Pin mapping
Which ESP32 and expander pins the inputs, outputs and peripherals of the boneIO ESP Cover 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: boneio-cover_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 |
| PCF8575 | bus_b | 0x20 | pcf_right |
| PCF8575 | bus_b | 0x21 | pcf_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 | `` | PCF8574 0x22 (pcf_inputs_28to35_menu) | 4 (P4) | yes |
| IN_34 | `` | PCF8574 0x22 (pcf_inputs_28to35_menu) | 5 (P5) | yes |
| IN_35 | `` | PCF8574 0x22 (pcf_inputs_28to35_menu) | 6 (P6) | yes |
| YAML ID | Name | On | Pin | Inverted |
|---|
cover_open_01_out01 | | PCF8575 0x21 (pcf_left) | 15 (P17) | yes |
cover_close_01_out02 | | PCF8575 0x21 (pcf_left) | 14 (P16) | yes |
cover_open_02_out03 | | PCF8575 0x21 (pcf_left) | 13 (P15) | yes |
cover_close_02_out04 | | PCF8575 0x21 (pcf_left) | 12 (P14) | yes |
cover_open_03_out05 | | PCF8575 0x21 (pcf_left) | 11 (P13) | yes |
cover_close_03_out06 | | PCF8575 0x21 (pcf_left) | 10 (P12) | yes |
cover_open_04_out07 | | PCF8575 0x21 (pcf_left) | 9 (P11) | yes |
cover_close_04_out08 | | PCF8575 0x21 (pcf_left) | 8 (P10) | yes |
cover_open_05_out09 | | PCF8575 0x20 (pcf_right) | 15 (P17) | yes |
cover_close_05_out10 | | PCF8575 0x20 (pcf_right) | 14 (P16) | yes |
cover_open_06_out11 | | PCF8575 0x20 (pcf_right) | 13 (P15) | yes |
cover_close_06_out12 | | PCF8575 0x20 (pcf_right) | 12 (P14) | yes |
cover_open_07_out13 | | PCF8575 0x20 (pcf_right) | 11 (P13) | yes |
cover_close_07_out14 | | PCF8575 0x20 (pcf_right) | 10 (P12) | yes |
cover_open_08_out15 | | PCF8575 0x20 (pcf_right) | 9 (P11) | yes |
cover_close_08_out16 | | PCF8575 0x20 (pcf_right) | 8 (P10) | yes |
cover_open_09_out17 | | PCF8575 0x21 (pcf_left) | 0 (P00) | yes |
cover_close_09_out18 | | PCF8575 0x21 (pcf_left) | 1 (P01) | yes |
cover_open_10_out19 | | PCF8575 0x21 (pcf_left) | 2 (P02) | yes |
cover_close_10_out20 | | PCF8575 0x21 (pcf_left) | 3 (P03) | yes |
cover_open_11_out21 | | PCF8575 0x21 (pcf_left) | 4 (P04) | yes |
cover_close_11_out22 | | PCF8575 0x21 (pcf_left) | 5 (P05) | yes |
cover_open_12_out23 | | PCF8575 0x21 (pcf_left) | 6 (P06) | yes |
cover_close_12_out24 | | PCF8575 0x21 (pcf_left) | 7 (P07) | yes |
cover_open_13_out25 | | PCF8575 0x20 (pcf_right) | 0 (P00) | yes |
cover_close_13_out26 | | PCF8575 0x20 (pcf_right) | 1 (P01) | yes |
cover_open_14_out27 | | PCF8575 0x20 (pcf_right) | 2 (P02) | yes |
cover_close_14_out28 | | PCF8575 0x20 (pcf_right) | 3 (P03) | yes |
cover_open_15_out29 | | PCF8575 0x20 (pcf_right) | 4 (P04) | yes |
cover_close_15_out30 | | PCF8575 0x20 (pcf_right) | 5 (P05) | yes |
cover_open_16_out31 | | PCF8575 0x20 (pcf_right) | 6 (P06) | yes |
cover_close_16_out32 | | PCF8575 0x20 (pcf_right) | 7 (P07) | yes |
| 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: boneio-cover_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 |
| PCF8575 | i2c_bus | 0x23 | pcf_left |
| PCF8575 | i2c_bus | 0x24 | pcf_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 | `` | PCF8574 0x22 (pcf_inputs_28to35_menu) | 4 (P4) | yes |
| IN_34 | `` | PCF8574 0x22 (pcf_inputs_28to35_menu) | 5 (P5) | yes |
| IN_35 | `` | PCF8574 0x22 (pcf_inputs_28to35_menu) | 6 (P6) | yes |
| YAML ID | Name | On | Pin | Inverted |
|---|
cover_open_01_out01 | | PCF8575 0x23 (pcf_left) | 15 (P17) | yes |
cover_close_01_out02 | | PCF8575 0x23 (pcf_left) | 14 (P16) | yes |
cover_open_02_out03 | | PCF8575 0x23 (pcf_left) | 13 (P15) | yes |
cover_close_02_out04 | | PCF8575 0x23 (pcf_left) | 12 (P14) | yes |
cover_open_03_out05 | | PCF8575 0x23 (pcf_left) | 11 (P13) | yes |
cover_close_03_out06 | | PCF8575 0x23 (pcf_left) | 10 (P12) | yes |
cover_open_04_out07 | | PCF8575 0x23 (pcf_left) | 9 (P11) | yes |
cover_close_04_out08 | | PCF8575 0x23 (pcf_left) | 8 (P10) | yes |
cover_open_05_out09 | | PCF8575 0x24 (pcf_right) | 15 (P17) | yes |
cover_close_05_out10 | | PCF8575 0x24 (pcf_right) | 14 (P16) | yes |
cover_open_06_out11 | | PCF8575 0x24 (pcf_right) | 13 (P15) | yes |
cover_close_06_out12 | | PCF8575 0x24 (pcf_right) | 12 (P14) | yes |
cover_open_07_out13 | | PCF8575 0x24 (pcf_right) | 11 (P13) | yes |
cover_close_07_out14 | | PCF8575 0x24 (pcf_right) | 10 (P12) | yes |
cover_open_08_out15 | | PCF8575 0x24 (pcf_right) | 9 (P11) | yes |
cover_close_08_out16 | | PCF8575 0x24 (pcf_right) | 8 (P10) | yes |
cover_open_09_out17 | | PCF8575 0x23 (pcf_left) | 0 (P00) | yes |
cover_close_09_out18 | | PCF8575 0x23 (pcf_left) | 1 (P01) | yes |
cover_open_10_out19 | | PCF8575 0x23 (pcf_left) | 2 (P02) | yes |
cover_close_10_out20 | | PCF8575 0x23 (pcf_left) | 3 (P03) | yes |
cover_open_11_out21 | | PCF8575 0x23 (pcf_left) | 4 (P04) | yes |
cover_close_11_out22 | | PCF8575 0x23 (pcf_left) | 5 (P05) | yes |
cover_open_12_out23 | | PCF8575 0x23 (pcf_left) | 6 (P06) | yes |
cover_close_12_out24 | | PCF8575 0x23 (pcf_left) | 7 (P07) | yes |
cover_open_13_out25 | | PCF8575 0x24 (pcf_right) | 0 (P00) | yes |
cover_close_13_out26 | | PCF8575 0x24 (pcf_right) | 1 (P01) | yes |
cover_open_14_out27 | | PCF8575 0x24 (pcf_right) | 2 (P02) | yes |
cover_close_14_out28 | | PCF8575 0x24 (pcf_right) | 3 (P03) | yes |
cover_open_15_out29 | | PCF8575 0x24 (pcf_right) | 4 (P04) | yes |
cover_close_15_out30 | | PCF8575 0x24 (pcf_right) | 5 (P05) | yes |
cover_open_16_out31 | | PCF8575 0x24 (pcf_right) | 6 (P06) | yes |
cover_close_16_out32 | | PCF8575 0x24 (pcf_right) | 7 (P07) | yes |
| 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 | — |