Components - FengtianGu/Sonoff-Tasmota GitHub Wiki

Component is anything wired to the ESP8266 to be controlled by or send data to it.

Components can be: buttons, switches, relays, LEDs, sensors, displays, MCU units, etc. Every component is assigned to the ESP8266 GPIO it is wired (connected) to in the device template.

Every Tasmota device has some components configured by default. Most often there is a relay, a button and a LED configured as is the case for a Sonoff Basic in the following image.

GPIOs configured as User (255) are the GPIOs that can be assigned to components in the Configure Module page. See next image for an example!

Adding Components

If you wish to expand a device with your own component, after properly wiring everything, you need to assign it to a free GPIO in Configure Module page or use command GPIO<x>.

Read more about adding specific sensors or adding components to a Sonoff Basic.

Components List

#	Name	Description
1	DHT11	DHT11 sensor
2	AM2301	AM230X, DHT21 and DHT22 sensor
3	SI7021	Only for Sonoff Si7021, not the i2c version
4	DS18x20	Dallas Semiconductor DS18b20 1-Wire temperature sensor
5	I2C SCL	I2C serial clock pin, used with any I2C component (sensors, displays, ...)
6	I2C SDA	I2C serial data pin, used with any I2C component (sensors, displays, ...)
7	WS2812	Addressable LEDs such as WS281X or Neopixel
8	IRsend	IR Transmitter LED
9	Switch1	Switch
10	Switch2	Switch
11	Switch3	Switch
12	Switch4	Switch
13	Switch5	Switch
14	Switch6	Switch
15	Switch7	Switch
16	Switch8	Switch
17	Button1	Button
18	Button2	Button
19	Button3	Button
20	Button4	Button
21	Relay1	Relay
22	Relay2	Relay
23	Relay3	Relay
24	Relay4	Relay
25	Relay5	Relay
26	Relay6	Relay
27	Relay7	Relay
28	Relay8	Relay
29	Relay1i	Relay inverted
30	Relay2i	Relay inverted
31	Relay3i	Relay inverted
32	Relay4i	Relay inverted
33	Relay5i	Relay inverted
34	Relay6i	Relay inverted
35	Relay7i	Relay inverted
36	Relay8i	Relay inverted
37	PWM1	Pulse Width Modulated Output
38	PWM2	Pulse Width Modulated Output
39	PWM3	Pulse Width Modulated Output
40	PWM4	Pulse Width Modulated Output
41	PWM5	Pulse Width Modulated Output
42	Counter1	Counter Input
43	Counter2	Counter Input
44	Counter3	Counter Input
45	Counter4	Counter Input
46	PWM1i	Pulse Width Modulated inverted Output
47	PWM2i	Pulse Width Modulated inverted Output
48	PWM3i	Pulse Width Modulated inverted Output
49	PWM4i	Pulse Width Modulated inverted Output
50	PWM5i	Pulse Width Modulated inverted Output
51	IRrecv	IR Receiver Input (for eample TSOP1838)
52	Led1	LED
53	Led2	LED
54	Led3	LED
55	Led4	LED
56	Led1i	Inverted LED - default state ON
57	Led2i	Inverted LED - default state ON
58	Led3i	Inverted LED - default state ON
59	Led4i	Inverted LED - default state ON
60	MHZ Rx	MHZ 19 Co2 Sensor
61	MHZ Tx	MHZ 19 Co2 Sensor
62	PZEM0XX Tx	Peacefair Pzem-0XX Power Meter Tx pin
63	PZEM004 Rx	Peacefair Pzem-004 Power Meter Rx pin
64	SAir Rx	Sensor Senseair
65	SAir Tx	Sensor Senseair
66	SPI CS	SPI Interface (ePaper Display)
67	SPI DC	SPI Interface (ePaper Display)
68	BkLight	Backlight (Display)
69	PMS5003	PMS5003 Air Quality Sensor
70	SDS0X1 Rx	Nova Fitness SDS011 Laser Dust Sensor Rx pin
71	SerBr Rx	Serial Bridge Receive
72	SerBr Tx	Serial Bridge Transmit
73	SR04 Tri	Ultrasonic Sensor HC-SR04 Trigger pin
74	SR04 Ech	Ultrasonic Sensor HC-SR04 Echo pin
75	SDMx20 Tx	SDMx20-Modbus Mutlifunction Power Analyser Tx pin
76	SDMx20 Rx	SDMx20-Modbus Mutlifunction Power Analyser Rx pin
77	SDM630 Tx	SDM630-Modbus Mutlifunction Power Analyser Tx pin
78	SDM630 Rx	SDM630-Modbus Mutlifunction Power Analyser Rx pin
79	TM16 CLK	TM1638 Switch Modul
80	TM16 DIO	TM1638 Switch Modul
81	TM16 STB	TM1638 Switch Modul
82	Switch1n	Switch, no pullup resistor
83	Switch2n	Switch, no pullup resistor
84	Switch3n	Switch, no pullup resistor
85	Switch4n	Switch, no pullup resistor
86	Switch5n	Switch, no pullup resistor
87	Switch6n	Switch, no pullup resistor
88	Switch7n	Switch, no pullup resistor
89	Switch8n	Switch, no pullup resistor
90	Button1n	Button, no pullup resistor
91	Button2n	Button, no pullup resistor
92	Button3n	Button, no pullup resistor
93	Button4n	Button, no pullup resistor
94	Counter1n	Counter sensor, no pullup resistor
95	Counter2n	Counter sensor, no pullup resistor
96	Counter3n	Counter sensor, no pullup resistor
97	Counter4n	Counter sensor, no pullup resistor
98	PZEM016 Rx	Peacefair Pzem-016 Power Meter Rx pin
99	PZEM017 Rx	Peacefair Pzem-017 Power Meter Rx pin
100	MP3 Player	DF MP3 Player mini (Input)
101	SDS0X1 Tx	Nova Fitness SDS011 Laser Dust Sensor Tx pin
102	HX711 SCK	HX711 weight sensor serial clock input
103	HX711 DAT	HX711 weight sensor data output
104	TX20	TX20 Wind Sensor (DTR or TxD?)
105	RFSend	RF Emitter (433Mhz module needed)
106	RFrecv	RF Receiver (433Mhz module needed)
107	Tuya Tx	Tuya Transfer pin
108	Tuya Rx	Tuya Receive pin
109	MGC3130 Xfr	MGC3130 E-field Xfr pin
110	MGC3130 Rst	MGC3130 E-field Reset pin
111	SSPI MISO	Software SPI MISO (Display)
112	SSPI MOSI	Software SPI MOSI (Display)
113	SSPI SCLK	Software SPI SCLK (Display)
114	SSPI CS	Software SPI CS (Display)
115	SSPI DC	Software SPI DC (Display)
116	RF Sensor	Theo Arendst RF433 Sensor
117	AZ Rx	AZ 7798 CO2 datalogger
118	AZ Tx	AZ 7798 CO2 datalogger
119	MX31855 CS	MAX31855 Thermocouple Sensor Chip Select pin
120	MX31855 CLK	MAX31855 Thermocouple Sensor Serial Clock pin
121	MX31855 DO	MAX31855 Thermocouple Sensor Digital Output pin
122	Button1i	Button inverted
123	Button2i	Button inverted
124	Button3i	Button inverted
125	Button4i	Button inverted
126	Button1in	Button inverted, no pullup resistor
127	Button2in	Button inverted, no pullup resistor
128	Button3in	Button inverted, no pullup resistor
129	Button4in	Button inverted, no pullup resistor
130	HLWBL SEL	Energy Monitoring (for example Pow)
131	HLWBL SELi	Energy Monitoring (for example Pow)
132	HLWBL CF1	Energy Monitoring (for example Pow)
133	HLW8012 CF	HLW8012 Single Phase Energy Monitor Chip CF pin
134	BL0937 CF	BL0937 Single Phase Energy Monitor Chip CF pin
135	MCP39F5 Tx	Energy Monitoring (for example Shelly2)
136	MCP39F5 Rx	Energy Monitoring (for example Shelly2)
137	MCP39F5 Rst	Energy Monitoring (for example Shelly2)
138	PN532 Tx	PN532 RFID/NFC Reader Tx pin
139	PN532 Rx	PN532 RFID/NFC Reader Rx pin
140	SM16716 CLK	SM16716 Pixel LED Serial Clock pin
141	SM16716 DAT	SM16716 Pixel LED Data pin
142	SM16716 PWR	SM16716 Pixel LED Power pin
143	MY92x1 DI	Light Bulb with MY92x controller
144	MY92x1 DCKI	Light Bulb with MY92x controller
145	CSE7766 Tx	CSE7766 Single Phase Energy Monitor Chip Tx pin
146	CSE7766 Rx	CSE7766 Single Phase Energy Monitor Chip Rx pin
147	ALux IrRcv	AriLux RGB Controller IR receive (Input)
148	Serial Tx	Serial Transfer pin
149	Serial Rx	Serial Receive pin
150	Rotary1a	Rotary Encoder (Mi Desk Lamp)
151	Rotary1b	Rotary Encoder (Mi Desk Lamp)
152	Rotary1c	Rotary Encoder (Mi Desk Lamp)
153	Rotary1d	Rotary Encoder (Mi Desk Lamp)
157	LedLink	Device Status LED
158	LedLinki	Device Status LED, inverted
159	ALux IrSel	For AriLux devices - switches between IR/RF mode