From ab8823a80d2d7b323dfcb20e646052a5e9e00ee8 Mon Sep 17 00:00:00 2001 From: Ton Huisman Date: Tue, 5 Aug 2025 22:41:26 +0200 Subject: [PATCH 01/10] [P102] Add support for PZEM-017v1 --- lib/PZEM-004T-v30-master/PZEM004Tv30.cpp | 200 ++++++++++++++++++----- lib/PZEM-004T-v30-master/PZEM004Tv30.h | 35 +++- src/_P102_PZEM004Tv3.ino | 74 ++++++--- 3 files changed, 238 insertions(+), 71 deletions(-) diff --git a/lib/PZEM-004T-v30-master/PZEM004Tv30.cpp b/lib/PZEM-004T-v30-master/PZEM004Tv30.cpp index fd834487f..13c500f40 100644 --- a/lib/PZEM-004T-v30-master/PZEM004Tv30.cpp +++ b/lib/PZEM-004T-v30-master/PZEM004Tv30.cpp @@ -14,6 +14,10 @@ #define REG_PF 0x0008 #define REG_ALARM 0x0009 +#define REG_CURRENT 0x0001 +#define REG_HVALARM 0x0006 +#define REG_LVALARM 0x0007 + #define CMD_RHR 0x03 #define CMD_RIR 0X04 #define CMD_WSR 0x06 @@ -24,6 +28,9 @@ #define WREG_ALARM_THR 0x0001 #define WREG_ADDR 0x0002 +#define WREG_HV_ALARM_THR 0x0000 +#define WREG_LV_ALARM_THR 0x0001 + #define UPDATE_TIME 200 #define RESPONSE_SIZE 32 @@ -84,6 +91,23 @@ PZEM004Tv30::~PZEM004Tv30() // delete this->_serial; } + +void PZEM004Tv30::setModel(PZEM_model model) { + if (model == _model) { + return; + } + _model = model; + switch (_model) { + case PZEM_model::PZEM004Tv30: + _expectedResponse = PZEM004Tv30_EXPECTED_RESPONSE; + _requestRegisters = PZEM004Tv30_REQUEST_REGISTERS; + break; + case PZEM_model::PZEM017Tv1: + _expectedResponse = PZEM017v1_EXPECTED_RESPONSE; + _requestRegisters = PZEM017v1_REQUEST_REGISTERS; + break; + } +} /*! * PZEM004Tv30::voltage * * Get line voltage in Volts * * @return current L-N volage*/ @@ -222,28 +246,97 @@ uint8_t PZEM004Tv30::getAddress() * Set power alarm threshold in watts * * @param[in] watts Alamr theshold * * @return success*/ -bool PZEM004Tv30::setPowerAlarm(uint16_t watts) -{ - if (watts > 25000){ // Sanitych check - watts = 25000; - } +// bool PZEM004Tv30::setPowerAlarm(uint16_t watts) +// { +// if (watts > 25000){ // Sanitych check +// watts = 25000; +// } - // Write the watts threshold to the Alarm register - if(!sendCmd8(CMD_WSR, WREG_ALARM_THR, watts, true)) - return false; - return true; -} +// // Write the watts threshold to the Alarm register +// if(!sendCmd8(CMD_WSR, WREG_ALARM_THR, watts, true)) +// return false; +// return true; +// } /*! * PZEM004Tv30::getPowerAlarm * * Is the power alarm set * * * @return arlam triggerd*/ -bool PZEM004Tv30::getPowerAlarm() -{ - if(!updateValues()) // Update vales if necessary - return NAN; // Update did not work, return NAN +// bool PZEM004Tv30::getPowerAlarm() +// { +// if(!updateValues()) // Update vales if necessary +// return NAN; // Update did not work, return NAN + +// return _currentValues.alarms != 0x0000; +// } + + /*! + * PZEM004Tv30::setHighVoltAlarm + * Set HV alarm threshold in volts + * @param[in] volt Alarm theshold + * @return success */ +// bool PZEM004Tv30::setHighvoltAlarm(uint16_t volts) +// { +// if (volts < 500){ // Sanity check +// volts = 500; +// } + +// if (volts > 34999){ // Sanity check +// volts = 34999; +// } + +// // Write the volts threshold to the alarm register +// if(!sendCmd8(CMD_WSR, WREG_HV_ALARM_THR, volts, true)) +// return false; + +// return true; +// } + +/*! + * PZEM004Tv30::setLowVoltAlarm + * Set LV alarm threshold in volts + * @param[in] volt Alarm theshold + * @return success */ +// bool PZEM004Tv30::setLowvoltAlarm(uint16_t volts) +// { +// if (volts < 100){ // Sanity check +// volts = 100; +// } + +// if (volts > 34999){ // Sanity check +// volts = 34999; +// } + +// // Write the volts threshold to the alarm register +// if(!sendCmd8(CMD_WSR, WREG_LV_ALARM_THR, volts, true)) +// return false; + +// return true; +// } + +/*! + * PZEM004Tv30::isHighVoltAlarmOn GET + * Is the HV alarm set + * @return alarm triggerd*/ +// bool PZEM004Tv30::isHighvoltAlarmOn() +// { +// if(!updateValues()) // Update vales if necessary +// return NAN; // Update did not work, return NAN + +// return _currentValues.HVAlarms != 0x0000; +// } + +/*! + * PZEM004Tv30::isLowVoltAlarmOn GET + * Is the LV alarm set + * @return alarm triggerd*/ +// bool PZEM004Tv30::isLowvoltAlarmOn() +// { +// if(!updateValues()) // Update vales if necessary +// return NAN; // Update did not work, return NAN + +// return _currentValues.LVAlarms != 0x0000; +// } - return _currentValues.alarms != 0x0000; -} /*! * PZEM004Tv30::init * * initialization common to all consturctors * @@ -266,52 +359,75 @@ void PZEM004Tv30::init(uint8_t addr){ * @return success*/ bool PZEM004Tv30::updateValues() { - //static uint8_t buffer[] = {0x00, CMD_RIR, 0x00, 0x00, 0x00, 0x0A, 0x00, 0x00}; - static uint8_t response[25]; - // If we read before the update time limit, do not update if(_lastRead + UPDATE_TIME > millis()){ return true; } - // Read 10 registers starting at 0x00 (no check) - sendCmd8(CMD_RIR, 0x00, 0x0A, false); + // Read registers starting at 0x00 (no check) + sendCmd8(CMD_RIR, 0x00, _requestRegisters, false); - if(recieve(response, 25) != 25){ // Something went wrong + if(recieve(_response, _expectedResponse) != _expectedResponse){ // Something went wrong return false; } // Update the current values - _currentValues.voltage = ((uint32_t)response[3] << 8 | // Raw voltage in 0.1V - (uint32_t)response[4])/10.0; + switch(_model) { + case PZEM_model::PZEM004Tv30: + _currentValues.voltage = ((uint32_t)_response[3] << 8 | // Raw voltage in 0.1V + (uint32_t)_response[4]) / 10.0; - _currentValues.current = ((uint32_t)response[5] << 8 | // Raw current in 0.001A - (uint32_t)response[6] | - (uint32_t)response[7] << 24 | - (uint32_t)response[8] << 16) / 1000.0; + _currentValues.current = ((uint32_t)_response[5] << 8 | // Raw current in 0.001A + (uint32_t)_response[6] | + (uint32_t)_response[7] << 24 | + (uint32_t)_response[8] << 16) / 1000.0; - _currentValues.power = ((uint32_t)response[9] << 8 | // Raw power in 0.1W - (uint32_t)response[10] | - (uint32_t)response[11] << 24 | - (uint32_t)response[12] << 16) / 10.0; + _currentValues.power = ((uint32_t)_response[9] << 8 | // Raw power in 0.1W + (uint32_t)_response[10] | + (uint32_t)_response[11] << 24 | + (uint32_t)_response[12] << 16) / 10.0; - _currentValues.energy = ((uint32_t)response[13] << 8 | // Raw Energy in 1Wh - (uint32_t)response[14] | - (uint32_t)response[15] << 24 | - (uint32_t)response[16] << 16) / 1000.0; + _currentValues.energy = ((uint32_t)_response[13] << 8 | // Raw Energy in 1Wh + (uint32_t)_response[14] | + (uint32_t)_response[15] << 24 | + (uint32_t)_response[16] << 16) / 1000.0; - _currentValues.frequeny =((uint32_t)response[17] << 8 | // Raw Frequency in 0.1Hz - (uint32_t)response[18]) / 10.0; + _currentValues.frequeny =((uint32_t)_response[17] << 8 | // Raw Frequency in 0.1Hz + (uint32_t)_response[18]) / 10.0; - _currentValues.pf = ((uint32_t)response[19] << 8 | // Raw pf in 0.01 - (uint32_t)response[20])/100.0; + _currentValues.pf = ((uint32_t)_response[19] << 8 | // Raw pf in 0.01 + (uint32_t)_response[20]) / 100.0; - _currentValues.alarms = ((uint32_t)response[21] << 8 | // Raw alarm value - (uint32_t)response[22]); + _currentValues.alarms = ((uint32_t)_response[21] << 8 | // Raw alarm value + (uint32_t)_response[22]); + break; + case PZEM_model::PZEM017Tv1: + _currentValues.voltage = ((uint32_t)_response[3] << 8 | // Raw voltage in 0.01V + (uint32_t)_response[4]) / 100.0; + _currentValues.current = ((uint32_t)_response[5] << 8 | // Raw voltage in 0.01A + (uint32_t)_response[6]) / 100.0; + + _currentValues.power = ((uint32_t)_response[7] << 8 | // Raw power in 0.1W + (uint32_t)_response[8] | + (uint32_t)_response[9] << 24 | + (uint32_t)_response[10] << 16) / 10.0; + + _currentValues.energy = ((uint32_t)_response[11] << 8 | // Raw Energy in 1Wh + (uint32_t)_response[12] | + (uint32_t)_response[13] << 24 | + (uint32_t)_response[14] << 16) / 1000.0; + + _currentValues.HVAlarms = ((uint32_t)_response[15] << 8 | // Raw alarm value + (uint32_t)_response[16]); + + _currentValues.LVAlarms = ((uint32_t)_response[17] << 8 | // Raw alarm value + (uint32_t)_response[18]); + break; + } // Record current time as _lastRead _lastRead = millis(); diff --git a/lib/PZEM-004T-v30-master/PZEM004Tv30.h b/lib/PZEM-004T-v30-master/PZEM004Tv30.h index 6579b0418..c5a65e9c3 100644 --- a/lib/PZEM-004T-v30-master/PZEM004Tv30.h +++ b/lib/PZEM-004T-v30-master/PZEM004Tv30.h @@ -28,9 +28,20 @@ #include #endif +#define PZEM004Tv30_EXPECTED_RESPONSE 25 +#define PZEM004Tv30_REQUEST_REGISTERS 10 + +#define PZEM017v1_EXPECTED_RESPONSE 21 +#define PZEM017v1_REQUEST_REGISTERS 8 #define PZEM_DEFAULT_ADDR 0xF8 +#define PZEM_MAX_EXPECTED_RESPONSE 25 // PZEM004v30 needs this buffer size, adjust for models that need a bigger buffer + +enum class PZEM_model : uint8_t { + PZEM004Tv30 = 0, // Buffer size 25, request 10 registers + PZEM017Tv1 = 1, // Buffer size 21, request 8 registers +}; class PZEM004Tv30 { @@ -40,6 +51,7 @@ public: #endif ~PZEM004Tv30(); + void setModel(PZEM_model model); // Sets some communication buffer params float voltage(); float current(); @@ -52,8 +64,14 @@ public: bool setAddress(uint8_t addr); uint8_t getAddress(); - bool setPowerAlarm(uint16_t watts); - bool getPowerAlarm(); + // Unused methods: + // bool setPowerAlarm(uint16_t watts); + // bool getPowerAlarm(); + + // bool setHighvoltAlarm(uint16_t volts); //moja uprava + // bool setLowvoltAlarm(uint16_t volts); //moja uprava + // bool isHighvoltAlarmOn(); //upravil som + // bool isLowvoltAlarmOn(); //upravil som bool resetEnergy(); void init(uint8_t addr); // Init common to all constructors @@ -64,15 +82,22 @@ private: bool _isSoft; // Is serial interface software uint8_t _addr; // Device address + PZEM_model _model = PZEM_model::PZEM004Tv30; // Current default + + uint8_t _response[PZEM_MAX_EXPECTED_RESPONSE]; + uint8_t _expectedResponse = PZEM004Tv30_EXPECTED_RESPONSE; + uint8_t _requestRegisters = PZEM004Tv30_REQUEST_REGISTERS; struct { float voltage; float current; float power; float energy; - float frequeny; - float pf; - uint16_t alarms; + float frequeny; // PZEM004 + float pf; // PZEM004 + uint16_t alarms; // PZEM004 + uint16_t HVAlarms; //upravil som PZEM017 + uint16_t LVAlarms; //upravil sOM PZEM017 } _currentValues; // Measured values uint64_t _lastRead; // Last time values were updated diff --git a/src/_P102_PZEM004Tv3.ino b/src/_P102_PZEM004Tv3.ino index 545d5471e..a2fd17e5e 100644 --- a/src/_P102_PZEM004Tv3.ino +++ b/src/_P102_PZEM004Tv3.ino @@ -8,6 +8,8 @@ // /** Changelog: + * 2025-08-05 tonhuisman: Add support for PZEM-017v1 from a forum suggestion: + * https://www.letscontrolit.com/forum/viewtopic.php?p=74069#p74064 * 2025-01-17 tonhuisman: Implement support for MQTT AutoDiscovery (partially) * 2025-01-12 tonhuisman: Add support for MQTT AutoDiscovery (not supported yet for PZEM00x) */ @@ -21,7 +23,7 @@ # define PLUGIN_102 # define PLUGIN_ID_102 102 # define PLUGIN_102_DEBUG true // activate extra log info in the debug -# define PLUGIN_NAME_102 "Energy (AC) - PZEM-004Tv30-Multiple" +# define PLUGIN_NAME_102 "Energy (AC) - PZEM-004Tv30 / PZEM-017v1" # define P102_PZEM_mode PCONFIG(1) // 0=read value ; 1=reset energy; 2=programm address # define P102_PZEM_ADDR PCONFIG(2) @@ -32,6 +34,7 @@ # define P102_QUERY4 PCONFIG(6) # define P102_PZEM_FIRST PCONFIG(7) # define P102_PZEM_ATTEMPT PCONFIG_LONG(1) +# define P102_PZEM_TYPE PCONFIG_LONG(0) # define P102_PZEM_mode_DFLT 0 // Read value # define P102_QUERY1_DFLT 0 // Voltage (V) @@ -44,6 +47,10 @@ # define P102_PZEM_MAX_ATTEMPT 3 // Number of tentative before declaring NAN value +# define P102_PZEM004_VALUE_COUNT 6 +# define P102_PZEM017_VALUE_COUNT 4 + + PZEM004Tv30 * P102_PZEM_sensor = nullptr; boolean Plugin_102_init = false; @@ -56,7 +63,7 @@ const __FlashStringHelper* p102_getQueryString(uint8_t query); boolean Plugin_102(uint8_t function, struct EventStruct *event, String& string) { - boolean success = false; + bool success = false; switch (function) { @@ -126,6 +133,7 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even case PLUGIN_WEBFORM_SHOW_CONFIG: { string += serialHelper_getSerialTypeLabel(event); + string += strformat(F("
addr: 0x%02x"), P102_PZEM_ADDR); // Show modbus address success = true; break; } @@ -134,14 +142,17 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even { // To select the data in the 4 fields. const __FlashStringHelper *options[P102_NR_OUTPUT_OPTIONS]; + const uint8_t nrOptions = PZEM_model::PZEM004Tv30 == static_cast(P102_PZEM_TYPE) + ? P102_PZEM004_VALUE_COUNT + : P102_PZEM017_VALUE_COUNT; - for (uint8_t i = 0; i < P102_NR_OUTPUT_OPTIONS; ++i) { + for (uint8_t i = 0; i < nrOptions; ++i) { options[i] = p102_getQueryString(i); } for (uint8_t i = 0; i < P102_NR_OUTPUT_VALUES; ++i) { const uint8_t pconfigIndex = i + P102_QUERY1_CONFIG_POS; - sensorTypeHelper_loadOutputSelector(event, pconfigIndex, i, P102_NR_OUTPUT_OPTIONS, options); + sensorTypeHelper_loadOutputSelector(event, pconfigIndex, i, nrOptions, options); } success = true; @@ -149,7 +160,19 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even break; } - case PLUGIN_WEBFORM_LOAD: { + case PLUGIN_WEBFORM_LOAD: + { + { + const __FlashStringHelper*pzemModels[] = { + F("PZEM004Tv30"), + F("PZEM017v1"), + }; + constexpr int pzemCount = NR_ELEMENTS(pzemModels); + FormSelectorOptions selector(pzemCount, pzemModels); + selector.reloadonchange = true; + selector.addFormSelector(F("PZEM Model"), F("pztype"), P102_PZEM_TYPE); + } + if (P102_PZEM_sensor == nullptr) { P102_PZEM_FIRST = event->TaskIndex; // To detect if first PZEM or not } @@ -168,8 +191,8 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even if (P102_PZEM_mode == 2) { - addHtml(F("
When programming an address, only one PZEMv30 must be connected. " - "Otherwise, all connected PZEMv30s will get the same address, which would cause a conflict during reading.")); + addHtml(F("
When programming an address, only one PZEM must be connected. " + "Otherwise, all connected PZEMs will get the same address, which would cause a conflict during reading.")); { const __FlashStringHelper *options_confirm[] = { F("NO"), F("YES") }; constexpr size_t optionCount = NR_ELEMENTS(options_confirm); @@ -182,7 +205,7 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even else { addFormNumericBox(F("Address of PZEM"), F("PZEM_addr"), P102_PZEM_ADDR, 0, 247); - addHtml(F(" Address 0 allows to communicate with any single PZEMv30 whatever its address")); + addHtml(F(" Address 0 allows to communicate with any single PZEM whatever its address")); } if (P102_PZEM_ADDR_SET == 3) // If address programming done @@ -216,7 +239,8 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even break; } - case PLUGIN_WEBFORM_SAVE: { + case PLUGIN_WEBFORM_SAVE: + { serialHelper_webformSave(event); // Save output selector parameters. @@ -225,6 +249,7 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even const uint8_t choice = PCONFIG(pconfigIndex); sensorTypeHelper_saveOutputSelector(event, pconfigIndex, i, p102_getQueryString(choice)); } + P102_PZEM_TYPE = getFormItemInt(F("pztype")); P102_PZEM_mode = getFormItemInt(F("PZEM_mode")); P102_PZEM_ADDR = getFormItemInt(F("PZEM_addr")); P102_PZEM_ADDR_SET = getFormItemInt(F("PZEM_addr_set")); @@ -346,13 +371,18 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even // FIXME TD-er: Calling these functions is probably done within the 200 msec timeout used in the library. // If not, this should be cached in a task data struct. - string += LoRa_addFloat(P102_PZEM_sensor->voltage(), PackedData_int16_1e1); - string += LoRa_addFloat(P102_PZEM_sensor->current(), PackedData_int32_1e3); - string += LoRa_addFloat(P102_PZEM_sensor->power(), PackedData_int32_1e1); - string += LoRa_addFloat(P102_PZEM_sensor->energy(), PackedData_int32_1e1); - string += LoRa_addFloat(P102_PZEM_sensor->pf(), PackedData_uint16_1e2); - string += LoRa_addFloat(P102_PZEM_sensor->frequency() - 40, PackedData_uint8_1e1); - event->Par1 = 6; // valuecount + string += LoRa_addFloat(P102_PZEM_sensor->voltage(), PackedData_int16_1e1); + string += LoRa_addFloat(P102_PZEM_sensor->current(), PackedData_int32_1e3); + string += LoRa_addFloat(P102_PZEM_sensor->power(), PackedData_int32_1e1); + string += LoRa_addFloat(P102_PZEM_sensor->energy(), PackedData_int32_1e1); + + if (PZEM_model::PZEM004Tv30 == static_cast(P102_PZEM_TYPE)) { + string += LoRa_addFloat(P102_PZEM_sensor->pf(), PackedData_uint16_1e2); + string += LoRa_addFloat(P102_PZEM_sensor->frequency() - 40, PackedData_uint8_1e1); + event->Par1 = P102_PZEM004_VALUE_COUNT; // valuecount + } else { + event->Par1 = P102_PZEM017_VALUE_COUNT; // valuecount + } success = true; break; @@ -366,14 +396,10 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even { const String command = parseString(string, 1); - if ((equals(command, F("resetenergy"))) && (P102_PZEM_FIRST == event->TaskIndex)) - { - if ((event->Par1 >= 0) && (event->Par1 <= 247)) - { - P102_PZEM_sensor->init(event->Par1); - P102_PZEM_sensor->resetEnergy(); - success = true; - } + if (equals(command, F("resetenergy")) && (event->Par1 >= 0) && (event->Par1 <= 247)) { + P102_PZEM_sensor->init(event->Par1); + P102_PZEM_sensor->resetEnergy(); + success = true; } } From de5acb32656a2bd9681da6d4077d0862a3781d7e Mon Sep 17 00:00:00 2001 From: Ton Huisman Date: Wed, 6 Aug 2025 15:51:21 +0200 Subject: [PATCH 02/10] [P102] UI updates and corrections --- src/_P102_PZEM004Tv3.ino | 35 ++++++++++++++++++++--------------- 1 file changed, 20 insertions(+), 15 deletions(-) diff --git a/src/_P102_PZEM004Tv3.ino b/src/_P102_PZEM004Tv3.ino index a2fd17e5e..22f431a69 100644 --- a/src/_P102_PZEM004Tv3.ino +++ b/src/_P102_PZEM004Tv3.ino @@ -3,11 +3,12 @@ #ifdef USES_P102 // ####################################################################################################### -// #################################### Plugin 102: PZEM004T v30 with modbus mgt########################## +// ######################## Plugin 102: PZEM004Tv30 / PZEM-017v1 with modbus mgt ######################## // ####################################################################################################### // /** Changelog: + * 2025-08-06 tonhuisman: Change plugin name to "Energy - PZEM-004T (AC) / PZEM-017 (DC)" * 2025-08-05 tonhuisman: Add support for PZEM-017v1 from a forum suggestion: * https://www.letscontrolit.com/forum/viewtopic.php?p=74069#p74064 * 2025-01-17 tonhuisman: Implement support for MQTT AutoDiscovery (partially) @@ -23,7 +24,7 @@ # define PLUGIN_102 # define PLUGIN_ID_102 102 # define PLUGIN_102_DEBUG true // activate extra log info in the debug -# define PLUGIN_NAME_102 "Energy (AC) - PZEM-004Tv30 / PZEM-017v1" +# define PLUGIN_NAME_102 "Energy - PZEM-004T (AC) / PZEM-017 (DC)" # define P102_PZEM_mode PCONFIG(1) // 0=read value ; 1=reset energy; 2=programm address # define P102_PZEM_ADDR PCONFIG(2) @@ -164,8 +165,8 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even { { const __FlashStringHelper*pzemModels[] = { - F("PZEM004Tv30"), - F("PZEM017v1"), + F("PZEM-004Tv30 (AC)"), + F("PZEM-017v1 (DC)"), }; constexpr int pzemCount = NR_ELEMENTS(pzemModels); FormSelectorOptions selector(pzemCount, pzemModels); @@ -183,7 +184,7 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even "don't use HW serial (or invert Tx and Rx to configure as SW serial).")); addFormSubHeader(F("PZEM actions")); { - const __FlashStringHelper *options_model[] = { F("Read_value"), F("Reset_Energy"), F("Program_adress") }; + const __FlashStringHelper *options_model[] = { F("Read value"), F("Reset Energy"), F("Program address") }; constexpr size_t optionCount = NR_ELEMENTS(options_model); const FormSelectorOptions selector(optionCount, options_model); selector.addFormSelector(F("PZEM Mode"), F("PZEM_mode"), P102_PZEM_mode); @@ -204,13 +205,13 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even } else { - addFormNumericBox(F("Address of PZEM"), F("PZEM_addr"), P102_PZEM_ADDR, 0, 247); - addHtml(F(" Address 0 allows to communicate with any single PZEM whatever its address")); + addFormNumericBox(F("Address of PZEM"), F("PZEM_addr"), P102_PZEM_ADDR, 0x00, 0xF7); + addHtml(F(" Address 0 allows to communicate with any single PZEM whatever its address")); } if (P102_PZEM_ADDR_SET == 3) // If address programming done { - addHtml(F("
Address programming done ! ")); + addHtml(F("
Address programming done ! ")); P102_PZEM_ADDR_SET = 0; // Reset programming confirmation } } @@ -218,23 +219,23 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even { addFormSubHeader(F("PZEM actions")); { - const __FlashStringHelper *options_model[] = { F("Read_value"), F("Reset_Energy") }; + const __FlashStringHelper *options_model[] = { F("Read value"), F("Reset Energy") }; constexpr size_t optionCount = NR_ELEMENTS(options_model); const FormSelectorOptions selector(optionCount, options_model); selector.addFormSelector(F("PZEM Mode"), F("PZEM_mode"), P102_PZEM_mode); } - addHtml(F(" Tx/Rx Pins config disabled: Configuration is available in the first PZEM plugin.
")); - addFormNumericBox(F("Address of PZEM"), F("PZEM_addr"), P102_PZEM_ADDR, 1, 247); + addHtml(F(" Tx/Rx Pins config ignored: Configuration is available in the first PZEM plugin.
")); + addFormNumericBox(F("Address of PZEM"), F("PZEM_addr"), P102_PZEM_ADDR, 0x01, 0xF7); } - addHtml(F("

Reset energy can be done also by: http://*espeasyip*/control?cmd=resetenergy,*PZEM address*")); - if (P102_PZEM_ADDR_SET == 4) { addHtml(F("
Energy reset on current PZEM ! ")); P102_PZEM_ADDR_SET = 0; // Reset programming confirmation } + addFormNote(F("Reset Energy can also be done by: http://*espeasyip*/control?cmd=resetenergy,*PZEM address*")); + success = true; break; } @@ -357,10 +358,14 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even # if FEATURE_PACKED_RAW_DATA case PLUGIN_GET_PACKED_RAW_DATA: { - // Matching JS code: + // Matching JS code for PZEM-004T: // return decode(bytes, [header, int16_1e1, int32_1e3, int32_1e1, int32_1e1, uint16_1e2, uint8_1e1], // ['header', 'voltage', 'current', 'power', 'energy', 'powerfactor', 'frequency']); // + // Matching JS code for PZEM-017: + // return decode(bytes, [header, int16_1e1, int32_1e3, int32_1e1, int32_1e1], + // ['header', 'voltage', 'current', 'power', 'energy']); + // // Resolutions: // Voltage: 0.1V => int16_1e1 (range 80-260V) // Current: 0.001A => int32_1e3 @@ -417,7 +422,7 @@ const __FlashStringHelper* p102_getQueryString(uint8_t query) { case 2: return F("Power_W"); case 3: return F("Energy_kWh"); case 4: return F("Power_Factor_cosphi"); - case 5: return F("Frequency Hz"); + case 5: return F("Frequency_Hz"); } return F(""); } From 98db7e78bf334e39913cf9447ef15a6012a83b1d Mon Sep 17 00:00:00 2001 From: Ton Huisman Date: Wed, 6 Aug 2025 15:51:40 +0200 Subject: [PATCH 03/10] [P102] Add documentation --- docs/source/Plugin/P102.rst | 217 +++++++++++++++++- .../Plugin/P102_DeviceConfiguration.png | Bin 0 -> 83858 bytes docs/source/Plugin/P102_ProgramAddress.png | Bin 0 -> 20505 bytes docs/source/Plugin/P102_ResetEnergyDone.png | Bin 0 -> 13403 bytes .../Plugin/P102_SecondConfiguration.png | Bin 0 -> 18325 bytes docs/source/Plugin/P102_commands.repl | 15 ++ docs/source/Plugin/_plugin_categories.repl | 4 +- .../Plugin/_plugin_substitutions_p10x.repl | 10 +- 8 files changed, 238 insertions(+), 8 deletions(-) create mode 100644 docs/source/Plugin/P102_DeviceConfiguration.png create mode 100644 docs/source/Plugin/P102_ProgramAddress.png create mode 100644 docs/source/Plugin/P102_ResetEnergyDone.png create mode 100644 docs/source/Plugin/P102_SecondConfiguration.png create mode 100644 docs/source/Plugin/P102_commands.repl diff --git a/docs/source/Plugin/P102.rst b/docs/source/Plugin/P102.rst index 12030e886..9d93c1dfb 100644 --- a/docs/source/Plugin/P102.rst +++ b/docs/source/Plugin/P102.rst @@ -24,7 +24,7 @@ Used libraries: |P102_usedlibraries| Description ----------- -PZEM-004T V3.0 or Version 3.0 is the upgraded version to replace the old PZEM004T V1.0. +PZEM-004T (AC) V3.0 or Version 3.0 is the upgraded version to replace the old PZEM004T V1.0. The old version has been sold out in most of the online store and is no longer being produced. Improvements over V1: @@ -99,18 +99,231 @@ Active Energy * Resolution: 1Wh * Measurement accuracy: 0.5% +Description +----------- + +PZEM-017 v1.0/v2.0 (DC) For measuring DC loads. When the voltage is below 7V, an independent (**not from PC USB port!**) USB powersupply should be used on the USB input connector. + +Specifications +-------------- + +Voltage +^^^^^^^ + +* Measuring range: 0.05 - 300V +* Resolution: 0.01V +* Measurement accuracy: 1% + +Current +^^^^^^^ + +* Measuring range: + + * 0.02 - 50/100/200/300A(Depending on shunt) + +* Resolution: 0.01A + +* Measurement accuracy: 1% + + +Active power +^^^^^^^^^^^^ + +* Measuring range: + + * 0.2 - 90kW(Depending on shunt) + +* Starting measure power: 0.2W +* Resolution: 0.1W +* Measurement accuracy: 1% + + +Active Energy +^^^^^^^^^^^^^ + +* Measuring range: 0 - 9999.99kWh +* Resolution: 1Wh +* Measurement accuracy: 1% + +Installation and configuration +------------------------------ + +When installing multiple PZEM devices on a single ESP unit, some specific order of configuration is required to be able to correctly configure a second, third, etc. PZEM. + +This is described below, in the :cyan:`Installing multiple PZEM units on a single ESP` paragraph. + +Configuration +------------- + +.. image:: P102_DeviceConfiguration.png + +Task Settings +^^^^^^^^^^^^^ + +* **Name**: Required by ESPEasy, must be unique among the list of available devices/tasks. + +* **Enabled**: The device can be disabled or enabled. When not enabled the device should not use any resources. + Sensor ^^^^^^ See: :ref:`SerialHelper_page` +Device Settings +^^^^^^^^^^^^^^^ + +* **PZEM Model**: Select the PZEM model that is to be handled by this task. (For changing the Address the model doesn't matter as they use the same command.) + +Available options: + +* *PZEM-004Tv30 (AC)*: The AC model, and default setting. +* *PZEM-017v1 (DC)*: The DC model. Also compatible with later v2/2.0 models. + +For reading the correct values from a PZEM-017, that Model *must* be selected as it uses a different data format to fetch the results. + +PZEM Actions +^^^^^^^^^^^^ + +* **PZEM Mode**: By default, the ``Read value`` option is selected. + +Available options: + +* *Read value*: Normal operating mode, for reading the configured values from the PZEM. +* *Reset Energy*: For resetting the counted total energy, this option can be selected. See below for a description. +* *Program address*: Only available on the *first* PZEM device, for changing the PZEM unit MODBUS address, as described below. + +| + +* **Address of PZEM**: Set to the address of the PZEM unit to be used. When only a single device is connected, can be set to 0, as a sort of 'universal' address. + +Available address range for the *first* PZEM device: 0 .. 247, on subsequent PZEM devices: 1 .. 247. + +Output Configuration +^^^^^^^^^^^^^^^^^^^^ + +For all 4 available Values slots for this task, a value to use can be selected here. The available options depend om the **PZEM Model** setting: + +* *Voltage_V* +* *Current_A* +* *Power_W* +* *Energy_kWh* +* *Power_Factor_cosphi*: for ``PZEM-004Tv30 (AC)`` only. +* *Frequency_Hz*: for ``PZEM-004Tv30 (AC)`` only. + .. include:: DataAcquisition.repl +* **Interval**: By default, Interval will be set to 60 sec for this plugin. It is the frequency used to read sensor values and send these to any Controllers configured for this device. + +Values +^^^^^^ + +The measured values are configured above, and get their names based on the selection made there. + +For a complete description of all available columns see the `Plugin - Values <_Plugin.html#values>`_ section. + +| + + .. Events .. ~~~~~~ .. .. include:: P102_events.repl +Resetting the Energy counter +---------------------------- + +For resetting the counted Energy value in the PZEM unit, there are 2 methods: + +1. Use the *Reset Energy* **PZEM Mode** setting. +2. Send the command ``resetenergy,`` to the ESP unit. This can be done via the Command entry on the Tools page, from Rules, or via a url command as shown in the configuration page. + +Use the *Reset Energy* **PZEM Mode** setting +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +For resetting the incrementing Energy counter in the PZEM unit, this PZEM Mode option can be used. + +* Set **PZEM Mode** to ``Reset Energy``, and :cyan:`Submit` the page. + +The command will be executed immediately, and afterward the status will shown: + +.. image:: P102_ResetEnergyDone.png + +The blue message showing that the command was sent. The **PZEM Mode** is already reset to ``Read value``. + +Installing multiple PZEM units on a single ESP +---------------------------------------------- + +Configuring separate MODBUS addresses on each device +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To uniquely identify each PZEM unit on the bus, it has to be configured to use a unique address. The range of these addresses is 1 .. 247. + +* Add the, numerically, first PZEM task, f.e. in Devices slot 1. + +* Configure the serial port, and on ESP32 also the GPIO pins, to be used, enable the plugin, and connect a single PZEM to the RS485 converter. When using ``HW Serial0``, the Serial Console Settings, on the Tools/Advanced page, have to be disabled to avoid issues with his port. + +* Set **PZEM Mode** to ``Program address`` and :cyan:`Submit` the page. + +.. image:: P102_ProgramAddress.png + +Fill the desired address in the **Address of PZEM** field, change the **Confirm address programming ?** field to ``YES``, and again :cyan:`Submit` the page. + +When successful, a message :green:`Address programming done !` is displayed, and the **PZEM Mode** is set to the default ``Read value`` setting. + +* Disconnect the PZEM unit from the RS485 bus, connect the next PZEM unit, and repeat above steps, using a diferent **Address of PZEM** value, for all units to be connected. + +N.B.: The last set Address of PZEM will be kept in the configuration, but can be changed to the desired first PZEM unit. + +N.B.2: To correctly store the **PZEM Mode** setting, the configuration should be saved once more, using the :cyan:`Submit` button! + +Configuring a secondary PZEM unit +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The first PZEM unit can be configured as shown above in the generic Configuration paragraph. Once thats completed, with the correct, unique, MODBUS Address set, both in all PZEM units to connect and the task configuration for the first PZEM task, that task should be Enabled, so the next task added can detect that it will be the second (or third, etc.) device on the MODBUS chain. + +After that task is running, a new PZEM task can be added, with a task number higher than the *first* PZEM task. + +.. warning:: This is crucial for the PZEM tasks to start correctly, and in the correct order, on reboot or power-up of the ESP! + +These secondary PZEM tasks do not use the Serial configuration, as they use the same connection as the *first* PZEM task. + +.. image:: P102_SecondConfiguration.png + +Sensor +^^^^^^ + +This selector should not be used, as it is ignored. + +Device Settings +^^^^^^^^^^^^^^^ + +* **PZEM Model**: Select the PZEM model that is to be handled by this task. (Changing the selection will save the new setting and reload the page.) + +For reading the correct values from a PZEM-017, that Model *must* be selected as it uses a different data format to fetch the results. + +PZEM Actions +^^^^^^^^^^^^ + +* **PZEM Mode**: By default, the ``Read value`` option is selected. + +Available options: + +* *Read value*: Normal operating mode, for reading the configured values from the PZEM. +* *Reset Energy*: For resetting the counted total energy, this option can be selected. See above for a description. + +* **Address of PZEM**: Set to the address of the PZEM unit to be used. + +Available address range: 1 .. 247. + +When using the same address as the *first* PZEM task, and the **PZEM Model** connected is a ``PZEM-004Tv30 (AC)``, the extra values ``Power_Factor_cosphi`` and ``Frequency_Hz`` can be made available in a task, for sending to a controller. + +| + +Commands +-------- + +.. include:: P102_commands.repl + Change log @@ -119,4 +332,6 @@ Change log .. versionchanged:: 2.0 ... + |added| 2025-08-06: Support for PZEM-017, updated documentation. + |added| 2020-04-25 diff --git a/docs/source/Plugin/P102_DeviceConfiguration.png b/docs/source/Plugin/P102_DeviceConfiguration.png new file mode 100644 index 0000000000000000000000000000000000000000..95b8c81d4a8352653b57ecab60a43cd9fd657275 GIT binary patch literal 83858 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 H=m-A-P=^vE literal 0 HcmV?d00001 diff --git a/docs/source/Plugin/P102_ResetEnergyDone.png b/docs/source/Plugin/P102_ResetEnergyDone.png new file mode 100644 index 0000000000000000000000000000000000000000..c5d3f366e5c07379dde01d67a5549bd3b03d3b57 GIT binary patch literal 13403 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 J+wVsHopavv=aWmX+}!tk+su4t=KGns^YjkL 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 Date: Fri, 8 Aug 2025 10:15:05 +0200 Subject: [PATCH 04/10] [P102] Small typo in documentation --- docs/source/Plugin/P102_commands.repl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/Plugin/P102_commands.repl b/docs/source/Plugin/P102_commands.repl index f8d8a7f35..caac65d7e 100644 --- a/docs/source/Plugin/P102_commands.repl +++ b/docs/source/Plugin/P102_commands.repl @@ -4,7 +4,7 @@ " - | ``ResetEnergy,`` "," From f9c7ffc8f35ccd18c745abb51e9196232fa6afc8 Mon Sep 17 00:00:00 2001 From: Ton Huisman Date: Sat, 23 Aug 2025 11:28:38 +0200 Subject: [PATCH 05/10] [P102] Don't check non-available values for NaN --- src/_P102_PZEM004Tv3.ino | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/src/_P102_PZEM004Tv3.ino b/src/_P102_PZEM004Tv3.ino index 22f431a69..627988306 100644 --- a/src/_P102_PZEM004Tv3.ino +++ b/src/_P102_PZEM004Tv3.ino @@ -331,12 +331,15 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even PZEM[4] = P102_PZEM_sensor->pf(); PZEM[5] = P102_PZEM_sensor->frequency(); - for (uint8_t i = 0; i < 6; i++) // Check each PZEM field + // Skip non-available values + const uint8_t toCheckMax = PZEM_model::PZEM004Tv30 == static_cast(P102_PZEM_TYPE) ? 6 : 4; + + for (uint8_t i = 0; i < toCheckMax; i++) // Check each PZEM field { - if (PZEM[i] != PZEM[i]) // Check if NAN + if (PZEM[i] != PZEM[i]) // Check if NAN { P102_PZEM_ATTEMPT == P102_PZEM_MAX_ATTEMPT ? P102_PZEM_ATTEMPT = 0 : P102_PZEM_ATTEMPT++; - break; // if one is Not A Number, break + break; // if one is Not A Number, break } P102_PZEM_ATTEMPT = 0; } @@ -376,13 +379,13 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even // FIXME TD-er: Calling these functions is probably done within the 200 msec timeout used in the library. // If not, this should be cached in a task data struct. - string += LoRa_addFloat(P102_PZEM_sensor->voltage(), PackedData_int16_1e1); - string += LoRa_addFloat(P102_PZEM_sensor->current(), PackedData_int32_1e3); - string += LoRa_addFloat(P102_PZEM_sensor->power(), PackedData_int32_1e1); - string += LoRa_addFloat(P102_PZEM_sensor->energy(), PackedData_int32_1e1); + string += LoRa_addFloat(P102_PZEM_sensor->voltage(), PackedData_int16_1e1); + string += LoRa_addFloat(P102_PZEM_sensor->current(), PackedData_int32_1e3); + string += LoRa_addFloat(P102_PZEM_sensor->power(), PackedData_int32_1e1); + string += LoRa_addFloat(P102_PZEM_sensor->energy(), PackedData_int32_1e1); if (PZEM_model::PZEM004Tv30 == static_cast(P102_PZEM_TYPE)) { - string += LoRa_addFloat(P102_PZEM_sensor->pf(), PackedData_uint16_1e2); + string += LoRa_addFloat(P102_PZEM_sensor->pf(), PackedData_uint16_1e2); string += LoRa_addFloat(P102_PZEM_sensor->frequency() - 40, PackedData_uint8_1e1); event->Par1 = P102_PZEM004_VALUE_COUNT; // valuecount } else { From 9ab134106d4d295a6911032675266ac8d118c365 Mon Sep 17 00:00:00 2001 From: Ton Huisman Date: Sat, 23 Aug 2025 11:29:10 +0200 Subject: [PATCH 06/10] [P102] Correct documentation small typos --- docs/source/Plugin/P102_commands.repl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/Plugin/P102_commands.repl b/docs/source/Plugin/P102_commands.repl index caac65d7e..1ebe20567 100644 --- a/docs/source/Plugin/P102_commands.repl +++ b/docs/source/Plugin/P102_commands.repl @@ -10,6 +10,6 @@ | This command will reset the Energy counter for the PZEM unit (value is stored in the unit). The value retrieved on the next read should return the updated value. (Can be 0 if no energy is flowing, or the energy counted since the reset command was executed.) - | This command can be executed by any task is multiple PZEM tasks are configured, as they all share the same MODBUS Serial configuration of the *first* PZEM task. + | This command can be executed by any task if multiple PZEM tasks are configured, as they all share the single MODBUS Serial configuration of the *first* PZEM task. " From 339d8f88750b0021e351a87ba6bd467f73c4c075 Mon Sep 17 00:00:00 2001 From: Ton Huisman Date: Thu, 11 Sep 2025 20:24:55 +0200 Subject: [PATCH 07/10] [P102] Use added setModel() method when needed --- src/_P102_PZEM004Tv3.ino | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/_P102_PZEM004Tv3.ino b/src/_P102_PZEM004Tv3.ino index 78daa90d3..58069b228 100644 --- a/src/_P102_PZEM004Tv3.ino +++ b/src/_P102_PZEM004Tv3.ino @@ -289,6 +289,7 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even if (P102_PZEM_sensor != nullptr) { P102_PZEM_sensor->init(P102_PZEM_ADDR); + P102_PZEM_sensor->setModel(static_cast(P102_PZEM_TYPE)); // Sequence for reseting PZEM energy if (P102_PZEM_mode == 1) @@ -323,6 +324,7 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even { // When new data is available, return true P102_PZEM_sensor->init(P102_PZEM_ADDR); + P102_PZEM_sensor->setModel(static_cast(P102_PZEM_TYPE)); float PZEM[6]; PZEM[0] = P102_PZEM_sensor->voltage(); From eb8e0e46c787f6b127d2e942985d1b8001acdbf2 Mon Sep 17 00:00:00 2001 From: Ton Huisman Date: Sat, 13 Sep 2025 13:09:25 +0200 Subject: [PATCH 08/10] [P102] Use defined constants --- src/_P102_PZEM004Tv3.ino | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/_P102_PZEM004Tv3.ino b/src/_P102_PZEM004Tv3.ino index 58069b228..61d59afa5 100644 --- a/src/_P102_PZEM004Tv3.ino +++ b/src/_P102_PZEM004Tv3.ino @@ -335,7 +335,9 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even PZEM[5] = P102_PZEM_sensor->frequency(); // Skip non-available values - const uint8_t toCheckMax = PZEM_model::PZEM004Tv30 == static_cast(P102_PZEM_TYPE) ? 6 : 4; + const uint8_t toCheckMax = PZEM_model::PZEM004Tv30 == static_cast(P102_PZEM_TYPE) + ? P102_PZEM004_VALUE_COUNT + : P102_PZEM017_VALUE_COUNT; for (uint8_t i = 0; i < toCheckMax; i++) // Check each PZEM field { From 659e5e50fa0b99aa01e8e0d7c0f62ecf8c2028c1 Mon Sep 17 00:00:00 2001 From: Ton Huisman Date: Sun, 14 Sep 2025 15:32:10 +0200 Subject: [PATCH 09/10] [P102] Add Submit instruction after use of 'Reset energy' mode --- src/_P102_PZEM004Tv3.ino | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/_P102_PZEM004Tv3.ino b/src/_P102_PZEM004Tv3.ino index 61d59afa5..38ef4e59f 100644 --- a/src/_P102_PZEM004Tv3.ino +++ b/src/_P102_PZEM004Tv3.ino @@ -8,6 +8,7 @@ // /** Changelog: + * 2025-09-14 tonhuisman: Add extra instruction to submit page once more after 'Reset energy' is used, to save 'Read energy' default Mode. * 2025-08-06 tonhuisman: Change plugin name to "Energy - PZEM-004T (AC) / PZEM-017 (DC)" * 2025-08-05 tonhuisman: Add support for PZEM-017v1 from a forum suggestion: * https://www.letscontrolit.com/forum/viewtopic.php?p=74069#p74064 @@ -232,6 +233,7 @@ boolean Plugin_102(uint8_t function, struct EventStruct *even if (P102_PZEM_ADDR_SET == 4) { addHtml(F("
Energy reset on current PZEM ! ")); + addHtml(F("
Click Submit button once more to save 'Read value' PZEM Mode!")); P102_PZEM_ADDR_SET = 0; // Reset programming confirmation } From 546e850959440a962f257575fa9c0334632ac9a4 Mon Sep 17 00:00:00 2001 From: Ton Huisman Date: Sun, 14 Sep 2025 16:58:24 +0200 Subject: [PATCH 10/10] [P102] Update documentation --- docs/source/Plugin/P102.rst | 7 +++++++ docs/source/Plugin/P102_ResetEnergyDone.png | Bin 13403 -> 15793 bytes src/_P102_PZEM004Tv3.ino | 2 +- 3 files changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/source/Plugin/P102.rst b/docs/source/Plugin/P102.rst index 9d93c1dfb..580305b73 100644 --- a/docs/source/Plugin/P102.rst +++ b/docs/source/Plugin/P102.rst @@ -250,6 +250,13 @@ The command will be executed immediately, and afterward the status will shown: The blue message showing that the command was sent. The **PZEM Mode** is already reset to ``Read value``. +To store this change in settings, the :cyan:`Submit` button should be used once more (you can of course change more settings if desired, that's why no automatic save is done.) + +Send the ``resetenergy,`` command +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +For an easy alternative to reset the Energy counter, you can use the ``resetenergy,`` command, f.e. from the ``Command`` field on the Tools page, to reset the counter for the specific modbus address (range 1..247, or 0 if only 1 device is on the bus). + Installing multiple PZEM units on a single ESP ---------------------------------------------- diff --git a/docs/source/Plugin/P102_ResetEnergyDone.png b/docs/source/Plugin/P102_ResetEnergyDone.png index c5d3f366e5c07379dde01d67a5549bd3b03d3b57..84183a0b2ad32d758be336ef57ebfb835bac553e 100644 GIT binary patch literal 15793 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 HECc=z*+GB~ literal 13403 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 J+
Energy reset on current PZEM ! ")); - addHtml(F("
Click Submit button once more to save 'Read value' PZEM Mode!")); + addHtml(F("
Click Submit button once more to save 'Read value' PZEM Mode !")); P102_PZEM_ADDR_SET = 0; // Reset programming confirmation }