BlogContact

Pin mapping

Which ESP32 and expander pins the inputs, outputs and peripherals of the boneIO ESP 24x16A use

This page is for people writing their own firmware (e.g. SUPLA, Tasmota) or a configuration from scratch. You don't need it for normal setup — the installer at boneio.eu/esp and the ready YAML files already contain these pins.

The tables are generated from the controller's public ESPHome configuration, so they match the firmware. "Inverted" means the active state is low. Ports commented out in the YAML (e.g. Modbus, 1-Wire) are not in the tables — their pins are in the comments of the source file.

v0.5/v0.6

Source: discontinued/boneio-24x16_switches_v0_5-v0_6.yaml

I2C buses

BusSDASCL
bus_aGPIO14GPIO15
bus_bGPIO17GPIO33

Chips on I2C

ChipBusAddressYAML ID
PCF8575bus_a0x20pcf_inputs_1to14
PCF8575bus_a0x21pcf_inputs_15to28
PCF8574bus_a0x22pcf_inputs_28to35_menu
ina219bus_a0x40
ds1307bus_a0x68ds1307_time
MCP23017bus_b0x20mcp_right
MCP23017bus_b0x21mcp_left
SH1106_128X64bus_b0x3Coled_display
lm75bus_b0x48boneIO_temp

Inputs

NameYAML IDOnPinInverted
boneIO_buttonboneIO_buttonPCF8574 0x22 (pcf_inputs_28to35_menu)7 (P7)yes
IN_01in_01PCF8575 0x20 (pcf_inputs_1to14)0 (P00)yes
IN_02in_02PCF8575 0x20 (pcf_inputs_1to14)1 (P01)yes
IN_03in_03PCF8575 0x20 (pcf_inputs_1to14)2 (P02)yes
IN_04in_04PCF8575 0x20 (pcf_inputs_1to14)3 (P03)yes
IN_05in_05PCF8575 0x20 (pcf_inputs_1to14)4 (P04)yes
IN_06in_06PCF8575 0x20 (pcf_inputs_1to14)5 (P05)yes
IN_07in_07PCF8575 0x20 (pcf_inputs_1to14)6 (P06)yes
IN_08in_08PCF8575 0x20 (pcf_inputs_1to14)8 (P10)yes
IN_09in_09PCF8575 0x20 (pcf_inputs_1to14)9 (P11)yes
IN_10in_10PCF8575 0x20 (pcf_inputs_1to14)10 (P12)yes
IN_11in_11PCF8575 0x20 (pcf_inputs_1to14)11 (P13)yes
IN_12in_12PCF8575 0x20 (pcf_inputs_1to14)12 (P14)yes
IN_13in_13PCF8575 0x20 (pcf_inputs_1to14)13 (P15)yes
IN_14in_14PCF8575 0x20 (pcf_inputs_1to14)14 (P16)yes
IN_15in_15PCF8575 0x21 (pcf_inputs_15to28)6 (P06)yes
IN_16in_16PCF8575 0x21 (pcf_inputs_15to28)5 (P05)yes
IN_17in_17PCF8575 0x21 (pcf_inputs_15to28)4 (P04)yes
IN_18in_18PCF8575 0x21 (pcf_inputs_15to28)3 (P03)yes
IN_19in_19PCF8575 0x21 (pcf_inputs_15to28)2 (P02)yes
IN_20in_20PCF8575 0x21 (pcf_inputs_15to28)1 (P01)yes
IN_21in_21PCF8575 0x21 (pcf_inputs_15to28)0 (P00)yes
IN_22in_22PCF8575 0x21 (pcf_inputs_15to28)8 (P10)yes
IN_23in_23PCF8575 0x21 (pcf_inputs_15to28)9 (P11)yes
IN_24in_24PCF8575 0x21 (pcf_inputs_15to28)10 (P12)yes
IN_25in_25PCF8575 0x21 (pcf_inputs_15to28)11 (P13)yes
IN_26in_26PCF8575 0x21 (pcf_inputs_15to28)12 (P14)yes
IN_27in_27PCF8575 0x21 (pcf_inputs_15to28)13 (P15)yes
IN_28in_28PCF8575 0x21 (pcf_inputs_15to28)14 (P16)yes
IN_29in_29PCF8574 0x22 (pcf_inputs_28to35_menu)0 (P0)yes
IN_30in_30PCF8574 0x22 (pcf_inputs_28to35_menu)1 (P1)yes
IN_31in_31PCF8574 0x22 (pcf_inputs_28to35_menu)2 (P2)yes
IN_32in_32PCF8574 0x22 (pcf_inputs_28to35_menu)3 (P3)yes
IN_33in_33PCF8574 0x22 (pcf_inputs_28to35_menu)4 (P4)yes
IN_34in_34PCF8574 0x22 (pcf_inputs_28to35_menu)5 (P5)yes
IN_35in_35PCF8574 0x22 (pcf_inputs_28to35_menu)6 (P6)yes

Outputs

YAML IDNameOnPinInverted
out_01Switch 01MCP23017 0x21 (mcp_left)8 (GPB0)—
out_02Switch 02MCP23017 0x21 (mcp_left)9 (GPB1)—
out_03Switch 03MCP23017 0x21 (mcp_left)10 (GPB2)—
out_04Switch 04MCP23017 0x21 (mcp_left)11 (GPB3)—
out_05Switch 05MCP23017 0x21 (mcp_left)12 (GPB4)—
out_06Switch 06MCP23017 0x21 (mcp_left)13 (GPB5)—
out_07Switch 07MCP23017 0x21 (mcp_left)14 (GPB6)—
out_08Switch 08MCP23017 0x21 (mcp_left)15 (GPB7)—
out_09Switch 09MCP23017 0x20 (mcp_right)8 (GPB0)—
out_10Switch 10MCP23017 0x20 (mcp_right)9 (GPB1)—
out_11Switch 11MCP23017 0x20 (mcp_right)10 (GPB2)—
out_12Switch 12MCP23017 0x20 (mcp_right)11 (GPB3)—
out_13Switch 13MCP23017 0x21 (mcp_left)7 (GPA7)—
out_14Switch 14MCP23017 0x21 (mcp_left)6 (GPA6)—
out_15Switch 15MCP23017 0x21 (mcp_left)5 (GPA5)—
out_16Switch 16MCP23017 0x21 (mcp_left)4 (GPA4)—
out_17Switch 17MCP23017 0x21 (mcp_left)3 (GPA3)—
out_18Switch 18MCP23017 0x21 (mcp_left)2 (GPA2)—
out_19Switch 19MCP23017 0x21 (mcp_left)1 (GPA1)—
out_20Switch 20MCP23017 0x21 (mcp_left)0 (GPA0)—
out_21Switch 21MCP23017 0x20 (mcp_right)12 (GPB4)—
out_22Switch 22MCP23017 0x20 (mcp_right)13 (GPB5)—
out_23Switch 23MCP23017 0x20 (mcp_right)14 (GPB6)—
out_24Switch 24MCP23017 0x20 (mcp_right)15 (GPB7)—

Other pins

FunctionNameOnPinInverted
ethernet.clkethESP32GPIO0—
switch.gpioBuzzerESP32GPIO2—
ethernet.power_pinethESP32GPIO16—
ethernet.mdio_pinethESP32GPIO18—
ethernet.mdc_pinethESP32GPIO23—

v0.7

Source: discontinued/boneio-24x16_switches_v0_7.yaml

I2C buses

BusSDASCL
i2c_busGPIO17GPIO33

Chips on I2C

ChipBusAddressYAML ID
PCF8575i2c_bus0x20pcf_inputs_1to14
PCF8575i2c_bus0x21pcf_inputs_15to28
PCF8574i2c_bus0x22pcf_inputs_28to35_menu
MCP23017i2c_bus0x23mcp_left
MCP23017i2c_bus0x24mcp_right
SH1106_128X64i2c_bus0x3Coled_display
ina219i2c_bus0x40
lm75i2c_bus0x48boneIO_temp

Inputs

NameYAML IDOnPinInverted
boneIO_buttonboneIO_buttonPCF8574 0x22 (pcf_inputs_28to35_menu)7 (P7)yes
IN_01in_01PCF8575 0x20 (pcf_inputs_1to14)0 (P00)yes
IN_02in_02PCF8575 0x20 (pcf_inputs_1to14)1 (P01)yes
IN_03in_03PCF8575 0x20 (pcf_inputs_1to14)2 (P02)yes
IN_04in_04PCF8575 0x20 (pcf_inputs_1to14)3 (P03)yes
IN_05in_05PCF8575 0x20 (pcf_inputs_1to14)4 (P04)yes
IN_06in_06PCF8575 0x20 (pcf_inputs_1to14)5 (P05)yes
IN_07in_07PCF8575 0x20 (pcf_inputs_1to14)6 (P06)yes
IN_08in_08PCF8575 0x20 (pcf_inputs_1to14)8 (P10)yes
IN_09in_09PCF8575 0x20 (pcf_inputs_1to14)9 (P11)yes
IN_10in_10PCF8575 0x20 (pcf_inputs_1to14)10 (P12)yes
IN_11in_11PCF8575 0x20 (pcf_inputs_1to14)11 (P13)yes
IN_12in_12PCF8575 0x20 (pcf_inputs_1to14)12 (P14)yes
IN_13in_13PCF8575 0x20 (pcf_inputs_1to14)13 (P15)yes
IN_14in_14PCF8575 0x20 (pcf_inputs_1to14)14 (P16)yes
IN_15in_15PCF8575 0x21 (pcf_inputs_15to28)6 (P06)yes
IN_16in_16PCF8575 0x21 (pcf_inputs_15to28)5 (P05)yes
IN_17in_17PCF8575 0x21 (pcf_inputs_15to28)4 (P04)yes
IN_18in_18PCF8575 0x21 (pcf_inputs_15to28)3 (P03)yes
IN_19in_19PCF8575 0x21 (pcf_inputs_15to28)2 (P02)yes
IN_20in_20PCF8575 0x21 (pcf_inputs_15to28)1 (P01)yes
IN_21in_21PCF8575 0x21 (pcf_inputs_15to28)0 (P00)yes
IN_22in_22PCF8575 0x21 (pcf_inputs_15to28)8 (P10)yes
IN_23in_23PCF8575 0x21 (pcf_inputs_15to28)9 (P11)yes
IN_24in_24PCF8575 0x21 (pcf_inputs_15to28)10 (P12)yes
IN_25in_25PCF8575 0x21 (pcf_inputs_15to28)11 (P13)yes
IN_26in_26PCF8575 0x21 (pcf_inputs_15to28)12 (P14)yes
IN_27in_27PCF8575 0x21 (pcf_inputs_15to28)13 (P15)yes
IN_28in_28PCF8575 0x21 (pcf_inputs_15to28)14 (P16)yes
IN_29in_29PCF8574 0x22 (pcf_inputs_28to35_menu)0 (P0)yes
IN_30in_30PCF8574 0x22 (pcf_inputs_28to35_menu)1 (P1)yes
IN_31in_31PCF8574 0x22 (pcf_inputs_28to35_menu)2 (P2)yes
IN_32in_32PCF8574 0x22 (pcf_inputs_28to35_menu)3 (P3)yes
IN_33in_33PCF8574 0x22 (pcf_inputs_28to35_menu)4 (P4)yes
IN_34in_34PCF8574 0x22 (pcf_inputs_28to35_menu)5 (P5)yes
IN_35in_35PCF8574 0x22 (pcf_inputs_28to35_menu)6 (P6)yes

Outputs

YAML IDNameOnPinInverted
out_01Switch 01MCP23017 0x23 (mcp_left)8 (GPB0)—
out_02Switch 02MCP23017 0x23 (mcp_left)9 (GPB1)—
out_03Switch 03MCP23017 0x23 (mcp_left)10 (GPB2)—
out_04Switch 04MCP23017 0x23 (mcp_left)11 (GPB3)—
out_05Switch 05MCP23017 0x23 (mcp_left)12 (GPB4)—
out_06Switch 06MCP23017 0x23 (mcp_left)13 (GPB5)—
out_07Switch 07MCP23017 0x23 (mcp_left)14 (GPB6)—
out_08Switch 08MCP23017 0x23 (mcp_left)15 (GPB7)—
out_09Switch 09MCP23017 0x24 (mcp_right)8 (GPB0)—
out_10Switch 10MCP23017 0x24 (mcp_right)9 (GPB1)—
out_11Switch 11MCP23017 0x24 (mcp_right)10 (GPB2)—
out_12Switch 12MCP23017 0x24 (mcp_right)11 (GPB3)—
out_13Switch 13MCP23017 0x23 (mcp_left)7 (GPA7)—
out_14Switch 14MCP23017 0x23 (mcp_left)6 (GPA6)—
out_15Switch 15MCP23017 0x23 (mcp_left)5 (GPA5)—
out_16Switch 16MCP23017 0x23 (mcp_left)4 (GPA4)—
out_17Switch 17MCP23017 0x23 (mcp_left)3 (GPA3)—
out_18Switch 18MCP23017 0x23 (mcp_left)2 (GPA2)—
out_19Switch 19MCP23017 0x23 (mcp_left)1 (GPA1)—
out_20Switch 20MCP23017 0x23 (mcp_left)0 (GPA0)—
out_21Switch 21MCP23017 0x24 (mcp_right)12 (GPB4)—
out_22Switch 22MCP23017 0x24 (mcp_right)13 (GPB5)—
out_23Switch 23MCP23017 0x24 (mcp_right)14 (GPB6)—
out_24Switch 24MCP23017 0x24 (mcp_right)15 (GPB7)—

Other pins

FunctionNameOnPinInverted
ethernet.clkethESP32GPIO0—
switch.gpioBuzzerESP32GPIO2—
ethernet.power_pinethESP32GPIO16—
ethernet.mdio_pinethESP32GPIO18—
ethernet.mdc_pinethESP32GPIO23—