/* xsns_23_sdm120.ino - Eastron SDM120-Modbus energy meter support for Sonoff-Tasmota Copyright (C) 2019 Gennaro Tortone 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_SDM120 /*********************************************************************************************\ * Eastron SDM120-Modbus energy meter * * Based on: https://github.com/reaper7/SDM_Energy_Meter \*********************************************************************************************/ #define XSNS_23 23 // can be user defined in my_user_config.h #ifndef SDM120_SPEED #define SDM120_SPEED 2400 // default SDM120 Modbus address #endif // can be user defined in my_user_config.h #ifndef SDM120_ADDR #define SDM120_ADDR 1 // default SDM120 Modbus address #endif #include enum SDM120_Error {SDM120_ERR_NO_ERROR=0, SDM120_ERR_CRC_ERROR, SDM120_ERR_WRONG_BYTES, SDM120_ERR_NOT_ENOUGHT_BYTES}; TasmotaSerial *SDM120Serial; uint8_t sdm120_type = 1; //uint8_t sdm120_state = 0; float sdm120_voltage = 0; float sdm120_current = 0; float sdm120_active_power = 0; float sdm120_apparent_power = 0; float sdm120_reactive_power = 0; float sdm120_power_factor = 0; float sdm120_frequency = 0; float sdm120_energy_total = 0; float sdm120_phase_angle = 0; float sdm120_import_active = 0; float sdm120_export_active = 0; float sdm120_import_reactive = 0; float sdm120_export_reactive = 0; float sdm120_total_reactive = 0; bool SDM120_ModbusReceiveReady(void) { return (SDM120Serial->available() > 1); } void SDM120_ModbusSend(uint8_t function_code, uint16_t start_address, uint16_t register_count) { uint8_t frame[8]; frame[0] = SDM120_ADDR; frame[1] = function_code; frame[2] = (uint8_t)(start_address >> 8); frame[3] = (uint8_t)(start_address); frame[4] = (uint8_t)(register_count >> 8); frame[5] = (uint8_t)(register_count); uint16_t crc = SDM120_calculateCRC(frame, 6); // calculate out crc only from first 6 bytes frame[6] = lowByte(crc); frame[7] = highByte(crc); while (SDM120Serial->available() > 0) { // read serial if any old data is available SDM120Serial->read(); } SDM120Serial->flush(); SDM120Serial->write(frame, sizeof(frame)); } uint8_t SDM120_ModbusReceive(float *value) { uint8_t buffer[9]; *value = NAN; uint8_t len = 0; while (SDM120Serial->available() > 0) { buffer[len++] = (uint8_t)SDM120Serial->read(); } if (len < 9) { return SDM120_ERR_NOT_ENOUGHT_BYTES; } if (9 == len) { if (0x01 == buffer[0] && 0x04 == buffer[1] && 4 == buffer[2]) { // check node number, op code and reply bytes count if((SDM120_calculateCRC(buffer, 7)) == ((buffer[8] << 8) | buffer[7])) { //calculate crc from first 7 bytes and compare with received crc (bytes 7 & 8) ((uint8_t*)value)[3] = buffer[3]; ((uint8_t*)value)[2] = buffer[4]; ((uint8_t*)value)[1] = buffer[5]; ((uint8_t*)value)[0] = buffer[6]; } else { return SDM120_ERR_CRC_ERROR; } } else { return SDM120_ERR_WRONG_BYTES; } } return SDM120_ERR_NO_ERROR; } uint16_t SDM120_calculateCRC(uint8_t *frame, uint8_t num) { uint16_t crc, flag; crc = 0xFFFF; for (uint32_t i = 0; i < num; i++) { crc ^= frame[i]; for (uint32_t j = 8; j; j--) { if ((crc & 0x0001) != 0) { // If the LSB is set crc >>= 1; // Shift right and XOR 0xA001 crc ^= 0xA001; } else { // Else LSB is not set crc >>= 1; // Just shift right } } } return crc; } /*********************************************************************************************/ const uint16_t sdm120_start_addresses[] { 0x0000, // SDM120C_VOLTAGE [V] 0x0006, // SDM120C_CURRENT [A] 0x000C, // SDM120C_POWER [W] 0x0012, // SDM120C_APPARENT_POWER [VA] 0x0018, // SDM120C_REACTIVE_POWER [VAR] 0x001E, // SDM120C_POWER_FACTOR 0x0046, // SDM120C_FREQUENCY [Hz] #ifdef USE_SDM220 0x0156, // SDM120C_TOTAL_ACTIVE_ENERGY [Wh] 0X0024, // SDM220_PHASE_ANGLE [Degre] 0X0048, // SDM220_IMPORT_ACTIVE [kWh] 0X004A, // SDM220_EXPORT_ACTIVE [kWh] 0X004C, // SDM220_IMPORT_REACTIVE [kVArh] 0X004E, // SDM220_EXPORT_REACTIVE [kVArh] 0X0158 // SDM220 TOTAL_REACTIVE [kVArh] #else // USE_SDM220 0x0156 // SDM120C_TOTAL_ACTIVE_ENERGY [Wh] #endif // USE_SDM220 }; uint8_t sdm120_read_state = 0; uint8_t sdm120_send_retry = 0; uint8_t sdm120_nodata_count = 0; void SDM120250ms(void) // Every 250 mSec { // sdm120_state++; // if (6 == sdm120_state) { // Every 300 mSec // sdm120_state = 0; float value = 0; bool data_ready = SDM120_ModbusReceiveReady(); if (data_ready) { sdm120_nodata_count = 0; uint8_t error = SDM120_ModbusReceive(&value); if (error) { AddLog_P2(LOG_LEVEL_DEBUG, PSTR(D_LOG_DEBUG "SDM120 response error %d"), error); } else { switch(sdm120_read_state) { case 0: sdm120_voltage = value; break; case 1: sdm120_current = value; break; case 2: sdm120_active_power = value; break; case 3: sdm120_apparent_power = value; break; case 4: sdm120_reactive_power = value; break; case 5: sdm120_power_factor = value; break; case 6: sdm120_frequency = value; break; case 7: sdm120_energy_total = value; break; #ifdef USE_SDM220 case 8: sdm120_phase_angle = value; break; case 9: sdm120_import_active = value; break; case 10: sdm120_export_active = value; break; case 11: sdm120_import_reactive = value; break; case 12: sdm120_export_reactive = value; break; case 13: sdm120_total_reactive = value; break; #endif // USE_SDM220 } // end switch sdm120_read_state++; if (sizeof(sdm120_start_addresses)/2 == sdm120_read_state) { sdm120_read_state = 0; } } } // end data ready else { if (sdm120_nodata_count <= (1000/250) * 4) { // max. 4 sec without data sdm120_nodata_count++; } else if (sdm120_nodata_count != 255) { // no data from modbus, reset values to 0 sdm120_nodata_count = 255; sdm120_voltage = sdm120_current = sdm120_active_power = sdm120_apparent_power = sdm120_reactive_power = sdm120_power_factor = sdm120_frequency = sdm120_energy_total = 0; #ifdef USE_SDM220 sdm120_phase_angle = sdm120_import_active = sdm120_export_active = sdm120_import_reactive = sdm120_export_reactive = sdm120_total_reactive = 0; #endif } } if (0 == sdm120_send_retry || data_ready) { sdm120_send_retry = 5; SDM120_ModbusSend(0x04, sdm120_start_addresses[sdm120_read_state], 2); } else { sdm120_send_retry--; } // } // end 300 ms } void SDM120Init(void) { sdm120_type = 0; if ((pin[GPIO_SDM120_RX] < 99) && (pin[GPIO_SDM120_TX] < 99)) { SDM120Serial = new TasmotaSerial(pin[GPIO_SDM120_RX], pin[GPIO_SDM120_TX], 1); if (SDM120Serial->begin(SDM120_SPEED)) { if (SDM120Serial->hardwareSerial()) { ClaimSerial(); } sdm120_type = 1; } } } #ifdef USE_WEBSERVER const char HTTP_SNS_SDM120_DATA[] PROGMEM = "{s}SDM120 " D_VOLTAGE "{m}%s " D_UNIT_VOLT "{e}" "{s}SDM120 " D_CURRENT "{m}%s " D_UNIT_AMPERE "{e}" "{s}SDM120 " D_POWERUSAGE_ACTIVE "{m}%s " D_UNIT_WATT "{e}" "{s}SDM120 " D_POWERUSAGE_APPARENT "{m}%s " D_UNIT_VA "{e}" "{s}SDM120 " D_POWERUSAGE_REACTIVE "{m}%s " D_UNIT_VAR "{e}" "{s}SDM120 " D_POWER_FACTOR "{m}%s{e}" "{s}SDM120 " D_FREQUENCY "{m}%s " D_UNIT_HERTZ "{e}" "{s}SDM120 " D_ENERGY_TOTAL "{m}%s " D_UNIT_KILOWATTHOUR "{e}" #ifdef USE_SDM220 "{s}SDM120 " D_PHASE_ANGLE "{m}%s " D_UNIT_ANGLE "{e}" "{s}SDM120 " D_IMPORT_ACTIVE "{m}%s " D_UNIT_KILOWATTHOUR "{e}" "{s}SDM120 " D_EXPORT_ACTIVE "{m}%s " D_UNIT_KILOWATTHOUR "{e}" "{s}SDM120 " D_IMPORT_REACTIVE "{m}%s " D_UNIT_KWARH "{e}" "{s}SDM120 " D_EXPORT_REACTIVE "{m}%s " D_UNIT_KWARH "{e}" "{s}SDM120 " D_TOTAL_REACTIVE "{m}%s " D_UNIT_KWARH "{e}" #endif // USE_SDM220 ; #endif // USE_WEBSERVER void SDM120Show(bool json) { char voltage[33]; dtostrfd(sdm120_voltage, Settings.flag2.voltage_resolution, voltage); char current[33]; dtostrfd(sdm120_current, Settings.flag2.current_resolution, current); char active_power[33]; dtostrfd(sdm120_active_power, Settings.flag2.wattage_resolution, active_power); char apparent_power[33]; dtostrfd(sdm120_apparent_power, Settings.flag2.wattage_resolution, apparent_power); char reactive_power[33]; dtostrfd(sdm120_reactive_power, Settings.flag2.wattage_resolution, reactive_power); char power_factor[33]; dtostrfd(sdm120_power_factor, 2, power_factor); char frequency[33]; dtostrfd(sdm120_frequency, Settings.flag2.frequency_resolution, frequency); char energy_total[33]; dtostrfd(sdm120_energy_total, Settings.flag2.energy_resolution, energy_total); #ifdef USE_SDM220 char phase_angle[33]; dtostrfd(sdm120_phase_angle, 2, phase_angle); char import_active[33]; dtostrfd(sdm120_import_active, Settings.flag2.wattage_resolution, import_active); char export_active[33]; dtostrfd(sdm120_export_active, Settings.flag2.wattage_resolution, export_active); char import_reactive[33]; dtostrfd(sdm120_import_reactive,Settings.flag2.wattage_resolution, import_reactive); char export_reactive[33]; dtostrfd(sdm120_export_reactive,Settings.flag2.wattage_resolution, export_reactive); char total_reactive[33]; dtostrfd(sdm120_total_reactive, Settings.flag2.wattage_resolution, total_reactive); #endif // USE_SDM220 if (json) { #ifdef USE_SDM220 ResponseAppend_P(PSTR(",\"" D_RSLT_ENERGY "\":{\"" D_JSON_TOTAL "\":%s,\"" D_JSON_ACTIVE_POWERUSAGE "\":%s,\"" D_JSON_APPARENT_POWERUSAGE "\":%s,\"" D_JSON_REACTIVE_POWERUSAGE "\":%s,\"" D_JSON_FREQUENCY "\":%s,\"" D_JSON_POWERFACTOR "\":%s,\"" D_JSON_VOLTAGE "\":%s,\"" D_JSON_CURRENT "\":%s,\"" D_JSON_PHASE_ANGLE "\":%s,\"" D_JSON_IMPORT_ACTIVE "\":%s,\"" D_JSON_EXPORT_ACTIVE "\":%s,\"" D_JSON_IMPORT_REACTIVE "\":%s,\"" D_JSON_EXPORT_REACTIVE "\":%s,\"" D_JSON_TOTAL_REACTIVE "\":%s}"), energy_total, active_power, apparent_power, reactive_power, frequency, power_factor, voltage, current, phase_angle, import_active, export_active, import_reactive, export_reactive, total_reactive); #else ResponseAppend_P(PSTR(",\"" D_RSLT_ENERGY "\":{\"" D_JSON_TOTAL "\":%s,\"" D_JSON_ACTIVE_POWERUSAGE "\":%s,\"" D_JSON_APPARENT_POWERUSAGE "\":%s,\"" D_JSON_REACTIVE_POWERUSAGE "\":%s,\"" D_JSON_FREQUENCY "\":%s,\"" D_JSON_POWERFACTOR "\":%s,\"" D_JSON_VOLTAGE "\":%s,\"" D_JSON_CURRENT "\":%s}"), energy_total, active_power, apparent_power, reactive_power, frequency, power_factor, voltage, current); #endif // USE_SDM220 #ifdef USE_DOMOTICZ if (0 == tele_period) { char energy_total_chr[33]; dtostrfd(sdm120_energy_total * 1000, 1, energy_total_chr); DomoticzSensor(DZ_VOLTAGE, voltage); DomoticzSensor(DZ_CURRENT, current); DomoticzSensorPowerEnergy((int)sdm120_active_power, energy_total_chr); } #endif // USE_DOMOTICZ #ifdef USE_WEBSERVER } else { #ifdef USE_SDM220 WSContentSend_PD(HTTP_SNS_SDM120_DATA, voltage, current, active_power, apparent_power, reactive_power, power_factor, frequency, energy_total, phase_angle,import_active,export_active,import_reactive,export_reactive,total_reactive); #else WSContentSend_PD(HTTP_SNS_SDM120_DATA, voltage, current, active_power, apparent_power, reactive_power, power_factor, frequency, energy_total); #endif // USE_SDM220 #endif // USE_WEBSERVER } } /*********************************************************************************************\ * Interface \*********************************************************************************************/ bool Xsns23(uint8_t function) { bool result = false; if (sdm120_type) { switch (function) { case FUNC_INIT: SDM120Init(); break; case FUNC_EVERY_250_MSECOND: SDM120250ms(); break; case FUNC_JSON_APPEND: SDM120Show(1); break; #ifdef USE_WEBSERVER case FUNC_WEB_SENSOR: SDM120Show(0); break; #endif // USE_WEBSERVER } } return result; } #endif // USE_SDM120