https://github.com/johntalton/mcp23
8/16-bit I/O Expander (mcp23) with advanced features
https://github.com/johntalton/mcp23
chip expander gpio i2c io mcp23008 mcp23017 pin
Last synced: 8 days ago
JSON representation
8/16-bit I/O Expander (mcp23) with advanced features
- Host: GitHub
- URL: https://github.com/johntalton/mcp23
- Owner: johntalton
- License: mit
- Created: 2018-05-17T06:22:46.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2025-09-24T05:29:23.000Z (25 days ago)
- Last Synced: 2025-09-24T07:22:32.921Z (25 days ago)
- Topics: chip, expander, gpio, i2c, io, mcp23008, mcp23017, pin
- Language: TypeScript
- Homepage:
- Size: 899 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Microchip I/O Expander
A Feature rich general I/O chip available in single port (8-bit) and dual port (16-bit) packages.
[](https://www.npmjs.com/package/@johntalton/mcp23)
[](https://github.com/johntalton/mcp23/actions/workflows/CI.yml)
## Banks and sequential mode
The chip has four operational mode in which registers can be read/written.
- Interlaced Block
- Dual Block
- 8-bit Poll
- 16-bit Poll
The library exposes methods that are specific for each mode, and is the callers responsibility to validate mode settings. This affords reduced call overhead (no validation of mode) when operation are done in a stable mode environment.
# Example
```javascript
import { I2CAddressedBus } from '@johntalton/and-other-delights'
import { MCP23, MODE, PORT, DIRECTION } form '@johntalton/mcp23'
const bus = /* I2CBus implementation of your choice */
const aBus = new I2CAddressedBus(bus, 0x20)
const device = new MCP23(aBus)
const mode = MODE.DUAL_BLOCK // bank: 1, sequential: true
const port = PORT.A
const direction = await device.getDirection(mode, port)
// test if portA pin 0 is an Output
const isA0Output = direction[0] === DIRECTION.OUT
```
```javascript
// ...
// some things can only be done in specific modes
// first switch to that mode from the existing mode
const existingIOControl = await device.getControl(existingMode)
const newMode = MODE.POLL_16_BIT
await device.setControl(existingMode, {
...existingIOControl,
mode: newMode
})
// existingMode is now invalid, and the device is in the newMode
// now polling 16 bit register can be done efficiently
const flags = await device.getInterruptFlags(newMode)
```