Communication - Itho

Itho RFT fan control using a CC1101 transceiver

Plugin details

Type: Communication

Name: Itho

Status: COLLECTION D

GitHub: _P118_Itho.ino

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

CC1101 868 MHz transceiver

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

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

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.