Language & Communication: How We Talk
For a smart home to work, every part of the system needs to speak the same language. We call our language HxTP (HeliX Transfer Protocol). This guide explains the different ways we communicate.
1. The Ways We Connectâ
| Connection Type | Who is it for? | What is it like? |
|---|---|---|
| The Front Door (API) | Apps & Websites | A standard conversation where you ask for information and get a reply. |
| The Live Stream (WebSockets) | Real-time Updates | A "hotline" that stays open so we can tell your app instantly when a light turns on. |
| The AI Tools (MCP) | AI Brains | A specialized toolbox that allows AI agents to "see" and "touch" your smart devices. |
| The Device Hub (MQTT) | Smart Devices | A low-power, high-speed system optimized for small electronics. |
2. The "Secret Handshake" (HxTP/3.0)â
When a device talks to our cloud, it doesn't just send raw data. It sends a carefully packed "envelope" that includes:
- Who is it for? (Device ID & User ID)
- What time is it? (Timestamp)
- Is this a duplicate? (Nonce & Sequence Number)
- The Message Seal: A unique digital signature that proves the message is authentic.
3. Registering a New Deviceâ
We make adding new devices easy with our Claim Service.
- When you first turn on a device, it introduces itself using a "Public Key."
- Our cloud and the device perform a "digital dance" (ECIES) to create a shared secret.
- This secret is then used to encrypt all future conversations, so only you and your device can understand them.
4. The AI Toolbox (MCP Tools)â
Our AI Brain has a specific list of Tools it can use. These are like its "hands."
- Observing: Tools to see your device's battery, status, and history.
- Acting: Tools to send commands (like "Turn on") through the Smart Shield.
- Managing: Tools to create "Groups" or "Rooms" in your home.
- Remembering: Tools to store and recall your preferences.
5. Summaryâ
By using a single, secure language (HxTP) across all these different connection types, we ensure that your smart world is both simple to use and impossible to break into.