mqtt-energenie-ener314rt

MQTT node.js application to control the Energenie line of products via the ENER314-RT add-on board for the Raspberry Pi.

The primary reason this application has been built is to allow integration with Home Assistant via MQTT messaging; but it should work with anything that can integrate via MQTT.

https://energenie4u.co.uk/

IMPORTANT: UPGRADING FROM PREVIOUS RELEASE

v0.7.x requires additional software dependencies that must be manually installed first.

If you are upgrading from version 0.6.x or below, please ensure that you install node.js v18.2+, gpiod and libgpiod by following steps 2 and 3 in the Getting Started secion below.

There are also some additional parameters that you may wish to add to your config.json file.

Purpose

This node.js application is designed to run on a Raspberry Pi which has an energenie ENER314-RT board installed.

MQTT messages are used to control and monitor the Energenie MiHome radio based smart devices such as adapters, sockets, lights, thermostats and relays (see below for full device list). This is instead of operating the devices using a MiHome Gateway, so this module does not require an internet connection.

There is an alternative node-red implementation by the same author node-red-contrib-energenie-ener314rt, for native integration with node-red if you prefer.

The number of individual devices this module can control is over 4 million, so it should be suitable for most installations!

NOTE: This module does not currently support the older boards (ENER314/Pi-Mote), the Energenie Wifi sockets or the MiHome Gateway.

Getting Started

1. Plug in your ENER314-RT-VER01 board from Energenie onto the 26 pin or 40 pin connector of your Raspberry Pi.

2. Ensure that the Raspberry Pi is up to date, and has node.js v18.2+ and npm installed. See https://github.com/nodesource/distributions

3. Install gpiod and libgpiod dependencies (as of v0.7.x) : For example (using Debian):

sudo apt-get install gpiod libgpiod-dev

4. Download this application e.g:

wget https://github.com/Achronite/mqtt-energenie-ener314rt/archive/refs/heads/master.zip
unzip master.zip

5. Rename folder mv mqtt-energenie-ener314rt-master mqtt-energenie-ener314rt

6. cd mqtt-energenie-ener314rt

7. Install node's dependencies:

npm install

8. Copy/Rename the file config_sample.json to config.json in the same directory as the install (mqtt-energenie-ener314rt), and edit it to match your MQTT broker and user details.

It should contain the following entities configured for your environment. The example shown here uses the default Mosquitto MQTT broker Add-on in a Home Assistant installation:

{
  "topic_stub": "energenie/",
  "mqtt_broker": "mqtt://homeassistant.local",
  "mqtt_options": {
    "username":"node-ener314rt",
    "password":"password",
    "clean": true
    },
  "monitoring": true,
  "discovery_prefix": "homeassistant/",
  "ook_xmits": 10,
  "fsk_xmits": 5,
  "cached_retries": 10,
  "log_level": "info",
  "retry": true
}

• topic_stub should contain the base topic where your energenie messages should reside on mqtt, the default value should suit most installations.
• mqtt_broker should contain your MQTT broker address and protocol.
• Modify the mqtt_options section with your MQTT client options, such as username, password, certificate etc.
• If you have any energenie 'Control & Monitor' or 'Monitor' devices then set "monitoring": true otherwise remove or set false.
• If you are using this module with Home Assistant AND you have monitoring enabled include the discovery_prefix line as above. The value shown above is the default MQTT discovery topic used by Home Assistant.
• ook_xmits and fsk_xmits (optional) contain the number of times to transmit a radio message for Control (OOK) and Control & Monitor (FSK) devices. Defaults to 20 otherwise
• cached_retries (optional) contains the number of times to retry a cached command before stopping (applies to eTRV and thermostat)
• log_level the application logging level, see Logging below
• retry auto-retry capability for MIHO005 (optional, enabled by default). Checks that the resulting monitor message switch state from the Smart Plug+ matches the (just) sent switch command state; if it is different it retries the command again (indefinitely) until the state matches. Set this to false to disable the auto-retry switch command for the MIHO005 (Smart Plug+).

9. Run the application manually first using the command: node app.js. When you know this runs OK a system service can then be set-up as shown in the Systemd Service below.

Enabling The Hardware based SPI driver

This application works best using the linux hardware based SPI driver (spidev). The application attempts to open this driver on start-up, if it has not been enabled it falls back to using the software driver. The hardware SPI driver is enabled using sudo raspi-config choosing Interface Options and SPI. Do this whilst this software is not running. The driver in use is reported within the log on startup.

Systemd Service

If you want this application to run unattended automatically create a system service by executing the following commands:

sudo ln -s /home/pi/mqtt-energenie-ener314rt/mqtt-energenie-ener314rt.service /lib/systemd/system/
sudo systemctl daemon-reload
sudo systemctl start mqtt-energenie-ener314rt
sudo systemctl enable mqtt-energenie-ener314rt

To view the log output from the application, use the following command:

journalctl -u mqtt-energenie-ener314rt.service

Supported Devices

These nodes are designed for energenie RF radio devices in the OOK & FSK (OpenThings) ranges.

Here is a table showing the Device Topic and if control, monitoring, MQTT discovery and overall support for each device:

| Device | Description | Device Topic | Control | Monitoring | Discovery | Supported | |---|---|:---:|:---:|:---:|:---:|:---:| |ENER002|Green Button Adapter|ook|Yes|No|No|Yes| |ENER010|MiHome 4 gang Multiplug|ook|Yes|No|No|Yes| |MIHO002|MiHome Smart Plug (Blue)|ook|Yes|No|No|Yes| |MIHO004|MiHome Smart Monitor Plug (Pink)|1|No|Yes|Yes|Yes| |MIHO005|MiHome Smart Plug+ (Purple)|2|Yes|Yes|Yes|Yes| |MIHO006|MiHome House Monitor|5|No|Yes|Yes|Yes| |MIHO007|MiHome Socket (White)|ook|Yes|No|No|Yes| |MIHO008|MiHome Light Switch (White)|ook|Yes|No|No|Yes| |MIHO009|MiHome 2 gang Light Switch (White)|ook|Yes|No|No|Yes| |MIHO010|MiHome Dimmer Switch (White)|ook|Yes|No|No|Yes| |MIHO013|MiHome Radiator Valve|3|Cached|Yes|Yes|Yes| |MIHO014|Single Pole Relay (inline)|ook|Yes|No|No|Yes| |MIHO015|MiHome Relay|ook|Yes|No|No|Yes| |MIHO021|MiHome Socket (Nickel)|ook|Yes|No|No|Yes| |MIHO022|MiHome Socket (Chrome)|ook|Yes|No|No|Yes| |MIHO023|MiHome Socket (Steel)|ook|Yes|No|No|Yes| |MIHO024|MiHome Light Switch (Nickel)|ook|Yes|No|No|Yes| |MIHO025|MiHome Light Switch (Chrome)|ook|Yes|No|No|Yes| |MIHO026|MiHome Light Switch (Steel)|ook|Yes|No|No|Yes| |MIHO032|MiHome Motion sensor|12|No|Yes|Yes|Yes| |MIHO033|MiHome Open Sensor|13|No|Yes|Yes|Yes| |MIHO069|MiHome Heating Thermostat|18|Cached|Yes|Yes|Yes| |MIHO089|MiHome Click - Smart Button|19|No|Yes|Yes|Yes|

MQTT Topics

The commands and monitor messages are sent/received using MQTT topics. The topic design is loosely based on that used for esphome devices, and parameter names generally align to the OpenThings parameter standard.

The following table shows some examples of the topics used:

|device|topic stem (~)|command topic|state topic(s)|valid values| |---|---|---|---|---| | All |energenie/availability| |~/state|online,offline| |ENER002|energenie/ook/zone/switchNum|~/command|~/state|ON,OFF| |ENER010|energenie/ook/zone/0-4|~/command|~/state|ON,OFF| |MIHO002|energenie/ook/zone/switchNum|~/command|~/state|ON,OFF| |MIHO010|energenie/ook/zone/dimmer|~/command|~/state|ON,OFF,1-10| |MIHO004|energenie/1/deviceNum||~/REAL_POWER/state~/REACTIVE_POWER/state~/VOLTAGE/state~/FREQUENCY/state~/last_seen/state|NumberNumberNumberFloatepoch| |MIHO005|energenie/2/deviceNum|~/switch/command|~/switch/state~/REAL_POWER/state~/REACTIVE_POWER/state~/VOLTAGE/state~/FREQUENCY/state~/last_seen/state|ON,OFFNumberNumberNumberFloatepoch| |MIHO006|energenie/5/deviceNum||~/APPARENT_POWER/state~/VOLTAGE/state~/CURRENT/state~/battery/state~/last_seen/state|NumberFloatFloat%epoch| |MIHO013|(see eTRV topics below)|||| |MIHO032|energenie/12/deviceNum||~/motion/state~/ALARM/state~/last_seen/state|ON,OFF66=batt_lowepoch| |MIHO033|energenie/13/deviceNum||~/contact/state~/last_seen/state|ON,OFFepoch| |MIHO089|energenie/19/deviceNum||~/BUTTON/state~/VOLTAGE/state~/last_seen/state|1=single,2=double,255=longFloatepoch| software/board|energenie/board/1|~/discover/command|~/discover/state~/initialised/state|Numberepoch|

epoch = Unix timestamp

Other devices will return other OpenThings parameters which you can use. I have provided parameter name and type mapping for the known values for received messages to MQTT topics.

TIP: You can use an MQTT explorer to show your FSK/OpenThings 'Monitor' devices and their automatically-added reported values.

Home Assistant Set-up

Enable the MQTT Integration in Home Assistant (if not already enabled).

MQTT Discovery

Most MiHome Monitor devices will auto-add and be available in Home Assistant via MQTT discovery, consult the table above to see if your devices are supported. If your Monitor device is not found you can force it to transmit a 'join' request by holding down the button on the device for 5 seconds. The default discovery topics for the devices follow the pattern homeassistant/<component>/ener314rt/<deviceId>-<ParameterName>, the value homeassistant/ can be changed in the config.json file if your discovery topic is configured differently.

The MQTT discovery configuration is updated one minute after the program starts for seen devices, and then every 10 minutes thereafter for performance reasons.

The number of discovered FSK 'monitor' devices since the application was started is shown under Sensors->Discovered for the mqtt-energenie-ener314rt device. If you restart this application, the number will restart at 0.

You can also force the application to perform a discovery at any time by pressing the 'Discover' button within the Home Assistant device called mqtt-energenie-ener314rt; this will scan for devices for 10 seconds and then update the MQTT Discovery entries for all devices found since the last restart.

WARNING: Discovery currently bases the availability of OpenThings devices upon the overall availability of this application (MQTT topic: energenie/availability/state), it does not currently work to the device level (see #19 for latest)

MQTT Manual setup

For other devices (particularly the 'Control Only' devices) you will need to add them manually by editting your Home Assistant configuration.yaml file for lights, dimmers, switches and reported values as applicable. For example:

mqtt:
  light:
    - unique_id: "Lounge_Light_Left"
      name: null
      command_topic: energenie/ook/87/1/command
      optimistic: false
      state_topic: energenie/ook/87/1/state
      availability_topic: energenie/availability/state
      device:
        name: "energenie light"
        identifiers: ["ook-light"]
        model: "MIHO008"
        manufacturer: "Energenie"
        software: "mqtt-ener314rt"
        via_device: "mqtt-energenie-ener314rt"
    - unique_id: "Lounge_Light_Right"
      name: null
      command_topic: energenie/ook/87/2/command
      optimistic: false
      state_topic: energenie/ook/87/2/state
      availability_topic: energenie/availability/state
      device:
        identifiers: ["ook-light"]

  switch:
    - unique_id: "Coffee_Maker"
      name: null
      command_topic: energenie/ook/89/1/command
      optimistic: false
      state_topic: energenie/ook/89/1/state
      availability_topic: energenie/availability/state
      device:
        name: "energenie OOK plug"
        identifiers: ["ook-plug"]
        model: "ENER002"
        manufacturer: "Energenie"
        software: "mqtt-ener314rt"
        via_device: "mqtt-energenie-ener314rt"

    - unique_id: "Subwoofer"
      name: null
      command_topic: energenie/ook/564/2/command
      optimistic: false
      state_topic: energenie/ook/564/2/state
      availability_topic: energenie/availability/state
      device:
        name: "energenie OOK 4-gang"
        identifiers: ["ook-4gang"]
        model: "ENER010"
        manufacturer: "Energenie"
        software: "mqtt-ener314rt"
        via_device: "mqtt-energenie-ener314rt"

    - unique_id: "Kitchen_Dimmer"
      name: null
      command_topic: energenie/ook/669/dimmer/command
      state_topic: energenie/ook/669/dimmer/state
      state_value_template: "{{ 'OFF' if value == 'OFF' else 'ON' }}"
      brightness_state_topic: energenie/ook/669/dimmer/state
      brightness_command_topic: energenie/ook/669/dimmer/command
      brightness_scale: 10
      payload_on: 'ON'
      payload_off: 'OFF'
      on_command_type: "brightness"
      optimistic: false
      availability_topic: energenie/availability/state
      device:
        name: "energenie OOK dimmer"
        identifiers: ["ook-dimmer"]
        model: "MIHO010"
        manufacturer: "Energenie"
        software: "mqtt-ener314rt"
        via_device: "mqtt-energenie-ener314rt"

And if you are not using MQTT Discovery:

  sensor:
    - name: "MiHome Thermometer Temperature"
      state_topic: energenie/18/12345/TEMPERATURE/state
      device_class: temperature
      unit_of_measurement: "C"
      device:
        name: "energenie FSK"
        identifiers: ["ener314rt-12345"]
        model: "Thermometer"
        manufacturer: "Energenie"
        software: "mqtt-ener314rt"   
        via_device: "mqtt-energenie-ener314rt"

Adding the device section enables easier access to the underlying switches within Home Assistant automations etc.

TIP: If you do not know the existing zone and switch number for any of your 'Control Only' (Blue) devices you can 're-teach' the device (see below)

Converting an epoch timestamp

Timestamps are sent via MQTT as epoch timestamps. To convert these to datetime objects in HA do the following (example shown is the conversion of the eTRV VALVE_TS epoch in Home Assistant configuration.yaml).

NOTE: MQTT Discovery automatically does this for you.

mqtt:
  sensor:
    - unique_id: XXXX_valve_ts
      name: "Radiator XXXX Valve Exercised"
      state_topic: energenie/3/XXXX/VALVE_TS/state
      value_template: "{{ as_datetime(value) }}"
      device_class: timestamp

Energenie 'Control Only' OOK device teaching in Home Assistant

The control only devices (any listed in the above table as Device Topic 'ook' or with a Blue icon on the energenie boxes) need to be taught a zone and switch code.

1. Add an mqtt entry in configuration.yaml for your switch or light. These should uniquely reference your device (following the OOK zone rules below). For example to teach an ENER002 socket to be Zone 567 switch 1 enter the following:

mqtt:
  switch:
    - name: "My Switch"
      command_topic: energenie/ook/567/1/command
      optimistic: false
      state_topic: energenie/ook/567/1/state

2. Reload the YAML configuration MANUALLY CONFIGURED MQTT ENTITIES in Home Assistant Developer Tools
3. Hold the button on your device until it starts to flash (holding longer clears any previous codes; each device can usually have 2 separate codes).
4. Click the power on button on the dashboard for your new switch/light device. This will send an MQTT message to this application, which will send a power-on request for the zone/switch combination set in the command topic.
5. The device should learn the zone code being sent by the power-on request, the light should stop flashing when successful.
6. All subsequent calls using the same zone/switch number will cause your device to switch.

'Control Only' OOK Zone Rules

• Each Energenie 'Control' or OOK based device can be assigned to a specifc zone (or house code) and a switch number.
• Each zone is encoded as a 20-bit address (1-1048575 decimal).
• Each zone can contain up to 6 separate switches (1-6) - NOTE: officially energenie state this is only 4 devices (1-4)
• All devices within the same zone can be switched at the same time using a switch number of '0'.
• A default zone '0' can be used to use Energenie's default zone (0x6C6C6).

MiHome Heating Support

Both MiHome heating devices are now supported (as of v0.7.x). Specifically the MIHO013 MiHome Radiator Valve (eTRV) and the MIHO069 MiHome Thermostat.

These devices are battery operated, so energenie in order to save power, have implemented periods of sleep where the devices do not listen for commands. This can lead to a delay from when a command is sent to it being processed by the device. See Command Caching below.

Command Caching

Battery powered energenie devices, such as the eTRV or Thermostat do not constantly listen for commands. For example, the eTRV reports its temperature at the SET_REPORTING_INTERVAL (default 5 minutes) after which the receiver is then activated to listen for commands. The receiver only remains active for 200ms or until a message is received.

To cater for these hardware limitations a command will be held (cached) until a report is received by the monitor thread from the device; at this point the most recent cached message (only 1 is supported) will be sent to the device. Messages will continue to be resent until we know they have been succesfully received or until the number of retries has reached 0. When a command is known to have been processed (e.g DIAGNOSTICS) the 'command' and 'retries' topics are reset to 0.

The reason that a command may be resent multiple times is due to reporting issues. The eTRV devices, unfortunately, do not send acknowledgement for every command type (indicated by a 'No' in the Response Msg column in the above table). This includes the TEMP_SET command! So these commands are always resent for the full number of retries.

NOTE: The performance of node may decrease when a command is cached due to dynamic polling. The frequency that the radio device is polled by the monitor thread automatically increases by a factor of 200 when a command is cached (it goes from checking every 5 seconds to every 25 milliseconds) this dramatically increases the chance of a message being correctly received sooner.

eTRV Commands

The MiHome Thermostatic Radiator valve (eTRV) can accept commands to perform operations, provide diagnostics or perform self tests. The documented commands are provided in the table below. For this MQTT implementation most of the commands have been simplified under a single 'Maintenance' topic. If you are using MQTT Discovery in Home Assistant you should see a 'select' for this on your dashboard.

Where .data shows an entry in "", this is the string that should be sent as the 'Command' for the MQTT Maintenance topic. This can be used if you want to send a request without using the select dropdown set-up by MQTT discovery.

| Command | MQTT Command Topic(s) | # | Description | .data | Response Msg | |---|:---:|---|---|:---:|---| |Clear|Maintenance|0|Cancel current outstanding cached command for the device (set command & retries to 0)| "Cancel Command"|All Msgs| |Exercise Valve|Maintenance EXERCISE_VALVE|163|Send exercise valve command, recommended once a week to calibrate eTRV|"Exercise Valve"|DIAGNOSTICS| |Low power mode|Maintenance LOW_POWER_MODE|164|This is used to enhance battery life by limiting the hunting of the actuator, ie it limits small adjustments to degree of opening, when the room temperature is close to the TEMP_SET point. A consequence of the Low Power mode is that it may cause larger errors in controlling room temperature to the set temperature.|0=Off1=On OR "Low Power Mode ON" "Low Power Mode OFF"|No*| |Valve state^|MaintenanceVALVE_STATE|165|Set valve state|"Valve Auto""Valve Open""Valve Closed" OR 0=Open1=Closed2=Auto (default)|No| |Diagnostics|MaintenanceDIAGNOSTICS|166|Request diagnostic data from device, if all is OK it will return 0. Otherwise see additional monitored values for status messages|"Request Diagnostics"|DIAGNOSTICS| |Identify|MaintenanceIDENTIFY|191|Identify the device by making the green light flash on the selected eTRV for 60 seconds|"Identify"|No| |Reporting Interval|Maintenance REPORTING_INTERVAL|210|Update reporting interval to requested value|300-3600 seconds|No| |Voltage|MaintenanceVOLTAGE|226|Report current voltage of the batteries||VOLTAGE| |Target temperature|TARGET_TEMP|244|Send new target temperature for eTRV.NOTE: The VALVE_STATE must be set to 'Auto' for this to work.|5-40(Integer)|No|

* Although this will not auto-report, a subsequent call to REQUEST_DIAGNOTICS will confirm the LOW_POWER_MODE setting

^ Do not set VALVE_STATE 0='Valve Open' When used with Home Assistant in MQTT Discovery mode as it will interfere with the Climate Control Entity

eTRV Topics

To support the MiHome Radiator Valve (MIHO013) aka 'eTRV', additional code has been added to also cache the monitor information for these devices. Examples of the values are shown below, only 'known' values are returned when the eTRV regularly reports.

|Parameter|Description|Topics|Data|Discovery Type| |---|---|:---:|:---:|:---:| |Maintenance|For sending maintenance commands|state,command|None, Cancel Command, Request Diagnostics, Exercise Valve, Identify, Low Power Mode ON, Low Power Mode OFF, Valve Auto, Valve Open,Valve Closed|select| |command|Current cached command being sent to device|state,command|None,...|sensor| |retries|The number of remaining retries for 'command' to be sent to the device|state,soon|0-10|sensor| |DIAGNOSTICS|Numeric diagnostic code|state|Numeric|| |DIAGNOSTICS_TS|The time the diagnostics last reported|state|epoch|sensor| |ERRORS|true if an error condition has been detected|state||binary_sensor| |ERROR_TEXT|error information|state|text|sensor| |EXERCISE_VALVE|The result of the EXERCISE_VALVE command|state|success, fail|binary_sensor| |LOW_POWER_MODE|eTRV is in low power mode state>|state|ON, OFF|binary_sensor| |REPORTING_INTERVAL|Frequency the eTRV will work up and report (in seconds)|command|300-3600|Number| |TARGET_TEMP|Target temperature in celcius|state,command|5.0 to 40.00.5 increments|Number| |TEMPERATURE|The current temperature in celcius|state|float|sensor| |VALVE_STATE|Current valve mode/state|state|0=Open1=Closed2=Auto|sensor| |VALVE_TS|The time the valve was last exercised|state|state|epoch|| |VOLTAGE|Current battery voltage|state|float|sensor| |VOLTAGE_TS|The time the battery last updated|state|epoch|sensor| |battery|Estimated battery percentage|state|0-100|sensor| |last_seen|The time the device last reported|state|epoch|sensor|

Thermostat topics

The MiHome Thermostat is supported in v0.7.x.

A different mechanism of reporting processed commands has been implemented for the thermostat. When (and only when) the thermostat procesess a command it outputs it's telemetry data. This mechanism has been exploited, for values that do not get reported back by the thermostat (RELAY_POLARITY,HUMID_OFFSET,TEMP_OFFSET,HYSTERISIS) to assume for the command that has just been sent to the device (upon WAKEUP) has now been processed succesfully; at this point the retained state of the command is set in MQTT copying the command values.

| Parameter | Description | Topics | Data | Discovery type | |---|---|---|---|---| |command|Current cached command being sent to device|state,command|None,...|sensor| |retries|The number of remaining retries for 'command' to be sent to the device|state|0-10|sensor| |battery|Estimated battery percentage|state|0-100|sensor| |BATTERY_LEVEL|Current battery voltage|state|float|sensor| |REL_HUMIDITY|The current relative humidity as a percentage|state|float|sensor| |TEMPERATURE|The current temperature in celcius|state|float|sensor| |TARGET_TEMP|Target temperature in celcius|state,command|5.0 to 40.00.5 increments|Number| |THERMOSTAT_MODE|Set operating mode for thermostat, where0=Off, 1=Auto, 2=On|state,command|0,1,2|sensor| |MOTION_DETECTOR|Somehow relates to motion being detected|state|who knows!|sensor| |RELAY_POLARITY|Set relay polarity, where0=Normally Open, 1=Normally Closed|command,state|0,1|switch| |HUMID_OFFSET|Set relative humidity offset for calibration|command,state|-20..20|number| |TEMP_OFFSET|Set temperature offset for calibration|command,state|-20..20|number| |HYSTERISIS|aka Temp Margin, set the difference between the current temperature and target temperature before the thermostat triggers|command,state|0.5-10.0|number| |last_seen|The time the device last reported|state|epoch|sensor| |switch|The status of the 'boiler' switch|state|OFF, ON|sensor|

WARNING: If you are controlling/setting the Thermostat using a MiHome gateway/app you should NOT issue commands via this module as the commands will clash/override each other (see auto-messaging below).

Thermostat auto-messaging to obtain telemetry

In order for the Thermostat to provide updates for it's telemetry data, auto messaging has been enabled within this module. To start this auto-messaging you will need to have a monitoring enabled (via the config.json file) and then subsequently send a command that returns the THERMOSTAT_MODE to the application. The result of the most recent THERMOSTAT_MODE value will be stored and periodically replayed (until a restart) to prompt the thermostat into providing it's telemetry data.

As the result is used, pressing the buttons on the thermostat should still work and be reflected as the thermostat will ignore the same command values after a button has been pressed.

NOTE: If you are controlling/setting the Thermostat using a MiHome gateway/app you should NOT issue commands via this module as the commands could clash/override each other.

Logging

From v0.5.0 the application can be configured with different logging levels by the key log_level in the configuration file. The log level is read and set once during startup. The valid levels, using npmlog, in increasing level are:

• error - Only logs fatal errors
• warn + reports minor errors that do not affect normal operation
• http + logs all incoming/outgoing messages (default)
• info + adds startup/discovery/internal details
• verbose + all logging - use for debugging purposes

In normal operation you will not see any messages (after the 2 uncofigurable starting messages) in the log for settings 'warn' level or below.

Change History

See CHANGELOG.md

Built With

• NodeJS - JavaScript runtime built on Chrome's V8 JavaScript engine.
• energenie-ener314rt - Dependant node.js module that performs all energenie functions
• mqtt - javascript implementation of MQTT protocol

Authors

• Achronite - MQTT implementation and dependant Node module -

License

This project is licensed under the MIT License - see the LICENSE.md file for details

This project needs your help!

I have performed all work to date on this open source, free, software without any help (financial or otherwise) from energenie. Your support provides increased motivation to work on future releases and new features. You can help by sponsoring my work on GitHub Sponsors (one-time/monthly, no service fee).

Thank you for your support!

Bugs and Future Work

Future work is detailed on the github issues page. Please raise any bugs, questions, queries or enhancements you have using this page.

https://github.com/Achronite/mqtt-energenie-ener314rt/issues

@Achronite - February 2024