homebridge-decaid

A Homebridge dynamic platform plugin that exposes a Decaid-connected Decent DE1 espresso machine to HomeKit:

• A switch to wake (idle) / sleep the machine.
• Temperature sensors for mix, group head, and steam temperatures.
• A water level sensor (modeled as a humidity sensor, since HomeKit has no native tank-level service), reported as a percentage of a configurable tank height.

It talks to Decaid's REST + WebSocket API (port 8080 by default): telemetry (temperatures, machine state, water level) is streamed live over WebSocket, and the on/off switch issues a REST state-change request. See assets/api/rest_v1.yml and assets/api/websocket_v1.yml in the Decaid repo for the full API contracts.

This plugin is a rewrite of homebridge-decent-advanced-rest-api targeting Decaid's newer API (the original targets the legacy de1app REST API and is not compatible with Decaid).

Installation

Once published to npm:

sudo npm install -g homebridge-decaid

Then add a decaid platform block to your Homebridge config.json (or use the Homebridge UI's plugin settings screen, which uses config.schema.json):

{
  "platform": "decaid",
  "machines": [
    {
      "name": "Decent Espresso",
      "host": "192.168.1.50:8080",
      "waterTankHeight": 60
    }
  ]
}

Configuration reference

Field	Description	Default
machines[].name	Accessory name shown in HomeKit	— (required)
machines[].host	Hostname/IP and port of the tablet running Decaid	— (required)
machines[].waterTankHeight	Full-tank height in mm, used to convert the live water height into a percentage	60
machines[].suppressMixTemperature	Hide the mix temperature sensor	false
machines[].suppressGroupTemperature	Hide the group head temperature sensor	false
machines[].suppressSteamTemperature	Hide the steam heater temperature sensor	false
machines[].suppressWaterLevel	Hide the water level sensor	false
reconnectDelay	Delay (ms) before retrying a dropped WebSocket connection	2000
staleAfter	Milliseconds without a telemetry frame before a sensor reports "not responding"	5000
requestTimeout	Timeout (ms) for the REST on/off request	3000

waterTankHeight calibrates the percentage HomeKit shows, not the physical tank — Decaid reports the raw water height in mm (see ws/v1/machine/waterLevels), and this plugin divides by waterTankHeight to get a 0-100% reading. Adjust it to whatever height your machine's sensor reports at a full tank.

Development

npm install
npm run lint
npm run build

See homebridge-plugin-template and the Homebridge developer docs for background on the plugin API this is built against.

License

Apache-2.0 — see LICENSE. Adapted from homebridge-decent-advanced-rest-api, also Apache-2.0.