From ebe0482d953d66aa3f89734daa471afff7c77add Mon Sep 17 00:00:00 2001
From: Ash-4 <81280775+Ash-4@users.noreply.github.com>
Date: Wed, 2 Aug 2023 14:58:31 -0500
Subject: [PATCH 01/44] Add files via upload
---
IO_CMRI.cpp | 316 +++++++++++++++++++++++++++++++++++++++++++++
IO_CMRI.h | 291 +++++++++++++++++++++++++++++++++++++++++
mySetup_h_cmri.txt | 128 ++++++++++++++++++
3 files changed, 735 insertions(+)
create mode 100644 IO_CMRI.cpp
create mode 100644 IO_CMRI.h
create mode 100644 mySetup_h_cmri.txt
diff --git a/IO_CMRI.cpp b/IO_CMRI.cpp
new file mode 100644
index 0000000..1dfa2fc
--- /dev/null
+++ b/IO_CMRI.cpp
@@ -0,0 +1,316 @@
+/*
+ * © 2023, 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 .
+ */
+
+#include "IO_CMRI.h"
+#include "defines.h"
+
+/************************************************************
+ * CMRIbus implementation
+ ************************************************************/
+
+// Constructor for CMRIbus
+CMRIbus::CMRIbus(uint8_t busNo, HardwareSerial &serial, unsigned long baud, uint16_t cycleTimeMS, VPIN transmitEnablePin) {
+ _busNo = busNo;
+ _serial = &serial;
+ _baud = baud;
+ _cycleTime = cycleTimeMS * 1000UL; // convert from milliseconds to microseconds.
+ _transmitEnablePin = transmitEnablePin;
+ if (_transmitEnablePin != VPIN_NONE) {
+ pinMode(_transmitEnablePin, OUTPUT);
+ ArduinoPins::fastWriteDigital(_transmitEnablePin, 0); // transmitter initially off
+ }
+
+ // Max message length is 256+6=262 bytes.
+ // Each byte is one start bit, 8 data bits and 1 or 2 stop bits, assume 11 bits per byte.
+ // Calculate timeout based on treble this time.
+ _timeoutPeriod = 3 * 11 * 262 * 1000UL / (_baud / 1000UL);
+#if defined(ARDUINOCMRI_COMPATIBLE)
+ // NOTE: The ArduinoCMRI library, unless modified, contains a 'delay(50)' between
+ // receiving the end of the prompt message and starting to send the response. This
+ // is allowed for below.
+ _timeoutPeriod += 50000UL;
+#endif
+
+ // Calculate the time in microseconds to transmit one byte (11 bits max).
+ _byteTransmitTime = 1000000UL * 11 / _baud;
+ // Postdelay is only required if we need to allow for data still being sent when
+ // we want to switch off the transmitter. The flush() method of HardwareSerial
+ // ensures that the data has completed being sent over the line.
+ _postDelay = 0;
+
+ // Add device to HAL device chain
+ IODevice::addDevice(this);
+
+ // Add bus to CMRIbus chain.
+ _nextBus = _busList;
+ _busList = this;
+}
+
+
+// Main loop function for CMRIbus.
+// Work through list of nodes. For each node, in separate loop entries
+// send initialisation message (once only); then send
+// output message; then send prompt for input data, and
+// process any response data received.
+// When the slot time has finished, move on to the next device.
+void CMRIbus::_loop(unsigned long currentMicros) {
+
+ _currentMicros = currentMicros;
+
+ while (_serial->available())
+ processIncoming();
+
+ // Send any data that needs sending.
+ processOutgoing();
+
+}
+
+// Send output data to the bus for nominated CMRInode
+uint16_t CMRIbus::sendData(CMRInode *node) {
+ uint16_t numDataBytes = (node->getNumOutputs()+7)/8;
+ _serial->write(SYN);
+ _serial->write(SYN);
+ _serial->write(STX);
+ _serial->write(node->getAddress() + 65);
+ _serial->write('T'); // T for Transmit data message
+ uint16_t charsSent = 6; // include header and trailer
+ for (uint8_t index=0; indexgetOutputStates(index);
+ if (value == DLE || value == STX || value == ETX) {
+ _serial->write(DLE);
+ charsSent++;
+ }
+ _serial->write(value);
+ charsSent++;
+ }
+ _serial->write(ETX);
+ return charsSent; // number of characters sent
+}
+
+// Send request for input data to nominated CMRInode.
+uint16_t CMRIbus::requestData(CMRInode *node) {
+ _serial->write(SYN);
+ _serial->write(SYN);
+ _serial->write(STX);
+ _serial->write(node->getAddress() + 65);
+ _serial->write('P'); // P for Poll message
+ _serial->write(ETX);
+ return 6; // number of characters sent
+}
+
+// Send initialisation message
+uint16_t CMRIbus::sendInitialisation(CMRInode *node) {
+ _serial->write(SYN);
+ _serial->write(SYN);
+ _serial->write(STX);
+ _serial->write(node->getAddress() + 65);
+ _serial->write('I'); // I for initialise message
+ _serial->write(node->getType()); // NDP
+ _serial->write((uint8_t)0); // dH
+ _serial->write((uint8_t)0); // dL
+ _serial->write((uint8_t)0); // NS
+ _serial->write(ETX);
+ return 10; // number of characters sent
+}
+
+void CMRIbus::processOutgoing() {
+ uint16_t charsSent = 0;
+ if (_currentNode == NULL) {
+ // If we're between read/write cycles then don't do anything else.
+ if (_currentMicros - _cycleStartTime < _cycleTime) return;
+ // ... otherwise start processing the first node in the list
+ _currentNode = _nodeListStart;
+ _transmitState = TD_INIT;
+ _cycleStartTime = _currentMicros;
+ }
+ if (_currentNode == NULL) return;
+ switch (_transmitState) {
+ case TD_IDLE:
+ case TD_INIT:
+ enableTransmitter();
+ if (!_currentNode->isInitialised()) {
+ charsSent = sendInitialisation(_currentNode);
+ _currentNode->setInitialised();
+ _transmitState = TD_TRANSMIT;
+ delayUntil(_currentMicros+_byteTransmitTime*charsSent);
+ break;
+ }
+ /* fallthrough */
+ case TD_TRANSMIT:
+ charsSent = sendData(_currentNode);
+ _transmitState = TD_PROMPT;
+ // Defer next entry for as long as it takes to transmit the characters,
+ // to allow output queue to empty. Allow 2 bytes extra.
+ delayUntil(_currentMicros+_byteTransmitTime*(charsSent+2));
+ break;
+ case TD_PROMPT:
+ charsSent = requestData(_currentNode);
+ disableTransmitter();
+ _transmitState = TD_RECEIVE;
+ _timeoutStart = _currentMicros; // Start timeout on response
+ break;
+ case TD_RECEIVE: // Waiting for response / timeout
+ if (_currentMicros - _timeoutStart > _timeoutPeriod) {
+ // End of time slot allocated for responses.
+ _transmitState = TD_IDLE;
+ // Reset state of receiver
+ _receiveState = RD_SYN1;
+ // Move to next node
+ _currentNode = _currentNode->getNext();
+ }
+ break;
+ }
+}
+
+// Process any data bytes received from a CMRInode.
+void CMRIbus::processIncoming() {
+ int data = _serial->read();
+ if (data < 0) return; // No characters to read
+
+ if (_transmitState != TD_RECEIVE || !_currentNode) return; // Not waiting for input, so ignore.
+
+ uint8_t nextState = RD_SYN1; // default to resetting state machine
+ switch(_receiveState) {
+ case RD_SYN1:
+ if (data == SYN) nextState = RD_SYN2;
+ break;
+ case RD_SYN2:
+ if (data == SYN) nextState = RD_STX; else nextState = RD_SYN2;
+ break;
+ case RD_STX:
+ if (data == STX) nextState = RD_ADDR;
+ break;
+ case RD_ADDR:
+ // If address doesn't match, then ignore everything until next SYN-SYN-STX.
+ if (data == _currentNode->getAddress() + 65) nextState = RD_TYPE;
+ break;
+ case RD_TYPE:
+ _receiveDataIndex = 0; // Initialise data pointer
+ if (data == 'R') nextState = RD_DATA;
+ break;
+ case RD_DATA: // data body
+ if (data == DLE) // escape next character
+ nextState = RD_ESCDATA;
+ else if (data == ETX) { // end of data
+ // End of data message. Protocol has all data in one
+ // message, so we don't need to wait any more. Allow
+ // transmitter to proceed with next node in list.
+ _currentNode = _currentNode->getNext();
+ _transmitState = TD_IDLE;
+ } else {
+ // Not end yet, so save data byte
+ _currentNode->saveIncomingData(_receiveDataIndex++, data);
+ nextState = RD_DATA; // wait for more data
+ }
+ break;
+ case RD_ESCDATA: // escaped data byte
+ _currentNode->saveIncomingData(_receiveDataIndex++, data);
+ nextState = RD_DATA;
+ break;
+ }
+ _receiveState = nextState;
+}
+
+// If configured for half duplex RS485, switch RS485 interface
+// into transmit mode.
+void CMRIbus::enableTransmitter() {
+ if (_transmitEnablePin != VPIN_NONE)
+ ArduinoPins::fastWriteDigital(_transmitEnablePin, 1);
+ // If we need a delay before we start the packet header,
+ // we can send a character or two to synchronise the
+ // transmitter and receiver.
+ // SYN characters should be used, but a bug in the
+ // ArduinoCMRI library causes it to ignore the packet if
+ // it's preceded by an odd number of SYN characters.
+ // So send a SYN followed by a NUL in that case.
+ _serial->write(SYN);
+#if defined(ARDUINOCMRI_COMPATIBLE)
+ _serial->write(NUL); // Reset the ArduinoCMRI library's parser
+#endif
+}
+
+// If configured for half duplex RS485, switch RS485 interface
+// into receive mode.
+void CMRIbus::disableTransmitter() {
+ // Wait until all data has been transmitted. On the standard
+ // AVR driver, this waits until the FIFO is empty and all
+ // data has been sent over the link.
+ _serial->flush();
+ // If we don't trust the 'flush' function and think the
+ // data's still in transit, then wait a bit longer.
+ if (_postDelay > 0)
+ delayMicroseconds(_postDelay);
+ // Hopefully, we can now safely switch off the transmitter.
+ if (_transmitEnablePin != VPIN_NONE)
+ ArduinoPins::fastWriteDigital(_transmitEnablePin, 0);
+}
+
+// Link to chain of CMRI bus instances
+CMRIbus *CMRIbus::_busList = NULL;
+
+
+/************************************************************
+ * CMRInode implementation
+ ************************************************************/
+
+// Constructor for CMRInode object
+CMRInode::CMRInode(VPIN firstVpin, int nPins, uint8_t busNo, uint8_t address, char type, uint16_t inputs, uint16_t outputs) {
+ _firstVpin = firstVpin;
+ _nPins = nPins;
+ _busNo = busNo;
+ _address = address;
+ _type = type;
+
+ switch (_type) {
+ case 'M': // SMINI, fixed 24 inputs and 48 outputs
+ _numInputs = 24;
+ _numOutputs = 48;
+ break;
+ case 'C': // CPNODE with 16 to 144 inputs/outputs using 8-bit cards
+ _numInputs = inputs;
+ _numOutputs = outputs;
+ break;
+ case 'N': // Classic USIC and SUSIC using 24 bit i/o cards
+ case 'X': // SUSIC using 32 bit i/o cards
+ default:
+ DIAG(F("CMRInode: bus:%d address:%d ERROR unsupported type %c"), _busNo, _address, _type);
+ return; // Don't register device.
+ }
+ if ((unsigned int)_nPins < _numInputs + _numOutputs)
+ DIAG(F("CMRInode: bus:%d address:%d WARNING number of Vpins does not cover all inputs and outputs"), _busNo, _address);
+
+ // Allocate memory for states
+ _inputStates = (uint8_t *)calloc((_numInputs+7)/8, 1);
+ _outputStates = (uint8_t *)calloc((_numOutputs+7)/8, 1);
+ if (!_inputStates || !_outputStates) {
+ DIAG(F("CMRInode: ERROR insufficient memory"));
+ return;
+ }
+
+ // Add this device to HAL device list
+ IODevice::addDevice(this);
+
+ // Add CMRInode to CMRIbus object.
+ CMRIbus *bus = CMRIbus::findBus(_busNo);
+ if (bus != NULL) {
+ bus->addNode(this);
+ return;
+ }
+}
+
diff --git a/IO_CMRI.h b/IO_CMRI.h
new file mode 100644
index 0000000..bb1abfb
--- /dev/null
+++ b/IO_CMRI.h
@@ -0,0 +1,291 @@
+/*
+ * © 2023, 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 .
+ */
+
+/*
+ * CMRIbus
+ * =======
+ * To define a CMRI bus, example syntax:
+ * CMRIbus::create(bus, serial, baud[, cycletime[, pin]]);
+ *
+ * bus = 0-255
+ * serial = serial port to be used (e.g. Serial3)
+ * baud = baud rate (9600, 19200, 28800, 57600 or 115200)
+ * cycletime = minimum time between successive updates/reads of a node in millisecs (default 500ms)
+ * pin = pin number connected to RS485 module's DE and !RE terminals for half-duplex operation (default VPIN_NONE)
+ *
+ * Each bus must use a different serial port.
+ *
+ * IMPORTANT: If you are using ArduinoCMRI library code by Michael Adams, at the time of writing this library
+ * is not compliant with the LCS-9.10.1 specification for CMRInet protocol.
+ * Various work-arounds may be enabled within the driver by adding the following line to your config.h file,
+ * to allow nodes running the ArduinoCMRI library to communicate:
+ *
+ * #define ARDUINOCMRI_COMPATIBLE
+ *
+ * CMRINode
+ * ========
+ * To define a CMRI node and associate it with a CMRI bus,
+ * CMRInode::create(firstVPIN, numVPINs, bus, address, type [, inputs, outputs]);
+ *
+ * firstVPIN = first vpin in block allocated to this device
+ * numVPINs = number of vpins (e.g. 72 for an SMINI node)
+ * bus = 0-255
+ * address = 0-127
+ * type = 'M' for SMINI (fixed 24 inputs and 48 outputs)
+ * 'C' for CPNODE (16 to 144 inputs/outputs in groups of 8)
+ * (other types are not supported at this time).
+ * inputs = number of inputs (CPNODE only)
+ * outputs = number of outputs (CPNODE only)
+ *
+ * Reference: "LCS-9.10.1
+ * Layout Control Specification: CMRInet Protocol
+ * Version 1.1 December 2014."
+ */
+
+#ifndef IO_CMRI_H
+#define IO_CMRI_H
+
+#include "IODevice.h"
+
+/**********************************************************************
+ * CMRInode class
+ *
+ * This encapsulates the state associated with a single CMRI node,
+ * which includes the address type, number of inputs and outputs, and
+ * the states of the inputs and outputs.
+ **********************************************************************/
+class CMRInode : public IODevice {
+private:
+ uint8_t _busNo;
+ uint8_t _address;
+ char _type;
+ CMRInode *_next = NULL;
+ uint8_t *_inputStates = NULL;
+ uint8_t *_outputStates = NULL;
+ uint16_t _numInputs = 0;
+ uint16_t _numOutputs = 0;
+ bool _initialised = false;
+
+public:
+ static void create(VPIN firstVpin, int nPins, uint8_t busNo, uint8_t address, char type, uint16_t inputs=0, uint16_t outputs=0) {
+ if (checkNoOverlap(firstVpin, nPins)) new CMRInode(firstVpin, nPins, busNo, address, type, inputs, outputs);
+ }
+ CMRInode(VPIN firstVpin, int nPins, uint8_t busNo, uint8_t address, char type, uint16_t inputs=0, uint16_t outputs=0);
+
+ uint8_t getAddress() {
+ return _address;
+ }
+ CMRInode *getNext() {
+ return _next;
+ }
+ void setNext(CMRInode *node) {
+ _next = node;
+ }
+ bool isInitialised() {
+ return _initialised;
+ }
+ void setInitialised() {
+ _initialised = true;
+ }
+
+ void _begin() {
+ _initialised = false;
+ }
+
+ int _read(VPIN vpin) {
+ // Return current state from this device
+ uint16_t pin = vpin - _firstVpin;
+ if (pin < _numInputs) {
+ uint8_t mask = 1 << (pin & 0x7);
+ int index = pin / 8;
+ return (_inputStates[index] & mask) != 0;
+ } else
+ return 0;
+ }
+
+ void _write(VPIN vpin, int value) {
+ // Update current state for this device, in preparation the bus transmission
+ uint16_t pin = vpin - _firstVpin - _numInputs;
+ if (pin < _numOutputs) {
+ uint8_t mask = 1 << (pin & 0x7);
+ int index = pin / 8;
+ if (value)
+ _outputStates[index] |= mask;
+ else
+ _outputStates[index] &= ~mask;
+ }
+ }
+
+ void saveIncomingData(uint8_t index, uint8_t data) {
+ if (index < (_numInputs+7)/8)
+ _inputStates[index] = data;
+ }
+
+ uint8_t getOutputStates(uint8_t index) {
+ if (index < (_numOutputs+7)/8)
+ return _outputStates[index];
+ else
+ return 0;
+ }
+
+ uint16_t getNumInputs() {
+ return _numInputs;
+ }
+
+ uint16_t getNumOutputs() {
+ return _numOutputs;
+ }
+
+ char getType() {
+ return _type;
+ }
+
+ uint8_t getBusNumber() {
+ return _busNo;
+ }
+
+ void _display() override {
+ DIAG(F("CMRInode type:'%c' configured on bus:%d address:%d VPINs:%u-%u (in) %u-%u (out)"),
+ _type, _busNo, _address, _firstVpin, _firstVpin+_numInputs-1,
+ _firstVpin+_numInputs, _firstVpin+_numInputs+_numOutputs-1);
+ }
+
+};
+
+/**********************************************************************
+ * CMRIbus class
+ *
+ * This encapsulates the properties state of the bus and the
+ * transmission and reception of data across that bus. Each CMRIbus
+ * object owns a set of CMRInode objects which represent the nodes
+ * attached to that bus.
+ **********************************************************************/
+class CMRIbus : public IODevice {
+private:
+ // Here we define the device-specific variables.
+ uint8_t _busNo;
+ HardwareSerial *_serial;
+ unsigned long _baud;
+ VPIN _transmitEnablePin = VPIN_NONE;
+ CMRInode *_nodeListStart = NULL, *_nodeListEnd = NULL;
+ CMRInode *_currentNode = NULL;
+
+ // Transmitter state machine states
+ enum {TD_IDLE, TD_PRETRANSMIT, TD_INIT, TD_TRANSMIT, TD_PROMPT, TD_RECEIVE};
+ uint8_t _transmitState = TD_IDLE;
+ // Receiver state machine states.
+ enum {RD_SYN1, RD_SYN2, RD_STX, RD_ADDR, RD_TYPE,
+ RD_DATA, RD_ESCDATA, RD_SKIPDATA, RD_SKIPESCDATA, RD_ETX};
+ uint8_t _receiveState = RD_SYN1;
+ uint16_t _receiveDataIndex = 0; // Index of next data byte to be received.
+ CMRIbus *_nextBus = NULL; // Pointer to next bus instance in list.
+ unsigned long _cycleStartTime = 0;
+ unsigned long _timeoutStart = 0;
+ unsigned long _cycleTime; // target time between successive read/write cycles, microseconds
+ unsigned long _timeoutPeriod; // timeout on read responses, in microseconds.
+ unsigned long _currentMicros; // last value of micros() from _loop function.
+ unsigned long _postDelay; // delay time after transmission before switching off transmitter (in us)
+ unsigned long _byteTransmitTime; // time in us for transmission of one byte
+
+ static CMRIbus *_busList; // linked list of defined bus instances
+
+ // Definition of special characters in CMRInet protocol
+ enum : uint8_t {
+ NUL = 0x00,
+ STX = 0x02,
+ ETX = 0x03,
+ DLE = 0x10,
+ SYN = 0xff,
+ };
+
+public:
+ static void create(uint8_t busNo, HardwareSerial &serial, unsigned long baud, uint16_t cycleTimeMS=500, VPIN transmitEnablePin=VPIN_NONE) {
+ new CMRIbus(busNo, serial, baud, cycleTimeMS, transmitEnablePin);
+ }
+
+ // Device-specific initialisation
+ void _begin() override {
+ // CMRInet spec states one stop bit, JMRI and ArduinoCMRI use two stop bits
+#if defined(ARDUINOCMRI_COMPATIBLE)
+ _serial->begin(_baud, SERIAL_8N2);
+#else
+ _serial->begin(_baud, SERIAL_8N1);
+#endif
+ #if defined(DIAG_IO)
+ _display();
+ #endif
+ }
+
+ // Loop function (overriding IODevice::_loop(unsigned long))
+ void _loop(unsigned long currentMicros) override;
+
+ // Display information about the device
+ void _display() override {
+ DIAG(F("CMRIbus %d configured, speed=%d baud, cycle=%d ms"), _busNo, _baud, _cycleTime/1000);
+ }
+
+ // Locate CMRInode object with specified address.
+ CMRInode *findNode(uint8_t address) {
+ for (CMRInode *node = _nodeListStart; node != NULL; node = node->getNext()) {
+ if (node->getAddress() == address)
+ return node;
+ }
+ return NULL;
+ }
+
+ // Add new CMRInode to the list of nodes for this bus.
+ void addNode(CMRInode *newNode) {
+ if (!_nodeListStart)
+ _nodeListStart = newNode;
+ if (!_nodeListEnd)
+ _nodeListEnd = newNode;
+ else
+ _nodeListEnd->setNext(newNode);
+ }
+
+protected:
+ CMRIbus(uint8_t busNo, HardwareSerial &serial, unsigned long baud, uint16_t cycleTimeMS, VPIN transmitEnablePin);
+ uint16_t sendData(CMRInode *node);
+ uint16_t requestData(CMRInode *node);
+ uint16_t sendInitialisation(CMRInode *node);
+
+ // Process any data bytes received from a CMRInode.
+ void processIncoming();
+ // Process any outgoing traffic that is due.
+ void processOutgoing();
+ // Enable transmitter
+ void enableTransmitter();
+ // Disable transmitter and enable receiver
+ void disableTransmitter();
+
+
+public:
+ uint8_t getBusNumber() {
+ return _busNo;
+ }
+
+ static CMRIbus *findBus(uint8_t busNo) {
+ for (CMRIbus *bus=_busList; bus!=NULL; bus=bus->_nextBus) {
+ if (bus->_busNo == busNo) return bus;
+ }
+ return NULL;
+ }
+};
+
+#endif // IO_CMRI_H
\ No newline at end of file
diff --git a/mySetup_h_cmri.txt b/mySetup_h_cmri.txt
new file mode 100644
index 0000000..405c3b1
--- /dev/null
+++ b/mySetup_h_cmri.txt
@@ -0,0 +1,128 @@
+// mySetup.h
+// defining CMRI accessories
+// CMRI connections defined in myHal.cpp
+//
+// this is for testing.
+SETUP("D CMD 1");
+// Turnouts defined in myAutomation.h can include descriptions which will appear in Engine Driver
+// Sensors and digital outputs do not require pre-definition for use in EXRAIL automation
+//
+// SMINI emulation node 24-input/48-outputs
+// the sketch I use
+// 16 or 24 input pins
+// 32 or 48 output pins
+//
+// Define 16 input pins 1000-1015
+SETUP("S 1000 1000 1");
+SETUP("S 1001 1001 1");
+SETUP("S 1002 1002 1");
+SETUP("S 1003 1003 1");
+SETUP("S 1004 1004 1");
+SETUP("S 1005 1005 1");
+SETUP("S 1006 1006 1");
+SETUP("S 1007 1007 1");
+SETUP("S 1008 1008 1");
+SETUP("S 1009 1009 1");
+SETUP("S 1010 1010 1");
+SETUP("S 1011 1011 1");
+SETUP("S 1012 1012 1");
+SETUP("S 1013 1013 1");
+SETUP("S 1014 1014 1");
+SETUP("S 1015 1015 1");
+//
+// define 16 turnouts using VPIN (for Throw/Close commands via CMRI)
+SETUP("T 1024 VPIN 1024");
+SETUP("T 1025 VPIN 1025");
+SETUP("T 1026 VPIN 1026");
+SETUP("T 1027 VPIN 1027");
+SETUP("T 1028 VPIN 1028");
+SETUP("T 1029 VPIN 1029");
+SETUP("T 1030 VPIN 1030");
+SETUP("T 1031 VPIN 1031");
+SETUP("T 1032 VPIN 1032");
+SETUP("T 1033 VPIN 1033");
+SETUP("T 1034 VPIN 1034");
+SETUP("T 1035 VPIN 1035");
+SETUP("T 1036 VPIN 1036");
+SETUP("T 1037 VPIN 1037");
+SETUP("T 1038 VPIN 1038");
+SETUP("T 1039 VPIN 1039");
+//
+// define 16 pins for digital outputs
+SETUP("Z 1040 1040 0");
+SETUP("Z 1041 1041 0");
+SETUP("Z 1042 1042 0");
+SETUP("Z 1043 1043 0");
+SETUP("Z 1044 1044 0");
+SETUP("Z 1045 1045 0");
+SETUP("Z 1046 1046 0");
+SETUP("Z 1047 1047 0");
+SETUP("Z 1048 1048 0");
+SETUP("Z 1049 1049 0");
+SETUP("Z 1050 1050 0");
+SETUP("Z 1051 1051 0");
+SETUP("Z 1052 1052 0");
+SETUP("Z 1053 1053 0");
+SETUP("Z 1054 1054 0");
+SETUP("Z 1055 1055 0");
+//
+// additional 16 outputs available 1056-1071
+//SETUP("Z 1056 1056 0");
+//
+// CMRI sketch used for testing available here
+// https://www.trainboard.com/highball/index.php?threads/24-in-48-out-card-for-jmri.116454/page-2#post-1141569
+//
+
+// Define 16 input pins 900-915
+SETUP("S 900 900 1");
+SETUP("S 901 901 1");
+SETUP("S 902 902 1");
+SETUP("S 903 903 1");
+SETUP("S 904 904 1");
+SETUP("S 905 905 1");
+SETUP("S 906 906 1");
+SETUP("S 907 907 1");
+SETUP("S 908 908 1");
+SETUP("S 909 909 1");
+SETUP("S 910 910 1");
+SETUP("S 911 911 1");
+SETUP("S 912 912 1");
+SETUP("S 913 913 1");
+SETUP("S 914 914 1");
+SETUP("S 915 915 1");
+//
+// define 16 turnouts using VPIN (for Throw/Close commands via CMRI)
+SETUP("T 924 VPIN 924");
+SETUP("T 925 VPIN 925");
+SETUP("T 926 VPIN 926");
+SETUP("T 927 VPIN 927");
+SETUP("T 928 VPIN 928");
+SETUP("T 929 VPIN 929");
+SETUP("T 930 VPIN 930");
+SETUP("T 931 VPIN 931");
+SETUP("T 932 VPIN 932");
+SETUP("T 933 VPIN 933");
+SETUP("T 934 VPIN 934");
+SETUP("T 935 VPIN 935");
+SETUP("T 936 VPIN 936");
+SETUP("T 937 VPIN 937");
+SETUP("T 938 VPIN 938");
+SETUP("T 939 VPIN 939");
+//
+// define 16 pins for digital outputs
+SETUP("Z 940 940 0");
+SETUP("Z 941 941 0");
+SETUP("Z 942 942 0");
+SETUP("Z 943 943 0");
+SETUP("Z 944 944 0");
+SETUP("Z 945 945 0");
+SETUP("Z 946 946 0");
+SETUP("Z 947 947 0");
+SETUP("Z 948 948 0");
+SETUP("Z 949 949 0");
+SETUP("Z 950 950 0");
+SETUP("Z 951 951 0");
+SETUP("Z 952 952 0");
+SETUP("Z 953 953 0");
+SETUP("Z 954 954 0");
+SETUP("Z 955 955 0");
From 27fcdfbbbaf873aba1285f0fde18caf20763eff0 Mon Sep 17 00:00:00 2001
From: Ash-4 <81280775+Ash-4@users.noreply.github.com>
Date: Wed, 2 Aug 2023 15:31:49 -0500
Subject: [PATCH 02/44] CMRI setup lines
---
myHal.cpp_example.txt | 40 ++++++++++++++++++++++++++++++++++++++++
1 file changed, 40 insertions(+)
diff --git a/myHal.cpp_example.txt b/myHal.cpp_example.txt
index d93ea5c..f3fa1b3 100644
--- a/myHal.cpp_example.txt
+++ b/myHal.cpp_example.txt
@@ -24,6 +24,16 @@
//#include "IO_TouchKeypad.h // Touch keypad with 16 keys
//#include "IO_EXTurntable.h" // Turntable-EX turntable controller
//#include "IO_EXFastClock.h" // FastClock driver
+//#include "IO_CMRI.h" // CMRI nodes
+
+//==========================================================================
+// also for CMRI connection using RS485 TTL module
+//==========================================================================
+// define UARt2 pins for ESP32 Rx=16, Tx=17 -- can conflict if sabertooth defined
+//HardwareSerial mySerial2(2); // use UART2
+//
+// for SERIAL_8N2 include this in config.h
+// #define ARDUINOCMRI_COMPATIBLE
//==========================================================================
// The function halSetup() is invoked from CS if it exists within the build.
@@ -33,6 +43,36 @@
void halSetup() {
+//==========================================================================
+// CMRI bus and nodes defined
+//==========================================================================
+// further explanation in IO_CMRI.h
+// this example is being used to test connection of existing CMRI device
+// add lines to myHal.cpp within halSetup()
+
+// for ESP32
+//mySerial2.begin(9600, SERIAL_8N2, 16, 17); // ESP32 to define pins also check DCCTimerESP.cpp
+//CMRIbus::create(0, mySerial2, 9600, 500, 4); // for ESP32
+
+// for Mega
+//CMRIbus::create(0, Serial3, 9600, 500, 38); // for Mega - Serial3 already defined
+ // bus=0 always, unless multiple serial ports are used
+ // baud=9600 to match setting in existing CMRI nodes
+ // cycletime.. 500ms is default -- more frequent might be needed on master
+ // pin.. DE/!RE pins tied together on TTL RS485 module.
+ // pin 38 should work on Mega and F411RE (pin D38 aka PB12 on CN10_16)
+
+//CMRInode::create(900, 72, 0, 4, 'M');
+//CMRInode::create(1000, 72, 0, 5, 'M');
+ // bus=0 must agree with bus in CMRIbus
+ // node=4 number to agree with node numbering
+ // 'M' is for SMINI.
+ // Starting VPin, Number of VPins=72 for SMINI
+//==========================================================================
+// end of CMRI
+//==========================================================================
+
+
//=======================================================================
// The following directives define auxiliary display devices.
// These can be defined in addition to the system display (display
From ad6a079c0b7677b34109bc9c0891c55904df0ca6 Mon Sep 17 00:00:00 2001
From: Ash-4
Date: Fri, 18 Aug 2023 14:21:26 -0500
Subject: [PATCH 03/44] Enable multiple CMRI nodes to function
---
DCCTimerSTM32.cpp | 1 +
IO_CMRI.h | 4 +++-
2 files changed, 4 insertions(+), 1 deletion(-)
diff --git a/DCCTimerSTM32.cpp b/DCCTimerSTM32.cpp
index cffae40..7e121be 100644
--- a/DCCTimerSTM32.cpp
+++ b/DCCTimerSTM32.cpp
@@ -55,6 +55,7 @@ HardwareSerial Serial5(PD2, PC12); // Rx=PC7, Tx=PC6 -- UART5 - F446RE
#elif defined(ARDUINO_NUCLEO_F413ZH) || defined(ARDUINO_NUCLEO_F429ZI) || defined(ARDUINO_NUCLEO_F446ZE)|| defined(ARDUINO_NUCLEO_F412ZG)
// Nucleo-144 boards don't have Serial1 defined by default
HardwareSerial Serial6(PG9, PG14); // Rx=PG9, Tx=PG14 -- USART6
+HardwareSerial Serial5(PE7, PE8); // Rx=PE7, Tx=PE8 -- USART5
// Serial3 is defined to use USART3 by default, but is in fact used as the diag console
// via the debugger on the Nucleo-144. It is therefore unavailable for other DCC-EX uses like WiFi, DFPlayer, etc.
#else
diff --git a/IO_CMRI.h b/IO_CMRI.h
index bb1abfb..ef647b8 100644
--- a/IO_CMRI.h
+++ b/IO_CMRI.h
@@ -255,8 +255,10 @@ public:
_nodeListStart = newNode;
if (!_nodeListEnd)
_nodeListEnd = newNode;
- else
+ else {
_nodeListEnd->setNext(newNode);
+ _nodeListEnd = newNode;
+ }
}
protected:
From 0d5495aa25c5107b369724543e8b3410a170f7aa Mon Sep 17 00:00:00 2001
From: pmantoine
Date: Mon, 23 Oct 2023 21:28:25 +0800
Subject: [PATCH 04/44] F429ZI edits for ethernet
---
EthernetInterface.cpp | 63 +++++++++++++++++++++++++++++++++----------
EthernetInterface.h | 10 +++++++
platformio.ini | 18 ++++++++++++-
version.h | 3 ++-
4 files changed, 78 insertions(+), 16 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index 5cf531c..993d5d0 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -41,8 +41,11 @@ void EthernetInterface::setup()
DIAG(F("Prog Error!"));
return;
}
- if ((singleton=new EthernetInterface()))
+ DIAG(F("Ethernet Class setup, attempting to instantiate"));
+ if ((singleton=new EthernetInterface())) {
+ DIAG(F("Ethernet Class initialized"));
return;
+ }
DIAG(F("Ethernet not initialized"));
};
@@ -55,24 +58,48 @@ void EthernetInterface::setup()
*/
EthernetInterface::EthernetInterface()
{
- byte mac[6];
- DCCTimer::getSimulatedMacAddress(mac);
connected=false;
-
- #ifdef IP_ADDRESS
- Ethernet.begin(mac, IP_ADDRESS);
- #else
- if (Ethernet.begin(mac) == 0)
+#if defined(STM32_ETHERNET)
+ // Set a HOSTNAME for the DHCP request - a nice to have, but hard it seems on LWIP for STM32
+ // The default is "lwip", which is **always** set in STM32Ethernet/src/utility/ethernetif.cpp
+ // for some reason. One can edit it to instead read:
+ // #if LWIP_NETIF_HOSTNAME
+ // /* Initialize interface hostname */
+ // if (netif->hostname == NULL)
+ // netif->hostname = "lwip";
+ // #endif /* LWIP_NETIF_HOSTNAME */
+ // Which seems more useful! We should propose the patch... so the following line actually works!
+ netif_set_hostname(&gnetif, WIFI_HOSTNAME); // Should probably be passed in the contructor...
+ #ifdef IP_ADDRESS
+ if (Ethernet.begin(IP_ADDRESS) == 0)
+ #else
+ if (Ethernet.begin() == 0)
+ #endif // IP_ADDRESS
{
DIAG(F("Ethernet.begin FAILED"));
return;
}
- #endif
+#else // All other architectures
+ byte mac[6]= { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
+ DIAG(F("Ethernet attempting to get MAC address"));
+ DCCTimer::getSimulatedMacAddress(mac);
+ DIAG(F("Ethernet got MAC address"));
+ #ifdef IP_ADDRESS
+ if (Ethernet.begin(IP_ADDRESS) == 0)
+ #else
+ if (Ethernet.begin(mac, IP_ADDRESS) == 0)
+ #endif
+ {
+ DIAG(F("Ethernet.begin FAILED"));
+ return;
+ }
+
if (Ethernet.hardwareStatus() == EthernetNoHardware) {
DIAG(F("Ethernet shield not found or W5100"));
}
-
- unsigned long startmilli = millis();
+#endif
+
+ uint32_t startmilli = millis();
while ((millis() - startmilli) < 5500) { // Loop to give time to check for cable connection
if (Ethernet.linkStatus() == LinkON)
break;
@@ -171,17 +198,25 @@ void EthernetInterface::loop2() {
return;
}
// get client from the server
+ #if defined (STM32_ETHERNET)
+ // STM32Ethernet doesn't use accept(), just available()
+ EthernetClient client = server->available();
+ #else
EthernetClient client = server->accept();
-
+ #endif
// check for new client
if (client)
{
- if (Diag::ETHERNET) DIAG(F("Ethernet: New client "));
byte socket;
for (socket = 0; socket < MAX_SOCK_NUM; socket++)
{
- if (!clients[socket])
+ if (clients[socket]) {
+ if (clients[socket] == client)
+ break;
+ }
+ else //if (!clients[socket])
{
+ if (Diag::ETHERNET) DIAG(F("Ethernet: New client "));
// On accept() the EthernetServer doesn't track the client anymore
// so we store it in our client array
if (Diag::ETHERNET) DIAG(F("Socket %d"),socket);
diff --git a/EthernetInterface.h b/EthernetInterface.h
index 8078c3f..f4f18dd 100644
--- a/EthernetInterface.h
+++ b/EthernetInterface.h
@@ -35,8 +35,18 @@
#if defined (ARDUINO_TEENSY41)
#include //TEENSY Ethernet Treiber
#include
+ #define MAX_SOCK_NUM 4
+#elif defined (ARDUINO_NUCLEO_F429ZI) || defined (ARDUINO_NUCLEO_F439ZI)
+ #include
+// #include "STM32lwipopts.h"
+ #include
+ #include
+ extern "C" struct netif gnetif;
+ #define STM32_ETHERNET
+ #define MAX_SOCK_NUM 10
#else
#include "Ethernet.h"
+ #define MAX_SOCK_NUM 4
#endif
#include "RingStream.h"
diff --git a/platformio.ini b/platformio.ini
index 8767ef1..e1ddfb5 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -245,7 +245,23 @@ monitor_echo = yes
; Experimental - Ethernet work still in progress
;
-; [env:Nucleo-F429ZI]
+[env:Nucleo-F429ZI]
+platform = ststm32
+board = nucleo_f429zi
+framework = arduino
+lib_deps = ${env.lib_deps}
+ arduino-libraries/Ethernet @ ^2.0.1
+ stm32duino/STM32Ethernet @ ^1.3.0
+ stm32duino/STM32duino LwIP @ ^2.1.2
+build_flags = -std=c++17 -Os -g2 -Wunused-variable
+monitor_speed = 115200
+monitor_echo = yes
+upload_protocol = stlink
+
+; Experimental - Ethernet work still in progress
+; Commented out as the F439ZI also needs variant files
+;
+; [env:Nucleo-F439ZI]
; platform = ststm32
; board = nucleo_f429zi
; framework = arduino
diff --git a/version.h b/version.h
index 4daafba..3c98c21 100644
--- a/version.h
+++ b/version.h
@@ -3,7 +3,8 @@
#include "StringFormatter.h"
-#define VERSION "5.1.17"
+#define VERSION "5.1.17eth"
+// 5.1.17e - Initial ethernet code for STM32F429ZI and F439ZI boards
// 5.1.17 - Divide out C for config and D for diag commands
// 5.1.16 - Remove I2C address from EXTT_TURNTABLE macro to work with MUX, requires separate HAL macro to create
// 5.1.15 - LCC/Adapter support and Exrail feature-compile-out.
From 9437945745bcf5c861eb6df2c67d9cf8a45e1e5b Mon Sep 17 00:00:00 2001
From: pmantoine
Date: Sun, 29 Oct 2023 17:34:51 +0800
Subject: [PATCH 05/44] STM32F439ZI updates
---
DCCTimerSTM32.cpp | 2 +-
I2CManager_STM32.h | 3 ++-
platformio.ini | 24 ++++++++++++------------
3 files changed, 15 insertions(+), 14 deletions(-)
diff --git a/DCCTimerSTM32.cpp b/DCCTimerSTM32.cpp
index f2d51ff..13694aa 100644
--- a/DCCTimerSTM32.cpp
+++ b/DCCTimerSTM32.cpp
@@ -52,7 +52,7 @@ HardwareSerial Serial6(PA12, PA11); // Rx=PA12, Tx=PA11 -- CN10 pins 12 and 14
HardwareSerial Serial3(PC11, PC10); // Rx=PC11, Tx=PC10 -- USART3 - F446RE
HardwareSerial Serial5(PD2, PC12); // Rx=PC7, Tx=PC6 -- UART5 - F446RE
// On the F446RE, Serial4 and Serial6 also use pins we can't readily map while using the Arduino pins
-#elif defined(ARDUINO_NUCLEO_F412ZG) || defined(ARDUINO_NUCLEO_F413ZH) || defined(ARDUINO_NUCLEO_F429ZI) || defined(ARDUINO_NUCLEO_F446ZE)
+#elif defined(ARDUINO_NUCLEO_F412ZG) || defined(ARDUINO_NUCLEO_F413ZH) || defined(ARDUINO_NUCLEO_F429ZI) || defined(ARDUINO_NUCLEO_F439ZI) || defined(ARDUINO_NUCLEO_F446ZE)
// Nucleo-144 boards don't have Serial1 defined by default
HardwareSerial Serial6(PG9, PG14); // Rx=PG9, Tx=PG14 -- USART6
// Serial3 is defined to use USART3 by default, but is in fact used as the diag console
diff --git a/I2CManager_STM32.h b/I2CManager_STM32.h
index 7e0f547..f386959 100644
--- a/I2CManager_STM32.h
+++ b/I2CManager_STM32.h
@@ -39,7 +39,8 @@
#if defined(I2C_USE_INTERRUPTS) && defined(ARDUINO_ARCH_STM32)
#if defined(ARDUINO_NUCLEO_F401RE) || defined(ARDUINO_NUCLEO_F411RE) || defined(ARDUINO_NUCLEO_F446RE) \
|| defined(ARDUINO_NUCLEO_F412ZG) || defined(ARDUINO_NUCLEO_F413ZH) \
- || defined(ARDUINO_NUCLEO_F429ZI) || defined(ARDUINO_NUCLEO_F446ZE)
+ || defined(ARDUINO_NUCLEO_F429ZI) || defined(ARDUINO_NUCLEO_F439ZI) \
+ || defined(ARDUINO_NUCLEO_F446ZE)
// Assume I2C1 for now - default I2C bus on Nucleo-F411RE and likely all Nucleo-64
// and Nucleo-144 variants
I2C_TypeDef *s = I2C1;
diff --git a/platformio.ini b/platformio.ini
index e1ddfb5..f13d4f5 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -261,18 +261,18 @@ upload_protocol = stlink
; Experimental - Ethernet work still in progress
; Commented out as the F439ZI also needs variant files
;
-; [env:Nucleo-F439ZI]
-; platform = ststm32
-; board = nucleo_f429zi
-; framework = arduino
-; lib_deps = ${env.lib_deps}
-; arduino-libraries/Ethernet @ ^2.0.1
-; stm32duino/STM32Ethernet @ ^1.3.0
-; stm32duino/STM32duino LwIP @ ^2.1.2
-; build_flags = -std=c++17 -Os -g2 -Wunused-variable
-; monitor_speed = 115200
-; monitor_echo = yes
-; upload_protocol = stlink
+[env:Nucleo-F439ZI]
+platform = ststm32
+board = nucleo_f429zi
+framework = arduino
+lib_deps = ${env.lib_deps}
+ arduino-libraries/Ethernet @ ^2.0.1
+ stm32duino/STM32Ethernet @ ^1.3.0
+ stm32duino/STM32duino LwIP @ ^2.1.2
+build_flags = -std=c++17 -Os -g2 -Wunused-variable
+monitor_speed = 115200
+monitor_echo = yes
+upload_protocol = stlink
[env:Teensy3_2]
platform = teensy
From 645c9f9f893b71b06e6caf263769ba94d08d0087 Mon Sep 17 00:00:00 2001
From: pmantoine
Date: Sun, 29 Oct 2023 17:39:12 +0800
Subject: [PATCH 06/44] STM32 Use UID_BASE to get MAC address
---
DCCTimerSTM32.cpp | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/DCCTimerSTM32.cpp b/DCCTimerSTM32.cpp
index 13694aa..17d4b44 100644
--- a/DCCTimerSTM32.cpp
+++ b/DCCTimerSTM32.cpp
@@ -215,9 +215,9 @@ void DCCTimer::clearPWM() {
}
void DCCTimer::getSimulatedMacAddress(byte mac[6]) {
- volatile uint32_t *serno1 = (volatile uint32_t *)0x1FFF7A10;
- volatile uint32_t *serno2 = (volatile uint32_t *)0x1FFF7A14;
- // volatile uint32_t *serno3 = (volatile uint32_t *)0x1FFF7A18;
+ volatile uint32_t *serno1 = (volatile uint32_t *)UID_BASE;
+ volatile uint32_t *serno2 = (volatile uint32_t *)UID_BASE+4;
+ // volatile uint32_t *serno3 = (volatile uint32_t *)UID_BASE+8;
volatile uint32_t m1 = *serno1;
volatile uint32_t m2 = *serno2;
From 22b066c40044e6ad13c237f6044ff69725744227 Mon Sep 17 00:00:00 2001
From: kempe63 <78020007+kempe63@users.noreply.github.com>
Date: Sun, 5 Nov 2023 15:57:58 +0000
Subject: [PATCH 07/44] Initial submit I2CDFPlayer
---
I2CManager.cpp | 5 +-
IODevice.h | 3 +-
IO_I2CDFPlayer.h | 589 +++++++++++++++++++++++++++++++++++++++++++++++
IO_Template.h | 69 ++++++
4 files changed, 664 insertions(+), 2 deletions(-)
create mode 100644 IO_I2CDFPlayer.h
create mode 100644 IO_Template.h
diff --git a/I2CManager.cpp b/I2CManager.cpp
index 1d1387e..fadf8bb 100644
--- a/I2CManager.cpp
+++ b/I2CManager.cpp
@@ -54,6 +54,8 @@ static const FSH * guessI2CDeviceType(uint8_t address) {
return F("Time-of-flight sensor");
else if (address >= 0x3c && address <= 0x3d)
return F("OLED Display");
+ else if (address >= 0x48 && address <= 0x57) // Henkk: Added SC16IS752 UART detection
+ return F("SC16IS752 UART");
else if (address >= 0x48 && address <= 0x4f)
return F("Analogue Inputs or PWM");
else if (address >= 0x40 && address <= 0x4f)
@@ -64,6 +66,7 @@ static const FSH * guessI2CDeviceType(uint8_t address) {
return F("Real-time clock");
else if (address >= 0x70 && address <= 0x77)
return F("I2C Mux");
+ else if (address >= 0x90 && address <= 0xAE);
else
return F("?");
}
@@ -363,4 +366,4 @@ void I2CAddress::toHex(const uint8_t value, char *buffer) {
/* static */ bool I2CAddress::_addressWarningDone = false;
-#endif
\ No newline at end of file
+#endif
diff --git a/IODevice.h b/IODevice.h
index 74fe49b..4a2fc48 100644
--- a/IODevice.h
+++ b/IODevice.h
@@ -22,7 +22,8 @@
#define iodevice_h
// Define symbol DIAG_IO to enable diagnostic output
-//#define DIAG_IO Y
+//#define DIAG_IO
+
// Define symbol DIAG_LOOPTIMES to enable CS loop execution time to be reported
//#define DIAG_LOOPTIMES
diff --git a/IO_I2CDFPlayer.h b/IO_I2CDFPlayer.h
new file mode 100644
index 0000000..d4905a5
--- /dev/null
+++ b/IO_I2CDFPlayer.h
@@ -0,0 +1,589 @@
+/*
+ * © 2023, 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 .
+ */
+
+/*
+ * DFPlayer is an MP3 player module with an SD card holder. It also has an integrated
+ * amplifier, so it only needs a power supply and a speaker.
+ *
+ * This driver allows the device to be controlled through IODevice::write() and
+ * IODevice::writeAnalogue() calls.
+ *
+ * The driver is configured as follows:
+ *
+ * DFPlayer::create(firstVpin, nPins, Serialn);
+ *
+ * Where firstVpin is the first vpin reserved for reading the device,
+ * nPins is the number of pins to be allocated (max 5)
+ * and Serialn is the name of the Serial port connected to the DFPlayer (e.g. Serial1).
+ *
+ * Example:
+ * In halSetup function within myHal.cpp:
+ * DFPlayer::create(3500, 5, Serial1);
+ * or in myAutomation.h:
+ * HAL(DFPlayer, 3500, 5, Serial1)
+ *
+ * Writing an analogue value 1-2999 to the first pin (3500) will play the numbered file from the
+ * SD card; e.g. a value of 1 will play the first file, 2 for the second file etc.
+ * Writing an analogue value 0 to the first pin (3500) will stop the file playing;
+ * Writing an analogue value 0-30 to the second pin (3501) will set the volume;
+ * Writing a digital value of 1 to a pin will play the file corresponding to that pin, e.g.
+ the first file will be played by setting pin 3500, the second by setting pin 3501 etc.;
+ * Writing a digital value of 0 to any pin will stop the player;
+ * Reading a digital value from any pin will return true(1) if the player is playing, false(0) otherwise.
+ *
+ * From EX-RAIL, the following commands may be used:
+ * SET(3500) -- starts playing the first file (file 1) on the SD card
+ * SET(3501) -- starts playing the second file (file 2) on the SD card
+ * etc.
+ * RESET(3500) -- stops all playing on the player
+ * WAITFOR(3500) -- wait for the file currently being played by the player to complete
+ * SERVO(3500,2,Instant) -- plays file 2 at current volume
+ * SERVO(3501,20,Instant) -- Sets the volume to 20
+ *
+ * NB The DFPlayer's serial lines are not 5V safe, so connecting the Arduino TX directly
+ * to the DFPlayer's RX terminal will cause lots of noise over the speaker, or worse.
+ * A 1k resistor in series with the module's RX terminal will alleviate this.
+ *
+ * Files on the SD card are numbered according to their order in the directory on the
+ * card (as listed by the DIR command in Windows). This may not match the order of the files
+ * as displayed by Windows File Manager, which sorts the file names. It is suggested that
+ * files be copied into an empty SDcard in the desired order, one at a time.
+ *
+ * The driver now polls the device for its current status every second. Should the device
+ * fail to respond it will be marked off-line and its busy indicator cleared, to avoid
+ * lock-ups in automation scripts that are executing for a WAITFOR().
+ *
+ * *********************************************************************************************
+ * 2023, Added NXP SC16IS752 I2C Dual UART to enable the DFPlayer connection over the I2C bus
+ * The SC16IS752 has 64 bytes TX & RX FIFO buffer
+ * First version without interrupts from I2C UART and only RX/TX are used, interrupts may not be needed as the RX Fifo holds the reply
+ *
+ *
+ */
+
+#ifndef IO_I2CDFPlayer_h
+#define IO_I2CDFPlayer_h
+
+#include "IODevice.h"
+#include "I2CManager.h"
+#include "DIAG.h"
+
+//#define DIAG_I2CDFplayer
+//#define DIAG_I2CDFplayer_data
+//#define DIAG_I2CDFplayer_reg
+
+class I2CDFPlayer : public IODevice {
+private:
+ const uint8_t MAXVOLUME=30;
+ bool _playing = false;
+ uint8_t _inputIndex = 0;
+ unsigned long _commandSendTime; // Time (us) that last transmit took place.
+ unsigned long _timeoutTime;
+ uint8_t _recvCMD; // Last received command code byte
+ bool _awaitingResponse = false;
+ uint8_t _requestedVolumeLevel = MAXVOLUME;
+ uint8_t _currentVolume = MAXVOLUME;
+ int _requestedSong = -1; // -1=none, 0=stop, >0=file number
+ // SC16IS752 defines
+ I2CAddress _I2CAddress;
+ I2CRB _rb;
+ uint8_t _UART_CH;
+ // Communication parameters for the DFPlayer are fixed at 8 bit, No parity, 1 stopbit
+ uint8_t WORD_LEN = 0x03; // Value LCR bit 0,1
+ uint8_t STOP_BIT = 0x00; // Value LCR bit 2
+ uint8_t PARITY_ENA = 0x00; // Value LCR bit 3
+ uint8_t PARITY_TYPE = 0x00; // Value LCR bit 4
+ uint32_t BAUD_RATE = 9600;
+ uint8_t PRESCALER = 0x01; // Value MCR bit 7
+ uint8_t TEMP_REG_VAL = 0x00;
+ uint8_t FIFO_RX_LEVEL = 0x00;
+ uint8_t FIFO_TX_LEVEL = 0x00;
+ uint8_t _outbuffer [11]; // DFPlayer command is 10 bytes + 1 byte register address & UART channel
+ uint8_t _inbuffer[10]; // expected DFPlayer return 10 bytes
+
+ unsigned long SC16IS752_XTAL_FREQ = 1843200; // May need to change xtal frequency to 14.7456Mhz (14745600) to allow for higher baud rates
+ //unsigned long SC16IS752_XTAL_FREQ = 14745600; // Support for higher baud rates
+
+public:
+ // Constructor
+ I2CDFPlayer(VPIN firstVpin, int nPins, I2CAddress i2cAddress, uint8_t UART_CH){
+ _firstVpin = firstVpin;
+ _nPins = nPins;
+ _I2CAddress = i2cAddress;
+ _UART_CH = UART_CH;
+ addDevice(this);
+
+ }
+
+
+public:
+ static void create(VPIN firstVpin, int nPins, I2CAddress i2cAddress, uint8_t UART_CH) {
+ if (checkNoOverlap(firstVpin, nPins, i2cAddress)) new I2CDFPlayer(firstVpin, nPins, i2cAddress, UART_CH);
+ }
+
+ void _begin() override {
+ // check if SC16IS752 exist first, initialize and then resume DFPlayer init via SC16IS752
+ I2CManager.begin();
+ //I2CManager.setClock(1000000);
+ if (I2CManager.exists(_I2CAddress)){
+ DIAG(F("SC16IS752 I2C:%s UART detected"), _I2CAddress.toString());
+ Init_SC16IS752(); // Initialize UART
+ if (_deviceState == DEVSTATE_FAILED){
+ DIAG(F("SC16IS752 I2C:%s UART initialization failed"), _I2CAddress.toString());
+ }
+ } else {
+ DIAG(F("SC16IS752 I2C:%s UART not detected"), _I2CAddress.toString());
+ }
+ #if defined(DIAG_IO)
+ _display();
+ #endif
+ // Now init DFPlayer
+ // Send a query to the device to see if it responds
+ _deviceState = DEVSTATE_INITIALISING;
+ sendPacket(0x42);
+ _timeoutTime = micros() + 5000000UL; // 5 second timeout
+ //_timeoutTime = micros() + 10000000UL; // 5 second timeout
+ _awaitingResponse = true;
+ }
+
+
+ void _loop(unsigned long currentMicros) override {
+ // Read responses from device
+
+ processIncoming();
+ // Check if a command sent to device has timed out. Allow 0.5 second for response
+ if (_awaitingResponse && (int32_t)(currentMicros - _timeoutTime) > 0) {
+ DIAG(F("I2CDFPlayer:%s, DFPlayer not responding on UART channel: 0x%x"), _I2CAddress.toString(), _UART_CH);
+ _deviceState = DEVSTATE_FAILED;
+ _awaitingResponse = false;
+ _playing = false;
+ }
+
+ // Send any commands that need to go.
+ processOutgoing(currentMicros);
+ delayUntil(currentMicros + 10000); // Only enter every 10ms
+ }
+
+
+ // Check for incoming data on _serial, and update busy flag and other state accordingly
+
+ void processIncoming() {
+ // Expected message is in the form "7E FF 06 3D xx xx xx xx xx EF"
+ RX_fifo_lvl();
+ if (FIFO_RX_LEVEL >= 10) {
+ #ifdef DIAG_I2CDFplayer
+ DIAG(F("I2CDFPlayer: %s Retrieving data from RX Fifo on UART_CH: 0x%x"),_I2CAddress.toString(), _UART_CH);
+ #endif
+ ReceiveI2CData();
+ } else {
+ return; // No data or not enough data in rx fifo, check again next time around
+ }
+
+ bool ok = false;
+ while (FIFO_RX_LEVEL != 0) {
+ int c = _inbuffer[_inputIndex]; // Start at 0, increment to FIFO_RX_LEVEL
+ switch (_inputIndex) {
+ case 0:
+ if (c == 0x7E) ok = true;
+ break;
+ case 1:
+ if (c == 0xFF) ok = true;
+ break;
+ case 2:
+ if (c== 0x06) ok = true;
+ break;
+ case 3:
+ _recvCMD = c; // CMD byte
+ ok = true;
+ break;
+ case 6:
+ switch (_recvCMD) {
+ case 0x42:
+ // Response to status query
+ _playing = (c != 0);
+ // Mark the device online and cancel timeout
+ if (_deviceState==DEVSTATE_INITIALISING) {
+ _deviceState = DEVSTATE_NORMAL;
+ #ifdef DIAG_I2CDFplayer
+ DIAG(F("I2CDFPlayer: %s, UART_CH: 0x0%x, _deviceState: 0x0%x"),_I2CAddress.toString(), _UART_CH, _deviceState);
+ #endif
+ #ifdef DIAG_IO
+ _display();
+ #endif
+ }
+ _awaitingResponse = false;
+ break;
+ case 0x3d:
+ // End of play
+ if (_playing) {
+ #ifdef DIAG_IO
+ DIAG(F("I2CDFPlayer: Finished"));
+ #endif
+ _playing = false;
+ }
+ break;
+ case 0x40:
+ // Error codes; 1: Module Busy
+ DIAG(F("I2CDFPlayer: Error %d returned from device"), c);
+ _playing = false;
+ break;
+ }
+ ok = true;
+ break;
+ case 4: case 5: case 7: case 8:
+ ok = true; // Skip over these bytes in message.
+ break;
+ case 9:
+ if (c==0xef) {
+ // Message finished
+ }
+ break;
+ default:
+ break;
+ }
+ if (ok){
+ _inputIndex++; // character as expected, so increment index
+ FIFO_RX_LEVEL --; // Decrease FIFO_RX_LEVEL with each character read from _inbuffer[_inputIndex]
+ } else {
+ _inputIndex = 0; // otherwise reset.
+ FIFO_RX_LEVEL = 0;
+ }
+ }
+ }
+
+ // Send any commands that need to be sent
+ void processOutgoing(unsigned long currentMicros) {
+ // When two commands are sent in quick succession, the device will often fail to
+ // execute one. Testing has indicated that a delay of 100ms or more is required
+ // between successive commands to get reliable operation.
+ // If 100ms has elapsed since the last thing sent, then check if there's some output to do.
+ if (((int32_t)currentMicros - _commandSendTime) > 100000) {
+ if (_currentVolume > _requestedVolumeLevel) {
+ // Change volume before changing song if volume is reducing.
+ _currentVolume = _requestedVolumeLevel;
+ sendPacket(0x06, _currentVolume);
+ } else if (_requestedSong > 0) {
+ // Change song
+ sendPacket(0x03, _requestedSong);
+ _requestedSong = -1;
+ } else if (_requestedSong == 0) {
+ sendPacket(0x16); // Stop playing
+ _requestedSong = -1;
+ } else if (_currentVolume < _requestedVolumeLevel) {
+ // Change volume after changing song if volume is increasing.
+ _currentVolume = _requestedVolumeLevel;
+ sendPacket(0x06, _currentVolume);
+ } else if ((int32_t)currentMicros - _commandSendTime > 1000000) {
+ // Poll device every second that other commands aren't being sent,
+ // to check if it's still connected and responding.
+ sendPacket(0x42);
+ if (!_awaitingResponse) {
+ _timeoutTime = currentMicros + 5000000UL; // Timeout if no response within 5 seconds
+ _awaitingResponse = true;
+ }
+ }
+ }
+ }
+
+ // Write with value 1 starts playing a song. The relative pin number is the file number.
+ // Write with value 0 stops playing.
+ void _write(VPIN vpin, int value) override {
+ if (_deviceState == DEVSTATE_FAILED) return;
+ int pin = vpin - _firstVpin;
+ if (value) {
+ // Value 1, start playing
+ #ifdef DIAG_IO
+ DIAG(F("I2CDFPlayer: Play %d"), pin+1);
+ #endif
+ _requestedSong = pin+1;
+ _playing = true;
+ } else {
+ // Value 0, stop playing
+ #ifdef DIAG_IO
+ DIAG(F("I2CDFPlayer: Stop"));
+ #endif
+ _requestedSong = 0; // No song
+ _playing = false;
+ }
+ }
+
+ // WriteAnalogue on first pin uses the nominated value as a file number to start playing, if file number > 0.
+ // Volume may be specified as second parameter to writeAnalogue.
+ // If value is zero, the player stops playing.
+ // WriteAnalogue on second pin sets the output volume.
+ //
+ void _writeAnalogue(VPIN vpin, int value, uint8_t volume=0, uint16_t=0) override {
+ if (_deviceState == DEVSTATE_FAILED) return;
+ uint8_t pin = vpin - _firstVpin;
+
+ #ifdef DIAG_IO
+ DIAG(F("I2CDFPlayer: VPIN:%u FileNo:%d Volume:%d"), vpin, value, volume);
+ #endif
+
+ // Validate parameter.
+ if (volume > MAXVOLUME) volume = MAXVOLUME;
+
+ if (pin == 0) {
+ // Play track
+ if (value > 0) {
+ if (volume > 0)
+ _requestedVolumeLevel = volume;
+ _requestedSong = value;
+ _playing = true;
+ } else {
+ _requestedSong = 0; // stop playing
+ _playing = false;
+ }
+ } else if (pin == 1) {
+ // Set volume (0-30)
+ _requestedVolumeLevel = value;
+ }
+ }
+
+ // A read on any pin indicates whether the player is still playing.
+ int _read(VPIN) override {
+ if (_deviceState == DEVSTATE_FAILED) return false;
+ return _playing;
+ }
+
+ void _display() override {
+ DIAG(F("I2CDFPlayer Configured on Vpins:%u-%u %S"), _firstVpin, _firstVpin+_nPins-1,
+ (_deviceState==DEVSTATE_FAILED) ? F("OFFLINE") : F(""));
+ }
+
+private:
+ // 7E FF 06 0F 00 01 01 xx xx EF
+ // 0 -> 7E is start code
+ // 1 -> FF is version
+ // 2 -> 06 is length
+ // 3 -> 0F is command
+ // 4 -> 00 is no receive
+ // 5~6 -> 01 01 is argument
+ // 7~8 -> checksum = 0 - ( FF+06+0F+00+01+01 )
+ // 9 -> EF is end code
+
+ void sendPacket(uint8_t command, uint16_t arg = 0)
+ {
+ FIFO_TX_LEVEL = 0; // Reset FIFO_TX_LEVEL
+ uint8_t out[] = {
+ 0x7E,
+ 0xFF,
+ 06,
+ command,
+ 00,
+ static_cast(arg >> 8),
+ static_cast(arg & 0x00ff),
+ 00,
+ 00,
+ 0xEF };
+
+ setChecksum(out);
+
+ // Prepend the DFPlayer command with REG address and UART Channel in _outbuffer
+ _outbuffer[0] = REG_THR << 3 | _UART_CH << 1; //TX FIFO and UART Channel
+ for ( int i = 1; i < sizeof(out)+1 ; i++){
+ _outbuffer[i] = out[i-1];
+ }
+
+ #ifdef DIAG_I2CDFplayer_data
+ DIAG(F("SC16IS752: I2C: %s Sent packet function"), _I2CAddress.toString());
+ for (int i = 0; i < sizeof _outbuffer; i++){
+ DIAG(F("SC16IS752: Data _outbuffer[0x%x]: 0x%x"), i, _outbuffer[i]);
+ }
+ #endif
+
+ TX_fifo_lvl();
+ if(FIFO_TX_LEVEL > 0){ //FIFO is empty
+ //I2CManager.write(_I2CAddress, _outbuffer, sizeof(_outbuffer), &_rb);
+ I2CManager.write(_I2CAddress, _outbuffer, sizeof(_outbuffer));
+ #ifdef DIAG_I2CDFplayer
+ DIAG(F("SC16IS752: I2C: %s data transmit complete on UART: 0x%x"), _I2CAddress.toString(), _UART_CH);
+ #endif
+ } else {
+ DIAG(F("I2CDFPlayer at: %s, TX FIFO not empty on UART: 0x%x"), _I2CAddress.toString(), _UART_CH);
+ _deviceState = DEVSTATE_FAILED; // This should not happen
+ }
+ _commandSendTime = micros();
+ }
+
+ uint16_t calcChecksum(uint8_t* packet)
+ {
+ uint16_t sum = 0;
+ for (int i = 1; i < 7; i++)
+ {
+ sum += packet[i];
+ }
+ return -sum;
+ }
+
+ void setChecksum(uint8_t* out)
+ {
+ uint16_t sum = calcChecksum(out);
+
+ out[7] = (sum >> 8);
+ out[8] = (sum & 0xff);
+ }
+
+ // SC16IS752 functions
+ // Initialise SC16IS752 only for this channel
+ // First a software reset
+ // Enable FIFO and clear TX & RX FIFO
+ // Need to set the following registers
+ // LCR bit 7=0 divisor latch (clock division registers DLH & DLL, they store 16 bit divisor),
+ // WORD_LEN, STOP_BIT, PARITY_ENA and PARITY_TYPE
+ // MCR bit 7=0 clock divisor devide-by-1 clock input
+ // DLH most significant part of divisor
+ // DLL least significant part of divisor
+ //
+ // BAUD_RATE, WORD_LEN, STOP_BIT, PARITY_ENA and PARITY_TYPE have been defined and initialized
+ //
+ void Init_SC16IS752(){ // Return value is in _deviceState
+ #ifdef DIAG_I2CDFplayer
+ DIAG(F("SC16IS752: Initialize I2C: %s , UART Ch: 0x%x"), _I2CAddress.toString(), _UART_CH);
+ #endif
+ uint16_t _divisor = (SC16IS752_XTAL_FREQ / PRESCALER) / (BAUD_RATE * 16);
+ TEMP_REG_VAL = 0x08; // UART Software reset
+ UART_WriteRegister(REG_IOCONTROL, TEMP_REG_VAL);
+ TEMP_REG_VAL = 0x07; // Reset FIFO, clear RX & TX FIFO
+ UART_WriteRegister(REG_FCR, TEMP_REG_VAL);
+ TEMP_REG_VAL = 0x00; // Set MCR to all 0, includes Clock divisor
+ UART_WriteRegister(REG_MCR, TEMP_REG_VAL);
+ TEMP_REG_VAL = 0x80 | WORD_LEN | STOP_BIT | PARITY_ENA | PARITY_TYPE;
+ UART_WriteRegister(REG_LCR, TEMP_REG_VAL); // Divisor latch enabled
+ UART_WriteRegister(REG_DLL, (uint8_t)_divisor); // Write DLL
+ UART_WriteRegister(REG_DLH, (uint8_t)(_divisor >> 8)); // Write DLH
+ UART_ReadRegister(REG_LCR);
+ TEMP_REG_VAL = _inbuffer[0] & 0x7F; // Disable Divisor latch enabled bit
+ UART_WriteRegister(REG_LCR, TEMP_REG_VAL); // Divisor latch disabled
+
+ uint8_t status = _rb.wait();
+ if (status != I2C_STATUS_OK) {
+ DIAG(F("SC16IS752: I2C: %s failed %S"), _I2CAddress.toString(), I2CManager.getErrorMessage(status));
+ _deviceState = DEVSTATE_FAILED;
+ } else {
+ #ifdef DIAG_IO
+ DIAG(F("SC16IS752: I2C: %s, _deviceState == I2C_STATUS_OK"), _I2CAddress.toString());
+ #endif
+ _deviceState = DEVSTATE_NORMAL; // If I2C state is OK, then proceed to initialize DFPlayer
+ }
+ }
+
+
+ // Read the Receive FIFO Level register (RXLVL), return a single unsigned integer
+ // of nr of characters in the RX FIFO, bit 6:0, 7 not used, set to zero
+ // value from 0 (0x00) to 64 (0x40) Only display if RX FIFO has data
+ void RX_fifo_lvl(){
+ UART_ReadRegister(REG_RXLV);
+ FIFO_RX_LEVEL = _inbuffer[0];
+ #ifdef DIAG_I2CDFplayer
+ if (FIFO_RX_LEVEL > 0){
+ DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, RX FIFO Level: 0d%d"), _I2CAddress.toString(), _UART_CH, _inbuffer[0]);
+ }
+ #endif
+ }
+
+ // Read the Tranmit FIFO Level register (TXLVL), return a single unsigned integer
+ // of nr characters free in the TX FIFO, bit 6:0, 7 not used, set to zero
+ // value from 0 (0x00) to 64 (0x40)
+ //
+ void TX_fifo_lvl(){
+ UART_ReadRegister(REG_TXLV);
+ FIFO_TX_LEVEL = _inbuffer[0];
+ #ifdef DIAG_I2CDFplayer
+ DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, TX FIFO Level: 0d%d"), _I2CAddress.toString(), _UART_CH, FIFO_TX_LEVEL);
+ #endif
+ }
+
+ // Read from RX FIFO, we know the register REG_RHR
+ void ReceiveI2CData(){
+ //_inbuffer[0] = 0x00;
+ _outbuffer[0] = REG_RHR << 3 | _UART_CH << 1;
+ //I2CManager.read(_I2CAddress, _inbuffer, FIFO_RX_LEVEL, _outbuffer, 1, &_rb); // inbuffer[] has the data now
+ I2CManager.read(_I2CAddress, _inbuffer, FIFO_RX_LEVEL, _outbuffer, 1); // _inbuffer[] has the data now
+ #ifdef DIAG_I2CDFplayer_data
+ DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, RX FIFO Data"), _I2CAddress.toString(), _UART_CH);
+ for (int i = 0; i < sizeof _inbuffer; i++){
+ DIAG(F("SC16IS752: Data _inbuffer[0x%x]: 0x%x"), i, _inbuffer[i]);
+ }
+ #endif
+ }
+
+
+
+ //void UART_WriteRegister(I2CAddress _I2CAddress, uint8_t _UART_CH, uint8_t UART_REG, uint8_t Val, I2CRB &_rb){
+ void UART_WriteRegister(uint8_t UART_REG, uint8_t Val){
+ _outbuffer[0] = UART_REG << 3 | _UART_CH << 1;
+ _outbuffer[1] = Val;
+ #ifdef DIAG_I2CDFplayer_reg
+ DIAG(F("SC16IS752: Write register at I2C: %s, UART channel: 0x%x, Register: 0x%x, Data: 0b%b"), _I2CAddress.toString(), _UART_CH, UART_REG, _outbuffer[1]);
+ #endif
+ I2CManager.write(_I2CAddress, _outbuffer, 2);
+ }
+
+
+ void UART_ReadRegister(uint8_t UART_REG){
+ _outbuffer[0] = UART_REG << 3 | _UART_CH << 1; // _outbuffer[0] has now UART_REG and UART_CH
+ I2CManager.read(_I2CAddress, _inbuffer, 1, _outbuffer, 1);
+ // _inbuffer has the REG data
+ #ifdef DIAG_I2CDFplayer_reg
+ DIAG(F("SC16IS752: Read register at I2C: %s, UART channel: 0x%x, Register: 0x%x, Data: 0b%b"), _I2CAddress.toString(), _UART_CH, UART_REG, _inbuffer[0]);
+ #endif
+ }
+
+// SC16IS752 General register set (from the datasheet)
+enum : uint8_t{
+ REG_RHR = 0x00, // FIFO Read
+ REG_THR = 0x00, // FIFO Write
+ REG_IER = 0x01, // Interrupt Enable Register R/W
+ REG_FCR = 0x02, // FIFO Control Register Write
+ REG_IIR = 0x02, // Interrupt Identification Register Read
+ REG_LCR = 0x03, // Line Control Register R/W
+ REG_MCR = 0x04, // Modem Control Register R/W
+ REG_LSR = 0x05, // Line Status Register Read
+ REG_MSR = 0x06, // Modem Status Register Read
+ REG_SPR = 0x07, // Scratchpad Register R/W
+ REG_TCR = 0x06, // Transmission Control Register R/W
+ REG_TLR = 0x07, // Trigger Level Register R/W
+ REG_TXLV = 0x08, // Transmitter FIFO Level register Read
+ REG_RXLV = 0x09, // Receiver FIFO Level register Read
+ REG_IODIR = 0x0A, // Programmable I/O pins Direction register R/W
+ REG_IOSTATE = 0x0B, // Programmable I/O pins State register R/W
+ REG_IOINTENA = 0x0C, // I/O Interrupt Enable register R/W
+ REG_IOCONTROL = 0x0E, // I/O Control register R/W
+ REG_EFCR = 0x0F, // Extra Features Control Register R/W
+ };
+
+// SC16IS752 Special register set
+enum : uint8_t{
+ REG_DLL = 0x00, // Division registers R/W
+ REG_DLH = 0x01, // Division registers R/W
+ };
+
+// SC16IS752 Enhanced regiter set
+enum : uint8_t{
+ REG_EFR = 0X02, // Enhanced Features Register R/W
+ REG_XON1 = 0x04, // R/W
+ REG_XON2 = 0x05, // R/W
+ REG_XOFF1 = 0x06, // R/W
+ REG_XOFF2 = 0x07, // R/W
+ };
+
+};
+
+#endif // IO_I2CDFPlayer_h
diff --git a/IO_Template.h b/IO_Template.h
new file mode 100644
index 0000000..adc545a
--- /dev/null
+++ b/IO_Template.h
@@ -0,0 +1,69 @@
+
+/*
+* Creation - a create() function and constructor are required;
+* Initialisation - a _begin() function is written (optional);
+* Background operations - a _loop() function is written (optional);
+* Operations - you can optionally supply any of _write() (digital) function, _writeAnalogue() function, _read() (digital) function and _readAnalogue() function.
+*
+*
+*
+*
+*
+*
+*/
+
+
+#ifndef IO_MYDEVICE_H
+#define IO_MYDEVICE_H
+
+#include "IODevice.h"
+#include "DIAG.h" // for DIAG calls
+
+class MyDevice: public IODevice {
+public:
+ // Constructor
+ MyDevice(VPIN firstVpin, int nPins) {
+ _firstVpin = firstVpin;
+ _nPins = min(nPins,16);
+ // Other object initialisation here
+ // ...
+ addDevice(this);
+ }
+ static void create(VPIN firstVpin, int nPins, uint8_t i2cAddress) {
+ new MyDevice(firstVpin, nPins);
+ }
+private:
+ void _begin() override {
+ // Initialise device
+ // ...
+ }
+ void _loop(unsigned long currentMicros) override {
+ // Regular operations, e.g. acquire data
+ // ...
+ delayUntil(currentMicros + 10*1000UL); // 10ms till next entry
+ }
+ int _readAnalogue(VPIN vpin) override {
+ // Return acquired data value, e.g.
+ int pin = vpin - _firstVpin;
+ return _value[pin];
+ }
+ int _read(VPIN vpin) override {
+ // Return acquired data value, e.g.
+ int pin = vpin - _firstVpin;
+ return _value[pin];
+ }
+ void write(VPIN vpin, int value) override {
+ // Do something with value , e.g. write to device.
+ // ...
+ }
+ void writeAnalogue(VPIN vpin, int value) override {
+ // Do something with value, e.g. write to device.
+ // ...
+ }
+ void _display() override {
+ DIAG(F("MyDevice Configured on Vpins:%d-%d %S"), _firstVpin, _firstVpin+_nPins-1,
+ _deviceState == DEVSTATE_FAILED ? F("OFFLINE") : F(""));
+ }
+ uint16_t _value[16];
+};
+#endif // IO_MYDEVICE_H
\ No newline at end of file
From 44ce1c0cfa17f6c5b2e3c2b7d6d6f589513b9cc5 Mon Sep 17 00:00:00 2001
From: kempe63 <78020007+kempe63@users.noreply.github.com>
Date: Sun, 12 Nov 2023 12:14:02 +0000
Subject: [PATCH 08/44] Preliminary working version of I2CDFPlayer
Working, need some endurance testing and testing at scale
---
IO_I2CDFPlayer.h | 124 +++++++++++++++++++++++++++--------------------
1 file changed, 71 insertions(+), 53 deletions(-)
diff --git a/IO_I2CDFPlayer.h b/IO_I2CDFPlayer.h
index d4905a5..f0e4c09 100644
--- a/IO_I2CDFPlayer.h
+++ b/IO_I2CDFPlayer.h
@@ -100,6 +100,8 @@ private:
uint8_t _requestedVolumeLevel = MAXVOLUME;
uint8_t _currentVolume = MAXVOLUME;
int _requestedSong = -1; // -1=none, 0=stop, >0=file number
+ uint8_t _repeat;
+ uint8_t _previousCmd = true;
// SC16IS752 defines
I2CAddress _I2CAddress;
I2CRB _rb;
@@ -113,6 +115,7 @@ private:
uint8_t PRESCALER = 0x01; // Value MCR bit 7
uint8_t TEMP_REG_VAL = 0x00;
uint8_t FIFO_RX_LEVEL = 0x00;
+ uint8_t RX_BUFFER = 0x00; // nr of bytes copied into _inbuffer
uint8_t FIFO_TX_LEVEL = 0x00;
uint8_t _outbuffer [11]; // DFPlayer command is 10 bytes + 1 byte register address & UART channel
uint8_t _inbuffer[10]; // expected DFPlayer return 10 bytes
@@ -128,9 +131,7 @@ public:
_I2CAddress = i2cAddress;
_UART_CH = UART_CH;
addDevice(this);
-
}
-
public:
static void create(VPIN firstVpin, int nPins, I2CAddress i2cAddress, uint8_t UART_CH) {
@@ -140,7 +141,7 @@ public:
void _begin() override {
// check if SC16IS752 exist first, initialize and then resume DFPlayer init via SC16IS752
I2CManager.begin();
- //I2CManager.setClock(1000000);
+ I2CManager.setClock(1000000);
if (I2CManager.exists(_I2CAddress)){
DIAG(F("SC16IS752 I2C:%s UART detected"), _I2CAddress.toString());
Init_SC16IS752(); // Initialize UART
@@ -158,45 +159,71 @@ public:
_deviceState = DEVSTATE_INITIALISING;
sendPacket(0x42);
_timeoutTime = micros() + 5000000UL; // 5 second timeout
- //_timeoutTime = micros() + 10000000UL; // 5 second timeout
- _awaitingResponse = true;
+ _awaitingResponse = true;
}
void _loop(unsigned long currentMicros) override {
// Read responses from device
-
- processIncoming();
- // Check if a command sent to device has timed out. Allow 0.5 second for response
- if (_awaitingResponse && (int32_t)(currentMicros - _timeoutTime) > 0) {
- DIAG(F("I2CDFPlayer:%s, DFPlayer not responding on UART channel: 0x%x"), _I2CAddress.toString(), _UART_CH);
- _deviceState = DEVSTATE_FAILED;
- _awaitingResponse = false;
- _playing = false;
+ uint8_t status = _rb.status;
+ if (status == I2C_STATUS_PENDING) return; // Busy, so don't do anything
+ if (status == I2C_STATUS_OK) {
+ processIncoming(currentMicros);
+ // Check if a command sent to device has timed out. Allow 0.5 second for response
+ if (_awaitingResponse && (int32_t)(currentMicros - _timeoutTime) > 0) {
+ DIAG(F("I2CDFPlayer:%s, DFPlayer not responding on UART channel: 0x%x"), _I2CAddress.toString(), _UART_CH);
+ _deviceState = DEVSTATE_FAILED;
+ _awaitingResponse = false;
+ _playing = false;
+ }
}
- // Send any commands that need to go.
- processOutgoing(currentMicros);
- delayUntil(currentMicros + 10000); // Only enter every 10ms
+ status = _rb.status;
+ if (status == I2C_STATUS_PENDING) return; // Busy, try next time
+ if (status == I2C_STATUS_OK) {
+ // Send any commands that need to go.
+ processOutgoing(currentMicros);
+ }
+ delayUntil(currentMicros + 10000); // Only enter every 10ms
}
// Check for incoming data on _serial, and update busy flag and other state accordingly
- void processIncoming() {
+ void processIncoming(unsigned long currentMicros) {
// Expected message is in the form "7E FF 06 3D xx xx xx xx xx EF"
RX_fifo_lvl();
if (FIFO_RX_LEVEL >= 10) {
#ifdef DIAG_I2CDFplayer
- DIAG(F("I2CDFPlayer: %s Retrieving data from RX Fifo on UART_CH: 0x%x"),_I2CAddress.toString(), _UART_CH);
+ DIAG(F("I2CDFPlayer: %s Retrieving data from RX Fifo on UART_CH: 0x%x FIFO_RX_LEVEL: %d"),_I2CAddress.toString(), _UART_CH, FIFO_RX_LEVEL);
#endif
- ReceiveI2CData();
+ _outbuffer[0] = REG_RHR << 3 | _UART_CH << 1;
+ // Only copy 10 bytes from RX FIFO, there maybe additional partial return data after a track is finished playing in the RX FIFO
+ I2CManager.read(_I2CAddress, _inbuffer, 10, _outbuffer, 1); // inbuffer[] has the data now
+ //delayUntil(currentMicros + 10000); // Allow time to get the data
+ RX_BUFFER = 10; // We have copied 10 bytes from RX FIFO to _inbuffer
+ #ifdef DIAG_I2CDFplayer_data
+ DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, RX FIFO Data"), _I2CAddress.toString(), _UART_CH);
+ for (int i = 0; i < sizeof _inbuffer; i++){
+ DIAG(F("SC16IS752: Data _inbuffer[0x%x]: 0x%x"), i, _inbuffer[i]);
+ }
+ #endif
} else {
- return; // No data or not enough data in rx fifo, check again next time around
+ FIFO_RX_LEVEL = 0; //set to 0, we'll read a fresh FIFO_RX_LEVEL next time
+ return; // No data or not enough data in rx fifo, check again next time around
}
+/*
+ #ifdef DIAG_I2CDFplayer
+ if (FIFO_RX_LEVEL > 10) {
+ DIAG(F("I2CDFPlayer: %s FIFO_RX_LEVEL: %d"),_I2CAddress.toString(), FIFO_RX_LEVEL);
+ }
+ #endif
+*/
+
bool ok = false;
- while (FIFO_RX_LEVEL != 0) {
+ //DIAG(F("I2CDFPlayer: RX_BUFFER: %d"), RX_BUFFER);
+ while (RX_BUFFER != 0) {
int c = _inbuffer[_inputIndex]; // Start at 0, increment to FIFO_RX_LEVEL
switch (_inputIndex) {
case 0:
@@ -214,6 +241,7 @@ public:
break;
case 6:
switch (_recvCMD) {
+ DIAG(F("I2CDFPlayer: %s, _recvCMD: 0x%x _awaitingResponse: 0x0%x"),_I2CAddress.toString(), _recvCMD, _awaitingResponse);
case 0x42:
// Response to status query
_playing = (c != 0);
@@ -229,7 +257,7 @@ public:
}
_awaitingResponse = false;
break;
- case 0x3d:
+ case 0x3d:
// End of play
if (_playing) {
#ifdef DIAG_IO
@@ -259,12 +287,13 @@ public:
}
if (ok){
_inputIndex++; // character as expected, so increment index
- FIFO_RX_LEVEL --; // Decrease FIFO_RX_LEVEL with each character read from _inbuffer[_inputIndex]
+ RX_BUFFER --; // Decrease FIFO_RX_LEVEL with each character read from _inbuffer[_inputIndex]
} else {
_inputIndex = 0; // otherwise reset.
- FIFO_RX_LEVEL = 0;
+ RX_BUFFER = 0;
}
}
+ RX_BUFFER = 0; //Set to 0, we'll read a new RX FIFO level again
}
// Send any commands that need to be sent
@@ -273,7 +302,7 @@ public:
// execute one. Testing has indicated that a delay of 100ms or more is required
// between successive commands to get reliable operation.
// If 100ms has elapsed since the last thing sent, then check if there's some output to do.
- if (((int32_t)currentMicros - _commandSendTime) > 100000) {
+ if (((int32_t)currentMicros - _commandSendTime) > 100000) {
if (_currentVolume > _requestedVolumeLevel) {
// Change volume before changing song if volume is reducing.
_currentVolume = _requestedVolumeLevel;
@@ -281,7 +310,7 @@ public:
} else if (_requestedSong > 0) {
// Change song
sendPacket(0x03, _requestedSong);
- _requestedSong = -1;
+ _requestedSong = -1;
} else if (_requestedSong == 0) {
sendPacket(0x16); // Stop playing
_requestedSong = -1;
@@ -298,7 +327,7 @@ public:
_awaitingResponse = true;
}
}
- }
+ }
}
// Write with value 1 starts playing a song. The relative pin number is the file number.
@@ -328,23 +357,27 @@ public:
// If value is zero, the player stops playing.
// WriteAnalogue on second pin sets the output volume.
//
- void _writeAnalogue(VPIN vpin, int value, uint8_t volume=0, uint16_t=0) override {
+ //void _writeAnalogue(VPIN vpin, int value, uint8_t volume=0, uint16_t=0) override {
+ void _writeAnalogue(VPIN vpin, int value, uint8_t volume=0, uint16_t cmd=0) override {
if (_deviceState == DEVSTATE_FAILED) return;
uint8_t pin = vpin - _firstVpin;
-
#ifdef DIAG_IO
- DIAG(F("I2CDFPlayer: VPIN:%u FileNo:%d Volume:%d"), vpin, value, volume);
+ DIAG(F("I2CDFPlayer: VPIN:%u FileNo:%d Volume:%d Repeat:0x0%x"), vpin, value, volume, cmd);
#endif
-
// Validate parameter.
if (volume > MAXVOLUME) volume = MAXVOLUME;
if (pin == 0) {
- // Play track
+ // Play track
if (value > 0) {
if (volume > 0)
_requestedVolumeLevel = volume;
_requestedSong = value;
+ if (cmd = 1){ // check for Repeat playback of song
+ _repeat = true;
+ } else {
+ _repeat = false;
+ }
_playing = true;
} else {
_requestedSong = 0; // stop playing
@@ -410,8 +443,8 @@ private:
TX_fifo_lvl();
if(FIFO_TX_LEVEL > 0){ //FIFO is empty
- //I2CManager.write(_I2CAddress, _outbuffer, sizeof(_outbuffer), &_rb);
- I2CManager.write(_I2CAddress, _outbuffer, sizeof(_outbuffer));
+ I2CManager.write(_I2CAddress, _outbuffer, sizeof(_outbuffer), &_rb);
+ //I2CManager.write(_I2CAddress, _outbuffer, sizeof(_outbuffer));
#ifdef DIAG_I2CDFplayer
DIAG(F("SC16IS752: I2C: %s data transmit complete on UART: 0x%x"), _I2CAddress.toString(), _UART_CH);
#endif
@@ -472,13 +505,13 @@ private:
TEMP_REG_VAL = _inbuffer[0] & 0x7F; // Disable Divisor latch enabled bit
UART_WriteRegister(REG_LCR, TEMP_REG_VAL); // Divisor latch disabled
- uint8_t status = _rb.wait();
+ uint8_t status = _rb.status;
if (status != I2C_STATUS_OK) {
DIAG(F("SC16IS752: I2C: %s failed %S"), _I2CAddress.toString(), I2CManager.getErrorMessage(status));
_deviceState = DEVSTATE_FAILED;
} else {
#ifdef DIAG_IO
- DIAG(F("SC16IS752: I2C: %s, _deviceState == I2C_STATUS_OK"), _I2CAddress.toString());
+ DIAG(F("SC16IS752: I2C: %s, _deviceState: %S"), _I2CAddress.toString(), I2CManager.getErrorMessage(status));
#endif
_deviceState = DEVSTATE_NORMAL; // If I2C state is OK, then proceed to initialize DFPlayer
}
@@ -493,7 +526,7 @@ private:
FIFO_RX_LEVEL = _inbuffer[0];
#ifdef DIAG_I2CDFplayer
if (FIFO_RX_LEVEL > 0){
- DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, RX FIFO Level: 0d%d"), _I2CAddress.toString(), _UART_CH, _inbuffer[0]);
+ // DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, FIFO_RX_LEVEL: 0d%d"), _I2CAddress.toString(), _UART_CH, _inbuffer[0]);
}
#endif
}
@@ -506,25 +539,10 @@ private:
UART_ReadRegister(REG_TXLV);
FIFO_TX_LEVEL = _inbuffer[0];
#ifdef DIAG_I2CDFplayer
- DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, TX FIFO Level: 0d%d"), _I2CAddress.toString(), _UART_CH, FIFO_TX_LEVEL);
+ // DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, FIFO_TX_LEVEL: 0d%d"), _I2CAddress.toString(), _UART_CH, FIFO_TX_LEVEL);
#endif
}
- // Read from RX FIFO, we know the register REG_RHR
- void ReceiveI2CData(){
- //_inbuffer[0] = 0x00;
- _outbuffer[0] = REG_RHR << 3 | _UART_CH << 1;
- //I2CManager.read(_I2CAddress, _inbuffer, FIFO_RX_LEVEL, _outbuffer, 1, &_rb); // inbuffer[] has the data now
- I2CManager.read(_I2CAddress, _inbuffer, FIFO_RX_LEVEL, _outbuffer, 1); // _inbuffer[] has the data now
- #ifdef DIAG_I2CDFplayer_data
- DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, RX FIFO Data"), _I2CAddress.toString(), _UART_CH);
- for (int i = 0; i < sizeof _inbuffer; i++){
- DIAG(F("SC16IS752: Data _inbuffer[0x%x]: 0x%x"), i, _inbuffer[i]);
- }
- #endif
- }
-
-
//void UART_WriteRegister(I2CAddress _I2CAddress, uint8_t _UART_CH, uint8_t UART_REG, uint8_t Val, I2CRB &_rb){
void UART_WriteRegister(uint8_t UART_REG, uint8_t Val){
From 5e0cf8eb74f485f87403fee211ab442b1f097322 Mon Sep 17 00:00:00 2001
From: kempe63 <78020007+kempe63@users.noreply.github.com>
Date: Sun, 12 Nov 2023 20:02:01 +0000
Subject: [PATCH 09/44] Update myHal.cpp_example.txt
Added IO_I2CDFPlayer example
---
myHal.cpp_example.txt | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
diff --git a/myHal.cpp_example.txt b/myHal.cpp_example.txt
index 5533554..6363674 100644
--- a/myHal.cpp_example.txt
+++ b/myHal.cpp_example.txt
@@ -234,6 +234,23 @@ void halSetup() {
// DFPlayer::create(10000, 10, Serial1);
+ //=======================================================================
+ // Play mp3 files from a Micro-SD card, using a DFPlayer MP3 Module on a SC16IS752 I2C Dual UART
+ //=======================================================================
+ // DFPlayer via NXP SC16IS752 I2C Dual UART. Each device has 2 UARTs on a single I2C address
+ // Total nr of devices on an I2C bus is 16, with 2 UARTs on each address making a total of 32 UARTs per I2C bus
+ // I2C address range 0x48 - 0x57
+ // I2CDFPlayer::create(1st vPin,vPins, I2C address, UART ch);
+
+ // I2CDFPlayer::create(10000, 10, 0x48, 0);
+ // I2CDFPlayer::create(10010, 10, 0x48, 1);
+
+ // Multiplexer example
+ // I2CDFPlayer::create(10020, 10, {I2CMux_0, SubBus_0, 0x50}, 0);
+
+
+
+
//=======================================================================
// 16-pad capacitative touch key pad based on TP229 IC.
//=======================================================================
From b8e0185540fd49f4e08a420a9cf5c802ff446447 Mon Sep 17 00:00:00 2001
From: kempe63 <78020007+kempe63@users.noreply.github.com>
Date: Sun, 12 Nov 2023 20:03:41 +0000
Subject: [PATCH 10/44] Update IO_I2CDFPlayer.h
Further tweaks and cleanup
---
IO_I2CDFPlayer.h | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/IO_I2CDFPlayer.h b/IO_I2CDFPlayer.h
index f0e4c09..bc98e17 100644
--- a/IO_I2CDFPlayer.h
+++ b/IO_I2CDFPlayer.h
@@ -120,7 +120,7 @@ private:
uint8_t _outbuffer [11]; // DFPlayer command is 10 bytes + 1 byte register address & UART channel
uint8_t _inbuffer[10]; // expected DFPlayer return 10 bytes
- unsigned long SC16IS752_XTAL_FREQ = 1843200; // May need to change xtal frequency to 14.7456Mhz (14745600) to allow for higher baud rates
+ unsigned long SC16IS752_XTAL_FREQ = 1843200; // May need to change oscillator frequency to 14.7456Mhz (14745600) to allow for higher baud rates
//unsigned long SC16IS752_XTAL_FREQ = 14745600; // Support for higher baud rates
public:
From d703c42d79559d03b5eb967b7aa55eca19cdfd97 Mon Sep 17 00:00:00 2001
From: pmantoine
Date: Thu, 30 Nov 2023 16:16:44 +0800
Subject: [PATCH 11/44] STM32 Ethernet fix lib_deps
---
platformio.ini | 5 +----
1 file changed, 1 insertion(+), 4 deletions(-)
diff --git a/platformio.ini b/platformio.ini
index f13d4f5..93804de 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -30,7 +30,6 @@ include_dir = .
[env]
build_flags = -Wall -Wextra
-; monitor_filters = time
[env:samd21-dev-usb]
platform = atmelsam
@@ -250,7 +249,6 @@ platform = ststm32
board = nucleo_f429zi
framework = arduino
lib_deps = ${env.lib_deps}
- arduino-libraries/Ethernet @ ^2.0.1
stm32duino/STM32Ethernet @ ^1.3.0
stm32duino/STM32duino LwIP @ ^2.1.2
build_flags = -std=c++17 -Os -g2 -Wunused-variable
@@ -263,10 +261,9 @@ upload_protocol = stlink
;
[env:Nucleo-F439ZI]
platform = ststm32
-board = nucleo_f429zi
+board = nucleo_f439zi
framework = arduino
lib_deps = ${env.lib_deps}
- arduino-libraries/Ethernet @ ^2.0.1
stm32duino/STM32Ethernet @ ^1.3.0
stm32duino/STM32duino LwIP @ ^2.1.2
build_flags = -std=c++17 -Os -g2 -Wunused-variable
From 6fab3a5dd531efd458fee4206bf5ae87b21a079a Mon Sep 17 00:00:00 2001
From: Ash-4
Date: Fri, 8 Dec 2023 16:27:15 -0600
Subject: [PATCH 12/44] Nucleo-144b Serial LCD lines
---
I2CManager_STM32.h | 3 +--
WifiInterface.cpp | 5 +++--
2 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/I2CManager_STM32.h b/I2CManager_STM32.h
index f386959..9350d14 100644
--- a/I2CManager_STM32.h
+++ b/I2CManager_STM32.h
@@ -39,8 +39,7 @@
#if defined(I2C_USE_INTERRUPTS) && defined(ARDUINO_ARCH_STM32)
#if defined(ARDUINO_NUCLEO_F401RE) || defined(ARDUINO_NUCLEO_F411RE) || defined(ARDUINO_NUCLEO_F446RE) \
|| defined(ARDUINO_NUCLEO_F412ZG) || defined(ARDUINO_NUCLEO_F413ZH) \
- || defined(ARDUINO_NUCLEO_F429ZI) || defined(ARDUINO_NUCLEO_F439ZI) \
- || defined(ARDUINO_NUCLEO_F446ZE)
+ || defined(ARDUINO_NUCLEO_F429ZI) || defined(ARDUINO_NUCLEO_F439ZI) || defined(ARDUINO_NUCLEO_F446ZE)
// Assume I2C1 for now - default I2C bus on Nucleo-F411RE and likely all Nucleo-64
// and Nucleo-144 variants
I2C_TypeDef *s = I2C1;
diff --git a/WifiInterface.cpp b/WifiInterface.cpp
index 8b2251a..d08ce29 100644
--- a/WifiInterface.cpp
+++ b/WifiInterface.cpp
@@ -68,9 +68,10 @@ Stream * WifiInterface::wifiStream;
#define NUM_SERIAL 3
#define SERIAL1 Serial3
#define SERIAL3 Serial5
-#elif defined(ARDUINO_NUCLEO_F413ZH) || defined(ARDUINO_NUCLEO_F429ZI) || defined(ARDUINO_NUCLEO_F446ZE) || defined(ARDUINO_NUCLEO_F412ZG)
-#define NUM_SERIAL 2
+#elif defined(ARDUINO_NUCLEO_F413ZH) || defined(ARDUINO_NUCLEO_F429ZI) || defined(ARDUINO_NUCLEO_F439ZI) || defined(ARDUINO_NUCLEO_F446ZE) || defined(ARDUINO_NUCLEO_F412ZG)
+#define NUM_SERIAL 3
#define SERIAL1 Serial6
+#define SERIAL3 Serial2
#else
#warning This variant of Nucleo not yet explicitly supported
#endif
From 330a85ec172b5c36db68e2014b51c49813d2eecc Mon Sep 17 00:00:00 2001
From: Ash-4 <81280775+Ash-4@users.noreply.github.com>
Date: Wed, 13 Dec 2023 16:12:03 -0600
Subject: [PATCH 13/44] version updated 5.2.15ethC
---
version.h | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/version.h b/version.h
index b74cbd2..8895dc2 100644
--- a/version.h
+++ b/version.h
@@ -3,9 +3,11 @@
#include "StringFormatter.h"
-#define VERSION "5.2.15"
+#define VERSION "5.2.15ethC"
// 5.2.15 - move call to CommandDistributor::broadcastPower() into the TrackManager::setTrackPower(*) functions
// - add repeats to function packets that are not reminded in accordance with accessory packets
+// 5.2.14eth - Initial ethernet code for STM32F429ZI and F439ZI boards
+// - CMRI RS485 connection
// 5.2.14 - Reminder window DCC packet optimization
// - Optional #define DISABLE_FUNCTION_REMINDERS
// 5.2.13 - EXRAIL STEALTH
From 32ecbbe147b5dc608ded89525ac8fd74d1db0458 Mon Sep 17 00:00:00 2001
From: kempe63 <78020007+kempe63@users.noreply.github.com>
Date: Wed, 27 Dec 2023 17:31:31 +0000
Subject: [PATCH 14/44] Update IO_I2CDFPlayer.h
Implented more DFPlayer commands
---
IO_I2CDFPlayer.h | 223 ++++++++++++++++++++++++++++++++++++++++-------
1 file changed, 192 insertions(+), 31 deletions(-)
diff --git a/IO_I2CDFPlayer.h b/IO_I2CDFPlayer.h
index bc98e17..536dff5 100644
--- a/IO_I2CDFPlayer.h
+++ b/IO_I2CDFPlayer.h
@@ -1,4 +1,4 @@
-/*
+ /*
* © 2023, Neil McKechnie. All rights reserved.
*
* This file is part of DCC++EX API
@@ -87,6 +87,7 @@
//#define DIAG_I2CDFplayer
//#define DIAG_I2CDFplayer_data
//#define DIAG_I2CDFplayer_reg
+#define DIAG_I2CDFplayer_playing
class I2CDFPlayer : public IODevice {
private:
@@ -100,12 +101,13 @@ private:
uint8_t _requestedVolumeLevel = MAXVOLUME;
uint8_t _currentVolume = MAXVOLUME;
int _requestedSong = -1; // -1=none, 0=stop, >0=file number
- uint8_t _repeat;
+ bool _repeat = false; // audio file is repeat playing
uint8_t _previousCmd = true;
// SC16IS752 defines
I2CAddress _I2CAddress;
I2CRB _rb;
uint8_t _UART_CH;
+ uint8_t _audioMixer = 0x00; // Default no audio mixer installed
// Communication parameters for the DFPlayer are fixed at 8 bit, No parity, 1 stopbit
uint8_t WORD_LEN = 0x03; // Value LCR bit 0,1
uint8_t STOP_BIT = 0x00; // Value LCR bit 2
@@ -116,26 +118,43 @@ private:
uint8_t TEMP_REG_VAL = 0x00;
uint8_t FIFO_RX_LEVEL = 0x00;
uint8_t RX_BUFFER = 0x00; // nr of bytes copied into _inbuffer
- uint8_t FIFO_TX_LEVEL = 0x00;
+ uint8_t FIFO_TX_LEVEL = 0x00;
+ //uint8_t DFPlayerValue = NONE; // Values for enhanced commands
+ //uint8_t DFPlayerCmd = NONE; // Enhanced commands
+ bool _playCmd = false;
+ bool _volCmd = false;
+ bool _folderCmd = false;
+ uint8_t _requestedFolder = 0x01; // default to folder 01
+ uint8_t _currentFolder = 0x01; // default to folder 01
+ bool _repeatCmd = false;
+ bool _stopplayCmd = false;
+ bool _resetCmd = false;
+ bool _eqCmd = false;
+ uint8_t _requestedEQValue = NORMAL;
+ uint8_t _currentEQvalue = NORMAL; // start equalizer value
+ bool _daconCmd = false;
+
uint8_t _outbuffer [11]; // DFPlayer command is 10 bytes + 1 byte register address & UART channel
uint8_t _inbuffer[10]; // expected DFPlayer return 10 bytes
+
- unsigned long SC16IS752_XTAL_FREQ = 1843200; // May need to change oscillator frequency to 14.7456Mhz (14745600) to allow for higher baud rates
- //unsigned long SC16IS752_XTAL_FREQ = 14745600; // Support for higher baud rates
+ //unsigned long SC16IS752_XTAL_FREQ = 1843200; // May need to change oscillator frequency to 14.7456Mhz (14745600) to allow for higher baud rates
+ unsigned long SC16IS752_XTAL_FREQ = 14745600; // Support for higher baud rates
public:
// Constructor
- I2CDFPlayer(VPIN firstVpin, int nPins, I2CAddress i2cAddress, uint8_t UART_CH){
+ I2CDFPlayer(VPIN firstVpin, int nPins, I2CAddress i2cAddress, uint8_t UART_CH, uint8_t AM){
_firstVpin = firstVpin;
_nPins = nPins;
_I2CAddress = i2cAddress;
- _UART_CH = UART_CH;
+ _UART_CH = UART_CH;
+ _audioMixer = AM;
addDevice(this);
}
public:
- static void create(VPIN firstVpin, int nPins, I2CAddress i2cAddress, uint8_t UART_CH) {
- if (checkNoOverlap(firstVpin, nPins, i2cAddress)) new I2CDFPlayer(firstVpin, nPins, i2cAddress, UART_CH);
+ static void create(VPIN firstVpin, int nPins, I2CAddress i2cAddress, uint8_t UART_CH, uint8_t AM) {
+ if (checkNoOverlap(firstVpin, nPins, i2cAddress)) new I2CDFPlayer(firstVpin, nPins, i2cAddress, UART_CH, AM);
}
void _begin() override {
@@ -159,7 +178,7 @@ public:
_deviceState = DEVSTATE_INITIALISING;
sendPacket(0x42);
_timeoutTime = micros() + 5000000UL; // 5 second timeout
- _awaitingResponse = true;
+ _awaitingResponse = true;
}
@@ -296,28 +315,75 @@ public:
RX_BUFFER = 0; //Set to 0, we'll read a new RX FIFO level again
}
+ //sendPacket(0x1A,0x00,0x01); //Enable DAC
+
// Send any commands that need to be sent
void processOutgoing(unsigned long currentMicros) {
// When two commands are sent in quick succession, the device will often fail to
// execute one. Testing has indicated that a delay of 100ms or more is required
// between successive commands to get reliable operation.
// If 100ms has elapsed since the last thing sent, then check if there's some output to do.
- if (((int32_t)currentMicros - _commandSendTime) > 100000) {
+ if (((int32_t)currentMicros - _commandSendTime) > 100000) {
if (_currentVolume > _requestedVolumeLevel) {
// Change volume before changing song if volume is reducing.
_currentVolume = _requestedVolumeLevel;
- sendPacket(0x06, _currentVolume);
- } else if (_requestedSong > 0) {
+ sendPacket(0x06, 0x00, _currentVolume);
+ } else if (_playCmd == true) {
// Change song
- sendPacket(0x03, _requestedSong);
- _requestedSong = -1;
- } else if (_requestedSong == 0) {
- sendPacket(0x16); // Stop playing
+ if (_requestedSong != -1) {
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: _requestedVolumeLevel: %u, _requestedSong: %u, _playCmd: 0x%x"), _requestedVolumeLevel, _requestedSong, _playCmd);
+ #endif
+ sendPacket(0x0F, 0x01, _requestedSong); // audio file in folder 01
+ _requestedSong = -1;
+ _playCmd = false;
+ }
+ } //else if (_requestedSong == 0) {
+ else if (_stopplayCmd == true) {
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: Stop playing: _stopplayCmd: 0x%x"), _stopplayCmd);
+ #endif
+ sendPacket(0x16, 0x00, 0x00); // Stop playing
_requestedSong = -1;
+ _repeat = false; // reset repeat
+ _stopplayCmd = false;
+ } else if (_folderCmd == true) {
+ if (_currentFolder != _requestedFolder){
+ _currentFolder = _requestedFolder;
+ }
+ _folderCmd = false;
+ } else if (_repeatCmd == true) {
+ if(_repeat == false) { // No repeat play currently
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: Repeat: _repeatCmd: 0x%x, _requestedSong: %d, _repeat: 0x0%x"), _repeatCmd, _requestedSong, _repeat);
+ #endif
+ sendPacket(0x08, 0x00, _requestedSong); // repeat playing audio file in root folder
+ _requestedSong = -1;
+ _repeat = true;
+ }
+ _repeatCmd= false;
+ } else if (_daconCmd == true) { // Always turn DAC on
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: DACON: _daconCmd: 0x%x"), _daconCmd);
+ #endif
+ sendPacket(0x1A,0,0x00);
+ _daconCmd = false;
+ } else if (_eqCmd == true){ // Set Equalizer, values 0x00 - 0x05
+ if (_currentEQvalue != _requestedEQValue){
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: EQ: _eqCmd: 0x%x, _currentEQvalue: 0x0%x, _requestedEQValue: 0x0%x"), _eqCmd, _currentEQvalue, _requestedEQValue);
+ #endif
+ _currentEQvalue = _requestedEQValue;
+ sendPacket(0x07,0x00,_currentEQvalue);
+ }
+ _eqCmd = false;
+ } else if ( _resetCmd == true){
+ sendPacket(0x0C,0,0);
+ _resetCmd = false;
} else if (_currentVolume < _requestedVolumeLevel) {
// Change volume after changing song if volume is increasing.
_currentVolume = _requestedVolumeLevel;
- sendPacket(0x06, _currentVolume);
+ sendPacket(0x06, 0x00, _currentVolume);
} else if ((int32_t)currentMicros - _commandSendTime > 1000000) {
// Poll device every second that other commands aren't being sent,
// to check if it's still connected and responding.
@@ -357,13 +423,15 @@ public:
// If value is zero, the player stops playing.
// WriteAnalogue on second pin sets the output volume.
//
+ // Currently all WrtiteAnalogue to be done on vpin 2, will move to vpin 0 when fully implemented
+ //
//void _writeAnalogue(VPIN vpin, int value, uint8_t volume=0, uint16_t=0) override {
void _writeAnalogue(VPIN vpin, int value, uint8_t volume=0, uint16_t cmd=0) override {
- if (_deviceState == DEVSTATE_FAILED) return;
- uint8_t pin = vpin - _firstVpin;
+ if (_deviceState == DEVSTATE_FAILED) return;
#ifdef DIAG_IO
- DIAG(F("I2CDFPlayer: VPIN:%u FileNo:%d Volume:%d Repeat:0x0%x"), vpin, value, volume, cmd);
+ DIAG(F("I2CDFPlayer: VPIN:%u FileNo:%d Volume:%d Command:0x%x"), vpin, value, volume, cmd);
#endif
+ uint8_t pin = vpin - _firstVpin;
// Validate parameter.
if (volume > MAXVOLUME) volume = MAXVOLUME;
@@ -372,12 +440,7 @@ public:
if (value > 0) {
if (volume > 0)
_requestedVolumeLevel = volume;
- _requestedSong = value;
- if (cmd = 1){ // check for Repeat playback of song
- _repeat = true;
- } else {
- _repeat = false;
- }
+ _requestedSong = value;
_playing = true;
} else {
_requestedSong = 0; // stop playing
@@ -386,7 +449,75 @@ public:
} else if (pin == 1) {
// Set volume (0-30)
_requestedVolumeLevel = value;
- }
+
+ } else if (pin == 2) { // Enhanced DFPlayer commands
+ // Read command and value
+ switch (cmd){
+ //case NONE:
+ // DFPlayerCmd = cmd;
+ // break;
+ case PLAY:
+ _playCmd = true;
+ //DFPlayerCmd = cmd;
+ _requestedSong = value;
+ _requestedVolumeLevel = volume;
+ _playing = true;
+ break;
+ case VOL:
+ _volCmd = true;
+ //DFPlayerCmd = cmd;
+ _requestedVolumeLevel = volume;
+ break;
+ case FOLDER:
+ _folderCmd = true;
+ if (volume <= 0 && volume > 99){ // Range checking
+ _requestedFolder = 0x01; // if outside range, default to folder 01
+ } else {
+ _requestedFolder = volume;
+ }
+ break;
+ case REPEATPLAY: // Need to check if _repeat == true, if so do nothing
+ if (_repeat == false) {
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: WriteAnalog Repeat: _repeat: 0x0%x, value: %d _repeatCmd: 0x%x"), _repeat, value, _repeatCmd);
+ #endif
+ _repeatCmd = true;
+ _requestedSong = value;
+ _requestedVolumeLevel = volume;
+ _playing = true;
+ }
+ break;
+ case STOPPLAY:
+ _stopplayCmd = true;
+ //DFPlayerCmd = cmd;
+ break;
+ case EQ:
+ //DIAG(F("I2CDFPlayer: WriteAnalog EQ: cmd: 0x%x, EQ value: 0x%x"), cmd, volume);
+ _eqCmd = true;
+ //DFPlayerCmd = cmd;
+ if (volume <= NORMAL) { // to keep backward compatibility the volume parameter is used for values of the EQ cmd
+ _requestedEQValue = NORMAL;
+ //DFPlayerValue = NONE;
+ } else if (volume <= 0x05) { // Validate EQ parameters
+ _requestedEQValue = volume;
+ //DFPlayerValue = volume;
+ }
+ break;
+
+ case RESET:
+ _resetCmd = true;
+ //DFPlayerCmd = cmd;
+ break;
+ case DACON: // Works, but without the DACOFF command limited value, except when not relying on DFPlayer default to turn the DAC on
+ //DIAG(F("I2CDFPlayer: WrtieAnalog DACON: cmd: 0x%x"), cmd);
+ _daconCmd = true;
+ //DFPlayerCmd = 0x1A;
+ //DFPlayerValue = 0x00;
+ break;
+ default:
+ break;
+ }
+ }
}
// A read on any pin indicates whether the player is still playing.
@@ -411,7 +542,8 @@ private:
// 7~8 -> checksum = 0 - ( FF+06+0F+00+01+01 )
// 9 -> EF is end code
- void sendPacket(uint8_t command, uint16_t arg = 0)
+ //void sendPacket(uint8_t command, uint16_t arg = 0)
+ void sendPacket(uint8_t command, uint8_t arg1 = 0, uint8_t arg2 = 0)
{
FIFO_TX_LEVEL = 0; // Reset FIFO_TX_LEVEL
uint8_t out[] = {
@@ -420,8 +552,10 @@ private:
06,
command,
00,
- static_cast(arg >> 8),
- static_cast(arg & 0x00ff),
+ //static_cast(arg >> 8),
+ //static_cast(arg & 0x00ff),
+ arg1,
+ arg2,
00,
00,
0xEF };
@@ -493,6 +627,13 @@ private:
uint16_t _divisor = (SC16IS752_XTAL_FREQ / PRESCALER) / (BAUD_RATE * 16);
TEMP_REG_VAL = 0x08; // UART Software reset
UART_WriteRegister(REG_IOCONTROL, TEMP_REG_VAL);
+ TEMP_REG_VAL = 0x00; // Set pins to GPIO mode
+ UART_WriteRegister(REG_IOCONTROL, TEMP_REG_VAL);
+ TEMP_REG_VAL = 0xFF; //Set all pins as output
+ UART_WriteRegister(REG_IODIR, TEMP_REG_VAL);
+ TEMP_REG_VAL = 0x01; //Set initial value as high
+ //TEMP_REG_VAL = 0x00; //Set initial value as low
+ UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
TEMP_REG_VAL = 0x07; // Reset FIFO, clear RX & TX FIFO
UART_WriteRegister(REG_FCR, TEMP_REG_VAL);
TEMP_REG_VAL = 0x00; // Set MCR to all 0, includes Clock divisor
@@ -602,6 +743,26 @@ enum : uint8_t{
REG_XOFF2 = 0x07, // R/W
};
+// DFPlayer commands and values
+enum : uint8_t{
+ //NONE = 0x00, // redundant
+ PLAY = 0x0F,
+ VOL = 0x06,
+ FOLDER = 0x2B, // Not a DFPlayer command, used to set folder nr where audio file is
+ REPEATPLAY = 0x08,
+ STOPPLAY = 0x16,
+ EQ = 0x07, // Set equaliser, require parameter NORMAL, POP, ROCK, JAZZ, CLASSIC or BASS
+ RESET = 0x0C,
+ //DACOFF = 0x1A, // Require 3rd byte to 0x00 in processOutgoing()
+ DACON = 0x1A, // Not a DFLayer command,need to sent 0x1A and 3rd byte to 0x01 in processOutgoing()
+ NORMAL = 0x00, // Equalizer parameters
+ POP = 0x01,
+ ROCK = 0x02,
+ JAZZ = 0x03,
+ CLASSIC = 0x04,
+ BASS = 0x05,
+ };
+
};
#endif // IO_I2CDFPlayer_h
From 0feb2c74e7c217b4c4f5eb2011862c8727c7a123 Mon Sep 17 00:00:00 2001
From: kempe63 <78020007+kempe63@users.noreply.github.com>
Date: Fri, 29 Dec 2023 22:11:40 +0000
Subject: [PATCH 15/44] Update IO_I2CDFPlayer.h
Completed implementation of exposing most relevant DFPlayer commands
Fixed a problem with RX corrupted data from DFPlayer.
Added retry (currently max retry 3) after timeout and recovery
Note: Need to think of a more elegant way to recover from a reset command
---
IO_I2CDFPlayer.h | 135 +++++++++++++++++++++++++++++------------------
1 file changed, 83 insertions(+), 52 deletions(-)
diff --git a/IO_I2CDFPlayer.h b/IO_I2CDFPlayer.h
index 536dff5..1ea6c25 100644
--- a/IO_I2CDFPlayer.h
+++ b/IO_I2CDFPlayer.h
@@ -87,7 +87,7 @@
//#define DIAG_I2CDFplayer
//#define DIAG_I2CDFplayer_data
//#define DIAG_I2CDFplayer_reg
-#define DIAG_I2CDFplayer_playing
+//#define DIAG_I2CDFplayer_playing
class I2CDFPlayer : public IODevice {
private:
@@ -98,6 +98,8 @@ private:
unsigned long _timeoutTime;
uint8_t _recvCMD; // Last received command code byte
bool _awaitingResponse = false;
+ uint8_t RETRYCOUNT = 0x03;
+ uint8_t _retryCounter = RETRYCOUNT; // Max retries before timing out
uint8_t _requestedVolumeLevel = MAXVOLUME;
uint8_t _currentVolume = MAXVOLUME;
int _requestedSong = -1; // -1=none, 0=stop, >0=file number
@@ -107,7 +109,7 @@ private:
I2CAddress _I2CAddress;
I2CRB _rb;
uint8_t _UART_CH;
- uint8_t _audioMixer = 0x00; // Default no audio mixer installed
+ uint8_t _audioMixer = 0x01; // Default to output amplifier 1
// Communication parameters for the DFPlayer are fixed at 8 bit, No parity, 1 stopbit
uint8_t WORD_LEN = 0x03; // Value LCR bit 0,1
uint8_t STOP_BIT = 0x00; // Value LCR bit 2
@@ -136,11 +138,12 @@ private:
uint8_t _outbuffer [11]; // DFPlayer command is 10 bytes + 1 byte register address & UART channel
uint8_t _inbuffer[10]; // expected DFPlayer return 10 bytes
-
-
+
//unsigned long SC16IS752_XTAL_FREQ = 1843200; // May need to change oscillator frequency to 14.7456Mhz (14745600) to allow for higher baud rates
unsigned long SC16IS752_XTAL_FREQ = 14745600; // Support for higher baud rates
+ unsigned long test = 0;
+
public:
// Constructor
I2CDFPlayer(VPIN firstVpin, int nPins, I2CAddress i2cAddress, uint8_t UART_CH, uint8_t AM){
@@ -176,7 +179,7 @@ public:
// Now init DFPlayer
// Send a query to the device to see if it responds
_deviceState = DEVSTATE_INITIALISING;
- sendPacket(0x42);
+ sendPacket(0x42,0,0);
_timeoutTime = micros() + 5000000UL; // 5 second timeout
_awaitingResponse = true;
}
@@ -188,13 +191,26 @@ public:
if (status == I2C_STATUS_PENDING) return; // Busy, so don't do anything
if (status == I2C_STATUS_OK) {
processIncoming(currentMicros);
- // Check if a command sent to device has timed out. Allow 0.5 second for response
- if (_awaitingResponse && (int32_t)(currentMicros - _timeoutTime) > 0) {
- DIAG(F("I2CDFPlayer:%s, DFPlayer not responding on UART channel: 0x%x"), _I2CAddress.toString(), _UART_CH);
- _deviceState = DEVSTATE_FAILED;
- _awaitingResponse = false;
- _playing = false;
- }
+ // Check if a command sent to device has timed out. Allow 0.5 second for response
+ // added retry counter, sometimes we do not sent keep alive due to other commands sent to DFPlayer
+ if (_awaitingResponse && (int32_t)(currentMicros - _timeoutTime) > 0) { // timeout triggered
+ if(_retryCounter == 0){ // retry counter out of luck, must take the device to failed state
+ DIAG(F("I2CDFPlayer:%s, DFPlayer not responding on UART channel: 0x%x"), _I2CAddress.toString(), _UART_CH);
+ _deviceState = DEVSTATE_FAILED;
+ _awaitingResponse = false;
+ _playing = false;
+ _retryCounter = RETRYCOUNT;
+ } else { // timeout and retry protection and recovery of corrupt data frames from DFPlayer
+ DIAG(F("I2CDFPlayer: %s, DFPlayer timout, retry counter: %d on UART channel: 0x%x"), _I2CAddress.toString(), _retryCounter, _UART_CH);
+ _timeoutTime = currentMicros + 5000000UL; // Timeout if no response within 5 seconds// reset timeout
+ _awaitingResponse = false; // trigger sending a keep alive 0x42 in processOutgoing()
+ _retryCounter --; // decrement retry counter
+ _resetCmd = true; // queue a DFPlayer reset
+ _currentVolume = MAXVOLUME; // Resetting the DFPlayer makes the volume go to default i.e. MAXVOLUME
+ //sendPacket(0x0C,0,0); // Reset DFPlayer
+ resetRX_fifo(); // reset the RX fifo as it maybe poisoned
+ }
+ }
}
status = _rb.status;
@@ -232,13 +248,6 @@ public:
return; // No data or not enough data in rx fifo, check again next time around
}
-/*
- #ifdef DIAG_I2CDFplayer
- if (FIFO_RX_LEVEL > 10) {
- DIAG(F("I2CDFPlayer: %s FIFO_RX_LEVEL: %d"),_I2CAddress.toString(), FIFO_RX_LEVEL);
- }
- #endif
-*/
bool ok = false;
//DIAG(F("I2CDFPlayer: RX_BUFFER: %d"), RX_BUFFER);
@@ -260,7 +269,7 @@ public:
break;
case 6:
switch (_recvCMD) {
- DIAG(F("I2CDFPlayer: %s, _recvCMD: 0x%x _awaitingResponse: 0x0%x"),_I2CAddress.toString(), _recvCMD, _awaitingResponse);
+ //DIAG(F("I2CDFPlayer: %s, _recvCMD: 0x%x _awaitingResponse: 0x0%x"),_I2CAddress.toString(), _recvCMD, _awaitingResponse);
case 0x42:
// Response to status query
_playing = (c != 0);
@@ -299,6 +308,7 @@ public:
case 9:
if (c==0xef) {
// Message finished
+ _retryCounter = RETRYCOUNT; // reset the retry counter as we have received a valid packet
}
break;
default:
@@ -315,7 +325,6 @@ public:
RX_BUFFER = 0; //Set to 0, we'll read a new RX FIFO level again
}
- //sendPacket(0x1A,0x00,0x01); //Enable DAC
// Send any commands that need to be sent
void processOutgoing(unsigned long currentMicros) {
@@ -323,8 +332,15 @@ public:
// execute one. Testing has indicated that a delay of 100ms or more is required
// between successive commands to get reliable operation.
// If 100ms has elapsed since the last thing sent, then check if there's some output to do.
- if (((int32_t)currentMicros - _commandSendTime) > 100000) {
- if (_currentVolume > _requestedVolumeLevel) {
+ if (((int32_t)currentMicros - _commandSendTime) > 100000) {
+ if ( _resetCmd == true){
+ sendPacket(0x0C,0,0);
+ _resetCmd = false;
+ return; // after reset do not execute more commands, wait for the next time giving the DFPlayer time to reset
+ // A more saver/elegant way is to wait for the 'SD card online' packet (7E FF 06 3F 00 00 02 xx xx EF)
+ // this indicate that the DFPlayer is ready.This may take between 500ms and 1500ms depending on the
+ // number of tracks on the SD card
+ } else if (_currentVolume > _requestedVolumeLevel) {
// Change volume before changing song if volume is reducing.
_currentVolume = _requestedVolumeLevel;
sendPacket(0x06, 0x00, _currentVolume);
@@ -332,9 +348,9 @@ public:
// Change song
if (_requestedSong != -1) {
#ifdef DIAG_I2CDFplayer_playing
- DIAG(F("I2CDFPlayer: _requestedVolumeLevel: %u, _requestedSong: %u, _playCmd: 0x%x"), _requestedVolumeLevel, _requestedSong, _playCmd);
+ DIAG(F("I2CDFPlayer: _requestedVolumeLevel: %u, _requestedSong: %u, _currentFolder: %u _playCmd: 0x%x"), _requestedVolumeLevel, _requestedSong, _currentFolder, _playCmd);
#endif
- sendPacket(0x0F, 0x01, _requestedSong); // audio file in folder 01
+ sendPacket(0x0F, _currentFolder, _requestedSong); // audio file in folder
_requestedSong = -1;
_playCmd = false;
}
@@ -348,6 +364,9 @@ public:
_repeat = false; // reset repeat
_stopplayCmd = false;
} else if (_folderCmd == true) {
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: Folder: _folderCmd: 0x%x, _requestedFolder: %d"), _stopplayCmd, _requestedFolder);
+ #endif
if (_currentFolder != _requestedFolder){
_currentFolder = _requestedFolder;
}
@@ -377,9 +396,6 @@ public:
sendPacket(0x07,0x00,_currentEQvalue);
}
_eqCmd = false;
- } else if ( _resetCmd == true){
- sendPacket(0x0C,0,0);
- _resetCmd = false;
} else if (_currentVolume < _requestedVolumeLevel) {
// Change volume after changing song if volume is increasing.
_currentVolume = _requestedVolumeLevel;
@@ -387,8 +403,14 @@ public:
} else if ((int32_t)currentMicros - _commandSendTime > 1000000) {
// Poll device every second that other commands aren't being sent,
// to check if it's still connected and responding.
- sendPacket(0x42);
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: Send keepalive") );
+ #endif
+ sendPacket(0x42,0,0);
if (!_awaitingResponse) {
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: Send keepalive, _awaitingResponse: 0x0%x"), _awaitingResponse );
+ #endif
_timeoutTime = currentMicros + 5000000UL; // Timeout if no response within 5 seconds
_awaitingResponse = true;
}
@@ -457,15 +479,13 @@ public:
// DFPlayerCmd = cmd;
// break;
case PLAY:
- _playCmd = true;
- //DFPlayerCmd = cmd;
+ _playCmd = true;
_requestedSong = value;
_requestedVolumeLevel = volume;
_playing = true;
break;
case VOL:
- _volCmd = true;
- //DFPlayerCmd = cmd;
+ _volCmd = true;
_requestedVolumeLevel = volume;
break;
case FOLDER:
@@ -479,7 +499,7 @@ public:
case REPEATPLAY: // Need to check if _repeat == true, if so do nothing
if (_repeat == false) {
#ifdef DIAG_I2CDFplayer_playing
- DIAG(F("I2CDFPlayer: WriteAnalog Repeat: _repeat: 0x0%x, value: %d _repeatCmd: 0x%x"), _repeat, value, _repeatCmd);
+ DIAG(F("I2CDFPlayer: WriteAnalog Repeat: _repeat: 0x0%x, value: %d _repeatCmd: 0x%x"), _repeat, value, _repeatCmd);
#endif
_repeatCmd = true;
_requestedSong = value;
@@ -488,31 +508,27 @@ public:
}
break;
case STOPPLAY:
- _stopplayCmd = true;
- //DFPlayerCmd = cmd;
+ _stopplayCmd = true;
break;
case EQ:
- //DIAG(F("I2CDFPlayer: WriteAnalog EQ: cmd: 0x%x, EQ value: 0x%x"), cmd, volume);
- _eqCmd = true;
- //DFPlayerCmd = cmd;
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: WriteAnalog EQ: cmd: 0x%x, EQ value: 0x%x"), cmd, volume);
+ #endif
+ _eqCmd = true;
if (volume <= NORMAL) { // to keep backward compatibility the volume parameter is used for values of the EQ cmd
- _requestedEQValue = NORMAL;
- //DFPlayerValue = NONE;
+ _requestedEQValue = NORMAL;
} else if (volume <= 0x05) { // Validate EQ parameters
- _requestedEQValue = volume;
- //DFPlayerValue = volume;
+ _requestedEQValue = volume;
}
- break;
-
+ break;
case RESET:
- _resetCmd = true;
- //DFPlayerCmd = cmd;
+ _resetCmd = true;
break;
case DACON: // Works, but without the DACOFF command limited value, except when not relying on DFPlayer default to turn the DAC on
- //DIAG(F("I2CDFPlayer: WrtieAnalog DACON: cmd: 0x%x"), cmd);
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: WrtieAnalog DACON: cmd: 0x%x"), cmd);
+ #endif
_daconCmd = true;
- //DFPlayerCmd = 0x1A;
- //DFPlayerValue = 0x00;
break;
default:
break;
@@ -666,12 +682,27 @@ private:
UART_ReadRegister(REG_RXLV);
FIFO_RX_LEVEL = _inbuffer[0];
#ifdef DIAG_I2CDFplayer
- if (FIFO_RX_LEVEL > 0){
- // DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, FIFO_RX_LEVEL: 0d%d"), _I2CAddress.toString(), _UART_CH, _inbuffer[0]);
+ //if (FIFO_RX_LEVEL > 0){
+ if (FIFO_RX_LEVEL > 0 && FIFO_RX_LEVEL < 10){
+ DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, FIFO_RX_LEVEL: 0d%d"), _I2CAddress.toString(), _UART_CH, _inbuffer[0]);
}
#endif
}
+ // When a frame is transmitted from the DFPlayer to the serial port, and at the same time the CS is sending a 42 query
+ // the following two frames from the DFPlayer are corrupt. This result in the receive buffer being out of sync and the
+ // CS will complain and generate a timeout.
+ // The RX fifo has corrupt data and need to be flushed, this function does that
+ //
+ void resetRX_fifo(){
+ #ifdef DIAG_I2CDFplayer
+ DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, RX fifo reset"), _I2CAddress.toString(), _UART_CH);
+ #endif
+ TEMP_REG_VAL = 0x03; // Reset RX fifo
+ UART_WriteRegister(REG_FCR, TEMP_REG_VAL);
+ }
+
+
// Read the Tranmit FIFO Level register (TXLVL), return a single unsigned integer
// of nr characters free in the TX FIFO, bit 6:0, 7 not used, set to zero
// value from 0 (0x00) to 64 (0x40)
From c4689795010406fc623b45bccfef79b0d8de3e85 Mon Sep 17 00:00:00 2001
From: kempe63 <78020007+kempe63@users.noreply.github.com>
Date: Sat, 30 Dec 2023 20:51:35 +0000
Subject: [PATCH 16/44] Update IO_I2CDFPlayer.h
Cleaned up the code and tested again.
This is ready to be merged into the devel branch when documentation is finished
---
IO_I2CDFPlayer.h | 211 ++++++++++++++++-------------------------------
1 file changed, 73 insertions(+), 138 deletions(-)
diff --git a/IO_I2CDFPlayer.h b/IO_I2CDFPlayer.h
index 1ea6c25..3c0ae3c 100644
--- a/IO_I2CDFPlayer.h
+++ b/IO_I2CDFPlayer.h
@@ -20,60 +20,26 @@
/*
* DFPlayer is an MP3 player module with an SD card holder. It also has an integrated
* amplifier, so it only needs a power supply and a speaker.
- *
- * This driver allows the device to be controlled through IODevice::write() and
- * IODevice::writeAnalogue() calls.
- *
- * The driver is configured as follows:
- *
- * DFPlayer::create(firstVpin, nPins, Serialn);
- *
- * Where firstVpin is the first vpin reserved for reading the device,
- * nPins is the number of pins to be allocated (max 5)
- * and Serialn is the name of the Serial port connected to the DFPlayer (e.g. Serial1).
- *
- * Example:
- * In halSetup function within myHal.cpp:
- * DFPlayer::create(3500, 5, Serial1);
- * or in myAutomation.h:
- * HAL(DFPlayer, 3500, 5, Serial1)
- *
- * Writing an analogue value 1-2999 to the first pin (3500) will play the numbered file from the
- * SD card; e.g. a value of 1 will play the first file, 2 for the second file etc.
- * Writing an analogue value 0 to the first pin (3500) will stop the file playing;
- * Writing an analogue value 0-30 to the second pin (3501) will set the volume;
- * Writing a digital value of 1 to a pin will play the file corresponding to that pin, e.g.
- the first file will be played by setting pin 3500, the second by setting pin 3501 etc.;
- * Writing a digital value of 0 to any pin will stop the player;
- * Reading a digital value from any pin will return true(1) if the player is playing, false(0) otherwise.
- *
- * From EX-RAIL, the following commands may be used:
- * SET(3500) -- starts playing the first file (file 1) on the SD card
- * SET(3501) -- starts playing the second file (file 2) on the SD card
- * etc.
- * RESET(3500) -- stops all playing on the player
- * WAITFOR(3500) -- wait for the file currently being played by the player to complete
- * SERVO(3500,2,Instant) -- plays file 2 at current volume
- * SERVO(3501,20,Instant) -- Sets the volume to 20
- *
- * NB The DFPlayer's serial lines are not 5V safe, so connecting the Arduino TX directly
- * to the DFPlayer's RX terminal will cause lots of noise over the speaker, or worse.
- * A 1k resistor in series with the module's RX terminal will alleviate this.
- *
- * Files on the SD card are numbered according to their order in the directory on the
- * card (as listed by the DIR command in Windows). This may not match the order of the files
- * as displayed by Windows File Manager, which sorts the file names. It is suggested that
- * files be copied into an empty SDcard in the desired order, one at a time.
- *
- * The driver now polls the device for its current status every second. Should the device
- * fail to respond it will be marked off-line and its busy indicator cleared, to avoid
- * lock-ups in automation scripts that are executing for a WAITFOR().
- *
+ * This driver is a modified version of the IO_DFPlayer.h file
* *********************************************************************************************
+ *
* 2023, Added NXP SC16IS752 I2C Dual UART to enable the DFPlayer connection over the I2C bus
* The SC16IS752 has 64 bytes TX & RX FIFO buffer
- * First version without interrupts from I2C UART and only RX/TX are used, interrupts may not be needed as the RX Fifo holds the reply
- *
+ * First version without interrupts from I2C UART and only RX/TX are used, interrupts may not be
+ * needed as the RX Fifo holds the reply
+ *
+ * myHall.cpp configuration syntax:
+ *
+ * I2CDFPlayer::create(1st vPin, vPins, I2C address, UART ch, AM);
+ *
+ * Parameters:
+ * 1st vPin : First virtual pin that EX-Rail can control to play a sound, use PLAYSOUND command (alias of ANOUT)
+ * vPins : Total number of virtual pins allocated (only 1 vPin is supported)
+ * I2C Address : I2C address of the serial controller, in 0x format,
+ * UART ch : Indicating UART 0 or UART 1, values 0 or 1
+ * AM : audio mixer, values: 1 or 2 to select an audio amplifier, no effect if AM is not installed
+ *
+ * The vPin is also an pin that can be read, it indicated if the DFPlayer has finished playing a track
*
*/
@@ -84,6 +50,7 @@
#include "I2CManager.h"
#include "DIAG.h"
+// Debug and diagnostic defines, enable too many will result in slowing the driver
//#define DIAG_I2CDFplayer
//#define DIAG_I2CDFplayer_data
//#define DIAG_I2CDFplayer_reg
@@ -92,13 +59,13 @@
class I2CDFPlayer : public IODevice {
private:
const uint8_t MAXVOLUME=30;
+ uint8_t RETRYCOUNT = 0x03;
bool _playing = false;
uint8_t _inputIndex = 0;
unsigned long _commandSendTime; // Time (us) that last transmit took place.
unsigned long _timeoutTime;
uint8_t _recvCMD; // Last received command code byte
- bool _awaitingResponse = false;
- uint8_t RETRYCOUNT = 0x03;
+ bool _awaitingResponse = false;
uint8_t _retryCounter = RETRYCOUNT; // Max retries before timing out
uint8_t _requestedVolumeLevel = MAXVOLUME;
uint8_t _currentVolume = MAXVOLUME;
@@ -121,8 +88,6 @@ private:
uint8_t FIFO_RX_LEVEL = 0x00;
uint8_t RX_BUFFER = 0x00; // nr of bytes copied into _inbuffer
uint8_t FIFO_TX_LEVEL = 0x00;
- //uint8_t DFPlayerValue = NONE; // Values for enhanced commands
- //uint8_t DFPlayerCmd = NONE; // Enhanced commands
bool _playCmd = false;
bool _volCmd = false;
bool _folderCmd = false;
@@ -135,15 +100,13 @@ private:
uint8_t _requestedEQValue = NORMAL;
uint8_t _currentEQvalue = NORMAL; // start equalizer value
bool _daconCmd = false;
-
uint8_t _outbuffer [11]; // DFPlayer command is 10 bytes + 1 byte register address & UART channel
uint8_t _inbuffer[10]; // expected DFPlayer return 10 bytes
- //unsigned long SC16IS752_XTAL_FREQ = 1843200; // May need to change oscillator frequency to 14.7456Mhz (14745600) to allow for higher baud rates
- unsigned long SC16IS752_XTAL_FREQ = 14745600; // Support for higher baud rates
+ //unsigned long SC16IS752_XTAL_FREQ = 1843200; // To support cheap eBay/AliExpress SC16IS752 boards
+ unsigned long SC16IS752_XTAL_FREQ = 14745600; // Support for higher baud rates, standard for modular EX-IO system
- unsigned long test = 0;
-
+
public:
// Constructor
I2CDFPlayer(VPIN firstVpin, int nPins, I2CAddress i2cAddress, uint8_t UART_CH, uint8_t AM){
@@ -201,14 +164,13 @@ public:
_playing = false;
_retryCounter = RETRYCOUNT;
} else { // timeout and retry protection and recovery of corrupt data frames from DFPlayer
- DIAG(F("I2CDFPlayer: %s, DFPlayer timout, retry counter: %d on UART channel: 0x%x"), _I2CAddress.toString(), _retryCounter, _UART_CH);
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: %s, DFPlayer timout, retry counter: %d on UART channel: 0x%x"), _I2CAddress.toString(), _retryCounter, _UART_CH);
+ #endif
_timeoutTime = currentMicros + 5000000UL; // Timeout if no response within 5 seconds// reset timeout
_awaitingResponse = false; // trigger sending a keep alive 0x42 in processOutgoing()
- _retryCounter --; // decrement retry counter
- _resetCmd = true; // queue a DFPlayer reset
- _currentVolume = MAXVOLUME; // Resetting the DFPlayer makes the volume go to default i.e. MAXVOLUME
- //sendPacket(0x0C,0,0); // Reset DFPlayer
- resetRX_fifo(); // reset the RX fifo as it maybe poisoned
+ _retryCounter --; // decrement retry counter
+ resetRX_fifo(); // reset the RX fifo as it has corrupt data
}
}
}
@@ -223,7 +185,7 @@ public:
}
- // Check for incoming data on _serial, and update busy flag and other state accordingly
+ // Check for incoming data, and update busy flag and other state accordingly
void processIncoming(unsigned long currentMicros) {
// Expected message is in the form "7E FF 06 3D xx xx xx xx xx EF"
@@ -335,15 +297,13 @@ public:
if (((int32_t)currentMicros - _commandSendTime) > 100000) {
if ( _resetCmd == true){
sendPacket(0x0C,0,0);
- _resetCmd = false;
- return; // after reset do not execute more commands, wait for the next time giving the DFPlayer time to reset
- // A more saver/elegant way is to wait for the 'SD card online' packet (7E FF 06 3F 00 00 02 xx xx EF)
- // this indicate that the DFPlayer is ready.This may take between 500ms and 1500ms depending on the
- // number of tracks on the SD card
- } else if (_currentVolume > _requestedVolumeLevel) {
- // Change volume before changing song if volume is reducing.
- _currentVolume = _requestedVolumeLevel;
- sendPacket(0x06, 0x00, _currentVolume);
+ _resetCmd = false;
+ } else if(_volCmd == true) { // do the volme before palying a track
+ if(_requestedVolumeLevel >= 0 && _requestedVolumeLevel <= 30){
+ _currentVolume = _requestedVolumeLevel; // If _requestedVolumeLevel is out of range, sent _currentV1olume
+ }
+ sendPacket(0x06, 0x00, _currentVolume);
+ _volCmd = false;
} else if (_playCmd == true) {
// Change song
if (_requestedSong != -1) {
@@ -396,10 +356,6 @@ public:
sendPacket(0x07,0x00,_currentEQvalue);
}
_eqCmd = false;
- } else if (_currentVolume < _requestedVolumeLevel) {
- // Change volume after changing song if volume is increasing.
- _currentVolume = _requestedVolumeLevel;
- sendPacket(0x06, 0x00, _currentVolume);
} else if ((int32_t)currentMicros - _commandSendTime > 1000000) {
// Poll device every second that other commands aren't being sent,
// to check if it's still connected and responding.
@@ -418,34 +374,22 @@ public:
}
}
- // Write with value 1 starts playing a song. The relative pin number is the file number.
- // Write with value 0 stops playing.
+
+ // Write to a vPin will do nothing
void _write(VPIN vpin, int value) override {
if (_deviceState == DEVSTATE_FAILED) return;
- int pin = vpin - _firstVpin;
- if (value) {
- // Value 1, start playing
#ifdef DIAG_IO
- DIAG(F("I2CDFPlayer: Play %d"), pin+1);
+ DIAG(F("I2CDFPlayer: Writing to any vPin not supported"));
#endif
- _requestedSong = pin+1;
- _playing = true;
- } else {
- // Value 0, stop playing
- #ifdef DIAG_IO
- DIAG(F("I2CDFPlayer: Stop"));
- #endif
- _requestedSong = 0; // No song
- _playing = false;
- }
}
+
// WriteAnalogue on first pin uses the nominated value as a file number to start playing, if file number > 0.
// Volume may be specified as second parameter to writeAnalogue.
// If value is zero, the player stops playing.
// WriteAnalogue on second pin sets the output volume.
//
- // Currently all WrtiteAnalogue to be done on vpin 2, will move to vpin 0 when fully implemented
+ // WriteAnalogue to be done on first vpin
//
//void _writeAnalogue(VPIN vpin, int value, uint8_t volume=0, uint16_t=0) override {
void _writeAnalogue(VPIN vpin, int value, uint8_t volume=0, uint16_t cmd=0) override {
@@ -454,32 +398,15 @@ public:
DIAG(F("I2CDFPlayer: VPIN:%u FileNo:%d Volume:%d Command:0x%x"), vpin, value, volume, cmd);
#endif
uint8_t pin = vpin - _firstVpin;
- // Validate parameter.
- if (volume > MAXVOLUME) volume = MAXVOLUME;
-
- if (pin == 0) {
- // Play track
- if (value > 0) {
- if (volume > 0)
- _requestedVolumeLevel = volume;
- _requestedSong = value;
- _playing = true;
- } else {
- _requestedSong = 0; // stop playing
- _playing = false;
- }
- } else if (pin == 1) {
- // Set volume (0-30)
- _requestedVolumeLevel = value;
-
- } else if (pin == 2) { // Enhanced DFPlayer commands
+ if (pin == 0) { // Enhanced DFPlayer commands, do nothing if not vPin 0
// Read command and value
switch (cmd){
//case NONE:
// DFPlayerCmd = cmd;
// break;
case PLAY:
- _playCmd = true;
+ _playCmd = true;
+ _volCmd = true;
_requestedSong = value;
_requestedVolumeLevel = volume;
_playing = true;
@@ -536,31 +463,33 @@ public:
}
}
- // A read on any pin indicates whether the player is still playing.
- int _read(VPIN) override {
+ // A read on any pin indicates if the player is still playing.
+ int _read(VPIN vpin) override {
if (_deviceState == DEVSTATE_FAILED) return false;
- return _playing;
- }
+ uint8_t pin = vpin - _firstVpin;
+ if (pin == 0) { // Do nothing if not vPin 0
+ return _playing;
+ }
+ }
void _display() override {
DIAG(F("I2CDFPlayer Configured on Vpins:%u-%u %S"), _firstVpin, _firstVpin+_nPins-1,
(_deviceState==DEVSTATE_FAILED) ? F("OFFLINE") : F(""));
}
-private:
+private:
+ // DFPlayer command frame
// 7E FF 06 0F 00 01 01 xx xx EF
- // 0 -> 7E is start code
- // 1 -> FF is version
- // 2 -> 06 is length
- // 3 -> 0F is command
- // 4 -> 00 is no receive
+ // 0 -> 7E is start code
+ // 1 -> FF is version
+ // 2 -> 06 is length
+ // 3 -> 0F is command
+ // 4 -> 00 is no receive
// 5~6 -> 01 01 is argument
// 7~8 -> checksum = 0 - ( FF+06+0F+00+01+01 )
- // 9 -> EF is end code
+ // 9 -> EF is end code
- //void sendPacket(uint8_t command, uint16_t arg = 0)
- void sendPacket(uint8_t command, uint8_t arg1 = 0, uint8_t arg2 = 0)
- {
+ void sendPacket(uint8_t command, uint8_t arg1 = 0, uint8_t arg2 = 0) {
FIFO_TX_LEVEL = 0; // Reset FIFO_TX_LEVEL
uint8_t out[] = {
0x7E,
@@ -618,7 +547,6 @@ private:
void setChecksum(uint8_t* out)
{
uint16_t sum = calcChecksum(out);
-
out[7] = (sum >> 8);
out[8] = (sum & 0xff);
}
@@ -628,6 +556,9 @@ private:
// First a software reset
// Enable FIFO and clear TX & RX FIFO
// Need to set the following registers
+ // IOCONTROL set bit 1 and 2 to 0 indicating that they are GPIO
+ // IODIR set all bit to 1 indicating al are output
+ // IOSTATE set only bit 0 to 1 for UART 0, or only bit 1 for UART 1 //
// LCR bit 7=0 divisor latch (clock division registers DLH & DLL, they store 16 bit divisor),
// WORD_LEN, STOP_BIT, PARITY_ENA and PARITY_TYPE
// MCR bit 7=0 clock divisor devide-by-1 clock input
@@ -647,8 +578,13 @@ private:
UART_WriteRegister(REG_IOCONTROL, TEMP_REG_VAL);
TEMP_REG_VAL = 0xFF; //Set all pins as output
UART_WriteRegister(REG_IODIR, TEMP_REG_VAL);
- TEMP_REG_VAL = 0x01; //Set initial value as high
- //TEMP_REG_VAL = 0x00; //Set initial value as low
+ UART_ReadRegister(REG_IOSTATE); // Read current state as not to overwrite the other GPIO pins
+ TEMP_REG_VAL = _inbuffer[0];
+ if (_UART_CH == 0){
+ TEMP_REG_VAL |= (0x01 << _UART_CH); //Set GPIO pin 0 to high
+ } else { // must be UART 1
+ TEMP_REG_VAL |= (0x01 << _UART_CH); //Set GPIO pin 1 to high
+ }
UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
TEMP_REG_VAL = 0x07; // Reset FIFO, clear RX & TX FIFO
UART_WriteRegister(REG_FCR, TEMP_REG_VAL);
@@ -678,12 +614,13 @@ private:
// Read the Receive FIFO Level register (RXLVL), return a single unsigned integer
// of nr of characters in the RX FIFO, bit 6:0, 7 not used, set to zero
// value from 0 (0x00) to 64 (0x40) Only display if RX FIFO has data
+ // The RX fifo level is used to check if there are enough bytes to process a frame
void RX_fifo_lvl(){
UART_ReadRegister(REG_RXLV);
FIFO_RX_LEVEL = _inbuffer[0];
#ifdef DIAG_I2CDFplayer
- //if (FIFO_RX_LEVEL > 0){
- if (FIFO_RX_LEVEL > 0 && FIFO_RX_LEVEL < 10){
+ if (FIFO_RX_LEVEL > 0){
+ //if (FIFO_RX_LEVEL > 0 && FIFO_RX_LEVEL < 10){
DIAG(F("SC16IS752: At I2C: %s, UART channel: 0x%x, FIFO_RX_LEVEL: 0d%d"), _I2CAddress.toString(), _UART_CH, _inbuffer[0]);
}
#endif
@@ -776,7 +713,6 @@ enum : uint8_t{
// DFPlayer commands and values
enum : uint8_t{
- //NONE = 0x00, // redundant
PLAY = 0x0F,
VOL = 0x06,
FOLDER = 0x2B, // Not a DFPlayer command, used to set folder nr where audio file is
@@ -784,7 +720,6 @@ enum : uint8_t{
STOPPLAY = 0x16,
EQ = 0x07, // Set equaliser, require parameter NORMAL, POP, ROCK, JAZZ, CLASSIC or BASS
RESET = 0x0C,
- //DACOFF = 0x1A, // Require 3rd byte to 0x00 in processOutgoing()
DACON = 0x1A, // Not a DFLayer command,need to sent 0x1A and 3rd byte to 0x01 in processOutgoing()
NORMAL = 0x00, // Equalizer parameters
POP = 0x01,
From 46673007cc18f12bf3102f03cc1cb87121c2a23d Mon Sep 17 00:00:00 2001
From: kempe63 <78020007+kempe63@users.noreply.github.com>
Date: Mon, 1 Jan 2024 20:35:39 +0000
Subject: [PATCH 17/44] Update IO_I2CDFPlayer.h
Added SETAM, set the audio Mixer command to the supported EX-Rail commands.
the audio mixer can now be set at startup by using the configuration in myHall.cpp and it can be modified in an EX-Rail scripts.
Syntax: PLAYSOUND(, 0, , SETAM)
Valid values for : 1 or 2
---
IO_I2CDFPlayer.h | 81 ++++++++++++++++++++++++++++++++++++++++++------
1 file changed, 71 insertions(+), 10 deletions(-)
diff --git a/IO_I2CDFPlayer.h b/IO_I2CDFPlayer.h
index 3c0ae3c..2bf28cc 100644
--- a/IO_I2CDFPlayer.h
+++ b/IO_I2CDFPlayer.h
@@ -75,8 +75,7 @@ private:
// SC16IS752 defines
I2CAddress _I2CAddress;
I2CRB _rb;
- uint8_t _UART_CH;
- uint8_t _audioMixer = 0x01; // Default to output amplifier 1
+ uint8_t _UART_CH;
// Communication parameters for the DFPlayer are fixed at 8 bit, No parity, 1 stopbit
uint8_t WORD_LEN = 0x03; // Value LCR bit 0,1
uint8_t STOP_BIT = 0x00; // Value LCR bit 2
@@ -100,6 +99,8 @@ private:
uint8_t _requestedEQValue = NORMAL;
uint8_t _currentEQvalue = NORMAL; // start equalizer value
bool _daconCmd = false;
+ uint8_t _audioMixer = 0x01; // Default to output amplifier 1
+ bool _setamCmd = false; // Set the Audio mixer channel
uint8_t _outbuffer [11]; // DFPlayer command is 10 bytes + 1 byte register address & UART channel
uint8_t _inbuffer[10]; // expected DFPlayer return 10 bytes
@@ -356,6 +357,28 @@ public:
sendPacket(0x07,0x00,_currentEQvalue);
}
_eqCmd = false;
+ } else if (_setamCmd == true){ // Set Audio mixer channel
+ setGPIO(); // Set the audio mixer channel
+ /*
+ if (_audioMixer == 1){ // set to audio mixer 1
+ if (_UART_CH == 0){
+ TEMP_REG_VAL |= (0x01 << _UART_CH); //Set GPIO pin 0 to high
+ } else { // must be UART 1
+ TEMP_REG_VAL |= (0x01 << _UART_CH); //Set GPIO pin 1 to high
+ }
+ //_setamCmd = false;
+ //UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
+ } else { // set to audio mixer 2
+ if (_UART_CH == 0){
+ TEMP_REG_VAL &= (0x00 << _UART_CH); //Set GPIO pin 0 to Low
+ } else { // must be UART 1
+ TEMP_REG_VAL &= (0x00 << _UART_CH); //Set GPIO pin 1 to Low
+ }
+ //_setamCmd = false;
+ //UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
+ }*/
+ _setamCmd = false;
+ UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
} else if ((int32_t)currentMicros - _commandSendTime > 1000000) {
// Poll device every second that other commands aren't being sent,
// to check if it's still connected and responding.
@@ -417,7 +440,7 @@ public:
break;
case FOLDER:
_folderCmd = true;
- if (volume <= 0 && volume > 99){ // Range checking
+ if (volume <= 0 || volume > 99){ // Range checking, valid values 1-99, else default to 1
_requestedFolder = 0x01; // if outside range, default to folder 01
} else {
_requestedFolder = volume;
@@ -442,11 +465,11 @@ public:
DIAG(F("I2CDFPlayer: WriteAnalog EQ: cmd: 0x%x, EQ value: 0x%x"), cmd, volume);
#endif
_eqCmd = true;
- if (volume <= NORMAL) { // to keep backward compatibility the volume parameter is used for values of the EQ cmd
+ if (volume <= 0 || volume > 5) { // If out of range, default to NORMAL
_requestedEQValue = NORMAL;
- } else if (volume <= 0x05) { // Validate EQ parameters
+ } else { // Valid EQ parameter range
_requestedEQValue = volume;
- }
+ }
break;
case RESET:
_resetCmd = true;
@@ -457,6 +480,17 @@ public:
#endif
_daconCmd = true;
break;
+ case SETAM: // Set the audio mixer channel to 1 or 2
+ _setamCmd = true;
+ #ifdef DIAG_I2CDFplayer_playing
+ DIAG(F("I2CDFPlayer: WrtieAnalog SETAM: cmd: 0x%x"), cmd);
+ #endif
+ if (volume <= 0 || volume > 2) { // If out of range, default to 1
+ _audioMixer = 1;
+ } else { // Valid SETAM parameter in range
+ _audioMixer = volume; // _audioMixer valid values 1 or 2
+ }
+ break;
default:
break;
}
@@ -580,12 +614,15 @@ private:
UART_WriteRegister(REG_IODIR, TEMP_REG_VAL);
UART_ReadRegister(REG_IOSTATE); // Read current state as not to overwrite the other GPIO pins
TEMP_REG_VAL = _inbuffer[0];
- if (_UART_CH == 0){
+ setGPIO(); // Set the audio mixer channel
+ /*
+ if (_UART_CH == 0){ // Set Audio mixer channel
TEMP_REG_VAL |= (0x01 << _UART_CH); //Set GPIO pin 0 to high
} else { // must be UART 1
TEMP_REG_VAL |= (0x01 << _UART_CH); //Set GPIO pin 1 to high
}
- UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
+ UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
+ */
TEMP_REG_VAL = 0x07; // Reset FIFO, clear RX & TX FIFO
UART_WriteRegister(REG_FCR, TEMP_REG_VAL);
TEMP_REG_VAL = 0x00; // Set MCR to all 0, includes Clock divisor
@@ -638,6 +675,29 @@ private:
TEMP_REG_VAL = 0x03; // Reset RX fifo
UART_WriteRegister(REG_FCR, TEMP_REG_VAL);
}
+
+ // Set or reset GPIO pin 0 and 1 depending on the UART ch
+ // This function may be modified in a future release to enable all 8 pins to be set or reset with EX-Rail
+ // for various auxilary functions
+ void setGPIO(){
+ UART_ReadRegister(REG_IOSTATE); // Get the current GPIO pins state from the IOSTATE register
+ TEMP_REG_VAL = _inbuffer[0];
+ if (_audioMixer == 1){ // set to audio mixer 1
+ if (_UART_CH == 0){
+ TEMP_REG_VAL |= (0x01 << _UART_CH); //Set GPIO pin 0 to high
+ } else { // must be UART 1
+ TEMP_REG_VAL |= (0x01 << _UART_CH); //Set GPIO pin 1 to high
+ }
+ } else { // set to audio mixer 2
+ if (_UART_CH == 0){
+ TEMP_REG_VAL &= ~(0x01 << _UART_CH); //Set GPIO pin 0 to Low
+ } else { // must be UART 1
+ TEMP_REG_VAL &= ~(0x01 << _UART_CH); //Set GPIO pin 1 to Low
+ }
+ }
+ UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
+ _setamCmd = false;
+ }
// Read the Tranmit FIFO Level register (TXLVL), return a single unsigned integer
@@ -720,13 +780,14 @@ enum : uint8_t{
STOPPLAY = 0x16,
EQ = 0x07, // Set equaliser, require parameter NORMAL, POP, ROCK, JAZZ, CLASSIC or BASS
RESET = 0x0C,
- DACON = 0x1A, // Not a DFLayer command,need to sent 0x1A and 3rd byte to 0x01 in processOutgoing()
+ DACON = 0x1A,
+ SETAM = 0x2A, // Set audio mixer 1 or 2 for this DFPLayer
NORMAL = 0x00, // Equalizer parameters
POP = 0x01,
ROCK = 0x02,
JAZZ = 0x03,
CLASSIC = 0x04,
- BASS = 0x05,
+ BASS = 0x05,
};
};
From 0e9caa11c8b423ce55c1a6ca4144e92fb3569a15 Mon Sep 17 00:00:00 2001
From: kempe63 <78020007+kempe63@users.noreply.github.com>
Date: Mon, 1 Jan 2024 20:39:37 +0000
Subject: [PATCH 18/44] Update IO_I2CDFPlayer.h
Oops, fixed a typo
---
IO_I2CDFPlayer.h | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/IO_I2CDFPlayer.h b/IO_I2CDFPlayer.h
index 2bf28cc..39c0e02 100644
--- a/IO_I2CDFPlayer.h
+++ b/IO_I2CDFPlayer.h
@@ -377,8 +377,7 @@ public:
//_setamCmd = false;
//UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
}*/
- _setamCmd = false;
- UART_WriteRegister(REG_IOSTATE, TEMP_REG_VAL);
+ _setamCmd = false;
} else if ((int32_t)currentMicros - _commandSendTime > 1000000) {
// Poll device every second that other commands aren't being sent,
// to check if it's still connected and responding.
From 6b8b3e2664c2ba3fd5936824d1c531f892e672da Mon Sep 17 00:00:00 2001
From: Ash-4 <81280775+Ash-4@users.noreply.github.com>
Date: Mon, 8 Jan 2024 19:02:06 -0600
Subject: [PATCH 19/44] Update version.h
---
version.h | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/version.h b/version.h
index 8239649..42fd03e 100644
--- a/version.h
+++ b/version.h
@@ -3,7 +3,8 @@
#include "StringFormatter.h"
-#define VERSION "5.2.20ethCdf"
+#define VERSION "5.2.21"
+// 5.2.21 - Add STARTUP_DELAY config option to delay CS bootup
// 5.2.20 - Check return of Ethernet.begin()
// 5.2.19 - ESP32: Determine if the RMT hardware can handle DCC
// 5.2.18 - Display network IP fix
From b3667b4d8585d05f107e93e988fe8d40da3ff469 Mon Sep 17 00:00:00 2001
From: Ash-4 <81280775+Ash-4@users.noreply.github.com>
Date: Mon, 8 Jan 2024 19:07:16 -0600
Subject: [PATCH 20/44] Update version.h 5.2.21 startup-delay
---
version.h | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/version.h b/version.h
index 42fd03e..ee50594 100644
--- a/version.h
+++ b/version.h
@@ -3,7 +3,7 @@
#include "StringFormatter.h"
-#define VERSION "5.2.21"
+#define VERSION "5.2.21ethCdf"
// 5.2.21 - Add STARTUP_DELAY config option to delay CS bootup
// 5.2.20 - Check return of Ethernet.begin()
// 5.2.19 - ESP32: Determine if the RMT hardware can handle DCC
From 8e56a1e7f9c8940b77bde293290dd3327776c718 Mon Sep 17 00:00:00 2001
From: Ash-4 <81280775+Ash-4@users.noreply.github.com>
Date: Wed, 10 Jan 2024 01:34:29 -0600
Subject: [PATCH 21/44] Update version.h
---
version.h | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/version.h b/version.h
index ee50594..bb100bb 100644
--- a/version.h
+++ b/version.h
@@ -3,7 +3,8 @@
#include "StringFormatter.h"
-#define VERSION "5.2.21ethCdf"
+#define VERSION "5.2.22"
+// 5.2.22 - Bugfixes: Empty turnout descriptions ok; negative route numbers valid.
// 5.2.21 - Add STARTUP_DELAY config option to delay CS bootup
// 5.2.20 - Check return of Ethernet.begin()
// 5.2.19 - ESP32: Determine if the RMT hardware can handle DCC
From 1bd113a35f87701b7e5a097661ec9b3c1b123591 Mon Sep 17 00:00:00 2001
From: Ash-4 <81280775+Ash-4@users.noreply.github.com>
Date: Wed, 10 Jan 2024 01:40:31 -0600
Subject: [PATCH 22/44] update for negative routes 5.2.22
---
version.h | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/version.h b/version.h
index bb100bb..909d56b 100644
--- a/version.h
+++ b/version.h
@@ -3,7 +3,7 @@
#include "StringFormatter.h"
-#define VERSION "5.2.22"
+#define VERSION "5.2.22ethCdf"
// 5.2.22 - Bugfixes: Empty turnout descriptions ok; negative route numbers valid.
// 5.2.21 - Add STARTUP_DELAY config option to delay CS bootup
// 5.2.20 - Check return of Ethernet.begin()
From fa44d547749a36b2b89c7254c2d608d3d09e2604 Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Wed, 10 Jan 2024 09:16:27 +0100
Subject: [PATCH 23/44] guessI2CDeviceType should always return FSH "string"
---
I2CManager.cpp | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/I2CManager.cpp b/I2CManager.cpp
index fadf8bb..2591e13 100644
--- a/I2CManager.cpp
+++ b/I2CManager.cpp
@@ -66,9 +66,9 @@ static const FSH * guessI2CDeviceType(uint8_t address) {
return F("Real-time clock");
else if (address >= 0x70 && address <= 0x77)
return F("I2C Mux");
- else if (address >= 0x90 && address <= 0xAE);
- else
- return F("?");
+ else if (address >= 0x90 && address <= 0xAE)
+ return F("UART");
+ return F("?");
}
// If not already initialised, initialise I2C
From 7ae6ff27f5eb24b684e329aba7461a3e9814b7c8 Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Wed, 10 Jan 2024 15:09:22 +0100
Subject: [PATCH 24/44] Bugfix: Ethernet fixed IP start
---
EthernetInterface.cpp | 19 +++++++++++--------
1 file changed, 11 insertions(+), 8 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index 914dd8c..6c8e8fa 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -50,6 +50,10 @@ void EthernetInterface::setup()
};
+#ifdef IP_ADDRESS
+static IPAddress myIP(IP_ADDRESS);
+#endif
+
/**
* @brief Aquire IP Address from DHCP and start server
*
@@ -71,33 +75,32 @@ EthernetInterface::EthernetInterface()
// Which seems more useful! We should propose the patch... so the following line actually works!
netif_set_hostname(&gnetif, WIFI_HOSTNAME); // Should probably be passed in the contructor...
#ifdef IP_ADDRESS
- if (Ethernet.begin(IP_ADDRESS) == 0)
+ Ethernet.begin(myIP);
#else
if (Ethernet.begin() == 0)
- #endif // IP_ADDRESS
{
DIAG(F("Ethernet.begin FAILED"));
return;
}
+ #endif // IP_ADDRESS
#else // All other architectures
byte mac[6]= { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
DIAG(F("Ethernet attempting to get MAC address"));
DCCTimer::getSimulatedMacAddress(mac);
DIAG(F("Ethernet got MAC address"));
#ifdef IP_ADDRESS
- if (Ethernet.begin(mac, IP_ADDRESS) == 0)
+ Ethernet.begin(mac, myIP);
#else
if (Ethernet.begin(mac) == 0)
- #endif
{
DIAG(F("Ethernet.begin FAILED"));
return;
- }
-
+ }
+ #endif // IP_ADDRESS
if (Ethernet.hardwareStatus() == EthernetNoHardware) {
DIAG(F("Ethernet shield not found or W5100"));
}
-#endif
+#endif STM32_ETHERNET
uint32_t startmilli = millis();
while ((millis() - startmilli) < 5500) { // Loop to give time to check for cable connection
@@ -163,7 +166,7 @@ bool EthernetInterface::checkLink() {
DIAG(F("Ethernet cable connected"));
connected=true;
#ifdef IP_ADDRESS
- Ethernet.setLocalIP(IP_ADDRESS); // for static IP, set it again
+ Ethernet.setLocalIP(myIP); // for static IP, set it again
#endif
IPAddress ip = Ethernet.localIP(); // look what IP was obtained (dynamic or static)
server = new EthernetServer(IP_PORT); // Ethernet Server listening on default port IP_PORT
From ba3d29e4b565c2e02f6d87bf5e0947a9129e299a Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Wed, 10 Jan 2024 16:29:21 +0100
Subject: [PATCH 25/44] STM32Ethernet lib for onboard ethernet is different
---
EthernetInterface.cpp | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index 6c8e8fa..ad26778 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -100,7 +100,7 @@ EthernetInterface::EthernetInterface()
if (Ethernet.hardwareStatus() == EthernetNoHardware) {
DIAG(F("Ethernet shield not found or W5100"));
}
-#endif STM32_ETHERNET
+#endif // STM32_ETHERNET
uint32_t startmilli = millis();
while ((millis() - startmilli) < 5500) { // Loop to give time to check for cable connection
@@ -166,8 +166,10 @@ bool EthernetInterface::checkLink() {
DIAG(F("Ethernet cable connected"));
connected=true;
#ifdef IP_ADDRESS
+ #ifndef STM32_ETHERNET
Ethernet.setLocalIP(myIP); // for static IP, set it again
#endif
+ #endif
IPAddress ip = Ethernet.localIP(); // look what IP was obtained (dynamic or static)
server = new EthernetServer(IP_PORT); // Ethernet Server listening on default port IP_PORT
server->begin();
From 8503835e1c99f8dd5c99dbadd29e5058502e9bcf Mon Sep 17 00:00:00 2001
From: pmantoine
Date: Sat, 13 Jan 2024 10:51:27 +0800
Subject: [PATCH 26/44] STM32 I2C pullups config turned off for testing
---
I2CManager_STM32.h | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/I2CManager_STM32.h b/I2CManager_STM32.h
index 9350d14..ea56fec 100644
--- a/I2CManager_STM32.h
+++ b/I2CManager_STM32.h
@@ -185,7 +185,7 @@ void I2CManagerClass::I2C_init()
GPIOB->OTYPER |= (1<<8) | (1<<9); // PB8 and PB9 set to open drain output capability
GPIOB->OSPEEDR |= (3<<(8*2)) | (3<<(9*2)); // PB8 and PB9 set to High Speed mode
GPIOB->PUPDR &= ~((3<<(8*2)) | (3<<(9*2))); // Clear all PUPDR bits for PB8 and PB9
- GPIOB->PUPDR |= (1<<(8*2)) | (1<<(9*2)); // PB8 and PB9 set to pull-up capability
+ // GPIOB->PUPDR |= (1<<(8*2)) | (1<<(9*2)); // PB8 and PB9 set to pull-up capability
// Alt Function High register routing pins PB8 and PB9 for I2C1:
// Bits (3:2:1:0) = 0:1:0:0 --> AF4 for pin PB8
// Bits (7:6:5:4) = 0:1:0:0 --> AF4 for pin PB9
From 08c89f743f44eb01941533358c7776b67f1de969 Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Sat, 27 Jan 2024 21:12:09 +0100
Subject: [PATCH 27/44] make Ethernet socket array insert more fool proof
---
EthernetInterface.cpp | 29 ++++++++++++++++-------------
1 file changed, 16 insertions(+), 13 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index ad26778..613c04e 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -213,21 +213,24 @@ void EthernetInterface::loop2() {
if (client)
{
byte socket;
- for (socket = 0; socket < MAX_SOCK_NUM; socket++)
- {
- if (clients[socket]) {
- if (clients[socket] == client)
- break;
+ bool sockfound = false;
+ for (socket = 0; socket < MAX_SOCK_NUM; socket++) {
+ if (clients[socket] && (clients[socket] == client)) {
+ sockfound = true;
+ if (Diag::ETHERNET) DIAG(F("Ethernet: Old client socket %d"),socket);
+ break;
}
- else //if (!clients[socket])
- {
- if (Diag::ETHERNET) DIAG(F("Ethernet: New client "));
- // On accept() the EthernetServer doesn't track the client anymore
- // so we store it in our client array
- if (Diag::ETHERNET) DIAG(F("Socket %d"),socket);
- clients[socket] = client;
- break;
+ }
+ if (!sockfound) { // new client
+ for (socket = 0; socket < MAX_SOCK_NUM; socket++) {
+ if (!clients[socket]) {
+ // On accept() the EthernetServer doesn't track the client anymore
+ // so we store it in our client array
+ clients[socket] = client;
+ if (Diag::ETHERNET) DIAG(F("Ethernet: New client socket %d"),socket);
+ break;
}
+ }
}
if (socket==MAX_SOCK_NUM) DIAG(F("new Ethernet OVERFLOW"));
}
From 4d3dffacb4fe66ce10ac3caa6ef5f8daedd1f25c Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Sat, 27 Jan 2024 21:29:25 +0100
Subject: [PATCH 28/44] scan earlier for dead Ethernet connections
---
EthernetInterface.cpp | 41 +++++++++++++++++++----------------------
1 file changed, 19 insertions(+), 22 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index 613c04e..6d440dd 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -238,29 +238,26 @@ void EthernetInterface::loop2() {
// check for incoming data from all possible clients
for (byte socket = 0; socket < MAX_SOCK_NUM; socket++)
{
- if (clients[socket]) {
+ if (clients[socket]) {
+ if (!clients[socket].connected()) { // stop any clients which disconnect
+ CommandDistributor::forget(socket);
+ clients[socket].stop();
+ //if (Diag::ETHERNET)
+ DIAG(F("Ethernet: disconnect %d "), socket);
+ }
- int available=clients[socket].available();
- if (available > 0) {
- if (Diag::ETHERNET) DIAG(F("Ethernet: available socket=%d,avail=%d"), socket, available);
- // read bytes from a client
- int count = clients[socket].read(buffer, MAX_ETH_BUFFER);
- buffer[count] = '\0'; // terminate the string properly
- if (Diag::ETHERNET) DIAG(F(",count=%d:%e"), socket,buffer);
- // execute with data going directly back
- CommandDistributor::parse(socket,buffer,outboundRing);
- return; // limit the amount of processing that takes place within 1 loop() cycle.
- }
- }
- }
-
- // stop any clients which disconnect
- for (int socket = 0; socket 0) {
+ if (Diag::ETHERNET) DIAG(F("Ethernet: available socket=%d,avail=%d"), socket, available);
+ // read bytes from a client
+ int count = clients[socket].read(buffer, MAX_ETH_BUFFER);
+ buffer[count] = '\0'; // terminate the string properly
+ if (Diag::ETHERNET) DIAG(F(",count=%d:%e"), socket,buffer);
+ // execute with data going directly back
+ CommandDistributor::parse(socket,buffer,outboundRing);
+ return; // limit the amount of processing that takes place within 1 loop() cycle.
+ }
+ }
}
WiThrottle::loop(outboundRing);
From dd5ab6c7fa62bbfd924b4fd7d362a54c682f22ad Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Sat, 27 Jan 2024 21:30:20 +0100
Subject: [PATCH 29/44] github tag
---
GITHUB_SHA.h | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/GITHUB_SHA.h b/GITHUB_SHA.h
index d15db46..a127d69 100644
--- a/GITHUB_SHA.h
+++ b/GITHUB_SHA.h
@@ -1 +1 @@
-#define GITHUB_SHA "devel-202401202116Z"
+#define GITHUB_SHA "devel-stm32EC 202401272029Z"
From 60fb30c0a76774944f4419e946e5679e8ac4c1cf Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Sun, 28 Jan 2024 01:47:05 +0100
Subject: [PATCH 30/44] set ethernet client to NULL when done with it
---
EthernetInterface.cpp | 2 ++
1 file changed, 2 insertions(+)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index 6d440dd..8b1a643 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -242,8 +242,10 @@ void EthernetInterface::loop2() {
if (!clients[socket].connected()) { // stop any clients which disconnect
CommandDistributor::forget(socket);
clients[socket].stop();
+ clients[socket]=NULL;
//if (Diag::ETHERNET)
DIAG(F("Ethernet: disconnect %d "), socket);
+ return; // Trick: So that we do not continue in this loop with client that is NULL
}
int available=clients[socket].available();
From 6cdde5d3c615715df651f89d0664249be492f0b3 Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Sun, 28 Jan 2024 01:47:28 +0100
Subject: [PATCH 31/44] github tag
---
GITHUB_SHA.h | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/GITHUB_SHA.h b/GITHUB_SHA.h
index a127d69..aaa555c 100644
--- a/GITHUB_SHA.h
+++ b/GITHUB_SHA.h
@@ -1 +1 @@
-#define GITHUB_SHA "devel-stm32EC 202401272029Z"
+#define GITHUB_SHA "devel-stm32EC 202401280047Z"
From ad09360a54d8953615c7288abb85c737e1c2c342 Mon Sep 17 00:00:00 2001
From: pmantoine
Date: Sun, 28 Jan 2024 13:31:43 +0900
Subject: [PATCH 32/44] MDNS Generic library integration
---
EthernetInterface.cpp | 12 ++++++++++++
EthernetInterface.h | 2 +-
platformio.ini | 3 +++
version.h | 3 ++-
4 files changed, 18 insertions(+), 2 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index 8b1a643..b39d5af 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -29,6 +29,10 @@
#include "CommandDistributor.h"
#include "WiThrottle.h"
#include "DCCTimer.h"
+#include "MDNS_Generic.h"
+
+EthernetUDP udp;
+MDNS mdns(udp);
EthernetInterface * EthernetInterface::singleton=NULL;
/**
@@ -175,6 +179,8 @@ bool EthernetInterface::checkLink() {
server->begin();
LCD(4,F("IP: %d.%d.%d.%d"), ip[0], ip[1], ip[2], ip[3]);
LCD(5,F("Port:%d"), IP_PORT);
+ mdns.begin(Ethernet.localIP(), "dccex"); // hostname
+ mdns.addServiceRecord("dccex._withrottle", 2560, MDNSServiceTCP);
// only create a outboundRing it none exists, this may happen if the cable
// gets disconnected and connected again
if(!outboundRing)
@@ -242,7 +248,11 @@ void EthernetInterface::loop2() {
if (!clients[socket].connected()) { // stop any clients which disconnect
CommandDistributor::forget(socket);
clients[socket].stop();
+ #if defined(ARDUINO_ARCH_AVR)
clients[socket]=NULL;
+ #else
+ clients[socket]=(EthernetClient)nullptr;
+ #endif
//if (Diag::ETHERNET)
DIAG(F("Ethernet: disconnect %d "), socket);
return; // Trick: So that we do not continue in this loop with client that is NULL
@@ -262,6 +272,8 @@ void EthernetInterface::loop2() {
}
}
+ mdns.run();
+
WiThrottle::loop(outboundRing);
// handle at most 1 outbound transmission
diff --git a/EthernetInterface.h b/EthernetInterface.h
index f4f18dd..31780f4 100644
--- a/EthernetInterface.h
+++ b/EthernetInterface.h
@@ -46,7 +46,7 @@
#define MAX_SOCK_NUM 10
#else
#include "Ethernet.h"
- #define MAX_SOCK_NUM 4
+// #define MAX_SOCK_NUM 4
#endif
#include "RingStream.h"
diff --git a/platformio.ini b/platformio.ini
index 93804de..898cda9 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -103,6 +103,7 @@ framework = arduino
lib_deps =
${env.lib_deps}
arduino-libraries/Ethernet
+ MDNS_Generic
SPI
monitor_speed = 115200
monitor_echo = yes
@@ -251,6 +252,7 @@ framework = arduino
lib_deps = ${env.lib_deps}
stm32duino/STM32Ethernet @ ^1.3.0
stm32duino/STM32duino LwIP @ ^2.1.2
+ MDNS_Generic
build_flags = -std=c++17 -Os -g2 -Wunused-variable
monitor_speed = 115200
monitor_echo = yes
@@ -266,6 +268,7 @@ framework = arduino
lib_deps = ${env.lib_deps}
stm32duino/STM32Ethernet @ ^1.3.0
stm32duino/STM32duino LwIP @ ^2.1.2
+ MDNS_Generic
build_flags = -std=c++17 -Os -g2 -Wunused-variable
monitor_speed = 115200
monitor_echo = yes
diff --git a/version.h b/version.h
index 276f2a9..76de326 100644
--- a/version.h
+++ b/version.h
@@ -3,7 +3,8 @@
#include "StringFormatter.h"
-#define VERSION "5.2.27stm32ECvf"
+#define VERSION "5.2.27stm32ECvfmdns"
+// 5.2.XX - MDNS Generic library integration for Ethernet
// 5.2.XX - Variable frequency for DC mode
// 5.2.27 - Bugfix: IOExpander memory allocation
// 5.2.26 - Silently ignore overridden HAL defaults
From d1f558d64f14f7deb294c7293f6c257d7906b522 Mon Sep 17 00:00:00 2001
From: pmantoine
Date: Thu, 1 Feb 2024 19:15:08 +0900
Subject: [PATCH 33/44] Fix Ethernet cable disconnect message
---
EthernetInterface.cpp | 36 +++++++++++++++++++++++-------------
version.h | 1 +
2 files changed, 24 insertions(+), 13 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index b39d5af..8c605e2 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -1,4 +1,6 @@
/*
+ * © 2024 Morten "Doc" Nielsen
+ * © 2023-2024 Paul M. Antoine
* © 2022 Bruno Sanches
* © 2021 Fred Decker
* © 2020-2022 Harald Barth
@@ -174,9 +176,15 @@ bool EthernetInterface::checkLink() {
Ethernet.setLocalIP(myIP); // for static IP, set it again
#endif
#endif
- IPAddress ip = Ethernet.localIP(); // look what IP was obtained (dynamic or static)
server = new EthernetServer(IP_PORT); // Ethernet Server listening on default port IP_PORT
server->begin();
+ IPAddress ip = Ethernet.localIP(); // look what IP was obtained (dynamic or static)
+ if (ip[0] == 0)
+ LCD(4,F("Awaiting DHCP..."));
+ while (ip[0] == 0) { // wait until we are given an IP address from the DHCP server
+ // LCD(4,F("."));
+ ip = Ethernet.localIP(); // look what IP was obtained (dynamic or static)
+ }
LCD(4,F("IP: %d.%d.%d.%d"), ip[0], ip[1], ip[2], ip[3]);
LCD(5,F("Port:%d"), IP_PORT);
mdns.begin(Ethernet.localIP(), "dccex"); // hostname
@@ -184,21 +192,23 @@ bool EthernetInterface::checkLink() {
// only create a outboundRing it none exists, this may happen if the cable
// gets disconnected and connected again
if(!outboundRing)
- outboundRing=new RingStream(OUTBOUND_RING_SIZE);
+ outboundRing=new RingStream(OUTBOUND_RING_SIZE);
}
return true;
- } else { // connected
- DIAG(F("Ethernet cable disconnected"));
- connected=false;
- //clean up any client
- for (byte socket = 0; socket < MAX_SOCK_NUM; socket++) {
- if(clients[socket].connected())
- clients[socket].stop();
+ } else { // LinkOFF
+ if (connected) {
+ DIAG(F("Ethernet cable disconnected"));
+ connected=false;
+ //clean up any client
+ for (byte socket = 0; socket < MAX_SOCK_NUM; socket++) {
+ if(clients[socket].connected())
+ clients[socket].stop();
+ }
+ // tear down server
+ delete server;
+ server = nullptr;
+ LCD(4,F("IP: None"));
}
- // tear down server
- delete server;
- server = nullptr;
- LCD(4,F("IP: None"));
}
return false;
}
diff --git a/version.h b/version.h
index 76de326..e0718f3 100644
--- a/version.h
+++ b/version.h
@@ -4,6 +4,7 @@
#include "StringFormatter.h"
#define VERSION "5.2.27stm32ECvfmdns"
+// 5.2.XX - Fix Ethernet cable disconnected message, wait for DHCP
// 5.2.XX - MDNS Generic library integration for Ethernet
// 5.2.XX - Variable frequency for DC mode
// 5.2.27 - Bugfix: IOExpander memory allocation
From c0f69cd278f5a489f439655135d1b1678b23d51e Mon Sep 17 00:00:00 2001
From: pmantoine
Date: Thu, 1 Feb 2024 20:22:32 +0900
Subject: [PATCH 34/44] mDNS entry now uses IP_PORT and WIFI_HOSTNAME
---
EthernetInterface.cpp | 7 ++++---
1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index 8c605e2..450253d 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -187,8 +187,8 @@ bool EthernetInterface::checkLink() {
}
LCD(4,F("IP: %d.%d.%d.%d"), ip[0], ip[1], ip[2], ip[3]);
LCD(5,F("Port:%d"), IP_PORT);
- mdns.begin(Ethernet.localIP(), "dccex"); // hostname
- mdns.addServiceRecord("dccex._withrottle", 2560, MDNSServiceTCP);
+ mdns.begin(Ethernet.localIP(), WIFI_HOSTNAME); // hostname
+ mdns.addServiceRecord(WIFI_HOSTNAME "._withrottle", IP_PORT, MDNSServiceTCP);
// only create a outboundRing it none exists, this may happen if the cable
// gets disconnected and connected again
if(!outboundRing)
@@ -196,7 +196,7 @@ bool EthernetInterface::checkLink() {
}
return true;
} else { // LinkOFF
- if (connected) {
+ if (connected) { // Were connected, but no longer without a LINK!
DIAG(F("Ethernet cable disconnected"));
connected=false;
//clean up any client
@@ -204,6 +204,7 @@ bool EthernetInterface::checkLink() {
if(clients[socket].connected())
clients[socket].stop();
}
+ mdns.removeServiceRecord(IP_PORT, MDNSServiceTCP);
// tear down server
delete server;
server = nullptr;
From 1fad61b67f5265b6f6a007fbbf2c8c32688c8256 Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Sun, 4 Feb 2024 12:44:16 +0100
Subject: [PATCH 35/44] WiThrottle sendIntro after initial N message as well
---
WiThrottle.cpp | 13 ++++++++-----
1 file changed, 8 insertions(+), 5 deletions(-)
diff --git a/WiThrottle.cpp b/WiThrottle.cpp
index e71c1cd..3e712b3 100644
--- a/WiThrottle.cpp
+++ b/WiThrottle.cpp
@@ -187,6 +187,7 @@ void WiThrottle::parse(RingStream * stream, byte * cmdx) {
}
break;
case 'N': // Heartbeat (2), only send if connection completed by 'HU' message
+ sendIntro(stream);
StringFormatter::send(stream, F("*%d\n"), heartrateSent ? HEARTBEAT_SECONDS : HEARTBEAT_PRELOAD); // return timeout value
break;
case 'M': // multithrottle
@@ -194,7 +195,7 @@ void WiThrottle::parse(RingStream * stream, byte * cmdx) {
break;
case 'H': // send initial connection info after receiving "HU" message
if (cmd[1] == 'U') {
- sendIntro(stream);
+ sendIntro(stream);
}
break;
case 'Q': //
@@ -498,12 +499,14 @@ void WiThrottle::getLocoCallback(int16_t locoid) {
}
void WiThrottle::sendIntro(Print* stream) {
+ if (introSent) // sendIntro only once
+ return;
introSent=true;
StringFormatter::send(stream,F("VN2.0\nHTDCC-EX\nRL0\n"));
- StringFormatter::send(stream,F("HtDCC-EX v%S, %S, %S, %S\n"), F(VERSION), F(ARDUINO_TYPE), DCC::getMotorShieldName(), F(GITHUB_SHA));
- StringFormatter::send(stream,F("PTT]\\[Turnouts}|{Turnout]\\[THROW}|{2]\\[CLOSE}|{4\n"));
- StringFormatter::send(stream,F("PPA%x\n"),TrackManager::getMainPower()==POWERMODE::ON);
- // set heartbeat to 2 seconds because we need to sync the metadata (1 second is too short!)
+ StringFormatter::send(stream,F("HtDCC-EX v%S, %S, %S, %S\n"), F(VERSION), F(ARDUINO_TYPE), DCC::getMotorShieldName(), F(GITHUB_SHA));
+ StringFormatter::send(stream,F("PTT]\\[Turnouts}|{Turnout]\\[THROW}|{2]\\[CLOSE}|{4\n"));
+ StringFormatter::send(stream,F("PPA%x\n"),TrackManager::getMainPower()==POWERMODE::ON);
+ // set heartbeat to 2 seconds because we need to sync the metadata (1 second is too short!)
StringFormatter::send(stream,F("*%d\nHMConnecting..\n"), HEARTBEAT_PRELOAD);
}
From 160eb01b3d54ef00fcd38687fdae67c79f2b07c7 Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Sun, 4 Feb 2024 13:20:53 +0100
Subject: [PATCH 36/44] version 5.3.4
---
GITHUB_SHA.h | 2 +-
version.h | 9 +++++----
2 files changed, 6 insertions(+), 5 deletions(-)
diff --git a/GITHUB_SHA.h b/GITHUB_SHA.h
index aaa555c..d27b1be 100644
--- a/GITHUB_SHA.h
+++ b/GITHUB_SHA.h
@@ -1 +1 @@
-#define GITHUB_SHA "devel-stm32EC 202401280047Z"
+#define GITHUB_SHA "devel-stm32EC 202402041220Z"
diff --git a/version.h b/version.h
index e0718f3..eeae782 100644
--- a/version.h
+++ b/version.h
@@ -3,10 +3,11 @@
#include "StringFormatter.h"
-#define VERSION "5.2.27stm32ECvfmdns"
-// 5.2.XX - Fix Ethernet cable disconnected message, wait for DHCP
-// 5.2.XX - MDNS Generic library integration for Ethernet
-// 5.2.XX - Variable frequency for DC mode
+#define VERSION "5.3.4"
+// 5.3.4 - Bugfix: WiThrottle sendIntro after initial N message as well
+// 5.3.3 - Fix Ethernet cable disconnected message, wait for DHCP
+// 5.3.2 - MDNS Generic library integration for Ethernet
+// 5.3.1 - Variable frequency for DC mode
// 5.2.27 - Bugfix: IOExpander memory allocation
// 5.2.26 - Silently ignore overridden HAL defaults
// - include HAL_IGNORE_DEFAULTS macro in EXRAIL
From 06fb74c3d71a2233bc46f175965a92cf4d56b21f Mon Sep 17 00:00:00 2001
From: Harald Barth
Date: Sun, 4 Feb 2024 13:50:07 +0100
Subject: [PATCH 37/44] remove mega328 from default build env list
---
platformio.ini | 1 -
1 file changed, 1 deletion(-)
diff --git a/platformio.ini b/platformio.ini
index 898cda9..0e42cf7 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -12,7 +12,6 @@
default_envs =
mega2560
uno
- mega328
unowifiR2
nano
samd21-dev-usb
From 7679710c23fd58b67829ee935aa290f7fa42741a Mon Sep 17 00:00:00 2001
From: Ash-4
Date: Sun, 4 Feb 2024 23:23:56 -0600
Subject: [PATCH 38/44] lib_ignore wifi for F429ZI and F439ZI and update
Ethernet disconnect messages
---
EthernetInterface.cpp | 13 +++++++++----
platformio.ini | 10 ++++++++++
2 files changed, 19 insertions(+), 4 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index 450253d..5a76c29 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -182,11 +182,15 @@ bool EthernetInterface::checkLink() {
if (ip[0] == 0)
LCD(4,F("Awaiting DHCP..."));
while (ip[0] == 0) { // wait until we are given an IP address from the DHCP server
- // LCD(4,F("."));
ip = Ethernet.localIP(); // look what IP was obtained (dynamic or static)
}
- LCD(4,F("IP: %d.%d.%d.%d"), ip[0], ip[1], ip[2], ip[3]);
- LCD(5,F("Port:%d"), IP_PORT);
+ if (MAX_MSG_SIZE < 20) {
+ LCD(4,F("%d.%d.%d.%d"), ip[0], ip[1], ip[2], ip[3]);
+ LCD(5,F("Port:%d Eth"), IP_PORT);
+ } else {
+ LCD(4,F("Ethernet UP"));
+ LCD(5,F("%d.%d.%d.%d:%d"), ip[0], ip[1], ip[2], ip[3], IP_PORT);
+ }
mdns.begin(Ethernet.localIP(), WIFI_HOSTNAME); // hostname
mdns.addServiceRecord(WIFI_HOSTNAME "._withrottle", IP_PORT, MDNSServiceTCP);
// only create a outboundRing it none exists, this may happen if the cable
@@ -208,7 +212,8 @@ bool EthernetInterface::checkLink() {
// tear down server
delete server;
server = nullptr;
- LCD(4,F("IP: None"));
+ LCD(4,F("Ethernet DOWN"));
+ LCD(5,F(" "));
}
}
return false;
diff --git a/platformio.ini b/platformio.ini
index 0e42cf7..2bc72a8 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -252,6 +252,11 @@ lib_deps = ${env.lib_deps}
stm32duino/STM32Ethernet @ ^1.3.0
stm32duino/STM32duino LwIP @ ^2.1.2
MDNS_Generic
+lib_ignore = WiFi101
+ WiFi101_Generic
+ WiFiEspAT
+ WiFiMulti_Generic
+ WiFiNINA_Generic
build_flags = -std=c++17 -Os -g2 -Wunused-variable
monitor_speed = 115200
monitor_echo = yes
@@ -268,6 +273,11 @@ lib_deps = ${env.lib_deps}
stm32duino/STM32Ethernet @ ^1.3.0
stm32duino/STM32duino LwIP @ ^2.1.2
MDNS_Generic
+lib_ignore = WiFi101
+ WiFi101_Generic
+ WiFiEspAT
+ WiFiMulti_Generic
+ WiFiNINA_Generic
build_flags = -std=c++17 -Os -g2 -Wunused-variable
monitor_speed = 115200
monitor_echo = yes
From 6253267b5db266b3db643b09b91a5c9ddf7edeb7 Mon Sep 17 00:00:00 2001
From: Ash-4
Date: Mon, 5 Feb 2024 01:06:20 -0600
Subject: [PATCH 39/44] Update WiFi LCD messages
---
WifiESP32.cpp | 17 ++++++++++++-----
WifiInterface.cpp | 16 ++++++++++------
2 files changed, 22 insertions(+), 11 deletions(-)
diff --git a/WifiESP32.cpp b/WifiESP32.cpp
index e45d0e8..aa73675 100644
--- a/WifiESP32.cpp
+++ b/WifiESP32.cpp
@@ -181,7 +181,14 @@ bool WifiESP::setup(const char *SSid,
if (WiFi.status() == WL_CONNECTED) {
// DIAG(F("Wifi STA IP %s"),WiFi.localIP().toString().c_str());
DIAG(F("Wifi in STA mode"));
- LCD(7, F("IP: %s"), WiFi.localIP().toString().c_str());
+ //
+ if (MAX_MSG_SIZE < 20) {
+ LCD(4, F("IP: %s"), WiFi.localIP().toString().c_str());
+ LCD(5,F("PORT=%d WiFi"), IP_PORT);
+ } else {
+ LCD(4, F("WiFi UP"));
+ LCD(5, F("%s:%d"), WiFi.localIP().toString().c_str(), IP_PORT);
+ }
wifiUp = true;
} else {
DIAG(F("Could not connect to Wifi SSID %s"),SSid);
@@ -228,12 +235,12 @@ bool WifiESP::setup(const char *SSid,
havePassword ? password : strPass.c_str(),
channel, false, 8)) {
// DIAG(F("Wifi AP SSID %s PASS %s"),strSSID.c_str(),havePassword ? password : strPass.c_str());
- DIAG(F("Wifi in AP mode"));
- LCD(5, F("Wifi: %s"), strSSID.c_str());
+ DIAG(F("WiFi in AP mode"));
+ LCD(4, F("WiFi: %s"), strSSID.c_str());
+ LCD(5, F("%s:%d"),WiFi.softAPIP().toString().c_str(), IP_PORT);
if (!havePassword)
- LCD(6, F("PASS: %s"),strPass.c_str());
+ LCD(6, F("PASS: %s"),strPass.c_str());
// DIAG(F("Wifi AP IP %s"),WiFi.softAPIP().toString().c_str());
- LCD(7, F("IP: %s"),WiFi.softAPIP().toString().c_str());
wifiUp = true;
APmode = true;
} else {
diff --git a/WifiInterface.cpp b/WifiInterface.cpp
index 9a4b37f..014b7e9 100644
--- a/WifiInterface.cpp
+++ b/WifiInterface.cpp
@@ -166,10 +166,10 @@ wifiSerialState WifiInterface::setup(Stream & setupStream, const FSH* SSid, con
if (wifiState == WIFI_CONNECTED) {
StringFormatter::send(wifiStream, F("ATE0\r\n")); // turn off the echo
checkForOK(200, true);
- DIAG(F("WiFi CONNECTED"));
+ DIAG(F("WiFi UP"));
// LCD already shows IP
} else {
- LCD(4,F("WiFi DISCON."));
+ LCD(4,F("WiFi DOWN"));
}
return wifiState;
}
@@ -366,11 +366,15 @@ wifiSerialState WifiInterface::setup2(const FSH* SSid, const FSH* password,
}
ipString[ipLen]=ipChar;
}
- LCD(4,F("%s"),ipString); // There is not enough room on some LCDs to put a title to this
- }
- // suck up anything after the IP.
+ if (MAX_MSG_SIZE < 20) {
+ LCD(4,F("%s"),ipString); // There is not enough room on some LCDs to put a title to this
+ LCD(5,F("PORT=%d WiFi"),port);
+ } else {
+ LCD(4,F("WiFi UP"));
+ LCD(5,F("%s:%d"), ipString, port);
+ }
+ }
if (!checkForOK(1000, true, false)) return WIFI_DISCONNECTED;
- LCD(5,F("PORT=%d"),port);
return WIFI_CONNECTED;
}
From 78178c2c453e22bd73c9cd7526f22658590b9449 Mon Sep 17 00:00:00 2001
From: Ash-4
Date: Mon, 5 Feb 2024 16:05:43 -0600
Subject: [PATCH 40/44] IP PORT messages on LCD line 4
---
EthernetInterface.cpp | 4 +---
WifiESP32.cpp | 3 +--
WifiInterface.cpp | 3 +--
3 files changed, 3 insertions(+), 7 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index 5a76c29..cc4ab1b 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -188,8 +188,7 @@ bool EthernetInterface::checkLink() {
LCD(4,F("%d.%d.%d.%d"), ip[0], ip[1], ip[2], ip[3]);
LCD(5,F("Port:%d Eth"), IP_PORT);
} else {
- LCD(4,F("Ethernet UP"));
- LCD(5,F("%d.%d.%d.%d:%d"), ip[0], ip[1], ip[2], ip[3], IP_PORT);
+ LCD(4,F("%d.%d.%d.%d:%d"), ip[0], ip[1], ip[2], ip[3], IP_PORT);
}
mdns.begin(Ethernet.localIP(), WIFI_HOSTNAME); // hostname
mdns.addServiceRecord(WIFI_HOSTNAME "._withrottle", IP_PORT, MDNSServiceTCP);
@@ -213,7 +212,6 @@ bool EthernetInterface::checkLink() {
delete server;
server = nullptr;
LCD(4,F("Ethernet DOWN"));
- LCD(5,F(" "));
}
}
return false;
diff --git a/WifiESP32.cpp b/WifiESP32.cpp
index aa73675..a61cd2c 100644
--- a/WifiESP32.cpp
+++ b/WifiESP32.cpp
@@ -186,8 +186,7 @@ bool WifiESP::setup(const char *SSid,
LCD(4, F("IP: %s"), WiFi.localIP().toString().c_str());
LCD(5,F("PORT=%d WiFi"), IP_PORT);
} else {
- LCD(4, F("WiFi UP"));
- LCD(5, F("%s:%d"), WiFi.localIP().toString().c_str(), IP_PORT);
+ LCD(4, F("%s:%d"), WiFi.localIP().toString().c_str(), IP_PORT);
}
wifiUp = true;
} else {
diff --git a/WifiInterface.cpp b/WifiInterface.cpp
index 014b7e9..29a94f2 100644
--- a/WifiInterface.cpp
+++ b/WifiInterface.cpp
@@ -370,8 +370,7 @@ wifiSerialState WifiInterface::setup2(const FSH* SSid, const FSH* password,
LCD(4,F("%s"),ipString); // There is not enough room on some LCDs to put a title to this
LCD(5,F("PORT=%d WiFi"),port);
} else {
- LCD(4,F("WiFi UP"));
- LCD(5,F("%s:%d"), ipString, port);
+ LCD(4,F("%s:%d"), ipString, port);
}
}
if (!checkForOK(1000, true, false)) return WIFI_DISCONNECTED;
From 26b9e1f35f55b57b01ec936956b342d5000c27c5 Mon Sep 17 00:00:00 2001
From: Ash-4
Date: Mon, 5 Feb 2024 17:37:49 -0600
Subject: [PATCH 41/44] LCD IP messages updated plus WiThrottle.cpp Line 137
---
WiThrottle.cpp | 2 +-
WifiESP32.cpp | 15 ++++++++++-----
WifiInterface.cpp | 2 +-
3 files changed, 12 insertions(+), 7 deletions(-)
diff --git a/WiThrottle.cpp b/WiThrottle.cpp
index 3e712b3..56efeeb 100644
--- a/WiThrottle.cpp
+++ b/WiThrottle.cpp
@@ -134,7 +134,7 @@ void WiThrottle::parse(RingStream * stream, byte * cmdx) {
StringFormatter::send(stream,F("*%d\nHMConnected\n"),HEARTBEAT_SECONDS);
}
- }
+ } else sendIntro(stream);
while (cmd[0]) {
switch (cmd[0]) {
diff --git a/WifiESP32.cpp b/WifiESP32.cpp
index a61cd2c..fd2dd7b 100644
--- a/WifiESP32.cpp
+++ b/WifiESP32.cpp
@@ -183,8 +183,8 @@ bool WifiESP::setup(const char *SSid,
DIAG(F("Wifi in STA mode"));
//
if (MAX_MSG_SIZE < 20) {
- LCD(4, F("IP: %s"), WiFi.localIP().toString().c_str());
- LCD(5,F("PORT=%d WiFi"), IP_PORT);
+ LCD(4, F("%s"), WiFi.localIP().toString().c_str());
+ LCD(5,F("Port: %d"), IP_PORT);
} else {
LCD(4, F("%s:%d"), WiFi.localIP().toString().c_str(), IP_PORT);
}
@@ -235,10 +235,15 @@ bool WifiESP::setup(const char *SSid,
channel, false, 8)) {
// DIAG(F("Wifi AP SSID %s PASS %s"),strSSID.c_str(),havePassword ? password : strPass.c_str());
DIAG(F("WiFi in AP mode"));
- LCD(4, F("WiFi: %s"), strSSID.c_str());
- LCD(5, F("%s:%d"),WiFi.softAPIP().toString().c_str(), IP_PORT);
+ if (MAX_MSG_SIZE < 20) {
+ LCD(4, F("%s"), WiFi.softAPIP().toString().c_str());
+ LCD(5, F("Port: %d"), IP_PORT);
+ } else {
+ LCD(4, F("%s:%d"), WiFi.softAPIP().toString().c_str(), IP_PORT);
+ }
+ LCD(6, F("WiFi: %s"), strSSID.c_str());
if (!havePassword)
- LCD(6, F("PASS: %s"),strPass.c_str());
+ LCD(7, F("Pass: %s"),strPass.c_str());
// DIAG(F("Wifi AP IP %s"),WiFi.softAPIP().toString().c_str());
wifiUp = true;
APmode = true;
diff --git a/WifiInterface.cpp b/WifiInterface.cpp
index 29a94f2..1f96998 100644
--- a/WifiInterface.cpp
+++ b/WifiInterface.cpp
@@ -368,7 +368,7 @@ wifiSerialState WifiInterface::setup2(const FSH* SSid, const FSH* password,
}
if (MAX_MSG_SIZE < 20) {
LCD(4,F("%s"),ipString); // There is not enough room on some LCDs to put a title to this
- LCD(5,F("PORT=%d WiFi"),port);
+ LCD(5,F("Port: %d"),port);
} else {
LCD(4,F("%s:%d"), ipString, port);
}
From d591309efd7f2cdebcdc3a9e7d23ce19c7052e37 Mon Sep 17 00:00:00 2001
From: pmantoine
Date: Tue, 20 Feb 2024 14:55:21 +0800
Subject: [PATCH 42/44] Fixes to Ethernet cable handling and STM32
---
EthernetInterface.cpp | 51 +++++++++++++++++++++++++++++--------------
version.h | 3 ++-
2 files changed, 37 insertions(+), 17 deletions(-)
diff --git a/EthernetInterface.cpp b/EthernetInterface.cpp
index cc4ab1b..814cc4f 100644
--- a/EthernetInterface.cpp
+++ b/EthernetInterface.cpp
@@ -47,9 +47,9 @@ void EthernetInterface::setup()
DIAG(F("Prog Error!"));
return;
}
- DIAG(F("Ethernet Class setup, attempting to instantiate"));
+ DIAG(F("Ethernet starting... please be patient, especially if no cable is connected!"));
if ((singleton=new EthernetInterface())) {
- DIAG(F("Ethernet Class initialized"));
+ // DIAG(F("Ethernet Class initialized"));
return;
}
DIAG(F("Ethernet not initialized"));
@@ -83,11 +83,7 @@ EthernetInterface::EthernetInterface()
#ifdef IP_ADDRESS
Ethernet.begin(myIP);
#else
- if (Ethernet.begin() == 0)
- {
- DIAG(F("Ethernet.begin FAILED"));
- return;
- }
+ Ethernet.begin();
#endif // IP_ADDRESS
#else // All other architectures
byte mac[6]= { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
@@ -112,15 +108,22 @@ EthernetInterface::EthernetInterface()
while ((millis() - startmilli) < 5500) { // Loop to give time to check for cable connection
if (Ethernet.linkStatus() == LinkON)
break;
- DIAG(F("Ethernet waiting for link (1sec) "));
+ DIAG(F("Ethernet cable connected? Waiting for link (1sec) "));
delay(1000);
}
- // now we either do have link of we have a W5100
- // where we do not know if we have link. That's
- // the reason to now run checkLink.
- // CheckLinks sets up outboundRing if it does
- // not exist yet as well.
- checkLink();
+ // Now we either do have link or we have a W5100 where we do not know if we have link.
+ // So now run checkLink() which also sets up outboundRing if it does not exist.
+ // A false returned means we know we booted without an Ethernet cable, or perhaps there
+ // is no W5100 and we should say so
+ if (!checkLink())
+ {
+ #if defined(STM32_ETHERNET)
+ DIAG(F("Ethernet cable disconnected!"));
+ #else
+ DIAG(F("Ethernet cable disconnected, or W5100 hardware not present"));
+ #endif
+ LCD(4,F("Ethernet DOWN"));
+ }
}
/**
@@ -176,14 +179,30 @@ bool EthernetInterface::checkLink() {
Ethernet.setLocalIP(myIP); // for static IP, set it again
#endif
#endif
+ #if defined (STM32_ETHERNET)
+ netif_set_hostname(&gnetif, WIFI_HOSTNAME); // Should probably be passed in the contructor...
+ #ifdef IP_ADDRESS
+ Ethernet.begin(myIP);
+ #else
+ Ethernet.begin();
+ #endif // IP_ADDRESS
+ #endif // STM32_ETHERNET
+
server = new EthernetServer(IP_PORT); // Ethernet Server listening on default port IP_PORT
server->begin();
+ #ifndef IP_ADDRESS
+ LCD(4,F("Awaiting DHCP..."));
IPAddress ip = Ethernet.localIP(); // look what IP was obtained (dynamic or static)
- if (ip[0] == 0)
- LCD(4,F("Awaiting DHCP..."));
+ if (ip[0] == 0) {
+ DIAG(F("Awaiting DHCP... ip was %d.%d.%d.%d"), ip[0], ip[1], ip[2], ip[3]);
+ }
while (ip[0] == 0) { // wait until we are given an IP address from the DHCP server
+ DIAG(F("Awaiting DHCP... ip was %d.%d.%d.%d"), ip[0], ip[1], ip[2], ip[3]);
ip = Ethernet.localIP(); // look what IP was obtained (dynamic or static)
}
+ #else
+ IPAddress ip = Ethernet.localIP(); // look what IP was obtained (dynamic or static)
+ #endif
if (MAX_MSG_SIZE < 20) {
LCD(4,F("%d.%d.%d.%d"), ip[0], ip[1], ip[2], ip[3]);
LCD(5,F("Port:%d Eth"), IP_PORT);
diff --git a/version.h b/version.h
index 19e6f96..e37b7bc 100644
--- a/version.h
+++ b/version.h
@@ -3,7 +3,8 @@
#include "StringFormatter.h"
-#define VERSION "5.3.5"
+#define VERSION "5.3.5e"
+// 5.3.5e - Fixes to ethernet cable handling, and STM32 related handling as well
// 5.3.5 - Exrail JMRI_SENSORS(vpin [,count]) creates types.
// 5.3.4 - Bugfix: WiThrottle sendIntro after initial N message as well
// 5.3.3 - Fix Ethernet cable disconnected message, wait for DHCP
From 486e083c1d6b29c6d78d3d0b5728514718168a9d Mon Sep 17 00:00:00 2001
From: Ash-4
Date: Tue, 30 Apr 2024 22:34:30 -0500
Subject: [PATCH 43/44] myCMRI.h example added
---
myCMRI_h_example.txt | 41 +++++++++++++++++++++++++++++++++++++++++
myHal.cpp_example.txt | 10 ++++++++++
version.h | 4 +++-
3 files changed, 54 insertions(+), 1 deletion(-)
create mode 100644 myCMRI_h_example.txt
diff --git a/myCMRI_h_example.txt b/myCMRI_h_example.txt
new file mode 100644
index 0000000..8716a46
--- /dev/null
+++ b/myCMRI_h_example.txt
@@ -0,0 +1,41 @@
+// myCMRI.h to be included in myAutomation.h
+
+// see myHal.cpp_example.txt for explanation of parameters
+
+#include "IO_CMRI.h" // CMRI nodes
+// in config.h #define ARDUINOCMRI_COMPATIBLE
+
+// define CMRI bus
+HAL(CMRIbus, 0, Serial5, 9600, 500, 51)
+
+// define CMRI nodes
+HAL(CMRInode, 900, 72, 0, 4, 'M')
+
+// define the pins - this is S-MINI emulation 24/48 I/O
+// 16 of 24 input pins
+//JMRI_SENSOR(900,16) // broadcast ")
+// ... these pins do not need to be defined unless needed for JMRI
+
+// a testing sequence
+// pin 941 is wired to pin 907. LED on pin 943
+// pin 942 is wired to pin 911.
+// use commands etc.
+AUTOSTART
+SEQUENCE(99)
+ AT(907) SET(943)
+ AT(911) RESET(943)
+FOLLOW(99)
+
+// CMRI sketch used for testing available here
+// https://www.trainboard.com/highball/index.php?threads/24-in-48-out-card-for-jmri.116454/page-2#post-1141569
diff --git a/myHal.cpp_example.txt b/myHal.cpp_example.txt
index 0934723..b1d0cc0 100644
--- a/myHal.cpp_example.txt
+++ b/myHal.cpp_example.txt
@@ -16,6 +16,7 @@
#if !defined(IO_NO_HAL)
// Include devices you need.
+//#include "DCC.h" // for the locoID in updateLocoScreen()
#include "IODevice.h"
//#include "IO_HALDisplay.h" // Auxiliary display devices (LCD/OLED)
//#include "IO_HCSR04.h" // Ultrasonic range sensor
@@ -56,6 +57,10 @@ void halSetup() {
//mySerial2.begin(9600, SERIAL_8N2, 16, 17); // ESP32 to define pins also check DCCTimerESP.cpp
//CMRIbus::create(0, mySerial2, 9600, 500, 4); // for ESP32
+// for F439ZI and others - already defined Serial5(PD2, PC12); // Rx=PD2, Tx=PC12 -- UART5
+// D51 is PD7
+//CMRIbus::create(0, Serial5, 9600, 500, 51);
+
// for Mega
//CMRIbus::create(0, Serial3, 9600, 500, 38); // for Mega - Serial3 already defined
// bus=0 always, unless multiple serial ports are used
@@ -64,6 +69,9 @@ void halSetup() {
// pin.. DE/!RE pins tied together on TTL RS485 module.
// pin 38 should work on Mega and F411RE (pin D38 aka PB12 on CN10_16)
+//CMRInode::create(500, 72, 0, 1, 'M');
+//CMRInode::create(600, 72, 0, 2, 'M');
+//
//CMRInode::create(900, 72, 0, 4, 'M');
//CMRInode::create(1000, 72, 0, 5, 'M');
// bus=0 must agree with bus in CMRIbus
@@ -108,6 +116,8 @@ void halSetup() {
// on screen #3, the first eight entries (assuming an 8-line display)
// from the loco speed table.
+ // Uncomment the line #include "DCC.h" above
+
// Put the following block of code in myHal.cpp OUTSIDE of the
// halSetup() function:
//
diff --git a/version.h b/version.h
index baf04f6..0372f71 100644
--- a/version.h
+++ b/version.h
@@ -3,7 +3,9 @@
#include "StringFormatter.h"
-#define VERSION "5.3.9"
+#define VERSION "5.3.10"
+// 5.3.10 - myCMRI.h example
+
// 5.2.47 - EXRAIL additions:
// STEALTH_GLOBAL
// BLINK
From 5669799c82095f755b764d3f6d60125ff7e7b07b Mon Sep 17 00:00:00 2001
From: Ash-4
Date: Sat, 4 May 2024 16:00:52 -0500
Subject: [PATCH 44/44] mySetup_h_cmri.txt note and brackets added
---
mySetup_h_cmri.txt | 203 +++++++++++++++++++++++----------------------
1 file changed, 105 insertions(+), 98 deletions(-)
diff --git a/mySetup_h_cmri.txt b/mySetup_h_cmri.txt
index 405c3b1..82592e7 100644
--- a/mySetup_h_cmri.txt
+++ b/mySetup_h_cmri.txt
@@ -2,8 +2,15 @@
// defining CMRI accessories
// CMRI connections defined in myHal.cpp
//
+// update 04-May-2024
+// Note: Accessories can be defined in myCMRI.h/myAutomation.h
+// along with the CMRI bus and node definitions (previously in myHal.cpp).
+// An ESP32 command station will need the Serial2 defined in myHal.cpp
+//
+//
+//
// this is for testing.
-SETUP("D CMD 1");
+SETUP("");
// Turnouts defined in myAutomation.h can include descriptions which will appear in Engine Driver
// Sensors and digital outputs do not require pre-definition for use in EXRAIL automation
//
@@ -13,116 +20,116 @@ SETUP("D CMD 1");
// 32 or 48 output pins
//
// Define 16 input pins 1000-1015
-SETUP("S 1000 1000 1");
-SETUP("S 1001 1001 1");
-SETUP("S 1002 1002 1");
-SETUP("S 1003 1003 1");
-SETUP("S 1004 1004 1");
-SETUP("S 1005 1005 1");
-SETUP("S 1006 1006 1");
-SETUP("S 1007 1007 1");
-SETUP("S 1008 1008 1");
-SETUP("S 1009 1009 1");
-SETUP("S 1010 1010 1");
-SETUP("S 1011 1011 1");
-SETUP("S 1012 1012 1");
-SETUP("S 1013 1013 1");
-SETUP("S 1014 1014 1");
-SETUP("S 1015 1015 1");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
//
// define 16 turnouts using VPIN (for Throw/Close commands via CMRI)
-SETUP("T 1024 VPIN 1024");
-SETUP("T 1025 VPIN 1025");
-SETUP("T 1026 VPIN 1026");
-SETUP("T 1027 VPIN 1027");
-SETUP("T 1028 VPIN 1028");
-SETUP("T 1029 VPIN 1029");
-SETUP("T 1030 VPIN 1030");
-SETUP("T 1031 VPIN 1031");
-SETUP("T 1032 VPIN 1032");
-SETUP("T 1033 VPIN 1033");
-SETUP("T 1034 VPIN 1034");
-SETUP("T 1035 VPIN 1035");
-SETUP("T 1036 VPIN 1036");
-SETUP("T 1037 VPIN 1037");
-SETUP("T 1038 VPIN 1038");
-SETUP("T 1039 VPIN 1039");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
//
// define 16 pins for digital outputs
-SETUP("Z 1040 1040 0");
-SETUP("Z 1041 1041 0");
-SETUP("Z 1042 1042 0");
-SETUP("Z 1043 1043 0");
-SETUP("Z 1044 1044 0");
-SETUP("Z 1045 1045 0");
-SETUP("Z 1046 1046 0");
-SETUP("Z 1047 1047 0");
-SETUP("Z 1048 1048 0");
-SETUP("Z 1049 1049 0");
-SETUP("Z 1050 1050 0");
-SETUP("Z 1051 1051 0");
-SETUP("Z 1052 1052 0");
-SETUP("Z 1053 1053 0");
-SETUP("Z 1054 1054 0");
-SETUP("Z 1055 1055 0");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
//
// additional 16 outputs available 1056-1071
-//SETUP("Z 1056 1056 0");
+//SETUP("");
//
// CMRI sketch used for testing available here
// https://www.trainboard.com/highball/index.php?threads/24-in-48-out-card-for-jmri.116454/page-2#post-1141569
//
// Define 16 input pins 900-915
-SETUP("S 900 900 1");
-SETUP("S 901 901 1");
-SETUP("S 902 902 1");
-SETUP("S 903 903 1");
-SETUP("S 904 904 1");
-SETUP("S 905 905 1");
-SETUP("S 906 906 1");
-SETUP("S 907 907 1");
-SETUP("S 908 908 1");
-SETUP("S 909 909 1");
-SETUP("S 910 910 1");
-SETUP("S 911 911 1");
-SETUP("S 912 912 1");
-SETUP("S 913 913 1");
-SETUP("S 914 914 1");
-SETUP("S 915 915 1");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
//
// define 16 turnouts using VPIN (for Throw/Close commands via CMRI)
-SETUP("T 924 VPIN 924");
-SETUP("T 925 VPIN 925");
-SETUP("T 926 VPIN 926");
-SETUP("T 927 VPIN 927");
-SETUP("T 928 VPIN 928");
-SETUP("T 929 VPIN 929");
-SETUP("T 930 VPIN 930");
-SETUP("T 931 VPIN 931");
-SETUP("T 932 VPIN 932");
-SETUP("T 933 VPIN 933");
-SETUP("T 934 VPIN 934");
-SETUP("T 935 VPIN 935");
-SETUP("T 936 VPIN 936");
-SETUP("T 937 VPIN 937");
-SETUP("T 938 VPIN 938");
-SETUP("T 939 VPIN 939");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
//
// define 16 pins for digital outputs
-SETUP("Z 940 940 0");
-SETUP("Z 941 941 0");
-SETUP("Z 942 942 0");
-SETUP("Z 943 943 0");
-SETUP("Z 944 944 0");
-SETUP("Z 945 945 0");
-SETUP("Z 946 946 0");
-SETUP("Z 947 947 0");
-SETUP("Z 948 948 0");
-SETUP("Z 949 949 0");
-SETUP("Z 950 950 0");
-SETUP("Z 951 951 0");
-SETUP("Z 952 952 0");
-SETUP("Z 953 953 0");
-SETUP("Z 954 954 0");
-SETUP("Z 955 955 0");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");
+SETUP("");