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/bluetooth.py

@@ -0,0 +1,27 @@
+"""
+Bluetooth Manager for AGATE device communication.
+"""
+
+class BluetoothManager:
+    """Manages Bluetooth LE connection to AGATE device."""
+    
+    SERVICE_UUIDS = []
+    DEVICE_NAME_PREFIX = "AGATE"
+    
+    def __init__(self):
+        self.connected = False
+        self.heartbeat_active = False
+    
+    def connect_via_bluetooth(self, device_address):
+        """Connect to AGATE device via Bluetooth."""
+        # Reverse engineered operation: connectViaBluetooth
+        pass
+    
+    def start_bluetooth_heartbeat(self):
+        """Start Bluetooth heartbeat keepalive."""
+        # Reverse engineered operation: startBluetoothHeartbeat
+        pass
+    
+    def disconnect_bluetooth(self):
+        """Disconnect from AGATE device."""
+        pass