mirror of
https://github.com/DCC-EX/CommandStation-EX.git
synced 2024-11-30 03:26:13 +01:00
134 lines
4.4 KiB
C++
134 lines
4.4 KiB
C++
/*
|
|
* © 2020, Chris Harlow. All rights reserved.
|
|
* © 2020, Harald Barth.
|
|
*
|
|
* This file is part of Asbelos DCC API
|
|
*
|
|
* This is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* It is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with CommandStation. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
#ifndef DCCWaveform_h
|
|
#define DCCWaveform_h
|
|
#include "MotorDriver.h"
|
|
#include "ArduinoTimers.h"
|
|
|
|
// Wait times for power management. Unit: milliseconds
|
|
const int POWER_SAMPLE_ON_WAIT = 100;
|
|
const int POWER_SAMPLE_OFF_WAIT = 1000;
|
|
const int POWER_SAMPLE_OVERLOAD_WAIT = 20;
|
|
|
|
// Ack time thresholds. Unit: microseconds
|
|
const int MIN_ACK_PULSE_DURATION = 2000;
|
|
const int MAX_ACK_PULSE_DURATION = 8500;
|
|
|
|
// Number of preamble bits.
|
|
const int PREAMBLE_BITS_MAIN = 16;
|
|
const int PREAMBLE_BITS_PROG = 22;
|
|
|
|
|
|
|
|
const byte MAX_PACKET_SIZE = 12;
|
|
// NOTE: static functions are used for the overall controller, then
|
|
// one instance is created for each track.
|
|
|
|
|
|
enum class POWERMODE { OFF, ON, OVERLOAD };
|
|
|
|
const byte idlePacket[] = {0xFF, 0x00, 0xFF};
|
|
const byte resetPacket[] = {0x00, 0x00, 0x00};
|
|
|
|
class DCCWaveform {
|
|
public:
|
|
DCCWaveform( byte preambleBits, bool isMain);
|
|
static void begin(MotorDriver * mainDriver, MotorDriver * progDriver, byte timerNumber);
|
|
static void setDiagnosticSlowWave(bool slow);
|
|
static void loop();
|
|
static DCCWaveform mainTrack;
|
|
static DCCWaveform progTrack;
|
|
|
|
void beginTrack();
|
|
void setPowerMode(POWERMODE);
|
|
POWERMODE getPowerMode();
|
|
void checkPowerOverload();
|
|
int getLastCurrent();
|
|
void schedulePacket(const byte buffer[], byte byteCount, byte repeats);
|
|
volatile bool packetPending;
|
|
volatile byte sentResetsSincePacket;
|
|
volatile bool autoPowerOff=false;
|
|
void setAckBaseline(); //prog track only
|
|
void setAckPending(); //prog track only
|
|
byte getAck(); //prog track only 0=NACK, 1=ACK 2=keep waiting
|
|
static bool progTrackSyncMain; // true when prog track is a siding switched to main
|
|
static bool progTrackBoosted; // true when prog track is not current limited
|
|
inline void doAutoPowerOff() {
|
|
if (autoPowerOff) {
|
|
setPowerMode(POWERMODE::OFF);
|
|
autoPowerOff=false;
|
|
}
|
|
};
|
|
inline void setAckLimit(int mA) {
|
|
ackLimitmA = mA;
|
|
}
|
|
|
|
private:
|
|
static VirtualTimer * interruptTimer;
|
|
static void interruptHandler();
|
|
bool interrupt1();
|
|
void interrupt2();
|
|
void checkAck();
|
|
void setSignal(bool high);
|
|
|
|
bool isMainTrack;
|
|
MotorDriver* motorDriver;
|
|
// Transmission controller
|
|
byte transmitPacket[MAX_PACKET_SIZE]; // packet being transmitted
|
|
byte transmitLength;
|
|
byte transmitRepeats; // remaining repeats of transmission
|
|
byte remainingPreambles;
|
|
byte requiredPreambles;
|
|
bool currentBit; // bit to be transmitted
|
|
byte bits_sent; // 0-8 (yes 9 bits) sent for current byte
|
|
byte bytes_sent; // number of bytes sent from transmitPacket
|
|
byte state; // wave generator state machine
|
|
|
|
byte pendingPacket[MAX_PACKET_SIZE];
|
|
byte pendingLength;
|
|
byte pendingRepeats;
|
|
int lastCurrent;
|
|
|
|
|
|
// current sampling
|
|
POWERMODE powerMode;
|
|
unsigned long lastSampleTaken;
|
|
unsigned int sampleDelay;
|
|
// Trip current for programming track, 250mA. Change only if you really
|
|
// need to be non-NMRA-compliant because of decoders that are not either.
|
|
static const int TRIP_CURRENT_PROG=250;
|
|
unsigned long power_sample_overload_wait = POWER_SAMPLE_OVERLOAD_WAIT;
|
|
unsigned int power_good_counter = 0;
|
|
|
|
// ACK management (Prog track only)
|
|
volatile bool ackPending;
|
|
volatile bool ackDetected;
|
|
int ackThreshold;
|
|
int ackLimitmA = 60;
|
|
int ackMaxCurrent;
|
|
unsigned long ackCheckStart; // millis
|
|
unsigned int ackCheckDuration; // millis
|
|
|
|
unsigned int ackPulseDuration; // micros
|
|
unsigned long ackPulseStart; // micros
|
|
|
|
};
|
|
#endif
|