MCP23017 expander
The MCP23017 (Advanced) section allows you to change the GPIO expander addresses for the relay board. This enables setting the addresses appropriate for your specific board. This may be necessary when updating older controllers.
Web application configuration
Recommended configuration method.
Sample webui configuration

| Option name | Description |
|---|---|
| mcp_left | I2C address of the left GPIO expander for outputs (OUT_01-OUT_16 for 32x10, OUT_01-OUT_12 for 24x16) |
| mcp_right | I2C address of the right GPIO expander for outputs (OUT_17-OUT_32 for 32x10, OUT_13-OUT_24 for 24x16) |
YAML Editor
I2C expander used in relay boards. You probably need to configure this. By default, one relay board has 2 MCP23017 chips installed.
If you are using the boneio: configuration, you do not need to configure this!
Sample configuration
mcp23017:
- id: mcp_left
address: 0x21
- id: mcp_right
address: 0x20Configuration variables:
- id (Required, string) - The ID to use. This is for internal use only, but you must define it to correctly define the output pins.
- address (Required, string) - The I2C address of the device.
- init_sleep (Optional, timeperiod, default: 0s) - How long to wait for the MCP23017 response. Some MCP23017 chips have a delay during initialization. This option will wait X seconds for the device to respond.