Library and Codes updated

Author: mcmchris

MCM_BL0940.cpp

@@ -25,20 +25,17 @@
 #define ERR(...)
 #endif /* BL0940_DBG */
 
-BL0940::BL0940()
+bool BL0940::begin(HardwareSerial& serial, int8_t rxPin, int8_t txPin)
 {
 
-  /* For M5STACK_PAPER */
-  // Serial2.begin(4800, SERIAL_8N1, 18, 19);
+  serialPtr = &serial;  // default
 
-  Serial2.begin(4800);
-
-  delay(500);
-}
-
-BL0940::~BL0940()
-{
-  Serial2.end();
+#if defined (ARDUINO_RASPBERRY_PI_PICO)
+  serialPtr->begin(4800);
+#else
+  serialPtr->begin(4800, SERIAL_8N1, rxPin, txPin);
+#endif
+  return true;
 }
 
 uint8_t BL0940::_culcCheckSum(uint8_t *txData, int txLenght, uint8_t *rxData, int rxLenght)
@@ -60,38 +57,38 @@ uint8_t BL0940::_culcCheckSum(uint8_t *txData, int txLenght, uint8_t *rxData, in
 bool BL0940::_writeRegister(uint8_t address, uint32_t data)
 {
   // read buffer clear
-  while (Serial2.available() != 0)
+  while (serialPtr->available() != 0)
   {
-    Serial2.read();
+    serialPtr->read();
   }
 
   // Register Unlock
   uint8_t unlockTxData[6] = {0xA8, 0x1A, 0x55, 0, 0, 0};
   unlockTxData[5] = _culcCheckSum(unlockTxData, sizeof(unlockTxData) - 1, 0, 0);
-  Serial2.write(unlockTxData, sizeof(unlockTxData));
+  serialPtr->write(unlockTxData, sizeof(unlockTxData));
 
   // Write Register
   uint8_t txData[6] = {0xA8, address, (uint8_t)(data), (uint8_t)(data >> 8), (uint8_t)(data >> 16)};
   txData[5] = _culcCheckSum(txData, sizeof(txData) - 1, 0, 0);
-  Serial2.write(txData, sizeof(txData));
+  serialPtr->write(txData, sizeof(txData));
 
   return true;
 }
 
 bool BL0940::_readRegister(uint8_t address, uint32_t *data)
 {
   uint8_t txData[] = {0x58, address};
-  Serial2.write(txData, sizeof(txData));
+  serialPtr->write(txData, sizeof(txData));
 
   uint8_t rxData[4] = {0, 0, 0, 0};
   uint32_t startTime = millis();
-  while (Serial2.available() != sizeof(rxData))
+  while (serialPtr->available() != sizeof(rxData))
   {
     delay(10);
     if ((millis() - startTime) > timeout)
       break;
   }
-  int rxDataLength = Serial2.readBytes(rxData, sizeof(rxData));
+  int rxDataLength = serialPtr->readBytes(rxData, sizeof(rxData));
 
   if (rxDataLength == 0)
   {
@@ -359,9 +356,9 @@ bool BL0940::Reset()
     ERR("Can not write SOFT_RESET register.");
     return false;
   }
-  while (Serial2.available() != 0)
+  while (serialPtr->available() != 0)
   {
-    Serial2.read();
+    serialPtr->read();
   }
 
   delay(500);

MCM_BL0940.h

@@ -6,14 +6,18 @@
 *	Based on Kohacraft previews work.
 */
 
+#pragma once
+
+#include <Arduino.h>
+
 #ifndef MCM_BL0940_h
 #define MCM_BL0940_h
 
 class BL0940
 {
   public:
-    BL0940();
-    ~BL0940(); 
+
+    bool begin(HardwareSerial& serial, int8_t rxPin = -1, int8_t txPin = -1);
     bool getCurrent( float *current );  //[A]
     bool getVoltage( float *voltage );  //[V]
     bool getActivePower( float *activePower );  //[W]
@@ -27,6 +31,7 @@ class BL0940
     bool Reset();
 
   private:
+    HardwareSerial* serialPtr = nullptr;  // pointer to HardwareSerial
     const uint16_t timeout = 1000;  //Serial timeout[ms]
     const float Vref = 1.218; //[V]
     const float R5 = 3.3;   //[Ohm]
@@ -43,5 +48,6 @@ class BL0940
     uint8_t _culcCheckSum( uint8_t *txData , int txLenght , uint8_t *rxData , int rxLenght );
     bool _writeRegister( uint8_t address , uint32_t data );
     bool _readRegister( uint8_t address , uint32_t *data );
+    
 };
 #endif /* BL0940 */

README.md

@@ -8,5 +8,9 @@ An Arduino library to interface the BL0940 Energy Meter IC with Arduino, ESP32 a
 ![FotoModulo](https://user-images.githubusercontent.com/49886387/219874809-0241e54c-ceb6-4885-a2be-acae7203bad2.JPG)
 
 ## Supported MCU's
-- ESP32
+- ESP32: 
+  - Adafruit Feather ESP32
+  - Arduino Nano ESP32
+  - M5Stack Paper
+  - Xiao ESP32C3
 - Raspberry Pi Pico

examples/BL0940-ESP32/BL0940-ESP32.ino

@@ -1,11 +1,11 @@
-
 #include "MCM_BL0940.h"
 
 BL0940 bl0940;
 
 void setup() {
   Serial.begin(115200);
 
+  bl0940.begin(Serial1, RX, TX); // RX pin - TX pin 
   bl0940.Reset();
   bl0940.setFrequency(60); //50[Hz]
   bl0940.setUpdateRate(800); //400[ms]
@@ -19,15 +19,15 @@ void loop() {
 
   float current;
   bl0940.getCurrent( &current );
-  Serial.printf("%.2f [A]\n", current );
+  Serial.printf("%.4f [A]\n", current );
 
   float activePower;
   bl0940.getActivePower( &activePower );
   Serial.printf("%.2f [W]\n", activePower );
 
   float activeEnergy;
   bl0940.getActiveEnergy( &activeEnergy );
-  Serial.printf("%.3f [kWh]\n", activeEnergy );
+  Serial.printf("%.6f [kWh]\n", activeEnergy );
 
   float powerFactor;
   bl0940.getPowerFactor( &powerFactor );