hass-wattbox

Home Assistant Custom Component to integrate with WattBox.

Easiest way to install this component is through HACS.

Configuration

UI Configuration (Recommended)

Starting with version 0.20.0, this integration supports UI-based configuration through the Home Assistant interface:

1. Go to Configuration → Integrations
2. Click "Add Integration"
3. Search for "WattBox"
4. Enter your WattBox connection details:
   • Host: IP address of your WattBox device
   • Port: Port number (default 80 for HTTP, 22/23 for SSH)
   • Username: Authentication username (default: wattbox)
   • Password: Authentication password (default: wattbox)
   • Name: Friendly name for your WattBox device

Each WattBox will now appear as a device in Home Assistant with all its entities (sensors, switches, etc.) grouped under it.

YAML Configuration (Legacy)

Configuration through configuration.yaml is still supported for backward compatibility.

Example Config:

wattbox:
- name: WattBox-HTTP
  host: !secret wattbox1_ip
  port: 80
  username: !secret wattbox1_username
  password: !secret wattbox1_password
  name_regexp: "^Fixed Prefix (.*)$"
  skip_regexp: "SKIP"
  scan_interval: 00:00:10
- name: WattBox-SSH
  host: !secret wattbox2_ip
  port: 22
  username: !secret wattbox2_username
  password: !secret wattbox2_password
  scan_interval: 00:00:20
  resources:
  - auto_reboot
  - mute
  - safe_voltage_status
  - current_value
  - power_value
  - voltage_value

Configuration Options:

• host: Host IP of the WattBox (Required)
• name: Name for the WattBox (Default WattBox)
• port: Port of the HTTP interface (Default 80)
• username: Username for authentication (Default wattbox)
• password: Password for authentication (Default wattbox)
• scan_interval: A time interval run updates at (Default 30s, format HH:MM:SS)
• resources: A list of resources to enable (Default all of them)
• name_regexp: A regexp to extract the name to use for the outlet instead of just the index. If there is a match group, it is used, else the whole match is used.
• skip_regexp: A regexp to use that, if the outlet name matches, the outlet is not added as a switch entity.

Resources:

• audible_alarm
• auto_reboot
• battery_health
• battery_test
• cloud_status
• has_ups
• mute
• power_lost
• safe_voltage_status
• battery_charge
• battery_load
• current_value
• est_run_time
• power_value
• voltage_value

Be careful, if the WattBox controls the power to its own networking equipment you can turn it off and not have remote access until you fix it. You may even have to plug it in elsewhere to get back online and turn that outlet back on in HA. You can use the skip_regexp option for those outlets.

Master switch will turn on / off all the switches that the physical switch on the box does. You can config that through the UI on the wattbox directly. If ALL of the switches controlled by Master are on, then Master will be on. Otherwise it will be off. If any outlets on a wattbox are skipped via skip_regexp then the master switch for that wattbox will also not be added as an entity.

Based on: ludeeus/integration_blueprint

---