mirror of
https://github.com/DCC-EX/CommandStation-EX.git
synced 2024-11-27 01:56:14 +01:00
133 lines
4.3 KiB
C++
133 lines
4.3 KiB
C++
/*
|
|
* © 2021, Peter Cole. All rights reserved.
|
|
*
|
|
* This file is part of EX-CommandStation
|
|
*
|
|
* This is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* It is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with CommandStation. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/*
|
|
* The IO_EX-IOExpander.h device driver integrates with one or more EX-IOExpander devices.
|
|
* This device driver will configure the device and all I/O ports on startup, along with
|
|
* interacting with the device for all input/output duties.
|
|
*
|
|
* To create EX-IOExpander devices, these are defined in myHal.cpp:
|
|
*
|
|
* #include "IO_EX-IOExpander.h"
|
|
*
|
|
* void halSetup() {
|
|
* // EXIOExpander::create(vpin, num_vpins, i2c_address, digital_pinmap, analogue_pinmap);
|
|
* EXIOExpander::create(800, 18, 0x90, DEFAULT_NANO_DIGITAL_PINMAP, DEFAULT_NANO_ANALOGUE_PINMAP);
|
|
}
|
|
*/
|
|
|
|
#ifndef IO_EX_IOEXPANDER_H
|
|
#define IO_EX_IOEXPANDER_H
|
|
|
|
#include "IO_GPIOBase.h"
|
|
#include "FSH.h"
|
|
#include "EX-IOExpanderPinMaps.h"
|
|
|
|
// Include user defined pin maps in myEX-IOExpander if defined
|
|
#if __has_include ("myEX-IOExpander.h")
|
|
#include "myEX-IOExpander.h"
|
|
#endif
|
|
|
|
/////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
/*
|
|
* EXIODigitalPinMap class for EX-IOExpander.
|
|
*/
|
|
class EXIODigitalPinMap {
|
|
public:
|
|
EXIODigitalPinMap(uint8_t numDigitalPins, uint8_t...);
|
|
EXIODigitalPinMap() = default;
|
|
|
|
private:
|
|
EXIODigitalPinMap(uint8_t numDigitalPins, ...) {
|
|
_numDigitalPins = numDigitalPins;
|
|
uint8_t _digitalPinMap[_numDigitalPins];
|
|
va_list _pinList;
|
|
va_start(_pinList, _numDigitalPins);
|
|
for (uint8_t pin = 0; pin < _numDigitalPins; pin++) {
|
|
_digitalPinMap[pin] = va_arg(_pinList, int);
|
|
}
|
|
va_end(_pinList);
|
|
}
|
|
|
|
uint8_t _numDigitalPins;
|
|
};
|
|
|
|
/////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
/*
|
|
* EXIOAnaloguePinMap class for EX-IOExpander.
|
|
*/
|
|
class EXIOAnaloguePinMap {
|
|
public:
|
|
EXIOAnaloguePinMap(uint8_t numAnaloguePins, ...);
|
|
EXIOAnaloguePinMap() = default;
|
|
};
|
|
|
|
/////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
/*
|
|
* IODevice subclass for EX-IOExpander.
|
|
*/
|
|
class EXIOExpander : public IODevice {
|
|
public:
|
|
static void create(VPIN vpin, int nPins, uint8_t i2cAddress, EXIODigitalPinMap digitalPinMap, EXIOAnaloguePinMap analoguePinMap) {
|
|
if (checkNoOverlap(vpin, nPins, i2cAddress)) new EXIOExpander(vpin, nPins, i2cAddress, digitalPinMap, analoguePinMap);
|
|
}
|
|
|
|
private:
|
|
// Constructor
|
|
EXIOExpander(VPIN firstVpin, int nPins, uint8_t i2cAddress, EXIODigitalPinMap digitalPinMap, EXIOAnaloguePinMap analoguePinMap) {
|
|
_firstVpin = firstVpin;
|
|
_nPins = nPins;
|
|
_i2cAddress = i2cAddress;
|
|
_digitalPinMap = digitalPinMap;
|
|
_analoguePinMap = analoguePinMap;
|
|
addDevice(this);
|
|
}
|
|
|
|
void _begin() {
|
|
// Initialise EX-IOExander device
|
|
if (I2CManager.exists(_i2cAddress)) {
|
|
#ifdef DIAG_IO
|
|
_display();
|
|
#endif
|
|
} else {
|
|
DIAG(F("EX-IOExpander device not found, I2C:%x"), _i2cAddress);
|
|
_deviceState = DEVSTATE_FAILED;
|
|
}
|
|
}
|
|
|
|
void _display() override {
|
|
DIAG(F("EX-IOExpander I2C:x%x Configured on Vpins:%d-%d %S"), _i2cAddress, _firstVpin, _firstVpin+_nPins-1,
|
|
_deviceState == DEVSTATE_FAILED ? F("OFFLINE") : F(""));
|
|
}
|
|
|
|
uint8_t _i2cAddress;
|
|
EXIODigitalPinMap _digitalPinMap;
|
|
EXIOAnaloguePinMap _analoguePinMap;
|
|
|
|
enum {
|
|
REG_EXIOINIT = 0x00, // Flag to initialise setup procedure
|
|
REG_EXIODPIN = 0x01, // Flag we're sending digital pin assignments
|
|
REG_EXIOAPIN = 0x02, // Flag we're sending analogue pin assignments
|
|
REG_EXIORDY = 0x03, // Flag we have completed setup procedure, also for EX-IO to ACK setup
|
|
REG_EXIODDIR = 0x04, // Flag we're sending digital pin direction configuration
|
|
REG_EXIODPUP = 0x05, // Flag we're sending digital pin pullup configuration
|
|
};
|
|
};
|
|
|
|
#endif |