Initial commit: FranklinWH AGATE client library reverse engineered from Family Energy app

- Reverse engineered network I/O stack for AGATE device
- Bluetooth LE and Wi-Fi onboard communication support
- Discovered operations: queryAgateInfo, queryDeviceInfoHttp, queryModesByHttp, queryConnectWifi, connectViaBluetooth, startBluetoothHeartbeat
- Cloud API endpoints identified: e-api.franklinwh.com, energy.franklinwh.com, hes-gateway
- Python library structure with client, bluetooth, wifi, api modules
- Documentation for reverse engineering findings

franklinwh_agate_client/client.py

@@ -0,0 +1,26 @@
+"""
+Agate Client - Main interface for AGATE device operations.
+"""
+
+class AgateClient:
+    """Main client for FranklinWH AGATE device operations."""
+    
+    def __init__(self, device_id=None):
+        self.device_id = device_id
+        self.bluetooth_manager = None
+        self.wifi_manager = None
+    
+    def query_agate_info(self, device_id=None):
+        """Query AGATE device information."""
+        # Reverse engineered operation: queryAgateInfo
+        pass
+    
+    def query_device_info_http(self, device_id=None):
+        """Query device info via HTTP."""
+        # Reverse engineered operation: queryDeviceInfoHttp
+        pass
+    
+    def query_modes_by_http(self, device_id=None):
+        """Query operating modes via HTTP."""
+        # Reverse engineered operation: queryModesByHttp
+        pass