alex/GY-63_MS5611
1
0
Fork 0
mirror of https://github.com/RobTillaart/Arduino.git synced 2024-09-20 00:55:58 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
2451f38556
GY-63_MS5611/libraries/MCP23S08
History
rob tillaart 714e5368f7 0.1.3 MCP23S08
2023-02-04 16:07:28 +01:00
..
.github 0.1.3 MCP23S08 2023-02-04 16:07:28 +01:00
documents 0.1.0 MCP23S08 2022-01-10 12:52:28 +01:00
examples 0.1.1 MCP23S08 2022-09-28 13:59:32 +02:00
test 0.1.3 MCP23S08 2023-02-04 16:07:28 +01:00
.arduino-ci.yml 0.1.2 MCP23S08 2022-11-17 13:36:23 +01:00
CHANGELOG.md 0.1.3 MCP23S08 2023-02-04 16:07:28 +01:00
library.json 0.1.3 MCP23S08 2023-02-04 16:07:28 +01:00
library.properties 0.1.3 MCP23S08 2023-02-04 16:07:28 +01:00
LICENSE 0.1.3 MCP23S08 2023-02-04 16:07:28 +01:00
MCP23S08.cpp 0.1.3 MCP23S08 2023-02-04 16:07:28 +01:00
MCP23S08.h 0.1.3 MCP23S08 2023-02-04 16:07:28 +01:00
README.md 0.1.3 MCP23S08 2023-02-04 16:07:28 +01:00

README.md

Arduino CI Arduino-lint JSON check License: MIT GitHub release

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.

Since 0.1.1 the digitalWrite(pin, value) is optimized. If a pin is not changed it will not be written again to save time.

Related

16 bit port expanders

8 bit port expanders

Interface

#include "MCP23S08.h"

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. Returns true if successful.
  • bool getPolarity8(uint8_t &mask) reads polarity of 8 channels at once. Returns true if successful.
  • bool setPullup8(uint8_t mask) sets pull-up for 8 channels at once. Returns true if successful.
  • bool getPullup8(uint8_t &mask) reads pull-up for 8 channels at once. Returns true if successful.

Error codes

If one of the above functions return false, there might be an error.

  • int lastError() Above functions set an error flag that can be read with this function.
    Reading it will reset the flag to MCP23S08_OK.
Name Value description
MCP23S08_OK 0x00 No error
MCP23S08_PIN_ERROR 0x81
MCP23S08_SPI_ERROR 0x82
MCP23S08_VALUE_ERROR 0x83
MCP23S08_PORT_ERROR 0x84
MCP23S08_REGISTER_ERROR 0xFF low level.

Operation

See examples.

Future

Must

  • keep documentation in sync with MCP23S17

Should

  • keep functional in sync with MCP23017_RT and MCP23S17

Could

  • MCP23S17 sync
    • add enableIO controlRegister functions
    • add registers.h file

Wont