mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-10-03 18:09:02 -04:00
77 lines
3.2 KiB
Markdown
77 lines
3.2 KiB
Markdown
|
|
||
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
||
|
|
[](https://github.com/RobTillaart/MCP23S08/actions/workflows/arduino-lint.yml)
|
||
|
|
[](https://github.com/RobTillaart/MCP23S08/actions/workflows/jsoncheck.yml)
|
||
|
|
[](https://github.com/RobTillaart/MCP23S08/blob/master/LICENSE)
|
||
|
|
[](https://github.com/RobTillaart/MCP23S08/releases)
|
||
|
|
|
||
|
|
|
||
|
|
# MCP23S08
|
||
|
|
|
||
|
|
Arduino library for MCP23S08 8 channel SPI port expander.
|
||
|
|
|
||
|
|
|
||
|
|
## Description
|
||
|
|
|
||
|
|
This experimental library gives easy control over the 8 pins of a (SPI) MCP23S08 chip.
|
||
|
|
|
||
|
|
This IC is strongly related to the MCP23017 I2C port expander - https://github.com/RobTillaart/MCP23017_RT
|
||
|
|
Programming Interface is kept the same as much as possible.
|
||
|
|
|
||
|
|
|
||
|
|
## Interface
|
||
|
|
|
||
|
|
### Constructor
|
||
|
|
|
||
|
|
- **MCP23S08(uint8_t select, uint8_t data, uint8_t clock)** constructor SW SPI.
|
||
|
|
- **MCP23S08(uint8_t select)** constructor HW SPI.
|
||
|
|
- **bool begin()** returns true if successful.
|
||
|
|
- **bool isConnected()** returns true if connected, false otherwise. (dummy)
|
||
|
|
|
||
|
|
|
||
|
|
### Single pin interface
|
||
|
|
|
||
|
|
- **bool pinMode(uint8_t pin, uint8_t mode)** pin = 0..7, mode = INPUT, OUTPUT, returns true if successful.
|
||
|
|
- **bool digitalWrite(uint8_t pin, uint8_t value)** pin = 0..7, value = LOW(0) HIGH (!0), returns true if successful.
|
||
|
|
- **uint8_t digitalRead(uint8_t pin)** pin = 0..7, returns LOW or HIGH, might set the lastError();
|
||
|
|
- **bool setPolarity(uint8_t pin, bool reversed)** pin = 0..7, set reversed flag, returns true if successful.
|
||
|
|
- **bool getPolarity(uint8_t pin, bool &reversed)** pin = 0..7, reads reversed flag, returns true if successful.
|
||
|
|
- **bool setPullup(uint8_t pin, bool pullup)** pin = 0..7, set pull-up flag, returns true if successful.
|
||
|
|
- **bool getPullup(uint8_t pin, bool &pullup)** pin = 0..7, reads pull-up flag, returns true if successful.
|
||
|
|
|
||
|
|
|
||
|
|
### 8 pins interface
|
||
|
|
|
||
|
|
- **bool pinMode8(uint8_t value)** value = 0..255, returns true if successful.
|
||
|
|
- **bool write8(uint8_t value)** value = 0..255, returns true if successful.
|
||
|
|
- **uint8_t read8()** reads 8 pins into one byte.
|
||
|
|
- **bool setPolarity8(uint8_t mask)** sets polarity for 8 channels at once.
|
||
|
|
- **bool getPolarity8(uint8_t &mask)** reads polarity of 8 channels at once.
|
||
|
|
- **bool setPullup8(uint8_t mask)** sets pull-up for 8 channels at once.
|
||
|
|
- **bool getPullup8(uint8_t &mask)** reads pull-up for 8 channels at once.
|
||
|
|
|
||
|
|
|
||
|
|
### Error codes
|
||
|
|
|
||
|
|
- **int lastError()** Above functions set an error flag that can be read with this function.
|
||
|
|
Reading it will reset the flag to **MCP23S08_OK**.
|
||
|
|
|
||
|
|
| DESCRIPTION | VALUE |
|
||
|
|
|:----------------------|:-----:|
|
||
|
|
| MCP23S08_OK | 0x00 |
|
||
|
|
| MCP23S08_PIN_ERROR | 0x81 |
|
||
|
|
| MCP23S08_I2C_ERROR | 0x82 |
|
||
|
|
| MCP23S08_VALUE_ERROR | 0x83 |
|
||
|
|
| MCP23S08_PORT_ERROR | 0x84 |
|
||
|
|
|
||
|
|
|
||
|
|
## Operation
|
||
|
|
|
||
|
|
See examples.
|
||
|
|
|
||
|
|
|
||
|
|
## Future
|
||
|
|
|
||
|
|
- keep functional in sync with MCP23017_RT
|
||
|
|
- **isConnected()** is not really needed
|