homebridge-tuya-energy-monitor

Starter Homebridge plugin scaffold for a Tuya energy monitor.

Quick start

1. Install dependencies:

   npm install

2. Build:

   npm run build

3. Link globally for Homebridge development:

   npm link

4. Add this to your Homebridge config.json:

   {
     "platforms": [
       {
         "platform": "TuyaEnergyPlatform",
         "name": "Tuya Energy",
         "deviceName": "Tuya Energy Monitor",
         "clientId": "YOUR_TUYA_CLIENT_ID",
         "secret": "YOUR_TUYA_SECRET",
         "deviceId": "YOUR_TUYA_DEVICE_ID",
         "region": "us",
         "pollSeconds": 30
       }
     ]
   }

Project structure

• src/index.ts: Homebridge plugin entrypoint and platform registration.
• src/platform.ts: Dynamic platform setup and accessory discovery scaffold.
• src/tuyaEnergyAccessory.ts: Accessory skeleton with placeholder characteristic mapping.
• config.schema.json: Homebridge UI schema for plugin settings.

Tuya setup notes

• Create or use an existing Tuya IoT Cloud project and link your app account/devices.
• Copy your cloud Access ID as clientId and Access Secret as secret.
• Use the Tuya IoT console or API explorer to confirm the target deviceId.
• Pick the correct region for your project: us, eu, cn, or in.

Current behavior

• The plugin polls Tuya /v1.0/devices/{deviceId}/status on an interval.
• It attempts to read current power from status codes like cur_power and maps this into a simple activity signal.
• Next we can map richer telemetry (power, voltage, current, kWh) into custom HomeKit characteristics.

Publish to npm (for Homebridge UI install)

1. Login to npm from this project directory:

   npm login

2. Publish the package:

   npm publish

3. In Homebridge UI on your remote host:

   • Open Plugins
   • Search for homebridge-tuya-energy-monitor
   • Install and restart Homebridge

4. For updates:

   npm version patch
   npm publish