#include #include #include "Configuration.h" #include "HardwareSerial.h" #include "PinMapping.h" #include "MessageOutput.h" #include "JbdBmsDataPoints.h" #include "JbdBmsController.h" #include "JbdBmsSerialMessage.h" #include "SerialPortManager.h" #include namespace JbdBms { bool Controller::init(bool verboseLogging) { _verboseLogging = verboseLogging; std::string ifcType = "transceiver"; if (Interface::Transceiver != getInterface()) { ifcType = "TTL-UART"; } MessageOutput.printf("[JBD BMS] Initialize %s interface...\r\n", ifcType.c_str()); const PinMapping_t& pin = PinMapping.get(); MessageOutput.printf("[JBD BMS] rx = %d, rxen = %d, tx = %d, txen = %d\r\n", pin.battery_rx, pin.battery_rxen, pin.battery_tx, pin.battery_txen); if (pin.battery_rx < 0 || pin.battery_tx < 0) { MessageOutput.println("[JBD BMS] Invalid RX/TX pin config"); return false; } #ifdef JBDBMS_DUMMY_SERIAL _upSerial = std::make_unique(); #else auto oHwSerialPort = SerialPortManager.allocatePort(_serialPortOwner); if (!oHwSerialPort) { return false; } _upSerial = std::make_unique(*oHwSerialPort); #endif _upSerial->end(); // make sure the UART will be re-initialized _upSerial->begin(9600, SERIAL_8N1, pin.battery_rx, pin.battery_tx); _upSerial->flush(); if (Interface::Transceiver != getInterface()) { return true; } _rxEnablePin = pin.battery_rxen; _txEnablePin = pin.battery_txen; if (_rxEnablePin < 0 || _txEnablePin < 0) { MessageOutput.println("[JBD BMS] Invalid transceiver pin config"); return false; } pinMode(_rxEnablePin, OUTPUT); pinMode(_txEnablePin, OUTPUT); return true; } void Controller::deinit() { _upSerial->end(); if (_rxEnablePin > 0) { pinMode(_rxEnablePin, INPUT); } if (_txEnablePin > 0) { pinMode(_txEnablePin, INPUT); } SerialPortManager.freePort(_serialPortOwner); } Controller::Interface Controller::getInterface() const { CONFIG_T& config = Configuration.get(); if (0x00 == config.Battery.JkBmsInterface) { return Interface::Uart; } if (0x01 == config.Battery.JkBmsInterface) { return Interface::Transceiver; } return Interface::Invalid; } frozen::string const& Controller::getStatusText(Controller::Status status) { static constexpr frozen::string missing = "programmer error: missing status text"; static constexpr frozen::map texts = { { Status::Timeout, "timeout wating for response from BMS" }, { Status::WaitingForPollInterval, "waiting for poll interval to elapse" }, { Status::HwSerialNotAvailableForWrite, "UART is not available for writing" }, { Status::BusyReading, "busy waiting for or reading a message from the BMS" }, { Status::RequestSent, "request for data sent" }, { Status::FrameCompleted, "a whole frame was received" } }; auto iter = texts.find(status); if (iter == texts.end()) { return missing; } return iter->second; } void Controller::announceStatus(Controller::Status status) { if (_lastStatus == status && millis() < _lastStatusPrinted + 10 * 1000) { return; } MessageOutput.printf("[%11.3f] JBD BMS: %s\r\n", static_cast(millis())/1000, getStatusText(status).data()); _lastStatus = status; _lastStatusPrinted = millis(); } void Controller::sendRequest(uint8_t pollInterval) { if (ReadState::Idle != _readState) { return announceStatus(Status::BusyReading); } if ((millis() - _lastRequest) < pollInterval * 1000) { return announceStatus(Status::WaitingForPollInterval); } if (!_upSerial->availableForWrite()) { return announceStatus(Status::HwSerialNotAvailableForWrite); } SerialCommand::Command cmd; switch (SerialCommand::getLastCommand()) { case SerialCommand::Command::Init: // read only once cmd = SerialCommand::Command::ReadHardwareVersionNumber; break; case SerialCommand::Command::ReadBasicInformation: cmd = SerialCommand::Command::ReadCellVoltages; break; case SerialCommand::Command::ReadCellVoltages: cmd = SerialCommand::Command::ReadBasicInformation; break; default: cmd = SerialCommand::Command::ReadBasicInformation; break; } SerialCommand readCmd(SerialCommand::Status::Read, cmd); if (Interface::Transceiver == getInterface()) { digitalWrite(_rxEnablePin, HIGH); // disable reception (of our own data) digitalWrite(_txEnablePin, HIGH); // enable transmission } _upSerial->write(readCmd.data(), readCmd.size()); if (Interface::Transceiver == getInterface()) { _upSerial->flush(); digitalWrite(_rxEnablePin, LOW); // enable reception digitalWrite(_txEnablePin, LOW); // disable transmission (free the bus) } _lastRequest = millis(); setReadState(ReadState::WaitingForFrameStart); return announceStatus(Status::RequestSent); } void Controller::loop() { CONFIG_T& config = Configuration.get(); uint8_t pollInterval = config.Battery.JkBmsPollingInterval; while (_upSerial->available()) { rxData(_upSerial->read()); } sendRequest(pollInterval); if (millis() > _lastRequest + 2 * pollInterval * 1000 + 250) { reset(); return announceStatus(Status::Timeout); } } void Controller::rxData(uint8_t inbyte) { _buffer.push_back(inbyte); switch(_readState) { case ReadState::Idle: // unsolicited message from BMS case ReadState::WaitingForFrameStart: if (inbyte == SerialMessage::startMarker) { return setReadState(ReadState::FrameStartReceived); } break; case ReadState::FrameStartReceived: return setReadState(ReadState::StateReceived); break; case ReadState::StateReceived: return setReadState(ReadState::CommandCodeReceived); break; case ReadState::CommandCodeReceived: _dataLength = inbyte; if (_dataLength == 0) { return setReadState(ReadState::DataContentReceived); } return setReadState(ReadState::ReadingDataContent); break; case ReadState::ReadingDataContent: _dataLength--; if (_dataLength == 0) { return setReadState(ReadState::DataContentReceived); } return setReadState(ReadState::ReadingDataContent); break; case ReadState::DataContentReceived: return setReadState(ReadState::ReadingCheckSum); break; case ReadState::ReadingCheckSum: return setReadState(ReadState::CheckSumReceived); break; case ReadState::CheckSumReceived: if (inbyte == SerialMessage::endMarker) { return frameComplete(); } MessageOutput.printf("[JBD BMS] Invalid Frame: end marker not found."); MessageOutput.println(); return reset(); break; } reset(); } void Controller::reset() { _buffer.clear(); return setReadState(ReadState::Idle); } void Controller::frameComplete() { announceStatus(Status::FrameCompleted); if (_verboseLogging) { double ts = static_cast(millis())/1000; MessageOutput.printf("[%11.3f] JBD BMS: raw data (%d Bytes):", ts, _buffer.size()); for (size_t ctr = 0; ctr < _buffer.size(); ++ctr) { if (ctr % 16 == 0) { MessageOutput.printf("\r\n[%11.3f] JBD BMS:", ts); } MessageOutput.printf(" %02x", _buffer[ctr]); } MessageOutput.println(); } auto pResponse = std::make_unique(std::move(_buffer)); if (pResponse->isValid()) { processDataPoints(pResponse->getDataPoints()); } // if invalid, error message has been produced by SerialResponse c'tor reset(); } void Controller::processDataPoints(DataPointContainer const& dataPoints) { _stats->updateFrom(dataPoints); if (!_verboseLogging) { return; } auto iter = dataPoints.cbegin(); while ( iter != dataPoints.cend() ) { MessageOutput.printf("[%11.3f] JBD BMS: %s: %s%s\r\n", static_cast(iter->second.getTimestamp())/1000, iter->second.getLabelText().c_str(), iter->second.getValueText().c_str(), iter->second.getUnitText().c_str()); ++iter; } } } /* namespace JbdBms */