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.
Source: discontinued/boneio-24x16_switches_v0_5-v0_6.yaml
| Bus | SDA | SCL |
|---|
| bus_a | GPIO14 | GPIO15 |
| bus_b | GPIO17 | GPIO33 |
| Chip | Bus | Address | YAML ID |
|---|
| PCF8575 | bus_a | 0x20 | pcf_inputs_1to14 |
| PCF8575 | bus_a | 0x21 | pcf_inputs_15to28 |
| PCF8574 | bus_a | 0x22 | pcf_inputs_28to35_menu |
| ina219 | bus_a | 0x40 | |
| ds1307 | bus_a | 0x68 | ds1307_time |
| MCP23017 | bus_b | 0x20 | mcp_right |
| MCP23017 | bus_b | 0x21 | mcp_left |
| SH1106_128X64 | bus_b | 0x3C | oled_display |
| lm75 | bus_b | 0x48 | boneIO_temp |
| Name | YAML ID | On | Pin | Inverted |
|---|
| boneIO_button | boneIO_button | PCF8574 0x22 (pcf_inputs_28to35_menu) | 7 (P7) | yes |
| IN_01 | in_01 | PCF8575 0x20 (pcf_inputs_1to14) | 0 (P00) | yes |
| IN_02 | in_02 | PCF8575 0x20 (pcf_inputs_1to14) | 1 (P01) | yes |
| IN_03 | in_03 | PCF8575 0x20 (pcf_inputs_1to14) | 2 (P02) | yes |
| IN_04 | in_04 | PCF8575 0x20 (pcf_inputs_1to14) | 3 (P03) | yes |
| IN_05 | in_05 | PCF8575 0x20 (pcf_inputs_1to14) | 4 (P04) | yes |
| IN_06 | in_06 | PCF8575 0x20 (pcf_inputs_1to14) | 5 (P05) | yes |
| IN_07 | in_07 | PCF8575 0x20 (pcf_inputs_1to14) | 6 (P06) | yes |
| IN_08 | in_08 | PCF8575 0x20 (pcf_inputs_1to14) | 8 (P10) | yes |
| IN_09 | in_09 | PCF8575 0x20 (pcf_inputs_1to14) | 9 (P11) | yes |
| IN_10 | in_10 | PCF8575 0x20 (pcf_inputs_1to14) | 10 (P12) | yes |
| IN_11 | in_11 | PCF8575 0x20 (pcf_inputs_1to14) | 11 (P13) | yes |
| IN_12 | in_12 | PCF8575 0x20 (pcf_inputs_1to14) | 12 (P14) | yes |
| IN_13 | in_13 | PCF8575 0x20 (pcf_inputs_1to14) | 13 (P15) | yes |
| IN_14 | in_14 | PCF8575 0x20 (pcf_inputs_1to14) | 14 (P16) | yes |
| IN_15 | in_15 | PCF8575 0x21 (pcf_inputs_15to28) | 6 (P06) | yes |
| IN_16 | in_16 | PCF8575 0x21 (pcf_inputs_15to28) | 5 (P05) | yes |
| IN_17 | in_17 | PCF8575 0x21 (pcf_inputs_15to28) | 4 (P04) | yes |
| IN_18 | in_18 | PCF8575 0x21 (pcf_inputs_15to28) | 3 (P03) | yes |
| IN_19 | in_19 | PCF8575 0x21 (pcf_inputs_15to28) | 2 (P02) | yes |
| IN_20 | in_20 | PCF8575 0x21 (pcf_inputs_15to28) | 1 (P01) | yes |
| IN_21 | in_21 | PCF8575 0x21 (pcf_inputs_15to28) | 0 (P00) | yes |
| IN_22 | in_22 | PCF8575 0x21 (pcf_inputs_15to28) | 8 (P10) | yes |
| IN_23 | in_23 | PCF8575 0x21 (pcf_inputs_15to28) | 9 (P11) | yes |
| IN_24 | in_24 | PCF8575 0x21 (pcf_inputs_15to28) | 10 (P12) | yes |
| IN_25 | in_25 | PCF8575 0x21 (pcf_inputs_15to28) | 11 (P13) | yes |
| IN_26 | in_26 | PCF8575 0x21 (pcf_inputs_15to28) | 12 (P14) | yes |
| IN_27 | in_27 | PCF8575 0x21 (pcf_inputs_15to28) | 13 (P15) | yes |
| IN_28 | in_28 | PCF8575 0x21 (pcf_inputs_15to28) | 14 (P16) | yes |
| IN_29 | in_29 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 0 (P0) | yes |
| IN_30 | in_30 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 1 (P1) | yes |
| IN_31 | in_31 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 2 (P2) | yes |
| IN_32 | in_32 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 3 (P3) | yes |
| IN_33 | in_33 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 4 (P4) | yes |
| IN_34 | in_34 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 5 (P5) | yes |
| IN_35 | in_35 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 6 (P6) | yes |
| YAML ID | Name | On | Pin | Inverted |
|---|
out_01 | Switch 01 | MCP23017 0x21 (mcp_left) | 8 (GPB0) | — |
out_02 | Switch 02 | MCP23017 0x21 (mcp_left) | 9 (GPB1) | — |
out_03 | Switch 03 | MCP23017 0x21 (mcp_left) | 10 (GPB2) | — |
out_04 | Switch 04 | MCP23017 0x21 (mcp_left) | 11 (GPB3) | — |
out_05 | Switch 05 | MCP23017 0x21 (mcp_left) | 12 (GPB4) | — |
out_06 | Switch 06 | MCP23017 0x21 (mcp_left) | 13 (GPB5) | — |
out_07 | Switch 07 | MCP23017 0x21 (mcp_left) | 14 (GPB6) | — |
out_08 | Switch 08 | MCP23017 0x21 (mcp_left) | 15 (GPB7) | — |
out_09 | Switch 09 | MCP23017 0x20 (mcp_right) | 8 (GPB0) | — |
out_10 | Switch 10 | MCP23017 0x20 (mcp_right) | 9 (GPB1) | — |
out_11 | Switch 11 | MCP23017 0x20 (mcp_right) | 10 (GPB2) | — |
out_12 | Switch 12 | MCP23017 0x20 (mcp_right) | 11 (GPB3) | — |
out_13 | Switch 13 | MCP23017 0x21 (mcp_left) | 7 (GPA7) | — |
out_14 | Switch 14 | MCP23017 0x21 (mcp_left) | 6 (GPA6) | — |
out_15 | Switch 15 | MCP23017 0x21 (mcp_left) | 5 (GPA5) | — |
out_16 | Switch 16 | MCP23017 0x21 (mcp_left) | 4 (GPA4) | — |
out_17 | Switch 17 | MCP23017 0x21 (mcp_left) | 3 (GPA3) | — |
out_18 | Switch 18 | MCP23017 0x21 (mcp_left) | 2 (GPA2) | — |
out_19 | Switch 19 | MCP23017 0x21 (mcp_left) | 1 (GPA1) | — |
out_20 | Switch 20 | MCP23017 0x21 (mcp_left) | 0 (GPA0) | — |
out_21 | Switch 21 | MCP23017 0x20 (mcp_right) | 12 (GPB4) | — |
out_22 | Switch 22 | MCP23017 0x20 (mcp_right) | 13 (GPB5) | — |
out_23 | Switch 23 | MCP23017 0x20 (mcp_right) | 14 (GPB6) | — |
out_24 | Switch 24 | MCP23017 0x20 (mcp_right) | 15 (GPB7) | — |
| Function | Name | On | Pin | Inverted |
|---|
ethernet.clk | eth | ESP32 | GPIO0 | — |
switch.gpio | Buzzer | ESP32 | GPIO2 | — |
ethernet.power_pin | eth | ESP32 | GPIO16 | — |
ethernet.mdio_pin | eth | ESP32 | GPIO18 | — |
ethernet.mdc_pin | eth | ESP32 | GPIO23 | — |
Source: discontinued/boneio-24x16_switches_v0_7.yaml
| Bus | SDA | SCL |
|---|
| i2c_bus | GPIO17 | GPIO33 |
| Chip | Bus | Address | YAML ID |
|---|
| PCF8575 | i2c_bus | 0x20 | pcf_inputs_1to14 |
| PCF8575 | i2c_bus | 0x21 | pcf_inputs_15to28 |
| PCF8574 | i2c_bus | 0x22 | pcf_inputs_28to35_menu |
| MCP23017 | i2c_bus | 0x23 | mcp_left |
| MCP23017 | i2c_bus | 0x24 | mcp_right |
| SH1106_128X64 | i2c_bus | 0x3C | oled_display |
| ina219 | i2c_bus | 0x40 | |
| lm75 | i2c_bus | 0x48 | boneIO_temp |
| Name | YAML ID | On | Pin | Inverted |
|---|
| boneIO_button | boneIO_button | PCF8574 0x22 (pcf_inputs_28to35_menu) | 7 (P7) | yes |
| IN_01 | in_01 | PCF8575 0x20 (pcf_inputs_1to14) | 0 (P00) | yes |
| IN_02 | in_02 | PCF8575 0x20 (pcf_inputs_1to14) | 1 (P01) | yes |
| IN_03 | in_03 | PCF8575 0x20 (pcf_inputs_1to14) | 2 (P02) | yes |
| IN_04 | in_04 | PCF8575 0x20 (pcf_inputs_1to14) | 3 (P03) | yes |
| IN_05 | in_05 | PCF8575 0x20 (pcf_inputs_1to14) | 4 (P04) | yes |
| IN_06 | in_06 | PCF8575 0x20 (pcf_inputs_1to14) | 5 (P05) | yes |
| IN_07 | in_07 | PCF8575 0x20 (pcf_inputs_1to14) | 6 (P06) | yes |
| IN_08 | in_08 | PCF8575 0x20 (pcf_inputs_1to14) | 8 (P10) | yes |
| IN_09 | in_09 | PCF8575 0x20 (pcf_inputs_1to14) | 9 (P11) | yes |
| IN_10 | in_10 | PCF8575 0x20 (pcf_inputs_1to14) | 10 (P12) | yes |
| IN_11 | in_11 | PCF8575 0x20 (pcf_inputs_1to14) | 11 (P13) | yes |
| IN_12 | in_12 | PCF8575 0x20 (pcf_inputs_1to14) | 12 (P14) | yes |
| IN_13 | in_13 | PCF8575 0x20 (pcf_inputs_1to14) | 13 (P15) | yes |
| IN_14 | in_14 | PCF8575 0x20 (pcf_inputs_1to14) | 14 (P16) | yes |
| IN_15 | in_15 | PCF8575 0x21 (pcf_inputs_15to28) | 6 (P06) | yes |
| IN_16 | in_16 | PCF8575 0x21 (pcf_inputs_15to28) | 5 (P05) | yes |
| IN_17 | in_17 | PCF8575 0x21 (pcf_inputs_15to28) | 4 (P04) | yes |
| IN_18 | in_18 | PCF8575 0x21 (pcf_inputs_15to28) | 3 (P03) | yes |
| IN_19 | in_19 | PCF8575 0x21 (pcf_inputs_15to28) | 2 (P02) | yes |
| IN_20 | in_20 | PCF8575 0x21 (pcf_inputs_15to28) | 1 (P01) | yes |
| IN_21 | in_21 | PCF8575 0x21 (pcf_inputs_15to28) | 0 (P00) | yes |
| IN_22 | in_22 | PCF8575 0x21 (pcf_inputs_15to28) | 8 (P10) | yes |
| IN_23 | in_23 | PCF8575 0x21 (pcf_inputs_15to28) | 9 (P11) | yes |
| IN_24 | in_24 | PCF8575 0x21 (pcf_inputs_15to28) | 10 (P12) | yes |
| IN_25 | in_25 | PCF8575 0x21 (pcf_inputs_15to28) | 11 (P13) | yes |
| IN_26 | in_26 | PCF8575 0x21 (pcf_inputs_15to28) | 12 (P14) | yes |
| IN_27 | in_27 | PCF8575 0x21 (pcf_inputs_15to28) | 13 (P15) | yes |
| IN_28 | in_28 | PCF8575 0x21 (pcf_inputs_15to28) | 14 (P16) | yes |
| IN_29 | in_29 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 0 (P0) | yes |
| IN_30 | in_30 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 1 (P1) | yes |
| IN_31 | in_31 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 2 (P2) | yes |
| IN_32 | in_32 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 3 (P3) | yes |
| IN_33 | in_33 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 4 (P4) | yes |
| IN_34 | in_34 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 5 (P5) | yes |
| IN_35 | in_35 | PCF8574 0x22 (pcf_inputs_28to35_menu) | 6 (P6) | yes |
| YAML ID | Name | On | Pin | Inverted |
|---|
out_01 | Switch 01 | MCP23017 0x23 (mcp_left) | 8 (GPB0) | — |
out_02 | Switch 02 | MCP23017 0x23 (mcp_left) | 9 (GPB1) | — |
out_03 | Switch 03 | MCP23017 0x23 (mcp_left) | 10 (GPB2) | — |
out_04 | Switch 04 | MCP23017 0x23 (mcp_left) | 11 (GPB3) | — |
out_05 | Switch 05 | MCP23017 0x23 (mcp_left) | 12 (GPB4) | — |
out_06 | Switch 06 | MCP23017 0x23 (mcp_left) | 13 (GPB5) | — |
out_07 | Switch 07 | MCP23017 0x23 (mcp_left) | 14 (GPB6) | — |
out_08 | Switch 08 | MCP23017 0x23 (mcp_left) | 15 (GPB7) | — |
out_09 | Switch 09 | MCP23017 0x24 (mcp_right) | 8 (GPB0) | — |
out_10 | Switch 10 | MCP23017 0x24 (mcp_right) | 9 (GPB1) | — |
out_11 | Switch 11 | MCP23017 0x24 (mcp_right) | 10 (GPB2) | — |
out_12 | Switch 12 | MCP23017 0x24 (mcp_right) | 11 (GPB3) | — |
out_13 | Switch 13 | MCP23017 0x23 (mcp_left) | 7 (GPA7) | — |
out_14 | Switch 14 | MCP23017 0x23 (mcp_left) | 6 (GPA6) | — |
out_15 | Switch 15 | MCP23017 0x23 (mcp_left) | 5 (GPA5) | — |
out_16 | Switch 16 | MCP23017 0x23 (mcp_left) | 4 (GPA4) | — |
out_17 | Switch 17 | MCP23017 0x23 (mcp_left) | 3 (GPA3) | — |
out_18 | Switch 18 | MCP23017 0x23 (mcp_left) | 2 (GPA2) | — |
out_19 | Switch 19 | MCP23017 0x23 (mcp_left) | 1 (GPA1) | — |
out_20 | Switch 20 | MCP23017 0x23 (mcp_left) | 0 (GPA0) | — |
out_21 | Switch 21 | MCP23017 0x24 (mcp_right) | 12 (GPB4) | — |
out_22 | Switch 22 | MCP23017 0x24 (mcp_right) | 13 (GPB5) | — |
out_23 | Switch 23 | MCP23017 0x24 (mcp_right) | 14 (GPB6) | — |
out_24 | Switch 24 | MCP23017 0x24 (mcp_right) | 15 (GPB7) | — |
| Function | Name | On | Pin | Inverted |
|---|
ethernet.clk | eth | ESP32 | GPIO0 | — |
switch.gpio | Buzzer | ESP32 | GPIO2 | — |
ethernet.power_pin | eth | ESP32 | GPIO16 | — |
ethernet.mdio_pin | eth | ESP32 | GPIO18 | — |
ethernet.mdc_pin | eth | ESP32 | GPIO23 | — |