mirror of
https://github.com/DCC-EX/CommandStation-EX.git
synced 2024-11-30 03:26:13 +01:00
9dacd24d27
* Add <D SERVO vpin position> command Allow a PWM servo to be driven to any arbitrary position. * Enhancements for HAL drivers Add state change notification for external GPIO module drivers; Allow drivers to be installed statically by declaration (as an alternative to the 'create' call). * Create IO_HCSR04.h HAL driver for HC-SR04 ultrasonic distance sensor (sonar). * Enable servo commands in NO-HAL mode, but return error. Avoid compile errors in RMFT.cpp when compiled with basic HAL by including the Turnout::createServo function as a stub that returns NULL. * Update IO_HCSR04.h Minor changes * Change <D SERVO> Give the <D SERVO> command an optional parameter of the profile. For example, <D SERVO 100 200 3> will slowly move the servo on pin 100 to PWM position corresponding to 200. If omitted, the servo will move immediately (no animation). * IODevice (HAL) changes 1) Put new devices on the end of the chain instead of the beginning. This will give better performance for devices created first (ArduinoPins and extender GPIO devices, typically). 2) Remove unused functions. * Update IO_HCSR04.h Allow thresholds for ON and OFF to be separately configured at creation. * Update IODevice.cpp Fix compile error on IO_NO_HAL minimal HAL version. * Update IO_PCA9685.cpp Remove unnecessary duplicated call to min() function.
84 lines
2.9 KiB
C++
84 lines
2.9 KiB
C++
/*
|
|
* © 2021, Neil McKechnie. All rights reserved.
|
|
*
|
|
* This file is part of DCC++EX API
|
|
*
|
|
* 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/>.
|
|
*/
|
|
|
|
#ifndef IO_PCF8574_H
|
|
#define IO_PCF8574_H
|
|
|
|
#include "IO_GPIOBase.h"
|
|
|
|
class PCF8574 : public GPIOBase<uint8_t> {
|
|
public:
|
|
static void create(VPIN firstVpin, uint8_t nPins, uint8_t I2CAddress, int interruptPin=-1) {
|
|
new PCF8574(firstVpin, nPins, I2CAddress, interruptPin);
|
|
}
|
|
|
|
PCF8574(VPIN firstVpin, uint8_t nPins, uint8_t I2CAddress, int interruptPin=-1)
|
|
: GPIOBase<uint8_t>((FSH *)F("PCF8574"), firstVpin, min(nPins, 8), I2CAddress, interruptPin)
|
|
{
|
|
requestBlock.setReadParams(_I2CAddress, inputBuffer, 1);
|
|
}
|
|
|
|
private:
|
|
// The pin state is '1' if the pin is an input or if it is an output set to 1. Zero otherwise.
|
|
void _writeGpioPort() override {
|
|
I2CManager.write(_I2CAddress, 1, _portOutputState | ~_portMode);
|
|
}
|
|
|
|
// The PCF8574 handles inputs by applying a weak pull-up when output is driven to '1'.
|
|
// Therefore, writing '1' in _writePortModes is enough to set the module to input mode
|
|
// and enable pull-up.
|
|
void _writePullups() override { }
|
|
|
|
// The pin state is '1' if the pin is an input or if it is an output set to 1. Zero otherwise.
|
|
void _writePortModes() override {
|
|
I2CManager.write(_I2CAddress, 1, _portOutputState | ~_portMode);
|
|
}
|
|
|
|
// In immediate mode, _readGpioPort reads the device GPIO port and updates _portInputState accordingly.
|
|
// When not in immediate mode, it initiates a request using the request block and returns.
|
|
// When the request completes, _processCompletion finishes the operation.
|
|
void _readGpioPort(bool immediate) override {
|
|
if (immediate) {
|
|
uint8_t buffer[1];
|
|
I2CManager.read(_I2CAddress, buffer, 1);
|
|
_portInputState = ((uint16_t)buffer) & 0xff;
|
|
} else {
|
|
requestBlock.wait(); // Wait for preceding operation to complete
|
|
// Issue new request to read GPIO register
|
|
I2CManager.queueRequest(&requestBlock);
|
|
}
|
|
}
|
|
|
|
// This function is invoked when an I/O operation on the requestBlock completes.
|
|
void _processCompletion(uint8_t status) override {
|
|
if (status == I2C_STATUS_OK)
|
|
_portInputState = ((uint16_t)inputBuffer[0]) & 0xff;
|
|
else
|
|
_portInputState = 0xff;
|
|
}
|
|
|
|
// Set up device ports
|
|
void _setupDevice() override {
|
|
_writePortModes();
|
|
}
|
|
|
|
uint8_t inputBuffer[1];
|
|
};
|
|
|
|
#endif |