Node-HIU Pairing

From Heatweb Wiki
Jump to: navigation, search

Introduction

Pairing with Node-HIU systems is achieved through use of connected services, typically the use of a hot water tap.

This is to tie identification to the locality of the HIU, giving the end-user ultimate control over access to, and persistence of, their data.

An email address is required, as well as the serial number of the system. Login details are displayed on successful pairing and emailed.

MQTT

Remote access to systems is provided over MQTT. This is similar to text messaging, but done over the internet, and instead of messages going to a single recipient, any system who knows the 'conversation topic' can access the data if they have the rights, and a network connection to the MQTT server (post office).

Passwords are generated randomly, and registered against the email address when locality to the HIU system is confirmed.

The MQTT server is set to run locally as default, requiring inbound access to the Node-HIU system via port forwarding on the internet router. This can be altered at installation to use an external MQTT service, located either on the local network, or in the cloud. Details of the server are provided upon successful pairing.

Procedure

  1. Scan barcode
  2. Enter email address and press Start
  3. Run tap 5 times in a row (5 seconds on, 5 seconds off, repeat 5 times)
  4. Press Finish

Pairing

The following frame can be used for pairing, or scan the barcode on the front of the HIU.

Details will be provided upon successful pairing, for example:

2.120.27.52

Please wait...
Success.

WAN server: 2.120.27.52
LAN server: 192.168.0.13
port: 10000
username: admin@heatweb.com
password: ez56pazy
MQTT topic: ihiu/xaCho7od/d03b027ae3b94045/#

These details can be used for remote access to sensor readings, and to user commands.


Mobile Phone Software

To connect to a Node-HIU system from a mobile device, you need an MQTT app.

The most effective tool for Android devices is IoT Dashboard

Topics Available

ihiu/node_id/device_id/user/request

This topic is used to send general commands to the Node-HIu system.


Command Description
diagnostics send system diagnostics
alarms new_email@new.com Add a new recipient for all alarms
alarms new_email@new.com remove Remove an alarm recipient from the list
alarms Lists the alarms, and alarm recipient list
alarm 'primary too cold' where tF < 65 every 3h to new_email_one@new.com,new_email_two@new.com Set an alarm when reading tF is lower than 65C, sending every 3 hours to specific recipients.
alarm fC,tCo,fHDHW,tH,tHoDHW where fC > 0 every 5s to mqtt.heatweb.com:10031 Establish Diversity posting.
alarms tF remove Clears the alarms for a reading

ihiu/node_id/device_id/user/CentralHeatingControl

ihiu/node_id/device_id/user/EcoMode

ihiu/node_id/device_id/user/setpoint