Skip to content
sanderkob edited this page Nov 20, 2021 · 10 revisions

Types of remotes

The Itho RFT remotes communicate by radio (868MHz) to the Itho unit and to the add-on (if equipped with the CC1101 module and with RF support enabled).
When paired to the Itho unit, 'remote' information is available in the ithostatus message.
When paired to the add-on, some 'remote' information is available in the remotesinfo message.

The add-on itself can be paired to the Itho unit as a 'virtual remote', similar in functionality to a physical RFT remote, but without an actual RF signal. The virtual remote is emulated directly towards the Itho firmware through the internal I2C bus. Joining a virtual remote adheres to the same logic as real remotes. Pairing needs to be done within 2 minutes after power-on of the Itho unit by sending a 'join' command from the add-on to the Itho unit automatically (as set on the System settings webpage) or manual with the 'Join' button on the Debug webpage. Sending a leave will unlearn all remotes from the Itho unit.

The add-on can also act as a continuous speed controller (only for CVE units and the HRU200). The add-on then communicates with the Itho unit via the I2C bus, sending speed commands which control the unit between 0 and 254 (minimum speed dependent on itho settings). This control is only possible if the Itho unit is in auto or medium setting. Auto or medium mode can be enforced with the virtual remote enabled by switching on the ‘force medium’ setting on the add-on System settings page.

Connecting remotes

Pre-requisites

  • Add-on with supported RF receiver, e.g. non-CVE with CC1101 RF Module.

Use-cases

Remotes known to be working

RFT Remote W (RFT bediening stand 1,2,3,T) (536-0124):

RFT Remote AUTO (RFT bediening stand 1,A,3,T) (536-0150):

A button press on the button marked with "A" sends the command "medium".
This remote is also known by the old name 'RFT AUTO CO2', where CO2 is misleading since the remote does not provide CO2 data.
Since firmware version 2.0.4 the buttons of this remote are working. The RF performance seems to be improved a lot with firmware version 2.0.5 so it I included it in the supported list again.

Itho RFT-RV typenr 04-00046:
when paired to the Itho unit, speed is visible on the remote, values of the remote are also available within the add-on.
When paired to the add-on, speed is not visible, the remotesinfo message shows battery status.

Itho RFT-CO2 typenr 04-00045 see Itho RTF CO2 sensor:
when paired to the Itho unit, speed is visible on remote, values of the remote are also available within the add-on.
When paired to the add-on, speed is not visible.

Remotes known to be not working

Trying to add a non working remote manually

  1. Turn debug level1 on in a new tab: http://[nrg-itho-A1B2]/api.html?debug=level1
  2. Go back to the main web interface of the add-on
  3. Press 4 buttons at the same time to send a leave command (or try any other button)
  4. In the web interface there will be a debug message (blue box on the top), the remote ID (and command type is shown), copy that ID. (press the button multiple times to have a little bit more time to copy an ID)
  5. Go to: http://[nrg-itho-A1B2]/edit (username/pwd both admin)
  6. Edit remotes.json and replace an empty slot ie.:
 {"index":0,"id":[0,0,0],"name":"remote"} 

with the remote ID ie.:

{"index":0,
"id":[106,153,102],
"name":"remote"}
  1. Save the file and reboot the add-on
  2. Remote commands should be working now

== To further debug command switch to debug level2: http://[nrg-itho-A1B2]/api.html?debug=level2 The needed command bytes to implement a non working button will now also be visible on the debug message

Debug level3 will show IDs and commands for all packets received, also non itho devices and can clutter the interface.