Communication - Itho¶
Itho RFT fan control using a CC1101 transceiver
Plugin details¶
Type: Communication
Name: Itho
Status: COLLECTION F CLIMATE
GitHub: _P118_Itho.ino
Maintainer: svollebregt
Used libraries: https://github.com/arjenhiemstra/IthoEcoFanRFT/tree/master/Master (currently using a local adapted version of v2.0.0, due to v2.1.0 recieve issues i.c.w. plugin)
Description¶
This plugin enables communication with an Itho RFT fan (and some Duco fans) through a CC1101 868 MHz transceiver. It allows controlling the fan speed by simulating an Itho remote, and can also monitor for commands sent by other remotes.
Wiring¶
The CC1101 transceiver is controlled via SPI and also requires an pin for the interrupt to let the ESP know a data packet has arrived. Make sure to enable SPI under the ESPEasy hardware configuration.
CC1101 pin ESP pin Description
1 - Vcc Vcc 3.3V
2 - GND GND Ground
3 - MOSI <-- D7/GPIO13 Data input to CC1101
4 - SCK <-- D5/GPIO14 SPI clock pin
5 - MISO --> D6/GPIO12 Data output from CC1101
6 - GDO2 --> Choose Interrupt pin (see note)
7 - GDO0 NC Not in use
8 - CSN <-- D8/GPIO15 SPI chip select
Note
Any pin of the ESP can be used except for SPI pins, boot related pints (GPIO0, GPIO2, GPIO15), or GPIO16 (no interrupt support). If you use I2C pins for the interrupt make sure to disable I2C in the ESPEasy hardware configuration.
Configuration¶
Name Required by ESPEasy, must be unique among the list of available devices/tasks. Used in MQTT commands
Enabled The device can be disabled or enabled. When not enabled the device should not use any resources.
Sensor¶
GPIO <- Interrupt pin (CC1101 GDO2): Input interrupt pin of the ESPEasy, should be connected to CC1101 GDO2. Don’t use ESP boot related pints (GPIO0, GPIO2, GPIO15) or GPIO16 (no interrupt support). When this setting is set to
- None -
it will be iognored, but receiving the messages sent from other controllers is not possible. Sending commands to the ITHO ventilation unit is still possible.GPIO -> CS pin (CC1101 CSN): The output pin to connect to the CS/CSN line of the CC1101 controller. The previous fixed setting of GPIO 15 is filled by default, but can be changed if multiple tranceiver units can be connected to the ESP.
Remote RF Controls¶
Unit ID remote 1..3: ID of another remote that controls your Itho fan. When set it allows the plugin to monitor for commands and act on them. The ID consist out of 3 numbers separated by ‘,’. Up to 3 remotes are supported. After the controller is joined with the ventilation unit, and enabling the Enable minimal RF INFO log option below, these ID’s can be extracted from the logs at the INFO level by pressing a button on the remote. Most remotes will repeat a command ca. 3 times, in case there is disturbance in communication, so that should be easily recognizable.
Enable RF DEBUG log: When enabled all recieved RF packages will be shown in the ESPEasy log at DEBUG level. Useful to determine the ID of other remotes and the messages they send. Disable when not necessary to reduce writing to the log. (Only available when Debug logging is available in the build.)
Enable minimal RF INFO lgo: When enabled, this will write the ID and raw command sent from any device using the same frequency and protocol. Can be used to determine entries for Unit ID remote 1..3. Disable when not necessary to reduce writing to the log.
Device ID byte 1..3: Device ID of the ESPEasy plugin, defaults to 10,87,81. The plugin acts as a remote and can have a unique ID. Can be changed from default if you have interference with neighbours. After a change you should again join the ESP with the fan.
Enable Orcon support: Enables the extra protocol for the Orcon brand of ventilation units, that use the same protocol, but with a different command set. To avoid possible interference, it is disabled by default.
Data Acquisition¶
This group of settings, Single event with all values and Send to Controller settings are standard available configuration items. Send to Controller is only visible when one or more Controllers are configured.
Values¶
The plugin has 3 values to indicate the status of the fan:
State
shows the state of the last command send to the fan
Timer
shows the value of the timer
LastIDindex
shows the index of the last remote from which a command was received (1 to 3)
Commands available¶
Command Syntax |
Extra information |
---|---|
itho,<state> (Command was
state , but that has been deprecated) |
Use the states in the table below to control the state of the fan. To pair the remote with the Itho fan use 1111 to join, or 9999 to leave/unjoin, respectively.
|
Examples:
HTTP control: http://ip/control?cmd=ITHO,1
MQTT conrol: mosquitto_pub -t /Fan/cmd -m ‘itho 1’ Here ‘Fan’ is the name of the plugin
Fan states¶
State |
Name |
Description |
---|---|---|
0 |
Standby |
Itho ventilation unit on standby (not supported on most models) |
1 |
Low |
Itho ventilation to lowest speed |
2 |
Medium |
Itho ventilation to medium speed |
3 |
High |
Itho ventilation to high speed |
4 |
Full |
Itho ventilation to full speed (same as high on most models) |
13 |
Timer1 |
Itho to high speed with hardware timer (10 min) |
23 |
Timer2 |
Itho to high speed with hardware timer (20 min) |
33 |
Timer3 |
Itho to high speed with hardware timer (30 min) |
1111 |
Join with an ITHO ventilation unit that is waiting for join requests (first minutes after power-on) |
|
9999 |
Leave connection with an ITHO ventilation unit (maybe not supported on all models). Needs a new Join (1111) to be able to control a unit. |
|
100 |
Orcon standBy |
Orcon ventilation unit on standby |
101 |
Orcon low speed |
Orcon ventilation to lowest speed |
102 |
Orcon medium speed |
Orcon ventilation to medium speed |
103 |
Orcon high speed |
Itho ventilation to high speed |
104 |
Orcon auto speed |
Itho ventilation to auto speed (based on Humidity and/or CO2) |
110 |
Orcon Timer 0 |
Orcon ventilation unit on standby for 12*60 minutes |
111 |
Orcon Timer 1 |
Orcon ventilation to lowest speed for 60 minutes |
112 |
Orcon Timer 2 |
Orcon ventilation unit to medium speed for 13*60 minutes |
113 |
Orcon Timer 3 |
Orcon ventilation unit to high speed for 60 minutes |
114 |
Orcon Auto CO2 |
Itho ventilation to auto speed for 60 minutes (based on Humidity and/or CO2) |
Two special states exist: 1111 for a join command and 9999 for a leave/unjoin command, check the Itho manual on how to put your fain into pairing mode.
For Orcon the Unit ID remote 1 will be used as the spoofed sender ID
Rules examples¶
Below an example on how to synchronize the plugin with a level switch in Domoticz
on Itho#State do
if [Itho#State]=0
Publish domoticz/in,'{"command":"switchlight","idx":IDX,"switchcmd":"Set Level","level":0}'
elseif [Itho#State]=1
Publish domoticz/in,'{"command":"switchlight","idx":IDX,"switchcmd":"Set Level","level":10}'
elseif [Itho#State]=2
Publish domoticz/in,'{"command":"switchlight","idx":IDX,"switchcmd":"Set Level","level":20}'
elseif [Itho#State]=3
Publish domoticz/in,'{"command":"switchlight","idx":IDX,"switchcmd":"Set Level","level":30}'
elseif [Itho#State]=4
Publish domoticz/in,'{"command":"switchlight","idx":IDX,"switchcmd":"Set Level","level":40}'
elseif [Itho#State]=13
if [Itho#Timer]=599
Publish domoticz/in,'{"command":"switchlight","idx":IDX,"switchcmd":"Set Level","level":50}'
endif
elseif [Itho#State]=23
if [Itho#Timer]=1199
Publish domoticz/in,'{"command":"switchlight","idx":IDX,"switchcmd":"Set Level","level":60}'
endif
elseif [Itho#State]=33
if [Itho#Timer]=1799
Publish domoticz/in,'{"command":"switchlight","idx":IDX,"switchcmd":"Set Level","level":70}'
endif
endif
endon
Change log¶
Changed in version 2.0: .
changed
2023-03-05: Deprecate state
command, introduce itho
command.
- added
2022-08-18: Add support for Orcon devices.
- added
2022-08-10: Made multi-instance compatible, CS pin configurable and interrupt pin usage optional.
- added
2021-12-26 Initial release version.