GPIO Conversion

GPIO functions define the action being taken by a device connected to it's pin. The current GPIO function configuration supports 216 GPIO functions like Relay1 (21) or Inverted Button1 (122).

The current implementation supports up to 250 functions as it is confined to 8-bits uint8_t arrays.

As more devices need to be connected it would become impossible to have them addressed with this 8-bit scheme. Another problem is that the current implementation would need GUI drop down boxes with up to 250 items which is hard to use. Also user templates still need to be able to address all possible GPIO functions.

To solve this issue Theo needed to change from 8-bit uint8_t to 16-bit uint16_t arrays. Without further action this would result in even more entries in the GUI drop down boxes and made adding more relays, buttons, switches, etc also very cumbersome. As the ESP32 would need to be supported too a challenge lay ahead.

Theo decided for the following option where every GPIO function type (relays, buttons, switches) would have an id allowing for 32 devices. So every GPIO function would be offset by 32 (or 5-bits). These 5-bits can be used in the future to easily expand current max values like 4 buttons or 8 relays to max 32. How this works could have been seen in the ESP32 implementation. The GUI now contains two drop down boxes, one for the GPIO function (Relay) and one for the function index (1 to 8).

For the ESP8266 the current maxed GPIO functions of 216 will be fixed an any new device will be using the GPIO addressing scheme. To make the transition transparent, a table is used to convert current 216 GPIO 8-bit function numbers to new 16-bit function numbers. As both are offset from 0 there will be some duplication in numbering so the only way to distinguish them by external programs like TDM is by checking the Tasmota version number: below 9.0 will be 8-bit GPIO and starting with development version 9.0.0.1 it will be 16-bit GPIO.

See below how the numbers are being converted. The first number is 8-bit GPIO, the second the 16-bit GPIO.

GPIO Conversion~

Old GPIO	New GPIO	Name	Description
255	1	User	User
0	0	None	Not used
1	1184	DHT11	DHT11 sensor
2	1216	AM2301	AM230X, DHT21 and DHT22 sensor
3	1248	SI7021	Only for Sonoff Si7021, not the i2c version
4	1312	DS18x20	Dallas Semiconductor DS18b20 1-Wire temperature sensor
5	608	I2C SCL	I2C serial clock pin, used with any I2C component (sensors, displays, ...)
6	640	I2C SDA	I2C serial data pin, used with any I2C component (sensors, displays, ...)
7	1376	WS2812	Addressable LEDs such as WS281X or Neopixel
8	1056	IRsend	IR Transmitter LED
9	160	Switch1	Switch
10	161	Switch2	Switch
11	162	Switch3	Switch
12	163	Switch4	Switch
13	164	Switch5	Switch
14	165	Switch6	Switch
15	166	Switch7	Switch
16	167	Switch8	Switch
17	32	Button1	Button
18	33	Button2	Button
19	34	Button3	Button
20	35	Button4	Button
21	224	Relay1	Relay
22	225	Relay2	Relay
23	226	Relay3	Relay
24	227	Relay4	Relay
25	228	Relay5	Relay
26	229	Relay6	Relay
27	230	Relay7	Relay
28	231	Relay8	Relay
29	256	Relay1i	Relay inverted
30	257	Relay2i	Relay inverted
31	258	Relay3i	Relay inverted
32	259	Relay4i	Relay inverted
33	260	Relay5i	Relay inverted
34	261	Relay6i	Relay inverted
35	262	Relay7i	Relay inverted
36	263	Relay8i	Relay inverted
37	416	PWM1	Pulse Width Modulated Output
38	417	PWM2	Pulse Width Modulated Output
39	418	PWM3	Pulse Width Modulated Output
40	419	PWM4	Pulse Width Modulated Output
41	420	PWM5	Pulse Width Modulated Output
42	352	Counter1	Counter Input
43	353	Counter2	Counter Input
44	354	Counter3	Counter Input
45	355	Counter4	Counter Input
46	448	PWM1i	Pulse Width Modulated inverted Output
47	449	PWM2i	Pulse Width Modulated inverted Output
48	450	PWM3i	Pulse Width Modulated inverted Output
49	451	PWM4i	Pulse Width Modulated inverted Output
50	452	PWM5i	Pulse Width Modulated inverted Output
51	1088	IRrecv	IR Receiver Input (for example TSOP1838)
52	288	Led1	LED
53	289	Led2	LED
54	290	Led3	LED
55	291	Led4	LED
56	320	Led1i	Inverted LED - default state ON
57	321	Led2i	Inverted LED - default state ON
58	322	Led3i	Inverted LED - default state ON
59	323	Led4i	Inverted LED - default state ON
60	1408	MHZ Rx	MHZ 19 CO₂ Sensor
61	1440	MHZ Tx	MHZ 19 CO₂ Sensor
62	1472	PZEM0XX Tx	Peacefair Pzem-0XX Power Meter Tx pin
63	1504	PZEM004 Rx	Peacefair Pzem-004 Power Meter Rx pin
64	1600	SAir Rx	Sensor Senseair
65	1632	SAir Tx	Sensor Senseair
66	768	SPI CS	SPI Interface (ePaper Display)
67	800	SPI DC	SPI Interface (ePaper Display)
68	992	BkLight	Backlight (Display)
69	1696	PMS5003	PMS5003 Air Quality Sensor
70	1760	SDS0X1 Rx	Nova Fitness SDS011 Laser Dust Sensor Rx pin
71	1792	SerBr Rx	Serial Bridge Receive
72	1824	SerBr Tx	Serial Bridge Transmit
73	1856	SR04 Tri	Ultrasonic Sensor HC-SR04 Trigger pin
74	1888	SR04 Ech	Ultrasonic Sensor HC-SR04 Echo pin
75	1920	SDMx20 Tx	SDMx20-Modbus Multifunction Power Analyser Tx pin
76	1952	SDMx20 Rx	SDMx20-Modbus Multifunction Power Analyser Rx pin
77	1984	SDM630 Tx	SDM630-Modbus Multifunction Power Analyser Tx pin
78	2016	SDM630 Rx	SDM630-Modbus Multifunction Power Analyser Rx pin
79	2048	TM16 CLK	TM1638 Switch Module
80	2080	TM16 DIO	TM1638 Switch Module
81	2112	TM16 STB	TM1638 Switch Module
82	192	Switch1n	Switch, no pullup resistor
83	193	Switch2n	Switch, no pullup resistor
84	194	Switch3n	Switch, no pullup resistor
85	195	Switch4n	Switch, no pullup resistor
86	196	Switch5n	Switch, no pullup resistor
87	197	Switch6n	Switch, no pullup resistor
88	198	Switch7n	Switch, no pullup resistor
89	199	Switch8n	Switch, no pullup resistor
90	64	Button1n	Button, no pullup resistor
91	65	Button2n	Button, no pullup resistor
92	66	Button3n	Button, no pullup resistor
93	67	Button4n	Button, no pullup resistor
94	384	Counter1n	Counter sensor, no pullup resistor
95	385	Counter2n	Counter sensor, no pullup resistor
96	386	Counter3n	Counter sensor, no pullup resistor
97	387	Counter4n	Counter sensor, no pullup resistor
98	1536	PZEM016 Rx	Peacefair Pzem-016 Power Meter Rx pin
99	1568	PZEM017 Rx	Peacefair Pzem-017 Power Meter Rx pin
100	2144	MP3 Player	DF MP3 Player mini (Input)
101	1728	SDS0X1 Tx	Nova Fitness SDS011 Laser Dust Sensor Tx pin
102	2176	HX711 SCK	HX711 weight sensor serial clock input
103	2208	HX711 DAT	HX711 weight sensor data output
104	2240	TX20	TX20 Wind Sensor Input (Tx from sensor)
105	1120	RFSend	RF Emitter (433Mhz module needed; Requires self-compile with RF_SENSOR and USE_RC_SWITCH)
106	1152	RFrecv	RF Receiver (433Mhz module needed; Requires self-compile with RF_SENSOR and USE_RC_SWITCH)
107	2272	Tuya Tx	Tuya Transfer pin
108	2304	Tuya Rx	Tuya Receive pin
109	2336	MGC3130 Xfr	MGC3130 E-field Xfr pin
110	2368	MGC3130 Rst	MGC3130 E-field Reset pin
111	832	SSPI MISO	Software SPI MISO (Display)
112	864	SSPI MOSI	Software SPI MOSI (Display)
113	896	SSPI SCLK	Software SPI SCLK (Display)
114	928	SSPI CS	Software SPI CS (Display)
115	960	SSPI DC	Software SPI DC (Display)
116	2400	RF Sensor	Theo Arendst RF433 Sensor
117	2432	AZ Rx	AZ 7798 CO₂ datalogger
118	2464	AZ Tx	AZ 7798 CO₂ datalogger
119	2496	MX31855 CS	MAX31855 Thermocouple Sensor Chip Select pin
120	2528	MX31855 CLK	MAX31855 Thermocouple Sensor Serial Clock pin
121	2560	MX31855 DO	MAX31855 Thermocouple Sensor Digital Output pin
122	96	Button1i	Button inverted
123	97	Button2i	Button inverted
124	98	Button3i	Button inverted
125	99	Button4i	Button inverted
126	128	Button1in	Button inverted, no pullup resistor
127	129	Button2in	Button inverted, no pullup resistor
128	130	Button3in	Button inverted, no pullup resistor
129	131	Button4in	Button inverted, no pullup resistor
130	2592	HLWBL SEL	Energy Monitoring (for example Pow)
131	2624	HLWBL SELi	Energy Monitoring (for example Pow)
132	2656	HLWBL CF1	Energy Monitoring (for example Pow)
133	2688	HLW8012 CF	HLW8012 Single Phase Energy Monitor Chip CF pin
134	2720	BL0937 CF	BL0937 Single Phase Energy Monitor Chip CF pin
135	2752	MCP39F5 Tx	Energy Monitoring (for example Shelly2)
136	2784	MCP39F5 Rx	Energy Monitoring (for example Shelly2)
137	2816	MCP39F5 Rst	Energy Monitoring (for example Shelly2)
138	2848	PN532 Tx	PN532 RFID/NFC Reader Tx pin
139	2880	PN532 Rx	PN532 RFID/NFC Reader Rx pin
140	2912	SM16716 CLK	SM16716 Pixel LED Serial Clock pin
141	2944	SM16716 DAT	SM16716 Pixel LED Data pin
142	2976	SM16716 PWR	SM16716 Pixel LED Power pin
143	3008	MY92x1 DI	Light Bulb with MY92x controller
144	3040	MY92x1 DCKI	Light Bulb with MY92x controller
145	3072	CSE7766 Tx	CSE7766 Single Phase Energy Monitor Chip Tx pin
146	3104	CSE7766 Rx	CSE7766 Single Phase Energy Monitor Chip Rx pin
147	3136	ALux IrRcv	AriLux RGB Controller IR receive (Input)
148	3200	Serial Tx	Serial Transfer pin
149	3232	Serial Rx	Serial Receive pin
150	3264	Rotary1a	Rotary Encoder (Mi Desk Lamp)
151	3296	Rotary1b	Rotary Encoder (Mi Desk Lamp)
152	3265	Rotary2a	Rotary Encoder (Mi Desk Lamp)
153	3297	Rotary2b	Rotary Encoder (Mi Desk Lamp)
154	3392	HRE CLOCK	Clock/Power line for HR-E Water Meter
155	3424	HRE DATA	Data line for HR-E Water Meter
156	3456	ADE7953_IRQ	ADE7953 IRQ
157	544	LedLink	Device Status LED
158	576	LedLinki	Device Status LED, inverted
159	3168	ALux IrSel	For AriLux devices - switches between IR/RF mode
160	480	Buzzer	Sonoff iFan03 Buzzer
161	512	Buzzeri	Sonoff iFan03 Buzzer inverted
162	1024	OLED Reset	OLED Display Reset
163	3488	SolaxX1 Tx	Solax Inverter Tx pin
164	3520	SolaxX1 Rx	Solax Inverter Rx pin
165	3552	Zigbee Tx	Zigbee Serial interface Tx
166	3584	Zigbee Rx	Zigbee Serial interface Rx
167	3616	RDM6300 Rx	RDM6300 RX
168	3648	iBeacon Tx	HM17 iBeacon Tx
169	3680	iBeacon Rx	HM17 iBeacon Rx
170	3712	A4988 DIR	A4988 Motor Direction
171	3744	A4988 STP	A4988 Step motor
172	3776	A4988 ENA	A4988 Enable motor
173	3808	A4988 MS1	A4988 Microstep increment select pin1
174	3809	A4988 MS2	A4988 Microstep increment select pin2
175	3810	A4988 MS3	A4988 Microstep increment select pin3
176	3904	DDS238-2 Tx	DDS2382 Serial interface Tx
177	3936	DDS238-2 Rx	DDS2382 Serial interface Rx
178	3968	DDSU666 Tx	DDSU666 Serial interface Tx
179	4000	DDSU666 Rx	DDSU666 Serial interface Rx
180	4032	SM2135 CLK	SM2135 Clk
181	4064	SM2135 DAT	SM2135 Dat
182	4096	DeepSleep	DeepSleep wake switch
183	4128	EXS Enable	EXS Dimmer MCU Enable
184	4160	Slave TX	TasmotaClient TX
185	4192	Slave RX	TasmotaClient RX
186	4224	Slave RST	TasmotaClient Reset Pin
187	4256	Slave RSTi	TasmotaClient Reset Inverted
188	4288	HPMA RX	Honeywell HPMA115S0 Serial Rx
189	4320	HPMA TX	Honeywell HPMA115S0 Serial Tx
190	4352	GPS RX	GPS Serial Tx
191	4384	GPS TX	GPS Serial Tx
192	1344	DSB OUT	Pseudo Single wire DS18B20 or DS18S20
193	1280	DHT11 OUT	Pseudo Single wire DHT11, DHT21, DHT22, AM2301, AM2302, AM2321
194	4416	HM10 RX	HM10-BLE-Mijia-bridge Serial
195	4448	HM10 TX	HM10-BLE-Mijia-bridge Serial
196	4480	LE01MR RX	F&F LE-01MR Energy Meter Serial
197	4512	LE01MR TX	F&F LE-01MR Energy Meter Serial
198	4544	CC1101 GDO0	CC1101 RX Pin
199	4576	CC1101 GDO2	CC1101 TX Pin
200	4608	HRXL RX	Data from MaxBotix HRXL sonar range sensor
201	4640	MOODL TX	ElectriQ iQ-wifiMOODL Serial TX
202	4672	AS3935	Lightning Detector Interrupt Pin
203	1664	PMS5003 TX	Plantower PMS5003 Serial interface
204	4928	Boiler OT Rx	OpenTherm Boiler RX pin
205	4960	Boiler OT Tx	OpenTherm Boiler TX pin
206	4992	Windmeter Speed	WindMeter speed counter pin
207	5056	BL0940 RX	BL0940 serial interface
208	5088	TCP TX	TCP Serial bridge
209	5120	TCP RX	TCP Serial bridge
210	5152	TELEINFO RX	Teleinfo serial interface
211	5184	TELEINFO Enable	Teleinfo Enable PIN
212	5216	LMT01	LMT01 input counting pin
213	5248	IEM3000 TX	IEM3000 Serial interface
214	5280	IEM3000 RX	IEM3000 Serial interface
215	5312	Zigbee RST	Zigbee reset
216	5344	DYP Rx	DYP-ME007 Rx pin

ADC Conversion~

Old ADC	New ADC	Option	WebUI display	MQTT message
0	0	None	none	none
1	4704	Analog	Analog0 %value%	{"A0":%value%}
2	4736	Temperature	Temperature %value% °C (°F)	{"Temperature":%value%},"TempUnit":"C"}
3	4768	Light	Illuminance %value% lux	{"Illuminance":%value%}
4	4800	Button	none	none
5	4832	Buttoni	none	none
6	4864	Range	Range %value%	{"Range":%value%}
7	4896	CT Power	Voltage 230 V Current %value A Power %value W Energy Total %value kWh	{"Energy":%value,"Power":%value,"Voltage":230,"Current":%value}
8	3328	Joystick	none	{"ANALOG":{"Joy1":%value%}