2020-05-23 13:33:43 +02:00
|
|
|
#pragma once
|
2013-09-30 18:15:02 +02:00
|
|
|
//
|
2021-12-23 12:51:26 +01:00
|
|
|
// FILE: PCF8574.h
|
2013-09-30 18:15:02 +02:00
|
|
|
// AUTHOR: Rob Tillaart
|
|
|
|
// DATE: 02-febr-2013
|
2022-04-11 10:50:17 +02:00
|
|
|
// VERSION: 0.3.4
|
2021-01-29 12:31:58 +01:00
|
|
|
// PURPOSE: Arduino library for PCF8574 - 8 channel I2C IO expander
|
2020-05-23 13:33:43 +02:00
|
|
|
// URL: https://github.com/RobTillaart/PCF8574
|
|
|
|
// http://forum.arduino.cc/index.php?topic=184800
|
2013-09-30 18:15:02 +02:00
|
|
|
//
|
2013-09-30 18:19:55 +02:00
|
|
|
// HISTORY:
|
|
|
|
// see PCF8574.cpp file
|
2015-05-09 17:07:09 +02:00
|
|
|
//
|
2013-09-30 18:15:02 +02:00
|
|
|
|
2021-07-05 10:01:35 +02:00
|
|
|
|
2013-09-30 18:15:02 +02:00
|
|
|
#include "Arduino.h"
|
2021-01-29 12:31:58 +01:00
|
|
|
#include "Wire.h"
|
2013-09-30 18:15:02 +02:00
|
|
|
|
2021-07-05 10:01:35 +02:00
|
|
|
|
2022-04-11 10:50:17 +02:00
|
|
|
#define PCF8574_LIB_VERSION (F("0.3.4"))
|
2016-05-02 19:23:06 +02:00
|
|
|
|
2021-01-29 12:31:58 +01:00
|
|
|
#ifndef PCF8574_INITIAL_VALUE
|
2021-12-23 12:51:26 +01:00
|
|
|
#define PCF8574_INITIAL_VALUE 0xFF
|
2021-01-29 12:31:58 +01:00
|
|
|
#endif
|
|
|
|
|
2021-12-23 12:51:26 +01:00
|
|
|
#define PCF8574_OK 0x00
|
|
|
|
#define PCF8574_PIN_ERROR 0x81
|
|
|
|
#define PCF8574_I2C_ERROR 0x82
|
2016-05-02 19:23:06 +02:00
|
|
|
|
2013-09-30 18:15:02 +02:00
|
|
|
|
|
|
|
class PCF8574
|
|
|
|
{
|
2015-05-09 17:07:09 +02:00
|
|
|
public:
|
2021-12-23 12:51:26 +01:00
|
|
|
explicit PCF8574(const uint8_t deviceAddress = 0x20, TwoWire *wire = &Wire);
|
2015-05-09 17:07:09 +02:00
|
|
|
|
2020-05-23 13:33:43 +02:00
|
|
|
#if defined (ESP8266) || defined(ESP32)
|
2022-04-11 10:50:17 +02:00
|
|
|
bool begin(int sda, int scl, uint8_t value = PCF8574_INITIAL_VALUE);
|
2020-05-23 13:33:43 +02:00
|
|
|
#endif
|
2021-12-23 12:51:26 +01:00
|
|
|
bool begin(uint8_t value = PCF8574_INITIAL_VALUE);
|
2021-01-29 12:31:58 +01:00
|
|
|
bool isConnected();
|
2016-05-02 19:23:06 +02:00
|
|
|
|
2021-12-23 12:51:26 +01:00
|
|
|
|
2021-07-05 10:01:35 +02:00
|
|
|
// note: setting the address corrupt internal buffer values
|
|
|
|
// a read8() / write8() call updates them.
|
|
|
|
bool setAddress(const uint8_t deviceAddress);
|
|
|
|
uint8_t getAddress();
|
|
|
|
|
2021-12-23 12:51:26 +01:00
|
|
|
|
2021-01-29 12:31:58 +01:00
|
|
|
uint8_t read8();
|
2021-07-05 10:01:35 +02:00
|
|
|
uint8_t read(const uint8_t pin);
|
2021-01-29 12:31:58 +01:00
|
|
|
uint8_t value() const { return _dataIn; };
|
2015-05-09 17:07:09 +02:00
|
|
|
|
2021-12-23 12:51:26 +01:00
|
|
|
|
2021-01-29 12:31:58 +01:00
|
|
|
void write8(const uint8_t value);
|
|
|
|
void write(const uint8_t pin, const uint8_t value);
|
|
|
|
uint8_t valueOut() const { return _dataOut; }
|
2016-05-01 10:02:01 +02:00
|
|
|
|
2021-12-23 12:51:26 +01:00
|
|
|
|
2021-01-29 12:31:58 +01:00
|
|
|
//added 0.1.07/08 Septillion
|
|
|
|
inline uint8_t readButton8() { return PCF8574::readButton8(_buttonMask); }
|
|
|
|
uint8_t readButton8(const uint8_t mask);
|
|
|
|
uint8_t readButton(const uint8_t pin);
|
2021-07-05 10:01:35 +02:00
|
|
|
inline void setButtonMask(const uint8_t mask) { _buttonMask = mask; };
|
2021-12-23 12:51:26 +01:00
|
|
|
uint8_t getButtonMask() { return _buttonMask; };
|
|
|
|
|
2016-05-01 10:02:01 +02:00
|
|
|
|
2021-01-29 12:31:58 +01:00
|
|
|
// rotate, shift, toggle, reverse expect all lines are output
|
|
|
|
void toggle(const uint8_t pin);
|
|
|
|
void toggleMask(const uint8_t mask = 0xFF); // default 0xFF ==> invertAll()
|
|
|
|
void shiftRight(const uint8_t n = 1);
|
|
|
|
void shiftLeft(const uint8_t n = 1);
|
|
|
|
void rotateRight(const uint8_t n = 1);
|
|
|
|
void rotateLeft(const uint8_t n = 1);
|
|
|
|
void reverse();
|
2015-05-09 17:07:09 +02:00
|
|
|
|
2021-12-23 12:51:26 +01:00
|
|
|
|
2021-01-29 12:31:58 +01:00
|
|
|
int lastError();
|
2015-05-09 17:07:09 +02:00
|
|
|
|
2021-12-23 12:51:26 +01:00
|
|
|
|
2015-05-09 17:07:09 +02:00
|
|
|
private:
|
2021-01-29 12:31:58 +01:00
|
|
|
uint8_t _address;
|
|
|
|
uint8_t _dataIn;
|
|
|
|
uint8_t _dataOut;
|
|
|
|
uint8_t _buttonMask;
|
|
|
|
int _error;
|
2013-09-30 18:15:02 +02:00
|
|
|
|
2021-01-29 12:31:58 +01:00
|
|
|
TwoWire* _wire;
|
|
|
|
};
|
2020-05-23 13:33:43 +02:00
|
|
|
|
2021-07-05 10:01:35 +02:00
|
|
|
|
2020-05-23 13:33:43 +02:00
|
|
|
// -- END OF FILE --
|
2021-12-23 12:51:26 +01:00
|
|
|
|