sensio-lib 0.1.0__py3-none-any.whl

sensio_lib/__init__.py

@@ -0,0 +1,5 @@
+from sensio_lib.light import Light
+from sensio_lib.hub import Hub
+from sensio_lib.light_state import LightState
+
+__all__ = ['Light', 'Hub', 'LightState']

sensio_lib/const.py

@@ -0,0 +1,18 @@
+
+SENSIO_AGENT_REQUEST = {
+  "DeviceName": "sdk_gphone_x86",
+  "DeviceId": "97e2cd6e-002d-4cfe-a596-5eb7a34c7582",
+  "DeviceOsVersion": "11 (sdk_gphone_x86-userdebug 11 RSR1.210722.013.A2 10067904 dev-keys)",
+  "DeviceType": "Android",
+  "ClientType": "SensioHaPanelApp",
+  "ClientVersion": "6.12.2 (320)"
+}
+
+# URLS
+SENSIO_BASE_URL = 'https://unity.sensio.no/api/v1'
+SENSIO_TOKEN_URL = 'https://unity.sensio.no/api/v1/tokens'
+SENSIO_PROJECTS_URL = 'https://unity.sensio.no/api/v1/users/self/projects?include=controllers&installerProjectsOnly=false&siteIdentifier=self'
+
+# Hex
+COMMAND_PREFIX = '\x01'
+COMMAND_POSTFIX = '\x02'

sensio_lib/hub.py

@@ -0,0 +1,85 @@
+from sensio_lib.const import SENSIO_AGENT_REQUEST, SENSIO_TOKEN_URL, SENSIO_PROJECTS_URL, SENSIO_BASE_URL
+from sensio_lib.light import Light
+import requests
+import logging
+import base64
+
+logger = logging.getLogger(__name__)
+
+class Hub:
+    def __init__(self, server_address: str, username: str, password: str):
+        self.username = username
+        self.password = password
+        self.server_address = server_address      
+
+    def login(self) -> list:
+        ''' Authenticate with the Sensio API and retrieve a list of projects '''
+
+        self.token = self._get_auth_token()
+        return self._get_projects()
+    
+    def get_lights(self, project_id) -> list:
+        ''' Retrieve a list of lights for the specified project '''
+
+        entities_url = f'{SENSIO_BASE_URL}/projects/{project_id}/functions'
+        entities_response = requests.get(entities_url, headers={'Authorization': f'Token {self.token}'})
+        if entities_response.status_code != 200:
+            raise Exception("Failed to retrieve entities")
+        
+        logger.debug(entities_response.json())
+        
+        switches = self._create_function_list(entities_response.json())
+        return [Light(switch['switch']['name'], switch['switch']['command_on'], switch['switch']['command_off'], self.server_address) for switch in switches]
+        
+        
+    def _get_auth_token(self):
+        response = requests.post(SENSIO_TOKEN_URL, auth=(self.username, self.password), json=SENSIO_AGENT_REQUEST, headers={"Content-Type": "application/json"})
+        if response.status_code != 200:
+            raise Exception("Failed to retrieve token")
+        
+        token_str = f'{response.json()["tokenId"]}:{response.json()["tokenSecret"]}'
+        token_bytes = token_str.encode('utf-8')
+        return base64.b64encode(token_bytes).decode('utf-8')
+        
+    def _get_projects(self):
+        if not self.token:
+            raise Exception("Token not set")
+
+        # Get a list of projects
+        project_response = requests.get(SENSIO_PROJECTS_URL, headers={'Authorization': f'Token {self.token}'})
+        if project_response.status_code != 200:
+            raise Exception("Failed to retrieve projects")
+        
+        # We want to populate projects with the project ID and project name for each project
+        return {project['name']: project['projectId'] for project in project_response.json()['projects']}
+    
+    
+    def _create_function_list(self, entity_json) -> list:
+        ''' Create a list of functions from the entity data. This is.....ugly.'''
+        
+        switch_info = []
+        intermediate_switches = {}
+
+        for switch in entity_json['functions']:
+            name = switch['name']
+            sub_type = switch['subType']
+            # Strip postfix to get the base name
+            base_name = name.rsplit('_', 1)[0]
+            # Determine command based on postfix
+            if sub_type in ['light_on', 'light_off', 'LightOffRoom', 'LightOnRoom']:
+                if base_name not in intermediate_switches:
+                    intermediate_switches[base_name] = {
+                        'name': base_name,
+                        'command_on': '',
+                        'command_off': ''
+                    }
+
+                if name.endswith('_OFF'):
+                    intermediate_switches[base_name]['command_off'] = switch["address"]
+                elif name.endswith('_ON'):
+                    intermediate_switches[base_name]['command_on'] = switch["address"]
+
+                if intermediate_switches[base_name]['command_on'] and intermediate_switches[base_name]['command_off']:
+                    switch_info.append({'switch': intermediate_switches.pop(base_name)})
+        
+        return switch_info

sensio_lib/light.py

@@ -0,0 +1,32 @@
+from sensio_lib.light_state import LightState
+from sensio_lib.socket_manager import SocketManager
+import uuid
+import logging
+
+logger = logging.getLogger(__name__)
+
+class Light:
+    def __init__(self, name, on_address, off_address, server_address=None):
+        self.state = LightState.UNKNOWN
+        self.id = uuid.uuid4()
+        self.name = name
+        self.on_address = on_address
+        self.off_address = off_address
+        self.server_address = server_address
+        self.socket_manager = SocketManager(self.server_address)
+
+    def turn_on(self):
+        logger.debug(f"Turning on light with ID: {self.name}")
+        self.socket_manager.send_command(f'new_state {self.on_address} 0')
+        self.state = LightState.ON
+
+    def turn_off(self):
+        logger.debug(f"Turning off light with ID: {self.name}")
+        self.socket_manager.send_command(f'new_state {self.off_address} 0')
+        self.state = LightState.OFF
+
+    def update(self):
+        logger.debug('Not implemented')
+
+    def __repr__(self):
+        return f'LightEntity: {self.name} - {self.state}'

sensio_lib/light_state.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+class LightState(Enum):
+    ON = "on"
+    OFF = "off"
+    UNKNOWN = "unknown"

sensio_lib/socket_manager.py

@@ -0,0 +1,25 @@
+import socket
+from sensio_lib.const import COMMAND_PREFIX, COMMAND_POSTFIX
+
+class SocketManager:
+    _instance = None
+
+    def __new__(cls, server_address):
+        if cls._instance is None:
+            cls._instance = super(SocketManager, cls).__new__(cls)
+            cls._instance.server_address = server_address
+            cls._instance.server_port = 10023
+            cls._instance.socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            cls._instance.socket.settimeout(15)
+            cls._instance.socket.connect((server_address, 10023))
+        return cls._instance
+
+    def send_command(self, command):
+        command = f'{COMMAND_PREFIX}{command}{COMMAND_POSTFIX}'
+        self.socket.sendall(command.encode('utf-8'))
+        #response = self.socket.recv(1024)
+        #return response.decode('utf-8')
+
+    def close(self):
+        self.socket.close()
+        SocketManager._instance = None

sensio_lib-0.1.0.dist-info/METADATA

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: sensio-lib
+Version: 0.1.0
+Requires-Python: ~=3.10
+Requires-Dist: pytest<9,>=8.3.3
+Requires-Dist: requests<3,>=2.32.3
+Description-Content-Type: text/markdown
+
+# Sensio Library
+
+A small library designed to control the Sensio smart house controller. This library was developed by reverse engineering the communication between the Sensio smart home app and the controller. It retrieves all device information from the Sensio cloud, but after the initial setup, all devices can be controlled 100% locally from your LAN.
+
+More features could probably be implemented by additional reverse engineering.
+
+## Features (v0.1.0)
+
+- **Login to Sensio Cloud**
+  - Select between multiple projects
+  - Get a list of all light devices
+- **Basic Light Control**
+  - Turn lights on/off (Note: no actual state of lights is implemented)
+
+## Device Support
+
+This library has been tested with a Sensio X1 controller. Testing is limited, so your experience may vary.

sensio_lib-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+sensio_lib/__init__.py,sha256=97fSUXIBY8r-hvLWOyaOOsSjfapwVuZv-chAOFxMs24,153
+sensio_lib/const.py,sha256=uFQ4DYaA3GTY61mDWBJvwlY1NZtMoXs3F0DXjY6HSnY,623
+sensio_lib/hub.py,sha256=TLMqJmz1on-T6Fz86POrAbAdOj1xRuZ2iZiUPDRcD1U,3746
+sensio_lib/light.py,sha256=yoHHGerpZefMpeN4UMdI-wyM8dB19FG8TRYohztD6SQ,1078
+sensio_lib/light_state.py,sha256=ENMnAlSAzvUSxywYsSJgME3ViBp1Er398NGYRiVWPeQ,100
+sensio_lib/socket_manager.py,sha256=8FflL6fTV_d4n7iRA6AaPJf3qzbBoHIYrRzF34Q2H5A,917
+sensio_lib-0.1.0.dist-info/METADATA,sha256=hTnfr7iJ6CpOS6EgoNKFl6RhMou_euEQskd43EEUbpw,971
+sensio_lib-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sensio_lib-0.1.0.dist-info/RECORD,,

sensio_lib-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any