smartbox

Warning

This project and the related hass-smartbox project are no longer maintained

Python API to control heating 'smart boxes'

Installation

Install using pip from PyPI:

pip install smartbox

You can use the smartbox tool to get status information from your heaters (nodes) and change settings.

A few common options are required for all commands:

-a/--api-name: The API name for your heater vendor. This is visible in the 'API Host' entry in the 'Version' menu item in the mobile app/web app. If the host name is of the form api-foo.xxxx or api.xxxx use the values api-foo or api respectively.
-u/--username: Your username as used for the mobile app/web app.
-p/--password: Your password as used for the mobile app/web app.
-b/--base-auth-creds: An HTTP Basic Auth credential used to do initial authentication with the server. Use the base64 encoded string directly. See 'Basic Auth Credential' section below for more details.

Verbose logging can be enabled with the -v/--verbose flag.

smartbox <auth options...> devices

The nodes command lists nodes across all devices.

smartbox <auth options...> nodes

The status command lists status across all nodes and devices.

smartbox <auth options...> status

The set-status command can be used to change a status item on a particular node.

smartbox <auth options...> set-status <-d/--device-id> <device id> <-n/--node-addr> <node> <name>=<value> [<name>=<value> ...]

The setup command lists setup across all nodes and devices.

smartbox <auth options...> setup

The set-setup command can be used to change a setup item on a particular node.

smartbox <auth options...> set-setup <-d/--device-id> <device id> <-n/--node-addr> <node> <name>=<value> [<name>=<value> ...]

The device-away-status command lists the away status across all devices.

smartbox <auth options...> device-away-status

The set-device-away-status command can be used to change the away status on a particular device.

smartbox <auth options...> set-device-away-status <-d/--device-id> <device id> <name>=<value> [<name>=<value> ...]

The device-power-limit command lists the power limit (in watts) across all devices.

smartbox <auth options...> device-power-limit

The set-device-power-limit command can be used to change the power limit (in watts) on a particular device.

smartbox <auth options...> set-device-power-limit <-d/--device-id> <device id> <limit>