Overview

novolto P2300/P3000 and Sense devices offer local APIs for interacting with the device directly on your network, without needing novolto’s cloud. These APIs let you read sensor data, send commands and change configuration from your own energy management and home automation systems.

This page contains documentation for setting up and working with these APIs.

Supported devices

• novolto P2300(G)/P3000(G) water heater
  Firmware version v2.0 (currently in pre-release) or newer

  Note

  If you are using a P2300/P3000 water heater with a firmware version before v2.0, please contact us for a firmware update or the documentation for the legacy MQTT API.

• novolto Sense electricity meter reader

Setup

Instructions to setup local APIs are available under Setup Instructions.

Available APIs

• MQTT API

  The primary API, which allows running commands, reading and writing settings, monitoring online status, etc.

• Modbus API

  A SunSpec-based Modbus server for direct local control, as an alternative to the MQTT API.

  Caution

  The Modbus API is under development and not available yet. The current documentations is a draft and subject to change.

Settings reference

Devices are configured through a set of namespaced settings, which can be read and changed via web configuration, the MQTT API’s settings/get and settings/set topics, and indirectly via Modbus. See the List of Settings for all available settings, their types, default values, etc.