mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-09-20 00:55:58 -04:00
130 lines
3.2 KiB
C++
130 lines
3.2 KiB
C++
#pragma once
|
|
//
|
|
// FILE: MCP23S08.h
|
|
// AUTHOR: Rob Tillaart
|
|
// VERSION: 0.2.0
|
|
// PURPOSE: Arduino library for SPI MCP23S08 8 channel port expander
|
|
// DATE: 2022-01-10
|
|
// URL: https://github.com/RobTillaart/MCP23S08
|
|
|
|
|
|
#include "Arduino.h"
|
|
#include "SPI.h"
|
|
#include "MCP23S08_registers.h"
|
|
|
|
|
|
#define MCP23S08_LIB_VERSION (F("0.2.0"))
|
|
|
|
// ERROR CODES
|
|
#define MCP23S08_OK 0x00
|
|
#define MCP23S08_PIN_ERROR 0x81
|
|
#define MCP23S08_SPI_ERROR 0x82
|
|
#define MCP23S08_VALUE_ERROR 0x83
|
|
#define MCP23S08_PORT_ERROR 0x84
|
|
#define MCP23S08_REGISTER_ERROR 0xFF
|
|
|
|
#define MCP23S08_INVALID_READ -100
|
|
|
|
|
|
const uint32_t MCP23S08_TYP_SPI_SPEED = 8000000;
|
|
const uint32_t MCP23S08_MAX_SPI_SPEED = 10000000;
|
|
|
|
|
|
|
|
class MCP23S08
|
|
{
|
|
public:
|
|
// SOFTWARE SPI
|
|
MCP23S08(uint8_t select, uint8_t dataIn, uint8_t dataOut, uint8_t clock, uint8_t address = 0x00);
|
|
// HARDWARE SPI
|
|
MCP23S08(uint8_t select, SPIClass* spi);
|
|
MCP23S08(uint8_t select, uint8_t address = 0x00, SPIClass* spi = &SPI);
|
|
|
|
bool begin();
|
|
bool isConnected();
|
|
uint8_t getAddress();
|
|
|
|
// single pin interface
|
|
// mode: 0 = OUTPUT, 1 = INPUT, 1 = INPUT_PULLUP (==INPUT)
|
|
bool pinMode(uint8_t pin, uint8_t mode);
|
|
bool digitalWrite(uint8_t pin, uint8_t value);
|
|
uint8_t digitalRead(uint8_t pin);
|
|
|
|
bool setPolarity(uint8_t pin, bool reversed);
|
|
bool getPolarity(uint8_t pin, bool &reversed);
|
|
bool setPullup(uint8_t pin, bool pullup);
|
|
bool getPullup(uint8_t pin, bool &pullup);
|
|
|
|
|
|
// 8 pins interface
|
|
// value = bit pattern
|
|
bool pinMode8(uint8_t value);
|
|
bool write8(uint8_t value);
|
|
int read8();
|
|
|
|
bool setPolarity8(uint8_t mask);
|
|
bool getPolarity8(uint8_t &mask);
|
|
bool setPullup8(uint8_t mask);
|
|
bool getPullup8(uint8_t &mask);
|
|
|
|
|
|
// speed in Hz
|
|
void setSPIspeed(uint32_t speed);
|
|
uint32_t getSPIspeed() { return _SPIspeed; };
|
|
|
|
// debugging
|
|
bool usesHWSPI() { return _hwSPI; };
|
|
int lastError();
|
|
|
|
// set/clear IOCR bit fields (0.2.0 experimental)
|
|
void enableControlRegister(uint8_t mask);
|
|
void disableControlRegister(uint8_t mask);
|
|
// 0.2.0 experimental
|
|
void enableHardwareAddress();
|
|
void disableHardwareAddress();
|
|
|
|
// ESP32 specific
|
|
#if defined(ESP32)
|
|
|
|
void selectHSPI();
|
|
void selectVSPI();
|
|
bool usesHSPI();
|
|
bool usesVSPI();
|
|
|
|
// to overrule the ESP32s default hardware pins
|
|
void setGPIOpins(uint8_t clk, uint8_t miso, uint8_t mosi, uint8_t select);
|
|
|
|
#endif
|
|
|
|
|
|
private:
|
|
// access to low level registers (just make these two functions public).
|
|
// USE WITH CARE !!!
|
|
bool writeReg(uint8_t reg, uint8_t value);
|
|
uint8_t readReg(uint8_t reg);
|
|
|
|
uint8_t _address = 0;
|
|
uint8_t _select = 0;
|
|
uint8_t _dataOut = 0;
|
|
uint8_t _dataIn = 0;
|
|
uint8_t _clock = 0;
|
|
uint8_t _error = MCP23S08_OK;
|
|
|
|
bool _hwSPI = false;
|
|
|
|
// 10 MHz is maximum, 8 is a better clock divider on AVR.
|
|
uint32_t _SPIspeed = MCP23S08_TYP_SPI_SPEED;
|
|
SPIClass * _mySPI;
|
|
SPISettings _spi_settings;
|
|
|
|
uint8_t swSPI_transfer(uint8_t val);
|
|
|
|
#if defined(ESP32)
|
|
bool _useHSPI = true;
|
|
#endif
|
|
};
|
|
|
|
|
|
// -- END OF FILE --
|
|
|