/* xsns_87_mcp2515.ino - MCP2515 CAN bus support for Tasmota Copyright (C) 2021 Marius Bezuidenhout This program 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. This program 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 this program. If not, see . */ #ifdef USE_SPI #ifdef USE_MCP2515 #ifdef USE_CANSNIFFER #undef USE_CANSNIFFER #warning **** USE_CANSNIFFER disabled in favour of USE_MCP2515 **** #endif /*********************************************************************************************\ * MCP2515 - Microchip CAN controller * * Connections: * MCP2515 ESP8266 Tasmota * ------- -------------- ---------- * INT not used * SCK GPIO14 SPI CLK * SI GPIO13 SPI MOSI * SO GPIO12 SPI MISO * CS GPIO0..5,15,16 MCP2515 * Gnd Gnd * VCC Vin/5V \*********************************************************************************************/ #define XSNS_87 87 // set defaults if not defined #ifndef MCP2515_BITRATE #define MCP2515_BITRATE CAN_500KBPS #endif #ifndef MCP2515_CLOCK #define MCP2515_CLOCK MCP_8MHZ #endif #ifndef MCP2515_MAX_FRAMES #define MCP2515_MAX_FRAMES 14 #endif #ifndef CAN_KEEP_ALIVE_SECS #define CAN_KEEP_ALIVE_SECS 300 #endif #ifndef MCP2515_TIMEOUT #define MCP2515_TIMEOUT 10 #endif #ifndef MCP2515_BMS_CLIENT #define MCP2515_BMS_CLIENT // Look for SMA or Freedom Won BMS data in CAN message // 11-Bit Identifiers // 500kBit/sec #ifndef MCP2515_BMS_SMA #define MCP2515_BMS_SMA #endif // MCP2515_BMS_SMA #endif // MCP2515_BMS_CLIENT #include "mcp2515.h" #ifdef MCP2515_BMS_CLIENT #define BMS_NAME 0x1 #define BMS_SOC 0x2 #define BMS_SOH 0x4 #define BMS_CHARGE_VOLT_MAX 0x8 #define BMS_CHARGE_VOLT_MIN 0x10 #define BMS_CHARGE_AMP_MAX 0x20 #define BMS_DISCHARGE_AMP_MAX 0x40 #define BMS_VOLT 0x80 #define BMS_AMP 0x100 #define BMS_TEMP 0x200 #define BMS_CAPACITY 0x400 #define BMS_MODEL 0x800 #define BMS_FIRMWARE_VER 0x1000 #define BMS_MANUFACTURER 0x2000 #define BMS_SERIAL 0x4000 #define BMS_MODULES_OK 0x8000 #define BMS_CELL_VOLT_TEMP 0x10000 struct BMS_Struct { uint32_t setFields; // Bitwise fields set list char name[17]; uint16_t stateOfCharge; uint16_t stateOfHealth; uint16_t chargeVoltLimit; // Div 10 uint16_t dischargeVolt; // Div 10 int16_t maxChargeCurrent; // Div 10 int16_t maxDischargeCurrent; // Div 10 uint16_t battVoltage; // Div 100 int16_t battAmp; // Div 10 int16_t battTemp; // Div 10 uint16_t capacityAh; uint16_t model; uint16_t firmwareVer; char manuf[9]; char serialNr[17]; uint16_t nrModulesOk; uint16_t nrModulesBlockingCharge; uint16_t nrModulesBlocking; uint16_t nrModulesOffline; uint16_t minCellVolt; uint16_t maxCellVolt; uint16_t cellTempLow; uint16_t cellTempHigh; } bms; #endif struct MCP2515_Struct { uint32_t lastFrameRecv = 0; int8_t init_status = 0; } Mcp2515; struct can_frame canFrame; MCP2515 *mcp2515 = nullptr; char c2h(char c) { return "0123456789ABCDEF"[0x0F & (unsigned char)c]; } void MCP2515_FrameSizeError(uint8_t len, uint32_t id) { AddLog(LOG_LEVEL_DEBUG, PSTR("CAN: Unexpected length (%d) for ID 0x%x"), len, id); } void MCP2515_Init(void) { if (PinUsed(GPIO_MCP2515_CS, GPIO_ANY) && TasmotaGlobal.spi_enabled) { mcp2515 = new MCP2515(Pin(GPIO_MCP2515_CS, GPIO_ANY)); if (MCP2515::ERROR_OK != mcp2515->reset()) { AddLog(LOG_LEVEL_INFO, PSTR("CAN: Failed to reset module")); return; } if (MCP2515::ERROR_OK != mcp2515->setBitrate(MCP2515_BITRATE, MCP2515_CLOCK)) { AddLog(LOG_LEVEL_INFO, PSTR("CAN: Failed to set module bitrate")); return; } if (MCP2515::ERROR_OK != mcp2515->setNormalMode()) { AddLog(LOG_LEVEL_INFO, PSTR("CAN: Failed to set normal mode")); return; } AddLog(LOG_LEVEL_INFO, PSTR("CAN: Initialized on GPIO%d"), Pin(GPIO_MCP2515_CS, GPIO_ANY)); Mcp2515.init_status = 1; #ifdef MCP2515_BMS_SMA /* mcp2515->setFilterMask(MCP2515::MASK0, false, 0x0200); mcp2515->setFilterMask(MCP2515::MASK1, false, 0x0200); mcp2515->setFilter(MCP2515::RXF0, false, 0x7ff); mcp2515->setFilter(MCP2515::RXF1, false, 0x7ff); mcp2515->setFilter(MCP2515::RXF2, false, 0x7ff); mcp2515->setFilter(MCP2515::RXF3, false, 0x7ff); mcp2515->setFilter(MCP2515::RXF4, false, 0x7ff); mcp2515->setFilter(MCP2515::RXF5, false, 0x7ff); */ #endif } } void MCP2515_Read() { uint8_t nCounter = 0; bool checkRcv; checkRcv = mcp2515->checkReceive(); while (checkRcv && nCounter <= MCP2515_MAX_FRAMES) { mcp2515->checkReceive(); nCounter++; if (mcp2515->readMessage(&canFrame) == MCP2515::ERROR_OK) { Mcp2515.lastFrameRecv = TasmotaGlobal.uptime; #ifdef MCP2515_BMS_CLIENT #ifdef MCP2515_BMS_SMA switch (canFrame.can_id) { // Keep alive from inverter to BMS case 0x305: break; // Charge/Discharge parameters case 0x351: if (8 == canFrame.can_dlc) { bms.chargeVoltLimit = (canFrame.data[1] << 8) | canFrame.data[0]; bms.maxChargeCurrent = (canFrame.data[3] << 8) | canFrame.data[2]; bms.maxDischargeCurrent = (canFrame.data[5] << 8) | canFrame.data[4]; bms.dischargeVolt = (canFrame.data[7] << 8) | canFrame.data[6]; bms.setFields |= BMS_CHARGE_VOLT_MAX | BMS_CHARGE_VOLT_MIN | BMS_CHARGE_AMP_MAX | BMS_DISCHARGE_AMP_MAX; } else { MCP2515_FrameSizeError(canFrame.can_dlc, canFrame.can_id); } break; // State of Charge/Health case 0x355: if (6 >= canFrame.can_dlc) { bms.stateOfCharge = (canFrame.data[1] << 8) | canFrame.data[0]; bms.stateOfHealth = (canFrame.data[3] << 8) | canFrame.data[2]; bms.setFields |= BMS_SOC | BMS_SOH; } else { MCP2515_FrameSizeError(canFrame.can_dlc, canFrame.can_id); } break; // Voltage/Current/Temperature case 0x356: if (6 >= canFrame.can_dlc) { bms.battVoltage = (canFrame.data[1] << 8) | canFrame.data[0]; bms.battAmp = (canFrame.data[3] << 8) | canFrame.data[2]; bms.battTemp = (canFrame.data[5] << 8) | canFrame.data[4]; // Convert to fahrenheit if SetOpion8 is set bms.setFields |= BMS_VOLT | BMS_AMP | BMS_TEMP; } else { MCP2515_FrameSizeError(canFrame.can_dlc, canFrame.can_id); } break; // Alarms case 0x35A: break; // Manufacturer name case 0x35E: for (int i = 0; i < canFrame.can_dlc; i++) { bms.manuf[i] = canFrame.data[i]; } bms.setFields |= BMS_MANUFACTURER; bms.manuf[8] = 0; // Ensure that name is null terminated break; // Battery Model / Firmware version case 0x35F: if (4 == canFrame.can_dlc) { bms.model = (canFrame.data[1] << 8) | canFrame.data[0]; bms.firmwareVer = (canFrame.data[3] << 8) | canFrame.data[2]; bms.setFields |= BMS_MODEL | BMS_FIRMWARE_VER; } else { MCP2515_FrameSizeError(canFrame.can_dlc, canFrame.can_id); } break; // Battery / BMS name case 0x370: case 0x371: for (int i = 0; i < canFrame.can_dlc; i++) { uint8_t nameStrPos = i + ((canFrame.can_id & 0x1) * 8); // If can_id is 0x371 then fill from byte 8 onwards bms.name[nameStrPos] = canFrame.data[i]; } if ((canFrame.can_id & 0x1) && (bms.name[0] > 0)) { // Upper and lower part of name has been set now bms.setFields |= BMS_NAME; } bms.name[16] = 0; // Ensure that name is null terminated break; // Modules status case 0x372: if (4 == canFrame.can_dlc) { bms.nrModulesOk = (canFrame.data[1] << 8) | canFrame.data[0]; bms.nrModulesBlockingCharge = (canFrame.data[3] << 8) | canFrame.data[2]; bms.nrModulesBlocking = (canFrame.data[5] << 8) | canFrame.data[4]; bms.nrModulesOffline = (canFrame.data[7] << 8) | canFrame.data[6]; bms.setFields |= BMS_MODULES_OK; } else { MCP2515_FrameSizeError(canFrame.can_dlc, canFrame.can_id); } break; // Min/Max cell voltage/temperature case 0x373: if (4 == canFrame.can_dlc) { bms.minCellVolt = (canFrame.data[1] << 8) | canFrame.data[0]; bms.maxCellVolt = (canFrame.data[3] << 8) | canFrame.data[2]; bms.cellTempLow = (canFrame.data[5] << 8) | canFrame.data[4]; bms.cellTempHigh = (canFrame.data[7] << 8) | canFrame.data[6]; bms.setFields |= BMS_CELL_VOLT_TEMP; } else { MCP2515_FrameSizeError(canFrame.can_dlc, canFrame.can_id); } break; // Min. cell voltage id string case 0x374: // Max. cell voltage id string case 0x375: // Min. cell temperature id string case 0x376: // Max. cell temperature id string case 0x377: break; // Installed capacity case 0x379: if (2 >= canFrame.can_dlc) { bms.capacityAh = (canFrame.data[1] << 8) | canFrame.data[0]; bms.setFields |= BMS_CAPACITY; } else { MCP2515_FrameSizeError(canFrame.can_dlc, canFrame.can_id); } break; // Serial number case 0x380: case 0x381: for (int i = 0; i < canFrame.can_dlc; i++) { uint8_t serialNrStrPos = i + ((canFrame.can_id & 0x1) * 8); // If can_id is 0x381 then fill from byte 8 onwards bms.serialNr[serialNrStrPos] = canFrame.data[i]; } if ((canFrame.can_id & 0x1) && (bms.serialNr[0] > 0)) { // Upper and lower part of serial number has been set now bms.setFields |= BMS_SERIAL; } bms.serialNr[16] = 0; // Ensure that serial nr is null terminated break; default: char canMsg[17]; canMsg[0] = 0; for (int i = 0; i < canFrame.can_dlc; i++) { canMsg[i*2] = c2h(canFrame.data[i]>>4); canMsg[i*2+1] = c2h(canFrame.data[i]); } if (canFrame.can_dlc > 0) { canMsg[(canFrame.can_dlc - 1) * 2 + 2] = 0; } AddLog(LOG_LEVEL_INFO, PSTR("CAN: Received message 0x%s from ID 0x%x"), canMsg, (uint32_t)canFrame.can_id); break; } #endif // MCP2515_BMS_SMA #endif // MCP2515_BMS_CLIENT } else if (mcp2515->checkError()) { uint8_t errFlags = mcp2515->getErrorFlags(); mcp2515->clearRXnOVRFlags(); AddLog(LOG_LEVEL_DEBUG, PSTR("CAN: Received error %d"), errFlags); } } #ifdef MCP2515_BMS_SMA if (!(TasmotaGlobal.uptime%CAN_KEEP_ALIVE_SECS) && TasmotaGlobal.uptime>60) { canFrame.can_id = 0x305; canFrame.can_dlc = 0; if (MCP2515::ERROR_OK != mcp2515->sendMessage(&canFrame)) { AddLog(LOG_LEVEL_ERROR, PSTR("CAN: Failed to send keep alive frame")); } } #endif } void MCP2515_Show(bool Json) { if (Json) { if (Mcp2515.lastFrameRecv > 0 && TasmotaGlobal.uptime - Mcp2515.lastFrameRecv <= MCP2515_TIMEOUT) { #ifdef MCP2515_BMS_CLIENT if (bms.setFields & BMS_MANUFACTURER) { bool jsonFirstField = true; ResponseAppend_P(PSTR(",\"%s\":{"), bms.manuf); if (bms.setFields & BMS_SOC) { ResponseAppend_P(PSTR("\"SOC\":%d"), bms.stateOfCharge); jsonFirstField = false; } if (bms.setFields & BMS_SOH) { ResponseAppend_P(PSTR("%s\"SOH\":%d"), jsonFirstField ? PSTR("") : PSTR(","), bms.stateOfHealth); jsonFirstField = false; } if (bms.setFields & BMS_VOLT) { ResponseAppend_P(PSTR("%s\"BattVolt\":%d.%d"), jsonFirstField ? PSTR("") : PSTR(","), bms.battVoltage / 100, bms.battVoltage % 100); jsonFirstField = false; } if (bms.setFields & BMS_AMP) { int8_t bmsModNeg = 1; if (bms.battAmp < 0) { bmsModNeg = -1; } ResponseAppend_P(PSTR("%s\"BattAmp\":%d.%d"), jsonFirstField ? PSTR("") : PSTR(","), bms.battAmp / 10, (bms.battAmp % 10) * bmsModNeg); jsonFirstField = false; } if (bms.setFields & BMS_TEMP) { ResponseAppend_P(PSTR("%s\"BattTemp\":%d.%d"), jsonFirstField ? PSTR("") : PSTR(","), bms.battTemp / 10, bms.battTemp % 10); jsonFirstField = false; } if (bms.setFields & BMS_CHARGE_VOLT_MAX) { ResponseAppend_P(PSTR("%s\"MaxVoltage\":%d.%d"), jsonFirstField ? PSTR("") : PSTR(","), bms.chargeVoltLimit / 10, bms.chargeVoltLimit % 10); jsonFirstField = false; } if (bms.setFields & BMS_CHARGE_VOLT_MIN) { ResponseAppend_P(PSTR("%s\"MinVoltage\":%d.%d"), jsonFirstField ? PSTR("") : PSTR(","), bms.dischargeVolt / 10, bms.dischargeVolt % 10); jsonFirstField = false; } if (bms.setFields & BMS_CHARGE_AMP_MAX) { ResponseAppend_P(PSTR("%s\"MaxChargeAmp\":%d.%d"), jsonFirstField ? PSTR("") : PSTR(","), bms.maxChargeCurrent / 10, bms.maxChargeCurrent % 10); jsonFirstField = false; } if (bms.setFields & BMS_DISCHARGE_AMP_MAX) { ResponseAppend_P(PSTR("%s\"MaxDischargeAmp\":%d.%d"), jsonFirstField ? PSTR("") : PSTR(","), bms.maxDischargeCurrent / 10, bms.maxDischargeCurrent % 10); jsonFirstField = false; } ResponseAppend_P(PSTR("}")); } } else { bms.setFields = 0; #endif // MCP2515_BMS_CLIENT } #ifdef USE_WEBSERVER } else { #ifdef MCP2515_BMS_CLIENT if (bms.setFields & BMS_MANUFACTURER) { if (bms.setFields & BMS_SOC) { WSContentSend_PD(HTTP_SNS_SOC, bms.manuf, bms.stateOfCharge); } if (bms.setFields & BMS_SOH) { WSContentSend_PD(HTTP_SNS_SOH, bms.manuf, bms.stateOfHealth); } if (bms.setFields & BMS_VOLT) { WSContentSend_Voltage(bms.manuf, (float(bms.battVoltage) / 100)); } if (bms.setFields & BMS_AMP) { char ampStr[6]; dtostrf((float(bms.battAmp) / 10), 5, 1, ampStr); WSContentSend_PD(PSTR("{s}%s " D_CURRENT "{m}%s " D_UNIT_AMPERE "{e}"), bms.manuf, ampStr); } if (bms.setFields & BMS_TEMP) { WSContentSend_Temp(bms.manuf, ConvertTemp(float(bms.battTemp) / 10)); } if (bms.setFields & BMS_CHARGE_VOLT_MAX) { char voltStr[6]; dtostrf((float(bms.chargeVoltLimit) / 10), 5, 1, voltStr); WSContentSend_PD(PSTR("{s}%s Max Voltage{m}%s " D_UNIT_VOLT "{e}"), bms.manuf, voltStr); } if (bms.setFields & BMS_CHARGE_VOLT_MIN) { char voltStr[6]; dtostrf((float(bms.dischargeVolt) / 10), 5, 1, voltStr); WSContentSend_PD(PSTR("{s}%s Min Voltage{m}%s " D_UNIT_VOLT "{e}"), bms.manuf, voltStr); } if (bms.setFields & BMS_CHARGE_AMP_MAX) { char ampStr[6]; dtostrf((float(bms.maxChargeCurrent) / 10), 5, 1, ampStr); WSContentSend_PD(PSTR("{s}%s Max Charge Current{m}%s " D_UNIT_AMPERE "{e}"), bms.manuf, ampStr); } if (bms.setFields & BMS_DISCHARGE_AMP_MAX) { char ampStr[6]; dtostrf((float(bms.maxDischargeCurrent) / 10), 5, 1, ampStr); WSContentSend_PD(PSTR("{s}%s Max Discharge Current{m}%s " D_UNIT_AMPERE "{e}"), bms.manuf, ampStr); } if (bms.setFields & BMS_MODULES_OK) { WSContentSend_PD(PSTR("{s}%s Modules OK{m}%d {e}"), bms.manuf, bms.nrModulesOk); WSContentSend_PD(PSTR("{s}%s Modules Blocking Charge{m}%d {e}"), bms.manuf, bms.nrModulesBlockingCharge); WSContentSend_PD(PSTR("{s}%s Modules Blocking{m}%d {e}"), bms.manuf, bms.nrModulesBlocking); WSContentSend_PD(PSTR("{s}%s Modules Offline{m}%d {e}"), bms.manuf, bms.nrModulesOffline); } if (bms.setFields & BMS_CELL_VOLT_TEMP) { WSContentSend_PD(PSTR("{s}%s Cell Voltage Min{m}%d " D_UNIT_MILLIVOLT "{e}"), bms.manuf, bms.minCellVolt); WSContentSend_PD(PSTR("{s}%s Cell Voltage Max{m}%d " D_UNIT_MILLIVOLT "{e}"), bms.manuf, bms.maxCellVolt ); WSContentSend_PD(PSTR("{s}%s Cell Temp Low{m}%d " D_UNIT_KELVIN "{e}"), bms.manuf, bms.cellTempLow); WSContentSend_PD(PSTR("{s}%s Cell Temp High{m}%d " D_UNIT_KELVIN "{e}"), bms.manuf, bms.cellTempHigh); } } else { WSContentSend_PD(PSTR("{s}MCP2515 {m} Waiting for data{e}")); } #endif // MCP2515_BMS_CLIENT #endif // USE_WEBSERVER } } /*********************************************************************************************\ * Interface \*********************************************************************************************/ bool Xsns87(uint32_t function) { bool result = false; if (FUNC_INIT == function) { MCP2515_Init(); } else if (Mcp2515.init_status) { switch (function) { case FUNC_EVERY_50_MSECOND: MCP2515_Read(); break; case FUNC_JSON_APPEND: MCP2515_Show(1); break; #ifdef USE_WEBSERVER case FUNC_WEB_SENSOR: MCP2515_Show(0); break; #endif // USE_WEBSERVER } } return result; } #endif // USE_MCP2515 #endif // USE_SPI