mirror of
https://github.com/DCC-EX/CommandStation-EX.git
synced 2024-12-23 12:51:24 +01:00
197 lines
7.2 KiB
C++
197 lines
7.2 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_EXIOExpander.h device driver integrates with one or more EX-IOExpander devices.
|
|
* This device driver will configure the device on startup, along with
|
|
* interacting with the device for all input/output duties.
|
|
*
|
|
* To create EX-IOExpander devices, these are defined in myHal.cpp:
|
|
* (Note the device driver is included by default)
|
|
*
|
|
* void halSetup() {
|
|
* // EXIOExpander::create(vpin, num_vpins, i2c_address, digitalPinCount, analoguePinCount);
|
|
* EXIOExpander::create(800, 18, 0x65, 12, 8);
|
|
* }
|
|
*
|
|
* Note when defining the number of digital and analogue pins, there is no way to sanity check
|
|
* this from the device driver, and it is up to the user to define the correct values here.
|
|
*
|
|
* All pins available on the EX-IOExpander device must be accounted for.
|
|
*
|
|
* Vpins are allocated to digital pins first, and then analogue pins, so digital pins will
|
|
* populate the first part of the specified vpin range, with the analogue pins populating the
|
|
* last part of the vpin range.
|
|
* Eg. for a default Nano, 800 - 811 are digital (D2 - D13), 812 to 817 are analogue (A0 - A3, A6/A7).
|
|
*/
|
|
|
|
#ifndef IO_EX_IOEXPANDER_H
|
|
#define IO_EX_IOEXPANDER_H
|
|
|
|
#include "I2CManager.h"
|
|
#include "DIAG.h"
|
|
#include "FSH.h"
|
|
|
|
/////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
/*
|
|
* IODevice subclass for EX-IOExpander.
|
|
*/
|
|
class EXIOExpander : public IODevice {
|
|
public:
|
|
static void create(VPIN vpin, int nPins, uint8_t i2cAddress, int numDigitalPins, int numAnaloguePins) {
|
|
if (checkNoOverlap(vpin, nPins, i2cAddress)) new EXIOExpander(vpin, nPins, i2cAddress, numDigitalPins, numAnaloguePins);
|
|
}
|
|
|
|
private:
|
|
// Constructor
|
|
EXIOExpander(VPIN firstVpin, int nPins, uint8_t i2cAddress, int numDigitalPins, int numAnaloguePins) {
|
|
_firstVpin = firstVpin;
|
|
_nPins = nPins;
|
|
_i2cAddress = i2cAddress;
|
|
_numDigitalPins = numDigitalPins;
|
|
_numAnaloguePins = numAnaloguePins;
|
|
addDevice(this);
|
|
}
|
|
|
|
void _begin() {
|
|
// Initialise EX-IOExander device
|
|
I2CManager.begin();
|
|
if (I2CManager.exists(_i2cAddress)) {
|
|
_digitalOutBuffer[0] = EXIOINIT;
|
|
_digitalOutBuffer[1] = _numDigitalPins;
|
|
_digitalOutBuffer[2] = _numAnaloguePins;
|
|
// Send config, if EXIORDY returned, we're good, otherwise go offline
|
|
I2CManager.read(_i2cAddress, _digitalInBuffer, 1, _digitalOutBuffer, 3);
|
|
if (_digitalInBuffer[0] != EXIORDY) {
|
|
DIAG(F("ERROR configuring EX-IOExpander device, I2C:x%x"), _i2cAddress);
|
|
_deviceState = DEVSTATE_FAILED;
|
|
return;
|
|
}
|
|
// Attempt to get version, if we don't get it, we don't care, don't go offline
|
|
// Using digital in buffer in reverse to save RAM
|
|
_digitalInBuffer[0] = EXIOVER;
|
|
I2CManager.read(_i2cAddress, _versionBuffer, 3, _digitalInBuffer, 1);
|
|
_majorVer = _versionBuffer[0];
|
|
_minorVer = _versionBuffer[1];
|
|
_patchVer = _versionBuffer[2];
|
|
DIAG(F("EX-IOExpander device found, I2C:x%x, Version v%d.%d.%d"),
|
|
_i2cAddress, _versionBuffer[0], _versionBuffer[1], _versionBuffer[2]);
|
|
#ifdef DIAG_IO
|
|
_display();
|
|
#endif
|
|
} else {
|
|
DIAG(F("EX-IOExpander device not found, I2C:x%x"), _i2cAddress);
|
|
_deviceState = DEVSTATE_FAILED;
|
|
}
|
|
}
|
|
|
|
bool _configure(VPIN vpin, ConfigTypeEnum configType, int paramCount, int params[]) override {
|
|
if (configType != CONFIGURE_INPUT) return false;
|
|
if (paramCount != 1) return false;
|
|
if (vpin >= _firstVpin + _numDigitalPins) {
|
|
DIAG(F("EX-IOExpander ERROR: Vpin %d is an analogue pin, cannot use as a digital pin"), vpin);
|
|
return false;
|
|
}
|
|
bool pullup = params[0];
|
|
int pin = vpin - _firstVpin;
|
|
_digitalOutBuffer[0] = EXIODPUP;
|
|
_digitalOutBuffer[1] = pin;
|
|
_digitalOutBuffer[2] = pullup;
|
|
I2CManager.write(_i2cAddress, _digitalOutBuffer, 3);
|
|
return true;
|
|
}
|
|
|
|
// We only use this to detect incorrect use of analogue pins
|
|
int _configureAnalogIn(VPIN vpin) override {
|
|
if (vpin < _firstVpin + _numDigitalPins) {
|
|
DIAG(F("EX-IOExpander ERROR: Vpin %d is a digital pin, cannot use as an analogue pin"), vpin);
|
|
}
|
|
return false;
|
|
}
|
|
|
|
int _readAnalogue(VPIN vpin) override {
|
|
if (vpin < _firstVpin + _numDigitalPins) return false;
|
|
int pin = vpin - _firstVpin;
|
|
_analogueOutBuffer[0] = EXIORDAN;
|
|
_analogueOutBuffer[1] = pin;
|
|
I2CManager.read(_i2cAddress, _analogueInBuffer, 2, _analogueOutBuffer, 2);
|
|
return (_analogueInBuffer[1] << 8) + _analogueInBuffer[0];
|
|
}
|
|
|
|
int _read(VPIN vpin) override {
|
|
if (vpin >= _firstVpin + _numDigitalPins) return false;
|
|
int pin = vpin - _firstVpin;
|
|
_digitalOutBuffer[0] = EXIORDD;
|
|
_digitalOutBuffer[1] = pin;
|
|
_digitalOutBuffer[2] = 0x00; // Don't need to use this for reading
|
|
I2CManager.read(_i2cAddress, _digitalInBuffer, 1, _digitalOutBuffer, 3);
|
|
return _digitalInBuffer[0];
|
|
}
|
|
|
|
void _write(VPIN vpin, int value) override {
|
|
if (vpin >= _firstVpin + _numDigitalPins) return;
|
|
int pin = vpin - _firstVpin;
|
|
_digitalOutBuffer[0] = EXIOWRD;
|
|
_digitalOutBuffer[1] = pin;
|
|
_digitalOutBuffer[2] = value;
|
|
I2CManager.write(_i2cAddress, _digitalOutBuffer, 3);
|
|
}
|
|
|
|
void _display() override {
|
|
int _firstAnalogue, _lastAnalogue;
|
|
if (_numAnaloguePins == 0) {
|
|
_firstAnalogue = 0;
|
|
_lastAnalogue = 0;
|
|
} else {
|
|
_firstAnalogue = _firstVpin + _numDigitalPins;
|
|
_lastAnalogue = _firstVpin + _nPins - 1;
|
|
}
|
|
DIAG(F("EX-IOExpander I2C:x%x v%d.%d.%d: %d Digital Vpins %d-%d, %d Analogue Vpins %d-%d %S"),
|
|
_i2cAddress, _majorVer, _minorVer, _patchVer,
|
|
_numDigitalPins, _firstVpin, _firstVpin + _numDigitalPins - 1,
|
|
_numAnaloguePins, _firstAnalogue, _lastAnalogue,
|
|
_deviceState == DEVSTATE_FAILED ? F("OFFLINE") : F(""));
|
|
}
|
|
|
|
uint8_t _i2cAddress;
|
|
uint8_t _numDigitalPins;
|
|
uint8_t _numAnaloguePins;
|
|
int _digitalPinBytes;
|
|
int _analoguePinBytes;
|
|
byte _analogueInBuffer[2];
|
|
byte _analogueOutBuffer[2];
|
|
byte _digitalOutBuffer[3];
|
|
byte _digitalInBuffer[1];
|
|
uint8_t _versionBuffer[3];
|
|
uint8_t _majorVer = 0;
|
|
uint8_t _minorVer = 0;
|
|
uint8_t _patchVer = 0;
|
|
|
|
enum {
|
|
EXIOINIT = 0xE0, // Flag to initialise setup procedure
|
|
EXIORDY = 0xE1, // Flag we have completed setup procedure, also for EX-IO to ACK setup
|
|
EXIODPUP = 0xE2, // Flag we're sending digital pin pullup configuration
|
|
EXIOVER = 0xE3, // Flag to get version
|
|
EXIORDAN = 0xE4, // Flag to read an analogue input
|
|
EXIOWRD = 0xE5, // Flag for digital write
|
|
EXIORDD = 0xE6, // Flag to read digital input
|
|
};
|
|
};
|
|
|
|
#endif |