With this app you can communicate with Homey using MQTT messages.
- Dispatch device state changes for all connected devices.
- Dispatch system info (memory, cpu, etc.) on a regular basis.
- Request info (system, zone, device, capability, etc.).
- Update the state of a device (set capability).
The gateway allows two ways of communication, by topic & by message.
E.g. These two messages will both dim the tv light to 30%:
- publish to topic 'homey/light/living/tv/dim/update', with message payload: 0.3
- publish to topic 'homey/command', with message payload:
{
"command": "update",
"device":{
"name": "tv"
"class": "light", // optional
"zone": "living", // optional
"id": "<your-device-guid>" // optional
},
"capability": "dim"
"value": 0.3
}
This app uses the MQTT Client (beta) to communicate with a MQTT broker.
The following message format is used for communication:
system name
/device class
/zone
/device name
/capability
/command
Note: system name
, zone
& device name
will be normalized.
E.g. Homey/light/Living room/Light tv/... -> homey/light/living_room/light_tv/...
Messages with the following commands are dispatched by the Gateway:
state
: Current state value. Dispatched on device state changes or onrequest
command.info
: JSON Object describing the element(s) in the request (Zone, Device, Capability, etc.).
The gateway provides the following commands to interact with Homey:
request
: Request current state, astate
message will be published.update
: Update a device state (capability).describe
: Request a description of a Zone/Device/Capability/etc. Results will be published in ainfo
message.
- Device id's will automatically be resolved from the device id, name or topic (in this order).
- The device name may contain either de original name or the normalized version.
Homey 2.0 users should use the beta version of this app.
- Create the abillity to listen to app flow triggers.
- Trigger flows.
- Settings page for managing the Gateway (on/off, select devices/capabilities, etc.).
- etc.
- Initial release for Homey firmware v2 (beta)
- Initial release for Homey firmware v1.5