ENERGY · power-strip

Power Strip

Multi-outlet power control.

4 capabilitiesREST + secure WebSocketProduction schema
OVERVIEW

Built from capabilities, not assumptions.

Power Strip is a canonical HomeAutoPro energy template. The same production capability schema drives validation, controls, reported state, telemetry, scenes and automations. Undeclared keys are rejected.

WRITABLE CAPABILITIES

Controls

ControlTypeRange / valuesDescription
Outlet 1outlet_1booleanON / OFFWritable through validated owner commands and automations.
Outlet 2outlet_2booleanON / OFFWritable through validated owner commands and automations.
Outlet 3outlet_3booleanON / OFFWritable through validated owner commands and automations.
DEVICE → HOMEAUTOPRO

Feedback / state

Every connected device also reports online state and last-seen time. Applied values remain distinct from requested values until the device acknowledges them.

Outlet 1outlet_1

boolean. Report the value actually applied after each command.

Outlet 2outlet_2

boolean. Report the value actually applied after each command.

Outlet 3outlet_3

boolean. Report the value actually applied after each command.

Powerpower_w

number · W. Read-only device feedback.

TIME-SERIES VALUES

Telemetry

Powerpower_w

Validated number in W, 0–10000. Publish in a telemetry message.

CAPABILITY-AWARE WORKFLOWS

Automations

Triggers

State/telemetry changes for outlet_1, outlet_2, outlet_3, power_w, plus online and offline events.

Actions

Validated commands for outlet_1, outlet_2, outlet_3. Applied state is reported as ACK.

ACTUAL PRODUCTION PROTOCOL

Payloads and acknowledgement

Dashboard/APIHomeAutoProDeviceApplied-state ACK

Authenticate

{"type":"auth","device_secret":"YOUR_DEVICE_SECRET"}

Command

{
  "event": "command",
  "state": {
    "outlet_1": true,
    "outlet_2": true,
    "outlet_3": true
  }
}

State ACK

{
  "state": {
    "outlet_1": true,
    "outlet_2": true,
    "outlet_3": true
  },
  "type": "state"
}

Telemetry

{
  "telemetry": {
    "power_w": 5000.0
  },
  "type": "telemetry"
}
CAPABILITY-GENERATED EXAMPLES

Sample code

Choose one platform. All examples use the production protocol and placeholders; no stored secret is retrieved.

C++ · ESP8266
#include <ESP8266WiFi.h>
#include <ArduinoJson.h>
#include <WebSocketsClient.h>

const char* DEVICE_CODE = "YOUR_DEVICE_ID";
const char* DEVICE_SECRET = "YOUR_DEVICE_SECRET";
WebSocketsClient socket;

// Handle only: outlet_1, outlet_2, outlet_3
// Connect: socket.beginSSL("api.homeautopro.in", 443, path);
// First message: {"type":"auth","device_secret":DEVICE_SECRET}
// After a command, publish {"type":"state","state":applied}.
SAFE DIAGNOSTICS

Troubleshooting

401 authentication

Use the current Device Secret locally. Rotate it in Device Details if it was lost.

422 validation

Compare every key, type and range with the capability schema above.

No command ACK

Publish the value actually applied after handling event=command.