Communication - Itho¶

Itho RFT fan control using a CC1101 transceiver

Plugin details¶

Type: Communication

Name: Itho

Status: COLLECTION D

Maintainer: svollebregt

Used libraries: https://github.com/arjenhiemstra/IthoEcoFanRFT/tree/master/Master (currently using 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 a Itho remote, and can also monitor for commands send by other remotes.

Wiring¶

The CC1101 transceiver is controlled via SPI and also requires another pin for the interrupt to let the ESP know a data packet arrived. Make sure to enable SPI under the ESPEasy hardware configuration.

CC1101 pin                    ESP pin                 Description
- Vcc                       Vcc                     3.3V
- GND                       GND                     Ground
- MOSI      <--             D7/GPIO13               Data input to CC1101
- SCK       <--             D5/GPIO14               SPI clock pin
- MISO      -->             D6/GPIO12               Data output from CC1101
- GDO2      -->             Choose                  Interrupt pin (see note)
- GDO0                      NC                      Not in use
- 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 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).

Device Settings¶

Unit ID remote X 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,
Enable RF receive log When enabled all recieved RF packages will be shown in the ESPEasy log under debug. Useful to determine the ID of other remotes. Disable when not necessary to reduce writing to the log.
Device ID byte X 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.

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
`state`	Use the states in the table below to control the state of the fan. To pair the remote with the Itho fan use 1111 or 9999 are for join or leave, respectively.

Examples:

HTTP control: http://ip/control?cmd=STATE,1
MQTT conrol: mosquitto_pub -t /Fan/cmd -m ‘state 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)

Two special states exist: 1111 for a join command and 9999 for a leave command, check the Itho manual on how to put your fain into pairing mode.

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: …

added 2021-12-26 Initial release version.