Mcp23017zero
What is Mcp23017zero
HA-mcp23017 is a Home Assistant integration for controlling MCP23008 and MCP23017 I/O expanders. It provides a robust interface for interfacing with these devices, allowing for the addition of more input and output pins to Home Assistant setups.
Use cases
This integration is useful for projects that require multiple buttons, switches, or sensors, enabling them to be connected to Home Assistant for automation and monitoring. Ideal use cases include DIY smart home systems, remote control applications, and any scenario that benefits from additional I/O options.
How to use
Users can install the integration via HACS or manually by adding the custom component to the Home Assistant directory. Configuration can be done through either the user-friendly config flow interface or by editing the configuration.yaml file, where users specify pin assignments and other parameters for their devices.
Key features
Key features include an asynchronous implementation for improved performance, thread-safety for concurrent entity usage, config flow support for easy setup, optimized I2C bus utilization, state synchronization at startup, and compatibility with both MCP23008 and MCP23017 devices.
Where to use
This integration is suitable for any Home Assistant environment where additional GPIO pins are needed, especially in projects involving custom hardware setups using the MCP23017 or MCP23008 expanders for smarter home automation control.
Overview
What is Mcp23017zero
HA-mcp23017 is a Home Assistant integration for controlling MCP23008 and MCP23017 I/O expanders. It provides a robust interface for interfacing with these devices, allowing for the addition of more input and output pins to Home Assistant setups.
Use cases
This integration is useful for projects that require multiple buttons, switches, or sensors, enabling them to be connected to Home Assistant for automation and monitoring. Ideal use cases include DIY smart home systems, remote control applications, and any scenario that benefits from additional I/O options.
How to use
Users can install the integration via HACS or manually by adding the custom component to the Home Assistant directory. Configuration can be done through either the user-friendly config flow interface or by editing the configuration.yaml file, where users specify pin assignments and other parameters for their devices.
Key features
Key features include an asynchronous implementation for improved performance, thread-safety for concurrent entity usage, config flow support for easy setup, optimized I2C bus utilization, state synchronization at startup, and compatibility with both MCP23008 and MCP23017 devices.
Where to use
This integration is suitable for any Home Assistant environment where additional GPIO pins are needed, especially in projects involving custom hardware setups using the MCP23017 or MCP23008 expanders for smarter home automation control.
Content
HA-mcp23017
MCP23008/MCP23017 implementation for Home Assistant (HA)
Highlights of what it does offer
- Async implementation (more reactive and nicer to HA)
- Thread-safety allows different entities to use the same component
- Config Flow support (UI configuration) in addition to legacy configuration.yaml.
- Push iso pull model for higher reactivity, e.g. 100ms polling for ‘zero-delay’ push button without loading HA.
- Optimized i2c bus bandwidth utilisation
- Polling per device instead of per entity/8x gain, register cache to avoid read-modify-write/3xgain or rewriting the same register value)
- Synchronization with the device state at startup, e.g. avoid output glitches when HA restart.
- Compatible with MCP23008 device (8 pins variant).
Installation
1. Add this MCP23017 integration to HA
- Using HACS
- Or by updating manually your custom_components folder
- Clone or download this repository
- Move custom_components/mcp23017 to your <ha_configuration_folder>, e.g. /home/homeassistant/.homeassistant/custom_components/mcp23017
- Restart HA and clear browser cache (or restart a browser); latter is required for new config_flow to show up
2. Add your mcp23017 component(s) using either:
- config flow (Configuration->Integrations->Add integration)
- Created entities will be visible in the Integrations tab and aggregated per device (i2c address) in the Devices tab.
- Entity parameters (invert logic, pull-up, …) can be adapted individually by using the entity’s Options button once created.
- configuration.yaml see configuration example below.
- Syntax is compatible with the now defunct core implementation (removed by https://github.com/home-assistant/core/pull/67281)
- New hw_sync option allowing to either synchronize initial value of the switch with the hardware (true, default option) or to set it to a fixed value (false, value=invert_logic)
- Entity parameters (invert logic, pull-up, …) can only be set globally for all pins of a given device/integration.
- Syntax is compatible with the now defunct core implementation (removed by https://github.com/home-assistant/core/pull/67281)
Example entry for configuration.yaml:
# Example configuration.yaml
binary_sensor:
- platform: mcp23017
i2c_address: 0x26
pins:
8 : Button_0
9 : Button_1
10: Button_2
11: Button_3
- platform: mcp23017
i2c_address: 0x27
invert_logic: true
pins:
8: Button_4
9: Button_5
10: Button_6
11: Button_7
switch:
- platform: mcp23017
i2c_address: 0x26
pins:
0 : Output_0
1 : Output_1
2 : Output_2
3 : Output_3
- platform: mcp23017
i2c_address: 0x27
hw_sync: false
pins:
0 : Output_4
1 : Output_5
2 : Output_6
3 : Output_7