From 569240fb6f8fd43571012f252b651e11a7b6000e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 9 Mar 2022 18:01:00 +0100
Subject: [PATCH 001/549] further configuration keys

---
 .../Tasks/ChargePointStatus/ChargePointStatusService.cpp    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 22aaa061..c0cbe8cf 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -42,6 +42,12 @@ ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned
         fProfilePlus += fpIdRTrigger;
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
+
+    /*
+     * Further configuration keys which correspond to the Core profile
+     */
+    declareConfiguration<const char*>("AuthorizeRemoteTxRequests","false",CONFIGURATION_VOLATILE,false,true,false,false);
+    declareConfiguration<int>("GetConfigurationMaxKeys",30,CONFIGURATION_VOLATILE,false,true,false,false);
 }
 
 ChargePointStatusService::~ChargePointStatusService() {

From d36ccd5cdc5fb260e05e5e3f5513f45c61b7c6fc Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 16 Mar 2022 18:28:44 +0100
Subject: [PATCH 002/549] add generic MeterValue support

---
 src/ArduinoOcpp.cpp                           |  33 +++-
 src/ArduinoOcpp.h                             |   3 +
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp   |  71 +++------
 src/ArduinoOcpp/MessagesV16/MeterValues.h     |   8 +-
 .../MessagesV16/StartTransaction.cpp          |   2 +-
 .../MessagesV16/StartTransaction.h            |   2 +-
 .../MessagesV16/StopTransaction.cpp           |   2 +-
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |   2 +-
 .../Metering/ConnectorMeterValuesRecorder.cpp |  87 +++++------
 .../Metering/ConnectorMeterValuesRecorder.h   |  19 ++-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.h   |  61 ++++++++
 .../Tasks/Metering/MeteringService.cpp        |  10 +-
 .../Tasks/Metering/MeteringService.h          |   5 +-
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h | 143 ++++++++++++++++++
 14 files changed, 327 insertions(+), 121 deletions(-)
 create mode 100644 src/ArduinoOcpp/Tasks/Metering/MeterValue.h
 create mode 100644 src/ArduinoOcpp/Tasks/Metering/SampledValue.h

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 60f8b841..b32ae275 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -168,7 +168,16 @@ void setPowerActiveImportSampler(std::function<float()> power) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
             new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS)));
     }
-    model.getMeteringService()->setPowerSampler(OCPP_ID_OF_CONNECTOR, power); //connectorId=1
+    SampledValueProperties meterProperties;
+    meterProperties.setMeasurand("Power.Active.Import");
+    meterProperties.setUnit("W");
+    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
+                           new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
+            meterProperties,
+            power
+    ));
+    model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(mvs)); //connectorId=1
+    model.getMeteringService()->setPowerSampler(OCPP_ID_OF_CONNECTOR, power);
 }
 
 void setEnergyActiveImportSampler(std::function<float()> energy) {
@@ -181,7 +190,27 @@ void setEnergyActiveImportSampler(std::function<float()> energy) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
             new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS)));
     }
-    model.getMeteringService()->setEnergySampler(OCPP_ID_OF_CONNECTOR, energy); //connectorId=1
+    SampledValueProperties meterProperties;
+    meterProperties.setMeasurand("Energy.Active.Import.Register");
+    meterProperties.setUnit("Wh");
+    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
+                           new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
+            meterProperties, energy));
+    model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(mvs)); //connectorId=1
+    model.getMeteringService()->setEnergySampler(OCPP_ID_OF_CONNECTOR, energy);
+}
+
+void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("Please call OCPP_initialize before");
+        return;
+    }
+    auto& model = ocppEngine->getOcppModel();
+    if (!model.getMeteringService()) {
+        model.setMeteringSerivce(std::unique_ptr<MeteringService>(
+            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS)));
+    }
+    model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(meterValueSampler)); //connectorId=1
 }
 
 void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index aba69669..65ca8ca7 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -13,6 +13,7 @@
 #include <ArduinoOcpp/Core/OcppOperationCallbacks.h>
 #include <ArduinoOcpp/Core/OcppOperationTimeout.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
 using ArduinoOcpp::OnReceiveReqListener;
@@ -50,6 +51,8 @@ void setPowerActiveImportSampler(std::function<float()> power);
 
 void setEnergyActiveImportSampler(std::function<float()> energy);
 
+void addMeterValueSampler(std::unique_ptr<ArduinoOcpp::SampledValueSampler> meterValueSampler);
+
 void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy);
 
 void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized);
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index 4f04992b..26c60593 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -5,6 +5,7 @@
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::MeterValues;
@@ -14,14 +15,12 @@ MeterValues::MeterValues() {
     
 }
 
-MeterValues::MeterValues(const std::vector<OcppTimestamp> *sampleTime, const std::vector<float> *energy, const std::vector<float> *power, int connectorId, int transactionId) 
+MeterValues::MeterValues(const std::vector<std::unique_ptr<MeterValue>>& meterValue, int connectorId, int transactionId) 
       : connectorId{connectorId}, transactionId{transactionId} {
-    if (sampleTime)
-        this->sampleTime = std::vector<OcppTimestamp>(*sampleTime);
-    if (energy)
-        this->energy = std::vector<float>(*energy);
-    if (power)
-        this->power = std::vector<float>(*power);
+
+    for (auto value = meterValue.begin(); value != meterValue.end(); value++) {
+        this->meterValue.push_back(std::unique_ptr<MeterValue>(new MeterValue(**value)));
+    }
 }
 
 MeterValues::~MeterValues(){
@@ -34,49 +33,22 @@ const char* MeterValues::getOcppOperationType(){
 
 std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
 
-    int numEntries = sampleTime.size();
-
-    const size_t VALUE_MAXPRECISION = 10;
-    const size_t VALUE_MAXSIZE = VALUE_MAXPRECISION + 7; 
-    char value_str [VALUE_MAXSIZE] = {'\0'};
-
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-        JSON_OBJECT_SIZE(3) //connectorID, transactionId, meterValue entry
-        + JSON_ARRAY_SIZE(numEntries) //metervalue array
-        + numEntries * JSON_OBJECT_SIZE(1) //sampledValue entry
-        + numEntries * (JSON_OBJECT_SIZE(1) + (JSONDATE_LENGTH + 1)) //timestamp
-        + numEntries * JSON_ARRAY_SIZE(2) //sampledValue
-        + 2 * numEntries * (JSON_OBJECT_SIZE(1) + VALUE_MAXSIZE) //value
-        + 2 * numEntries * JSON_OBJECT_SIZE(1) //measurand
-        + 2 * numEntries * JSON_OBJECT_SIZE(1) //unit
-        + 230)); //"safety space"
-    JsonObject payload = doc->to<JsonObject>();
+    size_t capacity = 0;
     
-    payload["connectorId"] = connectorId;
-    JsonArray meterValues = payload.createNestedArray("meterValue");
-    for (size_t i = 0; i < sampleTime.size(); i++) {
-        JsonObject meterValue = meterValues.createNestedObject();
-        char timestamp[JSONDATE_LENGTH + 1] = {'\0'};
-        OcppTimestamp otimestamp = sampleTime.at(i);
-        otimestamp.toJsonString(timestamp, JSONDATE_LENGTH + 1);
-        meterValue["timestamp"] = timestamp;
-        JsonArray sampledValue = meterValue.createNestedArray("sampledValue");
-        if (energy.size() >= i + 1) {
-            JsonObject sampledValue_1 = sampledValue.createNestedObject();
-            snprintf(value_str, VALUE_MAXSIZE, "%.*g", VALUE_MAXPRECISION, energy.at(i));
-            sampledValue_1["value"] = value_str;
-            sampledValue_1["measurand"] = "Energy.Active.Import.Register";
-            sampledValue_1["unit"] = "Wh";
-        }
-        if (power.size() >= i + 1) {
-            JsonObject sampledValue_2 = sampledValue.createNestedObject();
-            snprintf(value_str, VALUE_MAXSIZE, "%.*g", VALUE_MAXPRECISION, power.at(i));
-            sampledValue_2["value"] = value_str;
-            sampledValue_2["measurand"] = "Power.Active.Import";
-            sampledValue_2["unit"] = "W";
-        }
+    std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
+    for (auto value = meterValue.begin(); value != meterValue.end(); value++) {
+        auto entry = (*value)->toJson();
+        capacity += entry->capacity();
+        entries.push_back(std::move(entry));
     }
 
+    capacity += JSON_OBJECT_SIZE(3);
+    capacity += JSON_ARRAY_SIZE(entries.size());
+
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
+    auto payload = doc->to<JsonObject>();
+    payload["connectorId"] = connectorId;
+
     if (ocppModel && ocppModel->getConnectorStatus(connectorId)) {
         auto connector = ocppModel->getConnectorStatus(connectorId);
         if (connector->getTransactionIdSync() >= 0) {
@@ -84,6 +56,11 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
         }
     }
 
+    auto meterValueJson = payload.createNestedArray("meterValue");
+    for (auto entry = entries.begin(); entry != entries.end(); entry++) {
+        meterValueJson.add(**entry);
+    }
+
     return doc;
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.h b/src/ArduinoOcpp/MessagesV16/MeterValues.h
index 35160909..2e0bfcab 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.h
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.h
@@ -7,22 +7,20 @@
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
 
 class MeterValues : public OcppMessage {
 private:
-
-    std::vector<OcppTimestamp> sampleTime;
-    std::vector<float> power;
-    std::vector<float> energy;
+    std::vector<std::unique_ptr<MeterValue>> meterValue;
 
     int connectorId = 0;
     int transactionId = -1;
 
 public:
-    MeterValues(const std::vector<OcppTimestamp> *sampleTime, const std::vector<float> *energy, const std::vector<float> *power, int connectorId, int transactionId);
+    MeterValues(const std::vector<std::unique_ptr<MeterValue>>& meterValue, int connectorId, int transactionId);
 
     MeterValues(); //for debugging only. Make this for the server pendant
 
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 62e05590..c6941c51 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -28,7 +28,7 @@ const char* StartTransaction::getOcppOperationType(){
 void StartTransaction::initiate() {
     if (ocppModel && ocppModel->getMeteringService()) {
         auto meteringService = ocppModel->getMeteringService();
-        meterStart = (int) meteringService->readEnergyActiveImportRegister(connectorId);
+        meterStart = meteringService->readEnergyActiveImportRegister(connectorId);
     }
 
     if (ocppModel) {
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.h b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
index b756cdec..6390a0f1 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
@@ -15,7 +15,7 @@ namespace Ocpp16 {
 class StartTransaction : public OcppMessage {
 private:
     int connectorId = 1;
-    int meterStart = -1;
+    int32_t meterStart = -1;
     OcppTimestamp otimestamp;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
     uint16_t transactionRev = 0;
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 094888c3..52f91627 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -22,7 +22,7 @@ void StopTransaction::initiate() {
 
     if (ocppModel && ocppModel->getMeteringService()) {
         auto meteringService = ocppModel->getMeteringService();
-        meterStop = (int) meteringService->readEnergyActiveImportRegister(connectorId);
+        meterStop = meteringService->readEnergyActiveImportRegister(connectorId);
     }
 
     if (ocppModel) {
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index a1b861bd..d662cf4d 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -14,7 +14,7 @@ namespace Ocpp16 {
 class StopTransaction : public OcppMessage {
 private:
     int connectorId = 1;
-    int meterStop = -1;
+    int32_t meterStop = -1;
     OcppTimestamp otimestamp;
 public:
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 659bd265..1d71648f 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -15,27 +15,27 @@ using namespace ArduinoOcpp::Ocpp16;
 
 ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, int connectorId)
         : context(context), connectorId{connectorId} {
-    sampleTimestamp = std::vector<OcppTimestamp>();
-    energy = std::vector<float>();
-    power = std::vector<float>();
 
     MeterValueSampleInterval = declareConfiguration("MeterValueSampleInterval", 60);
     MeterValuesSampledDataMaxLength = declareConfiguration("MeterValuesSampledDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
 }
 
 void ConnectorMeterValuesRecorder::takeSample() {
-    if (energySampler != nullptr || powerSampler != nullptr) {
-        if (!context.getOcppTime().isValid()) return;
-        sampleTimestamp.push_back(context.getOcppTime().getOcppTimestampNow());
-    }
+    if (meterValueSamplers.empty()) return;
 
-    if (energySampler != nullptr) {
-        energy.push_back(energySampler());
+    std::unique_ptr<MeterValue> sample;
+    if (context.getOcppTime().isValid()) {
+        sample.reset(new MeterValue(context.getOcppTime().getOcppTimestampNow()));
+    }
+    if (!sample) {
+        return;
     }
 
-    if (powerSampler != nullptr) {
-        power.push_back(powerSampler());
+    for (auto mvs = meterValueSamplers.begin(); mvs != meterValueSamplers.end(); mvs++) {
+        sample->addSampledValue((*mvs)->takeValue());
     }
+
+    meterValue.push_back(std::move(sample));
 }
 
 OcppMessage *ConnectorMeterValuesRecorder::loop() {
@@ -73,7 +73,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
     /*
     * Is the value buffer already full? If yes, return MeterValues message
     */
-    if (((int) sampleTimestamp.size()) >= (int) *MeterValuesSampledDataMaxLength) {
+    if (((int) meterValue.size()) >= (int) *MeterValuesSampledDataMaxLength) {
         auto result = toMeterValues();
         return result;
     }
@@ -82,59 +82,35 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
 }
 
 OcppMessage *ConnectorMeterValuesRecorder::toMeterValues() {
-    if (sampleTimestamp.size() == 0) {
+    if (meterValue.empty()) {
         AO_DBG_DEBUG("Checking if to send MeterValues ... No");
         clear();
         return nullptr;
-    }
-
-    //decide which measurands to send. If a measurand is missing at at least one point in time, omit that measurand completely
-
-    if (energy.size() == sampleTimestamp.size() && power.size() == sampleTimestamp.size()) {
-        auto result = new MeterValues(&sampleTimestamp, &energy, &power, connectorId, lastTransactionId);
-        clear();
-        return result;
-    }
-
-    if (energy.size() == sampleTimestamp.size() && power.size() != sampleTimestamp.size()) {
-        auto result = new MeterValues(&sampleTimestamp, &energy, nullptr, connectorId, lastTransactionId);
-        clear();
-        return result;
-    }
-
-    if (energy.size() != sampleTimestamp.size() && power.size() == sampleTimestamp.size()) {
-        auto result = new MeterValues(&sampleTimestamp, nullptr, &power, connectorId, lastTransactionId);
+    } else {
+        auto result = new MeterValues(meterValue, connectorId, lastTransactionId);
         clear();
         return result;
     }
-
-    //Maybe the energy sampler or power sampler was set during recording. Discard recorded data.
-    AO_DBG_WARN("Invalid data set. Discard data set and restart recording");
-    clear();
-
-    return nullptr;
 }
 
 OcppMessage *ConnectorMeterValuesRecorder::takeMeterValuesNow() {
 
-    if (!energySampler && !powerSampler) {
+    if (meterValueSamplers.empty()) {
         return nullptr;
     }
 
-    decltype(sampleTimestamp) t_now;
-    decltype(energy) e_now;
-    decltype(power) p_now;
+    std::unique_ptr<MeterValue> value;
 
     if (context.getOcppTime().isValid()) {
-        t_now.push_back(context.getOcppTime().getOcppTimestampNow());
+        value.reset(new MeterValue(context.getOcppTime().getOcppTimestampNow()));
     }
 
-    if (energySampler) {
-        e_now.push_back(energySampler());
+    if (!value) {
+        return nullptr;
     }
 
-    if (powerSampler) {
-        p_now.push_back(powerSampler());
+    for (auto mvs = meterValueSamplers.begin(); mvs != meterValueSamplers.end(); mvs++) {
+        value->addSampledValue((*mvs)->takeValue());
     }
 
     int txId_now = -1;
@@ -143,24 +119,29 @@ OcppMessage *ConnectorMeterValuesRecorder::takeMeterValuesNow() {
         txId_now = connector->getTransactionId();
     }
 
-    return new MeterValues(&t_now, &e_now, &p_now, connectorId, txId_now);
+    decltype(meterValue) mv_now;
+    mv_now.push_back(std::move(value));
+
+    return new MeterValues(mv_now, connectorId, txId_now);
 }
 
 void ConnectorMeterValuesRecorder::clear() {
-    sampleTimestamp.clear();
-    energy.clear();
-    power.clear();
+    meterValue.clear();
 }
 
 void ConnectorMeterValuesRecorder::setPowerSampler(PowerSampler ps){
-  this->powerSampler = ps;
+    this->powerSampler = ps;
 }
 
 void ConnectorMeterValuesRecorder::setEnergySampler(EnergySampler es){
-  this->energySampler = es;
+    this->energySampler = es;
+}
+
+void ConnectorMeterValuesRecorder::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
+    meterValueSamplers.push_back(std::move(meterValueSampler));
 }
 
-float ConnectorMeterValuesRecorder::readEnergyActiveImportRegister() {
+int32_t ConnectorMeterValuesRecorder::readEnergyActiveImportRegister() {
     if (energySampler != nullptr) {
         return energySampler();
     } else {
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index 9976067d..d65de801 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -12,6 +12,7 @@
 #include <functional>
 #include <memory>
 
+#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 
 namespace ArduinoOcpp {
@@ -29,18 +30,18 @@ class ConnectorMeterValuesRecorder {
     
     const int connectorId;
 
-    std::vector<OcppTimestamp> sampleTimestamp;
-    std::vector<float> energy;
-    std::vector<float> power;
+    std::vector<std::unique_ptr<MeterValue>> meterValue;
+
     ulong lastSampleTime = 0; //0 means not charging right now
     float lastPower;
     int lastTransactionId = -1;
  
-    PowerSampler powerSampler = NULL;
-    EnergySampler energySampler = NULL;
+    PowerSampler powerSampler = nullptr;
+    EnergySampler energySampler = nullptr;
+    std::vector<std::unique_ptr<SampledValueSampler>> meterValueSamplers;
 
-    std::shared_ptr<Configuration<int>> MeterValueSampleInterval = NULL;
-    std::shared_ptr<Configuration<int>> MeterValuesSampledDataMaxLength = NULL;
+    std::shared_ptr<Configuration<int>> MeterValueSampleInterval = nullptr;
+    std::shared_ptr<Configuration<int>> MeterValuesSampledDataMaxLength = nullptr;
 
     void takeSample();
     OcppMessage *toMeterValues();
@@ -54,7 +55,9 @@ class ConnectorMeterValuesRecorder {
 
     void setEnergySampler(EnergySampler energySampler);
 
-    float readEnergyActiveImportRegister();
+    void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler);
+
+    int32_t readEnergyActiveImportRegister();
 
     OcppMessage *takeMeterValuesNow();
 };
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
new file mode 100644
index 00000000..6945fa8c
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
@@ -0,0 +1,61 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef METERVALUE_H
+#define METERVALUE_H
+
+#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
+#include <ArduinoJson.h>
+#include <memory>
+
+namespace ArduinoOcpp {
+
+class MeterValue {
+private:
+    OcppTimestamp timestamp;
+    std::vector<std::unique_ptr<SampledValue>> sampledValue;
+public:
+    MeterValue(OcppTimestamp timestamp) : timestamp(timestamp) { }
+    MeterValue(const MeterValue& other) {
+        timestamp = other.timestamp;
+        for (auto value = other.sampledValue.begin(); value != other.sampledValue.end(); value++) {
+            sampledValue.push_back(std::unique_ptr<SampledValue>((*value)->clone()));
+        }
+    }
+
+    void addSampledValue(std::unique_ptr<SampledValue> sample) {sampledValue.push_back(std::move(sample));}
+
+    std::unique_ptr<DynamicJsonDocument> toJson() {
+        size_t capacity = 0;
+        std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
+        for (auto sample = sampledValue.begin(); sample != sampledValue.end(); sample++) {
+            auto json = (*sample)->toJson();
+            capacity += json->capacity();
+            entries.push_back(std::move(json));
+        }
+
+        capacity += JSON_ARRAY_SIZE(entries.size());
+        capacity += JSONDATE_LENGTH + 1;
+        capacity += JSON_OBJECT_SIZE(2);
+        
+        auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
+        auto jsonPayload = result->to<JsonObject>();
+
+        char timestampStr [JSONDATE_LENGTH + 1] = {'\0'};
+        if (!timestamp.toJsonString(timestampStr, JSONDATE_LENGTH + 1)) {
+            return nullptr;
+        }
+        jsonPayload["timestamp"] = timestampStr;
+        auto jsonMeterValue = jsonPayload.createNestedArray("sampledValue");
+        for (auto entry = entries.begin(); entry != entries.end(); entry++) {
+            jsonMeterValue.add(**entry);
+        }
+        return std::move(result);
+    }
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index 6260a55c..6232aa34 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -45,7 +45,15 @@ void MeteringService::setEnergySampler(int connectorId, EnergySampler es){
     connectors[connectorId]->setEnergySampler(es);
 }
 
-float MeteringService::readEnergyActiveImportRegister(int connectorId) {
+void MeteringService::addMeterValueSampler(int connectorId, std::unique_ptr<SampledValueSampler> meterValueSampler) {
+    if (connectorId < 0 || connectorId >= connectors.size()) {
+        AO_DBG_ERR("connectorId is out of bounds");
+        return;
+    }
+    connectors[connectorId]->addMeterValueSampler(std::move(meterValueSampler));
+}
+
+int32_t MeteringService::readEnergyActiveImportRegister(int connectorId) {
     if (connectorId < 0 || connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
         return 0.f;
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index 035db5f6..526629fb 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -8,6 +8,7 @@
 #include <functional>
 
 #include <ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h>
+#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 namespace ArduinoOcpp {
 
@@ -31,7 +32,9 @@ class MeteringService {
 
     void setEnergySampler(int connectorId, EnergySampler energySampler);
 
-    float readEnergyActiveImportRegister(int connectorId);
+    void addMeterValueSampler(int connectorId, std::unique_ptr<SampledValueSampler> meterValueSampler);
+
+    int32_t readEnergyActiveImportRegister(int connectorId);
 
     std::unique_ptr<OcppOperation> takeMeterValuesNow(int connectorId); //snapshot of all meters now
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
new file mode 100644
index 00000000..f2a3adb9
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -0,0 +1,143 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef SAMPLEDVALUE_H
+#define SAMPLEDVALUE_H
+
+#include <ArduinoJson.h>
+#include <memory>
+
+namespace ArduinoOcpp {
+
+template <class T>
+class SampledValueDeSerializer {
+public:
+    static T deserialize(const char *str);
+    static std::string serialize(const T& val);
+    static int32_t toInteger(const T& val);
+};
+
+template <>
+class SampledValueDeSerializer<int32_t> {
+public:
+    static int32_t deserialize(const char *str) {return 42;}
+    static std::string serialize(const int32_t& val) {
+        char str [12] = {'\0'};
+        snprintf(str, 12, "%d", val);
+        return std::string(str);
+    }
+    static int32_t toInteger(const int32_t& val) {return val;}
+};
+
+class SampledValueProperties {
+private:
+    std::string format;
+    std::string measurand;
+    std::string phase;
+    std::string location;
+    std::string unit;
+
+    const std::string& getFormat() const {return format;}
+    const std::string& getMeasurand() const {return measurand;}
+    const std::string& getPhase() const {return phase;}
+    const std::string& getLocation() const {return location;}
+    const std::string& getUnit() const {return unit;}
+    friend class SampledValue; //will be able to retreive these parameters
+
+public:
+    SampledValueProperties() { }
+    SampledValueProperties(const SampledValueProperties& other) :
+            format(other.format),
+            measurand(other.measurand),
+            phase(other.phase),
+            location(other.location),
+            unit(other.unit) { }
+    ~SampledValueProperties() = default;
+
+    void setFormat(const char *format) {this->format = format;}
+    void setMeasurand(const char *measurand) {this->measurand = measurand;}
+    void setPhase(const char *phase) {this->phase = phase;}
+    void setLocation(const char *location) {this->location = location;}
+    void setUnit(const char *unit) {this->unit = unit;}
+};
+
+class SampledValue {
+protected:
+    const SampledValueProperties& properties;
+    virtual std::string serializeValue() = 0;
+public:
+    SampledValue(const SampledValueProperties& properties) : properties(properties) { }
+    SampledValue(const SampledValue& other) : properties(other.properties) { }
+    virtual ~SampledValue() = default;
+
+    std::unique_ptr<DynamicJsonDocument> toJson() {
+        auto value = serializeValue();
+        size_t capacity = 0;
+        capacity += JSON_OBJECT_SIZE(7);
+        capacity += value.length() + 1
+                  + properties.getFormat().length() + 1
+                  + properties.getMeasurand().length() + 1
+                  + properties.getPhase().length() + 1
+                  + properties.getLocation().length() + 1
+                  + properties.getUnit().length() + 1;
+        auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
+        auto payload = result->to<JsonObject>();
+        payload["value"] = value;
+        if (!properties.getFormat().empty())
+            payload["format"] = properties.getFormat();
+        if (!properties.getMeasurand().empty())
+            payload["measurand"] = properties.getMeasurand();
+        if (!properties.getPhase().empty())
+            payload["phase"] = properties.getPhase();
+        if (!properties.getLocation().empty())
+            payload["location"] = properties.getLocation();
+        if (!properties.getUnit().empty())
+            payload["unit"] = properties.getUnit();
+        return std::move(result);
+    }
+
+    virtual std::unique_ptr<SampledValue> clone() = 0;
+
+    virtual int32_t toInteger() = 0;
+};
+
+template <class T, class DeSerializer>
+class SampledValueConcrete : public SampledValue {
+private:
+    const T value;
+public:
+    SampledValueConcrete(const SampledValueProperties& properties, const T&& value) : SampledValue(properties), value(value) { }
+    SampledValueConcrete(const SampledValueConcrete& other) : SampledValue(other), value(other.value) { }
+    ~SampledValueConcrete() = default;
+
+    std::string serializeValue() override {return DeSerializer::serialize(value);}
+
+    std::unique_ptr<SampledValue> clone() override {return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(*this));}
+
+    int32_t toInteger() override { return DeSerializer::toInteger(value);}
+};
+
+class SampledValueSampler {
+protected:
+    SampledValueProperties properties;
+public:
+    SampledValueSampler(SampledValueProperties properties) : properties(properties) { }
+    virtual ~SampledValueSampler() = default;
+    virtual std::unique_ptr<SampledValue> takeValue() = 0;
+};
+
+template <class T, class DeSerializer>
+class SampledValueSamplerConcrete : public SampledValueSampler {
+private:
+    std::function<T()> sampler;
+public:
+    SampledValueSamplerConcrete(SampledValueProperties properties, std::function<T()> sampler) : SampledValueSampler(properties), sampler(sampler) { }
+    std::unique_ptr<SampledValue> takeValue() override {
+        return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(properties, sampler()));
+    }
+};
+
+}
+
+#endif

From 9b0ca14d931d016cf945bdfdb3d98c850da93107 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 4 Apr 2022 11:42:39 +0200
Subject: [PATCH 003/549] initial commit

---
 CMakeLists.txt                                |  59 ++++++++++
 README.md                                     | 102 +-----------------
 src/ArduinoOcpp.cpp                           |   4 +-
 src/ArduinoOcpp/Core/Configuration.cpp        |   9 +-
 .../Core/ConfigurationContainerFlash.cpp      |   2 +
 .../Core/ConfigurationKeyValue.cpp            |   8 --
 src/ArduinoOcpp/Core/OcppConnection.cpp       |  10 +-
 src/ArduinoOcpp/Core/OcppOperation.cpp        |  14 +--
 src/ArduinoOcpp/Core/OcppOperation.h          |  14 +--
 src/ArduinoOcpp/Core/OcppTime.cpp             |   1 +
 .../MessagesV16/StatusNotification.cpp        |   1 +
 src/ArduinoOcpp/Platform.h                    |   2 +
 .../SimpleOcppOperationFactory.cpp            |   2 +-
 .../ChargePointStatus/ConnectorStatus.cpp     |   2 +-
 .../SmartCharging/SmartChargingModel.cpp      |   1 +
 .../SmartCharging/SmartChargingService.cpp    |   4 +-
 src/ao_opts.h                                 |  31 ++++++
 src/ao_opts_impl.c                            |  29 +++++
 18 files changed, 154 insertions(+), 141 deletions(-)
 create mode 100644 CMakeLists.txt
 create mode 100644 src/ao_opts.h
 create mode 100644 src/ao_opts_impl.c

diff --git a/CMakeLists.txt b/CMakeLists.txt
new file mode 100644
index 00000000..be8c56fc
--- /dev/null
+++ b/CMakeLists.txt
@@ -0,0 +1,59 @@
+set(AO_SRC
+    src/ArduinoOcpp/Core/Configuration.cpp
+    src/ArduinoOcpp/Core/ConfigurationContainer.cpp
+    src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+    src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+    src/ArduinoOcpp/Core/OcppConnection.cpp
+    src/ArduinoOcpp/Core/OcppEngine.cpp
+    src/ArduinoOcpp/Core/OcppMessage.cpp
+    src/ArduinoOcpp/Core/OcppModel.cpp
+    src/ArduinoOcpp/Core/OcppOperation.cpp
+    src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
+    src/ArduinoOcpp/Core/OcppServer.cpp
+    src/ArduinoOcpp/Core/OcppSocket.cpp
+    src/ArduinoOcpp/Core/OcppTime.cpp
+    src/ArduinoOcpp/MessagesV16/Authorize.cpp
+    src/ArduinoOcpp/MessagesV16/BootNotification.cpp
+    src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
+    src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
+    src/ArduinoOcpp/MessagesV16/ClearCache.cpp
+    src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
+    src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
+    src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
+    src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
+    src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
+    src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
+    src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
+    src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+    src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+    src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
+    src/ArduinoOcpp/MessagesV16/Reset.cpp
+    src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
+    src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+    src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+    src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+    src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+    src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+    src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
+    src/ArduinoOcpp/Platform.cpp
+    src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+    src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+    src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+    src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
+    src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+    src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
+    src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+    src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+    src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
+    src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+    src/ArduinoOcpp.cpp
+    src/ao_opts_impl.c
+)
+
+idf_component_register(SRCS ${AO_SRC}
+                    INCLUDE_DIRS "./src")
+
+target_compile_options(${COMPONENT_TARGET} PUBLIC
+    -DAO_CUSTOM_WS
+    -DAO_CUSTOM_CONSOLE
+    -DAO_DEACTIVATE_FLASH)
diff --git a/README.md b/README.md
index 5329de96..35e19a87 100644
--- a/README.md
+++ b/README.md
@@ -32,107 +32,7 @@ For simple chargers, the necessary hardware and internet integration is usually
 
 ## Usage guide
 
-Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. In this guide, I give a brief overview of the key concepts.
-
-- To get the library running, you have to install all dependencies (see the list below).
-
-   - In case you use PlatformIO, you can just add `matth-x/ArduinoOcpp` to your project using the PIO library manager.
-
-- In your project's `main` file, include `ArduinoOcpp.h`. This gives you a simple access to all functions.
-
-- Before establishing an OCPP connection you have to ensure that your device has access to a Wi-Fi access point. All debug messages are printed on the standard serial (i.e. `Serial.print("debug msg")`). To redirect debug messages, please refer to `src/ArduinoOcpp/Platform.h`.
-
-- To connect to your OCPP Central System, call `OCPP_initialize(String OCPP_HOST, uint16_t OCPP_PORT, String OCPP_URL)`. You need to insert the address parameters according to the configuration of your central system. Internally, the library passes these parameters to the WebSocket object without further alteration.
-   - To secure the connection with TLS, you have to configure the WebSocket. Please take `examples/SECC/main.cpp` as an example.
-
-- In your `setup()` function, you can add the configuration functions from `ArduinoOcpp.h` to properly integrate your hardware. All configuration functions are documented in `ArduinoOcpp.h`. For example, to integrate the energy meter of your EVSE, add
-
-```cpp
-setEnergyActiveImportSampler([]() {
-    return yourEVSE_readEnergyMeter();
-});
-```
-
-- Add `OCPP_loop()` to your `loop()` function.
-
-### Sending OCPP operations
-
-There are a couple of OCPP operations you can initialize on your EVSE. For example, to send a `Boot Notification`, use the function 
-```cpp
-void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf = nullptr, ...)`
-```
-
-In practice, it looks like this:
-
-```cpp
-void setup() {
-
-    ... //other code including the initialization of Wi-Fi and OCPP
-
-    bootNotification("My CP model name", "My company name", [] (JsonObject confMsg) {
-        //This callback is executed when the .conf() response from the central system arrives
-        Serial.print(F("BootNotification was answered. Central System clock: "));
-        Serial.println(confMsg["currentTime"].as<String>()); //"currentTime" is a field of the central system response
-        
-        //Notify your hardare that the BootNotification.conf() has arrived. E.g.:
-        //evseIsBooted = true;
-    });
-    
-    ... //rest of setup() function; executed immediately as bootNotification() is non-blocking
-}
-```
-
-The parameters `chargePointModel` and `chargePointVendor` are equivalent to the parameters in the `Boot Notification` as defined by the OCPP specification. The last parameter `OnReceiveConfListener onConf` is a callback function which the library executes when the central system has processed the operation and the ESP has received the `.conf()` response. Here you can add your device-specific behavior, e.g. flash a confirmation LED or unlock the connectors. If you don't need it, the last parameter is optional.
-
-For your first EVSE integration, the `onReceiveConfListener` is probably sufficient. For advanced EVSE projects, the other listeners likely become relevant:
-  
-- `onAbortListener`: will be called whenever the engine stops trying to finish an operation normally which was initiated by this device.
-
-- `onTimeoutListener`: will be executed when the operation is not answered until the timeout expires. Note that timeouts also trigger the `onAbortListener`.
-
-- `onReceiveErrorListener`: will be called when the Central System returns a CallError. Again, each error also triggers the `onAbortListener`.
-  
-The following example shows the correct usage of all listeners.
-
-```cpp
-authorize(idTag, [](JsonObject conf) { 
-    //onReceiveConfListener (optional but very likely necessary for your integration)
-    successfullyAuthorized = true; //example client code
-    ... //further client code, e.g. beginSession(idTag);
-}, []() { 
-    //onAbortListener (optional)
-    Serial.print(F("[EVSE] Could not authorize charging session. Aborted\n")); //flash error light etc.
-}, []() { 
-    //onTimeoutListener (optional)
-    Serial.print(F("[EVSE] Could not authorize charging session. Reason: timeout\n"));
-}, [](const char *code, const char *description, JsonObject details) { 
-    //onReceiveErrorListener (optional)
-    Serial.print(F("[EVSE] Could not authorize charging session. Reason: received OCPP error: "));
-    Serial.println(code);
-});
-
-```
-
-### Receiving OCPP operations
-
-The library also reacts on CS-initiated operations. You can add your own behavior there too. For example, to flash a LED on receipt of a `Set Charging Profile` request, use the following function.
-
-```cpp
-setOnSetChargingProfileRequest([] (JsonObject payload) {
-    //...
-});
-```
-
-You can also process the original payload from the CS using the `payload` object.
-
-*To get started quickly with or without EVSE hardware, you can flash the sketch in `examples/SECC` onto your ESP. That example mimics a full OCPP communications controller as it would look like in a real charging station. You can build a charger prototype based on that example or just view the internal state using the device monitor.*
-
-## Dependencies
-
-- [bblanchon/ArduinoJSON](https://github.com/bblanchon/ArduinoJson) (please upgrade to version `6.19.1`)
-- [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (please upgrade to version `2.3.6`)
-
-In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
+**This feature branch is WIP. A usage guide will follow.**
 
 ## Supported operations
 
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 60f8b841..e90985cb 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -37,7 +37,7 @@ float voltage_eff {230.f};
 #define OCPP_NUMCONNECTORS 2
 #define OCPP_ID_OF_CONNECTOR 1
 #define OCPP_ID_OF_CP 0
-boolean OCPP_booted = false; //if BootNotification succeeded
+bool OCPP_booted = false; //if BootNotification succeeded
 
 } //end namespace ArduinoOcpp::Facade
 } //end namespace ArduinoOcpp
@@ -137,7 +137,7 @@ void OCPP_deinitialize() {
 void OCPP_loop() {
     if (!ocppEngine) {
         AO_DBG_WARN("Please call OCPP_initialize before");
-        delay(200); //Prevent this message from flooding the Serial monitor.
+        //delay(200); //Prevent this message from flooding the Serial monitor.
         return;
     }
 
diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 21e27f0e..cbd75a0a 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -7,16 +7,9 @@
 
 #include <string.h>
 #include <vector>
+#include <algorithm>
 #include <ArduinoJson.h>
 
-#if defined(ESP32) && !defined(AO_DEACTIVATE_FLASH)
-#include <LITTLEFS.h>
-#define USE_FS LITTLEFS
-#else
-#include <FS.h>
-#define USE_FS SPIFFS
-#endif
-
 namespace ArduinoOcpp {
 
 FilesystemOpt configurationFilesystemOpt = FilesystemOpt::Use_Mount_FormatOnFail;
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index d10adbf3..4d0a260d 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -11,6 +11,7 @@
 #define USE_FS SPIFFS
 #endif
 
+#ifndef AO_DEACTIVATE_FLASH
 #if USE_FS == LITTLEFS
 #include <LITTLEFS.h>
 #elif USE_FS == SPIFFS
@@ -18,6 +19,7 @@
 #else
 #error "FS not supported"
 #endif
+#endif
 
 #define MAX_FILE_SIZE 4000
 #define MAX_CONFIGURATIONS 50
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index 0cee24e3..f25abddb 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -9,14 +9,6 @@
 #include <vector>
 #include <ArduinoJson.h>
 
-#if defined(ESP32) && !defined(AO_DEACTIVATE_FLASH)
-#include <LITTLEFS.h>
-#define USE_FS LITTLEFS
-#else
-#include <FS.h>
-#define USE_FS SPIFFS
-#endif
-
 #define KEY_MAXLEN 60
 #define STRING_VAL_MAXLEN 2000 //allow TLS certificates in ...
 
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 204a8288..15c10ce3 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -35,7 +35,7 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
 
     auto operation = initiatedOcppOperations.begin();
     while (operation != initiatedOcppOperations.end()){
-        boolean timeout = (*operation)->sendReq(ocppSock); //The only reason to dequeue elements here is when a timeout occurs. Normally
+        bool timeout = (*operation)->sendReq(ocppSock); //The only reason to dequeue elements here is when a timeout occurs. Normally
         if (timeout){                                       //the Conf msg processing routine dequeues finished elements
             operation = initiatedOcppOperations.erase(operation);
         } else {
@@ -76,7 +76,7 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
 
     operation = receivedOcppOperations.begin();
     while (operation != receivedOcppOperations.end()){
-        boolean success = (*operation)->sendConf(ocppSock);
+        bool success = (*operation)->sendConf(ocppSock);
         if (success){
             operation = receivedOcppOperations.erase(operation);
         } else {
@@ -102,7 +102,7 @@ void OcppConnection::initiateOcppOperation(std::unique_ptr<OcppOperation> o){
 
 bool OcppConnection::processOcppSocketInputTXT(const char* payload, size_t length) {
     
-    boolean deserializationSuccess = false;
+    bool deserializationSuccess = false;
 
     auto doc = std::unique_ptr<DynamicJsonDocument>{nullptr};
     size_t capacity = length + 100;
@@ -187,7 +187,7 @@ bool OcppConnection::processOcppSocketInputTXT(const char* payload, size_t lengt
  */
 void OcppConnection::handleConfMessage(JsonDocument& json) {
     for (auto operation = initiatedOcppOperations.begin(); operation != initiatedOcppOperations.end(); ++operation) {
-        boolean success = (*operation)->receiveConf(json); //maybe rename to "consumed"?
+        bool success = (*operation)->receiveConf(json); //maybe rename to "consumed"?
         if (success) {
             initiatedOcppOperations.erase(operation);
             return;
@@ -219,7 +219,7 @@ void OcppConnection::handleReqMessage(JsonDocument& json, std::unique_ptr<OcppOp
 
 void OcppConnection::handleErrMessage(JsonDocument& json) {
     for (auto operation = initiatedOcppOperations.begin(); operation != initiatedOcppOperations.end(); ++operation){
-        boolean discardOperation = (*operation)->receiveError(json); //maybe rename to "consumed"?
+        bool discardOperation = (*operation)->receiveError(json); //maybe rename to "consumed"?
         if (discardOperation) {
             initiatedOcppOperations.erase(operation);
             return;
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 52a9f7e2..035ac8c5 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -73,7 +73,7 @@ const std::string *OcppOperation::getMessageID() {
     return &messageID;
 }
 
-boolean OcppOperation::sendReq(OcppSocket& ocppSocket){
+bool OcppOperation::sendReq(OcppSocket& ocppSocket){
 
     /*
      * timeout behaviour
@@ -151,7 +151,7 @@ boolean OcppOperation::sendReq(OcppSocket& ocppSocket){
     return false;
 }
 
-boolean OcppOperation::receiveConf(JsonDocument& confJson){
+bool OcppOperation::receiveConf(JsonDocument& confJson){
     /*
      * check if messageIDs match. If yes, continue with this function. If not, return false for message not consumed
      */
@@ -176,7 +176,7 @@ boolean OcppOperation::receiveConf(JsonDocument& confJson){
     return true;
 }
 
-boolean OcppOperation::receiveError(JsonDocument& confJson){
+bool OcppOperation::receiveError(JsonDocument& confJson){
     /*
      * check if messageIDs match. If yes, continue with this function. If not, return false for message not consumed
      */
@@ -205,7 +205,7 @@ boolean OcppOperation::receiveError(JsonDocument& confJson){
     return abortOperation;
 }
 
-boolean OcppOperation::receiveReq(JsonDocument& reqJson){
+bool OcppOperation::receiveReq(JsonDocument& reqJson){
   
     std::string reqId = reqJson[1];
     setMessageID(reqId);
@@ -229,7 +229,7 @@ boolean OcppOperation::receiveReq(JsonDocument& reqJson){
     return true; //true because everything was successful. If there will be an error check in future, this value becomes more reasonable
 }
 
-boolean OcppOperation::sendConf(OcppSocket& ocppSocket){
+bool OcppOperation::sendConf(OcppSocket& ocppSocket){
 
     if (!reqExecuted) {
         //wait until req has been executed
@@ -290,7 +290,7 @@ boolean OcppOperation::sendConf(OcppSocket& ocppSocket){
      */
     std::string out {};
     serializeJson(*confJson, out);
-    boolean wsSuccess = ocppSocket.sendTXT(out);
+    bool wsSuccess = ocppSocket.sendTXT(out);
 
     if (wsSuccess) {
         if (operationSuccess) {
@@ -346,7 +346,7 @@ void OcppOperation::setOnAbortListener(OnAbortListener onAbort) {
         onAbortListener = onAbort;
 }
 
-boolean OcppOperation::isFullyConfigured(){
+bool OcppOperation::isFullyConfigured(){
     return ocppMessage != nullptr;
 }
 
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index fd93e96a..4ca7b5ad 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -31,7 +31,7 @@ class OcppOperation {
     OnTimeoutListener onTimeoutListener = [] () {};
     OnReceiveErrorListener onReceiveErrorListener = [] (const char *code, const char *description, JsonObject details) {};
     OnAbortListener onAbortListener = [] () {};
-    boolean reqExecuted = false;
+    bool reqExecuted = false;
 
     std::unique_ptr<Timeout> timeout{new OfflineSensitiveTimeout(40000)};
 
@@ -67,7 +67,7 @@ class OcppOperation {
      * the operation is completed (for example when conf() has been called), return true. When the operation is still pending, return
      * false.
      */
-    boolean sendReq(OcppSocket& ocppSocket);
+    bool sendReq(OcppSocket& ocppSocket);
 
    /**
     * Decides if message belongs to this operation instance and if yes, proccesses it. For example, multiple instances of an
@@ -75,28 +75,28 @@ class OcppOperation {
     * 
     * Returns true if JSON object has been consumed, false otherwise.
     */
-    boolean receiveConf(JsonDocument& json);
+    bool receiveConf(JsonDocument& json);
 
     /**
     * Decides if message belongs to this operation instance and if yes, notifies the OcppMessage object about the CallError.
     * 
     * Returns true if JSON object has been consumed, false otherwise.
     */
-    boolean receiveError(JsonDocument& json);
+    bool receiveError(JsonDocument& json);
 
     /**
      * Processes the request in the JSON document. Returns true on success, false on error.
      * 
      * Returns false if the request doesn't belong to the corresponding operation instance
      */
-    boolean receiveReq(JsonDocument& json);
+    bool receiveReq(JsonDocument& json);
 
     /**
      * After processing a request sent by the communication counterpart, this function sends a confirmation
      * message. Returns true on success, false otherwise. Returns also true if a CallError has successfully
      * been sent
      */
-    boolean sendConf(OcppSocket& ocppSocket);
+    bool sendConf(OcppSocket& ocppSocket);
 
     void setInitiated();
 
@@ -126,7 +126,7 @@ class OcppOperation {
      */
     void setOnAbortListener(OnAbortListener onAbort);
 
-    boolean isFullyConfigured();
+    bool isFullyConfigured();
 
     void print_debug();
 };
diff --git a/src/ArduinoOcpp/Core/OcppTime.cpp b/src/ArduinoOcpp/Core/OcppTime.cpp
index 3c58e4ba..d44dc4f8 100644
--- a/src/ArduinoOcpp/Core/OcppTime.cpp
+++ b/src/ArduinoOcpp/Core/OcppTime.cpp
@@ -4,6 +4,7 @@
 
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <ArduinoOcpp/Platform.h>
+#include <string.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index 72cdff6a..8776e60e 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -36,6 +36,7 @@ const char *cstrFromOcppEveState(OcppEvseState state) {
             return "Faulted";
         default:
             AO_DBG_ERR("OcppEvseState not specified");
+            __attribute__ ((fallthrough));
         case (OcppEvseState::NOT_SET):
             return "NOT_SET";
     }
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 25f9f322..66cb0d97 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -5,6 +5,8 @@
 #ifndef AO_PLATFORM_H
 #define AO_PLATFORM_H
 
+#include <ao_opts.h>
+
 #ifdef AO_CUSTOM_CONSOLE
 
 #ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
index d4deeb38..1b1ca459 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
@@ -31,7 +31,7 @@
 #include <ArduinoOcpp/Debug.h>
 
 #include <string.h>
-
+#include <algorithm>
 #include <vector>
 
 namespace ArduinoOcpp {
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 532aecd5..05504484 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -38,7 +38,7 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
         AO_DBG_ERR("Cannot declare sessionIdTag, transactionId or availability");
     }
     if (sIdTag->getBuffsize() > 0 && (*sIdTag)[0] != '\0') {
-        snprintf(idTag, min((size_t) (IDTAG_LEN_MAX + 1), sIdTag->getBuffsize()), "%s", ((const char *) *sIdTag));
+        snprintf(idTag, std::min((size_t) (IDTAG_LEN_MAX + 1), sIdTag->getBuffsize()), "%s", ((const char *) *sIdTag));
         session = true;
         connectionTimeOutTimestamp = ao_tick_ms();
         connectionTimeOutListen = true;
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
index fd34dd7c..8a326cfe 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
@@ -6,6 +6,7 @@
 #include <ArduinoOcpp/Debug.h>
 
 #include <string.h>
+#include <algorithm>
 
 using namespace ArduinoOcpp;
 
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index b4cd67ce..8b28483e 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -9,13 +9,15 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
-#if defined(ESP32) && !defined(AO_DEACTIVATE_FLASH)
+#ifndef AO_DEACTIVATE_FLASH
+#if defined(ESP32)
 #include <LITTLEFS.h>
 #define USE_FS LITTLEFS
 #else
 #include <FS.h>
 #define USE_FS SPIFFS
 #endif
+#endif
 
 #define SINGLE_CONNECTOR_ID 1
 
diff --git a/src/ao_opts.h b/src/ao_opts.h
new file mode 100644
index 00000000..a95f1cad
--- /dev/null
+++ b/src/ao_opts.h
@@ -0,0 +1,31 @@
+#ifndef AOOPTS_H
+#define AOOPTS_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+long  ao_tick_ms_impl();
+//unsigned int32_t ao_avail_heap_impl();
+
+#ifdef __cplusplus
+}
+#endif
+
+#ifndef ao_tick_ms
+#define ao_tick_ms ao_tick_ms_impl
+#endif
+
+#ifndef ao_avail_heap
+#define ao_avail_heap() 20000
+#endif
+
+//#ifndef AO_CONSOLE_PRINTF
+//#define AO_CONSOLE_PRINTF(...) ESP_LOGI("[ocpp]", __VA_ARGS__)
+//#endif
+
+#ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
+#define AO_CUSTOM_CONSOLE_MAXMSGSIZE 500
+#endif
+
+#endif
diff --git a/src/ao_opts_impl.c b/src/ao_opts_impl.c
new file mode 100644
index 00000000..61c0dae8
--- /dev/null
+++ b/src/ao_opts_impl.c
@@ -0,0 +1,29 @@
+#include "ao_opts.h"
+
+#include <stdio.h>
+#include <esp_wifi.h>
+#include <esp_system.h>
+#include <esp_event.h>
+
+#include <freertos/FreeRTOS.h>
+#include <freertos/task.h>
+#include <freertos/semphr.h>
+#include <freertos/event_groups.h>
+
+#include <esp_log.h>
+#include <esp_event.h>
+
+#include <freertos/task.h>
+#include <freertos/FreeRTOSConfig.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+long ao_tick_ms_impl() {
+    return xTaskGetTickCount() / configTICK_RATE_HZ;
+}
+
+#ifdef _cplusplus
+}
+#endif

From b36ff888e5693fa41e46fdbea57d504abba9acdd Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 5 Apr 2022 17:30:14 +0200
Subject: [PATCH 004/549] support StopTxOnEvUnplug, -InvalidId, field reason

---
 src/ArduinoOcpp/MessagesV16/CiStrings.h       |  4 ++
 .../MessagesV16/RemoteStopTransaction.cpp     |  2 +-
 src/ArduinoOcpp/MessagesV16/Reset.cpp         |  4 +-
 .../MessagesV16/StartTransaction.cpp          | 15 +++---
 .../MessagesV16/StopTransaction.cpp           | 12 +++--
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |  4 +-
 .../MessagesV16/UnlockConnector.cpp           |  4 +-
 .../ChargePointStatus/ConnectorStatus.cpp     | 52 +++++++++++++++----
 .../Tasks/ChargePointStatus/ConnectorStatus.h | 22 +++++---
 9 files changed, 87 insertions(+), 32 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/CiStrings.h b/src/ArduinoOcpp/MessagesV16/CiStrings.h
index a6a13209..2d84cdd7 100644
--- a/src/ArduinoOcpp/MessagesV16/CiStrings.h
+++ b/src/ArduinoOcpp/MessagesV16/CiStrings.h
@@ -15,7 +15,11 @@
 #define CiString255TypeLen 255
 #define CiString500TypeLen 500
 
+//specified by OCPP
 #define IDTAG_LEN_MAX CiString20TypeLen
 #define CONF_KEYLEN_MAX CiString50TypeLen
 
+//not specified by OCPP
+#define REASON_LEN_MAX CiString25TypeLen
+
 #endif
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
index 761b486d..461398b8 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
@@ -32,7 +32,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
             auto connIter = cpStatusService->getConnector(i);
             if (connIter->getTransactionId() == transactionId) {
                 canStopTransaction = true;
-                connIter->endSession();
+                connIter->endSession("Remote");
             }
         }
     }
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.cpp b/src/ArduinoOcpp/MessagesV16/Reset.cpp
index 04de2f51..9e751ca6 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Reset.cpp
@@ -21,7 +21,7 @@ void Reset::processReq(JsonObject payload) {
      * Process the application data here. Note: you have to implement the device reset procedure in your client code. You have to set
      * a onSendConfListener in which you initiate a reset (e.g. calling ESP.reset() )
      */
-    //const char *type = payload["type"] | "Invalid";
+    bool isHard = !strcmp(payload["type"] | "undefined", "Hard");
 
     if (ocppModel && ocppModel->getChargePointStatusService()) {
         auto cpsService = ocppModel->getChargePointStatusService();
@@ -29,7 +29,7 @@ void Reset::processReq(JsonObject payload) {
         for (int i = 0; i < cpsService->getNumConnectors(); i++) {
             auto connector = cpsService->getConnector(connId);
             if (connector) {
-                connector->endSession();
+                connector->endSession(isHard ? "HardReset" : "SoftReset");
             }
         }
     }
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 62e05590..d05c908f 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -21,7 +21,7 @@ StartTransaction::StartTransaction(int connectorId, const char *idTag) : connect
         AO_DBG_ERR("Format violation");
 }
 
-const char* StartTransaction::getOcppOperationType(){
+const char* StartTransaction::getOcppOperationType() {
     return "StartTransaction";
 }
 
@@ -95,17 +95,18 @@ void StartTransaction::processConf(JsonObject payload) {
     if (ocppModel)
         connector = ocppModel->getConnectorStatus(connectorId);
     
-    if (connector){
+    if (connector) {
         if (transactionRev == connector->getTransactionWriteCount()) {
-            
+
             if (!strcmp(idTagInfoStatus, "Accepted")) {
                 AO_DBG_INFO("Request has been accepted");
-                connector->setTransactionId(transactionId);
             } else {
                 AO_DBG_INFO("Request has been denied. Reason: %s", idTagInfoStatus);
-                //connector->setTransactionId(-1);
-                connector->endSession(); //something is wrong with the idTag. Abort session
+                AO_DBG_DEBUG("Set txId despite rejection");
+                connector->setIdTagInvalidated();
             }
+            
+            connector->setTransactionId(transactionId);
         }
         connector->setTransactionIdSync(transactionId);
 
@@ -123,7 +124,7 @@ void StartTransaction::processReq(JsonObject payload) {
 
 }
 
-std::unique_ptr<DynamicJsonDocument> StartTransaction::createConf(){
+std::unique_ptr<DynamicJsonDocument> StartTransaction::createConf() {
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
     JsonObject payload = doc->to<JsonObject>();
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 094888c3..17af6b60 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -10,8 +10,10 @@
 
 using ArduinoOcpp::Ocpp16::StopTransaction;
 
-StopTransaction::StopTransaction(int connectorId) : connectorId(connectorId) {
-
+StopTransaction::StopTransaction(int connectorId, const char *reason) : connectorId(connectorId) {
+    if (reason) {
+        snprintf(this->reason, REASON_LEN_MAX, "%s", reason);
+    }
 }
 
 const char* StopTransaction::getOcppOperationType(){
@@ -44,7 +46,7 @@ void StopTransaction::initiate() {
 }
 
 std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4) + (JSONDATE_LENGTH + 1)));
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(5) + (JSONDATE_LENGTH + 1) + (REASON_LEN_MAX + 1)));
     JsonObject payload = doc->to<JsonObject>();
 
     if (meterStop >= 0)
@@ -61,6 +63,10 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
         payload["transactionId"] = connector->getTransactionIdSync();
     }
 
+    if (reason[0] != '\0') {
+        payload["reason"] = reason;
+    }
+
     return doc;
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index a1b861bd..58dbf9b3 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -7,6 +7,7 @@
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/MessagesV16/CiStrings.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
@@ -16,9 +17,10 @@ class StopTransaction : public OcppMessage {
     int connectorId = 1;
     int meterStop = -1;
     OcppTimestamp otimestamp;
+    char reason [REASON_LEN_MAX] {'\0'};
 public:
 
-    StopTransaction(int connectorId);
+    StopTransaction(int connectorId, const char *reason = nullptr);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
index 9b464087..a7418c44 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
@@ -28,6 +28,8 @@ void UnlockConnector::processReq(JsonObject payload) {
 
     auto connector = ocppModel->getConnectorStatus(connectorId);
 
+    connector->endSession("UnlockCommand");
+
     std::function<bool()> unlockConnector = connector->getOnUnlockConnector();
     if (unlockConnector != nullptr) {
         cbDefined = true;
@@ -38,8 +40,6 @@ void UnlockConnector::processReq(JsonObject payload) {
     }
 
     cbUnlockSuccessful = unlockConnector();
-
-    //success
 }
 
 std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf(){
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index cf304af9..6d27b36d 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -35,6 +35,8 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
 
     connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN, true, true, true, false);
     minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
+    stopTransactionOnInvalidId = declareConfiguration<const char*>("StopTransactionOnInvalidId", "true", CONFIGURATION_FN, true, true, false, false);
+    stopTransactionOnEVSideDisconnect = declareConfiguration<const char*>("StopTransactionOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, false, false);
 
     if (!sIdTag || !transactionId || !availability) {
         AO_DBG_ERR("Cannot declare sessionIdTag, transactionId or availability");
@@ -89,12 +91,13 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
         return OcppEvseState::Preparing;
     } else {
         //Transaction is currently running
+        if ((connectorEnergizedSampler && !connectorEnergizedSampler()) ||
+                idTagInvalidated) {
+            return OcppEvseState::SuspendedEVSE;
+        }
         if (evRequestsEnergySampler && !evRequestsEnergySampler()) {
             return OcppEvseState::SuspendedEV;
         }
-        if (connectorEnergizedSampler && !connectorEnergizedSampler()) {
-            return OcppEvseState::SuspendedEVSE;
-        }
         return OcppEvseState::Charging;
     }
 }
@@ -105,6 +108,10 @@ bool ConnectorStatus::ocppPermitsCharge() {
         return false;
     }
 
+    if (idTagInvalidated) {
+        return false;
+    }
+
     OcppEvseState state = inferenceStatus();
 
     return state == OcppEvseState::Charging ||
@@ -117,6 +124,14 @@ OcppMessage *ConnectorStatus::loop() {
         *availability = AVAILABILITY_INOPERATIVE;
         saveState();
     }
+        
+    if (connectorPluggedSampler) {
+        if (getTransactionId() >= 0 && !connectorPluggedSampler()) {
+            if (!*stopTransactionOnEVSideDisconnect || strcmp(*stopTransactionOnEVSideDisconnect, "false")) {
+                endSession("EVDisconnected");
+            }
+        }
+    }
 
     /*
      * Check conditions for start or stop transaction
@@ -124,12 +139,11 @@ OcppMessage *ConnectorStatus::loop() {
     if (connectorPluggedSampler) { //only supported with connectorPluggedSampler
         if (getTransactionId() >= 0) {
             //check condition for StopTransaction
-            if (!connectorPluggedSampler() ||
-                    !session) {
+            if (!session) {
                 AO_DBG_DEBUG("Session mngt: txId=%i, connectorPlugged=%d, session=%d",
                         getTransactionId(), connectorPluggedSampler(), session);
                 AO_DBG_INFO("Session mngt: trigger StopTransaction");
-                return new StopTransaction(connectorId);
+                return new StopTransaction(connectorId, endReason[0] != '\0' ? endReason : nullptr);
             }
         } else {
             //check condition for StartTransaction
@@ -163,7 +177,7 @@ OcppMessage *ConnectorStatus::loop() {
     if (inferencedStatus != currentStatus) {
         currentStatus = inferencedStatus;
         t_statusTransition = ao_tick_ms();
-        AO_DBG_DEBUG("Status changed%s", *minimumStatusDuration > 0 ? ", will report delayed", "");
+        AO_DBG_DEBUG("Status changed%s", *minimumStatusDuration ? ", will report delayed" : "");
     }
 
     if (reportedStatus != currentStatus &&
@@ -200,13 +214,18 @@ void ConnectorStatus::beginSession(const char *sessionIdTag) {
     sIdTag->setValue(idTag, IDTAG_LEN_MAX + 1);
     saveState();
     session = true;
+    idTagInvalidated = false;
+
+    memset(endReason, '\0', REASON_LEN_MAX + 1);
 
     connectionTimeOutListen = true;
     connectionTimeOutTimestamp = ao_tick_ms();
 }
 
-void ConnectorStatus::endSession() {
-    AO_DBG_DEBUG("End session with idTag %s", idTag);
+void ConnectorStatus::endSession(const char *reason) {
+    AO_DBG_DEBUG("End session with idTag %s for reason %s, %s previous reason",
+                            idTag, reason ? reason : "undefined",
+                            endReason[0] == '\0' ? "no" : "overruled by");
     if (session) {
         memset(idTag, '\0', IDTAG_LEN_MAX + 1);
         *sIdTag = "";
@@ -214,9 +233,24 @@ void ConnectorStatus::endSession() {
     }
     session = false;
 
+    if (reason && endReason[0] == '\0') {
+        snprintf(endReason, REASON_LEN_MAX + 1, "%s", reason);
+    }
+
     connectionTimeOutListen = false;
 }
 
+void ConnectorStatus::setIdTagInvalidated() {
+    if (session) {
+        idTagInvalidated = true;
+        if (!*stopTransactionOnInvalidId || strcmp(*stopTransactionOnInvalidId, "false")) {
+            endSession("DeAuthorized");
+        }
+    } else {
+        AO_DBG_WARN("Cannot invalidate IdTag outside of session");
+    }
+}
+
 const char *ConnectorStatus::getSessionIdTag() {
     return session ? idTag : nullptr;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 6a1879dc..fb9d3ff0 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -28,15 +28,17 @@ class ConnectorStatus {
     
     const int connectorId;
 
-    std::shared_ptr<Configuration<int>> availability {nullptr};
+    std::shared_ptr<Configuration<int>> availability;
 
     bool session = false;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
-    std::shared_ptr<Configuration<const char *>> sIdTag {nullptr};
-    std::shared_ptr<Configuration<int>> transactionId {nullptr};
+    bool idTagInvalidated {false}; //if StartTransaction.conf() has status != "Accepted"
+    std::shared_ptr<Configuration<const char *>> sIdTag;
+    std::shared_ptr<Configuration<int>> transactionId;
     int transactionIdSync = -1;
+    char endReason [REASON_LEN_MAX + 1] = {'\0'};
 
-    std::shared_ptr<Configuration<int>> connectionTimeOut {nullptr}; //in seconds
+    std::shared_ptr<Configuration<int>> connectionTimeOut; //in seconds
     bool connectionTimeOutListen {false};
     ulong connectionTimeOutTimestamp {0}; //in milliseconds
 
@@ -47,11 +49,17 @@ class ConnectorStatus {
     const char *getErrorCode();
 
     OcppEvseState currentStatus = OcppEvseState::NOT_SET;
-    std::shared_ptr<Configuration<int>> minimumStatusDuration {nullptr}; //in seconds
+    std::shared_ptr<Configuration<int>> minimumStatusDuration; //in seconds
     OcppEvseState reportedStatus = OcppEvseState::NOT_SET;
     ulong t_statusTransition = 0;
 
+    //std::function<std::unique_ptr<OcppMessage>()> startTransactionBehavior;
+    //std::function<std::unique_ptr<OcppMessage>(const char* stopReason)> stopTransactionBehavior;
+
     std::function<bool()> onUnlockConnector {nullptr};
+
+    std::shared_ptr<Configuration<const char*>> stopTransactionOnInvalidId;
+    std::shared_ptr<Configuration<const char*>> stopTransactionOnEVSideDisconnect;
 public:
     ConnectorStatus(OcppModel& context, int connectorId);
 
@@ -66,7 +74,8 @@ class ConnectorStatus {
      * (given by ConnectorPluggedSampler and no error code)
      */
     void beginSession(const char *idTag);
-    void endSession();
+    void endSession(const char *reason = nullptr);
+    void setIdTagInvalidated(); //if StartTransaction.conf() has status != "Accepted"
     const char *getSessionIdTag();
     int getTransactionId();
     int getTransactionIdSync();
@@ -74,7 +83,6 @@ class ConnectorStatus {
     void setTransactionId(int id);
     void setTransactionIdSync(int id);
 
-
     int getAvailability();
     void setAvailability(bool available);
     void setAuthorizationProvider(std::function<const char *()> authorization);

From 38bdce6d91ee1060100be84c6cea53bb4acaa166 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 8 Apr 2022 17:09:31 +0200
Subject: [PATCH 005/549] begin with c facade

---
 CMakeLists.txt        |  3 ++-
 README.md             |  4 ++++
 src/ArduinoOcpp_c.cpp | 22 ++++++++++++++++++++++
 src/ArduinoOcpp_c.h   | 18 ++++++++++++++++++
 src/ao_opts_impl.c    |  2 +-
 5 files changed, 47 insertions(+), 2 deletions(-)
 create mode 100644 src/ArduinoOcpp_c.cpp
 create mode 100644 src/ArduinoOcpp_c.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index be8c56fc..176999e2 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -47,11 +47,12 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
     src/ArduinoOcpp.cpp
+    src/ArduinoOcpp_c.cpp
     src/ao_opts_impl.c
 )
 
 idf_component_register(SRCS ${AO_SRC}
-                    INCLUDE_DIRS "./src")
+                    INCLUDE_DIRS "./src" "${PROJECT_DIR}/include")
 
 target_compile_options(${COMPONENT_TARGET} PUBLIC
     -DAO_CUSTOM_WS
diff --git a/README.md b/README.md
index 35e19a87..facb1c3c 100644
--- a/README.md
+++ b/README.md
@@ -34,6 +34,10 @@ For simple chargers, the necessary hardware and internet integration is usually
 
 **This feature branch is WIP. A usage guide will follow.**
 
+## Dependencies
+
+- [bblanchon/ArduinoJson](https://github.com/bblanchon/ArduinoJson)
+
 ## Supported operations
 
 | Operation name | supported | in progress | not supported |
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
new file mode 100644
index 00000000..7400cc89
--- /dev/null
+++ b/src/ArduinoOcpp_c.cpp
@@ -0,0 +1,22 @@
+#include "ArduinoOcpp_c.h"
+#include "ArduinoOcpp.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+void ao_initialize() {
+    //OCPP_initialize("echo.websocket.events", 80, "ws://echo.websocket.events/");
+}
+
+void ao_loop() {
+    OCPP_loop();
+}
+
+void ao_bootNotification() {
+    bootNotification("model", "vendor");
+}
+
+#ifdef __cplusplus
+}
+#endif
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
new file mode 100644
index 00000000..54eedd24
--- /dev/null
+++ b/src/ArduinoOcpp_c.h
@@ -0,0 +1,18 @@
+#ifndef ARDUINOOCPP_C_H
+#define ARDUINOOCPP_C_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+void ao_initialize();
+
+void ao_loop();
+
+void ao_bootNotification();
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
diff --git a/src/ao_opts_impl.c b/src/ao_opts_impl.c
index 61c0dae8..41839036 100644
--- a/src/ao_opts_impl.c
+++ b/src/ao_opts_impl.c
@@ -24,6 +24,6 @@ long ao_tick_ms_impl() {
     return xTaskGetTickCount() / configTICK_RATE_HZ;
 }
 
-#ifdef _cplusplus
+#ifdef __cplusplus
 }
 #endif

From 0f1f23616dc4d631b9b634febfe68b8e67478db3 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 10 Apr 2022 18:04:24 +0200
Subject: [PATCH 006/549] add ocpp socket type and callbacks in c adapter

---
 src/ArduinoOcpp/Platform.h                    |  2 +-
 .../SimpleOcppOperationFactory.cpp            |  6 ---
 src/ArduinoOcpp/SimpleOcppOperationFactory.h  |  1 -
 src/ArduinoOcpp_c.cpp                         | 37 +++++++++++++++----
 src/ArduinoOcpp_c.h                           | 16 +++++++-
 5 files changed, 44 insertions(+), 18 deletions(-)

diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 66cb0d97..319239d1 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -23,7 +23,7 @@ void ao_console_out(const char *msg);
                 char msg [AO_CUSTOM_CONSOLE_MAXMSGSIZE]; \
                 snprintf(msg, AO_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__); \
                 sprintf(msg + AO_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
-                ao_console_out(msg); \
+                ArduinoOcpp::ao_console_out(msg); \
             } while (0)
 #else
 #define ao_set_console_out(X) \
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
index 1b1ca459..590818e5 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
@@ -69,12 +69,6 @@ void setOnBootNotificationRequestListener(OnReceiveReqListener listener){
     deinit_afterwards(onBootNotificationRequest);
 }
 
-OnReceiveReqListener onTargetValuesRequest;
-void setOnTargetValuesRequestListener(OnReceiveReqListener listener) {
-    onTargetValuesRequest = listener;
-    deinit_afterwards(onTargetValuesRequest);
-}
-
 OnReceiveReqListener onSetChargingProfileRequest;
 void setOnSetChargingProfileRequestListener(OnReceiveReqListener listener){
     onSetChargingProfileRequest = listener;
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.h b/src/ArduinoOcpp/SimpleOcppOperationFactory.h
index c9ad0726..875b90ad 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.h
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.h
@@ -26,7 +26,6 @@ void registerCustomOcppMessage(const char *messageType, OcppMessageCreator ocppM
 
 void setOnAuthorizeRequestListener(OnReceiveReqListener onReceiveReq);
 void setOnBootNotificationRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnTargetValuesRequestListener(OnReceiveReqListener onReceiveReq);
 void setOnSetChargingProfileRequestListener(OnReceiveReqListener onReceiveReq);
 void setOnStartTransactionRequestListener(OnReceiveReqListener onReceiveReq);
 void setOnTriggerMessageRequestListener(OnReceiveReqListener onReceiveReq);
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 7400cc89..11f9969d 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -1,22 +1,43 @@
 #include "ArduinoOcpp_c.h"
 #include "ArduinoOcpp.h"
 
-#ifdef __cplusplus
-extern "C" {
-#endif
+#include <ArduinoOcpp/Debug.h>
+
+ArduinoOcpp::OcppSocket *ocppSocket = nullptr;
 
-void ao_initialize() {
+extern "C" void ao_initialize(AO_OcppSocket *osock) {
     //OCPP_initialize("echo.websocket.events", 80, "ws://echo.websocket.events/");
+    if (!osock) {
+        AO_DBG_ERR("osock is null");
+    }
+
+    ocppSocket = reinterpret_cast<ArduinoOcpp::OcppSocket*>(osock);
+
+    OCPP_initialize(*ocppSocket);
 }
 
-void ao_loop() {
+extern "C" void ao_loop() {
     OCPP_loop();
 }
 
-void ao_bootNotification() {
+extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation) {
     bootNotification("model", "vendor");
 }
 
-#ifdef __cplusplus
-}
+#ifndef AO_RECEIVE_PAYLOAD_BUFSIZE
+#define AO_RECEIVE_PAYLOAD_BUFSIZE 1024
 #endif
+
+char ao_recv_payload_buff [AO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
+
+extern "C" void ao_onResetRequest(OnOcppMessage onRequest) {
+    OnReceiveReqListener cb = [onRequest] (JsonObject payload) {
+        auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+        if (len <= 0) {
+            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+        }
+        onRequest(len > 0 ? ao_recv_payload_buff : nullptr, len);
+    };
+    setOnResetReceiveReq(cb);
+}
+
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 54eedd24..5faf07a9 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -1,15 +1,27 @@
 #ifndef ARDUINOOCPP_C_H
 #define ARDUINOOCPP_C_H
 
+#include <stddef.h>
+
+struct AO_OcppSocket;
+typedef struct AO_OcppSocket AO_OcppSocket;
+
+typedef void (*OnOcppMessage) (const char *payload, size_t len);
+typedef void (*OnOcppAbort)   ();
+typedef void (*OnOcppTimeout) ();
+typedef void (*OnOcppError)   (const char *code, const char *description, const char *details_json, size_t details_len);
+
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-void ao_initialize();
+void ao_initialize(AO_OcppSocket *osock);
 
 void ao_loop();
 
-void ao_bootNotification();
+void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation);
+
+void ao_onResetRequest(OnOcppMessage onRequest);
 
 #ifdef __cplusplus
 }

From 7d451a2dc9c58b61fec3e494e352b0597bee8ac3 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 18 Apr 2022 09:45:10 +0200
Subject: [PATCH 007/549] added functions

---
 src/ArduinoOcpp_c.cpp |  4 ++--
 src/ArduinoOcpp_c.h   | 14 ++++++++++----
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 11f9969d..ad0f0701 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -5,7 +5,7 @@
 
 ArduinoOcpp::OcppSocket *ocppSocket = nullptr;
 
-extern "C" void ao_initialize(AO_OcppSocket *osock) {
+extern "C" void ao_initialize(AOcppSocket *osock) {
     //OCPP_initialize("echo.websocket.events", 80, "ws://echo.websocket.events/");
     if (!osock) {
         AO_DBG_ERR("osock is null");
@@ -20,7 +20,7 @@ extern "C" void ao_loop() {
     OCPP_loop();
 }
 
-extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation) {
+extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
     bootNotification("model", "vendor");
 }
 
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 5faf07a9..7efb3878 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -3,8 +3,8 @@
 
 #include <stddef.h>
 
-struct AO_OcppSocket;
-typedef struct AO_OcppSocket AO_OcppSocket;
+struct AOcppSocket;
+typedef struct AOcppSocket AOcppSocket;
 
 typedef void (*OnOcppMessage) (const char *payload, size_t len);
 typedef void (*OnOcppAbort)   ();
@@ -15,11 +15,17 @@ typedef void (*OnOcppError)   (const char *code, const char *description, const
 extern "C" {
 #endif
 
-void ao_initialize(AO_OcppSocket *osock);
+void ao_initialize(AOcppSocket *osock);
 
 void ao_loop();
 
-void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation);
+void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
 void ao_onResetRequest(OnOcppMessage onRequest);
 

From 4af1e7908764304a06daeac2b8b2c6cebb852673 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 19 Apr 2022 14:59:14 +0200
Subject: [PATCH 008/549] All function declarations for c-facade

---
 src/ArduinoOcpp_c.h | 73 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 72 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 7efb3878..fb74c201 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -11,14 +11,65 @@ typedef void (*OnOcppAbort)   ();
 typedef void (*OnOcppTimeout) ();
 typedef void (*OnOcppError)   (const char *code, const char *description, const char *details_json, size_t details_len);
 
+typedef float (*SamplerFloat)();
+typedef int   (*SamplerInt)();
+typedef bool  (*SamplerBool)();
+typedef const char* (*SamplerString)();
+
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 void ao_initialize(AOcppSocket *osock);
 
+void ao_deinitialize();
+
 void ao_loop();
 
+/*
+ * Feed lib with HW related data
+ */
+
+void ao_setPowerActiveImportSampler(SamplerFloat power);
+
+void ao_setEnergyActiveImportSampler(SamplerFloat energy);
+
+void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy);
+
+void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized);
+
+void ao_setConnectorPluggedSampler(SamplerBool connectorPlugged);
+
+//void setConnectorFaultedSampler(SamplerBool connectorFailed);
+
+void ao_addConnectorErrorCodeSampler(SamplerString connectorErrorCode);
+
+/*
+ * Execute HW related operations on EVSE
+ */
+
+void ao_onChargingRateLimitChange(void (*chargingRateChanged)(float));
+
+void ao_onUnlockConnector(SamplerBool unlockConnector); //true: success, false: failure
+
+/*
+ * Generic listeners for OCPP operations initiated by Central System
+ */
+
+void ao_onSetChargingProfileRequest(OnOcppMessage onRequest); //optional
+
+void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf); //important, energize the power plug here and capture the idTag
+
+void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf); //important, de-energize the power plug here
+void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest); //optional, to de-energize the power plug immediately
+
+void ao_onResetSendConf(OnOcppMessage onSendConf); //important, reset your device here (i.e. call ESP.reset();)
+void ao_onResetRequest(OnOcppMessage onRequest); //alternative: start reset timer here
+
+/*
+ * Initiate OCPP operations
+ */
+
 void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
 void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
@@ -27,7 +78,27 @@ void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcpp
 
 void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
-void ao_onResetRequest(OnOcppMessage onRequest);
+/*
+ * Access OCPP state
+ */
+
+int ao_getTransactionId(); //returns the ID of the current transaction. Returns -1 if called before or after an transaction
+
+bool ao_ocppPermitsCharge();
+
+bool ao_isAvailable(); //if the charge point is operative or inoperative
+
+/*
+ * Charging session management
+ */
+
+void ao_beginSession(const char *idTag);
+
+void ao_endSession();
+
+bool ao_isInSession();
+
+const char *ao_getSessionIdTag();
 
 #ifdef __cplusplus
 }

From 5bd8b4c9f328e9beddbc669807f651865a8f2598 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 29 Apr 2022 17:56:05 +0200
Subject: [PATCH 009/549] debug out fixes

---
 CMakeLists.txt             | 3 ++-
 src/ArduinoOcpp/Platform.h | 7 ++++---
 src/ArduinoOcpp_c.cpp      | 4 ++++
 src/ArduinoOcpp_c.h        | 2 ++
 src/ao_opts.h              | 2 +-
 src/ao_opts_impl.c         | 3 ++-
 6 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 176999e2..210f3d11 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -57,4 +57,5 @@ idf_component_register(SRCS ${AO_SRC}
 target_compile_options(${COMPONENT_TARGET} PUBLIC
     -DAO_CUSTOM_WS
     -DAO_CUSTOM_CONSOLE
-    -DAO_DEACTIVATE_FLASH)
+    -DAO_DEACTIVATE_FLASH
+    -DAO_DBG_LEVEL=AO_DL_DEBUG)
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 319239d1..f6dfb757 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -10,7 +10,7 @@
 #ifdef AO_CUSTOM_CONSOLE
 
 #ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
-#define AO_CUSTOM_CONSOLE_MAXMSGSIZE 128
+#define AO_CUSTOM_CONSOLE_MAXMSGSIZE 196
 #endif
 
 void ao_set_console_out(void (*console_out)(const char *msg));
@@ -21,8 +21,9 @@ void ao_console_out(const char *msg);
 #define AO_CONSOLE_PRINTF(X, ...) \
             do { \
                 char msg [AO_CUSTOM_CONSOLE_MAXMSGSIZE]; \
-                snprintf(msg, AO_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__); \
-                sprintf(msg + AO_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
+                if (snprintf(msg, AO_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__) < 0) { \
+                    sprintf(msg + AO_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
+                } \
                 ArduinoOcpp::ao_console_out(msg); \
             } while (0)
 #else
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index ad0f0701..4511f1ac 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -20,6 +20,10 @@ extern "C" void ao_loop() {
     OCPP_loop();
 }
 
+extern "C" void ao_set_console_out_c(void (*console_out)(const char *msg)) {
+    ao_set_console_out(console_out);
+}
+
 extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
     bootNotification("model", "vendor");
 }
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index fb74c201..c44db5fc 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -26,6 +26,8 @@ void ao_deinitialize();
 
 void ao_loop();
 
+void ao_set_console_out_c(void (*console_out)(const char *msg));
+
 /*
  * Feed lib with HW related data
  */
diff --git a/src/ao_opts.h b/src/ao_opts.h
index a95f1cad..8f76097f 100644
--- a/src/ao_opts.h
+++ b/src/ao_opts.h
@@ -25,7 +25,7 @@ long  ao_tick_ms_impl();
 //#endif
 
 #ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
-#define AO_CUSTOM_CONSOLE_MAXMSGSIZE 500
+#define AO_CUSTOM_CONSOLE_MAXMSGSIZE 192
 #endif
 
 #endif
diff --git a/src/ao_opts_impl.c b/src/ao_opts_impl.c
index 41839036..5238ad01 100644
--- a/src/ao_opts_impl.c
+++ b/src/ao_opts_impl.c
@@ -21,7 +21,8 @@ extern "C" {
 #endif
 
 long ao_tick_ms_impl() {
-    return xTaskGetTickCount() / configTICK_RATE_HZ;
+    //return xTaskGetTickCount() / configTICK_RATE_HZ;
+    return xTaskGetTickCount() * (1000 / configTICK_RATE_HZ);
 }
 
 #ifdef __cplusplus

From 1d8946dcaf4eb8a62ab3cbf96fbebfc46c3a6ad7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 1 May 2022 21:54:35 +0200
Subject: [PATCH 010/549] adapt c-style callback functions for AO

---
 src/ArduinoOcpp_c.cpp | 32 ++++++++++++++++++++++++++++----
 src/ao_opts.h         |  2 +-
 src/ao_opts_impl.c    |  4 ++--
 3 files changed, 31 insertions(+), 7 deletions(-)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 4511f1ac..7b50aa69 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -24,16 +24,40 @@ extern "C" void ao_set_console_out_c(void (*console_out)(const char *msg)) {
     ao_set_console_out(console_out);
 }
 
-extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    bootNotification("model", "vendor");
-}
-
 #ifndef AO_RECEIVE_PAYLOAD_BUFSIZE
 #define AO_RECEIVE_PAYLOAD_BUFSIZE 1024
 #endif
 
 char ao_recv_payload_buff [AO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
 
+std::function<void(JsonObject)> wrapCstyleOcppCb(OnOcppMessage cb) {
+    return [cb] (JsonObject payload) {
+        auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+        if (len <= 0) {
+            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+        }
+        cb(len > 0 ? ao_recv_payload_buff : nullptr, len);
+    };
+}
+
+std::function<void()> wrapCstyleOcppCb(void (*cb)()) {
+    return cb;
+}
+
+ArduinoOcpp::OnReceiveErrorListener wrapCstyleOcppCb(OnOcppError cb) {
+    return [cb] (const char *code, const char *description, JsonObject details) {
+        auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+        if (len <= 0) {
+            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+        }
+        cb(code, description, len > 0 ? ao_recv_payload_buff : "", len);
+    };
+}
+
+extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    bootNotification("model", "vendor", wrapCstyleOcppCb(onConfirmation), wrapCstyleOcppCb(onAbort), wrapCstyleOcppCb(onTimeout), wrapCstyleOcppCb(onError));
+}
+
 extern "C" void ao_onResetRequest(OnOcppMessage onRequest) {
     OnReceiveReqListener cb = [onRequest] (JsonObject payload) {
         auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
diff --git a/src/ao_opts.h b/src/ao_opts.h
index 8f76097f..5a19cede 100644
--- a/src/ao_opts.h
+++ b/src/ao_opts.h
@@ -5,7 +5,7 @@
 extern "C" {
 #endif
 
-long  ao_tick_ms_impl();
+unsigned long ao_tick_ms_impl();
 //unsigned int32_t ao_avail_heap_impl();
 
 #ifdef __cplusplus
diff --git a/src/ao_opts_impl.c b/src/ao_opts_impl.c
index 5238ad01..ce1b6559 100644
--- a/src/ao_opts_impl.c
+++ b/src/ao_opts_impl.c
@@ -20,9 +20,9 @@
 extern "C" {
 #endif
 
-long ao_tick_ms_impl() {
+unsigned long ao_tick_ms_impl() {
     //return xTaskGetTickCount() / configTICK_RATE_HZ;
-    return xTaskGetTickCount() * (1000 / configTICK_RATE_HZ);
+    return (xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ;
 }
 
 #ifdef __cplusplus

From 8eb95d06dfc90d26af8daeebea3f0a9653fa5c84 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 3 May 2022 16:00:00 +0200
Subject: [PATCH 011/549] Customizable meter values format

---
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp   |   7 +-
 src/ArduinoOcpp/MessagesV16/MeterValues.h     |   2 +-
 .../MessagesV16/TriggerMessage.cpp            |   4 +-
 .../Metering/ConnectorMeterValuesRecorder.cpp | 228 +++++++++++-------
 .../Metering/ConnectorMeterValuesRecorder.h   |  34 ++-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp | 108 +++++++++
 src/ArduinoOcpp/Tasks/Metering/MeterValue.h   |  52 ++--
 .../Tasks/Metering/MeteringService.cpp        |   4 +-
 .../Tasks/Metering/MeteringService.h          |   2 +-
 .../Tasks/Metering/SampledValue.cpp           |  67 +++++
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h |  56 ++---
 11 files changed, 389 insertions(+), 175 deletions(-)
 create mode 100644 src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp

diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index 26c60593..97863a93 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -15,12 +15,9 @@ MeterValues::MeterValues() {
     
 }
 
-MeterValues::MeterValues(const std::vector<std::unique_ptr<MeterValue>>& meterValue, int connectorId, int transactionId) 
-      : connectorId{connectorId}, transactionId{transactionId} {
+MeterValues::MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, int connectorId, int transactionId) 
+      : meterValue{std::move(meterValue)}, connectorId{connectorId}, transactionId{transactionId} {
 
-    for (auto value = meterValue.begin(); value != meterValue.end(); value++) {
-        this->meterValue.push_back(std::unique_ptr<MeterValue>(new MeterValue(**value)));
-    }
 }
 
 MeterValues::~MeterValues(){
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.h b/src/ArduinoOcpp/MessagesV16/MeterValues.h
index 5fba8009..24f4be0e 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.h
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.h
@@ -22,7 +22,7 @@ class MeterValues : public OcppMessage {
     int transactionId = -1;
 
 public:
-    MeterValues(const std::vector<std::unique_ptr<MeterValue>>& meterValue, int connectorId, int transactionId);
+    MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, int connectorId, int transactionId);
 
     MeterValues(); //for debugging only. Make this for the server pendant
 
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
index 3ab778be..3673a589 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
@@ -31,10 +31,10 @@ void TriggerMessage::processReq(JsonObject payload) {
             if (connectorId < 0) {
                 auto nConnectors = mService->getNumConnectors();
                 for (decltype(nConnectors) i = 0; i < nConnectors; i++) {
-                    triggeredOperations.push_back(mService->takeMeterValuesNow(i));
+                    triggeredOperations.push_back(mService->takeTriggeredMeterValues(i));
                 }
             } else if (connectorId < mService->getNumConnectors()) {
-                triggeredOperations.push_back(mService->takeMeterValuesNow(connectorId));
+                triggeredOperations.push_back(mService->takeTriggeredMeterValues(connectorId));
             } else {
                 errorCode = "PropertyConstraintViolation";
             }
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 1d71648f..ffc6b91f 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -16,117 +16,162 @@ using namespace ArduinoOcpp::Ocpp16;
 ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, int connectorId)
         : context(context), connectorId{connectorId} {
 
-    MeterValueSampleInterval = declareConfiguration("MeterValueSampleInterval", 60);
+    auto MeterValuesSampledData = declareConfiguration<const char*>(
+        "MeterValuesSampledData",
+        "Energy.Active.Import.Register,Power.Active.Import",
+        CONFIGURATION_FN,
+        true,true,true,false
+    );
     MeterValuesSampledDataMaxLength = declareConfiguration("MeterValuesSampledDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
-}
-
-void ConnectorMeterValuesRecorder::takeSample() {
-    if (meterValueSamplers.empty()) return;
-
-    std::unique_ptr<MeterValue> sample;
-    if (context.getOcppTime().isValid()) {
-        sample.reset(new MeterValue(context.getOcppTime().getOcppTimestampNow()));
-    }
-    if (!sample) {
-        return;
-    }
-
-    for (auto mvs = meterValueSamplers.begin(); mvs != meterValueSamplers.end(); mvs++) {
-        sample->addSampledValue((*mvs)->takeValue());
-    }
-
-    meterValue.push_back(std::move(sample));
+    MeterValueSampleInterval = declareConfiguration("MeterValueSampleInterval", 60);
+    
+    auto StopTxnSampledData = declareConfiguration<const char*>(
+        "StopTxnSampledData",
+        "",
+        CONFIGURATION_FN,
+        true,true,true,false
+    );
+    StopTxnSampledDataMaxLength = declareConfiguration("StopTxnSampledDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
+    
+    auto MeterValuesAlignedData = declareConfiguration<const char*>(
+        "MeterValuesAlignedData",
+        "Energy.Active.Import.Register,Power.Active.Import",
+        CONFIGURATION_FN,
+        true,true,true,false
+    );
+    MeterValuesAlignedDataMaxLength = declareConfiguration("MeterValuesAlignedDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
+    ClockAlignedDataInterval  = declareConfiguration("ClockAlignedDataInterval", 0);
+    
+    auto StopTxnAlignedData = declareConfiguration<const char*>(
+        "StopTxnAlignedData",
+        "",
+        CONFIGURATION_FN,
+        true,true,true,false
+    );
+    StopTxnAlignedDataMaxLength = declareConfiguration("StopTxnAlignedDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
+    
+    sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesSampledData)); AO_DBG_DEBUG("After MeterValuesSampledData");
+    alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData)); AO_DBG_DEBUG("After MeterValuesAlignedData");
+    stopTxnSampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnSampledData)); AO_DBG_DEBUG("After StopTxnSampledData");
+    stopTxnAlignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnAlignedData)); AO_DBG_DEBUG("After StopTxnAlignedData");
 }
 
 OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
-    if (*MeterValueSampleInterval < 1) {
-        //Metering off by definition
-        clear();
-        return nullptr;
-    }
-
-    /*
-     * First: check if there was a transaction break (i.e. transaction either started or stopped; transactionId changed)
-     */ 
-    auto connector = context.getConnectorStatus(connectorId);
-    if (connector && connector->getTransactionId() != lastTransactionId) {
-        //transaction break occured!
-        auto result = toMeterValues();
-        lastTransactionId = connector->getTransactionId();
-        return result;
-    }
-
-    /*
-    * Calculate energy consumption which finally should be reportet to the Central Station in a MeterValues.req.
-    * This code uses the EVSE's own energy register, if available (i.e. if energySampler is set). Otherwise it
-    * uses the power sampler.
-    * If no powerSampler is available, estimate the energy consumption taking the Charging Schedule and CP Status
-    * into account.
-    */
-    if (ao_tick_ms() - lastSampleTime >= (ulong) (*MeterValueSampleInterval * 1000)) {
-        takeSample();
-        lastSampleTime = ao_tick_ms();
+    if (*ClockAlignedDataInterval >= 1) {
+
+         if (alignedData.size() >= *MeterValuesAlignedDataMaxLength) {
+            auto meterValues = new MeterValues(std::move(alignedData), connectorId, -1);
+            alignedData.clear();
+            return meterValues;
+        }
+
+        auto& timestampNow = context.getOcppTime().getOcppTimestampNow();
+        auto dt = nextAlignedTime - timestampNow;
+        if (dt <= 0 ||                              //normal case: interval elapsed
+                dt > *ClockAlignedDataInterval) {   //special case: clock has been adjusted or first run
+
+            AO_DBG_DEBUG("Clock aligned measurement %ds: %s", dt,
+                abs(dt) <= 60 ?
+                "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore"); abs(-123);
+            if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
+                auto alignedMeterValues = alignedDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SampleClock);
+                if (alignedMeterValues) {
+                    alignedData.push_back(std::move(alignedMeterValues));
+                }
+
+                if (stopTxnAlignedData.size() + 1 < (size_t) (*StopTxnAlignedDataMaxLength)) {
+                    //ensure that collection keeps one free data slot for final value at StopTransaction
+                    auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SampleClock);
+                    if (alignedStopTx) {
+                        stopTxnAlignedData.push_back(std::move(alignedStopTx));
+                    }
+                }
+            }
+            
+            OcppTimestamp midnightBase = OcppTimestamp(2010,0,0,0,0,0);
+            auto intervall = timestampNow - midnightBase;
+            intervall %= 3600 * 24;
+            OcppTimestamp midnight = timestampNow - intervall;
+            intervall += *ClockAlignedDataInterval;
+            if (intervall >= 3600 * 24) {
+                //next measurement is tomorrow; set to precisely 00:00 
+                nextAlignedTime = midnight;
+                nextAlignedTime += 3600 * 24;
+            } else {
+                intervall /= *ClockAlignedDataInterval;
+                nextAlignedTime = midnight + (intervall * *ClockAlignedDataInterval);
+            }
+        }
+    } else {
+        alignedData.clear();
+        stopTxnAlignedData.clear();
     }
 
+    if (*MeterValueSampleInterval >= 1) {
+        //record periodic tx data
+
+        if (sampledData.size() >= *MeterValuesSampledDataMaxLength) {
+            auto meterValues = new MeterValues(std::move(sampledData), connectorId, lastTransactionId);
+            sampledData.clear();
+            return meterValues;
+        }
+
+        auto connector = context.getConnectorStatus(connectorId);
+        if (connector && connector->getTransactionId() != lastTransactionId) {
+            //transaction break
+            MeterValues *meterValues = nullptr;
+            if (!sampledData.empty()) {
+                meterValues = new MeterValues(std::move(sampledData), connectorId, lastTransactionId);
+                sampledData.clear();
+            }
+            lastTransactionId = connector->getTransactionId();
+            lastSampleTime = ao_tick_ms();
+            return meterValues;
+        }
+
+        if (ao_tick_ms() - lastSampleTime >= (ulong) (*MeterValueSampleInterval * 1000)) {
+            auto sampleMeterValues = sampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SamplePeriodic);
+            if (sampleMeterValues) {
+                sampledData.push_back(std::move(sampleMeterValues));
+            }
+
+            if (stopTxnSampledData.size() + 1 < (size_t) (*StopTxnSampledDataMaxLength)) {
+                //ensure that collection keeps one free data slot for final value at StopTransaction
+                auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SamplePeriodic);
+                if (sampleStopTx) {
+                    stopTxnSampledData.push_back(std::move(sampleStopTx));
+                }
+            }
+            lastSampleTime = ao_tick_ms();
+        }   
 
-    /*
-    * Is the value buffer already full? If yes, return MeterValues message
-    */
-    if (((int) meterValue.size()) >= (int) *MeterValuesSampledDataMaxLength) {
-        auto result = toMeterValues();
-        return result;
+    } else {
+        sampledData.clear();
+        stopTxnSampledData.clear();
     }
 
     return nullptr; //successful method completition. Currently there is no reason to send a MeterValues Msg.
 }
 
-OcppMessage *ConnectorMeterValuesRecorder::toMeterValues() {
-    if (meterValue.empty()) {
-        AO_DBG_DEBUG("Checking if to send MeterValues ... No");
-        clear();
-        return nullptr;
-    } else {
-        auto result = new MeterValues(meterValue, connectorId, lastTransactionId);
-        clear();
-        return result;
-    }
-}
-
-OcppMessage *ConnectorMeterValuesRecorder::takeMeterValuesNow() {
-
-    if (meterValueSamplers.empty()) {
-        return nullptr;
-    }
+OcppMessage *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
 
-    std::unique_ptr<MeterValue> value;
+    auto sample = sampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::Trigger);
 
-    if (context.getOcppTime().isValid()) {
-        value.reset(new MeterValue(context.getOcppTime().getOcppTimestampNow()));
-    }
-
-    if (!value) {
+    if (!sample) {
         return nullptr;
     }
 
-    for (auto mvs = meterValueSamplers.begin(); mvs != meterValueSamplers.end(); mvs++) {
-        value->addSampledValue((*mvs)->takeValue());
-    }
-
     int txId_now = -1;
     auto connector = context.getConnectorStatus(connectorId);
     if (connector) {
         txId_now = connector->getTransactionId();
     }
 
-    decltype(meterValue) mv_now;
-    mv_now.push_back(std::move(value));
-
-    return new MeterValues(mv_now, connectorId, txId_now);
-}
+    decltype(sampledData) mv_now;
+    mv_now.push_back(std::move(sample));
 
-void ConnectorMeterValuesRecorder::clear() {
-    meterValue.clear();
+    return new MeterValues(std::move(mv_now), connectorId, txId_now);
 }
 
 void ConnectorMeterValuesRecorder::setPowerSampler(PowerSampler ps){
@@ -138,14 +183,17 @@ void ConnectorMeterValuesRecorder::setEnergySampler(EnergySampler es){
 }
 
 void ConnectorMeterValuesRecorder::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
-    meterValueSamplers.push_back(std::move(meterValueSampler));
+    if (!meterValueSampler->getMeasurand().compare("Energy.Active.Import.Register")) {
+        energySamplerIndex = samplers.size();
+    }
+    samplers.push_back(std::move(meterValueSampler));
 }
 
 int32_t ConnectorMeterValuesRecorder::readEnergyActiveImportRegister() {
-    if (energySampler != nullptr) {
-        return energySampler();
+    if (energySamplerIndex >= 0 && energySamplerIndex < samplers.size()) {
+        return samplers[energySamplerIndex]->takeValue(ReadingContext::NOT_SET)->toInteger();
     } else {
         AO_DBG_DEBUG("Called readEnergyActiveImportRegister(), but no energySampler or handling strategy set");
-        return 0.f;
+        return 0;
     }
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index 1148ee7e..502724d1 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -30,23 +30,39 @@ class ConnectorMeterValuesRecorder {
     OcppModel& context;
     
     const int connectorId;
+    
+    std::vector<std::unique_ptr<MeterValue>> sampledData;
+    std::vector<std::unique_ptr<MeterValue>> alignedData;
+    std::vector<std::unique_ptr<MeterValue>> stopTxnSampledData;
+    std::vector<std::unique_ptr<MeterValue>> stopTxnAlignedData;
+
+    std::unique_ptr<MeterValueBuilder> sampledDataBuilder;
+    std::unique_ptr<MeterValueBuilder> alignedDataBuilder;
+    std::unique_ptr<MeterValueBuilder> stopTxnSampledDataBuilder;
+    std::unique_ptr<MeterValueBuilder> stopTxnAlignedDataBuilder;
 
-    std::vector<std::unique_ptr<MeterValue>> meterValue;
+    std::shared_ptr<Configuration<const char *>> sampledDataSelect;
+    std::shared_ptr<Configuration<const char *>> alignedDataSelect;
+    std::shared_ptr<Configuration<const char *>> stopTxnSampledDataSelect;
+    std::shared_ptr<Configuration<const char *>> stopTxnAlignedDataSelect;
 
     ulong lastSampleTime = 0; //0 means not charging right now
+    OcppTimestamp nextAlignedTime;
     float lastPower;
     int lastTransactionId = -1;
  
     PowerSampler powerSampler = nullptr;
     EnergySampler energySampler = nullptr;
-    std::vector<std::unique_ptr<SampledValueSampler>> meterValueSamplers;
+    std::vector<std::unique_ptr<SampledValueSampler>> samplers;
+    int energySamplerIndex {-1};
 
-    std::shared_ptr<Configuration<int>> MeterValueSampleInterval = nullptr;
-    std::shared_ptr<Configuration<int>> MeterValuesSampledDataMaxLength = nullptr;
+    std::shared_ptr<Configuration<int>> MeterValueSampleInterval;
+    std::shared_ptr<Configuration<int>> MeterValuesSampledDataMaxLength;
+    std::shared_ptr<Configuration<int>> StopTxnSampledDataMaxLength;
 
-    void takeSample();
-    OcppMessage *toMeterValues();
-    void clear();
+    std::shared_ptr<Configuration<int>> ClockAlignedDataInterval;
+    std::shared_ptr<Configuration<int>> MeterValuesAlignedDataMaxLength;
+    std::shared_ptr<Configuration<int>> StopTxnAlignedDataMaxLength;
 public:
     ConnectorMeterValuesRecorder(OcppModel& context, int connectorId);
 
@@ -60,7 +76,9 @@ class ConnectorMeterValuesRecorder {
 
     int32_t readEnergyActiveImportRegister();
 
-    OcppMessage *takeMeterValuesNow();
+    OcppMessage *takeTriggeredMeterValues();
+
+    OcppMessage *getStopTransactionData();
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
new file mode 100644
index 00000000..e46edd1d
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
@@ -0,0 +1,108 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Debug.h>
+
+using ArduinoOcpp::MeterValue;
+using ArduinoOcpp::MeterValueBuilder;
+
+MeterValue::MeterValue(const MeterValue& other) {
+    timestamp = other.timestamp;
+    for (auto value = other.sampledValue.begin(); value != other.sampledValue.end(); value++) {
+        sampledValue.push_back(std::unique_ptr<SampledValue>((*value)->clone()));
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> MeterValue::toJson() {
+    size_t capacity = 0;
+    std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
+    for (auto sample = sampledValue.begin(); sample != sampledValue.end(); sample++) {
+        auto json = (*sample)->toJson();
+        capacity += json->capacity();
+        entries.push_back(std::move(json));
+    }
+
+    capacity += JSON_ARRAY_SIZE(entries.size());
+    capacity += JSONDATE_LENGTH + 1;
+    capacity += JSON_OBJECT_SIZE(2);
+    
+    auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
+    auto jsonPayload = result->to<JsonObject>();
+
+    char timestampStr [JSONDATE_LENGTH + 1] = {'\0'};
+    if (!timestamp.toJsonString(timestampStr, JSONDATE_LENGTH + 1)) {
+        return nullptr;
+    }
+    jsonPayload["timestamp"] = timestampStr;
+    auto jsonMeterValue = jsonPayload.createNestedArray("sampledValue");
+    for (auto entry = entries.begin(); entry != entries.end(); entry++) {
+        jsonMeterValue.add(**entry);
+    }
+    return std::move(result);
+}
+
+MeterValueBuilder::MeterValueBuilder(const std::vector<std::unique_ptr<SampledValueSampler>> &samplers,
+            std::shared_ptr<Configuration<const char*>> samplers_select) :
+            samplers(samplers),
+            select(samplers_select) {
+        
+    updateObservedSamplers();
+    select_observe = select->getValueRevision();
+}
+
+void MeterValueBuilder::updateObservedSamplers() {
+
+    if (select_mask.size() != samplers.size()) {
+        select_mask.resize(samplers.size(), false);
+        select_n = 0;
+    }
+    
+    auto selectStr = select->operator const char *();
+    size_t sl = 0, sr = 0;
+    while (selectStr && sl < select->getBuffsize()) {
+        while (sr < select->getBuffsize()) {
+            if (selectStr[sr] == ',') {
+                break;
+            }
+            sr++;
+        }
+
+        if (sr != sl + 1) {
+            for (size_t i = 0; i < samplers.size(); i++) {
+                if (!strncmp(samplers[i]->getMeasurand().c_str(), selectStr + sl, sr - sl)) {
+                    select_mask[i] = true;
+                    select_n++;
+                }
+            }
+        }
+
+        sr++;
+        sl = sr;
+    }
+}
+
+std::unique_ptr<MeterValue> MeterValueBuilder::takeSample(const OcppTimestamp& timestamp, const ReadingContext& context) {
+    if (select_observe != select->getValueRevision() || //OCPP server has changed configuration about which measurands to take
+            samplers.size() != select_mask.size()) {    //Client has added another Measurand; synchronize lists
+        AO_DBG_DEBUG("Updating observed samplers due to config change or samplers added");
+        updateObservedSamplers();
+        select_observe = select->getValueRevision();
+    }
+
+    if (select_n == 0) {
+        return nullptr;
+    }
+
+    auto sample = std::unique_ptr<MeterValue>(new MeterValue(timestamp));
+
+    for (size_t i = 0; i < select_mask.size(); i++) {
+        if (select_mask[i]) {
+            sample->addSampledValue(samplers[i]->takeValue(context));
+        }
+    }
+
+    return sample;
+}
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
index 6945fa8c..d9ba7a2b 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
@@ -7,6 +7,7 @@
 
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
+#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoJson.h>
 #include <memory>
 
@@ -18,42 +19,27 @@ class MeterValue {
     std::vector<std::unique_ptr<SampledValue>> sampledValue;
 public:
     MeterValue(OcppTimestamp timestamp) : timestamp(timestamp) { }
-    MeterValue(const MeterValue& other) {
-        timestamp = other.timestamp;
-        for (auto value = other.sampledValue.begin(); value != other.sampledValue.end(); value++) {
-            sampledValue.push_back(std::unique_ptr<SampledValue>((*value)->clone()));
-        }
-    }
+    MeterValue(const MeterValue& other);
 
     void addSampledValue(std::unique_ptr<SampledValue> sample) {sampledValue.push_back(std::move(sample));}
 
-    std::unique_ptr<DynamicJsonDocument> toJson() {
-        size_t capacity = 0;
-        std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
-        for (auto sample = sampledValue.begin(); sample != sampledValue.end(); sample++) {
-            auto json = (*sample)->toJson();
-            capacity += json->capacity();
-            entries.push_back(std::move(json));
-        }
-
-        capacity += JSON_ARRAY_SIZE(entries.size());
-        capacity += JSONDATE_LENGTH + 1;
-        capacity += JSON_OBJECT_SIZE(2);
-        
-        auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
-        auto jsonPayload = result->to<JsonObject>();
-
-        char timestampStr [JSONDATE_LENGTH + 1] = {'\0'};
-        if (!timestamp.toJsonString(timestampStr, JSONDATE_LENGTH + 1)) {
-            return nullptr;
-        }
-        jsonPayload["timestamp"] = timestampStr;
-        auto jsonMeterValue = jsonPayload.createNestedArray("sampledValue");
-        for (auto entry = entries.begin(); entry != entries.end(); entry++) {
-            jsonMeterValue.add(**entry);
-        }
-        return std::move(result);
-    }
+    std::unique_ptr<DynamicJsonDocument> toJson();
+};
+
+class MeterValueBuilder {
+private:
+    const std::vector<std::unique_ptr<SampledValueSampler>> &samplers;
+    std::shared_ptr<Configuration<const char*>> select;
+    std::vector<bool> select_mask;
+    unsigned int select_n {0};
+    decltype(select->getValueRevision()) select_observe;
+
+    void updateObservedSamplers();
+public:
+    MeterValueBuilder(const std::vector<std::unique_ptr<SampledValueSampler>> &samplers,
+            std::shared_ptr<Configuration<const char*>> samplers_select);
+    
+    std::unique_ptr<MeterValue> takeSample(const OcppTimestamp& timestamp, const ReadingContext& context);
 };
 
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index c8e95419..97c2a792 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -61,14 +61,14 @@ int32_t MeteringService::readEnergyActiveImportRegister(int connectorId) {
     return connectors[connectorId]->readEnergyActiveImportRegister();
 }
 
-std::unique_ptr<OcppOperation> MeteringService::takeMeterValuesNow(int connectorId) {
+std::unique_ptr<OcppOperation> MeteringService::takeTriggeredMeterValues(int connectorId) {
     if (connectorId < 0 || connectorId >= (int) connectors.size()) {
         AO_DBG_ERR("connectorId out of bounds. Ignore");
         return nullptr;
     }
     auto& connector = connectors.at(connectorId);
     if (connector.get()) {
-        auto msg = connector->takeMeterValuesNow();
+        auto msg = connector->takeTriggeredMeterValues();
         if (msg) {
             auto meterValues = makeOcppOperation(msg);
             meterValues->setTimeout(std::unique_ptr<Timeout>{new FixedTimeout(120000)});
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index 25814b37..f82700a3 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -38,7 +38,7 @@ class MeteringService {
 
     int32_t readEnergyActiveImportRegister(int connectorId);
 
-    std::unique_ptr<OcppOperation> takeMeterValuesNow(int connectorId); //snapshot of all meters now
+    std::unique_ptr<OcppOperation> takeTriggeredMeterValues(int connectorId); //snapshot of all meters now
 
     int getNumConnectors() {return connectors.size();}
 };
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
new file mode 100644
index 00000000..75227b11
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
@@ -0,0 +1,67 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
+#include <ArduinoOcpp/Debug.h>
+
+using ArduinoOcpp::SampledValue;
+
+//helper function
+namespace ArduinoOcpp {
+namespace Ocpp16 {
+const char *cstrFromReadingContext(ReadingContext context) {
+    switch (context) {
+        case (ReadingContext::InterruptionBegin):
+            return "Interruption.Begin";
+        case (ReadingContext::InterruptionEnd):
+            return "Interruption.End";
+        case (ReadingContext::Other):
+            return "Other";
+        case (ReadingContext::SampleClock):
+            return "Sample.Clock";
+        case (ReadingContext::SamplePeriodic):
+            return "Sample.Periodic";
+        case (ReadingContext::TransactionBegin):
+            return "Transaction.Begin";
+        case (ReadingContext::TransactionEnd):
+            return "Transaction.End";
+        case (ReadingContext::Trigger):
+            return "Trigger";
+        default:
+            AO_DBG_ERR("ReadingContext not specified");
+        case (ReadingContext::NOT_SET):
+            return nullptr;
+    }
+}
+
+}} //end namespaces
+
+std::unique_ptr<DynamicJsonDocument> SampledValue::toJson() {
+    auto value = serializeValue();
+    size_t capacity = 0;
+    capacity += JSON_OBJECT_SIZE(8);
+    capacity += value.length() + 1
+                + properties.getFormat().length() + 1
+                + properties.getMeasurand().length() + 1
+                + properties.getPhase().length() + 1
+                + properties.getLocation().length() + 1
+                + properties.getUnit().length() + 1;
+    auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
+    auto payload = result->to<JsonObject>();
+    payload["value"] = value;
+    auto context_cstr = Ocpp16::cstrFromReadingContext(context);
+    if (context_cstr)
+        payload["context"] = context_cstr;
+    if (!properties.getFormat().empty())
+        payload["format"] = properties.getFormat();
+    if (!properties.getMeasurand().empty())
+        payload["measurand"] = properties.getMeasurand();
+    if (!properties.getPhase().empty())
+        payload["phase"] = properties.getPhase();
+    if (!properties.getLocation().empty())
+        payload["location"] = properties.getLocation();
+    if (!properties.getUnit().empty())
+        payload["unit"] = properties.getUnit();
+    return std::move(result);
+}
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
index f2a3adb9..c6a4d7ec 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -39,7 +39,6 @@ class SampledValueProperties {
     std::string unit;
 
     const std::string& getFormat() const {return format;}
-    const std::string& getMeasurand() const {return measurand;}
     const std::string& getPhase() const {return phase;}
     const std::string& getLocation() const {return location;}
     const std::string& getUnit() const {return unit;}
@@ -57,45 +56,35 @@ class SampledValueProperties {
 
     void setFormat(const char *format) {this->format = format;}
     void setMeasurand(const char *measurand) {this->measurand = measurand;}
+    const std::string& getMeasurand() const {return measurand;}
     void setPhase(const char *phase) {this->phase = phase;}
     void setLocation(const char *location) {this->location = location;}
     void setUnit(const char *unit) {this->unit = unit;}
 };
 
+enum class ReadingContext {
+    InterruptionBegin,
+    InterruptionEnd,
+    Other,
+    SampleClock,
+    SamplePeriodic,
+    TransactionBegin,
+    TransactionEnd,
+    Trigger,
+    NOT_SET
+};
+
 class SampledValue {
 protected:
     const SampledValueProperties& properties;
+    const ReadingContext context;
     virtual std::string serializeValue() = 0;
 public:
-    SampledValue(const SampledValueProperties& properties) : properties(properties) { }
-    SampledValue(const SampledValue& other) : properties(other.properties) { }
+    SampledValue(const SampledValueProperties& properties, ReadingContext context) : properties(properties), context(context) { }
+    SampledValue(const SampledValue& other) : properties(other.properties), context(other.context) { }
     virtual ~SampledValue() = default;
 
-    std::unique_ptr<DynamicJsonDocument> toJson() {
-        auto value = serializeValue();
-        size_t capacity = 0;
-        capacity += JSON_OBJECT_SIZE(7);
-        capacity += value.length() + 1
-                  + properties.getFormat().length() + 1
-                  + properties.getMeasurand().length() + 1
-                  + properties.getPhase().length() + 1
-                  + properties.getLocation().length() + 1
-                  + properties.getUnit().length() + 1;
-        auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
-        auto payload = result->to<JsonObject>();
-        payload["value"] = value;
-        if (!properties.getFormat().empty())
-            payload["format"] = properties.getFormat();
-        if (!properties.getMeasurand().empty())
-            payload["measurand"] = properties.getMeasurand();
-        if (!properties.getPhase().empty())
-            payload["phase"] = properties.getPhase();
-        if (!properties.getLocation().empty())
-            payload["location"] = properties.getLocation();
-        if (!properties.getUnit().empty())
-            payload["unit"] = properties.getUnit();
-        return std::move(result);
-    }
+    std::unique_ptr<DynamicJsonDocument> toJson();
 
     virtual std::unique_ptr<SampledValue> clone() = 0;
 
@@ -107,7 +96,7 @@ class SampledValueConcrete : public SampledValue {
 private:
     const T value;
 public:
-    SampledValueConcrete(const SampledValueProperties& properties, const T&& value) : SampledValue(properties), value(value) { }
+    SampledValueConcrete(const SampledValueProperties& properties, ReadingContext context, const T&& value) : SampledValue(properties, context), value(value) { }
     SampledValueConcrete(const SampledValueConcrete& other) : SampledValue(other), value(other.value) { }
     ~SampledValueConcrete() = default;
 
@@ -124,7 +113,8 @@ class SampledValueSampler {
 public:
     SampledValueSampler(SampledValueProperties properties) : properties(properties) { }
     virtual ~SampledValueSampler() = default;
-    virtual std::unique_ptr<SampledValue> takeValue() = 0;
+    virtual std::unique_ptr<SampledValue> takeValue(ReadingContext context) = 0;
+    const std::string& getMeasurand() {return properties.getMeasurand();};
 };
 
 template <class T, class DeSerializer>
@@ -133,11 +123,11 @@ class SampledValueSamplerConcrete : public SampledValueSampler {
     std::function<T()> sampler;
 public:
     SampledValueSamplerConcrete(SampledValueProperties properties, std::function<T()> sampler) : SampledValueSampler(properties), sampler(sampler) { }
-    std::unique_ptr<SampledValue> takeValue() override {
-        return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(properties, sampler()));
+    std::unique_ptr<SampledValue> takeValue(ReadingContext context) override {
+        return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(properties, context, sampler()));
     }
 };
 
-}
+} //end namespace ArduinoOcpp
 
 #endif

From 0a3d89b7ff4e79561cb2cacc58b8336008978b80 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 8 May 2022 18:52:58 +0200
Subject: [PATCH 012/549] complete C facade definitions

---
 src/ArduinoOcpp.h     |   2 +-
 src/ArduinoOcpp_c.cpp | 107 +++++++++++++++++++++++++++++++++++++-----
 src/ArduinoOcpp_c.h   |   4 --
 3 files changed, 95 insertions(+), 18 deletions(-)

diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 6fbaec92..18882796 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -30,7 +30,7 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
 #endif
 
 //Lets you use your own WebSocket implementation
-void OCPP_initialize(ArduinoOcpp::OcppSocket& ocppSocket, float V_eff = 230.f /*German grid*/, ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail, ArduinoOcpp::OcppClock system_time = ArduinoOcpp::Clocks::DEFAULT_CLOCK);
+void OCPP_initialize(ArduinoOcpp::OcppSocket& ocppSocket, float V_eff = 230.f /*European grid*/, ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail, ArduinoOcpp::OcppClock system_time = ArduinoOcpp::Clocks::DEFAULT_CLOCK);
 
 //experimental; More testing required (help needed: it would be awesome if you can you publish your evaluation results on the GitHub page)
 void OCPP_deinitialize();
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 7b50aa69..b44dceb4 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -10,6 +10,7 @@ extern "C" void ao_initialize(AOcppSocket *osock) {
     if (!osock) {
         AO_DBG_ERR("osock is null");
     }
+    AO_DBG_ERR("no error");
 
     ocppSocket = reinterpret_cast<ArduinoOcpp::OcppSocket*>(osock);
 
@@ -30,7 +31,7 @@ extern "C" void ao_set_console_out_c(void (*console_out)(const char *msg)) {
 
 char ao_recv_payload_buff [AO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
 
-std::function<void(JsonObject)> wrapCstyleOcppCb(OnOcppMessage cb) {
+std::function<void(JsonObject)> adaptCb(OnOcppMessage cb) {
     return [cb] (JsonObject payload) {
         auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
@@ -40,11 +41,11 @@ std::function<void(JsonObject)> wrapCstyleOcppCb(OnOcppMessage cb) {
     };
 }
 
-std::function<void()> wrapCstyleOcppCb(void (*cb)()) {
+std::function<void()> adaptCb(void (*cb)()) {
     return cb;
 }
 
-ArduinoOcpp::OnReceiveErrorListener wrapCstyleOcppCb(OnOcppError cb) {
+ArduinoOcpp::OnReceiveErrorListener adaptCb(OnOcppError cb) {
     return [cb] (const char *code, const char *description, JsonObject details) {
         auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
@@ -54,18 +55,98 @@ ArduinoOcpp::OnReceiveErrorListener wrapCstyleOcppCb(OnOcppError cb) {
     };
 }
 
-extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    bootNotification("model", "vendor", wrapCstyleOcppCb(onConfirmation), wrapCstyleOcppCb(onAbort), wrapCstyleOcppCb(onTimeout), wrapCstyleOcppCb(onError));
+std::function<bool()> adaptCb(SamplerBool cb) {
+    return cb;
+}
+
+std::function<const char*()> adaptCb(SamplerString cb) {
+    return cb;
+}
+
+void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy) {
+    setEvRequestsEnergySampler(adaptCb(evRequestsEnergy));
+}
+
+void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized) {
+    setConnectorEnergizedSampler(adaptCb(connectorEnergized));
+}
+
+void ao_setConnectorPluggedSampler(SamplerBool connectorPlugged) {
+    setConnectorPluggedSampler(adaptCb(connectorPlugged));
+}
+
+void ao_addConnectorErrorCodeSampler(SamplerString connectorErrorCode) {
+    addConnectorErrorCodeSampler(adaptCb(connectorErrorCode));
+}
+
+void ao_onChargingRateLimitChange(void (*chargingRateChanged)(float)) {
+    setOnChargingRateLimitChange(chargingRateChanged);
+}
+
+void ao_onUnlockConnector(SamplerBool unlockConnector) {
+    setOnUnlockConnector(adaptCb(unlockConnector));
+}
+
+void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf) {
+    setOnRemoteStopTransactionSendConf(adaptCb(onSendConf));
+}
+
+void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf) {
+    setOnRemoteStopTransactionSendConf(adaptCb(onSendConf));
+}
+
+void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest) {
+    setOnRemoteStopTransactionReceiveReq(adaptCb(onRequest));
+}
+
+void ao_onResetSendConf(OnOcppMessage onSendConf) {
+    setOnResetSendConf(adaptCb(onSendConf));
 }
 
 extern "C" void ao_onResetRequest(OnOcppMessage onRequest) {
-    OnReceiveReqListener cb = [onRequest] (JsonObject payload) {
-        auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
-        if (len <= 0) {
-            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
-        }
-        onRequest(len > 0 ? ao_recv_payload_buff : nullptr, len);
-    };
-    setOnResetReceiveReq(cb);
+    setOnResetReceiveReq(adaptCb(onRequest));
+}
+
+extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    bootNotification("model", "vendor", adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+}
+
+void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    authorize(idTag, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+}
+
+void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    startTransaction(idTag, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+}
+
+void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    stopTransaction(adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
 }
 
+int ao_getTransactionId() {
+    return getTransactionId();
+}
+
+bool ao_ocppPermitsCharge() {
+    return ocppPermitsCharge();
+}
+
+bool ao_isAvailable() {
+    return isAvailable();
+}
+
+void ao_beginSession(const char *idTag) {
+    return beginSession(idTag);
+}
+
+void ao_endSession() {
+    return endSession();
+}
+
+bool ao_isInSession() {
+    return isInSession();
+}
+
+const char *ao_getSessionIdTag() {
+    return getSessionIdTag();
+}
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index c44db5fc..b36af90a 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -42,8 +42,6 @@ void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized);
 
 void ao_setConnectorPluggedSampler(SamplerBool connectorPlugged);
 
-//void setConnectorFaultedSampler(SamplerBool connectorFailed);
-
 void ao_addConnectorErrorCodeSampler(SamplerString connectorErrorCode);
 
 /*
@@ -58,8 +56,6 @@ void ao_onUnlockConnector(SamplerBool unlockConnector); //true: success, false:
  * Generic listeners for OCPP operations initiated by Central System
  */
 
-void ao_onSetChargingProfileRequest(OnOcppMessage onRequest); //optional
-
 void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf); //important, energize the power plug here and capture the idTag
 
 void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf); //important, de-energize the power plug here

From c22495379dbcba7a2a0e06ed4e74a5e68466cafc Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 18 May 2022 16:40:26 +0200
Subject: [PATCH 013/549] Async meter measurments and connector unlock

---
 src/ArduinoOcpp.cpp                           |  8 +--
 src/ArduinoOcpp.h                             |  3 +-
 src/ArduinoOcpp/Core/OcppOperation.cpp        | 15 +++---
 src/ArduinoOcpp/Core/PollResult.h             | 51 +++++++++++++++++++
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp   |  3 ++
 .../MessagesV16/StartTransaction.cpp          | 10 +++-
 .../MessagesV16/StartTransaction.h            |  3 +-
 .../MessagesV16/StopTransaction.cpp           | 11 +++-
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |  3 +-
 .../MessagesV16/UnlockConnector.cpp           | 25 +++++----
 src/ArduinoOcpp/MessagesV16/UnlockConnector.h |  5 +-
 .../ChargePointStatus/ConnectorStatus.cpp     |  4 +-
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  7 +--
 .../Metering/ConnectorMeterValuesRecorder.cpp | 12 ++---
 .../Metering/ConnectorMeterValuesRecorder.h   |  2 +-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp | 10 ++--
 src/ArduinoOcpp/Tasks/Metering/MeterValue.h   |  2 +-
 .../Tasks/Metering/MeteringService.cpp        |  4 +-
 .../Tasks/Metering/MeteringService.h          |  2 +-
 .../Tasks/Metering/SampledValue.cpp           |  3 ++
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h | 33 +++++++-----
 21 files changed, 151 insertions(+), 65 deletions(-)
 create mode 100644 src/ArduinoOcpp/Core/PollResult.h

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index b32ae275..d8ffe4d1 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -174,7 +174,7 @@ void setPowerActiveImportSampler(std::function<float()> power) {
     auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
                            new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
             meterProperties,
-            power
+            [power] (ReadingContext) {return power();}
     ));
     model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(mvs)); //connectorId=1
     model.getMeteringService()->setPowerSampler(OCPP_ID_OF_CONNECTOR, power);
@@ -195,7 +195,9 @@ void setEnergyActiveImportSampler(std::function<float()> energy) {
     meterProperties.setUnit("Wh");
     auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
                            new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
-            meterProperties, energy));
+            meterProperties,
+            [energy] (ReadingContext) {return energy();}
+    ));
     model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(mvs)); //connectorId=1
     model.getMeteringService()->setEnergySampler(OCPP_ID_OF_CONNECTOR, energy);
 }
@@ -278,7 +280,7 @@ void setOnChargingRateLimitChange(std::function<void(float)> chargingRateChanged
     model.getSmartChargingService()->setOnLimitChange(chargingRateChanged);
 }
 
-void setOnUnlockConnector(std::function<bool()> unlockConnector) {
+void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
     if (!ocppEngine) {
         AO_DBG_ERR("Please call OCPP_initialize before");
         return;
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 59953387..15b3ee91 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -14,6 +14,7 @@
 #include <ArduinoOcpp/Core/OcppOperationCallbacks.h>
 #include <ArduinoOcpp/Core/OcppOperationTimeout.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
@@ -76,7 +77,7 @@ void addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCo
 
 void setOnChargingRateLimitChange(std::function<void(float)> chargingRateChanged);
 
-void setOnUnlockConnector(std::function<bool()> unlockConnector); //true: success, false: failure
+void setOnUnlockConnector(std::function<ArduinoOcpp::PollResult<bool>()> unlockConnector); //true: success, false: failure
 
 /*
  * React on CS-initiated operations
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 52a9f7e2..9f651caa 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -104,8 +104,7 @@ boolean OcppOperation::sendReq(OcppSocket& ocppSocket){
      */
     auto requestPayload = ocppMessage->createReq();
     if (!requestPayload) {
-        onAbortListener();
-        return true;
+        return false;
     }
 
     /*
@@ -240,12 +239,16 @@ boolean OcppOperation::sendConf(OcppSocket& ocppSocket){
      * Create the OCPP message
      */
     std::unique_ptr<DynamicJsonDocument> confJson = nullptr;
-    std::unique_ptr<DynamicJsonDocument> confPayload = std::unique_ptr<DynamicJsonDocument>(ocppMessage->createConf());
+    std::unique_ptr<DynamicJsonDocument> confPayload = ocppMessage->createConf();
     std::unique_ptr<DynamicJsonDocument> errorDetails = nullptr;
     
-    bool operationSuccess = ocppMessage->getErrorCode() == nullptr && confPayload != nullptr;
+    bool operationFailure = ocppMessage->getErrorCode() != nullptr;
+
+    if (!operationFailure && !confPayload) {
+        return false; //confirmation message still pending
+    }
 
-    if (operationSuccess) {
+    if (!operationFailure) {
 
         /*
          * Create OCPP-J Remote Procedure Call header
@@ -293,7 +296,7 @@ boolean OcppOperation::sendConf(OcppSocket& ocppSocket){
     boolean wsSuccess = ocppSocket.sendTXT(out);
 
     if (wsSuccess) {
-        if (operationSuccess) {
+        if (!operationFailure) {
             AO_DBG_TRAFFIC_OUT(out.c_str());
             onSendConfListener(confPayload->as<JsonObject>());
         } else {
diff --git a/src/ArduinoOcpp/Core/PollResult.h b/src/ArduinoOcpp/Core/PollResult.h
new file mode 100644
index 00000000..a21324f8
--- /dev/null
+++ b/src/ArduinoOcpp/Core/PollResult.h
@@ -0,0 +1,51 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef POLLRESULT_H
+#define POLLRESULT_H
+
+#include <utility>
+#include <ArduinoOcpp/Debug.h>
+
+namespace ArduinoOcpp {
+
+template <class T>
+class PollResult {
+private:
+    bool ready;
+    T value;
+public:
+    PollResult() :          ready(false) {}
+    PollResult(T&& value) : ready(true), value(value) {}
+    PollResult(const PollResult<T>&) = delete;
+    PollResult<T>& operator =(const PollResult<T>&) = delete;
+    PollResult<T>& operator =(const PollResult<T>&& other) {
+        ready = other.ready;
+        value = std::move(other.value);
+        return *this;
+    }
+    PollResult(PollResult<T>&& other) : ready(other.ready), value(std::move(other.value)) {}
+    T&& toValue() {
+        if (!ready) {
+            AO_DBG_ERR("Not ready");
+            (void)0;
+        }
+        ready = false;
+        return std::move(value);
+    }
+    T& getValue() const {
+        if (!ready) {
+            AO_DBG_ERR("Not ready");
+            (void)0;
+        }
+        return *value;
+    }
+    operator bool() const {return ready;}
+
+    static PollResult<T> Await() {return PollResult<T>();}
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index 97863a93..87559f96 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -35,6 +35,9 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
     std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
     for (auto value = meterValue.begin(); value != meterValue.end(); value++) {
         auto entry = (*value)->toJson();
+        if (!entry) {
+            return nullptr;
+        }
         capacity += entry->capacity();
         entries.push_back(std::move(entry));
     }
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 339aa8b1..f7f3ec57 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -67,12 +67,18 @@ void StartTransaction::initiate() {
 }
 
 std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
+
+    if (meterStart && !*meterStart) {
+        //meterStart not ready yet
+        return nullptr;
+    }
+
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(5) + (JSONDATE_LENGTH + 1) + (IDTAG_LEN_MAX + 1)));
     JsonObject payload = doc->to<JsonObject>();
 
     payload["connectorId"] = connectorId;
-    if (meterStart >= 0) {
-        payload["meterStart"] = meterStart;
+    if (meterStart && *meterStart) {
+        payload["meterStart"] = meterStart->toInteger();
     }
 
     if (otimestamp > MIN_TIME) {
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.h b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
index 6390a0f1..153da753 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
@@ -8,6 +8,7 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
@@ -15,7 +16,7 @@ namespace Ocpp16 {
 class StartTransaction : public OcppMessage {
 private:
     int connectorId = 1;
-    int32_t meterStart = -1;
+    std::unique_ptr<SampledValue> meterStart {nullptr};
     OcppTimestamp otimestamp;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
     uint16_t transactionRev = 0;
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 1f5c002c..6466a85c 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -46,11 +46,18 @@ void StopTransaction::initiate() {
 }
 
 std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
+
+    if (meterStop && !*meterStop) {
+        //meterStop not ready yet
+        return nullptr;
+    }
+
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(5) + (JSONDATE_LENGTH + 1) + (REASON_LEN_MAX + 1)));
     JsonObject payload = doc->to<JsonObject>();
 
-    if (meterStop >= 0)
-        payload["meterStop"] = meterStop; //TODO meterStart is required to be in Wh, but measuring unit is probably inconsistent in implementation
+    if (meterStop && *meterStop) {
+        payload["meterStop"] = meterStop->toInteger();
+    }
 
     if (otimestamp > MIN_TIME) {
         char timestamp[JSONDATE_LENGTH + 1] = {'\0'};
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index 6268b8f4..08a91957 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -8,6 +8,7 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
@@ -15,7 +16,7 @@ namespace Ocpp16 {
 class StopTransaction : public OcppMessage {
 private:
     int connectorId = 1;
-    int32_t meterStop = -1;
+    std::unique_ptr<SampledValue> meterStop {nullptr};
     OcppTimestamp otimestamp;
     char reason [REASON_LEN_MAX] {'\0'};
 public:
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
index a7418c44..e883c89c 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
@@ -19,7 +19,7 @@ const char* UnlockConnector::getOcppOperationType(){
 
 void UnlockConnector::processReq(JsonObject payload) {
     
-    int connectorId = payload["connectorId"] | -1;
+    auto connectorId = payload["connectorId"] | -1;
 
     if (!ocppModel || !ocppModel->getConnectorStatus(connectorId)) {
         err = true;
@@ -30,24 +30,29 @@ void UnlockConnector::processReq(JsonObject payload) {
 
     connector->endSession("UnlockCommand");
 
-    std::function<bool()> unlockConnector = connector->getOnUnlockConnector();
+    unlockConnector = connector->getOnUnlockConnector();
     if (unlockConnector != nullptr) {
-        cbDefined = true;
+        cbUnlockResult = unlockConnector();
     } else {
-        cbDefined = false;
         AO_DBG_WARN("Unlock CB undefined");
-        return;
     }
-
-    cbUnlockSuccessful = unlockConnector();
 }
 
-std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf(){
+std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
+    if (unlockConnector) {
+        if (!cbUnlockResult) {
+            cbUnlockResult = unlockConnector();
+            if (!cbUnlockResult) {
+                return nullptr; //no result yet - delay confirmation response
+            }
+        }
+    }
+
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    if (err || !cbDefined) {
+    if (err || !unlockConnector) {
         payload["status"] = "NotSupported";
-    } else if (cbUnlockSuccessful) {
+    } else if (cbUnlockResult.toValue()) {
         payload["status"] = "Unlocked";
     } else {
         payload["status"] = "UnlockFailed";
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
index d65dc559..2659fd2b 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
@@ -6,6 +6,7 @@
 #define UNLOCKCONNECTOR_H
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/PollResult.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
@@ -13,8 +14,8 @@ namespace Ocpp16 {
 class UnlockConnector : public OcppMessage {
 private:
     bool err = false;
-    bool cbDefined = false;
-    bool cbUnlockSuccessful = false;
+    std::function<PollResult<bool> ()> unlockConnector;
+    PollResult<bool> cbUnlockResult;
 public:
     UnlockConnector();
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 6d27b36d..185ff4b5 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -315,10 +315,10 @@ void ConnectorStatus::saveState() {
     configuration_save();
 }
 
-void ConnectorStatus::setOnUnlockConnector(std::function<bool()> unlockConnector) {
+void ConnectorStatus::setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
     this->onUnlockConnector = unlockConnector;
 }
 
-std::function<bool()> ConnectorStatus::getOnUnlockConnector() {
+std::function<PollResult<bool>()> ConnectorStatus::getOnUnlockConnector() {
     return this->onUnlockConnector;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index fb9d3ff0..8c9a8962 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -7,6 +7,7 @@
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
+#include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
 
 #include <vector>
@@ -56,7 +57,7 @@ class ConnectorStatus {
     //std::function<std::unique_ptr<OcppMessage>()> startTransactionBehavior;
     //std::function<std::unique_ptr<OcppMessage>(const char* stopReason)> stopTransactionBehavior;
 
-    std::function<bool()> onUnlockConnector {nullptr};
+    std::function<PollResult<bool>()> onUnlockConnector {nullptr};
 
     std::shared_ptr<Configuration<const char*>> stopTransactionOnInvalidId;
     std::shared_ptr<Configuration<const char*>> stopTransactionOnEVSideDisconnect;
@@ -100,8 +101,8 @@ class ConnectorStatus {
 
     bool ocppPermitsCharge();
 
-    void setOnUnlockConnector(std::function<bool()> unlockConnector);
-    std::function<bool()> getOnUnlockConnector();
+    void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector);
+    std::function<PollResult<bool>()> getOnUnlockConnector();
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index ffc6b91f..56620cd5 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -50,10 +50,10 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
     );
     StopTxnAlignedDataMaxLength = declareConfiguration("StopTxnAlignedDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
     
-    sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesSampledData)); AO_DBG_DEBUG("After MeterValuesSampledData");
-    alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData)); AO_DBG_DEBUG("After MeterValuesAlignedData");
-    stopTxnSampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnSampledData)); AO_DBG_DEBUG("After StopTxnSampledData");
-    stopTxnAlignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnAlignedData)); AO_DBG_DEBUG("After StopTxnAlignedData");
+    sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesSampledData));
+    alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData));
+    stopTxnSampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnSampledData));
+    stopTxnAlignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnAlignedData));
 }
 
 OcppMessage *ConnectorMeterValuesRecorder::loop() {
@@ -189,9 +189,9 @@ void ConnectorMeterValuesRecorder::addMeterValueSampler(std::unique_ptr<SampledV
     samplers.push_back(std::move(meterValueSampler));
 }
 
-int32_t ConnectorMeterValuesRecorder::readEnergyActiveImportRegister() {
+std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readEnergyActiveImportRegister() {
     if (energySamplerIndex >= 0 && energySamplerIndex < samplers.size()) {
-        return samplers[energySamplerIndex]->takeValue(ReadingContext::NOT_SET)->toInteger();
+        return samplers[energySamplerIndex]->takeValue(ReadingContext::NOT_SET);
     } else {
         AO_DBG_DEBUG("Called readEnergyActiveImportRegister(), but no energySampler or handling strategy set");
         return 0;
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index 502724d1..a145438b 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -74,7 +74,7 @@ class ConnectorMeterValuesRecorder {
 
     void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler);
 
-    int32_t readEnergyActiveImportRegister();
+    std::unique_ptr<SampledValue> readEnergyActiveImportRegister();
 
     OcppMessage *takeTriggeredMeterValues();
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
index e46edd1d..27fe8904 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
@@ -9,18 +9,14 @@
 using ArduinoOcpp::MeterValue;
 using ArduinoOcpp::MeterValueBuilder;
 
-MeterValue::MeterValue(const MeterValue& other) {
-    timestamp = other.timestamp;
-    for (auto value = other.sampledValue.begin(); value != other.sampledValue.end(); value++) {
-        sampledValue.push_back(std::unique_ptr<SampledValue>((*value)->clone()));
-    }
-}
-
 std::unique_ptr<DynamicJsonDocument> MeterValue::toJson() {
     size_t capacity = 0;
     std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
     for (auto sample = sampledValue.begin(); sample != sampledValue.end(); sample++) {
         auto json = (*sample)->toJson();
+        if (!json) {
+            return nullptr;
+        }
         capacity += json->capacity();
         entries.push_back(std::move(json));
     }
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
index d9ba7a2b..450f5d5b 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
@@ -19,7 +19,7 @@ class MeterValue {
     std::vector<std::unique_ptr<SampledValue>> sampledValue;
 public:
     MeterValue(OcppTimestamp timestamp) : timestamp(timestamp) { }
-    MeterValue(const MeterValue& other);
+    MeterValue(const MeterValue& other) = delete;
 
     void addSampledValue(std::unique_ptr<SampledValue> sample) {sampledValue.push_back(std::move(sample));}
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index 97c2a792..c5522f78 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -53,10 +53,10 @@ void MeteringService::addMeterValueSampler(int connectorId, std::unique_ptr<Samp
     connectors[connectorId]->addMeterValueSampler(std::move(meterValueSampler));
 }
 
-int32_t MeteringService::readEnergyActiveImportRegister(int connectorId) {
+std::unique_ptr<SampledValue> MeteringService::readEnergyActiveImportRegister(int connectorId) {
     if (connectorId < 0 || connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
-        return 0.f;
+        return nullptr;
     }
     return connectors[connectorId]->readEnergyActiveImportRegister();
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index f82700a3..4b51defe 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -36,7 +36,7 @@ class MeteringService {
 
     void addMeterValueSampler(int connectorId, std::unique_ptr<SampledValueSampler> meterValueSampler);
 
-    int32_t readEnergyActiveImportRegister(int connectorId);
+    std::unique_ptr<SampledValue> readEnergyActiveImportRegister(int connectorId);
 
     std::unique_ptr<OcppOperation> takeTriggeredMeterValues(int connectorId); //snapshot of all meters now
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
index 75227b11..4a570829 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
@@ -39,6 +39,9 @@ const char *cstrFromReadingContext(ReadingContext context) {
 
 std::unique_ptr<DynamicJsonDocument> SampledValue::toJson() {
     auto value = serializeValue();
+    if (value.empty()) {
+        return nullptr;
+    }
     size_t capacity = 0;
     capacity += JSON_OBJECT_SIZE(8);
     capacity += value.length() + 1
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
index c6a4d7ec..7debf013 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -14,20 +14,22 @@ template <class T>
 class SampledValueDeSerializer {
 public:
     static T deserialize(const char *str);
-    static std::string serialize(const T& val);
-    static int32_t toInteger(const T& val);
+    static bool ready(T& val);
+    static std::string serialize(T& val);
+    static int32_t toInteger(T& val);
 };
 
 template <>
-class SampledValueDeSerializer<int32_t> {
+class SampledValueDeSerializer<int32_t> { // example class
 public:
-    static int32_t deserialize(const char *str) {return 42;}
-    static std::string serialize(const int32_t& val) {
+    static int32_t deserialize(const char *str) {return strtol(str, nullptr,10);}
+    static bool ready(int32_t& val) {return true;} //int32_t is always valid
+    static std::string serialize(int32_t& val) {
         char str [12] = {'\0'};
         snprintf(str, 12, "%d", val);
         return std::string(str);
     }
-    static int32_t toInteger(const int32_t& val) {return val;}
+    static int32_t toInteger(int32_t& val) {return val;}
 };
 
 class SampledValueProperties {
@@ -74,6 +76,10 @@ enum class ReadingContext {
     NOT_SET
 };
 
+namespace Ocpp16 {
+const char *cstrFromReadingContext(ReadingContext context);
+}
+
 class SampledValue {
 protected:
     const SampledValueProperties& properties;
@@ -86,23 +92,22 @@ class SampledValue {
 
     std::unique_ptr<DynamicJsonDocument> toJson();
 
-    virtual std::unique_ptr<SampledValue> clone() = 0;
-
+    virtual operator bool() = 0;
     virtual int32_t toInteger() = 0;
 };
 
 template <class T, class DeSerializer>
 class SampledValueConcrete : public SampledValue {
 private:
-    const T value;
+    T value;
 public:
     SampledValueConcrete(const SampledValueProperties& properties, ReadingContext context, const T&& value) : SampledValue(properties, context), value(value) { }
     SampledValueConcrete(const SampledValueConcrete& other) : SampledValue(other), value(other.value) { }
     ~SampledValueConcrete() = default;
 
-    std::string serializeValue() override {return DeSerializer::serialize(value);}
+    operator bool() override {return DeSerializer::ready(value);}
 
-    std::unique_ptr<SampledValue> clone() override {return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(*this));}
+    std::string serializeValue() override {return DeSerializer::serialize(value);}
 
     int32_t toInteger() override { return DeSerializer::toInteger(value);}
 };
@@ -120,11 +125,11 @@ class SampledValueSampler {
 template <class T, class DeSerializer>
 class SampledValueSamplerConcrete : public SampledValueSampler {
 private:
-    std::function<T()> sampler;
+    std::function<T(ReadingContext context)> sampler;
 public:
-    SampledValueSamplerConcrete(SampledValueProperties properties, std::function<T()> sampler) : SampledValueSampler(properties), sampler(sampler) { }
+    SampledValueSamplerConcrete(SampledValueProperties properties, std::function<T(ReadingContext)> sampler) : SampledValueSampler(properties), sampler(sampler) { }
     std::unique_ptr<SampledValue> takeValue(ReadingContext context) override {
-        return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(properties, context, sampler()));
+        return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(properties, context, sampler(context)));
     }
 };
 

From 9ef142b334b30328249ccbe8805fafa11e2c4611 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 19 May 2022 16:23:48 +0200
Subject: [PATCH 014/549] Continuous Integration

---
 .github/workflows/pio.yaml                    | 47 +++++++++++++++++++
 README.md                                     |  3 ++
 .../Core/ConfigurationContainerFlash.cpp      | 12 ++---
 3 files changed, 53 insertions(+), 9 deletions(-)
 create mode 100644 .github/workflows/pio.yaml

diff --git a/.github/workflows/pio.yaml b/.github/workflows/pio.yaml
new file mode 100644
index 00000000..ab6248b7
--- /dev/null
+++ b/.github/workflows/pio.yaml
@@ -0,0 +1,47 @@
+name: PlatformIO CI
+
+on:
+  push:
+    branches:
+      - develop
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        example: [examples/ESP/main.cpp, examples/ESP-TLS/main.cpp, examples/SECC/main.cpp]
+        include:
+          - example: examples/SECC/main.cpp
+            dashboard-extra: --lib="/tmp/tzapu/WiFiManager"
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Cache pip
+      uses: actions/cache@v2
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+    - name: Cache PlatformIO
+      uses: actions/cache@v2
+      with:
+        path: ~/.platformio
+        key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }}
+    - name: Set up Python
+      uses: actions/setup-python@v2
+    - name: Install PlatformIO
+      run: |
+        python -m pip install --upgrade pip
+        pip install --upgrade platformio
+    - name: Install library dependencies
+      run: pio pkg install
+    - name: Extra dependencies for SECC example
+      if: ${{ matrix.dashboard-extra }}
+      run: git clone https://github.com/tzapu/WiFiManager.git /tmp/tzapu/WiFiManager
+    - name: Run PlatformIO
+      run: pio ci --lib="." --project-conf=platformio.ini ${{ matrix.dashboard-extra }}
+      env:
+        PLATFORMIO_CI_SRC: ${{ matrix.example }}
\ No newline at end of file
diff --git a/README.md b/README.md
index e485854a..44b2988e 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,7 @@
 # <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; ArduinoOcpp
+
+[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
+
 OCPP-J 1.6 client for the ESP8266 and the ESP32 (more coming soon)
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index d10adbf3..f8740bff 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -5,18 +5,12 @@
 #include <ArduinoOcpp/Core/ConfigurationContainerFlash.h>
 #include <ArduinoOcpp/Debug.h>
 
-#if defined(ESP32)
+#if defined(ESP32) && !defined(AO_DEACTIVATE_FLASH)
+#include <LITTLEFS.h>
 #define USE_FS LITTLEFS
 #else
-#define USE_FS SPIFFS
-#endif
-
-#if USE_FS == LITTLEFS
-#include <LITTLEFS.h>
-#elif USE_FS == SPIFFS
 #include <FS.h>
-#else
-#error "FS not supported"
+#define USE_FS SPIFFS
 #endif
 
 #define MAX_FILE_SIZE 4000

From 786bc975c52248287f4fef6d3fc64e62217e9424 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 26 May 2022 20:59:31 +0200
Subject: [PATCH 015/549] Decoupled filesystem driver

---
 CMakeLists.txt                                |   8 +-
 src/ArduinoOcpp.cpp                           |   6 +-
 src/ArduinoOcpp/Core/Configuration.cpp        |  68 ++---
 src/ArduinoOcpp/Core/Configuration.h          |   7 +-
 .../Core/ConfigurationContainerFlash.cpp      | 180 ++++++------
 .../Core/ConfigurationContainerFlash.h        |   7 +-
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp    | 274 ++++++++++++++++++
 src/ArduinoOcpp/Core/FilesystemAdapter.h      | 103 +++++++
 src/ArduinoOcpp/Core/OcppConnection.cpp       |   2 +-
 .../MessagesV16/GetConfiguration.cpp          |   6 +-
 10 files changed, 520 insertions(+), 141 deletions(-)
 create mode 100644 src/ArduinoOcpp/Core/FilesystemAdapter.cpp
 create mode 100644 src/ArduinoOcpp/Core/FilesystemAdapter.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 210f3d11..f0307395 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -49,13 +49,17 @@ set(AO_SRC
     src/ArduinoOcpp.cpp
     src/ArduinoOcpp_c.cpp
     src/ao_opts_impl.c
+    src/ArduinoOcpp/Core/FilesystemAdapter.cpp
 )
 
 idf_component_register(SRCS ${AO_SRC}
-                    INCLUDE_DIRS "./src" "${PROJECT_DIR}/include")
+                    INCLUDE_DIRS "./src" "${PROJECT_DIR}/include"
+                    PRIV_REQUIRES spiffs)
 
 target_compile_options(${COMPONENT_TARGET} PUBLIC
     -DAO_CUSTOM_WS
     -DAO_CUSTOM_CONSOLE
     -DAO_DEACTIVATE_FLASH
-    -DAO_DBG_LEVEL=AO_DL_DEBUG)
+    -DAO_USE_FILEAPI=ESPIDF_SPIFFS
+    -DAO_DBG_LEVEL=AO_DL_DEBUG
+    -DAO_TRAFFIC_OUT)
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index e90985cb..c96f7985 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -14,6 +14,7 @@
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
 #include <ArduinoOcpp/MessagesV16/Authorize.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
@@ -83,8 +84,11 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
 
     voltage_eff = V_eff;
     fileSystemOpt = fsOpt;
+
+    std::shared_ptr<FilesystemAdapter> filesystem = EspWiFi::makeDefaultFilesystemAdapter(fileSystemOpt);
+    AO_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "error");
     
-    configuration_init(fileSystemOpt); //call before each other library call
+    configuration_init(filesystem); //call before each other library call
 
     ocppEngine = new OcppEngine(ocppSocket, system_time);
     auto& model = ocppEngine->getOcppModel();
diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index cbd75a0a..4dfe8bde 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -12,7 +12,7 @@
 
 namespace ArduinoOcpp {
 
-FilesystemOpt configurationFilesystemOpt = FilesystemOpt::Use_Mount_FormatOnFail;
+std::shared_ptr<FilesystemAdapter> filesystem;
 
 template<class T>
 std::shared_ptr<Configuration<T>> createConfiguration(const char *key, T value) {
@@ -46,16 +46,16 @@ std::shared_ptr<Configuration<const char *>> createConfiguration(const char *key
     return configuration;
 }
 
-std::shared_ptr<ConfigurationContainer> createConfigurationContainer(const char *filename) {
+std::unique_ptr<ConfigurationContainer> createConfigurationContainer(const char *filename) {
     //create non-persistent Configuration store (i.e. lives only in RAM) if
     //     - Flash FS usage is switched off OR
     //     - Filename starts with "/volatile"
-    if (!configurationFilesystemOpt.accessAllowed() ||
+    if (!filesystem ||
                  !strncmp(filename, CONFIGURATION_VOLATILE, strlen(CONFIGURATION_VOLATILE))) {
-        return std::static_pointer_cast<ConfigurationContainer>(std::make_shared<ConfigurationContainerVolatile>(filename));
+        return std::unique_ptr<ConfigurationContainer>(new ConfigurationContainerVolatile(filename));
     } else {
-        //create persistent Configuration store. This is the normal case
-        return std::static_pointer_cast<ConfigurationContainer>(std::make_shared<ConfigurationContainerFlash>(filename));
+        //create persistent Configuration store. This is the normal caseS
+        return std::unique_ptr<ConfigurationContainer>(new ConfigurationContainerFlash(filesystem, filename));
     }
 }
 
@@ -154,8 +154,10 @@ std::shared_ptr<AbstractConfiguration> getConfiguration(const char *key) {
     return nullptr;
 }
 
-std::shared_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> getAllConfigurations() { //TODO maybe change to iterator?
-    auto result = std::make_shared<std::vector<std::shared_ptr<AbstractConfiguration>>>();
+std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> getAllConfigurations() { //TODO maybe change to iterator?
+    auto result = std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>>(
+                              new std::vector<std::shared_ptr<AbstractConfiguration>>()
+    );
 
     for (auto container = configurationContainers.begin(); container != configurationContainers.end(); container++) {
         for (auto config = (*container)->configurationsIteratorBegin(); config != (*container)->configurationsIteratorEnd(); config++) {
@@ -172,33 +174,17 @@ std::shared_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> getAllConfi
 
 bool configuration_inited = false;
 
-bool configuration_init(FilesystemOpt fsOpt) {
+bool configuration_init(std::shared_ptr<FilesystemAdapter> _filesystem) {
     if (configuration_inited)
         return true; //configuration_init() already called; tolerate multiple calls so user can use this store for
                      //credentials outside ArduinoOcpp which need to be loaded before OCPP_initialize()
-    bool loadRoutineSuccessful = true;
-#ifndef AO_DEACTIVATE_FLASH
-
-    configurationFilesystemOpt = fsOpt;
+    
+    filesystem = _filesystem;
 
-    if (fsOpt.mustMount()) { 
-#if defined(ESP32)
-        if(!LITTLEFS.begin(fsOpt.formatOnFail())) {
-            AO_DBG_ERR("Error while mounting LITTLEFS");
-            loadRoutineSuccessful = false;
-        }
-#else
-        //ESP8266
-        SPIFFSConfig cfg;
-        cfg.setAutoFormat(fsOpt.formatOnFail());
-        SPIFFS.setConfig(cfg);
-
-        if (!SPIFFS.begin()) {
-            AO_DBG_ERR("Unable to initialize: unable to mount SPIFFS");
-            loadRoutineSuccessful = false;
-        }
-#endif
-    } //end fs mount
+    if (!filesystem) {
+        configuration_inited = true;
+        return true; //no filesystem, nothing can go wrong
+    }
 
     std::shared_ptr<ConfigurationContainer> containerDefault = nullptr;
     for (auto container = configurationContainers.begin(); container != configurationContainers.end(); container++) {
@@ -208,29 +194,28 @@ bool configuration_init(FilesystemOpt fsOpt) {
         }
     }
 
+    bool success = true;
+
     if (containerDefault) {
-        AO_DBG_DEBUG("Found default container before calling configuration_init(). If you added\n" \
-                           "        the container manually, please ensure to call load(). If not, it is a hint\n" \
-                           "        that declareConfiguration() was called too early\n");
+        AO_DBG_DEBUG("Found default container before calling configuration_init(). If you added");
+        AO_DBG_DEBUG(" > the container manually, please ensure to call load(). If not, it is a hint");
+        AO_DBG_DEBUG(" > that declareConfiguration() was called too early");
+        (void)0;
     } else {
         containerDefault = createConfigurationContainer(CONFIGURATION_FN);
         if (!containerDefault->load()) {
             AO_DBG_ERR("Loading default configurations file failed");
-            loadRoutineSuccessful = false;
+            success = false;
         }
         configurationContainers.push_back(containerDefault);
     }
 
-
-#endif //ndef AO_DEACTIVATE_FLASH
-    configuration_inited = loadRoutineSuccessful;
-    return loadRoutineSuccessful;
+    configuration_inited = success;
+    return success;
 }
 
 bool configuration_save() {
     bool success = true;
-#ifndef AO_DEACTIVATE_FLASH
-
 
     for (auto container = configurationContainers.begin(); container != configurationContainers.end(); container++) {
         if (!(*container)->save()) {
@@ -238,7 +223,6 @@ bool configuration_save() {
         }
     }
 
-#endif //ndef AO_DEACTIVATE_FLASH
     return success;
 }
 
diff --git a/src/ArduinoOcpp/Core/Configuration.h b/src/ArduinoOcpp/Core/Configuration.h
index 4097bc1a..e7d9f911 100644
--- a/src/ArduinoOcpp/Core/Configuration.h
+++ b/src/ArduinoOcpp/Core/Configuration.h
@@ -8,11 +8,12 @@
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
 #include <ArduinoOcpp/Core/ConfigurationContainerFlash.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
 #include <memory>
 #include <vector>
 
-#define CONFIGURATION_FN "/arduino-ocpp.cnf"
+#define CONFIGURATION_FN (AO_FILENAME_PREFIX "/arduino-ocpp.cnf")
 #define CONFIGURATION_VOLATILE "/volatile"
 
 namespace ArduinoOcpp {
@@ -28,10 +29,10 @@ std::vector<std::shared_ptr<ConfigurationContainer>>::iterator getConfigurationC
 namespace Ocpp16 {
 
     std::shared_ptr<AbstractConfiguration> getConfiguration(const char *key);
-    std::shared_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> getAllConfigurations();
+    std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> getAllConfigurations();
 }
 
-bool configuration_init(FilesystemOpt fsOpt = FilesystemOpt::Use_Mount_FormatOnFail);
+bool configuration_init(std::shared_ptr<FilesystemAdapter> filesytem);
 bool configuration_save();
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index 4d0a260d..b656144d 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -5,6 +5,8 @@
 #include <ArduinoOcpp/Core/ConfigurationContainerFlash.h>
 #include <ArduinoOcpp/Debug.h>
 
+#include <algorithm>
+
 #if defined(ESP32)
 #define USE_FS LITTLEFS
 #else
@@ -23,95 +25,85 @@
 
 #define MAX_FILE_SIZE 4000
 #define MAX_CONFIGURATIONS 50
+#define MAX_CONFJSON_CAPACITY 4000
 
 namespace ArduinoOcpp {
 
 bool ConfigurationContainerFlash::load() {
-#ifndef AO_DEACTIVATE_FLASH
+
+    if (!filesystem) {
+        return false;
+    }
 
     if (configurations.size() > 0) {
         AO_DBG_ERR("Error: declared configurations before calling container->load(). " \
                     "All previously declared values won't be written back");
+        (void)0;
     }
 
-    if (!USE_FS.exists(getFilename())) {
+    size_t file_size = 0;
+    if (filesystem->stat(getFilename(), &file_size) != 0 // file does not exist
+            || file_size == 0) {                         // file exists, but empty
         AO_DBG_DEBUG("Populate FS: create configuration file");
-        return true;
+        return save();
     }
 
-    File file = USE_FS.open(getFilename(), "r");
+    if (file_size > MAX_FILE_SIZE) {
+        AO_DBG_ERR("Unable to initialize: filesize is too long");
+        return false;
+    }
+
+    auto file = filesystem->open(getFilename(), "r");
 
     if (!file) {
         AO_DBG_ERR("Unable to initialize: could not open configuration file %s", getFilename());
         return false;
     }
 
-    if (!file.available()) {
-        AO_DBG_DEBUG("Populate FS: create configuration file");
-        file.close();
-        return true;
-    }
+    auto jsonCapacity = std::max(file_size, (size_t) 256);
+    DynamicJsonDocument doc {0};
+    DeserializationError err = DeserializationError::NoMemory;
 
-    int file_size = file.size();
+    while (err == DeserializationError::NoMemory) {
+        if (jsonCapacity > MAX_CONFJSON_CAPACITY) {
+            AO_DBG_ERR("JSON capacity exceeded");
+            return false;
+        }
 
-    if (file_size < 2) {
-        AO_DBG_ERR("Unable to initialize: too short for json");
-        file.close();
-        return false;
-    } else if (file_size > MAX_FILE_SIZE) {
-        AO_DBG_ERR("Unable to initialize: filesize is too long");
-        file.close();
-        return false;
-    }
+        AO_DBG_DEBUG("Configs JSON capacity: %zu", jsonCapacity);
 
-    String token = file.readStringUntil('\n');
-    if (!token.equals("content-type:arduino-ocpp_configuration_file")) {
-        AO_DBG_ERR("Unable to initialize: unrecognized configuration file format");
-        file.close();
-        return false;
+        doc = DynamicJsonDocument(jsonCapacity);
+        ArduinoJsonFileAdapter file_adapt {file.get()};
+        err = deserializeJson(doc, file_adapt);
+
+        jsonCapacity *= 3;
+        jsonCapacity /= 2;
+        file->seek(0);
     }
 
-    token = file.readStringUntil('\n');
-    if (!token.equals("version:1.0")) {
-        AO_DBG_ERR("Unable to initialize: unsupported version");
-        file.close();
+    if (err) {
+        AO_DBG_ERR("Unable to initialize: config file deserialization failed: %s", err.c_str());
         return false;
     }
 
-    token = file.readStringUntil(':');
-    if (!token.equals("configurations_len")) {
-        AO_DBG_ERR("Unable to initialize: missing length statement");
-        file.close();
+    JsonObject configHeader = doc["head"];
+
+    if (strcmp(configHeader["content-type"] | "Invalid", "ao_configuration_file")) {
+        AO_DBG_ERR("Unable to initialize: unrecognized configuration file format");
         return false;
     }
 
-    token = file.readStringUntil('\n');
-    int configurations_len = token.toInt();
-    if (configurations_len <= 0) {
-        AO_DBG_ERR("Unable to initialize: empty configuration");
-        file.close();
-        return true;
-    }
-    if (configurations_len > MAX_CONFIGURATIONS) {
-        AO_DBG_ERR("Unable to initialize: configurations_len is too big");
-        file.close();
+    if (strcmp(configHeader["version"] | "Invalid", "1.1")) {
+        AO_DBG_ERR("Unable to initialize: unsupported version");
         return false;
     }
-
-    size_t jsonCapacity = file_size + JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(configurations_len) + configurations_len * JSON_OBJECT_SIZE(5);
-
-    AO_DBG_DEBUG("Config capacity = %zu", jsonCapacity);
-
-    DynamicJsonDocument configDoc(jsonCapacity);
-
-    DeserializationError error = deserializeJson(configDoc, file);
-    if (error) {
-        AO_DBG_ERR("Unable to initialize: config file deserialization failed: %s", error.c_str());
-        file.close();
+    
+    JsonArray configurationsArray = doc["configurations"];
+    if (configurationsArray.size() > MAX_CONFIGURATIONS) {
+        AO_DBG_ERR("Unable to initialize: configurations_len is too big (=%zu)", configurationsArray.size());
         return false;
     }
 
-    JsonArray configurationsArray = configDoc["configurations"];
     for (JsonObject config : configurationsArray) {
         const char *type = config["type"] | "Undefined";
 
@@ -132,49 +124,46 @@ bool ConfigurationContainerFlash::load() {
         }
     }
 
-    file.close();
-
     configurationsUpdated();
 
-    AO_DBG_DEBUG("Initialization successful");
-#endif //ndef AO_DEACTIVATE_FLASH
+    AO_DBG_DEBUG("Initialization finished");
     return true;
 }
 
 bool ConfigurationContainerFlash::save() {
-#ifndef AO_DEACTIVATE_FLASH
+
+    if (!filesystem) {
+        return false;
+    }
 
     if (!configurationsUpdated()) {
         return true; //nothing to be done
     }
 
-    if (USE_FS.exists(getFilename())) {
-        USE_FS.remove(getFilename());
+    size_t file_size = 0;
+    if (filesystem->stat(getFilename(), &file_size) == 0) {
+        filesystem->remove(getFilename());
     }
 
-    File file = USE_FS.open(getFilename(), "w");
-
+    auto file = filesystem->open(getFilename(), "w");
     if (!file) {
         AO_DBG_ERR("Unable to save: could not open configuration file %s", getFilename());
         return false;
     }
 
-    size_t jsonCapacity = JSON_OBJECT_SIZE(1); //configurations
-
-    size_t numEntries = configurations.size();
-
-    file.print("content-type:arduino-ocpp_configuration_file\n");
-    file.print("version:1.0\n");
-    file.print("configurations_len:");
-    file.print(numEntries, DEC);
-    file.print("\n");
+    size_t jsonCapacity = 2 * JSON_OBJECT_SIZE(2); //head + configurations + head payload
 
     std::vector<std::shared_ptr<DynamicJsonDocument>> entries;
 
     for (auto config = configurations.begin(); config != configurations.end(); config++) {
         std::shared_ptr<DynamicJsonDocument> entry = (*config)->toJsonStorageEntry();
-        if (entry)
+        if (entry) {
             entries.push_back(entry);
+        }
+        if (entries.size() >= MAX_CONFIGURATIONS) {
+            AO_DBG_ERR("Max No of configratuions exceeded. Crop configs file (by FCFS)");
+            break;
+        }
     }
 
     jsonCapacity += JSON_ARRAY_SIZE(entries.size()); //length of configurations
@@ -182,26 +171,43 @@ bool ConfigurationContainerFlash::save() {
         jsonCapacity += (*entry)->capacity();
     }
 
-    DynamicJsonDocument configDoc(jsonCapacity);
+    jsonCapacity = std::max(jsonCapacity, (size_t) 256);
+    DynamicJsonDocument doc {0};
+    bool jsonDocOverflow = true;
 
-    JsonArray configurationsArray = configDoc.createNestedArray("configurations");
+    while (jsonDocOverflow) {
+        if (jsonCapacity > MAX_CONFJSON_CAPACITY) {
+            AO_DBG_ERR("JSON capacity exceeded");
+            return false;
+        }
 
-    for (auto entry = entries.begin(); entry != entries.end(); entry++) {
-        configurationsArray.add((*entry)->as<JsonObject>());
-    }
+        file->seek(0);
 
-    // Serialize JSON to file
-    if (serializeJson(configDoc, file) == 0) {
-        AO_DBG_ERR("Unable to save: Could not serialize JSON");
-        file.close();
-        return false;
+        doc = DynamicJsonDocument(jsonCapacity);
+        JsonObject head = doc.createNestedObject("head");
+        head["content-type"] = "ao_configuration_file";
+        head["version"] = "1.1";
+
+        JsonArray configurationsArray = doc.createNestedArray("configurations");
+        for (auto entry = entries.begin(); entry != entries.end(); entry++) {
+            configurationsArray.add((*entry)->as<JsonObject>());
+        }
+
+        ArduinoJsonFileAdapter file_adapt {file.get()};
+        size_t written = serializeJson(doc, file_adapt);
+
+        jsonCapacity *= 3;
+        jsonCapacity /= 2;
+        jsonDocOverflow = doc.overflowed();
+
+        if (!jsonDocOverflow && written < 20) { //plausibility check
+            AO_DBG_ERR("Config serialization: unkown error for file %s", getFilename());
+            return false;
+        }
     }
 
     //success
-    file.close();
-    AO_DBG_DEBUG("Saving configDoc successful");
-
-#endif //ndef AO_DEACTIVATE_FLASH
+    AO_DBG_DEBUG("Saving configurations finished");
     return true;
 }
 
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.h b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.h
index e401ab94..865756de 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.h
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.h
@@ -6,14 +6,15 @@
 #define CONFIGURATIONCONTAINERFLASH_H
 
 #include <ArduinoOcpp/Core/ConfigurationContainer.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
 namespace ArduinoOcpp {
 
 class ConfigurationContainerFlash : public ConfigurationContainer {
-
-
+    std::shared_ptr<FilesystemAdapter> filesystem;
 public:
-    ConfigurationContainerFlash(const char *filename) : ConfigurationContainer(filename) { }
+    ConfigurationContainerFlash(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename) :
+            ConfigurationContainer(filename), filesystem(filesystem) { }
 
     ~ConfigurationContainerFlash() = default;
 
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
new file mode 100644
index 00000000..d35789be
--- /dev/null
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -0,0 +1,274 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <ArduinoOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
+#include <ArduinoOcpp/Debug.h>
+
+//#ifndef AO_DEACTIVATE_FLASH
+#if 1
+
+//Set default parameters; assume usage with Arduino if no build flags are present
+#ifndef AO_USE_FILEAPI
+#if defined(ESP32)
+#define AO_USE_FILEAPI ARDUINO_LITTLEFS
+#else
+#define AO_USE_FILEAPI ARDUINO_SPIFFS
+#endif
+#endif //ndef AO_USE_FILEAPI
+
+/*
+ * Platform specific implementations. Currently supported:
+ *     - Arduino LittleFs
+ *     - Arduino SPIFFS
+ *     - ESP-IDF SPIFFS
+ * 
+ * You can add support for any file system by passing custom adapters to the initialize
+ * function of ArduinoOcpp
+ */
+
+#if AO_USE_FILEAPI == ARDUINO_LITTLEFS
+#include <LITTLEFS.h>
+#define USE_FS LITTLEFS
+#elif AO_USE_FILEAPI == ARDUINO_SPIFFS
+#include <FS.h>
+#define USE_FS SPIFFS
+#elif AO_USE_FILEAPI == ESPIDF_SPIFFS
+#include <sys/stat.h>
+#include "esp_spiffs.h"
+#endif
+
+
+#if AO_USE_FILEAPI == ARDUINO_LITTLEFS || AO_USE_FILEAPI == ARDUINO_SPIFFS
+
+namespace ArduinoOcpp {
+namespace EspWiFi {
+
+class ArduinoFileAdapter : public FileAdapter {
+    File file;
+public:
+    ArduinoFileAdapter(File&& file) : file(file) {}
+
+    ~ArduinoFileAdapter() {
+        if (file) {
+            file.close();
+        }
+    }
+    
+    int read() override;
+    size_t read(char *buf, size_t len) override;
+    size_t write(const char *buf, size_t len) override;
+    size_t seek(size_t offset) override;
+};
+
+class ArduinoFilesystemAdapter : public FilesystemAdapter {
+private:
+    bool valid = false;
+    FilesystemOpt config;
+public:
+    ArduinoFilesystemAdapter(FilesystemOpt config) : config(config) {
+        valid = true;
+
+        if (config.mustMount()) { 
+#if AO_USE_FILEAPI == ARDUINO_LITTLEFS
+            if(!USE_FS.begin(config.formatOnFail())) {
+                AO_DBG_ERR("Error while mounting LITTLEFS");
+                valid = false;
+            }
+#elif AO_USE_FILEAPI == ARDUINO_SPIFFS
+            //ESP8266
+            SPIFFSConfig cfg;
+            cfg.setAutoFormat(config.formatOnFail());
+            SPIFFS.setConfig(cfg);
+
+            if (!SPIFFS.begin()) {
+                AO_DBG_ERR("Unable to initialize: unable to mount SPIFFS");
+                valid = false;
+            }
+#else
+#error
+#endif
+        } //end if mustMount()
+    }
+
+    ~ArduinoFilesystemAdapter() {
+        if (config.mustMount()) {
+            USE_FS.end();
+        }
+    }
+
+    operator bool() {return valid;}
+
+    int stat(const char *path, size_t *size) override {
+        if (!USE_FS.exists(path)) {
+            return -1;
+        }
+        File f = USE_FS.open(path, "r");
+        if (!f) {
+            return -1;
+        }
+
+        int status = -1;
+        if (f.isFile()) {
+            size = f.size();
+            status = 0;
+        } else {
+            //fetch more information for directory when ArduinoOcpp also uses them
+            //status = 0;
+        }
+
+        f.close();
+        return status;
+    }
+
+    std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {
+        File file = USE_FS.open(fn, mode);
+        if (file && file.isFile()) {
+            return std::unique_ptr<FileAdapter>(new ArduinoFileAdapter(std::move(file)));
+        } else {
+            return nullptr;
+        }
+    }
+    bool remove(const char *fn) override {
+        return USE_FS.remove(fn);
+    };
+};
+
+std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
+
+    if (!config.accessAllowed()) {
+            AO_DBG_DEBUG("Access to Arduino FS not allowed by config");
+            return nullptr;
+    }
+
+    auto fs = std::unique_ptr<FilesystemAdapter>(
+        new ArduinoFilesystemAdapter(config)
+    );
+
+    if (*fs) {
+        return fs;
+    } else {
+        return nullptr;
+    }
+}
+
+} //end namespace EspWiFi
+} //end namespace ArduinoOcpp
+
+#elif AO_USE_FILEAPI == ESPIDF_SPIFFS
+
+namespace ArduinoOcpp {
+namespace EspWiFi {
+
+class EspIdfFileAdapter : public FileAdapter {
+    FILE *file {nullptr};
+public:
+    EspIdfFileAdapter(FILE *file) : file(file) {}
+
+    ~EspIdfFileAdapter() {
+        fclose(file);
+    }
+
+    size_t read(char *buf, size_t len) override {
+        return fread(buf, 1, len, file);
+    }
+
+    size_t write(const char *buf, size_t len) override {
+        return fwrite(buf, 1, len, file);
+    }
+
+    size_t seek(size_t offset) override {
+        return fseek(file, offset, SEEK_SET);
+    }
+
+    int read() {
+        return fgetc(file);
+    }
+};
+
+class EspIdfFilesystemAdapter : public FilesystemAdapter {
+public:
+    FilesystemOpt config;
+public:
+    EspIdfFilesystemAdapter(FilesystemOpt config) : config(config) { }
+
+    ~EspIdfFilesystemAdapter() {
+        if (config.mustMount()) {
+            esp_vfs_spiffs_unregister("ao"); //partition label
+            AO_DBG_DEBUG("SPIFFS unmounted");
+        }
+    }
+
+    int stat(const char *path, size_t *size) override {
+        struct ::stat st;
+        auto ret = ::stat(path, &st);
+        if (ret == 0) {
+            *size = st.st_size;
+        }
+        return ret;
+    }
+
+    std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {
+        auto file = fopen(fn, mode);
+        if (file) {
+            return std::unique_ptr<FileAdapter>(new EspIdfFileAdapter(std::move(file)));
+        } else {
+            AO_DBG_DEBUG("Failed to open file path %s", fn);
+            return nullptr;
+        }
+    }
+
+    bool remove(const char *fn) override {
+        return unlink(fn) == 0;
+    }
+};
+
+std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
+
+    if (!config.accessAllowed()) {
+            AO_DBG_DEBUG("Access to ESP-IDF SPIFFS not allowed by config");
+            return nullptr;
+    }
+
+    bool mounted = true;
+
+    if (config.mustMount()) {
+        mounted = false;
+        
+        esp_vfs_spiffs_conf_t conf = {
+            .base_path = AO_FILENAME_PREFIX,
+            .partition_label = "ao", //also see deconstructor
+            .max_files = 5,
+            .format_if_mount_failed = config.formatOnFail()
+        };
+
+        esp_err_t ret = esp_vfs_spiffs_register(&conf);
+
+        if (ret == ESP_OK) {
+            mounted = true;
+            AO_DBG_DEBUG("SPIFFS mounted");
+        } else {
+            if (ret == ESP_FAIL) {
+                AO_DBG_ERR("Failed to mount or format filesystem");
+            } else if (ret == ESP_ERR_NOT_FOUND) {
+                AO_DBG_ERR("Failed to find SPIFFS partition");
+            } else {
+                AO_DBG_ERR("Failed to initialize SPIFFS (%s)", esp_err_to_name(ret));
+            }
+        }
+    }
+
+    if (mounted) {
+        return std::unique_ptr<FilesystemAdapter>(new EspIdfFilesystemAdapter(config));
+    } else {
+        return nullptr;
+    }
+}
+
+} //end namespace EspWiFi
+} //end namespace ArduinoOcpp
+
+#endif
+
+#endif
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
new file mode 100644
index 00000000..e32f7779
--- /dev/null
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -0,0 +1,103 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef AO_FILESYSTEMADAPTER_H
+#define AO_FILESYSTEMADAPTER_H
+
+#ifndef AO_FILENAME_PREFIX
+#define AO_FILENAME_PREFIX "/ao_store"
+#endif
+
+#define ARDUINO_LITTLEFS 1
+#define ARDUINO_SPIFFS   2
+#define ESPIDF_SPIFFS    3
+
+#include <memory>
+
+namespace ArduinoOcpp {
+
+class FileAdapter {
+public:
+    virtual ~FileAdapter() = default;
+    virtual size_t read(char *buf, size_t len) = 0;
+    virtual size_t write(const char *buf, size_t len) = 0;
+    virtual size_t seek(size_t offset) = 0;
+    // virtual void close() = 0; implemented in deconstructor
+
+    virtual int read() = 0;
+};
+
+class ArduinoJsonFileAdapter {
+private:
+    FileAdapter *file;
+public:
+    ArduinoJsonFileAdapter(FileAdapter *file) : file(file) { }
+
+    size_t readBytes(char *buf, size_t len) {
+        return file->read(buf, len);
+    }
+
+    int read() {
+        return file->read();
+    }
+
+    size_t write(const uint8_t *buf, size_t len) {
+        return file->write((const char*) buf, len);
+    }
+
+    size_t write(uint8_t c) {
+        return file->write((const char*) &c, 1);
+    }
+};
+
+class FilesystemAdapter {
+public:
+    virtual ~FilesystemAdapter() = default;
+    virtual int stat(const char *path, size_t *size) = 0;
+    virtual std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) = 0;
+    virtual bool remove(const char *fn) = 0;
+};
+
+} //end namespace ArduinoOcpp
+
+//#ifndef AO_DEACTIVATE_FLASH
+#if 1
+
+//Set default parameters; assume usage with Arduino if no build flags are present
+#ifndef AO_USE_FILEAPI
+#if defined(ESP32)
+#define AO_USE_FILEAPI ARDUINO_LITTLEFS
+#else
+#define AO_USE_FILEAPI ARDUINO_SPIFFS
+#endif
+#endif //ndef AO_USE_FILEAPI
+
+/*
+ * Platform specific implementations. Currently supported:
+ *     - Arduino LittleFs
+ *     - Arduino SPIFFS
+ *     - ESP-IDF SPIFFS
+ * 
+ * You can add support for any file system by passing custom adapters to the initialize
+ * function of ArduinoOcpp
+ */
+
+#if AO_USE_FILEAPI == ARDUINO_LITTLEFS || \
+    AO_USE_FILEAPI == ARDUINO_SPIFFS || \
+    AO_USE_FILEAPI == ESPIDF_SPIFFS
+
+#include <ArduinoOcpp/Core/ConfigurationOptions.h>
+
+namespace ArduinoOcpp {
+namespace EspWiFi {
+
+std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config);
+
+} //end namespace EspWiFi
+} //end namespace ArduinoOcpp
+#endif
+
+#endif //ndef AO_DEACTIVATE_FLASH
+
+#endif
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 15c10ce3..310f5d0c 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -112,8 +112,8 @@ bool OcppConnection::processOcppSocketInputTXT(const char* payload, size_t lengt
         doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
         err = deserializeJson(*doc, payload, length);
 
-        capacity /= 2;
         capacity *= 3;
+        capacity /= 2;
     }
 
     //TODO insert validateRpcHeader at suitable position
diff --git a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
index ccd4c57f..3989137a 100644
--- a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
@@ -26,13 +26,15 @@ void GetConfiguration::processReq(JsonObject payload) {
 
 std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
 
-    std::shared_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> configurationKeys;
+    std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> configurationKeys;
     std::vector<std::string> unknownKeys;
 
     if (keys.size() == 0){ //return all existing keys
         configurationKeys = getAllConfigurations();
     } else { //only return keys that were searched using the "key" parameter
-        configurationKeys = std::make_shared<std::vector<std::shared_ptr<AbstractConfiguration>>>();
+        configurationKeys = std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>>(
+                                        new std::vector<std::shared_ptr<AbstractConfiguration>>()
+        );
         for (size_t i = 0; i < keys.size(); i++) {
             std::shared_ptr<AbstractConfiguration> entry = getConfiguration(keys.at(i).c_str());
             if (entry)

From 6c02f43bd50ca59149c6de8f2a0bfeffa6c38d91 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 1 Jun 2022 10:07:54 +0200
Subject: [PATCH 016/549] Add loopback OCPP socket

---
 src/ArduinoOcpp/Core/OcppSocket.h | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppSocket.h b/src/ArduinoOcpp/Core/OcppSocket.h
index f0c9c087..f1fb6db7 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.h
+++ b/src/ArduinoOcpp/Core/OcppSocket.h
@@ -24,6 +24,23 @@ class OcppSocket {
     virtual void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) = 0; //ReceiveTXTcallback is defined in OcppServer.h
 };
 
+class OcppEchoSocket : public OcppSocket {
+private:
+    ReceiveTXTcallback receiveTXT;
+public:
+    void loop() override { }
+    bool sendTXT(std::string &out) override {
+        if (receiveTXT) {
+            return receiveTXT(out.c_str(), out.length());
+        } else {
+            return false;
+        }
+    }
+    void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) override {
+        this->receiveTXT = receiveTXT;
+    }
+};
+
 } //end namespace ArduinoOcpp
 
 #ifndef AO_CUSTOM_WS
@@ -36,10 +53,8 @@ namespace EspWiFi {
 
 class OcppClientSocket : public OcppSocket {
 private:
-    //std::shared_ptr<WebSocketsClient> wsock;
     WebSocketsClient *wsock;
 public:
-    //OcppClientSocket(ReceiveTXTcallback &receiveTXT, std::shared_ptr<WebSocketsClient> wsock);
     OcppClientSocket(WebSocketsClient *wsock);
 
     void loop();

From a1bcd53f84096af4747bef5274f0331d31023b57 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 1 Jun 2022 10:20:37 +0200
Subject: [PATCH 017/549] OCMF support, connector lock integration

---
 src/ArduinoOcpp.cpp                           |  26 +++
 src/ArduinoOcpp.h                             |  21 ++-
 .../MessagesV16/StartTransaction.cpp          |   3 +-
 .../ChargePointStatus/ConnectorStatus.cpp     | 177 +++++++++++++-----
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  27 ++-
 .../TransactionPrerequisites.h                |  27 +++
 6 files changed, 227 insertions(+), 54 deletions(-)
 create mode 100644 src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index d8ffe4d1..f488c258 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -293,6 +293,32 @@ void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
     connector->setOnUnlockConnector(unlockConnector);
 }
 
+void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCondition)> lockConnector) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("Please call OCPP_initialize before");
+        return;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+    connector->setConnectorLock(lockConnector);
+}
+
+void setTxBasedMeterUpdate(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCondition)> updateTxState) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("Please call OCPP_initialize before");
+        return;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+    connector->setTxBasedMeterUpdate(updateTxState);
+}
+
 void setOnSetChargingProfileRequest(OnReceiveReqListener onReceiveReq) {
      setOnSetChargingProfileRequestListener(onReceiveReq);
 }
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 15b3ee91..c22b2088 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -15,6 +15,7 @@
 #include <ArduinoOcpp/Core/OcppOperationTimeout.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Core/PollResult.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
@@ -77,7 +78,25 @@ void addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCo
 
 void setOnChargingRateLimitChange(std::function<void(float)> chargingRateChanged);
 
-void setOnUnlockConnector(std::function<ArduinoOcpp::PollResult<bool>()> unlockConnector); //true: success, false: failure
+//Set a Cb to mechanically unlock the connector. Called for the OCPP operation "UnlockConnector"
+//Return values: true on success, false on failure, PollResult::Await if not known yet
+//Continues to call the Cb as long as it returns PollResult::Await
+void setOnUnlockConnector(std::function<ArduinoOcpp::PollResult<bool>()> unlockConnector);
+
+//Set a Cb for setting the state of the connector lock. Called in the course of normal transactions
+//Return values: - TxEnableState::Active if connector is locked and ready for transaction
+//               - TxEnableState::Inactive if connector lock is released
+//               - TxEnableState::Pending otherwise, e.g. if transitioning between the states
+//Called periodically
+void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCondition)> lockConnector);
+
+//Set a Cb to update transaction-based energy measurements with the most recent transaction state.
+//This allows energy meters (e.g. based on OCMF) to take their measruements right before and after a transaction
+//Return values: - TxEnableState::Active if the energy meter confirmed to be in the transaction-state
+//               - TxEnableState::Inactive if the energy meter has transitioned into a non-transaction-state
+//               - TxEnableState::Pending otherwise, e.g. if transitioning between the states
+//Called periodically
+void setTxBasedMeterUpdate(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCondition)> updateTxState);
 
 /*
  * React on CS-initiated operations
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index f7f3ec57..bee6d6cf 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -136,7 +136,8 @@ std::unique_ptr<DynamicJsonDocument> StartTransaction::createConf() {
 
     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
     idTagInfo["status"] = "Accepted";
-    payload["transactionId"] = 123456; //sample data for debug purpose
+    static int uniqueTxId = 1000;
+    payload["transactionId"] = uniqueTxId++; //sample data for debug purpose
 
     return doc;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 185ff4b5..eb90a08f 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -37,6 +37,8 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
     minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
     stopTransactionOnInvalidId = declareConfiguration<const char*>("StopTransactionOnInvalidId", "true", CONFIGURATION_FN, true, true, false, false);
     stopTransactionOnEVSideDisconnect = declareConfiguration<const char*>("StopTransactionOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, false, false);
+    localAuthorizeOffline = declareConfiguration<const char*>("LocalAuthorizeOffline", "false", CONFIGURATION_FN, true, true, false, false);
+    localPreAuthorize = declareConfiguration<const char*>("LocalPreAuthorize", "false", CONFIGURATION_FN, true, true, false, false);
 
     if (!sIdTag || !transactionId || !availability) {
         AO_DBG_ERR("Cannot declare sessionIdTag, transactionId or availability");
@@ -49,6 +51,29 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
         AO_DBG_DEBUG("Load session idTag at initialization");
     }
     transactionIdSync = *transactionId;
+
+    /*
+     * Initialize standard EVSE behavior.
+     * By default, transactions are triggered by a valid IdTag (+ connected plug as soon as set)
+     * The default necessary steps before starting a transaction are
+     *     - lock the connector (if handler is set)
+     *     - instruct the OCMF meter to begin a transaction (if OCMF meter handler is set)
+     */
+    txTriggerConditions.push_back([this] () -> TxCondition {
+        return getSessionIdTag() == nullptr ? TxCondition::Inactive : TxCondition::Active;
+    });
+    txEnableSequence.push_back([this] (TxCondition cond) -> TxEnableState {
+        if (onOcmfMeterPollTx) {
+            return onOcmfMeterPollTx(cond);
+        }
+        return cond == TxCondition::Active ? TxEnableState::Active : TxEnableState::Inactive;
+    });
+    txEnableSequence.push_back([this] (TxCondition cond) -> TxEnableState {
+        if (onConnectorLockPollTx) {
+            return onConnectorLockPollTx(cond);
+        }
+        return cond == TxCondition::Active ? TxEnableState::Active : TxEnableState::Inactive;
+    });
 }
 
 OcppEvseState ConnectorStatus::inferenceStatus() {
@@ -65,31 +90,16 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
         }
     }
 
-//    auto cpStatusService = context.getChargePointStatusService();
-//
-//    if (!authorized && !getChargePointStatusService()->existsUnboundAuthorization()) {
-//        return OcppEvseState::Available;
-//    } else if (((int) *transactionId) < 0) {
-//        return OcppEvseState::Preparing;
-    //if (connectorFaultedSampler != nullptr && connectorFaultedSampler()) {
     if (getErrorCode() != nullptr) {
         return OcppEvseState::Faulted;
     } else if (*availability == AVAILABILITY_INOPERATIVE) {
         return OcppEvseState::Unavailable;
-    } else if (!session &&
-                getTransactionId() < 0 &&
-                (connectorPluggedSampler == nullptr || !connectorPluggedSampler()) ) {
-        return OcppEvseState::Available;
-    } else if (getTransactionId() <= 0) {
-        if (connectorPluggedSampler != nullptr && connectorPluggedSampler() &&
-                (currentStatus == OcppEvseState::Finishing ||
-                currentStatus == OcppEvseState::Charging ||
-                currentStatus == OcppEvseState::SuspendedEV ||
-                currentStatus == OcppEvseState::SuspendedEVSE)) {
-            return OcppEvseState::Finishing;
-        }
-        return OcppEvseState::Preparing;
-    } else {
+    } else if (getTransactionId() == 0 &&      // i.e. Tx pending or EVSE offline. Check if offline Tx is OFF
+            !(*localAuthorizeOffline && strcmp(*localAuthorizeOffline, "false")) &&
+            !(*localPreAuthorize && strcmp(*localPreAuthorize, "false"))) {
+        //All modes for offline Tx are off
+        return OcppEvseState::Preparing; //see other Preparing case
+    } else if (getTransactionId() >= 0) {
         //Transaction is currently running
         if ((connectorEnergizedSampler && !connectorEnergizedSampler()) ||
                 idTagInvalidated) {
@@ -99,7 +109,32 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
             return OcppEvseState::SuspendedEV;
         }
         return OcppEvseState::Charging;
+    } else if (txEnable == TxEnableState::Inactive) {
+        return OcppEvseState::Available;
+    } else if (txEnable == TxEnableState::Pending ||  
+               txEnable == TxEnableState::Active) {   //reached if Tx init is delayed
+
+        if (txEnable == TxEnableState::Active) { // TODO verify if actually possible
+            AO_DBG_VERBOSE("Infered Active"); //
+            (void)0;                             //
+        }                                        //
+
+        /*
+         * Either in Preparing or Finishing state. Only way to know is from previous state
+         */
+        const auto previous = currentStatus;
+        if (previous == OcppEvseState::Finishing ||
+                previous == OcppEvseState::Charging ||
+                previous == OcppEvseState::SuspendedEV ||
+                previous == OcppEvseState::SuspendedEVSE) {
+            return OcppEvseState::Finishing;
+        } else {
+            return OcppEvseState::Preparing;
+        }
     }
+    
+    AO_DBG_VERBOSE("Cannot infere status");
+    return OcppEvseState::Faulted; //internal error
 }
 
 bool ConnectorStatus::ocppPermitsCharge() {
@@ -120,7 +155,7 @@ bool ConnectorStatus::ocppPermitsCharge() {
 }
 
 OcppMessage *ConnectorStatus::loop() {
-    if (getTransactionId() <= 0 && *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
+    if (getTransactionId() < 0 && *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
         *availability = AVAILABILITY_INOPERATIVE;
         saveState();
     }
@@ -133,29 +168,72 @@ OcppMessage *ConnectorStatus::loop() {
         }
     }
 
+    auto txTrigger = txTriggerConditions.empty() ? TxCondition::Inactive : TxCondition::Active;
+    txEnable = TxEnableState::Inactive;
+
+    if (*availability == AVAILABILITY_INOPERATIVE) {
+        txTrigger = TxCondition::Inactive;
+    }
+
+    if (txTrigger == TxCondition::Active) {
+        for (auto trigger = txTriggerConditions.begin(); trigger != txTriggerConditions.end(); trigger++) {
+            auto result = trigger->operator()();
+            if (result == TxCondition::Active) {
+                txEnable = TxEnableState::Pending;
+            } else {
+                txTrigger = TxCondition::Inactive;
+            }
+        }
+    }
+
+    if (txTrigger == TxCondition::Active) {
+        txEnable = TxEnableState::Active;
+
+        for (auto step = txEnableSequence.rbegin(); step != txEnableSequence.rend(); step++) {
+            auto result = step->operator()(TxCondition::Active);
+            if (result != TxEnableState::Active) {
+                txEnable = TxEnableState::Pending;
+                break;
+            }
+        }
+    } else {
+        for (auto step = txEnableSequence.begin(); step != txEnableSequence.end(); step++) {
+            auto result = step->operator()(TxCondition::Inactive);
+            if (result != TxEnableState::Inactive) {
+                txEnable = TxEnableState::Pending;
+                break;
+            }
+        }
+    }
+
+
     /*
      * Check conditions for start or stop transaction
      */
-    if (connectorPluggedSampler) { //only supported with connectorPluggedSampler
+    if (txEnable == TxEnableState::Active) {
+        //check if not in transaction yet
+        if (getTransactionId() < 0 &&
+                !getErrorCode()) {
+            //start Transaction
+
+            AO_DBG_DEBUG("Session mngt: txId=%i, connectorPlugged = %s, session=%d",
+                    getTransactionId(),
+                    connectorPluggedSampler ? (connectorPluggedSampler() ? "plugged" : "unplugged") : "undefined",
+                    session);
+            AO_DBG_INFO("Session mngt: trigger StartTransaction");
+            return new StartTransaction(connectorId);
+        }
+    } else {
+        //check if still in transaction
         if (getTransactionId() >= 0) {
-            //check condition for StopTransaction
-            if (!session) {
-                AO_DBG_DEBUG("Session mngt: txId=%i, connectorPlugged=%d, session=%d",
-                        getTransactionId(), connectorPluggedSampler(), session);
-                AO_DBG_INFO("Session mngt: trigger StopTransaction");
-                return new StopTransaction(connectorId, endReason[0] != '\0' ? endReason : nullptr);
-            }
-        } else {
-            //check condition for StartTransaction
-            if (connectorPluggedSampler() &&
-                    session &&
-                    !getErrorCode() &&
-                    *availability == AVAILABILITY_OPERATIVE) {
-                AO_DBG_DEBUG("Session mngt: txId=%i, connectorPlugged=%d, session=%d",
-                        getTransactionId(), connectorPluggedSampler(), session);
-                AO_DBG_INFO("Session mngt: trigger StartTransaction");
-                return new StartTransaction(connectorId);
-            }
+            //stop transaction
+
+            AO_DBG_DEBUG("Session mngt: txId=%i, connectorPlugged = %s, session=%d",
+                    getTransactionId(),
+                    connectorPluggedSampler ? (connectorPluggedSampler() ? "plugged" : "unplugged") : "undefined",
+                    session);
+            AO_DBG_INFO("Session mngt: trigger StopTransaction");
+            return new StopTransaction(connectorId, endReason[0] != '\0' ? endReason : nullptr);
         }
     }
 
@@ -172,10 +250,10 @@ OcppMessage *ConnectorStatus::loop() {
         }
     }
 
-    auto inferencedStatus = inferenceStatus();
+    auto inferedStatus = inferenceStatus();
     
-    if (inferencedStatus != currentStatus) {
-        currentStatus = inferencedStatus;
+    if (inferedStatus != currentStatus) {
+        currentStatus = inferedStatus;
         t_statusTransition = ao_tick_ms();
         AO_DBG_DEBUG("Status changed%s", *minimumStatusDuration ? ", will report delayed" : "");
     }
@@ -297,6 +375,9 @@ void ConnectorStatus::setAvailability(bool available) {
 
 void ConnectorStatus::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
     this->connectorPluggedSampler = connectorPlugged;
+    txTriggerConditions.push_back([this] () -> TxCondition {
+        return connectorPluggedSampler() ? TxCondition::Active : TxCondition::Inactive;
+    });
 }
 
 void ConnectorStatus::setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
@@ -322,3 +403,11 @@ void ConnectorStatus::setOnUnlockConnector(std::function<PollResult<bool>()> unl
 std::function<PollResult<bool>()> ConnectorStatus::getOnUnlockConnector() {
     return this->onUnlockConnector;
 }
+
+void ConnectorStatus::setConnectorLock(std::function<TxEnableState(TxCondition)> onConnectorLockPollTx) {
+    this->onConnectorLockPollTx = onConnectorLockPollTx;
+}
+
+void ConnectorStatus::setTxBasedMeterUpdate(std::function<TxEnableState(TxCondition)> onOcmfMeterPollTx) {
+    this->onOcmfMeterPollTx = onOcmfMeterPollTx;
+}
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 8c9a8962..940e1d35 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -2,10 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2022
 // MIT License
 
-#ifndef CONNECTOR_STATUS
-#define CONNECTOR_STATUS
+#ifndef CONNECTORSTATUS_H
+#define CONNECTORSTATUS_H
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
@@ -43,9 +44,9 @@ class ConnectorStatus {
     bool connectionTimeOutListen {false};
     ulong connectionTimeOutTimestamp {0}; //in milliseconds
 
-    std::function<bool()> connectorPluggedSampler {nullptr};
-    std::function<bool()> evRequestsEnergySampler {nullptr};
-    std::function<bool()> connectorEnergizedSampler {nullptr};
+    std::function<bool()> connectorPluggedSampler;
+    std::function<bool()> evRequestsEnergySampler;
+    std::function<bool()> connectorEnergizedSampler;
     std::vector<std::function<const char *()>> connectorErrorCodeSamplers;
     const char *getErrorCode();
 
@@ -54,13 +55,20 @@ class ConnectorStatus {
     OcppEvseState reportedStatus = OcppEvseState::NOT_SET;
     ulong t_statusTransition = 0;
 
-    //std::function<std::unique_ptr<OcppMessage>()> startTransactionBehavior;
-    //std::function<std::unique_ptr<OcppMessage>(const char* stopReason)> stopTransactionBehavior;
+    std::function<PollResult<bool>()> onUnlockConnector;
 
-    std::function<PollResult<bool>()> onUnlockConnector {nullptr};
+    std::function<TxEnableState(TxCondition)> onConnectorLockPollTx;
+    std::function<TxEnableState(TxCondition)> onOcmfMeterPollTx;
+
+    std::vector<std::function<TxCondition()>> txTriggerConditions;
+    std::vector<std::function<TxEnableState(TxCondition)>> txEnableSequence;
+    TxEnableState txEnable {TxEnableState::Inactive}; // = Result of Trigger and Enable Sequence
 
     std::shared_ptr<Configuration<const char*>> stopTransactionOnInvalidId;
     std::shared_ptr<Configuration<const char*>> stopTransactionOnEVSideDisconnect;
+    std::shared_ptr<Configuration<const char*>> unlockConnectorOnEVSideDisconnect;
+    std::shared_ptr<Configuration<const char*>> localAuthorizeOffline;
+    std::shared_ptr<Configuration<const char*>> localPreAuthorize;
 public:
     ConnectorStatus(OcppModel& context, int connectorId);
 
@@ -103,6 +111,9 @@ class ConnectorStatus {
 
     void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector);
     std::function<PollResult<bool>()> getOnUnlockConnector();
+
+    void setConnectorLock(std::function<TxEnableState(TxCondition)> lockConnector);
+    void setTxBasedMeterUpdate(std::function<TxEnableState(TxCondition)> updateTxBasedMeter);
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h
new file mode 100644
index 00000000..d73b3310
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h
@@ -0,0 +1,27 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef TXPREREQUISITES_H
+#define TXPREREQUISITES_H
+
+namespace ArduinoOcpp {
+
+/*
+ * Type definitions for extending the transaction initiation process
+ */
+
+enum class TxCondition {
+    Active,
+    Inactive
+};
+
+enum class TxEnableState {
+    Active,
+    Inactive,
+    Pending
+};
+
+}
+
+#endif

From 322a7c85d16dac2e4f5bc9348b6f2f1adbb69217 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 7 Jun 2022 17:41:23 +0200
Subject: [PATCH 018/549] add energy and power meter cb

---
 src/ArduinoOcpp_c.cpp | 18 ++++++++++++++++++
 src/ArduinoOcpp_c.h   |  2 +-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index b44dceb4..7a027a88 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -63,6 +63,24 @@ std::function<const char*()> adaptCb(SamplerString cb) {
     return cb;
 }
 
+std::function<float()> adaptCb(SamplerFloat cb) {
+    return cb;
+}
+
+std::function<int()> adaptCb(SamplerInt cb) {
+    return cb;
+}
+
+void ao_setPowerActiveImportSampler(SamplerFloat power) {
+    setPowerActiveImportSampler(adaptCb(power));
+}
+
+void ao_setEnergyActiveImportSampler(SamplerInt energy) {
+    setEnergyActiveImportSampler([energy] () -> float {
+        return (float) energy();
+    });
+}
+
 void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy) {
     setEvRequestsEnergySampler(adaptCb(evRequestsEnergy));
 }
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index b36af90a..568cfa7a 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -34,7 +34,7 @@ void ao_set_console_out_c(void (*console_out)(const char *msg));
 
 void ao_setPowerActiveImportSampler(SamplerFloat power);
 
-void ao_setEnergyActiveImportSampler(SamplerFloat energy);
+void ao_setEnergyActiveImportSampler(SamplerInt energy);
 
 void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy);
 

From b01683658c82c0e3093a520ba83953b36ea7f9df Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 8 Jun 2022 10:25:15 +0200
Subject: [PATCH 019/549] explicit custom updater

---
 CMakeLists.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index f0307395..862c2398 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -59,6 +59,7 @@ idf_component_register(SRCS ${AO_SRC}
 target_compile_options(${COMPONENT_TARGET} PUBLIC
     -DAO_CUSTOM_WS
     -DAO_CUSTOM_CONSOLE
+    -DAO_CUSTOM_UPDATER
     -DAO_DEACTIVATE_FLASH
     -DAO_USE_FILEAPI=ESPIDF_SPIFFS
     -DAO_DBG_LEVEL=AO_DL_DEBUG

From 597d04ac7fa707f7f42b2e551661626ad1345fc9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 17 Jun 2022 14:44:24 +0200
Subject: [PATCH 020/549] BootNotification with all fields

---
 src/ArduinoOcpp_c.cpp | 11 +++++++++++
 src/ArduinoOcpp_c.h   |  2 ++
 2 files changed, 13 insertions(+)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 7a027a88..855689c0 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -129,6 +129,17 @@ extern "C" void ao_bootNotification(const char *chargePointModel, const char *ch
     bootNotification("model", "vendor", adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
 }
 
+void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    DynamicJsonDocument *payload = new DynamicJsonDocument(JSON_OBJECT_SIZE(9) + 230 + 9); // BootNotification has at most 9 attributes with at most 230 chars + null terminators
+    auto err = deserializeJson(*payload, payloadJson);
+    if (err) {
+        AO_DBG_ERR("Could not process input: %s", err.c_str());
+        (void)0;
+    }
+
+    bootNotification(payload, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+}
+
 void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
     authorize(idTag, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
 }
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 568cfa7a..16e45b39 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -70,6 +70,8 @@ void ao_onResetRequest(OnOcppMessage onRequest); //alternative: start reset time
 
 void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
+void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
 void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
 void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);

From eca45824a47c7a5513b2104e06d3720adcf70c3a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 18 Jun 2022 11:53:27 +0200
Subject: [PATCH 021/549] update examples

---
 examples/ESP-TLS/main.cpp |   2 +-
 examples/SECC/README.md   |   2 +-
 examples/SECC/main.cpp    | 116 ++++++++++++++++++++------------------
 3 files changed, 62 insertions(+), 58 deletions(-)

diff --git a/examples/ESP-TLS/main.cpp b/examples/ESP-TLS/main.cpp
index 5e9be62e..0bb11e53 100644
--- a/examples/ESP-TLS/main.cpp
+++ b/examples/ESP-TLS/main.cpp
@@ -87,8 +87,8 @@ void setup() {
 #elif defined(ESP32)
     WiFi.begin(STASSID, STAPSK);
     while (!WiFi.isConnected()) {
-        Serial.print('.');
         delay(1000);
+        Serial.print('.');
     }
 #endif
 
diff --git a/examples/SECC/README.md b/examples/SECC/README.md
index 4d9eeaa5..e1f7a7b5 100644
--- a/examples/SECC/README.md
+++ b/examples/SECC/README.md
@@ -15,7 +15,7 @@ You can find the interface descriptions in `main.ino`. Please be aware that alth
 - Copy the `main.ino` from this example folder into your source directory. Adapt the pinout settings if needed.
 - Finished. You should be able to compile and upload the sketch onto your ESP.
 
-When booting, the ESP opens up the Wi-Fi configuration portal. Please connect your PC to the network with the SSID `EVSE_Maintenance_Portal` within the first 30s of the boot routine of the ESP (the portal has a timeout). The passphrase is `myEvseController`.
+When booting, the ESP opens up the Wi-Fi configuration portal. Please connect your PC to the network with the SSID `EVSE-Config` within the first 30s of the boot routine of the ESP (the portal has a timeout). The passphrase is `evse1234`.
 
 ## Standalone mode
 
diff --git a/examples/SECC/main.cpp b/examples/SECC/main.cpp
index 40160cab..446dc6fa 100644
--- a/examples/SECC/main.cpp
+++ b/examples/SECC/main.cpp
@@ -74,11 +74,13 @@
 #define CHARGE_PERMISSION_OFF HIGH
 #endif
 
-#if DEBUG_OUT
+#if !defined(SECC_NO_DEBUG)
 #define PRINT(...) Serial.print(__VA_ARGS__)
+#define PRINTF(...) Serial.printf(__VA_ARGS__)
 #define PRINTLN(...) Serial.println(__VA_ARGS__)
 #else
 #define PRINT(...)
+#define PRINTF(...)
 #define PRINTLN(...)
 #endif
 
@@ -92,14 +94,15 @@ ulong scheduleReboot = 0; //0 = no reboot scheduled; otherwise reboot scheduled
 ulong reboot_timestamp = 0; //timestamp of the triggering event; if scheduleReboot=0, the timestamp has no meaning
 
 // ============ CAPTIVE PORTAL
-#define CAPTIVE_PORTAL_TIMEOUT 30000
+#define CAPTIVE_PORTAL_TIMEOUT  60 //in seconds
+#define WIFI_CONNECTION_TIMEOUT 30 //in seconds
 
 struct Ocpp_URL {
     bool isTLS = true;
     String host = String('\0');
     uint16_t port = 443;
     String url = String('\0');
-    bool parse(String &url);
+    bool parse(String& url);
 };
 
 Ocpp_URL ocppUrlParsed = Ocpp_URL();
@@ -113,7 +116,9 @@ void setup() {
      * Initialize peripherals
      */
     Serial.begin(115200);
+#if !defined(SECC_NO_DEBUG)
     Serial.setDebugOutput(true);
+#endif
     pinMode(EV_PLUG_PIN, INPUT);
     pinMode(EV_CHARGE_PIN, INPUT);
     pinMode(EVSE_GROUND_FAULT_PIN, INPUT);
@@ -174,12 +179,10 @@ void setup() {
         ESP.restart();
     }
 
-    PRINT(F("[main] host, port, URL: "));
-    PRINT(ocppUrlParsed.host);
-    PRINT(F(", "));
-    PRINT(ocppUrlParsed.port);
-    PRINT(F(", "));
-    PRINTLN(ocppUrlParsed.url);
+    PRINTF("[main] host, port, URL: %s, %hu, %s\n",
+                ocppUrlParsed.host.isEmpty() ? "undefined" : ocppUrlParsed.host.c_str(),
+                ocppUrlParsed.port,
+                ocppUrlParsed.url.isEmpty()  ? "undefined" : ocppUrlParsed.url.c_str());
 
     /*
      * Initialize ArduinoOcpp framework.
@@ -202,21 +205,19 @@ void setup() {
                 PRINT('.');
                 now = time(nullptr);
             }
-            PRINT(F(" finished. Unix timestamp is "));
-            PRINTLN(now);
+            PRINTF(" finished. Unix timestamp is %lu\n", now);
 
             wSock.beginSslWithCA(ocppUrlParsed.host.c_str(), ocppUrlParsed.port, ocppUrlParsed.url.c_str(), *CA_cert, "ocpp1.6");
         } else {
-            wSock.beginSSL(ocppUrlParsed.host.c_str(), ocppUrlParsed.port, ocppUrlParsed.url.c_str(), NULL, "ocpp1.6");
+            wSock.beginSSL(ocppUrlParsed.host.c_str(), ocppUrlParsed.port, ocppUrlParsed.url.c_str(), nullptr, "ocpp1.6");
         }
     } else {
         wSock.begin(ocppUrlParsed.host, ocppUrlParsed.port, ocppUrlParsed.url, "ocpp1.6");
     }
 
     OCPP_initialize(oSock,
-            /* Grid voltage */ 230.f, 
-            ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail, 
-            ArduinoOcpp::Clocks::DEFAULT_CLOCK);
+            230.f, //European grid voltage
+            ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
 
     /*
      * Integrate OCPP functionality. You can leave out the following part if your EVSE doesn't need it.
@@ -224,24 +225,26 @@ void setup() {
     setEnergyActiveImportSampler([]() {
         //read the energy input register of the EVSE here and return the value in Wh
         /*
-         * Approximated value. TODO: Replace with real reading
+         * Approximated value. Replace with real reading
          */
         static ulong lastSampled = millis();
         static float energyMeter = 0.f;
-        if (getTransactionId() > 0 && digitalRead(EV_CHARGE_PIN) == EV_CHARGING)
-            energyMeter += ((float) millis() - lastSampled) * 0.003f; //increase by 0.003Wh per ms (~ 10.8kWh per h)
+        if (getTransactionId() > 0)
+            energyMeter += ((float) (millis() - lastSampled)) * 0.003f; //increase by 0.003Wh per ms (~ 10.8kWh per h)
         lastSampled = millis();
         return energyMeter;
     });
 
     setOnChargingRateLimitChange([](float limit) {
         //set the SAE J1772 Control Pilot value here
-        PRINT(F("[main] Smart Charging allows maximum charge rate: "));
-        PRINTLN(limit);
-        float amps = limit / 230.f;
+        const float voltage = 230.f; // European grid
+        const uint nPhases = 1; //one, two or three phase charging
+        float amps = limit / (voltage * (float) nPhases);
         if (amps > 51.f)
             amps = 51.f;
 
+        PRINTF("[main] Smart Charging allows maximum charge rate: %iW; convert to Control Pilot amerage: %.2fA\n", (int) limit, amps);
+
         int pwmVal;
         if (amps < 6.f) {
             pwmVal = 256; // = constant +3.3V DC
@@ -253,7 +256,6 @@ void setup() {
         ledcWrite(AMPERAGE_PIN, pwmVal);
 #elif defined(ESP8266)
         analogWrite(AMPERAGE_PIN, pwmVal);
-#else
 #endif
     });
 
@@ -263,19 +265,20 @@ void setup() {
     });
 
     addConnectorErrorCodeSampler([] () {
-//        if (digitalRead(EVSE_GROUND_FAULT_PIN) != EVSE_GROUND_CLEAR) {
-//            return "GroundFault";
-//        } else {
-            return (const char *) NULL;
-//        }
+        //Uncomment if Ground fault pin is used
+        //if (digitalRead(EVSE_GROUND_FAULT_PIN) != EVSE_GROUND_CLEAR) {
+        //    return "GroundFault";
+        //}
+        return (const char *) nullptr;
     });
 
-    setOnResetSendConf([] (JsonObject payload) {
+    setOnResetSendConf([] (JsonObject confirmation) {
         if (getTransactionId() >= 0)
             stopTransaction();
         
+        PRINTLN(F("[main] Execute reset command"));
         reboot_timestamp = millis();
-        scheduleReboot = 5000;
+        scheduleReboot = 5000; //reboot will be executed in loop()
         booted = false;
     });
 
@@ -284,15 +287,14 @@ void setup() {
     /*
      * Notify the Central System that this station is ready
      */
-    bootNotification("My Charging Station", "My company name", [] (JsonObject payload) {
-        const char *status = payload["status"] | "INVALID";
-        if (!strcmp(status, "Accepted")) {
+    bootNotification("My Charging Station", "My company name", [] (JsonObject response) {
+        if (response["status"].as<String>().equals("Accepted")) {
             booted = true;
             digitalWrite(SERVER_CONNECT_LED, SERVER_CONNECT_ON);
         } else {
-            //retry sending the BootNotification
-            delay(60000);
-            ESP.restart();
+            //Wait for the connection retry
+            reboot_timestamp = millis();
+            scheduleReboot = 60000; //wait for 60s until reboot; reboot will be executed in loop()
         }
     });
 }
@@ -304,47 +306,49 @@ void loop() {
      */
     OCPP_loop();
 
-    /*
-     * Detect if something physical happened at your EVSE and trigger the corresponding OCPP messages
-     */
+    //NFC reader integration example
     if (/* RFID chip detected? */ false) {
         const char *idTag = "my-id-tag"; //e.g. idTag = RFID.readIdTag();
         authorize(idTag);
     }
 
     if (ocppPermitsCharge()) {
+        //EVSE is in a charging session and charging is permitted by the OCPP server
         digitalWrite(OCPP_CHARGE_PERMISSION_PIN, OCPP_CHARGE_PERMITTED);
         digitalWrite(CHARGE_PERMISSION_LED, CHARGE_PERMISSION_ON);
     } else {
+        //Charging is not allowed due to OCPP rules
         digitalWrite(OCPP_CHARGE_PERMISSION_PIN, OCPP_CHARGE_FORBIDDEN);
         digitalWrite(CHARGE_PERMISSION_LED, CHARGE_PERMISSION_OFF);
     }
 
-    if (!booted)
-        return;
     if (scheduleReboot > 0 && millis() - reboot_timestamp >= scheduleReboot) {
         ESP.restart();
     }
 
-    if (digitalRead(EV_PLUG_PIN) == EV_PLUGGED && evPlugged == EV_UNPLUGGED && getTransactionId() >= 0) {
-        //transition unplugged -> plugged; Case A: transaction has already been initiated
-        evPlugged = EV_PLUGGED;
-    } else if (digitalRead(EV_PLUG_PIN) == EV_PLUGGED && evPlugged == EV_UNPLUGGED && isAvailable()) {
-        //transition unplugged -> plugged; Case B: no transaction running; start transaction
-        evPlugged = EV_PLUGGED;
+    if (!booted) {
+        return;
+    }
 
+    auto readEvPlugged = digitalRead(EV_PLUG_PIN);
+    if (evPlugged == EV_UNPLUGGED && readEvPlugged == EV_PLUGGED //transition from unplugged to plugged
+                && getTransactionId() < 0  //no transaction yet
+                && isAvailable()) {        //EVSE is in operative mode
         startTransaction("my-id-tag");
-    } else if (digitalRead(EV_PLUG_PIN) == EV_UNPLUGGED && evPlugged == EV_PLUGGED) {
-        //transition plugged -> unplugged
-        evPlugged = EV_UNPLUGGED;
-
-        if (getTransactionId() >= 0)
-            stopTransaction();
+    } else if (evPlugged == EV_PLUGGED && readEvPlugged == EV_UNPLUGGED //transition from plugged to unplugged
+                && getTransactionId() >= 0) { //need to stop transaction
+        stopTransaction();
     }
+    evPlugged = readEvPlugged;
 
     //... see ArduinoOcpp.h for more possibilities
 }
 
+
+
+// ### End of the OCPP integration. The following code integrates the
+// ### WiFi-Manager into this example sketch.
+
 bool runWiFiManager() {
 
     /*
@@ -416,16 +420,16 @@ bool runWiFiManager() {
     wifiManager.setDarkMode(true);
 
     //wifiManager.setConfigPortalTimeout(CAPATITIVE_PORTAL_TIMEOUT / 1000); //if nobody logs in to the portal, continue after timeout 
-    wifiManager.setTimeout(CAPTIVE_PORTAL_TIMEOUT / 1000); //if nobody logs in to the portal, continue after timeout 
-    wifiManager.setConnectTimeout(CAPTIVE_PORTAL_TIMEOUT / 1000);
+    wifiManager.setTimeout(CAPTIVE_PORTAL_TIMEOUT); //if nobody logs in to the portal, continue after timeout 
+    wifiManager.setConnectTimeout(WIFI_CONNECTION_TIMEOUT);
     //wifiManager.setSaveConnect(true);
     wifiManager.setAPClientCheck(true); // avoid timeout if client connected to softap
     PRINTLN(F("[main] Start capatitive portal"));
     
-    if (wifiManager.startConfigPortal("EVSE_Maintenance_Portal", "myEvseController")) {
+    if (wifiManager.startConfigPortal("EVSE-Config", "evse1234")) {
         return true;
     } else {
-        return wifiManager.autoConnect("EVSE_Maintenance_Portal", "myEvseController");
+        return wifiManager.autoConnect("EVSE-Config", "evse1234");
     }
 }
 

From f2956cbb7fbf5b240c07cca372cca785c8c63416 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 18 Jun 2022 12:18:19 +0200
Subject: [PATCH 022/549] update Status documentation

---
 .../MessagesV16/StatusNotification.cpp        |  2 +-
 .../ChargePointStatus/ConnectorStatus.cpp     |  1 +
 .../Tasks/ChargePointStatus/OcppEvseState.h   | 20 +++++++++----------
 3 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index 72cdff6a..89350484 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -45,7 +45,7 @@ const char *cstrFromOcppEveState(OcppEvseState state) {
 StatusNotification::StatusNotification(int connectorId, OcppEvseState currentStatus, const OcppTimestamp &otimestamp, const char *errorCode) 
   : connectorId(connectorId), currentStatus(currentStatus), otimestamp(otimestamp), errorCode(errorCode) {
 
-    AO_DBG_INFO("New status: %s", cstrFromOcppEveState(currentStatus));
+    AO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
 }
 
 const char* StatusNotification::getOcppOperationType(){
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index eb90a08f..0a8d67fa 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -37,6 +37,7 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
     minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
     stopTransactionOnInvalidId = declareConfiguration<const char*>("StopTransactionOnInvalidId", "true", CONFIGURATION_FN, true, true, false, false);
     stopTransactionOnEVSideDisconnect = declareConfiguration<const char*>("StopTransactionOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, false, false);
+    unlockConnectorOnEVSideDisconnect = declareConfiguration<const char*>("UnlockConnectorOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, false, false);
     localAuthorizeOffline = declareConfiguration<const char*>("LocalAuthorizeOffline", "false", CONFIGURATION_FN, true, true, false, false);
     localPreAuthorize = declareConfiguration<const char*>("LocalPreAuthorize", "false", CONFIGURATION_FN, true, true, false, false);
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h
index 00a49152..a3d9964a 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h
@@ -8,16 +8,16 @@
 namespace ArduinoOcpp {
 
 enum class OcppEvseState {
-  Available,
-  Preparing,
-  Charging,
-  SuspendedEVSE,
-  SuspendedEV,
-  Finishing,    //not supported by this client
-  Reserved,     //not supported by this client
-  Unavailable,
-  Faulted,
-  NOT_SET //not part of OCPP 1.6
+    Available,
+    Preparing,
+    Charging,
+    SuspendedEVSE,
+    SuspendedEV,
+    Finishing,
+    Reserved,
+    Unavailable,
+    Faulted,
+    NOT_SET //internal value for "undefined"
 };
 
 } //end namespace ArduinoOcpp

From a45d3a822c031394e50b52324a9c291feb4a2e01 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 18 Jun 2022 23:07:39 +0200
Subject: [PATCH 023/549] more Smart Charging Configuration keys

---
 src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp | 3 +++
 src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h   | 4 +++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index b4cd67ce..0dd66ba8 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -44,6 +44,9 @@ SmartChargingService::SmartChargingService(OcppEngine& context, float chargeLimi
         TxProfile[i] = NULL;
     }
     declareConfiguration<int>("ChargeProfileMaxStackLevel", CHARGEPROFILEMAXSTACKLEVEL, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit ", "Power", CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<int>("ChargingScheduleMaxPeriods", CHARGINGSCHEDULEMAXPERIODS, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<int>("MaxChargingProfilesInstalled", MAXCHARGINGPROFILESINSTALLED, CONFIGURATION_VOLATILE, false, true, false, false);
 
     const char *fpId = "SmartCharging";
     auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
index 53546204..8dd10dc6 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
@@ -5,7 +5,9 @@
 #ifndef SMARTCHARGINGSERVICE_H
 #define SMARTCHARGINGSERVICE_H
 
-#define CHARGEPROFILEMAXSTACKLEVEL 20
+#define CHARGEPROFILEMAXSTACKLEVEL 8
+#define CHARGINGSCHEDULEMAXPERIODS 24
+#define MAXCHARGINGPROFILESINSTALLED 10
 
 #include <ArduinoJson.h>
 #include <functional>

From 5f3a729d62f0337aaba20905596d91d56f09b088 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 19 Jun 2022 11:16:49 +0200
Subject: [PATCH 024/549] cache BootNotification credentials

---
 src/ArduinoOcpp.cpp                           | 10 ++-
 .../MessagesV16/BootNotification.cpp          | 74 +++++++++----------
 .../MessagesV16/BootNotification.h            | 17 ++---
 .../ChargePointStatusService.cpp              | 23 ++++++
 .../ChargePointStatusService.h                |  5 ++
 5 files changed, 78 insertions(+), 51 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index f488c258..9add110d 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -374,8 +374,14 @@ void bootNotification(const char *chargePointModel, const char *chargePointVendo
         AO_DBG_ERR("Please call OCPP_initialize before");
         return;
     }
+    
+    auto credentials = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+        JSON_OBJECT_SIZE(2) + strlen(chargePointModel) + strlen(chargePointVendor) + 2));
+    (*credentials)["chargePointModel"] = (char*) chargePointModel;
+    (*credentials)["chargePointVendor"] = (char*) chargePointVendor;
+
     auto bootNotification = makeOcppOperation(
-        new BootNotification(chargePointModel, chargePointVendor));
+        new BootNotification(std::move(credentials)));
     if (onConf)
         bootNotification->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -397,7 +403,7 @@ void bootNotification(DynamicJsonDocument *payload, OnReceiveConfListener onConf
         return;
     }
     auto bootNotification = makeOcppOperation(
-        new BootNotification(payload));
+        new BootNotification(std::unique_ptr<DynamicJsonDocument>(payload)));
     if (onConf)
         bootNotification->setOnReceiveConfListener(onConf);
     if (onAbort)
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
index ab5a2309..3bae171e 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
@@ -13,56 +13,56 @@
 using ArduinoOcpp::Ocpp16::BootNotification;
 
 BootNotification::BootNotification() {
-  
-}
-
-BootNotification::BootNotification(const char *cpModel, const char *cpVendor) {
-    snprintf(chargePointModel, CP_MODEL_LEN_MAX + 1, "%s", cpModel);
-    snprintf(chargePointVendor, CP_VENDOR_LEN_MAX + 1, "%s", cpVendor);
-}
-
-BootNotification::BootNotification(const char *cpModel, const char *cpSerialNumber, const char *cpVendor, const char *fwVersion) {
-    snprintf(chargePointModel, CP_MODEL_LEN_MAX + 1, "%s", cpModel);
-    snprintf(chargePointSerialNumber, CP_SERIALNUMBER_LEN_MAX + 1, "%s", cpSerialNumber);
-    snprintf(chargePointVendor, CP_VENDOR_LEN_MAX + 1, "%s", cpVendor);
-    snprintf(firmwareVersion, FW_VERSION_LEN_MAX + 1, "%s", fwVersion);
-}
-
-BootNotification::BootNotification(DynamicJsonDocument *payload) {
-    this->overridePayload = payload;
+    
 }
 
-BootNotification::~BootNotification() {
-    if (overridePayload != nullptr)
-        delete overridePayload;
+BootNotification::BootNotification(std::unique_ptr<DynamicJsonDocument> payload) : credentials(std::move(payload)) {
+    
 }
 
 const char* BootNotification::getOcppOperationType(){
     return "BootNotification";
 }
 
+void BootNotification::initiate() {
+    if (credentials &&
+            ocppModel && ocppModel->getChargePointStatusService()) {
+        auto cpStatus = ocppModel->getChargePointStatusService();
+        cpStatus->setChargePointCredentials(*credentials);
+        credentials.release();
+    }
+}
+
 std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
 
-    if (overridePayload != nullptr) {
-        auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(*overridePayload));
-        return result;
-    }
+    if (ocppModel && ocppModel->getChargePointStatusService()) {
+        auto cpStatus = ocppModel->getChargePointStatusService();
+        const auto& cpCredentials = cpStatus->getChargePointCredentials();
+    
+        std::unique_ptr<DynamicJsonDocument> doc;
+        size_t capacity = JSON_OBJECT_SIZE(9) + cpCredentials.size();
+        DeserializationError err = DeserializationError::NoMemory;
+        while (err == DeserializationError::NoMemory) {
+            doc.reset(new DynamicJsonDocument(capacity));
+            err = deserializeJson(*doc, cpCredentials);
+
+            capacity *= 3;
+            capacity /= 2;
+        }
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)
-        + strlen(chargePointModel) + 1
-        + strlen(chargePointVendor) + 1
-        + strlen(chargePointSerialNumber) + 1
-        + strlen(firmwareVersion) + 1));
-    JsonObject payload = doc->to<JsonObject>();
-    payload["chargePointModel"] = chargePointModel;
-    if (chargePointSerialNumber[0]) {
-        payload["chargePointSerialNumber"] = chargePointSerialNumber;
+        if (!err) {
+            return doc;
+        } else {
+            AO_DBG_ERR("could not parse stored credentials: %s", err.c_str());
+        }
     }
-    payload["chargePointVendor"] = chargePointVendor;
-    if (firmwareVersion[0]) {
-        payload["firmwareVersion"] = firmwareVersion;
+
+    if (credentials) {
+        return std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(*credentials));
     }
-    return doc;
+    
+    AO_DBG_ERR("payload undefined");
+    return createEmptyDocument();
 }
 
 void BootNotification::processConf(JsonObject payload){
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.h b/src/ArduinoOcpp/MessagesV16/BootNotification.h
index 54449802..5f33364a 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.h
@@ -18,25 +18,18 @@ namespace Ocpp16 {
 
 class BootNotification : public OcppMessage {
 private:
-    char chargePointModel [CP_MODEL_LEN_MAX + 1] = {'\0'};
-    char chargePointSerialNumber [CP_SERIALNUMBER_LEN_MAX + 1] = {'\0'};
-    char chargePointVendor [CP_VENDOR_LEN_MAX + 1] = {'\0'};
-    char firmwareVersion [FW_VERSION_LEN_MAX + 1] = {'\0'};
-
-    DynamicJsonDocument *overridePayload = NULL;
+    std::unique_ptr<DynamicJsonDocument> credentials;
 public:
     BootNotification();
 
-    ~BootNotification();
-
-    BootNotification(const char *chargePointModel, const char *chargePointVendor);
+    ~BootNotification() = default;
 
-    BootNotification(const char *chargePointModel, const char *chargePointSerialNumber, const char *chargePointVendor, const char *firmwareVersion);
-
-    BootNotification(DynamicJsonDocument *payload);
+    BootNotification(std::unique_ptr<DynamicJsonDocument> payload);
 
     const char* getOcppOperationType();
 
+    void initiate();
+
     std::unique_ptr<DynamicJsonDocument> createReq();
 
     void processConf(JsonObject payload);
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 7a43ac50..ce616d72 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -86,3 +86,26 @@ bool ChargePointStatusService::isBooted() {
 int ChargePointStatusService::getNumConnectors() {
     return connectors.size();
 }
+
+void ChargePointStatusService::setChargePointCredentials(DynamicJsonDocument &credentials) {
+    if (!credentials.is<JsonObject>()) {
+        AO_DBG_ERR("Payload must be JSON object");
+        cpCredentials.clear();
+        return;
+    }
+    auto written = serializeJson(credentials, cpCredentials);
+    if (written <= 2) {
+        AO_DBG_ERR("Could not parse CP credentials: %s", written == 2 ? "format violation" : "invalid JSON");
+        cpCredentials.clear();
+        return;
+    }
+    //success
+}
+
+std::string& ChargePointStatusService::getChargePointCredentials() {
+    if (cpCredentials.size() <= 2) {
+        cpCredentials = "{}";
+    }
+
+    return cpCredentials;
+}
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
index ce95f59e..7526d352 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
@@ -21,6 +21,8 @@ class ChargePointStatusService {
 
     bool booted = false;
 
+    std::string cpCredentials;
+
 public:
     ChargePointStatusService(OcppEngine& context, unsigned int numConnectors);
 
@@ -33,6 +35,9 @@ class ChargePointStatusService {
 
     ConnectorStatus *getConnector(int connectorId);
     int getNumConnectors();
+
+    void setChargePointCredentials(DynamicJsonDocument &credentials);
+    std::string& getChargePointCredentials();
 };
 
 } //end namespace ArduinoOcpp

From 0d870bb448af3147e8e50c3517ff6b5ab6f01b2a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Jun 2022 23:24:23 +0200
Subject: [PATCH 025/549] fix ClearChargingProfile not removed

---
 src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h    | 6 +++---
 .../Tasks/SmartCharging/SmartChargingService.cpp            | 1 +
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
index d909e6a7..9a107e8c 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
@@ -94,9 +94,9 @@ class ChargingProfile {
     int chargingProfileId = -1;
     int transactionId = -1;
     int stackLevel = 0;
-    ChargingProfilePurposeType chargingProfilePurpose;
-    ChargingProfileKindType chargingProfileKind; //copied to ChargingSchedule to increase cohesion of limit inferencing methods
-    RecurrencyKindType recurrencyKind; // copied to ChargingSchedule to increase cohesion
+    ChargingProfilePurposeType chargingProfilePurpose {ChargingProfilePurposeType::TxProfile};
+    ChargingProfileKindType chargingProfileKind {ChargingProfileKindType::Relative}; //copied to ChargingSchedule to increase cohesion of limit inferencing methods
+    RecurrencyKindType recurrencyKind {RecurrencyKindType::NOT_SET}; // copied to ChargingSchedule to increase cohesion
     OcppTimestamp validFrom;
     OcppTimestamp validTo;
     std::unique_ptr<ChargingSchedule> chargingSchedule;
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index 0dd66ba8..08e752ae 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -330,6 +330,7 @@ bool SmartChargingService::clearChargingProfile(const std::function<bool(int, in
                 }
 #endif
                 delete chargingProfile;
+                profileStack[iLevel] = nullptr;
             }
         }
     }

From d0c411f248d40c39f1e79652e4ee83b0d901add2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Jun 2022 23:27:08 +0200
Subject: [PATCH 026/549] fix SuspendedEVSE state

---
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 0a8d67fa..f61b5f91 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -386,7 +386,7 @@ void ConnectorStatus::setEvRequestsEnergySampler(std::function<bool()> evRequest
 }
 
 void ConnectorStatus::setConnectorEnergizedSampler(std::function<bool()> connectorEnergized) {
-    this->connectorEnergizedSampler = connectorEnergizedSampler;
+    this->connectorEnergizedSampler = connectorEnergized;
 }
 
 void ConnectorStatus::addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode) {

From d29698ec281a7e6e3620a1c7b08ad2cd94e4af3f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Jun 2022 23:27:27 +0200
Subject: [PATCH 027/549] update BootNotification facade call

---
 src/ArduinoOcpp.cpp | 20 +++-----------------
 src/ArduinoOcpp.h   |  2 +-
 2 files changed, 4 insertions(+), 18 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 9add110d..c2cd64a2 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -380,30 +380,16 @@ void bootNotification(const char *chargePointModel, const char *chargePointVendo
     (*credentials)["chargePointModel"] = (char*) chargePointModel;
     (*credentials)["chargePointVendor"] = (char*) chargePointVendor;
 
-    auto bootNotification = makeOcppOperation(
-        new BootNotification(std::move(credentials)));
-    if (onConf)
-        bootNotification->setOnReceiveConfListener(onConf);
-    if (onAbort)
-        bootNotification->setOnAbortListener(onAbort);
-    if (onTimeout)
-        bootNotification->setOnTimeoutListener(onTimeout);
-    if (onError)
-        bootNotification->setOnReceiveErrorListener(onError);
-    if (timeout)
-        bootNotification->setTimeout(std::move(timeout));
-    else
-        bootNotification->setTimeout(std::unique_ptr<Timeout> (new SuppressedTimeout()));
-    ocppEngine->initiateOperation(std::move(bootNotification));
+    bootNotification(std::move(credentials), onConf, onAbort, onTimeout, onError, std::move(timeout));
 }
 
-void bootNotification(DynamicJsonDocument *payload, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
     if (!ocppEngine) {
         AO_DBG_ERR("Please call OCPP_initialize before");
         return;
     }
     auto bootNotification = makeOcppOperation(
-        new BootNotification(std::unique_ptr<DynamicJsonDocument>(payload)));
+        new BootNotification(std::move(payload)));
     if (onConf)
         bootNotification->setOnReceiveConfListener(onConf);
     if (onAbort)
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index c22b2088..c24ed0f4 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -145,7 +145,7 @@ void authorize(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbor
 void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
 
 //The OCPP operation will include the given payload without modifying it. The library will delete the payload object after successful transmission.
-void bootNotification(DynamicJsonDocument *payload, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
 
 void startTransaction(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
 

From 235202fcd1c774c8f41ac178bd32d0e0d55dc3fb Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 25 Jun 2022 00:32:46 +0200
Subject: [PATCH 028/549] improved Reset integration

---
 src/ArduinoOcpp.cpp                           |  4 ++
 src/ArduinoOcpp/MessagesV16/Reset.cpp         | 20 ++++--
 src/ArduinoOcpp/MessagesV16/Reset.h           |  2 +
 .../ChargePointStatusService.cpp              | 65 ++++++++++++++++++-
 .../ChargePointStatusService.h                | 31 +++++++++
 .../ChargePointStatus/ConnectorStatus.cpp     | 12 ++++
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  3 +
 7 files changed, 129 insertions(+), 8 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index c2cd64a2..7f5333fc 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -110,6 +110,10 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
         new DiagnosticsService(*ocppEngine)));
 #endif
 
+#if !defined(AO_CUSTOM_RESET)
+    model.getChargePointStatusService()->setExecuteReset(EspWiFi::makeDefaultResetFn());
+#endif
+
     ocppEngine->setRunOcppTasks(false); //prevent OCPP classes from doing anything while booting
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.cpp b/src/ArduinoOcpp/MessagesV16/Reset.cpp
index 9e751ca6..0e54e8ef 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Reset.cpp
@@ -25,19 +25,25 @@ void Reset::processReq(JsonObject payload) {
 
     if (ocppModel && ocppModel->getChargePointStatusService()) {
         auto cpsService = ocppModel->getChargePointStatusService();
-        int connId = 0;
-        for (int i = 0; i < cpsService->getNumConnectors(); i++) {
-            auto connector = cpsService->getConnector(connId);
-            if (connector) {
-                connector->endSession(isHard ? "HardReset" : "SoftReset");
+        if (!cpsService->getPreReset() || cpsService->getPreReset()(isHard) || isHard) {
+            resetAccepted = true;
+            cpsService->initiateReset(isHard);
+            int connId = 0;
+            for (int i = 0; i < cpsService->getNumConnectors(); i++) {
+                auto connector = cpsService->getConnector(connId);
+                if (connector) {
+                    connector->endSession(isHard ? "HardReset" : "SoftReset");
+                }
             }
         }
+    } else {
+        resetAccepted = true; //assume that onReceiveReset is set
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> Reset::createConf(){
+std::unique_ptr<DynamicJsonDocument> Reset::createConf() {
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    payload["status"] = "Accepted";
+    payload["status"] = resetAccepted ? "Accepted" : "Rejected";
     return doc;
 }
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.h b/src/ArduinoOcpp/MessagesV16/Reset.h
index e7dcfa83..7693dddb 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.h
+++ b/src/ArduinoOcpp/MessagesV16/Reset.h
@@ -11,6 +11,8 @@ namespace ArduinoOcpp {
 namespace Ocpp16 {
 
 class Reset : public OcppMessage {
+private:
+    bool resetAccepted {false};
 public:
     Reset();
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index ce616d72..7ac60c4a 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -12,6 +12,8 @@
 #include <memory>
 #include <string.h>
 
+#define RESET_DELAY 15000
+
 using namespace ArduinoOcpp;
 
 ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned int numConn)
@@ -20,7 +22,6 @@ ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned
     for (unsigned int i = 0; i < numConn; i++) {
         connectors.push_back(std::unique_ptr<ConnectorStatus>(new ConnectorStatus(context.getOcppModel(), i)));
     }
-
     
     std::shared_ptr<Configuration<int>> numberOfConnectors =
             declareConfiguration<int>("NumberOfConnectors", numConn >= 1 ? numConn - 1 : 0, CONFIGURATION_VOLATILE, false, true, false, false);
@@ -44,6 +45,8 @@ ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
 
+    resetRetries = declareConfiguration<int>("ResetRetries", 2, CONFIGURATION_FN, true, true, false, false);
+    
     /*
      * Further configuration keys which correspond to the Core profile
      */
@@ -64,6 +67,25 @@ void ChargePointStatusService::loop() {
             context.initiateOperation(std::move(statusNotification));
         }
     }
+
+    if (outstandingResetRetries > 0 && ao_tick_ms() - t_resetRetry >= RESET_DELAY) {
+        t_resetRetry = ao_tick_ms();
+        outstandingResetRetries--;
+        if (executeReset) {
+            AO_DBG_INFO("Reset device");
+            executeReset(isHardReset);
+        } else {
+            AO_DBG_ERR("No Reset function set! Abort");
+            outstandingResetRetries = 0;
+        }
+        AO_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
+
+        if (outstandingResetRetries <= 0) {
+            for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
+                (*connector)->setRebooting(false);
+            }
+        }
+    }
 }
 
 ConnectorStatus *ChargePointStatusService::getConnector(int connectorId) {
@@ -109,3 +131,44 @@ std::string& ChargePointStatusService::getChargePointCredentials() {
 
     return cpCredentials;
 }
+
+void ChargePointStatusService::setPreReset(std::function<bool(bool)> preReset) {
+    this->preReset = preReset;
+}
+
+std::function<bool(bool)> ChargePointStatusService::getPreReset() {
+    return this->preReset;
+}
+
+void ChargePointStatusService::setExecuteReset(std::function<void(bool)> executeReset) {
+    this->executeReset = executeReset;
+}
+
+std::function<void(bool)> ChargePointStatusService::getExecuteReset() {
+    return this->executeReset;
+}
+
+void ChargePointStatusService::initiateReset(bool isHard) {
+    isHardReset = isHard;
+    outstandingResetRetries = 1 + *resetRetries; //one initial try + no. of retries
+    if (outstandingResetRetries > 5) {
+        AO_DBG_ERR("no. of reset trials exceeds 5");
+        outstandingResetRetries = 5;
+    }
+    t_resetRetry = ao_tick_ms();
+
+    for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
+        (*connector)->setRebooting(true);
+    }
+}
+
+#if !defined(AO_CUSTOM_RESET)
+#if defined(ESP32) || defined(ESP8266)
+std::function<void(bool isHard)> ArduinoOcpp::EspWiFi::makeDefaultResetFn() {
+    return [] (bool isHard) {
+        AO_DBG_DEBUG("Perform ESP reset");
+        ESP.restart();
+    };
+}
+#endif //defined(ESP32) || defined(ESP8266)
+#endif //!defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
index 7526d352..2add4e7c 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
@@ -23,6 +23,14 @@ class ChargePointStatusService {
 
     std::string cpCredentials;
 
+    std::function<bool(bool isHard)> preReset; //true: reset is possible; false: reject reset; Await: need more time to determine
+    std::function<void(bool isHard)> executeReset; //please disconnect WebSocket (AO remains initialized), shut down device and restart with normal initialization routine; on failure reconnect WebSocket
+    uint outstandingResetRetries = 0; //0 = do not reset device
+    bool isHardReset = false;
+    ulong t_resetRetry;
+
+    std::shared_ptr<Configuration<int>> resetRetries;
+
 public:
     ChargePointStatusService(OcppEngine& context, unsigned int numConnectors);
 
@@ -38,7 +46,30 @@ class ChargePointStatusService {
 
     void setChargePointCredentials(DynamicJsonDocument &credentials);
     std::string& getChargePointCredentials();
+
+    void setPreReset(std::function<bool(bool isHard)> preReset);
+    std::function<bool(bool isHard)> getPreReset();
+
+    void setExecuteReset(std::function<void(bool isHard)> executeReset);
+    std::function<void(bool isHard)> getExecuteReset();
+
+    void initiateReset(bool isHard);
 };
 
 } //end namespace ArduinoOcpp
+
+#if !defined(AO_CUSTOM_RESET)
+#if defined(ESP32) || defined(ESP8266)
+
+namespace ArduinoOcpp {
+namespace EspWiFi {
+
+std::function<void(bool isHard)> makeDefaultResetFn();
+
+}
+}
+
+#endif //defined(ESP32) || defined(ESP8266)
+#endif //!defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+
 #endif
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index f61b5f91..e4682138 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -86,6 +86,8 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
             return OcppEvseState::Faulted;
         } else if (*availability == AVAILABILITY_INOPERATIVE) {
             return OcppEvseState::Unavailable;
+        } else if (rebooting) {
+            return OcppEvseState::Unavailable;
         } else {
             return OcppEvseState::Available;
         }
@@ -95,6 +97,8 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
         return OcppEvseState::Faulted;
     } else if (*availability == AVAILABILITY_INOPERATIVE) {
         return OcppEvseState::Unavailable;
+    } else if (rebooting && getTransactionId() < 0) {
+        return OcppEvseState::Unavailable;
     } else if (getTransactionId() == 0 &&      // i.e. Tx pending or EVSE offline. Check if offline Tx is OFF
             !(*localAuthorizeOffline && strcmp(*localAuthorizeOffline, "false")) &&
             !(*localPreAuthorize && strcmp(*localPreAuthorize, "false"))) {
@@ -334,6 +338,10 @@ const char *ConnectorStatus::getSessionIdTag() {
     return session ? idTag : nullptr;
 }
 
+uint16_t ConnectorStatus::getSessionWriteCount() {
+    return sIdTag->getValueRevision();
+}
+
 int ConnectorStatus::getTransactionId() {
     return *transactionId;
 }
@@ -374,6 +382,10 @@ void ConnectorStatus::setAvailability(bool available) {
     saveState();
 }
 
+void ConnectorStatus::setRebooting(bool rebooting) {
+    this->rebooting = rebooting;
+}
+
 void ConnectorStatus::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
     this->connectorPluggedSampler = connectorPlugged;
     txTriggerConditions.push_back([this] () -> TxCondition {
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 940e1d35..ec5492ba 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -31,6 +31,7 @@ class ConnectorStatus {
     const int connectorId;
 
     std::shared_ptr<Configuration<int>> availability;
+    bool rebooting = false; //report connector inoperative and reject new charging sessions
 
     bool session = false;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
@@ -86,6 +87,7 @@ class ConnectorStatus {
     void endSession(const char *reason = nullptr);
     void setIdTagInvalidated(); //if StartTransaction.conf() has status != "Accepted"
     const char *getSessionIdTag();
+    uint16_t getSessionWriteCount();
     int getTransactionId();
     int getTransactionIdSync();
     uint16_t getTransactionWriteCount();
@@ -94,6 +96,7 @@ class ConnectorStatus {
 
     int getAvailability();
     void setAvailability(bool available);
+    void setRebooting(bool rebooting);
     void setAuthorizationProvider(std::function<const char *()> authorization);
     void setConnectorPluggedSampler(std::function<bool()> connectorPlugged);
     void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy);

From 0041934bc22da9448f1f89b4b2aa1dd47435203c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 26 Jun 2022 17:53:44 +0200
Subject: [PATCH 029/549] RmtTx charging profile support

---
 .../MessagesV16/RemoteStartTransaction.cpp    | 55 ++++++++++--
 .../MessagesV16/RemoteStartTransaction.h      |  5 ++
 .../MessagesV16/SetChargingProfile.cpp        |  2 +-
 .../SmartCharging/SmartChargingModel.cpp      | 35 +++++---
 .../Tasks/SmartCharging/SmartChargingModel.h  |  4 +-
 .../SmartCharging/SmartChargingService.cpp    | 88 +++++++++++++++----
 .../SmartCharging/SmartChargingService.h      | 14 ++-
 7 files changed, 158 insertions(+), 45 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
index 4100b291..39835d7a 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
@@ -5,7 +5,9 @@
 
 #include <ArduinoOcpp/MessagesV16/RemoteStartTransaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::RemoteStartTransaction;
@@ -27,20 +29,28 @@ void RemoteStartTransaction::processReq(JsonObject payload) {
         snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
     }
 
+    if (*idTag == '\0') {
+        AO_DBG_WARN("idTag format violation");
+        errorCode = "FormationViolation";
+    }
+
     if (payload.containsKey("chargingProfile")) {
-        AO_DBG_WARN("chargingProfile via RmtStartTransaction not supported yet");
+        AO_DBG_INFO("Setting Charging profile via RemoteStartTransaction");
+
+        JsonObject chargingProfile = payload["chargingProfile"];
+        if ((chargingProfile["chargingProfileId"] | -1) < 0) {
+            AO_DBG_WARN("RemoteStartTx profile requires non-negative chargingProfileId");
+            errorCode = chargingProfile.containsKey("chargingProfileId") ? 
+                        "PropertyConstraintViolation" : "FormationViolation";
+        }
+        chargingProfileDoc = DynamicJsonDocument(chargingProfile.memoryUsage()); //copy TxProfile
+        chargingProfileDoc.set(chargingProfile);
     }
 }
 
 std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-
-    if (*idTag == '\0') {
-        AO_DBG_WARN("idTag format violation");
-        payload["status"] = "Rejected";
-        return doc;
-    }
     
     bool canStartTransaction = false;
     if (connectorId >= 1) {
@@ -70,13 +80,42 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         }
     }
 
-    if (canStartTransaction){
+    if (canStartTransaction) {
+
+        auto sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, CONFIGURATION_FN, false, false, true, false);
+
+        if (ocppModel && ocppModel->getSmartChargingService()) {
+            auto scService = ocppModel->getSmartChargingService();
+
+            if (*sRmtProfileId >= 0) {
+                int clearProfileId = *sRmtProfileId;
+                bool ret = scService->clearChargingProfile([clearProfileId](int id, int, ChargingProfilePurposeType, int) {
+                    return id == clearProfileId;
+                });
+
+                *sRmtProfileId = -1;
+                AO_DBG_DEBUG("Cleared Charging Profile from previous RemoteStartTx: %s", ret ? "success" : "already cleared");
+                configuration_save();
+            }
+        }
+
         if (ocppModel && ocppModel->getConnectorStatus(connectorId)) {
             auto connector = ocppModel->getConnectorStatus(connectorId);
 
             connector->beginSession(idTag);
         }
 
+        if (!chargingProfileDoc.isNull()
+                && (ocppModel && ocppModel->getSmartChargingService())) {
+            auto scService = ocppModel->getSmartChargingService();
+
+            JsonObject chargingProfile = chargingProfileDoc.as<JsonObject>();
+            scService->setChargingProfile(chargingProfile);
+            *sRmtProfileId = chargingProfile["chargingProfileId"].as<int>();
+            AO_DBG_DEBUG("Charging Profile from RemoteStartTx set");
+            configuration_save();
+        }
+
         payload["status"] = "Accepted";
     } else {
         AO_DBG_INFO("No connector to start transaction");
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
index f8026d6b..f3d077b6 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
@@ -15,6 +15,9 @@ class RemoteStartTransaction : public OcppMessage {
 private:
     int connectorId;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
+    DynamicJsonDocument chargingProfileDoc {0};
+    
+    const char *errorCode {nullptr};
 public:
     RemoteStartTransaction();
 
@@ -27,6 +30,8 @@ class RemoteStartTransaction : public OcppMessage {
     void processReq(JsonObject payload);
 
     std::unique_ptr<DynamicJsonDocument> createConf();
+
+    const char *getErrorCode() {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
index da4c18d0..5006130a 100644
--- a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
+++ b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
@@ -34,7 +34,7 @@ void SetChargingProfile::processReq(JsonObject payload) {
 
     if (ocppModel && ocppModel->getSmartChargingService()) {
         auto smartChargingService = ocppModel->getSmartChargingService();
-        smartChargingService->updateChargingProfile(&csChargingProfiles);
+        smartChargingService->setChargingProfile(csChargingProfiles);
     }
 }
 
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
index fd34dd7c..1ddf7c94 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
@@ -46,7 +46,7 @@ int ChargingSchedulePeriod::getNumberPhases(){
 }
 
 void ChargingSchedulePeriod::printPeriod(){
-    AO_DBG_INFO("CHARGING SCHEDULE PERIOD:\n" \
+    AO_DBG_VERBOSE("CHARGING SCHEDULE PERIOD:\n" \
                 "      startPeriod: %i\n" \
                 "      limit: %f\n" \
                 "      numberPhases: %i\n",
@@ -267,7 +267,7 @@ void ChargingSchedule::printSchedule(){
     char tmp[JSONDATE_LENGTH + 1] = {'\0'};
     startSchedule.toJsonString(tmp, JSONDATE_LENGTH + 1);
 
-    AO_DBG_INFO("CHARGING SCHEDULE:\n" \
+    AO_DBG_VERBOSE("CHARGING SCHEDULE:\n" \
                 "    duration: %i\n" \
                 "    startSchedule: %s\n" \
                 "    chargingRateUnit: %s\n" \
@@ -351,15 +351,28 @@ bool ChargingProfile::inferenceLimit(const OcppTimestamp &t, float *limit, OcppT
     return inferenceLimit(t, MAX_TIME, limit, nextChange);
 }
 
-bool ChargingProfile::checkTransactionId(int chargingSessionTransactionID) {
-    if (transactionId >= 0 && chargingSessionTransactionID >= 0){
-        //Transaction IDs are valid
-        if (chargingProfilePurpose == ChargingProfilePurposeType::TxProfile //only then a transactionId can restrict the limits
-            && transactionId != chargingSessionTransactionID) {
-        return false;
-        }
+bool ChargingProfile::checkTransactionAssignment(int txId, int profileId) {
+    if (chargingProfilePurpose != ChargingProfilePurposeType::TxProfile) {
+        AO_DBG_ERR("assignment only exists for TxProfiles");
+        return true; //does not apply to this profile -> no restriction
     }
-    return true;
+
+    if (txId <= 0 && profileId < 0) {
+        //no search parameters set
+        return true;
+    }
+
+    if (chargingProfileId >= 0 && profileId >= 0) { //profileIDs are valid
+        return chargingProfileId == profileId; //return if they match (case of remote charging profiles)
+    }
+
+    if (transactionId > 0 && txId > 0) { //txIDs are valid
+        return transactionId == txId; //return if they do match
+    }
+    
+    AO_DBG_ERR("Check error");
+    //neither txIds nor profileIDs apply
+    return false;
 }
 
 int ChargingProfile::getStackLevel(){
@@ -381,7 +394,7 @@ void ChargingProfile::printProfile(){
     char tmp2[JSONDATE_LENGTH + 1] = {'\0'};
     validTo.toJsonString(tmp2, JSONDATE_LENGTH + 1);
 
-    AO_DBG_INFO("CHARGING PROFILE:\n" \
+    AO_DBG_VERBOSE("CHARGING PROFILE:\n" \
                 "  chargingProfileId: %i\n" \
                 "  transactionId: %i\n" \
                 "  stackLevel: %i\n" \
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
index 9a107e8c..2cb8b37d 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
@@ -119,9 +119,9 @@ class ChargingProfile {
     bool inferenceLimit(const OcppTimestamp &t, float *limit, OcppTimestamp *nextChange);
 
     /*
-    * Check if this profile belongs to transaction with ID transId
+    * Check if this profile belongs to transaction with ID txId or idTag alternatively
     */
-    bool checkTransactionId(int transId);
+    bool checkTransactionAssignment(int txId, int profileId);
 
     int getStackLevel();
     
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index 08e752ae..52e3cd04 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -37,7 +37,11 @@ SmartChargingService::SmartChargingService(OcppEngine& context, float chargeLimi
     limitBeforeChange = -1.0f;
     nextChange = MIN_TIME;
     chargingSessionStart = MAX_TIME;
+    char max_timestamp [JSONDATE_LENGTH + 1] = {'\0'};
+    chargingSessionStart.toJsonString(max_timestamp, JSONDATE_LENGTH + 1);
+    txStartTime = declareConfiguration<const char*>("AO_TXSTARTTIME_CONN_1", max_timestamp, CONFIGURATION_FN, false, false, true, false);
     chargingSessionTransactionID = -1;
+    sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, CONFIGURATION_FN, false, false, true, false);
     for (int i = 0; i < CHARGEPROFILEMAXSTACKLEVEL; i++) {
         ChargePointMaxProfile[i] = NULL;
         TxDefaultProfile[i] = NULL;
@@ -126,9 +130,11 @@ void SmartChargingService::inferenceLimit(const OcppTimestamp &t, float *limitOu
     //evaluate limit from TxProfiles
     float limit_tx = 0.0f;
     bool limit_defined_tx = false;
-    for (int i = CHARGEPROFILEMAXSTACKLEVEL - 1; i >= 0; i--){
-        if (TxProfile[i] == NULL) continue;
-        if (!TxProfile[i]->checkTransactionId(chargingSessionTransactionID)) continue;
+    for (int i = CHARGEPROFILEMAXSTACKLEVEL - 1; i >= 0; i--) {
+        if (!TxProfile[i])
+            continue;
+        if (!TxProfile[i]->checkTransactionAssignment(chargingSessionTransactionID, *sRmtProfileId))
+            continue;
         OcppTimestamp nextChange = MAX_TIME;
         limit_defined_tx = TxProfile[i]->inferenceLimit(t, chargingSessionStart, &limit_tx, &nextChange);
         if (nextChange < validToMin)
@@ -144,7 +150,6 @@ void SmartChargingService::inferenceLimit(const OcppTimestamp &t, float *limitOu
     bool limit_defined_txdef = false;
     for (int i = CHARGEPROFILEMAXSTACKLEVEL - 1; i >= 0; i--){
         if (TxDefaultProfile[i] == NULL) continue;
-        //if (!TxDefaultProfile[i]->checkTransactionId(chargingSessionTransactionID)) continue; //this doesn't do anything on TxDefaultProfiles and could be deleted
         OcppTimestamp nextChange = MAX_TIME;
         limit_defined_txdef = TxDefaultProfile[i]->inferenceLimit(t, chargingSessionStart, &limit_txdef, &nextChange);
         if (nextChange < validToMin)
@@ -160,7 +165,6 @@ void SmartChargingService::inferenceLimit(const OcppTimestamp &t, float *limitOu
     bool limit_defined_cpmax = false;
     for (int i = CHARGEPROFILEMAXSTACKLEVEL - 1; i >= 0; i--){
         if (ChargePointMaxProfile[i] == NULL) continue;
-        //if (!ChargePointMaxProfile[i]->checkTransactionId(chargingSessionTransactionID)) continue; //this doesn't do anything on ChargePointMaxProfiles and could be deleted
         OcppTimestamp nextChange = MAX_TIME;
         limit_defined_cpmax = ChargePointMaxProfile[i]->inferenceLimit(t, chargingSessionStart, &limit_cpmax, &nextChange);
         if (nextChange < validToMin)
@@ -219,34 +223,80 @@ ChargingSchedule *SmartChargingService::getCompositeSchedule(int connectorId, ot
 }
 
 void SmartChargingService::refreshChargingSessionState() {
-    int currentTxId = -1;
-    if (context.getOcppModel().getConnectorStatus(SINGLE_CONNECTOR_ID)) {
-        auto connector = context.getOcppModel().getConnectorStatus(SINGLE_CONNECTOR_ID);
-        currentTxId = connector->getTransactionId();
+    if (!context.getOcppModel().getConnectorStatus(SINGLE_CONNECTOR_ID)) {
+        return; //charging session state does not apply
+    }
+
+    auto connector = context.getOcppModel().getConnectorStatus(SINGLE_CONNECTOR_ID);
+
+    if (!chargingSessionStateInitialized) {
+        chargingSessionStateInitialized = true;
+
+        chargingSessionStart.setTime(*txStartTime);
+        chargingSessionTransactionID = connector->getTransactionId();
+        sessionIdTagRev = connector->getSessionWriteCount();
+        sRmtProfileIdRev = sRmtProfileId->getValueRevision();
+
+        //fuzzy check if session engaged at reboot (during first loop run)
+        auto chargingSessionStartCheck = MAX_TIME;
+        chargingSessionStartCheck -= 1000000; 
+        if (chargingSessionStart >= chargingSessionStartCheck) {
+            //charging session start lies in future -> null-value -> no charging session before reboot
+            chargingSessionTransactionID = -1;
+        }
     }
 
-    if (currentTxId != chargingSessionTransactionID) {
+    if (connector->getTransactionId() != chargingSessionTransactionID) {
         //transition!
 
-        if (chargingSessionTransactionID != 0 && currentTxId >= 0) {
+        bool txStartUpdated = false;
+        if (chargingSessionTransactionID != 0 && connector->getTransactionId() >= 0) {
             chargingSessionStart = context.getOcppModel().getOcppTime().getOcppTimestampNow();
-        } else if (chargingSessionTransactionID >= 0 && currentTxId < 0) {
+            txStartUpdated = true;
+        } else if (chargingSessionTransactionID >= 0 && connector->getTransactionId() < 0) {
             chargingSessionStart = MAX_TIME;
+            txStartUpdated = true;
+        }
+
+        if (txStartUpdated) {
+            char timestamp [JSONDATE_LENGTH + 1] = {'\0'};
+            chargingSessionStart.toJsonString(timestamp, JSONDATE_LENGTH + 1);
+            *txStartTime = timestamp;
+            configuration_save();
         }
 
         nextChange = context.getOcppModel().getOcppTime().getOcppTimestampNow();
-        chargingSessionTransactionID = currentTxId;
     }
+  
+    if (*sRmtProfileId >= 0 && //Remote profile set? Check if to delete
+            (!connector->getSessionIdTag()    //Always delete Rmt profile if there is no session
+            || (sessionIdTagRev != connector->getSessionWriteCount() && sRmtProfileIdRev == sRmtProfileId->getValueRevision()))) {
+                                               //Alternaternively delete if session state has been overwritten
+        
+        //after RemoteTx session expired, clean charging profile
+        int clearProfileId = *sRmtProfileId;
+        bool ret = clearChargingProfile([clearProfileId] (int id, int, ChargingProfilePurposeType, int) {
+            return id == clearProfileId;
+        });
+
+        AO_DBG_DEBUG("Clearing RmtTx Charging Profile after session expiry: %s", ret ? "success" : "already cleared");
+
+        *sRmtProfileId = -1;
+    }
+
+    chargingSessionTransactionID = connector->getTransactionId();
+    sessionIdTagRev = connector->getSessionWriteCount();
+    sRmtProfileIdRev = sRmtProfileId->getValueRevision();
 }
 
-void SmartChargingService::updateChargingProfile(JsonObject *json) {
+void SmartChargingService::setChargingProfile(JsonObject json) {
     ChargingProfile *pointer = updateProfileStack(json);
     if (pointer)
         writeProfileToFlash(json, pointer);
 }
 
-ChargingProfile *SmartChargingService::updateProfileStack(JsonObject *json){
-    ChargingProfile *chargingProfile = new ChargingProfile(*json);
+ChargingProfile *SmartChargingService::updateProfileStack(JsonObject json){
+    ChargingProfile *chargingProfile = new ChargingProfile(json);
 
     if (AO_DBG_LEVEL >= AO_DL_INFO) {
         AO_DBG_INFO("Charging Profile internal model:");
@@ -344,7 +394,7 @@ bool SmartChargingService::clearChargingProfile(const std::function<bool(int, in
     return nMatches > 0;
 }
 
-bool SmartChargingService::writeProfileToFlash(JsonObject *json, ChargingProfile *chargingProfile) {
+bool SmartChargingService::writeProfileToFlash(JsonObject json, ChargingProfile *chargingProfile) {
 #ifndef AO_DEACTIVATE_FLASH
 
     if (!filesystemOpt.accessAllowed()) {
@@ -378,7 +428,7 @@ bool SmartChargingService::writeProfileToFlash(JsonObject *json, ChargingProfile
     }
 
     // Serialize JSON to file
-    if (serializeJson(*json, file) == 0) {
+    if (serializeJson(json, file) == 0) {
         AO_DBG_ERR("Unable to save: could not serialize JSON for profile: %s", fn);
         file.close();
         return false;
@@ -496,7 +546,7 @@ bool SmartChargingService::loadProfiles() {
                 }
 
                 JsonObject profileJson = profileDoc.as<JsonObject>();
-                updateProfileStack(&profileJson);
+                updateProfileStack(profileJson);
 
                 profileDoc.clear();
                 break;
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
index 8dd10dc6..ef288ee6 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
@@ -13,7 +13,7 @@
 #include <functional>
 
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h>
-#include <ArduinoOcpp/Core/ConfigurationOptions.h>
+#include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
 
 namespace ArduinoOcpp {
@@ -34,18 +34,24 @@ class SmartChargingService {
     OnLimitChange onLimitChange = NULL;
     float limitBeforeChange;
     OcppTimestamp nextChange;
+
+    bool chargingSessionStateInitialized {false};
+    std::shared_ptr<Configuration<const char*>> txStartTime;
     OcppTimestamp chargingSessionStart;
     int chargingSessionTransactionID;
+    std::shared_ptr<Configuration<int>> sRmtProfileId;
+    uint16_t sRmtProfileIdRev {0};
+    uint16_t sessionIdTagRev {0};
     void refreshChargingSessionState();
 
-    ChargingProfile *updateProfileStack(JsonObject *json);
+    ChargingProfile *updateProfileStack(JsonObject json);
     FilesystemOpt filesystemOpt;
-    bool writeProfileToFlash(JsonObject *json, ChargingProfile *chargingProfile);
+    bool writeProfileToFlash(JsonObject json, ChargingProfile *chargingProfile);
     bool loadProfiles();
   
 public:
     SmartChargingService(OcppEngine& context, float chargeLimit, float V_eff, int numConnectors, FilesystemOpt filesystemOpt = FilesystemOpt::Use_Mount_FormatOnFail);
-    void updateChargingProfile(JsonObject *json);
+    void setChargingProfile(JsonObject json);
     bool clearChargingProfile(const std::function<bool(int, int, ChargingProfilePurposeType, int)>& filter);
     void inferenceLimit(const OcppTimestamp &t, float *limit, OcppTimestamp *validTo);
     float inferenceLimitNow();

From 9bb7a703b204607f2a11d23632f18c82e23537ef Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 26 Jun 2022 19:28:47 +0200
Subject: [PATCH 030/549] retain C facade

---
 CMakeLists.txt        |  66 ---------------
 README.md             |  66 ++++++++++++++-
 src/ArduinoOcpp_c.cpp | 181 ------------------------------------------
 src/ArduinoOcpp_c.h   | 107 -------------------------
 src/ao_opts.h         |  31 --------
 src/ao_opts_impl.c    |  30 -------
 6 files changed, 64 insertions(+), 417 deletions(-)
 delete mode 100644 CMakeLists.txt
 delete mode 100644 src/ArduinoOcpp_c.cpp
 delete mode 100644 src/ArduinoOcpp_c.h
 delete mode 100644 src/ao_opts.h
 delete mode 100644 src/ao_opts_impl.c

diff --git a/CMakeLists.txt b/CMakeLists.txt
deleted file mode 100644
index 862c2398..00000000
--- a/CMakeLists.txt
+++ /dev/null
@@ -1,66 +0,0 @@
-set(AO_SRC
-    src/ArduinoOcpp/Core/Configuration.cpp
-    src/ArduinoOcpp/Core/ConfigurationContainer.cpp
-    src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
-    src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
-    src/ArduinoOcpp/Core/OcppConnection.cpp
-    src/ArduinoOcpp/Core/OcppEngine.cpp
-    src/ArduinoOcpp/Core/OcppMessage.cpp
-    src/ArduinoOcpp/Core/OcppModel.cpp
-    src/ArduinoOcpp/Core/OcppOperation.cpp
-    src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
-    src/ArduinoOcpp/Core/OcppServer.cpp
-    src/ArduinoOcpp/Core/OcppSocket.cpp
-    src/ArduinoOcpp/Core/OcppTime.cpp
-    src/ArduinoOcpp/MessagesV16/Authorize.cpp
-    src/ArduinoOcpp/MessagesV16/BootNotification.cpp
-    src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
-    src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
-    src/ArduinoOcpp/MessagesV16/ClearCache.cpp
-    src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
-    src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
-    src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
-    src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
-    src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
-    src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
-    src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
-    src/ArduinoOcpp/MessagesV16/MeterValues.cpp
-    src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
-    src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
-    src/ArduinoOcpp/MessagesV16/Reset.cpp
-    src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
-    src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
-    src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
-    src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
-    src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
-    src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
-    src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
-    src/ArduinoOcpp/Platform.cpp
-    src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
-    src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
-    src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
-    src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
-    src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
-    src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
-    src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
-    src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
-    src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
-    src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
-    src/ArduinoOcpp.cpp
-    src/ArduinoOcpp_c.cpp
-    src/ao_opts_impl.c
-    src/ArduinoOcpp/Core/FilesystemAdapter.cpp
-)
-
-idf_component_register(SRCS ${AO_SRC}
-                    INCLUDE_DIRS "./src" "${PROJECT_DIR}/include"
-                    PRIV_REQUIRES spiffs)
-
-target_compile_options(${COMPONENT_TARGET} PUBLIC
-    -DAO_CUSTOM_WS
-    -DAO_CUSTOM_CONSOLE
-    -DAO_CUSTOM_UPDATER
-    -DAO_DEACTIVATE_FLASH
-    -DAO_USE_FILEAPI=ESPIDF_SPIFFS
-    -DAO_DBG_LEVEL=AO_DL_DEBUG
-    -DAO_TRAFFIC_OUT)
diff --git a/README.md b/README.md
index facb1c3c..44b2988e 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,7 @@
 # <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; ArduinoOcpp
+
+[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
+
 OCPP-J 1.6 client for the ESP8266 and the ESP32 (more coming soon)
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
@@ -32,11 +35,70 @@ For simple chargers, the necessary hardware and internet integration is usually
 
 ## Usage guide
 
-**This feature branch is WIP. A usage guide will follow.**
+Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. This guide explains the concepts for a minimal integration.
+
+- To get the library running, you have to install all dependencies (see the list below). In case you use PlatformIO, you can just add `matth-x/ArduinoOcpp` to your project using the PIO library manager.
+
+- In your project's `main` file, include `ArduinoOcpp.h`.
+
+- Before establishing an OCPP connection you have to ensure that your device has access to a Wi-Fi access point. All debug messages are printed on the standard serial (i.e. `Serial.print("debug msg")`). To redirect debug messages, please refer to `src/ArduinoOcpp/Platform.h`.
+
+- To connect to your OCPP Central System, call `OCPP_initialize(String OCPP_HOST, uint16_t OCPP_PORT, String OCPP_URL)`. You need to insert the address parameters according to the configuration of your central system. Internally, the library passes these parameters to the WebSocket object without further alteration.
+   - To secure the connection with TLS, you have to configure the WebSocket. Please take `examples/ESP-TLS/main.cpp` as an example.
+
+- In your `setup()` function, you can add the configuration functions from `ArduinoOcpp.h` to properly integrate your hardware. For example, the library needs access to the energy meter. All configuration functions are documented in `ArduinoOcpp.h`.
+
+- Add `OCPP_loop()` to your `loop()` function.
+
+**Sending OCPP operations**
+
+There are a couple of OCPP operations you can initialize on your EVSE. For example, to send a `Boot Notification`, use the function 
+```cpp
+void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf = nullptr, ...)`
+```
+
+In practice, it looks like this:
+
+```cpp
+void setup() {
+
+    ... //other code including the initialization of Wi-Fi and OCPP
+
+    bootNotification("My CP model name", "My company name", [] (JsonObject confMsg) {
+        //This callback is executed when the .conf() response from the central system arrives
+        Serial.print(F("BootNotification was answered. Central System clock: "));
+        Serial.println(confMsg["currentTime"].as<String>()); //"currentTime" is a field of the central system response
+        
+        //Notify your hardare that the BootNotification.conf() has arrived. E.g.:
+        //evseIsBooted = true;
+    });
+    
+    ... //rest of setup() function; executed immediately as bootNotification() is non-blocking
+}
+```
+
+The parameters `chargePointModel` and `chargePointVendor` are equivalent to the parameters in the `Boot Notification` as defined by the OCPP specification. The last parameter `OnReceiveConfListener onConf` is a callback function which the library executes when the central system has processed the operation and the ESP has received the `.conf()` response. Here you can add your device-specific behavior, e.g. flash a confirmation LED or unlock the connectors. If you don't need it, the last parameter is optional.
+
+**Receiving OCPP operations**
+
+The library also reacts on CS-initiated operations. You can add your own behavior there too. For example, to flash a LED on receipt of a `Set Charging Profile` request, use the following function.
+
+```cpp
+setOnSetChargingProfileRequest([] (JsonObject payload) {
+    //...
+});
+```
+
+You can also process the original payload from the CS using the `payload` object.
+
+*To get started quickly with or without EVSE hardware, you can flash the sketch in `examples/SECC` onto your ESP. That example mimics a full OCPP communications controller as it would look like in a real charging station. You can build a charger prototype based on that example or just view the internal state using the device monitor.*
 
 ## Dependencies
 
-- [bblanchon/ArduinoJson](https://github.com/bblanchon/ArduinoJson)
+- [bblanchon/ArduinoJSON](https://github.com/bblanchon/ArduinoJson) (please upgrade to version `6.19.1`)
+- [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (please upgrade to version `2.3.6`)
+
+In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
 
 ## Supported operations
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
deleted file mode 100644
index 855689c0..00000000
--- a/src/ArduinoOcpp_c.cpp
+++ /dev/null
@@ -1,181 +0,0 @@
-#include "ArduinoOcpp_c.h"
-#include "ArduinoOcpp.h"
-
-#include <ArduinoOcpp/Debug.h>
-
-ArduinoOcpp::OcppSocket *ocppSocket = nullptr;
-
-extern "C" void ao_initialize(AOcppSocket *osock) {
-    //OCPP_initialize("echo.websocket.events", 80, "ws://echo.websocket.events/");
-    if (!osock) {
-        AO_DBG_ERR("osock is null");
-    }
-    AO_DBG_ERR("no error");
-
-    ocppSocket = reinterpret_cast<ArduinoOcpp::OcppSocket*>(osock);
-
-    OCPP_initialize(*ocppSocket);
-}
-
-extern "C" void ao_loop() {
-    OCPP_loop();
-}
-
-extern "C" void ao_set_console_out_c(void (*console_out)(const char *msg)) {
-    ao_set_console_out(console_out);
-}
-
-#ifndef AO_RECEIVE_PAYLOAD_BUFSIZE
-#define AO_RECEIVE_PAYLOAD_BUFSIZE 1024
-#endif
-
-char ao_recv_payload_buff [AO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
-
-std::function<void(JsonObject)> adaptCb(OnOcppMessage cb) {
-    return [cb] (JsonObject payload) {
-        auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
-        if (len <= 0) {
-            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
-        }
-        cb(len > 0 ? ao_recv_payload_buff : nullptr, len);
-    };
-}
-
-std::function<void()> adaptCb(void (*cb)()) {
-    return cb;
-}
-
-ArduinoOcpp::OnReceiveErrorListener adaptCb(OnOcppError cb) {
-    return [cb] (const char *code, const char *description, JsonObject details) {
-        auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
-        if (len <= 0) {
-            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
-        }
-        cb(code, description, len > 0 ? ao_recv_payload_buff : "", len);
-    };
-}
-
-std::function<bool()> adaptCb(SamplerBool cb) {
-    return cb;
-}
-
-std::function<const char*()> adaptCb(SamplerString cb) {
-    return cb;
-}
-
-std::function<float()> adaptCb(SamplerFloat cb) {
-    return cb;
-}
-
-std::function<int()> adaptCb(SamplerInt cb) {
-    return cb;
-}
-
-void ao_setPowerActiveImportSampler(SamplerFloat power) {
-    setPowerActiveImportSampler(adaptCb(power));
-}
-
-void ao_setEnergyActiveImportSampler(SamplerInt energy) {
-    setEnergyActiveImportSampler([energy] () -> float {
-        return (float) energy();
-    });
-}
-
-void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy) {
-    setEvRequestsEnergySampler(adaptCb(evRequestsEnergy));
-}
-
-void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized) {
-    setConnectorEnergizedSampler(adaptCb(connectorEnergized));
-}
-
-void ao_setConnectorPluggedSampler(SamplerBool connectorPlugged) {
-    setConnectorPluggedSampler(adaptCb(connectorPlugged));
-}
-
-void ao_addConnectorErrorCodeSampler(SamplerString connectorErrorCode) {
-    addConnectorErrorCodeSampler(adaptCb(connectorErrorCode));
-}
-
-void ao_onChargingRateLimitChange(void (*chargingRateChanged)(float)) {
-    setOnChargingRateLimitChange(chargingRateChanged);
-}
-
-void ao_onUnlockConnector(SamplerBool unlockConnector) {
-    setOnUnlockConnector(adaptCb(unlockConnector));
-}
-
-void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf) {
-    setOnRemoteStopTransactionSendConf(adaptCb(onSendConf));
-}
-
-void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf) {
-    setOnRemoteStopTransactionSendConf(adaptCb(onSendConf));
-}
-
-void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest) {
-    setOnRemoteStopTransactionReceiveReq(adaptCb(onRequest));
-}
-
-void ao_onResetSendConf(OnOcppMessage onSendConf) {
-    setOnResetSendConf(adaptCb(onSendConf));
-}
-
-extern "C" void ao_onResetRequest(OnOcppMessage onRequest) {
-    setOnResetReceiveReq(adaptCb(onRequest));
-}
-
-extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    bootNotification("model", "vendor", adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
-}
-
-void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    DynamicJsonDocument *payload = new DynamicJsonDocument(JSON_OBJECT_SIZE(9) + 230 + 9); // BootNotification has at most 9 attributes with at most 230 chars + null terminators
-    auto err = deserializeJson(*payload, payloadJson);
-    if (err) {
-        AO_DBG_ERR("Could not process input: %s", err.c_str());
-        (void)0;
-    }
-
-    bootNotification(payload, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
-}
-
-void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    authorize(idTag, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
-}
-
-void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    startTransaction(idTag, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
-}
-
-void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    stopTransaction(adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
-}
-
-int ao_getTransactionId() {
-    return getTransactionId();
-}
-
-bool ao_ocppPermitsCharge() {
-    return ocppPermitsCharge();
-}
-
-bool ao_isAvailable() {
-    return isAvailable();
-}
-
-void ao_beginSession(const char *idTag) {
-    return beginSession(idTag);
-}
-
-void ao_endSession() {
-    return endSession();
-}
-
-bool ao_isInSession() {
-    return isInSession();
-}
-
-const char *ao_getSessionIdTag() {
-    return getSessionIdTag();
-}
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
deleted file mode 100644
index 16e45b39..00000000
--- a/src/ArduinoOcpp_c.h
+++ /dev/null
@@ -1,107 +0,0 @@
-#ifndef ARDUINOOCPP_C_H
-#define ARDUINOOCPP_C_H
-
-#include <stddef.h>
-
-struct AOcppSocket;
-typedef struct AOcppSocket AOcppSocket;
-
-typedef void (*OnOcppMessage) (const char *payload, size_t len);
-typedef void (*OnOcppAbort)   ();
-typedef void (*OnOcppTimeout) ();
-typedef void (*OnOcppError)   (const char *code, const char *description, const char *details_json, size_t details_len);
-
-typedef float (*SamplerFloat)();
-typedef int   (*SamplerInt)();
-typedef bool  (*SamplerBool)();
-typedef const char* (*SamplerString)();
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-void ao_initialize(AOcppSocket *osock);
-
-void ao_deinitialize();
-
-void ao_loop();
-
-void ao_set_console_out_c(void (*console_out)(const char *msg));
-
-/*
- * Feed lib with HW related data
- */
-
-void ao_setPowerActiveImportSampler(SamplerFloat power);
-
-void ao_setEnergyActiveImportSampler(SamplerInt energy);
-
-void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy);
-
-void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized);
-
-void ao_setConnectorPluggedSampler(SamplerBool connectorPlugged);
-
-void ao_addConnectorErrorCodeSampler(SamplerString connectorErrorCode);
-
-/*
- * Execute HW related operations on EVSE
- */
-
-void ao_onChargingRateLimitChange(void (*chargingRateChanged)(float));
-
-void ao_onUnlockConnector(SamplerBool unlockConnector); //true: success, false: failure
-
-/*
- * Generic listeners for OCPP operations initiated by Central System
- */
-
-void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf); //important, energize the power plug here and capture the idTag
-
-void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf); //important, de-energize the power plug here
-void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest); //optional, to de-energize the power plug immediately
-
-void ao_onResetSendConf(OnOcppMessage onSendConf); //important, reset your device here (i.e. call ESP.reset();)
-void ao_onResetRequest(OnOcppMessage onRequest); //alternative: start reset timer here
-
-/*
- * Initiate OCPP operations
- */
-
-void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
-
-void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
-
-void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
-
-void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
-
-void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
-
-/*
- * Access OCPP state
- */
-
-int ao_getTransactionId(); //returns the ID of the current transaction. Returns -1 if called before or after an transaction
-
-bool ao_ocppPermitsCharge();
-
-bool ao_isAvailable(); //if the charge point is operative or inoperative
-
-/*
- * Charging session management
- */
-
-void ao_beginSession(const char *idTag);
-
-void ao_endSession();
-
-bool ao_isInSession();
-
-const char *ao_getSessionIdTag();
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif
diff --git a/src/ao_opts.h b/src/ao_opts.h
deleted file mode 100644
index 5a19cede..00000000
--- a/src/ao_opts.h
+++ /dev/null
@@ -1,31 +0,0 @@
-#ifndef AOOPTS_H
-#define AOOPTS_H
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-unsigned long ao_tick_ms_impl();
-//unsigned int32_t ao_avail_heap_impl();
-
-#ifdef __cplusplus
-}
-#endif
-
-#ifndef ao_tick_ms
-#define ao_tick_ms ao_tick_ms_impl
-#endif
-
-#ifndef ao_avail_heap
-#define ao_avail_heap() 20000
-#endif
-
-//#ifndef AO_CONSOLE_PRINTF
-//#define AO_CONSOLE_PRINTF(...) ESP_LOGI("[ocpp]", __VA_ARGS__)
-//#endif
-
-#ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
-#define AO_CUSTOM_CONSOLE_MAXMSGSIZE 192
-#endif
-
-#endif
diff --git a/src/ao_opts_impl.c b/src/ao_opts_impl.c
deleted file mode 100644
index ce1b6559..00000000
--- a/src/ao_opts_impl.c
+++ /dev/null
@@ -1,30 +0,0 @@
-#include "ao_opts.h"
-
-#include <stdio.h>
-#include <esp_wifi.h>
-#include <esp_system.h>
-#include <esp_event.h>
-
-#include <freertos/FreeRTOS.h>
-#include <freertos/task.h>
-#include <freertos/semphr.h>
-#include <freertos/event_groups.h>
-
-#include <esp_log.h>
-#include <esp_event.h>
-
-#include <freertos/task.h>
-#include <freertos/FreeRTOSConfig.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-unsigned long ao_tick_ms_impl() {
-    //return xTaskGetTickCount() / configTICK_RATE_HZ;
-    return (xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ;
-}
-
-#ifdef __cplusplus
-}
-#endif

From 8be2cdbf7a39a692dcc713eddcee2b650ea1662c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 26 Jun 2022 21:33:08 +0200
Subject: [PATCH 031/549] fix compilation errors

---
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp    | 24 ++++++++++++-------
 .../MessagesV16/StatusNotification.cpp        |  3 ++-
 2 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index d35789be..e8dad634 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -56,10 +56,18 @@ class ArduinoFileAdapter : public FileAdapter {
         }
     }
     
-    int read() override;
-    size_t read(char *buf, size_t len) override;
-    size_t write(const char *buf, size_t len) override;
-    size_t seek(size_t offset) override;
+    int read() override {
+        return file.read();
+    };
+    size_t read(char *buf, size_t len) override {
+        return file.readBytes(buf, len);
+    }
+    size_t write(const char *buf, size_t len) override {
+        return file.printf("%.*s", len, buf);
+    }
+    size_t seek(size_t offset) override {
+        return file.seek(offset);
+    }
 };
 
 class ArduinoFilesystemAdapter : public FilesystemAdapter {
@@ -110,8 +118,8 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
         }
 
         int status = -1;
-        if (f.isFile()) {
-            size = f.size();
+        if (!f.isDirectory()) {
+            *size = f.size();
             status = 0;
         } else {
             //fetch more information for directory when ArduinoOcpp also uses them
@@ -124,7 +132,7 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
 
     std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {
         File file = USE_FS.open(fn, mode);
-        if (file && file.isFile()) {
+        if (file && !file.isDirectory()) {
             return std::unique_ptr<FileAdapter>(new ArduinoFileAdapter(std::move(file)));
         } else {
             return nullptr;
@@ -146,7 +154,7 @@ std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
         new ArduinoFilesystemAdapter(config)
     );
 
-    if (*fs) {
+    if (fs) {
         return fs;
     } else {
         return nullptr;
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index c563a8dd..9c405a33 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -36,7 +36,8 @@ const char *cstrFromOcppEveState(OcppEvseState state) {
             return "Faulted";
         default:
             AO_DBG_ERR("OcppEvseState not specified");
-            __attribute__ ((fallthrough));
+            (void)0;
+            /* fall through */
         case (OcppEvseState::NOT_SET):
             return "NOT_SET";
     }

From bbab921fca8feb69b4733088bec72d3885ebcc30 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 26 Jun 2022 21:45:27 +0200
Subject: [PATCH 032/549] remove includes

---
 .../Core/ConfigurationContainerFlash.cpp          | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index 3aa078e8..0eea713d 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -7,21 +7,6 @@
 
 #include <algorithm>
 
-#if defined(ESP32)
-#define USE_FS LITTLEFS
-#else
-#define USE_FS SPIFFS
-#endif
-
-#ifndef AO_DEACTIVATE_FLASH
-#if USE_FS == LITTLEFS
-#include <LITTLEFS.h>
-#elif USE_FS == SPIFFS
-#include <FS.h>
-#define USE_FS SPIFFS
-#endif
-#endif
-
 #define MAX_FILE_SIZE 4000
 #define MAX_CONFIGURATIONS 50
 #define MAX_CONFJSON_CAPACITY 4000

From 07f6c0caeda1f73c6c5b51385d0138dc2fe11046 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 27 Jun 2022 00:10:49 +0200
Subject: [PATCH 033/549] fix filesystem access

---
 examples/SECC/main.cpp                                   | 7 ++++++-
 src/ArduinoOcpp.cpp                                      | 3 ++-
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp               | 9 +++++----
 src/ArduinoOcpp/Core/FilesystemAdapter.h                 | 2 +-
 .../Tasks/SmartCharging/SmartChargingService.cpp         | 4 ++--
 5 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/examples/SECC/main.cpp b/examples/SECC/main.cpp
index 446dc6fa..1ca19e35 100644
--- a/examples/SECC/main.cpp
+++ b/examples/SECC/main.cpp
@@ -151,8 +151,13 @@ void setup() {
     /*
      * You can use ArduinoOcpp's internal configurations store for credentials other than those which are
      * specified by OCPP. To use it before ArduinoOcpp is initialized, you need to call configuration_init()
+     * 
+     * This snippet also shows how to integrate a custom filesystem. Just subclass FilesystemAdapter and pass
+     * it to the library
      */
-    ArduinoOcpp::configuration_init(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
+    std::shared_ptr<ArduinoOcpp::FilesystemAdapter> filesystem = ArduinoOcpp::EspWiFi::makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
+    ArduinoOcpp::configuration_init(filesystem);
+    filesystem = nullptr;
 
     /*
      * WiFiManager opens a captive portal, lets the user enter the WiFi credentials and provides a settings
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 4a9b6bf1..781fc9c1 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -32,6 +32,7 @@ OcppSocket *ocppSocket {nullptr};
 #endif
 
 OcppEngine *ocppEngine {nullptr};
+std::shared_ptr<FilesystemAdapter> filesystem;
 FilesystemOpt fileSystemOpt {};
 float voltage_eff {230.f};
 
@@ -85,7 +86,7 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
     voltage_eff = V_eff;
     fileSystemOpt = fsOpt;
 
-    std::shared_ptr<FilesystemAdapter> filesystem = EspWiFi::makeDefaultFilesystemAdapter(fileSystemOpt);
+    filesystem = EspWiFi::makeDefaultFilesystemAdapter(fileSystemOpt);
     AO_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "error");
     
     configuration_init(filesystem); //call before each other library call
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index e8dad634..1d3d720e 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -83,6 +83,8 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
             if(!USE_FS.begin(config.formatOnFail())) {
                 AO_DBG_ERR("Error while mounting LITTLEFS");
                 valid = false;
+            } else {
+                AO_DBG_DEBUG("LittleFS mount success");
             }
 #elif AO_USE_FILEAPI == ARDUINO_SPIFFS
             //ESP8266
@@ -150,11 +152,10 @@ std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
             return nullptr;
     }
 
-    auto fs = std::unique_ptr<FilesystemAdapter>(
-        new ArduinoFilesystemAdapter(config)
-    );
+    auto fs_concrete = new ArduinoFilesystemAdapter(config);
+    auto fs = std::unique_ptr<FilesystemAdapter>(fs_concrete);
 
-    if (fs) {
+    if (*fs_concrete) {
         return fs;
     } else {
         return nullptr;
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index e32f7779..93c6af27 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -6,7 +6,7 @@
 #define AO_FILESYSTEMADAPTER_H
 
 #ifndef AO_FILENAME_PREFIX
-#define AO_FILENAME_PREFIX "/ao_store"
+#define AO_FILENAME_PREFIX ""
 #endif
 
 #define ARDUINO_LITTLEFS 1
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index 79c564d4..b2dbbe84 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -300,8 +300,8 @@ void SmartChargingService::setChargingProfile(JsonObject json) {
 ChargingProfile *SmartChargingService::updateProfileStack(JsonObject json){
     ChargingProfile *chargingProfile = new ChargingProfile(json);
 
-    if (AO_DBG_LEVEL >= AO_DL_INFO) {
-        AO_DBG_INFO("Charging Profile internal model:");
+    if (AO_DBG_LEVEL >= AO_DL_VERBOSE) {
+        AO_DBG_VERBOSE("Charging Profile internal model:");
         chargingProfile->printProfile();
     }
 

From 0e5dab47de87b08ff4ff7fe356bbe8f5dc489e4d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 27 Jun 2022 11:35:31 +0200
Subject: [PATCH 034/549] restore files

---
 .github/workflows/pio.yaml |  47 ----------
 CMakeLists.txt             |  67 ++++++++++++++
 README.md                  |  66 +-------------
 src/ArduinoOcpp/Platform.h |   2 +
 src/ArduinoOcpp_c.cpp      | 181 +++++++++++++++++++++++++++++++++++++
 src/ArduinoOcpp_c.h        | 107 ++++++++++++++++++++++
 src/ao_opts.h              |  31 +++++++
 src/ao_opts_impl.c         |  30 ++++++
 8 files changed, 420 insertions(+), 111 deletions(-)
 delete mode 100644 .github/workflows/pio.yaml
 create mode 100644 CMakeLists.txt
 create mode 100644 src/ArduinoOcpp_c.cpp
 create mode 100644 src/ArduinoOcpp_c.h
 create mode 100644 src/ao_opts.h
 create mode 100644 src/ao_opts_impl.c

diff --git a/.github/workflows/pio.yaml b/.github/workflows/pio.yaml
deleted file mode 100644
index ab6248b7..00000000
--- a/.github/workflows/pio.yaml
+++ /dev/null
@@ -1,47 +0,0 @@
-name: PlatformIO CI
-
-on:
-  push:
-    branches:
-      - develop
-
-jobs:
-  build:
-
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        example: [examples/ESP/main.cpp, examples/ESP-TLS/main.cpp, examples/SECC/main.cpp]
-        include:
-          - example: examples/SECC/main.cpp
-            dashboard-extra: --lib="/tmp/tzapu/WiFiManager"
-
-    steps:
-    - uses: actions/checkout@v2
-    - name: Cache pip
-      uses: actions/cache@v2
-      with:
-        path: ~/.cache/pip
-        key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
-        restore-keys: |
-          ${{ runner.os }}-pip-
-    - name: Cache PlatformIO
-      uses: actions/cache@v2
-      with:
-        path: ~/.platformio
-        key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }}
-    - name: Set up Python
-      uses: actions/setup-python@v2
-    - name: Install PlatformIO
-      run: |
-        python -m pip install --upgrade pip
-        pip install --upgrade platformio
-    - name: Install library dependencies
-      run: pio pkg install
-    - name: Extra dependencies for SECC example
-      if: ${{ matrix.dashboard-extra }}
-      run: git clone https://github.com/tzapu/WiFiManager.git /tmp/tzapu/WiFiManager
-    - name: Run PlatformIO
-      run: pio ci --lib="." --project-conf=platformio.ini ${{ matrix.dashboard-extra }}
-      env:
-        PLATFORMIO_CI_SRC: ${{ matrix.example }}
\ No newline at end of file
diff --git a/CMakeLists.txt b/CMakeLists.txt
new file mode 100644
index 00000000..56345c10
--- /dev/null
+++ b/CMakeLists.txt
@@ -0,0 +1,67 @@
+set(AO_SRC
+    src/ArduinoOcpp/Core/Configuration.cpp
+    src/ArduinoOcpp/Core/ConfigurationContainer.cpp
+    src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+    src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+    src/ArduinoOcpp/Core/OcppConnection.cpp
+    src/ArduinoOcpp/Core/OcppEngine.cpp
+    src/ArduinoOcpp/Core/OcppMessage.cpp
+    src/ArduinoOcpp/Core/OcppModel.cpp
+    src/ArduinoOcpp/Core/OcppOperation.cpp
+    src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
+    src/ArduinoOcpp/Core/OcppServer.cpp
+    src/ArduinoOcpp/Core/OcppSocket.cpp
+    src/ArduinoOcpp/Core/OcppTime.cpp
+    src/ArduinoOcpp/MessagesV16/Authorize.cpp
+    src/ArduinoOcpp/MessagesV16/BootNotification.cpp
+    src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
+    src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
+    src/ArduinoOcpp/MessagesV16/ClearCache.cpp
+    src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
+    src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
+    src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
+    src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
+    src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
+    src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
+    src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
+    src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+    src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+    src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
+    src/ArduinoOcpp/MessagesV16/Reset.cpp
+    src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
+    src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+    src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+    src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+    src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+    src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+    src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
+    src/ArduinoOcpp/Platform.cpp
+    src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+    src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+    src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+    src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
+    src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+    src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
+    src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+    src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+    src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
+    src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+    src/ArduinoOcpp.cpp
+    src/ArduinoOcpp_c.cpp
+    src/ao_opts_impl.c
+    src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+)
+
+idf_component_register(SRCS ${AO_SRC}
+                    INCLUDE_DIRS "./src" "${PROJECT_DIR}/include"
+                    PRIV_REQUIRES spiffs)
+
+target_compile_options(${COMPONENT_TARGET} PUBLIC
+    -DAO_CUSTOM_WS
+    -DAO_CUSTOM_CONSOLE
+    -DAO_CUSTOM_UPDATER
+    -DAO_DEACTIVATE_FLASH
+    -DAO_USE_FILEAPI=ESPIDF_SPIFFS
+    -DAO_DBG_LEVEL=AO_DL_DEBUG
+    -DAO_TRAFFIC_OUT
+    -DAO_FILENAME_PREFIX="/ao_store")
diff --git a/README.md b/README.md
index 44b2988e..facb1c3c 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,4 @@
 # <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; ArduinoOcpp
-
-[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
-
 OCPP-J 1.6 client for the ESP8266 and the ESP32 (more coming soon)
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
@@ -35,70 +32,11 @@ For simple chargers, the necessary hardware and internet integration is usually
 
 ## Usage guide
 
-Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. This guide explains the concepts for a minimal integration.
-
-- To get the library running, you have to install all dependencies (see the list below). In case you use PlatformIO, you can just add `matth-x/ArduinoOcpp` to your project using the PIO library manager.
-
-- In your project's `main` file, include `ArduinoOcpp.h`.
-
-- Before establishing an OCPP connection you have to ensure that your device has access to a Wi-Fi access point. All debug messages are printed on the standard serial (i.e. `Serial.print("debug msg")`). To redirect debug messages, please refer to `src/ArduinoOcpp/Platform.h`.
-
-- To connect to your OCPP Central System, call `OCPP_initialize(String OCPP_HOST, uint16_t OCPP_PORT, String OCPP_URL)`. You need to insert the address parameters according to the configuration of your central system. Internally, the library passes these parameters to the WebSocket object without further alteration.
-   - To secure the connection with TLS, you have to configure the WebSocket. Please take `examples/ESP-TLS/main.cpp` as an example.
-
-- In your `setup()` function, you can add the configuration functions from `ArduinoOcpp.h` to properly integrate your hardware. For example, the library needs access to the energy meter. All configuration functions are documented in `ArduinoOcpp.h`.
-
-- Add `OCPP_loop()` to your `loop()` function.
-
-**Sending OCPP operations**
-
-There are a couple of OCPP operations you can initialize on your EVSE. For example, to send a `Boot Notification`, use the function 
-```cpp
-void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf = nullptr, ...)`
-```
-
-In practice, it looks like this:
-
-```cpp
-void setup() {
-
-    ... //other code including the initialization of Wi-Fi and OCPP
-
-    bootNotification("My CP model name", "My company name", [] (JsonObject confMsg) {
-        //This callback is executed when the .conf() response from the central system arrives
-        Serial.print(F("BootNotification was answered. Central System clock: "));
-        Serial.println(confMsg["currentTime"].as<String>()); //"currentTime" is a field of the central system response
-        
-        //Notify your hardare that the BootNotification.conf() has arrived. E.g.:
-        //evseIsBooted = true;
-    });
-    
-    ... //rest of setup() function; executed immediately as bootNotification() is non-blocking
-}
-```
-
-The parameters `chargePointModel` and `chargePointVendor` are equivalent to the parameters in the `Boot Notification` as defined by the OCPP specification. The last parameter `OnReceiveConfListener onConf` is a callback function which the library executes when the central system has processed the operation and the ESP has received the `.conf()` response. Here you can add your device-specific behavior, e.g. flash a confirmation LED or unlock the connectors. If you don't need it, the last parameter is optional.
-
-**Receiving OCPP operations**
-
-The library also reacts on CS-initiated operations. You can add your own behavior there too. For example, to flash a LED on receipt of a `Set Charging Profile` request, use the following function.
-
-```cpp
-setOnSetChargingProfileRequest([] (JsonObject payload) {
-    //...
-});
-```
-
-You can also process the original payload from the CS using the `payload` object.
-
-*To get started quickly with or without EVSE hardware, you can flash the sketch in `examples/SECC` onto your ESP. That example mimics a full OCPP communications controller as it would look like in a real charging station. You can build a charger prototype based on that example or just view the internal state using the device monitor.*
+**This feature branch is WIP. A usage guide will follow.**
 
 ## Dependencies
 
-- [bblanchon/ArduinoJSON](https://github.com/bblanchon/ArduinoJson) (please upgrade to version `6.19.1`)
-- [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (please upgrade to version `2.3.6`)
-
-In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
+- [bblanchon/ArduinoJson](https://github.com/bblanchon/ArduinoJson)
 
 ## Supported operations
 
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 58cdd372..f6dfb757 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -5,6 +5,8 @@
 #ifndef AO_PLATFORM_H
 #define AO_PLATFORM_H
 
+#include <ao_opts.h>
+
 #ifdef AO_CUSTOM_CONSOLE
 
 #ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
new file mode 100644
index 00000000..855689c0
--- /dev/null
+++ b/src/ArduinoOcpp_c.cpp
@@ -0,0 +1,181 @@
+#include "ArduinoOcpp_c.h"
+#include "ArduinoOcpp.h"
+
+#include <ArduinoOcpp/Debug.h>
+
+ArduinoOcpp::OcppSocket *ocppSocket = nullptr;
+
+extern "C" void ao_initialize(AOcppSocket *osock) {
+    //OCPP_initialize("echo.websocket.events", 80, "ws://echo.websocket.events/");
+    if (!osock) {
+        AO_DBG_ERR("osock is null");
+    }
+    AO_DBG_ERR("no error");
+
+    ocppSocket = reinterpret_cast<ArduinoOcpp::OcppSocket*>(osock);
+
+    OCPP_initialize(*ocppSocket);
+}
+
+extern "C" void ao_loop() {
+    OCPP_loop();
+}
+
+extern "C" void ao_set_console_out_c(void (*console_out)(const char *msg)) {
+    ao_set_console_out(console_out);
+}
+
+#ifndef AO_RECEIVE_PAYLOAD_BUFSIZE
+#define AO_RECEIVE_PAYLOAD_BUFSIZE 1024
+#endif
+
+char ao_recv_payload_buff [AO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
+
+std::function<void(JsonObject)> adaptCb(OnOcppMessage cb) {
+    return [cb] (JsonObject payload) {
+        auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+        if (len <= 0) {
+            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+        }
+        cb(len > 0 ? ao_recv_payload_buff : nullptr, len);
+    };
+}
+
+std::function<void()> adaptCb(void (*cb)()) {
+    return cb;
+}
+
+ArduinoOcpp::OnReceiveErrorListener adaptCb(OnOcppError cb) {
+    return [cb] (const char *code, const char *description, JsonObject details) {
+        auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+        if (len <= 0) {
+            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+        }
+        cb(code, description, len > 0 ? ao_recv_payload_buff : "", len);
+    };
+}
+
+std::function<bool()> adaptCb(SamplerBool cb) {
+    return cb;
+}
+
+std::function<const char*()> adaptCb(SamplerString cb) {
+    return cb;
+}
+
+std::function<float()> adaptCb(SamplerFloat cb) {
+    return cb;
+}
+
+std::function<int()> adaptCb(SamplerInt cb) {
+    return cb;
+}
+
+void ao_setPowerActiveImportSampler(SamplerFloat power) {
+    setPowerActiveImportSampler(adaptCb(power));
+}
+
+void ao_setEnergyActiveImportSampler(SamplerInt energy) {
+    setEnergyActiveImportSampler([energy] () -> float {
+        return (float) energy();
+    });
+}
+
+void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy) {
+    setEvRequestsEnergySampler(adaptCb(evRequestsEnergy));
+}
+
+void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized) {
+    setConnectorEnergizedSampler(adaptCb(connectorEnergized));
+}
+
+void ao_setConnectorPluggedSampler(SamplerBool connectorPlugged) {
+    setConnectorPluggedSampler(adaptCb(connectorPlugged));
+}
+
+void ao_addConnectorErrorCodeSampler(SamplerString connectorErrorCode) {
+    addConnectorErrorCodeSampler(adaptCb(connectorErrorCode));
+}
+
+void ao_onChargingRateLimitChange(void (*chargingRateChanged)(float)) {
+    setOnChargingRateLimitChange(chargingRateChanged);
+}
+
+void ao_onUnlockConnector(SamplerBool unlockConnector) {
+    setOnUnlockConnector(adaptCb(unlockConnector));
+}
+
+void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf) {
+    setOnRemoteStopTransactionSendConf(adaptCb(onSendConf));
+}
+
+void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf) {
+    setOnRemoteStopTransactionSendConf(adaptCb(onSendConf));
+}
+
+void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest) {
+    setOnRemoteStopTransactionReceiveReq(adaptCb(onRequest));
+}
+
+void ao_onResetSendConf(OnOcppMessage onSendConf) {
+    setOnResetSendConf(adaptCb(onSendConf));
+}
+
+extern "C" void ao_onResetRequest(OnOcppMessage onRequest) {
+    setOnResetReceiveReq(adaptCb(onRequest));
+}
+
+extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    bootNotification("model", "vendor", adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+}
+
+void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    DynamicJsonDocument *payload = new DynamicJsonDocument(JSON_OBJECT_SIZE(9) + 230 + 9); // BootNotification has at most 9 attributes with at most 230 chars + null terminators
+    auto err = deserializeJson(*payload, payloadJson);
+    if (err) {
+        AO_DBG_ERR("Could not process input: %s", err.c_str());
+        (void)0;
+    }
+
+    bootNotification(payload, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+}
+
+void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    authorize(idTag, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+}
+
+void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    startTransaction(idTag, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+}
+
+void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    stopTransaction(adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+}
+
+int ao_getTransactionId() {
+    return getTransactionId();
+}
+
+bool ao_ocppPermitsCharge() {
+    return ocppPermitsCharge();
+}
+
+bool ao_isAvailable() {
+    return isAvailable();
+}
+
+void ao_beginSession(const char *idTag) {
+    return beginSession(idTag);
+}
+
+void ao_endSession() {
+    return endSession();
+}
+
+bool ao_isInSession() {
+    return isInSession();
+}
+
+const char *ao_getSessionIdTag() {
+    return getSessionIdTag();
+}
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
new file mode 100644
index 00000000..16e45b39
--- /dev/null
+++ b/src/ArduinoOcpp_c.h
@@ -0,0 +1,107 @@
+#ifndef ARDUINOOCPP_C_H
+#define ARDUINOOCPP_C_H
+
+#include <stddef.h>
+
+struct AOcppSocket;
+typedef struct AOcppSocket AOcppSocket;
+
+typedef void (*OnOcppMessage) (const char *payload, size_t len);
+typedef void (*OnOcppAbort)   ();
+typedef void (*OnOcppTimeout) ();
+typedef void (*OnOcppError)   (const char *code, const char *description, const char *details_json, size_t details_len);
+
+typedef float (*SamplerFloat)();
+typedef int   (*SamplerInt)();
+typedef bool  (*SamplerBool)();
+typedef const char* (*SamplerString)();
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+void ao_initialize(AOcppSocket *osock);
+
+void ao_deinitialize();
+
+void ao_loop();
+
+void ao_set_console_out_c(void (*console_out)(const char *msg));
+
+/*
+ * Feed lib with HW related data
+ */
+
+void ao_setPowerActiveImportSampler(SamplerFloat power);
+
+void ao_setEnergyActiveImportSampler(SamplerInt energy);
+
+void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy);
+
+void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized);
+
+void ao_setConnectorPluggedSampler(SamplerBool connectorPlugged);
+
+void ao_addConnectorErrorCodeSampler(SamplerString connectorErrorCode);
+
+/*
+ * Execute HW related operations on EVSE
+ */
+
+void ao_onChargingRateLimitChange(void (*chargingRateChanged)(float));
+
+void ao_onUnlockConnector(SamplerBool unlockConnector); //true: success, false: failure
+
+/*
+ * Generic listeners for OCPP operations initiated by Central System
+ */
+
+void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf); //important, energize the power plug here and capture the idTag
+
+void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf); //important, de-energize the power plug here
+void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest); //optional, to de-energize the power plug immediately
+
+void ao_onResetSendConf(OnOcppMessage onSendConf); //important, reset your device here (i.e. call ESP.reset();)
+void ao_onResetRequest(OnOcppMessage onRequest); //alternative: start reset timer here
+
+/*
+ * Initiate OCPP operations
+ */
+
+void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+/*
+ * Access OCPP state
+ */
+
+int ao_getTransactionId(); //returns the ID of the current transaction. Returns -1 if called before or after an transaction
+
+bool ao_ocppPermitsCharge();
+
+bool ao_isAvailable(); //if the charge point is operative or inoperative
+
+/*
+ * Charging session management
+ */
+
+void ao_beginSession(const char *idTag);
+
+void ao_endSession();
+
+bool ao_isInSession();
+
+const char *ao_getSessionIdTag();
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
diff --git a/src/ao_opts.h b/src/ao_opts.h
new file mode 100644
index 00000000..5a19cede
--- /dev/null
+++ b/src/ao_opts.h
@@ -0,0 +1,31 @@
+#ifndef AOOPTS_H
+#define AOOPTS_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+unsigned long ao_tick_ms_impl();
+//unsigned int32_t ao_avail_heap_impl();
+
+#ifdef __cplusplus
+}
+#endif
+
+#ifndef ao_tick_ms
+#define ao_tick_ms ao_tick_ms_impl
+#endif
+
+#ifndef ao_avail_heap
+#define ao_avail_heap() 20000
+#endif
+
+//#ifndef AO_CONSOLE_PRINTF
+//#define AO_CONSOLE_PRINTF(...) ESP_LOGI("[ocpp]", __VA_ARGS__)
+//#endif
+
+#ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
+#define AO_CUSTOM_CONSOLE_MAXMSGSIZE 192
+#endif
+
+#endif
diff --git a/src/ao_opts_impl.c b/src/ao_opts_impl.c
new file mode 100644
index 00000000..ce1b6559
--- /dev/null
+++ b/src/ao_opts_impl.c
@@ -0,0 +1,30 @@
+#include "ao_opts.h"
+
+#include <stdio.h>
+#include <esp_wifi.h>
+#include <esp_system.h>
+#include <esp_event.h>
+
+#include <freertos/FreeRTOS.h>
+#include <freertos/task.h>
+#include <freertos/semphr.h>
+#include <freertos/event_groups.h>
+
+#include <esp_log.h>
+#include <esp_event.h>
+
+#include <freertos/task.h>
+#include <freertos/FreeRTOSConfig.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+unsigned long ao_tick_ms_impl() {
+    //return xTaskGetTickCount() / configTICK_RATE_HZ;
+    return (xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ;
+}
+
+#ifdef __cplusplus
+}
+#endif

From 6701e7a5fcda87ffb6c8b81b27e92c1e5974d211 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 27 Jun 2022 12:07:07 +0200
Subject: [PATCH 035/549] missing includes; fix compilation issues

---
 CMakeLists.txt                                                 | 3 +++
 src/ArduinoOcpp/MessagesV16/UnlockConnector.h                  | 1 +
 .../Tasks/Metering/ConnectorMeterValuesRecorder.cpp            | 2 +-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.h                    | 1 +
 src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp                | 1 +
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h                  | 1 +
 src/ArduinoOcpp_c.cpp                                          | 2 +-
 7 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 56345c10..cc4ae294 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -44,6 +44,8 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
     src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
     src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+    src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
+    src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
     src/ArduinoOcpp.cpp
@@ -60,6 +62,7 @@ target_compile_options(${COMPONENT_TARGET} PUBLIC
     -DAO_CUSTOM_WS
     -DAO_CUSTOM_CONSOLE
     -DAO_CUSTOM_UPDATER
+    -DAO_CUSTOM_RESET
     -DAO_DEACTIVATE_FLASH
     -DAO_USE_FILEAPI=ESPIDF_SPIFFS
     -DAO_DBG_LEVEL=AO_DL_DEBUG
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
index 2659fd2b..a8b37220 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
@@ -7,6 +7,7 @@
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/PollResult.h>
+#include <functional>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 56620cd5..5cc05a98 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -73,7 +73,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
             AO_DBG_DEBUG("Clock aligned measurement %ds: %s", dt,
                 abs(dt) <= 60 ?
-                "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore"); abs(-123);
+                "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
                 auto alignedMeterValues = alignedDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SampleClock);
                 if (alignedMeterValues) {
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
index 450f5d5b..541360d5 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
@@ -10,6 +10,7 @@
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoJson.h>
 #include <memory>
+#include <vector>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
index 4a570829..3ab56895 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
@@ -30,6 +30,7 @@ const char *cstrFromReadingContext(ReadingContext context) {
             return "Trigger";
         default:
             AO_DBG_ERR("ReadingContext not specified");
+            /* fall through */
         case (ReadingContext::NOT_SET):
             return nullptr;
     }
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
index 7debf013..f808bbe7 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -7,6 +7,7 @@
 
 #include <ArduinoJson.h>
 #include <memory>
+#include <functional>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 855689c0..bf5c6cc6 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -137,7 +137,7 @@ void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmat
         (void)0;
     }
 
-    bootNotification(payload, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+    bootNotification(std::unique_ptr<DynamicJsonDocument>(payload), adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
 }
 
 void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {

From 48ddb71a7857cf2dbcf50c8fafcdde3694ad1792 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 28 Jun 2022 11:08:38 +0200
Subject: [PATCH 036/549] Update documentation

---
 README.md | 34 ++++++++++++++--------------------
 1 file changed, 14 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index e485854a..793edd6a 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,7 @@
 # <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; ArduinoOcpp
+
+[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
+
 OCPP-J 1.6 client for the ESP8266 and the ESP32 (more coming soon)
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
@@ -34,18 +37,15 @@ For simple chargers, the necessary hardware and internet integration is usually
 
 Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. This guide explains the concepts for a minimal integration.
 
-- To get the library running, you have to install all dependencies (see the list below). In case you use PlatformIO, you can just add `matth-x/ArduinoOcpp` to your project using the PIO library manager.
+- To install the dependencies, see the list below for a manual installation or add `matth-x/ArduinoOcpp` to your project using the PIO library manager.
 
-- In your project's `main` file, include `ArduinoOcpp.h`.
+- In your project's `main` file, include `ArduinoOcpp.h` and the Wi-Fi library. Initialize Wi-Fi and the Serial output.
 
-- Before establishing an OCPP connection you have to ensure that your device has access to a Wi-Fi access point. All debug messages are printed on the standard serial (i.e. `Serial.print("debug msg")`). To redirect debug messages, please refer to `src/ArduinoOcpp/Platform.h`.
+- To connect to the OCPP Central System, call `OCPP_initialize(const char *host, uint16_t port, const char *url)`. For a secure connection with TLS, you need to configure the WebSocket in advance. Please take `examples/ESP-TLS/main.cpp` as an example.
 
-- To connect to your OCPP Central System, call `OCPP_initialize(String OCPP_HOST, uint16_t OCPP_PORT, String OCPP_URL)`. You need to insert the address parameters according to the configuration of your central system. Internally, the library passes these parameters to the WebSocket object without further alteration.
-   - To secure the connection with TLS, you have to configure the WebSocket. Please take `examples/ESP-TLS/main.cpp` as an example.
+- In `setup()`, configure ArduinoOcpp with the hardware drivers. You can leave that part out for the first connection test. Please refer to `ArduinoOcpp.h` for a documentation about the supported EVSE peripherals.
 
-- In your `setup()` function, you can add the configuration functions from `ArduinoOcpp.h` to properly integrate your hardware. For example, the library needs access to the energy meter. All configuration functions are documented in `ArduinoOcpp.h`.
-
-- Add `OCPP_loop()` to your `loop()` function.
+- In `loop()`, add `OCPP_loop()`.
 
 **Sending OCPP operations**
 
@@ -58,7 +58,6 @@ In practice, it looks like this:
 
 ```cpp
 void setup() {
-
     ... //other code including the initialization of Wi-Fi and OCPP
 
     bootNotification("My CP model name", "My company name", [] (JsonObject confMsg) {
@@ -66,8 +65,7 @@ void setup() {
         Serial.print(F("BootNotification was answered. Central System clock: "));
         Serial.println(confMsg["currentTime"].as<String>()); //"currentTime" is a field of the central system response
         
-        //Notify your hardare that the BootNotification.conf() has arrived. E.g.:
-        //evseIsBooted = true;
+        //evseIsBooted = true; <-- Example: Notify your hardare that the BootNotification.conf() has arrived
     });
     
     ... //rest of setup() function; executed immediately as bootNotification() is non-blocking
@@ -78,15 +76,15 @@ The parameters `chargePointModel` and `chargePointVendor` are equivalent to the
 
 **Receiving OCPP operations**
 
-The library also reacts on CS-initiated operations. You can add your own behavior there too. For example, to flash a LED on receipt of a `Set Charging Profile` request, use the following function.
+You can also add customized behavior to incoming OCPP messages. For example, to flash an LED on receipt of a `Set Charging Profile` request, use the following function.
 
 ```cpp
 setOnSetChargingProfileRequest([] (JsonObject payload) {
-    //...
+    //... will be executed every time this EVSE receives a new Charging Profile
 });
 ```
 
-You can also process the original payload from the CS using the `payload` object.
+Using the `payload` object you can access the original payload from the CS.
 
 *To get started quickly with or without EVSE hardware, you can flash the sketch in `examples/SECC` onto your ESP. That example mimics a full OCPP communications controller as it would look like in a real charging station. You can build a charger prototype based on that example or just view the internal state using the device monitor.*
 
@@ -132,13 +130,9 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 
 ## Next development steps
 
-- [x] introduce proper offline behavior and package loss / fault detection
-- [x] handle fragmented input messages correctly
-- [x] add support for multiple power connectors
-- [x] add support for the ESP32
-- [ ] reach full compliance to OCPP 1.6 Smart Charging Profile
+- [x] reach full compliance to OCPP 1.6 Smart Charging Profile
 - [ ] integrate Authorization Cache
-- [ ] **get ready for OCPP 2.0.1**
+- [ ] **get ready for OCPP 2.0.1 and ISO 15118**
 
 ## Further help
 

From 67a32ec8fdd1dbcb7bf30fc66af834e9bade809e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 28 Jun 2022 11:11:43 +0200
Subject: [PATCH 037/549] integrate GetCompositeSchedule

---
 README.md                                     | 80 +++++-----------
 .../MessagesV16/GetCompositeSchedule.cpp      | 95 +++++++++++++++++++
 .../MessagesV16/GetCompositeSchedule.h        | 36 +++++++
 .../MessagesV16/RemoteStartTransaction.cpp    |  1 +
 .../SimpleOcppOperationFactory.cpp            |  3 +
 .../Metering/ConnectorMeterValuesRecorder.cpp |  2 +-
 .../SmartCharging/SmartChargingModel.cpp      |  5 +-
 7 files changed, 164 insertions(+), 58 deletions(-)
 create mode 100644 src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
 create mode 100644 src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h

diff --git a/README.md b/README.md
index 44b2988e..fac6eacf 100644
--- a/README.md
+++ b/README.md
@@ -10,18 +10,18 @@ PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoO
 
 Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
-Full compatibility with the Arduino platform. Need a **FreeRTOS** version? Please [contact me](https://github.com/matth-x/ArduinoOcpp#further-help)
+Fully integrated into the Arduino platform. Compatible with ESP-IDF and generic FreeRTOS
 
 ## Make your EVSE ready for OCPP :car::electric_plug::battery:
 
 You can build an OCPP Charge Point controller using the popular, Wi-Fi enabled microcontrollers ESP8266, ESP32 and comparable. This library allows your EVSE to communicate with an OCPP Central System and to participate in your Charging Network.
 
-:heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve) and [The Mobility House OCPP package](https://github.com/mobilityhouse/ocpp)
-
-:heavy_check_mark: Passed compatibility tests with further commercial Central Systems
+:heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve), [The Mobility House OCPP package](https://github.com/mobilityhouse/ocpp) and further commercial Central Systems
 
 :heavy_check_mark: Integrated and tested in many charging stations
 
+:heavy_check_mark: Eligible for **public chargers**. Complies also with the legal requirements of the German Ladesäulenverordnung (LSV)
+
 ### Features
 
 - handles the OCPP communication with the charging network
@@ -37,18 +37,15 @@ For simple chargers, the necessary hardware and internet integration is usually
 
 Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. This guide explains the concepts for a minimal integration.
 
-- To get the library running, you have to install all dependencies (see the list below). In case you use PlatformIO, you can just add `matth-x/ArduinoOcpp` to your project using the PIO library manager.
+- To install the dependencies, see the list below for a manual installation or add `matth-x/ArduinoOcpp` to your project using the PIO library manager.
 
-- In your project's `main` file, include `ArduinoOcpp.h`.
+- In your project's `main` file, include `ArduinoOcpp.h` and the Wi-Fi library. Initialize Wi-Fi and the Serial output.
 
-- Before establishing an OCPP connection you have to ensure that your device has access to a Wi-Fi access point. All debug messages are printed on the standard serial (i.e. `Serial.print("debug msg")`). To redirect debug messages, please refer to `src/ArduinoOcpp/Platform.h`.
+- To connect to the OCPP Central System, call `OCPP_initialize(const char *host, uint16_t port, const char *url)`. For a secure connection with TLS, you need to configure the WebSocket in advance. Please take `examples/ESP-TLS/main.cpp` as an example.
 
-- To connect to your OCPP Central System, call `OCPP_initialize(String OCPP_HOST, uint16_t OCPP_PORT, String OCPP_URL)`. You need to insert the address parameters according to the configuration of your central system. Internally, the library passes these parameters to the WebSocket object without further alteration.
-   - To secure the connection with TLS, you have to configure the WebSocket. Please take `examples/ESP-TLS/main.cpp` as an example.
+- In `setup()`, configure ArduinoOcpp with the hardware drivers. You can leave that part out for the first connection test. Please refer to `ArduinoOcpp.h` for a documentation about the supported EVSE peripherals.
 
-- In your `setup()` function, you can add the configuration functions from `ArduinoOcpp.h` to properly integrate your hardware. For example, the library needs access to the energy meter. All configuration functions are documented in `ArduinoOcpp.h`.
-
-- Add `OCPP_loop()` to your `loop()` function.
+- In `loop()`, add `OCPP_loop()`.
 
 **Sending OCPP operations**
 
@@ -61,7 +58,6 @@ In practice, it looks like this:
 
 ```cpp
 void setup() {
-
     ... //other code including the initialization of Wi-Fi and OCPP
 
     bootNotification("My CP model name", "My company name", [] (JsonObject confMsg) {
@@ -69,8 +65,7 @@ void setup() {
         Serial.print(F("BootNotification was answered. Central System clock: "));
         Serial.println(confMsg["currentTime"].as<String>()); //"currentTime" is a field of the central system response
         
-        //Notify your hardare that the BootNotification.conf() has arrived. E.g.:
-        //evseIsBooted = true;
+        //evseIsBooted = true; <-- Example: Notify your hardare that the BootNotification.conf() has arrived
     });
     
     ... //rest of setup() function; executed immediately as bootNotification() is non-blocking
@@ -81,67 +76,44 @@ The parameters `chargePointModel` and `chargePointVendor` are equivalent to the
 
 **Receiving OCPP operations**
 
-The library also reacts on CS-initiated operations. You can add your own behavior there too. For example, to flash a LED on receipt of a `Set Charging Profile` request, use the following function.
+You can also add customized behavior to incoming OCPP messages. For example, to flash an LED on receipt of a `Set Charging Profile` request, use the following function.
 
 ```cpp
 setOnSetChargingProfileRequest([] (JsonObject payload) {
-    //...
+    //... will be executed every time this EVSE receives a new Charging Profile
 });
 ```
 
-You can also process the original payload from the CS using the `payload` object.
+Using the `payload` object you can access the original payload from the CS.
 
 *To get started quickly with or without EVSE hardware, you can flash the sketch in `examples/SECC` onto your ESP. That example mimics a full OCPP communications controller as it would look like in a real charging station. You can build a charger prototype based on that example or just view the internal state using the device monitor.*
 
 ## Dependencies
 
+Mandatory:
+
 - [bblanchon/ArduinoJSON](https://github.com/bblanchon/ArduinoJson) (please upgrade to version `6.19.1`)
+
+If compiled with the Arduino integration:
+
 - [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (please upgrade to version `2.3.6`)
 
 In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
 
 ## Supported operations
 
-| Operation name | supported | in progress | not supported |
-| -------------- | :---------: | :-----------: | :-------------: |
-| **Core profile** |
-| `Authorize` | :heavy_check_mark: |
-| `BootNotification` | :heavy_check_mark: |
-| `ChangeAvailability` | :heavy_check_mark: |
-| `ChangeConfiguration` | :heavy_check_mark: |
-| `ClearCache` | :heavy_check_mark: |
-| `DataTransfer` | :heavy_check_mark: |
-| `GetConfiguration` | :heavy_check_mark: |
-| `Heartbeat` | :heavy_check_mark: |
-| `MeterValues` | :heavy_check_mark: |
-| `RemoteStartTransaction` | :heavy_check_mark: |
-| `RemoteStopTransaction` | :heavy_check_mark: |
-| `Reset` | :heavy_check_mark: |
-| `StartTransaction` | :heavy_check_mark: |
-| `StatusNotification` | :heavy_check_mark: |
-| `StopTransaction` | :heavy_check_mark: |
-| `UnlockConnector` | :heavy_check_mark: |
-| **Smart charging profile** |
-| `ClearChargingProfile` | :heavy_check_mark: |
-| `GetCompositeSchedule` |   |   | :heavy_multiplication_x: |
-| `SetChargingProfile` | :heavy_check_mark: |
-| **Remote trigger profile** |
-| `TriggerMessage` | :heavy_check_mark: |
-| **Firmware management** |
-| `GetDiagnostics` | :heavy_check_mark: |
-| `DiagnosticsStatusNotification` | :heavy_check_mark: |
-| `FirmwareStatusNotification` | :heavy_check_mark: |
-| `UpdateFirmware` | :heavy_check_mark: |
+| Feature profile | supported | in progress |
+| -------------- | :---------: | :-----------: |
+| **Core** | :heavy_check_mark: |
+| **Smart charging** | :heavy_check_mark: |
+| **Remote trigger** | :heavy_check_mark: |
+| **Firmware management** | :heavy_check_mark: |
 
 ## Next development steps
 
-- [x] introduce proper offline behavior and package loss / fault detection
-- [x] handle fragmented input messages correctly
-- [x] add support for multiple power connectors
-- [x] add support for the ESP32
-- [ ] reach full compliance to OCPP 1.6 Smart Charging Profile
+- [x] reach full compliance to OCPP 1.6 Smart Charging Profile
 - [ ] integrate Authorization Cache
-- [ ] **get ready for OCPP 2.0.1**
+- [ ] **get ready for OCPP 2.0.1 and ISO 15118**
 
 ## Further help
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
new file mode 100644
index 00000000..96399201
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
@@ -0,0 +1,95 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Debug.h>
+
+#include <functional>
+
+using ArduinoOcpp::Ocpp16::GetCompositeSchedule;
+
+GetCompositeSchedule::GetCompositeSchedule() {
+
+}
+
+const char* GetCompositeSchedule::getOcppOperationType(){
+    return "GetCompositeSchedule";
+}
+
+void GetCompositeSchedule::processReq(JsonObject payload) {
+
+    connectorId = payload["connectorId"] | -1;
+    duration = payload["duration"] | 0;
+    auto unitString =  payload["chargingRateUnit"] | "W";
+
+    if (unitString[0] == 'A' || unitString[0] == 'a') {
+        chargingRateUnit = ChargingRateUnitType::Amp;
+    } else if (unitString[0] == 'W' || unitString[0] == 'w') {
+        chargingRateUnit = ChargingRateUnitType::Watt;
+    } else {
+        errorCode = "PropertyConstraintViolation";
+    }
+
+    if (ocppModel && ocppModel->getChargePointStatusService()) {
+        if (connectorId >= ocppModel->getChargePointStatusService()->getNumConnectors()) {
+            errorCode = "PropertyConstraintViolation";
+        }
+    }
+
+    if (connectorId < 0 || !payload.containsKey("duration")) {
+        errorCode = "FormatViolation";
+    }
+
+    if (!ocppModel || !ocppModel->getSmartChargingService()) {
+        AO_DBG_ERR("SmartChargingService not initialized! Ignore request");
+        errorCode = "NotSupported";
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
+    if (!ocppModel || !ocppModel->getSmartChargingService()) {
+        return nullptr;
+    }
+
+    auto scService = ocppModel->getSmartChargingService();
+    ChargingSchedule *composite = scService->getCompositeSchedule(connectorId, duration);
+    DynamicJsonDocument *compositeJson {nullptr};
+
+    if (composite) {
+        compositeJson = composite->toJsonDocument();
+    }
+
+    std::unique_ptr<DynamicJsonDocument> doc;
+
+    if (compositeJson) {
+        doc.reset(new DynamicJsonDocument(JSON_OBJECT_SIZE(4) + JSONDATE_LENGTH + 1 + compositeJson->capacity()));
+        JsonObject payload = doc->to<JsonObject>();
+        payload["status"] = "Accepted";
+        if (connectorId > 0)
+            payload["connectorId"] = connectorId;
+
+        char scheduleStart [JSONDATE_LENGTH + 1] {'\0'};
+        auto startSchedule = (*compositeJson)["startSchedule"] | "";
+        if (startSchedule[0] != '\0') {
+            strncpy(scheduleStart, startSchedule, JSONDATE_LENGTH + 1);
+        } else {
+            ocppModel->getOcppTime().getOcppTimestampNow().toJsonString(scheduleStart, JSONDATE_LENGTH + 1);
+        }
+        payload["scheduleStart"] = scheduleStart;
+        
+        payload["chargingSchedule"] = *compositeJson;
+    } else {
+        doc.reset(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+        JsonObject payload = doc->to<JsonObject>();
+        payload["status"] = "Rejected";
+    }
+
+    delete compositeJson;
+    delete composite;
+
+    return doc;
+}
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
new file mode 100644
index 00000000..00482796
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
@@ -0,0 +1,36 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef GETCOMPOSITESCHEDULE_H
+#define GETCOMPOSITESCHEDULE_H
+
+#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h>
+
+namespace ArduinoOcpp {
+namespace Ocpp16 {
+
+class GetCompositeSchedule : public OcppMessage {
+private:
+    int connectorId {-1};
+    otime_t duration {0};
+    ChargingRateUnitType chargingRateUnit {ChargingRateUnitType::Watt};
+
+    const char *errorCode {nullptr};
+public:
+    GetCompositeSchedule();
+
+    const char* getOcppOperationType();
+
+    void processReq(JsonObject payload);
+
+    std::unique_ptr<DynamicJsonDocument> createConf();
+
+    const char *getErrorCode() {return errorCode;}
+};
+
+} //end namespace Ocpp16
+} //end namespace ArduinoOcpp
+#endif
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
index 39835d7a..864035d0 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
@@ -92,6 +92,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
                 bool ret = scService->clearChargingProfile([clearProfileId](int id, int, ChargingProfilePurposeType, int) {
                     return id == clearProfileId;
                 });
+                (void)ret;
 
                 *sRmtProfileId = -1;
                 AO_DBG_DEBUG("Cleared Charging Profile from previous RemoteStartTx: %s", ret ? "success" : "already cleared");
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
index 590818e5..274ac806 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
@@ -6,6 +6,7 @@
 
 #include <ArduinoOcpp/MessagesV16/Authorize.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
+#include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
 #include <ArduinoOcpp/MessagesV16/Heartbeat.h>
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
 #include <ArduinoOcpp/MessagesV16/SetChargingProfile.h>
@@ -214,6 +215,8 @@ std::unique_ptr<OcppOperation> makeOcppOperation(const char *messageType, int co
     } else if (!strcmp(messageType, "BootNotification")) {
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::BootNotification());
         operation->setOnReceiveReqListener(onBootNotificationRequest);
+    } else if (!strcmp(messageType, "GetCompositeSchedule")) {
+        msg = std::unique_ptr<OcppMessage>(new Ocpp16::GetCompositeSchedule());
     } else if (!strcmp(messageType, "Heartbeat")) {
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::Heartbeat());
     } else if (!strcmp(messageType, "MeterValues")) {
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 56620cd5..5cc05a98 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -73,7 +73,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
             AO_DBG_DEBUG("Clock aligned measurement %ds: %s", dt,
                 abs(dt) <= 60 ?
-                "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore"); abs(-123);
+                "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
                 auto alignedMeterValues = alignedDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SampleClock);
                 if (alignedMeterValues) {
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
index 2fd2a28b..1a4b469e 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
@@ -371,9 +371,8 @@ bool ChargingProfile::checkTransactionAssignment(int txId, int profileId) {
         return transactionId == txId; //return if they do match
     }
     
-    AO_DBG_ERR("Check error");
-    //neither txIds nor profileIDs apply
-    return false;
+    AO_DBG_DEBUG("Neither txIds nor profileIDs apply");
+    return true;
 }
 
 int ChargingProfile::getStackLevel(){

From f1e289454c860129ef248f96e74be6968e2b791f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 28 Jun 2022 11:20:45 +0200
Subject: [PATCH 038/549] add interface for custom meters

---
 src/ArduinoOcpp_c.cpp | 19 +++++++++++++++++++
 src/ArduinoOcpp_c.h   |  2 ++
 2 files changed, 21 insertions(+)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index bf5c6cc6..03fbc26a 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -81,6 +81,25 @@ void ao_setEnergyActiveImportSampler(SamplerInt energy) {
     });
 }
 
+void ao_addMeterValueSampler_Int(SamplerInt sampler, const char *measurand, const char *phase, const char *unit) {
+    
+    ArduinoOcpp::SampledValueProperties properties;
+    if (measurand)
+        properties.setMeasurand(measurand);
+    if (phase)
+        properties.setPhase(phase);
+    if (unit)
+        properties.setUnit(unit);
+    
+    auto adaptSampler = [sampler] (ArduinoOcpp::ReadingContext) -> int32_t {
+        return sampler();
+    };
+
+    auto reader =   new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(properties, adaptSampler);
+    addMeterValueSampler(
+        std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(reader));
+}
+
 void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy) {
     setEvRequestsEnergySampler(adaptCb(evRequestsEnergy));
 }
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 16e45b39..9f4235e8 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -36,6 +36,8 @@ void ao_setPowerActiveImportSampler(SamplerFloat power);
 
 void ao_setEnergyActiveImportSampler(SamplerInt energy);
 
+void ao_addMeterValueSampler_Int(SamplerInt sampler, const char *measurand, const char *phase, const char *unit);
+
 void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy);
 
 void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized);

From 3e103b076fe8aff51f93c76adeada7ebea81323f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 4 Jul 2022 18:05:54 +0200
Subject: [PATCH 039/549] send txData in StopTransaction

---
 examples/SECC/main.cpp                        |  1 -
 .../MessagesV16/StartTransaction.cpp          |  2 +-
 .../MessagesV16/StopTransaction.cpp           | 28 ++++++++++++-
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |  6 ++-
 .../Metering/ConnectorMeterValuesRecorder.cpp | 39 +++++++++++++++++--
 .../Metering/ConnectorMeterValuesRecorder.h   |  5 ++-
 .../Tasks/Metering/MeteringService.cpp        | 14 ++++++-
 .../Tasks/Metering/MeteringService.h          |  4 +-
 8 files changed, 85 insertions(+), 14 deletions(-)

diff --git a/examples/SECC/main.cpp b/examples/SECC/main.cpp
index 1ca19e35..97d4cf25 100644
--- a/examples/SECC/main.cpp
+++ b/examples/SECC/main.cpp
@@ -157,7 +157,6 @@ void setup() {
      */
     std::shared_ptr<ArduinoOcpp::FilesystemAdapter> filesystem = ArduinoOcpp::EspWiFi::makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
     ArduinoOcpp::configuration_init(filesystem);
-    filesystem = nullptr;
 
     /*
      * WiFiManager opens a captive portal, lets the user enter the WiFi credentials and provides a settings
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index bee6d6cf..fa501eca 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -28,7 +28,7 @@ const char* StartTransaction::getOcppOperationType() {
 void StartTransaction::initiate() {
     if (ocppModel && ocppModel->getMeteringService()) {
         auto meteringService = ocppModel->getMeteringService();
-        meterStart = meteringService->readEnergyActiveImportRegister(connectorId);
+        meterStart = meteringService->readTxEnergyMeter(connectorId, ReadingContext::TransactionBegin);
     }
 
     if (ocppModel) {
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 6466a85c..7b214cd7 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -6,6 +6,7 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
+#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::StopTransaction;
@@ -24,7 +25,8 @@ void StopTransaction::initiate() {
 
     if (ocppModel && ocppModel->getMeteringService()) {
         auto meteringService = ocppModel->getMeteringService();
-        meterStop = meteringService->readEnergyActiveImportRegister(connectorId);
+        meterStop = meteringService->readTxEnergyMeter(connectorId, ReadingContext::TransactionEnd);
+        transactionData = meteringService->createStopTxMeterData(connectorId);
     }
 
     if (ocppModel) {
@@ -52,7 +54,27 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
         return nullptr;
     }
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(5) + (JSONDATE_LENGTH + 1) + (REASON_LEN_MAX + 1)));
+    std::vector<std::unique_ptr<DynamicJsonDocument>> txDataJson;
+    size_t txDataJson_size = 0;
+    for (auto mv = transactionData.begin(); mv != transactionData.end(); mv++) {
+        auto mvJson = (*mv)->toJson();
+        if (!mvJson) {
+            return nullptr;
+        }
+        txDataJson_size += mvJson->capacity();
+        txDataJson.emplace_back(std::move(mvJson));
+    }
+
+    DynamicJsonDocument txDataDoc = DynamicJsonDocument(JSON_ARRAY_SIZE(txDataJson.size()) + txDataJson_size);
+    for (auto mvJson = txDataJson.begin(); mvJson != txDataJson.end(); mvJson++) {
+        txDataDoc.add(**mvJson);
+    }
+
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                JSON_OBJECT_SIZE(6) + //total of 6 fields
+                (JSONDATE_LENGTH + 1) + //timestamp string
+                (REASON_LEN_MAX + 1) + //reason string
+                txDataDoc.capacity()));
     JsonObject payload = doc->to<JsonObject>();
 
     if (meterStop && *meterStop) {
@@ -74,6 +96,8 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
         payload["reason"] = reason;
     }
 
+    payload["transactionData"] = txDataDoc;
+
     return doc;
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index 08a91957..eaaacde8 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -8,9 +8,12 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
-#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 namespace ArduinoOcpp {
+
+class SampledValue;
+class MeterValue;
+
 namespace Ocpp16 {
 
 class StopTransaction : public OcppMessage {
@@ -19,6 +22,7 @@ class StopTransaction : public OcppMessage {
     std::unique_ptr<SampledValue> meterStop {nullptr};
     OcppTimestamp otimestamp;
     char reason [REASON_LEN_MAX] {'\0'};
+    std::vector<std::unique_ptr<MeterValue>> transactionData;
 public:
 
     StopTransaction(int connectorId, const char *reason = nullptr);
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 5cc05a98..8d68985c 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -120,6 +120,17 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
         auto connector = context.getConnectorStatus(connectorId);
         if (connector && connector->getTransactionId() != lastTransactionId) {
             //transaction break
+
+    	    //take a transaction-related sample which is aligned to the transaction break
+            if (connector->getTransactionId() >= 0 && lastTransactionId < 0) {
+                auto sampleStartTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionBegin);
+                if (sampleStartTx) {
+                    stopTxnSampledData.push_back(std::move(sampleStartTx));
+                }
+            } else if (connector->getTransactionId() >= 0 && lastTransactionId > 0) {
+                AO_DBG_ERR("Cannot switch txId");
+            }
+
             MeterValues *meterValues = nullptr;
             if (!sampledData.empty()) {
                 meterValues = new MeterValues(std::move(sampledData), connectorId, lastTransactionId);
@@ -189,11 +200,31 @@ void ConnectorMeterValuesRecorder::addMeterValueSampler(std::unique_ptr<SampledV
     samplers.push_back(std::move(meterValueSampler));
 }
 
-std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readEnergyActiveImportRegister() {
+std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readTxEnergyMeter(ReadingContext reason) {
     if (energySamplerIndex >= 0 && energySamplerIndex < samplers.size()) {
-        return samplers[energySamplerIndex]->takeValue(ReadingContext::NOT_SET);
+        return samplers[energySamplerIndex]->takeValue(reason);
     } else {
-        AO_DBG_DEBUG("Called readEnergyActiveImportRegister(), but no energySampler or handling strategy set");
-        return 0;
+        AO_DBG_DEBUG("Called readTxEnergyMeter(), but no energySampler or handling strategy set");
+        return nullptr;
+    }
+}
+
+std::vector<std::unique_ptr<MeterValue>> ConnectorMeterValuesRecorder::createStopTxMeterData() {
+    
+    //create final StopTxSample
+    if (*MeterValueSampleInterval >= 1) { //... only if sampled Meter Values are activated
+        auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionEnd);
+        if (sampleStopTx) {
+            stopTxnSampledData.push_back(std::move(sampleStopTx));
+        }
     }
+
+    //concatenate sampled and aligned meter data; clear all StopTX data in this object
+    auto res{std::move(stopTxnSampledData)};
+    res.insert(res.end(), std::make_move_iterator(stopTxnAlignedData.begin()),
+                          std::make_move_iterator(stopTxnAlignedData.end()));
+    stopTxnSampledData.clear(); //make vectors defined after moving from them
+    stopTxnAlignedData.clear();
+
+    return std::move(res);
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index a145438b..7377ffed 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -74,11 +74,12 @@ class ConnectorMeterValuesRecorder {
 
     void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler);
 
-    std::unique_ptr<SampledValue> readEnergyActiveImportRegister();
+    std::unique_ptr<SampledValue> readTxEnergyMeter(ReadingContext context);
 
     OcppMessage *takeTriggeredMeterValues();
 
-    OcppMessage *getStopTransactionData();
+    std::vector<std::unique_ptr<MeterValue>> createStopTxMeterData();
+
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index c5522f78..f7567cec 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -53,12 +53,12 @@ void MeteringService::addMeterValueSampler(int connectorId, std::unique_ptr<Samp
     connectors[connectorId]->addMeterValueSampler(std::move(meterValueSampler));
 }
 
-std::unique_ptr<SampledValue> MeteringService::readEnergyActiveImportRegister(int connectorId) {
+std::unique_ptr<SampledValue> MeteringService::readTxEnergyMeter(int connectorId, ReadingContext context) {
     if (connectorId < 0 || connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
-    return connectors[connectorId]->readEnergyActiveImportRegister();
+    return connectors[connectorId]->readTxEnergyMeter(context);
 }
 
 std::unique_ptr<OcppOperation> MeteringService::takeTriggeredMeterValues(int connectorId) {
@@ -80,3 +80,13 @@ std::unique_ptr<OcppOperation> MeteringService::takeTriggeredMeterValues(int con
     AO_DBG_ERR("Could not find connector");
     return nullptr;
 }
+
+std::vector<std::unique_ptr<MeterValue>> MeteringService::createStopTxMeterData(int connectorId) {
+    if (connectorId < 0 || connectorId >= connectors.size()) {
+        AO_DBG_ERR("connectorId is out of bounds");
+        return std::vector<std::unique_ptr<MeterValue>>();
+    }
+    auto& connector = connectors[connectorId];
+
+    return connector->createStopTxMeterData();
+}
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index 4b51defe..bad4ca29 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -36,10 +36,12 @@ class MeteringService {
 
     void addMeterValueSampler(int connectorId, std::unique_ptr<SampledValueSampler> meterValueSampler);
 
-    std::unique_ptr<SampledValue> readEnergyActiveImportRegister(int connectorId);
+    std::unique_ptr<SampledValue> readTxEnergyMeter(int connectorId, ReadingContext reason);
 
     std::unique_ptr<OcppOperation> takeTriggeredMeterValues(int connectorId); //snapshot of all meters now
 
+    std::vector<std::unique_ptr<MeterValue>> createStopTxMeterData(int connectorId);
+
     int getNumConnectors() {return connectors.size();}
 };
 

From 707ef4b2ee20fff29aa7f4184291f813a3da98a3 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 4 Jul 2022 18:36:49 +0200
Subject: [PATCH 040/549] fix data types

---
 .../Tasks/Metering/ConnectorMeterValuesRecorder.cpp       | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 8d68985c..2633828a 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -60,7 +60,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
     if (*ClockAlignedDataInterval >= 1) {
 
-         if (alignedData.size() >= *MeterValuesAlignedDataMaxLength) {
+         if (alignedData.size() >= (size_t) *MeterValuesAlignedDataMaxLength) {
             auto meterValues = new MeterValues(std::move(alignedData), connectorId, -1);
             alignedData.clear();
             return meterValues;
@@ -111,7 +111,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
     if (*MeterValueSampleInterval >= 1) {
         //record periodic tx data
 
-        if (sampledData.size() >= *MeterValuesSampledDataMaxLength) {
+        if (sampledData.size() >= (size_t) *MeterValuesSampledDataMaxLength) {
             auto meterValues = new MeterValues(std::move(sampledData), connectorId, lastTransactionId);
             sampledData.clear();
             return meterValues;
@@ -201,7 +201,7 @@ void ConnectorMeterValuesRecorder::addMeterValueSampler(std::unique_ptr<SampledV
 }
 
 std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readTxEnergyMeter(ReadingContext reason) {
-    if (energySamplerIndex >= 0 && energySamplerIndex < samplers.size()) {
+    if (energySamplerIndex >= 0 && (size_t) energySamplerIndex < samplers.size()) {
         return samplers[energySamplerIndex]->takeValue(reason);
     } else {
         AO_DBG_DEBUG("Called readTxEnergyMeter(), but no energySampler or handling strategy set");
@@ -220,7 +220,7 @@ std::vector<std::unique_ptr<MeterValue>> ConnectorMeterValuesRecorder::createSto
     }
 
     //concatenate sampled and aligned meter data; clear all StopTX data in this object
-    auto res{std::move(stopTxnSampledData)};
+    decltype(stopTxnSampledData) res {std::move(stopTxnSampledData)};
     res.insert(res.end(), std::make_move_iterator(stopTxnAlignedData.begin()),
                           std::make_move_iterator(stopTxnAlignedData.end()));
     stopTxnSampledData.clear(); //make vectors defined after moving from them

From bbbc1f74d66943aa3574ecfe950a087a3b47214d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 4 Jul 2022 19:37:57 +0200
Subject: [PATCH 041/549] update facade

---
 src/ArduinoOcpp.cpp | 33 +++++++++++++++++++++++++++++++++
 src/ArduinoOcpp.h   |  3 +--
 2 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 781fc9c1..a9495203 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -224,6 +224,39 @@ void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler
     model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(meterValueSampler)); //connectorId=1
 }
 
+void addMeterValueSampler(std::function<int32_t ()> value, const char *measurand, const char *unit, const char *location, const char *phase) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("Please call OCPP_initialize before");
+        return;
+    }
+
+    if (!value) {
+        AO_DBG_ERR("value undefined");
+        return;
+    }
+
+    if (!measurand) {
+        measurand = "Energy.Active.Import.Register";
+        AO_DBG_WARN("Measurand unspecified; assume %s", measurand);
+    }
+
+    SampledValueProperties properties;
+    properties.setMeasurand(measurand); //mandatory for AO
+
+    if (unit)
+        properties.setUnit(unit);
+    if (location)
+        properties.setLocation(location);
+    if (phase)
+        properties.setPhase(phase);
+
+    auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
+                                    new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
+                properties,
+                [value] (ArduinoOcpp::ReadingContext) -> int32_t {return value();}));
+    addMeterValueSampler(std::move(valueSampler));
+}
+
 void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
     if (!ocppEngine) {
         AO_DBG_ERR("Please call OCPP_initialize before");
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 40014f94..c02c19af 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -55,6 +55,7 @@ void setPowerActiveImportSampler(std::function<float()> power);
 void setEnergyActiveImportSampler(std::function<float()> energy);
 
 void addMeterValueSampler(std::unique_ptr<ArduinoOcpp::SampledValueSampler> meterValueSampler);
+void addMeterValueSampler(std::function<int32_t ()> value, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr);
 
 void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy);
 
@@ -62,8 +63,6 @@ void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized);
 
 void setConnectorPluggedSampler(std::function<bool()> connectorPlugged);
 
-//void setConnectorFaultedSampler(std::function<bool()> connectorFailed);
-
 void addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode);
 
 /*

From e8202a9d68ebe724c097128dc795dbe8f86f4a14 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 4 Jul 2022 23:03:20 +0200
Subject: [PATCH 042/549] omit txData in stopTx if empty

---
 src/ArduinoOcpp/MessagesV16/StopTransaction.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 7b214cd7..69a85f27 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -96,7 +96,9 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
         payload["reason"] = reason;
     }
 
-    payload["transactionData"] = txDataDoc;
+    if (!transactionData.empty()) {
+        payload["transactionData"] = txDataDoc;
+    }
 
     return doc;
 }

From 8741300eea920b884ebf2c71eb6fe12f3c98799b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 5 Jul 2022 16:35:35 +0200
Subject: [PATCH 043/549] remove obsolete txId tracking

---
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp               | 4 ++--
 src/ArduinoOcpp/MessagesV16/MeterValues.h                 | 3 +--
 .../Tasks/Metering/ConnectorMeterValuesRecorder.cpp       | 8 ++++----
 3 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index 87559f96..cb7b01cb 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -15,8 +15,8 @@ MeterValues::MeterValues() {
     
 }
 
-MeterValues::MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, int connectorId, int transactionId) 
-      : meterValue{std::move(meterValue)}, connectorId{connectorId}, transactionId{transactionId} {
+MeterValues::MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, int connectorId) 
+      : meterValue{std::move(meterValue)}, connectorId{connectorId} {
 
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.h b/src/ArduinoOcpp/MessagesV16/MeterValues.h
index 24f4be0e..898899ba 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.h
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.h
@@ -19,10 +19,9 @@ class MeterValues : public OcppMessage {
     std::vector<std::unique_ptr<MeterValue>> meterValue;
 
     int connectorId = 0;
-    int transactionId = -1;
 
 public:
-    MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, int connectorId, int transactionId);
+    MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, int connectorId);
 
     MeterValues(); //for debugging only. Make this for the server pendant
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 2633828a..a856e2ba 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -61,7 +61,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
     if (*ClockAlignedDataInterval >= 1) {
 
          if (alignedData.size() >= (size_t) *MeterValuesAlignedDataMaxLength) {
-            auto meterValues = new MeterValues(std::move(alignedData), connectorId, -1);
+            auto meterValues = new MeterValues(std::move(alignedData), connectorId);
             alignedData.clear();
             return meterValues;
         }
@@ -112,7 +112,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
         //record periodic tx data
 
         if (sampledData.size() >= (size_t) *MeterValuesSampledDataMaxLength) {
-            auto meterValues = new MeterValues(std::move(sampledData), connectorId, lastTransactionId);
+            auto meterValues = new MeterValues(std::move(sampledData), connectorId);
             sampledData.clear();
             return meterValues;
         }
@@ -133,7 +133,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
             MeterValues *meterValues = nullptr;
             if (!sampledData.empty()) {
-                meterValues = new MeterValues(std::move(sampledData), connectorId, lastTransactionId);
+                meterValues = new MeterValues(std::move(sampledData), connectorId);
                 sampledData.clear();
             }
             lastTransactionId = connector->getTransactionId();
@@ -182,7 +182,7 @@ OcppMessage *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
     decltype(sampledData) mv_now;
     mv_now.push_back(std::move(sample));
 
-    return new MeterValues(std::move(mv_now), connectorId, txId_now);
+    return new MeterValues(std::move(mv_now), connectorId);
 }
 
 void ConnectorMeterValuesRecorder::setPowerSampler(PowerSampler ps){

From de19d2a00446b25d53d82e6f96584308f726eaa9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 7 Jul 2022 11:01:32 +0200
Subject: [PATCH 044/549] fix missing debug message null check

---
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 8c809ff3..67f44dff 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -287,7 +287,7 @@ const char *ConnectorStatus::getErrorCode() {
 }
 
 void ConnectorStatus::beginSession(const char *sessionIdTag) {
-    AO_DBG_DEBUG("Begin session with idTag %s, overwriting idTag %s", sessionIdTag, idTag);
+    AO_DBG_DEBUG("Begin session with idTag %s, overwriting idTag %s", sessionIdTag != nullptr ? sessionIdTag : "", idTag);
     if (!sessionIdTag || *sessionIdTag == '\0') {
         //input string is empty
         snprintf(idTag, IDTAG_LEN_MAX + 1, "A0-00-00-00");

From cba8cf2172fcb618cad095b4a49f3f00024d2021 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 7 Jul 2022 11:30:02 +0200
Subject: [PATCH 045/549] update StartTx trigger

---
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 67f44dff..ac671131 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -61,7 +61,9 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
      *     - instruct the OCMF meter to begin a transaction (if OCMF meter handler is set)
      */
     txTriggerConditions.push_back([this] () -> TxCondition {
-        return getSessionIdTag() == nullptr ? TxCondition::Inactive : TxCondition::Active;
+        if (!session)
+            return TxCondition::Inactive;
+        return getSessionIdTag() ? TxCondition::Active : TxCondition::Inactive;
     });
     txEnableSequence.push_back([this] (TxCondition cond) -> TxEnableState {
         if (onOcmfMeterPollTx) {

From cf3f90530e9900a5f897f0085e5aa99fffe0110d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 14 Jul 2022 10:20:12 +0200
Subject: [PATCH 046/549] add energy meter timeout; small changes

---
 .../MessagesV16/GetCompositeSchedule.cpp      |  5 ++++-
 .../MessagesV16/GetDiagnostics.cpp            |  2 +-
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp   | 19 +++++++++++++++----
 src/ArduinoOcpp/MessagesV16/MeterValues.h     |  4 ++++
 .../MessagesV16/StartTransaction.cpp          | 11 ++++++++++-
 .../MessagesV16/StartTransaction.h            |  1 +
 .../MessagesV16/StopTransaction.cpp           | 11 ++++++++++-
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |  1 +
 .../ChargePointStatus/ConnectorStatus.cpp     |  5 ++---
 src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp |  5 ++---
 10 files changed, 50 insertions(+), 14 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
index 96399201..686dc864 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
@@ -52,7 +52,10 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
 
 std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
     if (!ocppModel || !ocppModel->getSmartChargingService()) {
-        return nullptr;
+        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+        JsonObject payload = doc->to<JsonObject>();
+        payload["status"] = "Rejected";
+        return doc;
     }
 
     auto scService = ocppModel->getSmartChargingService();
diff --git a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
index 18289acf..6dd5fd72 100644
--- a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
@@ -57,7 +57,7 @@ std::unique_ptr<DynamicJsonDocument> GetDiagnostics::createConf(){
         fileName = ocppModel->getDiagnosticsService()->requestDiagnosticsUpload(location, retries, retryInterval, startTime, stopTime);
     } else {
         AO_DBG_WARN("DiagnosticsService has not been initialized before! Please have a look at ArduinoOcpp.cpp for an example. Abort");
-        return nullptr;
+        return createEmptyDocument();
     }
 
     if (fileName.empty()) {
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index cb7b01cb..b9edaf99 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -10,6 +10,8 @@
 
 using ArduinoOcpp::Ocpp16::MeterValues;
 
+#define ENERGY_METER_TIMEOUT_MS 30 * 1000  //after waiting for 30s, send MeterValues without missing readings
+
 //can only be used for echo server debugging
 MeterValues::MeterValues() {
     
@@ -28,6 +30,10 @@ const char* MeterValues::getOcppOperationType(){
     return "MeterValues";
 }
 
+void MeterValues::initiate() {
+    emTimeout = ao_tick_ms();
+}
+
 std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
 
     size_t capacity = 0;
@@ -35,11 +41,16 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
     std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
     for (auto value = meterValue.begin(); value != meterValue.end(); value++) {
         auto entry = (*value)->toJson();
-        if (!entry) {
-            return nullptr;
+        if (entry) {
+            capacity += entry->capacity();
+            entries.push_back(std::move(entry));
+        } else {
+            if (ao_tick_ms() - emTimeout < ENERGY_METER_TIMEOUT_MS) {
+                return nullptr;
+            } else {
+                AO_DBG_ERR("Energy meter timeout!");
+            }
         }
-        capacity += entry->capacity();
-        entries.push_back(std::move(entry));
     }
 
     capacity += JSON_OBJECT_SIZE(3);
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.h b/src/ArduinoOcpp/MessagesV16/MeterValues.h
index 898899ba..3b477d15 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.h
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.h
@@ -20,6 +20,8 @@ class MeterValues : public OcppMessage {
 
     int connectorId = 0;
 
+    ulong emTimeout = 0;
+
 public:
     MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, int connectorId);
 
@@ -29,6 +31,8 @@ class MeterValues : public OcppMessage {
 
     const char* getOcppOperationType();
 
+    void initiate() override;
+
     std::unique_ptr<DynamicJsonDocument> createReq();
 
     void processConf(JsonObject payload);
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index fa501eca..a52229e7 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -10,6 +10,8 @@
 
 using ArduinoOcpp::Ocpp16::StartTransaction;
 
+#define ENERGY_METER_TIMEOUT_MS 30 * 1000  //after waiting for 30s, send StartTx without start reading
+
 StartTransaction::StartTransaction(int connectorId) : connectorId(connectorId) {
     
 }
@@ -63,6 +65,8 @@ void StartTransaction::initiate() {
         transactionRev = connector->getTransactionWriteCount();
     }
 
+    emTimeout = ao_tick_ms();
+
     AO_DBG_INFO("StartTransaction initiated");
 }
 
@@ -70,7 +74,9 @@ std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
 
     if (meterStart && !*meterStart) {
         //meterStart not ready yet
-        return nullptr;
+        if (ao_tick_ms() - emTimeout < ENERGY_METER_TIMEOUT_MS) {
+            return nullptr;
+        }
     }
 
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(5) + (JSONDATE_LENGTH + 1) + (IDTAG_LEN_MAX + 1)));
@@ -79,6 +85,9 @@ std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
     payload["connectorId"] = connectorId;
     if (meterStart && *meterStart) {
         payload["meterStart"] = meterStart->toInteger();
+    } else {
+        AO_DBG_ERR("Energy meter timeout");
+        payload["meterStart"] = -1;
     }
 
     if (otimestamp > MIN_TIME) {
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.h b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
index 153da753..c06b8715 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
@@ -20,6 +20,7 @@ class StartTransaction : public OcppMessage {
     OcppTimestamp otimestamp;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
     uint16_t transactionRev = 0;
+    ulong emTimeout = 0;
 public:
     StartTransaction(int connectorId);
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 69a85f27..d110e7e4 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -11,6 +11,8 @@
 
 using ArduinoOcpp::Ocpp16::StopTransaction;
 
+#define ENERGY_METER_TIMEOUT_MS 60 * 1000  //after waiting for 60s, send StopTx without start reading
+
 StopTransaction::StopTransaction(int connectorId, const char *reason) : connectorId(connectorId) {
     if (reason) {
         snprintf(this->reason, REASON_LEN_MAX, "%s", reason);
@@ -44,6 +46,8 @@ void StopTransaction::initiate() {
         }
     }
 
+    emTimeout = ao_tick_ms();
+
     AO_DBG_INFO("StopTransaction initiated!");
 }
 
@@ -51,7 +55,9 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
     if (meterStop && !*meterStop) {
         //meterStop not ready yet
-        return nullptr;
+        if (ao_tick_ms() - emTimeout < ENERGY_METER_TIMEOUT_MS) {
+            return nullptr;
+        }
     }
 
     std::vector<std::unique_ptr<DynamicJsonDocument>> txDataJson;
@@ -79,6 +85,9 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
     if (meterStop && *meterStop) {
         payload["meterStop"] = meterStop->toInteger();
+    } else {
+        AO_DBG_ERR("Energy meter timeout");
+        payload["meterStart"] = -1;
     }
 
     if (otimestamp > MIN_TIME) {
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index eaaacde8..5e7e2918 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -23,6 +23,7 @@ class StopTransaction : public OcppMessage {
     OcppTimestamp otimestamp;
     char reason [REASON_LEN_MAX] {'\0'};
     std::vector<std::unique_ptr<MeterValue>> transactionData;
+    ulong emTimeout = 0;
 public:
 
     StopTransaction(int connectorId, const char *reason = nullptr);
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index ac671131..50df0d9a 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -183,9 +183,8 @@ OcppMessage *ConnectorStatus::loop() {
     }
 
     if (txTrigger == TxCondition::Active) {
-        for (auto trigger = txTriggerConditions.begin(); trigger != txTriggerConditions.end(); trigger++) {
-            auto result = trigger->operator()();
-            if (result == TxCondition::Active) {
+        for (auto trigger : txTriggerConditions) {
+            if (trigger() == TxCondition::Active) {
                 txEnable = TxEnableState::Pending;
             } else {
                 txTrigger = TxCondition::Inactive;
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
index 27fe8904..658547fb 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
@@ -29,10 +29,9 @@ std::unique_ptr<DynamicJsonDocument> MeterValue::toJson() {
     auto jsonPayload = result->to<JsonObject>();
 
     char timestampStr [JSONDATE_LENGTH + 1] = {'\0'};
-    if (!timestamp.toJsonString(timestampStr, JSONDATE_LENGTH + 1)) {
-        return nullptr;
+    if (timestamp.toJsonString(timestampStr, JSONDATE_LENGTH + 1)) {
+        jsonPayload["timestamp"] = timestampStr;
     }
-    jsonPayload["timestamp"] = timestampStr;
     auto jsonMeterValue = jsonPayload.createNestedArray("sampledValue");
     for (auto entry = entries.begin(); entry != entries.end(); entry++) {
         jsonMeterValue.add(**entry);

From f647e2fa5ff18a68b8e651a4ba11bfd88c985c03 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 7 Jul 2022 11:30:02 +0200
Subject: [PATCH 047/549] update StartTx trigger

---
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 67f44dff..ac671131 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -61,7 +61,9 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
      *     - instruct the OCMF meter to begin a transaction (if OCMF meter handler is set)
      */
     txTriggerConditions.push_back([this] () -> TxCondition {
-        return getSessionIdTag() == nullptr ? TxCondition::Inactive : TxCondition::Active;
+        if (!session)
+            return TxCondition::Inactive;
+        return getSessionIdTag() ? TxCondition::Active : TxCondition::Inactive;
     });
     txEnableSequence.push_back([this] (TxCondition cond) -> TxEnableState {
         if (onOcmfMeterPollTx) {

From fbeed4fa0865022f22e11e29bd7533097c7ec770 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 29 Jul 2022 14:50:03 +0200
Subject: [PATCH 048/549] encapsulate JSON file read / write

---
 .../Core/ConfigurationContainerFlash.cpp      |   1 +
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp    |  12 +-
 src/ArduinoOcpp/Core/FilesystemAdapter.h      |  27 +---
 src/ArduinoOcpp/Core/FilesystemUtils.cpp      | 121 ++++++++++++++++++
 src/ArduinoOcpp/Core/FilesystemUtils.h        |  46 +++++++
 5 files changed, 181 insertions(+), 26 deletions(-)
 create mode 100644 src/ArduinoOcpp/Core/FilesystemUtils.cpp
 create mode 100644 src/ArduinoOcpp/Core/FilesystemUtils.h

diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index 0eea713d..46b4f2f2 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -3,6 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Core/ConfigurationContainerFlash.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Debug.h>
 
 #include <algorithm>
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 1d3d720e..c43c89c1 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -135,6 +135,7 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {
         File file = USE_FS.open(fn, mode);
         if (file && !file.isDirectory()) {
+            AO_DBG_DEBUG("File open successful: %s", fn);
             return std::unique_ptr<FileAdapter>(new ArduinoFileAdapter(std::move(file)));
         } else {
             return nullptr;
@@ -145,7 +146,13 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     };
 };
 
-std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
+std::weak_ptr<FilesystemAdapter> filesystemCache;
+
+std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
+
+    if (auto cached = filesystemCache.lock()) {
+        return cached;
+    }
 
     if (!config.accessAllowed()) {
             AO_DBG_DEBUG("Access to Arduino FS not allowed by config");
@@ -153,7 +160,8 @@ std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     auto fs_concrete = new ArduinoFilesystemAdapter(config);
-    auto fs = std::unique_ptr<FilesystemAdapter>(fs_concrete);
+    auto fs = std::shared_ptr<FilesystemAdapter>(fs_concrete);
+    filesystemCache = fs;
 
     if (*fs_concrete) {
         return fs;
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index 93c6af27..ec7e6e34 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -9,6 +9,8 @@
 #define AO_FILENAME_PREFIX ""
 #endif
 
+#define MAX_PATH_SIZE 30
+
 #define ARDUINO_LITTLEFS 1
 #define ARDUINO_SPIFFS   2
 #define ESPIDF_SPIFFS    3
@@ -28,29 +30,6 @@ class FileAdapter {
     virtual int read() = 0;
 };
 
-class ArduinoJsonFileAdapter {
-private:
-    FileAdapter *file;
-public:
-    ArduinoJsonFileAdapter(FileAdapter *file) : file(file) { }
-
-    size_t readBytes(char *buf, size_t len) {
-        return file->read(buf, len);
-    }
-
-    int read() {
-        return file->read();
-    }
-
-    size_t write(const uint8_t *buf, size_t len) {
-        return file->write((const char*) buf, len);
-    }
-
-    size_t write(uint8_t c) {
-        return file->write((const char*) &c, 1);
-    }
-};
-
 class FilesystemAdapter {
 public:
     virtual ~FilesystemAdapter() = default;
@@ -92,7 +71,7 @@ class FilesystemAdapter {
 namespace ArduinoOcpp {
 namespace EspWiFi {
 
-std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config);
+std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config);
 
 } //end namespace EspWiFi
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
new file mode 100644
index 00000000..390b6d6a
--- /dev/null
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -0,0 +1,121 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
+#include <ArduinoOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
+#include <ArduinoOcpp/Debug.h>
+
+#define MAX_JSON_CAPACITY 4096
+
+using namespace ArduinoOcpp;
+
+std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn) {
+    if (!filesystem || !fn || *fn == '\0') {
+        AO_DBG_ERR("Format error");
+        return nullptr;
+    }
+
+    if (strnlen(fn, MAX_PATH_SIZE) >= MAX_PATH_SIZE) {
+        AO_DBG_ERR("Fn too long: %.*s", MAX_PATH_SIZE, fn);
+        return nullptr;
+    }
+    
+    size_t fsize = 0;
+    if (filesystem->stat(fn, &fsize) != 0) {
+        AO_DBG_DEBUG("File does not exist: %s", fn);
+        return nullptr;
+    }
+
+    if (fsize < 2) {
+        AO_DBG_ERR("File too small for JSON, collect %s", fn);
+        filesystem->remove(fn);
+        return nullptr;
+    }
+
+    auto file = filesystem->open(fn, "r");
+    if (!file) {
+        AO_DBG_ERR("Could not open file %s", fn);
+        return nullptr;
+    }
+
+    size_t capacity = (3 * fsize) / 2;
+    if (capacity < 32) {
+        capacity = 32;
+    }
+    if (capacity > MAX_JSON_CAPACITY) {
+        capacity = MAX_JSON_CAPACITY;
+    }
+    
+    auto doc = std::unique_ptr<DynamicJsonDocument>(nullptr);
+    DeserializationError err = DeserializationError::NoMemory;
+    ArduinoJsonFileAdapter fileReader {file.get()};
+
+    while (err == DeserializationError::NoMemory && capacity <= MAX_JSON_CAPACITY) {
+
+        doc.reset(new DynamicJsonDocument(capacity));
+        err = deserializeJson(*doc, fileReader);
+
+        capacity *= 3;
+        capacity /= 2;
+
+        file->seek(0); //rewind file to beginning
+    }
+
+    if (err) {
+        AO_DBG_ERR("Error deserializing file %s: %s", fn, err.c_str());
+        //skip this file
+        return nullptr;
+    }
+
+    AO_DBG_DEBUG("Loaded JSON file: %s", fn);
+    serializeJson(*doc, Serial);
+    Serial.println();
+    return doc;
+}
+
+bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const DynamicJsonDocument& doc) {
+    if (!filesystem || !fn || *fn == '\0') {
+        AO_DBG_ERR("Format error");
+        return false;
+    }
+
+    if (strnlen(fn, MAX_PATH_SIZE) >= MAX_PATH_SIZE) {
+        AO_DBG_ERR("Fn too long: %.*s", MAX_PATH_SIZE, fn);
+        return false;
+    }
+
+    if (doc.isNull() || doc.overflowed()) {
+        AO_DBG_ERR("Invalid JSON %s", fn);
+        return false;
+    }
+
+    size_t file_size = 0;
+    if (filesystem->stat(fn, &file_size) == 0) {
+        filesystem->remove(fn);
+    }
+
+    auto file = filesystem->open(fn, "w");
+    if (!file) {
+        AO_DBG_ERR("Could not open file %s", fn);
+        return false;
+    }
+
+    ArduinoJsonFileAdapter fileWriter {file.get()};
+
+    size_t written = serializeJson(doc, fileWriter);
+    written = serializeJson(doc, Serial);
+
+    if (written < 2) {
+        AO_DBG_ERR("Error writing file %s", fn);
+        if (filesystem->stat(fn, &file_size) == 0) {
+            AO_DBG_DEBUG("Collect invalid file %s", fn);
+            filesystem->remove(fn);
+        }
+        return false;
+    }
+
+    AO_DBG_DEBUG("Wrote JSON file: %s", fn);
+    return true;
+}
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.h b/src/ArduinoOcpp/Core/FilesystemUtils.h
new file mode 100644
index 00000000..13af63cf
--- /dev/null
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.h
@@ -0,0 +1,46 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef AO_FILESYSTEMUTILS_H
+#define AO_FILESYSTEMUTILS_H
+
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <ArduinoJson.h>
+#include <memory>
+
+namespace ArduinoOcpp {
+
+class ArduinoJsonFileAdapter {
+private:
+    FileAdapter *file;
+public:
+    ArduinoJsonFileAdapter(FileAdapter *file) : file(file) { }
+
+    size_t readBytes(char *buf, size_t len) {
+        return file->read(buf, len);
+    }
+
+    int read() {
+        return file->read();
+    }
+
+    size_t write(const uint8_t *buf, size_t len) {
+        return file->write((const char*) buf, len);
+    }
+
+    size_t write(uint8_t c) {
+        return file->write((const char*) &c, 1);
+    }
+};
+
+namespace FilesystemUtils {
+
+std::unique_ptr<DynamicJsonDocument> loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn);
+bool storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const DynamicJsonDocument& doc);
+
+}
+
+}
+
+#endif

From a9b4f3d3384ed488d079db8ffbc3e7a97a37232a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 3 Aug 2022 17:12:46 +0200
Subject: [PATCH 049/549] internet connection loss simulation

---
 src/ArduinoOcpp/Core/OcppSocket.h | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/ArduinoOcpp/Core/OcppSocket.h b/src/ArduinoOcpp/Core/OcppSocket.h
index f1fb6db7..c9db90e1 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.h
+++ b/src/ArduinoOcpp/Core/OcppSocket.h
@@ -27,9 +27,14 @@ class OcppSocket {
 class OcppEchoSocket : public OcppSocket {
 private:
     ReceiveTXTcallback receiveTXT;
+
+    bool connected = true; //for simulating connection losses
 public:
     void loop() override { }
     bool sendTXT(std::string &out) override {
+        if (!connected) {
+            return true;
+        }
         if (receiveTXT) {
             return receiveTXT(out.c_str(), out.length());
         } else {
@@ -39,6 +44,9 @@ class OcppEchoSocket : public OcppSocket {
     void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) override {
         this->receiveTXT = receiveTXT;
     }
+
+    void setConnected(bool connected) {this->connected = connected;}
+    bool isConnected() {return connected;}
 };
 
 } //end namespace ArduinoOcpp

From 59c2912b9b0dcdab492eba5030acff6711de64ce Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 8 Aug 2022 10:56:11 +0200
Subject: [PATCH 050/549] MeterValue restore from flash

---
 src/ArduinoOcpp/MessagesV16/MeterValues.h     |  4 ++-
 .../Metering/ConnectorMeterValuesRecorder.cpp |  8 +----
 .../Metering/ConnectorMeterValuesRecorder.h   |  5 ---
 src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp | 32 ++++++++++++++++++
 src/ArduinoOcpp/Tasks/Metering/MeterValue.h   |  2 ++
 .../Tasks/Metering/SampledValue.cpp           | 33 +++++++++++++++++--
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h | 15 +++++++--
 7 files changed, 82 insertions(+), 17 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.h b/src/ArduinoOcpp/MessagesV16/MeterValues.h
index 898899ba..99e2d077 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.h
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.h
@@ -7,11 +7,13 @@
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
-#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 
 #include <vector>
 
 namespace ArduinoOcpp {
+
+class MeterValue;
+
 namespace Ocpp16 {
 
 class MeterValues : public OcppMessage {
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index a856e2ba..63ee89e1 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -60,7 +60,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
     if (*ClockAlignedDataInterval >= 1) {
 
-         if (alignedData.size() >= (size_t) *MeterValuesAlignedDataMaxLength) {
+        if (alignedData.size() >= (size_t) *MeterValuesAlignedDataMaxLength) {
             auto meterValues = new MeterValues(std::move(alignedData), connectorId);
             alignedData.clear();
             return meterValues;
@@ -173,12 +173,6 @@ OcppMessage *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
         return nullptr;
     }
 
-    int txId_now = -1;
-    auto connector = context.getConnectorStatus(connectorId);
-    if (connector) {
-        txId_now = connector->getTransactionId();
-    }
-
     decltype(sampledData) mv_now;
     mv_now.push_back(std::move(sample));
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index 7377ffed..d2d2d151 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -5,10 +5,6 @@
 #ifndef CONNECTOR_METER_VALUES_RECORDER
 #define CONNECTOR_METER_VALUES_RECORDER
 
-//#define METER_VALUE_SAMPLE_INTERVAL 60 //in seconds
-
-//#define METER_VALUES_SAMPLED_DATA_MAX_LENGTH 4 //after 4 measurements, send the values to the CS
-
 #include <functional>
 #include <memory>
 #include <vector>
@@ -22,7 +18,6 @@ using PowerSampler = std::function<float()>;
 using EnergySampler = std::function<float()>;
 
 class OcppModel;
-class OcppTimestamp;
 class OcppMessage;
 
 class ConnectorMeterValuesRecorder {
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
index 27fe8904..c8be2032 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
@@ -102,3 +102,35 @@ std::unique_ptr<MeterValue> MeterValueBuilder::takeSample(const OcppTimestamp& t
 
     return sample;
 }
+
+std::unique_ptr<MeterValue> MeterValueBuilder::deserializeSample(const JsonObject mvJson) {
+
+    OcppTimestamp timestamp;
+    bool ret = timestamp.setTime(mvJson["timestamp"] | "Invalid");
+    if (!ret) {
+        AO_DBG_ERR("invalid timestamp");
+        return nullptr;
+    }
+
+    auto sample = std::unique_ptr<MeterValue>(new MeterValue(timestamp));
+
+    JsonArray sampledValue = mvJson["sampledValue"];
+    for (JsonObject svJson : sampledValue) {  //for each sampled value, search sampler with matching measurand type
+        const char *measurand = svJson["measurand"] | "Invalid";
+        for (auto& sampler : samplers) {
+            if (!sampler->getMeasurand().compare(measurand)) {
+                //found correct sampler
+                auto dVal = sampler->deserializeValue(svJson);
+                if (dVal) {
+                    sample->addSampledValue(std::move(dVal));
+                } else {
+                    AO_DBG_ERR("deserialization error");
+                }
+                break;
+            }
+        }
+    }
+
+    AO_DBG_VERBOSE("deserialized MV");
+    return sample;
+}
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
index 450f5d5b..c89565d3 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
@@ -40,6 +40,8 @@ class MeterValueBuilder {
             std::shared_ptr<Configuration<const char*>> samplers_select);
     
     std::unique_ptr<MeterValue> takeSample(const OcppTimestamp& timestamp, const ReadingContext& context);
+
+    std::unique_ptr<MeterValue> deserializeSample(const JsonObject mvJson);
 };
 
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
index 4a570829..702de16e 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
@@ -10,7 +10,7 @@ using ArduinoOcpp::SampledValue;
 //helper function
 namespace ArduinoOcpp {
 namespace Ocpp16 {
-const char *cstrFromReadingContext(ReadingContext context) {
+const char *serializeReadingContext(ReadingContext context) {
     switch (context) {
         case (ReadingContext::InterruptionBegin):
             return "Interruption.Begin";
@@ -34,7 +34,36 @@ const char *cstrFromReadingContext(ReadingContext context) {
             return nullptr;
     }
 }
+ReadingContext deserializeReadingContext(const char *context) {
+    if (!context) {
+        AO_DBG_ERR("Invalid argument");
+        return ReadingContext::NOT_SET;
+    }
+
+    if (!strcmp(context, "NOT_SET")) {
+        AO_DBG_DEBUG("Deserialize Null-ReadingContext");
+        return ReadingContext::NOT_SET;
+    } else if (!strcmp(context, "Sample.Periodic")) {
+        return ReadingContext::SamplePeriodic;
+    } else if (!strcmp(context, "Sample.Clock")) {
+        return ReadingContext::SampleClock;
+    } else if (!strcmp(context, "Transaction.Begin")) {
+        return ReadingContext::TransactionBegin;
+    } else if (!strcmp(context, "Transaction.End")) {
+        return ReadingContext::TransactionEnd;
+    } else if (!strcmp(context, "Other")) {
+        return ReadingContext::Other;
+    } else if (!strcmp(context, "Interruption.Begin")) {
+        return ReadingContext::InterruptionBegin;
+    } else if (!strcmp(context, "Interruption.End")) {
+        return ReadingContext::InterruptionEnd;
+    } else if (!strcmp(context, "Trigger")) {
+        return ReadingContext::Trigger;
+    }
 
+    AO_DBG_ERR("ReadingContext not specified %.10s", context);
+    return ReadingContext::NOT_SET;
+}
 }} //end namespaces
 
 std::unique_ptr<DynamicJsonDocument> SampledValue::toJson() {
@@ -53,7 +82,7 @@ std::unique_ptr<DynamicJsonDocument> SampledValue::toJson() {
     auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
     auto payload = result->to<JsonObject>();
     payload["value"] = value;
-    auto context_cstr = Ocpp16::cstrFromReadingContext(context);
+    auto context_cstr = Ocpp16::serializeReadingContext(context);
     if (context_cstr)
         payload["context"] = context_cstr;
     if (!properties.getFormat().empty())
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
index 7debf013..f5750f8c 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -77,7 +77,8 @@ enum class ReadingContext {
 };
 
 namespace Ocpp16 {
-const char *cstrFromReadingContext(ReadingContext context);
+const char *serializeReadingContext(ReadingContext context);
+ReadingContext deserializeReadingContext(const char *serialized);
 }
 
 class SampledValue {
@@ -119,6 +120,7 @@ class SampledValueSampler {
     SampledValueSampler(SampledValueProperties properties) : properties(properties) { }
     virtual ~SampledValueSampler() = default;
     virtual std::unique_ptr<SampledValue> takeValue(ReadingContext context) = 0;
+    virtual std::unique_ptr<SampledValue> deserializeValue(JsonObject svJson) = 0;
     const std::string& getMeasurand() {return properties.getMeasurand();};
 };
 
@@ -129,7 +131,16 @@ class SampledValueSamplerConcrete : public SampledValueSampler {
 public:
     SampledValueSamplerConcrete(SampledValueProperties properties, std::function<T(ReadingContext)> sampler) : SampledValueSampler(properties), sampler(sampler) { }
     std::unique_ptr<SampledValue> takeValue(ReadingContext context) override {
-        return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(properties, context, sampler(context)));
+        return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(
+            properties,
+            context,
+            sampler(context)));
+    }
+    std::unique_ptr<SampledValue> deserializeValue(JsonObject svJson) override {
+        return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(
+            properties,
+            Ocpp16::deserializeReadingContext(svJson["context"] | "NOT_SET"),
+            DeSerializer::deserialize(svJson["value"] | "")));
     }
 };
 

From 2225250c252300154370519afafd398167aab3d0 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 18 Aug 2022 15:37:02 +0200
Subject: [PATCH 051/549] atomic transaction operations

---
 src/ArduinoOcpp.cpp                           | 102 +++--
 src/ArduinoOcpp.h                             |   8 +-
 src/ArduinoOcpp/Core/OcppMessage.h            |   4 +-
 src/ArduinoOcpp/Core/OcppModel.cpp            |   9 +
 src/ArduinoOcpp/Core/OcppModel.h              |   5 +
 src/ArduinoOcpp/Core/OcppOperation.cpp        |  15 +
 src/ArduinoOcpp/Core/OcppOperation.h          |   2 +
 .../MessagesV16/StartTransaction.cpp          | 121 +++---
 .../MessagesV16/StartTransaction.h            |  17 +-
 .../MessagesV16/StopTransaction.cpp           |  93 +++--
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |  20 +-
 .../SimpleOcppOperationFactory.cpp            |   4 +-
 .../ChargePointStatus/ConnectorStatus.cpp     | 349 ++++++++----------
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  32 +-
 .../TransactionPrerequisites.h                |   7 +-
 .../Transactions/OrderedOperationsQueue.cpp   |  29 ++
 .../Transactions/OrderedOperationsQueue.h     |  28 ++
 .../Tasks/Transactions/Transaction.cpp        | 218 +++++++++++
 .../Tasks/Transactions/Transaction.h          | 196 ++++++++++
 .../Tasks/Transactions/TransactionProcess.cpp | 113 ++++++
 .../Tasks/Transactions/TransactionProcess.h   |  46 +++
 .../Transactions/TransactionSequence.cpp      |  29 ++
 .../Tasks/Transactions/TransactionSequence.h  |  28 ++
 .../Tasks/Transactions/TransactionService.cpp |  74 ++++
 .../Tasks/Transactions/TransactionService.h   |  44 +++
 .../Tasks/Transactions/TransactionStore.cpp   | 308 ++++++++++++++++
 .../Tasks/Transactions/TransactionStore.h     |  61 +++
 27 files changed, 1589 insertions(+), 373 deletions(-)
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/Transaction.h
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.h
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionService.h
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index a9495203..6b29a231 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -12,6 +12,7 @@
 #include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
@@ -40,6 +41,7 @@ float voltage_eff {230.f};
 #define OCPP_ID_OF_CONNECTOR 1
 #define OCPP_ID_OF_CP 0
 bool OCPP_booted = false; //if BootNotification succeeded
+bool enteredLoop = false; //if loop() is called the first time
 
 } //end namespace ArduinoOcpp::Facade
 } //end namespace ArduinoOcpp
@@ -94,6 +96,8 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
     ocppEngine = new OcppEngine(ocppSocket, system_time);
     auto& model = ocppEngine->getOcppModel();
 
+    model.setTransactionService(std::unique_ptr<TransactionService>(
+        new TransactionService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
     model.setChargePointStatusService(std::unique_ptr<ChargePointStatusService>(
         new ChargePointStatusService(*ocppEngine, OCPP_NUMCONNECTORS)));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
@@ -123,8 +127,7 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
 }
 
 void OCPP_deinitialize() {
-    AO_DBG_DEBUG("Still experimental function. If you find problems, it would be great if you publish them on the GitHub page");
-
+    
     delete ocppEngine;
     ocppEngine = nullptr;
 
@@ -141,15 +144,21 @@ void OCPP_deinitialize() {
     voltage_eff = 230.f;
 
     OCPP_booted = false;
+    enteredLoop = false;
 }
 
 void OCPP_loop() {
     if (!ocppEngine) {
         AO_DBG_WARN("Please call OCPP_initialize before");
-        //delay(200); //Prevent this message from flooding the Serial monitor.
         return;
     }
 
+    if (!enteredLoop) {
+        enteredLoop = true;
+        configuration_save();
+        ocppEngine->getOcppModel().getTransactionService()->initiateRestoredOperations();
+    }
+
     ocppEngine->loop();
 
     auto& model = ocppEngine->getOcppModel();
@@ -168,7 +177,7 @@ void OCPP_loop() {
 
 void setPowerActiveImportSampler(std::function<float()> power) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
 
@@ -191,7 +200,7 @@ void setPowerActiveImportSampler(std::function<float()> power) {
 
 void setEnergyActiveImportSampler(std::function<float()> energy) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto& model = ocppEngine->getOcppModel();
@@ -213,7 +222,7 @@ void setEnergyActiveImportSampler(std::function<float()> energy) {
 
 void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto& model = ocppEngine->getOcppModel();
@@ -226,7 +235,7 @@ void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler
 
 void addMeterValueSampler(std::function<int32_t ()> value, const char *measurand, const char *unit, const char *location, const char *phase) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
 
@@ -259,7 +268,7 @@ void addMeterValueSampler(std::function<int32_t ()> value, const char *measurand
 
 void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
@@ -272,7 +281,7 @@ void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
 
 void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
@@ -285,7 +294,7 @@ void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized) {
 
 void setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
@@ -298,7 +307,7 @@ void setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
 
 void addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
@@ -311,7 +320,7 @@ void addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCo
 
 void setOnChargingRateLimitChange(std::function<void(float)> chargingRateChanged) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto& model = ocppEngine->getOcppModel();
@@ -324,7 +333,7 @@ void setOnChargingRateLimitChange(std::function<void(float)> chargingRateChanged
 
 void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
@@ -335,9 +344,9 @@ void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
     connector->setOnUnlockConnector(unlockConnector);
 }
 
-void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCondition)> lockConnector) {
+void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnector) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
@@ -348,9 +357,9 @@ void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCo
     connector->setConnectorLock(lockConnector);
 }
 
-void setTxBasedMeterUpdate(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCondition)> updateTxState) {
+void setTxBasedMeterUpdate(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> updateTxState) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
@@ -387,7 +396,7 @@ void setOnResetReceiveReq(OnReceiveReqListener onReceiveReq) {
 
 void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
@@ -413,7 +422,7 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
 
 void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     
@@ -427,7 +436,7 @@ void bootNotification(const char *chargePointModel, const char *chargePointVendo
 
 void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto bootNotification = makeOcppOperation(
@@ -447,17 +456,30 @@ void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveCon
     ocppEngine->initiateOperation(std::move(bootNotification));
 }
 
-void startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
-        return;
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return false;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
-        return;
+        return false;
+    }
+    auto transaction = ocppEngine->getOcppModel().getTransactionService()->getTransactionStore().getActiveTransaction(OCPP_ID_OF_CONNECTOR);
+    if (!transaction) {
+        AO_DBG_ERR("Transaction buffer full");
+        return false;
+    }
+
+    if (transaction->isRunning()) {
+        AO_DBG_ERR("Called StartTx while still in transaction. Please call StopTx");
+        return false;
     }
+
+    transaction->setIdTag(idTag);
+    
     auto startTransaction = makeOcppOperation(
-        new StartTransaction(OCPP_ID_OF_CONNECTOR, idTag));
+        new StartTransaction(transaction));
     if (onConf)
         startTransaction->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -471,15 +493,31 @@ void startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
     else
         startTransaction->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
     ocppEngine->initiateOperation(std::move(startTransaction));
+
+    return true;
 }
 
-void stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
-        return;
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return false;
     }
+
+    auto transaction = ocppEngine->getOcppModel().getTransactionService()->getTransactionStore().getActiveTransaction(OCPP_ID_OF_CONNECTOR);
+    if (!transaction || !transaction->isRunning()) {
+        AO_DBG_ERR("No running Tx to stop");
+        return false;
+    }
+
+    const char *idTag = transaction->getIdTag();
+    if (idTag) {
+        transaction->setStopIdTag(idTag);
+    }
+    
+    transaction->setStopReason("Local");
+
     auto stopTransaction = makeOcppOperation(
-        new StopTransaction(OCPP_ID_OF_CONNECTOR));
+        new StopTransaction(transaction));
     if (onConf)
         stopTransaction->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -493,6 +531,8 @@ void stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
     else
         stopTransaction->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
     ocppEngine->initiateOperation(std::move(stopTransaction));
+
+    return true;
 }
 
 int getTransactionId() {
@@ -539,7 +579,7 @@ bool isAvailable() {
 
 void beginSession(const char *idTag) {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
@@ -556,7 +596,7 @@ void beginSession(const char *idTag) {
 
 void endSession() {
     if (!ocppEngine) {
-        AO_DBG_ERR("Please call OCPP_initialize before");
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
     auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index c02c19af..d8ffae91 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -87,7 +87,7 @@ void setOnUnlockConnector(std::function<ArduinoOcpp::PollResult<bool>()> unlockC
 //               - TxEnableState::Inactive if connector lock is released
 //               - TxEnableState::Pending otherwise, e.g. if transitioning between the states
 //Called periodically
-void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCondition)> lockConnector);
+void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnector);
 
 //Set a Cb to update transaction-based energy measurements with the most recent transaction state.
 //This allows energy meters (e.g. based on OCMF) to take their measruements right before and after a transaction
@@ -95,7 +95,7 @@ void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCo
 //               - TxEnableState::Inactive if the energy meter has transitioned into a non-transaction-state
 //               - TxEnableState::Pending otherwise, e.g. if transitioning between the states
 //Called periodically
-void setTxBasedMeterUpdate(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxCondition)> updateTxState);
+void setTxBasedMeterUpdate(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> updateTxState);
 
 /*
  * React on CS-initiated operations
@@ -146,9 +146,9 @@ void bootNotification(const char *chargePointModel, const char *chargePointVendo
 //The OCPP operation will include the given payload without modifying it. The library will delete the payload object after successful transmission.
 void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
 
-void startTransaction(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+bool startTransaction(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
 
-void stopTransaction(OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+bool stopTransaction(OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
 
 /*
  * Access information about the internal state of the library
diff --git a/src/ArduinoOcpp/Core/OcppMessage.h b/src/ArduinoOcpp/Core/OcppMessage.h
index ab88d345..5b0cb3cd 100644
--- a/src/ArduinoOcpp/Core/OcppMessage.h
+++ b/src/ArduinoOcpp/Core/OcppMessage.h
@@ -26,6 +26,7 @@ namespace ArduinoOcpp {
 std::unique_ptr<DynamicJsonDocument> createEmptyDocument();
 
 class OcppModel;
+class TransactionRPC;
 
 class OcppMessage {
 private:
@@ -75,7 +76,8 @@ class OcppMessage {
     virtual const char *getErrorCode() {return nullptr;} //nullptr means no error
     virtual const char *getErrorDescription() {return "";}
     virtual std::unique_ptr<DynamicJsonDocument> getErrorDetails() {return createEmptyDocument();}
-        
+    
+    virtual TransactionRPC *getTransactionSync() {return nullptr;}
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/OcppModel.cpp
index ec6a78fc..13925ffb 100644
--- a/src/ArduinoOcpp/Core/OcppModel.cpp
+++ b/src/ArduinoOcpp/Core/OcppModel.cpp
@@ -3,6 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
@@ -41,6 +42,14 @@ void OcppModel::loop() {
         firmwareService->loop();
 }
 
+void OcppModel::setTransactionService(std::unique_ptr<TransactionService> ts) {
+    transactionService = std::move(ts);
+}
+
+TransactionService *OcppModel::getTransactionService() {
+    return transactionService.get();
+}
+
 void OcppModel::setSmartChargingService(std::unique_ptr<SmartChargingService> scs) {
     smartChargingService = std::move(scs);
 }
diff --git a/src/ArduinoOcpp/Core/OcppModel.h b/src/ArduinoOcpp/Core/OcppModel.h
index e0ae10b8..2b7a351a 100644
--- a/src/ArduinoOcpp/Core/OcppModel.h
+++ b/src/ArduinoOcpp/Core/OcppModel.h
@@ -11,6 +11,7 @@
 
 namespace ArduinoOcpp {
 
+class TransactionService;
 class SmartChargingService;
 class ChargePointStatusService;
 class ConnectorStatus;
@@ -21,6 +22,7 @@ class HeartbeatService;
 
 class OcppModel {
 private:
+    std::unique_ptr<TransactionService> transactionService;
     std::unique_ptr<SmartChargingService> smartChargingService;
     std::unique_ptr<ChargePointStatusService> chargePointStatusService;
     std::unique_ptr<MeteringService> meteringService;
@@ -37,6 +39,9 @@ class OcppModel {
 
     void loop();
 
+    void setTransactionService(std::unique_ptr<TransactionService> transactionService);
+    TransactionService *getTransactionService();
+
     void setSmartChargingService(std::unique_ptr<SmartChargingService> scs);
     SmartChargingService* getSmartChargingService() const;
 
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 723baeab..18183dcb 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -6,6 +6,7 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
@@ -118,6 +119,15 @@ bool OcppOperation::sendReq(OcppSocket& ocppSocket){
     requestJson.add(ocppMessage->getOcppOperationType());  //Action
     requestJson.add(*requestPayload);                      //Payload
 
+    /*
+     * Transaction safety: before sending the message, store the assigned msgId so this action
+     * can be replayed when booted the next time
+     */
+    auto txSync = ocppMessage->getTransactionSync();
+    if (txSync) {
+        txSync->requestWithMsgId(unique_id_counter);
+    }
+
     /*
      * Serialize and send. Destroy serialization and JSON object. 
      * 
@@ -353,6 +363,11 @@ bool OcppOperation::isFullyConfigured(){
     return ocppMessage != nullptr;
 }
 
+void OcppOperation::rebaseMsgId(int msgIdCounter) {
+    unique_id_counter = msgIdCounter;
+    getMessageID(); //apply msgIdCounter to this operation
+}
+
 void OcppOperation::print_debug() {
     if (ocppMessage) {
         AO_CONSOLE_PRINTF("OcppOperation of type %s\n", ocppMessage->getOcppOperationType());
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index 4ca7b5ad..a3c44de6 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -128,6 +128,8 @@ class OcppOperation {
 
     bool isFullyConfigured();
 
+    void rebaseMsgId(int msgIdCounter); //workaround; remove when random UUID msg IDs are introduced
+
     void print_debug();
 };
 
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index fa501eca..9e9d91ca 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -6,19 +6,16 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::StartTransaction;
+using ArduinoOcpp::TransactionRPC;
 
-StartTransaction::StartTransaction(int connectorId) : connectorId(connectorId) {
-    
-}
 
-StartTransaction::StartTransaction(int connectorId, const char *idTag) : connectorId(connectorId) {
-    if (idTag && strnlen(idTag, IDTAG_LEN_MAX + 2) <= IDTAG_LEN_MAX)
-        snprintf(this->idTag, IDTAG_LEN_MAX + 1, "%s", idTag);
-    else
-        AO_DBG_ERR("Format violation");
+StartTransaction::StartTransaction(std::shared_ptr<Transaction> transaction) : transaction(transaction) {
+    
 }
 
 const char* StartTransaction::getOcppOperationType() {
@@ -26,41 +23,28 @@ const char* StartTransaction::getOcppOperationType() {
 }
 
 void StartTransaction::initiate() {
-    if (ocppModel && ocppModel->getMeteringService()) {
-        auto meteringService = ocppModel->getMeteringService();
-        meterStart = meteringService->readTxEnergyMeter(connectorId, ReadingContext::TransactionBegin);
-    }
-
-    if (ocppModel) {
-        otimestamp = ocppModel->getOcppTime().getOcppTimestampNow();
-    } else {
-        otimestamp = MIN_TIME;
-    }
+    if (ocppModel && transaction && !transaction->getStartRpcSync().isRequested()) {
+        //fill out tx data if not happened before
 
-    if (ocppModel && ocppModel->getConnectorStatus(connectorId)) {
-        auto connector = ocppModel->getConnectorStatus(connectorId);
-
-        if (*idTag == '\0') {
-            const char *sessionIdTag = connector->getSessionIdTag();
-            if (sessionIdTag) {
-                snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", sessionIdTag);
+        auto meteringService = ocppModel->getMeteringService();
+        if (transaction->getMeterStart() < 0 && meteringService) {
+            auto meterStart = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionBegin);
+            if (meterStart && *meterStart) {
+                transaction->setMeterStart(meterStart->toInteger());
             } else {
-                AO_DBG_WARN("Try to start transaction without providing idTag. Initialize session with default idTag");
-                connector->beginSession(nullptr);
-                sessionIdTag = connector->getSessionIdTag(); //returns default idTag now
-                if (sessionIdTag)
-                    snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", sessionIdTag);
+                AO_DBG_ERR("MeterStart undefined");
             }
-        } else {
-            //idTag has been overriden
-            connector->beginSession(idTag);
         }
 
-        if (connector->getTransactionId() >= 0) {
-            AO_DBG_WARN("Started transaction while OCPP already presumes a running transaction");
+        if (transaction->getStartTimestamp() <= MIN_TIME) {
+            transaction->setStartTimestamp(ocppModel->getOcppTime().getOcppTimestampNow());
         }
-        connector->setTransactionId(0); //pending
-        transactionRev = connector->getTransactionWriteCount();
+        
+        auto seqNr = ocppModel->getTransactionService()->getTransactionSequence().reserveSeqNr();
+        AO_DBG_DEBUG("Reserved seqNr inside StartTx: %u", seqNr);
+        transaction->getStartRpcSync().setRequested(seqNr);
+
+        transaction->commit();
     }
 
     AO_DBG_INFO("StartTransaction initiated");
@@ -68,59 +52,52 @@ void StartTransaction::initiate() {
 
 std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
 
-    if (meterStart && !*meterStart) {
-        //meterStart not ready yet
-        return nullptr;
-    }
-
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(5) + (JSONDATE_LENGTH + 1) + (IDTAG_LEN_MAX + 1)));
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                JSON_OBJECT_SIZE(5) + 
+                (IDTAG_LEN_MAX + 1) +
+                (JSONDATE_LENGTH + 1)));
+                
     JsonObject payload = doc->to<JsonObject>();
 
-    payload["connectorId"] = connectorId;
-    if (meterStart && *meterStart) {
-        payload["meterStart"] = meterStart->toInteger();
+    payload["connectorId"] = transaction->getConnectorId();
+
+    if (transaction->getIdTag() && *transaction->getIdTag()) {
+        payload["idTag"] = (char*) transaction->getIdTag();
     }
 
-    if (otimestamp > MIN_TIME) {
+    if (transaction->isMeterStartDefined()) {
+        payload["meterStart"] = transaction->getMeterStart();
+    }
+
+    if (transaction->getStartTimestamp() > MIN_TIME) {
         char timestamp[JSONDATE_LENGTH + 1] = {'\0'};
-        otimestamp.toJsonString(timestamp, JSONDATE_LENGTH + 1);
+        transaction->getStartTimestamp().toJsonString(timestamp, JSONDATE_LENGTH + 1);
         payload["timestamp"] = timestamp;
     }
 
-    payload["idTag"] = idTag;
-
     return doc;
 }
 
 void StartTransaction::processConf(JsonObject payload) {
 
     const char* idTagInfoStatus = payload["idTagInfo"]["status"] | "not specified";
-    int transactionId = payload["transactionId"] | -1;
-
-    ConnectorStatus *connector = nullptr;
-    if (ocppModel)
-        connector = ocppModel->getConnectorStatus(connectorId);
-    
-    if (connector) {
-        if (transactionRev == connector->getTransactionWriteCount()) {
-
-            if (!strcmp(idTagInfoStatus, "Accepted")) {
-                AO_DBG_INFO("Request has been accepted");
-            } else {
-                AO_DBG_INFO("Request has been denied. Reason: %s", idTagInfoStatus);
-                AO_DBG_DEBUG("Set txId despite rejection");
-                connector->setIdTagInvalidated();
-            }
-            
-            connector->setTransactionId(transactionId);
-        }
-        connector->setTransactionIdSync(transactionId);
-
-        AO_DBG_DEBUG("Local txId = %i, remote txId = %i", connector->getTransactionId(), connector->getTransactionIdSync());
+    if (!strcmp(idTagInfoStatus, "Accepted")) {
+        AO_DBG_INFO("Request has been accepted");
+    } else {
+        AO_DBG_INFO("Request has been denied. Reason: %s", idTagInfoStatus);
+        transaction->setIdTagDeauthorized();
     }
 
+    int transactionId = payload["transactionId"] | -1;
+    transaction->setTransactionId(transactionId);
+
+    transaction->getStartRpcSync().confirm();
+    transaction->commit();
 }
 
+TransactionRPC *StartTransaction::getTransactionSync() {
+    return transaction ? &transaction->getStartRpcSync() : nullptr;
+}
 
 void StartTransaction::processReq(JsonObject payload) {
 
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.h b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
index 153da753..1445148f 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
@@ -11,19 +11,20 @@
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 namespace ArduinoOcpp {
+
+class Transaction;
+class TransactionRPC;
+
 namespace Ocpp16 {
 
 class StartTransaction : public OcppMessage {
 private:
-    int connectorId = 1;
-    std::unique_ptr<SampledValue> meterStart {nullptr};
-    OcppTimestamp otimestamp;
-    char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
-    uint16_t transactionRev = 0;
+    std::shared_ptr<Transaction> transaction;
 public:
-    StartTransaction(int connectorId);
 
-    StartTransaction(int connectorId, const char *idTag);
+    StartTransaction(std::shared_ptr<Transaction> transaction);
+
+    StartTransaction() = default; //for debugging only. Make this for the server pendant
 
     const char* getOcppOperationType();
 
@@ -33,6 +34,8 @@ class StartTransaction : public OcppMessage {
 
     void processConf(JsonObject payload);
 
+    TransactionRPC *getTransactionSync() override;
+
     void processReq(JsonObject payload);
 
     std::unique_ptr<DynamicJsonDocument> createConf();
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 69a85f27..ddf5b566 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -7,53 +7,59 @@
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::StopTransaction;
+using ArduinoOcpp::TransactionRPC;
+
+StopTransaction::StopTransaction(std::shared_ptr<Transaction> transaction)
+        : transaction(transaction) {
+
+}
+
+StopTransaction::StopTransaction(std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData)
+        : transaction(transaction), transactionData(std::move(transactionData)) {
 
-StopTransaction::StopTransaction(int connectorId, const char *reason) : connectorId(connectorId) {
-    if (reason) {
-        snprintf(this->reason, REASON_LEN_MAX, "%s", reason);
-    }
 }
 
+StopTransaction::StopTransaction() { }
+
 const char* StopTransaction::getOcppOperationType(){
     return "StopTransaction";
 }
 
 void StopTransaction::initiate() {
 
-    if (ocppModel && ocppModel->getMeteringService()) {
-        auto meteringService = ocppModel->getMeteringService();
-        meterStop = meteringService->readTxEnergyMeter(connectorId, ReadingContext::TransactionEnd);
-        transactionData = meteringService->createStopTxMeterData(connectorId);
-    }
+    if (ocppModel && transaction && !transaction->getStopRpcSync().isRequested()) {
+        //fill out tx data if not happened before
 
-    if (ocppModel) {
-        otimestamp = ocppModel->getOcppTime().getOcppTimestampNow();
-    } else {
-        otimestamp = MIN_TIME;
-    }
+        auto meteringService = ocppModel->getMeteringService();
+        if (transaction->getMeterStop() < 0 && meteringService) {
+            auto meterStop = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
+            if (meterStop && *meterStop) {
+                transaction->setMeterStop(meterStop->toInteger());
+            } else {
+                AO_DBG_ERR("MeterStop undefined");
+            }
+        }
 
-    if (ocppModel && ocppModel->getConnectorStatus(connectorId)){
-        auto connector = ocppModel->getConnectorStatus(connectorId);
-        connector->setTransactionId(-1); //immediate end of transaction
-        if (connector->getSessionIdTag()) {
-            AO_DBG_DEBUG("Ending EV user session triggered by StopTransaction");
-            connector->endSession();
+        if (transaction->getStopTimestamp() <= MIN_TIME) {
+            transaction->setStopTimestamp(ocppModel->getOcppTime().getOcppTimestampNow());
         }
-    }
 
+        auto seqNr = ocppModel->getTransactionService()->getTransactionSequence().reserveSeqNr();
+        AO_DBG_DEBUG("Reserved seqNr inside StopTx: %u", seqNr);
+        transaction->getStopRpcSync().setRequested(seqNr);
+
+        transaction->commit();
+    }
     AO_DBG_INFO("StopTransaction initiated!");
 }
 
 std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
-    if (meterStop && !*meterStop) {
-        //meterStop not ready yet
-        return nullptr;
-    }
-
     std::vector<std::unique_ptr<DynamicJsonDocument>> txDataJson;
     size_t txDataJson_size = 0;
     for (auto mv = transactionData.begin(); mv != transactionData.end(); mv++) {
@@ -72,28 +78,30 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
                 JSON_OBJECT_SIZE(6) + //total of 6 fields
+                (IDTAG_LEN_MAX + 1) + //stop idTag
                 (JSONDATE_LENGTH + 1) + //timestamp string
                 (REASON_LEN_MAX + 1) + //reason string
                 txDataDoc.capacity()));
     JsonObject payload = doc->to<JsonObject>();
 
-    if (meterStop && *meterStop) {
-        payload["meterStop"] = meterStop->toInteger();
+    if (transaction->getStopIdTag() && *transaction->getStopIdTag()) {
+        payload["idTag"] = (char*) transaction->getStopIdTag();
     }
 
-    if (otimestamp > MIN_TIME) {
-        char timestamp[JSONDATE_LENGTH + 1] = {'\0'};
-        otimestamp.toJsonString(timestamp, JSONDATE_LENGTH + 1);
-        payload["timestamp"] = timestamp;
+    if (transaction->isMeterStopDefined()) {
+        payload["meterStop"] = transaction->getMeterStop();
     }
-    
-    if (ocppModel && ocppModel->getConnectorStatus(connectorId)){
-        auto connector = ocppModel->getConnectorStatus(connectorId);
-        payload["transactionId"] = connector->getTransactionIdSync();
+
+    if (transaction->getStopTimestamp() > MIN_TIME) {
+        char timestamp [JSONDATE_LENGTH + 1] = {'\0'};
+        transaction->getStopTimestamp().toJsonString(timestamp, JSONDATE_LENGTH + 1);
+        payload["timestamp"] = timestamp;
     }
 
-    if (reason[0] != '\0') {
-        payload["reason"] = reason;
+    payload["transactionId"] = transaction->getTransactionId();
+    
+    if (transaction->getStopReason() && *transaction->getStopReason()) {
+        payload["reason"] = (char*) transaction->getStopReason();
     }
 
     if (!transactionData.empty()) {
@@ -105,14 +113,17 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
 void StopTransaction::processConf(JsonObject payload) {
 
-    if (ocppModel && ocppModel->getConnectorStatus(connectorId)){
-        auto connector = ocppModel->getConnectorStatus(connectorId);
-        connector->setTransactionIdSync(-1);
+    if (transaction) {
+        transaction->getStopRpcSync().confirm();
+        transaction->commit();
     }
 
     AO_DBG_INFO("Request has been accepted!");
 }
 
+TransactionRPC *StopTransaction::getTransactionSync() {
+    return transaction ? &transaction->getStopRpcSync() : nullptr;
+}
 
 void StopTransaction::processReq(JsonObject payload) {
     /**
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index eaaacde8..da40c680 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -14,18 +14,24 @@ namespace ArduinoOcpp {
 class SampledValue;
 class MeterValue;
 
+class Transaction;
+class TransactionRPC;
+
 namespace Ocpp16 {
 
 class StopTransaction : public OcppMessage {
 private:
-    int connectorId = 1;
-    std::unique_ptr<SampledValue> meterStop {nullptr};
-    OcppTimestamp otimestamp;
-    char reason [REASON_LEN_MAX] {'\0'};
+    std::shared_ptr<Transaction> transaction;
     std::vector<std::unique_ptr<MeterValue>> transactionData;
 public:
 
-    StopTransaction(int connectorId, const char *reason = nullptr);
+    //StopTransaction(int connectorId, const char *reason = nullptr);
+
+    StopTransaction(std::shared_ptr<Transaction> transaction);
+
+    StopTransaction(std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData);
+    
+    StopTransaction(); //for debugging only. Make this for the server pendant
 
     const char* getOcppOperationType();
 
@@ -35,6 +41,10 @@ class StopTransaction : public OcppMessage {
 
     void processConf(JsonObject payload);
 
+    bool processErr(const char *code, const char *description, JsonObject details) { return false;}
+
+    TransactionRPC *getTransactionSync() override;
+
     void processReq(JsonObject payload);
 
     std::unique_ptr<DynamicJsonDocument> createConf();
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
index 274ac806..9a825b85 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
@@ -228,10 +228,10 @@ std::unique_ptr<OcppOperation> makeOcppOperation(const char *messageType, int co
     } else if (!strcmp(messageType, "StatusNotification")) {
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::StatusNotification(connectorId));
     } else if (!strcmp(messageType, "StartTransaction")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction(1)); //connectorId 1
+        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction());
         operation->setOnReceiveReqListener(onStartTransactionRequest);
     } else if (!strcmp(messageType, "StopTransaction")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StopTransaction(1)); //connectorId 1
+        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StopTransaction());
     } else if (!strcmp(messageType, "TriggerMessage")) {
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::TriggerMessage());
         operation->setOnReceiveReqListener(onTriggerMessageRequest);
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index ac671131..5ba7dd26 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -6,6 +6,7 @@
 
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
@@ -19,19 +20,11 @@ using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
 ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
-        : context(context), connectorId{connectorId} {
+        : context(context), connectorId{connectorId}, txProcess(connectorId) {
 
-    //Set default transaction ID in memory
-    char key [CONF_KEYLEN_MAX + 1] = {'\0'};
-
-    snprintf(key, CONF_KEYLEN_MAX + 1, "AO_SID_CONN_%d", connectorId);
-    sIdTag = declareConfiguration<const char *>(key, "", CONFIGURATION_FN, false, false, true, false);
-
-    snprintf(key, CONF_KEYLEN_MAX + 1, "AO_TXID_CONN_%d", connectorId);
-    transactionId = declareConfiguration<int>(key, -1, CONFIGURATION_FN, false, false, true, false);
-
-    snprintf(key, CONF_KEYLEN_MAX + 1, "AO_AVAIL_CONN_%d", connectorId);
-    availability = declareConfiguration<int>(key, AVAILABILITY_OPERATIVE, CONFIGURATION_FN, false, false, true, false);
+    char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
+    snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, "AO_AVAIL_CONN_%d", connectorId);
+    availability = declareConfiguration<int>(availabilityKey, AVAILABILITY_OPERATIVE, CONFIGURATION_FN, false, false, true, false);
 
     connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN, true, true, true, false);
     minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
@@ -41,17 +34,9 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
     localAuthorizeOffline = declareConfiguration<const char*>("LocalAuthorizeOffline", "false", CONFIGURATION_FN, true, true, false, false);
     localPreAuthorize = declareConfiguration<const char*>("LocalPreAuthorize", "false", CONFIGURATION_FN, true, true, false, false);
 
-    if (!sIdTag || !transactionId || !availability) {
-        AO_DBG_ERR("Cannot declare sessionIdTag, transactionId or availability");
+    if (!availability) {
+        AO_DBG_ERR("Cannot declare availability");
     }
-    if (sIdTag->getBuffsize() > 0 && (*sIdTag)[0] != '\0') {
-        snprintf(idTag, std::min((size_t) (IDTAG_LEN_MAX + 1), sIdTag->getBuffsize()), "%s", ((const char *) *sIdTag));
-        session = true;
-        connectionTimeOutTimestamp = ao_tick_ms();
-        connectionTimeOutListen = true;
-        AO_DBG_DEBUG("Load session idTag at initialization");
-    }
-    transactionIdSync = *transactionId;
 
     /*
      * Initialize standard EVSE behavior.
@@ -60,22 +45,26 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
      *     - lock the connector (if handler is set)
      *     - instruct the OCMF meter to begin a transaction (if OCMF meter handler is set)
      */
-    txTriggerConditions.push_back([this] () -> TxCondition {
-        if (!session)
-            return TxCondition::Inactive;
-        return getSessionIdTag() ? TxCondition::Active : TxCondition::Inactive;
+    txProcess.addTrigger([this] () -> TxTrigger {
+        auto transaction = this->context.getTransactionService()->getTransactionStore().getActiveTransaction(this->connectorId);
+
+        if (transaction && transaction->isInSession() && transaction->isActive()) {
+            return TxTrigger::Active;
+        } else {
+            return TxTrigger::Inactive;
+        }
     });
-    txEnableSequence.push_back([this] (TxCondition cond) -> TxEnableState {
+    txProcess.addEnableStep([this] (TxTrigger cond) -> TxEnableState {
         if (onOcmfMeterPollTx) {
             return onOcmfMeterPollTx(cond);
         }
-        return cond == TxCondition::Active ? TxEnableState::Active : TxEnableState::Inactive;
+        return cond == TxTrigger::Active ? TxEnableState::Active : TxEnableState::Inactive;
     });
-    txEnableSequence.push_back([this] (TxCondition cond) -> TxEnableState {
+    txProcess.addEnableStep([this] (TxTrigger cond) -> TxEnableState {
         if (onConnectorLockPollTx) {
             return onConnectorLockPollTx(cond);
         }
-        return cond == TxCondition::Active ? TxEnableState::Active : TxEnableState::Inactive;
+        return cond == TxTrigger::Active ? TxEnableState::Active : TxEnableState::Inactive;
     });
 }
 
@@ -95,37 +84,30 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
         }
     }
 
+    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
+
     if (getErrorCode() != nullptr) {
         return OcppEvseState::Faulted;
+    } else if (!transaction) { //won't start new transactions if cached tx queue is full
+        return OcppEvseState::Unavailable;
     } else if (*availability == AVAILABILITY_INOPERATIVE) {
         return OcppEvseState::Unavailable;
-    } else if (rebooting && getTransactionId() < 0) {
+    } else if (rebooting && !transaction->isRunning()) {
         return OcppEvseState::Unavailable;
-    } else if (getTransactionId() == 0 &&      // i.e. Tx pending or EVSE offline. Check if offline Tx is OFF
-            !(*localAuthorizeOffline && strcmp(*localAuthorizeOffline, "false")) &&
-            !(*localPreAuthorize && strcmp(*localPreAuthorize, "false"))) {
-        //All modes for offline Tx are off
-        return OcppEvseState::Preparing; //see other Preparing case
-    } else if (getTransactionId() >= 0) {
+    } else if (transaction->isRunning()) {
         //Transaction is currently running
         if ((connectorEnergizedSampler && !connectorEnergizedSampler()) ||
-                idTagInvalidated) {
+                !transaction->isActive() || //will forbid charging
+                transaction->isIdTagDeauthorized()) {
             return OcppEvseState::SuspendedEVSE;
         }
         if (evRequestsEnergySampler && !evRequestsEnergySampler()) {
             return OcppEvseState::SuspendedEV;
         }
         return OcppEvseState::Charging;
-    } else if (txEnable == TxEnableState::Inactive) {
+    } else if (!txProcess.existsActiveTrigger() && txProcess.getState() == TxEnableState::Inactive) {
         return OcppEvseState::Available;
-    } else if (txEnable == TxEnableState::Pending ||  
-               txEnable == TxEnableState::Active) {   //reached if Tx init is delayed
-
-        if (txEnable == TxEnableState::Active) { // TODO verify if actually possible
-            AO_DBG_VERBOSE("Infered Active"); //
-            (void)0;                             //
-        }                                        //
-
+    } else {
         /*
          * Either in Preparing or Finishing state. Only way to know is from previous state
          */
@@ -139,7 +121,7 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
             return OcppEvseState::Preparing;
         }
     }
-    
+
     AO_DBG_VERBOSE("Cannot infere status");
     return OcppEvseState::Faulted; //internal error
 }
@@ -150,112 +132,99 @@ bool ConnectorStatus::ocppPermitsCharge() {
         return false;
     }
 
-    if (idTagInvalidated) {
-        return false;
-    }
+    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
 
-    OcppEvseState state = inferenceStatus();
-
-    return state == OcppEvseState::Charging ||
-            state == OcppEvseState::SuspendedEV ||
-            state == OcppEvseState::SuspendedEVSE;
+    return transaction &&
+            transaction->isRunning() &&
+            transaction->isActive() &&
+            !getErrorCode() &&
+            !transaction->isIdTagDeauthorized();
 }
 
 OcppMessage *ConnectorStatus::loop() {
-    if (getTransactionId() < 0 && *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
+
+    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
+
+    if ((!transaction || !transaction->isRunning()) && *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
         *availability = AVAILABILITY_INOPERATIVE;
         saveState();
     }
-        
-    if (connectorPluggedSampler) {
-        if (getTransactionId() >= 0 && !connectorPluggedSampler()) {
-            if (!*stopTransactionOnEVSideDisconnect || strcmp(*stopTransactionOnEVSideDisconnect, "false")) {
-                endSession("EVDisconnected");
+
+    if (transaction) { //begin exclusively transaction-related operations
+            
+        if (connectorPluggedSampler) {
+            if (transaction->isRunning() && transaction->isInSession() && !connectorPluggedSampler()) {
+                if (!*stopTransactionOnEVSideDisconnect || strcmp(*stopTransactionOnEVSideDisconnect, "false")) {
+                    AO_DBG_DEBUG("Stop Tx due to EV disconnect");
+                    transaction->setStopReason("EVDisconnected");
+                    transaction->endSession();
+                    transaction->commit();
+                }
             }
         }
-    }
 
-    auto txTrigger = txTriggerConditions.empty() ? TxCondition::Inactive : TxCondition::Active;
-    txEnable = TxEnableState::Inactive;
-
-    if (*availability == AVAILABILITY_INOPERATIVE) {
-        txTrigger = TxCondition::Inactive;
-    }
+        if (transaction->isInSession() &&
+                !transaction->getStartRpcSync().isRequested() &&
+                transaction->getSessionTimestamp() > MIN_TIME &&
+                connectionTimeOut && *connectionTimeOut > 0 &&
+                context.getOcppTime().getOcppTimestampNow() - transaction->getSessionTimestamp() >= (otime_t) *connectionTimeOut) {
+                
+            AO_DBG_INFO("Session mngt: timeout");
+            transaction->endSession();
+            transaction->commit();
+        }
 
-    if (txTrigger == TxCondition::Active) {
-        for (auto trigger = txTriggerConditions.begin(); trigger != txTriggerConditions.end(); trigger++) {
-            auto result = trigger->operator()();
-            if (result == TxCondition::Active) {
-                txEnable = TxEnableState::Pending;
-            } else {
-                txTrigger = TxCondition::Inactive;
+        if (transaction->isInSession() && transaction->isIdTagDeauthorized()) {
+            if (!*stopTransactionOnInvalidId || strcmp(*stopTransactionOnInvalidId, "false")) {
+                AO_DBG_DEBUG("DeAuthorize session");
+                transaction->setStopReason("DeAuthorized");
+                transaction->endSession();
+                transaction->commit();
             }
         }
-    }
 
-    if (txTrigger == TxCondition::Active) {
-        txEnable = TxEnableState::Active;
+        txProcess.evaluateProcessSteps(transaction->getTxNr());
+        auto txEnable = txProcess.getState();
 
-        for (auto step = txEnableSequence.rbegin(); step != txEnableSequence.rend(); step++) {
-            auto result = step->operator()(TxCondition::Active);
-            if (result != TxEnableState::Active) {
-                txEnable = TxEnableState::Pending;
-                break;
+        /*
+        * Check conditions for start or stop transaction
+        */
+
+        if (txEnable == TxEnableState::Active) {
+            
+            if (transaction->isPreparing() && !getErrorCode()) {
+                //start Transaction
+
+                AO_DBG_INFO("Session mngt: trigger StartTransaction");
+                //return new StartTransaction(connectorId);
+                auto seqNr = context.getTransactionService()->getTransactionSequence().reserveSeqNr();
+                AO_DBG_DEBUG("Reserved SeqNr %u", seqNr);
+                transaction->getStartRpcSync().setRequested(seqNr);
+                transaction->commit();
+                return new StartTransaction(transaction);
             }
-        }
-    } else {
-        for (auto step = txEnableSequence.begin(); step != txEnableSequence.end(); step++) {
-            auto result = step->operator()(TxCondition::Inactive);
-            if (result != TxEnableState::Inactive) {
-                txEnable = TxEnableState::Pending;
-                break;
+        } else if (transaction->isRunning()) {
+
+            if (transaction->isInSession()) {
+                AO_DBG_DEBUG("Tx process not active");
+                transaction->endSession();
+                transaction->commit();
             }
-        }
-    }
 
+            if (txEnable == TxEnableState::Inactive) {
+                //stop transaction
+                auto seqNr = context.getTransactionService()->getTransactionSequence().reserveSeqNr();
+                transaction->getStopRpcSync().setRequested(seqNr);
+                transaction->commit();
 
-    /*
-     * Check conditions for start or stop transaction
-     */
-    if (txEnable == TxEnableState::Active) {
-        //check if not in transaction yet
-        if (getTransactionId() < 0 &&
-                !getErrorCode()) {
-            //start Transaction
-
-            AO_DBG_DEBUG("Session mngt: txId=%i, connectorPlugged = %s, session=%d",
-                    getTransactionId(),
-                    connectorPluggedSampler ? (connectorPluggedSampler() ? "plugged" : "unplugged") : "undefined",
-                    session);
-            AO_DBG_INFO("Session mngt: trigger StartTransaction");
-            return new StartTransaction(connectorId);
-        }
-    } else {
-        //check if still in transaction
-        if (getTransactionId() >= 0) {
-            //stop transaction
-
-            AO_DBG_DEBUG("Session mngt: txId=%i, connectorPlugged = %s, session=%d",
-                    getTransactionId(),
-                    connectorPluggedSampler ? (connectorPluggedSampler() ? "plugged" : "unplugged") : "undefined",
-                    session);
-            AO_DBG_INFO("Session mngt: trigger StopTransaction");
-            return new StopTransaction(connectorId, endReason[0] != '\0' ? endReason : nullptr);
-        }
-    }
+                AO_DBG_INFO("Session mngt: trigger StopTransaction");
 
-    if (connectionTimeOutListen) {
-        if (getTransactionId() >= 0 || !session) {
-            AO_DBG_DEBUG("Session mngt: release connectionTimeOut");
-            connectionTimeOutListen = false;
-        } else {
-            if (ao_tick_ms() - connectionTimeOutTimestamp >= ((ulong) *connectionTimeOut) * 1000UL) {
-                AO_DBG_INFO("Session mngt: timeout");
-                endSession();
-                connectionTimeOutListen = false;
+                AO_DBG_DEBUG("Reserved SeqNr %u", seqNr);
+                
+                return new StopTransaction(transaction);
             }
         }
-    }
+    } //end transaction-related operations
 
     auto inferedStatus = inferenceStatus();
     
@@ -289,82 +258,92 @@ const char *ConnectorStatus::getErrorCode() {
 }
 
 void ConnectorStatus::beginSession(const char *sessionIdTag) {
-    AO_DBG_DEBUG("Begin session with idTag %s, overwriting idTag %s", sessionIdTag != nullptr ? sessionIdTag : "", idTag);
+    
+    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
+
+    if (!transaction) {
+        AO_DBG_ERR("Could not allocate Tx");
+        return;
+    }
+    
+    AO_DBG_DEBUG("Begin session with idTag %s, overwriting idTag %s", sessionIdTag != nullptr ? sessionIdTag : "", transaction->getIdTag());
     if (!sessionIdTag || *sessionIdTag == '\0') {
         //input string is empty
-        snprintf(idTag, IDTAG_LEN_MAX + 1, "A0-00-00-00");
+        transaction->setIdTag("A0-00-00-00");
     } else {
-        snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", sessionIdTag);
+        transaction->setIdTag(sessionIdTag);
     }
-    sIdTag->setValue(idTag, IDTAG_LEN_MAX + 1);
-    saveState();
-    session = true;
-    idTagInvalidated = false;
 
-    memset(endReason, '\0', REASON_LEN_MAX + 1);
+    transaction->setSessionTimestamp(context.getOcppTime().getOcppTimestampNow());
 
-    connectionTimeOutListen = true;
-    connectionTimeOutTimestamp = ao_tick_ms();
+    transaction->commit();
 }
 
 void ConnectorStatus::endSession(const char *reason) {
-    AO_DBG_DEBUG("End session with idTag %s for reason %s, %s previous reason",
-                            idTag, reason ? reason : "undefined",
-                            endReason[0] == '\0' ? "no" : "overruled by");
-    if (session) {
-        memset(idTag, '\0', IDTAG_LEN_MAX + 1);
-        *sIdTag = "";
-        saveState();
-    }
-    session = false;
 
-    if (reason && endReason[0] == '\0') {
-        snprintf(endReason, REASON_LEN_MAX + 1, "%s", reason);
+    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
+
+    if (!transaction) {
+        AO_DBG_ERR("Could not allocate Tx");
+        return;
     }
 
-    connectionTimeOutListen = false;
-}
+    if (transaction->isInSession()) {
+        AO_DBG_DEBUG("End session with idTag %s for reason %s, %s previous reason",
+                                transaction->getIdTag(), reason ? reason : "undefined",
+                                transaction->getStopReason() == '\0' ? "no" : "overruled by");
 
-void ConnectorStatus::setIdTagInvalidated() {
-    if (session) {
-        idTagInvalidated = true;
-        if (!*stopTransactionOnInvalidId || strcmp(*stopTransactionOnInvalidId, "false")) {
-            endSession("DeAuthorized");
+        if (reason) {
+            transaction->setStopReason(reason);
         }
-    } else {
-        AO_DBG_WARN("Cannot invalidate IdTag outside of session");
+        transaction->endSession();
+        transaction->commit();
     }
 }
 
 const char *ConnectorStatus::getSessionIdTag() {
-    return session ? idTag : nullptr;
-}
 
-uint16_t ConnectorStatus::getSessionWriteCount() {
-    return sIdTag->getValueRevision();
-}
+    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
 
-int ConnectorStatus::getTransactionId() {
-    return *transactionId;
-}
+    if (!transaction) {
+        return nullptr;
+    }
 
-int ConnectorStatus::getTransactionIdSync() {
-    return transactionIdSync;
+    return transaction->isInSession() ? transaction->getIdTag() : nullptr;
 }
 
-void ConnectorStatus::setTransactionIdSync(int id) {
-    transactionIdSync = id;
+uint16_t ConnectorStatus::getSessionWriteCount() {
+    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
+    
+    return transaction ? transaction->getTxNr() : 0;
 }
 
-uint16_t ConnectorStatus::getTransactionWriteCount() {
-    return transactionId->getValueRevision();
+int ConnectorStatus::getTransactionId() {
+    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
+    
+    if (!transaction) {
+        return -1;
+    }
+
+    if (transaction->isRunning()) {
+        if (transaction->getStartRpcSync().isConfirmed()) {
+            return transaction->getTransactionId();
+        } else {
+            return 0;
+        }
+    } else {
+        return -1;
+    }
 }
 
-void ConnectorStatus::setTransactionId(int id) {
-    int prevTxId = *transactionId;
-    *transactionId = id;
-    if (id != 0 || prevTxId > 0)
-        saveState();
+int ConnectorStatus::getTransactionIdSync() {
+    auto transaction = context.getTransactionService()->getTransactionStore().getTransactionSync(connectorId);
+    
+    if (transaction) {
+        return transaction->getTransactionId();
+    } else {
+        return -1;
+    }
 }
 
 int ConnectorStatus::getAvailability() {
@@ -390,8 +369,8 @@ void ConnectorStatus::setRebooting(bool rebooting) {
 
 void ConnectorStatus::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
     this->connectorPluggedSampler = connectorPlugged;
-    txTriggerConditions.push_back([this] () -> TxCondition {
-        return connectorPluggedSampler() ? TxCondition::Active : TxCondition::Inactive;
+    txProcess.addTrigger([this] () -> TxTrigger {
+        return connectorPluggedSampler() ? TxTrigger::Active : TxTrigger::Inactive;
     });
 }
 
@@ -419,10 +398,10 @@ std::function<PollResult<bool>()> ConnectorStatus::getOnUnlockConnector() {
     return this->onUnlockConnector;
 }
 
-void ConnectorStatus::setConnectorLock(std::function<TxEnableState(TxCondition)> onConnectorLockPollTx) {
+void ConnectorStatus::setConnectorLock(std::function<TxEnableState(TxTrigger)> onConnectorLockPollTx) {
     this->onConnectorLockPollTx = onConnectorLockPollTx;
 }
 
-void ConnectorStatus::setTxBasedMeterUpdate(std::function<TxEnableState(TxCondition)> onOcmfMeterPollTx) {
+void ConnectorStatus::setTxBasedMeterUpdate(std::function<TxEnableState(TxTrigger)> onOcmfMeterPollTx) {
     this->onOcmfMeterPollTx = onOcmfMeterPollTx;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index ec5492ba..43ddc867 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -7,6 +7,7 @@
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionProcess.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
@@ -23,6 +24,7 @@ namespace ArduinoOcpp {
 
 class OcppModel;
 class OcppMessage;
+class Transaction;
 
 class ConnectorStatus {
 private:
@@ -33,18 +35,6 @@ class ConnectorStatus {
     std::shared_ptr<Configuration<int>> availability;
     bool rebooting = false; //report connector inoperative and reject new charging sessions
 
-    bool session = false;
-    char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
-    bool idTagInvalidated {false}; //if StartTransaction.conf() has status != "Accepted"
-    std::shared_ptr<Configuration<const char *>> sIdTag;
-    std::shared_ptr<Configuration<int>> transactionId;
-    int transactionIdSync = -1;
-    char endReason [REASON_LEN_MAX + 1] = {'\0'};
-
-    std::shared_ptr<Configuration<int>> connectionTimeOut; //in seconds
-    bool connectionTimeOutListen {false};
-    ulong connectionTimeOutTimestamp {0}; //in milliseconds
-
     std::function<bool()> connectorPluggedSampler;
     std::function<bool()> evRequestsEnergySampler;
     std::function<bool()> connectorEnergizedSampler;
@@ -58,13 +48,12 @@ class ConnectorStatus {
 
     std::function<PollResult<bool>()> onUnlockConnector;
 
-    std::function<TxEnableState(TxCondition)> onConnectorLockPollTx;
-    std::function<TxEnableState(TxCondition)> onOcmfMeterPollTx;
+    std::function<TxEnableState(TxTrigger)> onConnectorLockPollTx;
+    std::function<TxEnableState(TxTrigger)> onOcmfMeterPollTx;
 
-    std::vector<std::function<TxCondition()>> txTriggerConditions;
-    std::vector<std::function<TxEnableState(TxCondition)>> txEnableSequence;
-    TxEnableState txEnable {TxEnableState::Inactive}; // = Result of Trigger and Enable Sequence
+    TransactionProcess txProcess;
 
+    std::shared_ptr<Configuration<int>> connectionTimeOut; //in seconds
     std::shared_ptr<Configuration<const char*>> stopTransactionOnInvalidId;
     std::shared_ptr<Configuration<const char*>> stopTransactionOnEVSideDisconnect;
     std::shared_ptr<Configuration<const char*>> unlockConnectorOnEVSideDisconnect;
@@ -85,14 +74,10 @@ class ConnectorStatus {
      */
     void beginSession(const char *idTag);
     void endSession(const char *reason = nullptr);
-    void setIdTagInvalidated(); //if StartTransaction.conf() has status != "Accepted"
     const char *getSessionIdTag();
     uint16_t getSessionWriteCount();
     int getTransactionId();
     int getTransactionIdSync();
-    uint16_t getTransactionWriteCount();
-    void setTransactionId(int id);
-    void setTransactionIdSync(int id);
 
     int getAvailability();
     void setAvailability(bool available);
@@ -104,7 +89,6 @@ class ConnectorStatus {
     void addConnectorErrorCodeSampler(std::function<const char*()> connectorErrorCode);
 
     void saveState();
-    //void recoverState();
 
     OcppMessage *loop();
 
@@ -115,8 +99,8 @@ class ConnectorStatus {
     void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector);
     std::function<PollResult<bool>()> getOnUnlockConnector();
 
-    void setConnectorLock(std::function<TxEnableState(TxCondition)> lockConnector);
-    void setTxBasedMeterUpdate(std::function<TxEnableState(TxCondition)> updateTxBasedMeter);
+    void setConnectorLock(std::function<TxEnableState(TxTrigger)> lockConnector);
+    void setTxBasedMeterUpdate(std::function<TxEnableState(TxTrigger)> updateTxBasedMeter);
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h
index d73b3310..9a503718 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h
@@ -11,7 +11,12 @@ namespace ArduinoOcpp {
  * Type definitions for extending the transaction initiation process
  */
 
-enum class TxCondition {
+enum class TxPrecondition {
+    Active,
+    Inactive
+};
+
+enum class TxTrigger {
     Active,
     Inactive
 };
diff --git a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
new file mode 100644
index 00000000..e72d0c73
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
@@ -0,0 +1,29 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
+#include <ArduinoOcpp/Debug.h>
+
+using namespace ArduinoOcpp;
+
+void OrderedOperationsQueue::addOcppOperation(uint seqNr, std::unique_ptr<OcppOperation> op) {
+    operations.push_back(std::pair<uint, std::unique_ptr<OcppOperation>>{seqNr, std::move(op)});
+}
+
+void OrderedOperationsQueue::sort(uint seqEnd) {
+    std::sort(operations.begin(), operations.end(), [seqEnd] (std::pair<uint, std::unique_ptr<OcppOperation>>& a, std::pair<uint, std::unique_ptr<OcppOperation>>& b) {
+        uint da = (seqEnd - a.first + MAX_TXEVENT_CNT) % MAX_TXEVENT_CNT; //distance between a to seqEnd
+        uint db = (seqEnd - b.first + MAX_TXEVENT_CNT) % MAX_TXEVENT_CNT;
+        return da > db; //sort descending by distance to seqEnd <=> sort ascending by seqNr
+    });
+}
+
+void OrderedOperationsQueue::moveTo(std::vector<std::unique_ptr<OcppOperation>>& dst) {
+    for (auto el = operations.begin(); el != operations.end(); el++) {
+        dst.emplace_back(std::move(el->second));
+    }
+
+    operations.clear();
+}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h
new file mode 100644
index 00000000..52a9563f
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h
@@ -0,0 +1,28 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef OPERATIONSQUEUE_H
+#define OPERATIONSQUEUE_H
+
+#include <vector>
+#include <memory>
+#include <ArduinoOcpp/Core/OcppOperation.h>
+
+namespace ArduinoOcpp {
+
+class OrderedOperationsQueue {
+private:
+    std::vector<std::pair<uint, std::unique_ptr<OcppOperation>>> operations;
+public:
+
+    void addOcppOperation(uint seqNr, std::unique_ptr<OcppOperation> op);
+
+    void sort(uint seqEnd); //sort and take seqEnd as largest order number
+
+    void moveTo(std::vector<std::unique_ptr<OcppOperation>>& dst); //move contents of operations to dst
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
new file mode 100644
index 00000000..337a2d66
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -0,0 +1,218 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
+
+#include <ArduinoOcpp/Debug.h>
+
+using namespace ArduinoOcpp;
+
+void TransactionRPC::requestWithMsgId(int msgId) {
+    context.setInitiatedMsgId(seqNr, msgId);
+}
+
+bool TransactionRPC::serializeSessionState(JsonObject rpc) {
+    rpc["requested"] = requested;
+    if (requested) {
+        rpc["seqNr"] = seqNr;
+    }
+    rpc["confirmed"] = confirmed;
+    return true;
+}
+
+bool Transaction::serializeSessionState(DynamicJsonDocument& out) {
+    out = DynamicJsonDocument(1024);
+    JsonObject state = out.to<JsonObject>();
+
+    JsonObject sessionState = state.createNestedObject("session");
+    if (session.idTag[0] != '\0') {
+        sessionState["idTag"] = session.idTag;
+    }
+    if (session.timestamp > MIN_TIME) {
+        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+        session.timestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
+        sessionState["timestamp"] = timeStr;
+    }
+    if (session.txProfileId >= 0) {
+        sessionState["txProfileId"] = session.txProfileId;
+    }
+    if (!session.active) {
+        sessionState["active"] = session.active;
+    }
+
+    JsonObject txStart = state.createNestedObject("start");
+
+    JsonObject txStartRPC = txStart.createNestedObject("rpc");
+    if (!start.rpc.serializeSessionState(txStartRPC)) {
+        return false;
+    }
+
+    JsonObject txStartClientSide = txStart.createNestedObject("client");
+
+    if (start.client.timestamp > MIN_TIME) {
+        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+        start.client.timestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
+        txStartClientSide["timestamp"] = timeStr;
+    }
+
+    if (start.client.meter >= 0) {
+        txStartClientSide["meter"] = start.client.meter;
+    }
+
+
+    if (start.rpc.confirmed) {
+        JsonObject txStartServerSide = txStart.createNestedObject("server");
+        txStartServerSide["transactionId"] = start.server.transactionId;
+        txStartServerSide["authorized"] = start.server.authorized;
+    }
+
+    JsonObject txStop = state.createNestedObject("stop");
+
+    JsonObject txStopRPC = txStop.createNestedObject("rpc");
+    if (!stop.rpc.serializeSessionState(txStopRPC)) {
+        return false;
+    }
+
+    JsonObject txStopClientSide = txStop.createNestedObject("client");
+
+    if (stop.client.timestamp > MIN_TIME) {
+        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+        stop.client.timestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
+        txStopClientSide["timestamp"] = timeStr;
+    }
+
+    if (stop.client.meter >= 0) {
+        txStopClientSide["meter"] = stop.client.meter;
+    }
+
+    if (stop.client.idTag[0] != '\0') {
+        txStopClientSide["idTag"] = stop.client.idTag;
+    }
+
+    if (stop.client.reason[0] != '\0') {
+        txStopClientSide["reason"] = stop.client.reason;
+    }
+
+    //if (stop.rpc.confirmed) {
+    //    JsonObject txStopServerSide = txStop.createNestedObject("server");
+    //}
+
+    if (out.overflowed()) {
+        AO_DBG_ERR("JSON capacity exceeded");
+        return false;
+    }
+
+    return true;
+}
+
+bool TransactionRPC::deserializeSessionState(JsonObject rpc) {
+    if (rpc["requested"] | false) {
+        requested = true;
+        seqNr = rpc["seqNr"] | 0;
+    }
+    if (rpc["confirmed"] | false) {
+        confirmed = true;
+    }
+    return true;
+}
+
+bool Transaction::deserializeSessionState(JsonObject state) {
+
+    JsonObject sessionState = state["session"];
+
+    if (sessionState.containsKey("idTag")) {
+        if (snprintf(session.idTag, sizeof(session.idTag), "%s", sessionState["idTag"] | "") < 0) {
+            AO_DBG_ERR("Read err");
+            return false;
+        }
+    }
+    if (sessionState.containsKey("timestamp")) {
+        session.timestamp.setTime(sessionState["timestamp"] | "Invalid");
+    }
+    if (sessionState.containsKey("txProfileId")) {
+        session.txProfileId = sessionState["txProfileId"] | -1;
+    }
+    if (sessionState.containsKey("active")) {
+        session.active = sessionState["active"] | true;
+    }
+
+    JsonObject txStart = state["start"];
+
+    if (txStart.containsKey("rpc")) {
+        JsonObject txStartRPC = txStart["rpc"];
+        AO_DBG_DEBUG("Deserialize RPC. Raw:")
+        serializeJson(txStartRPC, Serial);
+        Serial.println();
+        if (!start.rpc.deserializeSessionState(txStartRPC)) {
+            return false;
+        }
+    }
+
+    JsonObject txStartClientSide = txStart["client"];
+
+    if (txStartClientSide.containsKey("timestamp")) {
+        start.client.timestamp.setTime(txStartClientSide["timestamp"] | "Invalid");
+    }
+
+    if (txStartClientSide.containsKey("meter")) {
+        start.client.meter = txStartClientSide["meter"] | 0;
+    }
+
+    if (start.rpc.confirmed) {
+        JsonObject txStartServerSide = txStart["server"];
+        start.server.transactionId = txStartServerSide["transactionId"] | -1;
+        start.server.authorized = txStartServerSide["authorized"] | false;
+    }
+
+    JsonObject txStop = state["stop"];
+
+    if (txStop.containsKey("rpc")) {
+        JsonObject txStopRPC = txStop["rpc"];
+        if (!stop.rpc.deserializeSessionState(txStopRPC)) {
+            return false;
+        }
+    }
+
+    JsonObject txStopClientSide = txStop["client"];
+
+    if (txStopClientSide.containsKey("timestamp")) {
+        stop.client.timestamp.setTime(txStopClientSide["timestamp"] | "Invalid");
+    }
+
+    if (txStopClientSide.containsKey("meter")) {
+        stop.client.meter = txStopClientSide["meter"] | 0;
+    }
+
+    if (txStopClientSide.containsKey("idTag")) {
+        if (snprintf(stop.client.idTag, sizeof(stop.client.idTag), "%s", txStopClientSide["idTag"] | "") < 0) {
+            AO_DBG_ERR("Read err");
+            return false;
+        }
+    }
+
+    if (txStopClientSide.containsKey("reason")) {
+        if (snprintf(stop.client.reason, sizeof(stop.client.reason), "%s", txStopClientSide["reason"] | "") < 0) {
+            AO_DBG_ERR("Read err");
+            return false;
+        }
+    }
+
+    AO_DBG_DEBUG("DUMP TX");
+    AO_DBG_DEBUG("Session   | idTag %s", session.idTag);
+    AO_DBG_DEBUG("Start RPC | req: %i, seq: %u, conf: %i", start.rpc.requested, start.rpc.seqNr, start.rpc.confirmed);
+    AO_DBG_DEBUG("Stop  RPC | req: %i, seq: %u, conf: %i",  stop.rpc.requested,  stop.rpc.seqNr,  stop.rpc.confirmed);
+
+    //if (stop.rpc.confirmed) {
+    //    JsonObject txStopServerSide = txStop["server"];
+    //}
+
+    return true;
+}
+
+bool Transaction::commit() {
+    return context.getTransactionStore().commit(this);
+}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
new file mode 100644
index 00000000..f5336b1b
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -0,0 +1,196 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef TRANSACTION_H
+#define TRANSACTION_H
+
+#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <memory>
+#include <ArduinoJson.h>
+
+namespace ArduinoOcpp {
+
+/*
+ * A transaction is initiated by the client (charging station) and processed by the server (central system).
+ * The client side of a transaction is all data that is generated or collected at the charging station. The
+ * server side is all transaction data that is assigned by the central system.
+ * 
+ * "ClientTransaction" is short for the client-side data, and the same goes for "ServerTranaction". The rest
+ * of the terminology is documented in OCPP 1.6 Specification - Edition 2, sections 3.6, 4.8, 4.10 and 5.11. 
+ */
+
+class TransactionService;
+
+class TransactionRPC {
+private:
+    friend class Transaction;
+
+    TransactionService& context;
+    
+    uint seqNr = 0;
+    bool requested = false;
+    bool confirmed = false;
+
+    bool serializeSessionState(JsonObject out);
+    bool deserializeSessionState(JsonObject in);
+public:
+    TransactionRPC(TransactionService& context) : context(context) { }
+
+    void requestWithMsgId(int msgId);
+
+    void setRequested(uint seqNr) {
+        this->seqNr = seqNr;
+        this->requested = true;
+    }
+    bool isRequested() {return requested;}
+    uint getSeqNr() {return seqNr;}
+    void confirm() {confirmed = true;}
+    bool isConfirmed() {return confirmed;}
+    bool isCompleted() {return isRequested() && isConfirmed();}
+};
+
+class ClientTransactionStart {
+private:
+    friend class Transaction;
+
+    OcppTimestamp timestamp = MIN_TIME;      //timestamp of StartTx; can be set before actually initiating
+    int32_t meter = -1;           //meterStart of StartTx
+};
+
+class ServerTransactionStart {
+private:
+    friend class Transaction;
+
+    bool authorized = true;      //authorization status; only valid if confirmed = true
+    int transactionId = -1; //only valid if confirmed = true
+};
+
+class TransactionStart {
+private:
+    friend class Transaction;
+    
+    TransactionRPC rpc;
+    ClientTransactionStart client;
+    ServerTransactionStart server;
+public:
+    TransactionStart(TransactionService& context) : rpc(context) { }
+};
+
+class ClientTransactionStop {
+private:
+    friend class Transaction;
+
+    char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
+    OcppTimestamp timestamp = MIN_TIME;
+    int32_t meter = -1;
+    char reason [REASON_LEN_MAX + 1] = {'\0'};
+};
+
+class ServerTransactionStop {
+//no data at the moment
+};
+
+class TransactionStop {
+private:
+    friend class Transaction;
+
+    TransactionRPC rpc;
+    ClientTransactionStop client;
+    ServerTransactionStop server;
+public:
+    TransactionStop(TransactionService& context) : rpc(context) { }
+};
+
+class ChargingSession {
+private:
+    friend class Transaction;
+    
+    char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
+    OcppTimestamp timestamp = MIN_TIME;
+    int txProfileId = -1;
+
+    bool active = true;         //true: ignore
+                                //false before StartTx init: abort 
+                                //false between StartTx init and StopTx init: end
+                                //false after StopTx init: ignore
+};
+
+class Transaction {
+private:
+    TransactionService& context;
+
+    ChargingSession session;      //data that exists before the tx
+    TransactionStart start;
+    TransactionStop stop;
+
+    int connectorId = -1;
+    uint txNr = 0; //only valid if session.connectorId is >= 0
+public:
+    Transaction(TransactionService& context, uint connectorId, uint txNr) : 
+                context(context), 
+                start(context),
+                stop(context),
+                connectorId(connectorId), 
+                txNr(txNr) {}
+
+    bool serializeSessionState(DynamicJsonDocument& out);
+    bool deserializeSessionState(JsonObject in);
+
+    int getConnectorId() {return connectorId;}
+    void setConnectorId(uint connectorId) {this->connectorId = connectorId;}
+    uint getTxNr() {return txNr;} //only valid if getConnectorId() >= 0
+    void setTxNr(uint txNr) {this->txNr = txNr;}
+
+    TransactionRPC& getStartRpcSync() {return start.rpc;}
+
+    TransactionRPC& getStopRpcSync() {return stop.rpc;}
+
+    bool isAborted() {return !start.rpc.requested && !session.active;}
+    bool isCompleted() {return start.rpc.isRequested() && start.rpc.isConfirmed() &&
+                               stop.rpc.isRequested()  && stop.rpc.isConfirmed();}
+    bool isPending() {return !isAborted() && !isCompleted();}
+    bool isPreparing() {return session.active && !start.rpc.isRequested() && !stop.rpc.isRequested();}
+    bool isRunning() {return start.rpc.isRequested() && !stop.rpc.isRequested();}
+    bool isActive() {return session.active && !stop.rpc.isRequested();}
+    bool isInSession() {return isActive() && *session.idTag;}
+
+    const char *getIdTag() {return session.idTag;} //only for testing in StartTx.req
+    void setIdTag(const char *idTag) {snprintf(session.idTag, IDTAG_LEN_MAX + 1, "%s", idTag);}
+    OcppTimestamp& getSessionTimestamp() {return session.timestamp;}
+    void setSessionTimestamp(OcppTimestamp timestamp) {session.timestamp = timestamp;}
+
+    const char *getStopReason() {return stop.client.reason;}
+    void setStopReason(const char *reason) {snprintf(stop.client.reason, REASON_LEN_MAX + 1, "%s", reason);}
+    void endSession() {session.active = false;}
+
+    void setIdTagDeauthorized() {start.server.authorized = false;}
+    bool isIdTagDeauthorized() {return start.rpc.isConfirmed() && !start.server.authorized;}
+
+    int getTransactionId() {return start.server.transactionId;}
+    void setTransactionId(int transactionId) {start.server.transactionId = transactionId;}
+
+    void setMeterStart(int32_t meter) {start.client.meter = meter;}
+    bool isMeterStartDefined() {return start.client.meter >= 0;} //should introduce extra variable later
+    int32_t getMeterStart() {return start.client.meter;}
+
+    void setStartTimestamp(OcppTimestamp timestamp) {start.client.timestamp = timestamp;}
+    OcppTimestamp& getStartTimestamp() {return start.client.timestamp;}
+
+    void setMeterStop(int32_t meter) {stop.client.meter = meter;}
+    bool isMeterStopDefined() {return stop.client.meter >= 0;} //should introduce extra variable later
+    int32_t getMeterStop() {return stop.client.meter;}
+
+    void setStopTimestamp(OcppTimestamp timestamp) {stop.client.timestamp = timestamp;}
+    OcppTimestamp& getStopTimestamp() {return stop.client.timestamp;}
+
+    const char *getStopIdTag() {return stop.client.idTag;} //only for testing in StartTx.req
+    void setStopIdTag(const char *idTag) {snprintf(stop.client.idTag, IDTAG_LEN_MAX + 1, "%s", idTag);}
+
+    bool commit();
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
new file mode 100644
index 00000000..fe31d2dd
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
@@ -0,0 +1,113 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Transactions/TransactionProcess.h>
+
+#include <ArduinoOcpp/Debug.h>
+
+#define AO_TXPROC_FN AO_FILENAME_PREFIX "/txproc.cnf"
+
+using namespace ArduinoOcpp;
+
+TransactionProcess::TransactionProcess(uint connectorId) {
+    char key [30] = {'\0'};
+    if (snprintf(key, 30, "AO_txNrRef_%u", connectorId) < 0) {
+        AO_DBG_ERR("Invalid key");
+        (void)0;
+    }
+    txNrRef = declareConfiguration<int>(key, 0, AO_TXPROC_FN, false, false, true, false);
+    if (!txNrRef || *txNrRef < 0) {
+        AO_DBG_ERR("Initialization failure");
+    }
+}
+
+/*
+ * Evaluate the preconditions and triggers. If all are Active, then execute the transaction enable sequence.
+ * That is an ordered sequence of preparation steps which must be true before the transaction can start. When
+ * the transaction is finished, disable the preparation steps in reversed order.
+ * 
+ * txEnable is the output variable. See getState() for getting the result.
+ */
+void TransactionProcess::evaluateProcessSteps(uint txNr) {
+
+#if AO_DBG_LEVEL >= AO_DL_DEBUG
+    //print transitions to debug console
+    TxEnableState txEnableBefore = txEnable;
+#endif
+
+    //Check Tx preconditions: Tx is only possible if all of them are true; search for a false precondition
+    auto txPrecondition = TxPrecondition::Active;
+    for (auto cond : txPreconditions) {
+        if (cond() != TxPrecondition::Active) {
+            txPrecondition = TxPrecondition::Inactive;
+            break;
+        }
+    }
+
+    //Check Tx triggers: all of them need to be true to trigger a tx; prepare that search here
+    auto txTrigger = txTriggers.empty() ? TxTrigger::Inactive : TxTrigger::Active;
+    if (txPrecondition != TxPrecondition::Active) { //Only trigger a tx if the preconditions are met
+        txTrigger = TxTrigger::Inactive;
+    }
+
+    //Check if the current process is obsolete
+    if (txNrRef && (uint) *txNrRef != txNr) {
+        txTrigger = TxTrigger::Inactive;
+    }
+
+    //Determine if
+    // - No trigger is active      -> activeTriggerExists = false, txTrigger = Inactive
+    // - All triggers are active   -> activeTriggerExists = true,  txTrigger = Active
+    // - Some are active, some not -> activeTriggerExists = true,  txTrigger = Inactive
+    activeTriggerExists = false;
+    for (auto trigger = txTriggers.begin(); trigger != txTriggers.end(); trigger++) {
+        auto result = trigger->operator()();
+        if (result == TxTrigger::Active) {
+            activeTriggerExists = true;
+        } else {
+            txTrigger = TxTrigger::Inactive;
+        }
+    }
+
+    //Also check if all devices on the charger are enabled for the Tx
+    if (txTrigger == TxTrigger::Active) { //Search for an unready device
+        txEnable = TxEnableState::Active;
+
+        for (auto step = txEnableSequence.rbegin(); step != txEnableSequence.rend(); step++) {
+            auto result = step->operator()(TxTrigger::Active);
+            if (result != TxEnableState::Active) {
+                txEnable = TxEnableState::Pending;
+                break;
+            }
+        }
+    } else { //Search for a device that is still enabled
+        txEnable = TxEnableState::Inactive;
+
+        for (auto step = txEnableSequence.begin(); step != txEnableSequence.end(); step++) {
+            auto result = step->operator()(TxTrigger::Inactive);
+            if (result != TxEnableState::Inactive) {
+                txEnable = TxEnableState::Pending;
+                break;
+            }
+        }
+    }
+
+    //If the current process is obsolete: Check if updating the tx reference is possible
+    if (txNrRef && (uint) *txNrRef != txNr) {
+        if (txEnable == TxEnableState::Inactive) {
+            AO_DBG_DEBUG("Upgrade to next tx: %u", txNr);
+            *txNrRef = txNr;
+            configuration_save();
+        }
+    }
+
+#if AO_DBG_LEVEL >= AO_DL_DEBUG
+    if (txEnableBefore != txEnable) {
+        AO_DBG_DEBUG("Transition from %s to %s",
+                    txEnableBefore == TxEnableState::Active ? "Active" : txEnableBefore == TxEnableState::Inactive ? "Inactive" : "Pending",
+                    txEnable == TxEnableState::Active ? "Active" : txEnable == TxEnableState::Inactive ? "Inactive" : "Pending");
+    }
+#endif
+
+}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
new file mode 100644
index 00000000..6240bb24
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
@@ -0,0 +1,46 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef TRANSACTIONPROCESS_H
+#define TRANSACTIONPROCESS_H
+
+#include <ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+
+#include <vector>
+#include <functional>
+
+namespace ArduinoOcpp {
+
+class TransactionProcess {
+private:
+    
+    std::vector<std::function<TxPrecondition()>> txPreconditions;
+    std::vector<std::function<TxTrigger()>> txTriggers;
+    std::vector<std::function<TxEnableState(TxTrigger)>> txEnableSequence;
+
+    bool activeTriggerExists = false;
+    TxEnableState txEnable {TxEnableState::Inactive}; // = Result of Trigger and Enable Sequence
+
+    std::shared_ptr<Configuration<int>> txNrRef;
+    
+public:
+
+    TransactionProcess(uint connectorId);
+
+    void addPrecondition(std::function<TxPrecondition()> fn) {txPreconditions.push_back(fn);}
+
+    void addTrigger(std::function<TxTrigger()> fn) {txTriggers.push_back(fn);}
+
+    void addEnableStep(std::function<TxEnableState(TxTrigger)> fn) {txEnableSequence.push_back(fn);}
+
+    void evaluateProcessSteps(uint txNr);
+
+    bool existsActiveTrigger() {return activeTriggerExists;}
+    TxEnableState getState() {return txEnable;}
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp
new file mode 100644
index 00000000..b6809892
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp
@@ -0,0 +1,29 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
+
+#include <ArduinoOcpp/Debug.h>
+
+#define AO_TXSEQ_FN AO_FILENAME_PREFIX "/txseq.cnf"
+
+using namespace ArduinoOcpp;
+
+TransactionSequence::TransactionSequence() {
+
+    seqEnd = declareConfiguration<int>("AO_SEQEND", 0, AO_TXSEQ_FN, false, false, true, false);
+}
+
+uint TransactionSequence::getSeqEnd() {
+    return *seqEnd;
+}
+
+uint TransactionSequence::reserveSeqNr() {
+    uint seq = (uint) *seqEnd;
+    uint seqIncr = (seq + 1U) % MAX_TXEVENT_CNT;
+    *seqEnd = seqIncr;
+    configuration_save();
+    return seq;
+}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.h
new file mode 100644
index 00000000..76856ce0
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.h
@@ -0,0 +1,28 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef TRANSACTIONSEQUENCE_H
+#define TRANSACTIONSEQUENCE_H
+
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <vector>
+
+#define MAX_TXEVENT_CNT 100000U
+
+namespace ArduinoOcpp {
+
+class TransactionSequence {
+private:
+    std::shared_ptr<Configuration<int>> seqEnd; //one place after last event
+public:
+    TransactionSequence();
+
+    uint getSeqEnd();
+
+    uint reserveSeqNr();
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
new file mode 100644
index 00000000..b5dc1320
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
@@ -0,0 +1,74 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
+#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/OcppOperation.h>
+#include <ArduinoOcpp/Debug.h>
+
+using namespace ArduinoOcpp;
+
+#define AO_TXSERV_FN AO_FILENAME_PREFIX "/txserv.cnf"
+
+TransactionService::TransactionService(OcppEngine& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) : 
+        context(context),
+        txStore(*this, nConnectors, filesystem) {
+    
+    lastInitiatedSeqNr = declareConfiguration<int>("LastSeqNr", MAX_TXEVENT_CNT, AO_TXSERV_FN, false, false, true, false);
+    lastInitiatedMsgCnt = declareConfiguration<int>("LastMsgId", 1100000, AO_TXSERV_FN, false, false, true, false);
+
+    txStore.restorePendingTransactions();
+    txStore.submitPendingOperations();
+}
+
+void TransactionService::addRestoredOperation(uint seqNr, std::unique_ptr<OcppOperation> o) {
+    if (restoredOpsInitiated) {
+        AO_DBG_ERR("Can only restore at initialization. Abort");
+        return;
+    }
+    if (seqNr == (uint) *lastInitiatedSeqNr) {
+        AO_DBG_DEBUG("Rebase msgIds: %i", (int) *lastInitiatedMsgCnt);
+        o->rebaseMsgId(*lastInitiatedMsgCnt);
+    }
+    restoredOps.addOcppOperation(seqNr, std::move(o));
+}
+
+void TransactionService::initiateRestoredOperations() {
+    if (restoredOpsInitiated) {
+        AO_DBG_ERR("Called two times. Abort");
+        return;
+    }
+
+    restoredOps.sort(txSequence.getSeqEnd());
+
+    std::vector<std::unique_ptr<OcppOperation>> res;
+
+    restoredOps.moveTo(res);
+
+    for (auto operation = res.begin(); operation != res.end(); operation++) {
+        context.initiateOperation(std::move(*operation));
+    }
+    res.clear();
+
+    restoredOpsInitiated = true;
+}
+
+void TransactionService::setInitiatedMsgId(uint seqNr, int msgId) {
+    if (seqNr >= MAX_TXEVENT_CNT) {
+        AO_DBG_ERR("Invalid params");
+        return;
+    }
+    if (*lastInitiatedSeqNr == seqNr && *lastInitiatedMsgCnt == msgId) {
+        //Nothing to update
+        return;
+    }
+
+    AO_DBG_DEBUG("Set tx-related msg Id");
+    *lastInitiatedSeqNr = seqNr;
+    *lastInitiatedMsgCnt = msgId;
+    configuration_save();
+}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.h
new file mode 100644
index 00000000..93cd63c3
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.h
@@ -0,0 +1,44 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef TRANSACTIONSERVICE_H
+#define TRANSACTIONSERVICE_H
+
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
+#include <ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h>
+#include <memory>
+
+namespace ArduinoOcpp {
+
+class OcppEngine;
+class FilesystemAdapter;
+class OcppOperation;
+
+class TransactionService {
+private:
+    OcppEngine& context;
+
+    TransactionSequence txSequence;
+    TransactionStore txStore;
+    OrderedOperationsQueue restoredOps;//restore pending operations from flash in case of a power loss
+    bool restoredOpsInitiated = false;
+
+    std::shared_ptr<Configuration<int>> lastInitiatedSeqNr;
+    std::shared_ptr<Configuration<int>> lastInitiatedMsgCnt; //use this msgId for the current initiated operation
+public:
+    TransactionService(OcppEngine& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+
+    void addRestoredOperation(uint seqNr, std::unique_ptr<OcppOperation> op);
+    void initiateRestoredOperations();
+
+    void setInitiatedMsgId(uint seqNr, int msgId);
+
+    TransactionStore& getTransactionStore() {return txStore;}
+    TransactionSequence& getTransactionSequence() {return txSequence;}
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
new file mode 100644
index 00000000..8deeea6d
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -0,0 +1,308 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
+#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
+#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
+
+#include <ArduinoOcpp/Debug.h>
+
+using namespace ArduinoOcpp;
+
+#ifndef AO_TXSTORE_DIR
+#define AO_TXSTORE_DIR AO_FILENAME_PREFIX "/"
+#endif
+
+#define AO_TXSTORE_META_FN AO_FILENAME_PREFIX "/txstore.jsn"
+
+#define MAX_QUEUE_SIZE 20U
+#define MAX_TX_CNT 100000U
+
+ConnectorTransactionStore::ConnectorTransactionStore(TransactionService& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
+        context(context),
+        connectorId(connectorId),
+        filesystem(filesystem) {
+
+    char key [30] = {'\0'};
+    if (snprintf(key, 30, "AO_txBegin_%u", connectorId) < 0) {
+        AO_DBG_ERR("Invalid key");
+        (void)0;
+    }
+    txBegin = declareConfiguration<int>(key, 0, AO_TXSTORE_META_FN, false, false, true, false);
+}
+
+void ConnectorTransactionStore::restorePendingTransactions() {
+
+    if (!filesystem) {
+        AO_DBG_ERR("FS error");
+        return;
+    }
+
+    if (!txBegin || *txBegin < 0 || *txBegin > MAX_TX_CNT) {
+        AO_DBG_ERR("Invalid state");
+        return;
+    }
+
+    uint tx = *txBegin;
+    txEnd = tx;
+
+    const uint MISSES_LIMIT = 3;
+    uint misses = 0;
+
+    while (misses < MISSES_LIMIT) { //search until region without txs found
+
+        char fn [MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, tx);
+        if (ret < 0 || ret >= MAX_PATH_SIZE) {
+            AO_DBG_ERR("fn error: %i", ret);
+            break; //all files have same length
+        }
+
+        auto doc = FilesystemUtils::loadJson(filesystem, fn);
+
+        if (!doc) {
+            misses++;
+            tx++;
+            tx %= MAX_TX_CNT;
+            continue;
+        }
+
+        std::shared_ptr<Transaction> transaction = std::make_shared<Transaction>(context, connectorId, tx);
+        JsonObject txJson = doc->as<JsonObject>();
+        if (!transaction->deserializeSessionState(txJson)) {
+            AO_DBG_ERR("Deserialization error");
+            misses++;
+            tx++;
+            tx %= MAX_TX_CNT;
+            continue;
+        }
+
+        if (!transaction->isPending()) {
+            AO_DBG_DEBUG("Drop aborted / finished tx");
+            tx++;
+            tx %= MAX_TX_CNT;
+            continue; //normal behavior => don't increment misses
+        }
+
+        transactions.push_back(std::move(transaction));
+
+        tx++;
+        tx %= MAX_TX_CNT;
+        txEnd = tx;
+        misses = 0;
+
+        if (transactions.size() > MAX_QUEUE_SIZE) { //allow to exceed MAX_QUEUE_SIZE by 1
+            AO_DBG_ERR("txBegin out of sync");
+            break;
+        }
+    }
+
+    AO_DBG_DEBUG("Restored %zu transactions", transactions.size());
+}
+
+void ConnectorTransactionStore::submitPendingOperations() {
+    for (auto& tx : transactions) {
+        
+        auto& startRpc = tx->getStartRpcSync();
+        if (startRpc.isRequested() && !startRpc.isConfirmed()) {
+            //startTx has been initiated, but not been confirmed yet
+            AO_DBG_DEBUG("Restore StartTx, connectorId=%i, seqNr=%u", connectorId, startRpc.getSeqNr());
+
+            auto startOp = makeOcppOperation(new Ocpp16::StartTransaction(tx));
+            context.addRestoredOperation(startRpc.getSeqNr(), std::move(startOp));
+        }
+
+        auto& stopRpc = tx->getStopRpcSync();
+        if (stopRpc.isRequested() && !stopRpc.isConfirmed()) {
+            //stopTx has been initiated, but not been confirmed yet
+            AO_DBG_DEBUG("Restore StopTx, connectorId=%i, seqNr=%u", connectorId, stopRpc.getSeqNr());
+
+            //... add stop data
+
+            auto stopOp = makeOcppOperation(new Ocpp16::StopTransaction(tx));
+            context.addRestoredOperation(stopRpc.getSeqNr(), std::move(stopOp));
+        }
+    }
+}
+
+std::shared_ptr<Transaction> ConnectorTransactionStore::makeTransaction() {
+
+    if (!filesystem) {
+        AO_DBG_ERR("Invalid state");
+        return nullptr;
+    }
+
+    if (transactions.size() >= MAX_QUEUE_SIZE) {
+        AO_DBG_WARN("Queue full");
+        return nullptr;
+    }
+
+    auto transaction = std::make_shared<Transaction>(context, connectorId, txEnd);
+    txEnd++;
+    txEnd %= MAX_TX_CNT;
+
+    transactions.push_back(transaction);
+
+    if (!commit(transaction.get())) {
+        std::remove_if(transactions.begin(), transactions.end(),
+            [&transaction] (const std::shared_ptr<Transaction>& el) {
+                return el == transaction;
+            }
+        );
+        txEnd--;
+        txEnd += MAX_TX_CNT;
+        txEnd %= MAX_TX_CNT;
+        return nullptr;
+    }
+
+    return transaction;
+}
+
+std::shared_ptr<Transaction> ConnectorTransactionStore::getActiveTransaction() {
+    
+    if (!transactions.empty()) {
+        auto& tx = transactions.back();
+        if (tx->isActive() || tx->isRunning()) {
+            return tx;
+        }
+    }
+
+    AO_DBG_DEBUG("Make new Tx");
+
+    auto tx = makeTransaction();
+    if (tx) {
+        tx->setConnectorId(connectorId);
+    }
+
+    return tx;
+}
+
+std::shared_ptr<Transaction> ConnectorTransactionStore::getTransactionSync() {
+    
+    if (!transactions.empty()) {
+        auto& tx = transactions.front();
+        if (tx->isRunning()) {
+            return tx;
+        }
+    }
+
+    return nullptr;
+}
+
+bool ConnectorTransactionStore::commit(Transaction *transaction) {
+    if (transactions.empty()) {
+        AO_DBG_ERR("Dangling transaction");
+        return false;
+    }
+
+    auto found = transactions.end();
+    if (transaction == (transactions.end() - 1)->get()) { //optimization: check if committing the last container element
+        found = transactions.end() - 1;
+    } else {
+        for (auto entry = transactions.begin(); entry != transactions.end(); entry++) {
+            if (transaction == entry->get()) {
+                found = entry;
+                break;
+            }
+        }
+    }
+
+    if (found == transactions.end()) {
+        AO_DBG_ERR("Dangling transaction");
+        return false;
+    }
+
+    //confirmed that transaction points to an element in the transactions container
+
+    char fn [MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
+    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+        AO_DBG_ERR("fn error: %i", ret);
+        return false; //all files have same length
+    }
+    
+    DynamicJsonDocument txDoc {0};
+    if (!transaction->serializeSessionState(txDoc)) {
+        AO_DBG_ERR("Serialization error");
+        return false;
+    }
+
+    if (!FilesystemUtils::storeJson(filesystem, fn, txDoc)) {
+        AO_DBG_ERR("FS error");
+        return false;
+    }
+
+    //Data committed to memory; now update meta structures
+    
+    if (!transaction->isPending()) {
+        
+        AO_DBG_DEBUG("Drop completed transaction");
+        transactions.erase(found);
+        transaction = nullptr;
+        auto beginNew = txEnd;
+        if (!transactions.empty()) {
+            beginNew = transactions.front()->getTxNr();
+        }
+        if (beginNew != (uint) *txBegin) {
+            *txBegin = beginNew;
+            configuration_save();
+        }
+    }
+
+    //success
+    return true;
+}
+
+TransactionStore::TransactionStore(TransactionService& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
+    
+    for (uint i = 0; i < nConnectors; i++) {
+        connectors.push_back(std::unique_ptr<ConnectorTransactionStore>(
+            new ConnectorTransactionStore(context, i, filesystem)));
+    }
+}
+
+std::shared_ptr<Transaction> TransactionStore::getActiveTransaction(uint connectorId) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return nullptr;
+    }
+    return connectors[connectorId]->getActiveTransaction();
+}
+
+std::shared_ptr<Transaction> TransactionStore::getTransactionSync(uint connectorId) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return nullptr;
+    }
+    return connectors[connectorId]->getTransactionSync();
+}
+
+bool TransactionStore::commit(Transaction *transaction) {
+    if (!transaction) {
+        AO_DBG_ERR("Invalid arg");
+        return false;
+    }
+    auto connectorId = transaction->getConnectorId();
+    if (connectorId < 0 || connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid tx");
+        return false;
+    }
+    return connectors[connectorId]->commit(transaction);
+}
+
+void TransactionStore::restorePendingTransactions() {
+    for (auto& connector : connectors) {
+        connector->restorePendingTransactions();
+    }
+}
+
+void TransactionStore::submitPendingOperations() {
+    for (auto& connector : connectors) {
+        connector->submitPendingOperations();
+    }
+}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
new file mode 100644
index 00000000..cfffdfa4
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
@@ -0,0 +1,61 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef TRANSACTIONSTORE_H
+#define TRANSACTIONSTORE_H
+
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
+#include <deque>
+
+namespace ArduinoOcpp {
+
+class TransactionService;
+class ConnectorTransactionSequence;
+
+class ConnectorTransactionStore {
+private:
+    TransactionService& context;
+    const uint connectorId;
+
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    std::shared_ptr<Configuration<int>> txBegin; //The Tx file names are consecutively numbered; first number
+    uint txEnd; //one place after last number
+    
+    std::deque<std::shared_ptr<Transaction>> transactions;
+
+    std::shared_ptr<Transaction> makeTransaction();
+
+public:
+    ConnectorTransactionStore(TransactionService& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+    
+    std::shared_ptr<Transaction> getActiveTransaction();
+    std::shared_ptr<Transaction> getTransactionSync();
+    bool commit(Transaction *transaction);
+
+    void restorePendingTransactions();
+    void submitPendingOperations();
+};
+
+class TransactionStore {
+private:
+    std::vector<std::unique_ptr<ConnectorTransactionStore>> connectors;
+
+public:
+    TransactionStore(TransactionService& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+
+    //std::shared_ptr<Transaction> makeTransaction(uint connectorId);
+    std::shared_ptr<Transaction> getActiveTransaction(uint connectorId);
+    std::shared_ptr<Transaction> getTransactionSync(uint connectorId); //fron element of the tx queue; tx which is being executed at the server now
+    bool commit(Transaction *transaction);
+
+    void restorePendingTransactions();
+    void submitPendingOperations();
+};
+
+}
+
+#endif

From f833b1fc2687d6b42bec2588ae34ab9a7a456779 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 25 Aug 2022 21:14:10 +0200
Subject: [PATCH 052/549] fix signature

---
 src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
index e72d0c73..c622af73 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
@@ -13,7 +13,7 @@ void OrderedOperationsQueue::addOcppOperation(uint seqNr, std::unique_ptr<OcppOp
 }
 
 void OrderedOperationsQueue::sort(uint seqEnd) {
-    std::sort(operations.begin(), operations.end(), [seqEnd] (std::pair<uint, std::unique_ptr<OcppOperation>>& a, std::pair<uint, std::unique_ptr<OcppOperation>>& b) {
+    std::sort(operations.begin(), operations.end(), [seqEnd] (const std::pair<uint, std::unique_ptr<OcppOperation>>& a, const std::pair<uint, std::unique_ptr<OcppOperation>>& b) {
         uint da = (seqEnd - a.first + MAX_TXEVENT_CNT) % MAX_TXEVENT_CNT; //distance between a to seqEnd
         uint db = (seqEnd - b.first + MAX_TXEVENT_CNT) % MAX_TXEVENT_CNT;
         return da > db; //sort descending by distance to seqEnd <=> sort ascending by seqNr

From 7681ec7666dc80f076bf45d31ced1f4a4e4418cd Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 27 Aug 2022 23:51:52 +0200
Subject: [PATCH 053/549] allow access to internals via facade

---
 src/ArduinoOcpp.cpp | 9 +++++++++
 src/ArduinoOcpp.h   | 8 ++++++++
 2 files changed, 17 insertions(+)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 6b29a231..1de0dc77 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -637,3 +637,12 @@ ArduinoOcpp::DiagnosticsService *getDiagnosticsService() {
     return model.getDiagnosticsService();
 }
 #endif
+
+OcppEngine *getOcppEngine() {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return nullptr;
+    }
+
+    return ocppEngine;
+}
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index d8ffae91..d72cdbdf 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -199,4 +199,12 @@ ArduinoOcpp::FirmwareService *getFirmwareService();
 ArduinoOcpp::DiagnosticsService *getDiagnosticsService();
 #endif
 
+namespace ArduinoOcpp {
+class OcppEngine;
+}
+
+//Get access to internal functions and data structures. The returned OcppEngine object allows
+//you to bypass the facace functions of this header and implement custom functionality.
+ArduinoOcpp::OcppEngine *getOcppEngine();
+
 #endif

From 5f1a8c5d2c84caf6dd2669aa09e0e89de1708df3 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 28 Aug 2022 12:22:16 +0200
Subject: [PATCH 054/549] remove superfluous debug messages

---
 src/ArduinoOcpp/Core/FilesystemUtils.cpp           | 3 +--
 src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp | 3 ---
 2 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
index 390b6d6a..27056d73 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -70,8 +70,7 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
     }
 
     AO_DBG_DEBUG("Loaded JSON file: %s", fn);
-    serializeJson(*doc, Serial);
-    Serial.println();
+    
     return doc;
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index 337a2d66..cdee0f13 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -144,9 +144,6 @@ bool Transaction::deserializeSessionState(JsonObject state) {
 
     if (txStart.containsKey("rpc")) {
         JsonObject txStartRPC = txStart["rpc"];
-        AO_DBG_DEBUG("Deserialize RPC. Raw:")
-        serializeJson(txStartRPC, Serial);
-        Serial.println();
         if (!start.rpc.deserializeSessionState(txStartRPC)) {
             return false;
         }

From c280d6c35bb11dd575b0d04025724ed209674412 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 28 Aug 2022 12:22:47 +0200
Subject: [PATCH 055/549] allow to initialize with multiple connectors

---
 src/ArduinoOcpp.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 1de0dc77..3b2902ea 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -37,7 +37,10 @@ std::shared_ptr<FilesystemAdapter> filesystem;
 FilesystemOpt fileSystemOpt {};
 float voltage_eff {230.f};
 
+#ifndef OCPP_NUMCONNECTORS
 #define OCPP_NUMCONNECTORS 2
+#endif
+
 #define OCPP_ID_OF_CONNECTOR 1
 #define OCPP_ID_OF_CP 0
 bool OCPP_booted = false; //if BootNotification succeeded

From a4fef8d7f4a51fe2206d7e43ff9375b5ad3a8aa2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 28 Aug 2022 15:01:52 +0200
Subject: [PATCH 056/549] remove superfluous console output

---
 src/ArduinoOcpp/Core/FilesystemUtils.cpp | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
index 27056d73..8ed689f8 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -70,7 +70,7 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
     }
 
     AO_DBG_DEBUG("Loaded JSON file: %s", fn);
-    
+
     return doc;
 }
 
@@ -104,7 +104,6 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
     ArduinoJsonFileAdapter fileWriter {file.get()};
 
     size_t written = serializeJson(doc, fileWriter);
-    written = serializeJson(doc, Serial);
 
     if (written < 2) {
         AO_DBG_ERR("Error writing file %s", fn);

From 154828c2a3174e7cb6da7fed6243a436b10b02d8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 27 Aug 2022 23:51:52 +0200
Subject: [PATCH 057/549] allow access to internals via facade

---
 src/ArduinoOcpp.cpp | 9 +++++++++
 src/ArduinoOcpp.h   | 8 ++++++++
 2 files changed, 17 insertions(+)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 781fc9c1..78a15f2c 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -564,3 +564,12 @@ ArduinoOcpp::DiagnosticsService *getDiagnosticsService() {
     return model.getDiagnosticsService();
 }
 #endif
+
+OcppEngine *getOcppEngine() {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return nullptr;
+    }
+
+    return ocppEngine;
+}
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 40014f94..72775ed9 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -200,4 +200,12 @@ ArduinoOcpp::FirmwareService *getFirmwareService();
 ArduinoOcpp::DiagnosticsService *getDiagnosticsService();
 #endif
 
+namespace ArduinoOcpp {
+class OcppEngine;
+}
+
+//Get access to internal functions and data structures. The returned OcppEngine object allows
+//you to bypass the facace functions of this header and implement custom functionality.
+ArduinoOcpp::OcppEngine *getOcppEngine();
+
 #endif

From 18355d0ea32db7ca836167ca82bfb8b435ff83b6 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 28 Aug 2022 12:22:47 +0200
Subject: [PATCH 058/549] allow to initialize with multiple connectors

---
 src/ArduinoOcpp.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 78a15f2c..8e79fc7a 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -36,7 +36,10 @@ std::shared_ptr<FilesystemAdapter> filesystem;
 FilesystemOpt fileSystemOpt {};
 float voltage_eff {230.f};
 
+#ifndef OCPP_NUMCONNECTORS
 #define OCPP_NUMCONNECTORS 2
+#endif
+
 #define OCPP_ID_OF_CONNECTOR 1
 #define OCPP_ID_OF_CP 0
 bool OCPP_booted = false; //if BootNotification succeeded

From 766963219b0187658212f87627cd493c96d6b808 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 7 Sep 2022 10:22:59 +0200
Subject: [PATCH 059/549] access to internals from C facade

---
 src/ArduinoOcpp.cpp                        | 6 +++++-
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp | 3 +--
 src/ArduinoOcpp/Core/FilesystemAdapter.h   | 3 +--
 src/ArduinoOcpp_c.cpp                      | 4 ++++
 src/ArduinoOcpp_c.h                        | 9 +++++++++
 5 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 8e79fc7a..d65a754b 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -89,7 +89,11 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
     voltage_eff = V_eff;
     fileSystemOpt = fsOpt;
 
-    filesystem = EspWiFi::makeDefaultFilesystemAdapter(fileSystemOpt);
+#ifndef AO_DEACTIVATE_FLASH
+    std::shared_ptr<FilesystemAdapter> filesystem = EspWiFi::makeDefaultFilesystemAdapter(fileSystemOpt);
+#else
+    std::shared_ptr<FilesystemAdapter> filesystem;
+#endif
     AO_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "error");
     
     configuration_init(filesystem); //call before each other library call
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 1d3d720e..51e1e251 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -6,8 +6,7 @@
 #include <ArduinoOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
 #include <ArduinoOcpp/Debug.h>
 
-//#ifndef AO_DEACTIVATE_FLASH
-#if 1
+#ifndef AO_DEACTIVATE_FLASH
 
 //Set default parameters; assume usage with Arduino if no build flags are present
 #ifndef AO_USE_FILEAPI
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index 93c6af27..8fd7c9c0 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -61,8 +61,7 @@ class FilesystemAdapter {
 
 } //end namespace ArduinoOcpp
 
-//#ifndef AO_DEACTIVATE_FLASH
-#if 1
+#ifndef AO_DEACTIVATE_FLASH
 
 //Set default parameters; assume usage with Arduino if no build flags are present
 #ifndef AO_USE_FILEAPI
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 03fbc26a..69ae46e0 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -198,3 +198,7 @@ bool ao_isInSession() {
 const char *ao_getSessionIdTag() {
     return getSessionIdTag();
 }
+
+OcppHandle *getOcppHandle() {
+    return reinterpret_cast<OcppHandle*>(getOcppEngine());
+}
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 9f4235e8..3fe0a0b0 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -6,6 +6,9 @@
 struct AOcppSocket;
 typedef struct AOcppSocket AOcppSocket;
 
+struct OcppHandle;
+typedef struct OcppHandle OcppHandle;
+
 typedef void (*OnOcppMessage) (const char *payload, size_t len);
 typedef void (*OnOcppAbort)   ();
 typedef void (*OnOcppTimeout) ();
@@ -102,6 +105,12 @@ bool ao_isInSession();
 
 const char *ao_getSessionIdTag();
 
+/*
+ * Get access to the internals
+ */
+
+OcppHandle *getOcppHandle();
+
 #ifdef __cplusplus
 }
 #endif

From 10795aad7e124917a0336b4d98fd51b47c197453 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 10 Sep 2022 09:43:29 +0200
Subject: [PATCH 060/549] Fix typo

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 793edd6a..4e3b4c82 100644
--- a/README.md
+++ b/README.md
@@ -65,7 +65,7 @@ void setup() {
         Serial.print(F("BootNotification was answered. Central System clock: "));
         Serial.println(confMsg["currentTime"].as<String>()); //"currentTime" is a field of the central system response
         
-        //evseIsBooted = true; <-- Example: Notify your hardare that the BootNotification.conf() has arrived
+        //evseIsBooted = true; <-- Example: Notify your hardware that the BootNotification.conf() has arrived
     });
     
     ... //rest of setup() function; executed immediately as bootNotification() is non-blocking

From 5643ea004a324fa7fbf7380e83475e4bd558486d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 19 Sep 2022 22:47:50 +0200
Subject: [PATCH 061/549] add missing include statements

---
 src/ArduinoOcpp/MessagesV16/StopTransaction.h | 1 +
 src/ArduinoOcpp/Tasks/Metering/MeterValue.h   | 1 +
 2 files changed, 2 insertions(+)

diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index eaaacde8..c74e4601 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -8,6 +8,7 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <vector>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
index 450f5d5b..541360d5 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
@@ -10,6 +10,7 @@
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoJson.h>
 #include <memory>
+#include <vector>
 
 namespace ArduinoOcpp {
 

From c8bdc6a140736222aa7f1092427be72e6d4a8e1c Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Wed, 21 Sep 2022 11:13:13 +0200
Subject: [PATCH 062/549] roll back dependency

---
 examples/SECC/platformio.ini | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/SECC/platformio.ini b/examples/SECC/platformio.ini
index 5453178e..72b36270 100644
--- a/examples/SECC/platformio.ini
+++ b/examples/SECC/platformio.ini
@@ -8,7 +8,7 @@ board = esp32dev
 framework = arduino
 lib_deps =
     https://github.com/matth-x/ArduinoOcpp.git
-    https://github.com/tzapu/WiFiManager.git
+    https://github.com/tzapu/WiFiManager.git#4dcf0cc78bb031351d65e0f9b9271569df8720ed
 monitor_speed = 115200
 
 [env:nodemcuv2]
@@ -17,5 +17,5 @@ board = nodemcuv2
 framework = arduino
 lib_deps = 
     https://github.com/matth-x/ArduinoOcpp.git
-    https://github.com/tzapu/WiFiManager.git
+    https://github.com/tzapu/WiFiManager.git#4dcf0cc78bb031351d65e0f9b9271569df8720ed
 monitor_speed = 115200

From 0a8fbfbb10e86223803a231f42f9d683d8d55fff Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Wed, 21 Sep 2022 11:19:15 +0200
Subject: [PATCH 063/549] Exclude SECC example

---
 .github/workflows/pio.yaml | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/pio.yaml b/.github/workflows/pio.yaml
index ab6248b7..819bc365 100644
--- a/.github/workflows/pio.yaml
+++ b/.github/workflows/pio.yaml
@@ -11,10 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        example: [examples/ESP/main.cpp, examples/ESP-TLS/main.cpp, examples/SECC/main.cpp]
-        include:
-          - example: examples/SECC/main.cpp
-            dashboard-extra: --lib="/tmp/tzapu/WiFiManager"
+        example: [examples/ESP/main.cpp, examples/ESP-TLS/main.cpp]
 
     steps:
     - uses: actions/checkout@v2
@@ -38,10 +35,7 @@ jobs:
         pip install --upgrade platformio
     - name: Install library dependencies
       run: pio pkg install
-    - name: Extra dependencies for SECC example
-      if: ${{ matrix.dashboard-extra }}
-      run: git clone https://github.com/tzapu/WiFiManager.git /tmp/tzapu/WiFiManager
     - name: Run PlatformIO
       run: pio ci --lib="." --project-conf=platformio.ini ${{ matrix.dashboard-extra }}
       env:
-        PLATFORMIO_CI_SRC: ${{ matrix.example }}
\ No newline at end of file
+        PLATFORMIO_CI_SRC: ${{ matrix.example }}

From 579c67adffd43477a302e94dcc8846303682e255 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Tue, 27 Sep 2022 09:47:25 +0200
Subject: [PATCH 064/549] sample workflow for platform independent compilation

---
 .github/workflows/platformless.yml | 23 +++++++++++++++++++++++
 .github/workflows/tests.yml        | 19 +++++++++++++++++++
 src/ArduinoOcpp_c.cpp              |  2 ++
 src/patch.cpp                      |  9 +++++++++
 4 files changed, 53 insertions(+)
 create mode 100644 .github/workflows/platformless.yml
 create mode 100644 .github/workflows/tests.yml
 create mode 100644 src/patch.cpp

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
new file mode 100644
index 00000000..60764468
--- /dev/null
+++ b/.github/workflows/platformless.yml
@@ -0,0 +1,23 @@
+name: Platform independent compilation
+
+on:
+  push:
+    branches:
+      - feature/freertos
+
+jobs:
+
+  compile-tests:
+    name: Compile
+    runs-on: ubuntu-latest
+    steps:
+    - name: Check out repository code
+      uses: actions/checkout@v3
+    - name: get gcc compiler
+      run: |
+        sudo apt update
+        sudo apt install build-essential
+    - name: Get ArduinoJson
+      run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
+    - name: Compile
+      run: g++ -I ./src -g $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
new file mode 100644
index 00000000..d14d3fe9
--- /dev/null
+++ b/.github/workflows/tests.yml
@@ -0,0 +1,19 @@
+name: Unit tests
+
+on:
+  push:
+    branches:
+      - test-integration-disabled
+
+jobs:
+
+  compile-tests:
+    name: Compile Tests
+    runs-on: ubuntu-latest
+    steps:
+    - name: Check out repository code
+      uses: actions/checkout@v3
+    - name: Compile tests
+      run: g++ -Wall test/unitTests/000-unitTestsMain.cpp -o test/compiledTests
+    - name: Run tests
+      run: ./test/compiledTests
\ No newline at end of file
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 69ae46e0..b4642ccf 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -1,3 +1,4 @@
+#if 0
 #include "ArduinoOcpp_c.h"
 #include "ArduinoOcpp.h"
 
@@ -202,3 +203,4 @@ const char *ao_getSessionIdTag() {
 OcppHandle *getOcppHandle() {
     return reinterpret_cast<OcppHandle*>(getOcppEngine());
 }
+#endif
diff --git a/src/patch.cpp b/src/patch.cpp
new file mode 100644
index 00000000..2f87613c
--- /dev/null
+++ b/src/patch.cpp
@@ -0,0 +1,9 @@
+#include <ArduinoOcpp/Platform.h>
+
+unsigned long ao_tick_ms_impl() {
+    return 0;
+}
+
+int main() {
+    return 0;
+}

From 62813473b49c38ddea0491f014381ffa918da7d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Tue, 27 Sep 2022 08:48:59 +0000
Subject: [PATCH 065/549] update gitignore

---
 .gitignore | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 .gitignore

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 00000000..015a4214
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+.devcontainer
+ArduinoJson.h
\ No newline at end of file

From 03e2b3e0323d4f98496b7bd23f4bdb8817442e79 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Tue, 27 Sep 2022 08:52:04 +0000
Subject: [PATCH 066/549] test workflow

---
 .github/workflows/platformless.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 60764468..e07500c0 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -20,4 +20,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -I ./src -g $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall
+      run: g++ -std=c++14 -I ./src -g $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall

From 0fbbd8de8e035a99c7c26a1ca6f49a19c8d57823 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Tue, 27 Sep 2022 08:52:37 +0000
Subject: [PATCH 067/549] update gitignore

---
 .gitignore | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 015a4214..8f15d4c9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,3 @@
 .devcontainer
-ArduinoJson.h
\ No newline at end of file
+ArduinoJson.h
+workflow.ps1
\ No newline at end of file

From 17af159ef507cc573fa90d9f5b74ba9cffa5f795 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Tue, 27 Sep 2022 08:55:11 +0000
Subject: [PATCH 068/549] update gitignore

---
 .gitignore | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 8f15d4c9..0b81cddd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,3 @@
 .devcontainer
 ArduinoJson.h
-workflow.ps1
\ No newline at end of file
+workflow.sh
\ No newline at end of file

From ee21d06da8c21f32ab66f3687c0b6cde3bbe9172 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Tue, 27 Sep 2022 09:00:26 +0000
Subject: [PATCH 069/549] test workflow

---
 .github/workflows/platformless.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index e07500c0..4b22b20a 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -17,6 +17,7 @@ jobs:
       run: |
         sudo apt update
         sudo apt install build-essential
+        g++ --version
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile

From 47168202b7f5fbad83c72808070a54b8f3ae44fc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Tue, 27 Sep 2022 09:34:30 +0000
Subject: [PATCH 070/549] added info for g++ compiler version

---
 .github/workflows/platformless.yml | 4 +++-
 .gitignore                         | 3 ++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 4b22b20a..83f266c9 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -17,8 +17,10 @@ jobs:
       run: |
         sudo apt update
         sudo apt install build-essential
+        sudo apt -y install gcc-9 g++-9
         g++ --version
+        echo "g++ version must be 9.4.0"
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -std=c++14 -I ./src -g $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall
+      run: g++ -std=c++14 -I ./src -g $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output.exe -Wall
diff --git a/.gitignore b/.gitignore
index 0b81cddd..83d29ad3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 .devcontainer
 ArduinoJson.h
-workflow.sh
\ No newline at end of file
+workflow.sh
+output.exe
\ No newline at end of file

From c672d19fce9fa753deb203cad6cda753a8dbffad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Tue, 27 Sep 2022 09:44:13 +0000
Subject: [PATCH 071/549] added test files

---
 tests/000-unitTestsMain.cpp   |    12 +
 tests/catch2/catch.hpp        | 17969 ++++++++++++++++++++++++++++++++
 tests/exampleCheckNumbers.cpp |    13 +
 3 files changed, 17994 insertions(+)
 create mode 100644 tests/000-unitTestsMain.cpp
 create mode 100644 tests/catch2/catch.hpp
 create mode 100644 tests/exampleCheckNumbers.cpp

diff --git a/tests/000-unitTestsMain.cpp b/tests/000-unitTestsMain.cpp
new file mode 100644
index 00000000..71a6c970
--- /dev/null
+++ b/tests/000-unitTestsMain.cpp
@@ -0,0 +1,12 @@
+//000- prefix is for the main-file to always be on top in folder view
+
+// Powershell to compile tests and run them:
+// g++ -Wall test/unitTests/000-unitTestsMain.cpp -o ./test/compiledTests ; ./test/compiledTests ; Remove-Item -Path ./test/compiledTests.exe
+
+//use the main function provided by catch2
+#define CATCH_CONFIG_MAIN
+//include the catch2 library
+#include "../catch2/catch.hpp"
+
+//include the unit tests
+#include "./exampleCheckNumbers.cpp"
\ No newline at end of file
diff --git a/tests/catch2/catch.hpp b/tests/catch2/catch.hpp
new file mode 100644
index 00000000..07efa655
--- /dev/null
+++ b/tests/catch2/catch.hpp
@@ -0,0 +1,17969 @@
+/*
+ *  Catch v2.13.9
+ *  Generated: 2022-04-12 22:37:23.260201
+ *  ----------------------------------------------------------
+ *  This file has been merged from multiple headers. Please don't edit it directly
+ *  Copyright (c) 2022 Two Blue Cubes Ltd. All rights reserved.
+ *
+ *  Distributed under the Boost Software License, Version 1.0. (See accompanying
+ *  file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ */
+#ifndef TWOBLUECUBES_SINGLE_INCLUDE_CATCH_HPP_INCLUDED
+#define TWOBLUECUBES_SINGLE_INCLUDE_CATCH_HPP_INCLUDED
+// start catch.hpp
+
+
+#define CATCH_VERSION_MAJOR 2
+#define CATCH_VERSION_MINOR 13
+#define CATCH_VERSION_PATCH 9
+
+#ifdef __clang__
+#    pragma clang system_header
+#elif defined __GNUC__
+#    pragma GCC system_header
+#endif
+
+// start catch_suppress_warnings.h
+
+#ifdef __clang__
+#   ifdef __ICC // icpc defines the __clang__ macro
+#       pragma warning(push)
+#       pragma warning(disable: 161 1682)
+#   else // __ICC
+#       pragma clang diagnostic push
+#       pragma clang diagnostic ignored "-Wpadded"
+#       pragma clang diagnostic ignored "-Wswitch-enum"
+#       pragma clang diagnostic ignored "-Wcovered-switch-default"
+#    endif
+#elif defined __GNUC__
+     // Because REQUIREs trigger GCC's -Wparentheses, and because still
+     // supported version of g++ have only buggy support for _Pragmas,
+     // Wparentheses have to be suppressed globally.
+#    pragma GCC diagnostic ignored "-Wparentheses" // See #674 for details
+
+#    pragma GCC diagnostic push
+#    pragma GCC diagnostic ignored "-Wunused-variable"
+#    pragma GCC diagnostic ignored "-Wpadded"
+#endif
+// end catch_suppress_warnings.h
+#if defined(CATCH_CONFIG_MAIN) || defined(CATCH_CONFIG_RUNNER)
+#  define CATCH_IMPL
+#  define CATCH_CONFIG_ALL_PARTS
+#endif
+
+// In the impl file, we want to have access to all parts of the headers
+// Can also be used to sanely support PCHs
+#if defined(CATCH_CONFIG_ALL_PARTS)
+#  define CATCH_CONFIG_EXTERNAL_INTERFACES
+#  if defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#    undef CATCH_CONFIG_DISABLE_MATCHERS
+#  endif
+#  if !defined(CATCH_CONFIG_ENABLE_CHRONO_STRINGMAKER)
+#    define CATCH_CONFIG_ENABLE_CHRONO_STRINGMAKER
+#  endif
+#endif
+
+#if !defined(CATCH_CONFIG_IMPL_ONLY)
+// start catch_platform.h
+
+// See e.g.:
+// https://opensource.apple.com/source/CarbonHeaders/CarbonHeaders-18.1/TargetConditionals.h.auto.html
+#ifdef __APPLE__
+#  include <TargetConditionals.h>
+#  if (defined(TARGET_OS_OSX) && TARGET_OS_OSX == 1) || \
+      (defined(TARGET_OS_MAC) && TARGET_OS_MAC == 1)
+#    define CATCH_PLATFORM_MAC
+#  elif (defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE == 1)
+#    define CATCH_PLATFORM_IPHONE
+#  endif
+
+#elif defined(linux) || defined(__linux) || defined(__linux__)
+#  define CATCH_PLATFORM_LINUX
+
+#elif defined(WIN32) || defined(__WIN32__) || defined(_WIN32) || defined(_MSC_VER) || defined(__MINGW32__)
+#  define CATCH_PLATFORM_WINDOWS
+#endif
+
+// end catch_platform.h
+
+#ifdef CATCH_IMPL
+#  ifndef CLARA_CONFIG_MAIN
+#    define CLARA_CONFIG_MAIN_NOT_DEFINED
+#    define CLARA_CONFIG_MAIN
+#  endif
+#endif
+
+// start catch_user_interfaces.h
+
+namespace Catch {
+    unsigned int rngSeed();
+}
+
+// end catch_user_interfaces.h
+// start catch_tag_alias_autoregistrar.h
+
+// start catch_common.h
+
+// start catch_compiler_capabilities.h
+
+// Detect a number of compiler features - by compiler
+// The following features are defined:
+//
+// CATCH_CONFIG_COUNTER : is the __COUNTER__ macro supported?
+// CATCH_CONFIG_WINDOWS_SEH : is Windows SEH supported?
+// CATCH_CONFIG_POSIX_SIGNALS : are POSIX signals supported?
+// CATCH_CONFIG_DISABLE_EXCEPTIONS : Are exceptions enabled?
+// ****************
+// Note to maintainers: if new toggles are added please document them
+// in configuration.md, too
+// ****************
+
+// In general each macro has a _NO_<feature name> form
+// (e.g. CATCH_CONFIG_NO_POSIX_SIGNALS) which disables the feature.
+// Many features, at point of detection, define an _INTERNAL_ macro, so they
+// can be combined, en-mass, with the _NO_ forms later.
+
+#ifdef __cplusplus
+
+#  if (__cplusplus >= 201402L) || (defined(_MSVC_LANG) && _MSVC_LANG >= 201402L)
+#    define CATCH_CPP14_OR_GREATER
+#  endif
+
+#  if (__cplusplus >= 201703L) || (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L)
+#    define CATCH_CPP17_OR_GREATER
+#  endif
+
+#endif
+
+// Only GCC compiler should be used in this block, so other compilers trying to
+// mask themselves as GCC should be ignored.
+#if defined(__GNUC__) && !defined(__clang__) && !defined(__ICC) && !defined(__CUDACC__) && !defined(__LCC__)
+#    define CATCH_INTERNAL_START_WARNINGS_SUPPRESSION _Pragma( "GCC diagnostic push" )
+#    define CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION  _Pragma( "GCC diagnostic pop" )
+
+#    define CATCH_INTERNAL_IGNORE_BUT_WARN(...) (void)__builtin_constant_p(__VA_ARGS__)
+
+#endif
+
+#if defined(__clang__)
+
+#    define CATCH_INTERNAL_START_WARNINGS_SUPPRESSION _Pragma( "clang diagnostic push" )
+#    define CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION  _Pragma( "clang diagnostic pop" )
+
+// As of this writing, IBM XL's implementation of __builtin_constant_p has a bug
+// which results in calls to destructors being emitted for each temporary,
+// without a matching initialization. In practice, this can result in something
+// like `std::string::~string` being called on an uninitialized value.
+//
+// For example, this code will likely segfault under IBM XL:
+// ```
+// REQUIRE(std::string("12") + "34" == "1234")
+// ```
+//
+// Therefore, `CATCH_INTERNAL_IGNORE_BUT_WARN` is not implemented.
+#  if !defined(__ibmxl__) && !defined(__CUDACC__)
+#    define CATCH_INTERNAL_IGNORE_BUT_WARN(...) (void)__builtin_constant_p(__VA_ARGS__) /* NOLINT(cppcoreguidelines-pro-type-vararg, hicpp-vararg) */
+#  endif
+
+#    define CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+         _Pragma( "clang diagnostic ignored \"-Wexit-time-destructors\"" ) \
+         _Pragma( "clang diagnostic ignored \"-Wglobal-constructors\"")
+
+#    define CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS \
+         _Pragma( "clang diagnostic ignored \"-Wparentheses\"" )
+
+#    define CATCH_INTERNAL_SUPPRESS_UNUSED_WARNINGS \
+         _Pragma( "clang diagnostic ignored \"-Wunused-variable\"" )
+
+#    define CATCH_INTERNAL_SUPPRESS_ZERO_VARIADIC_WARNINGS \
+         _Pragma( "clang diagnostic ignored \"-Wgnu-zero-variadic-macro-arguments\"" )
+
+#    define CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS \
+         _Pragma( "clang diagnostic ignored \"-Wunused-template\"" )
+
+#endif // __clang__
+
+////////////////////////////////////////////////////////////////////////////////
+// Assume that non-Windows platforms support posix signals by default
+#if !defined(CATCH_PLATFORM_WINDOWS)
+    #define CATCH_INTERNAL_CONFIG_POSIX_SIGNALS
+#endif
+
+////////////////////////////////////////////////////////////////////////////////
+// We know some environments not to support full POSIX signals
+#if defined(__CYGWIN__) || defined(__QNX__) || defined(__EMSCRIPTEN__) || defined(__DJGPP__)
+    #define CATCH_INTERNAL_CONFIG_NO_POSIX_SIGNALS
+#endif
+
+#ifdef __OS400__
+#       define CATCH_INTERNAL_CONFIG_NO_POSIX_SIGNALS
+#       define CATCH_CONFIG_COLOUR_NONE
+#endif
+
+////////////////////////////////////////////////////////////////////////////////
+// Android somehow still does not support std::to_string
+#if defined(__ANDROID__)
+#    define CATCH_INTERNAL_CONFIG_NO_CPP11_TO_STRING
+#    define CATCH_INTERNAL_CONFIG_ANDROID_LOGWRITE
+#endif
+
+////////////////////////////////////////////////////////////////////////////////
+// Not all Windows environments support SEH properly
+#if defined(__MINGW32__)
+#    define CATCH_INTERNAL_CONFIG_NO_WINDOWS_SEH
+#endif
+
+////////////////////////////////////////////////////////////////////////////////
+// PS4
+#if defined(__ORBIS__)
+#    define CATCH_INTERNAL_CONFIG_NO_NEW_CAPTURE
+#endif
+
+////////////////////////////////////////////////////////////////////////////////
+// Cygwin
+#ifdef __CYGWIN__
+
+// Required for some versions of Cygwin to declare gettimeofday
+// see: http://stackoverflow.com/questions/36901803/gettimeofday-not-declared-in-this-scope-cygwin
+#   define _BSD_SOURCE
+// some versions of cygwin (most) do not support std::to_string. Use the libstd check.
+// https://gcc.gnu.org/onlinedocs/gcc-4.8.2/libstdc++/api/a01053_source.html line 2812-2813
+# if !((__cplusplus >= 201103L) && defined(_GLIBCXX_USE_C99) \
+           && !defined(_GLIBCXX_HAVE_BROKEN_VSWPRINTF))
+
+#    define CATCH_INTERNAL_CONFIG_NO_CPP11_TO_STRING
+
+# endif
+#endif // __CYGWIN__
+
+////////////////////////////////////////////////////////////////////////////////
+// Visual C++
+#if defined(_MSC_VER)
+
+// Universal Windows platform does not support SEH
+// Or console colours (or console at all...)
+#  if defined(WINAPI_FAMILY) && (WINAPI_FAMILY == WINAPI_FAMILY_APP)
+#    define CATCH_CONFIG_COLOUR_NONE
+#  else
+#    define CATCH_INTERNAL_CONFIG_WINDOWS_SEH
+#  endif
+
+#  if !defined(__clang__) // Handle Clang masquerading for msvc
+
+// MSVC traditional preprocessor needs some workaround for __VA_ARGS__
+// _MSVC_TRADITIONAL == 0 means new conformant preprocessor
+// _MSVC_TRADITIONAL == 1 means old traditional non-conformant preprocessor
+#    if !defined(_MSVC_TRADITIONAL) || (defined(_MSVC_TRADITIONAL) && _MSVC_TRADITIONAL)
+#      define CATCH_INTERNAL_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#    endif // MSVC_TRADITIONAL
+
+// Only do this if we're not using clang on Windows, which uses `diagnostic push` & `diagnostic pop`
+#    define CATCH_INTERNAL_START_WARNINGS_SUPPRESSION __pragma( warning(push) )
+#    define CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION  __pragma( warning(pop) )
+#  endif // __clang__
+
+#endif // _MSC_VER
+
+#if defined(_REENTRANT) || defined(_MSC_VER)
+// Enable async processing, as -pthread is specified or no additional linking is required
+# define CATCH_INTERNAL_CONFIG_USE_ASYNC
+#endif // _MSC_VER
+
+////////////////////////////////////////////////////////////////////////////////
+// Check if we are compiled with -fno-exceptions or equivalent
+#if defined(__EXCEPTIONS) || defined(__cpp_exceptions) || defined(_CPPUNWIND)
+#  define CATCH_INTERNAL_CONFIG_EXCEPTIONS_ENABLED
+#endif
+
+////////////////////////////////////////////////////////////////////////////////
+// DJGPP
+#ifdef __DJGPP__
+#  define CATCH_INTERNAL_CONFIG_NO_WCHAR
+#endif // __DJGPP__
+
+////////////////////////////////////////////////////////////////////////////////
+// Embarcadero C++Build
+#if defined(__BORLANDC__)
+    #define CATCH_INTERNAL_CONFIG_POLYFILL_ISNAN
+#endif
+
+////////////////////////////////////////////////////////////////////////////////
+
+// Use of __COUNTER__ is suppressed during code analysis in
+// CLion/AppCode 2017.2.x and former, because __COUNTER__ is not properly
+// handled by it.
+// Otherwise all supported compilers support COUNTER macro,
+// but user still might want to turn it off
+#if ( !defined(__JETBRAINS_IDE__) || __JETBRAINS_IDE__ >= 20170300L )
+    #define CATCH_INTERNAL_CONFIG_COUNTER
+#endif
+
+////////////////////////////////////////////////////////////////////////////////
+
+// RTX is a special version of Windows that is real time.
+// This means that it is detected as Windows, but does not provide
+// the same set of capabilities as real Windows does.
+#if defined(UNDER_RTSS) || defined(RTX64_BUILD)
+    #define CATCH_INTERNAL_CONFIG_NO_WINDOWS_SEH
+    #define CATCH_INTERNAL_CONFIG_NO_ASYNC
+    #define CATCH_CONFIG_COLOUR_NONE
+#endif
+
+#if !defined(_GLIBCXX_USE_C99_MATH_TR1)
+#define CATCH_INTERNAL_CONFIG_GLOBAL_NEXTAFTER
+#endif
+
+// Various stdlib support checks that require __has_include
+#if defined(__has_include)
+  // Check if string_view is available and usable
+  #if __has_include(<string_view>) && defined(CATCH_CPP17_OR_GREATER)
+  #    define CATCH_INTERNAL_CONFIG_CPP17_STRING_VIEW
+  #endif
+
+  // Check if optional is available and usable
+  #  if __has_include(<optional>) && defined(CATCH_CPP17_OR_GREATER)
+  #    define CATCH_INTERNAL_CONFIG_CPP17_OPTIONAL
+  #  endif // __has_include(<optional>) && defined(CATCH_CPP17_OR_GREATER)
+
+  // Check if byte is available and usable
+  #  if __has_include(<cstddef>) && defined(CATCH_CPP17_OR_GREATER)
+  #    include <cstddef>
+  #    if defined(__cpp_lib_byte) && (__cpp_lib_byte > 0)
+  #      define CATCH_INTERNAL_CONFIG_CPP17_BYTE
+  #    endif
+  #  endif // __has_include(<cstddef>) && defined(CATCH_CPP17_OR_GREATER)
+
+  // Check if variant is available and usable
+  #  if __has_include(<variant>) && defined(CATCH_CPP17_OR_GREATER)
+  #    if defined(__clang__) && (__clang_major__ < 8)
+         // work around clang bug with libstdc++ https://bugs.llvm.org/show_bug.cgi?id=31852
+         // fix should be in clang 8, workaround in libstdc++ 8.2
+  #      include <ciso646>
+  #      if defined(__GLIBCXX__) && defined(_GLIBCXX_RELEASE) && (_GLIBCXX_RELEASE < 9)
+  #        define CATCH_CONFIG_NO_CPP17_VARIANT
+  #      else
+  #        define CATCH_INTERNAL_CONFIG_CPP17_VARIANT
+  #      endif // defined(__GLIBCXX__) && defined(_GLIBCXX_RELEASE) && (_GLIBCXX_RELEASE < 9)
+  #    else
+  #      define CATCH_INTERNAL_CONFIG_CPP17_VARIANT
+  #    endif // defined(__clang__) && (__clang_major__ < 8)
+  #  endif // __has_include(<variant>) && defined(CATCH_CPP17_OR_GREATER)
+#endif // defined(__has_include)
+
+#if defined(CATCH_INTERNAL_CONFIG_COUNTER) && !defined(CATCH_CONFIG_NO_COUNTER) && !defined(CATCH_CONFIG_COUNTER)
+#   define CATCH_CONFIG_COUNTER
+#endif
+#if defined(CATCH_INTERNAL_CONFIG_WINDOWS_SEH) && !defined(CATCH_CONFIG_NO_WINDOWS_SEH) && !defined(CATCH_CONFIG_WINDOWS_SEH) && !defined(CATCH_INTERNAL_CONFIG_NO_WINDOWS_SEH)
+#   define CATCH_CONFIG_WINDOWS_SEH
+#endif
+// This is set by default, because we assume that unix compilers are posix-signal-compatible by default.
+#if defined(CATCH_INTERNAL_CONFIG_POSIX_SIGNALS) && !defined(CATCH_INTERNAL_CONFIG_NO_POSIX_SIGNALS) && !defined(CATCH_CONFIG_NO_POSIX_SIGNALS) && !defined(CATCH_CONFIG_POSIX_SIGNALS)
+#   define CATCH_CONFIG_POSIX_SIGNALS
+#endif
+// This is set by default, because we assume that compilers with no wchar_t support are just rare exceptions.
+#if !defined(CATCH_INTERNAL_CONFIG_NO_WCHAR) && !defined(CATCH_CONFIG_NO_WCHAR) && !defined(CATCH_CONFIG_WCHAR)
+#   define CATCH_CONFIG_WCHAR
+#endif
+
+#if !defined(CATCH_INTERNAL_CONFIG_NO_CPP11_TO_STRING) && !defined(CATCH_CONFIG_NO_CPP11_TO_STRING) && !defined(CATCH_CONFIG_CPP11_TO_STRING)
+#    define CATCH_CONFIG_CPP11_TO_STRING
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_CPP17_OPTIONAL) && !defined(CATCH_CONFIG_NO_CPP17_OPTIONAL) && !defined(CATCH_CONFIG_CPP17_OPTIONAL)
+#  define CATCH_CONFIG_CPP17_OPTIONAL
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_CPP17_STRING_VIEW) && !defined(CATCH_CONFIG_NO_CPP17_STRING_VIEW) && !defined(CATCH_CONFIG_CPP17_STRING_VIEW)
+#  define CATCH_CONFIG_CPP17_STRING_VIEW
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_CPP17_VARIANT) && !defined(CATCH_CONFIG_NO_CPP17_VARIANT) && !defined(CATCH_CONFIG_CPP17_VARIANT)
+#  define CATCH_CONFIG_CPP17_VARIANT
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_CPP17_BYTE) && !defined(CATCH_CONFIG_NO_CPP17_BYTE) && !defined(CATCH_CONFIG_CPP17_BYTE)
+#  define CATCH_CONFIG_CPP17_BYTE
+#endif
+
+#if defined(CATCH_CONFIG_EXPERIMENTAL_REDIRECT)
+#  define CATCH_INTERNAL_CONFIG_NEW_CAPTURE
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_NEW_CAPTURE) && !defined(CATCH_INTERNAL_CONFIG_NO_NEW_CAPTURE) && !defined(CATCH_CONFIG_NO_NEW_CAPTURE) && !defined(CATCH_CONFIG_NEW_CAPTURE)
+#  define CATCH_CONFIG_NEW_CAPTURE
+#endif
+
+#if !defined(CATCH_INTERNAL_CONFIG_EXCEPTIONS_ENABLED) && !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+#  define CATCH_CONFIG_DISABLE_EXCEPTIONS
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_POLYFILL_ISNAN) && !defined(CATCH_CONFIG_NO_POLYFILL_ISNAN) && !defined(CATCH_CONFIG_POLYFILL_ISNAN)
+#  define CATCH_CONFIG_POLYFILL_ISNAN
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_USE_ASYNC)  && !defined(CATCH_INTERNAL_CONFIG_NO_ASYNC) && !defined(CATCH_CONFIG_NO_USE_ASYNC) && !defined(CATCH_CONFIG_USE_ASYNC)
+#  define CATCH_CONFIG_USE_ASYNC
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_ANDROID_LOGWRITE) && !defined(CATCH_CONFIG_NO_ANDROID_LOGWRITE) && !defined(CATCH_CONFIG_ANDROID_LOGWRITE)
+#  define CATCH_CONFIG_ANDROID_LOGWRITE
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_GLOBAL_NEXTAFTER) && !defined(CATCH_CONFIG_NO_GLOBAL_NEXTAFTER) && !defined(CATCH_CONFIG_GLOBAL_NEXTAFTER)
+#  define CATCH_CONFIG_GLOBAL_NEXTAFTER
+#endif
+
+// Even if we do not think the compiler has that warning, we still have
+// to provide a macro that can be used by the code.
+#if !defined(CATCH_INTERNAL_START_WARNINGS_SUPPRESSION)
+#   define CATCH_INTERNAL_START_WARNINGS_SUPPRESSION
+#endif
+#if !defined(CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION)
+#   define CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
+#endif
+#if !defined(CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS)
+#   define CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS
+#endif
+#if !defined(CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS)
+#   define CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS
+#endif
+#if !defined(CATCH_INTERNAL_SUPPRESS_UNUSED_WARNINGS)
+#   define CATCH_INTERNAL_SUPPRESS_UNUSED_WARNINGS
+#endif
+#if !defined(CATCH_INTERNAL_SUPPRESS_ZERO_VARIADIC_WARNINGS)
+#   define CATCH_INTERNAL_SUPPRESS_ZERO_VARIADIC_WARNINGS
+#endif
+
+// The goal of this macro is to avoid evaluation of the arguments, but
+// still have the compiler warn on problems inside...
+#if !defined(CATCH_INTERNAL_IGNORE_BUT_WARN)
+#   define CATCH_INTERNAL_IGNORE_BUT_WARN(...)
+#endif
+
+#if defined(__APPLE__) && defined(__apple_build_version__) && (__clang_major__ < 10)
+#   undef CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS
+#elif defined(__clang__) && (__clang_major__ < 5)
+#   undef CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS
+#endif
+
+#if !defined(CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS)
+#   define CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS
+#endif
+
+#if defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+#define CATCH_TRY if ((true))
+#define CATCH_CATCH_ALL if ((false))
+#define CATCH_CATCH_ANON(type) if ((false))
+#else
+#define CATCH_TRY try
+#define CATCH_CATCH_ALL catch (...)
+#define CATCH_CATCH_ANON(type) catch (type)
+#endif
+
+#if defined(CATCH_INTERNAL_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR) && !defined(CATCH_CONFIG_NO_TRADITIONAL_MSVC_PREPROCESSOR) && !defined(CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR)
+#define CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#endif
+
+// end catch_compiler_capabilities.h
+#define INTERNAL_CATCH_UNIQUE_NAME_LINE2( name, line ) name##line
+#define INTERNAL_CATCH_UNIQUE_NAME_LINE( name, line ) INTERNAL_CATCH_UNIQUE_NAME_LINE2( name, line )
+#ifdef CATCH_CONFIG_COUNTER
+#  define INTERNAL_CATCH_UNIQUE_NAME( name ) INTERNAL_CATCH_UNIQUE_NAME_LINE( name, __COUNTER__ )
+#else
+#  define INTERNAL_CATCH_UNIQUE_NAME( name ) INTERNAL_CATCH_UNIQUE_NAME_LINE( name, __LINE__ )
+#endif
+
+#include <iosfwd>
+#include <string>
+#include <cstdint>
+
+// We need a dummy global operator<< so we can bring it into Catch namespace later
+struct Catch_global_namespace_dummy {};
+std::ostream& operator<<(std::ostream&, Catch_global_namespace_dummy);
+
+namespace Catch {
+
+    struct CaseSensitive { enum Choice {
+        Yes,
+        No
+    }; };
+
+    class NonCopyable {
+        NonCopyable( NonCopyable const& )              = delete;
+        NonCopyable( NonCopyable && )                  = delete;
+        NonCopyable& operator = ( NonCopyable const& ) = delete;
+        NonCopyable& operator = ( NonCopyable && )     = delete;
+
+    protected:
+        NonCopyable();
+        virtual ~NonCopyable();
+    };
+
+    struct SourceLineInfo {
+
+        SourceLineInfo() = delete;
+        SourceLineInfo( char const* _file, std::size_t _line ) noexcept
+        :   file( _file ),
+            line( _line )
+        {}
+
+        SourceLineInfo( SourceLineInfo const& other )            = default;
+        SourceLineInfo& operator = ( SourceLineInfo const& )     = default;
+        SourceLineInfo( SourceLineInfo&& )              noexcept = default;
+        SourceLineInfo& operator = ( SourceLineInfo&& ) noexcept = default;
+
+        bool empty() const noexcept { return file[0] == '\0'; }
+        bool operator == ( SourceLineInfo const& other ) const noexcept;
+        bool operator < ( SourceLineInfo const& other ) const noexcept;
+
+        char const* file;
+        std::size_t line;
+    };
+
+    std::ostream& operator << ( std::ostream& os, SourceLineInfo const& info );
+
+    // Bring in operator<< from global namespace into Catch namespace
+    // This is necessary because the overload of operator<< above makes
+    // lookup stop at namespace Catch
+    using ::operator<<;
+
+    // Use this in variadic streaming macros to allow
+    //    >> +StreamEndStop
+    // as well as
+    //    >> stuff +StreamEndStop
+    struct StreamEndStop {
+        std::string operator+() const;
+    };
+    template<typename T>
+    T const& operator + ( T const& value, StreamEndStop ) {
+        return value;
+    }
+}
+
+#define CATCH_INTERNAL_LINEINFO \
+    ::Catch::SourceLineInfo( __FILE__, static_cast<std::size_t>( __LINE__ ) )
+
+// end catch_common.h
+namespace Catch {
+
+    struct RegistrarForTagAliases {
+        RegistrarForTagAliases( char const* alias, char const* tag, SourceLineInfo const& lineInfo );
+    };
+
+} // end namespace Catch
+
+#define CATCH_REGISTER_TAG_ALIAS( alias, spec ) \
+    CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+    CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+    namespace{ Catch::RegistrarForTagAliases INTERNAL_CATCH_UNIQUE_NAME( AutoRegisterTagAlias )( alias, spec, CATCH_INTERNAL_LINEINFO ); } \
+    CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
+
+// end catch_tag_alias_autoregistrar.h
+// start catch_test_registry.h
+
+// start catch_interfaces_testcase.h
+
+#include <vector>
+
+namespace Catch {
+
+    class TestSpec;
+
+    struct ITestInvoker {
+        virtual void invoke () const = 0;
+        virtual ~ITestInvoker();
+    };
+
+    class TestCase;
+    struct IConfig;
+
+    struct ITestCaseRegistry {
+        virtual ~ITestCaseRegistry();
+        virtual std::vector<TestCase> const& getAllTests() const = 0;
+        virtual std::vector<TestCase> const& getAllTestsSorted( IConfig const& config ) const = 0;
+    };
+
+    bool isThrowSafe( TestCase const& testCase, IConfig const& config );
+    bool matchTest( TestCase const& testCase, TestSpec const& testSpec, IConfig const& config );
+    std::vector<TestCase> filterTests( std::vector<TestCase> const& testCases, TestSpec const& testSpec, IConfig const& config );
+    std::vector<TestCase> const& getAllTestCasesSorted( IConfig const& config );
+
+}
+
+// end catch_interfaces_testcase.h
+// start catch_stringref.h
+
+#include <cstddef>
+#include <string>
+#include <iosfwd>
+#include <cassert>
+
+namespace Catch {
+
+    /// A non-owning string class (similar to the forthcoming std::string_view)
+    /// Note that, because a StringRef may be a substring of another string,
+    /// it may not be null terminated.
+    class StringRef {
+    public:
+        using size_type = std::size_t;
+        using const_iterator = const char*;
+
+    private:
+        static constexpr char const* const s_empty = "";
+
+        char const* m_start = s_empty;
+        size_type m_size = 0;
+
+    public: // construction
+        constexpr StringRef() noexcept = default;
+
+        StringRef( char const* rawChars ) noexcept;
+
+        constexpr StringRef( char const* rawChars, size_type size ) noexcept
+        :   m_start( rawChars ),
+            m_size( size )
+        {}
+
+        StringRef( std::string const& stdString ) noexcept
+        :   m_start( stdString.c_str() ),
+            m_size( stdString.size() )
+        {}
+
+        explicit operator std::string() const {
+            return std::string(m_start, m_size);
+        }
+
+    public: // operators
+        auto operator == ( StringRef const& other ) const noexcept -> bool;
+        auto operator != (StringRef const& other) const noexcept -> bool {
+            return !(*this == other);
+        }
+
+        auto operator[] ( size_type index ) const noexcept -> char {
+            assert(index < m_size);
+            return m_start[index];
+        }
+
+    public: // named queries
+        constexpr auto empty() const noexcept -> bool {
+            return m_size == 0;
+        }
+        constexpr auto size() const noexcept -> size_type {
+            return m_size;
+        }
+
+        // Returns the current start pointer. If the StringRef is not
+        // null-terminated, throws std::domain_exception
+        auto c_str() const -> char const*;
+
+    public: // substrings and searches
+        // Returns a substring of [start, start + length).
+        // If start + length > size(), then the substring is [start, size()).
+        // If start > size(), then the substring is empty.
+        auto substr( size_type start, size_type length ) const noexcept -> StringRef;
+
+        // Returns the current start pointer. May not be null-terminated.
+        auto data() const noexcept -> char const*;
+
+        constexpr auto isNullTerminated() const noexcept -> bool {
+            return m_start[m_size] == '\0';
+        }
+
+    public: // iterators
+        constexpr const_iterator begin() const { return m_start; }
+        constexpr const_iterator end() const { return m_start + m_size; }
+    };
+
+    auto operator += ( std::string& lhs, StringRef const& sr ) -> std::string&;
+    auto operator << ( std::ostream& os, StringRef const& sr ) -> std::ostream&;
+
+    constexpr auto operator "" _sr( char const* rawChars, std::size_t size ) noexcept -> StringRef {
+        return StringRef( rawChars, size );
+    }
+} // namespace Catch
+
+constexpr auto operator "" _catch_sr( char const* rawChars, std::size_t size ) noexcept -> Catch::StringRef {
+    return Catch::StringRef( rawChars, size );
+}
+
+// end catch_stringref.h
+// start catch_preprocessor.hpp
+
+
+#define CATCH_RECURSION_LEVEL0(...) __VA_ARGS__
+#define CATCH_RECURSION_LEVEL1(...) CATCH_RECURSION_LEVEL0(CATCH_RECURSION_LEVEL0(CATCH_RECURSION_LEVEL0(__VA_ARGS__)))
+#define CATCH_RECURSION_LEVEL2(...) CATCH_RECURSION_LEVEL1(CATCH_RECURSION_LEVEL1(CATCH_RECURSION_LEVEL1(__VA_ARGS__)))
+#define CATCH_RECURSION_LEVEL3(...) CATCH_RECURSION_LEVEL2(CATCH_RECURSION_LEVEL2(CATCH_RECURSION_LEVEL2(__VA_ARGS__)))
+#define CATCH_RECURSION_LEVEL4(...) CATCH_RECURSION_LEVEL3(CATCH_RECURSION_LEVEL3(CATCH_RECURSION_LEVEL3(__VA_ARGS__)))
+#define CATCH_RECURSION_LEVEL5(...) CATCH_RECURSION_LEVEL4(CATCH_RECURSION_LEVEL4(CATCH_RECURSION_LEVEL4(__VA_ARGS__)))
+
+#ifdef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#define INTERNAL_CATCH_EXPAND_VARGS(...) __VA_ARGS__
+// MSVC needs more evaluations
+#define CATCH_RECURSION_LEVEL6(...) CATCH_RECURSION_LEVEL5(CATCH_RECURSION_LEVEL5(CATCH_RECURSION_LEVEL5(__VA_ARGS__)))
+#define CATCH_RECURSE(...)  CATCH_RECURSION_LEVEL6(CATCH_RECURSION_LEVEL6(__VA_ARGS__))
+#else
+#define CATCH_RECURSE(...)  CATCH_RECURSION_LEVEL5(__VA_ARGS__)
+#endif
+
+#define CATCH_REC_END(...)
+#define CATCH_REC_OUT
+
+#define CATCH_EMPTY()
+#define CATCH_DEFER(id) id CATCH_EMPTY()
+
+#define CATCH_REC_GET_END2() 0, CATCH_REC_END
+#define CATCH_REC_GET_END1(...) CATCH_REC_GET_END2
+#define CATCH_REC_GET_END(...) CATCH_REC_GET_END1
+#define CATCH_REC_NEXT0(test, next, ...) next CATCH_REC_OUT
+#define CATCH_REC_NEXT1(test, next) CATCH_DEFER ( CATCH_REC_NEXT0 ) ( test, next, 0)
+#define CATCH_REC_NEXT(test, next)  CATCH_REC_NEXT1(CATCH_REC_GET_END test, next)
+
+#define CATCH_REC_LIST0(f, x, peek, ...) , f(x) CATCH_DEFER ( CATCH_REC_NEXT(peek, CATCH_REC_LIST1) ) ( f, peek, __VA_ARGS__ )
+#define CATCH_REC_LIST1(f, x, peek, ...) , f(x) CATCH_DEFER ( CATCH_REC_NEXT(peek, CATCH_REC_LIST0) ) ( f, peek, __VA_ARGS__ )
+#define CATCH_REC_LIST2(f, x, peek, ...)   f(x) CATCH_DEFER ( CATCH_REC_NEXT(peek, CATCH_REC_LIST1) ) ( f, peek, __VA_ARGS__ )
+
+#define CATCH_REC_LIST0_UD(f, userdata, x, peek, ...) , f(userdata, x) CATCH_DEFER ( CATCH_REC_NEXT(peek, CATCH_REC_LIST1_UD) ) ( f, userdata, peek, __VA_ARGS__ )
+#define CATCH_REC_LIST1_UD(f, userdata, x, peek, ...) , f(userdata, x) CATCH_DEFER ( CATCH_REC_NEXT(peek, CATCH_REC_LIST0_UD) ) ( f, userdata, peek, __VA_ARGS__ )
+#define CATCH_REC_LIST2_UD(f, userdata, x, peek, ...)   f(userdata, x) CATCH_DEFER ( CATCH_REC_NEXT(peek, CATCH_REC_LIST1_UD) ) ( f, userdata, peek, __VA_ARGS__ )
+
+// Applies the function macro `f` to each of the remaining parameters, inserts commas between the results,
+// and passes userdata as the first parameter to each invocation,
+// e.g. CATCH_REC_LIST_UD(f, x, a, b, c) evaluates to f(x, a), f(x, b), f(x, c)
+#define CATCH_REC_LIST_UD(f, userdata, ...) CATCH_RECURSE(CATCH_REC_LIST2_UD(f, userdata, __VA_ARGS__, ()()(), ()()(), ()()(), 0))
+
+#define CATCH_REC_LIST(f, ...) CATCH_RECURSE(CATCH_REC_LIST2(f, __VA_ARGS__, ()()(), ()()(), ()()(), 0))
+
+#define INTERNAL_CATCH_EXPAND1(param) INTERNAL_CATCH_EXPAND2(param)
+#define INTERNAL_CATCH_EXPAND2(...) INTERNAL_CATCH_NO## __VA_ARGS__
+#define INTERNAL_CATCH_DEF(...) INTERNAL_CATCH_DEF __VA_ARGS__
+#define INTERNAL_CATCH_NOINTERNAL_CATCH_DEF
+#define INTERNAL_CATCH_STRINGIZE(...) INTERNAL_CATCH_STRINGIZE2(__VA_ARGS__)
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#define INTERNAL_CATCH_STRINGIZE2(...) #__VA_ARGS__
+#define INTERNAL_CATCH_STRINGIZE_WITHOUT_PARENS(param) INTERNAL_CATCH_STRINGIZE(INTERNAL_CATCH_REMOVE_PARENS(param))
+#else
+// MSVC is adding extra space and needs another indirection to expand INTERNAL_CATCH_NOINTERNAL_CATCH_DEF
+#define INTERNAL_CATCH_STRINGIZE2(...) INTERNAL_CATCH_STRINGIZE3(__VA_ARGS__)
+#define INTERNAL_CATCH_STRINGIZE3(...) #__VA_ARGS__
+#define INTERNAL_CATCH_STRINGIZE_WITHOUT_PARENS(param) (INTERNAL_CATCH_STRINGIZE(INTERNAL_CATCH_REMOVE_PARENS(param)) + 1)
+#endif
+
+#define INTERNAL_CATCH_MAKE_NAMESPACE2(...) ns_##__VA_ARGS__
+#define INTERNAL_CATCH_MAKE_NAMESPACE(name) INTERNAL_CATCH_MAKE_NAMESPACE2(name)
+
+#define INTERNAL_CATCH_REMOVE_PARENS(...) INTERNAL_CATCH_EXPAND1(INTERNAL_CATCH_DEF __VA_ARGS__)
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#define INTERNAL_CATCH_MAKE_TYPE_LIST2(...) decltype(get_wrapper<INTERNAL_CATCH_REMOVE_PARENS_GEN(__VA_ARGS__)>())
+#define INTERNAL_CATCH_MAKE_TYPE_LIST(...) INTERNAL_CATCH_MAKE_TYPE_LIST2(INTERNAL_CATCH_REMOVE_PARENS(__VA_ARGS__))
+#else
+#define INTERNAL_CATCH_MAKE_TYPE_LIST2(...) INTERNAL_CATCH_EXPAND_VARGS(decltype(get_wrapper<INTERNAL_CATCH_REMOVE_PARENS_GEN(__VA_ARGS__)>()))
+#define INTERNAL_CATCH_MAKE_TYPE_LIST(...) INTERNAL_CATCH_EXPAND_VARGS(INTERNAL_CATCH_MAKE_TYPE_LIST2(INTERNAL_CATCH_REMOVE_PARENS(__VA_ARGS__)))
+#endif
+
+#define INTERNAL_CATCH_MAKE_TYPE_LISTS_FROM_TYPES(...)\
+    CATCH_REC_LIST(INTERNAL_CATCH_MAKE_TYPE_LIST,__VA_ARGS__)
+
+#define INTERNAL_CATCH_REMOVE_PARENS_1_ARG(_0) INTERNAL_CATCH_REMOVE_PARENS(_0)
+#define INTERNAL_CATCH_REMOVE_PARENS_2_ARG(_0, _1) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_1_ARG(_1)
+#define INTERNAL_CATCH_REMOVE_PARENS_3_ARG(_0, _1, _2) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_2_ARG(_1, _2)
+#define INTERNAL_CATCH_REMOVE_PARENS_4_ARG(_0, _1, _2, _3) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_3_ARG(_1, _2, _3)
+#define INTERNAL_CATCH_REMOVE_PARENS_5_ARG(_0, _1, _2, _3, _4) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_4_ARG(_1, _2, _3, _4)
+#define INTERNAL_CATCH_REMOVE_PARENS_6_ARG(_0, _1, _2, _3, _4, _5) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_5_ARG(_1, _2, _3, _4, _5)
+#define INTERNAL_CATCH_REMOVE_PARENS_7_ARG(_0, _1, _2, _3, _4, _5, _6) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_6_ARG(_1, _2, _3, _4, _5, _6)
+#define INTERNAL_CATCH_REMOVE_PARENS_8_ARG(_0, _1, _2, _3, _4, _5, _6, _7) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_7_ARG(_1, _2, _3, _4, _5, _6, _7)
+#define INTERNAL_CATCH_REMOVE_PARENS_9_ARG(_0, _1, _2, _3, _4, _5, _6, _7, _8) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_8_ARG(_1, _2, _3, _4, _5, _6, _7, _8)
+#define INTERNAL_CATCH_REMOVE_PARENS_10_ARG(_0, _1, _2, _3, _4, _5, _6, _7, _8, _9) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_9_ARG(_1, _2, _3, _4, _5, _6, _7, _8, _9)
+#define INTERNAL_CATCH_REMOVE_PARENS_11_ARG(_0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10) INTERNAL_CATCH_REMOVE_PARENS(_0), INTERNAL_CATCH_REMOVE_PARENS_10_ARG(_1, _2, _3, _4, _5, _6, _7, _8, _9, _10)
+
+#define INTERNAL_CATCH_VA_NARGS_IMPL(_0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, N, ...) N
+
+#define INTERNAL_CATCH_TYPE_GEN\
+    template<typename...> struct TypeList {};\
+    template<typename...Ts>\
+    constexpr auto get_wrapper() noexcept -> TypeList<Ts...> { return {}; }\
+    template<template<typename...> class...> struct TemplateTypeList{};\
+    template<template<typename...> class...Cs>\
+    constexpr auto get_wrapper() noexcept -> TemplateTypeList<Cs...> { return {}; }\
+    template<typename...>\
+    struct append;\
+    template<typename...>\
+    struct rewrap;\
+    template<template<typename...> class, typename...>\
+    struct create;\
+    template<template<typename...> class, typename>\
+    struct convert;\
+    \
+    template<typename T> \
+    struct append<T> { using type = T; };\
+    template< template<typename...> class L1, typename...E1, template<typename...> class L2, typename...E2, typename...Rest>\
+    struct append<L1<E1...>, L2<E2...>, Rest...> { using type = typename append<L1<E1...,E2...>, Rest...>::type; };\
+    template< template<typename...> class L1, typename...E1, typename...Rest>\
+    struct append<L1<E1...>, TypeList<mpl_::na>, Rest...> { using type = L1<E1...>; };\
+    \
+    template< template<typename...> class Container, template<typename...> class List, typename...elems>\
+    struct rewrap<TemplateTypeList<Container>, List<elems...>> { using type = TypeList<Container<elems...>>; };\
+    template< template<typename...> class Container, template<typename...> class List, class...Elems, typename...Elements>\
+    struct rewrap<TemplateTypeList<Container>, List<Elems...>, Elements...> { using type = typename append<TypeList<Container<Elems...>>, typename rewrap<TemplateTypeList<Container>, Elements...>::type>::type; };\
+    \
+    template<template <typename...> class Final, template< typename...> class...Containers, typename...Types>\
+    struct create<Final, TemplateTypeList<Containers...>, TypeList<Types...>> { using type = typename append<Final<>, typename rewrap<TemplateTypeList<Containers>, Types...>::type...>::type; };\
+    template<template <typename...> class Final, template <typename...> class List, typename...Ts>\
+    struct convert<Final, List<Ts...>> { using type = typename append<Final<>,TypeList<Ts>...>::type; };
+
+#define INTERNAL_CATCH_NTTP_1(signature, ...)\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)> struct Nttp{};\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)>\
+    constexpr auto get_wrapper() noexcept -> Nttp<__VA_ARGS__> { return {}; } \
+    template<template<INTERNAL_CATCH_REMOVE_PARENS(signature)> class...> struct NttpTemplateTypeList{};\
+    template<template<INTERNAL_CATCH_REMOVE_PARENS(signature)> class...Cs>\
+    constexpr auto get_wrapper() noexcept -> NttpTemplateTypeList<Cs...> { return {}; } \
+    \
+    template< template<INTERNAL_CATCH_REMOVE_PARENS(signature)> class Container, template<INTERNAL_CATCH_REMOVE_PARENS(signature)> class List, INTERNAL_CATCH_REMOVE_PARENS(signature)>\
+    struct rewrap<NttpTemplateTypeList<Container>, List<__VA_ARGS__>> { using type = TypeList<Container<__VA_ARGS__>>; };\
+    template< template<INTERNAL_CATCH_REMOVE_PARENS(signature)> class Container, template<INTERNAL_CATCH_REMOVE_PARENS(signature)> class List, INTERNAL_CATCH_REMOVE_PARENS(signature), typename...Elements>\
+    struct rewrap<NttpTemplateTypeList<Container>, List<__VA_ARGS__>, Elements...> { using type = typename append<TypeList<Container<__VA_ARGS__>>, typename rewrap<NttpTemplateTypeList<Container>, Elements...>::type>::type; };\
+    template<template <typename...> class Final, template<INTERNAL_CATCH_REMOVE_PARENS(signature)> class...Containers, typename...Types>\
+    struct create<Final, NttpTemplateTypeList<Containers...>, TypeList<Types...>> { using type = typename append<Final<>, typename rewrap<NttpTemplateTypeList<Containers>, Types...>::type...>::type; };
+
+#define INTERNAL_CATCH_DECLARE_SIG_TEST0(TestName)
+#define INTERNAL_CATCH_DECLARE_SIG_TEST1(TestName, signature)\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)>\
+    static void TestName()
+#define INTERNAL_CATCH_DECLARE_SIG_TEST_X(TestName, signature, ...)\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)>\
+    static void TestName()
+
+#define INTERNAL_CATCH_DEFINE_SIG_TEST0(TestName)
+#define INTERNAL_CATCH_DEFINE_SIG_TEST1(TestName, signature)\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)>\
+    static void TestName()
+#define INTERNAL_CATCH_DEFINE_SIG_TEST_X(TestName, signature,...)\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)>\
+    static void TestName()
+
+#define INTERNAL_CATCH_NTTP_REGISTER0(TestFunc, signature)\
+    template<typename Type>\
+    void reg_test(TypeList<Type>, Catch::NameAndTags nameAndTags)\
+    {\
+        Catch::AutoReg( Catch::makeTestInvoker(&TestFunc<Type>), CATCH_INTERNAL_LINEINFO, Catch::StringRef(), nameAndTags);\
+    }
+
+#define INTERNAL_CATCH_NTTP_REGISTER(TestFunc, signature, ...)\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)>\
+    void reg_test(Nttp<__VA_ARGS__>, Catch::NameAndTags nameAndTags)\
+    {\
+        Catch::AutoReg( Catch::makeTestInvoker(&TestFunc<__VA_ARGS__>), CATCH_INTERNAL_LINEINFO, Catch::StringRef(), nameAndTags);\
+    }
+
+#define INTERNAL_CATCH_NTTP_REGISTER_METHOD0(TestName, signature, ...)\
+    template<typename Type>\
+    void reg_test(TypeList<Type>, Catch::StringRef className, Catch::NameAndTags nameAndTags)\
+    {\
+        Catch::AutoReg( Catch::makeTestInvoker(&TestName<Type>::test), CATCH_INTERNAL_LINEINFO, className, nameAndTags);\
+    }
+
+#define INTERNAL_CATCH_NTTP_REGISTER_METHOD(TestName, signature, ...)\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)>\
+    void reg_test(Nttp<__VA_ARGS__>, Catch::StringRef className, Catch::NameAndTags nameAndTags)\
+    {\
+        Catch::AutoReg( Catch::makeTestInvoker(&TestName<__VA_ARGS__>::test), CATCH_INTERNAL_LINEINFO, className, nameAndTags);\
+    }
+
+#define INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD0(TestName, ClassName)
+#define INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD1(TestName, ClassName, signature)\
+    template<typename TestType> \
+    struct TestName : INTERNAL_CATCH_REMOVE_PARENS(ClassName)<TestType> { \
+        void test();\
+    }
+
+#define INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X(TestName, ClassName, signature, ...)\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)> \
+    struct TestName : INTERNAL_CATCH_REMOVE_PARENS(ClassName)<__VA_ARGS__> { \
+        void test();\
+    }
+
+#define INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD0(TestName)
+#define INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD1(TestName, signature)\
+    template<typename TestType> \
+    void INTERNAL_CATCH_MAKE_NAMESPACE(TestName)::TestName<TestType>::test()
+#define INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X(TestName, signature, ...)\
+    template<INTERNAL_CATCH_REMOVE_PARENS(signature)> \
+    void INTERNAL_CATCH_MAKE_NAMESPACE(TestName)::TestName<__VA_ARGS__>::test()
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#define INTERNAL_CATCH_NTTP_0
+#define INTERNAL_CATCH_NTTP_GEN(...) INTERNAL_CATCH_VA_NARGS_IMPL(__VA_ARGS__, INTERNAL_CATCH_NTTP_1(__VA_ARGS__), INTERNAL_CATCH_NTTP_1(__VA_ARGS__), INTERNAL_CATCH_NTTP_1(__VA_ARGS__), INTERNAL_CATCH_NTTP_1(__VA_ARGS__), INTERNAL_CATCH_NTTP_1(__VA_ARGS__), INTERNAL_CATCH_NTTP_1( __VA_ARGS__), INTERNAL_CATCH_NTTP_1( __VA_ARGS__), INTERNAL_CATCH_NTTP_1( __VA_ARGS__), INTERNAL_CATCH_NTTP_1( __VA_ARGS__),INTERNAL_CATCH_NTTP_1( __VA_ARGS__), INTERNAL_CATCH_NTTP_0)
+#define INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD(TestName, ...) INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD1, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD0)(TestName, __VA_ARGS__)
+#define INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD(TestName, ClassName, ...) INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD1, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD0)(TestName, ClassName, __VA_ARGS__)
+#define INTERNAL_CATCH_NTTP_REG_METHOD_GEN(TestName, ...) INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD0, INTERNAL_CATCH_NTTP_REGISTER_METHOD0)(TestName, __VA_ARGS__)
+#define INTERNAL_CATCH_NTTP_REG_GEN(TestFunc, ...) INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER0, INTERNAL_CATCH_NTTP_REGISTER0)(TestFunc, __VA_ARGS__)
+#define INTERNAL_CATCH_DEFINE_SIG_TEST(TestName, ...) INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X,INTERNAL_CATCH_DEFINE_SIG_TEST_X,INTERNAL_CATCH_DEFINE_SIG_TEST1, INTERNAL_CATCH_DEFINE_SIG_TEST0)(TestName, __VA_ARGS__)
+#define INTERNAL_CATCH_DECLARE_SIG_TEST(TestName, ...) INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_DECLARE_SIG_TEST_X,INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X,INTERNAL_CATCH_DECLARE_SIG_TEST_X,INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST1, INTERNAL_CATCH_DECLARE_SIG_TEST0)(TestName, __VA_ARGS__)
+#define INTERNAL_CATCH_REMOVE_PARENS_GEN(...) INTERNAL_CATCH_VA_NARGS_IMPL(__VA_ARGS__, INTERNAL_CATCH_REMOVE_PARENS_11_ARG,INTERNAL_CATCH_REMOVE_PARENS_10_ARG,INTERNAL_CATCH_REMOVE_PARENS_9_ARG,INTERNAL_CATCH_REMOVE_PARENS_8_ARG,INTERNAL_CATCH_REMOVE_PARENS_7_ARG,INTERNAL_CATCH_REMOVE_PARENS_6_ARG,INTERNAL_CATCH_REMOVE_PARENS_5_ARG,INTERNAL_CATCH_REMOVE_PARENS_4_ARG,INTERNAL_CATCH_REMOVE_PARENS_3_ARG,INTERNAL_CATCH_REMOVE_PARENS_2_ARG,INTERNAL_CATCH_REMOVE_PARENS_1_ARG)(__VA_ARGS__)
+#else
+#define INTERNAL_CATCH_NTTP_0(signature)
+#define INTERNAL_CATCH_NTTP_GEN(...) INTERNAL_CATCH_EXPAND_VARGS(INTERNAL_CATCH_VA_NARGS_IMPL(__VA_ARGS__, INTERNAL_CATCH_NTTP_1, INTERNAL_CATCH_NTTP_1, INTERNAL_CATCH_NTTP_1, INTERNAL_CATCH_NTTP_1, INTERNAL_CATCH_NTTP_1, INTERNAL_CATCH_NTTP_1, INTERNAL_CATCH_NTTP_1, INTERNAL_CATCH_NTTP_1, INTERNAL_CATCH_NTTP_1,INTERNAL_CATCH_NTTP_1, INTERNAL_CATCH_NTTP_0)( __VA_ARGS__))
+#define INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD(TestName, ...) INTERNAL_CATCH_EXPAND_VARGS(INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD1, INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD0)(TestName, __VA_ARGS__))
+#define INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD(TestName, ClassName, ...) INTERNAL_CATCH_EXPAND_VARGS(INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X,INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD_X, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD1, INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD0)(TestName, ClassName, __VA_ARGS__))
+#define INTERNAL_CATCH_NTTP_REG_METHOD_GEN(TestName, ...) INTERNAL_CATCH_EXPAND_VARGS(INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD, INTERNAL_CATCH_NTTP_REGISTER_METHOD0, INTERNAL_CATCH_NTTP_REGISTER_METHOD0)(TestName, __VA_ARGS__))
+#define INTERNAL_CATCH_NTTP_REG_GEN(TestFunc, ...) INTERNAL_CATCH_EXPAND_VARGS(INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER, INTERNAL_CATCH_NTTP_REGISTER0, INTERNAL_CATCH_NTTP_REGISTER0)(TestFunc, __VA_ARGS__))
+#define INTERNAL_CATCH_DEFINE_SIG_TEST(TestName, ...) INTERNAL_CATCH_EXPAND_VARGS(INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X,INTERNAL_CATCH_DEFINE_SIG_TEST_X,INTERNAL_CATCH_DEFINE_SIG_TEST1, INTERNAL_CATCH_DEFINE_SIG_TEST0)(TestName, __VA_ARGS__))
+#define INTERNAL_CATCH_DECLARE_SIG_TEST(TestName, ...) INTERNAL_CATCH_EXPAND_VARGS(INTERNAL_CATCH_VA_NARGS_IMPL( "dummy", __VA_ARGS__, INTERNAL_CATCH_DECLARE_SIG_TEST_X,INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DEFINE_SIG_TEST_X,INTERNAL_CATCH_DECLARE_SIG_TEST_X,INTERNAL_CATCH_DECLARE_SIG_TEST_X, INTERNAL_CATCH_DECLARE_SIG_TEST1, INTERNAL_CATCH_DECLARE_SIG_TEST0)(TestName, __VA_ARGS__))
+#define INTERNAL_CATCH_REMOVE_PARENS_GEN(...) INTERNAL_CATCH_EXPAND_VARGS(INTERNAL_CATCH_VA_NARGS_IMPL(__VA_ARGS__, INTERNAL_CATCH_REMOVE_PARENS_11_ARG,INTERNAL_CATCH_REMOVE_PARENS_10_ARG,INTERNAL_CATCH_REMOVE_PARENS_9_ARG,INTERNAL_CATCH_REMOVE_PARENS_8_ARG,INTERNAL_CATCH_REMOVE_PARENS_7_ARG,INTERNAL_CATCH_REMOVE_PARENS_6_ARG,INTERNAL_CATCH_REMOVE_PARENS_5_ARG,INTERNAL_CATCH_REMOVE_PARENS_4_ARG,INTERNAL_CATCH_REMOVE_PARENS_3_ARG,INTERNAL_CATCH_REMOVE_PARENS_2_ARG,INTERNAL_CATCH_REMOVE_PARENS_1_ARG)(__VA_ARGS__))
+#endif
+
+// end catch_preprocessor.hpp
+// start catch_meta.hpp
+
+
+#include <type_traits>
+
+namespace Catch {
+    template<typename T>
+    struct always_false : std::false_type {};
+
+    template <typename> struct true_given : std::true_type {};
+    struct is_callable_tester {
+        template <typename Fun, typename... Args>
+        true_given<decltype(std::declval<Fun>()(std::declval<Args>()...))> static test(int);
+        template <typename...>
+        std::false_type static test(...);
+    };
+
+    template <typename T>
+    struct is_callable;
+
+    template <typename Fun, typename... Args>
+    struct is_callable<Fun(Args...)> : decltype(is_callable_tester::test<Fun, Args...>(0)) {};
+
+#if defined(__cpp_lib_is_invocable) && __cpp_lib_is_invocable >= 201703
+    // std::result_of is deprecated in C++17 and removed in C++20. Hence, it is
+    // replaced with std::invoke_result here.
+    template <typename Func, typename... U>
+    using FunctionReturnType = std::remove_reference_t<std::remove_cv_t<std::invoke_result_t<Func, U...>>>;
+#else
+    // Keep ::type here because we still support C++11
+    template <typename Func, typename... U>
+    using FunctionReturnType = typename std::remove_reference<typename std::remove_cv<typename std::result_of<Func(U...)>::type>::type>::type;
+#endif
+
+} // namespace Catch
+
+namespace mpl_{
+    struct na;
+}
+
+// end catch_meta.hpp
+namespace Catch {
+
+template<typename C>
+class TestInvokerAsMethod : public ITestInvoker {
+    void (C::*m_testAsMethod)();
+public:
+    TestInvokerAsMethod( void (C::*testAsMethod)() ) noexcept : m_testAsMethod( testAsMethod ) {}
+
+    void invoke() const override {
+        C obj;
+        (obj.*m_testAsMethod)();
+    }
+};
+
+auto makeTestInvoker( void(*testAsFunction)() ) noexcept -> ITestInvoker*;
+
+template<typename C>
+auto makeTestInvoker( void (C::*testAsMethod)() ) noexcept -> ITestInvoker* {
+    return new(std::nothrow) TestInvokerAsMethod<C>( testAsMethod );
+}
+
+struct NameAndTags {
+    NameAndTags( StringRef const& name_ = StringRef(), StringRef const& tags_ = StringRef() ) noexcept;
+    StringRef name;
+    StringRef tags;
+};
+
+struct AutoReg : NonCopyable {
+    AutoReg( ITestInvoker* invoker, SourceLineInfo const& lineInfo, StringRef const& classOrMethod, NameAndTags const& nameAndTags ) noexcept;
+    ~AutoReg();
+};
+
+} // end namespace Catch
+
+#if defined(CATCH_CONFIG_DISABLE)
+    #define INTERNAL_CATCH_TESTCASE_NO_REGISTRATION( TestName, ... ) \
+        static void TestName()
+    #define INTERNAL_CATCH_TESTCASE_METHOD_NO_REGISTRATION( TestName, ClassName, ... ) \
+        namespace{                        \
+            struct TestName : INTERNAL_CATCH_REMOVE_PARENS(ClassName) { \
+                void test();              \
+            };                            \
+        }                                 \
+        void TestName::test()
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION_2( TestName, TestFunc, Name, Tags, Signature, ... )  \
+        INTERNAL_CATCH_DEFINE_SIG_TEST(TestFunc, INTERNAL_CATCH_REMOVE_PARENS(Signature))
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION_2( TestNameClass, TestName, ClassName, Name, Tags, Signature, ... )    \
+        namespace{                                                                                  \
+            namespace INTERNAL_CATCH_MAKE_NAMESPACE(TestName) {                                      \
+            INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD(TestName, ClassName, INTERNAL_CATCH_REMOVE_PARENS(Signature));\
+        }                                                                                           \
+        }                                                                                           \
+        INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD(TestName, INTERNAL_CATCH_REMOVE_PARENS(Signature))
+
+    #ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+        #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION(Name, Tags, ...) \
+            INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, typename TestType, __VA_ARGS__ )
+    #else
+        #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION(Name, Tags, ...) \
+            INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, typename TestType, __VA_ARGS__ ) )
+    #endif
+
+    #ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+        #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG_NO_REGISTRATION(Name, Tags, Signature, ...) \
+            INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, Signature, __VA_ARGS__ )
+    #else
+        #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG_NO_REGISTRATION(Name, Tags, Signature, ...) \
+            INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, Signature, __VA_ARGS__ ) )
+    #endif
+
+    #ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+        #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION( ClassName, Name, Tags,... ) \
+            INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_C_L_A_S_S_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ) , ClassName, Name, Tags, typename T, __VA_ARGS__ )
+    #else
+        #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION( ClassName, Name, Tags,... ) \
+            INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_C_L_A_S_S_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ) , ClassName, Name, Tags, typename T, __VA_ARGS__ ) )
+    #endif
+
+    #ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+        #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG_NO_REGISTRATION( ClassName, Name, Tags, Signature, ... ) \
+            INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_C_L_A_S_S_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ) , ClassName, Name, Tags, Signature, __VA_ARGS__ )
+    #else
+        #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG_NO_REGISTRATION( ClassName, Name, Tags, Signature, ... ) \
+            INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_C_L_A_S_S_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ) , ClassName, Name, Tags, Signature, __VA_ARGS__ ) )
+    #endif
+#endif
+
+    ///////////////////////////////////////////////////////////////////////////////
+    #define INTERNAL_CATCH_TESTCASE2( TestName, ... ) \
+        static void TestName(); \
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+        namespace{ Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( Catch::makeTestInvoker( &TestName ), CATCH_INTERNAL_LINEINFO, Catch::StringRef(), Catch::NameAndTags{ __VA_ARGS__ } ); } /* NOLINT */ \
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION \
+        static void TestName()
+    #define INTERNAL_CATCH_TESTCASE( ... ) \
+        INTERNAL_CATCH_TESTCASE2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ), __VA_ARGS__ )
+
+    ///////////////////////////////////////////////////////////////////////////////
+    #define INTERNAL_CATCH_METHOD_AS_TEST_CASE( QualifiedMethod, ... ) \
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+        namespace{ Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( Catch::makeTestInvoker( &QualifiedMethod ), CATCH_INTERNAL_LINEINFO, "&" #QualifiedMethod, Catch::NameAndTags{ __VA_ARGS__ } ); } /* NOLINT */ \
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
+
+    ///////////////////////////////////////////////////////////////////////////////
+    #define INTERNAL_CATCH_TEST_CASE_METHOD2( TestName, ClassName, ... )\
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+        namespace{ \
+            struct TestName : INTERNAL_CATCH_REMOVE_PARENS(ClassName) { \
+                void test(); \
+            }; \
+            Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar ) ( Catch::makeTestInvoker( &TestName::test ), CATCH_INTERNAL_LINEINFO, #ClassName, Catch::NameAndTags{ __VA_ARGS__ } ); /* NOLINT */ \
+        } \
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION \
+        void TestName::test()
+    #define INTERNAL_CATCH_TEST_CASE_METHOD( ClassName, ... ) \
+        INTERNAL_CATCH_TEST_CASE_METHOD2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ), ClassName, __VA_ARGS__ )
+
+    ///////////////////////////////////////////////////////////////////////////////
+    #define INTERNAL_CATCH_REGISTER_TESTCASE( Function, ... ) \
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+        Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( Catch::makeTestInvoker( Function ), CATCH_INTERNAL_LINEINFO, Catch::StringRef(), Catch::NameAndTags{ __VA_ARGS__ } ); /* NOLINT */ \
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
+
+    ///////////////////////////////////////////////////////////////////////////////
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_2(TestName, TestFunc, Name, Tags, Signature, ... )\
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+        CATCH_INTERNAL_SUPPRESS_ZERO_VARIADIC_WARNINGS \
+        CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS \
+        INTERNAL_CATCH_DECLARE_SIG_TEST(TestFunc, INTERNAL_CATCH_REMOVE_PARENS(Signature));\
+        namespace {\
+        namespace INTERNAL_CATCH_MAKE_NAMESPACE(TestName){\
+            INTERNAL_CATCH_TYPE_GEN\
+            INTERNAL_CATCH_NTTP_GEN(INTERNAL_CATCH_REMOVE_PARENS(Signature))\
+            INTERNAL_CATCH_NTTP_REG_GEN(TestFunc,INTERNAL_CATCH_REMOVE_PARENS(Signature))\
+            template<typename...Types> \
+            struct TestName{\
+                TestName(){\
+                    int index = 0;                                    \
+                    constexpr char const* tmpl_types[] = {CATCH_REC_LIST(INTERNAL_CATCH_STRINGIZE_WITHOUT_PARENS, __VA_ARGS__)};\
+                    using expander = int[];\
+                    (void)expander{(reg_test(Types{}, Catch::NameAndTags{ Name " - " + std::string(tmpl_types[index]), Tags } ), index++)... };/* NOLINT */ \
+                }\
+            };\
+            static int INTERNAL_CATCH_UNIQUE_NAME( globalRegistrar ) = [](){\
+            TestName<INTERNAL_CATCH_MAKE_TYPE_LISTS_FROM_TYPES(__VA_ARGS__)>();\
+            return 0;\
+        }();\
+        }\
+        }\
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION \
+        INTERNAL_CATCH_DEFINE_SIG_TEST(TestFunc,INTERNAL_CATCH_REMOVE_PARENS(Signature))
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE(Name, Tags, ...) \
+        INTERNAL_CATCH_TEMPLATE_TEST_CASE_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, typename TestType, __VA_ARGS__ )
+#else
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE(Name, Tags, ...) \
+        INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, typename TestType, __VA_ARGS__ ) )
+#endif
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG(Name, Tags, Signature, ...) \
+        INTERNAL_CATCH_TEMPLATE_TEST_CASE_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, Signature, __VA_ARGS__ )
+#else
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG(Name, Tags, Signature, ...) \
+        INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, Signature, __VA_ARGS__ ) )
+#endif
+
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE2(TestName, TestFuncName, Name, Tags, Signature, TmplTypes, TypesList) \
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION                      \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS                      \
+        CATCH_INTERNAL_SUPPRESS_ZERO_VARIADIC_WARNINGS                \
+        CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS              \
+        template<typename TestType> static void TestFuncName();       \
+        namespace {\
+        namespace INTERNAL_CATCH_MAKE_NAMESPACE(TestName) {                                     \
+            INTERNAL_CATCH_TYPE_GEN                                                  \
+            INTERNAL_CATCH_NTTP_GEN(INTERNAL_CATCH_REMOVE_PARENS(Signature))         \
+            template<typename... Types>                               \
+            struct TestName {                                         \
+                void reg_tests() {                                          \
+                    int index = 0;                                    \
+                    using expander = int[];                           \
+                    constexpr char const* tmpl_types[] = {CATCH_REC_LIST(INTERNAL_CATCH_STRINGIZE_WITHOUT_PARENS, INTERNAL_CATCH_REMOVE_PARENS(TmplTypes))};\
+                    constexpr char const* types_list[] = {CATCH_REC_LIST(INTERNAL_CATCH_STRINGIZE_WITHOUT_PARENS, INTERNAL_CATCH_REMOVE_PARENS(TypesList))};\
+                    constexpr auto num_types = sizeof(types_list) / sizeof(types_list[0]);\
+                    (void)expander{(Catch::AutoReg( Catch::makeTestInvoker( &TestFuncName<Types> ), CATCH_INTERNAL_LINEINFO, Catch::StringRef(), Catch::NameAndTags{ Name " - " + std::string(tmpl_types[index / num_types]) + "<" + std::string(types_list[index % num_types]) + ">", Tags } ), index++)... };/* NOLINT */\
+                }                                                     \
+            };                                                        \
+            static int INTERNAL_CATCH_UNIQUE_NAME( globalRegistrar ) = [](){ \
+                using TestInit = typename create<TestName, decltype(get_wrapper<INTERNAL_CATCH_REMOVE_PARENS(TmplTypes)>()), TypeList<INTERNAL_CATCH_MAKE_TYPE_LISTS_FROM_TYPES(INTERNAL_CATCH_REMOVE_PARENS(TypesList))>>::type; \
+                TestInit t;                                           \
+                t.reg_tests();                                        \
+                return 0;                                             \
+            }();                                                      \
+        }                                                             \
+        }                                                             \
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION                       \
+        template<typename TestType>                                   \
+        static void TestFuncName()
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE(Name, Tags, ...)\
+        INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE2(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, typename T,__VA_ARGS__)
+#else
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE(Name, Tags, ...)\
+        INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, typename T, __VA_ARGS__ ) )
+#endif
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG(Name, Tags, Signature, ...)\
+        INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE2(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, Signature, __VA_ARGS__)
+#else
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG(Name, Tags, Signature, ...)\
+        INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, Signature, __VA_ARGS__ ) )
+#endif
+
+    #define INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE_2(TestName, TestFunc, Name, Tags, TmplList)\
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+        CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS \
+        template<typename TestType> static void TestFunc();       \
+        namespace {\
+        namespace INTERNAL_CATCH_MAKE_NAMESPACE(TestName){\
+        INTERNAL_CATCH_TYPE_GEN\
+        template<typename... Types>                               \
+        struct TestName {                                         \
+            void reg_tests() {                                          \
+                int index = 0;                                    \
+                using expander = int[];                           \
+                (void)expander{(Catch::AutoReg( Catch::makeTestInvoker( &TestFunc<Types> ), CATCH_INTERNAL_LINEINFO, Catch::StringRef(), Catch::NameAndTags{ Name " - " + std::string(INTERNAL_CATCH_STRINGIZE(TmplList)) + " - " + std::to_string(index), Tags } ), index++)... };/* NOLINT */\
+            }                                                     \
+        };\
+        static int INTERNAL_CATCH_UNIQUE_NAME( globalRegistrar ) = [](){ \
+                using TestInit = typename convert<TestName, TmplList>::type; \
+                TestInit t;                                           \
+                t.reg_tests();                                        \
+                return 0;                                             \
+            }();                                                      \
+        }}\
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION                       \
+        template<typename TestType>                                   \
+        static void TestFunc()
+
+    #define INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE(Name, Tags, TmplList) \
+        INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), Name, Tags, TmplList )
+
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_2( TestNameClass, TestName, ClassName, Name, Tags, Signature, ... ) \
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+        CATCH_INTERNAL_SUPPRESS_ZERO_VARIADIC_WARNINGS \
+        CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS \
+        namespace {\
+        namespace INTERNAL_CATCH_MAKE_NAMESPACE(TestName){ \
+            INTERNAL_CATCH_TYPE_GEN\
+            INTERNAL_CATCH_NTTP_GEN(INTERNAL_CATCH_REMOVE_PARENS(Signature))\
+            INTERNAL_CATCH_DECLARE_SIG_TEST_METHOD(TestName, ClassName, INTERNAL_CATCH_REMOVE_PARENS(Signature));\
+            INTERNAL_CATCH_NTTP_REG_METHOD_GEN(TestName, INTERNAL_CATCH_REMOVE_PARENS(Signature))\
+            template<typename...Types> \
+            struct TestNameClass{\
+                TestNameClass(){\
+                    int index = 0;                                    \
+                    constexpr char const* tmpl_types[] = {CATCH_REC_LIST(INTERNAL_CATCH_STRINGIZE_WITHOUT_PARENS, __VA_ARGS__)};\
+                    using expander = int[];\
+                    (void)expander{(reg_test(Types{}, #ClassName, Catch::NameAndTags{ Name " - " + std::string(tmpl_types[index]), Tags } ), index++)... };/* NOLINT */ \
+                }\
+            };\
+            static int INTERNAL_CATCH_UNIQUE_NAME( globalRegistrar ) = [](){\
+                TestNameClass<INTERNAL_CATCH_MAKE_TYPE_LISTS_FROM_TYPES(__VA_ARGS__)>();\
+                return 0;\
+        }();\
+        }\
+        }\
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION \
+        INTERNAL_CATCH_DEFINE_SIG_TEST_METHOD(TestName, INTERNAL_CATCH_REMOVE_PARENS(Signature))
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD( ClassName, Name, Tags,... ) \
+        INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_C_L_A_S_S_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ) , ClassName, Name, Tags, typename T, __VA_ARGS__ )
+#else
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD( ClassName, Name, Tags,... ) \
+        INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_C_L_A_S_S_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ) , ClassName, Name, Tags, typename T, __VA_ARGS__ ) )
+#endif
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( ClassName, Name, Tags, Signature, ... ) \
+        INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_C_L_A_S_S_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ) , ClassName, Name, Tags, Signature, __VA_ARGS__ )
+#else
+    #define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( ClassName, Name, Tags, Signature, ... ) \
+        INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_C_L_A_S_S_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ) , ClassName, Name, Tags, Signature, __VA_ARGS__ ) )
+#endif
+
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_2(TestNameClass, TestName, ClassName, Name, Tags, Signature, TmplTypes, TypesList)\
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+        CATCH_INTERNAL_SUPPRESS_ZERO_VARIADIC_WARNINGS \
+        CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS \
+        template<typename TestType> \
+            struct TestName : INTERNAL_CATCH_REMOVE_PARENS(ClassName <TestType>) { \
+                void test();\
+            };\
+        namespace {\
+        namespace INTERNAL_CATCH_MAKE_NAMESPACE(TestNameClass) {\
+            INTERNAL_CATCH_TYPE_GEN                  \
+            INTERNAL_CATCH_NTTP_GEN(INTERNAL_CATCH_REMOVE_PARENS(Signature))\
+            template<typename...Types>\
+            struct TestNameClass{\
+                void reg_tests(){\
+                    int index = 0;\
+                    using expander = int[];\
+                    constexpr char const* tmpl_types[] = {CATCH_REC_LIST(INTERNAL_CATCH_STRINGIZE_WITHOUT_PARENS, INTERNAL_CATCH_REMOVE_PARENS(TmplTypes))};\
+                    constexpr char const* types_list[] = {CATCH_REC_LIST(INTERNAL_CATCH_STRINGIZE_WITHOUT_PARENS, INTERNAL_CATCH_REMOVE_PARENS(TypesList))};\
+                    constexpr auto num_types = sizeof(types_list) / sizeof(types_list[0]);\
+                    (void)expander{(Catch::AutoReg( Catch::makeTestInvoker( &TestName<Types>::test ), CATCH_INTERNAL_LINEINFO, #ClassName, Catch::NameAndTags{ Name " - " + std::string(tmpl_types[index / num_types]) + "<" + std::string(types_list[index % num_types]) + ">", Tags } ), index++)... };/* NOLINT */ \
+                }\
+            };\
+            static int INTERNAL_CATCH_UNIQUE_NAME( globalRegistrar ) = [](){\
+                using TestInit = typename create<TestNameClass, decltype(get_wrapper<INTERNAL_CATCH_REMOVE_PARENS(TmplTypes)>()), TypeList<INTERNAL_CATCH_MAKE_TYPE_LISTS_FROM_TYPES(INTERNAL_CATCH_REMOVE_PARENS(TypesList))>>::type;\
+                TestInit t;\
+                t.reg_tests();\
+                return 0;\
+            }(); \
+        }\
+        }\
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION \
+        template<typename TestType> \
+        void TestName<TestType>::test()
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( ClassName, Name, Tags, ... )\
+        INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), ClassName, Name, Tags, typename T, __VA_ARGS__ )
+#else
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( ClassName, Name, Tags, ... )\
+        INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), ClassName, Name, Tags, typename T,__VA_ARGS__ ) )
+#endif
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( ClassName, Name, Tags, Signature, ... )\
+        INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), ClassName, Name, Tags, Signature, __VA_ARGS__ )
+#else
+    #define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( ClassName, Name, Tags, Signature, ... )\
+        INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), ClassName, Name, Tags, Signature,__VA_ARGS__ ) )
+#endif
+
+    #define INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE_METHOD_2( TestNameClass, TestName, ClassName, Name, Tags, TmplList) \
+        CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+        CATCH_INTERNAL_SUPPRESS_UNUSED_TEMPLATE_WARNINGS \
+        template<typename TestType> \
+        struct TestName : INTERNAL_CATCH_REMOVE_PARENS(ClassName <TestType>) { \
+            void test();\
+        };\
+        namespace {\
+        namespace INTERNAL_CATCH_MAKE_NAMESPACE(TestName){ \
+            INTERNAL_CATCH_TYPE_GEN\
+            template<typename...Types>\
+            struct TestNameClass{\
+                void reg_tests(){\
+                    int index = 0;\
+                    using expander = int[];\
+                    (void)expander{(Catch::AutoReg( Catch::makeTestInvoker( &TestName<Types>::test ), CATCH_INTERNAL_LINEINFO, #ClassName, Catch::NameAndTags{ Name " - " + std::string(INTERNAL_CATCH_STRINGIZE(TmplList)) + " - " + std::to_string(index), Tags } ), index++)... };/* NOLINT */ \
+                }\
+            };\
+            static int INTERNAL_CATCH_UNIQUE_NAME( globalRegistrar ) = [](){\
+                using TestInit = typename convert<TestNameClass, TmplList>::type;\
+                TestInit t;\
+                t.reg_tests();\
+                return 0;\
+            }(); \
+        }}\
+        CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION \
+        template<typename TestType> \
+        void TestName<TestType>::test()
+
+#define INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE_METHOD(ClassName, Name, Tags, TmplList) \
+        INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE_METHOD_2( INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_ ), INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_M_P_L_A_T_E_T_E_S_T_F_U_N_C_ ), ClassName, Name, Tags, TmplList )
+
+// end catch_test_registry.h
+// start catch_capture.hpp
+
+// start catch_assertionhandler.h
+
+// start catch_assertioninfo.h
+
+// start catch_result_type.h
+
+namespace Catch {
+
+    // ResultWas::OfType enum
+    struct ResultWas { enum OfType {
+        Unknown = -1,
+        Ok = 0,
+        Info = 1,
+        Warning = 2,
+
+        FailureBit = 0x10,
+
+        ExpressionFailed = FailureBit | 1,
+        ExplicitFailure = FailureBit | 2,
+
+        Exception = 0x100 | FailureBit,
+
+        ThrewException = Exception | 1,
+        DidntThrowException = Exception | 2,
+
+        FatalErrorCondition = 0x200 | FailureBit
+
+    }; };
+
+    bool isOk( ResultWas::OfType resultType );
+    bool isJustInfo( int flags );
+
+    // ResultDisposition::Flags enum
+    struct ResultDisposition { enum Flags {
+        Normal = 0x01,
+
+        ContinueOnFailure = 0x02,   // Failures fail test, but execution continues
+        FalseTest = 0x04,           // Prefix expression with !
+        SuppressFail = 0x08         // Failures are reported but do not fail the test
+    }; };
+
+    ResultDisposition::Flags operator | ( ResultDisposition::Flags lhs, ResultDisposition::Flags rhs );
+
+    bool shouldContinueOnFailure( int flags );
+    inline bool isFalseTest( int flags ) { return ( flags & ResultDisposition::FalseTest ) != 0; }
+    bool shouldSuppressFailure( int flags );
+
+} // end namespace Catch
+
+// end catch_result_type.h
+namespace Catch {
+
+    struct AssertionInfo
+    {
+        StringRef macroName;
+        SourceLineInfo lineInfo;
+        StringRef capturedExpression;
+        ResultDisposition::Flags resultDisposition;
+
+        // We want to delete this constructor but a compiler bug in 4.8 means
+        // the struct is then treated as non-aggregate
+        //AssertionInfo() = delete;
+    };
+
+} // end namespace Catch
+
+// end catch_assertioninfo.h
+// start catch_decomposer.h
+
+// start catch_tostring.h
+
+#include <vector>
+#include <cstddef>
+#include <type_traits>
+#include <string>
+// start catch_stream.h
+
+#include <iosfwd>
+#include <cstddef>
+#include <ostream>
+
+namespace Catch {
+
+    std::ostream& cout();
+    std::ostream& cerr();
+    std::ostream& clog();
+
+    class StringRef;
+
+    struct IStream {
+        virtual ~IStream();
+        virtual std::ostream& stream() const = 0;
+    };
+
+    auto makeStream( StringRef const &filename ) -> IStream const*;
+
+    class ReusableStringStream : NonCopyable {
+        std::size_t m_index;
+        std::ostream* m_oss;
+    public:
+        ReusableStringStream();
+        ~ReusableStringStream();
+
+        auto str() const -> std::string;
+
+        template<typename T>
+        auto operator << ( T const& value ) -> ReusableStringStream& {
+            *m_oss << value;
+            return *this;
+        }
+        auto get() -> std::ostream& { return *m_oss; }
+    };
+}
+
+// end catch_stream.h
+// start catch_interfaces_enum_values_registry.h
+
+#include <vector>
+
+namespace Catch {
+
+    namespace Detail {
+        struct EnumInfo {
+            StringRef m_name;
+            std::vector<std::pair<int, StringRef>> m_values;
+
+            ~EnumInfo();
+
+            StringRef lookup( int value ) const;
+        };
+    } // namespace Detail
+
+    struct IMutableEnumValuesRegistry {
+        virtual ~IMutableEnumValuesRegistry();
+
+        virtual Detail::EnumInfo const& registerEnum( StringRef enumName, StringRef allEnums, std::vector<int> const& values ) = 0;
+
+        template<typename E>
+        Detail::EnumInfo const& registerEnum( StringRef enumName, StringRef allEnums, std::initializer_list<E> values ) {
+            static_assert(sizeof(int) >= sizeof(E), "Cannot serialize enum to int");
+            std::vector<int> intValues;
+            intValues.reserve( values.size() );
+            for( auto enumValue : values )
+                intValues.push_back( static_cast<int>( enumValue ) );
+            return registerEnum( enumName, allEnums, intValues );
+        }
+    };
+
+} // Catch
+
+// end catch_interfaces_enum_values_registry.h
+
+#ifdef CATCH_CONFIG_CPP17_STRING_VIEW
+#include <string_view>
+#endif
+
+#ifdef __OBJC__
+// start catch_objc_arc.hpp
+
+#import <Foundation/Foundation.h>
+
+#ifdef __has_feature
+#define CATCH_ARC_ENABLED __has_feature(objc_arc)
+#else
+#define CATCH_ARC_ENABLED 0
+#endif
+
+void arcSafeRelease( NSObject* obj );
+id performOptionalSelector( id obj, SEL sel );
+
+#if !CATCH_ARC_ENABLED
+inline void arcSafeRelease( NSObject* obj ) {
+    [obj release];
+}
+inline id performOptionalSelector( id obj, SEL sel ) {
+    if( [obj respondsToSelector: sel] )
+        return [obj performSelector: sel];
+    return nil;
+}
+#define CATCH_UNSAFE_UNRETAINED
+#define CATCH_ARC_STRONG
+#else
+inline void arcSafeRelease( NSObject* ){}
+inline id performOptionalSelector( id obj, SEL sel ) {
+#ifdef __clang__
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
+#endif
+    if( [obj respondsToSelector: sel] )
+        return [obj performSelector: sel];
+#ifdef __clang__
+#pragma clang diagnostic pop
+#endif
+    return nil;
+}
+#define CATCH_UNSAFE_UNRETAINED __unsafe_unretained
+#define CATCH_ARC_STRONG __strong
+#endif
+
+// end catch_objc_arc.hpp
+#endif
+
+#ifdef _MSC_VER
+#pragma warning(push)
+#pragma warning(disable:4180) // We attempt to stream a function (address) by const&, which MSVC complains about but is harmless
+#endif
+
+namespace Catch {
+    namespace Detail {
+
+        extern const std::string unprintableString;
+
+        std::string rawMemoryToString( const void *object, std::size_t size );
+
+        template<typename T>
+        std::string rawMemoryToString( const T& object ) {
+          return rawMemoryToString( &object, sizeof(object) );
+        }
+
+        template<typename T>
+        class IsStreamInsertable {
+            template<typename Stream, typename U>
+            static auto test(int)
+                -> decltype(std::declval<Stream&>() << std::declval<U>(), std::true_type());
+
+            template<typename, typename>
+            static auto test(...)->std::false_type;
+
+        public:
+            static const bool value = decltype(test<std::ostream, const T&>(0))::value;
+        };
+
+        template<typename E>
+        std::string convertUnknownEnumToString( E e );
+
+        template<typename T>
+        typename std::enable_if<
+            !std::is_enum<T>::value && !std::is_base_of<std::exception, T>::value,
+        std::string>::type convertUnstreamable( T const& ) {
+            return Detail::unprintableString;
+        }
+        template<typename T>
+        typename std::enable_if<
+            !std::is_enum<T>::value && std::is_base_of<std::exception, T>::value,
+         std::string>::type convertUnstreamable(T const& ex) {
+            return ex.what();
+        }
+
+        template<typename T>
+        typename std::enable_if<
+            std::is_enum<T>::value
+        , std::string>::type convertUnstreamable( T const& value ) {
+            return convertUnknownEnumToString( value );
+        }
+
+#if defined(_MANAGED)
+        //! Convert a CLR string to a utf8 std::string
+        template<typename T>
+        std::string clrReferenceToString( T^ ref ) {
+            if (ref == nullptr)
+                return std::string("null");
+            auto bytes = System::Text::Encoding::UTF8->GetBytes(ref->ToString());
+            cli::pin_ptr<System::Byte> p = &bytes[0];
+            return std::string(reinterpret_cast<char const *>(p), bytes->Length);
+        }
+#endif
+
+    } // namespace Detail
+
+    // If we decide for C++14, change these to enable_if_ts
+    template <typename T, typename = void>
+    struct StringMaker {
+        template <typename Fake = T>
+        static
+        typename std::enable_if<::Catch::Detail::IsStreamInsertable<Fake>::value, std::string>::type
+            convert(const Fake& value) {
+                ReusableStringStream rss;
+                // NB: call using the function-like syntax to avoid ambiguity with
+                // user-defined templated operator<< under clang.
+                rss.operator<<(value);
+                return rss.str();
+        }
+
+        template <typename Fake = T>
+        static
+        typename std::enable_if<!::Catch::Detail::IsStreamInsertable<Fake>::value, std::string>::type
+            convert( const Fake& value ) {
+#if !defined(CATCH_CONFIG_FALLBACK_STRINGIFIER)
+            return Detail::convertUnstreamable(value);
+#else
+            return CATCH_CONFIG_FALLBACK_STRINGIFIER(value);
+#endif
+        }
+    };
+
+    namespace Detail {
+
+        // This function dispatches all stringification requests inside of Catch.
+        // Should be preferably called fully qualified, like ::Catch::Detail::stringify
+        template <typename T>
+        std::string stringify(const T& e) {
+            return ::Catch::StringMaker<typename std::remove_cv<typename std::remove_reference<T>::type>::type>::convert(e);
+        }
+
+        template<typename E>
+        std::string convertUnknownEnumToString( E e ) {
+            return ::Catch::Detail::stringify(static_cast<typename std::underlying_type<E>::type>(e));
+        }
+
+#if defined(_MANAGED)
+        template <typename T>
+        std::string stringify( T^ e ) {
+            return ::Catch::StringMaker<T^>::convert(e);
+        }
+#endif
+
+    } // namespace Detail
+
+    // Some predefined specializations
+
+    template<>
+    struct StringMaker<std::string> {
+        static std::string convert(const std::string& str);
+    };
+
+#ifdef CATCH_CONFIG_CPP17_STRING_VIEW
+    template<>
+    struct StringMaker<std::string_view> {
+        static std::string convert(std::string_view str);
+    };
+#endif
+
+    template<>
+    struct StringMaker<char const *> {
+        static std::string convert(char const * str);
+    };
+    template<>
+    struct StringMaker<char *> {
+        static std::string convert(char * str);
+    };
+
+#ifdef CATCH_CONFIG_WCHAR
+    template<>
+    struct StringMaker<std::wstring> {
+        static std::string convert(const std::wstring& wstr);
+    };
+
+# ifdef CATCH_CONFIG_CPP17_STRING_VIEW
+    template<>
+    struct StringMaker<std::wstring_view> {
+        static std::string convert(std::wstring_view str);
+    };
+# endif
+
+    template<>
+    struct StringMaker<wchar_t const *> {
+        static std::string convert(wchar_t const * str);
+    };
+    template<>
+    struct StringMaker<wchar_t *> {
+        static std::string convert(wchar_t * str);
+    };
+#endif
+
+    // TBD: Should we use `strnlen` to ensure that we don't go out of the buffer,
+    //      while keeping string semantics?
+    template<int SZ>
+    struct StringMaker<char[SZ]> {
+        static std::string convert(char const* str) {
+            return ::Catch::Detail::stringify(std::string{ str });
+        }
+    };
+    template<int SZ>
+    struct StringMaker<signed char[SZ]> {
+        static std::string convert(signed char const* str) {
+            return ::Catch::Detail::stringify(std::string{ reinterpret_cast<char const *>(str) });
+        }
+    };
+    template<int SZ>
+    struct StringMaker<unsigned char[SZ]> {
+        static std::string convert(unsigned char const* str) {
+            return ::Catch::Detail::stringify(std::string{ reinterpret_cast<char const *>(str) });
+        }
+    };
+
+#if defined(CATCH_CONFIG_CPP17_BYTE)
+    template<>
+    struct StringMaker<std::byte> {
+        static std::string convert(std::byte value);
+    };
+#endif // defined(CATCH_CONFIG_CPP17_BYTE)
+    template<>
+    struct StringMaker<int> {
+        static std::string convert(int value);
+    };
+    template<>
+    struct StringMaker<long> {
+        static std::string convert(long value);
+    };
+    template<>
+    struct StringMaker<long long> {
+        static std::string convert(long long value);
+    };
+    template<>
+    struct StringMaker<unsigned int> {
+        static std::string convert(unsigned int value);
+    };
+    template<>
+    struct StringMaker<unsigned long> {
+        static std::string convert(unsigned long value);
+    };
+    template<>
+    struct StringMaker<unsigned long long> {
+        static std::string convert(unsigned long long value);
+    };
+
+    template<>
+    struct StringMaker<bool> {
+        static std::string convert(bool b);
+    };
+
+    template<>
+    struct StringMaker<char> {
+        static std::string convert(char c);
+    };
+    template<>
+    struct StringMaker<signed char> {
+        static std::string convert(signed char c);
+    };
+    template<>
+    struct StringMaker<unsigned char> {
+        static std::string convert(unsigned char c);
+    };
+
+    template<>
+    struct StringMaker<std::nullptr_t> {
+        static std::string convert(std::nullptr_t);
+    };
+
+    template<>
+    struct StringMaker<float> {
+        static std::string convert(float value);
+        static int precision;
+    };
+
+    template<>
+    struct StringMaker<double> {
+        static std::string convert(double value);
+        static int precision;
+    };
+
+    template <typename T>
+    struct StringMaker<T*> {
+        template <typename U>
+        static std::string convert(U* p) {
+            if (p) {
+                return ::Catch::Detail::rawMemoryToString(p);
+            } else {
+                return "nullptr";
+            }
+        }
+    };
+
+    template <typename R, typename C>
+    struct StringMaker<R C::*> {
+        static std::string convert(R C::* p) {
+            if (p) {
+                return ::Catch::Detail::rawMemoryToString(p);
+            } else {
+                return "nullptr";
+            }
+        }
+    };
+
+#if defined(_MANAGED)
+    template <typename T>
+    struct StringMaker<T^> {
+        static std::string convert( T^ ref ) {
+            return ::Catch::Detail::clrReferenceToString(ref);
+        }
+    };
+#endif
+
+    namespace Detail {
+        template<typename InputIterator, typename Sentinel = InputIterator>
+        std::string rangeToString(InputIterator first, Sentinel last) {
+            ReusableStringStream rss;
+            rss << "{ ";
+            if (first != last) {
+                rss << ::Catch::Detail::stringify(*first);
+                for (++first; first != last; ++first)
+                    rss << ", " << ::Catch::Detail::stringify(*first);
+            }
+            rss << " }";
+            return rss.str();
+        }
+    }
+
+#ifdef __OBJC__
+    template<>
+    struct StringMaker<NSString*> {
+        static std::string convert(NSString * nsstring) {
+            if (!nsstring)
+                return "nil";
+            return std::string("@") + [nsstring UTF8String];
+        }
+    };
+    template<>
+    struct StringMaker<NSObject*> {
+        static std::string convert(NSObject* nsObject) {
+            return ::Catch::Detail::stringify([nsObject description]);
+        }
+
+    };
+    namespace Detail {
+        inline std::string stringify( NSString* nsstring ) {
+            return StringMaker<NSString*>::convert( nsstring );
+        }
+
+    } // namespace Detail
+#endif // __OBJC__
+
+} // namespace Catch
+
+//////////////////////////////////////////////////////
+// Separate std-lib types stringification, so it can be selectively enabled
+// This means that we do not bring in
+
+#if defined(CATCH_CONFIG_ENABLE_ALL_STRINGMAKERS)
+#  define CATCH_CONFIG_ENABLE_PAIR_STRINGMAKER
+#  define CATCH_CONFIG_ENABLE_TUPLE_STRINGMAKER
+#  define CATCH_CONFIG_ENABLE_VARIANT_STRINGMAKER
+#  define CATCH_CONFIG_ENABLE_CHRONO_STRINGMAKER
+#  define CATCH_CONFIG_ENABLE_OPTIONAL_STRINGMAKER
+#endif
+
+// Separate std::pair specialization
+#if defined(CATCH_CONFIG_ENABLE_PAIR_STRINGMAKER)
+#include <utility>
+namespace Catch {
+    template<typename T1, typename T2>
+    struct StringMaker<std::pair<T1, T2> > {
+        static std::string convert(const std::pair<T1, T2>& pair) {
+            ReusableStringStream rss;
+            rss << "{ "
+                << ::Catch::Detail::stringify(pair.first)
+                << ", "
+                << ::Catch::Detail::stringify(pair.second)
+                << " }";
+            return rss.str();
+        }
+    };
+}
+#endif // CATCH_CONFIG_ENABLE_PAIR_STRINGMAKER
+
+#if defined(CATCH_CONFIG_ENABLE_OPTIONAL_STRINGMAKER) && defined(CATCH_CONFIG_CPP17_OPTIONAL)
+#include <optional>
+namespace Catch {
+    template<typename T>
+    struct StringMaker<std::optional<T> > {
+        static std::string convert(const std::optional<T>& optional) {
+            ReusableStringStream rss;
+            if (optional.has_value()) {
+                rss << ::Catch::Detail::stringify(*optional);
+            } else {
+                rss << "{ }";
+            }
+            return rss.str();
+        }
+    };
+}
+#endif // CATCH_CONFIG_ENABLE_OPTIONAL_STRINGMAKER
+
+// Separate std::tuple specialization
+#if defined(CATCH_CONFIG_ENABLE_TUPLE_STRINGMAKER)
+#include <tuple>
+namespace Catch {
+    namespace Detail {
+        template<
+            typename Tuple,
+            std::size_t N = 0,
+            bool = (N < std::tuple_size<Tuple>::value)
+            >
+            struct TupleElementPrinter {
+            static void print(const Tuple& tuple, std::ostream& os) {
+                os << (N ? ", " : " ")
+                    << ::Catch::Detail::stringify(std::get<N>(tuple));
+                TupleElementPrinter<Tuple, N + 1>::print(tuple, os);
+            }
+        };
+
+        template<
+            typename Tuple,
+            std::size_t N
+        >
+            struct TupleElementPrinter<Tuple, N, false> {
+            static void print(const Tuple&, std::ostream&) {}
+        };
+
+    }
+
+    template<typename ...Types>
+    struct StringMaker<std::tuple<Types...>> {
+        static std::string convert(const std::tuple<Types...>& tuple) {
+            ReusableStringStream rss;
+            rss << '{';
+            Detail::TupleElementPrinter<std::tuple<Types...>>::print(tuple, rss.get());
+            rss << " }";
+            return rss.str();
+        }
+    };
+}
+#endif // CATCH_CONFIG_ENABLE_TUPLE_STRINGMAKER
+
+#if defined(CATCH_CONFIG_ENABLE_VARIANT_STRINGMAKER) && defined(CATCH_CONFIG_CPP17_VARIANT)
+#include <variant>
+namespace Catch {
+    template<>
+    struct StringMaker<std::monostate> {
+        static std::string convert(const std::monostate&) {
+            return "{ }";
+        }
+    };
+
+    template<typename... Elements>
+    struct StringMaker<std::variant<Elements...>> {
+        static std::string convert(const std::variant<Elements...>& variant) {
+            if (variant.valueless_by_exception()) {
+                return "{valueless variant}";
+            } else {
+                return std::visit(
+                    [](const auto& value) {
+                        return ::Catch::Detail::stringify(value);
+                    },
+                    variant
+                );
+            }
+        }
+    };
+}
+#endif // CATCH_CONFIG_ENABLE_VARIANT_STRINGMAKER
+
+namespace Catch {
+    // Import begin/ end from std here
+    using std::begin;
+    using std::end;
+
+    namespace detail {
+        template <typename...>
+        struct void_type {
+            using type = void;
+        };
+
+        template <typename T, typename = void>
+        struct is_range_impl : std::false_type {
+        };
+
+        template <typename T>
+        struct is_range_impl<T, typename void_type<decltype(begin(std::declval<T>()))>::type> : std::true_type {
+        };
+    } // namespace detail
+
+    template <typename T>
+    struct is_range : detail::is_range_impl<T> {
+    };
+
+#if defined(_MANAGED) // Managed types are never ranges
+    template <typename T>
+    struct is_range<T^> {
+        static const bool value = false;
+    };
+#endif
+
+    template<typename Range>
+    std::string rangeToString( Range const& range ) {
+        return ::Catch::Detail::rangeToString( begin( range ), end( range ) );
+    }
+
+    // Handle vector<bool> specially
+    template<typename Allocator>
+    std::string rangeToString( std::vector<bool, Allocator> const& v ) {
+        ReusableStringStream rss;
+        rss << "{ ";
+        bool first = true;
+        for( bool b : v ) {
+            if( first )
+                first = false;
+            else
+                rss << ", ";
+            rss << ::Catch::Detail::stringify( b );
+        }
+        rss << " }";
+        return rss.str();
+    }
+
+    template<typename R>
+    struct StringMaker<R, typename std::enable_if<is_range<R>::value && !::Catch::Detail::IsStreamInsertable<R>::value>::type> {
+        static std::string convert( R const& range ) {
+            return rangeToString( range );
+        }
+    };
+
+    template <typename T, int SZ>
+    struct StringMaker<T[SZ]> {
+        static std::string convert(T const(&arr)[SZ]) {
+            return rangeToString(arr);
+        }
+    };
+
+} // namespace Catch
+
+// Separate std::chrono::duration specialization
+#if defined(CATCH_CONFIG_ENABLE_CHRONO_STRINGMAKER)
+#include <ctime>
+#include <ratio>
+#include <chrono>
+
+namespace Catch {
+
+template <class Ratio>
+struct ratio_string {
+    static std::string symbol();
+};
+
+template <class Ratio>
+std::string ratio_string<Ratio>::symbol() {
+    Catch::ReusableStringStream rss;
+    rss << '[' << Ratio::num << '/'
+        << Ratio::den << ']';
+    return rss.str();
+}
+template <>
+struct ratio_string<std::atto> {
+    static std::string symbol();
+};
+template <>
+struct ratio_string<std::femto> {
+    static std::string symbol();
+};
+template <>
+struct ratio_string<std::pico> {
+    static std::string symbol();
+};
+template <>
+struct ratio_string<std::nano> {
+    static std::string symbol();
+};
+template <>
+struct ratio_string<std::micro> {
+    static std::string symbol();
+};
+template <>
+struct ratio_string<std::milli> {
+    static std::string symbol();
+};
+
+    ////////////
+    // std::chrono::duration specializations
+    template<typename Value, typename Ratio>
+    struct StringMaker<std::chrono::duration<Value, Ratio>> {
+        static std::string convert(std::chrono::duration<Value, Ratio> const& duration) {
+            ReusableStringStream rss;
+            rss << duration.count() << ' ' << ratio_string<Ratio>::symbol() << 's';
+            return rss.str();
+        }
+    };
+    template<typename Value>
+    struct StringMaker<std::chrono::duration<Value, std::ratio<1>>> {
+        static std::string convert(std::chrono::duration<Value, std::ratio<1>> const& duration) {
+            ReusableStringStream rss;
+            rss << duration.count() << " s";
+            return rss.str();
+        }
+    };
+    template<typename Value>
+    struct StringMaker<std::chrono::duration<Value, std::ratio<60>>> {
+        static std::string convert(std::chrono::duration<Value, std::ratio<60>> const& duration) {
+            ReusableStringStream rss;
+            rss << duration.count() << " m";
+            return rss.str();
+        }
+    };
+    template<typename Value>
+    struct StringMaker<std::chrono::duration<Value, std::ratio<3600>>> {
+        static std::string convert(std::chrono::duration<Value, std::ratio<3600>> const& duration) {
+            ReusableStringStream rss;
+            rss << duration.count() << " h";
+            return rss.str();
+        }
+    };
+
+    ////////////
+    // std::chrono::time_point specialization
+    // Generic time_point cannot be specialized, only std::chrono::time_point<system_clock>
+    template<typename Clock, typename Duration>
+    struct StringMaker<std::chrono::time_point<Clock, Duration>> {
+        static std::string convert(std::chrono::time_point<Clock, Duration> const& time_point) {
+            return ::Catch::Detail::stringify(time_point.time_since_epoch()) + " since epoch";
+        }
+    };
+    // std::chrono::time_point<system_clock> specialization
+    template<typename Duration>
+    struct StringMaker<std::chrono::time_point<std::chrono::system_clock, Duration>> {
+        static std::string convert(std::chrono::time_point<std::chrono::system_clock, Duration> const& time_point) {
+            auto converted = std::chrono::system_clock::to_time_t(time_point);
+
+#ifdef _MSC_VER
+            std::tm timeInfo = {};
+            gmtime_s(&timeInfo, &converted);
+#else
+            std::tm* timeInfo = std::gmtime(&converted);
+#endif
+
+            auto const timeStampSize = sizeof("2017-01-16T17:06:45Z");
+            char timeStamp[timeStampSize];
+            const char * const fmt = "%Y-%m-%dT%H:%M:%SZ";
+
+#ifdef _MSC_VER
+            std::strftime(timeStamp, timeStampSize, fmt, &timeInfo);
+#else
+            std::strftime(timeStamp, timeStampSize, fmt, timeInfo);
+#endif
+            return std::string(timeStamp);
+        }
+    };
+}
+#endif // CATCH_CONFIG_ENABLE_CHRONO_STRINGMAKER
+
+#define INTERNAL_CATCH_REGISTER_ENUM( enumName, ... ) \
+namespace Catch { \
+    template<> struct StringMaker<enumName> { \
+        static std::string convert( enumName value ) { \
+            static const auto& enumInfo = ::Catch::getMutableRegistryHub().getMutableEnumValuesRegistry().registerEnum( #enumName, #__VA_ARGS__, { __VA_ARGS__ } ); \
+            return static_cast<std::string>(enumInfo.lookup( static_cast<int>( value ) )); \
+        } \
+    }; \
+}
+
+#define CATCH_REGISTER_ENUM( enumName, ... ) INTERNAL_CATCH_REGISTER_ENUM( enumName, __VA_ARGS__ )
+
+#ifdef _MSC_VER
+#pragma warning(pop)
+#endif
+
+// end catch_tostring.h
+#include <iosfwd>
+
+#ifdef _MSC_VER
+#pragma warning(push)
+#pragma warning(disable:4389) // '==' : signed/unsigned mismatch
+#pragma warning(disable:4018) // more "signed/unsigned mismatch"
+#pragma warning(disable:4312) // Converting int to T* using reinterpret_cast (issue on x64 platform)
+#pragma warning(disable:4180) // qualifier applied to function type has no meaning
+#pragma warning(disable:4800) // Forcing result to true or false
+#endif
+
+namespace Catch {
+
+    struct ITransientExpression {
+        auto isBinaryExpression() const -> bool { return m_isBinaryExpression; }
+        auto getResult() const -> bool { return m_result; }
+        virtual void streamReconstructedExpression( std::ostream &os ) const = 0;
+
+        ITransientExpression( bool isBinaryExpression, bool result )
+        :   m_isBinaryExpression( isBinaryExpression ),
+            m_result( result )
+        {}
+
+        // We don't actually need a virtual destructor, but many static analysers
+        // complain if it's not here :-(
+        virtual ~ITransientExpression();
+
+        bool m_isBinaryExpression;
+        bool m_result;
+
+    };
+
+    void formatReconstructedExpression( std::ostream &os, std::string const& lhs, StringRef op, std::string const& rhs );
+
+    template<typename LhsT, typename RhsT>
+    class BinaryExpr  : public ITransientExpression {
+        LhsT m_lhs;
+        StringRef m_op;
+        RhsT m_rhs;
+
+        void streamReconstructedExpression( std::ostream &os ) const override {
+            formatReconstructedExpression
+                    ( os, Catch::Detail::stringify( m_lhs ), m_op, Catch::Detail::stringify( m_rhs ) );
+        }
+
+    public:
+        BinaryExpr( bool comparisonResult, LhsT lhs, StringRef op, RhsT rhs )
+        :   ITransientExpression{ true, comparisonResult },
+            m_lhs( lhs ),
+            m_op( op ),
+            m_rhs( rhs )
+        {}
+
+        template<typename T>
+        auto operator && ( T ) const -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<T>::value,
+            "chained comparisons are not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+
+        template<typename T>
+        auto operator || ( T ) const -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<T>::value,
+            "chained comparisons are not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+
+        template<typename T>
+        auto operator == ( T ) const -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<T>::value,
+            "chained comparisons are not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+
+        template<typename T>
+        auto operator != ( T ) const -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<T>::value,
+            "chained comparisons are not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+
+        template<typename T>
+        auto operator > ( T ) const -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<T>::value,
+            "chained comparisons are not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+
+        template<typename T>
+        auto operator < ( T ) const -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<T>::value,
+            "chained comparisons are not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+
+        template<typename T>
+        auto operator >= ( T ) const -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<T>::value,
+            "chained comparisons are not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+
+        template<typename T>
+        auto operator <= ( T ) const -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<T>::value,
+            "chained comparisons are not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+    };
+
+    template<typename LhsT>
+    class UnaryExpr : public ITransientExpression {
+        LhsT m_lhs;
+
+        void streamReconstructedExpression( std::ostream &os ) const override {
+            os << Catch::Detail::stringify( m_lhs );
+        }
+
+    public:
+        explicit UnaryExpr( LhsT lhs )
+        :   ITransientExpression{ false, static_cast<bool>(lhs) },
+            m_lhs( lhs )
+        {}
+    };
+
+    // Specialised comparison functions to handle equality comparisons between ints and pointers (NULL deduces as an int)
+    template<typename LhsT, typename RhsT>
+    auto compareEqual( LhsT const& lhs, RhsT const& rhs ) -> bool { return static_cast<bool>(lhs == rhs); }
+    template<typename T>
+    auto compareEqual( T* const& lhs, int rhs ) -> bool { return lhs == reinterpret_cast<void const*>( rhs ); }
+    template<typename T>
+    auto compareEqual( T* const& lhs, long rhs ) -> bool { return lhs == reinterpret_cast<void const*>( rhs ); }
+    template<typename T>
+    auto compareEqual( int lhs, T* const& rhs ) -> bool { return reinterpret_cast<void const*>( lhs ) == rhs; }
+    template<typename T>
+    auto compareEqual( long lhs, T* const& rhs ) -> bool { return reinterpret_cast<void const*>( lhs ) == rhs; }
+
+    template<typename LhsT, typename RhsT>
+    auto compareNotEqual( LhsT const& lhs, RhsT&& rhs ) -> bool { return static_cast<bool>(lhs != rhs); }
+    template<typename T>
+    auto compareNotEqual( T* const& lhs, int rhs ) -> bool { return lhs != reinterpret_cast<void const*>( rhs ); }
+    template<typename T>
+    auto compareNotEqual( T* const& lhs, long rhs ) -> bool { return lhs != reinterpret_cast<void const*>( rhs ); }
+    template<typename T>
+    auto compareNotEqual( int lhs, T* const& rhs ) -> bool { return reinterpret_cast<void const*>( lhs ) != rhs; }
+    template<typename T>
+    auto compareNotEqual( long lhs, T* const& rhs ) -> bool { return reinterpret_cast<void const*>( lhs ) != rhs; }
+
+    template<typename LhsT>
+    class ExprLhs {
+        LhsT m_lhs;
+    public:
+        explicit ExprLhs( LhsT lhs ) : m_lhs( lhs ) {}
+
+        template<typename RhsT>
+        auto operator == ( RhsT const& rhs ) -> BinaryExpr<LhsT, RhsT const&> const {
+            return { compareEqual( m_lhs, rhs ), m_lhs, "==", rhs };
+        }
+        auto operator == ( bool rhs ) -> BinaryExpr<LhsT, bool> const {
+            return { m_lhs == rhs, m_lhs, "==", rhs };
+        }
+
+        template<typename RhsT>
+        auto operator != ( RhsT const& rhs ) -> BinaryExpr<LhsT, RhsT const&> const {
+            return { compareNotEqual( m_lhs, rhs ), m_lhs, "!=", rhs };
+        }
+        auto operator != ( bool rhs ) -> BinaryExpr<LhsT, bool> const {
+            return { m_lhs != rhs, m_lhs, "!=", rhs };
+        }
+
+        template<typename RhsT>
+        auto operator > ( RhsT const& rhs ) -> BinaryExpr<LhsT, RhsT const&> const {
+            return { static_cast<bool>(m_lhs > rhs), m_lhs, ">", rhs };
+        }
+        template<typename RhsT>
+        auto operator < ( RhsT const& rhs ) -> BinaryExpr<LhsT, RhsT const&> const {
+            return { static_cast<bool>(m_lhs < rhs), m_lhs, "<", rhs };
+        }
+        template<typename RhsT>
+        auto operator >= ( RhsT const& rhs ) -> BinaryExpr<LhsT, RhsT const&> const {
+            return { static_cast<bool>(m_lhs >= rhs), m_lhs, ">=", rhs };
+        }
+        template<typename RhsT>
+        auto operator <= ( RhsT const& rhs ) -> BinaryExpr<LhsT, RhsT const&> const {
+            return { static_cast<bool>(m_lhs <= rhs), m_lhs, "<=", rhs };
+        }
+        template <typename RhsT>
+        auto operator | (RhsT const& rhs) -> BinaryExpr<LhsT, RhsT const&> const {
+            return { static_cast<bool>(m_lhs | rhs), m_lhs, "|", rhs };
+        }
+        template <typename RhsT>
+        auto operator & (RhsT const& rhs) -> BinaryExpr<LhsT, RhsT const&> const {
+            return { static_cast<bool>(m_lhs & rhs), m_lhs, "&", rhs };
+        }
+        template <typename RhsT>
+        auto operator ^ (RhsT const& rhs) -> BinaryExpr<LhsT, RhsT const&> const {
+            return { static_cast<bool>(m_lhs ^ rhs), m_lhs, "^", rhs };
+        }
+
+        template<typename RhsT>
+        auto operator && ( RhsT const& ) -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<RhsT>::value,
+            "operator&& is not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+
+        template<typename RhsT>
+        auto operator || ( RhsT const& ) -> BinaryExpr<LhsT, RhsT const&> const {
+            static_assert(always_false<RhsT>::value,
+            "operator|| is not supported inside assertions, "
+            "wrap the expression inside parentheses, or decompose it");
+        }
+
+        auto makeUnaryExpr() const -> UnaryExpr<LhsT> {
+            return UnaryExpr<LhsT>{ m_lhs };
+        }
+    };
+
+    void handleExpression( ITransientExpression const& expr );
+
+    template<typename T>
+    void handleExpression( ExprLhs<T> const& expr ) {
+        handleExpression( expr.makeUnaryExpr() );
+    }
+
+    struct Decomposer {
+        template<typename T>
+        auto operator <= ( T const& lhs ) -> ExprLhs<T const&> {
+            return ExprLhs<T const&>{ lhs };
+        }
+
+        auto operator <=( bool value ) -> ExprLhs<bool> {
+            return ExprLhs<bool>{ value };
+        }
+    };
+
+} // end namespace Catch
+
+#ifdef _MSC_VER
+#pragma warning(pop)
+#endif
+
+// end catch_decomposer.h
+// start catch_interfaces_capture.h
+
+#include <string>
+#include <chrono>
+
+namespace Catch {
+
+    class AssertionResult;
+    struct AssertionInfo;
+    struct SectionInfo;
+    struct SectionEndInfo;
+    struct MessageInfo;
+    struct MessageBuilder;
+    struct Counts;
+    struct AssertionReaction;
+    struct SourceLineInfo;
+
+    struct ITransientExpression;
+    struct IGeneratorTracker;
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+    struct BenchmarkInfo;
+    template <typename Duration = std::chrono::duration<double, std::nano>>
+    struct BenchmarkStats;
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+    struct IResultCapture {
+
+        virtual ~IResultCapture();
+
+        virtual bool sectionStarted(    SectionInfo const& sectionInfo,
+                                        Counts& assertions ) = 0;
+        virtual void sectionEnded( SectionEndInfo const& endInfo ) = 0;
+        virtual void sectionEndedEarly( SectionEndInfo const& endInfo ) = 0;
+
+        virtual auto acquireGeneratorTracker( StringRef generatorName, SourceLineInfo const& lineInfo ) -> IGeneratorTracker& = 0;
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+        virtual void benchmarkPreparing( std::string const& name ) = 0;
+        virtual void benchmarkStarting( BenchmarkInfo const& info ) = 0;
+        virtual void benchmarkEnded( BenchmarkStats<> const& stats ) = 0;
+        virtual void benchmarkFailed( std::string const& error ) = 0;
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+        virtual void pushScopedMessage( MessageInfo const& message ) = 0;
+        virtual void popScopedMessage( MessageInfo const& message ) = 0;
+
+        virtual void emplaceUnscopedMessage( MessageBuilder const& builder ) = 0;
+
+        virtual void handleFatalErrorCondition( StringRef message ) = 0;
+
+        virtual void handleExpr
+                (   AssertionInfo const& info,
+                    ITransientExpression const& expr,
+                    AssertionReaction& reaction ) = 0;
+        virtual void handleMessage
+                (   AssertionInfo const& info,
+                    ResultWas::OfType resultType,
+                    StringRef const& message,
+                    AssertionReaction& reaction ) = 0;
+        virtual void handleUnexpectedExceptionNotThrown
+                (   AssertionInfo const& info,
+                    AssertionReaction& reaction ) = 0;
+        virtual void handleUnexpectedInflightException
+                (   AssertionInfo const& info,
+                    std::string const& message,
+                    AssertionReaction& reaction ) = 0;
+        virtual void handleIncomplete
+                (   AssertionInfo const& info ) = 0;
+        virtual void handleNonExpr
+                (   AssertionInfo const &info,
+                    ResultWas::OfType resultType,
+                    AssertionReaction &reaction ) = 0;
+
+        virtual bool lastAssertionPassed() = 0;
+        virtual void assertionPassed() = 0;
+
+        // Deprecated, do not use:
+        virtual std::string getCurrentTestName() const = 0;
+        virtual const AssertionResult* getLastResult() const = 0;
+        virtual void exceptionEarlyReported() = 0;
+    };
+
+    IResultCapture& getResultCapture();
+}
+
+// end catch_interfaces_capture.h
+namespace Catch {
+
+    struct TestFailureException{};
+    struct AssertionResultData;
+    struct IResultCapture;
+    class RunContext;
+
+    class LazyExpression {
+        friend class AssertionHandler;
+        friend struct AssertionStats;
+        friend class RunContext;
+
+        ITransientExpression const* m_transientExpression = nullptr;
+        bool m_isNegated;
+    public:
+        LazyExpression( bool isNegated );
+        LazyExpression( LazyExpression const& other );
+        LazyExpression& operator = ( LazyExpression const& ) = delete;
+
+        explicit operator bool() const;
+
+        friend auto operator << ( std::ostream& os, LazyExpression const& lazyExpr ) -> std::ostream&;
+    };
+
+    struct AssertionReaction {
+        bool shouldDebugBreak = false;
+        bool shouldThrow = false;
+    };
+
+    class AssertionHandler {
+        AssertionInfo m_assertionInfo;
+        AssertionReaction m_reaction;
+        bool m_completed = false;
+        IResultCapture& m_resultCapture;
+
+    public:
+        AssertionHandler
+            (   StringRef const& macroName,
+                SourceLineInfo const& lineInfo,
+                StringRef capturedExpression,
+                ResultDisposition::Flags resultDisposition );
+        ~AssertionHandler() {
+            if ( !m_completed ) {
+                m_resultCapture.handleIncomplete( m_assertionInfo );
+            }
+        }
+
+        template<typename T>
+        void handleExpr( ExprLhs<T> const& expr ) {
+            handleExpr( expr.makeUnaryExpr() );
+        }
+        void handleExpr( ITransientExpression const& expr );
+
+        void handleMessage(ResultWas::OfType resultType, StringRef const& message);
+
+        void handleExceptionThrownAsExpected();
+        void handleUnexpectedExceptionNotThrown();
+        void handleExceptionNotThrownAsExpected();
+        void handleThrowingCallSkipped();
+        void handleUnexpectedInflightException();
+
+        void complete();
+        void setCompleted();
+
+        // query
+        auto allowThrows() const -> bool;
+    };
+
+    void handleExceptionMatchExpr( AssertionHandler& handler, std::string const& str, StringRef const& matcherString );
+
+} // namespace Catch
+
+// end catch_assertionhandler.h
+// start catch_message.h
+
+#include <string>
+#include <vector>
+
+namespace Catch {
+
+    struct MessageInfo {
+        MessageInfo(    StringRef const& _macroName,
+                        SourceLineInfo const& _lineInfo,
+                        ResultWas::OfType _type );
+
+        StringRef macroName;
+        std::string message;
+        SourceLineInfo lineInfo;
+        ResultWas::OfType type;
+        unsigned int sequence;
+
+        bool operator == ( MessageInfo const& other ) const;
+        bool operator < ( MessageInfo const& other ) const;
+    private:
+        static unsigned int globalCount;
+    };
+
+    struct MessageStream {
+
+        template<typename T>
+        MessageStream& operator << ( T const& value ) {
+            m_stream << value;
+            return *this;
+        }
+
+        ReusableStringStream m_stream;
+    };
+
+    struct MessageBuilder : MessageStream {
+        MessageBuilder( StringRef const& macroName,
+                        SourceLineInfo const& lineInfo,
+                        ResultWas::OfType type );
+
+        template<typename T>
+        MessageBuilder& operator << ( T const& value ) {
+            m_stream << value;
+            return *this;
+        }
+
+        MessageInfo m_info;
+    };
+
+    class ScopedMessage {
+    public:
+        explicit ScopedMessage( MessageBuilder const& builder );
+        ScopedMessage( ScopedMessage& duplicate ) = delete;
+        ScopedMessage( ScopedMessage&& old );
+        ~ScopedMessage();
+
+        MessageInfo m_info;
+        bool m_moved;
+    };
+
+    class Capturer {
+        std::vector<MessageInfo> m_messages;
+        IResultCapture& m_resultCapture = getResultCapture();
+        size_t m_captured = 0;
+    public:
+        Capturer( StringRef macroName, SourceLineInfo const& lineInfo, ResultWas::OfType resultType, StringRef names );
+        ~Capturer();
+
+        void captureValue( size_t index, std::string const& value );
+
+        template<typename T>
+        void captureValues( size_t index, T const& value ) {
+            captureValue( index, Catch::Detail::stringify( value ) );
+        }
+
+        template<typename T, typename... Ts>
+        void captureValues( size_t index, T const& value, Ts const&... values ) {
+            captureValue( index, Catch::Detail::stringify(value) );
+            captureValues( index+1, values... );
+        }
+    };
+
+} // end namespace Catch
+
+// end catch_message.h
+#if !defined(CATCH_CONFIG_DISABLE)
+
+#if !defined(CATCH_CONFIG_DISABLE_STRINGIFICATION)
+  #define CATCH_INTERNAL_STRINGIFY(...) #__VA_ARGS__
+#else
+  #define CATCH_INTERNAL_STRINGIFY(...) "Disabled by CATCH_CONFIG_DISABLE_STRINGIFICATION"
+#endif
+
+#if defined(CATCH_CONFIG_FAST_COMPILE) || defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+
+///////////////////////////////////////////////////////////////////////////////
+// Another way to speed-up compilation is to omit local try-catch for REQUIRE*
+// macros.
+#define INTERNAL_CATCH_TRY
+#define INTERNAL_CATCH_CATCH( capturer )
+
+#else // CATCH_CONFIG_FAST_COMPILE
+
+#define INTERNAL_CATCH_TRY try
+#define INTERNAL_CATCH_CATCH( handler ) catch(...) { handler.handleUnexpectedInflightException(); }
+
+#endif
+
+#define INTERNAL_CATCH_REACT( handler ) handler.complete();
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_TEST( macroName, resultDisposition, ... ) \
+    do { \
+        CATCH_INTERNAL_IGNORE_BUT_WARN(__VA_ARGS__); \
+        Catch::AssertionHandler catchAssertionHandler( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__), resultDisposition ); \
+        INTERNAL_CATCH_TRY { \
+            CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+            CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS \
+            catchAssertionHandler.handleExpr( Catch::Decomposer() <= __VA_ARGS__ ); \
+            CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION \
+        } INTERNAL_CATCH_CATCH( catchAssertionHandler ) \
+        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
+    } while( (void)0, (false) && static_cast<bool>( !!(__VA_ARGS__) ) )
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_IF( macroName, resultDisposition, ... ) \
+    INTERNAL_CATCH_TEST( macroName, resultDisposition, __VA_ARGS__ ); \
+    if( Catch::getResultCapture().lastAssertionPassed() )
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_ELSE( macroName, resultDisposition, ... ) \
+    INTERNAL_CATCH_TEST( macroName, resultDisposition, __VA_ARGS__ ); \
+    if( !Catch::getResultCapture().lastAssertionPassed() )
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_NO_THROW( macroName, resultDisposition, ... ) \
+    do { \
+        Catch::AssertionHandler catchAssertionHandler( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__), resultDisposition ); \
+        try { \
+            static_cast<void>(__VA_ARGS__); \
+            catchAssertionHandler.handleExceptionNotThrownAsExpected(); \
+        } \
+        catch( ... ) { \
+            catchAssertionHandler.handleUnexpectedInflightException(); \
+        } \
+        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
+    } while( false )
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_THROWS( macroName, resultDisposition, ... ) \
+    do { \
+        Catch::AssertionHandler catchAssertionHandler( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__), resultDisposition); \
+        if( catchAssertionHandler.allowThrows() ) \
+            try { \
+                static_cast<void>(__VA_ARGS__); \
+                catchAssertionHandler.handleUnexpectedExceptionNotThrown(); \
+            } \
+            catch( ... ) { \
+                catchAssertionHandler.handleExceptionThrownAsExpected(); \
+            } \
+        else \
+            catchAssertionHandler.handleThrowingCallSkipped(); \
+        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
+    } while( false )
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_THROWS_AS( macroName, exceptionType, resultDisposition, expr ) \
+    do { \
+        Catch::AssertionHandler catchAssertionHandler( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(expr) ", " CATCH_INTERNAL_STRINGIFY(exceptionType), resultDisposition ); \
+        if( catchAssertionHandler.allowThrows() ) \
+            try { \
+                static_cast<void>(expr); \
+                catchAssertionHandler.handleUnexpectedExceptionNotThrown(); \
+            } \
+            catch( exceptionType const& ) { \
+                catchAssertionHandler.handleExceptionThrownAsExpected(); \
+            } \
+            catch( ... ) { \
+                catchAssertionHandler.handleUnexpectedInflightException(); \
+            } \
+        else \
+            catchAssertionHandler.handleThrowingCallSkipped(); \
+        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
+    } while( false )
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_MSG( macroName, messageType, resultDisposition, ... ) \
+    do { \
+        Catch::AssertionHandler catchAssertionHandler( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, Catch::StringRef(), resultDisposition ); \
+        catchAssertionHandler.handleMessage( messageType, ( Catch::MessageStream() << __VA_ARGS__ + ::Catch::StreamEndStop() ).m_stream.str() ); \
+        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
+    } while( false )
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_CAPTURE( varName, macroName, ... ) \
+    auto varName = Catch::Capturer( macroName, CATCH_INTERNAL_LINEINFO, Catch::ResultWas::Info, #__VA_ARGS__ ); \
+    varName.captureValues( 0, __VA_ARGS__ )
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_INFO( macroName, log ) \
+    Catch::ScopedMessage INTERNAL_CATCH_UNIQUE_NAME( scopedMessage )( Catch::MessageBuilder( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, Catch::ResultWas::Info ) << log );
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_UNSCOPED_INFO( macroName, log ) \
+    Catch::getResultCapture().emplaceUnscopedMessage( Catch::MessageBuilder( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, Catch::ResultWas::Info ) << log )
+
+///////////////////////////////////////////////////////////////////////////////
+// Although this is matcher-based, it can be used with just a string
+#define INTERNAL_CATCH_THROWS_STR_MATCHES( macroName, resultDisposition, matcher, ... ) \
+    do { \
+        Catch::AssertionHandler catchAssertionHandler( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__) ", " CATCH_INTERNAL_STRINGIFY(matcher), resultDisposition ); \
+        if( catchAssertionHandler.allowThrows() ) \
+            try { \
+                static_cast<void>(__VA_ARGS__); \
+                catchAssertionHandler.handleUnexpectedExceptionNotThrown(); \
+            } \
+            catch( ... ) { \
+                Catch::handleExceptionMatchExpr( catchAssertionHandler, matcher, #matcher##_catch_sr ); \
+            } \
+        else \
+            catchAssertionHandler.handleThrowingCallSkipped(); \
+        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
+    } while( false )
+
+#endif // CATCH_CONFIG_DISABLE
+
+// end catch_capture.hpp
+// start catch_section.h
+
+// start catch_section_info.h
+
+// start catch_totals.h
+
+#include <cstddef>
+
+namespace Catch {
+
+    struct Counts {
+        Counts operator - ( Counts const& other ) const;
+        Counts& operator += ( Counts const& other );
+
+        std::size_t total() const;
+        bool allPassed() const;
+        bool allOk() const;
+
+        std::size_t passed = 0;
+        std::size_t failed = 0;
+        std::size_t failedButOk = 0;
+    };
+
+    struct Totals {
+
+        Totals operator - ( Totals const& other ) const;
+        Totals& operator += ( Totals const& other );
+
+        Totals delta( Totals const& prevTotals ) const;
+
+        int error = 0;
+        Counts assertions;
+        Counts testCases;
+    };
+}
+
+// end catch_totals.h
+#include <string>
+
+namespace Catch {
+
+    struct SectionInfo {
+        SectionInfo
+            (   SourceLineInfo const& _lineInfo,
+                std::string const& _name );
+
+        // Deprecated
+        SectionInfo
+            (   SourceLineInfo const& _lineInfo,
+                std::string const& _name,
+                std::string const& ) : SectionInfo( _lineInfo, _name ) {}
+
+        std::string name;
+        std::string description; // !Deprecated: this will always be empty
+        SourceLineInfo lineInfo;
+    };
+
+    struct SectionEndInfo {
+        SectionInfo sectionInfo;
+        Counts prevAssertions;
+        double durationInSeconds;
+    };
+
+} // end namespace Catch
+
+// end catch_section_info.h
+// start catch_timer.h
+
+#include <cstdint>
+
+namespace Catch {
+
+    auto getCurrentNanosecondsSinceEpoch() -> uint64_t;
+    auto getEstimatedClockResolution() -> uint64_t;
+
+    class Timer {
+        uint64_t m_nanoseconds = 0;
+    public:
+        void start();
+        auto getElapsedNanoseconds() const -> uint64_t;
+        auto getElapsedMicroseconds() const -> uint64_t;
+        auto getElapsedMilliseconds() const -> unsigned int;
+        auto getElapsedSeconds() const -> double;
+    };
+
+} // namespace Catch
+
+// end catch_timer.h
+#include <string>
+
+namespace Catch {
+
+    class Section : NonCopyable {
+    public:
+        Section( SectionInfo const& info );
+        ~Section();
+
+        // This indicates whether the section should be executed or not
+        explicit operator bool() const;
+
+    private:
+        SectionInfo m_info;
+
+        std::string m_name;
+        Counts m_assertions;
+        bool m_sectionIncluded;
+        Timer m_timer;
+    };
+
+} // end namespace Catch
+
+#define INTERNAL_CATCH_SECTION( ... ) \
+    CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+    CATCH_INTERNAL_SUPPRESS_UNUSED_WARNINGS \
+    if( Catch::Section const& INTERNAL_CATCH_UNIQUE_NAME( catch_internal_Section ) = Catch::SectionInfo( CATCH_INTERNAL_LINEINFO, __VA_ARGS__ ) ) \
+    CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
+
+#define INTERNAL_CATCH_DYNAMIC_SECTION( ... ) \
+    CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+    CATCH_INTERNAL_SUPPRESS_UNUSED_WARNINGS \
+    if( Catch::Section const& INTERNAL_CATCH_UNIQUE_NAME( catch_internal_Section ) = Catch::SectionInfo( CATCH_INTERNAL_LINEINFO, (Catch::ReusableStringStream() << __VA_ARGS__).str() ) ) \
+    CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
+
+// end catch_section.h
+// start catch_interfaces_exception.h
+
+// start catch_interfaces_registry_hub.h
+
+#include <string>
+#include <memory>
+
+namespace Catch {
+
+    class TestCase;
+    struct ITestCaseRegistry;
+    struct IExceptionTranslatorRegistry;
+    struct IExceptionTranslator;
+    struct IReporterRegistry;
+    struct IReporterFactory;
+    struct ITagAliasRegistry;
+    struct IMutableEnumValuesRegistry;
+
+    class StartupExceptionRegistry;
+
+    using IReporterFactoryPtr = std::shared_ptr<IReporterFactory>;
+
+    struct IRegistryHub {
+        virtual ~IRegistryHub();
+
+        virtual IReporterRegistry const& getReporterRegistry() const = 0;
+        virtual ITestCaseRegistry const& getTestCaseRegistry() const = 0;
+        virtual ITagAliasRegistry const& getTagAliasRegistry() const = 0;
+        virtual IExceptionTranslatorRegistry const& getExceptionTranslatorRegistry() const = 0;
+
+        virtual StartupExceptionRegistry const& getStartupExceptionRegistry() const = 0;
+    };
+
+    struct IMutableRegistryHub {
+        virtual ~IMutableRegistryHub();
+        virtual void registerReporter( std::string const& name, IReporterFactoryPtr const& factory ) = 0;
+        virtual void registerListener( IReporterFactoryPtr const& factory ) = 0;
+        virtual void registerTest( TestCase const& testInfo ) = 0;
+        virtual void registerTranslator( const IExceptionTranslator* translator ) = 0;
+        virtual void registerTagAlias( std::string const& alias, std::string const& tag, SourceLineInfo const& lineInfo ) = 0;
+        virtual void registerStartupException() noexcept = 0;
+        virtual IMutableEnumValuesRegistry& getMutableEnumValuesRegistry() = 0;
+    };
+
+    IRegistryHub const& getRegistryHub();
+    IMutableRegistryHub& getMutableRegistryHub();
+    void cleanUp();
+    std::string translateActiveException();
+
+}
+
+// end catch_interfaces_registry_hub.h
+#if defined(CATCH_CONFIG_DISABLE)
+    #define INTERNAL_CATCH_TRANSLATE_EXCEPTION_NO_REG( translatorName, signature) \
+        static std::string translatorName( signature )
+#endif
+
+#include <exception>
+#include <string>
+#include <vector>
+
+namespace Catch {
+    using exceptionTranslateFunction = std::string(*)();
+
+    struct IExceptionTranslator;
+    using ExceptionTranslators = std::vector<std::unique_ptr<IExceptionTranslator const>>;
+
+    struct IExceptionTranslator {
+        virtual ~IExceptionTranslator();
+        virtual std::string translate( ExceptionTranslators::const_iterator it, ExceptionTranslators::const_iterator itEnd ) const = 0;
+    };
+
+    struct IExceptionTranslatorRegistry {
+        virtual ~IExceptionTranslatorRegistry();
+
+        virtual std::string translateActiveException() const = 0;
+    };
+
+    class ExceptionTranslatorRegistrar {
+        template<typename T>
+        class ExceptionTranslator : public IExceptionTranslator {
+        public:
+
+            ExceptionTranslator( std::string(*translateFunction)( T& ) )
+            : m_translateFunction( translateFunction )
+            {}
+
+            std::string translate( ExceptionTranslators::const_iterator it, ExceptionTranslators::const_iterator itEnd ) const override {
+#if defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+                return "";
+#else
+                try {
+                    if( it == itEnd )
+                        std::rethrow_exception(std::current_exception());
+                    else
+                        return (*it)->translate( it+1, itEnd );
+                }
+                catch( T& ex ) {
+                    return m_translateFunction( ex );
+                }
+#endif
+            }
+
+        protected:
+            std::string(*m_translateFunction)( T& );
+        };
+
+    public:
+        template<typename T>
+        ExceptionTranslatorRegistrar( std::string(*translateFunction)( T& ) ) {
+            getMutableRegistryHub().registerTranslator
+                ( new ExceptionTranslator<T>( translateFunction ) );
+        }
+    };
+}
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_TRANSLATE_EXCEPTION2( translatorName, signature ) \
+    static std::string translatorName( signature ); \
+    CATCH_INTERNAL_START_WARNINGS_SUPPRESSION \
+    CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
+    namespace{ Catch::ExceptionTranslatorRegistrar INTERNAL_CATCH_UNIQUE_NAME( catch_internal_ExceptionRegistrar )( &translatorName ); } \
+    CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION \
+    static std::string translatorName( signature )
+
+#define INTERNAL_CATCH_TRANSLATE_EXCEPTION( signature ) INTERNAL_CATCH_TRANSLATE_EXCEPTION2( INTERNAL_CATCH_UNIQUE_NAME( catch_internal_ExceptionTranslator ), signature )
+
+// end catch_interfaces_exception.h
+// start catch_approx.h
+
+#include <type_traits>
+
+namespace Catch {
+namespace Detail {
+
+    class Approx {
+    private:
+        bool equalityComparisonImpl(double other) const;
+        // Validates the new margin (margin >= 0)
+        // out-of-line to avoid including stdexcept in the header
+        void setMargin(double margin);
+        // Validates the new epsilon (0 < epsilon < 1)
+        // out-of-line to avoid including stdexcept in the header
+        void setEpsilon(double epsilon);
+
+    public:
+        explicit Approx ( double value );
+
+        static Approx custom();
+
+        Approx operator-() const;
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        Approx operator()( T const& value ) const {
+            Approx approx( static_cast<double>(value) );
+            approx.m_epsilon = m_epsilon;
+            approx.m_margin = m_margin;
+            approx.m_scale = m_scale;
+            return approx;
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        explicit Approx( T const& value ): Approx(static_cast<double>(value))
+        {}
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        friend bool operator == ( const T& lhs, Approx const& rhs ) {
+            auto lhs_v = static_cast<double>(lhs);
+            return rhs.equalityComparisonImpl(lhs_v);
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        friend bool operator == ( Approx const& lhs, const T& rhs ) {
+            return operator==( rhs, lhs );
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        friend bool operator != ( T const& lhs, Approx const& rhs ) {
+            return !operator==( lhs, rhs );
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        friend bool operator != ( Approx const& lhs, T const& rhs ) {
+            return !operator==( rhs, lhs );
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        friend bool operator <= ( T const& lhs, Approx const& rhs ) {
+            return static_cast<double>(lhs) < rhs.m_value || lhs == rhs;
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        friend bool operator <= ( Approx const& lhs, T const& rhs ) {
+            return lhs.m_value < static_cast<double>(rhs) || lhs == rhs;
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        friend bool operator >= ( T const& lhs, Approx const& rhs ) {
+            return static_cast<double>(lhs) > rhs.m_value || lhs == rhs;
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        friend bool operator >= ( Approx const& lhs, T const& rhs ) {
+            return lhs.m_value > static_cast<double>(rhs) || lhs == rhs;
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        Approx& epsilon( T const& newEpsilon ) {
+            double epsilonAsDouble = static_cast<double>(newEpsilon);
+            setEpsilon(epsilonAsDouble);
+            return *this;
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        Approx& margin( T const& newMargin ) {
+            double marginAsDouble = static_cast<double>(newMargin);
+            setMargin(marginAsDouble);
+            return *this;
+        }
+
+        template <typename T, typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+        Approx& scale( T const& newScale ) {
+            m_scale = static_cast<double>(newScale);
+            return *this;
+        }
+
+        std::string toString() const;
+
+    private:
+        double m_epsilon;
+        double m_margin;
+        double m_scale;
+        double m_value;
+    };
+} // end namespace Detail
+
+namespace literals {
+    Detail::Approx operator "" _a(long double val);
+    Detail::Approx operator "" _a(unsigned long long val);
+} // end namespace literals
+
+template<>
+struct StringMaker<Catch::Detail::Approx> {
+    static std::string convert(Catch::Detail::Approx const& value);
+};
+
+} // end namespace Catch
+
+// end catch_approx.h
+// start catch_string_manip.h
+
+#include <string>
+#include <iosfwd>
+#include <vector>
+
+namespace Catch {
+
+    bool startsWith( std::string const& s, std::string const& prefix );
+    bool startsWith( std::string const& s, char prefix );
+    bool endsWith( std::string const& s, std::string const& suffix );
+    bool endsWith( std::string const& s, char suffix );
+    bool contains( std::string const& s, std::string const& infix );
+    void toLowerInPlace( std::string& s );
+    std::string toLower( std::string const& s );
+    //! Returns a new string without whitespace at the start/end
+    std::string trim( std::string const& str );
+    //! Returns a substring of the original ref without whitespace. Beware lifetimes!
+    StringRef trim(StringRef ref);
+
+    // !!! Be aware, returns refs into original string - make sure original string outlives them
+    std::vector<StringRef> splitStringRef( StringRef str, char delimiter );
+    bool replaceInPlace( std::string& str, std::string const& replaceThis, std::string const& withThis );
+
+    struct pluralise {
+        pluralise( std::size_t count, std::string const& label );
+
+        friend std::ostream& operator << ( std::ostream& os, pluralise const& pluraliser );
+
+        std::size_t m_count;
+        std::string m_label;
+    };
+}
+
+// end catch_string_manip.h
+#ifndef CATCH_CONFIG_DISABLE_MATCHERS
+// start catch_capture_matchers.h
+
+// start catch_matchers.h
+
+#include <string>
+#include <vector>
+
+namespace Catch {
+namespace Matchers {
+    namespace Impl {
+
+        template<typename ArgT> struct MatchAllOf;
+        template<typename ArgT> struct MatchAnyOf;
+        template<typename ArgT> struct MatchNotOf;
+
+        class MatcherUntypedBase {
+        public:
+            MatcherUntypedBase() = default;
+            MatcherUntypedBase ( MatcherUntypedBase const& ) = default;
+            MatcherUntypedBase& operator = ( MatcherUntypedBase const& ) = delete;
+            std::string toString() const;
+
+        protected:
+            virtual ~MatcherUntypedBase();
+            virtual std::string describe() const = 0;
+            mutable std::string m_cachedToString;
+        };
+
+#ifdef __clang__
+#    pragma clang diagnostic push
+#    pragma clang diagnostic ignored "-Wnon-virtual-dtor"
+#endif
+
+        template<typename ObjectT>
+        struct MatcherMethod {
+            virtual bool match( ObjectT const& arg ) const = 0;
+        };
+
+#if defined(__OBJC__)
+        // Hack to fix Catch GH issue #1661. Could use id for generic Object support.
+        // use of const for Object pointers is very uncommon and under ARC it causes some kind of signature mismatch that breaks compilation
+        template<>
+        struct MatcherMethod<NSString*> {
+            virtual bool match( NSString* arg ) const = 0;
+        };
+#endif
+
+#ifdef __clang__
+#    pragma clang diagnostic pop
+#endif
+
+        template<typename T>
+        struct MatcherBase : MatcherUntypedBase, MatcherMethod<T> {
+
+            MatchAllOf<T> operator && ( MatcherBase const& other ) const;
+            MatchAnyOf<T> operator || ( MatcherBase const& other ) const;
+            MatchNotOf<T> operator ! () const;
+        };
+
+        template<typename ArgT>
+        struct MatchAllOf : MatcherBase<ArgT> {
+            bool match( ArgT const& arg ) const override {
+                for( auto matcher : m_matchers ) {
+                    if (!matcher->match(arg))
+                        return false;
+                }
+                return true;
+            }
+            std::string describe() const override {
+                std::string description;
+                description.reserve( 4 + m_matchers.size()*32 );
+                description += "( ";
+                bool first = true;
+                for( auto matcher : m_matchers ) {
+                    if( first )
+                        first = false;
+                    else
+                        description += " and ";
+                    description += matcher->toString();
+                }
+                description += " )";
+                return description;
+            }
+
+            MatchAllOf<ArgT> operator && ( MatcherBase<ArgT> const& other ) {
+                auto copy(*this);
+                copy.m_matchers.push_back( &other );
+                return copy;
+            }
+
+            std::vector<MatcherBase<ArgT> const*> m_matchers;
+        };
+        template<typename ArgT>
+        struct MatchAnyOf : MatcherBase<ArgT> {
+
+            bool match( ArgT const& arg ) const override {
+                for( auto matcher : m_matchers ) {
+                    if (matcher->match(arg))
+                        return true;
+                }
+                return false;
+            }
+            std::string describe() const override {
+                std::string description;
+                description.reserve( 4 + m_matchers.size()*32 );
+                description += "( ";
+                bool first = true;
+                for( auto matcher : m_matchers ) {
+                    if( first )
+                        first = false;
+                    else
+                        description += " or ";
+                    description += matcher->toString();
+                }
+                description += " )";
+                return description;
+            }
+
+            MatchAnyOf<ArgT> operator || ( MatcherBase<ArgT> const& other ) {
+                auto copy(*this);
+                copy.m_matchers.push_back( &other );
+                return copy;
+            }
+
+            std::vector<MatcherBase<ArgT> const*> m_matchers;
+        };
+
+        template<typename ArgT>
+        struct MatchNotOf : MatcherBase<ArgT> {
+
+            MatchNotOf( MatcherBase<ArgT> const& underlyingMatcher ) : m_underlyingMatcher( underlyingMatcher ) {}
+
+            bool match( ArgT const& arg ) const override {
+                return !m_underlyingMatcher.match( arg );
+            }
+
+            std::string describe() const override {
+                return "not " + m_underlyingMatcher.toString();
+            }
+            MatcherBase<ArgT> const& m_underlyingMatcher;
+        };
+
+        template<typename T>
+        MatchAllOf<T> MatcherBase<T>::operator && ( MatcherBase const& other ) const {
+            return MatchAllOf<T>() && *this && other;
+        }
+        template<typename T>
+        MatchAnyOf<T> MatcherBase<T>::operator || ( MatcherBase const& other ) const {
+            return MatchAnyOf<T>() || *this || other;
+        }
+        template<typename T>
+        MatchNotOf<T> MatcherBase<T>::operator ! () const {
+            return MatchNotOf<T>( *this );
+        }
+
+    } // namespace Impl
+
+} // namespace Matchers
+
+using namespace Matchers;
+using Matchers::Impl::MatcherBase;
+
+} // namespace Catch
+
+// end catch_matchers.h
+// start catch_matchers_exception.hpp
+
+namespace Catch {
+namespace Matchers {
+namespace Exception {
+
+class ExceptionMessageMatcher : public MatcherBase<std::exception> {
+    std::string m_message;
+public:
+
+    ExceptionMessageMatcher(std::string const& message):
+        m_message(message)
+    {}
+
+    bool match(std::exception const& ex) const override;
+
+    std::string describe() const override;
+};
+
+} // namespace Exception
+
+Exception::ExceptionMessageMatcher Message(std::string const& message);
+
+} // namespace Matchers
+} // namespace Catch
+
+// end catch_matchers_exception.hpp
+// start catch_matchers_floating.h
+
+namespace Catch {
+namespace Matchers {
+
+    namespace Floating {
+
+        enum class FloatingPointKind : uint8_t;
+
+        struct WithinAbsMatcher : MatcherBase<double> {
+            WithinAbsMatcher(double target, double margin);
+            bool match(double const& matchee) const override;
+            std::string describe() const override;
+        private:
+            double m_target;
+            double m_margin;
+        };
+
+        struct WithinUlpsMatcher : MatcherBase<double> {
+            WithinUlpsMatcher(double target, uint64_t ulps, FloatingPointKind baseType);
+            bool match(double const& matchee) const override;
+            std::string describe() const override;
+        private:
+            double m_target;
+            uint64_t m_ulps;
+            FloatingPointKind m_type;
+        };
+
+        // Given IEEE-754 format for floats and doubles, we can assume
+        // that float -> double promotion is lossless. Given this, we can
+        // assume that if we do the standard relative comparison of
+        // |lhs - rhs| <= epsilon * max(fabs(lhs), fabs(rhs)), then we get
+        // the same result if we do this for floats, as if we do this for
+        // doubles that were promoted from floats.
+        struct WithinRelMatcher : MatcherBase<double> {
+            WithinRelMatcher(double target, double epsilon);
+            bool match(double const& matchee) const override;
+            std::string describe() const override;
+        private:
+            double m_target;
+            double m_epsilon;
+        };
+
+    } // namespace Floating
+
+    // The following functions create the actual matcher objects.
+    // This allows the types to be inferred
+    Floating::WithinUlpsMatcher WithinULP(double target, uint64_t maxUlpDiff);
+    Floating::WithinUlpsMatcher WithinULP(float target, uint64_t maxUlpDiff);
+    Floating::WithinAbsMatcher WithinAbs(double target, double margin);
+    Floating::WithinRelMatcher WithinRel(double target, double eps);
+    // defaults epsilon to 100*numeric_limits<double>::epsilon()
+    Floating::WithinRelMatcher WithinRel(double target);
+    Floating::WithinRelMatcher WithinRel(float target, float eps);
+    // defaults epsilon to 100*numeric_limits<float>::epsilon()
+    Floating::WithinRelMatcher WithinRel(float target);
+
+} // namespace Matchers
+} // namespace Catch
+
+// end catch_matchers_floating.h
+// start catch_matchers_generic.hpp
+
+#include <functional>
+#include <string>
+
+namespace Catch {
+namespace Matchers {
+namespace Generic {
+
+namespace Detail {
+    std::string finalizeDescription(const std::string& desc);
+}
+
+template <typename T>
+class PredicateMatcher : public MatcherBase<T> {
+    std::function<bool(T const&)> m_predicate;
+    std::string m_description;
+public:
+
+    PredicateMatcher(std::function<bool(T const&)> const& elem, std::string const& descr)
+        :m_predicate(std::move(elem)),
+        m_description(Detail::finalizeDescription(descr))
+    {}
+
+    bool match( T const& item ) const override {
+        return m_predicate(item);
+    }
+
+    std::string describe() const override {
+        return m_description;
+    }
+};
+
+} // namespace Generic
+
+    // The following functions create the actual matcher objects.
+    // The user has to explicitly specify type to the function, because
+    // inferring std::function<bool(T const&)> is hard (but possible) and
+    // requires a lot of TMP.
+    template<typename T>
+    Generic::PredicateMatcher<T> Predicate(std::function<bool(T const&)> const& predicate, std::string const& description = "") {
+        return Generic::PredicateMatcher<T>(predicate, description);
+    }
+
+} // namespace Matchers
+} // namespace Catch
+
+// end catch_matchers_generic.hpp
+// start catch_matchers_string.h
+
+#include <string>
+
+namespace Catch {
+namespace Matchers {
+
+    namespace StdString {
+
+        struct CasedString
+        {
+            CasedString( std::string const& str, CaseSensitive::Choice caseSensitivity );
+            std::string adjustString( std::string const& str ) const;
+            std::string caseSensitivitySuffix() const;
+
+            CaseSensitive::Choice m_caseSensitivity;
+            std::string m_str;
+        };
+
+        struct StringMatcherBase : MatcherBase<std::string> {
+            StringMatcherBase( std::string const& operation, CasedString const& comparator );
+            std::string describe() const override;
+
+            CasedString m_comparator;
+            std::string m_operation;
+        };
+
+        struct EqualsMatcher : StringMatcherBase {
+            EqualsMatcher( CasedString const& comparator );
+            bool match( std::string const& source ) const override;
+        };
+        struct ContainsMatcher : StringMatcherBase {
+            ContainsMatcher( CasedString const& comparator );
+            bool match( std::string const& source ) const override;
+        };
+        struct StartsWithMatcher : StringMatcherBase {
+            StartsWithMatcher( CasedString const& comparator );
+            bool match( std::string const& source ) const override;
+        };
+        struct EndsWithMatcher : StringMatcherBase {
+            EndsWithMatcher( CasedString const& comparator );
+            bool match( std::string const& source ) const override;
+        };
+
+        struct RegexMatcher : MatcherBase<std::string> {
+            RegexMatcher( std::string regex, CaseSensitive::Choice caseSensitivity );
+            bool match( std::string const& matchee ) const override;
+            std::string describe() const override;
+
+        private:
+            std::string m_regex;
+            CaseSensitive::Choice m_caseSensitivity;
+        };
+
+    } // namespace StdString
+
+    // The following functions create the actual matcher objects.
+    // This allows the types to be inferred
+
+    StdString::EqualsMatcher Equals( std::string const& str, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes );
+    StdString::ContainsMatcher Contains( std::string const& str, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes );
+    StdString::EndsWithMatcher EndsWith( std::string const& str, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes );
+    StdString::StartsWithMatcher StartsWith( std::string const& str, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes );
+    StdString::RegexMatcher Matches( std::string const& regex, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes );
+
+} // namespace Matchers
+} // namespace Catch
+
+// end catch_matchers_string.h
+// start catch_matchers_vector.h
+
+#include <algorithm>
+
+namespace Catch {
+namespace Matchers {
+
+    namespace Vector {
+        template<typename T, typename Alloc>
+        struct ContainsElementMatcher : MatcherBase<std::vector<T, Alloc>> {
+
+            ContainsElementMatcher(T const &comparator) : m_comparator( comparator) {}
+
+            bool match(std::vector<T, Alloc> const &v) const override {
+                for (auto const& el : v) {
+                    if (el == m_comparator) {
+                        return true;
+                    }
+                }
+                return false;
+            }
+
+            std::string describe() const override {
+                return "Contains: " + ::Catch::Detail::stringify( m_comparator );
+            }
+
+            T const& m_comparator;
+        };
+
+        template<typename T, typename AllocComp, typename AllocMatch>
+        struct ContainsMatcher : MatcherBase<std::vector<T, AllocMatch>> {
+
+            ContainsMatcher(std::vector<T, AllocComp> const &comparator) : m_comparator( comparator ) {}
+
+            bool match(std::vector<T, AllocMatch> const &v) const override {
+                // !TBD: see note in EqualsMatcher
+                if (m_comparator.size() > v.size())
+                    return false;
+                for (auto const& comparator : m_comparator) {
+                    auto present = false;
+                    for (const auto& el : v) {
+                        if (el == comparator) {
+                            present = true;
+                            break;
+                        }
+                    }
+                    if (!present) {
+                        return false;
+                    }
+                }
+                return true;
+            }
+            std::string describe() const override {
+                return "Contains: " + ::Catch::Detail::stringify( m_comparator );
+            }
+
+            std::vector<T, AllocComp> const& m_comparator;
+        };
+
+        template<typename T, typename AllocComp, typename AllocMatch>
+        struct EqualsMatcher : MatcherBase<std::vector<T, AllocMatch>> {
+
+            EqualsMatcher(std::vector<T, AllocComp> const &comparator) : m_comparator( comparator ) {}
+
+            bool match(std::vector<T, AllocMatch> const &v) const override {
+                // !TBD: This currently works if all elements can be compared using !=
+                // - a more general approach would be via a compare template that defaults
+                // to using !=. but could be specialised for, e.g. std::vector<T, Alloc> etc
+                // - then just call that directly
+                if (m_comparator.size() != v.size())
+                    return false;
+                for (std::size_t i = 0; i < v.size(); ++i)
+                    if (m_comparator[i] != v[i])
+                        return false;
+                return true;
+            }
+            std::string describe() const override {
+                return "Equals: " + ::Catch::Detail::stringify( m_comparator );
+            }
+            std::vector<T, AllocComp> const& m_comparator;
+        };
+
+        template<typename T, typename AllocComp, typename AllocMatch>
+        struct ApproxMatcher : MatcherBase<std::vector<T, AllocMatch>> {
+
+            ApproxMatcher(std::vector<T, AllocComp> const& comparator) : m_comparator( comparator ) {}
+
+            bool match(std::vector<T, AllocMatch> const &v) const override {
+                if (m_comparator.size() != v.size())
+                    return false;
+                for (std::size_t i = 0; i < v.size(); ++i)
+                    if (m_comparator[i] != approx(v[i]))
+                        return false;
+                return true;
+            }
+            std::string describe() const override {
+                return "is approx: " + ::Catch::Detail::stringify( m_comparator );
+            }
+            template <typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+            ApproxMatcher& epsilon( T const& newEpsilon ) {
+                approx.epsilon(newEpsilon);
+                return *this;
+            }
+            template <typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+            ApproxMatcher& margin( T const& newMargin ) {
+                approx.margin(newMargin);
+                return *this;
+            }
+            template <typename = typename std::enable_if<std::is_constructible<double, T>::value>::type>
+            ApproxMatcher& scale( T const& newScale ) {
+                approx.scale(newScale);
+                return *this;
+            }
+
+            std::vector<T, AllocComp> const& m_comparator;
+            mutable Catch::Detail::Approx approx = Catch::Detail::Approx::custom();
+        };
+
+        template<typename T, typename AllocComp, typename AllocMatch>
+        struct UnorderedEqualsMatcher : MatcherBase<std::vector<T, AllocMatch>> {
+            UnorderedEqualsMatcher(std::vector<T, AllocComp> const& target) : m_target(target) {}
+            bool match(std::vector<T, AllocMatch> const& vec) const override {
+                if (m_target.size() != vec.size()) {
+                    return false;
+                }
+                return std::is_permutation(m_target.begin(), m_target.end(), vec.begin());
+            }
+
+            std::string describe() const override {
+                return "UnorderedEquals: " + ::Catch::Detail::stringify(m_target);
+            }
+        private:
+            std::vector<T, AllocComp> const& m_target;
+        };
+
+    } // namespace Vector
+
+    // The following functions create the actual matcher objects.
+    // This allows the types to be inferred
+
+    template<typename T, typename AllocComp = std::allocator<T>, typename AllocMatch = AllocComp>
+    Vector::ContainsMatcher<T, AllocComp, AllocMatch> Contains( std::vector<T, AllocComp> const& comparator ) {
+        return Vector::ContainsMatcher<T, AllocComp, AllocMatch>( comparator );
+    }
+
+    template<typename T, typename Alloc = std::allocator<T>>
+    Vector::ContainsElementMatcher<T, Alloc> VectorContains( T const& comparator ) {
+        return Vector::ContainsElementMatcher<T, Alloc>( comparator );
+    }
+
+    template<typename T, typename AllocComp = std::allocator<T>, typename AllocMatch = AllocComp>
+    Vector::EqualsMatcher<T, AllocComp, AllocMatch> Equals( std::vector<T, AllocComp> const& comparator ) {
+        return Vector::EqualsMatcher<T, AllocComp, AllocMatch>( comparator );
+    }
+
+    template<typename T, typename AllocComp = std::allocator<T>, typename AllocMatch = AllocComp>
+    Vector::ApproxMatcher<T, AllocComp, AllocMatch> Approx( std::vector<T, AllocComp> const& comparator ) {
+        return Vector::ApproxMatcher<T, AllocComp, AllocMatch>( comparator );
+    }
+
+    template<typename T, typename AllocComp = std::allocator<T>, typename AllocMatch = AllocComp>
+    Vector::UnorderedEqualsMatcher<T, AllocComp, AllocMatch> UnorderedEquals(std::vector<T, AllocComp> const& target) {
+        return Vector::UnorderedEqualsMatcher<T, AllocComp, AllocMatch>( target );
+    }
+
+} // namespace Matchers
+} // namespace Catch
+
+// end catch_matchers_vector.h
+namespace Catch {
+
+    template<typename ArgT, typename MatcherT>
+    class MatchExpr : public ITransientExpression {
+        ArgT const& m_arg;
+        MatcherT m_matcher;
+        StringRef m_matcherString;
+    public:
+        MatchExpr( ArgT const& arg, MatcherT const& matcher, StringRef const& matcherString )
+        :   ITransientExpression{ true, matcher.match( arg ) },
+            m_arg( arg ),
+            m_matcher( matcher ),
+            m_matcherString( matcherString )
+        {}
+
+        void streamReconstructedExpression( std::ostream &os ) const override {
+            auto matcherAsString = m_matcher.toString();
+            os << Catch::Detail::stringify( m_arg ) << ' ';
+            if( matcherAsString == Detail::unprintableString )
+                os << m_matcherString;
+            else
+                os << matcherAsString;
+        }
+    };
+
+    using StringMatcher = Matchers::Impl::MatcherBase<std::string>;
+
+    void handleExceptionMatchExpr( AssertionHandler& handler, StringMatcher const& matcher, StringRef const& matcherString  );
+
+    template<typename ArgT, typename MatcherT>
+    auto makeMatchExpr( ArgT const& arg, MatcherT const& matcher, StringRef const& matcherString  ) -> MatchExpr<ArgT, MatcherT> {
+        return MatchExpr<ArgT, MatcherT>( arg, matcher, matcherString );
+    }
+
+} // namespace Catch
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CHECK_THAT( macroName, matcher, resultDisposition, arg ) \
+    do { \
+        Catch::AssertionHandler catchAssertionHandler( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(arg) ", " CATCH_INTERNAL_STRINGIFY(matcher), resultDisposition ); \
+        INTERNAL_CATCH_TRY { \
+            catchAssertionHandler.handleExpr( Catch::makeMatchExpr( arg, matcher, #matcher##_catch_sr ) ); \
+        } INTERNAL_CATCH_CATCH( catchAssertionHandler ) \
+        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
+    } while( false )
+
+///////////////////////////////////////////////////////////////////////////////
+#define INTERNAL_CATCH_THROWS_MATCHES( macroName, exceptionType, resultDisposition, matcher, ... ) \
+    do { \
+        Catch::AssertionHandler catchAssertionHandler( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__) ", " CATCH_INTERNAL_STRINGIFY(exceptionType) ", " CATCH_INTERNAL_STRINGIFY(matcher), resultDisposition ); \
+        if( catchAssertionHandler.allowThrows() ) \
+            try { \
+                static_cast<void>(__VA_ARGS__ ); \
+                catchAssertionHandler.handleUnexpectedExceptionNotThrown(); \
+            } \
+            catch( exceptionType const& ex ) { \
+                catchAssertionHandler.handleExpr( Catch::makeMatchExpr( ex, matcher, #matcher##_catch_sr ) ); \
+            } \
+            catch( ... ) { \
+                catchAssertionHandler.handleUnexpectedInflightException(); \
+            } \
+        else \
+            catchAssertionHandler.handleThrowingCallSkipped(); \
+        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
+    } while( false )
+
+// end catch_capture_matchers.h
+#endif
+// start catch_generators.hpp
+
+// start catch_interfaces_generatortracker.h
+
+
+#include <memory>
+
+namespace Catch {
+
+    namespace Generators {
+        class GeneratorUntypedBase {
+        public:
+            GeneratorUntypedBase() = default;
+            virtual ~GeneratorUntypedBase();
+            // Attempts to move the generator to the next element
+             //
+             // Returns true iff the move succeeded (and a valid element
+             // can be retrieved).
+            virtual bool next() = 0;
+        };
+        using GeneratorBasePtr = std::unique_ptr<GeneratorUntypedBase>;
+
+    } // namespace Generators
+
+    struct IGeneratorTracker {
+        virtual ~IGeneratorTracker();
+        virtual auto hasGenerator() const -> bool = 0;
+        virtual auto getGenerator() const -> Generators::GeneratorBasePtr const& = 0;
+        virtual void setGenerator( Generators::GeneratorBasePtr&& generator ) = 0;
+    };
+
+} // namespace Catch
+
+// end catch_interfaces_generatortracker.h
+// start catch_enforce.h
+
+#include <exception>
+
+namespace Catch {
+#if !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+    template <typename Ex>
+    [[noreturn]]
+    void throw_exception(Ex const& e) {
+        throw e;
+    }
+#else // ^^ Exceptions are enabled //  Exceptions are disabled vv
+    [[noreturn]]
+    void throw_exception(std::exception const& e);
+#endif
+
+    [[noreturn]]
+    void throw_logic_error(std::string const& msg);
+    [[noreturn]]
+    void throw_domain_error(std::string const& msg);
+    [[noreturn]]
+    void throw_runtime_error(std::string const& msg);
+
+} // namespace Catch;
+
+#define CATCH_MAKE_MSG(...) \
+    (Catch::ReusableStringStream() << __VA_ARGS__).str()
+
+#define CATCH_INTERNAL_ERROR(...) \
+    Catch::throw_logic_error(CATCH_MAKE_MSG( CATCH_INTERNAL_LINEINFO << ": Internal Catch2 error: " << __VA_ARGS__))
+
+#define CATCH_ERROR(...) \
+    Catch::throw_domain_error(CATCH_MAKE_MSG( __VA_ARGS__ ))
+
+#define CATCH_RUNTIME_ERROR(...) \
+    Catch::throw_runtime_error(CATCH_MAKE_MSG( __VA_ARGS__ ))
+
+#define CATCH_ENFORCE( condition, ... ) \
+    do{ if( !(condition) ) CATCH_ERROR( __VA_ARGS__ ); } while(false)
+
+// end catch_enforce.h
+#include <memory>
+#include <vector>
+#include <cassert>
+
+#include <utility>
+#include <exception>
+
+namespace Catch {
+
+class GeneratorException : public std::exception {
+    const char* const m_msg = "";
+
+public:
+    GeneratorException(const char* msg):
+        m_msg(msg)
+    {}
+
+    const char* what() const noexcept override final;
+};
+
+namespace Generators {
+
+    // !TBD move this into its own location?
+    namespace pf{
+        template<typename T, typename... Args>
+        std::unique_ptr<T> make_unique( Args&&... args ) {
+            return std::unique_ptr<T>(new T(std::forward<Args>(args)...));
+        }
+    }
+
+    template<typename T>
+    struct IGenerator : GeneratorUntypedBase {
+        virtual ~IGenerator() = default;
+
+        // Returns the current element of the generator
+        //
+        // \Precondition The generator is either freshly constructed,
+        // or the last call to `next()` returned true
+        virtual T const& get() const = 0;
+        using type = T;
+    };
+
+    template<typename T>
+    class SingleValueGenerator final : public IGenerator<T> {
+        T m_value;
+    public:
+        SingleValueGenerator(T&& value) : m_value(std::move(value)) {}
+
+        T const& get() const override {
+            return m_value;
+        }
+        bool next() override {
+            return false;
+        }
+    };
+
+    template<typename T>
+    class FixedValuesGenerator final : public IGenerator<T> {
+        static_assert(!std::is_same<T, bool>::value,
+            "FixedValuesGenerator does not support bools because of std::vector<bool>"
+            "specialization, use SingleValue Generator instead.");
+        std::vector<T> m_values;
+        size_t m_idx = 0;
+    public:
+        FixedValuesGenerator( std::initializer_list<T> values ) : m_values( values ) {}
+
+        T const& get() const override {
+            return m_values[m_idx];
+        }
+        bool next() override {
+            ++m_idx;
+            return m_idx < m_values.size();
+        }
+    };
+
+    template <typename T>
+    class GeneratorWrapper final {
+        std::unique_ptr<IGenerator<T>> m_generator;
+    public:
+        GeneratorWrapper(std::unique_ptr<IGenerator<T>> generator):
+            m_generator(std::move(generator))
+        {}
+        T const& get() const {
+            return m_generator->get();
+        }
+        bool next() {
+            return m_generator->next();
+        }
+    };
+
+    template <typename T>
+    GeneratorWrapper<T> value(T&& value) {
+        return GeneratorWrapper<T>(pf::make_unique<SingleValueGenerator<T>>(std::forward<T>(value)));
+    }
+    template <typename T>
+    GeneratorWrapper<T> values(std::initializer_list<T> values) {
+        return GeneratorWrapper<T>(pf::make_unique<FixedValuesGenerator<T>>(values));
+    }
+
+    template<typename T>
+    class Generators : public IGenerator<T> {
+        std::vector<GeneratorWrapper<T>> m_generators;
+        size_t m_current = 0;
+
+        void populate(GeneratorWrapper<T>&& generator) {
+            m_generators.emplace_back(std::move(generator));
+        }
+        void populate(T&& val) {
+            m_generators.emplace_back(value(std::forward<T>(val)));
+        }
+        template<typename U>
+        void populate(U&& val) {
+            populate(T(std::forward<U>(val)));
+        }
+        template<typename U, typename... Gs>
+        void populate(U&& valueOrGenerator, Gs &&... moreGenerators) {
+            populate(std::forward<U>(valueOrGenerator));
+            populate(std::forward<Gs>(moreGenerators)...);
+        }
+
+    public:
+        template <typename... Gs>
+        Generators(Gs &&... moreGenerators) {
+            m_generators.reserve(sizeof...(Gs));
+            populate(std::forward<Gs>(moreGenerators)...);
+        }
+
+        T const& get() const override {
+            return m_generators[m_current].get();
+        }
+
+        bool next() override {
+            if (m_current >= m_generators.size()) {
+                return false;
+            }
+            const bool current_status = m_generators[m_current].next();
+            if (!current_status) {
+                ++m_current;
+            }
+            return m_current < m_generators.size();
+        }
+    };
+
+    template<typename... Ts>
+    GeneratorWrapper<std::tuple<Ts...>> table( std::initializer_list<std::tuple<typename std::decay<Ts>::type...>> tuples ) {
+        return values<std::tuple<Ts...>>( tuples );
+    }
+
+    // Tag type to signal that a generator sequence should convert arguments to a specific type
+    template <typename T>
+    struct as {};
+
+    template<typename T, typename... Gs>
+    auto makeGenerators( GeneratorWrapper<T>&& generator, Gs &&... moreGenerators ) -> Generators<T> {
+        return Generators<T>(std::move(generator), std::forward<Gs>(moreGenerators)...);
+    }
+    template<typename T>
+    auto makeGenerators( GeneratorWrapper<T>&& generator ) -> Generators<T> {
+        return Generators<T>(std::move(generator));
+    }
+    template<typename T, typename... Gs>
+    auto makeGenerators( T&& val, Gs &&... moreGenerators ) -> Generators<T> {
+        return makeGenerators( value( std::forward<T>( val ) ), std::forward<Gs>( moreGenerators )... );
+    }
+    template<typename T, typename U, typename... Gs>
+    auto makeGenerators( as<T>, U&& val, Gs &&... moreGenerators ) -> Generators<T> {
+        return makeGenerators( value( T( std::forward<U>( val ) ) ), std::forward<Gs>( moreGenerators )... );
+    }
+
+    auto acquireGeneratorTracker( StringRef generatorName, SourceLineInfo const& lineInfo ) -> IGeneratorTracker&;
+
+    template<typename L>
+    // Note: The type after -> is weird, because VS2015 cannot parse
+    //       the expression used in the typedef inside, when it is in
+    //       return type. Yeah.
+    auto generate( StringRef generatorName, SourceLineInfo const& lineInfo, L const& generatorExpression ) -> decltype(std::declval<decltype(generatorExpression())>().get()) {
+        using UnderlyingType = typename decltype(generatorExpression())::type;
+
+        IGeneratorTracker& tracker = acquireGeneratorTracker( generatorName, lineInfo );
+        if (!tracker.hasGenerator()) {
+            tracker.setGenerator(pf::make_unique<Generators<UnderlyingType>>(generatorExpression()));
+        }
+
+        auto const& generator = static_cast<IGenerator<UnderlyingType> const&>( *tracker.getGenerator() );
+        return generator.get();
+    }
+
+} // namespace Generators
+} // namespace Catch
+
+#define GENERATE( ... ) \
+    Catch::Generators::generate( INTERNAL_CATCH_STRINGIZE(INTERNAL_CATCH_UNIQUE_NAME(generator)), \
+                                 CATCH_INTERNAL_LINEINFO, \
+                                 [ ]{ using namespace Catch::Generators; return makeGenerators( __VA_ARGS__ ); } ) //NOLINT(google-build-using-namespace)
+#define GENERATE_COPY( ... ) \
+    Catch::Generators::generate( INTERNAL_CATCH_STRINGIZE(INTERNAL_CATCH_UNIQUE_NAME(generator)), \
+                                 CATCH_INTERNAL_LINEINFO, \
+                                 [=]{ using namespace Catch::Generators; return makeGenerators( __VA_ARGS__ ); } ) //NOLINT(google-build-using-namespace)
+#define GENERATE_REF( ... ) \
+    Catch::Generators::generate( INTERNAL_CATCH_STRINGIZE(INTERNAL_CATCH_UNIQUE_NAME(generator)), \
+                                 CATCH_INTERNAL_LINEINFO, \
+                                 [&]{ using namespace Catch::Generators; return makeGenerators( __VA_ARGS__ ); } ) //NOLINT(google-build-using-namespace)
+
+// end catch_generators.hpp
+// start catch_generators_generic.hpp
+
+namespace Catch {
+namespace Generators {
+
+    template <typename T>
+    class TakeGenerator : public IGenerator<T> {
+        GeneratorWrapper<T> m_generator;
+        size_t m_returned = 0;
+        size_t m_target;
+    public:
+        TakeGenerator(size_t target, GeneratorWrapper<T>&& generator):
+            m_generator(std::move(generator)),
+            m_target(target)
+        {
+            assert(target != 0 && "Empty generators are not allowed");
+        }
+        T const& get() const override {
+            return m_generator.get();
+        }
+        bool next() override {
+            ++m_returned;
+            if (m_returned >= m_target) {
+                return false;
+            }
+
+            const auto success = m_generator.next();
+            // If the underlying generator does not contain enough values
+            // then we cut short as well
+            if (!success) {
+                m_returned = m_target;
+            }
+            return success;
+        }
+    };
+
+    template <typename T>
+    GeneratorWrapper<T> take(size_t target, GeneratorWrapper<T>&& generator) {
+        return GeneratorWrapper<T>(pf::make_unique<TakeGenerator<T>>(target, std::move(generator)));
+    }
+
+    template <typename T, typename Predicate>
+    class FilterGenerator : public IGenerator<T> {
+        GeneratorWrapper<T> m_generator;
+        Predicate m_predicate;
+    public:
+        template <typename P = Predicate>
+        FilterGenerator(P&& pred, GeneratorWrapper<T>&& generator):
+            m_generator(std::move(generator)),
+            m_predicate(std::forward<P>(pred))
+        {
+            if (!m_predicate(m_generator.get())) {
+                // It might happen that there are no values that pass the
+                // filter. In that case we throw an exception.
+                auto has_initial_value = nextImpl();
+                if (!has_initial_value) {
+                    Catch::throw_exception(GeneratorException("No valid value found in filtered generator"));
+                }
+            }
+        }
+
+        T const& get() const override {
+            return m_generator.get();
+        }
+
+        bool next() override {
+            return nextImpl();
+        }
+
+    private:
+        bool nextImpl() {
+            bool success = m_generator.next();
+            if (!success) {
+                return false;
+            }
+            while (!m_predicate(m_generator.get()) && (success = m_generator.next()) == true);
+            return success;
+        }
+    };
+
+    template <typename T, typename Predicate>
+    GeneratorWrapper<T> filter(Predicate&& pred, GeneratorWrapper<T>&& generator) {
+        return GeneratorWrapper<T>(std::unique_ptr<IGenerator<T>>(pf::make_unique<FilterGenerator<T, Predicate>>(std::forward<Predicate>(pred), std::move(generator))));
+    }
+
+    template <typename T>
+    class RepeatGenerator : public IGenerator<T> {
+        static_assert(!std::is_same<T, bool>::value,
+            "RepeatGenerator currently does not support bools"
+            "because of std::vector<bool> specialization");
+        GeneratorWrapper<T> m_generator;
+        mutable std::vector<T> m_returned;
+        size_t m_target_repeats;
+        size_t m_current_repeat = 0;
+        size_t m_repeat_index = 0;
+    public:
+        RepeatGenerator(size_t repeats, GeneratorWrapper<T>&& generator):
+            m_generator(std::move(generator)),
+            m_target_repeats(repeats)
+        {
+            assert(m_target_repeats > 0 && "Repeat generator must repeat at least once");
+        }
+
+        T const& get() const override {
+            if (m_current_repeat == 0) {
+                m_returned.push_back(m_generator.get());
+                return m_returned.back();
+            }
+            return m_returned[m_repeat_index];
+        }
+
+        bool next() override {
+            // There are 2 basic cases:
+            // 1) We are still reading the generator
+            // 2) We are reading our own cache
+
+            // In the first case, we need to poke the underlying generator.
+            // If it happily moves, we are left in that state, otherwise it is time to start reading from our cache
+            if (m_current_repeat == 0) {
+                const auto success = m_generator.next();
+                if (!success) {
+                    ++m_current_repeat;
+                }
+                return m_current_repeat < m_target_repeats;
+            }
+
+            // In the second case, we need to move indices forward and check that we haven't run up against the end
+            ++m_repeat_index;
+            if (m_repeat_index == m_returned.size()) {
+                m_repeat_index = 0;
+                ++m_current_repeat;
+            }
+            return m_current_repeat < m_target_repeats;
+        }
+    };
+
+    template <typename T>
+    GeneratorWrapper<T> repeat(size_t repeats, GeneratorWrapper<T>&& generator) {
+        return GeneratorWrapper<T>(pf::make_unique<RepeatGenerator<T>>(repeats, std::move(generator)));
+    }
+
+    template <typename T, typename U, typename Func>
+    class MapGenerator : public IGenerator<T> {
+        // TBD: provide static assert for mapping function, for friendly error message
+        GeneratorWrapper<U> m_generator;
+        Func m_function;
+        // To avoid returning dangling reference, we have to save the values
+        T m_cache;
+    public:
+        template <typename F2 = Func>
+        MapGenerator(F2&& function, GeneratorWrapper<U>&& generator) :
+            m_generator(std::move(generator)),
+            m_function(std::forward<F2>(function)),
+            m_cache(m_function(m_generator.get()))
+        {}
+
+        T const& get() const override {
+            return m_cache;
+        }
+        bool next() override {
+            const auto success = m_generator.next();
+            if (success) {
+                m_cache = m_function(m_generator.get());
+            }
+            return success;
+        }
+    };
+
+    template <typename Func, typename U, typename T = FunctionReturnType<Func, U>>
+    GeneratorWrapper<T> map(Func&& function, GeneratorWrapper<U>&& generator) {
+        return GeneratorWrapper<T>(
+            pf::make_unique<MapGenerator<T, U, Func>>(std::forward<Func>(function), std::move(generator))
+        );
+    }
+
+    template <typename T, typename U, typename Func>
+    GeneratorWrapper<T> map(Func&& function, GeneratorWrapper<U>&& generator) {
+        return GeneratorWrapper<T>(
+            pf::make_unique<MapGenerator<T, U, Func>>(std::forward<Func>(function), std::move(generator))
+        );
+    }
+
+    template <typename T>
+    class ChunkGenerator final : public IGenerator<std::vector<T>> {
+        std::vector<T> m_chunk;
+        size_t m_chunk_size;
+        GeneratorWrapper<T> m_generator;
+        bool m_used_up = false;
+    public:
+        ChunkGenerator(size_t size, GeneratorWrapper<T> generator) :
+            m_chunk_size(size), m_generator(std::move(generator))
+        {
+            m_chunk.reserve(m_chunk_size);
+            if (m_chunk_size != 0) {
+                m_chunk.push_back(m_generator.get());
+                for (size_t i = 1; i < m_chunk_size; ++i) {
+                    if (!m_generator.next()) {
+                        Catch::throw_exception(GeneratorException("Not enough values to initialize the first chunk"));
+                    }
+                    m_chunk.push_back(m_generator.get());
+                }
+            }
+        }
+        std::vector<T> const& get() const override {
+            return m_chunk;
+        }
+        bool next() override {
+            m_chunk.clear();
+            for (size_t idx = 0; idx < m_chunk_size; ++idx) {
+                if (!m_generator.next()) {
+                    return false;
+                }
+                m_chunk.push_back(m_generator.get());
+            }
+            return true;
+        }
+    };
+
+    template <typename T>
+    GeneratorWrapper<std::vector<T>> chunk(size_t size, GeneratorWrapper<T>&& generator) {
+        return GeneratorWrapper<std::vector<T>>(
+            pf::make_unique<ChunkGenerator<T>>(size, std::move(generator))
+        );
+    }
+
+} // namespace Generators
+} // namespace Catch
+
+// end catch_generators_generic.hpp
+// start catch_generators_specific.hpp
+
+// start catch_context.h
+
+#include <memory>
+
+namespace Catch {
+
+    struct IResultCapture;
+    struct IRunner;
+    struct IConfig;
+    struct IMutableContext;
+
+    using IConfigPtr = std::shared_ptr<IConfig const>;
+
+    struct IContext
+    {
+        virtual ~IContext();
+
+        virtual IResultCapture* getResultCapture() = 0;
+        virtual IRunner* getRunner() = 0;
+        virtual IConfigPtr const& getConfig() const = 0;
+    };
+
+    struct IMutableContext : IContext
+    {
+        virtual ~IMutableContext();
+        virtual void setResultCapture( IResultCapture* resultCapture ) = 0;
+        virtual void setRunner( IRunner* runner ) = 0;
+        virtual void setConfig( IConfigPtr const& config ) = 0;
+
+    private:
+        static IMutableContext *currentContext;
+        friend IMutableContext& getCurrentMutableContext();
+        friend void cleanUpContext();
+        static void createContext();
+    };
+
+    inline IMutableContext& getCurrentMutableContext()
+    {
+        if( !IMutableContext::currentContext )
+            IMutableContext::createContext();
+        // NOLINTNEXTLINE(clang-analyzer-core.uninitialized.UndefReturn)
+        return *IMutableContext::currentContext;
+    }
+
+    inline IContext& getCurrentContext()
+    {
+        return getCurrentMutableContext();
+    }
+
+    void cleanUpContext();
+
+    class SimplePcg32;
+    SimplePcg32& rng();
+}
+
+// end catch_context.h
+// start catch_interfaces_config.h
+
+// start catch_option.hpp
+
+namespace Catch {
+
+    // An optional type
+    template<typename T>
+    class Option {
+    public:
+        Option() : nullableValue( nullptr ) {}
+        Option( T const& _value )
+        : nullableValue( new( storage ) T( _value ) )
+        {}
+        Option( Option const& _other )
+        : nullableValue( _other ? new( storage ) T( *_other ) : nullptr )
+        {}
+
+        ~Option() {
+            reset();
+        }
+
+        Option& operator= ( Option const& _other ) {
+            if( &_other != this ) {
+                reset();
+                if( _other )
+                    nullableValue = new( storage ) T( *_other );
+            }
+            return *this;
+        }
+        Option& operator = ( T const& _value ) {
+            reset();
+            nullableValue = new( storage ) T( _value );
+            return *this;
+        }
+
+        void reset() {
+            if( nullableValue )
+                nullableValue->~T();
+            nullableValue = nullptr;
+        }
+
+        T& operator*() { return *nullableValue; }
+        T const& operator*() const { return *nullableValue; }
+        T* operator->() { return nullableValue; }
+        const T* operator->() const { return nullableValue; }
+
+        T valueOr( T const& defaultValue ) const {
+            return nullableValue ? *nullableValue : defaultValue;
+        }
+
+        bool some() const { return nullableValue != nullptr; }
+        bool none() const { return nullableValue == nullptr; }
+
+        bool operator !() const { return nullableValue == nullptr; }
+        explicit operator bool() const {
+            return some();
+        }
+
+    private:
+        T *nullableValue;
+        alignas(alignof(T)) char storage[sizeof(T)];
+    };
+
+} // end namespace Catch
+
+// end catch_option.hpp
+#include <chrono>
+#include <iosfwd>
+#include <string>
+#include <vector>
+#include <memory>
+
+namespace Catch {
+
+    enum class Verbosity {
+        Quiet = 0,
+        Normal,
+        High
+    };
+
+    struct WarnAbout { enum What {
+        Nothing = 0x00,
+        NoAssertions = 0x01,
+        NoTests = 0x02
+    }; };
+
+    struct ShowDurations { enum OrNot {
+        DefaultForReporter,
+        Always,
+        Never
+    }; };
+    struct RunTests { enum InWhatOrder {
+        InDeclarationOrder,
+        InLexicographicalOrder,
+        InRandomOrder
+    }; };
+    struct UseColour { enum YesOrNo {
+        Auto,
+        Yes,
+        No
+    }; };
+    struct WaitForKeypress { enum When {
+        Never,
+        BeforeStart = 1,
+        BeforeExit = 2,
+        BeforeStartAndExit = BeforeStart | BeforeExit
+    }; };
+
+    class TestSpec;
+
+    struct IConfig : NonCopyable {
+
+        virtual ~IConfig();
+
+        virtual bool allowThrows() const = 0;
+        virtual std::ostream& stream() const = 0;
+        virtual std::string name() const = 0;
+        virtual bool includeSuccessfulResults() const = 0;
+        virtual bool shouldDebugBreak() const = 0;
+        virtual bool warnAboutMissingAssertions() const = 0;
+        virtual bool warnAboutNoTests() const = 0;
+        virtual int abortAfter() const = 0;
+        virtual bool showInvisibles() const = 0;
+        virtual ShowDurations::OrNot showDurations() const = 0;
+        virtual double minDuration() const = 0;
+        virtual TestSpec const& testSpec() const = 0;
+        virtual bool hasTestFilters() const = 0;
+        virtual std::vector<std::string> const& getTestsOrTags() const = 0;
+        virtual RunTests::InWhatOrder runOrder() const = 0;
+        virtual unsigned int rngSeed() const = 0;
+        virtual UseColour::YesOrNo useColour() const = 0;
+        virtual std::vector<std::string> const& getSectionsToRun() const = 0;
+        virtual Verbosity verbosity() const = 0;
+
+        virtual bool benchmarkNoAnalysis() const = 0;
+        virtual int benchmarkSamples() const = 0;
+        virtual double benchmarkConfidenceInterval() const = 0;
+        virtual unsigned int benchmarkResamples() const = 0;
+        virtual std::chrono::milliseconds benchmarkWarmupTime() const = 0;
+    };
+
+    using IConfigPtr = std::shared_ptr<IConfig const>;
+}
+
+// end catch_interfaces_config.h
+// start catch_random_number_generator.h
+
+#include <cstdint>
+
+namespace Catch {
+
+    // This is a simple implementation of C++11 Uniform Random Number
+    // Generator. It does not provide all operators, because Catch2
+    // does not use it, but it should behave as expected inside stdlib's
+    // distributions.
+    // The implementation is based on the PCG family (http://pcg-random.org)
+    class SimplePcg32 {
+        using state_type = std::uint64_t;
+    public:
+        using result_type = std::uint32_t;
+        static constexpr result_type (min)() {
+            return 0;
+        }
+        static constexpr result_type (max)() {
+            return static_cast<result_type>(-1);
+        }
+
+        // Provide some default initial state for the default constructor
+        SimplePcg32():SimplePcg32(0xed743cc4U) {}
+
+        explicit SimplePcg32(result_type seed_);
+
+        void seed(result_type seed_);
+        void discard(uint64_t skip);
+
+        result_type operator()();
+
+    private:
+        friend bool operator==(SimplePcg32 const& lhs, SimplePcg32 const& rhs);
+        friend bool operator!=(SimplePcg32 const& lhs, SimplePcg32 const& rhs);
+
+        // In theory we also need operator<< and operator>>
+        // In practice we do not use them, so we will skip them for now
+
+        std::uint64_t m_state;
+        // This part of the state determines which "stream" of the numbers
+        // is chosen -- we take it as a constant for Catch2, so we only
+        // need to deal with seeding the main state.
+        // Picked by reading 8 bytes from `/dev/random` :-)
+        static const std::uint64_t s_inc = (0x13ed0cc53f939476ULL << 1ULL) | 1ULL;
+    };
+
+} // end namespace Catch
+
+// end catch_random_number_generator.h
+#include <random>
+
+namespace Catch {
+namespace Generators {
+
+template <typename Float>
+class RandomFloatingGenerator final : public IGenerator<Float> {
+    Catch::SimplePcg32& m_rng;
+    std::uniform_real_distribution<Float> m_dist;
+    Float m_current_number;
+public:
+
+    RandomFloatingGenerator(Float a, Float b):
+        m_rng(rng()),
+        m_dist(a, b) {
+        static_cast<void>(next());
+    }
+
+    Float const& get() const override {
+        return m_current_number;
+    }
+    bool next() override {
+        m_current_number = m_dist(m_rng);
+        return true;
+    }
+};
+
+template <typename Integer>
+class RandomIntegerGenerator final : public IGenerator<Integer> {
+    Catch::SimplePcg32& m_rng;
+    std::uniform_int_distribution<Integer> m_dist;
+    Integer m_current_number;
+public:
+
+    RandomIntegerGenerator(Integer a, Integer b):
+        m_rng(rng()),
+        m_dist(a, b) {
+        static_cast<void>(next());
+    }
+
+    Integer const& get() const override {
+        return m_current_number;
+    }
+    bool next() override {
+        m_current_number = m_dist(m_rng);
+        return true;
+    }
+};
+
+// TODO: Ideally this would be also constrained against the various char types,
+//       but I don't expect users to run into that in practice.
+template <typename T>
+typename std::enable_if<std::is_integral<T>::value && !std::is_same<T, bool>::value,
+GeneratorWrapper<T>>::type
+random(T a, T b) {
+    return GeneratorWrapper<T>(
+        pf::make_unique<RandomIntegerGenerator<T>>(a, b)
+    );
+}
+
+template <typename T>
+typename std::enable_if<std::is_floating_point<T>::value,
+GeneratorWrapper<T>>::type
+random(T a, T b) {
+    return GeneratorWrapper<T>(
+        pf::make_unique<RandomFloatingGenerator<T>>(a, b)
+    );
+}
+
+template <typename T>
+class RangeGenerator final : public IGenerator<T> {
+    T m_current;
+    T m_end;
+    T m_step;
+    bool m_positive;
+
+public:
+    RangeGenerator(T const& start, T const& end, T const& step):
+        m_current(start),
+        m_end(end),
+        m_step(step),
+        m_positive(m_step > T(0))
+    {
+        assert(m_current != m_end && "Range start and end cannot be equal");
+        assert(m_step != T(0) && "Step size cannot be zero");
+        assert(((m_positive && m_current <= m_end) || (!m_positive && m_current >= m_end)) && "Step moves away from end");
+    }
+
+    RangeGenerator(T const& start, T const& end):
+        RangeGenerator(start, end, (start < end) ? T(1) : T(-1))
+    {}
+
+    T const& get() const override {
+        return m_current;
+    }
+
+    bool next() override {
+        m_current += m_step;
+        return (m_positive) ? (m_current < m_end) : (m_current > m_end);
+    }
+};
+
+template <typename T>
+GeneratorWrapper<T> range(T const& start, T const& end, T const& step) {
+    static_assert(std::is_arithmetic<T>::value && !std::is_same<T, bool>::value, "Type must be numeric");
+    return GeneratorWrapper<T>(pf::make_unique<RangeGenerator<T>>(start, end, step));
+}
+
+template <typename T>
+GeneratorWrapper<T> range(T const& start, T const& end) {
+    static_assert(std::is_integral<T>::value && !std::is_same<T, bool>::value, "Type must be an integer");
+    return GeneratorWrapper<T>(pf::make_unique<RangeGenerator<T>>(start, end));
+}
+
+template <typename T>
+class IteratorGenerator final : public IGenerator<T> {
+    static_assert(!std::is_same<T, bool>::value,
+        "IteratorGenerator currently does not support bools"
+        "because of std::vector<bool> specialization");
+
+    std::vector<T> m_elems;
+    size_t m_current = 0;
+public:
+    template <typename InputIterator, typename InputSentinel>
+    IteratorGenerator(InputIterator first, InputSentinel last):m_elems(first, last) {
+        if (m_elems.empty()) {
+            Catch::throw_exception(GeneratorException("IteratorGenerator received no valid values"));
+        }
+    }
+
+    T const& get() const override {
+        return m_elems[m_current];
+    }
+
+    bool next() override {
+        ++m_current;
+        return m_current != m_elems.size();
+    }
+};
+
+template <typename InputIterator,
+          typename InputSentinel,
+          typename ResultType = typename std::iterator_traits<InputIterator>::value_type>
+GeneratorWrapper<ResultType> from_range(InputIterator from, InputSentinel to) {
+    return GeneratorWrapper<ResultType>(pf::make_unique<IteratorGenerator<ResultType>>(from, to));
+}
+
+template <typename Container,
+          typename ResultType = typename Container::value_type>
+GeneratorWrapper<ResultType> from_range(Container const& cnt) {
+    return GeneratorWrapper<ResultType>(pf::make_unique<IteratorGenerator<ResultType>>(cnt.begin(), cnt.end()));
+}
+
+} // namespace Generators
+} // namespace Catch
+
+// end catch_generators_specific.hpp
+
+// These files are included here so the single_include script doesn't put them
+// in the conditionally compiled sections
+// start catch_test_case_info.h
+
+#include <string>
+#include <vector>
+#include <memory>
+
+#ifdef __clang__
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wpadded"
+#endif
+
+namespace Catch {
+
+    struct ITestInvoker;
+
+    struct TestCaseInfo {
+        enum SpecialProperties{
+            None = 0,
+            IsHidden = 1 << 1,
+            ShouldFail = 1 << 2,
+            MayFail = 1 << 3,
+            Throws = 1 << 4,
+            NonPortable = 1 << 5,
+            Benchmark = 1 << 6
+        };
+
+        TestCaseInfo(   std::string const& _name,
+                        std::string const& _className,
+                        std::string const& _description,
+                        std::vector<std::string> const& _tags,
+                        SourceLineInfo const& _lineInfo );
+
+        friend void setTags( TestCaseInfo& testCaseInfo, std::vector<std::string> tags );
+
+        bool isHidden() const;
+        bool throws() const;
+        bool okToFail() const;
+        bool expectedToFail() const;
+
+        std::string tagsAsString() const;
+
+        std::string name;
+        std::string className;
+        std::string description;
+        std::vector<std::string> tags;
+        std::vector<std::string> lcaseTags;
+        SourceLineInfo lineInfo;
+        SpecialProperties properties;
+    };
+
+    class TestCase : public TestCaseInfo {
+    public:
+
+        TestCase( ITestInvoker* testCase, TestCaseInfo&& info );
+
+        TestCase withName( std::string const& _newName ) const;
+
+        void invoke() const;
+
+        TestCaseInfo const& getTestCaseInfo() const;
+
+        bool operator == ( TestCase const& other ) const;
+        bool operator < ( TestCase const& other ) const;
+
+    private:
+        std::shared_ptr<ITestInvoker> test;
+    };
+
+    TestCase makeTestCase(  ITestInvoker* testCase,
+                            std::string const& className,
+                            NameAndTags const& nameAndTags,
+                            SourceLineInfo const& lineInfo );
+}
+
+#ifdef __clang__
+#pragma clang diagnostic pop
+#endif
+
+// end catch_test_case_info.h
+// start catch_interfaces_runner.h
+
+namespace Catch {
+
+    struct IRunner {
+        virtual ~IRunner();
+        virtual bool aborting() const = 0;
+    };
+}
+
+// end catch_interfaces_runner.h
+
+#ifdef __OBJC__
+// start catch_objc.hpp
+
+#import <objc/runtime.h>
+
+#include <string>
+
+// NB. Any general catch headers included here must be included
+// in catch.hpp first to make sure they are included by the single
+// header for non obj-usage
+
+///////////////////////////////////////////////////////////////////////////////
+// This protocol is really only here for (self) documenting purposes, since
+// all its methods are optional.
+@protocol OcFixture
+
+@optional
+
+-(void) setUp;
+-(void) tearDown;
+
+@end
+
+namespace Catch {
+
+    class OcMethod : public ITestInvoker {
+
+    public:
+        OcMethod( Class cls, SEL sel ) : m_cls( cls ), m_sel( sel ) {}
+
+        virtual void invoke() const {
+            id obj = [[m_cls alloc] init];
+
+            performOptionalSelector( obj, @selector(setUp)  );
+            performOptionalSelector( obj, m_sel );
+            performOptionalSelector( obj, @selector(tearDown)  );
+
+            arcSafeRelease( obj );
+        }
+    private:
+        virtual ~OcMethod() {}
+
+        Class m_cls;
+        SEL m_sel;
+    };
+
+    namespace Detail{
+
+        inline std::string getAnnotation(   Class cls,
+                                            std::string const& annotationName,
+                                            std::string const& testCaseName ) {
+            NSString* selStr = [[NSString alloc] initWithFormat:@"Catch_%s_%s", annotationName.c_str(), testCaseName.c_str()];
+            SEL sel = NSSelectorFromString( selStr );
+            arcSafeRelease( selStr );
+            id value = performOptionalSelector( cls, sel );
+            if( value )
+                return [(NSString*)value UTF8String];
+            return "";
+        }
+    }
+
+    inline std::size_t registerTestMethods() {
+        std::size_t noTestMethods = 0;
+        int noClasses = objc_getClassList( nullptr, 0 );
+
+        Class* classes = (CATCH_UNSAFE_UNRETAINED Class *)malloc( sizeof(Class) * noClasses);
+        objc_getClassList( classes, noClasses );
+
+        for( int c = 0; c < noClasses; c++ ) {
+            Class cls = classes[c];
+            {
+                u_int count;
+                Method* methods = class_copyMethodList( cls, &count );
+                for( u_int m = 0; m < count ; m++ ) {
+                    SEL selector = method_getName(methods[m]);
+                    std::string methodName = sel_getName(selector);
+                    if( startsWith( methodName, "Catch_TestCase_" ) ) {
+                        std::string testCaseName = methodName.substr( 15 );
+                        std::string name = Detail::getAnnotation( cls, "Name", testCaseName );
+                        std::string desc = Detail::getAnnotation( cls, "Description", testCaseName );
+                        const char* className = class_getName( cls );
+
+                        getMutableRegistryHub().registerTest( makeTestCase( new OcMethod( cls, selector ), className, NameAndTags( name.c_str(), desc.c_str() ), SourceLineInfo("",0) ) );
+                        noTestMethods++;
+                    }
+                }
+                free(methods);
+            }
+        }
+        return noTestMethods;
+    }
+
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+
+    namespace Matchers {
+        namespace Impl {
+        namespace NSStringMatchers {
+
+            struct StringHolder : MatcherBase<NSString*>{
+                StringHolder( NSString* substr ) : m_substr( [substr copy] ){}
+                StringHolder( StringHolder const& other ) : m_substr( [other.m_substr copy] ){}
+                StringHolder() {
+                    arcSafeRelease( m_substr );
+                }
+
+                bool match( NSString* str ) const override {
+                    return false;
+                }
+
+                NSString* CATCH_ARC_STRONG m_substr;
+            };
+
+            struct Equals : StringHolder {
+                Equals( NSString* substr ) : StringHolder( substr ){}
+
+                bool match( NSString* str ) const override {
+                    return  (str != nil || m_substr == nil ) &&
+                            [str isEqualToString:m_substr];
+                }
+
+                std::string describe() const override {
+                    return "equals string: " + Catch::Detail::stringify( m_substr );
+                }
+            };
+
+            struct Contains : StringHolder {
+                Contains( NSString* substr ) : StringHolder( substr ){}
+
+                bool match( NSString* str ) const override {
+                    return  (str != nil || m_substr == nil ) &&
+                            [str rangeOfString:m_substr].location != NSNotFound;
+                }
+
+                std::string describe() const override {
+                    return "contains string: " + Catch::Detail::stringify( m_substr );
+                }
+            };
+
+            struct StartsWith : StringHolder {
+                StartsWith( NSString* substr ) : StringHolder( substr ){}
+
+                bool match( NSString* str ) const override {
+                    return  (str != nil || m_substr == nil ) &&
+                            [str rangeOfString:m_substr].location == 0;
+                }
+
+                std::string describe() const override {
+                    return "starts with: " + Catch::Detail::stringify( m_substr );
+                }
+            };
+            struct EndsWith : StringHolder {
+                EndsWith( NSString* substr ) : StringHolder( substr ){}
+
+                bool match( NSString* str ) const override {
+                    return  (str != nil || m_substr == nil ) &&
+                            [str rangeOfString:m_substr].location == [str length] - [m_substr length];
+                }
+
+                std::string describe() const override {
+                    return "ends with: " + Catch::Detail::stringify( m_substr );
+                }
+            };
+
+        } // namespace NSStringMatchers
+        } // namespace Impl
+
+        inline Impl::NSStringMatchers::Equals
+            Equals( NSString* substr ){ return Impl::NSStringMatchers::Equals( substr ); }
+
+        inline Impl::NSStringMatchers::Contains
+            Contains( NSString* substr ){ return Impl::NSStringMatchers::Contains( substr ); }
+
+        inline Impl::NSStringMatchers::StartsWith
+            StartsWith( NSString* substr ){ return Impl::NSStringMatchers::StartsWith( substr ); }
+
+        inline Impl::NSStringMatchers::EndsWith
+            EndsWith( NSString* substr ){ return Impl::NSStringMatchers::EndsWith( substr ); }
+
+    } // namespace Matchers
+
+    using namespace Matchers;
+
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+
+} // namespace Catch
+
+///////////////////////////////////////////////////////////////////////////////
+#define OC_MAKE_UNIQUE_NAME( root, uniqueSuffix ) root##uniqueSuffix
+#define OC_TEST_CASE2( name, desc, uniqueSuffix ) \
++(NSString*) OC_MAKE_UNIQUE_NAME( Catch_Name_test_, uniqueSuffix ) \
+{ \
+return @ name; \
+} \
++(NSString*) OC_MAKE_UNIQUE_NAME( Catch_Description_test_, uniqueSuffix ) \
+{ \
+return @ desc; \
+} \
+-(void) OC_MAKE_UNIQUE_NAME( Catch_TestCase_test_, uniqueSuffix )
+
+#define OC_TEST_CASE( name, desc ) OC_TEST_CASE2( name, desc, __LINE__ )
+
+// end catch_objc.hpp
+#endif
+
+// Benchmarking needs the externally-facing parts of reporters to work
+#if defined(CATCH_CONFIG_EXTERNAL_INTERFACES) || defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+// start catch_external_interfaces.h
+
+// start catch_reporter_bases.hpp
+
+// start catch_interfaces_reporter.h
+
+// start catch_config.hpp
+
+// start catch_test_spec_parser.h
+
+#ifdef __clang__
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wpadded"
+#endif
+
+// start catch_test_spec.h
+
+#ifdef __clang__
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wpadded"
+#endif
+
+// start catch_wildcard_pattern.h
+
+namespace Catch
+{
+    class WildcardPattern {
+        enum WildcardPosition {
+            NoWildcard = 0,
+            WildcardAtStart = 1,
+            WildcardAtEnd = 2,
+            WildcardAtBothEnds = WildcardAtStart | WildcardAtEnd
+        };
+
+    public:
+
+        WildcardPattern( std::string const& pattern, CaseSensitive::Choice caseSensitivity );
+        virtual ~WildcardPattern() = default;
+        virtual bool matches( std::string const& str ) const;
+
+    private:
+        std::string normaliseString( std::string const& str ) const;
+        CaseSensitive::Choice m_caseSensitivity;
+        WildcardPosition m_wildcard = NoWildcard;
+        std::string m_pattern;
+    };
+}
+
+// end catch_wildcard_pattern.h
+#include <string>
+#include <vector>
+#include <memory>
+
+namespace Catch {
+
+    struct IConfig;
+
+    class TestSpec {
+        class Pattern {
+        public:
+            explicit Pattern( std::string const& name );
+            virtual ~Pattern();
+            virtual bool matches( TestCaseInfo const& testCase ) const = 0;
+            std::string const& name() const;
+        private:
+            std::string const m_name;
+        };
+        using PatternPtr = std::shared_ptr<Pattern>;
+
+        class NamePattern : public Pattern {
+        public:
+            explicit NamePattern( std::string const& name, std::string const& filterString );
+            bool matches( TestCaseInfo const& testCase ) const override;
+        private:
+            WildcardPattern m_wildcardPattern;
+        };
+
+        class TagPattern : public Pattern {
+        public:
+            explicit TagPattern( std::string const& tag, std::string const& filterString );
+            bool matches( TestCaseInfo const& testCase ) const override;
+        private:
+            std::string m_tag;
+        };
+
+        class ExcludedPattern : public Pattern {
+        public:
+            explicit ExcludedPattern( PatternPtr const& underlyingPattern );
+            bool matches( TestCaseInfo const& testCase ) const override;
+        private:
+            PatternPtr m_underlyingPattern;
+        };
+
+        struct Filter {
+            std::vector<PatternPtr> m_patterns;
+
+            bool matches( TestCaseInfo const& testCase ) const;
+            std::string name() const;
+        };
+
+    public:
+        struct FilterMatch {
+            std::string name;
+            std::vector<TestCase const*> tests;
+        };
+        using Matches = std::vector<FilterMatch>;
+        using vectorStrings = std::vector<std::string>;
+
+        bool hasFilters() const;
+        bool matches( TestCaseInfo const& testCase ) const;
+        Matches matchesByFilter( std::vector<TestCase> const& testCases, IConfig const& config ) const;
+        const vectorStrings & getInvalidArgs() const;
+
+    private:
+        std::vector<Filter> m_filters;
+        std::vector<std::string> m_invalidArgs;
+        friend class TestSpecParser;
+    };
+}
+
+#ifdef __clang__
+#pragma clang diagnostic pop
+#endif
+
+// end catch_test_spec.h
+// start catch_interfaces_tag_alias_registry.h
+
+#include <string>
+
+namespace Catch {
+
+    struct TagAlias;
+
+    struct ITagAliasRegistry {
+        virtual ~ITagAliasRegistry();
+        // Nullptr if not present
+        virtual TagAlias const* find( std::string const& alias ) const = 0;
+        virtual std::string expandAliases( std::string const& unexpandedTestSpec ) const = 0;
+
+        static ITagAliasRegistry const& get();
+    };
+
+} // end namespace Catch
+
+// end catch_interfaces_tag_alias_registry.h
+namespace Catch {
+
+    class TestSpecParser {
+        enum Mode{ None, Name, QuotedName, Tag, EscapedName };
+        Mode m_mode = None;
+        Mode lastMode = None;
+        bool m_exclusion = false;
+        std::size_t m_pos = 0;
+        std::size_t m_realPatternPos = 0;
+        std::string m_arg;
+        std::string m_substring;
+        std::string m_patternName;
+        std::vector<std::size_t> m_escapeChars;
+        TestSpec::Filter m_currentFilter;
+        TestSpec m_testSpec;
+        ITagAliasRegistry const* m_tagAliases = nullptr;
+
+    public:
+        TestSpecParser( ITagAliasRegistry const& tagAliases );
+
+        TestSpecParser& parse( std::string const& arg );
+        TestSpec testSpec();
+
+    private:
+        bool visitChar( char c );
+        void startNewMode( Mode mode );
+        bool processNoneChar( char c );
+        void processNameChar( char c );
+        bool processOtherChar( char c );
+        void endMode();
+        void escape();
+        bool isControlChar( char c ) const;
+        void saveLastMode();
+        void revertBackToLastMode();
+        void addFilter();
+        bool separate();
+
+        // Handles common preprocessing of the pattern for name/tag patterns
+        std::string preprocessPattern();
+        // Adds the current pattern as a test name
+        void addNamePattern();
+        // Adds the current pattern as a tag
+        void addTagPattern();
+
+        inline void addCharToPattern(char c) {
+            m_substring += c;
+            m_patternName += c;
+            m_realPatternPos++;
+        }
+
+    };
+    TestSpec parseTestSpec( std::string const& arg );
+
+} // namespace Catch
+
+#ifdef __clang__
+#pragma clang diagnostic pop
+#endif
+
+// end catch_test_spec_parser.h
+// Libstdc++ doesn't like incomplete classes for unique_ptr
+
+#include <memory>
+#include <vector>
+#include <string>
+
+#ifndef CATCH_CONFIG_CONSOLE_WIDTH
+#define CATCH_CONFIG_CONSOLE_WIDTH 80
+#endif
+
+namespace Catch {
+
+    struct IStream;
+
+    struct ConfigData {
+        bool listTests = false;
+        bool listTags = false;
+        bool listReporters = false;
+        bool listTestNamesOnly = false;
+
+        bool showSuccessfulTests = false;
+        bool shouldDebugBreak = false;
+        bool noThrow = false;
+        bool showHelp = false;
+        bool showInvisibles = false;
+        bool filenamesAsTags = false;
+        bool libIdentify = false;
+
+        int abortAfter = -1;
+        unsigned int rngSeed = 0;
+
+        bool benchmarkNoAnalysis = false;
+        unsigned int benchmarkSamples = 100;
+        double benchmarkConfidenceInterval = 0.95;
+        unsigned int benchmarkResamples = 100000;
+        std::chrono::milliseconds::rep benchmarkWarmupTime = 100;
+
+        Verbosity verbosity = Verbosity::Normal;
+        WarnAbout::What warnings = WarnAbout::Nothing;
+        ShowDurations::OrNot showDurations = ShowDurations::DefaultForReporter;
+        double minDuration = -1;
+        RunTests::InWhatOrder runOrder = RunTests::InDeclarationOrder;
+        UseColour::YesOrNo useColour = UseColour::Auto;
+        WaitForKeypress::When waitForKeypress = WaitForKeypress::Never;
+
+        std::string outputFilename;
+        std::string name;
+        std::string processName;
+#ifndef CATCH_CONFIG_DEFAULT_REPORTER
+#define CATCH_CONFIG_DEFAULT_REPORTER "console"
+#endif
+        std::string reporterName = CATCH_CONFIG_DEFAULT_REPORTER;
+#undef CATCH_CONFIG_DEFAULT_REPORTER
+
+        std::vector<std::string> testsOrTags;
+        std::vector<std::string> sectionsToRun;
+    };
+
+    class Config : public IConfig {
+    public:
+
+        Config() = default;
+        Config( ConfigData const& data );
+        virtual ~Config() = default;
+
+        std::string const& getFilename() const;
+
+        bool listTests() const;
+        bool listTestNamesOnly() const;
+        bool listTags() const;
+        bool listReporters() const;
+
+        std::string getProcessName() const;
+        std::string const& getReporterName() const;
+
+        std::vector<std::string> const& getTestsOrTags() const override;
+        std::vector<std::string> const& getSectionsToRun() const override;
+
+        TestSpec const& testSpec() const override;
+        bool hasTestFilters() const override;
+
+        bool showHelp() const;
+
+        // IConfig interface
+        bool allowThrows() const override;
+        std::ostream& stream() const override;
+        std::string name() const override;
+        bool includeSuccessfulResults() const override;
+        bool warnAboutMissingAssertions() const override;
+        bool warnAboutNoTests() const override;
+        ShowDurations::OrNot showDurations() const override;
+        double minDuration() const override;
+        RunTests::InWhatOrder runOrder() const override;
+        unsigned int rngSeed() const override;
+        UseColour::YesOrNo useColour() const override;
+        bool shouldDebugBreak() const override;
+        int abortAfter() const override;
+        bool showInvisibles() const override;
+        Verbosity verbosity() const override;
+        bool benchmarkNoAnalysis() const override;
+        int benchmarkSamples() const override;
+        double benchmarkConfidenceInterval() const override;
+        unsigned int benchmarkResamples() const override;
+        std::chrono::milliseconds benchmarkWarmupTime() const override;
+
+    private:
+
+        IStream const* openStream();
+        ConfigData m_data;
+
+        std::unique_ptr<IStream const> m_stream;
+        TestSpec m_testSpec;
+        bool m_hasTestFilters = false;
+    };
+
+} // end namespace Catch
+
+// end catch_config.hpp
+// start catch_assertionresult.h
+
+#include <string>
+
+namespace Catch {
+
+    struct AssertionResultData
+    {
+        AssertionResultData() = delete;
+
+        AssertionResultData( ResultWas::OfType _resultType, LazyExpression const& _lazyExpression );
+
+        std::string message;
+        mutable std::string reconstructedExpression;
+        LazyExpression lazyExpression;
+        ResultWas::OfType resultType;
+
+        std::string reconstructExpression() const;
+    };
+
+    class AssertionResult {
+    public:
+        AssertionResult() = delete;
+        AssertionResult( AssertionInfo const& info, AssertionResultData const& data );
+
+        bool isOk() const;
+        bool succeeded() const;
+        ResultWas::OfType getResultType() const;
+        bool hasExpression() const;
+        bool hasMessage() const;
+        std::string getExpression() const;
+        std::string getExpressionInMacro() const;
+        bool hasExpandedExpression() const;
+        std::string getExpandedExpression() const;
+        std::string getMessage() const;
+        SourceLineInfo getSourceInfo() const;
+        StringRef getTestMacroName() const;
+
+    //protected:
+        AssertionInfo m_info;
+        AssertionResultData m_resultData;
+    };
+
+} // end namespace Catch
+
+// end catch_assertionresult.h
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+// start catch_estimate.hpp
+
+ // Statistics estimates
+
+
+namespace Catch {
+    namespace Benchmark {
+        template <typename Duration>
+        struct Estimate {
+            Duration point;
+            Duration lower_bound;
+            Duration upper_bound;
+            double confidence_interval;
+
+            template <typename Duration2>
+            operator Estimate<Duration2>() const {
+                return { point, lower_bound, upper_bound, confidence_interval };
+            }
+        };
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_estimate.hpp
+// start catch_outlier_classification.hpp
+
+// Outlier information
+
+namespace Catch {
+    namespace Benchmark {
+        struct OutlierClassification {
+            int samples_seen = 0;
+            int low_severe = 0;     // more than 3 times IQR below Q1
+            int low_mild = 0;       // 1.5 to 3 times IQR below Q1
+            int high_mild = 0;      // 1.5 to 3 times IQR above Q3
+            int high_severe = 0;    // more than 3 times IQR above Q3
+
+            int total() const {
+                return low_severe + low_mild + high_mild + high_severe;
+            }
+        };
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_outlier_classification.hpp
+
+#include <iterator>
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+#include <string>
+#include <iosfwd>
+#include <map>
+#include <set>
+#include <memory>
+#include <algorithm>
+
+namespace Catch {
+
+    struct ReporterConfig {
+        explicit ReporterConfig( IConfigPtr const& _fullConfig );
+
+        ReporterConfig( IConfigPtr const& _fullConfig, std::ostream& _stream );
+
+        std::ostream& stream() const;
+        IConfigPtr fullConfig() const;
+
+    private:
+        std::ostream* m_stream;
+        IConfigPtr m_fullConfig;
+    };
+
+    struct ReporterPreferences {
+        bool shouldRedirectStdOut = false;
+        bool shouldReportAllAssertions = false;
+    };
+
+    template<typename T>
+    struct LazyStat : Option<T> {
+        LazyStat& operator=( T const& _value ) {
+            Option<T>::operator=( _value );
+            used = false;
+            return *this;
+        }
+        void reset() {
+            Option<T>::reset();
+            used = false;
+        }
+        bool used = false;
+    };
+
+    struct TestRunInfo {
+        TestRunInfo( std::string const& _name );
+        std::string name;
+    };
+    struct GroupInfo {
+        GroupInfo(  std::string const& _name,
+                    std::size_t _groupIndex,
+                    std::size_t _groupsCount );
+
+        std::string name;
+        std::size_t groupIndex;
+        std::size_t groupsCounts;
+    };
+
+    struct AssertionStats {
+        AssertionStats( AssertionResult const& _assertionResult,
+                        std::vector<MessageInfo> const& _infoMessages,
+                        Totals const& _totals );
+
+        AssertionStats( AssertionStats const& )              = default;
+        AssertionStats( AssertionStats && )                  = default;
+        AssertionStats& operator = ( AssertionStats const& ) = delete;
+        AssertionStats& operator = ( AssertionStats && )     = delete;
+        virtual ~AssertionStats();
+
+        AssertionResult assertionResult;
+        std::vector<MessageInfo> infoMessages;
+        Totals totals;
+    };
+
+    struct SectionStats {
+        SectionStats(   SectionInfo const& _sectionInfo,
+                        Counts const& _assertions,
+                        double _durationInSeconds,
+                        bool _missingAssertions );
+        SectionStats( SectionStats const& )              = default;
+        SectionStats( SectionStats && )                  = default;
+        SectionStats& operator = ( SectionStats const& ) = default;
+        SectionStats& operator = ( SectionStats && )     = default;
+        virtual ~SectionStats();
+
+        SectionInfo sectionInfo;
+        Counts assertions;
+        double durationInSeconds;
+        bool missingAssertions;
+    };
+
+    struct TestCaseStats {
+        TestCaseStats(  TestCaseInfo const& _testInfo,
+                        Totals const& _totals,
+                        std::string const& _stdOut,
+                        std::string const& _stdErr,
+                        bool _aborting );
+
+        TestCaseStats( TestCaseStats const& )              = default;
+        TestCaseStats( TestCaseStats && )                  = default;
+        TestCaseStats& operator = ( TestCaseStats const& ) = default;
+        TestCaseStats& operator = ( TestCaseStats && )     = default;
+        virtual ~TestCaseStats();
+
+        TestCaseInfo testInfo;
+        Totals totals;
+        std::string stdOut;
+        std::string stdErr;
+        bool aborting;
+    };
+
+    struct TestGroupStats {
+        TestGroupStats( GroupInfo const& _groupInfo,
+                        Totals const& _totals,
+                        bool _aborting );
+        TestGroupStats( GroupInfo const& _groupInfo );
+
+        TestGroupStats( TestGroupStats const& )              = default;
+        TestGroupStats( TestGroupStats && )                  = default;
+        TestGroupStats& operator = ( TestGroupStats const& ) = default;
+        TestGroupStats& operator = ( TestGroupStats && )     = default;
+        virtual ~TestGroupStats();
+
+        GroupInfo groupInfo;
+        Totals totals;
+        bool aborting;
+    };
+
+    struct TestRunStats {
+        TestRunStats(   TestRunInfo const& _runInfo,
+                        Totals const& _totals,
+                        bool _aborting );
+
+        TestRunStats( TestRunStats const& )              = default;
+        TestRunStats( TestRunStats && )                  = default;
+        TestRunStats& operator = ( TestRunStats const& ) = default;
+        TestRunStats& operator = ( TestRunStats && )     = default;
+        virtual ~TestRunStats();
+
+        TestRunInfo runInfo;
+        Totals totals;
+        bool aborting;
+    };
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+    struct BenchmarkInfo {
+        std::string name;
+        double estimatedDuration;
+        int iterations;
+        int samples;
+        unsigned int resamples;
+        double clockResolution;
+        double clockCost;
+    };
+
+    template <class Duration>
+    struct BenchmarkStats {
+        BenchmarkInfo info;
+
+        std::vector<Duration> samples;
+        Benchmark::Estimate<Duration> mean;
+        Benchmark::Estimate<Duration> standardDeviation;
+        Benchmark::OutlierClassification outliers;
+        double outlierVariance;
+
+        template <typename Duration2>
+        operator BenchmarkStats<Duration2>() const {
+            std::vector<Duration2> samples2;
+            samples2.reserve(samples.size());
+            std::transform(samples.begin(), samples.end(), std::back_inserter(samples2), [](Duration d) { return Duration2(d); });
+            return {
+                info,
+                std::move(samples2),
+                mean,
+                standardDeviation,
+                outliers,
+                outlierVariance,
+            };
+        }
+    };
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+    struct IStreamingReporter {
+        virtual ~IStreamingReporter() = default;
+
+        // Implementing class must also provide the following static methods:
+        // static std::string getDescription();
+        // static std::set<Verbosity> getSupportedVerbosities()
+
+        virtual ReporterPreferences getPreferences() const = 0;
+
+        virtual void noMatchingTestCases( std::string const& spec ) = 0;
+
+        virtual void reportInvalidArguments(std::string const&) {}
+
+        virtual void testRunStarting( TestRunInfo const& testRunInfo ) = 0;
+        virtual void testGroupStarting( GroupInfo const& groupInfo ) = 0;
+
+        virtual void testCaseStarting( TestCaseInfo const& testInfo ) = 0;
+        virtual void sectionStarting( SectionInfo const& sectionInfo ) = 0;
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+        virtual void benchmarkPreparing( std::string const& ) {}
+        virtual void benchmarkStarting( BenchmarkInfo const& ) {}
+        virtual void benchmarkEnded( BenchmarkStats<> const& ) {}
+        virtual void benchmarkFailed( std::string const& ) {}
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+        virtual void assertionStarting( AssertionInfo const& assertionInfo ) = 0;
+
+        // The return value indicates if the messages buffer should be cleared:
+        virtual bool assertionEnded( AssertionStats const& assertionStats ) = 0;
+
+        virtual void sectionEnded( SectionStats const& sectionStats ) = 0;
+        virtual void testCaseEnded( TestCaseStats const& testCaseStats ) = 0;
+        virtual void testGroupEnded( TestGroupStats const& testGroupStats ) = 0;
+        virtual void testRunEnded( TestRunStats const& testRunStats ) = 0;
+
+        virtual void skipTest( TestCaseInfo const& testInfo ) = 0;
+
+        // Default empty implementation provided
+        virtual void fatalErrorEncountered( StringRef name );
+
+        virtual bool isMulti() const;
+    };
+    using IStreamingReporterPtr = std::unique_ptr<IStreamingReporter>;
+
+    struct IReporterFactory {
+        virtual ~IReporterFactory();
+        virtual IStreamingReporterPtr create( ReporterConfig const& config ) const = 0;
+        virtual std::string getDescription() const = 0;
+    };
+    using IReporterFactoryPtr = std::shared_ptr<IReporterFactory>;
+
+    struct IReporterRegistry {
+        using FactoryMap = std::map<std::string, IReporterFactoryPtr>;
+        using Listeners = std::vector<IReporterFactoryPtr>;
+
+        virtual ~IReporterRegistry();
+        virtual IStreamingReporterPtr create( std::string const& name, IConfigPtr const& config ) const = 0;
+        virtual FactoryMap const& getFactories() const = 0;
+        virtual Listeners const& getListeners() const = 0;
+    };
+
+} // end namespace Catch
+
+// end catch_interfaces_reporter.h
+#include <algorithm>
+#include <cstring>
+#include <cfloat>
+#include <cstdio>
+#include <cassert>
+#include <memory>
+#include <ostream>
+
+namespace Catch {
+    void prepareExpandedExpression(AssertionResult& result);
+
+    // Returns double formatted as %.3f (format expected on output)
+    std::string getFormattedDuration( double duration );
+
+    //! Should the reporter show
+    bool shouldShowDuration( IConfig const& config, double duration );
+
+    std::string serializeFilters( std::vector<std::string> const& container );
+
+    template<typename DerivedT>
+    struct StreamingReporterBase : IStreamingReporter {
+
+        StreamingReporterBase( ReporterConfig const& _config )
+        :   m_config( _config.fullConfig() ),
+            stream( _config.stream() )
+        {
+            m_reporterPrefs.shouldRedirectStdOut = false;
+            if( !DerivedT::getSupportedVerbosities().count( m_config->verbosity() ) )
+                CATCH_ERROR( "Verbosity level not supported by this reporter" );
+        }
+
+        ReporterPreferences getPreferences() const override {
+            return m_reporterPrefs;
+        }
+
+        static std::set<Verbosity> getSupportedVerbosities() {
+            return { Verbosity::Normal };
+        }
+
+        ~StreamingReporterBase() override = default;
+
+        void noMatchingTestCases(std::string const&) override {}
+
+        void reportInvalidArguments(std::string const&) override {}
+
+        void testRunStarting(TestRunInfo const& _testRunInfo) override {
+            currentTestRunInfo = _testRunInfo;
+        }
+
+        void testGroupStarting(GroupInfo const& _groupInfo) override {
+            currentGroupInfo = _groupInfo;
+        }
+
+        void testCaseStarting(TestCaseInfo const& _testInfo) override  {
+            currentTestCaseInfo = _testInfo;
+        }
+        void sectionStarting(SectionInfo const& _sectionInfo) override {
+            m_sectionStack.push_back(_sectionInfo);
+        }
+
+        void sectionEnded(SectionStats const& /* _sectionStats */) override {
+            m_sectionStack.pop_back();
+        }
+        void testCaseEnded(TestCaseStats const& /* _testCaseStats */) override {
+            currentTestCaseInfo.reset();
+        }
+        void testGroupEnded(TestGroupStats const& /* _testGroupStats */) override {
+            currentGroupInfo.reset();
+        }
+        void testRunEnded(TestRunStats const& /* _testRunStats */) override {
+            currentTestCaseInfo.reset();
+            currentGroupInfo.reset();
+            currentTestRunInfo.reset();
+        }
+
+        void skipTest(TestCaseInfo const&) override {
+            // Don't do anything with this by default.
+            // It can optionally be overridden in the derived class.
+        }
+
+        IConfigPtr m_config;
+        std::ostream& stream;
+
+        LazyStat<TestRunInfo> currentTestRunInfo;
+        LazyStat<GroupInfo> currentGroupInfo;
+        LazyStat<TestCaseInfo> currentTestCaseInfo;
+
+        std::vector<SectionInfo> m_sectionStack;
+        ReporterPreferences m_reporterPrefs;
+    };
+
+    template<typename DerivedT>
+    struct CumulativeReporterBase : IStreamingReporter {
+        template<typename T, typename ChildNodeT>
+        struct Node {
+            explicit Node( T const& _value ) : value( _value ) {}
+            virtual ~Node() {}
+
+            using ChildNodes = std::vector<std::shared_ptr<ChildNodeT>>;
+            T value;
+            ChildNodes children;
+        };
+        struct SectionNode {
+            explicit SectionNode(SectionStats const& _stats) : stats(_stats) {}
+            virtual ~SectionNode() = default;
+
+            bool operator == (SectionNode const& other) const {
+                return stats.sectionInfo.lineInfo == other.stats.sectionInfo.lineInfo;
+            }
+            bool operator == (std::shared_ptr<SectionNode> const& other) const {
+                return operator==(*other);
+            }
+
+            SectionStats stats;
+            using ChildSections = std::vector<std::shared_ptr<SectionNode>>;
+            using Assertions = std::vector<AssertionStats>;
+            ChildSections childSections;
+            Assertions assertions;
+            std::string stdOut;
+            std::string stdErr;
+        };
+
+        struct BySectionInfo {
+            BySectionInfo( SectionInfo const& other ) : m_other( other ) {}
+            BySectionInfo( BySectionInfo const& other ) : m_other( other.m_other ) {}
+            bool operator() (std::shared_ptr<SectionNode> const& node) const {
+                return ((node->stats.sectionInfo.name == m_other.name) &&
+                        (node->stats.sectionInfo.lineInfo == m_other.lineInfo));
+            }
+            void operator=(BySectionInfo const&) = delete;
+
+        private:
+            SectionInfo const& m_other;
+        };
+
+        using TestCaseNode = Node<TestCaseStats, SectionNode>;
+        using TestGroupNode = Node<TestGroupStats, TestCaseNode>;
+        using TestRunNode = Node<TestRunStats, TestGroupNode>;
+
+        CumulativeReporterBase( ReporterConfig const& _config )
+        :   m_config( _config.fullConfig() ),
+            stream( _config.stream() )
+        {
+            m_reporterPrefs.shouldRedirectStdOut = false;
+            if( !DerivedT::getSupportedVerbosities().count( m_config->verbosity() ) )
+                CATCH_ERROR( "Verbosity level not supported by this reporter" );
+        }
+        ~CumulativeReporterBase() override = default;
+
+        ReporterPreferences getPreferences() const override {
+            return m_reporterPrefs;
+        }
+
+        static std::set<Verbosity> getSupportedVerbosities() {
+            return { Verbosity::Normal };
+        }
+
+        void testRunStarting( TestRunInfo const& ) override {}
+        void testGroupStarting( GroupInfo const& ) override {}
+
+        void testCaseStarting( TestCaseInfo const& ) override {}
+
+        void sectionStarting( SectionInfo const& sectionInfo ) override {
+            SectionStats incompleteStats( sectionInfo, Counts(), 0, false );
+            std::shared_ptr<SectionNode> node;
+            if( m_sectionStack.empty() ) {
+                if( !m_rootSection )
+                    m_rootSection = std::make_shared<SectionNode>( incompleteStats );
+                node = m_rootSection;
+            }
+            else {
+                SectionNode& parentNode = *m_sectionStack.back();
+                auto it =
+                    std::find_if(   parentNode.childSections.begin(),
+                                    parentNode.childSections.end(),
+                                    BySectionInfo( sectionInfo ) );
+                if( it == parentNode.childSections.end() ) {
+                    node = std::make_shared<SectionNode>( incompleteStats );
+                    parentNode.childSections.push_back( node );
+                }
+                else
+                    node = *it;
+            }
+            m_sectionStack.push_back( node );
+            m_deepestSection = std::move(node);
+        }
+
+        void assertionStarting(AssertionInfo const&) override {}
+
+        bool assertionEnded(AssertionStats const& assertionStats) override {
+            assert(!m_sectionStack.empty());
+            // AssertionResult holds a pointer to a temporary DecomposedExpression,
+            // which getExpandedExpression() calls to build the expression string.
+            // Our section stack copy of the assertionResult will likely outlive the
+            // temporary, so it must be expanded or discarded now to avoid calling
+            // a destroyed object later.
+            prepareExpandedExpression(const_cast<AssertionResult&>( assertionStats.assertionResult ) );
+            SectionNode& sectionNode = *m_sectionStack.back();
+            sectionNode.assertions.push_back(assertionStats);
+            return true;
+        }
+        void sectionEnded(SectionStats const& sectionStats) override {
+            assert(!m_sectionStack.empty());
+            SectionNode& node = *m_sectionStack.back();
+            node.stats = sectionStats;
+            m_sectionStack.pop_back();
+        }
+        void testCaseEnded(TestCaseStats const& testCaseStats) override {
+            auto node = std::make_shared<TestCaseNode>(testCaseStats);
+            assert(m_sectionStack.size() == 0);
+            node->children.push_back(m_rootSection);
+            m_testCases.push_back(node);
+            m_rootSection.reset();
+
+            assert(m_deepestSection);
+            m_deepestSection->stdOut = testCaseStats.stdOut;
+            m_deepestSection->stdErr = testCaseStats.stdErr;
+        }
+        void testGroupEnded(TestGroupStats const& testGroupStats) override {
+            auto node = std::make_shared<TestGroupNode>(testGroupStats);
+            node->children.swap(m_testCases);
+            m_testGroups.push_back(node);
+        }
+        void testRunEnded(TestRunStats const& testRunStats) override {
+            auto node = std::make_shared<TestRunNode>(testRunStats);
+            node->children.swap(m_testGroups);
+            m_testRuns.push_back(node);
+            testRunEndedCumulative();
+        }
+        virtual void testRunEndedCumulative() = 0;
+
+        void skipTest(TestCaseInfo const&) override {}
+
+        IConfigPtr m_config;
+        std::ostream& stream;
+        std::vector<AssertionStats> m_assertions;
+        std::vector<std::vector<std::shared_ptr<SectionNode>>> m_sections;
+        std::vector<std::shared_ptr<TestCaseNode>> m_testCases;
+        std::vector<std::shared_ptr<TestGroupNode>> m_testGroups;
+
+        std::vector<std::shared_ptr<TestRunNode>> m_testRuns;
+
+        std::shared_ptr<SectionNode> m_rootSection;
+        std::shared_ptr<SectionNode> m_deepestSection;
+        std::vector<std::shared_ptr<SectionNode>> m_sectionStack;
+        ReporterPreferences m_reporterPrefs;
+    };
+
+    template<char C>
+    char const* getLineOfChars() {
+        static char line[CATCH_CONFIG_CONSOLE_WIDTH] = {0};
+        if( !*line ) {
+            std::memset( line, C, CATCH_CONFIG_CONSOLE_WIDTH-1 );
+            line[CATCH_CONFIG_CONSOLE_WIDTH-1] = 0;
+        }
+        return line;
+    }
+
+    struct TestEventListenerBase : StreamingReporterBase<TestEventListenerBase> {
+        TestEventListenerBase( ReporterConfig const& _config );
+
+        static std::set<Verbosity> getSupportedVerbosities();
+
+        void assertionStarting(AssertionInfo const&) override;
+        bool assertionEnded(AssertionStats const&) override;
+    };
+
+} // end namespace Catch
+
+// end catch_reporter_bases.hpp
+// start catch_console_colour.h
+
+namespace Catch {
+
+    struct Colour {
+        enum Code {
+            None = 0,
+
+            White,
+            Red,
+            Green,
+            Blue,
+            Cyan,
+            Yellow,
+            Grey,
+
+            Bright = 0x10,
+
+            BrightRed = Bright | Red,
+            BrightGreen = Bright | Green,
+            LightGrey = Bright | Grey,
+            BrightWhite = Bright | White,
+            BrightYellow = Bright | Yellow,
+
+            // By intention
+            FileName = LightGrey,
+            Warning = BrightYellow,
+            ResultError = BrightRed,
+            ResultSuccess = BrightGreen,
+            ResultExpectedFailure = Warning,
+
+            Error = BrightRed,
+            Success = Green,
+
+            OriginalExpression = Cyan,
+            ReconstructedExpression = BrightYellow,
+
+            SecondaryText = LightGrey,
+            Headers = White
+        };
+
+        // Use constructed object for RAII guard
+        Colour( Code _colourCode );
+        Colour( Colour&& other ) noexcept;
+        Colour& operator=( Colour&& other ) noexcept;
+        ~Colour();
+
+        // Use static method for one-shot changes
+        static void use( Code _colourCode );
+
+    private:
+        bool m_moved = false;
+    };
+
+    std::ostream& operator << ( std::ostream& os, Colour const& );
+
+} // end namespace Catch
+
+// end catch_console_colour.h
+// start catch_reporter_registrars.hpp
+
+
+namespace Catch {
+
+    template<typename T>
+    class ReporterRegistrar {
+
+        class ReporterFactory : public IReporterFactory {
+
+            IStreamingReporterPtr create( ReporterConfig const& config ) const override {
+                return std::unique_ptr<T>( new T( config ) );
+            }
+
+            std::string getDescription() const override {
+                return T::getDescription();
+            }
+        };
+
+    public:
+
+        explicit ReporterRegistrar( std::string const& name ) {
+            getMutableRegistryHub().registerReporter( name, std::make_shared<ReporterFactory>() );
+        }
+    };
+
+    template<typename T>
+    class ListenerRegistrar {
+
+        class ListenerFactory : public IReporterFactory {
+
+            IStreamingReporterPtr create( ReporterConfig const& config ) const override {
+                return std::unique_ptr<T>( new T( config ) );
+            }
+            std::string getDescription() const override {
+                return std::string();
+            }
+        };
+
+    public:
+
+        ListenerRegistrar() {
+            getMutableRegistryHub().registerListener( std::make_shared<ListenerFactory>() );
+        }
+    };
+}
+
+#if !defined(CATCH_CONFIG_DISABLE)
+
+#define CATCH_REGISTER_REPORTER( name, reporterType ) \
+    CATCH_INTERNAL_START_WARNINGS_SUPPRESSION         \
+    CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS          \
+    namespace{ Catch::ReporterRegistrar<reporterType> catch_internal_RegistrarFor##reporterType( name ); } \
+    CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
+
+#define CATCH_REGISTER_LISTENER( listenerType ) \
+    CATCH_INTERNAL_START_WARNINGS_SUPPRESSION   \
+    CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS    \
+    namespace{ Catch::ListenerRegistrar<listenerType> catch_internal_RegistrarFor##listenerType; } \
+    CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
+#else // CATCH_CONFIG_DISABLE
+
+#define CATCH_REGISTER_REPORTER(name, reporterType)
+#define CATCH_REGISTER_LISTENER(listenerType)
+
+#endif // CATCH_CONFIG_DISABLE
+
+// end catch_reporter_registrars.hpp
+// Allow users to base their work off existing reporters
+// start catch_reporter_compact.h
+
+namespace Catch {
+
+    struct CompactReporter : StreamingReporterBase<CompactReporter> {
+
+        using StreamingReporterBase::StreamingReporterBase;
+
+        ~CompactReporter() override;
+
+        static std::string getDescription();
+
+        void noMatchingTestCases(std::string const& spec) override;
+
+        void assertionStarting(AssertionInfo const&) override;
+
+        bool assertionEnded(AssertionStats const& _assertionStats) override;
+
+        void sectionEnded(SectionStats const& _sectionStats) override;
+
+        void testRunEnded(TestRunStats const& _testRunStats) override;
+
+    };
+
+} // end namespace Catch
+
+// end catch_reporter_compact.h
+// start catch_reporter_console.h
+
+#if defined(_MSC_VER)
+#pragma warning(push)
+#pragma warning(disable:4061) // Not all labels are EXPLICITLY handled in switch
+                              // Note that 4062 (not all labels are handled
+                              // and default is missing) is enabled
+#endif
+
+namespace Catch {
+    // Fwd decls
+    struct SummaryColumn;
+    class TablePrinter;
+
+    struct ConsoleReporter : StreamingReporterBase<ConsoleReporter> {
+        std::unique_ptr<TablePrinter> m_tablePrinter;
+
+        ConsoleReporter(ReporterConfig const& config);
+        ~ConsoleReporter() override;
+        static std::string getDescription();
+
+        void noMatchingTestCases(std::string const& spec) override;
+
+        void reportInvalidArguments(std::string const&arg) override;
+
+        void assertionStarting(AssertionInfo const&) override;
+
+        bool assertionEnded(AssertionStats const& _assertionStats) override;
+
+        void sectionStarting(SectionInfo const& _sectionInfo) override;
+        void sectionEnded(SectionStats const& _sectionStats) override;
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+        void benchmarkPreparing(std::string const& name) override;
+        void benchmarkStarting(BenchmarkInfo const& info) override;
+        void benchmarkEnded(BenchmarkStats<> const& stats) override;
+        void benchmarkFailed(std::string const& error) override;
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+        void testCaseEnded(TestCaseStats const& _testCaseStats) override;
+        void testGroupEnded(TestGroupStats const& _testGroupStats) override;
+        void testRunEnded(TestRunStats const& _testRunStats) override;
+        void testRunStarting(TestRunInfo const& _testRunInfo) override;
+    private:
+
+        void lazyPrint();
+
+        void lazyPrintWithoutClosingBenchmarkTable();
+        void lazyPrintRunInfo();
+        void lazyPrintGroupInfo();
+        void printTestCaseAndSectionHeader();
+
+        void printClosedHeader(std::string const& _name);
+        void printOpenHeader(std::string const& _name);
+
+        // if string has a : in first line will set indent to follow it on
+        // subsequent lines
+        void printHeaderString(std::string const& _string, std::size_t indent = 0);
+
+        void printTotals(Totals const& totals);
+        void printSummaryRow(std::string const& label, std::vector<SummaryColumn> const& cols, std::size_t row);
+
+        void printTotalsDivider(Totals const& totals);
+        void printSummaryDivider();
+        void printTestFilters();
+
+    private:
+        bool m_headerPrinted = false;
+    };
+
+} // end namespace Catch
+
+#if defined(_MSC_VER)
+#pragma warning(pop)
+#endif
+
+// end catch_reporter_console.h
+// start catch_reporter_junit.h
+
+// start catch_xmlwriter.h
+
+#include <vector>
+
+namespace Catch {
+    enum class XmlFormatting {
+        None = 0x00,
+        Indent = 0x01,
+        Newline = 0x02,
+    };
+
+    XmlFormatting operator | (XmlFormatting lhs, XmlFormatting rhs);
+    XmlFormatting operator & (XmlFormatting lhs, XmlFormatting rhs);
+
+    class XmlEncode {
+    public:
+        enum ForWhat { ForTextNodes, ForAttributes };
+
+        XmlEncode( std::string const& str, ForWhat forWhat = ForTextNodes );
+
+        void encodeTo( std::ostream& os ) const;
+
+        friend std::ostream& operator << ( std::ostream& os, XmlEncode const& xmlEncode );
+
+    private:
+        std::string m_str;
+        ForWhat m_forWhat;
+    };
+
+    class XmlWriter {
+    public:
+
+        class ScopedElement {
+        public:
+            ScopedElement( XmlWriter* writer, XmlFormatting fmt );
+
+            ScopedElement( ScopedElement&& other ) noexcept;
+            ScopedElement& operator=( ScopedElement&& other ) noexcept;
+
+            ~ScopedElement();
+
+            ScopedElement& writeText( std::string const& text, XmlFormatting fmt = XmlFormatting::Newline | XmlFormatting::Indent );
+
+            template<typename T>
+            ScopedElement& writeAttribute( std::string const& name, T const& attribute ) {
+                m_writer->writeAttribute( name, attribute );
+                return *this;
+            }
+
+        private:
+            mutable XmlWriter* m_writer = nullptr;
+            XmlFormatting m_fmt;
+        };
+
+        XmlWriter( std::ostream& os = Catch::cout() );
+        ~XmlWriter();
+
+        XmlWriter( XmlWriter const& ) = delete;
+        XmlWriter& operator=( XmlWriter const& ) = delete;
+
+        XmlWriter& startElement( std::string const& name, XmlFormatting fmt = XmlFormatting::Newline | XmlFormatting::Indent);
+
+        ScopedElement scopedElement( std::string const& name, XmlFormatting fmt = XmlFormatting::Newline | XmlFormatting::Indent);
+
+        XmlWriter& endElement(XmlFormatting fmt = XmlFormatting::Newline | XmlFormatting::Indent);
+
+        XmlWriter& writeAttribute( std::string const& name, std::string const& attribute );
+
+        XmlWriter& writeAttribute( std::string const& name, bool attribute );
+
+        template<typename T>
+        XmlWriter& writeAttribute( std::string const& name, T const& attribute ) {
+            ReusableStringStream rss;
+            rss << attribute;
+            return writeAttribute( name, rss.str() );
+        }
+
+        XmlWriter& writeText( std::string const& text, XmlFormatting fmt = XmlFormatting::Newline | XmlFormatting::Indent);
+
+        XmlWriter& writeComment(std::string const& text, XmlFormatting fmt = XmlFormatting::Newline | XmlFormatting::Indent);
+
+        void writeStylesheetRef( std::string const& url );
+
+        XmlWriter& writeBlankLine();
+
+        void ensureTagClosed();
+
+    private:
+
+        void applyFormatting(XmlFormatting fmt);
+
+        void writeDeclaration();
+
+        void newlineIfNecessary();
+
+        bool m_tagIsOpen = false;
+        bool m_needsNewline = false;
+        std::vector<std::string> m_tags;
+        std::string m_indent;
+        std::ostream& m_os;
+    };
+
+}
+
+// end catch_xmlwriter.h
+namespace Catch {
+
+    class JunitReporter : public CumulativeReporterBase<JunitReporter> {
+    public:
+        JunitReporter(ReporterConfig const& _config);
+
+        ~JunitReporter() override;
+
+        static std::string getDescription();
+
+        void noMatchingTestCases(std::string const& /*spec*/) override;
+
+        void testRunStarting(TestRunInfo const& runInfo) override;
+
+        void testGroupStarting(GroupInfo const& groupInfo) override;
+
+        void testCaseStarting(TestCaseInfo const& testCaseInfo) override;
+        bool assertionEnded(AssertionStats const& assertionStats) override;
+
+        void testCaseEnded(TestCaseStats const& testCaseStats) override;
+
+        void testGroupEnded(TestGroupStats const& testGroupStats) override;
+
+        void testRunEndedCumulative() override;
+
+        void writeGroup(TestGroupNode const& groupNode, double suiteTime);
+
+        void writeTestCase(TestCaseNode const& testCaseNode);
+
+        void writeSection( std::string const& className,
+                           std::string const& rootName,
+                           SectionNode const& sectionNode,
+                           bool testOkToFail );
+
+        void writeAssertions(SectionNode const& sectionNode);
+        void writeAssertion(AssertionStats const& stats);
+
+        XmlWriter xml;
+        Timer suiteTimer;
+        std::string stdOutForSuite;
+        std::string stdErrForSuite;
+        unsigned int unexpectedExceptions = 0;
+        bool m_okToFail = false;
+    };
+
+} // end namespace Catch
+
+// end catch_reporter_junit.h
+// start catch_reporter_xml.h
+
+namespace Catch {
+    class XmlReporter : public StreamingReporterBase<XmlReporter> {
+    public:
+        XmlReporter(ReporterConfig const& _config);
+
+        ~XmlReporter() override;
+
+        static std::string getDescription();
+
+        virtual std::string getStylesheetRef() const;
+
+        void writeSourceInfo(SourceLineInfo const& sourceInfo);
+
+    public: // StreamingReporterBase
+
+        void noMatchingTestCases(std::string const& s) override;
+
+        void testRunStarting(TestRunInfo const& testInfo) override;
+
+        void testGroupStarting(GroupInfo const& groupInfo) override;
+
+        void testCaseStarting(TestCaseInfo const& testInfo) override;
+
+        void sectionStarting(SectionInfo const& sectionInfo) override;
+
+        void assertionStarting(AssertionInfo const&) override;
+
+        bool assertionEnded(AssertionStats const& assertionStats) override;
+
+        void sectionEnded(SectionStats const& sectionStats) override;
+
+        void testCaseEnded(TestCaseStats const& testCaseStats) override;
+
+        void testGroupEnded(TestGroupStats const& testGroupStats) override;
+
+        void testRunEnded(TestRunStats const& testRunStats) override;
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+        void benchmarkPreparing(std::string const& name) override;
+        void benchmarkStarting(BenchmarkInfo const&) override;
+        void benchmarkEnded(BenchmarkStats<> const&) override;
+        void benchmarkFailed(std::string const&) override;
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+    private:
+        Timer m_testCaseTimer;
+        XmlWriter m_xml;
+        int m_sectionDepth = 0;
+    };
+
+} // end namespace Catch
+
+// end catch_reporter_xml.h
+
+// end catch_external_interfaces.h
+#endif
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+// start catch_benchmarking_all.hpp
+
+// A proxy header that includes all of the benchmarking headers to allow
+// concise include of the benchmarking features. You should prefer the
+// individual includes in standard use.
+
+// start catch_benchmark.hpp
+
+ // Benchmark
+
+// start catch_chronometer.hpp
+
+// User-facing chronometer
+
+
+// start catch_clock.hpp
+
+// Clocks
+
+
+#include <chrono>
+#include <ratio>
+
+namespace Catch {
+    namespace Benchmark {
+        template <typename Clock>
+        using ClockDuration = typename Clock::duration;
+        template <typename Clock>
+        using FloatDuration = std::chrono::duration<double, typename Clock::period>;
+
+        template <typename Clock>
+        using TimePoint = typename Clock::time_point;
+
+        using default_clock = std::chrono::steady_clock;
+
+        template <typename Clock>
+        struct now {
+            TimePoint<Clock> operator()() const {
+                return Clock::now();
+            }
+        };
+
+        using fp_seconds = std::chrono::duration<double, std::ratio<1>>;
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_clock.hpp
+// start catch_optimizer.hpp
+
+ // Hinting the optimizer
+
+
+#if defined(_MSC_VER)
+#   include <atomic> // atomic_thread_fence
+#endif
+
+namespace Catch {
+    namespace Benchmark {
+#if defined(__GNUC__) || defined(__clang__)
+        template <typename T>
+        inline void keep_memory(T* p) {
+            asm volatile("" : : "g"(p) : "memory");
+        }
+        inline void keep_memory() {
+            asm volatile("" : : : "memory");
+        }
+
+        namespace Detail {
+            inline void optimizer_barrier() { keep_memory(); }
+        } // namespace Detail
+#elif defined(_MSC_VER)
+
+#pragma optimize("", off)
+        template <typename T>
+        inline void keep_memory(T* p) {
+            // thanks @milleniumbug
+            *reinterpret_cast<char volatile*>(p) = *reinterpret_cast<char const volatile*>(p);
+        }
+        // TODO equivalent keep_memory()
+#pragma optimize("", on)
+
+        namespace Detail {
+            inline void optimizer_barrier() {
+                std::atomic_thread_fence(std::memory_order_seq_cst);
+            }
+        } // namespace Detail
+
+#endif
+
+        template <typename T>
+        inline void deoptimize_value(T&& x) {
+            keep_memory(&x);
+        }
+
+        template <typename Fn, typename... Args>
+        inline auto invoke_deoptimized(Fn&& fn, Args&&... args) -> typename std::enable_if<!std::is_same<void, decltype(fn(args...))>::value>::type {
+            deoptimize_value(std::forward<Fn>(fn) (std::forward<Args...>(args...)));
+        }
+
+        template <typename Fn, typename... Args>
+        inline auto invoke_deoptimized(Fn&& fn, Args&&... args) -> typename std::enable_if<std::is_same<void, decltype(fn(args...))>::value>::type {
+            std::forward<Fn>(fn) (std::forward<Args...>(args...));
+        }
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_optimizer.hpp
+// start catch_complete_invoke.hpp
+
+// Invoke with a special case for void
+
+
+#include <type_traits>
+#include <utility>
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            template <typename T>
+            struct CompleteType { using type = T; };
+            template <>
+            struct CompleteType<void> { struct type {}; };
+
+            template <typename T>
+            using CompleteType_t = typename CompleteType<T>::type;
+
+            template <typename Result>
+            struct CompleteInvoker {
+                template <typename Fun, typename... Args>
+                static Result invoke(Fun&& fun, Args&&... args) {
+                    return std::forward<Fun>(fun)(std::forward<Args>(args)...);
+                }
+            };
+            template <>
+            struct CompleteInvoker<void> {
+                template <typename Fun, typename... Args>
+                static CompleteType_t<void> invoke(Fun&& fun, Args&&... args) {
+                    std::forward<Fun>(fun)(std::forward<Args>(args)...);
+                    return {};
+                }
+            };
+
+            // invoke and not return void :(
+            template <typename Fun, typename... Args>
+            CompleteType_t<FunctionReturnType<Fun, Args...>> complete_invoke(Fun&& fun, Args&&... args) {
+                return CompleteInvoker<FunctionReturnType<Fun, Args...>>::invoke(std::forward<Fun>(fun), std::forward<Args>(args)...);
+            }
+
+            const std::string benchmarkErrorMsg = "a benchmark failed to run successfully";
+        } // namespace Detail
+
+        template <typename Fun>
+        Detail::CompleteType_t<FunctionReturnType<Fun>> user_code(Fun&& fun) {
+            CATCH_TRY{
+                return Detail::complete_invoke(std::forward<Fun>(fun));
+            } CATCH_CATCH_ALL{
+                getResultCapture().benchmarkFailed(translateActiveException());
+                CATCH_RUNTIME_ERROR(Detail::benchmarkErrorMsg);
+            }
+        }
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_complete_invoke.hpp
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            struct ChronometerConcept {
+                virtual void start() = 0;
+                virtual void finish() = 0;
+                virtual ~ChronometerConcept() = default;
+            };
+            template <typename Clock>
+            struct ChronometerModel final : public ChronometerConcept {
+                void start() override { started = Clock::now(); }
+                void finish() override { finished = Clock::now(); }
+
+                ClockDuration<Clock> elapsed() const { return finished - started; }
+
+                TimePoint<Clock> started;
+                TimePoint<Clock> finished;
+            };
+        } // namespace Detail
+
+        struct Chronometer {
+        public:
+            template <typename Fun>
+            void measure(Fun&& fun) { measure(std::forward<Fun>(fun), is_callable<Fun(int)>()); }
+
+            int runs() const { return k; }
+
+            Chronometer(Detail::ChronometerConcept& meter, int k)
+                : impl(&meter)
+                , k(k) {}
+
+        private:
+            template <typename Fun>
+            void measure(Fun&& fun, std::false_type) {
+                measure([&fun](int) { return fun(); }, std::true_type());
+            }
+
+            template <typename Fun>
+            void measure(Fun&& fun, std::true_type) {
+                Detail::optimizer_barrier();
+                impl->start();
+                for (int i = 0; i < k; ++i) invoke_deoptimized(fun, i);
+                impl->finish();
+                Detail::optimizer_barrier();
+            }
+
+            Detail::ChronometerConcept* impl;
+            int k;
+        };
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_chronometer.hpp
+// start catch_environment.hpp
+
+// Environment information
+
+
+namespace Catch {
+    namespace Benchmark {
+        template <typename Duration>
+        struct EnvironmentEstimate {
+            Duration mean;
+            OutlierClassification outliers;
+
+            template <typename Duration2>
+            operator EnvironmentEstimate<Duration2>() const {
+                return { mean, outliers };
+            }
+        };
+        template <typename Clock>
+        struct Environment {
+            using clock_type = Clock;
+            EnvironmentEstimate<FloatDuration<Clock>> clock_resolution;
+            EnvironmentEstimate<FloatDuration<Clock>> clock_cost;
+        };
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_environment.hpp
+// start catch_execution_plan.hpp
+
+ // Execution plan
+
+
+// start catch_benchmark_function.hpp
+
+ // Dumb std::function implementation for consistent call overhead
+
+
+#include <cassert>
+#include <type_traits>
+#include <utility>
+#include <memory>
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            template <typename T>
+            using Decay = typename std::decay<T>::type;
+            template <typename T, typename U>
+            struct is_related
+                : std::is_same<Decay<T>, Decay<U>> {};
+
+            /// We need to reinvent std::function because every piece of code that might add overhead
+            /// in a measurement context needs to have consistent performance characteristics so that we
+            /// can account for it in the measurement.
+            /// Implementations of std::function with optimizations that aren't always applicable, like
+            /// small buffer optimizations, are not uncommon.
+            /// This is effectively an implementation of std::function without any such optimizations;
+            /// it may be slow, but it is consistently slow.
+            struct BenchmarkFunction {
+            private:
+                struct callable {
+                    virtual void call(Chronometer meter) const = 0;
+                    virtual callable* clone() const = 0;
+                    virtual ~callable() = default;
+                };
+                template <typename Fun>
+                struct model : public callable {
+                    model(Fun&& fun) : fun(std::move(fun)) {}
+                    model(Fun const& fun) : fun(fun) {}
+
+                    model<Fun>* clone() const override { return new model<Fun>(*this); }
+
+                    void call(Chronometer meter) const override {
+                        call(meter, is_callable<Fun(Chronometer)>());
+                    }
+                    void call(Chronometer meter, std::true_type) const {
+                        fun(meter);
+                    }
+                    void call(Chronometer meter, std::false_type) const {
+                        meter.measure(fun);
+                    }
+
+                    Fun fun;
+                };
+
+                struct do_nothing { void operator()() const {} };
+
+                template <typename T>
+                BenchmarkFunction(model<T>* c) : f(c) {}
+
+            public:
+                BenchmarkFunction()
+                    : f(new model<do_nothing>{ {} }) {}
+
+                template <typename Fun,
+                    typename std::enable_if<!is_related<Fun, BenchmarkFunction>::value, int>::type = 0>
+                    BenchmarkFunction(Fun&& fun)
+                    : f(new model<typename std::decay<Fun>::type>(std::forward<Fun>(fun))) {}
+
+                BenchmarkFunction(BenchmarkFunction&& that)
+                    : f(std::move(that.f)) {}
+
+                BenchmarkFunction(BenchmarkFunction const& that)
+                    : f(that.f->clone()) {}
+
+                BenchmarkFunction& operator=(BenchmarkFunction&& that) {
+                    f = std::move(that.f);
+                    return *this;
+                }
+
+                BenchmarkFunction& operator=(BenchmarkFunction const& that) {
+                    f.reset(that.f->clone());
+                    return *this;
+                }
+
+                void operator()(Chronometer meter) const { f->call(meter); }
+
+            private:
+                std::unique_ptr<callable> f;
+            };
+        } // namespace Detail
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_benchmark_function.hpp
+// start catch_repeat.hpp
+
+// repeat algorithm
+
+
+#include <type_traits>
+#include <utility>
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            template <typename Fun>
+            struct repeater {
+                void operator()(int k) const {
+                    for (int i = 0; i < k; ++i) {
+                        fun();
+                    }
+                }
+                Fun fun;
+            };
+            template <typename Fun>
+            repeater<typename std::decay<Fun>::type> repeat(Fun&& fun) {
+                return { std::forward<Fun>(fun) };
+            }
+        } // namespace Detail
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_repeat.hpp
+// start catch_run_for_at_least.hpp
+
+// Run a function for a minimum amount of time
+
+
+// start catch_measure.hpp
+
+// Measure
+
+
+// start catch_timing.hpp
+
+// Timing
+
+
+#include <tuple>
+#include <type_traits>
+
+namespace Catch {
+    namespace Benchmark {
+        template <typename Duration, typename Result>
+        struct Timing {
+            Duration elapsed;
+            Result result;
+            int iterations;
+        };
+        template <typename Clock, typename Func, typename... Args>
+        using TimingOf = Timing<ClockDuration<Clock>, Detail::CompleteType_t<FunctionReturnType<Func, Args...>>>;
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_timing.hpp
+#include <utility>
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            template <typename Clock, typename Fun, typename... Args>
+            TimingOf<Clock, Fun, Args...> measure(Fun&& fun, Args&&... args) {
+                auto start = Clock::now();
+                auto&& r = Detail::complete_invoke(fun, std::forward<Args>(args)...);
+                auto end = Clock::now();
+                auto delta = end - start;
+                return { delta, std::forward<decltype(r)>(r), 1 };
+            }
+        } // namespace Detail
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_measure.hpp
+#include <utility>
+#include <type_traits>
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            template <typename Clock, typename Fun>
+            TimingOf<Clock, Fun, int> measure_one(Fun&& fun, int iters, std::false_type) {
+                return Detail::measure<Clock>(fun, iters);
+            }
+            template <typename Clock, typename Fun>
+            TimingOf<Clock, Fun, Chronometer> measure_one(Fun&& fun, int iters, std::true_type) {
+                Detail::ChronometerModel<Clock> meter;
+                auto&& result = Detail::complete_invoke(fun, Chronometer(meter, iters));
+
+                return { meter.elapsed(), std::move(result), iters };
+            }
+
+            template <typename Clock, typename Fun>
+            using run_for_at_least_argument_t = typename std::conditional<is_callable<Fun(Chronometer)>::value, Chronometer, int>::type;
+
+            struct optimized_away_error : std::exception {
+                const char* what() const noexcept override {
+                    return "could not measure benchmark, maybe it was optimized away";
+                }
+            };
+
+            template <typename Clock, typename Fun>
+            TimingOf<Clock, Fun, run_for_at_least_argument_t<Clock, Fun>> run_for_at_least(ClockDuration<Clock> how_long, int seed, Fun&& fun) {
+                auto iters = seed;
+                while (iters < (1 << 30)) {
+                    auto&& Timing = measure_one<Clock>(fun, iters, is_callable<Fun(Chronometer)>());
+
+                    if (Timing.elapsed >= how_long) {
+                        return { Timing.elapsed, std::move(Timing.result), iters };
+                    }
+                    iters *= 2;
+                }
+                Catch::throw_exception(optimized_away_error{});
+            }
+        } // namespace Detail
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_run_for_at_least.hpp
+#include <algorithm>
+#include <iterator>
+
+namespace Catch {
+    namespace Benchmark {
+        template <typename Duration>
+        struct ExecutionPlan {
+            int iterations_per_sample;
+            Duration estimated_duration;
+            Detail::BenchmarkFunction benchmark;
+            Duration warmup_time;
+            int warmup_iterations;
+
+            template <typename Duration2>
+            operator ExecutionPlan<Duration2>() const {
+                return { iterations_per_sample, estimated_duration, benchmark, warmup_time, warmup_iterations };
+            }
+
+            template <typename Clock>
+            std::vector<FloatDuration<Clock>> run(const IConfig &cfg, Environment<FloatDuration<Clock>> env) const {
+                // warmup a bit
+                Detail::run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(warmup_time), warmup_iterations, Detail::repeat(now<Clock>{}));
+
+                std::vector<FloatDuration<Clock>> times;
+                times.reserve(cfg.benchmarkSamples());
+                std::generate_n(std::back_inserter(times), cfg.benchmarkSamples(), [this, env] {
+                    Detail::ChronometerModel<Clock> model;
+                    this->benchmark(Chronometer(model, iterations_per_sample));
+                    auto sample_time = model.elapsed() - env.clock_cost.mean;
+                    if (sample_time < FloatDuration<Clock>::zero()) sample_time = FloatDuration<Clock>::zero();
+                    return sample_time / iterations_per_sample;
+                });
+                return times;
+            }
+        };
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_execution_plan.hpp
+// start catch_estimate_clock.hpp
+
+ // Environment measurement
+
+
+// start catch_stats.hpp
+
+// Statistical analysis tools
+
+
+#include <algorithm>
+#include <functional>
+#include <vector>
+#include <iterator>
+#include <numeric>
+#include <tuple>
+#include <cmath>
+#include <utility>
+#include <cstddef>
+#include <random>
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            using sample = std::vector<double>;
+
+            double weighted_average_quantile(int k, int q, std::vector<double>::iterator first, std::vector<double>::iterator last);
+
+            template <typename Iterator>
+            OutlierClassification classify_outliers(Iterator first, Iterator last) {
+                std::vector<double> copy(first, last);
+
+                auto q1 = weighted_average_quantile(1, 4, copy.begin(), copy.end());
+                auto q3 = weighted_average_quantile(3, 4, copy.begin(), copy.end());
+                auto iqr = q3 - q1;
+                auto los = q1 - (iqr * 3.);
+                auto lom = q1 - (iqr * 1.5);
+                auto him = q3 + (iqr * 1.5);
+                auto his = q3 + (iqr * 3.);
+
+                OutlierClassification o;
+                for (; first != last; ++first) {
+                    auto&& t = *first;
+                    if (t < los) ++o.low_severe;
+                    else if (t < lom) ++o.low_mild;
+                    else if (t > his) ++o.high_severe;
+                    else if (t > him) ++o.high_mild;
+                    ++o.samples_seen;
+                }
+                return o;
+            }
+
+            template <typename Iterator>
+            double mean(Iterator first, Iterator last) {
+                auto count = last - first;
+                double sum = std::accumulate(first, last, 0.);
+                return sum / count;
+            }
+
+            template <typename URng, typename Iterator, typename Estimator>
+            sample resample(URng& rng, int resamples, Iterator first, Iterator last, Estimator& estimator) {
+                auto n = last - first;
+                std::uniform_int_distribution<decltype(n)> dist(0, n - 1);
+
+                sample out;
+                out.reserve(resamples);
+                std::generate_n(std::back_inserter(out), resamples, [n, first, &estimator, &dist, &rng] {
+                    std::vector<double> resampled;
+                    resampled.reserve(n);
+                    std::generate_n(std::back_inserter(resampled), n, [first, &dist, &rng] { return first[dist(rng)]; });
+                    return estimator(resampled.begin(), resampled.end());
+                });
+                std::sort(out.begin(), out.end());
+                return out;
+            }
+
+            template <typename Estimator, typename Iterator>
+            sample jackknife(Estimator&& estimator, Iterator first, Iterator last) {
+                auto n = last - first;
+                auto second = std::next(first);
+                sample results;
+                results.reserve(n);
+
+                for (auto it = first; it != last; ++it) {
+                    std::iter_swap(it, first);
+                    results.push_back(estimator(second, last));
+                }
+
+                return results;
+            }
+
+            inline double normal_cdf(double x) {
+                return std::erfc(-x / std::sqrt(2.0)) / 2.0;
+            }
+
+            double erfc_inv(double x);
+
+            double normal_quantile(double p);
+
+            template <typename Iterator, typename Estimator>
+            Estimate<double> bootstrap(double confidence_level, Iterator first, Iterator last, sample const& resample, Estimator&& estimator) {
+                auto n_samples = last - first;
+
+                double point = estimator(first, last);
+                // Degenerate case with a single sample
+                if (n_samples == 1) return { point, point, point, confidence_level };
+
+                sample jack = jackknife(estimator, first, last);
+                double jack_mean = mean(jack.begin(), jack.end());
+                double sum_squares, sum_cubes;
+                std::tie(sum_squares, sum_cubes) = std::accumulate(jack.begin(), jack.end(), std::make_pair(0., 0.), [jack_mean](std::pair<double, double> sqcb, double x) -> std::pair<double, double> {
+                    auto d = jack_mean - x;
+                    auto d2 = d * d;
+                    auto d3 = d2 * d;
+                    return { sqcb.first + d2, sqcb.second + d3 };
+                });
+
+                double accel = sum_cubes / (6 * std::pow(sum_squares, 1.5));
+                int n = static_cast<int>(resample.size());
+                double prob_n = std::count_if(resample.begin(), resample.end(), [point](double x) { return x < point; }) / (double)n;
+                // degenerate case with uniform samples
+                if (prob_n == 0) return { point, point, point, confidence_level };
+
+                double bias = normal_quantile(prob_n);
+                double z1 = normal_quantile((1. - confidence_level) / 2.);
+
+                auto cumn = [n](double x) -> int {
+                    return std::lround(normal_cdf(x) * n); };
+                auto a = [bias, accel](double b) { return bias + b / (1. - accel * b); };
+                double b1 = bias + z1;
+                double b2 = bias - z1;
+                double a1 = a(b1);
+                double a2 = a(b2);
+                auto lo = (std::max)(cumn(a1), 0);
+                auto hi = (std::min)(cumn(a2), n - 1);
+
+                return { point, resample[lo], resample[hi], confidence_level };
+            }
+
+            double outlier_variance(Estimate<double> mean, Estimate<double> stddev, int n);
+
+            struct bootstrap_analysis {
+                Estimate<double> mean;
+                Estimate<double> standard_deviation;
+                double outlier_variance;
+            };
+
+            bootstrap_analysis analyse_samples(double confidence_level, int n_resamples, std::vector<double>::iterator first, std::vector<double>::iterator last);
+        } // namespace Detail
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_stats.hpp
+#include <algorithm>
+#include <iterator>
+#include <tuple>
+#include <vector>
+#include <cmath>
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            template <typename Clock>
+            std::vector<double> resolution(int k) {
+                std::vector<TimePoint<Clock>> times;
+                times.reserve(k + 1);
+                std::generate_n(std::back_inserter(times), k + 1, now<Clock>{});
+
+                std::vector<double> deltas;
+                deltas.reserve(k);
+                std::transform(std::next(times.begin()), times.end(), times.begin(),
+                    std::back_inserter(deltas),
+                    [](TimePoint<Clock> a, TimePoint<Clock> b) { return static_cast<double>((a - b).count()); });
+
+                return deltas;
+            }
+
+            const auto warmup_iterations = 10000;
+            const auto warmup_time = std::chrono::milliseconds(100);
+            const auto minimum_ticks = 1000;
+            const auto warmup_seed = 10000;
+            const auto clock_resolution_estimation_time = std::chrono::milliseconds(500);
+            const auto clock_cost_estimation_time_limit = std::chrono::seconds(1);
+            const auto clock_cost_estimation_tick_limit = 100000;
+            const auto clock_cost_estimation_time = std::chrono::milliseconds(10);
+            const auto clock_cost_estimation_iterations = 10000;
+
+            template <typename Clock>
+            int warmup() {
+                return run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(warmup_time), warmup_seed, &resolution<Clock>)
+                    .iterations;
+            }
+            template <typename Clock>
+            EnvironmentEstimate<FloatDuration<Clock>> estimate_clock_resolution(int iterations) {
+                auto r = run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(clock_resolution_estimation_time), iterations, &resolution<Clock>)
+                    .result;
+                return {
+                    FloatDuration<Clock>(mean(r.begin(), r.end())),
+                    classify_outliers(r.begin(), r.end()),
+                };
+            }
+            template <typename Clock>
+            EnvironmentEstimate<FloatDuration<Clock>> estimate_clock_cost(FloatDuration<Clock> resolution) {
+                auto time_limit = (std::min)(
+                    resolution * clock_cost_estimation_tick_limit,
+                    FloatDuration<Clock>(clock_cost_estimation_time_limit));
+                auto time_clock = [](int k) {
+                    return Detail::measure<Clock>([k] {
+                        for (int i = 0; i < k; ++i) {
+                            volatile auto ignored = Clock::now();
+                            (void)ignored;
+                        }
+                    }).elapsed;
+                };
+                time_clock(1);
+                int iters = clock_cost_estimation_iterations;
+                auto&& r = run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(clock_cost_estimation_time), iters, time_clock);
+                std::vector<double> times;
+                int nsamples = static_cast<int>(std::ceil(time_limit / r.elapsed));
+                times.reserve(nsamples);
+                std::generate_n(std::back_inserter(times), nsamples, [time_clock, &r] {
+                    return static_cast<double>((time_clock(r.iterations) / r.iterations).count());
+                });
+                return {
+                    FloatDuration<Clock>(mean(times.begin(), times.end())),
+                    classify_outliers(times.begin(), times.end()),
+                };
+            }
+
+            template <typename Clock>
+            Environment<FloatDuration<Clock>> measure_environment() {
+                static Environment<FloatDuration<Clock>>* env = nullptr;
+                if (env) {
+                    return *env;
+                }
+
+                auto iters = Detail::warmup<Clock>();
+                auto resolution = Detail::estimate_clock_resolution<Clock>(iters);
+                auto cost = Detail::estimate_clock_cost<Clock>(resolution.mean);
+
+                env = new Environment<FloatDuration<Clock>>{ resolution, cost };
+                return *env;
+            }
+        } // namespace Detail
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_estimate_clock.hpp
+// start catch_analyse.hpp
+
+ // Run and analyse one benchmark
+
+
+// start catch_sample_analysis.hpp
+
+// Benchmark results
+
+
+#include <algorithm>
+#include <vector>
+#include <string>
+#include <iterator>
+
+namespace Catch {
+    namespace Benchmark {
+        template <typename Duration>
+        struct SampleAnalysis {
+            std::vector<Duration> samples;
+            Estimate<Duration> mean;
+            Estimate<Duration> standard_deviation;
+            OutlierClassification outliers;
+            double outlier_variance;
+
+            template <typename Duration2>
+            operator SampleAnalysis<Duration2>() const {
+                std::vector<Duration2> samples2;
+                samples2.reserve(samples.size());
+                std::transform(samples.begin(), samples.end(), std::back_inserter(samples2), [](Duration d) { return Duration2(d); });
+                return {
+                    std::move(samples2),
+                    mean,
+                    standard_deviation,
+                    outliers,
+                    outlier_variance,
+                };
+            }
+        };
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_sample_analysis.hpp
+#include <algorithm>
+#include <iterator>
+#include <vector>
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            template <typename Duration, typename Iterator>
+            SampleAnalysis<Duration> analyse(const IConfig &cfg, Environment<Duration>, Iterator first, Iterator last) {
+                if (!cfg.benchmarkNoAnalysis()) {
+                    std::vector<double> samples;
+                    samples.reserve(last - first);
+                    std::transform(first, last, std::back_inserter(samples), [](Duration d) { return d.count(); });
+
+                    auto analysis = Catch::Benchmark::Detail::analyse_samples(cfg.benchmarkConfidenceInterval(), cfg.benchmarkResamples(), samples.begin(), samples.end());
+                    auto outliers = Catch::Benchmark::Detail::classify_outliers(samples.begin(), samples.end());
+
+                    auto wrap_estimate = [](Estimate<double> e) {
+                        return Estimate<Duration> {
+                            Duration(e.point),
+                                Duration(e.lower_bound),
+                                Duration(e.upper_bound),
+                                e.confidence_interval,
+                        };
+                    };
+                    std::vector<Duration> samples2;
+                    samples2.reserve(samples.size());
+                    std::transform(samples.begin(), samples.end(), std::back_inserter(samples2), [](double d) { return Duration(d); });
+                    return {
+                        std::move(samples2),
+                        wrap_estimate(analysis.mean),
+                        wrap_estimate(analysis.standard_deviation),
+                        outliers,
+                        analysis.outlier_variance,
+                    };
+                } else {
+                    std::vector<Duration> samples;
+                    samples.reserve(last - first);
+
+                    Duration mean = Duration(0);
+                    int i = 0;
+                    for (auto it = first; it < last; ++it, ++i) {
+                        samples.push_back(Duration(*it));
+                        mean += Duration(*it);
+                    }
+                    mean /= i;
+
+                    return {
+                        std::move(samples),
+                        Estimate<Duration>{mean, mean, mean, 0.0},
+                        Estimate<Duration>{Duration(0), Duration(0), Duration(0), 0.0},
+                        OutlierClassification{},
+                        0.0
+                    };
+                }
+            }
+        } // namespace Detail
+    } // namespace Benchmark
+} // namespace Catch
+
+// end catch_analyse.hpp
+#include <algorithm>
+#include <functional>
+#include <string>
+#include <vector>
+#include <cmath>
+
+namespace Catch {
+    namespace Benchmark {
+        struct Benchmark {
+            Benchmark(std::string &&name)
+                : name(std::move(name)) {}
+
+            template <class FUN>
+            Benchmark(std::string &&name, FUN &&func)
+                : fun(std::move(func)), name(std::move(name)) {}
+
+            template <typename Clock>
+            ExecutionPlan<FloatDuration<Clock>> prepare(const IConfig &cfg, Environment<FloatDuration<Clock>> env) const {
+                auto min_time = env.clock_resolution.mean * Detail::minimum_ticks;
+                auto run_time = std::max(min_time, std::chrono::duration_cast<decltype(min_time)>(cfg.benchmarkWarmupTime()));
+                auto&& test = Detail::run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(run_time), 1, fun);
+                int new_iters = static_cast<int>(std::ceil(min_time * test.iterations / test.elapsed));
+                return { new_iters, test.elapsed / test.iterations * new_iters * cfg.benchmarkSamples(), fun, std::chrono::duration_cast<FloatDuration<Clock>>(cfg.benchmarkWarmupTime()), Detail::warmup_iterations };
+            }
+
+            template <typename Clock = default_clock>
+            void run() {
+                IConfigPtr cfg = getCurrentContext().getConfig();
+
+                auto env = Detail::measure_environment<Clock>();
+
+                getResultCapture().benchmarkPreparing(name);
+                CATCH_TRY{
+                    auto plan = user_code([&] {
+                        return prepare<Clock>(*cfg, env);
+                    });
+
+                    BenchmarkInfo info {
+                        name,
+                        plan.estimated_duration.count(),
+                        plan.iterations_per_sample,
+                        cfg->benchmarkSamples(),
+                        cfg->benchmarkResamples(),
+                        env.clock_resolution.mean.count(),
+                        env.clock_cost.mean.count()
+                    };
+
+                    getResultCapture().benchmarkStarting(info);
+
+                    auto samples = user_code([&] {
+                        return plan.template run<Clock>(*cfg, env);
+                    });
+
+                    auto analysis = Detail::analyse(*cfg, env, samples.begin(), samples.end());
+                    BenchmarkStats<FloatDuration<Clock>> stats{ info, analysis.samples, analysis.mean, analysis.standard_deviation, analysis.outliers, analysis.outlier_variance };
+                    getResultCapture().benchmarkEnded(stats);
+
+                } CATCH_CATCH_ALL{
+                    if (translateActiveException() != Detail::benchmarkErrorMsg) // benchmark errors have been reported, otherwise rethrow.
+                        std::rethrow_exception(std::current_exception());
+                }
+            }
+
+            // sets lambda to be used in fun *and* executes benchmark!
+            template <typename Fun,
+                typename std::enable_if<!Detail::is_related<Fun, Benchmark>::value, int>::type = 0>
+                Benchmark & operator=(Fun func) {
+                fun = Detail::BenchmarkFunction(func);
+                run();
+                return *this;
+            }
+
+            explicit operator bool() {
+                return true;
+            }
+
+        private:
+            Detail::BenchmarkFunction fun;
+            std::string name;
+        };
+    }
+} // namespace Catch
+
+#define INTERNAL_CATCH_GET_1_ARG(arg1, arg2, ...) arg1
+#define INTERNAL_CATCH_GET_2_ARG(arg1, arg2, ...) arg2
+
+#define INTERNAL_CATCH_BENCHMARK(BenchmarkName, name, benchmarkIndex)\
+    if( Catch::Benchmark::Benchmark BenchmarkName{name} ) \
+        BenchmarkName = [&](int benchmarkIndex)
+
+#define INTERNAL_CATCH_BENCHMARK_ADVANCED(BenchmarkName, name)\
+    if( Catch::Benchmark::Benchmark BenchmarkName{name} ) \
+        BenchmarkName = [&]
+
+// end catch_benchmark.hpp
+// start catch_constructor.hpp
+
+// Constructor and destructor helpers
+
+
+#include <type_traits>
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+            template <typename T, bool Destruct>
+            struct ObjectStorage
+            {
+                using TStorage = typename std::aligned_storage<sizeof(T), std::alignment_of<T>::value>::type;
+
+                ObjectStorage() : data() {}
+
+                ObjectStorage(const ObjectStorage& other)
+                {
+                    new(&data) T(other.stored_object());
+                }
+
+                ObjectStorage(ObjectStorage&& other)
+                {
+                    new(&data) T(std::move(other.stored_object()));
+                }
+
+                ~ObjectStorage() { destruct_on_exit<T>(); }
+
+                template <typename... Args>
+                void construct(Args&&... args)
+                {
+                    new (&data) T(std::forward<Args>(args)...);
+                }
+
+                template <bool AllowManualDestruction = !Destruct>
+                typename std::enable_if<AllowManualDestruction>::type destruct()
+                {
+                    stored_object().~T();
+                }
+
+            private:
+                // If this is a constructor benchmark, destruct the underlying object
+                template <typename U>
+                void destruct_on_exit(typename std::enable_if<Destruct, U>::type* = 0) { destruct<true>(); }
+                // Otherwise, don't
+                template <typename U>
+                void destruct_on_exit(typename std::enable_if<!Destruct, U>::type* = 0) { }
+
+                T& stored_object() {
+                    return *static_cast<T*>(static_cast<void*>(&data));
+                }
+
+                T const& stored_object() const {
+                    return *static_cast<T*>(static_cast<void*>(&data));
+                }
+
+                TStorage data;
+            };
+        }
+
+        template <typename T>
+        using storage_for = Detail::ObjectStorage<T, true>;
+
+        template <typename T>
+        using destructable_object = Detail::ObjectStorage<T, false>;
+    }
+}
+
+// end catch_constructor.hpp
+// end catch_benchmarking_all.hpp
+#endif
+
+#endif // ! CATCH_CONFIG_IMPL_ONLY
+
+#ifdef CATCH_IMPL
+// start catch_impl.hpp
+
+#ifdef __clang__
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wweak-vtables"
+#endif
+
+// Keep these here for external reporters
+// start catch_test_case_tracker.h
+
+#include <string>
+#include <vector>
+#include <memory>
+
+namespace Catch {
+namespace TestCaseTracking {
+
+    struct NameAndLocation {
+        std::string name;
+        SourceLineInfo location;
+
+        NameAndLocation( std::string const& _name, SourceLineInfo const& _location );
+        friend bool operator==(NameAndLocation const& lhs, NameAndLocation const& rhs) {
+            return lhs.name == rhs.name
+                && lhs.location == rhs.location;
+        }
+    };
+
+    class ITracker;
+
+    using ITrackerPtr = std::shared_ptr<ITracker>;
+
+    class  ITracker {
+        NameAndLocation m_nameAndLocation;
+
+    public:
+        ITracker(NameAndLocation const& nameAndLoc) :
+            m_nameAndLocation(nameAndLoc)
+        {}
+
+        // static queries
+        NameAndLocation const& nameAndLocation() const {
+            return m_nameAndLocation;
+        }
+
+        virtual ~ITracker();
+
+        // dynamic queries
+        virtual bool isComplete() const = 0; // Successfully completed or failed
+        virtual bool isSuccessfullyCompleted() const = 0;
+        virtual bool isOpen() const = 0; // Started but not complete
+        virtual bool hasChildren() const = 0;
+        virtual bool hasStarted() const = 0;
+
+        virtual ITracker& parent() = 0;
+
+        // actions
+        virtual void close() = 0; // Successfully complete
+        virtual void fail() = 0;
+        virtual void markAsNeedingAnotherRun() = 0;
+
+        virtual void addChild( ITrackerPtr const& child ) = 0;
+        virtual ITrackerPtr findChild( NameAndLocation const& nameAndLocation ) = 0;
+        virtual void openChild() = 0;
+
+        // Debug/ checking
+        virtual bool isSectionTracker() const = 0;
+        virtual bool isGeneratorTracker() const = 0;
+    };
+
+    class TrackerContext {
+
+        enum RunState {
+            NotStarted,
+            Executing,
+            CompletedCycle
+        };
+
+        ITrackerPtr m_rootTracker;
+        ITracker* m_currentTracker = nullptr;
+        RunState m_runState = NotStarted;
+
+    public:
+
+        ITracker& startRun();
+        void endRun();
+
+        void startCycle();
+        void completeCycle();
+
+        bool completedCycle() const;
+        ITracker& currentTracker();
+        void setCurrentTracker( ITracker* tracker );
+    };
+
+    class TrackerBase : public ITracker {
+    protected:
+        enum CycleState {
+            NotStarted,
+            Executing,
+            ExecutingChildren,
+            NeedsAnotherRun,
+            CompletedSuccessfully,
+            Failed
+        };
+
+        using Children = std::vector<ITrackerPtr>;
+        TrackerContext& m_ctx;
+        ITracker* m_parent;
+        Children m_children;
+        CycleState m_runState = NotStarted;
+
+    public:
+        TrackerBase( NameAndLocation const& nameAndLocation, TrackerContext& ctx, ITracker* parent );
+
+        bool isComplete() const override;
+        bool isSuccessfullyCompleted() const override;
+        bool isOpen() const override;
+        bool hasChildren() const override;
+        bool hasStarted() const override {
+            return m_runState != NotStarted;
+        }
+
+        void addChild( ITrackerPtr const& child ) override;
+
+        ITrackerPtr findChild( NameAndLocation const& nameAndLocation ) override;
+        ITracker& parent() override;
+
+        void openChild() override;
+
+        bool isSectionTracker() const override;
+        bool isGeneratorTracker() const override;
+
+        void open();
+
+        void close() override;
+        void fail() override;
+        void markAsNeedingAnotherRun() override;
+
+    private:
+        void moveToParent();
+        void moveToThis();
+    };
+
+    class SectionTracker : public TrackerBase {
+        std::vector<std::string> m_filters;
+        std::string m_trimmed_name;
+    public:
+        SectionTracker( NameAndLocation const& nameAndLocation, TrackerContext& ctx, ITracker* parent );
+
+        bool isSectionTracker() const override;
+
+        bool isComplete() const override;
+
+        static SectionTracker& acquire( TrackerContext& ctx, NameAndLocation const& nameAndLocation );
+
+        void tryOpen();
+
+        void addInitialFilters( std::vector<std::string> const& filters );
+        void addNextFilters( std::vector<std::string> const& filters );
+        //! Returns filters active in this tracker
+        std::vector<std::string> const& getFilters() const;
+        //! Returns whitespace-trimmed name of the tracked section
+        std::string const& trimmedName() const;
+    };
+
+} // namespace TestCaseTracking
+
+using TestCaseTracking::ITracker;
+using TestCaseTracking::TrackerContext;
+using TestCaseTracking::SectionTracker;
+
+} // namespace Catch
+
+// end catch_test_case_tracker.h
+
+// start catch_leak_detector.h
+
+namespace Catch {
+
+    struct LeakDetector {
+        LeakDetector();
+        ~LeakDetector();
+    };
+
+}
+// end catch_leak_detector.h
+// Cpp files will be included in the single-header file here
+// start catch_stats.cpp
+
+// Statistical analysis tools
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+
+#include <cassert>
+#include <random>
+
+#if defined(CATCH_CONFIG_USE_ASYNC)
+#include <future>
+#endif
+
+namespace {
+    double erf_inv(double x) {
+        // Code accompanying the article "Approximating the erfinv function" in GPU Computing Gems, Volume 2
+        double w, p;
+
+        w = -log((1.0 - x) * (1.0 + x));
+
+        if (w < 6.250000) {
+            w = w - 3.125000;
+            p = -3.6444120640178196996e-21;
+            p = -1.685059138182016589e-19 + p * w;
+            p = 1.2858480715256400167e-18 + p * w;
+            p = 1.115787767802518096e-17 + p * w;
+            p = -1.333171662854620906e-16 + p * w;
+            p = 2.0972767875968561637e-17 + p * w;
+            p = 6.6376381343583238325e-15 + p * w;
+            p = -4.0545662729752068639e-14 + p * w;
+            p = -8.1519341976054721522e-14 + p * w;
+            p = 2.6335093153082322977e-12 + p * w;
+            p = -1.2975133253453532498e-11 + p * w;
+            p = -5.4154120542946279317e-11 + p * w;
+            p = 1.051212273321532285e-09 + p * w;
+            p = -4.1126339803469836976e-09 + p * w;
+            p = -2.9070369957882005086e-08 + p * w;
+            p = 4.2347877827932403518e-07 + p * w;
+            p = -1.3654692000834678645e-06 + p * w;
+            p = -1.3882523362786468719e-05 + p * w;
+            p = 0.0001867342080340571352 + p * w;
+            p = -0.00074070253416626697512 + p * w;
+            p = -0.0060336708714301490533 + p * w;
+            p = 0.24015818242558961693 + p * w;
+            p = 1.6536545626831027356 + p * w;
+        } else if (w < 16.000000) {
+            w = sqrt(w) - 3.250000;
+            p = 2.2137376921775787049e-09;
+            p = 9.0756561938885390979e-08 + p * w;
+            p = -2.7517406297064545428e-07 + p * w;
+            p = 1.8239629214389227755e-08 + p * w;
+            p = 1.5027403968909827627e-06 + p * w;
+            p = -4.013867526981545969e-06 + p * w;
+            p = 2.9234449089955446044e-06 + p * w;
+            p = 1.2475304481671778723e-05 + p * w;
+            p = -4.7318229009055733981e-05 + p * w;
+            p = 6.8284851459573175448e-05 + p * w;
+            p = 2.4031110387097893999e-05 + p * w;
+            p = -0.0003550375203628474796 + p * w;
+            p = 0.00095328937973738049703 + p * w;
+            p = -0.0016882755560235047313 + p * w;
+            p = 0.0024914420961078508066 + p * w;
+            p = -0.0037512085075692412107 + p * w;
+            p = 0.005370914553590063617 + p * w;
+            p = 1.0052589676941592334 + p * w;
+            p = 3.0838856104922207635 + p * w;
+        } else {
+            w = sqrt(w) - 5.000000;
+            p = -2.7109920616438573243e-11;
+            p = -2.5556418169965252055e-10 + p * w;
+            p = 1.5076572693500548083e-09 + p * w;
+            p = -3.7894654401267369937e-09 + p * w;
+            p = 7.6157012080783393804e-09 + p * w;
+            p = -1.4960026627149240478e-08 + p * w;
+            p = 2.9147953450901080826e-08 + p * w;
+            p = -6.7711997758452339498e-08 + p * w;
+            p = 2.2900482228026654717e-07 + p * w;
+            p = -9.9298272942317002539e-07 + p * w;
+            p = 4.5260625972231537039e-06 + p * w;
+            p = -1.9681778105531670567e-05 + p * w;
+            p = 7.5995277030017761139e-05 + p * w;
+            p = -0.00021503011930044477347 + p * w;
+            p = -0.00013871931833623122026 + p * w;
+            p = 1.0103004648645343977 + p * w;
+            p = 4.8499064014085844221 + p * w;
+        }
+        return p * x;
+    }
+
+    double standard_deviation(std::vector<double>::iterator first, std::vector<double>::iterator last) {
+        auto m = Catch::Benchmark::Detail::mean(first, last);
+        double variance = std::accumulate(first, last, 0., [m](double a, double b) {
+            double diff = b - m;
+            return a + diff * diff;
+            }) / (last - first);
+            return std::sqrt(variance);
+    }
+
+}
+
+namespace Catch {
+    namespace Benchmark {
+        namespace Detail {
+
+            double weighted_average_quantile(int k, int q, std::vector<double>::iterator first, std::vector<double>::iterator last) {
+                auto count = last - first;
+                double idx = (count - 1) * k / static_cast<double>(q);
+                int j = static_cast<int>(idx);
+                double g = idx - j;
+                std::nth_element(first, first + j, last);
+                auto xj = first[j];
+                if (g == 0) return xj;
+
+                auto xj1 = *std::min_element(first + (j + 1), last);
+                return xj + g * (xj1 - xj);
+            }
+
+            double erfc_inv(double x) {
+                return erf_inv(1.0 - x);
+            }
+
+            double normal_quantile(double p) {
+                static const double ROOT_TWO = std::sqrt(2.0);
+
+                double result = 0.0;
+                assert(p >= 0 && p <= 1);
+                if (p < 0 || p > 1) {
+                    return result;
+                }
+
+                result = -erfc_inv(2.0 * p);
+                // result *= normal distribution standard deviation (1.0) * sqrt(2)
+                result *= /*sd * */ ROOT_TWO;
+                // result += normal disttribution mean (0)
+                return result;
+            }
+
+            double outlier_variance(Estimate<double> mean, Estimate<double> stddev, int n) {
+                double sb = stddev.point;
+                double mn = mean.point / n;
+                double mg_min = mn / 2.;
+                double sg = (std::min)(mg_min / 4., sb / std::sqrt(n));
+                double sg2 = sg * sg;
+                double sb2 = sb * sb;
+
+                auto c_max = [n, mn, sb2, sg2](double x) -> double {
+                    double k = mn - x;
+                    double d = k * k;
+                    double nd = n * d;
+                    double k0 = -n * nd;
+                    double k1 = sb2 - n * sg2 + nd;
+                    double det = k1 * k1 - 4 * sg2 * k0;
+                    return (int)(-2. * k0 / (k1 + std::sqrt(det)));
+                };
+
+                auto var_out = [n, sb2, sg2](double c) {
+                    double nc = n - c;
+                    return (nc / n) * (sb2 - nc * sg2);
+                };
+
+                return (std::min)(var_out(1), var_out((std::min)(c_max(0.), c_max(mg_min)))) / sb2;
+            }
+
+            bootstrap_analysis analyse_samples(double confidence_level, int n_resamples, std::vector<double>::iterator first, std::vector<double>::iterator last) {
+                CATCH_INTERNAL_START_WARNINGS_SUPPRESSION
+                CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS
+                static std::random_device entropy;
+                CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
+
+                auto n = static_cast<int>(last - first); // seriously, one can't use integral types without hell in C++
+
+                auto mean = &Detail::mean<std::vector<double>::iterator>;
+                auto stddev = &standard_deviation;
+
+#if defined(CATCH_CONFIG_USE_ASYNC)
+                auto Estimate = [=](double(*f)(std::vector<double>::iterator, std::vector<double>::iterator)) {
+                    auto seed = entropy();
+                    return std::async(std::launch::async, [=] {
+                        std::mt19937 rng(seed);
+                        auto resampled = resample(rng, n_resamples, first, last, f);
+                        return bootstrap(confidence_level, first, last, resampled, f);
+                    });
+                };
+
+                auto mean_future = Estimate(mean);
+                auto stddev_future = Estimate(stddev);
+
+                auto mean_estimate = mean_future.get();
+                auto stddev_estimate = stddev_future.get();
+#else
+                auto Estimate = [=](double(*f)(std::vector<double>::iterator, std::vector<double>::iterator)) {
+                    auto seed = entropy();
+                    std::mt19937 rng(seed);
+                    auto resampled = resample(rng, n_resamples, first, last, f);
+                    return bootstrap(confidence_level, first, last, resampled, f);
+                };
+
+                auto mean_estimate = Estimate(mean);
+                auto stddev_estimate = Estimate(stddev);
+#endif // CATCH_USE_ASYNC
+
+                double outlier_variance = Detail::outlier_variance(mean_estimate, stddev_estimate, n);
+
+                return { mean_estimate, stddev_estimate, outlier_variance };
+            }
+        } // namespace Detail
+    } // namespace Benchmark
+} // namespace Catch
+
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+// end catch_stats.cpp
+// start catch_approx.cpp
+
+#include <cmath>
+#include <limits>
+
+namespace {
+
+// Performs equivalent check of std::fabs(lhs - rhs) <= margin
+// But without the subtraction to allow for INFINITY in comparison
+bool marginComparison(double lhs, double rhs, double margin) {
+    return (lhs + margin >= rhs) && (rhs + margin >= lhs);
+}
+
+}
+
+namespace Catch {
+namespace Detail {
+
+    Approx::Approx ( double value )
+    :   m_epsilon( std::numeric_limits<float>::epsilon()*100 ),
+        m_margin( 0.0 ),
+        m_scale( 0.0 ),
+        m_value( value )
+    {}
+
+    Approx Approx::custom() {
+        return Approx( 0 );
+    }
+
+    Approx Approx::operator-() const {
+        auto temp(*this);
+        temp.m_value = -temp.m_value;
+        return temp;
+    }
+
+    std::string Approx::toString() const {
+        ReusableStringStream rss;
+        rss << "Approx( " << ::Catch::Detail::stringify( m_value ) << " )";
+        return rss.str();
+    }
+
+    bool Approx::equalityComparisonImpl(const double other) const {
+        // First try with fixed margin, then compute margin based on epsilon, scale and Approx's value
+        // Thanks to Richard Harris for his help refining the scaled margin value
+        return marginComparison(m_value, other, m_margin)
+            || marginComparison(m_value, other, m_epsilon * (m_scale + std::fabs(std::isinf(m_value)? 0 : m_value)));
+    }
+
+    void Approx::setMargin(double newMargin) {
+        CATCH_ENFORCE(newMargin >= 0,
+            "Invalid Approx::margin: " << newMargin << '.'
+            << " Approx::Margin has to be non-negative.");
+        m_margin = newMargin;
+    }
+
+    void Approx::setEpsilon(double newEpsilon) {
+        CATCH_ENFORCE(newEpsilon >= 0 && newEpsilon <= 1.0,
+            "Invalid Approx::epsilon: " << newEpsilon << '.'
+            << " Approx::epsilon has to be in [0, 1]");
+        m_epsilon = newEpsilon;
+    }
+
+} // end namespace Detail
+
+namespace literals {
+    Detail::Approx operator "" _a(long double val) {
+        return Detail::Approx(val);
+    }
+    Detail::Approx operator "" _a(unsigned long long val) {
+        return Detail::Approx(val);
+    }
+} // end namespace literals
+
+std::string StringMaker<Catch::Detail::Approx>::convert(Catch::Detail::Approx const& value) {
+    return value.toString();
+}
+
+} // end namespace Catch
+// end catch_approx.cpp
+// start catch_assertionhandler.cpp
+
+// start catch_debugger.h
+
+namespace Catch {
+    bool isDebuggerActive();
+}
+
+#ifdef CATCH_PLATFORM_MAC
+
+    #if defined(__i386__) || defined(__x86_64__)
+        #define CATCH_TRAP() __asm__("int $3\n" : : ) /* NOLINT */
+    #elif defined(__aarch64__)
+        #define CATCH_TRAP()  __asm__(".inst 0xd4200000")
+    #endif
+
+#elif defined(CATCH_PLATFORM_IPHONE)
+
+    // use inline assembler
+    #if defined(__i386__) || defined(__x86_64__)
+        #define CATCH_TRAP()  __asm__("int $3")
+    #elif defined(__aarch64__)
+        #define CATCH_TRAP()  __asm__(".inst 0xd4200000")
+    #elif defined(__arm__) && !defined(__thumb__)
+        #define CATCH_TRAP()  __asm__(".inst 0xe7f001f0")
+    #elif defined(__arm__) &&  defined(__thumb__)
+        #define CATCH_TRAP()  __asm__(".inst 0xde01")
+    #endif
+
+#elif defined(CATCH_PLATFORM_LINUX)
+    // If we can use inline assembler, do it because this allows us to break
+    // directly at the location of the failing check instead of breaking inside
+    // raise() called from it, i.e. one stack frame below.
+    #if defined(__GNUC__) && (defined(__i386) || defined(__x86_64))
+        #define CATCH_TRAP() asm volatile ("int $3") /* NOLINT */
+    #else // Fall back to the generic way.
+        #include <signal.h>
+
+        #define CATCH_TRAP() raise(SIGTRAP)
+    #endif
+#elif defined(_MSC_VER)
+    #define CATCH_TRAP() __debugbreak()
+#elif defined(__MINGW32__)
+    extern "C" __declspec(dllimport) void __stdcall DebugBreak();
+    #define CATCH_TRAP() DebugBreak()
+#endif
+
+#ifndef CATCH_BREAK_INTO_DEBUGGER
+    #ifdef CATCH_TRAP
+        #define CATCH_BREAK_INTO_DEBUGGER() []{ if( Catch::isDebuggerActive() ) { CATCH_TRAP(); } }()
+    #else
+        #define CATCH_BREAK_INTO_DEBUGGER() []{}()
+    #endif
+#endif
+
+// end catch_debugger.h
+// start catch_run_context.h
+
+// start catch_fatal_condition.h
+
+#include <cassert>
+
+namespace Catch {
+
+    // Wrapper for platform-specific fatal error (signals/SEH) handlers
+    //
+    // Tries to be cooperative with other handlers, and not step over
+    // other handlers. This means that unknown structured exceptions
+    // are passed on, previous signal handlers are called, and so on.
+    //
+    // Can only be instantiated once, and assumes that once a signal
+    // is caught, the binary will end up terminating. Thus, there
+    class FatalConditionHandler {
+        bool m_started = false;
+
+        // Install/disengage implementation for specific platform.
+        // Should be if-defed to work on current platform, can assume
+        // engage-disengage 1:1 pairing.
+        void engage_platform();
+        void disengage_platform();
+    public:
+        // Should also have platform-specific implementations as needed
+        FatalConditionHandler();
+        ~FatalConditionHandler();
+
+        void engage() {
+            assert(!m_started && "Handler cannot be installed twice.");
+            m_started = true;
+            engage_platform();
+        }
+
+        void disengage() {
+            assert(m_started && "Handler cannot be uninstalled without being installed first");
+            m_started = false;
+            disengage_platform();
+        }
+    };
+
+    //! Simple RAII guard for (dis)engaging the FatalConditionHandler
+    class FatalConditionHandlerGuard {
+        FatalConditionHandler* m_handler;
+    public:
+        FatalConditionHandlerGuard(FatalConditionHandler* handler):
+            m_handler(handler) {
+            m_handler->engage();
+        }
+        ~FatalConditionHandlerGuard() {
+            m_handler->disengage();
+        }
+    };
+
+} // end namespace Catch
+
+// end catch_fatal_condition.h
+#include <string>
+
+namespace Catch {
+
+    struct IMutableContext;
+
+    ///////////////////////////////////////////////////////////////////////////
+
+    class RunContext : public IResultCapture, public IRunner {
+
+    public:
+        RunContext( RunContext const& ) = delete;
+        RunContext& operator =( RunContext const& ) = delete;
+
+        explicit RunContext( IConfigPtr const& _config, IStreamingReporterPtr&& reporter );
+
+        ~RunContext() override;
+
+        void testGroupStarting( std::string const& testSpec, std::size_t groupIndex, std::size_t groupsCount );
+        void testGroupEnded( std::string const& testSpec, Totals const& totals, std::size_t groupIndex, std::size_t groupsCount );
+
+        Totals runTest(TestCase const& testCase);
+
+        IConfigPtr config() const;
+        IStreamingReporter& reporter() const;
+
+    public: // IResultCapture
+
+        // Assertion handlers
+        void handleExpr
+                (   AssertionInfo const& info,
+                    ITransientExpression const& expr,
+                    AssertionReaction& reaction ) override;
+        void handleMessage
+                (   AssertionInfo const& info,
+                    ResultWas::OfType resultType,
+                    StringRef const& message,
+                    AssertionReaction& reaction ) override;
+        void handleUnexpectedExceptionNotThrown
+                (   AssertionInfo const& info,
+                    AssertionReaction& reaction ) override;
+        void handleUnexpectedInflightException
+                (   AssertionInfo const& info,
+                    std::string const& message,
+                    AssertionReaction& reaction ) override;
+        void handleIncomplete
+                (   AssertionInfo const& info ) override;
+        void handleNonExpr
+                (   AssertionInfo const &info,
+                    ResultWas::OfType resultType,
+                    AssertionReaction &reaction ) override;
+
+        bool sectionStarted( SectionInfo const& sectionInfo, Counts& assertions ) override;
+
+        void sectionEnded( SectionEndInfo const& endInfo ) override;
+        void sectionEndedEarly( SectionEndInfo const& endInfo ) override;
+
+        auto acquireGeneratorTracker( StringRef generatorName, SourceLineInfo const& lineInfo ) -> IGeneratorTracker& override;
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+        void benchmarkPreparing( std::string const& name ) override;
+        void benchmarkStarting( BenchmarkInfo const& info ) override;
+        void benchmarkEnded( BenchmarkStats<> const& stats ) override;
+        void benchmarkFailed( std::string const& error ) override;
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+        void pushScopedMessage( MessageInfo const& message ) override;
+        void popScopedMessage( MessageInfo const& message ) override;
+
+        void emplaceUnscopedMessage( MessageBuilder const& builder ) override;
+
+        std::string getCurrentTestName() const override;
+
+        const AssertionResult* getLastResult() const override;
+
+        void exceptionEarlyReported() override;
+
+        void handleFatalErrorCondition( StringRef message ) override;
+
+        bool lastAssertionPassed() override;
+
+        void assertionPassed() override;
+
+    public:
+        // !TBD We need to do this another way!
+        bool aborting() const final;
+
+    private:
+
+        void runCurrentTest( std::string& redirectedCout, std::string& redirectedCerr );
+        void invokeActiveTestCase();
+
+        void resetAssertionInfo();
+        bool testForMissingAssertions( Counts& assertions );
+
+        void assertionEnded( AssertionResult const& result );
+        void reportExpr
+                (   AssertionInfo const &info,
+                    ResultWas::OfType resultType,
+                    ITransientExpression const *expr,
+                    bool negated );
+
+        void populateReaction( AssertionReaction& reaction );
+
+    private:
+
+        void handleUnfinishedSections();
+
+        TestRunInfo m_runInfo;
+        IMutableContext& m_context;
+        TestCase const* m_activeTestCase = nullptr;
+        ITracker* m_testCaseTracker = nullptr;
+        Option<AssertionResult> m_lastResult;
+
+        IConfigPtr m_config;
+        Totals m_totals;
+        IStreamingReporterPtr m_reporter;
+        std::vector<MessageInfo> m_messages;
+        std::vector<ScopedMessage> m_messageScopes; /* Keeps owners of so-called unscoped messages. */
+        AssertionInfo m_lastAssertionInfo;
+        std::vector<SectionEndInfo> m_unfinishedSections;
+        std::vector<ITracker*> m_activeSections;
+        TrackerContext m_trackerContext;
+        FatalConditionHandler m_fatalConditionhandler;
+        bool m_lastAssertionPassed = false;
+        bool m_shouldReportUnexpected = true;
+        bool m_includeSuccessfulResults;
+    };
+
+    void seedRng(IConfig const& config);
+    unsigned int rngSeed();
+} // end namespace Catch
+
+// end catch_run_context.h
+namespace Catch {
+
+    namespace {
+        auto operator <<( std::ostream& os, ITransientExpression const& expr ) -> std::ostream& {
+            expr.streamReconstructedExpression( os );
+            return os;
+        }
+    }
+
+    LazyExpression::LazyExpression( bool isNegated )
+    :   m_isNegated( isNegated )
+    {}
+
+    LazyExpression::LazyExpression( LazyExpression const& other ) : m_isNegated( other.m_isNegated ) {}
+
+    LazyExpression::operator bool() const {
+        return m_transientExpression != nullptr;
+    }
+
+    auto operator << ( std::ostream& os, LazyExpression const& lazyExpr ) -> std::ostream& {
+        if( lazyExpr.m_isNegated )
+            os << "!";
+
+        if( lazyExpr ) {
+            if( lazyExpr.m_isNegated && lazyExpr.m_transientExpression->isBinaryExpression() )
+                os << "(" << *lazyExpr.m_transientExpression << ")";
+            else
+                os << *lazyExpr.m_transientExpression;
+        }
+        else {
+            os << "{** error - unchecked empty expression requested **}";
+        }
+        return os;
+    }
+
+    AssertionHandler::AssertionHandler
+        (   StringRef const& macroName,
+            SourceLineInfo const& lineInfo,
+            StringRef capturedExpression,
+            ResultDisposition::Flags resultDisposition )
+    :   m_assertionInfo{ macroName, lineInfo, capturedExpression, resultDisposition },
+        m_resultCapture( getResultCapture() )
+    {}
+
+    void AssertionHandler::handleExpr( ITransientExpression const& expr ) {
+        m_resultCapture.handleExpr( m_assertionInfo, expr, m_reaction );
+    }
+    void AssertionHandler::handleMessage(ResultWas::OfType resultType, StringRef const& message) {
+        m_resultCapture.handleMessage( m_assertionInfo, resultType, message, m_reaction );
+    }
+
+    auto AssertionHandler::allowThrows() const -> bool {
+        return getCurrentContext().getConfig()->allowThrows();
+    }
+
+    void AssertionHandler::complete() {
+        setCompleted();
+        if( m_reaction.shouldDebugBreak ) {
+
+            // If you find your debugger stopping you here then go one level up on the
+            // call-stack for the code that caused it (typically a failed assertion)
+
+            // (To go back to the test and change execution, jump over the throw, next)
+            CATCH_BREAK_INTO_DEBUGGER();
+        }
+        if (m_reaction.shouldThrow) {
+#if !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+            throw Catch::TestFailureException();
+#else
+            CATCH_ERROR( "Test failure requires aborting test!" );
+#endif
+        }
+    }
+    void AssertionHandler::setCompleted() {
+        m_completed = true;
+    }
+
+    void AssertionHandler::handleUnexpectedInflightException() {
+        m_resultCapture.handleUnexpectedInflightException( m_assertionInfo, Catch::translateActiveException(), m_reaction );
+    }
+
+    void AssertionHandler::handleExceptionThrownAsExpected() {
+        m_resultCapture.handleNonExpr(m_assertionInfo, ResultWas::Ok, m_reaction);
+    }
+    void AssertionHandler::handleExceptionNotThrownAsExpected() {
+        m_resultCapture.handleNonExpr(m_assertionInfo, ResultWas::Ok, m_reaction);
+    }
+
+    void AssertionHandler::handleUnexpectedExceptionNotThrown() {
+        m_resultCapture.handleUnexpectedExceptionNotThrown( m_assertionInfo, m_reaction );
+    }
+
+    void AssertionHandler::handleThrowingCallSkipped() {
+        m_resultCapture.handleNonExpr(m_assertionInfo, ResultWas::Ok, m_reaction);
+    }
+
+    // This is the overload that takes a string and infers the Equals matcher from it
+    // The more general overload, that takes any string matcher, is in catch_capture_matchers.cpp
+    void handleExceptionMatchExpr( AssertionHandler& handler, std::string const& str, StringRef const& matcherString  ) {
+        handleExceptionMatchExpr( handler, Matchers::Equals( str ), matcherString );
+    }
+
+} // namespace Catch
+// end catch_assertionhandler.cpp
+// start catch_assertionresult.cpp
+
+namespace Catch {
+    AssertionResultData::AssertionResultData(ResultWas::OfType _resultType, LazyExpression const & _lazyExpression):
+        lazyExpression(_lazyExpression),
+        resultType(_resultType) {}
+
+    std::string AssertionResultData::reconstructExpression() const {
+
+        if( reconstructedExpression.empty() ) {
+            if( lazyExpression ) {
+                ReusableStringStream rss;
+                rss << lazyExpression;
+                reconstructedExpression = rss.str();
+            }
+        }
+        return reconstructedExpression;
+    }
+
+    AssertionResult::AssertionResult( AssertionInfo const& info, AssertionResultData const& data )
+    :   m_info( info ),
+        m_resultData( data )
+    {}
+
+    // Result was a success
+    bool AssertionResult::succeeded() const {
+        return Catch::isOk( m_resultData.resultType );
+    }
+
+    // Result was a success, or failure is suppressed
+    bool AssertionResult::isOk() const {
+        return Catch::isOk( m_resultData.resultType ) || shouldSuppressFailure( m_info.resultDisposition );
+    }
+
+    ResultWas::OfType AssertionResult::getResultType() const {
+        return m_resultData.resultType;
+    }
+
+    bool AssertionResult::hasExpression() const {
+        return !m_info.capturedExpression.empty();
+    }
+
+    bool AssertionResult::hasMessage() const {
+        return !m_resultData.message.empty();
+    }
+
+    std::string AssertionResult::getExpression() const {
+        // Possibly overallocating by 3 characters should be basically free
+        std::string expr; expr.reserve(m_info.capturedExpression.size() + 3);
+        if (isFalseTest(m_info.resultDisposition)) {
+            expr += "!(";
+        }
+        expr += m_info.capturedExpression;
+        if (isFalseTest(m_info.resultDisposition)) {
+            expr += ')';
+        }
+        return expr;
+    }
+
+    std::string AssertionResult::getExpressionInMacro() const {
+        std::string expr;
+        if( m_info.macroName.empty() )
+            expr = static_cast<std::string>(m_info.capturedExpression);
+        else {
+            expr.reserve( m_info.macroName.size() + m_info.capturedExpression.size() + 4 );
+            expr += m_info.macroName;
+            expr += "( ";
+            expr += m_info.capturedExpression;
+            expr += " )";
+        }
+        return expr;
+    }
+
+    bool AssertionResult::hasExpandedExpression() const {
+        return hasExpression() && getExpandedExpression() != getExpression();
+    }
+
+    std::string AssertionResult::getExpandedExpression() const {
+        std::string expr = m_resultData.reconstructExpression();
+        return expr.empty()
+                ? getExpression()
+                : expr;
+    }
+
+    std::string AssertionResult::getMessage() const {
+        return m_resultData.message;
+    }
+    SourceLineInfo AssertionResult::getSourceInfo() const {
+        return m_info.lineInfo;
+    }
+
+    StringRef AssertionResult::getTestMacroName() const {
+        return m_info.macroName;
+    }
+
+} // end namespace Catch
+// end catch_assertionresult.cpp
+// start catch_capture_matchers.cpp
+
+namespace Catch {
+
+    using StringMatcher = Matchers::Impl::MatcherBase<std::string>;
+
+    // This is the general overload that takes a any string matcher
+    // There is another overload, in catch_assertionhandler.h/.cpp, that only takes a string and infers
+    // the Equals matcher (so the header does not mention matchers)
+    void handleExceptionMatchExpr( AssertionHandler& handler, StringMatcher const& matcher, StringRef const& matcherString  ) {
+        std::string exceptionMessage = Catch::translateActiveException();
+        MatchExpr<std::string, StringMatcher const&> expr( exceptionMessage, matcher, matcherString );
+        handler.handleExpr( expr );
+    }
+
+} // namespace Catch
+// end catch_capture_matchers.cpp
+// start catch_commandline.cpp
+
+// start catch_commandline.h
+
+// start catch_clara.h
+
+// Use Catch's value for console width (store Clara's off to the side, if present)
+#ifdef CLARA_CONFIG_CONSOLE_WIDTH
+#define CATCH_TEMP_CLARA_CONFIG_CONSOLE_WIDTH CATCH_CLARA_TEXTFLOW_CONFIG_CONSOLE_WIDTH
+#undef CATCH_CLARA_TEXTFLOW_CONFIG_CONSOLE_WIDTH
+#endif
+#define CATCH_CLARA_TEXTFLOW_CONFIG_CONSOLE_WIDTH CATCH_CONFIG_CONSOLE_WIDTH-1
+
+#ifdef __clang__
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wweak-vtables"
+#pragma clang diagnostic ignored "-Wexit-time-destructors"
+#pragma clang diagnostic ignored "-Wshadow"
+#endif
+
+// start clara.hpp
+// Copyright 2017 Two Blue Cubes Ltd. All rights reserved.
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// See https://github.com/philsquared/Clara for more details
+
+// Clara v1.1.5
+
+
+#ifndef CATCH_CLARA_CONFIG_CONSOLE_WIDTH
+#define CATCH_CLARA_CONFIG_CONSOLE_WIDTH 80
+#endif
+
+#ifndef CATCH_CLARA_TEXTFLOW_CONFIG_CONSOLE_WIDTH
+#define CATCH_CLARA_TEXTFLOW_CONFIG_CONSOLE_WIDTH CATCH_CLARA_CONFIG_CONSOLE_WIDTH
+#endif
+
+#ifndef CLARA_CONFIG_OPTIONAL_TYPE
+#ifdef __has_include
+#if __has_include(<optional>) && __cplusplus >= 201703L
+#include <optional>
+#define CLARA_CONFIG_OPTIONAL_TYPE std::optional
+#endif
+#endif
+#endif
+
+// ----------- #included from clara_textflow.hpp -----------
+
+// TextFlowCpp
+//
+// A single-header library for wrapping and laying out basic text, by Phil Nash
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// This project is hosted at https://github.com/philsquared/textflowcpp
+
+
+#include <cassert>
+#include <ostream>
+#include <sstream>
+#include <vector>
+
+#ifndef CATCH_CLARA_TEXTFLOW_CONFIG_CONSOLE_WIDTH
+#define CATCH_CLARA_TEXTFLOW_CONFIG_CONSOLE_WIDTH 80
+#endif
+
+namespace Catch {
+namespace clara {
+namespace TextFlow {
+
+inline auto isWhitespace(char c) -> bool {
+	static std::string chars = " \t\n\r";
+	return chars.find(c) != std::string::npos;
+}
+inline auto isBreakableBefore(char c) -> bool {
+	static std::string chars = "[({<|";
+	return chars.find(c) != std::string::npos;
+}
+inline auto isBreakableAfter(char c) -> bool {
+	static std::string chars = "])}>.,:;*+-=&/\\";
+	return chars.find(c) != std::string::npos;
+}
+
+class Columns;
+
+class Column {
+	std::vector<std::string> m_strings;
+	size_t m_width = CATCH_CLARA_TEXTFLOW_CONFIG_CONSOLE_WIDTH;
+	size_t m_indent = 0;
+	size_t m_initialIndent = std::string::npos;
+
+public:
+	class iterator {
+		friend Column;
+
+		Column const& m_column;
+		size_t m_stringIndex = 0;
+		size_t m_pos = 0;
+
+		size_t m_len = 0;
+		size_t m_end = 0;
+		bool m_suffix = false;
+
+		iterator(Column const& column, size_t stringIndex)
+			: m_column(column),
+			m_stringIndex(stringIndex) {}
+
+		auto line() const -> std::string const& { return m_column.m_strings[m_stringIndex]; }
+
+		auto isBoundary(size_t at) const -> bool {
+			assert(at > 0);
+			assert(at <= line().size());
+
+			return at == line().size() ||
+				(isWhitespace(line()[at]) && !isWhitespace(line()[at - 1])) ||
+				isBreakableBefore(line()[at]) ||
+				isBreakableAfter(line()[at - 1]);
+		}
+
+		void calcLength() {
+			assert(m_stringIndex < m_column.m_strings.size());
+
+			m_suffix = false;
+			auto width = m_column.m_width - indent();
+			m_end = m_pos;
+			if (line()[m_pos] == '\n') {
+				++m_end;
+			}
+			while (m_end < line().size() && line()[m_end] != '\n')
+				++m_end;
+
+			if (m_end < m_pos + width) {
+				m_len = m_end - m_pos;
+			} else {
+				size_t len = width;
+				while (len > 0 && !isBoundary(m_pos + len))
+					--len;
+				while (len > 0 && isWhitespace(line()[m_pos + len - 1]))
+					--len;
+
+				if (len > 0) {
+					m_len = len;
+				} else {
+					m_suffix = true;
+					m_len = width - 1;
+				}
+			}
+		}
+
+		auto indent() const -> size_t {
+			auto initial = m_pos == 0 && m_stringIndex == 0 ? m_column.m_initialIndent : std::string::npos;
+			return initial == std::string::npos ? m_column.m_indent : initial;
+		}
+
+		auto addIndentAndSuffix(std::string const &plain) const -> std::string {
+			return std::string(indent(), ' ') + (m_suffix ? plain + "-" : plain);
+		}
+
+	public:
+		using difference_type = std::ptrdiff_t;
+		using value_type = std::string;
+		using pointer = value_type * ;
+		using reference = value_type & ;
+		using iterator_category = std::forward_iterator_tag;
+
+		explicit iterator(Column const& column) : m_column(column) {
+			assert(m_column.m_width > m_column.m_indent);
+			assert(m_column.m_initialIndent == std::string::npos || m_column.m_width > m_column.m_initialIndent);
+			calcLength();
+			if (m_len == 0)
+				m_stringIndex++; // Empty string
+		}
+
+		auto operator *() const -> std::string {
+			assert(m_stringIndex < m_column.m_strings.size());
+			assert(m_pos <= m_end);
+			return addIndentAndSuffix(line().substr(m_pos, m_len));
+		}
+
+		auto operator ++() -> iterator& {
+			m_pos += m_len;
+			if (m_pos < line().size() && line()[m_pos] == '\n')
+				m_pos += 1;
+			else
+				while (m_pos < line().size() && isWhitespace(line()[m_pos]))
+					++m_pos;
+
+			if (m_pos == line().size()) {
+				m_pos = 0;
+				++m_stringIndex;
+			}
+			if (m_stringIndex < m_column.m_strings.size())
+				calcLength();
+			return *this;
+		}
+		auto operator ++(int) -> iterator {
+			iterator prev(*this);
+			operator++();
+			return prev;
+		}
+
+		auto operator ==(iterator const& other) const -> bool {
+			return
+				m_pos == other.m_pos &&
+				m_stringIndex == other.m_stringIndex &&
+				&m_column == &other.m_column;
+		}
+		auto operator !=(iterator const& other) const -> bool {
+			return !operator==(other);
+		}
+	};
+	using const_iterator = iterator;
+
+	explicit Column(std::string const& text) { m_strings.push_back(text); }
+
+	auto width(size_t newWidth) -> Column& {
+		assert(newWidth > 0);
+		m_width = newWidth;
+		return *this;
+	}
+	auto indent(size_t newIndent) -> Column& {
+		m_indent = newIndent;
+		return *this;
+	}
+	auto initialIndent(size_t newIndent) -> Column& {
+		m_initialIndent = newIndent;
+		return *this;
+	}
+
+	auto width() const -> size_t { return m_width; }
+	auto begin() const -> iterator { return iterator(*this); }
+	auto end() const -> iterator { return { *this, m_strings.size() }; }
+
+	inline friend std::ostream& operator << (std::ostream& os, Column const& col) {
+		bool first = true;
+		for (auto line : col) {
+			if (first)
+				first = false;
+			else
+				os << "\n";
+			os << line;
+		}
+		return os;
+	}
+
+	auto operator + (Column const& other)->Columns;
+
+	auto toString() const -> std::string {
+		std::ostringstream oss;
+		oss << *this;
+		return oss.str();
+	}
+};
+
+class Spacer : public Column {
+
+public:
+	explicit Spacer(size_t spaceWidth) : Column("") {
+		width(spaceWidth);
+	}
+};
+
+class Columns {
+	std::vector<Column> m_columns;
+
+public:
+
+	class iterator {
+		friend Columns;
+		struct EndTag {};
+
+		std::vector<Column> const& m_columns;
+		std::vector<Column::iterator> m_iterators;
+		size_t m_activeIterators;
+
+		iterator(Columns const& columns, EndTag)
+			: m_columns(columns.m_columns),
+			m_activeIterators(0) {
+			m_iterators.reserve(m_columns.size());
+
+			for (auto const& col : m_columns)
+				m_iterators.push_back(col.end());
+		}
+
+	public:
+		using difference_type = std::ptrdiff_t;
+		using value_type = std::string;
+		using pointer = value_type * ;
+		using reference = value_type & ;
+		using iterator_category = std::forward_iterator_tag;
+
+		explicit iterator(Columns const& columns)
+			: m_columns(columns.m_columns),
+			m_activeIterators(m_columns.size()) {
+			m_iterators.reserve(m_columns.size());
+
+			for (auto const& col : m_columns)
+				m_iterators.push_back(col.begin());
+		}
+
+		auto operator ==(iterator const& other) const -> bool {
+			return m_iterators == other.m_iterators;
+		}
+		auto operator !=(iterator const& other) const -> bool {
+			return m_iterators != other.m_iterators;
+		}
+		auto operator *() const -> std::string {
+			std::string row, padding;
+
+			for (size_t i = 0; i < m_columns.size(); ++i) {
+				auto width = m_columns[i].width();
+				if (m_iterators[i] != m_columns[i].end()) {
+					std::string col = *m_iterators[i];
+					row += padding + col;
+					if (col.size() < width)
+						padding = std::string(width - col.size(), ' ');
+					else
+						padding = "";
+				} else {
+					padding += std::string(width, ' ');
+				}
+			}
+			return row;
+		}
+		auto operator ++() -> iterator& {
+			for (size_t i = 0; i < m_columns.size(); ++i) {
+				if (m_iterators[i] != m_columns[i].end())
+					++m_iterators[i];
+			}
+			return *this;
+		}
+		auto operator ++(int) -> iterator {
+			iterator prev(*this);
+			operator++();
+			return prev;
+		}
+	};
+	using const_iterator = iterator;
+
+	auto begin() const -> iterator { return iterator(*this); }
+	auto end() const -> iterator { return { *this, iterator::EndTag() }; }
+
+	auto operator += (Column const& col) -> Columns& {
+		m_columns.push_back(col);
+		return *this;
+	}
+	auto operator + (Column const& col) -> Columns {
+		Columns combined = *this;
+		combined += col;
+		return combined;
+	}
+
+	inline friend std::ostream& operator << (std::ostream& os, Columns const& cols) {
+
+		bool first = true;
+		for (auto line : cols) {
+			if (first)
+				first = false;
+			else
+				os << "\n";
+			os << line;
+		}
+		return os;
+	}
+
+	auto toString() const -> std::string {
+		std::ostringstream oss;
+		oss << *this;
+		return oss.str();
+	}
+};
+
+inline auto Column::operator + (Column const& other) -> Columns {
+	Columns cols;
+	cols += *this;
+	cols += other;
+	return cols;
+}
+}
+
+}
+}
+
+// ----------- end of #include from clara_textflow.hpp -----------
+// ........... back in clara.hpp
+
+#include <cctype>
+#include <string>
+#include <memory>
+#include <set>
+#include <algorithm>
+
+#if !defined(CATCH_PLATFORM_WINDOWS) && ( defined(WIN32) || defined(__WIN32__) || defined(_WIN32) || defined(_MSC_VER) )
+#define CATCH_PLATFORM_WINDOWS
+#endif
+
+namespace Catch { namespace clara {
+namespace detail {
+
+    // Traits for extracting arg and return type of lambdas (for single argument lambdas)
+    template<typename L>
+    struct UnaryLambdaTraits : UnaryLambdaTraits<decltype( &L::operator() )> {};
+
+    template<typename ClassT, typename ReturnT, typename... Args>
+    struct UnaryLambdaTraits<ReturnT( ClassT::* )( Args... ) const> {
+        static const bool isValid = false;
+    };
+
+    template<typename ClassT, typename ReturnT, typename ArgT>
+    struct UnaryLambdaTraits<ReturnT( ClassT::* )( ArgT ) const> {
+        static const bool isValid = true;
+        using ArgType = typename std::remove_const<typename std::remove_reference<ArgT>::type>::type;
+        using ReturnType = ReturnT;
+    };
+
+    class TokenStream;
+
+    // Transport for raw args (copied from main args, or supplied via init list for testing)
+    class Args {
+        friend TokenStream;
+        std::string m_exeName;
+        std::vector<std::string> m_args;
+
+    public:
+        Args( int argc, char const* const* argv )
+            : m_exeName(argv[0]),
+              m_args(argv + 1, argv + argc) {}
+
+        Args( std::initializer_list<std::string> args )
+        :   m_exeName( *args.begin() ),
+            m_args( args.begin()+1, args.end() )
+        {}
+
+        auto exeName() const -> std::string {
+            return m_exeName;
+        }
+    };
+
+    // Wraps a token coming from a token stream. These may not directly correspond to strings as a single string
+    // may encode an option + its argument if the : or = form is used
+    enum class TokenType {
+        Option, Argument
+    };
+    struct Token {
+        TokenType type;
+        std::string token;
+    };
+
+    inline auto isOptPrefix( char c ) -> bool {
+        return c == '-'
+#ifdef CATCH_PLATFORM_WINDOWS
+            || c == '/'
+#endif
+        ;
+    }
+
+    // Abstracts iterators into args as a stream of tokens, with option arguments uniformly handled
+    class TokenStream {
+        using Iterator = std::vector<std::string>::const_iterator;
+        Iterator it;
+        Iterator itEnd;
+        std::vector<Token> m_tokenBuffer;
+
+        void loadBuffer() {
+            m_tokenBuffer.resize( 0 );
+
+            // Skip any empty strings
+            while( it != itEnd && it->empty() )
+                ++it;
+
+            if( it != itEnd ) {
+                auto const &next = *it;
+                if( isOptPrefix( next[0] ) ) {
+                    auto delimiterPos = next.find_first_of( " :=" );
+                    if( delimiterPos != std::string::npos ) {
+                        m_tokenBuffer.push_back( { TokenType::Option, next.substr( 0, delimiterPos ) } );
+                        m_tokenBuffer.push_back( { TokenType::Argument, next.substr( delimiterPos + 1 ) } );
+                    } else {
+                        if( next[1] != '-' && next.size() > 2 ) {
+                            std::string opt = "- ";
+                            for( size_t i = 1; i < next.size(); ++i ) {
+                                opt[1] = next[i];
+                                m_tokenBuffer.push_back( { TokenType::Option, opt } );
+                            }
+                        } else {
+                            m_tokenBuffer.push_back( { TokenType::Option, next } );
+                        }
+                    }
+                } else {
+                    m_tokenBuffer.push_back( { TokenType::Argument, next } );
+                }
+            }
+        }
+
+    public:
+        explicit TokenStream( Args const &args ) : TokenStream( args.m_args.begin(), args.m_args.end() ) {}
+
+        TokenStream( Iterator it, Iterator itEnd ) : it( it ), itEnd( itEnd ) {
+            loadBuffer();
+        }
+
+        explicit operator bool() const {
+            return !m_tokenBuffer.empty() || it != itEnd;
+        }
+
+        auto count() const -> size_t { return m_tokenBuffer.size() + (itEnd - it); }
+
+        auto operator*() const -> Token {
+            assert( !m_tokenBuffer.empty() );
+            return m_tokenBuffer.front();
+        }
+
+        auto operator->() const -> Token const * {
+            assert( !m_tokenBuffer.empty() );
+            return &m_tokenBuffer.front();
+        }
+
+        auto operator++() -> TokenStream & {
+            if( m_tokenBuffer.size() >= 2 ) {
+                m_tokenBuffer.erase( m_tokenBuffer.begin() );
+            } else {
+                if( it != itEnd )
+                    ++it;
+                loadBuffer();
+            }
+            return *this;
+        }
+    };
+
+    class ResultBase {
+    public:
+        enum Type {
+            Ok, LogicError, RuntimeError
+        };
+
+    protected:
+        ResultBase( Type type ) : m_type( type ) {}
+        virtual ~ResultBase() = default;
+
+        virtual void enforceOk() const = 0;
+
+        Type m_type;
+    };
+
+    template<typename T>
+    class ResultValueBase : public ResultBase {
+    public:
+        auto value() const -> T const & {
+            enforceOk();
+            return m_value;
+        }
+
+    protected:
+        ResultValueBase( Type type ) : ResultBase( type ) {}
+
+        ResultValueBase( ResultValueBase const &other ) : ResultBase( other ) {
+            if( m_type == ResultBase::Ok )
+                new( &m_value ) T( other.m_value );
+        }
+
+        ResultValueBase( Type, T const &value ) : ResultBase( Ok ) {
+            new( &m_value ) T( value );
+        }
+
+        auto operator=( ResultValueBase const &other ) -> ResultValueBase & {
+            if( m_type == ResultBase::Ok )
+                m_value.~T();
+            ResultBase::operator=(other);
+            if( m_type == ResultBase::Ok )
+                new( &m_value ) T( other.m_value );
+            return *this;
+        }
+
+        ~ResultValueBase() override {
+            if( m_type == Ok )
+                m_value.~T();
+        }
+
+        union {
+            T m_value;
+        };
+    };
+
+    template<>
+    class ResultValueBase<void> : public ResultBase {
+    protected:
+        using ResultBase::ResultBase;
+    };
+
+    template<typename T = void>
+    class BasicResult : public ResultValueBase<T> {
+    public:
+        template<typename U>
+        explicit BasicResult( BasicResult<U> const &other )
+        :   ResultValueBase<T>( other.type() ),
+            m_errorMessage( other.errorMessage() )
+        {
+            assert( type() != ResultBase::Ok );
+        }
+
+        template<typename U>
+        static auto ok( U const &value ) -> BasicResult { return { ResultBase::Ok, value }; }
+        static auto ok() -> BasicResult { return { ResultBase::Ok }; }
+        static auto logicError( std::string const &message ) -> BasicResult { return { ResultBase::LogicError, message }; }
+        static auto runtimeError( std::string const &message ) -> BasicResult { return { ResultBase::RuntimeError, message }; }
+
+        explicit operator bool() const { return m_type == ResultBase::Ok; }
+        auto type() const -> ResultBase::Type { return m_type; }
+        auto errorMessage() const -> std::string { return m_errorMessage; }
+
+    protected:
+        void enforceOk() const override {
+
+            // Errors shouldn't reach this point, but if they do
+            // the actual error message will be in m_errorMessage
+            assert( m_type != ResultBase::LogicError );
+            assert( m_type != ResultBase::RuntimeError );
+            if( m_type != ResultBase::Ok )
+                std::abort();
+        }
+
+        std::string m_errorMessage; // Only populated if resultType is an error
+
+        BasicResult( ResultBase::Type type, std::string const &message )
+        :   ResultValueBase<T>(type),
+            m_errorMessage(message)
+        {
+            assert( m_type != ResultBase::Ok );
+        }
+
+        using ResultValueBase<T>::ResultValueBase;
+        using ResultBase::m_type;
+    };
+
+    enum class ParseResultType {
+        Matched, NoMatch, ShortCircuitAll, ShortCircuitSame
+    };
+
+    class ParseState {
+    public:
+
+        ParseState( ParseResultType type, TokenStream const &remainingTokens )
+        : m_type(type),
+          m_remainingTokens( remainingTokens )
+        {}
+
+        auto type() const -> ParseResultType { return m_type; }
+        auto remainingTokens() const -> TokenStream { return m_remainingTokens; }
+
+    private:
+        ParseResultType m_type;
+        TokenStream m_remainingTokens;
+    };
+
+    using Result = BasicResult<void>;
+    using ParserResult = BasicResult<ParseResultType>;
+    using InternalParseResult = BasicResult<ParseState>;
+
+    struct HelpColumns {
+        std::string left;
+        std::string right;
+    };
+
+    template<typename T>
+    inline auto convertInto( std::string const &source, T& target ) -> ParserResult {
+        std::stringstream ss;
+        ss << source;
+        ss >> target;
+        if( ss.fail() )
+            return ParserResult::runtimeError( "Unable to convert '" + source + "' to destination type" );
+        else
+            return ParserResult::ok( ParseResultType::Matched );
+    }
+    inline auto convertInto( std::string const &source, std::string& target ) -> ParserResult {
+        target = source;
+        return ParserResult::ok( ParseResultType::Matched );
+    }
+    inline auto convertInto( std::string const &source, bool &target ) -> ParserResult {
+        std::string srcLC = source;
+        std::transform( srcLC.begin(), srcLC.end(), srcLC.begin(), []( unsigned char c ) { return static_cast<char>( std::tolower(c) ); } );
+        if (srcLC == "y" || srcLC == "1" || srcLC == "true" || srcLC == "yes" || srcLC == "on")
+            target = true;
+        else if (srcLC == "n" || srcLC == "0" || srcLC == "false" || srcLC == "no" || srcLC == "off")
+            target = false;
+        else
+            return ParserResult::runtimeError( "Expected a boolean value but did not recognise: '" + source + "'" );
+        return ParserResult::ok( ParseResultType::Matched );
+    }
+#ifdef CLARA_CONFIG_OPTIONAL_TYPE
+    template<typename T>
+    inline auto convertInto( std::string const &source, CLARA_CONFIG_OPTIONAL_TYPE<T>& target ) -> ParserResult {
+        T temp;
+        auto result = convertInto( source, temp );
+        if( result )
+            target = std::move(temp);
+        return result;
+    }
+#endif // CLARA_CONFIG_OPTIONAL_TYPE
+
+    struct NonCopyable {
+        NonCopyable() = default;
+        NonCopyable( NonCopyable const & ) = delete;
+        NonCopyable( NonCopyable && ) = delete;
+        NonCopyable &operator=( NonCopyable const & ) = delete;
+        NonCopyable &operator=( NonCopyable && ) = delete;
+    };
+
+    struct BoundRef : NonCopyable {
+        virtual ~BoundRef() = default;
+        virtual auto isContainer() const -> bool { return false; }
+        virtual auto isFlag() const -> bool { return false; }
+    };
+    struct BoundValueRefBase : BoundRef {
+        virtual auto setValue( std::string const &arg ) -> ParserResult = 0;
+    };
+    struct BoundFlagRefBase : BoundRef {
+        virtual auto setFlag( bool flag ) -> ParserResult = 0;
+        virtual auto isFlag() const -> bool { return true; }
+    };
+
+    template<typename T>
+    struct BoundValueRef : BoundValueRefBase {
+        T &m_ref;
+
+        explicit BoundValueRef( T &ref ) : m_ref( ref ) {}
+
+        auto setValue( std::string const &arg ) -> ParserResult override {
+            return convertInto( arg, m_ref );
+        }
+    };
+
+    template<typename T>
+    struct BoundValueRef<std::vector<T>> : BoundValueRefBase {
+        std::vector<T> &m_ref;
+
+        explicit BoundValueRef( std::vector<T> &ref ) : m_ref( ref ) {}
+
+        auto isContainer() const -> bool override { return true; }
+
+        auto setValue( std::string const &arg ) -> ParserResult override {
+            T temp;
+            auto result = convertInto( arg, temp );
+            if( result )
+                m_ref.push_back( temp );
+            return result;
+        }
+    };
+
+    struct BoundFlagRef : BoundFlagRefBase {
+        bool &m_ref;
+
+        explicit BoundFlagRef( bool &ref ) : m_ref( ref ) {}
+
+        auto setFlag( bool flag ) -> ParserResult override {
+            m_ref = flag;
+            return ParserResult::ok( ParseResultType::Matched );
+        }
+    };
+
+    template<typename ReturnType>
+    struct LambdaInvoker {
+        static_assert( std::is_same<ReturnType, ParserResult>::value, "Lambda must return void or clara::ParserResult" );
+
+        template<typename L, typename ArgType>
+        static auto invoke( L const &lambda, ArgType const &arg ) -> ParserResult {
+            return lambda( arg );
+        }
+    };
+
+    template<>
+    struct LambdaInvoker<void> {
+        template<typename L, typename ArgType>
+        static auto invoke( L const &lambda, ArgType const &arg ) -> ParserResult {
+            lambda( arg );
+            return ParserResult::ok( ParseResultType::Matched );
+        }
+    };
+
+    template<typename ArgType, typename L>
+    inline auto invokeLambda( L const &lambda, std::string const &arg ) -> ParserResult {
+        ArgType temp{};
+        auto result = convertInto( arg, temp );
+        return !result
+           ? result
+           : LambdaInvoker<typename UnaryLambdaTraits<L>::ReturnType>::invoke( lambda, temp );
+    }
+
+    template<typename L>
+    struct BoundLambda : BoundValueRefBase {
+        L m_lambda;
+
+        static_assert( UnaryLambdaTraits<L>::isValid, "Supplied lambda must take exactly one argument" );
+        explicit BoundLambda( L const &lambda ) : m_lambda( lambda ) {}
+
+        auto setValue( std::string const &arg ) -> ParserResult override {
+            return invokeLambda<typename UnaryLambdaTraits<L>::ArgType>( m_lambda, arg );
+        }
+    };
+
+    template<typename L>
+    struct BoundFlagLambda : BoundFlagRefBase {
+        L m_lambda;
+
+        static_assert( UnaryLambdaTraits<L>::isValid, "Supplied lambda must take exactly one argument" );
+        static_assert( std::is_same<typename UnaryLambdaTraits<L>::ArgType, bool>::value, "flags must be boolean" );
+
+        explicit BoundFlagLambda( L const &lambda ) : m_lambda( lambda ) {}
+
+        auto setFlag( bool flag ) -> ParserResult override {
+            return LambdaInvoker<typename UnaryLambdaTraits<L>::ReturnType>::invoke( m_lambda, flag );
+        }
+    };
+
+    enum class Optionality { Optional, Required };
+
+    struct Parser;
+
+    class ParserBase {
+    public:
+        virtual ~ParserBase() = default;
+        virtual auto validate() const -> Result { return Result::ok(); }
+        virtual auto parse( std::string const& exeName, TokenStream const &tokens) const -> InternalParseResult  = 0;
+        virtual auto cardinality() const -> size_t { return 1; }
+
+        auto parse( Args const &args ) const -> InternalParseResult {
+            return parse( args.exeName(), TokenStream( args ) );
+        }
+    };
+
+    template<typename DerivedT>
+    class ComposableParserImpl : public ParserBase {
+    public:
+        template<typename T>
+        auto operator|( T const &other ) const -> Parser;
+
+		template<typename T>
+        auto operator+( T const &other ) const -> Parser;
+    };
+
+    // Common code and state for Args and Opts
+    template<typename DerivedT>
+    class ParserRefImpl : public ComposableParserImpl<DerivedT> {
+    protected:
+        Optionality m_optionality = Optionality::Optional;
+        std::shared_ptr<BoundRef> m_ref;
+        std::string m_hint;
+        std::string m_description;
+
+        explicit ParserRefImpl( std::shared_ptr<BoundRef> const &ref ) : m_ref( ref ) {}
+
+    public:
+        template<typename T>
+        ParserRefImpl( T &ref, std::string const &hint )
+        :   m_ref( std::make_shared<BoundValueRef<T>>( ref ) ),
+            m_hint( hint )
+        {}
+
+        template<typename LambdaT>
+        ParserRefImpl( LambdaT const &ref, std::string const &hint )
+        :   m_ref( std::make_shared<BoundLambda<LambdaT>>( ref ) ),
+            m_hint(hint)
+        {}
+
+        auto operator()( std::string const &description ) -> DerivedT & {
+            m_description = description;
+            return static_cast<DerivedT &>( *this );
+        }
+
+        auto optional() -> DerivedT & {
+            m_optionality = Optionality::Optional;
+            return static_cast<DerivedT &>( *this );
+        };
+
+        auto required() -> DerivedT & {
+            m_optionality = Optionality::Required;
+            return static_cast<DerivedT &>( *this );
+        };
+
+        auto isOptional() const -> bool {
+            return m_optionality == Optionality::Optional;
+        }
+
+        auto cardinality() const -> size_t override {
+            if( m_ref->isContainer() )
+                return 0;
+            else
+                return 1;
+        }
+
+        auto hint() const -> std::string { return m_hint; }
+    };
+
+    class ExeName : public ComposableParserImpl<ExeName> {
+        std::shared_ptr<std::string> m_name;
+        std::shared_ptr<BoundValueRefBase> m_ref;
+
+        template<typename LambdaT>
+        static auto makeRef(LambdaT const &lambda) -> std::shared_ptr<BoundValueRefBase> {
+            return std::make_shared<BoundLambda<LambdaT>>( lambda) ;
+        }
+
+    public:
+        ExeName() : m_name( std::make_shared<std::string>( "<executable>" ) ) {}
+
+        explicit ExeName( std::string &ref ) : ExeName() {
+            m_ref = std::make_shared<BoundValueRef<std::string>>( ref );
+        }
+
+        template<typename LambdaT>
+        explicit ExeName( LambdaT const& lambda ) : ExeName() {
+            m_ref = std::make_shared<BoundLambda<LambdaT>>( lambda );
+        }
+
+        // The exe name is not parsed out of the normal tokens, but is handled specially
+        auto parse( std::string const&, TokenStream const &tokens ) const -> InternalParseResult override {
+            return InternalParseResult::ok( ParseState( ParseResultType::NoMatch, tokens ) );
+        }
+
+        auto name() const -> std::string { return *m_name; }
+        auto set( std::string const& newName ) -> ParserResult {
+
+            auto lastSlash = newName.find_last_of( "\\/" );
+            auto filename = ( lastSlash == std::string::npos )
+                    ? newName
+                    : newName.substr( lastSlash+1 );
+
+            *m_name = filename;
+            if( m_ref )
+                return m_ref->setValue( filename );
+            else
+                return ParserResult::ok( ParseResultType::Matched );
+        }
+    };
+
+    class Arg : public ParserRefImpl<Arg> {
+    public:
+        using ParserRefImpl::ParserRefImpl;
+
+        auto parse( std::string const &, TokenStream const &tokens ) const -> InternalParseResult override {
+            auto validationResult = validate();
+            if( !validationResult )
+                return InternalParseResult( validationResult );
+
+            auto remainingTokens = tokens;
+            auto const &token = *remainingTokens;
+            if( token.type != TokenType::Argument )
+                return InternalParseResult::ok( ParseState( ParseResultType::NoMatch, remainingTokens ) );
+
+            assert( !m_ref->isFlag() );
+            auto valueRef = static_cast<detail::BoundValueRefBase*>( m_ref.get() );
+
+            auto result = valueRef->setValue( remainingTokens->token );
+            if( !result )
+                return InternalParseResult( result );
+            else
+                return InternalParseResult::ok( ParseState( ParseResultType::Matched, ++remainingTokens ) );
+        }
+    };
+
+    inline auto normaliseOpt( std::string const &optName ) -> std::string {
+#ifdef CATCH_PLATFORM_WINDOWS
+        if( optName[0] == '/' )
+            return "-" + optName.substr( 1 );
+        else
+#endif
+            return optName;
+    }
+
+    class Opt : public ParserRefImpl<Opt> {
+    protected:
+        std::vector<std::string> m_optNames;
+
+    public:
+        template<typename LambdaT>
+        explicit Opt( LambdaT const &ref ) : ParserRefImpl( std::make_shared<BoundFlagLambda<LambdaT>>( ref ) ) {}
+
+        explicit Opt( bool &ref ) : ParserRefImpl( std::make_shared<BoundFlagRef>( ref ) ) {}
+
+        template<typename LambdaT>
+        Opt( LambdaT const &ref, std::string const &hint ) : ParserRefImpl( ref, hint ) {}
+
+        template<typename T>
+        Opt( T &ref, std::string const &hint ) : ParserRefImpl( ref, hint ) {}
+
+        auto operator[]( std::string const &optName ) -> Opt & {
+            m_optNames.push_back( optName );
+            return *this;
+        }
+
+        auto getHelpColumns() const -> std::vector<HelpColumns> {
+            std::ostringstream oss;
+            bool first = true;
+            for( auto const &opt : m_optNames ) {
+                if (first)
+                    first = false;
+                else
+                    oss << ", ";
+                oss << opt;
+            }
+            if( !m_hint.empty() )
+                oss << " <" << m_hint << ">";
+            return { { oss.str(), m_description } };
+        }
+
+        auto isMatch( std::string const &optToken ) const -> bool {
+            auto normalisedToken = normaliseOpt( optToken );
+            for( auto const &name : m_optNames ) {
+                if( normaliseOpt( name ) == normalisedToken )
+                    return true;
+            }
+            return false;
+        }
+
+        using ParserBase::parse;
+
+        auto parse( std::string const&, TokenStream const &tokens ) const -> InternalParseResult override {
+            auto validationResult = validate();
+            if( !validationResult )
+                return InternalParseResult( validationResult );
+
+            auto remainingTokens = tokens;
+            if( remainingTokens && remainingTokens->type == TokenType::Option ) {
+                auto const &token = *remainingTokens;
+                if( isMatch(token.token ) ) {
+                    if( m_ref->isFlag() ) {
+                        auto flagRef = static_cast<detail::BoundFlagRefBase*>( m_ref.get() );
+                        auto result = flagRef->setFlag( true );
+                        if( !result )
+                            return InternalParseResult( result );
+                        if( result.value() == ParseResultType::ShortCircuitAll )
+                            return InternalParseResult::ok( ParseState( result.value(), remainingTokens ) );
+                    } else {
+                        auto valueRef = static_cast<detail::BoundValueRefBase*>( m_ref.get() );
+                        ++remainingTokens;
+                        if( !remainingTokens )
+                            return InternalParseResult::runtimeError( "Expected argument following " + token.token );
+                        auto const &argToken = *remainingTokens;
+                        if( argToken.type != TokenType::Argument )
+                            return InternalParseResult::runtimeError( "Expected argument following " + token.token );
+                        auto result = valueRef->setValue( argToken.token );
+                        if( !result )
+                            return InternalParseResult( result );
+                        if( result.value() == ParseResultType::ShortCircuitAll )
+                            return InternalParseResult::ok( ParseState( result.value(), remainingTokens ) );
+                    }
+                    return InternalParseResult::ok( ParseState( ParseResultType::Matched, ++remainingTokens ) );
+                }
+            }
+            return InternalParseResult::ok( ParseState( ParseResultType::NoMatch, remainingTokens ) );
+        }
+
+        auto validate() const -> Result override {
+            if( m_optNames.empty() )
+                return Result::logicError( "No options supplied to Opt" );
+            for( auto const &name : m_optNames ) {
+                if( name.empty() )
+                    return Result::logicError( "Option name cannot be empty" );
+#ifdef CATCH_PLATFORM_WINDOWS
+                if( name[0] != '-' && name[0] != '/' )
+                    return Result::logicError( "Option name must begin with '-' or '/'" );
+#else
+                if( name[0] != '-' )
+                    return Result::logicError( "Option name must begin with '-'" );
+#endif
+            }
+            return ParserRefImpl::validate();
+        }
+    };
+
+    struct Help : Opt {
+        Help( bool &showHelpFlag )
+        :   Opt([&]( bool flag ) {
+                showHelpFlag = flag;
+                return ParserResult::ok( ParseResultType::ShortCircuitAll );
+            })
+        {
+            static_cast<Opt &>( *this )
+                    ("display usage information")
+                    ["-?"]["-h"]["--help"]
+                    .optional();
+        }
+    };
+
+    struct Parser : ParserBase {
+
+        mutable ExeName m_exeName;
+        std::vector<Opt> m_options;
+        std::vector<Arg> m_args;
+
+        auto operator|=( ExeName const &exeName ) -> Parser & {
+            m_exeName = exeName;
+            return *this;
+        }
+
+        auto operator|=( Arg const &arg ) -> Parser & {
+            m_args.push_back(arg);
+            return *this;
+        }
+
+        auto operator|=( Opt const &opt ) -> Parser & {
+            m_options.push_back(opt);
+            return *this;
+        }
+
+        auto operator|=( Parser const &other ) -> Parser & {
+            m_options.insert(m_options.end(), other.m_options.begin(), other.m_options.end());
+            m_args.insert(m_args.end(), other.m_args.begin(), other.m_args.end());
+            return *this;
+        }
+
+        template<typename T>
+        auto operator|( T const &other ) const -> Parser {
+            return Parser( *this ) |= other;
+        }
+
+        // Forward deprecated interface with '+' instead of '|'
+        template<typename T>
+        auto operator+=( T const &other ) -> Parser & { return operator|=( other ); }
+        template<typename T>
+        auto operator+( T const &other ) const -> Parser { return operator|( other ); }
+
+        auto getHelpColumns() const -> std::vector<HelpColumns> {
+            std::vector<HelpColumns> cols;
+            for (auto const &o : m_options) {
+                auto childCols = o.getHelpColumns();
+                cols.insert( cols.end(), childCols.begin(), childCols.end() );
+            }
+            return cols;
+        }
+
+        void writeToStream( std::ostream &os ) const {
+            if (!m_exeName.name().empty()) {
+                os << "usage:\n" << "  " << m_exeName.name() << " ";
+                bool required = true, first = true;
+                for( auto const &arg : m_args ) {
+                    if (first)
+                        first = false;
+                    else
+                        os << " ";
+                    if( arg.isOptional() && required ) {
+                        os << "[";
+                        required = false;
+                    }
+                    os << "<" << arg.hint() << ">";
+                    if( arg.cardinality() == 0 )
+                        os << " ... ";
+                }
+                if( !required )
+                    os << "]";
+                if( !m_options.empty() )
+                    os << " options";
+                os << "\n\nwhere options are:" << std::endl;
+            }
+
+            auto rows = getHelpColumns();
+            size_t consoleWidth = CATCH_CLARA_CONFIG_CONSOLE_WIDTH;
+            size_t optWidth = 0;
+            for( auto const &cols : rows )
+                optWidth = (std::max)(optWidth, cols.left.size() + 2);
+
+            optWidth = (std::min)(optWidth, consoleWidth/2);
+
+            for( auto const &cols : rows ) {
+                auto row =
+                        TextFlow::Column( cols.left ).width( optWidth ).indent( 2 ) +
+                        TextFlow::Spacer(4) +
+                        TextFlow::Column( cols.right ).width( consoleWidth - 7 - optWidth );
+                os << row << std::endl;
+            }
+        }
+
+        friend auto operator<<( std::ostream &os, Parser const &parser ) -> std::ostream& {
+            parser.writeToStream( os );
+            return os;
+        }
+
+        auto validate() const -> Result override {
+            for( auto const &opt : m_options ) {
+                auto result = opt.validate();
+                if( !result )
+                    return result;
+            }
+            for( auto const &arg : m_args ) {
+                auto result = arg.validate();
+                if( !result )
+                    return result;
+            }
+            return Result::ok();
+        }
+
+        using ParserBase::parse;
+
+        auto parse( std::string const& exeName, TokenStream const &tokens ) const -> InternalParseResult override {
+
+            struct ParserInfo {
+                ParserBase const* parser = nullptr;
+                size_t count = 0;
+            };
+            const size_t totalParsers = m_options.size() + m_args.size();
+            assert( totalParsers < 512 );
+            // ParserInfo parseInfos[totalParsers]; // <-- this is what we really want to do
+            ParserInfo parseInfos[512];
+
+            {
+                size_t i = 0;
+                for (auto const &opt : m_options) parseInfos[i++].parser = &opt;
+                for (auto const &arg : m_args) parseInfos[i++].parser = &arg;
+            }
+
+            m_exeName.set( exeName );
+
+            auto result = InternalParseResult::ok( ParseState( ParseResultType::NoMatch, tokens ) );
+            while( result.value().remainingTokens() ) {
+                bool tokenParsed = false;
+
+                for( size_t i = 0; i < totalParsers; ++i ) {
+                    auto&  parseInfo = parseInfos[i];
+                    if( parseInfo.parser->cardinality() == 0 || parseInfo.count < parseInfo.parser->cardinality() ) {
+                        result = parseInfo.parser->parse(exeName, result.value().remainingTokens());
+                        if (!result)
+                            return result;
+                        if (result.value().type() != ParseResultType::NoMatch) {
+                            tokenParsed = true;
+                            ++parseInfo.count;
+                            break;
+                        }
+                    }
+                }
+
+                if( result.value().type() == ParseResultType::ShortCircuitAll )
+                    return result;
+                if( !tokenParsed )
+                    return InternalParseResult::runtimeError( "Unrecognised token: " + result.value().remainingTokens()->token );
+            }
+            // !TBD Check missing required options
+            return result;
+        }
+    };
+
+    template<typename DerivedT>
+    template<typename T>
+    auto ComposableParserImpl<DerivedT>::operator|( T const &other ) const -> Parser {
+        return Parser() | static_cast<DerivedT const &>( *this ) | other;
+    }
+} // namespace detail
+
+// A Combined parser
+using detail::Parser;
+
+// A parser for options
+using detail::Opt;
+
+// A parser for arguments
+using detail::Arg;
+
+// Wrapper for argc, argv from main()
+using detail::Args;
+
+// Specifies the name of the executable
+using detail::ExeName;
+
+// Convenience wrapper for option parser that specifies the help option
+using detail::Help;
+
+// enum of result types from a parse
+using detail::ParseResultType;
+
+// Result type for parser operation
+using detail::ParserResult;
+
+}} // namespace Catch::clara
+
+// end clara.hpp
+#ifdef __clang__
+#pragma clang diagnostic pop
+#endif
+
+// Restore Clara's value for console width, if present
+#ifdef CATCH_TEMP_CLARA_CONFIG_CONSOLE_WIDTH
+#define CATCH_CLARA_TEXTFLOW_CONFIG_CONSOLE_WIDTH CATCH_TEMP_CLARA_CONFIG_CONSOLE_WIDTH
+#undef CATCH_TEMP_CLARA_CONFIG_CONSOLE_WIDTH
+#endif
+
+// end catch_clara.h
+namespace Catch {
+
+    clara::Parser makeCommandLineParser( ConfigData& config );
+
+} // end namespace Catch
+
+// end catch_commandline.h
+#include <fstream>
+#include <ctime>
+
+namespace Catch {
+
+    clara::Parser makeCommandLineParser( ConfigData& config ) {
+
+        using namespace clara;
+
+        auto const setWarning = [&]( std::string const& warning ) {
+                auto warningSet = [&]() {
+                    if( warning == "NoAssertions" )
+                        return WarnAbout::NoAssertions;
+
+                    if ( warning == "NoTests" )
+                        return WarnAbout::NoTests;
+
+                    return WarnAbout::Nothing;
+                }();
+
+                if (warningSet == WarnAbout::Nothing)
+                    return ParserResult::runtimeError( "Unrecognised warning: '" + warning + "'" );
+                config.warnings = static_cast<WarnAbout::What>( config.warnings | warningSet );
+                return ParserResult::ok( ParseResultType::Matched );
+            };
+        auto const loadTestNamesFromFile = [&]( std::string const& filename ) {
+                std::ifstream f( filename.c_str() );
+                if( !f.is_open() )
+                    return ParserResult::runtimeError( "Unable to load input file: '" + filename + "'" );
+
+                std::string line;
+                while( std::getline( f, line ) ) {
+                    line = trim(line);
+                    if( !line.empty() && !startsWith( line, '#' ) ) {
+                        if( !startsWith( line, '"' ) )
+                            line = '"' + line + '"';
+                        config.testsOrTags.push_back( line );
+                        config.testsOrTags.emplace_back( "," );
+                    }
+                }
+                //Remove comma in the end
+                if(!config.testsOrTags.empty())
+                    config.testsOrTags.erase( config.testsOrTags.end()-1 );
+
+                return ParserResult::ok( ParseResultType::Matched );
+            };
+        auto const setTestOrder = [&]( std::string const& order ) {
+                if( startsWith( "declared", order ) )
+                    config.runOrder = RunTests::InDeclarationOrder;
+                else if( startsWith( "lexical", order ) )
+                    config.runOrder = RunTests::InLexicographicalOrder;
+                else if( startsWith( "random", order ) )
+                    config.runOrder = RunTests::InRandomOrder;
+                else
+                    return clara::ParserResult::runtimeError( "Unrecognised ordering: '" + order + "'" );
+                return ParserResult::ok( ParseResultType::Matched );
+            };
+        auto const setRngSeed = [&]( std::string const& seed ) {
+                if( seed != "time" )
+                    return clara::detail::convertInto( seed, config.rngSeed );
+                config.rngSeed = static_cast<unsigned int>( std::time(nullptr) );
+                return ParserResult::ok( ParseResultType::Matched );
+            };
+        auto const setColourUsage = [&]( std::string const& useColour ) {
+                    auto mode = toLower( useColour );
+
+                    if( mode == "yes" )
+                        config.useColour = UseColour::Yes;
+                    else if( mode == "no" )
+                        config.useColour = UseColour::No;
+                    else if( mode == "auto" )
+                        config.useColour = UseColour::Auto;
+                    else
+                        return ParserResult::runtimeError( "colour mode must be one of: auto, yes or no. '" + useColour + "' not recognised" );
+                return ParserResult::ok( ParseResultType::Matched );
+            };
+        auto const setWaitForKeypress = [&]( std::string const& keypress ) {
+                auto keypressLc = toLower( keypress );
+                if (keypressLc == "never")
+                    config.waitForKeypress = WaitForKeypress::Never;
+                else if( keypressLc == "start" )
+                    config.waitForKeypress = WaitForKeypress::BeforeStart;
+                else if( keypressLc == "exit" )
+                    config.waitForKeypress = WaitForKeypress::BeforeExit;
+                else if( keypressLc == "both" )
+                    config.waitForKeypress = WaitForKeypress::BeforeStartAndExit;
+                else
+                    return ParserResult::runtimeError( "keypress argument must be one of: never, start, exit or both. '" + keypress + "' not recognised" );
+            return ParserResult::ok( ParseResultType::Matched );
+            };
+        auto const setVerbosity = [&]( std::string const& verbosity ) {
+            auto lcVerbosity = toLower( verbosity );
+            if( lcVerbosity == "quiet" )
+                config.verbosity = Verbosity::Quiet;
+            else if( lcVerbosity == "normal" )
+                config.verbosity = Verbosity::Normal;
+            else if( lcVerbosity == "high" )
+                config.verbosity = Verbosity::High;
+            else
+                return ParserResult::runtimeError( "Unrecognised verbosity, '" + verbosity + "'" );
+            return ParserResult::ok( ParseResultType::Matched );
+        };
+        auto const setReporter = [&]( std::string const& reporter ) {
+            IReporterRegistry::FactoryMap const& factories = getRegistryHub().getReporterRegistry().getFactories();
+
+            auto lcReporter = toLower( reporter );
+            auto result = factories.find( lcReporter );
+
+            if( factories.end() != result )
+                config.reporterName = lcReporter;
+            else
+                return ParserResult::runtimeError( "Unrecognized reporter, '" + reporter + "'. Check available with --list-reporters" );
+            return ParserResult::ok( ParseResultType::Matched );
+        };
+
+        auto cli
+            = ExeName( config.processName )
+            | Help( config.showHelp )
+            | Opt( config.listTests )
+                ["-l"]["--list-tests"]
+                ( "list all/matching test cases" )
+            | Opt( config.listTags )
+                ["-t"]["--list-tags"]
+                ( "list all/matching tags" )
+            | Opt( config.showSuccessfulTests )
+                ["-s"]["--success"]
+                ( "include successful tests in output" )
+            | Opt( config.shouldDebugBreak )
+                ["-b"]["--break"]
+                ( "break into debugger on failure" )
+            | Opt( config.noThrow )
+                ["-e"]["--nothrow"]
+                ( "skip exception tests" )
+            | Opt( config.showInvisibles )
+                ["-i"]["--invisibles"]
+                ( "show invisibles (tabs, newlines)" )
+            | Opt( config.outputFilename, "filename" )
+                ["-o"]["--out"]
+                ( "output filename" )
+            | Opt( setReporter, "name" )
+                ["-r"]["--reporter"]
+                ( "reporter to use (defaults to console)" )
+            | Opt( config.name, "name" )
+                ["-n"]["--name"]
+                ( "suite name" )
+            | Opt( [&]( bool ){ config.abortAfter = 1; } )
+                ["-a"]["--abort"]
+                ( "abort at first failure" )
+            | Opt( [&]( int x ){ config.abortAfter = x; }, "no. failures" )
+                ["-x"]["--abortx"]
+                ( "abort after x failures" )
+            | Opt( setWarning, "warning name" )
+                ["-w"]["--warn"]
+                ( "enable warnings" )
+            | Opt( [&]( bool flag ) { config.showDurations = flag ? ShowDurations::Always : ShowDurations::Never; }, "yes|no" )
+                ["-d"]["--durations"]
+                ( "show test durations" )
+            | Opt( config.minDuration, "seconds" )
+                ["-D"]["--min-duration"]
+                ( "show test durations for tests taking at least the given number of seconds" )
+            | Opt( loadTestNamesFromFile, "filename" )
+                ["-f"]["--input-file"]
+                ( "load test names to run from a file" )
+            | Opt( config.filenamesAsTags )
+                ["-#"]["--filenames-as-tags"]
+                ( "adds a tag for the filename" )
+            | Opt( config.sectionsToRun, "section name" )
+                ["-c"]["--section"]
+                ( "specify section to run" )
+            | Opt( setVerbosity, "quiet|normal|high" )
+                ["-v"]["--verbosity"]
+                ( "set output verbosity" )
+            | Opt( config.listTestNamesOnly )
+                ["--list-test-names-only"]
+                ( "list all/matching test cases names only" )
+            | Opt( config.listReporters )
+                ["--list-reporters"]
+                ( "list all reporters" )
+            | Opt( setTestOrder, "decl|lex|rand" )
+                ["--order"]
+                ( "test case order (defaults to decl)" )
+            | Opt( setRngSeed, "'time'|number" )
+                ["--rng-seed"]
+                ( "set a specific seed for random numbers" )
+            | Opt( setColourUsage, "yes|no" )
+                ["--use-colour"]
+                ( "should output be colourised" )
+            | Opt( config.libIdentify )
+                ["--libidentify"]
+                ( "report name and version according to libidentify standard" )
+            | Opt( setWaitForKeypress, "never|start|exit|both" )
+                ["--wait-for-keypress"]
+                ( "waits for a keypress before exiting" )
+            | Opt( config.benchmarkSamples, "samples" )
+                ["--benchmark-samples"]
+                ( "number of samples to collect (default: 100)" )
+            | Opt( config.benchmarkResamples, "resamples" )
+                ["--benchmark-resamples"]
+                ( "number of resamples for the bootstrap (default: 100000)" )
+            | Opt( config.benchmarkConfidenceInterval, "confidence interval" )
+                ["--benchmark-confidence-interval"]
+                ( "confidence interval for the bootstrap (between 0 and 1, default: 0.95)" )
+            | Opt( config.benchmarkNoAnalysis )
+                ["--benchmark-no-analysis"]
+                ( "perform only measurements; do not perform any analysis" )
+            | Opt( config.benchmarkWarmupTime, "benchmarkWarmupTime" )
+                ["--benchmark-warmup-time"]
+                ( "amount of time in milliseconds spent on warming up each test (default: 100)" )
+            | Arg( config.testsOrTags, "test name|pattern|tags" )
+                ( "which test or tests to use" );
+
+        return cli;
+    }
+
+} // end namespace Catch
+// end catch_commandline.cpp
+// start catch_common.cpp
+
+#include <cstring>
+#include <ostream>
+
+namespace Catch {
+
+    bool SourceLineInfo::operator == ( SourceLineInfo const& other ) const noexcept {
+        return line == other.line && (file == other.file || std::strcmp(file, other.file) == 0);
+    }
+    bool SourceLineInfo::operator < ( SourceLineInfo const& other ) const noexcept {
+        // We can assume that the same file will usually have the same pointer.
+        // Thus, if the pointers are the same, there is no point in calling the strcmp
+        return line < other.line || ( line == other.line && file != other.file && (std::strcmp(file, other.file) < 0));
+    }
+
+    std::ostream& operator << ( std::ostream& os, SourceLineInfo const& info ) {
+#ifndef __GNUG__
+        os << info.file << '(' << info.line << ')';
+#else
+        os << info.file << ':' << info.line;
+#endif
+        return os;
+    }
+
+    std::string StreamEndStop::operator+() const {
+        return std::string();
+    }
+
+    NonCopyable::NonCopyable() = default;
+    NonCopyable::~NonCopyable() = default;
+
+}
+// end catch_common.cpp
+// start catch_config.cpp
+
+namespace Catch {
+
+    Config::Config( ConfigData const& data )
+    :   m_data( data ),
+        m_stream( openStream() )
+    {
+        // We need to trim filter specs to avoid trouble with superfluous
+        // whitespace (esp. important for bdd macros, as those are manually
+        // aligned with whitespace).
+
+        for (auto& elem : m_data.testsOrTags) {
+            elem = trim(elem);
+        }
+        for (auto& elem : m_data.sectionsToRun) {
+            elem = trim(elem);
+        }
+
+        TestSpecParser parser(ITagAliasRegistry::get());
+        if (!m_data.testsOrTags.empty()) {
+            m_hasTestFilters = true;
+            for (auto const& testOrTags : m_data.testsOrTags) {
+                parser.parse(testOrTags);
+            }
+        }
+        m_testSpec = parser.testSpec();
+    }
+
+    std::string const& Config::getFilename() const {
+        return m_data.outputFilename ;
+    }
+
+    bool Config::listTests() const          { return m_data.listTests; }
+    bool Config::listTestNamesOnly() const  { return m_data.listTestNamesOnly; }
+    bool Config::listTags() const           { return m_data.listTags; }
+    bool Config::listReporters() const      { return m_data.listReporters; }
+
+    std::string Config::getProcessName() const { return m_data.processName; }
+    std::string const& Config::getReporterName() const { return m_data.reporterName; }
+
+    std::vector<std::string> const& Config::getTestsOrTags() const { return m_data.testsOrTags; }
+    std::vector<std::string> const& Config::getSectionsToRun() const { return m_data.sectionsToRun; }
+
+    TestSpec const& Config::testSpec() const { return m_testSpec; }
+    bool Config::hasTestFilters() const { return m_hasTestFilters; }
+
+    bool Config::showHelp() const { return m_data.showHelp; }
+
+    // IConfig interface
+    bool Config::allowThrows() const                   { return !m_data.noThrow; }
+    std::ostream& Config::stream() const               { return m_stream->stream(); }
+    std::string Config::name() const                   { return m_data.name.empty() ? m_data.processName : m_data.name; }
+    bool Config::includeSuccessfulResults() const      { return m_data.showSuccessfulTests; }
+    bool Config::warnAboutMissingAssertions() const    { return !!(m_data.warnings & WarnAbout::NoAssertions); }
+    bool Config::warnAboutNoTests() const              { return !!(m_data.warnings & WarnAbout::NoTests); }
+    ShowDurations::OrNot Config::showDurations() const { return m_data.showDurations; }
+    double Config::minDuration() const                 { return m_data.minDuration; }
+    RunTests::InWhatOrder Config::runOrder() const     { return m_data.runOrder; }
+    unsigned int Config::rngSeed() const               { return m_data.rngSeed; }
+    UseColour::YesOrNo Config::useColour() const       { return m_data.useColour; }
+    bool Config::shouldDebugBreak() const              { return m_data.shouldDebugBreak; }
+    int Config::abortAfter() const                     { return m_data.abortAfter; }
+    bool Config::showInvisibles() const                { return m_data.showInvisibles; }
+    Verbosity Config::verbosity() const                { return m_data.verbosity; }
+
+    bool Config::benchmarkNoAnalysis() const                      { return m_data.benchmarkNoAnalysis; }
+    int Config::benchmarkSamples() const                          { return m_data.benchmarkSamples; }
+    double Config::benchmarkConfidenceInterval() const            { return m_data.benchmarkConfidenceInterval; }
+    unsigned int Config::benchmarkResamples() const               { return m_data.benchmarkResamples; }
+    std::chrono::milliseconds Config::benchmarkWarmupTime() const { return std::chrono::milliseconds(m_data.benchmarkWarmupTime); }
+
+    IStream const* Config::openStream() {
+        return Catch::makeStream(m_data.outputFilename);
+    }
+
+} // end namespace Catch
+// end catch_config.cpp
+// start catch_console_colour.cpp
+
+#if defined(__clang__)
+#    pragma clang diagnostic push
+#    pragma clang diagnostic ignored "-Wexit-time-destructors"
+#endif
+
+// start catch_errno_guard.h
+
+namespace Catch {
+
+    class ErrnoGuard {
+    public:
+        ErrnoGuard();
+        ~ErrnoGuard();
+    private:
+        int m_oldErrno;
+    };
+
+}
+
+// end catch_errno_guard.h
+// start catch_windows_h_proxy.h
+
+
+#if defined(CATCH_PLATFORM_WINDOWS)
+
+#if !defined(NOMINMAX) && !defined(CATCH_CONFIG_NO_NOMINMAX)
+#  define CATCH_DEFINED_NOMINMAX
+#  define NOMINMAX
+#endif
+#if !defined(WIN32_LEAN_AND_MEAN) && !defined(CATCH_CONFIG_NO_WIN32_LEAN_AND_MEAN)
+#  define CATCH_DEFINED_WIN32_LEAN_AND_MEAN
+#  define WIN32_LEAN_AND_MEAN
+#endif
+
+#ifdef __AFXDLL
+#include <AfxWin.h>
+#else
+#include <windows.h>
+#endif
+
+#ifdef CATCH_DEFINED_NOMINMAX
+#  undef NOMINMAX
+#endif
+#ifdef CATCH_DEFINED_WIN32_LEAN_AND_MEAN
+#  undef WIN32_LEAN_AND_MEAN
+#endif
+
+#endif // defined(CATCH_PLATFORM_WINDOWS)
+
+// end catch_windows_h_proxy.h
+#include <sstream>
+
+namespace Catch {
+    namespace {
+
+        struct IColourImpl {
+            virtual ~IColourImpl() = default;
+            virtual void use( Colour::Code _colourCode ) = 0;
+        };
+
+        struct NoColourImpl : IColourImpl {
+            void use( Colour::Code ) override {}
+
+            static IColourImpl* instance() {
+                static NoColourImpl s_instance;
+                return &s_instance;
+            }
+        };
+
+    } // anon namespace
+} // namespace Catch
+
+#if !defined( CATCH_CONFIG_COLOUR_NONE ) && !defined( CATCH_CONFIG_COLOUR_WINDOWS ) && !defined( CATCH_CONFIG_COLOUR_ANSI )
+#   ifdef CATCH_PLATFORM_WINDOWS
+#       define CATCH_CONFIG_COLOUR_WINDOWS
+#   else
+#       define CATCH_CONFIG_COLOUR_ANSI
+#   endif
+#endif
+
+#if defined ( CATCH_CONFIG_COLOUR_WINDOWS ) /////////////////////////////////////////
+
+namespace Catch {
+namespace {
+
+    class Win32ColourImpl : public IColourImpl {
+    public:
+        Win32ColourImpl() : stdoutHandle( GetStdHandle(STD_OUTPUT_HANDLE) )
+        {
+            CONSOLE_SCREEN_BUFFER_INFO csbiInfo;
+            GetConsoleScreenBufferInfo( stdoutHandle, &csbiInfo );
+            originalForegroundAttributes = csbiInfo.wAttributes & ~( BACKGROUND_GREEN | BACKGROUND_RED | BACKGROUND_BLUE | BACKGROUND_INTENSITY );
+            originalBackgroundAttributes = csbiInfo.wAttributes & ~( FOREGROUND_GREEN | FOREGROUND_RED | FOREGROUND_BLUE | FOREGROUND_INTENSITY );
+        }
+
+        void use( Colour::Code _colourCode ) override {
+            switch( _colourCode ) {
+                case Colour::None:      return setTextAttribute( originalForegroundAttributes );
+                case Colour::White:     return setTextAttribute( FOREGROUND_GREEN | FOREGROUND_RED | FOREGROUND_BLUE );
+                case Colour::Red:       return setTextAttribute( FOREGROUND_RED );
+                case Colour::Green:     return setTextAttribute( FOREGROUND_GREEN );
+                case Colour::Blue:      return setTextAttribute( FOREGROUND_BLUE );
+                case Colour::Cyan:      return setTextAttribute( FOREGROUND_BLUE | FOREGROUND_GREEN );
+                case Colour::Yellow:    return setTextAttribute( FOREGROUND_RED | FOREGROUND_GREEN );
+                case Colour::Grey:      return setTextAttribute( 0 );
+
+                case Colour::LightGrey:     return setTextAttribute( FOREGROUND_INTENSITY );
+                case Colour::BrightRed:     return setTextAttribute( FOREGROUND_INTENSITY | FOREGROUND_RED );
+                case Colour::BrightGreen:   return setTextAttribute( FOREGROUND_INTENSITY | FOREGROUND_GREEN );
+                case Colour::BrightWhite:   return setTextAttribute( FOREGROUND_INTENSITY | FOREGROUND_GREEN | FOREGROUND_RED | FOREGROUND_BLUE );
+                case Colour::BrightYellow:  return setTextAttribute( FOREGROUND_INTENSITY | FOREGROUND_RED | FOREGROUND_GREEN );
+
+                case Colour::Bright: CATCH_INTERNAL_ERROR( "not a colour" );
+
+                default:
+                    CATCH_ERROR( "Unknown colour requested" );
+            }
+        }
+
+    private:
+        void setTextAttribute( WORD _textAttribute ) {
+            SetConsoleTextAttribute( stdoutHandle, _textAttribute | originalBackgroundAttributes );
+        }
+        HANDLE stdoutHandle;
+        WORD originalForegroundAttributes;
+        WORD originalBackgroundAttributes;
+    };
+
+    IColourImpl* platformColourInstance() {
+        static Win32ColourImpl s_instance;
+
+        IConfigPtr config = getCurrentContext().getConfig();
+        UseColour::YesOrNo colourMode = config
+            ? config->useColour()
+            : UseColour::Auto;
+        if( colourMode == UseColour::Auto )
+            colourMode = UseColour::Yes;
+        return colourMode == UseColour::Yes
+            ? &s_instance
+            : NoColourImpl::instance();
+    }
+
+} // end anon namespace
+} // end namespace Catch
+
+#elif defined( CATCH_CONFIG_COLOUR_ANSI ) //////////////////////////////////////
+
+#include <unistd.h>
+
+namespace Catch {
+namespace {
+
+    // use POSIX/ ANSI console terminal codes
+    // Thanks to Adam Strzelecki for original contribution
+    // (http://github.com/nanoant)
+    // https://github.com/philsquared/Catch/pull/131
+    class PosixColourImpl : public IColourImpl {
+    public:
+        void use( Colour::Code _colourCode ) override {
+            switch( _colourCode ) {
+                case Colour::None:
+                case Colour::White:     return setColour( "[0m" );
+                case Colour::Red:       return setColour( "[0;31m" );
+                case Colour::Green:     return setColour( "[0;32m" );
+                case Colour::Blue:      return setColour( "[0;34m" );
+                case Colour::Cyan:      return setColour( "[0;36m" );
+                case Colour::Yellow:    return setColour( "[0;33m" );
+                case Colour::Grey:      return setColour( "[1;30m" );
+
+                case Colour::LightGrey:     return setColour( "[0;37m" );
+                case Colour::BrightRed:     return setColour( "[1;31m" );
+                case Colour::BrightGreen:   return setColour( "[1;32m" );
+                case Colour::BrightWhite:   return setColour( "[1;37m" );
+                case Colour::BrightYellow:  return setColour( "[1;33m" );
+
+                case Colour::Bright: CATCH_INTERNAL_ERROR( "not a colour" );
+                default: CATCH_INTERNAL_ERROR( "Unknown colour requested" );
+            }
+        }
+        static IColourImpl* instance() {
+            static PosixColourImpl s_instance;
+            return &s_instance;
+        }
+
+    private:
+        void setColour( const char* _escapeCode ) {
+            getCurrentContext().getConfig()->stream()
+                << '\033' << _escapeCode;
+        }
+    };
+
+    bool useColourOnPlatform() {
+        return
+#if defined(CATCH_PLATFORM_MAC) || defined(CATCH_PLATFORM_IPHONE)
+            !isDebuggerActive() &&
+#endif
+#if !(defined(__DJGPP__) && defined(__STRICT_ANSI__))
+            isatty(STDOUT_FILENO)
+#else
+            false
+#endif
+            ;
+    }
+    IColourImpl* platformColourInstance() {
+        ErrnoGuard guard;
+        IConfigPtr config = getCurrentContext().getConfig();
+        UseColour::YesOrNo colourMode = config
+            ? config->useColour()
+            : UseColour::Auto;
+        if( colourMode == UseColour::Auto )
+            colourMode = useColourOnPlatform()
+                ? UseColour::Yes
+                : UseColour::No;
+        return colourMode == UseColour::Yes
+            ? PosixColourImpl::instance()
+            : NoColourImpl::instance();
+    }
+
+} // end anon namespace
+} // end namespace Catch
+
+#else  // not Windows or ANSI ///////////////////////////////////////////////
+
+namespace Catch {
+
+    static IColourImpl* platformColourInstance() { return NoColourImpl::instance(); }
+
+} // end namespace Catch
+
+#endif // Windows/ ANSI/ None
+
+namespace Catch {
+
+    Colour::Colour( Code _colourCode ) { use( _colourCode ); }
+    Colour::Colour( Colour&& other ) noexcept {
+        m_moved = other.m_moved;
+        other.m_moved = true;
+    }
+    Colour& Colour::operator=( Colour&& other ) noexcept {
+        m_moved = other.m_moved;
+        other.m_moved  = true;
+        return *this;
+    }
+
+    Colour::~Colour(){ if( !m_moved ) use( None ); }
+
+    void Colour::use( Code _colourCode ) {
+        static IColourImpl* impl = platformColourInstance();
+        // Strictly speaking, this cannot possibly happen.
+        // However, under some conditions it does happen (see #1626),
+        // and this change is small enough that we can let practicality
+        // triumph over purity in this case.
+        if (impl != nullptr) {
+            impl->use( _colourCode );
+        }
+    }
+
+    std::ostream& operator << ( std::ostream& os, Colour const& ) {
+        return os;
+    }
+
+} // end namespace Catch
+
+#if defined(__clang__)
+#    pragma clang diagnostic pop
+#endif
+
+// end catch_console_colour.cpp
+// start catch_context.cpp
+
+namespace Catch {
+
+    class Context : public IMutableContext, NonCopyable {
+
+    public: // IContext
+        IResultCapture* getResultCapture() override {
+            return m_resultCapture;
+        }
+        IRunner* getRunner() override {
+            return m_runner;
+        }
+
+        IConfigPtr const& getConfig() const override {
+            return m_config;
+        }
+
+        ~Context() override;
+
+    public: // IMutableContext
+        void setResultCapture( IResultCapture* resultCapture ) override {
+            m_resultCapture = resultCapture;
+        }
+        void setRunner( IRunner* runner ) override {
+            m_runner = runner;
+        }
+        void setConfig( IConfigPtr const& config ) override {
+            m_config = config;
+        }
+
+        friend IMutableContext& getCurrentMutableContext();
+
+    private:
+        IConfigPtr m_config;
+        IRunner* m_runner = nullptr;
+        IResultCapture* m_resultCapture = nullptr;
+    };
+
+    IMutableContext *IMutableContext::currentContext = nullptr;
+
+    void IMutableContext::createContext()
+    {
+        currentContext = new Context();
+    }
+
+    void cleanUpContext() {
+        delete IMutableContext::currentContext;
+        IMutableContext::currentContext = nullptr;
+    }
+    IContext::~IContext() = default;
+    IMutableContext::~IMutableContext() = default;
+    Context::~Context() = default;
+
+    SimplePcg32& rng() {
+        static SimplePcg32 s_rng;
+        return s_rng;
+    }
+
+}
+// end catch_context.cpp
+// start catch_debug_console.cpp
+
+// start catch_debug_console.h
+
+#include <string>
+
+namespace Catch {
+    void writeToDebugConsole( std::string const& text );
+}
+
+// end catch_debug_console.h
+#if defined(CATCH_CONFIG_ANDROID_LOGWRITE)
+#include <android/log.h>
+
+    namespace Catch {
+        void writeToDebugConsole( std::string const& text ) {
+            __android_log_write( ANDROID_LOG_DEBUG, "Catch", text.c_str() );
+        }
+    }
+
+#elif defined(CATCH_PLATFORM_WINDOWS)
+
+    namespace Catch {
+        void writeToDebugConsole( std::string const& text ) {
+            ::OutputDebugStringA( text.c_str() );
+        }
+    }
+
+#else
+
+    namespace Catch {
+        void writeToDebugConsole( std::string const& text ) {
+            // !TBD: Need a version for Mac/ XCode and other IDEs
+            Catch::cout() << text;
+        }
+    }
+
+#endif // Platform
+// end catch_debug_console.cpp
+// start catch_debugger.cpp
+
+#if defined(CATCH_PLATFORM_MAC) || defined(CATCH_PLATFORM_IPHONE)
+
+#  include <cassert>
+#  include <sys/types.h>
+#  include <unistd.h>
+#  include <cstddef>
+#  include <ostream>
+
+#ifdef __apple_build_version__
+    // These headers will only compile with AppleClang (XCode)
+    // For other compilers (Clang, GCC, ... ) we need to exclude them
+#  include <sys/sysctl.h>
+#endif
+
+    namespace Catch {
+        #ifdef __apple_build_version__
+        // The following function is taken directly from the following technical note:
+        // https://developer.apple.com/library/archive/qa/qa1361/_index.html
+
+        // Returns true if the current process is being debugged (either
+        // running under the debugger or has a debugger attached post facto).
+        bool isDebuggerActive(){
+            int                 mib[4];
+            struct kinfo_proc   info;
+            std::size_t         size;
+
+            // Initialize the flags so that, if sysctl fails for some bizarre
+            // reason, we get a predictable result.
+
+            info.kp_proc.p_flag = 0;
+
+            // Initialize mib, which tells sysctl the info we want, in this case
+            // we're looking for information about a specific process ID.
+
+            mib[0] = CTL_KERN;
+            mib[1] = KERN_PROC;
+            mib[2] = KERN_PROC_PID;
+            mib[3] = getpid();
+
+            // Call sysctl.
+
+            size = sizeof(info);
+            if( sysctl(mib, sizeof(mib) / sizeof(*mib), &info, &size, nullptr, 0) != 0 ) {
+                Catch::cerr() << "\n** Call to sysctl failed - unable to determine if debugger is active **\n" << std::endl;
+                return false;
+            }
+
+            // We're being debugged if the P_TRACED flag is set.
+
+            return ( (info.kp_proc.p_flag & P_TRACED) != 0 );
+        }
+        #else
+        bool isDebuggerActive() {
+            // We need to find another way to determine this for non-appleclang compilers on macOS
+            return false;
+        }
+        #endif
+    } // namespace Catch
+
+#elif defined(CATCH_PLATFORM_LINUX)
+    #include <fstream>
+    #include <string>
+
+    namespace Catch{
+        // The standard POSIX way of detecting a debugger is to attempt to
+        // ptrace() the process, but this needs to be done from a child and not
+        // this process itself to still allow attaching to this process later
+        // if wanted, so is rather heavy. Under Linux we have the PID of the
+        // "debugger" (which doesn't need to be gdb, of course, it could also
+        // be strace, for example) in /proc/$PID/status, so just get it from
+        // there instead.
+        bool isDebuggerActive(){
+            // Libstdc++ has a bug, where std::ifstream sets errno to 0
+            // This way our users can properly assert over errno values
+            ErrnoGuard guard;
+            std::ifstream in("/proc/self/status");
+            for( std::string line; std::getline(in, line); ) {
+                static const int PREFIX_LEN = 11;
+                if( line.compare(0, PREFIX_LEN, "TracerPid:\t") == 0 ) {
+                    // We're traced if the PID is not 0 and no other PID starts
+                    // with 0 digit, so it's enough to check for just a single
+                    // character.
+                    return line.length() > PREFIX_LEN && line[PREFIX_LEN] != '0';
+                }
+            }
+
+            return false;
+        }
+    } // namespace Catch
+#elif defined(_MSC_VER)
+    extern "C" __declspec(dllimport) int __stdcall IsDebuggerPresent();
+    namespace Catch {
+        bool isDebuggerActive() {
+            return IsDebuggerPresent() != 0;
+        }
+    }
+#elif defined(__MINGW32__)
+    extern "C" __declspec(dllimport) int __stdcall IsDebuggerPresent();
+    namespace Catch {
+        bool isDebuggerActive() {
+            return IsDebuggerPresent() != 0;
+        }
+    }
+#else
+    namespace Catch {
+       bool isDebuggerActive() { return false; }
+    }
+#endif // Platform
+// end catch_debugger.cpp
+// start catch_decomposer.cpp
+
+namespace Catch {
+
+    ITransientExpression::~ITransientExpression() = default;
+
+    void formatReconstructedExpression( std::ostream &os, std::string const& lhs, StringRef op, std::string const& rhs ) {
+        if( lhs.size() + rhs.size() < 40 &&
+                lhs.find('\n') == std::string::npos &&
+                rhs.find('\n') == std::string::npos )
+            os << lhs << " " << op << " " << rhs;
+        else
+            os << lhs << "\n" << op << "\n" << rhs;
+    }
+}
+// end catch_decomposer.cpp
+// start catch_enforce.cpp
+
+#include <stdexcept>
+
+namespace Catch {
+#if defined(CATCH_CONFIG_DISABLE_EXCEPTIONS) && !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS_CUSTOM_HANDLER)
+    [[noreturn]]
+    void throw_exception(std::exception const& e) {
+        Catch::cerr() << "Catch will terminate because it needed to throw an exception.\n"
+                      << "The message was: " << e.what() << '\n';
+        std::terminate();
+    }
+#endif
+
+    [[noreturn]]
+    void throw_logic_error(std::string const& msg) {
+        throw_exception(std::logic_error(msg));
+    }
+
+    [[noreturn]]
+    void throw_domain_error(std::string const& msg) {
+        throw_exception(std::domain_error(msg));
+    }
+
+    [[noreturn]]
+    void throw_runtime_error(std::string const& msg) {
+        throw_exception(std::runtime_error(msg));
+    }
+
+} // namespace Catch;
+// end catch_enforce.cpp
+// start catch_enum_values_registry.cpp
+// start catch_enum_values_registry.h
+
+#include <vector>
+#include <memory>
+
+namespace Catch {
+
+    namespace Detail {
+
+        std::unique_ptr<EnumInfo> makeEnumInfo( StringRef enumName, StringRef allValueNames, std::vector<int> const& values );
+
+        class EnumValuesRegistry : public IMutableEnumValuesRegistry {
+
+            std::vector<std::unique_ptr<EnumInfo>> m_enumInfos;
+
+            EnumInfo const& registerEnum( StringRef enumName, StringRef allEnums, std::vector<int> const& values) override;
+        };
+
+        std::vector<StringRef> parseEnums( StringRef enums );
+
+    } // Detail
+
+} // Catch
+
+// end catch_enum_values_registry.h
+
+#include <map>
+#include <cassert>
+
+namespace Catch {
+
+    IMutableEnumValuesRegistry::~IMutableEnumValuesRegistry() {}
+
+    namespace Detail {
+
+        namespace {
+            // Extracts the actual name part of an enum instance
+            // In other words, it returns the Blue part of Bikeshed::Colour::Blue
+            StringRef extractInstanceName(StringRef enumInstance) {
+                // Find last occurrence of ":"
+                size_t name_start = enumInstance.size();
+                while (name_start > 0 && enumInstance[name_start - 1] != ':') {
+                    --name_start;
+                }
+                return enumInstance.substr(name_start, enumInstance.size() - name_start);
+            }
+        }
+
+        std::vector<StringRef> parseEnums( StringRef enums ) {
+            auto enumValues = splitStringRef( enums, ',' );
+            std::vector<StringRef> parsed;
+            parsed.reserve( enumValues.size() );
+            for( auto const& enumValue : enumValues ) {
+                parsed.push_back(trim(extractInstanceName(enumValue)));
+            }
+            return parsed;
+        }
+
+        EnumInfo::~EnumInfo() {}
+
+        StringRef EnumInfo::lookup( int value ) const {
+            for( auto const& valueToName : m_values ) {
+                if( valueToName.first == value )
+                    return valueToName.second;
+            }
+            return "{** unexpected enum value **}"_sr;
+        }
+
+        std::unique_ptr<EnumInfo> makeEnumInfo( StringRef enumName, StringRef allValueNames, std::vector<int> const& values ) {
+            std::unique_ptr<EnumInfo> enumInfo( new EnumInfo );
+            enumInfo->m_name = enumName;
+            enumInfo->m_values.reserve( values.size() );
+
+            const auto valueNames = Catch::Detail::parseEnums( allValueNames );
+            assert( valueNames.size() == values.size() );
+            std::size_t i = 0;
+            for( auto value : values )
+                enumInfo->m_values.emplace_back(value, valueNames[i++]);
+
+            return enumInfo;
+        }
+
+        EnumInfo const& EnumValuesRegistry::registerEnum( StringRef enumName, StringRef allValueNames, std::vector<int> const& values ) {
+            m_enumInfos.push_back(makeEnumInfo(enumName, allValueNames, values));
+            return *m_enumInfos.back();
+        }
+
+    } // Detail
+} // Catch
+
+// end catch_enum_values_registry.cpp
+// start catch_errno_guard.cpp
+
+#include <cerrno>
+
+namespace Catch {
+        ErrnoGuard::ErrnoGuard():m_oldErrno(errno){}
+        ErrnoGuard::~ErrnoGuard() { errno = m_oldErrno; }
+}
+// end catch_errno_guard.cpp
+// start catch_exception_translator_registry.cpp
+
+// start catch_exception_translator_registry.h
+
+#include <vector>
+#include <string>
+#include <memory>
+
+namespace Catch {
+
+    class ExceptionTranslatorRegistry : public IExceptionTranslatorRegistry {
+    public:
+        ~ExceptionTranslatorRegistry();
+        virtual void registerTranslator( const IExceptionTranslator* translator );
+        std::string translateActiveException() const override;
+        std::string tryTranslators() const;
+
+    private:
+        std::vector<std::unique_ptr<IExceptionTranslator const>> m_translators;
+    };
+}
+
+// end catch_exception_translator_registry.h
+#ifdef __OBJC__
+#import "Foundation/Foundation.h"
+#endif
+
+namespace Catch {
+
+    ExceptionTranslatorRegistry::~ExceptionTranslatorRegistry() {
+    }
+
+    void ExceptionTranslatorRegistry::registerTranslator( const IExceptionTranslator* translator ) {
+        m_translators.push_back( std::unique_ptr<const IExceptionTranslator>( translator ) );
+    }
+
+#if !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+    std::string ExceptionTranslatorRegistry::translateActiveException() const {
+        try {
+#ifdef __OBJC__
+            // In Objective-C try objective-c exceptions first
+            @try {
+                return tryTranslators();
+            }
+            @catch (NSException *exception) {
+                return Catch::Detail::stringify( [exception description] );
+            }
+#else
+            // Compiling a mixed mode project with MSVC means that CLR
+            // exceptions will be caught in (...) as well. However, these
+            // do not fill-in std::current_exception and thus lead to crash
+            // when attempting rethrow.
+            // /EHa switch also causes structured exceptions to be caught
+            // here, but they fill-in current_exception properly, so
+            // at worst the output should be a little weird, instead of
+            // causing a crash.
+            if (std::current_exception() == nullptr) {
+                return "Non C++ exception. Possibly a CLR exception.";
+            }
+            return tryTranslators();
+#endif
+        }
+        catch( TestFailureException& ) {
+            std::rethrow_exception(std::current_exception());
+        }
+        catch( std::exception& ex ) {
+            return ex.what();
+        }
+        catch( std::string& msg ) {
+            return msg;
+        }
+        catch( const char* msg ) {
+            return msg;
+        }
+        catch(...) {
+            return "Unknown exception";
+        }
+    }
+
+    std::string ExceptionTranslatorRegistry::tryTranslators() const {
+        if (m_translators.empty()) {
+            std::rethrow_exception(std::current_exception());
+        } else {
+            return m_translators[0]->translate(m_translators.begin() + 1, m_translators.end());
+        }
+    }
+
+#else // ^^ Exceptions are enabled // Exceptions are disabled vv
+    std::string ExceptionTranslatorRegistry::translateActiveException() const {
+        CATCH_INTERNAL_ERROR("Attempted to translate active exception under CATCH_CONFIG_DISABLE_EXCEPTIONS!");
+    }
+
+    std::string ExceptionTranslatorRegistry::tryTranslators() const {
+        CATCH_INTERNAL_ERROR("Attempted to use exception translators under CATCH_CONFIG_DISABLE_EXCEPTIONS!");
+    }
+#endif
+
+}
+// end catch_exception_translator_registry.cpp
+// start catch_fatal_condition.cpp
+
+#include <algorithm>
+
+#if !defined( CATCH_CONFIG_WINDOWS_SEH ) && !defined( CATCH_CONFIG_POSIX_SIGNALS )
+
+namespace Catch {
+
+    // If neither SEH nor signal handling is required, the handler impls
+    // do not have to do anything, and can be empty.
+    void FatalConditionHandler::engage_platform() {}
+    void FatalConditionHandler::disengage_platform() {}
+    FatalConditionHandler::FatalConditionHandler() = default;
+    FatalConditionHandler::~FatalConditionHandler() = default;
+
+} // end namespace Catch
+
+#endif // !CATCH_CONFIG_WINDOWS_SEH && !CATCH_CONFIG_POSIX_SIGNALS
+
+#if defined( CATCH_CONFIG_WINDOWS_SEH ) && defined( CATCH_CONFIG_POSIX_SIGNALS )
+#error "Inconsistent configuration: Windows' SEH handling and POSIX signals cannot be enabled at the same time"
+#endif // CATCH_CONFIG_WINDOWS_SEH && CATCH_CONFIG_POSIX_SIGNALS
+
+#if defined( CATCH_CONFIG_WINDOWS_SEH ) || defined( CATCH_CONFIG_POSIX_SIGNALS )
+
+namespace {
+    //! Signals fatal error message to the run context
+    void reportFatal( char const * const message ) {
+        Catch::getCurrentContext().getResultCapture()->handleFatalErrorCondition( message );
+    }
+
+    //! Minimal size Catch2 needs for its own fatal error handling.
+    //! Picked anecdotally, so it might not be sufficient on all
+    //! platforms, and for all configurations.
+    constexpr std::size_t minStackSizeForErrors = 32 * 1024;
+} // end unnamed namespace
+
+#endif // CATCH_CONFIG_WINDOWS_SEH || CATCH_CONFIG_POSIX_SIGNALS
+
+#if defined( CATCH_CONFIG_WINDOWS_SEH )
+
+namespace Catch {
+
+    struct SignalDefs { DWORD id; const char* name; };
+
+    // There is no 1-1 mapping between signals and windows exceptions.
+    // Windows can easily distinguish between SO and SigSegV,
+    // but SigInt, SigTerm, etc are handled differently.
+    static SignalDefs signalDefs[] = {
+        { static_cast<DWORD>(EXCEPTION_ILLEGAL_INSTRUCTION),  "SIGILL - Illegal instruction signal" },
+        { static_cast<DWORD>(EXCEPTION_STACK_OVERFLOW), "SIGSEGV - Stack overflow" },
+        { static_cast<DWORD>(EXCEPTION_ACCESS_VIOLATION), "SIGSEGV - Segmentation violation signal" },
+        { static_cast<DWORD>(EXCEPTION_INT_DIVIDE_BY_ZERO), "Divide by zero error" },
+    };
+
+    static LONG CALLBACK handleVectoredException(PEXCEPTION_POINTERS ExceptionInfo) {
+        for (auto const& def : signalDefs) {
+            if (ExceptionInfo->ExceptionRecord->ExceptionCode == def.id) {
+                reportFatal(def.name);
+            }
+        }
+        // If its not an exception we care about, pass it along.
+        // This stops us from eating debugger breaks etc.
+        return EXCEPTION_CONTINUE_SEARCH;
+    }
+
+    // Since we do not support multiple instantiations, we put these
+    // into global variables and rely on cleaning them up in outlined
+    // constructors/destructors
+    static PVOID exceptionHandlerHandle = nullptr;
+
+    // For MSVC, we reserve part of the stack memory for handling
+    // memory overflow structured exception.
+    FatalConditionHandler::FatalConditionHandler() {
+        ULONG guaranteeSize = static_cast<ULONG>(minStackSizeForErrors);
+        if (!SetThreadStackGuarantee(&guaranteeSize)) {
+            // We do not want to fully error out, because needing
+            // the stack reserve should be rare enough anyway.
+            Catch::cerr()
+                << "Failed to reserve piece of stack."
+                << " Stack overflows will not be reported successfully.";
+        }
+    }
+
+    // We do not attempt to unset the stack guarantee, because
+    // Windows does not support lowering the stack size guarantee.
+    FatalConditionHandler::~FatalConditionHandler() = default;
+
+    void FatalConditionHandler::engage_platform() {
+        // Register as first handler in current chain
+        exceptionHandlerHandle = AddVectoredExceptionHandler(1, handleVectoredException);
+        if (!exceptionHandlerHandle) {
+            CATCH_RUNTIME_ERROR("Could not register vectored exception handler");
+        }
+    }
+
+    void FatalConditionHandler::disengage_platform() {
+        if (!RemoveVectoredExceptionHandler(exceptionHandlerHandle)) {
+            CATCH_RUNTIME_ERROR("Could not unregister vectored exception handler");
+        }
+        exceptionHandlerHandle = nullptr;
+    }
+
+} // end namespace Catch
+
+#endif // CATCH_CONFIG_WINDOWS_SEH
+
+#if defined( CATCH_CONFIG_POSIX_SIGNALS )
+
+#include <signal.h>
+
+namespace Catch {
+
+    struct SignalDefs {
+        int id;
+        const char* name;
+    };
+
+    static SignalDefs signalDefs[] = {
+        { SIGINT,  "SIGINT - Terminal interrupt signal" },
+        { SIGILL,  "SIGILL - Illegal instruction signal" },
+        { SIGFPE,  "SIGFPE - Floating point error signal" },
+        { SIGSEGV, "SIGSEGV - Segmentation violation signal" },
+        { SIGTERM, "SIGTERM - Termination request signal" },
+        { SIGABRT, "SIGABRT - Abort (abnormal termination) signal" }
+    };
+
+// Older GCCs trigger -Wmissing-field-initializers for T foo = {}
+// which is zero initialization, but not explicit. We want to avoid
+// that.
+#if defined(__GNUC__)
+#    pragma GCC diagnostic push
+#    pragma GCC diagnostic ignored "-Wmissing-field-initializers"
+#endif
+
+    static char* altStackMem = nullptr;
+    static std::size_t altStackSize = 0;
+    static stack_t oldSigStack{};
+    static struct sigaction oldSigActions[sizeof(signalDefs) / sizeof(SignalDefs)]{};
+
+    static void restorePreviousSignalHandlers() {
+        // We set signal handlers back to the previous ones. Hopefully
+        // nobody overwrote them in the meantime, and doesn't expect
+        // their signal handlers to live past ours given that they
+        // installed them after ours..
+        for (std::size_t i = 0; i < sizeof(signalDefs) / sizeof(SignalDefs); ++i) {
+            sigaction(signalDefs[i].id, &oldSigActions[i], nullptr);
+        }
+        // Return the old stack
+        sigaltstack(&oldSigStack, nullptr);
+    }
+
+    static void handleSignal( int sig ) {
+        char const * name = "<unknown signal>";
+        for (auto const& def : signalDefs) {
+            if (sig == def.id) {
+                name = def.name;
+                break;
+            }
+        }
+        // We need to restore previous signal handlers and let them do
+        // their thing, so that the users can have the debugger break
+        // when a signal is raised, and so on.
+        restorePreviousSignalHandlers();
+        reportFatal( name );
+        raise( sig );
+    }
+
+    FatalConditionHandler::FatalConditionHandler() {
+        assert(!altStackMem && "Cannot initialize POSIX signal handler when one already exists");
+        if (altStackSize == 0) {
+            altStackSize = std::max(static_cast<size_t>(SIGSTKSZ), minStackSizeForErrors);
+        }
+        altStackMem = new char[altStackSize]();
+    }
+
+    FatalConditionHandler::~FatalConditionHandler() {
+        delete[] altStackMem;
+        // We signal that another instance can be constructed by zeroing
+        // out the pointer.
+        altStackMem = nullptr;
+    }
+
+    void FatalConditionHandler::engage_platform() {
+        stack_t sigStack;
+        sigStack.ss_sp = altStackMem;
+        sigStack.ss_size = altStackSize;
+        sigStack.ss_flags = 0;
+        sigaltstack(&sigStack, &oldSigStack);
+        struct sigaction sa = { };
+
+        sa.sa_handler = handleSignal;
+        sa.sa_flags = SA_ONSTACK;
+        for (std::size_t i = 0; i < sizeof(signalDefs)/sizeof(SignalDefs); ++i) {
+            sigaction(signalDefs[i].id, &sa, &oldSigActions[i]);
+        }
+    }
+
+#if defined(__GNUC__)
+#    pragma GCC diagnostic pop
+#endif
+
+    void FatalConditionHandler::disengage_platform() {
+        restorePreviousSignalHandlers();
+    }
+
+} // end namespace Catch
+
+#endif // CATCH_CONFIG_POSIX_SIGNALS
+// end catch_fatal_condition.cpp
+// start catch_generators.cpp
+
+#include <limits>
+#include <set>
+
+namespace Catch {
+
+IGeneratorTracker::~IGeneratorTracker() {}
+
+const char* GeneratorException::what() const noexcept {
+    return m_msg;
+}
+
+namespace Generators {
+
+    GeneratorUntypedBase::~GeneratorUntypedBase() {}
+
+    auto acquireGeneratorTracker( StringRef generatorName, SourceLineInfo const& lineInfo ) -> IGeneratorTracker& {
+        return getResultCapture().acquireGeneratorTracker( generatorName, lineInfo );
+    }
+
+} // namespace Generators
+} // namespace Catch
+// end catch_generators.cpp
+// start catch_interfaces_capture.cpp
+
+namespace Catch {
+    IResultCapture::~IResultCapture() = default;
+}
+// end catch_interfaces_capture.cpp
+// start catch_interfaces_config.cpp
+
+namespace Catch {
+    IConfig::~IConfig() = default;
+}
+// end catch_interfaces_config.cpp
+// start catch_interfaces_exception.cpp
+
+namespace Catch {
+    IExceptionTranslator::~IExceptionTranslator() = default;
+    IExceptionTranslatorRegistry::~IExceptionTranslatorRegistry() = default;
+}
+// end catch_interfaces_exception.cpp
+// start catch_interfaces_registry_hub.cpp
+
+namespace Catch {
+    IRegistryHub::~IRegistryHub() = default;
+    IMutableRegistryHub::~IMutableRegistryHub() = default;
+}
+// end catch_interfaces_registry_hub.cpp
+// start catch_interfaces_reporter.cpp
+
+// start catch_reporter_listening.h
+
+namespace Catch {
+
+    class ListeningReporter : public IStreamingReporter {
+        using Reporters = std::vector<IStreamingReporterPtr>;
+        Reporters m_listeners;
+        IStreamingReporterPtr m_reporter = nullptr;
+        ReporterPreferences m_preferences;
+
+    public:
+        ListeningReporter();
+
+        void addListener( IStreamingReporterPtr&& listener );
+        void addReporter( IStreamingReporterPtr&& reporter );
+
+    public: // IStreamingReporter
+
+        ReporterPreferences getPreferences() const override;
+
+        void noMatchingTestCases( std::string const& spec ) override;
+
+        void reportInvalidArguments(std::string const&arg) override;
+
+        static std::set<Verbosity> getSupportedVerbosities();
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+        void benchmarkPreparing(std::string const& name) override;
+        void benchmarkStarting( BenchmarkInfo const& benchmarkInfo ) override;
+        void benchmarkEnded( BenchmarkStats<> const& benchmarkStats ) override;
+        void benchmarkFailed(std::string const&) override;
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+        void testRunStarting( TestRunInfo const& testRunInfo ) override;
+        void testGroupStarting( GroupInfo const& groupInfo ) override;
+        void testCaseStarting( TestCaseInfo const& testInfo ) override;
+        void sectionStarting( SectionInfo const& sectionInfo ) override;
+        void assertionStarting( AssertionInfo const& assertionInfo ) override;
+
+        // The return value indicates if the messages buffer should be cleared:
+        bool assertionEnded( AssertionStats const& assertionStats ) override;
+        void sectionEnded( SectionStats const& sectionStats ) override;
+        void testCaseEnded( TestCaseStats const& testCaseStats ) override;
+        void testGroupEnded( TestGroupStats const& testGroupStats ) override;
+        void testRunEnded( TestRunStats const& testRunStats ) override;
+
+        void skipTest( TestCaseInfo const& testInfo ) override;
+        bool isMulti() const override;
+
+    };
+
+} // end namespace Catch
+
+// end catch_reporter_listening.h
+namespace Catch {
+
+    ReporterConfig::ReporterConfig( IConfigPtr const& _fullConfig )
+    :   m_stream( &_fullConfig->stream() ), m_fullConfig( _fullConfig ) {}
+
+    ReporterConfig::ReporterConfig( IConfigPtr const& _fullConfig, std::ostream& _stream )
+    :   m_stream( &_stream ), m_fullConfig( _fullConfig ) {}
+
+    std::ostream& ReporterConfig::stream() const { return *m_stream; }
+    IConfigPtr ReporterConfig::fullConfig() const { return m_fullConfig; }
+
+    TestRunInfo::TestRunInfo( std::string const& _name ) : name( _name ) {}
+
+    GroupInfo::GroupInfo(  std::string const& _name,
+                           std::size_t _groupIndex,
+                           std::size_t _groupsCount )
+    :   name( _name ),
+        groupIndex( _groupIndex ),
+        groupsCounts( _groupsCount )
+    {}
+
+     AssertionStats::AssertionStats( AssertionResult const& _assertionResult,
+                                     std::vector<MessageInfo> const& _infoMessages,
+                                     Totals const& _totals )
+    :   assertionResult( _assertionResult ),
+        infoMessages( _infoMessages ),
+        totals( _totals )
+    {
+        assertionResult.m_resultData.lazyExpression.m_transientExpression = _assertionResult.m_resultData.lazyExpression.m_transientExpression;
+
+        if( assertionResult.hasMessage() ) {
+            // Copy message into messages list.
+            // !TBD This should have been done earlier, somewhere
+            MessageBuilder builder( assertionResult.getTestMacroName(), assertionResult.getSourceInfo(), assertionResult.getResultType() );
+            builder << assertionResult.getMessage();
+            builder.m_info.message = builder.m_stream.str();
+
+            infoMessages.push_back( builder.m_info );
+        }
+    }
+
+     AssertionStats::~AssertionStats() = default;
+
+    SectionStats::SectionStats(  SectionInfo const& _sectionInfo,
+                                 Counts const& _assertions,
+                                 double _durationInSeconds,
+                                 bool _missingAssertions )
+    :   sectionInfo( _sectionInfo ),
+        assertions( _assertions ),
+        durationInSeconds( _durationInSeconds ),
+        missingAssertions( _missingAssertions )
+    {}
+
+    SectionStats::~SectionStats() = default;
+
+    TestCaseStats::TestCaseStats(  TestCaseInfo const& _testInfo,
+                                   Totals const& _totals,
+                                   std::string const& _stdOut,
+                                   std::string const& _stdErr,
+                                   bool _aborting )
+    : testInfo( _testInfo ),
+        totals( _totals ),
+        stdOut( _stdOut ),
+        stdErr( _stdErr ),
+        aborting( _aborting )
+    {}
+
+    TestCaseStats::~TestCaseStats() = default;
+
+    TestGroupStats::TestGroupStats( GroupInfo const& _groupInfo,
+                                    Totals const& _totals,
+                                    bool _aborting )
+    :   groupInfo( _groupInfo ),
+        totals( _totals ),
+        aborting( _aborting )
+    {}
+
+    TestGroupStats::TestGroupStats( GroupInfo const& _groupInfo )
+    :   groupInfo( _groupInfo ),
+        aborting( false )
+    {}
+
+    TestGroupStats::~TestGroupStats() = default;
+
+    TestRunStats::TestRunStats(   TestRunInfo const& _runInfo,
+                    Totals const& _totals,
+                    bool _aborting )
+    :   runInfo( _runInfo ),
+        totals( _totals ),
+        aborting( _aborting )
+    {}
+
+    TestRunStats::~TestRunStats() = default;
+
+    void IStreamingReporter::fatalErrorEncountered( StringRef ) {}
+    bool IStreamingReporter::isMulti() const { return false; }
+
+    IReporterFactory::~IReporterFactory() = default;
+    IReporterRegistry::~IReporterRegistry() = default;
+
+} // end namespace Catch
+// end catch_interfaces_reporter.cpp
+// start catch_interfaces_runner.cpp
+
+namespace Catch {
+    IRunner::~IRunner() = default;
+}
+// end catch_interfaces_runner.cpp
+// start catch_interfaces_testcase.cpp
+
+namespace Catch {
+    ITestInvoker::~ITestInvoker() = default;
+    ITestCaseRegistry::~ITestCaseRegistry() = default;
+}
+// end catch_interfaces_testcase.cpp
+// start catch_leak_detector.cpp
+
+#ifdef CATCH_CONFIG_WINDOWS_CRTDBG
+#include <crtdbg.h>
+
+namespace Catch {
+
+    LeakDetector::LeakDetector() {
+        int flag = _CrtSetDbgFlag(_CRTDBG_REPORT_FLAG);
+        flag |= _CRTDBG_LEAK_CHECK_DF;
+        flag |= _CRTDBG_ALLOC_MEM_DF;
+        _CrtSetDbgFlag(flag);
+        _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE | _CRTDBG_MODE_DEBUG);
+        _CrtSetReportFile(_CRT_WARN, _CRTDBG_FILE_STDERR);
+        // Change this to leaking allocation's number to break there
+        _CrtSetBreakAlloc(-1);
+    }
+}
+
+#else
+
+    Catch::LeakDetector::LeakDetector() {}
+
+#endif
+
+Catch::LeakDetector::~LeakDetector() {
+    Catch::cleanUp();
+}
+// end catch_leak_detector.cpp
+// start catch_list.cpp
+
+// start catch_list.h
+
+#include <set>
+
+namespace Catch {
+
+    std::size_t listTests( Config const& config );
+
+    std::size_t listTestsNamesOnly( Config const& config );
+
+    struct TagInfo {
+        void add( std::string const& spelling );
+        std::string all() const;
+
+        std::set<std::string> spellings;
+        std::size_t count = 0;
+    };
+
+    std::size_t listTags( Config const& config );
+
+    std::size_t listReporters();
+
+    Option<std::size_t> list( std::shared_ptr<Config> const& config );
+
+} // end namespace Catch
+
+// end catch_list.h
+// start catch_text.h
+
+namespace Catch {
+    using namespace clara::TextFlow;
+}
+
+// end catch_text.h
+#include <limits>
+#include <algorithm>
+#include <iomanip>
+
+namespace Catch {
+
+    std::size_t listTests( Config const& config ) {
+        TestSpec const& testSpec = config.testSpec();
+        if( config.hasTestFilters() )
+            Catch::cout() << "Matching test cases:\n";
+        else {
+            Catch::cout() << "All available test cases:\n";
+        }
+
+        auto matchedTestCases = filterTests( getAllTestCasesSorted( config ), testSpec, config );
+        for( auto const& testCaseInfo : matchedTestCases ) {
+            Colour::Code colour = testCaseInfo.isHidden()
+                ? Colour::SecondaryText
+                : Colour::None;
+            Colour colourGuard( colour );
+
+            Catch::cout() << Column( testCaseInfo.name ).initialIndent( 2 ).indent( 4 ) << "\n";
+            if( config.verbosity() >= Verbosity::High ) {
+                Catch::cout() << Column( Catch::Detail::stringify( testCaseInfo.lineInfo ) ).indent(4) << std::endl;
+                std::string description = testCaseInfo.description;
+                if( description.empty() )
+                    description = "(NO DESCRIPTION)";
+                Catch::cout() << Column( description ).indent(4) << std::endl;
+            }
+            if( !testCaseInfo.tags.empty() )
+                Catch::cout() << Column( testCaseInfo.tagsAsString() ).indent( 6 ) << "\n";
+        }
+
+        if( !config.hasTestFilters() )
+            Catch::cout() << pluralise( matchedTestCases.size(), "test case" ) << '\n' << std::endl;
+        else
+            Catch::cout() << pluralise( matchedTestCases.size(), "matching test case" ) << '\n' << std::endl;
+        return matchedTestCases.size();
+    }
+
+    std::size_t listTestsNamesOnly( Config const& config ) {
+        TestSpec const& testSpec = config.testSpec();
+        std::size_t matchedTests = 0;
+        std::vector<TestCase> matchedTestCases = filterTests( getAllTestCasesSorted( config ), testSpec, config );
+        for( auto const& testCaseInfo : matchedTestCases ) {
+            matchedTests++;
+            if( startsWith( testCaseInfo.name, '#' ) )
+               Catch::cout() << '"' << testCaseInfo.name << '"';
+            else
+               Catch::cout() << testCaseInfo.name;
+            if ( config.verbosity() >= Verbosity::High )
+                Catch::cout() << "\t@" << testCaseInfo.lineInfo;
+            Catch::cout() << std::endl;
+        }
+        return matchedTests;
+    }
+
+    void TagInfo::add( std::string const& spelling ) {
+        ++count;
+        spellings.insert( spelling );
+    }
+
+    std::string TagInfo::all() const {
+        size_t size = 0;
+        for (auto const& spelling : spellings) {
+            // Add 2 for the brackes
+            size += spelling.size() + 2;
+        }
+
+        std::string out; out.reserve(size);
+        for (auto const& spelling : spellings) {
+            out += '[';
+            out += spelling;
+            out += ']';
+        }
+        return out;
+    }
+
+    std::size_t listTags( Config const& config ) {
+        TestSpec const& testSpec = config.testSpec();
+        if( config.hasTestFilters() )
+            Catch::cout() << "Tags for matching test cases:\n";
+        else {
+            Catch::cout() << "All available tags:\n";
+        }
+
+        std::map<std::string, TagInfo> tagCounts;
+
+        std::vector<TestCase> matchedTestCases = filterTests( getAllTestCasesSorted( config ), testSpec, config );
+        for( auto const& testCase : matchedTestCases ) {
+            for( auto const& tagName : testCase.getTestCaseInfo().tags ) {
+                std::string lcaseTagName = toLower( tagName );
+                auto countIt = tagCounts.find( lcaseTagName );
+                if( countIt == tagCounts.end() )
+                    countIt = tagCounts.insert( std::make_pair( lcaseTagName, TagInfo() ) ).first;
+                countIt->second.add( tagName );
+            }
+        }
+
+        for( auto const& tagCount : tagCounts ) {
+            ReusableStringStream rss;
+            rss << "  " << std::setw(2) << tagCount.second.count << "  ";
+            auto str = rss.str();
+            auto wrapper = Column( tagCount.second.all() )
+                                                    .initialIndent( 0 )
+                                                    .indent( str.size() )
+                                                    .width( CATCH_CONFIG_CONSOLE_WIDTH-10 );
+            Catch::cout() << str << wrapper << '\n';
+        }
+        Catch::cout() << pluralise( tagCounts.size(), "tag" ) << '\n' << std::endl;
+        return tagCounts.size();
+    }
+
+    std::size_t listReporters() {
+        Catch::cout() << "Available reporters:\n";
+        IReporterRegistry::FactoryMap const& factories = getRegistryHub().getReporterRegistry().getFactories();
+        std::size_t maxNameLen = 0;
+        for( auto const& factoryKvp : factories )
+            maxNameLen = (std::max)( maxNameLen, factoryKvp.first.size() );
+
+        for( auto const& factoryKvp : factories ) {
+            Catch::cout()
+                    << Column( factoryKvp.first + ":" )
+                            .indent(2)
+                            .width( 5+maxNameLen )
+                    +  Column( factoryKvp.second->getDescription() )
+                            .initialIndent(0)
+                            .indent(2)
+                            .width( CATCH_CONFIG_CONSOLE_WIDTH - maxNameLen-8 )
+                    << "\n";
+        }
+        Catch::cout() << std::endl;
+        return factories.size();
+    }
+
+    Option<std::size_t> list( std::shared_ptr<Config> const& config ) {
+        Option<std::size_t> listedCount;
+        getCurrentMutableContext().setConfig( config );
+        if( config->listTests() )
+            listedCount = listedCount.valueOr(0) + listTests( *config );
+        if( config->listTestNamesOnly() )
+            listedCount = listedCount.valueOr(0) + listTestsNamesOnly( *config );
+        if( config->listTags() )
+            listedCount = listedCount.valueOr(0) + listTags( *config );
+        if( config->listReporters() )
+            listedCount = listedCount.valueOr(0) + listReporters();
+        return listedCount;
+    }
+
+} // end namespace Catch
+// end catch_list.cpp
+// start catch_matchers.cpp
+
+namespace Catch {
+namespace Matchers {
+    namespace Impl {
+
+        std::string MatcherUntypedBase::toString() const {
+            if( m_cachedToString.empty() )
+                m_cachedToString = describe();
+            return m_cachedToString;
+        }
+
+        MatcherUntypedBase::~MatcherUntypedBase() = default;
+
+    } // namespace Impl
+} // namespace Matchers
+
+using namespace Matchers;
+using Matchers::Impl::MatcherBase;
+
+} // namespace Catch
+// end catch_matchers.cpp
+// start catch_matchers_exception.cpp
+
+namespace Catch {
+namespace Matchers {
+namespace Exception {
+
+bool ExceptionMessageMatcher::match(std::exception const& ex) const {
+    return ex.what() == m_message;
+}
+
+std::string ExceptionMessageMatcher::describe() const {
+    return "exception message matches \"" + m_message + "\"";
+}
+
+}
+Exception::ExceptionMessageMatcher Message(std::string const& message) {
+    return Exception::ExceptionMessageMatcher(message);
+}
+
+// namespace Exception
+} // namespace Matchers
+} // namespace Catch
+// end catch_matchers_exception.cpp
+// start catch_matchers_floating.cpp
+
+// start catch_polyfills.hpp
+
+namespace Catch {
+    bool isnan(float f);
+    bool isnan(double d);
+}
+
+// end catch_polyfills.hpp
+// start catch_to_string.hpp
+
+#include <string>
+
+namespace Catch {
+    template <typename T>
+    std::string to_string(T const& t) {
+#if defined(CATCH_CONFIG_CPP11_TO_STRING)
+        return std::to_string(t);
+#else
+        ReusableStringStream rss;
+        rss << t;
+        return rss.str();
+#endif
+    }
+} // end namespace Catch
+
+// end catch_to_string.hpp
+#include <algorithm>
+#include <cmath>
+#include <cstdlib>
+#include <cstdint>
+#include <cstring>
+#include <sstream>
+#include <type_traits>
+#include <iomanip>
+#include <limits>
+
+namespace Catch {
+namespace {
+
+    int32_t convert(float f) {
+        static_assert(sizeof(float) == sizeof(int32_t), "Important ULP matcher assumption violated");
+        int32_t i;
+        std::memcpy(&i, &f, sizeof(f));
+        return i;
+    }
+
+    int64_t convert(double d) {
+        static_assert(sizeof(double) == sizeof(int64_t), "Important ULP matcher assumption violated");
+        int64_t i;
+        std::memcpy(&i, &d, sizeof(d));
+        return i;
+    }
+
+    template <typename FP>
+    bool almostEqualUlps(FP lhs, FP rhs, uint64_t maxUlpDiff) {
+        // Comparison with NaN should always be false.
+        // This way we can rule it out before getting into the ugly details
+        if (Catch::isnan(lhs) || Catch::isnan(rhs)) {
+            return false;
+        }
+
+        auto lc = convert(lhs);
+        auto rc = convert(rhs);
+
+        if ((lc < 0) != (rc < 0)) {
+            // Potentially we can have +0 and -0
+            return lhs == rhs;
+        }
+
+        // static cast as a workaround for IBM XLC
+        auto ulpDiff = std::abs(static_cast<FP>(lc - rc));
+        return static_cast<uint64_t>(ulpDiff) <= maxUlpDiff;
+    }
+
+#if defined(CATCH_CONFIG_GLOBAL_NEXTAFTER)
+
+    float nextafter(float x, float y) {
+        return ::nextafterf(x, y);
+    }
+
+    double nextafter(double x, double y) {
+        return ::nextafter(x, y);
+    }
+
+#endif // ^^^ CATCH_CONFIG_GLOBAL_NEXTAFTER ^^^
+
+template <typename FP>
+FP step(FP start, FP direction, uint64_t steps) {
+    for (uint64_t i = 0; i < steps; ++i) {
+#if defined(CATCH_CONFIG_GLOBAL_NEXTAFTER)
+        start = Catch::nextafter(start, direction);
+#else
+        start = std::nextafter(start, direction);
+#endif
+    }
+    return start;
+}
+
+// Performs equivalent check of std::fabs(lhs - rhs) <= margin
+// But without the subtraction to allow for INFINITY in comparison
+bool marginComparison(double lhs, double rhs, double margin) {
+    return (lhs + margin >= rhs) && (rhs + margin >= lhs);
+}
+
+template <typename FloatingPoint>
+void write(std::ostream& out, FloatingPoint num) {
+    out << std::scientific
+        << std::setprecision(std::numeric_limits<FloatingPoint>::max_digits10 - 1)
+        << num;
+}
+
+} // end anonymous namespace
+
+namespace Matchers {
+namespace Floating {
+
+    enum class FloatingPointKind : uint8_t {
+        Float,
+        Double
+    };
+
+    WithinAbsMatcher::WithinAbsMatcher(double target, double margin)
+        :m_target{ target }, m_margin{ margin } {
+        CATCH_ENFORCE(margin >= 0, "Invalid margin: " << margin << '.'
+            << " Margin has to be non-negative.");
+    }
+
+    // Performs equivalent check of std::fabs(lhs - rhs) <= margin
+    // But without the subtraction to allow for INFINITY in comparison
+    bool WithinAbsMatcher::match(double const& matchee) const {
+        return (matchee + m_margin >= m_target) && (m_target + m_margin >= matchee);
+    }
+
+    std::string WithinAbsMatcher::describe() const {
+        return "is within " + ::Catch::Detail::stringify(m_margin) + " of " + ::Catch::Detail::stringify(m_target);
+    }
+
+    WithinUlpsMatcher::WithinUlpsMatcher(double target, uint64_t ulps, FloatingPointKind baseType)
+        :m_target{ target }, m_ulps{ ulps }, m_type{ baseType } {
+        CATCH_ENFORCE(m_type == FloatingPointKind::Double
+                   || m_ulps < (std::numeric_limits<uint32_t>::max)(),
+            "Provided ULP is impossibly large for a float comparison.");
+    }
+
+#if defined(__clang__)
+#pragma clang diagnostic push
+// Clang <3.5 reports on the default branch in the switch below
+#pragma clang diagnostic ignored "-Wunreachable-code"
+#endif
+
+    bool WithinUlpsMatcher::match(double const& matchee) const {
+        switch (m_type) {
+        case FloatingPointKind::Float:
+            return almostEqualUlps<float>(static_cast<float>(matchee), static_cast<float>(m_target), m_ulps);
+        case FloatingPointKind::Double:
+            return almostEqualUlps<double>(matchee, m_target, m_ulps);
+        default:
+            CATCH_INTERNAL_ERROR( "Unknown FloatingPointKind value" );
+        }
+    }
+
+#if defined(__clang__)
+#pragma clang diagnostic pop
+#endif
+
+    std::string WithinUlpsMatcher::describe() const {
+        std::stringstream ret;
+
+        ret << "is within " << m_ulps << " ULPs of ";
+
+        if (m_type == FloatingPointKind::Float) {
+            write(ret, static_cast<float>(m_target));
+            ret << 'f';
+        } else {
+            write(ret, m_target);
+        }
+
+        ret << " ([";
+        if (m_type == FloatingPointKind::Double) {
+            write(ret, step(m_target, static_cast<double>(-INFINITY), m_ulps));
+            ret << ", ";
+            write(ret, step(m_target, static_cast<double>( INFINITY), m_ulps));
+        } else {
+            // We have to cast INFINITY to float because of MinGW, see #1782
+            write(ret, step(static_cast<float>(m_target), static_cast<float>(-INFINITY), m_ulps));
+            ret << ", ";
+            write(ret, step(static_cast<float>(m_target), static_cast<float>( INFINITY), m_ulps));
+        }
+        ret << "])";
+
+        return ret.str();
+    }
+
+    WithinRelMatcher::WithinRelMatcher(double target, double epsilon):
+        m_target(target),
+        m_epsilon(epsilon){
+        CATCH_ENFORCE(m_epsilon >= 0., "Relative comparison with epsilon <  0 does not make sense.");
+        CATCH_ENFORCE(m_epsilon  < 1., "Relative comparison with epsilon >= 1 does not make sense.");
+    }
+
+    bool WithinRelMatcher::match(double const& matchee) const {
+        const auto relMargin = m_epsilon * (std::max)(std::fabs(matchee), std::fabs(m_target));
+        return marginComparison(matchee, m_target,
+                                std::isinf(relMargin)? 0 : relMargin);
+    }
+
+    std::string WithinRelMatcher::describe() const {
+        Catch::ReusableStringStream sstr;
+        sstr << "and " << m_target << " are within " << m_epsilon * 100. << "% of each other";
+        return sstr.str();
+    }
+
+}// namespace Floating
+
+Floating::WithinUlpsMatcher WithinULP(double target, uint64_t maxUlpDiff) {
+    return Floating::WithinUlpsMatcher(target, maxUlpDiff, Floating::FloatingPointKind::Double);
+}
+
+Floating::WithinUlpsMatcher WithinULP(float target, uint64_t maxUlpDiff) {
+    return Floating::WithinUlpsMatcher(target, maxUlpDiff, Floating::FloatingPointKind::Float);
+}
+
+Floating::WithinAbsMatcher WithinAbs(double target, double margin) {
+    return Floating::WithinAbsMatcher(target, margin);
+}
+
+Floating::WithinRelMatcher WithinRel(double target, double eps) {
+    return Floating::WithinRelMatcher(target, eps);
+}
+
+Floating::WithinRelMatcher WithinRel(double target) {
+    return Floating::WithinRelMatcher(target, std::numeric_limits<double>::epsilon() * 100);
+}
+
+Floating::WithinRelMatcher WithinRel(float target, float eps) {
+    return Floating::WithinRelMatcher(target, eps);
+}
+
+Floating::WithinRelMatcher WithinRel(float target) {
+    return Floating::WithinRelMatcher(target, std::numeric_limits<float>::epsilon() * 100);
+}
+
+} // namespace Matchers
+} // namespace Catch
+// end catch_matchers_floating.cpp
+// start catch_matchers_generic.cpp
+
+std::string Catch::Matchers::Generic::Detail::finalizeDescription(const std::string& desc) {
+    if (desc.empty()) {
+        return "matches undescribed predicate";
+    } else {
+        return "matches predicate: \"" + desc + '"';
+    }
+}
+// end catch_matchers_generic.cpp
+// start catch_matchers_string.cpp
+
+#include <regex>
+
+namespace Catch {
+namespace Matchers {
+
+    namespace StdString {
+
+        CasedString::CasedString( std::string const& str, CaseSensitive::Choice caseSensitivity )
+        :   m_caseSensitivity( caseSensitivity ),
+            m_str( adjustString( str ) )
+        {}
+        std::string CasedString::adjustString( std::string const& str ) const {
+            return m_caseSensitivity == CaseSensitive::No
+                   ? toLower( str )
+                   : str;
+        }
+        std::string CasedString::caseSensitivitySuffix() const {
+            return m_caseSensitivity == CaseSensitive::No
+                   ? " (case insensitive)"
+                   : std::string();
+        }
+
+        StringMatcherBase::StringMatcherBase( std::string const& operation, CasedString const& comparator )
+        : m_comparator( comparator ),
+          m_operation( operation ) {
+        }
+
+        std::string StringMatcherBase::describe() const {
+            std::string description;
+            description.reserve(5 + m_operation.size() + m_comparator.m_str.size() +
+                                        m_comparator.caseSensitivitySuffix().size());
+            description += m_operation;
+            description += ": \"";
+            description += m_comparator.m_str;
+            description += "\"";
+            description += m_comparator.caseSensitivitySuffix();
+            return description;
+        }
+
+        EqualsMatcher::EqualsMatcher( CasedString const& comparator ) : StringMatcherBase( "equals", comparator ) {}
+
+        bool EqualsMatcher::match( std::string const& source ) const {
+            return m_comparator.adjustString( source ) == m_comparator.m_str;
+        }
+
+        ContainsMatcher::ContainsMatcher( CasedString const& comparator ) : StringMatcherBase( "contains", comparator ) {}
+
+        bool ContainsMatcher::match( std::string const& source ) const {
+            return contains( m_comparator.adjustString( source ), m_comparator.m_str );
+        }
+
+        StartsWithMatcher::StartsWithMatcher( CasedString const& comparator ) : StringMatcherBase( "starts with", comparator ) {}
+
+        bool StartsWithMatcher::match( std::string const& source ) const {
+            return startsWith( m_comparator.adjustString( source ), m_comparator.m_str );
+        }
+
+        EndsWithMatcher::EndsWithMatcher( CasedString const& comparator ) : StringMatcherBase( "ends with", comparator ) {}
+
+        bool EndsWithMatcher::match( std::string const& source ) const {
+            return endsWith( m_comparator.adjustString( source ), m_comparator.m_str );
+        }
+
+        RegexMatcher::RegexMatcher(std::string regex, CaseSensitive::Choice caseSensitivity): m_regex(std::move(regex)), m_caseSensitivity(caseSensitivity) {}
+
+        bool RegexMatcher::match(std::string const& matchee) const {
+            auto flags = std::regex::ECMAScript; // ECMAScript is the default syntax option anyway
+            if (m_caseSensitivity == CaseSensitive::Choice::No) {
+                flags |= std::regex::icase;
+            }
+            auto reg = std::regex(m_regex, flags);
+            return std::regex_match(matchee, reg);
+        }
+
+        std::string RegexMatcher::describe() const {
+            return "matches " + ::Catch::Detail::stringify(m_regex) + ((m_caseSensitivity == CaseSensitive::Choice::Yes)? " case sensitively" : " case insensitively");
+        }
+
+    } // namespace StdString
+
+    StdString::EqualsMatcher Equals( std::string const& str, CaseSensitive::Choice caseSensitivity ) {
+        return StdString::EqualsMatcher( StdString::CasedString( str, caseSensitivity) );
+    }
+    StdString::ContainsMatcher Contains( std::string const& str, CaseSensitive::Choice caseSensitivity ) {
+        return StdString::ContainsMatcher( StdString::CasedString( str, caseSensitivity) );
+    }
+    StdString::EndsWithMatcher EndsWith( std::string const& str, CaseSensitive::Choice caseSensitivity ) {
+        return StdString::EndsWithMatcher( StdString::CasedString( str, caseSensitivity) );
+    }
+    StdString::StartsWithMatcher StartsWith( std::string const& str, CaseSensitive::Choice caseSensitivity ) {
+        return StdString::StartsWithMatcher( StdString::CasedString( str, caseSensitivity) );
+    }
+
+    StdString::RegexMatcher Matches(std::string const& regex, CaseSensitive::Choice caseSensitivity) {
+        return StdString::RegexMatcher(regex, caseSensitivity);
+    }
+
+} // namespace Matchers
+} // namespace Catch
+// end catch_matchers_string.cpp
+// start catch_message.cpp
+
+// start catch_uncaught_exceptions.h
+
+namespace Catch {
+    bool uncaught_exceptions();
+} // end namespace Catch
+
+// end catch_uncaught_exceptions.h
+#include <cassert>
+#include <stack>
+
+namespace Catch {
+
+    MessageInfo::MessageInfo(   StringRef const& _macroName,
+                                SourceLineInfo const& _lineInfo,
+                                ResultWas::OfType _type )
+    :   macroName( _macroName ),
+        lineInfo( _lineInfo ),
+        type( _type ),
+        sequence( ++globalCount )
+    {}
+
+    bool MessageInfo::operator==( MessageInfo const& other ) const {
+        return sequence == other.sequence;
+    }
+
+    bool MessageInfo::operator<( MessageInfo const& other ) const {
+        return sequence < other.sequence;
+    }
+
+    // This may need protecting if threading support is added
+    unsigned int MessageInfo::globalCount = 0;
+
+    ////////////////////////////////////////////////////////////////////////////
+
+    Catch::MessageBuilder::MessageBuilder( StringRef const& macroName,
+                                           SourceLineInfo const& lineInfo,
+                                           ResultWas::OfType type )
+        :m_info(macroName, lineInfo, type) {}
+
+    ////////////////////////////////////////////////////////////////////////////
+
+    ScopedMessage::ScopedMessage( MessageBuilder const& builder )
+    : m_info( builder.m_info ), m_moved()
+    {
+        m_info.message = builder.m_stream.str();
+        getResultCapture().pushScopedMessage( m_info );
+    }
+
+    ScopedMessage::ScopedMessage( ScopedMessage&& old )
+    : m_info( old.m_info ), m_moved()
+    {
+        old.m_moved = true;
+    }
+
+    ScopedMessage::~ScopedMessage() {
+        if ( !uncaught_exceptions() && !m_moved ){
+            getResultCapture().popScopedMessage(m_info);
+        }
+    }
+
+    Capturer::Capturer( StringRef macroName, SourceLineInfo const& lineInfo, ResultWas::OfType resultType, StringRef names ) {
+        auto trimmed = [&] (size_t start, size_t end) {
+            while (names[start] == ',' || isspace(static_cast<unsigned char>(names[start]))) {
+                ++start;
+            }
+            while (names[end] == ',' || isspace(static_cast<unsigned char>(names[end]))) {
+                --end;
+            }
+            return names.substr(start, end - start + 1);
+        };
+        auto skipq = [&] (size_t start, char quote) {
+            for (auto i = start + 1; i < names.size() ; ++i) {
+                if (names[i] == quote)
+                    return i;
+                if (names[i] == '\\')
+                    ++i;
+            }
+            CATCH_INTERNAL_ERROR("CAPTURE parsing encountered unmatched quote");
+        };
+
+        size_t start = 0;
+        std::stack<char> openings;
+        for (size_t pos = 0; pos < names.size(); ++pos) {
+            char c = names[pos];
+            switch (c) {
+            case '[':
+            case '{':
+            case '(':
+            // It is basically impossible to disambiguate between
+            // comparison and start of template args in this context
+//            case '<':
+                openings.push(c);
+                break;
+            case ']':
+            case '}':
+            case ')':
+//           case '>':
+                openings.pop();
+                break;
+            case '"':
+            case '\'':
+                pos = skipq(pos, c);
+                break;
+            case ',':
+                if (start != pos && openings.empty()) {
+                    m_messages.emplace_back(macroName, lineInfo, resultType);
+                    m_messages.back().message = static_cast<std::string>(trimmed(start, pos));
+                    m_messages.back().message += " := ";
+                    start = pos;
+                }
+            }
+        }
+        assert(openings.empty() && "Mismatched openings");
+        m_messages.emplace_back(macroName, lineInfo, resultType);
+        m_messages.back().message = static_cast<std::string>(trimmed(start, names.size() - 1));
+        m_messages.back().message += " := ";
+    }
+    Capturer::~Capturer() {
+        if ( !uncaught_exceptions() ){
+            assert( m_captured == m_messages.size() );
+            for( size_t i = 0; i < m_captured; ++i  )
+                m_resultCapture.popScopedMessage( m_messages[i] );
+        }
+    }
+
+    void Capturer::captureValue( size_t index, std::string const& value ) {
+        assert( index < m_messages.size() );
+        m_messages[index].message += value;
+        m_resultCapture.pushScopedMessage( m_messages[index] );
+        m_captured++;
+    }
+
+} // end namespace Catch
+// end catch_message.cpp
+// start catch_output_redirect.cpp
+
+// start catch_output_redirect.h
+#ifndef TWOBLUECUBES_CATCH_OUTPUT_REDIRECT_H
+#define TWOBLUECUBES_CATCH_OUTPUT_REDIRECT_H
+
+#include <cstdio>
+#include <iosfwd>
+#include <string>
+
+namespace Catch {
+
+    class RedirectedStream {
+        std::ostream& m_originalStream;
+        std::ostream& m_redirectionStream;
+        std::streambuf* m_prevBuf;
+
+    public:
+        RedirectedStream( std::ostream& originalStream, std::ostream& redirectionStream );
+        ~RedirectedStream();
+    };
+
+    class RedirectedStdOut {
+        ReusableStringStream m_rss;
+        RedirectedStream m_cout;
+    public:
+        RedirectedStdOut();
+        auto str() const -> std::string;
+    };
+
+    // StdErr has two constituent streams in C++, std::cerr and std::clog
+    // This means that we need to redirect 2 streams into 1 to keep proper
+    // order of writes
+    class RedirectedStdErr {
+        ReusableStringStream m_rss;
+        RedirectedStream m_cerr;
+        RedirectedStream m_clog;
+    public:
+        RedirectedStdErr();
+        auto str() const -> std::string;
+    };
+
+    class RedirectedStreams {
+    public:
+        RedirectedStreams(RedirectedStreams const&) = delete;
+        RedirectedStreams& operator=(RedirectedStreams const&) = delete;
+        RedirectedStreams(RedirectedStreams&&) = delete;
+        RedirectedStreams& operator=(RedirectedStreams&&) = delete;
+
+        RedirectedStreams(std::string& redirectedCout, std::string& redirectedCerr);
+        ~RedirectedStreams();
+    private:
+        std::string& m_redirectedCout;
+        std::string& m_redirectedCerr;
+        RedirectedStdOut m_redirectedStdOut;
+        RedirectedStdErr m_redirectedStdErr;
+    };
+
+#if defined(CATCH_CONFIG_NEW_CAPTURE)
+
+    // Windows's implementation of std::tmpfile is terrible (it tries
+    // to create a file inside system folder, thus requiring elevated
+    // privileges for the binary), so we have to use tmpnam(_s) and
+    // create the file ourselves there.
+    class TempFile {
+    public:
+        TempFile(TempFile const&) = delete;
+        TempFile& operator=(TempFile const&) = delete;
+        TempFile(TempFile&&) = delete;
+        TempFile& operator=(TempFile&&) = delete;
+
+        TempFile();
+        ~TempFile();
+
+        std::FILE* getFile();
+        std::string getContents();
+
+    private:
+        std::FILE* m_file = nullptr;
+    #if defined(_MSC_VER)
+        char m_buffer[L_tmpnam] = { 0 };
+    #endif
+    };
+
+    class OutputRedirect {
+    public:
+        OutputRedirect(OutputRedirect const&) = delete;
+        OutputRedirect& operator=(OutputRedirect const&) = delete;
+        OutputRedirect(OutputRedirect&&) = delete;
+        OutputRedirect& operator=(OutputRedirect&&) = delete;
+
+        OutputRedirect(std::string& stdout_dest, std::string& stderr_dest);
+        ~OutputRedirect();
+
+    private:
+        int m_originalStdout = -1;
+        int m_originalStderr = -1;
+        TempFile m_stdoutFile;
+        TempFile m_stderrFile;
+        std::string& m_stdoutDest;
+        std::string& m_stderrDest;
+    };
+
+#endif
+
+} // end namespace Catch
+
+#endif // TWOBLUECUBES_CATCH_OUTPUT_REDIRECT_H
+// end catch_output_redirect.h
+#include <cstdio>
+#include <cstring>
+#include <fstream>
+#include <sstream>
+#include <stdexcept>
+
+#if defined(CATCH_CONFIG_NEW_CAPTURE)
+    #if defined(_MSC_VER)
+    #include <io.h>      //_dup and _dup2
+    #define dup _dup
+    #define dup2 _dup2
+    #define fileno _fileno
+    #else
+    #include <unistd.h>  // dup and dup2
+    #endif
+#endif
+
+namespace Catch {
+
+    RedirectedStream::RedirectedStream( std::ostream& originalStream, std::ostream& redirectionStream )
+    :   m_originalStream( originalStream ),
+        m_redirectionStream( redirectionStream ),
+        m_prevBuf( m_originalStream.rdbuf() )
+    {
+        m_originalStream.rdbuf( m_redirectionStream.rdbuf() );
+    }
+
+    RedirectedStream::~RedirectedStream() {
+        m_originalStream.rdbuf( m_prevBuf );
+    }
+
+    RedirectedStdOut::RedirectedStdOut() : m_cout( Catch::cout(), m_rss.get() ) {}
+    auto RedirectedStdOut::str() const -> std::string { return m_rss.str(); }
+
+    RedirectedStdErr::RedirectedStdErr()
+    :   m_cerr( Catch::cerr(), m_rss.get() ),
+        m_clog( Catch::clog(), m_rss.get() )
+    {}
+    auto RedirectedStdErr::str() const -> std::string { return m_rss.str(); }
+
+    RedirectedStreams::RedirectedStreams(std::string& redirectedCout, std::string& redirectedCerr)
+    :   m_redirectedCout(redirectedCout),
+        m_redirectedCerr(redirectedCerr)
+    {}
+
+    RedirectedStreams::~RedirectedStreams() {
+        m_redirectedCout += m_redirectedStdOut.str();
+        m_redirectedCerr += m_redirectedStdErr.str();
+    }
+
+#if defined(CATCH_CONFIG_NEW_CAPTURE)
+
+#if defined(_MSC_VER)
+    TempFile::TempFile() {
+        if (tmpnam_s(m_buffer)) {
+            CATCH_RUNTIME_ERROR("Could not get a temp filename");
+        }
+        if (fopen_s(&m_file, m_buffer, "w+")) {
+            char buffer[100];
+            if (strerror_s(buffer, errno)) {
+                CATCH_RUNTIME_ERROR("Could not translate errno to a string");
+            }
+            CATCH_RUNTIME_ERROR("Could not open the temp file: '" << m_buffer << "' because: " << buffer);
+        }
+    }
+#else
+    TempFile::TempFile() {
+        m_file = std::tmpfile();
+        if (!m_file) {
+            CATCH_RUNTIME_ERROR("Could not create a temp file.");
+        }
+    }
+
+#endif
+
+    TempFile::~TempFile() {
+         // TBD: What to do about errors here?
+         std::fclose(m_file);
+         // We manually create the file on Windows only, on Linux
+         // it will be autodeleted
+#if defined(_MSC_VER)
+         std::remove(m_buffer);
+#endif
+    }
+
+    FILE* TempFile::getFile() {
+        return m_file;
+    }
+
+    std::string TempFile::getContents() {
+        std::stringstream sstr;
+        char buffer[100] = {};
+        std::rewind(m_file);
+        while (std::fgets(buffer, sizeof(buffer), m_file)) {
+            sstr << buffer;
+        }
+        return sstr.str();
+    }
+
+    OutputRedirect::OutputRedirect(std::string& stdout_dest, std::string& stderr_dest) :
+        m_originalStdout(dup(1)),
+        m_originalStderr(dup(2)),
+        m_stdoutDest(stdout_dest),
+        m_stderrDest(stderr_dest) {
+        dup2(fileno(m_stdoutFile.getFile()), 1);
+        dup2(fileno(m_stderrFile.getFile()), 2);
+    }
+
+    OutputRedirect::~OutputRedirect() {
+        Catch::cout() << std::flush;
+        fflush(stdout);
+        // Since we support overriding these streams, we flush cerr
+        // even though std::cerr is unbuffered
+        Catch::cerr() << std::flush;
+        Catch::clog() << std::flush;
+        fflush(stderr);
+
+        dup2(m_originalStdout, 1);
+        dup2(m_originalStderr, 2);
+
+        m_stdoutDest += m_stdoutFile.getContents();
+        m_stderrDest += m_stderrFile.getContents();
+    }
+
+#endif // CATCH_CONFIG_NEW_CAPTURE
+
+} // namespace Catch
+
+#if defined(CATCH_CONFIG_NEW_CAPTURE)
+    #if defined(_MSC_VER)
+    #undef dup
+    #undef dup2
+    #undef fileno
+    #endif
+#endif
+// end catch_output_redirect.cpp
+// start catch_polyfills.cpp
+
+#include <cmath>
+
+namespace Catch {
+
+#if !defined(CATCH_CONFIG_POLYFILL_ISNAN)
+    bool isnan(float f) {
+        return std::isnan(f);
+    }
+    bool isnan(double d) {
+        return std::isnan(d);
+    }
+#else
+    // For now we only use this for embarcadero
+    bool isnan(float f) {
+        return std::_isnan(f);
+    }
+    bool isnan(double d) {
+        return std::_isnan(d);
+    }
+#endif
+
+} // end namespace Catch
+// end catch_polyfills.cpp
+// start catch_random_number_generator.cpp
+
+namespace Catch {
+
+namespace {
+
+#if defined(_MSC_VER)
+#pragma warning(push)
+#pragma warning(disable:4146) // we negate uint32 during the rotate
+#endif
+        // Safe rotr implementation thanks to John Regehr
+        uint32_t rotate_right(uint32_t val, uint32_t count) {
+            const uint32_t mask = 31;
+            count &= mask;
+            return (val >> count) | (val << (-count & mask));
+        }
+
+#if defined(_MSC_VER)
+#pragma warning(pop)
+#endif
+
+}
+
+    SimplePcg32::SimplePcg32(result_type seed_) {
+        seed(seed_);
+    }
+
+    void SimplePcg32::seed(result_type seed_) {
+        m_state = 0;
+        (*this)();
+        m_state += seed_;
+        (*this)();
+    }
+
+    void SimplePcg32::discard(uint64_t skip) {
+        // We could implement this to run in O(log n) steps, but this
+        // should suffice for our use case.
+        for (uint64_t s = 0; s < skip; ++s) {
+            static_cast<void>((*this)());
+        }
+    }
+
+    SimplePcg32::result_type SimplePcg32::operator()() {
+        // prepare the output value
+        const uint32_t xorshifted = static_cast<uint32_t>(((m_state >> 18u) ^ m_state) >> 27u);
+        const auto output = rotate_right(xorshifted, m_state >> 59u);
+
+        // advance state
+        m_state = m_state * 6364136223846793005ULL + s_inc;
+
+        return output;
+    }
+
+    bool operator==(SimplePcg32 const& lhs, SimplePcg32 const& rhs) {
+        return lhs.m_state == rhs.m_state;
+    }
+
+    bool operator!=(SimplePcg32 const& lhs, SimplePcg32 const& rhs) {
+        return lhs.m_state != rhs.m_state;
+    }
+}
+// end catch_random_number_generator.cpp
+// start catch_registry_hub.cpp
+
+// start catch_test_case_registry_impl.h
+
+#include <vector>
+#include <set>
+#include <algorithm>
+#include <ios>
+
+namespace Catch {
+
+    class TestCase;
+    struct IConfig;
+
+    std::vector<TestCase> sortTests( IConfig const& config, std::vector<TestCase> const& unsortedTestCases );
+
+    bool isThrowSafe( TestCase const& testCase, IConfig const& config );
+    bool matchTest( TestCase const& testCase, TestSpec const& testSpec, IConfig const& config );
+
+    void enforceNoDuplicateTestCases( std::vector<TestCase> const& functions );
+
+    std::vector<TestCase> filterTests( std::vector<TestCase> const& testCases, TestSpec const& testSpec, IConfig const& config );
+    std::vector<TestCase> const& getAllTestCasesSorted( IConfig const& config );
+
+    class TestRegistry : public ITestCaseRegistry {
+    public:
+        virtual ~TestRegistry() = default;
+
+        virtual void registerTest( TestCase const& testCase );
+
+        std::vector<TestCase> const& getAllTests() const override;
+        std::vector<TestCase> const& getAllTestsSorted( IConfig const& config ) const override;
+
+    private:
+        std::vector<TestCase> m_functions;
+        mutable RunTests::InWhatOrder m_currentSortOrder = RunTests::InDeclarationOrder;
+        mutable std::vector<TestCase> m_sortedFunctions;
+        std::size_t m_unnamedCount = 0;
+        std::ios_base::Init m_ostreamInit; // Forces cout/ cerr to be initialised
+    };
+
+    ///////////////////////////////////////////////////////////////////////////
+
+    class TestInvokerAsFunction : public ITestInvoker {
+        void(*m_testAsFunction)();
+    public:
+        TestInvokerAsFunction( void(*testAsFunction)() ) noexcept;
+
+        void invoke() const override;
+    };
+
+    std::string extractClassName( StringRef const& classOrQualifiedMethodName );
+
+    ///////////////////////////////////////////////////////////////////////////
+
+} // end namespace Catch
+
+// end catch_test_case_registry_impl.h
+// start catch_reporter_registry.h
+
+#include <map>
+
+namespace Catch {
+
+    class ReporterRegistry : public IReporterRegistry {
+
+    public:
+
+        ~ReporterRegistry() override;
+
+        IStreamingReporterPtr create( std::string const& name, IConfigPtr const& config ) const override;
+
+        void registerReporter( std::string const& name, IReporterFactoryPtr const& factory );
+        void registerListener( IReporterFactoryPtr const& factory );
+
+        FactoryMap const& getFactories() const override;
+        Listeners const& getListeners() const override;
+
+    private:
+        FactoryMap m_factories;
+        Listeners m_listeners;
+    };
+}
+
+// end catch_reporter_registry.h
+// start catch_tag_alias_registry.h
+
+// start catch_tag_alias.h
+
+#include <string>
+
+namespace Catch {
+
+    struct TagAlias {
+        TagAlias(std::string const& _tag, SourceLineInfo _lineInfo);
+
+        std::string tag;
+        SourceLineInfo lineInfo;
+    };
+
+} // end namespace Catch
+
+// end catch_tag_alias.h
+#include <map>
+
+namespace Catch {
+
+    class TagAliasRegistry : public ITagAliasRegistry {
+    public:
+        ~TagAliasRegistry() override;
+        TagAlias const* find( std::string const& alias ) const override;
+        std::string expandAliases( std::string const& unexpandedTestSpec ) const override;
+        void add( std::string const& alias, std::string const& tag, SourceLineInfo const& lineInfo );
+
+    private:
+        std::map<std::string, TagAlias> m_registry;
+    };
+
+} // end namespace Catch
+
+// end catch_tag_alias_registry.h
+// start catch_startup_exception_registry.h
+
+#include <vector>
+#include <exception>
+
+namespace Catch {
+
+    class StartupExceptionRegistry {
+#if !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+    public:
+        void add(std::exception_ptr const& exception) noexcept;
+        std::vector<std::exception_ptr> const& getExceptions() const noexcept;
+    private:
+        std::vector<std::exception_ptr> m_exceptions;
+#endif
+    };
+
+} // end namespace Catch
+
+// end catch_startup_exception_registry.h
+// start catch_singletons.hpp
+
+namespace Catch {
+
+    struct ISingleton {
+        virtual ~ISingleton();
+    };
+
+    void addSingleton( ISingleton* singleton );
+    void cleanupSingletons();
+
+    template<typename SingletonImplT, typename InterfaceT = SingletonImplT, typename MutableInterfaceT = InterfaceT>
+    class Singleton : SingletonImplT, public ISingleton {
+
+        static auto getInternal() -> Singleton* {
+            static Singleton* s_instance = nullptr;
+            if( !s_instance ) {
+                s_instance = new Singleton;
+                addSingleton( s_instance );
+            }
+            return s_instance;
+        }
+
+    public:
+        static auto get() -> InterfaceT const& {
+            return *getInternal();
+        }
+        static auto getMutable() -> MutableInterfaceT& {
+            return *getInternal();
+        }
+    };
+
+} // namespace Catch
+
+// end catch_singletons.hpp
+namespace Catch {
+
+    namespace {
+
+        class RegistryHub : public IRegistryHub, public IMutableRegistryHub,
+                            private NonCopyable {
+
+        public: // IRegistryHub
+            RegistryHub() = default;
+            IReporterRegistry const& getReporterRegistry() const override {
+                return m_reporterRegistry;
+            }
+            ITestCaseRegistry const& getTestCaseRegistry() const override {
+                return m_testCaseRegistry;
+            }
+            IExceptionTranslatorRegistry const& getExceptionTranslatorRegistry() const override {
+                return m_exceptionTranslatorRegistry;
+            }
+            ITagAliasRegistry const& getTagAliasRegistry() const override {
+                return m_tagAliasRegistry;
+            }
+            StartupExceptionRegistry const& getStartupExceptionRegistry() const override {
+                return m_exceptionRegistry;
+            }
+
+        public: // IMutableRegistryHub
+            void registerReporter( std::string const& name, IReporterFactoryPtr const& factory ) override {
+                m_reporterRegistry.registerReporter( name, factory );
+            }
+            void registerListener( IReporterFactoryPtr const& factory ) override {
+                m_reporterRegistry.registerListener( factory );
+            }
+            void registerTest( TestCase const& testInfo ) override {
+                m_testCaseRegistry.registerTest( testInfo );
+            }
+            void registerTranslator( const IExceptionTranslator* translator ) override {
+                m_exceptionTranslatorRegistry.registerTranslator( translator );
+            }
+            void registerTagAlias( std::string const& alias, std::string const& tag, SourceLineInfo const& lineInfo ) override {
+                m_tagAliasRegistry.add( alias, tag, lineInfo );
+            }
+            void registerStartupException() noexcept override {
+#if !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+                m_exceptionRegistry.add(std::current_exception());
+#else
+                CATCH_INTERNAL_ERROR("Attempted to register active exception under CATCH_CONFIG_DISABLE_EXCEPTIONS!");
+#endif
+            }
+            IMutableEnumValuesRegistry& getMutableEnumValuesRegistry() override {
+                return m_enumValuesRegistry;
+            }
+
+        private:
+            TestRegistry m_testCaseRegistry;
+            ReporterRegistry m_reporterRegistry;
+            ExceptionTranslatorRegistry m_exceptionTranslatorRegistry;
+            TagAliasRegistry m_tagAliasRegistry;
+            StartupExceptionRegistry m_exceptionRegistry;
+            Detail::EnumValuesRegistry m_enumValuesRegistry;
+        };
+    }
+
+    using RegistryHubSingleton = Singleton<RegistryHub, IRegistryHub, IMutableRegistryHub>;
+
+    IRegistryHub const& getRegistryHub() {
+        return RegistryHubSingleton::get();
+    }
+    IMutableRegistryHub& getMutableRegistryHub() {
+        return RegistryHubSingleton::getMutable();
+    }
+    void cleanUp() {
+        cleanupSingletons();
+        cleanUpContext();
+    }
+    std::string translateActiveException() {
+        return getRegistryHub().getExceptionTranslatorRegistry().translateActiveException();
+    }
+
+} // end namespace Catch
+// end catch_registry_hub.cpp
+// start catch_reporter_registry.cpp
+
+namespace Catch {
+
+    ReporterRegistry::~ReporterRegistry() = default;
+
+    IStreamingReporterPtr ReporterRegistry::create( std::string const& name, IConfigPtr const& config ) const {
+        auto it =  m_factories.find( name );
+        if( it == m_factories.end() )
+            return nullptr;
+        return it->second->create( ReporterConfig( config ) );
+    }
+
+    void ReporterRegistry::registerReporter( std::string const& name, IReporterFactoryPtr const& factory ) {
+        m_factories.emplace(name, factory);
+    }
+    void ReporterRegistry::registerListener( IReporterFactoryPtr const& factory ) {
+        m_listeners.push_back( factory );
+    }
+
+    IReporterRegistry::FactoryMap const& ReporterRegistry::getFactories() const {
+        return m_factories;
+    }
+    IReporterRegistry::Listeners const& ReporterRegistry::getListeners() const {
+        return m_listeners;
+    }
+
+}
+// end catch_reporter_registry.cpp
+// start catch_result_type.cpp
+
+namespace Catch {
+
+    bool isOk( ResultWas::OfType resultType ) {
+        return ( resultType & ResultWas::FailureBit ) == 0;
+    }
+    bool isJustInfo( int flags ) {
+        return flags == ResultWas::Info;
+    }
+
+    ResultDisposition::Flags operator | ( ResultDisposition::Flags lhs, ResultDisposition::Flags rhs ) {
+        return static_cast<ResultDisposition::Flags>( static_cast<int>( lhs ) | static_cast<int>( rhs ) );
+    }
+
+    bool shouldContinueOnFailure( int flags )    { return ( flags & ResultDisposition::ContinueOnFailure ) != 0; }
+    bool shouldSuppressFailure( int flags )      { return ( flags & ResultDisposition::SuppressFail ) != 0; }
+
+} // end namespace Catch
+// end catch_result_type.cpp
+// start catch_run_context.cpp
+
+#include <cassert>
+#include <algorithm>
+#include <sstream>
+
+namespace Catch {
+
+    namespace Generators {
+        struct GeneratorTracker : TestCaseTracking::TrackerBase, IGeneratorTracker {
+            GeneratorBasePtr m_generator;
+
+            GeneratorTracker( TestCaseTracking::NameAndLocation const& nameAndLocation, TrackerContext& ctx, ITracker* parent )
+            :   TrackerBase( nameAndLocation, ctx, parent )
+            {}
+            ~GeneratorTracker();
+
+            static GeneratorTracker& acquire( TrackerContext& ctx, TestCaseTracking::NameAndLocation const& nameAndLocation ) {
+                std::shared_ptr<GeneratorTracker> tracker;
+
+                ITracker& currentTracker = ctx.currentTracker();
+                // Under specific circumstances, the generator we want
+                // to acquire is also the current tracker. If this is
+                // the case, we have to avoid looking through current
+                // tracker's children, and instead return the current
+                // tracker.
+                // A case where this check is important is e.g.
+                //     for (int i = 0; i < 5; ++i) {
+                //         int n = GENERATE(1, 2);
+                //     }
+                //
+                // without it, the code above creates 5 nested generators.
+                if (currentTracker.nameAndLocation() == nameAndLocation) {
+                    auto thisTracker = currentTracker.parent().findChild(nameAndLocation);
+                    assert(thisTracker);
+                    assert(thisTracker->isGeneratorTracker());
+                    tracker = std::static_pointer_cast<GeneratorTracker>(thisTracker);
+                } else if ( TestCaseTracking::ITrackerPtr childTracker = currentTracker.findChild( nameAndLocation ) ) {
+                    assert( childTracker );
+                    assert( childTracker->isGeneratorTracker() );
+                    tracker = std::static_pointer_cast<GeneratorTracker>( childTracker );
+                } else {
+                    tracker = std::make_shared<GeneratorTracker>( nameAndLocation, ctx, &currentTracker );
+                    currentTracker.addChild( tracker );
+                }
+
+                if( !tracker->isComplete() ) {
+                    tracker->open();
+                }
+
+                return *tracker;
+            }
+
+            // TrackerBase interface
+            bool isGeneratorTracker() const override { return true; }
+            auto hasGenerator() const -> bool override {
+                return !!m_generator;
+            }
+            void close() override {
+                TrackerBase::close();
+                // If a generator has a child (it is followed by a section)
+                // and none of its children have started, then we must wait
+                // until later to start consuming its values.
+                // This catches cases where `GENERATE` is placed between two
+                // `SECTION`s.
+                // **The check for m_children.empty cannot be removed**.
+                // doing so would break `GENERATE` _not_ followed by `SECTION`s.
+                const bool should_wait_for_child = [&]() {
+                    // No children -> nobody to wait for
+                    if ( m_children.empty() ) {
+                        return false;
+                    }
+                    // If at least one child started executing, don't wait
+                    if ( std::find_if(
+                             m_children.begin(),
+                             m_children.end(),
+                             []( TestCaseTracking::ITrackerPtr tracker ) {
+                                 return tracker->hasStarted();
+                             } ) != m_children.end() ) {
+                        return false;
+                    }
+
+                    // No children have started. We need to check if they _can_
+                    // start, and thus we should wait for them, or they cannot
+                    // start (due to filters), and we shouldn't wait for them
+                    auto* parent = m_parent;
+                    // This is safe: there is always at least one section
+                    // tracker in a test case tracking tree
+                    while ( !parent->isSectionTracker() ) {
+                        parent = &( parent->parent() );
+                    }
+                    assert( parent &&
+                            "Missing root (test case) level section" );
+
+                    auto const& parentSection =
+                        static_cast<SectionTracker&>( *parent );
+                    auto const& filters = parentSection.getFilters();
+                    // No filters -> no restrictions on running sections
+                    if ( filters.empty() ) {
+                        return true;
+                    }
+
+                    for ( auto const& child : m_children ) {
+                        if ( child->isSectionTracker() &&
+                             std::find( filters.begin(),
+                                        filters.end(),
+                                        static_cast<SectionTracker&>( *child )
+                                            .trimmedName() ) !=
+                                 filters.end() ) {
+                            return true;
+                        }
+                    }
+                    return false;
+                }();
+
+                // This check is a bit tricky, because m_generator->next()
+                // has a side-effect, where it consumes generator's current
+                // value, but we do not want to invoke the side-effect if
+                // this generator is still waiting for any child to start.
+                if ( should_wait_for_child ||
+                     ( m_runState == CompletedSuccessfully &&
+                       m_generator->next() ) ) {
+                    m_children.clear();
+                    m_runState = Executing;
+                }
+            }
+
+            // IGeneratorTracker interface
+            auto getGenerator() const -> GeneratorBasePtr const& override {
+                return m_generator;
+            }
+            void setGenerator( GeneratorBasePtr&& generator ) override {
+                m_generator = std::move( generator );
+            }
+        };
+        GeneratorTracker::~GeneratorTracker() {}
+    }
+
+    RunContext::RunContext(IConfigPtr const& _config, IStreamingReporterPtr&& reporter)
+    :   m_runInfo(_config->name()),
+        m_context(getCurrentMutableContext()),
+        m_config(_config),
+        m_reporter(std::move(reporter)),
+        m_lastAssertionInfo{ StringRef(), SourceLineInfo("",0), StringRef(), ResultDisposition::Normal },
+        m_includeSuccessfulResults( m_config->includeSuccessfulResults() || m_reporter->getPreferences().shouldReportAllAssertions )
+    {
+        m_context.setRunner(this);
+        m_context.setConfig(m_config);
+        m_context.setResultCapture(this);
+        m_reporter->testRunStarting(m_runInfo);
+    }
+
+    RunContext::~RunContext() {
+        m_reporter->testRunEnded(TestRunStats(m_runInfo, m_totals, aborting()));
+    }
+
+    void RunContext::testGroupStarting(std::string const& testSpec, std::size_t groupIndex, std::size_t groupsCount) {
+        m_reporter->testGroupStarting(GroupInfo(testSpec, groupIndex, groupsCount));
+    }
+
+    void RunContext::testGroupEnded(std::string const& testSpec, Totals const& totals, std::size_t groupIndex, std::size_t groupsCount) {
+        m_reporter->testGroupEnded(TestGroupStats(GroupInfo(testSpec, groupIndex, groupsCount), totals, aborting()));
+    }
+
+    Totals RunContext::runTest(TestCase const& testCase) {
+        Totals prevTotals = m_totals;
+
+        std::string redirectedCout;
+        std::string redirectedCerr;
+
+        auto const& testInfo = testCase.getTestCaseInfo();
+
+        m_reporter->testCaseStarting(testInfo);
+
+        m_activeTestCase = &testCase;
+
+        ITracker& rootTracker = m_trackerContext.startRun();
+        assert(rootTracker.isSectionTracker());
+        static_cast<SectionTracker&>(rootTracker).addInitialFilters(m_config->getSectionsToRun());
+        do {
+            m_trackerContext.startCycle();
+            m_testCaseTracker = &SectionTracker::acquire(m_trackerContext, TestCaseTracking::NameAndLocation(testInfo.name, testInfo.lineInfo));
+            runCurrentTest(redirectedCout, redirectedCerr);
+        } while (!m_testCaseTracker->isSuccessfullyCompleted() && !aborting());
+
+        Totals deltaTotals = m_totals.delta(prevTotals);
+        if (testInfo.expectedToFail() && deltaTotals.testCases.passed > 0) {
+            deltaTotals.assertions.failed++;
+            deltaTotals.testCases.passed--;
+            deltaTotals.testCases.failed++;
+        }
+        m_totals.testCases += deltaTotals.testCases;
+        m_reporter->testCaseEnded(TestCaseStats(testInfo,
+                                  deltaTotals,
+                                  redirectedCout,
+                                  redirectedCerr,
+                                  aborting()));
+
+        m_activeTestCase = nullptr;
+        m_testCaseTracker = nullptr;
+
+        return deltaTotals;
+    }
+
+    IConfigPtr RunContext::config() const {
+        return m_config;
+    }
+
+    IStreamingReporter& RunContext::reporter() const {
+        return *m_reporter;
+    }
+
+    void RunContext::assertionEnded(AssertionResult const & result) {
+        if (result.getResultType() == ResultWas::Ok) {
+            m_totals.assertions.passed++;
+            m_lastAssertionPassed = true;
+        } else if (!result.isOk()) {
+            m_lastAssertionPassed = false;
+            if( m_activeTestCase->getTestCaseInfo().okToFail() )
+                m_totals.assertions.failedButOk++;
+            else
+                m_totals.assertions.failed++;
+        }
+        else {
+            m_lastAssertionPassed = true;
+        }
+
+        // We have no use for the return value (whether messages should be cleared), because messages were made scoped
+        // and should be let to clear themselves out.
+        static_cast<void>(m_reporter->assertionEnded(AssertionStats(result, m_messages, m_totals)));
+
+        if (result.getResultType() != ResultWas::Warning)
+            m_messageScopes.clear();
+
+        // Reset working state
+        resetAssertionInfo();
+        m_lastResult = result;
+    }
+    void RunContext::resetAssertionInfo() {
+        m_lastAssertionInfo.macroName = StringRef();
+        m_lastAssertionInfo.capturedExpression = "{Unknown expression after the reported line}"_sr;
+    }
+
+    bool RunContext::sectionStarted(SectionInfo const & sectionInfo, Counts & assertions) {
+        ITracker& sectionTracker = SectionTracker::acquire(m_trackerContext, TestCaseTracking::NameAndLocation(sectionInfo.name, sectionInfo.lineInfo));
+        if (!sectionTracker.isOpen())
+            return false;
+        m_activeSections.push_back(&sectionTracker);
+
+        m_lastAssertionInfo.lineInfo = sectionInfo.lineInfo;
+
+        m_reporter->sectionStarting(sectionInfo);
+
+        assertions = m_totals.assertions;
+
+        return true;
+    }
+    auto RunContext::acquireGeneratorTracker( StringRef generatorName, SourceLineInfo const& lineInfo ) -> IGeneratorTracker& {
+        using namespace Generators;
+        GeneratorTracker& tracker = GeneratorTracker::acquire(m_trackerContext,
+                                                              TestCaseTracking::NameAndLocation( static_cast<std::string>(generatorName), lineInfo ) );
+        m_lastAssertionInfo.lineInfo = lineInfo;
+        return tracker;
+    }
+
+    bool RunContext::testForMissingAssertions(Counts& assertions) {
+        if (assertions.total() != 0)
+            return false;
+        if (!m_config->warnAboutMissingAssertions())
+            return false;
+        if (m_trackerContext.currentTracker().hasChildren())
+            return false;
+        m_totals.assertions.failed++;
+        assertions.failed++;
+        return true;
+    }
+
+    void RunContext::sectionEnded(SectionEndInfo const & endInfo) {
+        Counts assertions = m_totals.assertions - endInfo.prevAssertions;
+        bool missingAssertions = testForMissingAssertions(assertions);
+
+        if (!m_activeSections.empty()) {
+            m_activeSections.back()->close();
+            m_activeSections.pop_back();
+        }
+
+        m_reporter->sectionEnded(SectionStats(endInfo.sectionInfo, assertions, endInfo.durationInSeconds, missingAssertions));
+        m_messages.clear();
+        m_messageScopes.clear();
+    }
+
+    void RunContext::sectionEndedEarly(SectionEndInfo const & endInfo) {
+        if (m_unfinishedSections.empty())
+            m_activeSections.back()->fail();
+        else
+            m_activeSections.back()->close();
+        m_activeSections.pop_back();
+
+        m_unfinishedSections.push_back(endInfo);
+    }
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+    void RunContext::benchmarkPreparing(std::string const& name) {
+        m_reporter->benchmarkPreparing(name);
+    }
+    void RunContext::benchmarkStarting( BenchmarkInfo const& info ) {
+        m_reporter->benchmarkStarting( info );
+    }
+    void RunContext::benchmarkEnded( BenchmarkStats<> const& stats ) {
+        m_reporter->benchmarkEnded( stats );
+    }
+    void RunContext::benchmarkFailed(std::string const & error) {
+        m_reporter->benchmarkFailed(error);
+    }
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+    void RunContext::pushScopedMessage(MessageInfo const & message) {
+        m_messages.push_back(message);
+    }
+
+    void RunContext::popScopedMessage(MessageInfo const & message) {
+        m_messages.erase(std::remove(m_messages.begin(), m_messages.end(), message), m_messages.end());
+    }
+
+    void RunContext::emplaceUnscopedMessage( MessageBuilder const& builder ) {
+        m_messageScopes.emplace_back( builder );
+    }
+
+    std::string RunContext::getCurrentTestName() const {
+        return m_activeTestCase
+            ? m_activeTestCase->getTestCaseInfo().name
+            : std::string();
+    }
+
+    const AssertionResult * RunContext::getLastResult() const {
+        return &(*m_lastResult);
+    }
+
+    void RunContext::exceptionEarlyReported() {
+        m_shouldReportUnexpected = false;
+    }
+
+    void RunContext::handleFatalErrorCondition( StringRef message ) {
+        // First notify reporter that bad things happened
+        m_reporter->fatalErrorEncountered(message);
+
+        // Don't rebuild the result -- the stringification itself can cause more fatal errors
+        // Instead, fake a result data.
+        AssertionResultData tempResult( ResultWas::FatalErrorCondition, { false } );
+        tempResult.message = static_cast<std::string>(message);
+        AssertionResult result(m_lastAssertionInfo, tempResult);
+
+        assertionEnded(result);
+
+        handleUnfinishedSections();
+
+        // Recreate section for test case (as we will lose the one that was in scope)
+        auto const& testCaseInfo = m_activeTestCase->getTestCaseInfo();
+        SectionInfo testCaseSection(testCaseInfo.lineInfo, testCaseInfo.name);
+
+        Counts assertions;
+        assertions.failed = 1;
+        SectionStats testCaseSectionStats(testCaseSection, assertions, 0, false);
+        m_reporter->sectionEnded(testCaseSectionStats);
+
+        auto const& testInfo = m_activeTestCase->getTestCaseInfo();
+
+        Totals deltaTotals;
+        deltaTotals.testCases.failed = 1;
+        deltaTotals.assertions.failed = 1;
+        m_reporter->testCaseEnded(TestCaseStats(testInfo,
+                                  deltaTotals,
+                                  std::string(),
+                                  std::string(),
+                                  false));
+        m_totals.testCases.failed++;
+        testGroupEnded(std::string(), m_totals, 1, 1);
+        m_reporter->testRunEnded(TestRunStats(m_runInfo, m_totals, false));
+    }
+
+    bool RunContext::lastAssertionPassed() {
+         return m_lastAssertionPassed;
+    }
+
+    void RunContext::assertionPassed() {
+        m_lastAssertionPassed = true;
+        ++m_totals.assertions.passed;
+        resetAssertionInfo();
+        m_messageScopes.clear();
+    }
+
+    bool RunContext::aborting() const {
+        return m_totals.assertions.failed >= static_cast<std::size_t>(m_config->abortAfter());
+    }
+
+    void RunContext::runCurrentTest(std::string & redirectedCout, std::string & redirectedCerr) {
+        auto const& testCaseInfo = m_activeTestCase->getTestCaseInfo();
+        SectionInfo testCaseSection(testCaseInfo.lineInfo, testCaseInfo.name);
+        m_reporter->sectionStarting(testCaseSection);
+        Counts prevAssertions = m_totals.assertions;
+        double duration = 0;
+        m_shouldReportUnexpected = true;
+        m_lastAssertionInfo = { "TEST_CASE"_sr, testCaseInfo.lineInfo, StringRef(), ResultDisposition::Normal };
+
+        seedRng(*m_config);
+
+        Timer timer;
+        CATCH_TRY {
+            if (m_reporter->getPreferences().shouldRedirectStdOut) {
+#if !defined(CATCH_CONFIG_EXPERIMENTAL_REDIRECT)
+                RedirectedStreams redirectedStreams(redirectedCout, redirectedCerr);
+
+                timer.start();
+                invokeActiveTestCase();
+#else
+                OutputRedirect r(redirectedCout, redirectedCerr);
+                timer.start();
+                invokeActiveTestCase();
+#endif
+            } else {
+                timer.start();
+                invokeActiveTestCase();
+            }
+            duration = timer.getElapsedSeconds();
+        } CATCH_CATCH_ANON (TestFailureException&) {
+            // This just means the test was aborted due to failure
+        } CATCH_CATCH_ALL {
+            // Under CATCH_CONFIG_FAST_COMPILE, unexpected exceptions under REQUIRE assertions
+            // are reported without translation at the point of origin.
+            if( m_shouldReportUnexpected ) {
+                AssertionReaction dummyReaction;
+                handleUnexpectedInflightException( m_lastAssertionInfo, translateActiveException(), dummyReaction );
+            }
+        }
+        Counts assertions = m_totals.assertions - prevAssertions;
+        bool missingAssertions = testForMissingAssertions(assertions);
+
+        m_testCaseTracker->close();
+        handleUnfinishedSections();
+        m_messages.clear();
+        m_messageScopes.clear();
+
+        SectionStats testCaseSectionStats(testCaseSection, assertions, duration, missingAssertions);
+        m_reporter->sectionEnded(testCaseSectionStats);
+    }
+
+    void RunContext::invokeActiveTestCase() {
+        FatalConditionHandlerGuard _(&m_fatalConditionhandler);
+        m_activeTestCase->invoke();
+    }
+
+    void RunContext::handleUnfinishedSections() {
+        // If sections ended prematurely due to an exception we stored their
+        // infos here so we can tear them down outside the unwind process.
+        for (auto it = m_unfinishedSections.rbegin(),
+             itEnd = m_unfinishedSections.rend();
+             it != itEnd;
+             ++it)
+            sectionEnded(*it);
+        m_unfinishedSections.clear();
+    }
+
+    void RunContext::handleExpr(
+        AssertionInfo const& info,
+        ITransientExpression const& expr,
+        AssertionReaction& reaction
+    ) {
+        m_reporter->assertionStarting( info );
+
+        bool negated = isFalseTest( info.resultDisposition );
+        bool result = expr.getResult() != negated;
+
+        if( result ) {
+            if (!m_includeSuccessfulResults) {
+                assertionPassed();
+            }
+            else {
+                reportExpr(info, ResultWas::Ok, &expr, negated);
+            }
+        }
+        else {
+            reportExpr(info, ResultWas::ExpressionFailed, &expr, negated );
+            populateReaction( reaction );
+        }
+    }
+    void RunContext::reportExpr(
+            AssertionInfo const &info,
+            ResultWas::OfType resultType,
+            ITransientExpression const *expr,
+            bool negated ) {
+
+        m_lastAssertionInfo = info;
+        AssertionResultData data( resultType, LazyExpression( negated ) );
+
+        AssertionResult assertionResult{ info, data };
+        assertionResult.m_resultData.lazyExpression.m_transientExpression = expr;
+
+        assertionEnded( assertionResult );
+    }
+
+    void RunContext::handleMessage(
+            AssertionInfo const& info,
+            ResultWas::OfType resultType,
+            StringRef const& message,
+            AssertionReaction& reaction
+    ) {
+        m_reporter->assertionStarting( info );
+
+        m_lastAssertionInfo = info;
+
+        AssertionResultData data( resultType, LazyExpression( false ) );
+        data.message = static_cast<std::string>(message);
+        AssertionResult assertionResult{ m_lastAssertionInfo, data };
+        assertionEnded( assertionResult );
+        if( !assertionResult.isOk() )
+            populateReaction( reaction );
+    }
+    void RunContext::handleUnexpectedExceptionNotThrown(
+            AssertionInfo const& info,
+            AssertionReaction& reaction
+    ) {
+        handleNonExpr(info, Catch::ResultWas::DidntThrowException, reaction);
+    }
+
+    void RunContext::handleUnexpectedInflightException(
+            AssertionInfo const& info,
+            std::string const& message,
+            AssertionReaction& reaction
+    ) {
+        m_lastAssertionInfo = info;
+
+        AssertionResultData data( ResultWas::ThrewException, LazyExpression( false ) );
+        data.message = message;
+        AssertionResult assertionResult{ info, data };
+        assertionEnded( assertionResult );
+        populateReaction( reaction );
+    }
+
+    void RunContext::populateReaction( AssertionReaction& reaction ) {
+        reaction.shouldDebugBreak = m_config->shouldDebugBreak();
+        reaction.shouldThrow = aborting() || (m_lastAssertionInfo.resultDisposition & ResultDisposition::Normal);
+    }
+
+    void RunContext::handleIncomplete(
+            AssertionInfo const& info
+    ) {
+        m_lastAssertionInfo = info;
+
+        AssertionResultData data( ResultWas::ThrewException, LazyExpression( false ) );
+        data.message = "Exception translation was disabled by CATCH_CONFIG_FAST_COMPILE";
+        AssertionResult assertionResult{ info, data };
+        assertionEnded( assertionResult );
+    }
+    void RunContext::handleNonExpr(
+            AssertionInfo const &info,
+            ResultWas::OfType resultType,
+            AssertionReaction &reaction
+    ) {
+        m_lastAssertionInfo = info;
+
+        AssertionResultData data( resultType, LazyExpression( false ) );
+        AssertionResult assertionResult{ info, data };
+        assertionEnded( assertionResult );
+
+        if( !assertionResult.isOk() )
+            populateReaction( reaction );
+    }
+
+    IResultCapture& getResultCapture() {
+        if (auto* capture = getCurrentContext().getResultCapture())
+            return *capture;
+        else
+            CATCH_INTERNAL_ERROR("No result capture instance");
+    }
+
+    void seedRng(IConfig const& config) {
+        if (config.rngSeed() != 0) {
+            std::srand(config.rngSeed());
+            rng().seed(config.rngSeed());
+        }
+    }
+
+    unsigned int rngSeed() {
+        return getCurrentContext().getConfig()->rngSeed();
+    }
+
+}
+// end catch_run_context.cpp
+// start catch_section.cpp
+
+namespace Catch {
+
+    Section::Section( SectionInfo const& info )
+    :   m_info( info ),
+        m_sectionIncluded( getResultCapture().sectionStarted( m_info, m_assertions ) )
+    {
+        m_timer.start();
+    }
+
+    Section::~Section() {
+        if( m_sectionIncluded ) {
+            SectionEndInfo endInfo{ m_info, m_assertions, m_timer.getElapsedSeconds() };
+            if( uncaught_exceptions() )
+                getResultCapture().sectionEndedEarly( endInfo );
+            else
+                getResultCapture().sectionEnded( endInfo );
+        }
+    }
+
+    // This indicates whether the section should be executed or not
+    Section::operator bool() const {
+        return m_sectionIncluded;
+    }
+
+} // end namespace Catch
+// end catch_section.cpp
+// start catch_section_info.cpp
+
+namespace Catch {
+
+    SectionInfo::SectionInfo
+        (   SourceLineInfo const& _lineInfo,
+            std::string const& _name )
+    :   name( _name ),
+        lineInfo( _lineInfo )
+    {}
+
+} // end namespace Catch
+// end catch_section_info.cpp
+// start catch_session.cpp
+
+// start catch_session.h
+
+#include <memory>
+
+namespace Catch {
+
+    class Session : NonCopyable {
+    public:
+
+        Session();
+        ~Session() override;
+
+        void showHelp() const;
+        void libIdentify();
+
+        int applyCommandLine( int argc, char const * const * argv );
+    #if defined(CATCH_CONFIG_WCHAR) && defined(_WIN32) && defined(UNICODE)
+        int applyCommandLine( int argc, wchar_t const * const * argv );
+    #endif
+
+        void useConfigData( ConfigData const& configData );
+
+        template<typename CharT>
+        int run(int argc, CharT const * const argv[]) {
+            if (m_startupExceptions)
+                return 1;
+            int returnCode = applyCommandLine(argc, argv);
+            if (returnCode == 0)
+                returnCode = run();
+            return returnCode;
+        }
+
+        int run();
+
+        clara::Parser const& cli() const;
+        void cli( clara::Parser const& newParser );
+        ConfigData& configData();
+        Config& config();
+    private:
+        int runInternal();
+
+        clara::Parser m_cli;
+        ConfigData m_configData;
+        std::shared_ptr<Config> m_config;
+        bool m_startupExceptions = false;
+    };
+
+} // end namespace Catch
+
+// end catch_session.h
+// start catch_version.h
+
+#include <iosfwd>
+
+namespace Catch {
+
+    // Versioning information
+    struct Version {
+        Version( Version const& ) = delete;
+        Version& operator=( Version const& ) = delete;
+        Version(    unsigned int _majorVersion,
+                    unsigned int _minorVersion,
+                    unsigned int _patchNumber,
+                    char const * const _branchName,
+                    unsigned int _buildNumber );
+
+        unsigned int const majorVersion;
+        unsigned int const minorVersion;
+        unsigned int const patchNumber;
+
+        // buildNumber is only used if branchName is not null
+        char const * const branchName;
+        unsigned int const buildNumber;
+
+        friend std::ostream& operator << ( std::ostream& os, Version const& version );
+    };
+
+    Version const& libraryVersion();
+}
+
+// end catch_version.h
+#include <cstdlib>
+#include <iomanip>
+#include <set>
+#include <iterator>
+
+namespace Catch {
+
+    namespace {
+        const int MaxExitCode = 255;
+
+        IStreamingReporterPtr createReporter(std::string const& reporterName, IConfigPtr const& config) {
+            auto reporter = Catch::getRegistryHub().getReporterRegistry().create(reporterName, config);
+            CATCH_ENFORCE(reporter, "No reporter registered with name: '" << reporterName << "'");
+
+            return reporter;
+        }
+
+        IStreamingReporterPtr makeReporter(std::shared_ptr<Config> const& config) {
+            if (Catch::getRegistryHub().getReporterRegistry().getListeners().empty()) {
+                return createReporter(config->getReporterName(), config);
+            }
+
+            // On older platforms, returning std::unique_ptr<ListeningReporter>
+            // when the return type is std::unique_ptr<IStreamingReporter>
+            // doesn't compile without a std::move call. However, this causes
+            // a warning on newer platforms. Thus, we have to work around
+            // it a bit and downcast the pointer manually.
+            auto ret = std::unique_ptr<IStreamingReporter>(new ListeningReporter);
+            auto& multi = static_cast<ListeningReporter&>(*ret);
+            auto const& listeners = Catch::getRegistryHub().getReporterRegistry().getListeners();
+            for (auto const& listener : listeners) {
+                multi.addListener(listener->create(Catch::ReporterConfig(config)));
+            }
+            multi.addReporter(createReporter(config->getReporterName(), config));
+            return ret;
+        }
+
+        class TestGroup {
+        public:
+            explicit TestGroup(std::shared_ptr<Config> const& config)
+            : m_config{config}
+            , m_context{config, makeReporter(config)}
+            {
+                auto const& allTestCases = getAllTestCasesSorted(*m_config);
+                m_matches = m_config->testSpec().matchesByFilter(allTestCases, *m_config);
+                auto const& invalidArgs = m_config->testSpec().getInvalidArgs();
+
+                if (m_matches.empty() && invalidArgs.empty()) {
+                    for (auto const& test : allTestCases)
+                        if (!test.isHidden())
+                            m_tests.emplace(&test);
+                } else {
+                    for (auto const& match : m_matches)
+                        m_tests.insert(match.tests.begin(), match.tests.end());
+                }
+            }
+
+            Totals execute() {
+                auto const& invalidArgs = m_config->testSpec().getInvalidArgs();
+                Totals totals;
+                m_context.testGroupStarting(m_config->name(), 1, 1);
+                for (auto const& testCase : m_tests) {
+                    if (!m_context.aborting())
+                        totals += m_context.runTest(*testCase);
+                    else
+                        m_context.reporter().skipTest(*testCase);
+                }
+
+                for (auto const& match : m_matches) {
+                    if (match.tests.empty()) {
+                        m_context.reporter().noMatchingTestCases(match.name);
+                        totals.error = -1;
+                    }
+                }
+
+                if (!invalidArgs.empty()) {
+                    for (auto const& invalidArg: invalidArgs)
+                         m_context.reporter().reportInvalidArguments(invalidArg);
+                }
+
+                m_context.testGroupEnded(m_config->name(), totals, 1, 1);
+                return totals;
+            }
+
+        private:
+            using Tests = std::set<TestCase const*>;
+
+            std::shared_ptr<Config> m_config;
+            RunContext m_context;
+            Tests m_tests;
+            TestSpec::Matches m_matches;
+        };
+
+        void applyFilenamesAsTags(Catch::IConfig const& config) {
+            auto& tests = const_cast<std::vector<TestCase>&>(getAllTestCasesSorted(config));
+            for (auto& testCase : tests) {
+                auto tags = testCase.tags;
+
+                std::string filename = testCase.lineInfo.file;
+                auto lastSlash = filename.find_last_of("\\/");
+                if (lastSlash != std::string::npos) {
+                    filename.erase(0, lastSlash);
+                    filename[0] = '#';
+                }
+                else
+                {
+                    filename.insert(0, "#");
+                }
+
+                auto lastDot = filename.find_last_of('.');
+                if (lastDot != std::string::npos) {
+                    filename.erase(lastDot);
+                }
+
+                tags.push_back(std::move(filename));
+                setTags(testCase, tags);
+            }
+        }
+
+    } // anon namespace
+
+    Session::Session() {
+        static bool alreadyInstantiated = false;
+        if( alreadyInstantiated ) {
+            CATCH_TRY { CATCH_INTERNAL_ERROR( "Only one instance of Catch::Session can ever be used" ); }
+            CATCH_CATCH_ALL { getMutableRegistryHub().registerStartupException(); }
+        }
+
+        // There cannot be exceptions at startup in no-exception mode.
+#if !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+        const auto& exceptions = getRegistryHub().getStartupExceptionRegistry().getExceptions();
+        if ( !exceptions.empty() ) {
+            config();
+            getCurrentMutableContext().setConfig(m_config);
+
+            m_startupExceptions = true;
+            Colour colourGuard( Colour::Red );
+            Catch::cerr() << "Errors occurred during startup!" << '\n';
+            // iterate over all exceptions and notify user
+            for ( const auto& ex_ptr : exceptions ) {
+                try {
+                    std::rethrow_exception(ex_ptr);
+                } catch ( std::exception const& ex ) {
+                    Catch::cerr() << Column( ex.what() ).indent(2) << '\n';
+                }
+            }
+        }
+#endif
+
+        alreadyInstantiated = true;
+        m_cli = makeCommandLineParser( m_configData );
+    }
+    Session::~Session() {
+        Catch::cleanUp();
+    }
+
+    void Session::showHelp() const {
+        Catch::cout()
+                << "\nCatch v" << libraryVersion() << "\n"
+                << m_cli << std::endl
+                << "For more detailed usage please see the project docs\n" << std::endl;
+    }
+    void Session::libIdentify() {
+        Catch::cout()
+                << std::left << std::setw(16) << "description: " << "A Catch2 test executable\n"
+                << std::left << std::setw(16) << "category: " << "testframework\n"
+                << std::left << std::setw(16) << "framework: " << "Catch Test\n"
+                << std::left << std::setw(16) << "version: " << libraryVersion() << std::endl;
+    }
+
+    int Session::applyCommandLine( int argc, char const * const * argv ) {
+        if( m_startupExceptions )
+            return 1;
+
+        auto result = m_cli.parse( clara::Args( argc, argv ) );
+        if( !result ) {
+            config();
+            getCurrentMutableContext().setConfig(m_config);
+            Catch::cerr()
+                << Colour( Colour::Red )
+                << "\nError(s) in input:\n"
+                << Column( result.errorMessage() ).indent( 2 )
+                << "\n\n";
+            Catch::cerr() << "Run with -? for usage\n" << std::endl;
+            return MaxExitCode;
+        }
+
+        if( m_configData.showHelp )
+            showHelp();
+        if( m_configData.libIdentify )
+            libIdentify();
+        m_config.reset();
+        return 0;
+    }
+
+#if defined(CATCH_CONFIG_WCHAR) && defined(_WIN32) && defined(UNICODE)
+    int Session::applyCommandLine( int argc, wchar_t const * const * argv ) {
+
+        char **utf8Argv = new char *[ argc ];
+
+        for ( int i = 0; i < argc; ++i ) {
+            int bufSize = WideCharToMultiByte( CP_UTF8, 0, argv[i], -1, nullptr, 0, nullptr, nullptr );
+
+            utf8Argv[ i ] = new char[ bufSize ];
+
+            WideCharToMultiByte( CP_UTF8, 0, argv[i], -1, utf8Argv[i], bufSize, nullptr, nullptr );
+        }
+
+        int returnCode = applyCommandLine( argc, utf8Argv );
+
+        for ( int i = 0; i < argc; ++i )
+            delete [] utf8Argv[ i ];
+
+        delete [] utf8Argv;
+
+        return returnCode;
+    }
+#endif
+
+    void Session::useConfigData( ConfigData const& configData ) {
+        m_configData = configData;
+        m_config.reset();
+    }
+
+    int Session::run() {
+        if( ( m_configData.waitForKeypress & WaitForKeypress::BeforeStart ) != 0 ) {
+            Catch::cout() << "...waiting for enter/ return before starting" << std::endl;
+            static_cast<void>(std::getchar());
+        }
+        int exitCode = runInternal();
+        if( ( m_configData.waitForKeypress & WaitForKeypress::BeforeExit ) != 0 ) {
+            Catch::cout() << "...waiting for enter/ return before exiting, with code: " << exitCode << std::endl;
+            static_cast<void>(std::getchar());
+        }
+        return exitCode;
+    }
+
+    clara::Parser const& Session::cli() const {
+        return m_cli;
+    }
+    void Session::cli( clara::Parser const& newParser ) {
+        m_cli = newParser;
+    }
+    ConfigData& Session::configData() {
+        return m_configData;
+    }
+    Config& Session::config() {
+        if( !m_config )
+            m_config = std::make_shared<Config>( m_configData );
+        return *m_config;
+    }
+
+    int Session::runInternal() {
+        if( m_startupExceptions )
+            return 1;
+
+        if (m_configData.showHelp || m_configData.libIdentify) {
+            return 0;
+        }
+
+        CATCH_TRY {
+            config(); // Force config to be constructed
+
+            seedRng( *m_config );
+
+            if( m_configData.filenamesAsTags )
+                applyFilenamesAsTags( *m_config );
+
+            // Handle list request
+            if( Option<std::size_t> listed = list( m_config ) )
+                return static_cast<int>( *listed );
+
+            TestGroup tests { m_config };
+            auto const totals = tests.execute();
+
+            if( m_config->warnAboutNoTests() && totals.error == -1 )
+                return 2;
+
+            // Note that on unices only the lower 8 bits are usually used, clamping
+            // the return value to 255 prevents false negative when some multiple
+            // of 256 tests has failed
+            return (std::min) (MaxExitCode, (std::max) (totals.error, static_cast<int>(totals.assertions.failed)));
+        }
+#if !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+        catch( std::exception& ex ) {
+            Catch::cerr() << ex.what() << std::endl;
+            return MaxExitCode;
+        }
+#endif
+    }
+
+} // end namespace Catch
+// end catch_session.cpp
+// start catch_singletons.cpp
+
+#include <vector>
+
+namespace Catch {
+
+    namespace {
+        static auto getSingletons() -> std::vector<ISingleton*>*& {
+            static std::vector<ISingleton*>* g_singletons = nullptr;
+            if( !g_singletons )
+                g_singletons = new std::vector<ISingleton*>();
+            return g_singletons;
+        }
+    }
+
+    ISingleton::~ISingleton() {}
+
+    void addSingleton(ISingleton* singleton ) {
+        getSingletons()->push_back( singleton );
+    }
+    void cleanupSingletons() {
+        auto& singletons = getSingletons();
+        for( auto singleton : *singletons )
+            delete singleton;
+        delete singletons;
+        singletons = nullptr;
+    }
+
+} // namespace Catch
+// end catch_singletons.cpp
+// start catch_startup_exception_registry.cpp
+
+#if !defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+namespace Catch {
+void StartupExceptionRegistry::add( std::exception_ptr const& exception ) noexcept {
+        CATCH_TRY {
+            m_exceptions.push_back(exception);
+        } CATCH_CATCH_ALL {
+            // If we run out of memory during start-up there's really not a lot more we can do about it
+            std::terminate();
+        }
+    }
+
+    std::vector<std::exception_ptr> const& StartupExceptionRegistry::getExceptions() const noexcept {
+        return m_exceptions;
+    }
+
+} // end namespace Catch
+#endif
+// end catch_startup_exception_registry.cpp
+// start catch_stream.cpp
+
+#include <cstdio>
+#include <iostream>
+#include <fstream>
+#include <sstream>
+#include <vector>
+#include <memory>
+
+namespace Catch {
+
+    Catch::IStream::~IStream() = default;
+
+    namespace Detail { namespace {
+        template<typename WriterF, std::size_t bufferSize=256>
+        class StreamBufImpl : public std::streambuf {
+            char data[bufferSize];
+            WriterF m_writer;
+
+        public:
+            StreamBufImpl() {
+                setp( data, data + sizeof(data) );
+            }
+
+            ~StreamBufImpl() noexcept {
+                StreamBufImpl::sync();
+            }
+
+        private:
+            int overflow( int c ) override {
+                sync();
+
+                if( c != EOF ) {
+                    if( pbase() == epptr() )
+                        m_writer( std::string( 1, static_cast<char>( c ) ) );
+                    else
+                        sputc( static_cast<char>( c ) );
+                }
+                return 0;
+            }
+
+            int sync() override {
+                if( pbase() != pptr() ) {
+                    m_writer( std::string( pbase(), static_cast<std::string::size_type>( pptr() - pbase() ) ) );
+                    setp( pbase(), epptr() );
+                }
+                return 0;
+            }
+        };
+
+        ///////////////////////////////////////////////////////////////////////////
+
+        struct OutputDebugWriter {
+
+            void operator()( std::string const&str ) {
+                writeToDebugConsole( str );
+            }
+        };
+
+        ///////////////////////////////////////////////////////////////////////////
+
+        class FileStream : public IStream {
+            mutable std::ofstream m_ofs;
+        public:
+            FileStream( StringRef filename ) {
+                m_ofs.open( filename.c_str() );
+                CATCH_ENFORCE( !m_ofs.fail(), "Unable to open file: '" << filename << "'" );
+            }
+            ~FileStream() override = default;
+        public: // IStream
+            std::ostream& stream() const override {
+                return m_ofs;
+            }
+        };
+
+        ///////////////////////////////////////////////////////////////////////////
+
+        class CoutStream : public IStream {
+            mutable std::ostream m_os;
+        public:
+            // Store the streambuf from cout up-front because
+            // cout may get redirected when running tests
+            CoutStream() : m_os( Catch::cout().rdbuf() ) {}
+            ~CoutStream() override = default;
+
+        public: // IStream
+            std::ostream& stream() const override { return m_os; }
+        };
+
+        ///////////////////////////////////////////////////////////////////////////
+
+        class DebugOutStream : public IStream {
+            std::unique_ptr<StreamBufImpl<OutputDebugWriter>> m_streamBuf;
+            mutable std::ostream m_os;
+        public:
+            DebugOutStream()
+            :   m_streamBuf( new StreamBufImpl<OutputDebugWriter>() ),
+                m_os( m_streamBuf.get() )
+            {}
+
+            ~DebugOutStream() override = default;
+
+        public: // IStream
+            std::ostream& stream() const override { return m_os; }
+        };
+
+    }} // namespace anon::detail
+
+    ///////////////////////////////////////////////////////////////////////////
+
+    auto makeStream( StringRef const &filename ) -> IStream const* {
+        if( filename.empty() )
+            return new Detail::CoutStream();
+        else if( filename[0] == '%' ) {
+            if( filename == "%debug" )
+                return new Detail::DebugOutStream();
+            else
+                CATCH_ERROR( "Unrecognised stream: '" << filename << "'" );
+        }
+        else
+            return new Detail::FileStream( filename );
+    }
+
+    // This class encapsulates the idea of a pool of ostringstreams that can be reused.
+    struct StringStreams {
+        std::vector<std::unique_ptr<std::ostringstream>> m_streams;
+        std::vector<std::size_t> m_unused;
+        std::ostringstream m_referenceStream; // Used for copy state/ flags from
+
+        auto add() -> std::size_t {
+            if( m_unused.empty() ) {
+                m_streams.push_back( std::unique_ptr<std::ostringstream>( new std::ostringstream ) );
+                return m_streams.size()-1;
+            }
+            else {
+                auto index = m_unused.back();
+                m_unused.pop_back();
+                return index;
+            }
+        }
+
+        void release( std::size_t index ) {
+            m_streams[index]->copyfmt( m_referenceStream ); // Restore initial flags and other state
+            m_unused.push_back(index);
+        }
+    };
+
+    ReusableStringStream::ReusableStringStream()
+    :   m_index( Singleton<StringStreams>::getMutable().add() ),
+        m_oss( Singleton<StringStreams>::getMutable().m_streams[m_index].get() )
+    {}
+
+    ReusableStringStream::~ReusableStringStream() {
+        static_cast<std::ostringstream*>( m_oss )->str("");
+        m_oss->clear();
+        Singleton<StringStreams>::getMutable().release( m_index );
+    }
+
+    auto ReusableStringStream::str() const -> std::string {
+        return static_cast<std::ostringstream*>( m_oss )->str();
+    }
+
+    ///////////////////////////////////////////////////////////////////////////
+
+#ifndef CATCH_CONFIG_NOSTDOUT // If you #define this you must implement these functions
+    std::ostream& cout() { return std::cout; }
+    std::ostream& cerr() { return std::cerr; }
+    std::ostream& clog() { return std::clog; }
+#endif
+}
+// end catch_stream.cpp
+// start catch_string_manip.cpp
+
+#include <algorithm>
+#include <ostream>
+#include <cstring>
+#include <cctype>
+#include <vector>
+
+namespace Catch {
+
+    namespace {
+        char toLowerCh(char c) {
+            return static_cast<char>( std::tolower( static_cast<unsigned char>(c) ) );
+        }
+    }
+
+    bool startsWith( std::string const& s, std::string const& prefix ) {
+        return s.size() >= prefix.size() && std::equal(prefix.begin(), prefix.end(), s.begin());
+    }
+    bool startsWith( std::string const& s, char prefix ) {
+        return !s.empty() && s[0] == prefix;
+    }
+    bool endsWith( std::string const& s, std::string const& suffix ) {
+        return s.size() >= suffix.size() && std::equal(suffix.rbegin(), suffix.rend(), s.rbegin());
+    }
+    bool endsWith( std::string const& s, char suffix ) {
+        return !s.empty() && s[s.size()-1] == suffix;
+    }
+    bool contains( std::string const& s, std::string const& infix ) {
+        return s.find( infix ) != std::string::npos;
+    }
+    void toLowerInPlace( std::string& s ) {
+        std::transform( s.begin(), s.end(), s.begin(), toLowerCh );
+    }
+    std::string toLower( std::string const& s ) {
+        std::string lc = s;
+        toLowerInPlace( lc );
+        return lc;
+    }
+    std::string trim( std::string const& str ) {
+        static char const* whitespaceChars = "\n\r\t ";
+        std::string::size_type start = str.find_first_not_of( whitespaceChars );
+        std::string::size_type end = str.find_last_not_of( whitespaceChars );
+
+        return start != std::string::npos ? str.substr( start, 1+end-start ) : std::string();
+    }
+
+    StringRef trim(StringRef ref) {
+        const auto is_ws = [](char c) {
+            return c == ' ' || c == '\t' || c == '\n' || c == '\r';
+        };
+        size_t real_begin = 0;
+        while (real_begin < ref.size() && is_ws(ref[real_begin])) { ++real_begin; }
+        size_t real_end = ref.size();
+        while (real_end > real_begin && is_ws(ref[real_end - 1])) { --real_end; }
+
+        return ref.substr(real_begin, real_end - real_begin);
+    }
+
+    bool replaceInPlace( std::string& str, std::string const& replaceThis, std::string const& withThis ) {
+        bool replaced = false;
+        std::size_t i = str.find( replaceThis );
+        while( i != std::string::npos ) {
+            replaced = true;
+            str = str.substr( 0, i ) + withThis + str.substr( i+replaceThis.size() );
+            if( i < str.size()-withThis.size() )
+                i = str.find( replaceThis, i+withThis.size() );
+            else
+                i = std::string::npos;
+        }
+        return replaced;
+    }
+
+    std::vector<StringRef> splitStringRef( StringRef str, char delimiter ) {
+        std::vector<StringRef> subStrings;
+        std::size_t start = 0;
+        for(std::size_t pos = 0; pos < str.size(); ++pos ) {
+            if( str[pos] == delimiter ) {
+                if( pos - start > 1 )
+                    subStrings.push_back( str.substr( start, pos-start ) );
+                start = pos+1;
+            }
+        }
+        if( start < str.size() )
+            subStrings.push_back( str.substr( start, str.size()-start ) );
+        return subStrings;
+    }
+
+    pluralise::pluralise( std::size_t count, std::string const& label )
+    :   m_count( count ),
+        m_label( label )
+    {}
+
+    std::ostream& operator << ( std::ostream& os, pluralise const& pluraliser ) {
+        os << pluraliser.m_count << ' ' << pluraliser.m_label;
+        if( pluraliser.m_count != 1 )
+            os << 's';
+        return os;
+    }
+
+}
+// end catch_string_manip.cpp
+// start catch_stringref.cpp
+
+#include <algorithm>
+#include <ostream>
+#include <cstring>
+#include <cstdint>
+
+namespace Catch {
+    StringRef::StringRef( char const* rawChars ) noexcept
+    : StringRef( rawChars, static_cast<StringRef::size_type>(std::strlen(rawChars) ) )
+    {}
+
+    auto StringRef::c_str() const -> char const* {
+        CATCH_ENFORCE(isNullTerminated(), "Called StringRef::c_str() on a non-null-terminated instance");
+        return m_start;
+    }
+    auto StringRef::data() const noexcept -> char const* {
+        return m_start;
+    }
+
+    auto StringRef::substr( size_type start, size_type size ) const noexcept -> StringRef {
+        if (start < m_size) {
+            return StringRef(m_start + start, (std::min)(m_size - start, size));
+        } else {
+            return StringRef();
+        }
+    }
+    auto StringRef::operator == ( StringRef const& other ) const noexcept -> bool {
+        return m_size == other.m_size
+            && (std::memcmp( m_start, other.m_start, m_size ) == 0);
+    }
+
+    auto operator << ( std::ostream& os, StringRef const& str ) -> std::ostream& {
+        return os.write(str.data(), str.size());
+    }
+
+    auto operator+=( std::string& lhs, StringRef const& rhs ) -> std::string& {
+        lhs.append(rhs.data(), rhs.size());
+        return lhs;
+    }
+
+} // namespace Catch
+// end catch_stringref.cpp
+// start catch_tag_alias.cpp
+
+namespace Catch {
+    TagAlias::TagAlias(std::string const & _tag, SourceLineInfo _lineInfo): tag(_tag), lineInfo(_lineInfo) {}
+}
+// end catch_tag_alias.cpp
+// start catch_tag_alias_autoregistrar.cpp
+
+namespace Catch {
+
+    RegistrarForTagAliases::RegistrarForTagAliases(char const* alias, char const* tag, SourceLineInfo const& lineInfo) {
+        CATCH_TRY {
+            getMutableRegistryHub().registerTagAlias(alias, tag, lineInfo);
+        } CATCH_CATCH_ALL {
+            // Do not throw when constructing global objects, instead register the exception to be processed later
+            getMutableRegistryHub().registerStartupException();
+        }
+    }
+
+}
+// end catch_tag_alias_autoregistrar.cpp
+// start catch_tag_alias_registry.cpp
+
+#include <sstream>
+
+namespace Catch {
+
+    TagAliasRegistry::~TagAliasRegistry() {}
+
+    TagAlias const* TagAliasRegistry::find( std::string const& alias ) const {
+        auto it = m_registry.find( alias );
+        if( it != m_registry.end() )
+            return &(it->second);
+        else
+            return nullptr;
+    }
+
+    std::string TagAliasRegistry::expandAliases( std::string const& unexpandedTestSpec ) const {
+        std::string expandedTestSpec = unexpandedTestSpec;
+        for( auto const& registryKvp : m_registry ) {
+            std::size_t pos = expandedTestSpec.find( registryKvp.first );
+            if( pos != std::string::npos ) {
+                expandedTestSpec =  expandedTestSpec.substr( 0, pos ) +
+                                    registryKvp.second.tag +
+                                    expandedTestSpec.substr( pos + registryKvp.first.size() );
+            }
+        }
+        return expandedTestSpec;
+    }
+
+    void TagAliasRegistry::add( std::string const& alias, std::string const& tag, SourceLineInfo const& lineInfo ) {
+        CATCH_ENFORCE( startsWith(alias, "[@") && endsWith(alias, ']'),
+                      "error: tag alias, '" << alias << "' is not of the form [@alias name].\n" << lineInfo );
+
+        CATCH_ENFORCE( m_registry.insert(std::make_pair(alias, TagAlias(tag, lineInfo))).second,
+                      "error: tag alias, '" << alias << "' already registered.\n"
+                      << "\tFirst seen at: " << find(alias)->lineInfo << "\n"
+                      << "\tRedefined at: " << lineInfo );
+    }
+
+    ITagAliasRegistry::~ITagAliasRegistry() {}
+
+    ITagAliasRegistry const& ITagAliasRegistry::get() {
+        return getRegistryHub().getTagAliasRegistry();
+    }
+
+} // end namespace Catch
+// end catch_tag_alias_registry.cpp
+// start catch_test_case_info.cpp
+
+#include <cctype>
+#include <exception>
+#include <algorithm>
+#include <sstream>
+
+namespace Catch {
+
+    namespace {
+        TestCaseInfo::SpecialProperties parseSpecialTag( std::string const& tag ) {
+            if( startsWith( tag, '.' ) ||
+                tag == "!hide" )
+                return TestCaseInfo::IsHidden;
+            else if( tag == "!throws" )
+                return TestCaseInfo::Throws;
+            else if( tag == "!shouldfail" )
+                return TestCaseInfo::ShouldFail;
+            else if( tag == "!mayfail" )
+                return TestCaseInfo::MayFail;
+            else if( tag == "!nonportable" )
+                return TestCaseInfo::NonPortable;
+            else if( tag == "!benchmark" )
+                return static_cast<TestCaseInfo::SpecialProperties>( TestCaseInfo::Benchmark | TestCaseInfo::IsHidden );
+            else
+                return TestCaseInfo::None;
+        }
+        bool isReservedTag( std::string const& tag ) {
+            return parseSpecialTag( tag ) == TestCaseInfo::None && tag.size() > 0 && !std::isalnum( static_cast<unsigned char>(tag[0]) );
+        }
+        void enforceNotReservedTag( std::string const& tag, SourceLineInfo const& _lineInfo ) {
+            CATCH_ENFORCE( !isReservedTag(tag),
+                          "Tag name: [" << tag << "] is not allowed.\n"
+                          << "Tag names starting with non alphanumeric characters are reserved\n"
+                          << _lineInfo );
+        }
+    }
+
+    TestCase makeTestCase(  ITestInvoker* _testCase,
+                            std::string const& _className,
+                            NameAndTags const& nameAndTags,
+                            SourceLineInfo const& _lineInfo )
+    {
+        bool isHidden = false;
+
+        // Parse out tags
+        std::vector<std::string> tags;
+        std::string desc, tag;
+        bool inTag = false;
+        for (char c : nameAndTags.tags) {
+            if( !inTag ) {
+                if( c == '[' )
+                    inTag = true;
+                else
+                    desc += c;
+            }
+            else {
+                if( c == ']' ) {
+                    TestCaseInfo::SpecialProperties prop = parseSpecialTag( tag );
+                    if( ( prop & TestCaseInfo::IsHidden ) != 0 )
+                        isHidden = true;
+                    else if( prop == TestCaseInfo::None )
+                        enforceNotReservedTag( tag, _lineInfo );
+
+                    // Merged hide tags like `[.approvals]` should be added as
+                    // `[.][approvals]`. The `[.]` is added at later point, so
+                    // we only strip the prefix
+                    if (startsWith(tag, '.') && tag.size() > 1) {
+                        tag.erase(0, 1);
+                    }
+                    tags.push_back( tag );
+                    tag.clear();
+                    inTag = false;
+                }
+                else
+                    tag += c;
+            }
+        }
+        if( isHidden ) {
+            // Add all "hidden" tags to make them behave identically
+            tags.insert( tags.end(), { ".", "!hide" } );
+        }
+
+        TestCaseInfo info( static_cast<std::string>(nameAndTags.name), _className, desc, tags, _lineInfo );
+        return TestCase( _testCase, std::move(info) );
+    }
+
+    void setTags( TestCaseInfo& testCaseInfo, std::vector<std::string> tags ) {
+        std::sort(begin(tags), end(tags));
+        tags.erase(std::unique(begin(tags), end(tags)), end(tags));
+        testCaseInfo.lcaseTags.clear();
+
+        for( auto const& tag : tags ) {
+            std::string lcaseTag = toLower( tag );
+            testCaseInfo.properties = static_cast<TestCaseInfo::SpecialProperties>( testCaseInfo.properties | parseSpecialTag( lcaseTag ) );
+            testCaseInfo.lcaseTags.push_back( lcaseTag );
+        }
+        testCaseInfo.tags = std::move(tags);
+    }
+
+    TestCaseInfo::TestCaseInfo( std::string const& _name,
+                                std::string const& _className,
+                                std::string const& _description,
+                                std::vector<std::string> const& _tags,
+                                SourceLineInfo const& _lineInfo )
+    :   name( _name ),
+        className( _className ),
+        description( _description ),
+        lineInfo( _lineInfo ),
+        properties( None )
+    {
+        setTags( *this, _tags );
+    }
+
+    bool TestCaseInfo::isHidden() const {
+        return ( properties & IsHidden ) != 0;
+    }
+    bool TestCaseInfo::throws() const {
+        return ( properties & Throws ) != 0;
+    }
+    bool TestCaseInfo::okToFail() const {
+        return ( properties & (ShouldFail | MayFail ) ) != 0;
+    }
+    bool TestCaseInfo::expectedToFail() const {
+        return ( properties & (ShouldFail ) ) != 0;
+    }
+
+    std::string TestCaseInfo::tagsAsString() const {
+        std::string ret;
+        // '[' and ']' per tag
+        std::size_t full_size = 2 * tags.size();
+        for (const auto& tag : tags) {
+            full_size += tag.size();
+        }
+        ret.reserve(full_size);
+        for (const auto& tag : tags) {
+            ret.push_back('[');
+            ret.append(tag);
+            ret.push_back(']');
+        }
+
+        return ret;
+    }
+
+    TestCase::TestCase( ITestInvoker* testCase, TestCaseInfo&& info ) : TestCaseInfo( std::move(info) ), test( testCase ) {}
+
+    TestCase TestCase::withName( std::string const& _newName ) const {
+        TestCase other( *this );
+        other.name = _newName;
+        return other;
+    }
+
+    void TestCase::invoke() const {
+        test->invoke();
+    }
+
+    bool TestCase::operator == ( TestCase const& other ) const {
+        return  test.get() == other.test.get() &&
+                name == other.name &&
+                className == other.className;
+    }
+
+    bool TestCase::operator < ( TestCase const& other ) const {
+        return name < other.name;
+    }
+
+    TestCaseInfo const& TestCase::getTestCaseInfo() const
+    {
+        return *this;
+    }
+
+} // end namespace Catch
+// end catch_test_case_info.cpp
+// start catch_test_case_registry_impl.cpp
+
+#include <algorithm>
+#include <sstream>
+
+namespace Catch {
+
+    namespace {
+        struct TestHasher {
+            using hash_t = uint64_t;
+
+            explicit TestHasher( hash_t hashSuffix ):
+                m_hashSuffix{ hashSuffix } {}
+
+            uint32_t operator()( TestCase const& t ) const {
+                // FNV-1a hash with multiplication fold.
+                const hash_t prime = 1099511628211u;
+                hash_t hash = 14695981039346656037u;
+                for ( const char c : t.name ) {
+                    hash ^= c;
+                    hash *= prime;
+                }
+                hash ^= m_hashSuffix;
+                hash *= prime;
+                const uint32_t low{ static_cast<uint32_t>( hash ) };
+                const uint32_t high{ static_cast<uint32_t>( hash >> 32 ) };
+                return low * high;
+            }
+
+        private:
+            hash_t m_hashSuffix;
+        };
+    } // end unnamed namespace
+
+    std::vector<TestCase> sortTests( IConfig const& config, std::vector<TestCase> const& unsortedTestCases ) {
+        switch( config.runOrder() ) {
+            case RunTests::InDeclarationOrder:
+                // already in declaration order
+                break;
+
+            case RunTests::InLexicographicalOrder: {
+                std::vector<TestCase> sorted = unsortedTestCases;
+                std::sort( sorted.begin(), sorted.end() );
+                return sorted;
+            }
+
+            case RunTests::InRandomOrder: {
+                seedRng( config );
+                TestHasher h{ config.rngSeed() };
+
+                using hashedTest = std::pair<TestHasher::hash_t, TestCase const*>;
+                std::vector<hashedTest> indexed_tests;
+                indexed_tests.reserve( unsortedTestCases.size() );
+
+                for (auto const& testCase : unsortedTestCases) {
+                    indexed_tests.emplace_back(h(testCase), &testCase);
+                }
+
+                std::sort(indexed_tests.begin(), indexed_tests.end(),
+                          [](hashedTest const& lhs, hashedTest const& rhs) {
+                          if (lhs.first == rhs.first) {
+                              return lhs.second->name < rhs.second->name;
+                          }
+                          return lhs.first < rhs.first;
+                });
+
+                std::vector<TestCase> sorted;
+                sorted.reserve( indexed_tests.size() );
+
+                for (auto const& hashed : indexed_tests) {
+                    sorted.emplace_back(*hashed.second);
+                }
+
+                return sorted;
+            }
+        }
+        return unsortedTestCases;
+    }
+
+    bool isThrowSafe( TestCase const& testCase, IConfig const& config ) {
+        return !testCase.throws() || config.allowThrows();
+    }
+
+    bool matchTest( TestCase const& testCase, TestSpec const& testSpec, IConfig const& config ) {
+        return testSpec.matches( testCase ) && isThrowSafe( testCase, config );
+    }
+
+    void enforceNoDuplicateTestCases( std::vector<TestCase> const& functions ) {
+        std::set<TestCase> seenFunctions;
+        for( auto const& function : functions ) {
+            auto prev = seenFunctions.insert( function );
+            CATCH_ENFORCE( prev.second,
+                    "error: TEST_CASE( \"" << function.name << "\" ) already defined.\n"
+                    << "\tFirst seen at " << prev.first->getTestCaseInfo().lineInfo << "\n"
+                    << "\tRedefined at " << function.getTestCaseInfo().lineInfo );
+        }
+    }
+
+    std::vector<TestCase> filterTests( std::vector<TestCase> const& testCases, TestSpec const& testSpec, IConfig const& config ) {
+        std::vector<TestCase> filtered;
+        filtered.reserve( testCases.size() );
+        for (auto const& testCase : testCases) {
+            if ((!testSpec.hasFilters() && !testCase.isHidden()) ||
+                (testSpec.hasFilters() && matchTest(testCase, testSpec, config))) {
+                filtered.push_back(testCase);
+            }
+        }
+        return filtered;
+    }
+    std::vector<TestCase> const& getAllTestCasesSorted( IConfig const& config ) {
+        return getRegistryHub().getTestCaseRegistry().getAllTestsSorted( config );
+    }
+
+    void TestRegistry::registerTest( TestCase const& testCase ) {
+        std::string name = testCase.getTestCaseInfo().name;
+        if( name.empty() ) {
+            ReusableStringStream rss;
+            rss << "Anonymous test case " << ++m_unnamedCount;
+            return registerTest( testCase.withName( rss.str() ) );
+        }
+        m_functions.push_back( testCase );
+    }
+
+    std::vector<TestCase> const& TestRegistry::getAllTests() const {
+        return m_functions;
+    }
+    std::vector<TestCase> const& TestRegistry::getAllTestsSorted( IConfig const& config ) const {
+        if( m_sortedFunctions.empty() )
+            enforceNoDuplicateTestCases( m_functions );
+
+        if(  m_currentSortOrder != config.runOrder() || m_sortedFunctions.empty() ) {
+            m_sortedFunctions = sortTests( config, m_functions );
+            m_currentSortOrder = config.runOrder();
+        }
+        return m_sortedFunctions;
+    }
+
+    ///////////////////////////////////////////////////////////////////////////
+    TestInvokerAsFunction::TestInvokerAsFunction( void(*testAsFunction)() ) noexcept : m_testAsFunction( testAsFunction ) {}
+
+    void TestInvokerAsFunction::invoke() const {
+        m_testAsFunction();
+    }
+
+    std::string extractClassName( StringRef const& classOrQualifiedMethodName ) {
+        std::string className(classOrQualifiedMethodName);
+        if( startsWith( className, '&' ) )
+        {
+            std::size_t lastColons = className.rfind( "::" );
+            std::size_t penultimateColons = className.rfind( "::", lastColons-1 );
+            if( penultimateColons == std::string::npos )
+                penultimateColons = 1;
+            className = className.substr( penultimateColons, lastColons-penultimateColons );
+        }
+        return className;
+    }
+
+} // end namespace Catch
+// end catch_test_case_registry_impl.cpp
+// start catch_test_case_tracker.cpp
+
+#include <algorithm>
+#include <cassert>
+#include <stdexcept>
+#include <memory>
+#include <sstream>
+
+#if defined(__clang__)
+#    pragma clang diagnostic push
+#    pragma clang diagnostic ignored "-Wexit-time-destructors"
+#endif
+
+namespace Catch {
+namespace TestCaseTracking {
+
+    NameAndLocation::NameAndLocation( std::string const& _name, SourceLineInfo const& _location )
+    :   name( _name ),
+        location( _location )
+    {}
+
+    ITracker::~ITracker() = default;
+
+    ITracker& TrackerContext::startRun() {
+        m_rootTracker = std::make_shared<SectionTracker>( NameAndLocation( "{root}", CATCH_INTERNAL_LINEINFO ), *this, nullptr );
+        m_currentTracker = nullptr;
+        m_runState = Executing;
+        return *m_rootTracker;
+    }
+
+    void TrackerContext::endRun() {
+        m_rootTracker.reset();
+        m_currentTracker = nullptr;
+        m_runState = NotStarted;
+    }
+
+    void TrackerContext::startCycle() {
+        m_currentTracker = m_rootTracker.get();
+        m_runState = Executing;
+    }
+    void TrackerContext::completeCycle() {
+        m_runState = CompletedCycle;
+    }
+
+    bool TrackerContext::completedCycle() const {
+        return m_runState == CompletedCycle;
+    }
+    ITracker& TrackerContext::currentTracker() {
+        return *m_currentTracker;
+    }
+    void TrackerContext::setCurrentTracker( ITracker* tracker ) {
+        m_currentTracker = tracker;
+    }
+
+    TrackerBase::TrackerBase( NameAndLocation const& nameAndLocation, TrackerContext& ctx, ITracker* parent ):
+        ITracker(nameAndLocation),
+        m_ctx( ctx ),
+        m_parent( parent )
+    {}
+
+    bool TrackerBase::isComplete() const {
+        return m_runState == CompletedSuccessfully || m_runState == Failed;
+    }
+    bool TrackerBase::isSuccessfullyCompleted() const {
+        return m_runState == CompletedSuccessfully;
+    }
+    bool TrackerBase::isOpen() const {
+        return m_runState != NotStarted && !isComplete();
+    }
+    bool TrackerBase::hasChildren() const {
+        return !m_children.empty();
+    }
+
+    void TrackerBase::addChild( ITrackerPtr const& child ) {
+        m_children.push_back( child );
+    }
+
+    ITrackerPtr TrackerBase::findChild( NameAndLocation const& nameAndLocation ) {
+        auto it = std::find_if( m_children.begin(), m_children.end(),
+            [&nameAndLocation]( ITrackerPtr const& tracker ){
+                return
+                    tracker->nameAndLocation().location == nameAndLocation.location &&
+                    tracker->nameAndLocation().name == nameAndLocation.name;
+            } );
+        return( it != m_children.end() )
+            ? *it
+            : nullptr;
+    }
+    ITracker& TrackerBase::parent() {
+        assert( m_parent ); // Should always be non-null except for root
+        return *m_parent;
+    }
+
+    void TrackerBase::openChild() {
+        if( m_runState != ExecutingChildren ) {
+            m_runState = ExecutingChildren;
+            if( m_parent )
+                m_parent->openChild();
+        }
+    }
+
+    bool TrackerBase::isSectionTracker() const { return false; }
+    bool TrackerBase::isGeneratorTracker() const { return false; }
+
+    void TrackerBase::open() {
+        m_runState = Executing;
+        moveToThis();
+        if( m_parent )
+            m_parent->openChild();
+    }
+
+    void TrackerBase::close() {
+
+        // Close any still open children (e.g. generators)
+        while( &m_ctx.currentTracker() != this )
+            m_ctx.currentTracker().close();
+
+        switch( m_runState ) {
+            case NeedsAnotherRun:
+                break;
+
+            case Executing:
+                m_runState = CompletedSuccessfully;
+                break;
+            case ExecutingChildren:
+                if( std::all_of(m_children.begin(), m_children.end(), [](ITrackerPtr const& t){ return t->isComplete(); }) )
+                    m_runState = CompletedSuccessfully;
+                break;
+
+            case NotStarted:
+            case CompletedSuccessfully:
+            case Failed:
+                CATCH_INTERNAL_ERROR( "Illogical state: " << m_runState );
+
+            default:
+                CATCH_INTERNAL_ERROR( "Unknown state: " << m_runState );
+        }
+        moveToParent();
+        m_ctx.completeCycle();
+    }
+    void TrackerBase::fail() {
+        m_runState = Failed;
+        if( m_parent )
+            m_parent->markAsNeedingAnotherRun();
+        moveToParent();
+        m_ctx.completeCycle();
+    }
+    void TrackerBase::markAsNeedingAnotherRun() {
+        m_runState = NeedsAnotherRun;
+    }
+
+    void TrackerBase::moveToParent() {
+        assert( m_parent );
+        m_ctx.setCurrentTracker( m_parent );
+    }
+    void TrackerBase::moveToThis() {
+        m_ctx.setCurrentTracker( this );
+    }
+
+    SectionTracker::SectionTracker( NameAndLocation const& nameAndLocation, TrackerContext& ctx, ITracker* parent )
+    :   TrackerBase( nameAndLocation, ctx, parent ),
+        m_trimmed_name(trim(nameAndLocation.name))
+    {
+        if( parent ) {
+            while( !parent->isSectionTracker() )
+                parent = &parent->parent();
+
+            SectionTracker& parentSection = static_cast<SectionTracker&>( *parent );
+            addNextFilters( parentSection.m_filters );
+        }
+    }
+
+    bool SectionTracker::isComplete() const {
+        bool complete = true;
+
+        if (m_filters.empty()
+            || m_filters[0] == ""
+            || std::find(m_filters.begin(), m_filters.end(), m_trimmed_name) != m_filters.end()) {
+            complete = TrackerBase::isComplete();
+        }
+        return complete;
+    }
+
+    bool SectionTracker::isSectionTracker() const { return true; }
+
+    SectionTracker& SectionTracker::acquire( TrackerContext& ctx, NameAndLocation const& nameAndLocation ) {
+        std::shared_ptr<SectionTracker> section;
+
+        ITracker& currentTracker = ctx.currentTracker();
+        if( ITrackerPtr childTracker = currentTracker.findChild( nameAndLocation ) ) {
+            assert( childTracker );
+            assert( childTracker->isSectionTracker() );
+            section = std::static_pointer_cast<SectionTracker>( childTracker );
+        }
+        else {
+            section = std::make_shared<SectionTracker>( nameAndLocation, ctx, &currentTracker );
+            currentTracker.addChild( section );
+        }
+        if( !ctx.completedCycle() )
+            section->tryOpen();
+        return *section;
+    }
+
+    void SectionTracker::tryOpen() {
+        if( !isComplete() )
+            open();
+    }
+
+    void SectionTracker::addInitialFilters( std::vector<std::string> const& filters ) {
+        if( !filters.empty() ) {
+            m_filters.reserve( m_filters.size() + filters.size() + 2 );
+            m_filters.emplace_back(""); // Root - should never be consulted
+            m_filters.emplace_back(""); // Test Case - not a section filter
+            m_filters.insert( m_filters.end(), filters.begin(), filters.end() );
+        }
+    }
+    void SectionTracker::addNextFilters( std::vector<std::string> const& filters ) {
+        if( filters.size() > 1 )
+            m_filters.insert( m_filters.end(), filters.begin()+1, filters.end() );
+    }
+
+    std::vector<std::string> const& SectionTracker::getFilters() const {
+        return m_filters;
+    }
+
+    std::string const& SectionTracker::trimmedName() const {
+        return m_trimmed_name;
+    }
+
+} // namespace TestCaseTracking
+
+using TestCaseTracking::ITracker;
+using TestCaseTracking::TrackerContext;
+using TestCaseTracking::SectionTracker;
+
+} // namespace Catch
+
+#if defined(__clang__)
+#    pragma clang diagnostic pop
+#endif
+// end catch_test_case_tracker.cpp
+// start catch_test_registry.cpp
+
+namespace Catch {
+
+    auto makeTestInvoker( void(*testAsFunction)() ) noexcept -> ITestInvoker* {
+        return new(std::nothrow) TestInvokerAsFunction( testAsFunction );
+    }
+
+    NameAndTags::NameAndTags( StringRef const& name_ , StringRef const& tags_ ) noexcept : name( name_ ), tags( tags_ ) {}
+
+    AutoReg::AutoReg( ITestInvoker* invoker, SourceLineInfo const& lineInfo, StringRef const& classOrMethod, NameAndTags const& nameAndTags ) noexcept {
+        CATCH_TRY {
+            getMutableRegistryHub()
+                    .registerTest(
+                        makeTestCase(
+                            invoker,
+                            extractClassName( classOrMethod ),
+                            nameAndTags,
+                            lineInfo));
+        } CATCH_CATCH_ALL {
+            // Do not throw when constructing global objects, instead register the exception to be processed later
+            getMutableRegistryHub().registerStartupException();
+        }
+    }
+
+    AutoReg::~AutoReg() = default;
+}
+// end catch_test_registry.cpp
+// start catch_test_spec.cpp
+
+#include <algorithm>
+#include <string>
+#include <vector>
+#include <memory>
+
+namespace Catch {
+
+    TestSpec::Pattern::Pattern( std::string const& name )
+    : m_name( name )
+    {}
+
+    TestSpec::Pattern::~Pattern() = default;
+
+    std::string const& TestSpec::Pattern::name() const {
+        return m_name;
+    }
+
+    TestSpec::NamePattern::NamePattern( std::string const& name, std::string const& filterString )
+    : Pattern( filterString )
+    , m_wildcardPattern( toLower( name ), CaseSensitive::No )
+    {}
+
+    bool TestSpec::NamePattern::matches( TestCaseInfo const& testCase ) const {
+        return m_wildcardPattern.matches( testCase.name );
+    }
+
+    TestSpec::TagPattern::TagPattern( std::string const& tag, std::string const& filterString )
+    : Pattern( filterString )
+    , m_tag( toLower( tag ) )
+    {}
+
+    bool TestSpec::TagPattern::matches( TestCaseInfo const& testCase ) const {
+        return std::find(begin(testCase.lcaseTags),
+                         end(testCase.lcaseTags),
+                         m_tag) != end(testCase.lcaseTags);
+    }
+
+    TestSpec::ExcludedPattern::ExcludedPattern( PatternPtr const& underlyingPattern )
+    : Pattern( underlyingPattern->name() )
+    , m_underlyingPattern( underlyingPattern )
+    {}
+
+    bool TestSpec::ExcludedPattern::matches( TestCaseInfo const& testCase ) const {
+        return !m_underlyingPattern->matches( testCase );
+    }
+
+    bool TestSpec::Filter::matches( TestCaseInfo const& testCase ) const {
+        return std::all_of( m_patterns.begin(), m_patterns.end(), [&]( PatternPtr const& p ){ return p->matches( testCase ); } );
+    }
+
+    std::string TestSpec::Filter::name() const {
+        std::string name;
+        for( auto const& p : m_patterns )
+            name += p->name();
+        return name;
+    }
+
+    bool TestSpec::hasFilters() const {
+        return !m_filters.empty();
+    }
+
+    bool TestSpec::matches( TestCaseInfo const& testCase ) const {
+        return std::any_of( m_filters.begin(), m_filters.end(), [&]( Filter const& f ){ return f.matches( testCase ); } );
+    }
+
+    TestSpec::Matches TestSpec::matchesByFilter( std::vector<TestCase> const& testCases, IConfig const& config ) const
+    {
+        Matches matches( m_filters.size() );
+        std::transform( m_filters.begin(), m_filters.end(), matches.begin(), [&]( Filter const& filter ){
+            std::vector<TestCase const*> currentMatches;
+            for( auto const& test : testCases )
+                if( isThrowSafe( test, config ) && filter.matches( test ) )
+                    currentMatches.emplace_back( &test );
+            return FilterMatch{ filter.name(), currentMatches };
+        } );
+        return matches;
+    }
+
+    const TestSpec::vectorStrings& TestSpec::getInvalidArgs() const{
+        return  (m_invalidArgs);
+    }
+
+}
+// end catch_test_spec.cpp
+// start catch_test_spec_parser.cpp
+
+namespace Catch {
+
+    TestSpecParser::TestSpecParser( ITagAliasRegistry const& tagAliases ) : m_tagAliases( &tagAliases ) {}
+
+    TestSpecParser& TestSpecParser::parse( std::string const& arg ) {
+        m_mode = None;
+        m_exclusion = false;
+        m_arg = m_tagAliases->expandAliases( arg );
+        m_escapeChars.clear();
+        m_substring.reserve(m_arg.size());
+        m_patternName.reserve(m_arg.size());
+        m_realPatternPos = 0;
+
+        for( m_pos = 0; m_pos < m_arg.size(); ++m_pos )
+          //if visitChar fails
+           if( !visitChar( m_arg[m_pos] ) ){
+               m_testSpec.m_invalidArgs.push_back(arg);
+               break;
+           }
+        endMode();
+        return *this;
+    }
+    TestSpec TestSpecParser::testSpec() {
+        addFilter();
+        return m_testSpec;
+    }
+    bool TestSpecParser::visitChar( char c ) {
+        if( (m_mode != EscapedName) && (c == '\\') ) {
+            escape();
+            addCharToPattern(c);
+            return true;
+        }else if((m_mode != EscapedName) && (c == ',') )  {
+            return separate();
+        }
+
+        switch( m_mode ) {
+        case None:
+            if( processNoneChar( c ) )
+                return true;
+            break;
+        case Name:
+            processNameChar( c );
+            break;
+        case EscapedName:
+            endMode();
+            addCharToPattern(c);
+            return true;
+        default:
+        case Tag:
+        case QuotedName:
+            if( processOtherChar( c ) )
+                return true;
+            break;
+        }
+
+        m_substring += c;
+        if( !isControlChar( c ) ) {
+            m_patternName += c;
+            m_realPatternPos++;
+        }
+        return true;
+    }
+    // Two of the processing methods return true to signal the caller to return
+    // without adding the given character to the current pattern strings
+    bool TestSpecParser::processNoneChar( char c ) {
+        switch( c ) {
+        case ' ':
+            return true;
+        case '~':
+            m_exclusion = true;
+            return false;
+        case '[':
+            startNewMode( Tag );
+            return false;
+        case '"':
+            startNewMode( QuotedName );
+            return false;
+        default:
+            startNewMode( Name );
+            return false;
+        }
+    }
+    void TestSpecParser::processNameChar( char c ) {
+        if( c == '[' ) {
+            if( m_substring == "exclude:" )
+                m_exclusion = true;
+            else
+                endMode();
+            startNewMode( Tag );
+        }
+    }
+    bool TestSpecParser::processOtherChar( char c ) {
+        if( !isControlChar( c ) )
+            return false;
+        m_substring += c;
+        endMode();
+        return true;
+    }
+    void TestSpecParser::startNewMode( Mode mode ) {
+        m_mode = mode;
+    }
+    void TestSpecParser::endMode() {
+        switch( m_mode ) {
+        case Name:
+        case QuotedName:
+            return addNamePattern();
+        case Tag:
+            return addTagPattern();
+        case EscapedName:
+            revertBackToLastMode();
+            return;
+        case None:
+        default:
+            return startNewMode( None );
+        }
+    }
+    void TestSpecParser::escape() {
+        saveLastMode();
+        m_mode = EscapedName;
+        m_escapeChars.push_back(m_realPatternPos);
+    }
+    bool TestSpecParser::isControlChar( char c ) const {
+        switch( m_mode ) {
+            default:
+                return false;
+            case None:
+                return c == '~';
+            case Name:
+                return c == '[';
+            case EscapedName:
+                return true;
+            case QuotedName:
+                return c == '"';
+            case Tag:
+                return c == '[' || c == ']';
+        }
+    }
+
+    void TestSpecParser::addFilter() {
+        if( !m_currentFilter.m_patterns.empty() ) {
+            m_testSpec.m_filters.push_back( m_currentFilter );
+            m_currentFilter = TestSpec::Filter();
+        }
+    }
+
+    void TestSpecParser::saveLastMode() {
+      lastMode = m_mode;
+    }
+
+    void TestSpecParser::revertBackToLastMode() {
+      m_mode = lastMode;
+    }
+
+    bool TestSpecParser::separate() {
+      if( (m_mode==QuotedName) || (m_mode==Tag) ){
+         //invalid argument, signal failure to previous scope.
+         m_mode = None;
+         m_pos = m_arg.size();
+         m_substring.clear();
+         m_patternName.clear();
+         m_realPatternPos = 0;
+         return false;
+      }
+      endMode();
+      addFilter();
+      return true; //success
+    }
+
+    std::string TestSpecParser::preprocessPattern() {
+        std::string token = m_patternName;
+        for (std::size_t i = 0; i < m_escapeChars.size(); ++i)
+            token = token.substr(0, m_escapeChars[i] - i) + token.substr(m_escapeChars[i] - i + 1);
+        m_escapeChars.clear();
+        if (startsWith(token, "exclude:")) {
+            m_exclusion = true;
+            token = token.substr(8);
+        }
+
+        m_patternName.clear();
+        m_realPatternPos = 0;
+
+        return token;
+    }
+
+    void TestSpecParser::addNamePattern() {
+        auto token = preprocessPattern();
+
+        if (!token.empty()) {
+            TestSpec::PatternPtr pattern = std::make_shared<TestSpec::NamePattern>(token, m_substring);
+            if (m_exclusion)
+                pattern = std::make_shared<TestSpec::ExcludedPattern>(pattern);
+            m_currentFilter.m_patterns.push_back(pattern);
+        }
+        m_substring.clear();
+        m_exclusion = false;
+        m_mode = None;
+    }
+
+    void TestSpecParser::addTagPattern() {
+        auto token = preprocessPattern();
+
+        if (!token.empty()) {
+            // If the tag pattern is the "hide and tag" shorthand (e.g. [.foo])
+            // we have to create a separate hide tag and shorten the real one
+            if (token.size() > 1 && token[0] == '.') {
+                token.erase(token.begin());
+                TestSpec::PatternPtr pattern = std::make_shared<TestSpec::TagPattern>(".", m_substring);
+                if (m_exclusion) {
+                    pattern = std::make_shared<TestSpec::ExcludedPattern>(pattern);
+                }
+                m_currentFilter.m_patterns.push_back(pattern);
+            }
+
+            TestSpec::PatternPtr pattern = std::make_shared<TestSpec::TagPattern>(token, m_substring);
+
+            if (m_exclusion) {
+                pattern = std::make_shared<TestSpec::ExcludedPattern>(pattern);
+            }
+            m_currentFilter.m_patterns.push_back(pattern);
+        }
+        m_substring.clear();
+        m_exclusion = false;
+        m_mode = None;
+    }
+
+    TestSpec parseTestSpec( std::string const& arg ) {
+        return TestSpecParser( ITagAliasRegistry::get() ).parse( arg ).testSpec();
+    }
+
+} // namespace Catch
+// end catch_test_spec_parser.cpp
+// start catch_timer.cpp
+
+#include <chrono>
+
+static const uint64_t nanosecondsInSecond = 1000000000;
+
+namespace Catch {
+
+    auto getCurrentNanosecondsSinceEpoch() -> uint64_t {
+        return std::chrono::duration_cast<std::chrono::nanoseconds>( std::chrono::high_resolution_clock::now().time_since_epoch() ).count();
+    }
+
+    namespace {
+        auto estimateClockResolution() -> uint64_t {
+            uint64_t sum = 0;
+            static const uint64_t iterations = 1000000;
+
+            auto startTime = getCurrentNanosecondsSinceEpoch();
+
+            for( std::size_t i = 0; i < iterations; ++i ) {
+
+                uint64_t ticks;
+                uint64_t baseTicks = getCurrentNanosecondsSinceEpoch();
+                do {
+                    ticks = getCurrentNanosecondsSinceEpoch();
+                } while( ticks == baseTicks );
+
+                auto delta = ticks - baseTicks;
+                sum += delta;
+
+                // If we have been calibrating for over 3 seconds -- the clock
+                // is terrible and we should move on.
+                // TBD: How to signal that the measured resolution is probably wrong?
+                if (ticks > startTime + 3 * nanosecondsInSecond) {
+                    return sum / ( i + 1u );
+                }
+            }
+
+            // We're just taking the mean, here. To do better we could take the std. dev and exclude outliers
+            // - and potentially do more iterations if there's a high variance.
+            return sum/iterations;
+        }
+    }
+    auto getEstimatedClockResolution() -> uint64_t {
+        static auto s_resolution = estimateClockResolution();
+        return s_resolution;
+    }
+
+    void Timer::start() {
+       m_nanoseconds = getCurrentNanosecondsSinceEpoch();
+    }
+    auto Timer::getElapsedNanoseconds() const -> uint64_t {
+        return getCurrentNanosecondsSinceEpoch() - m_nanoseconds;
+    }
+    auto Timer::getElapsedMicroseconds() const -> uint64_t {
+        return getElapsedNanoseconds()/1000;
+    }
+    auto Timer::getElapsedMilliseconds() const -> unsigned int {
+        return static_cast<unsigned int>(getElapsedMicroseconds()/1000);
+    }
+    auto Timer::getElapsedSeconds() const -> double {
+        return getElapsedMicroseconds()/1000000.0;
+    }
+
+} // namespace Catch
+// end catch_timer.cpp
+// start catch_tostring.cpp
+
+#if defined(__clang__)
+#    pragma clang diagnostic push
+#    pragma clang diagnostic ignored "-Wexit-time-destructors"
+#    pragma clang diagnostic ignored "-Wglobal-constructors"
+#endif
+
+// Enable specific decls locally
+#if !defined(CATCH_CONFIG_ENABLE_CHRONO_STRINGMAKER)
+#define CATCH_CONFIG_ENABLE_CHRONO_STRINGMAKER
+#endif
+
+#include <cmath>
+#include <iomanip>
+
+namespace Catch {
+
+namespace Detail {
+
+    const std::string unprintableString = "{?}";
+
+    namespace {
+        const int hexThreshold = 255;
+
+        struct Endianness {
+            enum Arch { Big, Little };
+
+            static Arch which() {
+                int one = 1;
+                // If the lowest byte we read is non-zero, we can assume
+                // that little endian format is used.
+                auto value = *reinterpret_cast<char*>(&one);
+                return value ? Little : Big;
+            }
+        };
+    }
+
+    std::string rawMemoryToString( const void *object, std::size_t size ) {
+        // Reverse order for little endian architectures
+        int i = 0, end = static_cast<int>( size ), inc = 1;
+        if( Endianness::which() == Endianness::Little ) {
+            i = end-1;
+            end = inc = -1;
+        }
+
+        unsigned char const *bytes = static_cast<unsigned char const *>(object);
+        ReusableStringStream rss;
+        rss << "0x" << std::setfill('0') << std::hex;
+        for( ; i != end; i += inc )
+             rss << std::setw(2) << static_cast<unsigned>(bytes[i]);
+       return rss.str();
+    }
+}
+
+template<typename T>
+std::string fpToString( T value, int precision ) {
+    if (Catch::isnan(value)) {
+        return "nan";
+    }
+
+    ReusableStringStream rss;
+    rss << std::setprecision( precision )
+        << std::fixed
+        << value;
+    std::string d = rss.str();
+    std::size_t i = d.find_last_not_of( '0' );
+    if( i != std::string::npos && i != d.size()-1 ) {
+        if( d[i] == '.' )
+            i++;
+        d = d.substr( 0, i+1 );
+    }
+    return d;
+}
+
+//// ======================================================= ////
+//
+//   Out-of-line defs for full specialization of StringMaker
+//
+//// ======================================================= ////
+
+std::string StringMaker<std::string>::convert(const std::string& str) {
+    if (!getCurrentContext().getConfig()->showInvisibles()) {
+        return '"' + str + '"';
+    }
+
+    std::string s("\"");
+    for (char c : str) {
+        switch (c) {
+        case '\n':
+            s.append("\\n");
+            break;
+        case '\t':
+            s.append("\\t");
+            break;
+        default:
+            s.push_back(c);
+            break;
+        }
+    }
+    s.append("\"");
+    return s;
+}
+
+#ifdef CATCH_CONFIG_CPP17_STRING_VIEW
+std::string StringMaker<std::string_view>::convert(std::string_view str) {
+    return ::Catch::Detail::stringify(std::string{ str });
+}
+#endif
+
+std::string StringMaker<char const*>::convert(char const* str) {
+    if (str) {
+        return ::Catch::Detail::stringify(std::string{ str });
+    } else {
+        return{ "{null string}" };
+    }
+}
+std::string StringMaker<char*>::convert(char* str) {
+    if (str) {
+        return ::Catch::Detail::stringify(std::string{ str });
+    } else {
+        return{ "{null string}" };
+    }
+}
+
+#ifdef CATCH_CONFIG_WCHAR
+std::string StringMaker<std::wstring>::convert(const std::wstring& wstr) {
+    std::string s;
+    s.reserve(wstr.size());
+    for (auto c : wstr) {
+        s += (c <= 0xff) ? static_cast<char>(c) : '?';
+    }
+    return ::Catch::Detail::stringify(s);
+}
+
+# ifdef CATCH_CONFIG_CPP17_STRING_VIEW
+std::string StringMaker<std::wstring_view>::convert(std::wstring_view str) {
+    return StringMaker<std::wstring>::convert(std::wstring(str));
+}
+# endif
+
+std::string StringMaker<wchar_t const*>::convert(wchar_t const * str) {
+    if (str) {
+        return ::Catch::Detail::stringify(std::wstring{ str });
+    } else {
+        return{ "{null string}" };
+    }
+}
+std::string StringMaker<wchar_t *>::convert(wchar_t * str) {
+    if (str) {
+        return ::Catch::Detail::stringify(std::wstring{ str });
+    } else {
+        return{ "{null string}" };
+    }
+}
+#endif
+
+#if defined(CATCH_CONFIG_CPP17_BYTE)
+#include <cstddef>
+std::string StringMaker<std::byte>::convert(std::byte value) {
+    return ::Catch::Detail::stringify(std::to_integer<unsigned long long>(value));
+}
+#endif // defined(CATCH_CONFIG_CPP17_BYTE)
+
+std::string StringMaker<int>::convert(int value) {
+    return ::Catch::Detail::stringify(static_cast<long long>(value));
+}
+std::string StringMaker<long>::convert(long value) {
+    return ::Catch::Detail::stringify(static_cast<long long>(value));
+}
+std::string StringMaker<long long>::convert(long long value) {
+    ReusableStringStream rss;
+    rss << value;
+    if (value > Detail::hexThreshold) {
+        rss << " (0x" << std::hex << value << ')';
+    }
+    return rss.str();
+}
+
+std::string StringMaker<unsigned int>::convert(unsigned int value) {
+    return ::Catch::Detail::stringify(static_cast<unsigned long long>(value));
+}
+std::string StringMaker<unsigned long>::convert(unsigned long value) {
+    return ::Catch::Detail::stringify(static_cast<unsigned long long>(value));
+}
+std::string StringMaker<unsigned long long>::convert(unsigned long long value) {
+    ReusableStringStream rss;
+    rss << value;
+    if (value > Detail::hexThreshold) {
+        rss << " (0x" << std::hex << value << ')';
+    }
+    return rss.str();
+}
+
+std::string StringMaker<bool>::convert(bool b) {
+    return b ? "true" : "false";
+}
+
+std::string StringMaker<signed char>::convert(signed char value) {
+    if (value == '\r') {
+        return "'\\r'";
+    } else if (value == '\f') {
+        return "'\\f'";
+    } else if (value == '\n') {
+        return "'\\n'";
+    } else if (value == '\t') {
+        return "'\\t'";
+    } else if ('\0' <= value && value < ' ') {
+        return ::Catch::Detail::stringify(static_cast<unsigned int>(value));
+    } else {
+        char chstr[] = "' '";
+        chstr[1] = value;
+        return chstr;
+    }
+}
+std::string StringMaker<char>::convert(char c) {
+    return ::Catch::Detail::stringify(static_cast<signed char>(c));
+}
+std::string StringMaker<unsigned char>::convert(unsigned char c) {
+    return ::Catch::Detail::stringify(static_cast<char>(c));
+}
+
+std::string StringMaker<std::nullptr_t>::convert(std::nullptr_t) {
+    return "nullptr";
+}
+
+int StringMaker<float>::precision = 5;
+
+std::string StringMaker<float>::convert(float value) {
+    return fpToString(value, precision) + 'f';
+}
+
+int StringMaker<double>::precision = 10;
+
+std::string StringMaker<double>::convert(double value) {
+    return fpToString(value, precision);
+}
+
+std::string ratio_string<std::atto>::symbol() { return "a"; }
+std::string ratio_string<std::femto>::symbol() { return "f"; }
+std::string ratio_string<std::pico>::symbol() { return "p"; }
+std::string ratio_string<std::nano>::symbol() { return "n"; }
+std::string ratio_string<std::micro>::symbol() { return "u"; }
+std::string ratio_string<std::milli>::symbol() { return "m"; }
+
+} // end namespace Catch
+
+#if defined(__clang__)
+#    pragma clang diagnostic pop
+#endif
+
+// end catch_tostring.cpp
+// start catch_totals.cpp
+
+namespace Catch {
+
+    Counts Counts::operator - ( Counts const& other ) const {
+        Counts diff;
+        diff.passed = passed - other.passed;
+        diff.failed = failed - other.failed;
+        diff.failedButOk = failedButOk - other.failedButOk;
+        return diff;
+    }
+
+    Counts& Counts::operator += ( Counts const& other ) {
+        passed += other.passed;
+        failed += other.failed;
+        failedButOk += other.failedButOk;
+        return *this;
+    }
+
+    std::size_t Counts::total() const {
+        return passed + failed + failedButOk;
+    }
+    bool Counts::allPassed() const {
+        return failed == 0 && failedButOk == 0;
+    }
+    bool Counts::allOk() const {
+        return failed == 0;
+    }
+
+    Totals Totals::operator - ( Totals const& other ) const {
+        Totals diff;
+        diff.assertions = assertions - other.assertions;
+        diff.testCases = testCases - other.testCases;
+        return diff;
+    }
+
+    Totals& Totals::operator += ( Totals const& other ) {
+        assertions += other.assertions;
+        testCases += other.testCases;
+        return *this;
+    }
+
+    Totals Totals::delta( Totals const& prevTotals ) const {
+        Totals diff = *this - prevTotals;
+        if( diff.assertions.failed > 0 )
+            ++diff.testCases.failed;
+        else if( diff.assertions.failedButOk > 0 )
+            ++diff.testCases.failedButOk;
+        else
+            ++diff.testCases.passed;
+        return diff;
+    }
+
+}
+// end catch_totals.cpp
+// start catch_uncaught_exceptions.cpp
+
+// start catch_config_uncaught_exceptions.hpp
+
+//              Copyright Catch2 Authors
+// Distributed under the Boost Software License, Version 1.0.
+//   (See accompanying file LICENSE_1_0.txt or copy at
+//        https://www.boost.org/LICENSE_1_0.txt)
+
+// SPDX-License-Identifier: BSL-1.0
+
+#ifndef CATCH_CONFIG_UNCAUGHT_EXCEPTIONS_HPP
+#define CATCH_CONFIG_UNCAUGHT_EXCEPTIONS_HPP
+
+#if defined(_MSC_VER)
+#  if _MSC_VER >= 1900 // Visual Studio 2015 or newer
+#    define CATCH_INTERNAL_CONFIG_CPP17_UNCAUGHT_EXCEPTIONS
+#  endif
+#endif
+
+#include <exception>
+
+#if defined(__cpp_lib_uncaught_exceptions) \
+    && !defined(CATCH_INTERNAL_CONFIG_CPP17_UNCAUGHT_EXCEPTIONS)
+
+#  define CATCH_INTERNAL_CONFIG_CPP17_UNCAUGHT_EXCEPTIONS
+#endif // __cpp_lib_uncaught_exceptions
+
+#if defined(CATCH_INTERNAL_CONFIG_CPP17_UNCAUGHT_EXCEPTIONS) \
+    && !defined(CATCH_CONFIG_NO_CPP17_UNCAUGHT_EXCEPTIONS) \
+    && !defined(CATCH_CONFIG_CPP17_UNCAUGHT_EXCEPTIONS)
+
+#  define CATCH_CONFIG_CPP17_UNCAUGHT_EXCEPTIONS
+#endif
+
+#endif // CATCH_CONFIG_UNCAUGHT_EXCEPTIONS_HPP
+// end catch_config_uncaught_exceptions.hpp
+#include <exception>
+
+namespace Catch {
+    bool uncaught_exceptions() {
+#if defined(CATCH_CONFIG_DISABLE_EXCEPTIONS)
+        return false;
+#elif defined(CATCH_CONFIG_CPP17_UNCAUGHT_EXCEPTIONS)
+        return std::uncaught_exceptions() > 0;
+#else
+        return std::uncaught_exception();
+#endif
+  }
+} // end namespace Catch
+// end catch_uncaught_exceptions.cpp
+// start catch_version.cpp
+
+#include <ostream>
+
+namespace Catch {
+
+    Version::Version
+        (   unsigned int _majorVersion,
+            unsigned int _minorVersion,
+            unsigned int _patchNumber,
+            char const * const _branchName,
+            unsigned int _buildNumber )
+    :   majorVersion( _majorVersion ),
+        minorVersion( _minorVersion ),
+        patchNumber( _patchNumber ),
+        branchName( _branchName ),
+        buildNumber( _buildNumber )
+    {}
+
+    std::ostream& operator << ( std::ostream& os, Version const& version ) {
+        os  << version.majorVersion << '.'
+            << version.minorVersion << '.'
+            << version.patchNumber;
+        // branchName is never null -> 0th char is \0 if it is empty
+        if (version.branchName[0]) {
+            os << '-' << version.branchName
+               << '.' << version.buildNumber;
+        }
+        return os;
+    }
+
+    Version const& libraryVersion() {
+        static Version version( 2, 13, 9, "", 0 );
+        return version;
+    }
+
+}
+// end catch_version.cpp
+// start catch_wildcard_pattern.cpp
+
+namespace Catch {
+
+    WildcardPattern::WildcardPattern( std::string const& pattern,
+                                      CaseSensitive::Choice caseSensitivity )
+    :   m_caseSensitivity( caseSensitivity ),
+        m_pattern( normaliseString( pattern ) )
+    {
+        if( startsWith( m_pattern, '*' ) ) {
+            m_pattern = m_pattern.substr( 1 );
+            m_wildcard = WildcardAtStart;
+        }
+        if( endsWith( m_pattern, '*' ) ) {
+            m_pattern = m_pattern.substr( 0, m_pattern.size()-1 );
+            m_wildcard = static_cast<WildcardPosition>( m_wildcard | WildcardAtEnd );
+        }
+    }
+
+    bool WildcardPattern::matches( std::string const& str ) const {
+        switch( m_wildcard ) {
+            case NoWildcard:
+                return m_pattern == normaliseString( str );
+            case WildcardAtStart:
+                return endsWith( normaliseString( str ), m_pattern );
+            case WildcardAtEnd:
+                return startsWith( normaliseString( str ), m_pattern );
+            case WildcardAtBothEnds:
+                return contains( normaliseString( str ), m_pattern );
+            default:
+                CATCH_INTERNAL_ERROR( "Unknown enum" );
+        }
+    }
+
+    std::string WildcardPattern::normaliseString( std::string const& str ) const {
+        return trim( m_caseSensitivity == CaseSensitive::No ? toLower( str ) : str );
+    }
+}
+// end catch_wildcard_pattern.cpp
+// start catch_xmlwriter.cpp
+
+#include <iomanip>
+#include <type_traits>
+
+namespace Catch {
+
+namespace {
+
+    size_t trailingBytes(unsigned char c) {
+        if ((c & 0xE0) == 0xC0) {
+            return 2;
+        }
+        if ((c & 0xF0) == 0xE0) {
+            return 3;
+        }
+        if ((c & 0xF8) == 0xF0) {
+            return 4;
+        }
+        CATCH_INTERNAL_ERROR("Invalid multibyte utf-8 start byte encountered");
+    }
+
+    uint32_t headerValue(unsigned char c) {
+        if ((c & 0xE0) == 0xC0) {
+            return c & 0x1F;
+        }
+        if ((c & 0xF0) == 0xE0) {
+            return c & 0x0F;
+        }
+        if ((c & 0xF8) == 0xF0) {
+            return c & 0x07;
+        }
+        CATCH_INTERNAL_ERROR("Invalid multibyte utf-8 start byte encountered");
+    }
+
+    void hexEscapeChar(std::ostream& os, unsigned char c) {
+        std::ios_base::fmtflags f(os.flags());
+        os << "\\x"
+            << std::uppercase << std::hex << std::setfill('0') << std::setw(2)
+            << static_cast<int>(c);
+        os.flags(f);
+    }
+
+    bool shouldNewline(XmlFormatting fmt) {
+        return !!(static_cast<std::underlying_type<XmlFormatting>::type>(fmt & XmlFormatting::Newline));
+    }
+
+    bool shouldIndent(XmlFormatting fmt) {
+        return !!(static_cast<std::underlying_type<XmlFormatting>::type>(fmt & XmlFormatting::Indent));
+    }
+
+} // anonymous namespace
+
+    XmlFormatting operator | (XmlFormatting lhs, XmlFormatting rhs) {
+        return static_cast<XmlFormatting>(
+            static_cast<std::underlying_type<XmlFormatting>::type>(lhs) |
+            static_cast<std::underlying_type<XmlFormatting>::type>(rhs)
+        );
+    }
+
+    XmlFormatting operator & (XmlFormatting lhs, XmlFormatting rhs) {
+        return static_cast<XmlFormatting>(
+            static_cast<std::underlying_type<XmlFormatting>::type>(lhs) &
+            static_cast<std::underlying_type<XmlFormatting>::type>(rhs)
+        );
+    }
+
+    XmlEncode::XmlEncode( std::string const& str, ForWhat forWhat )
+    :   m_str( str ),
+        m_forWhat( forWhat )
+    {}
+
+    void XmlEncode::encodeTo( std::ostream& os ) const {
+        // Apostrophe escaping not necessary if we always use " to write attributes
+        // (see: http://www.w3.org/TR/xml/#syntax)
+
+        for( std::size_t idx = 0; idx < m_str.size(); ++ idx ) {
+            unsigned char c = m_str[idx];
+            switch (c) {
+            case '<':   os << "&lt;"; break;
+            case '&':   os << "&amp;"; break;
+
+            case '>':
+                // See: http://www.w3.org/TR/xml/#syntax
+                if (idx > 2 && m_str[idx - 1] == ']' && m_str[idx - 2] == ']')
+                    os << "&gt;";
+                else
+                    os << c;
+                break;
+
+            case '\"':
+                if (m_forWhat == ForAttributes)
+                    os << "&quot;";
+                else
+                    os << c;
+                break;
+
+            default:
+                // Check for control characters and invalid utf-8
+
+                // Escape control characters in standard ascii
+                // see http://stackoverflow.com/questions/404107/why-are-control-characters-illegal-in-xml-1-0
+                if (c < 0x09 || (c > 0x0D && c < 0x20) || c == 0x7F) {
+                    hexEscapeChar(os, c);
+                    break;
+                }
+
+                // Plain ASCII: Write it to stream
+                if (c < 0x7F) {
+                    os << c;
+                    break;
+                }
+
+                // UTF-8 territory
+                // Check if the encoding is valid and if it is not, hex escape bytes.
+                // Important: We do not check the exact decoded values for validity, only the encoding format
+                // First check that this bytes is a valid lead byte:
+                // This means that it is not encoded as 1111 1XXX
+                // Or as 10XX XXXX
+                if (c <  0xC0 ||
+                    c >= 0xF8) {
+                    hexEscapeChar(os, c);
+                    break;
+                }
+
+                auto encBytes = trailingBytes(c);
+                // Are there enough bytes left to avoid accessing out-of-bounds memory?
+                if (idx + encBytes - 1 >= m_str.size()) {
+                    hexEscapeChar(os, c);
+                    break;
+                }
+                // The header is valid, check data
+                // The next encBytes bytes must together be a valid utf-8
+                // This means: bitpattern 10XX XXXX and the extracted value is sane (ish)
+                bool valid = true;
+                uint32_t value = headerValue(c);
+                for (std::size_t n = 1; n < encBytes; ++n) {
+                    unsigned char nc = m_str[idx + n];
+                    valid &= ((nc & 0xC0) == 0x80);
+                    value = (value << 6) | (nc & 0x3F);
+                }
+
+                if (
+                    // Wrong bit pattern of following bytes
+                    (!valid) ||
+                    // Overlong encodings
+                    (value < 0x80) ||
+                    (0x80 <= value && value < 0x800   && encBytes > 2) ||
+                    (0x800 < value && value < 0x10000 && encBytes > 3) ||
+                    // Encoded value out of range
+                    (value >= 0x110000)
+                    ) {
+                    hexEscapeChar(os, c);
+                    break;
+                }
+
+                // If we got here, this is in fact a valid(ish) utf-8 sequence
+                for (std::size_t n = 0; n < encBytes; ++n) {
+                    os << m_str[idx + n];
+                }
+                idx += encBytes - 1;
+                break;
+            }
+        }
+    }
+
+    std::ostream& operator << ( std::ostream& os, XmlEncode const& xmlEncode ) {
+        xmlEncode.encodeTo( os );
+        return os;
+    }
+
+    XmlWriter::ScopedElement::ScopedElement( XmlWriter* writer, XmlFormatting fmt )
+    :   m_writer( writer ),
+        m_fmt(fmt)
+    {}
+
+    XmlWriter::ScopedElement::ScopedElement( ScopedElement&& other ) noexcept
+    :   m_writer( other.m_writer ),
+        m_fmt(other.m_fmt)
+    {
+        other.m_writer = nullptr;
+        other.m_fmt = XmlFormatting::None;
+    }
+    XmlWriter::ScopedElement& XmlWriter::ScopedElement::operator=( ScopedElement&& other ) noexcept {
+        if ( m_writer ) {
+            m_writer->endElement();
+        }
+        m_writer = other.m_writer;
+        other.m_writer = nullptr;
+        m_fmt = other.m_fmt;
+        other.m_fmt = XmlFormatting::None;
+        return *this;
+    }
+
+    XmlWriter::ScopedElement::~ScopedElement() {
+        if (m_writer) {
+            m_writer->endElement(m_fmt);
+        }
+    }
+
+    XmlWriter::ScopedElement& XmlWriter::ScopedElement::writeText( std::string const& text, XmlFormatting fmt ) {
+        m_writer->writeText( text, fmt );
+        return *this;
+    }
+
+    XmlWriter::XmlWriter( std::ostream& os ) : m_os( os )
+    {
+        writeDeclaration();
+    }
+
+    XmlWriter::~XmlWriter() {
+        while (!m_tags.empty()) {
+            endElement();
+        }
+        newlineIfNecessary();
+    }
+
+    XmlWriter& XmlWriter::startElement( std::string const& name, XmlFormatting fmt ) {
+        ensureTagClosed();
+        newlineIfNecessary();
+        if (shouldIndent(fmt)) {
+            m_os << m_indent;
+            m_indent += "  ";
+        }
+        m_os << '<' << name;
+        m_tags.push_back( name );
+        m_tagIsOpen = true;
+        applyFormatting(fmt);
+        return *this;
+    }
+
+    XmlWriter::ScopedElement XmlWriter::scopedElement( std::string const& name, XmlFormatting fmt ) {
+        ScopedElement scoped( this, fmt );
+        startElement( name, fmt );
+        return scoped;
+    }
+
+    XmlWriter& XmlWriter::endElement(XmlFormatting fmt) {
+        m_indent = m_indent.substr(0, m_indent.size() - 2);
+
+        if( m_tagIsOpen ) {
+            m_os << "/>";
+            m_tagIsOpen = false;
+        } else {
+            newlineIfNecessary();
+            if (shouldIndent(fmt)) {
+                m_os << m_indent;
+            }
+            m_os << "</" << m_tags.back() << ">";
+        }
+        m_os << std::flush;
+        applyFormatting(fmt);
+        m_tags.pop_back();
+        return *this;
+    }
+
+    XmlWriter& XmlWriter::writeAttribute( std::string const& name, std::string const& attribute ) {
+        if( !name.empty() && !attribute.empty() )
+            m_os << ' ' << name << "=\"" << XmlEncode( attribute, XmlEncode::ForAttributes ) << '"';
+        return *this;
+    }
+
+    XmlWriter& XmlWriter::writeAttribute( std::string const& name, bool attribute ) {
+        m_os << ' ' << name << "=\"" << ( attribute ? "true" : "false" ) << '"';
+        return *this;
+    }
+
+    XmlWriter& XmlWriter::writeText( std::string const& text, XmlFormatting fmt) {
+        if( !text.empty() ){
+            bool tagWasOpen = m_tagIsOpen;
+            ensureTagClosed();
+            if (tagWasOpen && shouldIndent(fmt)) {
+                m_os << m_indent;
+            }
+            m_os << XmlEncode( text );
+            applyFormatting(fmt);
+        }
+        return *this;
+    }
+
+    XmlWriter& XmlWriter::writeComment( std::string const& text, XmlFormatting fmt) {
+        ensureTagClosed();
+        if (shouldIndent(fmt)) {
+            m_os << m_indent;
+        }
+        m_os << "<!--" << text << "-->";
+        applyFormatting(fmt);
+        return *this;
+    }
+
+    void XmlWriter::writeStylesheetRef( std::string const& url ) {
+        m_os << "<?xml-stylesheet type=\"text/xsl\" href=\"" << url << "\"?>\n";
+    }
+
+    XmlWriter& XmlWriter::writeBlankLine() {
+        ensureTagClosed();
+        m_os << '\n';
+        return *this;
+    }
+
+    void XmlWriter::ensureTagClosed() {
+        if( m_tagIsOpen ) {
+            m_os << '>' << std::flush;
+            newlineIfNecessary();
+            m_tagIsOpen = false;
+        }
+    }
+
+    void XmlWriter::applyFormatting(XmlFormatting fmt) {
+        m_needsNewline = shouldNewline(fmt);
+    }
+
+    void XmlWriter::writeDeclaration() {
+        m_os << "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";
+    }
+
+    void XmlWriter::newlineIfNecessary() {
+        if( m_needsNewline ) {
+            m_os << std::endl;
+            m_needsNewline = false;
+        }
+    }
+}
+// end catch_xmlwriter.cpp
+// start catch_reporter_bases.cpp
+
+#include <cstring>
+#include <cfloat>
+#include <cstdio>
+#include <cassert>
+#include <memory>
+
+namespace Catch {
+    void prepareExpandedExpression(AssertionResult& result) {
+        result.getExpandedExpression();
+    }
+
+    // Because formatting using c++ streams is stateful, drop down to C is required
+    // Alternatively we could use stringstream, but its performance is... not good.
+    std::string getFormattedDuration( double duration ) {
+        // Max exponent + 1 is required to represent the whole part
+        // + 1 for decimal point
+        // + 3 for the 3 decimal places
+        // + 1 for null terminator
+        const std::size_t maxDoubleSize = DBL_MAX_10_EXP + 1 + 1 + 3 + 1;
+        char buffer[maxDoubleSize];
+
+        // Save previous errno, to prevent sprintf from overwriting it
+        ErrnoGuard guard;
+#ifdef _MSC_VER
+        sprintf_s(buffer, "%.3f", duration);
+#else
+        std::sprintf(buffer, "%.3f", duration);
+#endif
+        return std::string(buffer);
+    }
+
+    bool shouldShowDuration( IConfig const& config, double duration ) {
+        if ( config.showDurations() == ShowDurations::Always ) {
+            return true;
+        }
+        if ( config.showDurations() == ShowDurations::Never ) {
+            return false;
+        }
+        const double min = config.minDuration();
+        return min >= 0 && duration >= min;
+    }
+
+    std::string serializeFilters( std::vector<std::string> const& container ) {
+        ReusableStringStream oss;
+        bool first = true;
+        for (auto&& filter : container)
+        {
+            if (!first)
+                oss << ' ';
+            else
+                first = false;
+
+            oss << filter;
+        }
+        return oss.str();
+    }
+
+    TestEventListenerBase::TestEventListenerBase(ReporterConfig const & _config)
+        :StreamingReporterBase(_config) {}
+
+    std::set<Verbosity> TestEventListenerBase::getSupportedVerbosities() {
+        return { Verbosity::Quiet, Verbosity::Normal, Verbosity::High };
+    }
+
+    void TestEventListenerBase::assertionStarting(AssertionInfo const &) {}
+
+    bool TestEventListenerBase::assertionEnded(AssertionStats const &) {
+        return false;
+    }
+
+} // end namespace Catch
+// end catch_reporter_bases.cpp
+// start catch_reporter_compact.cpp
+
+namespace {
+
+#ifdef CATCH_PLATFORM_MAC
+    const char* failedString() { return "FAILED"; }
+    const char* passedString() { return "PASSED"; }
+#else
+    const char* failedString() { return "failed"; }
+    const char* passedString() { return "passed"; }
+#endif
+
+    // Colour::LightGrey
+    Catch::Colour::Code dimColour() { return Catch::Colour::FileName; }
+
+    std::string bothOrAll( std::size_t count ) {
+        return count == 1 ? std::string() :
+               count == 2 ? "both " : "all " ;
+    }
+
+} // anon namespace
+
+namespace Catch {
+namespace {
+// Colour, message variants:
+// - white: No tests ran.
+// -   red: Failed [both/all] N test cases, failed [both/all] M assertions.
+// - white: Passed [both/all] N test cases (no assertions).
+// -   red: Failed N tests cases, failed M assertions.
+// - green: Passed [both/all] N tests cases with M assertions.
+void printTotals(std::ostream& out, const Totals& totals) {
+    if (totals.testCases.total() == 0) {
+        out << "No tests ran.";
+    } else if (totals.testCases.failed == totals.testCases.total()) {
+        Colour colour(Colour::ResultError);
+        const std::string qualify_assertions_failed =
+            totals.assertions.failed == totals.assertions.total() ?
+            bothOrAll(totals.assertions.failed) : std::string();
+        out <<
+            "Failed " << bothOrAll(totals.testCases.failed)
+            << pluralise(totals.testCases.failed, "test case") << ", "
+            "failed " << qualify_assertions_failed <<
+            pluralise(totals.assertions.failed, "assertion") << '.';
+    } else if (totals.assertions.total() == 0) {
+        out <<
+            "Passed " << bothOrAll(totals.testCases.total())
+            << pluralise(totals.testCases.total(), "test case")
+            << " (no assertions).";
+    } else if (totals.assertions.failed) {
+        Colour colour(Colour::ResultError);
+        out <<
+            "Failed " << pluralise(totals.testCases.failed, "test case") << ", "
+            "failed " << pluralise(totals.assertions.failed, "assertion") << '.';
+    } else {
+        Colour colour(Colour::ResultSuccess);
+        out <<
+            "Passed " << bothOrAll(totals.testCases.passed)
+            << pluralise(totals.testCases.passed, "test case") <<
+            " with " << pluralise(totals.assertions.passed, "assertion") << '.';
+    }
+}
+
+// Implementation of CompactReporter formatting
+class AssertionPrinter {
+public:
+    AssertionPrinter& operator= (AssertionPrinter const&) = delete;
+    AssertionPrinter(AssertionPrinter const&) = delete;
+    AssertionPrinter(std::ostream& _stream, AssertionStats const& _stats, bool _printInfoMessages)
+        : stream(_stream)
+        , result(_stats.assertionResult)
+        , messages(_stats.infoMessages)
+        , itMessage(_stats.infoMessages.begin())
+        , printInfoMessages(_printInfoMessages) {}
+
+    void print() {
+        printSourceInfo();
+
+        itMessage = messages.begin();
+
+        switch (result.getResultType()) {
+        case ResultWas::Ok:
+            printResultType(Colour::ResultSuccess, passedString());
+            printOriginalExpression();
+            printReconstructedExpression();
+            if (!result.hasExpression())
+                printRemainingMessages(Colour::None);
+            else
+                printRemainingMessages();
+            break;
+        case ResultWas::ExpressionFailed:
+            if (result.isOk())
+                printResultType(Colour::ResultSuccess, failedString() + std::string(" - but was ok"));
+            else
+                printResultType(Colour::Error, failedString());
+            printOriginalExpression();
+            printReconstructedExpression();
+            printRemainingMessages();
+            break;
+        case ResultWas::ThrewException:
+            printResultType(Colour::Error, failedString());
+            printIssue("unexpected exception with message:");
+            printMessage();
+            printExpressionWas();
+            printRemainingMessages();
+            break;
+        case ResultWas::FatalErrorCondition:
+            printResultType(Colour::Error, failedString());
+            printIssue("fatal error condition with message:");
+            printMessage();
+            printExpressionWas();
+            printRemainingMessages();
+            break;
+        case ResultWas::DidntThrowException:
+            printResultType(Colour::Error, failedString());
+            printIssue("expected exception, got none");
+            printExpressionWas();
+            printRemainingMessages();
+            break;
+        case ResultWas::Info:
+            printResultType(Colour::None, "info");
+            printMessage();
+            printRemainingMessages();
+            break;
+        case ResultWas::Warning:
+            printResultType(Colour::None, "warning");
+            printMessage();
+            printRemainingMessages();
+            break;
+        case ResultWas::ExplicitFailure:
+            printResultType(Colour::Error, failedString());
+            printIssue("explicitly");
+            printRemainingMessages(Colour::None);
+            break;
+            // These cases are here to prevent compiler warnings
+        case ResultWas::Unknown:
+        case ResultWas::FailureBit:
+        case ResultWas::Exception:
+            printResultType(Colour::Error, "** internal error **");
+            break;
+        }
+    }
+
+private:
+    void printSourceInfo() const {
+        Colour colourGuard(Colour::FileName);
+        stream << result.getSourceInfo() << ':';
+    }
+
+    void printResultType(Colour::Code colour, std::string const& passOrFail) const {
+        if (!passOrFail.empty()) {
+            {
+                Colour colourGuard(colour);
+                stream << ' ' << passOrFail;
+            }
+            stream << ':';
+        }
+    }
+
+    void printIssue(std::string const& issue) const {
+        stream << ' ' << issue;
+    }
+
+    void printExpressionWas() {
+        if (result.hasExpression()) {
+            stream << ';';
+            {
+                Colour colour(dimColour());
+                stream << " expression was:";
+            }
+            printOriginalExpression();
+        }
+    }
+
+    void printOriginalExpression() const {
+        if (result.hasExpression()) {
+            stream << ' ' << result.getExpression();
+        }
+    }
+
+    void printReconstructedExpression() const {
+        if (result.hasExpandedExpression()) {
+            {
+                Colour colour(dimColour());
+                stream << " for: ";
+            }
+            stream << result.getExpandedExpression();
+        }
+    }
+
+    void printMessage() {
+        if (itMessage != messages.end()) {
+            stream << " '" << itMessage->message << '\'';
+            ++itMessage;
+        }
+    }
+
+    void printRemainingMessages(Colour::Code colour = dimColour()) {
+        if (itMessage == messages.end())
+            return;
+
+        const auto itEnd = messages.cend();
+        const auto N = static_cast<std::size_t>(std::distance(itMessage, itEnd));
+
+        {
+            Colour colourGuard(colour);
+            stream << " with " << pluralise(N, "message") << ':';
+        }
+
+        while (itMessage != itEnd) {
+            // If this assertion is a warning ignore any INFO messages
+            if (printInfoMessages || itMessage->type != ResultWas::Info) {
+                printMessage();
+                if (itMessage != itEnd) {
+                    Colour colourGuard(dimColour());
+                    stream << " and";
+                }
+                continue;
+            }
+            ++itMessage;
+        }
+    }
+
+private:
+    std::ostream& stream;
+    AssertionResult const& result;
+    std::vector<MessageInfo> messages;
+    std::vector<MessageInfo>::const_iterator itMessage;
+    bool printInfoMessages;
+};
+
+} // anon namespace
+
+        std::string CompactReporter::getDescription() {
+            return "Reports test results on a single line, suitable for IDEs";
+        }
+
+        void CompactReporter::noMatchingTestCases( std::string const& spec ) {
+            stream << "No test cases matched '" << spec << '\'' << std::endl;
+        }
+
+        void CompactReporter::assertionStarting( AssertionInfo const& ) {}
+
+        bool CompactReporter::assertionEnded( AssertionStats const& _assertionStats ) {
+            AssertionResult const& result = _assertionStats.assertionResult;
+
+            bool printInfoMessages = true;
+
+            // Drop out if result was successful and we're not printing those
+            if( !m_config->includeSuccessfulResults() && result.isOk() ) {
+                if( result.getResultType() != ResultWas::Warning )
+                    return false;
+                printInfoMessages = false;
+            }
+
+            AssertionPrinter printer( stream, _assertionStats, printInfoMessages );
+            printer.print();
+
+            stream << std::endl;
+            return true;
+        }
+
+        void CompactReporter::sectionEnded(SectionStats const& _sectionStats) {
+            double dur = _sectionStats.durationInSeconds;
+            if ( shouldShowDuration( *m_config, dur ) ) {
+                stream << getFormattedDuration( dur ) << " s: " << _sectionStats.sectionInfo.name << std::endl;
+            }
+        }
+
+        void CompactReporter::testRunEnded( TestRunStats const& _testRunStats ) {
+            printTotals( stream, _testRunStats.totals );
+            stream << '\n' << std::endl;
+            StreamingReporterBase::testRunEnded( _testRunStats );
+        }
+
+        CompactReporter::~CompactReporter() {}
+
+    CATCH_REGISTER_REPORTER( "compact", CompactReporter )
+
+} // end namespace Catch
+// end catch_reporter_compact.cpp
+// start catch_reporter_console.cpp
+
+#include <cfloat>
+#include <cstdio>
+
+#if defined(_MSC_VER)
+#pragma warning(push)
+#pragma warning(disable:4061) // Not all labels are EXPLICITLY handled in switch
+ // Note that 4062 (not all labels are handled and default is missing) is enabled
+#endif
+
+#if defined(__clang__)
+#  pragma clang diagnostic push
+// For simplicity, benchmarking-only helpers are always enabled
+#  pragma clang diagnostic ignored "-Wunused-function"
+#endif
+
+namespace Catch {
+
+namespace {
+
+// Formatter impl for ConsoleReporter
+class ConsoleAssertionPrinter {
+public:
+    ConsoleAssertionPrinter& operator= (ConsoleAssertionPrinter const&) = delete;
+    ConsoleAssertionPrinter(ConsoleAssertionPrinter const&) = delete;
+    ConsoleAssertionPrinter(std::ostream& _stream, AssertionStats const& _stats, bool _printInfoMessages)
+        : stream(_stream),
+        stats(_stats),
+        result(_stats.assertionResult),
+        colour(Colour::None),
+        message(result.getMessage()),
+        messages(_stats.infoMessages),
+        printInfoMessages(_printInfoMessages) {
+        switch (result.getResultType()) {
+        case ResultWas::Ok:
+            colour = Colour::Success;
+            passOrFail = "PASSED";
+            //if( result.hasMessage() )
+            if (_stats.infoMessages.size() == 1)
+                messageLabel = "with message";
+            if (_stats.infoMessages.size() > 1)
+                messageLabel = "with messages";
+            break;
+        case ResultWas::ExpressionFailed:
+            if (result.isOk()) {
+                colour = Colour::Success;
+                passOrFail = "FAILED - but was ok";
+            } else {
+                colour = Colour::Error;
+                passOrFail = "FAILED";
+            }
+            if (_stats.infoMessages.size() == 1)
+                messageLabel = "with message";
+            if (_stats.infoMessages.size() > 1)
+                messageLabel = "with messages";
+            break;
+        case ResultWas::ThrewException:
+            colour = Colour::Error;
+            passOrFail = "FAILED";
+            messageLabel = "due to unexpected exception with ";
+            if (_stats.infoMessages.size() == 1)
+                messageLabel += "message";
+            if (_stats.infoMessages.size() > 1)
+                messageLabel += "messages";
+            break;
+        case ResultWas::FatalErrorCondition:
+            colour = Colour::Error;
+            passOrFail = "FAILED";
+            messageLabel = "due to a fatal error condition";
+            break;
+        case ResultWas::DidntThrowException:
+            colour = Colour::Error;
+            passOrFail = "FAILED";
+            messageLabel = "because no exception was thrown where one was expected";
+            break;
+        case ResultWas::Info:
+            messageLabel = "info";
+            break;
+        case ResultWas::Warning:
+            messageLabel = "warning";
+            break;
+        case ResultWas::ExplicitFailure:
+            passOrFail = "FAILED";
+            colour = Colour::Error;
+            if (_stats.infoMessages.size() == 1)
+                messageLabel = "explicitly with message";
+            if (_stats.infoMessages.size() > 1)
+                messageLabel = "explicitly with messages";
+            break;
+            // These cases are here to prevent compiler warnings
+        case ResultWas::Unknown:
+        case ResultWas::FailureBit:
+        case ResultWas::Exception:
+            passOrFail = "** internal error **";
+            colour = Colour::Error;
+            break;
+        }
+    }
+
+    void print() const {
+        printSourceInfo();
+        if (stats.totals.assertions.total() > 0) {
+            printResultType();
+            printOriginalExpression();
+            printReconstructedExpression();
+        } else {
+            stream << '\n';
+        }
+        printMessage();
+    }
+
+private:
+    void printResultType() const {
+        if (!passOrFail.empty()) {
+            Colour colourGuard(colour);
+            stream << passOrFail << ":\n";
+        }
+    }
+    void printOriginalExpression() const {
+        if (result.hasExpression()) {
+            Colour colourGuard(Colour::OriginalExpression);
+            stream << "  ";
+            stream << result.getExpressionInMacro();
+            stream << '\n';
+        }
+    }
+    void printReconstructedExpression() const {
+        if (result.hasExpandedExpression()) {
+            stream << "with expansion:\n";
+            Colour colourGuard(Colour::ReconstructedExpression);
+            stream << Column(result.getExpandedExpression()).indent(2) << '\n';
+        }
+    }
+    void printMessage() const {
+        if (!messageLabel.empty())
+            stream << messageLabel << ':' << '\n';
+        for (auto const& msg : messages) {
+            // If this assertion is a warning ignore any INFO messages
+            if (printInfoMessages || msg.type != ResultWas::Info)
+                stream << Column(msg.message).indent(2) << '\n';
+        }
+    }
+    void printSourceInfo() const {
+        Colour colourGuard(Colour::FileName);
+        stream << result.getSourceInfo() << ": ";
+    }
+
+    std::ostream& stream;
+    AssertionStats const& stats;
+    AssertionResult const& result;
+    Colour::Code colour;
+    std::string passOrFail;
+    std::string messageLabel;
+    std::string message;
+    std::vector<MessageInfo> messages;
+    bool printInfoMessages;
+};
+
+std::size_t makeRatio(std::size_t number, std::size_t total) {
+    std::size_t ratio = total > 0 ? CATCH_CONFIG_CONSOLE_WIDTH * number / total : 0;
+    return (ratio == 0 && number > 0) ? 1 : ratio;
+}
+
+std::size_t& findMax(std::size_t& i, std::size_t& j, std::size_t& k) {
+    if (i > j && i > k)
+        return i;
+    else if (j > k)
+        return j;
+    else
+        return k;
+}
+
+struct ColumnInfo {
+    enum Justification { Left, Right };
+    std::string name;
+    int width;
+    Justification justification;
+};
+struct ColumnBreak {};
+struct RowBreak {};
+
+class Duration {
+    enum class Unit {
+        Auto,
+        Nanoseconds,
+        Microseconds,
+        Milliseconds,
+        Seconds,
+        Minutes
+    };
+    static const uint64_t s_nanosecondsInAMicrosecond = 1000;
+    static const uint64_t s_nanosecondsInAMillisecond = 1000 * s_nanosecondsInAMicrosecond;
+    static const uint64_t s_nanosecondsInASecond = 1000 * s_nanosecondsInAMillisecond;
+    static const uint64_t s_nanosecondsInAMinute = 60 * s_nanosecondsInASecond;
+
+    double m_inNanoseconds;
+    Unit m_units;
+
+public:
+    explicit Duration(double inNanoseconds, Unit units = Unit::Auto)
+        : m_inNanoseconds(inNanoseconds),
+        m_units(units) {
+        if (m_units == Unit::Auto) {
+            if (m_inNanoseconds < s_nanosecondsInAMicrosecond)
+                m_units = Unit::Nanoseconds;
+            else if (m_inNanoseconds < s_nanosecondsInAMillisecond)
+                m_units = Unit::Microseconds;
+            else if (m_inNanoseconds < s_nanosecondsInASecond)
+                m_units = Unit::Milliseconds;
+            else if (m_inNanoseconds < s_nanosecondsInAMinute)
+                m_units = Unit::Seconds;
+            else
+                m_units = Unit::Minutes;
+        }
+
+    }
+
+    auto value() const -> double {
+        switch (m_units) {
+        case Unit::Microseconds:
+            return m_inNanoseconds / static_cast<double>(s_nanosecondsInAMicrosecond);
+        case Unit::Milliseconds:
+            return m_inNanoseconds / static_cast<double>(s_nanosecondsInAMillisecond);
+        case Unit::Seconds:
+            return m_inNanoseconds / static_cast<double>(s_nanosecondsInASecond);
+        case Unit::Minutes:
+            return m_inNanoseconds / static_cast<double>(s_nanosecondsInAMinute);
+        default:
+            return m_inNanoseconds;
+        }
+    }
+    auto unitsAsString() const -> std::string {
+        switch (m_units) {
+        case Unit::Nanoseconds:
+            return "ns";
+        case Unit::Microseconds:
+            return "us";
+        case Unit::Milliseconds:
+            return "ms";
+        case Unit::Seconds:
+            return "s";
+        case Unit::Minutes:
+            return "m";
+        default:
+            return "** internal error **";
+        }
+
+    }
+    friend auto operator << (std::ostream& os, Duration const& duration) -> std::ostream& {
+        return os << duration.value() << ' ' << duration.unitsAsString();
+    }
+};
+} // end anon namespace
+
+class TablePrinter {
+    std::ostream& m_os;
+    std::vector<ColumnInfo> m_columnInfos;
+    std::ostringstream m_oss;
+    int m_currentColumn = -1;
+    bool m_isOpen = false;
+
+public:
+    TablePrinter( std::ostream& os, std::vector<ColumnInfo> columnInfos )
+    :   m_os( os ),
+        m_columnInfos( std::move( columnInfos ) ) {}
+
+    auto columnInfos() const -> std::vector<ColumnInfo> const& {
+        return m_columnInfos;
+    }
+
+    void open() {
+        if (!m_isOpen) {
+            m_isOpen = true;
+            *this << RowBreak();
+
+			Columns headerCols;
+			Spacer spacer(2);
+			for (auto const& info : m_columnInfos) {
+				headerCols += Column(info.name).width(static_cast<std::size_t>(info.width - 2));
+				headerCols += spacer;
+			}
+			m_os << headerCols << '\n';
+
+            m_os << Catch::getLineOfChars<'-'>() << '\n';
+        }
+    }
+    void close() {
+        if (m_isOpen) {
+            *this << RowBreak();
+            m_os << std::endl;
+            m_isOpen = false;
+        }
+    }
+
+    template<typename T>
+    friend TablePrinter& operator << (TablePrinter& tp, T const& value) {
+        tp.m_oss << value;
+        return tp;
+    }
+
+    friend TablePrinter& operator << (TablePrinter& tp, ColumnBreak) {
+        auto colStr = tp.m_oss.str();
+        const auto strSize = colStr.size();
+        tp.m_oss.str("");
+        tp.open();
+        if (tp.m_currentColumn == static_cast<int>(tp.m_columnInfos.size() - 1)) {
+            tp.m_currentColumn = -1;
+            tp.m_os << '\n';
+        }
+        tp.m_currentColumn++;
+
+        auto colInfo = tp.m_columnInfos[tp.m_currentColumn];
+        auto padding = (strSize + 1 < static_cast<std::size_t>(colInfo.width))
+            ? std::string(colInfo.width - (strSize + 1), ' ')
+            : std::string();
+        if (colInfo.justification == ColumnInfo::Left)
+            tp.m_os << colStr << padding << ' ';
+        else
+            tp.m_os << padding << colStr << ' ';
+        return tp;
+    }
+
+    friend TablePrinter& operator << (TablePrinter& tp, RowBreak) {
+        if (tp.m_currentColumn > 0) {
+            tp.m_os << '\n';
+            tp.m_currentColumn = -1;
+        }
+        return tp;
+    }
+};
+
+ConsoleReporter::ConsoleReporter(ReporterConfig const& config)
+    : StreamingReporterBase(config),
+    m_tablePrinter(new TablePrinter(config.stream(),
+        [&config]() -> std::vector<ColumnInfo> {
+        if (config.fullConfig()->benchmarkNoAnalysis())
+        {
+            return{
+                { "benchmark name", CATCH_CONFIG_CONSOLE_WIDTH - 43, ColumnInfo::Left },
+                { "     samples", 14, ColumnInfo::Right },
+                { "  iterations", 14, ColumnInfo::Right },
+                { "        mean", 14, ColumnInfo::Right }
+            };
+        }
+        else
+        {
+            return{
+                { "benchmark name", CATCH_CONFIG_CONSOLE_WIDTH - 43, ColumnInfo::Left },
+                { "samples      mean       std dev", 14, ColumnInfo::Right },
+                { "iterations   low mean   low std dev", 14, ColumnInfo::Right },
+                { "estimated    high mean  high std dev", 14, ColumnInfo::Right }
+            };
+        }
+    }())) {}
+ConsoleReporter::~ConsoleReporter() = default;
+
+std::string ConsoleReporter::getDescription() {
+    return "Reports test results as plain lines of text";
+}
+
+void ConsoleReporter::noMatchingTestCases(std::string const& spec) {
+    stream << "No test cases matched '" << spec << '\'' << std::endl;
+}
+
+void ConsoleReporter::reportInvalidArguments(std::string const&arg){
+    stream << "Invalid Filter: " << arg << std::endl;
+}
+
+void ConsoleReporter::assertionStarting(AssertionInfo const&) {}
+
+bool ConsoleReporter::assertionEnded(AssertionStats const& _assertionStats) {
+    AssertionResult const& result = _assertionStats.assertionResult;
+
+    bool includeResults = m_config->includeSuccessfulResults() || !result.isOk();
+
+    // Drop out if result was successful but we're not printing them.
+    if (!includeResults && result.getResultType() != ResultWas::Warning)
+        return false;
+
+    lazyPrint();
+
+    ConsoleAssertionPrinter printer(stream, _assertionStats, includeResults);
+    printer.print();
+    stream << std::endl;
+    return true;
+}
+
+void ConsoleReporter::sectionStarting(SectionInfo const& _sectionInfo) {
+    m_tablePrinter->close();
+    m_headerPrinted = false;
+    StreamingReporterBase::sectionStarting(_sectionInfo);
+}
+void ConsoleReporter::sectionEnded(SectionStats const& _sectionStats) {
+    m_tablePrinter->close();
+    if (_sectionStats.missingAssertions) {
+        lazyPrint();
+        Colour colour(Colour::ResultError);
+        if (m_sectionStack.size() > 1)
+            stream << "\nNo assertions in section";
+        else
+            stream << "\nNo assertions in test case";
+        stream << " '" << _sectionStats.sectionInfo.name << "'\n" << std::endl;
+    }
+    double dur = _sectionStats.durationInSeconds;
+    if (shouldShowDuration(*m_config, dur)) {
+        stream << getFormattedDuration(dur) << " s: " << _sectionStats.sectionInfo.name << std::endl;
+    }
+    if (m_headerPrinted) {
+        m_headerPrinted = false;
+    }
+    StreamingReporterBase::sectionEnded(_sectionStats);
+}
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+void ConsoleReporter::benchmarkPreparing(std::string const& name) {
+	lazyPrintWithoutClosingBenchmarkTable();
+
+	auto nameCol = Column(name).width(static_cast<std::size_t>(m_tablePrinter->columnInfos()[0].width - 2));
+
+	bool firstLine = true;
+	for (auto line : nameCol) {
+		if (!firstLine)
+			(*m_tablePrinter) << ColumnBreak() << ColumnBreak() << ColumnBreak();
+		else
+			firstLine = false;
+
+		(*m_tablePrinter) << line << ColumnBreak();
+	}
+}
+
+void ConsoleReporter::benchmarkStarting(BenchmarkInfo const& info) {
+    (*m_tablePrinter) << info.samples << ColumnBreak()
+        << info.iterations << ColumnBreak();
+    if (!m_config->benchmarkNoAnalysis())
+        (*m_tablePrinter) << Duration(info.estimatedDuration) << ColumnBreak();
+}
+void ConsoleReporter::benchmarkEnded(BenchmarkStats<> const& stats) {
+    if (m_config->benchmarkNoAnalysis())
+    {
+        (*m_tablePrinter) << Duration(stats.mean.point.count()) << ColumnBreak();
+    }
+    else
+    {
+        (*m_tablePrinter) << ColumnBreak()
+            << Duration(stats.mean.point.count()) << ColumnBreak()
+            << Duration(stats.mean.lower_bound.count()) << ColumnBreak()
+            << Duration(stats.mean.upper_bound.count()) << ColumnBreak() << ColumnBreak()
+            << Duration(stats.standardDeviation.point.count()) << ColumnBreak()
+            << Duration(stats.standardDeviation.lower_bound.count()) << ColumnBreak()
+            << Duration(stats.standardDeviation.upper_bound.count()) << ColumnBreak() << ColumnBreak() << ColumnBreak() << ColumnBreak() << ColumnBreak();
+    }
+}
+
+void ConsoleReporter::benchmarkFailed(std::string const& error) {
+	Colour colour(Colour::Red);
+    (*m_tablePrinter)
+        << "Benchmark failed (" << error << ')'
+        << ColumnBreak() << RowBreak();
+}
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+void ConsoleReporter::testCaseEnded(TestCaseStats const& _testCaseStats) {
+    m_tablePrinter->close();
+    StreamingReporterBase::testCaseEnded(_testCaseStats);
+    m_headerPrinted = false;
+}
+void ConsoleReporter::testGroupEnded(TestGroupStats const& _testGroupStats) {
+    if (currentGroupInfo.used) {
+        printSummaryDivider();
+        stream << "Summary for group '" << _testGroupStats.groupInfo.name << "':\n";
+        printTotals(_testGroupStats.totals);
+        stream << '\n' << std::endl;
+    }
+    StreamingReporterBase::testGroupEnded(_testGroupStats);
+}
+void ConsoleReporter::testRunEnded(TestRunStats const& _testRunStats) {
+    printTotalsDivider(_testRunStats.totals);
+    printTotals(_testRunStats.totals);
+    stream << std::endl;
+    StreamingReporterBase::testRunEnded(_testRunStats);
+}
+void ConsoleReporter::testRunStarting(TestRunInfo const& _testInfo) {
+    StreamingReporterBase::testRunStarting(_testInfo);
+    printTestFilters();
+}
+
+void ConsoleReporter::lazyPrint() {
+
+    m_tablePrinter->close();
+    lazyPrintWithoutClosingBenchmarkTable();
+}
+
+void ConsoleReporter::lazyPrintWithoutClosingBenchmarkTable() {
+
+    if (!currentTestRunInfo.used)
+        lazyPrintRunInfo();
+    if (!currentGroupInfo.used)
+        lazyPrintGroupInfo();
+
+    if (!m_headerPrinted) {
+        printTestCaseAndSectionHeader();
+        m_headerPrinted = true;
+    }
+}
+void ConsoleReporter::lazyPrintRunInfo() {
+    stream << '\n' << getLineOfChars<'~'>() << '\n';
+    Colour colour(Colour::SecondaryText);
+    stream << currentTestRunInfo->name
+        << " is a Catch v" << libraryVersion() << " host application.\n"
+        << "Run with -? for options\n\n";
+
+    if (m_config->rngSeed() != 0)
+        stream << "Randomness seeded to: " << m_config->rngSeed() << "\n\n";
+
+    currentTestRunInfo.used = true;
+}
+void ConsoleReporter::lazyPrintGroupInfo() {
+    if (!currentGroupInfo->name.empty() && currentGroupInfo->groupsCounts > 1) {
+        printClosedHeader("Group: " + currentGroupInfo->name);
+        currentGroupInfo.used = true;
+    }
+}
+void ConsoleReporter::printTestCaseAndSectionHeader() {
+    assert(!m_sectionStack.empty());
+    printOpenHeader(currentTestCaseInfo->name);
+
+    if (m_sectionStack.size() > 1) {
+        Colour colourGuard(Colour::Headers);
+
+        auto
+            it = m_sectionStack.begin() + 1, // Skip first section (test case)
+            itEnd = m_sectionStack.end();
+        for (; it != itEnd; ++it)
+            printHeaderString(it->name, 2);
+    }
+
+    SourceLineInfo lineInfo = m_sectionStack.back().lineInfo;
+
+    stream << getLineOfChars<'-'>() << '\n';
+    Colour colourGuard(Colour::FileName);
+    stream << lineInfo << '\n';
+    stream << getLineOfChars<'.'>() << '\n' << std::endl;
+}
+
+void ConsoleReporter::printClosedHeader(std::string const& _name) {
+    printOpenHeader(_name);
+    stream << getLineOfChars<'.'>() << '\n';
+}
+void ConsoleReporter::printOpenHeader(std::string const& _name) {
+    stream << getLineOfChars<'-'>() << '\n';
+    {
+        Colour colourGuard(Colour::Headers);
+        printHeaderString(_name);
+    }
+}
+
+// if string has a : in first line will set indent to follow it on
+// subsequent lines
+void ConsoleReporter::printHeaderString(std::string const& _string, std::size_t indent) {
+    std::size_t i = _string.find(": ");
+    if (i != std::string::npos)
+        i += 2;
+    else
+        i = 0;
+    stream << Column(_string).indent(indent + i).initialIndent(indent) << '\n';
+}
+
+struct SummaryColumn {
+
+    SummaryColumn( std::string _label, Colour::Code _colour )
+    :   label( std::move( _label ) ),
+        colour( _colour ) {}
+    SummaryColumn addRow( std::size_t count ) {
+        ReusableStringStream rss;
+        rss << count;
+        std::string row = rss.str();
+        for (auto& oldRow : rows) {
+            while (oldRow.size() < row.size())
+                oldRow = ' ' + oldRow;
+            while (oldRow.size() > row.size())
+                row = ' ' + row;
+        }
+        rows.push_back(row);
+        return *this;
+    }
+
+    std::string label;
+    Colour::Code colour;
+    std::vector<std::string> rows;
+
+};
+
+void ConsoleReporter::printTotals( Totals const& totals ) {
+    if (totals.testCases.total() == 0) {
+        stream << Colour(Colour::Warning) << "No tests ran\n";
+    } else if (totals.assertions.total() > 0 && totals.testCases.allPassed()) {
+        stream << Colour(Colour::ResultSuccess) << "All tests passed";
+        stream << " ("
+            << pluralise(totals.assertions.passed, "assertion") << " in "
+            << pluralise(totals.testCases.passed, "test case") << ')'
+            << '\n';
+    } else {
+
+        std::vector<SummaryColumn> columns;
+        columns.push_back(SummaryColumn("", Colour::None)
+                          .addRow(totals.testCases.total())
+                          .addRow(totals.assertions.total()));
+        columns.push_back(SummaryColumn("passed", Colour::Success)
+                          .addRow(totals.testCases.passed)
+                          .addRow(totals.assertions.passed));
+        columns.push_back(SummaryColumn("failed", Colour::ResultError)
+                          .addRow(totals.testCases.failed)
+                          .addRow(totals.assertions.failed));
+        columns.push_back(SummaryColumn("failed as expected", Colour::ResultExpectedFailure)
+                          .addRow(totals.testCases.failedButOk)
+                          .addRow(totals.assertions.failedButOk));
+
+        printSummaryRow("test cases", columns, 0);
+        printSummaryRow("assertions", columns, 1);
+    }
+}
+void ConsoleReporter::printSummaryRow(std::string const& label, std::vector<SummaryColumn> const& cols, std::size_t row) {
+    for (auto col : cols) {
+        std::string value = col.rows[row];
+        if (col.label.empty()) {
+            stream << label << ": ";
+            if (value != "0")
+                stream << value;
+            else
+                stream << Colour(Colour::Warning) << "- none -";
+        } else if (value != "0") {
+            stream << Colour(Colour::LightGrey) << " | ";
+            stream << Colour(col.colour)
+                << value << ' ' << col.label;
+        }
+    }
+    stream << '\n';
+}
+
+void ConsoleReporter::printTotalsDivider(Totals const& totals) {
+    if (totals.testCases.total() > 0) {
+        std::size_t failedRatio = makeRatio(totals.testCases.failed, totals.testCases.total());
+        std::size_t failedButOkRatio = makeRatio(totals.testCases.failedButOk, totals.testCases.total());
+        std::size_t passedRatio = makeRatio(totals.testCases.passed, totals.testCases.total());
+        while (failedRatio + failedButOkRatio + passedRatio < CATCH_CONFIG_CONSOLE_WIDTH - 1)
+            findMax(failedRatio, failedButOkRatio, passedRatio)++;
+        while (failedRatio + failedButOkRatio + passedRatio > CATCH_CONFIG_CONSOLE_WIDTH - 1)
+            findMax(failedRatio, failedButOkRatio, passedRatio)--;
+
+        stream << Colour(Colour::Error) << std::string(failedRatio, '=');
+        stream << Colour(Colour::ResultExpectedFailure) << std::string(failedButOkRatio, '=');
+        if (totals.testCases.allPassed())
+            stream << Colour(Colour::ResultSuccess) << std::string(passedRatio, '=');
+        else
+            stream << Colour(Colour::Success) << std::string(passedRatio, '=');
+    } else {
+        stream << Colour(Colour::Warning) << std::string(CATCH_CONFIG_CONSOLE_WIDTH - 1, '=');
+    }
+    stream << '\n';
+}
+void ConsoleReporter::printSummaryDivider() {
+    stream << getLineOfChars<'-'>() << '\n';
+}
+
+void ConsoleReporter::printTestFilters() {
+    if (m_config->testSpec().hasFilters()) {
+        Colour guard(Colour::BrightYellow);
+        stream << "Filters: " << serializeFilters(m_config->getTestsOrTags()) << '\n';
+    }
+}
+
+CATCH_REGISTER_REPORTER("console", ConsoleReporter)
+
+} // end namespace Catch
+
+#if defined(_MSC_VER)
+#pragma warning(pop)
+#endif
+
+#if defined(__clang__)
+#  pragma clang diagnostic pop
+#endif
+// end catch_reporter_console.cpp
+// start catch_reporter_junit.cpp
+
+#include <cassert>
+#include <sstream>
+#include <ctime>
+#include <algorithm>
+#include <iomanip>
+
+namespace Catch {
+
+    namespace {
+        std::string getCurrentTimestamp() {
+            // Beware, this is not reentrant because of backward compatibility issues
+            // Also, UTC only, again because of backward compatibility (%z is C++11)
+            time_t rawtime;
+            std::time(&rawtime);
+            auto const timeStampSize = sizeof("2017-01-16T17:06:45Z");
+
+#ifdef _MSC_VER
+            std::tm timeInfo = {};
+            gmtime_s(&timeInfo, &rawtime);
+#else
+            std::tm* timeInfo;
+            timeInfo = std::gmtime(&rawtime);
+#endif
+
+            char timeStamp[timeStampSize];
+            const char * const fmt = "%Y-%m-%dT%H:%M:%SZ";
+
+#ifdef _MSC_VER
+            std::strftime(timeStamp, timeStampSize, fmt, &timeInfo);
+#else
+            std::strftime(timeStamp, timeStampSize, fmt, timeInfo);
+#endif
+            return std::string(timeStamp, timeStampSize-1);
+        }
+
+        std::string fileNameTag(const std::vector<std::string> &tags) {
+            auto it = std::find_if(begin(tags),
+                                   end(tags),
+                                   [] (std::string const& tag) {return tag.front() == '#'; });
+            if (it != tags.end())
+                return it->substr(1);
+            return std::string();
+        }
+
+        // Formats the duration in seconds to 3 decimal places.
+        // This is done because some genius defined Maven Surefire schema
+        // in a way that only accepts 3 decimal places, and tools like
+        // Jenkins use that schema for validation JUnit reporter output.
+        std::string formatDuration( double seconds ) {
+            ReusableStringStream rss;
+            rss << std::fixed << std::setprecision( 3 ) << seconds;
+            return rss.str();
+        }
+
+    } // anonymous namespace
+
+    JunitReporter::JunitReporter( ReporterConfig const& _config )
+        :   CumulativeReporterBase( _config ),
+            xml( _config.stream() )
+        {
+            m_reporterPrefs.shouldRedirectStdOut = true;
+            m_reporterPrefs.shouldReportAllAssertions = true;
+        }
+
+    JunitReporter::~JunitReporter() {}
+
+    std::string JunitReporter::getDescription() {
+        return "Reports test results in an XML format that looks like Ant's junitreport target";
+    }
+
+    void JunitReporter::noMatchingTestCases( std::string const& /*spec*/ ) {}
+
+    void JunitReporter::testRunStarting( TestRunInfo const& runInfo )  {
+        CumulativeReporterBase::testRunStarting( runInfo );
+        xml.startElement( "testsuites" );
+    }
+
+    void JunitReporter::testGroupStarting( GroupInfo const& groupInfo ) {
+        suiteTimer.start();
+        stdOutForSuite.clear();
+        stdErrForSuite.clear();
+        unexpectedExceptions = 0;
+        CumulativeReporterBase::testGroupStarting( groupInfo );
+    }
+
+    void JunitReporter::testCaseStarting( TestCaseInfo const& testCaseInfo ) {
+        m_okToFail = testCaseInfo.okToFail();
+    }
+
+    bool JunitReporter::assertionEnded( AssertionStats const& assertionStats ) {
+        if( assertionStats.assertionResult.getResultType() == ResultWas::ThrewException && !m_okToFail )
+            unexpectedExceptions++;
+        return CumulativeReporterBase::assertionEnded( assertionStats );
+    }
+
+    void JunitReporter::testCaseEnded( TestCaseStats const& testCaseStats ) {
+        stdOutForSuite += testCaseStats.stdOut;
+        stdErrForSuite += testCaseStats.stdErr;
+        CumulativeReporterBase::testCaseEnded( testCaseStats );
+    }
+
+    void JunitReporter::testGroupEnded( TestGroupStats const& testGroupStats ) {
+        double suiteTime = suiteTimer.getElapsedSeconds();
+        CumulativeReporterBase::testGroupEnded( testGroupStats );
+        writeGroup( *m_testGroups.back(), suiteTime );
+    }
+
+    void JunitReporter::testRunEndedCumulative() {
+        xml.endElement();
+    }
+
+    void JunitReporter::writeGroup( TestGroupNode const& groupNode, double suiteTime ) {
+        XmlWriter::ScopedElement e = xml.scopedElement( "testsuite" );
+
+        TestGroupStats const& stats = groupNode.value;
+        xml.writeAttribute( "name", stats.groupInfo.name );
+        xml.writeAttribute( "errors", unexpectedExceptions );
+        xml.writeAttribute( "failures", stats.totals.assertions.failed-unexpectedExceptions );
+        xml.writeAttribute( "tests", stats.totals.assertions.total() );
+        xml.writeAttribute( "hostname", "tbd" ); // !TBD
+        if( m_config->showDurations() == ShowDurations::Never )
+            xml.writeAttribute( "time", "" );
+        else
+            xml.writeAttribute( "time", formatDuration( suiteTime ) );
+        xml.writeAttribute( "timestamp", getCurrentTimestamp() );
+
+        // Write properties if there are any
+        if (m_config->hasTestFilters() || m_config->rngSeed() != 0) {
+            auto properties = xml.scopedElement("properties");
+            if (m_config->hasTestFilters()) {
+                xml.scopedElement("property")
+                    .writeAttribute("name", "filters")
+                    .writeAttribute("value", serializeFilters(m_config->getTestsOrTags()));
+            }
+            if (m_config->rngSeed() != 0) {
+                xml.scopedElement("property")
+                    .writeAttribute("name", "random-seed")
+                    .writeAttribute("value", m_config->rngSeed());
+            }
+        }
+
+        // Write test cases
+        for( auto const& child : groupNode.children )
+            writeTestCase( *child );
+
+        xml.scopedElement( "system-out" ).writeText( trim( stdOutForSuite ), XmlFormatting::Newline );
+        xml.scopedElement( "system-err" ).writeText( trim( stdErrForSuite ), XmlFormatting::Newline );
+    }
+
+    void JunitReporter::writeTestCase( TestCaseNode const& testCaseNode ) {
+        TestCaseStats const& stats = testCaseNode.value;
+
+        // All test cases have exactly one section - which represents the
+        // test case itself. That section may have 0-n nested sections
+        assert( testCaseNode.children.size() == 1 );
+        SectionNode const& rootSection = *testCaseNode.children.front();
+
+        std::string className = stats.testInfo.className;
+
+        if( className.empty() ) {
+            className = fileNameTag(stats.testInfo.tags);
+            if ( className.empty() )
+                className = "global";
+        }
+
+        if ( !m_config->name().empty() )
+            className = m_config->name() + "." + className;
+
+        writeSection( className, "", rootSection, stats.testInfo.okToFail() );
+    }
+
+    void JunitReporter::writeSection( std::string const& className,
+                                      std::string const& rootName,
+                                      SectionNode const& sectionNode,
+                                      bool testOkToFail) {
+        std::string name = trim( sectionNode.stats.sectionInfo.name );
+        if( !rootName.empty() )
+            name = rootName + '/' + name;
+
+        if( !sectionNode.assertions.empty() ||
+            !sectionNode.stdOut.empty() ||
+            !sectionNode.stdErr.empty() ) {
+            XmlWriter::ScopedElement e = xml.scopedElement( "testcase" );
+            if( className.empty() ) {
+                xml.writeAttribute( "classname", name );
+                xml.writeAttribute( "name", "root" );
+            }
+            else {
+                xml.writeAttribute( "classname", className );
+                xml.writeAttribute( "name", name );
+            }
+            xml.writeAttribute( "time", formatDuration( sectionNode.stats.durationInSeconds ) );
+            // This is not ideal, but it should be enough to mimic gtest's
+            // junit output.
+            // Ideally the JUnit reporter would also handle `skipTest`
+            // events and write those out appropriately.
+            xml.writeAttribute( "status", "run" );
+
+            if (sectionNode.stats.assertions.failedButOk) {
+                xml.scopedElement("skipped")
+                    .writeAttribute("message", "TEST_CASE tagged with !mayfail");
+            }
+
+            writeAssertions( sectionNode );
+
+            if( !sectionNode.stdOut.empty() )
+                xml.scopedElement( "system-out" ).writeText( trim( sectionNode.stdOut ), XmlFormatting::Newline );
+            if( !sectionNode.stdErr.empty() )
+                xml.scopedElement( "system-err" ).writeText( trim( sectionNode.stdErr ), XmlFormatting::Newline );
+        }
+        for( auto const& childNode : sectionNode.childSections )
+            if( className.empty() )
+                writeSection( name, "", *childNode, testOkToFail );
+            else
+                writeSection( className, name, *childNode, testOkToFail );
+    }
+
+    void JunitReporter::writeAssertions( SectionNode const& sectionNode ) {
+        for( auto const& assertion : sectionNode.assertions )
+            writeAssertion( assertion );
+    }
+
+    void JunitReporter::writeAssertion( AssertionStats const& stats ) {
+        AssertionResult const& result = stats.assertionResult;
+        if( !result.isOk() ) {
+            std::string elementName;
+            switch( result.getResultType() ) {
+                case ResultWas::ThrewException:
+                case ResultWas::FatalErrorCondition:
+                    elementName = "error";
+                    break;
+                case ResultWas::ExplicitFailure:
+                case ResultWas::ExpressionFailed:
+                case ResultWas::DidntThrowException:
+                    elementName = "failure";
+                    break;
+
+                // We should never see these here:
+                case ResultWas::Info:
+                case ResultWas::Warning:
+                case ResultWas::Ok:
+                case ResultWas::Unknown:
+                case ResultWas::FailureBit:
+                case ResultWas::Exception:
+                    elementName = "internalError";
+                    break;
+            }
+
+            XmlWriter::ScopedElement e = xml.scopedElement( elementName );
+
+            xml.writeAttribute( "message", result.getExpression() );
+            xml.writeAttribute( "type", result.getTestMacroName() );
+
+            ReusableStringStream rss;
+            if (stats.totals.assertions.total() > 0) {
+                rss << "FAILED" << ":\n";
+                if (result.hasExpression()) {
+                    rss << "  ";
+                    rss << result.getExpressionInMacro();
+                    rss << '\n';
+                }
+                if (result.hasExpandedExpression()) {
+                    rss << "with expansion:\n";
+                    rss << Column(result.getExpandedExpression()).indent(2) << '\n';
+                }
+            } else {
+                rss << '\n';
+            }
+
+            if( !result.getMessage().empty() )
+                rss << result.getMessage() << '\n';
+            for( auto const& msg : stats.infoMessages )
+                if( msg.type == ResultWas::Info )
+                    rss << msg.message << '\n';
+
+            rss << "at " << result.getSourceInfo();
+            xml.writeText( rss.str(), XmlFormatting::Newline );
+        }
+    }
+
+    CATCH_REGISTER_REPORTER( "junit", JunitReporter )
+
+} // end namespace Catch
+// end catch_reporter_junit.cpp
+// start catch_reporter_listening.cpp
+
+#include <cassert>
+
+namespace Catch {
+
+    ListeningReporter::ListeningReporter() {
+        // We will assume that listeners will always want all assertions
+        m_preferences.shouldReportAllAssertions = true;
+    }
+
+    void ListeningReporter::addListener( IStreamingReporterPtr&& listener ) {
+        m_listeners.push_back( std::move( listener ) );
+    }
+
+    void ListeningReporter::addReporter(IStreamingReporterPtr&& reporter) {
+        assert(!m_reporter && "Listening reporter can wrap only 1 real reporter");
+        m_reporter = std::move( reporter );
+        m_preferences.shouldRedirectStdOut = m_reporter->getPreferences().shouldRedirectStdOut;
+    }
+
+    ReporterPreferences ListeningReporter::getPreferences() const {
+        return m_preferences;
+    }
+
+    std::set<Verbosity> ListeningReporter::getSupportedVerbosities() {
+        return std::set<Verbosity>{ };
+    }
+
+    void ListeningReporter::noMatchingTestCases( std::string const& spec ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->noMatchingTestCases( spec );
+        }
+        m_reporter->noMatchingTestCases( spec );
+    }
+
+    void ListeningReporter::reportInvalidArguments(std::string const&arg){
+        for ( auto const& listener : m_listeners ) {
+            listener->reportInvalidArguments( arg );
+        }
+        m_reporter->reportInvalidArguments( arg );
+    }
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+    void ListeningReporter::benchmarkPreparing( std::string const& name ) {
+		for (auto const& listener : m_listeners) {
+			listener->benchmarkPreparing(name);
+		}
+		m_reporter->benchmarkPreparing(name);
+	}
+    void ListeningReporter::benchmarkStarting( BenchmarkInfo const& benchmarkInfo ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->benchmarkStarting( benchmarkInfo );
+        }
+        m_reporter->benchmarkStarting( benchmarkInfo );
+    }
+    void ListeningReporter::benchmarkEnded( BenchmarkStats<> const& benchmarkStats ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->benchmarkEnded( benchmarkStats );
+        }
+        m_reporter->benchmarkEnded( benchmarkStats );
+    }
+
+	void ListeningReporter::benchmarkFailed( std::string const& error ) {
+		for (auto const& listener : m_listeners) {
+			listener->benchmarkFailed(error);
+		}
+		m_reporter->benchmarkFailed(error);
+	}
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+    void ListeningReporter::testRunStarting( TestRunInfo const& testRunInfo ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->testRunStarting( testRunInfo );
+        }
+        m_reporter->testRunStarting( testRunInfo );
+    }
+
+    void ListeningReporter::testGroupStarting( GroupInfo const& groupInfo ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->testGroupStarting( groupInfo );
+        }
+        m_reporter->testGroupStarting( groupInfo );
+    }
+
+    void ListeningReporter::testCaseStarting( TestCaseInfo const& testInfo ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->testCaseStarting( testInfo );
+        }
+        m_reporter->testCaseStarting( testInfo );
+    }
+
+    void ListeningReporter::sectionStarting( SectionInfo const& sectionInfo ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->sectionStarting( sectionInfo );
+        }
+        m_reporter->sectionStarting( sectionInfo );
+    }
+
+    void ListeningReporter::assertionStarting( AssertionInfo const& assertionInfo ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->assertionStarting( assertionInfo );
+        }
+        m_reporter->assertionStarting( assertionInfo );
+    }
+
+    // The return value indicates if the messages buffer should be cleared:
+    bool ListeningReporter::assertionEnded( AssertionStats const& assertionStats ) {
+        for( auto const& listener : m_listeners ) {
+            static_cast<void>( listener->assertionEnded( assertionStats ) );
+        }
+        return m_reporter->assertionEnded( assertionStats );
+    }
+
+    void ListeningReporter::sectionEnded( SectionStats const& sectionStats ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->sectionEnded( sectionStats );
+        }
+        m_reporter->sectionEnded( sectionStats );
+    }
+
+    void ListeningReporter::testCaseEnded( TestCaseStats const& testCaseStats ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->testCaseEnded( testCaseStats );
+        }
+        m_reporter->testCaseEnded( testCaseStats );
+    }
+
+    void ListeningReporter::testGroupEnded( TestGroupStats const& testGroupStats ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->testGroupEnded( testGroupStats );
+        }
+        m_reporter->testGroupEnded( testGroupStats );
+    }
+
+    void ListeningReporter::testRunEnded( TestRunStats const& testRunStats ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->testRunEnded( testRunStats );
+        }
+        m_reporter->testRunEnded( testRunStats );
+    }
+
+    void ListeningReporter::skipTest( TestCaseInfo const& testInfo ) {
+        for ( auto const& listener : m_listeners ) {
+            listener->skipTest( testInfo );
+        }
+        m_reporter->skipTest( testInfo );
+    }
+
+    bool ListeningReporter::isMulti() const {
+        return true;
+    }
+
+} // end namespace Catch
+// end catch_reporter_listening.cpp
+// start catch_reporter_xml.cpp
+
+#if defined(_MSC_VER)
+#pragma warning(push)
+#pragma warning(disable:4061) // Not all labels are EXPLICITLY handled in switch
+                              // Note that 4062 (not all labels are handled
+                              // and default is missing) is enabled
+#endif
+
+namespace Catch {
+    XmlReporter::XmlReporter( ReporterConfig const& _config )
+    :   StreamingReporterBase( _config ),
+        m_xml(_config.stream())
+    {
+        m_reporterPrefs.shouldRedirectStdOut = true;
+        m_reporterPrefs.shouldReportAllAssertions = true;
+    }
+
+    XmlReporter::~XmlReporter() = default;
+
+    std::string XmlReporter::getDescription() {
+        return "Reports test results as an XML document";
+    }
+
+    std::string XmlReporter::getStylesheetRef() const {
+        return std::string();
+    }
+
+    void XmlReporter::writeSourceInfo( SourceLineInfo const& sourceInfo ) {
+        m_xml
+            .writeAttribute( "filename", sourceInfo.file )
+            .writeAttribute( "line", sourceInfo.line );
+    }
+
+    void XmlReporter::noMatchingTestCases( std::string const& s ) {
+        StreamingReporterBase::noMatchingTestCases( s );
+    }
+
+    void XmlReporter::testRunStarting( TestRunInfo const& testInfo ) {
+        StreamingReporterBase::testRunStarting( testInfo );
+        std::string stylesheetRef = getStylesheetRef();
+        if( !stylesheetRef.empty() )
+            m_xml.writeStylesheetRef( stylesheetRef );
+        m_xml.startElement( "Catch" );
+        if( !m_config->name().empty() )
+            m_xml.writeAttribute( "name", m_config->name() );
+        if (m_config->testSpec().hasFilters())
+            m_xml.writeAttribute( "filters", serializeFilters( m_config->getTestsOrTags() ) );
+        if( m_config->rngSeed() != 0 )
+            m_xml.scopedElement( "Randomness" )
+                .writeAttribute( "seed", m_config->rngSeed() );
+    }
+
+    void XmlReporter::testGroupStarting( GroupInfo const& groupInfo ) {
+        StreamingReporterBase::testGroupStarting( groupInfo );
+        m_xml.startElement( "Group" )
+            .writeAttribute( "name", groupInfo.name );
+    }
+
+    void XmlReporter::testCaseStarting( TestCaseInfo const& testInfo ) {
+        StreamingReporterBase::testCaseStarting(testInfo);
+        m_xml.startElement( "TestCase" )
+            .writeAttribute( "name", trim( testInfo.name ) )
+            .writeAttribute( "description", testInfo.description )
+            .writeAttribute( "tags", testInfo.tagsAsString() );
+
+        writeSourceInfo( testInfo.lineInfo );
+
+        if ( m_config->showDurations() == ShowDurations::Always )
+            m_testCaseTimer.start();
+        m_xml.ensureTagClosed();
+    }
+
+    void XmlReporter::sectionStarting( SectionInfo const& sectionInfo ) {
+        StreamingReporterBase::sectionStarting( sectionInfo );
+        if( m_sectionDepth++ > 0 ) {
+            m_xml.startElement( "Section" )
+                .writeAttribute( "name", trim( sectionInfo.name ) );
+            writeSourceInfo( sectionInfo.lineInfo );
+            m_xml.ensureTagClosed();
+        }
+    }
+
+    void XmlReporter::assertionStarting( AssertionInfo const& ) { }
+
+    bool XmlReporter::assertionEnded( AssertionStats const& assertionStats ) {
+
+        AssertionResult const& result = assertionStats.assertionResult;
+
+        bool includeResults = m_config->includeSuccessfulResults() || !result.isOk();
+
+        if( includeResults || result.getResultType() == ResultWas::Warning ) {
+            // Print any info messages in <Info> tags.
+            for( auto const& msg : assertionStats.infoMessages ) {
+                if( msg.type == ResultWas::Info && includeResults ) {
+                    m_xml.scopedElement( "Info" )
+                            .writeText( msg.message );
+                } else if ( msg.type == ResultWas::Warning ) {
+                    m_xml.scopedElement( "Warning" )
+                            .writeText( msg.message );
+                }
+            }
+        }
+
+        // Drop out if result was successful but we're not printing them.
+        if( !includeResults && result.getResultType() != ResultWas::Warning )
+            return true;
+
+        // Print the expression if there is one.
+        if( result.hasExpression() ) {
+            m_xml.startElement( "Expression" )
+                .writeAttribute( "success", result.succeeded() )
+                .writeAttribute( "type", result.getTestMacroName() );
+
+            writeSourceInfo( result.getSourceInfo() );
+
+            m_xml.scopedElement( "Original" )
+                .writeText( result.getExpression() );
+            m_xml.scopedElement( "Expanded" )
+                .writeText( result.getExpandedExpression() );
+        }
+
+        // And... Print a result applicable to each result type.
+        switch( result.getResultType() ) {
+            case ResultWas::ThrewException:
+                m_xml.startElement( "Exception" );
+                writeSourceInfo( result.getSourceInfo() );
+                m_xml.writeText( result.getMessage() );
+                m_xml.endElement();
+                break;
+            case ResultWas::FatalErrorCondition:
+                m_xml.startElement( "FatalErrorCondition" );
+                writeSourceInfo( result.getSourceInfo() );
+                m_xml.writeText( result.getMessage() );
+                m_xml.endElement();
+                break;
+            case ResultWas::Info:
+                m_xml.scopedElement( "Info" )
+                    .writeText( result.getMessage() );
+                break;
+            case ResultWas::Warning:
+                // Warning will already have been written
+                break;
+            case ResultWas::ExplicitFailure:
+                m_xml.startElement( "Failure" );
+                writeSourceInfo( result.getSourceInfo() );
+                m_xml.writeText( result.getMessage() );
+                m_xml.endElement();
+                break;
+            default:
+                break;
+        }
+
+        if( result.hasExpression() )
+            m_xml.endElement();
+
+        return true;
+    }
+
+    void XmlReporter::sectionEnded( SectionStats const& sectionStats ) {
+        StreamingReporterBase::sectionEnded( sectionStats );
+        if( --m_sectionDepth > 0 ) {
+            XmlWriter::ScopedElement e = m_xml.scopedElement( "OverallResults" );
+            e.writeAttribute( "successes", sectionStats.assertions.passed );
+            e.writeAttribute( "failures", sectionStats.assertions.failed );
+            e.writeAttribute( "expectedFailures", sectionStats.assertions.failedButOk );
+
+            if ( m_config->showDurations() == ShowDurations::Always )
+                e.writeAttribute( "durationInSeconds", sectionStats.durationInSeconds );
+
+            m_xml.endElement();
+        }
+    }
+
+    void XmlReporter::testCaseEnded( TestCaseStats const& testCaseStats ) {
+        StreamingReporterBase::testCaseEnded( testCaseStats );
+        XmlWriter::ScopedElement e = m_xml.scopedElement( "OverallResult" );
+        e.writeAttribute( "success", testCaseStats.totals.assertions.allOk() );
+
+        if ( m_config->showDurations() == ShowDurations::Always )
+            e.writeAttribute( "durationInSeconds", m_testCaseTimer.getElapsedSeconds() );
+
+        if( !testCaseStats.stdOut.empty() )
+            m_xml.scopedElement( "StdOut" ).writeText( trim( testCaseStats.stdOut ), XmlFormatting::Newline );
+        if( !testCaseStats.stdErr.empty() )
+            m_xml.scopedElement( "StdErr" ).writeText( trim( testCaseStats.stdErr ), XmlFormatting::Newline );
+
+        m_xml.endElement();
+    }
+
+    void XmlReporter::testGroupEnded( TestGroupStats const& testGroupStats ) {
+        StreamingReporterBase::testGroupEnded( testGroupStats );
+        // TODO: Check testGroupStats.aborting and act accordingly.
+        m_xml.scopedElement( "OverallResults" )
+            .writeAttribute( "successes", testGroupStats.totals.assertions.passed )
+            .writeAttribute( "failures", testGroupStats.totals.assertions.failed )
+            .writeAttribute( "expectedFailures", testGroupStats.totals.assertions.failedButOk );
+        m_xml.scopedElement( "OverallResultsCases")
+            .writeAttribute( "successes", testGroupStats.totals.testCases.passed )
+            .writeAttribute( "failures", testGroupStats.totals.testCases.failed )
+            .writeAttribute( "expectedFailures", testGroupStats.totals.testCases.failedButOk );
+        m_xml.endElement();
+    }
+
+    void XmlReporter::testRunEnded( TestRunStats const& testRunStats ) {
+        StreamingReporterBase::testRunEnded( testRunStats );
+        m_xml.scopedElement( "OverallResults" )
+            .writeAttribute( "successes", testRunStats.totals.assertions.passed )
+            .writeAttribute( "failures", testRunStats.totals.assertions.failed )
+            .writeAttribute( "expectedFailures", testRunStats.totals.assertions.failedButOk );
+        m_xml.scopedElement( "OverallResultsCases")
+            .writeAttribute( "successes", testRunStats.totals.testCases.passed )
+            .writeAttribute( "failures", testRunStats.totals.testCases.failed )
+            .writeAttribute( "expectedFailures", testRunStats.totals.testCases.failedButOk );
+        m_xml.endElement();
+    }
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+    void XmlReporter::benchmarkPreparing(std::string const& name) {
+        m_xml.startElement("BenchmarkResults")
+            .writeAttribute("name", name);
+    }
+
+    void XmlReporter::benchmarkStarting(BenchmarkInfo const &info) {
+        m_xml.writeAttribute("samples", info.samples)
+            .writeAttribute("resamples", info.resamples)
+            .writeAttribute("iterations", info.iterations)
+            .writeAttribute("clockResolution", info.clockResolution)
+            .writeAttribute("estimatedDuration", info.estimatedDuration)
+            .writeComment("All values in nano seconds");
+    }
+
+    void XmlReporter::benchmarkEnded(BenchmarkStats<> const& benchmarkStats) {
+        m_xml.startElement("mean")
+            .writeAttribute("value", benchmarkStats.mean.point.count())
+            .writeAttribute("lowerBound", benchmarkStats.mean.lower_bound.count())
+            .writeAttribute("upperBound", benchmarkStats.mean.upper_bound.count())
+            .writeAttribute("ci", benchmarkStats.mean.confidence_interval);
+        m_xml.endElement();
+        m_xml.startElement("standardDeviation")
+            .writeAttribute("value", benchmarkStats.standardDeviation.point.count())
+            .writeAttribute("lowerBound", benchmarkStats.standardDeviation.lower_bound.count())
+            .writeAttribute("upperBound", benchmarkStats.standardDeviation.upper_bound.count())
+            .writeAttribute("ci", benchmarkStats.standardDeviation.confidence_interval);
+        m_xml.endElement();
+        m_xml.startElement("outliers")
+            .writeAttribute("variance", benchmarkStats.outlierVariance)
+            .writeAttribute("lowMild", benchmarkStats.outliers.low_mild)
+            .writeAttribute("lowSevere", benchmarkStats.outliers.low_severe)
+            .writeAttribute("highMild", benchmarkStats.outliers.high_mild)
+            .writeAttribute("highSevere", benchmarkStats.outliers.high_severe);
+        m_xml.endElement();
+        m_xml.endElement();
+    }
+
+    void XmlReporter::benchmarkFailed(std::string const &error) {
+        m_xml.scopedElement("failed").
+            writeAttribute("message", error);
+        m_xml.endElement();
+    }
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+    CATCH_REGISTER_REPORTER( "xml", XmlReporter )
+
+} // end namespace Catch
+
+#if defined(_MSC_VER)
+#pragma warning(pop)
+#endif
+// end catch_reporter_xml.cpp
+
+namespace Catch {
+    LeakDetector leakDetector;
+}
+
+#ifdef __clang__
+#pragma clang diagnostic pop
+#endif
+
+// end catch_impl.hpp
+#endif
+
+#ifdef CATCH_CONFIG_MAIN
+// start catch_default_main.hpp
+
+#ifndef __OBJC__
+
+#if defined(CATCH_CONFIG_WCHAR) && defined(CATCH_PLATFORM_WINDOWS) && defined(_UNICODE) && !defined(DO_NOT_USE_WMAIN)
+// Standard C/C++ Win32 Unicode wmain entry point
+extern "C" int wmain (int argc, wchar_t * argv[], wchar_t * []) {
+#else
+// Standard C/C++ main entry point
+int main (int argc, char * argv[]) {
+#endif
+
+    return Catch::Session().run( argc, argv );
+}
+
+#else // __OBJC__
+
+// Objective-C entry point
+int main (int argc, char * const argv[]) {
+#if !CATCH_ARC_ENABLED
+    NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
+#endif
+
+    Catch::registerTestMethods();
+    int result = Catch::Session().run( argc, (char**)argv );
+
+#if !CATCH_ARC_ENABLED
+    [pool drain];
+#endif
+
+    return result;
+}
+
+#endif // __OBJC__
+
+// end catch_default_main.hpp
+#endif
+
+#if !defined(CATCH_CONFIG_IMPL_ONLY)
+
+#ifdef CLARA_CONFIG_MAIN_NOT_DEFINED
+#  undef CLARA_CONFIG_MAIN
+#endif
+
+#if !defined(CATCH_CONFIG_DISABLE)
+//////
+// If this config identifier is defined then all CATCH macros are prefixed with CATCH_
+#ifdef CATCH_CONFIG_PREFIX_ALL
+
+#define CATCH_REQUIRE( ... ) INTERNAL_CATCH_TEST( "CATCH_REQUIRE", Catch::ResultDisposition::Normal, __VA_ARGS__ )
+#define CATCH_REQUIRE_FALSE( ... ) INTERNAL_CATCH_TEST( "CATCH_REQUIRE_FALSE", Catch::ResultDisposition::Normal | Catch::ResultDisposition::FalseTest, __VA_ARGS__ )
+
+#define CATCH_REQUIRE_THROWS( ... ) INTERNAL_CATCH_THROWS( "CATCH_REQUIRE_THROWS", Catch::ResultDisposition::Normal, __VA_ARGS__ )
+#define CATCH_REQUIRE_THROWS_AS( expr, exceptionType ) INTERNAL_CATCH_THROWS_AS( "CATCH_REQUIRE_THROWS_AS", exceptionType, Catch::ResultDisposition::Normal, expr )
+#define CATCH_REQUIRE_THROWS_WITH( expr, matcher ) INTERNAL_CATCH_THROWS_STR_MATCHES( "CATCH_REQUIRE_THROWS_WITH", Catch::ResultDisposition::Normal, matcher, expr )
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CATCH_REQUIRE_THROWS_MATCHES( expr, exceptionType, matcher ) INTERNAL_CATCH_THROWS_MATCHES( "CATCH_REQUIRE_THROWS_MATCHES", exceptionType, Catch::ResultDisposition::Normal, matcher, expr )
+#endif// CATCH_CONFIG_DISABLE_MATCHERS
+#define CATCH_REQUIRE_NOTHROW( ... ) INTERNAL_CATCH_NO_THROW( "CATCH_REQUIRE_NOTHROW", Catch::ResultDisposition::Normal, __VA_ARGS__ )
+
+#define CATCH_CHECK( ... ) INTERNAL_CATCH_TEST( "CATCH_CHECK", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define CATCH_CHECK_FALSE( ... ) INTERNAL_CATCH_TEST( "CATCH_CHECK_FALSE", Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::FalseTest, __VA_ARGS__ )
+#define CATCH_CHECKED_IF( ... ) INTERNAL_CATCH_IF( "CATCH_CHECKED_IF", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define CATCH_CHECKED_ELSE( ... ) INTERNAL_CATCH_ELSE( "CATCH_CHECKED_ELSE", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define CATCH_CHECK_NOFAIL( ... ) INTERNAL_CATCH_TEST( "CATCH_CHECK_NOFAIL", Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::SuppressFail, __VA_ARGS__ )
+
+#define CATCH_CHECK_THROWS( ... )  INTERNAL_CATCH_THROWS( "CATCH_CHECK_THROWS", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define CATCH_CHECK_THROWS_AS( expr, exceptionType ) INTERNAL_CATCH_THROWS_AS( "CATCH_CHECK_THROWS_AS", exceptionType, Catch::ResultDisposition::ContinueOnFailure, expr )
+#define CATCH_CHECK_THROWS_WITH( expr, matcher ) INTERNAL_CATCH_THROWS_STR_MATCHES( "CATCH_CHECK_THROWS_WITH", Catch::ResultDisposition::ContinueOnFailure, matcher, expr )
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CATCH_CHECK_THROWS_MATCHES( expr, exceptionType, matcher ) INTERNAL_CATCH_THROWS_MATCHES( "CATCH_CHECK_THROWS_MATCHES", exceptionType, Catch::ResultDisposition::ContinueOnFailure, matcher, expr )
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+#define CATCH_CHECK_NOTHROW( ... ) INTERNAL_CATCH_NO_THROW( "CATCH_CHECK_NOTHROW", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CATCH_CHECK_THAT( arg, matcher ) INTERNAL_CHECK_THAT( "CATCH_CHECK_THAT", matcher, Catch::ResultDisposition::ContinueOnFailure, arg )
+
+#define CATCH_REQUIRE_THAT( arg, matcher ) INTERNAL_CHECK_THAT( "CATCH_REQUIRE_THAT", matcher, Catch::ResultDisposition::Normal, arg )
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+
+#define CATCH_INFO( msg ) INTERNAL_CATCH_INFO( "CATCH_INFO", msg )
+#define CATCH_UNSCOPED_INFO( msg ) INTERNAL_CATCH_UNSCOPED_INFO( "CATCH_UNSCOPED_INFO", msg )
+#define CATCH_WARN( msg ) INTERNAL_CATCH_MSG( "CATCH_WARN", Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, msg )
+#define CATCH_CAPTURE( ... ) INTERNAL_CATCH_CAPTURE( INTERNAL_CATCH_UNIQUE_NAME(capturer), "CATCH_CAPTURE",__VA_ARGS__ )
+
+#define CATCH_TEST_CASE( ... ) INTERNAL_CATCH_TESTCASE( __VA_ARGS__ )
+#define CATCH_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define CATCH_METHOD_AS_TEST_CASE( method, ... ) INTERNAL_CATCH_METHOD_AS_TEST_CASE( method, __VA_ARGS__ )
+#define CATCH_REGISTER_TEST_CASE( Function, ... ) INTERNAL_CATCH_REGISTER_TESTCASE( Function, __VA_ARGS__ )
+#define CATCH_SECTION( ... ) INTERNAL_CATCH_SECTION( __VA_ARGS__ )
+#define CATCH_DYNAMIC_SECTION( ... ) INTERNAL_CATCH_DYNAMIC_SECTION( __VA_ARGS__ )
+#define CATCH_FAIL( ... ) INTERNAL_CATCH_MSG( "CATCH_FAIL", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, __VA_ARGS__ )
+#define CATCH_FAIL_CHECK( ... ) INTERNAL_CATCH_MSG( "CATCH_FAIL_CHECK", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define CATCH_SUCCEED( ... ) INTERNAL_CATCH_MSG( "CATCH_SUCCEED", Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+
+#define CATCH_ANON_TEST_CASE() INTERNAL_CATCH_TESTCASE()
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#define CATCH_TEMPLATE_TEST_CASE( ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define CATCH_TEMPLATE_TEST_CASE_SIG( ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG( __VA_ARGS__ )
+#define CATCH_TEMPLATE_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( className, __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE( ... ) INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE( __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG( ... ) INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG( __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, __VA_ARGS__ )
+#else
+#define CATCH_TEMPLATE_TEST_CASE( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE( __VA_ARGS__ ) )
+#define CATCH_TEMPLATE_TEST_CASE_SIG( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG( __VA_ARGS__ ) )
+#define CATCH_TEMPLATE_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ ) )
+#define CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( className, __VA_ARGS__ ) )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE( __VA_ARGS__ ) )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG( __VA_ARGS__ ) )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, __VA_ARGS__ ) )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, __VA_ARGS__ ) )
+#endif
+
+#if !defined(CATCH_CONFIG_RUNTIME_STATIC_REQUIRE)
+#define CATCH_STATIC_REQUIRE( ... )       static_assert(   __VA_ARGS__ ,      #__VA_ARGS__ );     CATCH_SUCCEED( #__VA_ARGS__ )
+#define CATCH_STATIC_REQUIRE_FALSE( ... ) static_assert( !(__VA_ARGS__), "!(" #__VA_ARGS__ ")" ); CATCH_SUCCEED( #__VA_ARGS__ )
+#else
+#define CATCH_STATIC_REQUIRE( ... )       CATCH_REQUIRE( __VA_ARGS__ )
+#define CATCH_STATIC_REQUIRE_FALSE( ... ) CATCH_REQUIRE_FALSE( __VA_ARGS__ )
+#endif
+
+// "BDD-style" convenience wrappers
+#define CATCH_SCENARIO( ... ) CATCH_TEST_CASE( "Scenario: " __VA_ARGS__ )
+#define CATCH_SCENARIO_METHOD( className, ... ) INTERNAL_CATCH_TEST_CASE_METHOD( className, "Scenario: " __VA_ARGS__ )
+#define CATCH_GIVEN( desc )     INTERNAL_CATCH_DYNAMIC_SECTION( "    Given: " << desc )
+#define CATCH_AND_GIVEN( desc ) INTERNAL_CATCH_DYNAMIC_SECTION( "And given: " << desc )
+#define CATCH_WHEN( desc )      INTERNAL_CATCH_DYNAMIC_SECTION( "     When: " << desc )
+#define CATCH_AND_WHEN( desc )  INTERNAL_CATCH_DYNAMIC_SECTION( " And when: " << desc )
+#define CATCH_THEN( desc )      INTERNAL_CATCH_DYNAMIC_SECTION( "     Then: " << desc )
+#define CATCH_AND_THEN( desc )  INTERNAL_CATCH_DYNAMIC_SECTION( "      And: " << desc )
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+#define CATCH_BENCHMARK(...) \
+    INTERNAL_CATCH_BENCHMARK(INTERNAL_CATCH_UNIQUE_NAME(C_A_T_C_H_B_E_N_C_H_), INTERNAL_CATCH_GET_1_ARG(__VA_ARGS__,,), INTERNAL_CATCH_GET_2_ARG(__VA_ARGS__,,))
+#define CATCH_BENCHMARK_ADVANCED(name) \
+    INTERNAL_CATCH_BENCHMARK_ADVANCED(INTERNAL_CATCH_UNIQUE_NAME(C_A_T_C_H_B_E_N_C_H_), name)
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+// If CATCH_CONFIG_PREFIX_ALL is not defined then the CATCH_ prefix is not required
+#else
+
+#define REQUIRE( ... ) INTERNAL_CATCH_TEST( "REQUIRE", Catch::ResultDisposition::Normal, __VA_ARGS__  )
+#define REQUIRE_FALSE( ... ) INTERNAL_CATCH_TEST( "REQUIRE_FALSE", Catch::ResultDisposition::Normal | Catch::ResultDisposition::FalseTest, __VA_ARGS__ )
+
+#define REQUIRE_THROWS( ... ) INTERNAL_CATCH_THROWS( "REQUIRE_THROWS", Catch::ResultDisposition::Normal, __VA_ARGS__ )
+#define REQUIRE_THROWS_AS( expr, exceptionType ) INTERNAL_CATCH_THROWS_AS( "REQUIRE_THROWS_AS", exceptionType, Catch::ResultDisposition::Normal, expr )
+#define REQUIRE_THROWS_WITH( expr, matcher ) INTERNAL_CATCH_THROWS_STR_MATCHES( "REQUIRE_THROWS_WITH", Catch::ResultDisposition::Normal, matcher, expr )
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define REQUIRE_THROWS_MATCHES( expr, exceptionType, matcher ) INTERNAL_CATCH_THROWS_MATCHES( "REQUIRE_THROWS_MATCHES", exceptionType, Catch::ResultDisposition::Normal, matcher, expr )
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+#define REQUIRE_NOTHROW( ... ) INTERNAL_CATCH_NO_THROW( "REQUIRE_NOTHROW", Catch::ResultDisposition::Normal, __VA_ARGS__ )
+
+#define CHECK( ... ) INTERNAL_CATCH_TEST( "CHECK", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define CHECK_FALSE( ... ) INTERNAL_CATCH_TEST( "CHECK_FALSE", Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::FalseTest, __VA_ARGS__ )
+#define CHECKED_IF( ... ) INTERNAL_CATCH_IF( "CHECKED_IF", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define CHECKED_ELSE( ... ) INTERNAL_CATCH_ELSE( "CHECKED_ELSE", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define CHECK_NOFAIL( ... ) INTERNAL_CATCH_TEST( "CHECK_NOFAIL", Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::SuppressFail, __VA_ARGS__ )
+
+#define CHECK_THROWS( ... )  INTERNAL_CATCH_THROWS( "CHECK_THROWS", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define CHECK_THROWS_AS( expr, exceptionType ) INTERNAL_CATCH_THROWS_AS( "CHECK_THROWS_AS", exceptionType, Catch::ResultDisposition::ContinueOnFailure, expr )
+#define CHECK_THROWS_WITH( expr, matcher ) INTERNAL_CATCH_THROWS_STR_MATCHES( "CHECK_THROWS_WITH", Catch::ResultDisposition::ContinueOnFailure, matcher, expr )
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CHECK_THROWS_MATCHES( expr, exceptionType, matcher ) INTERNAL_CATCH_THROWS_MATCHES( "CHECK_THROWS_MATCHES", exceptionType, Catch::ResultDisposition::ContinueOnFailure, matcher, expr )
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+#define CHECK_NOTHROW( ... ) INTERNAL_CATCH_NO_THROW( "CHECK_NOTHROW", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CHECK_THAT( arg, matcher ) INTERNAL_CHECK_THAT( "CHECK_THAT", matcher, Catch::ResultDisposition::ContinueOnFailure, arg )
+
+#define REQUIRE_THAT( arg, matcher ) INTERNAL_CHECK_THAT( "REQUIRE_THAT", matcher, Catch::ResultDisposition::Normal, arg )
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+
+#define INFO( msg ) INTERNAL_CATCH_INFO( "INFO", msg )
+#define UNSCOPED_INFO( msg ) INTERNAL_CATCH_UNSCOPED_INFO( "UNSCOPED_INFO", msg )
+#define WARN( msg ) INTERNAL_CATCH_MSG( "WARN", Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, msg )
+#define CAPTURE( ... ) INTERNAL_CATCH_CAPTURE( INTERNAL_CATCH_UNIQUE_NAME(capturer), "CAPTURE",__VA_ARGS__ )
+
+#define TEST_CASE( ... ) INTERNAL_CATCH_TESTCASE( __VA_ARGS__ )
+#define TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define METHOD_AS_TEST_CASE( method, ... ) INTERNAL_CATCH_METHOD_AS_TEST_CASE( method, __VA_ARGS__ )
+#define REGISTER_TEST_CASE( Function, ... ) INTERNAL_CATCH_REGISTER_TESTCASE( Function, __VA_ARGS__ )
+#define SECTION( ... ) INTERNAL_CATCH_SECTION( __VA_ARGS__ )
+#define DYNAMIC_SECTION( ... ) INTERNAL_CATCH_DYNAMIC_SECTION( __VA_ARGS__ )
+#define FAIL( ... ) INTERNAL_CATCH_MSG( "FAIL", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, __VA_ARGS__ )
+#define FAIL_CHECK( ... ) INTERNAL_CATCH_MSG( "FAIL_CHECK", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define SUCCEED( ... ) INTERNAL_CATCH_MSG( "SUCCEED", Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
+#define ANON_TEST_CASE() INTERNAL_CATCH_TESTCASE()
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#define TEMPLATE_TEST_CASE( ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define TEMPLATE_TEST_CASE_SIG( ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG( __VA_ARGS__ )
+#define TEMPLATE_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define TEMPLATE_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( className, __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE( ... ) INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE( __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE_SIG( ... ) INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG( __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, __VA_ARGS__ )
+#define TEMPLATE_LIST_TEST_CASE( ... ) INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE(__VA_ARGS__)
+#define TEMPLATE_LIST_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#else
+#define TEMPLATE_TEST_CASE( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE( __VA_ARGS__ ) )
+#define TEMPLATE_TEST_CASE_SIG( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG( __VA_ARGS__ ) )
+#define TEMPLATE_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ ) )
+#define TEMPLATE_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( className, __VA_ARGS__ ) )
+#define TEMPLATE_PRODUCT_TEST_CASE( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE( __VA_ARGS__ ) )
+#define TEMPLATE_PRODUCT_TEST_CASE_SIG( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG( __VA_ARGS__ ) )
+#define TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, __VA_ARGS__ ) )
+#define TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, __VA_ARGS__ ) )
+#define TEMPLATE_LIST_TEST_CASE( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE( __VA_ARGS__ ) )
+#define TEMPLATE_LIST_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_LIST_TEST_CASE_METHOD( className, __VA_ARGS__ ) )
+#endif
+
+#if !defined(CATCH_CONFIG_RUNTIME_STATIC_REQUIRE)
+#define STATIC_REQUIRE( ... )       static_assert(   __VA_ARGS__,  #__VA_ARGS__ ); SUCCEED( #__VA_ARGS__ )
+#define STATIC_REQUIRE_FALSE( ... ) static_assert( !(__VA_ARGS__), "!(" #__VA_ARGS__ ")" ); SUCCEED( "!(" #__VA_ARGS__ ")" )
+#else
+#define STATIC_REQUIRE( ... )       REQUIRE( __VA_ARGS__ )
+#define STATIC_REQUIRE_FALSE( ... ) REQUIRE_FALSE( __VA_ARGS__ )
+#endif
+
+#endif
+
+#define CATCH_TRANSLATE_EXCEPTION( signature ) INTERNAL_CATCH_TRANSLATE_EXCEPTION( signature )
+
+// "BDD-style" convenience wrappers
+#define SCENARIO( ... ) TEST_CASE( "Scenario: " __VA_ARGS__ )
+#define SCENARIO_METHOD( className, ... ) INTERNAL_CATCH_TEST_CASE_METHOD( className, "Scenario: " __VA_ARGS__ )
+
+#define GIVEN( desc )     INTERNAL_CATCH_DYNAMIC_SECTION( "    Given: " << desc )
+#define AND_GIVEN( desc ) INTERNAL_CATCH_DYNAMIC_SECTION( "And given: " << desc )
+#define WHEN( desc )      INTERNAL_CATCH_DYNAMIC_SECTION( "     When: " << desc )
+#define AND_WHEN( desc )  INTERNAL_CATCH_DYNAMIC_SECTION( " And when: " << desc )
+#define THEN( desc )      INTERNAL_CATCH_DYNAMIC_SECTION( "     Then: " << desc )
+#define AND_THEN( desc )  INTERNAL_CATCH_DYNAMIC_SECTION( "      And: " << desc )
+
+#if defined(CATCH_CONFIG_ENABLE_BENCHMARKING)
+#define BENCHMARK(...) \
+    INTERNAL_CATCH_BENCHMARK(INTERNAL_CATCH_UNIQUE_NAME(C_A_T_C_H_B_E_N_C_H_), INTERNAL_CATCH_GET_1_ARG(__VA_ARGS__,,), INTERNAL_CATCH_GET_2_ARG(__VA_ARGS__,,))
+#define BENCHMARK_ADVANCED(name) \
+    INTERNAL_CATCH_BENCHMARK_ADVANCED(INTERNAL_CATCH_UNIQUE_NAME(C_A_T_C_H_B_E_N_C_H_), name)
+#endif // CATCH_CONFIG_ENABLE_BENCHMARKING
+
+using Catch::Detail::Approx;
+
+#else // CATCH_CONFIG_DISABLE
+
+//////
+// If this config identifier is defined then all CATCH macros are prefixed with CATCH_
+#ifdef CATCH_CONFIG_PREFIX_ALL
+
+#define CATCH_REQUIRE( ... )        (void)(0)
+#define CATCH_REQUIRE_FALSE( ... )  (void)(0)
+
+#define CATCH_REQUIRE_THROWS( ... ) (void)(0)
+#define CATCH_REQUIRE_THROWS_AS( expr, exceptionType ) (void)(0)
+#define CATCH_REQUIRE_THROWS_WITH( expr, matcher )     (void)(0)
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CATCH_REQUIRE_THROWS_MATCHES( expr, exceptionType, matcher ) (void)(0)
+#endif// CATCH_CONFIG_DISABLE_MATCHERS
+#define CATCH_REQUIRE_NOTHROW( ... ) (void)(0)
+
+#define CATCH_CHECK( ... )         (void)(0)
+#define CATCH_CHECK_FALSE( ... )   (void)(0)
+#define CATCH_CHECKED_IF( ... )    if (__VA_ARGS__)
+#define CATCH_CHECKED_ELSE( ... )  if (!(__VA_ARGS__))
+#define CATCH_CHECK_NOFAIL( ... )  (void)(0)
+
+#define CATCH_CHECK_THROWS( ... )  (void)(0)
+#define CATCH_CHECK_THROWS_AS( expr, exceptionType ) (void)(0)
+#define CATCH_CHECK_THROWS_WITH( expr, matcher )     (void)(0)
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CATCH_CHECK_THROWS_MATCHES( expr, exceptionType, matcher ) (void)(0)
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+#define CATCH_CHECK_NOTHROW( ... ) (void)(0)
+
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CATCH_CHECK_THAT( arg, matcher )   (void)(0)
+
+#define CATCH_REQUIRE_THAT( arg, matcher ) (void)(0)
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+
+#define CATCH_INFO( msg )          (void)(0)
+#define CATCH_UNSCOPED_INFO( msg ) (void)(0)
+#define CATCH_WARN( msg )          (void)(0)
+#define CATCH_CAPTURE( msg )       (void)(0)
+
+#define CATCH_TEST_CASE( ... ) INTERNAL_CATCH_TESTCASE_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ))
+#define CATCH_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TESTCASE_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ))
+#define CATCH_METHOD_AS_TEST_CASE( method, ... )
+#define CATCH_REGISTER_TEST_CASE( Function, ... ) (void)(0)
+#define CATCH_SECTION( ... )
+#define CATCH_DYNAMIC_SECTION( ... )
+#define CATCH_FAIL( ... ) (void)(0)
+#define CATCH_FAIL_CHECK( ... ) (void)(0)
+#define CATCH_SUCCEED( ... ) (void)(0)
+
+#define CATCH_ANON_TEST_CASE() INTERNAL_CATCH_TESTCASE_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ))
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#define CATCH_TEMPLATE_TEST_CASE( ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION(__VA_ARGS__)
+#define CATCH_TEMPLATE_TEST_CASE_SIG( ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG_NO_REGISTRATION(__VA_ARGS__)
+#define CATCH_TEMPLATE_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION(className, __VA_ARGS__)
+#define CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG_NO_REGISTRATION(className, __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE( ... ) CATCH_TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG( ... ) CATCH_TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, ... ) CATCH_TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, ... ) CATCH_TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#else
+#define CATCH_TEMPLATE_TEST_CASE( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION(__VA_ARGS__) )
+#define CATCH_TEMPLATE_TEST_CASE_SIG( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG_NO_REGISTRATION(__VA_ARGS__) )
+#define CATCH_TEMPLATE_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION(className, __VA_ARGS__ ) )
+#define CATCH_TEMPLATE_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG_NO_REGISTRATION(className, __VA_ARGS__ ) )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE( ... ) CATCH_TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_SIG( ... ) CATCH_TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, ... ) CATCH_TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, ... ) CATCH_TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#endif
+
+// "BDD-style" convenience wrappers
+#define CATCH_SCENARIO( ... ) INTERNAL_CATCH_TESTCASE_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ))
+#define CATCH_SCENARIO_METHOD( className, ... ) INTERNAL_CATCH_TESTCASE_METHOD_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ), className )
+#define CATCH_GIVEN( desc )
+#define CATCH_AND_GIVEN( desc )
+#define CATCH_WHEN( desc )
+#define CATCH_AND_WHEN( desc )
+#define CATCH_THEN( desc )
+#define CATCH_AND_THEN( desc )
+
+#define CATCH_STATIC_REQUIRE( ... )       (void)(0)
+#define CATCH_STATIC_REQUIRE_FALSE( ... ) (void)(0)
+
+// If CATCH_CONFIG_PREFIX_ALL is not defined then the CATCH_ prefix is not required
+#else
+
+#define REQUIRE( ... )       (void)(0)
+#define REQUIRE_FALSE( ... ) (void)(0)
+
+#define REQUIRE_THROWS( ... ) (void)(0)
+#define REQUIRE_THROWS_AS( expr, exceptionType ) (void)(0)
+#define REQUIRE_THROWS_WITH( expr, matcher ) (void)(0)
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define REQUIRE_THROWS_MATCHES( expr, exceptionType, matcher ) (void)(0)
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+#define REQUIRE_NOTHROW( ... ) (void)(0)
+
+#define CHECK( ... ) (void)(0)
+#define CHECK_FALSE( ... ) (void)(0)
+#define CHECKED_IF( ... ) if (__VA_ARGS__)
+#define CHECKED_ELSE( ... ) if (!(__VA_ARGS__))
+#define CHECK_NOFAIL( ... ) (void)(0)
+
+#define CHECK_THROWS( ... )  (void)(0)
+#define CHECK_THROWS_AS( expr, exceptionType ) (void)(0)
+#define CHECK_THROWS_WITH( expr, matcher ) (void)(0)
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CHECK_THROWS_MATCHES( expr, exceptionType, matcher ) (void)(0)
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+#define CHECK_NOTHROW( ... ) (void)(0)
+
+#if !defined(CATCH_CONFIG_DISABLE_MATCHERS)
+#define CHECK_THAT( arg, matcher ) (void)(0)
+
+#define REQUIRE_THAT( arg, matcher ) (void)(0)
+#endif // CATCH_CONFIG_DISABLE_MATCHERS
+
+#define INFO( msg ) (void)(0)
+#define UNSCOPED_INFO( msg ) (void)(0)
+#define WARN( msg ) (void)(0)
+#define CAPTURE( ... ) (void)(0)
+
+#define TEST_CASE( ... )  INTERNAL_CATCH_TESTCASE_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ))
+#define TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TESTCASE_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ))
+#define METHOD_AS_TEST_CASE( method, ... )
+#define REGISTER_TEST_CASE( Function, ... ) (void)(0)
+#define SECTION( ... )
+#define DYNAMIC_SECTION( ... )
+#define FAIL( ... ) (void)(0)
+#define FAIL_CHECK( ... ) (void)(0)
+#define SUCCEED( ... ) (void)(0)
+#define ANON_TEST_CASE() INTERNAL_CATCH_TESTCASE_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ))
+
+#ifndef CATCH_CONFIG_TRADITIONAL_MSVC_PREPROCESSOR
+#define TEMPLATE_TEST_CASE( ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION(__VA_ARGS__)
+#define TEMPLATE_TEST_CASE_SIG( ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG_NO_REGISTRATION(__VA_ARGS__)
+#define TEMPLATE_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION(className, __VA_ARGS__)
+#define TEMPLATE_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG_NO_REGISTRATION(className, __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE( ... ) TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE_SIG( ... ) TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, ... ) TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, ... ) TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#else
+#define TEMPLATE_TEST_CASE( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_NO_REGISTRATION(__VA_ARGS__) )
+#define TEMPLATE_TEST_CASE_SIG( ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_SIG_NO_REGISTRATION(__VA_ARGS__) )
+#define TEMPLATE_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_NO_REGISTRATION(className, __VA_ARGS__ ) )
+#define TEMPLATE_TEST_CASE_METHOD_SIG( className, ... ) INTERNAL_CATCH_EXPAND_VARGS( INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD_SIG_NO_REGISTRATION(className, __VA_ARGS__ ) )
+#define TEMPLATE_PRODUCT_TEST_CASE( ... ) TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE_SIG( ... ) TEMPLATE_TEST_CASE( __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, ... ) TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#define TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG( className, ... ) TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )
+#endif
+
+#define STATIC_REQUIRE( ... )       (void)(0)
+#define STATIC_REQUIRE_FALSE( ... ) (void)(0)
+
+#endif
+
+#define CATCH_TRANSLATE_EXCEPTION( signature ) INTERNAL_CATCH_TRANSLATE_EXCEPTION_NO_REG( INTERNAL_CATCH_UNIQUE_NAME( catch_internal_ExceptionTranslator ), signature )
+
+// "BDD-style" convenience wrappers
+#define SCENARIO( ... ) INTERNAL_CATCH_TESTCASE_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ) )
+#define SCENARIO_METHOD( className, ... ) INTERNAL_CATCH_TESTCASE_METHOD_NO_REGISTRATION(INTERNAL_CATCH_UNIQUE_NAME( C_A_T_C_H_T_E_S_T_ ), className )
+
+#define GIVEN( desc )
+#define AND_GIVEN( desc )
+#define WHEN( desc )
+#define AND_WHEN( desc )
+#define THEN( desc )
+#define AND_THEN( desc )
+
+using Catch::Detail::Approx;
+
+#endif
+
+#endif // ! CATCH_CONFIG_IMPL_ONLY
+
+// start catch_reenable_warnings.h
+
+
+#ifdef __clang__
+#    ifdef __ICC // icpc defines the __clang__ macro
+#        pragma warning(pop)
+#    else
+#        pragma clang diagnostic pop
+#    endif
+#elif defined __GNUC__
+#    pragma GCC diagnostic pop
+#endif
+
+// end catch_reenable_warnings.h
+// end catch.hpp
+#endif // TWOBLUECUBES_SINGLE_INCLUDE_CATCH_HPP_INCLUDED
diff --git a/tests/exampleCheckNumbers.cpp b/tests/exampleCheckNumbers.cpp
new file mode 100644
index 00000000..cfe7c0b4
--- /dev/null
+++ b/tests/exampleCheckNumbers.cpp
@@ -0,0 +1,13 @@
+#include "../catch2/catch.hpp"
+
+int Factorial( int number ) {
+    return number <= 1 ? number : Factorial( number - 1 ) * number;  // fail
+    // return number <= 1 ? 1      : Factorial( number - 1 ) * number;  // pass
+}
+
+TEST_CASE( "2: Factorials of 1 and higher are computed (pass)", "[multi-file:2]" ) {
+    REQUIRE( Factorial(1) == 1 );
+    REQUIRE( Factorial(2) == 2 );
+    REQUIRE( Factorial(3) == 6 );
+    REQUIRE( Factorial(10) == 3628800 );
+}
\ No newline at end of file

From 62e9ff314fb49df6666d0249e9f56a17ff13cf1b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Tue, 27 Sep 2022 15:01:07 +0000
Subject: [PATCH 072/549] project compiles on linu, tests run on compiled
 project

---
 .github/workflows/platformless.yml |   6 ++---
 .github/workflows/tests.yml        |  23 +++++++++++++------
 output                             | Bin 0 -> 4615232 bytes
 src/patch.cpp                      |   5 +----
 tests/000-unitTestsMain.cpp        |   5 +++--
 tests/exampleCheckNumbers.cpp      |  13 -----------
 tests/initializeDeinitialize.cpp   |  35 +++++++++++++++++++++++++++++
 tests/initializeDeinitialize.h     |   6 +++++
 8 files changed, 64 insertions(+), 29 deletions(-)
 create mode 100755 output
 delete mode 100644 tests/exampleCheckNumbers.cpp
 create mode 100644 tests/initializeDeinitialize.cpp
 create mode 100644 tests/initializeDeinitialize.h

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 83f266c9..988a5c25 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -3,11 +3,11 @@ name: Platform independent compilation
 on:
   push:
     branches:
-      - feature/freertos
+      - disabled
 
 jobs:
 
-  compile-tests:
+  compile-platform:
     name: Compile
     runs-on: ubuntu-latest
     steps:
@@ -23,4 +23,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -std=c++14 -I ./src -g $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output.exe -Wall
+      run: g++ -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index d14d3fe9..4ffe8ad1 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -1,19 +1,28 @@
-name: Unit tests
+name: Platform independent tests
 
 on:
   push:
     branches:
-      - test-integration-disabled
+      - feature/freertos
 
 jobs:
 
-  compile-tests:
-    name: Compile Tests
+  compile-and-run:
+    name: Compile
     runs-on: ubuntu-latest
     steps:
     - name: Check out repository code
       uses: actions/checkout@v3
-    - name: Compile tests
-      run: g++ -Wall test/unitTests/000-unitTestsMain.cpp -o test/compiledTests
+    - name: get gcc compiler
+      run: |
+        sudo apt update
+        sudo apt install build-essential
+        sudo apt -y install gcc-9 g++-9
+        g++ --version
+        echo "g++ version must be 9.4.0"
+    - name: Get ArduinoJson
+      run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
+    - name: Compile
+      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall
     - name: Run tests
-      run: ./test/compiledTests
\ No newline at end of file
+      run: ./output
diff --git a/output b/output
new file mode 100755
index 0000000000000000000000000000000000000000..34ec6976cffe26fec5791b42b54f6be4b1f465f7
GIT binary patch
literal 4615232
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%0DEn*>G^)9*_Q{wU^32^och
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%0ALvC*rsUKxsx%NxI{8*Rdha+?#-S
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%0Dv!$SC9lg%5~fN!6}7UICWfFA*u`2yAb
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%0DgrkQ!-aIsq6
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%0D0l7X`QkRqcGm0ymOX1M6oZT;a}Af8+)}|w*v?NT
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

literal 0
HcmV?d00001

diff --git a/src/patch.cpp b/src/patch.cpp
index 2f87613c..6dc0ca4d 100644
--- a/src/patch.cpp
+++ b/src/patch.cpp
@@ -1,9 +1,6 @@
 #include <ArduinoOcpp/Platform.h>
 
 unsigned long ao_tick_ms_impl() {
-    return 0;
+    return 10000;
 }
 
-int main() {
-    return 0;
-}
diff --git a/tests/000-unitTestsMain.cpp b/tests/000-unitTestsMain.cpp
index 71a6c970..ecd97afd 100644
--- a/tests/000-unitTestsMain.cpp
+++ b/tests/000-unitTestsMain.cpp
@@ -6,7 +6,8 @@
 //use the main function provided by catch2
 #define CATCH_CONFIG_MAIN
 //include the catch2 library
-#include "../catch2/catch.hpp"
+#include "./catch2/catch.hpp"
 
 //include the unit tests
-#include "./exampleCheckNumbers.cpp"
\ No newline at end of file
+//#include "./exampleCheckNumbers.cpp"
+#include "./initializeDeinitialize.h"
\ No newline at end of file
diff --git a/tests/exampleCheckNumbers.cpp b/tests/exampleCheckNumbers.cpp
deleted file mode 100644
index cfe7c0b4..00000000
--- a/tests/exampleCheckNumbers.cpp
+++ /dev/null
@@ -1,13 +0,0 @@
-#include "../catch2/catch.hpp"
-
-int Factorial( int number ) {
-    return number <= 1 ? number : Factorial( number - 1 ) * number;  // fail
-    // return number <= 1 ? 1      : Factorial( number - 1 ) * number;  // pass
-}
-
-TEST_CASE( "2: Factorials of 1 and higher are computed (pass)", "[multi-file:2]" ) {
-    REQUIRE( Factorial(1) == 1 );
-    REQUIRE( Factorial(2) == 2 );
-    REQUIRE( Factorial(3) == 6 );
-    REQUIRE( Factorial(10) == 3628800 );
-}
\ No newline at end of file
diff --git a/tests/initializeDeinitialize.cpp b/tests/initializeDeinitialize.cpp
new file mode 100644
index 00000000..0a6d344e
--- /dev/null
+++ b/tests/initializeDeinitialize.cpp
@@ -0,0 +1,35 @@
+#include <iostream>
+#include <ArduinoOcpp.h>
+#include <ArduinoOcpp/Platform.h>
+#include <ArduinoOcpp/Core/OcppSocket.h>
+#include "./catch2/catch.hpp"
+
+void cpp_console_out(const char *msg) {
+    std::cout << msg;
+}
+
+TEST_CASE( "Do some loops", "[multi-file:2]" ) {
+
+    ArduinoOcpp::OcppEchoSocket echoSocket;
+
+    std::cout << "[main] Enter compilation test\n";
+
+    std::cout << "[main] set custom console\n";
+    ao_set_console_out(cpp_console_out);
+    
+    OCPP_initialize(echoSocket);
+    std::cout << "[main] AO initialized\n---------------------\n";
+    
+    std::cout << "[main] enqueue first operation\n";
+    bootNotification("Test charger", "Test vendor");
+    
+    std::cout << "[main] handle WebSocket traffic and run OCPP tasks\n"; 
+    OCPP_loop();
+    OCPP_loop();
+    OCPP_loop();
+
+    std::cout << "-------------------------\n[main] test routines done\n";
+    OCPP_deinitialize();
+
+    std::cout << "[main] exit\n";
+}
\ No newline at end of file
diff --git a/tests/initializeDeinitialize.h b/tests/initializeDeinitialize.h
new file mode 100644
index 00000000..73678f52
--- /dev/null
+++ b/tests/initializeDeinitialize.h
@@ -0,0 +1,6 @@
+#ifndef CPP_CONSOLE_OUT
+#define CPP_CONSOLE_OUT
+
+void cpp_console_out(const char *msg);    
+
+#endif
\ No newline at end of file

From a5d438c7183b2d5338291c415ebf1805a5c16bb5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Wed, 28 Sep 2022 09:39:18 +0000
Subject: [PATCH 073/549] file restructuring

---
 tests/000-testsMain.cpp                             | 13 +++++++++++++
 tests/{initializeDeinitialize.h => 000-testsMain.h} |  0
 tests/000-unitTestsMain.cpp                         | 13 -------------
 .../{initializeDeinitialize.cpp => initialize.cpp}  |  5 +----
 4 files changed, 14 insertions(+), 17 deletions(-)
 create mode 100644 tests/000-testsMain.cpp
 rename tests/{initializeDeinitialize.h => 000-testsMain.h} (100%)
 delete mode 100644 tests/000-unitTestsMain.cpp
 rename tests/{initializeDeinitialize.cpp => initialize.cpp} (93%)

diff --git a/tests/000-testsMain.cpp b/tests/000-testsMain.cpp
new file mode 100644
index 00000000..836dba68
--- /dev/null
+++ b/tests/000-testsMain.cpp
@@ -0,0 +1,13 @@
+//000- prefix is for the main-file to always be on top in folder view
+#include "./000-testsMain.h"
+//use the main function provided by catch2
+#define CATCH_CONFIG_MAIN
+//include the catch2 library
+#include "./catch2/catch.hpp"
+
+void cpp_console_out(const char *msg) {
+    std::cout << msg;
+}
+
+//include the tests
+#include "./initializeDeinitialize.h"
\ No newline at end of file
diff --git a/tests/initializeDeinitialize.h b/tests/000-testsMain.h
similarity index 100%
rename from tests/initializeDeinitialize.h
rename to tests/000-testsMain.h
diff --git a/tests/000-unitTestsMain.cpp b/tests/000-unitTestsMain.cpp
deleted file mode 100644
index ecd97afd..00000000
--- a/tests/000-unitTestsMain.cpp
+++ /dev/null
@@ -1,13 +0,0 @@
-//000- prefix is for the main-file to always be on top in folder view
-
-// Powershell to compile tests and run them:
-// g++ -Wall test/unitTests/000-unitTestsMain.cpp -o ./test/compiledTests ; ./test/compiledTests ; Remove-Item -Path ./test/compiledTests.exe
-
-//use the main function provided by catch2
-#define CATCH_CONFIG_MAIN
-//include the catch2 library
-#include "./catch2/catch.hpp"
-
-//include the unit tests
-//#include "./exampleCheckNumbers.cpp"
-#include "./initializeDeinitialize.h"
\ No newline at end of file
diff --git a/tests/initializeDeinitialize.cpp b/tests/initialize.cpp
similarity index 93%
rename from tests/initializeDeinitialize.cpp
rename to tests/initialize.cpp
index 0a6d344e..fa3a156a 100644
--- a/tests/initializeDeinitialize.cpp
+++ b/tests/initialize.cpp
@@ -3,10 +3,7 @@
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include "./catch2/catch.hpp"
-
-void cpp_console_out(const char *msg) {
-    std::cout << msg;
-}
+#include "./000-unitTestsMain.h"
 
 TEST_CASE( "Do some loops", "[multi-file:2]" ) {
 

From 3efa8619a71dccf4e1f918ecd1001b9ff640b85e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Wed, 28 Sep 2022 09:40:17 +0000
Subject: [PATCH 074/549] delete output file

---
 output | Bin 4615232 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100755 output

diff --git a/output b/output
deleted file mode 100755
index 34ec6976cffe26fec5791b42b54f6be4b1f465f7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4615232
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%0DEn*>G^)9*_Q{wU^32^och
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%0ALvC*rsUKxsx%NxI{8*Rdha+?#-S
zvm_KHUr=VJK`?tVE{*ToT4^o4X@rTN5S<VSuExw;pDG}z9?D_Ms}i!+l3}_3y2Q_%
z4(({B%L4=Zs~2An<S6B{T1;*?kHVC6CroB%lr(onZ}7tOs+-ohQBl%F_tEjK1F;aq
zh%Xi%GNuXbU72~dO$fEeWFRLoK)D5}^W`>J_0CF*L`d8VB#<ux@47tDim|s0YfcL1
z)4i|wPH}SW>0pAq`bugwu-2-fP0xaTLz^~W8;Y8~mXrOq?ZJ}m>tGveBbPGJeMgiL
zoaF5!^$!G{SCy=%DvE1P;0>CqTI~0s6juR-3kR!)Ve4_zUlC?QWXHA+!*1QC4GW4t
zL+2a2JTUe%e`COF@Q{$QZC-Z+XSMoJpt3N4!ObvDgSz2MW=Vp;{W_!(y1QH}0EssO
z*n^=tIOKKPdAaA!4@l&OFGd!UYH08z>_ljOGzH)ngGljTZz=5#E`hnizS|V-7ni6{
zw=B`cm$5i4i+_9sRPfE0G+wH2o)hSwcY9;tL4G<;tRvuNyacWnx*T=BzJgxxKJ{4F
zSW3%hP^hifNibaA%QS+K7oL+@g}!*5aNSeL&3%O8=T4C45h8>w2)Au*6jL)`;a;#R
zN1Y)PRT|r|B~9-#C|?DtgcU+>TzpcZlHR+1L%IzZNdRA+PKxy2PZb@_qW7d|z(wGp
zcP*y=V8jwsNhV>kK$1s4{t!j;`{MBmI0Y&DjNU<6z7~A5lFvTvQqb||->S#k)P16$
zp!v7EuzBwnzGjO7&*6L;Z>Ac<$Es*Ki^`=)b%H*mlaF<{<Zu4GP8H1c3sO=bL91VO
zvML+M;TlLkm$Es)s$p)4nNp}vGd6zEsU)2y0w)h``Vt1fSn=L7)bJYc<9&J;5W=zJ
zpaTJuEc^ae$RYs{ZvWoI+v2%=^n|)z!t3i)HFm(;8!r=T^ir@NgLCkvoCcBF;oMI)
zd7b#r*7yhXI#Jd59cv7c8ndK)vMO(6c@LB;twA;eF}Ew-UFPwifb|#RA3vHXmN8A;
z`NK_ZWBo!Or4cf2|09rJF9=ZjSY1o=jH+f(`rD;|798D1CC+&7lHzLbOE(xz?`96Q
z`Alnz2va6~OPV%dDmM(<f}8$<W^`%LBG@V%pTJfAOtB|CWRmEp;+8rjOYwwv={>Q|
z3R5XgU5rL2WZf5R%@zF)ZGUHWrEmVB#b@Zn4=vuq4McU_fgtf8p>HsW*Y8aC-TQeI
zl{9y(<{gmy=oFzpW02RsR5JVPvGn>9gS6_RDN+=PLEc@6npt9yhtfI*(et6-Yfwea
z5`%n)(A+Cy`|L5u!5sb5tds8g#!fQ&-8lMm$6c>r!;Dvm(NkiaOx@SxZP#nXAosd4
z2t0-Fke&hR0Q1a1gkkc#6?|{;XM6*CNBnca0ets)H@^DZxsBh=Ld~tPKT}$$-$aMD
z4hx+%ZNRthBi{|snRTGC7eY&<0gnJcNQ1nHw2tWg1rlfNJ$+#mmuKFRMS?fI&S(^D
zkKWAJ1l;w70cdLbP31Fxw;d$|o>d%wkcCuF=VW<mGBwgL<2^$of$J3#dIE<za9NfY
zb$tTnO{|~pdUzyj)`<kbe3=6c#uDl+G5<pzZerDl+s#X=0@#c5WD9ynum8zZWE3`!
zhwoJj0cT$Ffsk6isdY4N^{Z1tamJyWUW7tM&ea$QWrw1>A0d_OG}VQ%k7)KTz(f>3
zD7uzKa*Kl*8_^%5vQQX#cy8*QH|K-+wEz>x0qya5)ajK+oq}w2H0K{!`eE*|WM~Gp
zgkdfM##=HNWS_YKT6668=LuCr7rw-F5IS-eo~;|!Jg@+il6ns_Go<E3gEp<^Q-oFB
z6a@L@J!(@1N(&<2iy6l*l#xH;R2q};J9$RpqAS{W-3Z^p(BJGHkR-WqyVnx`5r@JR
z#%@{=x?;E%-jJS+tl`X!lG(#Bk>r)4WWbv94)qenT~eg+gpcP0CF5P~mx6|J5|3jk
z*Nl$W&2-lr*SNvB&RQ>?D-3~&$aw#P1<$3M{>o5yVNk}agZa{$3I{YFr`q8xiB0u~
zs~|AFSDlo6(5cHlbI~F}W)24B+B&fs)&Luy>I84N@JT!qzmKrTTM3@=0SkZp??(#!
zNP!<I@FN9&q`;39_>lrXQs74l{78WxDe(X26zGuP3|9T8t}3hR6O*cH%IXt!^|h7N
zlhv~xhu77XA3mtIqM@?7W@Pz{8HW$9sZHUZ>PeN88*0nyD{HEIpg2)HYShS4iPHy-
zJTrMfU9$TDb^Q;hJg9#%kvzRej~-_x2A5S=*VHHLQuWDcsoDD`2TiQ0txt5e%V(BV
zHKfdw!)Ml10eDp^ad=tHgt~fmTBb&ESPlB?QC>YMQIVS1pvO6+rlGnbS&^Dl)=*WS
zEU&4qFRQFh)g~vVCZTDvysWAUIPpO+?g^FEmG#{Z>X95eDLK2QAz4;Yk*d%%Ngk7|
zpMrKipy_4R4FEFx(BzD&R9RgrnX0a90Oa}_0iFcqDl{x0dT6q;K3Q3pEK5!yT@wj`
zS5}V^mRFV4rX2cpKPY)lS)G7MRRCa3GF4VvHCsk93}88M3$p-$y5uBKC^@MN|5hX_
zt0&dqA9P%uI>*Hnzzrh(!Jfo9Wwq6c#hNc1y#mIHsp|T=9?8<O`YFkCDyynM#AMCP
zRP8ynmGyWg<3hDbRh8xSYHWfNhCX{n3Jpi1Zf#{nDmkMzHM6p&p-y8h!lLP``<+w?
zt`U|mOiAH222)!zJpfRbs;h&fCCgY{iBfrOs;oXGxYktrax*hk4q55nf5PwycwSXi
zQw}cIr66lt_TT9Go<~d=J!3*S<f=YZF=0l1Edb4^Dl1P79Z^(dDMZl`gYEGTom5;r
zx@_p^o)e0Pjp#RF!sP0P3FWh974@7jtfqY0gc&uU+U(+<#l^YD)BgS||9{+n=}F~k
z1iiiw1xD8w^|R?;k*Z47r)r0my2S6<(;+@?l-?JkeJ`yu6I9!wql+exGc)tzi`&f+
zh4I~t(?%-FOt*d3VP+KqjK7bK|3sLap<5tOG5F^>B!!Ei|MaqHsR?ycV6rME)R$>v
zi&5iw(S+d*^{H7C@*bM<Gx=+%s(<+5`|Wqe8528A`e}9N+8ye*PmG+FD4sr}e)iDn
z84dM`q1ELz(_xb9Q|2Ciq_RTYjHnr&nqE^oJ29rF=J-@<2Fzo~$>rnUe5o2zRaQ48
zA8(gP6xY_m3>kADvT=1WZb`}QVaFIhG6;6p*w3oj0U+^`b;)yTs()Ee!>o;Ra$;He
zH272F5=(1lG{AwTl0!!KPij+HZrdrb_KC#U>avM&A@E}K9F-v5xvBp0tPWRnVf05;
zHHZglDXj7JVI`|7l63GjGg8$dgDyS_PUpnYBS*k^&nPRete>4s%_>i&=x>!~)g_(B
z@KWbC<m!(eLpiL96wJE}T>OjnhT`U?q{=E1z?u&2Fghnli%3TTF@-~o2^?hh{u-)l
zQ{^?2t3i?wE7cefV@yZj1iwcwl_=^_L|FVUo?Z=z9cIix1O#xVku#n;)jC^yx9)^0
z&|GtBBFNHx0El-`LJ%HX4J(L9s3L)|3qXe&E*oMYT!Mi3{Daf1V1#y<$XRkmS!FHb
zxtdAh+!;HBAwX{GrU3pqGUNc?y0V#&qyTab$w15DWwVkaYS@p$4UuI7NLlC0Nsr{<
z+L{^qsSbR)Pn?|`GI+@7gA!Vb5MNrN&_CHwJ+0=P>LkLEn%X3oq__nn5~IszM&dz2
z)yQNwQq>JrRf+oAhE!rwSyf#saYjQS{xj^FYcBM!bH940@<IQd^7exJH@<UBBC-EK
zRp(UoyWmOrowxRyK`fvB<e<Tcx$BO+fBBU|cB}4q|JEb>4*%bm$F46q=c3bk?p65Z
z>m$219KEvc0@jWD@7il0I`+D2uf6u)=gvF!*Sq}rgtz+ae(Yg`_iVd#cJVR&FDZQM
zo)@k^`q8G=Yku+h(0)hUzVx5pcDc3ZfZIPizSF~}AMpEYF8N3IZC7<3Tys~&O%Jzi
z;@^?_Z#Vq%?>G2kd5!)(MgJcAkSaIrzVGj*9~j=2j^_;YA4lIrV#Bd4H*_98vGmw)
z?)dKupR7Iin3B66z3%R<UpRW#aqr#ma=*F#=1yr!eKY#io;$25y1IDG<p(_R#)B8$
zv)y-{cWGWbCmwbp5pvc?4z_JKZj`$ahvWwzS>|z~`1$y`lTx$CaSoP`hZ_THnw(x)
z2eVf`1%3xQMblAJt>-N|zAv9rRy{dIgOY^y>Dgbh{+!BkMC>QQBPVO%IK<W{O27_O
zPA{vH7BFj*F$FQ6f+oF(o;W5(Kn)2p#YjME)B7;sKPOdTCXs`EvnDeEx<eA<fXc)H
zlM)A1Bo63t@ML8s)d<YAXf&srdRR29(uo?MgE!2Znu`QJD3v_14)YZF)5(=HVV1=R
zqv@F1N}1cqL`o({B-df2m$qqoGTmRzp_BOU7*J?-azHXMsCIJ0boelih4!ZhO{F4j
zVq(LjNyb$lJs??_JnS&*DeY?I^oHq*#K{mveQMHv8V~N1N_ha#SY4FY%$Tji3*QC!
z-Y{7+aVlnB{S$}k+5^BW?uH+os+T#Uf>Bw`00FkWrgnhLdFcqt%Q3l|)KF!$RkX&x
zbNwrI;oLv4{|B4+w*Y^y;_oW`d#nD<;P(#)sK3+j`#Aol>ffvM@4fg9^&z*p=U;vG
z{ExiuQ`E25gd>ZJjy$fcuCkmZ$Jdk#yM~S!T{xkr&+#fLfq<^2oR}A@>CqA2XL=N}
z4>5DlIHasH*S>_?V-9K6jl0a<Ugm&t&HOUAeb1sn6OnZ)E3bF#oF0U-YkpJz;{RZN
zFch(3ZFO0dgzxMK6Nh9K(jH8+)TUtaWImCkitF@HZB12Gsuo!f5o{(YDpJ)@_5|xs
zKnOY`F}-dwV>B4EL>4>D%o<Ryh7JLO7+^`~WX-1?Us+d<d>CUGrBTvxgGBQ6mD5u-
z4N%6;Ix9CAIt^7lrxMmw*^i-<t6}1RpY;e$1gQYt#FQN)0Rq!6v|F=j;ObJ<6+M!A
zAi*g1wX#c$H=+5J70Ho<OG`n#y1KH-u>9TYr_?k|o}yy@Dad^VRsi;JVhV=SGN~1a
z?~V^e`LKjF)5=g6gRZD4H<l4;8ox`VYZ~hJg)xL*ke<lTkt0j@P0F0nC7p6Ib-)fG
z<V>JS#vwCE7{+YErk&exsFDLdhG{;aAu=+Rjg$EY`WuxhPr(sXBnJ-~Hf&V!=&{4b
zV7#e1&fdg#f~K>Rm^8VpRQ6a^nwElW%?QLxGGn7sziLR;)nkOhNsL?WedNou%OKAD
z&l!j0YLgXUi#ScDVnL$lAka=bI6Z@`tFP$azk*#Qk;R;xs)fLmRRfV(6X=7wgHigw
zgHLlcyr`Ee;)8n?j~X$0LQx@$M<X+qs%OroP^TKeM_A7Z{rGfv4H7sonq#YAR;CwE
zFkSF>u6<+Qhk7p>*-$@nl1c{nrY)OYA<W$N-_HM8V`SbBNv3?$G<N?v?80!RHTgtk
zoG%75OJ9-uCnu-sNlIUc7{(y&%y<IoQON`f0}NO#q~sfrf}QSHRTRzwSIGs0F&<df
z@yw{Lq1UIik8hc!Kiw{ShgsUGac1u>>`#kC@D$-4dCA2m%4vRFqTQACkVz?o&kO)*
z`4MV~iB^%LUpN$2c2ugqp|)C#H%%NPtAt*`iR8!RS&nh~oXuyf!yybzGjRch4qy`e
zBjb3BK3w%M%Q>ZGb#<slCxdYs>y&VdVSttUG4VD=tc85&@svr<6J(CS2w&f;o+nk-
zVmuAvMHs=0lO)2(QP7Xj^;IO{$@YypCLO$vsr9{=v6^D6#nq0fNuDwq4u7H)oshy3
zQf0Xx44|JNPSz%IM%ipxJn8O;Sgr7@F3D+%7)77xIzQDz`98W|0dIVx^gFx~s~z<0
zw0=qmk)EroFRLz3B^*7r5;L7cPr6sv$n4{w&Iz(3d(ML7Gylys7yPyJ6<^@h1^%V=
z-*o))?{)mK{AvCBC;ht!uRWMHKg91?4fltD)gBo403Vw+A^&oO!<C}mHPxaK!z$~L
zdrZ|1A6qrEc!F<804Qhso;_=-wZj(Su)x3tVrgkaQOpda-$<E*jY?q!%IV7<x4F*Q
zf6<XO)nil;X?5*jkh^`~n(EOAX=raP09!KZobY=V`t*S(Xjc!p;TQSv+lzt=|42>E
zJOo2CC`<dzGbXlu&m%@o!g6hO3S6l}ntx_W56Blux4)vELn>#bDy&NGbAyj+ZsHj8
zYh=v+J=g`%XD}wi)9PHc(CwL?jhQEDLs&PisL$bp8Zd#VMZ_sC%(#)PlO@0#A{qK5
zmZQ0?0FyLinky^DluhoD9E-(#v%D@vaIb?34=dFFC;ZM5>Z$xYl#A`K$n_0%35HO0
zGg9T1lQ``ggnY&fMpELNAfJrW#W~5mrp!E6)QLP-lSg{|GNcmBG{PpOT!+X>^HbEP
zpFdQeuYSWwnDBj;(M;@-IIgCq9uq8Jj?@Oox*5KOtLGDeC=7yigc)VEV3^(|0H+Ir
zaows;NYy!E{4utJ=!K8+hT2-xp)i~25$5%{0}yU>;lco>Vu5V*NEXimJL}DZs!B}3
zdKUKVc~~L-FB;Rcuz&9(`XAA=N3XtpPD>bPT~-fhn2sV=vO2_qBj%H3Rk^mYlwi9@
z{Y30$kn961Yr)D_l#BuxVQR3mYQ6;UVy<%+z4sr-%2!dJFasSq)A~DDa=wFRVpmGp
z#7ZPjW+$vzR^?lVju<y+*wEt>IxLz=&eW&`3a&N!qf*Q%LX$?9V}YrGdt7{q=z(U%
zCw}~Wqhqr$(BqG+5vxY@1pY3S1oO!JFB)gtb}FW2eikbTGnsCYtaaxEBm>J%en41<
zIe7Ur3b1-0<3V)G5~OF;t_MliNS0YuqKI+c&iy>t?RCz+k~?R%*3R5QKYTc>=_jl$
zNaHvfv1^sG1P}d}m1Hin=Ge0pV5SsVk3A^15<fbZj7b1z1P~&N0bv;#m6`}!L=C8f
zO^67J5GN|{b9Fg>=B`xNbC1PtEv~`MRrm4##>-c~7={M|X7mI5$7%<cL8bwEGxFnC
z%};C+zOzzJPI{3kevlP7EIHVR%E=X{oJ{?tCQX92!S{uYPb>lA@h=QO2WZE(XQ4w6
zY%!S($t|s|k)`-bS-4lT;-MA!(a8moAH_ybhwV**ZPL4>=G>G>aynMXE0G@wX6bdw
z*{LA&X4|&TiE?)kr46++YOqRd?45L!Dy@Ny!ODz5cFZijMi3O3D=?#c+OX8jRF%%<
zYHG^3&9Fzq#b8BE4csj7a~Uj@91L@IZ1uEitdGYrD4f6Rqauu+n!_%ZMTIj|J_qVo
zyxAy!Y*l3?a(g}dnBi+&HLaMMDz0?Xd|7pIZrs>e7Av3eqxU6M%j5B7^<`sf%c|=p
zrE0OIqq?G|780nkV&mjCQGqH(Pt2AQ*EQwVYr6}PQ?+d;YXEB;J5wBP6xlgTn5oww
zvXLjAK1Dt4fko(2S%$PtU43PF-DnAXoxpEs1vb!(oxxlP%&)o_qBf?g8z{FSSyuk^
zJ3dz*W<Z)xLn>>hBl1bb4CZ)9wH}GN)MGKX9E}WlDDx^+YEq!<=pw12o&qEMcg+bO
zZCZlAJMec8{vN^KQ}}xxe_FMCddJIOpX_5c$QcNcc-^;`C#2j}GKobT=ZIzF1h&3V
zw|U9`a?4{FWIi&fjR)fg9eT4Ld*ck3{wKiAl~3!RoG_s}+5Ma;mB@C&=Wu^g@|Xcw
zJ*ccZ>=?Cl5PIxDa(D9PpU!gahMmuf<xf$cFd-bSXt_fjOHB355_6w%W^S2~g<j5v
z@}Ro~DnE}!D%*KT2@p+>K_(U%NNhRau8jIxY?air5Qu4QXeJa3&#z|yV!ky)W>BiS
zl?Rpn&0|wNVWDNb6O9+A%3{E<(Ms<&tUv)~V5xnRrD|jS6l@&Ba#U4K&9o$@W!6?}
z5=gdjVa+KutBk7_rb7k|Bg!ztbN`#`-Ujjz&;MR7Z#DNd-~DM?!k*w6^RGL~t!F-n
zd=xB~(Kj=`FdyoJX>GPyEYcb|X0b?NU_*|D;Ff{$$sJ4Iem?$jdNrIIyk%BV=S~>u
zi?KBT3I#tr-LEBm<)*g<vRxDxt6GaC1%$=6WpnM3kF<3Wi+@p(H6VusR?Fa0%iSn!
zIjE<XgXRXLa7d&QQ%s!Yrbj%e{OpeOVNxP~9u0(1sWry{hN9qLna1A_WMV(;ah8A|
z*_Sfpyy7u+qfJf+5_Z*DK9E{9{iB_!KCC)58M7eRlF(?-9uX&!4fV4JV}~iWogf+y
zjCYQ?>!6VnMvodkrgYTEAw!214?TXu;E^LnOeoR|OL`AOqO6K05!<>r%~FvA?6tZH
zW*R!^4ZY{$pk*ije0n+Uoa&q;n+VGfM!8YUUtQ#;4T@0`I2)A$C3Tj?&Uq%X#s59+
zE(0h<g~9Sy@k}h$Z()c(H;{VgDqDGc{Ms|i=v+H)Fn~h~5Ww=7PZ9`-suQ86Pb)LX
z@c8`uSpDx=6x+A41irqLk+N|xNMe>?vrmHmjKT($`o!p(Nyv5Z%ICB{Hn5mkY4^X_
z@$?oDrh79VAC36Z)wo1?U8tlkLYgh|gV8SXvq9WXh%HFkX7opLOUZ5$8^Oz~Dv{-d
zJ(B-o@h$2b?byfOkFWDse+V068U1G7fDErdV5DI%*3K!jN*z{LKV1VF%&e46Lt>b@
zRmntDFa+vtIoVC%E^SDcSR%K?J&CX!=?&STWo#GTJgLJTM!vvU+fdDS1??8fo`*-D
zR52YBw!X<R4qNIb7@gGBBW}xYCB+&e;8=p5V@V|vG{vl^sL3`&Az43bC|??_n^B3h
zy%HuBwkL*RuV$5cj^t?Np?FH)6qLB?HP^lM@3NK0+pnTNVVYXf>C30itYf-eTAM-=
zmGe}io{7;7Sc$^YM@8|t(Z%*%VhGq%hqqBD!?>wEZhSdKW$6KH2w$8v-fDAk1cnI{
zW6%Hd(Ez59if7izgk2@8f>pE5i4h~mOc-4}2Bh2n%a1k{;_qnumEdm-{?5i<75--7
zZyx^c`0Arg{^k#~8G%<`AzBy}y=JnzC4tEUuz@f-V#Omn?~L$sI@U;&B%KE4NHX%^
zHMN7W%Lf$X%RAHx-$I)PGS%{TkdCO41$<*I0|m%tpCW{{BtZKI*r(B)jRg)1sN|0O
zLiL4Nn@Kq-@+6AY#>C=r*mRR(9$r}%%q=Hl83Bd_mNx_)hD|sVDh|xUzAA|4bIT;S
z+Kvzk%by^07G2+0nGky!);ACwdOUr5hsI<P7i~0s$0*$NItwPyGK5rxDKMVS60yzE
z-vue;7ZPPn_$7*GrOLUMh?%k38YH`UWTD3DnR`$xL2=*vTQiKDVQ!2<K%a+NI{|%q
zD#zwazl5b`0_tK0Tgt7^J+v}tib(^docYe8=8}go|IIaJ@%-)O4##D$;qO?a2Fs@n
zHc_#o;^x_Oyzb9w#%A=&RM*@0gt3M)S$V4(B?liD7!NQ|(+4~lZC(w8edb7El-0%m
z$KCzF)m_(%AODQVa4jQSw!6rV3pX}_0b?5?o3I@wDBEzbxfEr<fq^^xiE}oYqLGnd
zk&!L$GFoJ0WMpeDTecP%b-9a-blKV^o5nS^agB^?%ggorUhmK6`#pc)z?kN}{q7#(
z6VCa5zJEU7&-e5F{QG{sR`aBeg2~sro|hq?!RTb~WaWvKR)+y=<mN?%#Ev?#Dfo||
z-~FG5kKg4J4mdP|t?OrV9nItAc1vft>Y?3Q#fB#zhm~mbIFHa(%`AG&(FF2!-9BY+
z(QYo9&1LPSeQZ}bE#BpUVF44{Q-YVW!-j8JGZzVWS*uan>XLa=8@&Q2&VSwlAL-ww
z`h1G~F*P*8v(2+eWH+8#N{B&ic2+6dY|T3F6SEI{j84d4nu!All)p)cj_pAE&*XA?
zxH~v`SZJHbgzR0Ox{}+Jopal@uL+^-k3;XN6sc&xCYuQAbe`Betcy~5YKh6|xImAp
z4jC7?j#ez5Mn9i)tZQhKyJ;!2%fn?nf+A00$WB_%X6UC4xN9<o)eJq9ur)G3NxCeh
z%uCCv{gr8tr>I}<rBAbVXFd71bR;H{ABCobK)Rk(KvAJ>rXelAlNX+lftYp?yYy<c
zZAfXBs1F%I66jdA$BZzBOCOg%w=`EE&)VoimLadxG}(pbZ^>zeYn(jnLN$N_UJY#-
zOeav_O{>^hW7-|p?K)?-CQm2?U3?SPpA=ZXS!%-fsi7AS%S_q-6POui!_Ml`^7@Sx
z?6K)6_mF+nm&cp*Y^8nu5$RNFFZM_NJIp!;9WjZG74IGuKi$X;ofJ1&-3sR6Xa9IJ
zYyAyYdCen<BIMGcx0|jgPni6^u*9>&vs5Pm(=l#JCX+w0`VnSOdNLP{Ny{W<lQ3ur
zGoRZhRW1qpNl`O?T@G%yxu&fvL66oZh7u`v1s4<~iOHY|MiG|E%tIcAxSMg{)z*M{
zJ)MDhDpFC13mITW`IuoZJboh!nM4z~UzuSsYx8B+hLEvscigFJY7=FX`iiAOF2mle
z$74N?<$6WIN&e06e+zy1ogHX0M`QjU+}{@bx&6DjZ%Cu6-IRK{Yq|ueShR3!(6aoU
zwIwSz&$Po5*t!y^!%JTk&-^etuSTAKHEGIeJ!4B_9|Nf-+$=WMSOt698szz(kh{Ug
z8Y+cMX(Ug(nXAn@hza>wnB~lsk|*s6{>#N0jcZyNsKxugIG^jozUs}f>C3{T^eIc8
z?DJatfn_~qlU<+7m65RV!A(50i%|2hng`4vKK+olJ-<kvOc-U?22IxheRcj4f*yVp
z)SN}i<rZXT)w)(=#iI<aaIE6NWtF`p5WAFl>)boJcf07w4*X^h>6CUrQxUD^smgTS
zDzi#jY5XhAH=(6^#K<;lM^}+VtVV+g;Y~S#n(Tz4!Nl$OmkUW9l3qggr=Ho0N*JYT
z?M_g73|&sz1IR{r@>$QbMRSfkipR*klHDA+IkDD*-Y(rNsn(P;O3FSS^SF?SeK|~f
zk}heOus;ncebv+|J)BR*Qc`ngzp3AcUz<KhrWUTFkVX|61?l%;Ixnko?hK?`U00Gz
z!b)FO1}9J4>$D}ArAMX&BlogS#&maQHL3q0dHLGV^q#VU?A!mDb-D|5pKv`-5(eG6
zOLysq2YGx!cF_7av43OI`mF~PgP!iIqFX~ASxhc$V7o3_TWf2wvy+3@YOj3;`#;n5
zC;eU59})?Y|JwDH^(8etnJdo#sz3o_nsUPA@~*j$2le|e4f;L!-hGaSCwU}_=c~=2
zA^+Xm{(#|l=7BVQ^N#bBO9|M!(OR4*(Qc3l>q_+Of^s$}9XodFQAv(^(x5c&$*eIR
zT{2xf)z@-e)-U$wUuIwQ!)2^PGRBIaDfjeA_YYC#xikMTDQnA@&6e35LjTznQk_AC
z`QEBz>gFA3d=47KA)oCGU7P&HA(^2aQ?1ft4dKw=Q{~m&1?2g=Wt0WEiz~3>iSF9K
zRA0K?<n^YLX?j!FY|hPd7H`<ReogkKDerrex4YE-C^$_`-<qbgbxww~OOT?>pDt^R
zm_B{V9v3$GBwt3cQHq5@qr&Va9)dC^!3+_bDq&h*PfVHC$7YzWbsGpIEPI>ger_MI
zbp&?en~?6--C%wH`jeY!4VfzaoGVG{{V`>_Y0kR8zV9EC<p0E+3DXWc%^LJ#**sOZ
zeRpCO)w5mYi8Nbs<4oMd&5>GfeSAK%z|@C+8Qi>JZWAsU>==~W>GcLRLIf>E?Iq95
z-w^oTeC<C9Q(|nW2?`bFqi`$oWVx%hGeei&oxu8oKMn-b&rJmd@NZuiSQ~1BzOpwT
z^ig0vQ{~@!`;;GKhF4Rm4B8`}Nvy4R5wmpUsB>iFlu{&FGt~o4M|4#%JelcfRwQ}M
z909cz74eSpL>|8?EiWsfZ$U~175eF3Ivo8E4%0qB3n=sY=oq3UyhJ8l)pOxo?y?{G
znKmt0iAwG&lzF5v&@66Jj!8Inx`|sHuP2n?$ys@7bNg;{GI?5}o(COjTzU#w88E^#
z6x>7TeGjf~O*tq?u8DKTw;l1px!O63^JVraq69suK5Dhl1uvuTU3P`lAI0W8I;o9H
z8Qsf#k9tZ9k1k3vB^t*byb_Agfx4<aeXB_+64k*G@@CaPty8M+OOnR8^U<YjcG#r{
zkj*r{^};hr&89g_%GI@{9y39R*<L-9+nQNdh$NYluuQjINs93=VCEH`ZUmW$wG5tM
zaj({M*D{>ZJ!#@vleg+CzJ6z&6h9Mnb%0wFnV$U-C3>}ymce@FxYHvf^(AEgk<SC|
zwXUi%nnwNOU97bPe<CZfTZ?pbpELcMjhX15NnLakS0eGbR%T~xV9H{tANrr6oUNMI
z{n^*XPdh(d{2b(`ho63aj`Q>1*ZkQ>8w%BU;$7BYHL}pPC|QK`-qg|dULF{WyORQs
zopOv4pSsj!B1O5Ys#&B)x2ok!V9G>xi-BIwF68<93pm;Oxsgre2%Ba7#l`;KLF+3!
zjI|9qm~~SZhc1Dp%ojqQ?^qi0m!1!0CQ&R$$-GLnZs|z0#>`k5TsaT@l#@iI%xLdn
zJSV~WNHSyl*c>Iya!p>xgR=G`mE_qB(ygkkkGD$N(*G!9M&$yr56@~;v@=w*KzU8s
z?(3NISswD3W~Ck(eBxN-q?EmTkv>`aUcyYX<a7MzVTw5JDrWW>Cfk--fS6Cmsv0n`
zTra7z)D6mx@Nym9_CZ-YM^jH|w=)r9KW;N&QTs_AeR$`7f@eZ#IcER42t<~u*U@Ij
ziqZ$HZYVF`!8CeyQ;R<S!2CzdFh{E)Q_qEt(aLq129VHCt-W3)tplOk;v;#Wu*$WL
ziMGkN?Oy|(l2eWR4f_}@onz*t?X1z45%*fXN_qNI|58}1kHh-?P1uSZA9ixqn^Vk3
zLeW7N81%D?<qeb&&0Vd~e*TJPb9qR?OcNS%2b=Pi-elH3>HkxGE(=ch&VJrdz6$?u
zx^hEEju4tZoJR?Q`LJXHLgr5o+~b3q>8KY<7gKeuZWow6UE8c~nk^{I+EiGWyFS|<
z7%OeN;RehGni#Ch$qWLfcv=v+0CgeWjv2ii*^7O4v&>A7_Q!Sx?C_6-vKM5XChPUc
zT!{Aac8`Zu4U@(;c@WV4nt@Z+^t_XMNK6Bwj5pE=J+y%2NT#vTep*@T)u#Qih8q;?
zmZ>n!2PP=L+b=PgYVfe`_mXUNQ?<9S!JoN0?A+C!kjJ!!mN(Q@)tkq0tccU`>6YgQ
zB~Q1H&mTM}FD38aPVtzMgvnOd=45TUCfge8ygq9yCwJ|2dD&aC^JLW%+s{&xLL$&g
zgDETP%b5nxQ)zG5YW`%eyyfRPPI&V5V#-4lNGBCe^xe^}rBBx!F71_O9&MWErGntS
zjahS~Oqu9lE}$}V&g3Ep>W!h|Vs4)tncP4f*#-GDzEVzR9eNxkQ_lOF!eyQ<^Mngc
z4<=8y9!=9DYLq;=;@M5LwOSfs3V7#*n?9X7%4u@dF$mG_ucE|m-czAV-F5Y~JZ@c0
zzRn9DZqu`OGEI{{gN`b*T;0x6x_T?+8m_iyEWD=5o3pc&d7ZbH>l9)=a}(I}z<%3%
zZE7Lms?;~od^}AxT-{JPWnIBv{jk!hX|A5wQRcq|l_hw*yBUID&Dfv^wsLh<^Eje3
zhH;)`@<^uNR`Tn1>;5bgas_{2J-w+%x>6i8EnqUIx3v>NEV(fyjY7}lx}quP)`zq(
zSC|&&iG8}EMO-H330?n6)~{nVxGMU_S6{JKoxEaQ=)R<^3@)Bq+o0%eI=c1KxT(QQ
zIGHHMOr*^#7nlq*q-$FrMd<pIuM7@ttv|Rse8PB><dop$Ll(5+Xu|qeN`}nk#^hp!
zTo=@2!vzY8-_Y>nPP#5+swZ#gz=O6Sze;j*td&WS)6)y+k)>E)UXh+|=CY`*zv<?<
z$zRIzj>R&*f3e(kJznxJFFA>4Y2wl{SyPH3v65C6%8lg>jtob&o?y`)qnJfx)HcNN
zcAdp`UBqENOHb!MMi&up-qHX3AFtORn@Q4YxwI+l2Og10oV1qmI!_g|{@bfzMg+ad
z^mOZspcT>5b5l~hBl%|8;I3L460AdBNBf$a$TnRiInsbq&Z}8yNF(>L=8C+G1Cu<I
ztasr;#{z31dtPOBv&wz~*USi)xWF9O47TH{Vr-1PsdH^cvIBNR-vjI!5zO?bfzNgG
z)B<&xic|iHF7H^f#F}0{fikUr*p)*uvr?0bOOmCYPTAWUMCw?w<W6;2oRV{Q;p}&)
zo8s=sXjC^ZzH@bAeEL;Ou1Hw5aA^^TC`|!&JW5w>NqTxAg@|=b*^!>UmMUF!O?tWv
zSCJWo`OULNh9Q*H?~XI6%T8KklB?-k1zO)^1}J9h3!bVoI38!P9qtolrX|!me-f{f
z>T~_+v`p_@qWy)(-dut{aaPip!KUnklcC(?^3w-gXrGX3-s>Qd!}f2haxvfSYAzlB
zM{+gk*D<M(4|Pw7905~o(-o~}IW>oso?gTJ4UWdf;I)KZanL&CK!etCj$IEvjdr%N
zgffH48mf6?kVnp4bunF8(!Z*+nknLM;W@XZ_uWn-iWf!QV8v1rr4vW`DwW^}bDmt~
z%s1~Q3D)jl*jea4gnUO9SYA>c$o~Qd!iDaY&}*2loEBt#g^-5Ao!pQ$E;*mgC9L*G
z+-{X@hI#BR_s~nDYE+UkLouWiyrM!MCH>!erYA1h5(e_nQq7aaR8eWs(-R9@jiS_?
z<>en9-e<8$Em9ffdT_S9IAygeTB_HytE%41`@yEzS=~U#Ljn0Rchx36K6i>Gv+B2}
zr|Tg=R=PLoaG@UBFzGS~i76BJ3+<Fcgj4uVSY74eEdkq!>Ugr847EDwknL&ZD;PCg
zdz;iU6r-eSb<?8E$y`^*Ggb0NGA1DQGVV^A933@0WgV11TXW+Fe`&SD$Up^MP+OF+
zNF^jxmb>dzLZwQ$nw~}vZ_?Ur=J6zlH^n|yuJp{F>7+#VRo$dAl!Ld&In>R{-YYeG
zHbWn2k+S!a)~R&Pz~3wW^%){V{kxn3Z!LEevqr9A$MWP9MsoWTlSC{R1h?1?wKSga
zJSs8Z;g3Qo41_Le)nz381>UeC)d*rwW~i1*gnSuK4MXw<inMN;I>@e-w1v{b6S865
zi^KVrAX3{=B|E*QeTJ-3#(`E-boRHWN%KH$MY=;4if8T{hQ8HPd`KklBHeHsI3#iu
zri&u?<Cd=20WUW)W<6IjM}@u_(wb<!%fN1}v)8UeQhS!5)UXIEn~~tMA*OYryM+cy
zTK-gJ)%MEJ17f44wajeD>-i*xtR0fK^_Vd=^a=6>{}%Bc8Qs|9fAYzs(S!sU6`No$
z?NL%9(`mi2j+xz<6uyzyU-9NVJ%xq-lD*T#Hn~3Nz#@s4(vVk4`D;f4=c{^WU4o8V
z|ED+T52gI7R7thGSWfEXvJ7XDmuc{dLJv6&qY0%cT)yQ3B8*&^JL`BUAd_e4Eyr2U
z^rbtJladyPY`CU2fsq{U-87WS;VSBpa&@sP+IfPy&pcN#*O5MX_7XA=c_3);!LUme
zjNPFNFQH0$8pt3e-?lzu->uJNdtpA;EhJKfCWG~ooiTBGTxq%YHksu;Ne^45(Zqj5
zNr_i34?QHxP`dCgb6MEGS*`REfBp}{ZO6Y_B8q>ZE4Ei=EBkL+|7E?_r*d|=DBLn1
z;G}rJt)$AEK>Q}y$=js=MxBToB@H)P>0g#K&5k89V~V*JOtXMa>zrfGBNGoxL^GeF
z{j`QPBur<zT*wX*x_J>|nRLZU%3%M3g30wG<v<r}BT*)p>sfKpHgezdFw+;)J5YU+
zOhcx1)|WfUPL{8)*`C0F8kbrmX>w7ci3^Dp$}@W8xYa{bM$<i)76<Myxr@Ur>R}~1
zYtgw-BRNo`?ujA1PPb(;CQdKlk4kyJ7$?7sS&}DRf^tR5D_#88u&iHSrn0sKi4%{0
zg9_`nmtCqS)z|SN7qD!R@$a&vz64l-KdVp)yG*u1%t*G<sIwJ0P%D0dmLy*EKyZ~%
zMpWou^;(sQ5$OyzA96JGU$Ys>k<A{KcoKBhk?=u9PoO+f%b)(lYA;6+ot5i=DxpHR
z3&{#3_BlSu>vbfWgE8ANvj>#u?4K2oQzZC%tP-5Er;?jUc+UK7CcM3XNsY2f&OwQu
zN03^Aj9WCVzGfEkpzFa}S%QBPoDNsG6|*ODzfuXe*(0b-ToE5KL!f-e36hhk$7waF
zga&f<M0>2YN9m8PxyBm;A6v_-gc5rRx$((_;4&PGaRIDR$5;ZzJ&8HbPI<1^eB{sC
zRf4?8&d%tq%sVta5^M6nizG>sf=ZykXs(!$leMeLBQqXy9935QGV0O#jA0KYrL@ga
zz?MoEgC5v5Ze{hgx2XhnY)2LOId8x-MJjy~SfZ4|^A43z%KqtJC2N(dgSXu3IU8$&
z4%BWiPB8gAb1=Gha?cLDNJF1(ddq68<jnfbwIjE&1aG)2Mt>8y!dT25ZZZFbrEW^9
z=I5$q$%Yg|s$qp;86;n|%vy4#`AY)up#%WyLzYZ;*hOViK29-}YsyH{L0n?xSKQ(C
z<W|<7<PTQuTB*B+U-rq*1N=P7&(HXIj-OZfx#-l(zIUCT{%0S{)bO*KpDjVl-^1?<
z`FT6%W+{y?WlKHf?uw=4wldcOUFT)x_4!q<^b3`=2<)W6UuKXclPu>7vZ@qP_1E=6
z8XMSQd8cfKRhM#F6|8KQ&ZRuO+O8hhU&wnn?Jp-aDaG4MQw8A4q6NyXF6hl!qYFq(
ztNrz4UCG%X`Jz=nmx{0c(Efk}<=+O%AZxF<B9K^lFK{hw8l@B`N*rtRHU)j-KP~>0
z%?g@iEsT%Oy(V`<p(DXjs2{SXrlgAvGHAgeJ#-W){LAI#v0N^<-0gZXiVQnV<{Gph
z>syzf&2qGeFo=%(V4X~=Xtl)z7G$}C>}$5LU_tqI-Jq^3G5+~$?2WTrVfLo=fgRL~
zSqaNt$Q(!3noV*b`jHVwTuG_9dvLi)Nlg#vTWkl&ux4Si{^qTJ*7=^IX)Nr=x~1i^
z61TTN`o?&NiEb&Q<3cWpKqIyze`7)JR%=UUxDs7C`Z+NvV%sx2P$(hCUqELV4GE$5
zN$Oo$GI-XW6TsXr^evRH;x=q_II|1ZZpzIs%-y(w_e<LOfSP>IRTpNO^T~4s=0-Dl
z8PDYHu`nNUdsNoLU)(P2oLas~SN^2se=1t9nA`gTwZPws8E6A_oTJ^74lt>sl1oy>
ztZ>L9(@d+ub-Ot)Uq%}65TBjgsaDZ{CxsqvxRUC~eyXV_R`H;EqB&Z5--*eY>}08@
z`jp;(b8#tIFGUfy<cPb8c0W7ZCdT}m$%_2zG!+xOy*0x@VOicBqzmnm9Z=@r&DPeI
z&l#RU5y|1hOR-YvQ66?oTrNAPs~g<1%InSfWy><zfv1dFu8AK?unZ%TAuRR@@PCrd
zxtPU)N&j3VKT-Td^W)$rlb<GjLKc|tXV~SZ3G)`dlkL2fp9}bT8$Ys+3;B^@aFS=w
z;Ya@Ytbez}79}pZ;_A4?H{E>4osBB-rlKXc#0qhX`S^~;34hGCmY`)KPM2b76}G3+
zU(8)=f#Md#(^!h4gS?v2W2(R=amgri>o;8>)hCYjLONx4EAvUv>iEo#QTBIjR(|2;
zP1$tVQSK*~qZTF=M?Lkz&Kk3z%kklzJl!YFcMds5`Df)bYfI|n0Y4fv?BBxNJfyhe
zZ(uE;`d?O_N1;XTL$o_tYcj1?H<WnN(>GSg@E!j*{+o^@W?C?H;m&U0(|HwBq}zLH
ze=p7Wqu2e#7qdR}M?O2k&tTAZAISTQZ_@GH<v$>O4bh%!4pl!)R9(!CO<oe?znKNM
zbK4=))2%RDq{Yu_6b;-t<yOl5Qre7756r}MN<2#epsLJ{B>ln|X^|(E{J%@#U`Khq
zzirn4MVN)s(@V<q4A%B(DkPI#OC?6HgdL&{)~s%=8TK}@VQ}*Da+A-hamfQ{a!=!k
zWY$e<Ey2G_Q=xy~tna0Tmf3+^_TnLbO%Xt%#ZG_z^@TmwGB<N0$1P4z&v2Jim%2*g
z7ITL*|48rB0wR4v_5}O&G#^l|w(mNNsjJAa2CL>J35tJKIw_QvH;;W<HtnpjqANX}
z+L^>rXs?1DYyRSql8sphomk~5Ftxitq^LXWj6SH7$Bf00mJaKl<)UU@Q+}r^%q}P_
zUYo^)JT$)g3;k4$J=V)8Zewap8bzggq-RuFn^m|rM+VWX%e|&}U6zF2xIUjb=cIj>
z1`p<UAm7lJHYEV5^7CRK<>UDE_xjD!)XlBo@T^m}!%9U+TKqmJxs+6JSl&PW$6k$O
z{Z=GegEiO^(``~2mIedb6kHO|dRiN9WMz7)NG4I*DVK}1KF|(ccbS^4*WuVD%gVoX
z+%|a=yS!;bx)RtW-PG$~3QuVikmq<L;wV|mj9%QR%6NUKx!dSE5;cG<vtKEuSQ2Q1
zXVPtML)&?<o`ocNRMc~zx7F6~n9VyFtzY@d?2(*m8H%f$QTTMWK9V>OFGJ%c+R~Ux
zIb${h8h2W)*9lkad%oUXZUc#l(v%~|DkTBZXnFloVp_kR%WBWjk-!pi+%s8T+KE_P
z9s;Dps*I*r_AAiLD_N$$f%kGVg2dm%DR0}NfGnLZoY~p$xX>Y6mFqxvW%~1G@;d3M
zqkDt`eF<d<I)8aYKEW=vvKl)DsGBmC9-6{)l{8c^FtCK0>>{(?MN%k|f+xvDP8g9;
z?YJpZFQjYQHz&@fRoE_V29h8jU&w<j+-Nx0>;g}1stY&qgfpXA*tq`tvPz0x>M~tT
z_NdEDYn9aP)n(NsyUj1`xg>A7RMchurd35bQ*S=qL8;2#N8&(U2h67Z-_x`zNmS0C
zxh5n!+zb__;wA6;as-Bw=pqppn;!1XnYSawe>KNRnbWb@f3ViEOghpD2TDrjAa>IL
zOv8(vn>kc^y1GMh9rH@)3H=#%2BmW#c0N5l*UF6ix0T6@SWEC;+H&2YL1HC8r$<re
zt%@2}?RJWAWT7$~OQ$(gc(woLl;3jZFTN;#=J8WE@)w`{EkD8c({pUOnnz9xYxDI+
zbzMeMl58Sy-<-UL&>VM~gA85pf8_ot`yYH)l>1=lZg7}XRHQ*h`ljZ+b<B4eKgs;0
z^Rt8>b@aijWIdT{-YMw3JE=hx)u<w`x<f8axvV+UcT(cyi$z8C^tKdL$p32Of8Is3
zRqMCxsS;J8>eNmpojm3QN~42bZJ<UZZ!sv{O>@{zZ$(0yxe9m$m=A)Al&YvfEp&UY
zQVVHu=l|Q~S1DXxrIxN%8B5iw1uEmRgaq1>tUGna)eY5dGdRmrSuRuRQ8Zk&Kt|**
zZSc4kI4bFcB-DbdSL-KI^zwEq_NoQRiAf9e4oFk>ss)=1*CnLsMK4cWMiZ#MQ}9Y3
z8TX@mk{n9fgXJ#g<;vkn<Pxf0>&y*>4o(w*h3xJ$`^|$yVoj~X|FLIrqB7UNq9!k0
zy>bVx-Jw))%Z>k5t#b;i^d~2je-$#e#cFNfZfb_Om{s~04735+Yl?SlC+p<uFIRdP
zsnrxpVxgzCtjbH-pVlMYGD3@pwfZGX*xtr1W4?y`G2f$wW4_qUW4`7Oo&S%l<BIFY
zd=C<yW*glHAw9Yrd%BXGoGgHR-r9evgbX;?q#sGQGAdK@kd}0AAyOTodM+g#dhKXw
z)s4GyQ_OW{OE+d9bMrXt;{PJ$;HfQ@pH)zh?Nq_>8uEuntz%k;Y-i}nF`wz^=fMp9
zs^h6omwg!4M5xyC)ZD|JINDpSr_e|xfhGn?6#8aF9GOmM8dBs#`^*NNxR7%{)#n~{
zbLE)tJ>_G*FKi$4eV3m<^Y{7w$U3@M$FB%aVMWIxdqi=Pvnj144i3lai8QU>@_ew}
zp+(=i8Cs)zoAo#RkFG(PuHJfz%40s353L1gNTletO9g`R1$S2+(E8P0M%KgCS;a}`
z&dxvSSg{t=zXmNBHhmGpj1QnZCW%Y8mgpyZtVe4c>#CTkQWEQI5?SDy=DM*f17W_A
z{6g2Y)gqn%-pK@SJoqfBbvw_6*OBZO5pz;-C^5xMimr}I8D3f<qaY|@5?$QcCl(8>
zVF*%S<Z`L4W`8MS&^yMFdu!RpYh?9k{R_TtQYVp8xQPO(qt}t)d+mE6bvEm!!UM8A
zbjdwM2Fsb6NP#p3+I4LETGQE~X~Q$Qqm^+w;y5rGxUAeUIQ{x#g-#bc&!pL3XHkv>
z<!E#;Lx9A#T(y^fDB<$zgv(upm*=EkzCQi(f*WNXZYhmT$RF4k31{p2JY77bp^Udg
z)3wBe{=BnFUZ$2+<6Y!&+)6t*MORq?B~2RFnDtn4b?LP+9q{^BQ||KU-KQ<X`bNpg
z(Oo;<Ql8?W!;&Hej{#DHphw#)uRgGT-7Q^datKPdZ(9Q*Oi!m7c&&SRtY0bl%Bc!I
zPuI$R2F}uL_3U3Eo0EFERgbj)+(6-7S0d#=<a_xbQ5P1d&jvNMC#&u5+EQA*WkG3C
zQViShc=Q2DDNq-X=vkn;s(Xv-OtmXem6WnM)1#Pd$6q|w<#s!!xW{nV+(>j4$IK|r
zdC(~_`1tZ@5!S6Xfn%hj(*DD4iC{h~sb-Mt+u!7S>lfNJW<A=-s&`7I-M>!iM%Kqt
zjl4~I|MggeWWL}QXMbx|-@~UTQmmDps25UBX9%C<45mgGbm1wv@XQsb>@yNviIkRQ
zhS-}+h@ug%aJ<2EM#`Wll9ptk^cwPtMvq5rWU?0;^m*};<gM~n8-L}UA_upB9j#o%
z=H{=9A<_xCk;)~dluf#tPD7ws9qG}&Ye;!TCuF-THkY@hN+E)628ZQg0M|zPAAwDU
ze&><IMT+KFWc(-lF4YvN_XUp+w8w{01*j@BJCsq#6Q)6bhc<**;|jxt+f3(?<0gHx
z+00Wcl7Oyq6!Kg6O;X;sX8OHZr#xz&m#uP`eK0i=UO@RjxWCivrP(QI)12u61uEy9
zHcpvW?jL3(1NS}C38YKHs>a+_)fRhzlGSP@RcIMtN8ZOp%#0+`DCfT#D31h<|6RM2
zcaU)d+U37hNCaj$sju#0JUr*qpLg@zZn-P;lxEraI`<5($A1p((18;elFjMC+!OM_
zbMJ?p>xJ13`+7Xjy_j&vvtAXX=ZmW5DVy>-vQPVhwl9X_^^AO!x__Dd2zAgm)`*~D
zZtF6jHhi)Ox;`ddFX2N3Cv4L?PRfwR4qb`!$ND+0m*A90At^oG1m_&-zlw{?8XA(5
z)6+}kdbUPhXGn|1>YJ(8OVumvMfSR`vp4fNB@uA3o$n$3?;MB8>CSgwgOVJTR9=K7
zT|5kmwEl53lq`S;aEJ*L5hesL^`s=k&_bG|s5Uj|=RW++CNy<U3g?p14^ssTPAPh3
z0i7(RL!B{ORHbDnC>B-eMqT!8bMVLoMvBS!y6yCT=ze56|4Qm80MO?+?Q$HH9-79s
zy!AZCAWfQ9KjpOHN<3v%Re=_`#E`AXwi&QyKj~$yZ-ahXU-omux-8<6*bGdGsGqWA
zz=COGrs>*2lOh?eZW`yH%+;kI-P2!MPnDO-Xb!34)teH5UO@M_7GIN>yJqdyt;L(N
zugTt8%p;M7*~NLe>vIdO__y}z9Pwky$GTnDw8d4HGhS1Nwd*)~Tp8t~unV2*Jh6T`
zh8;A=1dhV&T2TD^qmox=a04-$vck>yI3~uG9Wd;6to;g(+c3+MEz9|wuzQI#<w%#1
zjw-u>S9c(}WE~smsU~I0J(waT7Zsfq)b8X(Vsy;Ph{`ISItV#0di1qajKUp5(EeNd
z6K*NxZ(q~b_*5$kJzu4q8AhY=6od?^l`wU+?%g%D)lBE92VTqZteLowbV5qYL^)l_
z*6X<_K$Io~PB51lJ;PRnP6)3zM~}V45BZ9uD*gx!A9x6CQq;TDZHgMATbdPhYq=_Q
zm(=V~WnABGhVyS{p!ar)_LYoNWacGmUQ|6)oy?xg2uZFcMNx;(8_c4i@!=}r8P)Jf
z*0GKXx;3t4Hy!H@OgP~%%bQ*Zsgg(minmPbLbp82&d4O4TQPuKs`HW(D91~$v<xWc
zY)TZZwet~K#x9s!Lk`U*Ohg8ygFvi=-&ucJkm16Tt1}6t)KvoUN=98pW~)!TzUBg7
zg`}T}7w(45d8%Mzjw&eJs<P#0W1-64aJ}MzY)*&VRU}QBh^84%9_!KdBPp3m13%+W
zOBGi`bwY(ykjhG!se{gO5}|Zkv1*2ADJQ*)&b7(>r0}zhpH#IW>pE5Np$%+w4I>e7
zy(-weMllLV<rbv!vy7h<ev*~6cbCxOLk%iHhQKqlmOj|PpClb7D^8G+S;{35Wc^OE
zC?k^07gXS>r%StI3Bzu<chvEcWOsRmHz6pWRMg8VLqB26DurRs4w*F6V^+o3oaz!)
zxtlfA$S8Pby-{?xdMefJ<@F5cr25FS-iqeE@^a#4XFaV1^6K%b25OPK^;MP2Rusub
zrkLSTNItHvGQTnClQF&Apv|Vt&=2#w^$2~?w|Z!zKUQS7IASjKgc4rfq=;ALRM~2s
zx<=)wTy?FwPUWffYJ=LS^40ZflPXY!YO~tHR3=;1ht!QGIy_`*_2mp0)w#Sm{rccc
z+)Vhotg4=Ba|PqEY2T(Pi8*Ykr*gsWDo-e(vdgtvs>&1}sY+F)ZdE&!Th*!$t9r#0
zSE@nXZnjFk<KFGxs6Tb-v}QIOx&+U%)1T)wGX`+c1^ru6;7wUpTu{fec`}^EC4(U;
zBGK$uR-U_Ixh{Mz*R|0VrZSqGte<eq(*p%^Z`@FjRGgA5H|4c*q8Z=7iPCk>`s_{e
zWpdJ5Jt33Ks+P^notv)PP~cr@m7tSTg3Cp@Wd+{kWVyVHy}S(0>&Y$4E-2xD{7Ws)
zmfs836=&ydxU#r-d(BQ=2u~?yK*bIo&ZBK`cXrC82c-XhIlg88$B!@N|M>AG{~tfT
z<^RWzFX{i6<15X+(%RLPGsz17f64z|XY{N8@#Cw?PW!(Y|0`bS2{`}wU#`m!@+|c0
zE<==NllFCSU`E$KP;qC{uS;fB#+j~&^Y<*_Oxiv5kF$SLLitDDKPh4SBk!M-5dM+(
zPww#l$onUE=>L)ZGj~{PQ~x;EU)aNcGx7&>hx>;+ez`-<^!$gr$DCIlZtgH_&OZMu
zoO--;atck)8`osz6&Lfu@#JL%x-Xu&RG7fpox7nRxj1<xUB!%EcFNPDH^>l$`s}>w
zl;tbJOx|_Q^{48!utKw)X^ubq{!#ayCalEf^v9RPpc7sbOXFU3m~97#zp{XKJ$Jd6
zdHChs9HG&aY$o=u-_4YF+4}3;iJx4VyMCu0xfc8dC*0n@>DDOwG1b2*!Y}9H$tqqS
zB9m;$shi^H0`W6p`zaf0XAqd3nqvFOxxvBjxcW}ows?k(W?DTMM=_Yw98vK2kaPF@
zTBDM(C-**EeY5A;>l-@$MmGbcr-vJqAf4akGJi~2`Nkdg+&|VRg>&?^>OM%jn|q4h
z(>xg<ZAQ;nCpvsDE2F|>1X9qF!SVM7_Fq<`_wnzvzVMy8y4@_$_beN<9+Ufsb=dN^
z|99)NRQo%n_Gg&o|HLwVYXYCErl8;Xb@XcU_o&a3<(v4u3FY61GAs1Im##K{kN!w(
zYEI08V)L2&|K!^Lc+a@+7(c(BJMQbmh5TgkQ^b##pHV)4JIZpc{2b<|;C<u1bbhXy
zKkl22t@w3*p5*5QKU?_uFh8=~%eVlU!XU8Opx<arOe<ypf;`NUyu5ggX^34fqi>ip
zF{G(ccc2DZ7PIq8ll4!y+lqe+Z+QJl;q!fa18->kNpJH0%lgk}|5J*kJLm5g`9xAk
z{G9jt&$07wX#F#Y{5QP*^W6XB;;fq8=N0{O4a_|Kzn=A<;}Am5@A<BO2B+W+um8>3
zf3xpzUi{nZe>3<0&5VCpxA~bieNNkb6?AV%EoNNG^!EePqC_?Ld^(t>-F~?4vt_#Z
zOF!w%{2;k*vsJpc&S$Ik-9s@Z^*p=pCT#!K|K;tw-u&$+ue1kBTXl;PDHzZ*nY^`{
z(ZOa^G%pZbZvSq*9$GgrzU~uaouV0>pDFimS;$DxH)juLuzx8j;VT{{5-08?Z%}s8
zb1d<jDq~Ica~HbWLCr6<*a{Rf3Y9OGaW<?fiiGE$WYPtF9k1`Yu&<Ce^Z1sX`zWN#
z`VF;F&tU(jOh59f&fo`I-i#FV2KP_bdF|`&e`)_hhc`^f9}B!I%y>`|?)eW}kkg+<
zyOl}I&exHcXAr-k`ya09E2TI!hgo0cRi~v4!6?mUmu8qUXR!S=xeN-JW-B>~r@!;f
zES-A&G|8Xq>OHUZFXzDzd6?IAo*S_<gD{@g_LF4}kMrC14A!5#!p=wRr^=I4t-R2B
za(t$d`TCA;g&CluH$o@Hxz1SVMrLw+NrBl%l2`bDf8)m{doqLVhh85k{_aPLU;3Eo
z*gC&s4vvBI-u{IA<@Mw$=Hew^nZa&PyMM1UM?0S)G9$W{PZ(a7n{V~GCa2^|%4euG
z^Dom%em>*6>~j#d`*uPcQ^vLzpX5x!Q%0T?&i-H~;VI+Vi%-&yim+wWa~Dz7Il@mY
zolP#}PTHf;56-dvnG`WXS2*FXbFcrLMT7}!4E@tue`p>sA$`2@d%O(E34fBqZa>^T
zIyuZennSU|Pg4djPM&y@?IJke*moAY0G=|boE;inlm2>R+n-zmSSB@q8SR*fPiy-V
zx|gKijs7OnGv&#q+l~Kp0BiY`)|^RGUwGD$TFWO-e~$`8i+}lCe}`AdHtg?LP!!6N
z8GG#hENdzM_jaLo!uNqKncuACQ<8&n$}G=18PU&JX6B(XZ4AjN@_m?f+2619KL~7Z
z*zC~jx&H+3qrHDC{m<lbU)S?#)z*jEo#3GQcPqTzeVHb6tLny)i4kXow3c5<nMLLz
z2#I@H#QHwudS79UN1p0?T{sRsKOy0l@lu6J8w%Z@kmZw?nGH(&j@>P+*AXU*2)Dl}
zblb{wmokxuS<}?32^W4@R{eH+f5UwrcK;;I-(mkIt|t8UL)*Y!Pa3p$HQf41i{(;M
zmpBOb{WS6G4?5lY83G@8j+^X^PX8o*o^)4cXe@@?zTAXm>NuUwS(P-GOtp@%;X}5+
z%idKhMTQbKyxH4&*|eQbLPG`q3L8GO3>{cF%x_`CuLv%KPrnyo!><fUKOrj!w|tsj
zT#EaXcQD-YVb1SzeSQO7v;LDDHhlQ=8+IKt3qSQa4jVqn>}W{DOg?n|i531z-D{N1
zqn59$okJe#C{D9_o;<0NT_q=5f689u7RcxwNvPKLQj+9;Wlg}~zjXw@PfnsMf2uq_
z_)x6%&7ck)94hep)Zvq@3hMN+IA!=Wdt$iIL}xD_()JwKok_o0%cmrpvJQnF`~I!t
zRmxH!tD2Y@*xQ>>M)YsTUjNi>ypzk9!AE4Te^N!j+Je3QY4(3o(BNYTT7PIo;Jnr!
z8Z^xMP5COD=gqvPpj2+<j_2P0se+oV*!#bd5l^P4A+%Ivf4{>2z1{m@4$%HSZSu4)
z`ZU<zoATez8dK2spI-ZVo75I>FJXtDP*bqK_J>ai9zYb70POIoq0?LVm$1IK+nD_8
zTbVmW0olK0^NSTe(8f5a4KOsoq~(L#Bw2LQ_aSY1lfPeSH}_eavBD=Wzkz4!c!1O2
z6dC$Gr+a4&?_~AIgT0ql_?3+R;>A7wVw(N6y?@Ee?eTCEGC_O)C49I7u)Tk2{&u$D
z+|_@4$t!dH3)l^D{(T7k#a>@f{U{~y`{o*%>%uin7HRLVeQ&t3!0R%Vx8xMAgz^UK
zi%Ah>?Zh<Umov=Ga|2VgPPd9_!ms37ValxO*Dy_Z$+z?z<F9l3%d+)U<<o`spD+Kt
zH7Nerf2jmp;iotU6Zb#Nz4?t4zwPwu-#@edW!6ruFZWi~x?We2!pfv4?thv+p?~rU
zIdN4rOt?Q?3{D+>r3t^;UFVr*1yhH&wx3lxUGOR5C!}mNUGv}+;U~oJG;5f+|5y66
zgOp|dU)S>-HP4}ki-w8e!=#@A@0I2D#G1jkR(%DB4?ki5r&&Yz@OE;WasHE%mg_&-
zX&Wf4?WH7zTb@kH`aU`Acx8^*{yrsSgmWNAwZ5l)%4)y~d=(sD$*F{wI^tS0ySP7l
z4D6pij4BE&QffC7r1+N#tkhn9g?&FcM+1w!JXHv0+NJ@*WHP4o894rxR&iv~7VYE9
z;vI$L?^Aux{YNSQGI?6~@=$2kz@+0zPTo*U{h)5Q?Bb-21Qwr3|IjpTs|;e8P;kz+
z8&~-%w9FM4-7vY;^Ss7AnC_i5GwR;?`yXHEI1K3}enUfGtn?7tJ~q>n$9c5V<N4H2
zLJuJ*F$C79pWFy)K@MFg=&#qaeLIOvP9aw7_v8d}KF#9(JT^k_r>QS6k%ikGm%LbB
zAC=7K_N&ax8}vIH^}9CB98I3YGTvvtDf{}(xto~pf@cnD<rVXUPSK%LLOxrjKU)#<
zS#py8aM_BKw6vrowQ3dHOG$V5SEXl)O_phk^^CJj^TZq(%!*UZV=>GT6DQN5E><@&
znVz>wzh*Bz#XtVvitps4HB8@EzgxFRY`U(hAo%G%bKK@6-Biu|v^P7lWrj_?i7M+=
z4qmdC*=$6AEiV%++v)MvR<n#A6Qd`=W);=~SsR)8M!!0mcfz}7CxrW_gILR#*D#$3
zvwfM@-pNd-dWx0VN^&)()n*FXdh@$XXTdyTW^eu5W6ly@!tS`CytIJnD`dLv`jUzY
zCSsRJW3Exh#<ltROfBl!!Rr^~U$`C8pUt-RNRHRR9Jfq+$jn<V=2h_@y}Z|8wsO`w
zJhi;yl<8mVJd<MIPA`F2aFz#t*GY!Gs939aCg^_~l9RLQT|294YB!Rsl2hgX*=3cr
z=CJ6W2>m`uzPG=d^}e@Uwg0EH)OXXAO3gjx8{+ra8&3J={A`wL##nTfpYrwd`M!!%
zzQg?eLu~)~EVbs=Q@&oT*m262*FQ_Oq8lH=Ry>5=_+Rq<FJ`HqyHEM{<NIn(`HthE
z+Ec!!r)H^-?K<V_!qnSN`7)lFrQF#4Z?n{oupi&oz<xbHOWlk6|9zI)iv##$jDC^j
zZ$IU8yfjOF8BflRP;a^8l&>W^Ld9SP`<sbH_%&?AA7DE^g@ZVZ<ER=>`C|TMmRf=t
zn2SaDX>7z_VLQHnhw&^9V)UJa$2g4Xo29PC49v$OEWt*s$9B9Q590wG#HVo_U&fe!
zouw|mi}09&Mc9mu_#n39VLXh_;UGFbLU_!_n4_~)3ua(D7U6zu#8GU=xlM$})i{W^
z;5Z(@7|v%uX5c6mVf05&`9?4a=WssrF&^u%ANR}mcuc<MyuK#i<E3|>^3~xQY{ODi
zoacwpfyXct=Y8yyZyRP~AMXD6Dc>l5`xB>p^L{x?4c*If_><3_@>SwDzr^~m_3Nj6
zhwu;{$K!Yw<GMJG0rn3wu^qSJVQj*SzH!ReiCeG_AHrdL8KZthygzcv7l+$02Tx-i
zF8C(f#Z25U-{Sx_<0y7u^wYD{QB1|u?o+<4xD6Yy3HRdDco;W*i}=TVIF2u24C#N)
zqr^MrVI!7eJKl|l@nIaq=WrZf!<b|2-?uq$cq0~J4>saBw&T40gvT{_62FO&zn-N=
zFcvp`=akQhmFU8Iuo*kC6Jrl>y<-~=VK+uT%k_h?IOj3KV?4SrADgibJ8?hu;t3qW
zS26N8EPs&jn1N2*g)VHtW_%nw@mcJ}sP7UU=V9b=_8Vi-g-*O5U3d_iaS%JP=yAeh
zBM#vgG4i*wR3FCT33TF$?-3pgu^I2iPCSIY_$&_L7)G9$r7k!`cwB)_tV0*JVKY97
zo%l5N;@iJZc+9~_^0&J%7VkqR-hG&S6g#mMpTrS7hI0mIsfZtPec@cp!#Z^1K5WJP
z*o||JaDC!EID&_9&hI!*jK{N>hqHe~cwC3AxD~r`7xv>G9Km1Voabh#xAhPnFTp&V
z{gYEZFUH^=d;kxkqnC7wTX7tBVa)IO9y9O>EW+d1h^0Rzp725J#X~qG-(%!S(lN&3
z{GSm|n1(L&Vl%d3C;l9J@ooP?cywYU_m6EDi(f=1{svt*w~z3cgq^qpd$9|nUYMo6
zhjDlcb8zmzk`Lhru?06{7dBxZ9>8II5~KdWdB->$#~e&ON_e~$Td)edum$_@VI0O@
zj2fDyp20YL>(2>~^RN<K*n)-qoG;vq{rF29!MI;=zPL}OV?5rE`FI%X@HDoe4@dDG
zPo455y*NubFdr+h4nK}<*oph`NgTlAIEsJ6=s%L)eo1)Tiusr`K)S$I+=D;CgBbIx
zQ@&&9#k05%=MA%ePm^EcaomPyu?gS%%qd?7I<W`0;7L4y>eMVXfDU{OGx5@6gvV9b
zgtuY`HewGR$CLO9s?+3aza~6x!Au;$ZTKQK;k;)FkJn-k_TouAf$9v${TssLYRtq#
zxD8KZ6Ta&>;V~9_@H#w+EvQB~-{`<+F%y^kmhiY4o6v(Dct7^wK|G0rsQ!ce-~{1u
zF=pac+=lmH6CTD6jQTgi<7zyKC8%EF{9q>T$8Go|Hetpf;cz?l;K%VKeihZ9SPmUH
zjG6e(-w_^HVH0|=1Al})IEE+jz0VPTl;cDPUiy2|H6~*vK7uXy1a{$3?87k}#>kUg
z7k}nD#5i1yIrtH*#QU)Yk7F0kf1dDo6AohyM!iftVjRALIk@r#!sE5rf^FD^zrsHJ
z0}f-v9|->!@{=L%^XSDw+=E_x6!&019>mjl45R-2ly3~{aqbx92291HScoYvQcl2p
z+>0N_L--^f#~1J{j^n)l<hcHL%9n;|xD~fx1NPuvd>RkoykWv)6OQ9PjCqCo31;9J
z7U8>3kq=`Qw&Pyx!4W)(SD)s*{dJbQ9vyfTGjR~N;pQ`(cifI0coKUsa)j{sK~!hS
zx6px|=)|9)3rDdTqyK|^7?ZFUFM5gmO#a3>f8&0S@mPX+=s`Dr7F+S#*p0uyejLXU
zockxjzdB1T#CUASeB3-ryy14-i}&Cm{5&4Vuj5(#DbD*Z(gCJn#Gi?GoR19{k9+YU
zJd8yzbN@j%MvjyJU@ZO|o%lO+;V3p^-Csy=_|zEb1z*51%zTCT`fu`i%tRM%Lk~9L
zL)d|X*n=1SmH0*ns@J&RpaUy06Ys}uco>`T1a{yE_TcQZgvWAJK9)xZK8~6AbKHjS
z{u|-(a_qpB*n{`uNj!q`=Gzz0fq%tJ%zTybxD}i51a{(U*o*J~FX9bv!N^$=Y9Gd7
z59Z)$ti;*lT&K7MyD;j%xi87zIEr}~9TB1GFbO|{`8a@e82uX8DW>2-EW%^hh-27}
zbKer7ZufDWU^^D!5p2YZ)M;NkI`A;&;2_rHI6jSWkr8SLbMO_c#AUNi`&zILyYO!8
z!yn-=j$_nYS$_oK(SbSGfR)&SE%?vag+IeSRBs_XreM?s5z2{ixD|8oZmh&^Y{8@0
zg(t8NPvJ1mizNKpBGe{~!)DCE2e1+!!4^D*UHBUIVa!_zkEs|H6``6i4j;fAd;u%*
zEVf|G1%$^W?87D;#``hq!U**Q#^Dg=p!02~eO}yxd+=dAh==ePp2RVn9d+6_mv(?#
zF%uhc8}7j-?8Xi}fjv0;!qYzWcFrF<umLmiFmA*A*@VM`*nux&4=#B7Y2Qh#Ks6^q
zy^0RJWe(x79k*dWHevKT2#=lEgHaa|9#^1x2kSuxc3>u^zLW6SgiY9oo%ka5Vs!Lr
z-w-BZ<VBokjKy8(#13@f5p2dm>_qi0!ecrP;ckq2XN39`#^FB9!9J|S6WD^07jwSw
z670iF9L7x;MSF`2<8T+|U>8>60CwXj_TvlhKJ6R9ruUroMZYUTJ&H;Ao%f#h?Vn3}
zpLg0<$lq@C;v={RkK;kC`KQyq<9Gzm;%hkX;s_N#|Fka+pTr_u^uE)+My$kkybBMb
zGlqD_+flun^Mnrk3ua>4`-yklhfR3brNkSyVK4p>hj7UUh<En44P&v+!Es~RWv6{^
z+=Z<;cLC`W6LAdlaqfE}R4Jz70o;nmumNAhy}06o>@RM^LHr4-OCr<-vFtC-!%W<a
z+wfD^gb!i|HZS5l;R85~k#VPebKcAO!+31QeB6t5IEZc7znFN&w=7}5u?WZTAkLc?
zp?-~NIQt6r8}qOMt8p(rgokhlkK^ok&J!l#yno{Qz%<;0Tk#||;Cm7XkGt^@K7+?G
zBa!g90q4z+P@lszd=-mu-crspuE%zC<6&&ZL3{wmaSUVL7ojdsI_=BAowyCZh)p;<
zne&Vvz+OzoA<V(Z7}61TBt)pz^`z^>2=&;_oR3xH1GjMg`F<rju?Ah(hRygWcH&X&
z#n*5M-(Adl-_P-3EZ&Mvd>makgw3e75gsqWUc3T_uo)vSWqFLns1m}X6J2;CHsdbr
z#8&LZ$8iXklycpEfbC-(dNBv@$4czO797Pc%qt^3VJQw{BSty6J~0j#xCoDFScyg0
zg7w&iZP<s;;xM+C6aF&N6~^Id%)$8;gvTY=g6-IauVEivvYqhg#Ha<VALDQj=HTO4
ziDTG;msAoS)3FbWa2VS#>Vw=rF%C~-4(3-89-FZR4`CNRjeU60t%S#TjEap=*J2#r
zgE_btEAeq`!Cvgb`8x=YUL3{_jJllb4dd_y%)vQs!s9w@!BXtPHtfTwYQkd@MlIxe
z!Z>^$bMVtOgvVE~6(6c4|HY@VA4hQnFRCLySVVq{@wfu>@RL}F4`LfeeVBY1x8eZa
zj-$8_qvME&dh&0)1@o~P>u|_JzKt1P@)JCQ$ME+!hKqNS4=yGhVJdzD3o&aK`2jwL
zd+{tD!Vla=et<9CPJV#iJID`~aGZ@?&-ku8$qz6Q8*vM^V-p_6JvfM6IF5%g<_hjl
zn1L^15k}rcc-)HZSdWLX4F~Zh9LJoGkPpX4(7sMSjK^>rUfx80g4bgQ-i1B*5T3-O
zkCJbYkE}xnx-b*>;5IytO*sE<&NrsxFy4q!<U6-x9PYy${2{jCGq@jzaRBFhjPr#3
z7`>GAg-Li8^YM~q&J(6$8|LDEyafla5l8Vsj82MB7k`}a_({yi`S%bWORx>Qa6b;>
z0KW4RgvU6HPUbqmB;4LYc<jMCY`T|pf)C(9d<2hSAC6(lCpph4oKH-{lURh&pCX=c
zHFjVT_TYXziBF+g7NPF_H1Ui}?jydi94qmH&#>Q^h5PXZJdT&Pk-qR+oR><zjA?in
zi!k!DY!@@I1Gi!i9><fY?q|Ep$uH4??U;#!xDD5Qj_|k@J8&2FVCEk3Wt{za&hrZ5
z3FEL0bMVVpi644^>l%l#8!P{r>l*)pBlv;6T-PhP4`DnW!8}a;0_74c#a3MSAmMQZ
z_G2NAU_H)BW4joS4`CiYjc#1>MZ#k`cH`~Xj}`5lZ~O#CUrBoY66YHq#(X@4b$Axr
zuznx$jt6i6<G)OJbYpZn*CQt31s#OPG_1oMY{R>8KkmT+d=f|T7)D<ep_YDy@aV>T
zd<g6C0Jh=7o#ZRnhsW^*p2f2`FN5>&HO@QUid*p{HemC^<O|q=hjG)_Iqw+R#eH~H
zg!(6RVj8+|3pQgDcH(!i7YA?%U&6@MoVRZf9$o0f*hdJDmDr5E*ojf!Bs{us2)i)y
zYPR1^czicHF&kZ2i_Lg9cH)!Riz7IMY2PAzCfDhsq&IY94t^CYaU5H)@Y|ekybJqr
z501$9I46tm_mf_*9`o>7bYshRh;K|k!1=<@;sAadNAVXJy@vh4B)s)8&KC|I<b2^P
z*oG^<OL%+;kKsj+bH4C)j9JTh#SHu{7U3n|BOk{MY{y&iFm~V|j^H>hI7E0S`7vhT
z6Ig_=Vk5?WpYYg(hp`U_@kJcR$R`M&&3Z5cbFc_6`T^lFAKP)$4+)RA9w9tF`eVXl
z+fN9;j_vdk9$&^HJoYof<HCO-Jnrk`et?%8C11q*eop>!4ab9-_#@ngasA{kn2sIT
zggrQnLwLb2INv$M3&!FBbmAboFzPAN3(m(*Ov7Hh7Kg9~BXcRYVJ!X(omlxx!s8Rz
zjQ!Y&zx@^aja#1PK8Dvm!}-3JeES&J7bgFj{l<K3!b<GG+pz~naR|ThEa~hz$}7Ji
zo#A@S!%v|b_hBnOj@|eQ_T#0;NvC-6Zwa3lq26(V@Oan15gxyXZXCl_OdcdW)?h#W
zD~{kRIA=Za@;k!gQq02!bYskOq*EOHJ?RuLI!QXmr8tUPF?s{{CCotQ^ITu}ecXeu
z;6YsW0_hvq;TYb9b2oB*{ek$x`*AA{U;|z-L^%mF@DSGHaXf%$aRBG#N2po<PI$Z)
zx8gm2Bs@NidvO>K;iabtk2!c2AH{jslRi%q9=G6Dd=wjS*BQd&VLXHpBZNl>p2ed7
zAp9oE4VZ?`mk5uS{)zCo3-{s}9>OJ~gvVR(EP8QX0r?-MVZ@&ak3HCcBe)lryi9n!
z5gQAsZ(%zQ|CQ?wQ_gbTVJVK|+`n<%ZKk}48Tjg}q(hwhU!+5fQfGXfxD|VG^sQ%n
zL-P3rXMB-c*nf=0RCMAk=)x9k#(mg{1K5j~y^Zkr1B|?Z^+pjM>(Pnb=)%{q88^M-
zjISHxqR;q_;gL(u_{MSdd(Ze{wvs+E15-bE##e+-#h&ps;+)IR_}Z})4`Ty*i^#9g
z<)Zwt@QiPecq+$nY{3}f;{;~lC>CMVB9<e3436Wq81o^%U&8+4YfD)l&P`%}F$FuZ
zCH0K2A5W}2;~T@5aqf+z)3h_bR7}M}eC{gt7soT%U!0r8{$dIaVrw?>bW?<SA?J)Q
z9$&>goS%Ef=f+joiqGLe%)FL(!WtaI`*1GD{VhzzA7LT-a4)XD?u_pcZouPs3!cTV
z;JllOFHFM)d1riEaXU6(H}1uC>j{qsa1bxpKs@0$Fy<D@5txCGZ6rQX<#W7v5w_zN
zJd96Wf5tbA&tp_E*XgD+zBs%RbFcy{@pIUM7ZjZFbzuhfVI2<R5Jqj|??S@k9?ZeV
zuoB0x1yeVZu5b(XV-t>G2hJ(sy25xoxP|z_XVHsiaSvX21M!XX@E8{17`}#cOF6!+
z#5cYl3o#G9cn|KuLwFF6;xT*<$1v(cgfAmrF%?}{h|xC^9xHGUHsC?*z+-q6$FTIK
zGd>6D+l!f)R>bjQK6c@!u@6_@%<-Zd=af@E$9O!7dH5>2G3^%87gl07c4I$g784#j
zaZUy0DU8Pv%){5vjSIFB4%guEDz0;!cPr_#g#E)?wsZa9jkmI&c=xU|zWw-g1ILB)
z?jSv3(VgTIJJ|k5IG=b=6YFtDsP}!8bopWOJ#4@<+>5Pv2+!akK6*F%=jA&7*cso+
zowQG)+QojL1G_L2|AgCcb~E|Z9pv{I*~s;Xv6zRg9MA38kH>HX=YE`c*v|b4<FOs{
za6h{7DQv|N?8bTb5FX=k1RHQpCE+k0AH_WEK{pO!E6)D}@q_Dd0NZdBAI50n_b?{m
zzE2S^_#8H1L@V)v@puUH@GQEqlK6ZUTTy+Q_2Z>DfU9v7pT<n$JMuo_2e)7oegZr2
zAok!<Jc+}oswsbchWN#=VJ7zDHcV+FJZ`}bti&GNhbQp}sv7nm9XRK+<hSTT7v7D{
zcmg|d9DDJLpX0pY7)I8TzV?t0;6cpC-(nq}!8Uvi_hZcGIbKZ1QOv{WI`VN$!XINk
z9>Y4E{Q%)H4)<dY4&XjKE8qV!>63I9gK5}~s-AKoI`C!8#MKWHAGimb@zO7HJa{ek
z;`eYEPqdS-dDvf!!%O#(J}?8_cq6u=8@sU!`|)`k!7-de`cL~Z$AMe04!zih_v3zi
z3<q#l2l0TLFq-S73zM)9^ReS0(iNV@y?D!4$;Yw2lk>{;vj;oyuh@&;uW?@RD;Rkj
z>Gxr-C;TQlG5_nFS3H2tctscSfLCKLUXMd~A4WE?y>Ac?co*j2UaZ86A0Z#X>#z$O
zu@8^pFt&b^c-$SKeu{DU{%*qKE_7qcw}?l~$8M~_e(b?fd=8^;C%s`3&VQ8nz&xx&
zH@4v;xF4Uu0o?R$(gi+;4)T>t_H*300bN*)&G=>P#K*7~pGPP8jt^a!_#KwR7Z0!;
zMnA@Kcpnbq(+4@eJIRN>OFn`XkF$Sx0PFBLwqeHi*gw1#2k>?r#V(A#i~Hjtjt?LH
zKH;$k>u}8zgvWzFAUys82k;Dz;)RC^{}IwXCgCnD#69T61GonV@F4ykkKsFh$o&g5
zac+~;6S@E4E-b`*(2L)~J@^|ui2sSl@WV$4k5A&fk8*us8ZP(|`5<Ov13rN5*wsUR
zgBSmp{03M2gmiT``3uJ4L+HfHUg8}e!Dj6K8S#$2|3bWD)Xzzmc)FkPA0s{fg7BF4
z6yY&(fbiIa&3FVm@$O#{9(!>}K7WSr&BV(w!sCMDgvasU5+1ux5FQ);jqrHw?+B0W
zID}7N<i|O`7>gG@M|ivnUAP{baR+wdC$Sd?a0t(0<UJAUZNDcxu0<!7pbK|mGkyX)
z@jtN-T_?$3@cS733C;^9;iBg`Z`gnhcm((23wQ|QUZ6aHNAWDi{DJe<LVNhXQ(nY}
zu?UZ1BSyc-dBX#E7$g74eI4I=ihT9n2=!5P;O8(C58yWZH8$ZNu>)Vl9=!N8=N)5F
zeUjrv2X4kp+>YC@9h>j~cHl7fpgKc%ycpG|IKLQ+FJTT|FhYKW>#zlDunSB7gLuQ6
zU*dYj2QaFY`#r|tOPGU~{E6@wIZAl^8+PHXFB2ZWio^I_jQTX~ZGRy=-ibN*8LY%!
zY{3)Qh0$Y#$LnzzZ^x+nD92$Oj$;lM|0m(`S!}_zuaF<&VeH4#ID+&4%6;WC+&3`~
z6VGy;q8s<%b9fM6{u}2D=e|lh`z+}n<N5o?IF6<NMf|l9kLbjG=)xn|jK9N9{1f(K
z(m3fBH((s=y9INw1}pIZwqPH2Vd{Ug-`M>c=?!~u-u=`UFb&`0BcDJgHefTh<HL9u
z2XGKaaU7%7h%e@IoS#`EJ|`|j7v^9yZpBXAj=lH*4&eYs?x8#uG2)BGx#+|=bm1m!
z#y0H4N3j<p-$Ho21S3CBxdCIb5}o)Q*5N3&VN~RZZ$GZX0o;Y7_yk5jK)k(m#FvBz
zFdql74qwGKoO1!;F$s@hJ{JBn`38FNFz&$-Jcv0_BfhzNxes9~?!!WyJDcUP`Ry!^
zV{=#@Z@q~1;<9&+_%gmgev4yl=W(3N`uZ^yFNtP3yb;H+1;+{3g)xMC7Ka|hca8Yw
ze35d^#Us9Wy!G89zC7$eHy*)OJd52pf9{B{AD?~Ch;Ia=FClz8_kWB>H|F7e=*B*5
z#naf0vF{~3rejPu`-3j_rw^NP3_J1Cd7M97jYD_~MzX(mVJz-LCmul;K8MZt8g}BP
z|3r9PgClIO6z6=2`!6QpI2K~eeBv21a1U1CAsoO#9K~^rejoe0kNw6>>_iv#Vlxh5
zCtegY;_Jf(9KpRf=gZVvF&<yQe9U`4+eJ6-!B#wokK=K4T*`Ja6Jt6U$AKC6N!*5G
z*o^Z&z;<y3_Tr5=gbf(^74l(>#V62-&!G#)u^Al>!sBY}#Znx?CX9TD@-4>VX>?-L
zWrWB1*o^hqiEY@658)8LijiMs{}vD)m!K2xMi+KqGakTBoc%$<V;l})I!1P~eT>D2
z(20ZS!k4faV`2%9IoOL8IE2j@`8DznjK!1a#F)zok2%<k71)W**ozO~5I&8O50joS
z7Go9?9@Ei<dDx6~*oocPi^p*YU%|+)a~&@tJT62h?n4)zz-GK4j_??Zy|@O4un;4=
z=s(3+d={M;v6%4az-C;HotTfk=*1!2kCES?{*1Ahv1G)TgFCSjTd)Nm!7iM41=l5B
zk0a>9Ige0&#CROTd`yTZzr##y!&2Oj19%KCOd!9(7@Ye}_779B8@J-WV*{SWy*NLS
z>kV6Q5Pyv0_zY%}KfHA*=^c}>3G=Z7Z^a&L!IStfs&CPsfDSx~nfMxR!<Zz(V+MBM
z7VJSUp2Yi+n}#}pvG^)Fac(m4jVaiS`Phkd*o&XUA?(7)Z?k=j#TU_uDuwWPDK=vU
zcH+(0i_hW^j$!0}>NCp-kDo#(My3)T7hp4f5j*kw*o!I436J?0`5nrA7>j>KCnl~S
zJg&lKya_w;cI?G_aR|STkq6j+jKyE06aRuPym%$yF$FuZ8T;@79L8RZdW`diarkG<
z!RR#78-4&=a20l85%%E@9L9Sw>LB}parjfr!9QRn&bpHD_yO#~RoI6&;V@QX)OX28
zF%BQW9PGnNd=XnPGM(_a0Q)c#hjAN5JszRHfN}T}%)#fe5`EZ$@4t%hcop{Hhj18g
z!>I2?sLx{@K888?E3CvnVGF(^gYX!SefR*5;6a>oi1^2N9Kt+&1>HDz757nGh~4PK
zek{Nd{5a0}KGzS%<1?6te?~XHWi{dPGVI1>*pJua2-f19C#Vl#Jbn)I@N4MC?_nz*
z#cmwNetZ>2aLLt#{{i_b#^a5chi-J^UD%3W!*2W@_T#fSg2OoHFzds3oRdj-ycFG-
zfvtEWcH>WQ0H4QER9TeIe#r8egc+ER8?X+aT0?$?7p^70!bLcM**J<Wj6TBs36t<B
z7GkQC{0bYf9q+@#*nxw11jlg@V}8Va6*F){Hu(;2!zR2BJFpvj@F<?dK~z0lC+o<!
zFb^})joa`DHsb(x;%nH8G1qY2Vme0tn0Uch{2V&*hv>pVY{ply6X)j;9@B9MJsA09
zg!&T3;<wR>PoWEcht2rTT*BjZ*o##-ge@5P6Y@Wd#bcO*f51w7&$Xm`ydJyIg?;!b
z9L6tUR4?UXjKdR{gJ-c4=Uqp5Y{f2o4Eyk>IE+IW^;7EUd88XG#yq?W-FP3iVn24{
zYuJyw)|2k=Bu4*?&oK#OHjr*G5$kXhw&AC7KYkep@BohD35@<1_7{`zl8uDNIIP1P
zunl+Ne%yltcmPLn0HgaT&tMYH$tOH6!8**rHmtz?*o*`C5RPIGM*l126->fW%*Tl9
z36BnJ!xY?)PCSM#jOizy3OL``yqWmI_$|a2R$w<i@FAAR^dizZ-hwf|V1I8Wo#XH=
zq!Uc3A{<t@DaYd8dae&Vxs&wq6!)i(bAE8>9?lOg_ypU-ZP<$Yup3WezkJ`q`9T-X
z`6cHc<M9XglFkNc@AxF;436VgoO_h(2~%;|rzmIOC$Rx9X{DTjpT|S!{51Q8+i)D4
zFy`l!=P?6&u?UB;5$D{;b&oN47@atXE*wWM=CNNtLpP3ME8hJX;sNKju{=JEkpr|N
zf0pCGqgaSV_p=?m2Rm>t_TWo6j9Wj)@&AhUIZVPAFdrlKaDFi!_h2&~#4bFBy*P$1
z;M}JvXMUde!FgDSb?C+Wa1Sngfa60a4q`Qq<AWIU4EgInlP}>Oti-3V1xK+9x9#P+
z#Jh1AU&g3o9RC-%uJL1-gI~i+jC_#r=)x|%4g2t39LDD{>epO{UnD%fjCr`Jop{D_
zY{lEK8-I!Y81p644gMaZpCue7VdOsI4U4c2zkzM&{xb1~AHiezSscStIQKW?%N@iU
zK7(8FMQp&cxEJ%kLb}3ZcoO$M#Cbl>_ZW+B|0>rPz8_t<6PvLeJ8@el$Bhr*Fb-hU
zZ#n-Mhw5v@8#=KPOR)vL*oB?ghfm@#p2VmV95=?{f`<u@8?X`&V=JD(Zp`^Q`3Zg$
zM{y5E{~PUNn1pk?h&OCUFFuNUaNRdZFZdh|;W$QeUEcHv+rw(C#MiI|qrb`i;=S01
zU&LXY+s*#|j(Eg4Y{DGehn08&Tkvn#g>U~B;jtNqu?M4`BOPKKUi2v8@mj3JDr~{8
zVHY05K71L6G4b1k|2_8)jKg~|2M=K-K8r1Q@qWT%GWKCL4r4n;ouqz^arg@6;CsG9
zcwB@n*nwR*h<!Nc0O4^7Mm<lyiE(%j=HSCviM`l@mpsP#!c^?XO*n#eIOhfG-x!aN
zU>?RE<T}A@Y{etkjf2>a^S?`YEXFy1ApKxGIv*#0z#8=8gSZC|;Xyo#$8Z?O@PhAg
zoeYt$U@ES_LM%itR^T3N#)J6K|D))R<GQ-a27uqmPh^fca?Hq)kuk>{Epp5;V@5{C
zj20Og`I3>5V@5`f85vv5$e3eBiy2$A*kZ;O898#~*kX<uGcqz-WVA8I9CN6MXk_Gl
zzy9_80Qb4)oaa2xxfceL{cPt14>A4?`^R)n>k!W*mUAiVna6f+U_T$?1fOR7QS)Lt
zlYggAxr`MoVgv7H2k++qf5}O{#Dq6pw|6wmU?&TBlod>VMm)3G!8IIUB`3L?2_w!M
zX7GP3;FX=?c@rD>Id<?)4se81Jj=wly!Sop`NPdD<dWZeF0ho1{5CuJFbDZ8r}$?k
z9&=tYlOYTF?k@36V<Y?6$(ZNG^A!efJ1_Tn@8oJ`v5rOD&nix_iJ32WE^#%7Sju2j
zUYW!?W^sSFc#g4(t6mh(UUu<3hc0}6zxd<c*Z&}%#mwT9EMgC<c$Q6U>k-dwFNx<7
z1}E&>0rA|yEFNSLhgrq>e-zIlb}_!!xqMRpFq?HOX7rz&%gkXjH?y02m^&s9EM>+)
z{lp@+@=5k`jHA5!&-&?<^MI+0^f@0djLV4oC13cMI~eQw0j4tMFUE2G!z|~uhwK}d
zvXglnWDBSGXC{vOxy4_tn~$@IPqT`b^;<U=vy1=XFmL#qd7PGSCUXn3`5cS+FIMwi
zFUtdS*v)ku=3|UZI4_vYA!c)&#f<yAcwWb5X0e-VILul`&ge5H^BA)^cR(EL*vx;i
zo4x-K$NqnbJL~y+L>w0!bxtymB^-OxImtC6&RO=dhYQ|v&hlx-{M+{>OyT4)@yvN!
zJioyjKFk(Q8x_xPj_@dBCS8AAJX@H<LoDH!Pv~oI<Rq(@@E`ML2G6m8&z`ieJi|^V
zjoDW&;S@JA@tpTEX0nBa+`~%tv5~(xC7xX@mY<Yy?=!~jVh1N#>3(xhyT9uS&&c0@
z-Ji+q`L}vwFr}`U%v$a|Z~Q6s8mcRPo$WrqYufQ}fLo)Ehf{1|v9IrEHP15nf1Xc~
z<6$<pv4l;m;i~D!!_xECGxK;@&!v|i4?DS*gIqWFc$gnV1^tYTjtV|-<?*oDeGAxq
z;r<+ETH^6A;(n!UVJ&;Ohod~gSofRu?&D!9XET?njD+&aWDZ~WJkPR}E9M;!Yxx_t
zb3@Ycu%8ceg8yQ?`HjE#c$m(m^N)uWtYafzVHYoZ-|=vWg$yo=3g#sr50m&RvpLRU
z=3XT)+{_k6FR%_)Tzxzo;RB4B78Ud`g=d+=gcNz@D%LRZ8u47i9u{3Io)xL$qoRV&
z4~XX@9~93;i^MayUObPai)Z=`;#t5ERx&0M73^aQix-RM9+vQh4EbW#O~=Dl7O<BM
z9Ay_{r$+_tOY8%G{UQ102uryxQ#^mbR`#)%i*FXsT&AgmHOylp%h=0$&RlArn8bdr
z`G|eu@bcqf;*6+Z<;RbQS*&6a+gQy$4s%Y9dWeY%Qkl#xYt$d(i;stu7d~dQ>pIxY
zgKYBoDRwdSEAGS9j9eTQlrfn@>+CZ#ZnsYEWF7n2#>jf}<q}RXkMT3D_YUK8_npRP
z)3=Pzk8PG0=5v&58GDI+U@AZMZE=jLRFB-mM)t6a6HJPY3TE9UA1q=qD_PAQY-TgN
z`5e=Y^DhpGKgq!7r`>J6Ok?Cy_hB+mFqe_<STD!7*dO+6)z@77eSOYi2D74q$C$)J
zEM`NEI=JvLTY25R*30_)<cCi){<5fGL9M*{IFlJZUe5wP%tjX7Z~hlP<}l}MH_tfh
ztdl4HjJcfkL;3afWS04OCF{6_?R<>s@34=|=UJAs^ugm{=Ip58b4@;;6BX=dzw3{3
zg3*tfr|TB5k;~c1jU40yoZ@3lbe~QZbA;85dCWd=HGB9NM>)XQ%k}Het%C*3Wj#wd
z#9F2`%OA_w%a=LIQO3qc1u2h<=grJz9!puqT0X{B?q)AXIm+{ly+Xb36wd?9W5zG!
zf!|;~tJ%)O?B{t-FsVge<ZBVrS;Ks`vVqUAgU30*cRq1Eoa8l3c&BrM8Ej+$TUo)T
zR{hAizf$M?2#0t#g9P(r68G*>H$2Z`-tcSr=5{voD0>*!=G^0a#=I*kSjH5VFo!!>
z!d})e;Wy4r-pU?+gCji5n7Q)D6fW8=o)5E>9jxVXwlel9`DQXlxtOt6S|`)^m3Hf9
z7b`f*2FCqX-gp%U_%%-QNhTz^o*6vP0$#UAJ#w7GOzhGh?^gFO+E<RT(&wZ1t6wf+
zp3hgYjBTvvD{SWk`?>TF_L<Xq?ejeK&vbVE`FL2!>-vs|RoupAcCecxOn#4k{)_!!
zD_eMsJ)C<;KAFanB=<e6Pr2it&Qb1VAEO4<!BzT<!|wY4BjR>5n}aN7^uO%Oh5Imt
z%bCM<9ODle_g?29(|C^gT=0rI=W^DwfgK#;AX8t}*Q{jXe0|MK&L6UVX0Vd0*vMLT
zvYmqrUK7teCce-61T%S-g^WESo~dl)8g{abgM64%jDB5wviUNT1uSF<EBP23+0ITL
z;UFW!;yH(j@|ey{9%2zESjFf!>>KBBm<t(M5Eb0SWPX*|+`(c#&1$~HW=0<s&rA+8
zmyxTZg6y}{AHT|6{(`04&sxqtrcXHSZTrpT9OGS#OL5LIjn|FZFBY(z>silx+0GXB
z^B^ZU#rSK~`Em8iyP3~+mh<nd=NYzh%?a@=;{^9GexdifllqLAEZ{d-!SAwxkFkS$
zIlx{{a@m-CUmF$tm)Tr(O5V7I)!fNuKErNCjmsOe7)f<Kn>or}PCM=V;E^fwdcS=C
z&$?KD$%(L-qnDltYZ*7|MA*w_PVgzlUl$cT&vagK*@-Zp&8*~YaVNqi{*B$7`;HUg
zFqbp(fvBK}$$XsI>|!wwvzjAp=Cs+aGrzUWW;=_y^m5m+fUV{;#ctOxi8l_{Gm@t7
zn9N<w=Ef_;^9ysWi@j{)IreekmDa~1#(&Uz5%c-Tyc1y+XTA4C7`sT{GTq0GY~ge4
z;pOvBgri)*G}q-bkJT*aKGrkgeJ8>WuHpc<a*~ZqxL#ddbt25*%U7QWi?}c4L|DVO
z7upA|zSg*`<^-3eo(L1u<?%Y}<jXAPk{jfSTW^*pZvU8dayQ5LyIbtj;;7*274mkY
zI%2{N>W>-R#{!PAk~yC^5jJuiJGqU6Y~d99ndpAYa!-U={5FfYomFgQH+wnEql_50
z=#%#8!uZVQ4_VA#vzmWmGv8)6&od@N|J-^aOkpW=xi0U7zZZ9&uasxDu$}upE6?1v
z_Cy%mq#l^W^e>+Xb6CI<KFS(iRxDp!&ptMAj6IBBBK|8U!c2CvkPFw#4-@V%PtL#7
zJh`01?D?j;`H<&yg}UGa%x53V8GP$R*v~nf;Mf*<%=F&1)%Z*0jrBgikL?_0wy(#2
zU!J&()qIl8Jj-q_uQ5KiGIF!`LMAi%Uh!;X372fs4}5^FJjPxwyiYwdm$BxthN&!P
zF8|0<#?^}FCbsgk_ge?=WBi9NykF}VK2RrLY-c6+vypRtcp~g#^aJM06^vv>1@|zS
zhndY$7Bl-t_KA0~g+E{q&vTT?_2&DLsNfS!<vq;hpIFLi51KFE$5wuYy*$WK4l#C_
zdf#EcxQ==J3CsA7AKMQeU?;C?&<9+}DQ;roN3EZk{3{C?_mFjS0UKG&PS$gfgY-X9
z3#ORFTOYPwHnW<0+02AT>@R=RZ2rrw=W+S*@qCVQ8Dl@Du9?b1%;f}2xn`&Jvx%+T
z$6gL_^upI$#Jg`9Q@NA5jDA8q6IjcI>|-X!xQB5cHxAR7{G>c_KRda$%{uwSZh2zD
zQ~H3{v7D=zlp`O^;tMS1IIB6YT|M05y@%P{!eX|wnn&5pgx|^!S8$k>jI7YNOy&@?
zIeU+IX0w``*vuAo^Du`Q`?UB^c<wNnWo%~Cg^zPR7k(!{{2)vD25Y%<ul#*7DtK4F
zb+YJX`_H!-|0(tNcYX31<1#%zD)`>OiLhZ+RB)Qj1@`qH=D}+@%o-+t-t(PhYt-#O
z&HJlS!IxiApQYBxW_fym-Q3M#9%4iu#+hy2vtPAtE@CxTvYQ(@%$<yw|6#WB9D6x;
zNPV!3vDWbjo7vB92Cs={5+k>|A5-{4<}l-kd9#>xtY#aJvY(4ymk(}Xy8N^;pPPnH
z_`7rOiELo>8=jxs$^o`<lK)^ro_QYi{Nhp;FrO7%&jvQIlYJcIIR>BB$8V}Xu3#3+
zSj0M3v5if9h24x9IT4O9g)u8Vmzl!#%waQ2xQ{g)VhiKma$fOPj<ABU>fi{|Sar<0
z*~D@lV*Q1$vz>`=%NLh2UfndZfV)`1>7&-k)$HT}4zl;Sb$(X<PnajWnZt`tnkR2$
z4VSZp8^-lFhdIHV)AFl6?`8(uSinJ6aQ1}p_+Ab&pHtk%#Lwv~W^z9ZIlxNJIO9Cz
zyV%K99OO<;agd4Xf0UUVo>ad)&1zotAN8g$zQSx)u$belX6ZR~%I)lC6Nfp*nAO(%
zUwz8kn9Faml;f;rWJ({fhW$Lx;Q#y_>wo%@SDiO5?`ARUSj`c(aCT_FnZ*&VWK5xb
zW(u2_!@Vrw5!Udc;AGgsB=&GAN4SkKU+`YQ6gFOTGR)-&OPM<DWLV2Dvz49f<w1^e
zLDb1G&iRqYG=7tL{2uGrz&0LaABQ-`amIboITkq?rgJOv`5enR%6iV9ell$52KKX=
z6Z`|?i=u*4OlM-Wc&4(PpJP4mWIOBG&tsfo+>Dc9;+NDZGx-%3@+Yk1n`~ra%*n8m
zALby7IK>B<xK^H+$(0w2XE7_;&PFEAJQ;Rz35WP~249W}e#s<`FpDvloD7RNpH<9a
z6W6edKjsjhWKitqH%#KHSn(`j5qGhQb1pp@HZz^wyq&{*g^{m#FJLm`XPpeQxq!uN
zWDP%inSJAJ?BiCBv4L^x{2Ya8`~&m&50-I~b(|9?o+a$(R!;B{#^0vjna&08I2ji3
zRaSAyZ0qJac5xer*hGIc6a1G+{OIM@%~dSoH(AAPY~nDx`Qdo$W+@}L>nA4jac1*4
zi@ETMlVLS)V>7?SZZ>e32N_v!d?xeKIpVp3#oWPa{*ui+z;2%4Fr(fn{;SS2CNrJc
zT+3oUz-IQdn~?-@%w<fe`eiD|8UHoUwfE>#j<A$#7N~d5OHuD!%zox_f*TmW!FhJA
zytAA69A`O`Q^j*7+gZ(izIB~Czf(Vbz;(udlJz{mb{=CtXQmm43oj^c7306|dCPS6
zuz+zN)E`V^BlFnF%^cz|BW0eui{y#xn9V&b=2=#=@Ot^;Ms~A~!`#itH}q4w^NeZC
zVJS<vjWrx$3kz;=9&(IhELyC-H>zW1FyTh?<_cDDH5*vZ4({Xt`#H&(87ISpJ3Pmk
z!R0Jq0V`O+1~#yR=WY_u8<vP?4in0~$1syIA9Aj6E-P8aM%J^FdpO8Bna(9{VwU~-
z9*g)it9XP>yy#|q#Uu`KDT7V=lgT{D9L`y)u9(7Feub_4348e@NBQVS?DIFHg5NWp
ze_=jXEK@HmWIbPIJO9UiF8QcB;a3=65fyxw>3od&+{bdpXUi8Cu!H#=U^yqbpNZe{
z{AVVkKPF#Xz)DuIiQCx44h}K0+`2dW{({NO__#Xb*ICRSRx>F_op1$vSi%u*X3V#J
zKgtyDWe)pU!g1Cx?iTS(V-IiV2<sVB={dm^9%l{{R)}W?YxoVeu#r6+=NJ<{p-%5o
zUrb{q^Vq{Oo@X83o9i5A7W?=qj`2&3yW4vM)A$4C@p+c<JnMMrC&lx_>|-Uzcpu}w
z6BRtmG@fG~ufJ71m$Q!dvW?^HW8_ofxq@+3`jzSIV?L+n*>}E^^<2nyewzI(<^;dX
z_<Pg~)A<tfImmMUm-U?cY4Q9B`}rA8a3kZlI0u=*BP`%KRxoy@y5kmh@<X3-zVKE?
zzU%#yDU8auZ%kte^I5~&*}~oI;Rr`~#b@n%wR4s!+{7H#GWC1vh`EeirT@5wwcJ>2
z9xS;{zcb}_{m%KD)$dmI&up%^OZ~FtJL;E>_c$lHpWPheFz0Tuj_;c{lbOqGZelTy
zu$r;o70(mw=B#S*T*gR^^O&hj`JQ=mHA`8`S~jzlFSD03w>meN$=G{6m)Oh5_vL?^
zeqs~TYUF2oRPZ7jexR?|!6O{t;(PT!3z<+C6})GgI9|stW^#yi41Vb6CQRav`|J-N
zXA7TV4`<ZcAFg1`1M2>M^-=Hrjp<y-eBRA+HnX0$ZFj#1{d}6SJ6!(*`Ctxnxt67T
zg0<{s{*R-AOX}Q*i&@V+w)4mA=WaGOL<Rq0CzF3@-?@}i{2mh@@?Lb|W4?Le<A;5J
z@PKoWsVw9jtmJl%{X|_buF-RYY3yUhPd&$3z)4nc_K!R_9&sNwaS6Ma&mnGL@H6KD
zlemMW>Ua-p`7&F1mc5))Z{N9?vFdgeQ|<dE=JGL?avy7Xf~}nUpnhc@<JHARrgJ~5
zIK>{O@34Pd#hCkiAHfvP{IUMxYL@U})-Y(W|D3}f-pUbfWlXI+F@;0SVeCWVS;`uA
zvxRXFi)Rr>*u<FoJ%@fGo{7w12}{_)8cwo>YZ}F~oFi;yjJi+!sq>VLEMx2=&QmtC
zgYiGp2TbQA*D*mqY-I*JSik{RaAuRb&<}|$<X%>>m)Yw66&ADdQTw9)`<cts$LtGB
zS<CHgWfOb(97nnE=l1nS^2k({GMC#~$|lxwA6wbaUY0i7U-q&?KVAH|b@9WT<gHB5
zU&~s&*YGe)xa0}<;R^P0HAi{-h0p7=Z(sO4J1%^lCm5@*&NG$ct;S{KSL#YXeT3=!
zCiA(K<=osRZ~Ci|h1|tTzQ9IC{YHQC3J!8R8}(b$h0k-&Zu`pUr;M-vRxp+KFqel}
z%0=z=mxXNO2KI4;dHOW{x9Wh&dz=?6VLN}ueok_Nc~8ri{@u(5?q>)0beJE{af%=O
zo%2E;Z(}Bpu!ymH<yk*BvxEm&!&7YGd!A9R{47WKC}W!RJ5zX$IZW#m&sD79U2Nem
z*~8a3!uLNb{!!;7Q@E8m>|_a#u!a{uC!RO5hhO6ef5(`|>@QO|`}g8`Jxkcg8t!5X
zC)mTnE_K1pjQzRqN14jF=j{tOvy`>0<sr6m$v*qS0*>*1#x*<Vn8uhF>=$ok8TYWB
z{cPvO-S&$qoM0B?ANM}MboQ`-_q?b-`6D(lcE9tN3pvDP40bw?nZyIk=6C;K-h7O;
z+{;$>vX{$x%$xsZ!Y}O4OU?^!VF7otg3qvlQ3uoy*KmN_ILTd1Xwe7E;3a<)&vmTe
z18m?PcJPlJ;N`vIc@-0$u<y*^&sf0Stl$V6c-5c8b1etBi<9hT!jt;ppm;7}0YAkG
zeu)h{%ueq8i~Z)zf6DhSou99%dp59;yN-C@;UJrN>FfG<m-CR_K5pVLUtpxw_h(Gz
zSBKRLx3iS{S<AQC%D6Y=omCv=7-N5>PmiiMwlSA~VJTl{Ezh!*32%yL8z=bj5q)c3
zpJyfyv5>>8<eIn4mjk1&XZ3OG{k6V2?|Po|e?lo@+O)B-iXD-$u!YCi!-VN$;RshS
zrp@<HOyT3KeoEe=$HE*RXRw5Ytl@Xq!e;hxKSwxs##k8p8}DOGWjS;C5KGy~T28Q)
z?}`}<dzr~mwla3N=hnsIS<76GvXr?q#j};IJjh;-ag?(!5pUj4GM&p}$HGGXgDrfU
zJuJS|e7T7+?SAi&DZFTw^>Q;yS$Nr4*ubrEV__F3IL!EWjD_95RTo!|g%ixVdMr%b
z<9U-Z7G^W;nz68$Ygx@vws2<ZSQy_a&y0xM&SbVRn|&<i7^|7~{;{x`tJy35ZjSO1
z#y;(N%v6prkMY-yg=JjIdhTF5pJP8qIKk)-m`8{8F_Tp+<O8f^4;z`5HWqfWiGzHO
zQ+$Jozw;boCa?RTc&=n6ce9bNu#@LG$h1Y`xsHi@os-PsrPr%dCb5duZ02L^=07>i
z6O26L`I#<n>|+j7Zcv}BVhy|4!h*$PVIMbfjPW;)g&Fd{fCX$~1-sb5!|dQ&9N^lF
zv2c>rOnBCFkC_}{A+Ng0dij5B<a%~;ZKnCMnvv)11C!aoZ2p7Ae4Euwx!HPI!EWy2
zFrQ=O_s-QU`^*=a%hy@Tv#e#_N5;Z7HnNYk%j`4z7~kdlosa4V7BQb4tl$wgFvzxU
z=5l}=ILS31vro_KCuZ^l3whOY>*n2TWF0#>!XeK7_*fY1v)@eOI%ct+Mcm6Oj<AXI
za`YG1bBIk0UU2?0iAR{lj9ct8*RY1QY~eokaMlWa&1}YW`+kin+{zq2!4l5?gm@;i
zh3nbFLmcH8V_&q+TzO|Ub9om_S;t!bm95PDr2gcs9A!OY_xpZ@X`Fkj{^X}v#xJps
zRcvDe`}icsnDi<8_6K#sOpdaUOY`K7g=}IuySSA@oMNOWD){ZE&6{y6&6}AlWf5z6
zCtLX}d)dcPF8s`xzwh?_Ceyf^d3>2=e4BN=KHt1q#y;-k82`$+1IGQVcrIWbSFnsl
z?B}*s&H-i>=!-w9x7Fs!#=^0%oc(Lm)dh>Jk6&A7ygzwfvtHa3+nIQq{r2@7#`OAr
zk*RE9E_+$ZW31(Z66<C*ds)m;?qIC@_cE2QFqf6Ln>P=!juY%>WWE04`xt-F&vTj1
zjm+mhmUEKzjQOhhGW?ozkn=WJKUXmE&&FpaJ6On;uiIx%u!$LE^1!cih&>GYoL5ZZ
zqHj1?Sjb{-W;GvXGuzqCnH#N_X^j1gK4L2Cnad%Ta?Ty{#hcj50`{_mqkNRHhuoK`
z{5Nx1R4$$yS<4Q#GU-lr!lfMJ9gO>{x@8&%n9s8;=d4Zg#w50L2M746Z(4W1^OZ^L
zWH#SfVcpDTHA~pcyV%YB9Oe`wfAjm^-%@v6$82t6F`HP;E_M(2`9+oW{lh*mp9{Y0
z++_Oq?ccvVpBVd==Np^FrPhe!Dh_imBQHBQnasua8jqDM=B3+=$5m|RR(A6khZ%dH
z_`iF;GMR<U<{=hyTCI34W;2`E&6xYeb0H(vv4_cQ-Y%ZqEaot)ne+qkEaWIF8Ec)5
zY~ml-#lsw8T%CP5?0P1#m028R5m)|D{j!8jtY;S^4~S>%kId_z>X6B7W;VN7%wbk@
zcD?hNne62QoZxQ854w)&-14C3Ih$F*J#661?BMJj>W7;+$yb<Q|7QKz`v5nwfK9C6
zjt1us_py_c9AxH0*87Uz4`UX;z#=}(D)zC7L+s)}qw|R)jCs{_`lp^p9B9%noMb6y
zKdN6?%r>^Mk4=wRFNYaF6ct?gbL(X}^V!P^o@E2?Y_?t|K5o8@-D#g*bIvk}SN}qu
zd5|R>VGaMy7S3$(9Aq&^xs9<$qWn8B`hc%8msdPt-ux14xr43z9eeo}M>+JQK7U=_
zeyPv7o_XBMa(=1Ryjk!odFFNw@)=Gsd6)BXSbZ~-l`P~it2ph~^35CB#oIW<K}OzC
zr)}zs*D;$}Eap~Lvw_Ww{*85WF-MrX+q#eHZ>I4@=5d&1oMIhkJ!QXG&3@k8Zr)t*
zTls#|dB-f~v54Pe6@S7e{*hhG+M{3j!Kc;9i1!+%u!A`qWC>5PhBtNCFE+A=cl}Pj
zxtD3qqdxYt^BMKSrkCXLnE4)1H$F~cITy2@xoqcJ7Q623pX7&24$2R2WjEJxnEM!c
z+x`A5zf5K})7i}`j_}Es?f<CzF`bcr*gtl&nj2qt{|jGd51$+s$2D)r!*O+b+Islp
zg#0sY+NrRDbE8g$4P3(xZj3$^4zPxke1r)noD<Ao*^E=+*vSjO?{O+@8}mG1)`Xu=
z#GLYX#Lf>k^Uv(z(u+@pxo4egOq`TgX7X>W<oz>Gg^hgoC8xqprgD%U=M+OG{>Oi3
zi*>*MdXM1<e{t!lFm+15Uv?_Y=T?^UkF4h-an{3&XP*j(co&O8&-cqu`S**Rf9&F`
z9OjHGPKA*m61>0`&Y5#6?B%=PX}vtexQimeqJ&dn8o$GQ{^DK6<(KCgmwVX3XRkaJ
zHbq5(h3__Bes-SEM<PKn2UyKX?qkCANbrFqdF1N%p7QVgMuHO7u!b$%&-fXU;Qh(+
z!}<m09TN$jV&vjTFh4~cKf)TeU1R<nXWYz4aQ#B_=5}VQyLJ|<tA18<g3XM-_EcD4
zpR-uOA~syue|GX5hnSpdTy?OWDI8`V&$5iE?>`mRv4U;vVIPk&PTl<S1Lng~=5b}3
zIF_)ETiM4Bj&YE2r_}ui#W9(A%w`!ku$}|#;Iu{Z#MPW)1rx`eQ_SQ67V<DF8GpSx
z<N|gwpM%`SDYh{2w0dVI2Uy7Hbn*N!8@ZC5+`&Pn-*74n^ua17v7FW1$`S5n%o*nl
zQ+R?o3>Mo@CbNb`Y~c>}FmmImaFjPQR)6I&l^a;byI99xvyF$@$NzAQ2^sSFZ|4@%
zSi^ii%yRyn^}O_^Q(-$3+0Xb)`QQyK)SsJ~sXrgS@G;w2$wO@97(2QCX8B+(r}z{T
z&-pqtdF4{^yor_k92>cwo$Tfi<322(`aj4z<?rD=ub9m`7ITC(oc$5`Vj5%h{|*NK
z^Yb_+@dak_H5M^s72mN;-!hF|%;ON(GdM3#OyW*vagarv`BCvqV-we~i}f7h5CiAT
zoNV#DiCHXQ6Q5_Yb7tDdtcMF&%uTG}K@K`sMmfcq%jIucBuHT<Z)72FVI@o0$otsI
z2@W#)<KmgiMCVdFvv`O_oRMQ4yox<s$2jNIHm31U%;T#p<E^)-6F$Qp=hUA#!nYX{
z9SJU8p{{u)bGU>hT*(?1vxSG*%O8E>l)nd$1dlV*IrnE4a*UO{D%ZMr8#_6~h;wk9
z$&7qb{`f@}vzFCtV>4f5H)q{yUe3o1=CF~iJj_vMe@Z_%FF((6ewFn+z;?EM&N?~g
z|J2tdk)VmGJj7gfeNlcmcdhf2OWDEB67|4&x2uELNN`=L@p<TLr@~U6V=d!0$oHj@
zpqVkVobycK^UUEDUzbNVvyQiwnHT@Ygv*Tk4bN*XX90^?!N=LaE_U!R2ROn>PTQzX
zjlY1cyoJ3i<tX<t&b$`g;l4b`DqdHvj`=BeaV>}V9}bw;C3m_%tC<)V34YGh*^wZq
zlxMzjm-(^(JLbpuD)VC+2e^s}mq&ud-&3#L#3DYxDt54m4cpWq*WT}(V|AUl_(-tx
zN8;GCL*97oA$j9eqj5N|$$XjhbNRkP{7(7jTP$GNFO0)~vxRrJI8QnK3F~4llje92
zXtO`u_q6--t!LezSG?%{Ja)kS-x=}m@7Ygo?sGjG{%T(Q&ENF}?>KB6*06_p|59(f
zi!lk2;7O)%&a3+5U6G)bg>yasht%Dbu4f(Bu#LOf$NzAQov-PqcSnLhvXTE_C*Oa>
zIl*#H@y6HXd7ipqH7D7^Im70|G{(Hg{xF3vF^@CeI2EQRd7ohcD_Fq?*uV~U@Y<vD
z!u3pkul-^+A7RXV*D-~M7<-lZy=i^?D$}lYJu}r)0}I*0N<PCz9%Lu$N4zgx_&Ou+
zhy*cj8IQA$=~rg5lp9#f7Pd0xZS~J=j&dDi)nhFu*~&8edYC!(BW~0_atUi$%r<Uk
zKRY<dBTTe!bB{Zxn9FKbvYFK<jLTgd<2z4!|Fgdfna(O!^GUWa7_+}z%rTZS&OSfJ
zG!8J2vrf5BqJCf|2U*B-tYpHtym28rxt@c3m{UB!M0F8$T0G~lkgJ)b9_pCIzp{r%
zS*9LhCe$OZW*e8YkHsA07RITAeg^h`!5Mksr&-Ofvzgo3%{C5m=2>}HABimCCf0HX
zTiM259^@!T8T&qQ|91W`i@DsyQZ}=ePqCFRvX`%Ol+z}~Cwp!%m4(dZW|r~^*76y)
z@-TaOoTCi>V?WgIb<E=$)^YAR=QlTSfX{J~BTQW2dHG*?WeZFA3TrsU7S5fLZ>DmD
zs~K~(=QdNgmpMGm5=Q?|JXf%Vx3h;e9N|vJq(p*lrf|-A>*PmR$}h5(ce9mE?BzL*
zac*couZaZdOyf%Cv5aNh&N_Cpjelhy-{2Virb!sL(DyY=<L8*i+gZjM*6}B7<1Y4b
z+C}5x7?T<2d|1wWu3~v=B)F3$H#q-T!@1MO!xnB}563vd(J1kY^=riV?3q3u7VuQ`
zxWA*-k2A*o-L7+iU94x(jjm%A$1i-HNin|84{?Zz7mtTY8OCQ8BQwP@pH+N-O>AWs
z(=HLm90oVZFH^ZJc0A1GHkPuNwY>b&aep@(30`JDubVX<PH^#M<6-d<_hk+H*upt+
z*3IiU!hFVjNIf%!rSFh;w$2_8E7*DYc-YL!`0=opyEw`o#%4x>*O<yZSB!`0d66J?
zj{GzGo#SC8^R5)nlzHNLkfUr&8V}<?t#9X#hnXx+Heaq-U|lR>E34VdHjb`z{ny9C
z#Lq;6^UUPtvhlEx2U*DpHgfhi#=}mgagar<{;Yi8>Aq}XFQ4Nm`x(2+^O~s)Hpw^B
zS;}12vY4%`WH0ME%3X~8ocd-eUtun1e^We5Sj)TF%0~8bFGtzO*aH2}RGw!p<155-
zA#0h%R<2?%OF7CdjQzalB2&4Gx!liE4ziZ1-xAMi_HqYD`D@0mc5ZJL&(|vLBbVHz
zkN9KOvyJKh=lOECyfgTYyz@FXvVfhe<`5TGsjou$W6c-T6<hfVdpX5Xrru-xHO?`n
zavO7bl%*VF72mT(zwjEivxS2^#3^p79uJehXkVDk7g)^5R^#(aY~ge4VdD4o0hchQ
z$a%vQ{+lgaf3I_f+d0NhZ*vZP$@x(`9(FMAe(PizgSDQAOyWUi@jQ!IzuowJ?1#=T
z?s~wyx%fxozU=wKBrdHN$2kw0H}hD{wLA0?H?x}!9A*zA#q!ByPBEL;{#ZOWv6}U4
zW;eSz&SB1P5dRf*#blN-o7-8;=UB}_HZ%4i@m$DZu4ZJN_Yx*^gxNgLVx~PTo~zl+
zW|rKhZhtC|Y-1aTILWn-jE4y&=F1Frvx%cWvtL}+WWTtPIk&6VN7WMx*~{%5<#Wtk
z?|ggA^MhMi$31N0VfOI^#~Ax_=l@r|7cz~jna6D`V+-pzz&4&`9~U%>XEx(Xy+<>R
z)y!if)4%3@`<MEK`+g-K40g!}YkzH?U-y02)B23_pV3EL|ExSS{yBN(az@JRCzIL9
zZ0=_POMkCF_z;^oz%I`1QlDJT;2WNYOkyXyn6^(oxq~qqJ=dAYS>5i>q8IfackkE#
z>|zU>Ub23!`lEegYOj5}Lmx4fH~-1`!Obk^9@cY$?Ob%w^NQc(1b@Z&a{Iw_j{aF6
zeACYx`t%R?v5M7yQ9l*V<wN#^-G4PcTl%f*Tk7&}=FJQiF!5z^e1y$xWe4m2E-zd(
zVBMS5KNFe!5Aod3Queco%MaTJ#{Sbe^=)}&5-%B4hiqXPKlZQjuz^R|#qYc#znox9
zrTu%=`NBr#a35<JGo-#bz%kB#O+DS^`zY3P^$~gF(Cf}Q#*V0iyFE9U%N=hSpUaQA
zo;B>?ISz5f+xGuE>TcBd%wr9E*~SNt+Yh#Lf`4OtmGgw@Og>>hxsm1E#d=<S(!BUd
z_OqN5+{XBO)Ctqs!F=|yoFlB~yfN`iVGmbvghia<b|!9d-Z70YF^~N$=Im4YiHU6B
zHg>X}eQf0z_b~EZ@Aph*KePE3i<vvFKKL-Zd4Q2>^E|DdId4LqnafhHWi2b%$~yM4
znWOAv?DverRF1OY``+u$*cYy3FYn<fYuR<Ly7`aw^Vk2i|J&S$$$XpHJj(*^o>G@Q
z|3Bk%*R<1NKaX&N(NU+v`1_ns(@%$)>|_z=&p7S(`t?=J>9CEnFFqaiasSNI;Uw2z
zaym??RiDgYO{_TXWff;%dOB=kI=gr)hgdiJwBP6V9AFBA%TN1#e)(bvSFw?+6HbTS
z9OWoG-*q~S+pa$5o(|KvJn?i`z>;~!V=J4uGU;^K!)}f+YreQ2M1tY>nJ14Yn<wwM
z>U3DmRyMPJfpK{DYS-7vM~ZQn#XLU9G9I|*blAY;_n!`v9<c5-^XFgEeVtV|T3@|<
zXNu?An@{^Y7w?lSXWCNntoZQhaFFfGPW$)k^gXk=^P{K3Vs^5b$Josv`*b+WM;O`R
z{9`hYeEhWE&-Xmau|HhRG2Y9#AA4V58XIph4-T+`$JoG_6{o`vW^jN7OlZ*WpEw<6
z@d%5!CRaVMoGo1TN#n7AW6b}Q>mHJ4*6>iCy5Y1>yN;_k#@iV8u=O*I_cD)9vW$yX
zo(}7I58Ijb8S~;#Imtsz_=)$(eD%sU7IW=q?I#~(Gk>{C-gvCQzH;4ab>8Ubi%e(y
z|H%h$WjW^*syn8#lOr5t_7_fvQ><g+Po1mG;(|5S%hoT-2amCbbBoj++ZgkR^We+Y
z#bfK-pE0+&KQlPURh;52CGP(-d0-~nZdVUY`gMbNwwBp1=4{kYEa4Dq7(D8^!X)-E
zizVgyiLY>srFY8PW9onzT(IeMSjaq9axEKK$xd$lrg{9_&o|h}TfQxye2Bw5&gy1A
z2fSPT@#o)hu5gGG9KXkU9=F~t?!$!d>Qk;_6YpRbw^z#-`x&#-dGtN!0vEG}-CNZW
z&#{lG-?ttvXWTE$n`x|I9vj%l*c#VyDdSr71=IK#^Vq{Oo@E_3-)r7ny-l8;@H}D$
z&$56s@6$J&#|D<OgO725S=;TyllqrQ>|z$@{y?2Dn^ml-Q!jk@ho{3{?&2t?exyEs
z>Ak34eRA!C_J<ie<e9g!nZ@j83x_$%NUL+N;dGeFD(13{r5t4~=RIVfcq@BZ%uz0R
z*tow^FHC3TC&pzfgI&(?M&}GyGMn32%mLQ$z)$TDN7={tN93JrS^sNa|CxH?Sd;M>
z{iyl0d5*A^n|`jZxrYhA@qB(<-r3Fq#_yDOZe#<uvxDb3z-7M>&;88UZT&6c*vJZY
zuz@R|5Xa0``|*_L@2~VLKi_7)y!toBZ;u4`GlMtob|3Cx6<=l(C)vg8p3;9TX7F3j
zVJ0zT7B~D>|FQOI^~Kf><Fog7;yATez3;K!PIbx5XN|{tR&bOJJo=pRE`0s>;x2rh
z!PD~4rB9gtyn1Hw3*y+x2F7<Ak2^WU+!u}4p>CMM#rwsvn-yI72kYYyd$^%TUO2^s
z->IjU<c0AE%#&HHU^yFD#}01$qjQaiImP>XodbLA2Qzt+h1~Ne=MIw&I$yZ^&+3|U
z4yh9!V*E3a;G%wUT>Lk6$Jm$E9Y4qxu3`^MIl?WB>GU4L6s8^44_w1iZeuO`*veb~
z>D=O0PO_5;&w8E>+DG=Xm<|8ZhrI3;aoqW;{IGM#_0Orp*W`yqN7NUmSjF7e<(1X!
z;t+=zGi)D!?|H{0-oY&Pu!w_iSSRm0YMtzOQ=fI|BaU(Jh`c`U=LgK>8!Y5mR&vH$
z^2#~v<WUZD_vzDN>^|d8s5|DLx1WrJ=F5X@VN5U)_OO>@+;Y)GnDB!Bnl|D0#MNWe
zL|Dw|=!vkF^=#)^_H*WpiEx4o8Q*Q6VkW{&uDw_s53!rU%!zQAX^gyRe=eKw`{4FD
zZo=<_>uZ*?_Z<^qBa<!{$A<U`zX$I7l`GtTzjK)BoHl17%;!9oGn@5X&vu^Y6tmtr
z5hnh@&jVP<1@E2+dzn9PBAjGB6MFOqGr00S6JZhCS;d)26JZnQv5Olx#1rqG2xDII
z+?hWSrf^I0gx~MBUY4=pstLc}Eq=j--|sdL_Hi@EIL5dG@{nR&R$XIU4qZDD)^Ks^
zMA*tP_H+FG;{NElm0`ZU>iR?WhnXLl2urw`HGFcJ@mTxOiEx0sImvHl%fp|%2YgIk
znZ8_J*}&L?>XE5j^>KOSdX}>&$A0i2J2}NcZn{N&ImE<2UwEIi@7%#c=B=IxtGWFP
z*1?L~t%E7+)eE<L!~Oc4e;j1WM)zYE6aV5IW+T(@a2*rMUB@X-ap+Fh9kOqmjLVj9
z8ke;d6JaIGz9pV3H;d=uZ;R*LO7T3;#J_s)y-Pgz-z}bp*~z-^s8{we(yxB2Cc<QH
zXD-`W%GfRHj*HpO=e}<oF1lCT-}GaxymHnL<dyST&g4hTk1s!JKe*@@_Jb3x>ip$M
z@Y~(y#p0*b({blA>)6LOj<Syp?efWC#-Gq%zttbCWI21-&iFm@&mvB+mGLJ%=a|my
zr_FoX^x)$i^24Iv$xqaDzXz$#IA^bZW*MvbBAcV92Yu}35L2(59^^k`o!r23*0X{C
zVfXu{2g#lK>gwr1A-nht;}=d3=09s*T*>m(>A`!S^YIPSgEYo3o*ryr1|MMor&!6X
z-@6YBImAo4oM#`J9xP_+7pDiSn9GeU<=39KU!1wmK65DtxrS5R%*3MU!KN1`!fftf
zF?X|?ySmjg53-lXILf0hn$MS}`~Ps;SI%cA=lwx{tu+o)xth6L)nlF9#Ckr!c5Z*k
ze7K8KJix>+PY?DVFdrUeF{k~}e0ZL%oY!kUT*6T<{*&wPnI5b-Xx)7GpPk=a$R=j6
zowu={-{1%<nYd+o@Fp`^+Gie()BS(Ieg3D@gHC4hWfpRbl|0WzUh|g;e+O$_Y~&m4
zZZ+N^{lt1kel<OKjsv@<2WMIF>*>K4{;EzojmHi?zyY4)B%}MCd(Tb}GMT{@EMPe+
zSj7hJWCuGqz$s4h>A$I`=cfmem)&RI^q_$4uTBppILMU0TPL%bI5a)@A~X3l7V-&J
zvV)DhY{34qmBSoj<Td&Ghka%nbD4YCKC_C0O#G+oj!X~on9Nb;GHK90v6J;2V>@gA
zC5~O3V&N;|UY{P+F`KEcienM8FOLp3vzQOEnr&?60d_MoWS@CGOXo!g%UH`Vu$5Q5
zrjGbH8<L}gc6RVz9N_m~mrwRH@v7+H{loTSL3B{X0=~%xCcWXhMbW_rm~g%OGlSJE
z;2u`6hYd_TY8*boLH>nPoc5;t-54Fjv7XnmorgxOD=#`Y!ERpsmVMwm8ToW{@EIm^
zEwj0o#oW(o9%3_R9}~~(ILuoZSs5LCj>-HHv-uc{d5+bb^R{??klp++hxu(rJ`){m
zV=|90o99`~ca4hY)okXM+0Bg{=79?z=STZ@i+s$Bj=SGyql3$s%ug_zt69w5tmZ*B
z^DTDs-yG)kC&aI^&rIgS%;p{z^DnICt8C_#C&hCihq;B3&)F9y^LNbVA6U$&G4Y(u
zX0B&9w{n<|GExv7{F=#po7p_aVy-+To*UTAd)dt&bC`c+<n!{#WZpDB5hmRe9pp2M
z-)0dXWEI=k#OMjn$!+q*KF&MiIdWfgP;gcqvX?18hz>&LaMr)QNAViga1&dZ_#gFG
zCm*cmXV}i2oM7I6-S>yl!Oxk_U`qT$(ZT!J!b0|N8%J2rn1`c--!p~D|1&;sWeKa8
z@`%1;{Zr9F7u(s(e#V|RF3XwF?s{ghmIdr(1qax`VRkS%)W1yQBr}=t+vuQ@4Xj}Y
z>p8%FPI8C|d!hsXYG0Va)ZmQoU!#KzRxq0ltY!!6IKW0ua*zp6M+YO!-~<bpevx=)
zv4Oel;C*cQyZo|;`#8b@#tcLU<4j@fv@>DmtI@&pEM!vDnXr*xV;3KcoC$~c>FH;}
z>Y-@=|4a8}WAvFY_x0$YgQYydDJINtzhV2pLKd=;-(x2~aPb-cPF{3yGmBWjDsE&G
zpJUgB&(Ay)#!s6ObTNbJv1h_!X0w{DY+?MRXTn}qGCpcXFw6|*&N4pRS;fT5&V<dZ
zW)DX>^6nYIImXPJ5loMh4_?k3zMmDzGlE6$kWXGZ+kCHbA67AwP29}-Yi0zySiNXQ
zu#e45yIlN7X9UghK4v?++0S8~WF*^lSDXoxS;`!4V+q?>!(O&<ggqRXb0!?)S;l?L
z`rmmbOk+)g^|FDLjGZfviR@wBm1n{UHnC{AxOboN|Gl0OB(s$b^VAz#ILX8$^ZNLV
zAeGr{dheOAjBTuA^84&3(>chNWO>Y)5j@R?H8X-28LXWVTy(Yje{Dt($ARxyFDLm4
zCREJ`YMH?v7V;=78JnUGnZizHbCBuR$lE<Lf|X2W8M9f*Vt$|1+|6c=u$yxh$~%)8
z+2TG-=4xiMp2gh7Y93@W-(oixUMrsK81r3q#1uZs9PVcckFbV^QqP2K9Ah76z2Cm^
zI>uGc2yS5-w=s|VS<YeBbLMqt!gelTKbLWWi#~8BO#I%AAdi{cz(Q_kC7)m;kFk>r
z()2I08El;qtY;FpGK-I~h!1?wyxGPU9%OpWjNk<GdGR9i;|kVuD?8ZC0UqEak22xj
z8Nsyc?JLJw#JF^Q!|T|@TiM0iIm9O!Y!lC9MsBb#T*zWBXEoQdnJX9TdzNvO+ZlVG
z{bMR$VlHRi=zQXG*0Gpv+{Qlc<QVrcu2$V-m^b@az!R+Cteey|uVDw*bAUTJ#cn3v
zFYnA`^b-5R`K;vZ51BX9*v(rx%ngiepAp>4WFBBPqchbLlUc(RY~ecga0^Gc@n-Y>
zf&OM1cQKC#S;n_m$AwF+o9o!mYEJM;#@DGort=8%dFaFD%`rA|R+f7Ig>#WPeDWi{
z-Z>-K!$v;OPL6Vr^OwmB^O*STj9?8jxq*eOXC)7^kt6Kn!jFn)2B%oa#OJJ+nLNNk
z4zQBLY~)FHa&ESG=5dO5Gx7J%8D_GPh1|zVPO*`5J|>>?Imq{OiUmyUQeVtuCkuIi
zl|0Nw2Ft~B2?v?aDHbvD`5D1inaLe2WG^duj*X1@xOgUTkV`qm3MTH;pR9agM(_w5
z`2;)J&q2=2aXmAb*sb1~$yF?5B`djyjqGD52RX<$ImOwxh<|ZLki$%FVj-(p$$B<&
zFFQHGLC#tso^zSFe@1W>GnvOiZe=Cg*~oqD<RK1nl2cst3GsjM{AMN#SjaE4lH1wH
zZgz5<gA8)TGmeQpGlIp;WEl&&jg{QNMn1|;_HvNZJ}I7QOngcHnaNvO$Z}S47aQ5b
zPWE$<uX2hrZxw%FMv%o!ZeSrRS;<;9ayL6U%0WhdN`Jm0@6372d|AQ<*07T;Ji;C>
z%+vqOV9YW3VhU@R!vieg0BbnK7S8{)c&_IND;V>({bUMz{-2^dj*I%N9{_$iq}yUf
zM#hXB8QJBSF=LL5ZDeGZk&%&+F(V^)Gv=7FjTv*ym|aG888dRsn2|A~MMlPq7IS1b
zBV&#^X3WUQE@MXin4*#V-v0G|;oXPt^L##^=Xt&dhsQ8S8R5(o;<<`#j4;l<Ot6c=
zQGLV^r+rF1modW9%U{3x`oPZ1U$c!-_OXp;8Ry~>-;ZGi&zL_$Y+{(*jPN9*od0R@
z%wwDznP8N`f4e_qh({Ub?3LmfVwCIH#u~=i%mfcIIHr!D5zlmnxrz}+7-a+7xQ}sO
zWP-s`@&7S@hFHolYZ>8gMtPcToM6k9!9dDqorer_m}LxH6$~^nlkF^Eg5{iK9rIRs
zK8qN5Log6!CYxEnL6&orbqsyZ^_b5d)^L~&45S1Dab|Le1xzn9uRX!QQU-q<4BX2Q
zTN&m6Bb;`dd2u1zSk5?OOz>$2+k$~J3^8N1cowmZ8yV+bCOF986Tv|6^PbN|40A0b
zY-E(ZOzaH?&NBFuU|?>!@AuPSpo(#}Fu@ZHJ{b(m_=4}pB8FMZ2>-<>Ut=?;t+5_C
zlfC>PNBA*L@Y78BSun7MEk8F;_OOS;Jj1}gVBqav^mV84uQiVS!9X>Gzmh+Om|&Q-
zw;KnC8ReXad2l)7+|C5&-66g!7}&}X;|z0x5$3NG&wjQs_sinBfeG$r@Tp+n6hqut
zDV`@7VaA=}S;RKR7-!ac@r*KfAQ(8r5YI8p#dnG45k|SN%D?|w9T;H?qa0xyYwq@a
zIm85KZ}5G)gMnoXaT~*&`xWur!YF&$#&O1(S1q1>4E`n<$hk*6*E7srjPN9*y!T%5
zJkHQT{e7S3G0X@X7-eRS=du2>&#4RJ%)j6D*u>yr<6wxz8+{+PGs@ss#j%2M_AtSW
zTK8jp^3Keo!9d#s?$ZW>frE@O!46K_<o=W)j&TW7UknB!%;9DhvyD|e$QTps;Is$D
zGsK)@;#tfHtGJmlwy}c;+0O*WIIYh0UJ}o-LGhQrepx(+{~Qe5{*d_(S&y52e}3s}
z?w46nZ=c~8A2xrk*<!sg`|IZWN-%I;RGv7&DxUv_=l{j`+3LRgr1im4?qm(y*u*33
z;t&Tp?VG+YQ<?rZ>x+3TWGUCNhBa*BE>5tW=_5h^UybK;n59f^@O-ARiHq6AFbBE*
z^4F)V)5~9TH%tGi|5?Lj-x9}N?BZDta_KhL<xZxb4hF9Lw(IgX)-lc&X2jh8zv;@r
zjjX=T?>X7XPq34p<p96Pao)+aZ0~PlF1uO61RELrjyQ%mz?B?lJ=3oD{#fR+Y`gmt
zcCeOxZ01RJ^Q!N<KVc>(S-^}1eqY9XKEpD;%v%1N&79sSo^Rz4!<^(sX1v$$1)0w-
zmT`==T=|H2KEQ51!6ClLNxp7}_#A(~$b7D18Mm>P2ieTP_r!Azhj@{bT+}4~2JbUq
zK0n7Y-pN|lv6(yA%`Oh{2q!thjD>#h_<iv#VHvlumaS~&7`vIhQ#{K!$w6kl&v;nK
zs~+|GmJ3+V3byj=>}5MgnAGfbVy@>gi<=ncB}RD5WA+_>l5O0}I7gXa$}a2mMs;9_
zs~KhuhZm_k12=hp%@3?oE@uI&7|4@fW-Ru5*B0aECs~s3eS(jhH@~{uxEcGQ*X2CT
zQO;_0PTuVIs6Vn#@ZgWdG2Eulx%CP8;*P!Y#jc;2FPHw*cyIAO1%`NpVJ?5tzQLW0
zv6~${!G4Z&jB|fxzq-{tnZw;3)+-OPhD|@W?%2g14sw_i3=~{`zmn^6eW!hsEv#a&
z%R1*tb}{)W>zuiqU_H}6==}oB;}A<Z$r@%H5YH#r!$sZd!<7s!@qPe?xPxKl{Kj>;
z_-S#xon73-LGI=R&m2^@4|)IDv+BkOD;Q-x+t|uDds)z{K8!J?P=1-sg5UYM37c5S
zwTI-HF?Mj6{ha-KdFBG9e%RkJGKWW4%rRDR=V9aKlkDO_4)Pc$IL`E?#{CER;u4m!
ziZ$HDCLUoIQ~Jd7UQTci(?8<<3(Vs<OPT#g@m$3wZe<rwaFC%R;+fC%u=z2MoBrf}
znY&rXgKXh2dw7Y%T+pviK5AVvlUrH911#qW*6|Ws*!;Zp$Q~v*%-}Nb-#997+{0pq
zUodXgvx!FrT$htCiR1i1aUZh|7~*<{xt$U2W0b>eW9rMU%k@lf7lTFOkE=K9Si}xi
zvho$zW$OvoW%l32@!&ty`QyG$7%$hcm^)d;@V~@yHM`irLH2Wkmzcg>eMjY)RV?KI
zYnc41c;>N->o~}*oZw!jf5Q7Cna73ymS?VD9kb7wFIO?n)f4)gdzezJ&Qrerr0>g=
z6~@hMPOylfz`3bPM%ciuZ0BC~@h~Sp<@wAgQI{*uO%-xk(z&S$u46s7vXy(;%i|p3
zRnyP;{iFIZi;uIA9jxF4J6D;1@;RT&rmr~8Elm5Ic`#IFzhjt38DWA^248>9=c}0q
z<E&(YI~lyqx@U-|7-m{fJfjSk+aE4}%{Ze>F!c+*@0I7Kau{MU!>nQrd)L}`nBdH-
zT<3OmVTdak<`(ud_=a;+r4jpj$~m8tWj+kvVV_`#saMNCm#~3#Oj#$7%;s~fu5_Ql
zMxJITubLrW%;h*&Gwn|6ihbP8Q66N<diyrBIqi+-riwV1m0ZFGu3<YjvyV@5lt-9y
zmp*1TOH<EH72ItfVmS}8j+fZN>)&+F=O!fuKEzsnmd)JCZnkiU`#H%tGww<9d!}<!
z`K)F+n_0&}ws3+yOn>t^pP!^(7`WGd!A$OC0XtaEgREmPO*|{!DxRGj=1B(b^S-=v
z@hoB+*D=ohOz<p&HS%?hda;~g*0YPl9AxTj{l8H?*vk?|YR!jj9AoYSp7*wMQzgt{
zHH$gKDuy4FA4WLL`med4%dn1^#iEDRiIv>W26nKWS#MW2hB?XzQ?}TTn9ZNCi1Xgz
zx?Idgma&s-8Rx`1&rOYSewKCcb@zSD;YAiR>0Q<>Z)QEi3`E5<ll3fME6dr-I*zb~
zN%Pc!SsZ2|1K&^|X0o0IY-KrnS;vcP;p}(ot8d9O`@SvD?1_0FCWqO@z<1P_nVc5#
z{WzE9T*5l8VGB32hr2n<gA8mJ&n8ZLk2-TM2f2h3T*LJ5nimT=d7ZlP4cYb)&So3K
zjI*5y&cEI|XtZB5=@IpQuRL;2j{59yKg&w4W&<~I;(OKu)4#9YH@F@%7P`)3_IKv&
zQb!iEffYaSJl3<Ht(^8geaUQ&a3zyk)FIct%=L^tZr!tkgY4(r8};XI^X4SiFyn{v
z#xm|^Ee|rORo<AzX^ZUhoXZL>Vfl}&ABOj+Gb3ze)sNMgF^;f<NjK@sHvPc?u4mm(
zjgKun${tQ~m>GHYzn{qmb6Lg`*0P%IOzCjH&uoseh$-)vZ)UTfJD9%DcsR@i1HZ73
zEY?rVW&w*BWfj{PWB+gD{j$HcZ*q*6nA)ShA5bUW!eXvw6^9vPYQ8w;u)f#*3|o1U
zLx=qT6*t=-e{Y{-12b;1?pegi!|K4yKj^z#<(JDCVdn>Ze-5yN<LqbJ67~6`eUud}
zWj!-K<hm?kM!)@#`P|Af?qw|xvzdv@k3TOzg&t>!wG3bO1<zwMFS6oTQs9~oyAJoT
zo$Hqx54$<WqfC9tzV{LN;tee37FMx~F`i}zGs5Dzf@6#_b<q7Nb2!Rk&iSZ#7Bj|X
zcJKiEIm$8CFVjaayDwla$63PakLe?}u#r9N<lG|r0@rbpyP0v^`e8m3EMxO>{mXH-
zu;>%|mkk_d2LpfhK4NC_zbxR_isg+Rtmg@~@(rJ~p4r4v9%9On`-~O(n`=MizJpJ)
zmPgpkoD$b%8Hah1!B_O(r=4$H#xVcF2s2meb1q^VS24~iCb);e6Z)JXuKbL6?qVem
zvw^4C&Z1KJW+%ru%GAFY*Jss>n_0{wtl}hN+`dY_x$kqv%_#<ky&fr(FUDBFr&-Qd
zS;zZtlP|Whm-nrfFCJvdU!8Z%=FOkCAFzUz+|33SmD~T>$U#2K308c;bx*1f3z)S=
zzF5vEf66uvG0uxjaMl;)>u=64hPa$z&aN<D<}r5p-`T+k`<eSC*W~~+N9<c`U6+el
z&W)^ND_fX;yE-$E!z^Xs@8Tk^%MupxVOFw}4a~Shomj*^R&kUurkwIRd7V0O1B)4B
z6;r=#+?T&*2Z!0uyh?Sx{O?Tthks`d^X?SS7^~RL7_VNh&Ros`Zs0hhOiNf-%w^VH
z)+JZ4ns2SLE?LS>)^dQ`InH*b{nPqkE;H{I&nT-IXCp`1$!QzJb1}!cfoZ4Zm${6y
zgw<b>cWz?~KUuBbY+-`8+#_%Q(tph6F&44%Uh`%XV+_~mGj8A@W1QfArjP2^`_-El
zS<b~9U6&PXVJmxhgu~4Ls(Qa_pRZMK4zZZo4;c3u`C%jbE`R-Rb>AcptYjl&>|_TA
zc!J}XebD|krrve-Hx9Cb6RhW|hx9#nvyTTk%B;=m{~zC<xor5Fd2m1LnOQH6MU1nO
z2_9j}S?lIueZ$2p=4Mv&Fq=4ki~Mmb2ieAn%a1et|Lh~o<ASf-7rBfzyn{{bU?&qC
z;DV^WWi?aA^(S*U#9}V^hU;?`8~G4B`6~|a5XZUlo38(wd@zq^S;~bCuFsWhVkNt{
zn}a;fNiO-8e4lgfGoQy<#!IYa+BW+-3)sza4)GuZ=k+tQxboZf8CEmGM;YbwY~wKF
zZ2XRTag-?&?!UI{Th_CPZLH+eY~V?@bI*6JcTRGG3meV*g8pV6_p_9jSj*5O`j*?-
z%Q#1vv%`JlMf(%8xPgT{%nIgwProqAR<^O1agOjDga4I>CgbLQmhjm3tryPODUL<#
zWgkbF_Ncf?=Qy*ul|>w774w>{Q%2drIQu!qF;0I>fB#ROnZs=?X7Voa%wmj7*ue<<
z*~l^OXX+*W!5q%~fp`|Pnj6{3CU){^4)7w!IlIOFG-dx|9yha;?X2M`HgWOe`h*)e
z#70hXA2R~e1B1+G(r$gmd93A1HghYx*~TFr;v~;9<8{*mX+IRtg)Cz+Yq^fi+{$it
za)?Jc$)r~C)BN2F^SPd7Y-TNwu$h4$iRVJLUNJrJMfP$BM;K>PlE3?47U%8JKdfPd
z$JxNEf2?o0n*Dr|W0xOi>U8nUVOg90;Wk$DNj7rH6UM<x4zYog+{+Aq&$M%|>oV{Y
zeak%7b1g@>g-NfU9_VF=Ded}=3t7n$HgFF+IPa&%$@LuPHl_uQhq)YNDVIDcU);!M
z?qD}NIm9te^17cH=av4xg<;O?kRKK@$~A1`7RGso2`>J*b#j$DGQ=*1Il%}s_KD|0
zwy~ITHZZ}x48CD{;01<wiecXJ3-K&wl<V2XDC2Bnf&&bu_`4g1xUy5;xQkUh%otCz
zgGIlzPT0r^_AveG>49P9ap8V_#*M6F8(VmYJsjgO@BNkQ&hYm-3^A?CxVe!Lb}`D6
zY~!-0jGKp<;H(4U->Ci!aW}*4XM{U`t=`P-Hf}CsKO-Dt3sY0onK?}Qjs1c1SjCNu
zv6US>#(rMp7_*-i|0ey;93EmZ$5_qqZ}l}>*vVlIFsVnsaW>Ot$~SX)FH6|T8V<9G
zfoGg!T*D#mW#G-1|6b00D>tx!hgr_K&&oU3u!URM!xj#6POo*6X8&Lo53rCIS;0BK
zv#yxSRyMGgBOKwZL*n1!ab|G^3t7Vowz8gw*vbXJ7td83;T9&%vJRQWK^C$gE}l)S
z=NMa=^PG5=aD?la^j7iA;z<^A$zk!_&3X>7l{fxDJPSF()kmDe>DB|YdHi{K=V?}R
z#f#QC?_@V;923W7Ou9z@FpCeckWa9J$5_v4FS#z~vX|9NaGb%}<~gWe8Dp6JjBuP$
zUiGqm=L+`mC`Xxe+_?SS<|1};7l#;UAj7)*vvD!PLdICZbF63Xka4k;y}Xwre2qzO
zpB@OlBA)YD$jyxKhm7)p6ZUro|6(0*F~_)ysdLngxje`c4zrrc!`1;q?Br4oa0AEL
z$h2$q3v(I#t9X{NhK+2x{5ZQf!9mVHY5(C{{$}6J^!=I7O)Ter)^UI>Jj)&yj#vlW
z!N5CQ=kMmthgrxbR`4L}Im}kR#$LYTlzMUvgLCyWL;TS{jGGgzW>&(yS;$WA;2=+M
zl4<`m?ss|~^VxaYxLNZr*JUqTnKr6UEMQWWzYk>=A7dfgS;68n>ckk^*vU8#Gr`J#
z>z{YokD1Lli<mrSzvCvx*uf4SWj~Ytqt4vI)Oq%0<}mZD{f-Z^ipBqD-LQe(Ji{R-
zjhioXnDK7UV?KAYoO54OA1>uEYZwUG=a|V;EZ{rNc|Omwff?uZBNwxer5t5q!Z_b!
zychHni!Q1Q_pzG&Y~&esGUdPekrf<gH*@DZ$63P6NpW1nM($!K&vAgu|EGVib3NvA
z4@)@jlKTd(U^6$co4p)n%9MI$n<qm&960ZNH`4<%Uw7X7Zk*rj<Z2GEgA+W?^y}@{
z)6P#7a?KUzrz&`o^<0v4eyWx0*voAk;nL~nr&1QEGqbs$MO>MDeyW<=*~po%cU|7f
z0iNR|7X;6Hzm2~iW+AV*(senD^$fF>8`;Ztj&PJoInx8FSDl~A;=5SLdsx9Z>p96*
z7QaC}>p8*~nRJ8oo+6$PvXFnAaek_jbKYd!EM_P7bAaO<XU5F)Q)vsWL*{ZlOSp~I
ze3Fek!cH!I%X#m!abLknZehmz)Rp->!*b4;b$+Uj3)sTYThC9$xt62+4O4Rc9X7L>
zmM-7SV<l_Yz<#zfbj|sxK1MjoeN4I0xx#FoV-aW17SF|OVA9)+n`Io}-E3K;uNb_^
z`kHfoDu+cZ;eOU|fK5!k_WV>AZ{Z*#oZxn*=ea*%9+NW9PnB{ZYgox9Ze|yoILN>|
z#B&zY->*NJ$D=Ie+_~Z}|2vzwg<WjsAg8@kJoA~p*m#)7C`);qwVaz}o-Ab#J2=eX
zyUtGq{C@*sX0nn6+{|+BVI2>#g|T_(rxNU8FyDU95CiW%KNV&sBP?K)<!oae<7{Dq
zJq+F~o*@Q8;+e?^3m9cN+gQgqTbN)EgSUuhi2m@^`;_!e_IdA9QeQT*m0cX=5Oc3L
z-&_5iJG0o!Fb5goD5H!na9y@D&ORnsk#l}3wZP-dVH=CN<_2|QoJ~B%E*@Ga&)oAq
z<Ncue<%;9l8`X!qSi@s%;*3S&xRisJALj(mF@1@B^(OV@DweW}HQdG~?q?T+dEz;b
z6PN#;nIE$L-><&B#0VEHHeYUI8&5ILc^@!eE@QAz9T;L4!%WQ=&tgVd!!~YXoa=8s
z?|n+@#ncb$XXY^J7Wra`RSYx6nYS7@Z{Z+UbAlbrSn5831zb>|FS&(vJjfQFWY6Wt
zKPcba#K1@VKMl;}NfvN|<*X_+ZWe#|{8R@k*w5`8V-Hiq&QInrYpHQ_IjgvZF+R->
zCfLt;9}&;xO#P^J&K!2Lm_w}Mp0Ii``J?8|Ega@C`Vj6w_A=w<G8Qn(a@Ky_xY^7$
z9$}m(m|*&H_4=6opCOhq%uS4NKchUuHoof<;x9kW1P?P<q<+Q5%@~Whn^o*&j4M8A
zALU*SaM}vz2Uj!w<MPWqKFLyEVhwXYW!@}g7b7dpn_UbncYS6u=QGC5C5-SsM!AP=
z>}Q<AOmKFoaeu--&k!pa<_<>K$|y@e>-^w)_OX_u+{ct+{lsiWZnOXM1Zz0PCQe&z
z+-%_x4|0+N%=o0oKkwY*T$ZtfwX9$>cd?u2IK<`U;<=3(D~yx*Jj5~%vX<}tf_T=m
zhvOXP3u~PBpVFUSw4ZSi3)##{KF<aQD$JWJ*~c9m<pHLY$S1S8{!8Y~I##oXjXcUu
zE?BGHEaNz9nfB@Ffk&CkpR$CnvYLV0#d9M&IV)n^%w=GuK4K;#EZ|O-v!8W5#TF*r
zVcwk0VHPp)8FgkRzsUkV#&W*GI*zf0MeD?~jKi#Cpi~~1$#xd-6wA5u%kHx-|2tcG
zoV~26ls9%U<+Jj6r+M=n%eY{@dhyF_=Hu*U2ZuOtw|cFb9(dCR_2NfZ$d#<%rhC+j
zEo|pO_Hlrt%)HliKWAMsoBLSA0ao%98@TX3@!ZY6%a3!EGit<_`993%G8VCtmE6Pz
zzQ}gYzF$1+ILcE@xy?SxZ02ng&t<G+lntzXK)pG@0WRL8UpV_g`@?E=VLl7$<c-0H
z<eU9$zx?=S=Kxdd<?Hi&Sf71C-!PXYEV=9!_q~_>y2mTjhq-KG$z`MJ!EQElh~512
zH^i}atNDD%zQ$}GViD(l(|lOO29~j%JJ`oIj`A2&*6Q;H@l0hAm$8y%Y~WV5^Emrh
z@Gbe^y-d4ZpD~w*S;7RXd6A8rzfC^5j03FYI2)K2F>dB^kR?q1ws@wqkxSXhQVwtn
z$JxZRJKVp-)PvdI(T7~dde*R&TiMGljxf%ob@sdM`j~TB$P!j?BkQ@Ft$dliT=-q_
z+{C0Wi))lO7P5#dS;+_+nEZ(ImFeu~QjT4IoT-(r!yN8pG5c7>A;vgshj<pTpX)fr
zC{yng#~dDGF~?cO+20e-73|<v_VXEzU4Fbt{Cf9s%;8nvcg``JHN1sQEM^ziaFAV`
zWN@eb{w{s+n7r|RR<MEf{1aPwlD(|k<(y+bgH_hk51ex>W|&os@E{vFz;;e+(QnM-
zC|5G&Za-&ZHn*^dzhoujY~b3*&6|7J&t8u46jL|2U)yco%waK?vx?=6F~$x)$9@iR
zjMx59{8x;ZIo!-*CRoFZY~p)c<&C#-kUKfSex_GD_nF6FoBf)zS;sJ2xQacj=P<_@
zxW_tu!hX-iEMOVSxt?{Lx!3&#=lsO|1*<s99;V!DeYeXS7qW;eSjjbP;0CsHh<!ZE
zQO192-uLO_C(WCAEM}Nh+{YN>?BH?sbJ5SNQ~r$UHR{Ve&i=V^GoN*AU<-G%hi5s=
zw0-7%zwt7YVHU8G<!omi53_}n?BSwci02rC8~uM_o%)R(EM`BeIPI6l&6(_A5&K!m
zF*Y#utIiANaQ=SrEMpbdGsYfvaN4iL^Inc|kg2uP1Jk?2^Q|oAdsxK}FvfOvGSKau
zWi=<cl^GA%ubIz7EaM1kx$8I987JAx?5FKdT*jnL_6uflD+{@o6+Fy(o@Oiaek-0U
zIl_CH^q}*CSsY*?&$5Cud&F}gTUo_k#yG+bCe_I^vpB{=ramK{3s}$PY~_0PavMk3
z$E1fY|K3A97ju%Otk`T{XFX4{l@sjcvS;lxEMxF%=FJeB8RnJ0lXos<j62xDKK65n
zW9*OX*LvTdc}#uI{>XgRa21<a!!B;+AfMs{`<VW)*NKP4b16$%!y0a76O;ZRo>?5^
zhd9AcGkuGn|1yvFvy`K(Wp<zY0WM=VBOGE6Cz<|7ee-qsVm|L@84t6LbB|ar%w-Sj
zILu)NqRz8F$vgKk%zrV$ON=t3-#){YjPqV5*v8;DoD&T3EW=ECUOX2v$`x#5J>zU-
zf=3wKY8(u4#!>NHzzEA3Wfj}FmvMG8!P5+W)Bhj%f_;t~Sj5x;b!UVz_OOG27uB7`
z9OD6|HaNeS!;36t)iL)YjI)uMFIlfF=KyzcoM)K!E%h99Kf_#>u<Xz3#s}EU!|diq
zht!RwugLp0>y?>&h6S8;Lcenh>-qJ+m^Z)AIFB*GdBf)YZP#Ill?=1-Z|2Q?jPVjX
zxNgL}xs79NWom4C;F`Z1H&?NQF;;UQ8`;ZFj&OkE9B0xg^Zt%?%v{#9g!@^|Lu_Q=
zAL2Qa11#V;S1@h6zDnp<R<n$KtYykS<&6v2%>oW_1t+=pw0`}reUM?!`ImlS4x?Pb
zHqIV(u5leld4MU6);+VC@v44dJ}bGN4cx|d_OOp<ILZZQ#6O~cn9VgT;t(sj^55ba
zVLKO&nKuhL&Kdu)PIpWXe2V#8$1--Ymcwl3*UsAC_yQAr-T$fg_ofFv$!u<65t~@a
z4mR**wsYRNadS0C`MTHSyGcCr_#jL9C)P6Qoa=HHySacv{0t}A%8c)uC-eE>d40-1
zG0Ok3jUS(IU2f(mcQa+D{$@5`U=iPZ!MHh(4QydMyV=Jfj&jCD@sFx6v-ueov5}QL
z%myB3JCFWPzB$fuCSNk|X8R*^xs)ZWXEg`d$g8IGDQ9zlGp9{Vbw8#)9O6Mva@rLW
zQyIIQpUme<ma&?(+`?x5lHH7Rh-;H3rUE~(KA6eO=@U~0ypiSnJnPuZ79M2}PjZ;Y
zgA-H17W)%JoPFiQRG5ny;ggK<3_Ez;RTESF+{p?4n(2?rEA#lKH%v^GvYIt~giV~6
zGBMS~r5t1jCwPeIyN&N^^X4eaIAex+b2Xb;#cn>!VIE`Phx#eixcSkviK$|iv5H$5
z<5_kv=`F_1&vT4Nnc8aqnKdz$%fYuAH}lh7m+frkVRm!&HS*1DPI5c5el$Jsdlqu>
z?1`xgu3|kK*ve-1@)$>$VA3Az;ceoX&q7wPf{(JE<7{O?hIsysqkN4iKX!ll_6eV(
z;dN%Far0hwa|eeQ=OoWCqfP$bA-}whW!%qNPMd3<+{0dWafFAN^n}+H?=()P&6}7i
zVlFFL$Oe|Molmom103b>yNz?NeJW&}EMYMlS;ak!vFbhgf-w&AXPn?OO#g{>%{(rh
zZ`>?pEswI9>DQSz^EkwHoa9Dkv`-KGg83X{8Run-=OQ+9{(H^ur{Y-1W>#=kjyiBF
z+jy99CYaziZ_qza`Z*hOc$~#NlB@5Td!xSR3U=`;oM0!@f2Qx5$K*xo#}J!%6T8^W
zA<n%?9XhOYW^oG(*~JRRS<h*C`h{ui<r0ptj!8dvAIdByzh69Ov4S)5)sZ){om<$)
zCXVtF)ApIq&DIH5vxK`?&4X;@AUm0N%f!?G*KnMhnf43wW-fbK!b_~?np@4A``C5)
zaSn2Rf%V;Ky)u){EZ`{1IroG1H7;ZeR~D)dBTQWW_YbSjFXf*(yqm>5%xVs?kvA<h
zZZ6{h_i&ttn6}^Vt(nX7Ea6Qb5zl38WG_28Ei9fZIL;{3ekG60Wy8nxA9t~qPqUe?
zu$zmD>}w1&(B=Iz%;Y2sIq&1@#m%f|BU>3~FHdrWlT3O_eV3~@m#~m)SixRK8UBR6
z=4Qs(%>>Uec)+?Zwy$y#!(7S;S2D^vwsH0+?W@e;7}qiN*Wy>mJ2$YHQC4v;W9()J
z53`@+9OIl%iSKqj=I~AybAmO@DY34f)&~r8?x&551&nev+gQaoTbbZ6gTK{x3~|#+
z@$6=VXBp+P&xq%4#(9znCY6fskynPem0`9p!X8F>mTjE&S@Fzgg3B3v#?LDm;x>kv
zy~=*d<!oR%+j*J;oclTZ#6gd<l<Qf;el~NG-OMPnUvLux&&o41d6)&vxJ~^TW<4Wp
z<pIWdiU}sKHqKuAEVEg|BDS)Uy=>rHKCgZ}${~($k~7QI=XYMWFrO<}#tPPQJDb_c
zZXV?jM>xruUl4ytJoCANWjw%IX08#>-R$O)FY0@4WYX`gH)b)tLf>Ehniagrdd~Wi
zc{7*29N;KZ);h1^_8n%kjwKA-ZoRXZjXc0k_H%$|IL^$7_5Pga-(lPwW(B9Mb6uvf
zl?&O+VvaDzq{I64%dX4qEMhAwd58@hWINYXx-NHeoClcp2kU{koMZ_X-D%tmvyu0*
zlWFViuiVT@?q)`x{g?SX$TE(ymNV{>Z)UQaLrgHWN}v4EI%SBP80PA`t#c;W#LNx$
zbuQ;1TRFj}n0~}{n8!6=kuToOdj62D{3Cn0s9L^Q!K6Q#KeO1yLcYohPO+Z(_lRc$
zd)ZN=&U~IJ{njb7`R@DWn~Pb=4mR;9yLfP;{^X3W$`>n``Mmoy7I2*9Os;hvaWz{R
zWiR)0griJ4s_qXMHy>spJ6OSIS<iE9W%4HR%;yLjne>9!)ep)ymov;gjBtoiPOG#3
zFo$twK4jkf3{wVNkJ$`vwy$zFt60hy+t|TBJ*-~5$O&G#MZI1$9_Dd1OIgJlcCd+o
zuj>=e=MYOd$<53-re4hF+oSr7D_F}$HuEsMIpZ7RIfs*6z>Jsl2lH9aG7htr^R|j-
zKD)VsLtMj2ZeYfsdN7}(EaS9qisvdebC^ARYlHKcMGU-b{V<a|SioPhoWExsU;i!l
zA)L(~-os%=8945IU?%r$Q#YPqgeBj$K3N#kZ`{ctKF>+c|BiA0S^ikSc9!#L*6|!$
zIJ8~8S@K=yC=WAZ$o|kMj;W96Gk%2iY+)-W80Xv_)-_8Qe8u^|5VtbSW=6P|Q6Al?
zPx#oQ#>+DdoN!Jyn<r<pfG@Fv=UC6I$6S|7*vsu4;RI9uGCgqpF8#?(EaC{OIr|6l
z#1)tQtM$un&Tp|l{>^;Z$!U+<AGw>8JkE>}eaw7bvs>MH9c%ezHgglZd7MLhm6N>o
zhvNV4zJU3>jb;2cYxxwLd5YaEXcf<UImt(uamxKK^LdnI{3~nu<{ydY&Ftpw9O8CP
z@-Q?0VV_|>zp_U>dsxc}HgoQe#q)6v@eC*V#y0VZ>4En%pOq}*S6RyuHuD_2ne~Kt
zuHqzXnDI~VXJ9^m%Q8-~mSgSe$=N?uPripEEMwAX*I^cSvXEV@;LEJ%k|)KpguUF%
z5q2@@UtTveizz=7&kc;Qkx|xnI2YN^KF<5O{%0OjN1d<C<pGv3WuN_ubJ)bsv5Vi~
zAX_-WreEsgSH-b_$63xd@3-!F3tM;_dsxe1?quMMb;?YhW&s!fN<6Dr$2zvK=79Cb
ztxT|;!GHUCB||*LFq3|5-ki%QtJ%)o>|-BCIj!3|8q-J2W;2U;h?N{<1DF5Cym`yh
z>di(5{xd!B2WB$sx5mv{R&WpN+0Rz~jlG=Jqh9QM#<<VwSB98in1N?qmti(=E!$bc
zKJMfwyO{ES>dkEaokjdFD><`QJd4@Rwd~_Nf2ZDD!qjp1&&=UnEat<kVl!iWnH?Nu
zKW7~h&-qM!&AMd{)8hJt?`AbOvXK?f$s5}_$itjqg6ZeHzF;2TeAxNOd8}c|ALNbe
z*~|S*@En8Z{a&w6-k8TQx3P+YjIrpC_BU?j06%-gby?5!3HJ+svOby3GVWzPPqCFV
z`(2j{Il|RUx*-3|;vp9D6f2nbygp+c+u6=O_HmSRj>^|Xbzm;<VF|y<YVKwuhuO(%
zUNCMJa-4ga{$J<Oi^k2JEMxsK>w|r4;c518{!7*uOBk56PMOJrEa1LD<K`vSbIHr*
z&HLHQqa5J~lm6#E;kbNrEyIj4!VX4xm~Bij&g4I<7sCu*a(~JY_cP2%Mwl`ro*8Uo
zBm23RW9(z<l>M1G47{RGIg?eqfid374xTz8o=JZZ&zVdOB>Nmo@m%y*@hoK(Z)c3(
zX9s)P&lfnx=_kd%&gaK4hqtnrce9F*GR8r6aK_)na}LKi>y)}p^SLq1<1&`Ak~OSj
z6L+(VogCyLPH^r&#9xsdXksA`u!4IN^2WeF^&4+uA7dQlZl)ypydmZ=>$Gum39Go9
zF`i@xlmBJhT*@)lF?D)!U^{bok|iu1)o<L$7Os0$zi>ZCm~uwFlam7<Vu;NQ^GQaS
z{BQdbbJ)%gvyWRi%14;;`sBb*n9YMM;uI@+!<cxMv7L?V<I^1F&HoV}^tnUKW;=`c
zG%I=4S@G=rKl5gA+`M^?<GkfHuMe;E{h7=4EMbh*e3Fek!%ogTXPt5l$63R)tMu7<
z@ho8pH?W%ZY-A%l`9ltHKgaoBroBNQO^D}GmavM|{5Kn!e?dH}Ilx^U=i4uePf-`<
zvX&)$jnxePS3GC4lTi+GA1Bz$^sAEt3n%R}jIfNau#RJF;k5tRXIRA%?qt#o`DPYp
zUs87#Gs54ofrD)4Y4)*nO22V4Q{Q;`bC~oSrv)xdl`xOh46~7?>|`?sc%I|D>U9^U
z(o%iS7<2hCmT)zzxtopLKJCI(7msm}S6^{qYJzK-{w96Gd?r}NnMoI>YMI4mR<WDg
zImFG=FH8ky`W!N5a%S>{sRDkK<=o9WcCv+s*uy!mzc4kzFq7WwbGMkq4hGYFP8&lU
zVVGA0FHA)^mr)k5jVl;uj0p}i_!j%lmEt*%Va`dpFjd6@#`r0Aa4q|}mt)*{wLH%9
zIc&`3{2B7dFR+>i*vLM1GV6`<$YM^gis^5)Zkf-kQssdm*0F{y{1$t7fWy4yP4bYQ
z9QZi1_(c|SBP-a&dLCgbN7&29XPP&E&)_x2%@C8`Y~Gy92-h>pH@xM-R6AF*kKtM7
z%@|W>Ti?uK@>|WDD_O%mY-TWB{rNTy@dZxui`QJ3%6Oal&o*zaU>TcO%Y$s@i|ppK
zw~1#SC;137GJFmm^LcHCyzwR0G4ghK<9+Pm6CCCX47}ZbFh~D!ISW|Ja_(at``N<e
zYsIsYBP`35H=ldh!Vo7|#JTUdFg3~>m~ySYU^e3{;w4rxWA25i2CiWH<;OY5u6LRj
zQ?raKGdZxB1^g(>`FYmyUbe84JzO!*xENv5JDdy5;;whACr>fLq>y@Y7TcJ|I9D>k
zZ4Aye4u*Ksd&IMz5jHZ)R<<!?zIDL+IL56^eP?pu@66%q>n=<c^G;Ur2aItaJ9vrx
zJd<rd;==2#qpak>9n9rHmT>k0{lr4%zsvks#y-}v@V)w*tJuqVImW}~xz^RZ<Uj>$
zcrUv+%t6k&(fZ?8nf~tNKpXS;E0*$~tYO-s3sX%jWfwPckn3(zFYaeX$bAFzc|)G@
zaVu-t%w~?WhjZSq4_U;(d+dkI<PZxubFq5!U94jsTR80l>cv@1Tz;Iv`96P=A=Wd@
z1B`G^zIyRfY~xzS8DoOUH_P{R_8I0f{TB0P1#5VK&HN9$x$IW!k7b->Co{8?11DI(
zSp~+;0@m@jY+=d=&6^n<W;O%Y%MY`-lZD*N3ckvE29~HR%h=1uIl@jRE%5k<#B(kS
zIkV8bxtdY#W*c8-oC`l}-YjJBz3Rej9%2!Xv683Qz`~{al)E{={T$~prsdezJ|b^S
zX9-uZnxU|MVGX;ui-U}Ff<sKd!T3L_-&n>{ZeR^#Y~nDxIBl7D_Hcs7n7+{GEHaPt
zKPH~bSi?Km#2xHn8wZ(Gq)&5w-X!z6gk>yeEgxbtpJq45ImD!ot2eJJmhT(w7cAru
zD|v|xO#P(&jMuV{pX4aN%9KUUFJ|*Fi#U6QcowsP<!ookr{$Z~9OrkLc9Z!tmq%H`
z1uH#|%Q?<Ersc^Wb9tC0Jk4rme8xG<Y<6-j2e^gf>|)yc)rq;BRw|xzS<MnQvVxu5
z#Q{FeagH%<vATX%JQuTs5mqzGMjl`%4|9N5tP;=bnf3wenYnz3CHx7i`63%R#ZDG{
zPCR2A=S8OF`~253@hoBqn_11HY~)FH^33Pemov)Mm)A4nX0O+n&j(q??X2aiZ07tg
z=ns~2h*g|qMTP#j#d={O&$5D{FImsbV=J>G`hy!d%I!?KH97EeX7gDV@rpb22WPQ?
z8`#eOu#azBC!VEDDR6!<o4Z)V?RT0tJK4y??BpZ|ICH(cF~qbFIzO1pjV$5!S<ORi
z<RCkldzW~Ah~vD6X-k}M%;nEn!ZWO9R+V_>vXj?+Mc&xTNp>>hL;8;STwX129AE>-
z+0HlLW8N&_C|5A0(ES&)dG=n{<?Q=hmmg#!OW4T`9N;q?XQ;+L@?rZW^LT`19Ahnq
z@3((5d!zlEn>oTpCM~u9FvMA3b?z|42sbgxR<`jd;|$i?e_6udN9_L$@uv)P?E~%;
zxSKIP#}593{mj_pT<2n@hLZz#F^7XJ=JW@}^L>o*4tDUD?B{8YF;pl1qxKi(@Hv(+
z`5}4Z^=#y=?BtUi<WWxW?@V8&&o(>vxS!>m`!#*eZERx;<D6Y@-rT~JkI5gixsOGB
z+r#>tA7ukKv7HCl$HN@uai$bG*SCmgA&a<ym26`J$Jx&LUl-33j&dVYKJIzU<_Q*Y
zepEcm*}$!A=g-;4E59M0A7{#PpZCoizQz)Mc&l@Vd)UMwcCqi9`kYw}&ihYzea}p`
zvXBQ@!G6~B5?h)3E$2PI&k-JBQn7W*EH2z8o;z5<KGrkzZO<$5`h;1$orS!g6?}^I
z>|-lKF^_-N^I5^$S<m~~%BR@NK8`T-9p8VI=QE49vyk_*f={uYeQafDyLjetgkdIq
z&gU;Pi@#tY$5_F)epfs{#a5;?%0F-7C_l}VGJVTzKFT7##7drK1Lr-Wek^7mzr#^>
zGUYaPV>Z)wi02|!av2+VH`^IwACGaAH-FE%S*_og!(NuKvq}9q!6p`e-}%6e9O5=k
zaz8UZpB(rr^Et&bzI~_th96)vSFxK<aEPgo>Ys8y*I_0bSim2!ocmbElxBHjDSH`y
z%(`PEgI};uFvK_RvfnVm2sbjy2DWj8eVp+F^JYF%)_DEEY(C5){)&|xX9KTokvHDV
zK9+HmZA|&1b<AuYc-(%)<lXiwE@O-jv4h9i&ry!C@Q2Qq3a`hR%LbP4QC9OQHu5EQ
z@-zon*lNGxXPEvadHj*Qv54i|z&f_Dg~!;#xqIBFvy_3g?%$Zn11#W4mUDu2Ec&r{
zHnWEZIn1lt#NV#Jn8^|ru#x3F!a5GKg=g8rMNf!l6_X<Ri&;FwFsJQRH!fh5gY01D
zPvnh79OHVX-r;o-bGU=WY-1G<FvdQ1@GSc|t6e-7F?F5$UFPs-EM~_~#j~F=j<JLD
zpA^q!9Ai7vzU=;xxg2E)Gk&ISEMp_T$xh~V>UWlNlKYuaX+Pd?pWs1O@FMGZ&9C%3
zKgM3(&k;5-=}zNg7B8`oSzY28Wj*(^mBFW+Q_Nt3`3$Z%K8CoBVeVptPczCfwlVd9
zc;+y{H4NURzZl|nhS|#q2N-4guf=l(`&iFW_AsSNzL?F9Zm(~6h&7z`8~Y6N*~NMe
zvV#*m#PqxM1@m}`rF_@Z;`u2y@f+;oiyY)tzZK8xnZCj6d*<<emhyY7;V;?5-?NJa
zJ>ogcz*k(4nQVE+ym_1vPB6-A51Kd280XiRU=M@U?spjCMTU9Hv*Nj+*FM9IZ0FPL
z<7*t{^54nZJ^F{)>|!xbu!^$|=~ouAgB#h;LmcBIQ|~pt-|Kf?&tkq57ten(#?t5X
zD>rd~`#H`Lrrl?K9@g(%&JxzMnr&?4C_6dt5Aw#3bAnr$USl6&9uKjUukVw0&Sw)>
zvWvYO;&D#$5;N|1-9I{CSj{qavz7@qGx><~g&7>;;PdLX(Z0z{CcR+2a26{VVm)`W
zm3{2x)dSWWbC~p1=N7a0C=2;CEBF`IGw`B#-pF3w#}WRCNwuzfOgv|^kiTLj2id?2
zZ0CZP)SVA;lrJ;of#kryn9a;V=MxvPk}t54<Lu;HURF0Q<2WB<+9rL(T)zIex-p;C
zT){?;v72Rowm-9;fd~EEhM9bx1)O3zZyd6}^C7lyKYREbhdIPRoql;mJm13teum}z
z7VG#jTR7u{c;3KaevW~M>`#pIDJJ+5gPZ++iXkrfi*>{bMp!Z|pKM_}N7%=={Z&3$
z&6KaXUuQO(Si~__arQ~;fMIrUGyB=bF`i&*y?*_hb;NQOvyN5V#~7bs2Z!0uOC00;
z5%CY}W9G1m#oWd!9%YOve^*b=<pA?I&Sgy7;(mp>%sgcsa1m>{h0SbdH^(`|%zs!%
zT*Qp8n;-Mp$TCh#s0Y*7!p-dElN{lBCPkg=|CD#W|6j(<eXQawqt-7kvWFjfRUJ9|
zjJR*;CuVWwzx6+V$coEf|3|%egzbEdeGHyeFV17iRzII-HeX;dga7BcT)`OEa-4lE
z{igNK8oqDbxVV$u?B@{2Imx`&<fFlP#sWrJ&LP(Es&n$eRqSCMhZ$$!TfPr7IrF@D
z7O|YGS;s22a3_2CXAbic1KXUt6Y|MJ40DtbzWIXlgdb!Z?_-?LGQkN3zpbw?$``Na
zDEBZW=6?FW`h&Yz!YK~$>PcUJ$LoGp^NVa`jGg=y2Y8s{9AnycuS@^u`>}*2Y+*Hz
zv625|Cud(0&lMbJEz`d1_qfbucuG9)Vl_j7i&M>)|NV6reZG$SIwsi6V59ZG5a&$0
zI2C3IBdlSRTiM1=#(9DXUVDZ3N9+#_G0r09CS9DW;!?)g!w#NeKd+vCacYboVCoL9
zmzcxfu$X6A#aYSX+00JPef`C$LEgX#Rxtg0&SB;;#!`MfcyX$hm274sySa};Ji|!_
zuDm#v(PTX`p9@*Wp_GeLbv(-!CS84Ts)rdfE>4ZGoJrr;ZwzrS!#uzUM;P7db<!K<
zjn^~Ik1@eJ7<^RS7~)x$@MP-6sT$_J$+&qJyBX&YGiP3$k_`Xf;l-&;ewhVqV>u^T
z$MBnto9o!aRcXe}JxqGcx@8vM@s^8Ih1|#rHn5%}Y~zes#?3iQZ~=q6+`ll)+Zo|b
zM)?HWIK(*r#RTX4KSg&OUu9K30Q`y*ZnSXH!iftPO<c5S(!~96;nGDnnz(S$#6=4i
z-e}^Ysf#8qTDoY_q=}0rPMo-K;lhPCnz(4<l@?80IC0{{MK@ZsblSqP{l5J5{fxWk
zo^zh_oacStI|dhvdqf_X#$twe2gBUK8vceYe2Y=eP7=?R3^o~uX*|jhr(YtTOIgD^
z*ussB@~)Zcj6+O*)Os$p&m3nlmn6#<o7l`(*u{*G$``L=+z#V1ja>|}mthXFhF8oo
zE*CP&^^CEZ!N;6$rg7jh=Y#1fXC_Kn##%nXRt7$HW}=(ZIm9(gXjZ?>;7;cAB+HmE
z+xcJ-+qi)}T>J4e6C>Qm#K*0dnY=1hopCeE*~EH|GQ!!HJ73J?D0eeyr~5Ew@h}TH
zeU3WiO>AHjBizG2zRgi4Um^YppA#^Pg=x+gn_0;i8+q9$)Hy5I&rKZT38u8TPR~{6
zOlC3DS;ggS;yvu-J`Qm5C!LdDxqo3Q7pALoeupJI#A?p|lzn3!qby>Kr3~)!yvsD6
zW{7d~>^qBC!$!8SolzcSjM<+)GZFu!@tMgFWXL-&WjU)^&zITGg;&ZO3pvW4GO5+)
zGt6SbeDmg~S<P;?@>`!dGttZYIl>+${#u{NG%jmc$epa<Yi!`Z7-9TX#^t9t%2iC-
z?fHyZe2;~kxj;N?+03{sb;cwPv+n<#ucz!QvzdI2Jn_@4;ZnA+o>5+zEsobSq0P9=
z;9(Xp>$CF2`&rM^j4*zY`SNod<t`@u#{CepxawN<#VS_vw`}Bbc5rTv`r_9)#_uqB
zkLL^K@INf(*FPuE{4txkpIsc}AU}AWzVNjBY^Ji7x%~X~&NauG^;`WWSN=GQ6<o!>
zXWR#IlpC28Q8&!uQ5NzfD>(P__KRED!4~%OFvmE+<lm|H#q!PyhS|Ux?qLgi80Bfk
z82Ezv-sjvgjaM?ne1^G-H7sWfw=l|GjIo2k-@9Ih&P=3phy@IM(Y`T-^<2ny7P6Oj
zafJ0u>~R0gOzvj^GnZI5PqT@sUvjRwj03D-;92K_Df}~Ycz&LJ<BhChHJkVZJNXg^
z7<YsC{eFJL6n>UDEMhS$S;ehvVmmu|gab@lYTeJNXQuH^hWHr6e3do4{6=}>3PyPk
zWBet9ou0Fp#y*BPEnhsZVGVC!3-_~^uXBWpzbtQmFh6E;oP|tYCU5*Q8+a=t+{ixG
zbCf%obU=S*7UOOb&v~q1F&ns!5!SPh`#H*CCjC)87l`LAEaX~Nu$B$n&ItRyDsL<;
zwC*nT!!+(=h=&;F2x~a)X6xn`80B{u<5mWrw;xR735Gatg?MgY4fnI<-0O^TlrhHN
zBL1N32Gf|w5NChQb(CvZ&pnKA+Dhx@bsXi`*VW4l?hA_53&SjC6RUWbO^pABdSNqT
z%vhzrMZFI*xSILAi)DP6b$o$syyjMYmCYPx^qcnkMfX$8<PZxu#&X85Hg6`go$2gl
zHb=OWiHF>0Fq7L@z;2fF9oF-L+r%@Ky<El-wlL{W_KR6e4cl)nU<E7Lz(IC!(zo;{
zUd=Ink;&ci#cbZkA~v&<cYWJ+j6Y^KpWqOmXZ)Ytk1?I^F^|Dg{gr8~<x;ltPImJ#
z4)ImSA9fCJ7ta;UV;4(#l(n3*Ry;Sehpimun@sqN_1t0Kcs296iDevN9VeIBH!f!n
z%Q?(lOz6=knZe`CXYf1XxsY|tV;jHC9^S)YKFNfa+#fN6XPD0=>%_B|b-ash+{+$z
zbC`+W6@SF%s?6Ye=ChV%+|D}wmu<{17taG6<1mw7){pPBZ(PM9o@ON%+~vB;CU$Uu
z{fxU?JTGB#ug_(f%@Kw<yTUo;Znp3>M)~>gIWN4A!N1BM)A$@i{KR_k+{SuNuXN6M
zIS06zfurWb6rN-bm)_&PiKVROqip8X4X)=*<{(!w?iKxrX^b(%kKSusu3!x}GSugJ
z<=mgM<J_O~7+W~XD3?~*2bMG8Ro~AH_A#HSKd=v6!8+c<Ha@`~zRF=<w^95t&*RKs
z2Mc(N<xKdYeDE^1^Rw*bdXBJ`iLc2wGug)iPOTQtEY|Z*w)1}WvV$W$%*1~C_#^Q=
z!2+h;C!YEDi)Va|cowmbB|laNe3Z$r+pkUX#upgooS(=Wx3GnMj56?3b-)e=kLz<x
z<Fw7<xss*)1#5ZiXY$6k*~7RxdE<H}zM*~}P_KNLfdSW1rtsg)Va^uy!CH2+nM2&m
z_&43({9N97nuYWa4^32XHXE472sf~gbsS|slTL_Z7CX0EH(zEAvmdf<E@hPUjB$+d
zZ@J%Y(6^Y+T7GPsbH*j?XE~Dx{d|IrJb3QUd7NX6|E1Ue=I7na=6)72u2DW%$|i1N
zC!ga06CQRBPU=rg<@cG(?JVJi+tn+J*~WwH<NF+C$s^YNcR!bB7H2jYmszajS~hYc
zI~ZX<4{?m^c35{zA7CEGACqrh)GXgz&j>r&$F#@AaWRws;d;buraqxgn8jKSv>1<5
zeq}ta;26u8e9CytW&?{DVI_mR%$Kv+!A$mZ3C9?FQa%0CJek9}t?moBoK>u26L+wa
zT^!(P28P@x|5`lD8Dl+z|8icL#%_jqieUzKs~^r|3yT=#7RGp-!P7q1d`dhoXNb8B
za}8_w09*JRqkNY!ey&aYzg<_D#%&DoG{c<n8}VGk7OrNLn;GL?28W$9rt#kl@gsZ0
z^9t5*F<V&3DDP&BKW6Yh?mL*qeGKt9!#v9xCO<8n^BCn)##qka+pgnG<1vOf$}p$4
zi)Rj7xQ0<4<q*dh|Bik9tvX~e^VrH#o?tB}?{(k6bawM54)F(!AMyDv(|P_g;+e%#
z7O|F5wy~c*oD|Ww_z5Pw>$#E{{3-MKD$6+Scg`Q@vyDGu4<F(%_cGx<@5>CHzfU}`
zWEpQ`9iL_!W9(u4@5S@$O!%+AZ_W(f&wM_}GCsvRPVErS1?=Gp4)YEsjLJJRIm!Yi
zJnMSF*{o*+BmDAy=YdJj$=m<jFEgDtF^@Z0$_Q&YuhY1Uv5%klgTBM<OgiJ|*UVxs
z3;7N!n0Y||U^zRumHphyF&<^|`})uy^*au+gwwj*H*h|i`DJ!-3kP|G!7=wYOyjKQ
z)f*Qv%$2O+vV-Q$a`td5hq;dlXYDUDIP(Sh<_eaxlJ(rlb{=FePjZCEqUJrWZkf$l
zFX~@hz)Ci;nbQv$mz(}%y?mI-6Rxw&W-p7lq+8$O`G0mkIGa%}WQ=W$4@?QHIc$Gf
z!va3ba{h(&jQflEawdCu4M$kU#Pg>3cSgnYO%`xlkNL8djZApSKJf>P@of%Ini5!f
z#5p^EO5hL^;-&-^yzG6ryI0@k0ao!PHt{WX^1Q#QGhW8P1ycf7GKICwVT8r(XBGd$
zCgvQq-@K87{08GDPYK-1R6fjHKE)DFeMP-+0h_skUA%*XJjmdbDS>}5jm!Gf3riU0
zF4l1RtNIHw*v)Tph&vb`w0@@ZRp#-ZEalW=&Izw)E0?pIzu*ujy(azxQv!)h=L+WW
z0LwVQI)0>Iz49~c;paKb5++QY61blk+{t|IXBm4~$HlMPe+G^_XH4f9k23XxQv#FU
zkT=d{374^&Wo%|WyV$`&#t+DQ{FFc;Q@Mt@oc*SCGl#WYe8RX~&0bb>g!`HJA?tff
zy)%7Ky|eLe_L~VO?KkV#$w3bA<lpVrv?+o0G3#aGDeGk>%h<#^9$_2f{wZIa!C{7(
zaG`x=20NI~5teb*ka*^^jV0`16^FT<2?<jI^ZzBD1<dDama&?3>|h&X>|yY<c&0Jo
zqA7tEW--b_##q7Nzx72nv6Gz~;Pheno<1dz%2Y06E?2RH?X2NJws3?|PXCYd$_xfS
ztiG7Woec39!%TQvJd4=EIz|~~jPEg+I3;kwJK~wd5W_5Ggmpa1HclR~ZqDT}moecZ
z&I>bm<-7Kq`K)A^ja<(T4s(FNde68srUZV^G#+D!;|%ko|21!}WDB>mo1GluDaK#y
z9F96)oXb2e{hxfZj1Anv2;11l!yIMS8P~C-DS;)-VjT-P%1X|7-@N%Hc5n^*xshY6
zXYwV+AJf<PM~0bo*1Wl#EnLee)5hhCi<vOfeldd^na?9E<BSRU<|?+aoISjc!`#J$
zOQ!^0WCo`O-k-?l5|*=+_1wyK?qx5Ja)gJ@d*AONP6-S#o6{z}KT*VVRx+23T+R+Y
z%YL5b7~{_u|55eIY%X9CTUo_##=Sq$!n+yeR)%Ly2|UgkK6CDM9zFLuFTCLWi5O=y
zc$s*n@i0RiV3>0zi|1yxvX$L@lS7;}<^75H6#bLwY-Ju_XDNqS%gI6UOl3C<IK&FZ
zf6V!0I)|CZ><@@P_vftTybsDN*Rq$}<K=}1m^|A#`jEV^oW*Qq70WKPZniPX<cr?-
zdx)+dO!&C{Wd<9V&&kv6C#zV`2-|sxy}bOx_LIw)m^vkJ7c==27VuRzaAu<Y<06jn
z2TZ<vO5o?r=6N4^f1;B`9AFItbIg+|e4aU+Hp6<D&MM}!i52W*GY7czV*7Z-l)yTs
z@d1W-gkerkl1FB;l`GlJ4IJWj#;3{WCGSsUagc?aJoEjD3Z}Aw*^F>0``E=XZn*UQ
ziPTT%N6GTYmsrL*AC*7e#a=$n5e8?;-(0UVlZ#lue3tVW)-%R-o?$P;m%TqR%Joe8
zq`uEAPD(LfUd;+FX9L$V!YcOhJ&v*MW9FMaCD6-UzQYn`&VGNQn&oWaRz}&$7zY^q
zl<WS-<(X4ct(WO6<5Jdf9ozT-dw7JyoPN1=&od4)xsnCkz;bS9J-5u!2iVSj9_1KE
znEYw|;0krbSuA2btGG1Hyt$51KEN1{FqmQdPdI1HWFA+tlp9#f?QCVsT>0i9j&O*H
zSIXZfjmxBT<1)-jZe}BovV*ffW!}u;7z>y@e~SO-Pdr=Z$u~RL!#{DDuQTB@Qv&ZZ
zgO_|-ez}oltY;ku*~YvK^W++i@DV0vs;?{Mmor(wVwN+?2A*Vu$@A3(L!WW}u9_0K
zg(>V}4v(^!mu1Q?3)sZ&tDGOc!6AkgI6n(qUzpA&<}rA+d2<fycnjOu#U38zFq5;a
z`)c<)%;XLhu#e@;Uuaz3%1(B3fX5lgaz3vyZ`LxGyI8^jRx|#y_LY~hn>8HbHpc&-
z?_)Yci{zWDS;j`zF?y|h@iq1_DaSeFcbT-%dYQ#87V;P?nE5&RW+fxs%s&2uqnvS_
z_-m#F7BY)BvXBj|U<(`g3?n?rKBinRp39h&?Y@#(+{{9Dvx2ACz%z{S1G(av#Zj(f
z(r5KiW^peId59GpVFTxXUOe;J$6}814kj&fZkWYB7INxh@l0j|GZ^6t_OXGZ+{>hE
z<(F9;Vj(~H1@X*d18dpA-Rx%{$2iL59QzS+t{DGC`_6f+W<HzwB)izhL5?x*bNay&
zeUM9-%M&c&%rA-ODmL?3cJUMkIW158b?T0(EMhK4Si&#dAf7*CGeb+&9qTy65yoHd
zdUB(><AcoO<b3CMv3~Sr=Z{;M7Lw1KoCnTgIky%#58TC09_9f5#lRP>|0~V|*D{xN
zEa5&@^B9|XhFv_p+`O3ZRr6Y6znRWl=5aYo`E%CtaklaqcJoCJadM&fFS);9I={j^
zma~+#tmSsLGVx}8fPdyF-(XUn`*CJ5VTF3&Dps<Jjci~Ccd?%-w^;WL?mw8ue=@|g
z470GveH^RV!WKrkpD`}{n(M<-eU@o#V~D32W?-dwCb5O(>}EZO_%!2hbl<{szQR0a
zd|e;mQr2;ZZOkmux7qnkeVfZx+xL9uk(ume0Y_NQ`M0?)@+n4mfPGvOb`IFU<S$#-
zx6}<6t}*X(e%rXLU>n=m!zhP2z=UP;%?!>e)&IDLW!%R)o?+X$*KZfkOb#=|gqvIk
znZZ5G=bW|X&5f*QgzX$)FW=<|KY53B7nmnAd2F5QD)YbVdc%!u;ud!DQ4VlUx%2lG
z^~7}cFppy_W%8ZsjEmXEd)dQX9Ohe0SUx52p}WkR>CER6ma&|5+|D*0uaIw6eovk9
z0F%CIpP0q#)|)rmSj7Wu;xTsevhSNW*E3M)d6_9Z#2miCVqQ@xo(tK;CG6zQ9AFIt
zH+z4kaD+LWe2;j}WEFGS#CCS^2nRXHxE1bWn99Tr`UBHh!bPm+<80<pcJa!4#d9U&
zZm};+Wdn2h9!t2aN<6o*nFra$Qyip!RBj@!$aBdL<eeLt&uuJYaHD!*65DwNd%2t=
ztYhNWte=_eWdUO>=ky<nXFl7xmc881QC?DQ-&U#%W^oM*c`qyY0wX-eKBoW3`Qj2L
ze_bD9Hp^MWQ>@}+_vs7#Eu-vZjH&nQ3&oySna-um<F8o88Jk?+n8OHf_^Ey72RGa2
zZy28`{04K_&SD;96+ieh`^*qK`6CYSA*QaH68Hmid4eUpxX%9YW;SyxyZAB(d6IFr
zx~?*na~=@S5|*%>)%+owxrbdG;vi>j5nrP3F_pQ@<yw~TIBPh@7Jl{T^2KV#*uvm9
zU2mDj3+nY@-pNuv&pMuD8!vs(x#pD|=C7H!S{-dwAIxL{3t7&!tY-t;d4Rnf;s`Sz
z5`UX{Gm|&5fE!uP4%YKD+ZkvO&qR)J5fj6%3(Vpk7V-cq_!1i!_=WxELiVwgqujux
zZ|Qf;Vh0O(h80ZOCZ6AAgiY*Y7f1Ojlh%0t_@#KxXCXhw3YM{fyBJ|V`*@n8oYW}(
z+v<*4+{hv}v6AnxiHQ%ZH_qVzmoZT4dd5^9VJ_ce2|u!3-EcXZxs_2y7~=^BZ#VuU
z_MNjCVh>CCHfx#K<hsi_9AXyZ*Lq*3b1m~&#Ztb<IzIKN_3|+Lc#@+WWzrqub~x8e
zd(3>9$7+6?&1_{ChZy6uX7epGKGRsp5GxqwoX5?VA+~Z2yII2_HZlG?>TIVvW0(cJ
zpXH3Qp1~)~n{(O60*<nrN$b=ZvslxjFK`#D*v%%MVkam4%04lXf$vTUY+@>}-z8sM
z#Zs<kEo<4zNl!Xo?BFN|m{hKhGmAN`>WfvZ<PJ8nn;jftKjVL`k20{^xOduL<}#Nh
zT*YdxXESTr#Ys=eH#?Ycm+_gw3Fb4WO&?_y>$!vN>}D^AIKuefIG1<3pJ5jJS;%o#
zFnN!2!AwTDn0@Tv81H)8yenL%n9JX>glAaIh3)zoix}m7jBzJ}-_x&|#`53FH@C8s
z5!Uk0Y~>s5X7XNj!kZbtUL7)>EzIM8S<0!;i06E^vWVSGi`XwNWYYKLhgsahLhfS)
z2id@k-&r@WV;^fc%56-l)W4X;Ar>-gpLi}|16MG@Z?TUJ9OV%v-Q(vbzZcILEaY5P
zuz(HR!U)^g#{(SY1d}#+PU;ZPr7YxqtY8Bh_*X_a{aNu$<tX!+bg#TKi<?-;zp#QA
z?-$QcFv4s`@AG`i81H59etnH;3_K_QoXt|^v6iK5Wi7i|)v4~dgNZfzGdt?sr?8(>
z{-CZHV)6s>%^dDxF?(6X5jHXLfOE{?AI*z%8Qfxgrm>76{)}Pvu!ad;=EeE!W)X*2
z$@ri9e1qw%dtU$H9+tD0^&Dh7-(fFjAG9tOF|pp~4a{T{3)s$b9%nt1Ul7lQ>}5Vj
zxQj^-P6<56EY6JD7cOQ6*RX;2GQt<w$7392=8N*S)q0uD4i<5Mm3)_t{Olol=X&<@
z8IJJ~lOK|wKZ)mk409`MxRWi6>y|gp<PfJG)`uGG!^`>*6OQUboZqJpv4#!Y#t8SZ
zkNq6wMXy@-FVrWqxPpb;!wUAZfu|W^>M`-G<|t1xX`At16VI6}<Xl#86&tyY9sC{p
zIm9u}=(p})s&i&@4U4$qb@j#v*u+!p<aNj0*Rhpxjh+XX%J?_*L9S*A>sifqHuEIA
z_#OwDJ|O;K&ks!HcbLn^Si(10&9iJ~@|)thl!M&Mxb5nashoX6JTqCsO|0Qjws6i{
z&M{XrcJ6fsAMyDp)3}ErP9L=IeEM(VIl>msIw_u+j4_wNCVBXWedp4D+IOyI87o-F
zU$c#WWDiF<%&9}_=FusEFEE4E%;#2?@i6N+>tEuT!5$WJm>Zd}Lmp4-6I{e%Ze}%`
z*v!}2#hL$>H>NZ0F@2e-{62FTVF}M07SBXBGn-vp%|Z4vp;<jLgNgq!Z*F8c>sim2
z*v@HhJLgQ{2<J2Laea|l{5uPo_>OvI78`g2BYcp3{5?nci4pa>)88*)Hg~;i-Mr+#
z=FNIGb0@o)GHTvj$KVsrBTM;b)^h&;^h0i7H|sgX(~NKNoO8xJxsQeHW(7ysz*+B`
zCl4{keg=PKK4a>N%Nb&rVP14r9Is}CkF%e_ap#fwOy1?(GMkUEi2bbOX*M!<!g=I2
z4zQJhC!GhTaGW{Z92lD@WfN;T%vMf1Z)~EQb2-EU#<yArv)Io<UNUKHqJqoWz%V1+
z&p!5Wl%q`gwR3pBcxJ|p`TzR#Z&vdt+ZbaHXIwBgG0Xxc?3QO{@Vm_C4wkW>b(}U?
zJX6@iOb&A;6P~iK%-~Mu^SmkIIgfQ*#x~x@9zMlkP7R80^E}QBu3$dzU>PH<W0Y-t
zg*}}70rAXX!f(_UGg!@hHn5BbSjQo@aq3j@tmGJLnY?F8;FrwiAr>+2gJTnwT);+#
z*uf(9^FEHTi^)%WUSc*s8!w(~Sjo+7<YVmMKiSX49}>@XOm5eAn9V0y#1U39Zkl+0
zm>s;1{jB5|cQg67?uVGoUKVkjmCU|SJXf%Tzhys9aEy}^#P9Xo&TN*jh~=#05822)
z?BEdlIqM?v%wX~}&I7Z#mPKq}CHJzC7flz>MeOG)j`40LN6equ>|qh#U?r!0SUf}Q
z;ClA6mSb#U^6%^$vpK>dPEQoim26}=JGhDc+`%#KWAZ-dg4vw$5%FBiN>;OxjqKnF
z_H%?|Or9bB_r9Om+`=L@vy#JX<OLUtXA=8a&M|f}xx@W3vpGFUJX4u{z&ShjHLqtS
z*RheU?BH?sbC_d{yTtqb(Ya$bOIgHC96O|6oqPRHKJPmBI{VJO&gnC~KXcj0<?P@Z
z_OqU2Ji_E|<1w3oOU3g-R&o&=S-}qOVm~`L#vUgB*>f7RnUyS_%UQ`rHgY#Rc$EDN
zd{jL1n0(m2GMkMo;t^JIf{o0cC7w0x=XQ>9FO&b`^~=U4a=0O7Y@(RGtm59;V-qbb
z__+Seb`G&^jy}_)-qXh>GP#QdJj8O2XBwC5t}-si*w0l9jLW;3{F1t3HdC)QE|;^4
zVK%XroowU)yXYT@54^$@=46>Sm$8`lvWmZE6W?MdKmC8=S;D}}?hly4t;}JR#hhRj
z(-(?oHal6w0ai26t1mHy`<cTxS<JvS;yH^=%x34gKhGYU7-S*i{wjY=<uG%3(Pv$s
z_;FUVl+E18F4l99`x$rCb#jq-<}sHmS;DkyU01o0t!!gAt8(lcvp(m#`ik?$bS}Ma
zY$A{CEalAW#j}pBOvn{~?sX2aZLxjtbDqE8`oc)a^@Yh_wC~JhJ-^0w?qV-baD)q&
zj7=oIsxL5;SA9vn@<*)V(`@4TdDhJ=4l<u{$IR~r>*f*WvURC-bNY?)#tJs`G`qMq
zUp&*lEdDk5xoK=7jqep$H~;$;>*k8(*3BNaGWo04&G{VSX2$oso->`@%;UmB*Hzxf
zIySP6d)UMGILv7`%iHVrml?c@`CP*?R<VxVY~u;`FlmK&ex3=(?JG0*5cAp1GREB^
zp4sf-QV#P4CcJU(=Z@mItVkT!u#6j7$HQ#nAba>f4)cRw6F=abF@v?t=c6oRJL{OT
zQarQR!+Z|2kqK|g2Qzqx`JDN6@hoB;pJW^Nvxg@+%!Fd`C-iS-u!#ArXBl_0juE!;
zUG{MPH^eiS32#{^Gx!qoImj}`uM*D%Y-0&~*vMh-X2PKS-YT9mn9oHlW0-Y3&JGT<
zpOZ@TIbO@;zqvnQHaD|~2U*GUzo}0$haFtTe*TJM>|pXq^JO-ttrpK})^ICZ_%fqR
zxNU4A#@P)1-E%C{Sj`Yy8Rk*eFfJ^f*^F{2W2|K`=I@g*ji(vnjBkl&4r{oUE!@c{
zBaE?!!GD;~8u6UNnjw9SE!@B;cQVEv2LI*UecShQ9;5%!rx@dX48CnY&b`h)hL~Dv
zK3u>WR<ebg8RcHaIKbdL`oQhtxriYyXPEV@;V!oDFryq~jJ0=oo)~d|#VmHRkmIc2
z)-rvIv%e#bKjaV}Wc<7O71J49r*ANcrOdulzvNQ3Gs<4BxXb=?h^g<1zgrv+Rp_(q
z`kuPs!S(taqu)2)xz{W8*Z+F`9`(Y58}vs;@73RUsLD9p`UB5P?B1v^j=JxyR^QC|
zk^18L`{aWu_v?oY{@A=&$PrdB@qe!0%w#tUIK*<!*koPIVLOZ2%S{|%I}^{C$4|tw
z^{2+=7%Q2)+4{Jc9V}x%!#|T3Zg@am-nUQ8<-sl1$^LrlWcq{V&D5>>I2Se;m)HHm
zxMSwSOs?5xTyA0|cd?O&*uhim=e|ee>8#K9n98+H_Ja*9<zCjZm#ut<-MrvY`@#*3
zA9tRa&Y$eiNBA(yc#L)2^_YBdKYMwSBYc;M6P|mT&6`Cm;FB!p^v699GlLPXW*;|j
zl&wq(1Or(+-LLRg7V}P4@#k#f<Lu=79ORWxSoe9sKn_zG+GX8b!%|kVmfP6M-R$N`
z4)L2$TKA-2U=P#T&pc-QT0Bcw%R_AC?A_uy@|1WU_>Fa+9}K+5OwQb6-3+muO>E$U
zPdf+v7Y7+=H}AM$;A2eXa^^D35*}p@1HX0NIh|2fafo{ve?idCFU*^z%ws1@S@S#d
zX2I|67r(_`exD<3W8&ms;2<+Ox5K=-l;ymY_2*t^`?=Sj70>H9!WB%M5)ABQCOcTb
zBP{1B)^pN+@m&0zI%Pe_IKbqfyfK^0I@LM1vy$y>WH&pw>JRR3xtoCx1OsQ7!h{3r
zg=sA2B35xZo2CW>YuU-xbFaq-16}7{=cGS+oio|VLJqK!fe!@(zhnygnZx8R`@%)6
zW|+;aVHaCC$UV>7muW$t|JxV7$2?we(7rH}wOqwk-o<Vn;1Kt`;Cg;xFc6H&E3ah%
z8(7X=tmmW`og=2Rk1IIJdL|_V1N)i9{6p5wf<LJzZeR;r80DgF_Yn*;;i6z*3p1GZ
zXV(udV+AYO!0CtOi`g9DVFsrM1EWmi=D+A0jIfMLd&IGV5l(wa9G5fj;b35hY0Nz0
zddFid<LsC98%7ynLa%jlF9V74cT^mAFvNol^CW9H`4#Kr97egAF|KCtBf-FZOyhz+
z@!Y^t9%LP-y{c|mz+P5!gqx1Z?~GvJj@Q&JH?oL*tm2%0b-_wT*~l1&7=N+z^Sb<U
z74zB7axOWp-noVy+{At^e8YL+My4dGw*h^Ex4&t<tYQt1vX$?#o1qi-mB*QMiG6uX
zJ+OYzeEGe<nJ;VE#Mvj!mq!?5-`~x5W-#z<%zW9ye6Ie7dSGx!9Cw`-$Gra-kEh=;
z-lfjVi1Ap+LRPSXd)dh9cg1n%d+MHZ|7*Nt^JY3%Gmo__WrVdn##Y9SS|{glh>IEj
zQE^P?5#}-Of8x1-wG6S9+t|&14l)0X_*v?J={(LnUi-dyE@LfQ*~Vk+VPMR<S;B<N
zoI7UnC<_>4ITO!1x17UvHnNY)$JKL+ubIN#%;7N>^9-w)I3eGh!%pty5O)U7P9%Ix
zzhwqLcHY^Ee6D91kFcI&Z0F2LXZ`+5FmMY;xPghYog-$lmj%o_|LjBstJuJ%xU&;o
zJitL-e8Jg?;Kzf3y2)oJ()ld&xFTp=hFQl4*v5nG;omvT;0Me*H5m9TGg!xbKE^Wk
zv5u$N#?Vyp?BobjKWN^U>l@7E^(^2zma~=hJkE9wvzKx4;yI6rbJQWTxPyg^v4S%`
zWZleWglpKx8jf-sldf<sn8kNk$d67F&wMuURz`Ri`&h$K4lpS#7`Wm>@jS&MmL!~=
zsN_aA@<Dd+3HH-3L;HOh^?uRWiR4eX{!c&a|MSwXS<Gu##T(ef$Jxmt4zTURXD8z3
z>f21^o6O}qEa8_D&rVcx3!C|skDT@YdD&0KxSqjJsw<}Pk{M?wLhNTL|IJ#Sck$VY
zR^H5RHgSlzCfWCN`CtZXn9l*0@rq0AJ5RBlXW7dOXWBR3#>7uKC(Pu!OXZzEW(6DB
zaPD<RI5}C~c>_n8@KJf2XJ47k8(G9}u#&%HBmG0Oet*XO0tYzEz^8+O^DjF)k;0EK
zhqtqs?W|%&ioCIzU3`Xve35Y(&gaMEonhuOefHUjFbi43YPPVAQT8y#6AWJIzLRO3
z{c(9`Cc|9C8kS$~yznS{xO|TD#vM$UAN21|$~$wfkauon8M|1=O=<GZYd#@wT*^`I
zW722T39~qPuDmmY6>MY!TN&Zs*vC<ha`q?1XSxnCi`!YqS6IPQY~Xe2;`w9tG4E6A
zofS;J%KVtk2#Z)cPu{tKO>AK&6F+U=m`Xpa3Ve+zEMpF%Eart7;(3J4yzfeR=PwxJ
ze;B;lbIE*p=NR+Y_8EEOA6dssGv%GD*uyzjsaM{|#4PX6Om_aCd2`-E<8m{bc#NHl
zE;23`Tzl5<)z}}V^91wQbG`n?MY;0D?Tqjg``8z<-i5)y=f9}VSjt@1vV@JSW-FUH
zV~ILtItSUs_-j0;FrA5CGA<XglqIa?X1218-Fz?4df9!0ea?3MUuvIu9SgaI6+FQP
z#@%S%JjQ-z<U1dq)i;^SZOrAgFRO3nv4)o}GcK=VH(NNwXBodp|7JSZ+@!u4EU-^p
z$2x9ZuD<y!dztiA^JXp+uXQe&$$MD9URH3N4V+eJ-dxT;R&tb&F)1e)c!^n@a<g^w
zCRVV94SbRjzQ{iIbCfr&5dS%SgjtNcMLgHAij{2Q<wf?3I~Zd-gVzNEv%aQ2`BR4Y
zUxvAKrTt<vTe+9rJkB8ozb<drd%j>6cd?KMSiy^m&712PVJ-Xk8b_J%4fD>mKg{BH
zS;(hY!Q*UT(JJv=&pz(uDF4c&&j$l3w~A*z3wf9o9AX2nE)mb=?Bk;xWe<}UyIy|N
zxn>iK`A=4H>S}r8SJ=sF4sgM3^7aMy_e|p>3~@ihJi{8!4eQ6ei&54y#vTSku6Io1
z!f%P^8iu)-HSA>zFIyv?ix}gN8T_I?#x%x#TRdko%-dPRTDI^NMmf1uJeM)JL_cF1
zf6ow)G0e+v7taE=u#QpgW{m%1@Js4{t#~eDh~HwE&#{)L*~+<hs2hej#O+MTbB>t7
z50^PFypHAEz<M^aoo};`7k$UR@ir#k;5;&$M_9yRR&wz=`^MGmWCI5nVPL6##}rQe
zu6<`Vi@AnXtY;JVvy*A%;<=208+~5E6rN!Ym)t3yRjgtin^;pJZ~PTwO#Ys{<$J&N
z`V1E`j}NevM_9|u@5>ugD_swm#bK^x!k6WT89aQidS^zJdgm@S@L5JU%s!s~19{_B
zOj@Qcn9bcR;u%&lX`}lWe))&`1fv|{)N1GaCi}>A7BP?av6S;_>=*0U&d1oxzjB1>
zKQ?ZGe!?tnV<97~;FO=p7dJ4<PR5w<Gwc0|{>u!$$O4{XITzF!mj!I+V-L6<aOM`*
zgXQMQRK{&JU#?~;pJg47vyF2fl4piE%!eAx_pAE#FYGV#S<F@2oC`*NDULOb^2_}k
zWzWOvqR{pG5$A!+8Rotw<FWfu`@-3esVBb8;LYauxb<<xPI=+}C)5%D%qG6YPM+Za
zvs%>Q3g6EZ?qV(@Ea3@ObA-*D{44v(Bo4BH!CQiX&;8ndvYvU|u-o;HjjZDywlT^c
z{^%+D$z~=N>GRCw01NmY%h}$h4mtHV*2@!n%$sjB@HP2<+P-iVbNK_7@M%`_Ae%Y0
z-MpE_L9S%nO5-w>!_4L4-^w#@W)1IV3twP2llIzIet`*J_kGOZR_3#lWjxC|Uigf4
zvw}U`#9{U@q1b#P*3IQC;7?f2hgr`T*v=95vha8E#s(&SL;qkVUt$5T*ykK@Ase`i
z5w2q&w{Vnun6yftU>4tIAzOd%{IZLUJi!j0VLu=0khfd)A*M3QT%KeJM_J7o&&oS9
z*~P^iWC`O+Tql{zdggKuOW4C|o?tTr`^9q>2bsaRZ@TYbDm$6W<1FDYtGVhq@vLGO
zw{wtfj9cy8bc$yVbGecwEMqlKu$h5Bi03R0GJ|oq=|4<mDRa4jC2V9h_pzDX?BXd7
zGI&6ISYKf(vzW^eOZZh*a}Aq$54%{$K^|q?x8#|rjQvr6U}l%PWd&>a6k8a4ULWL4
z#<-60Ys{1B>}MX659(*^Wi3lyaNXdCqw1ao9AX9Izpd_=&X<_SL6&mzi{hEYR)*Qb
zC`UN`kh(3kK4$U&3%Ke}>Xz%-z$1)sZnwJS8jf-^lWx~Hn8o8PWaeRgj<sy!AUm1*
z7yW`E2G)B1VhYzWhuc}qgRJ6dHZi_OJQs0*Mf8^o1C=jXHye)_mmM$LFaC+m4EEZu
zbN*GnSj_k`{gmk(Wge4{$`|LemYdkhJ?v%=hdAjK@!xS@%5>)R8JC5uU>zH{n-LDM
zkK-IY=d0Gc&h_<}I$<-zJjxo5u!T?c+b7O`-9E99iQm<SnZ;|48<%yg<Uuxa>Kpn4
zb2-3O43yg^rm%FtdfCBJ9$_tGY~_6?jLSw2Gs=WJofl>>@Rq*H87yNu>$r$*T*)3b
za+sNe>f<hbfjNAe#f<x#{bd@Pn8i+hodbN0fxE5aq<J$Ob1u1+CEUeocCeXq|KVJ*
zfkS+o2^H%9lzH<~=5ry-xQulyVH=OJm-YYjxdNYK^7rJ2*&JsPXAQ|WtJuUSyBOmj
z)BmL(tXId(U>EcGPnPkL)5hhEY~wH4!yXRvEhc>5`}|ux&mVRkIqyH}i#yrC2qT>H
zw(9`1ImX+WT<P=Ecg&j`Sj2i(axWVhWd~P}m^U{w?jH5dR33U)op6Yy9A_=l-cu)B
z$Zj@qgh!dU!RH{%WZr+xn=4t)E;jOi?BJ47^JWppcz~(*dOl??Kkz^M%rsUr=ZtZ=
zirp;d5O*-4%KalVIP-n^W;)Bbg$;}{!j3WZ#kRBVlYU@arm=Y3digL*`7&#Hg00+t
z-uOf>FPStxG0Jo%ZImZwv!6wreE#@EC9~Mb)$HI=4scf7_(b4`_KPX}5_7no#oWOv
z{)SEb3p;t)1>+NgEMu_RJ~E9_hIp1?et7cuL=8i1;bV-lhcS*Y_#=H{ig;!+#FY$l
zJ8O87Eu0(_&n(9H1qSas_j$c|{*NK9`ha-0u!ad!$0u4jkKMeLLrnVM_(c5uu3Jp!
zapv)3@#B8)D;W6VhsOQhm!FGH6VI=(hglbn`@JvscTB8Nugv5@7I0R=_(VCYSkJv|
z=P~v&?jrGQXVQ=D8?!jVLS|1NpQzwEHZaNv&$5qmKWyJw%%n{|4`vomvyjP&;<=0s
zY-NNe*vC~LvF|_8ubIMw%wft5`_8Yhinp<e&Ftg|2RQd)@wLt!Q<yqa-Wg_?g_p`3
zf5ukE*v*{e@rhwBW5Q33&kPPQpEEu>K2gRwtmDiS^X5GEaXCl1lS!M^5wrNqkBv{1
za5t;j$!1QTJwDOJSsY{r<9?>Dn8x^z+i%{%QvQv#{4ZOXnQGqr4u@FH_&WQ@4E}@p
z3|?;DOko}8vyCn6<u~Sx`#nJQa>cmc1N6Bqv$--&zPXWAe4b6r{DgV)4i0iZ<F>e8
zWGdffE-#yF-E3wJUu6rYe$qMN=NRL&jQ_d)N;hxTF`qB6j8&gfCyX+}Q|#lhdFIVI
zpEmD$pSv)d2Ux^jRx&-qyt$m6tmFXqFz}#$%@k%{sm@r%V(wrSx6HR+JkBo8{)~0A
zl5ty|FQ)P&Lrln2XG~)a!))O`MtOuW4l?+VK6#b>=BF8A3Bzn-4WDNV`xs^J0`XkV
zV1xe0G#+P&ldcxei&?`$ws775sTamL#90gF{TKQO)47Lv{5wl|^)>2+-((x_W)Jsq
zm}5-X=5vy4`^GBf^Asys^jUf1Ms_j6LB=hTw_n<Crt${nvYlZbVGV=Vnm6Y$$`Z!d
z#$cm-GmRg}v2La@%-dPR9=34t=fty+F+RxP!^UA62N`1S_14XutmP|g<v-ZX!d&a-
z!%Wz29?YPB*m9zfi&?=!Ht-LOFzpND6aD92=NP}w<VSqY%xn&@h!=&_E7!A;C)mlr
z7u74TqJN|@u!JcLGl#ob%q~{(e{A9xm&iNUaFCBM?os`osXWYFzR40U{F45}Wo%{{
zySR~q9A$8addstJo_B-m2`^(guVg)+V1&g>&6^t-c+9zG3dfnt8*Vf%Z(%j7*~~ZC
z#rS;VGJ|o=ejdYA)-ad5S;FKm+i%{@7B(}=C}Vt`!N+}`yUc#`YKC|>!)#{_Ut|kk
zW0XlZiRU~9cd8GjaUDb4!7zJR!$5&}&SR7-8E)}h#~OB=d;M3=$GO)z^DEw;AqIE3
z&NGcW8RAif8Mj<KGugsbjB*Rpo^(B7h{FtX(N}#x*Rq9;jIx_Cjx*S5o`vFB$`BhF
z<}ucA>doRAVw4q(@gRf0_I$-Ormhgr0*1MTH9WwSr+j{Ri#p{Z7IQtTxQk6Z$xhBF
zQZHP_K%2T_3imUIr&-LoUlY$2Y~ogS@*oE|X{GqzxXv+!8<@l0EM`Be82@#z?~y0w
za65}R#ww;4dw;HACpU3`5eA;tN14JI-w@BmEM`5c*u^GJS|y(IIlwXo+C2|2g@>8L
zaTYWCR`D!l6SuLGhZy{=zE~pf%wmX@3^U=I^3HO$a1WzA!5HVP7Qa{jW*TSRCZ0tM
zvz9gNVGB#b;u&SjKKCo%@--JQ#`O&T-u|xfeq6`sv-%=q9AI$2`uMij8DWUYrN-k5
z)^HPBc$iVHx?MaEGWeYOUn`!O46%Y?#@`{HWo+SYMtPhu&Mp(*soyb;GruFAg$%QX
zHSA^!i`R)~7h|0CUGaagZ%pG|3~_3?c&=p)TiL>XMwxP_c(yZmKp(lwpL025ypO>@
z+E1o&<=x(w2N-6c!uv9VEi7l0!S9J@DT7_k57T&zA<kMao_kos8Q&Mr0!CTQ7^4h6
zZ{I7$vy&l?Gt7DSi03-CaPkK6T*DY!7(D2HglSB^S3KJoW@43iE@KNfGRlLDam5eB
zzu;UmjbjWkeWQ4mv4(L!6wffD+{qY^G8na=)#ACEAx{61c;>T)Rcv7wqb$5nJUbYC
z(epafIQ@R{oXarpV+~K7`}&Z+Rpa~r<oSXbT=Zl2Ip@A+#ksFHx!#}qnw{sq{)uzW
zyBO%Uu3F>pE{3>?VXpkC`zm&@hetWgQ%v}?{a^;K+iX0pV;S37$3eDnoISkmXX07L
zgv07!i{}p>WFhDL+<e){2F|Z{oo4Vs^JOvve{sH<!V>0iD~q{{RqSFD``F3JTg5Yz
zfu3_eUlPv-=I{WEd5TpWXA_ei63=uFFo%JcoGYfVkvTlfVg?$-b1s`$z)n_jfCm{k
z;yf_K<X^}$D_Fy~*}~Fo>VYR2W3W-aUiSUWU<UJ<%Q6<SjvLv=Cid_UhZ$o+uR3~I
zJTsWj6&(Jn@tJVc{ldA|Uvb{fz0OlCV{p6o=X|y?pFLd9VKy+KPac`U0p@e+BjTCH
zIxb@y%h<zh%y?DbWj;@^jDaTK&$(=4h&^1#Vb(F>nCk>H*vEWMdQ?19SjQ!7W0*bM
z!eO>C;Whif4309Nvv-JR4(mAlnEGS5S$w~G*r_gGSI6vND+f5~3Fq&)I$=7uGM_`N
z;EWdc%dBE2k21!kPnyRY^3P13U?H<w)epC_lM8<B`?-$60qbWPf5Q+zxmz8vlr`MN
z7A|?pyt$FXY+}Nj=YIa@-0{vf<FSSnjIx3MWQ61FW7=<gZoq|1I^o<g@|J$VJ~o|u
zeb9M6_xj&lXPCv)EM(Fi@6WkxU;!gs%|6y~lslMo()Es6JkCM}pBB%VY+x=&xtvLV
zmse(S3k%u73La(yM;YPNcH=RVqg>3Sn0jOuH?oketl)k&FvbYau#c&~70(4s`iJW>
zv$&3hr_|9i_Kk%c;9U&-(|s3HxRW_N%3@v^(Kk4oO<c`RHgbUb7#LFLOyMc!aOUsC
z^CnhtHJiALogCl*#~JvS{;^Ly=P`#XS<Hu6#a(RTzu0;1>)(40=K$kRdmpAVxx;ff
z=dqM4S<8pm%3bW{X%2DPv*Q09419{|yq0;aVkytCmf`*4xrN=F{G52sVf?V?E2i_S
z%;Q5W<u2B8a;JEvvYU@_h<|4Mf9(Gs#B&AnSjSQ}v6l5+K4;|9?Bx-TaF~g2TgUUx
zDT`Uids)HlY+wf?JjOnzAM`xUFERNY_b1F|4U4#wl^kUgFMdJZxqt&KU|>XDF@;^s
zWiLxO$ZB2@^<2vTV;BFQu=|0lyQ&{Qes{S}HgThg3zg<|lF`D6^Ez>&qN3tN!-<QO
zCQdXooTzBzmlPFk8ci}XQdCkhTBKyS&`4>K(V|6mGg@T0$iX5bMI$5c?{z-+azF3O
z@AE$E@vy`0^ZY;Ob3W(u=Ry(T7-0ip;9dHYFq1HE7wHL$2rCH72pb672-^vF5cU)P
zn{bS<;8&!7kK>Fmlkj1}0>VDR3c{2@(i5&GY$sgtYtCDQ*AtEtK0}!NZ|(~cW)YsT
zoArvYn6Q$tgRqhCRl-if{}B!n9`zf>jc^@d$_(`+%qHAHSWNf^VKrfdu!(TR5bHc)
zKH(7IBZSk0KPOE456@u;Lxld{azB7Dldy*H4#F0~?-KS9{(^9r@J+%Q!sJ&uzTaoR
zPnbuzo3Na4;qN$J2v-rd5k5@VPq>|MjBtoB@L&3oFq813Vfu~m3c?D)?+`W+ju5sJ
z`hHJ(!XV)o;X1;=Eb9khCgE*_1%%Cn6@<G88wmFkwi5<kBR%0t!ZE^p!odGHE(tRU
zn+XdDy9p}@cM~=cP7<~gF8%}Q39|^t2saT1KA?XHGYMM=3kY`*RuF~>8wlSfY$wbb
zCOu)>A34tub`z#X*k|ma-w8YZM86UKn6REObA)~)TuazTSVuTYI7S%oE%N#QOu2-)
zgaw4>6IKv@ny`WJ^Mvh$4-@ti4ib(L{)sTKV3F@1gqehgyiR(;RfH9U<%A7{HxjlJ
z-bL6?_ypk?;Y)-8|03TsVJ2bHUr0}QIAI0hNrVlA8wlG8w-WXfb`p*e{)#Y=w1~gc
zM0&y^!a~9=gq4IXgj)%F2s;Re2?q!V-=N<J-y%#6Eb^u9WnV%VA}l7nl(3qxnXrj4
zOxR8M9$}a;_*dpTVLoBnL9~-FL|8J$IzxCHVI5%$VJqPd!d}ANgd>EbgtLSj|HeAA
zaFK86o79`|7{W@ze8R1SmlAdmUPCxQ*g!Z=_zlA3gBSU}OPEDCKv+olC&Eg?e-LgZ
zOxZ_z!XV)QVGiLq;hBWV$@CLp7GVcrA>kgvO2SFPt%SaD(i5&C93ZSD94EYwFnJO4
zfiR2k+k}OLVZutnB@?74%qQ$1+(0-$crD>LVH08UV)}zHi*S;#knsHdq$jK)+)CI&
z*g^Px!U4i}3C9T!{yXUpS>!u{FpKaLgoT7>5LOayBiu^ZM%Y0(KsZ47HsLs7<s{>l
zvdDKkVTf>uu!L|gVGZHpe{kQDFhtl*xSep6u$Rzx=px^L2!n)c-{QPZSV&k-SWZ|^
zxR<bv@Y;WJyb<0(I7*l{#e7{tJi<)EPQn7horD#HdH-U*6IKzn6K*H$C)`6gM!4c_
z(l1@)dyX)ZaQQo=CoCbXAZ#FPARHiUCoG#LJz*c=7@_}N(x)!+ts%@LEG8@<yq&Ou
zu!XRJa3^6qVVJO=@B_jz!qoRj|Di=Zzovf)KTFs_xNDYvTDHjdhyQWjJ#3M0im-ss
z3qK%V!Y0BY!coF0!iEU_Py8ndLxisomJpuji$rP&YY3YO+X=&j_b!M;W(i*->?8kK
z!t%65{Qaaz#J7Br@1qAr_<rCb-xUiZk$%D&!aU-I3Cjq_2<r%o4~|6I2=5>qC2S@1
zk<W{SLBjon`Gi@?5&q8CBHwz#F2Wwdu=#vZBr;7{NSJmw<3t!DY$7Zn>?W)s3==jJ
z`WHtcJ%o=CjuO64m`VLo4v9nx2=61TAnYe>AWZW`|F_`w4Za1nsSA!uIXJm#fzSCo
z18RC=U*tFwrQqOH6J+vVi2n-j*%z5QlpmI)p0^}@{nA4|pIq-d^T>6pPRd-#r%w7Z
z!ql(s<NM$4|4ex`{8!57qb7aqf2OQP{u}Pz7dh5^cJ7kY`~2q|y6|!;#6OL9^4|!4
z4Po5<WljX+gZy{Q^ZO#prC;QxpXBoo<A+IK?|KUD-a~tjHh$LsUw$^epYo5CewmxT
z2p_}KrC;iL6>jRkO8PafH{x&NTKS#$-|zyN{!TajAijw9X+DV`kAKLdpX=X3H+_nq
zuS;3_FB?z8KP=N<?4~cmQ!HME2Q1!*|Cjb@_3OkZEk20<+2WJ<ZrthLx%O{#>z|Tj
z_v{0B(E+^b0N!{2?~M5+vj6?j0d(d+?z4>FB>o=lUn$dnTC_jl^UYX18-E`^OQx@N
z(-+|xlz)QsYhACxv+-Q%H@e=47vS3Q*@@>`d@z=OzRdsgZvK;a5$TVWF4mWngM7YX
z+&Mny=EqfT`fU7iT$?{dF~3yi?~g7pW_+sfZKQYBkGcFWar1A)w_57gi8orxH^nZv
zy|~C($q#<?-ix@*np@8^G4tOMkM4`y%RC62b|Js)DYnKH-jkG6ljKyy#3|yx+aBM?
z{+f8liFoHXCfyTAN?Slo)1Ey3OuQLytv|{R;B^P^R(#pq`Dd=KpK<%E7f;8v^?n3j
zV)0o#fS*HK;_Lmn_auEG*1imWomwmNJ>U3T`C>lh;k~#vpUUt)T$@jI_%7V5|AG|R
zihqZ37?R~XW8m*Iy<o<mk2p_T>cFqY@@-ejFk_v|ns^v}P;AEfq6^$PK|ds&ZALme
zZ_0^xTHC(JV<ui`Uc3jR@l1V+iGMleIej|UXScg!R*m0*A1~Wf;d&F^Xi49NcPZ&j
zdy<*kIp5kB`IR%ag>HMy9Di}4Q;?}Aw+?*2`_8_|4`e<39r5-Slh3V`6QbP#^M|J9
z+G6rK)*p{oOT4>w?2D{5@vfW~@1t(KHsU?lvoCV8iMM`Uyi7OV0P$L1+!y%^mqLM)
z=f&H-C|>Rq@h<J($F&Xd%pb&(_4|VxFFnBc?%o%9!^FE~Uc8}bJkuY^i`hT@VPE7E
zvOhLE#X0jV3m?X{xmr&-#*0ZG*dWUBpYLQ6<nwmo1cvuT3Qe3fB97R@G*M0#akP4L
z;UQeBM>1=qadVCgyn4RdFR}BasYf<(HqX`LIT1(HBmEGc?>^#~wJ_ed{&SqRnEuMe
zpTkXiU5~cacqzUY&zCONj#}LR$9<92(qnr;GmnR;V=DdtKL?hHI&xh4>)dhaBcGdz
zmvBxc&h<nw^%%t;z*op}#Gcic!Z`=`>Q9qC81rLgdU4Lo#~Vq1l=KbJ`UUx{h2zlV
zzlxs&8_#pcBX(XjaT>^D8*#4V=XhV5c3$DOvx7Kc;(S8J5%Y5ZAH}`e5hP8Jb<lWp
zUYzUJL+qbYxE@)uXJ6z_S%&{MrxK<wvhgi=QG&a3q6mKk*XBeOz6;mJq7k2ZDmIpL
z*B`gIeb9+_kUn3QPe0vE6jQ%Jd;mXOdXbxc5`PKz>LZgrWl7YvvChVKl3tr@Mfe^|
z{#7y8@^8dnx8&c6zlUEV+b6I8@Vr0mi<~B%{<$I6Ka+SVuFcf~*2ogvnXAv8<IWK=
zS96wfej|=;u9gtz3F73>tH<0p)!==&){bU;;fOwt-S{l&wRsfA-?#WQK7(uXJS~-e
zqWsUv`un2?o0%seydC%IN8=@U8?KE*4c?1u^Pm~;!?k(Z9dj*x81J{FpN@IHY@b-0
z(>}y?Jn79mh_6SnIpDM(f6J18NzB*C^w+t^VGZv4^S%hf;O2jx>&^HS`JXDi+VyUH
zG3l2{zrgh{K1=%5(#3s-=~#NLf78g=<ge8~glAalUxKILTK#MA<1F=W#?x`F{@t<k
z$H?}TiuU7Kq|cImrR&pp4zA9BE<l@bt$#uX@Dlt%(jPC&7kk_qycMS!?)Z!GYsR<X
zS4j6qPpW4Ab>q8m_4vmJaIOEQ@z?ORGJms3@^6!W8aL@CE%}G={T465$8oKFHTWL<
z1X;egPtY98Uz<POc;Iz?e8MqbBl8!>-!#6Q^xE;4#tC#Gu9Y9ckH$}z`PaDpSAyr^
zTL0GI8<g_R-fxhKosCbMYlRa|ch5td%aY!VUMrY!>Ls5gZ|sX`$H54mifi*^7Vmj<
zU*uBLj=BAYKYByY<e$NX_22Qb1pk!NP~&;{?ooZ5%kVy2n}>A=NZ%SuuN?=y_^c)W
z5qvT2*XH4DEWMV01~)o$Nq@U(|J?PJ|0cKn_(S+w>Ebvl!#gbfUxz<!@m9PY*XrMk
zKa6YV*%ACXOZwSZ{@VP=;70b7mip!4ZMb$El;J<Ywf?EYe}{V=hvqm4)9{_Ra~ynf
zoq8Pflh3v>y`RSLdfaOqO*wh2hkJ16T5D-yIr3U7`v~Ix&9eW+OK`0}tMCoDc3x?W
zxwfzA#5XGWn|1_P*G&0NJ1#vnp}%B1rpadq@p9$7Wo?<eW=!J-<!+@MbKHmUL0oG`
zNzAo&)Zjyw{F@I@es?VYJXwEnofO8$$^R(nv1?LO|7m;-*N&Ss5=L+>{}6uEo4S|a
zxj2ElZiw=0fDnF~ba9>1jDOOSe>eU)i-+;8mhz|Z221&AbkY+_{z2*-!cTa3Uu4U?
z`uoe>b6_cPTFAre*oJ(y{NI;w?Ht{Le-qdC;5~S|CI4akYnJ?H@NZl4PyYz_8SxWk
z8!O%R<>EUn<(J~mS-cj1(o%j4-ie<g%irRb--Gw#oWk8XCa(2|@fUIJ7@fgiz_qn1
z9q6%mF22L!rFb{4jz9hsu8u$cJg%MldhiZB;a&{K&>eJ9kS-a<!}yf!AKbs!?Za8(
zwC#&MFP%HT6UW@~VS4y7=)8Vh8-qOjPxz;08UA9Y0F%B9PaF4cLlCdS7viNdy{V&k
zCf!Dyb;Qw*gFd_f*Y;SW_y$~?Cq63j+lTf=mY6!s?E%HLND%MCKQ3Kd%jDw+lfRQb
z-iK}<m*d|h{q_Z9Fy~3%avm6%KB~umPakUI+=dU}=Mp!bUf%!2-@<98>*AU2DE<$e
zp>|!~|2&3k9g7F?{kYbD`S>VK;N~x`MazLVaIJmyco^5_ahu7Q{<Y2He&P%gr$E+0
z%;Pb93fJawU?pQX;XRLo<Z0gM$j5E-w2(M8#POP^W^dBQVBdki!_R@A<s|M+{^rh?
zCh}RoUmx!-yc*ZWd*}c@h2Kbe?b<w*O-miFjaLr71;2uJ#OI^9HZR7v<Jx?y#yfEB
zcx}RW;9C2-4&X!h^Q70>H-+!Swf3blSlzhRz8riC*V<Q%zlCe<tHx*XHM0N2wRsc1
z<nP{lb+cY{;gz^{JPzTTa4r8SyxQWaANBd}wv?ZPk66kt#$UDMUyYAhya|8LQhpa+
zJgK*D2;Yo<O!n_4_xPH^ufw_Iap$i%-=rSLdCQVM2frH6lj+6YyBM#>*<QH$m$>Cu
z<9FaENEi2hn(%G7b5COKd?DVU=)!m6+H;^G{MWcPKd10tSv-}F+l8BDH-3DJ^*je3
z#I^n{2EsVSxaq|^3)T1@OZq1K4P5J=E_@2tj;|s716;f2p2E}qG4FgMo@=IZ(=;DH
zS=PVG9lsoWBhE77wog0{EXF^Ldz}Z&@mq}-H13O>WYW*=H#k?BCBS%-anf^`y7`Oe
zfL(YYuB~4~_&WRxGQB@~^W5Y=g*W5c{7Ge_^8~KVpB(%#ix=aMTD%&61lQ(A6W)e1
zOm6$d@!N%e2Uo`*e;!xIAO97eu-}m5&%pf~SH~YudCM~X_)^?!e9V}3@PB^X*$4bG
zOWg;wkk4-7Y3o!E{!?5V=VAQFf9lsCGx%bQr!zs`Cx4>3;~<^^<>CQL`cizF^y>8w
zK4!_k1%C@aOO`L*wd=u`QodI|n|VHr`|)#Sda-Yw!Lx8J|MYD3VHVHDKW8bw6yIbi
zzZP$><lllnZSfxb7nbse@fR)S&)}n${L|S$Ett~#Hy3}0^j`ZkmKdK|$KS>`Eim)s
zqwYMv;44XufqM>0DsnD?oaZeK<dyj^eXh6T>9|)}W~}>T&TTDsu8Q{x$M9vO*VeQE
zi%F`*Gw~%BFThjq>ty+{n?a_275GM6o2w0YA%31r|HbGzC&*{*_!j)L(xdOeIS(UD
z83V+5jyPHy$MG&)Ti22~;r<-YlVyl~O%}cv*T$eQ=Gquk;v<&&ZN>LkyaOM$_yGPI
zu8qMs9(-FLgXA3M2(FDm7M_dS#-NBeb;QxepbEbo*T$d`Z^E@c?mU1G;t!IZp>~gh
z*mLh7A5G$q;Txr!`z_)f_*8EA4G~A%f9BwUcXThtPr<dhUX6bo*Uno__}!NDU3iTp
z{Sf|ZOZqANWlQ?hHLNw$`uRNv&%m`YD#nk(z0NCU3_4hM^YAnIIq-Mh%9`8bM_;pY
z*28A<C?yV;>h3s-_td-b%W>`89L6hft&Y<cH+z&K)=QKA&!&zSiaMIP@*8(AoW~~i
z$anR6mf;x|uftd1OJzI7dmyd&q4+ZC;@(^@9-*Gv@iv10&*HQAe=VL7^7;OQvvj!Q
zAg<N&@MP-8<2Bbm>Gn?<?o;X?gzE6O$^SNfj?V+r$FckDW-Nv|m<!0`1%3|vW`#Rn
zOuX;8Wet$m@0GI5`C%OY1+LABWEQ1YaBVEI@aHZ07vkT+wXvwgzisiY_)`||z@Nmm
zz8=6I!M)~6(6k?K#BF_D!20+)ah$%s^CN0shq$<?eoybK61?2vHFz=pN$M3JcYk!^
zo3U!f@5H^@V!Ru_N%0^a#w+kU`8l4ynJ>{t_dc^f%V8btBaX8_dp5&utH=H<lN+aR
z|J!?iX7Z{duQzcgug}}_swS`W|9IzR+SY`p;MzRw!e?i6AHx5Rdz}MK{!{q-_&R=$
z_f4!{jHl*ue}M8?B3&2v=W_7laBXagaa;SUannAQ9yfpU;F*6q?Z<<-wzhZSt1Lc*
zhj8sUoWj@OTK!W`WiM_?pM$T&wfm#R_-AlVb8h>tcH38tUyqx$E#Cj){zenN1wUN6
zc&^ulUyT<^XKtIXSeX7B!oQ4b?VG~CXz^4g#*Mhvz8rizuC=ci-+^oGtHxi%we~gP
z&*ED9y6|B<UA8}V&Iy|K<3spe(#^3i_VUxjS^d7g$4NVlIf85FiV%JxuI+IeS!*}o
zXHtj2|E0TYi`e7TlE)U}XnUL%yc*YzgC6{LT&v@-#m(5{utu8n&K~DaA9m|#`bz9^
zf_cRKuU^l5e2vA+@er=vFRaINajhL~_$j#7*E6)E6nFZ1rD%uf>oM}EA&%D9fz$cE
z8?N<rCSH$gbu6&B>FZY3T$A4E>${h$ecebtYiIR(cH+4fAH>(;#d7Y)zJHU!XOsB#
zxVAQ=oWZ?+T)X#}jaT4a{bbIA4XmwO@GJQ_@ZH1RcE--Be(_!GTJn0*QkNFI+2TF;
zeK<{W*HQ5f<}m)$d}nUo7+WW2@IFia=}f5S=BF3==i<Ma?;`(FeA1GCE&jU2Tks+L
zQ?h;H-OL_5`G5L8U>Khvy|#~-!S~_XJ|R7y=TJCHrQ5$^pOA~EQvMq0VxLfouf(;v
zR*R?MhspHfIaCX7+UGUb%v|olmsxxm&%jp@H-4TK&;4icBXO;N(phj8TRa#4kEQ=g
zaZ~?wvV75hwYcdYt^Zo^5U%xK4}Ki3_1`dV+Nbs344!H6^s_lf;#&XZ;@P;@dDx6k
zDQ@yFlI`dCFz@FWuf>aTZ6DBrpJz$mgWqgPKa5x6+IeRNufnzdOFxHe7+hORbMYoz
z8=q4AZd_YSYw-tgukkT!=@1KBGkzsM2d+!CuBH9tHDIaB82%!zwIxu%J1&;=nfM5<
zwWR<b!?m`wvev$ZJ8k*yQfph9$ZO>XdcStzX}C7;hVT@NPvHTaTRiT%Al_$6<$=jE
z`~>OZo<|P;qZ{|}yQ)O`*cTPeye`K5q}R?%)p*d7e-oaAGh}Z4IBsr@9XDNg3H~+d
z{s++L_0teOfM1>9(Fe4qep7f#M6X{eH-J~+YWwkZxK_Vnd=swKuNr?9*Xq}VFZYeB
z{nv$uaIJnrcmb}}Zwjx(wfd!=&s@i~`sLuk1>@@cDaKdhTK%f=GjJ}$-0>CP?P|hH
zajkw`_#mFJuEw6<2FWs+b!`SW*G~cN6~@nf;=9e$<dNYYSJ(D55+8|s9nWSCh44&E
z`VxGlC4CK^ZAssZud<}?#zU6$VSJ6nr|}&8SlSZrAMp-D+6B@4z0Tc1l2kFdE+#!&
zC|_V=vD?Sunxm9Ft|N|ieyGK-uy_k@%FxE32QRgxAI8^P($C-}mh|cCIsaPH=i<ed
z^riUO7O%z47;62~f**&kp^xKZB=(m*crN}i>9O}Df_yfN-*WxF$Pv<`ujZOhoO?~P
z#4*Rg(dL7>cTvPV$ha`-|1v)JoWeiuthGTt%ER9x{bLJ+vsNdG--l67oXWts=RVuy
zQIFq-C;8{)@vi%PxScrt3%!qdb3FFrQ+UETM_h}H;Y$woUb9Rc0xTvO_{01hZzt*f
zTb-sleU(L=ZN$;`5QX?lc>cUR=Dzb>iN9{C!&ZFq0Cngj&ZgvX^?TEU_*1x6he^C2
z_u6v?sdvgn?33`H&ufGKM{Yml5T|U>xcUsU7{3`mM&=>jAFIY|aP7LT3I86>HYH&!
z%+g}Ux(gq|ua)kPzF-#Qvmt!>;_=8|q?@t)t=ooa;=D>6?bu7Zn0~^wI)?E7;@Ua3
z1YdE8_c)n4*5DPmR!0-3g*d^KapyguggGhR749X@KZ)bj4wJ_Sz88O-pA+(EiuQ$x
z<NGAnaU8>2%+GVjxalwPU6xGZ<Q_V%{@$hnd=0LRc?BNAwR$$-$KeUbmZ`(p?wEBD
zXM?4T0ldUg#yEc70m?|B0yh(9mF$byJ5NDAt6;sX!_D3(@NSZO-t)Wr%VP5QF>$oH
zQH{Tjd-a8x-%a=sp0JjQ`z~GhKX7jQx#K0ib2)@3EgAQ`uFoV%7Hi?#q~Fha8#qO@
zf&NY!alc!eehJT+QoZXLB%fUTX*^-xMBhnq&O)XwWyG1X<WYz3JwP69#L529xO$!1
zhX--5^}^J16feN1_&H&Ii|@e%HgGRz*|_@sfK2>j_@`wavG2JA`K$mh$4jM~`77?{
zR1&9|INC9?75_TUt#h}Y;=R)jd^^te)^+oXy7;H*>j8YwlK(jVYfJvgmogUkSu%g|
zzFig`IBZ;fZ?h0zZ1GAw6<;m$kG-2>>c16Vfot=+0}tVx!rb<Y_cjOca$M`bar{<X
zyKYS`;rn3t<q7#;;&ia7Ul#rjeqDk`7fIuVcwU<K@nXCZUyXD5>DE8?K4OrMw&IuK
zpOrrE9j{K}JWL$zp41@TjB9-`iGSCUKIJmrPr<c&3)y%ZzD(AUYpl6BScE@>Z<6kh
z-gGp5P=ycSCrXdK>k#C#M*Iz&CCu%kdFO#H;v9Oo_dGOt4B?02wsmQmIGc!bxGYCJ
zV@%t~Sm0VaL-@J)a+zM-+b_ZMaBW{*gTHr{UVbzFcbvy2Za;|cK6c~&v&YrvIbl42
zYx86}mi{Q2zxaM`8XKPvC_g0qbM82Y@MYw$^<N2oF#d6wUhF4o@Kjt|3!3p2xOS{}
z<LfQy!+0sKwQm|P!I#VWiSbKgAvgJJ?F->&;tA`$Kl%{X%<~eU7WbOx#%u5ga86C`
z_=?}d)r|MzJi>I{TuAUwlfD}t#<lu|@!h!EetZ|Mwx1JSAFl0#LbyqPi>#kHPQ`j&
zN}MCl(T|~8JOw{R<{{>I3!aH<bGQdziLaIE#Xe{l&&9K(i{F7WgXiN{NEhE@OXoyT
zhiiS5i{FeNA=AgMugw^h;#Igd$7}K1@miVQZ=TLY$G8Q571zeN2Oq$XmFdN``!GI;
zYxSSOcj8+ArqeNfIJXPkIT(8<*|aYge-nR2y8kEf`j_I31>@@PO0LBlaBcir@JH|y
zWd7nlbPv8AUn)KN3YBw=49C*nEZrZyfnw@EgHMwFssxW-s2Wc%<9vOtUjJPDIQ)2-
zUff47#X}aa#m~mI{a_1TVDTROJp2q<zPU-xzccu67_YFTpTV!iwfU3&8J?9}(&yq;
z_(`&S@g7qtUXN?zTZ=!8n`@HzzFfQq)Pg^PUn5=ouDc$5)KdO1K5g+CJo!BR_)Xu$
zITp{8<%@S{a`6?ocKnp$85Xa_kF@09g0IE3JxC9pWyyaSKMr3a>wm60KW6YWe53T(
z3kqibq+iK75NDZi$H(vPhjZ};JX^YW&#M$~vUn}tifijr3;q!9bq+H1>xrdbC(9Sl
zmxu8kq(4f!*yGIL&*9qooL<iQhimI|E}nkAets#%gSeJ|ExsDR$H)KX?z{MJkFTFC
z_*e1H1b@o$AfNT%A1R!7JrccMaNZO*eKbOx&BXD_!}u)z7Ot(a87z(;;46q5ucLT}
zAP=9lcp3gauFc^(d=mGX13`*x#rNV|wz%b+eTG=)`-rpb0{uKNiu>^!WFG$LLT&oM
zx0(C+c)~S@-~BzdLA)McDbtI0@$>P!acvzf$M3_xBGdaD;^SP8PvhENu?=6iUccVy
z!&C4p7f`_5Jfe@1E^+Ulj}fQvLj8Vb;A(RpemwD=L4Wk(-}F%?z8616wn5y}Ex`YZ
zb9>CKga52}8!PZbi^d~df(wt{95MMf;Q6@MxipBk;}_vA{2Xs%bgnyh=uI92#Q7<4
zwDbKqe%M9c*WV_6GB*Ztaj)ko#<TD<@!uqgIwZZ4WEyF_5Pz$9JaR8T$LkpTrBgvZ
zs>Dk!p^xW}(=F~eH4^8!4f>kZiGLseh%7^Vw|o%aj%$0~$yol{by*50+g{QiCi55f
zu(I(kix=VT7O%ovEZ&GW;$G{4>EllPZd_ZB2Jw14VZHEQ7@voecsG8eY+v-0=8Rzq
z4;7xV<e!aq;%ptn7)J*n$VWx^ew<4S*Ufqrt%6fVHF1KMjz=nG9Dnq}#I&&quf#K@
zi+xcSUWIGdjzjokxOQHi!oO?rRBk}+z>k&Xi|dLU{6$<_&x-M^68*ZR8ef5HW7vde
z;MzH<3(v;Sk@bt7Hl6+*!i({<q{r@Knm)~9E$mC8f9dSNm6HqO$Lf0LZ##S_gV|!n
zA)NtQPd-P>d^S2$$tfrI0A6|kuZ_9Z&n@`HO8KT8Q?w)FXx6J#+VT6p&u>RsYOEcj
z<nvMT(T*t}H#CpJ(_}lvd=28MxK_`6JPm(YruXlNA9Lk+H?CdB*5li8t$uBI8?Mcl
zKKyZukK(PC@_pB{&$4(Bzt56?KHgyQa{O*w+eg;pdo13DueoeI@?b*$-WTuRKKx1i
zeCg&TL;h{%@hJXFi~ByuT*9^MxF8<bsCz#CVO+ZpQjVwMt+Iapuf^+Mk2m5^CHNz8
zZ^M^<%KKhhkTiXGA>Jp`n>F`2w-3gMGe#V3js>b116(@>GV$HG*Bmr;D8L7Crdr~<
zFV^i!;w&rmUe`??Tk+-i{qytqzi2y5oH5q!I^vkMF>w62d(4abB17b}l{j8|DKj6Y
z@P~1)wir*nfoBM~wpYu+2Q2A}@mKI4%Y9DLbIvBmtXmzd&sSYO9%<v}zzzG{HkdJc
z$Q`p5^4UYY(})*eqlsf~@j2@s`Mf)q&l)|SQS#Yxg`SUD$M46T`uzJ%wLV!}xQ;0E
z&d2myA-)3tgsksow>_2kD%|UQ5+qF@^)PPE>w!8^5Ak<9#)wl&oI(?)OvDlIwhd8E
z9dUArBm2$VnsLS-Z^n<3F0PAHZ)6XG-zi=E4Tv0k3jdh&*n3AN|6+UwFOu#*$LR>;
z)p+J-^y{rAyadme=^6K%WA*RCYjC!5Zu`W2p&|T5Tsz-P;a#}b{11|4YBhU6{FgHS
z=(WZRrV%Dih&Uyi^f;!SrNnukI9_{2<F)uHSL)A5TJU^)DRJZD7`yHb@=*_d0{)_O
za}0GlUG1#>BgFYRakj}g{(IwNF^h-F$0PL#{`t6P+{9eLzntKA$2|{^;Mvl}J)koD
zkgLYk@443D>nz@iUyt7=^Y=$@@|!;F#ryEp(#11~5qvlPGwJ>p<Mp4#Z{F<P$0q*_
zE+#kQUUS8G9$s$oGJKQ8>+mvsnXI39p4y6EjGrJ~to6OI{CS+^&Jpn)nGyV9(tFJz
zQ~z1~K0IHhj~#14KFhd;cRcXF&vXBuoi23dSUz#KT&>?5D93Na4^2291f27MsY5+p
zR-yMn8-B6H`|x}`U)C`?g`@i)yd1w>y7(RD=8ti{Xh|Q$_gK>B<DqNx^2_lOTr0mG
ze+KtDFPQ#mi}@N^fAJn@AKpiLZH!0pF8oxPzS<o>->p2$!<R`Hb1;ba;@UBme}MGm
zvGiBS{Ka#&di>wyf4X$>zEc~XcCG##p$}h$d$r%}6Vh4Zj>Mhcq5i4AB%I&n-x5e>
zk$JOHpT}AFIIi_mA-)IK){07e*phxLz6-xn_Jcoq!D;3}2fp|^@3k<958&l^yG(D+
z2M@brJxQEV;&`3=O&%$q=bkbCgZX(xZ#z53Qx0*izkWROoQ&iDu2YD~qZt2QaNheD
zrXKS7KXHc1<8YaWc>kgq|23}lWj8)(@i4v%|G3Owls}D!@e`%T-a|2coyNu5-z@ou
z@G*;*;Cn6k*WmBq=gRWM?<Q-;(?6$QQ+MM%_&G8?eLVLanJ_+rYscKQ$-hcZpY{dL
zZMc>`gx6Zqm*B0I^fmY}?sd$X{%^*Afop4CH~vR_m2Cf2?mQ3Uf5o+9bsB#S&zI@N
zIU|k5`aMhjA+wm@FmI1b|C`J1AXI{9<5Mz!a}0=g4r_@sL!5$nac(0I(+4eh#uokk
zh#veT{L?bMcqeffufj{En>vX5xwFJ+BaYUO8UM$<8C*L~^Kg@%OEIzkh+YhsHk9Gx
z_@@%w{rf6)c<@I3IB&&Q;8!Q4kKT+7@>wsw8Mm!hqr{maj@No+>gcQE{!F!A#~}U!
zuB}D+_>U}Jjz4eldb}II!_;N&`HesNAU}hT+VEvJ@mwQe|8!k^|I~+9+^pY!8O1l@
z`7;05To0PhzR2&R#knoumT%@s?3ymf$C<==<p6OCiL>MuJs;DSD&lM;&MEvHZ>xCc
zrxD+RYuA>Y_^o)JOfR0v58@Bu$4QTVHNZJ{P2w%MwwFm^5T3@@%Jkx$qHMeu*RE}g
z@NxWPnO?lZTZMmsA1ggNot^qM;{KZP2wOI{fBexG?@a%7;v4ZZrJDtVe;XgfZ^O0Y
zc@nS3%Vc{0rA`JWeF_)-y|}r*5Fa0LZy_5W!&gWb&x4Eby%w*+M=jonzm99;*BLAS
z6<NM`=V%ar;8yQ@|E7JDcqi`ni}oe`Cw?rY)bkym&-4Ck!m+kA?%DW#wVXGTWcqdS
zXMjcc_Wv7?>`h4j$9VcGyy}bNk!F&|``7>Fc>g!zqxkLw|9RXy@ojgEN8U)te>k51
zAYNQQ9@&tPKDwFD;<HTF!n^TW(g$t{yL;gaw<Ucg(0I^23zI5LW+rYiad+Ppi+hDV
zu35*AyeAg-96hcXgX+6@@2EjPH#gy>_|dWr(QU9Z$Gh-P;nztQziV>{Z?oh-g+GL!
zC)3B?YYXyO>fP+E@Pu<(^#0GM%s`kngoras9PKzL!QaQVb)W`Mz1Mp$Z}M-(uf?_F
zxErs=wfin%ybf3QKlm10tAE-(%u`GH5WWf5*0B<NGp_A#Yw)d>{G0LH@o&)=?s3u*
zKMuO_S=?)$oBj*qtMBt}e-NL>gZQC-kw53Wq=<7UIb)pO;PWloIv%Mbid%>1$;Mn)
zR<o8~i@(FqfzSTdJ(kS5^KVX7oxeBVLcBHi$Kq|!<Mk2mgSmL8d&e_v>!M!2d_W(&
zA$$N&CvLpn(N~k5c1_`ZxYyhWk|gzB-a){*RCLpuHpQ-wOxvqiM+09TkG#OoftQC8
z+y1?1+f7}|$m{FGOUO&yzpKM1@#Bdbud8^6vK9Xieunhu*2rl~FaF_1@3xroNASh?
zhh_Tc_R~o}i~I3>>Eb#d<38Ro#<l%O9=-}Ub0A)S|Ni(qEyF*+|C``%$Gr~!<5$Kb
zH!Tq9lPcrud8^6)LH*uMFMbYwy3AkPI~l>tEk28X(c&3j;vG!<3YovScaw+z9@o~P
zGJG#?=1jbQ#51uv{7qcDzG%h&gcr*6%*EU3!62XY;(;dnJ&#f1G!W<Igg)L8?_=Lq
z&WjJ}_X2|WTKpJU2l4JxK7I=Bb*~|dG%c*P`S`8;9C-HE?y)lWJE3Ct%T3&V;yy4J
z_d$EyDdL9b;@+soHOIjib^OTJ^m!7vpZoChoqnGCT~V3%r*N+|!{lFpug7!wIX=$O
zSJ{0*KB~Ys<F83KYs!GTR%|6sTC-lq4t$Np2k>HCJLit$*IGRJ0nV8g&%z(V&z#o=
z^UA5|gF^f{e1&weH?G9HaP6McR{W=Up-eCK-W~XU{4{yaN?PMLJ!r}wz!!dF-n9vR
zZ0<=IAII0=+Od|*L!K=B<b>lSJARyG;b*kydy+!D5WiN|KlZ(BQ+_4B4L8R@e2(~|
z7e~go;$!$4>Eb?j2mT(e-Afq2SATOn@(Y>X|B^Gooc80d;pa(@?fZ-;H?pU|&y_Cj
z$z|ayAJNCR5D(&c3H^6cy#FfkyhrtO-Bx@({-P}3|ATn_JMb}lPlEq8?gRMat$P2A
z<FDatGerNp_ZgDE!oKz~{n|GRUyp}m`sk&pGye+lP55%@7dh2)yb>?LKPlZGeW2-#
zKi+_A=dup`N&F`X>AT(b<N1&4=b~}E2=~fANS?{txUY?$AoGtsYcn62I%X4R)2sTv
zw+O$=;#GJBeu*qYeDA9fe;C*LuoG{@wf)Q>{u+IBV?zGXMwt3f;>Xd(j~v85=I%8m
zr5$8C(Rj*(oC}}Q-{Z~3FUGz4$fPgAH{l8Q<NO`*F{;9+@FR&EFF*GFWsr{=@%{Lq
zJcbI{m;cx~jGQ`l5$B<A>v;^}jrcnOQHIH5Zy;WeY2uV^*XLqd6M5h*3H|h7yq`jN
zpi3Wz5`6YqeH?4>w=Ld`kK?OoLcE`@a;oq2L3b>@=HUaBKOIZ2t+i=ijkZslry=}g
z+W&~GpZ}}z{w=|u#ak2HedntN&;Eh;7@B$1j30-ulj&~~?Z@-+4buJ5`y6JknZjCk
zGhV_R2wd6k?zzl7I43#}OuUd;GoNQ)!Z|fiG%w!Iol~oG4Od3Iq8@%f%tGRwIxpV6
z3*+rBdWdJqFX`{jRN+UytRFv(_$vJ8hfulr@!5NbDZungCqA@mJn~I>d?Yo+&oP7e
z`a$nC&ZM8jEAh+tIi9~i`ryrY%Gc-*Tw8y#@yy-&`{6}+I)1#&KXyH5`n#Pq_&EIO
zB>M57pCyjV*PYvFPCJ{)r~S8FpC=rDf%x&)jX(67zLyE(TXC<wn5joL>)?I(WoCYS
zb!TEd3f%coLcH!h%rjHpJLbhZ%dKw#H}qcrv%Vfw;IH9_$$k;fVH)sVxYlnY)MFUm
zZt8K!yn1}ot;ZnwT>gf>zE9$%Z|e0-`8s=OT<f<A*3FCY%T2$1<EM%Jc7fY(W*x8J
z&v(mAeH-S*JJ+pm9pydq54}FE_|v#{FR(Y}$I5<<-A^~;oW?r$UDCJlbKpaw9_HFZ
zylWVEn7!Rw`gcJy@d|vkEaw_`Ju1L&#<hA@9Kaj!n@GP*<{w?ooa3P#zZ%b%E}r4^
z<Ff<yXYS*~xsp82ka>uEDaqg9IS{^7dUSi{)FBJsV(~(J6Ml|NPd}R?%-T|k--T=Y
z>#g|Hc%Dozp6zttJ1yx4@O>5^$5a04ea;F}W^xN_0$wG{H}fR+9L%&Kn>f3PQzGMt
z@0S$e{we)k<|_PN{NjZ4=f=+;jd(Zy;{<;$?w$B2|1}=DD8UQjK8V-hOQc7$cgAoM
zzaBqdy178)-{$^9fmv5^=lQ@}KXH%mdCvz-U*vw1HScYGO)JHJiwB7tKi4>S(4%|l
z+L-4`kKHpc`M2N`r1x4AjrZX1S$r5zdS~A6DDa!NV58;F;2ZIiW%=S+T{@eaDm)}z
zT<_%K^_Kig@i5M1r`vwN`|e~do<FT$OSIqxxVEPB;OF3H$^2vAa|!ZUDr;i}ZthnE
z*7mw%DV`V3l1DvpR?0lYcN;Sv<#`dV?KAW6MqI07nZ?ce+)W)#`gcqnAO5jhM|0f$
zEjlmFShtf;>AQM8`|-;yK8Ba!ACm1Xbn_3i^8G?wTl+HcJUn4-GdCg0&(yB~FUP+n
z^Y^>YD=P54mi!y=S1sO-{}k8GKmGU+zD|}e_RC}VeteB|ac?E?80QaMJO5<jZ{gbh
zr2seW)8<J9K8c?$%NO^l8}P;NdG9+iNYjod<DD|S|Ec(~+>bZo8xuTw^TDJa!*}6Y
z`vQ-1FB$)sOfS~`OuQfWYM)s*>sVKJ;{?9IpL^VSJa>=xK6kEElh?X`d)FmM`X)RZ
z@8{?Ex@nGw9nm~YoNnUW{?mE)<xL!Mzh#&>9psZP^AXR1X7D!rbm_4%F=eDb;q(0j
z?~-oHc+zc49&y&s=xcNtUW%U}^N8M#@R@O`!z(T6Tk+d0>3i|}aIZF){73M1OZr*7
z8&5c{Y2)0UC8LdfH_mC%9SiZhrt|Qk|9HQjWXdnYoA4F<93RWe-2SV>x8Yv%%A{|_
zTX1dO_TmrVUi)9C{dmtuCe(B2EWU;GNBj7n*YAI2L3^6?pEf>sJsNw*%;cYkkK*~#
z#q+Z=vmma}y$%oJUi%TJ{dggsCiB10?Y~|;57+v41Yc+ISv(idmib@p=AZE-Ydfy3
zdwIA?UnJA}&v7y^^)JIKaBY0*@Jd`8-&Xu`i}&J1_))U_4bl1s`7Dif&-C9J{2aKf
z+g+E$zTfv0&t{0D^+6Edg0Gil_|J;BF&}Ti50@UjrQjUn<@h$m%^skKIyT^MBvHrb
zf9TfH+^ZRKuN6DU=Zuy5TpGYP;m68)h<B^T@y)n)tR=Uz-@~0_VQ#LA_fE3#&8+b`
zCjYr(MeGL)@ggO?X=fYj?FP~xwSac+d(Leq>rK+3(fgZ0;x&=ad91s?k@r4KU%YgX
z)8{5mH*wyc9gocV`Nv#cO`N~G_pDM`+jd1br=?Kd*F||I-tv@qUcPS=?~sW|@%+5b
zbn_}BulEj}h@4BDz*pzx6>{S>5HBrtB2r-D-7_!VNzr(w{xy`DvrI4396K$<DNCD(
z{E?sIZS)Vt>)nIT1}75V12X5Q*z@He$<o^R9ZSbV$2^cM>Lc!@`kv+(A&$0&1o885
zuX$m{wU#oBb8E#H==edxxcXz~eP{fMcP;H<%j*j?%!~IWr&-SN(nNU=kl%^Ki?=)W
z?uF@>F1!`LM7nr}Fof^6q@Tk7f@{Zn>UY?y;o9+>gYU(){wl^tajkyU_%e=@&n47<
zv(o{leNFgh@Z+S5cR0K73jA8>;yL3Gz8yDx9`8T#&cPJ^46d!YsT~}v_{lQ8xGv1W
zci>+0!PLLl;z7LQ$!L1Bmk-?ktUF(>apyoYdGt|6DRJU$5Wior8=t|oF$m-DS<+AA
ztB;*fulv%z%khan!CDnBKk4E4edZAUY^Hbpf+Q)y$MNg<Ii6k|n`UgfSdUkKbi&!Q
z2kw2w?T6^QcFvtA)1PhRRYtsz%Dl?lzUsrT!nN@n#V@tEZ#%~?uJvUQFR*w%ezqn5
zay*2eChJdMnAeI;`|9yx{8Z`U`&n)Hb(Z}5aMM3)WqOl2|2FxL;y2@3`+VQyT{hfn
zKAUkWWt}yC89xW!=yb=)jA!)MBst|2lF#GBt0G=}%>B{Ll&ME0z8}}dX)8X0-<gm;
zdb7f$@4$b&bRv3<K6m~V_s|FM?YMLAYtF?z)N#B8ckbQIdF+@9l7Dh1?@!}b%JQRg
z(Yb0eak7bXFz2_Q$vCDTo_G7Zm^jU}L+kHq{2@G7<{|ETHR0Rw3+4GZ>1^lZY3k60
zzxJ`{c*Og8-dKc*lbkgXc|exozssql>C0*SX8aS<qf4+a$Y*Ka=Uy;=gLG3y^w-ol
z<DE;KUl3<y!WwZze2pl@cYWM@9X4gu;=A#qW%>)hlGGSTI>cmR>e*`YSf%%6FFs)L
z5&RWgn{%^x53U`X8P9MJ57&;(Jp3P){LAoB{G56HXtv*`59;vSmrNx7u42>A;=5{X
zu{^Z-)Q7)L8JdscBNq2P%l8)XV`Lr0`)xt|Px!^s{n4AsW{mRjMW4{m_vQFHT)Q_@
zk5}W``ZLV>ZG4z{61b%!Vf{(k<xDqcJ`Rvi@Oba*lpysCvJS4tYxp_vNs&+N`xPcm
z3O73*A<kiPPC9EqQqtU<%pp#Qz3}<Ok6#BcX698Q(;vn76}WS3&8;)yo<}u)Eq<g-
zFYXC6;pLY6yYMgJ&Nbg${^B}i2;YCa_jm>=a|)ltuQuh+T|1aLC+d*)1E22`t0z3)
zeKu_j;al<JWgfBTyv9rLuj8CL+%o*F@%5($Kk|eL^>;Wl<5%KZ`fhv-zbYaB=%h8}
zhw<ZbCL&)*@aRd^_%wbeuH9Eidyc=IgKO(X2)_nDUFI+Dot5Bs<G+z^`uL|#7dZ2^
zmN=_V^q%*ojx8~F=E>YR#om=M-h*e6UTfp9sROR9T{HNj_=&QP;yNS!hrDlqUnJe{
zK5NRw_uxNG@SgY>m*RD6^zv)*uj5{O+#q?j;J?N{E%P^hDDVFe$A8j9q*uoA|1e&M
z5&UsnTN`KbR>e&nGP+q0@C`Em=$_zgQ-~RdeBul!c^EIpU$J;S-f!_Xd?&7rQy(72
zz1B}t{%Fk4kZmw0ApULK_dNF!NWWCNv-{><4?ZhpUEPbf@N?j(rxMoR*sV|}o>|8?
zgeD@5CSKCKc(G@UL9By#JBW9RiTBQvZhqo>fX&ot7jd*bQa8RA*V-J$-@w;UMtqGE
z&pW2^ckndnVqT@~;8`-hTDrJC3*jr0^)<W%Psf*-^mA*p*o)TS3oYrJ@vl?9HgCJ}
zui+=i`iXN)7=IG)k>|0bXPuL!8S`m;-CFN^VL?3YM_lvZcgXzBu_vxea*6XeaS9U3
zIL#@;<WY+6JY^zs_xwD>I$1}YU@q&d%!6{0qQ4%*nV)UMS#s*Ud#uDUQ_8fZ4_}9C
z_X|exd_3WNC;ncKuZR1OxHi^7{2_d)Y)9<)Fy-gtcU#hz<4yRNWqR=(xE`OyweR<~
z;TNAaq5gigKD-dWD<S{d_!>BhZ^yO#eJ@aco}PaYe;3#0Vm|(k#mn)3;mc(GV#h*|
z&+73p{Br4Lu8Did?Zi3qbiEG!c)G>M@Z}Z{yvUr#wK2}blW=X06yP7iwe_X~&&0j@
zz|5fr+|=(_*$3j@bvtg_uhp*~UyOfDrWemI$8b}>Rno6=&jEoS^E)7MZHzPVBk($z
z-XDEAC&*_7_^o)cbTfv|Su%Q_sU*&m#L?EQt@v{m@4$EBUVUWhFo6HuQU?=fk~nV@
z$F|<2_HxcVW8S^1*aex%BL`n~CfBv{`rNEp%biPfXU!@xan91`OAVfjpFw`{^OHCy
zH{%=eSEP&YId|i;_*v4UhrCmM7+-Prg!(<_Y1~&Zp?=Rf?I+w{#I^4^hwzNT3H5u<
zCHU(XMDK~m+b6!~T!U{|KM~n2>+k=0e9daceHZdfNS+sx-0wMe<2#Gy?aN~C|7MUh
zj8EfQ|4!q}E}C~ANBmx}w3pbU;9CEN@L~Kv3H6(bpI=Mx=RP@ao+T}cdkx-RO#PFn
z?A+cy=>q3rm#Kd<{@SHH`$))tD4xC>Z@O$E@+@)V>HSZ~`!9?KH%>%;mEb$$K8+9J
zuO{UG%Xt22FLVE=RPWyq-i5D_`HSnv68ss9*WjJ_$uhmT$KH(Z#I@_oZu~d6ww{LZ
zpIXYF#$UF0S|5MQ6F*PZPkdJ>gpc9cdRu}|;@Wy$gZ~N7llhBx9h>og<68fA<L~0y
z{xytG;LBwG;+#8;oAS3vk6za}XN@4Ar~j1S8~kZ|oIK)G6X!CSk6HJ{ec^KAe2X|<
zZ87E4<4@q)xx>V1C(f@dam+C@K%5!kXk#{xuejX%{9)23@8lg|{9JyHA5-%CUw9$@
zE$QMNuR?qmz9GS*ogU<~N_-Z#edoN9IDaeiKF^vucH(D$MsLF)ejcv1VG^&xwKk;u
zjQ6~7tqs|DaMMI&fuG9Ety|{Y_l~o4IOm>X;{5MQy$#j)r^~(PrfFjnej)BPUyOI*
z>+xgxIbH{`R~o`EvgAL7pK0;be!eG(r_21sds8|1DogreJOe*krWg0;s_~;N>6`FF
zE#8Gk=wEH^9KzE`zg(6t-V2+;7voy`)SolPxY~X^U8!G?GK+DOzin-)Ax?=Ujv40`
z;yg~A56gCl@9y{D599gL#k)tt_zqlKqi67!@ONZ-@!kD&HeU~2HKBfYKNr7YvwnZ8
z6u%GG>R*fBfot_|!5_!9`uE^Z<Nrvg|5*GSKaAI0JrQ{~!6)NBgI`cFq5kfH^j~oA
z>l(d%x%dxpuXBtUzf%0$ctt|_(FgIyYw-z-x8TQLtLNW?AB}7Cco+}i+Ho+0ud<|1
zAK=;^KTFnM?6Gt4tMHFY7td`<@#`&Ki`U?#GQD`l--37IS0{LMp)>v0gZ~r1Ey1G?
zeuI2AjGy;e`!l>*;yg&4FC^sQ-Y3uaCC~A3Z6B70zlUqrbY=L$%Gg>scOOiw)phvA
zpPNYhPJQ%|uX9f^%v${>`A<{7z^}Hs_X?wX6=$-WzUU{P=P2h4*$#0%HHHu2H%X8E
zLX%8B%VSMkc^&(y1(b8ED94=J7P{xQ>|NZ8y59S}36oC)`TPWL<LAIxiTTLy8`Y4{
zTH39h<C^i1#k=t}xOR>SAHb*a6G^WfyJ=iF9E<1Ej`%rNtgRuuK&fAlBqew<{h4qM
zF#AGreAE(W1$k(D<Q9C1#e47%=<9Q29Vx>MyO|Ti_)5|rE<JWnDadCtcsgDs-PAF5
z-z1CAOIRbziQ{}9W?Q2>|2)1AQ#i=+TBW}$T8X#e$I9}=v9J|y$F(u-z@Ngs)}x@w
zll810Ka(E=?|s>=YwUP3eKJWNqr_Qh;?M2h#P>Z?e$9P#e3kU8oKuFgx68&SajlL;
z7B|O7J9RYa%{e!)QPk1&``_Ghn#rf<2ECr$_=^?~<Gr{xx2Ew<i>Gm8;!%9H><4-O
zAK#9zlP<n*QG)m5YouT2wyy?%4cCspW_$oYOr{s_x^&~FecCvM@mKKEWqR>_i)nle
z*Vdo3-!KpGjWT`g%LQg0h4Az(di_iA#rVf$dT~Fp249AI)!!U<gRIvX_^tdLIQ@Qi
zF3)|RBKlg9Gbj7V>sm`)M)6Wy+t2!j*t6nVUj^|k_zAKt;#o^Reh03tL*@9B_}655
z@g0JCeEE&~dA<$59M{IG4==^N`qGTmD83o@nrlH*r{A*9;a=;KVUtH@ERJ*Bdz{A$
z@TY6_`C5TLf_tsSCjSP!3BSM;IJYkO^PL06cso8#AD${*Jd5hbm(Ye2rHg0TV|WnP
z#xU?I_jU0rIRD4XPudW_AC`%)qkaive7k!*7vP)l<7N33u2<mM)%taL1HJ)YD$|Q+
zOzrsD_-zUGyCGh`e!S(TiO7u!er?>x@bQ~<5B!e%(KX)rn{~U4^>W*-6VBhn2)uBw
zdpw$T`^RoOi^!+p^ZNOrD(0(YJ7eprDW?(tC*^FBZpw)58_dUMK6Dc=?+(43aLhj;
z^V#gya~dxs{l}$?y-8Y_@v!6{I)IlPz-tcR%?I%A19<oVK79aB`+c<iUTcCGrz+Oe
z{ftwDp96#UB+iF_x&2&5K09yI-|4KwS2AA`-nU9x9G|zX_;QY`ljS&x`^3F?Hm<FW
zBls#@TQ_F$0$ke<WxU2U6z=u6jLbaD!}oqc&%X?x#kKtF@DD8MTk-VU_4K{?k+{~r
z5j<o`KZ~!mq|f*R=SF<F?0<1DDG$H6&ignFlBSt;*Z3v;9Qff~?mQ8H)2N3yb;Kz&
zalR(vh~ItIPC0E#Ic6OCEgr-(SpQ6VbB+w0B+9rdI#*4c<YCTX#JP^2<L3ag_K5Ee
zWD{r7Qja2wn=;HgZqhsTc(&f{4^fXM@_73I_2?!}?iaoL-SkJ;;-((itbZoGQ;$!0
z*CYLpeBX*Vw*JT?PJ^W$WfnK}FzdKU@6_WvcY5|m8+kl%fO_;3XUI~IF^ije<gp%_
z^iDmF^{z+O9`@`9s7DcTGA!qfDvO(X^ivO$-l@kEcX;+k7kR8Cj%{4R#Hl2XS*zo7
zS<K^Uyb9OW&9pyp@5+)sgm1B=FTqXzTKP42wIzLXEPpM1H-57veK?lCmVO$qv7}EM
ziRQ1R58=02(wE>S|7EiOW6$5r@mYgki<e3l_x_sk$1VAH<E@tb!}vB!{?qs?mi*KH
z%v`kOAHsK7@-M;PvgBWbPg?SC#$UJO-;FQ7Q=h+KJPp_Se;QwiYyF@0I%}UL{}7&M
z$-e|&ZOOj|zZTc_`_1@9{8TwV#Pv=$UTrBqjBm!h_SqTaIUP%{?T^#`!a14rD`ffN
z`F;q$-Qp#9t)+f7`1SY&GJkQs*Nivgr%C5rZ0>HG`gh}9xK{r#-ivGXpT=Lbc-koU
zpKxvdgz)XSR=*Pb6<n)d4gRX7{APT};@$XeT&rIg@58<J@6Pz+{kT^Dv^ThKfNS*+
z;gh)5za{v7i`U@exK{sWd=LJ4AODNr4~V`X?2JFYre3dq7{3_T>OYNNj%)Q#+si!_
zi-+)yxK{rXybwQE)?d6!P=jy5wf=9$AHcQxcjFJ^TK&U#v&E<Jhj6X_X@6y3hHLXD
zgm1;Q`j_DCO8G(hqy~Qyzd`no*=vjMm$eXQk~rEL*n=N*m)?e9e1`PL$TCXZ{r(L8
z{sHQcF~;>FWoUKC!#`uGLm6I-Yjvo@H{iB@Xd_Omr4D`g^Oib{;vJSc`2NOPc7Qr$
z5@*^{hXVZ2yY;cCz<s#Z4-L2<xAj8@af*nejl}?djinCbc&Vih$#1eI9H0)_#A&zG
zp$PwpQimX2P=zn&d6IU2%dBlp#Q8FLtl{VQ+9#eJbm5QT<{BaHvFk^ZehBZtkCrap
zKbea8k<!KYic<G+Y?5AETXOI=ix=aMTgtDFxmJD?-eSqW3xC++LwK{L{Hd60<)@Cb
zcedo8gEuN3q))e+wHtTtXZ)qwy@nI_Giu1=8A~0TW3JV)8#iODjZqkX+Tzo=naA23
zNt=keR(=RKW2}{5g11_{27km-esj#V^1E>}##;Gd{2_}^<4w5NdSs5FwEaHcSMe{%
zV<h(F7vmv(za{??eB6@020!Z_z5dPknYdPdH{N1NAI2ZHq@TwBX-S{<cfQwbNgu+`
zYtZXof*0Ug{cG^Y@sG*=70(Bo@o(dK(#89+-S|#iyM7AeKfty5F^xZK@w7>fPfPwG
z{4q=V68uq%*Wiy>@^8lPx1{gJzhv<+ejo02d<W^%Y}P>I&VAW4tK2n8{2rO~e{h{e
z9Bq%7i$9HP*O;ZT^x7EJ;!lxY8>1HdTNdxZ+i)%aVf;Z$`WgHy7EgbRb>5PHF8+U(
z^riS0EMAL$-r_CztrqXWZ?X6=ev`##@Ea|j{!iX-w0JK5Ib53`rTAxXuQ_Pe&|19A
zl79<+xy5_%Qi~7c8!bMAmsmV~ioLnTbMazaYhP*1wf$->ejVvo$u&;w<63ar`1ato
z@g2r(<2!@f#y9<6(ec%e&s^NpU-MG@vlg$#ud#RweznDW@T)97j9+Q-8QjcIulk!c
zGX3r7{Jc(%&%EbBdBk~A$-~U?GTf|D+A&gxKV(VYiZ@x(_u_Y3(vRTvmh`ju&6e~T
z?{J?HUn=`RyqA!Nn?7D6U0kb_;bx9%=kYq+tij7<dU2n;6~7br8Y9!cz4#X`=|^ze
zF))jpV?ZlEW7<B4@^EbqIpdFCVadM^zsTaP_?Z^(#ZR>O2!5=^XYu8@*1s9=vKO|b
z&%+nuC&=*=??#p3w*2c3kbi3|e{Fnv@fr51nvdZ7ac!SDi~q}#KI1+9jySHZ@p<@O
zOZqZAZ1Fn$6^pmxJr?i9x8vIQjo=-M2N|<j{At{_#s&ZF^Zi}P!_4t~e8S@8__)RE
z@i#5rhL7Re8290?;dd^eGIRHelWtpJ?(~`ZjpA$X)$djMW_-R&aIFu6_$Mu%k6&c*
za=b|KAoc5co9{E>h5Q`&QMtPpkKHdYaoWja3vsk@GI4yYW!-c6-17hDWBOu}e1?gm
z^<~O`_zs)Jv+-VB>#HLCMT=MAJ-FBLWZKYA8;oDV&w(Fa>Gp-VF6knVH;JRQVF)*E
zTumPF`5@lior<N`+K~D_^NsYH=iqxS<rm{&{3Ka^^v@1B^RXHq$F+OsO?cowy^qFO
zvyD4_^tDZ%eH12-HN?^SXd2JNwLVJwZ#2Eu2O&I%^qQC8t8uS!HuJD1=BLU&63;iA
z@$*Tq?Tx$fODyGw@nVZl;}=`%mo{tnP|UUZm*AhZ)V~J53D?G_8Nb?6|89IUuI<ah
zxaprYvVX<CY&w>Io^)}4CGCIgyDa60@Gn}t1h2!r#y?1zovg{mKf%v|-(BI(VeyV;
z3wbmUM{8pbehaR(aTvcB*V;IPe+$>fApHaGG2+_ZAs2ttlD-uG3hvbh8MM0=Z^T#d
zb9|i=&)8e=2Q1!$Z?)t<9P?Xb{_^ji;3K5h+Ls<-?}KaolZ*deDL+V=rFa<E&RM1p
z>WFj1m-I4P@k8(xvJIk-dhx}$Hb+MA_o>4fGQIhN5dSvi&*JH%*XB@$Z-H+WUMti4
zqra>($Y*)@-MFod<-{2vj@E{H{1uD0;r+Na4t@9z{8(8>@x7u^{6+jU>Ec}q-+~3c
z-&^tz;=izXK5p{Y=21Dm6Ia`h_gTCRf5}pQAKry)*C3<#%a;6o{%HPM{epO}C4D|_
z+OMTA$9pVZkDKw+(zoH=7VpEKv-l`(`bW#(m$bn5jKza^r^WN}?G`V`J8*6O*5i*@
z(zoF)mh^r21D5oo_*NyoIfi|K1-{!AH*D64OyX1$=V<eR*Y{uW<NNgQOIF|)<K-s(
z+%<|n`p2+>eAIw%!xPq#=yzP5Z|9jhbP(rv#Q79IyLm*v5N~_{U;NYP@85I%9%r#L
zK91jp-<gm;`sKhNpCuo}I)Fbb-Q4f`mb+eN6Q_LVM8xD5FXK|zi|{hs>8H7Nif7MN
zG1u0r##sJZ`p%eZ=?C!&%GZ1nuf(<UMasejzEV6(wokm1l8u}8YxOINxmW&~<k`+z
zoX_6>2tU*AFB{x_5B;2UNc8tdnRtW5Tf=-?XyQ%Ii#Ow3+B);Hm-15YpNM=%*4O`d
ze9TAi7Tjx}YRU<*Ha>@+kVH8>q8#%#B33xRjwt%~Pl@+p<3!{sQ=f0oi}z5p-eyh|
z9lXG|_Cfu<-zt0^{$Rqj`h8A=Onv$(XM58`gv%3O;4`8eGY_M`y1=Q=B=PFL%KL+h
ziB}-vnR@3gcG_?9OJnVO{LzU>$h7Z_dGU^Q+m}bY?T_>Qv4zB2H7{OpVLZPI;&r!k
zt#0!B@Vt1ZxcM~_FZ><8Z^c9i95gT9rls-msY_nq%lHxB4NT~d2jcfGTJfeHegD#n
zKV$I`e9+>v_<sB>`YL`ri{EjOv1oxW<ptgI@YNPC!;5ikZ%~Jq;wL1u|2Vh(c<^QK
z-$!HSTQ9x=|G2Dw?0a0!__OAf;a|lAFBc~qZ~o}g=**`);=M8#uU(I4*6|$HU?;!(
z^>~fMdt@%&7Cl}!@dB*5PJWl_@kWTZWiDQ>cf6o!BkS8R@yvB|;3Fd5RnC-i){Lpe
z3w*B=$LoA-`mB&VhVYFhk3WCX?X&3l$hrF;#BvW=;QN4h3Fj<xoW{OqVB(Y!r-1cR
zi(|&Ho;VL!*3>qOn=)pouSxH;`9x7)(dIGoXd+H2@#FJcyl)>!VULcR_Qzd(Um_D9
z#E+65`#Vdf4F$3E+8(O{f5no21HKFQ8WWR$JKl?H_3y{0aj)`Cn=)8;-^Rbe&w&qJ
z?2f4!ulwD(k#gt)-{zlr=VR)TjhEwI$D8pY{5m|FpX2>_bu|AVA64PE;nzqvb%<_-
zoMW+xI6cJqnv65|z3;o+y7mw+v)}vNX6iDGpMf7E^NGFxX?zCH$8VJGk3PIGp1y=R
zV@aQjKV(T?itn|guf@kK>09uVey)G_uLnOFzcQiz(ao0Ae!K=RPw;3*JMG82@x!Ex
z-!YKBbb;?XxHczq@o(bVoGitEi(e%3XROU_?I54k;ve8Yo9FUxX|xjO@mKUV^y07M
zS{p`89dNA;v-r<&tqmEe3w-~@wKnA8S--Hip`19sAdXhYdi+IPt79A9iEDN2!^d!~
zj-&X82JCeVe28mA;%Ifu#Gk^oIu_tx$F(|E;J?Pb_5o%tG~i*}HWxaGbIULFIu791
z;#wWY@lxEYj%JNa=9j`Y;SF*=&aFE)yK7hu@g|99t7{2y8h7dQwgw->wf=6#U&ghz
zbmKq3z1m`q?Jz!pYyCZqPvN#Uq#s6q{7V13Lb>?UxYxCXsY5B=hkKoqjMw5X;aVG8
z@GkruIUcMZ=JuUQ--CxO`48i-TJoR4`|%TG{?X;%*(as*%b;xe=i(-Rt$n5Vkfr=u
ze5a-SmRSDg9(nv+8oNIp<f9(^b<*D;-JDCs_38+5vIf2DX!4lFkHc+w1P@=}t0s;%
z&iVNLxHgXEcpa{thwJe#;$G)5Q^z*E7vIXy@qUQzMV%`ZGZ*@a6a2Mz9i06SYv3~6
z+5fCM*K_}4;uR3@?zwnNz2lkkLd)4t5l<WY5_}5R+Ejx-_<j5L09uH1$Zqd8IrAU?
zA7z+phj_pEw>k@z@nL+6CH)Luj(;H`z5Bc0(m%Yw_ktyTF8)1B`cgdb8~yo9Egr<R
z<F5tJ!L>f_!B<=IAI8_?+P#_?`~qB?x9RB%e5c`B|K#G$mhwySE?jG0E#8M~?Q6kb
zvgF@`@4>b94dZ{bq@Tgx#kKmSAHnzy>GjLS{dk_7KjIl;DZT>N>Q{?@#FD-RKNZ*N
z*Mk@0TK^5>=UMWf!8hYt{nC$I;JeC_J{SKYuGOy;Z^X6w)#49W@^8VP#<lwO;NQlz
z`8$k%1J~y73_fKkKb=2RoAO(|eYtoBuC=ceKN8pGM=ib<*V@-|0Pl&pSNTD+{^23=
z-yr8_^t^GlStQLGIZK?)mNsN$utr)u58q_*GQ14e+E^F!BV`@Mcd=UWjilGcuov&b
zwR7tT{sT+;S$y%U`WR+>WPvXkKSS0}JU`9DkHgQEF23hlhF^$ZEj{+PSIqggn>BbF
zem6e{I!{kLFN@z-*G@j;#M9mf>Bry3z3w}haUR1zz`f>*@xY1&zFAy5mNN0TEa?mI
zNsCwD`z`r5;3Jmw?f4#x_v6Es{KxQJmh=Js2;+doGx1j}`4`|lmh=_)4vRP7-In~@
z@uw~6`|);*kKs>R@(%<#ms`?j;t%0odvP;=3h>7)=_~L@mGXn6Z@|rQa5+E6_i|=0
zANzf!ri>2a^jpdpz;{}F9PhJu@-gf;@TIa2&fVVVGteyj`<C>D`1dSciGLS2d+>N0
z{oCUE)vb8&cN3Aa1dl#kblQ)X;o2H7fM1JiYt=a3fNN`U^2(@dYjGBS2kEsnq!6#e
zPnPu;zpJbge+WNby7(P|Tk$6>`FG%tS$qJ0)Z*j#H!YrgEc*q;gVZ?-|2lq)tiPF~
z;@!$3;*1ezNkSZFh@JCo75*xIne^BsH)Gt0Cx`Vu>cp4hFDE=N+7W+VG>Gr`z5aV3
zC-DJXo8u{&3w%GqwK2}dP5#Hq`ipmMitrb3?L1P2f6wBL_+ysxJMl*?K8SzQlK&*$
zh(96g?|(Rc45oaPJ>P5Ie|IlPnru81e@&)0b6~(7<6`2xMx4`S9C0qM#-}abgfIJp
zejIh-Sr#9{&#?FuUV@(~>qi^RukST;F!ea@o8#IX$iZ*MwJ|QnD=c1(Z?t$5UWlKZ
zFvqjwbG!@RG_0?KLwF^At!$tFGx0H=!k@u!P4MVK<+T4}T=)G^e<v;nUyf_<p%mj6
z<G)DA|D|~O)%bh(dD6w-)@i~s_UL=cF8pj<8=oOOAJ^8|Dg0vmMOnW82l4u)X0g}A
z_ayjl<DP>*`6o;J@jdt*3F)JoX4Ajbc<zXPU$qIp7|)gI#oq_-!mq`bOBcVBaR@KN
zwc~FJza9UHOz-b@+85-r)Q>OlrT>|CCZvDPVe^Tzj)zQ~H}rM11W&ej4L(jC&X8q@
z>xyQ4A$8Ea8_&eGIUL4s$Ip`ai}xC)@m73|bn$+4+A59_JWqP;-iEnusbU??9p!H-
z@^iq)TO)JtI+?XloYTw5=WgO@^{B(!aqS*LE54a}XxCT0_*SK!X0DBx{BiAlrdhlb
zUoYF~KPx`hGd{suZYe(xpT)N&q`x<wz6`(qb?<&O^{d10!@bHk{Tybk?*2>c{fLee
z68l-azcEX^74)O?9>rI@<C*d%Dep_f)1JGeWHWDYZEerSt8nePOA&6yQ+w`Gg?|sX
zJ$Gp$&U%g=t&Uyz>9|(MA^ZeftK$^@SzN1Q>hat+#%*;B5$Djo`nZ<hAIG(MU4!T1
z+8W-BueIdgjc>rUy?hwI#FBm*zX8|km$sU{Jg(I*gx_w-zXX36*Xmajb1na7yqWac
z7<c3MS?U+Y8!SGJ-)+f1?F9Bfmh>U~W?VbRmf-cc*1t7)lO=sK{<tN5H(oM35vfdA
zccKrz%yAyZw~_uf<8$xp`pph6dj6Wm$MB01(ig-%Er)03f1QZ@Gr`}Cdk7!J4-ODv
zZtYL{z<B}ClwX1m?3;-6C-{#8CW9begI7&XM81+F(sS-ey3@(RImfmT=e2+8`@9}g
z2mFbIed5FMec~`){;zq@m|_=erj9fCGZs%jk+mI9xF_MiB;E(P_}aJi=TD{hcW~{V
zTrK`XoJV(}4^!gxZ^1j>nfG@A{n0-xXzJgC598XqNW=IW7N5cQ<JufbU&A}N(-V=M
zlocOi{|j#W@i4wpy7*fvrTA<3Rnq;@7m!T-Yw`4V^>+kX@KW5XedgR~*741_bIyA@
zOFcKHv(`2JC-&^~%k$!icfXQPVj$kv_nlezJ(Rc9v}f*^67LHY;y2^Ywf~%7;B=QW
zpDXclyhNrK@8E64oAKj}&mB|I%NAddk2>&2aNBulkT^B8^%$9lc;{;pKjOVu8|UgM
zo>`@Y7WhuYo%?)qF5U^q#`AFJ9?_g%=C-j2Uu(&~3cnb4-Xok#FW!%D#MfK$@5Bpm
zt&a!sHJ0>~csBkA*+2f>@j0EsMdx4fBcvBc+h^un1?%S88TPa0J@BIA+&O37yUuan
z11}+;V&>A}GN0JJOp{M1`J9JuH2I{@%jaA-pH}jzVV%!SSVvEA)=_f|_2P}b{hs$@
zOgUy9Z^G|3<^1xaiS@lHT27F7fwinfN&6#b$o1H?>G<e+Y~o}QXZOPWiG64G`@a<9
zPn^3C-tT$dHhEMT_wQGK|DTD|M4Un5T*1%r<G_?7uJO8wlTA6=`8SNO!?pA8G=9&D
z{pxi=+9~ua{+O(Tzd1fnLipmN_p9%Ol;D|o!gtQja__O!;JfHcuWQsGWj5pExOoRT
zp$`h(zV0E;k+jikj+wbJjHlu|WFG$S$J;Q2_tHkMJz9`7#jL-^&Hd)UGsn7f=PI`j
zdAZzkCyw@9pbX!wlws;v7jtJ#om=z7J@;1pCDJ?V&74P1!Opv~)6{V<{j}jA>bOMI
z(ahbm4st4Lj)M%=y_A&wk*~A=2`rlzuOT_!Cn=}0uT9gBrwa190}mWbKBFt$J~8FJ
zvoM~||0C@D<NB)V$N%1&w-YBVQk<w{SH*=!lNK&oq&P`YNpa#tMZ<*?7dlj&sH8a2
z&`8Np$@m%?*)l%13=J15DlS^6)5vI&k&zLwg@zN2e1D&>d++;w&ztV+?vFhlcRXL`
zbzbLn&Uu}m_r6QfV_~=7*k|{D^sI$T{YHLa=rQh?i+|eD(}J8f5AKC;f}ewIyq$!d
zLCNm_#JeZqmq|WfHS&@EWQ^63mE46u?rDa=xSpi$_*^6tevdVw&SeVW55iA2?H~`?
z(vWgg!k>euCFtKjuD=of<Pj6mVl#dCWZRz>f9r%VIy5+L3?TCiI#!!HjPq{MGlk3)
zGH3pe%uVsSOZ^i2dq+;FzonD||1?~iJD0#q;m?_QgnQy;se$jA&!s+oX^Yr%g;r#~
zca(p<OF6pXx5E?WrlP|*FB?Xt7nx<I9mZM3EPOls+a?chiu)lwpRq1;B6@W~on0QU
zvpjgy(G$L7rPO&Dd=vb5Q@?Q@R0nT^YcaeH{s{aCGrcjF>49&CYkOqF@NMvIX8Q2c
z@$${WtCvowdsFFOW(@@oGj@7?;sdYz@S3cNXnKNwJ|5>~@Tz0z6Xuwjv@*U%s)ILY
zPek8JNdKpJ`ZoBP%O;|&3HE<GZhsH_dHBl-{KYsQhSwZ75&dg|{^7X(S@`nL&Fe2=
zXTmD=mwp2K`0%4l{l-~O9=s}mm%*#y+TL9q{2us2rheo1#M|I$%l+-MNYev91s?Q!
z;v>i$mpc)yPsqcW@Jboy;LY%ZP42u>YWKs86WK?A7nt1m9ngGuC){r@N%WV)yWsye
z(;L6BTn}$JenS0?<#zamEA)9rFT56hQ-XePuYCmm8r*LUWtSiR2E4#bPaKi!-oi5q
zSOdc^HF>x^-p2CbtG?hr2eC*~4)03~p35~LlZFm$jO&0egllu9K6obFZ>}e1OF71n
z$x(C&kDNqbgKKlCOn9NBPw30Jc3+lpww_qJcI8C$cA1BKaA@MZ;96%MVj)+Jp1u?H
zaZGG!L1s~be_RwDTj1&Npz;nOlZlKyw~MW_jJ`Vqf4y9f&1tI`C*e!TFCP1h`FAdS
zjB;pwyA&>E@bjnahjbBpL+~|Z5Sch6(O<=%SeBafvGB4`(v+-F#J?lRFI_Vcy+`~T
zp6B0NJpT@oZ_9<j{+&i<DP{8;cP#QsJ(+uR@F4%@B2%E~kUA`dp9%LXzwlakA$&tZ
zY<7OHP|7<<Y;L`1B3dTvw$IP=&#B(JtrtE0UkfhpC^CyH^zw!ZId6mql{XWaEM&B?
zybyi@Tq|!SJQqI4{5!sPlJvek@fLqH!Z%&xzZS9UpEx~TH4$AW{wPdOY%k|J{t&qc
z@od>QCZfCPr;(g_a({N#vLcs_+{~2|(H~2iBMdp2L)~wOHz)poWkKkw4HN2~Pd>Z?
zuI)#Z!_S2K?fHlu_3%ybyLpcHv-oc-hi?>1EKnzM|3vNuQ%-Ds!m(9k29Rm0(c6N^
zOd<0cGWHxf78gX1v93%#g+_UmyQYiD7<)iD@b}<aye@(NBY@Yy2eH9#4@qonfp6Q3
zjorx1AfxRg4Z)|CJfywNz$f5Zy``PX-fBSlT=){o=odrm{twTD`}HZQ_b%dZF8n(@
zN1i;$YtK>_@`50L7d`Fhc>p=TekFP&j<>+=_I|UWN7kc8d(R-|t+{q0`nvRstLDkQ
z==2N8FQte*%<KKv3>G{aK31o<G0{<iOgTEV@wx_n1KiIyB)7}mip<V$>gArIJnPW$
zBJz=E(-QsnE6;x;=!x7gq5e+w9Q<&2xnvyMUkIOLD-i!m9KQg5sl=VjjeNwvrB2+D
zG8dl4TBhEAu57_8;Xi<1$#Xm(scYjmSDTQTL&mR7iH^<iMffDhZ-dC(d5i8hiQ{|7
z!}i<O169AJozD0}UMo#|o#P|BesbZD!EZEq*m+4%{MJl9i*9oLR%zrj&u{hUDQeLD
z)($@d9^|(^WV(>i{5A^T3J>yI<P2gCGTMA86Fzab|M+Cr|6X|IUU(yX9r^q98PVSf
zZ-i@cV2-$c1AL?O?}HEU>Q(%Gsn@@!(6cF^94W;P*Y@+W;dce3FLwFI&30kz=T*aR
zBE7bs*H2u|x^*HtxrlO9ej>3PJDu;Eh(Ef~Q-U7N&LMcYVy8v=Y~rf$vw4mb8u=K%
z%UXiWoyZi4Or{}Y#OM64(hrc)=0)Z3ez>+itcMT6wYv)K@JP#q?>!vxLoeKd`|X<v
zAAuLcOL&gQ9pemf4qgv0FgbB4zWzItdqVI_O>VCL;BUeG+NI=Q4j+c+o9T`7rh52H
zK>Bw0KjGS3qZd8`_uIp^%kT2#X8xCZ<HH<$H|e$ZnsFBIn8LqkrZ>LRnGc^0u&*3G
z0bgdOclY2d{#Ng%f6(MIF0?o{icAMGSATaR@Ez5DWO|X&>>Pvt0j~KmQo?yX{9Mxx
z<6d$m{3E!;_INuoz7J9e58tEj)m6eHa4r8v_@03LJK@=+_sieHq<;7tcLa|U<H)3-
zL#ylLv-#EmHfU`n3;r?E%XvuL2bXwlsR({>KpCsx`@yvs-vnO@Ut#LM!qdMQo)7o4
z-}VbJPkb~ZbCt;yFLu(NlHT^_D%0qhZJkixsY+eV-J*N-n3V%RAFlQ368J`VLQKL2
z*<rURTMhhSI6uGO`BB>ZTV7dPk-74|iD=<GnT?1@zwU<L1OI}_uk_Ln!G8)r-{fKE
zAlKq=Gw`?I32|3!FwXPS&tZ;#zh2*Ya0{-r=`#2Ma4j~~x!mu(U&`19Pba-!>=51q
zUkcaS%P>42o=^|&nTn*Jg;&9~u`9ilu^N69vhntA>>=gBZ-HNKa(6;2`pe+k;hKNy
z;Jxru%=GR(Xp6tK!QX<**;PD$=RC*$h>PUWi_Frt3H6@Z2s{(6m2nRK#enn~=W<UE
zo^IN3me<bm;W==>GFqf5haU;wXr`BTR^{lBe%nKAu0`f4o+IDeFQMOtf9B=28D0B)
zf8Jhdc(pAcz8HWPz-50e?ys+V>Br&4aK9KT>66zmr-Ex^c^3RDaG4Lq^;4D`$U@Q=
z!LNWP#5cHH-4<R2zcWC86TD%5diT8vi}ah}55kY*IiA0}FCl-DJO+`e{;6JuDfn8r
z-@H-$Qb=rEPagd|M~+HPtcxc-U*?|2p7aCktM7+kY~7e-?I#kVrx`t|KVrXXAN1_n
z*V7~O@pHZX%6jyixjA^;>Of{EGG9e+Jg=~GSI^>4eeh(;6y%pNWYUoFTO*0zB4xDG
z0Ka9z)8VHf>)B9XJ4DhK!dJol?)wR^gunfN{;@>-)k{2{fIlGXm)#2!{dI@4ezB12
zLQnZGbbpD=4rCrdCg}di3^H#bqxmE4eD=TLem<4*<ic-%T956ed*QY4UiAB&+l&5I
z_&W4!bB%6zjl#tTL+~x=ui-gfUlMoLdTn?XnK@(<`m6DtQu+nlFL_+|K_2{AxE3$U
z;Cp&?AJy%Jw*_!%Gt<QGKJ0&QU)szYk;FDLwr{*`j-uzTr~LQY#n+(=X$xEZ+oo^}
z{uW$o`vveTDW_jdk@OYt>*3lM(EzW8uMt~fu|(?1*pux<=D~nG`r(hl{pK1LYBPv?
z!tM3$WRmAAW4&8|%rG+cdiQsRjIrL$E~m{Pqs=Lb;aRjxZM|6yFM}6glUdf-db1f`
z2iMk{UGQh%TALe$cf+-N<x}v-;o5v4<s#NWaBaPw4c`G*%MYJ}tL2AhKNC=Xcrjcp
zKl~oJT7GyF+^-!-Tby$Fa?}6DdN}1`_M1uX*H$HcHoO_G#ie5Seeh~if7qFXNcw8{
zTLJbpyIixc3qC`7zcrBPAB2y=wRP|m{3EzlzLc+VZUEQj+}UtRe}q{+<4#I3JoK!t
zzZ(87>HXTLh0bO-e{DZN%D4rY_2i-1umfJL*dTdK!!LYNA44UNv<mJ|qC@j@F8o-y
z_Kr>|{P2MEweXL@wR&!ae+sU(vu-zk%?Cs9&yZfL=Nb4X;o8`jc8ODdZEckcFCo33
zf9&}m@wfo~zO2RX{%9XF)+PPZTZ`ADC-r$f-n7FHhUZf!aUI6~SugzaaKH8>^*91w
z4o`?zj4iRX_#FIVc+gthT1#EOps&RX;Ag_MwRi>mQn<DjZ-74t4_b?NBJ&zDT6^e+
zkHEG19)rIO*WzO2>wKRPuK6(&J_y&=>V<HzPm3Fs@KLzdo*LnM;0g6)tkpZ=NA~OE
zRzExsuC3L_;9r7k<%?9Z4u)%M`AqmGxaQwNcr9F8%U8l5fCsJRn~-@E8O_Gc@DaE+
zb`QYcfonF7!~YhbKlxI|Cb+iN&w}q%^jq|`BKROYXszE#>^=NNcdh@!4-?{oxz=w*
z*UynlSi=}={ciXKJez#ualu&Y55f1qB^JfGv0pm_{}8UtBhuC_2>lDLt@U%^2XC7f
zKaI71DLfah>92*q{`ZM!g=wGr5oC#5t?(sp```T&-VHB;-<gp9miU~12>v+y5R)74
zaby$s9;JNu!XuymAh904<*ku2E@R!RltX-5i=M^szpxJwnVa?W$U6UJdpp41m#9R~
zwpZN#8M{+)v6GL~p~Ug+@VgeH=eP6p42PGcZsa!9hW+gXlJ6AqS#P@cgI<~^@7@ox
z<3IV9jp}h>4&F&U{0N=#b`pLdo=+)pGoSQw2Q_lLk&moTZuk6DSjAmj<m~Y<Rz71d
zwGw_moZ@-+e@^q#H^Og&YxiV2;ZMQumh`bTlFvPvLFBBz2H%sJM&?;$t~7N?d5p98
zw9DD6f6Kk!7Ap@jav?|jnhReBx7U0zZrqV6g|CGB-EoohweZ{k{jKox;oAL{Zg^>c
z{vr68aLwN{@ce-EY3te79Glm_jlF?f_?htIOdp!%hhGfW_E&1*)o?97w8GcIUoiED
zx5nG$6tR3E?RGLkyZq04iT!S;{d!c$BJBuze*4ehx(<DVy|D>@TSbQjKN9X&R<PZ_
z3z1od%<=MvSo<{Yx>v#r;aYhc;RVzF^OG!8ju5X8C4H9ck7XO>E&fhYbL7^2k`8qC
z$Rsu-OYGdm-jB>Zml(1VlfLH7J!i>t>R<lr2n#*w)trsO&*eE@Cg~^6E2wt4^O5-!
zcKeOFqN5!C;qGAnH@NxuwH49P0iVN;ApiFxlZ+jH^Lf!R244yf+G9z+f>^2OkUpCQ
z-w5}!LwFJVcDPo@Rq%TFUs)o?{h8$4$CrBRBNm_Vt{c;D{&!-Vc4NB8jU#vE%tUmG
z=SYnqCw23t7gLAHZ~1%dQPU2*{4BcxSo|r6IQZ!M&YU`Of}zJf)0Dh2u4J4?MvIk*
z*!$h}=xRdlY5pHsZ0Hi3e(u;L`Xr7YKFfV|X`8d}CYJFEuWh!HZ|#S=FT3IE;gt(f
z8tZRK7cP{XB%c)G+hd{0=o!i6(>X7nmG-q$J3h>z=e6X?XfkqfJ<?C!_x2C14ZNF_
zI_W#Nmb~i7Yb#vdg^!fY%WIF*FQt7{p=a$ulj<6zDS%s~A0;12zl`U|$Bca3`vj85
zAUdj%Nmxr6?-)<PJK@?KJEexRS-6xd?hj+$m<@j<Abl}h^!x3FTBxjsZ-HN7>X$a+
ze7eAnDJ{r+h>W&}vju+Ol1bl~BR<#xUkLXrqu4MF|HOflYMT}vX;-mc!v<}=nCo)C
zdrXqP6uy)6*Yh0rW7xSkBD@x!i;dd;MJs#-{NrZ&Q@p<24L@2bqv#)k9~Ho7;70`T
zw5y5ha4oLq!oPIDWa9cn>d|;dpbVMa_&|%vb?_AO@QbHXY$-=OGU>>Cm=H7HvEN~m
zHabIGfA?V8o5Yj-{*@R{4)x;67<%>`GU*$eE%ZdLVJw6n!uT4mFNp)m-nd#pJbf!;
zGWweo<bSa{F|Q|6?8*_FOVG9H7(HHWmT>}pyX3pc&?Ek<^Xj+_J!6U<$)^WC4);5k
zu;9b+PaLbabCH=t=0ao=)|vC_(W+(785wPSE`WEywR)6#YA4QiA@g^hBaiIzd?$JR
z(JON^y4HWjzn-MbUGNI{rNr8JJtdXf6F$i&LVSDVxXI{liTfo+K2n!|cH+M1nL$r=
z-eh!9!q~XLZZN{ruI0Y;O1%!N$>##N{a$_YynKxJ>dVp7ogZ8W4aj_iOi&$kBD3Pl
z{(VX8?T44b{pvvY7(DfiN%ei6$VOr&{77Wuel^|?&V*;8-*0Xsey=B{9t!`Htb;#2
z<<+nFeZW}<i(DsigQrYJzbf<CRrBQXy|J>D{Mt^RRL^0$;T`bfO?!>`_7MC@c$LZB
zLB_6s_($;K1b%Y752szno+tj$&T(?#7r+b5^t9#JIaVqB2DqHJ#r^4?wMqW9@GiL4
zr&{4#;rE&8rLQzOeZ}JMJ;-DiPevb{FXP@Flzc{zc?6mBOqsCrf}`*`_?vKTzK~JJ
zTH>pEIrHHw;MzD=4$p)8jU$qOJ^Wa>U%L|C4!7W%{k`z>;Du)S@Kfxb*a*BHzRu+C
zw;(P4HV1zm{uh&rpI`O-Y+cX(^{ILv7CQ@(IseQ_b$_=Kz5(txo=d;zB@SN<x6cbM
z{HND{u*Ezt=t9r3vvq$D!gJt${<g?x3VtL!p<PRPS9#@4y@9noGC^koxyT&4TK9V?
z`~<jmCQu7M7w&f^ApUHH-v!so(G72aC$w8Bhq320j7&E&+B|X={!&05={K@Z1W#D|
zIQP%&ojb8JADKnxOseMs<?vLvcAi`hKNzl^3$(*O3)kXQFZ_JC76(V*SHiXaIS1bW
zUqxBsaq4=fElBw?>KBB*3)jvC^5Hw-T0ND+2jM~c{td{amio`v#fA>}Vz^%!EqEXN
zD0tAmdj@gtT4bI=K62FC3H{65cTf2y<KVgT#$sdNJsW-!JR3c6e|_EaS26rdxb*2b
zH`Y(p@YQfF-ZjHdg%_FWY1gqkc3tod@Ps)vJa)%!5Z)Z1e+s^7etKhHFXbl2Rk+_g
z!osFX;^h{&*cW+!%=4phN2CNDL&*58okYiGbO^WaqWsFxVT_Nh=y<ZiUx&1bZund1
zIG5+RpN;$KL-6!9x}Rs@i{TfW^ZlfA?Fop~T`_U8`25M}jqEQ(4mNC*`OJEIo59)t
zx|w(!U}w3@mzZ`MYovO3Ch2c5x$&L8cKA(jZC=(3Z-B2)NbhXmh@VE_+u<jf+*o7G
z!KdI_e8^~E4F}iSYd(Aoe)|G4i0{LE(_WuR{^jt~*ZRi?;q~x*xElZ9tKk*M#`PQL
zM7{8P0`!l-8x?M$at{8Ni{{068Apt>0P7aV2EQ05Whj6bl83g|uYf-YPw2D8z19YJ
zFWj%sq26w1og(uMy&n4EkHfPhL98C!Jr!xs633g!;~}0S*ZtM&w^G*cdGRY{6Yp_+
zeKPt3?ybi4B;8|QSe3G7!*8mZjGmgXZaTqUH(Bsv_>b2I`?Cg_W!S3uqXk|J5AsJh
zGUq8WV&@Qi9o%mpO85+X$Gy5g({AOw4(=DjBz^8)c<EkvE&N^lv>aV=KO6V3THz7w
z*LXL4NdO;$X9e&X_{spD*67rMmVYk%;(+v}@R|T#3*QvLTj8w%yc_;V03U+)1n?R7
z_5hxC8+Q!?crJW*0564ys`dJ-g&z>WTj7s<Pj7$Sd*MTS;WO}l?9Y+*7dyXnzi}?@
zJB@&TdqDoVF8{owkHwqyUK}ZfKR|jvF7c>~xLZs9YzuLIH{!*k)0>lSjU-(t1Blqs
zj-IXf=_oUw3%q=K;ZMW6P3}(UB>f2d>?<at&n564TY>O7_|kxKW_&A{=et~+hm^z1
z(eJm;7e90px39*&YYxE=$%Y?fp0V~2+fI=iLGJ0>owyr$>(8FQL~ez%&na>d;@U{l
zr2S2=$Sa1N#ChX424=A9-Fx(LH?4{DH0;*mXD&QV@tcJm&DbH_p5vWo*kR1^>d>)D
z(II8ofsT{lk4U)=Hgrf?+PpT<hn_y<G+RgEgGxSPYaX#s_*%)Q&!_|U19{R;GVfrW
z*Q&3>3gIi@3F~V2pj6UV!e9B;r1P5wvHoV<<7<SULVCY;Vv)WRUJ8Ga=Xie;KN#OS
z7(iwZGTN9m?(z+$j<9oRFE%FMi4BZ-Hz#n}Npa>NS@1{T$C%uhCl$fB1n?^OQ}6;a
zJ!OdPnKi+8!lmxxWi-}Ko8fQ5wYlg3d`RIIDlKB(cDQ|hHoDX6L&o`8%C{XId8Q4r
zxRUhzt3<~XI^-T=q|?yhOu6m3S_wMdMMi6nHSqt!k48tloX#h;?DQ@0@O?Vp0#Al(
z^}Hj1TV$C<%#-xCAKv-X|M)><ijg@08M~aX8Zt&X^O{*>1=vyMa%~P#2S1kdA1A-K
zAB;1uHu#}%ZU3eRo(un^nZDGE3&Zf`0elvo1NWO}N`FZI4tFx(+B~&}7<w_>_R%kf
zJwLiWvd~eEj!I+__D`hWy6swI8jyJunV@~#PGmCg*Xz9B<(jX@;44V4`8skJ;~ZS`
zbtb$3egyW$>#EH2bs_xIw@y0mGsWVYvCmuyKa%tpo9V;Ohode2)(Bro`j0aoi0j8s
zNeg5q;KZNJ$mFBr08@u?him}84DPpAEP0H>FNG(J)lwJ6eU_BFd4B<!8Z(dZWws5X
zBOCrUe8D_B!~b@CA+f88INRSg>HOC6|9jnQ7n0W<p3mygmHT~tZQBN~h5NNXX`emt
z@4~gU^Dz7;aKAbiJ9CJa_rX6cXE8~Mb|xL-oW)qkm5E&Yr2Shn336fQz(r*0kr_v(
zlIO_Z{@|6_ZRlceRSRp9|EJsA1U~_;wc*Y161Wyu2jJz3ez9>J{`Xsg*QP1oW&aKx
zem;{jWW&E4U}G^{Y}D$c8omzhcQ--wH^VCfco%#vT<Zga@KU%I)285G4@jSK5Bu_P
zt<7b_uZC;$oMQOHaJBsK9=M->rA_t|lQ+ZdbC4hY-fKq^3yk+By3teD;jc&hI0U~8
zuC=8Z_^Az(>ix*H?-4KI_FN|x&nmsXn+rb?UQS-|^^>tLRSG|Z{0oG~)<={fHrJ_z
zmy_OJAI0>;WeY&;Z*|ja_1q0lLBF<dI0Ro8z-Qona4nvvwQ?>7_sieHzFc@WJfR(6
zzj=;ShRi53LGiX8nFAiu?P!M|2=}u?{L~BI2d?eCjleHf(o1{GB}SIO8+neL_i93W
z3p-QaknE|IBiDu8wIX+-A$OW{|1#{J0a);odzptLJI%9M_vZI4YLR*VVf}op75*pq
z`KAu{`xR2|ZukK|^7o4cAA(2VLFZ$$$mAg-^Ov}t#{4e*KGtV&nJ31%F;~ummnb%f
zjb(dDU+1RR=CN%q*X~&Lz)vTC?QCrrz8bFSpM{?d*J5${{Z9Ebo(DgZ^a*Ek^Z|Ld
z$}T_r2Do1zv+z$HydECZPTG+v>YSH{@m^3bycS-FzIYvBL;U<3-UipsVdvmKhimOD
zqm6ML?$`gM4EgY#@St{9fz09`>+P%oo(|XQu><}o_~L{zda<|<e)5fz(MQcWS<*xH
z#8K*D6uwI-gYeMziBoWG%(CEn0@4@2gM3s07av_|+CT3cxe=L6%DB{&aew<oZ0v*|
z3-?=>3h#%nf@^(s3|<1)${2Zo@dBREmW_6n3BLz^ylJ0t-=+}08LsWqRl<J;*J4d0
z{D}bG3GajZ%^U3U!?(b-x#1Z6*Kn;bM}ENGgu-Q<C?{6-z}N5`IpcTUIN{Wzy=oOZ
ziqZ2na#}rB!>8a{TW^N{8?M!37kt4ZdOZ%p4~A>?I0Zi$uGM2oJ9psWT0LgNFNFKW
zG`sxp@&NtS@T=hGnC-~Dv?1x6;hpe=^|E^yC%g;38}1j6gb%_;;R*8+cY$ZYr{JkS
z3BHez`u~_iBcrvI9QbOu=ED;BW$=9Ri^pVRudfDvYXEP7cfhrAYm3XZad8Ly0n%&s
zPs7^+c<O_!_u$%IKo0!paIFqX;19!3Hp|bL6#FfZ8u*KFt&UsZi#O}~x4=X2Q%wEF
zccXT|m%@YYoXjAz9vRI?X+PxKSa7Y5bK&2FUu)Xnu7{-^mcm~P&|eGR0Z%v6pXH5d
zt?&W3pN}olbi=p8H=5~X{$1thkeHQ9%uD&Hd*|f`+q{@1a>jS1LLL0(HgbM>Nm(rT
z-Egfv7QpWcNM8YO2uR=HaxJ!Zz&8Zw?}J|g*XnW<UZHSH{Pz%R1o&!sj;+<4xNhHy
z6CY$E)2!$aUI@PvuGMEHd=uQy#}?@u;kEFf`Wz*8Z$suO<Rky+SL<^Jy3Tu4zr!>Q
zzXz_}VM=|N`wDPrLveo?`|vsNhv5gAyx42ICGfU@{A=L9hZmXYX_K)#PA%~N!2NtB
zzTN`g4cEq?9q@lC=`GSv!{35mFfV`ew{y~d#GLeJx({>V=fE`|mclFGnh$H?m2l06
zt?={Vnvc5Sx4^Z1nj!du^Ep0_-4mOE{~E6OIIVL*=>OnapUQ=I!L|5U3V$B%cb+A6
zSPOq8ApchQbMS=n8TNO>--IX3bKtSH*ARSBm+s#gc$D;7`O<#O{cyN856Xpy1N4`|
z-w)7V3x5x;`M(uD4%htG4c`OT_W6e3f7&n^{V3s{&U^MjvG{)m{x<1XnSH>x_nGzx
zXGE0GPrpT)YGP_ST-s;kx;`%!x%U7?rUjY&n9O<pGTjoJk-13pe8G?jI|n(UrvqE|
zznXV*c#g*-_g#MZla!|)nKz!F7sHL;G8%&~enB6@B0mY{nS0@d0X!G`+KIWZ<L{P*
zl=GZtJ%2g(9qwJQEH!)`ulS$KtNuwD&UwC+s~x?|9_M`*p5tYAzrQT8Wk$vg_(swD
zRYR}b3%Jy~r#Ob5=X)ljeF<yiU&YtRk<IKYZ=F<s2PqSN0ep#RhjEXw5MBa5(&Wbb
zBbD&g@I^^RIg%FGhYV8AMtJ_y^ZK)~{_KQT!L@Z!KYSznb7ubTTuAhf!J7ioM}Eqj
zHz0i`d^22r2OwS#N#*hWR0v=8oWB07gs+7A&7mw*_7abU+xI0Nc-m_p#`oDqk*Pw)
z?sGR7GREE8LGo!<@)18w1#q#Wkhm!6?K90ojXd0aL6ON}qvalC66Wv3-q@L@<Wq{w
zFf!WsPz&D;Pl(?}eYe67r9b<v<3xWq{B(E$&++=ehS>i45PUt{uir@e8Tb~sHvXpl
zjJpnSZG6aucf$SVAQt*d-So0wVA|(aryaBEkQqjYwinO_ABE?eI*fH>4}31b#$ot}
zaEYyP8{D`mKA45)5fe8gaOXaV#Fi3bW)u8=o+C?s?X^j%YvUZVpo{NG2k2=-Pf@?C
z=Z&qZo+kA4Am`Ud#NN#=UvAnf2PXVq_yBx6>9uvlID9KyTh}K4A9p|C+L)XL-v-xW
zP?4K{g=wGh{q8FG1nIRl)dU|8;G5xZ2iP|NABJoG8{Z30e#}XKNx~RW79S(B;D>IT
zO#Dq-+JY2O{9gn=9`5Hq3tk1!f<I{bN7|C{zFIRf4<qB(uOyEyc&Czw@Im-}@N>;P
zjQ0Yj;Dc~&UY_!E*5v{DXTx8ES0w1SKSyo1!D9FUzwzf5X{zBbJ~eMISbSjIqiR8B
z89KCfyaoPAxYiGLz>kA#d#%&(m2j<{q;BC`U~sLS=D_n5E@f;YwyuEN<J9bvUVk^{
zhF!>95R)19m)U{LO);6C|CN#Y?!}gek@0JD!bjk(@Pu`Q@xIF({1<So&u08$LFhMd
zzq*h%R7(tf5^kSYA7<D{oto#>mFT%`yYACQ_^oiQ9G&oM;n$O=7t6ix3G~BX4oE)+
z?+ZvDd7QreJAEw5gdYLVH}f~fqC)ryaBcs+5`G$7Yg3KzQv-M>{1mufo3*fMj@T~T
zo<IG%+iP>iebaGt)FPw#IQf^Hfxxx+o&}fmnhg!aSK+n|U-Gx18XXS@*w74b4X~lh
zO|RJyk@y+2;n%<P^}{qeb_Cdv+Ra)az=j;Sq)(W;(cWe4Ep<@>pMwXTYt|w&FsPqf
zw!)|2+PP&nJn1F>b4#&d2%ZlQI+vV9rUn@;PNqM>`7K;)vw843xYnM^;OpUjbtSQ>
zZZEve<=Q@f54<wKzG3*<06q(^2(T~xNr!9mr9Alcq}Tjc25$_|U*~d7e;fS&1?caA
zZw}Bu>~c;2Ec`h|zdipYW)8w-4j;K@i`SRto%t2~ig`A2+L>PkJoK_2R~q1p;o2C~
z0ndad^fzOz)CVttYiq4h_&T_@mlf(+5V{<$wQ~zz1@{{Rr5zW*&x33IpaOncfc^$}
zQGosq_!r>I$tyng8T0-=SHCtkjl!k;n*E`txbqgE--2HT*Yp>_8w2!Lz^@6=-vGZY
zKz|4PVYt?g`{2KZYyKaFKL*#%<3d{(gkFUwtmln0R||gVE4uyycnVxQkE?($hX<X<
zH6pVS8LbU=!fWAL8}EnT0oQym2EQ?YM}EzF@^Eb}o(aD;Ablac3a-WaO88{~yb-=G
zApcJI6#@D8!z%*xkHNndz$3k!fd%BB3BNQT|3dhAihhf3TM1tSUv2i`d1q`*$TT9O
zwSmp>O>pguZ2*1)+^-FY4dd`?_(szPS$i30riH}HXOMXcnaHh=dNE(*j5E{Rrx%3I
z+M(xF3SR{eI%BFsrVg2e@BSFy8fb(65}s|^>)tbzxZ4BogKKNqVR%1W+vA#rKLwX{
zT0E{&&e%Cz`ZJu9!L>e@2cLy&XB1`deO{fn_CkN`45|)(B;0RYvM{L)z7+0fznCmO
z=oK9wpHlnX$X@u|UU<f{!TR&}!prx<>)~bi&|Y)I?g1NPTRVImT-FrcJ!9vv)h<80
zP2tjR(ujN8;Ri0JJ-_l3uRY88z*$KgHoOtx*kM>+@D_b391uMA=4AA}gne%NXV`6j
zXTux+>VJ+P?NH))=HDixAEc7scZ~d;bB?!D-F#}%v*+KF(I-d~Z+qb`s8g@4@aCDx
z=v4`JRK@q(yWwx{VQ({mJ3q)P<rsozd@vcEN!ZJpjPGU5z^6ad-(^dCjyWA%o7?8X
zBmdEPDSR>9ukDI`wQhQOj+g%&yZE-BTj8Mq{oU|I@M<%?dkNVtKYUF<`Wbiy{I3b=
zhvWWFd!BYbr;lg3E>F0>?*9Isw1Z}1?F!QWlIO@Te(be7iK9RE%2|(|=aKuIX@_xc
z(+(dB;Jxs-1NaDh7OssMbMWba^cgR3&imiVsGQ-&>&bXeIv>6SuGwD>&kEr6@FVxv
z<5#=OwSARd__BcXBQDp{&%sxc-j7Q?mJ%Nyz(4o$967Kvu^zwW)nj2l-*rXL@ur`Q
z`=OQaT=)?tci$hg_*)}<1w7$iptO~*IC+RIquA0Jv!(S%sx3Rvb%J7x=*c2xz8lkX
zzOE<zMZT|wo;=dT>)w4ARQgyRyih5V@G|%*@G3LC@eR5<_+4;qUDpQR3fIoSdf*fA
z0#iRei=BZD!xyDYsb^rb@DjKdqtdrwKU^(8{Ney!2Hyzxt8?*B9lS0eeH*+5uFikp
z?eGe-{Kh*t!|)M!Sps)1*-8Gh@U)NV{!jl6?>xda|L4JL;030B!~bRQ7Pxi>SqFa|
zuKB+WJ_y&^M-O}!uGu#X&swb8Hw!O<YxboN&_3aseR=RkxYj<(;O+1YrhnY`&7~i1
zA@+tCWAEiT^5zfK{@j6{e)Qa&pvQYJy$_zr98k+AofuaOx6d(eotKYsj+y*hzGbB7
zk@k`W&rQ{1b&<=Ln|2y=xhnW60qL7uuBG1$FAGRN;BqbfIQ(elMD{*NY_4g1FE4pJ
z{Q=HY(VJ_Y=Ee9dco^>Y8x7*0BKQip-#(ZHuY%{pU*I_&PbJ1b;pNec%r@#kTf=q1
zd*Bbw*I}F??m%Wae)7{Hc22{u!w$_4slQ{+4cGjT122VZekg%A!Tt7IEb^~`{|p}F
zhgM`70{qYozj`lz7)E9x{Yxw7Ed0HIa;6XRdpQB+%!40{eyyBk@RjhOa@HeLL^;kg
z>(h8|yd5rn&|-KmT-rl{ncj%OBk*CkHU`bXcfz%{lJOET7_RL}<ioeawRw0sd<kt)
z;$6JW8+U2z;fKOC{q68{xMqK^n_jbj1fCL*eh$7E?w4L{E+w{x;CAdReIPML8?m$S
zWyV6}D$H^kV{s+?omsstHo`~YTA%BLzYN#<Tt8f5lNNi%;K_UGbIGqbzS7Q$v*5>2
zMs1(I2!0~m?r*Vs<nH$@#Frh!-(_(7_t_8reu6J!zt1jm630J0!1eh&IrH945BaS>
z(BJ14dWPYD#AjFX9B+FPZ;iVKbI9C|4nLbER%YyA4i~`l;p+l;Is7?nI8|(jjXBsL
zuWN|@diXfpUVp^6a|Ov>2e-p#;Px3<j60u=aQ1)Ty94x(zz?F{wcpX1gFk_<{o21>
z{#W^i0$gho`S5<Y)+Wl~JK=u*mAaNVz8!A2i7(yn+a|=0PV`g-l(QdxcYq(q;12}&
zG4dMc&H?%};lGA!ek_FVNz?sU2_J`Rer$yAbCB-GPWWMP&5sht7r|{m9(JGV$0_tI
z4k%~J@43SS*V<z?ya2AX$71-(0R7eQOW>Lxo8c=C*5iE_JP)q5*FpHPaBa>$1^*Ph
zfHq~ugxH!fWr!FSpg$Y_Ir#NvdgFI3is9|=>;1hN{sLU{Z!`R5xaQw3_&|XELHNJm
znt!L@6HEO4mqnQhiH9TbYk7|R=X+i|@_Elc?+@%x<BMt27ZP9J^5(PU$h?b8;XIkx
z``PvICFxV@J%@JqXW{3Y>D})DSp2OQz7C!+KN1^^dHpCd4<MuMWrkj7Uj?qUDGPod
zT&wc};q1j~byfjyfoo%X1N^3d^c|9({1eu}lreVSqz~Q;52}YTWSS1q>ml+--e-Yp
z_f0b4FTk~WD1^_!gX*CQnVduQdT4^Tyr=tdGyG1t=EnheT|oMA_)cup{Fpq<dI9@_
z{Fsf*YshHrxfs3&uKBSV{;|V!KQ_Zpfd~0<3o<t#qqXN9@H;s>(AwiPyb-SXG4)TZ
ztpd{Lz^emz34C3E{u+3xlHQ*G5u^L@p*`om^=>Z)NxwGc+&$>Y#SeaSUYRot!&kz!
zGwoUUN$_Q6Y%#v?k-n2NPPjI=$%9`CPiRlZy_7Qecj3pI`i(u|I`|{-qfBmm+p`V+
zXh8lw@IJU&e)u-HT7LLTaJBqz@J>-c{(10s;A;8dpUem-KYTe{EkAq(T=Rbqycn*Q
zAHEu{mLGmTTrK|ycNPNj&x3yxu9hGEQ@C3H@Mqv^`QgvQwY6^#`~|pnZ)F&s@=1MM
zn}vTw`cusIXS_$A{%7_TNq?EiojVKmg>UI&`N&iuqpjb|;p^a<59;Cd@Cq{zW8K^i
z?}ck+?1e8pTrcAYe3tZD8Ry`KlRl`7)|=cTL`ExP0lWgPm9YYTEnF)@1N<4dHvi~=
zZ-HxN=!3rw4=TeLGKYRjFGJ)n?6bhNGGxL(8<4&bo()eo>(M!Cu-B=T@JzU087<N@
z!k54|n&~Cp8+TJiiPu%gJcUf;#yb+n1><hY4s?B><Rxu(8a@fv=5wi|oNHOSuX5n4
z;96Nr;49%;S!>|g@Sw5|5}R*A#xCp6n$)uPqU+;F=(di)7sEAM=im$BnyndsrT^^3
z);i+o>FBU+JxsT?3SDm?ccEFw#(keA_>v>_^RCVCBjGYfh_Bs@y~F|dQusk8cdm-q
zZEzfZ7+kyWll&InhJkDLWx;QPXPf$s`$$FbJK>srRq(sunte_1Tj830o8do$YxWJm
z--c`Ujl<uCYxX7ojkzmavo8xi3D@i^f**L4e_N7%R|Ve(uI+&|!H=BJi2<?uQk&r?
z2IwDvFNbUMg>iUMfd1q$=5ql&3%&`SFy3Qd?4A1}_+xO*e^u~Kc!k-1jIpi>J{FLE
zGkj+NAAr9C*ZT4}{5iN^+!K?e-AEi?k~tOq3-^j5-)QvWjx+ARvn;iY>r&h7dqmQX
zYLVZzlrz}<kiW!`m-|&G?q_cVh+I2zyN{cSE?S7(Ifk5bFY5i+{j27`^KQlQQ}*`=
z<9$4QV_eS|dU99bW47fZOAS4?eM$R>Vba!y&~xM$^ts&(JO{4bTS<GHF&D1Q&2r)0
z0lXCcEBKMv5-*4QKDg~S_*VFBCXem081EIeBX@9~zaA-PFZ@t=o~g&UqcH+s4nNxD
z#<#ZT;9m&f8UNtS628Gq@19{x{`v6c0A3CsfmbA?_udz*hi80I=k4%vxHbpwg<k~s
zYx82?2>h%7J_lc==$CpbC1w`F?X~Euw|M<Q<|gi1ROITB>yF7i=`SbtRFCspT`P5a
zo8bq+{rae+?}A?$kbV$ep`;f(r{I_8PN`=ih}dzUm{@s_=t-iV{ky>{x6{wg=X(tj
z2xepbt?-}J^OvWhU7{d%_7nb5yx+E?uj+)U=z>q6Z@ZyS;>5JviVTG;k~X7f)mc-~
zTJv6`6C*B>%a7uNEy&z+HgTR95YH>=v+<aeOq|=idMer^F|5wW%dx#Kre_vC$>-`Z
zAbo<q1=rSxdGM@&^kwjs0qN`DMR4u@a2vcIuEn4p_&@+3h7ShtS@<h(EjFZ2a`zDK
z7sI5k^5Cz-?K8<(olC!P&-|pW%8^;P#$Si<dU!Hii(l<<3$EGN3qLwQ{|G!QK>r-P
zAV7b{)Pm4g0`%v@i{M&(EQhxR@Ot=o0B?uqou|jgUU*#qAA$D-@HzM_T#K(6yEuyt
z;Q8=5g-g6?CBA+Hx8rBpH@!GAFMdiKzp~7g`=DNx8$<5RnB1HGau)dxVb>wVfGc^9
z#|X*OIQyMN=9u&KSe(9_^#WXr#d+}Bfb?bXbph$?;Lj@Qr3`KGUnuFNSXum=A)YV1
zU@H1oo+EGEnCQ3iWvSK6Lg6!rn^G4R@vaxyV~LxQrxRt9GVJgfvXD#t7yA(x2Kz1-
zndEZ!E?Deb+St1+g;!rUrG77`7QPnl7h5DQw8AUl+WSP^d*MSaFF;qk{;#u#8G9`_
z18+pX-yXWmgNuocMfl*=MfmDxH+X)P@#-r1NYQMV@$WpDx7y=B@)MU%Mc3|+{7ysO
z8N1Hf-<9h`F7v9X=#x?hpEBye8Jix7ji;^C{GQ#_`q<PB?^n2m{X_8A;dk&HFTb>Z
zXDV&i^DHv?*RXeBj<r(0kJ+yo*nY}*hx-v5^)V<PekWY3r}6+Uc6JkgCB4)`<V3@7
zmw0v6fsPhr>@(BYIJ4H_qGJ{v?J*tu`s)}&$HT~!As_cg*t-iGd6%^nT-z(oguewp
z#!PR-l0x_t+;5Li+K0sP3HTbGBbQz8wI{pYoe@*oeKUH}X_t~FZl|%w(FM<dYxCVf
z_+t3+W_shyVG5oJuQIuDCp+cePQTU0vut=T>HW$n_7}sq!Zklu!=Hm|_BX@3;hOzj
z@a=HTKZEd>;S~wx^VS<v@WplhZAt7;nPJWc*V=Qo%a@z_FZbGNF+7{}etQrWX{zC?
z;8&RGrC++gRVg;KAk&P@7fl)GQx|rh+yehG+|P#=X_AR;ZSYE-BT3hJZO!;Ck{NUi
zBcs)0+Iz&002^}Q|59v_GL*vKf}hNDyd6_c`3A1VpK9R?uMfV*+J;O6GUu5(jJuIN
z@E*9<r-$Lw@B%YEHppEMX+Jr{ztkJtImchF_539DVVpBsd$0pJKVMnsDS+Pue{fzt
zvG4kbOeHeAHw2HVO~?$P$FE++r<>v1;M#m-0B+r=x7~4<+vmcuIC{3%c9Y+y?UUZ`
zj*;Y_1>X;@<zEC}3qJzcc%2*XxKzO_;j2yV#J^Qyh2+tU%st3xKInos!nHlbLHI*(
zzy2rsr{KSW`;}4Jgv9Yj;P&@y-nb^AO_<-a$(`k1;7$Hzm3&I!b#Sd5wea-;>09B|
z0lXW2MS%Vx_}Ac?pJw3oaP8fRv=6us0@wVQ3x6K2`BCEd<8a%LzrI@aV?BB{-QurD
z{MZh^3hvkUg!jTX!2SGe!AIb0;TP~6Z<Er$jdOv}hr~-{{PuN4hXwD42i*%PM5bkv
zelMgF-VOhPX@~p1pp>H#{yX^jCO7Umb;2XJ&Wm+Y4&$EF05W;V_|0i0k8$`axaP~`
z|F9N@`}slAXThuCTK_JBUkMNLQ#CRx8|UR=+?i;GuY(twexRJO`(j=2JK>ri2jLIF
z{ro6pn1b(wYwaavjy)52!k9A8&pF71Zqxl-0$&8z{9FT1hHG=27Wm<CZC_{$JR82$
z^pWvf89U(1;o82{G`s+=_3hOE^6o4=p&b}?lmp)c*X%EWx52f2s~Y$Z;C}v*7(76X
zegM9P=g7~l^kT=nxpEJB29VSIFbsbguK8gWJ_6VLkp2<pWpK?8dGNz;*Zoii&xLD#
zsDpn2?&k+-t8MTV0qJ|-UxZ(7wgY#AL(&h!H^Kedy6{<eEnK@-kRGKT;6e8a@{xHH
z8LbTE@DaGyR_fvJ1f*|=Ps6`xmeH6C_rmx4mR`mY_#El|=Aq()IryhYulX<|6b@Ad
z=+B2=0M~q24sU=5`LF?*eq=NscEF#9Yd-9Q{}Ha$^C<kc0s2D=!l40py6I!%?uG^L
zQ}kP;DS$r?-)N?nm}%VIXeaJQn%p}AZ>;zFw8$BEH=5CPFLHimk-WO#P4LxbUi0RV
zJCJ!28O@*5@NT$P-qdh7)D>Vu4*WrQP<fk)vD3&rg`JUo_43xE>y|t8GyQgWFFe~U
zuW{#~7d`-&xEY_{82bey@Im-NCO76jbMWWj+L?YvQaJQaxK<ze@DX^>{Hg+(1Mbwz
z*Z}`3Tq|P-`~tXE#y<GPaIK7^@N?i=8AFk9=tg+LT$y$myLVv0+u&OND}X-+*T(A#
z_^$)>H^7JCn*AN{m*IZnh(*2j!CzC-OSMa!8$+g`U0)kU_R+ccy_`7NNFK*9^@*Hw
znb&{qzL#`}>|2UlBXYNYdn)>b$bH3-!=Fh%arT%+t_!)e@8B~zqg!Rj$^N7J{dbWY
zLhjJJUAg0QIf>)ecR5EAeHruQKJDyhTIidioH^f{iV_mN{vvt)%d@Qrm~!t_lsD8u
zk-x9=$|`bAvg7OcG;d)zl>Gz$y(G!21wDCidvEjih8|;YvmPBMAfvUdc6cdVeBsx>
zd*NkpE!K^|*TD15^v3;yIr!B9=`;2Xhic&3eptTCmz(;H{jhTQCemwjta^AGT#GO5
z@H^oTn)+qTFy43WLncDoKG&2nzIi+fUkTUNEurLa=!v%Ay_rm8($V3!-j)7U2u}{^
zUzPBE;eO?m^o{TjC}%<pGQQK>3132bZN1(PKLxJ&c?@0-_p@Kxmc;R5xV>IKr_yWl
z(r=C5oz31a96IcWdV4E|9}4%|tCw<C!<WJn=G5d7yF=9sUk%slstaBU4_agHK*s8r
zmxr-_nT8j`3$Z8Or?4Tm#!OvAn}=&_%pCZ);My9q1l|Ytt80raYv7N=gVva>$h?h=
zwwCXPPs6o-KLp<m*ZS>@%l-BOr9BiAC&x*@hUdsNYrXa`Zw;2eKkf1%eGOI)&wy)d
zuzL8haIM|8!wcXE?Zv3eUU)TJi=QL#O>n=lQ`+Mk{5H7e$BdLPzfI-eZzO#_ycVvl
zPs-unf%~-uNna0dfNSfMcKDCr+WMpyJ{6#U1pX#mTc6CqBM%3!PpprHLq*7FJ}Q8p
z0@v!G0)8Rf&j%JhXn>yyU(Iv8KhB%ecOp|CU_(Fr2Dmn-AA?^VU_)eaI8+JWXxbp-
zjIoBPAcj7Pj6J8n>}y`15IJKFQ-ZEjf25bU2EGy=G-qx_rUn`9u5UN|XK-!KJOuB7
zYx9N~crW}Qv%JQ-AnoJf&@bTHoH-Z16Ry>HDSR5P&53K_|Ai-vcla?j=Wc}`+Nt;3
zZusGF&Hf>H8r+V5KKB!5;Hw|k<5F5`I8*^Y#`KSI-kS?w5C6K!!_EZ=>DQ(3$Kdw&
z;bLbk>%Fs<TKMzuQ_b`;2=aeP-wL0A`}JGl-SE_3PDQ_KrVls8=cYsOTi~Z9@Pas>
zfj<h*G5KX){%M~Ghql5iO>UeY=E6UMA8B&q_l`>8p>Cbm!ozT_eYC<;;R*dQ?EILB
zU4HmFxMu$ld?P&9wC@{U`DWmE!q=NT>`cr>f7$_IzM-z4ljp)Sp3uuz3O^j)oS^^K
zxc_V6cfxlk@W01-E4=JUef;j;3m<ZMzNz1s_s_s<(VxKSe{v*YkN?EW8OHx>7c&0e
ze}Nb4WDQigFm7l5f$Wb3*jXOHC7*8c3IAj&`ZUjx^Nf5XrvBW{CS<`n(bI<9=gf7R
zv-UhfR(E!sBc?s_)2Zm<2)Yh2bcxOXO^Vw*jjkDdugy_Y)54)B+;6;+wvhvW7p}#=
z5_mE`(dH~Q@Laeymv4br!VAbNJ|5za*f$Ecz#HM0n%w<OG_h|7d^=o=jnnWxxLW>$
z*fWCHB<Od7gT>!+;2FP~itfuA-?T6Mfm2^%Ln$($9)0|&g-77mARE^ab^@fNZ-tk^
zwfSpz0Jlh=LVT0-GVhF>TIRLiOT9LggUniF?DhF)3>kNQE^Vq5nJQ%LdGP**%)EJU
z;gWFZz5shGUA`Qh@$$OsWQ#vF!Z(vXXq~$mnIoU_UmJ<f2H=@+t=*2pm%ufjCLiqZ
zFQF@Lqcl4HEBdqG%Sm5pa$`&=f^URZC2;3ri=?lDKLbC`<i@vdn&2-7q~8o*vekc0
zWTA5aZo%I(_0#vmV_q4ika-swt?j3zGp@n4^++~6?brVEb+Mrso<j_}(zHQhnK5^$
zadr5u#l=r8@Feok>TwJFJ#0*vI~jWgJKzV9UMs^iJPYoZzqI)x;$u4eeY$Yuuyeh>
zLpjX7fV@LkBR=h~N6JwKABOw22Mb;Yx1QmieiHwQ&5<NlU+2Z@c4Qi#)7xyX%l+1|
zlE(=ACep9wIiAP7wMFPq_WO}Zh}V=g_I(WtJ`A5Wbx57Q<+ZCqWICVM_Y^AO18{9m
zp%MNUxZj?FMZTTz^cRBn3<i)XMn>B+7>BQc-)xp6?0iR3@<=|6eK7b>OfKd8z85pI
zk;&^1_C*OYkr(~vUXo7@JRSZIGau=vuY38lBJ&0^nk~}4dXTwz+m!R2i&*<H?lTR;
z%iw<PT++|NPlfySGYg)c!8#2dv`))MrUsd%$j954aTZ?=-w6M-$uIWWO+EaZaBY92
z9sX^&)|Y$X55W`KuCYHd0)Gjv%~j^$Z^5<wk&I7<Lw|?+&9g1aln;LozQ-(|)TJ|(
zwa1MLWCngS6)iVq!p_IOr5+mKkpX`nSnv+`0q}(RlC(?v)|m6&P(Ly!AfvSx(KC+B
zbI1hQn!;u1*5B&>%7#A**VZk?@L$2T{hDfcXuE%#6JIpL-zB}@x=+f`1y3jaWjx2*
zn-kCC-(=W<OgS>ze$6!e0=U*DQa=?AZGdZao&&!beywSP)Q7QtEJbDqGTQp97Cr{o
zY;1+U1^4Tl;-_x-5ZupC!iV4=D(Nlw415ZnFityuw0o!MNVmeF6~EK{kOw~nuC*u0
zryQB|!C+rCAhRABtq*p<uYha5>VsFqwY{%VcqQD=mtte+2*w5YMtP3KQK?U3@2i|x
zxfvOI@9V;^Cd>(9dtVmGi_!JPm!_isG<8Wla6YYX$AcPVK0-#bw*|fj?q{#m%NF=J
zTx-8O;Qxg$F>Nq@t9cs!Z@AXJQ;%f+^|D@P7J74$DMjWTGY=`}s2AJIkU8QNeGjh=
zUJlPTbr@&+ZSX3%%*o>QVw~;wz^ma0ncUdJ8-`y3FETmx8vA{dS@<1rzdbCAH0ejN
z4ut=8Ui$Fwy)xz_bH|Q(b5Zh;eLT@o4!`Tcc|MS~<<^JDG$6AH9e(8i+ij*3na4-<
zHqj67glly^27e%cM>4~qmH?g!pTQTr#^KdP(%<YuW2v8dVrt*3Q_-=HF=xK!bgzHV
zCX#;tG23AxSB;+fzs!p};tzLyfQVh*R^(O{>{8!*?1t|_Ppdh1PWrYzakk?heEr|%
z%}3pLe}vD#?}DdEhOs_>hF7m?M^h*8gH3*>$8+H~z{^c;jOnHDC*j(>q!#`b+^^2X
zzE=1!T${Uf!;4PbrLJX%_QGcZxJCYHOX+*$e}<GVwtp=3bduu(smmJTY6~*Q?n|Bj
zyeP5G582liw2-Sn*F6)#x_Z&I6&bd}LXj3j7kMT{?PeB|Jjamhn3{?{%X8#AiE`mz
zc=a<xo_V{bqW`xag0cEd>fBExEdDeD-?nGocNV04&T_zRgXy2<toHpW`!`JDI>L|I
znMfVw!M7@0Y?U~E<}CY2i?Q|Jr+WTz-if<tF`7hA1A6XTxGOrsvzLz(WJJ#}dRFhd
zD|(yst(Ofw(zj}zz9o7F(6c3NS9Bsl&tK#Aj>B&_XjkG{n*>ATC4F)h_qyN*CiJOA
z@jjIWzbAc{+GdO3O#!?LeiK~lb4~E8;m;)4?|d9y?Ar|Q&flf(T@1kc;C}l%7U?Zw
zpzyPKjy!aVS0C<g#EMKIGP{wHF(Yz|A!Gb@aTPKLe0i6%Z+3|xbBW_i(NlU1^B!ap
z=E2gw-0@55bqjhfMrMuV^+`j|yuGy!bTuQV%?JA6H^H^}z$m;GuEnCzvG@g^u)YYN
z8gDlid>XFJzY5@W2fOtWixtMcRt5ZJ((`j8Ui(h!wL7)cYXkfmVp##t@%E3eV*9-v
z@K(6C-`fY@3D;ujD0~N8vp@8iaOiJKbo(v%W2FC_X`eec6#EO{eQ>GMxc$aFr2^g$
z*Ve!d@Ikm=yA}N%0o;Pm63ZpMy^s5+lf8Crw8t@YyoQX{9z{<9F)^Jn*Vc3I|LPH2
zva>nYK_=nuM)<6FTPcRGfos05hL^&%vNpSXIeEo>Y22skg0CaJHZBgj`D^zPrr<TC
z*ZNY*XW0{nYx@z|a7n+ywC@Tph8DwbhpXj>HwN%#_$Ih!Ul+U<uC2cZ-Slet;Xeq_
zpR$a35&UGceDuZGdyCod$Kemo<K}&|5@fPZ+U0wPN!m~id>P!&M;5#Ve$#=wqF<Ff
zV(~;`=gFR*yOH?`G8;@8<NRa@KCYD0BFzl^^}XbgejMju0eR%X?;{UwFTD)@Fx;=4
z;)gnTM*wewKd6*J()Yky;79Qs?<>YP2!`RU@PzXW{3y*;($B)T!2Q~?1y9dmjs(Ag
z=eT~U2jgAcd}LCoORc??!;gV$?YSPF5zrRe;S&e!O5CRq8;tXWK4kV_rxp`N;eUr~
zF(t&I>ickQ-`IkOu~Caz1@Hw*8N|;Oa%ih?3*G?#i2PUc9QX6QJ^D^$q)%yn?1vu?
z*Um)7;9r9K)wS3dSso6Z4fpe*jBDk@%>uZ6CUWzay)lNmFwaDa(UV%J_x);k(<gSR
z-(GHpZ-gHvzKHexHD15(g1>t5F7@u>ApC67_elEKyx%=YmvT<Q{|RqN;NP+{5T5e+
zaOiy68&h^K|I@tuv*AT>&Awvz$#5<IYWN#)E&pct3d*OowJw+Yo%e|SgYX>EYcXdE
zzAS*J<kHUI*Gu{1{&QY968+im+u=u;+<nJccrm;QuFZ9-;djIH&Gg2-jAnQjT#Kn)
z@L$2T@(seD2;fujU&8(Rk%dhu$8(1Q9(3lBgUkpr3G-?CLF~M&1fEPEm^RBOG0QkF
zt3_rA8SOl*6+Q_+-_&8e58DmT{K~v}nB-x+4?B!Z88TX2n}x51Yrafh5e_|@x-0q>
zu_4wM!v%I{u=rCRd<_13lZy?%_4-RWG8yEtPGsWk$vGgBxYA8*zJ~tz4b}#cv%Z)Z
zS1z)b2=>~v6FpDTZ)(lF!m`WetX=!zix{glTgTwX!8KdO7K!6;B4gX~TApf4&KKC%
zWSy+pQUbq=y7P;r(no6G--K&^Z-L(!z_-A!58ylC*TMbTxa2<#zZ|Z`nAAM>egb%o
z%e5F(0$&?oUk$t>fVaRehHLBDE$~{nHV57T-vrmrB&Xp`aBYsC`bFk-aBZy2fp@_Z
z`oD4JSOOo0YxdW`cf+-LTMPUhxYj<lzz?FGJ|TS}-lw|aePIXuQTW#qxHE{_^$*{I
z{)DxlJE5{jle&`oQ>0Ire>?M$lOz+-k&Dc~k;zI}(|;<yrZ0v6hrOuY1RH)Cx3Ly}
zFE$jIoY)at^S8pEgiF7Sm(g8QTl}dTz7?LZXCbl2Jrflhhmm<38Naov=$M5cNIyP@
z=XiV*9qxE9G8tcD9~zmUyIuvz9L@fLRv#7ct#H5kkUSdTAHswD-HFUm?6GM6?uUPd
zy)!?5OCDqJ-@t>)nw-x(8kwN7W+O8ZFuoSU#{+mZ{OthV3?GAQv9k;Qd$<<c2H`IT
z=%0f3!?nJb@@4!4_v;(drn2EOzt!?DhKJ#P=dw}{)$lBM(D`)>GS$ea{U5#_uEm!f
z@SBzN(x0-3e+N;|SIC(A!RHdkxvzO+Zu$w~(7EU-AWggvx_wmi)SzeOA<Wf8Pak?>
za|C3Pj_~wUpyy2V`1NJ+X#;#U+;7i8cnADixS!80cpv;S_?0}z?KIA^MP>|{$B_wI
z%O;;lOrkv6+&>H62)D=0SXqtrc9F|Z5IbTVU&z%oDSHQT_hHi8e*a;Puir&(0J(o0
z>iYF|<P2S=Uwg=J;xOIbVfZjyvv=0ze)fvr(+ik`2K2Q&_@4v%S{eL}0A2_GQ-J<9
z`0oPJ_rSNq)3G&P@6J}FJw^?~pI7u-B$<VG!#A4gCH@=d{-wmtg|wTekcsSnTtc12
z&i%z#g(rnW_bY8w>a-m_k5Z?X$@$h_mL=#(IzJpA7n{*@33{|Sdl&p0@FPr{jrG?c
zTw;e78>Zm5z*m{+ueY<eeU`F{_pRW5>pv++CGqpL47VIh^>UP=N7grfeOCNc3*Q#N
zTj4$M3r#!2tK)v^hW{I$ZF1x8zz{sdx<hP^w+&-Yeg+<aA7pal?m*hfypM{0?e0J>
zeDf#$`<8{yQut5c8_fBU#KlXzxLAkGo8+O@bsKyfUTNBB+&AulKYqAw!!Z08@E{xJ
z+&mKYjj&TzR#HzHg{*ZywJUm(*kHsV`IM-|pYq`{$4VG4r4Jdtu0UpIfQ|<Ef8Ysq
zEjqsHwaZRq#1~q9^~3)R*V@|{{1y1cQjYkX+4&*S94QB}a53%S?{b!X(PzB=>73Ob
znZy@Qo8^nAnNDA|NR#&!&V7nGmr62p%9(7bePn9)r*dS%CA*?`BI4zHOS~P|!>i$b
zXG<1I+Tl0Bcg@dZ#K}Y2x5V+HQuZt)w!CueeA`bIi={5d(RITbckUCbOZP6O=qVr`
z-UR>VLiB7g^hlYiy?0)6PN8p??}}bR8m~-F5R!aK;2&P<KgW`MHj~dD(x+0U$VEmz
zj<5eK_FBlbq36x7?TY?rejmEm>qEWBTzm=hV&vnt82i&B@OAJdCO6vE9Q<m<R=fS5
z%G?8fq?z7*&&%R(`S3dU8k0-gE%MrK1u~B!v%!>ce?vh0(L+oguGkfA<vDWMF<$+N
zp4%Ngw%^e68hYAIJ!jmN^qolaKDRD(UVamscOZAlx?Rx<Q_lFEjcNGp@FPraj3KE-
zyx$G?>q}xs6|wUM`29Rb`m+-4y~8Va8G2eNmpzw{wKrpbst$fDT$^vT!LNdsik-3a
z?pdSlH~5d?cMFg8Y0n=wiX|3k6uA`Izze3F_|~~vV9P{K<9$+O66TO1W1KT&A#;f0
z7x8-$e1Ev#*eSdU{seg>>`{@27%IF8z7uZmea6aboTG1szYVwdU1Hn`VRoz;fR6^~
zABXR=R^Pi$KAivp*Ysz>KSaM@eOXd|__$&p*tW46nF`vlHYaU{7yMDbBhm%Wg=_1>
zL3k$oK*=!HCX6;W1wUBf(xwWDk&EElc#iz{=)|_&<F)PFGZ_DoOEdE^?vIti+u?p|
ze#xhcd`934iEWV|&C6%j%cmVZTZi?%s$Td2+;9AlHZ=m@314a2d6lPs4n70-vs2P%
z6yxtd>HGEh@DjLRe3bO%@YQg?y*TkhH}QAF*LOuPk}>D$OwZrWSa7<GIu>%B=;^$C
zSM*K%6|YwrmtOM5f&pYM{>H8-pLz9Ul6KhwV#_!@_X>AC8|y!IlyKT+@>jW=0N2iT
zvfw3fyDYKvmw3J`f;Zz!yKTqXo_lsBW$hsDt|0wrgtDIWKV^L>f-14I1wFg3((T*=
zUwpN0=MMNHxSyS3M;7rg6>i(HzrP(KSAyKY#$D0vGOsw^kQ2W@<;;UbPU86b>uCcr
zo_~Ix+$X$wN(XY4^{$+y%MBoR@y)K>$8@=A<jOX=avvV$wH>j~$Tyw1xB525GqLX<
z^W+wI_7xzP-{k81`#d>AUlnpIzU|7rrpvV;mvfgZ_pC10gWR#--4*>7zKnDkax(t7
zYcuilC~|ki<XUw(iR0rjxq4kL2f0)4ar3Rz<;swIBqmp^%QYak&-Yw?xw_nD<SLQ-
zqxAU<Lr&^#n={Xp^6o(Hzz2v;_MF_1b7DiW+%T2?(pN&i{)7K{fapml#vS_*XOfcN
zIzx}-x5Ue@0J&p+!kSX@du*QEVa|P4(N~4sXCK=Y{lh-U{cE0FzxREtva^Z3zuXla
zp#Q{UR?@R}#}T{h;G3S*c^mxLr`QLi-FoQ{vKy?V?}2Ca?us4~F?p(l5qqp1h9A+l
zEBbsw{!Yi0^t136p4Zn@>8n|T!!`T!;1w_W`(5;x!LJD5b?_VDa^B{ZZ*4qYx54lH
zz5h9kMUrXac?Vq9&yf$0^!mRWlSL+tSolaxW~aYQ9x`1qnXUdZ<;Xl9lX<{jrU99r
zn9L3TD<eLsK8JUJk;&sZUS{VQ)4t!_kB-;y$-UsnsfG@T1<o}EyKcMD^B8)xaeoNj
z2S3it$DK<`8_qtHJCX2YnSV?j;rWg}5q{qp(=6mlk=rul`gp{UGkjc7%2^FEL3;p|
z$ovNxZB5ZjKD*(vj*8S7`8fNyr-(&j_ZV_TG5?eqa)y7z?v%5b*Tn2T&yaKN7F{{W
zd>G5~4nxMsQ|in*mwrZkS;2F>&Wt;M1@IFBcm=#PfH%O`2k;JfLjdoC|F&OWXN|&p
z;C}OVDPL#}eFW~e&a%r7-w8j}EI<C1p~>QJ1@HybiMGBHU$+yZ-^JJVn(=7MYj09-
z#+tDiU26l%+6AwJYiA>a@Qnd{3SJBMYll+Sl=IjxfS<^7ysnLR0<z(^!~Ob|q%Vfw
z7r?9GkHEiZ>NmdU+YEmeuG!ZGe;j_YnI0d?{Y=S!5S|y%7N+2z4rmK0Wt<HKw1sT=
zX#s7a7+wR{+Je|vgUoWup!KH~c#%>@i}YLIuaJkfRu`EeWDcQCCY*OV{rXgiC1S^{
z<b%v7d5-Td82cdU=kp$1Kwad)my%vvFPFhBxHb>pLX4L5*N}Z==_kE&9>>nhVs>_*
z=PKm1bDBQ*mGrG6q#Utzhf$7Ecn#cdT_S!6v2nNouJtJkF8VcI0IycKh58EkdiZL|
zD`uZl##K^Ak!eKcchqT6eQieOLu9o28i3EjwfY!`zYEvuqkuRm>FxS><S?~9axUbK
zpHd%EmJ;|NW2;tP@p&yWC!j;KwH2Nhz`NmF$wRv*Hw1qXuGQHL{DlCXR?gWO+^<bZ
z8FS(N@C$g3*QvyE;|!$?nY#k&qYmB_z}w(bM!#4nHuS({-WFuT2r_RWqqY4xm)rFa
zYn#S56f!PipN90BAM@cm19&-nIDpr~Ux#bwb?xw}0Nx7^)3>y{P$TeExVB$52alrP
z&&SeEGcM*XQh@#W@P7sHa`^55`|IHm>^q9Q;_b*dQ*VbS!|gsFtDjPd8qS_gFMJ_f
z8;?ie2f?-S&B6DDYxSG)HAnw}rhUeKVm|x>#eWuQ%HhvE7kswWfXo0ov^wm7OB>P3
z*av@tJWeoelnDX<7aK<5+eqJQawq=Um&QaUQo)`Jez4<j%+J!FzvB5i3z@r+Im^@&
zwx{NHJ`KdzXW;gF?5-u=9M4!QRHLIG8Evf~b47{cix_w9wZQ3y9>-=oLus2m=*kP2
zM-0Qyglly>3oj1f>6e5<r^B_jlLya-YxP#<rq}AN4t@dYHQol7b%8cl?1A4JVBauY
z=EB-saTfjnT#JqAYr~=M!!`fq!P^3O8C>SVe(5dhuMXY{U(Iv8?;G<1spEEJo<~L-
z=X&8UDS1fx5%}){_#AvYTpQ;yzRp+<4;o_%kO{x8`?131+8EOSp9`?D1O8zE?}N_<
z@KN|4xHiUwDmfp+{*RmW;B;$yo@~MYLwc<r6u@@{<X-`w4B!p$i2(aL;L(8m`{3^c
z=pTho!?hS5x|H`n1N2+)*Wvd1I2If2UzK&npaS?J{HL9PRKUf*e%!+64e-y)KA!3S
z5-0A;pQIgkA|pQ1>Zl+7ROLI-MW&9Eyx2Vk?}TgVBkRJU?**jKgnu)D7s4+K;Fa*R
z;d0j^-q-CFj#Iuy_*%GMtgy=uuYha!efr@$8CUFB7CW0U<`HA?V$xe?{?5;0+Ww7P
z=5Q?*X1aWtncn@DqS#jmzX1IjuY^~@PcYNFW3-HUy~N_%;ScZ}x!~j8*ePRhvsaH@
z=$S=MYm0;M>`UK?icN7ppW~&Uf@i^(nB2Gzky6EbWN__1MK*jXT)T%;49|dDrhdcE
z)h_qDlPxwk!%InjjG5jzgYSZ01lR8T4Z_cbYvr4QpAo=QE)R!Jf@`rZ8~%B?w(nXD
zFAU(-@HKGFf6ee>xaR*ZxcEnVZ)gx+4PR&aFYLT;BmSL&KMw!2$=y3Z!c*20N8nmN
z%Z9%gz>DFp2JmY5p96R^{GS253%&=QYuayo*LV=VXr0cd;D^H#?z<V^j!gLmb2|7X
zrv9+AnIitlhTjBlOW=3g9ZYyJd=LCfCO5tzS`9zoGQE8^!;|4!obH0ZkAAIv4#NK#
zz^C9NaIO8NRCE3S_nQyd<%bW!wf<EM-yXoL;eGHEP5&7CtIhCH_;Ds*=f$rs_%vMW
ze}nKa{?pcrQ}7U6dv_=03gRa`-^|~5KQS9#1oyK~;&>zRwG3X*bL5BnCB|{%_bzME
z(}kShoIw2C3V#f)wS#W>gK)_+9_NiamqYM};VVpToLS7kd*Ir-JMBt-vnfD-F1!z}
z#qm=3EZi@STi7IVJY4mTy_SsJn(X<>T~CS++R(8KnVZcrxF6^d-UGi2uC=9M_+xNw
z-Zu+>2(FbOeFJj}_$o7h<F0fbd=9S78OmIqZ>BfeQXM?~a=kCL!571|bwdw)pTT+O
zGV&5C`H6pq;o0zu%>2X7=85oG_<DH4n%{kaRCsy~Z4ACCA-&@OX?Hcm($Gu0qH{b)
zURdbWq0Cu!dv;WyX9&5$1U)a<0-~n}Jq<52w_SjqwnRNi3l_xXMv<#}Wta0CTut-j
z4s+zh?j7WJ`3`rVH#T24zDYU_-vHOv?WtGsjWT$`yJg1raB|=+v~A6ACGdW@mc9l)
z1J`0$3w$B%N{bC!;Mv%xje$Gh1#sDiiN^+a4@Uem4L?1o{8tmh;PySJnE#xs_jbF=
zfu92(HT8%8XxEeIFM(H4K5Z^v1D_#%M?(7h<LO)AwXf>!dJDWAuK9Ndd=RdU@zd}L
zxV_$rtrd(t#nfwf2MyksV4rhQOv;x7FM4g4@3-M(-qu8HEr37Hb7VHj>ldeeC#gAd
z>ptNQyQsD=>(R9h*@UxIqYt;kcL(rZ_!9Q^v=}u4&x8Bvm%b-){A+MIuZvu4*edq`
z9{23btYr@Zx$}^Vw<-6x=tWOGdX}^Pl6MCqS%w~o1s^ziM6MIL^~~SC$8+R>d2+XT
z`L&YY>&W?yvleN);oHe?BhPVrBroH;OvA`zux8fAxLLRbx9{V|+IhWaL;AJcqlTxO
zc^K~(<-z6L|7eq!d+E#Ig$fs6Y$5)h4u6;D$iZQ+ok%&{Z?=n^#PKxt4^9-{{&zuw
zT+-*9xM!~yh-=y0DNPl*F+(oa?mqJBAsg9L?kYYjd2cghC2!+9dKnwJ=Zc&btMcJ;
zKUEu}%HiE`zr779TQ_$6AACscC^77i_U8-{_Pvi0<lg%_^HwR_iH4lLUzoIyctP|<
zh;47NKDOnK*5$I1dxiF8%kA$kCw)ERI({dJ`Q`;Y$J<%hIUo|A510AA-+IY{m&0W~
zx(>VJ>G5$=nNx2f(|}AN@%|Ks(*&73=Z>Z1(}~Qw_3uP)<2f!9b{eacdyeu9!dHoZ
zP78T$MDDn`ZAA1;q37*yyc10^?MX_qjS)SC#KzaE8GA&}p@tr@InA><w~qX-cqe+7
zsYhfQ92v>044D-h-bs9~$9RXU4t_P<&v#;r#POTpGXIM_9F4@wEp61e!`z3S*OAla
z^rP@_jXs`+uICIYfLri|aBa;~0G}g&Z9Y)}Uqt$R$`LPvI}em{_7J0&!VAUc+dlHj
zDRuXG&!3yov+64U`KIUz5zmCb&ST`eh92?PfESmh(KD^+k$OwLA(-a`aIvEaJ4FBS
zQl5-NJCZ)_lt<*YAotPL??ekkE@__Ja<AMS<hP{Of4(GoB#vjnFH1tt_WvgOZ;f-m
zSIRYxo~rBKiT;V_cs+!7*p3mNd?UXvQm3zpvfxYMT0IxRbK%;&qzYackiH3iHC&sw
zZHCvwwe`k802e=5#9~SR9iAh9nDhK3?Zf@PrN|W__gCbarCy#k<fJ{`=+#SJJ>%mI
zx;<rk;dKFA?AU=FqW}A1@A-xuV(+)Tv1}H(9^@8@y<eUuH|Mqcaq@fMM!o)$zsWnB
zaIK$b!5@VC%_qcOiQ^B$&xl~hZ~x=@SNyipzLsmx`D)O!?Ph;H7J6FX+u`T(9B-#m
zX8Y!nv$pF-W)2yxEe!32&jfHOOEEE1^k2tw<SRy5#E#27pXT4her1E+=F8#raKC+T
z>2vk)2jExp951Vzf$(<t6x?r(ZozxunYX+XeTnCIda?0Y&&E+?UPeaiSD~A^qXF0Y
ztp!is^p5%tO#%E!c$#U0@h(sWd<k5eLp8uZ4Nthw7IqF7#0MSljc~v9pw!hY@w^WH
zDD#KNk3aC*opVqAewjsxo^kYi*r@M^BsZ|u2;f=pw*q(({B^jt_f`cT3gAuf*WiA0
zezAYEo4*!+2jJ7B*Z4U6qX7NMx3J%Go4z-k1<!`B$Ch|o3twV4G_kJ;z7ek3Uj@G%
zuKA}4-WZU6GrSd^XXfwT9hdwE;9YRF{P3*-`ja;ici`H-Mi%@d_-SVT?)Sj#^24+K
zKVfGaP*+ty@Yj3KNrpy?jFjwYIBAj5!bytuoM^PraN$IyiIa@{k>W(9i4*5CGE|&2
z(Qx5JT}F!*8ZKI>Way8Kj3zBIGBPv*w#fJ?jo;^c?|tu{_qyN9{<?dg@A-be=bZ2P
zo^#JV_j0=)Usdo-xR-v3<393p34Ds{aPZ%59FsqTe{{!l7kZBVhIjrHKZfAPz_r{s
z<8ZAX(r#m4j`AAMg^PWypG)A&;95V_!1H`~Gkleg{x0|$xYs;n)gQhV?p1$j=WOz!
z@CT)xfAlZ6oh5JDk20)zDq{<4d>=dc@F5>N&DasXL+q?gveV-BX9IdxH+t7c{2f8h
z`S6EC&xexq-0SKYK+gbj1<1w6r?JkCkpITvpOtmO#B4&nL#Mmz(jw%R+`+S4Sx^4f
zkdt}*gYJ4V|LZ*0zf<q$GWaoYt)J@P$HBe&N&2zX;ad3~_z6DcM;xxj;T$}d@>(2c
z+#U=>;a@b{)7U@Ghi_8KM<`PUzYG3Dv%JLELvEkdBXi7M`rOzC&w+dSD0?2W<n#h~
zugrbx{^|B<vAx$8dd$9umN<%#{|1|Rb}Ic}Y{*K#E;ITcxzT$LEPO-W7dtgc?uI3n
z^P;Z?xq{XM3){r@W<!oTh8o>__lj@u{{I6963@IjFP2L`H^67%XK)>lTjQBzJACPP
zyxTzhn8S|~;Jd_+6AeG4UJtr{OrU4ygZlb5rIGb5T#J`%cqja9)6b1=UlzfKe9BkB
zU-2p52oG-8?eB!A!LKmw8-H_n0A32$)>#wqD}8v%H(5vd@ND=UaBaL6EyAmOxb$Nm
zd0X^XNqjaQaAVot<Fa;)Bwo7E^TKz%{SZAV<U!&4C4Mh7^hi8BZ^y6bnL|(gqu%Wu
zfoI%-KkyK76^~2NanK$sqN4zrt9Bkp{7#N>FWG`GTjAdpUzQratZxe477kq{-iV$p
z=#h5;t$Uu>p1kwDQ>oJ^db;5G(l+lxPfSMq`KUW~!{oHS=l-#f8b<EznMAn-J9mq|
z9OOD);2l&MGlwPVd%+zuncpI&cy{#&W#TrS4Sdm4i=O@PUx{CDCE4q9{c1z5foE55
ziQK=F<m^|}?f3tXTf?&lOW$mgoS|<LxjCK-{8jWFNRk_I`)3sY<=s5%Sxl_WE_TQ4
zJiHsOz4M;gWWWDs?a{@`8|StP;6*?1jv?vSa`;-fSN;}W55E$w%`t884xjS9@NRe%
zUGW&b(XHPod>DSb$&Gho=HdI`+L+F~Q|HnqwdB-Zo{PLzL_gd$?T*>1yF+({?>ww&
z$!&*+p0Ga#BlWFD--gVo#P9zF?E^T%o8Wuk^`^f;dl4hN6Mpmur##ot!Uy52;mgeO
z#<R~!cnSQ2CO4jarQXF_%ZKN{i{V;-7Q>(G^o|D^FCFCIVfgQ4+|3ztmCTvHbjMu_
zdN%*?z`{+YpF#T|jnuOn{t8^{x8X(j>>@n<Zd<=r&ph}P_BCD#Kjh<It;1!1B_6jy
z`+$hluLXW#m(TeRcp;pybITifH<f%keC*W1CnOK{9(3bU@@2%`i<(EzD<7It_q;Nj
z(c{Al;4k>_a(JH)uZKVB!`tAUaP3)lucKdkMmGxYp}fZD;axsF^B&erKD+?l4)=P#
zCH+_qe*muSDb~ZAeag4N?|^^O?B}c8{MHNK4o}!CbY8*|`=fBb{+owO|7rOkb1U~$
zKD+?_99%n3Ru1olzu)x#eAoYac(+gaHu&Q{ycaI*uh}1kZ-Z;?KM!y6DW7>SdB~@H
z0ldzqd^!ATpYrwaN}uv=@JrxY`}M-t_>>=o7s0i?&3U-^@3p@w@srtNj}Ps<VF7#x
z<*oRStq+X(q#XX8nEn`d{!X6E2a?AnK7TLs!6{R2o|5_Cf8F_@13h0q!SORmkNDXS
z-wU_a5pnLG+Z>0#4cEqL_}kpeeP3TkWWmef+P!!oyaKN6F;~K`f_u$Z(hj}k;adDV
zN!D{^|43|y54h{OPW04%7&*$s=M8)LVC~rq!t3GMIrK^R9dIu{Bd9DSAGW~deVg!K
zCS5<)+hbOItwN>^8S8w@vxbcQ?#>R8ls+lr#&}tlKKAP1H$1N2kG8_AeRvOiy$>IO
zm%+W-T>P6`glF7mm)Guh^WpXA*Y20g;CH~azNmw@!nNGn3g70VzX#p{uca>WSP0sO
zp(Fe>0`DcJD!7hw*?%$4a?K+%hm3a5oY~5=Yx-LAu>hU|*VaMh@C>-tM)mMzKIPls
zE8*p49i04;#&5mw4e%p`^H2J9h~KIdol<57exp%FV!D7l_*H(ph3oKtUU%dEY`IUh
z7vQ2h=YG!iA?G!IM9&uVya?}*as0HQ$9@)bkBnr|Q;VL}C+h9m0xyDlwQGd(-SCUx
zXJN<eTl2g?8ac0anVl2EMTRfLfcTIL|51$R|2HpzPsMolfAjnY*qb{^uR|GpIozub
zV!salDfnGn$LkQZ4}l49h3B((ppD<2Mfivhm%hp+7k&o&8?2l=;r6-AJ(X_GjeLha
zjO-~j_ebH|;Lj%1V~>?Er5+XVp~v)kG%Ui~7vX&l_iAUUX9juhDg4WnIrg@{x%HHL
zfp^(+tjI-?+qHaZ;Z?4~wT7JJjA1+fTXECI`1<IS`i@V@BD}`oXJ9AZ@5X*-GyHb+
zYxSAH&u#E+;^!-`x%Cl08*M+OK568(aL&}iQ6c1>HRSC5v_n#J*+b4p?v0bDtTR#J
z1w$@&Ztg8xX9U@t2U#zFd}^VQ>$vasyjLeu(mo}~oSZwgaI+~Bv@0mQ2L3Jhw-Wef
z%SeRZn&EH4UpBea?Rnb|(b0{}<DZyP-whsy_ru>~=7&&<71UCG7XIW4{k|xDJFx)Q
z@_rt?6YkYVqQ4a03)j}&wea0O`di>#KKi@iKZmbQY9l!jC-#ToZ}{k+g-`hCPya6S
zB3zrd^59E8=~I9B(QvK(YT@ZV<y+ucKIOaNC-{^fhOh7`KMT+GDWBfXvmc-GdGIrR
z%9p~=hims8weU@FEeEu~+u+)LT{nCyTwAvc!#m(!^RyNJ@LlkP_z9jBAA{)+5#Kuw
z_?|D$N9GVR+C4!TJovDl_v;+4m2ZVFp}f}^ll(SA-p`{B1CrM-eAUf^lGlG?=XI&;
z7<z_JnNpwI1a=VXaLrB``FI!g+>EYphG9o?l99KI&@+Y}k&EX>=L44FM-_b4O1;k-
z;iYiRk1_n%i63XmeBJ(Mx4!rh%5~@KA@uB}-7ZV;!~PJfv|Bd0FB3c2qGw~0o?~1+
z84n|Os=l|94_^cK@>l9x2H%DsUNI)T4&JB4M+DvqKLP#U<~rV<(&pcA=Yd{i+R(AW
zlrhd{jly@qwQ)8NFU3ZwS>AZJJ+p&v^uV=oRses%rwz*C)!5g@VLki?pEhWNU$saZ
z^dU3q<Kq~7%E!mRBaCCXHVz~3VE&Z)9$6IrCgrtUUjd)>vEKj>qhBlE?%3DjtPj4_
zr~DW^4X%|BJj#0zKIJ3u<9y0T;V1i)uYl+Hly86+z~61g;JJ2;NBC`oTrK5g4>$am
zKf2@Ico(A|9p^oCU_tKh;$y`)FF6iB!-t0-qYiNGUL(ulS{xU`^C_?KO86?cSByzc
z>Lo{45F=+CP8~x=9VM6N9Bws+$c-a+{h3n>6Oy|wHRL1*?ss$7F!okPr##PHik=+F
zwQ%c<?@38|Ho1B-calHa^>!&(gqJVE>lfi|i}2n>_~;^hei5GeJ-hze_h$;=dwklb
z+~L~TtB1cpd9U|Nq@RY#&-wJz&m=DH{(~F)5*M9rTu2`O)o0j84I%fUA!qM9JSR`S
zMPC-VaMS0e7K&ue@LNO9z9+KYIFY$2{c)ZvoHw=bJ+9;9$$9QAJP)3IzCJIM!cT*1
z^{$1lhM#NdCx+!FO2%*tyas-RaQ=z!lE<&)w@0}Sf5Pxx=EPPzUx;r*lpRM-Tf5J|
z55PZ-Y`kv9JLqZOCtrSkYGIYhjrV?Y;Va-?@2!aa68M>Lt?o7O^Wa|Z<VpEvvCsJp
zZ9eFN9|hOmcNv181}`xEch13y{u%gMxR-y@&PC+PS=y&oa?JkUC&t_rZf?l$3<jbl
zQ=Z?NkUlJf-wrqXumj!o{C2hIzCTH~^Y>oGhe70?xnOGH0+DMm<Rs6XZTlc{v&c=Z
znOayQa^FajE41armvMYKx^!ycNUr6dl+7hart#aKWGsBiC@W*@MSJ}$a%IR3teskT
zLTr>6a^lNlZhI8{fOajLvfjUm$5rrGR$z(`Rq)h{6Mg7L_Y!^!iSFYQbqD|D#&ic|
z|BRfrj_ZdXf@^&~4nO7+@A*JtBD{+{<HNJyYvJ0vl7;Y_;49G;ue<TRflBy2@Uu*A
z?U>koA$fc^{E+za(GfT1WNgp4?a+yy=iBsW27~aQ`|wHl6L4)koBBhZXZn=Sf%p3G
zV)$;j_Pneb-U0V&#|U-rXFibneOcP!^q1Xsu=2CLzukq7RL;?zgiO4xjb}hZ@N~HL
z4U!pnE?isdq;>i8+(mea!?pZW124zEwl~xaU*p5O;6-q)jfdc;!4u||o81_ifmgsU
zWv-03UucbWI84Su+K;%WVov_N*}leiDRSY1aBY4mf$xWF?Oy|b)2Dnhyn{S)d4l~i
zs{-O*7yLE2*K;4qS1IJW)5rx+a~%%-E-8lWw|hm;9D1al+B}o7n|nLB){pt{=imkC
zinpUN&y>Mmg?r62V!sZ45U#x&)Cy1YSu@X2&vfe9g|2Y+uv<^b89VI$miEXX_q8E+
zx8&HRiE^P^-Ta;MWA;q(r<^kJ`Z&*;#NTXq0DrvdBX%0F(@zc?=Q{ktZxj95XZsU@
z)u5;0(xiP7@!8o+k-4G;nOBf8=c_UFkMNtN|7KnP5M^7+{q@fxa}XI*f0W!f$#0ha
zTyOnS&no10esOAH2iM_aljK_LdP*J2y4k;2muRDdvYGs5*_e6BvyH@t<na;YEE|7F
zk~3`dVq?u^u8jy~hxo0S-!^a^??-9hO4~Q-%UNV9Sp#|9j|oqIf@d6XuN*1<Nglrh
z8_#haE>7~V$8Cdh^voIlN!gv0J;-kdr0fYvW&dKA6*<Y{KdqRu-_v+clAQCNhRDrH
zKEK?Nd+RreZEDCx$a{~(<o=?|6(M)bdPm=&x16+5{*%GL-N;?fb-bN})m8<Bm%+#3
zw<d6V(idI_Klh3$_4^5}@M0g{Bl^kXUVS9`N8l?c?={y7pM&>PzCOV}JAp~NN*>Rr
z{I9tV|86L;U7vPiDf$!kJ&`-j)Z@IL9^toE^t=WClIZ!ap(kj6EJA$Qf{t#Vx^yhU
z`xoKk@KJnt6<h8(X8WZoscQkbc6;U2!q+87F8n(2+;p9rBXfG#&r|#qJzLN-`X$bf
zgwgXG^u)faA#3Vm>~n`A*NNQNSEd&Fxeo6&<m_i@-O{=dSR3~0ud>HkT$e5LWK5<H
zndAOvN`22n^kkCn9!KUZuET2#d&U|xip&5qk~hLD3>n+rda);cmHQO?ZPnh-Hl%Ki
z=vf7SLiD`#qT2?xo=0MO>d-T!=n*@u@Ca)`ulYuJ4?Gv{bssB!q><zL&@X3b!;OX?
zk_(-+c?6b^T>4k17M>Tm8bdDFC$3s`&f3E>WMs6lRtWEbACHcBKiNwbt9+$XUR$$n
zf%j2f;~nq;_<5%OU}4<9e)ya40+SnSk#YFatEbez%^3bEe^(j4%q(x5o6dq?>%$A-
zb#QG>TM56~hi`#b!nJd%9q@7=-VZPJ;p6aPxYzxe%+=vu&Qif+_v#W~8T?kpZ(iq@
zq)a~i%A_*I{3d>CWvby<C6#I5w+epqx+fDm?Qm&()3<JZtKv7WwWE|7hTm?KiSXM5
zzt!{G)m+D8RK|kyeNicw`ZLzFMmcGR2*366n^)gRnJBzFsZ1%qJ<f0MhR1C=d)lJ2
z7Jk1EZ-F<$)#sn^o8ecO`i*y?hT)~Wo2HG|S$I3;wegg`mvc;TE%)TX)6ws>ev;hN
zL{8pI`Qv0hiM)`M14Bp2j3Vt&kDl&pyyH@M8~g>hS3C*tg^$3saW@Ko(TC5&`{7=F
zEBZ5kPT#}RxsLav@os+syvwJ2Iee!NuZOq$@HY6+HvRcsFMJBF_0uT)5L~;*n}^TC
zz3wHg`uFj^$bH`ZEW7|-3fJPS+~HnvBIWDhWlDL8qha#)MevOw;^^<cbmNF|8>+V7
z=Mp{r=#h6U-^+EppNzlLFb>}iKf&bAdr&fl!%x!>@K}x!+a=`8ZTxmm5dIy*wl$B3
zZj~KEu^pvsfHjd<{t{jRUkZPU>$q>huK3*50GIbFy<%8=YlrWE$9xl=-Tc<dZ=W)C
z)>tY7Qf3(bqogtu{8r2yS#Fjw&Qhj4L(YMlb~5>G6Tf-Im)I$Q-<edVgx{jr)?%&(
zex?s^h8MuKnCe=D4=uuH7U5~n`rFT4gqJMBYZl?ni}0>R_>jZB=6Z>p8My4Pd9|;^
zeUaou*1>DT#QjhD6USVUyN0hp?jX6#dRNhuv&YBJB*#mPRP+Y}_g(AWql*u<{MO8G
zT3ofjzYCAWqWCq2y>0x~%XRp3hF|u&+WK22a-J`RoVI+!)WYXv?m5Mfi@g)R(!QS&
zoq5QvzK(kbsp|=bto_`qO=>ItX8nS1liaAkhg1lE4K6z4W8C>3uly!?{0(?Sa>*Z`
zb=%aobEM>w2y#v6dG%}hnGex5fv(bx+)qmV9x-%DPQ1viTN*iU>rLE?iCnWGXWfh0
za#FXzbF^!{eJ>XGJ@`{AnTWkI^qh9{)IzuDsW9}|zCR?IL{AZVp4&9F@UZBN-S-6_
zu=EJ8g0H^Cdz~kC`mj?DpX556YS^*+cT^OKo-Xu68oc!gAA+xdU&OWRhyBu#@EQ13
zaId*Qc-k+y$Ax=+(@^}ZB9C4PUv(IMUiVCLUw-^Br#;Hh)9`iuos&BFM)+EEx_+J)
zZ?9H(7d&DAl|J5tgp8{m_$WL!M#T3)e%p4x_cw#Z_bhVXZpwtk_qU%;_WgjwyT}zI
zch?<L3tPDkpJdb#`@t=ii-8ENV1WHC<c7G8*Fj{Sv1P=k3S>IIHMQ`zDHA+s35cy8
zY&A4ZE!-*bHDLH8aa!-j^B8ik-N`+sjG-rz<kDmW+4rhL*c-ds`@Eaj%O?MYo2M2Y
z5qq~M>1lDtMaJ{I`*ly!KBDt&D$!Geo?-Y+qUQ@qdaiQ)ZbdHpUgw>FXp-E$u3R5-
z9W7G}?-YF>GvuT_-*(%)3%|bp?Wu*^&Gr--XD>tAd>EO(A(L;)Tx07H-*d>Xfo)Uv
z-+$fT=f;8Pan3u7p3E1xH&fPU5xC^>KJ=^-pC2*wgg#|e%<6x1ymFs+t{2__pMq=e
zX0^j7;1?nrk1^*RN2$vkK76os%KqNqiG~l<#r)o2gxtFP{;7qFWi5HEA!pB5pOw|5
z_>=a(yc5WpILdY0p7Bn3F1!=2t!Yc(UGU{*`OEFL7yUKxJ#er2S9tRxylW9Yv<RPB
zgr^Pq`<J^2FY)2hUpvXa^AAidR7yV#?REDW?S3eeeh@jy<N4dC7CswB?ioW)@<M^T
z4w*yl;vLN4k{6yrE;jdw+;%rFOyJilpLS3Al|Rp3gctd6sZTq(S?q7-I((|(r;Iu0
z*^kH#AlHUmhScZSM7hurZhd;N*Tg;eyD1Z|v$4l80>8<J&%v*Pf6Odj>Becsi|lE^
zuQ0i>$B+;2g>OpW_8+y8dNh-VYaZr32$^fH_?g=;_PXIJnI|L2^&t1$PU3;<@Q)3-
zpuK>SG0}moCExSTA)=!nel&bL*YUQHc5SxnBQg`nG$ZpFa+N9Lq$+D|k@{=qcIxD{
zE|oe}l2=<EXP;4G_g#jscAY*F%OR!cIUhae(1&qbp#rP(q&~Iq#ve?nIi>}^6TTbS
zc=_P>tjb9FZun`t^nH(Ecslp4UVS6wXW?m-*Y;J?huBm1(VquThd-F$pZ#D?^q0c7
z!apxO{ywgKLoV&uNlt$TJ}WUE>P?P~KTAW2o;LKnz<Nf@mA#AbQ6C;b|2+KUA5A5m
zzmvErw&O;8i2R1VS!A^P*(iKH+$(0Jd<FbkxYv9jJ~Y5@f=_TA?`!d4zZ<)w<m~8f
zdw)B8_)p#TGWNI!&{KxYQd7@o-Fi&GSHrb>q`btr3b<B}Y`EyR`Xbh+m$>?i;G2kf
zFa6Tz?d0El%3o)#m-e`MpSp&=Vy}awy_(Up<;UK!EqWx6Z-iUVHI^spF~18vf}R(B
z^yHHN`r$94Gd%TFf<M82w_cIok|(=$f9lXv0e@TS^)vLu<{x`L`@7W4sy}k|tfkUL
z?nOgR>c7OOKlZ9<$7=kF>k3|BIb_uzJ(Evxo<aP6Fi}tNR@-lpOC#TvJ~_4U50TrP
zB=;w`et}`0_x?oh_XvDBTzf|#3SS3*4|d}I+Mm3!a%u(q^FF)*9`)hv@K3;xH}yNu
zmLmMt2VVhiG`W4xXsw7PrpA%khK!YuV*TTs=@A{_-|=^?;6FEY$QU%fg`bT~MUV51
zfw+!Rt0Bck5&S{;DW(qlad;rYZ&mQ!@N$#eep=Z^`mCS4{01`C8sVj%xUnR@IBNv4
z)s3#gr}X(@7`_i~eK#aFR_)KrSbZ`Je;s}_u^8{O(2-UUiXX+~#Xs%gjI8A6OAJ3`
zO?9%p1`)Yh<lgLc?t#`AauU;Dbz{16AGv3*etvNa{LAob(HZy0`C|@J-wt>W+-tv6
z{E$5U68x83hkyTMV!J)%#`+|BHvC+Fu9EsPV-Mbo9@mc_$NM-39_~x(L*tB4F+2+Q
zx@V7|vKn3uFERB?->!0fY(}OP8L#teQdi02d*Rlz`ooR7+WF>sX?1C{5%e^*=yT^B
zeEw;@PclZx3(x3zAs@aRzRj#l@J_2D;-}>CcKFp2L-#)6_KC#M7ws4lKO4{!_VKgb
z;a>BS?Dx%K=h6PDh5wZ`S&3mMw%_-ptjg@Yfk||oJD|^jslR7j!M$vWuQ~8i_;Fmv
z<KsfN?~37T;Qusv@Qt|rYWRuId!Ox-HtQ$%UkP6#bHp#Z-8PdLnRD%QqbG8&eh)ef
z&w^{~rdfw;&n(jS^Zp3sz1A$!4temX4=;tUhRfU<Z>Qid;_XlipM$SX;AdG}`gD+d
zT}e9}3eyfR|JZGZSf9Rb-2WlF^2Moz|45tt$&i&CG;QY~Y1;@nFLh{Yp-trWCCT08
z=Bl(mupjjs{r&dbMR>^~yvB!%p9A<Q_P;BBUXbLc^#uw0%=8R$b1&KFufm^7lnZ{@
zjg>L%?c1vFX9Pyc;c%_5Bk+LISK@CSIrTOCxRdMf&vv_gB{A!KlT2c!3O&WYo$~w}
zun~A8yc~W9*YTJU9r98)KZ%Y`WS&9hBc_b;_dy5YgK%vPJPF?mxAt~p^P(|+Q~$_3
z1D8Fx_<c(#Yz2ok{^4iRR@%5KUW8XK!kgf$hV}0lb;6JHu|Md;rLVHcf1gJGm69uu
z|B>5Ql9MlV^JMxfoG*AeX`V9v23j8c2XJjoSPFlVZ|G|6RJ#aoS%i1{aH*%{@yqdV
zwah*1x)SU8DR=#nhum$ypIWGvv9`vLliab+%?Vk53I=|;-}`)#*sDj+IQ%_g?*oP&
zY1e=|*HxqE#Zm8ji3oa{;Qes<TX^Oei2WTriNP*p_VXQMulp?FL-6K5>ht;xd>7oS
zyws(L-28p`G14YC@?<Qw)|EC%b=xF=jA!bv=;tfT;QerIj;Vw1gKKkbD?E*Qei)zP
zJ{b3#J@9n6SByzLB#%Fee(Sly)4SYyNS`>*6{Niae`a17)6bwp;3vRWh-|DajCZV~
z@I1KJ^CHn-0Y4djtXbap22%rkIo#{{zm#u>N8n!d6y68Vx!b!PgpV!41F!m*kHGu>
z#C^Nzf6)F2q3Dmo)A3Jhp9=Ugzxu<aeLrLBmxo;Z->N@+HT*=A+ec?D-Uly%d+lXK
zC^H6M2ft0q$8x^RE5<v0;lHr=!FR-?A`|OlW6wVeUIq7>BO??kgm1#e7}xRg_PyPZ
z)I{o0h0JMx_FmTuZ-iICwda95;oIQa8J7Y09X@;lzR5>_$~b4S;MRU{tevXtevt80
zLC$>!zFl(Mx4!R=C&>%VZjLKKPyV>~dx28V8u%u-HeQ<Hb?{4&jkl%oH`lu0yWw7a
zA%3Qi-+JL^Oa3}4$<I^l{1riN4m~4(P5MTTeGg^*)lu;^^RMhpzvkWMVyhNgd*J6w
zo9uZ!u}z|Gn^dA_Y{EMyi=Hj;LvZ;fMZC_=_lH79+dhk2r^vmY^p0WdJ4MEx)i83M
zZ|FH?7QVxWr@zKMDEw?}#{Hq6Wp`iNB@f;UFEsg0Zmcwso5$etckjZ_e$Q<ed!PIZ
zQX|n*kDlWu^>=mK;5l$@j_8FKzza-2j6Km&co|%qgXZB^`RLF58+(m#uiR|)Ke@FA
z{yXf4-`?rgQ}W9%?e>s*R-)&)e|XnZ^z=%OhJQ!&ypW{FzNHRCV4dh`NA5AM<Nadi
z8S4+Iimf4JUi+q=%Vyy6_bs$}HEn`#{=vP*m*~%hr^CJGqX@hN-hq!_;yUi5w8uqm
zd(<NH8Zw_YWsG;QTi{EkrtH6SAInAd=bx>1=!PE$KhG?0wS)blpR{Qj`K}0=16+r1
ze=M<Y{^I%)c%Ack)86}wQr`$X9WM8!@%h8vj<tM=!ZYETFIN8}6QEDL+D!PCMR>;|
zyx-wo<3!pblU(;4ZSiFpkKcSWVXr&nymy_0Tp@BxW;h2ga@Qgkn+wk~zGt51t^o_)
zU=Im-ukj)EDu=i7H&?WJ*Du1`7U8{%@KN{%{QEh+#Oo5YULCReZXUk$0Phe|-#C}~
zY=@h3%gB|b)Zr>b!q-0Hwu!{Fu?{KvJKwT7s6W%If^UP%xvjXZP`PDD+Nu#g`p>C_
z`?!wt;9XXr3f~DYolW|lr!%O855QaC>k`V_H@Ctk;4i_ob!f^Y_a^X~g!1-Af|SpO
zANMcsoG-ixz6x%wvtn@*+!*)23Vs8B56D_y#JKUixe<Ol<+XFNJK>Qx`HrFK-xu6*
zJOI!1;S=x-_ycD7;60WC86#2h;#Rl}rSSa^yZtQp3nT7ap8F5_iN8~&<<AoM7+j0_
z8i#A;o8jY1dGT`sKZoa>v3!Ezr^M~W?${hbPp^-kbMQVNJCetT|Bv^Wq&;5Rk=Py`
zc6*3Fb;w;l?>t9)F;On~Gq-=Lrh<XP|D&%98{y}{A5Z9?hvNM+hMkw;x4^@7hMlBu
zv<{)?<U{)X(u~88H|;pjlO(p%rg^W5@+(d5ye}m@7k;h}FM*fCKWCPAHu$A{4g4E$
z>lr|7Zgal5CG9yt0R9Ai4S6Em_K@4|(!ZCxd1(f@LksLhOaC+`$vNlYL|+CuZuTA1
z3lY(`DM@art1pV&WYCejMwhEXZag%-kSqEslH^Ws^)-vWu%quYNpgnW9?^H0BbV<j
zC+)U#hH<xKTK!h}06hJ0Z!YZ+A^#P_|BvhN>+K2c8vMH(r)dYsb1Bp6eONBM6kdiN
zH&5FiqY^uk$D81moqN6Qh+G$P>)ttS{cV}>%}H|BYR=y09YJmsxsOXfuTPW<9q;C)
z0sI<&m$zTieiQJ_RBtZ+M9Gh(@U2{jPfWBEJM$@WRmkl{?h%oDXOf)bx7aH?$lCnK
zY0tm^Y}Fq<b@01H&r9D;?2iV!KSXW>xmRLxPwH|3@>$_gj=l$UxoqSfkI8M)<s^@%
zz1z{ZUYDyw?uMA$x!!Wp9##LOACdbp*KXWAZdFuxBfKVU+Byg2a`z0>PIxz5`xeyz
zybqpd>bE}!ZtXuzz=z>tE3V&}KO_8<GRwP0aEaSEmo<(tHgb@8^gYvw&o7OA;bQnc
zxK_t%_*a%rt7q1l;AQYHm_7vUb3@{HC;VG*dCnX6F}OG0hJ)}G@16Gi8=VqMS>)b&
z_*ThXk3N_XbD=G6?kYy^we;zQD`d=VO_ICNo%?E$JK_D)_B#ppC&~qPxiQ>^+>^+C
zT<qSKC>J{3wcC%}&oZX%v#hmAa?an*j!=*8e{nAA1JjA$8j`*mux(0PjUZEh%(S|1
zHV41ehiAOWdJL|u?epQHU*l!)4e(R(CEi!g8H5Nw)xqz8-w-mm%yCujbBH!%Mn5>M
zt{HpbZ@{%NF$#YZehwz$J~+>lBp&i4CmuI#os$cHuq`1Tg3kL?5#-8|+kl+ZCH#Ni
zapjCN6-EE1y^!%*H;AovbhN=`eII_x&>{WyO}pPBFv;VoADXuR_VRW^&iMO4-Po!?
z=6{io*ULF{FSb(2y{VCD`y1Ko3>{+2`9^jGxq0+#MD9l7GOkDZz&MW;nd6yQz4v-n
zY}H|F*YU)G#P*>F+_n)t_9v(9{ZI6?oiLqvZawJUulJ!R_~B{$ozdr$^ceS?UFexZ
zPWDRTJ_onPbHEV1Hf!4RtdER~8F&ZWD=vkn{U7UQ_@xQ@?G1b3x$rsoNhUYGzf=Mb
zoH(uSpVYvQfS+ZSw@xbA``yj(kHWR{?vlqV;MO^^?)%;Lmiv^DolC6okDlUX(}~|j
z2tI1Hlk{6Ix$+P29O<{43_a3s$GLhUZ?R9hQGebPh3|uV?LCMe74X;K+Wk<&BD{SO
z-skXJ&GvL&h7kK>@FM;$yXIfuZTjn^Y0q~hq<jRPPkAr@WlyM%JUT}^zQA?(+*Y?g
zV*9c^ZceU7*EVcvd-zT8JK*m}S3I`QcguIeZ-u|d<i=UMLHGtAJ_)}9{%*6pb7ov(
zqL6&K1}^XOgd6X3>tgRQS|5ZExoYIzLT>P#$X#v7Neuq<otDE9<jUuHM)-;8g$AzU
zduNh^oV`BL)g!u)IpGL&O`t1wPb6`eaYQ^`$B>&necJxs(<8LAA?Jj3K=h@M)9MSR
z?eAIKoh0{jw=L)J?YJ|h?K5RDUB)^567=N5pG9Z*;v_xJnKH3ghuko7Pl(*vNpjz}
z?TK7Fa_i5Ww!d+glO#85%SDiD{ttFPZLcX3>bTq0HHoevWS*Dx$$yMCllJd**C*-Z
zx(%zGHS7{>#`ayL51ci&#CZ4+V;s5lT*qaC_6yR&v*5>^t;cO4{3y6JMq+L0Jgb$u
zx8a9y>s`b<jCheg{-Ck`L2hZ`wEedju1}N;9&-Dx8+&gecTIx7S6Tw%?=ZaM#sliN
zhi2hR>hzqDz5qW*Uw7oe)8Sq@Me5r`?#+T<d>C!pw=E%7L!Xy7AM9LTkDj%wr)@uD
z?dBYK5k14`>4D3hShyuoPw<CsJj^4v`g79@he<BKIZ4iWcTDtUkqfhnrx!{^?m9zG
z;^s4MKNKTZdY-*52w!E$Nq;%#Iz?YCavkSS+kXpcZK7Oor`unZfl%P&&wJl{N`GyE
zUkSgAYd8MZ#@nd_{wUnqyNtDyjjgpsKYRz=`hH7{U+&r;hwoIl)T4mBxC?$S*WvbW
zC-hfrZ6<!^ydxAibo~MKn^(o~x6rc++4$JCmpGQ6)$q&`y&g^Q_ug>8v%KujkK^YY
z`k$A$I?V91#MqzjcH?UleM``%&5iT$D!5l1%iLB<j$Csg<3QqNti{bAv1gOVy6c3Z
zU?@<!c3OR=Qw6Vud)bmc=)=|)xV0a!)v%S6tGdwh269@i8iMCs<h_29KAeHChih|i
z8Ygzv!at8}ybqmwQ1P>h{CqpSLE7Zad)+pXF?5aF9%blxrObOBDtfxmbJWGt3x$%y
zpE2~v7+dM?>$Ib1`K8`^q&|J{OW@CO?T#IL<5l<=JWxKJ_&q%5JyzkofD>2)_quNp
z9)VZEKP9rU`NO$45*~$bhF@=T=R0sx&sK8n2>gC&ueq&mdr3XN<>s6|<W{enUicSf
z!sCf@!N0k=ZUVWC%g7bdZbON3p$qJGi=bl!ze+AoiUWzI&$zlIk8eh1kJ#Lis4HlF
zQNZ4VE0=t~etO{@QirA_xqsUF#Afkfp+M1f2NKurNj7()Ya=psV)F}0y6j^$R<3A8
z*9*vL<7Eat`{7qfI~;51kvP2Ajh`{}WHQFR)~{CoFY)IQA1?h{M{a$KHvF=z-#YJc
z`&ax}>#pD0kvpxLI3XOv=Op=CY2WjUz5(PKubEz`mK=AHAt&*&&dqH-_%&ENo%jtX
zWF$02Pa3)H4Y;*WeRYx^W1l)7xr5hFFZ@~hV_l+L@V9o~N;_pA9tw2c;62Ag;6?D=
z@aMUXj}z(ppStnZfvt;foVL#kyd%k$abBPWT?4iHGp26%AYALyVTa4wHSSArkL8He
zWfoq;Jf_7~F*$MzevTs>{vV@Hr9S)IHYrF61)_EAlO@=(7k*-=9KHpv+3Chk3*5^2
z?@O{{tWP`8^A>VmIa~UA9z9d=H^txIH@h)t-?zLb9*aMd=;{61bmBL_f?tZaOX@pA
zfg?8R>%JU#2K;O2a@*BThN8b1z5#w!0=E|;!mHuEa2fk<dHcnD;Z5-Lo2C=L^G%zJ
zgw%7KT)qOn=iSuvFr%LKxthn`?Z~B)`}*%dkBqf<80{)!GRGZjdC2X*b9&*8cOkdL
zkhAr@{4Vr~Us*?l0&Vx(_g=2wk6G;|e$}HV=K<Echofh!p-1c$9d5~4^+!)OIm_$p
zsa1dYGPoAkos00nMfjw{wf8qt-xUh%ZP)uR2cGiKbmDm<`bV|_#s6Y>7QB^fx1H{G
z>kn^(YkQ_m@Qw{W^<RV!F2X0_E3p5?1pnN3*iuu;3-G@r@cnWBbKrS9bY2Xf^WoL-
z-iP(_P4I>eop-_uAJO?BJmpcHPr?V`uO`&*_wo9r9vKSU^_X5h2fk*f&Wqtke^2Mt
z@cll#3BLVty?iHp{rA1|pv2!GyuU_Y?@z*)U90E)Lh|F$=(qMV^6ql;sN{WnxLbKN
zk3Xu|f!wFfc69c1#E(*VKU~ZEo!A+MTY3MLI}_~~dA|)kr*%4WZfx!OMXS54y`EY0
zMBx|7x@?D`$IAQm9j*8?j-Hwyc<;$d{wg5vZiF|=n&WGR9y<?SFRKobt3+=9?rHmP
zWAqquwms{whKiiz@nzjS2b28UZOGaB+9d;vTsLyNe=@z0Eo-<J{!8wCvWgS`JKl}l
zQ{Me9dgjsdC_E_h!p{HFGkug}Px5%f!1Th8#INg&{<ZyoDCSo&az_lZ2QKaLpdn}b
zUlePPTIA0B&Gf?4BKMd7lG_!NYeQ~ipCk8?yWRe_^~L4-k-K(udSMrJ3SVQ$F^>cv
zq!Rot?a`gaIKA3CPfB~FlIQM(-zj?X4LuUa&O1pF*gSd;A~(QwJYS29y;QPnMcxw%
zY`f+_;`zQ{q2-MD5{37}-)HJDz8_El-vigqJvG1w;My70cKGk%7n=H=4-|;~KKN0L
zd9C~yJmSLxOPLdVcm!Su*X|Fa@JoDn1-!;be*=884{wLJ`0zgXqdt5L-UI(!Li??X
z_g~<>p};s?TN6a!uPXW@=#0W=;qqKBA%>i1deTRg$W)PcB{t(S_M?3(#<sw#;hK*f
z@K*ROW_f25UG(?E=inbT`FeM}jKjmqx*|fE0`jBq^<0M|P44(~_JBpE0-06F6p2j0
zkTKrzD^6!051D*q;`Owbw^lu?;hW%EEH%Mf;G{9Pyz_h_!cU#>EpYi3U0groHT0;v
z?=pl;I`>8wArhAf+7D5rt!CiG@UjH{`FK2}y$>7ksL8P*$B(6aF1!P-^<@csCtS-1
zHSq25Q%wEFcLJK>KZZA&+`f;oo)U@=-N?M3`#0GWjMwoBx4(zsS#T}q%)(bFT<TR!
zUi>uN%AXl`xba}*Pw}JRXxc*2BfK2G8}1di*>K6@OJ#3D=I_35x^`mwi}oi80uf}#
zkX^!_z7>C+hO7~PgV<Y+jMx2x=*S`$3b*3C+R$M<>qvV)V-*>%u_SF%g^pVIgItGm
z3?0%o_EO)9^)mFlft(fxb?`CxY3PafAvz=!r0rVaZ^6H9@?cXuPJ7_j@C+krawASh
z;LUK&{v7;vxE9A58KJ-(KIQY_4REhG7XQoO+u+(btb@M@_Zo*0$`6sZmwe6X@1bwF
zv0?OgFFKYZ<JDK<!zg?uT#JW1@}h7n9%>95Mm$75Kz}1sg}!({1uu*DLloW%*K%G3
zd>CG6mZzU&xhy_5z~|r>m^^4d)D_+iU(WOMgl|d&&yL&ggRg~qjr9oS$KaLlZKi&S
zRp%UtjKczQqCCU5#$omCZd)gfL-8l~81^N39)6yw&sYzY!2j*@yuAj#g!3eqCzQ7j
z;EMiccoE#IKEk`;YvEq^77_Rm{7djAuH*e>=TGb8kLZ|1=2waiEB}!nN8!IlHeCC4
zw>_lYp0=9a8si1Wh61<Utk2u!@Lh0ijMT&X;pdpXI_Hzb&o=n$aP6!~FMI}mrdeKI
z(&GQpuj%B&qc$C|&Qyo@Y;o%mJDbqz)+Hq~6lg-W$kb(wwQP7d+^gNC%^I-vEWDlT
z@TG<=X*2tHj@4#0=qb3xdrXR+0rZ>>xAa7GJw4(Na;H-!-p|;QquSDTBk&=(7N>LY
z|G>TKBjqzb7z(5|=<C9K_z`gHnPlwV)IKI;=YRMTpYnC^F#H&7#r?m)?hk2)A@cJf
z{2SyteBy0x-${GgM;<LZedyWYV`mKB4%g;^z;WbhA3r3IH^VJIzQ5Vi53B!?%e&R-
zw|kQ0%>Kt-Cvpk-k~+zw4{7&ict2bn|L~XKQDo!ocB31|L-2#}<tDecV6FC=fzQLQ
zGr93TbJ~Y^ZnW7uKE=OWA1>|CNWPWwKju2T?bgKhdc^iK0_#F<6ge4h;hPLOW6ZT-
zD{z~BZ`TWd4_u4kQFsJig^hSy8FSY>yvnD1W+W7-gMZj8Z*T8gZCL=Xhimg|xx;^G
zmY4W_$nCENWKy>1b!>+p1OK3@!``yA;~$;@_gZ60e~rQGe0bn^_9oy7-()h*G)Lem
zU)R?$QFs*YwT=<{74SN^roREc(?@?he9T9GA3THic)Zp?5$tD>=d$3kz6ihn7B?P^
zHAeV^P~ZY&qR7PKgno+M^JKv{z$L!p+_--&gx>(ya!e(>8m_g$7I+(6TjO-V2jE&x
z=!frv|HAYy*lPuu^uaj%Cf+@Zn%t;g_`}$TYxT>5x5Ksi6~ec{y>hwOuY@<lwLO|G
z@E!28O#iIAJ$t{a1KtnU#&JJ9m3I`i`i;YL;9C8{S)o8KT&rIed>K3;XB+qRh43?d
zcqM!-T&+L63hw1!Hf=IW&aQ@kpX=~N^==Hu)-m_H`D6%PlgN7Yh3L;F=e-7hR&;&9
z&?R~430F_XiJ`!)yt8{ga`BiCo?{6__$eRW1>bIR(b4ScC`V>F?@E8glyUyxki<nj
zycX^i*AaLdd^22IyNixKWM+}c;X3Z8vlk%s%^?2;zIDKQ$2ENFO>W!Cv$^lO`z9&N
zc<$bGK>fB-Hhe2w+b1i6H^Z$nSh4kxu~#p7d>cGf?)87QF~N`6_syj~&FI;9rygrv
z;s-p6Y`nha{14v^SLc6tuTS~3lbDx%%ICsggI{ghcb*|jdpDAg^Y~WC%Up;5^EJ1g
z5*yFku_1C@$c-a6Aabu8a<bR`6E}w1vA5-JJ$LrOCx0<*=g!#KH)H-9gJ(SFeKu3t
zJCJR2ud{U#a0H%Cc^P~0^H5S3V-7DwrVSY@e|z{)2_Nv`Ti~-kyaPT&TWRx0KRobD
z-TpXy%%^<#Bjit?@>%eFA6^Kr^x>88W*@!<-s{6V;59z}_ru$L_&8kJPg}=@m$OF!
z_gcqEjAS|7D^E!**OPN!rThZd;g8>#81o0*SguCT9%9*R9uPhK=oy4tW8&=_Ts=u+
zq8mNc&EEb-(346|6mIS7{KC*<>}Tg9^Efg^;`1YhjIsXC{3v@=K6Yx+A>6X_B}0c{
zrxlshdmKCG7&49>ncsSm$wkK6e>u^RN!ovrx=kRPwbjmV;rAG_&OMIE4CD85WD@2b
z8MDTkZ4Q|lWW3gm(&rgDtnJ}mF(Ec;$fLroy5D)d+gC>2Taej<jMc_pHDru7Zotkf
z$VmUk^SR@v*cm~`t1%rP`)?g0Gmp%YdmTGR{<n<OX97FRk-3cPxSgPVh*)^a$3lUt
ze0Vneakx7F!FR%sH}%`wTGo9^l~dj;_Qif9yqEGC-wA&auI)Drz+ZrS^;ZV^C*aS+
z6TT};Oo;99$>d*{*ZNM%X2DZi{=2NOC~Tz%i@;jQyA?32|G##f8zW}_Q+^9FUVe*?
z5p)Q@fa~z53?0V(OFuexBcsLgID9W$+eZt3JQVl^Tzf8+1^)y5-S`lX9pkxFA^Zh+
zGi#eTr)@)<-St%!GAp;~_c)F4^>A&D+X>$akD5MUBX*BA0N)Mw8b?<A!=Hp}Yy6a4
z_GRFwnEH+9QWfOfXW&*}K5?yQUlya|HDt6s|7!Sg_v!b_P4KmFt&W}W8{k?U2jLsx
zS{*0hHE=CXQa?dXgKM!^NzN2*<-8|q+%_<BUL!JlkdgIg_}hkzk)La^(}#>-er`o(
zNvoc3df;KW7Ski}cfqxoo`W9`*J3(jMJSL4_j}e_fK2=SdViP0N8n{<Oa<L%t@UE#
z0lmN5;JI+EzkA_%aIL>b;meis5qz45pA7Fe{j;AHbjzwm?3PL1MP@D6;peY*``nhZ
zvVe@QqEE7~h@98>5ncsf`key{S8^TC5kdO~Nq8f?4DL0*MBroiu@-KPzjF*foLnk0
zlE*h9W5wQyhKvz=GuUZB#xM5L^Fo2=kkRUr2Oou3VbiV4W!6GZ>QV~NYSa6z7M>0F
zs;iW5fiHt=d88Y@4z9K3FuVh<#oa7?6z(<7#eVuJI*-7s$)!^MWUj+cSGzIsC3~$a
zGG*v^4H>PSCAPZJlk=bxTQ?hejM&OXZWOsokh9i@7aMXO>qE)o=Wmb2i6LvuxwH7T
z0U59LyjA~|#0dNrY`gtyAMlItQ#CfmVmAKzKW_bvSS&+F_`7!9;yPpvYP_#nkIYJB
zy!t`x3}Z*Qm2Yn~>^S*WeC<O=Ei&5P;TXIfuFb1~Q@J;SN6}^a8Jkxl@EN$4XQS{r
zxR!$|;Q#Qk-vB?Z-FxjN^=pT(gx_fTXM78w4}KS18%tyGCLbQi=Q%&zYu`rfN8rtH
zul*(AQFt3%TlZGLx5E>j(@En}R?0WP_rSFn7$HXsKLgqDtzU6tt=84ikB(tvK7vfV
z4=Y?g4u1u%wNdy}jAyvk23hb|;aVLE;fLT_9oopb!mT<yUFBJaMs#F6r0-kpgrDHU
z2jDsI)66!w*3Cx~@N?k_-|Uw0=&WO<FH%oqeTB@arVeDjf*RpD@VnqzUl+rh;aWRa
zJLR=@Zi2T^UW>I(c)O4NLHG`MuIc}m-8h(p?}lsN$Vok&c@M7np9Amr;l=Q0;F|x{
z@E74)`!&IbeDrrZ<u(5X;e(X-+WVINn}kdKyyDdA{{ow9d#5>YKmUs1Qa|k;wi-U>
zQ@<woD{w8Bcfya@Vb8nqaqi5y;{PB#1FqShgfI8usb_FD!H4I-D>&C3GVk-8KbR@@
zi{WQKF}?5slZWh&mqg&zqW{V1#BUqR7%X<jX)`h#kSRw#UPqBJz5~&X%;U*=jBg|l
z!^hzlnmUX#!?W<)eflZ=%uwJyxb{u&Jow{2<xAncKD-t#apH9!7QyF1^7VeWb<h9p
zE8KkPEFMIr2OTN&)#Y3#w3G2o$Wdg@Mdp*HjPs6Vgx}`j7sJI)f)4w5l{G&_K22L8
zqpcsJ@F(G3b&;5;fIkEG8gmhN4|!R*wZ{3udZVuH_ZK?Q5qMaS>wfrBxR(uCXJ(T3
zgtu@VKF_crado?!A5){8&qYoh|L{h|jurn7_sUP=M>YI*%Fl2eZ|~SMyjNU5T97-x
zLto!_!&~6_rXJ&Y<S@JwF6;BS9V1W7!au+`ewXmr^9o}gOh1dYE8My_j`7v5e|hkY
z==W;x2r4Cy3%BO`KUcVY>a1BrrVAOVgLOamv>{`x)7!AqgN!y`_QLnVz2+0KF$(X4
zC&agXZ*i8?M*1wUigzcGxkavH&+VME<q>`=BWIrfh~wu6z5Ogi#|C7)+Cywq`f#z)
ziw!An-M9YiGPk{q`_`T4s6$4(pAtKR$m~TXAufpV*x8~<_&&I{hnjjeXN%xo@hkds
z;6v~NuH$WWof{X$@JV>WIuZMFCQa_+I>@_+KYC!{H(ZB*zs{{^Yz+L|)zylwPGq&Q
z*aLqOuK79w@Alzy@ZE43m+`t7&j&IJZT(dyH_i^_!w*qjo2$#<%OBJ8W*z(zxHd*x
z;Z^XcX`i-?-Iw*i8{wM&Bk(4;c3(CJ-wfB<FXJ5Uf#F(T=fm54%9p_(fNS?8b?}Gb
zOU?Ry*64ruHn_Hj(F1?cr~C-K53bd34!#$ztrauQCHKI!F`e&lZQd(`_bcTi)VYfs
zEZmy+{&1-~7L2`A$>YJDPVV`sA!FpoKI|+*M)P9~z5?!55Ah?P94XxL<5I(h;YT?#
zH8DR<H)ISyiatX=_wl0&-tOZ^A2x(rYo0$`Vzh_7VIsbcBlBX+kDnSch95)NIf#rl
zu4dqY@9A-oR>ZibyjR@HSgRt3rcnOtT!&9Le6Z&g>-4eY$};p^iJZ2FSO>3%Yx$)W
z-VeVLUGe;6?3ebyk9ges?6cS(foH?L>LGj%z5=e<&-g5JINWPql=AuT{ctt^!IymB
zC;!1$!VAz9ub(lOw8GcGz4quL6zPFiz!T2A$$HK?J0dcp$OJq6&nN{}(+|jKc`^du
z0N3(J6kY>Qm~)M_SOvV%hd036;o3cOJG>Kq0`-Zvlf5*y)-QeVUGRi`4d;8>(obXX
zSK(S51U|={4gZ9xzsk+S5%?jvHqS)i!5`@5E8yuqyaB!p?iGg-e3CqVHQZVoy}Z`V
z3(nd|>e!EtT4c2S@^N@4T$@Y6#oRB#qv(pau`$<X!Na@sHYkLrz_l2vgdakG!n(-V
z1Ka{XhVojD9wmnhx7O1yU+A`hu?IMSjyz<vd0+w_^|28pFABHjfg24Q#yn7o%qC=t
zXr}N*hK!MaOU`2t3Yp8ywlvNe)WBbbd-b>UWix#F5B0w6g0F{beK`bw03J2%8+|zg
z-vih7v(wJ!eiZK2ml1U4!h7I1C+QCwW4;ubrCoY%tc9Nm*Y2rX;8(+=Nj73@zi#+l
zaBWNu!?(h{>L6`A3vYyL<0bv`texOm8|T62;M)F3Dg1~Z={d6&p5nt>;7j1zeP1^`
z6|UvXVR#1I>%P#cKl~WD7K7;}#28!~OL_3CeRwH+Biw5|i~U-MYdN<C-sIz7H+&eb
z_1`c&b+_Jsv+zQ=7GLQXaGnpY#aAA@3a-UhDSRC~A>T0uWA7%_!Z-Tx7Wg)}mP5MX
z`+WE?{OBL+bJ8q48=kOt7IfdiOJ5TTd<E`xHbB}W4_*d8hNWbDzWCf-p*zD(huyX$
zv?RpzDg9iI-0CNFJ@xR@;MLxG%3^vtklXZ>uBRV<HN47OPiaigByziYz3=~}UWMew
z@4?%-4&U^7cb<`T)mC>+koN_i#r#a~-%|LQaBa<03on3c@zVnT1Y8^6-S9Jf_%M7m
zTpPc$@U?KS@fo4+#pFlf*1br>`EENHXRh)~IhTdZEy%}X!1yLX8GIbBt&i*AX?yiK
zpcNj4M@{|4Jk|rRfNNuP1YQaEYU2nxbIF01z^%Ew{XDmh#$29xA#sO{R>uPPD{w83
zmBVKgE`CcM@BA*`li@lX!H3vhqr{uDPc7r913h!dS@-HO8T(H=1tRcy^c;lCd=Z`~
zcJ&zhXA|g{MdnM$B-k<bd{Wo4*2iD3c_BivO7i9&xV0ADf}PlYp<$;49ev1rMeM}5
z)W@(>i_DUr>-UB&@JzV2M(KuU!L@tCVfa<>Gff|y_hPO258epZVki9~<{!8=e)HgW
zz_qw2g})B>`d*zi|G`HU{Ska_f$xWxoBrGP*VdCF(b0p<(mwAwUUa09>)s3B&vkfo
zwcA(0-&l!EWaiQFJTiB19q%jK&PEXuJCQQZU_GtJcoe=0uH}+e{1AQyy290lAI92!
z3p&b?(eBYY;8()6{^*BS!nO6%IQ%NOwjK&!%z1Gi{aJ7+ujS)H_zgb#E8%r;El+HL
z-vM7`_QTig`6j||9q>+g!ac5xDdU;N05YS<XwU8^;IlqHq+G(7d`9;%8=j$X@v#WL
z9R7E%lVa%)u~@1`<^VEYd!C}B2|f;&vvzSEQcvT|P!}>sKby4QfJ|(Ue+YguT#J<%
zc#aQGyOess*O)#8?TuL(54rGixXg`lAC2ddCGfl8+P;kFs6{5XUyt_|_^04r?Ih*9
z;W=>a*}yP-C0uKRS$G~?n;VPCj~{_cyoY<wb#uoRc1(&7`Q@xpkcn~~ZwLAzc8^vD
zUjz5bvDp;q!p2&-b*8P{u#t48O>A|b>$AVm`=lRU57*W^<M2kfmZJ*DgTk%#&cr!x
zeT{ytK;}tgto6cxA!Do;ioZzSMn*exTMeIqd#$S@)Uydb2G`D!i%b_X#lO_gtV(+g
zBQuGNw)UEZXAJ0Tuk>}Hz{gshzpE2lZ(Qm2eI7iU@>+YB!t>zT{9Ow_9j>)g3;Y7O
z)=u5<D7@nxRMuEygtooIa#Gr01ew0)_4u5FkHNj-Q_5#tMlOPDV<aEGAN~-srVqh;
z-F7NRrtF2J`vha(s~%np*Wz-RoGsj%JIl^?<I<Qr`_OS0GB=uj80Q1W;IF~8xhGJ;
z+7hnKjS=`;KINnE)c-xOusOlLJ$XqxR=}@@YxW!94REhDr<8Ap55O-=&~LxDBY9+w
ze17<#^Gr2=mD@%h&r~PT)rqWjU!Hn7w&0g1*mCcSbKpn($~z{+*J5}8u8oUocq&}$
z?|$;Ka4QdOJj<<%ao^R2j?<92CBaAgY_9k)1aE6`{+>;2>>AG%X5bqs|6#Md@lA)c
z^*qO-yw%>Z@<Cfb^yk9YQC{oM5_k<<+Z(HaZ-y6`_6`4<;oIR}eI)%oK`ws^{u{2t
zmqgt*^62kT@%2T0o}7nQ!L@lZ^9t6T3XfpF0A30A%hwgi4E@^w8O#=BRu3hu8I122
zbiile+Wk&HeC2QSdW^&Ke0aE$XJI}(3!V$t_S*{KRd8*;v=aW^t$ZV%HjCeT2JH_N
zN=$8mH&8w*+{ov#wL}NJ9j@i-es~AmD_4vDargspEyskv#GX7{t6vuUn3weW6~dQM
zKkM9SY|I#cd$AI}g7W!h{fzzcE%4QFue>029wmnhmoXo%J;RN8SsOcNe5Ia)=-Gjs
zmVYMUyA(SS$`_I!g<JV2)39T#gQ}1jMW#r6nJ;jCan?bir}Rql;BWPqmvP*Mo{h*@
z>%SgDkJtJSeOC|LHskSOth@T*`<kb%?{&p_@VWR}U>tq}<+XMRf0>*F_iBHsPdPbL
zxYaIMhOb6mE<#5aGG6zvQr~uT>=7HRS;FI|yY1#t-xhT3`kfxH-S9Wz5)W>D-8o<w
zzILDYoGEcK3*QFU)@SK#q;7|MjW_wNn!LFK{u8dlxkg>=y#wn@(PF0@Ju6;LihJW;
ztscHw;bLbPJL}=?VrSoJZktKm8~d^S=-H2)*PLOEfB2hlt-Zoup}j`DpS6o0<>b#R
z;8uMvHT+1bZ!vlfB9}1Eo%)I%$>T@--qCZsuBQb(_ampxOWpAM;M)GuF#Ha<Hb>9G
z+kANXRm2}$o5S<qeefuCipL-IjOFW6_!wO39Ovf#AAB6H<?9ys@8R0>!EX3F_a9LI
zPV6we0G?;sH}df;yu_z``v0)E?NdGv-U^p|5U-z+3rgY7!!JzW_91VH$6ELyg-e@B
z9{=PY`1VYYxIaAKjeGfK%Ng=jaNfyAZWg(V|42KD+@Vtw<vwl8S@Dm(&41G4A<P4q
z7Pz*)$b#>OpJ~>|*iS8l&%w2PQYjC3#&o^~o&wkQGdkc);a>S!>es&rANS$Xjs@gH
z(SM_~<L_1`w&Rs<JLY_qeDtdBNAV)O+J{G^9{3^pt+}<<@WYtvy3ldEj}JpWT<V%l
zE|l`}cb>!Ph7CKHy)MBezLX$W_7~^gGhoOW_nrk;^Sl5VZQWE3{~kPwzW6vX@<cuS
z1-O<6+TeX~@jG7L$RoY*ejoj#@Nu}dE}e&Gj_W-08vdpkJZjoE{4apl!ar;BU^Kq&
zD2H!{Yxi39@Eve1uG<{0mG6Z=s+5;DODE3>e}U_8G|!D|yRY|%qcVQNHGFgRuX;OV
z!5iROKNZ4HY@A*=O4=c|{&mi>M);``o({M6RAZcWbW*0}LnAV)kU7@WVc+Ik@i<0Z
z&V;Xnhj0I+`;5ytpA#m})ge<TGFKWh#`u}R&hxa1_V>)vuC;Y|`5|pug^gNl{7`Hx
zF>FYE9<jRK%FWHlJ%Al6r~G||+xC*fotzRuM-OsuyyiSpd&7`3o~d=<(+o0x&(sEx
zS@}18%`gGagKKMolnuNq15a4H822dI@O5yn^{vEE5xmNWSHU;HwK<{@z7ejCrJe8&
zxOT2}0KOZp_3H$D5U#~=%5|K3^5NO=9(WaXjpricJbV#6Frn+Og1<?5ZBMolegfrd
z67<_IFG~CFgl~XrYoY=84tUfoZ{(^8_%m=Vm!{P6?jKxhpKN$9Tw5a)!Go{s?Oz4Y
zglqR;jqq%^S1ycDr!jK1aO)oIxsSW!$+$NSlMmM-W6htB8Zzei$IeD%PBGib`Ob;7
zbK3R1!wT2tv|RWAT$@u$;DI;veyD**;95U4!?WO8KXk#5fopTZ5d1i}S38Q$Z1SIQ
zYfiZRWVaoY=7fwJ*rVU#{LP$L&Nkkm%7?e3$J+CV?b#Ub+Lpn)6hEY$>lWdyi}0RB
z_{buBZV{ewqrd<8i}12Vc-<nrbrIgP2p?I5&n?0;>K3X0BD`!7UgyIlPKU_X5<l-{
zIE80E>c*+epFug%#n}Yp=8$Xqhco7<4LN7bi%cfDuP-L^Yj2q-GUG9sA9~AFB9k)Z
z*t*+WM)G)0Oy(MInNDO%VltoqZy6aMtzToEfsA&K-vh7m;Un;J_;=9d&R6!PiRhn$
zkHED&lChC}KDd@gYRIF)@00zkyO+ED!<-ZPru!VO0zJhux}64i30$)?f*s*c;dA)(
zL_0y}@2g9F2GH{=a@zbf0na|*y*`q7i;_2&!N<hTUq6yipWsXGx~>YjS7LI*x}4<k
zZ3i8F&+2kL$esUBM{c*boYZgUO`Ok|)z@bO@Z)^=1bn3rPpQWbAD#`r60XgQMeyx#
zZC<Q`?}JCFOFSNp^+_ZAO}I8M?u5Su*XG3m_zYazGn;@<!L{{g%FVWYZBHi~p8YRx
z{o->2`E(h)nd|U7vJ>NHvmHOuk2UDI3puZKr05wy&p!B==z0F6L_JO%ik=?P^QImT
zBk)JzT7S*KUx91=m9dF)HviW9D<8fRuJu<L{4}`MUv=<YxaMCgyb7-Q*8^{dM`;VM
zcp8EC!L|OLgAc&H{F6GBkRSKL$G8rcEmQj;dJE4M=Jflj3V5RrZ-77G!`tDVa4k>w
z!MosE{**i}+*<EFcA{I4r1f4(1Lt-APhX#B!`H#R>_liI$>YMU_4x&c9b<joflL!J
z*82PthK#X3Z^lj+GN+(3-mk{`ybJyuT#Jh#_#t@0vjEwcMxBhC8Tc`8dDlaD+O0O%
z?$dJN=Tcs~4=aJ+0FR<8?!S@eYT(=8+PG<kKLFR_Qu25++}c+-@L{(<jeP~tokqSJ
zn|I=O#*o98*nB4S4QysF`#<_RBLZ)NYxmtz_yaz?0=^Tj?K?EU_xSL3_#j-{cj$xf
zgXc?KV)r4&zQq`P%7+JTV_rR^>yN<G;M(4I6n-*X%QF@5m2hoeqXAw4*T#1{yb|s;
z?xde3j|;cP_lHh!;~{B$PoQVXg7-5)(Gw*fo(pf_I{f<at{#aOWBlZ9VV*}$jeq!y
z@C(rs?+@eKGd1vV;GjBBH^YPQGtBbNp0oHlfu9lhtnAf)A<@s!YwlkC2zn-i2R++O
z;(pHI+B2?<uaie8?{x-E%ICwU;M#su89XI)P(8z02Y-w5+PG?U$}cn9!TFxP*zbWK
zg?=sWN8rnR_#FI9_^GCT`9s$HU-W0(9tvCtzu4r#5=+3UKm0DZSDuu9l03c#{xH|!
z-+m}Dp1$qcX+Y1)@Im$bSvx!*zSQ)?_)bC}e7V9Slo^9(!nd2{C8mwP(-8g!IT;yk
zEs_O)5$-kTh>b${lEV)Ap4YEJ=1gR?dNjgw;a+hs?Y$FzK3p4j1Mp37?M&qayanzR
z&(`=SPi}!{h3K!dk4xyU(9!n&w)m0T$g_YH-H#G@7u>6!VrM6IcEII6EgVX;<Gg}q
z#a}CW#uPo`M-TiZxVBChf&UGzjjuWQoABl6isvb3&t3Fqe3OQFr+0e^&xg-YULF7N
zBPj2cx21fY!?pa=3eTjx=3ftd8T=@8#r;3W9#;{58iA+7yAwEZ|EN3m=8@?@=4eyq
zJeOzQ!Q8IckUA8=8{t~amBY8gwV3NB2j2yMRAMfanHY1e?jFx5a;ZliT(};a;rAMH
zL3?2+z6@Y%9Wq{VCwu~4qVNbj<y$;|g8Su(9AtWtIUf0Vn;YMFFNW_`Y={rl@GiI(
zlTA)}EoM3$uEoqCd<gws?Jf2v;eBu|W>cGZ&JWk}U=DogQQmn_^cTZd!=qfs+s9b@
zR>QA?d#!Dyd=tC^uC;F`d_7$2<3V^S+{^z6`X}Mvf+ws^WG?uO8}n&*(#OcuARn(o
z(B9Y<9l7w-cOP8%lgUMg{aTfkyGoJyB{EvBu7%IRz3L%3a*$m82HeV#Cw(AcT$nks
z7d_c&dJY_gp8?n6Z600>Uu)JSXeR*akIcI`Hv*5E-005&_zt-E9B(V*`FuJ2QMgxs
zOPOwRa2s64T=;VtiS;z*=MMBNeUEp0iJ$%OFg(h2+z;b#0*%A7e9DLKX0HQ&saZa_
z#tI72p9Nn7*V?fVUIEv}ZRH|-3;Z%4|2p6oz@w&rM*aHX*ZPznhgZTkn&q8?quKl>
zd3-Ni_KL$pN4xzHJ5&8lcYNeFbHB4xU%!{Yb9{IWd^y}JCZw&K;SsoYzt{y|0YAm8
zi?Kg21TXT@KLbA#ew<m}d6!n~r`^NZF`x3eaIvrXR{}4DYq3zX2ycd;O?j`}ApUj1
zPk~2G|BYA}f?w!Ueg-b>qs4mKR@Q-VZ4SwW*ZS}hcqLq0x75I|hO7PWlt0a^A2~<5
zIKppT@J*EWTh|ODbJTnFHk^eA;9lcd@=`H*QOa9+=~wS{$Ajc~BQF))OIslqrA$2U
zIQdcZw4kRWre~|S9+8tgeoXp7`<&~INpf4=vDb;ct;i+Z^I<Rc?&Bc*arhagKgM~j
zN%$|}+IlUuB^3B0+^g@!&r0&>Al$k~_|wvab}{b}O3^d$e%+5+_+R0gA1&~=;hG<l
z`0)n(Bw07!lH|t++<TQ#^t^G5zMhzePx|o8Z*z|i*T!N2d<^b&4=iJ~9G-ft_gX@D
zJ-i&Qt#{hs>wI`GyaKNIHws?^*ZiA@Z-QTA#!JwC(NFx#+{S$`e1*xs;>KeEd<?Fw
zC(Ge)!8QNt;gfJJSG2+3glp~73!n4RKMH>X?zJA2`pv_S&pfF9ZT8Ij*b{?m&lC&b
zO+LIF{t{fRKfE6vHQU$8AL3sdeB7seFMJ=|YrM;NO()OI!mYisTi%^GUX8u7a4Yu(
zAJW??3qA+;YKI7R3gKr)^fj@_R3Y;gGW)nTb7gSAji)ALI*<2WH%ooSsm~~Ufa~zf
zN4fQ3?>qM0JCREz&()vc$UW^XC+nU(<T5|ZT>TF8eczBvdM86<E09gga%At*WyO9I
zvf&dC+J6u4HbYkCj{|Of>+ff;^K$)fGqySWSainERXS%P#m+2t4pmGqyv=p^<JgIv
z(=qIbTqb$$H`r+txnq;$jQJ(?0pflAw0&;g&=s3sa^RQ1t+h>z8}AMlJ6!X(13%VM
z-txEoNKbzy?px5a{0iMpx5G6%spPd~l(*~@>vrbR^OldD%<tG-vr~(mH)D3@Qq}rY
zqGy&k`!IEj$G*{STi|mNhbA}rS@O8>1$ejvJF({+Mn6lt4Weg#rQU9n4%g~aNIqOg
zd8^$@yz3+JRE=B}W5M#LK=-G-jXkh0>HgF^T=QobJ4+~U`7`k@wSD{1v){+gxWhF&
zlE?SO?6l~1avo%Tb){aPVux#XI<WI7<*oWebvrHS+4yDMPPfA~JE`Q+8z^ttnLI*m
zw|VreuF~yfZnwE+rxrWsQr@!Ds@thVPrhIL!wdZ4A3MUWcq_z?7XRo;CoZ*dHVMy=
z9IlMBLh`L}%g)R@J?&WWkK8nJ?dS=QCdnE3wEVk_6XpSJy<QJ*fNSf6HuwhkrKZ2e
zzC<s47hGFEjlz52Uh8Pd7xVC)aBcmT+0L0^xaMC0yc_OyA0_(Bo${K0_3%L-|JvZa
zKK}K>_xboY3Lo(CZ{8{IwNEGgTuQ!Nvdr0sdq+xQJQ(}Fg%5GhkDRtAQ3<~UuHEl!
zf!DybJ&6wZ)jqr*UJcj!X&k-|{&6#ojPH4bci8&9#)b4_mcv(=<&FD*LU;rEwK%JU
zOZ~Js+XBDC$Nvs^JzR^k{zb}<FH%1Iu)qB*xS#z(pYjq%ZRA-g{{q+HUmTVgN4@rX
zP~`fNJMJV$?jdhE>5p#g^&zLl%P@Q|Tx+jc_#j-1m-G(*@_BG6ul08+yce$ZcP)G$
zT#L6BhimcH4WFR=GTI_O7Z}gRhv8Fj?M%ij{7v|&W_jb;clsltz>(Sdv+q3kxp1%h
zYU#%&$=mRUxeos+l-S?Kv+sKJOd+S;-?qVL;95WR!e3Q*1lyzVVYuvL#oI~NjK&^T
zfQN7Ae?+$tfk)w5EJdC2S{*9jB|iEa;H%(TEVMgZi-kUTDdn|T9D^6awO9;1Ms9>_
zxj6!_g==Fi3g6(vE8sP7tq&XE>*1#-^-=6wvF-3pKKlFM^>A%0jKMd<6V@Qc`KZ87
zp7Hwd2z)nO8!J)x^YDvJ|BZ7Z74YD4eXR75n@@&YW97FT4Kmku##q^jp2v~X;%ork
z3D??r0>0gcr+kldbqbGAw`}-k_*%1`GM0>Q(-kArjf}RQ=pgTo!%q#77Y<LXYv?2H
zzGVw~W<RFKY&ZPKll8g|!vpZMlYG6NsYd3HS@?&Q@)3CY<2(<8`{j*%WSWujs;k&2
zgZII|!gah)gZ3X~6kZ2E;^X>rfL3?_?v)oJl%FAo3%Aaj{^d}}wPAON*ce5}$;fCi
zF%OTxwcM8ZeY?Dt8w%isl-F`YIee85uZKr{{A+`+fNSfvUieu`d1<3jcpluZ9|N7-
zLm(4HKHi4J^#&(aBJdaCS{<YCLAW+9E1dG$dw&h^{XY8J;Uhl0555ns_3;>d0Is!R
z;0LyTZGMQr5BTVh!pGs-SgU{^o~w_O26#T)%YRu*jF7*V!)5O^yzsUg=aPGjdyoP2
zR4IC7EKI;Jfou0DDZ4^}Yv9^g$cEnx_u6X~{YCHx;M!QJf_K5a=4q*CANjc*eiFkv
z{NcoUhKy%AUFd25q<4FXA4Bl1aIGFQi<D3Mp<Q0PXU&DTp}!hi@$nM8!dk?O{Sx>D
z+^e3#Yv3brE#8{p2jSXy>VnV0wRlM(r@aP$7+c}cTZ!>v%%^kcS)X@s;a%@A>JbWB
zFK$KnDWi*Z;VB0bzk@0<S7_g_NL>n$sYgbe1Ipo@KD-`23O@l|@wPPnwo4oQ6}Z<N
zAohD5uC?_j{6)%Zd>+0RuFX-IKjIAUO7HV=5$qSh4^e&}*Kz-)jf`g+707g<Lu;c3
z_!wNPW4pt(I`qMZD6iFF41Ub1-gS^R4D9B)2HY#2BH#!-2v699k~%u)1VyG0nbVN@
z8rKQ!V0?3@3YohVJJ$FoPj7}_L_CHs`*%XzhCb`QPuPW?-T8XV48gnMT6@pH$Kgkt
zz8Ys9(|*i+<WoKue#EDA`z7#HxHezbIOR3_&F}!_rA^{(X`HF*f`{Qzlbh#1;8{NQ
zXW%EmSD59Ey_~de)(mj3{3Jd}9zP%c6xZRG|CP{B=KGjs=ov%KE3QS4<ncej9}+ze
zCh0N0q1uj~veUfvNc{FWT&vF*{3^<8<0tS0^CH}<zM?+@ul2DXU4&OST$?W%;C<-V
z&J(r6U-IF7@Nu};_!a-h;QQdRPL9WubJJpt|0l_DryunE_PAAl_;Pq{LV0^&3y;D#
z!7oqX?l)5_;C*nfzhfrl8{of!YyP*xf9}Kk;6GA$1pQ<1hv7A*fA+gE*3F2-qU7-z
zWJ+c2@u7dZF>T3(3gymBe9id@&x=2OaN#;rm-B}jgcrkW;M&=yYWS7#51Qpm-TAZ$
zUg^U-;p-JH^$3&OD&W@Gyyc)<56RcYyVA4hIf&dBO+SLRBT|p_9^OTW>TBjacoeSH
zqZEE7+-vNM{@O)&%Obpc5k9;KpLO_o3H7%ZHdg(gVn5xdetGb#eCk)a2(NYc8K!;X
zoK_3G(Z_x_{B|Gv!;A1)himrJ_i%2_M}OWTymS#>y9jStgm*h!i@#y`4j=z#7vbqY
z^)H|2aIO7H;eFWGcrE-D_{Yuucb><{I36Ttzwx>0g>+d9^-pn=e^lD-!LyHC!Z;2c
z;jV>x(X+33df~UGp5O~sLP_JdQTR8{n_f6lIRE6g8GhSr{3h`p?qwa%Z(jaLnJoCX
z;74#R|KzuPe!JE9P4pD=+e+%C^-DFpj57ZtN@8_#&YMZS`z2Syw{RWa{|~p`XE%jz
z3kU0^Vq&KoJ(J`wEx!yqTw4>*I(~Ys!6N9FJf1^6ti7f6_z~NaH0I6xpRsO0Mw_?F
z;Kgw5KD5rKytKs-K1lhmN(}sE()B@N;4(J``p|RFS$eFE!FRz+(COC0e&IpdGO(9e
zgs(KYY(DdU;Su;O+-v<Le%6so$Klo)vrCiwG|re+p{J`*Z?8u94!G7{JDu{{KGFcZ
zm-5=Wdjh`4ho}6UXXQTrWy2qbdyNrkry}@MKIN<6o$!SFDC1dvBYXm``M(qX8eCiF
z4#4Mp>`%bofP1|IApWQHv6p#{KBlr4;YIMXDX)!(D)=cryb*qq!Xx;%6aE2s!rIGT
z$61>%Qinlgs*s6t9glV6-e?lu2-n&;^=al+AD#o>0@u!y7Q=htUhj#Df7S3=c!Gb7
z=h$9r6FmJ~@4cT0<vZc;gD0%zWo>u1J6?y7S%r+|!wh^QT<fQ_XIT5dy`F7K9dhBV
z@CvTuZ5+JFav;J_jpWu5cqP~2>n7a1<@^CKk*P&T#%IWFT*q}tJuY+W(TdD^WVHLT
z9{5dgtsW!rtKnK-&%vvG^k+OvEWounCg0)Ocr1grQr;_XN;}rU8-47z!gs*6`t`tD
z;99;Mams7{&pBN4Kck<06d(Wd;r~zA{Rh-t)sG*)vO6WEiH3_N*-gn%$!OBViFTc&
zs5nV+qN0-0q(ze^>eXnH(j>!4izZH7v`9%&aiOB&q=iO{jFgm*lA@8(qDdPnD!K3T
z^}fH(<$GRd|K06ze!b7{_j$kXrQK2fQhb}E{2{!{QT~=le69RF5!cE;f)6>$KZEx<
z%Afu$=Rl6~=i!4&`2)0X6Z5UazmCuTYyM%3gZOt=Yf0m{LVFua8m;&d_+~yQj1%Me
zeIH?32&2tOWB3rR%?G~cxc@&(pOXT37Ow3df_N#e?X}ABEx2}1T!-I<+s@mi4n~->
zCB9dW$BkR-v7a=i38U4)IG%mBUI+f)bKi{z$<M6k=)9bX*W;&{ZrraG;9GF5jw<jM
zaBYuOk5AyXxkC0>qs-YO_~+$(;<&%Z>p=E`#<P(@(iu6|zJAD@Gl~BnuFdT!1HA9H
ze7E&?@&m-r#=n6d%%0S&r+NFu_oKyxDL&8Mr=<+l_%htqR+2{(ej|P%pUphX@91_D
z<^jS~n_-Oa=nmr_;QP%fXVRYd`Z7b9my7jsrvHKW8gQ-6^YFKDt<6jEg<sR#JcMWC
zTAL3sKWE@xn_uyU+U9+vlTo6tb7S}-Tx)aR4&G(Lwe!gUz5$nh7;6vXJUWPP#BJj{
zKoptB8*y*^J~I}-4&%G~^`!AP!UPE)%fr|gwc{V*+W6_m(=OEe{W!i5*Va=1ADIJj
zZLP_SxUH?EPZ!`bluz>td;-_z$a;J+`P=SCCH;0h3)j}Vetape<v)%ei)(u+{~&vR
zT&tf<d<m}YH3}T@rQftN|4MxC{l{lsi}wN9^F`i&l<RCHoe{#><_7UjJavUWj}PL7
zc#yERel&?!;-59$c!r+xC(iY7tsb)RGR5UOWgcISd(W_5{aeCyMxS8?2v<WoYcFy?
zTWujsCt<X*_TUfWT3JW%HYL84VFurV%Xg{Fx=QkX6+V3LpYc3%L#aN;<>S{oybQk&
z*Pidz;vIN!P8p)>ZYw^3YvZyv;@Y?v#b0s6pN+T{KjY7wGZA0w_xbn-j`Ek`i!RpN
zuoln2wKi<U7vS1GdoNz;@KJoblD_oUT;|1Y+#8qYyqeHo&2gDI#P_x?v6oZQsU@94
z+)L*GJ)J7j*-5ysn(ghK>V^ATBYyCuyZ3(5^yTq2yA$6Z*Us$+@m$>Y-mjE1lX);7
z_uh@T>XpRnjl3HXAY9sC=J}o=T*BHebJenVS@H<;cf#2EhNMx7|92m0)Dq^?W%@fg
zt@vVG>mR*%Ca%@jD4u~ILwRCjJp2ltceXc+e-78`GvfumKaAVn9hLg5VLn}jd-Zw3
z|Ecv^K|22+oU1+?2y@6~dVO}_pTS*e3=-xX!hG4hUgNhRCh>AytIw1dxn5kW&usi`
zT&vF_`~qC7&nmnQ*XpyMIk^S*>T}+RTA$sd^NGvdbumJiuMkG-pELNm`$!{Wn7ue*
zwEE1)*W=p!T(%Fd#qS`#)*h|+&3MpkPvbnV7yp?f{wTfy*XGYzd=fw0O#l4&7|-}C
z`!-y=zWj(UHsc%bQk3Bz5MSGu)#5vGZC}=k&$~ju2kFHFxVA4I#h2i={Jr^~`SNJ|
zJ^3xgUlTa`oI~y_{}ul&#mtxZzQot{b*uoN!L@d*z;`;l9v{VRebw9lM&h4h*0XW{
z-H#_<IcGdXZWty0IG%@V_2hq<eH*UTQyKH*sd%`a=rl?_6_HNm32%p=e?^~f8T-pB
zd?oJnm#7=hS{m^XzDTY!>KDfQV<*1G;e&V;zQBxsRy_VBehKb9Ly4wud=D&zDQ9_w
zzW>g~*Wub(QW3rl4@&+<9YyzZRrqVT)((yMG_IZ5cH+AoK8R1@T0fk`-^9OYme0I?
zmazXS@dL!k#>a8jd0a7JF8_w!7pw90xOOktgpc61`)TRRUHG4H+j*Jz5dJc*jg={U
z8rRw&m2J_1EA_EZN%#MN_}*CfGXukDXLHUdC7m6W`rH}XhqpLf=B_EqA?eF|N&agR
z%Mp2`?Co*JNN3?UcklfQ;bLVC|EWyReQZ~k;I{gbd`g)XFTk&nd_H016MiNgd-haF
zI-3Zm-LF;R_c*)(Z^gB>wgZ0@zskH0<L@#L;M0!uC-8UhA1B0b@FoZ8H_4;SO{?_w
z%8IzwZwv7*;x9DQH{KDg#P7pjGF|r6#=EkOgem=&K6X0s23)(J9K>&T#Gk~U!fo?I
zfO4g9%if7!Ft?16-_?|Q$|20FN*dB%8kl3B$GtOvJ=|cL<0JAOtAy(!+(%XHJ^b{m
ze;eV#@0=avr)4C+HuC##wY|*ZefT)8%?D%nE?hg`^Kl%r^gDX`0X!Smo?8d;tMP>A
zvXOV<0+g>De+oZj&ROiddEql-2~$s)jy1ePz-P0*lHLlhT@q%DxjS@i<hkPC*(gWr
zHS%0h>SB;|dI%$9HSXaFUVIWyuF=<*l-Iex#1rl@jD18lz67`RA8FHi=GH9S`>w|6
zMj54_8~cD7(pgD3ZLBxr-^FcpD%a7CKaXqs(&31E`;2Hk8T-;{e2n<E{f?xc#xd;>
zuI)>6@twG>9wdGVK8kDmxtd6P?K_Lj_!RMN_wnBK<1_e)<P~dY<NLeA_`%od-$|Ut
z3vt_-xU^#tb7c+g-G|-Ap+U3`r5%m$P~>wg|2E-l^$;MPGW-pE1)mer2!BP*`#XU>
z<dt^)?!C$Lm<LWy%xm5U@jZA4X-$Xh>x<+yfdA^4x5M|I(Y>9N*LXKzk}xk2#v32e
zFvk0<DR1&_J$Y#TDm&s@zbeA}iLbS56}|(v-Tz9vHsWvMTDx}Q@8cH}Hddd;cTETJ
z#W(8hn#o*vIqtRVdpsCX+BJ<wY_AZ`)~-^{Tzt^sCHOX6+f#H>j#2y|Y4bZ1%Q5eN
z@iuQIoxWPVJ$fUqjpI?gi};$);%&ILrf2ZDbti6H)1@Br@iAQc4pA9C_&xVIcO79q
zAdI%Ax8bvRko?T{ir!Q7;Tdb~Z6#wlow;rS9zNsbp`Y32#<Pdye^6J1)B1kaKD-cr
zL@9^VRVDs&#RGT){u4Z5&Y$ysQzv2GRML<<2JvBBJMWmpkH1+ze@%Id@6zL19b`vb
z9sl@B;%oh_3SWV1>q;Yj4Q?AZa($h6Bff;sv34}>p9k?RO8(LpGMWE2;NH86r$3j_
z7tFsMk@ipCHT&G#;eB9io(vyEOF44!BD_q>5%cgnP~s(c1Mcm~qHg@{#2Wmg@9TZK
z89(9{{dr$Eo`c)kIY9oy`0co>FU=6<6~Y7wAFE5_Y%P6)af#dR#icH*nQLcoZ!Z1J
zvk7%+u94-WbM3A6@hNpxhkpaNwYlUoLO!?PUYot#pOBB)W&@<Ne4YI_3MHQjycxG$
zk9hLG=o`3p|CWWncGTP9wJX}D*T&CQ3h`@+A0(|<eX{;W=c!6u^4Hds27H|(eg}S^
zqkIGS^_1^w$v;}Yq$^|hcN2I6@oi%>K$PU2^L#hpKalw592w~o(iRoWwIhV__P5vm
zE}<>V{cQ<pExc{c?`nQGURO2vQe2y7nj@~wGu?O*@om>4Z8?nR<JvqkjjzD9wn+Oo
z`$JsYzvki+-_~a({}Q|g*X|=~@OE6A$C~k{aNG4sJIFl#0PdZ^y!YFLb}-LiMoH(U
z+x30)EdG65D`&<e`$61RPg0H==G%7M>koG&mc#516{Pbf;k5gmdVB`g?qS>Uq#x;H
zs~<lSmomlruJMk_IDRy)ovHc%!yW>^!i=93{sBg5&rG}w*UDFbuf(<fToG}tKiA_S
z;@jF=@^8m0aa(^5;Iqu-x8N0g_8;CC?+?bk@dRmXCydtC$-6jP#kIDUd3+rA+WI%o
z#PgVQZ(B?{M>gthU5%fJYh$MgFTu5PcH#B7Hg<;aO}MQtrGI2G58jSv%HDhLwuI|2
zf5STcZRX=U_4=qLoe=KrD_>7c$9#5PPCAR4^uAH&aB15%{8PkFxaW~NKPNt)_7i3~
zVQg(D{bw8x;@TOGe~R-4NBm5DwIhB3{s6A_|9yBp{wqiR?f5--kZXyJZ)300kN?II
ze;j`px9yjte*FLCT<FJopUlLM#<f0KfUm%{K3RcR;aZ>UWgafWy*<udy@`F&_zq1c
z>0~wQ?L3Gt!nJmoba;SzNZCzaBfhJz<q&4MqYTA(5V!R;$)g(o?mqHpCQKJ$wE4Ch
ze+n-ny;y%px*)dK8OGnmwec{GPvE&`eB-wY()MuAiF?oCqI;pQ#m8GNF6nDtf=@ZT
z2H%Nm-(_l!q;G4-0A-$JE|>hT<g@?Ir{eu3Dg5IZ(x*pABloAf_uk6qcpcpotD_mb
z1-Gp!5<h*Kwcp`+_@Ki}@wafT4MO+`uI;f}BJpiwM#|TNzeIe^NATxxTOX2jAcr||
z2;anK|9MZw>rm#_#&}x?-r;@ajr!gpi09!;Nhem%q#>`JNIA>#^YMF4Pil^}LmfVZ
zYiBTR_@cY?GnhU+71!=t#_&UNtsQ*t@_Q1v_slrj*Nx{L0em;*JH{-(@eWZCpT%wU
z>|H;;Kj~{{xpnvg#igA_n7a?dZ|AeW`-#MMGTt2<Ae|8563!NBhv;vYPvB24)Srzf
zzsIv5+&jCB-amak-Vd_yt$3x>L)4Am{VBvhzz;J0jClM?{4Lzu14rXm$Gric#l3cj
zy7BD31K){z^&EBMOkn_@cH}>SkKx+&CC`M*cZga3qImhT@DbvlZaVdQBS8ZEUm-5#
z|IHjvdNiDd{Dyuz^KJ@#rI*kC>Br)28T~s$55)6pA-z_@YHMl_z7^N*=ST1^htJ>-
z<J!1Lf1k5a`~<n4=(v#1#6P89=i%M>$)-~uavUXIip#jx$``_)$8R>{CxstOOZ*o6
zc>43Hre7D&zXvbEwR@@&{7U>HGk#M13~L78glq3|q<_G(0z7EO=lY`O8F~0_T$^`F
z@o8ME-w^&5o^VEGJd0?-m$vBhZV#S=+tx^_zmbS9Hp_231DnB@5no$B(m&)`0<Nu(
zd3X`7U0*4FDz2?>AxHcGWp0VY-)xqj`Zs^OwU;nG<e{~}DE^dEMwwf4nG-v4Z*E<)
zH9j6CA7gIKoMn!_+dj8SSqt#re8T<gsgf|`gej5hiOye1=Xo7k+N%M7ld@=gq7Hl)
zZfoy=q{;jy?(K=TJ{rFkV^1_m8rfWjmPg9}Sj%xOj|%b-_wqR3o<}ihT<^%E8o$Mn
zhs@*R-fs`=?lP_;{LoP9s+%;r9C-}my^cJxnft`OJT}<#NdJiS#*s%J{;ngBCh`#X
z@>p!oqn0!>H`(i3uCq1bT6^{4IZFHh@za>&#Jw_XedPbEOIefh2y+=>dim_%V1%)(
zN!fepV}#Yld=Wl|Yh%7@AMqRa5x;XE@dx)2e{vu3Q}{_*SNXGX=k@O+e$_tWH|`^T
zXC%J22aB%BkuQx)e;LG=+@n7On8a)GTL>Fl)01Qe!x<m{Rlt1t8s5fdfAd4}{vz|?
zhWOf>yPw~;qSZbhN;yjK)ws6y*WgvSw)QvUgAVV;v+vb^b8A@g#}B70vFkiPUjAu(
z6>ck^)I$;TWF_9lXaC)uYCYs9(O(Fs?YYbF8Am?d<nu1RLh?CvPCk)$B&0suNhfo&
zUSIuqJ+7V4jN{$7c8}%fC)z*4we#Ujd>Xgamz1vn-;IBX&$0Th4A-~RXDjou|7W}R
zj`7)l$%BdY`9eHgzs%dwaA(=WNq*hrSJS4i`@{J4xHeBs<CVB}J!yWwZ>7U?@d`Xh
zSz^~4*&E9BHZm{Q<70gG%MUq6$Eu8@$o0x~)RIpA&-LqQ#ZSex>*&RE9Pvl-#Y%iB
zXD;($ChqNj4wzF;bN|DiVpvBwt)Ca*n{nH|L9VkR;*0qls|#Z<T90=TU)zhe<88RM
z7wyNN!nJxD$2)P`x)h*D{{6%8H=E^?wu=1DfP~2+Ozsx<Z*~+BW-Vc~dZ>!HcAbs*
zYT|3&iC>O;_rTFUW!$3=;+43zAD+Zl;kJ5`y+8r;Vj14cXaBs8c)zvm1@aE?`z8si
zogtRuzF+9~XCZtcp3tWvzsoOubBMAWkB>=NesF)hEXEj;a5IE^i*Q~au9*|g=))7_
zSJ*x$Khlbxk0kTwZOZX4kY=opR>aqgEPOS7q3KEC0|M#eg?Kxz&7qa}-MDQGNZt1_
zM|a}a@!8*VU;KKbb??1t9lrPOCare~tM!v%{2xkQQr2nwJzVQYY5Ym2{eG#h7rFS^
zxNSU1`XzWNuAN=f;Hz<M{%yvq@Gp~AtS#g~k$+11-T3!$TR#>b#;?Us;d3m$@qL+T
zya~6hm(r(-m^b@y?-|+2zl^s9{l$Dnmd~H!>g~|STN(be!)x(vxOSbb_=~vhI;GD{
zQ_kmbuh0CZJzh>rpP3-7)L+@l8X&D?{v6w(_!OUGbtYr&&3L_M6XrF-*xnnJG>Y&8
zADA;nBn{*5%U2U7pD@}xj!pOlc)~Ln;~mE?yb-t6iIiaoUyGOWIpI3aj$g+#VYU)R
z?f?8qzg}FM3v%%txYoZ*@G-o?EQ9eZx(3gDP;d8U{3Ki}UpHQWf5J@PxV~ZhMBFyl
zc;g>G8`tKKH2!4dQe3;fT)Y@hsN=|4Mu0Mv;0?I;E{&8SM3{dOM(g`6_(w_}62Avu
z(y7NE!HaP3yf?a58h;~c20tISwXs}7I)5g#9CwX}e8OZur1#}A{B+#bmnDx{ycSQW
zM;R|hTecCVi!iqSF7?odZ^5;>ZVd0kwYe^jxo`^qyu1%^Yg>E{k-5(JZJjLseD2#_
zdY>%BKftv<Rf+!#*ZO1wK8tI6mk#_RT&srxd<qXzC+4_c!>|wVUlVxhqjTy(>Uvpx
zUPwu0ZX%2}?y~VSa9f{|wkX0&9Pz90%W-X7HR3h+H%KdX4M}BQ0VVxT{7GCJGlTf^
z_%bto`1amgHz)BaNBopS{J#CS>VL~48$TA;+PDZ`<nSu|Ku7wG_!n@kjXUuGZhN*a
z^)rZ<;o9#jOyalThne+bJmX2>PpO9-o{g`@)$7MEcX$=P9QU3fMdu{?pgh))@;BmZ
zaIJrI;tlvhv;2|on0eQauf-GQ6JuVU#2?39^K$AZ{J!*G>vLKT{zY8tgT;6Ou8pB;
zd^xV&BQ@>AyYO>~ul123{403StRv%HnJN4VNBq<@)&*SaV>$R8j`+oR9iC_AZ`{{(
zFdw(z|G@nx-;*%kCcPY=i&{u$MYla2+51hA&T9NRN#_6~ojH5I06tDyJ%rWPG6|D>
z7-vY2x%Y0_gn67W+TN`Q{}ZmQcUAcQkI(6!bJn{i!Yn0>)_=P20$go>d<m}Ae-?A#
za@?!`SMRpgzuW^96E5Y6-FriP_WyoPIJs%$|D_#5gexPQ*A9;u;VkV?wb1XokFc(G
zXd=v-9(Ox*6Q-RoT00EmzrnS3n8v5^gn434JEVWo@5_2pZ-+d5F}|2Oh^<w|nNBHQ
zfNOiy5T1u?>wOEp6xZ6h2hYYAnE6NE+mQB4Wv*L<XZdNrqgvwae5U-C_PliYeyOxy
zo`idP_ufD9IU(FR>*w9!Z=8SY{z*?rYX|V`bk<+OChVo=>>-K?^A=&WIl3AjRb29D
z!e79j=5wrGC67nqb3->_zO_xie;&qH;o3fB8V@<*r+td^Q#|21BR6qUw^huc_u<~V
zu>ac_uUjdn@jcHn(itb5wpP^Q?>q7tCZA)UiRANhJ)eHksU)11&p5soPnZ)Zs|;hg
zo_yxV)^~U9ZRNB7tK<`XJ}cL=Azts<i`YZHw<~<+WrUG*Wc@9|GjZ>^L)0UG$6mY&
z4>-ILKOFb^bTq#44ooNhF+88NVr4Yewn6-Jj`)*!8t%Ol5luhx8{AS41<al2;9fnP
z{Zq9ba{1DBAK|>Szi2u}eKwNLa5SBR^>k`Ur*KA3XP9)#aIZYW&1!l2NoUBBP6qSc
z<BX{`uF-!t=@@%2vwc%CICG>wYW<{wbXue3xm+(#3F)N1uU}Uu>15*GbseRr(@Hum
zj&x)m?~JB1@e{Rv#z`mefnJ_`=F(i;E6+oEI@zE0`#K!y)RRtcG@UhiIyIz|^Pygz
zLDDI}z4Dx>r_)P1J&ttJnCCY3M%sOLgWB%?BmBMv^bf7w%Sh+wX#e@Go=y?zY*y0A
zpzl@T(hs%0Z{t3^6Mu~O+L}0s-;W2$E7r%2`C$_Oy(50gXLt^RYkS{p{9RmI(~Izb
z;o6>{3jYw-_I8c<{)|5@{Z9OSNBV>KLB!Y6pTrNtwRJHi;P)MgUt-o@QuxJZX}@f|
z4A<6~B76<5wQm*v9b7y2Zp5n{-ifcqwfoOO{4!jt|4IBBT&tgy&-#5gIy@V{)!{|>
zdOTqqMecpP{*TMPLCe1p@4|0RsQ>soft~oltmEe<c>M1c4dVH8*LfrVNxTHt@=rOE
z`*&Q+KO2AAk$(}s6W8{%RrtRh`8VS4;9C22;>mrE_Q&5NzV@7d5)Tqzn?F*HVo#52
z&vmkKiLaec6yYmyt$$bHCAc<z8u4%9TKPKhOYu|8_K!T*k^PIz<00Jp9?9qLNSN=<
z@5)Y-PQmZ=evp>QJtD4+vt0ZXTx+KiycpN!fg1cgT&t(%NdB64<3+^R`q?mkF0S>1
zX?!ED)pOeCIA_AOevpexe61gp;GMWu{u=xN+|~~Qv|}^ghs*s%Y#sCN+rnQ;l)0pb
zFiHLPItbt+xF6T<wIz*N!VD2cd!ChXG-uNIg@lcjL+%NT=UG9*9RIAnE(1g>#{+oj
z+%$|c{(8cc5XLqyNgD0=<@ot#8sYlzPOs%!1_;xrltX+1UyIwuj(GCt{l0r}txdD=
zM{(Pjkg-?C+}ehF-^qRPhlyj)_$|e1(y1P>x0{rs315S2W2Y<PClNN*CdT&&hVUN|
z-&U8B{uI8^k$x%%20z8MzMF$LJG>a*fNNu`8n4H-c4)%4;I?~jDSsFK0<N{w5I%ux
z?UcpbH-dZZbU}mKPU*+6*Z-q_9eMaBT$_VR@m5@G$56x<neAwN$E*e4NPMjwdhlk&
z1Ee{EZ@^t+W|lC0gwghc8OQQG1=spgK0bnLZBd5r!oOi&qwzea7C&LoJ`YM;x8jAk
zmVYmPK5px4a<-Mm{8oTp$7lbY>*8%~Ih#yAj=dXUwfQnY8rg)o<WKJTu$VB7gwf6>
ztMOmp+Sz0iK8m~M%WlG?KCjoyFuus)(|9JX-Djj_`+c9p7jw<AIVN(pDfN(xAB*3+
zpW&<v^X`oQ9gtGOwEtN@2Mpnxa9jVDJX-J;{F7!L;j_yFBp2x)y@Y8T+P(KoKF7+r
zHhx|;ig)9-JS6@sz7@CiAMuPYa1FRN#`E#}9O;)u;%oWW;#-Jso2$J3kN+57XkMT3
zysH<#&Ecc?T3nlJXYp1gen77Oc;*oNX)}LW|BbWQAYqRCi(bd&_^}SJ!?SR$4%+Zf
z;#wW_;U9PS81BclI`Dnb@B1vS^??AMhHG<B5I+Lf#!@+cD6Z|X>hM!>*H~&NOwS8?
z9{u=(_yuM=MP8zib{xlF!*`k<-aow}qec2!at?j{MSUz~;e)u=mkaS74zI)q@Wae9
z7|)&?@NEw7z<-U~+DYbmA9LD$xc6M^k-GnXu75E;FHDnG`LO-{`2a~3k=7Qxkk9@#
zMp`$=)5!Z0@17ARNSN5%W1KaW;&0(vzYgJl#cgw}>?emP!vrpSZ~yL_<JU81|J_GA
z3;()%@7ZQKl1}pq8sPuZnd5?ZjimFqkxo+lZ+QC`^FAP9Y-2>y$iyGU|IFvuwMsdD
z8?TQ-!d(24eVj-dm3Rf7@ZAeZ!+0;Tkuci{V|!;w>ZB7Nz}NCQR*vXeZoD5kOt>Rn
zp7Y&Ic@c(a($}Z)rMULJqO=ou&jr`^Zn+WH;+Np(JMyo=S3B}=#&1&c4^aL|=52BB
zdrfbBFWxsIf1g&uq%!Yy5XS4n&lzEiK0Hf4gN|}!<g&kWl%s|`#JzH?H1aUY(L$L0
zM<V4o!w6%Pqn><@C5$#!+VM}}+8WT0AMEgPT*_eU-_jraUuHjqYxh){_$jz;4UoDn
zzzgw&eXjKFi^6?Q!c-FGcEY&k`9{LbdqtneJMksBYaSmW%q(HFJ<$}N`KmsTr!L_P
z7!OkB*cdbBwH$mIZmSEa%VN9;Pgw7$3)z;5SK}evwx<f<P54c?whxyyx(Rc}=$t$v
zKXfWSjIY59_#C?i${;7H;?wv>T-&3ko#^*HgxmJ$5<eGz3%9LB0lWks!Cia!5MfgO
zrq^Q&zR=-4cmUVtsF8?k_m?yHBI0Z7d3ql2K{-4Rm-3y)^~UNr6rW>D@jP66mJ-6R
z#cg#cb=-ol#J_5$Z+xGj2XDl+Ib#H`Rb1AR8N3R=!Aw88mKeXQ5IBivdW6&VEkS%M
zZtKr-9p!kp!|U+JajhQO@D7Lf;hS)+AB^F5<F@xiq<p@m+(Y2^?Z@ZnbK!aSdN*?7
z0er#hdOr!`DY%w?IsU<GyZ1hjkp9nO>DS@)W4rg>C}oM}pA<gOlKk87*Kn<V`|vSb
z>jz`_pK;qh%e(%Q{k}JFZ9WU&laBO*_^Xce%klp>(yzm39O<{=|8%6^hrjPge+-}Z
zhQ9Xs@|j0)?F=V?FTri~E8{4{TzWL_ou_^4y7*p%`PTd`!b;M4_wRZ;HsCY3HV!)Q
zosRee_$02~hfUyPj`+!^_<e6W^3TGD9bSk(hnFSv<M3}%$^A(i^KH_2<Sgo2HSv0i
z&N;^So0>_hh_JRkA0Vx6d^xVIkrHNvFpK`-KC7CQd<dhhgBhp#eOKYyI+%~Q;<h%E
zGL+%#ao0LnN0{w|(Z*jJK8S1UR3E+rFDJkF{1M)G$@m__4}5FReulm&w*%hz{|b9g
zT>5e>zVX|U0sMGJ{2;y@UuwoDeYqWx^vm%|T&trx{1QCjyqoyZ_wuFhj53F>BaC;B
zdGZ=(-x(skA;M~XX9|A-*ZPi>IW5S09RIZMuL5{3z5|zg(^#EJnT_W{rG%L!jMle8
z_$MaxzSV*k;aa`*;HToQzBNjiHH6Xn)+}C&YioPPX}qt12j^U8wD08O8*tm)DD_x|
ze;?QGTWawe9Nvnr#<lyFUi?S+VzYe4JE)`hy|{Y)cn6+m#y8#<$XLen0Z06Nd<TBB
z8Q=H~qcZ%Mf9dZl)Z!~}TVIv>YsE`(TOSbb#m~kQ?lmI!0RemzzaCH6dxX!BH^~M>
z((s*5Ki#R{a|Q66fA8M=9|;@XpM=lO{wBL!Nuz);9}q^n=c>SuoYd#AdOUz@*V&FA
zifi@MkEc1(ACJTjn%7{=f&K#Cdmz3x2WH|+@Ps)kGT6QA$5-OoII6(Q@NH)PNsmeO
zdG%M1e}HRqd^<kl@P7PVT&urvd;-_TssF3ouQ@yu|Ggvq0{kglyH}~eUw6c>$6vs;
zaoCRU#I<qUk5A*;I2^|>_>Vpg{b%@nb-0#)Cf<T;`4`|@a4r7|e7{|K{`L6rxYmB{
zcmUV#5&H2Pac%E6j#nw^2k4XjGkL!NUv2i!@EE^5I>xgI(?J-m4hr$Djyx*y_I>2h
zNSIxO`LbD#$hoGJbDa6w|8`^_aP_MAKEU`}>O-V)Az`$-n8FKjTU|>YsfC=4;;y>L
zB}_eGw7Mw4*E{m4!Rz*sM+;$g5JszuDdzSu{5s0)zv7$Lx)>#mFHPxnF^gy7T3uwE
z#Tf_gs*50D$_b;@MLE98kw+a~wvRm833DG|Y;_^?Z$I9PYxCPU-sy1v+3e$S?R$Bd
zcpt8v<rLr_;<kE}@>Srw9QoJdf5R6OHnzqZ`<Qn8ZAbe3_?viv8K3n{&iexV-#EVi
zf8BfD<a3yV31dq`t|1G57uWW)h4{yJ+xN3lhD!Vl+_hhAB+N~O(fU#+UhnWhd_AtU
z!z5mZC+wG~r|8*iN)i18x9v0J8nW?+ao4>=F=1}nGbaz@Y_=M|57+9s3EzQh_1uNO
zfou1qL-?X;y$+`E6vgElQ_tml)}-%hr(D7;CJn8fO7MLAc+!jYXX8w<20t4=$#ml#
zu4X)KaF_abV7u`Jxb{7pVf<r`_|v#w@c?BiVqW~{kGs6``46aw&#guo^OlFp_(k&?
zjK8H?inmdZw!S3eDTHsqwZ7VdH{;s5W)J=oT-!5_;2Ru1gEu+yPd|_EO5@tSR~|0c
zr|pSL@gZD0R}0~9;kG$j_TfX!*)QSVx!P@4#@m4LYM!h0k<NYZ>h(N^ci`H7z*o$B
zkGR$j0en4f8?OP%8N|2Zt~sHCFl*n_=Y)Fv0o;~{^p$q}d0d+l`tg6@+MF<sA2DOU
zM!5$6*La@_ca8Zh!W0ljd*)k+7vr}6DtWXq_lkSZN?$LJx2N%}w4X3*3FAGpeZ~l5
zJS*)YpDl#Z`uz~zhHL$D3LnA`qfD{6$#@SV^?bkYS={zcpj<}|{sLZa#-~q4Zu`Ca
zxe~%Ge&61=r9Er#&*Iv-NHhLPhj-%(aBXZ3<Jpe*)A*5!%QdE5z_Ty>>ABZvy!Vtx
zm`4d?dsjiOu@rv-*V-wBKko1ryxZYD_*Oh&EjP|SM)22g*YoCC!d&#Be)f@3!ZT}p
zr&$kk-Wv)Mrg&CA`zXglxUC)nq+5qyk85L3!n70S0m3BoY3Xy3-!73b1B7|W5k}f%
zk}ygCv%mKvo^l~$9M|T`Z2UyLhp@4+6L}d<;uqn6#+wrSw%9pG75<fvcJF;8!S9QC
zBmO)dG@a{=o;P;lyYMsSxIA{1{0H&0z52dn5<ddht}kVU-**UZ8~c)eHZJkCHLVEG
z#V<3<msAqFzAF4Xxa~eBK%7Q=9e$x1U)tF?SMDOr6NJ&)U<g0Yw?}P*DZCH2t-ErK
zsTcWukKo$9NDls6T-*B<<A21p@19iSY5VO_*V`t1e_Y!;c17ZAZ7_r%OMKgSlk1zp
zvv92qQcF2k$5)zd5FYd1H@O4+e=cF_2;*AwO9@kyw8y%pOBx}(8rR0Xl(m&G?S#?l
zx)*=uxBB<RNAZVoZJ#`g{|eXoQpUx8-)Y--seLIQKc4bweW?upG_Li9T6`t0wRJ0A
zgKKTwi{FlGZ9R%N;I_7w=SsQEhnw;1`0T%+G`=U9^Gq^;XI;V>Dq*!YmoP<y>7M6q
z(`reFFj|{7;k$9IPP_0oaBc4}gum?YDg1fdws(+gNWGNj$hd3W%q7gq`Fa^j@G{)i
zE|NzLehKb+x4nfh%lF@-K2zwyug7h9$k-XdYjAB}KZCEtwfnR5GM-yH($B*seja(n
z)<WaiQ7OI_*V;LRH{jZtaSQ%W{9H5rr1*DTd+@Xa^nNme`xTe_s~LQn^lvcJkM?`x
zUOjLbdjitY&c1^9&A3+2<@g#${5t$0Tszxt!}m|tud@$-hxpohHHIHRe64)G%X#)f
z{DgfZYp$FL1*n?<el+p5aW8$XfH1oWqusw%;0r&tN4<Zm$G?Ev?%$*g?f6REwN?xe
zW)oqw{x*Tne_CHFlCPjY^zI7(oulY)dYHd|i~kQ#c$PRX{2r5(u@Jv)+b-wdU#}ue
z7h$~XjOJnNj~a0w*Kiu?#m1EJPF*K{ByM}oBz<}iFU0rNr>6<mLb$`sd?NRNvM$Ix
zz8?2}6X?wI<Lknl-vp98Lxes4z&+vL89L4g>+KoBzcVC#q_UiF3+#D{H{k!FeJ<d0
z?6+NvzgN?N2dKNN6a329-f{pR|G3`IC-5_g@6A`yx;OrQZ}Qi<A0xiDR%hWp%CD`(
zh4?}|;T>S(yKa^ErMR}YZon&XZQbj@FT%BPK7fA{SNlI+gBM8sMW16c&ZF<dCSOUP
zz-{Y6fGAn`Cfqd-6cJ|S!E@#k<LtKz-+*gnXv81KwR4_M{7<-To{&B?i0_|j?*noT
zllTnrUGqrlRh%7=hE|U`_!3-e$6~wy*ZN5{ehIGq#zqs~jNA5Xa*bX11Gsh%H-z7d
z+va;2uUX84P52Hz`+u=KKDOmPtJfP&-Wg7M1!p*i==tQ~N8?(5EyWMRwf-8yKaXqm
z*n;QcT0QpQXX6!IN31^^zcD<5ugA4|oWXyA+v-W`IsF^FBaYkpfy|NB%%N?#w|Bnc
z+;}}k_YlVWd=;d%ld#&@s>dgB*VyVHOwXbAu@#^^1Nb<8A)jOQG3VZSk}wNDp^vYW
zm8`?KHomg)mAI|WqzpxPDef9y)r4szjICa!-kb1^xHnHn=P6@f*@Zvsh(Cn);M%@&
z3jbu9zOPKZn(>Qk{W=HFRb1+z7|+BL&OpNV&)zpT<r-@UbGed+cr(7-;obPDxc0nu
z82>tMYbQy68ZW`MJ#AVga|CYNXGr{9{4q!RC3pvJ+f#bij}PP8cxc97!d>H`hcH_X
zo0EsJ){NlK<Jwv?gYU+*wI=<WJVRTkkA*yZ8E&iN0CiM~=i;uhP)nFf!f0cm6<>pE
zeX$q6QgJE6D1JV!^+gHeTg7;Egpu~jB+PS!(bk*-{3+b_>_g&LM0~O27ah~a^Zj~!
zkoeklw&T6{NoM@Wv&aDd*N?x1zht`1eFO3JY=STipWKsphHSjUmi#T|4O~0V&%(Fi
zT3Z$31GrX4m3S|Hlv&10;^k|=`|vW;jlXH!fzRR#O*g&^K7jAWwex@pd<ri%<D1uC
z#r`_oJ|?9Nv+yJFZ3*$?@9-7keYjS>O8jw$H{hMP?OaCk@4$E9S|1zOhfm;tAilQW
zNd7i`2)B)A@A~lpT$?is@xazy;XWL_zc7B|rV>9G_s;sFZj6Bj{L{GC|Dyi&c>n0Y
zGjVSWMg7}xAHbL3UiqVL^p6QV3%C9K#Q^o2yqYsB{QJ_r(fBfkjPL$s6Xq$xoM47o
z9WO%>{wLh~J6O>)BJZzB9aiCE^g*o+8}Zj2eYg{U&EbRiC~jL<B>zeLZ@AXSQm)}F
z1lRVQ*?1~_z&20G-nyRo)`xq4OW>l@<9kBt(fnHiHKen5k$o<abOuT1z{B@=zf<l%
z(MTt}kMRBqtXxko=~NO<yWUZJ6|VK^S-cFlU5})nQO)n6;$EM#%-i|+Ww<scmf=@B
z@~_1&#<lin#jnS;Ija}H57*jj6z|1t*C+Ly%beJWd%u_V>S>AX^;VMCv85g|zr!=k
zBlLb-un(`mZy>%l_tfL{xYkbX`1QCp_w?iI9?{RX#_<~baIPgbw!No0;rFloYxrG6
zT>B1SCVsx_`XjFOlM1|o__lVC`mM)HaNGJW-j1(!<li50E&p-6&XK?WTAoEY^3TL?
zcjR9XaV`G}yw#C^J>KZZza78Nk$->0wfx8N9!LKE8usgs{4??Gj{FNEuH|2W4?FU&
z$NL@mx8twj+H<mge9}?A@rY~X^IymNZjSP0;=3H>E5Hx<j6M%m;D<Q89zWdS?fB;$
z-j9FL;p6y84)<Tr-|4}FjJ4SQoHZ-@-a#f_fot<{0p5&jXQvhTYxrSi`o=p)_4tdp
zwhpx8Q;z)m@jyUd2gdOwxNZKCbs(Sl@o4;@d7O!Tcyi)8@W1#vkbMK|@=^LaP_z%P
z!aqj*L(O_PE53hf#6LW8PCFR;uTK1MNBlv20j{kRllWP<R?jIR&UbKaJ<Y~zajhO@
z9<Rc~>*><OdNkJ48q&!-S}#X4z5>_!TQ|NA*UCAJx8hnkvt_=;y>ecvmowu=&a;lu
z&q4C>wYavQE!&6J;@=~_)*o8&Yw)1iUyT0Hi{I&pKZ@UiYyDvs--h38rf+<IFXJZe
zNsiU$wS4^ZxYnP_@B&<Gr&|0HTx+Lc=IyibaDU2E`%^#ZEc}AL4<5(Uac%zbf0uEC
zd-pBTeQxCM_j>z3Jm835fJ^>b`W1MJBmH{(2wdw&?fdY4{L{qO_Lt-MvAEXH{I!05
z>rU?{nRqE~YbU9n0{l!|TVE^ii*fBfp&q{q*UHz9Ux;h{tRG*4YyE5-Z@_Kk_vU}*
z#SrejYkkj>#C~S{c5C+cxXv8?S$z@ShTHOydaA;kaN8M?l%t<=)Z;(kv;SnH9L9a0
zgp+yv&1ksK*uzPFqvRL-lHRXo_u(09d0&zETEEK2i*T*o%J5Th+x#QfA@lf6`04v`
zy;prXvEIMz{X~fOEUKM!HZJDAnmDojiTBOC@cm0azS-g9_%Cr=y-Pj$Z|2!2uAQA_
z;*$S)X8uWMcnf!c|0}?s#l2_K(fK3XX5J4GNFJ4hNj|~;JWA4Nz>mPM;dAU7<^07s
z1L`EqD#F<A_a%)%yb7P1o5q{*J;oGa@^bCx=8{Hg9eX|8^&BaeFdGSDYj;Vb1aH7y
zXWt>h^b$s!6I$@+lsu$9d+;871)pQ}l@vbk5+A{L;o5ob3_gu(_Y~>h=Uw41>vKvT
zo{lFx<1n5-l;Q>Wm(B7SXJH}y65MtkEMsGcIr}pFNk03pS)4F7k{*n=XCLY8B3!<i
zkMUl^7=GXqeeC#d;obz-`hEaE7}u^Nh-W(Dm*Yn|;@9CP;@Z7K8(xQNb5I|C2d=f_
z7=90~tqs0gd5<60+A)Ct4Og!p-;JMY*1vZ`7oMBS@zfLNq|dmHzF$>`=i{#N)=rpj
z6Gm&}e*AV^n;*yVALH71_1E)vE%4RmHH7CcZ<dwultq~531jQ8;)VDNxNVM={@lhK
z{4DPE=ihu$?axi5vm$TL-gL7p=Y{)wfdA{lm*Z8Y%RCub4<yVmVKzF#NO@-n^BQ4n
zbt0br1HLDN-^l0q{1SfX6yU$|@MBNX%OPo$5oQfx7VtTiM&xg_iPz%gxHk4$@yl^-
zZ1m#y<67Sz#UI19zB`NW!1K-W8FNR*I=-WZYx|je{3VB%;m_fxo9WY5GCaKN$9Lk|
z9Nmgf;o9}};veDK*dE2xmd+V_#vDD12XU=_GH#<U;@TROkC)?G`OEN?xK{pJyaw0G
z--_RkYjaaC{y46ce-t0Ywerv6FX7s}k<q~1hbOG#k-w)Z?U#=qcC!5$djK!PPr?)8
z%UF#(7n3k`g!wjM67KaS%(D2HZzs&%jxbV|0m3{>n6L9WHr674j8A+5-#_18R{=cv
zhuj0<+TKaRWD{nBFxvG<KE;yGDfW3q(x}E4;H&u@E9acKwwW-cgjr~YF`ngh<I5dB
zj2GbAnmLW1k8Axd?RK6k;o7^5x%fl4*6&L2?T-9w@F7S3&G=h*g?atPyItM*v8U?!
z592}HcHbdwG>sqKqCXEw`w@E<hv(v-#urHWqR%;vbG#D#AUxl6<J_hO|GXo9GrkbN
z$c&$KzBeGG{N4C+{2<fAw<F&D(lEZ%;nTQW|5wcT#=M-?$Zr+khnsFZFUrN2IlKfv
z1=s4Q20sqh>Zch$(-FTLUxI7(GmNjswenBns~nzohu`-NNB+6^1-MrJ68suR{2Kgn
zTq}Pwz7f~T-;Hl@_%MElBmZgqySP^VwDo@9U5@y<_&QuGe+iz!T&$gE)$GHY@xzI)
z?ajLJkK;k<pV9kmV|)$cUvR{q#sj!EKcwBszTz&u{&VpU9A1LIgRA`?|2wYLe>1+<
z5x*PXg=_UcjJxKyY1}oxr8T+dw_Myczm?#w`K<<b&2P=P%x`M{$Io{7F#c6X|DDE9
zz_t2M`!U}kb;QrbPsO$RFTt<Jwer{CYaHH;f7_9NH-0Ium46t&!4ZENUx{nwPuswG
z8m^T;7vJRY68xu*{A=)AajpE#_|F{iyYcn7R{ml9Ib19MG``*8X+Pob96IvP#UI4A
z@|WPhcf_y3AIG)wH{+w6DQNR&_da|Wf0g*!{5g&P3D@S&v}V4G<A|S&kKvb^^RKZ#
zDZw+i*VoElvkz~^4=27>{%-u^xK{pQ{0olw(|7>a%AfXA-iyMu``%o<$l)cpoat!y
zy)}3_uHAPv<5%Ne|B9|}#(jA=UhjxMjQ>c9FK02?%zyXe-dW5!N2q5p85=n(<_tvp
z&69lmbX+^XD8o;4cr6~pwR&j9&&0KQ=*6$XZD&pyT<0h*XGvQ8S$qwy-5+P%#q)0b
zG_#)@-^a_x@5Qw<u`;~P5x*Ayts{Ob-j8eb+lz0<)$7L}$F=&M#h-ShpV7h@J${CH
z{ojk<m*?Ye;#ZqK=eb8YVLrzhjqP4BK)gD9DSp10hTQ*$zv}CgFztk?B#d@%E^R$P
zm|V^(3g)CE-*1yNCh*d^XBoy>grt#jH}3@yM(YpR_(oi-?;>2zYqa{V!Z+aBcxuG&
z#kKbC#P4zVAbz*QC-J)+p0X)?ecE%bZ2Vc`yV|>$Fv;w#ZS5^}T#X-r+xnDv6JCI8
zb=-xYh}+hN0P%<LWATLV*GW4Y?;A}MrkpSd=W2wBp2?@(LqEV>{Vk6$rJMyNq+y&b
zmg4oetv||jhVTyjL_WvvVT^aFTkvP_i%m}|j-3JY;4`?b9whw{e5c|8d<GxIU1wPt
ztvtKn97Y=t`S>FIc(aVgcjwFSEc_(Xjo*-~#h2mQI@^kW314i+H{O}=#ZSlcO*hub
zQM?@2#@j6ZEnFLK8Tay?T8HQ3a!!`e2O|AQ+Mo<?#<l0QwfIKd)z8`pb0ue433(X(
ztPfw0YyE5t-->Jf%(t2EMc`UL3*bp#vG=n8*BHd7iSO!16@<wm4Xq#5<BM^v9oq36
zT<a(O_-7pP$MH`)-2XH7o49Q($u(x;3vkz*Qb?Er!r105*>klq_nwG*d#*ic>Yl5K
zbOs2g_318r9M_&X4B<O*ZA?z#Gq`s4o7%>;2KD}ygD=Ik`Mnq~#<e|BHGTo^ojpeP
zwz5c5M>1xb@HM!$hIZjM;o8~w5MGU6Kw7bRHS)kg(x1ZH@!|vz|G<=Z>d$#s8Q1DJ
z2Y&@GG~*k;&sU5mowjFhw&})qfvfQaxYpO3@Dw~~#y8Hky6|jV`+E~Z_!+pZFMHRI
z=Q%ue3+pFtyLSmtrb_0_<&pgTXC4~w$KQ#!VF_teIMV1OjfQ9%2iVhSA&t$1v5hCW
zjvjmiZkyX>yrnYlN&E-+?7#nzcsaxS(@j!ZNyqmK?gf|W?HRxeajiXrcnN-_q!sPY
z7su<O9AANJ{k0A+!nO8l!%ua1AD-jzG5kn}``UR%ihs^5e_6cz0elgzjprbK1g_od
zm+!;tBCf4JZTLl`@7vF)-=z1v0!sV!;d!U)`H$_xeZLIHPZ&=|Uk>2sE9nQwKg4`0
zekGs%mmVDNXG!5sAZ4r|jV8iqZCsDvf@^bjdnEoBNh{XJjNjVr$J>an&8g#fA8v~;
zV<n$C@y~dtpKG{hLHrsD`QF++{#adS-$!3B)aT|RybNDqmNW8BmgLh;J{$01+R}fK
zkq>*OdC$e)_iHAdQ_t4-EZz7DJkQL>_>F*Jd^N81$!YxC_+m4@v9C<KpWk%Cwf4xx
z@4&V8EWzt=+Z-zWp$2cqwdb?V_*Pt7gSzn^{3^5jN#QROOZvn3EN&}*0H4MWJZF#h
zTePwMB=<<C$H#qo2jhY;+Web`XX9EOm+r$u5!c$F1wWPawLM=Ce!L_9k%(*Q&)`8v
z{PbVBJul)~`la~!j`D}_Wsdw?BCe(1gO@ncAHfT7TOX7@ki)!KiOam_fBV4rm^bFW
zj0gCB17Wl><l{|vK54}Ik#YZ3hIit&HClc{rJFMJ;QdmDYm72Pe?w(!ygzo3R&kNO
zjt<~w;M%@!0>2*D##Hiyob}<_zAg)I$F+SxA>M^+>wG1CAAYD=SH?R74R{N#m9GQe
zjBESi0sNP^ZOqG@FoFLXUt;EOe1ANd$^Q?ycAuGrzk_T0{zCk~bM<{fCH`?->njcT
zvA8zgJMd58+P--J|D?kw@WXJe{*xc#JAC+!X8lC|4yCMJS$H|#W_q-ru8;TAV#19m
z<&bnbn0sHsf6izBT?fR+oy@;KiKo*-I>pQNeSQzV3fJmm1h2%k{xXAKgKO=P{xD}?
zj`(@_PaN?}@h(UF5dH+NtuHP319*X1-_%j`Jhumb9(SFcj1p$kd3v9o#h=4%dB~W_
zc!YatTsu3-$M-AN&rZtlrMRun1xUXZ&&FM6CvAi&CyX{P^x-RUZ7(#2uf?@_!PiAQ
z<J!Csz_;Mqyb#2n$F+H(93RKE`-eLGpZJ1=c8-sOHvF%+?ROWYjr#B_&e!XB4F4Lw
z+Dw1W`*!|E`Mw}wv^vhjx8PbG7vN9fS{+y51GqL;>+$Dst&ZFA-MCiA{dn>PdL57B
zDY&*5$Y*ZM!M(je>b&@zWb6g9wz9qwMw?Fx@pEx)KB>f4;kL0L?bv{q;o2Et2fh+N
z&1^^GS=<1A8?N=U3H)~4wigMIX7aB&i^X02B%3f}gwfXcBK##>=K0uu$oN~LRro8o
zwnu5i4=mC9VJDu7YkQPIJP+6QD3f>ruJyx|ZuX?O?fRsSvT;ejcb;*5-dLK~IgcSL
z?O05hp^NP8ENN8Z+wn!_{d_o$1LY1-(r6}3PpLf(@oxM9hY#bexNR+$_|y2ixYpOw
z9`pNr7wdg37ym4-^|cZ_6W7wO!H;*O-;AH<NWU9DAO9@Z66<HB@i}uCzrf+scnPk}
zCuxuK+yh@`rhj8R{apM<c*446ycb@A|IU$q4L*X~`k9QKLFVk|@q78~zwM)>*fq)?
z>CSjLdP(Q>OZ0je#S0uhi+>f@>LKF^zN3X}XUX~a9k^BxW%#qWHs{siPdM^##RqY%
zo~D`Cx8q(t-S9uPp2kV%#7p&h^7k;V9iEAwglqLwfG@|jdaA&`k8AZ*k3WfP_0*0(
z=*Yhx@58lv%3$7m9QW$!>RD?&1?X!jPqH5?bAP8NhcGpS(bmCYycXB?64m%Ej`&UZ
z4{>cT(S_fIFQL4#abeuY4dD;r+FoJ`|36%7%hacMw-nd*<vI8p4ll-sarOG~S8%QV
znj-0|*N?wVeD(VA`IkAaAO8}rUjJ{{=iu7ho`au-Yjb-segVGNY#-xnu^K<*JNn;t
zYr<1-uYRK6Ex0m1=XK$qaKs<NKd!jUty#=@$@mJ^U;nl5$Hzi=4L&2f2B-J(+Yr>V
zZNDUIXdeCtT-!^O;=gxz2!9Sw=%>u@@(zZi--7SPZEIWr@4=^W=lvgH`e=)UJd9`O
zv-l)lKzgyU6uHNgGGsi>e(Q3_{U82$Tzhs=hL_{oyjF{!uXup`Tk!%sVcwKA(D+@!
zKEi|uqxHuz{1#jrPrhxO;o&EdU#t#{cQgX{1GqMxgLoINjmL8QIb3UlI(#>-jmI`T
z`3n7<xi8|{cpJkP5nnr3@;$?E^59xO4&ai%=0SXaJlm{4<9Tm6ekd+uFIK<CJwYA5
z5Z9g`w&CfH{QDyDPdC%2kH~i{1N>h)^W9S7d-rztyb~Yq#=V`tkFzGi*w#-O2buU8
z4lls-ajl<M;K$>(xkT!vH&Vt2`0W3XUwer@M-AVn$DY-8l1{Iq9E12)T)V%T#NWiV
zzMS$~zTbyy_gC3?YPsIlMR*3T)ngTYD6Z90Bksp-V<kY{bmBR<>mGH8FgGcANE%ak
z)jrZl+s=N8Fj}9^#kb>UkzTB=l7ikMC3%$K|HfZ7UFNMngx4`?^DgGz&0pWM_gk_K
z9knOk=7gJfS^QaG8)?09<(|DEGp(fX!#+u8hIE!*wP$Z5pZ)*dosdqFEGGQFgbOea
zZYEr>gnM;PxQD~xq_3y`j(3qN^lQt(FU7TMlQc>Qv)~*0_qJ>BQv5H3jn`lJ$BHF>
zGk)Mo`)`!XwM=p?C*r@Bx;xIe7I|K~C0=)<q_h2Md)-Msv-qM)eJ_^L&wVbg?FIAk
zG+dh-%kV?-Gsr7;oyPmawRj$Wwdvt8f049^l(CI4-zAK;KJ?*DxUDZr{4x9~T)PI}
zv)sFUb65Dc&ZGM+qb~>WYw;JQj8QlGvgA=fm{sJlQo=;%uB6MnP8Hz4D)6LLyY?=n
zy<#r?JUiZ24TMSm)~>xZ1c~Jn>F1J12VO-UT3ruB%3!O90P!dApAg?w*D23&enl9q
zuCwt;T-zHL;ZwM_7PT|~rhPNA7Txl8e5@L4Q4?t#OBihq?ZN~21zc0CE{*rQhVT+x
zd$vA>Ux{mLMC$K(M*-K?h#b5H*Vc$)ybssr&T4!R*V?fO-+{||9lJjIiu`np^n)&Z
z9M{&6A^atWPvHZ&wqHyg;CDRm)6D#hbJiSu4{qxNGB*|D@8WG{e9LpP5aCv@(&wHQ
z{CZq#haSAv5q|`~71#E?Gx(2jZQq*y2fibN+ty-fhdlg6TpKH;_ylgNCy5`zTd$t;
zTiUd<+$xH<;E&)7q#mR5j`6&>2j7g_zT*}k$_Rcpey$l`<}KqLk6FTOCye&HzZpCD
z{tefl^|gHbB;0n+Dt)00-+;GC8KU!|r7zSI?!a%&xz91q6Wj4+_}9&JjNf+X$J;9P
zx*EsV<Htz+Xk8kA+spq)&Qx%3PKmnlx2H1kqsZTDi|BP2zvEJXKR|r#8C3<I%lxmU
zUyomnmzm{D@|Hkv4Q$6Br5?38qaW|Wwda)M`0sITPV^6QW`k>IGMV_R_$SQzH|{|T
z@aJ)DtX4$Q*T!N!{wDFYvDl8!;M!R1$1`akZ7h!COL49I{y*`3L0tX)NBmSg&%A!)
zeX|051+LAh6?i#*vl-v`oy~gu8QdGI(f(!pt;2SF61TOFjI&wh^gZ~KeD;5FBEGK5
zc#r&6SQeJaoL67Py|nBbk21nV#^k(@$M+-Y&vUNuZM{wN@U^(srloizuC-|h--2sx
z+JZliYi-(tkK@|>I)YE&+T1mRzk+LRmj35(`kLqAyNIu?lco5<tL^0r&=w*5P<$Pq
zV{>D8@9Vt{FJW2<Q$v_4GmNxp<hQP5o#-P>FJZLn9K#>RZF985_YHBragE;20ek^&
z>w6MEh#!V){h%B_3fKBU9ext7^@BG28@SdF`tX}@TR#X;zA=0)?y6`1UwE$T2qV{-
zMVMvP`Z-b|{v~`dVPoxSocmVd1^7bKjo<WXz?Ui>AWjFKgFkJ?m%i|bcbnm@6N7~L
z17WmvViF&~wYE%ofoHdl_}TdLc)nQ%<9)v(d?&8;#VULh*XH3yNB&X=oss;1HIIKp
z=Sk{d-aYd4IsE;RA;Of@==D5>pN-qfD0!s5$XOQd`rEv@gvq&1zt3r8zAnMNGq)Gt
zjL*l$eNKopRuM)!mu$f=ad;1YHm=Q2BY5?dyTaolx~DPbjT!t}+*{M4ZnS0kF!ML=
zjq9iz{W%Zcgda$q#r9Ojo~RVB$GtPZXnf<H^$>n1?)}D8)RW3%?bw13<KFc}-S}={
z5B?gi{jHf1T>63S%u&Yk41NW!jg|Dj^81?(&%-Zucqx7{ZtG{V7I!f(7vb0O+5hXY
zcpr)Gk0WQu0lb~GHWF5Q)*)dA2y-R<;X*!}V<Yk>p1k>Ck}%DL(e{ZcFY%lezt~J8
z@}1KF|Cf!A<F4ls#e_+}-aa2oy;tKIxHbnh;YZ=x9Mgpdac?gjodeAKf4l}ySWlQE
zqR*A4@HYIj<~2s%oserxeVKg;uGO_%LoQ)f-!LZ+<GE4^z6mcd^Pmi}uuJ?Jd>gK{
zLo@zY+|~{fzZ+i=viGe3K8*WtS3AuRCYLbU{E<Gwo)_2Vr#$?4hnM0<IMNT{#aB4)
zfAM5T`aSr2)RDH{j^GD6;?LmkJL0GRAJ1VO@$>Kx9q~(XX(O%vLiqn2@mugzNBkaq
zuOt2leyAh<489+()nEE6JZHwW?-b?Xi*aq7mg37D9>P~Syaiw9@E&}N!$<IKxNV%v
z7@EPK!EN)i+*1`ZS8m1k@Y(;FSL5@u?799C-gC)39wOY@8zb}h$Bb}u=5fih>Q(k%
zgte6^fH&ehaM#?^MVO5@+2<ZfV+h}lyVike!b}rJn}5<q`F*eN>hn)7UVz)`PRdY%
zFTq{&Plzz92&2tEEqD#Cjh`O8!r>!$34S`|G1tTBZ_m!)H{iBwkhV(yTey5dGrsXX
z+&uht;%ntE#hY>4Iuszy5Z;Ho+Pal6jkR;qFxHt~ya(6TnNfTc*V=g&--B!GOvY=x
z5A{8J9mzH1<454Gb}lE(`GnExsSYnw@{o3D!<XYhKF8Y8Xoo(0wIls8JcQfYLDKiV
z&i8t7ZA=F6`*2q~6%c04+Bta`?Notp#<g~;$G78JJGJBghimQBj~{xo-cIAVA9uA=
z@)*zJ2&1)A7QRf$L+Y^*&&6+)I*ski!Y`7DSK{k&Z9F&NYaQN!ug10UJb-V&Pc!p3
zo?A@dzs9vQw&XWB1HiTUAPav151Q#4{jd<<jcfH+iO=G;ei$Il20W|I-OoA+GfkL;
zG>m>WhzGu}_p?d70N46i%A4HN;95V+#+z|l9mzEm;p=c$KdUCpQ-sm#sR{4LwSLlt
zcRPFtZ+E0Wg+GjI_aCW$=Qq>we6A<fkB$4{9Q*}5p$#JU7g7hs_(!;FzNjJ0j$8D0
zYQ}frT03>)^KZ4clayf?KNWYi!wg~85Jqc<^l_fA;aWT7;Z+VV#mgM&hwznnLK%%`
zJ}vlWTstr8!J8fNNAN*BNPWcGk#>syO}iO<5>Ge%yzstG=BxC7aIcGNeLW9<3BTTq
zFMGqt-;I(zWHa+_R(<4L{==cfJ*4qBJnBj7DZ**zV(s`txUDQw)_(kF_&3e67-uQt
z_ym4lg2(@UjsGpaJNX0my8&5*xr8v<c}XE&ifiYzmH4-D+cn5Ox{vw!3j8~K_W%3O
z@w$rcqpyg!O*d(^6V~?KbE)?f=DA<s_exq18fi)U+!;<s!sQY!eO)BnJ@#-?znTB!
zJ%7S!*It1C2)Dg^A@M8lZoHV!vA!5Nm<jM-_4qh`wdr%-gXthl)@^zj2JoYCt^OzQ
zlW|-9OBs_Vcm{^s>Qp=n&&F;0B=N#Xd@cV<d>QezbDIYIIy^{Pu{tuwYX`m&mv)PJ
z<ULC1KR)KOO}N*8{`n`h|47(u!j2I(v>*NB_eR)r*3Y}c-#Gu){pVH4lQ6liz`wZe
zAKJ&JcmGFP0o+ULPIp>Wq*Zmho>o6;mE&Go7rE2wA+63I+0&A8kKjMUwLUw8Z^q9c
zY^**b?`BCI7c)Qh<K7s0eK201#u$=(f;)MB)2R2Wa{M^l)~^D@ufvbUtN0u%hvZ?L
zRkssn4PmtTtsn2jwfSuv|2OU$U&;UGJnIg<zOwLaT<hP3_-VLS#!CElT$=+L@TYKB
z89NE{5n;489mHpGt&EfSA?x>q--C$m(ZfgX-uZCKB<};_340r3f0>P+fotg(;g{mJ
zIY!#L3O^TLZMJoIp7UB;`co5O?sBBjh5v9LX$%wQMZ#!%n`!)SxON?B|6wnWYwt7U
z;xo9mhb+PO;#xh{;K$u*&tJygAaivPf0EDs@BSfi>_zqs5^kDse~E^>#vV@Ube#Os
z&({B5gnt+JhYrugr_Qqfy@&wm7vQPHujF(5Sy18_t|Ux}Baa3==<p6a8~4s5qtAnw
zC!*&$19*`m{sf-q@Z`67hs2S77GB_pUx?>8yb{lFq~CyVqt9sj?GF55hY#SJaqa$i
z0w1Lf4>H@x_?scgQ=CmYJPYqu`hfJYLVVZ}zY_0rcmv+)NWTLgbi^OPdmKK2w>#2L
z{x9pDBYqa%<?uqh)scQB-s_0pfOj~&18;VuKY&a7Xze?Jw>dm{H)oBG^t13=SVOh`
zS%}LTt$8JWC9d_)27H|(eg}TN!w2w{O8No%=LCK`?%HRh?BU*?Ft+te`gk_pk8A5f
z5x&C_zY3RqiY>nECHtADx8vR(_BX$a&-<2ppdQjnX05mFtE8+W5nsgT*uLs(@q4Hl
zJjt<_NT2rmd=AgUKXP1aDL#d3<qP3&JL0$CZ#d%j;A4*XBe<(AXK-mtZ7-GnPPi?!
z^MO44DJA~^RbGmB;;!?7ZsugELvNjb`M2@*mi@1BKG05DO|*q}KG2WXJNm+S#I?TQ
zf0wgYM_Xs&wGJ=9Z*q7A9>TS{tjDWy+qjduY{##}U3KY``HwJOUEbfP*5wpwx%RNB
z?{RL$I;y=Zn}e^yZDUx*T`^vbYkR|L{03ZmU#<!N0ltK^V&m5Mes>ps53cPkhw$Iy
z+TL~wAH|O{(+~f2pmz_DI^*}fj%$189Q<GSVl%$+UQjVUi>ud<&tuPOYip^$Cj1@Z
zYx71IKJD<Kh--a)3g1P1ZQQ56&$*!DvgfX3-rR|=;IseIZSj5<zK`*CRB|1qq?68d
zYW*aHAAxK2)PjEw*ZN5hegdxblM(zZT<a$@_;t9}PtreNy~MSCl84`cYxP))|H$DX
z{D%&2!5eU`d_DMPTpOn&_=C8upUGOA!<=|8?ya?V^~T%LvessP$ouJp)%s)s{syky
z`&Zz{HtF~N_4p<D)s!nX=I5UO5oR-CwE7;vTXC(vCh$jbTYX4>O`he<6xXgX3*X|1
zUx+t5yb@oBYyGhS-|C3pfw$w@yflD6jBE4K1m5RJKly**{I&04XW`wB{0s4Ij{Ga}
zAzT~J4ft#LDP|w2iSO4s@DFjV{RZ$|xYj==@JS`U%xgjBMah5ZJm$5ZJQ*Jk>_z5f
zhu^RD=0Czs{bbMHX5#qoNDP;>E?(Z!k61^W^}mZ9!f(R0`-K*KmBV}ROK`0}jNlcx
zwhqkTm*Xdy^=<s_LHb_SX-E2b`1f(`ce6|Jb-30ZA-o>f=C2lf1Fnsi9()^aJ5QAH
zJc94SgXZ<oma*qw_=2C>&(kG-x^KSkQ2a16zVSCy^6+Fl&Gd7O_Qz+*Uz<-t4wrs5
z#QZJs|0-wn$2<}5kKVjE?^!vY4-jsKa1U$@e;?Do&<Gd#O@0ZJ!QA(JG|an?$I~)?
zw?BEm`M%wR(f%e_7JmF)d-k3{da*frRrq?PymjQU41ZF}yV1xaT;5+rpC?q4&Txx8
z9jW&wd;(8+_Dj3T7E8Pf_uZ}g5T1@}{b~w78b6h^V%H&uX#7*IqmX&B0B_;5|8I}Q
z>q_oPZjXnnCR{h+8YSHC=7f`%ZTWvGZ+Q~s*`&`~b@+j}w$Et87vS1F(T9ITIkbJ$
z7(So)+C1T#H{W+K?tSk%dM2LqE$;%P`~mzb+_ts{@F3oaXD0EFXndJ77beBhsE{zN
z`dF#Q+i>j~+wmrc_v3XAAIGa5?)T64l{-8WFLrnV9>le^sRCb&Yinygo{MX3)Q+Eu
zYioNyF6Gnuz&L&pu9eR}f4=W5T$`&h@j~3Tc1s^9z*pdMPhj?eq{8?(s3c5-qYMrB
zO}MR}Nk8ns`yKHI@W=5p%rY3iwJ?E?;;ubr%Kr0xfqV5eD;qxo*Y=o2_zAdH&sF&6
zaIKyj@k~elo%oT8XLH?t<~Aw+Ut|tG^U?U+Rea~X_5M5NH|~Gy0rPrfCJxU{v!u6u
zvwp6Ualm}vW4N}4=i|S2cp3gEuGL2^{tH~Ik5+t(BYrR5?1(=aaqS*-7T-jCZQNue
z&-eWtxAlAJllk}~xONX(hChpIdzf1Mzqr<)TJimVrjLnUycpN&cNAZS+xAES%0G**
z!Chk_@G-^}VYEIF#Jh3r8p`oM;GZSG*xX?JR%ac)!x6s?e;wD}o9M$2ZPV*$3@^jA
zI`SPj-?tpM)seUU;cIdA`te#^y?%UyBmX+Q9@o}}Hhdkftqpy66TaB2U*kM#4Bz6&
z-**sW2-n770RM?2eh~iwu8ooMNPO+St`6^Vq~C^1`Oh=2FDd-sPTHpre*s@;y79fz
zF?_(`zLfdCZFta(Z@kwUz+ZF358}gkp&8%USC`|nxXjP7{vY{no0Pu}PyV_7dnax9
zk+{}>`|vb}kKy~{7n}JTe@D^x@%g^5D4s=}Qs&4I?wu1I@L+sRv78eXk=8cCYJ2Z0
zd=Nj~EXz&tJwhWs<%r*je}v1PJ64xTx5n19L44H~y)7p34fv{r_+O93Pg%eo0S}sP
z+%sn5v$)(R#PT<O%dQCb{X)NItis<>@|U{qXFmQ4@x8jf|5whs?jfyu!fJIrf^WdJ
zx|+d1a>P$Rc)stTcD=6h@C)&vSr<lKmEzaqT3v<koAATT_{RNp3x17~ztq(f^ZJvx
zS68=nsC6Y_GnfNEBCPjb+0{l^%lmGrsq=kj->2`1a`01dZJ%0<ufw(RT8)QrZJ*kN
zZ^m6~ayMb#B#gEu4dY|DwkA#E@8H@sq#eTj#{K#=<l;HFb`2%?3fy%KA;N4TjCKtz
zcnhvwLl6ECo^SRa<305ed<U-W?Pl;-kI{dJHvQ1~zL#*@?+eMiork}Gd+Sd0eH`QY
zaw$IGNI!&ccX$iFnDT4ua!<sy^Su!~oA_G&&fv!?E@QTsxiSlvdpiG_zl@KsInQ~5
zp9r_Lw#P2V%ScDtAJpNiaBUCWhS%ZR9=Z?j#I=4hhHuBU^A%qjdvsjeUj^_#<J$fz
zh`)hrW2qcJw!=P_0@Q6Co`Ji@N;_f738S@TKYlr`)xkJkgKOt2{=+!qaipJ#e;rTQ
z!!g&(PXNhSD8Sd^+MHK`SL50qw;o@EYi-bu*Wy|m^yBMst&ff4t$0HDjb{t~g{&pG
zR{l)<L0qff0=&-=zXIQiKSo`}_6<p$v3*B9e&(<C?7bqvSH!#>Uxz2mx75FUy-Vu9
zAMeDoxbKgpKkqZ%jlTFe-u*!Mw?AW^^lLBu0Pg=J_mL0Ixd$Tsq-9<ZpM=RGOf6v!
zF!PWw?}x)kK1GBn@3hymti$chx!=RRHT%7`_?%+dOSX{KcEW0P)`MU4kX~ma_(r^n
zeB;*~-grw{XYe<1txnU^*_S`8*J&P}`iQ+wCH+#o6A$t^mOu3sef|)_2XR}U3lOCR
z--ajLml|y%dGr!yCt*(JvzdpyE)n3rM)CPwl)-E>`Hj>s#?OF!pW^=FQT^SN0KN#<
z${EB{@ayN4!TcUjD|7JWgz?@@Ip}Bcc9-ih-t%cBt$`zVscqhgUv|_kb({?1UF2h%
zi={p$@mk`aD`kzY+2Qr<H0i}sr>TqP`+i9nZ7k*B4`uH1en&S}=aI1_@r&`FQidR(
zV{Wv2HU1c`)n^laKkjPxZo&)`<{UGR$Y2fdf5Z5*l+imgiC(AF^;z-pJVTgi!pxXy
zNSK}R@tkq^d|wawXzwlM<5J(+wUpso@Y=a~tPbZP`-~pu<_`$d%V+;V_a^oY<9CTW
zNNfF8dtOrS19%;-tuYh$Ex5MEBxlU`HR6lSvKr?oS@>p0{)KoGuI*DQ@m?i<HhK0j
zM?Z{vXSbhejn{*6cH2XG#ohXS$_RcsZW{|yUo&_kZfiU7^iQ*<;|cSlah{%sx8tsT
zOBrD%2&3&=YVo&lZC!1}3mJ>r9=sPXz`ebr(a+_#Vx>;gnE!f7->cKtH|?`dQ;uMM
zd0hW~NH)F_*ZNQqzLWXu81jzIFUId|R^i3OFAz7Ll|_FSrx70}zU_LXO*$j#FOc}r
z>y3<Q@j-mVk^dx~M*d#>SpM<xp7NRbzTXmG`yJ10{LRPo`Jf1Y1=sdrRrmycmXtr5
zf8@8OrTmTfA(T(+vz_=QxYj2J@jBeqC#MM0PZ+IFrUuw|;I=*)po}^A%eZTPE+LHn
z3B8}x;0y56NH10o#&`9b@h{@GdluP8O)_^c#=U*ii7oMdZP`bSk=6}_O(<{VyO%Qm
z<}ojJ;4As;fA6k%TCx@x=k!^hWvmj;Rxi?ah4_cK)^?S6L67|$H$eOb{94@AcAbQI
zoG@D34dUInR>nzu2d=$GoN^?4E?m18&Blju+ng!$O+9n!bNK!2xBO3RjMwG4#`Cuy
z$M;^fq<895_VP$O50l<v+&j1Wu92SQ+-iWd*8awxmbA|V{vBLvpX8(F`<}wJv6Y37
z;jZ>6B1~ql-ab|Mk+`jWr2hJu&+~Av{(kn;eb!$u>2*DAzh-a#XTEF4z4WfycX}zA
z+>1Y>pBZK2N8#GDs3Lp?zL0B)jcemsL=|4-@J4(YZtGvthMjmWuAK=DMqGPVGKp6>
z@=y63^Q*(N@nXdTl&=Us1Hae2-(Vh@cW1oMR}-eMPp_jU{Bc~`FII=f^O7!nyTga@
z=kcXxe99nu0;$6(d;-_%IQ3}OFkIV5=HR2awg)K2-@+H0`5XJlYJ3LQ`cM=8&kX&y
zyu0wf;@X~Q2p__|bHV5y;llVDKZWnWi==!}H`W80$KS>8hW)2+NQ#A#^&s-w0aA~7
zpXd1l*P->r(uiy4lOcR9@wK_U1+R5@4}O!wNAM7Sv|ML&uMz%}6yAN_OeBA8uacg{
z{+RgMT9Ait!M%Enrf+;#xD=OuXq)S#{zCZQajhS=;D5!n`t8Aoaqap>aOuaNH?QCL
zPWcS}2CiQJG4p+I<LdR}^MC8Oe*8<gdj0qrxNVOk_0xi%jceni2VaY8*EfQ%bNCFt
z-r?!Ta(?9SJbbgmOY!?09>O2O)%M4KhHLHHga6VIe+0h^*ZR*4F4w2!pMD(gYdPZQ
z;kP;Bm*O`%;)n2%BYq3M3fKBa55C%w{s{hUhtJ?uj{MWJIkR%a&-;Ib-G5x3RsHz!
zTewFw`6w+^nq;?=7Ah%CG@LYX(xiDiani&|h7*-0DJf1|G|Azlg^I>U`4}x)WN4&(
z7bzMk85tEB85t=VEt;e_N$)958sFFZx_?~fzPsMXKYToH_dMrZ=e*Ck&ULPHUH47I
zwf-r`tH@tqo`14o&i^~-Ki+_A=U+R%6W8X)eq8!T>%Vb)E3Tb?b9gK6bsY;($IOrO
zd=9TM>o3;;V-6`K&0f-IF{r?&ajlIF_}jQP$8_Ln&**c^0A7G=ZJfZ@;o2CQ$JgUp
z{j*M4<SWOuIi?W*Jg&8`0{<eewXXr+j%(MD4*XGEYu^AqgnPA5`fvgt#%+D*JC%Lx
zpL?&NWt;|ZKd!~72w#kAF{;ErfNL>o#6N;-G3vxm$F&#@;#c5Wj3)6dxL1s%eZD--
z6I{E_1n?i?+Id!le;e24*-CsDuEnnr@4~hCb>ct3wfGI<PvBboCh_0lTKs&U;JzK#
z;upZvhxGUr;TgCVze@Z({0ND4be&}UPI@DLI<Bn~JMmL3`3Lb2Tk=oh$KaQl$4^@C
zOvFzAuV4<qb4@qyHv;(Oxa^h0>TkUBQ-p8Ak1{>-9!r3KtHdwCuQgrfQDZIIM4DZs
z(dPOtyaU(v;fL@x+-r<V9j5Rd_?E;v7{Aq4#9TN|8s{0!l{?&fZ>ekK8I9~oRFm!t
zzj$lmmwfhLVx)`hNrWGUNNg)kWA1oXuXh7JPg&Zz*?}+M+SnSvS5Usz?g=~_x3#-~
zIdThWoOa)TyJx$lEjjr-5B#ORXIFxsh~Gro*f>d&yUy_Sz8c?#d(~CSZ^mnJEf(E)
z9j?tY!}yK3*Pdd4@&n9+ZTQ)I_W!2IZKw0sR>E~mJDvR$(rEX-x%eJS9fB5@^QVhC
zNdC8^4(A(nkTDkdO=*cm8|7>p*6Y!SH(GoQzYW)78NzqqS}Zfp;GI@ni)9US>Vvow
z%X_zb#<H9;o*|7E%X)kW_ga5R4BGMMaIKF07MED3Gw(@$C)RJ?=GHMG*1k`&&ij>K
z&j8+G@gjT|uEn|%-;HbSXvDvRYq1`u9nauStj{#sVT{`$%6OSHTCAt=NnDGyzkug9
zxK_t(i%YB<m|rEo6YKx`sv7GW%6aV9dOch4ev9|uPvTzJ0jY<d`EC!sSw066>QNEC
z_mDX}mvkZ0InNJLjdTgm4<v0lX;=OxvIjlg=(a63-@CsR7(A2nYD8a4*5J3`+I6l4
zugAUG7oaXZcr9+5&r_KPpCOGipI>Oy*SL<!`87vb7ynkTOXf<}1-Mq10(>oQt4kYo
z=^%|$m%rZX#x9{QO_X)Yb9!C6@LXJ5qYdHb;M%oi3O~(~-+va*S@ENZOYGWZ>|1B!
ztMKDZH=Yd@<7ZpSufogl)n@)%+<W0Bd<%Z6=~stc#`OgA_3gM5#~*D|<2XV&NB>Tb
z!wjB^SDD923NPkltQRw<265-SxW+h+$9Yjp+IymD&(qTeD7UI`5#JTke;-bcJxF<t
zq^UcMb2pjtqI<I*=UE@+4ZnYX_<g=;y2#%nl;e%z{dhH>W97)0i`=_QnmN+Uzek#^
zPw~CR#rATFNOO?B(e5$jSXHE{e2;RPNz?TnX?jRA{T^vXNt1iHz0M)h)V@cW%vC%~
ze2+ARq}lu)ZLcKF9!nbO`vK;4iJ|kH@7M-+e0%hLFXgQn)#unzd?l{E>p6>`h--62
z`q_(o$Ku)?orizO;-&a8mhx-y_v70ASSwzPYxiTlcquOPLTs)w?#D*)GF-bKo5eqa
zuQT(@xe@;J?atm@MiFam(r7Wv$FIb-7?$Cm#kCmL;TK!H4Zp}zejk1=uElT+--c^3
z4B<O*EruEAus4otG0exe;~NrVXnfzdoHUP-Mq3xw<4@q)^XPUw>Gyh!`|%L@*O+xM
z-cK6Gmy-V))5GujT_RT&Sp&?I=5o?#{gkzuch_<4x?6~U2`@B{VSERn0>2B__I4WZ
z`*3ZXb>O$-+Bh4)Z^pIyPvBedGtK%Lzwt4T-)$*B>s;=m@N>=loGa1a94*AZhiiRU
zf$z7J-+)izS|4`cDbL&caF8@>Nu$MJ5--8EKIF^mzRy|m2k^^qtq+Ru3oQ97@gT09
z2aWiJmi(RgI^1g=Dr0yMUxRzqFMv<t1-NaUTF9KZlQhoy>d~9r>rcWuHTToJAMpq8
zzbPnlNfYJd;1BcJzuhP&eBM0}J@4u$=V8)$t@or&ZTOS87PCJ5DO@|R#_(rxZA^sl
zAxrrgYgk`d%Fo9~aj$o(r2b{NZ!BTYl~~Hpf{54Qxwu!KNgPL*pO3>I=d=HkI=4T<
zar}NXjsukQ2<g1qDdosK-h(faHRXqma-?71ky66@KK}FQ|36ype<SX79BEH6-c0_u
zcP=7->r?8{K|OZk$4foBZ*<!u@1m!>?}oHcPR9!gaf>`t4^U1IK8)8=PVCz6#3Z>=
zN|CyZk|tyPt%V!;97~fF{-GN2S-cv*HO|AE3F7G`90M<l^Y9P*NL#9zGw1Qcq%8+-
zh-*vIY&fQpu9b8z{Q0egZ}8dw4<nt#{&qL^jT~?Fi*GGFV74ha{F0c|rxPD|N$;D%
zh{vtJlicq)Oya2%`rr2UeTM6##RGUQ?lo4Went3k_(gnn;~icIh*#pJxOVT?h~Ho-
zzZ0**3(WF~q4cPfKZrNr+TPA2z5`!j<~QEQ@vY^1hWH0fkK9X1`2oBIciy*&KEDV*
zK5*6$MR+r=og0<79AADf%#F|2odF=_H{u8J<4rg2tvm5~T#Nr8zTa~ENqh#6i=Xiv
z+IK#C^ndZ5)1CI?>A1ExR%CHG589b)CBK|+{{7dx=Zl;N#@_>OrkrZaak}5bhb=Dk
z2rySl`S(jbwixvY&#8Avhe&(VgFFXO>Jh-JDMwt!yZ<bsoXC&eNEv06k@B+MXLa}-
zWoXaz+9LVA)`e1s8S3zMv<^SH&W)*2hjGftw$xz`KN{ESka<Bkzc#K5@MYxJyc`eU
z+Id-zpM(c#k9%I68#^!B@eTNCriZ6-r=R-q&G;Fn%NL*cf9Zp9ywOtr9NuFoKXV=L
zDdO6BQ-F`-TKvlKeYjU2O8x5bKjL2VP5^Jmhw->IhMY6Tck%{E6SAa{<4lq!@K?Q`
zd>1l*<Jwv*fS-bEYq27H1+J~dD)E(gTstD~8_M2CKlAfu{BAz`-@4Wv%dx$Wq%TL$
z%^u47EorqeH-eAg+FE%AAHu!n(g4R#E9IUQx2=_{nNL$Eqx;K7eWh=V@3NIs*8h>t
z>sU_z<6p<MwzT6raV_rs_+7X*FOTDQ;^)w=*!dOtj)Al_kNNTu{A@n^zq{FuyYXBl
z>muG2C5`r6r4S#%wR5}ze*xF(*kExP8)MW_@@LChE7_=HWIr}}iMw_jrmW}wrq^{E
zAGLVudcMz(YyFXfOMcBua5=tqFI<gh?$yUbGrkzt?uEPYJlwXQF+!R;(r9&@!EeB|
zd*QT;d8f~kKNsJDYv)%G--dgQc^Pvxcr9)_zlNEYpCOHNFZz*ccU&f%U;UJI@!$35
z?c;biuEk;we-QU-i>wz)nKyUg;b#ulsP!l+qhF@<<5c3O;9m2*%ma=1GF+QKJMoin
zulZB*58@l~Vm`;tb7Cc@u`~bU+i>kV>-#MC;<#6zN&W!dVeumTE?k?ZD)D=9Z4PL}
z@4>ZsYMeQH5AMuU=UwgggE3DHQO0wm(dMZsd=%H_DgOrEmBzI?W?NjwN&|DP<bR9L
z{_kJq)=|c+@m@m><vjQgy`C+2x5az#hjDF8k3{l&jcMu28N8GHT3@GKLSNx=b4=u+
zk>t<C|BQcv&#|!<d51_mh`(y7UkyHuYxQfvCvmU(1t`A<e;&8ZAF0f7+4~~r?a5W~
zePLXm=P2vPr1LtKv?a5g?_uNGm?*&K|MhzKy|(BxIODsR<@l?(_V;M&@jqJfx8py@
zweNBC<IAa^w!R$4kFvCH4u2o6jit;>xrf2Ez2gG>BbM^Z@g?}V#4<KkI3J>W$MyK>
zxOTm4$G2I^@5gI#?Rq(m--pMI<?y|pyZ=v`7fGYVAZsIQd|bO;7UHktg=QPg{eOJ%
zEBf5tfPVmwtD|wgb>QW=cD@bZU%<67Jb_o>N164DyqhRvd>&tqtL?vxy&GJ+Hz>p_
zac%Cez^icW+SY*A;M%pV1Mk4&u3e0w=sxNIK8#nH?Tb9mmw7pZ`7Ukxt%bW}{diWT
zI~T~l<5%3ZqrZZ6(LcR^vq8$KpqzX0Q>C0Fqa5mze7svuka8Y)Re!ElgYUw<&WQlW
zX~BPnU&rUzITIeU&XarTvtH7qz2<#iDs@d|UdzUZq^?(eKEBOAa_c%rIfFBLn@eRb
z#;=ufaudqg=$2FTIgYnq@8e4RWZbLG(w;_q9qu)T19&H1gxg{=M4FwX*-H9Y+#;Jx
za*Qc_3NJ9-*aP!l&Rnk4LGowg`*H1gYcYP}8~XFsD*Oyw`X^RD<C%36z7qF3PXlD>
z!cWE5nfYaHVLY=QCe06Dd)?XVj~ydvKDM7Sjh{&wMG0ld@6iPKx75#b4$Qp1@RE4+
zdM3yCy;Fp<r;<w=TRVcdv_tFb8vJv(*4Higg}AM+dr9*>>Uo4&Pvg2finrm;bvxP)
z<L~>-Mtqf-pLWX6K}lbySBB%H^>rRzM;&t|e{?_Ccwf8}Z^X4ZuNH5{z4}^?-->?)
zFEPufe)2P!;=TBTxHe~x;$8R&W`48%csH)qFZ~MM0me@@^KS}|0U5v5%((;j!+iFi
zaG5*5gy*T)Grn@lSv9NIqaI(4YwN3a{2crovmVC&#VqyMgr6<-czmN<597XIf-<&|
zM!PSV#~X3&z94H8^9rujvC!hOf6>MqEBT%Mi(`yBdhA~`Q`T+&((BrdH(7ib-+^o6
zVmgvvTYINo$#WF)Yv*PTejRRGdp9x94wA;XXa3}+ZlB0J5?OmoTzW{i{>?~SPBzkc
z#HEwtu6@gU4HBTNLHttuvwV)7k8-^8+<9w?G%ruT9^Oli&IzQE$3SvU`K#E2qzr8x
zl8ry0)IstW;}79insrDDpLF6?_zbS~O%whquJuh9z8ClE8!3MXAH%hE<P?5vNMA?#
zui_aW?p1z(^0V>daNE3GLYiu&45?!^z7f}cueLdoe<NvQ{g@Q~K~2fujqfJ^>86Lj
zUg2DuhVjR7EymOMW4IRM)T`MK#kCmZ;GMX2{4=+{Ng8MTU%A0^{7YNvD68p!J~y`E
z&A2x2^x=2l+T57Nyw;67bK^Uob?afwjdPSSL>g^w%)EwoC~$3VEWk%`t&Zgum+MF`
zb(H*zWqo;xQOEFg<e;3r601(i+4Htu&q2J;;*<DexOP4CRr9V1uC*h8KY?qpu4i6-
z5qDy}tIRXjRh02IX|z~3;d8ha>n=R$9lef27MECOG5<+^XMgI@#cmyCo;3ES(!Rhx
z8tJrp=HjCk58}_`+BsMg$*-M*E%-3`wR5lse-gKygQ?7QX>*Zt@Pvf6n)^SLwTpDx
zxX9ehe1mJ_q5%I6u8oUU>hTQjjEl$DyD>M;!3N5BnKW9wJMc+d8y5rktGHIj35(0P
z$Y)NJ{LVRej8Vsgb1?f_p7Z=$uV*p-oZ@nv4vsU5JI8tIA~zNZ$7!LQJqPvU^x%EC
zcAXx<r|{(*Gj<IzzGpduzlz7Lt&QL6Ppe_i>fMC>2IDt9a`9ETHok*+A+GK9*Wh`$
z*V<d+G{l@-fS)XL;`d4u;*@->+;z*G*eA!C*N-!XFPnTl{I|)X>zxb3>mgZx<uWH8
zjen8P{_{CbG)=<y9OPJmFA`Jgr0p{n;eWur&RNM{iT?uEV%CWN+~S@1&v0#@a1dWi
zEVScK;`8M98Z!av=ev%z5BcNPPT_GG+b7H>O)Y7(HWcI6;o91y3g3=vZD_(raIFnp
z_*1yH*Exhw;kGtRlP2dsdK*%&XFnPDYJ-f;O6JQ#+!>oEtW(EkDdiL$(#K{kej2XD
zq7`qzwOI7x*WsU$zKh;}8^0kqir<fWwL`{!4s&7;?tItc3m3TUh`n#%exEI?mh19@
z-j+iAHC$^;1)lE<scmV%m*ZN$cHlwW)~|!4X(f#|HYf4BaIbjC`RV%-e}f6v+7Q5J
zaIHUz@RxC|4VAe6Fnb%CNK--@tqooH8r-W5(x>yx>lL`urw^TP?bBJx>P`x&b9DL*
zi+tb2wRq&=Q@9q7Qv3y6i$^U!kK6jRjWk8cdOZ5@Rk&9?<XlZ-&MU*6bM=R7-FP_j
zntL6Yr<`)X9*e9S7x~V|wOAD5ZMYVT3Va8y#i9Z4!ELeVB+V>ow6QUW@5i-RWHRsh
z7e!+6=x5Yeq}K6XPl_Ik9Q<9%iTe$C*3YtyEay=Po=JXf->@3L7}xd<oAF9q`Y$%G
z8GFRtcolw>>Bh61VSFR5-9Jy`ZFt<;hx%`g)Iaqm_VsYBFLUrmaIJkM_&;&2ebxBe
zxYoXA{2;EiuN!{@*XlovXTC3_u2ZJ*REwu>S>$_%@=r12dsTSNB>kI%r;vZ8>Bjr3
zC3pZ|VY>02aW%dI*W%lZXXDyhzZ*XVj~jo+-!K@)gSd8{Oyg^DZ5@|-Gkf<I&%sZ`
zwfL0a1-KTUYJ5Ge#itps!nOEx;~Q{oZ9R-j`?UB?<7K!Oztno3f8bjDa`0MQi(d&|
zY4K|OLR^bqGk!U)#jhK$$F=wk<2!LJe$#jZuEj6)mT>#D_~qbR$*;w)1aHT+_*LWg
zS?bq}H{;s<csJgHYxlat_}6jmemubZ*MmFv<3B#vy$%@n<7r#je;|!^Kc0*K8rNbJ
z#K&;0jx`pSd2xt3N`7ab<|w0%3HvmCl+&52*K-WtZSfG^g==$p#+Uh<i?}wI=i@WD
zHkX&-v$!^w*Wvr{0&}i3p2xP~hj4jUKXxrly33i2WiIZ+x4d7^KZf6hYuAbp{ur*d
zzk$EYiL33$58-P2@ubC;_TzKpSKE)LlV5E=-i%)y7oYH#RwO=S_)l=J_Dh{}nG64p
zJNwj67rEzxj5A}8EbA*g>pVQ69Am$v5bwaN;_4Azv`9TF@JUPl20S$_<oUM=bEF;A
z^Bnw3eD<Ga)H7k9Lelz}-+F)ddieJfK1kZ=o`%PLU5Mk(jlLe9%cJRx@BCzJ<2^Op
zIgg_rew^d%N#{rWSUGOgH@ItsGW_r4*XE)g>gxaf>(1Y8@qhVjx30!q)J_>$q;clc
z=rJyJkI|1W#h06PxWe^uJb-I;oQst2<uXP}nNKsx{|2A^FRgOxm@pR=-AW%@>RE}u
zthn@BKgXHCo!`B<%{Y!nzx7a7_8+|aP0I2!uVvs)S!?ZO%~4jxm|j*XWd(7ktR?oc
ziW^y5|4}cigR)-be0T0oU;LDNzIn8<m9oy@obkF&OB<&ttAJxU_1aBY(XruC)&ylW
zzM$7DpLwtrcgosqFDvJ({HDmC^s*W$s~dO9T467%j<ROQ^|D4NYZ7<LI#_6J;~-__
zyr`Fz$y}I;J7qm%FDvaf)^IQBWmQpDDejcD(_U6NWwlS}W%W|lrs$YhPg&8uERTNd
zqO3=lueC8TPg%QhXM8QSmo-aS`<3w}b9VZ6o;BmzIxG+0hihw`Qv4sdHurTi_ogtX
zJL|C9&T`vr%zbT?v5Yj@I;;=R#<g|W7=8+_)iGponfrpwjgsG4hwWYI)-hr3D{SJP
z)l$z2eBR;>_#s?dvv=UL79YU(;&E$o>KNUVn7|h-`RDO}Sv>1@u45K2#Q&IheB++9
z0)I2njruj<NB)nc{rF+Hc26;Y`*7`f;sidY)IUH!&*QJ+w&#iE%%O!G!&xi6QV>5D
zjI~n94!)aaX-hT!G_H-wX8b87ztpuG@5R^iIW|{>pHn#B2$XYogfuUcMvK=BK7niT
zO1p#m4@(_#@n>;cyqcMhGmnVG>kpq)<5f>t50OqA`|bEQE#8mciEC^4aeNrp*6?%q
z7%t~~ES|=GTV^xwe&gCbOacBJ-eBfW3cvg<eNm2|bY#NXnXw<;Z>z`G<Jx{eJ6?&$
zo!iE_)sJt(wfK$WwYXPb2dLj1UX91aPv$q{ci*zUw#e5>8g0xLzK2)f-?r4T0l!Ca
zsbdGe9lw;%u|ASIp6{-62T9XU8g0x^;*a6qGRsJ6a|#H^zwP81O*;ML=X3NL%rTNz
z`kge=m)WE#&j>BF@LV>QCV9K_60~?RK6F%Q;T}H6JgGUBzY0I&Xg!Wi5#JP-KfKtN
z^1JYQOa7sVdySO<`KR#v$p00ye2JrR&z<^p_E$;cHJ+r59DFa{omj>LZeIjRbM-MH
z&v(3}j2gTSKhlh2cn({TQsi75W=^im49C*{=xOou$M*2CB;73OeoeXsKKt8@biCW2
zwBN1MB*)zSq0quA(#85lzJ$X6N^E^Cyt9bM-HQ_&`Kq~i03XM_&Li<6eAMEV_%N=G
z&qn-NTsy})BOa8xM#rb|PQoDmCi%UdZ%h3q@nuUx3q@vr+86yhq`o_O4;R<w!2rGn
z*XF?@yb#YY%Qw!?N<0tO+SeHIwPyaLbDRze@NY7YZzO*mpZ!1iggYLRu65E#8;2<4
zVba9SWyWuOPvQIUGe{eYq48S*{<~PG;U6<S@>_{gem3quR*yk3{%=e9RrrzQ_u4y_
zxDPNFA0mHevfOLuxownr=-%X5ET%}e<+zaZ8`J*RjC98DOpkJ`VbZKH+hRP2n8jbj
zz3L)uO~0G-O7Q@mhd+VeZk8`|$<0nRopZQ_Id|ztLgBwDcb-vCNoV}FNdsk-ldjk-
z>&xMCq%IwJ1Mc-My7&OzjC+l(0G`3TCocC1{@<MH#?{y-@wKv7NSZTA6B`@GZ=?nA
z??=jrxsksJ-($&NiT}ouzY+f<uFVgf_?X29@#ih&PvR4b%h)Sme%yz%W9IY!;1oAT
zGWJ#^#m=#udl;j~hZc63aZ38%n3v!U%e<fUN?%puyK(LM(u}v^*O}#quMN(b7~tP~
zNb|BKjT~o`G&v`DA4hx^Uy5t<dHTJ)1BQQ^w6XqfaK~gG{z+V$YfAAOaBbaLi*LiV
z`L-3m4cF$|Ui@af#H=5E6<t@3;@`%-;_S2^zZX}}|8InkuX!H+CGu<Q)>6C?*Pdh5
z;t$~3{M3r~;9C8A@m;vrUWn8GxU|n}Zy-R-X7LWZ){I|xoK;FMOBoq$?EjKRJ16t;
zeYjS~GJM?Pb@;C><+tI(xHd-n@Ig!YWB49C?!5}*d!-@#-?;X@(v1J*ow{s&jOXK@
z#<ekChOfu9F<ysnz_l^nh6nM_nSGR07MpAO@SS)?oL?OCG5lFvJ4ZtJeq5`6#(nJT
z;9C9j@k6**{d1^O3v=#Uxbxg%^NH@9n(*90##$p~6?{}5OP%;hxYt++kbe+ghHLYt
z9Ak<!HKftbY5)D~g<CuuKOfi5`C@z{uATE$cpa{t^G)~;Tsxn-@OoT3=ZA1<pVv9>
zv>)Gsd)*(2``fwp;9lpu#5fzj7mr(G%UZ_Sc?sV~l#u2r(rDL(YW&~0Hs+e~l;!%E
z>&6%3USm$$FpMuyzBcBk@nfFVzc-osfBYT*<$Lvk#2^PhNcrpe9J?+i>^}ublS3I^
zag;jN;LCBZu`J$#A7`mU51x+O_McLj+cuHL*{^%|qwcvU{blUe%~94{%CV#_nGdj!
zjcaSm0(=U$jfo1<q<_pirgDr1JPG%TM*#1@4|0sSF(vJY?9s^lG)H?sK^b3^_1njc
z_R4qME8O+lG-Yi$(fb^ca*CJ}8}a{<dyxIvZrr4tdAFRrZ!Yp(l^a@kiafD#ko4o&
z+*^t#e>|lAo?$KS$4@u&8{gw<#Xp2!Y<iOWY`Yf^;$GuaVmgYi!nO6=EPf@f%?0Tl
z#39j%d2~-b5C4{O`~b%<#ee$D>kB-EapOb&<Wt-j){*8~%FyPkHvA_1c#4R{*tl=%
z!?)mC49D=V<Ezd5#@|~A;XlN+7-W2l^+}=|G04YX!L>dp!(X&`9X^6<*ORtLeyx6e
z_#FAQ>)9ASZSfHPC(H3OcCo(0wd+|v?mI=lo|WNCa4kM{xF6T9XKlE&&ue@H=+izt
ziTt)T>^N!Gkw%+~=kOpNH@6sjCYj&nJBGM+y(+-laBYoLj<@65^{O7f6Zg7aNgLbo
zALCjZCCvb74m;I82Tzjb<D}8fC0{4c`f%-B3gGABM{~T`xfq#$r4B{-nRtWgGDlzM
zOo`6@L=|c7A&nO6CVT|fV%>$0<65kT@CjUt^%VX*?lqod&h&pLoL}>7e4izMF+PiX
z^`(?wg=gmJ=W7$5YVj`o9m?0{iy=IP{Mz|Cg$M8zW*-@QV*cH{n~Q7bYc`&ZYv*e*
zF75M*UqITAFT*#O$Coi;{Jn%`(v*=#J72r;^|&_Y4dbgVK8=3@*J7CZUA}XGYcb5h
zH{x0hOYj<8i(xf>Ij+U98JG5X#ZbmjH(r5j*MwnwE3U<F8n4H-b1=1Qk?%*ib`Iv?
zgSd7Mmf%CUb`DnKPvF`)(v0uLwf^nKpSSoh{xe+b-)Vdl*ZMd0dprxrwf@b)=W(rn
zOYr@;*1y%bw9l)5<s50oXK>p&(nFf#KH=TRQpO0Lh1<%QCCxge3>jzX4{}|^wRYy=
zt8lM9X{kdgz81fZ&#~);v5zUos3T3A<rr=F4qST&rw`wWd)=Ez`D6Ik@N>*M7{8s8
z%Y67Sem3s^z=zzmzVQxD=J(k{A<Z(g4CDR70(=<v>QAXdIsQDZ)v?~<0rIy;{1Nl`
zGG}(W*VO^iRIJeJIDubo@p=4$C-i&btZwE+@@r$E5MN>O3OpOv=A;IE8SZueCo$~6
zmn!8;j0W&Dd`n`CBEQKfb5$nup2WbpA3pgQx349Z#{F>WLp=W_omSTzd_S($wFKXX
zd&NrXT8)q6wz>{c*ON|*)b*Q3t99+8tO3$#=f@a6h-+gngg=dI=SPsaauRpWk5i3$
z80Sa9!_0@I(aw)@{1C34AN6=@zFx<6i%UHFBW^oCCP;HH$I$9HkGEMo>j%6yfNNu-
z5SRR3V?xGW8*^<7{#`!%U(1N^&+wxoXMNm6IjN`X{n>@5;aYzV;fLc|e`YZs=HgC&
z-fGmt=+D$1zJp2{Emk@BT3qYT61)u8>R4@YiPa!=l>Bc=tp57J_*fag(a}pefiv`a
zj^fKKK8t7LTA!x>Fr443Pi0QZ!<Uj@JI_n;G~9Nc_sG0V8fQ*QPH3w!Cv{NP8<x5b
z;QMi{t`qn^T&wFmK91Y!TFxAM(kCNzy>Ur=zZi8bd4xHMblRL$jSu45_-MwT#<ej#
zNj)ZUXAHm3sE09zM<`>SG};)R!4Kiu7*2bX^RPg#W3I(z3^y^aN`7YyU-N<ZSQ%ru
zj&jCGr`59!f5GB?_&BbO;ju`5ZCr%#=g6;(i;Q0S3b&1mTIS9rXGX@w*VE(MYK)6Y
z%IYGWHZB_RZd@A|o%r{0ZCuPzk73*y7auX|VT_9@%9tXJ7H|Lm<2=E&agmMB;#wVx
zEgoQ8R7Ko&t!gIC)|Gl4yYU8#598Z#ZA?r@@@r!vbq~*|$ghow9Q<nBHYS>wTl-1l
z%xm`_p^k|<%36DtJ|^1mb+{JqKKue)8xv{FYuDk<m^j&}hcPDRC}SsSv@wzSBd*=J
zHYN)2`*5v}<rbGQQ6F*JnCKu)pir;l0KUxP6L>bR-ILGbAHu!*T&{IleXJ{RZO@?)
z&q;LF)zN1K75Jwu<u~A;wB+x=%kT@SOYB}UX-(`|%K*OJQvL+K1=rqdo5#1|UVWUy
zA<LL2oAKZ9+5gJn?s$%UM<wZTsf@&`<j2I~Q+h0`@uj%eZ$U`@X1vIfzZ+kHYi$|E
zSK?l6k@BbUVm!#_SS;zQ=x<4<KF0gfmgDE(n{ciEC3v$Xe>J`p*XrMl--c`T@5Wnj
zt^UJ!zvcMT_`|rizm)no@8wuL2mcy=iWxuS_Yq3)c3j(Es>b)=E6n`H9&9r{glp$w
zH~tu|?Jo`E(mpMI(|8}Qoy)2H>{sC0^&<x##kKmC;Lljfug3qH=*C>pjL%!j@5cAz
z1!nxnAAL`G7*AQH*KZo1OFX{ueS*{{_<I55kBg5{zZ`sprTh{+8`t(vtMNQs)`_w6
z&-lJYGoFuYb9Fa<60SYh9mX%jwf)s;{AOJ1ztkuBEq#mU;CbKIzY|;%@nfZZ(eGq#
zaQCXJ@sr7~U9$(7i-Y)CWcPn9#r@8san0_bj4IMNV>EgUV^3}b--K)537)~LajlMN
zKM9xb<<f6e%%PR!e?#i{&qZz>87E1``o4^Ea=P_;*5S)7-iBx6hjW}*EW?*Q=UUT;
zr(1jsf0ueXb3rst##|M`Q^<dYS-$aGE*S&tBje6o7tL?XRr&Zy_z`CQ&$xYEhG*i=
zTpP`Ae80R7PsO!<YQvAf&os+7&ec9#;=9!J&$`DS!<XUC+AMl}<NNEOh<o+3Tq`qv
zy2$ro@@r$YhPiYV?u^yhWOp1GW3`+zHjqXetMzypuEn4o--v5<?2nZ1<uX>&neWz<
z-x;f=MjaEzs_!Y*B@gNK4B(j-FT#(;wOCh1+^e1v>qh(o<kw<7PCHiMPOR@w@{IKm
zWvsQ-aSAWNwOIR~=6(a$>X?m7`CcxuZeVU*gFCT)=P<X939+uBoFg9AW8H$MS-b~d
zjBBwTiMUriCDt?eBJyjoE@pmQjythlWwgT>*Lj1CeM=on@j_gSbuGRc*Xr0BDc{Q_
z*3;B+CHb9L@A9d!9;ck7ALy~3!+jRd{29-4*(=iaEeh~jT)qFpugA4m_c8~!;%Cz)
z|34NEi>(QaSa(oH4{5Y})B*evTwC)^;QhE($9aoOtjm}uCBL(u^=YGy3FEr>8Gg^(
zvR_q&@343ielO>bHm<uO?lmT4To2)Ql3$B;7IWnzxHGO>4jmS|rW&zM{W;J3NTbcy
zIrtE+jq4Kp*SJ>4>PY!sF0me@j?a+a8P_xaaqE~6>t4#)X*vH!@n(z9;yZ9H*6BlG
z_o}DFIuHLU`L$R#GuQ6Momih{w8MyX9c4Uesbd@7k882+!=J*nI*vuk_i~AKF7x1H
z<ac8Ijd?ZJS-)U^z%oY^;tdwBz_;RBtQ#WkRZod^2YwUzwOEH}$9=dH>lfd3+hN3d
zk}@8#)Y11Wa}2J<I)LxNwK^8zQoff<tlODqAI6<nuQckIFs_>^=Y}5r{OiVREk2B2
zhikE(j<{DnCDy6G<o<{JTC6LXD|g~ftiO8DGuA=M*lnp}4c>`sv2MX1#I-v1M9TMa
ziM5}3a2NTVSpV(cZXFY19ip78f2hYgW0?COi|6B;a4ptl5%;R6#JUdu9Qn0akI;^7
zxD)FfqaDV$?x&3VEOi{m+i)$`bNB<eR>#a=h0FJHiFGaW=)L53V%<Ea#=4SnHa?=q
zx)Cq8cqhIA*J3>waj$wxtS9k{$gjn^fVuJp+==z?-f`Pu#5()ejD1TTi}7Y$i**%#
z7p~Q@DN??dOROiT;|}sWu|CzPW5T!|p`3M(>am`|gBDNw4QoQ)!P3@zxws#9`Xc&W
z^bPKPXAn=uwODsC7t4E;XVWJCmbX3Ee65rr?;&byzFu73bJW&+qj(V4>Nsn0iFFC{
zq~v$jd@meu>zEMhf)VZuE$>H_<4Y}GkITDiTCCggfaU$Ee*7c27VC88xFXz%^@oji
z7~^`LGAc-;#X9S^Jg3LCSQp~exEAXQi%YEgsH5a}V*Qnn8tX2~$>-f6t)4^p85W<y
z3-BX3X6!!0*iZ65$9{^%v+-kaZST7nUyf^g-&MH0N2cw4H{t7XZEvy*FUGaK?;%{;
zr}fhmz8a6)+cox+{J&#g57+j-vvGNc%xiBpKuC-6GJK;MUpZfl->0r7%}%8ZnWvla
zTk*@xGK}vdbmLFr+Wzt|{wyxzD%Quw{_-^bYs>LdM|uAO*Y=Nd@K<oJJ_>Ni68uHn
z7K0knr1MUg*2Wh6d|Yc|4_=OIZ5+WXaIb!n7|-Ar;aVHhe!s|f3$BfmT>QR7r=O$G
zJA?R-aIYB2@oVr0@ilyo_0d<t*AIE#IK<pMg5Shvf5WUhA4I=5Yy6$Xe#$zUcgwVM
zdK^ztJV5z#_}d)ob9|1~CH$VQ^X(3)Z`Skd`BR2hJOg+kz8rt!Fry6Ok^DF3r-7Wk
z>PphQ$$MRg{6?DO1I~{N$uS!7QQjGNU$W_koG*)scjEF~@AxFsGaZ+4FvlGJ<k=zT
z@89{$s7ds?Ea#u`H}Iw@XPR_c-=zM5@r!G7c}~Q&Ik*I$AphyqDOLyLdwtdTzbwaZ
z#;0&+Pd?fP<2PEm@q_p!X8B3$oWUb;8pc-?>2u&TUWlvhALDyKxK{rhycn;HJHGQL
zV#3eA@h1F=I1hhmPwH2VKZ_r4y78U9W_%de>er1wiF=LrfRxGn_AvfQKKjdFcgKP8
zJ){}Rc#1S}&k&8@fJ*x#?_J^A7|6x{h_8_2Mf=EjE)vA2aqT)(gTIM8>*Q#D<L@)I
z;B&aw-v|tF$R0f9oY2Cod3+h?d)+nYC~2N2jl>~VM<WKa_&@PWO;0Ly3JCCT=`Zl?
zWOZnv+;lmH@%$#AG#f~x{auVQyc5^rP=`N^Yh%3)AH?IXCC1-E?86V@UU8DKHioC3
ztM_9l;#xmu{E4+I`Mt)Pl%J0;#<lvF;Q?GLzYbr4YwMXd{G*oqefTHwLbH#Izq>w$
zUyN((nGk-F#WTkFomb28^YKl1wR!xc&&TGXGW=mn`E__VzAi5Rr(^ls@E35exgbEE
zK71J8VCI)GYJ8t;oHPeX6ZgJ|@w;Jj`10a}?@mT87}Cd?e`bv1MG41<{%%+Sz6ICT
zBIWp2-0RvY<=5la<6dnPZ^t*`pEr-66u#LM@5guJ-!ZSf$?eXCS9}~lVU1q@IlLG@
z(JbHj1(@*fIb^=by)=Hb>5=b!O8Eu2<o7y9Bqrr}K3;8J*JJNZC6~#sdPzBrq^tXk
z-i}WE?X~(l&V%@VT#Mr*K8b7BHQ!5%d<Sr?odNtcOa3C<cfNl7O8iaoYir6z{7CZ0
zIb%7xrtHLXE#(j5$Ki3;H1bE^i<!jFz~g?W!5HVh3HAal<p=O`TzhY;2(QGw=6YGj
zw=>sn#vkIdf9N0Xb@_t3lkf81xu_*&`}>l<;hg%;I--^Grj+^wD5DpD0gr2socpWY
zGR8=g6x919goh|2F6PGlV8&l~CQbf0H~J(WKgCjh86L3YufsoO$=`;bnwa0HUmqUC
zKSMlX*LdS^z>VQIS;`OL)wtHD885Tfj(hc~+^5tqcW%XR;<Nuhe|P)T<36R5vW6^m
zX~ZAHz1Bnl%J0Mn@ay;-Yiq*y35Q6Na)I98Q}`TZ#Pz2UPyb(e_lx{-ZuECHzQR&|
zF`lisw4n+=8joAg$e1<u2bxI}B#m}&+>PIXYxl;(cpI)=kEZc<T)Q5nPVx*D*Y1sT
z@E_w^Kb7D=!EOCiLz+eFy!%Pw)Plc58P}WFG~$$eMfiSF()5yM^@VyGxu%Sf=FZa4
z!k76R8#76A<qlulLijYUT{ANN#=RhZOI-f&k0J*6w|qSRqJ-Z9lKw1q=b&=ZY$A;o
z?|S^@cJF<CIYvAF7rY@c7T3A=)&r!;;27FFffM+dcopTjaR_e;Nu1{KZFt-oiFQQa
z3C`NfI?mFDLc9}?8`qI_y37-8%(E}z&OGtAzgp*sX3EN5pRlHj{LqiowHx1vYkfA1
z2XSpqo5ss<uQ^T5sUqgY%kdsQ`_D1zYF?-AbNjd8@3hTQpK^QzkDF7BIj0`~XQC7P
z=yksxPr2B;y;9#<>N`h%=eqjsm)+Q!^);@m)0Fom%G1u@)G6K%#ck(rE@^&7nkzZJ
zJD$QX)=3`)aetXUht%M?xYma)_;I)vvmX4cL^onKf|o1h2dLi+z81ILH>CfAXZne0
zjB%KU?@^8+F(}2maBUpc;yt+6IFxfn=JChyyZP)Nn{fLzwsuZ(ej!$lH9%QQKdZ-c
z0#C!^)=I|OZyqnS<j>m2ItSO<Qiz{{Yi(&`o-M+i^FPCAi^n>lnX-0T>e7uj;M&+2
z#{VzTjj=I}KV~UE^%d?(@wl;J^m`8evL$~BK8kCxs>a80Emnif#e1cE=6iqWMX!E8
zB(sn7dmm*DZ}9GS8AEBzbx-2X7#i>_D>jCF)0}gcc$X!|3gGGZDSVEd^TxZxMUnhk
zzf|Id<oCKyl=2(#T#I+&$6Ag*h@XV7H0x))%RGq}<10)z_UwHB<USwQ=A-~#f@^y<
zMYy!jt6!ykmG~NqH{zwZwpY`Mufw%<;UNAsT&@YR{xO~tOyc+9+Pcv9D(^wy+BzkG
z-;I};<#S#|e{Z)4e;n89SBbxgYxQfy58+z<I`O1(y?%rEJC^!Q;sNq&<IndR<J;l^
ze1Y=S@sA%ter^0!;yJiB{u=R>xHkSe@myRRe}lNRPaA)e_(>M`&9Iimy~dx+CFRVU
zD{$wxTpM0+=cVWz9^UqI=A|HI)st3>bq!u^@fQ3NT#I!Nel@PedIWF8wOG&K_u^Wt
z(_ZHp2Cl_A7nk;Fu@2(5;o4kSgLmRyv6i`_1>c2h=TZ;;XIwj%M(};Ob}r4}uj1Od
zp0=OwXyMwqo{PWlQoVjbd^N7suLfU-YxQfv*W+6Kdhqjbt$rhTEv}8f8NAZsX>afy
zDqI_Xx%lO{HvWQmJ+6(v8hj_NjlUMW0oTS~4=(M~#@`6O71ze!4Bn1w<1cNNYXz>2
zzg+zHxYoZx{AFD0-x_=`uJvyV{wG}P-yYnzQSaXoe3txb|Koqfwf;@}7kkOL*1x%U
zD#zFQH;6CAwf?Qa({QbSTX1Qg*1tXYVvCR98MxNJGx!o*>)*6D`CdJ)^=~e|5!d=R
zh+mFt{ab@yjBEYdf;Zq=|MlQC79YVc!?pgM!8hYt|E9gg{Eut>n~UFvYyBI<n{lmw
zYjA0w*1s+I4vY8Tt+>{|Blul-Fk!70-Ori9pTxEPNel5e)-0ZjKZs|V<zMLTi3IUo
z7O%l2e%f=}7QD;iJ@_8{RP*>(yT>2FpTX7n51+)f`llV>9t~e(mLGXPN3PGg_#s^F
ze|#3#?g4A?Ib7|3Jn1sM|9bFKaP9abc)*f>1`pzD|G&-O8@806i|6Co{1L=!Eyu6H
zJ1oa<!SBK2`p>wB@4+9z)%N4dZ`Z#!JA*H=c-lLQeE(_Ezc-tUr;`5+86VN_l^XY&
zLHsz}nSY{g+-uh0x%d%ge&c(yE%;L0ng62sjrT5k@Wr^ZhZprLjPZ}B<J$LTXYiBo
zrRMRC@6D#ou?LH<Hr*Wm_!?ZRe-O{dop*Yp^}F1yUkzS>YxQrzSK-d}A)255kIr8`
z_|=x<kKkpv_PyyDyvX8d|K>aDxO09+k8kXC<l<-GYX9RwT<w2+Bd*1-1uwzX{>N?c
z8^I-hYX9TqxZ3{*S%2eN{Bm(AU-KY-BCf@+2AA=n#jgcli)-=g!KMCM{6=sYpIZE8
zaOpp7{H49iUJkCsFBji{Yw-)>rMMQKnn?MYx8NTmzZSn9d<Cw>Zv>a|qs4Cqm-=h*
zOPgn}4A<h9i%b7$@eATBaV>r|xSXF_{95oy_CTHEN8gV#-c#?vWsg<!5&UV~X@4}o
zasJNW&*3X&ev7&>f2aM2=YseO(~bE%7e9z=*PkFhgRAR5T-v8z|M6Gxxa*(s%%}%X
zWnWia|KUe){nEzQ41RFC?rDekn;*C~{&MkITpNEuJcZ+H<F5wKz_sz$f+ykH`0K&n
z<oMe78^PyrZT!vPODJC(e`yQcpW#~ka&akN^C13rT#H`~z8}}(*Mj>wz81e8T<WjI
zZv^+@TKr~k=|3%gX}%QS+qf3LTs)ofwfF_`#kdxqnn?MYx8Q%X#IFaRvBYl#m+_;;
zZw8n8Yw=4vEX8+-^0oNo;?jRw{DOE0*Wy=$%lWCruLV!F#IGk(z81d`{I48e8-FwS
ztGG7)(vnh~@uS5r7nk~L@eAVfl&{6F2ABTR;@5)9`K`sT2bc3xi{A(?^N$vvnMnDX
zrzNNO{=)IK_~qi$xE8-4F5^dwUkxtx*W%ZL%lxdxuLqa@)8aRR%lWOvZw8n1Q;T1k
zKgF4UwD{!WQoiOv{3TqAUk$zw*W%ZL%lOga*Mm#_wfK$TGCynao57|3wD_eh3ZLIv
z{Bm(QKehM;@g2P1<QzY`zA)A=HTV{bx8PUdPWz+zjrB_pUWczV*C)pMWdy$q*VZpH
zcqgu{U(!-ieD~to`Xv{a_Bs6<t)FrK8N^$0ZT(V%KZ0xPmlnJS*W%ZMcUXJ`|2nS4
zZw7w=*W#D<z7$^{uEj4Ge-_u`7sUH<Eq*n)v`>p)3;r0c#jgh+!?pO0;Lqc0%<*B|
zzt7-vxK{tPROT04+rP@i-^8{02l07a+kdRVb9i@8JAMnk6pw4ax&MO~;HR7IGrnUr
zg0I81{lyvlGE4bs?@#g7<68Z5@h)83KMUdy;9mQS0qR_X-;3`s>mPoX)%jMk>@l{I
zCPbRm=6iq1XF4zaiTC11^G@9cvy8}lDzY!1${ZKO|0eH|ywvYLuO*Jje+a)j7$Dso
z<;eSGyUcP(lho?&*JLeD@imgB(oB;S{?1o`e=EcX@psMd<~i+2eoelhCuu54)6PB1
ztt?Gr_gvvL*DoTCw5f?SA@=pQ@;R0!DLk=>cj4<QyuZ&QZJwvi;`ynx`EaAnYg>}H
z`;(7PjT~o&ayC|l|CYLYoNJv1%W={UXMVzW^4ayT#yl6#yej;6y<HD~flKlS@yl^-
zeAM6<<6h@afc!0y{I~HrR=)I!aSzx_ngPnt=BQEpIb1u(X7NGX*`tfj;l^*{rKhF%
zhHz~T&cpj~ZH_3#rGDBRSc^Z3f5B{HQuvD}62n$}4%h16i@%C%=lCf84z67TX7NQ=
z>)+i<|DP1!v3T4ZV0>>V4?hpr=Acr%0@vo~T6`m}#itcthim=Yi&x^>_xncin{h2Z
zvv?D(^>6wStTAxyJCJ!1SNk7tAiw6d_;y_D-&TAJu8q%L{1!|7M)7)Fi~nq-d@m0$
z{?d;Ow|~eSpW!*WPbLBxqxq!CxJLgjZW$iL%gr*9!Vk(Me;wY07n#m^9{p}v8{UN<
zZ@Tea**^SxxE8}P{C-^fen<!(#E&-1H@@4Ik<L2AQhq+(jeE^w(!Mf$4_;%IpA>#6
z&1pY=2-n)zhWo0$+b8qA%;Rs8|JQu>pSmaR8kaQSOxI37O;Ao7<!p?r$3?OEd>(%e
z*Upu!52W}e@X@&Zzl`NC#9O`)TIi4SM`K=rXK&WOr`doP;eU?HKN`#5fgi-Lit~z?
z4@mxNb)Ud@;5WtP4=<RcALj81yfMyij+LLaB*j-)6aM=(vFlON1C9sCQ-}}Z{Hj;n
z^(y)G@H#_|QAwKi>%zZr;+FAh>==!B&Gn&$46}^n!<_=;7~{;>m9^pTF!;~wb^AKW
z{T{;*Wpt9}7}Cd%5&mktGY+Pt4)}?t8{c*Ge=x=O9sB~*BVXo_He}<^;RUA4i~9V(
zcrm^Yzr=LoyZKf4abNPD4`e(KFeh)ozsqO;HIKS&lxu(F?*s*~9?JPW>Ehn!mNdq9
z-$qIEAJTYT|D=pr{O}v>Wn^Te_&!M*?HZSl2XQUlWq2_z=Vz=xl71HJ^E!M#uAMh+
z_>LR(^P&$gs?*2)nB=#32p_?<^CIJ@6yLI&^z$MgzYTvXu6;j_ofl<zV2gfU1jtuU
znz@@p3%@nTJ$;${w0rJ!kY@KSp@qZDG)Z%@I1b?3x9Z==n82UKx5U*m{G$@i`HyFP
zIbp3s9iq=$vyM*jmEcF2`Hk<a72>OK?R|g>d@G)5<~QCKX~1v5o&A{TS~R?z_65k(
zf!E{Lnfb%lV&|!{v|*4m&yXf=y=Jsw65o$&ZSWnF;+wK~0DloLHtRt7a>FLaFTxMu
zS{p0zw=Ly2;;-S_wY(Gm3$C4ugZP`cb}gU8r*SPlzD(9K4SIY6_+nf;ei0tPwQFc4
z{&8Hpr*Fj9T8`g|pKUq*AYO)RbMqu#V{zYySZ~)xejhLT%%A?1tDy960Iwpy);~q~
z2K*Ltd?baxD=7IZ@kcHB8}aX0@^|6~acz7J;%{1f5`Ps}`+q6>316}FKb~gsBK$C1
zi%%u~7RT4dPa~d6eyx6;c)sQMgZPP-<4@vQcuidYxNA}0u_?Z4T#Ii2ue5j(UXE+^
zuf&^hZT@M*w_3{Y#BadkuKC7yxCZgvxbx0VbPi?w%9eqQze#)uzc8--;Z13AUl#p?
zYyB6%_u<<8ToJw>*X{)>@j3j%=JCs%OPI5EYQ*2hwfUnH_ixkhcL(t-T&w>ieuTw+
zALd>IkDH&2{gwd!;Y26Cviy_y72zu_<yYdlmi&$QT3qX&PW%>2`Ga^3uJz9(UWaS_
z<2x?Jw++|gAHZ91ZNH%i@4~hCSK{~KUi+02zeaq-lD`vw3fI~<h(C*awJ(SAGnxNJ
z@tgSUKe@|YTSvdYVtiLB?IY|z->SDI7f-Wz5I@ARw6Ro!A4~o?H^x#6USKJ|2R{jq
zyVj9E`dc3(`0B*+jj=p~e?HNT<EI7KyRjTU7rzeI?sJ0p_bmBq@OE75%ND#7*ZOjb
zx%^?=>C0<(Tl;dHvO<=+%;Ed+xV|uAm3e%MFS#+njaU`n0bCpR<@gd@JFn~Ub1eDW
z@qAp1RX<*cd&Nr5t8sh{uASF&cp0vp*O|+hS8%O;1^DH7T>Omql;aJ!+J5{8mh#*2
zUAWqQ{6So8Ki-S0?Z=<O)%Kr|;(GyC+m8?9+Pa|}AH<93i`YGIcx%PE?$zUyxVA26
z$LFrn-^K06mtL(u3m?Z*aqV5)IXn$_?!BVx-YeYea%MK;7uVj!Ex=b=j$e-F;2F~X
zX!*vyUp=0M7n*LwryVcAwRe&G@r{<_kK-k{+I~EUtL^`2if=uxwjbYWIes}_jcfI<
z$9G!tx8wD=R{wsy0oUq3j^BoB^`FBZwj4imIde6x)xQ9L(vrU%@5Z(I*W*37R{wT<
z53bd}AAiwu{Bis~)|G2yd_~vA#<TD_d;r(Z@63<!ED+b`p91_bT$_K&@j+a>FQ~_7
zEXQxhQ)!<T|9<==Tl?`$T#Nr4F6W;X|I8frz;G@81^8Oa@yl`B`CE_M&fj+2cK-I`
zw)1x!x1GOpxb6JSJkfss7T~t?w;Z>fzxBB7{B6f==Wjo5JAcP<+xa_(+s@z2lkDej
z0d6~g%W>QJTaVk$-*$YM@uiM`{8h{N8^_0Sb^PNKxH|q%PVw!<)$xxnzDB?Pmg95e
z*Xm!7FSX=v$5U~w{{46wuGN1WUxI7(pTk#Lj-Q#!`i{M4ZT>94n{aLZEXTLt+Wc9M
zZ^O0uvmI~7wfVCj@3S0#9Dfkk>OY5%Sn_9nob@5D)xQ9L7T4-uj*sG6{p<00%kkUs
z{kXQi?8o=vaqDm6{$(8Zv-hv9FX!-s<afqb^!jML2a<UT_p-QG{#-7pwalL({QEqc
z@W0mP-isN(Kb3rs`z)iH@@m+J*4}$)#w&5{y@T$EuQIRaH-*=$@(j(#e724J?R@lK
zZ`6l-lBAt(x*XEU^MDpfcS%AzdGNu%2ly}ZRIVTFTVBEE*!n@ry4YPK7n0^~(rD*E
z1^!iB>!SvI7k-9$4C6PyJMcdINYf+llS-RIw51ErPNps2{f65I)HC_$WT&EXFE~Xx
za$l|0)1SwCX}H%Owj8H|xpD@-htK{i<ByZH-HmM%={9gr<D@Im)Af)}?v4H-<$c^p
zS3-Qp-15dqx9zK;g?A*~2NTlmbJNX}ZryF6g@cmr;Jt1f!q1AFht1NCZ05Yc_VDvG
z|I~k_`<Ij`>4Ky?7)|$_p018`V@;9r`t@`jq<iG{Nd0#ISGrjJhDg`ABT`<=f2E7n
zZ-#Um?}((^qNmGXj>~V3q^tB!7m%2(V2|``;lFbpH`ad|j&TlYDk<wR(wr{m`*NeK
z$Ua)~3E^{H(zcLxa3}BCO4|SNNSouPm3jQRuSe2`?s5ArTCS0HinJ3gk+d)AX{Al$
zwCUA5Lkr*IbF59_@!&jBmwwJ?4y?H=wD5}5bC*#b<1qOJckaqQjXm5}eJ`UJufVmr
zt19B!wW0~Xn*5q~;kB0Xha#@!pTf6V%J=7UEw_}P9dWJvV*D;k`Biv3zSr!Fq(3`@
zOZs7exqah3Ji|<)A5Lm@$3Xb~&189(ROYcB$|?DV-VY;qJ+Ae`OvJTzq@B*1oBW#R
z;w|`GTsz)~wWEo7wyG`Cj<4RWwxf=6*59YMqfP38YsZ=4I2-Se9H&4(&IIL@{GWcD
zdAuIij#I{Uq4a^sao)H~ZBOwTya&+1-|*l(ik)john%=bzg6MOzvcZ-p40yvCmVmi
zoQDq@$C2wn_;m+o&#Z@XQg-S6JMtbr^B$h|NxgijXVoXd{yV?SYw`6=e#-fiCQd!e
zDCd#g-u0AndMHP{jnDp>JKea-`eKI@Hm95p%31ndeLN1}*|^ucj1u<=e3`}P@c^!!
zFIfdCzK`JAx}gyN0PeMJkmFb2n{lu8PXKSgoAKZAIW}%220wFS&`Fxpy7W2>;vdDe
zV@%?!aoaKcXR;<FjkY$;#`ogdy+ASkD(<yTbH+dZXI$&2Cj3vh_P%Bp?)#qic`R`p
z!cWDoG2<A%)?FfzlsZh4<_6Mebx2*wH3mQ3EW`M2MGn3L&otfG&n>~X;a=~Z$(ZkC
z?rp)Hb@#%~_%R<@cS}86DQA{+C!5FF<c^14{9RldlcV_SxYo{D{52(ifMceg#rrmR
z-1ABqlg8hc$S2K_59;goGW?^s*LZNwf9Bl`JXO~1hsVbv`Ji0w!tWJ!P)?{@e@}J*
ze;e0gF@aCxS}f-AeYiI6vkKXx!3)g3kO$xVzw}ih{w98_=}FF4SsbsxFM3FSud)H(
zhHLL-cHqtU#pZP-d9AZBlj9HI0}u1P5A*opuX8xZpTI|P?fuz#{OBL(&oi?=#eD_-
z`?%u|JI9xPtYiN4{V=rfoLslAZFa}BtRH{st{<x?=fOwxdN$!t;!<X89t^+U>a?Q^
ze+u_Hw*q7t!bkA9=dv<pBfl*pYw`f|pzqPp!T~<}$M10K8hsA_ceh_NR;BoUMcQ)G
z#_D6dzn+gD)~k=3GCV~7<IViW`|EZ10bHAF+VI7c?=`Lil-Y;Rli&7U;5cd4P=>aa
zo5M>j$H+XJ>jrK+Mj>fhNTao*0^f~m<F^5S;s1peHkolsy3{@Y@ytD;g|aw5Kjs5?
z5Fd^kpWzosWh`Yd*M)w>eVvTYw{Lg*T*l{<?)dZ<u|EH?_g;^jXW96jxL1FO7vs0$
zS{$nIHe7p0u?gRaUm4fV@Me^h--SPiYkO5g`1ANtW`5&6)hYa!mh%1QFy0>1kDraN
z!?kN)F}}v)Rro4g+Y4;MH{)9UyYNbj58)du$DhKr`pY;eWFD0IpDW|!mF@00VGc<?
z-5n>nt5bZN9@qbFQxI>(wRYCv1Gv`C7JLt`y-(bO@3)jcf-mjY%b&s1aj$+15QnsL
z*>lJL*BnPOkKW<Vjd`TmN}9Mf8s85q#UD&`%8(_FjOAMVd0dM@D?W^S)lu^I;)9m_
zqxfT%{IhuJh5B>(^kUxK#|tF}(dYKYbNM{H(vrUvFSF#Y#cM73Tk$GO{$9M%l7AGh
zv*e$}A7Kn>@lF3U{fB$qPe}apa9jLJaa;Uqaa;Uaaa;U)aa;UGaa;Umaa;V-*VyBi
zhqqedUy3(b;$Mq*TJpEzZI=AKc(G-!8^sH8t^a26jh6iB=dm|q$)AVU;@Y*S6tBaz
zd+J*JM*JK(zoO4w>cjI(fPWfhu5QE6=Ci+Un>!bWm(|XCu#Yl&NwbVJu`<HT2FJ(n
zJ-D{^3E=~{R>zDI-Q{{w!#pba7t8fx>?>{^!}pvAr8RP{R8Y<?&Lyp$4S1);JMi7O
z*L{?fKY-tZd##JbCnDu*K99>>;Jl+0?Thg8%Bg?WXTryio9iQUd4Tc@@#n}t%jZ}>
z$n|2c+n<%Bd4T!&vx#YpzfIdjni0}y@1k|#f5$I1%ZU8VPHE>5p7n(H`YeD?;YZ-*
zW`3#X+HgIkjMTNPcS)m-nH)TbYq2cBH{xfS#|VE7!ii-yUZ<2VV``9jc^mFLJG%SJ
z?wFE#8qb)fNjFWpWEp#PMmpImeA8{uIL8}$Qg6>3{+!}cpHk+@aa`5{{$q{fNPUd;
zK+*ZEoqnPprxGt!T#nPvaW>-4aR#@>x7#>QH{}c~<w*Yx<IgKD#|bd+O+=4#m42M`
zAn)}Ic(+H&sivGV-07#263U76lhmi2a-Oo3BlGw$?zH=jThw-UQqCDa)$21yIYqcr
zPM==RH03;EDW`}zu|HbQEqXb57o_->Kb7zs*0+Yooy4b^a@OHaeOBq^)KkuYrJPa9
znZo7yl|MP5ocrBzK1ey6p4RJ=$sD&6cgh*AkB_raPU<?=zJq!>m6Vf*JLTNzU5?X!
znNvyEBj@K0Mmo9Y{HA*^QP1&KJd^N#Eaz7AJMiuJdR)qk&8^0sNI$*-*REmX@8NUr
z;h7iO%P)8jFMkiOk9e=yzNGIv9UI`^Mwzqs(Y_Ks`_H}E?YGESlQbdHEdF^U%?aLV
zGMVR2iKa>Z?=*6*`b&v5X+F*8Sgae|F_w+j<9ViE6ZQcAR*W~}DfD?Pe|RnMwxp6Y
z)uh=x6n^F(OCxjXpWNfLkmlrH=-06x{5V|Oo0a3F%6v<j3;66mW{VrQ$oIJ=O^9-~
zTFQ}_WM0JkZKUxUUs6Ub#}SwBW%++}lX0B$oCZmn3d$INkK;6wX7RK7amG20_(gJ@
z3(ez%H>BnKm?upEX`DIdR3lBowQ7cAJ*XT@+MKrD?zs`y#%z<!)xV64$G$o@CdQbp
zrHqZFv5l2B(i9Hc$4WnG{zDqCJ*fa~8OLXFZLCOp=Sj2dS9<Krm|Ml2*iYZ+wkPs1
zKw>ZRcqwU|*bf_N5@KI{G1o)VX|Zd@*ZtZammbpO{l*@bQPTX2G+uF$`sOh2P2o;`
zKdRR^vy3@mM6YiFz8AOkV+Co3ervC9BWZ4bPOq=b<Mp^x-`j3*`@o2=bB$m=-AB6b
z$U6kr80o_A5ZonCRh;&duJZShbeHMrN=f(PA0p{4)YHj4UiLyH-MQZBWUN(xmi6Yi
z{(Y2Yd;&j<w6Xay{3lDD^>a5qhimhZk2y_T?tA@z`jQ)`$UA}Z3_#}bC4c5O2PDno
zMw;j|fS-it;sBnxfp^bHd%QWP6Z7N`y4UbR((HLLw6LA@u{tMhbqbL-SKvp#q(6UZ
zz%wk~fiJ<Ao8?D-A3(|<z%%h&)2|G-L3{$w#*a7Mcn&d-FUPg#Pg$36zFG1Y;wx~k
zK5^Rr9^Me~8nb@J@8opg+bI7NrdPY|8^BvFK7sGXz2*X`-#p%i%lzi{U--Hro>k5}
zuJ~%xZ*h-bh)?5nrYE_-r&fU%PUvI40bh$(#^t{xHhwzro%j`T9_~P?-vIs_+^c;7
zd;)(8kNf=}nKz7Q1HManMnW3xdtw1R=`Z>iEW%T9uV)uhhe|w%+v?Cnn%hXD?MZgw
zTXC;;N*spp8eBUMrto?tztqvck+m7Vh0n2ZAaRO}HJLXnnWqOx^Ms`T`WM~#MbiDi
z9TTOLweDs8z3W=M4%gb!ieHUuZRy2tz_oL3G~!FmwuFE3$(cuI@fzj$GDns$&t8t-
zE$w`|#%*W9-(L;jg_rT$Bcz?>b6nga`#;h*m87}rulnzYG~#=3ZSSWO{}t}F_Y<J}
zK|E>FzPB?)nlnhF?d|w0xQE8I_XM)>Rrom^FV@b;o~5+082>!3?TJ?5n{ekk9o=U$
z?&X^BtML_P`H|n<5AbhYcs*Wkx{SNc?zkH!%?N2uGt)%edH&5@H;I3Q>zV(p&2GO&
z-!uIm_qvwxIo|92oA<t@)F&T*0spLdEU8a;>F<*?<)nGvUfzx3c(Is~Ciz<TI1Qw!
z_`CPqBV}~pU%<bWSjOFM8H1$RI~5B5CUP{kpLXLiiI3viHO_ZA?<V1=bG%qRjrV>6
z_<sC&(~WCr5&nk7EAd%N`HlFZfAEalEI+a_DPyY>FTk~TR0i>rajpK7coD8Wd-i>v
za|4f?pCf<6Jize-cr9)ld&Q&~B8}HIK-y4+r|#4Dv77KY@@xCtUHB`ww)Z-Ozm2ct
zSg}6*k~;>b@N|yvb$&_x{FU72;M$y=jc4Fm9~9%#KCk&DK>1bp65Mt#)=ZjW(r9x~
zH@+HQLwT__8sFy}#;b8HM$`BfTw6<~UcvYAEctWrow!!N61*ALVpxrD#kFzTjJM+2
z9NLY41NVxt^x-i6EnMs4X}lNL`Y?4<itoD?&%y7*wf2?Z(*C$-48}V{)%YNOp4orQ
zhq9au@NdodEBMb7JSqIMYR<L0hcr80(SIj+1fRsUKAOQ_#<duvUCHn3;aVGW@t@;b
z8-w_}xYouReA%?Ujjg14hBR6mdhtPAYr`o1BV234EdD)QYeRY!??2*N8}e}fKkaQO
zBTW}+v^Lb?yK$`zZTSD<S{wTCJ8-QHWBAj!)`k$i54VlA%&XX!cvY`s0bY-5bu7m>
z<60f-@!hyq$9DWzxUG%@q^W*Quj2%M8LriF9=`zB>X>ykF~GGt7UDg)t&WwXIe$j4
zV<Wx_*Xr1b=iyo%2k~lLtK%eoH*Tw={~GqlU)SrHjUSI|bu7j|h--DM!q3OGIyT`q
z;I=w;lV-_&{Wmv<@%Q7}IW>*XTiTFX%{tH0h8%o3<!fyy!7spVZKxs53~97`yB2)T
z(uN-VHC*e55&SQ>)(<oIQE%vNNc#f&6}YVpd8C;jjn;-zd>YsKp%#A$*V@pE{}$KU
z(2Fmc)!Q(N=i;_Dgh(?&8m$c(n|W@5Yi-EKe}ijnD8qk>Yi+2*58&EZYQwYsWp6`2
zX$DB6eNSK<AGY`$K4$UEYgtR++CD=;#I+cd<Ij^{^Ll&;*Ve1;?~%XXl3(t#)0y|=
z_#cq{@MA07`(1es>vO+j;Hx2yZ|UzK2k=Aqt>(JSc*nm8zdWSB4_S%t#N|0zY~61B
zeqkg2B)&e*!!NEo_kZ{duI*6{;>R7(@1ZC0T>KYi`EsxRc=-M(z`y&y$lg3@{$FC6
z@4EL;Ii$JlZM{EB@O5~NS%$HfTa7<}YwyQ2<3F;L-;F<rtLuNf*K+)6d>+^CF;lN2
z&bU^;9DLC`miFUwmikrWN#xh!(~Pgfwfc4At8lG;!}uk*HfK%aYjJH(O1+*vSX`Tv
za`1<6+q@biP05@-C)MC(xHc!W;A?QNIYGv0Pb7bzImToxKj@CrQPNCVjxmeBfNSF@
zy_R_o*ZL_B&;7UFPo;PkuJuzbembu8Q!Ac>YyH%VSK?YfjpBFUT0cn~L!?=LFtlKc
zW9FB5kD4@EJqz%MaIK!@_}_4?p7nU@yY_l^kfxh7wt5bdreI#L=OlhIuGQ0bLyGT8
zT&rgQ--&DSlsUSXG$;K>e~wdyZ^q9z$8F?C>*ZQCz#M%a{(3TV@ok@VuT`>N`qyM<
za0f`&Lpc?P9a#9HS&oeV&l}^PG!K%d(o7Tin?+LBS$rR^)un`aa!JyGa9tMbbt$-!
zHPRw`T`EYkEJd$N1HK8@>M}-M?!uk8+*_u`Wr%Xh7TfDGO`2V#(c+R?$KD98)uod8
zbMfJkx-8Y}Qc5|aN7(C9N16{Ec|hHZYr_M$w)X0axOS}=!_&#Hc?kF6Ux*tc?%yEF
zxQS~8?zLwu<5lMIBK&?n`<L<UuGqdiWASV5SgfF&UealM?+y49xV9(Rfe$7+<6XAj
zWh@Wi&*Iu#K7o%~d>(%h_uAW+c9t<uPT*^J{@_1vz1vRb-LB*_<S9gebj4fvy_EC=
z3or0FE*8UXEUHP<^MM2EI<Og^z_nO(<9jXnhw&v#^zx_i)wtKY=+cJNo7sQHwKhmR
zs+ddPCXGDz@n3S08xNU-BF}!LU&<&e`-A%Ut&8|t(#GPIbdD3O0RJ??an_Mvo~!%c
zEp?A$JX`Olj9sMh`ksT7F^&)5zvFZ47*fxlxqUKEnrkxjm}k}Vd%yVAW*JH07ciuq
zg?Jx+l<CH^^$PqU+-rOW$kPzXf18<K>S+9qRVQhd9CaZ6@6<*9D2mi!5O2l3&Sg2q
zB>p0v&3%v=hvcK(dm#TUq&en*`u+ZF{BOASy|iLHEAxPQKV60A;4+3{bugcQ;<>n2
z90O$O!jH#o&rgO)Q$`xESWBFy@yl^-PE6g(n8W3L(^wrN@9jzc9DEC|ou4Im1O72H
z|K;vjtH!tEUTa$^zZt&=Kf}y#{1#R>{(U@Xy79fcVf+uc_Iza;pT<ux^Bcc+milG(
zmT+y)ItTwJuC3im@Cp28v;3s%oB&Ass`1l4bU=NVr5Ufoz3!7`+)Of8cj0m_`d<sW
zbAp^N#`D-w%GpaguX+Z^JByFu5AiwH&r-%W!+j-bG8$5Rmo7c9(2$rW+#KgwOaW>3
zkjCpc(%y2s3*T&(k#t2Y9`*Qs{Q5Y*I_B;8r;hc`A0SUZeg|$lCniYqWMZ1g-^!Fa
z&f~MV)`qOF5KCMe(}nn}xYs!+?;Nx-zlQL;`RqUUe7DaM-X)Q`G*ec2mR^@`d@Y_y
z+E~9CzrQhzuf{JlJ!wrWp40f3aIbk%j-R@XSXqvrgZEg<FTr2JweznUpT!H!`rQ~F
zb58s5v=8gC?#4feYx#%qQ}I*H^25W)8L!j$D*P*^M=mr@`)}oM3*+kfk3V2JehK~<
zuB}<C@gL)H>ub(Cd4%n>AD_gv`gh~AxK{sReBE(+{ipFDt{p$Mk-r;>YxU2;w^;I*
z;NQW$>M!$GC-ZMFzK75Lb4%QFA^bgo-7*p+4y}~4@*{dXdhr5WYsV;lC9bt&7T;va
zpZ-;T>j2l<A@g_#?zE%%JhdI=l(Rgbx1%1<#<g~|;}_yuJNof;xOP5_<C}4>c1WD(
z@U6IZJ<Yt0`)FJ{9}4g;%kj(cL0qeUJ^nPVwjX~L*XrMoAH=o#kK@aa*XuurXXD!O
zGq)3eT&sTpzRr@r9KQwE>R*pH<68aO@jhIOe?Pv*a{O`pFSu6!IefyBKeLJV*Ouw^
zFTjt+wfdLit8uOV^>`7k#lIcD7T4<Ek8if*AIJX}*Wy2icj0m85A(4sape5Syq)oj
zYxOU{pRydk9RDY-)xRE}#<hLYc0B2X1D=0lF+lzL@qd%wy8a=}$&{hRU>;wIYca^$
z!FS+ruNX)j3h^@BR)<Q`>>!O-9Hfj!{Py=Kql+|;lSXUD5dJK#wPOn3i)-!h-@&!_
zJ?fA{nkCtKJ4)~m;I>%Qkmg*{Xzggh*W+3{dhqLTtsNtH&3n{gmNdIa<JBKB?$evY
zzJkxOb!OyUT=6`-*OI?9;#&S%{25FB)`)BQd+{;yYxj|(_+H#=O)mAH#b+#@{x$Y^
zaP7V&4=?(tzNc4;uf?_ewRjuuwQnQ!YsL5AUiX3Gz4%`I3_i#D$GA@(#pm!NO%LA&
zIKOS2!@M_*za!6u|Fp_ozcBYD|I^(Q$=u2Jp>w?V2BjVa_!Ibz=5Zn~WC!@Say;$C
z0}F>Iyt|zAA9u~)K$;L~mY8LPAN@LO!47;Meu?SE-_;$!KYY@Gg(A~wNAx?y6Zk58
zlj)J)*9!1&^LQg}dw)Ohb=J)%A5fnI72!p=cHdKpZ@{(wka>I!exW@3xc*aaf5>zC
zRpDnJ67O!xx$YG2wuleoz4%r>$Hqlc_$6TRX?*didOK2E_&z21wev0qPq*YR!IN>X
z`~i+%jUR=_^<{YN@9dmP9a~6KLK?6AXz?C=Ev~IOM({1T*Ze5=Alb})b@-XGpPgCg
z##+Yy$+DYG8qx(xcY9uVFUOx|qzl*gn&`bs;hoGyq+3m%Sj;I)wlAf=75Lk@HrF;p
z+$(01zXMPGg!fz~^$bzZC3v@tow~E!_Q=?|-yJ(slyh&sK6d<f(GFaD)|rj}68EZS
zfO-_;f5vTnTTPm@)Ahb>#*e_YzU{_W;#%MOnD+|s3#D(H`Q>rrnN0FIZr|pR?(=6v
z`nJJHm(aJFck??2r1R=qiM`C@qquY478~UxoVS&fGk2zU>?L-M_{x>`*maTSi=@%c
ziy{0vT#MZl{s6AUu8?`K9d}~a!r7t3u8MR|pB0H+qmeElc4e*fWuYFs9?HqXopD=Y
zl#?)SJ1D33Y&~`Z_?x(G+)a|^qeXh`eD`plh-<M6;OlWMcJ<7wrMMHjZxyJq>m=RH
z=R{(6kC84RcC8%mS<-3aPUi7xe2I+nOB2gUPLh!><1?MP@cGp|tCDoZ|CR33(R2l*
z^A(4m6Z!Lubj)Msv!a}Pc^83nUe~$*&)WIGXF2YV|GMwzxwdD2TWi(K)KmFWB$HvB
zWa#wGpF^DKj1wm$AsNCD)*tD=smUmr3M*l<vPh!T`oA=pO07S#NQT8q>i53x=h>cn
zJI{4>&iD8AdgZ=%zdxVr`dpvu|DXGQRD5}avlQ;w^~Z%FKRD?N*;R~O@n3^>?fW-5
z$1c_O6%yZ;-r>i}D!y96*#{q}(zn1Bjw(Zc57qZ%+P;o`f_BYy$u+Yp6S>$cgLW1C
zn_Q#61|xUzRY8B{x#V2_QugH|w;MUfANRWCn#Eg&+`6lS@%H;SxyE>_kvnotFuj+%
z<Xq`heyf<u`%Kq{A8#mL3qK9shWo~P{x_%VbH-c=1^h;-fv3R};kxl_Uw9fkTwCQQ
z${cuic$4w1^4;Yj8w!xQ6`6RqjjngvO5xYQbz}TWct3ceTi-RVtb_M4@T3>WV+~hn
zNQZZYKkW`bP>-FjBP*F~WX2*hm%h2t&!p2cJ=8A`M<(uuLt)>2Q(?@2XTrbdzA=nI
zJX@8wRDLc)CgShm+b6}V;a<2dzr{4l6>)^)e)RqDTKLD@H`<``>)lX(^+INx!G?kG
zu?9XGKE}Z3z(;G+pln<Le;jVIu?Cr>tY-7`;9iibubH&FSHY`Pd*VqCwO=aF)&$xU
z<<GPi@z;&v>zA@+Ea7|)zmR+H&htXyxc1J55ymlOGLUKXsq4Gi1@Jcg^y9`-cx!mL
z@tCr)5`G3;TmIoG@LultNvHb6pwdq&WZneVy%V1fzXq<`3(kVy0KdZ>z8%<XRpAeV
zPlJb>!~5X{@Hy}s-TJD`xz1RWA+rS;-I%osz8W5`-&S$d!&kv|?U0g5eTm;jH^`{8
zWFq7LNBDk9@d5C2;JUoXgLi=I+S4L<Pq?nFTL$mbTpwSl;-uoQhTmz3U%bq@S-5Ur
z&<`&%=x4&Gz<U!{V_6Qqm+9xx0C*YvE;kRfVa|shl#Qd2If_iUyi$A){0KbU*hBFZ
z@D|y6AMb@*aGejm(<4L-Tvy&tg(t%Yy3=3>4sfXWd%^p|Gu@m#Xjq3B2p<kt?M$PO
z+~+^wdGOY59y~|m=h+<i!|;A?uIfYJQyoq}P>#%-$mq&h4g6)eZvWUfgM5VR=Bk}f
z!26tl4?Y1OYv9TU#X<gIb05qP^+W5B>3owujR)X<xUQVVzQVf%8hw>_168{We}#K*
zWVcY;uJYo!kR4fsGXXhWUJQdj3D^0$06rY9v$GWbxFP&X_z;7B9sC{xPnyX)b%yZM
z;Wr!fv*6hVJ`CQ^5Pku?k3qi_-rK+{;k^vu*TF9^=qJ6(@1_}eI=s6f{4DsX@CV&x
z)ebD8tM+0T{1HR=1@K`8UJ8HE5Pv0npdtP`_##92Nk!~E8hAQ<fg%1Z_#8w0!{EOe
z!Y_c=8F(rD7eoA&@V$ok>);pMtgl~5uaW--o(}I0*VXSV_^Af{VepOyUI6zS!Y_p<
z8uTmS2?kyVk2i#$G>bI>gMK>vm?3|%;71MlGYo#vpkDw#01vljuIf)Ie7k{H!q>ue
zW5YW5QUgz#9U<O>>+&}puF7|l?`6^lJQ^HxWx?0Lb#vfh@O5z0zC$50h2(*5U8)Se
z0<IgwSHWxGY97)!=5WnH>fy)XH@Ug%o6^a1SWo?Dcpv!D$$*~;Z}MJ=>IYrll<tqr
zt;p!cUBlsn;hAn52%}-#Gy^`?z?Z;_;bm_9;KWpwlkM=#{)dj|H{s7Z9kt>|;U(~Q
zoA5UpdFtyC;?i66_Vs`dfa}I}{ow=QSGdC`ed=dxRs6%@W8vY(eTvV3KMB{B!zJ(>
zc(`)rq#ypEM&D2PN8!po(;O(9wlW`?0mysLIxRHjalKR1>kY~?GFKwgSk~;!Mn4XO
z{|0ZePV3so8x8MvYqPQx{C0?+Am_jb!Hc+W3}2PCDNYoD@h>vFk!kCexi-XW;9KE3
z8+>olrv59u4a%3D;a9;k-Ql~+Y9IJLa9vp#3?B;D<@H$jKzO+GAS%pi+U%#`{nYxz
zo1H@WfDN8Lq4kLh!kIrnpUztNUU-vw>-tVhLNRCAZ_}qU4c-H;OJ`qrCR~@!9QgSL
zo)140ewN$Mw}<kv1bzWrcP6(2-qXNq;l1Iyv30^+#*T2^Hy6|3{WSXO%<ov*)hxL4
zow2qZL;2L~J7Y?=6xlwv2W8clHXHU`!pK%5+vAR)><@ZbRaPspF>Ro}|Ez<zhxc&%
zICvIU<?A)Hi#^~%m9-aLaRuh>wJJAMJU!;Irgo>kto4Uq1J{+c;qcM$Ot&4bIyD16
z2d*n?OW?(DU0K@>pJ|ByD0~ZCSC&%W;+;6SuB`NcZ-?v3N`Lr4jlPrrw7&=7PFcCa
zug!nu>te#H9;9#I%HdUTU4LH#uZ8Q<;+v1Ha9vtD!^K_U^;Q1l(Y_u--zhWCk)npO
z>?$)#E{AZo5YDsiJa72^Z1DHoReB4NyI^qm_!KXLr^9vjR>6B~^pzcHw1d6iAE`3_
zYrBxWYCmOOpgr{?=YN~u=DfSvITzLU+!<<<dLeWAJ>l1<R2T!{J>WCBZ}f`_BR>?z
zSY#F<(_~B;{06%UqZqyop4B{z;MpGKlXb|%-W%Qy#Sg$c!o!V6{P13?ZG@}u$a#N1
zCFB#=x8%~^VXX@pT{-FtzZo8`{Z?hZm^cQ(cc?gCbj1;RCt^)Q`!a*Dl83Ojifp6b
zT<<h2f%k!j+q+Qd-45@m;ePm0csktleMSGfoCCN|A4ev94!kSjHQIPbC|?J_OW+;d
z-1S>MdGG~>@QdKZ2EGhF)4;3Y1#sOMQk1aw0@tlY`GdTt+x}oZRrM%WwbAGoa_`-9
za;VIx@;yG_2PId8T++}(f!}{!+f2^=`>({8i(Geie6I6{CGhcZU3x0u!{MFW`mXo9
zYT<cs-P|(aJ;u~<U7wH!e-u949ljmtJXM+N3*QV6x1R2Y=fG3%r%$u_qoIw&SMK)_
z3zW<Q;rB;W9HsCx;Yr*#hT;0%qDpu>csL*VQK^F`z=yi^1MRf)#-5T%UO+uQflLo%
z<{)#kI~<kou6IBOAhQ)2-CR5mz5%Z5!;9d{;kx!_8T>PNvfGC1LiMj2{vllF3-LbV
zW%wg*eU%2+w~zbNZXQEsF*4pWPHI}lUEe;whOqJ<4Bz&td>aCv4i9IG;uGPM4f^xp
zFT=ytRll;0_Du2H)&2D3ke#kGkDZaJLZ*+BdBP>*de<|ll=T};Jj%}WAn(O}WBGd`
z;B(c+Pb3ciLx+w(z`gfmR~!xfyz6@nd4x3xS>0Y@5qt<-S09(bAA*P5OH{U2!$-g`
z;J(pT*Lhj7FhaZt*R8Yo;mhIYyY+{J%2y`53a%^P1K?}n;pWDE!pwu$!M}2cugc%*
zKpaYD4l-{Jqg*joX-tD^GfoN3`^u4d=ix(5zf)@mHkFkhYTyx%gfDw44&NfqsiCiH
z6I2*ok-3~Obp7o$@C>+aOg035CA@;L8q;B~auTY-p9nt;&vbLr*{~ioAD;54zO7gX
zPk?uD>$~2KJpfOHhpT_8kLpFc=!L(+z4!jsq57lp!?nMY{sH?h$f>g4m=0H&&VrAG
zhwFn>JoAZX47{xxd$wvCk0&aWr!xrWkz9RxmcVo2;nJi0xgCBFyo=k;z-KO;`P)(W
zFpa*lGmEx!5PT5#-cd<S{o(R!uQK`p<aBjpApAqPu8xm}FM~H(hjM)*Y!18@9xk2A
z&ZF458}8WoT`R4f2MEXinBLCV#jH)hb#`=x4}$CL7)|?}4R`FgS8vBK!kK2UqX7Pv
zCLWcqrSMna;rapPk67Bg8E~h3{lp10_c+5<zK#;k#K-mJEA>PABY3#<`iW;4@#Mi(
z+v|PR6_0CfG=MP1Bcp4-^We|Jbv`eGf2OfPrL`U#O5u*r+q-N~b=FlzYY68T<ieFv
z6^?4heNP-ZUZ>Ksr)3kL+4}-*v635%TxEk?d3ZUMN7)~7ZeqCJce(H>@R`WE^T$0W
zoPkX2llrqEOW<ALy1s2Y{8D(hv93x>I_+UM_%_C(-k7Fo@vINL3*txa)Fsrfr<;BM
zLiyKqZm<tBC*|qWI~X1dH>GzXGGjDhD4))U=fZXS3G3h^;oXsK^r>s^Z~$Ha4>wlu
zqZ0cu-{ghoxb*|$VyD$qHl!hQ5E(UoYK+4*cIpdnGeSRJ&4DMu!{vzzKOgRahqF=f
z5_lq9SDz~2DTeTC;Zg8#<7q$PCoJW?Pk591sPZ~^K2yo0BXgcXM%kH-%m8G1bKmHv
z;JF~hbKzs);o26(3*ou&aP?L3GWaC8ZY)v-A7#+5hZn+i-*id-gn1lXH?PltSHo33
zYD}N&Oiwm^FTAyzyXHl?@U3uNSuPCf>v$RbAo`i^@YMz+e=Gk~!Q)3ZE2re+<A^9;
z55E8&t`AW>d0Bw#>QV;05Bj=toDIJaUPM@p{;^+d9P8!6KY(lVA3hfzZXWIAKl~SX
zxbo#E$|`vBDD%0qqsa6}CR|-maio6A92l-EgFWE)!xthON@L(alG5)F_l`bv{9jFY
zzeXPnhxdZt*@X9R<TK#o;o;WnRQOBaZ^Jvg=LMej&Hz&J?eK-q96G+FN%-$O;rn@Z
z6n^~}b6xj;#vUXxd)#5D_TWn=7^kfDLZ-*F`f<cS_$6?iA4kJ)fM>Yl2uxj^@aMqq
zf$R1WR={V$Z*%JhJAdVez3{z;_`S<HUkKOL<x}Cu;Nj|`pYVIZePa(b{cS(xqgf#z
z4MwH_8C`od7Cs&xE)JE3;-LQjaNk(gh(rB;g5u@yCFtwM0yXe2;QieCu5aP^R*;5q
z`aJ3kKLxHkBiRRjCR`W)V0b26civzu{4qoP#qi07_{-rl4Dr{%7r>jWRRw?NMfuP7
zIeRgh_*J<WKznJAKXg2gdvBz#>G)7hP<gJx=}R~_Bd7CI4ty|N=cj!5Q*fP~CGax1
zt}a!;*TZ$~YAyT|_$AodSdLuZTT58Uo))}G|L>ZMrNLt-=<V+d?+6dqFDO42)8;0^
zzgJ_<jS)@!=-D0^b1FX;5>Dl$@NJ(TUIwp+*K*&O4prxNhw@@OGAkzQ_r#9Ex52}e
zNfk%xD#mKhHEVZN9Ii7inaK1(M(6JV@QdL(f9Juo;W~d8!N<aN<z*RsCS2$5WZJ&T
z@H*x1XJu1=?+f|cS5CQ|qF=}A48Inx8+Z1B_k&;O&JWjK&0zQ#c)0dWt)nc%&V2Y<
z?!A#NI~&#v7l-n-l(5d3s`q&%yrY5F!IR+O#ty3NC9NjU;JP*Cba;17_<r=W;HScM
zYiUX*7nz|38D+-|WXh1agZsuZ?s|`63H%TEBTaZ<aZ~AUhhJZy_tR1M6>weIOkKkm
zzB#A-tFBpv-vj=nCVW4<KRgHCkNZaZRsC_DThBvg7Bb<=uZp7x{ybbaMq38YhwJjH
z8a@^tu73KJU29p(gE#S^veCW%Pn)?88E5_f3A;%ha{u<>HH3A`3x|%^t8g3ET<o8m
zf~(Rp1b+UsW@C2ZQr(9iJ`sK+T=%Vd6-Eg%zagU=t5m>`z{8ChRUEbOQ(n}UO%+Gd
zI{GMNn*0_mcB+!4cshI(Tvyk#;0xgK$Ts@H_5R*4coAH;E?EGd3lG;;_zAKU{yzMf
zCgGE3?)eWgNrn1;vL4<Au3M{4UQZhU4|kqI*^mLh9zMLe4Z$;(N~S+Da}6@emwCw8
zFExADDY${Aco94U9?lL`2I^`5uY)^f^N-^$f8!6=-c$|YR3oPwKl(N>{(Cw67~W4j
zo#D}NQ-6C6GFy<*?WGKX+tb6BO_kP(@YCSo`eViC!*7M_>hd~xUwD&wf~w1|{<;>K
z(a3}=TPlu(jr5oB)46XfySF%1*csoY!3*HJ{<trE9$e>x9QYQvZv2)HKhRvCG^j0d
zWnT$Ad4@ipD&Q$_Q$E!pvkw`ajY$=Z(O%J?El!7D0N3SH7CZ;8%co)R+u^2sDnw=)
zGP-;!gBQVd?S2)!5T5DI$6#Bl{8$e!gJ19F!H!As<W0QCX$U_9z8fAcjY>ZoUJ2Lb
zb1r;8yp214*LrFpe5XOb3|<Fsl83HxQU&+V)UQ9)!&}33_9uTqdjKEew$Jr@CK>Q7
zgMK!=H(a;AmJ1&N@9GZUb#A5*J{hj-=gQzy;H};IuJyGl__OfK+#LU?lNx@W)x(S7
zDU6F7>p9#L8yXX*Zf0y<)NE{EhsIYu;B|0a9`}bwzotJAFdW_*u3O`p0lyU<E_{`S
zCGdyfP38`yp<%67mBVUeUPVT?o-8U^LxStdfgi5)!;L3Y_?hs};NkqN_yG7`_>J5*
z`q|aL<-t#y72ZCT_f@plo#FRz@4fJFC=8X(z*3n|^9Mnjb`NsSnS=H&xrX_JYk#(m
zI7^V#wed+`auyG+Yva@5>)=i5p6grGS@3#zxO`JS83vD^9e%FmhZn#t_+8vL`Yf;y
z@ekD#sW8fr>4l7LTwDde9ImsW9-a-?`5<`<We=|NK?ZynT<3#qc#$FgT=*h*CwCfM
z=d=ppi{ZNTmBGv4;m%7c|5U-hf$Qc@^>F_jecev}ioJKZu3luo2g7x9r)>B$%{gVZ
zVeXU*pQQ=kkNt)40{8&;+OBG!ZU~(ZSb|K&>*2qTqkOO(p7@4-jC&N`2_7zu%7)Y`
z+9$Yf9;@QWL}maox_lS_e?}9Bs^6*|&xP|V2g3W%p-_2OX}vs@)?&gbdQ(4VFNd#$
zhf9mHvj$!U57*ZE;l8h_bH(O5*A<yw$mq)CHSo*fx;i%m{tvj$#)<GN;eW@T#(MAi
zE$sR5;c(rYWgUDHT$jcJ@GWptyOOY#@#9>58q?s(a9tYv!q0}ccBjGBFXzBJ8p6+q
z`{7N>6J<e7?NmONz<V3QuYmV}hqKR*el7fZxT()f+QzyDG9BD$aGfPchd-r>L)n-G
zp9<HF?S{d}!*yfV0{BR{?o3%J{9$;L@w4k4o=W&ThVbj)Z@_isIB7fQdEnv7sq$eu
zd>Z@_w|~eZ_nJvQ?Q0D(i;?jz|2b5im0WOMs=~@6tjFe=^J5M&uOp+gcLjVlTxaiI
z_zQ58y_vLy-y!4Jdro+JRo<q3Lwog>-j=@bN8mbJa^QpErZ%+znFYw`)>lg5yWqO@
zl}h+Vco*z#Y)4$@zUtsraNXEEX$RlhpRXUAr^Eel-Pk+}ekxqo1`LCr1lNrz3*bHA
z;l?I@l2i)69B%Sq6*3c%(WS8-z6!3Je<bf@{sz~jF#}!&*QGHVz8>Dkod=ZthW+<k
z_#t?>a-zyvA^badW;6YUvyf%*$hVt~KM22Jd{G5I6|S?d9)1#B7k_d!-$XHlp8@Y|
z2tOO%&cJiwNpRghSs}b5{2X`s2dU9-V4tlF-rb;I1<y3-*Tef7^pkfn{x#@lz&kHI
zptV06egRx(e=fYYLB9~5Wza8!4>agk!5=i}*TY8|^pkh9u5QrJfEO9`v*GU;^mE}$
z4f=)fbq4)1_(9q*UHPekABF4uUk{&Qh(CD`>v)FvGvFT@^t0jR2K`)kl|jD{zR#dv
z2LH{VUj_Fr(wDz_c&x#H$$J?G8vK_5KhvO}4bL#>=fe9K^b6tr4Ekm8K?eOQ_%MTh
zJ$$r5KlxkMmkjzD@XAs{{fF;{>&jm){B}e9h436h{AKVw_}|>^qutACAXWcS1%Jn&
zUk_huh(CEB_0OQ60pAYS%|)`|s(xzI4?hOi&7TY5sq}w3{W5r0xK6(cew9JL9)7by
zKlwYxc?SIq_*l5k|Jm?G2K`+4O1Q55Duk=?hc^B2y>M;%;kKdws)s+g;DFZt<Qm#{
zxGw$-cnMq=e>QxBK|dG1!=PUXKWfk~gU7yqAnfmlC8+Wb|0g_J)ertt&kpeHdY;8O
zPXf=xe#!~Y6j%SLx|77S-aHGJb|se%zp+`^eRy_tvuFKzb{Wqa;!|Pg@a$#Ey>8ts
zAHLF1Z%W`>;5`Vdacm!acVC5H0sqCIUkkS>H#+@<?-{ol%3T_~n?b)X+*I#!;Huu~
z;?IXaVu-&4KE|M50iR{iuZ1r#=qLO@xi#pg!FL$+`@)YH^mE|R)Jtvt!!Iz@+Y)$h
zxUSu(fM*%>YvCW3==-gN1B_eX;mW=$Uup0vgMMH5K7)P^T(w)bxy!HXtY$v^bc6jR
zaOIy{n&@XW_InlZVFvwL_-MG!e+fU*?;G^f;Ij<+ec>er{T%o*gML1IgF(Lpz61WZ
zCg~6L`xWrmcl7;6Ej$&jYqt{)a_+&Pp9a6mpx+lh*r1;S&xPy!pAR2n&@X{cGsIs3
zFE!}b!dDpLPxy&*vKoE07BHCh^Za)X96!m!x>l#1p*EPgw<jj_ZRc#l`OsizF1$(;
zkE&;d@EW*ojid}7`|hFRQ=627zzg?EzY3lQ*Y1D7SHN}UAi0+DD_qwOWWaxc>+H*h
zw<*!vmkS>c*V$JH-vHOyR|Y=-*V$JEKML2`R}c5Ur?)TpXZBy<I{Px<z27yAf8Yb*
zI{R|r!{9pm3gLxtUH+EAV`*n~_Eo|A!gc<uhYvNh)5*WE#tqlmmjRyz*V&g1Z}Xns
zzFhdtaGiaH@Lagge`WBoaGiZs@cD3^ef4lZ<4c|Yl7A)t4CB)b_(;R}G#fqzuCp%}
zz6h?fuMmDFV@I8RW$>YJo&T!f6X81l)x&4Nb@nCK(NDp3_GQ4+ncwQ{%ZBH|b@t`L
zry1tQh444vI{V7tYv4Njs^C3YAJN%Y4^K9<&&h`vXBgV&40vxt`<xBG2d=X(7rq0o
zv#$`Y)(>?4D}xKe`cM@-0j~33Jv<$*voHBK&c_)1mjOQj*V&g1k2b77<-$|oI{OOY
zJ>fe0%HRv&I{#I{e}n7ntA{6jpsydvzq5W0*V&f=?*rG_mknP6*V&f~7iD_;3gPYG
zy82rN?*`Y|R|UTTuCuQmz7nppFS$N2kJ9-s1HQ~K&&h^Yz;*WJ!t3BV`wHQM8RzQk
zD}&F6>+Gw7uQ80H>)~7BI{T6jvpxma*_Q!-&`^J~;fvrp`*Puxa9#cu!uP^;_LaeX
zjK6gDRl$eDb^fb|FN5psOFlyT1lQS@0Y3=W*_RDZWc;PGFBd)ruCuQYz6P$duMA!T
z*V$JEuZQdGtB0qW#(#gX|6v;c!7Jf9`?BG`z;*WJ!tDim`wHQw!*%{EgTD;d`L7DT
z1Fo~L9)1+AvoHCmT3^%KmjO?M>+H*h&w=ag%Z1M~^lydma=6aEGI$kSm%ml;qi~&l
z_3#`+|CanG?K}4C{FebA1lQS@4Sxi#vo9C^GF)e0Aw0fR@4qtm4RD=(Rq!0R&c1qh
z9$aT%@-gxcuCp%#p1e?RUpBlyTxVY{{BgL>zC!qTxX!*Z_&ac&eO2&|i}d!@!w122
z_9Y)@od~Y8F9Tix*V&g1FN5ps%Y}FSKyP0mJO{3`uM9pJuCuQSJ`=99uO9vxTxVah
zh!hu;>FvvaKMvQ~mklq3>+H*g7sGY-6~foSb@r9PGZ*XatAdY)>+GwC&w}ghOSU4#
z0=Uk;4EPqf&c1B;RUhi@%Y{#d>+CCp&xh;mD}yhA>+Gw7SHpGo)x)zs(%YA8lYelX
zeHrjYaGibG@Re|#eYx=O;X3;Y;kPc)+gApk1=rbE1z!f&*;fy*fa~l__C$(0xX!)|
z_~4KA_GQE8!*%iJ!k56qopEy3|KOj&+q&2HT;DS<gMSF`@8<U38`r_B;J+DoJ-m{2
zOr3tRH&P_9{-om>@M{b_8$Q;+bKxrtybvx}U(&^227l0yzAAXCLBAfJZQ#i=QWO|?
z2E0PU)jDxL?Q1veTgbil($!7YiS0K-=a}*cN0oyso8)8Q+xaRS)sF9L2q#J(PC4NW
zTdEJoPkT2L?%1=rTx(B4M5O5YN%(M5u_q1Q51!$+R~<UzZ)NXT;u#8e;(1aZPcGpc
zHN;a0KYdyFGq5V2TH;B8S90$?qggyFL;kHMoY9oCTaatqFSSGaMItg%yg@iR?uYM%
zpXAo>8wx)YzC&ZD^49?P7Y3dOUkPv04yi+e=qmjp`1f#KJF*OZ1b&&@zTA+0H9YlG
zy}s~~-*8>}{P5G^I{Px=SHZ*W=cs&A?RYl)G7tGQWo0N2)OWViLi;6S3FpBT;qzPh
zp%^|0KERz$*Kbgi!{2~6IpgbkSE~ko6h5tq{v^jy%FayM!v{Y<bo@*1y~jQe*{RMe
z2R>2h<VRXmr0}oQ+u0YM1lRd92Obaa=C;H2y}W#QDqMH2rUc&25Pt={qaps<VEC=v
z@w?uSO^Bx5H`td3Z)f0r;a%Z6`*Ywu4Ll#-7p^<ITmruteumqA=c~nm`ceVE9j;4X
zExaFGmp=(Hf%tX$Y4Bc#@cY6u;JW<Hf%i7>e0UaI=f4v8AOo*}=fZXVtA&p=@Pyb%
zF%howZyLM+9<IMq^^~SjEQN>jpQ>lYw8uBh<NSd|JuCjKNj(dGy2`0%g@iMnaCGfj
z8GJsxzq=f`$3O5I_+w3Yj#J;2o%Qg`SLu0jT%?$x;VK<Dw5z|t`E?B8J^X3YbhHY+
zw={roYRkj>L)noB-)rDS@G1je24833)$nC-U3n1kkzx&8_ilwBUJlp2hn)%k!k|9@
zUSZJBgKstH7r|Bfb@4BQr_DWZJVoX6W$_7P>?`6TZglm3@H64gIJ<%07UH6XS>F#g
z>1Uomf4~X!^G={&bOQZlC(y4xfxbvMLHgmw^uuqb9_Y%?0Qdm7F8}i2wZ;1UD}sLy
z*X7@`6X;i;Kwq>p$M1)m;?F#R{(uwc=fUrxoznTQ2tF9D^WQS~g9iO-c#c6|B(jcU
z(D%btf1-;&6R!Fbo&5vgc?SJFxN7Hh`bF@u2K{C5DF*#&c)mejw2Blj8}$9~LW6!L
zJnc<=`5gd16Rs=2d2lse(WW0hz!3j3xT*Y9!%gK!B$>;PA8sl?nQ&A282~qxpFFs!
z{1m}W<!2e(RDP=Art%|No6C<MZYn>Sa8vmi05_GNJoqeA{=<t*`469`(O2V?WZJ)C
zc!?UP3|$-=r>ObYtATNfGyg#@jea&49q&MwoSOgK6X-9M++gJL<{UWAmxhG54{{BC
zD&g6`gyiy(`^W1+x%2dLWyp1VBPiESFQ?jZNj-Anjnd2cXz#W+$kml;?Mp-MefkwA
zyq$WvY~=Fkza0OqL9XGuUd{Zc+VR^NXRJ|vS>_5)`EOasFU81t8UH%*&U48%^IrvW
z+mKtY!h69br@~tv3a=iyytjhkJ?)Znh36*>KkZ;{a2(~m2f2oH1jj;3CN?=zJcZ2N
z+&6L+U+}xePW}_l3S{~r;yv9JPT>0#&aYAVVfo1Y(h#5Rl5@p3ocQWb5MLGH^jsZ`
zZ|MgiyPCx(Xy=9?r}`=H%Pu)rd<Tf{L1awn>q9tY4e|AJh2x4(`5_0neaJnkzN^^X
zC8x^8pujg|lphL_yI@_=u5(>-F1tpb6e)TjW3o%N<0FxA{Ql#juzpbUi3-BHpK^0Q
z_l<QkSb-I<h36B_t%^640Xr~YR_W?Pd$|E##JzW%D;`x2rUc5J3MV6ldF*=qH{!D4
zx5IV)S}uG5yaQo1+L0X!zYu;K{Bbw813yHj;xB`L1kZGHY;1TxwhF!--qX!pzgv|?
zyLkj&1oytfYGs2jnx)f!GG%5%v-M77RFkOe$b^rFhfAmOXCd*7g**B7_h#|9zJoZH
za26r=G&+s8*pE04QSlVRTW{3AuUiiH!7p{|2h^SUbPc>Sypx-|zPI8_jTC1Y!tV@k
z2iJ`Q`@mKBy7!3(!&40UW8tUM9y{-}H}ol2hRQ=RJjpN*C|BVd^lRWggTC(+*5wTP
zo#96f<G4O>+n_%fUTe@F3;zwSO+S3ELBAaSy+OYQUS-htwTl#Us1LgQ>kOX;*XBQb
zrXl{p@QH@_$HJ!=^o!wn2K{pQ7=wNde3(Js*Pd~#LBBJ6utC2Myoh#F=fA=5DR7<t
z#=>V9^o!w>4f^HqLW6z{e7r&5=Vx8dpx+rj#-QH^uKE>i`r)eo(xx9i(V$-pf6Aa=
z4j*gKuYo^q(D!wS6z?!z)z!bw@ELI3JgyJCmm&Va@P=_fWBVQ)1E}_WEIiYoUkvYV
zu)iFx#t=IH*TB0O^nD#!w>Ic^hM#HB?*mUa=nsaUZqOeKPc!Hj!#f)E%i&!O`Ze%&
z27O;A`Y(fiXLyQ1zYqLWgZ^N68-xB>xZj{(48MH#fxz#-HuR6KZ~m0SA2IM6_&fvm
zoytC@fp>-{GVgPKe>P0~ec-(fd@%fRxNclJ7QR}euf|c;wBLzqgY&Q!^Fw1K*E~$s
zqYA?Ll5p--<D5o210N1iycX`K9_!MPa2oqd<iiC@zhO)m_~c_?{|}x64>#UZ;rE3P
zHSiqx5JNua!*7M__Ipc$;a}voFR-oQ*jE96))0OzT(yHu_H!A}s-dy6KjC!xakw`9
z@KU%o{qO|_o&zs|>)NS&_$;_K{lW0H>4&d1gkK9^3fHFpj7YH?u1!C@9<EJ4{5J#7
zf!D#c>4)!wYttVLUz>h-3&S|B7H-4CrN1-z--mYcH24zky`L9{>OjMHH0OoJ<UKkw
zXF*oytN!qHaGkG)!`B%240t(Q=c^^~58*mrZ4ZX8^VL!K9z*!4T{z<h59cdYS9-wJ
z9I`$4jcrBX=Y5>I*#884IQ+07{u%He;F<35UEerg0*__RsGB2ihYx}eb?XOzxLnzP
z6kZC~jmc8aq^`gpYN8)l40O^DPh?J~P5%k_aCl3@oN)%+1J88F?@m9wlR<wwybWCU
z4X~r|8{oR~nR*sy0pPkhc@OxzaGn49!xzIZaog|ut(D>ME%3f>?)t5j8Ssb-ef?Sj
zPldN|>pLrOfwNdiv~{s?=eIv1Uk{a0+Ix@dw?DjHnHzqg&&N~YU%_>L>IL6o-~-{6
z8t%vT(eN+eH@MRgSZ}*rwKl4(6(b`y>uoHDAJ@d8^lRY94BU4%^Lq{Vqu&{R<ODWe
zgG^_GjYHsPz;%9{2tVDx=fh9caAo5<ct^O&kG073MMhU=6S_r;>ojpFKc>O2HSoUh
zYcyQhm;=8GZnCienOtPTm1|`~DSWVjSHiR5x^}w`{sdgtuOyulDeg1yboc;x2DUV|
z`>r*?EV#1YnM*c|A^#fcH;2Io!RN6j)2Q!x&1xv?1@PKRL;B&>23`rTfNRqauY<RC
z+wb~DYf>6(N$|_uJU3*2Iy~k}{WmDG;2Ch8e}}=(glD?LceU#U@T=gucC{3q1#j{V
z75v}u8wr*0Jb1XZWj}G&!AHVt-SMOE{_Uvbb1COrn#JMz#&-t%ad@w0VW=fnRYtSn
zGvODydGNPE6wie(gx}=mHm9dJ_^Egy{2)A>5B=~mcr`rRt*_E>RVbgfBa`%%-j7G&
z?cis*!?-=9pV~cAbb;&Is~+$(47@-5bhs`bhQm9<Z+6G8(%>qKMabNWjLybo@VgB*
zRKxEwaB&`W5w5e*4<8IS+1Lx2naJpD90;FluwgX(O#`0;e*><waRs~>ZnCiknH|XJ
zZ1kl^iv0!~I>Wy+@ILT;aGi~V;Wcobjeg3&L}c1kHT%s8RUTaDJ4=umgiMoqh0NW-
zdRGB|3a-`+8r#<3{-uhe7C!O>aU`A3yabtWXBbu8OouOpJ8OXr?YrwYVzS^X;JP!E
z!{BS--3Y7E#ydmxt^ocuTsN;Oh5rO^(*C*Hrb_t9Ux)t&wz9tto(Avaj^DKxlym`W
zd2rnrAw9@b-1^st?9YOCLtoc!41;$y@B;Xm23`v93_sr;|Bz7pmGGW$o&9w|uCqVs
zLi#U5{ORxu3_J_2{HIMnygOWHe*wG?TxWl2kn8NPgkNrmzYd;h;7J()|LN>chxahp
zp9R0cVE?cn*V$hHzs6u+Df}t}uY@cA>FlqA_lAe_zgh#ihPJXlJlA3k<o6dtb@b}V
zo=M(`a#Vz8pc<^Hx|DelZSU6bZG|5`06qi$1ow?~UA1Y!HANNQ65^{v#))sbIldCY
z%iJD5K4nh@{5*J*vjleF<KK$c!iU4djVlySxR~`zcyI0-?G65Jx1UF8@B;W<ZXTGc
z{X^A26-E{^RmkZ4KMcMF9?t(tzW{y!t{wlwx50I3sD!UK#9s$rYv4(Lq5X&J>`RAN
z!*%v$!8gKn_6>u7YKXr8{)vH?!k5Bz_Eo|w;X3>3;LG7U`;vMvHZ{bb4u9Xkv)~Kh
zI{Svf%i%iv3g92Wb@r9Q=NjU#guiLvb?`UfI{T6?;hj9Vu76C2FN5pa=PbC&zsuZp
zBshQa^K3rtuPQ&6a_{|QYN(#M&TAAB#!+NCy2H3B)W?;<kHK|wq$;@Y8@-M72Cl|V
zeQ6_={;$f$_AVP$+x2b8j?A8vHRN=54uEel@H}`GT<7Z|_;$F?*URAB;5uI?)7~A0
zJH8$?C9JQ#mqv=@9r`q!3QvLSeBBFvDqLsdKm%94UV@EE-|_Xz=R-C&^YwhfsWsTS
z4*rXQAAr}vb?tI&W<WpLUFNO}<#kv1_vnYKmwt4vfp3RD;?`GbaQ&8QF>P<Rox$JP
z_#wY(T3x?aSx8u)AQvt!)kl=U--GMYQUx!8w{qL!nj6={XB)y#zARF_U<f}0USJ46
z8~&^z{9O2BhVTpFxrXq|;P)EBuY%uV2)`cQ-w=NC<*XCJb!~J8Jk!9l;pf10bDUgw
zPx!^|{0SWI3#@;@v*F#{Tut)$+sS|UJ#bz5sDhi)R}WX|)79zZE7%8y>(=fw;3|J~
z<u4ol2wdmCT=*aZFNEI+*ZHpuJ`k?+Ulsf*xXyp|@O-$=f62X=C&P91Cj+k1r}JMn
zJP)q(UoLzmT<5<+_zbvi@1_j?6}+pve7Jr;vI@Qz9&Q~#m7jWe4ZO8m-?i?P{MShF
z4ZM$=)0Q>-eoF>iR_pzj4gVc|oqu!T`whGhzRkeP;2Yq&y`w7lF@t_RycVuoqe$+}
zJ~upE{;D}k4(+E+`XA=rd+CHwJKnHQ?8=LQgmsO<SEJ!Q;r-mcw*Tf-c9mCi;KL01
zE8v6Ry0q+t4~6T}(nGbia3?KKk2j_z?SJ?#hryP<@KU(0+~>eIHRqJ8hTrYUhaWVA
zUjna&>-y*lcolp^6JG`fpURiD@QZgHIzGAyf1=UX34N%S@NnV#(Mf|(gTLU`SAG1m
zp|&{-8Q*UG`qVIZdUH+~4eR#>@BwgL-7JOogFoiB!4AFKTL~|LpX26%BS22yQ3qcJ
z*X2>tm8_K-^wZ%7;kx~mEO_D`{kLO=!N<VwaNB1G7T{DK6~NcPb@r9QYv8){Rl@7x
zI{WJ2seASIC0#||0N2@<4zGlV8*?lBv*5qMb@mN|M|`Vq`wQS+c)0qi!Y_r#8}uvT
zu?GD*cpJE`ZBDwH@@vpfhbJ2Jv*0HChrw%~;v3@b{10sXIOVedKIcHQy`A7$KR-GL
zXuG$=Ro~>@_Dra~dOB1Gs|aHrd7%3)M;dM72P%&v2xGb{40WFFhKR=Yz<&+z!w^@v
zen#1n39o_A;l6RbD6k$>paN0(H4vG>KkD;)G<*=elRFI8dh{IlJ@7m?w*wo7D*P4j
zHSln0ReUeJ3a%@U-oH_vzCUz4&O*3hJ>TPX_G8ufp+9YAIr_V}_g?7om1_4khkSkw
z;fy$_|4s2B@b`&Fm+uqdX}=yi{x9Nbw8IV@C{pQ|56^+OaP!`Q`29Rv2Oj_*;^u+8
zaDFLSg;9%4F*3SwWx}=if;8y%HqzkJ&_Bf;N8ochPG0wg7Z`XBd<tBb7y0m6@NjLP
z8tc{2b{CKrAF21QJ{uMClPb6WvbrVM{ksYKr^fPIO?df)*THRX@I52HdUjpFo}q3Y
z@R_sgq<nTNGTRB`ez%N0s4<RS@UC@+`G1h>%J*n^8u~gu2cB-=E8rQL`2E<NN_(fc
z%5(3hBSSt5?m4M4o{7xm$guh>ysx=rR2d%^D&uK=S=&Qy0CJ%+>MZ>VKacvt-=+LC
z@uv#I_4|{<kl8>Oy7spKz6`GG-%H^shr*W;m0y+c47je0)xjUb#tWL%_p=+%UnE^0
zDW3Z&d_5(2as0T|qNfz%_E+SF2=RRcx9ZV7T;H+ex0X0&1s=t`V98mw_{a`QoTemf
zxziT)!AB>p^yEcMj}u#?<fu3?K6<&$A0Na8<uBoS+aCK*k9f%&d~_+-JNDSeJz{#p
zBgd3I_A!rmIr!*`VMraewphij#2$|<Nfcwfzu5foUgT0czm<41T9zk@_0f|1bum-C
z^@-x$1X<0amXiAwtpbr<@fg=*1oK`iQR9(|6U8Kg;g3ZG^HM7@KU!`|6kkM3?l;9u
z^NwgG$`a)MM6so%<bHiaFb@;V5rUc5O6>K>1&LxD!SKfdf|=4v6i3T7iDE;v<bHk3
zRPT{Q@m_-5ohUZ8l-#cj2BUoJ{^z?`_7^H>_j7T4`e|0mUvB29ed#w|>jw{$l@i%u
zlN5U-vMR@&|NdjS<CZ%j_kDD({M-_|gLxf&n_O&(FM@w1{7shFVyY!a*kW}sua%)O
zlPp<aiI0^Sww`3QI7dEeJ#R%%x5V4(VS|B2cH9aVez<4N;|%)BZ3d5gY4SpGUBH#P
z`$jh_yMsPHYG1m=Yt?v|c)cMztdipEranGyUA)=a6Dh=^=mPtf3&qcIhdo;_6vtZ1
znHP$^i8~VcV^$Zr=|XY1%be&%7m79MGi{zt&Is6&(XSSNtn`#yhuVvU5%!$+Vn@Uh
zdt7_5CPseKUTlv&Y<=Ed?2ngkw--}dyw!p~p7#fI8|`%!kEp)#K`|kiMfyJ+RVRP`
z&&yK6-(|Ti-m>INw%8Rc7ys!qCogAPl4E0=gK78=9{vB7Ghc7{H*sgMWN7YNexj`T
z%KAe-?-TQU0pW&+f7(-}n6HWj`H*lK*Kh6GsIOwhud%LYW%k?N?;^yg$e{9tlgRh4
ztfO*@PrTI-;)T=^QDg1&Oys8tf{m^dVwwG(m!GwIwwd;bh!=gLq?z^}Pd*=x4{A3l
z0^zbDjDLMM((I`A)m5%qcb7BSQkEkk#iRA!d6DAvNHu;!BBi(d*%JL^l_l<$pIBnN
zWs`m5gE`;pBTGKpR#aN@`!-^eT^sv*Td}f*e7mjK+Ct{H6?rXpTRi$BQ7&pLo^K_&
z-_=T1v=u)kl`AkcIbcT{<=1lSed`6U_|zlmFWw9G1T7cwl-lW$&v?bxp1(CQJL)QV
zzZmN(O3Gqi7nvrm45kn9=^d;#<CM%!Oa5eAB_6rZBUX8MK)8Ybf}V)_s~jqxRigZN
ze0pmuw!8eRHCWy!o(@R|W#j*cM^DQ#OY929pD<W1vBX?UZneah7DFK<o8*t%;p+ZB
z%`aD}ZFQP_&Jq{MhsCXu!Za-yjXUI+QI;HUiC>#}#Vzum-k*E5-0KnllxscWUb(;{
zo|G?n#B-KBW{cM>xyKftTB<Ri%XrVGXT>3;DlJ29@`ygN%p<bps~&NW9ODtg<qx))
zY{?2+4KNnkf*Lo|7DrSrpwsd_`Z*!CN?9w##9-M@ecO7OF><9xF82n;3U7PmUa#2c
zrD&oQLpxYuiT%NZw)^YrUREAt)=NoZM#T3KBa+10xYy<WR$^gNAeMv*Rcfnk`7FO|
zEjf3nVs3agI#z6s-bjhyVImFNbNmXPy~m!;kGw<#^0FsI|C4rNnRQ=bJF(A}n@*vN
zmZhhNiQe^*JSvNozn>yD#mcRxh#hg0qImRC+Zi&io!HhcU_exFd9N59wD<q}4`pe?
zzo=_G4^TA&(KI|%*CwFJAHJUQuaqJu!Les@y;xo;2K{%2x?@ea5Z$@<`_@RWm>Db!
zG%HiRG%LS(#G_x>uX-8Z1@aE?i2}2{;?ZOFTCZ3c1a8|q-+UcM>TFpZC0@7X@+k3}
zJ<GE{N_?jZ$l(Y%K3W`)e1{^UvaG@?rkj2(s?XO6Vr<MWfpief=W#?+97i-Uo8rW}
zxIp|$#do3XN#S<X8=^&Fc{B=dM2km9L~V=~YobF6N~l+b^}UZVW%N>e!CB&i`0dd`
ze4Mh!n%-69ogz1%B|bjI=Kj@o@`tm;_IB!iX?r=Ut0?z>63rhQ&SG9cI7CF~z2yQT
zniRDyT5M?+5dyS@y=6VFtF&M9iW$v3lyDoSPqPl%i@f5CkiXwj&G=-R@%{1xCOWDa
zC%UMc<<p|DS^0=dC4}p#2qS`^&6N`Me=7Bf)|YPm#GO`$XClQ^&nC|sk>a&rs106=
zSFQMER~A`faWEvTCu@7FHv7?C_B&oNx0&_-t%{S1mLu%vsN>Tk<YIo~F4#=;7&_8^
zy|tL-ku#FSW>1&VNh04X53~|>(%zUPUWt&UN#b>%Jd`As`eap-_{sN2)UhN{(Yk5Y
zHzcOX)#(TR&&N<Iics}y7>k~8y#K!(Yn#UC$1Nu#ZfQ-gQWng+Q*K^|lUGSu7_ElG
ze?*D#5pQ_rM2lCO710Jyk=fh$Eh)J)LOfa^83pZ*Xj*AbrOhAJLcC<lAL7L?ww&8S
zJm--UTZm<z_o5fHP-BHAwXh-J@Ye=^<#{gM>9r21`O*8bL!}h^nvUJg>5fxn_GXzQ
zoS^|3(()VY_XL(E6XmO|_~;Fx@-VHt%ugk0zn&}}{mr{BRm_Yiv`SOOnn*b#RZQ~j
zi{p>UZ9h}!#Z<O`&^ckvjk>a7m=TaJjv|H$QR2~kk)=`M-KeI{ORTh>p<6m?U%OF?
zx4n$Rf|0zfDp)=h?0~)4D@vPHFs&8wH<Ivy@@<Rp*1x+wT%#C&GIH5+tR>zHY9y$6
z{W$A2&wQ`g7HoS`2htKxx8&g#;$2H_Zy~C!58|Fl5P1oK^kC2m)i%9J+cYYof&*;L
zS`l|{CtO7Y)9sC9FEjsunFKKUBm(#@Sv>l2+x(Nngp&dx$13}-mA8q<1A+|!#kc40
z{_<T*R0ZvBuyIC9Wg|bCTy1?FU))m6ZrNz#iMu5ycqbDst+2i&iq9hDv_w&)#_0=u
z@`FV2c2qIBv^!c>u~HDzLx?Y8<l#i|lA16uK6ts6m=pgZ_hf&E?vfyS%W^3mt+K~N
zh!Il$EX9XXa(_Vn#Sv;qP-x!z|5x@K!b^P=BQ{uaZme1am>4Uj+V4j#j1?uZO^aZI
zyi;d-%OQeQp}-iKYBSn8?|obBvATa^ix2I<Q0Y&PDj;L62j1>3#@Mo`i}=iz+*jH1
zqb_2pN8ML=WK|c&PU@cV!mnM#XsPa}Ntu79*x=k(OZnEBVr_(a{!N4|KT|A^RQF#-
z%5TpU&->K<Y@f_KON@(B_tT@~D`$z#&i(gMvg|DJWwd&}KU#iyme?4h?svt=U(Ql_
z!To|*IjO67B~IP{7ANO*72BDKcNYia<*Ke?9ut}FVo3|RyQ`R$pzcc(B>VM0IQM@h
z$d}I+i(9JaYg@{NXN&g|)&25B`Ni4dh;u)&mHhE+QQk^D-`Yx!?IxBbsrxUI<m=tU
zxYp`^dTY6?oA}DP-``qp>n1j~QO|d^k@ej~VOw=SudSSVj@aki*SD4LoFjIgw9Nvn
zI$5qgM;tp@3FW8CedmaEsp@`5svMCfR-B^lx11tprisbz)O}Gqxj0Qc+g{zj)Lw2$
z6M24hKgBP9O%sQm`w1On{<-3p4(j>nj`Hnu#Si?yyZE!CTy?J4+ezL3)=BO<SIjx>
zV`ap+GvpuVijO<X7s%o6fpXpQHESDnpwuIO@rYM~H8}P(V7mOLcqAaC%2k|tc9R?)
zC{sLWC~WR)lYwh^;M9$i)w<bM>lbT`v<`bN5-gc@7_CO|#DO&pWi}APf7*{6w_-0s
zKMT8a19rRD6o~hK*)KOu>b1wL#OGqwK=<otvC5XeMT<8*k|$%l^7j~3Lw3iAUEY%?
z$B1<@Yj%wIC_+6s7IAV}jMyKUwLV7t>YHWp=+EG~M9a4<){kGX<(pJ*`%qM~rX&!3
z6VEpJqtVTHt#Q5VMD0$~G?{&K+&Xh-#IY7XC5!Ld$TyQkQCrFVg0}LLWKrYXA89MU
zN*1HkFqMMQx%=pN7760zgbq~GPkC68B<FPyN0Q28g!sWPS9cJvceuiljlYP7XpkId
ziCMv>zcD$@idd5+g#Yvp_q-?Mw1A(SGPsU1Xjr_(2De(szb706{)b~x#+R;DgJyC4
zFUzZ`oFBJ3-hSG<QsmikwB#of<WF82`;$NSishc`w|XhEfjn$;F;`ZQ$0o84Fe{-b
zQ7lOekhaW==fsGG)&dIZ<QVyRj93;E=!ROH-CKxfEcvA+W>|q~dqZx9Qr5(!{LyI%
zOO*V=o-GexmPdXi8Eu~YwiIu9um6m(VsQ4*V9??YENN7<-_$|;*dbt0>Ue7gZN@@|
ztJrTpC0Kou<z7+idDJOlCpMvpanX05TWX0-!P3~`ygP*W+>(1OF)p~2rWz;g{^wp>
zu56`-0eOj{RDNdFv=nn92UWBbWxmg>vX*MIp{S)e94-H7A*RR3T`k0D`mzM^My#Bg
zAfAhp+Y`ilaq_bS@d{O?rT8RX{+u8_4bFD%&U`?KwU*qLBu3fGJ!D42IY*ciMO^e|
zYw=y=Ib&Lj)js)LYf&0Cnpwd1I9c9W6vZ<=5Sv@b?^=taE$(79uH`vn+K91<7roy`
z97{ZBN*ht#N=|Ph>RL&j97@`WIB7}k-Gv38H>}k09`U`^?vO2BwdHnOd}UwX#Dxv6
zG+jf^{BPQ$|GbS4#BD0$CU)FvGbnMtr4|oAwn(w8wA8@INo9w-*<F}p$v<pLxBSpn
ztEHQ4QDDn`{J&uZY?E~ar&W36L5~<8>@Qnt9;yXVcEt{R#0x>mcAKot48K3}%FWSY
zqgTEbEq?dPkD{5cY#|%T3)8=lZ^H@xH~wxOkJ)FZe!#piR?K2v7$e4b)HrlD^TJrx
z{H8=Mh!tCdJz4ZEr;H9wKHBvEiE{gOgl8QG5SiU`d?UDSZc5|7v;U@S{HL;}^qLrT
z<!bWpQ(G3EEOyxPj}&Ied2L@iS*%u*n=skZC5z|p+q2|vapLP}`D2{;DO#4ri8(Ry
z%Q$f;X0`>G79T8vY5?<!C3kwn1Y2(Lh|g`gl+xo-PmTtQVEow#4VBX@@qVzCYR`)8
zs#L*_%{!^=_${ZK{VA?IdULAyBZZbrnbmf(#X-Bh_7`n7rHCCT$q!P*&nbaO!&&{`
zm8F<1&dTz0cBT_o^FM1W`KC?N9EdJvr6mtp;^l@v^_0NOc@e`l^v7PYC0Mzd{dp!+
z$C4J}J4;S!Ar^V+BJ1Mms^s=~F)p^l{CF`YZorCo@kMY=<Fv~di99MRJuDpG#0eN%
z{^}96ww&e_uX^NLUUAUF31K|h^1OT&7Qgbzk7LDGQO{DudFbpi^q19AJUFSTSDP#%
zgss5QkI2GMt!dW@{ho4{#bCSKV*iI}F-!U6_K{$24=HtaTBdrpSTkbPDttk-cs)XL
z|7nDLH(GoZ(T4jmk#cRcSQsg5qQwSQL1O7O<fs@i%_oau#JfKAq}(SNl>Y9MU&M&~
zDD`A+l>9zMR7FXa*;yxd(su1ki=8D=?2+$r651mxBgF)7`m0f5t5<&F6Tf=pn?5xs
ze9k9clJXE=5|Z-SC^0uee&rLZB06w?Btrh=6B{E{IC$&-KE#eQ92?nvTICgAdgS+B
z@vEvX>`qOP;#=?k1hQ_1^$M-*dMWovaXdKGY5D*6keKsn5sonjP|H4YffQ@K9a#6K
ziRXd*KZ!ZE8)>;%-qJ83`@jDC&QGjKIEHEbycqGDa!hH2EQ}K?BP8>csgdgbb&67q
z_{F&&?Nj~1CZBq~$0ujTiuF-)QLH!;rJhWVmK$Q(iI+98Vq}cWixcHB!JNNjol|zl
zdE|sRwYPVWP~<%C%y>~5Eyu)*AEV{LI58$hZiy4G#>k~{;*S{lVw{)~$2yoQI?Z=L
zhJ4}#$Q0~olvwPMyQ9QL=YED)nfs1cz7j3|aPB8bSr)DKu6TYxst$N@gt}+h;-FJg
z#>9wkokXrANipJ}Q#(G4k`*zcFglokpr^i-@_3B+LwSloXw(U0R;(zDRQK~DRon2p
zb3cxy>{zkIr=HjN<gc;fizt=$kxo~zCtA*q6BA<O$8q8-r$cxpwjrW2>obx(*&|tY
zoTJL}ZjYQ6BkDYIZIt-btL`^@<-RCUB-Q-_DMzr+;@m$^Ye1^$bECyuEPBO=i9We5
zT9o?azG#sbC67gml~KWn^!r=N-zWOlq(y5oElau%n{Sh>u(1cZ+7c_Qe_yO>qR=!b
z_tZ@pp{IIc)@w*w6a9vVv1efY`SR+9BMHs_ZjjSmN!buJ7jg=%udn=v$O+slg_F+W
zzGwRlmbfd4qdctAaZ5kt2q#^^wcoYhTI%oy`=$*?ypq%&-~-o^C3K+QTWa#=$jASU
z>m42jUJM*UPwtabEwy+Wc=C6y_auL9iRD(h^CYelPkOr6x1+Be$h>ELP$A}qcdU^%
zE4u;x=)aw^#u9%tgmwW>Z%TRI67zyjTAk06zVb~=+##n}^q@ht`_*xTkqv<u{%U;#
z$2_tB8C#TElCwDTf=UU_PE~~^>nt%T_{{frd9!#Z5JiiAS92`aI{8Ig9I^t#j~2b<
zd`sLYU$oTB%}H&{;1SmEmKw?j{(NYJN*$9N=g)IKu;rWxvB8$RB|{{+P>S^)xkjq}
zDV{J)=N!mxmUpCB7o3j9Di>TS`*PO83Buox>ku_(8fmp(Wh;voD2pWb4JYt?mnSzK
zBTMKb7g=JeGymAAmVYP}y)Jrzj)bMxJrQce$6Umt&UsAp%2ydWd(ZoV(;iZO94QW|
zW@mJStmWlwWzYHuIoT(UMwA4aNZ<d+YdHttgxNuze)!NM>%3}zey3M_Pr|&S*sGq<
zAUZ;=oD!raL{HdMR|a#=<EU%oL+mdG{)lsmtjrb9H$3P8xXvZf;-A#-nbv^mWMR;;
z=iNerMp>PXuuyI(SN?1%w{j@u87WrSk8!`tb2jdtMKdkM)P}kKUkG}ewZa-fc6j7c
zuXrVBsdE_eP0mf&Vs<c&`-5?8jupRI@}pSsn*GFtSk@4(I>4;TD=VYLNO=)YSlSrP
zU`I;s-;0pjVi=pqml*g&dbs}}@~V|F;su|4Cq~r!QjsZ+lE1Q67p20SNIM-X4g?28
zXY^BJ!@K1UkI1*>8(wA0^Io-h@wJz&SGmH=a{0ZE56@7IAUjtqvn;SA`{&yj3wy<6
zTaNOIBKt3#rg%A+ww5nive*^}Ey;L-35KKp*ULF#U1lX=Nxl6fk331w$BGZVv=`#p
zC^;`qd>$o#j}<$j<jz=86fIZ9iY3wV-B^}pQl5(w6JtLK6pBkWdnskC*^|~%4t8vh
z6{CHgf><%#Cy&O^HC0$V+8!-e#EL`Fa(=9Mm!UGfSj?C}07?JCqQ_*trHaHJOKi7z
zA&^qrP0era=<+2m!dr4uq^kReA~+4O!=j{)^2*nFyUn{x{qb{f_IFVq$qCY1<$jOy
z$$MV4zcqt>b6Xu6SzybJUQTonC{u1WU+CFKO0m<kC16H}%OD&O;(*IxOOEE43u{=m
zSZ}K*3skMaCP#<^2`fF~4O_nF5ld`2!=pmw$xgS>2}4SwO&MW5K^V_FVZ6zy6b~oM
zRH$o$A-xc@mt3VeWX|>+7n+lrd`oa*rGm>Sk1XTzu17x4Wi!hGEYckC$X#4GS-YAG
z!^ZcxRD0!1T>kXR5nRZt{gY|Jq};^iD=8Oq86P2E<FY719^v5HR+g5z{2C$GaG4b;
z7jP+!lrM8(v_F!|RG-{75tDp!IhP8be2dF*pPb6&`6&6v1Ulv@xra+_lw884AX?7h
z@^-YG$b|w?$04PI(Q-SN*J9)fF6(3DD_nkzk<V}$6DxmY{dQrj{F2M6SotxRBeC*z
zE-%K(NnA?e<e{;a*cm6k;qr5w{G7`ic5t{<#LF>UYUAa>XIW%xA-8ZTYay3%S<^zk
z!R5~uax#~>3GzD%<LU&tk<0D``2m;bTgq3t%x)>4<-&2`pV)*QnJCM-%u19cTs}&a
zg<QT*lzCi^CdwN6%6B>4#${bAS;pntR<el8i%D`Um$^x@b`<6&$to^KljJfkFSM4$
zTvoM~`CPtkE$c@zF>52Mxh!oX7jyZsjhw<|Qd@as1dB^;Q+9Ltv8`Og<#=1UfXl*U
z`7)Qi$@14cGUp_@j?0H9$x<$xPfD4=<>eGPn#=qYdEjZWJ4IGLEuLrJ=xOoJ$?}D#
z*-1+I^C>YoRet-FC`y&<pAuVA<-(`LGpESOPl?h~<abYs%2VXVC&iDaq<rwCC~YTS
zeNwD!C!c*%9Bn6m8ZO>yFUyCEt?lJ&!^N@oa@=t7qCe&5C&UiF{Q3z|>zAKCA>Qa9
z=RP66>>x)zq4t)xJuVh>l*=C%YdfYCKQ5+plKGE|Ih|zvV`6J3S^bz8cdA_cm?%3{
zPI*jJohpyyil0wS*_|uOPLpeL#hTOPf?Sbzx_miTynDL*^-;0obh++PG4Tvp`lxvQ
zjFgui6$j3cBOVpU&XD^b5v85wrbon{&T`%(Vtf}l<q<KvOUmyLi|@P0oe%RdS-I+A
zvEWSk?!#i&nR4vIBL6J8Ynb@pEV+7^s5mR-y<y_TuJWZ}Vs2MCVwl+3RqlUCOg>wF
z_K^7aY&rcQ@y*$C)I;L8vr~R}P<-4?ZhlZ~>?S{YP&{*voc*9EJx3mWK<qh3e))iS
zHcfu~fGA2!dHn(LU7DQqfH<5c59Nq=&z0Zgh#lw3MLFV+bLGq&QP4eQOpe&rT^_t&
z{McP?xnImaPcFS*d~u$9@qY2sd6E|u#-^uyH&kp)mm7zQUFq_Jp<?R!^3|c@v-4&B
zePZYNvid$ze|}2&ed3b~WXXME(*?5dJ~8S-nRlO9aH0Hqh}d|c{B($@xiDq!5b<t?
ze13@dG(#S~SNxhGcik&yT_iueSA24joOQ3Lx+rD*z2eo2<uCV$_b!%O?-6@0mY>}t
zru;=tzel|F7dh%4vEnZ&Kin-Q^pKnH7O(U;?W4QJH$CL+yTzY9<b=D$OP9!B2aAQ5
z$Zdngrc31V!Q#hD<XeNqxSn$AU@^C+{NpaMx~JT8m)PG^uDwf)yHvh^mzaC0oX+!0
z<tUzCDt{Ox#%0RQgT&lS`OzS;I#bRbB=%>@2|T|{{(7gFdzsvJr&xWNTz;q6f0=yi
zPBHFsIhE&^%RdH+)tAdX1I7N!<=TN_+!gZufnx3zayrkikfV5hh5X?TF|L=~e219Z
zOMY~RSlvs`zC$c;7^HN5MK#f79ywpCC0h;%*L!5WR}^~XH(pWZm7jUV>R|tS%AInA
zkKvpAmT$7ylkEk({u6P|%aP)h;KANA25=IRLD~5~dPOyx;$GE?3-O}&{35BQVk|U_
zkr_@0)S`3JpO$#suAvzZ_T;KxioQhB0*$a(XXY>8CCmyQ4)j=zS%0y`(44iLz6|y%
z!8!h=oak`GPxN<-KFB@zl2vAlZ-Q~QcGe!Pj*K!GOR}6eI=E66e?PKMsY9_18yzfD
zHOyD0-)8lkV##Gz%pyzfu%bS+)sT@Rl%%`VBl8)|DH9KR<eO5w>s2GVWnSLen<Y7m
zQ=_~oh4)F%llGI=lY%h||BdFy({uT!u7mlfd~uyRf4kD^?)-JeK-Ab-8ZE^$9=Xq}
zj)`p|hj<snE57ku%l({SKE-xIv}b57B)DM4G54Efp3Q>Ucg}*@21|`4oWNVFK`=}D
zOr175TR99h9H8tNei{9S_{o-k#)^E_4;Vjrl9t7=+Il|spK;(pZRe&iY<f#7x<Pg-
ziWL(gQpR$!oc=dfjEj`(87@X9aU$adpFJsFZ1BnV<JjhvGnwc|oiQ#>jEI(p;=~)#
zvN}#Ij6P#+oR}M2@=Z8DolOGk4U2VN7S|lRVn49PSsQHeUC_=uF3VC0=rE~;D#i2T
z#Lo;S;=~Lo567yB|6YcB5$eh3k+LLSY>T}21^(}oe<JCV6>+MIFN+h0qt5s?PUOeP
zeet3!MsA1~t76Vr953d!2t?Z@Z7Qpo%o8|QzR)YDaP-G3|BMj%Qhpmj_9m^55OX5t
z1O{Sly34U%ahr#c@Iq^e&HZb^!WF0X4zpZSg|<xWKCnfJbv>^rjkV<@TaAsJl(xT|
z>%Y`y%VX;OB_>2bUQc0|xj87(mdyudcWbP+Oxaj0{*m!S5Ve`6CL^C(=QD2p(~?s|
z<K`9@0<K@^EoPn(EH_<f6xiCCW3^pki_aLa*=jn%lhJltHh5-nP&l;B6YorSa@omb
zJnmSUbc392u|O=;YV4<$SQ0$a?K_9}7W(i(9?DYGP4X#qw95G-K1(uyx|jDr*i&+z
zqz;z5Y<2n<XS{9Q#61(zb)2paCWl7gL$&Ptdg!%_|Ljqm^5XR_kB3qFH<|cbP<mLh
zcS_Z8>}z#B*THhRMbq$(8sP^X$7OK6+I4{cfAJt*&6lsgf>rE>B?;xPHeabIM%w3B
z*<vXthslwkD_Y)s-5-1g+b;L=QqPOQ23V=6f3a%gq8Dp3s?p%@#K7N-i-&UHo@t2l
zG*-<bua-9m)z$?yTVy`XblLLkv_ySStn<^SR78lqmi;{ExNHyiYdw#B6d|Ta`;7=j
z--@z(<phy1&f-*Xxu@UnUU4i~+D{#4*^_)~4QF12+EA?HYZxB+O$5EmkJe`qVv)=E
z_yL4-zlUi6Zyz`zwtkRTiJ2Qyz}HzGlJ|bl0qu`lHP(0ZM_&1XPb~3H^6<x&NY6%}
zm=YDVhW#gAv$Z|!M1JK7c04_Klr29}>kwZBDr(Y=Ji1>Vb0%*48RQ0INEph}6H|51
zNROBqY<Oaxx6b*3(QVMWOCP2^_{hr2k7kN{V||qP+@lV8|K_pFqr_eg!1-7#_I!<%
ztO`eo>PX4+Um`svQR<C7+Wq6xueUCHkh|GdiTy>C$n&0F1NJ7ZiuCOCcH(}ue8~b#
zj<i3FQtjsaC~??l7jTv}O7i@mN~<mCNSyz=Zg9ND`yYcF4@0*+V99T6H532b7Kek0
zYkePG^&~s%XOB2!r+@8feCwg*7V9+jx1Y1yq4Rt&*)2b}PNU~#rHvDE4UKL~=7xOF
zzTQe_RfnD-kYA~+=Z~|_rvS0Gv?f%HT3n_k#e;630v`=}PZhe9&S`>0d)A)DSsA;X
zqnzt4Wvdg~MO`}yj!LL5l}1j8eO9LzBLriXDk(}lp5;=#WAly_i@kDWgjna5KT0uI
zGILWwx4BjBl;Q!^{eEiw;i=;iET$*_l~T@8%HR2TgiY5iDkJ3!K9TPuHWWLi5fu#}
zeeF+{<W%}n-W00#io>idd&PucbLqPv)WyaevgHzwcvcm8^7LWrj(%!$>29^#M3FCx
zu(n#~zY<|F))^aNO}DQ<7R8G|o?j!>Rt)$1J&CMS6Y}Ipxm2nrE9f~RL{)^kpW>6N
zqeQV!a;SEdFL4Gh4yeLIDur6|=({eE_gJp1zgUf!CU6RpQHK>hDT3zP^EMkTbSr8J
zuiYW%6v;P|UAv^uNulQ!o)=5zY>w^cT4y{m^eeALv;KnD!?FSQ`|K`@yq>)(b+cv4
zIw^K2AE5AL<yw{AILq5ncCnlg91os+qg-r@yZ=&Tvx1Q^!RbhT<CV-{w)%P{^lNB!
zTBXammbgMbCLWa3d))4XaK7rFE?4FDCG~_J;;3`#K)qa*QG%;&Ih{e93h-lFZt#fT
zZN7Cz@>{6`o7bq4cduFm{x;YPMV;009#-05K{xS6lo};9zB!UQTR~P@rg%}3N7zng
zr0e07O+Y86+<NF^TWkp?p_S^x|3=46G|bK!2s)W?eEPZ8>FIKwZQUiO*dDsFpDoWE
z%d_3`EOPqKHA;Vv`k!)NK!^1hH8f?BjFm5Xbu2hwD+^c|!Gh&M3oae%U+=6Cva)6O
z<$WHSH_p~NHScXkgAokO<dO(+NL9rN-bL24d@Di9Un0bah&PFigeP4Jy5XjE4E^Y2
zm3R1?=V>q5qwLqCScsC}P!FX1+^04v3)J?c<oWRkdB`UgN6JZ2VrQ^*J^8QbPPWeb
z)T3Uc#?BvXx!yzL-^B^i8Mxe}2JJcWYg--8r7-NWB!yu@u&sz)X-%@|<QuwopKHCi
z`TB8(>n;?k=c<+B8|ze+>8q{T5#-Ljlj(kV^+P2ixztK$|MIZ4NWHtW$RmIBh(!(g
zcl|nxS8P@V^Y8R)u>L{0i&NRw?W;ZF8E3(2rfsuIhVyy;XVA)cRZ#Bix7|{!)lM{R
za#Xn_Z+T^`*l7|QTGccD`4WzP*}nQyCkr`L?yPOk_FT<sGWo*#@>Xx4BXY80m^^Gz
z!2ep!T1?Qe)PbHk95%Ba;{}oN9-C6I(j$5Du}TMZ?G&r!z_W^Mi<capu{~=n&ySX;
zu_!4gv{EC9f62Ejb^sVotOy$IIP{<LcJV|Y5ivzr&iYORF0jT})Y*nAnsAGxpZmz!
zYWN{ohk_G}#wv5RDghr`YDX9M{Xh231<t1G{r~&S%pP+ybBw_ljDynTGEG85E<>&*
zO~^f_T$&_JzCtD6<334@OH2~SB~22O&?sq=YLb{DN%9>Ml9(h(;{UAue4cUk>KrqD
z>-YP;{;ya2_2QZJ-p_j0v({dFt+m%)d!1ryhVm<GHNZmC*bu1Zu-(@CURncf6<myZ
zOPglWZM4|YiiV_eGr82w{>Z3Iljf$|91Jq11)B7CL13GoXwZzf)}oGnaSN_2>YxU=
z<nhq?2w9lySnPN=z}SzHjJt-qqVeX7fod5Dtq^-HpgUdGErD$;Un+H0pN#i6bFJ4x
z)HNMMF8!Ve@4QgG6p>dxe)asG;4$-vk7;@frT#|}dbc^o$inICI-3^)RI8O8sLFXG
zwQ}@A#Jb<qQWdo#d2S#zB6QV5+M0vuvqtOh@@in$-OCPrqLW6?53KkX{&uS2*>jFb
zjy+cfqV*rX(`q)42lDGLdUr9EYHPraYJR#2J)F|=c&fe=g7}+~$hL9xqRphCs0>3Z
zsTWm?9Zl%X)_$wHEyne$q&!~XXhJPUk;A0!!)om*uPVRlUuZ9LK*=}cRv~mV`_N5o
z<uhsoUFS`X=#vgrIT_tK*s8Derfk21@4|5EUFboWX3AMZJ=J&|t!XSMqd@!O6AICs
zvAorL*U|4bS`^?gH%C#EeC>)TV^e_o8i>|v(o!0FhfhmsvIDRGFw*!w&|Dj-z7bdu
zNpsrK6C;gp>DyjoS+KdpY3vL(r#X#Zg3U8gv??X$>nP*AdJ`}+#N1xNcss;gSHU<K
zVlJ#;{16f|rGoKFsQH7_*b!=e?lis%jm~!(N7QiOLfEy>&_)p9=Fic_SM*JOv~e-q
zd_UTFIwFR4o%kri%#JorM5x7>zeYrVU%}WHMe`l1)QTK+C^|jzZ;qsU#C$2z_&lIH
zy+a5zCr7CdTTe$Cvx3b1k;VZUYDXDA2ARvEjAu=HnRVDSPeiFVMxRF+>w?V}oW}dX
zW~P%K2k7L+a%Q2EzKt>8avD=<IYb5Hxe)V|lQKjnY4EzSg0UpjTv|bGxbYq3E!5mo
z!I&LJ)r0n*SQKr16J}0}Hl~FW*cNW?iZ;FsH{Xmlepg^iggLRIv708=qm7y6%?%Ze
zrR7aeMPqw;%E{^S=JATg<VbUOMdS0x*N9LiBNIsWjHaoKC35ezRip~NNXT?t%Q~&C
zx=Hi#6G6(irsvjl^9f@fB2~Svw))s=r9;id80v9+n}a?9=5b@gXB;)iH-~vDNZsM|
zu8Up>Z=+^BAbKsmxKU3a^yEY1vS}tq@V+mj?i#A%)|?PfvhpkHF4}f$ila3(#NQ+R
zSb9c(I!rwyo(VNB1#AueGStXZSD&(2{#KIr#9aA2GA@Nc&pOoJP!qC|-T}}HwkvH<
zwIu3Mr&>=|bQ4g+w!snYHFe<Zw3fP+nE}yWgB~u#7#i=;iUli8dW%1dKQt!?It~wb
zAw+!^y(3ihl{8vaua!cL-)Sv%s2b^R2~n$lehV}5X@OCgF)dgPk_&>(*TW1CEe4_W
zDIwp`V+omxQ=QmjYC>w7^)8=0+<oPZzIVAf2QDT*rv=oe1-jI6bL?g`X|~Yu@Wnu5
zYXH@@GXbp^2GJ5zE_G*8Q`J|z@1WOWnds!5)SFxH*WYreRjq7g3>6TyISW)TPElVC
z?6M)q$c2^2n+ZLnhOF|a8kIruUUEd!V`VW+SUqMJvpc={woF!1PoKT2y-w420XrRw
zgVd{Y>%?ZqVESW<!~7tUn^C$Qk4380jr1E4H1!rm?TGnpl(8x><`ZgP=*#~o+PcMj
zfp}2O%qTTSd&a3g5Bb<>Y^4Hqsz-;#)Jl{y4^>bt$(!_{Scti-g7JQc`Ah|46D`__
zHhv2=Uye2wg_*OXjdfw>#R|sCaPuA7VJ6(nu1JdjO?O3ONrd@*w2@U_eTcfYy!k~%
z<EQc_eVINd(xeYm4@Vy33^b(y<$fBHI!t<`pB3=HtHJ8^<hQ0;ltX{hd(PiYwb+dQ
z{ygZKXM^dp%q4W)=u-EyhQyNt%{N2TyWtl@RF6R|M3DI_t(T(@<wJ~9s+4kQbyBGD
zhG{ORCtx)wcs<zsB~;~>mNZRP4dy%L%#GGsK3X(9ErbT0%6v>qx=tgTQTIXh`w-21
zqK?p$y!ZGgvH=-r-I>P8^nTWg7^zyt?rNt9`RLA8?MA6b47z<bIB0T`V=M`H!kkk@
zwH3ctrbX#yK^67U%Ij6=3EMnhMU85{p^YSh%$!)YW?^ouG0`;l#TwbB`5t{bVw#y%
z4R^5lQ>>969FSR)zKAjNsv7gknaish`^%X`CWV;CtEvTxyQ`}8l|*Q%(uz1^Zm2mc
zjt1uSi5#UV)HvgEnE7#>@lJTarW!_8gqd00SRG*&S2I43Fh8nhoQY_$zMAn_c{8h;
z@ojmvM)zW*(%cngF0El4k1}V}FlIZ=Z>t+?oDB=B8&fKndDV^QE11ix8%yZxubRfM
z70vna#+(>)LcFmy#{8~^u|3AzQ^WYEl35&Y9Hy_o;*HCd%=hArg_X@U@y41eG+U)E
z$Mx1++F{3s4tna`LJ!o|dxwpt@oA7rPo_TysU@PcGSX7s<>*I$(ChTKs;I{6a0NBV
zJ}X+?3l}QTkivW?+L#w)u8KB}2AQX+!=r90+SqNX4`07C&FK}@w?(@ust)$eifWbK
zxyr`oawhGhyQ`deqN4F?i1}8G@m`3zGRAl-)T9pw_Jo>qDjC0rn%~D53&YI4F~<2Y
z6^p*Ln_Str5N@8XWGsj<zo?|XxZ7IE__Vxvu(ENYy!laOV_Ky7T4iHdq`9cF`o3;?
z72{K<IkSqfqJr{&PZiG7(61ar7DXEWp*As6H9xde{P{qW))`Qh_%^~=9b^{La=0LM
zc9z-wB+ZhWYJuRA;7;`SdHR5`JbkrZ>)G<gg>v19d>vA2E3K6dTk4>|o^bOEnm)(G
zxmAIOc(+jA6}Vb=^OXQvyft6;Mtad<(pYI5ZjV8?)>lJ4^$piyhgzq4mhS8j+COUm
zk+%cY`c=A3&xFv|{5^=wqdFXFykwedX!gqtAo5YL`7Xr`Hdluk)5`_W5?mS(&=SPm
z<;-I=2Zlb&)tE|UlzNb&TZ!hDa;@DoXcFM5E1U8(SN$5zDbrG)6^>fp(JZ9Z$k3>c
zCKRcMnPW|BQ1e1h!e5$d;r%w#C=B|H@Bi8=Ha(snrAJdo{HOFy0)4<qU-Hocb$Y}P
zc$yobQ;vH{oi4;DRn#k-yeg{Q@>DT?2r{3KrMFh*)L2>-VxFo(6LID%RaJL2zp8Pt
zoOvnMI9<;CE|xxOF+Yt}6LgznjnCC1^5QUaW}NXxnE5LyhM9+|8t1~y9aU*XyZK|B
zF*CwE5U17zY>P8Ki7?m38LK1Bm#P_CBF#C~j9F3iz3dlJW<fP$x|3|}bDF<ZGfp_o
zqt%SJD$uz}(dx79jnQ;&az*oEb>oGK=CSH(yRco=jRO_UH>(>(G3L4&#+exNg&M|t
zl_<{BmCfBX=vDmdd?$8Y=1_0_=s9wMsrnq6E29-0+f8E+jbUjowE(r8i{=$J2Ggfc
z=F(t#AP%5~EA&3Ah^Bpm%#UeafmSoCDPS5wt9yHxDr&lpZmJay^Ltu{Mb|V$ZG5pf
zgjToLqMERf+Q1OwwLo)ch<bzacBp!Tk`qd+x6HXT`$<z@6xUj?P2<VSv{W_NJYnsV
z@i{H&ET`(yb0M@vOG#=}E%HOvIzX~P(~%QG)wK1=5MynCxhF&|5~B6j^axJtucrs9
z9gOw_nX|%;Vp^&errwtoQe8IH*Cl7ETM09!(mF9B!R9$D<wK#y*>W_k_rIT7c{Tj$
zLGMZy%0NN^ujvuxlJ`G-x+JDO=?_(7ruAwHif$R|1-;^g+;in|QMkW2VfWrJ$69M?
zSqN1xY^Y)2fZtub!Um{yj&xxxJ$uNumr&@x%*WL@+U6eZ=SK69@}elLS3|FHdz>0W
z_3QR)fSRnM*&~`$`Y3?c15yU9$^4P(3p-UcXe|vaJMTA_sd2sflJaA)NL5Jv;^tw$
zH;U~Xq+&ix4|G@FYyDA63QVNGf|K+Ajr_Z8hCQjqS#*=z%2)R&q&-cgjPb2wyIK-4
zB8HSZnRn8|k<D;SCkl@+Kcr<+j_U6^)U==dd@1!(+5e-<b`nva9@D&5xQb6#D>8rQ
z!iJdB9Q4G`UfQy1KV=V9OE>q?oS}-g#?j*GAX;A6;#?rTb>>-xYQxO^G)1jW=Q>)@
zhXcC;TAUB04=(t09eR&Kvp6dQVxOhecGOY@(i2LRcWALBy;%-aD<w+GjAmRsYKG9<
zqPC>Dat}w=rQQ061kx>Ly%+JivqK*?N2|JTnfMbaNh$u(a-AIkY7d;V0kPi%st$qv
z&JV0YxjINoMFNe}YAo*Mfd02r&7WpD-f{duoqQncT63zy)ec}Ze`>|9cmv6{vGkNW
z++1ocL-_k}#LZ;e>nZHdrS-=GksOw>bp0gvN4pUTRI%09`J>2R%07LoSEg^UX-+s=
zO<Z*|?{Pd4Mhj>bs6wSanU4}XU(&bSlTF8YwVyzdS!+TtFDMp8x`wo;W*eH`P-!=D
zG{|?{YN#zUzcOj<#hnX-9j^t^TJm4but~K3S`E>U(zi?HjOWy|7mT1DT(Lv5be+B4
zyN9ZN=V@GX`x%>BNx$M<4yE}o<yG3g38Gi}x9wKjpP{x1r6m_ug^cV%($;7AYg+tq
zUww>op!q2+)ucCtv<y>9r;FFe2fh@_%zSieKI4{E&xf-<?Uhx}SGqo!t#$UUVb=Yq
z>TGHEL22jderw&Ac21)EWP#~;I*9I*pUhhGXxW0Q?OykZO7V&ZQlCnzcQi$3t(u8_
zRP7*W-JHtj81=^Tj&@lA4jQ$t4=_GZk6>5sr!ZSPNriy-16KPG*Pi^%3vB(G=~$uM
zof%wfZ7{#*7I&4ep%0m(N~&;JhPjI-J@KFy5lgAnG1H80w9rD`zE(NLsPAD0wObkB
zped;B0mcDupD4d&+Sk{6h+5V%()0=g?<-~RlTypi%G6)48>QDBt4vDUS47J0@6w}s
zm~6I|VOWIPVdOem_|sBd%+l(XD(l;5V$@h-rY|bzSR34&wsI&}>nQzXg;$f#<!7t!
zrI&?u9~IGk^kb0Yvf9{en_25yQ@tuEsoG_@UrYMG^NzDYjvrOO^`TkoxM^Il*-`aO
z%C*#eN6O&4+Iy$;zQK0?m+9Jjmm%L9HXBx7Us@mcXY$Hvgx=w`HykBc@`+Vgy4qfq
z=GCnG-usMPa$VYE*xF-TK*jSj>iKin+bMhEe(ZQhDA_m$V+iXS%?NCLl_8LFyd+vl
zoq8s)^;NcEQgNJ*s`tqB+Lm5Ve<=m(wQr5D^ZL61Te{VHsrz!Znf`J)$7Xe3epas5
zPvwj$A>Q{7Jt_@TuOsOZUoIg=Z}yr-->G3YU~;vrfszr}pNLb&bZn+e0)OHjM*s6S
zwxM3vDx4PM(h}ZxQK(jx@ZN}-%0sb|e^>l2%^&Z&<^6YA+b*v}OX_CnX^Nv)>X)tF
zsD6Ul*|OC)t1wE+O2sSNK4n+t7s{GfvAx4#wfzNZ9N??%{}cAgG-mm;_DV1RD|x4D
zUNX<3(&;nEpoKo>qyPuaXw$cc0by#roYzQ8T^rits?Sw^m*DR{Cv{AvJJ1|TJ9es0
zf~Ir5`fb*!@tWgj8ZG7qnqP&`XP2ZfGswIcVmw`L4o%QnZLZgT<=+Q5R@43%w3<z6
zdXG&xk7La74!ZGZj?QY$L_sw^B_m#S*I9NeIm)*)`#ByBqc6X%c&7F_|5Kc13$Kqc
zj0f7TvX&Oo$HiYe_^VX*$$$Q_fy?s&^l1X=Qo7fg?HvzLGwb&D$GUcpJLWmU=p8k^
z+PIQ&%1Suxm-UlctwgQ6m9wi}Yx1={#rHF%>wRxWHY2@0>h0t)l_HrgIg9$Fe&>Qd
z44`e-t*2VAvJPo$b~f%+vHpBnUWw~_LwH}C#Q%}`P4~aN4=DFn@<cZL<z4pC@m(%f
zDVEr|Oz)B8tqHw$T0)<((ueN>9|UZmRmt=jfOR>k+$(%;eSk~rnP^erR!n`#$#6P3
zfhGZgX~nke*ngG%`kfD}&vY--Hy%`D5%Ws^yz^@R`;X<!_wbdtSIa-2^H-03`SeF7
z_I>@nirrTl!j+6-oI^}ni%##~Ke+PQm#@6|)cZqRRku>iUXDk?o={u&$=z7W9!g=>
z?u*vl>vjM5&WF0Vv|-hs{9O==WDN$rRwG}zFg|W3tIa`O_T|Ub%37WC*Jo(g!K=PI
z?=-gss1<vvjl{&kAFo4c>H2R^?X&AqJ?Yx)wtjx%S2SUj`c<YKK&?$K=$+Dku55J?
zqh^;MRlC&Dtl~TLH8CQTx7Kr*52#l@)(xq@H3)6$^;je~Wyk<?2(O~NT3-0x2`{Ag
z;tsV@WSOqV4ZeR{2)4ZH4EH_$ev63e7j4H!A99?)WeDF+J5@UjSu`2GDnQ*b9yAW&
zv|x0#+NV$zg36QsYhcygGUti>_!GL8ZF&hs7w9;yhkmP+?cTE62)75rZdVJ&vQaR!
z*rB~~4_|!ynLpNCA2%7@l=fKm&>!6|?Yh}+X&?8KWsw#q(%QmZC?lV@osXzK^?d!j
zQCZ{u-Fm)!@xlIBs8?;9uYQk)wl?qQ;h1Wa>3iJ|t}LUZYbEbD3TPWa)3G_Q>$Aa*
zHR}DwSu^YsttC-2zD2>cXweC+8<MU<IjH`5_faYw)q!>)`O?}8kJd+6?M=z$F0EdK
z)27n-^ou}<7fvhOzBYM<n@X*e`{L?lV5J?|&b-&>dm+w?cYk$tUrS5N-uGSImP)&H
zd-nMat9sb)kiUk!T3uY&@W0c1*=+f6!j4LY@2cWyGZCSq%_mjA$W^Z7$($6u{tkQ0
zbW^(sEqj!b4$mIN+0Uep@v^KIo7M)gd2d}A99Z?!>pAayfP*%fqffPIby&$=V?}rV
z>)mj}I2O^DeoEm`R9lOw%SZK~lsQ?uYu-8YHSY5oNmCj$=JWa6S2DkV`PN-(e!=%U
zQCmA=3(zW+)mJtM2&W~)^p^e`lvZS~3bgLD6)laD$FRs=v9zYS6)iA1RiaZC^7q(@
z%1ER&w2n5@XmEfYGAiRHTGi}mGb2Fl)^1&pvLR=0S|+VN+gd}b6)@7M)`!0MSmlVJ
z-`S$I%RAIZDjnAcs^zYh;s4Ro;WR%{c;)-7Ivv!<wu8pGL)D75y&?29$~TVhLuh&Q
zj}Bt%@c|oEU8{bSzsbDqkI(Kjx24_%mi7*VekG+1<&f5>E~bY$hx&;yYx4)H*w*ip
zJg(Nl<T{#Ig<z@DW>@s(BHiMX0*yCNc$L&M`+E+PekP3S58V^ALy{H4YTxXm9NTt;
z;q<&pPx_}(q3qiQdjF=J{fzDByZo#9KjZx?Otzn7vIQ!onO_CaCs_2|`df}}^a1BD
zYBfHZT3^!Ur6|~-|3K_q`s|Ok5u^REz6he7E<4f>pwJh!R(k&v=d4S^bH$rg@n7lB
ze9s|VdA9IBmqXhUsNJ+0&`l(tA37V;cOh>(u6wVXF(H7~Myq813iH~`QN14=P8P?t
z``zK7n|5gce_f9WAxcQ^ZoJ1m-uVf=)1(!8|Dx|IDAJXHDw8tK)zfUrRQd@pTGdaV
z7X{PDr*~VnV(XB9t;~69?~>mfv@nKxCHj)tIv1f{rZ=NCXb*6>`V2=a!+0fd@Ncvr
zm^S_lrai+=`kPkJd)uPPzCPw`wGRsIq4Ay{Th5NOM%cG6Wr|;;qxzou%YcoJzrmR(
zb&;NNw4>FW)<m(Y0czddQ;vy_muagGX}eWJM7vn$T-igSj4`Wqr?#6~B-(a^J~LdR
zwpvg-2o{Rr|I74M9r7AqT<v!+{mmWnI5*}dDxQ8SUn?E$>EqMo>YE-_ls@KE{mr%d
z<Ida7bq=+tgL<Klu}tqz>8iaV$5p0Z7g!KbgC5^$4ZG!=)uvRS)qL|Ejt#WsKEBuG
z8&utDS7r@WIr$swTxG6^%SM$$$pee}+iQ6+%8kApqxm1&9^(k|XKM?*=Ip$=zqnR<
zUU8^Zr(SIMI4jdv0xC~vKh6iV{y4}%n_bd=Qf93@)7b941VGudt)451SK99)i~Z8p
z4bZbqrb8`Qq(UgItyj-A{^!{IPxUEZhSEDBnpmO5K-SdP@_?{c={H8zjfhrRl?kq=
zuYN|(`I;BJ>_|~x1Wuygy{09pwDoF``nF>o?H)?I4bYcu^c8=Q`ih@+i?~FeN6@w!
zf$D3V9oAPmuLjWyHC4{mhuA4<pDtN8``;1j>u9RuA(Qrld`FcjnRbpRdDO8rkT&yp
zRXu>K<kSS;!||_N`I5a-@^$L>BI&)ELEo&LQhNb)wN$IBQB<nhOJq<q^%JWcarCEb
zC35v;;~`$lL!)k2A2d7?zv;@*{eKu;-M2`!)kIpn*FHo(+=*0+$OgqPxw6*VhmtB!
zU;oOukX54E)_T|iO5^I8@m|GI_It0aGj=L{@A(Ym*Benyx%xfg{e0>DH^tlLpluhd
zuM*Ze%uS(=osI^thdQ37dnMFC`>4_{y1uR&s1IpN@-WBIzy{009Ls~uX<?2nLFT?N
z<73ri{l_#HggY*o4Q7Ws=<Bp|VUE4Q=7-_NH)@nZTcS^maLf;B;Er(Y4l%zCcbp1Q
z+s4z!-d}|ppVEiYp=x7v+H)w(+)kg-(hu{689yqpD%{*ezgiHkOcjL_px=edi7*yN
zsOY;Q2wZ7Dut&rlY6p;isaLMl;8-_M?PfR6F^$CzlRj5|+Yw8DpAJwTFn=7_n*M$T
zgK4i3Bv+>^Ks{3ZbNo{R|CGQ#CGbxP{8Iw|l)yhF@J|W+Qv&~#z&|DMPYL{gS^}48
zhDIIB)yD^P45U3D)Nwy;O{$LAm&#jmcT5#a_Nu}1G7byUe|lJW$hlh9pTRC(H{1?#
z6l5M`ms)&Y;<*qn7yJ}td~Mdd5AqzO#7joJzI9kH8?pd0;u_{2NQsw<ctO|l`9_fU
zK`w$!s>|mkUOM9C)MUOFa`JpG*KA19KMwulA@mA@j=G^N2Y2H5nS<^2Q-0y{J2#5;
z8mmo-=@<-|1KDCUbL%Ai*BkMgBVIaWVsF;V?9cMxKzqCl#LI^M2NJI%>rK9$<=(FL
zc$tXzW<%!96IouU$+GJ;EKjy%S>oq;&R<Y9`Xq*qwvZzsH$vW4ozF|Wv4}Ud2J<|~
z<B-#9GG7Skti|EV^d?sw?%EtKuETP1U6$)03m_%E)L+@pzO?<DIx-<o(yXdF9zV)*
zBcuiCzjVaQgZ@#-^G8^}G2-`!lz2%OkX{eIFS8-1R^#v@$ZqPRKsr{`Vk!A+UXQ~A
zAWO^N*nrxWoeP8c{!bpla&vo@pFuY5!r_TMSW0@+`*U~=WNGPTA-$nbaJ+etGauma
z3dk+PIXv|-mXco5;~ee*Sz3BINN?sWj<*AH)i@64L)N7a=hYE2ou#A~PrK%*qb+1<
z=@kTVdCp9v4SDD&gtP+mUlGo4xy*JCK+5@qV2)omG|WOnA^SQxEP83syBNj19?rYb
ze$Rtk0V(muBHpSh9510F%bt*zz+JKS^dx@bPVNT``ZZW}BuO~JVTBt>*kuKc#uAR;
zaB~UsZD6Dz%&`rl1H#f8b`gD~*A3wy*y}Cl5n+IYQ#ifBqR&BNn4EVp$dE7`7%gEZ
zB0%KF@^$&(aayxXN6-^28$*tTj2Oop(TshFmjS*8@*rgGCs}_Zq{J&mytwgvzBgnh
z<PONRf7{bbDaU>`dXoF^3`h^;5y-LQ`Mjjp8}SZ+$Nihn-v&7ovNmm7=6z%!-c;~y
zkY^#2C$RnwNQs+?cu5oa{0PX!kcS~hPqL@yLA?Fov6K0HC&(F)t||6-d5AX|d@JM`
z$fi?Se><f3S%`Rv)A;;w$VHGvkfSo~=^aPBec+Yp=TOwq0dhKI{B(OfBZRNtMDTpb
zV#vnyE2`=!fV2YiUo7G^n8D|VK`w+m2s!c@dwNNTw--ESCZBHynF(2)epb)>=!AGN
z|6<-2a{eI>uYz=I@zM})B=kLg;vLZ9jYYgd=wI>^FFDKZXBOfmj$+;)QulM77B2_!
zW<dW<Kk<sSc=?ET0{XF!a=LnYUFdgfypMf|*9rQg{lv@B;uRy_O6c$L6EA3vJ-v`n
zu4h4`nKy#e{Y=y1xe)I@=x6zfw^@sqjClFbKc&Ung8C9W*Y0OJ;>C|)J{+>uU|M(T
zb-1Co2<P`h_8nx`%Z6UqShm**vfw_uUM}>;;(X*|te+9gdQ&0SLoR~c0eJ-SnsTh)
zA95aKA!KX_pU;9kj|VDA{}|G5iS*+TuN&la$oC;5VP`624rH-r_ea?62)lWgSV7Xg
zg!6adycG3uluHNN)>0jfkFxyVDi=w=D$*SU`B%$D?AC?7hae^2Nnw1y3_y9zfDD>#
zA18H!-e#OX0qM@N>xEQhd)v@|2e`Q(Zv;6SGHimqe|I6?2=LXA2OwP&S${pG_@9h;
zv6J|GPspi|+aU+gj;P*8D&lPwK84RGL5_k9nQD)hj(EetS3&NFjGxB(>mVgfH{w;!
z<nuisCqouM_J7KrUN++8gI|J7oX&b9A%mZ`$IC^$Vc<EC`yi{&VEtT3@v{K&VxHmi
z-5@7IegN5braiqP#M=UX5wgK7*2{nl%Cg5hk9g_eD<Stn#?5B^HIU+`Gmh(7^c+5)
z3h9R22HAVAJ-r0P+YEjIvfez_8vz;ctUX=|;td5~0l5b<c0TK`h7>=0Bc5{spYIAe
z9&#&W&un{o8Ho2L_<6{L=U8tzByCwNNm()z@dkr0gZvD#^7E{}3Q{6_5HE5OpYH-W
z4l*CI#|!rK@(?d&81oU3dC)r!8M)XVuMqJzhx2pSB}nn72<I2W-VR8;AFr#~J&$-7
zp<nMoPFIgNQH$rS#`UQ$^fUd$JE+A=K)gKYABAkbgwrjClzgQ?zw&TC-wv|52l|kr
z-y8a)ptnr)mqH&>^fRFU8T5>YSa0MqmI=#Qihd^alb|<1^r0u?-KknU58};){$@xi
zXBqeOU13iz*~R5NV?Ot<J0SC*7xEnQ&k$~e@SBU7C(_R~s^c*Ig10)tR<ewTbkWZ?
zs^hafmWf+f7Qe^xDD1A=#QoM@$mt9CycL=LE3VFdo<zQykKlZ4ev0*yrn8Kp-xgQL
zdB_7ZIGq0s%M~+OX3k<cJd0&l`r&VNG@8S*@?4e|AP>?e+v*TMw?4~Z3(|jiDE}?x
z`2I-_!Tbdj3UK}c^4sb~`*qld^CQ4>we#t?PD%H0y7M55px12x^XBV${5TZh{sWnB
zhaA3=(_Qm2%k$vbt2jI|jr9*eCceTvXf;d8zg(vt_p-i}LpJ<OZNfYYG8XZ>Hf5d*
z8QhY?jc`5<@<cN8;G0<vgKXZ6!{cvZxf60;3l7im<EQvn0RMKnSpOpAO2o^m!8{+~
zJ&*yfa{iMb?}I!8{kriSuUk!)^KgC(<N%~|6k)v_#lQ3LZy4%#Hsl4wi&?{dBtW)+
z90r*UxgB!jWgho$hr9@0cP-mVg&YgH71E!73AOn?EEvJ@FF>w2%IQcx3Tv@my@y#Z
z9WwHDyWVl=W#jx_NMoH{&p^7t8Emf|WYgE|dg<44x?R^Y9|tLZov+E~M<M=J$jL9U
ze)A<PdqOUT?7M;QtDZ~w{NiOSTfE3}8RRzTkM=NM1pWCr91cc2@yChl?Yb$_LIWT}
zVCR3zpEK}F_a`6iY`2B%?-`Vj>k%$@@p~Wi7Ve3%(0RyH*&HwEIhF_Jvy^yQh?g^(
z`BBKqV>rATQuLE>J&T6&`JMOM?HxzEnF{}AYJR$rUh+VW*Ar6gyKw$OcRoL$hu!|Z
zYq-ATwq$;$mHm7^>eE3d^So%t>MSE&EVtHT86VGbXl<6+kdy0h__k|U<|VOgdlSpS
zO<3kY=HJZW7R^}BxSr)o$c?ZU342M97ja&m|Hc1T;P)}ePW9NHlv5{^)A4ZTT_afj
z*?L;{7Ov-Iy>FzR)=uVlO(Bb5$7sPk8}kn0XFK@!BxG;IJBN795Kr=#gZy<0<$TSD
z`~b2O@;v}j;^m`V+Jbr)Hj?j?%4c{y)AmP}`{1AGhv2-}*#|q#5q~sf(svx+RcyB-
z`dh)pPBHAPMEt{=of)U>c0@n%G;^^NQitn(^uIViT_MGv*dOe6M1LW;*m1$mc*K8G
zv$NuRyB*Q5d(!StHtd{0{JNvqucq`<Q0nM**ltJk6L4Pq$%UPsh(8B%^Vb}|{{g!l
z(O-k}Vy6Ihwj%x|$VK$)CF*DZDc4=}=YWfy1hg-Sk8*w<hur!(+ZhQdc0@l9T<r8l
zKbng1^F&BFpN{jr^VsfmNI5?i=a18mAgQC(8!Y8~Ce9Doz&s05&S&F%`g%UU8dA<@
zqF$~-{`Ns`d)1y!Yz?k=GgdI)4w>~Lhc6&3c9WoAu#fwp;4fJYqhI9kJ~}~fYBuwe
zkjrXt`;iB^6Y>aTP&}WX4|!hN8Q41vJJp`Er<a5B2pP@Sbr@v+Gpx5CGLn8XL>+@6
z>(1iv;|OO%wgB%2xe<H^<XG6tg6sr&1m`b6IuSn&=hG1$4>=EV735aPeUMV79`wtR
zne1-^NICCD`7A`f&qMYs&*ix+isd!m^0-RkWg}j~7%sP-kO>!A&+{|Oy=(cr#LJa<
zm-+lq$kO7SN4%*>XFcTpBW!2;_bm5MV}B*Rlz6VEN1z`)mi>|EZFx?Q&9(d48}Zsg
zKMPXQTlO8Nr<Y46;^jmC667e&ejfA^ALDd~L!Q#~ilDa$=eI+O|1w_?@(ueV`A)!i
zrx@>1A`kO<i6{9M{S@e5fc@mh*{}51?B$XTy~E(?(3=k__Ht40((!z~5^^tOTqr+x
zuYr_!1&9|N#^+NZ-H_WLdu#JvMqR$no+=!#Eo26y*iVJt#M-Qv4_S!yY(<b=;`zM9
z`$zt@5^!U^TUo7Sm7+hcNLGm0ExK;v>!!!|_~EX`e)RotR}<FP^OFWH-gpo$(DG5F
z>A9NP>sg8x7JDK+Eq$k7avtmNBwSYMYU8^c^1(g2-L|Z+^Atba4X*o>*1?|tWUS}Q
zE6)ppjza#o>-lD2o!>IZJV^1Q2<gi@Lg6A^9etOJoOgD%`!8H%${qIeZY^wdwVzMX
z!X7Pb+-cW$V_l)7S5}#(+3{%MB7}AO&Qwlc=Skp_eufryVjbhWI9`vq6|%SbYLyOI
zr#S-QZR+<8>5z4I7o$1ss>rgmb$9u9v7dggYY*S&^WbOK0i4b_$l$v<EPnc1Pg)&%
zeS4S9&mup5Sed8)I{jA5`g8jeZ0|f|^uV(DlK{Q(kCx4!lwQ8er4W8BbF-a7$e!cM
z=Erd89eA>ge)RV3NBTuBk4y8|PJ?GzHl0v5KRQiky)`pfmR65kec2DW9z_W2^{N<t
zr7ebC$P@5S>Wwj<&!2jZrPS{~yAIjt@4I}){?6r-yqxV1g{%!Je$?~u`K)Ds%@4O9
zKa5N4hbxEecZCdt6hES0<nv=+`fGlq-Q&AF<ho_SpUpcsoePi$G=Kcv*Jq%YzMA8g
zR&R`fzWs^4%;l0u+dryf9OTIZ9F}tN=f|l}STFVqmH~+GZ@s#4uWvs*@MG#RwzD2`
zKkSJg#RxY)$a+#=FCFG^?Qd9?Rvu~h`Sv5h;BkA-akg_5vhsHv7C#ywT>D4n;>Vmb
z9Nq|7svm=V`yutjHI&awxB&j0ugB}No7QJ}Jd~yQmsK158kXYUCFljjFmDb!{;pR(
z(%0LUR0o$+!HsO^9OOLsBYya+H>;pGq5;P*wVdwvT~7PpN9|^8Cl#`PBMz75$4KZc
zY*IEqiv9SJ7Qp2Z)12*egPaH{etg!7&u?kXQm#uj^d4_fHb08eeV2#(K|lN<-@Isq
zZ=Mv$`Kg`D{-i-(#P<o3AAi?3I*a3-e2!(#3oQNCvkc#U<iU@1`5eC(((@XJOY>tR
z^kO!!erfg0HPW{qDflj;+jh2-1sMZbnjc%=<#+==WLXdK{FR3>%C{fI@FNM|Z47|?
zZ=XlT;=4M(evDy1<hu}Qhtj|$>_%8`C*-_H&v>>cVdLNSaGDm**TN<7{^TDibL{Cz
zbl0<X?$*L7_#Q>{{mIla>gn-|ke;4S%6z+D8Cuwbu>Rar1n$qDRIHEv;2f_vFn)p5
z9n-?AL+$f<+G)SR(b{_HG^{`M8v!TWpK<>6d6Tr=zIn<X-`w@NZ*J`M&5Qi-{4ad#
zr|t92Q@-@gi~R8X{l4|xUom%Lo>R)rb-*{z_rue^_N{Lm^vykfc*=kL==<R*MSk@C
z@RUQWe;)J9l3x$FgiGXM*6)pZTHz^vxZ4lU2Uqa}=%1{&7JITDAfS^&kR@H;aQZ5s
zzThmtdpTu89eEPQ_hIt>!_dCpN`oE!{_yzWMPBKubYk(IO#OYeBLVA1uBP+9c`hIC
zyULoTex3crOU8Rv{k*(~miMCm^fGbX^!R$%t<^jIydKUfqkeK(ujijEKk+B|PsZz1
zMtxaFDCzv&(%<?rxzGOY^yGg2t9G-?Sf6srsMo2C_2aMl{eKp}jQ7d^nSXu~&Mo70
z@sv?dPsUZoa&eYXFYUkdL-$L<WB*Hg1$dt>c0|hiZ3*k|?~BS9Pk%4&)W#QLUr$ee
zf1gmsczSvn|7ARnpLpW0$U;AQdVX}j^l_HhllSuSK3}*<eLN~$;_2`6<$P~#94lOx
z8D-SVETdkkpK*_Tuh6AGum6$n719u%3Aq{a6r}F2>mH8(CS>ga9KH?G-}ee)$L+^I
zS*I_0(!b`nWBYp`gI>qF4Q-wNah#WR`UUMd-inSaOIxQe>59zt<EO0CkA)u%AdQ<j
z9etgCVH4(JS7h_1%m+ixgxm;O+B*FrKmN%&{S^3B)^+;gm&hK7udmY|oWy>Ywoc#a
zXB_q4uG1I4ME=!v`l)`#&0=51&HnT<{lqWw!*#p<^kV&ti&Fe>-L5~qv3}yG9J}&d
zr)+t&uyNdeK1~bfYhl-Sc73-NF4Dp&C+zwjEo^*mKcA+B^R=++q+Q>wg^RRs$`7os
z&%fmR;VGy5==<R*r+w=e`Qh$j-}-4k`sS`PzInbMp7xV(eb-sv+~bEEKl|2q`{6}?
zc-lGNcJlr3lwbVl`{8Nled`zb;hu{0t5IG@%C8(>9|ySo@O(eqxWIPw=g|~D+~bEE
zzxlS42Cn;A1g?*NTv|R|7ul|4-J^wFzh618=6s4}+>QC3l6fOB0Ga9)Pt7Qm%nNCH
zZZAD$U%va1`6YRd2uQa_%=L<=&J-f7&$kqVCuseW>k{WnpRY&(*XKRb!1Z|oH@JA0
zkMJL!hc9z_`twZ^xQegxEYB+?`Pa%@(n&=;eO#OYF6(|pKMP!c4#@}q<8ubz54!yn
zgSk^1kEem_&kr7O-A<9%(Z;ta4z{16+XvU}c)<1Nh$3)({Ok&VeJ$NIa49bj!utJF
z1TO1+Mc)<3c6FW#UL@BM5!~SV^Fltj?za)d_H~{DE`GQX)}N1yH9e=v_EbEpuE9U4
zcQQX0fcsqRry!o(r^4Of`uuCYS2{|!7-9W+#TCr{==WC|xc>a$_M@K<u8-r3{OG&N
zak~1rIt5(!#|^HJb3K0ai@>FvjF2nku9!;;r)c3cE$r699xa@&g^Li@=hKQcJy$6E
zrO&gc`r#RVcow+iH&+W6YT;sp_5Q&b#{TH@ElJ>FKUE70&(OF>3l|}*kMmvOoUT4^
zp5}*p{O}?_+!ew0^>ov~mH+A<l=*qNALY3tAVG4-GT$qnBChgmUw_U>^TR!UcoDd=
z>B}E^UeWz=MRNKoo;uPH)}K#2UV6Ul%X5ovzsM_|vhRx0($m6OS~yn=7i!^Rukh8z
zEl#IB-6SoXriHV-!dJ7K>!qjiSBS8Fe-vwa&I+18S~v}1{dp%Pn&aub2weG~jtp(w
z=&Z!?^nNBC-+OSZvj3l7neFNEi@@cr<nV@UQ^HSZ;VD{pF2W_N0Ma;SdAQcN4v)*K
zBHZbdTGn6H5Ke~t`O@Ww)t|Z8MweH?8Aet-EAXlp!^p<In*8+_)&E33FJBFFE)Am+
z<C6bnciyoHwJj$1ePIl%Kp4EMsbR>d{CHc=kMOiq)|YNO^9+Z1S7`&IF2jJ^vW=+m
z+hxulS+k<jc4St5U3YSP`n=ByBYOtzXJ&<qyYTs65pEy}GydEDAM2-HrQmv|LZ(4x
zK)NBbAU%+|kok~>kVTNikjA}SzD`INWD;ZwWGZADWCo-gG7HiJnG2Z@SqNDKSqy31
zhx8#`kV%j!kg1SqkQtC}$Sg<?WG-YrWFce`WHF>M2<bz*Ad?_dAX6dJATuD{kXeu(
z$Xv*L$U?{>$YMxiFw%!~K_)?_K&C>bL1sX@A+sPokhzfgkcE&%kj0S35Tp<3f=q%;
zflP%=gUo<*LuNsGAafz}AqydkAd4Z5p-3On1(^hy0+|Y#2AKirhRlNWK;}Z`Ll#07
zK^8+A_al8s7i1D-3S=r|8e|5f8!`*h1DOk%4_OFV1X&Deq$7Pu7i1D-3S=r|8e|5f
z8!`*h1DOk%4_OFV1X&DeJb?5eU64tTDUhj<X^<I^ZpbW14`eQ6K4c+e5o9r>F%0QL
zx*(GvQy^0z(;zb--H=(39>`qCe8@t`BFJJ$<3Xek>4HpxOo2>=OoPmTbVFuAdLVNl
z^C1f%iy(_3jp0Zi(gm3WnF5&#nFg5w>4waL^g!l9=0g@j7C{z68V@0TNEc)hWC~;|
zWEx}!q#H5|(gT?bnGabASp-=OX^cSnkbhf;`WFp_B=I;!H}h6g9+_-`{0Q<($fJ;_
zAye8$8ON=`&(K@dm`cV?x?Kt99H?de>4p?8QpQagtJn`2uVf=E!;^f3Wn6X~;V2k#
zzQXZkT$haS-VHMHk`(Ro)m?o4HOLK+n;_qYd>8V4$d4d*L4FDOHRQLDXCN;^Mig>-
zQIOG)l_BFG;~{H9)`hGGnF!ekvMFRU$d-_8AlpNBhP(q(_IJMv;rk#TfqWA3DaiSd
z9>`Z9H$(1(`~vb2<T1!okUvBI25EfC<q`xL0vQQe5i%CCI%I9g1jvSvH$k?9>;l;v
zav0=T$f=N-kkcV&K+c5Bf}8_64{|<aHsnIcMUaajJ&?;FS3s_W%z<15xf*f}WG>`7
z$n}sLA@d;Lgxm?a5Ap}d^N@j9*SupBm%kI?Xh`|}f*6E%La#Eyv5;|))gj{{U66Ya
z@5e=)PHpf)@M{pR3n{;gkbv-K(5r{A{Ek8cgb%@PqMV1k74j~~A&?J3=3-ts#Lv2&
zj<??0+?8<meUFY9^{A^^V&lZ5hD{!|LN{K|VS9U`hg5G6Wc+wp=j!>+L1$**LDB_<
ziX?sMtLHxlJw>`d;r0~jMgxn-8d(}|PCS4X^=6IZ{z&v&fahymJvJ(R<4L>z5aJG_
zhEbTz{fC?#1-=hl+Ubd~lcm}5m#>+YohnAA=Ku2+k1>iG+VlG|>=)POdPG6%*gz8k
zzRK+#I_of^jgTbP7ytKLysDA?Gus#c!%0Dv!$SC9lg%5~fN!6}7UICWfFA*u`2yAb
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%0DgrkQ!-aIsq6
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%0D0l7X`QkRqcGm0ymOX1M6oZT;a}Af8+)}|w*v?NT
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


From 4eff12e5327a593b3fc37159cbff6f2792576f64 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Wed, 28 Sep 2022 09:53:13 +0000
Subject: [PATCH 075/549] update gitignore

---
 .gitignore | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 83d29ad3..3664a149 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,4 @@
 .devcontainer
 ArduinoJson.h
 workflow.sh
-output.exe
\ No newline at end of file
+output
\ No newline at end of file

From ef5fd826d1fdf0851d39e59b0c8eb9a3bfc53f95 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Wed, 28 Sep 2022 10:11:51 +0000
Subject: [PATCH 076/549] restructure files

---
 tests/000-testsMain.cpp                 | 8 ++------
 tests/initialize.cpp                    | 2 +-
 tests/testHelper.cpp                    | 5 +++++
 tests/{000-testsMain.h => testHelper.h} | 0
 4 files changed, 8 insertions(+), 7 deletions(-)
 create mode 100644 tests/testHelper.cpp
 rename tests/{000-testsMain.h => testHelper.h} (100%)

diff --git a/tests/000-testsMain.cpp b/tests/000-testsMain.cpp
index 836dba68..a50f2392 100644
--- a/tests/000-testsMain.cpp
+++ b/tests/000-testsMain.cpp
@@ -1,13 +1,9 @@
 //000- prefix is for the main-file to always be on top in folder view
-#include "./000-testsMain.h"
+
 //use the main function provided by catch2
 #define CATCH_CONFIG_MAIN
 //include the catch2 library
 #include "./catch2/catch.hpp"
 
-void cpp_console_out(const char *msg) {
-    std::cout << msg;
-}
-
 //include the tests
-#include "./initializeDeinitialize.h"
\ No newline at end of file
+#include "./initialize.cpp"
\ No newline at end of file
diff --git a/tests/initialize.cpp b/tests/initialize.cpp
index fa3a156a..782d5a3f 100644
--- a/tests/initialize.cpp
+++ b/tests/initialize.cpp
@@ -3,7 +3,7 @@
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include "./catch2/catch.hpp"
-#include "./000-unitTestsMain.h"
+#include "./testHelper.h"
 
 TEST_CASE( "Do some loops", "[multi-file:2]" ) {
 
diff --git a/tests/testHelper.cpp b/tests/testHelper.cpp
new file mode 100644
index 00000000..15f57b91
--- /dev/null
+++ b/tests/testHelper.cpp
@@ -0,0 +1,5 @@
+#include <iostream>
+
+void cpp_console_out(const char *msg) {
+    std::cout << msg;
+}
\ No newline at end of file
diff --git a/tests/000-testsMain.h b/tests/testHelper.h
similarity index 100%
rename from tests/000-testsMain.h
rename to tests/testHelper.h

From 7926b75a38eb30ec698261ad20738cb65d079fb0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Wed, 28 Sep 2022 11:19:14 +0000
Subject: [PATCH 077/549] initialization + deinitialization tests

---
 tests/000-testsMain.cpp |  4 +++-
 tests/initialize.cpp    | 31 +++++++++++--------------------
 2 files changed, 14 insertions(+), 21 deletions(-)

diff --git a/tests/000-testsMain.cpp b/tests/000-testsMain.cpp
index a50f2392..9d3e3e5a 100644
--- a/tests/000-testsMain.cpp
+++ b/tests/000-testsMain.cpp
@@ -5,5 +5,7 @@
 //include the catch2 library
 #include "./catch2/catch.hpp"
 
+//!!! following lines not nesseccary in the current test pipeline; all .cpp files are searched and compiled anyway
+
 //include the tests
-#include "./initialize.cpp"
\ No newline at end of file
+//#include "./initialize.h"
\ No newline at end of file
diff --git a/tests/initialize.cpp b/tests/initialize.cpp
index 782d5a3f..8b2923f0 100644
--- a/tests/initialize.cpp
+++ b/tests/initialize.cpp
@@ -5,28 +5,19 @@
 #include "./catch2/catch.hpp"
 #include "./testHelper.h"
 
-TEST_CASE( "Do some loops", "[multi-file:2]" ) {
-
-    ArduinoOcpp::OcppEchoSocket echoSocket;
-
-    std::cout << "[main] Enter compilation test\n";
-
-    std::cout << "[main] set custom console\n";
+TEST_CASE( "OcppEngine start and stop" ) {
+    //set console output to the cpp console to display outputs
     ao_set_console_out(cpp_console_out);
-    
+    //initialize OcppEngine with dummy socket
+    ArduinoOcpp::OcppEchoSocket echoSocket;
     OCPP_initialize(echoSocket);
-    std::cout << "[main] AO initialized\n---------------------\n";
-    
-    std::cout << "[main] enqueue first operation\n";
-    bootNotification("Test charger", "Test vendor");
-    
-    std::cout << "[main] handle WebSocket traffic and run OCPP tasks\n"; 
-    OCPP_loop();
-    OCPP_loop();
-    OCPP_loop();
 
-    std::cout << "-------------------------\n[main] test routines done\n";
-    OCPP_deinitialize();
+    SECTION("OCPP is initialized"){
+        REQUIRE( getOcppEngine() );
+    }
 
-    std::cout << "[main] exit\n";
+    SECTION("OCPP is deinitialized"){
+        OCPP_deinitialize();
+        REQUIRE( !( getOcppEngine() ) );
+    }
 }
\ No newline at end of file

From de27f1428c9a52834724970ef91ec6ddda27ee35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 14:23:39 +0000
Subject: [PATCH 078/549] file structure restructuring

---
 tests/000-testsMain.cpp            | 11 -----------
 tests/catch2/catchMain.cpp         |  6 ++++++
 tests/{ => helpers}/testHelper.cpp |  0
 tests/{ => helpers}/testHelper.h   |  0
 tests/initialize.cpp               |  4 +---
 tests/triggerLoopCallbacks.cpp     | 27 +++++++++++++++++++++++++++
 6 files changed, 34 insertions(+), 14 deletions(-)
 delete mode 100644 tests/000-testsMain.cpp
 create mode 100644 tests/catch2/catchMain.cpp
 rename tests/{ => helpers}/testHelper.cpp (100%)
 rename tests/{ => helpers}/testHelper.h (100%)
 create mode 100644 tests/triggerLoopCallbacks.cpp

diff --git a/tests/000-testsMain.cpp b/tests/000-testsMain.cpp
deleted file mode 100644
index 9d3e3e5a..00000000
--- a/tests/000-testsMain.cpp
+++ /dev/null
@@ -1,11 +0,0 @@
-//000- prefix is for the main-file to always be on top in folder view
-
-//use the main function provided by catch2
-#define CATCH_CONFIG_MAIN
-//include the catch2 library
-#include "./catch2/catch.hpp"
-
-//!!! following lines not nesseccary in the current test pipeline; all .cpp files are searched and compiled anyway
-
-//include the tests
-//#include "./initialize.h"
\ No newline at end of file
diff --git a/tests/catch2/catchMain.cpp b/tests/catch2/catchMain.cpp
new file mode 100644
index 00000000..448c1e5c
--- /dev/null
+++ b/tests/catch2/catchMain.cpp
@@ -0,0 +1,6 @@
+
+//use the main function provided by catch2
+#define CATCH_CONFIG_MAIN
+
+//include the catch2 library
+#include "./catch.hpp"
\ No newline at end of file
diff --git a/tests/testHelper.cpp b/tests/helpers/testHelper.cpp
similarity index 100%
rename from tests/testHelper.cpp
rename to tests/helpers/testHelper.cpp
diff --git a/tests/testHelper.h b/tests/helpers/testHelper.h
similarity index 100%
rename from tests/testHelper.h
rename to tests/helpers/testHelper.h
diff --git a/tests/initialize.cpp b/tests/initialize.cpp
index 8b2923f0..842b9aa9 100644
--- a/tests/initialize.cpp
+++ b/tests/initialize.cpp
@@ -1,9 +1,7 @@
-#include <iostream>
 #include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include "./catch2/catch.hpp"
-#include "./testHelper.h"
+#include "./helpers/testHelper.h"
 
 TEST_CASE( "OcppEngine start and stop" ) {
     //set console output to the cpp console to display outputs
diff --git a/tests/triggerLoopCallbacks.cpp b/tests/triggerLoopCallbacks.cpp
new file mode 100644
index 00000000..ec9bc2c2
--- /dev/null
+++ b/tests/triggerLoopCallbacks.cpp
@@ -0,0 +1,27 @@
+#include <ArduinoOcpp.h>
+#include <ArduinoOcpp/Core/OcppSocket.h>
+#include "./catch2/catch.hpp"
+#include "./testHelper.h"
+
+#include <iostream>
+
+TEST_CASE( "Trigger all callback functions in the Ocpp Loop" ) {
+    //set console output to the cpp console to display outputs
+    ao_set_console_out(cpp_console_out);
+    //initialize OcppEngine with dummy socket
+    ArduinoOcpp::OcppEchoSocket echoSocket;
+    OCPP_initialize(echoSocket);
+
+    SECTION("setOnChargingRateLimitChange"){
+
+        bool hasRun = false;
+
+        setOnChargingRateLimitChange([&hasRun](float limit) {
+            hasRun = true;
+            std::cout << "Has run!!!!" ;
+        });
+        OCPP_loop();
+
+        REQUIRE( hasRun );
+    }
+}
\ No newline at end of file

From 7adacc6601ce8530a2df895219aec38ed91507a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 14:24:40 +0000
Subject: [PATCH 079/549] delete callback test

---
 tests/triggerLoopCallbacks.cpp | 27 ---------------------------
 1 file changed, 27 deletions(-)
 delete mode 100644 tests/triggerLoopCallbacks.cpp

diff --git a/tests/triggerLoopCallbacks.cpp b/tests/triggerLoopCallbacks.cpp
deleted file mode 100644
index ec9bc2c2..00000000
--- a/tests/triggerLoopCallbacks.cpp
+++ /dev/null
@@ -1,27 +0,0 @@
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/OcppSocket.h>
-#include "./catch2/catch.hpp"
-#include "./testHelper.h"
-
-#include <iostream>
-
-TEST_CASE( "Trigger all callback functions in the Ocpp Loop" ) {
-    //set console output to the cpp console to display outputs
-    ao_set_console_out(cpp_console_out);
-    //initialize OcppEngine with dummy socket
-    ArduinoOcpp::OcppEchoSocket echoSocket;
-    OCPP_initialize(echoSocket);
-
-    SECTION("setOnChargingRateLimitChange"){
-
-        bool hasRun = false;
-
-        setOnChargingRateLimitChange([&hasRun](float limit) {
-            hasRun = true;
-            std::cout << "Has run!!!!" ;
-        });
-        OCPP_loop();
-
-        REQUIRE( hasRun );
-    }
-}
\ No newline at end of file

From 8ed6f20821114d31b31bc4709cd638ea4aa57603 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 14:54:14 +0000
Subject: [PATCH 080/549] naming adjustments and comments

---
 .github/workflows/platformless.yml | 2 +-
 .github/workflows/tests.yml        | 2 +-
 tests/helpers/testHelper.h         | 5 +++++
 tests/initialize.cpp               | 4 +++-
 4 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 988a5c25..6883e542 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -1,4 +1,4 @@
-name: Platform independent compilation
+name: Default Compilation
 
 on:
   push:
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 4ffe8ad1..9cb7ced7 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -1,4 +1,4 @@
-name: Platform independent tests
+name: Test Runner
 
 on:
   push:
diff --git a/tests/helpers/testHelper.h b/tests/helpers/testHelper.h
index 73678f52..202c2f38 100644
--- a/tests/helpers/testHelper.h
+++ b/tests/helpers/testHelper.h
@@ -1,6 +1,11 @@
 #ifndef CPP_CONSOLE_OUT
 #define CPP_CONSOLE_OUT
 
+/**
+* Prints a string to the c standart console
+*
+* @param msg pointer to the string
+*/
 void cpp_console_out(const char *msg);    
 
 #endif
\ No newline at end of file
diff --git a/tests/initialize.cpp b/tests/initialize.cpp
index 842b9aa9..bdaa8308 100644
--- a/tests/initialize.cpp
+++ b/tests/initialize.cpp
@@ -3,9 +3,11 @@
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
-TEST_CASE( "OcppEngine start and stop" ) {
+TEST_CASE( "OcppEngine lifecycle" ) {
+
     //set console output to the cpp console to display outputs
     ao_set_console_out(cpp_console_out);
+
     //initialize OcppEngine with dummy socket
     ArduinoOcpp::OcppEchoSocket echoSocket;
     OCPP_initialize(echoSocket);

From 45cf44344eb91fc24c2ad05c2c783b40d9dc5197 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 14:59:44 +0000
Subject: [PATCH 081/549] more coherent file and test naming

---
 .github/workflows/platformless.yml                | 2 +-
 .github/workflows/tests.yml                       | 4 ++--
 tests/{initialize.cpp => ocppEngineLifecycle.cpp} | 0
 3 files changed, 3 insertions(+), 3 deletions(-)
 rename tests/{initialize.cpp => ocppEngineLifecycle.cpp} (100%)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 6883e542..d3c82ca0 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -13,7 +13,7 @@ jobs:
     steps:
     - name: Check out repository code
       uses: actions/checkout@v3
-    - name: get gcc compiler
+    - name: Get gcc compiler
       run: |
         sudo apt update
         sudo apt install build-essential
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 9cb7ced7..147c89a5 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -8,12 +8,12 @@ on:
 jobs:
 
   compile-and-run:
-    name: Compile
+    name: Automated Tests
     runs-on: ubuntu-latest
     steps:
     - name: Check out repository code
       uses: actions/checkout@v3
-    - name: get gcc compiler
+    - name: Get gcc compiler
       run: |
         sudo apt update
         sudo apt install build-essential
diff --git a/tests/initialize.cpp b/tests/ocppEngineLifecycle.cpp
similarity index 100%
rename from tests/initialize.cpp
rename to tests/ocppEngineLifecycle.cpp

From 529cd9b5386d4af042807430f8639691ccbabdda Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 15:00:32 +0000
Subject: [PATCH 082/549] reactivate compile test

---
 .github/workflows/platformless.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index d3c82ca0..25975b2e 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -3,7 +3,7 @@ name: Default Compilation
 on:
   push:
     branches:
-      - disabled
+      - feature/freertos
 
 jobs:
 

From aec5c438dcc1e3caf5ab8304015293eba8bbe21b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 15:04:18 +0000
Subject: [PATCH 083/549] deactivate compile test

---
 .github/workflows/platformless.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 25975b2e..d3c82ca0 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -3,7 +3,7 @@ name: Default Compilation
 on:
   push:
     branches:
-      - feature/freertos
+      - disabled
 
 jobs:
 

From ac0e9add577e0e54c122ec9e4f12e00d0ee6feb6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 19:26:19 +0000
Subject: [PATCH 084/549] update gitignore

---
 .gitignore | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 3664a149..6207a6bc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
 .devcontainer
 ArduinoJson.h
 workflow.sh
-output
\ No newline at end of file
+output
+.vscode
\ No newline at end of file

From 6eeda50f70aa99b8a6d5c63616af6b5f939d7d15 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 19:26:56 +0000
Subject: [PATCH 085/549] removed unnecessary code

---
 src/ArduinoOcpp_c.cpp | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index b4642ccf..69ae46e0 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -1,4 +1,3 @@
-#if 0
 #include "ArduinoOcpp_c.h"
 #include "ArduinoOcpp.h"
 
@@ -203,4 +202,3 @@ const char *ao_getSessionIdTag() {
 OcppHandle *getOcppHandle() {
     return reinterpret_cast<OcppHandle*>(getOcppEngine());
 }
-#endif

From cec815b3a5894e42b7216f5fb381cced06803b29 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 19:30:12 +0000
Subject: [PATCH 086/549] reactivate compile test without linker

---
 .github/workflows/platformless.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index d3c82ca0..877ae7aa 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -3,12 +3,12 @@ name: Default Compilation
 on:
   push:
     branches:
-      - disabled
+      - feature/freertos
 
 jobs:
 
   compile-platform:
-    name: Compile
+    name: Compile (no linking)
     runs-on: ubuntu-latest
     steps:
     - name: Check out repository code
@@ -23,4 +23,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall

From 9fb09ea2eb9da3f23be38cf5395de6eed13ff3df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 19:49:19 +0000
Subject: [PATCH 087/549] update gitignore

---
 .gitignore | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 6207a6bc..efe6b541 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,4 +2,5 @@
 ArduinoJson.h
 workflow.sh
 output
-.vscode
\ No newline at end of file
+.vscode
+objectFiles
\ No newline at end of file

From 55300fd9ed71fc037fb866826ac9da09429c9781 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20Gr=C3=BCnberg?= <adriang2000@gmx.de>
Date: Mon, 3 Oct 2022 19:50:27 +0000
Subject: [PATCH 088/549] fixed command error in compilation test

---
 .github/workflows/platformless.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 877ae7aa..b9dd9f7e 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -23,4 +23,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -Wall

From abd92767986bd8f115cdeba3e9ac8b5f8c8e2949 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 7 Oct 2022 16:14:56 +0200
Subject: [PATCH 089/549] restore files

---
 .github/workflows/pio.yml |  41 +++++++++++++
 .gitignore                |   6 --
 README.md                 | 118 ++++++++++++++++++++++++--------------
 3 files changed, 117 insertions(+), 48 deletions(-)
 create mode 100644 .github/workflows/pio.yml
 delete mode 100644 .gitignore

diff --git a/.github/workflows/pio.yml b/.github/workflows/pio.yml
new file mode 100644
index 00000000..819bc365
--- /dev/null
+++ b/.github/workflows/pio.yml
@@ -0,0 +1,41 @@
+name: PlatformIO CI
+
+on:
+  push:
+    branches:
+      - develop
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        example: [examples/ESP/main.cpp, examples/ESP-TLS/main.cpp]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Cache pip
+      uses: actions/cache@v2
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+    - name: Cache PlatformIO
+      uses: actions/cache@v2
+      with:
+        path: ~/.platformio
+        key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }}
+    - name: Set up Python
+      uses: actions/setup-python@v2
+    - name: Install PlatformIO
+      run: |
+        python -m pip install --upgrade pip
+        pip install --upgrade platformio
+    - name: Install library dependencies
+      run: pio pkg install
+    - name: Run PlatformIO
+      run: pio ci --lib="." --project-conf=platformio.ini ${{ matrix.dashboard-extra }}
+      env:
+        PLATFORMIO_CI_SRC: ${{ matrix.example }}
diff --git a/.gitignore b/.gitignore
deleted file mode 100644
index efe6b541..00000000
--- a/.gitignore
+++ /dev/null
@@ -1,6 +0,0 @@
-.devcontainer
-ArduinoJson.h
-workflow.sh
-output
-.vscode
-objectFiles
\ No newline at end of file
diff --git a/README.md b/README.md
index facb1c3c..fac6eacf 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,7 @@
 # <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; ArduinoOcpp
+
+[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
+
 OCPP-J 1.6 client for the ESP8266 and the ESP32 (more coming soon)
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
@@ -7,18 +10,18 @@ PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoO
 
 Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
-Full compatibility with the Arduino platform. Need a **FreeRTOS** version? Please [contact me](https://github.com/matth-x/ArduinoOcpp#further-help)
+Fully integrated into the Arduino platform. Compatible with ESP-IDF and generic FreeRTOS
 
 ## Make your EVSE ready for OCPP :car::electric_plug::battery:
 
 You can build an OCPP Charge Point controller using the popular, Wi-Fi enabled microcontrollers ESP8266, ESP32 and comparable. This library allows your EVSE to communicate with an OCPP Central System and to participate in your Charging Network.
 
-:heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve) and [The Mobility House OCPP package](https://github.com/mobilityhouse/ocpp)
-
-:heavy_check_mark: Passed compatibility tests with further commercial Central Systems
+:heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve), [The Mobility House OCPP package](https://github.com/mobilityhouse/ocpp) and further commercial Central Systems
 
 :heavy_check_mark: Integrated and tested in many charging stations
 
+:heavy_check_mark: Eligible for **public chargers**. Complies also with the legal requirements of the German Ladesäulenverordnung (LSV)
+
 ### Features
 
 - handles the OCPP communication with the charging network
@@ -32,54 +35,85 @@ For simple chargers, the necessary hardware and internet integration is usually
 
 ## Usage guide
 
-**This feature branch is WIP. A usage guide will follow.**
+Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. This guide explains the concepts for a minimal integration.
+
+- To install the dependencies, see the list below for a manual installation or add `matth-x/ArduinoOcpp` to your project using the PIO library manager.
+
+- In your project's `main` file, include `ArduinoOcpp.h` and the Wi-Fi library. Initialize Wi-Fi and the Serial output.
+
+- To connect to the OCPP Central System, call `OCPP_initialize(const char *host, uint16_t port, const char *url)`. For a secure connection with TLS, you need to configure the WebSocket in advance. Please take `examples/ESP-TLS/main.cpp` as an example.
+
+- In `setup()`, configure ArduinoOcpp with the hardware drivers. You can leave that part out for the first connection test. Please refer to `ArduinoOcpp.h` for a documentation about the supported EVSE peripherals.
+
+- In `loop()`, add `OCPP_loop()`.
+
+**Sending OCPP operations**
+
+There are a couple of OCPP operations you can initialize on your EVSE. For example, to send a `Boot Notification`, use the function 
+```cpp
+void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf = nullptr, ...)`
+```
+
+In practice, it looks like this:
+
+```cpp
+void setup() {
+    ... //other code including the initialization of Wi-Fi and OCPP
+
+    bootNotification("My CP model name", "My company name", [] (JsonObject confMsg) {
+        //This callback is executed when the .conf() response from the central system arrives
+        Serial.print(F("BootNotification was answered. Central System clock: "));
+        Serial.println(confMsg["currentTime"].as<String>()); //"currentTime" is a field of the central system response
+        
+        //evseIsBooted = true; <-- Example: Notify your hardare that the BootNotification.conf() has arrived
+    });
+    
+    ... //rest of setup() function; executed immediately as bootNotification() is non-blocking
+}
+```
+
+The parameters `chargePointModel` and `chargePointVendor` are equivalent to the parameters in the `Boot Notification` as defined by the OCPP specification. The last parameter `OnReceiveConfListener onConf` is a callback function which the library executes when the central system has processed the operation and the ESP has received the `.conf()` response. Here you can add your device-specific behavior, e.g. flash a confirmation LED or unlock the connectors. If you don't need it, the last parameter is optional.
+
+**Receiving OCPP operations**
+
+You can also add customized behavior to incoming OCPP messages. For example, to flash an LED on receipt of a `Set Charging Profile` request, use the following function.
+
+```cpp
+setOnSetChargingProfileRequest([] (JsonObject payload) {
+    //... will be executed every time this EVSE receives a new Charging Profile
+});
+```
+
+Using the `payload` object you can access the original payload from the CS.
+
+*To get started quickly with or without EVSE hardware, you can flash the sketch in `examples/SECC` onto your ESP. That example mimics a full OCPP communications controller as it would look like in a real charging station. You can build a charger prototype based on that example or just view the internal state using the device monitor.*
 
 ## Dependencies
 
-- [bblanchon/ArduinoJson](https://github.com/bblanchon/ArduinoJson)
+Mandatory:
+
+- [bblanchon/ArduinoJSON](https://github.com/bblanchon/ArduinoJson) (please upgrade to version `6.19.1`)
+
+If compiled with the Arduino integration:
+
+- [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (please upgrade to version `2.3.6`)
+
+In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
 
 ## Supported operations
 
-| Operation name | supported | in progress | not supported |
-| -------------- | :---------: | :-----------: | :-------------: |
-| **Core profile** |
-| `Authorize` | :heavy_check_mark: |
-| `BootNotification` | :heavy_check_mark: |
-| `ChangeAvailability` | :heavy_check_mark: |
-| `ChangeConfiguration` | :heavy_check_mark: |
-| `ClearCache` | :heavy_check_mark: |
-| `DataTransfer` | :heavy_check_mark: |
-| `GetConfiguration` | :heavy_check_mark: |
-| `Heartbeat` | :heavy_check_mark: |
-| `MeterValues` | :heavy_check_mark: |
-| `RemoteStartTransaction` | :heavy_check_mark: |
-| `RemoteStopTransaction` | :heavy_check_mark: |
-| `Reset` | :heavy_check_mark: |
-| `StartTransaction` | :heavy_check_mark: |
-| `StatusNotification` | :heavy_check_mark: |
-| `StopTransaction` | :heavy_check_mark: |
-| `UnlockConnector` | :heavy_check_mark: |
-| **Smart charging profile** |
-| `ClearChargingProfile` | :heavy_check_mark: |
-| `GetCompositeSchedule` |   |   | :heavy_multiplication_x: |
-| `SetChargingProfile` | :heavy_check_mark: |
-| **Remote trigger profile** |
-| `TriggerMessage` | :heavy_check_mark: |
-| **Firmware management** |
-| `GetDiagnostics` | :heavy_check_mark: |
-| `DiagnosticsStatusNotification` | :heavy_check_mark: |
-| `FirmwareStatusNotification` | :heavy_check_mark: |
-| `UpdateFirmware` | :heavy_check_mark: |
+| Feature profile | supported | in progress |
+| -------------- | :---------: | :-----------: |
+| **Core** | :heavy_check_mark: |
+| **Smart charging** | :heavy_check_mark: |
+| **Remote trigger** | :heavy_check_mark: |
+| **Firmware management** | :heavy_check_mark: |
 
 ## Next development steps
 
-- [x] introduce proper offline behavior and package loss / fault detection
-- [x] handle fragmented input messages correctly
-- [x] add support for multiple power connectors
-- [x] add support for the ESP32
-- [ ] reach full compliance to OCPP 1.6 Smart Charging Profile
+- [x] reach full compliance to OCPP 1.6 Smart Charging Profile
 - [ ] integrate Authorization Cache
-- [ ] **get ready for OCPP 2.0.1**
+- [ ] **get ready for OCPP 2.0.1 and ISO 15118**
 
 ## Further help
 

From c58653f3baeb0d366ac393c6ab1db506b58053b8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 7 Oct 2022 21:05:59 +0200
Subject: [PATCH 090/549] update platforms definition (draft)

---
 src/ArduinoOcpp/Platform.cpp | 35 ++++++++++++++++++++++++++++
 src/ArduinoOcpp/Platform.h   | 44 ++++++++++++++++++++++++++++++++----
 src/ao_opts.h                | 31 -------------------------
 src/ao_opts_impl.c           | 30 ------------------------
 src/patch.cpp                |  6 -----
 5 files changed, 75 insertions(+), 71 deletions(-)
 delete mode 100644 src/ao_opts.h
 delete mode 100644 src/ao_opts_impl.c
 delete mode 100644 src/patch.cpp

diff --git a/src/ArduinoOcpp/Platform.cpp b/src/ArduinoOcpp/Platform.cpp
index d8932513..0b2a1ef8 100644
--- a/src/ArduinoOcpp/Platform.cpp
+++ b/src/ArduinoOcpp/Platform.cpp
@@ -22,3 +22,38 @@ void ao_set_console_out(void (*console_out)(const char *msg)) {
 }
 
 #endif
+
+#ifdef AO_CUSTOM_TIMER
+unsigned long (*ao_tick_ms_impl)() = nullptr;
+
+void ao_set_timer(unsigned long (*get_ms)()) {
+    ao_tick_ms_impl = get_ms;
+}
+
+unsigned long ao_tick_ms_custom() {
+    if (ao_tick_ms_impl) {
+        return ao_tick_ms_impl();
+    } else {
+        return 0;
+    }
+}
+#endif
+
+#if AO_PLATFORM == AO_PLATFORM_UNIX
+#include <chrono>
+
+namespace ArduinoOcpp {
+
+std::chrono::steady_clock::time_point clock_reference;
+bool clock_initialized = false;
+
+}
+
+unsigned long ao_tick_ms_unix() {
+    if (!ArduinoOcpp::clock_initialized) {
+        ArduinoOcpp::clock_reference = std::chrono::steady_clock::now();
+        ArduinoOcpp::clock_initialized = true;
+    }
+    return (std::chrono::steady_clock::now() - ArduinoOcpp::clock_reference).count() / (int64_t) 1000000;
+}
+#endif
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index f6dfb757..5bd0d776 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -7,6 +7,20 @@
 
 #include <ao_opts.h>
 
+#ifdef __cplusplus
+#define EXT_C extern "C"
+#else
+#define EXT_C
+#endif
+
+#define AO_PLATFORM_ARDUINO 0
+#define AO_PLATFORM_ESPIDF  1
+#define AO_PLATFORM_UNIX    2
+
+#ifndef AO_PLATFORM
+#define AO_PLATFORM AO_PLATFORM_ARDUINO
+#endif
+
 #ifdef AO_CUSTOM_CONSOLE
 
 #ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
@@ -36,26 +50,48 @@ void ao_console_out(const char *msg);
                 X(msg); \
                 X("\n     > see ArduinoOcpp/Platform.h\n"); \
             } while (0)
-#endif
 
-#ifndef AO_CONSOLE_PRINTF
-//begin with Arduino support, add more later
+#if AO_PLATFORM == AO_PLATFORM_ARDUINO
 #include <Arduino.h>
 #ifndef AO_USE_SERIAL
 #define AO_USE_SERIAL Serial
 #endif
 
 #define AO_CONSOLE_PRINTF(X, ...) AO_USE_SERIAL.printf_P(PSTR(X), ##__VA_ARGS__)
+#elif AO_PLATFORM == AO_PLATFORM_ESPIDF || AO_PLATFORM == AO_PLATFORM_UNIX
+#include <stdio.h>
+
+#define AO_CONSOLE_PRINTF(X, ...) printf(X, ##__VA_ARGS__)
+#endif
 #endif
 
-#ifndef ao_tick_ms
+#ifdef AO_CUSTOM_TIMER
+void ao_set_timer(unsigned long (*get_ms)());
+
+unsigned long ao_tick_ms_custom();
+#define ao_tick_ms ao_tick_ms_custom
+#else
+
+#if AO_PLATFORM == AO_PLATFORM_ARDUINO
 #include <Arduino.h>
 #define ao_tick_ms millis
+#elif AO_PLATFORM == AO_PLATFORM_ESPIDF
+#define ao_tick_ms(X) ((xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ)
+#elif AO_PLATFORM == AO_PLATFORM_UNIX
+#define ao_tick_ms ao_tick_ms_unix
+#endif
 #endif
 
 #ifndef ao_avail_heap
+#if AO_PLATFORM == AO_PLATFORM_ARDUINO
 #include <Arduino.h>
 #define ao_avail_heap ESP.getFreeHeap
+#elif AO_PLATFORM == AO_PLATFORM_ESPIDF
+#include "freertos/FreeRTOS.h"
+#define ao_avail_heap xPortGetFreeHeapSize
+#elif AO_PLATFORM == AO_PLATFORM_UNIX
+#define ao_avail_heap 1000000 //suppress this technique on unix
+#endif
 #endif
 
 #endif
diff --git a/src/ao_opts.h b/src/ao_opts.h
deleted file mode 100644
index 5a19cede..00000000
--- a/src/ao_opts.h
+++ /dev/null
@@ -1,31 +0,0 @@
-#ifndef AOOPTS_H
-#define AOOPTS_H
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-unsigned long ao_tick_ms_impl();
-//unsigned int32_t ao_avail_heap_impl();
-
-#ifdef __cplusplus
-}
-#endif
-
-#ifndef ao_tick_ms
-#define ao_tick_ms ao_tick_ms_impl
-#endif
-
-#ifndef ao_avail_heap
-#define ao_avail_heap() 20000
-#endif
-
-//#ifndef AO_CONSOLE_PRINTF
-//#define AO_CONSOLE_PRINTF(...) ESP_LOGI("[ocpp]", __VA_ARGS__)
-//#endif
-
-#ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
-#define AO_CUSTOM_CONSOLE_MAXMSGSIZE 192
-#endif
-
-#endif
diff --git a/src/ao_opts_impl.c b/src/ao_opts_impl.c
deleted file mode 100644
index ce1b6559..00000000
--- a/src/ao_opts_impl.c
+++ /dev/null
@@ -1,30 +0,0 @@
-#include "ao_opts.h"
-
-#include <stdio.h>
-#include <esp_wifi.h>
-#include <esp_system.h>
-#include <esp_event.h>
-
-#include <freertos/FreeRTOS.h>
-#include <freertos/task.h>
-#include <freertos/semphr.h>
-#include <freertos/event_groups.h>
-
-#include <esp_log.h>
-#include <esp_event.h>
-
-#include <freertos/task.h>
-#include <freertos/FreeRTOSConfig.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-unsigned long ao_tick_ms_impl() {
-    //return xTaskGetTickCount() / configTICK_RATE_HZ;
-    return (xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ;
-}
-
-#ifdef __cplusplus
-}
-#endif
diff --git a/src/patch.cpp b/src/patch.cpp
deleted file mode 100644
index 6dc0ca4d..00000000
--- a/src/patch.cpp
+++ /dev/null
@@ -1,6 +0,0 @@
-#include <ArduinoOcpp/Platform.h>
-
-unsigned long ao_tick_ms_impl() {
-    return 10000;
-}
-

From 76a5e50f3a532a1643d231b061f066146879f654 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 7 Oct 2022 21:57:15 +0200
Subject: [PATCH 091/549] fix compilation issues on ESP-IDF

---
 CMakeLists.txt                                     | 14 +++++++++++---
 src/ArduinoOcpp/Platform.h                         |  4 ++--
 .../Tasks/ChargePointStatus/ConnectorStatus.cpp    |  2 +-
 .../Tasks/Transactions/OrderedOperationsQueue.cpp  |  2 ++
 .../Tasks/Transactions/TransactionStore.cpp        |  3 ++-
 5 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index cc4ae294..491e78a8 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -3,6 +3,8 @@ set(AO_SRC
     src/ArduinoOcpp/Core/ConfigurationContainer.cpp
     src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
     src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+    src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+    src/ArduinoOcpp/Core/FilesystemUtils.cpp
     src/ArduinoOcpp/Core/OcppConnection.cpp
     src/ArduinoOcpp/Core/OcppEngine.cpp
     src/ArduinoOcpp/Core/OcppMessage.cpp
@@ -21,6 +23,7 @@ set(AO_SRC
     src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
     src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
     src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
+    src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
     src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
     src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
     src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
@@ -48,10 +51,14 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+    src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
+    src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+    src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
+    src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp
+    src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
+    src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
     src/ArduinoOcpp.cpp
     src/ArduinoOcpp_c.cpp
-    src/ao_opts_impl.c
-    src/ArduinoOcpp/Core/FilesystemAdapter.cpp
 )
 
 idf_component_register(SRCS ${AO_SRC}
@@ -67,4 +74,5 @@ target_compile_options(${COMPONENT_TARGET} PUBLIC
     -DAO_USE_FILEAPI=ESPIDF_SPIFFS
     -DAO_DBG_LEVEL=AO_DL_DEBUG
     -DAO_TRAFFIC_OUT
-    -DAO_FILENAME_PREFIX="/ao_store")
+    -DAO_FILENAME_PREFIX="/ao_store"
+    -DAO_PLATFORM=AO_PLATFORM_ESPIDF)
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 5bd0d776..313fde49 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -5,8 +5,6 @@
 #ifndef AO_PLATFORM_H
 #define AO_PLATFORM_H
 
-#include <ao_opts.h>
-
 #ifdef __cplusplus
 #define EXT_C extern "C"
 #else
@@ -76,6 +74,8 @@ unsigned long ao_tick_ms_custom();
 #include <Arduino.h>
 #define ao_tick_ms millis
 #elif AO_PLATFORM == AO_PLATFORM_ESPIDF
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
 #define ao_tick_ms(X) ((xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ)
 #elif AO_PLATFORM == AO_PLATFORM_UNIX
 #define ao_tick_ms ao_tick_ms_unix
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 5ba7dd26..384e747e 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -291,7 +291,7 @@ void ConnectorStatus::endSession(const char *reason) {
     if (transaction->isInSession()) {
         AO_DBG_DEBUG("End session with idTag %s for reason %s, %s previous reason",
                                 transaction->getIdTag(), reason ? reason : "undefined",
-                                transaction->getStopReason() == '\0' ? "no" : "overruled by");
+                                *transaction->getStopReason() ? "overruled by" : "no");
 
         if (reason) {
             transaction->setStopReason(reason);
diff --git a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
index c622af73..f293f076 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
@@ -6,6 +6,8 @@
 #include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
 #include <ArduinoOcpp/Debug.h>
 
+#include <algorithm>
+
 using namespace ArduinoOcpp;
 
 void OrderedOperationsQueue::addOcppOperation(uint seqNr, std::unique_ptr<OcppOperation> op) {
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index 8deeea6d..e03c7875 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -9,9 +9,10 @@
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
-
 #include <ArduinoOcpp/Debug.h>
 
+#include <algorithm>
+
 using namespace ArduinoOcpp;
 
 #ifndef AO_TXSTORE_DIR

From 3d1cd8617b1a00a2a4d2948bc2f9779752c347ed Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 8 Oct 2022 15:30:43 +0200
Subject: [PATCH 092/549] activate flash on ESP-IDF

---
 CMakeLists.txt                                |  1 -
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp    | 20 +++++++++++++------
 .../SmartCharging/SmartChargingService.cpp    |  7 +++++++
 3 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 491e78a8..d8bbb622 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -70,7 +70,6 @@ target_compile_options(${COMPONENT_TARGET} PUBLIC
     -DAO_CUSTOM_CONSOLE
     -DAO_CUSTOM_UPDATER
     -DAO_CUSTOM_RESET
-    -DAO_DEACTIVATE_FLASH
     -DAO_USE_FILEAPI=ESPIDF_SPIFFS
     -DAO_DBG_LEVEL=AO_DL_DEBUG
     -DAO_TRAFFIC_OUT
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 0739e1e4..6275726d 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -154,8 +154,8 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     if (!config.accessAllowed()) {
-            AO_DBG_DEBUG("Access to Arduino FS not allowed by config");
-            return nullptr;
+        AO_DBG_DEBUG("Access to Arduino FS not allowed by config");
+        return nullptr;
     }
 
     auto fs_concrete = new ArduinoFilesystemAdapter(config);
@@ -240,11 +240,17 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
     }
 };
 
-std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
+std::weak_ptr<FilesystemAdapter> filesystemCache;
+
+std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
+
+    if (auto cached = filesystemCache.lock()) {
+        return cached;
+    }
 
     if (!config.accessAllowed()) {
-            AO_DBG_DEBUG("Access to ESP-IDF SPIFFS not allowed by config");
-            return nullptr;
+        AO_DBG_DEBUG("Access to ESP-IDF SPIFFS not allowed by config");
+        return nullptr;
     }
 
     bool mounted = true;
@@ -276,7 +282,9 @@ std::unique_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     if (mounted) {
-        return std::unique_ptr<FilesystemAdapter>(new EspIdfFilesystemAdapter(config));
+        auto fs = std::shared_ptr<FilesystemAdapter>(new EspIdfFilesystemAdapter(config));
+        filesystemCache = fs;
+        return fs;
     } else {
         return nullptr;
     }
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index b2dbbe84..3f3a231f 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -9,6 +9,13 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
+#ifndef AO_DEACTIVATE_FLASH
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#if AO_USE_FILEAPI == ESPIDF_SPIFFS
+#define AO_DEACTIVATE_FLASH //migrate to File utils
+#endif
+#endif
+
 #ifndef AO_DEACTIVATE_FLASH
 #if defined(ESP32)
 #include <LITTLEFS.h>

From 27117f205eaceb6f6128d926e23cb931eb686413 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 8 Oct 2022 15:39:48 +0200
Subject: [PATCH 093/549] switch to default console settings

---
 CMakeLists.txt | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index d8bbb622..9ad9e28b 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -67,11 +67,8 @@ idf_component_register(SRCS ${AO_SRC}
 
 target_compile_options(${COMPONENT_TARGET} PUBLIC
     -DAO_CUSTOM_WS
-    -DAO_CUSTOM_CONSOLE
     -DAO_CUSTOM_UPDATER
     -DAO_CUSTOM_RESET
     -DAO_USE_FILEAPI=ESPIDF_SPIFFS
-    -DAO_DBG_LEVEL=AO_DL_DEBUG
-    -DAO_TRAFFIC_OUT
     -DAO_FILENAME_PREFIX="/ao_store"
     -DAO_PLATFORM=AO_PLATFORM_ESPIDF)

From 880d9dd2ef3e2abf82e0707a5c8079fd1ca2bcbd Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 8 Oct 2022 16:17:11 +0200
Subject: [PATCH 094/549] switch to default console on UNIX

---
 .github/workflows/platformless.yml | 2 +-
 .github/workflows/tests.yml        | 2 +-
 src/ArduinoOcpp/Platform.h         | 3 ++-
 tests/ocppEngineLifecycle.cpp      | 7 ++++---
 4 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index b9dd9f7e..c23315ae 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -23,4 +23,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -Wall
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 147c89a5..db2564a2 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -23,6 +23,6 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_CONSOLE -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -o ./output -Wall
+      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -o ./output -Wall
     - name: Run tests
       run: ./output
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 313fde49..4e811c07 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -78,6 +78,7 @@ unsigned long ao_tick_ms_custom();
 #include "freertos/task.h"
 #define ao_tick_ms(X) ((xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ)
 #elif AO_PLATFORM == AO_PLATFORM_UNIX
+unsigned long ao_tick_ms_unix();
 #define ao_tick_ms ao_tick_ms_unix
 #endif
 #endif
@@ -90,7 +91,7 @@ unsigned long ao_tick_ms_custom();
 #include "freertos/FreeRTOS.h"
 #define ao_avail_heap xPortGetFreeHeapSize
 #elif AO_PLATFORM == AO_PLATFORM_UNIX
-#define ao_avail_heap 1000000 //suppress this technique on unix
+#define ao_avail_heap(X) 1000000 //suppress this technique on unix
 #endif
 #endif
 
diff --git a/tests/ocppEngineLifecycle.cpp b/tests/ocppEngineLifecycle.cpp
index bdaa8308..441f298d 100644
--- a/tests/ocppEngineLifecycle.cpp
+++ b/tests/ocppEngineLifecycle.cpp
@@ -6,7 +6,7 @@
 TEST_CASE( "OcppEngine lifecycle" ) {
 
     //set console output to the cpp console to display outputs
-    ao_set_console_out(cpp_console_out);
+    //ao_set_console_out(cpp_console_out);
 
     //initialize OcppEngine with dummy socket
     ArduinoOcpp::OcppEchoSocket echoSocket;
@@ -16,8 +16,9 @@ TEST_CASE( "OcppEngine lifecycle" ) {
         REQUIRE( getOcppEngine() );
     }
 
+    OCPP_deinitialize();
+
     SECTION("OCPP is deinitialized"){
-        OCPP_deinitialize();
         REQUIRE( !( getOcppEngine() ) );
     }
-}
\ No newline at end of file
+}

From 13e8df0e1a2830f9f59379ceb5610919706332f3 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 9 Oct 2022 23:07:31 +0200
Subject: [PATCH 095/549] add transaction process test

---
 .../Tasks/Transactions/TransactionProcess.cpp |   7 +
 .../Tasks/Transactions/TransactionProcess.h   |   2 +
 tests/TransactionProcess.cpp                  | 199 ++++++++++++++++++
 3 files changed, 208 insertions(+)
 create mode 100644 tests/TransactionProcess.cpp

diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
index fe31d2dd..67a8b34b 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
@@ -111,3 +111,10 @@ void TransactionProcess::evaluateProcessSteps(uint txNr) {
 #endif
 
 }
+
+uint TransactionProcess::getTxNrRef() {
+    if (txNrRef) {
+        return (uint) *txNrRef;
+    }
+    return 0;
+}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
index 6240bb24..2863c847 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
@@ -39,6 +39,8 @@ class TransactionProcess {
 
     bool existsActiveTrigger() {return activeTriggerExists;}
     TxEnableState getState() {return txEnable;}
+
+    uint getTxNrRef();
 };
 
 }
diff --git a/tests/TransactionProcess.cpp b/tests/TransactionProcess.cpp
new file mode 100644
index 00000000..ed4a8801
--- /dev/null
+++ b/tests/TransactionProcess.cpp
@@ -0,0 +1,199 @@
+#include <ArduinoOcpp/Tasks/Transactions/TransactionProcess.h>
+#include "./catch2/catch.hpp"
+
+#include <array>
+
+using namespace ArduinoOcpp;
+
+TEST_CASE( "Transaction process - trivial" ) {
+
+    TransactionProcess txProcess {1};
+
+    SECTION("Trivial transaction process"){
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( !txProcess.existsActiveTrigger() );
+        REQUIRE( txProcess.getState() == TxEnableState::Inactive );
+    }
+
+    SECTION("Trivial transaction process with outputs"){
+        bool notified = false;
+        txProcess.addEnableStep([&notified] (TxTrigger trigger) -> TxEnableState {
+            REQUIRE( trigger == TxTrigger::Inactive );
+            notified = true;
+            return TxEnableState::Inactive;
+        });
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( notified );
+        REQUIRE( txProcess.getState() == TxEnableState::Inactive );
+    }
+}
+
+TEST_CASE("Transaction process - inputs") {
+
+    TransactionProcess txProcess {1};
+
+    TxPrecondition precondition = TxPrecondition::Active;
+    txProcess.addPrecondition([&precondition] () {
+        return precondition;
+    });
+
+    TxTrigger trigger = TxTrigger::Active;
+    txProcess.addTrigger([&trigger] () {
+        return trigger;
+    });
+
+    TxEnableState enable = TxEnableState::Active;
+    TxTrigger checkTrigger = TxTrigger::Active;
+    txProcess.addEnableStep([&enable, &checkTrigger] (TxTrigger input) {
+        REQUIRE(checkTrigger == input);
+        return enable;
+    });
+
+    SECTION("All active") {
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE(txProcess.getState() == TxEnableState::Active);
+    }
+
+    SECTION("Precondition") {
+        precondition = TxPrecondition::Inactive;
+        checkTrigger = TxTrigger::Inactive;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( txProcess.getState() != TxEnableState::Active );
+    }
+
+    SECTION("Trigger") {
+        trigger = TxTrigger::Inactive;
+        checkTrigger = TxTrigger::Inactive;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( txProcess.getState() != TxEnableState::Active );
+    }
+
+    SECTION("Output enable") {
+        enable = TxEnableState::Inactive;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( txProcess.getState() == TxEnableState::Pending );
+
+        enable = TxEnableState::Pending;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( txProcess.getState() == TxEnableState::Pending );
+    }
+}
+
+TEST_CASE("Transaction process - execution order") {
+
+    TransactionProcess txProcess {1};
+
+    std::array<TxPrecondition, 2> preconditions {TxPrecondition::Active, TxPrecondition::Active};
+    for (unsigned int i = 0; i < preconditions.size(); i++) {
+        txProcess.addPrecondition([&preconditions, i] () {
+            return preconditions[i];
+        });
+    }
+    
+    std::array<TxTrigger, 2> triggers {TxTrigger::Active, TxTrigger::Active};
+    for (unsigned int i = 0; i < triggers.size(); i++) {
+        txProcess.addTrigger([&triggers, i] () {
+            return triggers[i];
+        });
+    }
+    
+    std::array<TxEnableState, 2> enableSteps {TxEnableState::Active, TxEnableState::Active};
+    std::array<int, 2> checkSeq {-1, -1};
+    int checkCount = 0;
+    for (unsigned int i = 0; i < enableSteps.size(); i++) {
+        txProcess.addEnableStep([&enableSteps, &checkSeq, &checkCount, i] (TxTrigger) {
+            checkSeq[i] = checkCount;
+            checkCount++;
+            return enableSteps[i];
+        });
+    }
+    
+    SECTION("Precondition"){
+        preconditions[0] = TxPrecondition::Inactive;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( txProcess.getState() != TxEnableState::Active );
+
+        preconditions[0] = TxPrecondition::Active;
+        preconditions[1] = TxPrecondition::Inactive;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( txProcess.getState() != TxEnableState::Active );
+    }
+
+    SECTION("Trigger") {
+        triggers[0] = TxTrigger::Inactive;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( txProcess.getState() != TxEnableState::Active );
+        REQUIRE( txProcess.existsActiveTrigger());
+
+        triggers[0] = TxTrigger::Active;
+        triggers[1] = TxTrigger::Inactive;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE( txProcess.getState() != TxEnableState::Active );
+        REQUIRE( txProcess.existsActiveTrigger());
+    }
+
+    SECTION("Output enable - all active"){
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE(checkSeq[0] == 1);
+        REQUIRE(checkSeq[1] == 0);
+    }
+
+    SECTION("Output enable - active pending"){
+        enableSteps[1] = TxEnableState::Pending;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE(checkSeq[0] == -1);
+        REQUIRE(checkSeq[1] == 0);
+    }
+
+    SECTION("Output enable - inactive"){
+        preconditions[0] = TxPrecondition::Inactive;
+        enableSteps[0] = TxEnableState::Inactive;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE(checkSeq[0] == 0);
+        REQUIRE(checkSeq[1] == 1);
+    }
+
+    SECTION("Output enable - inactive pending"){
+        preconditions[0] = TxPrecondition::Inactive;
+        enableSteps[0] = TxEnableState::Pending;
+        txProcess.evaluateProcessSteps(0);
+        REQUIRE(checkSeq[0] == 0);
+        REQUIRE(checkSeq[1] == -1);
+    }
+}
+
+TEST_CASE("Transaction process - begin new transaction") {
+    TransactionProcess txProcess {1};
+
+    txProcess.addPrecondition([] () {
+        return TxPrecondition::Active;
+    });
+
+    TxTrigger trigger = TxTrigger::Active;
+    txProcess.addTrigger([&trigger] () {
+        return trigger;
+    });
+
+    TxEnableState enable = TxEnableState::Active;
+    TxTrigger checkTrigger = TxTrigger::Active;
+    txProcess.addEnableStep([&enable, &checkTrigger] (TxTrigger input) {
+        checkTrigger = input;
+        return enable;
+    });
+
+    SECTION("Evaluate different txNr") {
+        auto txNr = txProcess.getTxNrRef();
+        txProcess.evaluateProcessSteps(txNr + 1); //try to evaluate newer transaction
+        REQUIRE( checkTrigger == TxTrigger::Inactive );
+        REQUIRE( txProcess.getState() != TxEnableState::Active );
+        REQUIRE( txNr == txProcess.getTxNrRef() );
+    }
+
+    SECTION("Switch to newer transaction") {
+        auto txNr = txProcess.getTxNrRef();
+        trigger = TxTrigger::Inactive;
+        enable = TxEnableState::Inactive;
+        txProcess.evaluateProcessSteps(txNr + 1);
+        REQUIRE( txNr + 1 == txProcess.getTxNrRef() );
+    }
+}

From 8ac97e2165785af1406b5578644c105425b23ae6 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 9 Oct 2022 23:16:07 +0200
Subject: [PATCH 096/549] add transaction start test

---
 .github/workflows/platformless.yml            |   2 +-
 .github/workflows/tests.yml                   |   2 +-
 .../Tasks/Transactions/TransactionStore.cpp   |   4 +-
 .../Tasks/Transactions/TransactionStore.h     |   2 +-
 tests/ChargingSessions.cpp                    | 108 ++++++++++++++++++
 5 files changed, 113 insertions(+), 5 deletions(-)
 create mode 100644 tests/ChargingSessions.cpp

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index c23315ae..331f404f 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -23,4 +23,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -Wall
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index db2564a2..244b8938 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -23,6 +23,6 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -o ./output -Wall
+      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -o ./output -Wall
     - name: Run tests
       run: ./output
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index e03c7875..370b8e10 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -134,8 +134,8 @@ void ConnectorTransactionStore::submitPendingOperations() {
 std::shared_ptr<Transaction> ConnectorTransactionStore::makeTransaction() {
 
     if (!filesystem) {
-        AO_DBG_ERR("Invalid state");
-        return nullptr;
+        AO_DBG_ERR("Need FS adapter");
+        //return nullptr; <-- allow test runs without FS
     }
 
     if (transactions.size() >= MAX_QUEUE_SIZE) {
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
index cfffdfa4..45300caa 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
@@ -23,7 +23,7 @@ class ConnectorTransactionStore {
 
     std::shared_ptr<FilesystemAdapter> filesystem;
     std::shared_ptr<Configuration<int>> txBegin; //The Tx file names are consecutively numbered; first number
-    uint txEnd; //one place after last number
+    uint txEnd = 0; //one place after last number
     
     std::deque<std::shared_ptr<Transaction>> transactions;
 
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
new file mode 100644
index 00000000..34d33507
--- /dev/null
+++ b/tests/ChargingSessions.cpp
@@ -0,0 +1,108 @@
+#include <ArduinoOcpp.h>
+#include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/MessagesV16/BootNotification.h>
+#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
+#include "./catch2/catch.hpp"
+
+using namespace ArduinoOcpp;
+
+unsigned long mtime = 10000;
+unsigned long custom_timer_cb() {
+    return mtime;
+}
+
+void loop() {
+    mtime += 10000;
+    OCPP_loop();
+    mtime += 10000;
+    OCPP_loop();
+}
+
+TEST_CASE( "Charging sessions - basic" ) {
+
+    //initialize OcppEngine with dummy socket
+    OcppEchoSocket echoSocket;
+    OCPP_initialize(echoSocket);
+
+    ao_set_timer(custom_timer_cb);
+    
+    std::array<const char*, 2> expectedSN {"Available", "Available"};
+    std::array<bool, 2> checkedSN {false, false};
+    registerCustomOcppMessage("StatusNotification", [] () {return new Ocpp16::StatusNotification();},
+        [&checkedSN, &expectedSN] (JsonObject request) {
+            int connectorId = request["connectorId"] | -1;
+            checkedSN[connectorId] = !strcmp(request["status"] | "Invalid", expectedSN[connectorId]);
+        });
+
+    bootNotification("dummy1234", "");
+
+    SECTION("Check idle state"){
+
+        bool checkedBN = false;
+        registerCustomOcppMessage("BootNotification", [] () {return new Ocpp16::BootNotification();},
+            [&checkedBN] (JsonObject request) {
+                checkedBN = !strcmp(request["chargePointModel"] | "Invalid", "dummy1234");
+            });
+        
+        loop();
+        loop();
+        REQUIRE( checkedBN );
+        REQUIRE( checkedSN[0] );
+        REQUIRE( checkedSN[1] );
+        REQUIRE( isAvailable() );
+        REQUIRE( !getSessionIdTag() );
+        REQUIRE( !ocppPermitsCharge() );
+    }
+
+    loop();
+    loop();
+
+    SECTION("StartTx directly"){
+        startTransaction("mIdTag");
+        loop();
+        REQUIRE(ocppPermitsCharge());
+    }
+
+    SECTION("StartTx via session management - plug in first") {
+        checkedSN[1] = false;
+        expectedSN[1] = "Preparing";
+        setConnectorPluggedSampler([] () {return true;});
+        loop();
+        REQUIRE(checkedSN[1]);
+
+        checkedSN[1] = false;
+        expectedSN[1] = "Charging";
+        beginSession("mIdTag");
+        loop();
+        loop();
+        REQUIRE(checkedSN[1]);
+        REQUIRE(ocppPermitsCharge());
+    }
+
+    SECTION("StartTx via session management - authorization first") {
+        auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 100, CONFIGURATION_FN);
+        *connectionTimeOut = 100;
+
+        checkedSN[1] = false;
+        expectedSN[1] = "Preparing";
+        setConnectorPluggedSampler([] () {return false;});
+        beginSession("mIdTag");
+        loop();
+        REQUIRE(checkedSN[1]);
+
+        checkedSN[1] = false;
+        expectedSN[1] = "Charging";
+        setConnectorPluggedSampler([] () {return true;});
+        loop();
+        loop();
+        REQUIRE(checkedSN[1]);
+        REQUIRE(ocppPermitsCharge());
+    }
+
+    OCPP_deinitialize();
+
+}
\ No newline at end of file

From de92f0b69a3bfa9701ab4f7154cf19207cea840c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 9 Oct 2022 23:19:05 +0200
Subject: [PATCH 097/549] update test definition

---
 .github/workflows/platformless.yml | 2 +-
 .github/workflows/tests.yml        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 331f404f..4eb9167a 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -3,7 +3,7 @@ name: Default Compilation
 on:
   push:
     branches:
-      - feature/freertos
+      - develop
 
 jobs:
 
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 244b8938..e0a93743 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -3,7 +3,7 @@ name: Test Runner
 on:
   push:
     branches:
-      - feature/freertos
+      - develop
 
 jobs:
 

From 23c0357b6d50068e949199a48889b7221577202f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 10 Oct 2022 10:17:54 +0200
Subject: [PATCH 098/549] add stop reason to facade

---
 src/ArduinoOcpp.cpp | 4 ++--
 src/ArduinoOcpp.h   | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index c89ead3d..34cc153b 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -601,7 +601,7 @@ void beginSession(const char *idTag) {
     connector->beginSession(idTag);
 }
 
-void endSession() {
+void endSession(const char *reason) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -611,7 +611,7 @@ void endSession() {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->endSession();
+    connector->endSession(reason);
 }
 
 bool isInSession() {
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index d72cdbdf..36b6c13a 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -171,7 +171,7 @@ bool isAvailable(); //if the charge point is operative or inoperative
 
 void beginSession(const char *idTag);
 
-void endSession();
+void endSession(const char *reason = nullptr);
 
 bool isInSession();
 

From 4334512fdf111cb1c7aad50fdf4a0f93135e6727 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 10 Oct 2022 11:33:37 +0200
Subject: [PATCH 099/549] add advanced transaction process test

---
 tests/ChargingSessions.cpp | 192 ++++++++++++++++++++++++++++++++-----
 1 file changed, 167 insertions(+), 25 deletions(-)

diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 34d33507..4091173a 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -16,19 +16,26 @@ unsigned long custom_timer_cb() {
 }
 
 void loop() {
-    mtime += 10000;
+    mtime += 1000;
     OCPP_loop();
-    mtime += 10000;
+    mtime += 1000;
+    OCPP_loop();
+    mtime += 1000;
     OCPP_loop();
 }
 
-TEST_CASE( "Charging sessions - basic" ) {
+TEST_CASE( "Charging sessions" ) {
 
     //initialize OcppEngine with dummy socket
     OcppEchoSocket echoSocket;
     OCPP_initialize(echoSocket);
 
     ao_set_timer(custom_timer_cb);
+
+    auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN);
+        *connectionTimeOut = 30;
+    auto minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN);
+        *minimumStatusDuration = 0;
     
     std::array<const char*, 2> expectedSN {"Available", "Available"};
     std::array<bool, 2> checkedSN {false, false};
@@ -59,48 +66,183 @@ TEST_CASE( "Charging sessions - basic" ) {
     }
 
     loop();
-    loop();
 
-    SECTION("StartTx directly"){
+    SECTION("StartTx") {
+        SECTION("StartTx directly"){
+            startTransaction("mIdTag");
+            loop();
+            REQUIRE(ocppPermitsCharge());
+        }
+
+        SECTION("StartTx via session management - plug in first") {
+            expectedSN[1] = "Preparing";
+            setConnectorPluggedSampler([] () {return true;});
+            loop();
+            REQUIRE(checkedSN[1]);
+
+            checkedSN[1] = false;
+            expectedSN[1] = "Charging";
+            beginSession("mIdTag");
+            loop();
+            REQUIRE(checkedSN[1]);
+            REQUIRE(ocppPermitsCharge());
+        }
+
+        SECTION("StartTx via session management - authorization first") {
+
+            expectedSN[1] = "Preparing";
+            setConnectorPluggedSampler([] () {return false;});
+            beginSession("mIdTag");
+            loop();
+            REQUIRE(checkedSN[1]);
+
+            checkedSN[1] = false;
+            expectedSN[1] = "Charging";
+            setConnectorPluggedSampler([] () {return true;});
+            loop();
+            REQUIRE(checkedSN[1]);
+            REQUIRE(ocppPermitsCharge());
+        }
+
+        SECTION("StartTx via session management - no plug") {
+            expectedSN[1] = "Charging";
+            beginSession("mIdTag");
+            loop();
+            REQUIRE(checkedSN[1]);
+        }
+
+        SECTION("StartTx via session management - ConnectionTimeOut") {
+            expectedSN[1] = "Preparing";
+            setConnectorPluggedSampler([] () {return false;});
+            beginSession("mIdTag");
+            loop();
+            REQUIRE(checkedSN[1]);
+
+            checkedSN[1] = false;
+            expectedSN[1] = "Available";
+            mtime += *connectionTimeOut * 1000;
+            loop();
+            REQUIRE(checkedSN[1]);
+        }
+
+        loop();
+        if (ocppPermitsCharge()) {
+            stopTransaction();
+        }
+        loop();
+    }
+
+    SECTION("StopTx") {
         startTransaction("mIdTag");
         loop();
-        REQUIRE(ocppPermitsCharge());
+        expectedSN[1] = "Available";
+
+        SECTION("directly") {
+            stopTransaction();
+            loop();
+            REQUIRE(checkedSN[1]);
+            REQUIRE(!ocppPermitsCharge());
+        }
+
+        SECTION("via session management - deauthorize") {
+            endSession("Local");
+            loop();
+            REQUIRE(checkedSN[1]);
+            REQUIRE(!ocppPermitsCharge());
+        }
+
+        SECTION("via session management - deauthorize first") {
+            expectedSN[1] = "Finishing";
+            setConnectorPluggedSampler([] () {return true;});
+            endSession("Local");
+            loop();
+            REQUIRE(checkedSN[1]);
+            REQUIRE(!ocppPermitsCharge());
+
+            checkedSN[1] = false;
+            expectedSN[1] = "Available";
+            setConnectorPluggedSampler([] () {return false;});
+            loop();
+            REQUIRE(checkedSN[1]);
+            REQUIRE(!ocppPermitsCharge());
+        }
+
+        SECTION("via session management - plug out") {
+            setConnectorPluggedSampler([] () {return false;});
+            loop();
+            REQUIRE(checkedSN[1]);
+            REQUIRE(!ocppPermitsCharge());
+        }
+
+        if (ocppPermitsCharge()) {
+            stopTransaction();
+        }
+        loop();
     }
 
-    SECTION("StartTx via session management - plug in first") {
-        checkedSN[1] = false;
-        expectedSN[1] = "Preparing";
-        setConnectorPluggedSampler([] () {return true;});
+    SECTION("Advanced session management") {
+        bool connectorPlugged = false;
+        setConnectorPluggedSampler([&connectorPlugged] () {return connectorPlugged;});
+
+        TxEnableState meterState = TxEnableState::Inactive;
+        setTxBasedMeterUpdate([&meterState] (TxTrigger) {return meterState;});
+
+        TxEnableState lockState = TxEnableState::Inactive;
+        setConnectorLock([&lockState] (TxTrigger) {return lockState;});
+
+        beginSession("mIdTag");
         loop();
-        REQUIRE(checkedSN[1]);
+        REQUIRE(!ocppPermitsCharge());
+
+        connectorPlugged = true;
+        loop();
+        REQUIRE(!ocppPermitsCharge());
+        
+        meterState = TxEnableState::Active;
+        loop();
+        REQUIRE(!ocppPermitsCharge());
+        
+        meterState = TxEnableState::Pending;
+        lockState = TxEnableState::Active;
+        loop();
+        REQUIRE(!ocppPermitsCharge());
+        
+        meterState = TxEnableState::Active;
+        lockState = TxEnableState::Pending;
+        loop();
+        REQUIRE(!ocppPermitsCharge());
 
         checkedSN[1] = false;
         expectedSN[1] = "Charging";
-        beginSession("mIdTag");
-        loop();
+        
+        lockState = TxEnableState::Active;
         loop();
-        REQUIRE(checkedSN[1]);
         REQUIRE(ocppPermitsCharge());
-    }
-
-    SECTION("StartTx via session management - authorization first") {
-        auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 100, CONFIGURATION_FN);
-        *connectionTimeOut = 100;
+        REQUIRE(checkedSN[1]);
 
         checkedSN[1] = false;
-        expectedSN[1] = "Preparing";
-        setConnectorPluggedSampler([] () {return false;});
-        beginSession("mIdTag");
+        expectedSN[1] = "SuspendedEVSE";
+
+        lockState = TxEnableState::Pending;
         loop();
+        REQUIRE(!ocppPermitsCharge());
+        REQUIRE(!getSessionIdTag());
         REQUIRE(checkedSN[1]);
 
         checkedSN[1] = false;
-        expectedSN[1] = "Charging";
-        setConnectorPluggedSampler([] () {return true;});
+        expectedSN[1] = "Finishing";
+
+        meterState = TxEnableState::Inactive;
+        lockState = TxEnableState::Inactive;
         loop();
+        REQUIRE(checkedSN[1]);
+
+        checkedSN[1] = false;
+        expectedSN[1] = "Available";
+
+        connectorPlugged = false;
         loop();
         REQUIRE(checkedSN[1]);
-        REQUIRE(ocppPermitsCharge());
     }
 
     OCPP_deinitialize();

From e3455f48fa87ede11306e70dbd65e109ceafaea0 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 10 Oct 2022 13:54:15 +0200
Subject: [PATCH 100/549] filesystem integration on linux

---
 .github/workflows/platformless.yml            |  2 +-
 .github/workflows/tests.yml                   |  2 +-
 src/ArduinoOcpp.cpp                           |  2 +-
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp    | 95 ++++++++++++++++++-
 src/ArduinoOcpp/Core/FilesystemAdapter.h      |  6 +-
 .../SmartCharging/SmartChargingService.cpp    |  4 +
 6 files changed, 101 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 4eb9167a..a380452c 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -23,4 +23,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_USE_FILEAPI=POSIX_FILEAPI -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -DAO_DEACTIVATE_FLASH_SMARTCHARGING -Wall
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index e0a93743..55a30f85 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -23,6 +23,6 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DEACTIVATE_FLASH -DAO_USE_FILEAPI=ESPIDF_SPIFFS -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"/ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -o ./output -Wall
+      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_USE_FILEAPI=POSIX_FILEAPI -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -DAO_DEACTIVATE_FLASH_SMARTCHARGING -o ./output -Wall
     - name: Run tests
       run: ./output
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 34cc153b..a5cf8ae5 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -92,7 +92,7 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
     fileSystemOpt = fsOpt;
 
 #ifndef AO_DEACTIVATE_FLASH
-    std::shared_ptr<FilesystemAdapter> filesystem = EspWiFi::makeDefaultFilesystemAdapter(fileSystemOpt);
+    std::shared_ptr<FilesystemAdapter> filesystem = makeDefaultFilesystemAdapter(fileSystemOpt);
 #else
     std::shared_ptr<FilesystemAdapter> filesystem;
 #endif
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 6275726d..ed125f7a 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -42,7 +42,6 @@
 #if AO_USE_FILEAPI == ARDUINO_LITTLEFS || AO_USE_FILEAPI == ARDUINO_SPIFFS
 
 namespace ArduinoOcpp {
-namespace EspWiFi {
 
 class ArduinoFileAdapter : public FileAdapter {
     File file;
@@ -169,13 +168,11 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 }
 
-} //end namespace EspWiFi
 } //end namespace ArduinoOcpp
 
 #elif AO_USE_FILEAPI == ESPIDF_SPIFFS
 
 namespace ArduinoOcpp {
-namespace EspWiFi {
 
 class EspIdfFileAdapter : public FileAdapter {
     FILE *file {nullptr};
@@ -290,7 +287,97 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 }
 
-} //end namespace EspWiFi
+} //end namespace ArduinoOcpp
+
+#elif AO_USE_FILEAPI == POSIX_FILEAPI
+
+#include <cstdio>
+#include <sys/stat.h>
+
+namespace ArduinoOcpp {
+
+class PosixFileAdapter : public FileAdapter {
+    FILE *file {nullptr};
+public:
+    PosixFileAdapter(FILE *file) : file(file) {}
+
+    ~PosixFileAdapter() {
+        fclose(file);
+    }
+
+    size_t read(char *buf, size_t len) override {
+        return fread(buf, 1, len, file);
+    }
+
+    size_t write(const char *buf, size_t len) override {
+        return fwrite(buf, 1, len, file);
+    }
+
+    size_t seek(size_t offset) override {
+        return fseek(file, offset, SEEK_SET);
+    }
+
+    int read() {
+        return fgetc(file);
+    }
+};
+
+class PosixFilesystemAdapter : public FilesystemAdapter {
+public:
+    FilesystemOpt config;
+public:
+    PosixFilesystemAdapter(FilesystemOpt config) : config(config) { }
+
+    ~PosixFilesystemAdapter() = default;
+
+    int stat(const char *path, size_t *size) override {
+        struct ::stat st;
+        auto ret = ::stat(path, &st);
+        if (ret == 0) {
+            *size = st.st_size;
+        }
+        return ret;
+    }
+
+    std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {
+        auto file = fopen(fn, mode);
+        if (file) {
+            return std::unique_ptr<FileAdapter>(new PosixFileAdapter(std::move(file)));
+        } else {
+            AO_DBG_DEBUG("Failed to open file path %s", fn);
+            return nullptr;
+        }
+    }
+
+    bool remove(const char *fn) override {
+        return ::remove(fn) == 0;
+    }
+};
+
+std::weak_ptr<FilesystemAdapter> filesystemCache;
+
+std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
+
+    if (auto cached = filesystemCache.lock()) {
+        return cached;
+    }
+
+    if (!config.accessAllowed()) {
+        AO_DBG_DEBUG("Access to FS not allowed by config");
+        return nullptr;
+    }
+
+    bool mounted = true;
+
+    if (config.mustMount()) {
+        AO_DBG_DEBUG("Skip mounting on UNIX host");
+    }
+
+    auto fs = std::shared_ptr<FilesystemAdapter>(new PosixFilesystemAdapter(config));
+    filesystemCache = fs;
+    return fs;
+}
+
 } //end namespace ArduinoOcpp
 
 #endif
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index 39066623..e3d57d55 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -14,6 +14,7 @@
 #define ARDUINO_LITTLEFS 1
 #define ARDUINO_SPIFFS   2
 #define ESPIDF_SPIFFS    3
+#define POSIX_FILEAPI    4
 
 #include <memory>
 
@@ -63,16 +64,15 @@ class FilesystemAdapter {
 
 #if AO_USE_FILEAPI == ARDUINO_LITTLEFS || \
     AO_USE_FILEAPI == ARDUINO_SPIFFS || \
-    AO_USE_FILEAPI == ESPIDF_SPIFFS
+    AO_USE_FILEAPI == ESPIDF_SPIFFS || \
+    AO_USE_FILEAPI == POSIX_FILEAPI
 
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
 
 namespace ArduinoOcpp {
-namespace EspWiFi {
 
 std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config);
 
-} //end namespace EspWiFi
 } //end namespace ArduinoOcpp
 #endif
 
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index 3f3a231f..b5feb9b2 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -9,6 +9,10 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
+#if !defined(AO_DEACTIVATE_FLASH) && defined(AO_DEACTIVATE_FLASH_SMARTCHARGING)
+#define AO_DEACTIVATE_FLASH
+#endif
+
 #ifndef AO_DEACTIVATE_FLASH
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #if AO_USE_FILEAPI == ESPIDF_SPIFFS

From 9930058bbe1c2eea35561fa906e2a2115c245432 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 10 Oct 2022 14:39:30 +0200
Subject: [PATCH 101/549] fix compiler warnings

---
 src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp                | 3 ++-
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp                    | 2 --
 .../Tasks/Metering/ConnectorMeterValuesRecorder.cpp           | 2 +-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp                 | 2 +-
 src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp            | 4 ++--
 src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp               | 2 +-
 src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp  | 1 +
 src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp     | 2 +-
 src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp       | 4 ++--
 9 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index f25abddb..1e06471a 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -220,7 +220,8 @@ int toCStringValue(char *buf, size_t length, int value) {
 }
 
 int toCStringValue(char *buf, size_t length, float value) {
-    return snprintf(buf, length, "%.*g", length >= 7 ? length - 7 : 0, value);
+    int ilength = (int) std::min((size_t) 100, length);
+    return snprintf(buf, length, "%.*g", ilength >= 7 ? ilength - 7 : 0, value);
 }
 
 template<class T>
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index ed125f7a..a8af6e33 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -367,8 +367,6 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
         return nullptr;
     }
 
-    bool mounted = true;
-
     if (config.mustMount()) {
         AO_DBG_DEBUG("Skip mounting on UNIX host");
     }
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 63ee89e1..8f3f1342 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -220,5 +220,5 @@ std::vector<std::unique_ptr<MeterValue>> ConnectorMeterValuesRecorder::createSto
     stopTxnSampledData.clear(); //make vectors defined after moving from them
     stopTxnAlignedData.clear();
 
-    return std::move(res);
+    return res;
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
index 8fd8ffce..9c501dd0 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
@@ -36,7 +36,7 @@ std::unique_ptr<DynamicJsonDocument> MeterValue::toJson() {
     for (auto entry = entries.begin(); entry != entries.end(); entry++) {
         jsonMeterValue.add(**entry);
     }
-    return std::move(result);
+    return result;
 }
 
 MeterValueBuilder::MeterValueBuilder(const std::vector<std::unique_ptr<SampledValueSampler>> &samplers,
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index f7567cec..bf0c8fb4 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -54,7 +54,7 @@ void MeteringService::addMeterValueSampler(int connectorId, std::unique_ptr<Samp
 }
 
 std::unique_ptr<SampledValue> MeteringService::readTxEnergyMeter(int connectorId, ReadingContext context) {
-    if (connectorId < 0 || connectorId >= connectors.size()) {
+    if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
@@ -82,7 +82,7 @@ std::unique_ptr<OcppOperation> MeteringService::takeTriggeredMeterValues(int con
 }
 
 std::vector<std::unique_ptr<MeterValue>> MeteringService::createStopTxMeterData(int connectorId) {
-    if (connectorId < 0 || connectorId >= connectors.size()) {
+    if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
         return std::vector<std::unique_ptr<MeterValue>>();
     }
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
index a7999f6e..d687e8d6 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
@@ -96,5 +96,5 @@ std::unique_ptr<DynamicJsonDocument> SampledValue::toJson() {
         payload["location"] = properties.getLocation();
     if (!properties.getUnit().empty())
         payload["unit"] = properties.getUnit();
-    return std::move(result);
+    return result;
 }
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index b5feb9b2..23d50a71 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -291,6 +291,7 @@ void SmartChargingService::refreshChargingSessionState() {
         bool ret = clearChargingProfile([clearProfileId] (int id, int, ChargingProfilePurposeType, int) {
             return id == clearProfileId;
         });
+        (void)ret;
 
         AO_DBG_DEBUG("Clearing RmtTx Charging Profile after session expiry: %s", ret ? "success" : "already cleared");
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
index b5dc1320..1fa9b139 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
@@ -62,7 +62,7 @@ void TransactionService::setInitiatedMsgId(uint seqNr, int msgId) {
         AO_DBG_ERR("Invalid params");
         return;
     }
-    if (*lastInitiatedSeqNr == seqNr && *lastInitiatedMsgCnt == msgId) {
+    if ((uint) *lastInitiatedSeqNr == seqNr && *lastInitiatedMsgCnt == msgId) {
         //Nothing to update
         return;
     }
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index 370b8e10..fe4862bf 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -44,7 +44,7 @@ void ConnectorTransactionStore::restorePendingTransactions() {
         return;
     }
 
-    if (!txBegin || *txBegin < 0 || *txBegin > MAX_TX_CNT) {
+    if (!txBegin || *txBegin < 0 || *txBegin > (int) MAX_TX_CNT) {
         AO_DBG_ERR("Invalid state");
         return;
     }
@@ -289,7 +289,7 @@ bool TransactionStore::commit(Transaction *transaction) {
         return false;
     }
     auto connectorId = transaction->getConnectorId();
-    if (connectorId < 0 || connectorId >= connectors.size()) {
+    if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
         AO_DBG_ERR("Invalid tx");
         return false;
     }

From 737e20bfaabf34d12fcb3ce1745840c7f57ff001 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 11 Oct 2022 11:16:14 +0200
Subject: [PATCH 102/549] move TransactionPrerequisites.h

---
 src/ArduinoOcpp.h                                               | 2 +-
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h       | 2 +-
 .../TransactionPrerequisites.h                                  | 0
 src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h         | 2 +-
 4 files changed, 3 insertions(+), 3 deletions(-)
 rename src/ArduinoOcpp/Tasks/{ChargePointStatus => Transactions}/TransactionPrerequisites.h (100%)

diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 36b6c13a..4f485099 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -15,7 +15,7 @@
 #include <ArduinoOcpp/Core/OcppOperationTimeout.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Core/PollResult.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 43ddc867..a266a4c7 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -6,7 +6,7 @@
 #define CONNECTORSTATUS_H
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionProcess.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h
rename to src/ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
index 2863c847..1f87eca9 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
@@ -5,7 +5,7 @@
 #ifndef TRANSACTIONPROCESS_H
 #define TRANSACTIONPROCESS_H
 
-#include <ArduinoOcpp/Tasks/ChargePointStatus/TransactionPrerequisites.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 
 #include <vector>

From d23fc159431ac06f093eb012c6a4ebe64f99ceb3 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 18 Oct 2022 14:33:19 +0200
Subject: [PATCH 103/549] fix missing data in tx store

---
 .../ChargePointStatus/ConnectorStatus.cpp     | 40 ++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 384e747e..7b37bb27 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -16,6 +16,8 @@
 
 #include <ArduinoOcpp/Debug.h>
 
+#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
+
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
@@ -196,6 +198,21 @@ OcppMessage *ConnectorStatus::loop() {
                 //start Transaction
 
                 AO_DBG_INFO("Session mngt: trigger StartTransaction");
+                auto meteringService = context.getMeteringService();
+                if (transaction->getMeterStart() < 0 && meteringService) {
+                    auto meterStart = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionBegin);
+                    if (meterStart && *meterStart) {
+                        transaction->setMeterStart(meterStart->toInteger());
+                    } else {
+                        AO_DBG_ERR("MeterStart undefined");
+                    }
+                }
+
+                AO_DBG_DEBUG("############ Check timestamp");
+                if (transaction->getStartTimestamp() <= MIN_TIME) {
+                    AO_DBG_DEBUG("############ Override timestamp");
+                    transaction->setStartTimestamp(context.getOcppTime().getOcppTimestampNow());
+                }
                 //return new StartTransaction(connectorId);
                 auto seqNr = context.getTransactionService()->getTransactionSequence().reserveSeqNr();
                 AO_DBG_DEBUG("Reserved SeqNr %u", seqNr);
@@ -215,13 +232,34 @@ OcppMessage *ConnectorStatus::loop() {
                 //stop transaction
                 auto seqNr = context.getTransactionService()->getTransactionSequence().reserveSeqNr();
                 transaction->getStopRpcSync().setRequested(seqNr);
+
+                auto meteringService = context.getMeteringService();
+                if (transaction->getMeterStop() < 0 && meteringService) {
+                    auto meterStop = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
+                    if (meterStop && *meterStop) {
+                        transaction->setMeterStop(meterStop->toInteger());
+                    } else {
+                        AO_DBG_ERR("MeterStop undefined");
+                    }
+                }
+
+                if (transaction->getStopTimestamp() <= MIN_TIME) {
+                    transaction->setStopTimestamp(context.getOcppTime().getOcppTimestampNow());
+                }
+
                 transaction->commit();
 
                 AO_DBG_INFO("Session mngt: trigger StopTransaction");
 
                 AO_DBG_DEBUG("Reserved SeqNr %u", seqNr);
+
+                if (context.getMeteringService()) {
+                    auto txData = context.getMeteringService()->createStopTxMeterData(connectorId);
+                    return new StopTransaction(transaction, std::move(txData));
+                } else {
+                    return new StopTransaction(transaction);
+                }
                 
-                return new StopTransaction(transaction);
             }
         }
     } //end transaction-related operations

From a66da2c928a1fd8bd6522a2b710b0b34a1690783 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 24 Oct 2022 10:45:04 +0200
Subject: [PATCH 104/549] store StartTx and StopTx on flash

---
 src/ArduinoOcpp.cpp                           |   2 +-
 src/ArduinoOcpp/Core/OcppConnection.cpp       | 110 ++++----
 src/ArduinoOcpp/Core/OcppConnection.h         |   8 +-
 src/ArduinoOcpp/Core/OcppEngine.cpp           |   4 +-
 src/ArduinoOcpp/Core/OcppEngine.h             |   3 +-
 src/ArduinoOcpp/Core/OcppMessage.h            |   4 +
 src/ArduinoOcpp/Core/OcppOperation.cpp        |  99 ++++++-
 src/ArduinoOcpp/Core/OcppOperation.h          |  11 +-
 src/ArduinoOcpp/Core/OperationStore.cpp       | 189 +++++++++++++
 src/ArduinoOcpp/Core/OperationStore.h         |  68 +++++
 src/ArduinoOcpp/Core/OperationsQueue.cpp      | 151 +++++++++++
 src/ArduinoOcpp/Core/OperationsQueue.h        |  46 ++++
 .../MessagesV16/StartTransaction.cpp          |  63 +++++
 .../MessagesV16/StartTransaction.h            |   4 +
 .../MessagesV16/StopTransaction.cpp           |  62 +++++
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |   6 +-
 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp | 250 ++++++++++++++++++
 src/ArduinoOcpp/Tasks/Metering/MeterStore.h   |  59 +++++
 .../Transactions/OrderedOperationsQueue.h     |   4 +-
 .../Tasks/Transactions/TransactionService.cpp |   2 +-
 20 files changed, 1084 insertions(+), 61 deletions(-)
 create mode 100644 src/ArduinoOcpp/Core/OperationStore.cpp
 create mode 100644 src/ArduinoOcpp/Core/OperationStore.h
 create mode 100644 src/ArduinoOcpp/Core/OperationsQueue.cpp
 create mode 100644 src/ArduinoOcpp/Core/OperationsQueue.h
 create mode 100644 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Metering/MeterStore.h

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index a5cf8ae5..dee3f323 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -100,7 +100,7 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
     
     configuration_init(filesystem); //call before each other library call
 
-    ocppEngine = new OcppEngine(ocppSocket, system_time);
+    ocppEngine = new OcppEngine(ocppSocket, system_time, filesystem);
     auto& model = ocppEngine->getOcppModel();
 
     model.setTransactionService(std::unique_ptr<TransactionService>(
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 310f5d0c..3417521a 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -7,6 +7,7 @@
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/OcppError.h>
+#include <ArduinoOcpp/Core/OperationStore.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -16,7 +17,8 @@ size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_siz
 
 using namespace ArduinoOcpp;
 
-OcppConnection::OcppConnection(OcppSocket& ocppSock, std::shared_ptr<OcppModel> baseModel) : baseModel{baseModel} {
+OcppConnection::OcppConnection(OcppSocket& ocppSock, std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
+            : baseModel{baseModel}, filesystem{filesystem}, initiatedOcppOperations{baseModel, filesystem} {
     ReceiveTXTcallback callback = [this] (const char *payload, size_t length) {
         return this->processOcppSocketInputTXT(payload, length);
     };
@@ -33,14 +35,12 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
      * can be dequeued and the following ocppOperation is processed.
      */
 
-    auto operation = initiatedOcppOperations.begin();
-    while (operation != initiatedOcppOperations.end()){
-        bool timeout = (*operation)->sendReq(ocppSock); //The only reason to dequeue elements here is when a timeout occurs. Normally
+    auto inited = initiatedOcppOperations.front();
+    if (inited) {
+        bool timeout = inited->sendReq(ocppSock); //The only reason to dequeue elements here is when a timeout occurs. Normally
         if (timeout){                                       //the Conf msg processing routine dequeues finished elements
-            operation = initiatedOcppOperations.erase(operation);
-        } else {
-            //there is one operation pending right now, so quit this while-loop.
-            break;
+            inited->finalize();
+            initiatedOcppOperations.pop_front();
         }
     }
 
@@ -48,24 +48,23 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
      * Activate timeout detection on the msgs other than the first in the queue.
      */
 
-    operation = initiatedOcppOperations.begin();
-    while (operation != initiatedOcppOperations.end()) {
-        if (operation == initiatedOcppOperations.begin()){ //jump over the first element
-            ++operation; 
-            continue; 
-        } 
-        Timeout *timer = (*operation)->getTimeout();
+    auto cached = initiatedOcppOperations.begin_tail();
+    while (cached != initiatedOcppOperations.end_tail()) {
+        Timeout *timer = (*cached)->getTimeout();
         if (!timer) {
-            ++operation; //no timeouts, nothing to do in this iteration
+            ++cached; //no timeouts, nothing to do in this iteration
             continue;
         }
         timer->tick(false); //false: did not send a frame prior to calling tick
-        if (timer->isExceeded()) {
-            AO_DBG_INFO("Discarding operation due to timeout:");
-            (*operation)->print_debug();
-            operation = initiatedOcppOperations.erase(operation);
+        if (timer->isExceeded() &&
+                //dropping operations out-of-order is only possible if they do not own an opNr
+                (!(*cached)->getStorageHandler() || (*cached)->getStorageHandler()->getOpNr() < 0)) {
+            AO_DBG_INFO("Discarding cached due to timeout:");
+            (*cached)->print_debug();
+            (*cached)->finalize();
+            cached = initiatedOcppOperations.erase_tail(cached);
         } else {
-            ++operation;
+            ++cached;
         }
     }
     
@@ -74,15 +73,16 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
      * If an ocppOperation is finished, it returns true on a conf() call, and is dequeued.
      */
 
-    operation = receivedOcppOperations.begin();
-    while (operation != receivedOcppOperations.end()){
-        bool success = (*operation)->sendConf(ocppSock);
+    auto received = receivedOcppOperations.begin();
+    while (received != receivedOcppOperations.end()){
+        bool success = (*received)->sendConf(ocppSock);
         if (success){
-            operation = receivedOcppOperations.erase(operation);
+            (*received)->finalize();
+            received = receivedOcppOperations.erase(received);
         } else {
             //There will be another attempt to send this conf message in a future loop call.
             //Go on with the next element in the queue, which is now at receivedOcppOperations[i+1]
-            ++operation; //TODO review: this makes confs out-of-order. But if the first Op fails because of lacking RAM, this could save the device. 
+            ++received; //TODO review: this makes confs out-of-order. But if the first Op fails because of lacking RAM, this could save the device. 
         }
     }
 }
@@ -96,8 +96,8 @@ void OcppConnection::initiateOcppOperation(std::unique_ptr<OcppOperation> o){
         AO_DBG_ERR("Called without the operation being configured and ready to send. Discard operation!");
         return; //o gets destroyed
     }
-    o->setInitiated();
-    initiatedOcppOperations.push_back(std::move(o));
+    
+    initiatedOcppOperations.initiate(std::move(o));
 }
 
 bool OcppConnection::processOcppSocketInputTXT(const char* payload, size_t length) {
@@ -186,16 +186,25 @@ bool OcppConnection::processOcppSocketInputTXT(const char* payload, size_t lengt
  * guaranteed to be received and therefore processed in the right order.
  */
 void OcppConnection::handleConfMessage(JsonDocument& json) {
-    for (auto operation = initiatedOcppOperations.begin(); operation != initiatedOcppOperations.end(); ++operation) {
-        bool success = (*operation)->receiveConf(json); //maybe rename to "consumed"?
-        if (success) {
-            initiatedOcppOperations.erase(operation);
-            return;
-        }
-    }
 
-    //didn't find matching OcppOperation
-    AO_DBG_WARN("Received CALLRESULT doesn't match any pending operation");
+    bool success = false;
+
+    initiatedOcppOperations.drop_if(
+        [&json, &success] (std::unique_ptr<OcppOperation>& operation) {
+            bool match = operation->receiveConf(json);
+            if (match) {
+                operation->finalize();
+                success = true;
+                //operation will be deleted by the surrounding drop_if
+            }
+            return match;
+        }); //executes in order and drops every operation where predicate(op) == true
+
+    if (!success) {
+        //didn't find matching OcppOperation
+        AO_DBG_WARN("Received CALLRESULT doesn't match any pending operation");
+        (void)0;
+    }
 }
 
 void OcppConnection::handleReqMessage(JsonDocument& json) {
@@ -218,16 +227,25 @@ void OcppConnection::handleReqMessage(JsonDocument& json, std::unique_ptr<OcppOp
 }
 
 void OcppConnection::handleErrMessage(JsonDocument& json) {
-    for (auto operation = initiatedOcppOperations.begin(); operation != initiatedOcppOperations.end(); ++operation){
-        bool discardOperation = (*operation)->receiveError(json); //maybe rename to "consumed"?
-        if (discardOperation) {
-            initiatedOcppOperations.erase(operation);
-            return;
-        }
-    }
 
-    //No OcppOperation was aborted because of the error message
-    AO_DBG_WARN("Received CALLERROR did not abort a pending operation");
+    bool success = false;
+
+    initiatedOcppOperations.drop_if(
+        [&json, &success] (std::unique_ptr<OcppOperation>& operation) {
+            bool match = operation->receiveError(json);
+            if (match) {
+                operation->finalize();
+                success = true;
+                //operation will be deleted by the surrounding drop_if
+            }
+            return match;
+        }); //executes in order and drops every operation where predicate(op) == true
+
+    if (!success) {
+        //No OcppOperation was aborted because of the error message
+        AO_DBG_WARN("Received CALLERROR did not abort a pending operation");
+        (void)0;
+    }
 }
 
 /*
diff --git a/src/ArduinoOcpp/Core/OcppConnection.h b/src/ArduinoOcpp/Core/OcppConnection.h
index daabf22c..8f00f4fc 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.h
+++ b/src/ArduinoOcpp/Core/OcppConnection.h
@@ -5,6 +5,8 @@
 #ifndef OCPPCONNECTION_H
 #define OCPPCONNECTION_H
 
+#include <ArduinoOcpp/Core/OperationsQueue.h>
+
 #include <deque>
 #include <memory>
 #include <ArduinoJson.h>
@@ -14,12 +16,14 @@ namespace ArduinoOcpp {
 class OcppModel;
 class OcppSocket;
 class OcppOperation;
+class FilesystemAdapter;
 
 class OcppConnection {
 private:
     std::shared_ptr<OcppModel> baseModel;
+    std::shared_ptr<FilesystemAdapter> filesystem;
     
-    std::deque<std::unique_ptr<OcppOperation>> initiatedOcppOperations;
+    OperationsQueue initiatedOcppOperations;
     std::deque<std::unique_ptr<OcppOperation>> receivedOcppOperations;
 
     void handleConfMessage(JsonDocument& json);
@@ -27,7 +31,7 @@ class OcppConnection {
     void handleReqMessage(JsonDocument& json, std::unique_ptr<OcppOperation> op);
     void handleErrMessage(JsonDocument& json);
 public:
-    OcppConnection(OcppSocket& oSock, std::shared_ptr<OcppModel> baseModel);
+    OcppConnection(OcppSocket& oSock, std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
 
     void loop(OcppSocket& oSock);
 
diff --git a/src/ArduinoOcpp/Core/OcppEngine.cpp b/src/ArduinoOcpp/Core/OcppEngine.cpp
index d8c297c8..e920bc2d 100644
--- a/src/ArduinoOcpp/Core/OcppEngine.cpp
+++ b/src/ArduinoOcpp/Core/OcppEngine.cpp
@@ -11,8 +11,8 @@ using namespace ArduinoOcpp;
 
 OcppEngine *ArduinoOcpp::defaultOcppEngine = nullptr;
 
-OcppEngine::OcppEngine(OcppSocket& ocppSocket, const OcppClock& system_clock)
-        : oSock(ocppSocket), oModel{std::make_shared<OcppModel>(system_clock)}, oConn{oSock, oModel} {
+OcppEngine::OcppEngine(OcppSocket& ocppSocket, const OcppClock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem)
+        : oSock(ocppSocket), oModel{std::make_shared<OcppModel>(system_clock)}, oConn{oSock, oModel, filesystem} {
     defaultOcppEngine = this;
 }
 
diff --git a/src/ArduinoOcpp/Core/OcppEngine.h b/src/ArduinoOcpp/Core/OcppEngine.h
index aa01b613..e4c03871 100644
--- a/src/ArduinoOcpp/Core/OcppEngine.h
+++ b/src/ArduinoOcpp/Core/OcppEngine.h
@@ -13,6 +13,7 @@ namespace ArduinoOcpp {
 
 class OcppSocket;
 class OcppModel;
+class FilesystemAdapter;
 
 class OcppEngine {
 private:
@@ -22,7 +23,7 @@ class OcppEngine {
 
     bool runOcppTasks = true;
 public:
-    OcppEngine(OcppSocket& ocppSocket, const OcppClock& system_clock);
+    OcppEngine(OcppSocket& ocppSocket, const OcppClock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem);
     ~OcppEngine();
 
     void loop();
diff --git a/src/ArduinoOcpp/Core/OcppMessage.h b/src/ArduinoOcpp/Core/OcppMessage.h
index 5b0cb3cd..6c3a9cc3 100644
--- a/src/ArduinoOcpp/Core/OcppMessage.h
+++ b/src/ArduinoOcpp/Core/OcppMessage.h
@@ -27,6 +27,7 @@ std::unique_ptr<DynamicJsonDocument> createEmptyDocument();
 
 class OcppModel;
 class TransactionRPC;
+class StoredOperationHandler;
 
 class OcppMessage {
 private:
@@ -43,6 +44,9 @@ class OcppMessage {
     void setOcppModel(std::shared_ptr<OcppModel> ocppModel);
 
     virtual void initiate();
+    virtual bool initiate(StoredOperationHandler *rpcData) {return false;}
+
+    virtual bool restore(StoredOperationHandler *rpcData) {return false;}
 
     /**
      * Create the payload for the respective OCPP message
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 18183dcb..781082b6 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -7,6 +7,10 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Core/OperationStore.h>
+
+#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
+#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
 
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
@@ -318,14 +322,105 @@ bool OcppOperation::sendConf(OcppSocket& ocppSocket){
     return wsSuccess;
 }
 
-void OcppOperation::setInitiated() {
+void OcppOperation::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
     if (ocppMessage) {
-        ocppMessage->initiate();
+
+        /*
+         * Create OCPP-J Remote Procedure Call header as storage data (doesn't necessarily have to comply with OCPP RPC header)
+         */
+        if (opStorage) {
+            opStore = std::move(opStorage);
+            size_t json_buffsize = JSON_ARRAY_SIZE(3) + (getMessageID()->length() + 1);
+            auto rpcData = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
+
+            rpcData->add(MESSAGE_TYPE_CALL);                    //MessageType
+            rpcData->add(*getMessageID());                      //Unique message ID
+            rpcData->add(ocppMessage->getOcppOperationType());  //Action
+
+            opStore->setRpc(std::move(rpcData));
+        }
+        
+        bool inited = ocppMessage->initiate(opStore.get());
+
+        if (opStore) {
+            opStore->releaseBuffer();
+        }
+        
+        if (!inited) { //legacy support
+            ocppMessage->initiate();
+        }
     } else {
         AO_DBG_ERR("Missing ocppMessage instance");
     }
 }
 
+bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<OcppModel> oModel) {
+    if (!opStorage) {
+        AO_DBG_ERR("invalid argument");
+        return false;
+    }
+
+    opStore = std::move(opStorage);
+
+    auto rpcData = opStore->getRpc();
+    auto payloadData = opStore->getPayload();
+    if (!rpcData || !payloadData) {
+        AO_DBG_ERR("corrupted storage");
+        return false;
+    }
+
+    messageID = (*rpcData)[1] | std::string();
+    std::string opType = (*rpcData)[2] | std::string();
+    if (messageID.empty() || opType.empty()) {
+        AO_DBG_ERR("corrupted storage");
+        messageID.clear();
+        return false;
+    }
+
+    int parsedMessageID = -1;
+    if (sscanf(messageID.c_str(), "%d", &parsedMessageID) == 1) {
+        if (parsedMessageID > unique_id_counter) {
+            unique_id_counter = parsedMessageID;
+            AO_DBG_VERBOSE("restore unique_id_counter = %d", unique_id_counter);
+        }
+    } else {
+        AO_DBG_ERR("cannot set unique msgID counter");
+        (void)0;
+        //skip this step but don't abort restore
+    }
+
+    std::unique_ptr<OcppMessage> msg;
+
+    if (!strcmp(opType.c_str(), "StartTransaction")) { //TODO this will get a nicer solution
+        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction());
+    } else if (!strcmp(opType.c_str(), "StopTransaction")) {
+        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StopTransaction());
+    }
+
+    if (!msg) {
+        AO_DBG_ERR("cannot create msg");
+        return false;
+    }
+
+    msg->setOcppModel(oModel);
+
+    bool success = msg->restore(opStore.get());
+    opStore->releaseBuffer();
+
+    if (!success) {
+        AO_DBG_ERR("restore error");
+        (void)0;
+    }
+
+    return success;
+}
+
+void OcppOperation::finalize() {
+    if (opStore) {
+        opStore->confirm();
+    }
+}
+
 void OcppOperation::setOnReceiveConfListener(OnReceiveConfListener onReceiveConf){
     if (onReceiveConf)
         onReceiveConfListener = onReceiveConf;
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index a3c44de6..4e573dd2 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -18,6 +18,7 @@ namespace ArduinoOcpp {
 class OcppMessage;
 class OcppModel;
 class OcppSocket;
+class StoredOperationHandler;
 
 class OcppOperation {
 private:
@@ -41,6 +42,8 @@ class OcppOperation {
     ulong retry_interval_mult = 1; // RETRY_INTERVAL * retry_interval_mult gives longer periods with each iteration
 
     uint16_t printReqCounter = 0;
+
+    std::unique_ptr<StoredOperationHandler> opStore;
 public:
 
     OcppOperation(std::unique_ptr<OcppMessage> msg);
@@ -98,7 +101,13 @@ class OcppOperation {
      */
     bool sendConf(OcppSocket& ocppSocket);
 
-    void setInitiated();
+    void initiate(std::unique_ptr<StoredOperationHandler> opStorage);
+
+    bool restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<OcppModel> oModel);
+
+    StoredOperationHandler *getStorageHandler() {return opStore.get();}
+
+    void finalize(); //called whenever this operation is completed or aborted right before the destructor
 
     void setOnReceiveConfListener(OnReceiveConfListener onReceiveConf);
 
diff --git a/src/ArduinoOcpp/Core/OperationStore.cpp b/src/ArduinoOcpp/Core/OperationStore.cpp
new file mode 100644
index 00000000..b5ba2713
--- /dev/null
+++ b/src/ArduinoOcpp/Core/OperationStore.cpp
@@ -0,0 +1,189 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Debug.h>
+
+#ifndef AO_OPSTORE_DIR
+#define AO_OPSTORE_DIR AO_FILENAME_PREFIX "/"
+#endif
+
+#define AO_OPSTORE_FN AO_FILENAME_PREFIX "/opstore.cnf"
+
+#define AO_MAX_OPNR 10000
+
+using namespace ArduinoOcpp;
+
+bool StoredOperationHandler::commit() {
+    if (isPersistent) {
+        AO_DBG_ERR("cannot call two times");
+        return false;
+    }
+    if (!filesystem) {
+        AO_DBG_DEBUG("filesystem");
+        return false;
+    }
+
+    if (!rpc || !payload) {
+        AO_DBG_ERR("unitialized");
+        return false;
+    }
+
+    opNr = context.reserveOpNr();
+
+    char fn [MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", opNr);
+    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+        AO_DBG_ERR("fn error: %i", ret);
+        return false;
+    }
+
+    DynamicJsonDocument doc {JSON_OBJECT_SIZE(2) + rpc->capacity() + payload->capacity()};
+    doc["rpc"] = *rpc;
+    doc["payload"] = *payload;
+
+    if (!FilesystemUtils::storeJson(filesystem, fn, doc)) {
+        AO_DBG_ERR("FS error");
+        return false;
+    }
+
+    isPersistent = true;
+    return true;
+}
+
+void StoredOperationHandler::confirm() {
+    if (isPersistent && opNr < 0) {
+        AO_DBG_ERR("invalid state");
+        return;
+    }
+    if (isPersistent) {
+        context.confirm((unsigned int) opNr);
+    }
+}
+
+bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
+    if (isPersistent) {
+        AO_DBG_ERR("cannot restore after commit");
+        return false;
+    }
+    if (!filesystem) {
+        AO_DBG_DEBUG("filesystem");
+        return false;
+    }
+
+    opNr = opNrToLoad;
+
+    char fn [MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", opNr);
+    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+        AO_DBG_ERR("fn error: %i", ret);
+        return false;
+    }
+
+    size_t msize;
+    if (filesystem->stat(fn, &msize) != 0) {
+        AO_DBG_DEBUG("operation %u does not exist", opNr);
+        return false;
+    }
+
+    auto doc = FilesystemUtils::loadJson(filesystem, fn);
+    if (!doc) {
+        AO_DBG_ERR("FS error");
+        return false;
+    }
+    
+    JsonObject rpc_restore = (*doc)["rpc"];
+    JsonObject payload_restore = (*doc)["payload"];
+
+    rpc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(rpc_restore.memoryUsage()));
+    payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(payload_restore.memoryUsage()));
+    
+    *rpc = rpc_restore;
+    *payload = payload_restore;
+
+    isPersistent = true;
+    return true;
+}
+
+OperationStore::OperationStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
+    opBegin = declareConfiguration<int>("AO_opBegin", 0, AO_OPSTORE_FN, false, false, true, false);
+
+    if (!opBegin || *opBegin < 0) {
+        AO_DBG_ERR("init failure");
+    } else if (filesystem) {
+        opEnd = *opBegin;
+
+        unsigned int misses = 0;
+        unsigned int i = opEnd;
+        while (misses < 3) {
+            char fn [MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", i);
+            if (ret < 0 || ret >= MAX_PATH_SIZE) {
+                AO_DBG_ERR("fn error: %i", ret);
+                misses++;
+                i++;
+                continue;
+            }
+
+            size_t msize;
+            if (filesystem->stat(fn, &msize) != 0) {
+                AO_DBG_DEBUG("operation %u does not exist", i);
+                misses++;
+                i++;
+                continue;
+            }
+
+            //file exists
+            misses = 0;
+            opEnd = i;
+            i++;
+        }
+    }
+}
+
+std::unique_ptr<StoredOperationHandler> OperationStore::makeOpHandler() {
+    return std::unique_ptr<StoredOperationHandler>(new StoredOperationHandler(*this, filesystem));
+}
+
+unsigned int OperationStore::reserveOpNr() {
+    AO_DBG_DEBUG("reserved opNr %u", opEnd);
+    auto res = opEnd;
+    opEnd++;
+    opEnd %= AO_MAX_OPNR;
+    return res;
+}
+
+void OperationStore::confirm(unsigned int opNr) {
+    if (!opBegin || *opBegin < 0) {
+        AO_DBG_ERR("init failure");
+        return;
+    }
+
+    if (opNr != (unsigned int) *opBegin) {
+        if (opNr - (unsigned int) *opBegin < 100) {
+            AO_DBG_ERR("synchronization failure - try to fix");
+            (void)0;
+        } else {
+            AO_DBG_ERR("synchronization failure");
+            return;
+        }
+    }
+
+    opNr++;
+    opNr %= AO_MAX_OPNR;
+    AO_DBG_DEBUG("advance opBegin: %u", opNr);
+    *opBegin = opNr;
+    configuration_save();
+}
+
+unsigned int OperationStore::getOpBegin() {
+    if (!opBegin || *opBegin < 0) {
+        AO_DBG_ERR("invalid state");
+        return 0;
+    }
+    return (unsigned int) *opBegin;
+}
diff --git a/src/ArduinoOcpp/Core/OperationStore.h b/src/ArduinoOcpp/Core/OperationStore.h
new file mode 100644
index 00000000..3bd20454
--- /dev/null
+++ b/src/ArduinoOcpp/Core/OperationStore.h
@@ -0,0 +1,68 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef OPERATIONSTORE_H
+#define OPERATIONSTORE_H
+
+#include <memory>
+#include <deque>
+#include <ArduinoJson.h>
+
+namespace ArduinoOcpp {
+
+class OperationStore;
+class FilesystemAdapter;
+template<class T> class Configuration;
+
+class StoredOperationHandler {
+private:
+    OperationStore& context;
+    int opNr = -1;
+    std::shared_ptr<FilesystemAdapter> filesystem;
+
+    std::unique_ptr<DynamicJsonDocument> rpc;
+    std::unique_ptr<DynamicJsonDocument> payload;
+
+    bool isPersistent = false;
+
+public:
+    StoredOperationHandler(OperationStore& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {}
+
+    void setRpc(std::unique_ptr<DynamicJsonDocument> rpc) {this->rpc = std::move(rpc);}
+    void setPayload(std::unique_ptr<DynamicJsonDocument> payload) {this->payload = std::move(payload);}
+
+    std::unique_ptr<DynamicJsonDocument> getRpc() {return std::move(rpc);}
+    std::unique_ptr<DynamicJsonDocument> getPayload() {return std::move(payload);}
+
+    bool commit();
+    void releaseBuffer() {rpc.release(); payload.release();}
+    void confirm();
+
+    bool restore(unsigned int opNr);
+
+    int getOpNr() {return isPersistent ? opNr : -1;}
+};
+
+class OperationStore {
+private:
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    std::shared_ptr<Configuration<int>> opBegin; //Tx-related operations are stored; index of the first pending operation
+    unsigned int opEnd = 0; //one place after last number
+
+public:
+    OperationStore() = delete;
+    OperationStore(std::shared_ptr<FilesystemAdapter> filesystem);
+
+    std::unique_ptr<StoredOperationHandler> makeOpHandler();
+    std::unique_ptr<StoredOperationHandler> fetchOpHandler(unsigned int opNr);
+
+    unsigned int reserveOpNr();
+    void confirm(unsigned int opNr);
+
+    unsigned int getOpBegin();
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
new file mode 100644
index 00000000..800f73b6
--- /dev/null
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -0,0 +1,151 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Core/OperationsQueue.h>
+#include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+
+#include <ArduinoOcpp/Core/OcppOperation.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <ArduinoOcpp/Debug.h>
+
+#include <algorithm>
+
+#define AO_OPERATIONCACHE_MAXSIZE 10
+
+using namespace ArduinoOcpp;
+
+OperationsQueue::OperationsQueue(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
+            : opStore(filesystem), baseModel(baseModel) { }
+
+OperationsQueue::~OperationsQueue() {
+
+}
+
+OcppOperation *OperationsQueue::front() {
+    if (!head && !tailCache.empty()) {
+        AO_DBG_ERR("invalid state");
+        pop_front();
+    }
+    return head.get();
+}
+
+void OperationsQueue::pop_front() {
+    
+    if (head && head->getStorageHandler() && head->getStorageHandler()->getOpNr() >= 0) {
+        if (head->getStorageHandler()->getOpNr() != opStore.getOpBegin()) {
+            AO_DBG_ERR("wrong order, removed op from queue before increasing opBegin");
+            (void)0;
+        }
+    }
+
+    head.release();
+
+    unsigned int nextOpNr = opStore.getOpBegin();
+
+    /*
+     * Find next operation to take as front. Two cases:
+     * A) [front, tailCache] contains all operations stored on this device
+     * B) [front, tailCache] does not contain all operations. The next operation after front is not present
+     *                       in the cache. Fetch the next operation from the flash to front
+     */
+
+    auto found = std::find_if(tailCache.begin(), tailCache.end(),
+        [nextOpNr] (std::unique_ptr<OcppOperation>& op) {
+            return op->getStorageHandler() &&
+                   op->getStorageHandler()->getOpNr() >= 0 &&
+                   (unsigned int) op->getStorageHandler()->getOpNr() == nextOpNr;
+    });
+
+    if (found != tailCache.end()) {
+        //cache hit -> case A) -> don't load from flash but just take the next element from tail
+        head = std::move(tailCache.front());
+        tailCache.pop_front();
+    } else {
+        //cache miss -> case B) or A) -> try to fetch operation from flash (check for case B)) or take first cached element as front
+        auto storageHandler = opStore.makeOpHandler();
+        
+        std::unique_ptr<OcppOperation> fetched;
+
+        bool exists = false;
+        for (size_t misses = 0; misses < 3; misses++) {
+            exists = storageHandler->restore(nextOpNr);
+            if (exists) {
+                break;
+            }
+            nextOpNr++;
+        }
+
+        if (exists) {
+            //case B) -> load operation from flash and take it as front element
+            fetched = makeOcppOperation();
+            
+            bool success = fetched->restore(std::move(storageHandler), baseModel);
+
+            if (!success) {
+                AO_DBG_ERR("could not restore operation");
+                fetched.release();
+            }
+        }
+
+        if (fetched) {
+            //found operation in flash -> case B)
+            head = std::move(fetched);
+            AO_DBG_DEBUG("restored operation from flash");
+        } else {
+            //no operation anymore in flash -> case A) -> take next queued operation in tailCache
+            if (tailCache.empty()) {
+                //no operations anymore
+            } else {
+                head = std::move(tailCache.front());
+                tailCache.pop_front();
+            }
+        }
+    }
+
+    AO_DBG_DEBUG("popped front");
+}
+
+void OperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
+
+    op->initiate(opStore.makeOpHandler());
+
+    if (!head && !tailCache.empty()) {
+        AO_DBG_ERR("invalid state");
+        pop_front();
+    }
+
+    if (!head) {
+        head = std::move(op);
+    } else {
+        if (tailCache.size() >= AO_OPERATIONCACHE_MAXSIZE) {
+            AO_DBG_INFO("Replace cached operation (cache full): ");
+            tailCache.front()->print_debug();
+            tailCache.pop_front();
+        }
+
+        tailCache.push_back(std::move(op));
+    }
+}
+
+void OperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) {
+
+    while (head && pred(head)) {
+        pop_front();
+    }
+
+    std::remove_if(tailCache.begin(), tailCache.end(), pred);
+}
+
+std::deque<std::unique_ptr<OcppOperation>>::iterator OperationsQueue::begin_tail() {
+    return tailCache.begin();
+}
+
+std::deque<std::unique_ptr<OcppOperation>>::iterator OperationsQueue::end_tail() {
+    return tailCache.end();
+}
+
+std::deque<std::unique_ptr<OcppOperation>>::iterator OperationsQueue::erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) {
+    return tailCache.erase(el);
+}
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.h b/src/ArduinoOcpp/Core/OperationsQueue.h
new file mode 100644
index 00000000..1eb8df4a
--- /dev/null
+++ b/src/ArduinoOcpp/Core/OperationsQueue.h
@@ -0,0 +1,46 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef OPERATIONSQUEUE_H
+#define OPERATIONSQUEUE_H
+
+#include <ArduinoOcpp/Core/OperationStore.h>
+
+#include <memory>
+#include <deque>
+#include <functional>
+
+namespace ArduinoOcpp {
+
+class FilesystemAdapter;
+class OcppOperation;
+class OcppModel;
+
+class OperationsQueue {
+private:
+    OperationStore opStore;
+    std::shared_ptr<OcppModel> baseModel;
+
+    std::unique_ptr<OcppOperation> head;
+    std::deque<std::unique_ptr<OcppOperation>> tailCache;
+public:
+
+    OperationsQueue(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
+    ~OperationsQueue();
+
+    OcppOperation *front();
+    void pop_front();
+
+    void initiate(std::unique_ptr<OcppOperation> op);
+
+    std::deque<std::unique_ptr<OcppOperation>>::iterator begin_tail(); //iterator for all cached elements except head
+    std::deque<std::unique_ptr<OcppOperation>>::iterator end_tail();
+    std::deque<std::unique_ptr<OcppOperation>>::iterator erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el);
+    void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred); //drops operations from this queue where pred(operation) == true. Executes pred in order
+
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 9e9d91ca..009d996e 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -4,6 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/OperationStore.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
@@ -50,6 +51,68 @@ void StartTransaction::initiate() {
     AO_DBG_INFO("StartTransaction initiated");
 }
 
+bool StartTransaction::initiate(StoredOperationHandler *opStore) {
+    if (!opStore || !ocppModel || !transaction || !transaction->getStartRpcSync().isRequested()) {
+        AO_DBG_ERR("-> legacy");
+        return false; //execute legacy initiate instead
+    }
+    
+    auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+    (*payload)["connectorId"] = transaction->getConnectorId();
+    (*payload)["txNr"] = transaction->getTxNr();
+
+    opStore->setPayload(std::move(payload));
+
+    opStore->commit();
+
+    transaction->getStartRpcSync().setRequested(1);
+
+    transaction->commit();
+
+    return true; //don't execute legacy initiate
+}
+
+bool StartTransaction::restore(StoredOperationHandler *opStore) {
+    if (!ocppModel) {
+        AO_DBG_ERR("invalid state");
+        return false;
+    }
+
+    if (!opStore) {
+        AO_DBG_ERR("invalid argument");
+        return false;
+    }
+
+    auto payload = opStore->getPayload();
+    if (!payload) {
+        AO_DBG_ERR("memory corruption");
+        return false;
+    }
+
+    int connectorId = (*payload)["connectorId"] | -1;
+    int txNr = (*payload)["txNr"] | -1;
+    if (connectorId < 0 || txNr < 0) {
+        AO_DBG_ERR("record incomplete");
+        return false;
+    }
+
+    auto txService = ocppModel->getTransactionService();
+
+    if (!txService) {
+        AO_DBG_ERR("invalid state");
+        return false;
+    }
+
+    transaction = txService->getTransactionStore().getTransactionSync(connectorId);
+    AO_DBG_WARN("Does not fetch correct tx yet");
+    if (!transaction) {
+        AO_DBG_ERR("referential integrity violation");
+        return false;
+    }
+
+    return true;
+}
+
 std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
 
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.h b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
index 1445148f..20d8d626 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
@@ -14,6 +14,7 @@ namespace ArduinoOcpp {
 
 class Transaction;
 class TransactionRPC;
+class StoredOperationHandler;
 
 namespace Ocpp16 {
 
@@ -29,6 +30,9 @@ class StartTransaction : public OcppMessage {
     const char* getOcppOperationType();
 
     void initiate();
+    bool initiate(StoredOperationHandler *opStore) override;
+
+    bool restore(StoredOperationHandler *opStore) override;
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index ddf5b566..d6812d09 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -4,6 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/OperationStore.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
@@ -58,6 +59,67 @@ void StopTransaction::initiate() {
     AO_DBG_INFO("StopTransaction initiated!");
 }
 
+bool StopTransaction::initiate(StoredOperationHandler *opStore) {
+    if (!opStore || !ocppModel || !transaction || !transaction->getStopRpcSync().isRequested()) {
+        AO_DBG_ERR("-> legacy");
+        return false; //execute legacy initiate instead
+    }
+    
+    auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    (*payload)["txNr"] = transaction->getTxNr();
+
+    opStore->setPayload(std::move(payload));
+
+    opStore->commit();
+
+    transaction->getStopRpcSync().setRequested(1);
+
+    transaction->commit();
+
+    return true; //don't execute legacy initiate
+}
+
+bool StopTransaction::restore(StoredOperationHandler *opStore) {
+    if (!ocppModel) {
+        AO_DBG_ERR("invalid state");
+        return false;
+    }
+
+    if (!opStore) {
+        AO_DBG_ERR("invalid argument");
+        return false;
+    }
+
+    auto payload = opStore->getPayload();
+    if (!payload) {
+        AO_DBG_ERR("memory corruption");
+        return false;
+    }
+
+    int connectorId = (*payload)["connectorId"] | -1;
+    int txNr = (*payload)["txNr"] | -1;
+    if (connectorId < 0 || txNr < 0) {
+        AO_DBG_ERR("record incomplete");
+        return false;
+    }
+
+    auto txService = ocppModel->getTransactionService();
+
+    if (!txService) {
+        AO_DBG_ERR("invalid state");
+        return false;
+    }
+
+    transaction = txService->getTransactionStore().getTransactionSync(connectorId);
+    AO_DBG_WARN("Does not fetch correct tx yet, restore Stop data and so on ...");
+    if (!transaction) {
+        AO_DBG_ERR("referential integrity violation");
+        return false;
+    }
+
+    return true;
+}
+
 std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
     std::vector<std::unique_ptr<DynamicJsonDocument>> txDataJson;
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index 5ec9df06..0b4b0467 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -24,11 +24,8 @@ class StopTransaction : public OcppMessage {
 private:
     std::shared_ptr<Transaction> transaction;
     std::vector<std::unique_ptr<MeterValue>> transactionData;
-    ulong emTimeout = 0;
 public:
 
-    //StopTransaction(int connectorId, const char *reason = nullptr);
-
     StopTransaction(std::shared_ptr<Transaction> transaction);
 
     StopTransaction(std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData);
@@ -38,6 +35,9 @@ class StopTransaction : public OcppMessage {
     const char* getOcppOperationType();
 
     void initiate();
+    bool initiate(StoredOperationHandler *opStore) override;
+
+    bool restore(StoredOperationHandler *opStore) override;
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
new file mode 100644
index 00000000..835bda04
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
@@ -0,0 +1,250 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
+
+#include <ArduinoOcpp/Debug.h>
+
+#include <algorithm>
+
+#ifndef AO_METERSTORE_DIR
+#define AO_METERSTORE_DIR AO_FILENAME_PREFIX "/"
+#endif
+
+#define MAX_STOPTXDATA_LEN 20
+
+TransactionMeterData::TransactionMeterData(unsigned int connectorId, unsigned int txNr, std::shared_ptr<FilesystemAdapter> filesystem)
+        : connectorId(connectorId), txNr(txNr), filesystem(filesystem) {
+
+}
+
+bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
+    if (isFinalized()) {
+        AO_DBG_ERR("immutable");
+        return false;
+    }
+
+    if (!mv) {
+        AO_DBG_ERR("null");
+        return false;
+    }
+
+    if (filesystem) {
+        char fn [MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvCount);
+        if (ret < 0 || ret >= MAX_PATH_SIZE) {
+            AO_DBG_ERR("fn error: %i", ret);
+            return false;
+        }
+
+        auto mvDoc = mv->toJson();
+        if (!mvDoc) {
+            AO_DBG_ERR("MV not ready yet");
+            return false;
+        }
+
+        if (!FilesystemUtils::storeJson(filesystem, fn, *mvDoc)) {
+            AO_DBG_ERR("FS error");
+            return false;
+        }
+    }
+
+    txData.push_back(std::move(mv));
+    mvCount++;
+}
+
+std::vector<std::unique_ptr<MeterValue>> TransactionMeterData::retrieveStopTxData() {
+    if (isFinalized()) {
+        AO_DBG_ERR("Can only retrieve once");
+        return decltype(txData) {};
+    }
+    finalize();
+    return std::move(txData);
+}
+
+bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
+    if (!filesystem) {
+        AO_DBG_DEBUG("No FS - nothing to restore");
+        return true;
+    }
+
+    const uint MISSES_LIMIT = 3;
+    uint misses = 0;
+
+    while (misses < MISSES_LIMIT) { //search until region without mvs found
+        
+        char fn [MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvCount);
+        if (ret < 0 || ret >= MAX_PATH_SIZE) {
+            AO_DBG_ERR("fn error: %i", ret);
+            return false; //all files have same length
+        }
+
+        auto doc = FilesystemUtils::loadJson(filesystem, fn);
+
+        if (!doc) {
+            misses++;
+            mvCount++;
+            continue;
+        }
+
+        JsonObject mvJson = doc->as<JsonObject>();
+        std::unique_ptr<MeterValue> mv = mvBuilder.deserializeSample(mvJson);
+
+        if (!mv) {
+            AO_DBG_ERR("Deserialization error");
+            misses++;
+            mvCount++;
+            continue;
+        }
+
+        if (txData.size() >= MAX_STOPTXDATA_LEN) {
+            AO_DBG_ERR("corrupted memory");
+            return false;
+        }
+
+        txData.push_back(std::move(mv));
+
+        mvCount++;
+        misses = 0;
+    }
+
+    AO_DBG_DEBUG("Restored %zu meter values", txData.size());
+    return true;
+}
+
+std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuilder& mvBuilder, unsigned int connectorId, unsigned int txNr) {
+    auto cached = std::find_if(txMeterData.begin(), txMeterData.end(),
+            [connectorId, txNr] (std::weak_ptr<TransactionMeterData>& txm) {
+                if (auto txml = txm.lock()) {
+                    return txml->getConnectorId() == connectorId && txml->getTxNr() == txNr;
+                } else {
+                    return false;
+                }
+            });
+    
+    if (cached != txMeterData.end()) {
+        if (auto cachedl = cached->lock()) {
+            return cachedl;
+        }
+    }
+
+    //clean outdated pointers before creating new object
+
+    std::remove_if(txMeterData.begin(), txMeterData.end(),
+            [connectorId, txNr] (std::weak_ptr<TransactionMeterData>& txm) {
+                return txm.expired();
+            });
+
+    //create new object and cache weak pointer
+
+    auto tx = std::make_shared<TransactionMeterData>(connectorId, txNr, filesystem);
+    
+    if (filesystem) {
+        char fn [MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, 0);
+        if (ret < 0 || ret >= MAX_PATH_SIZE) {
+            AO_DBG_ERR("fn error: %i", ret);
+            return nullptr; //cannot store
+        }
+
+        size_t size = 0;
+        bool exists = filesystem->stat(fn, &size) == 0;
+
+        if (exists) {
+            if (!tx->restore(mvBuilder)) {
+                remove(connectorId, txNr);
+                AO_DBG_ERR("removed corrupted tx entries");
+            }
+        }
+    }
+
+    txMeterData.push_back(tx);
+
+    AO_DBG_DEBUG("Added txNr %u, now holding %zu txs", txNr, txMeterData.size());
+
+    return tx;
+}
+
+bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
+
+    int mvCount = -1;
+
+    auto cached = std::find_if(txMeterData.begin(), txMeterData.end(),
+            [connectorId, txNr] (std::weak_ptr<TransactionMeterData>& txm) {
+                if (auto txml = txm.lock()) {
+                    return txml->getConnectorId() == connectorId && txml->getTxNr() == txNr;
+                } else {
+                    return false;
+                }
+            });
+    
+    if (cached != txMeterData.end()) {
+        if (auto cachedl = cached->lock()) {
+            mvCount = cachedl->getPathsCount();
+            cachedl->finalize();
+        }
+    }
+
+    bool success = true;
+
+    if (filesystem) {
+        if (mvCount > 0) {
+            for (unsigned int i = 0; i < mvCount; i++) { //search until region without txs found
+            
+                char fn [MAX_PATH_SIZE] = {'\0'};
+                auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
+                if (ret < 0 || ret >= MAX_PATH_SIZE) {
+                    AO_DBG_ERR("fn error: %i", ret);
+                    return false; //all files have same length
+                }
+
+                success &= filesystem->remove(fn);
+            }
+        } else {
+            const uint MISSES_LIMIT = 3;
+            uint misses = 0;
+            unsigned int i = 0;
+
+            while (misses < MISSES_LIMIT) { //search until region without mvs found
+                
+                char fn [MAX_PATH_SIZE] = {'\0'};
+                auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
+                if (ret < 0 || ret >= MAX_PATH_SIZE) {
+                    AO_DBG_ERR("fn error: %i", ret);
+                    return false; //all files have same length
+                }
+
+                size_t nsize = 0;
+                if (filesystem->stat(fn, &nsize) != 0) {
+                    misses++;
+                    i++;
+                    continue;
+                }
+
+                success &= filesystem->remove(fn);
+
+                i++;
+                misses = 0;
+            }
+        }
+    }
+
+    //clean outdated pointers
+
+    std::remove_if(txMeterData.begin(), txMeterData.end(),
+            [connectorId, txNr] (std::weak_ptr<TransactionMeterData>& txm) {
+                return txm.expired();
+            });
+
+    if (success) {
+        AO_DBG_DEBUG("Removed meter values for cId %u, txNr %u", connectorId, txNr);
+        (void)0;
+    } else {
+        AO_DBG_DEBUG("corrupted fs");
+    }
+
+    return success;
+}
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
new file mode 100644
index 00000000..f6806963
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
@@ -0,0 +1,59 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2022
+// MIT License
+
+#ifndef METERSTORE_H
+#define METERSTORE_H
+
+#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+
+#include <vector>
+#include <deque>
+
+using namespace ArduinoOcpp;
+
+class TransactionMeterData {
+private:
+    const unsigned int connectorId; //assignment to Transaction object
+    const unsigned int txNr; //assignment to Transaction object
+
+    unsigned int mvCount = 0; //nr of saved meter values
+    bool finalized = false; //if true, this is read-only
+
+    std::shared_ptr<FilesystemAdapter> filesystem;
+
+    std::vector<std::unique_ptr<MeterValue>> txData;
+
+public:
+    TransactionMeterData(unsigned int connectorId, unsigned int txNr, std::shared_ptr<FilesystemAdapter> filesystem);
+
+    bool addTxData(std::unique_ptr<MeterValue> mv);
+
+    std::vector<std::unique_ptr<MeterValue>> retrieveStopTxData(); //will invalidate internal cache
+
+    bool restore(MeterValueBuilder& mvBuilder); //load record from memory; true if record found, false if nothing loaded
+    bool remove();
+
+    unsigned int getConnectorId() {return connectorId;}
+    unsigned int getTxNr() {return txNr;}
+    unsigned int getPathsCount() {return mvCount;} //size of spanned path indexes
+    void finalize() {finalized = true;}
+    bool isFinalized() {return finalized;}
+};
+
+class MeterStore {
+private:
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    
+    std::vector<std::weak_ptr<TransactionMeterData>> txMeterData;
+
+public:
+    MeterStore(std::shared_ptr<FilesystemAdapter> filesystem);
+
+    std::shared_ptr<TransactionMeterData> getTxMeterData(MeterValueBuilder& mvBuilder, unsigned int connectorId, unsigned int txNr);
+
+    bool remove(unsigned int connectorId, unsigned int txNr);
+};
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h
index 52a9563f..2fbc5e43 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2022
 // MIT License
 
-#ifndef OPERATIONSQUEUE_H
-#define OPERATIONSQUEUE_H
+#ifndef ORDEREDOPERATIONSQUEUE_H
+#define ORDEREDOPERATIONSQUEUE_H
 
 #include <vector>
 #include <memory>
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
index 1fa9b139..098f7493 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
@@ -22,7 +22,7 @@ TransactionService::TransactionService(OcppEngine& context, uint nConnectors, st
     lastInitiatedMsgCnt = declareConfiguration<int>("LastMsgId", 1100000, AO_TXSERV_FN, false, false, true, false);
 
     txStore.restorePendingTransactions();
-    txStore.submitPendingOperations();
+    /* txStore.submitPendingOperations(); */ AO_DBG_WARN("Disabled submitPendingOperations!");
 }
 
 void TransactionService::addRestoredOperation(uint seqNr, std::unique_ptr<OcppOperation> o) {

From 9e9a6e128b5bfb4fc8ecfa583a082c9a31082a01 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 24 Oct 2022 18:00:44 +0200
Subject: [PATCH 105/549] make transactions existence dependent

---
 .../Transactions/OrderedOperationsQueue.cpp   |  31 ---
 .../Transactions/OrderedOperationsQueue.h     |  28 ---
 .../Tasks/Transactions/Transaction.cpp        |  10 -
 .../Tasks/Transactions/Transaction.h          |   9 +-
 .../Transactions/TransactionSequence.cpp      |  29 ---
 .../Tasks/Transactions/TransactionSequence.h  |  28 ---
 .../Tasks/Transactions/TransactionStore.cpp   | 225 ++++++------------
 .../Tasks/Transactions/TransactionStore.h     |  20 +-
 8 files changed, 80 insertions(+), 300 deletions(-)
 delete mode 100644 src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
 delete mode 100644 src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h
 delete mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp
 delete mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.h

diff --git a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
deleted file mode 100644
index f293f076..00000000
--- a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
+++ /dev/null
@@ -1,31 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#include <ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
-#include <ArduinoOcpp/Debug.h>
-
-#include <algorithm>
-
-using namespace ArduinoOcpp;
-
-void OrderedOperationsQueue::addOcppOperation(uint seqNr, std::unique_ptr<OcppOperation> op) {
-    operations.push_back(std::pair<uint, std::unique_ptr<OcppOperation>>{seqNr, std::move(op)});
-}
-
-void OrderedOperationsQueue::sort(uint seqEnd) {
-    std::sort(operations.begin(), operations.end(), [seqEnd] (const std::pair<uint, std::unique_ptr<OcppOperation>>& a, const std::pair<uint, std::unique_ptr<OcppOperation>>& b) {
-        uint da = (seqEnd - a.first + MAX_TXEVENT_CNT) % MAX_TXEVENT_CNT; //distance between a to seqEnd
-        uint db = (seqEnd - b.first + MAX_TXEVENT_CNT) % MAX_TXEVENT_CNT;
-        return da > db; //sort descending by distance to seqEnd <=> sort ascending by seqNr
-    });
-}
-
-void OrderedOperationsQueue::moveTo(std::vector<std::unique_ptr<OcppOperation>>& dst) {
-    for (auto el = operations.begin(); el != operations.end(); el++) {
-        dst.emplace_back(std::move(el->second));
-    }
-
-    operations.clear();
-}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h b/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h
deleted file mode 100644
index 2fbc5e43..00000000
--- a/src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h
+++ /dev/null
@@ -1,28 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#ifndef ORDEREDOPERATIONSQUEUE_H
-#define ORDEREDOPERATIONSQUEUE_H
-
-#include <vector>
-#include <memory>
-#include <ArduinoOcpp/Core/OcppOperation.h>
-
-namespace ArduinoOcpp {
-
-class OrderedOperationsQueue {
-private:
-    std::vector<std::pair<uint, std::unique_ptr<OcppOperation>>> operations;
-public:
-
-    void addOcppOperation(uint seqNr, std::unique_ptr<OcppOperation> op);
-
-    void sort(uint seqEnd); //sort and take seqEnd as largest order number
-
-    void moveTo(std::vector<std::unique_ptr<OcppOperation>>& dst); //move contents of operations to dst
-};
-
-}
-
-#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index cdee0f13..2c89dbce 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -3,23 +3,14 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
 
 #include <ArduinoOcpp/Debug.h>
 
 using namespace ArduinoOcpp;
 
-void TransactionRPC::requestWithMsgId(int msgId) {
-    context.setInitiatedMsgId(seqNr, msgId);
-}
-
 bool TransactionRPC::serializeSessionState(JsonObject rpc) {
     rpc["requested"] = requested;
-    if (requested) {
-        rpc["seqNr"] = seqNr;
-    }
     rpc["confirmed"] = confirmed;
     return true;
 }
@@ -112,7 +103,6 @@ bool Transaction::serializeSessionState(DynamicJsonDocument& out) {
 bool TransactionRPC::deserializeSessionState(JsonObject rpc) {
     if (rpc["requested"] | false) {
         requested = true;
-        seqNr = rpc["seqNr"] | 0;
     }
     if (rpc["confirmed"] | false) {
         confirmed = true;
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index f5336b1b..362e63c2 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -29,7 +29,6 @@ class TransactionRPC {
 
     TransactionService& context;
     
-    uint seqNr = 0;
     bool requested = false;
     bool confirmed = false;
 
@@ -38,14 +37,8 @@ class TransactionRPC {
 public:
     TransactionRPC(TransactionService& context) : context(context) { }
 
-    void requestWithMsgId(int msgId);
-
-    void setRequested(uint seqNr) {
-        this->seqNr = seqNr;
-        this->requested = true;
-    }
+    void setRequested() {this->requested = true;}
     bool isRequested() {return requested;}
-    uint getSeqNr() {return seqNr;}
     void confirm() {confirmed = true;}
     bool isConfirmed() {return confirmed;}
     bool isCompleted() {return isRequested() && isConfirmed();}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp
deleted file mode 100644
index b6809892..00000000
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp
+++ /dev/null
@@ -1,29 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-
-#include <ArduinoOcpp/Debug.h>
-
-#define AO_TXSEQ_FN AO_FILENAME_PREFIX "/txseq.cnf"
-
-using namespace ArduinoOcpp;
-
-TransactionSequence::TransactionSequence() {
-
-    seqEnd = declareConfiguration<int>("AO_SEQEND", 0, AO_TXSEQ_FN, false, false, true, false);
-}
-
-uint TransactionSequence::getSeqEnd() {
-    return *seqEnd;
-}
-
-uint TransactionSequence::reserveSeqNr() {
-    uint seq = (uint) *seqEnd;
-    uint seqIncr = (seq + 1U) % MAX_TXEVENT_CNT;
-    *seqEnd = seqIncr;
-    configuration_save();
-    return seq;
-}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.h
deleted file mode 100644
index 76856ce0..00000000
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.h
+++ /dev/null
@@ -1,28 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#ifndef TRANSACTIONSEQUENCE_H
-#define TRANSACTIONSEQUENCE_H
-
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <vector>
-
-#define MAX_TXEVENT_CNT 100000U
-
-namespace ArduinoOcpp {
-
-class TransactionSequence {
-private:
-    std::shared_ptr<Configuration<int>> seqEnd; //one place after last event
-public:
-    TransactionSequence();
-
-    uint getSeqEnd();
-
-    uint reserveSeqNr();
-};
-
-}
-
-#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index fe4862bf..b7d31921 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -21,7 +21,6 @@ using namespace ArduinoOcpp;
 
 #define AO_TXSTORE_META_FN AO_FILENAME_PREFIX "/txstore.jsn"
 
-#define MAX_QUEUE_SIZE 20U
 #define MAX_TX_CNT 100000U
 
 ConnectorTransactionStore::ConnectorTransactionStore(TransactionService& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
@@ -30,137 +29,91 @@ ConnectorTransactionStore::ConnectorTransactionStore(TransactionService& context
         filesystem(filesystem) {
 
     char key [30] = {'\0'};
-    if (snprintf(key, 30, "AO_txBegin_%u", connectorId) < 0) {
+    if (snprintf(key, 30, "AO_txEnd_%u", connectorId) < 0) {
         AO_DBG_ERR("Invalid key");
         (void)0;
     }
-    txBegin = declareConfiguration<int>(key, 0, AO_TXSTORE_META_FN, false, false, true, false);
+    txEnd = declareConfiguration<int>(key, 0, AO_TXSTORE_META_FN, false, false, true, false);
 }
 
-void ConnectorTransactionStore::restorePendingTransactions() {
+std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned int txNr) {
 
-    if (!filesystem) {
-        AO_DBG_ERR("FS error");
-        return;
-    }
-
-    if (!txBegin || *txBegin < 0 || *txBegin > (int) MAX_TX_CNT) {
-        AO_DBG_ERR("Invalid state");
-        return;
-    }
-
-    uint tx = *txBegin;
-    txEnd = tx;
-
-    const uint MISSES_LIMIT = 3;
-    uint misses = 0;
-
-    while (misses < MISSES_LIMIT) { //search until region without txs found
-
-        char fn [MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, tx);
-        if (ret < 0 || ret >= MAX_PATH_SIZE) {
-            AO_DBG_ERR("fn error: %i", ret);
-            break; //all files have same length
-        }
-
-        auto doc = FilesystemUtils::loadJson(filesystem, fn);
-
-        if (!doc) {
-            misses++;
-            tx++;
-            tx %= MAX_TX_CNT;
-            continue;
-        }
-
-        std::shared_ptr<Transaction> transaction = std::make_shared<Transaction>(context, connectorId, tx);
-        JsonObject txJson = doc->as<JsonObject>();
-        if (!transaction->deserializeSessionState(txJson)) {
-            AO_DBG_ERR("Deserialization error");
-            misses++;
-            tx++;
-            tx %= MAX_TX_CNT;
-            continue;
-        }
-
-        if (!transaction->isPending()) {
-            AO_DBG_DEBUG("Drop aborted / finished tx");
-            tx++;
-            tx %= MAX_TX_CNT;
-            continue; //normal behavior => don't increment misses
+    //check for most recent element of cache first because of temporal locality
+    if (!transactions.empty()) {
+        if (auto cached = transactions.back().lock()) {
+            if (cached->getTxNr() == txNr) {
+                //cache hit
+                return cached;
+            }
         }
-
-        transactions.push_back(std::move(transaction));
-
-        tx++;
-        tx %= MAX_TX_CNT;
-        txEnd = tx;
-        misses = 0;
-
-        if (transactions.size() > MAX_QUEUE_SIZE) { //allow to exceed MAX_QUEUE_SIZE by 1
-            AO_DBG_ERR("txBegin out of sync");
-            break;
+    }
+    
+    //check all other elements 
+    for (auto cached_wp : transactions) {
+        if (auto cached = cached_wp.lock()) {
+            if (cached->getTxNr() == txNr) {
+                //cache hit
+                return cached;
+            }
         }
     }
 
-    AO_DBG_DEBUG("Restored %zu transactions", transactions.size());
-}
+    //cache miss - load tx from flash if existent
+    
+    if (!filesystem) {
+        AO_DBG_DEBUG("no FS adapter");
+        return nullptr;
+    }
 
-void ConnectorTransactionStore::submitPendingOperations() {
-    for (auto& tx : transactions) {
-        
-        auto& startRpc = tx->getStartRpcSync();
-        if (startRpc.isRequested() && !startRpc.isConfirmed()) {
-            //startTx has been initiated, but not been confirmed yet
-            AO_DBG_DEBUG("Restore StartTx, connectorId=%i, seqNr=%u", connectorId, startRpc.getSeqNr());
+    char fn [MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, txNr);
+    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+        AO_DBG_ERR("fn error: %i", ret);
+        return nullptr;
+    }
 
-            auto startOp = makeOcppOperation(new Ocpp16::StartTransaction(tx));
-            context.addRestoredOperation(startRpc.getSeqNr(), std::move(startOp));
-        }
+    size_t msize;
+    if (filesystem->stat(fn, msize) != 0) {
+        AO_DBG_DEBUG("tx does not exist");
+        return nullptr;
+    }
 
-        auto& stopRpc = tx->getStopRpcSync();
-        if (stopRpc.isRequested() && !stopRpc.isConfirmed()) {
-            //stopTx has been initiated, but not been confirmed yet
-            AO_DBG_DEBUG("Restore StopTx, connectorId=%i, seqNr=%u", connectorId, stopRpc.getSeqNr());
+    auto doc = FilesystemUtils::loadJson(filesystem, fn);
 
-            //... add stop data
+    if (!doc) {
+        AO_DBG_ERR("memory corruption");
+        return nullptr;
+    }
 
-            auto stopOp = makeOcppOperation(new Ocpp16::StopTransaction(tx));
-            context.addRestoredOperation(stopRpc.getSeqNr(), std::move(stopOp));
-        }
+    auto transaction = std::unique_ptr<Transaction>(new Transaction(context, connectorId, tx));
+    JsonObject txJson = doc->as<JsonObject>();
+    if (!transaction->deserializeSessionState(txJson)) {
+        AO_DBG_ERR("deserialization error");
+        return nullptr;
     }
+
+    transactions.push_back(transaction);
+    return transaction;
 }
 
-std::shared_ptr<Transaction> ConnectorTransactionStore::makeTransaction() {
+std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction() {
 
-    if (!filesystem) {
-        AO_DBG_ERR("Need FS adapter");
-        //return nullptr; <-- allow test runs without FS
-    }
+    auto transaction = std::make_shared<Transaction>(context, connectorId, txEnd);
 
-    if (transactions.size() >= MAX_QUEUE_SIZE) {
-        AO_DBG_WARN("Queue full");
+    if (!txEnd || *txEnd < 0) {
+        AO_DBG_ERR("memory corruption");
         return nullptr;
     }
 
-    auto transaction = std::make_shared<Transaction>(context, connectorId, txEnd);
-    txEnd++;
-    txEnd %= MAX_TX_CNT;
-
-    transactions.push_back(transaction);
+    *txEnd = (*txEnd + 1) % MAX_TX_CNT;
+    configuration_save();
 
     if (!commit(transaction.get())) {
-        std::remove_if(transactions.begin(), transactions.end(),
-            [&transaction] (const std::shared_ptr<Transaction>& el) {
-                return el == transaction;
-            }
-        );
-        txEnd--;
-        txEnd += MAX_TX_CNT;
-        txEnd %= MAX_TX_CNT;
+        AO_DBG_ERR("FS error");
         return nullptr;
     }
 
+    transactions.push_back(transaction);
     return transaction;
 }
 
@@ -175,10 +128,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getActiveTransaction() {
 
     AO_DBG_DEBUG("Make new Tx");
 
-    auto tx = makeTransaction();
-    if (tx) {
-        tx->setConnectorId(connectorId);
-    }
+    auto tx = createTransaction();
 
     return tx;
 }
@@ -196,35 +146,17 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransactionSync() {
 }
 
 bool ConnectorTransactionStore::commit(Transaction *transaction) {
-    if (transactions.empty()) {
-        AO_DBG_ERR("Dangling transaction");
-        return false;
-    }
 
-    auto found = transactions.end();
-    if (transaction == (transactions.end() - 1)->get()) { //optimization: check if committing the last container element
-        found = transactions.end() - 1;
-    } else {
-        for (auto entry = transactions.begin(); entry != transactions.end(); entry++) {
-            if (transaction == entry->get()) {
-                found = entry;
-                break;
-            }
-        }
-    }
-
-    if (found == transactions.end()) {
-        AO_DBG_ERR("Dangling transaction");
-        return false;
+    if (!filesystem) {
+        AO_DBG_DEBUG("no FS: nothing to commit");
+        return true;
     }
 
-    //confirmed that transaction points to an element in the transactions container
-
     char fn [MAX_PATH_SIZE] = {'\0'};
     auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
     if (ret < 0 || ret >= MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
-        return false; //all files have same length
+        return false;
     }
     
     DynamicJsonDocument txDoc {0};
@@ -238,23 +170,6 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
         return false;
     }
 
-    //Data committed to memory; now update meta structures
-    
-    if (!transaction->isPending()) {
-        
-        AO_DBG_DEBUG("Drop completed transaction");
-        transactions.erase(found);
-        transaction = nullptr;
-        auto beginNew = txEnd;
-        if (!transactions.empty()) {
-            beginNew = transactions.front()->getTxNr();
-        }
-        if (beginNew != (uint) *txBegin) {
-            *txBegin = beginNew;
-            configuration_save();
-        }
-    }
-
     //success
     return true;
 }
@@ -296,14 +211,18 @@ bool TransactionStore::commit(Transaction *transaction) {
     return connectors[connectorId]->commit(transaction);
 }
 
-void TransactionStore::restorePendingTransactions() {
-    for (auto& connector : connectors) {
-        connector->restorePendingTransactions();
+std::shared_ptr<Transaction> TransactionStore::getTransaction(unsigned int connectorId, unsigned int txNr) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return nullptr;
     }
+    return connectors[connectorId]->getTransaction(txNr);
 }
 
-void TransactionStore::submitPendingOperations() {
-    for (auto& connector : connectors) {
-        connector->submitPendingOperations();
+std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int connectorId) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return nullptr;
     }
+    return connectors[connectorId]->createTransaction();
 }
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
index 45300caa..0099cff1 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
@@ -8,7 +8,6 @@
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
 #include <deque>
 
 namespace ArduinoOcpp {
@@ -22,38 +21,33 @@ class ConnectorTransactionStore {
     const uint connectorId;
 
     std::shared_ptr<FilesystemAdapter> filesystem;
-    std::shared_ptr<Configuration<int>> txBegin; //The Tx file names are consecutively numbered; first number
-    uint txEnd = 0; //one place after last number
+    std::shared_ptr<Configuration<int>> txEnd;
     
-    std::deque<std::shared_ptr<Transaction>> transactions;
-
-    std::shared_ptr<Transaction> makeTransaction();
+    std::deque<std::weak_ptr<Transaction>> transactions;
 
 public:
-    ConnectorTransactionStore(TransactionService& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+    ConnectorTransactionStore(TransactionService& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
     
     std::shared_ptr<Transaction> getActiveTransaction();
     std::shared_ptr<Transaction> getTransactionSync();
     bool commit(Transaction *transaction);
 
-    void restorePendingTransactions();
-    void submitPendingOperations();
+    std::shared_ptr<Transaction> getTransaction(unsigned int txNr);
+    std::shared_ptr<Transaction> createTransaction();
 };
 
 class TransactionStore {
 private:
     std::vector<std::unique_ptr<ConnectorTransactionStore>> connectors;
-
 public:
     TransactionStore(TransactionService& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
-    //std::shared_ptr<Transaction> makeTransaction(uint connectorId);
     std::shared_ptr<Transaction> getActiveTransaction(uint connectorId);
     std::shared_ptr<Transaction> getTransactionSync(uint connectorId); //fron element of the tx queue; tx which is being executed at the server now
     bool commit(Transaction *transaction);
 
-    void restorePendingTransactions();
-    void submitPendingOperations();
+    std::shared_ptr<Transaction> getTransaction(unsigned int connectorId, unsigned int txNr);
+    std::shared_ptr<Transaction> createTransaction(unsigned int connectorId);
 };
 
 }

From 2a3e80d7f5245c9c7574aed4ccd416628ec8abb6 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 25 Oct 2022 00:07:40 +0200
Subject: [PATCH 106/549] txs started and stopped by ops

---
 src/ArduinoOcpp.cpp                           | 18 ++---
 src/ArduinoOcpp/Core/OcppModel.cpp            | 10 +--
 src/ArduinoOcpp/Core/OcppModel.h              |  8 +-
 .../MessagesV16/StartTransaction.cpp          | 17 ++---
 .../MessagesV16/StopTransaction.cpp           | 17 ++---
 .../ChargePointStatus/ConnectorStatus.cpp     | 59 +++++----------
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  2 +
 .../Tasks/Transactions/Transaction.cpp        |  2 +-
 .../Tasks/Transactions/Transaction.h          | 14 ++--
 .../Tasks/Transactions/TransactionService.cpp | 74 -------------------
 .../Tasks/Transactions/TransactionService.h   | 44 -----------
 .../Tasks/Transactions/TransactionStore.cpp   | 52 ++++++++-----
 .../Tasks/Transactions/TransactionStore.h     |  9 +--
 13 files changed, 94 insertions(+), 232 deletions(-)
 delete mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
 delete mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionService.h

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index dee3f323..93a86890 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -12,7 +12,7 @@
 #include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
@@ -44,7 +44,6 @@ float voltage_eff {230.f};
 #define OCPP_ID_OF_CONNECTOR 1
 #define OCPP_ID_OF_CP 0
 bool OCPP_booted = false; //if BootNotification succeeded
-bool enteredLoop = false; //if loop() is called the first time
 
 } //end namespace ArduinoOcpp::Facade
 } //end namespace ArduinoOcpp
@@ -103,8 +102,8 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
     ocppEngine = new OcppEngine(ocppSocket, system_time, filesystem);
     auto& model = ocppEngine->getOcppModel();
 
-    model.setTransactionService(std::unique_ptr<TransactionService>(
-        new TransactionService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
+    model.setTransactionStore(std::unique_ptr<TransactionStore>(
+        new TransactionStore(OCPP_NUMCONNECTORS, filesystem)));
     model.setChargePointStatusService(std::unique_ptr<ChargePointStatusService>(
         new ChargePointStatusService(*ocppEngine, OCPP_NUMCONNECTORS)));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
@@ -151,7 +150,6 @@ void OCPP_deinitialize() {
     voltage_eff = 230.f;
 
     OCPP_booted = false;
-    enteredLoop = false;
 }
 
 void OCPP_loop() {
@@ -160,12 +158,6 @@ void OCPP_loop() {
         return;
     }
 
-    if (!enteredLoop) {
-        enteredLoop = true;
-        configuration_save();
-        ocppEngine->getOcppModel().getTransactionService()->initiateRestoredOperations();
-    }
-
     ocppEngine->loop();
 
     auto& model = ocppEngine->getOcppModel();
@@ -472,7 +464,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
-    auto transaction = ocppEngine->getOcppModel().getTransactionService()->getTransactionStore().getActiveTransaction(OCPP_ID_OF_CONNECTOR);
+    auto transaction = ocppEngine->getOcppModel().getTransactionStore()->getActiveTransaction(OCPP_ID_OF_CONNECTOR);
     if (!transaction) {
         AO_DBG_ERR("Transaction buffer full");
         return false;
@@ -510,7 +502,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         return false;
     }
 
-    auto transaction = ocppEngine->getOcppModel().getTransactionService()->getTransactionStore().getActiveTransaction(OCPP_ID_OF_CONNECTOR);
+    auto transaction = ocppEngine->getOcppModel().getTransactionStore()->getActiveTransaction(OCPP_ID_OF_CONNECTOR);
     if (!transaction || !transaction->isRunning()) {
         AO_DBG_ERR("No running Tx to stop");
         return false;
diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/OcppModel.cpp
index 13925ffb..3c7eaee7 100644
--- a/src/ArduinoOcpp/Core/OcppModel.cpp
+++ b/src/ArduinoOcpp/Core/OcppModel.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
@@ -42,12 +42,12 @@ void OcppModel::loop() {
         firmwareService->loop();
 }
 
-void OcppModel::setTransactionService(std::unique_ptr<TransactionService> ts) {
-    transactionService = std::move(ts);
+void OcppModel::setTransactionStore(std::unique_ptr<TransactionStore> ts) {
+    transactionStore = std::move(ts);
 }
 
-TransactionService *OcppModel::getTransactionService() {
-    return transactionService.get();
+TransactionStore *OcppModel::getTransactionStore() {
+    return transactionStore.get();
 }
 
 void OcppModel::setSmartChargingService(std::unique_ptr<SmartChargingService> scs) {
diff --git a/src/ArduinoOcpp/Core/OcppModel.h b/src/ArduinoOcpp/Core/OcppModel.h
index 2b7a351a..ff9f4439 100644
--- a/src/ArduinoOcpp/Core/OcppModel.h
+++ b/src/ArduinoOcpp/Core/OcppModel.h
@@ -11,7 +11,7 @@
 
 namespace ArduinoOcpp {
 
-class TransactionService;
+class TransactionStore;
 class SmartChargingService;
 class ChargePointStatusService;
 class ConnectorStatus;
@@ -22,7 +22,7 @@ class HeartbeatService;
 
 class OcppModel {
 private:
-    std::unique_ptr<TransactionService> transactionService;
+    std::unique_ptr<TransactionStore> transactionStore;
     std::unique_ptr<SmartChargingService> smartChargingService;
     std::unique_ptr<ChargePointStatusService> chargePointStatusService;
     std::unique_ptr<MeteringService> meteringService;
@@ -39,8 +39,8 @@ class OcppModel {
 
     void loop();
 
-    void setTransactionService(std::unique_ptr<TransactionService> transactionService);
-    TransactionService *getTransactionService();
+    void setTransactionStore(std::unique_ptr<TransactionStore> transactionStore);
+    TransactionStore *getTransactionStore();
 
     void setSmartChargingService(std::unique_ptr<SmartChargingService> scs);
     SmartChargingService* getSmartChargingService() const;
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 009d996e..931d9bc4 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -7,7 +7,7 @@
 #include <ArduinoOcpp/Core/OperationStore.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -41,9 +41,7 @@ void StartTransaction::initiate() {
             transaction->setStartTimestamp(ocppModel->getOcppTime().getOcppTimestampNow());
         }
         
-        auto seqNr = ocppModel->getTransactionService()->getTransactionSequence().reserveSeqNr();
-        AO_DBG_DEBUG("Reserved seqNr inside StartTx: %u", seqNr);
-        transaction->getStartRpcSync().setRequested(seqNr);
+        transaction->getStartRpcSync().setRequested();
 
         transaction->commit();
     }
@@ -52,7 +50,7 @@ void StartTransaction::initiate() {
 }
 
 bool StartTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!opStore || !ocppModel || !transaction || !transaction->getStartRpcSync().isRequested()) {
+    if (!opStore || !ocppModel || !transaction) {
         AO_DBG_ERR("-> legacy");
         return false; //execute legacy initiate instead
     }
@@ -65,7 +63,7 @@ bool StartTransaction::initiate(StoredOperationHandler *opStore) {
 
     opStore->commit();
 
-    transaction->getStartRpcSync().setRequested(1);
+    transaction->getStartRpcSync().setRequested();
 
     transaction->commit();
 
@@ -96,15 +94,14 @@ bool StartTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
-    auto txService = ocppModel->getTransactionService();
+    auto txStore = ocppModel->getTransactionStore();
 
-    if (!txService) {
+    if (!txStore) {
         AO_DBG_ERR("invalid state");
         return false;
     }
 
-    transaction = txService->getTransactionStore().getTransactionSync(connectorId);
-    AO_DBG_WARN("Does not fetch correct tx yet");
+    transaction = txStore->getTransaction(connectorId, txNr);
     if (!transaction) {
         AO_DBG_ERR("referential integrity violation");
         return false;
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index d6812d09..722cb584 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -8,7 +8,7 @@
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -50,9 +50,7 @@ void StopTransaction::initiate() {
             transaction->setStopTimestamp(ocppModel->getOcppTime().getOcppTimestampNow());
         }
 
-        auto seqNr = ocppModel->getTransactionService()->getTransactionSequence().reserveSeqNr();
-        AO_DBG_DEBUG("Reserved seqNr inside StopTx: %u", seqNr);
-        transaction->getStopRpcSync().setRequested(seqNr);
+        transaction->getStopRpcSync().setRequested();
 
         transaction->commit();
     }
@@ -60,7 +58,7 @@ void StopTransaction::initiate() {
 }
 
 bool StopTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!opStore || !ocppModel || !transaction || !transaction->getStopRpcSync().isRequested()) {
+    if (!opStore || !ocppModel || !transaction) {
         AO_DBG_ERR("-> legacy");
         return false; //execute legacy initiate instead
     }
@@ -72,7 +70,7 @@ bool StopTransaction::initiate(StoredOperationHandler *opStore) {
 
     opStore->commit();
 
-    transaction->getStopRpcSync().setRequested(1);
+    transaction->getStopRpcSync().setRequested();
 
     transaction->commit();
 
@@ -103,15 +101,14 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
-    auto txService = ocppModel->getTransactionService();
+    auto txStore = ocppModel->getTransactionStore();
 
-    if (!txService) {
+    if (!txStore) {
         AO_DBG_ERR("invalid state");
         return false;
     }
 
-    transaction = txService->getTransactionStore().getTransactionSync(connectorId);
-    AO_DBG_WARN("Does not fetch correct tx yet, restore Stop data and so on ...");
+    transaction = txStore->getTransaction(connectorId, txNr);
     if (!transaction) {
         AO_DBG_ERR("referential integrity violation");
         return false;
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 7b37bb27..f4339d07 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -6,7 +6,7 @@
 
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
@@ -48,8 +48,6 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
      *     - instruct the OCMF meter to begin a transaction (if OCMF meter handler is set)
      */
     txProcess.addTrigger([this] () -> TxTrigger {
-        auto transaction = this->context.getTransactionService()->getTransactionStore().getActiveTransaction(this->connectorId);
-
         if (transaction && transaction->isInSession() && transaction->isActive()) {
             return TxTrigger::Active;
         } else {
@@ -86,17 +84,13 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
         }
     }
 
-    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
-
     if (getErrorCode() != nullptr) {
         return OcppEvseState::Faulted;
-    } else if (!transaction) { //won't start new transactions if cached tx queue is full
-        return OcppEvseState::Unavailable;
     } else if (*availability == AVAILABILITY_INOPERATIVE) {
         return OcppEvseState::Unavailable;
-    } else if (rebooting && !transaction->isRunning()) {
+    } else if (rebooting && (!transaction || !transaction->isRunning())) {
         return OcppEvseState::Unavailable;
-    } else if (transaction->isRunning()) {
+    } else if (transaction && transaction->isRunning()) {
         //Transaction is currently running
         if ((connectorEnergizedSampler && !connectorEnergizedSampler()) ||
                 !transaction->isActive() || //will forbid charging
@@ -134,8 +128,6 @@ bool ConnectorStatus::ocppPermitsCharge() {
         return false;
     }
 
-    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
-
     return transaction &&
             transaction->isRunning() &&
             transaction->isActive() &&
@@ -145,8 +137,6 @@ bool ConnectorStatus::ocppPermitsCharge() {
 
 OcppMessage *ConnectorStatus::loop() {
 
-    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
-
     if ((!transaction || !transaction->isRunning()) && *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
         *availability = AVAILABILITY_INOPERATIVE;
         saveState();
@@ -208,16 +198,12 @@ OcppMessage *ConnectorStatus::loop() {
                     }
                 }
 
-                AO_DBG_DEBUG("############ Check timestamp");
                 if (transaction->getStartTimestamp() <= MIN_TIME) {
-                    AO_DBG_DEBUG("############ Override timestamp");
                     transaction->setStartTimestamp(context.getOcppTime().getOcppTimestampNow());
                 }
-                //return new StartTransaction(connectorId);
-                auto seqNr = context.getTransactionService()->getTransactionSequence().reserveSeqNr();
-                AO_DBG_DEBUG("Reserved SeqNr %u", seqNr);
-                transaction->getStartRpcSync().setRequested(seqNr);
+
                 transaction->commit();
+
                 return new StartTransaction(transaction);
             }
         } else if (transaction->isRunning()) {
@@ -230,9 +216,7 @@ OcppMessage *ConnectorStatus::loop() {
 
             if (txEnable == TxEnableState::Inactive) {
                 //stop transaction
-                auto seqNr = context.getTransactionService()->getTransactionSequence().reserveSeqNr();
-                transaction->getStopRpcSync().setRequested(seqNr);
-
+                
                 auto meteringService = context.getMeteringService();
                 if (transaction->getMeterStop() < 0 && meteringService) {
                     auto meterStop = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
@@ -251,13 +235,11 @@ OcppMessage *ConnectorStatus::loop() {
 
                 AO_DBG_INFO("Session mngt: trigger StopTransaction");
 
-                AO_DBG_DEBUG("Reserved SeqNr %u", seqNr);
-
                 if (context.getMeteringService()) {
                     auto txData = context.getMeteringService()->createStopTxMeterData(connectorId);
-                    return new StopTransaction(transaction, std::move(txData));
+                    return new StopTransaction(std::move(transaction), std::move(txData));
                 } else {
-                    return new StopTransaction(transaction);
+                    return new StopTransaction(std::move(transaction));
                 }
                 
             }
@@ -297,11 +279,13 @@ const char *ConnectorStatus::getErrorCode() {
 
 void ConnectorStatus::beginSession(const char *sessionIdTag) {
     
-    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
-
     if (!transaction) {
-        AO_DBG_ERR("Could not allocate Tx");
-        return;
+        transaction = context.getTransactionStore()->createTransaction(connectorId);
+
+        if (!transaction) {
+            AO_DBG_ERR("Could not allocate Tx");
+            return;
+        }
     }
     
     AO_DBG_DEBUG("Begin session with idTag %s, overwriting idTag %s", sessionIdTag != nullptr ? sessionIdTag : "", transaction->getIdTag());
@@ -319,10 +303,8 @@ void ConnectorStatus::beginSession(const char *sessionIdTag) {
 
 void ConnectorStatus::endSession(const char *reason) {
 
-    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
-
     if (!transaction) {
-        AO_DBG_ERR("Could not allocate Tx");
+        AO_DBG_WARN("Cannot end session if no transaction running");
         return;
     }
 
@@ -341,8 +323,6 @@ void ConnectorStatus::endSession(const char *reason) {
 
 const char *ConnectorStatus::getSessionIdTag() {
 
-    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
-
     if (!transaction) {
         return nullptr;
     }
@@ -351,13 +331,10 @@ const char *ConnectorStatus::getSessionIdTag() {
 }
 
 uint16_t ConnectorStatus::getSessionWriteCount() {
-    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
-    
     return transaction ? transaction->getTxNr() : 0;
 }
 
 int ConnectorStatus::getTransactionId() {
-    auto transaction = context.getTransactionService()->getTransactionStore().getActiveTransaction(connectorId);
     
     if (!transaction) {
         return -1;
@@ -375,10 +352,10 @@ int ConnectorStatus::getTransactionId() {
 }
 
 int ConnectorStatus::getTransactionIdSync() {
-    auto transaction = context.getTransactionService()->getTransactionStore().getTransactionSync(connectorId);
+    auto txSync = context.getTransactionStore()->getTransactionSync(connectorId);
     
-    if (transaction) {
-        return transaction->getTransactionId();
+    if (txSync) {
+        return txSync->getTransactionId();
     } else {
         return -1;
     }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index a266a4c7..d02e9ed8 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -32,6 +32,8 @@ class ConnectorStatus {
     
     const int connectorId;
 
+    std::shared_ptr<Transaction> transaction;
+
     std::shared_ptr<Configuration<int>> availability;
     bool rebooting = false; //report connector inoperative and reject new charging sessions
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index 2c89dbce..9e0e358a 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -201,5 +201,5 @@ bool Transaction::deserializeSessionState(JsonObject state) {
 }
 
 bool Transaction::commit() {
-    return context.getTransactionStore().commit(this);
+    return context.commit(this);
 }
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index 362e63c2..522dd35d 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -21,13 +21,13 @@ namespace ArduinoOcpp {
  * of the terminology is documented in OCPP 1.6 Specification - Edition 2, sections 3.6, 4.8, 4.10 and 5.11. 
  */
 
-class TransactionService;
+class ConnectorTransactionStore;
 
 class TransactionRPC {
 private:
     friend class Transaction;
 
-    TransactionService& context;
+    ConnectorTransactionStore& context;
     
     bool requested = false;
     bool confirmed = false;
@@ -35,7 +35,7 @@ class TransactionRPC {
     bool serializeSessionState(JsonObject out);
     bool deserializeSessionState(JsonObject in);
 public:
-    TransactionRPC(TransactionService& context) : context(context) { }
+    TransactionRPC(ConnectorTransactionStore& context) : context(context) { }
 
     void setRequested() {this->requested = true;}
     bool isRequested() {return requested;}
@@ -68,7 +68,7 @@ class TransactionStart {
     ClientTransactionStart client;
     ServerTransactionStart server;
 public:
-    TransactionStart(TransactionService& context) : rpc(context) { }
+    TransactionStart(ConnectorTransactionStore& context) : rpc(context) { }
 };
 
 class ClientTransactionStop {
@@ -93,7 +93,7 @@ class TransactionStop {
     ClientTransactionStop client;
     ServerTransactionStop server;
 public:
-    TransactionStop(TransactionService& context) : rpc(context) { }
+    TransactionStop(ConnectorTransactionStore& context) : rpc(context) { }
 };
 
 class ChargingSession {
@@ -112,7 +112,7 @@ class ChargingSession {
 
 class Transaction {
 private:
-    TransactionService& context;
+    ConnectorTransactionStore& context;
 
     ChargingSession session;      //data that exists before the tx
     TransactionStart start;
@@ -121,7 +121,7 @@ class Transaction {
     int connectorId = -1;
     uint txNr = 0; //only valid if session.connectorId is >= 0
 public:
-    Transaction(TransactionService& context, uint connectorId, uint txNr) : 
+    Transaction(ConnectorTransactionStore& context, uint connectorId, uint txNr) : 
                 context(context), 
                 start(context),
                 stop(context),
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
deleted file mode 100644
index 098f7493..00000000
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
+++ /dev/null
@@ -1,74 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppOperation.h>
-#include <ArduinoOcpp/Debug.h>
-
-using namespace ArduinoOcpp;
-
-#define AO_TXSERV_FN AO_FILENAME_PREFIX "/txserv.cnf"
-
-TransactionService::TransactionService(OcppEngine& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) : 
-        context(context),
-        txStore(*this, nConnectors, filesystem) {
-    
-    lastInitiatedSeqNr = declareConfiguration<int>("LastSeqNr", MAX_TXEVENT_CNT, AO_TXSERV_FN, false, false, true, false);
-    lastInitiatedMsgCnt = declareConfiguration<int>("LastMsgId", 1100000, AO_TXSERV_FN, false, false, true, false);
-
-    txStore.restorePendingTransactions();
-    /* txStore.submitPendingOperations(); */ AO_DBG_WARN("Disabled submitPendingOperations!");
-}
-
-void TransactionService::addRestoredOperation(uint seqNr, std::unique_ptr<OcppOperation> o) {
-    if (restoredOpsInitiated) {
-        AO_DBG_ERR("Can only restore at initialization. Abort");
-        return;
-    }
-    if (seqNr == (uint) *lastInitiatedSeqNr) {
-        AO_DBG_DEBUG("Rebase msgIds: %i", (int) *lastInitiatedMsgCnt);
-        o->rebaseMsgId(*lastInitiatedMsgCnt);
-    }
-    restoredOps.addOcppOperation(seqNr, std::move(o));
-}
-
-void TransactionService::initiateRestoredOperations() {
-    if (restoredOpsInitiated) {
-        AO_DBG_ERR("Called two times. Abort");
-        return;
-    }
-
-    restoredOps.sort(txSequence.getSeqEnd());
-
-    std::vector<std::unique_ptr<OcppOperation>> res;
-
-    restoredOps.moveTo(res);
-
-    for (auto operation = res.begin(); operation != res.end(); operation++) {
-        context.initiateOperation(std::move(*operation));
-    }
-    res.clear();
-
-    restoredOpsInitiated = true;
-}
-
-void TransactionService::setInitiatedMsgId(uint seqNr, int msgId) {
-    if (seqNr >= MAX_TXEVENT_CNT) {
-        AO_DBG_ERR("Invalid params");
-        return;
-    }
-    if ((uint) *lastInitiatedSeqNr == seqNr && *lastInitiatedMsgCnt == msgId) {
-        //Nothing to update
-        return;
-    }
-
-    AO_DBG_DEBUG("Set tx-related msg Id");
-    *lastInitiatedSeqNr = seqNr;
-    *lastInitiatedMsgCnt = msgId;
-    configuration_save();
-}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionService.h
deleted file mode 100644
index 93cd63c3..00000000
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionService.h
+++ /dev/null
@@ -1,44 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#ifndef TRANSACTIONSERVICE_H
-#define TRANSACTIONSERVICE_H
-
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionSequence.h>
-#include <ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.h>
-#include <memory>
-
-namespace ArduinoOcpp {
-
-class OcppEngine;
-class FilesystemAdapter;
-class OcppOperation;
-
-class TransactionService {
-private:
-    OcppEngine& context;
-
-    TransactionSequence txSequence;
-    TransactionStore txStore;
-    OrderedOperationsQueue restoredOps;//restore pending operations from flash in case of a power loss
-    bool restoredOpsInitiated = false;
-
-    std::shared_ptr<Configuration<int>> lastInitiatedSeqNr;
-    std::shared_ptr<Configuration<int>> lastInitiatedMsgCnt; //use this msgId for the current initiated operation
-public:
-    TransactionService(OcppEngine& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
-
-    void addRestoredOperation(uint seqNr, std::unique_ptr<OcppOperation> op);
-    void initiateRestoredOperations();
-
-    void setInitiatedMsgId(uint seqNr, int msgId);
-
-    TransactionStore& getTransactionStore() {return txStore;}
-    TransactionSequence& getTransactionSequence() {return txSequence;}
-};
-
-}
-
-#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index b7d31921..71711112 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -3,7 +3,6 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionService.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
@@ -23,7 +22,7 @@ using namespace ArduinoOcpp;
 
 #define MAX_TX_CNT 100000U
 
-ConnectorTransactionStore::ConnectorTransactionStore(TransactionService& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
+ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context),
         connectorId(connectorId),
         filesystem(filesystem) {
@@ -47,14 +46,19 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
             }
         }
     }
-    
-    //check all other elements 
-    for (auto cached_wp : transactions) {
-        if (auto cached = cached_wp.lock()) {
-            if (cached->getTxNr() == txNr) {
+
+    //check all other elements (and free up unused entries)
+    auto cached = transactions.begin();
+    while (cached != transactions.end()) {
+        if (auto tx = cached->lock()) {
+            if (tx->getTxNr() == txNr) {
                 //cache hit
-                return cached;
+                return tx;
             }
+            cached++;
+        } else {
+            //collect outdated cache reference
+            cached = transactions.erase(cached);
         }
     }
 
@@ -73,7 +77,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
     }
 
     size_t msize;
-    if (filesystem->stat(fn, msize) != 0) {
+    if (filesystem->stat(fn, &msize) != 0) {
         AO_DBG_DEBUG("tx does not exist");
         return nullptr;
     }
@@ -85,13 +89,18 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
         return nullptr;
     }
 
-    auto transaction = std::unique_ptr<Transaction>(new Transaction(context, connectorId, tx));
+    auto transaction = std::make_shared<Transaction>(*this, connectorId, txNr);
     JsonObject txJson = doc->as<JsonObject>();
     if (!transaction->deserializeSessionState(txJson)) {
         AO_DBG_ERR("deserialization error");
         return nullptr;
     }
 
+    //before adding new entry, clean cache
+    std::remove_if(transactions.begin(), transactions.end(), [](std::weak_ptr<Transaction> tx) {
+        return tx.expired();
+    });
+
     transactions.push_back(transaction);
     return transaction;
 }
@@ -113,6 +122,11 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction() {
         return nullptr;
     }
 
+    //before adding new entry, clean cache
+    std::remove_if(transactions.begin(), transactions.end(), [](std::weak_ptr<Transaction> tx) {
+        return tx.expired();
+    });
+
     transactions.push_back(transaction);
     return transaction;
 }
@@ -120,9 +134,10 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction() {
 std::shared_ptr<Transaction> ConnectorTransactionStore::getActiveTransaction() {
     
     if (!transactions.empty()) {
-        auto& tx = transactions.back();
-        if (tx->isActive() || tx->isRunning()) {
-            return tx;
+        if (auto tx = transactions.back().lock()) {
+            if (tx->isActive() || tx->isRunning()) {
+                return tx;
+            }
         }
     }
 
@@ -136,9 +151,10 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getActiveTransaction() {
 std::shared_ptr<Transaction> ConnectorTransactionStore::getTransactionSync() {
     
     if (!transactions.empty()) {
-        auto& tx = transactions.front();
-        if (tx->isRunning()) {
-            return tx;
+        if (auto tx = transactions.front().lock()) {
+            if (tx->isRunning()) {
+                return tx;
+            }
         }
     }
 
@@ -174,11 +190,11 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
     return true;
 }
 
-TransactionStore::TransactionStore(TransactionService& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
+TransactionStore::TransactionStore(uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
     
     for (uint i = 0; i < nConnectors; i++) {
         connectors.push_back(std::unique_ptr<ConnectorTransactionStore>(
-            new ConnectorTransactionStore(context, i, filesystem)));
+            new ConnectorTransactionStore(*this, i, filesystem)));
     }
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
index 0099cff1..26b62f1e 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
@@ -12,12 +12,11 @@
 
 namespace ArduinoOcpp {
 
-class TransactionService;
-class ConnectorTransactionSequence;
+class TransactionStore;
 
 class ConnectorTransactionStore {
 private:
-    TransactionService& context;
+    TransactionStore& context;
     const uint connectorId;
 
     std::shared_ptr<FilesystemAdapter> filesystem;
@@ -26,7 +25,7 @@ class ConnectorTransactionStore {
     std::deque<std::weak_ptr<Transaction>> transactions;
 
 public:
-    ConnectorTransactionStore(TransactionService& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
+    ConnectorTransactionStore(TransactionStore& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
     
     std::shared_ptr<Transaction> getActiveTransaction();
     std::shared_ptr<Transaction> getTransactionSync();
@@ -40,7 +39,7 @@ class TransactionStore {
 private:
     std::vector<std::unique_ptr<ConnectorTransactionStore>> connectors;
 public:
-    TransactionStore(TransactionService& context, uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+    TransactionStore(uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
     std::shared_ptr<Transaction> getActiveTransaction(uint connectorId);
     std::shared_ptr<Transaction> getTransactionSync(uint connectorId); //fron element of the tx queue; tx which is being executed at the server now

From 7df5ea51e0776c101a9bacbebf1568279d2061e1 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 25 Oct 2022 13:48:10 +0200
Subject: [PATCH 107/549] add timeout to UnlockConnector

---
 .../MessagesV16/UnlockConnector.cpp            | 18 +++++++++++++-----
 src/ArduinoOcpp/MessagesV16/UnlockConnector.h  |  1 +
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
index e883c89c..b1f3565f 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
@@ -9,6 +9,8 @@
 
 using ArduinoOcpp::Ocpp16::UnlockConnector;
 
+#define AO_UNLOCK_TIMEOUT 5000
+
 UnlockConnector::UnlockConnector() {
   
 }
@@ -36,14 +38,20 @@ void UnlockConnector::processReq(JsonObject payload) {
     } else {
         AO_DBG_WARN("Unlock CB undefined");
     }
+
+    timerStart = ao_tick_ms();
 }
 
 std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
-    if (unlockConnector) {
-        if (!cbUnlockResult) {
-            cbUnlockResult = unlockConnector();
+    if (!err && ao_tick_ms() - timerStart < AO_UNLOCK_TIMEOUT) {
+        //do poll and if more time is needed, delay creation of conf msg
+
+        if (unlockConnector) {
             if (!cbUnlockResult) {
-                return nullptr; //no result yet - delay confirmation response
+                cbUnlockResult = unlockConnector();
+                if (!cbUnlockResult) {
+                    return nullptr; //no result yet - delay confirmation response
+                }
             }
         }
     }
@@ -52,7 +60,7 @@ std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
     JsonObject payload = doc->to<JsonObject>();
     if (err || !unlockConnector) {
         payload["status"] = "NotSupported";
-    } else if (cbUnlockResult.toValue()) {
+    } else if (cbUnlockResult && cbUnlockResult.toValue()) {
         payload["status"] = "Unlocked";
     } else {
         payload["status"] = "UnlockFailed";
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
index a8b37220..f5625b9d 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
@@ -17,6 +17,7 @@ class UnlockConnector : public OcppMessage {
     bool err = false;
     std::function<PollResult<bool> ()> unlockConnector;
     PollResult<bool> cbUnlockResult;
+    unsigned long timerStart = 0; //for timeout
 public:
     UnlockConnector();
 

From 8b32dae91ac9e20c0d8a40121d93fe2a5d0f3389 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 25 Oct 2022 15:32:20 +0200
Subject: [PATCH 108/549] don't keep tx history by default

---
 .../Tasks/Transactions/TransactionStore.cpp   | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index fe4862bf..67be4482 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -250,9 +250,35 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
             beginNew = transactions.front()->getTxNr();
         }
         if (beginNew != (uint) *txBegin) {
+            unsigned int clearMem = *txBegin;
             *txBegin = beginNew;
+
+            while (clearMem != beginNew) {
+                char fn [MAX_PATH_SIZE] = {'\0'};
+                auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, clearMem);
+                if (ret < 0 || ret >= MAX_PATH_SIZE) {
+                    AO_DBG_ERR("fn error: %i", ret);
+                    break; //all files have same length
+                }
+
+                size_t msize;
+                if (filesystem->stat(fn, &msize) == 0) {
+                    bool ret = filesystem->remove(fn);
+                    if (!ret) {
+                        AO_DBG_ERR("memory corrupted: %s", fn);
+                    }
+                }
+
+                clearMem++;
+            }
+            
             configuration_save();
         }
+
+        if (transaction == transactions.front().get()) {
+            AO_DBG_DEBUG("Remove TX entry: %s", fn);
+            filesystem->remove(fn);
+        }
     }
 
     //success

From 8a9f79b33d332f1da5e1c1b8d29a07a3764beacf Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 25 Oct 2022 21:57:09 +0200
Subject: [PATCH 109/549] increase timeout

---
 src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
index b1f3565f..ed6a338d 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
@@ -9,7 +9,7 @@
 
 using ArduinoOcpp::Ocpp16::UnlockConnector;
 
-#define AO_UNLOCK_TIMEOUT 5000
+#define AO_UNLOCK_TIMEOUT 10000
 
 UnlockConnector::UnlockConnector() {
   

From 5ebeecf48dcc24f9467198206d8905d7dde0ff9f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 26 Oct 2022 17:01:05 +0200
Subject: [PATCH 110/549] integrate opstore into charging process

---
 src/ArduinoOcpp.cpp                           | 41 ++++++++++++++-----
 src/ArduinoOcpp.h                             |  2 +-
 src/ArduinoOcpp/Core/OcppOperation.cpp        |  9 ----
 src/ArduinoOcpp/Core/OperationsQueue.cpp      |  2 +-
 .../ChargePointStatus/ConnectorStatus.cpp     | 18 +++++---
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  4 +-
 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp |  5 ++-
 .../Tasks/Transactions/Transaction.cpp        |  4 +-
 .../Tasks/Transactions/TransactionStore.cpp   |  4 +-
 9 files changed, 56 insertions(+), 33 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 93a86890..11866e42 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -302,6 +302,12 @@ void setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
         return;
     }
     connector->setConnectorPluggedSampler(connectorPlugged);
+
+    if (connectorPlugged) {
+        AO_DBG_INFO("Added ConnectorPluggedSampler. Transaction-management is in auto mode now");
+    } else {
+        AO_DBG_INFO("Reset ConnectorPluggedSampler. Transaction-management is in manual mode now");
+    }
 }
 
 void addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode) {
@@ -464,18 +470,26 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
-    auto transaction = ocppEngine->getOcppModel().getTransactionStore()->getActiveTransaction(OCPP_ID_OF_CONNECTOR);
-    if (!transaction) {
-        AO_DBG_ERR("Transaction buffer full");
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
-
-    if (transaction->isRunning()) {
-        AO_DBG_ERR("Called StartTx while still in transaction. Please call StopTx");
-        return false;
+    auto transaction = connector->getTransaction();
+    if (transaction) {
+        if (transaction->getStartRpcSync().isRequested()) {
+            AO_DBG_ERR("Transaction already in progress. Must call stopTransaction()");
+            return false;
+        }
+        transaction->setIdTag(idTag);
+    } else {
+        beginSession(idTag); //request new transaction object
+        transaction = connector->getTransaction();
+        if (!transaction) {
+            AO_DBG_WARN("Transaction queue full");
+            return false;
+        }
     }
-
-    transaction->setIdTag(idTag);
     
     auto startTransaction = makeOcppOperation(
         new StartTransaction(transaction));
@@ -501,13 +515,20 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return false;
+    }
 
-    auto transaction = ocppEngine->getOcppModel().getTransactionStore()->getActiveTransaction(OCPP_ID_OF_CONNECTOR);
+    auto transaction = connector->getTransaction();
     if (!transaction || !transaction->isRunning()) {
         AO_DBG_ERR("No running Tx to stop");
         return false;
     }
 
+    connector->releaseTransaction();
+
     const char *idTag = transaction->getIdTag();
     if (idTag) {
         transaction->setStopIdTag(idTag);
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 4f485099..b44c0d10 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -90,7 +90,7 @@ void setOnUnlockConnector(std::function<ArduinoOcpp::PollResult<bool>()> unlockC
 void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnector);
 
 //Set a Cb to update transaction-based energy measurements with the most recent transaction state.
-//This allows energy meters (e.g. based on OCMF) to take their measruements right before and after a transaction
+//This allows energy meters to take their measruements right before and after a transaction
 //Return values: - TxEnableState::Active if the energy meter confirmed to be in the transaction-state
 //               - TxEnableState::Inactive if the energy meter has transitioned into a non-transaction-state
 //               - TxEnableState::Pending otherwise, e.g. if transitioning between the states
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 781082b6..e78dc14a 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -123,15 +123,6 @@ bool OcppOperation::sendReq(OcppSocket& ocppSocket){
     requestJson.add(ocppMessage->getOcppOperationType());  //Action
     requestJson.add(*requestPayload);                      //Payload
 
-    /*
-     * Transaction safety: before sending the message, store the assigned msgId so this action
-     * can be replayed when booted the next time
-     */
-    auto txSync = ocppMessage->getTransactionSync();
-    if (txSync) {
-        txSync->requestWithMsgId(unique_id_counter);
-    }
-
     /*
      * Serialize and send. Destroy serialization and JSON object. 
      * 
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index 800f73b6..06e7b407 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -34,7 +34,7 @@ OcppOperation *OperationsQueue::front() {
 void OperationsQueue::pop_front() {
     
     if (head && head->getStorageHandler() && head->getStorageHandler()->getOpNr() >= 0) {
-        if (head->getStorageHandler()->getOpNr() != opStore.getOpBegin()) {
+        if ((unsigned int) head->getStorageHandler()->getOpNr() != opStore.getOpBegin()) {
             AO_DBG_ERR("wrong order, removed op from queue before increasing opBegin");
             (void)0;
         }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index f4339d07..6f220b9f 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -45,7 +45,7 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
      * By default, transactions are triggered by a valid IdTag (+ connected plug as soon as set)
      * The default necessary steps before starting a transaction are
      *     - lock the connector (if handler is set)
-     *     - instruct the OCMF meter to begin a transaction (if OCMF meter handler is set)
+     *     - instruct the tx-based meter to begin a transaction (if tx-based meter handler is set)
      */
     txProcess.addTrigger([this] () -> TxTrigger {
         if (transaction && transaction->isInSession() && transaction->isActive()) {
@@ -55,8 +55,8 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
         }
     });
     txProcess.addEnableStep([this] (TxTrigger cond) -> TxEnableState {
-        if (onOcmfMeterPollTx) {
-            return onOcmfMeterPollTx(cond);
+        if (onTxBasedMeterPollTx) {
+            return onTxBasedMeterPollTx(cond);
         }
         return cond == TxTrigger::Active ? TxEnableState::Active : TxEnableState::Inactive;
     });
@@ -361,6 +361,14 @@ int ConnectorStatus::getTransactionIdSync() {
     }
 }
 
+std::shared_ptr<Transaction> ConnectorStatus::getTransaction() {
+    return transaction;
+}
+
+void ConnectorStatus::releaseTransaction() {
+    transaction = nullptr;
+}
+
 int ConnectorStatus::getAvailability() {
     return *availability;
 }
@@ -417,6 +425,6 @@ void ConnectorStatus::setConnectorLock(std::function<TxEnableState(TxTrigger)> o
     this->onConnectorLockPollTx = onConnectorLockPollTx;
 }
 
-void ConnectorStatus::setTxBasedMeterUpdate(std::function<TxEnableState(TxTrigger)> onOcmfMeterPollTx) {
-    this->onOcmfMeterPollTx = onOcmfMeterPollTx;
+void ConnectorStatus::setTxBasedMeterUpdate(std::function<TxEnableState(TxTrigger)> onTxBasedMeterPollTx) {
+    this->onTxBasedMeterPollTx = onTxBasedMeterPollTx;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index d02e9ed8..de79c673 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -51,7 +51,7 @@ class ConnectorStatus {
     std::function<PollResult<bool>()> onUnlockConnector;
 
     std::function<TxEnableState(TxTrigger)> onConnectorLockPollTx;
-    std::function<TxEnableState(TxTrigger)> onOcmfMeterPollTx;
+    std::function<TxEnableState(TxTrigger)> onTxBasedMeterPollTx;
 
     TransactionProcess txProcess;
 
@@ -80,6 +80,8 @@ class ConnectorStatus {
     uint16_t getSessionWriteCount();
     int getTransactionId();
     int getTransactionIdSync();
+    std::shared_ptr<Transaction> getTransaction();
+    void releaseTransaction();
 
     int getAvailability();
     void setAvailability(bool available);
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
index 835bda04..9ff39b81 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
@@ -53,6 +53,7 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
 
     txData.push_back(std::move(mv));
     mvCount++;
+    return true;
 }
 
 std::vector<std::unique_ptr<MeterValue>> TransactionMeterData::retrieveStopTxData() {
@@ -192,10 +193,10 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
 
     if (filesystem) {
         if (mvCount > 0) {
-            for (unsigned int i = 0; i < mvCount; i++) { //search until region without txs found
+            for (int i = 0; i < mvCount; i++) { //search until region without txs found
             
                 char fn [MAX_PATH_SIZE] = {'\0'};
-                auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
+                auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%d.jsn", connectorId, txNr, i);
                 if (ret < 0 || ret >= MAX_PATH_SIZE) {
                     AO_DBG_ERR("fn error: %i", ret);
                     return false; //all files have same length
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index 9e0e358a..07bd2eb9 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -190,8 +190,8 @@ bool Transaction::deserializeSessionState(JsonObject state) {
 
     AO_DBG_DEBUG("DUMP TX");
     AO_DBG_DEBUG("Session   | idTag %s", session.idTag);
-    AO_DBG_DEBUG("Start RPC | req: %i, seq: %u, conf: %i", start.rpc.requested, start.rpc.seqNr, start.rpc.confirmed);
-    AO_DBG_DEBUG("Stop  RPC | req: %i, seq: %u, conf: %i",  stop.rpc.requested,  stop.rpc.seqNr,  stop.rpc.confirmed);
+    AO_DBG_DEBUG("Start RPC | req: %i, conf: %i", start.rpc.requested, start.rpc.confirmed);
+    AO_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  stop.rpc.requested, stop.rpc.confirmed);
 
     //if (stop.rpc.confirmed) {
     //    JsonObject txStopServerSide = txStop["server"];
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index 71711112..1c347bac 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -107,13 +107,13 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction() {
 
-    auto transaction = std::make_shared<Transaction>(context, connectorId, txEnd);
-
     if (!txEnd || *txEnd < 0) {
         AO_DBG_ERR("memory corruption");
         return nullptr;
     }
 
+    auto transaction = std::make_shared<Transaction>(*this, connectorId, (unsigned int) *txEnd);
+
     *txEnd = (*txEnd + 1) % MAX_TX_CNT;
     configuration_save();
 

From f825cad67795f0271d4e06345b4164c770b297a1 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 27 Oct 2022 11:37:57 +0200
Subject: [PATCH 111/549] revise charging process

---
 src/ArduinoOcpp.cpp                           |  2 ++
 src/ArduinoOcpp/Core/OcppConnection.cpp       |  5 ---
 src/ArduinoOcpp/Core/OcppOperation.cpp        | 34 ++++++++-----------
 src/ArduinoOcpp/Core/OcppOperation.h          |  2 --
 src/ArduinoOcpp/Core/OperationStore.cpp       | 24 ++++---------
 src/ArduinoOcpp/Core/OperationStore.h         |  3 +-
 src/ArduinoOcpp/Core/OperationsQueue.cpp      | 11 +++---
 .../MessagesV16/StopTransaction.cpp           |  3 +-
 .../ChargePointStatus/ConnectorStatus.cpp     |  3 +-
 .../Tasks/Transactions/TransactionProcess.cpp | 33 ++----------------
 .../Tasks/Transactions/TransactionProcess.h   |  6 +---
 tests/TransactionProcess.cpp                  | 32 +++++++++--------
 12 files changed, 55 insertions(+), 103 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 11866e42..d4c130b0 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -527,6 +527,8 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         return false;
     }
 
+    connector->endSession("Local");
+
     connector->releaseTransaction();
 
     const char *idTag = transaction->getIdTag();
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 3417521a..639bda9d 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -39,7 +39,6 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
     if (inited) {
         bool timeout = inited->sendReq(ocppSock); //The only reason to dequeue elements here is when a timeout occurs. Normally
         if (timeout){                                       //the Conf msg processing routine dequeues finished elements
-            inited->finalize();
             initiatedOcppOperations.pop_front();
         }
     }
@@ -61,7 +60,6 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
                 (!(*cached)->getStorageHandler() || (*cached)->getStorageHandler()->getOpNr() < 0)) {
             AO_DBG_INFO("Discarding cached due to timeout:");
             (*cached)->print_debug();
-            (*cached)->finalize();
             cached = initiatedOcppOperations.erase_tail(cached);
         } else {
             ++cached;
@@ -77,7 +75,6 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
     while (received != receivedOcppOperations.end()){
         bool success = (*received)->sendConf(ocppSock);
         if (success){
-            (*received)->finalize();
             received = receivedOcppOperations.erase(received);
         } else {
             //There will be another attempt to send this conf message in a future loop call.
@@ -193,7 +190,6 @@ void OcppConnection::handleConfMessage(JsonDocument& json) {
         [&json, &success] (std::unique_ptr<OcppOperation>& operation) {
             bool match = operation->receiveConf(json);
             if (match) {
-                operation->finalize();
                 success = true;
                 //operation will be deleted by the surrounding drop_if
             }
@@ -234,7 +230,6 @@ void OcppConnection::handleErrMessage(JsonDocument& json) {
         [&json, &success] (std::unique_ptr<OcppOperation>& operation) {
             bool match = operation->receiveError(json);
             if (match) {
-                operation->finalize();
                 success = true;
                 //operation will be deleted by the surrounding drop_if
             }
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index e78dc14a..d76579fc 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -142,7 +142,7 @@ bool OcppOperation::sendReq(OcppSocket& ocppSocket){
     bool success = ocppSocket.sendTXT(out);
 
     timeout->tick(success);
-    
+
     if (success) {
         AO_DBG_TRAFFIC_OUT(out.c_str());
         retry_start = ao_tick_ms();
@@ -354,8 +354,7 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
     opStore = std::move(opStorage);
 
     auto rpcData = opStore->getRpc();
-    auto payloadData = opStore->getPayload();
-    if (!rpcData || !payloadData) {
+    if (!rpcData) {
         AO_DBG_ERR("corrupted storage");
         return false;
     }
@@ -371,8 +370,8 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
     int parsedMessageID = -1;
     if (sscanf(messageID.c_str(), "%d", &parsedMessageID) == 1) {
         if (parsedMessageID > unique_id_counter) {
-            unique_id_counter = parsedMessageID;
-            AO_DBG_VERBOSE("restore unique_id_counter = %d", unique_id_counter);
+            AO_DBG_DEBUG("restore unique_id_counter with %d", parsedMessageID);
+            unique_id_counter = parsedMessageID + 1; //next unique value is parsedId + 1
         }
     } else {
         AO_DBG_ERR("cannot set unique msgID counter");
@@ -380,38 +379,33 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
         //skip this step but don't abort restore
     }
 
-    std::unique_ptr<OcppMessage> msg;
-
     if (!strcmp(opType.c_str(), "StartTransaction")) { //TODO this will get a nicer solution
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction());
+        ocppMessage = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction());
     } else if (!strcmp(opType.c_str(), "StopTransaction")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StopTransaction());
+        ocppMessage = std::unique_ptr<OcppMessage>(new Ocpp16::StopTransaction());
     }
 
-    if (!msg) {
+    if (!ocppMessage) {
         AO_DBG_ERR("cannot create msg");
         return false;
     }
 
-    msg->setOcppModel(oModel);
+    ocppMessage->setOcppModel(oModel);
 
-    bool success = msg->restore(opStore.get());
+    bool success = ocppMessage->restore(opStore.get());
     opStore->releaseBuffer();
 
-    if (!success) {
-        AO_DBG_ERR("restore error");
+    if (success) {
+        AO_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), ocppMessage->getOcppOperationType());
+        (void)0;
+    } else {
+        AO_DBG_ERR("restore opNr %i error", opStore->getOpNr());
         (void)0;
     }
 
     return success;
 }
 
-void OcppOperation::finalize() {
-    if (opStore) {
-        opStore->confirm();
-    }
-}
-
 void OcppOperation::setOnReceiveConfListener(OnReceiveConfListener onReceiveConf){
     if (onReceiveConf)
         onReceiveConfListener = onReceiveConf;
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index 4e573dd2..cb13f62d 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -107,8 +107,6 @@ class OcppOperation {
 
     StoredOperationHandler *getStorageHandler() {return opStore.get();}
 
-    void finalize(); //called whenever this operation is completed or aborted right before the destructor
-
     void setOnReceiveConfListener(OnReceiveConfListener onReceiveConf);
 
     /**
diff --git a/src/ArduinoOcpp/Core/OperationStore.cpp b/src/ArduinoOcpp/Core/OperationStore.cpp
index b5ba2713..68b5a39c 100644
--- a/src/ArduinoOcpp/Core/OperationStore.cpp
+++ b/src/ArduinoOcpp/Core/OperationStore.cpp
@@ -55,16 +55,6 @@ bool StoredOperationHandler::commit() {
     return true;
 }
 
-void StoredOperationHandler::confirm() {
-    if (isPersistent && opNr < 0) {
-        AO_DBG_ERR("invalid state");
-        return;
-    }
-    if (isPersistent) {
-        context.confirm((unsigned int) opNr);
-    }
-}
-
 bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
     if (isPersistent) {
         AO_DBG_ERR("cannot restore after commit");
@@ -96,8 +86,8 @@ bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
         return false;
     }
     
-    JsonObject rpc_restore = (*doc)["rpc"];
-    JsonObject payload_restore = (*doc)["payload"];
+    JsonVariant rpc_restore = (*doc)["rpc"];
+    JsonVariant payload_restore = (*doc)["payload"];
 
     rpc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(rpc_restore.memoryUsage()));
     payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(payload_restore.memoryUsage()));
@@ -157,14 +147,14 @@ unsigned int OperationStore::reserveOpNr() {
     return res;
 }
 
-void OperationStore::confirm(unsigned int opNr) {
+void OperationStore::advanceOpNr(unsigned int oldOpNr) {
     if (!opBegin || *opBegin < 0) {
         AO_DBG_ERR("init failure");
         return;
     }
 
-    if (opNr != (unsigned int) *opBegin) {
-        if (opNr - (unsigned int) *opBegin < 100) {
+    if (oldOpNr != (unsigned int) *opBegin) {
+        if (oldOpNr - (unsigned int) *opBegin < 100) {
             AO_DBG_ERR("synchronization failure - try to fix");
             (void)0;
         } else {
@@ -173,8 +163,8 @@ void OperationStore::confirm(unsigned int opNr) {
         }
     }
 
-    opNr++;
-    opNr %= AO_MAX_OPNR;
+    unsigned int opNr = (oldOpNr + 1) % AO_MAX_OPNR;
+
     AO_DBG_DEBUG("advance opBegin: %u", opNr);
     *opBegin = opNr;
     configuration_save();
diff --git a/src/ArduinoOcpp/Core/OperationStore.h b/src/ArduinoOcpp/Core/OperationStore.h
index 3bd20454..0fd6cd3d 100644
--- a/src/ArduinoOcpp/Core/OperationStore.h
+++ b/src/ArduinoOcpp/Core/OperationStore.h
@@ -37,7 +37,6 @@ class StoredOperationHandler {
 
     bool commit();
     void releaseBuffer() {rpc.release(); payload.release();}
-    void confirm();
 
     bool restore(unsigned int opNr);
 
@@ -58,7 +57,7 @@ class OperationStore {
     std::unique_ptr<StoredOperationHandler> fetchOpHandler(unsigned int opNr);
 
     unsigned int reserveOpNr();
-    void confirm(unsigned int opNr);
+    void advanceOpNr(unsigned int oldOpNr);
 
     unsigned int getOpBegin();
 };
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index 06e7b407..aefbdeca 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -34,10 +34,8 @@ OcppOperation *OperationsQueue::front() {
 void OperationsQueue::pop_front() {
     
     if (head && head->getStorageHandler() && head->getStorageHandler()->getOpNr() >= 0) {
-        if ((unsigned int) head->getStorageHandler()->getOpNr() != opStore.getOpBegin()) {
-            AO_DBG_ERR("wrong order, removed op from queue before increasing opBegin");
-            (void)0;
-        }
+        opStore.advanceOpNr(head->getStorageHandler()->getOpNr());
+        AO_DBG_DEBUG("advanced %i to %u", head->getStorageHandler()->getOpNr(), opStore.getOpBegin());
     }
 
     head.release();
@@ -87,6 +85,11 @@ void OperationsQueue::pop_front() {
                 AO_DBG_ERR("could not restore operation");
                 fetched.release();
             }
+
+            if (!fetched->isFullyConfigured()) {
+                AO_DBG_ERR("stored op initialization failure");
+                fetched.release();
+            }
         }
 
         if (fetched) {
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 722cb584..18cbc884 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -63,7 +63,8 @@ bool StopTransaction::initiate(StoredOperationHandler *opStore) {
         return false; //execute legacy initiate instead
     }
     
-    auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+    (*payload)["connectorId"] = transaction->getConnectorId();
     (*payload)["txNr"] = transaction->getTxNr();
 
     opStore->setPayload(std::move(payload));
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 6f220b9f..b49577df 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -142,6 +142,8 @@ OcppMessage *ConnectorStatus::loop() {
         saveState();
     }
 
+    txProcess.evaluateProcessSteps();
+
     if (transaction) { //begin exclusively transaction-related operations
             
         if (connectorPluggedSampler) {
@@ -175,7 +177,6 @@ OcppMessage *ConnectorStatus::loop() {
             }
         }
 
-        txProcess.evaluateProcessSteps(transaction->getTxNr());
         auto txEnable = txProcess.getState();
 
         /*
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
index 67a8b34b..139a7756 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
@@ -11,15 +11,7 @@
 using namespace ArduinoOcpp;
 
 TransactionProcess::TransactionProcess(uint connectorId) {
-    char key [30] = {'\0'};
-    if (snprintf(key, 30, "AO_txNrRef_%u", connectorId) < 0) {
-        AO_DBG_ERR("Invalid key");
-        (void)0;
-    }
-    txNrRef = declareConfiguration<int>(key, 0, AO_TXPROC_FN, false, false, true, false);
-    if (!txNrRef || *txNrRef < 0) {
-        AO_DBG_ERR("Initialization failure");
-    }
+
 }
 
 /*
@@ -29,7 +21,7 @@ TransactionProcess::TransactionProcess(uint connectorId) {
  * 
  * txEnable is the output variable. See getState() for getting the result.
  */
-void TransactionProcess::evaluateProcessSteps(uint txNr) {
+void TransactionProcess::evaluateProcessSteps() {
 
 #if AO_DBG_LEVEL >= AO_DL_DEBUG
     //print transitions to debug console
@@ -51,11 +43,6 @@ void TransactionProcess::evaluateProcessSteps(uint txNr) {
         txTrigger = TxTrigger::Inactive;
     }
 
-    //Check if the current process is obsolete
-    if (txNrRef && (uint) *txNrRef != txNr) {
-        txTrigger = TxTrigger::Inactive;
-    }
-
     //Determine if
     // - No trigger is active      -> activeTriggerExists = false, txTrigger = Inactive
     // - All triggers are active   -> activeTriggerExists = true,  txTrigger = Active
@@ -93,15 +80,6 @@ void TransactionProcess::evaluateProcessSteps(uint txNr) {
         }
     }
 
-    //If the current process is obsolete: Check if updating the tx reference is possible
-    if (txNrRef && (uint) *txNrRef != txNr) {
-        if (txEnable == TxEnableState::Inactive) {
-            AO_DBG_DEBUG("Upgrade to next tx: %u", txNr);
-            *txNrRef = txNr;
-            configuration_save();
-        }
-    }
-
 #if AO_DBG_LEVEL >= AO_DL_DEBUG
     if (txEnableBefore != txEnable) {
         AO_DBG_DEBUG("Transition from %s to %s",
@@ -111,10 +89,3 @@ void TransactionProcess::evaluateProcessSteps(uint txNr) {
 #endif
 
 }
-
-uint TransactionProcess::getTxNrRef() {
-    if (txNrRef) {
-        return (uint) *txNrRef;
-    }
-    return 0;
-}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
index 1f87eca9..375fb37a 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
@@ -22,8 +22,6 @@ class TransactionProcess {
 
     bool activeTriggerExists = false;
     TxEnableState txEnable {TxEnableState::Inactive}; // = Result of Trigger and Enable Sequence
-
-    std::shared_ptr<Configuration<int>> txNrRef;
     
 public:
 
@@ -35,12 +33,10 @@ class TransactionProcess {
 
     void addEnableStep(std::function<TxEnableState(TxTrigger)> fn) {txEnableSequence.push_back(fn);}
 
-    void evaluateProcessSteps(uint txNr);
+    void evaluateProcessSteps();
 
     bool existsActiveTrigger() {return activeTriggerExists;}
     TxEnableState getState() {return txEnable;}
-
-    uint getTxNrRef();
 };
 
 }
diff --git a/tests/TransactionProcess.cpp b/tests/TransactionProcess.cpp
index ed4a8801..b422761b 100644
--- a/tests/TransactionProcess.cpp
+++ b/tests/TransactionProcess.cpp
@@ -10,7 +10,7 @@ TEST_CASE( "Transaction process - trivial" ) {
     TransactionProcess txProcess {1};
 
     SECTION("Trivial transaction process"){
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( !txProcess.existsActiveTrigger() );
         REQUIRE( txProcess.getState() == TxEnableState::Inactive );
     }
@@ -22,7 +22,7 @@ TEST_CASE( "Transaction process - trivial" ) {
             notified = true;
             return TxEnableState::Inactive;
         });
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( notified );
         REQUIRE( txProcess.getState() == TxEnableState::Inactive );
     }
@@ -50,31 +50,31 @@ TEST_CASE("Transaction process - inputs") {
     });
 
     SECTION("All active") {
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE(txProcess.getState() == TxEnableState::Active);
     }
 
     SECTION("Precondition") {
         precondition = TxPrecondition::Inactive;
         checkTrigger = TxTrigger::Inactive;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( txProcess.getState() != TxEnableState::Active );
     }
 
     SECTION("Trigger") {
         trigger = TxTrigger::Inactive;
         checkTrigger = TxTrigger::Inactive;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( txProcess.getState() != TxEnableState::Active );
     }
 
     SECTION("Output enable") {
         enable = TxEnableState::Inactive;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( txProcess.getState() == TxEnableState::Pending );
 
         enable = TxEnableState::Pending;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( txProcess.getState() == TxEnableState::Pending );
     }
 }
@@ -110,37 +110,37 @@ TEST_CASE("Transaction process - execution order") {
     
     SECTION("Precondition"){
         preconditions[0] = TxPrecondition::Inactive;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( txProcess.getState() != TxEnableState::Active );
 
         preconditions[0] = TxPrecondition::Active;
         preconditions[1] = TxPrecondition::Inactive;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( txProcess.getState() != TxEnableState::Active );
     }
 
     SECTION("Trigger") {
         triggers[0] = TxTrigger::Inactive;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( txProcess.getState() != TxEnableState::Active );
         REQUIRE( txProcess.existsActiveTrigger());
 
         triggers[0] = TxTrigger::Active;
         triggers[1] = TxTrigger::Inactive;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE( txProcess.getState() != TxEnableState::Active );
         REQUIRE( txProcess.existsActiveTrigger());
     }
 
     SECTION("Output enable - all active"){
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE(checkSeq[0] == 1);
         REQUIRE(checkSeq[1] == 0);
     }
 
     SECTION("Output enable - active pending"){
         enableSteps[1] = TxEnableState::Pending;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE(checkSeq[0] == -1);
         REQUIRE(checkSeq[1] == 0);
     }
@@ -148,7 +148,7 @@ TEST_CASE("Transaction process - execution order") {
     SECTION("Output enable - inactive"){
         preconditions[0] = TxPrecondition::Inactive;
         enableSteps[0] = TxEnableState::Inactive;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE(checkSeq[0] == 0);
         REQUIRE(checkSeq[1] == 1);
     }
@@ -156,7 +156,7 @@ TEST_CASE("Transaction process - execution order") {
     SECTION("Output enable - inactive pending"){
         preconditions[0] = TxPrecondition::Inactive;
         enableSteps[0] = TxEnableState::Pending;
-        txProcess.evaluateProcessSteps(0);
+        txProcess.evaluateProcessSteps();
         REQUIRE(checkSeq[0] == 0);
         REQUIRE(checkSeq[1] == -1);
     }
@@ -181,6 +181,7 @@ TEST_CASE("Transaction process - begin new transaction") {
         return enable;
     });
 
+/*
     SECTION("Evaluate different txNr") {
         auto txNr = txProcess.getTxNrRef();
         txProcess.evaluateProcessSteps(txNr + 1); //try to evaluate newer transaction
@@ -196,4 +197,5 @@ TEST_CASE("Transaction process - begin new transaction") {
         txProcess.evaluateProcessSteps(txNr + 1);
         REQUIRE( txNr + 1 == txProcess.getTxNrRef() );
     }
+*/
 }

From 853d2dbd873b2ffb020762cfc29b5177e415d82d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 30 Oct 2022 19:20:54 +0100
Subject: [PATCH 112/549] refactored MV storage for StopTx

---
 src/ArduinoOcpp.cpp                           | 10 +-
 src/ArduinoOcpp/Core/OperationStore.cpp       |  2 +-
 src/ArduinoOcpp/Core/OperationsQueue.cpp      |  2 +-
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp   | 23 ++---
 src/ArduinoOcpp/MessagesV16/MeterValues.h     |  7 +-
 .../ChargePointStatus/ConnectorStatus.cpp     | 38 +++++---
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  3 +-
 .../Metering/ConnectorMeterValuesRecorder.cpp | 92 ++++++++++++-------
 .../Metering/ConnectorMeterValuesRecorder.h   | 16 +++-
 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp | 29 +++++-
 src/ArduinoOcpp/Tasks/Metering/MeterStore.h   |  5 +-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp | 10 +-
 .../Tasks/Metering/MeteringService.cpp        | 32 ++++++-
 .../Tasks/Metering/MeteringService.h          |  9 +-
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h | 12 +--
 .../Tasks/Transactions/TransactionStore.cpp   | 43 ++-------
 .../Tasks/Transactions/TransactionStore.h     |  6 +-
 17 files changed, 200 insertions(+), 139 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index d4c130b0..8464dde3 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -91,9 +91,7 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
     fileSystemOpt = fsOpt;
 
 #ifndef AO_DEACTIVATE_FLASH
-    std::shared_ptr<FilesystemAdapter> filesystem = makeDefaultFilesystemAdapter(fileSystemOpt);
-#else
-    std::shared_ptr<FilesystemAdapter> filesystem;
+    filesystem = makeDefaultFilesystemAdapter(fileSystemOpt);
 #endif
     AO_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "error");
     
@@ -183,7 +181,7 @@ void setPowerActiveImportSampler(std::function<float()> power) {
     auto& model = ocppEngine->getOcppModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS)));
+            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Power.Active.Import");
@@ -205,7 +203,7 @@ void setEnergyActiveImportSampler(std::function<float()> energy) {
     auto& model = ocppEngine->getOcppModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS)));
+            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Energy.Active.Import.Register");
@@ -227,7 +225,7 @@ void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler
     auto& model = ocppEngine->getOcppModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS)));
+            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
     }
     model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(meterValueSampler)); //connectorId=1
 }
diff --git a/src/ArduinoOcpp/Core/OperationStore.cpp b/src/ArduinoOcpp/Core/OperationStore.cpp
index 68b5a39c..971cff78 100644
--- a/src/ArduinoOcpp/Core/OperationStore.cpp
+++ b/src/ArduinoOcpp/Core/OperationStore.cpp
@@ -76,7 +76,7 @@ bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
 
     size_t msize;
     if (filesystem->stat(fn, &msize) != 0) {
-        AO_DBG_DEBUG("operation %u does not exist", opNr);
+        AO_DBG_VERBOSE("operation %u does not exist", opNr);
         return false;
     }
 
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index aefbdeca..b25ff625 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -107,7 +107,7 @@ void OperationsQueue::pop_front() {
         }
     }
 
-    AO_DBG_DEBUG("popped front");
+    AO_DBG_VERBOSE("popped front");
 }
 
 void OperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index b9edaf99..053c5309 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -6,6 +6,7 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::MeterValues;
@@ -17,9 +18,9 @@ MeterValues::MeterValues() {
     
 }
 
-MeterValues::MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, int connectorId) 
-      : meterValue{std::move(meterValue)}, connectorId{connectorId} {
-
+MeterValues::MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction) 
+      : meterValue{std::move(meterValue)}, connectorId{connectorId}, transaction{transaction} {
+    
 }
 
 MeterValues::~MeterValues(){
@@ -31,7 +32,7 @@ const char* MeterValues::getOcppOperationType(){
 }
 
 void MeterValues::initiate() {
-    emTimeout = ao_tick_ms();
+
 }
 
 std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
@@ -45,11 +46,8 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
             capacity += entry->capacity();
             entries.push_back(std::move(entry));
         } else {
-            if (ao_tick_ms() - emTimeout < ENERGY_METER_TIMEOUT_MS) {
-                return nullptr;
-            } else {
-                AO_DBG_ERR("Energy meter timeout!");
-            }
+            AO_DBG_ERR("Energy meter reading not convertible to JSON");
+            (void)0;
         }
     }
 
@@ -60,11 +58,8 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
     auto payload = doc->to<JsonObject>();
     payload["connectorId"] = connectorId;
 
-    if (ocppModel && ocppModel->getConnectorStatus(connectorId)) {
-        auto connector = ocppModel->getConnectorStatus(connectorId);
-        if (connector->getTransactionIdSync() >= 0) {
-            payload["transactionId"] = connector->getTransactionIdSync();
-        }
+    if (transaction) {
+        payload["transactionId"] = transaction->getTransactionId();
     }
 
     auto meterValueJson = payload.createNestedArray("meterValue");
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.h b/src/ArduinoOcpp/MessagesV16/MeterValues.h
index 82092c80..4c413c79 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.h
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.h
@@ -13,6 +13,7 @@
 namespace ArduinoOcpp {
 
 class MeterValue;
+class Transaction;
 
 namespace Ocpp16 {
 
@@ -20,12 +21,12 @@ class MeterValues : public OcppMessage {
 private:
     std::vector<std::unique_ptr<MeterValue>> meterValue;
 
-    int connectorId = 0;
+    unsigned int connectorId = 0;
 
-    ulong emTimeout = 0;
+    std::shared_ptr<Transaction> transaction;
 
 public:
-    MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, int connectorId);
+    MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction = nullptr);
 
     MeterValues(); //for debugging only. Make this for the server pendant
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index b49577df..7f9d6ce4 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -66,6 +66,13 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
         }
         return cond == TxTrigger::Active ? TxEnableState::Active : TxEnableState::Inactive;
     });
+
+    if (context.getTransactionStore()) {
+        transaction = context.getTransactionStore()->getLatestTransaction(connectorId);
+    } else {
+        AO_DBG_ERR("must initialize TxStore before ConnectorStatus");
+        (void)0;
+    }
 }
 
 OcppEvseState ConnectorStatus::inferenceStatus() {
@@ -142,6 +149,11 @@ OcppMessage *ConnectorStatus::loop() {
         saveState();
     }
 
+    if (transaction && (transaction->isAborted() || transaction->isCompleted())) {
+        AO_DBG_DEBUG("collect obsolete transaction");
+        transaction = nullptr;
+    }
+
     txProcess.evaluateProcessSteps();
 
     if (transaction) { //begin exclusively transaction-related operations
@@ -205,6 +217,10 @@ OcppMessage *ConnectorStatus::loop() {
 
                 transaction->commit();
 
+                if (context.getMeteringService()) {
+                    context.getMeteringService()->beginTxMeterData(transaction.get());
+                }
+
                 return new StartTransaction(transaction);
             }
         } else if (transaction->isRunning()) {
@@ -237,7 +253,7 @@ OcppMessage *ConnectorStatus::loop() {
                 AO_DBG_INFO("Session mngt: trigger StopTransaction");
 
                 if (context.getMeteringService()) {
-                    auto txData = context.getMeteringService()->createStopTxMeterData(connectorId);
+                    auto txData = context.getMeteringService()->createStopTxMeterData(transaction.get());
                     return new StopTransaction(std::move(transaction), std::move(txData));
                 } else {
                     return new StopTransaction(std::move(transaction));
@@ -335,6 +351,14 @@ uint16_t ConnectorStatus::getSessionWriteCount() {
     return transaction ? transaction->getTxNr() : 0;
 }
 
+bool ConnectorStatus::isTransactionRunning() {
+    if (!transaction) {
+        return false;
+    }
+
+    return transaction->isRunning();
+}
+
 int ConnectorStatus::getTransactionId() {
     
     if (!transaction) {
@@ -352,17 +376,7 @@ int ConnectorStatus::getTransactionId() {
     }
 }
 
-int ConnectorStatus::getTransactionIdSync() {
-    auto txSync = context.getTransactionStore()->getTransactionSync(connectorId);
-    
-    if (txSync) {
-        return txSync->getTransactionId();
-    } else {
-        return -1;
-    }
-}
-
-std::shared_ptr<Transaction> ConnectorStatus::getTransaction() {
+std::shared_ptr<Transaction>& ConnectorStatus::getTransaction() {
     return transaction;
 }
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index de79c673..5bac9139 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -78,9 +78,10 @@ class ConnectorStatus {
     void endSession(const char *reason = nullptr);
     const char *getSessionIdTag();
     uint16_t getSessionWriteCount();
+    bool isTransactionRunning();
     int getTransactionId();
     int getTransactionIdSync();
-    std::shared_ptr<Transaction> getTransaction();
+    std::shared_ptr<Transaction>& getTransaction();
     void releaseTransaction();
 
     int getAvailability();
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 8f3f1342..82339a89 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -3,6 +3,8 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h>
+#include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
@@ -13,8 +15,8 @@
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
-ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, int connectorId)
-        : context(context), connectorId{connectorId} {
+ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, int connectorId, MeterStore& meterStore)
+        : context(context), connectorId{connectorId}, meterStore{meterStore} {
 
     auto MeterValuesSampledData = declareConfiguration<const char*>(
         "MeterValuesSampledData",
@@ -58,6 +60,17 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
 
 OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
+    Transaction *transaction = nullptr;
+
+    if (context.getConnectorStatus(connectorId) && context.getConnectorStatus(connectorId)->getTransaction()) {
+        transaction = context.getConnectorStatus(connectorId)->getTransaction().get();
+
+        if (!stopTxnData || (stopTxnData->getTxNr() != transaction->getTxNr() && transaction->isRunning())) {
+            //reload (e.g. after power cut during transaction)
+            stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
+        }
+    }
+
     if (*ClockAlignedDataInterval >= 1) {
 
         if (alignedData.size() >= (size_t) *MeterValuesAlignedDataMaxLength) {
@@ -80,13 +93,13 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
                     alignedData.push_back(std::move(alignedMeterValues));
                 }
 
-                if (stopTxnAlignedData.size() + 1 < (size_t) (*StopTxnAlignedDataMaxLength)) {
-                    //ensure that collection keeps one free data slot for final value at StopTransaction
+                if (stopTxnData) {
                     auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SampleClock);
                     if (alignedStopTx) {
-                        stopTxnAlignedData.push_back(std::move(alignedStopTx));
+                        stopTxnData->addTxData(std::move(alignedStopTx));
                     }
                 }
+
             }
             
             OcppTimestamp midnightBase = OcppTimestamp(2010,0,0,0,0,0);
@@ -105,7 +118,6 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
         }
     } else {
         alignedData.clear();
-        stopTxnAlignedData.clear();
     }
 
     if (*MeterValueSampleInterval >= 1) {
@@ -117,26 +129,21 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
             return meterValues;
         }
 
-        auto connector = context.getConnectorStatus(connectorId);
-        if (connector && connector->getTransactionId() != lastTransactionId) {
+        if ((transaction && transaction->isRunning()) != trackTxRunning) {
             //transaction break
 
-    	    //take a transaction-related sample which is aligned to the transaction break
-            if (connector->getTransactionId() >= 0 && lastTransactionId < 0) {
-                auto sampleStartTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionBegin);
-                if (sampleStartTx) {
-                    stopTxnSampledData.push_back(std::move(sampleStartTx));
-                }
-            } else if (connector->getTransactionId() >= 0 && lastTransactionId > 0) {
-                AO_DBG_ERR("Cannot switch txId");
+            trackTxRunning = (transaction && transaction->isRunning());
+
+            std::shared_ptr<Transaction> transaction_sp = nullptr;
+            if (context.getConnectorStatus(connectorId)) {
+                transaction_sp = context.getConnectorStatus(connectorId)->getTransaction();
             }
 
             MeterValues *meterValues = nullptr;
             if (!sampledData.empty()) {
-                meterValues = new MeterValues(std::move(sampledData), connectorId);
+                meterValues = new MeterValues(std::move(sampledData), connectorId, transaction_sp);
                 sampledData.clear();
             }
-            lastTransactionId = connector->getTransactionId();
             lastSampleTime = ao_tick_ms();
             return meterValues;
         }
@@ -147,11 +154,10 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
                 sampledData.push_back(std::move(sampleMeterValues));
             }
 
-            if (stopTxnSampledData.size() + 1 < (size_t) (*StopTxnSampledDataMaxLength)) {
-                //ensure that collection keeps one free data slot for final value at StopTransaction
+            if (stopTxnData) {
                 auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SamplePeriodic);
                 if (sampleStopTx) {
-                    stopTxnSampledData.push_back(std::move(sampleStopTx));
+                    stopTxnData->addTxData(std::move(sampleStopTx));
                 }
             }
             lastSampleTime = ao_tick_ms();
@@ -159,7 +165,6 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
     } else {
         sampledData.clear();
-        stopTxnSampledData.clear();
     }
 
     return nullptr; //successful method completition. Currently there is no reason to send a MeterValues Msg.
@@ -188,7 +193,7 @@ void ConnectorMeterValuesRecorder::setEnergySampler(EnergySampler es){
 }
 
 void ConnectorMeterValuesRecorder::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
-    if (!meterValueSampler->getMeasurand().compare("Energy.Active.Import.Register")) {
+    if (!meterValueSampler->getProperties().getMeasurand().compare("Energy.Active.Import.Register")) {
         energySamplerIndex = samplers.size();
     }
     samplers.push_back(std::move(meterValueSampler));
@@ -203,22 +208,39 @@ std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readTxEnergyMeter(Re
     }
 }
 
-std::vector<std::unique_ptr<MeterValue>> ConnectorMeterValuesRecorder::createStopTxMeterData() {
-    
+void ConnectorMeterValuesRecorder::beginTxMeterData(Transaction *transaction) {
+    if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
+        stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
+    }
+
+    if (stopTxnData) {
+        auto sampleStartTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionBegin);
+        if (sampleStartTx) {
+            stopTxnData->addTxData(std::move(sampleStartTx));
+        }
+    }
+}
+
+std::vector<std::unique_ptr<MeterValue>> ConnectorMeterValuesRecorder::createStopTxMeterData(Transaction *transaction) {
+    if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
+        stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
+    }
+
     //create final StopTxSample
-    if (*MeterValueSampleInterval >= 1) { //... only if sampled Meter Values are activated
+    if (stopTxnData) {
         auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionEnd);
         if (sampleStopTx) {
-            stopTxnSampledData.push_back(std::move(sampleStopTx));
+            stopTxnData->addTxData(std::move(sampleStopTx));
         }
-    }
 
-    //concatenate sampled and aligned meter data; clear all StopTX data in this object
-    decltype(stopTxnSampledData) res {std::move(stopTxnSampledData)};
-    res.insert(res.end(), std::make_move_iterator(stopTxnAlignedData.begin()),
-                          std::make_move_iterator(stopTxnAlignedData.end()));
-    stopTxnSampledData.clear(); //make vectors defined after moving from them
-    stopTxnAlignedData.clear();
+        stopTxnData->finalize();
+
+        auto res = stopTxnData->retrieveStopTxData();
+        stopTxnData = nullptr;
+
+        return res;
+    }
 
-    return res;
+    AO_DBG_ERR("could not create TxData");
+    return std::vector<std::unique_ptr<MeterValue>>{};
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index d2d2d151..f3023b8b 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -10,6 +10,7 @@
 #include <vector>
 
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
+#include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 
 namespace ArduinoOcpp {
@@ -19,17 +20,18 @@ using EnergySampler = std::function<float()>;
 
 class OcppModel;
 class OcppMessage;
+class Transaction;
+class MeterStore;
 
 class ConnectorMeterValuesRecorder {
 private:
     OcppModel& context;
-    
     const int connectorId;
+    MeterStore& meterStore;
     
     std::vector<std::unique_ptr<MeterValue>> sampledData;
     std::vector<std::unique_ptr<MeterValue>> alignedData;
-    std::vector<std::unique_ptr<MeterValue>> stopTxnSampledData;
-    std::vector<std::unique_ptr<MeterValue>> stopTxnAlignedData;
+    std::shared_ptr<TransactionMeterData> stopTxnData;
 
     std::unique_ptr<MeterValueBuilder> sampledDataBuilder;
     std::unique_ptr<MeterValueBuilder> alignedDataBuilder;
@@ -45,6 +47,8 @@ class ConnectorMeterValuesRecorder {
     OcppTimestamp nextAlignedTime;
     float lastPower;
     int lastTransactionId = -1;
+    bool trackTxRunning = false;
+    int trackTxNr = -1;
  
     PowerSampler powerSampler = nullptr;
     EnergySampler energySampler = nullptr;
@@ -59,7 +63,7 @@ class ConnectorMeterValuesRecorder {
     std::shared_ptr<Configuration<int>> MeterValuesAlignedDataMaxLength;
     std::shared_ptr<Configuration<int>> StopTxnAlignedDataMaxLength;
 public:
-    ConnectorMeterValuesRecorder(OcppModel& context, int connectorId);
+    ConnectorMeterValuesRecorder(OcppModel& context, int connectorId, MeterStore& meterStore);
 
     OcppMessage *loop();
 
@@ -73,7 +77,9 @@ class ConnectorMeterValuesRecorder {
 
     OcppMessage *takeTriggeredMeterValues();
 
-    std::vector<std::unique_ptr<MeterValue>> createStopTxMeterData();
+    void beginTxMeterData(Transaction *transaction);
+
+    std::vector<std::unique_ptr<MeterValue>> createStopTxMeterData(Transaction *transaction);
 
 };
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
index 9ff39b81..ee7d66ea 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
@@ -15,9 +15,15 @@
 
 #define MAX_STOPTXDATA_LEN 20
 
-TransactionMeterData::TransactionMeterData(unsigned int connectorId, unsigned int txNr, std::shared_ptr<FilesystemAdapter> filesystem)
-        : connectorId(connectorId), txNr(txNr), filesystem(filesystem) {
+using namespace ArduinoOcpp;
 
+TransactionMeterData::TransactionMeterData(unsigned int connectorId, unsigned int txNr, std::shared_ptr<FilesystemAdapter> filesystem)
+        : connectorId(connectorId), txNr(txNr), filesystem{filesystem} {
+    
+    if (!filesystem) {
+        AO_DBG_DEBUG("volatile mode");
+        (void)0;
+    }
 }
 
 bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
@@ -51,8 +57,14 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
         }
     }
 
-    txData.push_back(std::move(mv));
-    mvCount++;
+    if (txData.size() < MAX_STOPTXDATA_LEN) {
+        txData.push_back(std::move(mv));
+        mvCount++;
+        AO_DBG_DEBUG("added sd");
+    } else {
+        txData.back() = std::move(mv);
+        AO_DBG_DEBUG("updated latest sd");
+    }
     return true;
 }
 
@@ -62,6 +74,7 @@ std::vector<std::unique_ptr<MeterValue>> TransactionMeterData::retrieveStopTxDat
         return decltype(txData) {};
     }
     finalize();
+    AO_DBG_DEBUG("creating sd");
     return std::move(txData);
 }
 
@@ -116,6 +129,14 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
     return true;
 }
 
+MeterStore::MeterStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem {filesystem} {
+
+    if (!filesystem) {
+        AO_DBG_DEBUG("volatile mode");
+        (void)0;
+    }
+}
+
 std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuilder& mvBuilder, unsigned int connectorId, unsigned int txNr) {
     auto cached = std::find_if(txMeterData.begin(), txMeterData.end(),
             [connectorId, txNr] (std::weak_ptr<TransactionMeterData>& txm) {
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
index f6806963..389d2fe4 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
@@ -11,7 +11,7 @@
 #include <vector>
 #include <deque>
 
-using namespace ArduinoOcpp;
+namespace ArduinoOcpp {
 
 class TransactionMeterData {
 private:
@@ -49,6 +49,7 @@ class MeterStore {
     std::vector<std::weak_ptr<TransactionMeterData>> txMeterData;
 
 public:
+    MeterStore() = delete;
     MeterStore(std::shared_ptr<FilesystemAdapter> filesystem);
 
     std::shared_ptr<TransactionMeterData> getTxMeterData(MeterValueBuilder& mvBuilder, unsigned int connectorId, unsigned int txNr);
@@ -56,4 +57,6 @@ class MeterStore {
     bool remove(unsigned int connectorId, unsigned int txNr);
 };
 
+}
+
 #endif
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
index 9c501dd0..ace0471e 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
@@ -67,7 +67,7 @@ void MeterValueBuilder::updateObservedSamplers() {
 
         if (sr != sl + 1) {
             for (size_t i = 0; i < samplers.size(); i++) {
-                if (!strncmp(samplers[i]->getMeasurand().c_str(), selectStr + sl, sr - sl)) {
+                if (!strncmp(samplers[i]->getProperties().getMeasurand().c_str(), selectStr + sl, sr - sl)) {
                     select_mask[i] = true;
                     select_n++;
                 }
@@ -115,9 +115,13 @@ std::unique_ptr<MeterValue> MeterValueBuilder::deserializeSample(const JsonObjec
 
     JsonArray sampledValue = mvJson["sampledValue"];
     for (JsonObject svJson : sampledValue) {  //for each sampled value, search sampler with matching measurand type
-        const char *measurand = svJson["measurand"] | "Invalid";
         for (auto& sampler : samplers) {
-            if (!sampler->getMeasurand().compare(measurand)) {
+            auto& properties = sampler->getProperties();
+            if (!properties.getMeasurand().compare(svJson["measurand"] | "") &&
+                    !properties.getFormat().compare(svJson["format"] | "") &&
+                    !properties.getPhase().compare(svJson["phase"] | "") &&
+                    !properties.getLocation().compare(svJson["location"] | "") &&
+                    !properties.getUnit().compare(svJson["unit"] | "")) {
                 //found correct sampler
                 auto dVal = sampler->deserializeValue(svJson);
                 if (dVal) {
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index bf0c8fb4..55c7ada9 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -3,17 +3,19 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Debug.h>
 
 using namespace ArduinoOcpp;
 
-MeteringService::MeteringService(OcppEngine& context, int numConn)
-      : context(context) {
+MeteringService::MeteringService(OcppEngine& context, int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
+      : context(context), meterStore(filesystem) {
 
     for (int i = 0; i < numConn; i++) {
-        connectors.push_back(std::unique_ptr<ConnectorMeterValuesRecorder>(new ConnectorMeterValuesRecorder(context.getOcppModel(), i)));
+        connectors.push_back(std::unique_ptr<ConnectorMeterValuesRecorder>(new ConnectorMeterValuesRecorder(context.getOcppModel(), i, meterStore)));
     }
 }
 
@@ -81,12 +83,32 @@ std::unique_ptr<OcppOperation> MeteringService::takeTriggeredMeterValues(int con
     return nullptr;
 }
 
-std::vector<std::unique_ptr<MeterValue>> MeteringService::createStopTxMeterData(int connectorId) {
+void MeteringService::beginTxMeterData(Transaction *transaction) {
+    if (!transaction) {
+        AO_DBG_ERR("invalid argument");
+        return;
+    }
+    auto connectorId = transaction->getConnectorId();
+    if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
+        AO_DBG_ERR("connectorId is out of bounds");
+        return;
+    }
+    auto& connector = connectors[connectorId];
+
+    connector->beginTxMeterData(transaction);
+}
+
+std::vector<std::unique_ptr<MeterValue>> MeteringService::createStopTxMeterData(Transaction *transaction) {
+    if (!transaction) {
+        AO_DBG_ERR("invalid argument");
+        return std::vector<std::unique_ptr<MeterValue>>();
+    }
+    auto connectorId = transaction->getConnectorId();
     if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
         return std::vector<std::unique_ptr<MeterValue>>();
     }
     auto& connector = connectors[connectorId];
 
-    return connector->createStopTxMeterData();
+    return connector->createStopTxMeterData(transaction);
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index bad4ca29..d5a5bd89 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -11,6 +11,7 @@
 
 #include <ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
+#include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
 
 namespace ArduinoOcpp {
 
@@ -19,14 +20,16 @@ using EnergySampler = std::function<float()>; //in Watt-hours (Wh)
 
 class OcppEngine;
 class OcppOperation;
+class FilesystemAdapter;
 
 class MeteringService {
 private:
     OcppEngine& context;
+    MeterStore meterStore;
 
     std::vector<std::unique_ptr<ConnectorMeterValuesRecorder>> connectors;
 public:
-    MeteringService(OcppEngine& context, int numConnectors);
+    MeteringService(OcppEngine& context, int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
     void loop();
 
@@ -40,7 +43,9 @@ class MeteringService {
 
     std::unique_ptr<OcppOperation> takeTriggeredMeterValues(int connectorId); //snapshot of all meters now
 
-    std::vector<std::unique_ptr<MeterValue>> createStopTxMeterData(int connectorId);
+    void beginTxMeterData(Transaction *transaction);
+
+    std::vector<std::unique_ptr<MeterValue>> createStopTxMeterData(Transaction *transaction);
 
     int getNumConnectors() {return connectors.size();}
 };
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
index 310a34a7..6e5f1867 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -41,12 +41,6 @@ class SampledValueProperties {
     std::string location;
     std::string unit;
 
-    const std::string& getFormat() const {return format;}
-    const std::string& getPhase() const {return phase;}
-    const std::string& getLocation() const {return location;}
-    const std::string& getUnit() const {return unit;}
-    friend class SampledValue; //will be able to retreive these parameters
-
 public:
     SampledValueProperties() { }
     SampledValueProperties(const SampledValueProperties& other) :
@@ -58,11 +52,15 @@ class SampledValueProperties {
     ~SampledValueProperties() = default;
 
     void setFormat(const char *format) {this->format = format;}
+    const std::string& getFormat() const {return format;}
     void setMeasurand(const char *measurand) {this->measurand = measurand;}
     const std::string& getMeasurand() const {return measurand;}
     void setPhase(const char *phase) {this->phase = phase;}
+    const std::string& getPhase() const {return phase;}
     void setLocation(const char *location) {this->location = location;}
+    const std::string& getLocation() const {return location;}
     void setUnit(const char *unit) {this->unit = unit;}
+    const std::string& getUnit() const {return unit;}
 };
 
 enum class ReadingContext {
@@ -122,7 +120,7 @@ class SampledValueSampler {
     virtual ~SampledValueSampler() = default;
     virtual std::unique_ptr<SampledValue> takeValue(ReadingContext context) = 0;
     virtual std::unique_ptr<SampledValue> deserializeValue(JsonObject svJson) = 0;
-    const std::string& getMeasurand() {return properties.getMeasurand();};
+    const SampledValueProperties& getProperties() {return properties;};
 };
 
 template <class T, class DeSerializer>
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index 1c347bac..487c9bde 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -131,34 +131,15 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction() {
     return transaction;
 }
 
-std::shared_ptr<Transaction> ConnectorTransactionStore::getActiveTransaction() {
-    
-    if (!transactions.empty()) {
-        if (auto tx = transactions.back().lock()) {
-            if (tx->isActive() || tx->isRunning()) {
-                return tx;
-            }
-        }
+std::shared_ptr<Transaction> ConnectorTransactionStore::getLatestTransaction() {
+    if (!txEnd || *txEnd < 0) {
+        AO_DBG_ERR("memory corruption");
+        return nullptr;
     }
 
-    AO_DBG_DEBUG("Make new Tx");
-
-    auto tx = createTransaction();
-
-    return tx;
-}
-
-std::shared_ptr<Transaction> ConnectorTransactionStore::getTransactionSync() {
-    
-    if (!transactions.empty()) {
-        if (auto tx = transactions.front().lock()) {
-            if (tx->isRunning()) {
-                return tx;
-            }
-        }
-    }
+    unsigned int latest = ((unsigned int) *txEnd + MAX_TX_CNT - 1) % MAX_TX_CNT;
 
-    return nullptr;
+    return getTransaction(latest);
 }
 
 bool ConnectorTransactionStore::commit(Transaction *transaction) {
@@ -198,20 +179,12 @@ TransactionStore::TransactionStore(uint nConnectors, std::shared_ptr<FilesystemA
     }
 }
 
-std::shared_ptr<Transaction> TransactionStore::getActiveTransaction(uint connectorId) {
-    if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
-        return nullptr;
-    }
-    return connectors[connectorId]->getActiveTransaction();
-}
-
-std::shared_ptr<Transaction> TransactionStore::getTransactionSync(uint connectorId) {
+std::shared_ptr<Transaction> TransactionStore::getLatestTransaction(uint connectorId) {
     if (connectorId >= connectors.size()) {
         AO_DBG_ERR("Invalid connectorId");
         return nullptr;
     }
-    return connectors[connectorId]->getTransactionSync();
+    return connectors[connectorId]->getLatestTransaction();
 }
 
 bool TransactionStore::commit(Transaction *transaction) {
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
index 26b62f1e..98004c9d 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
@@ -27,8 +27,7 @@ class ConnectorTransactionStore {
 public:
     ConnectorTransactionStore(TransactionStore& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
     
-    std::shared_ptr<Transaction> getActiveTransaction();
-    std::shared_ptr<Transaction> getTransactionSync();
+    std::shared_ptr<Transaction> getLatestTransaction();
     bool commit(Transaction *transaction);
 
     std::shared_ptr<Transaction> getTransaction(unsigned int txNr);
@@ -41,8 +40,7 @@ class TransactionStore {
 public:
     TransactionStore(uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
-    std::shared_ptr<Transaction> getActiveTransaction(uint connectorId);
-    std::shared_ptr<Transaction> getTransactionSync(uint connectorId); //fron element of the tx queue; tx which is being executed at the server now
+    std::shared_ptr<Transaction> getLatestTransaction(uint connectorId);
     bool commit(Transaction *transaction);
 
     std::shared_ptr<Transaction> getTransaction(unsigned int connectorId, unsigned int txNr);

From a7df1b305d7edaaa7ce0d38acf8f1102dcd64b4c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 31 Oct 2022 13:44:44 +0000
Subject: [PATCH 113/549] add missing includes for docker

---
 src/ArduinoOcpp/Core/OcppSocket.h                      | 1 +
 src/ArduinoOcpp/Core/OcppTime.cpp                      | 5 +++--
 src/ArduinoOcpp/Core/OcppTime.h                        | 2 ++
 src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h | 1 +
 4 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppSocket.h b/src/ArduinoOcpp/Core/OcppSocket.h
index c9db90e1..bb8c534a 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.h
+++ b/src/ArduinoOcpp/Core/OcppSocket.h
@@ -7,6 +7,7 @@
 
 #include <functional>
 #include <memory>
+#include <string>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Core/OcppTime.cpp b/src/ArduinoOcpp/Core/OcppTime.cpp
index d44dc4f8..9a805e1a 100644
--- a/src/ArduinoOcpp/Core/OcppTime.cpp
+++ b/src/ArduinoOcpp/Core/OcppTime.cpp
@@ -5,6 +5,7 @@
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <ArduinoOcpp/Platform.h>
 #include <string.h>
+#include <ctype.h>	
 
 namespace ArduinoOcpp {
 
@@ -13,14 +14,14 @@ const OcppTimestamp MAX_TIME = OcppTimestamp(2037, 0, 0, 0, 0, 0);
 
 namespace Clocks {
 
-ulong lastClockReading = 0;
+unsigned long lastClockReading = 0;
 otime_t lastClockValue = 0;
 
 /*
  * Basic clock implementation. Works if ao_tick_ms() is exact enough for you and if device doesn't go in sleep mode. 
  */
 OcppClock DEFAULT_CLOCK = [] () {
-    ulong tReading = (ao_tick_ms() - lastClockReading) / 1000UL;
+    unsigned long tReading = (ao_tick_ms() - lastClockReading) / 1000UL;
     if (tReading > 0) {
         lastClockValue += tReading;
         lastClockReading += tReading * 1000UL;
diff --git a/src/ArduinoOcpp/Core/OcppTime.h b/src/ArduinoOcpp/Core/OcppTime.h
index b9b2cb0a..2d18dedf 100644
--- a/src/ArduinoOcpp/Core/OcppTime.h
+++ b/src/ArduinoOcpp/Core/OcppTime.h
@@ -6,6 +6,8 @@
 #define OCPPTIME_H
 
 #include <functional>
+#include <stdint.h>
+#include <stddef.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
index 72f9e37b..bdc7de55 100644
--- a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
+++ b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
@@ -9,6 +9,7 @@
 #include <memory>
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h>
+#include <string>
 
 namespace ArduinoOcpp {
 

From 252c0cf484f13a476953594e7d163f5ebb4185d9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 31 Oct 2022 21:39:48 +0100
Subject: [PATCH 114/549] restore tx MVs after power loss

---
 src/ArduinoOcpp/MessagesV16/StopTransaction.cpp             | 6 ++++++
 .../Tasks/Metering/ConnectorMeterValuesRecorder.cpp         | 5 ++---
 .../Tasks/Metering/ConnectorMeterValuesRecorder.h           | 2 --
 src/ArduinoOcpp/Tasks/Metering/MeterStore.h                 | 1 +
 4 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 18cbc884..3dc5f36d 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -115,6 +115,12 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
+    if (ocppModel->getMeteringService()) {
+        auto mSerivce = ocppModel->getMeteringService();
+
+        transactionData = mSerivce->createStopTxMeterData(transaction.get());
+    }
+
     return true;
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 82339a89..7d574c8b 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -65,7 +65,8 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
     if (context.getConnectorStatus(connectorId) && context.getConnectorStatus(connectorId)->getTransaction()) {
         transaction = context.getConnectorStatus(connectorId)->getTransaction().get();
 
-        if (!stopTxnData || (stopTxnData->getTxNr() != transaction->getTxNr() && transaction->isRunning())) {
+        if (transaction->isRunning() && (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr())) {
+            AO_DBG_WARN("reload stopTxnData");
             //reload (e.g. after power cut during transaction)
             stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
         }
@@ -233,8 +234,6 @@ std::vector<std::unique_ptr<MeterValue>> ConnectorMeterValuesRecorder::createSto
             stopTxnData->addTxData(std::move(sampleStopTx));
         }
 
-        stopTxnData->finalize();
-
         auto res = stopTxnData->retrieveStopTxData();
         stopTxnData = nullptr;
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index f3023b8b..a472e9b4 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -45,8 +45,6 @@ class ConnectorMeterValuesRecorder {
 
     ulong lastSampleTime = 0; //0 means not charging right now
     OcppTimestamp nextAlignedTime;
-    float lastPower;
-    int lastTransactionId = -1;
     bool trackTxRunning = false;
     int trackTxNr = -1;
  
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
index 389d2fe4..14101aaa 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
@@ -50,6 +50,7 @@ class MeterStore {
 
 public:
     MeterStore() = delete;
+    MeterStore(MeterStore&) = delete;
     MeterStore(std::shared_ptr<FilesystemAdapter> filesystem);
 
     std::shared_ptr<TransactionMeterData> getTxMeterData(MeterValueBuilder& mvBuilder, unsigned int connectorId, unsigned int txNr);

From a235f7c1d52295ad97b01b0e638e01f5be4cbe05 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 31 Oct 2022 22:35:27 +0100
Subject: [PATCH 115/549] fix duplicate Transaction.End after reboot

---
 .../MessagesV16/StopTransaction.cpp           |  8 ++---
 .../ChargePointStatus/ConnectorStatus.cpp     | 14 ++++++---
 .../Metering/ConnectorMeterValuesRecorder.cpp | 31 +++++++++++--------
 .../Metering/ConnectorMeterValuesRecorder.h   |  4 ++-
 .../Tasks/Metering/MeteringService.cpp        | 23 +++++++++++---
 .../Tasks/Metering/MeteringService.h          |  4 ++-
 6 files changed, 56 insertions(+), 28 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 3dc5f36d..915d291d 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -115,10 +115,10 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
-    if (ocppModel->getMeteringService()) {
-        auto mSerivce = ocppModel->getMeteringService();
-
-        transactionData = mSerivce->createStopTxMeterData(transaction.get());
+    if (auto mSerivce = ocppModel->getMeteringService()) {
+        if (auto txData = mSerivce->getStopTxMeterData(transaction.get())) {
+            transactionData = txData->retrieveStopTxData();
+        }
     }
 
     return true;
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 7f9d6ce4..2fa5a69b 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -233,6 +233,8 @@ OcppMessage *ConnectorStatus::loop() {
 
             if (txEnable == TxEnableState::Inactive) {
                 //stop transaction
+
+                AO_DBG_INFO("Session mngt: trigger StopTransaction");
                 
                 auto meteringService = context.getMeteringService();
                 if (transaction->getMeterStop() < 0 && meteringService) {
@@ -250,15 +252,17 @@ OcppMessage *ConnectorStatus::loop() {
 
                 transaction->commit();
 
-                AO_DBG_INFO("Session mngt: trigger StopTransaction");
+                std::shared_ptr<TransactionMeterData> stopTxData;
 
-                if (context.getMeteringService()) {
-                    auto txData = context.getMeteringService()->createStopTxMeterData(transaction.get());
-                    return new StopTransaction(std::move(transaction), std::move(txData));
+                if (meteringService) {
+                    stopTxData = meteringService->endTxMeterData(transaction.get());
+                }
+
+                if (stopTxData) {
+                    return new StopTransaction(std::move(transaction), stopTxData->retrieveStopTxData());
                 } else {
                     return new StopTransaction(std::move(transaction));
                 }
-                
             }
         }
     } //end transaction-related operations
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 7d574c8b..52f3717e 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -215,31 +215,36 @@ void ConnectorMeterValuesRecorder::beginTxMeterData(Transaction *transaction) {
     }
 
     if (stopTxnData) {
-        auto sampleStartTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionBegin);
-        if (sampleStartTx) {
-            stopTxnData->addTxData(std::move(sampleStartTx));
+        auto sampleTxBegin = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionBegin);
+        if (sampleTxBegin) {
+            stopTxnData->addTxData(std::move(sampleTxBegin));
         }
     }
 }
 
-std::vector<std::unique_ptr<MeterValue>> ConnectorMeterValuesRecorder::createStopTxMeterData(Transaction *transaction) {
+std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::endTxMeterData(Transaction *transaction) {
     if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
         stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
     }
 
-    //create final StopTxSample
     if (stopTxnData) {
-        auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionEnd);
-        if (sampleStopTx) {
-            stopTxnData->addTxData(std::move(sampleStopTx));
+        auto sampleTxEnd = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionEnd);
+        if (sampleTxEnd) {
+            stopTxnData->addTxData(std::move(sampleTxEnd));
         }
+    }
+
+    return std::move(stopTxnData);
+}
 
-        auto res = stopTxnData->retrieveStopTxData();
-        stopTxnData = nullptr;
+std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::getStopTxMeterData(Transaction *transaction) {
 
-        return res;
+    auto txData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
+
+    if (!txData) {
+        AO_DBG_ERR("could not create TxData");
+        return nullptr;
     }
 
-    AO_DBG_ERR("could not create TxData");
-    return std::vector<std::unique_ptr<MeterValue>>{};
+    return txData;
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index a472e9b4..bc31ea9d 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -77,7 +77,9 @@ class ConnectorMeterValuesRecorder {
 
     void beginTxMeterData(Transaction *transaction);
 
-    std::vector<std::unique_ptr<MeterValue>> createStopTxMeterData(Transaction *transaction);
+    std::shared_ptr<TransactionMeterData> endTxMeterData(Transaction *transaction);
+
+    std::shared_ptr<TransactionMeterData> getStopTxMeterData(Transaction *transaction);
 
 };
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index 55c7ada9..69a1f4b3 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -98,17 +98,32 @@ void MeteringService::beginTxMeterData(Transaction *transaction) {
     connector->beginTxMeterData(transaction);
 }
 
-std::vector<std::unique_ptr<MeterValue>> MeteringService::createStopTxMeterData(Transaction *transaction) {
+std::shared_ptr<TransactionMeterData> MeteringService::endTxMeterData(Transaction *transaction) {
     if (!transaction) {
         AO_DBG_ERR("invalid argument");
-        return std::vector<std::unique_ptr<MeterValue>>();
+        return nullptr;
     }
     auto connectorId = transaction->getConnectorId();
     if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
-        return std::vector<std::unique_ptr<MeterValue>>();
+        return nullptr;
+    }
+    auto& connector = connectors[connectorId];
+
+    return connector->endTxMeterData(transaction);
+}
+
+std::shared_ptr<TransactionMeterData> MeteringService::getStopTxMeterData(Transaction *transaction) {
+    if (!transaction) {
+        AO_DBG_ERR("invalid argument");
+        return nullptr;
+    }
+    auto connectorId = transaction->getConnectorId();
+    if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
+        AO_DBG_ERR("connectorId is out of bounds");
+        return nullptr;
     }
     auto& connector = connectors[connectorId];
 
-    return connector->createStopTxMeterData(transaction);
+    return connector->getStopTxMeterData(transaction);
 }
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index d5a5bd89..1c5c42e2 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -45,7 +45,9 @@ class MeteringService {
 
     void beginTxMeterData(Transaction *transaction);
 
-    std::vector<std::unique_ptr<MeterValue>> createStopTxMeterData(Transaction *transaction);
+    std::shared_ptr<TransactionMeterData> endTxMeterData(Transaction *transaction); //use return value to keep data in cache
+
+    std::shared_ptr<TransactionMeterData> getStopTxMeterData(Transaction *transaction); //prefer endTxMeterData when possible
 
     int getNumConnectors() {return connectors.size();}
 };

From b07b765f441d58cd195c9905eddc6021e8cdf3be Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 1 Nov 2022 18:12:27 +0100
Subject: [PATCH 116/549] remove obsolete tx data; keep short history

---
 src/ArduinoOcpp.cpp                           |  2 -
 src/ArduinoOcpp/Core/OperationStore.cpp       | 39 +++++++-
 src/ArduinoOcpp/Core/OperationStore.h         |  3 +
 src/ArduinoOcpp/Core/OperationsQueue.cpp      |  6 +-
 .../MessagesV16/StopTransaction.cpp           | 71 ++++++++++++++
 src/ArduinoOcpp/MessagesV16/StopTransaction.h | 16 ++--
 .../ChargePointStatus/ConnectorStatus.cpp     | 16 +++-
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  1 -
 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp | 48 +++++-----
 src/ArduinoOcpp/Tasks/Metering/MeterStore.h   |  1 -
 .../Tasks/Metering/MeteringService.cpp        | 10 +-
 .../Tasks/Metering/MeteringService.h          |  2 +
 .../Tasks/Transactions/Transaction.h          | 14 +--
 .../Tasks/Transactions/TransactionStore.cpp   | 94 +++++++++++++++++--
 .../Tasks/Transactions/TransactionStore.h     | 14 +++
 15 files changed, 273 insertions(+), 64 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 8464dde3..f68fed42 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -527,8 +527,6 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
 
     connector->endSession("Local");
 
-    connector->releaseTransaction();
-
     const char *idTag = transaction->getIdTag();
     if (idTag) {
         transaction->setStopIdTag(idTag);
diff --git a/src/ArduinoOcpp/Core/OperationStore.cpp b/src/ArduinoOcpp/Core/OperationStore.cpp
index 971cff78..1f26d12f 100644
--- a/src/ArduinoOcpp/Core/OperationStore.cpp
+++ b/src/ArduinoOcpp/Core/OperationStore.cpp
@@ -14,7 +14,7 @@
 
 #define AO_OPSTORE_FN AO_FILENAME_PREFIX "/opstore.cnf"
 
-#define AO_MAX_OPNR 10000
+#define AO_OPHISTORY_SIZE 3
 
 using namespace ArduinoOcpp;
 
@@ -115,7 +115,7 @@ OperationStore::OperationStore(std::shared_ptr<FilesystemAdapter> filesystem) :
             if (ret < 0 || ret >= MAX_PATH_SIZE) {
                 AO_DBG_ERR("fn error: %i", ret);
                 misses++;
-                i++;
+                i = (i + 1) % AO_MAX_OPNR;
                 continue;
             }
 
@@ -123,14 +123,14 @@ OperationStore::OperationStore(std::shared_ptr<FilesystemAdapter> filesystem) :
             if (filesystem->stat(fn, &msize) != 0) {
                 AO_DBG_DEBUG("operation %u does not exist", i);
                 misses++;
-                i++;
+                i = (i + 1) % AO_MAX_OPNR;
                 continue;
             }
 
             //file exists
             misses = 0;
+            i = (i + 1) % AO_MAX_OPNR;
             opEnd = i;
-            i++;
         }
     }
 }
@@ -154,7 +154,7 @@ void OperationStore::advanceOpNr(unsigned int oldOpNr) {
     }
 
     if (oldOpNr != (unsigned int) *opBegin) {
-        if (oldOpNr - (unsigned int) *opBegin < 100) {
+        if ((oldOpNr + AO_MAX_OPNR - (unsigned int) *opBegin) % AO_MAX_OPNR < 100) {
             AO_DBG_ERR("synchronization failure - try to fix");
             (void)0;
         } else {
@@ -165,6 +165,35 @@ void OperationStore::advanceOpNr(unsigned int oldOpNr) {
 
     unsigned int opNr = (oldOpNr + 1) % AO_MAX_OPNR;
 
+    //delete range [*opBegin ... opNr)
+
+    unsigned int rangeSize = (opNr + AO_MAX_OPNR - (unsigned int) *opBegin) % AO_MAX_OPNR;
+
+    AO_DBG_DEBUG("delete %u operations", rangeSize);
+
+    for (unsigned int i = 0; i < rangeSize; i++) {
+        unsigned int op = ((unsigned int) *opBegin + i + AO_MAX_OPNR - AO_OPHISTORY_SIZE) % AO_MAX_OPNR;
+
+        char fn [MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", op);
+        if (ret < 0 || ret >= MAX_PATH_SIZE) {
+            AO_DBG_ERR("fn error: %i", ret);
+            break;
+        }
+
+        size_t msize;
+        if (filesystem->stat(fn, &msize) != 0) {
+            AO_DBG_DEBUG("operation %u does not exist", i);
+            continue;
+        }
+
+        bool success = filesystem->remove(fn);
+        if (!success) {
+            AO_DBG_ERR("error deleting %s", fn);
+            (void)0;
+        }
+    }
+
     AO_DBG_DEBUG("advance opBegin: %u", opNr);
     *opBegin = opNr;
     configuration_save();
diff --git a/src/ArduinoOcpp/Core/OperationStore.h b/src/ArduinoOcpp/Core/OperationStore.h
index 0fd6cd3d..3b7e884d 100644
--- a/src/ArduinoOcpp/Core/OperationStore.h
+++ b/src/ArduinoOcpp/Core/OperationStore.h
@@ -9,6 +9,8 @@
 #include <deque>
 #include <ArduinoJson.h>
 
+#define AO_MAX_OPNR 10000
+
 namespace ArduinoOcpp {
 
 class OperationStore;
@@ -60,6 +62,7 @@ class OperationStore {
     void advanceOpNr(unsigned int oldOpNr);
 
     unsigned int getOpBegin();
+    unsigned int getOpEnd() {return opEnd;}
 };
 
 }
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index b25ff625..a26878ee 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -67,12 +67,14 @@ void OperationsQueue::pop_front() {
         std::unique_ptr<OcppOperation> fetched;
 
         bool exists = false;
-        for (size_t misses = 0; misses < 3; misses++) {
+        unsigned int range = (opStore.getOpEnd() + AO_MAX_OPNR - nextOpNr) % AO_MAX_OPNR;
+        for (size_t i = 0; i < range; i++) {
             exists = storageHandler->restore(nextOpNr);
             if (exists) {
                 break;
             }
             nextOpNr++;
+            nextOpNr %= AO_MAX_OPNR;
         }
 
         if (exists) {
@@ -138,7 +140,7 @@ void OperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppOperation>&
         pop_front();
     }
 
-    std::remove_if(tailCache.begin(), tailCache.end(), pred);
+    tailCache.erase(std::remove_if(tailCache.begin(), tailCache.end(), pred), tailCache.end());
 }
 
 std::deque<std::unique_ptr<OcppOperation>>::iterator OperationsQueue::begin_tail() {
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 915d291d..9355d8b9 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -15,6 +15,8 @@
 using ArduinoOcpp::Ocpp16::StopTransaction;
 using ArduinoOcpp::TransactionRPC;
 
+#define AO_TXHISTORY_SIZE 10
+
 StopTransaction::StopTransaction(std::shared_ptr<Transaction> transaction)
         : transaction(transaction) {
 
@@ -184,9 +186,25 @@ void StopTransaction::processConf(JsonObject payload) {
         transaction->commit();
     }
 
+    cleanTxStore();
+
     AO_DBG_INFO("Request has been accepted!");
 }
 
+bool StopTransaction::processErr(const char *code, const char *description, JsonObject details) {
+
+    if (transaction) {
+        transaction->getStopRpcSync().confirm(); //no retry behavior for now; consider data "arrived" at server
+        transaction->commit();
+    }
+
+    cleanTxStore();
+
+    AO_DBG_ERR("Server error, data loss!");
+
+    return false;
+}
+
 TransactionRPC *StopTransaction::getTransactionSync() {
     return transaction ? &transaction->getStopRpcSync() : nullptr;
 }
@@ -206,3 +224,56 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createConf(){
 
     return doc;
 }
+
+bool StopTransaction::cleanTxStore() {
+    if (!transaction || !ocppModel) {
+        //doesn't apply
+        return true;
+    }
+
+    auto txStore = ocppModel->getTransactionStore();
+    if (!txStore || txStore->getTxBegin(transaction->getConnectorId()) < 0) {
+        AO_DBG_ERR("invalid state");
+        return false;
+    }
+
+    unsigned int txBegin = (unsigned int) txStore->getTxBegin(transaction->getConnectorId());
+    unsigned int txRangeEnd = (transaction->getTxNr() + MAX_TX_CNT - AO_TXHISTORY_SIZE) % MAX_TX_CNT;
+
+    //to be deleted: [txBegin ... txRangeEnd)
+
+    if ((transaction->getTxNr() + MAX_TX_CNT - txBegin) % MAX_TX_CNT <= 
+            (transaction->getTxNr() + MAX_TX_CNT - txRangeEnd) % MAX_TX_CNT) {
+        //txBegin is after txRangeEnd => nothing to delete
+        AO_DBG_DEBUG("already clean");
+        return true;
+    }
+
+    unsigned int rangeSize = (txRangeEnd + MAX_TX_CNT - txBegin) % MAX_TX_CNT;
+    AO_DBG_DEBUG("deleting %u entries from %u to %u", rangeSize, txBegin, txRangeEnd);
+    if (rangeSize >= 50) {
+        AO_DBG_ERR("cannot clean more than 50 entries at once - clean only the first 50");
+        rangeSize = 50;
+        txRangeEnd = (txBegin + 50) % MAX_TX_CNT;
+    }
+
+    bool success = true;
+
+    if (auto mService = ocppModel->getMeteringService()) {
+        for (unsigned int i = 0; i < rangeSize; i++) {
+            unsigned int tx = (txBegin + i) % MAX_TX_CNT;
+
+            success &= mService->removeTxMeterData(transaction->getConnectorId(), tx);
+        }
+    }
+
+    for (unsigned int i = 0; i < rangeSize; i++) {
+        unsigned int tx = (txBegin + i) % MAX_TX_CNT;
+
+        success &= txStore->remove(transaction->getConnectorId(), tx);
+    }
+
+    txStore->updateTxBegin(transaction->getConnectorId(), txRangeEnd);
+
+    return success;
+}
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index 0b4b0467..8ed365b8 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -24,6 +24,8 @@ class StopTransaction : public OcppMessage {
 private:
     std::shared_ptr<Transaction> transaction;
     std::vector<std::unique_ptr<MeterValue>> transactionData;
+
+    bool cleanTxStore();
 public:
 
     StopTransaction(std::shared_ptr<Transaction> transaction);
@@ -32,24 +34,24 @@ class StopTransaction : public OcppMessage {
     
     StopTransaction(); //for debugging only. Make this for the server pendant
 
-    const char* getOcppOperationType();
+    const char* getOcppOperationType() override;
 
-    void initiate();
+    void initiate() override;
     bool initiate(StoredOperationHandler *opStore) override;
 
     bool restore(StoredOperationHandler *opStore) override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
-    bool processErr(const char *code, const char *description, JsonObject details) { return false;}
+    bool processErr(const char *code, const char *description, JsonObject details) override;
 
     TransactionRPC *getTransactionSync() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 2fa5a69b..816ebad8 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -150,7 +150,17 @@ OcppMessage *ConnectorStatus::loop() {
     }
 
     if (transaction && (transaction->isAborted() || transaction->isCompleted())) {
-        AO_DBG_DEBUG("collect obsolete transaction");
+        if (transaction->isAborted()) {
+            //If the transaction is aborted (invalidated before started), delete all artifacts from flash
+            //This is an optimization. The memory management will attempt to remove those files again later
+            AO_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
+            if (auto mService = context.getMeteringService()) {
+                mService->removeTxMeterData(connectorId, transaction->getTxNr());
+            }
+
+            context.getTransactionStore()->remove(connectorId, transaction->getTxNr());
+        }
+
         transaction = nullptr;
     }
 
@@ -384,10 +394,6 @@ std::shared_ptr<Transaction>& ConnectorStatus::getTransaction() {
     return transaction;
 }
 
-void ConnectorStatus::releaseTransaction() {
-    transaction = nullptr;
-}
-
 int ConnectorStatus::getAvailability() {
     return *availability;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 5bac9139..60dd57b4 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -82,7 +82,6 @@ class ConnectorStatus {
     int getTransactionId();
     int getTransactionIdSync();
     std::shared_ptr<Transaction>& getTransaction();
-    void releaseTransaction();
 
     int getAvailability();
     void setAvailability(bool available);
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
index ee7d66ea..e6a81b0f 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
@@ -155,10 +155,11 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
 
     //clean outdated pointers before creating new object
 
-    std::remove_if(txMeterData.begin(), txMeterData.end(),
-            [connectorId, txNr] (std::weak_ptr<TransactionMeterData>& txm) {
+    txMeterData.erase(std::remove_if(txMeterData.begin(), txMeterData.end(),
+            [] (std::weak_ptr<TransactionMeterData>& txm) {
                 return txm.expired();
-            });
+            }),
+            txMeterData.end());
 
     //create new object and cache weak pointer
 
@@ -192,7 +193,7 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
 
 bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
 
-    int mvCount = -1;
+    unsigned int mvCount = 0;
 
     auto cached = std::find_if(txMeterData.begin(), txMeterData.end(),
             [connectorId, txNr] (std::weak_ptr<TransactionMeterData>& txm) {
@@ -213,19 +214,7 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
     bool success = true;
 
     if (filesystem) {
-        if (mvCount > 0) {
-            for (int i = 0; i < mvCount; i++) { //search until region without txs found
-            
-                char fn [MAX_PATH_SIZE] = {'\0'};
-                auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%d.jsn", connectorId, txNr, i);
-                if (ret < 0 || ret >= MAX_PATH_SIZE) {
-                    AO_DBG_ERR("fn error: %i", ret);
-                    return false; //all files have same length
-                }
-
-                success &= filesystem->remove(fn);
-            }
-        } else {
+        if (mvCount == 0) {
             const uint MISSES_LIMIT = 3;
             uint misses = 0;
             unsigned int i = 0;
@@ -246,20 +235,35 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
                     continue;
                 }
 
-                success &= filesystem->remove(fn);
-
                 i++;
+                mvCount = i;
                 misses = 0;
             }
         }
+
+        AO_DBG_DEBUG("remove %u mvs for txNr %u", mvCount, txNr);
+
+        for (unsigned int i = 0; i < mvCount; i++) {
+            unsigned int sd = mvCount - 1U - i;
+        
+            char fn [MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, sd);
+            if (ret < 0 || ret >= MAX_PATH_SIZE) {
+                AO_DBG_ERR("fn error: %i", ret);
+                return false;
+            }
+
+            success &= filesystem->remove(fn);
+        }
     }
 
     //clean outdated pointers
 
-    std::remove_if(txMeterData.begin(), txMeterData.end(),
-            [connectorId, txNr] (std::weak_ptr<TransactionMeterData>& txm) {
+    txMeterData.erase(std::remove_if(txMeterData.begin(), txMeterData.end(),
+            [] (std::weak_ptr<TransactionMeterData>& txm) {
                 return txm.expired();
-            });
+            }),
+            txMeterData.end());
 
     if (success) {
         AO_DBG_DEBUG("Removed meter values for cId %u, txNr %u", connectorId, txNr);
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
index 14101aaa..9c27d978 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
@@ -33,7 +33,6 @@ class TransactionMeterData {
     std::vector<std::unique_ptr<MeterValue>> retrieveStopTxData(); //will invalidate internal cache
 
     bool restore(MeterValueBuilder& mvBuilder); //load record from memory; true if record found, false if nothing loaded
-    bool remove();
 
     unsigned int getConnectorId() {return connectorId;}
     unsigned int getTxNr() {return txNr;}
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index 69a1f4b3..1bc2acb8 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -89,7 +89,7 @@ void MeteringService::beginTxMeterData(Transaction *transaction) {
         return;
     }
     auto connectorId = transaction->getConnectorId();
-    if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
+    if (connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
         return;
     }
@@ -104,7 +104,7 @@ std::shared_ptr<TransactionMeterData> MeteringService::endTxMeterData(Transactio
         return nullptr;
     }
     auto connectorId = transaction->getConnectorId();
-    if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
+    if (connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
@@ -119,7 +119,7 @@ std::shared_ptr<TransactionMeterData> MeteringService::getStopTxMeterData(Transa
         return nullptr;
     }
     auto connectorId = transaction->getConnectorId();
-    if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
+    if (connectorId >= connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
@@ -127,3 +127,7 @@ std::shared_ptr<TransactionMeterData> MeteringService::getStopTxMeterData(Transa
 
     return connector->getStopTxMeterData(transaction);
 }
+
+bool MeteringService::removeTxMeterData(unsigned int connectorId, unsigned int txNr) {
+    return meterStore.remove(connectorId, txNr);
+}
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index 1c5c42e2..58390aea 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -49,6 +49,8 @@ class MeteringService {
 
     std::shared_ptr<TransactionMeterData> getStopTxMeterData(Transaction *transaction); //prefer endTxMeterData when possible
 
+    bool removeTxMeterData(unsigned int connectorId, unsigned int txNr);
+
     int getNumConnectors() {return connectors.size();}
 };
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index 522dd35d..4f861b42 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -118,10 +118,10 @@ class Transaction {
     TransactionStart start;
     TransactionStop stop;
 
-    int connectorId = -1;
-    uint txNr = 0; //only valid if session.connectorId is >= 0
+    unsigned int connectorId = 0;
+    unsigned int txNr = 0; //only valid if session.connectorId is >= 0
 public:
-    Transaction(ConnectorTransactionStore& context, uint connectorId, uint txNr) : 
+    Transaction(ConnectorTransactionStore& context, unsigned int connectorId, unsigned int txNr) : 
                 context(context), 
                 start(context),
                 stop(context),
@@ -131,10 +131,10 @@ class Transaction {
     bool serializeSessionState(DynamicJsonDocument& out);
     bool deserializeSessionState(JsonObject in);
 
-    int getConnectorId() {return connectorId;}
-    void setConnectorId(uint connectorId) {this->connectorId = connectorId;}
-    uint getTxNr() {return txNr;} //only valid if getConnectorId() >= 0
-    void setTxNr(uint txNr) {this->txNr = txNr;}
+    unsigned int getConnectorId() {return connectorId;}
+    void setConnectorId(unsigned int connectorId) {this->connectorId = connectorId;}
+    unsigned int getTxNr() {return txNr;} //only valid if getConnectorId() >= 0
+    void setTxNr(unsigned int txNr) {this->txNr = txNr;}
 
     TransactionRPC& getStartRpcSync() {return start.rpc;}
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index 487c9bde..ba2d89eb 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -20,8 +20,6 @@ using namespace ArduinoOcpp;
 
 #define AO_TXSTORE_META_FN AO_FILENAME_PREFIX "/txstore.jsn"
 
-#define MAX_TX_CNT 100000U
-
 ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context),
         connectorId(connectorId),
@@ -33,6 +31,12 @@ ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context,
         (void)0;
     }
     txEnd = declareConfiguration<int>(key, 0, AO_TXSTORE_META_FN, false, false, true, false);
+
+    if (snprintf(key, 30, "AO_txBegin_%u", connectorId) < 0) {
+        AO_DBG_ERR("Invalid key");
+        (void)0;
+    }
+    txBegin = declareConfiguration<int>(key, 0, AO_TXSTORE_META_FN, false, false, true, false);
 }
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned int txNr) {
@@ -97,9 +101,11 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
     }
 
     //before adding new entry, clean cache
-    std::remove_if(transactions.begin(), transactions.end(), [](std::weak_ptr<Transaction> tx) {
-        return tx.expired();
-    });
+    transactions.erase(std::remove_if(transactions.begin(), transactions.end(),
+            [](std::weak_ptr<Transaction> tx) {
+                return tx.expired();
+            }),
+            transactions.end());
 
     transactions.push_back(transaction);
     return transaction;
@@ -123,9 +129,11 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction() {
     }
 
     //before adding new entry, clean cache
-    std::remove_if(transactions.begin(), transactions.end(), [](std::weak_ptr<Transaction> tx) {
-        return tx.expired();
-    });
+    transactions.erase(std::remove_if(transactions.begin(), transactions.end(),
+            [](std::weak_ptr<Transaction> tx) {
+                return tx.expired();
+            }),
+            transactions.end());
 
     transactions.push_back(transaction);
     return transaction;
@@ -171,6 +179,50 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
     return true;
 }
 
+bool ConnectorTransactionStore::remove(unsigned int txNr) {
+
+    if (!filesystem) {
+        AO_DBG_DEBUG("no FS: nothing to remove");
+        return true;
+    }
+
+    char fn [MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, txNr);
+    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+        AO_DBG_ERR("fn error: %i", ret);
+        return false;
+    }
+
+    size_t msize;
+    if (filesystem->stat(fn, &msize) != 0) {
+        AO_DBG_DEBUG("%s already removed", fn);
+        return true;
+    }
+
+    AO_DBG_DEBUG("remove %s", fn);
+    
+    return filesystem->remove(fn);
+}
+
+int ConnectorTransactionStore::getTxBegin() {
+    if (!txBegin || *txBegin < 0) {
+        AO_DBG_ERR("memory corruption");
+        return -1;
+    }
+
+    return *txBegin;
+}
+
+void ConnectorTransactionStore::updateTxBegin(unsigned int txNr) {
+    if (!txBegin || *txBegin < 0) {
+        AO_DBG_ERR("memory corruption");
+        return;
+    }
+
+    *txBegin = txNr;
+    configuration_save();
+}
+
 TransactionStore::TransactionStore(uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
     
     for (uint i = 0; i < nConnectors; i++) {
@@ -193,7 +245,7 @@ bool TransactionStore::commit(Transaction *transaction) {
         return false;
     }
     auto connectorId = transaction->getConnectorId();
-    if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
+    if (connectorId >= connectors.size()) {
         AO_DBG_ERR("Invalid tx");
         return false;
     }
@@ -215,3 +267,27 @@ std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int co
     }
     return connectors[connectorId]->createTransaction();
 }
+
+bool TransactionStore::remove(unsigned int connectorId, unsigned int txNr) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return false;
+    }
+    return connectors[connectorId]->remove(txNr);
+}
+
+int TransactionStore::getTxBegin(unsigned int connectorId) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return -1;
+    }
+    return connectors[connectorId]->getTxBegin();
+}
+
+void TransactionStore::updateTxBegin(unsigned int connectorId, unsigned int txNr) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return;
+    }
+    return connectors[connectorId]->updateTxBegin(txNr);
+}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
index 98004c9d..c2069496 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
@@ -10,6 +10,8 @@
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <deque>
 
+#define MAX_TX_CNT 100000U
+
 namespace ArduinoOcpp {
 
 class TransactionStore;
@@ -24,6 +26,8 @@ class ConnectorTransactionStore {
     
     std::deque<std::weak_ptr<Transaction>> transactions;
 
+    std::shared_ptr<Configuration<int>> txBegin; //if txNr < txBegin, tx has been safely deleted
+
 public:
     ConnectorTransactionStore(TransactionStore& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
     
@@ -32,6 +36,11 @@ class ConnectorTransactionStore {
 
     std::shared_ptr<Transaction> getTransaction(unsigned int txNr);
     std::shared_ptr<Transaction> createTransaction();
+
+    bool remove(unsigned int txNr);
+
+    int getTxBegin();
+    void updateTxBegin(unsigned int txNr);
 };
 
 class TransactionStore {
@@ -45,6 +54,11 @@ class TransactionStore {
 
     std::shared_ptr<Transaction> getTransaction(unsigned int connectorId, unsigned int txNr);
     std::shared_ptr<Transaction> createTransaction(unsigned int connectorId);
+
+    bool remove(unsigned int connectorId, unsigned int txNr);
+
+    int getTxBegin(unsigned int connectorId);
+    void updateTxBegin(unsigned int connectorId, unsigned int txNr);
 };
 
 }

From f120bf5883167dd5884edb7d60abc8be0a932c31 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 4 Nov 2022 12:21:16 +0100
Subject: [PATCH 117/549] restore availability after FW update and reboot

---
 .../ChargePointStatusService.cpp              |  4 +-
 .../ChargePointStatus/ConnectorStatus.cpp     | 47 ++++++++++++-------
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  6 +--
 .../FirmwareManagement/FirmwareService.cpp    |  4 +-
 4 files changed, 35 insertions(+), 26 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 7ac60c4a..ba483bf9 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -82,7 +82,7 @@ void ChargePointStatusService::loop() {
 
         if (outstandingResetRetries <= 0) {
             for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
-                (*connector)->setRebooting(false);
+                (*connector)->setAvailabilityVolatile(false);
             }
         }
     }
@@ -158,7 +158,7 @@ void ChargePointStatusService::initiateReset(bool isHard) {
     t_resetRetry = ao_tick_ms();
 
     for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
-        (*connector)->setRebooting(true);
+        (*connector)->setAvailabilityVolatile(true);
     }
 }
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 816ebad8..74f40c60 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -82,9 +82,7 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
     if (connectorId == 0) {
         if (getErrorCode() != nullptr) {
             return OcppEvseState::Faulted;
-        } else if (*availability == AVAILABILITY_INOPERATIVE) {
-            return OcppEvseState::Unavailable;
-        } else if (rebooting) {
+        } else if (getAvailability() == AVAILABILITY_INOPERATIVE) {
             return OcppEvseState::Unavailable;
         } else {
             return OcppEvseState::Available;
@@ -93,9 +91,7 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
 
     if (getErrorCode() != nullptr) {
         return OcppEvseState::Faulted;
-    } else if (*availability == AVAILABILITY_INOPERATIVE) {
-        return OcppEvseState::Unavailable;
-    } else if (rebooting && (!transaction || !transaction->isRunning())) {
+    } else if (getAvailability() == AVAILABILITY_INOPERATIVE) {
         return OcppEvseState::Unavailable;
     } else if (transaction && transaction->isRunning()) {
         //Transaction is currently running
@@ -144,9 +140,14 @@ bool ConnectorStatus::ocppPermitsCharge() {
 
 OcppMessage *ConnectorStatus::loop() {
 
-    if ((!transaction || !transaction->isRunning()) && *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
-        *availability = AVAILABILITY_INOPERATIVE;
-        saveState();
+    if (!isTransactionRunning()) {
+        if (*availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
+            *availability = AVAILABILITY_INOPERATIVE;
+            configuration_save();
+        }
+        if (availabilityVolatile == AVAILABILITY_INOPERATIVE_SCHEDULED) {
+            availabilityVolatile = AVAILABILITY_INOPERATIVE;
+        }
     }
 
     if (transaction && (transaction->isAborted() || transaction->isCompleted())) {
@@ -395,24 +396,38 @@ std::shared_ptr<Transaction>& ConnectorStatus::getTransaction() {
 }
 
 int ConnectorStatus::getAvailability() {
-    return *availability;
+    if (availabilityVolatile == AVAILABILITY_INOPERATIVE || *availability == AVAILABILITY_INOPERATIVE) {
+        return AVAILABILITY_INOPERATIVE;
+    } else if (availabilityVolatile == AVAILABILITY_INOPERATIVE_SCHEDULED || *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
+        AVAILABILITY_INOPERATIVE_SCHEDULED;
+    } else {
+        return AVAILABILITY_OPERATIVE;
+    }
 }
 
 void ConnectorStatus::setAvailability(bool available) {
     if (available) {
         *availability = AVAILABILITY_OPERATIVE;
     } else {
-        if (getTransactionId() > 0) {
+        if (isTransactionRunning()) {
             *availability = AVAILABILITY_INOPERATIVE_SCHEDULED;
         } else {
             *availability = AVAILABILITY_INOPERATIVE;
         }
     }
-    saveState();
+    configuration_save();
 }
 
-void ConnectorStatus::setRebooting(bool rebooting) {
-    this->rebooting = rebooting;
+void ConnectorStatus::setAvailabilityVolatile(bool available) {
+    if (available) {
+        availabilityVolatile = AVAILABILITY_OPERATIVE;
+    } else {
+        if (isTransactionRunning()) {
+            availabilityVolatile = AVAILABILITY_INOPERATIVE_SCHEDULED;
+        } else {
+            availabilityVolatile = AVAILABILITY_INOPERATIVE;
+        }
+    }
 }
 
 void ConnectorStatus::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
@@ -434,10 +449,6 @@ void ConnectorStatus::addConnectorErrorCodeSampler(std::function<const char *()>
     this->connectorErrorCodeSamplers.push_back(connectorErrorCode);
 }
 
-void ConnectorStatus::saveState() {
-    configuration_save();
-}
-
 void ConnectorStatus::setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
     this->onUnlockConnector = unlockConnector;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 60dd57b4..12e65be6 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -35,7 +35,7 @@ class ConnectorStatus {
     std::shared_ptr<Transaction> transaction;
 
     std::shared_ptr<Configuration<int>> availability;
-    bool rebooting = false; //report connector inoperative and reject new charging sessions
+    int availabilityVolatile = AVAILABILITY_OPERATIVE;
 
     std::function<bool()> connectorPluggedSampler;
     std::function<bool()> evRequestsEnergySampler;
@@ -85,15 +85,13 @@ class ConnectorStatus {
 
     int getAvailability();
     void setAvailability(bool available);
-    void setRebooting(bool rebooting);
+    void setAvailabilityVolatile(bool available); //set inoperative state but keep only until reboot at most
     void setAuthorizationProvider(std::function<const char *()> authorization);
     void setConnectorPluggedSampler(std::function<bool()> connectorPlugged);
     void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy);
     void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized);
     void addConnectorErrorCodeSampler(std::function<const char*()> connectorErrorCode);
 
-    void saveState();
-
     OcppMessage *loop();
 
     OcppEvseState inferenceStatus();
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index e32b1d11..f2f8dfea 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -61,7 +61,7 @@ void FirmwareService::loop() {
                 if (!availabilityRestore) {
                     availabilityRestore = (evse->getAvailability() == AVAILABILITY_OPERATIVE);
                 }
-                evse->setAvailability(false);
+                evse->setAvailabilityVolatile(false);
             }
             if (onDownload == nullptr) {
                 stage = UpdateStage::AfterDownload;
@@ -169,7 +169,7 @@ void FirmwareService::loop() {
                 retries = 0; //End of update routine. Client must reboot on its own
                 if (availabilityRestore) {
                     if (cpStatusService && cpStatusService->getConnector(0)) {
-                        cpStatusService->getConnector(0)->setAvailability(true);
+                        cpStatusService->getConnector(0)->setAvailabilityVolatile(true);
                     }
                 }
                 return;

From 49b288524e001e69c8ad715ec4f4118b243e8a67 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 4 Nov 2022 15:05:20 +0100
Subject: [PATCH 118/549] update tests

---
 .../ChargePointStatus/ConnectorStatus.cpp     |   2 +-
 tests/ChargingSessions.cpp                    |  14 +--
 tests/TransactionProcess.cpp                  |   1 +
 tests/TransactionSafety.cpp                   | 111 ++++++++++++++++++
 tests/helpers/testHelper.cpp                  |  19 ++-
 tests/helpers/testHelper.h                    |   9 +-
 6 files changed, 139 insertions(+), 17 deletions(-)
 create mode 100644 tests/TransactionSafety.cpp

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 74f40c60..6ac3326b 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -399,7 +399,7 @@ int ConnectorStatus::getAvailability() {
     if (availabilityVolatile == AVAILABILITY_INOPERATIVE || *availability == AVAILABILITY_INOPERATIVE) {
         return AVAILABILITY_INOPERATIVE;
     } else if (availabilityVolatile == AVAILABILITY_INOPERATIVE_SCHEDULED || *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
-        AVAILABILITY_INOPERATIVE_SCHEDULED;
+        return AVAILABILITY_INOPERATIVE_SCHEDULED;
     } else {
         return AVAILABILITY_OPERATIVE;
     }
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 4091173a..f7864a40 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -7,22 +7,10 @@
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
 
 using namespace ArduinoOcpp;
 
-unsigned long mtime = 10000;
-unsigned long custom_timer_cb() {
-    return mtime;
-}
-
-void loop() {
-    mtime += 1000;
-    OCPP_loop();
-    mtime += 1000;
-    OCPP_loop();
-    mtime += 1000;
-    OCPP_loop();
-}
 
 TEST_CASE( "Charging sessions" ) {
 
diff --git a/tests/TransactionProcess.cpp b/tests/TransactionProcess.cpp
index b422761b..a4a4e1de 100644
--- a/tests/TransactionProcess.cpp
+++ b/tests/TransactionProcess.cpp
@@ -1,5 +1,6 @@
 #include <ArduinoOcpp/Tasks/Transactions/TransactionProcess.h>
 #include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
 
 #include <array>
 
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
new file mode 100644
index 00000000..3214d8e2
--- /dev/null
+++ b/tests/TransactionSafety.cpp
@@ -0,0 +1,111 @@
+#include <ArduinoOcpp.h>
+#include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/MessagesV16/BootNotification.h>
+#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
+#include <ArduinoOcpp/Debug.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+using namespace ArduinoOcpp;
+
+
+TEST_CASE( "Transaction safety" ) {
+
+    //initialize OcppEngine with dummy socket
+    OcppEchoSocket echoSocket;
+    OCPP_initialize(echoSocket);
+
+    ao_set_timer(custom_timer_cb);
+
+    auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN);
+        *connectionTimeOut = 30;
+
+    bootNotification("dummy1234", "");
+
+    SECTION("Basic transaction") {
+        AO_DBG_DEBUG("Basic transaction");
+        OCPP_loop();
+        OCPP_loop();
+        OCPP_loop();
+        startTransaction("mIdTag");
+        OCPP_loop();
+        REQUIRE(ocppPermitsCharge());
+        stopTransaction();
+        OCPP_loop();
+        REQUIRE(!ocppPermitsCharge());
+
+        OCPP_deinitialize();
+    }
+
+    SECTION("Managed transaction") {
+        AO_DBG_DEBUG("Managed transaction");
+        OCPP_loop();
+        OCPP_loop();
+        OCPP_loop();
+        setConnectorPluggedSampler([] () {return true;});
+        beginSession("mIdTag");
+        OCPP_loop();
+        REQUIRE(ocppPermitsCharge());
+        endSession();
+        OCPP_loop();
+        REQUIRE(!ocppPermitsCharge());
+        
+        OCPP_deinitialize();
+    }
+
+    SECTION("Reset during transaction 01 - interrupt initiation") {
+        AO_DBG_DEBUG("Reset during transaction 01 - interrupt initiation");
+        setConnectorPluggedSampler([] () {return false;});
+        OCPP_loop();
+        OCPP_loop();
+        OCPP_loop();
+        beginSession("mIdTag");
+        OCPP_deinitialize(); //reset and jump to next section
+    }
+
+    SECTION("Reset during transaction 02 - interrupt initiation second time") {
+        AO_DBG_DEBUG("Reset during transaction 02 - interrupt initiation second time");
+        setConnectorPluggedSampler([] () {return false;});
+        OCPP_loop();
+        OCPP_loop();
+        OCPP_loop();
+        REQUIRE(!ocppPermitsCharge());
+        OCPP_deinitialize();
+    }
+
+    SECTION("Reset during transaction 03 - interrupt running tx") {
+        AO_DBG_DEBUG("Reset during transaction 03 - interrupt running tx");
+        setConnectorPluggedSampler([] () {return true;});
+        OCPP_loop();
+        OCPP_loop();
+        OCPP_loop();
+        REQUIRE(ocppPermitsCharge());
+        OCPP_deinitialize();
+    }
+
+    SECTION("Reset during transaction 04 - interrupt stopping tx") {
+        AO_DBG_DEBUG("Reset during transaction 04 - interrupt stopping tx");
+        setConnectorPluggedSampler([] () {return true;});
+        OCPP_loop();
+        OCPP_loop();
+        OCPP_loop();
+        REQUIRE(ocppPermitsCharge());
+        endSession();
+        OCPP_deinitialize();
+    }
+
+    SECTION("Reset during transaction 06 - check tx finished") {
+        AO_DBG_DEBUG("Reset during transaction 06 - check tx finished");
+        setConnectorPluggedSampler([] () {return true;});
+        OCPP_loop();
+        OCPP_loop();
+        OCPP_loop();
+        REQUIRE(!ocppPermitsCharge());
+        OCPP_deinitialize();
+    }
+
+}
\ No newline at end of file
diff --git a/tests/helpers/testHelper.cpp b/tests/helpers/testHelper.cpp
index 15f57b91..2ac00670 100644
--- a/tests/helpers/testHelper.cpp
+++ b/tests/helpers/testHelper.cpp
@@ -1,5 +1,22 @@
 #include <iostream>
+#include <ArduinoOcpp.h>
+
+using namespace ArduinoOcpp;
 
 void cpp_console_out(const char *msg) {
     std::cout << msg;
-}
\ No newline at end of file
+}
+
+unsigned long mtime = 10000;
+unsigned long custom_timer_cb() {
+    return mtime;
+}
+
+void loop() {
+    mtime += 1000;
+    OCPP_loop();
+    mtime += 1000;
+    OCPP_loop();
+    mtime += 1000;
+    OCPP_loop();
+}
diff --git a/tests/helpers/testHelper.h b/tests/helpers/testHelper.h
index 202c2f38..4d9fd640 100644
--- a/tests/helpers/testHelper.h
+++ b/tests/helpers/testHelper.h
@@ -6,6 +6,11 @@
 *
 * @param msg pointer to the string
 */
-void cpp_console_out(const char *msg);    
+void cpp_console_out(const char *msg);   
 
-#endif
\ No newline at end of file
+extern unsigned long mtime;
+unsigned long custom_timer_cb();
+
+void loop();
+
+#endif

From 529fc64628303963442079f891cdd9d567ca886a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 6 Nov 2022 11:08:17 +0100
Subject: [PATCH 119/549] specify FS root for testing

---
 .github/workflows/tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 55a30f85..f7ae612a 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -24,5 +24,7 @@ jobs:
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
       run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_USE_FILEAPI=POSIX_FILEAPI -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -DAO_DEACTIVATE_FLASH_SMARTCHARGING -o ./output -Wall
+    - name: Configure FS
+      run: mkdir ao_store
     - name: Run tests
       run: ./output

From 4f5276d0ca63533bf7c10a180bddb404b379d043 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 6 Nov 2022 11:34:00 +0100
Subject: [PATCH 120/549] fix compiler error

---
 src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 52f3717e..6054380b 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -16,7 +16,7 @@ using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
 ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, int connectorId, MeterStore& meterStore)
-        : context(context), connectorId{connectorId}, meterStore{meterStore} {
+        : context(context), connectorId{connectorId}, meterStore(meterStore) {
 
     auto MeterValuesSampledData = declareConfiguration<const char*>(
         "MeterValuesSampledData",

From af60f0bcdd234c5f17f0a37317e4a8dc7bfb44f7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 7 Nov 2022 23:32:40 +0000
Subject: [PATCH 121/549] minor fixes

---
 src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp   | 8 ++++++--
 src/ArduinoOcpp/MessagesV16/StatusNotification.h | 2 ++
 src/ArduinoOcpp/Platform.cpp                     | 4 +++-
 src/ArduinoOcpp/Platform.h                       | 1 +
 4 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index 1e06471a..a4938db3 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -107,13 +107,17 @@ bool AbstractConfiguration::toBeRemoved() {
 }
 
 void AbstractConfiguration::setToBeRemoved() {
+    if (!toBeRemovedFlag) {
+        value_revision++;
+    }
     toBeRemovedFlag = true;
-    value_revision++;
 }
 
 void AbstractConfiguration::resetToBeRemovedFlag() {
+    if (toBeRemovedFlag) {
+        value_revision++;
+    }
     toBeRemovedFlag = false;
-    value_revision++;
 }
 
 uint16_t AbstractConfiguration::getValueRevision() {
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.h b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
index 6bac84f1..5078044e 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
@@ -36,6 +36,8 @@ class StatusNotification : public OcppMessage {
     std::unique_ptr<DynamicJsonDocument> createConf();
 };
 
+const char *cstrFromOcppEveState(OcppEvseState state);
+
 } //end namespace Ocpp16
 } //end namespace ArduinoOcpp
 #endif
diff --git a/src/ArduinoOcpp/Platform.cpp b/src/ArduinoOcpp/Platform.cpp
index 0b2a1ef8..463d7cd5 100644
--- a/src/ArduinoOcpp/Platform.cpp
+++ b/src/ArduinoOcpp/Platform.cpp
@@ -54,6 +54,8 @@ unsigned long ao_tick_ms_unix() {
         ArduinoOcpp::clock_reference = std::chrono::steady_clock::now();
         ArduinoOcpp::clock_initialized = true;
     }
-    return (std::chrono::steady_clock::now() - ArduinoOcpp::clock_reference).count() / (int64_t) 1000000;
+    std::chrono::milliseconds ms = std::chrono::duration_cast<std::chrono::milliseconds>(
+        std::chrono::steady_clock::now() - ArduinoOcpp::clock_reference);
+    return (unsigned long) ms.count();
 }
 #endif
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 4e811c07..04fa5306 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -20,6 +20,7 @@
 #endif
 
 #ifdef AO_CUSTOM_CONSOLE
+#include <cstdio>
 
 #ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
 #define AO_CUSTOM_CONSOLE_MAXMSGSIZE 196

From 275c2d6a24c34773bbbb0cbbe2fd73e0e152fc5c Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 8 Nov 2022 15:54:28 +0100
Subject: [PATCH 122/549] Update README.md

---
 README.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index fac6eacf..4b24e5a0 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 [![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
 
-OCPP-J 1.6 client for the ESP8266 and the ESP32 (more coming soon)
+OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Runs on Espressif, NXP, Texas Instruments, STM and embedded Linux.
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
 
@@ -10,17 +10,17 @@ PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoO
 
 Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
-Fully integrated into the Arduino platform. Compatible with ESP-IDF and generic FreeRTOS
+Fully integrated into the Arduino platform and the ESP32 / ESP8266. Compatible with ESP-IDF, FreeRTOS and generic embedded C/C++ platforms.
 
-## Make your EVSE ready for OCPP :car::electric_plug::battery:
+## Make your EVSE ready for OCPP-based charging networks :car::electric_plug::battery:
 
-You can build an OCPP Charge Point controller using the popular, Wi-Fi enabled microcontrollers ESP8266, ESP32 and comparable. This library allows your EVSE to communicate with an OCPP Central System and to participate in your Charging Network.
+This library allows your EVSE to communicate with an OCPP Backend and to participate in commercial charging networks. You can integrate it into an existing firmware development, or start a new EVSE project from scratch with it.
 
 :heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve), [The Mobility House OCPP package](https://github.com/mobilityhouse/ocpp) and further commercial Central Systems
 
-:heavy_check_mark: Integrated and tested in many charging stations
+:heavy_check_mark: Flexible API for customizable EVSE projects. Tested in many charging stations
 
-:heavy_check_mark: Eligible for **public chargers**. Complies also with the legal requirements of the German Ladesäulenverordnung (LSV)
+:heavy_check_mark: Eligible for **public chargers** (Eichrecht-compliant)
 
 ### Features
 
@@ -100,7 +100,7 @@ If compiled with the Arduino integration:
 
 In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
 
-## Supported operations
+## Supported Feature Profiles
 
 | Feature profile | supported | in progress |
 | -------------- | :---------: | :-----------: |

From 81ed9ab3a504cc214df8d579171260f4484ba285 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 8 Nov 2022 17:32:43 +0100
Subject: [PATCH 123/549] Update README.md

---
 README.md | 69 ++++++++-----------------------------------------------
 1 file changed, 9 insertions(+), 60 deletions(-)

diff --git a/README.md b/README.md
index 4b24e5a0..d27fd202 100644
--- a/README.md
+++ b/README.md
@@ -33,62 +33,11 @@ This library allows your EVSE to communicate with an OCPP Backend and to partici
 
 For simple chargers, the necessary hardware and internet integration is usually far below 1000 LOCs.
 
-## Usage guide
+## Developers guide
 
-Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. This guide explains the concepts for a minimal integration.
+Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`ArduinoOcpp.h`](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h).
 
-- To install the dependencies, see the list below for a manual installation or add `matth-x/ArduinoOcpp` to your project using the PIO library manager.
-
-- In your project's `main` file, include `ArduinoOcpp.h` and the Wi-Fi library. Initialize Wi-Fi and the Serial output.
-
-- To connect to the OCPP Central System, call `OCPP_initialize(const char *host, uint16_t port, const char *url)`. For a secure connection with TLS, you need to configure the WebSocket in advance. Please take `examples/ESP-TLS/main.cpp` as an example.
-
-- In `setup()`, configure ArduinoOcpp with the hardware drivers. You can leave that part out for the first connection test. Please refer to `ArduinoOcpp.h` for a documentation about the supported EVSE peripherals.
-
-- In `loop()`, add `OCPP_loop()`.
-
-**Sending OCPP operations**
-
-There are a couple of OCPP operations you can initialize on your EVSE. For example, to send a `Boot Notification`, use the function 
-```cpp
-void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf = nullptr, ...)`
-```
-
-In practice, it looks like this:
-
-```cpp
-void setup() {
-    ... //other code including the initialization of Wi-Fi and OCPP
-
-    bootNotification("My CP model name", "My company name", [] (JsonObject confMsg) {
-        //This callback is executed when the .conf() response from the central system arrives
-        Serial.print(F("BootNotification was answered. Central System clock: "));
-        Serial.println(confMsg["currentTime"].as<String>()); //"currentTime" is a field of the central system response
-        
-        //evseIsBooted = true; <-- Example: Notify your hardare that the BootNotification.conf() has arrived
-    });
-    
-    ... //rest of setup() function; executed immediately as bootNotification() is non-blocking
-}
-```
-
-The parameters `chargePointModel` and `chargePointVendor` are equivalent to the parameters in the `Boot Notification` as defined by the OCPP specification. The last parameter `OnReceiveConfListener onConf` is a callback function which the library executes when the central system has processed the operation and the ESP has received the `.conf()` response. Here you can add your device-specific behavior, e.g. flash a confirmation LED or unlock the connectors. If you don't need it, the last parameter is optional.
-
-**Receiving OCPP operations**
-
-You can also add customized behavior to incoming OCPP messages. For example, to flash an LED on receipt of a `Set Charging Profile` request, use the following function.
-
-```cpp
-setOnSetChargingProfileRequest([] (JsonObject payload) {
-    //... will be executed every time this EVSE receives a new Charging Profile
-});
-```
-
-Using the `payload` object you can access the original payload from the CS.
-
-*To get started quickly with or without EVSE hardware, you can flash the sketch in `examples/SECC` onto your ESP. That example mimics a full OCPP communications controller as it would look like in a real charging station. You can build a charger prototype based on that example or just view the internal state using the device monitor.*
-
-## Dependencies
+### Dependencies
 
 Mandatory:
 
@@ -100,6 +49,12 @@ If compiled with the Arduino integration:
 
 In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
 
+### Next development steps
+
+- [x] reach full compliance to OCPP 1.6 Smart Charging Profile
+- [ ] integrate Authorization Cache
+- [ ] **get ready for OCPP 2.0.1 and ISO 15118**
+
 ## Supported Feature Profiles
 
 | Feature profile | supported | in progress |
@@ -109,12 +64,6 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 | **Remote trigger** | :heavy_check_mark: |
 | **Firmware management** | :heavy_check_mark: |
 
-## Next development steps
-
-- [x] reach full compliance to OCPP 1.6 Smart Charging Profile
-- [ ] integrate Authorization Cache
-- [ ] **get ready for OCPP 2.0.1 and ISO 15118**
-
 ## Further help
 
 I hope this guide can help you to successfully integrate an OCPP controller into your EVSE. If something needs clarification or if you have a question, please send me a message.

From 56247c5f7e0eb0e5ada09810fb04f6075dec17f2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 11 Nov 2022 14:46:49 +0100
Subject: [PATCH 124/549] set StopReason for Reset

---
 src/ArduinoOcpp.cpp                           |  7 ++++---
 src/ArduinoOcpp/MessagesV16/Reset.cpp         | 21 ++++++++++++-------
 .../SimpleOcppOperationFactory.cpp            |  2 --
 .../ChargePointStatusService.cpp              |  8 +++----
 .../ChargePointStatusService.h                |  9 +++-----
 5 files changed, 23 insertions(+), 24 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index f68fed42..47619ce1 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -117,14 +117,15 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
 
 #if !defined(AO_CUSTOM_DIAGNOSTICS) && !defined(AO_CUSTOM_WS)
     model.setDiagnosticsService(std::unique_ptr<DiagnosticsService>(
-        EspWiFi::makeDiagnosticsService(*ocppEngine))); //will only return "Rejected" because logging is not implemented yet
+        EspWiFi::makeDiagnosticsService(*ocppEngine))); //will only return "Rejected" because client needs to implement logging
 #else
     model.setDiagnosticsService(std::unique_ptr<DiagnosticsService>(
         new DiagnosticsService(*ocppEngine)));
 #endif
 
-#if !defined(AO_CUSTOM_RESET)
-    model.getChargePointStatusService()->setExecuteReset(EspWiFi::makeDefaultResetFn());
+#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+    if (!model.getChargePointStatusService()->getExecuteReset())
+        model.getChargePointStatusService()->setExecuteReset(makeDefaultResetFn());
 #endif
 
     ocppEngine->setRunOcppTasks(false); //prevent OCPP classes from doing anything while booting
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.cpp b/src/ArduinoOcpp/MessagesV16/Reset.cpp
index 0e54e8ef..4283eea5 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Reset.cpp
@@ -25,14 +25,19 @@ void Reset::processReq(JsonObject payload) {
 
     if (ocppModel && ocppModel->getChargePointStatusService()) {
         auto cpsService = ocppModel->getChargePointStatusService();
-        if (!cpsService->getPreReset() || cpsService->getPreReset()(isHard) || isHard) {
-            resetAccepted = true;
-            cpsService->initiateReset(isHard);
-            int connId = 0;
-            for (int i = 0; i < cpsService->getNumConnectors(); i++) {
-                auto connector = cpsService->getConnector(connId);
-                if (connector) {
-                    connector->endSession(isHard ? "HardReset" : "SoftReset");
+        if (!cpsService->getExecuteReset()) {
+            AO_DBG_ERR("No reset handler set. Abort operation");
+            (void)0;
+            //resetAccepted remains false
+        } else {
+            if (!cpsService->getPreReset() || cpsService->getPreReset()(isHard) || isHard) {
+                resetAccepted = true;
+                cpsService->initiateReset(isHard);
+                for (int i = 0; i < cpsService->getNumConnectors(); i++) {
+                    auto connector = cpsService->getConnector(i);
+                    if (connector) {
+                        connector->endSession(isHard ? "HardReset" : "SoftReset");
+                    }
                 }
             }
         }
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
index 9a825b85..59a62ff1 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
@@ -253,8 +253,6 @@ std::unique_ptr<OcppOperation> makeOcppOperation(const char *messageType, int co
         operation->setOnSendConfListener(onGetConfigurationSendConf);
     } else if (!strcmp(messageType, "Reset")) {
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::Reset());
-        if (onResetSendConf == nullptr && onResetReceiveReq == nullptr)
-            AO_DBG_WARN("Reset is without effect when the sendConf and receiveReq listener is not set. Set a listener which resets your device.");
         operation->setOnReceiveReqListener(onResetReceiveReq);
         operation->setOnSendConfListener(onResetSendConf);
     } else if (!strcmp(messageType, "UpdateFirmware")) {
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index ba483bf9..07c18331 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -162,13 +162,11 @@ void ChargePointStatusService::initiateReset(bool isHard) {
     }
 }
 
-#if !defined(AO_CUSTOM_RESET)
-#if defined(ESP32) || defined(ESP8266)
-std::function<void(bool isHard)> ArduinoOcpp::EspWiFi::makeDefaultResetFn() {
+#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+std::function<void(bool isHard)> ArduinoOcpp::makeDefaultResetFn() {
     return [] (bool isHard) {
         AO_DBG_DEBUG("Perform ESP reset");
         ESP.restart();
     };
 }
-#endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+#endif //AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
index 2add4e7c..ae7758d7 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
@@ -6,6 +6,7 @@
 #define CHARGEPOINTSTATUSSERVICE_H
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h>
+#include <ArduinoOcpp/Platform.h>
 
 #include <vector>
 
@@ -58,18 +59,14 @@ class ChargePointStatusService {
 
 } //end namespace ArduinoOcpp
 
-#if !defined(AO_CUSTOM_RESET)
-#if defined(ESP32) || defined(ESP8266)
+#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
 
 namespace ArduinoOcpp {
-namespace EspWiFi {
 
 std::function<void(bool isHard)> makeDefaultResetFn();
 
-}
 }
 
-#endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+#endif //AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
 
 #endif

From 03177f93e7d2c6b6b15c07b5d0f9944da65512b0 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 13 Nov 2022 17:23:00 +0100
Subject: [PATCH 125/549] MV outside tx optional; adapt MV configs

---
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp    |  15 +++
 .../Metering/ConnectorMeterValuesRecorder.cpp | 109 +++++++++---------
 .../Metering/ConnectorMeterValuesRecorder.h   |  14 +--
 .../Tasks/Transactions/TransactionStore.cpp   |   2 +-
 4 files changed, 80 insertions(+), 60 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index a8af6e33..1e778a4c 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -98,6 +98,21 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
 #error
 #endif
         } //end if mustMount()
+
+#if AO_DBG_LEVEL >= AO_DL_DEBUG
+        if (valid) {
+            File root = USE_FS.open("/");
+            File file = root.openNextFile();
+
+            AO_DBG_DEBUG("filesystem content:");
+            while(file) {
+                AO_CONSOLE_PRINTF("[AO]     > %s\n", file.name() ? file.name() : "null");
+                file = root.openNextFile();       
+            }
+
+            root.close();
+        }
+#endif //endif AO_DBG_LEVEL >= AO_DL_DBUG
     }
 
     ~ArduinoFilesystemAdapter() {
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 6054380b..9581c3ba 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -24,7 +24,8 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
         CONFIGURATION_FN,
         true,true,true,false
     );
-    MeterValuesSampledDataMaxLength = declareConfiguration("MeterValuesSampledDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
+    MeterValueCacheSize = declareConfiguration("AO_MeterValueCacheSize", 1, CONFIGURATION_FN, true, true, true, false);
     MeterValueSampleInterval = declareConfiguration("MeterValueSampleInterval", 60);
     
     auto StopTxnSampledData = declareConfiguration<const char*>(
@@ -33,7 +34,7 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
         CONFIGURATION_FN,
         true,true,true,false
     );
-    StopTxnSampledDataMaxLength = declareConfiguration("StopTxnSampledDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<int>("StopTxnSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
     
     auto MeterValuesAlignedData = declareConfiguration<const char*>(
         "MeterValuesAlignedData",
@@ -41,7 +42,7 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
         CONFIGURATION_FN,
         true,true,true,false
     );
-    MeterValuesAlignedDataMaxLength = declareConfiguration("MeterValuesAlignedDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<int>("MeterValuesAlignedDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
     ClockAlignedDataInterval  = declareConfiguration("ClockAlignedDataInterval", 0);
     
     auto StopTxnAlignedData = declareConfiguration<const char*>(
@@ -50,8 +51,10 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
         CONFIGURATION_FN,
         true,true,true,false
     );
-    StopTxnAlignedDataMaxLength = declareConfiguration("StopTxnAlignedDataMaxLength", 4, CONFIGURATION_VOLATILE, false, true, false, false);
-    
+
+    MeterValuesInTxOnly = declareConfiguration<const char*>("AO_MeterValuesInTxOnly", "true", CONFIGURATION_FN, true, true, true, false);
+    StopTxnDataCapturePeriodic = declareConfiguration<const char*>("AO_StopTxnDataCapturePeriodic", "false", CONFIGURATION_FN, true, true, true, false);
+
     sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesSampledData));
     alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData));
     stopTxnSampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnSampledData));
@@ -60,25 +63,48 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
 
 OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
-    Transaction *transaction = nullptr;
+    bool txBreak = false;
+    if (context.getConnectorStatus(connectorId)) {
+        auto &curTx = context.getConnectorStatus(connectorId)->getTransaction();
+        txBreak = (curTx && curTx->isRunning()) != trackTxRunning;
+        trackTxRunning = (curTx && curTx->isRunning());
+    }
 
-    if (context.getConnectorStatus(connectorId) && context.getConnectorStatus(connectorId)->getTransaction()) {
-        transaction = context.getConnectorStatus(connectorId)->getTransaction().get();
+    if (txBreak) {
+        lastSampleTime = ao_tick_ms();
+    }
 
-        if (transaction->isRunning() && (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr())) {
-            AO_DBG_WARN("reload stopTxnData");
-            //reload (e.g. after power cut during transaction)
-            stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
-        }
+    if ((txBreak || meterData.size() >= (size_t) *MeterValueCacheSize) && !meterData.empty()) {
+        auto meterValues = new MeterValues(std::move(meterData), connectorId, transaction);
+        meterData.clear();
+        return meterValues;
     }
 
-    if (*ClockAlignedDataInterval >= 1) {
+    if (context.getConnectorStatus(connectorId)) {
+        if (transaction != context.getConnectorStatus(connectorId)->getTransaction()) {
+            transaction = context.getConnectorStatus(connectorId)->getTransaction();
+        }
+        
+        if (transaction && transaction->isRunning()) {
+            //check during transaction
+
+            if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
+                AO_DBG_WARN("reload stopTxnData");
+                //reload (e.g. after power cut during transaction)
+                stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
+            }
+        } else {
+            //check outside of transaction
 
-        if (alignedData.size() >= (size_t) *MeterValuesAlignedDataMaxLength) {
-            auto meterValues = new MeterValues(std::move(alignedData), connectorId);
-            alignedData.clear();
-            return meterValues;
+            if (!(const char *) *MeterValuesInTxOnly || strcmp(*MeterValuesInTxOnly, "false")) {
+                //don't take any MeterValues outside of transactions
+                meterData.clear();
+                return nullptr;
+            }
         }
+    }
+
+    if (*ClockAlignedDataInterval >= 1) {
 
         auto& timestampNow = context.getOcppTime().getOcppTimestampNow();
         auto dt = nextAlignedTime - timestampNow;
@@ -91,7 +117,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
                 auto alignedMeterValues = alignedDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SampleClock);
                 if (alignedMeterValues) {
-                    alignedData.push_back(std::move(alignedMeterValues));
+                    meterData.push_back(std::move(alignedMeterValues));
                 }
 
                 if (stopTxnData) {
@@ -117,45 +143,18 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
                 nextAlignedTime = midnight + (intervall * *ClockAlignedDataInterval);
             }
         }
-    } else {
-        alignedData.clear();
     }
 
     if (*MeterValueSampleInterval >= 1) {
         //record periodic tx data
 
-        if (sampledData.size() >= (size_t) *MeterValuesSampledDataMaxLength) {
-            auto meterValues = new MeterValues(std::move(sampledData), connectorId);
-            sampledData.clear();
-            return meterValues;
-        }
-
-        if ((transaction && transaction->isRunning()) != trackTxRunning) {
-            //transaction break
-
-            trackTxRunning = (transaction && transaction->isRunning());
-
-            std::shared_ptr<Transaction> transaction_sp = nullptr;
-            if (context.getConnectorStatus(connectorId)) {
-                transaction_sp = context.getConnectorStatus(connectorId)->getTransaction();
-            }
-
-            MeterValues *meterValues = nullptr;
-            if (!sampledData.empty()) {
-                meterValues = new MeterValues(std::move(sampledData), connectorId, transaction_sp);
-                sampledData.clear();
-            }
-            lastSampleTime = ao_tick_ms();
-            return meterValues;
-        }
-
         if (ao_tick_ms() - lastSampleTime >= (ulong) (*MeterValueSampleInterval * 1000)) {
             auto sampleMeterValues = sampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SamplePeriodic);
             if (sampleMeterValues) {
-                sampledData.push_back(std::move(sampleMeterValues));
+                meterData.push_back(std::move(sampleMeterValues));
             }
 
-            if (stopTxnData) {
+            if (stopTxnData && ((const char*) *StopTxnDataCapturePeriodic && !strcmp(*StopTxnDataCapturePeriodic, "true"))) {
                 auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SamplePeriodic);
                 if (sampleStopTx) {
                     stopTxnData->addTxData(std::move(sampleStopTx));
@@ -163,9 +162,10 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
             }
             lastSampleTime = ao_tick_ms();
         }   
+    }
 
-    } else {
-        sampledData.clear();
+    if (*ClockAlignedDataInterval < 1 && *MeterValueSampleInterval < 1) {
+        meterData.clear();
     }
 
     return nullptr; //successful method completition. Currently there is no reason to send a MeterValues Msg.
@@ -179,10 +179,15 @@ OcppMessage *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
         return nullptr;
     }
 
-    decltype(sampledData) mv_now;
+    decltype(meterData) mv_now;
     mv_now.push_back(std::move(sample));
 
-    return new MeterValues(std::move(mv_now), connectorId);
+    std::shared_ptr<Transaction> transaction = nullptr;
+    if (context.getConnectorStatus(connectorId)) {
+        transaction = context.getConnectorStatus(connectorId)->getTransaction();
+    }
+
+    return new MeterValues(std::move(mv_now), connectorId, transaction);
 }
 
 void ConnectorMeterValuesRecorder::setPowerSampler(PowerSampler ps){
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index bc31ea9d..76d898c5 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -11,6 +11,7 @@
 
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 
 namespace ArduinoOcpp {
@@ -29,8 +30,7 @@ class ConnectorMeterValuesRecorder {
     const int connectorId;
     MeterStore& meterStore;
     
-    std::vector<std::unique_ptr<MeterValue>> sampledData;
-    std::vector<std::unique_ptr<MeterValue>> alignedData;
+    std::vector<std::unique_ptr<MeterValue>> meterData;
     std::shared_ptr<TransactionMeterData> stopTxnData;
 
     std::unique_ptr<MeterValueBuilder> sampledDataBuilder;
@@ -45,8 +45,8 @@ class ConnectorMeterValuesRecorder {
 
     ulong lastSampleTime = 0; //0 means not charging right now
     OcppTimestamp nextAlignedTime;
+    std::shared_ptr<Transaction> transaction;
     bool trackTxRunning = false;
-    int trackTxNr = -1;
  
     PowerSampler powerSampler = nullptr;
     EnergySampler energySampler = nullptr;
@@ -54,12 +54,12 @@ class ConnectorMeterValuesRecorder {
     int energySamplerIndex {-1};
 
     std::shared_ptr<Configuration<int>> MeterValueSampleInterval;
-    std::shared_ptr<Configuration<int>> MeterValuesSampledDataMaxLength;
-    std::shared_ptr<Configuration<int>> StopTxnSampledDataMaxLength;
+    std::shared_ptr<Configuration<int>> MeterValueCacheSize;
 
     std::shared_ptr<Configuration<int>> ClockAlignedDataInterval;
-    std::shared_ptr<Configuration<int>> MeterValuesAlignedDataMaxLength;
-    std::shared_ptr<Configuration<int>> StopTxnAlignedDataMaxLength;
+
+    std::shared_ptr<Configuration<const char*>> MeterValuesInTxOnly;
+    std::shared_ptr<Configuration<const char*>> StopTxnDataCapturePeriodic;
 public:
     ConnectorMeterValuesRecorder(OcppModel& context, int connectorId, MeterStore& meterStore);
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index ba2d89eb..d03c92ab 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -82,7 +82,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
 
     size_t msize;
     if (filesystem->stat(fn, &msize) != 0) {
-        AO_DBG_DEBUG("tx does not exist");
+        AO_DBG_DEBUG("%u-%u does not exist", connectorId, txNr);
         return nullptr;
     }
 

From 1d8f8a7d4b5874519611d123cf8f655f50ab31ec Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 15 Nov 2022 10:02:29 +0100
Subject: [PATCH 126/549] update README

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index d27fd202..8f4ed53c 100644
--- a/README.md
+++ b/README.md
@@ -12,13 +12,13 @@ Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
 Fully integrated into the Arduino platform and the ESP32 / ESP8266. Compatible with ESP-IDF, FreeRTOS and generic embedded C/C++ platforms.
 
-## Make your EVSE ready for OCPP-based charging networks :car::electric_plug::battery:
+## Make your EVSE ready for OCPP :car::electric_plug::battery:
 
 This library allows your EVSE to communicate with an OCPP Backend and to participate in commercial charging networks. You can integrate it into an existing firmware development, or start a new EVSE project from scratch with it.
 
 :heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve), [The Mobility House OCPP package](https://github.com/mobilityhouse/ocpp) and further commercial Central Systems
 
-:heavy_check_mark: Flexible API for customizable EVSE projects. Tested in many charging stations
+:heavy_check_mark: Tested in many charging stations
 
 :heavy_check_mark: Eligible for **public chargers** (Eichrecht-compliant)
 

From dca417261a3635c579b9aaf8b482ddbda5a84b8b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 18 Nov 2022 17:30:38 +0100
Subject: [PATCH 127/549] general API update (naming + multiple connectors)

---
 README.md                                     |   4 +-
 examples/ESP/main.cpp                         |  76 +--
 examples/SECC/main.cpp                        |  12 +-
 src/ArduinoOcpp.cpp                           | 515 +++++++++---------
 src/ArduinoOcpp.h                             | 318 +++++++----
 src/ArduinoOcpp/Core/ConfigurationOptions.h   |  20 +
 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp |   2 +-
 src/ArduinoOcpp_c.cpp                         | 300 ++++++----
 src/ArduinoOcpp_c.h                           | 140 +++--
 9 files changed, 835 insertions(+), 552 deletions(-)

diff --git a/README.md b/README.md
index 8f4ed53c..3782dd77 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 [![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
 
-OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Runs on Espressif, NXP, Texas Instruments, STM and embedded Linux.
+OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Runs on Espressif, NXP, Texas Instruments and STM.
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
 
@@ -20,7 +20,7 @@ This library allows your EVSE to communicate with an OCPP Backend and to partici
 
 :heavy_check_mark: Tested in many charging stations
 
-:heavy_check_mark: Eligible for **public chargers** (Eichrecht-compliant)
+:heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
 ### Features
 
diff --git a/examples/ESP/main.cpp b/examples/ESP/main.cpp
index b402082e..d1149bc2 100644
--- a/examples/ESP/main.cpp
+++ b/examples/ESP/main.cpp
@@ -23,11 +23,11 @@ ESP8266WiFiMulti WiFiMulti;
 #define OCPP_URL "ws://echo.websocket.events/"
 
 //
-////  Settings which worked for my SteVe instance
+//  Settings which worked for my SteVe instance:
 //
 //#define OCPP_HOST "my.instance.com"
 //#define OCPP_PORT 80
-//#define OCPP_URL "ws://my.instance.com/steve/websocket/CentralSystemService/gpio-based-charger"
+//#define OCPP_URL "ws://my.instance.com/steve/websocket/CentralSystemService/esp-charger"
 
 void setup() {
 
@@ -36,7 +36,6 @@ void setup() {
      */ 
 
     Serial.begin(115200);
-    Serial.setDebugOutput(true);
 
     Serial.print(F("[main] Wait for WiFi: "));
 
@@ -56,7 +55,7 @@ void setup() {
 #error only ESP32 or ESP8266 supported at the moment
 #endif
 
-    Serial.print(F(" connected!\n"));
+    Serial.println(F(" connected!"));
 
     /*
      * Initialize the OCPP library
@@ -66,19 +65,18 @@ void setup() {
     /*
      * Integrate OCPP functionality. You can leave out the following part if your EVSE doesn't need it.
      */
-    setPowerActiveImportSampler([]() {
-        //measure the input power of the EVSE here and return the value in Watts
+    setEnergyMeterInput([]() {
+        //take the energy register of the main electricity meter and return the value in watt-hours
         return 0.f;
     });
 
-    setOnChargingRateLimitChange([](float limit) {
+    setSmartChargingOutput([](float limit) {
         //set the SAE J1772 Control Pilot value here
-        Serial.print(F("[main] Smart Charging allows maximum charge rate: "));
-        Serial.println(limit);
+        Serial.printf("[main] Smart Charging allows maximum charge rate: %.0f\n", limit);
     });
 
-    setEvRequestsEnergySampler([]() {
-        //return true if the EV is in state "Ready for charging" (see https://en.wikipedia.org/wiki/SAE_J1772#Control_Pilot)
+    setConnectorPluggedInput([]() {
+        //return true if an EV is plugged to this EVSE
         return false;
     });
 
@@ -110,33 +108,39 @@ void loop() {
      * Detect if something physical happened at your EVSE and trigger the corresponding OCPP messages
      */
     if (/* RFID chip detected? */ false) {
-        const char *idTag = "0123456789abcd"; //e.g. idTag = RFID.readIdTag();
-        authorize(idTag, [] (JsonObject response) {
-            //check if user with idTag is authorized
-            if (!strcmp("Accepted", response["idTagInfo"]["status"] | "Invalid")){
-                Serial.println(F("[main] User is authorized to start charging"));
+        String idTag = "0123456789ABCD"; //e.g. idTag = RFID.readIdTag();
+
+        if (!getTransactionIdTag()) {
+            //no idTag registered yet. Start a new transaction
+
+            authorize(idTag.c_str(), [idTag] (JsonObject response) {
+                //check if user with idTag is authorized
+                if (!strcmp("Accepted", response["idTagInfo"]["status"] | "Invalid")){
+                    Serial.println(F("[main] User is authorized to start a transaction"));
+
+                    auto ret = beginTransaction(idTag.c_str()); //begin Tx locally
+
+                    if (ret) {
+                        Serial.println(F("[main] Transaction initiated. StartTransaction will be sent when ConnectorPlugged Input becomes true"));
+                    } else {
+                        Serial.println(F("[main] No transaction initiated"));
+                    }
+                } else {
+                    Serial.printf("[main] Authorize denied. Reason: %s\n", response["idTagInfo"]["status"] | "");
+                }
+            });
+            Serial.printf("[main] Authorizing user with idTag %s\n", idTag.c_str());
+        } else {
+            //Transaction already initiated. Check if to stop current Tx by RFID card
+            if (idTag.equals(getTransactionIdTag())) {
+                //card matches -> user can stop Tx
+                Serial.println(F("[main] End transaction by RFID card"));
+
+                endTransaction();
             } else {
-                Serial.printf("[main] Authorize denied. Reason: %s\n", response["idTagInfo"]["status"] | "");
+                Serial.println(F("[main] Cannot end transaction by RFID card (different card?)"));
             }
-        });
-        Serial.printf("[main] Authorizing user with idTag %s\n", idTag);
-    }
-    
-    if (/* EV plugged in and user authorized? */ false) {
-        const char *idTag = "0123456789abcd"; //e.g. authorized idTag from above
-        startTransaction(idTag, [] (JsonObject response) {
-            //Callback: Central System has answered. Could flash a confirmation light here.
-            Serial.printf("[main] Started OCPP transaction. Status: %s, transactionId: %u\n",
-                    response["idTagInfo"]["status"] | "Invalid",
-                    response["transactionId"] | -1);
-        });
-    }
-    
-    if (/* EV unplugged? */ false) {
-        stopTransaction([] (JsonObject response) {
-            //Callback: Central System has answered.
-            Serial.print(F("[main] Stopped OCPP transaction\n"));
-        });
+        }
     }
 
     //... see ArduinoOcpp.h for more possibilities
diff --git a/examples/SECC/main.cpp b/examples/SECC/main.cpp
index 97d4cf25..ff98eb57 100644
--- a/examples/SECC/main.cpp
+++ b/examples/SECC/main.cpp
@@ -155,7 +155,7 @@ void setup() {
      * This snippet also shows how to integrate a custom filesystem. Just subclass FilesystemAdapter and pass
      * it to the library
      */
-    std::shared_ptr<ArduinoOcpp::FilesystemAdapter> filesystem = ArduinoOcpp::EspWiFi::makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
+    std::shared_ptr<ArduinoOcpp::FilesystemAdapter> filesystem = ArduinoOcpp::makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
     ArduinoOcpp::configuration_init(filesystem);
 
     /*
@@ -226,7 +226,7 @@ void setup() {
     /*
      * Integrate OCPP functionality. You can leave out the following part if your EVSE doesn't need it.
      */
-    setEnergyActiveImportSampler([]() {
+    setEnergyMeterInput([]() {
         //read the energy input register of the EVSE here and return the value in Wh
         /*
          * Approximated value. Replace with real reading
@@ -239,7 +239,7 @@ void setup() {
         return energyMeter;
     });
 
-    setOnChargingRateLimitChange([](float limit) {
+    setSmartChargingOutput([](float limit) {
         //set the SAE J1772 Control Pilot value here
         const float voltage = 230.f; // European grid
         const uint nPhases = 1; //one, two or three phase charging
@@ -263,12 +263,12 @@ void setup() {
 #endif
     });
 
-    setEvRequestsEnergySampler([]() {
+    setEvReadyInput([]() {
         //return true if the EV is in state "Ready for charging" (see https://en.wikipedia.org/wiki/SAE_J1772#Control_Pilot)
         return digitalRead(EV_CHARGE_PIN) == EV_CHARGING;
     });
 
-    addConnectorErrorCodeSampler([] () {
+    addErrorCodeInput([] () {
         //Uncomment if Ground fault pin is used
         //if (digitalRead(EVSE_GROUND_FAULT_PIN) != EVSE_GROUND_CLEAR) {
         //    return "GroundFault";
@@ -337,7 +337,7 @@ void loop() {
     auto readEvPlugged = digitalRead(EV_PLUG_PIN);
     if (evPlugged == EV_UNPLUGGED && readEvPlugged == EV_PLUGGED //transition from unplugged to plugged
                 && getTransactionId() < 0  //no transaction yet
-                && isAvailable()) {        //EVSE is in operative mode
+                && isOperative()) {        //EVSE is in operative mode
         startTransaction("my-id-tag");
     } else if (evPlugged == EV_PLUGGED && readEvPlugged == EV_UNPLUGGED //transition from plugged to unplugged
                 && getTransactionId() >= 0) { //need to stop transaction
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 47619ce1..bd7b64a8 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -41,7 +41,6 @@ float voltage_eff {230.f};
 #define OCPP_NUMCONNECTORS 2
 #endif
 
-#define OCPP_ID_OF_CONNECTOR 1
 #define OCPP_ID_OF_CP 0
 bool OCPP_booted = false; //if BootNotification succeeded
 
@@ -53,7 +52,7 @@ using namespace ArduinoOcpp::Facade;
 using namespace ArduinoOcpp::Ocpp16;
 
 #ifndef AO_CUSTOM_WS
-void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt, ArduinoOcpp::OcppClock system_time) {
+void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
     if (ocppEngine) {
         AO_DBG_WARN("Can't be called two times. Either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -81,7 +80,7 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
 }
 #endif
 
-void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt, ArduinoOcpp::OcppClock system_time) {
+void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
     if (ocppEngine) {
         AO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -97,7 +96,7 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
     
     configuration_init(filesystem); //call before each other library call
 
-    ocppEngine = new OcppEngine(ocppSocket, system_time, filesystem);
+    ocppEngine = new OcppEngine(ocppSocket, Clocks::DEFAULT_CLOCK, filesystem);
     auto& model = ocppEngine->getOcppModel();
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
@@ -173,71 +172,254 @@ void OCPP_loop() {
 
 }
 
-void setPowerActiveImportSampler(std::function<float()> power) {
+void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    
+    auto credentials = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+        JSON_OBJECT_SIZE(2) + strlen(chargePointModel) + strlen(chargePointVendor) + 2));
+    (*credentials)["chargePointModel"] = (char*) chargePointModel;
+    (*credentials)["chargePointVendor"] = (char*) chargePointVendor;
+
+    bootNotification(std::move(credentials), onConf, onAbort, onTimeout, onError, std::move(timeout));
+}
+
+void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
+    auto bootNotification = makeOcppOperation(
+        new BootNotification(std::move(payload)));
+    if (onConf)
+        bootNotification->setOnReceiveConfListener(onConf);
+    if (onAbort)
+        bootNotification->setOnAbortListener(onAbort);
+    if (onTimeout)
+        bootNotification->setOnTimeoutListener(onTimeout);
+    if (onError)
+        bootNotification->setOnReceiveErrorListener(onError);
+    if (timeout)
+        bootNotification->setTimeout(std::move(timeout));
+    else
+        bootNotification->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
+    ocppEngine->initiateOperation(std::move(bootNotification));
+}
+
+void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
+        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        return;
+    }
+    auto authorize = makeOcppOperation(
+        new Authorize(idTag));
+    if (onConf)
+        authorize->setOnReceiveConfListener(onConf);
+    if (onAbort)
+        authorize->setOnAbortListener(onAbort);
+    if (onTimeout)
+        authorize->setOnTimeoutListener(onTimeout);
+    if (onError)
+        authorize->setOnReceiveErrorListener(onError);
+    if (timeout)
+        authorize->setTimeout(std::move(timeout));
+    else
+        authorize->setTimeout(std::unique_ptr<Timeout>(new FixedTimeout(20000)));
+    ocppEngine->initiateOperation(std::move(authorize));
+}
+
+bool beginTransaction(const char *idTag, uint connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return false;
+    }
+    if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
+        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        return false;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return false;
+    }
+    connector->beginSession(idTag);
+    return true;
+}
 
+bool endTransaction(const char *reason, uint connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return false;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return false;
+    }
+    bool res = connector->getSessionIdTag();
+    connector->endSession(reason);
+    return res;
+}
+
+bool isTransactionRunning(uint connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return false;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return false;
+    }
+    return connector->isTransactionRunning();
+}
+
+bool ocppPermitsCharge(uint connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_WARN("Please call OCPP_initialize before");
+        return false;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return false;
+    }
+    return connector->ocppPermitsCharge();
+}
+
+void setConnectorPluggedInput(std::function<bool()> pluggedInput, uint connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+    connector->setConnectorPluggedSampler(pluggedInput);
+
+    if (pluggedInput) {
+        AO_DBG_INFO("Added ConnectorPluggedSampler. Transaction-management is in auto mode now");
+    } else {
+        AO_DBG_INFO("Reset ConnectorPluggedSampler. Transaction-management is in manual mode now");
+    }
+}
+
+void setEnergyMeterInput(std::function<float()> energyInput, uint connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
     auto& model = ocppEngine->getOcppModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
             new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
-    meterProperties.setMeasurand("Power.Active.Import");
-    meterProperties.setUnit("W");
+    meterProperties.setMeasurand("Energy.Active.Import.Register");
+    meterProperties.setUnit("Wh");
     auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
                            new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
             meterProperties,
-            [power] (ReadingContext) {return power();}
+            [energyInput] (ReadingContext) {return energyInput();}
     ));
-    model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(mvs)); //connectorId=1
-    model.getMeteringService()->setPowerSampler(OCPP_ID_OF_CONNECTOR, power);
+    model.getMeteringService()->addMeterValueSampler(connectorId, std::move(mvs));
+    model.getMeteringService()->setEnergySampler(connectorId, energyInput);
 }
 
-void setEnergyActiveImportSampler(std::function<float()> energy) {
+void setPowerMeterInput(std::function<float()> powerInput, uint connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
+
     auto& model = ocppEngine->getOcppModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
             new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
-    meterProperties.setMeasurand("Energy.Active.Import.Register");
-    meterProperties.setUnit("Wh");
+    meterProperties.setMeasurand("Power.Active.Import");
+    meterProperties.setUnit("W");
     auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
                            new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
             meterProperties,
-            [energy] (ReadingContext) {return energy();}
+            [powerInput] (ReadingContext) {return powerInput();}
     ));
-    model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(mvs)); //connectorId=1
-    model.getMeteringService()->setEnergySampler(OCPP_ID_OF_CONNECTOR, energy);
+    model.getMeteringService()->addMeterValueSampler(connectorId, std::move(mvs));
+    model.getMeteringService()->setPowerSampler(connectorId, powerInput);
 }
 
-void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
+void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, uint connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
+    if (connectorId != 1) {
+        AO_DBG_WARN("Smart charging for multiple connectorId %u not implemented yet", connectorId);
+        return;
+    }
     auto& model = ocppEngine->getOcppModel();
-    if (!model.getMeteringService()) {
-        model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
+    if (!model.getSmartChargingService()) {
+        model.setSmartChargingService(std::unique_ptr<SmartChargingService>(
+            new SmartChargingService(*ocppEngine, 11000.0f, voltage_eff, OCPP_NUMCONNECTORS, fileSystemOpt))); //default charging limit: 11kW
     }
-    model.getMeteringService()->addMeterValueSampler(OCPP_ID_OF_CONNECTOR, std::move(meterValueSampler)); //connectorId=1
+    model.getSmartChargingService()->setOnLimitChange(chargingLimitOutput);
 }
 
-void addMeterValueSampler(std::function<int32_t ()> value, const char *measurand, const char *unit, const char *location, const char *phase) {
+void setEvReadyInput(std::function<bool()> evReadyInput, uint connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+    connector->setEvRequestsEnergySampler(evReadyInput);
+}
 
-    if (!value) {
+void setEvseReadyInput(std::function<bool()> evseReadyInput, uint connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+    connector->setConnectorEnergizedSampler(evseReadyInput);
+}
+
+void addErrorCodeInput(std::function<const char *()> errorCodeInput, uint connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+    connector->addConnectorErrorCodeSampler(errorCodeInput);
+}
+
+void addMeterValueInput(std::function<int32_t ()> valueInput, uint connectorId, const char *measurand, const char *unit, const char *location, const char *phase) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+
+    if (!valueInput) {
         AO_DBG_ERR("value undefined");
         return;
     }
@@ -260,118 +442,125 @@ void addMeterValueSampler(std::function<int32_t ()> value, const char *measurand
     auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
                                     new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
                 properties,
-                [value] (ArduinoOcpp::ReadingContext) -> int32_t {return value();}));
-    addMeterValueSampler(std::move(valueSampler));
+                [valueInput] (ArduinoOcpp::ReadingContext) -> int32_t {return valueInput();}));
+    addMeterValueInput(std::move(valueSampler), connectorId);
 }
 
-void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
+void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, uint connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
-    if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return;
+    auto& model = ocppEngine->getOcppModel();
+    if (!model.getMeteringService()) {
+        model.setMeteringSerivce(std::unique_ptr<MeteringService>(
+            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
     }
-    connector->setEvRequestsEnergySampler(evRequestsEnergy);
+    model.getMeteringService()->addMeterValueSampler(connectorId, std::move(valueInput));
 }
 
-void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized) {
+void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, uint connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->setConnectorEnergizedSampler(connectorEnergized);
+    connector->setOnUnlockConnector(onUnlockConnectorInOut);
 }
 
-void setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
+void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnectorInOut, uint connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->setConnectorPluggedSampler(connectorPlugged);
-
-    if (connectorPlugged) {
-        AO_DBG_INFO("Added ConnectorPluggedSampler. Transaction-management is in auto mode now");
-    } else {
-        AO_DBG_INFO("Reset ConnectorPluggedSampler. Transaction-management is in manual mode now");
-    }
+    connector->setConnectorLock(lockConnectorInOut);
 }
 
-void addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode) {
+void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> txMeterInOut, uint connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->addConnectorErrorCodeSampler(connectorErrorCode);
+    connector->setTxBasedMeterUpdate(txMeterInOut);
 }
 
-void setOnChargingRateLimitChange(std::function<void(float)> chargingRateChanged) {
+bool isOperative(uint connectorId) {
     if (!ocppEngine) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
+        AO_DBG_WARN("Please call OCPP_initialize before");
+        return true; //assume "true" as default state
     }
     auto& model = ocppEngine->getOcppModel();
-    if (!model.getSmartChargingService()) {
-        model.setSmartChargingService(std::unique_ptr<SmartChargingService>(
-            new SmartChargingService(*ocppEngine, 11000.0f, voltage_eff, OCPP_NUMCONNECTORS, fileSystemOpt))); //default charging limit: 11kW
+    auto chargePoint = model.getConnectorStatus(OCPP_ID_OF_CP);
+    auto connector = model.getConnectorStatus(connectorId);
+    if (!chargePoint || !connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return true; //assume "true" as default state
     }
-    model.getSmartChargingService()->setOnLimitChange(chargingRateChanged);
+    return (chargePoint->getAvailability() != AVAILABILITY_INOPERATIVE)
+       &&  (connector->getAvailability() != AVAILABILITY_INOPERATIVE);
 }
 
-void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
+int getTransactionId(uint connectorId) {
     if (!ocppEngine) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
+        AO_DBG_WARN("Please call OCPP_initialize before");
+        return -1;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
-        return;
+        return -1;
     }
-    connector->setOnUnlockConnector(unlockConnector);
+    return connector->getTransactionId();
 }
 
-void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnector) {
+const char *getTransactionIdTag(uint connectorId) {
     if (!ocppEngine) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
+        AO_DBG_WARN("Please call OCPP_initialize before");
+        return nullptr;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
-        return;
+        return nullptr;
     }
-    connector->setConnectorLock(lockConnector);
+    return connector->getSessionIdTag();
 }
 
-void setTxBasedMeterUpdate(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> updateTxState) {
+#if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
+ArduinoOcpp::FirmwareService *getFirmwareService() {
+    auto& model = ocppEngine->getOcppModel();
+    return model.getFirmwareService();
+}
+#endif
+
+#if defined(AO_CUSTOM_DIAGNOSTICS) || defined(AO_CUSTOM_WS)
+ArduinoOcpp::DiagnosticsService *getDiagnosticsService() {
+    auto& model = ocppEngine->getOcppModel();
+    return model.getDiagnosticsService();
+}
+#endif
+
+OcppEngine *getOcppEngine() {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
-    if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return;
+        return nullptr;
     }
-    connector->setTxBasedMeterUpdate(updateTxState);
+
+    return ocppEngine;
 }
 
 void setOnSetChargingProfileRequest(OnReceiveReqListener onReceiveReq) {
@@ -379,7 +568,7 @@ void setOnSetChargingProfileRequest(OnReceiveReqListener onReceiveReq) {
 }
 
 void setOnRemoteStartTransactionSendConf(OnSendConfListener onSendConf) {
-    setOnRemoteStartTransactionSendConfListener(onSendConf);
+     setOnRemoteStartTransactionSendConfListener(onSendConf);
 }
 
 void setOnRemoteStopTransactionReceiveReq(OnReceiveReqListener onReceiveReq) {
@@ -394,71 +583,11 @@ void setOnResetSendConf(OnSendConfListener onSendConf) {
      setOnResetSendConfListener(onSendConf);
 }
 
-void setOnResetReceiveReq(OnReceiveReqListener onReceiveReq) {
+void setOnResetRequest(OnReceiveReqListener onReceiveReq) {
      setOnResetReceiveRequestListener(onReceiveReq);
 }
 
-void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
-    if (!ocppEngine) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-    if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
-        return;
-    }
-    auto authorize = makeOcppOperation(
-        new Authorize(idTag));
-    if (onConf)
-        authorize->setOnReceiveConfListener(onConf);
-    if (onAbort)
-        authorize->setOnAbortListener(onAbort);
-    if (onTimeout)
-        authorize->setOnTimeoutListener(onTimeout);
-    if (onError)
-        authorize->setOnReceiveErrorListener(onError);
-    if (timeout)
-        authorize->setTimeout(std::move(timeout));
-    else
-        authorize->setTimeout(std::unique_ptr<Timeout>(new FixedTimeout(20000)));
-    ocppEngine->initiateOperation(std::move(authorize));
-}
-
-void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
-    if (!ocppEngine) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-    
-    auto credentials = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-        JSON_OBJECT_SIZE(2) + strlen(chargePointModel) + strlen(chargePointVendor) + 2));
-    (*credentials)["chargePointModel"] = (char*) chargePointModel;
-    (*credentials)["chargePointVendor"] = (char*) chargePointVendor;
-
-    bootNotification(std::move(credentials), onConf, onAbort, onTimeout, onError, std::move(timeout));
-}
-
-void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
-    if (!ocppEngine) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-    auto bootNotification = makeOcppOperation(
-        new BootNotification(std::move(payload)));
-    if (onConf)
-        bootNotification->setOnReceiveConfListener(onConf);
-    if (onAbort)
-        bootNotification->setOnAbortListener(onAbort);
-    if (onTimeout)
-        bootNotification->setOnTimeoutListener(onTimeout);
-    if (onError)
-        bootNotification->setOnReceiveErrorListener(onError);
-    if (timeout)
-        bootNotification->setTimeout(std::move(timeout));
-    else
-        bootNotification->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
-    ocppEngine->initiateOperation(std::move(bootNotification));
-}
+#define OCPP_ID_OF_CONNECTOR 1
 
 bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
     if (!ocppEngine) {
@@ -482,7 +611,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         }
         transaction->setIdTag(idTag);
     } else {
-        beginSession(idTag); //request new transaction object
+        beginTransaction(idTag); //request new transaction object
         transaction = connector->getTransaction();
         if (!transaction) {
             AO_DBG_WARN("Transaction queue full");
@@ -553,115 +682,3 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
 
     return true;
 }
-
-int getTransactionId() {
-    if (!ocppEngine) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
-        return -1;
-    }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
-    if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return -1;
-    }
-    return connector->getTransactionId();
-}
-
-bool ocppPermitsCharge() {
-    if (!ocppEngine) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
-        return false;
-    }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
-    if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return false;
-    }
-    return connector->ocppPermitsCharge();
-}
-
-bool isAvailable() {
-    if (!ocppEngine) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
-        return true; //assume "true" as default state
-    }
-    auto& model = ocppEngine->getOcppModel();
-    auto chargePoint = model.getConnectorStatus(OCPP_ID_OF_CP);
-    auto connector = model.getConnectorStatus(OCPP_ID_OF_CONNECTOR);
-    if (!chargePoint || !connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return true; //assume "true" as default state
-    }
-    return (chargePoint->getAvailability() != AVAILABILITY_INOPERATIVE)
-       &&  (connector->getAvailability() != AVAILABILITY_INOPERATIVE);
-}
-
-void beginSession(const char *idTag) {
-    if (!ocppEngine) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-    if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
-        return;
-    }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
-    if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return;
-    }
-    connector->beginSession(idTag);
-}
-
-void endSession(const char *reason) {
-    if (!ocppEngine) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
-    if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return;
-    }
-    connector->endSession(reason);
-}
-
-bool isInSession() {
-    return getSessionIdTag() != nullptr;
-}
-
-const char *getSessionIdTag() {
-    if (!ocppEngine) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
-        return nullptr;
-    }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
-    if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return nullptr;
-    }
-    return connector->getSessionIdTag();
-}
-
-#if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
-ArduinoOcpp::FirmwareService *getFirmwareService() {
-    auto& model = ocppEngine->getOcppModel();
-    return model.getFirmwareService();
-}
-#endif
-
-#if defined(AO_CUSTOM_DIAGNOSTICS) || defined(AO_CUSTOM_WS)
-ArduinoOcpp::DiagnosticsService *getDiagnosticsService() {
-    auto& model = ocppEngine->getOcppModel();
-    return model.getDiagnosticsService();
-}
-#endif
-
-OcppEngine *getOcppEngine() {
-    if (!ocppEngine) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return nullptr;
-    }
-
-    return ocppEngine;
-}
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index b44c0d10..fbe36197 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -28,154 +28,236 @@ using ArduinoOcpp::OnReceiveErrorListener;
 using ArduinoOcpp::Timeout;
 
 #ifndef AO_CUSTOM_WS
-//uses links2004/WebSockets library
-void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, float V_eff = 230.f /*German grid*/, ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail, ArduinoOcpp::OcppClock system_time = ArduinoOcpp::Clocks::DEFAULT_CLOCK);
+//use links2004/WebSockets library
+
+/*
+ * Initialize the library with the OCPP URL, EVSE voltage and filesystem configuration.
+ * 
+ * If the connections fails, please refer to 
+ * https://github.com/matth-x/ArduinoOcpp/issues/36#issuecomment-989716573 for recommendations on
+ * how to track down the issue with the connection.
+ * 
+ * This is a convenience function only available for Arduino. For a full initialization with TLS,
+ * please refer to https://github.com/matth-x/ArduinoOcpp/tree/master/examples/ESP-TLS
+ */
+void OCPP_initialize(
+            const char *CS_hostname, //e.g. "example.com"
+            uint16_t CS_port,        //e.g. 80
+            const char *CS_url,      //e.g. "ws://example.com/steve/websocket/CentralSystemService/charger001"
+            float V_eff = 230.f,     //Grid voltage of your country. e.g. 230.f (European voltage)
+            ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 #endif
 
-//Lets you use your own WebSocket implementation
-void OCPP_initialize(ArduinoOcpp::OcppSocket& ocppSocket, float V_eff = 230.f /*European grid*/, ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail, ArduinoOcpp::OcppClock system_time = ArduinoOcpp::Clocks::DEFAULT_CLOCK);
+/*
+ * Initialize the library with a WebSocket connection which is configured with protocol=ocpp1.6
+ * (=OcppSocket), EVSE voltage and filesystem configuration. This library requires that you handle
+ * establishing the connection and keeping it alive. Please refer to
+ * https://github.com/matth-x/ArduinoOcpp/tree/master/examples/ESP-TLS for an example how to use it.
+ * 
+ * This GitHub project also delivers an OcppSocket implementation based on links2004/WebSockets. If
+ * you need another WebSockets implementation, you can subclass the OcppSocket class and pass it to
+ * this initialize() function. Please refer to
+ * https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/MongooseOcppSocketClient.cpp for
+ * an example.
+ */
+void OCPP_initialize(
+            ArduinoOcpp::OcppSocket& ocppSocket, //WebSocket adapter for ArduinoOcpp
+            float V_eff = 230.f,                 //Grid voltage of your country. e.g. 230.f (European voltage)
+            ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
-//experimental; More testing required (help needed: it would be awesome if you can you publish your evaluation results on the GitHub page)
+/*
+ * Stop the OCPP library and release allocated resources.
+ */
 void OCPP_deinitialize();
 
+/*
+ * To be called in the main loop (e.g. place it inside loop())
+ */
 void OCPP_loop();
 
 /*
- * Provide hardware-related information to the library
+ * Send OCPP operations.
+ * 
+ * You only need to send the following operation types manually:
+ *     - BootNotification: Notify the OCPP server that this EVSE is ready and start the OCPP
+ *           routines.
+ *     - Authorize: Validate an RFID tag before using it for a transaction
+ * 
+ * All other operation types are handled automatically by this library.
+ * 
+ * On receipt of the .conf() response the library calls the callback function
+ * "OnReceiveConfListener onConf" and passes the OCPP payload to it.
  * 
- * The library needs a way to obtain information from your charger that changes over time. The
- * library calls following callbacks regularily (if they were set) to refresh its internal
- * status.
+ * For your first EVSE integration, the `onReceiveConfListener` is probably sufficient. For
+ * advanced EVSE projects, the other listeners likely become relevant:
+ * - `onAbortListener`: will be called whenever the engine stops trying to finish an operation
+ *           normally which was initiated by this device.
+ * - `onTimeoutListener`: will be executed when the operation is not answered until the timeout
+ *           expires. Note that timeouts also trigger the `onAbortListener`.
+ * - `onReceiveErrorListener`: will be called when the Central System returns a CallError.
+ *           Again, each error also triggers the `onAbortListener`.
  * 
- * Set the callbacks once in your setup() function.
+ * The functions for sending OCPP operations are non-blocking. The program will resume immediately
+ * with the code after with the subsequent code in any case.
  */
 
-void setPowerActiveImportSampler(std::function<float()> power);
-
-void setEnergyActiveImportSampler(std::function<float()> energy);
-
-void addMeterValueSampler(std::unique_ptr<ArduinoOcpp::SampledValueSampler> meterValueSampler);
-void addMeterValueSampler(std::function<int32_t ()> value, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr);
-
-void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy);
-
-void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized);
-
-void setConnectorPluggedSampler(std::function<bool()> connectorPlugged);
-
-void addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode);
+void bootNotification(
+            const char *chargePointModel,                //model name of the EVSE
+            const char *chargePointVendor,               //vendor name
+            OnReceiveConfListener onConf = nullptr,      //callback (confirmation received)
+            OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
+            OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
+            OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
+            std::unique_ptr<Timeout> timeout = nullptr); //custom timeout behavior, optional
+
+//Alternative version for sending a complete BootNotification payload
+void bootNotification(
+            std::unique_ptr<DynamicJsonDocument> payload,//manually defined payload
+            OnReceiveConfListener onConf = nullptr,      //callback (confirmation received)
+            OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
+            OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
+            OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
+            std::unique_ptr<Timeout> timeout = nullptr); //custom timeout behavior, optional
+
+void authorize(
+            const char *idTag,                           //RFID tag (e.g. ISO 14443 UID tag with 4 or 7 bytes)
+            OnReceiveConfListener onConf = nullptr,      //callback (confirmation received)
+            OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
+            OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
+            OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
+            std::unique_ptr<Timeout> timeout = nullptr); //custom timeout behavior, optional
 
 /*
- * React on calls by the library's internal functions
+ * Transaction management.
  * 
- * The library needs to set parameters on your charger on a regular basis or perform
- * functions triggered by the central system. The library uses the following callbacks
- * (if they were set) to perform updates or functions on your charger.
+ * Begin the transaction process by creating a new transaction and setting its user identification.
+ * The OCPP library will try to send a StartTransaction request with all data as soon as possible
+ * after all requirements for a transaction are met (i.e. the connector is plugged).
  * 
- * Set the callbacks once in your setup() function.
+ * Returns true if it was possible to create a transaction. If it returned false, either another
+ * transaction is still running or you need to try it again later.
  */
+bool beginTransaction(const char *idTag, uint connectorId = 1);
 
-void setOnChargingRateLimitChange(std::function<void(float)> chargingRateChanged);
-
-//Set a Cb to mechanically unlock the connector. Called for the OCPP operation "UnlockConnector"
-//Return values: true on success, false on failure, PollResult::Await if not known yet
-//Continues to call the Cb as long as it returns PollResult::Await
-void setOnUnlockConnector(std::function<ArduinoOcpp::PollResult<bool>()> unlockConnector);
+/*
+ * End the transaction process by terminating the transaction and setting a reason for its termination.
+ * Please refer to to OCPP 1.6 Specification - Edition 2 p. 90 for a list of valid reasons. "reason"
+ * can also be nullptr.
+ * 
+ * It is safe to call this function at any time, i.e. when no transaction runs or when the transaction
+ * has already been ended. For example you can place `endTransaction("Reboot");` in the beginning of
+ * the program just to ensure that there is no transaction from a previous run.
+ * 
+ * Returns true if this action actually ended a transaction. False otherwise
+ */
+bool endTransaction(const char *reason = nullptr, uint connectorId = 1);
 
-//Set a Cb for setting the state of the connector lock. Called in the course of normal transactions
-//Return values: - TxEnableState::Active if connector is locked and ready for transaction
-//               - TxEnableState::Inactive if connector lock is released
-//               - TxEnableState::Pending otherwise, e.g. if transitioning between the states
-//Called periodically
-void setConnectorLock(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnector);
+/*
+ * Returns if the library has started the transaction by sending a StartTransaction and if it hasn't
+ * been stopped already by sending a StopTransaction.
+ */
+bool isTransactionRunning(uint connectorId = 1);
 
-//Set a Cb to update transaction-based energy measurements with the most recent transaction state.
-//This allows energy meters to take their measruements right before and after a transaction
-//Return values: - TxEnableState::Active if the energy meter confirmed to be in the transaction-state
-//               - TxEnableState::Inactive if the energy meter has transitioned into a non-transaction-state
-//               - TxEnableState::Pending otherwise, e.g. if transitioning between the states
-//Called periodically
-void setTxBasedMeterUpdate(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> updateTxState);
+/* 
+ * Returns if the OCPP library allows the EVSE to charge at the moment.
+ *
+ * If you integrate it into a J1772 charger, true means that the Control Pilot can send the PWM signal
+ * and false means that the Control Pilot must be at a DC voltage.
+ */
+bool ocppPermitsCharge(uint connectorId = 1);
 
 /*
- * React on CS-initiated operations
+ * Define the Inputs and Outputs of this library.
+ * 
+ * This library interacts with the hardware of your charger by Inputs and Outputs. Inputs and Outputs
+ * are tiny function-objects which read information from the EVSE or control the behavior of the EVSE.
  * 
- * You can define custom behaviour in your integration which is executed every time the library
- * receives a CS-initiated operation. The following functions set a callback function for the
- * respective event. The library executes the callbacks always after its internal routines.
+ * An Input is a function which returns the current state of a variable of the EVSE. For example, if
+ * the energy meter stores the energy register in the global variable `e_reg`, then you can allow
+ * this library to read it by defining the Input 
+ *     `[] () {return e_reg;}`
+ * and passing it to the library.
  * 
- * Set the callbacks once in your setup() function.
+ * An Output is a function which gets a state value from the OCPP library and applies it to the EVSE.
+ * For example, to let Smart Charging control the PWM signal of the Control Pilot, define the Output
+ *     `[] (float p_max) {pwm = p_max / PWM_FACTOR;}` (simplified example)
+ * and pass it to the library.
+ * 
+ * Configure the library with Inputs and Outputs once in the setup() function.
  */
 
-void setOnSetChargingProfileRequest(OnReceiveReqListener onReceiveReq); //optional
+void setConnectorPluggedInput(std::function<bool()> pluggedInput, uint connectorId = 1); //Input about if an EV is plugged to this EVSE
 
-void setOnRemoteStartTransactionSendConf(OnSendConfListener onSendConf); //important, energize the power plug here and capture the idTag
+void setEnergyMeterInput(std::function<float()> energyInput, uint connectorId = 1); //Input of the electricity meter register
 
-void setOnRemoteStopTransactionSendConf(OnSendConfListener onSendConf); //important, de-energize the power plug here
-void setOnRemoteStopTransactionReceiveReq(OnReceiveReqListener onReceiveReq); //optional, to de-energize the power plug immediately
+void setPowerMeterInput(std::function<float()> powerInput, uint connectorId = 1); //Input of the power meter reading
 
-void setOnResetSendConf(OnSendConfListener onSendConf); //important, reset your device here (i.e. call ESP.reset();)
-void setOnResetReceiveReq(OnReceiveReqListener onReceiveReq); //alternative: start reset timer here
+void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, uint connectorId = 1); //Output for the Smart Charging limit
 
 /*
- * Perform CP-initiated operations
- * 
- * Use following functions to send OCPP messages. Each function will adapt the library's
- * internal state appropriatley (e.g. after a successful StartTransaction request the library
- * will store the transactionId and send a StatusNotification).
- * 
- * On receipt of the .conf() response the library calls the callback function
- * "OnReceiveConfListener onConf" and passes the OCPP payload to it. The following functions
- * are non-blocking. Your application code will immediately resume with the subsequent code
- * in any case.
+ * Define the Inputs and Outputs of this library. (Advanced)
  * 
- * For your first EVSE integration, the `onReceiveConfListener` is probably sufficient. For
- * advanced EVSE projects, the other listeners likely become relevant:
- * - `onAbortListener`: will be called whenever the engine stops trying to finish an operation
- *           normally which was initiated by this device.
- * - `onTimeoutListener`: will be executed when the operation is not answered until the timeout
- *           expires. Note that timeouts also trigger the `onAbortListener`.
- * - `onReceiveErrorListener`: will be called when the Central System returns a CallError.
- *           Again, each error also triggers the `onAbortListener`.
+ * These Inputs and Outputs are optional depending on the use case of your charger.
  */
 
-void authorize(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+void setEvReadyInput(std::function<bool()> evReadyInput, uint connectorId = 1); //Input if EV is ready to charge (= J1772 State C)
 
-void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+void setEvseReadyInput(std::function<bool()> evseReadyInput, uint connectorId = 1); //Input if EVSE allows charge (= PWM signal on)
 
-//The OCPP operation will include the given payload without modifying it. The library will delete the payload object after successful transmission.
-void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+void addErrorCodeInput(std::function<const char *()> errorCodeInput, uint connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
 
-bool startTransaction(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+void addMeterValueInput(std::function<int32_t ()> valueInput, uint connectorId = 1, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr); //integrate further metering Inputs
 
-bool stopTransaction(OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+void addMeterValueInput(std::unique_ptr<ArduinoOcpp::SampledValueSampler> valueInput, uint connectorId = 1); //integrate further metering Inputs (more extensive alternative)
 
 /*
- * Access information about the internal state of the library
+ * Set an InputOutput (reads and sets information at the same time) for forcing to unlock the
+ * connector. Called as part of the OCPP operation "UnlockConnector"
+ * Return values: true on success, false on failure, PollResult::Await if not known yet
+ * Continues to call the Cb as long as it returns PollResult::Await
  */
+void setOnUnlockConnectorInOut(std::function<ArduinoOcpp::PollResult<bool>()> onUnlockConnectorInOut, uint connectorId = 1);
 
-int getTransactionId(); //returns the ID of the current transaction. Returns -1 if called before or after an transaction
-
-bool ocppPermitsCharge();
+/*
+ * Set an Input/Output for setting the state of the connector lock. Called in the course of normal
+ * transactions (not as part of UnlockConnector).
+ * Param. values: 
+ *     - TxTrigger::Active if connector should be locked
+ *     - TxTrigger::Inactive if connector should be unlocked
+ * Return values:
+ *     - TxEnableState::Active if connector is locked and ready for transaction
+ *     - TxEnableState::Inactive if connector lock is released
+ *     - TxEnableState::Pending otherwise, e.g. if transitioning between the states
+ */
+void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnectorInOut, uint connectorId = 1);
 
-bool isAvailable(); //if the charge point is operative or inoperative
+/*
+ * Set an Input/Output to interact with a transaction-based energy meter. When this OCPP library is
+ * about to start a transaction, it toggles the Output to the energy meter to TxTrigger::Active so
+ * the energy meter can take a measurement right before a transaction. The same goes for the stop of
+ * transactions. With the Input, the energy meter signals if the measurement is ready and the
+ * transaction can finally start / stop.
+ * Param. values:
+ *     - TxTrigger::Active if the tx-based meter should be in transaction-mode
+ *     - TxTrigger::Inactive if the tx-based meter should be in non-transaction-mode
+ * Return values:
+ *     - TxEnableState::Active if the tx-based meter confirms to be in the transaction-mode
+ *     - TxEnableState::Inactive if the tx-based meter has transitioned into a non-transaction-mode
+ *     - TxEnableState::Pending otherwise, e.g. if transitioning between the states
+ */
+void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> txMeterInOut, uint connectorId = 1);
 
 /*
- * Session management
- *
- * A session begins when the EV user is authenticated against the OCPP system and intends to start the charging process.
- * The session ends as soon as the authentication expires or as soon as the EV user does not intend to charge anymore.
- * 
- * A session means that the EVSE does not need further input from the EV user or OCPP backend to start a transaction.
+ * Access further information about the internal state of the library
  */
 
-void beginSession(const char *idTag);
+bool isOperative(uint connectorId = 1); //if the charge point is operative or inoperative (see OCPP1.6 Edit2, p. 45)
 
-void endSession(const char *reason = nullptr);
+int getTransactionId(uint connectorId = 1); //returns the txId if known, -1 if no transaction is running and 0 if txId not assigned yet
 
-bool isInSession();
+const char *getTransactionIdTag(uint connectorId = 1); //returns the authorization token if applicable, or nullptr otherwise
 
-const char *getSessionIdTag();
+void setOnResetRequest(OnReceiveReqListener onReceiveReq);
 
 /*
  * Configure the device management
@@ -183,19 +265,24 @@ const char *getSessionIdTag();
 
 #if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
-// You need to configure this object if FW updates are relevant for you. This project already
-// brings a simple configuration for the ESP32 and ESP8266 for prototyping purposes, however
-// for the productive system you will have to develop a configuration targeting the specific
-// OCPP backend.
-// See  ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h 
+
+/*
+ * You need to configure this object if FW updates are relevant for you. This project already
+ * brings a simple configuration for the ESP32 and ESP8266 for prototyping purposes, however
+ * for the productive system you will have to develop a configuration targeting the specific
+ * OCPP backend.
+ * See ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h 
+ */
 ArduinoOcpp::FirmwareService *getFirmwareService();
 #endif
 
 #if defined(AO_CUSTOM_DIAGNOSTICS) || defined(AO_CUSTOM_WS)
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
-// This library implements the OCPP messaging side of Diagnostics, but no logging or the
-// log upload to your backend.
-// To integrate Diagnostics, see ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
+/*
+ * This library implements the OCPP messaging side of Diagnostics, but no logging or the
+ * log upload to your backend.
+ * To integrate Diagnostics, see ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
+ */
 ArduinoOcpp::DiagnosticsService *getDiagnosticsService();
 #endif
 
@@ -204,7 +291,24 @@ class OcppEngine;
 }
 
 //Get access to internal functions and data structures. The returned OcppEngine object allows
-//you to bypass the facace functions of this header and implement custom functionality.
+//you to bypass the facade functions of this header and implement custom functionality.
 ArduinoOcpp::OcppEngine *getOcppEngine();
 
+/*
+ * Deprecated functions or functions to be moved to ArduinoOcppExtended.h
+ */
+
+void setOnSetChargingProfileRequest(OnReceiveReqListener onReceiveReq); //optional
+
+void setOnRemoteStartTransactionSendConf(OnSendConfListener onSendConf);
+
+void setOnRemoteStopTransactionSendConf(OnSendConfListener onSendConf);
+void setOnRemoteStopTransactionReceiveReq(OnReceiveReqListener onReceiveReq);
+
+void setOnResetSendConf(OnSendConfListener onSendConf);
+
+bool startTransaction(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+
+bool stopTransaction(OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+
 #endif
diff --git a/src/ArduinoOcpp/Core/ConfigurationOptions.h b/src/ArduinoOcpp/Core/ConfigurationOptions.h
index b95ce96e..7897ff12 100644
--- a/src/ArduinoOcpp/Core/ConfigurationOptions.h
+++ b/src/ArduinoOcpp/Core/ConfigurationOptions.h
@@ -5,6 +5,19 @@
 #ifndef CONFIGURATIONOPTIONS_H
 #define CONFIGURATIONOPTIONS_H
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+struct AO_FilesystemOpt {
+    bool use = false;
+    bool mount = false;
+    bool formatFsOnFail = false;
+};
+
+#ifdef __cplusplus
+}
+
 namespace ArduinoOcpp {
 
 class FilesystemOpt{
@@ -31,6 +44,11 @@ class FilesystemOpt{
                 break;
         }
     }
+    FilesystemOpt(struct AO_FilesystemOpt fsopt) {
+        this->use = fsopt.use;
+        this->mount = fsopt.mount;
+        this->formatFsOnFail = fsopt.formatFsOnFail;
+    }
 
     bool accessAllowed() {return use;}
     bool mustMount() {return mount;}
@@ -39,4 +57,6 @@ class FilesystemOpt{
 
 } //end namespace ArduinoOcpp
 
+#endif //__cplusplus
+
 #endif
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
index e6a81b0f..3d8044d3 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
@@ -13,7 +13,7 @@
 #define AO_METERSTORE_DIR AO_FILENAME_PREFIX "/"
 #endif
 
-#define MAX_STOPTXDATA_LEN 20
+#define MAX_STOPTXDATA_LEN 10
 
 using namespace ArduinoOcpp;
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 69ae46e0..b7d5c076 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -5,200 +5,292 @@
 
 ArduinoOcpp::OcppSocket *ocppSocket = nullptr;
 
-extern "C" void ao_initialize(AOcppSocket *osock) {
-    //OCPP_initialize("echo.websocket.events", 80, "ws://echo.websocket.events/");
+void ao_initialize(AOcppSocket *osock,  float V_eff, struct AO_FilesystemOpt fsopt) {
     if (!osock) {
         AO_DBG_ERR("osock is null");
     }
-    AO_DBG_ERR("no error");
 
     ocppSocket = reinterpret_cast<ArduinoOcpp::OcppSocket*>(osock);
 
-    OCPP_initialize(*ocppSocket);
+    ArduinoOcpp::FilesystemOpt adaptFsopt = fsopt;
+
+    OCPP_initialize(*ocppSocket, V_eff, adaptFsopt);
+}
+
+void ao_deinitialize() {
+    OCPP_deinitialize();
 }
 
-extern "C" void ao_loop() {
+void ao_loop() {
     OCPP_loop();
 }
 
-extern "C" void ao_set_console_out_c(void (*console_out)(const char *msg)) {
-    ao_set_console_out(console_out);
+std::function<bool()> adaptFn(InputBool fn) {
+    return fn;
+}
+
+std::function<const char*()> adaptFn(InputString fn) {
+    return fn;
+}
+
+std::function<float()> adaptFn(InputFloat fn) {
+    return fn;
+}
+
+std::function<int()> adaptFn(InputInt fn) {
+    return fn;
+}
+
+std::function<void(float)> adaptFn(OutputFloat fn) {
+    return fn;
+}
+
+std::function<void(void)> adaptFn(void (*fn)(void)) {
+    return fn;
 }
 
 #ifndef AO_RECEIVE_PAYLOAD_BUFSIZE
-#define AO_RECEIVE_PAYLOAD_BUFSIZE 1024
+#define AO_RECEIVE_PAYLOAD_BUFSIZE 512
 #endif
 
 char ao_recv_payload_buff [AO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
 
-std::function<void(JsonObject)> adaptCb(OnOcppMessage cb) {
-    return [cb] (JsonObject payload) {
+std::function<void(JsonObject)> adaptFn(OnOcppMessage fn) {
+    return [fn] (JsonObject payload) {
         auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
             AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
         }
-        cb(len > 0 ? ao_recv_payload_buff : nullptr, len);
+        fn(len > 0 ? ao_recv_payload_buff : "", len);
     };
 }
 
-std::function<void()> adaptCb(void (*cb)()) {
-    return cb;
-}
-
-ArduinoOcpp::OnReceiveErrorListener adaptCb(OnOcppError cb) {
-    return [cb] (const char *code, const char *description, JsonObject details) {
+ArduinoOcpp::OnReceiveErrorListener adaptFn(OnOcppError fn) {
+    return [fn] (const char *code, const char *description, JsonObject details) {
         auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
             AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
         }
-        cb(code, description, len > 0 ? ao_recv_payload_buff : "", len);
+        fn(code, description, len > 0 ? ao_recv_payload_buff : "", len);
     };
 }
 
-std::function<bool()> adaptCb(SamplerBool cb) {
-    return cb;
+std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> adaptFn(TxStepInOut fn) {
+    return [fn] (ArduinoOcpp::TxTrigger trigger) -> ArduinoOcpp::TxEnableState {
+        auto res = fn(trigger == ArduinoOcpp::TxTrigger::Active ?
+                            TxTrg_Active : TxTrg_Inactive);
+        if (res == TxEna_Pending) {
+            return ArduinoOcpp::TxEnableState::Pending;
+        } else if (res == TxEna_Active) {
+            return ArduinoOcpp::TxEnableState::Active;
+        } else if (res == TxEna_Inactive) {
+            return ArduinoOcpp::TxEnableState::Inactive;
+        } else {
+            AO_DBG_ERR("illegal argument");
+            return ArduinoOcpp::TxEnableState::Inactive;
+        }
+    };
 }
 
-std::function<const char*()> adaptCb(SamplerString cb) {
-    return cb;
+void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    bootNotification(chargePointModel, chargePointVendor, adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
-std::function<float()> adaptCb(SamplerFloat cb) {
-    return cb;
-}
+void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(9) + 230 + 9)); // BootNotification has at most 9 attributes with at most 230 chars + null terminators
+    auto err = deserializeJson(*payload, payloadJson);
+    if (err) {
+        AO_DBG_ERR("Could not process input: %s", err.c_str());
+        (void)0;
+    }
 
-std::function<int()> adaptCb(SamplerInt cb) {
-    return cb;
+    bootNotification(std::move(payload), adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
-void ao_setPowerActiveImportSampler(SamplerFloat power) {
-    setPowerActiveImportSampler(adaptCb(power));
+void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    authorize(idTag, adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
-void ao_setEnergyActiveImportSampler(SamplerInt energy) {
-    setEnergyActiveImportSampler([energy] () -> float {
-        return (float) energy();
-    });
+void ao_beginTransaction(const char *idTag) {
+    ao_beginTransaction(idTag);
+}
+void ao_beginTransaction_m(const char *idTag, unsigned int connectorId) {
+    beginTransaction(idTag, 1);
 }
 
-void ao_addMeterValueSampler_Int(SamplerInt sampler, const char *measurand, const char *phase, const char *unit) {
-    
-    ArduinoOcpp::SampledValueProperties properties;
-    if (measurand)
-        properties.setMeasurand(measurand);
-    if (phase)
-        properties.setPhase(phase);
-    if (unit)
-        properties.setUnit(unit);
-    
-    auto adaptSampler = [sampler] (ArduinoOcpp::ReadingContext) -> int32_t {
-        return sampler();
-    };
-
-    auto reader =   new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(properties, adaptSampler);
-    addMeterValueSampler(
-        std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(reader));
+bool ao_endTransaction(const char *reason) {
+    return endTransaction(reason);
+}
+bool ao_endTransaction_m(const char *reason, unsigned int connectorId) {
+    return endTransaction(reason, connectorId);
 }
 
-void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy) {
-    setEvRequestsEnergySampler(adaptCb(evRequestsEnergy));
+bool ao_isTransactionRunning() {
+    return isTransactionRunning();
+}
+bool ao_isTransactionRunning_m(unsigned int connectorId) {
+    return isTransactionRunning(connectorId);
 }
 
-void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized) {
-    setConnectorEnergizedSampler(adaptCb(connectorEnergized));
+bool ao_ocppPermitsCharge() {
+    return ocppPermitsCharge();
+}
+bool ao_ocppPermitsCharge_m(unsigned int connectorId) {
+    return ocppPermitsCharge(connectorId);
 }
 
-void ao_setConnectorPluggedSampler(SamplerBool connectorPlugged) {
-    setConnectorPluggedSampler(adaptCb(connectorPlugged));
+void ao_setConnectorPluggedInput(InputBool pluggedInput) {
+    setConnectorPluggedInput(adaptFn(pluggedInput));
+}
+void ao_setConnectorPluggedInput_m(InputBool pluggedInput, unsigned int connectorId) {
+    setConnectorPluggedInput(adaptFn(pluggedInput), connectorId);
 }
 
-void ao_addConnectorErrorCodeSampler(SamplerString connectorErrorCode) {
-    addConnectorErrorCodeSampler(adaptCb(connectorErrorCode));
+void ao_setEnergyMeterInput(InputInt energyInput) {
+    setEnergyMeterInput(adaptFn(energyInput));
+}
+void ao_setEnergyMeterInput_m(InputInt energyInput, unsigned int connectorId) {
+    setEnergyMeterInput(adaptFn(energyInput), connectorId);
 }
 
-void ao_onChargingRateLimitChange(void (*chargingRateChanged)(float)) {
-    setOnChargingRateLimitChange(chargingRateChanged);
+void ao_setPowerMeterInput(InputFloat powerInput) {
+    setPowerMeterInput(adaptFn(powerInput));
+}
+void ao_setPowerMeterInput_m(InputFloat powerInput, unsigned int connectorId) {
+    setPowerMeterInput(adaptFn(powerInput), connectorId);
 }
 
-void ao_onUnlockConnector(SamplerBool unlockConnector) {
-    setOnUnlockConnector(adaptCb(unlockConnector));
+void ao_setSmartChargingOutput(OutputFloat chargingLimitOutput) {
+    setSmartChargingOutput(adaptFn(chargingLimitOutput));
+}
+void ao_setSmartChargingOutput_m(OutputFloat chargingLimitOutput, unsigned int connectorId) {
+    setSmartChargingOutput(adaptFn(chargingLimitOutput), connectorId);
 }
 
-void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf) {
-    setOnRemoteStopTransactionSendConf(adaptCb(onSendConf));
+void ao_setEvReadyInput(InputBool evReadyInput) {
+    setEvReadyInput(adaptFn(evReadyInput));
+}
+void ao_setEvReadyInput_m(InputBool evReadyInput, unsigned int connectorId) {
+    setEvReadyInput(adaptFn(evReadyInput), connectorId);
 }
 
-void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf) {
-    setOnRemoteStopTransactionSendConf(adaptCb(onSendConf));
+void ao_setEvseReadyInput(InputBool evseReadyInput) {
+    setEvseReadyInput(adaptFn(evseReadyInput));
+}
+void ao_setEvseReadyInput_m(InputBool evseReadyInput, unsigned int connectorId) {
+    setEvseReadyInput(adaptFn(evseReadyInput), connectorId);
 }
 
-void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest) {
-    setOnRemoteStopTransactionReceiveReq(adaptCb(onRequest));
+void ao_addErrorCodeInput(InputString errorCodeInput) {
+    addErrorCodeInput(adaptFn(errorCodeInput));
+}
+void ao_addErrorCodeInput_m(InputString errorCodeInput, unsigned int connectorId) {
+    addErrorCodeInput(adaptFn(errorCodeInput), connectorId);
 }
 
-void ao_onResetSendConf(OnOcppMessage onSendConf) {
-    setOnResetSendConf(adaptCb(onSendConf));
+void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
+    addMeterValueInput(adaptFn(valueInput), 1, measurand, unit, location, phase);
+}
+void ao_addMeterValueInputInt_m(InputInt valueInput, unsigned int connectorId, const char *measurand, const char *unit, const char *location, const char *phase) {
+    addMeterValueInput(adaptFn(valueInput), connectorId, measurand, unit, location, phase);
 }
 
-extern "C" void ao_onResetRequest(OnOcppMessage onRequest) {
-    setOnResetReceiveReq(adaptCb(onRequest));
+void ao_addMeterValueInput(MeterValueInput *meterValueInput) {
+    ao_addMeterValueInput_m(meterValueInput, 1);
+}
+void ao_addMeterValueInput_m(MeterValueInput *meterValueInput, unsigned int connectorId) {
+    auto svs = std::unique_ptr<ArduinoOcpp::SampledValueSampler>(
+        reinterpret_cast<ArduinoOcpp::SampledValueSampler*>(meterValueInput));
+    
+    addMeterValueInput(std::move(svs), connectorId);
+}
+
+void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut) {
+    ao_setOnUnlockConnectorInOut_m(onUnlockConnectorInOut, 1);
+}
+void ao_setOnUnlockConnectorInOut_m(PollBool onUnlockConnectorInOut, unsigned int connectorId) {
+    setOnUnlockConnectorInOut([onUnlockConnectorInOut] () -> ArduinoOcpp::PollResult<bool> {
+        auto res = onUnlockConnectorInOut();
+        if (res == OptionalTrue) {
+            return true;
+        } else if (res == OptionalFalse) {
+            return false;
+        } else if (res == OptionalUndefined) {
+            return ArduinoOcpp::PollResult<bool>::Await();
+        } else {
+            AO_DBG_ERR("illegal argument");
+            return false;
+        }
+    }, connectorId);
 }
 
-extern "C" void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    bootNotification("model", "vendor", adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+void ao_setConnectorLockInOut(TxStepInOut lockConnectorInOut) {
+    setConnectorLockInOut(adaptFn(lockConnectorInOut));
+}
+void ao_setConnectorLockInOut_m(TxStepInOut lockConnectorInOut, unsigned int connectorId) {
+    setConnectorLockInOut(adaptFn(lockConnectorInOut), connectorId);
 }
 
-void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    DynamicJsonDocument *payload = new DynamicJsonDocument(JSON_OBJECT_SIZE(9) + 230 + 9); // BootNotification has at most 9 attributes with at most 230 chars + null terminators
-    auto err = deserializeJson(*payload, payloadJson);
-    if (err) {
-        AO_DBG_ERR("Could not process input: %s", err.c_str());
-        (void)0;
-    }
+void ao_setTxBasedMeterInOut(TxStepInOut txMeterInOut) {
+    setTxBasedMeterInOut(adaptFn(txMeterInOut));
+}
+void ao_setTxBasedMeterInOut_m(TxStepInOut txMeterInOut, unsigned int connectorId) {
+    setTxBasedMeterInOut(adaptFn(txMeterInOut), connectorId);
+}
 
-    bootNotification(std::unique_ptr<DynamicJsonDocument>(payload), adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+bool ao_isOperative() {
+    return isOperative();
+}
+bool ao_isOperative_m(unsigned int connectorId) {
+    return isOperative(connectorId);
 }
 
-void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    authorize(idTag, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+int ao_getTransactionId() {
+    return getTransactionId();
+}
+int ao_getTransactionId_m(unsigned int connectorId) {
+    return getTransactionId(connectorId);
 }
 
-void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    startTransaction(idTag, adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+const char *ao_getTransactionIdTag() {
+    return getTransactionIdTag();
+}
+const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
+    return getTransactionIdTag(connectorId);
 }
 
-void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    stopTransaction(adaptCb(onConfirmation), adaptCb(onAbort), adaptCb(onTimeout), adaptCb(onError));
+void ao_setOnResetRequest(OnOcppMessage onRequest) {
+    setOnResetRequest(adaptFn(onRequest));
 }
 
-int ao_getTransactionId() {
-    return getTransactionId();
+void ao_set_console_out_c(void (*console_out)(const char *msg)) {
+    ao_set_console_out(console_out);
 }
 
-bool ao_ocppPermitsCharge() {
-    return ocppPermitsCharge();
+OcppHandle *getOcppHandle() {
+    return reinterpret_cast<OcppHandle*>(getOcppEngine());
 }
 
-bool ao_isAvailable() {
-    return isAvailable();
+void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf) {
+    setOnRemoteStopTransactionSendConf(adaptFn(onSendConf));
 }
 
-void ao_beginSession(const char *idTag) {
-    return beginSession(idTag);
+void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf) {
+    setOnRemoteStopTransactionSendConf(adaptFn(onSendConf));
 }
 
-void ao_endSession() {
-    return endSession();
+void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest) {
+    setOnRemoteStopTransactionReceiveReq(adaptFn(onRequest));
 }
 
-bool ao_isInSession() {
-    return isInSession();
+void ao_onResetSendConf(OnOcppMessage onSendConf) {
+    setOnResetSendConf(adaptFn(onSendConf));
 }
 
-const char *ao_getSessionIdTag() {
-    return getSessionIdTag();
+void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    startTransaction(idTag, adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
-OcppHandle *getOcppHandle() {
-    return reinterpret_cast<OcppHandle*>(getOcppEngine());
+void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    stopTransaction(adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 3fe0a0b0..7babf9a0 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -6,6 +6,9 @@
 struct AOcppSocket;
 typedef struct AOcppSocket AOcppSocket;
 
+struct MeterValueInput;
+typedef struct MeterValueInput MeterValueInput;
+
 struct OcppHandle;
 typedef struct OcppHandle OcppHandle;
 
@@ -14,102 +17,145 @@ typedef void (*OnOcppAbort)   ();
 typedef void (*OnOcppTimeout) ();
 typedef void (*OnOcppError)   (const char *code, const char *description, const char *details_json, size_t details_len);
 
-typedef float (*SamplerFloat)();
-typedef int   (*SamplerInt)();
-typedef bool  (*SamplerBool)();
-typedef const char* (*SamplerString)();
+typedef float (*InputFloat)();
+typedef int   (*InputInt)();
+typedef bool  (*InputBool)();
+typedef const char* (*InputString)();
+typedef void (*OutputFloat)(float limit);
+enum OptionalBool {OptionalTrue, OptionalFalse, OptionalUndefined};
+typedef OptionalBool (*PollBool)();
+enum TxTrigger_t {TxTrg_Active, TxTrg_Inactive};
+enum TxEnableState_t {TxEna_Active, TxEna_Inactive, TxEna_Pending};
+typedef TxEnableState_t (*TxStepInOut)(TxTrigger_t triggerIn);
+
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-void ao_initialize(AOcppSocket *osock);
+/*
+ * Please refer to ArduinoOcpp.h for the documentation
+ */
+
+void ao_initialize(
+            AOcppSocket *osock,  //WebSocket adapter for ArduinoOcpp
+            float V_eff, //Grid voltage of your country. e.g. 230.f (European voltage)
+            struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 void ao_deinitialize();
 
 void ao_loop();
-
-void ao_set_console_out_c(void (*console_out)(const char *msg));
-
 /*
- * Feed lib with HW related data
+ * Send OCPP operations
  */
 
-void ao_setPowerActiveImportSampler(SamplerFloat power);
+void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
-void ao_setEnergyActiveImportSampler(SamplerInt energy);
+void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
-void ao_addMeterValueSampler_Int(SamplerInt sampler, const char *measurand, const char *phase, const char *unit);
+/*
+ * Charging session management
+ */
 
-void ao_setEvRequestsEnergySampler(SamplerBool evRequestsEnergy);
+void ao_beginTransaction(const char *idTag);
+void ao_beginTransaction_m(const char *idTag, unsigned int connectorId); //multiple connectors version
 
-void ao_setConnectorEnergizedSampler(SamplerBool connectorEnergized);
+bool ao_endTransaction(const char *reason); //reason can be NULL
+bool ao_endTransaction_m(const char *reason, unsigned int connectorId); //reason can be NULL
 
-void ao_setConnectorPluggedSampler(SamplerBool connectorPlugged);
+bool ao_isTransactionRunning();
+bool ao_isTransactionRunning_m(unsigned int connectorId);
 
-void ao_addConnectorErrorCodeSampler(SamplerString connectorErrorCode);
+bool ao_ocppPermitsCharge();
+bool ao_ocppPermitsCharge_m(unsigned int connectorId);
 
 /*
- * Execute HW related operations on EVSE
+ * Define the Inputs and Outputs of this library.
  */
 
-void ao_onChargingRateLimitChange(void (*chargingRateChanged)(float));
+void ao_setConnectorPluggedInput(InputBool pluggedInput);
+void ao_setConnectorPluggedInput_m(InputBool pluggedInput, unsigned int connectorId);
+
+void ao_setEnergyMeterInput(InputInt energyInput);
+void ao_setEnergyMeterInput_m(InputInt energyInput, unsigned int connectorId);
+
+void ao_setPowerMeterInput(InputFloat powerInput);
+void ao_setPowerMeterInput_m(InputFloat powerInput, unsigned int connectorId);
 
-void ao_onUnlockConnector(SamplerBool unlockConnector); //true: success, false: failure
+void ao_setSmartChargingOutput(OutputFloat chargingLimitOutput);
+void ao_setSmartChargingOutput_m(OutputFloat chargingLimitOutput, unsigned int connectorId);
 
 /*
- * Generic listeners for OCPP operations initiated by Central System
+ * Define the Inputs and Outputs of this library. (Advanced)
  */
 
-void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf); //important, energize the power plug here and capture the idTag
-
-void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf); //important, de-energize the power plug here
-void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest); //optional, to de-energize the power plug immediately
+void ao_setEvReadyInput(InputBool evReadyInput);
+void ao_setEvReadyInput_m(InputBool evReadyInput, unsigned int connectorId);
 
-void ao_onResetSendConf(OnOcppMessage onSendConf); //important, reset your device here (i.e. call ESP.reset();)
-void ao_onResetRequest(OnOcppMessage onRequest); //alternative: start reset timer here
+void ao_setEvseReadyInput(InputBool evseReadyInput);
+void ao_setEvseReadyInput_m(InputBool evseReadyInput, unsigned int connectorId);
 
-/*
- * Initiate OCPP operations
- */
+void ao_addErrorCodeInput(InputString errorCodeInput);
+void ao_addErrorCodeInput_m(InputString errorCodeInput, unsigned int connectorId);
 
-void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
+void ao_addMeterValueInputInt_m(InputInt valueInput, unsigned int connectorId, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
 
-void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_addMeterValueInput(MeterValueInput *meterValueInput); //takes ownership of meterValueInput
+void ao_addMeterValueInput_m(MeterValueInput *meterValueInput, unsigned int connectorId); //takes ownership of meterValueInput
 
-void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
+void ao_setOnUnlockConnectorInOut_m(PollBool onUnlockConnectorInOut, unsigned int connectorId);
 
-void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_setConnectorLockInOut(TxStepInOut lockConnectorInOut);
+void ao_setConnectorLockInOut_m(TxStepInOut lockConnectorInOut, unsigned int connectorId);
 
-void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_setTxBasedMeterInOut(TxStepInOut txMeterInOut);
+void ao_setTxBasedMeterInOut_m(TxStepInOut txMeterInOut, unsigned int connectorId);
 
 /*
- * Access OCPP state
+ * Access further information about the internal state of the library
  */
 
-int ao_getTransactionId(); //returns the ID of the current transaction. Returns -1 if called before or after an transaction
+bool ao_isOperative();
+bool ao_isOperative_m(unsigned int connectorId);
 
-bool ao_ocppPermitsCharge();
+int ao_getTransactionId();
+int ao_getTransactionId_m(unsigned int connectorId);
 
-bool ao_isAvailable(); //if the charge point is operative or inoperative
+const char *ao_getTransactionIdTag();
+const char *ao_getTransactionIdTag_m(unsigned int connectorId);
+
+void ao_setOnResetRequest(OnOcppMessage onRequest);
 
 /*
- * Charging session management
+ * If build flag AO_CUSTOM_CONSOLE is set, all console output will be forwarded to the print
+ * function given by this setter. The parameter msg will also by null-terminated c-strings.
  */
+void ao_set_console_out_c(void (*console_out)(const char *msg));
 
-void ao_beginSession(const char *idTag);
-
-void ao_endSession();
-
-bool ao_isInSession();
+/*
+ * Get access to the internals
+ */
 
-const char *ao_getSessionIdTag();
+OcppHandle *ao_getOcppHandle();
 
 /*
- * Get access to the internals
+ * Deprecated functions or functions to be moved to ArduinoOcppExtended.h
  */
 
-OcppHandle *getOcppHandle();
+void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf); //important, energize the power plug here and capture the idTag
+
+void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf); //important, de-energize the power plug here
+void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest); //optional, to de-energize the power plug immediately
+
+void ao_setOnResetSendConf(OnOcppMessage onSendConf);
+
+void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+
+void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
 #ifdef __cplusplus
 }

From d6a3c1526d38558f689843210c51075e8ef578e2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 18 Nov 2022 21:13:28 +0100
Subject: [PATCH 128/549] apply API update to tests

---
 tests/ChargingSessions.cpp  | 40 ++++++++++++++++++-------------------
 tests/TransactionSafety.cpp | 20 +++++++++----------
 2 files changed, 30 insertions(+), 30 deletions(-)

diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index f7864a40..58d45cb6 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -48,8 +48,8 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE( checkedBN );
         REQUIRE( checkedSN[0] );
         REQUIRE( checkedSN[1] );
-        REQUIRE( isAvailable() );
-        REQUIRE( !getSessionIdTag() );
+        REQUIRE( isOperative() );
+        REQUIRE( !getTransactionIdTag() );
         REQUIRE( !ocppPermitsCharge() );
     }
 
@@ -64,13 +64,13 @@ TEST_CASE( "Charging sessions" ) {
 
         SECTION("StartTx via session management - plug in first") {
             expectedSN[1] = "Preparing";
-            setConnectorPluggedSampler([] () {return true;});
+            setConnectorPluggedInput([] () {return true;});
             loop();
             REQUIRE(checkedSN[1]);
 
             checkedSN[1] = false;
             expectedSN[1] = "Charging";
-            beginSession("mIdTag");
+            beginTransaction("mIdTag");
             loop();
             REQUIRE(checkedSN[1]);
             REQUIRE(ocppPermitsCharge());
@@ -79,14 +79,14 @@ TEST_CASE( "Charging sessions" ) {
         SECTION("StartTx via session management - authorization first") {
 
             expectedSN[1] = "Preparing";
-            setConnectorPluggedSampler([] () {return false;});
-            beginSession("mIdTag");
+            setConnectorPluggedInput([] () {return false;});
+            beginTransaction("mIdTag");
             loop();
             REQUIRE(checkedSN[1]);
 
             checkedSN[1] = false;
             expectedSN[1] = "Charging";
-            setConnectorPluggedSampler([] () {return true;});
+            setConnectorPluggedInput([] () {return true;});
             loop();
             REQUIRE(checkedSN[1]);
             REQUIRE(ocppPermitsCharge());
@@ -94,15 +94,15 @@ TEST_CASE( "Charging sessions" ) {
 
         SECTION("StartTx via session management - no plug") {
             expectedSN[1] = "Charging";
-            beginSession("mIdTag");
+            beginTransaction("mIdTag");
             loop();
             REQUIRE(checkedSN[1]);
         }
 
         SECTION("StartTx via session management - ConnectionTimeOut") {
             expectedSN[1] = "Preparing";
-            setConnectorPluggedSampler([] () {return false;});
-            beginSession("mIdTag");
+            setConnectorPluggedInput([] () {return false;});
+            beginTransaction("mIdTag");
             loop();
             REQUIRE(checkedSN[1]);
 
@@ -133,7 +133,7 @@ TEST_CASE( "Charging sessions" ) {
         }
 
         SECTION("via session management - deauthorize") {
-            endSession("Local");
+            endTransaction("Local");
             loop();
             REQUIRE(checkedSN[1]);
             REQUIRE(!ocppPermitsCharge());
@@ -141,22 +141,22 @@ TEST_CASE( "Charging sessions" ) {
 
         SECTION("via session management - deauthorize first") {
             expectedSN[1] = "Finishing";
-            setConnectorPluggedSampler([] () {return true;});
-            endSession("Local");
+            setConnectorPluggedInput([] () {return true;});
+            endTransaction("Local");
             loop();
             REQUIRE(checkedSN[1]);
             REQUIRE(!ocppPermitsCharge());
 
             checkedSN[1] = false;
             expectedSN[1] = "Available";
-            setConnectorPluggedSampler([] () {return false;});
+            setConnectorPluggedInput([] () {return false;});
             loop();
             REQUIRE(checkedSN[1]);
             REQUIRE(!ocppPermitsCharge());
         }
 
         SECTION("via session management - plug out") {
-            setConnectorPluggedSampler([] () {return false;});
+            setConnectorPluggedInput([] () {return false;});
             loop();
             REQUIRE(checkedSN[1]);
             REQUIRE(!ocppPermitsCharge());
@@ -170,15 +170,15 @@ TEST_CASE( "Charging sessions" ) {
 
     SECTION("Advanced session management") {
         bool connectorPlugged = false;
-        setConnectorPluggedSampler([&connectorPlugged] () {return connectorPlugged;});
+        setConnectorPluggedInput([&connectorPlugged] () {return connectorPlugged;});
 
         TxEnableState meterState = TxEnableState::Inactive;
-        setTxBasedMeterUpdate([&meterState] (TxTrigger) {return meterState;});
+        setTxBasedMeterInOut([&meterState] (TxTrigger) {return meterState;});
 
         TxEnableState lockState = TxEnableState::Inactive;
-        setConnectorLock([&lockState] (TxTrigger) {return lockState;});
+        setConnectorLockInOut([&lockState] (TxTrigger) {return lockState;});
 
-        beginSession("mIdTag");
+        beginTransaction("mIdTag");
         loop();
         REQUIRE(!ocppPermitsCharge());
 
@@ -214,7 +214,7 @@ TEST_CASE( "Charging sessions" ) {
         lockState = TxEnableState::Pending;
         loop();
         REQUIRE(!ocppPermitsCharge());
-        REQUIRE(!getSessionIdTag());
+        REQUIRE(!getTransactionIdTag());
         REQUIRE(checkedSN[1]);
 
         checkedSN[1] = false;
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 3214d8e2..8bd04c0f 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -46,11 +46,11 @@ TEST_CASE( "Transaction safety" ) {
         OCPP_loop();
         OCPP_loop();
         OCPP_loop();
-        setConnectorPluggedSampler([] () {return true;});
-        beginSession("mIdTag");
+        setConnectorPluggedInput([] () {return true;});
+        beginTransaction("mIdTag");
         OCPP_loop();
         REQUIRE(ocppPermitsCharge());
-        endSession();
+        endTransaction();
         OCPP_loop();
         REQUIRE(!ocppPermitsCharge());
         
@@ -59,17 +59,17 @@ TEST_CASE( "Transaction safety" ) {
 
     SECTION("Reset during transaction 01 - interrupt initiation") {
         AO_DBG_DEBUG("Reset during transaction 01 - interrupt initiation");
-        setConnectorPluggedSampler([] () {return false;});
+        setConnectorPluggedInput([] () {return false;});
         OCPP_loop();
         OCPP_loop();
         OCPP_loop();
-        beginSession("mIdTag");
+        beginTransaction("mIdTag");
         OCPP_deinitialize(); //reset and jump to next section
     }
 
     SECTION("Reset during transaction 02 - interrupt initiation second time") {
         AO_DBG_DEBUG("Reset during transaction 02 - interrupt initiation second time");
-        setConnectorPluggedSampler([] () {return false;});
+        setConnectorPluggedInput([] () {return false;});
         OCPP_loop();
         OCPP_loop();
         OCPP_loop();
@@ -79,7 +79,7 @@ TEST_CASE( "Transaction safety" ) {
 
     SECTION("Reset during transaction 03 - interrupt running tx") {
         AO_DBG_DEBUG("Reset during transaction 03 - interrupt running tx");
-        setConnectorPluggedSampler([] () {return true;});
+        setConnectorPluggedInput([] () {return true;});
         OCPP_loop();
         OCPP_loop();
         OCPP_loop();
@@ -89,18 +89,18 @@ TEST_CASE( "Transaction safety" ) {
 
     SECTION("Reset during transaction 04 - interrupt stopping tx") {
         AO_DBG_DEBUG("Reset during transaction 04 - interrupt stopping tx");
-        setConnectorPluggedSampler([] () {return true;});
+        setConnectorPluggedInput([] () {return true;});
         OCPP_loop();
         OCPP_loop();
         OCPP_loop();
         REQUIRE(ocppPermitsCharge());
-        endSession();
+        endTransaction();
         OCPP_deinitialize();
     }
 
     SECTION("Reset during transaction 06 - check tx finished") {
         AO_DBG_DEBUG("Reset during transaction 06 - check tx finished");
-        setConnectorPluggedSampler([] () {return true;});
+        setConnectorPluggedInput([] () {return true;});
         OCPP_loop();
         OCPP_loop();
         OCPP_loop();

From 7e636a405a799f520c17b0e1ec7341f45d4868c0 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 18 Nov 2022 21:22:14 +0100
Subject: [PATCH 129/549] update readme

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 3782dd77..2c6db156 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 [![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
 
-OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Runs on Espressif, NXP, Texas Instruments and STM.
+OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with Espressif, NXP, Texas Instruments and STM.
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
 
@@ -10,7 +10,7 @@ PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoO
 
 Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
-Fully integrated into the Arduino platform and the ESP32 / ESP8266. Compatible with ESP-IDF, FreeRTOS and generic embedded C/C++ platforms.
+Fully integrated into the Arduino platform and the ESP32 / ESP8266. Runs on ESP-IDF, FreeRTOS and generic embedded C/C++ platforms.
 
 ## Make your EVSE ready for OCPP :car::electric_plug::battery:
 

From 7859eb2fe48e36439424e4bfda4bd98efc7381cf Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 21 Nov 2022 22:22:06 +0100
Subject: [PATCH 130/549] update debug WS + minor corrections

---
 src/ArduinoOcpp/Core/OcppConnection.cpp |  2 ++
 src/ArduinoOcpp/Core/OcppSocket.cpp     |  6 ++----
 src/ArduinoOcpp/Debug.h                 |  4 ++--
 src/ArduinoOcpp_c.h                     |  1 +
 tests/TransactionProcess.cpp            | 17 -----------------
 tests/TransactionSafety.cpp             |  2 +-
 6 files changed, 8 insertions(+), 24 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 639bda9d..17402e26 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -98,6 +98,8 @@ void OcppConnection::initiateOcppOperation(std::unique_ptr<OcppOperation> o){
 }
 
 bool OcppConnection::processOcppSocketInputTXT(const char* payload, size_t length) {
+
+    AO_DBG_TRAFFIC_IN(length, payload);
     
     bool deserializationSuccess = false;
 
diff --git a/src/ArduinoOcpp/Core/OcppSocket.cpp b/src/ArduinoOcpp/Core/OcppSocket.cpp
index b0ec2cde..f7468aca 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.cpp
+++ b/src/ArduinoOcpp/Core/OcppSocket.cpp
@@ -34,8 +34,6 @@ void OcppClientSocket::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
                 AO_DBG_INFO("Connected to url: %s", payload);
                 break;
             case WStype_TEXT:
-                AO_DBG_TRAFFIC_IN(payload);
-
                 if (!callback((const char *) payload, length)) { //forward message to OcppEngine
                     AO_DBG_WARN("Processing WebSocket input event failed");
                 }
@@ -45,11 +43,11 @@ void OcppClientSocket::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
                 break;
             case WStype_PING:
                 // pong will be send automatically
-                AO_DBG_TRAFFIC_IN("WS ping");
+                AO_DBG_TRAFFIC_IN(8, "WS ping");
                 break;
             case WStype_PONG:
                 // answer to a ping we send
-                AO_DBG_TRAFFIC_IN("WS pong");
+                AO_DBG_TRAFFIC_IN(8, "WS pong");
                 break;
             case WStype_FRAGMENT_TEXT_START: //fragments are not supported
             default:
diff --git a/src/ArduinoOcpp/Debug.h b/src/ArduinoOcpp/Debug.h
index 78ece3c8..3eb8ab4c 100644
--- a/src/ArduinoOcpp/Debug.h
+++ b/src/ArduinoOcpp/Debug.h
@@ -59,13 +59,13 @@
 
 #define AO_DBG_TRAFFIC_OUT(...)   \
     do {                        \
-        AO_CONSOLE_PRINTF("[AO] To WS lib: %s",__VA_ARGS__);           \
+        AO_CONSOLE_PRINTF("[AO] Send: %s",__VA_ARGS__);           \
         AO_CONSOLE_PRINTF("\n");         \
     } while (0)
 
 #define AO_DBG_TRAFFIC_IN(...)   \
     do {                        \
-        AO_CONSOLE_PRINTF("[AO] From WS lib: %s",__VA_ARGS__);           \
+        AO_CONSOLE_PRINTF("[AO] Recv: %.*s",__VA_ARGS__);           \
         AO_CONSOLE_PRINTF("\n");         \
     } while (0)
 
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 7babf9a0..2aab409f 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -2,6 +2,7 @@
 #define ARDUINOOCPP_C_H
 
 #include <stddef.h>
+#include <ArduinoOcpp/Core/ConfigurationOptions.h>
 
 struct AOcppSocket;
 typedef struct AOcppSocket AOcppSocket;
diff --git a/tests/TransactionProcess.cpp b/tests/TransactionProcess.cpp
index a4a4e1de..0f0726f4 100644
--- a/tests/TransactionProcess.cpp
+++ b/tests/TransactionProcess.cpp
@@ -182,21 +182,4 @@ TEST_CASE("Transaction process - begin new transaction") {
         return enable;
     });
 
-/*
-    SECTION("Evaluate different txNr") {
-        auto txNr = txProcess.getTxNrRef();
-        txProcess.evaluateProcessSteps(txNr + 1); //try to evaluate newer transaction
-        REQUIRE( checkTrigger == TxTrigger::Inactive );
-        REQUIRE( txProcess.getState() != TxEnableState::Active );
-        REQUIRE( txNr == txProcess.getTxNrRef() );
-    }
-
-    SECTION("Switch to newer transaction") {
-        auto txNr = txProcess.getTxNrRef();
-        trigger = TxTrigger::Inactive;
-        enable = TxEnableState::Inactive;
-        txProcess.evaluateProcessSteps(txNr + 1);
-        REQUIRE( txNr + 1 == txProcess.getTxNrRef() );
-    }
-*/
 }
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 8bd04c0f..85913f2e 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -108,4 +108,4 @@ TEST_CASE( "Transaction safety" ) {
         OCPP_deinitialize();
     }
 
-}
\ No newline at end of file
+}

From 4ea11f243ccdbc3baa4d6bed7372d4f61a978cf7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 21 Nov 2022 22:30:05 +0100
Subject: [PATCH 131/549] fix compiler error

---
 src/ArduinoOcpp/Core/ConfigurationOptions.h | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/ArduinoOcpp/Core/ConfigurationOptions.h b/src/ArduinoOcpp/Core/ConfigurationOptions.h
index 7897ff12..22fab542 100644
--- a/src/ArduinoOcpp/Core/ConfigurationOptions.h
+++ b/src/ArduinoOcpp/Core/ConfigurationOptions.h
@@ -5,6 +5,8 @@
 #ifndef CONFIGURATIONOPTIONS_H
 #define CONFIGURATIONOPTIONS_H
 
+#include <stdint.h>
+
 #ifdef __cplusplus
 extern "C" {
 #endif

From bdae627330bf15e8553dfdd0f0904cebf8345987 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 24 Nov 2022 12:26:49 +0100
Subject: [PATCH 132/549] update mem management

---
 src/ArduinoOcpp.cpp                              | 3 +--
 src/ArduinoOcpp/Core/OcppConnection.cpp          | 2 +-
 src/ArduinoOcpp/Core/OcppOperation.cpp           | 4 ++--
 src/ArduinoOcpp/Core/OperationStore.h            | 2 +-
 src/ArduinoOcpp/Core/OperationsQueue.cpp         | 6 +++---
 src/ArduinoOcpp/MessagesV16/BootNotification.cpp | 2 +-
 6 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index bd7b64a8..8dd53939 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -158,10 +158,9 @@ void OCPP_loop() {
 
     ocppEngine->loop();
 
-    auto& model = ocppEngine->getOcppModel();
 
     if (!OCPP_booted) {
-        auto csService = model.getChargePointStatusService();
+        auto csService = ocppEngine->getOcppModel().getChargePointStatusService();
         if (!csService || csService->isBooted()) {
             OCPP_booted = true;
             ocppEngine->setRunOcppTasks(true);
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 17402e26..1c5c1308 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -99,7 +99,7 @@ void OcppConnection::initiateOcppOperation(std::unique_ptr<OcppOperation> o){
 
 bool OcppConnection::processOcppSocketInputTXT(const char* payload, size_t length) {
 
-    AO_DBG_TRAFFIC_IN(length, payload);
+    AO_DBG_TRAFFIC_IN((int) length, payload);
     
     bool deserializationSuccess = false;
 
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index d76579fc..9f89cc59 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -334,7 +334,7 @@ void OcppOperation::initiate(std::unique_ptr<StoredOperationHandler> opStorage)
         bool inited = ocppMessage->initiate(opStore.get());
 
         if (opStore) {
-            opStore->releaseBuffer();
+            opStore->clearBuffer();
         }
         
         if (!inited) { //legacy support
@@ -393,7 +393,7 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
     ocppMessage->setOcppModel(oModel);
 
     bool success = ocppMessage->restore(opStore.get());
-    opStore->releaseBuffer();
+    opStore->clearBuffer();
 
     if (success) {
         AO_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), ocppMessage->getOcppOperationType());
diff --git a/src/ArduinoOcpp/Core/OperationStore.h b/src/ArduinoOcpp/Core/OperationStore.h
index 3b7e884d..1cba6bf5 100644
--- a/src/ArduinoOcpp/Core/OperationStore.h
+++ b/src/ArduinoOcpp/Core/OperationStore.h
@@ -38,7 +38,7 @@ class StoredOperationHandler {
     std::unique_ptr<DynamicJsonDocument> getPayload() {return std::move(payload);}
 
     bool commit();
-    void releaseBuffer() {rpc.release(); payload.release();}
+    void clearBuffer() {rpc.reset(); payload.reset();}
 
     bool restore(unsigned int opNr);
 
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index a26878ee..8cacc00c 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -38,7 +38,7 @@ void OperationsQueue::pop_front() {
         AO_DBG_DEBUG("advanced %i to %u", head->getStorageHandler()->getOpNr(), opStore.getOpBegin());
     }
 
-    head.release();
+    head.reset();
 
     unsigned int nextOpNr = opStore.getOpBegin();
 
@@ -85,12 +85,12 @@ void OperationsQueue::pop_front() {
 
             if (!success) {
                 AO_DBG_ERR("could not restore operation");
-                fetched.release();
+                fetched.reset();
             }
 
             if (!fetched->isFullyConfigured()) {
                 AO_DBG_ERR("stored op initialization failure");
-                fetched.release();
+                fetched.reset();
             }
         }
 
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
index 3bae171e..2c4f3b86 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
@@ -29,7 +29,7 @@ void BootNotification::initiate() {
             ocppModel && ocppModel->getChargePointStatusService()) {
         auto cpStatus = ocppModel->getChargePointStatusService();
         cpStatus->setChargePointCredentials(*credentials);
-        credentials.release();
+        credentials.reset();
     }
 }
 

From fe1567cc813b5752fade74054d58c19efcdaf85c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 26 Nov 2022 19:34:42 +0100
Subject: [PATCH 133/549] ESP-IDF integration fixes

---
 CMakeLists.txt                              |  6 ++--
 src/ArduinoOcpp/Core/ConfigurationOptions.h |  6 ++--
 src/ArduinoOcpp_c.cpp                       | 32 ++++++++++-----------
 src/ArduinoOcpp_c.h                         | 32 ++++++++++-----------
 4 files changed, 38 insertions(+), 38 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 9ad9e28b..0d6416a8 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -14,6 +14,8 @@ set(AO_SRC
     src/ArduinoOcpp/Core/OcppServer.cpp
     src/ArduinoOcpp/Core/OcppSocket.cpp
     src/ArduinoOcpp/Core/OcppTime.cpp
+    src/ArduinoOcpp/Core/OperationsQueue.cpp
+    src/ArduinoOcpp/Core/OperationStore.cpp
     src/ArduinoOcpp/MessagesV16/Authorize.cpp
     src/ArduinoOcpp/MessagesV16/BootNotification.cpp
     src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
@@ -47,15 +49,13 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
     src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
     src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+    src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
     src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
     src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
-    src/ArduinoOcpp/Tasks/Transactions/OrderedOperationsQueue.cpp
     src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
     src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
-    src/ArduinoOcpp/Tasks/Transactions/TransactionSequence.cpp
-    src/ArduinoOcpp/Tasks/Transactions/TransactionService.cpp
     src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
     src/ArduinoOcpp.cpp
     src/ArduinoOcpp_c.cpp
diff --git a/src/ArduinoOcpp/Core/ConfigurationOptions.h b/src/ArduinoOcpp/Core/ConfigurationOptions.h
index 22fab542..a9e0f2b7 100644
--- a/src/ArduinoOcpp/Core/ConfigurationOptions.h
+++ b/src/ArduinoOcpp/Core/ConfigurationOptions.h
@@ -12,9 +12,9 @@ extern "C" {
 #endif
 
 struct AO_FilesystemOpt {
-    bool use = false;
-    bool mount = false;
-    bool formatFsOnFail = false;
+    bool use;
+    bool mount;
+    bool formatFsOnFail;
 };
 
 #ifdef __cplusplus
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index b7d5c076..2851fb5c 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -114,14 +114,14 @@ void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort o
 void ao_beginTransaction(const char *idTag) {
     ao_beginTransaction(idTag);
 }
-void ao_beginTransaction_m(const char *idTag, unsigned int connectorId) {
+void ao_beginTransaction_m(unsigned int connectorId, const char *idTag) {
     beginTransaction(idTag, 1);
 }
 
 bool ao_endTransaction(const char *reason) {
     return endTransaction(reason);
 }
-bool ao_endTransaction_m(const char *reason, unsigned int connectorId) {
+bool ao_endTransaction_m(unsigned int connectorId, const char *reason) {
     return endTransaction(reason, connectorId);
 }
 
@@ -142,63 +142,63 @@ bool ao_ocppPermitsCharge_m(unsigned int connectorId) {
 void ao_setConnectorPluggedInput(InputBool pluggedInput) {
     setConnectorPluggedInput(adaptFn(pluggedInput));
 }
-void ao_setConnectorPluggedInput_m(InputBool pluggedInput, unsigned int connectorId) {
+void ao_setConnectorPluggedInput_m(unsigned int connectorId, InputBool pluggedInput) {
     setConnectorPluggedInput(adaptFn(pluggedInput), connectorId);
 }
 
 void ao_setEnergyMeterInput(InputInt energyInput) {
     setEnergyMeterInput(adaptFn(energyInput));
 }
-void ao_setEnergyMeterInput_m(InputInt energyInput, unsigned int connectorId) {
+void ao_setEnergyMeterInput_m(unsigned int connectorId, InputInt energyInput) {
     setEnergyMeterInput(adaptFn(energyInput), connectorId);
 }
 
 void ao_setPowerMeterInput(InputFloat powerInput) {
     setPowerMeterInput(adaptFn(powerInput));
 }
-void ao_setPowerMeterInput_m(InputFloat powerInput, unsigned int connectorId) {
+void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat powerInput) {
     setPowerMeterInput(adaptFn(powerInput), connectorId);
 }
 
 void ao_setSmartChargingOutput(OutputFloat chargingLimitOutput) {
     setSmartChargingOutput(adaptFn(chargingLimitOutput));
 }
-void ao_setSmartChargingOutput_m(OutputFloat chargingLimitOutput, unsigned int connectorId) {
+void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputFloat chargingLimitOutput) {
     setSmartChargingOutput(adaptFn(chargingLimitOutput), connectorId);
 }
 
 void ao_setEvReadyInput(InputBool evReadyInput) {
     setEvReadyInput(adaptFn(evReadyInput));
 }
-void ao_setEvReadyInput_m(InputBool evReadyInput, unsigned int connectorId) {
+void ao_setEvReadyInput_m(unsigned int connectorId, InputBool evReadyInput) {
     setEvReadyInput(adaptFn(evReadyInput), connectorId);
 }
 
 void ao_setEvseReadyInput(InputBool evseReadyInput) {
     setEvseReadyInput(adaptFn(evseReadyInput));
 }
-void ao_setEvseReadyInput_m(InputBool evseReadyInput, unsigned int connectorId) {
+void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool evseReadyInput) {
     setEvseReadyInput(adaptFn(evseReadyInput), connectorId);
 }
 
 void ao_addErrorCodeInput(InputString errorCodeInput) {
     addErrorCodeInput(adaptFn(errorCodeInput));
 }
-void ao_addErrorCodeInput_m(InputString errorCodeInput, unsigned int connectorId) {
+void ao_addErrorCodeInput_m(unsigned int connectorId, InputString errorCodeInput) {
     addErrorCodeInput(adaptFn(errorCodeInput), connectorId);
 }
 
 void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
     addMeterValueInput(adaptFn(valueInput), 1, measurand, unit, location, phase);
 }
-void ao_addMeterValueInputInt_m(InputInt valueInput, unsigned int connectorId, const char *measurand, const char *unit, const char *location, const char *phase) {
+void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
     addMeterValueInput(adaptFn(valueInput), connectorId, measurand, unit, location, phase);
 }
 
 void ao_addMeterValueInput(MeterValueInput *meterValueInput) {
-    ao_addMeterValueInput_m(meterValueInput, 1);
+    ao_addMeterValueInput_m(1, meterValueInput);
 }
-void ao_addMeterValueInput_m(MeterValueInput *meterValueInput, unsigned int connectorId) {
+void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput) {
     auto svs = std::unique_ptr<ArduinoOcpp::SampledValueSampler>(
         reinterpret_cast<ArduinoOcpp::SampledValueSampler*>(meterValueInput));
     
@@ -206,9 +206,9 @@ void ao_addMeterValueInput_m(MeterValueInput *meterValueInput, unsigned int conn
 }
 
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut) {
-    ao_setOnUnlockConnectorInOut_m(onUnlockConnectorInOut, 1);
+    ao_setOnUnlockConnectorInOut_m(1, onUnlockConnectorInOut);
 }
-void ao_setOnUnlockConnectorInOut_m(PollBool onUnlockConnectorInOut, unsigned int connectorId) {
+void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool onUnlockConnectorInOut) {
     setOnUnlockConnectorInOut([onUnlockConnectorInOut] () -> ArduinoOcpp::PollResult<bool> {
         auto res = onUnlockConnectorInOut();
         if (res == OptionalTrue) {
@@ -227,14 +227,14 @@ void ao_setOnUnlockConnectorInOut_m(PollBool onUnlockConnectorInOut, unsigned in
 void ao_setConnectorLockInOut(TxStepInOut lockConnectorInOut) {
     setConnectorLockInOut(adaptFn(lockConnectorInOut));
 }
-void ao_setConnectorLockInOut_m(TxStepInOut lockConnectorInOut, unsigned int connectorId) {
+void ao_setConnectorLockInOut_m(unsigned int connectorId, TxStepInOut lockConnectorInOut) {
     setConnectorLockInOut(adaptFn(lockConnectorInOut), connectorId);
 }
 
 void ao_setTxBasedMeterInOut(TxStepInOut txMeterInOut) {
     setTxBasedMeterInOut(adaptFn(txMeterInOut));
 }
-void ao_setTxBasedMeterInOut_m(TxStepInOut txMeterInOut, unsigned int connectorId) {
+void ao_setTxBasedMeterInOut_m(unsigned int connectorId, TxStepInOut txMeterInOut) {
     setTxBasedMeterInOut(adaptFn(txMeterInOut), connectorId);
 }
 
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 2aab409f..a59eccd7 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -24,10 +24,10 @@ typedef bool  (*InputBool)();
 typedef const char* (*InputString)();
 typedef void (*OutputFloat)(float limit);
 enum OptionalBool {OptionalTrue, OptionalFalse, OptionalUndefined};
-typedef OptionalBool (*PollBool)();
+typedef enum OptionalBool (*PollBool)();
 enum TxTrigger_t {TxTrg_Active, TxTrg_Inactive};
 enum TxEnableState_t {TxEna_Active, TxEna_Inactive, TxEna_Pending};
-typedef TxEnableState_t (*TxStepInOut)(TxTrigger_t triggerIn);
+typedef enum TxEnableState_t (*TxStepInOut)(enum TxTrigger_t triggerIn);
 
 
 #ifdef __cplusplus
@@ -61,10 +61,10 @@ void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort o
  */
 
 void ao_beginTransaction(const char *idTag);
-void ao_beginTransaction_m(const char *idTag, unsigned int connectorId); //multiple connectors version
+void ao_beginTransaction_m(unsigned int connectorId, const char *idTag); //multiple connectors version
 
 bool ao_endTransaction(const char *reason); //reason can be NULL
-bool ao_endTransaction_m(const char *reason, unsigned int connectorId); //reason can be NULL
+bool ao_endTransaction_m(unsigned int connectorId, const char *reason); //reason can be NULL
 
 bool ao_isTransactionRunning();
 bool ao_isTransactionRunning_m(unsigned int connectorId);
@@ -77,44 +77,44 @@ bool ao_ocppPermitsCharge_m(unsigned int connectorId);
  */
 
 void ao_setConnectorPluggedInput(InputBool pluggedInput);
-void ao_setConnectorPluggedInput_m(InputBool pluggedInput, unsigned int connectorId);
+void ao_setConnectorPluggedInput_m(unsigned int connectorId, InputBool pluggedInput);
 
 void ao_setEnergyMeterInput(InputInt energyInput);
-void ao_setEnergyMeterInput_m(InputInt energyInput, unsigned int connectorId);
+void ao_setEnergyMeterInput_m(unsigned int connectorId, InputInt energyInput);
 
 void ao_setPowerMeterInput(InputFloat powerInput);
-void ao_setPowerMeterInput_m(InputFloat powerInput, unsigned int connectorId);
+void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat powerInput);
 
 void ao_setSmartChargingOutput(OutputFloat chargingLimitOutput);
-void ao_setSmartChargingOutput_m(OutputFloat chargingLimitOutput, unsigned int connectorId);
+void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputFloat chargingLimitOutput);
 
 /*
  * Define the Inputs and Outputs of this library. (Advanced)
  */
 
 void ao_setEvReadyInput(InputBool evReadyInput);
-void ao_setEvReadyInput_m(InputBool evReadyInput, unsigned int connectorId);
+void ao_setEvReadyInput_m(unsigned int connectorId, InputBool evReadyInput);
 
 void ao_setEvseReadyInput(InputBool evseReadyInput);
-void ao_setEvseReadyInput_m(InputBool evseReadyInput, unsigned int connectorId);
+void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool evseReadyInput);
 
 void ao_addErrorCodeInput(InputString errorCodeInput);
-void ao_addErrorCodeInput_m(InputString errorCodeInput, unsigned int connectorId);
+void ao_addErrorCodeInput_m(unsigned int connectorId, InputString errorCodeInput);
 
 void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
-void ao_addMeterValueInputInt_m(InputInt valueInput, unsigned int connectorId, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
+void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
 
 void ao_addMeterValueInput(MeterValueInput *meterValueInput); //takes ownership of meterValueInput
-void ao_addMeterValueInput_m(MeterValueInput *meterValueInput, unsigned int connectorId); //takes ownership of meterValueInput
+void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
-void ao_setOnUnlockConnectorInOut_m(PollBool onUnlockConnectorInOut, unsigned int connectorId);
+void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool onUnlockConnectorInOut);
 
 void ao_setConnectorLockInOut(TxStepInOut lockConnectorInOut);
-void ao_setConnectorLockInOut_m(TxStepInOut lockConnectorInOut, unsigned int connectorId);
+void ao_setConnectorLockInOut_m(unsigned int connectorId, TxStepInOut lockConnectorInOut);
 
 void ao_setTxBasedMeterInOut(TxStepInOut txMeterInOut);
-void ao_setTxBasedMeterInOut_m(TxStepInOut txMeterInOut, unsigned int connectorId);
+void ao_setTxBasedMeterInOut_m(unsigned int connectorId, TxStepInOut txMeterInOut);
 
 /*
  * Access further information about the internal state of the library

From 3b5e431b3ce467f8c7bbf81e03c83b22cbbb1870 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 27 Nov 2022 15:11:34 +0100
Subject: [PATCH 134/549] ESP-IDF integration update

---
 CMakeLists.txt      |  1 -
 src/ArduinoOcpp.cpp | 16 ++++++++--------
 2 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 0d6416a8..c2c2d7f5 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -70,5 +70,4 @@ target_compile_options(${COMPONENT_TARGET} PUBLIC
     -DAO_CUSTOM_UPDATER
     -DAO_CUSTOM_RESET
     -DAO_USE_FILEAPI=ESPIDF_SPIFFS
-    -DAO_FILENAME_PREFIX="/ao_store"
     -DAO_PLATFORM=AO_PLATFORM_ESPIDF)
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 8dd53939..a8aa33f9 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -37,8 +37,8 @@ std::shared_ptr<FilesystemAdapter> filesystem;
 FilesystemOpt fileSystemOpt {};
 float voltage_eff {230.f};
 
-#ifndef OCPP_NUMCONNECTORS
-#define OCPP_NUMCONNECTORS 2
+#ifndef AO_NUMCONNECTORS
+#define AO_NUMCONNECTORS 2
 #endif
 
 #define OCPP_ID_OF_CP 0
@@ -100,9 +100,9 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
     auto& model = ocppEngine->getOcppModel();
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
-        new TransactionStore(OCPP_NUMCONNECTORS, filesystem)));
+        new TransactionStore(AO_NUMCONNECTORS, filesystem)));
     model.setChargePointStatusService(std::unique_ptr<ChargePointStatusService>(
-        new ChargePointStatusService(*ocppEngine, OCPP_NUMCONNECTORS)));
+        new ChargePointStatusService(*ocppEngine, AO_NUMCONNECTORS)));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
         new HeartbeatService(*ocppEngine)));
 
@@ -319,7 +319,7 @@ void setEnergyMeterInput(std::function<float()> energyInput, uint connectorId) {
     auto& model = ocppEngine->getOcppModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
+            new MeteringService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Energy.Active.Import.Register");
@@ -342,7 +342,7 @@ void setPowerMeterInput(std::function<float()> powerInput, uint connectorId) {
     auto& model = ocppEngine->getOcppModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
+            new MeteringService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Power.Active.Import");
@@ -368,7 +368,7 @@ void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, uint
     auto& model = ocppEngine->getOcppModel();
     if (!model.getSmartChargingService()) {
         model.setSmartChargingService(std::unique_ptr<SmartChargingService>(
-            new SmartChargingService(*ocppEngine, 11000.0f, voltage_eff, OCPP_NUMCONNECTORS, fileSystemOpt))); //default charging limit: 11kW
+            new SmartChargingService(*ocppEngine, 11000.0f, voltage_eff, AO_NUMCONNECTORS, fileSystemOpt))); //default charging limit: 11kW
     }
     model.getSmartChargingService()->setOnLimitChange(chargingLimitOutput);
 }
@@ -453,7 +453,7 @@ void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, uint co
     auto& model = ocppEngine->getOcppModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, OCPP_NUMCONNECTORS, filesystem)));
+            new MeteringService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
     }
     model.getMeteringService()->addMeterValueSampler(connectorId, std::move(valueInput));
 }

From 26bec02d6a3cd695574e33eee489b1bd0e8f648e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 28 Nov 2022 19:05:15 +0100
Subject: [PATCH 135/549] handle NULL-callbacks in C-facade

---
 src/ArduinoOcpp_c.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 2851fb5c..f60fdfc0 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -56,6 +56,7 @@ std::function<void(void)> adaptFn(void (*fn)(void)) {
 char ao_recv_payload_buff [AO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
 
 std::function<void(JsonObject)> adaptFn(OnOcppMessage fn) {
+    if (!fn) return nullptr;
     return [fn] (JsonObject payload) {
         auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
@@ -66,6 +67,7 @@ std::function<void(JsonObject)> adaptFn(OnOcppMessage fn) {
 }
 
 ArduinoOcpp::OnReceiveErrorListener adaptFn(OnOcppError fn) {
+    if (!fn) return nullptr;
     return [fn] (const char *code, const char *description, JsonObject details) {
         auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
@@ -76,6 +78,7 @@ ArduinoOcpp::OnReceiveErrorListener adaptFn(OnOcppError fn) {
 }
 
 std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> adaptFn(TxStepInOut fn) {
+    if (!fn) return nullptr;
     return [fn] (ArduinoOcpp::TxTrigger trigger) -> ArduinoOcpp::TxEnableState {
         auto res = fn(trigger == ArduinoOcpp::TxTrigger::Active ?
                             TxTrg_Active : TxTrg_Inactive);

From 05bf1e0ab1183c866361a71c8b9ca3c652bcdc47 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 28 Nov 2022 20:12:59 +0100
Subject: [PATCH 136/549] add ESP-IDF example

---
 examples/ESP-IDF/CMakeLists.txt               |    8 +
 examples/ESP-IDF/Makefile                     |    8 +
 examples/ESP-IDF/README.md                    |   45 +
 .../ESP-IDF/components/AOcppMongoose/.gitkeep |    0
 .../ESP-IDF/components/ArduinoOcpp/.gitkeep   |    0
 examples/ESP-IDF/components/README.md         |    9 +
 examples/ESP-IDF/components/mongoose/.gitkeep |    0
 examples/ESP-IDF/include/README.md            |    9 +
 examples/ESP-IDF/main/CMakeLists.txt          |    2 +
 examples/ESP-IDF/main/Kconfig.projbuild       |   38 +
 examples/ESP-IDF/main/component.mk            |    8 +
 examples/ESP-IDF/main/main.c                  |  178 +++
 examples/ESP-IDF/partitions.csv               |    7 +
 examples/ESP-IDF/sdkconfig                    | 1402 +++++++++++++++++
 14 files changed, 1714 insertions(+)
 create mode 100644 examples/ESP-IDF/CMakeLists.txt
 create mode 100644 examples/ESP-IDF/Makefile
 create mode 100644 examples/ESP-IDF/README.md
 create mode 100644 examples/ESP-IDF/components/AOcppMongoose/.gitkeep
 create mode 100644 examples/ESP-IDF/components/ArduinoOcpp/.gitkeep
 create mode 100644 examples/ESP-IDF/components/README.md
 create mode 100644 examples/ESP-IDF/components/mongoose/.gitkeep
 create mode 100644 examples/ESP-IDF/include/README.md
 create mode 100644 examples/ESP-IDF/main/CMakeLists.txt
 create mode 100644 examples/ESP-IDF/main/Kconfig.projbuild
 create mode 100644 examples/ESP-IDF/main/component.mk
 create mode 100644 examples/ESP-IDF/main/main.c
 create mode 100644 examples/ESP-IDF/partitions.csv
 create mode 100644 examples/ESP-IDF/sdkconfig

diff --git a/examples/ESP-IDF/CMakeLists.txt b/examples/ESP-IDF/CMakeLists.txt
new file mode 100644
index 00000000..5358fdcb
--- /dev/null
+++ b/examples/ESP-IDF/CMakeLists.txt
@@ -0,0 +1,8 @@
+# The following five lines of boilerplate have to be in your project's
+# CMakeLists in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.5)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+project(ao_example)
+
+idf_build_set_property(COMPILE_OPTIONS -DAO_TRAFFIC_OUT APPEND)
diff --git a/examples/ESP-IDF/Makefile b/examples/ESP-IDF/Makefile
new file mode 100644
index 00000000..3ad0575f
--- /dev/null
+++ b/examples/ESP-IDF/Makefile
@@ -0,0 +1,8 @@
+#
+# This is a project Makefile. It is assumed the directory this Makefile resides in is a
+# project subdirectory.
+#
+
+PROJECT_NAME := ao_example
+
+include $(IDF_PATH)/make/project.mk
diff --git a/examples/ESP-IDF/README.md b/examples/ESP-IDF/README.md
new file mode 100644
index 00000000..e62dce59
--- /dev/null
+++ b/examples/ESP-IDF/README.md
@@ -0,0 +1,45 @@
+# ESP-IDF integration example
+
+To run ArduinoOcpp on the ESP-IDF platform, please take this example as the starting point. It is widely based on the [Wi-Fi Station Example](https://github.com/espressif/esp-idf/tree/release/v4.4/examples/wifi/getting_started/station) of Espressif. This example works with the ESP-IDF version `4.4`. For a general guide how to setup and use the ESP-IDF, please refer to the documentation of Espressif.
+
+## Setup guide
+
+### Dependencies
+
+Please clone the following repositories into the respective components-directory:
+
+- [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf) into `components/mongoose`
+- [ArduinoOcpp](https://github.com/matth-x/ArduinoOcpp) into `components/ArduinoOcpp`
+- [Mongoose adapter for ArduinoOcpp](https://github.com/matth-x/AOcppMongoose) into `components/AOcppMongoose`
+
+The following header-only library needs to go into the include-section:
+
+- [ArduinoJson header file](https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h), renamed and moved to `include/ArduinoJson.h`
+
+For setup, the following commands could come handy (change to the root directory of the ESP-IDF project first):
+
+```
+rm components/mongoose/.gitkeep
+rm components/ArduinoOcpp/.gitkeep
+rm components/AOcppMongoose/.gitkeep
+git clone --recurse-submodules https://github.com/cesanta/mongoose-esp-idf.git components/mongoose
+git clone https://github.com/matth-x/ArduinoOcpp components/ArduinoOcpp
+git clone https://github.com/matth-x/AOcppMongoose components/AOcppMongoose
+wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./include/ArduinoJson.h
+```
+
+### Configure the project
+
+Open the project configuration menu (`idf.py menuconfig`). 
+
+In the `Example Configuration` menu:
+
+* Set the Wi-Fi configuration.
+    * Set `WiFi SSID`.
+    * Set `WiFi Password`.
+    * Set `OCPP backend URL`. (e.g. `ws://ocpp.example.com/steve/websocket/CentralSystemService`)
+    * Set `ChargeBoxId`. (e.g. `my-charger` - last part of the WebSocket URL
+    * Set `AuthorizationKey`, or leave empty if not necessary
+
+Optional: If you need, change the other options according to your requirements.
+
diff --git a/examples/ESP-IDF/components/AOcppMongoose/.gitkeep b/examples/ESP-IDF/components/AOcppMongoose/.gitkeep
new file mode 100644
index 00000000..e69de29b
diff --git a/examples/ESP-IDF/components/ArduinoOcpp/.gitkeep b/examples/ESP-IDF/components/ArduinoOcpp/.gitkeep
new file mode 100644
index 00000000..e69de29b
diff --git a/examples/ESP-IDF/components/README.md b/examples/ESP-IDF/components/README.md
new file mode 100644
index 00000000..4cd447ac
--- /dev/null
+++ b/examples/ESP-IDF/components/README.md
@@ -0,0 +1,9 @@
+## Components folder structure
+
+The ESP-IDF integration requires at least the following components:
+
+- [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf)
+- [ArduinoOcpp](https://github.com/matth-x/ArduinoOcpp)
+- [Mongoose adapter for ArduinoOcpp](https://github.com/matth-x/AOcppMongoose)
+
+This example only provides the folder structure. You need to clone every project into it in order to run the example.
diff --git a/examples/ESP-IDF/components/mongoose/.gitkeep b/examples/ESP-IDF/components/mongoose/.gitkeep
new file mode 100644
index 00000000..e69de29b
diff --git a/examples/ESP-IDF/include/README.md b/examples/ESP-IDF/include/README.md
new file mode 100644
index 00000000..5e098b2f
--- /dev/null
+++ b/examples/ESP-IDF/include/README.md
@@ -0,0 +1,9 @@
+## Includes
+
+[ArduinoJson](https://github.com/bblanchon/ArduinoJson) is the JSON (de)serializer of ArduinoOcpp and a dependency. It is a header-only library and can go into the `include` folder. Any other location will work too as long as the header file `ArduinoJson.h` is on the include-path, i.e. the following `#include` works:
+
+```cpp
+#include <ArduinoJson.h>
+```
+
+Version `6.19.4` is required. You can download [this header file](https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h), rename it into `ArduinoJson.h` and move it here.
diff --git a/examples/ESP-IDF/main/CMakeLists.txt b/examples/ESP-IDF/main/CMakeLists.txt
new file mode 100644
index 00000000..cf2c455c
--- /dev/null
+++ b/examples/ESP-IDF/main/CMakeLists.txt
@@ -0,0 +1,2 @@
+idf_component_register(SRCS "main.c"
+                    INCLUDE_DIRS ".")
diff --git a/examples/ESP-IDF/main/Kconfig.projbuild b/examples/ESP-IDF/main/Kconfig.projbuild
new file mode 100644
index 00000000..420f3095
--- /dev/null
+++ b/examples/ESP-IDF/main/Kconfig.projbuild
@@ -0,0 +1,38 @@
+menu "Example Configuration"
+
+    config ESP_WIFI_SSID
+        string "WiFi SSID"
+        default "myssid"
+        help
+            SSID (network name) for the example to connect to.
+
+    config ESP_WIFI_PASSWORD
+        string "WiFi Password"
+        default "mypassword"
+        help
+            WiFi password (WPA or WPA2) for the example to use.
+
+    config ESP_MAXIMUM_RETRY
+        int "Maximum retry"
+        default 5
+        help
+            Set the Maximum retry to avoid station reconnecting to the AP unlimited when the AP is really inexistent.
+    
+    config AO_OCPP_BACKEND
+        string "OCPP backend URL"
+        default "ws://echo.websocket.events/"
+        help
+            URL of the OCPP backend
+    
+    config AO_CHARGEBOXID
+        string "ChargeBoxId"
+        default ""
+        help
+            ChargeBoxId as it appears in the WebSocket connection URL
+
+    config AO_AUTHORIZATIONKEY
+        string "Authorization Key"
+        default ""
+        help
+            Passphrase for connecting to the OCPP server
+endmenu
diff --git a/examples/ESP-IDF/main/component.mk b/examples/ESP-IDF/main/component.mk
new file mode 100644
index 00000000..0adf4564
--- /dev/null
+++ b/examples/ESP-IDF/main/component.mk
@@ -0,0 +1,8 @@
+#
+# Main component makefile.
+#
+# This Makefile can be left empty. By default, it will take the sources in the
+# src/ directory, compile them and link them into lib(subdirectory_name).a
+# in the build directory. This behaviour is entirely configurable,
+# please read the ESP-IDF documents if you need to do this.
+#
diff --git a/examples/ESP-IDF/main/main.c b/examples/ESP-IDF/main/main.c
new file mode 100644
index 00000000..14b7b005
--- /dev/null
+++ b/examples/ESP-IDF/main/main.c
@@ -0,0 +1,178 @@
+/* Based on the ESP-IDF WiFi station Example (see https://github.com/espressif/esp-idf/tree/release/v4.4/examples/wifi/getting_started/station/main)
+
+   This example code extends the WiFi example with the necessary calls to establish an
+   OCPP connection on the ESP-IDF. 
+*/
+#include <string.h>
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+#include "freertos/event_groups.h"
+#include "esp_system.h"
+#include "esp_wifi.h"
+#include "esp_event.h"
+#include "esp_log.h"
+#include "nvs_flash.h"
+
+#include "lwip/err.h"
+#include "lwip/sys.h"
+
+/* ArduinoOcpp includes */
+#include <mongoose.h>
+#include <ArduinoOcpp_c.h> //C-facade of ArduinoOcpp
+#include <AOcppMongooseClient_c.h> //WebSocket integration for ESP-IDF
+
+/* The examples use WiFi configuration that you can set via project configuration menu
+
+   If you'd rather not, just change the below entries to strings with
+   the config you want - ie #define EXAMPLE_WIFI_SSID "mywifissid"
+*/
+#define EXAMPLE_ESP_WIFI_SSID      CONFIG_ESP_WIFI_SSID
+#define EXAMPLE_ESP_WIFI_PASS      CONFIG_ESP_WIFI_PASSWORD
+#define EXAMPLE_ESP_MAXIMUM_RETRY  CONFIG_ESP_MAXIMUM_RETRY
+#define EXAMPLE_AO_OCPP_BACKEND    CONFIG_AO_OCPP_BACKEND
+#define EXAMPLE_AO_CHARGEBOXID     CONFIG_AO_CHARGEBOXID
+#define EXAMPLE_AO_AUTHORIZATIONKEY CONFIG_AO_AUTHORIZATIONKEY
+
+/* FreeRTOS event group to signal when we are connected*/
+static EventGroupHandle_t s_wifi_event_group;
+
+/* The event group allows multiple bits for each event, but we only care about two events:
+ * - we are connected to the AP with an IP
+ * - we failed to connect after the maximum amount of retries */
+#define WIFI_CONNECTED_BIT BIT0
+#define WIFI_FAIL_BIT      BIT1
+
+static const char *TAG = "wifi station";
+
+static int s_retry_num = 0;
+
+static void event_handler(void* arg, esp_event_base_t event_base,
+                                int32_t event_id, void* event_data)
+{
+    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_START) {
+        esp_wifi_connect();
+    } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_DISCONNECTED) {
+        if (s_retry_num < EXAMPLE_ESP_MAXIMUM_RETRY) {
+            esp_wifi_connect();
+            s_retry_num++;
+            ESP_LOGI(TAG, "retry to connect to the AP");
+        } else {
+            xEventGroupSetBits(s_wifi_event_group, WIFI_FAIL_BIT);
+        }
+        ESP_LOGI(TAG,"connect to the AP fail");
+    } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
+        ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data;
+        ESP_LOGI(TAG, "got ip:" IPSTR, IP2STR(&event->ip_info.ip));
+        s_retry_num = 0;
+        xEventGroupSetBits(s_wifi_event_group, WIFI_CONNECTED_BIT);
+    }
+}
+
+void wifi_init_sta(void)
+{
+    s_wifi_event_group = xEventGroupCreate();
+
+    ESP_ERROR_CHECK(esp_netif_init());
+
+    ESP_ERROR_CHECK(esp_event_loop_create_default());
+    esp_netif_create_default_wifi_sta();
+
+    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
+    ESP_ERROR_CHECK(esp_wifi_init(&cfg));
+
+    esp_event_handler_instance_t instance_any_id;
+    esp_event_handler_instance_t instance_got_ip;
+    ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,
+                                                        ESP_EVENT_ANY_ID,
+                                                        &event_handler,
+                                                        NULL,
+                                                        &instance_any_id));
+    ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT,
+                                                        IP_EVENT_STA_GOT_IP,
+                                                        &event_handler,
+                                                        NULL,
+                                                        &instance_got_ip));
+
+    wifi_config_t wifi_config = {
+        .sta = {
+            .ssid = EXAMPLE_ESP_WIFI_SSID,
+            .password = EXAMPLE_ESP_WIFI_PASS,
+            /* Setting a password implies station will connect to all security modes including WEP/WPA.
+             * However these modes are deprecated and not advisable to be used. Incase your Access point
+             * doesn't support WPA2, these mode can be enabled by commenting below line */
+	     .threshold.authmode = WIFI_AUTH_WPA2_PSK,
+        },
+    };
+    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA) );
+    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config) );
+    ESP_ERROR_CHECK(esp_wifi_start() );
+
+    ESP_LOGI(TAG, "wifi_init_sta finished.");
+
+    /* Waiting until either the connection is established (WIFI_CONNECTED_BIT) or connection failed for the maximum
+     * number of re-tries (WIFI_FAIL_BIT). The bits are set by event_handler() (see above) */
+    EventBits_t bits = xEventGroupWaitBits(s_wifi_event_group,
+            WIFI_CONNECTED_BIT | WIFI_FAIL_BIT,
+            pdFALSE,
+            pdFALSE,
+            portMAX_DELAY);
+
+    /* xEventGroupWaitBits() returns the bits before the call returned, hence we can test which event actually
+     * happened. */
+    if (bits & WIFI_CONNECTED_BIT) {
+        ESP_LOGI(TAG, "connected to ap SSID:%s password:%s",
+                 EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS);
+    } else if (bits & WIFI_FAIL_BIT) {
+        ESP_LOGI(TAG, "Failed to connect to SSID:%s, password:%s",
+                 EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS);
+    } else {
+        ESP_LOGE(TAG, "UNEXPECTED EVENT");
+    }
+
+    /* The event will not be processed after unregister */
+    ESP_ERROR_CHECK(esp_event_handler_instance_unregister(IP_EVENT, IP_EVENT_STA_GOT_IP, instance_got_ip));
+    ESP_ERROR_CHECK(esp_event_handler_instance_unregister(WIFI_EVENT, ESP_EVENT_ANY_ID, instance_any_id));
+    vEventGroupDelete(s_wifi_event_group);
+}
+
+void app_main(void)
+{
+    //Initialize NVS
+    esp_err_t ret = nvs_flash_init();
+    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
+      ESP_ERROR_CHECK(nvs_flash_erase());
+      ret = nvs_flash_init();
+    }
+    ESP_ERROR_CHECK(ret);
+
+    ESP_LOGI(TAG, "ESP_WIFI_MODE_STA");
+    wifi_init_sta();
+
+    /* Initialize Mongoose (necessary for ArduinoOcpp)*/
+    struct mg_mgr mgr;        // Event manager
+    mg_mgr_init(&mgr);        // Initialise event manager
+    mg_log_set(MG_LL_DEBUG);  // Set log level
+
+    /* Initialize ArduinoOcpp */
+    struct AO_FilesystemOpt fsopt = { .use = true, .mount = true, .formatFsOnFail = true};
+
+    AOcppSocket *osock = ao_makeOcppSocket(&mgr,
+            EXAMPLE_AO_OCPP_BACKEND, 
+            EXAMPLE_AO_CHARGEBOXID, 
+            EXAMPLE_AO_AUTHORIZATIONKEY, "", fsopt);
+    ao_initialize(osock, 230.f /* European grid voltage */, fsopt);
+
+    ao_bootNotification("ESP-IDF charger", "Your brand name here", NULL, NULL, NULL, NULL); //send first OCPP message
+
+    /* Enter infinite loop */
+    while (1) {
+        mg_mgr_poll(&mgr, 10);
+        ao_loop();
+    }
+    
+    /* Deallocate ressources */
+    ao_deinitOcppSocket(osock);
+    ao_deinitialize();
+    mg_mgr_free(&mgr);
+    return;
+}
diff --git a/examples/ESP-IDF/partitions.csv b/examples/ESP-IDF/partitions.csv
new file mode 100644
index 00000000..d521f8bf
--- /dev/null
+++ b/examples/ESP-IDF/partitions.csv
@@ -0,0 +1,7 @@
+# Name,   Type, SubType, Offset,  Size, Flags
+nvs,      data, nvs,     ,        0x4000,
+otadata,  data, ota,     ,        0x2000,
+phy_init, data, phy,     ,        0x1000,
+ota_0,    app,  ota_0,   ,        0x190000,
+ota_1,    app,  ota_1,   ,        0x190000,
+ao,       data, spiffs,  ,        0xD0000,
\ No newline at end of file
diff --git a/examples/ESP-IDF/sdkconfig b/examples/ESP-IDF/sdkconfig
new file mode 100644
index 00000000..a39a2b82
--- /dev/null
+++ b/examples/ESP-IDF/sdkconfig
@@ -0,0 +1,1402 @@
+#
+# Automatically generated file. DO NOT EDIT.
+# Espressif IoT Development Framework (ESP-IDF) Project Configuration
+#
+CONFIG_IDF_CMAKE=y
+CONFIG_IDF_TARGET_ARCH_XTENSA=y
+CONFIG_IDF_TARGET="esp32"
+CONFIG_IDF_TARGET_ESP32=y
+CONFIG_IDF_FIRMWARE_CHIP_ID=0x0000
+
+#
+# SDK tool configuration
+#
+CONFIG_SDK_TOOLPREFIX="xtensa-esp32-elf-"
+# CONFIG_SDK_TOOLCHAIN_SUPPORTS_TIME_WIDE_64_BITS is not set
+# end of SDK tool configuration
+
+#
+# Build type
+#
+CONFIG_APP_BUILD_TYPE_APP_2NDBOOT=y
+# CONFIG_APP_BUILD_TYPE_ELF_RAM is not set
+CONFIG_APP_BUILD_GENERATE_BINARIES=y
+CONFIG_APP_BUILD_BOOTLOADER=y
+CONFIG_APP_BUILD_USE_FLASH_SECTIONS=y
+# end of Build type
+
+#
+# Application manager
+#
+CONFIG_APP_COMPILE_TIME_DATE=y
+# CONFIG_APP_EXCLUDE_PROJECT_VER_VAR is not set
+# CONFIG_APP_EXCLUDE_PROJECT_NAME_VAR is not set
+# CONFIG_APP_PROJECT_VER_FROM_CONFIG is not set
+CONFIG_APP_RETRIEVE_LEN_ELF_SHA=16
+# end of Application manager
+
+#
+# Bootloader config
+#
+CONFIG_BOOTLOADER_OFFSET_IN_FLASH=0x1000
+CONFIG_BOOTLOADER_COMPILER_OPTIMIZATION_SIZE=y
+# CONFIG_BOOTLOADER_COMPILER_OPTIMIZATION_DEBUG is not set
+# CONFIG_BOOTLOADER_COMPILER_OPTIMIZATION_PERF is not set
+# CONFIG_BOOTLOADER_COMPILER_OPTIMIZATION_NONE is not set
+# CONFIG_BOOTLOADER_LOG_LEVEL_NONE is not set
+# CONFIG_BOOTLOADER_LOG_LEVEL_ERROR is not set
+# CONFIG_BOOTLOADER_LOG_LEVEL_WARN is not set
+CONFIG_BOOTLOADER_LOG_LEVEL_INFO=y
+# CONFIG_BOOTLOADER_LOG_LEVEL_DEBUG is not set
+# CONFIG_BOOTLOADER_LOG_LEVEL_VERBOSE is not set
+CONFIG_BOOTLOADER_LOG_LEVEL=3
+# CONFIG_BOOTLOADER_VDDSDIO_BOOST_1_8V is not set
+CONFIG_BOOTLOADER_VDDSDIO_BOOST_1_9V=y
+# CONFIG_BOOTLOADER_FACTORY_RESET is not set
+# CONFIG_BOOTLOADER_APP_TEST is not set
+CONFIG_BOOTLOADER_WDT_ENABLE=y
+# CONFIG_BOOTLOADER_WDT_DISABLE_IN_USER_CODE is not set
+CONFIG_BOOTLOADER_WDT_TIME_MS=9000
+# CONFIG_BOOTLOADER_APP_ROLLBACK_ENABLE is not set
+# CONFIG_BOOTLOADER_SKIP_VALIDATE_IN_DEEP_SLEEP is not set
+# CONFIG_BOOTLOADER_SKIP_VALIDATE_ON_POWER_ON is not set
+# CONFIG_BOOTLOADER_SKIP_VALIDATE_ALWAYS is not set
+CONFIG_BOOTLOADER_RESERVE_RTC_SIZE=0
+# CONFIG_BOOTLOADER_CUSTOM_RESERVE_RTC is not set
+CONFIG_BOOTLOADER_FLASH_XMC_SUPPORT=y
+# end of Bootloader config
+
+#
+# Security features
+#
+# CONFIG_SECURE_SIGNED_APPS_NO_SECURE_BOOT is not set
+# CONFIG_SECURE_BOOT is not set
+# CONFIG_SECURE_FLASH_ENC_ENABLED is not set
+# end of Security features
+
+#
+# Serial flasher config
+#
+CONFIG_ESPTOOLPY_BAUD_OTHER_VAL=115200
+# CONFIG_ESPTOOLPY_NO_STUB is not set
+# CONFIG_ESPTOOLPY_FLASHMODE_QIO is not set
+# CONFIG_ESPTOOLPY_FLASHMODE_QOUT is not set
+CONFIG_ESPTOOLPY_FLASHMODE_DIO=y
+# CONFIG_ESPTOOLPY_FLASHMODE_DOUT is not set
+CONFIG_ESPTOOLPY_FLASH_SAMPLE_MODE_STR=y
+CONFIG_ESPTOOLPY_FLASHMODE="dio"
+# CONFIG_ESPTOOLPY_FLASHFREQ_80M is not set
+CONFIG_ESPTOOLPY_FLASHFREQ_40M=y
+# CONFIG_ESPTOOLPY_FLASHFREQ_26M is not set
+# CONFIG_ESPTOOLPY_FLASHFREQ_20M is not set
+CONFIG_ESPTOOLPY_FLASHFREQ="40m"
+# CONFIG_ESPTOOLPY_FLASHSIZE_1MB is not set
+# CONFIG_ESPTOOLPY_FLASHSIZE_2MB is not set
+CONFIG_ESPTOOLPY_FLASHSIZE_4MB=y
+# CONFIG_ESPTOOLPY_FLASHSIZE_8MB is not set
+# CONFIG_ESPTOOLPY_FLASHSIZE_16MB is not set
+# CONFIG_ESPTOOLPY_FLASHSIZE_32MB is not set
+# CONFIG_ESPTOOLPY_FLASHSIZE_64MB is not set
+# CONFIG_ESPTOOLPY_FLASHSIZE_128MB is not set
+CONFIG_ESPTOOLPY_FLASHSIZE="4MB"
+CONFIG_ESPTOOLPY_FLASHSIZE_DETECT=y
+CONFIG_ESPTOOLPY_BEFORE_RESET=y
+# CONFIG_ESPTOOLPY_BEFORE_NORESET is not set
+CONFIG_ESPTOOLPY_BEFORE="default_reset"
+CONFIG_ESPTOOLPY_AFTER_RESET=y
+# CONFIG_ESPTOOLPY_AFTER_NORESET is not set
+CONFIG_ESPTOOLPY_AFTER="hard_reset"
+# CONFIG_ESPTOOLPY_MONITOR_BAUD_CONSOLE is not set
+# CONFIG_ESPTOOLPY_MONITOR_BAUD_9600B is not set
+# CONFIG_ESPTOOLPY_MONITOR_BAUD_57600B is not set
+CONFIG_ESPTOOLPY_MONITOR_BAUD_115200B=y
+# CONFIG_ESPTOOLPY_MONITOR_BAUD_230400B is not set
+# CONFIG_ESPTOOLPY_MONITOR_BAUD_921600B is not set
+# CONFIG_ESPTOOLPY_MONITOR_BAUD_2MB is not set
+# CONFIG_ESPTOOLPY_MONITOR_BAUD_OTHER is not set
+CONFIG_ESPTOOLPY_MONITOR_BAUD_OTHER_VAL=115200
+CONFIG_ESPTOOLPY_MONITOR_BAUD=115200
+# end of Serial flasher config
+
+#
+# Partition Table
+#
+# CONFIG_PARTITION_TABLE_SINGLE_APP is not set
+# CONFIG_PARTITION_TABLE_SINGLE_APP_LARGE is not set
+# CONFIG_PARTITION_TABLE_TWO_OTA is not set
+CONFIG_PARTITION_TABLE_CUSTOM=y
+CONFIG_PARTITION_TABLE_CUSTOM_FILENAME="partitions.csv"
+CONFIG_PARTITION_TABLE_FILENAME="partitions.csv"
+CONFIG_PARTITION_TABLE_OFFSET=0x8000
+CONFIG_PARTITION_TABLE_MD5=y
+# end of Partition Table
+
+#
+# Example Configuration
+#
+CONFIG_ESP_WIFI_SSID="myssid"
+CONFIG_ESP_WIFI_PASSWORD="mypassword"
+CONFIG_ESP_MAXIMUM_RETRY=5
+CONFIG_AO_OCPP_BACKEND="ws://echo.websocket.events/"
+CONFIG_AO_CHARGEBOXID=""
+CONFIG_AO_AUTHORIZATIONKEY=""
+# end of Example Configuration
+
+#
+# Compiler options
+#
+CONFIG_COMPILER_OPTIMIZATION_DEFAULT=y
+# CONFIG_COMPILER_OPTIMIZATION_SIZE is not set
+# CONFIG_COMPILER_OPTIMIZATION_PERF is not set
+# CONFIG_COMPILER_OPTIMIZATION_NONE is not set
+CONFIG_COMPILER_OPTIMIZATION_ASSERTIONS_ENABLE=y
+# CONFIG_COMPILER_OPTIMIZATION_ASSERTIONS_SILENT is not set
+# CONFIG_COMPILER_OPTIMIZATION_ASSERTIONS_DISABLE is not set
+CONFIG_COMPILER_OPTIMIZATION_ASSERTION_LEVEL=2
+# CONFIG_COMPILER_OPTIMIZATION_CHECKS_SILENT is not set
+CONFIG_COMPILER_HIDE_PATHS_MACROS=y
+# CONFIG_COMPILER_CXX_EXCEPTIONS is not set
+# CONFIG_COMPILER_CXX_RTTI is not set
+CONFIG_COMPILER_STACK_CHECK_MODE_NONE=y
+# CONFIG_COMPILER_STACK_CHECK_MODE_NORM is not set
+# CONFIG_COMPILER_STACK_CHECK_MODE_STRONG is not set
+# CONFIG_COMPILER_STACK_CHECK_MODE_ALL is not set
+# CONFIG_COMPILER_WARN_WRITE_STRINGS is not set
+# CONFIG_COMPILER_DISABLE_GCC8_WARNINGS is not set
+# CONFIG_COMPILER_DUMP_RTL_FILES is not set
+# end of Compiler options
+
+#
+# Component config
+#
+
+#
+# Application Level Tracing
+#
+# CONFIG_APPTRACE_DEST_JTAG is not set
+CONFIG_APPTRACE_DEST_NONE=y
+CONFIG_APPTRACE_LOCK_ENABLE=y
+# end of Application Level Tracing
+
+#
+# ESP-ASIO
+#
+# CONFIG_ASIO_SSL_SUPPORT is not set
+# end of ESP-ASIO
+
+#
+# Bluetooth
+#
+# CONFIG_BT_ENABLED is not set
+# end of Bluetooth
+
+#
+# CoAP Configuration
+#
+CONFIG_COAP_MBEDTLS_PSK=y
+# CONFIG_COAP_MBEDTLS_PKI is not set
+# CONFIG_COAP_MBEDTLS_DEBUG is not set
+CONFIG_COAP_LOG_DEFAULT_LEVEL=0
+# end of CoAP Configuration
+
+#
+# Driver configurations
+#
+
+#
+# ADC configuration
+#
+# CONFIG_ADC_FORCE_XPD_FSM is not set
+CONFIG_ADC_DISABLE_DAC=y
+# end of ADC configuration
+
+#
+# MCPWM configuration
+#
+# CONFIG_MCPWM_ISR_IN_IRAM is not set
+# end of MCPWM configuration
+
+#
+# SPI configuration
+#
+# CONFIG_SPI_MASTER_IN_IRAM is not set
+CONFIG_SPI_MASTER_ISR_IN_IRAM=y
+# CONFIG_SPI_SLAVE_IN_IRAM is not set
+CONFIG_SPI_SLAVE_ISR_IN_IRAM=y
+# end of SPI configuration
+
+#
+# TWAI configuration
+#
+# CONFIG_TWAI_ISR_IN_IRAM is not set
+# CONFIG_TWAI_ERRATA_FIX_BUS_OFF_REC is not set
+# CONFIG_TWAI_ERRATA_FIX_TX_INTR_LOST is not set
+# CONFIG_TWAI_ERRATA_FIX_RX_FRAME_INVALID is not set
+# CONFIG_TWAI_ERRATA_FIX_RX_FIFO_CORRUPT is not set
+# end of TWAI configuration
+
+#
+# UART configuration
+#
+# CONFIG_UART_ISR_IN_IRAM is not set
+# end of UART configuration
+
+#
+# RTCIO configuration
+#
+# CONFIG_RTCIO_SUPPORT_RTC_GPIO_DESC is not set
+# end of RTCIO configuration
+
+#
+# GPIO Configuration
+#
+# CONFIG_GPIO_ESP32_SUPPORT_SWITCH_SLP_PULL is not set
+# end of GPIO Configuration
+
+#
+# GDMA Configuration
+#
+# CONFIG_GDMA_CTRL_FUNC_IN_IRAM is not set
+# CONFIG_GDMA_ISR_IRAM_SAFE is not set
+# end of GDMA Configuration
+# end of Driver configurations
+
+#
+# eFuse Bit Manager
+#
+# CONFIG_EFUSE_CUSTOM_TABLE is not set
+# CONFIG_EFUSE_VIRTUAL is not set
+# CONFIG_EFUSE_CODE_SCHEME_COMPAT_NONE is not set
+CONFIG_EFUSE_CODE_SCHEME_COMPAT_3_4=y
+# CONFIG_EFUSE_CODE_SCHEME_COMPAT_REPEAT is not set
+CONFIG_EFUSE_MAX_BLK_LEN=192
+# end of eFuse Bit Manager
+
+#
+# ESP-TLS
+#
+CONFIG_ESP_TLS_USING_MBEDTLS=y
+# CONFIG_ESP_TLS_USE_SECURE_ELEMENT is not set
+# CONFIG_ESP_TLS_CLIENT_SESSION_TICKETS is not set
+# CONFIG_ESP_TLS_SERVER is not set
+# CONFIG_ESP_TLS_PSK_VERIFICATION is not set
+# CONFIG_ESP_TLS_INSECURE is not set
+# end of ESP-TLS
+
+#
+# ESP32-specific
+#
+CONFIG_ESP32_REV_MIN_0=y
+# CONFIG_ESP32_REV_MIN_1 is not set
+# CONFIG_ESP32_REV_MIN_2 is not set
+# CONFIG_ESP32_REV_MIN_3 is not set
+CONFIG_ESP32_REV_MIN=0
+CONFIG_ESP32_DPORT_WORKAROUND=y
+# CONFIG_ESP32_DEFAULT_CPU_FREQ_80 is not set
+CONFIG_ESP32_DEFAULT_CPU_FREQ_160=y
+# CONFIG_ESP32_DEFAULT_CPU_FREQ_240 is not set
+CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ=160
+# CONFIG_ESP32_SPIRAM_SUPPORT is not set
+# CONFIG_ESP32_TRAX is not set
+CONFIG_ESP32_TRACEMEM_RESERVE_DRAM=0x0
+# CONFIG_ESP32_ULP_COPROC_ENABLED is not set
+CONFIG_ESP32_ULP_COPROC_RESERVE_MEM=0
+CONFIG_ESP32_DEBUG_OCDAWARE=y
+CONFIG_ESP32_BROWNOUT_DET=y
+CONFIG_ESP32_BROWNOUT_DET_LVL_SEL_0=y
+# CONFIG_ESP32_BROWNOUT_DET_LVL_SEL_1 is not set
+# CONFIG_ESP32_BROWNOUT_DET_LVL_SEL_2 is not set
+# CONFIG_ESP32_BROWNOUT_DET_LVL_SEL_3 is not set
+# CONFIG_ESP32_BROWNOUT_DET_LVL_SEL_4 is not set
+# CONFIG_ESP32_BROWNOUT_DET_LVL_SEL_5 is not set
+# CONFIG_ESP32_BROWNOUT_DET_LVL_SEL_6 is not set
+# CONFIG_ESP32_BROWNOUT_DET_LVL_SEL_7 is not set
+CONFIG_ESP32_BROWNOUT_DET_LVL=0
+CONFIG_ESP32_TIME_SYSCALL_USE_RTC_FRC1=y
+# CONFIG_ESP32_TIME_SYSCALL_USE_RTC is not set
+# CONFIG_ESP32_TIME_SYSCALL_USE_FRC1 is not set
+# CONFIG_ESP32_TIME_SYSCALL_USE_NONE is not set
+CONFIG_ESP32_RTC_CLK_SRC_INT_RC=y
+# CONFIG_ESP32_RTC_CLK_SRC_EXT_CRYS is not set
+# CONFIG_ESP32_RTC_CLK_SRC_EXT_OSC is not set
+# CONFIG_ESP32_RTC_CLK_SRC_INT_8MD256 is not set
+CONFIG_ESP32_RTC_CLK_CAL_CYCLES=1024
+CONFIG_ESP32_DEEP_SLEEP_WAKEUP_DELAY=2000
+CONFIG_ESP32_XTAL_FREQ_40=y
+# CONFIG_ESP32_XTAL_FREQ_26 is not set
+# CONFIG_ESP32_XTAL_FREQ_AUTO is not set
+CONFIG_ESP32_XTAL_FREQ=40
+# CONFIG_ESP32_DISABLE_BASIC_ROM_CONSOLE is not set
+# CONFIG_ESP32_NO_BLOBS is not set
+# CONFIG_ESP32_COMPATIBLE_PRE_V2_1_BOOTLOADERS is not set
+# CONFIG_ESP32_COMPATIBLE_PRE_V3_1_BOOTLOADERS is not set
+# CONFIG_ESP32_USE_FIXED_STATIC_RAM_SIZE is not set
+CONFIG_ESP32_DPORT_DIS_INTERRUPT_LVL=5
+# end of ESP32-specific
+
+#
+# ADC-Calibration
+#
+CONFIG_ADC_CAL_EFUSE_TP_ENABLE=y
+CONFIG_ADC_CAL_EFUSE_VREF_ENABLE=y
+CONFIG_ADC_CAL_LUT_ENABLE=y
+# end of ADC-Calibration
+
+#
+# Common ESP-related
+#
+CONFIG_ESP_ERR_TO_NAME_LOOKUP=y
+# end of Common ESP-related
+
+#
+# Ethernet
+#
+CONFIG_ETH_ENABLED=y
+CONFIG_ETH_USE_ESP32_EMAC=y
+CONFIG_ETH_PHY_INTERFACE_RMII=y
+CONFIG_ETH_RMII_CLK_INPUT=y
+# CONFIG_ETH_RMII_CLK_OUTPUT is not set
+CONFIG_ETH_RMII_CLK_IN_GPIO=0
+CONFIG_ETH_DMA_BUFFER_SIZE=512
+CONFIG_ETH_DMA_RX_BUFFER_NUM=10
+CONFIG_ETH_DMA_TX_BUFFER_NUM=10
+CONFIG_ETH_USE_SPI_ETHERNET=y
+# CONFIG_ETH_SPI_ETHERNET_DM9051 is not set
+# CONFIG_ETH_SPI_ETHERNET_W5500 is not set
+# CONFIG_ETH_SPI_ETHERNET_KSZ8851SNL is not set
+# CONFIG_ETH_USE_OPENETH is not set
+# end of Ethernet
+
+#
+# Event Loop Library
+#
+# CONFIG_ESP_EVENT_LOOP_PROFILING is not set
+CONFIG_ESP_EVENT_POST_FROM_ISR=y
+CONFIG_ESP_EVENT_POST_FROM_IRAM_ISR=y
+# end of Event Loop Library
+
+#
+# GDB Stub
+#
+# end of GDB Stub
+
+#
+# ESP HTTP client
+#
+CONFIG_ESP_HTTP_CLIENT_ENABLE_HTTPS=y
+# CONFIG_ESP_HTTP_CLIENT_ENABLE_BASIC_AUTH is not set
+CONFIG_ESP_HTTP_CLIENT_ENABLE_DIGEST_AUTH=y
+# end of ESP HTTP client
+
+#
+# HTTP Server
+#
+CONFIG_HTTPD_MAX_REQ_HDR_LEN=512
+CONFIG_HTTPD_MAX_URI_LEN=512
+CONFIG_HTTPD_ERR_RESP_NO_DELAY=y
+CONFIG_HTTPD_PURGE_BUF_LEN=32
+# CONFIG_HTTPD_LOG_PURGE_DATA is not set
+# CONFIG_HTTPD_WS_SUPPORT is not set
+# end of HTTP Server
+
+#
+# ESP HTTPS OTA
+#
+# CONFIG_OTA_ALLOW_HTTP is not set
+# end of ESP HTTPS OTA
+
+#
+# ESP HTTPS server
+#
+# CONFIG_ESP_HTTPS_SERVER_ENABLE is not set
+# end of ESP HTTPS server
+
+#
+# Hardware Settings
+#
+
+#
+# MAC Config
+#
+CONFIG_ESP_MAC_ADDR_UNIVERSE_WIFI_STA=y
+CONFIG_ESP_MAC_ADDR_UNIVERSE_WIFI_AP=y
+CONFIG_ESP_MAC_ADDR_UNIVERSE_BT=y
+CONFIG_ESP_MAC_ADDR_UNIVERSE_ETH=y
+# CONFIG_ESP32_UNIVERSAL_MAC_ADDRESSES_TWO is not set
+CONFIG_ESP32_UNIVERSAL_MAC_ADDRESSES_FOUR=y
+CONFIG_ESP32_UNIVERSAL_MAC_ADDRESSES=4
+# end of MAC Config
+
+#
+# Sleep Config
+#
+CONFIG_ESP_SLEEP_POWER_DOWN_FLASH=y
+CONFIG_ESP_SLEEP_RTC_BUS_ISO_WORKAROUND=y
+# CONFIG_ESP_SLEEP_GPIO_RESET_WORKAROUND is not set
+# CONFIG_ESP_SLEEP_FLASH_LEAKAGE_WORKAROUND is not set
+# end of Sleep Config
+
+#
+# RTC Clock Config
+#
+# end of RTC Clock Config
+# end of Hardware Settings
+
+#
+# IPC (Inter-Processor Call)
+#
+CONFIG_ESP_IPC_TASK_STACK_SIZE=1536
+CONFIG_ESP_IPC_USES_CALLERS_PRIORITY=y
+CONFIG_ESP_IPC_ISR_ENABLE=y
+# end of IPC (Inter-Processor Call)
+
+#
+# LCD and Touch Panel
+#
+
+#
+# LCD Peripheral Configuration
+#
+CONFIG_LCD_PANEL_IO_FORMAT_BUF_SIZE=32
+# end of LCD Peripheral Configuration
+# end of LCD and Touch Panel
+
+#
+# ESP NETIF Adapter
+#
+CONFIG_ESP_NETIF_IP_LOST_TIMER_INTERVAL=120
+CONFIG_ESP_NETIF_TCPIP_LWIP=y
+# CONFIG_ESP_NETIF_LOOPBACK is not set
+CONFIG_ESP_NETIF_TCPIP_ADAPTER_COMPATIBLE_LAYER=y
+# end of ESP NETIF Adapter
+
+#
+# PHY
+#
+CONFIG_ESP_PHY_CALIBRATION_AND_DATA_STORAGE=y
+# CONFIG_ESP_PHY_INIT_DATA_IN_PARTITION is not set
+CONFIG_ESP_PHY_MAX_WIFI_TX_POWER=20
+CONFIG_ESP_PHY_MAX_TX_POWER=20
+CONFIG_ESP_PHY_REDUCE_TX_POWER=y
+# end of PHY
+
+#
+# Power Management
+#
+# CONFIG_PM_ENABLE is not set
+# end of Power Management
+
+#
+# ESP System Settings
+#
+# CONFIG_ESP_SYSTEM_PANIC_PRINT_HALT is not set
+CONFIG_ESP_SYSTEM_PANIC_PRINT_REBOOT=y
+# CONFIG_ESP_SYSTEM_PANIC_SILENT_REBOOT is not set
+# CONFIG_ESP_SYSTEM_PANIC_GDBSTUB is not set
+# CONFIG_ESP_SYSTEM_GDBSTUB_RUNTIME is not set
+
+#
+# Memory protection
+#
+# end of Memory protection
+
+CONFIG_ESP_SYSTEM_EVENT_QUEUE_SIZE=32
+CONFIG_ESP_SYSTEM_EVENT_TASK_STACK_SIZE=2304
+CONFIG_ESP_MAIN_TASK_STACK_SIZE=3584
+CONFIG_ESP_MAIN_TASK_AFFINITY_CPU0=y
+# CONFIG_ESP_MAIN_TASK_AFFINITY_CPU1 is not set
+# CONFIG_ESP_MAIN_TASK_AFFINITY_NO_AFFINITY is not set
+CONFIG_ESP_MAIN_TASK_AFFINITY=0x0
+CONFIG_ESP_MINIMAL_SHARED_STACK_SIZE=2048
+CONFIG_ESP_CONSOLE_UART_DEFAULT=y
+# CONFIG_ESP_CONSOLE_UART_CUSTOM is not set
+# CONFIG_ESP_CONSOLE_NONE is not set
+CONFIG_ESP_CONSOLE_UART=y
+CONFIG_ESP_CONSOLE_MULTIPLE_UART=y
+CONFIG_ESP_CONSOLE_UART_NUM=0
+CONFIG_ESP_CONSOLE_UART_BAUDRATE=115200
+CONFIG_ESP_INT_WDT=y
+CONFIG_ESP_INT_WDT_TIMEOUT_MS=300
+CONFIG_ESP_INT_WDT_CHECK_CPU1=y
+CONFIG_ESP_TASK_WDT=y
+# CONFIG_ESP_TASK_WDT_PANIC is not set
+CONFIG_ESP_TASK_WDT_TIMEOUT_S=5
+CONFIG_ESP_TASK_WDT_CHECK_IDLE_TASK_CPU0=y
+CONFIG_ESP_TASK_WDT_CHECK_IDLE_TASK_CPU1=y
+# CONFIG_ESP_PANIC_HANDLER_IRAM is not set
+# CONFIG_ESP_DEBUG_STUBS_ENABLE is not set
+# CONFIG_ESP_SYSTEM_CHECK_INT_LEVEL_5 is not set
+CONFIG_ESP_SYSTEM_CHECK_INT_LEVEL_4=y
+# end of ESP System Settings
+
+#
+# High resolution timer (esp_timer)
+#
+# CONFIG_ESP_TIMER_PROFILING is not set
+CONFIG_ESP_TIME_FUNCS_USE_RTC_TIMER=y
+CONFIG_ESP_TIME_FUNCS_USE_ESP_TIMER=y
+CONFIG_ESP_TIMER_TASK_STACK_SIZE=3584
+CONFIG_ESP_TIMER_INTERRUPT_LEVEL=1
+# CONFIG_ESP_TIMER_SUPPORTS_ISR_DISPATCH_METHOD is not set
+# CONFIG_ESP_TIMER_IMPL_FRC2 is not set
+CONFIG_ESP_TIMER_IMPL_TG0_LAC=y
+# end of High resolution timer (esp_timer)
+
+#
+# Wi-Fi
+#
+CONFIG_ESP32_WIFI_ENABLED=y
+CONFIG_ESP32_WIFI_STATIC_RX_BUFFER_NUM=10
+CONFIG_ESP32_WIFI_DYNAMIC_RX_BUFFER_NUM=32
+# CONFIG_ESP32_WIFI_STATIC_TX_BUFFER is not set
+CONFIG_ESP32_WIFI_DYNAMIC_TX_BUFFER=y
+CONFIG_ESP32_WIFI_TX_BUFFER_TYPE=1
+CONFIG_ESP32_WIFI_DYNAMIC_TX_BUFFER_NUM=32
+# CONFIG_ESP32_WIFI_CSI_ENABLED is not set
+CONFIG_ESP32_WIFI_AMPDU_TX_ENABLED=y
+CONFIG_ESP32_WIFI_TX_BA_WIN=6
+CONFIG_ESP32_WIFI_AMPDU_RX_ENABLED=y
+CONFIG_ESP32_WIFI_RX_BA_WIN=6
+CONFIG_ESP32_WIFI_NVS_ENABLED=y
+CONFIG_ESP32_WIFI_TASK_PINNED_TO_CORE_0=y
+# CONFIG_ESP32_WIFI_TASK_PINNED_TO_CORE_1 is not set
+CONFIG_ESP32_WIFI_SOFTAP_BEACON_MAX_LEN=752
+CONFIG_ESP32_WIFI_MGMT_SBUF_NUM=32
+CONFIG_ESP32_WIFI_IRAM_OPT=y
+CONFIG_ESP32_WIFI_RX_IRAM_OPT=y
+CONFIG_ESP32_WIFI_ENABLE_WPA3_SAE=y
+# CONFIG_ESP_WIFI_SLP_IRAM_OPT is not set
+# CONFIG_ESP_WIFI_STA_DISCONNECTED_PM_ENABLE is not set
+# CONFIG_ESP_WIFI_GMAC_SUPPORT is not set
+CONFIG_ESP_WIFI_SOFTAP_SUPPORT=y
+# end of Wi-Fi
+
+#
+# Core dump
+#
+# CONFIG_ESP_COREDUMP_ENABLE_TO_FLASH is not set
+# CONFIG_ESP_COREDUMP_ENABLE_TO_UART is not set
+CONFIG_ESP_COREDUMP_ENABLE_TO_NONE=y
+# end of Core dump
+
+#
+# FAT Filesystem support
+#
+# CONFIG_FATFS_CODEPAGE_DYNAMIC is not set
+CONFIG_FATFS_CODEPAGE_437=y
+# CONFIG_FATFS_CODEPAGE_720 is not set
+# CONFIG_FATFS_CODEPAGE_737 is not set
+# CONFIG_FATFS_CODEPAGE_771 is not set
+# CONFIG_FATFS_CODEPAGE_775 is not set
+# CONFIG_FATFS_CODEPAGE_850 is not set
+# CONFIG_FATFS_CODEPAGE_852 is not set
+# CONFIG_FATFS_CODEPAGE_855 is not set
+# CONFIG_FATFS_CODEPAGE_857 is not set
+# CONFIG_FATFS_CODEPAGE_860 is not set
+# CONFIG_FATFS_CODEPAGE_861 is not set
+# CONFIG_FATFS_CODEPAGE_862 is not set
+# CONFIG_FATFS_CODEPAGE_863 is not set
+# CONFIG_FATFS_CODEPAGE_864 is not set
+# CONFIG_FATFS_CODEPAGE_865 is not set
+# CONFIG_FATFS_CODEPAGE_866 is not set
+# CONFIG_FATFS_CODEPAGE_869 is not set
+# CONFIG_FATFS_CODEPAGE_932 is not set
+# CONFIG_FATFS_CODEPAGE_936 is not set
+# CONFIG_FATFS_CODEPAGE_949 is not set
+# CONFIG_FATFS_CODEPAGE_950 is not set
+CONFIG_FATFS_CODEPAGE=437
+CONFIG_FATFS_LFN_NONE=y
+# CONFIG_FATFS_LFN_HEAP is not set
+# CONFIG_FATFS_LFN_STACK is not set
+CONFIG_FATFS_FS_LOCK=0
+CONFIG_FATFS_TIMEOUT_MS=10000
+CONFIG_FATFS_PER_FILE_CACHE=y
+# CONFIG_FATFS_USE_FASTSEEK is not set
+# end of FAT Filesystem support
+
+#
+# Modbus configuration
+#
+CONFIG_FMB_COMM_MODE_TCP_EN=y
+CONFIG_FMB_TCP_PORT_DEFAULT=502
+CONFIG_FMB_TCP_PORT_MAX_CONN=5
+CONFIG_FMB_TCP_CONNECTION_TOUT_SEC=20
+CONFIG_FMB_COMM_MODE_RTU_EN=y
+CONFIG_FMB_COMM_MODE_ASCII_EN=y
+CONFIG_FMB_MASTER_TIMEOUT_MS_RESPOND=150
+CONFIG_FMB_MASTER_DELAY_MS_CONVERT=200
+CONFIG_FMB_QUEUE_LENGTH=20
+CONFIG_FMB_PORT_TASK_STACK_SIZE=4096
+CONFIG_FMB_SERIAL_BUF_SIZE=256
+CONFIG_FMB_SERIAL_ASCII_BITS_PER_SYMB=8
+CONFIG_FMB_SERIAL_ASCII_TIMEOUT_RESPOND_MS=1000
+CONFIG_FMB_PORT_TASK_PRIO=10
+# CONFIG_FMB_PORT_TASK_AFFINITY_NO_AFFINITY is not set
+CONFIG_FMB_PORT_TASK_AFFINITY_CPU0=y
+# CONFIG_FMB_PORT_TASK_AFFINITY_CPU1 is not set
+CONFIG_FMB_PORT_TASK_AFFINITY=0x0
+CONFIG_FMB_CONTROLLER_SLAVE_ID_SUPPORT=y
+CONFIG_FMB_CONTROLLER_SLAVE_ID=0x00112233
+CONFIG_FMB_CONTROLLER_NOTIFY_TIMEOUT=20
+CONFIG_FMB_CONTROLLER_NOTIFY_QUEUE_SIZE=20
+CONFIG_FMB_CONTROLLER_STACK_SIZE=4096
+CONFIG_FMB_EVENT_QUEUE_TIMEOUT=20
+# CONFIG_FMB_TIMER_PORT_ENABLED is not set
+CONFIG_FMB_TIMER_GROUP=0
+CONFIG_FMB_TIMER_INDEX=0
+CONFIG_FMB_MASTER_TIMER_GROUP=0
+CONFIG_FMB_MASTER_TIMER_INDEX=0
+# CONFIG_FMB_TIMER_ISR_IN_IRAM is not set
+# end of Modbus configuration
+
+#
+# FreeRTOS
+#
+# CONFIG_FREERTOS_UNICORE is not set
+CONFIG_FREERTOS_NO_AFFINITY=0x7FFFFFFF
+CONFIG_FREERTOS_TICK_SUPPORT_CORETIMER=y
+CONFIG_FREERTOS_CORETIMER_0=y
+# CONFIG_FREERTOS_CORETIMER_1 is not set
+CONFIG_FREERTOS_SYSTICK_USES_CCOUNT=y
+CONFIG_FREERTOS_HZ=100
+CONFIG_FREERTOS_ASSERT_ON_UNTESTED_FUNCTION=y
+# CONFIG_FREERTOS_CHECK_STACKOVERFLOW_NONE is not set
+# CONFIG_FREERTOS_CHECK_STACKOVERFLOW_PTRVAL is not set
+CONFIG_FREERTOS_CHECK_STACKOVERFLOW_CANARY=y
+# CONFIG_FREERTOS_WATCHPOINT_END_OF_STACK is not set
+CONFIG_FREERTOS_INTERRUPT_BACKTRACE=y
+CONFIG_FREERTOS_THREAD_LOCAL_STORAGE_POINTERS=1
+CONFIG_FREERTOS_ASSERT_FAIL_ABORT=y
+# CONFIG_FREERTOS_ASSERT_FAIL_PRINT_CONTINUE is not set
+# CONFIG_FREERTOS_ASSERT_DISABLE is not set
+CONFIG_FREERTOS_IDLE_TASK_STACKSIZE=1536
+CONFIG_FREERTOS_ISR_STACKSIZE=1536
+# CONFIG_FREERTOS_LEGACY_HOOKS is not set
+CONFIG_FREERTOS_MAX_TASK_NAME_LEN=16
+CONFIG_FREERTOS_SUPPORT_STATIC_ALLOCATION=y
+# CONFIG_FREERTOS_ENABLE_STATIC_TASK_CLEAN_UP is not set
+CONFIG_FREERTOS_TIMER_TASK_PRIORITY=1
+CONFIG_FREERTOS_TIMER_TASK_STACK_DEPTH=2048
+CONFIG_FREERTOS_TIMER_QUEUE_LENGTH=10
+CONFIG_FREERTOS_QUEUE_REGISTRY_SIZE=0
+# CONFIG_FREERTOS_USE_TRACE_FACILITY is not set
+# CONFIG_FREERTOS_GENERATE_RUN_TIME_STATS is not set
+CONFIG_FREERTOS_TASK_FUNCTION_WRAPPER=y
+CONFIG_FREERTOS_CHECK_MUTEX_GIVEN_BY_OWNER=y
+# CONFIG_FREERTOS_CHECK_PORT_CRITICAL_COMPLIANCE is not set
+# CONFIG_FREERTOS_PLACE_FUNCTIONS_INTO_FLASH is not set
+CONFIG_FREERTOS_DEBUG_OCDAWARE=y
+# CONFIG_FREERTOS_FPU_IN_ISR is not set
+CONFIG_FREERTOS_ENABLE_TASK_SNAPSHOT=y
+# CONFIG_FREERTOS_PLACE_SNAPSHOT_FUNS_INTO_FLASH is not set
+# end of FreeRTOS
+
+#
+# Hardware Abstraction Layer (HAL) and Low Level (LL)
+#
+CONFIG_HAL_ASSERTION_EQUALS_SYSTEM=y
+# CONFIG_HAL_ASSERTION_DISABLE is not set
+# CONFIG_HAL_ASSERTION_SILIENT is not set
+# CONFIG_HAL_ASSERTION_ENABLE is not set
+CONFIG_HAL_DEFAULT_ASSERTION_LEVEL=2
+# end of Hardware Abstraction Layer (HAL) and Low Level (LL)
+
+#
+# Heap memory debugging
+#
+CONFIG_HEAP_POISONING_DISABLED=y
+# CONFIG_HEAP_POISONING_LIGHT is not set
+# CONFIG_HEAP_POISONING_COMPREHENSIVE is not set
+CONFIG_HEAP_TRACING_OFF=y
+# CONFIG_HEAP_TRACING_STANDALONE is not set
+# CONFIG_HEAP_TRACING_TOHOST is not set
+# CONFIG_HEAP_ABORT_WHEN_ALLOCATION_FAILS is not set
+# end of Heap memory debugging
+
+#
+# jsmn
+#
+# CONFIG_JSMN_PARENT_LINKS is not set
+# CONFIG_JSMN_STRICT is not set
+# end of jsmn
+
+#
+# libsodium
+#
+# end of libsodium
+
+#
+# Log output
+#
+# CONFIG_LOG_DEFAULT_LEVEL_NONE is not set
+# CONFIG_LOG_DEFAULT_LEVEL_ERROR is not set
+# CONFIG_LOG_DEFAULT_LEVEL_WARN is not set
+CONFIG_LOG_DEFAULT_LEVEL_INFO=y
+# CONFIG_LOG_DEFAULT_LEVEL_DEBUG is not set
+# CONFIG_LOG_DEFAULT_LEVEL_VERBOSE is not set
+CONFIG_LOG_DEFAULT_LEVEL=3
+CONFIG_LOG_MAXIMUM_EQUALS_DEFAULT=y
+# CONFIG_LOG_MAXIMUM_LEVEL_DEBUG is not set
+# CONFIG_LOG_MAXIMUM_LEVEL_VERBOSE is not set
+CONFIG_LOG_MAXIMUM_LEVEL=3
+CONFIG_LOG_COLORS=y
+CONFIG_LOG_TIMESTAMP_SOURCE_RTOS=y
+# CONFIG_LOG_TIMESTAMP_SOURCE_SYSTEM is not set
+# end of Log output
+
+#
+# LWIP
+#
+CONFIG_LWIP_LOCAL_HOSTNAME="espressif"
+# CONFIG_LWIP_NETIF_API is not set
+# CONFIG_LWIP_TCPIP_CORE_LOCKING is not set
+CONFIG_LWIP_DNS_SUPPORT_MDNS_QUERIES=y
+# CONFIG_LWIP_L2_TO_L3_COPY is not set
+# CONFIG_LWIP_IRAM_OPTIMIZATION is not set
+CONFIG_LWIP_TIMERS_ONDEMAND=y
+CONFIG_LWIP_MAX_SOCKETS=10
+# CONFIG_LWIP_USE_ONLY_LWIP_SELECT is not set
+# CONFIG_LWIP_SO_LINGER is not set
+CONFIG_LWIP_SO_REUSE=y
+CONFIG_LWIP_SO_REUSE_RXTOALL=y
+# CONFIG_LWIP_SO_RCVBUF is not set
+# CONFIG_LWIP_NETBUF_RECVINFO is not set
+CONFIG_LWIP_IP4_FRAG=y
+CONFIG_LWIP_IP6_FRAG=y
+# CONFIG_LWIP_IP4_REASSEMBLY is not set
+# CONFIG_LWIP_IP6_REASSEMBLY is not set
+# CONFIG_LWIP_IP_FORWARD is not set
+# CONFIG_LWIP_STATS is not set
+# CONFIG_LWIP_ETHARP_TRUST_IP_MAC is not set
+CONFIG_LWIP_ESP_GRATUITOUS_ARP=y
+CONFIG_LWIP_GARP_TMR_INTERVAL=60
+CONFIG_LWIP_TCPIP_RECVMBOX_SIZE=32
+CONFIG_LWIP_DHCP_DOES_ARP_CHECK=y
+# CONFIG_LWIP_DHCP_DISABLE_CLIENT_ID is not set
+CONFIG_LWIP_DHCP_DISABLE_VENDOR_CLASS_ID=y
+# CONFIG_LWIP_DHCP_RESTORE_LAST_IP is not set
+CONFIG_LWIP_DHCP_OPTIONS_LEN=68
+
+#
+# DHCP server
+#
+CONFIG_LWIP_DHCPS=y
+CONFIG_LWIP_DHCPS_LEASE_UNIT=60
+CONFIG_LWIP_DHCPS_MAX_STATION_NUM=8
+# end of DHCP server
+
+# CONFIG_LWIP_AUTOIP is not set
+CONFIG_LWIP_IPV6=y
+# CONFIG_LWIP_IPV6_AUTOCONFIG is not set
+CONFIG_LWIP_IPV6_NUM_ADDRESSES=3
+# CONFIG_LWIP_IPV6_FORWARD is not set
+# CONFIG_LWIP_NETIF_STATUS_CALLBACK is not set
+CONFIG_LWIP_NETIF_LOOPBACK=y
+CONFIG_LWIP_LOOPBACK_MAX_PBUFS=8
+
+#
+# TCP
+#
+CONFIG_LWIP_MAX_ACTIVE_TCP=16
+CONFIG_LWIP_MAX_LISTENING_TCP=16
+CONFIG_LWIP_TCP_HIGH_SPEED_RETRANSMISSION=y
+CONFIG_LWIP_TCP_MAXRTX=12
+CONFIG_LWIP_TCP_SYNMAXRTX=12
+CONFIG_LWIP_TCP_MSS=1440
+CONFIG_LWIP_TCP_TMR_INTERVAL=250
+CONFIG_LWIP_TCP_MSL=60000
+CONFIG_LWIP_TCP_SND_BUF_DEFAULT=5744
+CONFIG_LWIP_TCP_WND_DEFAULT=5744
+CONFIG_LWIP_TCP_RECVMBOX_SIZE=6
+CONFIG_LWIP_TCP_QUEUE_OOSEQ=y
+# CONFIG_LWIP_TCP_SACK_OUT is not set
+# CONFIG_LWIP_TCP_KEEP_CONNECTION_WHEN_IP_CHANGES is not set
+CONFIG_LWIP_TCP_OVERSIZE_MSS=y
+# CONFIG_LWIP_TCP_OVERSIZE_QUARTER_MSS is not set
+# CONFIG_LWIP_TCP_OVERSIZE_DISABLE is not set
+CONFIG_LWIP_TCP_RTO_TIME=1500
+# end of TCP
+
+#
+# UDP
+#
+CONFIG_LWIP_MAX_UDP_PCBS=16
+CONFIG_LWIP_UDP_RECVMBOX_SIZE=6
+# end of UDP
+
+#
+# Checksums
+#
+# CONFIG_LWIP_CHECKSUM_CHECK_IP is not set
+# CONFIG_LWIP_CHECKSUM_CHECK_UDP is not set
+CONFIG_LWIP_CHECKSUM_CHECK_ICMP=y
+# end of Checksums
+
+CONFIG_LWIP_TCPIP_TASK_STACK_SIZE=3072
+CONFIG_LWIP_TCPIP_TASK_AFFINITY_NO_AFFINITY=y
+# CONFIG_LWIP_TCPIP_TASK_AFFINITY_CPU0 is not set
+# CONFIG_LWIP_TCPIP_TASK_AFFINITY_CPU1 is not set
+CONFIG_LWIP_TCPIP_TASK_AFFINITY=0x7FFFFFFF
+# CONFIG_LWIP_PPP_SUPPORT is not set
+CONFIG_LWIP_IPV6_MEMP_NUM_ND6_QUEUE=3
+CONFIG_LWIP_IPV6_ND6_NUM_NEIGHBORS=5
+# CONFIG_LWIP_SLIP_SUPPORT is not set
+
+#
+# ICMP
+#
+CONFIG_LWIP_ICMP=y
+# CONFIG_LWIP_MULTICAST_PING is not set
+# CONFIG_LWIP_BROADCAST_PING is not set
+# end of ICMP
+
+#
+# LWIP RAW API
+#
+CONFIG_LWIP_MAX_RAW_PCBS=16
+# end of LWIP RAW API
+
+#
+# SNTP
+#
+CONFIG_LWIP_SNTP_MAX_SERVERS=1
+# CONFIG_LWIP_DHCP_GET_NTP_SRV is not set
+CONFIG_LWIP_SNTP_UPDATE_DELAY=3600000
+# end of SNTP
+
+CONFIG_LWIP_ESP_LWIP_ASSERT=y
+
+#
+# Hooks
+#
+# CONFIG_LWIP_HOOK_TCP_ISN_NONE is not set
+CONFIG_LWIP_HOOK_TCP_ISN_DEFAULT=y
+# CONFIG_LWIP_HOOK_TCP_ISN_CUSTOM is not set
+CONFIG_LWIP_HOOK_IP6_ROUTE_NONE=y
+# CONFIG_LWIP_HOOK_IP6_ROUTE_DEFAULT is not set
+# CONFIG_LWIP_HOOK_IP6_ROUTE_CUSTOM is not set
+CONFIG_LWIP_HOOK_ND6_GET_GW_NONE=y
+# CONFIG_LWIP_HOOK_ND6_GET_GW_DEFAULT is not set
+# CONFIG_LWIP_HOOK_ND6_GET_GW_CUSTOM is not set
+CONFIG_LWIP_HOOK_NETCONN_EXT_RESOLVE_NONE=y
+# CONFIG_LWIP_HOOK_NETCONN_EXT_RESOLVE_DEFAULT is not set
+# CONFIG_LWIP_HOOK_NETCONN_EXT_RESOLVE_CUSTOM is not set
+# end of Hooks
+
+# CONFIG_LWIP_DEBUG is not set
+# end of LWIP
+
+#
+# mbedTLS
+#
+CONFIG_MBEDTLS_INTERNAL_MEM_ALLOC=y
+# CONFIG_MBEDTLS_DEFAULT_MEM_ALLOC is not set
+# CONFIG_MBEDTLS_CUSTOM_MEM_ALLOC is not set
+CONFIG_MBEDTLS_ASYMMETRIC_CONTENT_LEN=y
+CONFIG_MBEDTLS_SSL_IN_CONTENT_LEN=16384
+CONFIG_MBEDTLS_SSL_OUT_CONTENT_LEN=4096
+# CONFIG_MBEDTLS_DYNAMIC_BUFFER is not set
+# CONFIG_MBEDTLS_DEBUG is not set
+
+#
+# mbedTLS v2.28.x related
+#
+# CONFIG_MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH is not set
+# CONFIG_MBEDTLS_X509_TRUSTED_CERT_CALLBACK is not set
+# CONFIG_MBEDTLS_SSL_CONTEXT_SERIALIZATION is not set
+CONFIG_MBEDTLS_SSL_KEEP_PEER_CERTIFICATE=y
+# end of mbedTLS v2.28.x related
+
+#
+# Certificate Bundle
+#
+CONFIG_MBEDTLS_CERTIFICATE_BUNDLE=y
+CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_DEFAULT_FULL=y
+# CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_DEFAULT_CMN is not set
+# CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_DEFAULT_NONE is not set
+# CONFIG_MBEDTLS_CUSTOM_CERTIFICATE_BUNDLE is not set
+# end of Certificate Bundle
+
+# CONFIG_MBEDTLS_ECP_RESTARTABLE is not set
+# CONFIG_MBEDTLS_CMAC_C is not set
+CONFIG_MBEDTLS_HARDWARE_AES=y
+CONFIG_MBEDTLS_HARDWARE_MPI=y
+CONFIG_MBEDTLS_HARDWARE_SHA=y
+CONFIG_MBEDTLS_ROM_MD5=y
+# CONFIG_MBEDTLS_ATCA_HW_ECDSA_SIGN is not set
+# CONFIG_MBEDTLS_ATCA_HW_ECDSA_VERIFY is not set
+CONFIG_MBEDTLS_HAVE_TIME=y
+# CONFIG_MBEDTLS_HAVE_TIME_DATE is not set
+CONFIG_MBEDTLS_ECDSA_DETERMINISTIC=y
+CONFIG_MBEDTLS_SHA512_C=y
+CONFIG_MBEDTLS_TLS_SERVER_AND_CLIENT=y
+# CONFIG_MBEDTLS_TLS_SERVER_ONLY is not set
+# CONFIG_MBEDTLS_TLS_CLIENT_ONLY is not set
+# CONFIG_MBEDTLS_TLS_DISABLED is not set
+CONFIG_MBEDTLS_TLS_SERVER=y
+CONFIG_MBEDTLS_TLS_CLIENT=y
+CONFIG_MBEDTLS_TLS_ENABLED=y
+
+#
+# TLS Key Exchange Methods
+#
+# CONFIG_MBEDTLS_PSK_MODES is not set
+CONFIG_MBEDTLS_KEY_EXCHANGE_RSA=y
+CONFIG_MBEDTLS_KEY_EXCHANGE_DHE_RSA=y
+CONFIG_MBEDTLS_KEY_EXCHANGE_ELLIPTIC_CURVE=y
+CONFIG_MBEDTLS_KEY_EXCHANGE_ECDHE_RSA=y
+CONFIG_MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA=y
+CONFIG_MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA=y
+CONFIG_MBEDTLS_KEY_EXCHANGE_ECDH_RSA=y
+# end of TLS Key Exchange Methods
+
+CONFIG_MBEDTLS_SSL_RENEGOTIATION=y
+# CONFIG_MBEDTLS_SSL_PROTO_SSL3 is not set
+CONFIG_MBEDTLS_SSL_PROTO_TLS1=y
+CONFIG_MBEDTLS_SSL_PROTO_TLS1_1=y
+CONFIG_MBEDTLS_SSL_PROTO_TLS1_2=y
+# CONFIG_MBEDTLS_SSL_PROTO_GMTSSL1_1 is not set
+# CONFIG_MBEDTLS_SSL_PROTO_DTLS is not set
+CONFIG_MBEDTLS_SSL_ALPN=y
+CONFIG_MBEDTLS_CLIENT_SSL_SESSION_TICKETS=y
+CONFIG_MBEDTLS_X509_CHECK_KEY_USAGE=y
+CONFIG_MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE=y
+CONFIG_MBEDTLS_SERVER_SSL_SESSION_TICKETS=y
+
+#
+# Symmetric Ciphers
+#
+CONFIG_MBEDTLS_AES_C=y
+# CONFIG_MBEDTLS_CAMELLIA_C is not set
+# CONFIG_MBEDTLS_DES_C is not set
+CONFIG_MBEDTLS_RC4_DISABLED=y
+# CONFIG_MBEDTLS_RC4_ENABLED_NO_DEFAULT is not set
+# CONFIG_MBEDTLS_RC4_ENABLED is not set
+# CONFIG_MBEDTLS_BLOWFISH_C is not set
+# CONFIG_MBEDTLS_XTEA_C is not set
+CONFIG_MBEDTLS_CCM_C=y
+CONFIG_MBEDTLS_GCM_C=y
+# CONFIG_MBEDTLS_NIST_KW_C is not set
+# end of Symmetric Ciphers
+
+# CONFIG_MBEDTLS_RIPEMD160_C is not set
+
+#
+# Certificates
+#
+CONFIG_MBEDTLS_PEM_PARSE_C=y
+CONFIG_MBEDTLS_PEM_WRITE_C=y
+CONFIG_MBEDTLS_X509_CRL_PARSE_C=y
+CONFIG_MBEDTLS_X509_CSR_PARSE_C=y
+# end of Certificates
+
+CONFIG_MBEDTLS_ECP_C=y
+CONFIG_MBEDTLS_ECDH_C=y
+CONFIG_MBEDTLS_ECDSA_C=y
+# CONFIG_MBEDTLS_ECJPAKE_C is not set
+CONFIG_MBEDTLS_ECP_DP_SECP192R1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_SECP224R1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_SECP256R1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_SECP384R1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_SECP521R1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_SECP192K1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_SECP224K1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_SECP256K1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_BP256R1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_BP384R1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_BP512R1_ENABLED=y
+CONFIG_MBEDTLS_ECP_DP_CURVE25519_ENABLED=y
+CONFIG_MBEDTLS_ECP_NIST_OPTIM=y
+# CONFIG_MBEDTLS_POLY1305_C is not set
+# CONFIG_MBEDTLS_CHACHA20_C is not set
+# CONFIG_MBEDTLS_HKDF_C is not set
+# CONFIG_MBEDTLS_THREADING_C is not set
+# CONFIG_MBEDTLS_LARGE_KEY_SOFTWARE_MPI is not set
+# CONFIG_MBEDTLS_SECURITY_RISKS is not set
+# end of mbedTLS
+
+#
+# mDNS
+#
+CONFIG_MDNS_MAX_SERVICES=10
+CONFIG_MDNS_TASK_PRIORITY=1
+CONFIG_MDNS_TASK_STACK_SIZE=4096
+# CONFIG_MDNS_TASK_AFFINITY_NO_AFFINITY is not set
+CONFIG_MDNS_TASK_AFFINITY_CPU0=y
+# CONFIG_MDNS_TASK_AFFINITY_CPU1 is not set
+CONFIG_MDNS_TASK_AFFINITY=0x0
+CONFIG_MDNS_SERVICE_ADD_TIMEOUT_MS=2000
+# CONFIG_MDNS_STRICT_MODE is not set
+CONFIG_MDNS_TIMER_PERIOD_MS=100
+# CONFIG_MDNS_NETWORKING_SOCKET is not set
+CONFIG_MDNS_MULTIPLE_INSTANCE=y
+# end of mDNS
+
+#
+# ESP-MQTT Configurations
+#
+CONFIG_MQTT_PROTOCOL_311=y
+CONFIG_MQTT_TRANSPORT_SSL=y
+CONFIG_MQTT_TRANSPORT_WEBSOCKET=y
+CONFIG_MQTT_TRANSPORT_WEBSOCKET_SECURE=y
+# CONFIG_MQTT_MSG_ID_INCREMENTAL is not set
+# CONFIG_MQTT_SKIP_PUBLISH_IF_DISCONNECTED is not set
+# CONFIG_MQTT_REPORT_DELETED_MESSAGES is not set
+# CONFIG_MQTT_USE_CUSTOM_CONFIG is not set
+# CONFIG_MQTT_TASK_CORE_SELECTION_ENABLED is not set
+# CONFIG_MQTT_CUSTOM_OUTBOX is not set
+# end of ESP-MQTT Configurations
+
+#
+# Newlib
+#
+CONFIG_NEWLIB_STDOUT_LINE_ENDING_CRLF=y
+# CONFIG_NEWLIB_STDOUT_LINE_ENDING_LF is not set
+# CONFIG_NEWLIB_STDOUT_LINE_ENDING_CR is not set
+# CONFIG_NEWLIB_STDIN_LINE_ENDING_CRLF is not set
+# CONFIG_NEWLIB_STDIN_LINE_ENDING_LF is not set
+CONFIG_NEWLIB_STDIN_LINE_ENDING_CR=y
+# CONFIG_NEWLIB_NANO_FORMAT is not set
+# end of Newlib
+
+#
+# NVS
+#
+# end of NVS
+
+#
+# OpenSSL
+#
+# CONFIG_OPENSSL_DEBUG is not set
+CONFIG_OPENSSL_ERROR_STACK=y
+# CONFIG_OPENSSL_ASSERT_DO_NOTHING is not set
+CONFIG_OPENSSL_ASSERT_EXIT=y
+# end of OpenSSL
+
+#
+# OpenThread
+#
+# CONFIG_OPENTHREAD_ENABLED is not set
+# end of OpenThread
+
+#
+# PThreads
+#
+CONFIG_PTHREAD_TASK_PRIO_DEFAULT=5
+CONFIG_PTHREAD_TASK_STACK_SIZE_DEFAULT=3072
+CONFIG_PTHREAD_STACK_MIN=768
+CONFIG_PTHREAD_DEFAULT_CORE_NO_AFFINITY=y
+# CONFIG_PTHREAD_DEFAULT_CORE_0 is not set
+# CONFIG_PTHREAD_DEFAULT_CORE_1 is not set
+CONFIG_PTHREAD_TASK_CORE_DEFAULT=-1
+CONFIG_PTHREAD_TASK_NAME_DEFAULT="pthread"
+# end of PThreads
+
+#
+# SPI Flash driver
+#
+# CONFIG_SPI_FLASH_VERIFY_WRITE is not set
+# CONFIG_SPI_FLASH_ENABLE_COUNTERS is not set
+CONFIG_SPI_FLASH_ROM_DRIVER_PATCH=y
+CONFIG_SPI_FLASH_DANGEROUS_WRITE_ABORTS=y
+# CONFIG_SPI_FLASH_DANGEROUS_WRITE_FAILS is not set
+# CONFIG_SPI_FLASH_DANGEROUS_WRITE_ALLOWED is not set
+# CONFIG_SPI_FLASH_USE_LEGACY_IMPL is not set
+# CONFIG_SPI_FLASH_SHARE_SPI1_BUS is not set
+# CONFIG_SPI_FLASH_BYPASS_BLOCK_ERASE is not set
+CONFIG_SPI_FLASH_YIELD_DURING_ERASE=y
+CONFIG_SPI_FLASH_ERASE_YIELD_DURATION_MS=20
+CONFIG_SPI_FLASH_ERASE_YIELD_TICKS=1
+CONFIG_SPI_FLASH_WRITE_CHUNK_SIZE=8192
+# CONFIG_SPI_FLASH_SIZE_OVERRIDE is not set
+# CONFIG_SPI_FLASH_CHECK_ERASE_TIMEOUT_DISABLED is not set
+# CONFIG_SPI_FLASH_OVERRIDE_CHIP_DRIVER_LIST is not set
+
+#
+# Auto-detect flash chips
+#
+CONFIG_SPI_FLASH_SUPPORT_ISSI_CHIP=y
+CONFIG_SPI_FLASH_SUPPORT_MXIC_CHIP=y
+CONFIG_SPI_FLASH_SUPPORT_GD_CHIP=y
+CONFIG_SPI_FLASH_SUPPORT_WINBOND_CHIP=y
+# CONFIG_SPI_FLASH_SUPPORT_BOYA_CHIP is not set
+# CONFIG_SPI_FLASH_SUPPORT_TH_CHIP is not set
+# end of Auto-detect flash chips
+
+CONFIG_SPI_FLASH_ENABLE_ENCRYPTED_READ_WRITE=y
+# end of SPI Flash driver
+
+#
+# SPIFFS Configuration
+#
+CONFIG_SPIFFS_MAX_PARTITIONS=3
+
+#
+# SPIFFS Cache Configuration
+#
+CONFIG_SPIFFS_CACHE=y
+CONFIG_SPIFFS_CACHE_WR=y
+# CONFIG_SPIFFS_CACHE_STATS is not set
+# end of SPIFFS Cache Configuration
+
+CONFIG_SPIFFS_PAGE_CHECK=y
+CONFIG_SPIFFS_GC_MAX_RUNS=10
+# CONFIG_SPIFFS_GC_STATS is not set
+CONFIG_SPIFFS_PAGE_SIZE=256
+CONFIG_SPIFFS_OBJ_NAME_LEN=32
+# CONFIG_SPIFFS_FOLLOW_SYMLINKS is not set
+CONFIG_SPIFFS_USE_MAGIC=y
+CONFIG_SPIFFS_USE_MAGIC_LENGTH=y
+CONFIG_SPIFFS_META_LENGTH=4
+CONFIG_SPIFFS_USE_MTIME=y
+
+#
+# Debug Configuration
+#
+# CONFIG_SPIFFS_DBG is not set
+# CONFIG_SPIFFS_API_DBG is not set
+# CONFIG_SPIFFS_GC_DBG is not set
+# CONFIG_SPIFFS_CACHE_DBG is not set
+# CONFIG_SPIFFS_CHECK_DBG is not set
+# CONFIG_SPIFFS_TEST_VISUALISATION is not set
+# end of Debug Configuration
+# end of SPIFFS Configuration
+
+#
+# TCP Transport
+#
+
+#
+# Websocket
+#
+CONFIG_WS_TRANSPORT=y
+CONFIG_WS_BUFFER_SIZE=1024
+# end of Websocket
+# end of TCP Transport
+
+#
+# Unity unit testing library
+#
+CONFIG_UNITY_ENABLE_FLOAT=y
+CONFIG_UNITY_ENABLE_DOUBLE=y
+# CONFIG_UNITY_ENABLE_64BIT is not set
+# CONFIG_UNITY_ENABLE_COLOR is not set
+CONFIG_UNITY_ENABLE_IDF_TEST_RUNNER=y
+# CONFIG_UNITY_ENABLE_FIXTURE is not set
+# CONFIG_UNITY_ENABLE_BACKTRACE_ON_FAIL is not set
+# end of Unity unit testing library
+
+#
+# Virtual file system
+#
+CONFIG_VFS_SUPPORT_IO=y
+CONFIG_VFS_SUPPORT_DIR=y
+CONFIG_VFS_SUPPORT_SELECT=y
+CONFIG_VFS_SUPPRESS_SELECT_DEBUG_OUTPUT=y
+CONFIG_VFS_SUPPORT_TERMIOS=y
+
+#
+# Host File System I/O (Semihosting)
+#
+CONFIG_VFS_SEMIHOSTFS_MAX_MOUNT_POINTS=1
+CONFIG_VFS_SEMIHOSTFS_HOST_PATH_MAX_LEN=128
+# end of Host File System I/O (Semihosting)
+# end of Virtual file system
+
+#
+# Wear Levelling
+#
+# CONFIG_WL_SECTOR_SIZE_512 is not set
+CONFIG_WL_SECTOR_SIZE_4096=y
+CONFIG_WL_SECTOR_SIZE=4096
+# end of Wear Levelling
+
+#
+# Wi-Fi Provisioning Manager
+#
+CONFIG_WIFI_PROV_SCAN_MAX_ENTRIES=16
+CONFIG_WIFI_PROV_AUTOSTOP_TIMEOUT=30
+# end of Wi-Fi Provisioning Manager
+
+#
+# Supplicant
+#
+CONFIG_WPA_MBEDTLS_CRYPTO=y
+# CONFIG_WPA_WAPI_PSK is not set
+# CONFIG_WPA_SUITE_B_192 is not set
+# CONFIG_WPA_DEBUG_PRINT is not set
+# CONFIG_WPA_TESTING_OPTIONS is not set
+# CONFIG_WPA_WPS_STRICT is not set
+# CONFIG_WPA_11KV_SUPPORT is not set
+# CONFIG_WPA_MBO_SUPPORT is not set
+# CONFIG_WPA_DPP_SUPPORT is not set
+# end of Supplicant
+# end of Component config
+
+#
+# Compatibility options
+#
+# CONFIG_LEGACY_INCLUDE_COMMON_HEADERS is not set
+# end of Compatibility options
+
+# Deprecated options for backward compatibility
+CONFIG_TOOLPREFIX="xtensa-esp32-elf-"
+# CONFIG_LOG_BOOTLOADER_LEVEL_NONE is not set
+# CONFIG_LOG_BOOTLOADER_LEVEL_ERROR is not set
+# CONFIG_LOG_BOOTLOADER_LEVEL_WARN is not set
+CONFIG_LOG_BOOTLOADER_LEVEL_INFO=y
+# CONFIG_LOG_BOOTLOADER_LEVEL_DEBUG is not set
+# CONFIG_LOG_BOOTLOADER_LEVEL_VERBOSE is not set
+CONFIG_LOG_BOOTLOADER_LEVEL=3
+# CONFIG_APP_ROLLBACK_ENABLE is not set
+# CONFIG_FLASH_ENCRYPTION_ENABLED is not set
+# CONFIG_FLASHMODE_QIO is not set
+# CONFIG_FLASHMODE_QOUT is not set
+CONFIG_FLASHMODE_DIO=y
+# CONFIG_FLASHMODE_DOUT is not set
+# CONFIG_MONITOR_BAUD_9600B is not set
+# CONFIG_MONITOR_BAUD_57600B is not set
+CONFIG_MONITOR_BAUD_115200B=y
+# CONFIG_MONITOR_BAUD_230400B is not set
+# CONFIG_MONITOR_BAUD_921600B is not set
+# CONFIG_MONITOR_BAUD_2MB is not set
+# CONFIG_MONITOR_BAUD_OTHER is not set
+CONFIG_MONITOR_BAUD_OTHER_VAL=115200
+CONFIG_MONITOR_BAUD=115200
+CONFIG_COMPILER_OPTIMIZATION_LEVEL_DEBUG=y
+# CONFIG_COMPILER_OPTIMIZATION_LEVEL_RELEASE is not set
+CONFIG_OPTIMIZATION_ASSERTIONS_ENABLED=y
+# CONFIG_OPTIMIZATION_ASSERTIONS_SILENT is not set
+# CONFIG_OPTIMIZATION_ASSERTIONS_DISABLED is not set
+CONFIG_OPTIMIZATION_ASSERTION_LEVEL=2
+# CONFIG_CXX_EXCEPTIONS is not set
+CONFIG_STACK_CHECK_NONE=y
+# CONFIG_STACK_CHECK_NORM is not set
+# CONFIG_STACK_CHECK_STRONG is not set
+# CONFIG_STACK_CHECK_ALL is not set
+# CONFIG_WARN_WRITE_STRINGS is not set
+# CONFIG_DISABLE_GCC8_WARNINGS is not set
+# CONFIG_ESP32_APPTRACE_DEST_TRAX is not set
+CONFIG_ESP32_APPTRACE_DEST_NONE=y
+CONFIG_ESP32_APPTRACE_LOCK_ENABLE=y
+CONFIG_ADC2_DISABLE_DAC=y
+# CONFIG_SPIRAM_SUPPORT is not set
+CONFIG_TRACEMEM_RESERVE_DRAM=0x0
+# CONFIG_ULP_COPROC_ENABLED is not set
+CONFIG_ULP_COPROC_RESERVE_MEM=0
+CONFIG_BROWNOUT_DET=y
+CONFIG_BROWNOUT_DET_LVL_SEL_0=y
+# CONFIG_BROWNOUT_DET_LVL_SEL_1 is not set
+# CONFIG_BROWNOUT_DET_LVL_SEL_2 is not set
+# CONFIG_BROWNOUT_DET_LVL_SEL_3 is not set
+# CONFIG_BROWNOUT_DET_LVL_SEL_4 is not set
+# CONFIG_BROWNOUT_DET_LVL_SEL_5 is not set
+# CONFIG_BROWNOUT_DET_LVL_SEL_6 is not set
+# CONFIG_BROWNOUT_DET_LVL_SEL_7 is not set
+CONFIG_BROWNOUT_DET_LVL=0
+CONFIG_ESP32_RTC_CLOCK_SOURCE_INTERNAL_RC=y
+# CONFIG_ESP32_RTC_CLOCK_SOURCE_EXTERNAL_CRYSTAL is not set
+# CONFIG_ESP32_RTC_CLOCK_SOURCE_EXTERNAL_OSC is not set
+# CONFIG_ESP32_RTC_CLOCK_SOURCE_INTERNAL_8MD256 is not set
+# CONFIG_DISABLE_BASIC_ROM_CONSOLE is not set
+# CONFIG_NO_BLOBS is not set
+# CONFIG_COMPATIBLE_PRE_V2_1_BOOTLOADERS is not set
+# CONFIG_EVENT_LOOP_PROFILING is not set
+CONFIG_POST_EVENTS_FROM_ISR=y
+CONFIG_POST_EVENTS_FROM_IRAM_ISR=y
+# CONFIG_TWO_UNIVERSAL_MAC_ADDRESS is not set
+CONFIG_FOUR_UNIVERSAL_MAC_ADDRESS=y
+CONFIG_NUMBER_OF_UNIVERSAL_MAC_ADDRESS=4
+CONFIG_ESP_SYSTEM_PD_FLASH=y
+# CONFIG_ESP32C3_LIGHTSLEEP_GPIO_RESET_WORKAROUND is not set
+CONFIG_IPC_TASK_STACK_SIZE=1536
+CONFIG_ESP32_PHY_CALIBRATION_AND_DATA_STORAGE=y
+# CONFIG_ESP32_PHY_INIT_DATA_IN_PARTITION is not set
+CONFIG_ESP32_PHY_MAX_WIFI_TX_POWER=20
+CONFIG_ESP32_PHY_MAX_TX_POWER=20
+CONFIG_ESP32_REDUCE_PHY_TX_POWER=y
+# CONFIG_ESP32S2_PANIC_PRINT_HALT is not set
+CONFIG_ESP32S2_PANIC_PRINT_REBOOT=y
+# CONFIG_ESP32S2_PANIC_SILENT_REBOOT is not set
+# CONFIG_ESP32S2_PANIC_GDBSTUB is not set
+CONFIG_SYSTEM_EVENT_QUEUE_SIZE=32
+CONFIG_SYSTEM_EVENT_TASK_STACK_SIZE=2304
+CONFIG_MAIN_TASK_STACK_SIZE=3584
+CONFIG_CONSOLE_UART_DEFAULT=y
+# CONFIG_CONSOLE_UART_CUSTOM is not set
+# CONFIG_ESP_CONSOLE_UART_NONE is not set
+CONFIG_CONSOLE_UART=y
+CONFIG_CONSOLE_UART_NUM=0
+CONFIG_CONSOLE_UART_BAUDRATE=115200
+CONFIG_INT_WDT=y
+CONFIG_INT_WDT_TIMEOUT_MS=300
+CONFIG_INT_WDT_CHECK_CPU1=y
+CONFIG_TASK_WDT=y
+# CONFIG_TASK_WDT_PANIC is not set
+CONFIG_TASK_WDT_TIMEOUT_S=5
+CONFIG_TASK_WDT_CHECK_IDLE_TASK_CPU0=y
+CONFIG_TASK_WDT_CHECK_IDLE_TASK_CPU1=y
+# CONFIG_ESP32_DEBUG_STUBS_ENABLE is not set
+CONFIG_TIMER_TASK_STACK_SIZE=3584
+# CONFIG_ESP32_ENABLE_COREDUMP_TO_FLASH is not set
+# CONFIG_ESP32_ENABLE_COREDUMP_TO_UART is not set
+CONFIG_ESP32_ENABLE_COREDUMP_TO_NONE=y
+CONFIG_MB_MASTER_TIMEOUT_MS_RESPOND=150
+CONFIG_MB_MASTER_DELAY_MS_CONVERT=200
+CONFIG_MB_QUEUE_LENGTH=20
+CONFIG_MB_SERIAL_TASK_STACK_SIZE=4096
+CONFIG_MB_SERIAL_BUF_SIZE=256
+CONFIG_MB_SERIAL_TASK_PRIO=10
+CONFIG_MB_CONTROLLER_SLAVE_ID_SUPPORT=y
+CONFIG_MB_CONTROLLER_SLAVE_ID=0x00112233
+CONFIG_MB_CONTROLLER_NOTIFY_TIMEOUT=20
+CONFIG_MB_CONTROLLER_NOTIFY_QUEUE_SIZE=20
+CONFIG_MB_CONTROLLER_STACK_SIZE=4096
+CONFIG_MB_EVENT_QUEUE_TIMEOUT=20
+# CONFIG_MB_TIMER_PORT_ENABLED is not set
+CONFIG_MB_TIMER_GROUP=0
+CONFIG_MB_TIMER_INDEX=0
+# CONFIG_ENABLE_STATIC_TASK_CLEAN_UP_HOOK is not set
+CONFIG_TIMER_TASK_PRIORITY=1
+CONFIG_TIMER_TASK_STACK_DEPTH=2048
+CONFIG_TIMER_QUEUE_LENGTH=10
+# CONFIG_L2_TO_L3_COPY is not set
+# CONFIG_USE_ONLY_LWIP_SELECT is not set
+CONFIG_ESP_GRATUITOUS_ARP=y
+CONFIG_GARP_TMR_INTERVAL=60
+CONFIG_TCPIP_RECVMBOX_SIZE=32
+CONFIG_TCP_MAXRTX=12
+CONFIG_TCP_SYNMAXRTX=12
+CONFIG_TCP_MSS=1440
+CONFIG_TCP_MSL=60000
+CONFIG_TCP_SND_BUF_DEFAULT=5744
+CONFIG_TCP_WND_DEFAULT=5744
+CONFIG_TCP_RECVMBOX_SIZE=6
+CONFIG_TCP_QUEUE_OOSEQ=y
+# CONFIG_ESP_TCP_KEEP_CONNECTION_WHEN_IP_CHANGES is not set
+CONFIG_TCP_OVERSIZE_MSS=y
+# CONFIG_TCP_OVERSIZE_QUARTER_MSS is not set
+# CONFIG_TCP_OVERSIZE_DISABLE is not set
+CONFIG_UDP_RECVMBOX_SIZE=6
+CONFIG_TCPIP_TASK_STACK_SIZE=3072
+CONFIG_TCPIP_TASK_AFFINITY_NO_AFFINITY=y
+# CONFIG_TCPIP_TASK_AFFINITY_CPU0 is not set
+# CONFIG_TCPIP_TASK_AFFINITY_CPU1 is not set
+CONFIG_TCPIP_TASK_AFFINITY=0x7FFFFFFF
+# CONFIG_PPP_SUPPORT is not set
+CONFIG_ESP32_PTHREAD_TASK_PRIO_DEFAULT=5
+CONFIG_ESP32_PTHREAD_TASK_STACK_SIZE_DEFAULT=3072
+CONFIG_ESP32_PTHREAD_STACK_MIN=768
+CONFIG_ESP32_DEFAULT_PTHREAD_CORE_NO_AFFINITY=y
+# CONFIG_ESP32_DEFAULT_PTHREAD_CORE_0 is not set
+# CONFIG_ESP32_DEFAULT_PTHREAD_CORE_1 is not set
+CONFIG_ESP32_PTHREAD_TASK_CORE_DEFAULT=-1
+CONFIG_ESP32_PTHREAD_TASK_NAME_DEFAULT="pthread"
+CONFIG_SPI_FLASH_WRITING_DANGEROUS_REGIONS_ABORTS=y
+# CONFIG_SPI_FLASH_WRITING_DANGEROUS_REGIONS_FAILS is not set
+# CONFIG_SPI_FLASH_WRITING_DANGEROUS_REGIONS_ALLOWED is not set
+CONFIG_SUPPRESS_SELECT_DEBUG_OUTPUT=y
+CONFIG_SUPPORT_TERMIOS=y
+CONFIG_SEMIHOSTFS_MAX_MOUNT_POINTS=1
+CONFIG_SEMIHOSTFS_HOST_PATH_MAX_LEN=128
+# End of deprecated options

From 997d6b4405c6daa87236e2850945de97c0140015 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 2 Dec 2022 17:04:16 +0100
Subject: [PATCH 137/549] increase stack size for ESP-IDF example

---
 examples/ESP-IDF/sdkconfig | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/ESP-IDF/sdkconfig b/examples/ESP-IDF/sdkconfig
index a39a2b82..4e8f5df7 100644
--- a/examples/ESP-IDF/sdkconfig
+++ b/examples/ESP-IDF/sdkconfig
@@ -502,7 +502,7 @@ CONFIG_ESP_SYSTEM_PANIC_PRINT_REBOOT=y
 
 CONFIG_ESP_SYSTEM_EVENT_QUEUE_SIZE=32
 CONFIG_ESP_SYSTEM_EVENT_TASK_STACK_SIZE=2304
-CONFIG_ESP_MAIN_TASK_STACK_SIZE=3584
+CONFIG_ESP_MAIN_TASK_STACK_SIZE=8192
 CONFIG_ESP_MAIN_TASK_AFFINITY_CPU0=y
 # CONFIG_ESP_MAIN_TASK_AFFINITY_CPU1 is not set
 # CONFIG_ESP_MAIN_TASK_AFFINITY_NO_AFFINITY is not set
@@ -1321,7 +1321,7 @@ CONFIG_ESP32S2_PANIC_PRINT_REBOOT=y
 # CONFIG_ESP32S2_PANIC_GDBSTUB is not set
 CONFIG_SYSTEM_EVENT_QUEUE_SIZE=32
 CONFIG_SYSTEM_EVENT_TASK_STACK_SIZE=2304
-CONFIG_MAIN_TASK_STACK_SIZE=3584
+CONFIG_MAIN_TASK_STACK_SIZE=8192
 CONFIG_CONSOLE_UART_DEFAULT=y
 # CONFIG_CONSOLE_UART_CUSTOM is not set
 # CONFIG_ESP_CONSOLE_UART_NONE is not set

From 6c1a354a9dc6922edae608896710ccb724044847 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 7 Dec 2022 14:36:55 +0100
Subject: [PATCH 138/549] cleanup unused code

---
 src/ArduinoOcpp/Core/OcppMessage.h            |  2 --
 .../MessagesV16/StartTransaction.cpp          |  4 ----
 .../MessagesV16/StartTransaction.h            |  2 --
 .../MessagesV16/StopTransaction.cpp           |  4 ----
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |  2 --
 .../ChargePointStatusService.cpp              |  9 +++----
 .../ChargePointStatus/ConnectorStatus.cpp     | 24 +++++++++++--------
 .../Tasks/Transactions/Transaction.h          |  4 +---
 .../Tasks/Transactions/TransactionProcess.cpp |  2 --
 .../Tasks/Transactions/TransactionProcess.h   |  1 -
 10 files changed, 20 insertions(+), 34 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppMessage.h b/src/ArduinoOcpp/Core/OcppMessage.h
index 6c3a9cc3..107de536 100644
--- a/src/ArduinoOcpp/Core/OcppMessage.h
+++ b/src/ArduinoOcpp/Core/OcppMessage.h
@@ -80,8 +80,6 @@ class OcppMessage {
     virtual const char *getErrorCode() {return nullptr;} //nullptr means no error
     virtual const char *getErrorDescription() {return "";}
     virtual std::unique_ptr<DynamicJsonDocument> getErrorDetails() {return createEmptyDocument();}
-    
-    virtual TransactionRPC *getTransactionSync() {return nullptr;}
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 931d9bc4..31d25888 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -155,10 +155,6 @@ void StartTransaction::processConf(JsonObject payload) {
     transaction->commit();
 }
 
-TransactionRPC *StartTransaction::getTransactionSync() {
-    return transaction ? &transaction->getStartRpcSync() : nullptr;
-}
-
 void StartTransaction::processReq(JsonObject payload) {
 
   /**
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.h b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
index 20d8d626..4b43b535 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
@@ -38,8 +38,6 @@ class StartTransaction : public OcppMessage {
 
     void processConf(JsonObject payload);
 
-    TransactionRPC *getTransactionSync() override;
-
     void processReq(JsonObject payload);
 
     std::unique_ptr<DynamicJsonDocument> createConf();
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 9355d8b9..a2d34ab0 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -205,10 +205,6 @@ bool StopTransaction::processErr(const char *code, const char *description, Json
     return false;
 }
 
-TransactionRPC *StopTransaction::getTransactionSync() {
-    return transaction ? &transaction->getStopRpcSync() : nullptr;
-}
-
 void StopTransaction::processReq(JsonObject payload) {
     /**
      * Ignore Contents of this Req-message, because this is for debug purposes only
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index 8ed365b8..bc57828a 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -47,8 +47,6 @@ class StopTransaction : public OcppMessage {
 
     bool processErr(const char *code, const char *description, JsonObject details) override;
 
-    TransactionRPC *getTransactionSync() override;
-
     void processReq(JsonObject payload) override;
 
     std::unique_ptr<DynamicJsonDocument> createConf() override;
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 07c18331..8c356945 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -61,10 +61,11 @@ ChargePointStatusService::~ChargePointStatusService() {
 void ChargePointStatusService::loop() {
     if (!booted) return;
     for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
-        auto statusNotificationMsg = (*connector)->loop();
-        if (statusNotificationMsg != nullptr) {
-            auto statusNotification = makeOcppOperation(statusNotificationMsg);
-            context.initiateOperation(std::move(statusNotification));
+        auto transactionMsg = (*connector)->loop();
+        if (transactionMsg != nullptr) {
+            auto transactionOp = makeOcppOperation(transactionMsg);
+            transactionOp->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
+            context.initiateOperation(std::move(transactionOp));
         }
     }
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 6ac3326b..43aeef94 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -150,18 +150,22 @@ OcppMessage *ConnectorStatus::loop() {
         }
     }
 
-    if (transaction && (transaction->isAborted() || transaction->isCompleted())) {
-        if (transaction->isAborted()) {
-            //If the transaction is aborted (invalidated before started), delete all artifacts from flash
-            //This is an optimization. The memory management will attempt to remove those files again later
-            AO_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
-            if (auto mService = context.getMeteringService()) {
-                mService->removeTxMeterData(connectorId, transaction->getTxNr());
-            }
-
-            context.getTransactionStore()->remove(connectorId, transaction->getTxNr());
+    if (transaction && transaction->isAborted()) {
+        //If the transaction is aborted (invalidated before started), delete all artifacts from flash
+        //This is an optimization. The memory management will attempt to remove those files again later
+        if (auto mService = context.getMeteringService()) {
+            mService->removeTxMeterData(connectorId, transaction->getTxNr());
         }
 
+        context.getTransactionStore()->remove(connectorId, transaction->getTxNr());
+
+        //Now, collect the transaction
+        AO_DBG_DEBUG("collect aborted transaction %u-%u", connectorId, transaction->getTxNr());
+        transaction = nullptr;
+    }
+
+    if (transaction && transaction->isCompleted()) {
+        AO_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
         transaction = nullptr;
     }
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index 4f861b42..1f95751b 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -141,9 +141,7 @@ class Transaction {
     TransactionRPC& getStopRpcSync() {return stop.rpc;}
 
     bool isAborted() {return !start.rpc.requested && !session.active;}
-    bool isCompleted() {return start.rpc.isRequested() && start.rpc.isConfirmed() &&
-                               stop.rpc.isRequested()  && stop.rpc.isConfirmed();}
-    bool isPending() {return !isAborted() && !isCompleted();}
+    bool isCompleted() {return stop.rpc.isConfirmed();}
     bool isPreparing() {return session.active && !start.rpc.isRequested() && !stop.rpc.isRequested();}
     bool isRunning() {return start.rpc.isRequested() && !stop.rpc.isRequested();}
     bool isActive() {return session.active && !stop.rpc.isRequested();}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
index 139a7756..66a9384d 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
@@ -6,8 +6,6 @@
 
 #include <ArduinoOcpp/Debug.h>
 
-#define AO_TXPROC_FN AO_FILENAME_PREFIX "/txproc.cnf"
-
 using namespace ArduinoOcpp;
 
 TransactionProcess::TransactionProcess(uint connectorId) {
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
index 375fb37a..7699a81f 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
@@ -6,7 +6,6 @@
 #define TRANSACTIONPROCESS_H
 
 #include <ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h>
-#include <ArduinoOcpp/Core/Configuration.h>
 
 #include <vector>
 #include <functional>

From 0f443d92e265324bd6c8a224128c8749b039365f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 7 Dec 2022 15:11:24 +0100
Subject: [PATCH 139/549] fix compiler error

---
 src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
index 7699a81f..8b14f8c6 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
@@ -9,6 +9,7 @@
 
 #include <vector>
 #include <functional>
+#include <stdint.h>
 
 namespace ArduinoOcpp {
 

From 37e1dc04742606504a6b6273fd7b5f85ebb168d9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 7 Dec 2022 15:14:02 +0100
Subject: [PATCH 140/549] fix compiler error II

---
 src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
index 8b14f8c6..375fb37a 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
@@ -6,10 +6,10 @@
 #define TRANSACTIONPROCESS_H
 
 #include <ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h>
+#include <ArduinoOcpp/Core/Configuration.h>
 
 #include <vector>
 #include <functional>
-#include <stdint.h>
 
 namespace ArduinoOcpp {
 

From 6d9cc57ff8bb228457870359355212eb10dec23b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 11 Dec 2022 19:16:32 +0100
Subject: [PATCH 141/549] transactions overflow handling

---
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp   |   2 +-
 .../MessagesV16/StopTransaction.cpp           |  59 --------
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |   2 -
 .../ChargePointStatus/ConnectorStatus.cpp     | 139 +++++++++++++++++-
 .../Tasks/ChargePointStatus/ConnectorStatus.h |   2 +
 .../Metering/ConnectorMeterValuesRecorder.cpp |  11 +-
 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp |  44 ++++--
 src/ArduinoOcpp/Tasks/Metering/MeterStore.h   |   3 +-
 .../Tasks/Transactions/Transaction.cpp        |  18 ++-
 .../Tasks/Transactions/Transaction.h          |  24 ++-
 .../Tasks/Transactions/TransactionStore.cpp   |  81 ++++++++--
 .../Tasks/Transactions/TransactionStore.h     |  23 ++-
 12 files changed, 285 insertions(+), 123 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index 053c5309..6af25835 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -58,7 +58,7 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
     auto payload = doc->to<JsonObject>();
     payload["connectorId"] = connectorId;
 
-    if (transaction) {
+    if (transaction && !transaction->isSilent()) { //add txId if MVs are assigned to a tx with txId
         payload["transactionId"] = transaction->getTransactionId();
     }
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index a2d34ab0..7204f752 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -15,8 +15,6 @@
 using ArduinoOcpp::Ocpp16::StopTransaction;
 using ArduinoOcpp::TransactionRPC;
 
-#define AO_TXHISTORY_SIZE 10
-
 StopTransaction::StopTransaction(std::shared_ptr<Transaction> transaction)
         : transaction(transaction) {
 
@@ -186,8 +184,6 @@ void StopTransaction::processConf(JsonObject payload) {
         transaction->commit();
     }
 
-    cleanTxStore();
-
     AO_DBG_INFO("Request has been accepted!");
 }
 
@@ -198,8 +194,6 @@ bool StopTransaction::processErr(const char *code, const char *description, Json
         transaction->commit();
     }
 
-    cleanTxStore();
-
     AO_DBG_ERR("Server error, data loss!");
 
     return false;
@@ -220,56 +214,3 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createConf(){
 
     return doc;
 }
-
-bool StopTransaction::cleanTxStore() {
-    if (!transaction || !ocppModel) {
-        //doesn't apply
-        return true;
-    }
-
-    auto txStore = ocppModel->getTransactionStore();
-    if (!txStore || txStore->getTxBegin(transaction->getConnectorId()) < 0) {
-        AO_DBG_ERR("invalid state");
-        return false;
-    }
-
-    unsigned int txBegin = (unsigned int) txStore->getTxBegin(transaction->getConnectorId());
-    unsigned int txRangeEnd = (transaction->getTxNr() + MAX_TX_CNT - AO_TXHISTORY_SIZE) % MAX_TX_CNT;
-
-    //to be deleted: [txBegin ... txRangeEnd)
-
-    if ((transaction->getTxNr() + MAX_TX_CNT - txBegin) % MAX_TX_CNT <= 
-            (transaction->getTxNr() + MAX_TX_CNT - txRangeEnd) % MAX_TX_CNT) {
-        //txBegin is after txRangeEnd => nothing to delete
-        AO_DBG_DEBUG("already clean");
-        return true;
-    }
-
-    unsigned int rangeSize = (txRangeEnd + MAX_TX_CNT - txBegin) % MAX_TX_CNT;
-    AO_DBG_DEBUG("deleting %u entries from %u to %u", rangeSize, txBegin, txRangeEnd);
-    if (rangeSize >= 50) {
-        AO_DBG_ERR("cannot clean more than 50 entries at once - clean only the first 50");
-        rangeSize = 50;
-        txRangeEnd = (txBegin + 50) % MAX_TX_CNT;
-    }
-
-    bool success = true;
-
-    if (auto mService = ocppModel->getMeteringService()) {
-        for (unsigned int i = 0; i < rangeSize; i++) {
-            unsigned int tx = (txBegin + i) % MAX_TX_CNT;
-
-            success &= mService->removeTxMeterData(transaction->getConnectorId(), tx);
-        }
-    }
-
-    for (unsigned int i = 0; i < rangeSize; i++) {
-        unsigned int tx = (txBegin + i) % MAX_TX_CNT;
-
-        success &= txStore->remove(transaction->getConnectorId(), tx);
-    }
-
-    txStore->updateTxBegin(transaction->getConnectorId(), txRangeEnd);
-
-    return success;
-}
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index bc57828a..2e27ba8e 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -24,8 +24,6 @@ class StopTransaction : public OcppMessage {
 private:
     std::shared_ptr<Transaction> transaction;
     std::vector<std::unique_ptr<MeterValue>> transactionData;
-
-    bool cleanTxStore();
 public:
 
     StopTransaction(std::shared_ptr<Transaction> transaction);
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 43aeef94..e94203b1 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -36,6 +36,9 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
     localAuthorizeOffline = declareConfiguration<const char*>("LocalAuthorizeOffline", "false", CONFIGURATION_FN, true, true, false, false);
     localPreAuthorize = declareConfiguration<const char*>("LocalPreAuthorize", "false", CONFIGURATION_FN, true, true, false, false);
 
+    //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
+    silentOfflineTransactions = declareConfiguration<const char*>("AO_SilentOfflineTransactions", "false", CONFIGURATION_FN, true, true, false, false);
+
     if (!availability) {
         AO_DBG_ERR("Cannot declare availability");
     }
@@ -153,14 +156,20 @@ OcppMessage *ConnectorStatus::loop() {
     if (transaction && transaction->isAborted()) {
         //If the transaction is aborted (invalidated before started), delete all artifacts from flash
         //This is an optimization. The memory management will attempt to remove those files again later
+        bool removed = true;
         if (auto mService = context.getMeteringService()) {
-            mService->removeTxMeterData(connectorId, transaction->getTxNr());
+            removed &= mService->removeTxMeterData(connectorId, transaction->getTxNr());
+        }
+
+        if (removed) {
+            removed &= context.getTransactionStore()->remove(connectorId, transaction->getTxNr());
         }
 
-        context.getTransactionStore()->remove(connectorId, transaction->getTxNr());
+        if (removed) {
+            context.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr()); //roll back creation of last tx entry
+        }
 
-        //Now, collect the transaction
-        AO_DBG_DEBUG("collect aborted transaction %u-%u", connectorId, transaction->getTxNr());
+        AO_DBG_DEBUG("collect aborted transaction %u-%u %s", connectorId, transaction->getTxNr(), removed ? "" : "failure");
         transaction = nullptr;
     }
 
@@ -216,6 +225,7 @@ OcppMessage *ConnectorStatus::loop() {
                 //start Transaction
 
                 AO_DBG_INFO("Session mngt: trigger StartTransaction");
+
                 auto meteringService = context.getMeteringService();
                 if (transaction->getMeterStart() < 0 && meteringService) {
                     auto meterStart = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionBegin);
@@ -230,6 +240,14 @@ OcppMessage *ConnectorStatus::loop() {
                     transaction->setStartTimestamp(context.getOcppTime().getOcppTimestampNow());
                 }
 
+                if (transaction->isSilent()) {
+                    AO_DBG_INFO("silent Transaction: omit StartTx");
+                    transaction->getStartRpcSync().setRequested();
+                    transaction->getStartRpcSync().confirm();
+                    transaction->commit();
+                    return nullptr;
+                }
+
                 transaction->commit();
 
                 if (context.getMeteringService()) {
@@ -250,6 +268,19 @@ OcppMessage *ConnectorStatus::loop() {
                 //stop transaction
 
                 AO_DBG_INFO("Session mngt: trigger StopTransaction");
+
+                if (transaction->isSilent()) {
+                    AO_DBG_INFO("silent Transaction: omit StopTx");
+                    transaction->getStopRpcSync().setRequested();
+                    transaction->getStopRpcSync().confirm();
+                    if (auto mService = context.getMeteringService()) {
+                        mService->removeTxMeterData(connectorId, transaction->getTxNr());
+                    }
+                    context.getTransactionStore()->remove(connectorId, transaction->getTxNr());
+                    context.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr());
+                    transaction = nullptr;
+                    return nullptr;
+                }
                 
                 auto meteringService = context.getMeteringService();
                 if (transaction->getMeterStop() < 0 && meteringService) {
@@ -314,15 +345,107 @@ const char *ConnectorStatus::getErrorCode() {
 }
 
 void ConnectorStatus::beginSession(const char *sessionIdTag) {
-    
+    //(special case: tx already exists -> update the sessionIdTag and good)
+
     if (!transaction) {
+        //no tx running, before creating new one, clean possible aorted tx
+
+        auto txr = context.getTransactionStore()->getTxEnd(connectorId);
+        auto txsize = context.getTransactionStore()->size(connectorId);
+        for (decltype(txsize) i = 0; i < txsize; i++) {
+            txr = (txr + MAX_TX_CNT - 1) % MAX_TX_CNT; //decrement by 1
+            
+            auto tx = context.getTransactionStore()->getTransaction(connectorId, txr);
+            //check if dangling silent tx, aborted tx, or corrupted entry (tx == null)
+            if (!tx || tx->isSilent() || tx->isAborted()) {
+                //yes, remove
+                bool removed = true;
+                if (auto mService = context.getMeteringService()) {
+                    removed &= mService->removeTxMeterData(connectorId, txr);
+                }
+                if (removed) {
+                    removed &= context.getTransactionStore()->remove(connectorId, txr);
+                }
+                if (removed) {
+                    context.getTransactionStore()->setTxEnd(connectorId, txr);
+                    AO_DBG_WARN("deleted dangling silent tx for new transaction");
+                } else {
+                    AO_DBG_ERR("memory corruption");
+                    break;
+                }
+            } else {
+                //no, tx record trimmed, end
+                break;
+            }
+        }
+
+        //try to create new transaction
         transaction = context.getTransactionStore()->createTransaction(connectorId);
+    }
 
-        if (!transaction) {
-            AO_DBG_ERR("Could not allocate Tx");
-            return;
+    if (!transaction) {
+        //could not create transaction - now, try to replace tx history entry
+
+        auto txl = context.getTransactionStore()->getTxBegin(connectorId);
+        auto txsize = context.getTransactionStore()->size(connectorId);
+
+        for (decltype(txsize) i = 0; i < txsize; i++) {
+
+            if (transaction) {
+                //success, finished here
+                break;
+            }
+
+            //no transaction allocated, delete history entry to make space
+
+            auto txhist = context.getTransactionStore()->getTransaction(connectorId, txl);
+            //oldest entry, now check if it's history and can be removed or corrupted entry
+            if (!txhist || txhist->isCompleted()) {
+                //yes, remove
+                bool removed = true;
+                if (auto mService = context.getMeteringService()) {
+                    removed &= mService->removeTxMeterData(connectorId, txl);
+                }
+                if (removed) {
+                    removed &= context.getTransactionStore()->remove(connectorId, txl);
+                }
+                if (removed) {
+                    context.getTransactionStore()->setTxBegin(connectorId, (txl + 1) % MAX_TX_CNT);
+                    AO_DBG_DEBUG("deleted tx history entry for new transaction");
+
+                    transaction = context.getTransactionStore()->createTransaction(connectorId);
+                } else {
+                    AO_DBG_ERR("memory corruption");
+                    break;
+                }
+            } else {
+                //no, end of history reached, don't delete further tx
+                AO_DBG_DEBUG("cannot delete more tx");
+                break;
+            }
+
+            txl++;
+            txl %= MAX_TX_CNT;
         }
     }
+
+    if (!transaction) {
+        //couldn't create normal transaction -> check if to start charging without real transaction
+        if (silentOfflineTransactions && *silentOfflineTransactions && !strcmp(*silentOfflineTransactions, "true")) {
+            //try to handle charging session without sending StartTx or StopTx to the server
+            transaction = context.getTransactionStore()->createTransaction(connectorId, true);
+
+            if (transaction) {
+                AO_DBG_DEBUG("created silent transaction");
+                (void)0;
+            }
+        }
+    }
+
+    if (!transaction) {
+        AO_DBG_ERR("could not allocate Tx");
+        return;
+    }
     
     AO_DBG_DEBUG("Begin session with idTag %s, overwriting idTag %s", sessionIdTag != nullptr ? sessionIdTag : "", transaction->getIdTag());
     if (!sessionIdTag || *sessionIdTag == '\0') {
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 12e65be6..0286ae7f 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -61,6 +61,8 @@ class ConnectorStatus {
     std::shared_ptr<Configuration<const char*>> unlockConnectorOnEVSideDisconnect;
     std::shared_ptr<Configuration<const char*>> localAuthorizeOffline;
     std::shared_ptr<Configuration<const char*>> localPreAuthorize;
+
+    std::shared_ptr<Configuration<const char*>> silentOfflineTransactions;
 public:
     ConnectorStatus(OcppModel& context, int connectorId);
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 9581c3ba..563770ae 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -85,13 +85,13 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
             transaction = context.getConnectorStatus(connectorId)->getTransaction();
         }
         
-        if (transaction && transaction->isRunning()) {
+        if (transaction && transaction->isRunning() && !transaction->isSilent()) {
             //check during transaction
 
             if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
                 AO_DBG_WARN("reload stopTxnData");
                 //reload (e.g. after power cut during transaction)
-                stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
+                stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction.get());
             }
         } else {
             //check outside of transaction
@@ -216,7 +216,7 @@ std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readTxEnergyMeter(Re
 
 void ConnectorMeterValuesRecorder::beginTxMeterData(Transaction *transaction) {
     if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
-        stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
+        stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction);
     }
 
     if (stopTxnData) {
@@ -229,7 +229,7 @@ void ConnectorMeterValuesRecorder::beginTxMeterData(Transaction *transaction) {
 
 std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::endTxMeterData(Transaction *transaction) {
     if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
-        stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
+        stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction);
     }
 
     if (stopTxnData) {
@@ -243,8 +243,7 @@ std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::endTxMeterDa
 }
 
 std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::getStopTxMeterData(Transaction *transaction) {
-
-    auto txData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, connectorId, transaction->getTxNr());
+    auto txData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction);
 
     if (!txData) {
         AO_DBG_ERR("could not create TxData");
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
index 3d8044d3..42f0dec4 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
@@ -13,7 +13,7 @@
 #define AO_METERSTORE_DIR AO_FILENAME_PREFIX "/"
 #endif
 
-#define MAX_STOPTXDATA_LEN 10
+#define AO_MAX_STOPTXDATA_LEN 4
 
 using namespace ArduinoOcpp;
 
@@ -37,9 +37,24 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
         return false;
     }
 
+    if (AO_MAX_STOPTXDATA_LEN <= 0) {
+        //txData off
+        return true;
+    }
+
+    bool replaceLast = mvCount >= AO_MAX_STOPTXDATA_LEN; //txData size exceeded? overwrite last entry instead of appending
+
     if (filesystem) {
+
+        unsigned int mvIndex = 0;
+        if (replaceLast) {
+            mvIndex = mvCount - 1;
+        } else {
+            mvIndex = mvCount ;
+        }
+
         char fn [MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvCount);
+        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvIndex);
         if (ret < 0 || ret >= MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             return false;
@@ -55,15 +70,18 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
             AO_DBG_ERR("FS error");
             return false;
         }
+
+        if (!replaceLast) {
+            mvCount++;
+        }
     }
 
-    if (txData.size() < MAX_STOPTXDATA_LEN) {
-        txData.push_back(std::move(mv));
-        mvCount++;
-        AO_DBG_DEBUG("added sd");
-    } else {
+    if (replaceLast) {
         txData.back() = std::move(mv);
         AO_DBG_DEBUG("updated latest sd");
+    } else {
+        txData.push_back(std::move(mv));
+        AO_DBG_DEBUG("added sd");
     }
     return true;
 }
@@ -114,7 +132,7 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
             continue;
         }
 
-        if (txData.size() >= MAX_STOPTXDATA_LEN) {
+        if (txData.size() >= AO_MAX_STOPTXDATA_LEN) {
             AO_DBG_ERR("corrupted memory");
             return false;
         }
@@ -137,7 +155,15 @@ MeterStore::MeterStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesyst
     }
 }
 
-std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuilder& mvBuilder, unsigned int connectorId, unsigned int txNr) {
+std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuilder& mvBuilder, Transaction *transaction) {
+    if (!transaction || transaction->isSilent()) {
+        //no tx assignment -> don't store txData
+        //tx is silent -> no StopTx will be sent and don't store txData
+        return nullptr;
+    }
+    auto connectorId = transaction->getConnectorId();
+    auto txNr = transaction->getTxNr();
+    
     auto cached = std::find_if(txMeterData.begin(), txMeterData.end(),
             [connectorId, txNr] (std::weak_ptr<TransactionMeterData>& txm) {
                 if (auto txml = txm.lock()) {
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
index 9c27d978..1e6bef5f 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
@@ -6,6 +6,7 @@
 #define METERSTORE_H
 
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
 #include <vector>
@@ -52,7 +53,7 @@ class MeterStore {
     MeterStore(MeterStore&) = delete;
     MeterStore(std::shared_ptr<FilesystemAdapter> filesystem);
 
-    std::shared_ptr<TransactionMeterData> getTxMeterData(MeterValueBuilder& mvBuilder, unsigned int connectorId, unsigned int txNr);
+    std::shared_ptr<TransactionMeterData> getTxMeterData(MeterValueBuilder& mvBuilder, Transaction *transaction);
 
     bool remove(unsigned int connectorId, unsigned int txNr);
 };
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index 07bd2eb9..247444fe 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -88,9 +88,9 @@ bool Transaction::serializeSessionState(DynamicJsonDocument& out) {
         txStopClientSide["reason"] = stop.client.reason;
     }
 
-    //if (stop.rpc.confirmed) {
-    //    JsonObject txStopServerSide = txStop.createNestedObject("server");
-    //}
+    if (silent) {
+        state["silent"] = true;
+    }
 
     if (out.overflowed()) {
         AO_DBG_ERR("JSON capacity exceeded");
@@ -188,14 +188,18 @@ bool Transaction::deserializeSessionState(JsonObject state) {
         }
     }
 
+    if (state.containsKey("silent")) {
+        silent = state["silent"] | false;
+    }
+
     AO_DBG_DEBUG("DUMP TX");
     AO_DBG_DEBUG("Session   | idTag %s", session.idTag);
     AO_DBG_DEBUG("Start RPC | req: %i, conf: %i", start.rpc.requested, start.rpc.confirmed);
     AO_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  stop.rpc.requested, stop.rpc.confirmed);
-
-    //if (stop.rpc.confirmed) {
-    //    JsonObject txStopServerSide = txStop["server"];
-    //}
+    if (silent) {
+        AO_DBG_DEBUG("          | silent Tx");
+        (void)0;
+    }
 
     return true;
 }
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index 1f95751b..ea1c2da4 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -26,8 +26,6 @@ class ConnectorTransactionStore;
 class TransactionRPC {
 private:
     friend class Transaction;
-
-    ConnectorTransactionStore& context;
     
     bool requested = false;
     bool confirmed = false;
@@ -35,8 +33,6 @@ class TransactionRPC {
     bool serializeSessionState(JsonObject out);
     bool deserializeSessionState(JsonObject in);
 public:
-    TransactionRPC(ConnectorTransactionStore& context) : context(context) { }
-
     void setRequested() {this->requested = true;}
     bool isRequested() {return requested;}
     void confirm() {confirmed = true;}
@@ -67,8 +63,6 @@ class TransactionStart {
     TransactionRPC rpc;
     ClientTransactionStart client;
     ServerTransactionStart server;
-public:
-    TransactionStart(ConnectorTransactionStore& context) : rpc(context) { }
 };
 
 class ClientTransactionStop {
@@ -92,8 +86,6 @@ class TransactionStop {
     TransactionRPC rpc;
     ClientTransactionStop client;
     ServerTransactionStop server;
-public:
-    TransactionStop(ConnectorTransactionStore& context) : rpc(context) { }
 };
 
 class ChargingSession {
@@ -114,19 +106,20 @@ class Transaction {
 private:
     ConnectorTransactionStore& context;
 
-    ChargingSession session;      //data that exists before the tx
+    ChargingSession session;
     TransactionStart start;
     TransactionStop stop;
 
     unsigned int connectorId = 0;
-    unsigned int txNr = 0; //only valid if session.connectorId is >= 0
+    unsigned int txNr = 0;
+
+    bool silent = false; //silent Tx: process tx locally, without reporting to the server
 public:
-    Transaction(ConnectorTransactionStore& context, unsigned int connectorId, unsigned int txNr) : 
-                context(context), 
-                start(context),
-                stop(context),
+    Transaction(ConnectorTransactionStore& context, unsigned int connectorId, unsigned int txNr, bool silent = false) : 
+                context(context),
                 connectorId(connectorId), 
-                txNr(txNr) {}
+                txNr(txNr),
+                silent(silent) {}
 
     bool serializeSessionState(DynamicJsonDocument& out);
     bool deserializeSessionState(JsonObject in);
@@ -180,6 +173,7 @@ class Transaction {
     void setStopIdTag(const char *idTag) {snprintf(stop.client.idTag, IDTAG_LEN_MAX + 1, "%s", idTag);}
 
     bool commit();
+    bool isSilent() {return silent;} //no data will be sent to server and server will not assign transactionId
 };
 
 }
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index d03c92ab..feb3dd37 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -111,14 +111,25 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
     return transaction;
 }
 
-std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction() {
-
-    if (!txEnd || *txEnd < 0) {
+std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool silent) {
+    
+    if (!txBegin || *txBegin < 0 || !txEnd || *txEnd < 0) {
         AO_DBG_ERR("memory corruption");
         return nullptr;
     }
 
-    auto transaction = std::make_shared<Transaction>(*this, connectorId, (unsigned int) *txEnd);
+    //check if maximum number of queued tx already reached
+    if ((*txEnd + MAX_TX_CNT - *txBegin) % MAX_TX_CNT >= AO_TXRECORD_SIZE) {
+        //limit reached
+
+        if (!silent) {
+            //normal tx -> abort
+            return nullptr;
+        }
+        //special case: silent tx -> create tx anyway, but should be deleted immediately after charging session
+    }
+
+    auto transaction = std::make_shared<Transaction>(*this, connectorId, (unsigned int) *txEnd, silent);
 
     *txEnd = (*txEnd + 1) % MAX_TX_CNT;
     configuration_save();
@@ -213,7 +224,16 @@ int ConnectorTransactionStore::getTxBegin() {
     return *txBegin;
 }
 
-void ConnectorTransactionStore::updateTxBegin(unsigned int txNr) {
+int ConnectorTransactionStore::getTxEnd() {
+    if (!txBegin || *txBegin < 0) {
+        AO_DBG_ERR("memory corruption");
+        return -1;
+    }
+
+    return *txEnd;
+}
+
+void ConnectorTransactionStore::setTxBegin(unsigned int txNr) {
     if (!txBegin || *txBegin < 0) {
         AO_DBG_ERR("memory corruption");
         return;
@@ -223,6 +243,25 @@ void ConnectorTransactionStore::updateTxBegin(unsigned int txNr) {
     configuration_save();
 }
 
+void ConnectorTransactionStore::setTxEnd(unsigned int txNr) {
+    if (!txBegin || *txBegin < 0 || !txEnd || *txEnd < 0) {
+        AO_DBG_ERR("memory corruption");
+        return;
+    }
+
+    *txEnd = txNr;
+    configuration_save();
+}
+
+unsigned int ConnectorTransactionStore::size() {
+    if (!txBegin || *txBegin < 0 || !txEnd || *txEnd < 0) {
+        AO_DBG_ERR("memory corruption");
+        return 0;
+    }
+
+    return (*txEnd + MAX_TX_CNT - *txBegin) % MAX_TX_CNT;
+}
+
 TransactionStore::TransactionStore(uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
     
     for (uint i = 0; i < nConnectors; i++) {
@@ -260,12 +299,12 @@ std::shared_ptr<Transaction> TransactionStore::getTransaction(unsigned int conne
     return connectors[connectorId]->getTransaction(txNr);
 }
 
-std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int connectorId) {
+std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int connectorId, bool silent) {
     if (connectorId >= connectors.size()) {
         AO_DBG_ERR("Invalid connectorId");
         return nullptr;
     }
-    return connectors[connectorId]->createTransaction();
+    return connectors[connectorId]->createTransaction(silent);
 }
 
 bool TransactionStore::remove(unsigned int connectorId, unsigned int txNr) {
@@ -284,10 +323,34 @@ int TransactionStore::getTxBegin(unsigned int connectorId) {
     return connectors[connectorId]->getTxBegin();
 }
 
-void TransactionStore::updateTxBegin(unsigned int connectorId, unsigned int txNr) {
+int TransactionStore::getTxEnd(unsigned int connectorId) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return -1;
+    }
+    return connectors[connectorId]->getTxEnd();
+}
+
+void TransactionStore::setTxBegin(unsigned int connectorId, unsigned int txNr) {
     if (connectorId >= connectors.size()) {
         AO_DBG_ERR("Invalid connectorId");
         return;
     }
-    return connectors[connectorId]->updateTxBegin(txNr);
+    return connectors[connectorId]->setTxBegin(txNr);
+}
+
+void TransactionStore::setTxEnd(unsigned int connectorId, unsigned int txNr) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return;
+    }
+    return connectors[connectorId]->setTxEnd(txNr);
+}
+
+unsigned int TransactionStore::size(unsigned int connectorId) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("Invalid connectorId");
+        return 0;
+    }
+    return connectors[connectorId]->size();
 }
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
index c2069496..03df40a2 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
@@ -12,6 +12,10 @@
 
 #define MAX_TX_CNT 100000U
 
+#ifndef AO_TXRECORD_SIZE
+#define AO_TXRECORD_SIZE 4 //no. of tx to hold on flash storage
+#endif
+
 namespace ArduinoOcpp {
 
 class TransactionStore;
@@ -22,12 +26,11 @@ class ConnectorTransactionStore {
     const uint connectorId;
 
     std::shared_ptr<FilesystemAdapter> filesystem;
+    std::shared_ptr<Configuration<int>> txBegin; //if txNr < txBegin, tx has been safely deleted
     std::shared_ptr<Configuration<int>> txEnd;
     
     std::deque<std::weak_ptr<Transaction>> transactions;
 
-    std::shared_ptr<Configuration<int>> txBegin; //if txNr < txBegin, tx has been safely deleted
-
 public:
     ConnectorTransactionStore(TransactionStore& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
     
@@ -35,12 +38,16 @@ class ConnectorTransactionStore {
     bool commit(Transaction *transaction);
 
     std::shared_ptr<Transaction> getTransaction(unsigned int txNr);
-    std::shared_ptr<Transaction> createTransaction();
+    std::shared_ptr<Transaction> createTransaction(bool silent = false);
 
     bool remove(unsigned int txNr);
 
     int getTxBegin();
-    void updateTxBegin(unsigned int txNr);
+    int getTxEnd();
+    void setTxBegin(unsigned int txNr);
+    void setTxEnd(unsigned int txNr);
+
+    unsigned int size();
 };
 
 class TransactionStore {
@@ -53,12 +60,16 @@ class TransactionStore {
     bool commit(Transaction *transaction);
 
     std::shared_ptr<Transaction> getTransaction(unsigned int connectorId, unsigned int txNr);
-    std::shared_ptr<Transaction> createTransaction(unsigned int connectorId);
+    std::shared_ptr<Transaction> createTransaction(unsigned int connectorId, bool silent = false);
 
     bool remove(unsigned int connectorId, unsigned int txNr);
 
     int getTxBegin(unsigned int connectorId);
-    void updateTxBegin(unsigned int connectorId, unsigned int txNr);
+    int getTxEnd(unsigned int connectorId);
+    void setTxBegin(unsigned int connectorId, unsigned int txNr);
+    void setTxEnd(unsigned int connectorId, unsigned int txNr);
+
+    unsigned int size(unsigned int connectorId);
 };
 
 }

From eeec6dd2ebe837a3a5ae835bfd7a334b20411e5b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 12 Dec 2022 21:51:09 +0100
Subject: [PATCH 142/549] multi connector notation consitency

---
 src/ArduinoOcpp.cpp   | 2 +-
 src/ArduinoOcpp.h     | 2 +-
 src/ArduinoOcpp_c.cpp | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index a8aa33f9..b2352fee 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -412,7 +412,7 @@ void addErrorCodeInput(std::function<const char *()> errorCodeInput, uint connec
     connector->addConnectorErrorCodeSampler(errorCodeInput);
 }
 
-void addMeterValueInput(std::function<int32_t ()> valueInput, uint connectorId, const char *measurand, const char *unit, const char *location, const char *phase) {
+void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, uint connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index fbe36197..88eafe98 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -206,7 +206,7 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, uint connectorId =
 
 void addErrorCodeInput(std::function<const char *()> errorCodeInput, uint connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
 
-void addMeterValueInput(std::function<int32_t ()> valueInput, uint connectorId = 1, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr); //integrate further metering Inputs
+void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr, uint connectorId = 1); //integrate further metering Inputs
 
 void addMeterValueInput(std::unique_ptr<ArduinoOcpp::SampledValueSampler> valueInput, uint connectorId = 1); //integrate further metering Inputs (more extensive alternative)
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index f60fdfc0..bed2c57f 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -192,10 +192,10 @@ void ao_addErrorCodeInput_m(unsigned int connectorId, InputString errorCodeInput
 }
 
 void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
-    addMeterValueInput(adaptFn(valueInput), 1, measurand, unit, location, phase);
+    addMeterValueInput(adaptFn(valueInput), measurand, unit, location, phase, 1);
 }
 void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
-    addMeterValueInput(adaptFn(valueInput), connectorId, measurand, unit, location, phase);
+    addMeterValueInput(adaptFn(valueInput), measurand, unit, location, phase, connectorId);
 }
 
 void ao_addMeterValueInput(MeterValueInput *meterValueInput) {

From cb438fe0b1f4aec86bfbdc87dd0638cdf4dbe259 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 18 Dec 2022 19:44:19 +0100
Subject: [PATCH 143/549] remove strict read-only protection for strings

---
 .../Core/ConfigurationKeyValue.cpp            | 146 +++---------------
 src/ArduinoOcpp/Core/ConfigurationKeyValue.h  |   8 +-
 2 files changed, 26 insertions(+), 128 deletions(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index a4938db3..404d6a41 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -19,28 +19,23 @@ AbstractConfiguration::AbstractConfiguration() {
 }
 
 AbstractConfiguration::AbstractConfiguration(JsonObject &storedKeyValuePair) {
-    if (storedKeyValuePair["key"].as<JsonVariant>().is<const char*>()) {
-        setKey(storedKeyValuePair["key"]);
-    } else {
-        AO_DBG_ERR("Type mismatch");
+    if (!setKey(storedKeyValuePair["key"] | "")) {
+        AO_DBG_ERR("validation error");
     }
 }
 
 AbstractConfiguration::~AbstractConfiguration() {
-    if (key != nullptr) {
-        free(key);
-    }
-    key = nullptr;
+
 }
 
 void AbstractConfiguration::printKey() {
-    if (key)
-        AO_CONSOLE_PRINTF("%s", key);
+    AO_CONSOLE_PRINTF("%s", key.c_str());
+    (void)0;
 }
 
 size_t AbstractConfiguration::getStorageHeaderJsonCapacity() {
     return JSON_OBJECT_SIZE(1) //key
-            + key_size + 1; //TODO key_size already considers 0-terminator. Is "+1" really necessary here?
+            + key.size() + 1;
 }
 
 void AbstractConfiguration::storeStorageHeader(JsonObject &keyValuePair) {
@@ -49,8 +44,8 @@ void AbstractConfiguration::storeStorageHeader(JsonObject &keyValuePair) {
 }
 
 size_t AbstractConfiguration::getOcppMsgHeaderJsonCapacity() {
-    return JSON_OBJECT_SIZE(2) //key + readonly value
-            + key_size + 1; //TODO key_size already considers 0-terminator. Is "+1" really necessary here?
+    return JSON_OBJECT_SIZE(2) //key + readonly field
+            + key.size() + 1;
 }
 
 void AbstractConfiguration::storeOcppMsgHeader(JsonObject &keyValuePair) {
@@ -64,33 +59,21 @@ void AbstractConfiguration::storeOcppMsgHeader(JsonObject &keyValuePair) {
 }
 
 bool AbstractConfiguration::isValid() {
-    return initializedValue && key != nullptr && key_size > 0 && !toBeRemovedFlag;
+    return initializedValue && !key.empty() && !toBeRemovedFlag;
 }
 
 bool AbstractConfiguration::setKey(const char *newKey) {
-    if (key != nullptr || key_size > 0) {
-        AO_DBG_ERR("Cannot change key or set key twice! Keep old value");
-        return false;
-    }
-
-    key_size = strlen(newKey) + 1; //plus 0-terminator
-
-    if (key_size > KEY_MAXLEN + 1) {
-        AO_DBG_ERR("Maximal key length exceeded: %s. Abort", newKey);
-        return false;
-    } else if (key_size <= 1) {
-        AO_DBG_ERR("Null or empty key not allowed! Abort");
+    if (!key.empty()) {
+        AO_DBG_ERR("cannot override key");
         return false;
     }
 
-    key = (char *) malloc(sizeof(char) * key_size);
-    if (!key) {
-        AO_DBG_ERR("Could not allocate key");
+    if (!newKey || *newKey == '\0') {
+        AO_DBG_ERR("invalid argument");
         return false;
     }
 
-    strcpy(key, newKey);
-
+    key = newKey;
     return true;
 }
 
@@ -125,7 +108,7 @@ uint16_t AbstractConfiguration::getValueRevision() {
 }
 
 bool AbstractConfiguration::keyEquals(const char *other) {
-    return !strcmp(key, other);
+    return !key.compare(other);
 }
 
 template <class T>
@@ -199,7 +182,7 @@ size_t Configuration<T>::getValueJsonCapacity() {
 }
 
 size_t Configuration<const char *>::getValueJsonCapacity() {
-    return JSON_OBJECT_SIZE(1) + value_size;
+    return JSON_OBJECT_SIZE(1) + value.size() + 1;
 }
 
 template<class T>
@@ -294,14 +277,7 @@ Configuration<const char *>::Configuration(JsonObject &storedKeyValuePair) : Abs
 }
 
 Configuration<const char *>::~Configuration() {
-    if (value != nullptr) {
-        free(value);
-        value = nullptr;
-    }
-    if (valueReadOnlyCopy != nullptr) {
-        free(valueReadOnlyCopy);
-        valueReadOnlyCopy = nullptr;
-    }
+
 }
 
 bool Configuration<const char *>::setValue(const char *new_value, size_t buffsize) {
@@ -316,83 +292,8 @@ bool Configuration<const char *>::setValue(const char *new_value, size_t buffsiz
         return false;
     }
 
-    //"ab"
-    //buffsize=5
-    //a != 0 -> checkedBuffsize = 1
-    //b != 0 -> checkedBuffsize = 2
-    //0 == 0 -> checkedBuffsize = 3
-    //break
-    size_t checkedBuffsize = 0;
-    for (size_t i = 0; i < buffsize; i++) {
-        if (new_value[i] != '\0') {
-            checkedBuffsize++;
-        } else {
-            checkedBuffsize++;
-            break;
-        }
-    }
-
-    if (checkedBuffsize <= 0) {
-        AO_DBG_ERR("buffsize is <= 0 -- No change");
-        return false;
-    }
-
-    if (checkedBuffsize > STRING_VAL_MAXLEN + 1) {
-        AO_DBG_ERR("Maximum value length exceeded. Abort");
-        return false;
-    }
-
-    bool value_changed = true;
-    if (checkedBuffsize == value_size) {
-        value_changed = false;
-        for (size_t i = 0; i < value_size; i++) {
-            if (value[i] != new_value[i]) {
-                value_changed = true;
-                break;
-            }
-        }
-
-    }
-    
-    if (value_changed || !initializedValue) {
-
-        if (value != nullptr) {
-            free(value);
-            value = nullptr;
-        }
-
-        if (valueReadOnlyCopy != nullptr) {
-            free(valueReadOnlyCopy);
-            valueReadOnlyCopy = nullptr;
-        }
-
-        value_size = checkedBuffsize;
-
-        value = (char *) malloc (sizeof(char) * value_size);
-        valueReadOnlyCopy = (char *) malloc (sizeof(char) * value_size);
-        if (!value || !valueReadOnlyCopy) {
-            AO_DBG_ERR("Could not allocate value or value copy");
-
-            if (value != nullptr) {
-                free(value);
-                value = nullptr;
-            }
-
-            if (valueReadOnlyCopy != nullptr) {
-                free(valueReadOnlyCopy);
-                valueReadOnlyCopy = nullptr;
-            }
-
-            value_size = 0;
-            return false;
-        }
-
-        strncpy(value, new_value, value_size);
-        strncpy(valueReadOnlyCopy, new_value, value_size);
-
-        value[value_size-1] = '\0';
-        valueReadOnlyCopy[value_size-1] = '\0';
-
+    if (value.compare(new_value) || !initializedValue) {
+        value = new_value;
         value_revision++;
     }
     
@@ -400,7 +301,7 @@ bool Configuration<const char *>::setValue(const char *new_value, size_t buffsiz
         AO_DBG_DEBUG("Initialized config object:");
         AO_CONSOLE_PRINTF("[AO]     > Key = ");
         printKey();
-        AO_CONSOLE_PRINTF(", value = %s\n", value);
+        AO_CONSOLE_PRINTF(", value = %s\n", value.c_str());
     }
     initializedValue = true;
     resetToBeRemovedFlag();
@@ -415,16 +316,15 @@ const char *Configuration<const char *>::operator=(const char *newVal) {
 }
 
 Configuration<const char *>::operator const char*() {
-    strncpy(valueReadOnlyCopy, value, value_size);
-    return valueReadOnlyCopy;
+    return value.c_str();
 }
 
 bool Configuration<const char *>::isValid() {
-    return AbstractConfiguration::isValid() && value != nullptr && valueReadOnlyCopy != nullptr && value_size > 0;
+    return AbstractConfiguration::isValid();
 }
 
 size_t Configuration<const char *>::getBuffsize() {
-    return value_size;
+    return value.size() + 1;
 }
 
 template class Configuration<int>;
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
index 422d3142..bbc57864 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
@@ -7,13 +7,13 @@
 
 #include <ArduinoJson.h>
 #include <memory>
+#include <string>
 
 namespace ArduinoOcpp {
 
 class AbstractConfiguration {
 private:
-    char *key = nullptr;
-    size_t key_size = 0; // key=nullptr --> key_size = 0; key = "" --> key_size = 1; key = "A" --> key_size = 2
+    std::string key;
 
     bool rebootRequiredWhenChanged = false;
 
@@ -94,9 +94,7 @@ class Configuration : public AbstractConfiguration {
 template <>
 class Configuration<const char *> : public AbstractConfiguration {
 private:
-    char *value = nullptr;
-    char *valueReadOnlyCopy = nullptr;
-    size_t value_size = 0;
+    std::string value;
     size_t getValueJsonCapacity();
 public:
     Configuration();

From 35eb4421930ecb9ef0989e1f617f47d6f94cda00 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 18 Dec 2022 19:45:12 +0100
Subject: [PATCH 144/549] add FreeVend mode

---
 .../ChargePointStatus/ConnectorStatus.cpp     | 49 +++++++++++++++----
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  3 ++
 2 files changed, 42 insertions(+), 10 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index e94203b1..76305d40 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -30,14 +30,18 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
 
     connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN, true, true, true, false);
     minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
-    stopTransactionOnInvalidId = declareConfiguration<const char*>("StopTransactionOnInvalidId", "true", CONFIGURATION_FN, true, true, false, false);
-    stopTransactionOnEVSideDisconnect = declareConfiguration<const char*>("StopTransactionOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, false, false);
-    unlockConnectorOnEVSideDisconnect = declareConfiguration<const char*>("UnlockConnectorOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, false, false);
-    localAuthorizeOffline = declareConfiguration<const char*>("LocalAuthorizeOffline", "false", CONFIGURATION_FN, true, true, false, false);
-    localPreAuthorize = declareConfiguration<const char*>("LocalPreAuthorize", "false", CONFIGURATION_FN, true, true, false, false);
+    stopTransactionOnInvalidId = declareConfiguration<const char*>("StopTransactionOnInvalidId", "true", CONFIGURATION_FN, true, true, true, false);
+    stopTransactionOnEVSideDisconnect = declareConfiguration<const char*>("StopTransactionOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, true, false);
+    unlockConnectorOnEVSideDisconnect = declareConfiguration<const char*>("UnlockConnectorOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, true, false);
+    localAuthorizeOffline = declareConfiguration<const char*>("LocalAuthorizeOffline", "false", CONFIGURATION_FN, true, true, true, false);
+    localPreAuthorize = declareConfiguration<const char*>("LocalPreAuthorize", "false", CONFIGURATION_FN, true, true, true, false);
 
     //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
-    silentOfflineTransactions = declareConfiguration<const char*>("AO_SilentOfflineTransactions", "false", CONFIGURATION_FN, true, true, false, false);
+    silentOfflineTransactions = declareConfiguration<const char*>("AO_SilentOfflineTransactions", "false", CONFIGURATION_FN, true, true, true, false);
+
+    //FreeVend mode
+    freeVendActive = declareConfiguration<const char*>("AO_FreeVendActive", "true", CONFIGURATION_FN, true, true, true, false);
+    freeVendIdTag = declareConfiguration<const char*>("AO_FreeVendIdTag", "testtesttest", CONFIGURATION_FN, true, true, true, false);
 
     if (!availability) {
         AO_DBG_ERR("Cannot declare availability");
@@ -98,9 +102,8 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
         return OcppEvseState::Unavailable;
     } else if (transaction && transaction->isRunning()) {
         //Transaction is currently running
-        if ((connectorEnergizedSampler && !connectorEnergizedSampler()) ||
-                !transaction->isActive() || //will forbid charging
-                transaction->isIdTagDeauthorized()) {
+        if (!ocppPermitsCharge() ||
+                (connectorEnergizedSampler && !connectorEnergizedSampler())) {
             return OcppEvseState::SuspendedEVSE;
         }
         if (evRequestsEnergySampler && !evRequestsEnergySampler()) {
@@ -134,11 +137,18 @@ bool ConnectorStatus::ocppPermitsCharge() {
         return false;
     }
 
+    bool suspendDeAuthorizedIdTag = transaction && transaction->isIdTagDeauthorized(); //if idTag status is "DeAuthorized" and if charging should stop
+    
+    //check special case for DeAuthorized idTags: FreeVend mode
+    if (suspendDeAuthorizedIdTag && freeVendActive && !strcmp(*freeVendActive, "true")) {
+        suspendDeAuthorizedIdTag = false;
+    }
+
     return transaction &&
             transaction->isRunning() &&
             transaction->isActive() &&
             !getErrorCode() &&
-            !transaction->isIdTagDeauthorized();
+            !suspendDeAuthorizedIdTag;
 }
 
 OcppMessage *ConnectorStatus::loop() {
@@ -313,6 +323,25 @@ OcppMessage *ConnectorStatus::loop() {
         }
     } //end transaction-related operations
 
+    //handle FreeVend mode
+    if (freeVendActive && *freeVendActive && !strcmp(*freeVendActive, "true") && connectorPluggedSampler) {
+        if (!freeVendTrackPlugged && connectorPluggedSampler() && !transaction) {
+            const char *idTag = freeVendIdTag && *freeVendIdTag ? *freeVendIdTag : "";
+            if (!idTag || *idTag == '\0') {
+                idTag = "A0000000";
+            }
+            AO_DBG_INFO("begin FreeVend Tx using idTag %s", idTag);
+            beginSession(idTag);
+            
+            if (!transaction) {
+                AO_DBG_ERR("could not begin FreeVend Tx");
+                (void)0;
+            }
+        }
+
+        freeVendTrackPlugged = connectorPluggedSampler();
+    }
+
     auto inferedStatus = inferenceStatus();
     
     if (inferedStatus != currentStatus) {
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 0286ae7f..7acc84da 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -63,6 +63,9 @@ class ConnectorStatus {
     std::shared_ptr<Configuration<const char*>> localPreAuthorize;
 
     std::shared_ptr<Configuration<const char*>> silentOfflineTransactions;
+    std::shared_ptr<Configuration<const char*>> freeVendActive;
+    std::shared_ptr<Configuration<const char*>> freeVendIdTag;
+    bool freeVendTrackPlugged = false;
 public:
     ConnectorStatus(OcppModel& context, int connectorId);
 

From a39f815e0ba28a7e14e3d77bca4193366346f9ff Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 18 Dec 2022 19:56:50 +0100
Subject: [PATCH 145/549] fix FreeVend default values

---
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 76305d40..39c89f0c 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -40,8 +40,8 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
     silentOfflineTransactions = declareConfiguration<const char*>("AO_SilentOfflineTransactions", "false", CONFIGURATION_FN, true, true, true, false);
 
     //FreeVend mode
-    freeVendActive = declareConfiguration<const char*>("AO_FreeVendActive", "true", CONFIGURATION_FN, true, true, true, false);
-    freeVendIdTag = declareConfiguration<const char*>("AO_FreeVendIdTag", "testtesttest", CONFIGURATION_FN, true, true, true, false);
+    freeVendActive = declareConfiguration<const char*>("AO_FreeVendActive", "false", CONFIGURATION_FN, true, true, true, false);
+    freeVendIdTag = declareConfiguration<const char*>("AO_FreeVendIdTag", "", CONFIGURATION_FN, true, true, true, false);
 
     if (!availability) {
         AO_DBG_ERR("Cannot declare availability");

From 4303bdc78ae2fadfb5e803e9edf25aea6af4ecf3 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 18 Dec 2022 20:19:00 +0100
Subject: [PATCH 146/549] fix badge

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2c6db156..56b2ca58 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; ArduinoOcpp
 
-[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
+[![Build Status]( https://github.com/matth-x/ArduinoOcpp/workflows/PlatformIO%20CI/badge.svg)](https://github.com/matth-x/ArduinoOcpp/actions)
 
 OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with Espressif, NXP, Texas Instruments and STM.
 

From 1d7c4a3aa13318a27d00390ed8989dadc8087235 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 18 Dec 2022 20:21:26 +0100
Subject: [PATCH 147/549] fix badge

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2c6db156..56b2ca58 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; ArduinoOcpp
 
-[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/matth-x/ArduinoOcpp/PlatformIO%20CI?logo=github)](https://github.com/matth-x/ArduinoOcpp/actions)
+[![Build Status]( https://github.com/matth-x/ArduinoOcpp/workflows/PlatformIO%20CI/badge.svg)](https://github.com/matth-x/ArduinoOcpp/actions)
 
 OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with Espressif, NXP, Texas Instruments and STM.
 

From 0983669349366494e724901afb2886a4b7b36744 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 19 Dec 2022 11:00:12 +0100
Subject: [PATCH 148/549] pass connectorId in multi-connector cbs

---
 src/ArduinoOcpp_c.cpp | 160 +++++++++++++++++++++++++++++-------------
 src/ArduinoOcpp_c.h   |  34 +++++----
 2 files changed, 131 insertions(+), 63 deletions(-)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index f60fdfc0..ab7846ad 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -25,26 +25,80 @@ void ao_loop() {
     OCPP_loop();
 }
 
+/*
+ * Helper functions for transforming callback functions from C-style to C++style
+ */
+
+ArduinoOcpp::PollResult<bool> adaptScl(enum OptionalBool v) {
+    if (v == OptionalTrue) {
+        return true;
+    } else if (v == OptionalFalse) {
+        return false;
+    } else if (v == OptionalNone) {
+        return ArduinoOcpp::PollResult<bool>::Await();
+    } else {
+        AO_DBG_ERR("illegal argument");
+        return false;
+    }
+}
+
+enum TxTrigger_t adaptScl(ArduinoOcpp::TxTrigger v) {
+    return v == ArduinoOcpp::TxTrigger::Active ? TxTrigger_t::TxTrg_Active : TxTrigger_t::TxTrg_Inactive;
+}
+
+ArduinoOcpp::TxEnableState adaptScl(enum TxEnableState_t v) {
+    if (v == TxEna_Pending) {
+        return ArduinoOcpp::TxEnableState::Pending;
+    } else if (v == TxEna_Active) {
+        return ArduinoOcpp::TxEnableState::Active;
+    } else if (v == TxEna_Inactive) {
+        return ArduinoOcpp::TxEnableState::Inactive;
+    } else {
+        AO_DBG_ERR("illegal argument");
+        return ArduinoOcpp::TxEnableState::Inactive;
+    }
+}
+
 std::function<bool()> adaptFn(InputBool fn) {
     return fn;
 }
 
+std::function<bool()> adaptFn(unsigned int connectorId, InputBool_m fn) {
+    return [fn, connectorId] () {return fn(connectorId);};
+}
+
 std::function<const char*()> adaptFn(InputString fn) {
     return fn;
 }
 
+std::function<const char*()> adaptFn(unsigned int connectorId, InputString_m fn) {
+    return [fn, connectorId] () {return fn(connectorId);};
+}
+
 std::function<float()> adaptFn(InputFloat fn) {
     return fn;
 }
 
+std::function<float()> adaptFn(unsigned int connectorId, InputFloat_m fn) {
+    return [fn, connectorId] () {return fn(connectorId);};
+}
+
 std::function<int()> adaptFn(InputInt fn) {
     return fn;
 }
 
+std::function<int()> adaptFn(unsigned int connectorId, InputInt_m fn) {
+    return [fn, connectorId] () {return fn(connectorId);};
+}
+
 std::function<void(float)> adaptFn(OutputFloat fn) {
     return fn;
 }
 
+std::function<void(float)> adaptFn(unsigned int connectorId, OutputFloat_m fn) {
+    return [fn, connectorId] (float value) {return fn(connectorId, value);};
+}
+
 std::function<void(void)> adaptFn(void (*fn)(void)) {
     return fn;
 }
@@ -66,6 +120,18 @@ std::function<void(JsonObject)> adaptFn(OnOcppMessage fn) {
     };
 }
 
+std::function<void(JsonObject)> adaptFn(const char *idTag_cstr, OnAuthorize fn) {
+    if (!fn) return nullptr;
+    std::string idTag = idTag_cstr ? idTag_cstr : "undefined";
+    return [fn, idTag] (JsonObject payload) {
+        auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+        if (len <= 0) {
+            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+        }
+        fn(idTag.c_str(), len > 0 ? ao_recv_payload_buff : "", len);
+    };
+}
+
 ArduinoOcpp::OnReceiveErrorListener adaptFn(OnOcppError fn) {
     if (!fn) return nullptr;
     return [fn] (const char *code, const char *description, JsonObject details) {
@@ -77,21 +143,27 @@ ArduinoOcpp::OnReceiveErrorListener adaptFn(OnOcppError fn) {
     };
 }
 
+std::function<ArduinoOcpp::PollResult<bool>()> adaptFn(PollBool fn) {
+    return [fn] () {return adaptScl(fn());};
+}
+
+std::function<ArduinoOcpp::PollResult<bool>()> adaptFn(unsigned int connectorId, PollBool_m fn) {
+    return [fn, connectorId] () {return adaptScl(fn(connectorId));};
+}
+
 std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> adaptFn(TxStepInOut fn) {
     if (!fn) return nullptr;
     return [fn] (ArduinoOcpp::TxTrigger trigger) -> ArduinoOcpp::TxEnableState {
-        auto res = fn(trigger == ArduinoOcpp::TxTrigger::Active ?
-                            TxTrg_Active : TxTrg_Inactive);
-        if (res == TxEna_Pending) {
-            return ArduinoOcpp::TxEnableState::Pending;
-        } else if (res == TxEna_Active) {
-            return ArduinoOcpp::TxEnableState::Active;
-        } else if (res == TxEna_Inactive) {
-            return ArduinoOcpp::TxEnableState::Inactive;
-        } else {
-            AO_DBG_ERR("illegal argument");
-            return ArduinoOcpp::TxEnableState::Inactive;
-        }
+        auto res = fn(adaptScl(trigger));
+        return adaptScl(res);
+    };
+}
+
+std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> adaptFn(unsigned int connectorId, TxStepInOut_m fn) {
+    if (!fn) return nullptr;
+    return [fn, connectorId] (ArduinoOcpp::TxTrigger trigger) -> ArduinoOcpp::TxEnableState {
+        auto res = fn(connectorId, adaptScl(trigger));
+        return adaptScl(res);
     };
 }
 
@@ -110,8 +182,8 @@ void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmat
     bootNotification(std::move(payload), adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
-void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    authorize(idTag, adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
+void ao_authorize(const char *idTag, OnAuthorize onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+    authorize(idTag, adaptFn(idTag, onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
 void ao_beginTransaction(const char *idTag) {
@@ -145,57 +217,57 @@ bool ao_ocppPermitsCharge_m(unsigned int connectorId) {
 void ao_setConnectorPluggedInput(InputBool pluggedInput) {
     setConnectorPluggedInput(adaptFn(pluggedInput));
 }
-void ao_setConnectorPluggedInput_m(unsigned int connectorId, InputBool pluggedInput) {
-    setConnectorPluggedInput(adaptFn(pluggedInput), connectorId);
+void ao_setConnectorPluggedInput_m(unsigned int connectorId, InputBool_m pluggedInput) {
+    setConnectorPluggedInput(adaptFn(connectorId, pluggedInput), connectorId);
 }
 
 void ao_setEnergyMeterInput(InputInt energyInput) {
     setEnergyMeterInput(adaptFn(energyInput));
 }
-void ao_setEnergyMeterInput_m(unsigned int connectorId, InputInt energyInput) {
-    setEnergyMeterInput(adaptFn(energyInput), connectorId);
+void ao_setEnergyMeterInput_m(unsigned int connectorId, InputInt_m energyInput) {
+    setEnergyMeterInput(adaptFn(connectorId, energyInput), connectorId);
 }
 
 void ao_setPowerMeterInput(InputFloat powerInput) {
     setPowerMeterInput(adaptFn(powerInput));
 }
-void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat powerInput) {
-    setPowerMeterInput(adaptFn(powerInput), connectorId);
+void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat_m powerInput) {
+    setPowerMeterInput(adaptFn(connectorId, powerInput), connectorId);
 }
 
 void ao_setSmartChargingOutput(OutputFloat chargingLimitOutput) {
     setSmartChargingOutput(adaptFn(chargingLimitOutput));
 }
-void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputFloat chargingLimitOutput) {
-    setSmartChargingOutput(adaptFn(chargingLimitOutput), connectorId);
+void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputFloat_m chargingLimitOutput) {
+    setSmartChargingOutput(adaptFn(connectorId, chargingLimitOutput), connectorId);
 }
 
 void ao_setEvReadyInput(InputBool evReadyInput) {
     setEvReadyInput(adaptFn(evReadyInput));
 }
-void ao_setEvReadyInput_m(unsigned int connectorId, InputBool evReadyInput) {
-    setEvReadyInput(adaptFn(evReadyInput), connectorId);
+void ao_setEvReadyInput_m(unsigned int connectorId, InputBool_m evReadyInput) {
+    setEvReadyInput(adaptFn(connectorId, evReadyInput), connectorId);
 }
 
 void ao_setEvseReadyInput(InputBool evseReadyInput) {
     setEvseReadyInput(adaptFn(evseReadyInput));
 }
-void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool evseReadyInput) {
-    setEvseReadyInput(adaptFn(evseReadyInput), connectorId);
+void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput) {
+    setEvseReadyInput(adaptFn(connectorId, evseReadyInput), connectorId);
 }
 
 void ao_addErrorCodeInput(InputString errorCodeInput) {
     addErrorCodeInput(adaptFn(errorCodeInput));
 }
-void ao_addErrorCodeInput_m(unsigned int connectorId, InputString errorCodeInput) {
-    addErrorCodeInput(adaptFn(errorCodeInput), connectorId);
+void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput) {
+    addErrorCodeInput(adaptFn(connectorId, errorCodeInput), connectorId);
 }
 
 void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
     addMeterValueInput(adaptFn(valueInput), 1, measurand, unit, location, phase);
 }
-void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
-    addMeterValueInput(adaptFn(valueInput), connectorId, measurand, unit, location, phase);
+void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
+    addMeterValueInput(adaptFn(connectorId, valueInput), connectorId, measurand, unit, location, phase);
 }
 
 void ao_addMeterValueInput(MeterValueInput *meterValueInput) {
@@ -209,36 +281,24 @@ void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterVal
 }
 
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut) {
-    ao_setOnUnlockConnectorInOut_m(1, onUnlockConnectorInOut);
-}
-void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool onUnlockConnectorInOut) {
-    setOnUnlockConnectorInOut([onUnlockConnectorInOut] () -> ArduinoOcpp::PollResult<bool> {
-        auto res = onUnlockConnectorInOut();
-        if (res == OptionalTrue) {
-            return true;
-        } else if (res == OptionalFalse) {
-            return false;
-        } else if (res == OptionalUndefined) {
-            return ArduinoOcpp::PollResult<bool>::Await();
-        } else {
-            AO_DBG_ERR("illegal argument");
-            return false;
-        }
-    }, connectorId);
+    setOnUnlockConnectorInOut(adaptFn(onUnlockConnectorInOut));
+}
+void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut) {
+    setOnUnlockConnectorInOut(adaptFn(connectorId, onUnlockConnectorInOut), connectorId);
 }
 
 void ao_setConnectorLockInOut(TxStepInOut lockConnectorInOut) {
     setConnectorLockInOut(adaptFn(lockConnectorInOut));
 }
-void ao_setConnectorLockInOut_m(unsigned int connectorId, TxStepInOut lockConnectorInOut) {
-    setConnectorLockInOut(adaptFn(lockConnectorInOut), connectorId);
+void ao_setConnectorLockInOut_m(unsigned int connectorId, TxStepInOut_m lockConnectorInOut) {
+    setConnectorLockInOut(adaptFn(connectorId, lockConnectorInOut), connectorId);
 }
 
 void ao_setTxBasedMeterInOut(TxStepInOut txMeterInOut) {
     setTxBasedMeterInOut(adaptFn(txMeterInOut));
 }
-void ao_setTxBasedMeterInOut_m(unsigned int connectorId, TxStepInOut txMeterInOut) {
-    setTxBasedMeterInOut(adaptFn(txMeterInOut), connectorId);
+void ao_setTxBasedMeterInOut_m(unsigned int connectorId, TxStepInOut_m txMeterInOut) {
+    setTxBasedMeterInOut(adaptFn(connectorId, txMeterInOut), connectorId);
 }
 
 bool ao_isOperative() {
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index a59eccd7..3c532d4a 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -14,20 +14,28 @@ struct OcppHandle;
 typedef struct OcppHandle OcppHandle;
 
 typedef void (*OnOcppMessage) (const char *payload, size_t len);
+typedef void (*OnAuthorize) (const char *idTag, const char *payload, size_t len);
 typedef void (*OnOcppAbort)   ();
 typedef void (*OnOcppTimeout) ();
 typedef void (*OnOcppError)   (const char *code, const char *description, const char *details_json, size_t details_len);
 
 typedef float (*InputFloat)();
+typedef float (*InputFloat_m)(unsigned int connectorId); //multiple connectors version
 typedef int   (*InputInt)();
+typedef int   (*InputInt_m)(unsigned int connectorId);
 typedef bool  (*InputBool)();
+typedef bool  (*InputBool_m)(unsigned int connectorId);
 typedef const char* (*InputString)();
+typedef const char* (*InputString_m)(unsigned int connectorId);
 typedef void (*OutputFloat)(float limit);
-enum OptionalBool {OptionalTrue, OptionalFalse, OptionalUndefined};
+typedef void (*OutputFloat_m)(unsigned int connectorId, float limit);
+enum OptionalBool {OptionalTrue, OptionalFalse, OptionalNone};
 typedef enum OptionalBool (*PollBool)();
+typedef enum OptionalBool (*PollBool_m)(unsigned int connectorId);
 enum TxTrigger_t {TxTrg_Active, TxTrg_Inactive};
 enum TxEnableState_t {TxEna_Active, TxEna_Inactive, TxEna_Pending};
 typedef enum TxEnableState_t (*TxStepInOut)(enum TxTrigger_t triggerIn);
+typedef enum TxEnableState_t (*TxStepInOut_m)(unsigned int connectorId, enum TxTrigger_t triggerIn);
 
 
 #ifdef __cplusplus
@@ -54,7 +62,7 @@ void ao_bootNotification(const char *chargePointModel, const char *chargePointVe
 
 void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
-void ao_authorize(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_authorize(const char *idTag, OnAuthorize onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
 /*
  * Charging session management
@@ -77,44 +85,44 @@ bool ao_ocppPermitsCharge_m(unsigned int connectorId);
  */
 
 void ao_setConnectorPluggedInput(InputBool pluggedInput);
-void ao_setConnectorPluggedInput_m(unsigned int connectorId, InputBool pluggedInput);
+void ao_setConnectorPluggedInput_m(unsigned int connectorId, InputBool_m pluggedInput);
 
 void ao_setEnergyMeterInput(InputInt energyInput);
-void ao_setEnergyMeterInput_m(unsigned int connectorId, InputInt energyInput);
+void ao_setEnergyMeterInput_m(unsigned int connectorId, InputInt_m energyInput);
 
 void ao_setPowerMeterInput(InputFloat powerInput);
-void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat powerInput);
+void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat_m powerInput);
 
 void ao_setSmartChargingOutput(OutputFloat chargingLimitOutput);
-void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputFloat chargingLimitOutput);
+void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputFloat_m chargingLimitOutput);
 
 /*
  * Define the Inputs and Outputs of this library. (Advanced)
  */
 
 void ao_setEvReadyInput(InputBool evReadyInput);
-void ao_setEvReadyInput_m(unsigned int connectorId, InputBool evReadyInput);
+void ao_setEvReadyInput_m(unsigned int connectorId, InputBool_m evReadyInput);
 
 void ao_setEvseReadyInput(InputBool evseReadyInput);
-void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool evseReadyInput);
+void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput);
 
 void ao_addErrorCodeInput(InputString errorCodeInput);
-void ao_addErrorCodeInput_m(unsigned int connectorId, InputString errorCodeInput);
+void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput);
 
 void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
-void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
+void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
 
 void ao_addMeterValueInput(MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
-void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool onUnlockConnectorInOut);
+void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);
 
 void ao_setConnectorLockInOut(TxStepInOut lockConnectorInOut);
-void ao_setConnectorLockInOut_m(unsigned int connectorId, TxStepInOut lockConnectorInOut);
+void ao_setConnectorLockInOut_m(unsigned int connectorId, TxStepInOut_m lockConnectorInOut);
 
 void ao_setTxBasedMeterInOut(TxStepInOut txMeterInOut);
-void ao_setTxBasedMeterInOut_m(unsigned int connectorId, TxStepInOut txMeterInOut);
+void ao_setTxBasedMeterInOut_m(unsigned int connectorId, TxStepInOut_m txMeterInOut);
 
 /*
  * Access further information about the internal state of the library

From 16f58510b44cd45762f7f8f9285098023b237b21 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 26 Dec 2022 20:24:27 +0100
Subject: [PATCH 149/549] allow setting custom reset handlers

---
 src/ArduinoOcpp.cpp                           | 22 +++++++++++++++++++
 src/ArduinoOcpp.h                             |  4 ++++
 .../ChargePointStatusService.cpp              |  4 ++--
 .../FirmwareManagement/FirmwareService.cpp    | 14 +++---------
 .../FirmwareManagement/FirmwareService.h      |  2 --
 5 files changed, 31 insertions(+), 15 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index b2352fee..b550de47 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -458,6 +458,28 @@ void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, uint co
     model.getMeteringService()->addMeterValueSampler(connectorId, std::move(valueInput));
 }
 
+void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+
+    if (auto csService = ocppEngine->getOcppModel().getChargePointStatusService()) {
+        csService->setPreReset(onResetNotify);
+    }
+}
+
+void setOnResetExecute(std::function<void(bool)> onResetExecute) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+
+    if (auto csService = ocppEngine->getOcppModel().getChargePointStatusService()) {
+        csService->setExecuteReset(onResetExecute);
+    }
+}
+
 void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, uint connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 88eafe98..2b644e00 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -210,6 +210,10 @@ void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measur
 
 void addMeterValueInput(std::unique_ptr<ArduinoOcpp::SampledValueSampler> valueInput, uint connectorId = 1); //integrate further metering Inputs (more extensive alternative)
 
+void setOnResetNotify(std::function<bool(bool)> onResetNotify); //call onResetNotify(isHard) before Reset. If you return false, Reset will be aborted. Optional
+
+void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handler. This function should reboot this controller immediately. Already defined for the ESP32 on Arduino
+
 /*
  * Set an InputOutput (reads and sets information at the same time) for forcing to unlock the
  * connector. Called as part of the OCPP operation "UnlockConnector"
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 8c356945..3dc68b25 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -83,7 +83,7 @@ void ChargePointStatusService::loop() {
 
         if (outstandingResetRetries <= 0) {
             for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
-                (*connector)->setAvailabilityVolatile(false);
+                (*connector)->setAvailabilityVolatile(true);
             }
         }
     }
@@ -159,7 +159,7 @@ void ChargePointStatusService::initiateReset(bool isHard) {
     t_resetRetry = ao_tick_ms();
 
     for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
-        (*connector)->setAvailabilityVolatile(true);
+        (*connector)->setAvailabilityVolatile(false);
     }
 }
 
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index f2f8dfea..72b025b0 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -58,9 +58,6 @@ void FirmwareService::loop() {
 
             if (cpStatusService) {
                 ConnectorStatus *evse = cpStatusService->getConnector(0);
-                if (!availabilityRestore) {
-                    availabilityRestore = (evse->getAvailability() == AVAILABILITY_OPERATIVE);
-                }
                 evse->setAvailabilityVolatile(false);
             }
             if (onDownload == nullptr) {
@@ -161,17 +158,12 @@ void FirmwareService::loop() {
         if (stage == UpdateStage::Installing) {
 
             //check if client reports installation to be finished
-            if ((installationStatusSampler != nullptr && installationStatusSampler() == InstallationStatus::Installed)
-                    //if client doesn't report installation state, assume download to be finished (at least 40s installation time have passed until here)
-                      || (installationStatusSampler == nullptr)) {
+            if (installationStatusSampler == nullptr || installationStatusSampler() == InstallationStatus::Installed) {
+                        //if client doesn't report installation state, assume download to be finished (at least 40s installation time have passed until here)
+                
                 //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
                 resetStage();
                 retries = 0; //End of update routine. Client must reboot on its own
-                if (availabilityRestore) {
-                    if (cpStatusService && cpStatusService->getConnector(0)) {
-                        cpStatusService->getConnector(0)->setAvailabilityVolatile(true);
-                    }
-                }
                 return;
             }
 
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
index fb9ed2a1..2af4a4b3 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
@@ -67,8 +67,6 @@ class FirmwareService {
 
     void resetStage();
 
-    bool availabilityRestore = false;
-
     std::unique_ptr<OcppOperation> getFirmwareStatusNotification();
 
 public:

From e7a272076b3981c1002a597be79f11ce3dfef576 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 27 Dec 2022 16:26:06 +0100
Subject: [PATCH 150/549] never create / remove entry in ChangeConfiguration

---
 src/ArduinoOcpp/Core/Configuration.cpp        |  10 +-
 .../Core/ConfigurationKeyValue.cpp            |  32 +--
 src/ArduinoOcpp/Core/ConfigurationKeyValue.h  |   7 -
 .../MessagesV16/ChangeConfiguration.cpp       | 230 +++++++-----------
 .../MessagesV16/ChangeConfiguration.h         |  19 +-
 .../MessagesV16/GetCompositeSchedule.cpp      |   2 +-
 6 files changed, 112 insertions(+), 188 deletions(-)

diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 4dfe8bde..55638c01 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -106,18 +106,12 @@ std::shared_ptr<Configuration<T>> declareConfiguration(const char *key, T defaul
     std::shared_ptr<AbstractConfiguration> configuration = container->getConfiguration(key);
 
     if (configuration && strcmp(configuration->getSerializedType(), SerializedType<T>::get())) {
-        AO_DBG_ERR("conflicting declared types. Override previous declaration");
-        container->removeConfiguration(configuration);
-        configuration->setToBeRemoved();
-        configuration = nullptr;
+        AO_DBG_ERR("conflicting declared types");
+        return nullptr;
     }
 
     std::shared_ptr<Configuration<T>> configurationConcrete = std::static_pointer_cast<Configuration<T>>(configuration);
 
-    if (configurationConcrete && configurationConcrete->toBeRemoved()) {
-        (*configurationConcrete) = defaultValue;
-    }
-
     if (!configurationConcrete) {
         configurationConcrete = createConfiguration<T>(key, defaultValue);
         configuration = std::static_pointer_cast<AbstractConfiguration>(configurationConcrete);
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index 404d6a41..f34ca613 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -39,7 +39,6 @@ size_t AbstractConfiguration::getStorageHeaderJsonCapacity() {
 }
 
 void AbstractConfiguration::storeStorageHeader(JsonObject &keyValuePair) {
-    if (toBeRemovedFlag) return;
     keyValuePair["key"] = key;
 }
 
@@ -49,7 +48,6 @@ size_t AbstractConfiguration::getOcppMsgHeaderJsonCapacity() {
 }
 
 void AbstractConfiguration::storeOcppMsgHeader(JsonObject &keyValuePair) {
-    if (toBeRemovedFlag) return;
     keyValuePair["key"] = key;
     if (remotePeerCanWrite) {
         keyValuePair["readonly"] = false;
@@ -59,7 +57,7 @@ void AbstractConfiguration::storeOcppMsgHeader(JsonObject &keyValuePair) {
 }
 
 bool AbstractConfiguration::isValid() {
-    return initializedValue && !key.empty() && !toBeRemovedFlag;
+    return initializedValue && !key.empty();
 }
 
 bool AbstractConfiguration::setKey(const char *newKey) {
@@ -85,24 +83,6 @@ bool AbstractConfiguration::requiresRebootWhenChanged() {
     return rebootRequiredWhenChanged;
 }
 
-bool AbstractConfiguration::toBeRemoved() {
-    return toBeRemovedFlag;
-}
-
-void AbstractConfiguration::setToBeRemoved() {
-    if (!toBeRemovedFlag) {
-        value_revision++;
-    }
-    toBeRemovedFlag = true;
-}
-
-void AbstractConfiguration::resetToBeRemovedFlag() {
-    if (toBeRemovedFlag) {
-        value_revision++;
-    }
-    toBeRemovedFlag = false;
-}
-
 uint16_t AbstractConfiguration::getValueRevision() {
     return value_revision;
 }
@@ -156,7 +136,6 @@ const T &Configuration<T>::operator=(const T & newVal) {
             value_revision++;
         }
         value = newVal;
-        resetToBeRemovedFlag();
     } else {
         AO_DBG_ERR("Tried to override read-only configuration:");
         AO_CONSOLE_PRINTF("[AO]     > Key = ");
@@ -187,7 +166,7 @@ size_t Configuration<const char *>::getValueJsonCapacity() {
 
 template<class T>
 std::shared_ptr<DynamicJsonDocument> Configuration<T>::toJsonStorageEntry() {
-    if (!isValid() || toBeRemoved()) {
+    if (!isValid()) {
         return nullptr;
     }
     size_t capacity = getStorageHeaderJsonCapacity()
@@ -213,7 +192,7 @@ int toCStringValue(char *buf, size_t length, float value) {
 
 template<class T>
 std::shared_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
-    if (!isValid() || toBeRemoved()) {
+    if (!isValid()) {
         return nullptr;
     }
     const size_t VALUE_MAXSIZE = 50;
@@ -231,7 +210,7 @@ std::shared_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
 }
 
 std::shared_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonStorageEntry() {
-    if (!isValid() || toBeRemoved()) {
+    if (!isValid()) {
         return nullptr;
     }
     size_t capacity = getStorageHeaderJsonCapacity()
@@ -247,7 +226,7 @@ std::shared_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonStorageE
 }
 
 std::shared_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonOcppMsgEntry() {
-    if (!isValid() || toBeRemoved()) {
+    if (!isValid()) {
         return nullptr;
     }
     size_t capacity = getOcppMsgHeaderJsonCapacity()
@@ -304,7 +283,6 @@ bool Configuration<const char *>::setValue(const char *new_value, size_t buffsiz
         AO_CONSOLE_PRINTF(", value = %s\n", value.c_str());
     }
     initializedValue = true;
-    resetToBeRemovedFlag();
     return true;
 }
 
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
index bbc57864..90cf0613 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
@@ -20,10 +20,6 @@ class AbstractConfiguration {
     bool remotePeerCanWrite = true;
     bool remotePeerCanRead = true;
     bool localClientCanWrite = true;
-//    const char *serializedAccessControl();
-//    void loadFromSerializedAccessControl(const char *access);
-
-    bool toBeRemovedFlag = false;
 protected:
     uint16_t value_revision = 0; //number of memory-relevant changes of subclass-member "value" (deleting counts too). This will be important for the client to detect if there was a change
     bool initializedValue = false;
@@ -44,9 +40,6 @@ class AbstractConfiguration {
 
     void requireRebootWhenChanged();
     bool requiresRebootWhenChanged();
-    bool toBeRemoved();
-    void setToBeRemoved();
-    void resetToBeRemovedFlag();
 
     uint16_t getValueRevision();
     bool keyEquals(const char *other);
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
index ac03a762..eb4f325b 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
@@ -6,6 +6,8 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
+#include <cmath> //for isNaN check
+
 using ArduinoOcpp::Ocpp16::ChangeConfiguration;
 
 ChangeConfiguration::ChangeConfiguration() {
@@ -18,173 +20,123 @@ const char* ChangeConfiguration::getOcppOperationType(){
 
 void ChangeConfiguration::processReq(JsonObject payload) {
     const char *key = payload["key"] | "";
-    if (strlen(key) < 2) {
-        err = true;
+    if (strlen(key) < 1) {
+        errorCode = "FormationViolation";
         AO_DBG_WARN("Could not read key");
         return;
     }
 
-    JsonVariant value = payload["value"];
-    if (value.isNull()) {
-        err = true;
+    if (!payload["value"].is<const char *>()) {
+        errorCode = "FormationViolation";
         AO_DBG_WARN("Message is lacking value");
         return;
     }
 
-    /*
-     * Delete entry if value field is empty string
-     */
-    if (value.is<const char *>()) {
-        const char *value_string = value.as<const char *>();
-        if (value_string == nullptr || value_string[0] == '\0') {
-            auto configuration = getConfiguration(key);
-            if (configuration) {
-                if (configuration->permissionRemotePeerCanWrite()) {
-                    configuration->setToBeRemoved();
-                    configuration_save();
-                    rebootRequired = true;
-                } else {
-                    readOnly = true;
-                    AO_DBG_WARN("Trying to delete readonly value");
-                }
-            }
-            return; //delete operator but nothing to delete --> ignore operation
+    const char *value = payload["value"];
+
+    std::shared_ptr<AbstractConfiguration> configuration = getConfiguration(key);
+
+    if (!configuration) {
+        //configuration not found or hidden configuration
+        notSupported = true;
+        return;
+    }
+
+    if (!configuration->permissionRemotePeerCanWrite()) {
+        AO_DBG_WARN("Trying to override readonly value");
+
+        if (configuration->permissionRemotePeerCanRead()) {
+            readOnly = true;
+        } else {
+            //can neither read nor write -> hidden config
+            notSupported = true;
         }
+        return;
     }
 
+    //write config
+
     /*
-     * Parse value
-     */
-    bool isInt = false;
-    int numInt = -1;
-    bool isFloat = false;
-    float numFloat = -1.0f;
-    bool isString = false;
-    const char *value_string = "";
-
-    if (value.is<int>()) { //Not enough. SteVe always sends numerical values as strings. Must also handle this
-        isInt = true;
-        numInt = value.as<int>();
-    } else if (value.is<float>()) {
-        isFloat = true;
-        numFloat = value.as<float>();
-    } else if (value.is<const char *>()) { //SteVe sends numerical values as strings. Check for that first
-        isString = true;
-        value_string = value.as<const char *>();
-        size_t value_buffsize = strlen(value_string) + 1;
-
-        /*
-        * Try to interpret input as number
-        */
-
-        int nDigits = 0, nNonDigits = 0, nDots = 0, nSign = 0; //"-1.234" has 4 digits, 0 nonDigits, 1 dot and 1 sign. Don't allow comma as seperator. Don't allow e-expressions (e.g. 1.23e-7)
-        numInt = 0;
-        numFloat = 0.f;
-        float numFloatTranslate = 1.f;
-        for (size_t i = 0; i < value_buffsize - 1; i++) { //exclude terminating \0
-            char c = value_string[i];
-            if (c == '0' || c == '1' || c == '2' || c == '3' || c == '4' || c == '5' || c == '6' || c == '7' || c == '8' || c == '9') {
+    * Try to interpret input as number
+    */
+
+    bool convertibleInt = true;
+    int numInt = 0;
+    bool convertibleFloat = true;
+    float numFloat = 0.f;
+
+    int nDigits = 0, nNonDigits = 0, nDots = 0, nSign = 0; //"-1.234" has 4 digits, 0 nonDigits, 1 dot and 1 sign. Don't allow comma as seperator. Don't allow e-expressions (e.g. 1.23e-7)
+    float numFloatTranslate = 1.f;
+    for (const char *c = value; *c; ++c) {
+        if (*c >= '0' && *c <= '9') {
+            //int interpretation
+            if (nDots == 0) { //only append number if before floating point
                 nDigits++;
                 numInt *= 10;
-                numInt += c - '0';
-                numFloat *= 10.f;
-                numFloat += (float) (c - '0');
-                if (nDots != 0) {
-                    numFloatTranslate *= 10.f;
-                }
-            } else if (c == '.') {
-                nDots++;
-            } else if (i == 0 && c == '-') {
-                nSign++;
-            } else {
-                nNonDigits++;
-            }
-        }
-
-        int INT_MAXDIGITS; //plausibility check: this allows a numerical range of (-999,999,999 to 999,999,999), or (-9,999 to 9,999) respectively
-        if (sizeof(int) >= 4UL)
-            INT_MAXDIGITS = 9;
-        else
-            INT_MAXDIGITS = 4;
-
-        if (nNonDigits == 0 && nDigits > 0 && nSign <= 1 && nDots == 0) {
-            //integer
-            if (nDigits > INT_MAXDIGITS) {
-                AO_DBG_WARN("Integer overflow! key = %s, value = %s", key, value_string);
-                err = true;
-                return;
-            } else {
-                if (nSign == 1) {
-                    int neg = -numInt;
-                    numInt = neg; 
-                }
-                isInt = true;
+                numInt += *c - '0';
             }
-        } else if (nNonDigits == 0 && nDigits > 0 && nSign <= 1 && nDots == 1) {
-            //float
-            // no overflow check
-            numFloat /= numFloatTranslate; // "1." <-- numFlTrans = 1.f; "-1.234" <-- numFlTrans = 1000.f
 
-            if (nSign == 1) {
-                numFloat *= -1.f;
+            //float interpretation
+            numFloat *= 10.f;
+            numFloat += (float) (*c - '0');
+            if (nDots != 0) {
+                numFloatTranslate *= 10.f;
             }
-
-            isFloat = true;
+        } else if (*c == '.') {
+            nDots++;
+        } else if (c == value && *c == '-') {
+            nSign++;
         } else {
-            //only string
-            isString = true;
+            nNonDigits++;
         }
     }
 
-    std::shared_ptr<AbstractConfiguration> configuration = getConfiguration(key);
+    numFloat /= numFloatTranslate; // "1." <-- numFlTrans = 1.f; "-1.234" <-- numFlTrans = 1000.f
 
-    if (configuration) {
-        if (!configuration->permissionRemotePeerCanWrite()) {
-            readOnly = true;
-            AO_DBG_WARN("Trying to override readonly value");
-            return;
-        }
+    if (nSign == 1) {
+        numInt = -numInt;
+        numFloat *= -1.f;
+    }
 
-        if (!strcmp(configuration->getSerializedType(), SerializedType<int>::get()) && isInt) {
-            std::shared_ptr<Configuration<int>> configurationConcrete = std::static_pointer_cast<Configuration<int>>(configuration);
-            *configurationConcrete = numInt;
-        } else if (!strcmp(configuration->getSerializedType(), SerializedType<float>::get()) && isFloat) {
-            std::shared_ptr<Configuration<float>> configurationConcrete = std::static_pointer_cast<Configuration<float>>(configuration);
-            *configurationConcrete = numFloat;
-        } else if (!strcmp(configuration->getSerializedType(), SerializedType<const char *>::get()) && isString) {
-            std::shared_ptr<Configuration<const char *>> configurationConcrete = std::static_pointer_cast<Configuration<const char *>>(configuration);
-            *configurationConcrete = value_string;
-        } else {
-            err = true;
-            AO_DBG_WARN("Value has incompatible type");
-            return;
-        }
+    int INT_MAXDIGITS; //plausibility check: this allows a numerical range of (-999,999,999 to 999,999,999), or (-9,999 to 9,999) respectively
+    if (sizeof(int) >= 4UL)
+        INT_MAXDIGITS = 9;
+    else
+        INT_MAXDIGITS = 4;
 
-        configuration->resetToBeRemovedFlag();
+    if (nNonDigits > 0 || nDigits == 0 || nSign > 1 || nDots > 1) {
+        convertibleInt = false;
+        convertibleFloat = false;
+    }
 
-    } else {
-        //configuration does not exist yet. Create new entry
-        if (isInt) {
-            configuration = std::static_pointer_cast<AbstractConfiguration>(declareConfiguration<int>(key, numInt));
-        } else if (isFloat) {
-            configuration = std::static_pointer_cast<AbstractConfiguration>(declareConfiguration<float>(key, numFloat));
-        } else if (isString) {
-            configuration = std::static_pointer_cast<AbstractConfiguration>(declareConfiguration<const char*>(key, value_string));
-        } else {
-            err = true;
-            AO_DBG_WARN("Could not parse value");
-            return;
-        }
-    } //end if (configuration)
+    if (nDigits > INT_MAXDIGITS) {
+        AO_DBG_DEBUG("Possible integer overflow: key = %s, value = %s", key, value);
+        convertibleInt = false;
+    }
+
+    if (std::isnan(numFloat)) {
+        convertibleFloat = false;
+    }
     
-    if (!configuration) {
-        err = true;
-        AO_DBG_WARN("Could not deserialize value or set configuration");
+    //Store (parsed) value to Config
+
+    if (!strcmp(configuration->getSerializedType(), SerializedType<int>::get()) && convertibleInt) {
+        std::shared_ptr<Configuration<int>> configurationConcrete = std::static_pointer_cast<Configuration<int>>(configuration);
+        *configurationConcrete = numInt;
+    } else if (!strcmp(configuration->getSerializedType(), SerializedType<float>::get()) && convertibleFloat) {
+        std::shared_ptr<Configuration<float>> configurationConcrete = std::static_pointer_cast<Configuration<float>>(configuration);
+        *configurationConcrete = numFloat;
+    } else if (!strcmp(configuration->getSerializedType(), SerializedType<const char *>::get())) {
+        std::shared_ptr<Configuration<const char *>> configurationConcrete = std::static_pointer_cast<Configuration<const char *>>(configuration);
+        *configurationConcrete = value;
+    } else {
+        reject = true;
+        AO_DBG_WARN("Value has incompatible type");
         return;
     }
 
     //success
-    configuration_save(); //TODO encapsulate in AbstractConfiguration: will split configurations in multiple files. Only write back modified data
+    configuration_save();
 
     if (configuration->requiresRebootWhenChanged()) {
         rebootRequired = true;
@@ -196,7 +148,9 @@ void ChangeConfiguration::processReq(JsonObject payload) {
 std::unique_ptr<DynamicJsonDocument> ChangeConfiguration::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    if (err || readOnly) {
+    if (notSupported) {
+        payload["status"] = "NotSupported";
+    } else if (reject || readOnly) {
         payload["status"] = "Rejected";
     } else if (rebootRequired) {
         payload["status"] = "RebootRequired";
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
index 19c4a1c2..9467cba8 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
+++ b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
@@ -12,17 +12,22 @@ namespace Ocpp16 {
 
 class ChangeConfiguration : public OcppMessage {
 private:
-  bool err = false;
-  bool rebootRequired = false;
-  bool readOnly = false;
+    bool reject = false;
+    bool rebootRequired = false;
+    bool readOnly = false;
+    bool notSupported = false;
+
+    const char *errorCode = nullptr;
 public:
-  ChangeConfiguration();
+    ChangeConfiguration();
+
+    const char* getOcppOperationType();
 
-  const char* getOcppOperationType();
+    void processReq(JsonObject payload);
 
-  void processReq(JsonObject payload);
+    std::unique_ptr<DynamicJsonDocument> createConf();
 
-  std::unique_ptr<DynamicJsonDocument> createConf();
+    const char *getErrorCode() {return errorCode;}
 
 };
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
index 686dc864..b45620ed 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
@@ -41,7 +41,7 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
     }
 
     if (connectorId < 0 || !payload.containsKey("duration")) {
-        errorCode = "FormatViolation";
+        errorCode = "FormationViolation";
     }
 
     if (!ocppModel || !ocppModel->getSmartChargingService()) {

From 249a0d3e67d8f73706a44d1c1ea49c345eb6e1f7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 27 Dec 2022 17:18:10 +0100
Subject: [PATCH 151/549] add bool-type for Configurations

---
 src/ArduinoOcpp/Core/Configuration.cpp         |  2 ++
 .../Core/ConfigurationContainerFlash.cpp       |  2 ++
 src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp |  9 +++++++++
 src/ArduinoOcpp/Core/ConfigurationKeyValue.h   |  1 +
 .../MessagesV16/ChangeConfiguration.cpp        | 18 +++++++++++++++++-
 5 files changed, 31 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 55638c01..5c2a00c0 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -222,10 +222,12 @@ bool configuration_save() {
 
 template std::shared_ptr<Configuration<int>> createConfiguration(const char *key, int value);
 template std::shared_ptr<Configuration<float>> createConfiguration(const char *key, float value);
+template std::shared_ptr<Configuration<bool>> createConfiguration(const char *key, bool value);
 template std::shared_ptr<Configuration<const char *>> createConfiguration(const char *key, const char * value);
 
 template std::shared_ptr<Configuration<int>> declareConfiguration(const char *key, int defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
 template std::shared_ptr<Configuration<float>> declareConfiguration(const char *key, float defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
+template std::shared_ptr<Configuration<bool>> declareConfiguration(const char *key, bool defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
 template std::shared_ptr<Configuration<const char *>> declareConfiguration(const char *key, const char *defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index 46b4f2f2..d8717c13 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -98,6 +98,8 @@ bool ConfigurationContainerFlash::load() {
             configuration = std::make_shared<Configuration<int>>(config);
         } else if (!strcmp(type, SerializedType<float>::get())){
             configuration = std::make_shared<Configuration<float>>(config);
+        } else if (!strcmp(type, SerializedType<bool>::get())){
+            configuration = std::make_shared<Configuration<bool>>(config);
         } else if (!strcmp(type, SerializedType<const char *>::get())){
             configuration = std::make_shared<Configuration<const char *>>(config);
         }
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index f34ca613..1e04e73d 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -119,6 +119,10 @@ void printValue(float value) {
     AO_CONSOLE_PRINTF("%f", value);
 }
 
+void printValue(bool value) {
+    AO_CONSOLE_PRINTF("%s", value ? "true" : "false");
+}
+
 template <class T>
 const T &Configuration<T>::operator=(const T & newVal) {
 
@@ -190,6 +194,10 @@ int toCStringValue(char *buf, size_t length, float value) {
     return snprintf(buf, length, "%.*g", ilength >= 7 ? ilength - 7 : 0, value);
 }
 
+int toCStringValue(char *buf, size_t length, bool value) {
+    return snprintf(buf, length, "%s", value ? "true" : "false");
+}
+
 template<class T>
 std::shared_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
     if (!isValid()) {
@@ -307,6 +315,7 @@ size_t Configuration<const char *>::getBuffsize() {
 
 template class Configuration<int>;
 template class Configuration<float>;
+template class Configuration<bool>;
 template class Configuration<const char *>;
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
index 90cf0613..a4b575dc 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
@@ -64,6 +64,7 @@ struct SerializedType {
 
 template<> struct SerializedType<int> {static const char *get() {return "int";}};
 template<> struct SerializedType<float> {static const char *get() {return "float";}};
+template<> struct SerializedType<bool> {static const char *get() {return "bool";}};
 template<> struct SerializedType<const char*> {static const char *get() {return "string";}};
 
 template <class T>
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
index eb4f325b..249dcd0f 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
@@ -6,7 +6,8 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
-#include <cmath> //for isNaN check
+#include <cmath> //for isnan check
+#include <cctype> //for tolower
 
 using ArduinoOcpp::Ocpp16::ChangeConfiguration;
 
@@ -64,6 +65,8 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     int numInt = 0;
     bool convertibleFloat = true;
     float numFloat = 0.f;
+    bool convertibleBool = true;
+    bool numBool = false;
 
     int nDigits = 0, nNonDigits = 0, nDots = 0, nSign = 0; //"-1.234" has 4 digits, 0 nonDigits, 1 dot and 1 sign. Don't allow comma as seperator. Don't allow e-expressions (e.g. 1.23e-7)
     float numFloatTranslate = 1.f;
@@ -117,6 +120,16 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     if (std::isnan(numFloat)) {
         convertibleFloat = false;
     }
+
+    if (tolower(value[0]) == 't' && tolower(value[1]) == 'r' && tolower(value[2]) == 'u' && tolower(value[3]) == 'e' && !value[4]) {
+        numBool = true;
+    } else if (tolower(value[0]) == 'f' && tolower(value[1]) == 'a' && tolower(value[2]) == 'l' && tolower(value[3]) == 's' && tolower(value[4]) == 'e' && !value[5]) {
+        numBool = false;
+    } else if (convertibleInt) {
+        numBool = numInt != 0;
+    } else {
+        convertibleBool = false;
+    }
     
     //Store (parsed) value to Config
 
@@ -126,6 +139,9 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     } else if (!strcmp(configuration->getSerializedType(), SerializedType<float>::get()) && convertibleFloat) {
         std::shared_ptr<Configuration<float>> configurationConcrete = std::static_pointer_cast<Configuration<float>>(configuration);
         *configurationConcrete = numFloat;
+    } else if (!strcmp(configuration->getSerializedType(), SerializedType<bool>::get()) && convertibleBool) {
+        std::shared_ptr<Configuration<bool>> configurationConcrete = std::static_pointer_cast<Configuration<bool>>(configuration);
+        *configurationConcrete = numBool;
     } else if (!strcmp(configuration->getSerializedType(), SerializedType<const char *>::get())) {
         std::shared_ptr<Configuration<const char *>> configurationConcrete = std::static_pointer_cast<Configuration<const char *>>(configuration);
         *configurationConcrete = value;

From 6bfdc1fe4f2bb61d88fe48cba7ca37f68000a50a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 27 Dec 2022 17:43:15 +0100
Subject: [PATCH 152/549] change to bool configs where applicable

---
 .../ChargePointStatusService.cpp              |  2 +-
 .../ChargePointStatus/ConnectorStatus.cpp     | 24 +++++++++----------
 .../Tasks/ChargePointStatus/ConnectorStatus.h | 16 ++++++-------
 .../Metering/ConnectorMeterValuesRecorder.cpp | 12 +++++-----
 .../Metering/ConnectorMeterValuesRecorder.h   |  4 ++--
 5 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 3dc68b25..f7328171 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -50,7 +50,7 @@ ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned
     /*
      * Further configuration keys which correspond to the Core profile
      */
-    declareConfiguration<const char*>("AuthorizeRemoteTxRequests","false",CONFIGURATION_VOLATILE,false,true,false,false);
+    declareConfiguration<bool>("AuthorizeRemoteTxRequests",false,CONFIGURATION_VOLATILE,false,true,false,false);
     declareConfiguration<int>("GetConfigurationMaxKeys",30,CONFIGURATION_VOLATILE,false,true,false,false);
 }
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 39c89f0c..9a8b6868 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -30,17 +30,17 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
 
     connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN, true, true, true, false);
     minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
-    stopTransactionOnInvalidId = declareConfiguration<const char*>("StopTransactionOnInvalidId", "true", CONFIGURATION_FN, true, true, true, false);
-    stopTransactionOnEVSideDisconnect = declareConfiguration<const char*>("StopTransactionOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, true, false);
-    unlockConnectorOnEVSideDisconnect = declareConfiguration<const char*>("UnlockConnectorOnEVSideDisconnect", "true", CONFIGURATION_FN, true, true, true, false);
-    localAuthorizeOffline = declareConfiguration<const char*>("LocalAuthorizeOffline", "false", CONFIGURATION_FN, true, true, true, false);
-    localPreAuthorize = declareConfiguration<const char*>("LocalPreAuthorize", "false", CONFIGURATION_FN, true, true, true, false);
+    stopTransactionOnInvalidId = declareConfiguration<bool>("StopTransactionOnInvalidId", true, CONFIGURATION_FN, true, true, true, false);
+    stopTransactionOnEVSideDisconnect = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
+    unlockConnectorOnEVSideDisconnect = declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
+    localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", false, CONFIGURATION_FN, true, true, true, false);
+    localPreAuthorize = declareConfiguration<bool>("LocalPreAuthorize", false, CONFIGURATION_FN, true, true, true, false);
 
     //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
-    silentOfflineTransactions = declareConfiguration<const char*>("AO_SilentOfflineTransactions", "false", CONFIGURATION_FN, true, true, true, false);
+    silentOfflineTransactions = declareConfiguration<bool>("AO_SilentOfflineTransactions", false, CONFIGURATION_FN, true, true, true, false);
 
     //FreeVend mode
-    freeVendActive = declareConfiguration<const char*>("AO_FreeVendActive", "false", CONFIGURATION_FN, true, true, true, false);
+    freeVendActive = declareConfiguration<bool>("AO_FreeVendActive", false, CONFIGURATION_FN, true, true, true, false);
     freeVendIdTag = declareConfiguration<const char*>("AO_FreeVendIdTag", "", CONFIGURATION_FN, true, true, true, false);
 
     if (!availability) {
@@ -140,7 +140,7 @@ bool ConnectorStatus::ocppPermitsCharge() {
     bool suspendDeAuthorizedIdTag = transaction && transaction->isIdTagDeauthorized(); //if idTag status is "DeAuthorized" and if charging should stop
     
     //check special case for DeAuthorized idTags: FreeVend mode
-    if (suspendDeAuthorizedIdTag && freeVendActive && !strcmp(*freeVendActive, "true")) {
+    if (suspendDeAuthorizedIdTag && freeVendActive && *freeVendActive) {
         suspendDeAuthorizedIdTag = false;
     }
 
@@ -194,7 +194,7 @@ OcppMessage *ConnectorStatus::loop() {
             
         if (connectorPluggedSampler) {
             if (transaction->isRunning() && transaction->isInSession() && !connectorPluggedSampler()) {
-                if (!*stopTransactionOnEVSideDisconnect || strcmp(*stopTransactionOnEVSideDisconnect, "false")) {
+                if (!stopTransactionOnEVSideDisconnect || *stopTransactionOnEVSideDisconnect) {
                     AO_DBG_DEBUG("Stop Tx due to EV disconnect");
                     transaction->setStopReason("EVDisconnected");
                     transaction->endSession();
@@ -215,7 +215,7 @@ OcppMessage *ConnectorStatus::loop() {
         }
 
         if (transaction->isInSession() && transaction->isIdTagDeauthorized()) {
-            if (!*stopTransactionOnInvalidId || strcmp(*stopTransactionOnInvalidId, "false")) {
+            if (!stopTransactionOnInvalidId || *stopTransactionOnInvalidId) {
                 AO_DBG_DEBUG("DeAuthorize session");
                 transaction->setStopReason("DeAuthorized");
                 transaction->endSession();
@@ -324,7 +324,7 @@ OcppMessage *ConnectorStatus::loop() {
     } //end transaction-related operations
 
     //handle FreeVend mode
-    if (freeVendActive && *freeVendActive && !strcmp(*freeVendActive, "true") && connectorPluggedSampler) {
+    if (freeVendActive && *freeVendActive && connectorPluggedSampler) {
         if (!freeVendTrackPlugged && connectorPluggedSampler() && !transaction) {
             const char *idTag = freeVendIdTag && *freeVendIdTag ? *freeVendIdTag : "";
             if (!idTag || *idTag == '\0') {
@@ -460,7 +460,7 @@ void ConnectorStatus::beginSession(const char *sessionIdTag) {
 
     if (!transaction) {
         //couldn't create normal transaction -> check if to start charging without real transaction
-        if (silentOfflineTransactions && *silentOfflineTransactions && !strcmp(*silentOfflineTransactions, "true")) {
+        if (silentOfflineTransactions && *silentOfflineTransactions) {
             //try to handle charging session without sending StartTx or StopTx to the server
             transaction = context.getTransactionStore()->createTransaction(connectorId, true);
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 7acc84da..edd3ba2d 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -56,14 +56,14 @@ class ConnectorStatus {
     TransactionProcess txProcess;
 
     std::shared_ptr<Configuration<int>> connectionTimeOut; //in seconds
-    std::shared_ptr<Configuration<const char*>> stopTransactionOnInvalidId;
-    std::shared_ptr<Configuration<const char*>> stopTransactionOnEVSideDisconnect;
-    std::shared_ptr<Configuration<const char*>> unlockConnectorOnEVSideDisconnect;
-    std::shared_ptr<Configuration<const char*>> localAuthorizeOffline;
-    std::shared_ptr<Configuration<const char*>> localPreAuthorize;
-
-    std::shared_ptr<Configuration<const char*>> silentOfflineTransactions;
-    std::shared_ptr<Configuration<const char*>> freeVendActive;
+    std::shared_ptr<Configuration<bool>> stopTransactionOnInvalidId;
+    std::shared_ptr<Configuration<bool>> stopTransactionOnEVSideDisconnect;
+    std::shared_ptr<Configuration<bool>> unlockConnectorOnEVSideDisconnect;
+    std::shared_ptr<Configuration<bool>> localAuthorizeOffline;
+    std::shared_ptr<Configuration<bool>> localPreAuthorize;
+
+    std::shared_ptr<Configuration<bool>> silentOfflineTransactions;
+    std::shared_ptr<Configuration<bool>> freeVendActive;
     std::shared_ptr<Configuration<const char*>> freeVendIdTag;
     bool freeVendTrackPlugged = false;
 public:
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 563770ae..c7da0c01 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -52,8 +52,8 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
         true,true,true,false
     );
 
-    MeterValuesInTxOnly = declareConfiguration<const char*>("AO_MeterValuesInTxOnly", "true", CONFIGURATION_FN, true, true, true, false);
-    StopTxnDataCapturePeriodic = declareConfiguration<const char*>("AO_StopTxnDataCapturePeriodic", "false", CONFIGURATION_FN, true, true, true, false);
+    MeterValuesInTxOnly = declareConfiguration<bool>("AO_MeterValuesInTxOnly", true, CONFIGURATION_FN, true, true, true, false);
+    StopTxnDataCapturePeriodic = declareConfiguration<bool>("AO_StopTxnDataCapturePeriodic", false, CONFIGURATION_FN, true, true, true, false);
 
     sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesSampledData));
     alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData));
@@ -96,7 +96,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
         } else {
             //check outside of transaction
 
-            if (!(const char *) *MeterValuesInTxOnly || strcmp(*MeterValuesInTxOnly, "false")) {
+            if (!MeterValuesInTxOnly || *MeterValuesInTxOnly) {
                 //don't take any MeterValues outside of transactions
                 meterData.clear();
                 return nullptr;
@@ -154,7 +154,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
                 meterData.push_back(std::move(sampleMeterValues));
             }
 
-            if (stopTxnData && ((const char*) *StopTxnDataCapturePeriodic && !strcmp(*StopTxnDataCapturePeriodic, "true"))) {
+            if (stopTxnData && StopTxnDataCapturePeriodic && *StopTxnDataCapturePeriodic) {
                 auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SamplePeriodic);
                 if (sampleStopTx) {
                     stopTxnData->addTxData(std::move(sampleStopTx));
@@ -205,9 +205,9 @@ void ConnectorMeterValuesRecorder::addMeterValueSampler(std::unique_ptr<SampledV
     samplers.push_back(std::move(meterValueSampler));
 }
 
-std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readTxEnergyMeter(ReadingContext reason) {
+std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readTxEnergyMeter(ReadingContext context) {
     if (energySamplerIndex >= 0 && (size_t) energySamplerIndex < samplers.size()) {
-        return samplers[energySamplerIndex]->takeValue(reason);
+        return samplers[energySamplerIndex]->takeValue(context);
     } else {
         AO_DBG_DEBUG("Called readTxEnergyMeter(), but no energySampler or handling strategy set");
         return nullptr;
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index 76d898c5..5060fb97 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -58,8 +58,8 @@ class ConnectorMeterValuesRecorder {
 
     std::shared_ptr<Configuration<int>> ClockAlignedDataInterval;
 
-    std::shared_ptr<Configuration<const char*>> MeterValuesInTxOnly;
-    std::shared_ptr<Configuration<const char*>> StopTxnDataCapturePeriodic;
+    std::shared_ptr<Configuration<bool>> MeterValuesInTxOnly;
+    std::shared_ptr<Configuration<bool>> StopTxnDataCapturePeriodic;
 public:
     ConnectorMeterValuesRecorder(OcppModel& context, int connectorId, MeterStore& meterStore);
 

From e3e826b26f446d62e150afc710c51a0d3f1f98c4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 28 Dec 2022 23:27:43 +0100
Subject: [PATCH 153/549] validate configs for selecting measurands

---
 .../Core/ConfigurationKeyValue.cpp            |  8 +++++
 src/ArduinoOcpp/Core/ConfigurationKeyValue.h  |  5 +++
 .../MessagesV16/ChangeConfiguration.cpp       | 17 ++++++++-
 .../Metering/ConnectorMeterValuesRecorder.cpp | 36 +++++++++++++++++++
 4 files changed, 65 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index 1e04e73d..acbebab2 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -313,6 +313,14 @@ size_t Configuration<const char *>::getBuffsize() {
     return value.size() + 1;
 }
 
+void Configuration<const char *>::setValidator(std::function<bool(const char*)> validator) {
+    this->validator = validator;
+}
+
+std::function<bool(const char*)> Configuration<const char *>::getValidator() {
+    return this->validator;
+}
+
 template class Configuration<int>;
 template class Configuration<float>;
 template class Configuration<bool>;
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
index a4b575dc..fb190fdb 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
@@ -90,6 +90,8 @@ class Configuration<const char *> : public AbstractConfiguration {
 private:
     std::string value;
     size_t getValueJsonCapacity();
+
+    std::function<bool(const char*)> validator;
 public:
     Configuration();
     Configuration(JsonObject &storedKeyValuePair);
@@ -104,6 +106,9 @@ class Configuration<const char *> : public AbstractConfiguration {
     std::shared_ptr<DynamicJsonDocument> toJsonOcppMsgEntry();
 
     const char *getSerializedType() {return SerializedType<const char *>::get();}
+
+    void setValidator(std::function<bool(const char*)> validator);
+    std::function<bool(const char*)> getValidator();
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
index 249dcd0f..71373447 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
@@ -144,6 +144,16 @@ void ChangeConfiguration::processReq(JsonObject payload) {
         *configurationConcrete = numBool;
     } else if (!strcmp(configuration->getSerializedType(), SerializedType<const char *>::get())) {
         std::shared_ptr<Configuration<const char *>> configurationConcrete = std::static_pointer_cast<Configuration<const char *>>(configuration);
+        
+        //string configurations can have a validator
+        auto validator = configurationConcrete->getValidator();
+        if (validator && !validator(value)) {
+            //validator exists and validation fails
+            reject = true;
+            AO_DBG_WARN("validation failed for key=%s value=%s", key, value);
+            return;
+        }
+
         *configurationConcrete = value;
     } else {
         reject = true;
@@ -152,7 +162,12 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     }
 
     //success
-    configuration_save();
+
+    if (!configuration_save()) {
+        AO_DBG_ERR("could not write changes to flash");
+        errorCode = "InternalError";
+        return;
+    }
 
     if (configuration->requiresRebootWhenChanged()) {
         rebootRequired = true;
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index c7da0c01..5fd42f1a 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -59,6 +59,42 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
     alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData));
     stopTxnSampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnSampledData));
     stopTxnAlignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnAlignedData));
+
+    std::function<bool(const char*)> validateSelectString = [this] (const char *csl) {
+        bool isValid = true;
+        const char *l = csl; //the beginning of an entry of the comma-separated list
+        const char *r = l; //one place after the last character of the entry beginning with l
+        while (*l) {
+            if (*l == ',') {
+                l++;
+                continue;
+            }
+            r = l + 1;
+            while (*r != '\0' && *r != ',') {
+                r++;
+            }
+            bool found = false;
+            for (size_t i = 0; i < samplers.size(); i++) {
+                auto &measurand = samplers[i]->getProperties().getMeasurand();
+                if (measurand.length() == r - l &&                              //same length
+                        !strncmp(l, measurand.c_str(), measurand.length())) {   //same content
+                    found = true;
+                    break;
+                }
+            }
+            if (!found) {
+                isValid = false;
+                AO_DBG_WARN("could not find metering device for %.*s", r - l, l);
+                break;
+            }
+            l = r;
+        }
+        return isValid;
+    };
+    MeterValuesSampledData->setValidator(validateSelectString);
+    StopTxnSampledData->setValidator(validateSelectString);
+    MeterValuesAlignedData->setValidator(validateSelectString);
+    StopTxnAlignedData->setValidator(validateSelectString);
 }
 
 OcppMessage *ConnectorMeterValuesRecorder::loop() {

From f211f6accb4a9d7b52b15551eb89e5b3df54ea14 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 29 Dec 2022 08:45:10 +0100
Subject: [PATCH 154/549] fix compiler error

---
 src/ArduinoOcpp/Core/ConfigurationKeyValue.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
index fb190fdb..4038a89c 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
@@ -7,6 +7,7 @@
 
 #include <ArduinoJson.h>
 #include <memory>
+#include <functional>
 #include <string>
 
 namespace ArduinoOcpp {

From 5feac2b9ea16b16179ed02a3dd9faacd75094d25 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 29 Dec 2022 15:52:46 +0100
Subject: [PATCH 155/549] resolve Configuration type conflict

---
 src/ArduinoOcpp/Core/Configuration.cpp | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 5c2a00c0..4285b554 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -106,8 +106,9 @@ std::shared_ptr<Configuration<T>> declareConfiguration(const char *key, T defaul
     std::shared_ptr<AbstractConfiguration> configuration = container->getConfiguration(key);
 
     if (configuration && strcmp(configuration->getSerializedType(), SerializedType<T>::get())) {
-        AO_DBG_ERR("conflicting declared types");
-        return nullptr;
+        AO_DBG_ERR("conflicting declared types. Discard old config");
+        container->removeConfiguration(configuration);
+        configuration = nullptr;
     }
 
     std::shared_ptr<Configuration<T>> configurationConcrete = std::static_pointer_cast<Configuration<T>>(configuration);

From 9efdad2a21cb787e4af261e464445f500f1aa7eb Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 30 Dec 2022 18:38:18 +0100
Subject: [PATCH 156/549] update PIO version

---
 library.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/library.json b/library.json
index d31232fa..5fb9c93d 100644
--- a/library.json
+++ b/library.json
@@ -1,6 +1,6 @@
 {
     "name": "ArduinoOcpp",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "OCPP 1.6 Client for the ESP8266 and ESP32",
     "keywords": "OCPP, 1.6, OCPP 1.6, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, EVSE, Charge Point",
     "repository":
@@ -55,7 +55,7 @@
         [
             "src/sdkconfig*",
             "examples/SECC/WiFiManager*",
-            "src/main.cpp"
+            "src/main*"
         ]
     },
 

From 2a5b0450c98f6b4d6406d4303f1d68d03bf5cf64 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 12 Jan 2023 16:53:58 +0100
Subject: [PATCH 157/549] replace ulong and uint with full type name

---
 src/ArduinoOcpp.cpp                           | 38 +++++++++----------
 src/ArduinoOcpp.h                             | 38 +++++++++----------
 src/ArduinoOcpp/Core/OcppOperation.h          |  8 ++--
 src/ArduinoOcpp/Core/OcppOperationTimeout.cpp |  8 ++--
 src/ArduinoOcpp/Core/OcppOperationTimeout.h   | 16 ++++----
 src/ArduinoOcpp/MessagesV16/GetDiagnostics.h  |  2 +-
 src/ArduinoOcpp/MessagesV16/UpdateFirmware.h  |  2 +-
 .../ChargePointStatusService.h                |  4 +-
 .../ChargePointStatus/ConnectorStatus.cpp     |  2 +-
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  2 +-
 .../FirmwareManagement/FirmwareService.h      |  4 +-
 .../Tasks/Heartbeat/HeartbeatService.cpp      |  4 +-
 .../Tasks/Heartbeat/HeartbeatService.h        |  2 +-
 .../Metering/ConnectorMeterValuesRecorder.cpp |  2 +-
 .../Metering/ConnectorMeterValuesRecorder.h   |  2 +-
 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp |  8 ++--
 .../Tasks/Transactions/TransactionProcess.cpp |  2 +-
 .../Tasks/Transactions/TransactionProcess.h   |  2 +-
 .../Tasks/Transactions/TransactionStore.cpp   |  8 ++--
 .../Tasks/Transactions/TransactionStore.h     |  8 ++--
 20 files changed, 80 insertions(+), 82 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index b550de47..ff66cd90 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -233,7 +233,7 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
     ocppEngine->initiateOperation(std::move(authorize));
 }
 
-bool beginTransaction(const char *idTag, uint connectorId) {
+bool beginTransaction(const char *idTag, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
@@ -251,7 +251,7 @@ bool beginTransaction(const char *idTag, uint connectorId) {
     return true;
 }
 
-bool endTransaction(const char *reason, uint connectorId) {
+bool endTransaction(const char *reason, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
@@ -266,7 +266,7 @@ bool endTransaction(const char *reason, uint connectorId) {
     return res;
 }
 
-bool isTransactionRunning(uint connectorId) {
+bool isTransactionRunning(unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
@@ -279,7 +279,7 @@ bool isTransactionRunning(uint connectorId) {
     return connector->isTransactionRunning();
 }
 
-bool ocppPermitsCharge(uint connectorId) {
+bool ocppPermitsCharge(unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return false;
@@ -292,7 +292,7 @@ bool ocppPermitsCharge(uint connectorId) {
     return connector->ocppPermitsCharge();
 }
 
-void setConnectorPluggedInput(std::function<bool()> pluggedInput, uint connectorId) {
+void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -311,7 +311,7 @@ void setConnectorPluggedInput(std::function<bool()> pluggedInput, uint connector
     }
 }
 
-void setEnergyMeterInput(std::function<float()> energyInput, uint connectorId) {
+void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -333,7 +333,7 @@ void setEnergyMeterInput(std::function<float()> energyInput, uint connectorId) {
     model.getMeteringService()->setEnergySampler(connectorId, energyInput);
 }
 
-void setPowerMeterInput(std::function<float()> powerInput, uint connectorId) {
+void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -356,7 +356,7 @@ void setPowerMeterInput(std::function<float()> powerInput, uint connectorId) {
     model.getMeteringService()->setPowerSampler(connectorId, powerInput);
 }
 
-void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, uint connectorId) {
+void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -373,7 +373,7 @@ void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, uint
     model.getSmartChargingService()->setOnLimitChange(chargingLimitOutput);
 }
 
-void setEvReadyInput(std::function<bool()> evReadyInput, uint connectorId) {
+void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -386,7 +386,7 @@ void setEvReadyInput(std::function<bool()> evReadyInput, uint connectorId) {
     connector->setEvRequestsEnergySampler(evReadyInput);
 }
 
-void setEvseReadyInput(std::function<bool()> evseReadyInput, uint connectorId) {
+void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -399,7 +399,7 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, uint connectorId) {
     connector->setConnectorEnergizedSampler(evseReadyInput);
 }
 
-void addErrorCodeInput(std::function<const char *()> errorCodeInput, uint connectorId) {
+void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -412,7 +412,7 @@ void addErrorCodeInput(std::function<const char *()> errorCodeInput, uint connec
     connector->addConnectorErrorCodeSampler(errorCodeInput);
 }
 
-void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, uint connectorId) {
+void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -445,7 +445,7 @@ void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measur
     addMeterValueInput(std::move(valueSampler), connectorId);
 }
 
-void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, uint connectorId) {
+void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -480,7 +480,7 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute) {
     }
 }
 
-void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, uint connectorId) {
+void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -493,7 +493,7 @@ void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnect
     connector->setOnUnlockConnector(onUnlockConnectorInOut);
 }
 
-void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnectorInOut, uint connectorId) {
+void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnectorInOut, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -506,7 +506,7 @@ void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp:
     connector->setConnectorLock(lockConnectorInOut);
 }
 
-void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> txMeterInOut, uint connectorId) {
+void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> txMeterInOut, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -519,7 +519,7 @@ void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::
     connector->setTxBasedMeterUpdate(txMeterInOut);
 }
 
-bool isOperative(uint connectorId) {
+bool isOperative(unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return true; //assume "true" as default state
@@ -535,7 +535,7 @@ bool isOperative(uint connectorId) {
        &&  (connector->getAvailability() != AVAILABILITY_INOPERATIVE);
 }
 
-int getTransactionId(uint connectorId) {
+int getTransactionId(unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return -1;
@@ -548,7 +548,7 @@ int getTransactionId(uint connectorId) {
     return connector->getTransactionId();
 }
 
-const char *getTransactionIdTag(uint connectorId) {
+const char *getTransactionIdTag(unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return nullptr;
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 2b644e00..e0039efe 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -137,7 +137,7 @@ void authorize(
  * Returns true if it was possible to create a transaction. If it returned false, either another
  * transaction is still running or you need to try it again later.
  */
-bool beginTransaction(const char *idTag, uint connectorId = 1);
+bool beginTransaction(const char *idTag, unsigned int connectorId = 1);
 
 /*
  * End the transaction process by terminating the transaction and setting a reason for its termination.
@@ -150,13 +150,13 @@ bool beginTransaction(const char *idTag, uint connectorId = 1);
  * 
  * Returns true if this action actually ended a transaction. False otherwise
  */
-bool endTransaction(const char *reason = nullptr, uint connectorId = 1);
+bool endTransaction(const char *reason = nullptr, unsigned int connectorId = 1);
 
 /*
  * Returns if the library has started the transaction by sending a StartTransaction and if it hasn't
  * been stopped already by sending a StopTransaction.
  */
-bool isTransactionRunning(uint connectorId = 1);
+bool isTransactionRunning(unsigned int connectorId = 1);
 
 /* 
  * Returns if the OCPP library allows the EVSE to charge at the moment.
@@ -164,7 +164,7 @@ bool isTransactionRunning(uint connectorId = 1);
  * If you integrate it into a J1772 charger, true means that the Control Pilot can send the PWM signal
  * and false means that the Control Pilot must be at a DC voltage.
  */
-bool ocppPermitsCharge(uint connectorId = 1);
+bool ocppPermitsCharge(unsigned int connectorId = 1);
 
 /*
  * Define the Inputs and Outputs of this library.
@@ -186,13 +186,13 @@ bool ocppPermitsCharge(uint connectorId = 1);
  * Configure the library with Inputs and Outputs once in the setup() function.
  */
 
-void setConnectorPluggedInput(std::function<bool()> pluggedInput, uint connectorId = 1); //Input about if an EV is plugged to this EVSE
+void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int connectorId = 1); //Input about if an EV is plugged to this EVSE
 
-void setEnergyMeterInput(std::function<float()> energyInput, uint connectorId = 1); //Input of the electricity meter register
+void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connectorId = 1); //Input of the electricity meter register
 
-void setPowerMeterInput(std::function<float()> powerInput, uint connectorId = 1); //Input of the power meter reading
+void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId = 1); //Input of the power meter reading
 
-void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, uint connectorId = 1); //Output for the Smart Charging limit
+void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId = 1); //Output for the Smart Charging limit
 
 /*
  * Define the Inputs and Outputs of this library. (Advanced)
@@ -200,15 +200,15 @@ void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, uint
  * These Inputs and Outputs are optional depending on the use case of your charger.
  */
 
-void setEvReadyInput(std::function<bool()> evReadyInput, uint connectorId = 1); //Input if EV is ready to charge (= J1772 State C)
+void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorId = 1); //Input if EV is ready to charge (= J1772 State C)
 
-void setEvseReadyInput(std::function<bool()> evseReadyInput, uint connectorId = 1); //Input if EVSE allows charge (= PWM signal on)
+void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId = 1); //Input if EVSE allows charge (= PWM signal on)
 
-void addErrorCodeInput(std::function<const char *()> errorCodeInput, uint connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
+void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned int connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
 
-void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr, uint connectorId = 1); //integrate further metering Inputs
+void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr, unsigned int connectorId = 1); //integrate further metering Inputs
 
-void addMeterValueInput(std::unique_ptr<ArduinoOcpp::SampledValueSampler> valueInput, uint connectorId = 1); //integrate further metering Inputs (more extensive alternative)
+void addMeterValueInput(std::unique_ptr<ArduinoOcpp::SampledValueSampler> valueInput, unsigned int connectorId = 1); //integrate further metering Inputs (more extensive alternative)
 
 void setOnResetNotify(std::function<bool(bool)> onResetNotify); //call onResetNotify(isHard) before Reset. If you return false, Reset will be aborted. Optional
 
@@ -220,7 +220,7 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handle
  * Return values: true on success, false on failure, PollResult::Await if not known yet
  * Continues to call the Cb as long as it returns PollResult::Await
  */
-void setOnUnlockConnectorInOut(std::function<ArduinoOcpp::PollResult<bool>()> onUnlockConnectorInOut, uint connectorId = 1);
+void setOnUnlockConnectorInOut(std::function<ArduinoOcpp::PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId = 1);
 
 /*
  * Set an Input/Output for setting the state of the connector lock. Called in the course of normal
@@ -233,7 +233,7 @@ void setOnUnlockConnectorInOut(std::function<ArduinoOcpp::PollResult<bool>()> on
  *     - TxEnableState::Inactive if connector lock is released
  *     - TxEnableState::Pending otherwise, e.g. if transitioning between the states
  */
-void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnectorInOut, uint connectorId = 1);
+void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnectorInOut, unsigned int connectorId = 1);
 
 /*
  * Set an Input/Output to interact with a transaction-based energy meter. When this OCPP library is
@@ -249,17 +249,17 @@ void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp:
  *     - TxEnableState::Inactive if the tx-based meter has transitioned into a non-transaction-mode
  *     - TxEnableState::Pending otherwise, e.g. if transitioning between the states
  */
-void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> txMeterInOut, uint connectorId = 1);
+void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> txMeterInOut, unsigned int connectorId = 1);
 
 /*
  * Access further information about the internal state of the library
  */
 
-bool isOperative(uint connectorId = 1); //if the charge point is operative or inoperative (see OCPP1.6 Edit2, p. 45)
+bool isOperative(unsigned int connectorId = 1); //if the charge point is operative or inoperative (see OCPP1.6 Edit2, p. 45)
 
-int getTransactionId(uint connectorId = 1); //returns the txId if known, -1 if no transaction is running and 0 if txId not assigned yet
+int getTransactionId(unsigned int connectorId = 1); //returns the txId if known, -1 if no transaction is running and 0 if txId not assigned yet
 
-const char *getTransactionIdTag(uint connectorId = 1); //returns the authorization token if applicable, or nullptr otherwise
+const char *getTransactionIdTag(unsigned int connectorId = 1); //returns the authorization token if applicable, or nullptr otherwise
 
 void setOnResetRequest(OnReceiveReqListener onReceiveReq);
 
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index cb13f62d..64b451da 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -36,10 +36,10 @@ class OcppOperation {
 
     std::unique_ptr<Timeout> timeout{new OfflineSensitiveTimeout(40000)};
 
-    const ulong RETRY_INTERVAL = 3000; //in ms; first retry after ... ms; second retry after 2 * ... ms; third after 4 ...
-    const ulong RETRY_INTERVAL_MAX = 20000; //in ms; 
-    ulong retry_start = 0;
-    ulong retry_interval_mult = 1; // RETRY_INTERVAL * retry_interval_mult gives longer periods with each iteration
+    const unsigned long RETRY_INTERVAL = 3000; //in ms; first retry after ... ms; second retry after 2 * ... ms; third after 4 ...
+    const unsigned long RETRY_INTERVAL_MAX = 20000; //in ms; 
+    unsigned long retry_start = 0;
+    unsigned long retry_interval_mult = 1; // RETRY_INTERVAL * retry_interval_mult gives longer periods with each iteration
 
     uint16_t printReqCounter = 0;
 
diff --git a/src/ArduinoOcpp/Core/OcppOperationTimeout.cpp b/src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
index 1a315586..cd1eb25a 100644
--- a/src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
@@ -38,7 +38,7 @@ bool Timeout::isExceeded() {
     return exceeded;
 }
 
-FixedTimeout::FixedTimeout(ulong TIMEOUT_DURATION) : TIMEOUT_DURATION(TIMEOUT_DURATION) { 
+FixedTimeout::FixedTimeout(unsigned long TIMEOUT_DURATION) : TIMEOUT_DURATION(TIMEOUT_DURATION) { 
     timeout_active = false;
 }
 
@@ -57,12 +57,12 @@ bool FixedTimeout::timerIsExceeded() {
 }
 
 
-OfflineSensitiveTimeout::OfflineSensitiveTimeout(ulong TIMEOUT_DURATION) : TIMEOUT_DURATION(TIMEOUT_DURATION) { 
+OfflineSensitiveTimeout::OfflineSensitiveTimeout(unsigned long TIMEOUT_DURATION) : TIMEOUT_DURATION(TIMEOUT_DURATION) { 
     timeout_active = false;
 }
 
 void OfflineSensitiveTimeout::timerTick(bool sendingSuccessful) {
-    ulong t = ao_tick_ms();
+    unsigned long t = ao_tick_ms();
     
     if (!timeout_active) {
         timeout_active = true;
@@ -77,7 +77,7 @@ void OfflineSensitiveTimeout::timerTick(bool sendingSuccessful) {
     last_tick = t;
 }
 void OfflineSensitiveTimeout::timerRestart() {
-    ulong t = ao_tick_ms();
+    unsigned long t = ao_tick_ms();
     timeout_start = t;
     last_tick = t;
     timeout_active = false;
diff --git a/src/ArduinoOcpp/Core/OcppOperationTimeout.h b/src/ArduinoOcpp/Core/OcppOperationTimeout.h
index 25060537..a6a2f0c6 100644
--- a/src/ArduinoOcpp/Core/OcppOperationTimeout.h
+++ b/src/ArduinoOcpp/Core/OcppOperationTimeout.h
@@ -7,8 +7,6 @@
 
 #include <functional>
 
-#include <sys/types.h>
-
 namespace ArduinoOcpp {
 
 using OnTimeoutListener = std::function<void()>;
@@ -36,11 +34,11 @@ class Timeout {
 
 class FixedTimeout : public Timeout {
 private:
-    ulong TIMEOUT_DURATION;
-    ulong timeout_start;
+    unsigned long TIMEOUT_DURATION;
+    unsigned long timeout_start;
     bool timeout_active;
 public:
-    FixedTimeout(ulong TIMEOUT_EXPIRE);
+    FixedTimeout(unsigned long TIMEOUT_EXPIRE);
     void timerTick(bool sendingSuccessful);
     void timerRestart();
     bool timerIsExceeded();
@@ -48,12 +46,12 @@ class FixedTimeout : public Timeout {
 
 class OfflineSensitiveTimeout : public Timeout {
 private:
-    ulong TIMEOUT_DURATION;
-    ulong timeout_start;
-    ulong last_tick;
+    unsigned long TIMEOUT_DURATION;
+    unsigned long timeout_start;
+    unsigned long last_tick;
     bool timeout_active;
 public:
-    OfflineSensitiveTimeout(ulong TIMEOUT_EXPIRE);
+    OfflineSensitiveTimeout(unsigned long TIMEOUT_EXPIRE);
     void timerTick(bool sendingSuccessful);
     void timerRestart();
     bool timerIsExceeded();
diff --git a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
index 69ed0d0f..52440d7c 100644
--- a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
+++ b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
@@ -15,7 +15,7 @@ class GetDiagnostics : public OcppMessage {
 private:
     std::string location {};
     int retries = 1;
-    ulong retryInterval = 180;
+    unsigned long retryInterval = 180;
     OcppTimestamp startTime = OcppTimestamp();
     OcppTimestamp stopTime = OcppTimestamp();
 
diff --git a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
index edc5a5df..d4841031 100644
--- a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
+++ b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
@@ -16,7 +16,7 @@ class UpdateFirmware : public OcppMessage {
   std::string location {};
   OcppTimestamp retreiveDate = OcppTimestamp();
   int retries = 1;
-  ulong retryInterval = 180;
+  unsigned long retryInterval = 180;
   bool formatError = false;
 public:
   UpdateFirmware();
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
index ae7758d7..62f902e3 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
@@ -26,9 +26,9 @@ class ChargePointStatusService {
 
     std::function<bool(bool isHard)> preReset; //true: reset is possible; false: reject reset; Await: need more time to determine
     std::function<void(bool isHard)> executeReset; //please disconnect WebSocket (AO remains initialized), shut down device and restart with normal initialization routine; on failure reconnect WebSocket
-    uint outstandingResetRetries = 0; //0 = do not reset device
+    unsigned int outstandingResetRetries = 0; //0 = do not reset device
     bool isHardReset = false;
-    ulong t_resetRetry;
+    unsigned long t_resetRetry;
 
     std::shared_ptr<Configuration<int>> resetRetries;
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 9a8b6868..64106d23 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -352,7 +352,7 @@ OcppMessage *ConnectorStatus::loop() {
 
     if (reportedStatus != currentStatus &&
             (*minimumStatusDuration <= 0 || //MinimumStatusDuration disabled
-            ao_tick_ms() - t_statusTransition >= ((ulong) *minimumStatusDuration) * 1000UL)) {
+            ao_tick_ms() - t_statusTransition >= ((unsigned long) *minimumStatusDuration) * 1000UL)) {
         reportedStatus = currentStatus;
         OcppTimestamp reportedTimestamp = context.getOcppTime().getOcppTimestampNow();
         reportedTimestamp -= (ao_tick_ms() - t_statusTransition) / 1000UL;
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index edd3ba2d..f6e69459 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -46,7 +46,7 @@ class ConnectorStatus {
     OcppEvseState currentStatus = OcppEvseState::NOT_SET;
     std::shared_ptr<Configuration<int>> minimumStatusDuration; //in seconds
     OcppEvseState reportedStatus = OcppEvseState::NOT_SET;
-    ulong t_statusTransition = 0;
+    unsigned long t_statusTransition = 0;
 
     std::function<PollResult<bool>()> onUnlockConnector;
 
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
index 2af4a4b3..2e888de7 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
@@ -53,8 +53,8 @@ class FirmwareService {
     std::function<bool(const std::string &location)> onDownload = NULL;
     std::function<bool(const std::string &location)> onInstall = NULL;
 
-    ulong delayTransition = 0;
-    ulong timestampTransition = 0;
+    unsigned long delayTransition = 0;
+    unsigned long timestampTransition = 0;
 
     enum class UpdateStage {
         Idle,
diff --git a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
index 5e04fa63..06e57647 100644
--- a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
+++ b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
@@ -17,9 +17,9 @@ HeartbeatService::HeartbeatService(OcppEngine& context) : context(context) {
 }
 
 void HeartbeatService::loop() {
-    ulong hbInterval = *heartbeatInterval;
+    unsigned long hbInterval = *heartbeatInterval;
     hbInterval *= 1000UL; //conversion s -> ms
-    ulong now = ao_tick_ms();
+    unsigned long now = ao_tick_ms();
 
     if (now - lastHeartbeat >= hbInterval) {
         lastHeartbeat = now;
diff --git a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
index a684c620..05e2c57f 100644
--- a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
+++ b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
@@ -16,7 +16,7 @@ class HeartbeatService {
 private:
     OcppEngine& context;
 
-    ulong lastHeartbeat;
+    unsigned long lastHeartbeat;
     std::shared_ptr<ArduinoOcpp::Configuration<int>> heartbeatInterval;
 
 public:
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 5fd42f1a..6412b7b7 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -184,7 +184,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
     if (*MeterValueSampleInterval >= 1) {
         //record periodic tx data
 
-        if (ao_tick_ms() - lastSampleTime >= (ulong) (*MeterValueSampleInterval * 1000)) {
+        if (ao_tick_ms() - lastSampleTime >= (unsigned long) (*MeterValueSampleInterval * 1000)) {
             auto sampleMeterValues = sampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SamplePeriodic);
             if (sampleMeterValues) {
                 meterData.push_back(std::move(sampleMeterValues));
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index 5060fb97..514c594b 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -43,7 +43,7 @@ class ConnectorMeterValuesRecorder {
     std::shared_ptr<Configuration<const char *>> stopTxnSampledDataSelect;
     std::shared_ptr<Configuration<const char *>> stopTxnAlignedDataSelect;
 
-    ulong lastSampleTime = 0; //0 means not charging right now
+    unsigned long lastSampleTime = 0; //0 means not charging right now
     OcppTimestamp nextAlignedTime;
     std::shared_ptr<Transaction> transaction;
     bool trackTxRunning = false;
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
index 42f0dec4..ec087987 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
@@ -102,8 +102,8 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
         return true;
     }
 
-    const uint MISSES_LIMIT = 3;
-    uint misses = 0;
+    const unsigned int MISSES_LIMIT = 3;
+    unsigned int misses = 0;
 
     while (misses < MISSES_LIMIT) { //search until region without mvs found
         
@@ -241,8 +241,8 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
 
     if (filesystem) {
         if (mvCount == 0) {
-            const uint MISSES_LIMIT = 3;
-            uint misses = 0;
+            const unsigned int MISSES_LIMIT = 3;
+            unsigned int misses = 0;
             unsigned int i = 0;
 
             while (misses < MISSES_LIMIT) { //search until region without mvs found
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
index 66a9384d..bc997715 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
@@ -8,7 +8,7 @@
 
 using namespace ArduinoOcpp;
 
-TransactionProcess::TransactionProcess(uint connectorId) {
+TransactionProcess::TransactionProcess(unsigned int connectorId) {
 
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
index 375fb37a..187ec1bd 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
@@ -25,7 +25,7 @@ class TransactionProcess {
     
 public:
 
-    TransactionProcess(uint connectorId);
+    TransactionProcess(unsigned int connectorId);
 
     void addPrecondition(std::function<TxPrecondition()> fn) {txPreconditions.push_back(fn);}
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index feb3dd37..0d80e2f7 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -20,7 +20,7 @@ using namespace ArduinoOcpp;
 
 #define AO_TXSTORE_META_FN AO_FILENAME_PREFIX "/txstore.jsn"
 
-ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
+ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context, unsigned int connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context),
         connectorId(connectorId),
         filesystem(filesystem) {
@@ -262,15 +262,15 @@ unsigned int ConnectorTransactionStore::size() {
     return (*txEnd + MAX_TX_CNT - *txBegin) % MAX_TX_CNT;
 }
 
-TransactionStore::TransactionStore(uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
+TransactionStore::TransactionStore(unsigned int nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
     
-    for (uint i = 0; i < nConnectors; i++) {
+    for (unsigned int i = 0; i < nConnectors; i++) {
         connectors.push_back(std::unique_ptr<ConnectorTransactionStore>(
             new ConnectorTransactionStore(*this, i, filesystem)));
     }
 }
 
-std::shared_ptr<Transaction> TransactionStore::getLatestTransaction(uint connectorId) {
+std::shared_ptr<Transaction> TransactionStore::getLatestTransaction(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
         AO_DBG_ERR("Invalid connectorId");
         return nullptr;
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
index 03df40a2..87954916 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
@@ -23,7 +23,7 @@ class TransactionStore;
 class ConnectorTransactionStore {
 private:
     TransactionStore& context;
-    const uint connectorId;
+    const unsigned int connectorId;
 
     std::shared_ptr<FilesystemAdapter> filesystem;
     std::shared_ptr<Configuration<int>> txBegin; //if txNr < txBegin, tx has been safely deleted
@@ -32,7 +32,7 @@ class ConnectorTransactionStore {
     std::deque<std::weak_ptr<Transaction>> transactions;
 
 public:
-    ConnectorTransactionStore(TransactionStore& context, uint connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
+    ConnectorTransactionStore(TransactionStore& context, unsigned int connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
     
     std::shared_ptr<Transaction> getLatestTransaction();
     bool commit(Transaction *transaction);
@@ -54,9 +54,9 @@ class TransactionStore {
 private:
     std::vector<std::unique_ptr<ConnectorTransactionStore>> connectors;
 public:
-    TransactionStore(uint nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+    TransactionStore(unsigned int nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
-    std::shared_ptr<Transaction> getLatestTransaction(uint connectorId);
+    std::shared_ptr<Transaction> getLatestTransaction(unsigned int connectorId);
     bool commit(Transaction *transaction);
 
     std::shared_ptr<Transaction> getTransaction(unsigned int connectorId, unsigned int txNr);

From fe11c2eff54219c96bdb6d722d90c0b7d8f51b95 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 19 Jan 2023 21:54:46 +0100
Subject: [PATCH 158/549] fix compiler warnings

---
 .../Tasks/Metering/ConnectorMeterValuesRecorder.cpp         | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 6412b7b7..bbfd9d44 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -12,6 +12,8 @@
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
 
+#include <cstddef>
+
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
@@ -76,7 +78,7 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
             bool found = false;
             for (size_t i = 0; i < samplers.size(); i++) {
                 auto &measurand = samplers[i]->getProperties().getMeasurand();
-                if (measurand.length() == r - l &&                              //same length
+                if ((std::ptrdiff_t) measurand.length() == r - l &&                              //same length
                         !strncmp(l, measurand.c_str(), measurand.length())) {   //same content
                     found = true;
                     break;
@@ -84,7 +86,7 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
             }
             if (!found) {
                 isValid = false;
-                AO_DBG_WARN("could not find metering device for %.*s", r - l, l);
+                AO_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
                 break;
             }
             l = r;

From 2487cbd31bf6d14636b073872726034b5de9ba73 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 20 Jan 2023 12:12:58 +0100
Subject: [PATCH 159/549] select filesystem automatically

---
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp | 29 ++++++++--------------
 src/ArduinoOcpp/Core/FilesystemAdapter.h   | 11 ++++++--
 2 files changed, 19 insertions(+), 21 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 1e778a4c..3c04eb69 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -8,39 +8,27 @@
 
 #ifndef AO_DEACTIVATE_FLASH
 
-//Set default parameters; assume usage with Arduino if no build flags are present
-#ifndef AO_USE_FILEAPI
-#if defined(ESP32)
-#define AO_USE_FILEAPI ARDUINO_LITTLEFS
-#else
-#define AO_USE_FILEAPI ARDUINO_SPIFFS
-#endif
-#endif //ndef AO_USE_FILEAPI
-
 /*
  * Platform specific implementations. Currently supported:
  *     - Arduino LittleFs
  *     - Arduino SPIFFS
  *     - ESP-IDF SPIFFS
+ *     - POSIX-like API (tested on Ubuntu 20.04)
  * 
- * You can add support for any file system by passing custom adapters to the initialize
- * function of ArduinoOcpp
+ * You can add support for other file systems by passing a custom adapter to OCPP_initialize(...)
  */
 
+
+#if AO_USE_FILEAPI == ARDUINO_LITTLEFS || AO_USE_FILEAPI == ARDUINO_SPIFFS
+
 #if AO_USE_FILEAPI == ARDUINO_LITTLEFS
 #include <LITTLEFS.h>
 #define USE_FS LITTLEFS
 #elif AO_USE_FILEAPI == ARDUINO_SPIFFS
 #include <FS.h>
 #define USE_FS SPIFFS
-#elif AO_USE_FILEAPI == ESPIDF_SPIFFS
-#include <sys/stat.h>
-#include "esp_spiffs.h"
 #endif
 
-
-#if AO_USE_FILEAPI == ARDUINO_LITTLEFS || AO_USE_FILEAPI == ARDUINO_SPIFFS
-
 namespace ArduinoOcpp {
 
 class ArduinoFileAdapter : public FileAdapter {
@@ -187,6 +175,9 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 #elif AO_USE_FILEAPI == ESPIDF_SPIFFS
 
+#include <sys/stat.h>
+#include "esp_spiffs.h"
+
 namespace ArduinoOcpp {
 
 class EspIdfFileAdapter : public FileAdapter {
@@ -393,6 +384,6 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 } //end namespace ArduinoOcpp
 
-#endif
+#endif //switch-case AO_USE_FILEAPI
 
-#endif
+#endif //!AO_DEACTIVATE_FLASH
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index e3d57d55..47e788b0 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -17,6 +17,7 @@
 #define POSIX_FILEAPI    4
 
 #include <memory>
+#include <ArduinoOcpp/Platform.h>
 
 namespace ArduinoOcpp {
 
@@ -45,11 +46,17 @@ class FilesystemAdapter {
 
 //Set default parameters; assume usage with Arduino if no build flags are present
 #ifndef AO_USE_FILEAPI
+#if AO_PLATFORM == AO_PLATFORM_ARDUINO
 #if defined(ESP32)
 #define AO_USE_FILEAPI ARDUINO_LITTLEFS
 #else
 #define AO_USE_FILEAPI ARDUINO_SPIFFS
 #endif
+#elif AO_PLATFORM == AO_PLATFORM_ESPIDF
+#define AO_USE_FILEAPI ESPIDF_SPIFFS
+#elif AO_PLATFORM == AO_PLATFORM_UNIX
+#define AO_USE_FILEAPI POSIX_FILEAPI
+#endif //switch-case AO_PLATFORM
 #endif //ndef AO_USE_FILEAPI
 
 /*
@@ -57,9 +64,9 @@ class FilesystemAdapter {
  *     - Arduino LittleFs
  *     - Arduino SPIFFS
  *     - ESP-IDF SPIFFS
+ *     - POSIX-like API (tested on Ubuntu 20.04)
  * 
- * You can add support for any file system by passing custom adapters to the initialize
- * function of ArduinoOcpp
+ * You can add support for other file systems by passing a custom adapter to OCPP_initialize(...)
  */
 
 #if AO_USE_FILEAPI == ARDUINO_LITTLEFS || \

From 27ce8b15cd5158e1b8d637b67fe55416093bfe57 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 20 Jan 2023 16:13:41 +0100
Subject: [PATCH 160/549] cmake support for UNIX targets

---
 CMakeLists.txt | 46 +++++++++++++++++++++++++++++++++++++---------
 1 file changed, 37 insertions(+), 9 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index c2c2d7f5..e7f6f8de 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,3 +1,9 @@
+# matth-x/ArduinoOcpp
+# Copyright Matthias Akstaller 2019 - 2023
+# MIT License
+
+cmake_minimum_required(VERSION 3.15)
+
 set(AO_SRC
     src/ArduinoOcpp/Core/Configuration.cpp
     src/ArduinoOcpp/Core/ConfigurationContainer.cpp
@@ -61,13 +67,35 @@ set(AO_SRC
     src/ArduinoOcpp_c.cpp
 )
 
-idf_component_register(SRCS ${AO_SRC}
-                    INCLUDE_DIRS "./src" "${PROJECT_DIR}/include"
-                    PRIV_REQUIRES spiffs)
+if(ESP_PLATFORM)
+
+    idf_component_register(SRCS ${AO_SRC}
+                        INCLUDE_DIRS "./src" "${PROJECT_DIR}/include"
+                        PRIV_REQUIRES spiffs)
+
+    target_compile_options(${COMPONENT_TARGET} PUBLIC
+        -DAO_CUSTOM_WS
+        -DAO_CUSTOM_UPDATER
+        -DAO_CUSTOM_RESET
+        -DAO_PLATFORM=AO_PLATFORM_ESPIDF)
+
+    return()
+endif()
+
+add_library(ArduinoOcpp ${AO_SRC})
+
+target_include_directories(ArduinoOcpp PUBLIC
+                            "./src"
+                            "../ArduinoJson/src"
+                            )
 
-target_compile_options(${COMPONENT_TARGET} PUBLIC
-    -DAO_CUSTOM_WS
-    -DAO_CUSTOM_UPDATER
-    -DAO_CUSTOM_RESET
-    -DAO_USE_FILEAPI=ESPIDF_SPIFFS
-    -DAO_PLATFORM=AO_PLATFORM_ESPIDF)
+target_compile_definitions(ArduinoOcpp PUBLIC
+    AO_PLATFORM=AO_PLATFORM_UNIX
+    AO_CUSTOM_WS
+    AO_CUSTOM_UPDATER
+    AO_CUSTOM_RESET
+    AO_DBG_LEVEL=AO_DL_DEBUG
+    AO_TRAFFIC_OUT
+    AO_FILENAME_PREFIX="./ao_store"
+    AO_DEACTIVATE_FLASH_SMARTCHARGING
+    )

From ed4e3e766ae0b922bced49e0847bd66216f9d2cd Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 24 Jan 2023 14:57:24 +0100
Subject: [PATCH 161/549] add user_data parameter

---
 src/ArduinoOcpp_c.cpp | 35 +++++++++++++++++++++--------------
 src/ArduinoOcpp_c.h   | 11 +++++++++--
 2 files changed, 30 insertions(+), 16 deletions(-)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 47a86783..060e9e0c 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -120,18 +120,6 @@ std::function<void(JsonObject)> adaptFn(OnOcppMessage fn) {
     };
 }
 
-std::function<void(JsonObject)> adaptFn(const char *idTag_cstr, OnAuthorize fn) {
-    if (!fn) return nullptr;
-    std::string idTag = idTag_cstr ? idTag_cstr : "undefined";
-    return [fn, idTag] (JsonObject payload) {
-        auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
-        if (len <= 0) {
-            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
-        }
-        fn(idTag.c_str(), len > 0 ? ao_recv_payload_buff : "", len);
-    };
-}
-
 ArduinoOcpp::OnReceiveErrorListener adaptFn(OnOcppError fn) {
     if (!fn) return nullptr;
     return [fn] (const char *code, const char *description, JsonObject details) {
@@ -182,8 +170,27 @@ void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmat
     bootNotification(std::move(payload), adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
-void ao_authorize(const char *idTag, OnAuthorize onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
-    authorize(idTag, adaptFn(idTag, onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
+void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
+    
+    std::string idTag_capture = idTag;
+
+    authorize(idTag,
+            onConfirmation ? [onConfirmation, idTag_capture, user_data] (JsonObject payload) {
+                    auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+                    if (len <= 0) {AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
+                    onConfirmation(idTag_capture.c_str(), len > 0 ? ao_recv_payload_buff : "", len, user_data);
+                } : OnReceiveConfListener(nullptr),
+            onAbort ? [onAbort, idTag_capture, user_data] () -> void {
+                    onAbort(idTag_capture.c_str(), user_data);
+                } : OnAbortListener(nullptr),
+            onTimeout ? [onTimeout, idTag_capture, user_data] () {
+                    onTimeout(idTag_capture.c_str(), user_data);
+                } : OnTimeoutListener(nullptr),
+            onError ? [onError, idTag_capture, user_data] (const char *code, const char *description, JsonObject details) {
+                    auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+                    if (len <= 0) {AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
+                    onError(idTag_capture.c_str(), code, description, len > 0 ? ao_recv_payload_buff : "", len, user_data);
+                } : OnReceiveErrorListener(nullptr));
 }
 
 void ao_beginTransaction(const char *idTag) {
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 3c532d4a..fc7dbc64 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -14,10 +14,17 @@ struct OcppHandle;
 typedef struct OcppHandle OcppHandle;
 
 typedef void (*OnOcppMessage) (const char *payload, size_t len);
-typedef void (*OnAuthorize) (const char *idTag, const char *payload, size_t len);
 typedef void (*OnOcppAbort)   ();
 typedef void (*OnOcppTimeout) ();
 typedef void (*OnOcppError)   (const char *code, const char *description, const char *details_json, size_t details_len);
+//typedef void (*ConfCallback)    (const char *payload, size_t len, void* user_data);
+//typedef void (*AbortCallback)   (void* user_data);
+//typedef void (*TimeoutCallback) (void* user_data);
+//typedef void (*ErrorCallback)   (const char *code, const char *description, const char *details_json, size_t details_len, void* user_data);
+typedef void (*AuthorizeConfCallback)    (const char *idTag, const char *payload, size_t len, void *user_data);
+typedef void (*AuthorizeAbortCallback)   (const char *idTag, void* user_data);
+typedef void (*AuthorizeTimeoutCallback) (const char *idTag, void* user_data);
+typedef void (*AuthorizeErrorCallback)   (const char *idTag, const char *code, const char *description, const char *details_json, size_t details_len, void* user_data);
 
 typedef float (*InputFloat)();
 typedef float (*InputFloat_m)(unsigned int connectorId); //multiple connectors version
@@ -62,7 +69,7 @@ void ao_bootNotification(const char *chargePointModel, const char *chargePointVe
 
 void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
 
-void ao_authorize(const char *idTag, OnAuthorize onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data);
 
 /*
  * Charging session management

From 94fbfe120465c7d6ec1da15ddb510e432e656753 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 26 Jan 2023 12:49:21 +0100
Subject: [PATCH 162/549] add missing connector specifier

---
 src/ArduinoOcpp_c.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 060e9e0c..ee4b9a38 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -197,7 +197,7 @@ void ao_beginTransaction(const char *idTag) {
     ao_beginTransaction(idTag);
 }
 void ao_beginTransaction_m(unsigned int connectorId, const char *idTag) {
-    beginTransaction(idTag, 1);
+    beginTransaction(idTag, connectorId);
 }
 
 bool ao_endTransaction(const char *reason) {

From 6cd781e49810f1604c11adad13274f0723f742b7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 26 Jan 2023 22:02:48 +0100
Subject: [PATCH 163/549] add AuthorizationData

---
 .../Tasks/Authorization/AuthorizationData.cpp | 114 ++++++++++++++++++
 .../Tasks/Authorization/AuthorizationData.h   |  52 ++++++++
 .../Tasks/Authorization/AuthorizationList.cpp |   5 +
 .../Tasks/Authorization/AuthorizationList.h   |  37 ++++++
 4 files changed, 208 insertions(+)
 create mode 100644 src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
 create mode 100644 src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h

diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
new file mode 100644
index 00000000..d21bdce5
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
@@ -0,0 +1,114 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationData.h>
+
+#define AUTHDATA_KEY_IDTAG       "it"
+#define AUTHDATA_KEY_EXPIRYDATE  "ed"
+#define AUTHDATA_KEY_PARENTIDTAG "pi"
+#define AUTHDATA_KEY_STATUS      "st"
+
+using ArduinoOcpp::AuthorizationData;
+
+AuthorizationData::AuthorizationData() {
+
+}
+
+AuthorizationData::~AuthorizationData() {
+
+}
+
+void AuthorizationData::readJson(JsonObject entry) {
+    if (entry.containsKey(AUTHDATA_KEY_IDTAG)) {
+        strncpy(idTag, entry[AUTHDATA_KEY_IDTAG], IDTAG_LEN_MAX + 1);
+        idTag[IDTAG_LEN_MAX] = '\0';
+    }
+
+    if (entry.containsKey(AUTHDATA_KEY_EXPIRYDATE)) {
+        expiryDate = std::unique_ptr<OcppTimestamp>(new OcppTimestamp());
+        if (!expiryDate->setTime(entry[AUTHDATA_KEY_EXPIRYDATE])) {
+            expiryDate.reset();
+        }
+    }
+
+    if (entry.containsKey(AUTHDATA_KEY_PARENTIDTAG)) {
+        parentIdTag = std::unique_ptr<char[]>(new char[IDTAG_LEN_MAX + 1]);
+        strncpy(parentIdTag.get(), entry[AUTHDATA_KEY_PARENTIDTAG], IDTAG_LEN_MAX + 1);
+        parentIdTag.get()[IDTAG_LEN_MAX] = '\0';
+    }
+
+    if (entry.containsKey(AUTHDATA_KEY_STATUS)) {
+        status = deserializeAuthorizationStatus(entry[AUTHDATA_KEY_STATUS]);
+    }
+}
+
+size_t AuthorizationData::getJsonCapacity() {
+    return JSON_OBJECT_SIZE(1) +
+            (idTag[0] != '\0' ? 
+                JSON_OBJECT_SIZE(1) : 0) +
+            (expiryDate ?
+                JSON_OBJECT_SIZE(1) + JSONDATE_LENGTH + 1 : 0) +
+            (parentIdTag ?
+                JSON_OBJECT_SIZE(1) : 0) +
+            (status != AuthorizationStatus::UNDEFINED ?
+                JSON_OBJECT_SIZE(1) : 0);
+}
+
+void AuthorizationData::writeJson(JsonObject& entry) {
+    if (idTag[0] != '\0') {
+        entry[AUTHDATA_KEY_IDTAG] = (const char*) idTag;
+    }
+
+    if (expiryDate) {
+        char buf [JSONDATE_LENGTH + 1];
+        if (expiryDate->toJsonString(buf, JSONDATE_LENGTH + 1)) {
+            entry[AUTHDATA_KEY_EXPIRYDATE] = buf;
+        }
+    }
+
+    if (parentIdTag) {
+        entry[AUTHDATA_KEY_PARENTIDTAG] = (const char *) parentIdTag.get();
+    }
+
+    if (status != AuthorizationStatus::UNDEFINED) {
+        entry[AUTHDATA_KEY_STATUS] = serializeAuthorizationStatus(status);
+    }
+}
+
+const char *ArduinoOcpp::serializeAuthorizationStatus(AuthorizationStatus status) {
+    switch (status) {
+        case (AuthorizationStatus::Accepted):
+            return "Accepted";
+        case (AuthorizationStatus::Blocked):
+            return "Blocked";
+        case (AuthorizationStatus::Expired):
+            return "Expired";
+        case (AuthorizationStatus::Invalid):
+            return "Invalid";
+        case (AuthorizationStatus::ConcurrentTx):
+            return "ConcurrentTx";
+        default:
+            return "UNDEFINED";
+    }
+}
+
+ArduinoOcpp::AuthorizationStatus ArduinoOcpp::deserializeAuthorizationStatus(const char *cstr) {
+    if (!cstr) {
+        return AuthorizationStatus::UNDEFINED;
+    }
+
+    if (!strcmp(cstr, "Accepted")) {
+        return AuthorizationStatus::Accepted;
+    } else if (!strcmp(cstr, "Blocked")) {
+        return AuthorizationStatus::Blocked;
+    } else if (!strcmp(cstr, "Expired")) {
+        return AuthorizationStatus::Expired;
+    } else if (!strcmp(cstr, "Invalid")) {
+        return AuthorizationStatus::Invalid;
+    } else if (!strcmp(cstr, "ConcurrentTx")) {
+        return AuthorizationStatus::ConcurrentTx;
+    } else {
+        return AuthorizationStatus::UNDEFINED;
+    }
+}
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
new file mode 100644
index 00000000..122a14b8
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
@@ -0,0 +1,52 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef AUTHORIZATIONDATA_H
+#define AUTHORIZATIONDATA_H
+
+#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoJson.h>
+#include <memory>
+
+namespace ArduinoOcpp {
+
+enum class AuthorizationStatus:uint8_t {
+    Accepted,
+    Blocked,
+    Expired,
+    Invalid,
+    ConcurrentTx,
+    UNDEFINED //not part of OCPP 1.6
+};
+
+#define AUTHORIZATIONSTATUS_LEN_MAX (sizeof("ConcurrentTx") - 1) //max length of serialized AuthStatus
+
+const char *serializeAuthorizationStatus(AuthorizationStatus status);
+AuthorizationStatus deserializeAuthorizationStatus(const char *cstr);
+
+class AuthorizationData {
+private:
+    //data structure optimized for memory consumption
+
+    std::unique_ptr<char[]> parentIdTag;
+    std::unique_ptr<OcppTimestamp> expiryDate;
+
+    char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
+
+    AuthorizationStatus status = AuthorizationStatus::UNDEFINED;
+    uint16_t hist_order;
+public:
+    AuthorizationData();
+    ~AuthorizationData();
+
+    void readJson(JsonObject entry);
+
+    size_t getJsonCapacity();
+    void writeJson(JsonObject& entry);
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
new file mode 100644
index 00000000..ea49a771
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
@@ -0,0 +1,5 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationList.h>
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
new file mode 100644
index 00000000..e93d5d1b
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
@@ -0,0 +1,37 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef AUTHORIZATIONLIST_H
+#define AUTHORIZATIONLIST_H
+
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationData.h>
+#include <vector>
+
+namespace ArduinoOcpp {
+
+class AuthorizationList {
+private:
+    int localAuthListVersion = -1; //version number if list is LocalAuthorizationList
+    std::vector<std::unique_ptr<AuthorizationData>> authData; //sorted list
+
+    uint16_t updateCnt = 0; //used for temporal order of authData elements
+
+    const size_t MAX_SIZE;
+private:
+    AuthorizationList(size_t MAX_SIZE);
+    ~AuthorizationList();
+
+    void readJson(JsonObject entry);
+
+    size_t getJsonCapacity();
+    void writeJson(JsonObject& entry);
+
+    void update(JsonArray collection);
+    void update(std::unique_ptr<AuthorizationData> entry);
+    void clear();
+};
+
+}
+
+#endif

From 05b476ae0a1c71f8fde27493f2b0e49c450a5c2a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 29 Jan 2023 20:32:11 +0100
Subject: [PATCH 164/549] load List from storage, add SendLocalLists

---
 src/ArduinoOcpp.cpp                           |   3 +
 src/ArduinoOcpp/Core/OcppModel.cpp            |   9 +
 src/ArduinoOcpp/Core/OcppModel.h              |   5 +
 src/ArduinoOcpp/MessagesV16/SendLocalList.cpp |  69 +++++++
 src/ArduinoOcpp/MessagesV16/SendLocalList.h   |  34 ++++
 .../SimpleOcppOperationFactory.cpp            |   3 +
 .../Tasks/Authorization/AuthorizationData.cpp |  86 +++++---
 .../Tasks/Authorization/AuthorizationData.h   |  25 ++-
 .../Tasks/Authorization/AuthorizationList.cpp | 189 ++++++++++++++++++
 .../Tasks/Authorization/AuthorizationList.h   |  30 +--
 .../Authorization/AuthorizationService.cpp    | 114 +++++++++++
 .../Authorization/AuthorizationService.h      |  40 ++++
 12 files changed, 566 insertions(+), 41 deletions(-)
 create mode 100644 src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
 create mode 100644 src/ArduinoOcpp/MessagesV16/SendLocalList.h
 create mode 100644 src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index ff66cd90..94e5eecd 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -13,6 +13,7 @@
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
@@ -105,6 +106,8 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
         new ChargePointStatusService(*ocppEngine, AO_NUMCONNECTORS)));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
         new HeartbeatService(*ocppEngine)));
+    model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
+        new AuthorizationService(*ocppEngine, filesystem)));
 
 #if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/OcppModel.cpp
index 3c7eaee7..2ce306b5 100644
--- a/src/ArduinoOcpp/Core/OcppModel.cpp
+++ b/src/ArduinoOcpp/Core/OcppModel.cpp
@@ -10,6 +10,7 @@
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
 #include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -105,6 +106,14 @@ void OcppModel::setHeartbeatService(std::unique_ptr<HeartbeatService> hs) {
     heartbeatService = std::move(hs);
 }
 
+void OcppModel::setAuthorizationService(std::unique_ptr<AuthorizationService> as) {
+    authorizationService = std::move(as);
+}
+
+AuthorizationService *OcppModel::getAuthorizationService() {
+    return authorizationService.get();
+}
+
 OcppTime& OcppModel::getOcppTime() {
     return ocppTime;
 }
diff --git a/src/ArduinoOcpp/Core/OcppModel.h b/src/ArduinoOcpp/Core/OcppModel.h
index ff9f4439..7c208f21 100644
--- a/src/ArduinoOcpp/Core/OcppModel.h
+++ b/src/ArduinoOcpp/Core/OcppModel.h
@@ -19,6 +19,7 @@ class MeteringService;
 class FirmwareService;
 class DiagnosticsService;
 class HeartbeatService;
+class AuthorizationService;
 
 class OcppModel {
 private:
@@ -29,6 +30,7 @@ class OcppModel {
     std::unique_ptr<FirmwareService> firmwareService;
     std::unique_ptr<DiagnosticsService> diagnosticsService;
     std::unique_ptr<HeartbeatService> heartbeatService;
+    std::unique_ptr<AuthorizationService> authorizationService;
     OcppTime ocppTime;
 
 public:
@@ -60,6 +62,9 @@ class OcppModel {
 
     void setHeartbeatService(std::unique_ptr<HeartbeatService> heartbeatService);
 
+    void setAuthorizationService(std::unique_ptr<AuthorizationService> authorizationService);
+    AuthorizationService *getAuthorizationService();
+
     OcppTime &getOcppTime();
 };
 
diff --git a/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp b/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
new file mode 100644
index 00000000..e367507b
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
@@ -0,0 +1,69 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/MessagesV16/SendLocalList.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+
+using ArduinoOcpp::Ocpp16::SendLocalList;
+
+SendLocalList::SendLocalList() {
+  
+}
+
+SendLocalList::~SendLocalList() {
+  
+}
+
+const char* SendLocalList::getOcppOperationType(){
+    return "SendLocalList";
+}
+
+void SendLocalList::processReq(JsonObject payload) {
+    if (!payload.containsKey("listVersion") || !payload.containsKey("updateType")) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    AuthorizationService *authService;
+
+    if (ocppModel && ocppModel->getAuthorizationService()) {
+        authService = ocppModel->getAuthorizationService();
+    } else {
+        errorCode = "InternalError";
+        return;
+    }
+
+    if (payload["localAuthorizationList"].as<JsonArray>().size() >= AO_SendLocalListMaxLength) {
+        errorCode = "OccurenceConstraintViolation";
+    }
+
+    int listVersion = payload["listVersion"];
+
+    if (authService->getLocalListVersion() >= listVersion) {
+        versionMismatch = true;
+        return;
+    }
+
+    updateFailure = !authService->updateLocalList(payload);
+
+    if (updateFailure) {
+        authService->loadLists();
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> SendLocalList::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+
+    if (versionMismatch) {
+        payload["status"] = "VersionMismatch";
+    } else if (updateFailure) {
+        payload["status"] = "Failed";
+    } else {
+        payload["status"] = "Accepted";
+    }
+    
+    return doc;
+}
diff --git a/src/ArduinoOcpp/MessagesV16/SendLocalList.h b/src/ArduinoOcpp/MessagesV16/SendLocalList.h
new file mode 100644
index 00000000..67852fe1
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/SendLocalList.h
@@ -0,0 +1,34 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef SENDLOCALLIST_H
+#define SENDLOCALLIST_H
+
+#include <ArduinoOcpp/Core/OcppMessage.h>
+
+namespace ArduinoOcpp {
+namespace Ocpp16 {
+
+class SendLocalList : public OcppMessage {
+private:
+    const char *errorCode = nullptr;
+    bool updateFailure = true;
+    bool versionMismatch = false;
+public:
+    SendLocalList();
+
+    ~SendLocalList();
+
+    const char* getOcppOperationType();
+
+    void processReq(JsonObject payload);
+
+    std::unique_ptr<DynamicJsonDocument> createConf();
+
+    const char *getErrorCode() {return errorCode;}
+};
+
+} //end namespace Ocpp16
+} //end namespace ArduinoOcpp
+#endif
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
index 59a62ff1..8a6e67d0 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
@@ -28,6 +28,7 @@
 #include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
 #include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
 #include <ArduinoOcpp/MessagesV16/ClearCache.h>
+#include <ArduinoOcpp/MessagesV16/SendLocalList.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -272,6 +273,8 @@ std::unique_ptr<OcppOperation> makeOcppOperation(const char *messageType, int co
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::ChangeAvailability());
     } else if (!strcmp(messageType, "ClearCache")) {
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::ClearCache());
+    } else if (!strcmp(messageType, "SendLocalList")) {
+        msg = std::unique_ptr<OcppMessage>(new Ocpp16::SendLocalList());
     } else {
         AO_DBG_WARN("Operation not supported");
         msg = std::unique_ptr<OcppMessage>(new NotImplemented());
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
index d21bdce5..b04ddc76 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
@@ -4,47 +4,74 @@
 
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationData.h>
 
-#define AUTHDATA_KEY_IDTAG       "it"
-#define AUTHDATA_KEY_EXPIRYDATE  "ed"
-#define AUTHDATA_KEY_PARENTIDTAG "pi"
-#define AUTHDATA_KEY_STATUS      "st"
-
-using ArduinoOcpp::AuthorizationData;
+using namespace ArduinoOcpp;
 
 AuthorizationData::AuthorizationData() {
 
 }
 
+AuthorizationData::AuthorizationData(AuthorizationData&& other) {
+    operator=(std::move(other));
+}
+
 AuthorizationData::~AuthorizationData() {
 
 }
 
-void AuthorizationData::readJson(JsonObject entry) {
-    if (entry.containsKey(AUTHDATA_KEY_IDTAG)) {
-        strncpy(idTag, entry[AUTHDATA_KEY_IDTAG], IDTAG_LEN_MAX + 1);
+AuthorizationData& AuthorizationData::operator=(AuthorizationData&& other) {
+    parentIdTag = std::move(other.parentIdTag);
+    expiryDate = std::move(other.expiryDate);
+    strncpy(idTag, other.idTag, IDTAG_LEN_MAX + 1);
+    idTag[IDTAG_LEN_MAX] = '\0';
+    status = other.status;
+    return *this;
+}
+
+void AuthorizationData::readJson(JsonObject entry, bool compact) {
+    if (entry.containsKey(AUTHDATA_KEY_IDTAG(compact))) {
+        strncpy(idTag, entry[AUTHDATA_KEY_IDTAG(compact)], IDTAG_LEN_MAX + 1);
         idTag[IDTAG_LEN_MAX] = '\0';
+    } else {
+        idTag[0] = '\0';
+    }
+
+    JsonObject idTagInfo;
+    if (compact){
+        idTagInfo = entry;
+    } else {
+        idTagInfo = entry[AUTHDATA_KEY_IDTAGINFO];
     }
 
-    if (entry.containsKey(AUTHDATA_KEY_EXPIRYDATE)) {
+    if (idTagInfo.containsKey(AUTHDATA_KEY_EXPIRYDATE(compact))) {
         expiryDate = std::unique_ptr<OcppTimestamp>(new OcppTimestamp());
-        if (!expiryDate->setTime(entry[AUTHDATA_KEY_EXPIRYDATE])) {
+        if (!expiryDate->setTime(idTagInfo[AUTHDATA_KEY_EXPIRYDATE(compact)])) {
             expiryDate.reset();
         }
+    } else {
+        expiryDate.reset();
     }
 
-    if (entry.containsKey(AUTHDATA_KEY_PARENTIDTAG)) {
+    if (idTagInfo.containsKey(AUTHDATA_KEY_PARENTIDTAG(compact))) {
         parentIdTag = std::unique_ptr<char[]>(new char[IDTAG_LEN_MAX + 1]);
-        strncpy(parentIdTag.get(), entry[AUTHDATA_KEY_PARENTIDTAG], IDTAG_LEN_MAX + 1);
+        strncpy(parentIdTag.get(), idTagInfo[AUTHDATA_KEY_PARENTIDTAG(compact)], IDTAG_LEN_MAX + 1);
         parentIdTag.get()[IDTAG_LEN_MAX] = '\0';
+    } else {
+        parentIdTag.reset();
     }
 
-    if (entry.containsKey(AUTHDATA_KEY_STATUS)) {
-        status = deserializeAuthorizationStatus(entry[AUTHDATA_KEY_STATUS]);
+    if (idTagInfo.containsKey(AUTHDATA_KEY_STATUS(compact))) {
+        status = deserializeAuthorizationStatus(idTagInfo[AUTHDATA_KEY_STATUS(compact)]);
+    } else {
+        if (compact) {
+            status = AuthorizationStatus::Accepted;
+        } else {
+            status = AuthorizationStatus::UNDEFINED;
+        }
     }
 }
 
-size_t AuthorizationData::getJsonCapacity() {
-    return JSON_OBJECT_SIZE(1) +
+size_t AuthorizationData::getJsonCapacity() const {
+    return JSON_OBJECT_SIZE(2) +
             (idTag[0] != '\0' ? 
                 JSON_OBJECT_SIZE(1) : 0) +
             (expiryDate ?
@@ -55,27 +82,40 @@ size_t AuthorizationData::getJsonCapacity() {
                 JSON_OBJECT_SIZE(1) : 0);
 }
 
-void AuthorizationData::writeJson(JsonObject& entry) {
+void AuthorizationData::writeJson(JsonObject& entry, bool compact) {
     if (idTag[0] != '\0') {
-        entry[AUTHDATA_KEY_IDTAG] = (const char*) idTag;
+        entry[AUTHDATA_KEY_IDTAG(compact)] = (const char*) idTag;
+    }
+
+    JsonObject idTagInfo;
+    if (compact) {
+        idTagInfo = entry;
+    } else {
+        idTagInfo = entry.createNestedObject(AUTHDATA_KEY_IDTAGINFO);
     }
 
     if (expiryDate) {
         char buf [JSONDATE_LENGTH + 1];
         if (expiryDate->toJsonString(buf, JSONDATE_LENGTH + 1)) {
-            entry[AUTHDATA_KEY_EXPIRYDATE] = buf;
+            idTagInfo[AUTHDATA_KEY_EXPIRYDATE(compact)] = buf;
         }
     }
 
     if (parentIdTag) {
-        entry[AUTHDATA_KEY_PARENTIDTAG] = (const char *) parentIdTag.get();
+        idTagInfo[AUTHDATA_KEY_PARENTIDTAG(compact)] = (const char *) parentIdTag.get();
     }
 
-    if (status != AuthorizationStatus::UNDEFINED) {
-        entry[AUTHDATA_KEY_STATUS] = serializeAuthorizationStatus(status);
+    if (status != AuthorizationStatus::Accepted) {
+        idTagInfo[AUTHDATA_KEY_STATUS(compact)] = serializeAuthorizationStatus(status);
+    } else if (!compact) {
+        idTagInfo[AUTHDATA_KEY_STATUS(compact)] = serializeAuthorizationStatus(AuthorizationStatus::Invalid);
     }
 }
 
+void AuthorizationData::reset() {
+    idTag[0] = '\0';
+}
+
 const char *ArduinoOcpp::serializeAuthorizationStatus(AuthorizationStatus status) {
     switch (status) {
         case (AuthorizationStatus::Accepted):
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
index 122a14b8..8828dff1 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
@@ -12,7 +12,7 @@
 
 namespace ArduinoOcpp {
 
-enum class AuthorizationStatus:uint8_t {
+enum class AuthorizationStatus : uint8_t {
     Accepted,
     Blocked,
     Expired,
@@ -21,6 +21,12 @@ enum class AuthorizationStatus:uint8_t {
     UNDEFINED //not part of OCPP 1.6
 };
 
+#define AUTHDATA_KEY_IDTAG(COMPACT)       (COMPACT ? "it" : "idTag")
+#define AUTHDATA_KEY_IDTAGINFO            "idTagInfo"
+#define AUTHDATA_KEY_EXPIRYDATE(COMPACT)  (COMPACT ? "ed" : "expiryDate")
+#define AUTHDATA_KEY_PARENTIDTAG(COMPACT) (COMPACT ? "pi" : "parentIdTag")
+#define AUTHDATA_KEY_STATUS(COMPACT)      (COMPACT ? "st" : "status")
+
 #define AUTHORIZATIONSTATUS_LEN_MAX (sizeof("ConcurrentTx") - 1) //max length of serialized AuthStatus
 
 const char *serializeAuthorizationStatus(AuthorizationStatus status);
@@ -36,15 +42,24 @@ class AuthorizationData {
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
 
     AuthorizationStatus status = AuthorizationStatus::UNDEFINED;
-    uint16_t hist_order;
 public:
     AuthorizationData();
+    AuthorizationData(AuthorizationData&& other);
     ~AuthorizationData();
 
-    void readJson(JsonObject entry);
+    AuthorizationData& operator=(AuthorizationData&& other);
+
+    void readJson(JsonObject entry, bool compact = false); //compact: compressed representation for flash storage
+
+    size_t getJsonCapacity() const;
+    void writeJson(JsonObject& entry, bool compact = false); //compact: compressed representation for flash storage
+
+    const char *getIdTag() const {return idTag;}
+    OcppTimestamp *getExpiryDate() const {return expiryDate.get();}
+    const char *getParentIdTag() const {return parentIdTag.get();}
+    AuthorizationStatus getAuthorizationStatus() const {return status;}
 
-    size_t getJsonCapacity();
-    void writeJson(JsonObject& entry);
+    void reset();
 };
 
 }
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
index ea49a771..ccc19643 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
@@ -3,3 +3,192 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationList.h>
+#include <ArduinoOcpp/Debug.h>
+
+#include <algorithm>
+
+using namespace ArduinoOcpp;
+
+AuthorizationList::AuthorizationList() {
+
+}
+
+AuthorizationList::~AuthorizationList() {
+    
+}
+
+ArduinoOcpp::AuthorizationData *AuthorizationList::get(const char *idTag) {
+    //binary search
+
+    if (!idTag) {
+        return nullptr;
+    }
+
+    int l = 0;
+    int r = ((int) localAuthorizationList.size()) - 1;
+    while (l <= r) {
+        auto m = (r + l) / 2;
+        auto diff = strcmp(localAuthorizationList[m].getIdTag(), idTag);
+        if (diff < 0) {
+            l = m + 1;
+        } else if (diff > 0) {
+            r = m - 1;
+        } else {
+            return &localAuthorizationList[m];
+        }
+    }
+    return nullptr;
+}
+
+bool AuthorizationList::readJson(JsonObject payload, bool compact) {
+
+    bool differential = strcmp("Differential", payload["updateType"] | "Invalid"); //if Json also contains delete commands
+
+    if (compact) {
+        //compact representations don't contain remove commands
+        differential = false;
+    }
+
+    JsonArray collection = payload["localAuthorizationList"];
+
+    for (int i = 0; i < collection.size(); i++) {
+
+        //check if JSON object is valid
+        if (!collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAG(compact))) {
+            return false;
+        }
+    }
+
+    std::vector<int> collection_index;
+    std::vector<int> remove_list;
+
+    unsigned int resultingListLength = 0;
+
+    if (!differential) {
+        //every entry will insert an idTag
+        resultingListLength = collection.size();
+    } else {
+        //update type is differential; only unkown entries will insert an idTag
+
+        resultingListLength = localAuthorizationList.size();
+
+        //also, build index here
+        collection_index = std::vector<int>(collection.size(), -1);
+
+        for (int i = 0; i < collection.size(); i++) {
+
+            //check if locally stored auth info is present; if yes, apply it to the index
+            AuthorizationData *found = get(collection[i][AUTHDATA_KEY_IDTAG(compact)]);
+
+            if (found) {
+
+                collection_index[i] = (int) (found - localAuthorizationList.data());
+
+                //remove or update?
+                if (!collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
+                    //this entry should be removed
+                    found->reset(); //mark for deletion
+                    remove_list.push_back((int) (found - localAuthorizationList.data()));
+                    resultingListLength--;
+                } //else: this entry should be updated
+            } else {
+                //insert or ignore?
+                if (collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
+                    //add
+                    resultingListLength++;
+                } //else: ignore
+            }
+        }
+    }
+
+    if (resultingListLength > AO_LocalAuthListMaxLength) {
+        AO_DBG_WARN("localAuthList capacity exceeded");
+        return false;
+    }
+
+    //apply new list
+    listVersion = payload["listVersion"] | -1;
+
+    if (compact) {
+        localAuthorizationList.clear();
+
+        for (int i = 0; i < collection.size(); i++) {
+            localAuthorizationList.push_back(AuthorizationData());
+            localAuthorizationList.back().readJson(collection[i], compact);
+        }
+    } else if (differential) {
+
+        for (int i = 0; i < collection.size(); i++) {
+
+            //is entry a remove command?
+            if (!collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
+                continue; //yes, remove command, will be deleted afterwards
+            }
+
+            //update, or insert
+
+            if (collection_index[i] < 0) {
+                //auth list does not contain idTag yet -> insert new entry
+
+                //reuse removed AuthData object?
+                if (!remove_list.empty()) {
+                    //yes, reuse
+                    collection_index[i] = remove_list.back();
+                    remove_list.pop_back();
+                } else {
+                    //no, create new
+                    collection_index[i] = localAuthorizationList.size();
+                    localAuthorizationList.push_back(AuthorizationData());
+                }
+            }
+
+            localAuthorizationList[collection_index[i]].readJson(collection[i], compact);
+        }
+
+    } else {
+        localAuthorizationList.clear();
+
+        for (int i = 0; i < collection.size(); i++) {
+            if (collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
+                localAuthorizationList.push_back(AuthorizationData());
+                localAuthorizationList.back().readJson(collection[i], compact);
+            }
+        }
+    }
+
+    localAuthorizationList.erase(std::remove_if(localAuthorizationList.begin(), localAuthorizationList.end(),
+            [] (const AuthorizationData& elem) {
+                return elem.getIdTag()[0] == '\0'; //"" means no idTag --> marked for removal
+            }), localAuthorizationList.end());
+
+    std::sort(localAuthorizationList.begin(), localAuthorizationList.end(),
+            [] (const AuthorizationData& lhs, const AuthorizationData& rhs) {
+                return strcmp(lhs.getIdTag(), rhs.getIdTag()) < 0;
+            });
+    
+    return true;
+}
+
+void AuthorizationList::clear() {
+    localAuthorizationList.clear();
+}
+
+size_t AuthorizationList::getJsonCapacity(bool compact) {
+    return JSON_OBJECT_SIZE(3) +
+           JSON_ARRAY_SIZE(localAuthorizationList.size()) +
+            std::accumulate(localAuthorizationList.begin(), localAuthorizationList.end(), 0,
+                    [] (const int& acc, const AuthorizationData& v) {
+                        return acc + (int) v.getJsonCapacity();
+                    } );
+}
+
+void AuthorizationList::writeJson(JsonObject& payload, bool compact) {
+    payload["listVersion"] = listVersion;
+
+    JsonArray collection = payload.createNestedArray("localAuthorizationList");
+
+    for (auto& entry : localAuthorizationList) {
+        JsonObject entryJson = collection.addElement();
+        entry.writeJson(entryJson, compact);
+    }
+}
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
index e93d5d1b..d8c1f019 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
@@ -8,28 +8,32 @@
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationData.h>
 #include <vector>
 
+#ifndef AO_LocalAuthListMaxLength
+#define AO_LocalAuthListMaxLength 128
+#endif
+
+#define AO_SendLocalListMaxLength AO_LocalAuthListMaxLength
+
 namespace ArduinoOcpp {
 
 class AuthorizationList {
 private:
-    int localAuthListVersion = -1; //version number if list is LocalAuthorizationList
-    std::vector<std::unique_ptr<AuthorizationData>> authData; //sorted list
+    int listVersion = -1;
+    std::vector<AuthorizationData> localAuthorizationList; //sorted list
+public:
+    AuthorizationList();
+    ~AuthorizationList();
 
-    uint16_t updateCnt = 0; //used for temporal order of authData elements
+    AuthorizationData *get(const char *idTag);
 
-    const size_t MAX_SIZE;
-private:
-    AuthorizationList(size_t MAX_SIZE);
-    ~AuthorizationList();
+    bool readJson(JsonObject payload, bool compact = false); //compact: if true, then use compact non-ocpp representation
+    void clear();
 
-    void readJson(JsonObject entry);
+    size_t getJsonCapacity(bool compact = false);
+    void writeJson(JsonObject& entry, bool compact = false);
 
-    size_t getJsonCapacity();
-    void writeJson(JsonObject& entry);
+    int getListVersion() {return listVersion;}
 
-    void update(JsonArray collection);
-    void update(std::unique_ptr<AuthorizationData> entry);
-    void clear();
 };
 
 }
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
new file mode 100644
index 00000000..4d22950b
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -0,0 +1,114 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
+#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Debug.h>
+
+#define AO_LOCALAUTHORIZATIONLIST_FN (AO_FILENAME_PREFIX "/localauth.jsn")
+
+using namespace ArduinoOcpp;
+
+AuthorizationService::AuthorizationService(OcppEngine& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
+    
+    localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", true, CONFIGURATION_FN, true, true, true, false);
+    localAuthListEnabled = declareConfiguration<bool>("LocalAuthListEnabled", true, CONFIGURATION_FN, true, true, true, false);
+    declareConfiguration<int>("LocalAuthListMaxLength", AO_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<int>("SendLocalListMaxLength", AO_SendLocalListMaxLength, CONFIGURATION_VOLATILE, false, true, false, false);
+
+    if (!localAuthorizeOffline || !localAuthListEnabled) {
+        AO_DBG_ERR("initialization error");
+    }
+
+    //append "FirmwareManagement" to FeatureProfiles list
+    const char *fpId = "FirmwareManagement";
+    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
+    if (!strstr(*fProfile, fpId)) {
+        auto fProfilePlus = std::string(*fProfile);
+        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
+            fProfilePlus += ",";
+        fProfilePlus += fpId;
+        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+    }
+
+    loadLists();
+}
+
+AuthorizationService::~AuthorizationService() {
+    
+}
+
+bool AuthorizationService::loadLists() {
+    if (!filesystem) {
+        AO_DBG_WARN("no fs access");
+        return false;
+    }
+    
+    auto doc = FilesystemUtils::loadJson(filesystem, AO_LOCALAUTHORIZATIONLIST_FN);
+    if (!doc) {
+        AO_DBG_ERR("failed to load %s", AO_LOCALAUTHORIZATIONLIST_FN);
+        return false;
+    }
+
+    JsonObject root = doc->as<JsonObject>();
+
+    if (!localAuthorizationList.readJson(root, true)) {
+        AO_DBG_ERR("list read failure");
+        return false;
+    }
+
+    return true;
+}
+
+AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag) {
+    if (!*localAuthorizeOffline) {
+        AO_DBG_DEBUG("skip local auth");
+        return nullptr;
+    }
+
+    if (!*localAuthListEnabled) {
+        AO_DBG_DEBUG("skip local auth list");
+        return nullptr; //auth cache will follow
+    }
+
+    auto authData = localAuthorizationList.get(idTag);
+    if (!authData) {
+        AO_DBG_DEBUG("idTag %s not listed", idTag);
+        return nullptr;
+    }
+
+    //check expiry
+    if (authData->getExpiryDate()) {
+        auto& tnow = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+        if (tnow >= *authData->getExpiryDate()) {
+            AO_DBG_DEBUG("idTag %s local auth entry expired", idTag);
+            return nullptr;
+        }
+    }
+
+    //check status
+    if (authData->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
+        AO_DBG_DEBUG("idTag %s local auth status %s", idTag, serializeAuthorizationStatus(authData->getAuthorizationStatus()));
+        return nullptr;
+    }
+
+    return authData;
+}
+
+bool AuthorizationService::updateLocalList(JsonObject payload) {
+    bool success = localAuthorizationList.readJson(payload);
+
+    if (success) {
+        
+        DynamicJsonDocument doc (localAuthorizationList.getJsonCapacity());
+
+        JsonObject root = doc.to<JsonObject>();
+        localAuthorizationList.writeJson(root, true);
+        success = FilesystemUtils::storeJson(filesystem, AO_LOCALAUTHORIZATIONLIST_FN, doc);
+    }
+
+    return success;
+}
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h
new file mode 100644
index 00000000..f9e5b387
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h
@@ -0,0 +1,40 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef AUTHORIZATIONSERVICE_H
+#define AUTHORIZATIONSERVICE_H
+
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationList.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+
+namespace ArduinoOcpp {
+
+class OcppEngine;
+
+class AuthorizationService {
+private:
+    OcppEngine& context;
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    AuthorizationList localAuthorizationList;
+
+    std::shared_ptr<Configuration<bool>> localAuthorizeOffline;
+    std::shared_ptr<Configuration<bool>> localAuthListEnabled;
+
+public:
+    AuthorizationService(OcppEngine& context, std::shared_ptr<FilesystemAdapter> filesystem);
+    ~AuthorizationService();
+
+    bool loadLists();
+
+    AuthorizationData *getLocalAuthorization(const char *idTag);
+
+    int getLocalListVersion() {return localAuthorizationList.getListVersion();}
+
+    bool updateLocalList(JsonObject payload);
+};
+
+}
+
+#endif

From 3139b0d7d22554ef9a7988f842aaae097c33252e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 29 Jan 2023 20:48:40 +0100
Subject: [PATCH 165/549] fix compilation errors

---
 CMakeLists.txt                                            | 4 ++++
 src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp | 3 ++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index e7f6f8de..2b418efd 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -39,6 +39,7 @@ set(AO_SRC
     src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
     src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
     src/ArduinoOcpp/MessagesV16/Reset.cpp
+    src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
     src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
     src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
     src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -48,6 +49,9 @@ set(AO_SRC
     src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
     src/ArduinoOcpp/Platform.cpp
     src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+    src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
+    src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
+    src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
     src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
     src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
     src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
index ccc19643..32890117 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
@@ -6,6 +6,7 @@
 #include <ArduinoOcpp/Debug.h>
 
 #include <algorithm>
+#include <numeric>
 
 using namespace ArduinoOcpp;
 
@@ -188,7 +189,7 @@ void AuthorizationList::writeJson(JsonObject& payload, bool compact) {
     JsonArray collection = payload.createNestedArray("localAuthorizationList");
 
     for (auto& entry : localAuthorizationList) {
-        JsonObject entryJson = collection.addElement();
+        JsonObject entryJson = collection.createNestedObject();
         entry.writeJson(entryJson, compact);
     }
 }

From 4478365a74ecde19a5438e503649b94b5ec5ba61 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 29 Jan 2023 22:06:38 +0100
Subject: [PATCH 166/549] fix updateType field for list updates

---
 src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
index 32890117..c857370e 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
@@ -43,7 +43,7 @@ ArduinoOcpp::AuthorizationData *AuthorizationList::get(const char *idTag) {
 
 bool AuthorizationList::readJson(JsonObject payload, bool compact) {
 
-    bool differential = strcmp("Differential", payload["updateType"] | "Invalid"); //if Json also contains delete commands
+    bool differential = !strcmp("Differential", payload["updateType"] | "Invalid"); //if Json also contains delete commands
 
     if (compact) {
         //compact representations don't contain remove commands

From 2752a341d65b8b5020969e5c9b3cd9333526e0ea Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 30 Jan 2023 11:21:42 +0100
Subject: [PATCH 167/549] add last transmission timestamp in WS adapter

---
 src/ArduinoOcpp/Core/OcppSocket.cpp | 14 ++++++++++++--
 src/ArduinoOcpp/Core/OcppSocket.h   |  3 +++
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppSocket.cpp b/src/ArduinoOcpp/Core/OcppSocket.cpp
index f7468aca..223261a9 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.cpp
+++ b/src/ArduinoOcpp/Core/OcppSocket.cpp
@@ -25,16 +25,20 @@ bool OcppClientSocket::sendTXT(std::string &out) {
 }
 
 void OcppClientSocket::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
-    wsock->onEvent([callback](WStype_t type, uint8_t * payload, size_t length) {
+    auto& captureLastRecv = lastRecv;
+    wsock->onEvent([callback, &captureLastRecv](WStype_t type, uint8_t * payload, size_t length) {
         switch (type) {
             case WStype_DISCONNECTED:
                 AO_DBG_INFO("Disconnected");
                 break;
             case WStype_CONNECTED:
                 AO_DBG_INFO("Connected to url: %s", payload);
+                captureLastRecv = ao_tick_ms();
                 break;
             case WStype_TEXT:
-                if (!callback((const char *) payload, length)) { //forward message to OcppEngine
+                if (callback((const char *) payload, length)) { //forward message to OcppEngine
+                    captureLastRecv = ao_tick_ms();
+                } else {
                     AO_DBG_WARN("Processing WebSocket input event failed");
                 }
                 break;
@@ -44,10 +48,12 @@ void OcppClientSocket::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
             case WStype_PING:
                 // pong will be send automatically
                 AO_DBG_TRAFFIC_IN(8, "WS ping");
+                captureLastRecv = ao_tick_ms();
                 break;
             case WStype_PONG:
                 // answer to a ping we send
                 AO_DBG_TRAFFIC_IN(8, "WS pong");
+                captureLastRecv = ao_tick_ms();
                 break;
             case WStype_FRAGMENT_TEXT_START: //fragments are not supported
             default:
@@ -57,6 +63,10 @@ void OcppClientSocket::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
     });
 }
 
+unsigned long OcppClientSocket::getLastRecv() {
+    return lastRecv;
+}
+
 OcppServerSocket::OcppServerSocket(IPAddress &ip_addr) : ip_addr(ip_addr) {
     
 }
diff --git a/src/ArduinoOcpp/Core/OcppSocket.h b/src/ArduinoOcpp/Core/OcppSocket.h
index bb8c534a..959fa4bb 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.h
+++ b/src/ArduinoOcpp/Core/OcppSocket.h
@@ -63,6 +63,7 @@ namespace EspWiFi {
 class OcppClientSocket : public OcppSocket {
 private:
     WebSocketsClient *wsock;
+    unsigned long lastRecv = 0;
 public:
     OcppClientSocket(WebSocketsClient *wsock);
 
@@ -71,6 +72,8 @@ class OcppClientSocket : public OcppSocket {
     bool sendTXT(std::string &out);
 
     void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT);
+
+    unsigned long getLastRecv(); //get time of last successful receive in millis
 };
 
 class OcppServerSocket : public OcppSocket {

From 0e6bdc633d3358deadeb47725ef06230d0c910ca Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 30 Jan 2023 17:19:00 +0100
Subject: [PATCH 168/549] reset listVersion to 0 if local auth list is empty

---
 src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp | 7 ++++++-
 src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h   | 2 +-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
index c857370e..d0c0473f 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
@@ -108,7 +108,6 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
     }
 
     //apply new list
-    listVersion = payload["listVersion"] | -1;
 
     if (compact) {
         localAuthorizationList.clear();
@@ -167,6 +166,12 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
                 return strcmp(lhs.getIdTag(), rhs.getIdTag()) < 0;
             });
     
+    listVersion = payload["listVersion"] | 0;
+    
+    if (localAuthorizationList.empty()) {
+        listVersion = 0;
+    }
+
     return true;
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
index d8c1f019..957536ff 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
@@ -18,7 +18,7 @@ namespace ArduinoOcpp {
 
 class AuthorizationList {
 private:
-    int listVersion = -1;
+    int listVersion = 0;
     std::vector<AuthorizationData> localAuthorizationList; //sorted list
 public:
     AuthorizationList();

From f2ba08fcad77698b4a2559d90fd74ba85f8e7d99 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 30 Jan 2023 18:04:02 +0100
Subject: [PATCH 169/549] add GetLocalListVersion

---
 CMakeLists.txt                                |  1 +
 .../MessagesV16/GetLocalListVersion.cpp       | 33 +++++++++++++++++++
 .../MessagesV16/GetLocalListVersion.h         | 26 +++++++++++++++
 .../SimpleOcppOperationFactory.cpp            |  3 ++
 4 files changed, 63 insertions(+)
 create mode 100644 src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
 create mode 100644 src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 2b418efd..3d5476ba 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -34,6 +34,7 @@ set(AO_SRC
     src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
     src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
     src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
+    src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
     src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
     src/ArduinoOcpp/MessagesV16/MeterValues.cpp
     src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
new file mode 100644
index 00000000..527261bc
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
@@ -0,0 +1,33 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/MessagesV16/GetLocalListVersion.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Debug.h>
+
+using ArduinoOcpp::Ocpp16::GetLocalListVersion;
+
+GetLocalListVersion::GetLocalListVersion() {
+  
+}
+
+const char* GetLocalListVersion::getOcppOperationType(){
+    return "GetLocalListVersion";
+}
+
+void GetLocalListVersion::processReq(JsonObject payload) {
+    //empty payload
+}
+
+std::unique_ptr<DynamicJsonDocument> GetLocalListVersion::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+    if (ocppModel && ocppModel->getAuthorizationService()) {
+        payload["listVersion"] = ocppModel->getAuthorizationService()->getLocalListVersion();
+    } else {
+        payload["listVersion"] = -1;
+    }
+    return doc;
+}
diff --git a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h
new file mode 100644
index 00000000..f750cf36
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h
@@ -0,0 +1,26 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef GETLOCALLISTVERSION_H
+#define GETLOCALLISTVERSION_H
+
+#include <ArduinoOcpp/Core/OcppMessage.h>
+
+namespace ArduinoOcpp {
+namespace Ocpp16 {
+
+class GetLocalListVersion : public OcppMessage {
+public:
+    GetLocalListVersion();
+
+    const char* getOcppOperationType();
+
+    void processReq(JsonObject payload);
+
+    std::unique_ptr<DynamicJsonDocument> createConf();
+};
+
+} //end namespace Ocpp16
+} //end namespace ArduinoOcpp
+#endif
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
index 8a6e67d0..f55ccae9 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
@@ -29,6 +29,7 @@
 #include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
 #include <ArduinoOcpp/MessagesV16/ClearCache.h>
 #include <ArduinoOcpp/MessagesV16/SendLocalList.h>
+#include <ArduinoOcpp/MessagesV16/GetLocalListVersion.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -275,6 +276,8 @@ std::unique_ptr<OcppOperation> makeOcppOperation(const char *messageType, int co
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::ClearCache());
     } else if (!strcmp(messageType, "SendLocalList")) {
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::SendLocalList());
+    } else if (!strcmp(messageType, "GetLocalListVersion")) {
+        msg = std::unique_ptr<OcppMessage>(new Ocpp16::GetLocalListVersion());
     } else {
         AO_DBG_WARN("Operation not supported");
         msg = std::unique_ptr<OcppMessage>(new NotImplemented());

From 1b5c98dc2d2d56a38ca23ddd463fbc75b58c604e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 30 Jan 2023 21:48:36 +0100
Subject: [PATCH 170/549] check for LocalListConflict, bug fixes

---
 src/ArduinoOcpp/MessagesV16/Authorize.cpp     | 10 ++-
 src/ArduinoOcpp/MessagesV16/SendLocalList.cpp |  6 +-
 .../MessagesV16/StartTransaction.cpp          |  7 +-
 .../MessagesV16/StatusNotification.cpp        | 11 ++-
 .../MessagesV16/StopTransaction.cpp           |  7 +-
 .../Tasks/Authorization/AuthorizationList.h   |  2 +-
 .../Authorization/AuthorizationService.cpp    | 86 +++++++++++++++++--
 .../Authorization/AuthorizationService.h      |  2 +
 8 files changed, 108 insertions(+), 23 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.cpp b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
index 4227f4ff..d7c62672 100644
--- a/src/ArduinoOcpp/MessagesV16/Authorize.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
@@ -1,9 +1,10 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/Authorize.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 
 #include <ArduinoOcpp/Debug.h>
@@ -39,12 +40,13 @@ void Authorize::processConf(JsonObject payload){
 
     if (!strcmp(idTagInfo, "Accepted")) {
         AO_DBG_INFO("Request has been accepted");
-
-        //TODO add entry in offline auth cache
-    
     } else {
         AO_DBG_INFO("Request has been denied. Reason: %s", idTagInfo);
     }
+
+    if (ocppModel && ocppModel->getAuthorizationService()) {
+        ocppModel->getAuthorizationService()->notifyAuthorization(idTag, payload["idTagInfo"]);
+    }
 }
 
 void Authorize::processReq(JsonObject payload){
diff --git a/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp b/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
index e367507b..9fef9a67 100644
--- a/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
+++ b/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
@@ -35,7 +35,7 @@ void SendLocalList::processReq(JsonObject payload) {
         return;
     }
 
-    if (payload["localAuthorizationList"].as<JsonArray>().size() >= AO_SendLocalListMaxLength) {
+    if (payload["localAuthorizationList"].as<JsonArray>().size() > AO_SendLocalListMaxLength) {
         errorCode = "OccurenceConstraintViolation";
     }
 
@@ -47,10 +47,6 @@ void SendLocalList::processReq(JsonObject payload) {
     }
 
     updateFailure = !authService->updateLocalList(payload);
-
-    if (updateFailure) {
-        authService->loadLists();
-    }
 }
 
 std::unique_ptr<DynamicJsonDocument> SendLocalList::createConf(){
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 31d25888..9041251c 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -1,10 +1,11 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
@@ -153,6 +154,10 @@ void StartTransaction::processConf(JsonObject payload) {
 
     transaction->getStartRpcSync().confirm();
     transaction->commit();
+
+    if (ocppModel && ocppModel->getAuthorizationService()) {
+        ocppModel->getAuthorizationService()->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
+    }
 }
 
 void StartTransaction::processReq(JsonObject payload) {
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index 9c405a33..37670539 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
@@ -72,16 +72,15 @@ void StatusNotification::initiate() {
             }
         }
         auto connector = cpsService->getConnector(connectorId);
-        if (connector) {
+        if (connector && currentStatus == OcppEvseState::NOT_SET) {
             currentStatus = connector->inferenceStatus();
         }
     }
     
-    if (ocppModel) {
+    if (ocppModel && otimestamp == MIN_TIME) {
         otimestamp = ocppModel->getOcppTime().getOcppTimestampNow();
-    } else {
-        otimestamp = MIN_TIME;
     }
+
     if (currentStatus == OcppEvseState::NOT_SET) {
         AO_DBG_ERR("Could not determine EVSE status");
     }
@@ -119,7 +118,7 @@ void StatusNotification::processConf(JsonObject payload) {
 }
 
 StatusNotification::StatusNotification(int connectorId) : connectorId(connectorId) {
-    
+    otimestamp = MIN_TIME;
 }
 
 /*
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 7204f752..d34691cd 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -1,10 +1,11 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
@@ -185,6 +186,10 @@ void StopTransaction::processConf(JsonObject payload) {
     }
 
     AO_DBG_INFO("Request has been accepted!");
+
+    if (ocppModel && ocppModel->getAuthorizationService()) {
+        ocppModel->getAuthorizationService()->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
+    }
 }
 
 bool StopTransaction::processErr(const char *code, const char *description, JsonObject details) {
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
index 957536ff..1e300914 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
@@ -9,7 +9,7 @@
 #include <vector>
 
 #ifndef AO_LocalAuthListMaxLength
-#define AO_LocalAuthListMaxLength 128
+#define AO_LocalAuthListMaxLength 48
 #endif
 
 #define AO_SendLocalListMaxLength AO_LocalAuthListMaxLength
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index 4d22950b..9845d9a9 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -6,6 +6,9 @@
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
+#include <ArduinoOcpp/Core/OcppOperationTimeout.h>
+#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Debug.h>
 
 #define AO_LOCALAUTHORIZATIONLIST_FN (AO_FILENAME_PREFIX "/localauth.jsn")
@@ -23,8 +26,8 @@ AuthorizationService::AuthorizationService(OcppEngine& context, std::shared_ptr<
         AO_DBG_ERR("initialization error");
     }
 
-    //append "FirmwareManagement" to FeatureProfiles list
-    const char *fpId = "FirmwareManagement";
+    //append "LocalAuthListManagement" to FeatureProfiles list
+    const char *fpId = "LocalAuthListManagement";
     auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
     if (!strstr(*fProfile, fpId)) {
         auto fProfilePlus = std::string(*fProfile);
@@ -65,18 +68,15 @@ bool AuthorizationService::loadLists() {
 
 AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag) {
     if (!*localAuthorizeOffline) {
-        AO_DBG_DEBUG("skip local auth");
         return nullptr;
     }
 
     if (!*localAuthListEnabled) {
-        AO_DBG_DEBUG("skip local auth list");
         return nullptr; //auth cache will follow
     }
 
     auto authData = localAuthorizationList.get(idTag);
     if (!authData) {
-        AO_DBG_DEBUG("idTag %s not listed", idTag);
         return nullptr;
     }
 
@@ -108,7 +108,83 @@ bool AuthorizationService::updateLocalList(JsonObject payload) {
         JsonObject root = doc.to<JsonObject>();
         localAuthorizationList.writeJson(root, true);
         success = FilesystemUtils::storeJson(filesystem, AO_LOCALAUTHORIZATIONLIST_FN, doc);
+
+        if (!success) {
+            loadLists();
+        }
     }
 
     return success;
 }
+
+void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idTagInfo) {
+    //check local list conflicts. In future: also update authorization cache
+
+    if (!*localAuthorizeOffline) {
+        return;
+    }
+
+    if (!*localAuthListEnabled) {
+        return; //auth cache will follow
+    }
+
+    if (!idTagInfo.containsKey("status")) {
+        return; //empty idTagInfo
+    }
+
+    auto localInfo = localAuthorizationList.get(idTag);
+    if (!localInfo) {
+        return;
+    }
+
+    //check for conflicts
+
+    auto incomingStatus = deserializeAuthorizationStatus(idTagInfo["status"]);
+    auto localStatus = localInfo->getAuthorizationStatus();
+
+    if (incomingStatus == AuthorizationStatus::UNDEFINED) { //ignore invalid messages (handled elsewhere)
+        return;
+    }
+
+    if (incomingStatus == AuthorizationStatus::ConcurrentTx) { //incoming status ConcurrentTx is equivalent to local Accepted
+        incomingStatus = AuthorizationStatus::Accepted;
+    }
+
+    if (localStatus == AuthorizationStatus::Accepted && localInfo->getExpiryDate()) { //check for expiry
+        auto& t_now = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+        if (t_now > *localInfo->getExpiryDate()) {
+            AO_DBG_DEBUG("local auth expired");
+            localStatus = AuthorizationStatus::Expired;
+        }
+    }
+
+    bool equivalent = true;
+
+    if (incomingStatus != localStatus) {
+        AO_DBG_WARN("local auth list status conflict");
+        equivalent = false;
+    }
+
+    //check if parentIdTag definitions mismatch
+    if (equivalent &&
+            strcmp(localInfo->getParentIdTag() ? localInfo->getParentIdTag() : "", idTagInfo["parentIdTag"] | "")) {
+        AO_DBG_WARN("local auth list parentIdTag conflict");
+        equivalent = false;
+    }
+
+    AO_DBG_DEBUG("idTag %s fully evaluated: %s conflict", idTag, equivalent ? "no" : "contains");
+
+    if (!equivalent) {
+        //send error code "LocalListConflict" to server
+
+        auto statusNotification = makeOcppOperation(new Ocpp16::StatusNotification(
+                    0,
+                    OcppEvseState::NOT_SET, //will be determined in StatusNotification::initiate
+                    context.getOcppModel().getOcppTime().getOcppTimestampNow(),
+                    "LocalListConflict"));
+
+        statusNotification->setTimeout(std::unique_ptr<Timeout>(new FixedTimeout(60000)));
+
+        context.initiateOperation(std::move(statusNotification));
+    }
+}
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h
index f9e5b387..3d5e3cc0 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h
@@ -33,6 +33,8 @@ class AuthorizationService {
     int getLocalListVersion() {return localAuthorizationList.getListVersion();}
 
     bool updateLocalList(JsonObject payload);
+
+    void notifyAuthorization(const char *idTag, JsonObject idTagInfo);
 };
 
 }

From adac6bdcef20a89d414b5780703bcc65ac8402e2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 30 Jan 2023 21:53:05 +0100
Subject: [PATCH 171/549] add Local auth list to supported feature profiles

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 56b2ca58..1fed90dc 100644
--- a/README.md
+++ b/README.md
@@ -63,6 +63,7 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 | **Smart charging** | :heavy_check_mark: |
 | **Remote trigger** | :heavy_check_mark: |
 | **Firmware management** | :heavy_check_mark: |
+| **Local auth list management** | :heavy_check_mark: |
 
 ## Further help
 

From dcc1de6af772c4bf7e76bbc4891afe3079596b67 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 12 Feb 2023 14:40:12 +0100
Subject: [PATCH 172/549] add reservation functions

---
 src/ArduinoOcpp.cpp                           |   5 +-
 src/ArduinoOcpp/Core/OcppModel.cpp            |  11 +-
 src/ArduinoOcpp/Core/OcppModel.h              |   7 +-
 .../MessagesV16/CancelReservation.cpp         |  45 +++++
 .../MessagesV16/CancelReservation.h           |  32 ++++
 src/ArduinoOcpp/MessagesV16/ReserveNow.cpp    | 108 ++++++++++++
 src/ArduinoOcpp/MessagesV16/ReserveNow.h      |  34 ++++
 .../SimpleOcppOperationFactory.cpp            |   8 +-
 .../Tasks/Reservation/Reservation.cpp         | 116 +++++++++++++
 .../Tasks/Reservation/Reservation.h           |  47 ++++++
 .../Tasks/Reservation/ReservationService.cpp  | 157 ++++++++++++++++++
 .../Tasks/Reservation/ReservationService.h    |  43 +++++
 12 files changed, 609 insertions(+), 4 deletions(-)
 create mode 100644 src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
 create mode 100644 src/ArduinoOcpp/MessagesV16/CancelReservation.h
 create mode 100644 src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
 create mode 100644 src/ArduinoOcpp/MessagesV16/ReserveNow.h
 create mode 100644 src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Reservation/Reservation.h
 create mode 100644 src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Reservation/ReservationService.h

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 94e5eecd..e7330de2 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include "ArduinoOcpp.h"
@@ -14,6 +14,7 @@
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
@@ -108,6 +109,8 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
         new HeartbeatService(*ocppEngine)));
     model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
         new AuthorizationService(*ocppEngine, filesystem)));
+    model.setReservationService(std::unique_ptr<ReservationService>(
+        new ReservationService(*ocppEngine, AO_NUMCONNECTORS)));
 
 #if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/OcppModel.cpp
index 2ce306b5..5dfe577e 100644
--- a/src/ArduinoOcpp/Core/OcppModel.cpp
+++ b/src/ArduinoOcpp/Core/OcppModel.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppModel.h>
@@ -11,6 +11,7 @@
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
 #include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -114,6 +115,14 @@ AuthorizationService *OcppModel::getAuthorizationService() {
     return authorizationService.get();
 }
 
+void OcppModel::setReservationService(std::unique_ptr<ReservationService> rs) {
+    reservationService = std::move(rs);
+}
+
+ReservationService *OcppModel::getReservationService() {
+    return reservationService.get();
+}
+
 OcppTime& OcppModel::getOcppTime() {
     return ocppTime;
 }
diff --git a/src/ArduinoOcpp/Core/OcppModel.h b/src/ArduinoOcpp/Core/OcppModel.h
index 7c208f21..8c26df4b 100644
--- a/src/ArduinoOcpp/Core/OcppModel.h
+++ b/src/ArduinoOcpp/Core/OcppModel.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPPMODEL_H
@@ -20,6 +20,7 @@ class FirmwareService;
 class DiagnosticsService;
 class HeartbeatService;
 class AuthorizationService;
+class ReservationService;
 
 class OcppModel {
 private:
@@ -31,6 +32,7 @@ class OcppModel {
     std::unique_ptr<DiagnosticsService> diagnosticsService;
     std::unique_ptr<HeartbeatService> heartbeatService;
     std::unique_ptr<AuthorizationService> authorizationService;
+    std::unique_ptr<ReservationService> reservationService;
     OcppTime ocppTime;
 
 public:
@@ -65,6 +67,9 @@ class OcppModel {
     void setAuthorizationService(std::unique_ptr<AuthorizationService> authorizationService);
     AuthorizationService *getAuthorizationService();
 
+    void setReservationService(std::unique_ptr<ReservationService> reservationService);
+    ReservationService *getReservationService();
+
     OcppTime &getOcppTime();
 };
 
diff --git a/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp b/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
new file mode 100644
index 00000000..6c79381d
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
@@ -0,0 +1,45 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/MessagesV16/CancelReservation.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Debug.h>
+
+using ArduinoOcpp::Ocpp16::CancelReservation;
+
+CancelReservation::CancelReservation() {
+  
+}
+
+const char* CancelReservation::getOcppOperationType(){
+    return "CancelReservation";
+}
+
+void CancelReservation::processReq(JsonObject payload) {
+    if (!payload.containsKey("reservationId")) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    if (ocppModel && ocppModel->getReservationService()) {
+        if (auto reservation = ocppModel->getReservationService()->getReservationById(payload["reservationId"])) {
+            found = true;
+            reservation->clear();
+        }
+    } else {
+        errorCode = "InternalError";
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> CancelReservation::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+    if (found) {
+        payload["status"] = "Accepted";
+    } else {
+        payload["status"] = "Rejected";
+    }
+    return doc;
+}
diff --git a/src/ArduinoOcpp/MessagesV16/CancelReservation.h b/src/ArduinoOcpp/MessagesV16/CancelReservation.h
new file mode 100644
index 00000000..125a837b
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/CancelReservation.h
@@ -0,0 +1,32 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef CANCELRESERVATION_H
+#define CANCELRESERVATION_H
+
+#include <ArduinoOcpp/Core/OcppMessage.h>
+
+namespace ArduinoOcpp {
+namespace Ocpp16 {
+
+class CancelReservation : public OcppMessage {
+private:
+    bool found = false;
+    const char *errorCode = nullptr;
+public:
+    CancelReservation();
+
+    const char* getOcppOperationType();
+
+    void processReq(JsonObject payload);
+
+    std::unique_ptr<DynamicJsonDocument> createConf();
+
+    const char *getErrorCode() {return errorCode;}
+};
+
+} //end namespace Ocpp16
+} //end namespace ArduinoOcpp
+
+#endif
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
new file mode 100644
index 00000000..a1555910
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
@@ -0,0 +1,108 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/MessagesV16/ReserveNow.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Platform.h>
+
+using ArduinoOcpp::Ocpp16::ReserveNow;
+
+ReserveNow::ReserveNow() {
+  
+}
+
+ReserveNow::~ReserveNow() {
+  
+}
+
+const char* ReserveNow::getOcppOperationType(){
+    return "ReserveNow";
+}
+
+void ReserveNow::processReq(JsonObject payload) {
+    if (!payload.containsKey("connectorId") ||
+            payload["connectorId"] < 0 ||
+            !payload.containsKey("expiryDate") ||
+            !payload.containsKey("idTag") ||
+            //parentIdTag is optional
+            !payload.containsKey("reservationId")) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    OcppTimestamp validateTimestamp;
+    if (!validateTimestamp.setTime(payload["expiryDate"])) {
+        AO_DBG_WARN("bad time format");
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
+
+    int connectorId = payload["connectorId"];
+
+    ReservationService *rService = nullptr;
+    ChargePointStatusService *cpService = nullptr;
+    if (ocppModel && ocppModel->getReservationService() &&
+                ocppModel->getChargePointStatusService() && cpService->getConnector(0)) {
+        rService = ocppModel->getReservationService();
+        cpService = ocppModel->getChargePointStatusService();
+        ConnectorStatus *chargePoint = cpService->getConnector(0);
+
+        if (connectorId >= cpService->getNumConnectors()) {
+            errorCode = "PropertyConstraintViolation";
+            return;
+        }
+
+        if (auto reservation = rService->getReservationById(payload["reservationId"])) {
+            reservation->update(payload);
+            reservationStatus = "Accepted";
+        }
+
+        ConnectorStatus *connector = nullptr;
+        
+        if (connectorId > 0) {
+            connector = cpService->getConnector(connectorId);
+        }
+
+        if (chargePoint->inferenceStatus() == OcppEvseState::Faulted ||
+                (connector && connector->inferenceStatus() == OcppEvseState::Faulted)) {
+            reservationStatus = "Faulted";
+            return;
+        }
+
+        if (chargePoint->getAvailability() != AVAILABILITY_OPERATIVE ||
+                (connector && connector->getAvailability() == AVAILABILITY_INOPERATIVE)) {
+            reservationStatus = "Unavailable";
+            return;
+        }
+
+        if (connector && connector->inferenceStatus() != OcppEvseState::Available) {
+            reservationStatus = "Occupied";
+            return;
+        }
+
+        if (rService->updateReservation(payload)) {
+            reservationStatus = "Accepted";
+        } else {
+            reservationStatus = "Occupied";
+        }
+    } else {
+        errorCode = "InternalError";
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> ReserveNow::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+
+    if (reservationStatus) {
+        payload["status"] = reservationStatus;
+    } else {
+        AO_DBG_ERR("didn't set reservationStatus");
+        payload["status"] = "Rejected";
+    }
+    
+    return doc;
+}
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.h b/src/ArduinoOcpp/MessagesV16/ReserveNow.h
new file mode 100644
index 00000000..c8a2e8b5
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.h
@@ -0,0 +1,34 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef RESERVENOW_H
+#define RESERVENOW_H
+
+#include <ArduinoOcpp/Core/OcppMessage.h>
+
+namespace ArduinoOcpp {
+namespace Ocpp16 {
+
+class ReserveNow : public OcppMessage {
+private:
+    const char *errorCode = nullptr;
+    const char *reservationStatus = nullptr;
+public:
+    ReserveNow();
+
+    ~ReserveNow();
+
+    const char* getOcppOperationType();
+
+    void processReq(JsonObject payload);
+
+    std::unique_ptr<DynamicJsonDocument> createConf();
+
+    const char *getErrorCode() {return errorCode;}
+};
+
+} //end namespace Ocpp16
+} //end namespace ArduinoOcpp
+
+#endif
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
index f55ccae9..4c302e04 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
@@ -30,6 +30,8 @@
 #include <ArduinoOcpp/MessagesV16/ClearCache.h>
 #include <ArduinoOcpp/MessagesV16/SendLocalList.h>
 #include <ArduinoOcpp/MessagesV16/GetLocalListVersion.h>
+#include <ArduinoOcpp/MessagesV16/ReserveNow.h>
+#include <ArduinoOcpp/MessagesV16/CancelReservation.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -278,6 +280,10 @@ std::unique_ptr<OcppOperation> makeOcppOperation(const char *messageType, int co
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::SendLocalList());
     } else if (!strcmp(messageType, "GetLocalListVersion")) {
         msg = std::unique_ptr<OcppMessage>(new Ocpp16::GetLocalListVersion());
+    } else if (!strcmp(messageType, "ReserveNow")) {
+        msg = std::unique_ptr<OcppMessage>(new Ocpp16::ReserveNow());
+    } else if (!strcmp(messageType, "CancelReservation")) {
+        msg = std::unique_ptr<OcppMessage>(new Ocpp16::CancelReservation());
     } else {
         AO_DBG_WARN("Operation not supported");
         msg = std::unique_ptr<OcppMessage>(new NotImplemented());
diff --git a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
new file mode 100644
index 00000000..2b4808fa
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
@@ -0,0 +1,116 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Reservation/Reservation.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Debug.h>
+
+#ifndef RESERVATION_FN
+#define RESERVATION_FN (AO_FILENAME_PREFIX "/resrv.jsn")
+#endif
+
+using namespace ArduinoOcpp;
+
+Reservation::Reservation(OcppModel& context, unsigned int slot) : context(context), slot(slot) {
+    const size_t KEY_SIZE = 50;
+    char key [KEY_SIZE] = {'\0'};
+
+    snprintf(key, KEY_SIZE, "cid_%u", slot);
+    connectorId = declareConfiguration<int>(key, -1, RESERVATION_FN, false, false, true, false);
+
+    snprintf(key, KEY_SIZE, "expdt_%u", slot);
+    expiryDateRaw = declareConfiguration<const char*>(key, "", RESERVATION_FN, false, false, true, false);
+    expiryDate.setTime(*expiryDateRaw);
+    
+    snprintf(key, KEY_SIZE, "idt_%u", slot);
+    idTag = declareConfiguration<const char*>(key, "", RESERVATION_FN, false, false, true, false);
+
+    snprintf(key, KEY_SIZE, "rsvid_%u", slot);
+    reservationId = declareConfiguration<int>(key, -1, RESERVATION_FN, false, false, true, false);
+
+    snprintf(key, KEY_SIZE, "pidt_%u", slot);
+    parentIdTag = declareConfiguration<const char*>(key, "", RESERVATION_FN, false, false, true, false);
+
+    if (!connectorId || !expiryDateRaw || !idTag || !reservationId || !parentIdTag) {
+        AO_DBG_ERR("initialization failure");
+        (void)0;
+    }
+}
+
+bool Reservation::isActive() {
+    if (*connectorId < 0) {
+        //reservation invalidated
+        return false;
+    }
+
+    auto& t_now = context.getOcppTime().getOcppTimestampNow();
+    if (t_now > expiryDate) {
+        //reservation expired
+        return false;
+    }
+
+    return true;
+}
+
+bool Reservation::matches(unsigned int connectorId) {
+    return (int) connectorId == *this->connectorId;
+}
+
+bool Reservation::matches(const char *idTag, const char *parentIdTag) {
+    if (idTag == nullptr && parentIdTag == nullptr) {
+        return true;
+    }
+
+    if (idTag && !strcmp(idTag, *this->idTag)) {
+        return true;
+    }
+
+    if (parentIdTag && !strcmp(parentIdTag, *this->parentIdTag)) {
+        return true;
+    }
+
+    return false;
+}
+
+int Reservation::getConnectorId() {
+    return *connectorId;
+}
+
+OcppTimestamp& Reservation::getExpiryDate() {
+    return expiryDate;
+}
+
+const char *Reservation::getIdTag() {
+    return *idTag;
+}
+
+int Reservation::getReservationId() {
+    return *reservationId;
+}
+
+const char *Reservation::getParentIdTag() {
+    return parentIdTag->getBuffsize() <= 1 ? (const char *) nullptr : *parentIdTag;
+}
+
+void Reservation::update(JsonObject payload) {
+    *connectorId = payload["connectorId"] | -1;
+    expiryDate.setTime(payload["expiryDate"]);
+    *expiryDateRaw = payload["expiryDate"].as<const char*>();
+    *idTag = payload["idTag"].as<const char*>();
+    *reservationId = payload["reservationId"] | -1;
+    *parentIdTag = payload["parentIdTag"] | "";
+
+    configuration_save();
+}
+
+void Reservation::clear() {
+    *connectorId = -1;
+    expiryDate = MIN_TIME;
+    *expiryDateRaw = "";
+    *idTag = "";
+    *reservationId = -1;
+    *parentIdTag = "";
+
+    configuration_save();
+}
diff --git a/src/ArduinoOcpp/Tasks/Reservation/Reservation.h b/src/ArduinoOcpp/Tasks/Reservation/Reservation.h
new file mode 100644
index 00000000..d5a5e13f
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Reservation/Reservation.h
@@ -0,0 +1,47 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef RESERVATION_H
+#define RESERVATION_H
+
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Core/OcppTime.h>
+
+namespace ArduinoOcpp {
+
+class OcppModel;
+
+class Reservation {
+private:
+    OcppModel& context;
+    const unsigned int slot;
+
+    std::shared_ptr<Configuration<int>> connectorId;
+    std::shared_ptr<Configuration<const char *>> expiryDateRaw;
+    OcppTimestamp expiryDate;
+    std::shared_ptr<Configuration<const char *>> idTag;
+    std::shared_ptr<Configuration<int>> reservationId;
+    std::shared_ptr<Configuration<const char *>> parentIdTag;
+
+public:
+    Reservation(OcppModel& context, unsigned int slot);
+
+    bool isActive(); //if this object contains a valid, unexpired reservation
+
+    bool matches(unsigned int connectorId);
+    bool matches(const char *idTag, const char *parentIdTag = nullptr); //idTag == parentIdTag == nullptr -> return True
+
+    int getConnectorId();
+    OcppTimestamp& getExpiryDate();
+    const char *getIdTag();
+    int getReservationId();
+    const char *getParentIdTag();
+
+    void update(JsonObject payload);
+    void clear();
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
new file mode 100644
index 00000000..5c99894b
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -0,0 +1,157 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+
+#include <ArduinoOcpp/Debug.h>
+
+using namespace ArduinoOcpp;
+
+ReservationService::ReservationService(OcppEngine& context, unsigned int numConnectors) : context(context), maxReservations((int) numConnectors - 1) {
+    if (maxReservations > 0) {
+        reservations.reserve((size_t) maxReservations);
+        for (int i = 0; i < maxReservations; i++) {
+            reservations.push_back(Reservation(context.getOcppModel(), i));
+        }
+    }
+
+    //append "Reservation" to FeatureProfiles list
+    const char *fpId = "Reservation";
+    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
+    if (!strstr(*fProfile, fpId)) {
+        auto fProfilePlus = std::string(*fProfile);
+        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
+            fProfilePlus += ",";
+        fProfilePlus += fpId;
+        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+    }
+}
+
+Reservation *ReservationService::getReservation(unsigned int connectorId) {
+    for (Reservation& reservation : reservations) {
+        if (reservation.isActive() && reservation.matches(connectorId)) {
+            return &reservation;
+        }
+    }
+}
+
+Reservation *ReservationService::getReservation(const char *idTag, const char *parentIdTag) {
+    if (idTag == nullptr) {
+        AO_DBG_ERR("invalid input");
+        return nullptr;
+    }
+
+    Reservation *connectorReservation = nullptr;
+
+    for (Reservation& reservation : reservations) {
+        if (!reservation.isActive()) {
+            continue;
+        }
+
+        //TODO check for parentIdTag
+
+        if (reservation.matches(idTag, parentIdTag)) {
+            if (reservation.getConnectorId() == 0) {
+                return &reservation; //reservation at connectorId 0 has higher priority
+            } else {
+                connectorReservation = &reservation;
+            }
+        }
+    }
+
+    return connectorReservation;
+}
+
+Reservation *ReservationService::getReservation(unsigned int connectorId, const char *idTag, const char *parentIdTag) {
+
+    //is connector blocked by a reservation?
+    if (auto reservation = getReservation(connectorId)) {
+        //connector has reservation -> will always be the prevailing reservation
+        return reservation;
+    }
+
+    //is there any reservation at this charge point for idTag?
+    if (auto reservation = getReservation(idTag, parentIdTag)) {
+        //yes, can use reservation with different connectorId
+        return reservation;
+    }
+
+    if (reserveConnectorZeroSupported && !*reserveConnectorZeroSupported) {
+        //no connectorZero check - all done
+        AO_DBG_DEBUG("no reservation");
+        return nullptr;
+    }
+
+    //connectorZero check
+    Reservation *blockingReservation = nullptr; //any reservation which blocks this connector now
+
+    //Check if there are enough free connectors to satisfy all reservations at connectorId 0
+    unsigned int unspecifiedReservations = 0;
+    for (Reservation& ires : reservations) {
+        if (ires.isActive() && ires.getConnectorId() == 0) {
+            unspecifiedReservations++;
+            blockingReservation = &ires;
+        }
+    }
+
+    unsigned int availableCount = 0;
+    if (auto cpService = context.getOcppModel().getChargePointStatusService()) {
+        for (unsigned int iconn = 1; cpService->getNumConnectors(); iconn++) {
+            if (iconn == connectorId) {
+                //don't count this connector
+                continue;
+            }
+            if (auto connector = cpService->getConnector(iconn)) {
+                if (connector->inferenceStatus() == OcppEvseState::Available) {
+                    availableCount++;
+                }
+            }
+        }
+    }
+
+    if (availableCount >= unspecifiedReservations) {
+        //enough other connectors available to satisfy all reservations
+        return nullptr;
+    } else {
+        //not sufficient connectors for all reservations after this action
+        return blockingReservation;
+    }
+}
+
+Reservation *ReservationService::getReservationById(int reservationId) {
+    for (Reservation& reservation : reservations) {
+        if (reservation.isActive() && reservation.getReservationId() == reservationId) {
+            return &reservation;
+        }
+    }
+}
+
+bool ReservationService::updateReservation(JsonObject payload) {
+    if (auto reservation = getReservationById(payload["reservationId"])) {
+        reservation->update(payload);
+        return true;
+    }
+
+    if (getReservation(
+                payload["connectorId"],
+                payload["idTag"],
+                payload.containsKey("parentIdTag") ? payload["parentIdTag"] : nullptr)) {
+        AO_DBG_DEBUG("found blocking reservation");
+        return false;
+    }
+
+    //update free reservation slot
+    for (Reservation& reservation : reservations) {
+        if (!reservation.isActive()) {
+            reservation.update(payload);
+            return true;
+        }
+    }
+
+    AO_DBG_ERR("error finding blocking reservation");
+    return false;
+}
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h
new file mode 100644
index 00000000..00116a4e
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h
@@ -0,0 +1,43 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef RESERVATIONSERVICE_H
+#define RESERVATIONSERVICE_H
+
+#include <ArduinoOcpp/Tasks/Reservation/Reservation.h>
+
+namespace ArduinoOcpp {
+
+class OcppEngine;
+
+class ReservationService {
+private:
+    OcppEngine& context;
+
+    const int maxReservations; // = number of physical connectors
+    std::vector<Reservation> reservations;
+
+    std::shared_ptr<Configuration<bool>> reserveConnectorZeroSupported;
+
+public:
+    ReservationService(OcppEngine& context, unsigned int numConnectors);
+
+    Reservation *getReservation(unsigned int connectorId); //by connectorId
+    Reservation *getReservation(const char *idTag, const char *parentIdTag = nullptr); //by idTag
+
+    /*
+     * Get prevailing reservation for a charging session authorized by idTag/parentIdTag at connectorId.
+     * returns nullptr if there is no reservation in question
+     * returns a reservation if applicable. Caller must check if idTag/parentIdTag match before starting a transaction
+     */
+    Reservation *getReservation(unsigned int connectorId, const char *idTag, const char *parentIdtag = nullptr);
+
+    Reservation *getReservationById(int reservationId);
+
+    bool updateReservation(JsonObject payload);
+};
+
+}
+
+#endif

From 1d02ad9959ecfbc6228c837fcb130c70d58c9084 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 12 Feb 2023 14:45:23 +0100
Subject: [PATCH 173/549] updated CMakeLists

---
 CMakeLists.txt | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 3d5476ba..56776895 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -24,6 +24,7 @@ set(AO_SRC
     src/ArduinoOcpp/Core/OperationStore.cpp
     src/ArduinoOcpp/MessagesV16/Authorize.cpp
     src/ArduinoOcpp/MessagesV16/BootNotification.cpp
+    src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
     src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
     src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
     src/ArduinoOcpp/MessagesV16/ClearCache.cpp
@@ -39,6 +40,7 @@ set(AO_SRC
     src/ArduinoOcpp/MessagesV16/MeterValues.cpp
     src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
     src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
+    src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
     src/ArduinoOcpp/MessagesV16/Reset.cpp
     src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
     src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
@@ -63,6 +65,8 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
     src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
     src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
+    src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
+    src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
     src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp

From da8ad1aa92978c3c36d1ee3fdb1b2de5bb271ee4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 12 Feb 2023 16:15:10 +0100
Subject: [PATCH 174/549] bug fixes

---
 src/ArduinoOcpp/MessagesV16/ReserveNow.cpp               | 2 +-
 src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
index a1555910..c6b82876 100644
--- a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
@@ -45,7 +45,7 @@ void ReserveNow::processReq(JsonObject payload) {
     ReservationService *rService = nullptr;
     ChargePointStatusService *cpService = nullptr;
     if (ocppModel && ocppModel->getReservationService() &&
-                ocppModel->getChargePointStatusService() && cpService->getConnector(0)) {
+                ocppModel->getChargePointStatusService() && ocppModel->getChargePointStatusService()->getConnector(0)) {
         rService = ocppModel->getReservationService();
         cpService = ocppModel->getChargePointStatusService();
         ConnectorStatus *chargePoint = cpService->getConnector(0);
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index 5c99894b..7e9ac0fa 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -37,6 +37,8 @@ Reservation *ReservationService::getReservation(unsigned int connectorId) {
             return &reservation;
         }
     }
+    
+    return nullptr;
 }
 
 Reservation *ReservationService::getReservation(const char *idTag, const char *parentIdTag) {
@@ -100,7 +102,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
 
     unsigned int availableCount = 0;
     if (auto cpService = context.getOcppModel().getChargePointStatusService()) {
-        for (unsigned int iconn = 1; cpService->getNumConnectors(); iconn++) {
+        for (unsigned int iconn = 1; iconn < cpService->getNumConnectors(); iconn++) {
             if (iconn == connectorId) {
                 //don't count this connector
                 continue;
@@ -128,6 +130,8 @@ Reservation *ReservationService::getReservationById(int reservationId) {
             return &reservation;
         }
     }
+
+    return nullptr;
 }
 
 bool ReservationService::updateReservation(JsonObject payload) {

From 0bcad698d5097c4625fc5f0a842f4151d127cb4d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 12 Feb 2023 22:00:51 +0100
Subject: [PATCH 175/549] add reservationId to StartTransaction

---
 src/ArduinoOcpp/MessagesV16/StartTransaction.cpp    |  6 +++++-
 .../Tasks/ChargePointStatus/ConnectorStatus.cpp     | 13 ++++++++++++-
 src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp  | 10 +++++++++-
 src/ArduinoOcpp/Tasks/Transactions/Transaction.h    |  6 +++++-
 4 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 9041251c..46c211f1 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -114,7 +114,7 @@ bool StartTransaction::restore(StoredOperationHandler *opStore) {
 std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
 
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                JSON_OBJECT_SIZE(5) + 
+                JSON_OBJECT_SIZE(6) + 
                 (IDTAG_LEN_MAX + 1) +
                 (JSONDATE_LENGTH + 1)));
                 
@@ -130,6 +130,10 @@ std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
         payload["meterStart"] = transaction->getMeterStart();
     }
 
+    if (transaction->getReservationId() >= 0) {
+        payload["reservationId"] = transaction->getReservationId();
+    }
+
     if (transaction->getStartTimestamp() > MIN_TIME) {
         char timestamp[JSONDATE_LENGTH + 1] = {'\0'};
         transaction->getStartTimestamp().toJsonString(timestamp, JSONDATE_LENGTH + 1);
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 64106d23..623f9465 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h>
@@ -17,6 +17,7 @@
 #include <ArduinoOcpp/Debug.h>
 
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
+#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
@@ -110,6 +111,8 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
             return OcppEvseState::SuspendedEV;
         }
         return OcppEvseState::Charging;
+    } else if (context.getReservationService() && context.getReservationService()->getReservation(connectorId)) {
+        return OcppEvseState::Reserved;
     } else if (!txProcess.existsActiveTrigger() && txProcess.getState() == TxEnableState::Inactive) {
         return OcppEvseState::Available;
     } else {
@@ -486,6 +489,14 @@ void ConnectorStatus::beginSession(const char *sessionIdTag) {
 
     transaction->setSessionTimestamp(context.getOcppTime().getOcppTimestampNow());
 
+    if (context.getReservationService()) {
+        if (auto reservation = context.getReservationService()->getReservation(connectorId, sessionIdTag, nullptr)) { //TODO set parentIdTag
+            if (reservation->matches(sessionIdTag, nullptr)) { //TODO set parentIdTag
+                transaction->setReservationId(reservation->getReservationId());
+            }
+        }
+    }
+
     transaction->commit();
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index 247444fe..4d435953 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
@@ -54,6 +54,10 @@ bool Transaction::serializeSessionState(DynamicJsonDocument& out) {
         txStartClientSide["meter"] = start.client.meter;
     }
 
+    if (start.client.reservationId >= 0) {
+        txStartClientSide["reservationId"] = start.client.reservationId;
+    }
+
 
     if (start.rpc.confirmed) {
         JsonObject txStartServerSide = txStart.createNestedObject("server");
@@ -149,6 +153,10 @@ bool Transaction::deserializeSessionState(JsonObject state) {
         start.client.meter = txStartClientSide["meter"] | 0;
     }
 
+    if (txStartClientSide.containsKey("reservationId")) {
+        start.client.reservationId = txStartClientSide["reservationId"] | -1;
+    }
+
     if (start.rpc.confirmed) {
         JsonObject txStartServerSide = txStart["server"];
         start.server.transactionId = txStartServerSide["transactionId"] | -1;
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index ea1c2da4..abd6e682 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef TRANSACTION_H
@@ -46,6 +46,7 @@ class ClientTransactionStart {
 
     OcppTimestamp timestamp = MIN_TIME;      //timestamp of StartTx; can be set before actually initiating
     int32_t meter = -1;           //meterStart of StartTx
+    int reservationId = -1;
 };
 
 class ServerTransactionStart {
@@ -159,6 +160,9 @@ class Transaction {
     bool isMeterStartDefined() {return start.client.meter >= 0;} //should introduce extra variable later
     int32_t getMeterStart() {return start.client.meter;}
 
+    void setReservationId(int reservationId) {start.client.reservationId = reservationId;}
+    int getReservationId() {return start.client.reservationId;}
+
     void setStartTimestamp(OcppTimestamp timestamp) {start.client.timestamp = timestamp;}
     OcppTimestamp& getStartTimestamp() {return start.client.timestamp;}
 

From 5a0b4dbfa1f4a2fc1c4e8168a268f9a0cc5c2e39 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 12 Feb 2023 22:02:30 +0100
Subject: [PATCH 176/549] reservation expiration conditions

---
 src/ArduinoOcpp/Core/OcppModel.cpp            |  3 ++
 .../Tasks/Reservation/ReservationService.cpp  | 44 +++++++++++++++++++
 .../Tasks/Reservation/ReservationService.h    |  2 +
 3 files changed, 49 insertions(+)

diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/OcppModel.cpp
index 5dfe577e..095f8a13 100644
--- a/src/ArduinoOcpp/Core/OcppModel.cpp
+++ b/src/ArduinoOcpp/Core/OcppModel.cpp
@@ -42,6 +42,9 @@ void OcppModel::loop() {
     
     if (firmwareService)
         firmwareService->loop();
+    
+    if (reservationService)
+        reservationService->loop();
 }
 
 void OcppModel::setTransactionStore(std::unique_ptr<TransactionStore> ts) {
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index 7e9ac0fa..bacaded7 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -31,6 +31,50 @@ ReservationService::ReservationService(OcppEngine& context, unsigned int numConn
     }
 }
 
+void ReservationService::loop() {
+    //check if to end reservations
+    auto cpService = context.getOcppModel().getChargePointStatusService();
+    if (!cpService) {
+        return;
+    }
+
+    for (Reservation& reservation : reservations) {
+        if (!reservation.isActive()) {
+            continue;
+        }
+
+        if (auto connector = context.getOcppModel().getConnectorStatus(reservation.getConnectorId())) {
+
+            //check if connector went inoperative
+            auto cStatus = connector->inferenceStatus();
+            if (cStatus == OcppEvseState::Faulted || cStatus == OcppEvseState::Unavailable) {
+                reservation.clear();
+                continue;
+            }
+
+            //check if other tx started at this connector (e.g. due to RemoteStartTransaction)
+            if (connector->getSessionIdTag()) {
+                reservation.clear();
+                continue;
+            }
+        }
+
+        //check if tx with same idTag or reservationId has started
+        for (unsigned int cId = 1; cId < cpService->getNumConnectors(); cId++) {
+            auto& transaction = cpService->getConnector(cId)->getTransaction();
+            if (transaction) {
+                const char *cIdTag = transaction->getIdTag();
+                if (transaction->getReservationId() == reservation.getReservationId() || 
+                        (cIdTag && !strcmp(cIdTag, reservation.getIdTag()))) {
+                    
+                    reservation.clear();
+                    break;
+                }
+            }
+        }
+    }
+}
+
 Reservation *ReservationService::getReservation(unsigned int connectorId) {
     for (Reservation& reservation : reservations) {
         if (reservation.isActive() && reservation.matches(connectorId)) {
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h
index 00116a4e..d19a8003 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h
@@ -23,6 +23,8 @@ class ReservationService {
 public:
     ReservationService(OcppEngine& context, unsigned int numConnectors);
 
+    void loop();
+
     Reservation *getReservation(unsigned int connectorId); //by connectorId
     Reservation *getReservation(const char *idTag, const char *parentIdTag = nullptr); //by idTag
 

From 6c23c066d1e72cd6cb0d5a094c177a0b23b308fc Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 12 Feb 2023 22:03:25 +0100
Subject: [PATCH 177/549] Reservation at connectorId 0 fixes

---
 src/ArduinoOcpp/MessagesV16/ReserveNow.cpp    |  7 +++++
 .../Tasks/Reservation/Reservation.cpp         |  2 +-
 .../Tasks/Reservation/ReservationService.cpp  | 28 +++++++++++++------
 3 files changed, 28 insertions(+), 9 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
index c6b82876..901f4e2d 100644
--- a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
@@ -55,9 +55,16 @@ void ReserveNow::processReq(JsonObject payload) {
             return;
         }
 
+        auto reserveConnectorZeroSupported = declareConfiguration<bool>("ReserveConnectorZeroSupported", true, CONFIGURATION_VOLATILE);
+        if (connectorId == 0 && (!reserveConnectorZeroSupported || !*reserveConnectorZeroSupported)) {
+            reservationStatus = "Rejected";
+            return;
+        }
+
         if (auto reservation = rService->getReservationById(payload["reservationId"])) {
             reservation->update(payload);
             reservationStatus = "Accepted";
+            return;
         }
 
         ConnectorStatus *connector = nullptr;
diff --git a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
index 2b4808fa..dd25c4d9 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
@@ -7,7 +7,7 @@
 #include <ArduinoOcpp/Debug.h>
 
 #ifndef RESERVATION_FN
-#define RESERVATION_FN (AO_FILENAME_PREFIX "/resrv.jsn")
+#define RESERVATION_FN (AO_FILENAME_PREFIX "/reservations.jsn")
 #endif
 
 using namespace ArduinoOcpp;
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index bacaded7..dc10aea0 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -6,6 +6,7 @@
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -19,6 +20,8 @@ ReservationService::ReservationService(OcppEngine& context, unsigned int numConn
         }
     }
 
+    reserveConnectorZeroSupported = declareConfiguration<bool>("ReserveConnectorZeroSupported", true, CONFIGURATION_VOLATILE, false, true, false, false);
+
     //append "Reservation" to FeatureProfiles list
     const char *fpId = "Reservation";
     auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
@@ -76,6 +79,11 @@ void ReservationService::loop() {
 }
 
 Reservation *ReservationService::getReservation(unsigned int connectorId) {
+    if (connectorId == 0) {
+        AO_DBG_DEBUG("tried to fetch connectorId 0");
+        return nullptr; //cannot fetch for connectorId 0 because multiple reservations are possible at a time
+    }
+
     for (Reservation& reservation : reservations) {
         if (reservation.isActive() && reservation.matches(connectorId)) {
             return &reservation;
@@ -121,9 +129,11 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
     }
 
     //is there any reservation at this charge point for idTag?
-    if (auto reservation = getReservation(idTag, parentIdTag)) {
-        //yes, can use reservation with different connectorId
-        return reservation;
+    if (idTag) {
+        if (auto reservation = getReservation(idTag, parentIdTag)) {
+            //yes, can use reservation with different connectorId
+            return reservation;
+        }
     }
 
     if (reserveConnectorZeroSupported && !*reserveConnectorZeroSupported) {
@@ -184,11 +194,13 @@ bool ReservationService::updateReservation(JsonObject payload) {
         return true;
     }
 
-    if (getReservation(
-                payload["connectorId"],
-                payload["idTag"],
-                payload.containsKey("parentIdTag") ? payload["parentIdTag"] : nullptr)) {
-        AO_DBG_DEBUG("found blocking reservation");
+// Alternative condition: avoids that one idTag can make two reservations at a time. The specification doesn't
+// mention that double-reservations should be possible but it seems to mean it. 
+    if (auto reservation = getReservation(payload["connectorId"], nullptr, nullptr)) {
+//                payload["idTag"],
+//                payload.containsKey("parentIdTag") ? payload["parentIdTag"] : nullptr)) {
+//    if (auto reservation = getReservation(payload["connectorId"].as<int>())) {
+        AO_DBG_DEBUG("found blocking reservation at connectorId %u", reservation->getConnectorId());
         return false;
     }
 

From b4cbc461873c055f5f956b194366eeca9b5258d9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 12 Feb 2023 22:03:52 +0100
Subject: [PATCH 178/549] add Reservation to facade

---
 README.md           |  1 +
 src/ArduinoOcpp.cpp | 21 +++++++++++++++++++++
 src/ArduinoOcpp.h   |  4 +++-
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1fed90dc..6706e4dd 100644
--- a/README.md
+++ b/README.md
@@ -64,6 +64,7 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 | **Remote trigger** | :heavy_check_mark: |
 | **Firmware management** | :heavy_check_mark: |
 | **Local auth list management** | :heavy_check_mark: |
+| **Reservation** | :heavy_check_mark: |
 
 ## Further help
 
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index e7330de2..1d122f6b 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -567,6 +567,27 @@ const char *getTransactionIdTag(unsigned int connectorId) {
     return connector->getSessionIdTag();
 }
 
+bool isBlockedByReservation(const char *idTag, unsigned int connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_WARN("Please call OCPP_initialize before");
+        return false;
+    }
+    if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
+        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        return false;
+    }
+    auto rService = ocppEngine->getOcppModel().getReservationService();
+    if (!rService) {
+        AO_DBG_ERR("Could not access reservations. Ignore");
+        return false;
+    }
+    if (auto reservation = rService->getReservation(connectorId, idTag)) {
+        return !reservation->matches(idTag);
+    }
+
+    return false; //no reservation -> nothing blocked
+}
+
 #if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
 ArduinoOcpp::FirmwareService *getFirmwareService() {
     auto& model = ocppEngine->getOcppModel();
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index e0039efe..9b8ae5aa 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef ARDUINOOCPP_H
@@ -261,6 +261,8 @@ int getTransactionId(unsigned int connectorId = 1); //returns the txId if known,
 
 const char *getTransactionIdTag(unsigned int connectorId = 1); //returns the authorization token if applicable, or nullptr otherwise
 
+bool isBlockedByReservation(const char *idTag, unsigned int connectorId = 1); //if the connector is already reserved for a different idTag
+
 void setOnResetRequest(OnReceiveReqListener onReceiveReq);
 
 /*

From 12fff6ccb0770c789b2ee7ee2a92f9369448229c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 12 Feb 2023 22:06:22 +0100
Subject: [PATCH 179/549] add Reservation to C-facade

---
 src/ArduinoOcpp_c.cpp | 7 +++++++
 src/ArduinoOcpp_c.h   | 3 +++
 2 files changed, 10 insertions(+)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index ee4b9a38..4c33a9ac 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -329,6 +329,13 @@ const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
     return getTransactionIdTag(connectorId);
 }
 
+bool ao_isBlockedByReservation(const char *idTag) {
+    return isBlockedByReservation(idTag);
+}
+bool ao_isBlockedByReservation_m(unsigned int connectorId, const char *idTag) {
+    return isBlockedByReservation(idTag, connectorId);
+}
+
 void ao_setOnResetRequest(OnOcppMessage onRequest) {
     setOnResetRequest(adaptFn(onRequest));
 }
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index fc7dbc64..2b0b305b 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -144,6 +144,9 @@ int ao_getTransactionId_m(unsigned int connectorId);
 const char *ao_getTransactionIdTag();
 const char *ao_getTransactionIdTag_m(unsigned int connectorId);
 
+bool ao_isBlockedByReservation(const char *idTag);
+bool ao_isBlockedByReservation_m(unsigned int connectorId, const char *idTag);
+
 void ao_setOnResetRequest(OnOcppMessage onRequest);
 
 /*

From 9090c3ce3f2f7b74603cd8e7ed44610775516222 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 14 Feb 2023 20:58:30 +0100
Subject: [PATCH 180/549] do not remove config file before rewrite

---
 src/ArduinoOcpp/Core/FilesystemUtils.cpp | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
index 8ed689f8..ccfdbdb7 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -90,11 +90,6 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
         return false;
     }
 
-    size_t file_size = 0;
-    if (filesystem->stat(fn, &file_size) == 0) {
-        filesystem->remove(fn);
-    }
-
     auto file = filesystem->open(fn, "w");
     if (!file) {
         AO_DBG_ERR("Could not open file %s", fn);
@@ -107,6 +102,7 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
 
     if (written < 2) {
         AO_DBG_ERR("Error writing file %s", fn);
+        size_t file_size = 0;
         if (filesystem->stat(fn, &file_size) == 0) {
             AO_DBG_DEBUG("Collect invalid file %s", fn);
             filesystem->remove(fn);

From 3381a5240726b4be97b6e978f34fc46d63b7a823 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 14 Feb 2023 21:00:49 +0100
Subject: [PATCH 181/549] heap optimization for config store

---
 .../Core/ConfigurationContainerFlash.cpp      | 121 +++++-------------
 .../Core/ConfigurationKeyValue.cpp            |   9 +-
 src/ArduinoOcpp/Core/FilesystemUtils.cpp      |  23 ++--
 src/ArduinoOcpp/Core/FilesystemUtils.h        |   6 +-
 4 files changed, 51 insertions(+), 108 deletions(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index d8717c13..e0397f9a 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/ConfigurationContainerFlash.h>
@@ -8,9 +8,7 @@
 
 #include <algorithm>
 
-#define MAX_FILE_SIZE 4000
 #define MAX_CONFIGURATIONS 50
-#define MAX_CONFJSON_CAPACITY 4000
 
 namespace ArduinoOcpp {
 
@@ -33,45 +31,15 @@ bool ConfigurationContainerFlash::load() {
         return save();
     }
 
-    if (file_size > MAX_FILE_SIZE) {
-        AO_DBG_ERR("Unable to initialize: filesize is too long");
+    auto doc = FilesystemUtils::loadJson(filesystem, getFilename());
+    if (!doc) {
+        AO_DBG_ERR("failed to load %s", getFilename());
         return false;
     }
 
-    auto file = filesystem->open(getFilename(), "r");
+    JsonObject root = doc->as<JsonObject>();
 
-    if (!file) {
-        AO_DBG_ERR("Unable to initialize: could not open configuration file %s", getFilename());
-        return false;
-    }
-
-    auto jsonCapacity = std::max(file_size, (size_t) 256);
-    DynamicJsonDocument doc {0};
-    DeserializationError err = DeserializationError::NoMemory;
-
-    while (err == DeserializationError::NoMemory) {
-        if (jsonCapacity > MAX_CONFJSON_CAPACITY) {
-            AO_DBG_ERR("JSON capacity exceeded");
-            return false;
-        }
-
-        AO_DBG_DEBUG("Configs JSON capacity: %zu", jsonCapacity);
-
-        doc = DynamicJsonDocument(jsonCapacity);
-        ArduinoJsonFileAdapter file_adapt {file.get()};
-        err = deserializeJson(doc, file_adapt);
-
-        jsonCapacity *= 3;
-        jsonCapacity /= 2;
-        file->seek(0);
-    }
-
-    if (err) {
-        AO_DBG_ERR("Unable to initialize: config file deserialization failed: %s", err.c_str());
-        return false;
-    }
-
-    JsonObject configHeader = doc["head"];
+    JsonObject configHeader = root["head"];
 
     if (strcmp(configHeader["content-type"] | "Invalid", "ao_configuration_file")) {
         AO_DBG_ERR("Unable to initialize: unrecognized configuration file format");
@@ -83,7 +51,7 @@ bool ConfigurationContainerFlash::load() {
         return false;
     }
     
-    JsonArray configurationsArray = doc["configurations"];
+    JsonArray configurationsArray = root["configurations"];
     if (configurationsArray.size() > MAX_CONFIGURATIONS) {
         AO_DBG_ERR("Unable to initialize: configurations_len is too big (=%zu)", configurationsArray.size());
         return false;
@@ -127,17 +95,6 @@ bool ConfigurationContainerFlash::save() {
         return true; //nothing to be done
     }
 
-    size_t file_size = 0;
-    if (filesystem->stat(getFilename(), &file_size) == 0) {
-        filesystem->remove(getFilename());
-    }
-
-    auto file = filesystem->open(getFilename(), "w");
-    if (!file) {
-        AO_DBG_ERR("Unable to save: could not open configuration file %s", getFilename());
-        return false;
-    }
-
     size_t jsonCapacity = 2 * JSON_OBJECT_SIZE(2); //head + configurations + head payload
 
     std::vector<std::shared_ptr<DynamicJsonDocument>> entries;
@@ -145,57 +102,39 @@ bool ConfigurationContainerFlash::save() {
     for (auto config = configurations.begin(); config != configurations.end(); config++) {
         std::shared_ptr<DynamicJsonDocument> entry = (*config)->toJsonStorageEntry();
         if (entry) {
-            entries.push_back(entry);
-        }
-        if (entries.size() >= MAX_CONFIGURATIONS) {
-            AO_DBG_ERR("Max No of configratuions exceeded. Crop configs file (by FCFS)");
-            break;
-        }
-    }
-
-    jsonCapacity += JSON_ARRAY_SIZE(entries.size()); //length of configurations
-    for (auto entry = entries.begin(); entry != entries.end(); entry++) {
-        jsonCapacity += (*entry)->capacity();
-    }
+            size_t capacity = entry->memoryUsage(); //entry payload size
 
-    jsonCapacity = std::max(jsonCapacity, (size_t) 256);
-    DynamicJsonDocument doc {0};
-    bool jsonDocOverflow = true;
+            if (jsonCapacity + capacity + JSON_ARRAY_SIZE(entries.size() + 1)  > AO_MAX_JSON_CAPACITY) {
+                AO_DBG_ERR("configs JSON exceeds maximum capacity (%s, %zu entries). Crop configs file (by FCFS)", getFilename(), entries.size());
+                break;
+            }
 
-    while (jsonDocOverflow) {
-        if (jsonCapacity > MAX_CONFJSON_CAPACITY) {
-            AO_DBG_ERR("JSON capacity exceeded");
-            return false;
+            entries.push_back(entry);
+            jsonCapacity += capacity;
         }
+    }
 
-        file->seek(0);
-
-        doc = DynamicJsonDocument(jsonCapacity);
-        JsonObject head = doc.createNestedObject("head");
-        head["content-type"] = "ao_configuration_file";
-        head["version"] = "1.1";
+    jsonCapacity += JSON_ARRAY_SIZE(entries.size());
 
-        JsonArray configurationsArray = doc.createNestedArray("configurations");
-        for (auto entry = entries.begin(); entry != entries.end(); entry++) {
-            configurationsArray.add((*entry)->as<JsonObject>());
-        }
+    DynamicJsonDocument doc {jsonCapacity};
+    JsonObject head = doc.createNestedObject("head");
+    head["content-type"] = "ao_configuration_file";
+    head["version"] = "1.1";
 
-        ArduinoJsonFileAdapter file_adapt {file.get()};
-        size_t written = serializeJson(doc, file_adapt);
+    JsonArray configurationsArray = doc.createNestedArray("configurations");
+    for (auto entry = entries.begin(); entry != entries.end(); entry++) {
+        configurationsArray.add((*entry)->as<JsonObject>());
+    }
 
-        jsonCapacity *= 3;
-        jsonCapacity /= 2;
-        jsonDocOverflow = doc.overflowed();
+    bool success = FilesystemUtils::storeJson(filesystem, getFilename(), doc);
 
-        if (!jsonDocOverflow && written < 20) { //plausibility check
-            AO_DBG_ERR("Config serialization: unkown error for file %s", getFilename());
-            return false;
-        }
+    if (success) {
+        AO_DBG_DEBUG("Saving configurations finished");
+    } else {
+        AO_DBG_ERR("could not save configs file: %", getFilename());
     }
 
-    //success
-    AO_DBG_DEBUG("Saving configurations finished");
-    return true;
+    return success;
 }
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index acbebab2..d305ab0c 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
@@ -34,8 +34,7 @@ void AbstractConfiguration::printKey() {
 }
 
 size_t AbstractConfiguration::getStorageHeaderJsonCapacity() {
-    return JSON_OBJECT_SIZE(1) //key
-            + key.size() + 1;
+    return key.length() + 1;
 }
 
 void AbstractConfiguration::storeStorageHeader(JsonObject &keyValuePair) {
@@ -161,11 +160,11 @@ bool Configuration<T>::isValid() {
 
 template<class T>
 size_t Configuration<T>::getValueJsonCapacity() {
-    return JSON_OBJECT_SIZE(1);
+    return 0;
 }
 
 size_t Configuration<const char *>::getValueJsonCapacity() {
-    return JSON_OBJECT_SIZE(1) + value.size() + 1;
+    return value.size() + 1;
 }
 
 template<class T>
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
index ccfdbdb7..8c3dfa9e 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
@@ -7,8 +7,6 @@
 #include <ArduinoOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
 #include <ArduinoOcpp/Debug.h>
 
-#define MAX_JSON_CAPACITY 4096
-
 using namespace ArduinoOcpp;
 
 std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn) {
@@ -40,25 +38,28 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
         return nullptr;
     }
 
-    size_t capacity = (3 * fsize) / 2;
-    if (capacity < 32) {
-        capacity = 32;
+    size_t capacity_init = (3 * fsize) / 2;
+
+    //capacity = ceil capacity_init to the next power of two; should be at least 128
+
+    size_t capacity = 128;
+    while (capacity < capacity_init && capacity < AO_MAX_JSON_CAPACITY) {
+        capacity *= 2;
     }
-    if (capacity > MAX_JSON_CAPACITY) {
-        capacity = MAX_JSON_CAPACITY;
+    if (capacity > AO_MAX_JSON_CAPACITY) {
+        capacity = AO_MAX_JSON_CAPACITY;
     }
     
     auto doc = std::unique_ptr<DynamicJsonDocument>(nullptr);
     DeserializationError err = DeserializationError::NoMemory;
     ArduinoJsonFileAdapter fileReader {file.get()};
 
-    while (err == DeserializationError::NoMemory && capacity <= MAX_JSON_CAPACITY) {
+    while (err == DeserializationError::NoMemory && capacity <= AO_MAX_JSON_CAPACITY) {
 
         doc.reset(new DynamicJsonDocument(capacity));
         err = deserializeJson(*doc, fileReader);
 
-        capacity *= 3;
-        capacity /= 2;
+        capacity *= 2;
 
         file->seek(0); //rewind file to beginning
     }
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.h b/src/ArduinoOcpp/Core/FilesystemUtils.h
index 13af63cf..7976261a 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.h
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef AO_FILESYSTEMUTILS_H
@@ -9,6 +9,10 @@
 #include <ArduinoJson.h>
 #include <memory>
 
+#ifndef AO_MAX_JSON_CAPACITY
+#define AO_MAX_JSON_CAPACITY 4096
+#endif
+
 namespace ArduinoOcpp {
 
 class ArduinoJsonFileAdapter {

From c794ef55ea7a058a7528d1121f7afe085e377bf9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 14 Feb 2023 21:28:14 +0100
Subject: [PATCH 182/549] split persistent key store in further file

---
 src/ArduinoOcpp/Core/Configuration.h                         | 1 +
 src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp       | 2 +-
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp  | 2 +-
 src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp | 2 +-
 src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp | 4 ++--
 5 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/ArduinoOcpp/Core/Configuration.h b/src/ArduinoOcpp/Core/Configuration.h
index e7d9f911..5f815fde 100644
--- a/src/ArduinoOcpp/Core/Configuration.h
+++ b/src/ArduinoOcpp/Core/Configuration.h
@@ -15,6 +15,7 @@
 
 #define CONFIGURATION_FN (AO_FILENAME_PREFIX "/arduino-ocpp.cnf")
 #define CONFIGURATION_VOLATILE "/volatile"
+#define AO_KEYVALUE_FN (AO_FILENAME_PREFIX "/client-state.cnf")
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
index 864035d0..664f03b7 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
@@ -82,7 +82,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
 
     if (canStartTransaction) {
 
-        auto sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, CONFIGURATION_FN, false, false, true, false);
+        auto sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, AO_KEYVALUE_FN, false, false, true, false);
 
         if (ocppModel && ocppModel->getSmartChargingService()) {
             auto scService = ocppModel->getSmartChargingService();
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 623f9465..5aa35eb9 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -27,7 +27,7 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
 
     char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
     snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, "AO_AVAIL_CONN_%d", connectorId);
-    availability = declareConfiguration<int>(availabilityKey, AVAILABILITY_OPERATIVE, CONFIGURATION_FN, false, false, true, false);
+    availability = declareConfiguration<int>(availabilityKey, AVAILABILITY_OPERATIVE, AO_KEYVALUE_FN, false, false, true, false);
 
     connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN, true, true, true, false);
     minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index 72b025b0..eefc9e78 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -33,7 +33,7 @@ void FirmwareService::setBuildNumber(const char *buildNumber) {
     if (buildNumber == nullptr)
         return;
     this->buildNumber = buildNumber;
-    previousBuildNumber = declareConfiguration<const char*>("BUILD_NUMBER", buildNumber, CONFIGURATION_FN, false, false, true, false);
+    previousBuildNumber = declareConfiguration<const char*>("BUILD_NUMBER", buildNumber, AO_KEYVALUE_FN, false, false, true, false);
     checkedSuccessfulFwUpdate = false; //--> CS will be notified
 }
 
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index 23d50a71..fc422b2a 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -52,9 +52,9 @@ SmartChargingService::SmartChargingService(OcppEngine& context, float chargeLimi
     chargingSessionStart = MAX_TIME;
     char max_timestamp [JSONDATE_LENGTH + 1] = {'\0'};
     chargingSessionStart.toJsonString(max_timestamp, JSONDATE_LENGTH + 1);
-    txStartTime = declareConfiguration<const char*>("AO_TXSTARTTIME_CONN_1", max_timestamp, CONFIGURATION_FN, false, false, true, false);
+    txStartTime = declareConfiguration<const char*>("AO_TXSTARTTIME_CONN_1", max_timestamp, AO_KEYVALUE_FN, false, false, true, false);
     chargingSessionTransactionID = -1;
-    sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, CONFIGURATION_FN, false, false, true, false);
+    sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, AO_KEYVALUE_FN, false, false, true, false);
     for (int i = 0; i < CHARGEPROFILEMAXSTACKLEVEL; i++) {
         ChargePointMaxProfile[i] = NULL;
         TxDefaultProfile[i] = NULL;

From 9e881f9c1e929a9a2b9810735228b4b91530c2c5 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 14 Feb 2023 21:57:24 +0100
Subject: [PATCH 183/549] refactor pointer types

---
 .../Core/ConfigurationContainerFlash.cpp         |  6 +++---
 src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp   | 16 ++++++++--------
 src/ArduinoOcpp/Core/ConfigurationKeyValue.h     | 12 ++++++------
 src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp |  6 +++---
 4 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index e0397f9a..8f825f64 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -97,10 +97,10 @@ bool ConfigurationContainerFlash::save() {
 
     size_t jsonCapacity = 2 * JSON_OBJECT_SIZE(2); //head + configurations + head payload
 
-    std::vector<std::shared_ptr<DynamicJsonDocument>> entries;
+    std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
 
     for (auto config = configurations.begin(); config != configurations.end(); config++) {
-        std::shared_ptr<DynamicJsonDocument> entry = (*config)->toJsonStorageEntry();
+        auto entry = (*config)->toJsonStorageEntry();
         if (entry) {
             size_t capacity = entry->memoryUsage(); //entry payload size
 
@@ -109,7 +109,7 @@ bool ConfigurationContainerFlash::save() {
                 break;
             }
 
-            entries.push_back(entry);
+            entries.push_back(std::move(entry));
             jsonCapacity += capacity;
         }
     }
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index d305ab0c..ffd15931 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -168,7 +168,7 @@ size_t Configuration<const char *>::getValueJsonCapacity() {
 }
 
 template<class T>
-std::shared_ptr<DynamicJsonDocument> Configuration<T>::toJsonStorageEntry() {
+std::unique_ptr<DynamicJsonDocument> Configuration<T>::toJsonStorageEntry() {
     if (!isValid()) {
         return nullptr;
     }
@@ -176,7 +176,7 @@ std::shared_ptr<DynamicJsonDocument> Configuration<T>::toJsonStorageEntry() {
                 + getValueJsonCapacity()
                 + JSON_OBJECT_SIZE(3); //type, header, value
     
-    std::shared_ptr<DynamicJsonDocument> doc = std::make_shared<DynamicJsonDocument>(capacity);
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
     JsonObject keyValuePair = doc->to<JsonObject>();
     keyValuePair["type"] = SerializedType<T>::get();
     storeStorageHeader(keyValuePair);
@@ -198,7 +198,7 @@ int toCStringValue(char *buf, size_t length, bool value) {
 }
 
 template<class T>
-std::shared_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
+std::unique_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
     if (!isValid()) {
         return nullptr;
     }
@@ -207,7 +207,7 @@ std::shared_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
                 + getValueJsonCapacity() + VALUE_MAXSIZE
                 + JSON_OBJECT_SIZE(2); // header, value
     
-    std::shared_ptr<DynamicJsonDocument> doc = std::make_shared<DynamicJsonDocument>(capacity);
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
     JsonObject keyValuePair = doc->to<JsonObject>();
     storeOcppMsgHeader(keyValuePair);
     char value_str [VALUE_MAXSIZE] = {'\0'};
@@ -216,7 +216,7 @@ std::shared_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
     return doc;
 }
 
-std::shared_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonStorageEntry() {
+std::unique_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonStorageEntry() {
     if (!isValid()) {
         return nullptr;
     }
@@ -224,7 +224,7 @@ std::shared_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonStorageE
                 + getValueJsonCapacity()
                 + JSON_OBJECT_SIZE(3); //type, header, value
     
-    std::shared_ptr<DynamicJsonDocument> doc = std::make_shared<DynamicJsonDocument>(capacity);
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
     JsonObject keyValuePair = doc->to<JsonObject>();
     keyValuePair["type"] = SerializedType<const char *>::get();
     storeStorageHeader(keyValuePair);
@@ -232,7 +232,7 @@ std::shared_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonStorageE
     return doc;
 }
 
-std::shared_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonOcppMsgEntry() {
+std::unique_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonOcppMsgEntry() {
     if (!isValid()) {
         return nullptr;
     }
@@ -240,7 +240,7 @@ std::shared_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonOcppMsgE
                 + getValueJsonCapacity()
                 + JSON_OBJECT_SIZE(2); // header, value
     
-    std::shared_ptr<DynamicJsonDocument> doc = std::make_shared<DynamicJsonDocument>(capacity);
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
     JsonObject keyValuePair = doc->to<JsonObject>();
     storeOcppMsgHeader(keyValuePair);
     keyValuePair["value"] = value;
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
index 4038a89c..c3855774 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
@@ -45,8 +45,8 @@ class AbstractConfiguration {
     uint16_t getValueRevision();
     bool keyEquals(const char *other);
 
-    virtual std::shared_ptr<DynamicJsonDocument> toJsonStorageEntry() = 0;
-    virtual std::shared_ptr<DynamicJsonDocument> toJsonOcppMsgEntry() = 0;
+    virtual std::unique_ptr<DynamicJsonDocument> toJsonStorageEntry() = 0;
+    virtual std::unique_ptr<DynamicJsonDocument> toJsonOcppMsgEntry() = 0;
 
     virtual const char *getSerializedType() = 0;
 
@@ -80,8 +80,8 @@ class Configuration : public AbstractConfiguration {
     operator T();
     bool isValid();
 
-    std::shared_ptr<DynamicJsonDocument> toJsonStorageEntry();
-    std::shared_ptr<DynamicJsonDocument> toJsonOcppMsgEntry();
+    std::unique_ptr<DynamicJsonDocument> toJsonStorageEntry();
+    std::unique_ptr<DynamicJsonDocument> toJsonOcppMsgEntry();
 
     const char *getSerializedType() {return SerializedType<T>::get();} //returns "int" or "float" as written to the configuration Json file
 };
@@ -103,8 +103,8 @@ class Configuration<const char *> : public AbstractConfiguration {
     bool isValid();
     size_t getBuffsize();
 
-    std::shared_ptr<DynamicJsonDocument> toJsonStorageEntry();
-    std::shared_ptr<DynamicJsonDocument> toJsonOcppMsgEntry();
+    std::unique_ptr<DynamicJsonDocument> toJsonStorageEntry();
+    std::unique_ptr<DynamicJsonDocument> toJsonOcppMsgEntry();
 
     const char *getSerializedType() {return SerializedType<const char *>::get();}
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
index 3989137a..5667c541 100644
--- a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
@@ -45,13 +45,13 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
     }
 
     size_t capacity = 0;
-    std::vector<std::shared_ptr<DynamicJsonDocument>> configurationKeysJson;
+    std::vector<std::unique_ptr<DynamicJsonDocument>> configurationKeysJson;
 
     for (auto confKey = configurationKeys->begin(); confKey != configurationKeys->end(); confKey++) {
-        std::shared_ptr<DynamicJsonDocument> entry = (*confKey)->toJsonOcppMsgEntry();
+        auto entry = (*confKey)->toJsonOcppMsgEntry();
         if (entry) {
-            configurationKeysJson.push_back(entry);
             capacity += entry->capacity();
+            configurationKeysJson.push_back(std::move(entry));
         }
     }
 

From f0785950c60eac56f515d42f7211d1c23383ef3a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 14 Feb 2023 22:20:05 +0100
Subject: [PATCH 184/549] GetConfiguration heap optimization

---
 src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp   | 16 ++++++++--------
 src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp |  9 +++++----
 2 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index ffd15931..b3dafcaa 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -42,8 +42,7 @@ void AbstractConfiguration::storeStorageHeader(JsonObject &keyValuePair) {
 }
 
 size_t AbstractConfiguration::getOcppMsgHeaderJsonCapacity() {
-    return JSON_OBJECT_SIZE(2) //key + readonly field
-            + key.size() + 1;
+    return key.size() + 1;
 }
 
 void AbstractConfiguration::storeOcppMsgHeader(JsonObject &keyValuePair) {
@@ -202,16 +201,17 @@ std::unique_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
     if (!isValid()) {
         return nullptr;
     }
-    const size_t VALUE_MAXSIZE = 50;
     size_t capacity = getOcppMsgHeaderJsonCapacity()
-                + getValueJsonCapacity() + VALUE_MAXSIZE
-                + JSON_OBJECT_SIZE(2); // header, value
+                + JSON_OBJECT_SIZE(3); //header (key + readonly), value
+
+    const size_t VALUE_MAXSIZE = 50;
+    char value_str [VALUE_MAXSIZE] = {'\0'};
+    toCStringValue(value_str, VALUE_MAXSIZE, value);
+    capacity += strlen(value_str) + 1;
     
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
     JsonObject keyValuePair = doc->to<JsonObject>();
     storeOcppMsgHeader(keyValuePair);
-    char value_str [VALUE_MAXSIZE] = {'\0'};
-    toCStringValue(value_str, VALUE_MAXSIZE, value);
     keyValuePair["value"] = value_str;
     return doc;
 }
@@ -238,7 +238,7 @@ std::unique_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonOcppMsgE
     }
     size_t capacity = getOcppMsgHeaderJsonCapacity()
                 + getValueJsonCapacity()
-                + JSON_OBJECT_SIZE(2); // header, value
+                + JSON_OBJECT_SIZE(3); //header (key + readonly), value
     
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
     JsonObject keyValuePair = doc->to<JsonObject>();
diff --git a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
index 5667c541..63935a70 100644
--- a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
@@ -44,13 +44,13 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
         }
     }
 
-    size_t capacity = 0;
+    size_t capacity = JSON_OBJECT_SIZE(2); //configurationKey, unknownKey
     std::vector<std::unique_ptr<DynamicJsonDocument>> configurationKeysJson;
 
     for (auto confKey = configurationKeys->begin(); confKey != configurationKeys->end(); confKey++) {
         auto entry = (*confKey)->toJsonOcppMsgEntry();
         if (entry) {
-            capacity += entry->capacity();
+            capacity += entry->memoryUsage();
             configurationKeysJson.push_back(std::move(entry));
         }
     }
@@ -59,10 +59,11 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
         capacity += unknownKey->length() + 1;
     }
 
-    capacity += JSON_OBJECT_SIZE(2) //configurationKey, unknownKey
-                + JSON_ARRAY_SIZE(configurationKeysJson.size())
+    capacity += JSON_ARRAY_SIZE(configurationKeysJson.size())
                 + JSON_ARRAY_SIZE(unknownKeys.size());
     
+    AO_DBG_DEBUG("GetConfiguration capacity: %zu", capacity);
+    
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
 
     JsonObject payload = doc->to<JsonObject>();

From 88b852f52b38a304097abbc0819add748ec8aa97 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 17 Feb 2023 22:43:51 +0100
Subject: [PATCH 185/549] comment code

---
 src/ArduinoOcpp/Core/OcppSocket.h | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppSocket.h b/src/ArduinoOcpp/Core/OcppSocket.h
index 959fa4bb..c8b8e12d 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.h
+++ b/src/ArduinoOcpp/Core/OcppSocket.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPPSOCKET_H
@@ -18,11 +18,22 @@ class OcppSocket {
     OcppSocket() = default;
     virtual ~OcppSocket() = default;
 
+    /*
+     * The OCPP library will call this function frequently. If you need to execute regular routines, like
+     * calling the loop-function of the WebSocket library, implement them here
+     */
     virtual void loop() = 0;
 
+    /*
+     * The OCPP library calls this function for sending out OCPP messages to the server
+     */
     virtual bool sendTXT(std::string &out) = 0;
 
-    virtual void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) = 0; //ReceiveTXTcallback is defined in OcppServer.h
+    /*
+     * The OCPP library calls this function once during initialization. It passes a callback function to
+     * the socket. The socket should forward any incoming payload from the OCPP server to the receiveTXT callback
+     */
+    virtual void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) = 0;
 };
 
 class OcppEchoSocket : public OcppSocket {

From e2ad339753ee572e487893d11aeb56fccfc67941 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 17 Feb 2023 22:46:49 +0100
Subject: [PATCH 186/549] full BootNotification lifecycle management

---
 CMakeLists.txt                                |  1 +
 examples/ESP-TLS/main.cpp                     |  9 +-
 examples/ESP/main.cpp                         |  9 +-
 src/ArduinoOcpp.cpp                           | 67 +++++++++----
 src/ArduinoOcpp.h                             | 32 ++++++-
 src/ArduinoOcpp/Core/OcppConnection.cpp       | 39 +++++---
 src/ArduinoOcpp/Core/OcppConnection.h         | 14 +--
 src/ArduinoOcpp/Core/OcppEngine.cpp           | 39 ++++++--
 src/ArduinoOcpp/Core/OcppEngine.h             | 10 +-
 src/ArduinoOcpp/Core/OcppMessage.cpp          |  4 +-
 src/ArduinoOcpp/Core/OcppModel.cpp            | 18 ++++
 src/ArduinoOcpp/Core/OcppModel.h              |  9 ++
 src/ArduinoOcpp/Core/OcppOperation.h          |  4 +-
 src/ArduinoOcpp/Core/OperationsQueue.cpp      | 69 +++++++++++--
 src/ArduinoOcpp/Core/OperationsQueue.h        | 53 ++++++++--
 .../MessagesV16/BootNotification.cpp          | 71 +++++++++-----
 .../MessagesV16/BootNotification.h            |  5 +-
 .../MessagesV16/TriggerMessage.cpp            |  4 +-
 src/ArduinoOcpp/Tasks/Boot/BootService.cpp    | 96 +++++++++++++++++++
 src/ArduinoOcpp/Tasks/Boot/BootService.h      | 56 +++++++++++
 .../ChargePointStatusService.cpp              | 34 +------
 .../ChargePointStatusService.h                | 12 +--
 src/ArduinoOcpp_c.cpp                         |  8 +-
 src/ArduinoOcpp_c.h                           | 10 ++
 24 files changed, 512 insertions(+), 161 deletions(-)
 create mode 100644 src/ArduinoOcpp/Tasks/Boot/BootService.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Boot/BootService.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 56776895..1470b0e6 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -55,6 +55,7 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+    src/ArduinoOcpp/Tasks/Boot/BootService.cpp
     src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
     src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
     src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
diff --git a/examples/ESP-TLS/main.cpp b/examples/ESP-TLS/main.cpp
index 0bb11e53..d5e9c450 100644
--- a/examples/ESP-TLS/main.cpp
+++ b/examples/ESP-TLS/main.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <Arduino.h>
@@ -117,7 +117,7 @@ void setup() {
     wsockSecure.setReconnectInterval(5000);
     wsockSecure.enableHeartbeat(15000, 3000, 2);
     wsockSecure.setAuthorization(OCPP_AUTH_ID, OCPP_AUTH_KEY); // => Authorization: Basic QUwxMDAwOgABAgMEBQYH////////////////
-    OCPP_initialize(osockSecure);
+    OCPP_initialize(osockSecure, ChargerCredentials("My Charging Station", "My company name"));
 
     /*
      * ... see ArduinoOcpp.h for how to integrate the EVSE hardware.
@@ -125,11 +125,6 @@ void setup() {
      * This example only showcases the TLS connection. For examples about the HW integration,
      * please see the other examples
      */
-
-    /*
-     * Notify the Central System that this station is ready
-     */
-    bootNotification("My Charging Station", "My company name");
 }
 
 void loop() {
diff --git a/examples/ESP/main.cpp b/examples/ESP/main.cpp
index d1149bc2..0c7ea19a 100644
--- a/examples/ESP/main.cpp
+++ b/examples/ESP/main.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <Arduino.h>
@@ -60,7 +60,7 @@ void setup() {
     /*
      * Initialize the OCPP library
      */
-    OCPP_initialize(OCPP_HOST, OCPP_PORT, OCPP_URL);
+    OCPP_initialize(OCPP_HOST, OCPP_PORT, OCPP_URL, "My Charging Station", "My company name");
 
     /*
      * Integrate OCPP functionality. You can leave out the following part if your EVSE doesn't need it.
@@ -81,11 +81,6 @@ void setup() {
     });
 
     //... see ArduinoOcpp.h for more settings
-
-    /*
-     * Notify the Central System that this station is ready
-     */
-    bootNotification("My Charging Station", "My company name");
 }
 
 void loop() {
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 1d122f6b..aaec8af3 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -15,6 +15,7 @@
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Tasks/Boot/BootService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
@@ -44,7 +45,6 @@ float voltage_eff {230.f};
 #endif
 
 #define OCPP_ID_OF_CP 0
-bool OCPP_booted = false; //if BootNotification succeeded
 
 } //end namespace ArduinoOcpp::Facade
 } //end namespace ArduinoOcpp
@@ -54,7 +54,7 @@ using namespace ArduinoOcpp::Facade;
 using namespace ArduinoOcpp::Ocpp16;
 
 #ifndef AO_CUSTOM_WS
-void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
+void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
     if (ocppEngine) {
         AO_DBG_WARN("Can't be called two times. Either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -78,11 +78,50 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     delete ocppSocket;
     ocppSocket = new EspWiFi::OcppClientSocket(webSocket);
 
-    OCPP_initialize(*ocppSocket, V_eff, fsOpt);
+    StaticJsonDocument<256> bootNotificationCrededentialsDoc;
+    JsonObject bn = bootNotificationCrededentialsDoc.to<JsonObject>();
+    bn["chargePointModel"] = chargePointModel;
+    bn["chargePointVendor"] = chargePointVendor;
+
+    OCPP_initialize(*ocppSocket, bn, V_eff, fsOpt);
 }
 #endif
 
-void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
+ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor, const char *fWv, const char *cpSNr, const char *meterSNr, const char *meterType, const char *cbSNr, const char *iccid, const char *imsi) {
+
+    StaticJsonDocument<512> creds;
+    if (cbSNr)
+        creds["chargeBoxSerialNumber"] = cbSNr;
+    if (cpModel)
+        creds["chargePointModel"] = cpModel;
+    if (cpSNr)
+        creds["chargePointSerialNumber"] = cpSNr;
+    if (cpVendor)
+        creds["chargePointVendor"] = cpVendor;
+    if (fWv)
+        creds["firmwareVersion"] = fWv;
+    if (iccid)
+        creds["iccid"] = iccid;
+    if (imsi)
+        creds["imsi"] = imsi;
+    if (meterSNr)
+        creds["meterSerialNumber"] = meterSNr;
+    if (meterType)
+        creds["meterType"] = meterType;
+    
+    if (creds.overflowed()) {
+        AO_DBG_ERR("Charger Credentials too long");
+    }
+
+    size_t written = serializeJson(creds, payload, 512);
+
+    if (written < 2) {
+        AO_DBG_ERR("Charger Credentials could not be written");
+        sprintf(payload, "{}");
+    }
+}
+
+void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredentials, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
     if (ocppEngine) {
         AO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -103,6 +142,8 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
         new TransactionStore(AO_NUMCONNECTORS, filesystem)));
+    model.setBootService(std::unique_ptr<BootService>(
+        new BootService(*ocppEngine)));
     model.setChargePointStatusService(std::unique_ptr<ChargePointStatusService>(
         new ChargePointStatusService(*ocppEngine, AO_NUMCONNECTORS)));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
@@ -111,7 +152,7 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
         new AuthorizationService(*ocppEngine, filesystem)));
     model.setReservationService(std::unique_ptr<ReservationService>(
         new ReservationService(*ocppEngine, AO_NUMCONNECTORS)));
-
+    
 #if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
         EspWiFi::makeFirmwareService(*ocppEngine, "1234578901"))); //instantiate FW service + ESP installation routine
@@ -133,7 +174,7 @@ void OCPP_initialize(OcppSocket& ocppSocket, float V_eff, ArduinoOcpp::Filesyste
         model.getChargePointStatusService()->setExecuteReset(makeDefaultResetFn());
 #endif
 
-    ocppEngine->setRunOcppTasks(false); //prevent OCPP classes from doing anything while booting
+    model.getBootService()->setChargePointCredentials(bootNotificationCredentials);
 }
 
 void OCPP_deinitialize() {
@@ -152,8 +193,6 @@ void OCPP_deinitialize() {
 
     fileSystemOpt = FilesystemOpt();
     voltage_eff = 230.f;
-
-    OCPP_booted = false;
 }
 
 void OCPP_loop() {
@@ -163,18 +202,6 @@ void OCPP_loop() {
     }
 
     ocppEngine->loop();
-
-
-    if (!OCPP_booted) {
-        auto csService = ocppEngine->getOcppModel().getChargePointStatusService();
-        if (!csService || csService->isBooted()) {
-            OCPP_booted = true;
-            ocppEngine->setRunOcppTasks(true);
-        } else {
-            return; //wait until the first BootNotification succeeded
-        }
-    }
-
 }
 
 void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 9b8ae5aa..80f3fd27 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -44,10 +44,39 @@ void OCPP_initialize(
             const char *CS_hostname, //e.g. "example.com"
             uint16_t CS_port,        //e.g. 80
             const char *CS_url,      //e.g. "ws://example.com/steve/websocket/CentralSystemService/charger001"
+            const char *chargePointModel = "Demo Charger",     //model name of this charger
+            const char *chargePointVendor = "My Company Ltd.", //brand name
             float V_eff = 230.f,     //Grid voltage of your country. e.g. 230.f (European voltage)
             ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 #endif
 
+/*
+ * Convenience initialization: use this for passing the BootNotification payload JSON to the OCPP_initialize(...) below
+ *
+ * Example usage:
+ * 
+ *     OCPP_initialize(osock, ChargerCredentials("Demo Charger", "My Company Ltd."));
+ * 
+ * For a description of the fields, refer to OCPP 1.6 Specification - Edition 2 p. 60
+ */
+struct ChargerCredentials {
+    ChargerCredentials(
+            const char *chargePointModel = "Demo Charger",
+            const char *chargePointVendor = "My Company Ltd.",
+            const char *firmwareVersion = nullptr,
+            const char *chargePointSerialNumber = nullptr,
+            const char *meterSerialNumber = nullptr,
+            const char *meterType = nullptr,
+            const char *chargeBoxSerialNumber = nullptr,
+            const char *iccid = nullptr,
+            const char *imsi = nullptr);
+
+    operator const char *() {return payload;}
+
+private:
+    char payload [512] = {'{', '}', '\0'};
+};
+
 /*
  * Initialize the library with a WebSocket connection which is configured with protocol=ocpp1.6
  * (=OcppSocket), EVSE voltage and filesystem configuration. This library requires that you handle
@@ -62,6 +91,7 @@ void OCPP_initialize(
  */
 void OCPP_initialize(
             ArduinoOcpp::OcppSocket& ocppSocket, //WebSocket adapter for ArduinoOcpp
+            const char *bootNotificationCredentials = ChargerCredentials("Demo Charger", "My Company Ltd."), //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             float V_eff = 230.f,                 //Grid voltage of your country. e.g. 230.f (European voltage)
             ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
@@ -141,7 +171,7 @@ bool beginTransaction(const char *idTag, unsigned int connectorId = 1);
 
 /*
  * End the transaction process by terminating the transaction and setting a reason for its termination.
- * Please refer to to OCPP 1.6 Specification - Edition 2 p. 90 for a list of valid reasons. "reason"
+ * Please refer to OCPP 1.6 Specification - Edition 2 p. 90 for a list of valid reasons. "reason"
  * can also be nullptr.
  * 
  * It is safe to call this function at any time, i.e. when no transaction runs or when the transaction
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 1c5c1308..6c5f886d 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppConnection.h>
@@ -17,13 +17,22 @@ size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_siz
 
 using namespace ArduinoOcpp;
 
-OcppConnection::OcppConnection(OcppSocket& ocppSock, std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
-            : baseModel{baseModel}, filesystem{filesystem}, initiatedOcppOperations{baseModel, filesystem} {
+OcppConnection::OcppConnection(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
+            : baseModel{baseModel}, filesystem{filesystem} {
+    
+    if (filesystem) {
+        initiatedOcppOperations.reset(new PersistentOperationsQueue(baseModel, filesystem));
+    } else {
+        initiatedOcppOperations.reset(new VolatileOperationsQueue());
+    }
+}
+
+void OcppConnection::setSocket(OcppSocket& sock) {
     ReceiveTXTcallback callback = [this] (const char *payload, size_t length) {
-        return this->processOcppSocketInputTXT(payload, length);
+        return this->receiveMessage(payload, length);
     };
     
-    ocppSock.setReceiveTXTcallback(callback);
+    sock.setReceiveTXTcallback(callback);
 }
 
 void OcppConnection::loop(OcppSocket& ocppSock) {
@@ -35,11 +44,11 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
      * can be dequeued and the following ocppOperation is processed.
      */
 
-    auto inited = initiatedOcppOperations.front();
+    auto inited = initiatedOcppOperations->front();
     if (inited) {
         bool timeout = inited->sendReq(ocppSock); //The only reason to dequeue elements here is when a timeout occurs. Normally
         if (timeout){                                       //the Conf msg processing routine dequeues finished elements
-            initiatedOcppOperations.pop_front();
+            initiatedOcppOperations->pop_front();
         }
     }
 
@@ -47,8 +56,8 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
      * Activate timeout detection on the msgs other than the first in the queue.
      */
 
-    auto cached = initiatedOcppOperations.begin_tail();
-    while (cached != initiatedOcppOperations.end_tail()) {
+    auto cached = initiatedOcppOperations->begin_tail();
+    while (cached != initiatedOcppOperations->end_tail()) {
         Timeout *timer = (*cached)->getTimeout();
         if (!timer) {
             ++cached; //no timeouts, nothing to do in this iteration
@@ -60,7 +69,7 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
                 (!(*cached)->getStorageHandler() || (*cached)->getStorageHandler()->getOpNr() < 0)) {
             AO_DBG_INFO("Discarding cached due to timeout:");
             (*cached)->print_debug();
-            cached = initiatedOcppOperations.erase_tail(cached);
+            cached = initiatedOcppOperations->erase_tail(cached);
         } else {
             ++cached;
         }
@@ -84,7 +93,7 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
     }
 }
 
-void OcppConnection::initiateOcppOperation(std::unique_ptr<OcppOperation> o){
+void OcppConnection::initiateOperation(std::unique_ptr<OcppOperation> o){
     if (!o) {
         AO_DBG_ERR("Called with null. Ignore");
         return;
@@ -94,10 +103,10 @@ void OcppConnection::initiateOcppOperation(std::unique_ptr<OcppOperation> o){
         return; //o gets destroyed
     }
     
-    initiatedOcppOperations.initiate(std::move(o));
+    initiatedOcppOperations->initiate(std::move(o));
 }
 
-bool OcppConnection::processOcppSocketInputTXT(const char* payload, size_t length) {
+bool OcppConnection::receiveMessage(const char* payload, size_t length) {
 
     AO_DBG_TRAFFIC_IN((int) length, payload);
     
@@ -188,7 +197,7 @@ void OcppConnection::handleConfMessage(JsonDocument& json) {
 
     bool success = false;
 
-    initiatedOcppOperations.drop_if(
+    initiatedOcppOperations->drop_if(
         [&json, &success] (std::unique_ptr<OcppOperation>& operation) {
             bool match = operation->receiveConf(json);
             if (match) {
@@ -228,7 +237,7 @@ void OcppConnection::handleErrMessage(JsonDocument& json) {
 
     bool success = false;
 
-    initiatedOcppOperations.drop_if(
+    initiatedOcppOperations->drop_if(
         [&json, &success] (std::unique_ptr<OcppOperation>& operation) {
             bool match = operation->receiveError(json);
             if (match) {
diff --git a/src/ArduinoOcpp/Core/OcppConnection.h b/src/ArduinoOcpp/Core/OcppConnection.h
index 8f00f4fc..ca85cd05 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.h
+++ b/src/ArduinoOcpp/Core/OcppConnection.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPPCONNECTION_H
@@ -23,7 +23,7 @@ class OcppConnection {
     std::shared_ptr<OcppModel> baseModel;
     std::shared_ptr<FilesystemAdapter> filesystem;
     
-    OperationsQueue initiatedOcppOperations;
+    std::unique_ptr<OperationsQueue> initiatedOcppOperations;
     std::deque<std::unique_ptr<OcppOperation>> receivedOcppOperations;
 
     void handleConfMessage(JsonDocument& json);
@@ -31,13 +31,15 @@ class OcppConnection {
     void handleReqMessage(JsonDocument& json, std::unique_ptr<OcppOperation> op);
     void handleErrMessage(JsonDocument& json);
 public:
-    OcppConnection(OcppSocket& oSock, std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
+    OcppConnection(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem = nullptr);
 
-    void loop(OcppSocket& oSock);
+    void setSocket(OcppSocket& sock);
 
-    void initiateOcppOperation(std::unique_ptr<OcppOperation> o);
+    void loop(OcppSocket& ocppSock);
+
+    void initiateOperation(std::unique_ptr<OcppOperation> o); //send an OCPP operation request to the server
     
-    bool processOcppSocketInputTXT(const char* payload, size_t length);
+    bool receiveMessage(const char* payload, size_t length); //receive an OCPP operation from the server - either a confirmation or a request
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/OcppEngine.cpp b/src/ArduinoOcpp/Core/OcppEngine.cpp
index e920bc2d..b5880678 100644
--- a/src/ArduinoOcpp/Core/OcppEngine.cpp
+++ b/src/ArduinoOcpp/Core/OcppEngine.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppEngine.h>
@@ -7,13 +7,18 @@
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 
+#include <ArduinoOcpp/Debug.h>
+
 using namespace ArduinoOcpp;
 
 OcppEngine *ArduinoOcpp::defaultOcppEngine = nullptr;
 
 OcppEngine::OcppEngine(OcppSocket& ocppSocket, const OcppClock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem)
-        : oSock(ocppSocket), oModel{std::make_shared<OcppModel>(system_clock)}, oConn{oSock, oModel, filesystem} {
+        : oSock(ocppSocket), oModel{std::make_shared<OcppModel>(system_clock)}, oConn{oModel, filesystem} {
     defaultOcppEngine = this;
+
+    preBootConn = std::unique_ptr<OcppConnection>(new OcppConnection(oModel, nullptr)); //pre boot queue doesn't need persistency
+    preBootConn->setSocket(oSock);
 }
 
 OcppEngine::~OcppEngine() {
@@ -22,16 +27,38 @@ OcppEngine::~OcppEngine() {
 
 void OcppEngine::loop() {
     oSock.loop();
-    oConn.loop(oSock);
 
-    if (runOcppTasks)
-        oModel->loop();
+    if (preBootConn) {
+        preBootConn->loop(oSock);
+    } else {
+        oConn.loop(oSock);
+    }
+
+    oModel->loop();
+}
+
+void OcppEngine::activatePostBootCommunication() {
+    //switch from pre boot connection to normal connetion
+    oConn.setSocket(oSock);
+    preBootConn.reset();
 }
 
 void OcppEngine::initiateOperation(std::unique_ptr<OcppOperation> op) {
     if (op) {
         op->setOcppModel(oModel);
-        oConn.initiateOcppOperation(std::move(op));
+        oConn.initiateOperation(std::move(op));
+    }
+}
+
+void OcppEngine::initiatePreBootOperation(std::unique_ptr<OcppOperation> op) {
+    if (op) {
+        if (preBootConn) {
+            op->setOcppModel(oModel);
+            preBootConn->initiateOperation(std::move(op));
+        } else {
+            //not in pre boot mode anymore - initiate normally
+            initiateOperation(std::move(op));
+        }
     }
 }
 
diff --git a/src/ArduinoOcpp/Core/OcppEngine.h b/src/ArduinoOcpp/Core/OcppEngine.h
index e4c03871..5615c75c 100644
--- a/src/ArduinoOcpp/Core/OcppEngine.h
+++ b/src/ArduinoOcpp/Core/OcppEngine.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPPENGINE_H
@@ -21,16 +21,20 @@ class OcppEngine {
     std::shared_ptr<OcppModel> oModel;
     OcppConnection oConn;
 
-    bool runOcppTasks = true;
+    std::unique_ptr<OcppConnection> preBootConn;
+
 public:
     OcppEngine(OcppSocket& ocppSocket, const OcppClock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem);
     ~OcppEngine();
 
     void loop();
 
-    void setRunOcppTasks(bool enable) {runOcppTasks = enable;}
+    void activatePostBootCommunication();
 
     void initiateOperation(std::unique_ptr<OcppOperation> op);
+    
+    //for BootNotification and TriggerMessage: initiate operations before the first BootNotification was accepted (pre-boot mode)
+    void initiatePreBootOperation(std::unique_ptr<OcppOperation> op);
 
     OcppModel& getOcppModel();
 };
diff --git a/src/ArduinoOcpp/Core/OcppMessage.cpp b/src/ArduinoOcpp/Core/OcppMessage.cpp
index 40781d1f..9f6f7ea0 100644
--- a/src/ArduinoOcpp/Core/OcppMessage.cpp
+++ b/src/ArduinoOcpp/Core/OcppMessage.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
@@ -25,7 +25,7 @@ void OcppMessage::setOcppModel(std::shared_ptr<OcppModel> ocppModel) {
 }
 
 void OcppMessage::initiate() {
-    //called after initiateOcppOperation(anyMsg)
+    //called after initiateOperation(anyMsg)
 }
 
 std::unique_ptr<DynamicJsonDocument> OcppMessage::createReq() {
diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/OcppModel.cpp
index 095f8a13..9b8ce474 100644
--- a/src/ArduinoOcpp/Core/OcppModel.cpp
+++ b/src/ArduinoOcpp/Core/OcppModel.cpp
@@ -12,6 +12,7 @@
 #include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Tasks/Boot/BootService.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -25,6 +26,15 @@ OcppModel::OcppModel(const OcppClock& system_clock)
 OcppModel::~OcppModel() = default;
 
 void OcppModel::loop() {
+
+    if (bootService) {
+        bootService->loop();
+    }
+
+    if (!runTasks) {
+        return;
+    }
+
     if (chargePointStatusService)
         chargePointStatusService->loop();
     
@@ -126,6 +136,14 @@ ReservationService *OcppModel::getReservationService() {
     return reservationService.get();
 }
 
+void OcppModel::setBootService(std::unique_ptr<BootService> bs){
+    bootService = std::move(bs);
+}
+
+BootService *OcppModel::getBootService() const {
+    return bootService.get();
+}
+
 OcppTime& OcppModel::getOcppTime() {
     return ocppTime;
 }
diff --git a/src/ArduinoOcpp/Core/OcppModel.h b/src/ArduinoOcpp/Core/OcppModel.h
index 8c26df4b..c37d8bd8 100644
--- a/src/ArduinoOcpp/Core/OcppModel.h
+++ b/src/ArduinoOcpp/Core/OcppModel.h
@@ -21,6 +21,7 @@ class DiagnosticsService;
 class HeartbeatService;
 class AuthorizationService;
 class ReservationService;
+class BootService;
 
 class OcppModel {
 private:
@@ -33,8 +34,11 @@ class OcppModel {
     std::unique_ptr<HeartbeatService> heartbeatService;
     std::unique_ptr<AuthorizationService> authorizationService;
     std::unique_ptr<ReservationService> reservationService;
+    std::unique_ptr<BootService> bootService;
     OcppTime ocppTime;
 
+    bool runTasks = false;
+
 public:
     OcppModel(const OcppClock& system_clock);
     OcppModel() = delete;
@@ -43,6 +47,8 @@ class OcppModel {
 
     void loop();
 
+    void activateTasks() {runTasks = true;}
+
     void setTransactionStore(std::unique_ptr<TransactionStore> transactionStore);
     TransactionStore *getTransactionStore();
 
@@ -70,6 +76,9 @@ class OcppModel {
     void setReservationService(std::unique_ptr<ReservationService> reservationService);
     ReservationService *getReservationService();
 
+    void setBootService(std::unique_ptr<BootService> bs);
+    BootService *getBootService() const;
+
     OcppTime &getOcppTime();
 };
 
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index 64b451da..bf954136 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPPOPERATION_H
@@ -101,7 +101,7 @@ class OcppOperation {
      */
     bool sendConf(OcppSocket& ocppSocket);
 
-    void initiate(std::unique_ptr<StoredOperationHandler> opStorage);
+    void initiate(std::unique_ptr<StoredOperationHandler> opStorage = nullptr);
 
     bool restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<OcppModel> oModel);
 
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index 8cacc00c..1db3fb47 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OperationsQueue.h>
@@ -16,14 +16,63 @@
 
 using namespace ArduinoOcpp;
 
-OperationsQueue::OperationsQueue(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
+VolatileOperationsQueue::VolatileOperationsQueue() {
+
+}
+
+VolatileOperationsQueue::~VolatileOperationsQueue() {
+
+}
+
+OcppOperation *VolatileOperationsQueue::front() {
+    if (!queue.empty()) {
+        return queue.front().get();
+    } else {
+        return nullptr;
+    }
+}
+
+void VolatileOperationsQueue::pop_front() {
+    queue.pop_front();
+}
+
+void VolatileOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
+
+    op->initiate();
+
+    if (queue.size() >= AO_OPERATIONCACHE_MAXSIZE) {
+        AO_DBG_WARN("unsafe number of cached operations");
+        (void)0;
+    }
+
+    queue.push_back(std::move(op));
+}
+
+std::deque<std::unique_ptr<OcppOperation>>::iterator VolatileOperationsQueue::begin_tail() {
+    if (queue.begin() != queue.end()) {
+        return queue.begin() + 1;
+    } else {
+        return queue.end();
+    }
+}
+std::deque<std::unique_ptr<OcppOperation>>::iterator VolatileOperationsQueue::end_tail() {
+    return queue.end();
+}
+std::deque<std::unique_ptr<OcppOperation>>::iterator VolatileOperationsQueue::erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) {
+    return queue.erase(el);
+}
+void VolatileOperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) {
+    queue.erase(std::remove_if(queue.begin(), queue.end(), pred), queue.end());
+}
+
+PersistentOperationsQueue::PersistentOperationsQueue(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
             : opStore(filesystem), baseModel(baseModel) { }
 
-OperationsQueue::~OperationsQueue() {
+PersistentOperationsQueue::~PersistentOperationsQueue() {
 
 }
 
-OcppOperation *OperationsQueue::front() {
+OcppOperation *PersistentOperationsQueue::front() {
     if (!head && !tailCache.empty()) {
         AO_DBG_ERR("invalid state");
         pop_front();
@@ -31,7 +80,7 @@ OcppOperation *OperationsQueue::front() {
     return head.get();
 }
 
-void OperationsQueue::pop_front() {
+void PersistentOperationsQueue::pop_front() {
     
     if (head && head->getStorageHandler() && head->getStorageHandler()->getOpNr() >= 0) {
         opStore.advanceOpNr(head->getStorageHandler()->getOpNr());
@@ -112,7 +161,7 @@ void OperationsQueue::pop_front() {
     AO_DBG_VERBOSE("popped front");
 }
 
-void OperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
+void PersistentOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
 
     op->initiate(opStore.makeOpHandler());
 
@@ -134,7 +183,7 @@ void OperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
     }
 }
 
-void OperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) {
+void PersistentOperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) {
 
     while (head && pred(head)) {
         pop_front();
@@ -143,14 +192,14 @@ void OperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppOperation>&
     tailCache.erase(std::remove_if(tailCache.begin(), tailCache.end(), pred), tailCache.end());
 }
 
-std::deque<std::unique_ptr<OcppOperation>>::iterator OperationsQueue::begin_tail() {
+std::deque<std::unique_ptr<OcppOperation>>::iterator PersistentOperationsQueue::begin_tail() {
     return tailCache.begin();
 }
 
-std::deque<std::unique_ptr<OcppOperation>>::iterator OperationsQueue::end_tail() {
+std::deque<std::unique_ptr<OcppOperation>>::iterator PersistentOperationsQueue::end_tail() {
     return tailCache.end();
 }
 
-std::deque<std::unique_ptr<OcppOperation>>::iterator OperationsQueue::erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) {
+std::deque<std::unique_ptr<OcppOperation>>::iterator PersistentOperationsQueue::erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) {
     return tailCache.erase(el);
 }
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.h b/src/ArduinoOcpp/Core/OperationsQueue.h
index 1eb8df4a..ec46b5eb 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.h
+++ b/src/ArduinoOcpp/Core/OperationsQueue.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OPERATIONSQUEUE_H
@@ -18,6 +18,39 @@ class OcppOperation;
 class OcppModel;
 
 class OperationsQueue {
+public:
+    virtual ~OperationsQueue() = default;
+
+    virtual OcppOperation *front() = 0;
+    virtual void pop_front() = 0;
+
+    virtual void initiate(std::unique_ptr<OcppOperation> op) = 0;
+
+    virtual std::deque<std::unique_ptr<OcppOperation>>::iterator begin_tail() = 0; //iterator for all cached elements except head
+    virtual std::deque<std::unique_ptr<OcppOperation>>::iterator end_tail() = 0;
+    virtual std::deque<std::unique_ptr<OcppOperation>>::iterator erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) = 0;
+    virtual void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) = 0; //drops operations from this queue where pred(operation) == true. Executes pred in order
+};
+
+class VolatileOperationsQueue : public OperationsQueue {
+private:
+    std::deque<std::unique_ptr<OcppOperation>> queue;
+public:
+    VolatileOperationsQueue();
+    ~VolatileOperationsQueue();
+
+    OcppOperation *front() override;
+    void pop_front() override;
+
+    void initiate(std::unique_ptr<OcppOperation> op) override;
+
+    std::deque<std::unique_ptr<OcppOperation>>::iterator begin_tail() override; //iterator for all cached elements except head
+    std::deque<std::unique_ptr<OcppOperation>>::iterator end_tail() override;
+    std::deque<std::unique_ptr<OcppOperation>>::iterator erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) override;
+    void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
+};
+
+class PersistentOperationsQueue : public OperationsQueue {
 private:
     OperationStore opStore;
     std::shared_ptr<OcppModel> baseModel;
@@ -26,18 +59,18 @@ class OperationsQueue {
     std::deque<std::unique_ptr<OcppOperation>> tailCache;
 public:
 
-    OperationsQueue(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
-    ~OperationsQueue();
+    PersistentOperationsQueue(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
+    ~PersistentOperationsQueue();
 
-    OcppOperation *front();
-    void pop_front();
+    OcppOperation *front() override;
+    void pop_front() override;
 
-    void initiate(std::unique_ptr<OcppOperation> op);
+    void initiate(std::unique_ptr<OcppOperation> op) override;
 
-    std::deque<std::unique_ptr<OcppOperation>>::iterator begin_tail(); //iterator for all cached elements except head
-    std::deque<std::unique_ptr<OcppOperation>>::iterator end_tail();
-    std::deque<std::unique_ptr<OcppOperation>>::iterator erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el);
-    void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred); //drops operations from this queue where pred(operation) == true. Executes pred in order
+    std::deque<std::unique_ptr<OcppOperation>>::iterator begin_tail() override; //iterator for all cached elements except head
+    std::deque<std::unique_ptr<OcppOperation>>::iterator end_tail() override;
+    std::deque<std::unique_ptr<OcppOperation>>::iterator erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) override;
+    void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
 
 };
 
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
index 2c4f3b86..36ac3532 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
@@ -1,10 +1,10 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/Boot/BootService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -26,18 +26,24 @@ const char* BootNotification::getOcppOperationType(){
 
 void BootNotification::initiate() {
     if (credentials &&
-            ocppModel && ocppModel->getChargePointStatusService()) {
-        auto cpStatus = ocppModel->getChargePointStatusService();
-        cpStatus->setChargePointCredentials(*credentials);
+            ocppModel && ocppModel->getBootService()) {
+        auto bootService = ocppModel->getBootService();
+        std::string credentialsJson;
+        auto written = serializeJson(*credentials, credentialsJson);
+        if (written < 2) {
+            AO_DBG_ERR("serialization error");
+            credentialsJson = "{}";
+        }
+        bootService->setChargePointCredentials(credentialsJson.c_str());
         credentials.reset();
     }
 }
 
 std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
 
-    if (ocppModel && ocppModel->getChargePointStatusService()) {
-        auto cpStatus = ocppModel->getChargePointStatusService();
-        const auto& cpCredentials = cpStatus->getChargePointCredentials();
+    if (ocppModel && ocppModel->getBootService()) {
+        auto bootService = ocppModel->getBootService();
+        const auto& cpCredentials = bootService->getChargePointCredentials();
     
         std::unique_ptr<DynamicJsonDocument> doc;
         size_t capacity = JSON_OBJECT_SIZE(9) + cpCredentials.size();
@@ -46,8 +52,7 @@ std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
             doc.reset(new DynamicJsonDocument(capacity));
             err = deserializeJson(*doc, cpCredentials);
 
-            capacity *= 3;
-            capacity /= 2;
+            capacity *= 2;
         }
 
         if (!err) {
@@ -72,32 +77,52 @@ void BootNotification::processConf(JsonObject payload){
             //success
         } else {
             AO_DBG_ERR("Time string format violation. Expect format like 2022-02-01T20:53:32.486Z");
+            errorCode = "PropertyConstraintViolation";
+            return;
         }
     } else {
         AO_DBG_ERR("Missing attribute currentTime");
+        errorCode = "FormationViolation";
+        return;
     }
     
     int interval = payload["interval"] | -1;
+    if (interval < 0) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    RegistrationStatus status = deserializeRegistrationStatus(payload["status"] | "Invalid");
+    
+    if (status == RegistrationStatus::UNDEFINED) {
+        errorCode = "FormationViolation";
+        return;
+    }
 
-    //only write if in valid range
-    if (interval >= 1) {
-        std::shared_ptr<Configuration<int>> intervalConf = declareConfiguration<int>("HeartbeatInterval", 86400);
-        if (intervalConf && interval != *intervalConf) {
-            *intervalConf = interval;
-            configuration_save();
+    if (status == RegistrationStatus::Accepted) {
+        //only write if in valid range
+        if (interval >= 1) {
+            std::shared_ptr<Configuration<int>> intervalConf = declareConfiguration<int>("HeartbeatInterval", 86400);
+            if (intervalConf && interval != *intervalConf) {
+                *intervalConf = interval;
+                configuration_save();
+            }
         }
     }
 
-    const char* status = payload["status"] | "Invalid";
+    if (ocppModel && ocppModel->getBootService()) {
+        auto bootService = ocppModel->getBootService();
 
-    if (!strcmp(status, "Accepted")) {
-        AO_DBG_INFO("Request has been accepted");
-        if (ocppModel && ocppModel->getChargePointStatusService() != nullptr) {
-            ocppModel->getChargePointStatusService()->boot();
+        if (status != RegistrationStatus::Accepted) {
+            bootService->setRetryInterval(interval);
         }
-    } else {
-        AO_DBG_WARN("Request unsuccessful");
+
+        bootService->notifyRegistrationStatus(status);
     }
+
+    AO_DBG_INFO("request has been %s", status == RegistrationStatus::Accepted ? "Accepted" :
+                                       status == RegistrationStatus::Pending ? "replied with Pending" :
+                                       "Rejected");
 }
 
 void BootNotification::processReq(JsonObject payload){
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.h b/src/ArduinoOcpp/MessagesV16/BootNotification.h
index 5f33364a..1edee47b 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef BOOTNOTIFICATION_H
@@ -19,6 +19,7 @@ namespace Ocpp16 {
 class BootNotification : public OcppMessage {
 private:
     std::unique_ptr<DynamicJsonDocument> credentials;
+    const char *errorCode = nullptr;
 public:
     BootNotification();
 
@@ -37,6 +38,8 @@ class BootNotification : public OcppMessage {
     void processReq(JsonObject payload);
 
     std::unique_ptr<DynamicJsonDocument> createConf();
+
+    const char *getErrorCode() {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
index 3673a589..a18e1842 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/TriggerMessage.h>
@@ -83,7 +83,7 @@ std::unique_ptr<DynamicJsonDocument> TriggerMessage::createConf(){
     if (defaultOcppEngine) {
         auto op = triggeredOperations.begin();
         while (op != triggeredOperations.end()) {
-            defaultOcppEngine->initiateOperation(std::move(triggeredOperations.front()));
+            defaultOcppEngine->initiatePreBootOperation(std::move(triggeredOperations.front()));
             op = triggeredOperations.erase(op);
         }
     }
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
new file mode 100644
index 00000000..8fa433ea
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
@@ -0,0 +1,96 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Boot/BootService.h>
+#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/MessagesV16/BootNotification.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Platform.h>
+#include <ArduinoOcpp/Debug.h>
+
+using namespace ArduinoOcpp;
+
+RegistrationStatus ArduinoOcpp::deserializeRegistrationStatus(const char *serialized) {
+    if (!strcmp(serialized, "Accepted")) {
+        return RegistrationStatus::Accepted;
+    } else if (!strcmp(serialized, "Pending")) {
+        return RegistrationStatus::Pending;
+    } else if (!strcmp(serialized, "Rejected")) {
+        return RegistrationStatus::Rejected;
+    } else {
+        AO_DBG_ERR("deserialization error");
+        return RegistrationStatus::UNDEFINED;
+    }
+}
+
+BootService::BootService(OcppEngine& context) : context(context) {
+    
+    //if transactions can start before the BootNotification succeeds
+    preBootTransactions = declareConfiguration<bool>("AO_PreBootTransactions", false, CONFIGURATION_FN, true, true, true, false);
+    
+    if (!preBootTransactions) {
+        AO_DBG_ERR("initialization error");
+        (void)0;
+    }
+}
+
+void BootService::loop() {
+
+    if (!activatedPostBootCommunication && status == RegistrationStatus::Accepted) {
+        context.activatePostBootCommunication();
+        activatedPostBootCommunication = true;
+    }
+
+    if (!activatedModel && (status == RegistrationStatus::Accepted || *preBootTransactions)) {
+        context.getOcppModel().activateTasks();
+        activatedModel = true;
+    }
+
+    if (status == RegistrationStatus::Accepted) {
+        return;
+    }
+    
+    if (ao_tick_ms() - lastBootNotification < (interval_s * 1000UL)) {
+        return;
+    }
+
+    /*
+     * Create BootNotification. The BootNotifaction object will fetch its paremeters from
+     * this class and notify this class about the response
+     */
+    auto bootNotification = makeOcppOperation(new Ocpp16::BootNotification());
+    bootNotification->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
+    context.initiatePreBootOperation(std::move(bootNotification));
+
+    lastBootNotification = ao_tick_ms();
+}
+
+void BootService::setChargePointCredentials(const char *credentialsJson) {
+    cpCredentials = credentialsJson;
+    if (cpCredentials.size() < 2) {
+        cpCredentials = "{}";
+    }
+}
+
+std::string& BootService::getChargePointCredentials() {
+    if (cpCredentials.size() <= 2) {
+        cpCredentials = "{}";
+    }
+
+    return cpCredentials;
+}
+
+void BootService::notifyRegistrationStatus(RegistrationStatus status) {
+    this->status = status;
+}
+
+void BootService::setRetryInterval(unsigned long interval_s) {
+    if (interval_s == 0) {
+        this->interval_s = AO_BOOT_INTERVAL_DEFAULT;
+    } else {
+        this->interval_s = interval_s;
+    }
+}
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.h b/src/ArduinoOcpp/Tasks/Boot/BootService.h
new file mode 100644
index 00000000..f6883986
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.h
@@ -0,0 +1,56 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef BOOTSERVICE_H
+#define BOOTSERVICE_H
+
+#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
+#include <memory>
+
+#define AO_BOOT_INTERVAL_DEFAULT 60
+
+namespace ArduinoOcpp {
+
+enum class RegistrationStatus {
+    Accepted,
+    Pending,
+    Rejected,
+    UNDEFINED
+};
+
+RegistrationStatus deserializeRegistrationStatus(const char *serialized);
+
+class OcppEngine;
+
+class BootService {
+private:
+    OcppEngine& context;
+
+    unsigned long interval_s = AO_BOOT_INTERVAL_DEFAULT;
+    unsigned long lastBootNotification = -1UL / 2;
+
+    RegistrationStatus status = RegistrationStatus::Pending;
+    
+    std::string cpCredentials;
+
+    std::shared_ptr<Configuration<bool>> preBootTransactions;
+
+    bool activatedModel = false;
+    bool activatedPostBootCommunication = false;
+
+public:
+    BootService(OcppEngine& context);
+
+    void loop();
+
+    void setChargePointCredentials(const char *credentialsJson);
+    std::string& getChargePointCredentials();
+
+    void notifyRegistrationStatus(RegistrationStatus status);
+    void setRetryInterval(unsigned long interval);
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index f7328171..781ee4b6 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
@@ -59,7 +59,6 @@ ChargePointStatusService::~ChargePointStatusService() {
 }
 
 void ChargePointStatusService::loop() {
-    if (!booted) return;
     for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
         auto transactionMsg = (*connector)->loop();
         if (transactionMsg != nullptr) {
@@ -98,41 +97,10 @@ ConnectorStatus *ChargePointStatusService::getConnector(int connectorId) {
     return connectors.at(connectorId).get();
 }
 
-void ChargePointStatusService::boot() {
-    booted = true;
-}
-
-bool ChargePointStatusService::isBooted() {
-    return booted;
-}
-
 int ChargePointStatusService::getNumConnectors() {
     return connectors.size();
 }
 
-void ChargePointStatusService::setChargePointCredentials(DynamicJsonDocument &credentials) {
-    if (!credentials.is<JsonObject>()) {
-        AO_DBG_ERR("Payload must be JSON object");
-        cpCredentials.clear();
-        return;
-    }
-    auto written = serializeJson(credentials, cpCredentials);
-    if (written <= 2) {
-        AO_DBG_ERR("Could not parse CP credentials: %s", written == 2 ? "format violation" : "invalid JSON");
-        cpCredentials.clear();
-        return;
-    }
-    //success
-}
-
-std::string& ChargePointStatusService::getChargePointCredentials() {
-    if (cpCredentials.size() <= 2) {
-        cpCredentials = "{}";
-    }
-
-    return cpCredentials;
-}
-
 void ChargePointStatusService::setPreReset(std::function<bool(bool)> preReset) {
     this->preReset = preReset;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
index 62f902e3..fbed6540 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CHARGEPOINTSTATUSSERVICE_H
@@ -20,10 +20,6 @@ class ChargePointStatusService {
     
     std::vector<std::unique_ptr<ConnectorStatus>> connectors;
 
-    bool booted = false;
-
-    std::string cpCredentials;
-
     std::function<bool(bool isHard)> preReset; //true: reset is possible; false: reject reset; Await: need more time to determine
     std::function<void(bool isHard)> executeReset; //please disconnect WebSocket (AO remains initialized), shut down device and restart with normal initialization routine; on failure reconnect WebSocket
     unsigned int outstandingResetRetries = 0; //0 = do not reset device
@@ -39,15 +35,9 @@ class ChargePointStatusService {
     
     void loop();
 
-    void boot();
-    bool isBooted();
-
     ConnectorStatus *getConnector(int connectorId);
     int getNumConnectors();
 
-    void setChargePointCredentials(DynamicJsonDocument &credentials);
-    std::string& getChargePointCredentials();
-
     void setPreReset(std::function<bool(bool isHard)> preReset);
     std::function<bool(bool isHard)> getPreReset();
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 4c33a9ac..970b0995 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -5,7 +5,11 @@
 
 ArduinoOcpp::OcppSocket *ocppSocket = nullptr;
 
-void ao_initialize(AOcppSocket *osock,  float V_eff, struct AO_FilesystemOpt fsopt) {
+void ao_initialize(AOcppSocket *osock, const char *chargePointModel, const char *chargePointVendor, float V_eff, struct AO_FilesystemOpt fsopt) {
+    ao_initialize_full(osock, ChargerCredentials(chargePointModel, chargePointVendor), V_eff, fsopt);
+}
+
+void ao_initialize_full(AOcppSocket *osock, const char *bootNotificationCredentials, float V_eff, struct AO_FilesystemOpt fsopt) {
     if (!osock) {
         AO_DBG_ERR("osock is null");
     }
@@ -14,7 +18,7 @@ void ao_initialize(AOcppSocket *osock,  float V_eff, struct AO_FilesystemOpt fso
 
     ArduinoOcpp::FilesystemOpt adaptFsopt = fsopt;
 
-    OCPP_initialize(*ocppSocket, V_eff, adaptFsopt);
+    OCPP_initialize(*ocppSocket, bootNotificationCredentials, V_eff, adaptFsopt);
 }
 
 void ao_deinitialize() {
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 2b0b305b..c461ef9e 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -55,9 +55,19 @@ extern "C" {
 
 void ao_initialize(
             AOcppSocket *osock,  //WebSocket adapter for ArduinoOcpp
+            const char *chargePointModel,     //model name of this charger (e.g. "")
+            const char *chargePointVendor, //brand name
             float V_eff, //Grid voltage of your country. e.g. 230.f (European voltage)
             struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
+//same as above, but more fields for the BootNotification
+void ao_initialize_full(
+            AOcppSocket *osock,  //WebSocket adapter for ArduinoOcpp
+            const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
+            float V_eff, //Grid voltage of your country. e.g. 230.f (European voltage)
+            struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+
+
 void ao_deinitialize();
 
 void ao_loop();

From d10233897195cacc7ff242cd72b4901cf832051d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 17 Feb 2023 22:54:39 +0100
Subject: [PATCH 187/549] fix type error

---
 src/ArduinoOcpp.cpp | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index aaec8af3..dde5e2cc 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -78,12 +78,7 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     delete ocppSocket;
     ocppSocket = new EspWiFi::OcppClientSocket(webSocket);
 
-    StaticJsonDocument<256> bootNotificationCrededentialsDoc;
-    JsonObject bn = bootNotificationCrededentialsDoc.to<JsonObject>();
-    bn["chargePointModel"] = chargePointModel;
-    bn["chargePointVendor"] = chargePointVendor;
-
-    OCPP_initialize(*ocppSocket, bn, V_eff, fsOpt);
+    OCPP_initialize(*ocppSocket, ChargerCredentials(chargePointModel, chargePointVendor), V_eff, fsOpt);
 }
 #endif
 

From 43c4e19e3c71713cca002b894ea0638c6403157a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 17 Feb 2023 23:01:08 +0100
Subject: [PATCH 188/549] fix compiler warning

---
 src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index 8f825f64..079da8ed 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -131,7 +131,7 @@ bool ConfigurationContainerFlash::save() {
     if (success) {
         AO_DBG_DEBUG("Saving configurations finished");
     } else {
-        AO_DBG_ERR("could not save configs file: %", getFilename());
+        AO_DBG_ERR("could not save configs file: %s", getFilename());
     }
 
     return success;

From bb3a89491a6400387f4d76950566644044bcf64a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 17 Feb 2023 23:05:59 +0100
Subject: [PATCH 189/549] higher loop count

---
 tests/helpers/testHelper.cpp | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/tests/helpers/testHelper.cpp b/tests/helpers/testHelper.cpp
index 2ac00670..171fb793 100644
--- a/tests/helpers/testHelper.cpp
+++ b/tests/helpers/testHelper.cpp
@@ -13,10 +13,8 @@ unsigned long custom_timer_cb() {
 }
 
 void loop() {
-    mtime += 1000;
-    OCPP_loop();
-    mtime += 1000;
-    OCPP_loop();
-    mtime += 1000;
-    OCPP_loop();
+    for (int i = 0; i < 30; i++) {
+        mtime += 100;
+        OCPP_loop();
+    }
 }

From 5f2bc552c6c9b29451508c49e438e71ab4a3f728 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 17 Feb 2023 23:09:44 +0100
Subject: [PATCH 190/549] no initialization of incomplete type

---
 src/ArduinoOcpp/Core/OcppOperation.h     | 2 +-
 src/ArduinoOcpp/Core/OperationsQueue.cpp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index bf954136..83be63cd 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -101,7 +101,7 @@ class OcppOperation {
      */
     bool sendConf(OcppSocket& ocppSocket);
 
-    void initiate(std::unique_ptr<StoredOperationHandler> opStorage = nullptr);
+    void initiate(std::unique_ptr<StoredOperationHandler> opStorage);
 
     bool restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<OcppModel> oModel);
 
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index 1db3fb47..565e1629 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -38,7 +38,7 @@ void VolatileOperationsQueue::pop_front() {
 
 void VolatileOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
 
-    op->initiate();
+    op->initiate(nullptr);
 
     if (queue.size() >= AO_OPERATIONCACHE_MAXSIZE) {
         AO_DBG_WARN("unsafe number of cached operations");

From bc2fbc68b6c46fcdcdf0ab6d00b37ff2b40d70e8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 17 Feb 2023 23:14:23 +0100
Subject: [PATCH 191/549] higher loop count 2

---
 tests/TransactionSafety.cpp | 36 +++++++++++-------------------------
 1 file changed, 11 insertions(+), 25 deletions(-)

diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 85913f2e..7cd4f94f 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -28,14 +28,12 @@ TEST_CASE( "Transaction safety" ) {
 
     SECTION("Basic transaction") {
         AO_DBG_DEBUG("Basic transaction");
-        OCPP_loop();
-        OCPP_loop();
-        OCPP_loop();
+        loop();
         startTransaction("mIdTag");
-        OCPP_loop();
+        loop();
         REQUIRE(ocppPermitsCharge());
         stopTransaction();
-        OCPP_loop();
+        loop();
         REQUIRE(!ocppPermitsCharge());
 
         OCPP_deinitialize();
@@ -43,15 +41,13 @@ TEST_CASE( "Transaction safety" ) {
 
     SECTION("Managed transaction") {
         AO_DBG_DEBUG("Managed transaction");
-        OCPP_loop();
-        OCPP_loop();
-        OCPP_loop();
+        loop();
         setConnectorPluggedInput([] () {return true;});
         beginTransaction("mIdTag");
-        OCPP_loop();
+        loop();
         REQUIRE(ocppPermitsCharge());
         endTransaction();
-        OCPP_loop();
+        loop();
         REQUIRE(!ocppPermitsCharge());
         
         OCPP_deinitialize();
@@ -60,9 +56,7 @@ TEST_CASE( "Transaction safety" ) {
     SECTION("Reset during transaction 01 - interrupt initiation") {
         AO_DBG_DEBUG("Reset during transaction 01 - interrupt initiation");
         setConnectorPluggedInput([] () {return false;});
-        OCPP_loop();
-        OCPP_loop();
-        OCPP_loop();
+        loop();
         beginTransaction("mIdTag");
         OCPP_deinitialize(); //reset and jump to next section
     }
@@ -70,9 +64,7 @@ TEST_CASE( "Transaction safety" ) {
     SECTION("Reset during transaction 02 - interrupt initiation second time") {
         AO_DBG_DEBUG("Reset during transaction 02 - interrupt initiation second time");
         setConnectorPluggedInput([] () {return false;});
-        OCPP_loop();
-        OCPP_loop();
-        OCPP_loop();
+        loop();
         REQUIRE(!ocppPermitsCharge());
         OCPP_deinitialize();
     }
@@ -80,9 +72,7 @@ TEST_CASE( "Transaction safety" ) {
     SECTION("Reset during transaction 03 - interrupt running tx") {
         AO_DBG_DEBUG("Reset during transaction 03 - interrupt running tx");
         setConnectorPluggedInput([] () {return true;});
-        OCPP_loop();
-        OCPP_loop();
-        OCPP_loop();
+        loop();
         REQUIRE(ocppPermitsCharge());
         OCPP_deinitialize();
     }
@@ -90,9 +80,7 @@ TEST_CASE( "Transaction safety" ) {
     SECTION("Reset during transaction 04 - interrupt stopping tx") {
         AO_DBG_DEBUG("Reset during transaction 04 - interrupt stopping tx");
         setConnectorPluggedInput([] () {return true;});
-        OCPP_loop();
-        OCPP_loop();
-        OCPP_loop();
+        loop();
         REQUIRE(ocppPermitsCharge());
         endTransaction();
         OCPP_deinitialize();
@@ -101,9 +89,7 @@ TEST_CASE( "Transaction safety" ) {
     SECTION("Reset during transaction 06 - check tx finished") {
         AO_DBG_DEBUG("Reset during transaction 06 - check tx finished");
         setConnectorPluggedInput([] () {return true;});
-        OCPP_loop();
-        OCPP_loop();
-        OCPP_loop();
+        loop();
         REQUIRE(!ocppPermitsCharge());
         OCPP_deinitialize();
     }

From d331692bfb8a4c8a1242d9ab7a988cc992835002 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Feb 2023 14:27:10 +0100
Subject: [PATCH 192/549] remove superfluous Config declaration

---
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp | 1 -
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h   | 1 -
 2 files changed, 2 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 5aa35eb9..052bd328 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -34,7 +34,6 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
     stopTransactionOnInvalidId = declareConfiguration<bool>("StopTransactionOnInvalidId", true, CONFIGURATION_FN, true, true, true, false);
     stopTransactionOnEVSideDisconnect = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
     unlockConnectorOnEVSideDisconnect = declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
-    localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", false, CONFIGURATION_FN, true, true, true, false);
     localPreAuthorize = declareConfiguration<bool>("LocalPreAuthorize", false, CONFIGURATION_FN, true, true, true, false);
 
     //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index f6e69459..20dd84be 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -59,7 +59,6 @@ class ConnectorStatus {
     std::shared_ptr<Configuration<bool>> stopTransactionOnInvalidId;
     std::shared_ptr<Configuration<bool>> stopTransactionOnEVSideDisconnect;
     std::shared_ptr<Configuration<bool>> unlockConnectorOnEVSideDisconnect;
-    std::shared_ptr<Configuration<bool>> localAuthorizeOffline;
     std::shared_ptr<Configuration<bool>> localPreAuthorize;
 
     std::shared_ptr<Configuration<bool>> silentOfflineTransactions;

From 9fd189f8d60548666c9f6a61b1a9bc2e6dec0437 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Feb 2023 14:27:37 +0100
Subject: [PATCH 193/549] remove outdated SECC example

---
 examples/SECC/README.md      |  22 --
 examples/SECC/main.cpp       | 492 -----------------------------------
 examples/SECC/platformio.ini |  21 --
 3 files changed, 535 deletions(-)
 delete mode 100644 examples/SECC/README.md
 delete mode 100644 examples/SECC/main.cpp
 delete mode 100644 examples/SECC/platformio.ini

diff --git a/examples/SECC/README.md b/examples/SECC/README.md
deleted file mode 100644
index e1f7a7b5..00000000
--- a/examples/SECC/README.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# Simple EVSE OCPP communication controller
-
-With this sketch you can use an ESP8266/ESP32 as the central control unit of an EVSE. It controls the HW peripherals of the EVSE and connects the charge point to an OCPP server. When booting up the EVSE, it opens a maintenance web dashboard for setting the Wi-Fi and OCPP credentials (thanks to tzapu's WiFiManager).
-
-## Architecture
-
-The communication controller can connect to an SAE&nbsp;J1772 driver using the GPIO pins of the ESP. Furthermore, it can show the online status and charge point availability status via status LEDs. Displays, RFID readers or energy meters are not supported, though for your project you can integrate further HW components of course.
-
-You can find the interface descriptions in `main.ino`. Please be aware that although this program modulates the maximum charge rate with PWM analogous to the SAE&nbsp;J1772 standard, the PWM signal does not reflect the EVSE state. The latter is encoded via the other GPIO pins.
-
-## Usage
-
-- Create an empty project in the PlatformIO IDE.
-- Copy the `platformio.ini` from this directory to your root directory. Alternatively, just add `https://github.com/tzapu/WiFiManager.git` to the lib_deps of your `platformio.ini`.
-- Copy the `main.ino` from this example folder into your source directory. Adapt the pinout settings if needed.
-- Finished. You should be able to compile and upload the sketch onto your ESP.
-
-When booting, the ESP opens up the Wi-Fi configuration portal. Please connect your PC to the network with the SSID `EVSE-Config` within the first 30s of the boot routine of the ESP (the portal has a timeout). The passphrase is `evse1234`.
-
-## Standalone mode
-
-If you just want to check out ArduinoOcpp you can run this sketch on an ESP without any peripherals. The pinout of the ESP8266-NodeMCU&nbsp;board is already fully configured in `main.ino` so that board is the most convenient to start testing.
diff --git a/examples/SECC/main.cpp b/examples/SECC/main.cpp
deleted file mode 100644
index ff98eb57..00000000
--- a/examples/SECC/main.cpp
+++ /dev/null
@@ -1,492 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-//
-//
-// IMPORTANT: Please add https://github.com/tzapu/WiFiManager.git to the lib_deps of your project!
-//
-// This sketch demonstrates a complete OCPP Wi-Fi module of an EVSE. You can flash
-// an ESP8266/ESP32 with this program, build it into your EVSE and start charging with
-// OCPP-connectivity.
-//
-// The pin mapping and additional comments can be found in this file. You probably need
-// to adapt a few things before deployment.
-//
-
-
-#include <Arduino.h>
-#include <WiFiManager.h> //please add to lib_deps: https://github.com/tzapu/WiFiManager.git
-
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/Configuration.h> //load and save settings of WiFi captive portal
-
-/*
- * Pin mapping part I
- * Interface to the SECC (Supply Equipment Communication Controller, e.g. the SAE J1772 module)
- */
-#define AMPERAGE_PIN 4 //modulated as PWM
-
-#define EV_PLUG_PIN 14 // Input pin | Read if an EV is connected to the EVSE
-#if defined(ESP32)
-#define EV_PLUGGED HIGH
-#define EV_UNPLUGGED LOW
-#elif defined(ESP8266)
-#define EV_PLUGGED LOW
-#define EV_UNPLUGGED HIGH
-#endif
-
-#define OCPP_CHARGE_PERMISSION_PIN 5 // Output pin | Signal if OCPP allows / forbids energy flow
-#define OCPP_CHARGE_PERMITTED HIGH
-#define OCPP_CHARGE_FORBIDDEN LOW
-
-#define EV_CHARGE_PIN 12 // Input pin | Read if EV requests energy (corresponds to SAE J1772 State C)
-#if defined(ESP32)
-#define EV_CHARGING LOW
-#define EV_SUSPENDED HIGH
-#elif defined(ESP8266)
-#define EV_CHARGING HIGH
-#define EV_SUSPENDED LOW
-#endif
-
-#define OCPP_AVAILABILITY_PIN 0 // Output pin | Signal if this EVSE is out of order (set by Central System)
-#define OCPP_AVAILABLE HIGH
-#define OCPP_UNAVAILABLE LOW
-
-#define EVSE_GROUND_FAULT_PIN 13 // Input pin | Read ground fault detector
-#define EVSE_GROUND_FAULTED HIGH
-#define EVSE_GROUND_CLEAR LOW
-
-/*
- * Pin mapping part II
- * Internal LED of ESP8266/ESP32 + additional ESP8266 development board LED
- */
-
-#define SERVER_CONNECT_LED 16 // Output pin | Signal if connection to OCPP server has succeeded
-#define SERVER_CONNECT_ON LOW
-#define SERVER_CONNECT_OFF HIGH
-
-#define CHARGE_PERMISSION_LED 2 // Output pin | Signal if OCPP allows / forbids energy flow
-#if defined(ESP32)
-#define CHARGE_PERMISSION_ON HIGH
-#define CHARGE_PERMISSION_OFF LOW
-#elif defined(ESP8266)
-#define CHARGE_PERMISSION_ON LOW
-#define CHARGE_PERMISSION_OFF HIGH
-#endif
-
-#if !defined(SECC_NO_DEBUG)
-#define PRINT(...) Serial.print(__VA_ARGS__)
-#define PRINTF(...) Serial.printf(__VA_ARGS__)
-#define PRINTLN(...) Serial.println(__VA_ARGS__)
-#else
-#define PRINT(...)
-#define PRINTF(...)
-#define PRINTLN(...)
-#endif
-
-WebSocketsClient wSock;
-ArduinoOcpp::EspWiFi::OcppClientSocket oSock{&wSock};
-
-int evPlugged = EV_UNPLUGGED;
-
-bool booted = false;
-ulong scheduleReboot = 0; //0 = no reboot scheduled; otherwise reboot scheduled in X ms
-ulong reboot_timestamp = 0; //timestamp of the triggering event; if scheduleReboot=0, the timestamp has no meaning
-
-// ============ CAPTIVE PORTAL
-#define CAPTIVE_PORTAL_TIMEOUT  60 //in seconds
-#define WIFI_CONNECTION_TIMEOUT 30 //in seconds
-
-struct Ocpp_URL {
-    bool isTLS = true;
-    String host = String('\0');
-    uint16_t port = 443;
-    String url = String('\0');
-    bool parse(String& url);
-};
-
-Ocpp_URL ocppUrlParsed = Ocpp_URL();
-
-bool runWiFiManager();
-// ============ END CAPTIVE PORTAL
-
-void setup() {
-
-    /*
-     * Initialize peripherals
-     */
-    Serial.begin(115200);
-#if !defined(SECC_NO_DEBUG)
-    Serial.setDebugOutput(true);
-#endif
-    pinMode(EV_PLUG_PIN, INPUT);
-    pinMode(EV_CHARGE_PIN, INPUT);
-    pinMode(EVSE_GROUND_FAULT_PIN, INPUT);
-    pinMode(OCPP_CHARGE_PERMISSION_PIN, OUTPUT);
-    digitalWrite(OCPP_CHARGE_PERMISSION_PIN, OCPP_CHARGE_FORBIDDEN);
-    pinMode(OCPP_AVAILABILITY_PIN, OUTPUT);
-    digitalWrite(OCPP_AVAILABILITY_PIN, OCPP_UNAVAILABLE);
-    pinMode(CHARGE_PERMISSION_LED, OUTPUT);
-    digitalWrite(CHARGE_PERMISSION_LED, CHARGE_PERMISSION_OFF);
-
-    pinMode(AMPERAGE_PIN, OUTPUT);
-#if defined(ESP32)
-    pinMode(AMPERAGE_PIN, OUTPUT);
-    ledcSetup(0, 1000, 8); //channel=0, freq=1000Hz, range=(2^8)-1
-    ledcAttachPin(AMPERAGE_PIN, 0);
-    ledcWrite(AMPERAGE_PIN, 256); //256 is constant +3.3V DC
-#elif defined(ESP8266)
-    analogWriteRange(255); //range=(2^8)-1
-    analogWriteFreq(1000); //freq=1000Hz
-    analogWrite(AMPERAGE_PIN, 256); //256 is constant +3.3V DC
-#else
-#error Can only run on ESP8266 and ESP32 on the Arduino platform!
-#endif
-
-    pinMode(SERVER_CONNECT_LED, OUTPUT);
-    digitalWrite(SERVER_CONNECT_LED, SERVER_CONNECT_ON); //signal device reboot
-    delay(100);
-    digitalWrite(SERVER_CONNECT_LED, SERVER_CONNECT_OFF);
-
-    /*
-     * You can use ArduinoOcpp's internal configurations store for credentials other than those which are
-     * specified by OCPP. To use it before ArduinoOcpp is initialized, you need to call configuration_init()
-     * 
-     * This snippet also shows how to integrate a custom filesystem. Just subclass FilesystemAdapter and pass
-     * it to the library
-     */
-    std::shared_ptr<ArduinoOcpp::FilesystemAdapter> filesystem = ArduinoOcpp::makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
-    ArduinoOcpp::configuration_init(filesystem);
-
-    /*
-     * WiFiManager opens a captive portal, lets the user enter the WiFi credentials and provides a settings
-     * page for the OCPP connection
-     */
-    if (!runWiFiManager()) {
-        //couldn't connect
-        PRINTLN(F("[main] Couldn't connect to WiFi after multiple attempts"));
-        delay(30000);
-        ESP.restart();
-    }
-
-    std::shared_ptr<ArduinoOcpp::Configuration<const char *>> ocppUrl = ArduinoOcpp::declareConfiguration<const char *>(
-        "ocppUrl", "", CONFIGURATION_FN, false, false, true, true);
-    std::shared_ptr<ArduinoOcpp::Configuration<const char *>> CA_cert = ArduinoOcpp::declareConfiguration<const char *>(
-        "CA_cert", "", CONFIGURATION_FN, false, false, true, true);
-    std::shared_ptr<ArduinoOcpp::Configuration<const char *>> httpAuthentication = ArduinoOcpp::declareConfiguration<const char *>(
-        "httpAuthentication", "", CONFIGURATION_FN, false, false, true, true);
-    
-    String ocppUrlString = String(*ocppUrl);
-    if (!ocppUrlParsed.parse(ocppUrlString)) {
-        PRINTLN(F("[main] Invalid OCPP URL. Restart."));
-        delay(10000);
-        ESP.restart();
-    }
-
-    PRINTF("[main] host, port, URL: %s, %hu, %s\n",
-                ocppUrlParsed.host.isEmpty() ? "undefined" : ocppUrlParsed.host.c_str(),
-                ocppUrlParsed.port,
-                ocppUrlParsed.url.isEmpty()  ? "undefined" : ocppUrlParsed.url.c_str());
-
-    /*
-     * Initialize ArduinoOcpp framework.
-     */
-    wSock.setReconnectInterval(5000);
-    wSock.enableHeartbeat(15000, 3000, 2);
-
-    if (httpAuthentication->getBuffsize() > 1) {
-        wSock.setAuthorization(*httpAuthentication);
-    }
-    
-    if (ocppUrlParsed.isTLS) {
-        if (CA_cert->getBuffsize() > 0) {
-            //TODOS: ESP8266: limit BearSSL buffsize
-            configTime(3 * 3600, 0, "pool.ntp.org", "time.nist.gov"); //alternatively: settimeofday(&de, &tz);
-            PRINT(F("[main] Wait for NTP time (used for certificate validation) "));
-            time_t now = time(nullptr);
-            while (now < 8 * 3600 * 2) {
-                delay(500);
-                PRINT('.');
-                now = time(nullptr);
-            }
-            PRINTF(" finished. Unix timestamp is %lu\n", now);
-
-            wSock.beginSslWithCA(ocppUrlParsed.host.c_str(), ocppUrlParsed.port, ocppUrlParsed.url.c_str(), *CA_cert, "ocpp1.6");
-        } else {
-            wSock.beginSSL(ocppUrlParsed.host.c_str(), ocppUrlParsed.port, ocppUrlParsed.url.c_str(), nullptr, "ocpp1.6");
-        }
-    } else {
-        wSock.begin(ocppUrlParsed.host, ocppUrlParsed.port, ocppUrlParsed.url, "ocpp1.6");
-    }
-
-    OCPP_initialize(oSock,
-            230.f, //European grid voltage
-            ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
-
-    /*
-     * Integrate OCPP functionality. You can leave out the following part if your EVSE doesn't need it.
-     */
-    setEnergyMeterInput([]() {
-        //read the energy input register of the EVSE here and return the value in Wh
-        /*
-         * Approximated value. Replace with real reading
-         */
-        static ulong lastSampled = millis();
-        static float energyMeter = 0.f;
-        if (getTransactionId() > 0)
-            energyMeter += ((float) (millis() - lastSampled)) * 0.003f; //increase by 0.003Wh per ms (~ 10.8kWh per h)
-        lastSampled = millis();
-        return energyMeter;
-    });
-
-    setSmartChargingOutput([](float limit) {
-        //set the SAE J1772 Control Pilot value here
-        const float voltage = 230.f; // European grid
-        const uint nPhases = 1; //one, two or three phase charging
-        float amps = limit / (voltage * (float) nPhases);
-        if (amps > 51.f)
-            amps = 51.f;
-
-        PRINTF("[main] Smart Charging allows maximum charge rate: %iW; convert to Control Pilot amerage: %.2fA\n", (int) limit, amps);
-
-        int pwmVal;
-        if (amps < 6.f) {
-            pwmVal = 256; // = constant +3.3V DC
-        } else {
-            pwmVal = (int) (4.26667f * amps);
-        }
-
-#if defined(ESP32)
-        ledcWrite(AMPERAGE_PIN, pwmVal);
-#elif defined(ESP8266)
-        analogWrite(AMPERAGE_PIN, pwmVal);
-#endif
-    });
-
-    setEvReadyInput([]() {
-        //return true if the EV is in state "Ready for charging" (see https://en.wikipedia.org/wiki/SAE_J1772#Control_Pilot)
-        return digitalRead(EV_CHARGE_PIN) == EV_CHARGING;
-    });
-
-    addErrorCodeInput([] () {
-        //Uncomment if Ground fault pin is used
-        //if (digitalRead(EVSE_GROUND_FAULT_PIN) != EVSE_GROUND_CLEAR) {
-        //    return "GroundFault";
-        //}
-        return (const char *) nullptr;
-    });
-
-    setOnResetSendConf([] (JsonObject confirmation) {
-        if (getTransactionId() >= 0)
-            stopTransaction();
-        
-        PRINTLN(F("[main] Execute reset command"));
-        reboot_timestamp = millis();
-        scheduleReboot = 5000; //reboot will be executed in loop()
-        booted = false;
-    });
-
-    //... see ArduinoOcpp.h for more settings
-
-    /*
-     * Notify the Central System that this station is ready
-     */
-    bootNotification("My Charging Station", "My company name", [] (JsonObject response) {
-        if (response["status"].as<String>().equals("Accepted")) {
-            booted = true;
-            digitalWrite(SERVER_CONNECT_LED, SERVER_CONNECT_ON);
-        } else {
-            //Wait for the connection retry
-            reboot_timestamp = millis();
-            scheduleReboot = 60000; //wait for 60s until reboot; reboot will be executed in loop()
-        }
-    });
-}
-
-void loop() {
-
-    /*
-     * Do all OCPP stuff (process WebSocket input, send recorded meter values to Central System, etc.)
-     */
-    OCPP_loop();
-
-    //NFC reader integration example
-    if (/* RFID chip detected? */ false) {
-        const char *idTag = "my-id-tag"; //e.g. idTag = RFID.readIdTag();
-        authorize(idTag);
-    }
-
-    if (ocppPermitsCharge()) {
-        //EVSE is in a charging session and charging is permitted by the OCPP server
-        digitalWrite(OCPP_CHARGE_PERMISSION_PIN, OCPP_CHARGE_PERMITTED);
-        digitalWrite(CHARGE_PERMISSION_LED, CHARGE_PERMISSION_ON);
-    } else {
-        //Charging is not allowed due to OCPP rules
-        digitalWrite(OCPP_CHARGE_PERMISSION_PIN, OCPP_CHARGE_FORBIDDEN);
-        digitalWrite(CHARGE_PERMISSION_LED, CHARGE_PERMISSION_OFF);
-    }
-
-    if (scheduleReboot > 0 && millis() - reboot_timestamp >= scheduleReboot) {
-        ESP.restart();
-    }
-
-    if (!booted) {
-        return;
-    }
-
-    auto readEvPlugged = digitalRead(EV_PLUG_PIN);
-    if (evPlugged == EV_UNPLUGGED && readEvPlugged == EV_PLUGGED //transition from unplugged to plugged
-                && getTransactionId() < 0  //no transaction yet
-                && isOperative()) {        //EVSE is in operative mode
-        startTransaction("my-id-tag");
-    } else if (evPlugged == EV_PLUGGED && readEvPlugged == EV_UNPLUGGED //transition from plugged to unplugged
-                && getTransactionId() >= 0) { //need to stop transaction
-        stopTransaction();
-    }
-    evPlugged = readEvPlugged;
-
-    //... see ArduinoOcpp.h for more possibilities
-}
-
-
-
-// ### End of the OCPP integration. The following code integrates the
-// ### WiFi-Manager into this example sketch.
-
-bool runWiFiManager() {
-
-    /*
-     * Initialize WiFi and start captive portal to set connection credentials
-     */ 
-    WiFi.mode(WIFI_STA); // explicitly set mode, esp defaults to STA+AP
-
-    std::shared_ptr<ArduinoOcpp::Configuration<const char *>> ocppUrl = ArduinoOcpp::declareConfiguration<const char *>(
-        "ocppUrl", "", CONFIGURATION_FN, false, false, true, true);
-    std::shared_ptr<ArduinoOcpp::Configuration<const char *>> CA_cert = ArduinoOcpp::declareConfiguration<const char *>(
-        "CA_cert", "", CONFIGURATION_FN, false, false, true, true);
-    std::shared_ptr<ArduinoOcpp::Configuration<const char *>> httpAuthentication = ArduinoOcpp::declareConfiguration<const char *>(
-        "httpAuthentication", "", CONFIGURATION_FN, false, false, true, true);
-
-    WiFiManager wifiManager;
-    wifiManager.setTitle("EVSE configuration portal");
-    wifiManager.setParamsPage(true);
-    WiFiManagerParameter ocppUrlParam ("ocppUrl", "OCPP 1.6 Server URL + Charge Box ID", *ocppUrl, 150,"placeholder=\"wss://&lt;domain&gt;:&lt;port&gt;/&lt;path&gt;/&lt;chargeBoxId&gt;\"");
-    wifiManager.addParameter(&ocppUrlParam);
-    
-    WiFiManagerParameter divider("<div><br/></div>");
-    wifiManager.addParameter(&divider);
-
-    WiFiManagerParameter caCertParam ("caCert", "CA Certificate", "", 1500,"placeholder=\"Paste here or leave blank\"");
-    wifiManager.addParameter(&caCertParam);
-    WiFiManagerParameter caCertSavePararm ("<div><label for='caCertSave' style='width: auto;'>Save new CA Certificate</label><input type='checkbox' name='caCertSave' value='1'  style='width: auto; margin-left: 10px; vertical-align: middle;'></div>");
-    wifiManager.addParameter(&caCertSavePararm);
-
-    WiFiManagerParameter httpAuthenticationParam ("httpAuthentication", "HTTP-authentication token", "", 150,"placeholder=\"e.g.: aKu0Q4NjMRC9yO3wRo08\"");
-    wifiManager.addParameter(&httpAuthenticationParam);
-    WiFiManagerParameter httpAuthenticationSavePararm ("<div><label for='httpAuthenticationSave' style='width: auto;'>Save new HTTP token</label><input type='checkbox' name='httpAuthenticationSave' value='1'  style='width: auto; margin-left: 10px; vertical-align: middle;'></div>");
-    wifiManager.addParameter(&httpAuthenticationSavePararm);
-
-    wifiManager.setSaveParamsCallback([&ocppUrlParam, ocppUrl, &wifiManager, CA_cert, &caCertParam, httpAuthentication, &httpAuthenticationParam] () {
-        String newOcppUrl = String(ocppUrlParam.getValue());
-        newOcppUrl.trim();
-        Ocpp_URL newOcppUrlParsed = Ocpp_URL();
-        if (newOcppUrlParsed.parse(newOcppUrl)) {
-            //success
-            *ocppUrl = newOcppUrl.c_str();
-        }
-        
-        bool caCertSave = false;
-        String caCertChangedParam = String ("caCertSave");
-        if(wifiManager.server->hasArg(caCertChangedParam)) {
-            String caCertChanged = String(wifiManager.server->arg(caCertChangedParam));
-            if (caCertChanged.length() > 0) {
-                caCertSave = caCertChanged.charAt(0) == '1' || caCertChanged.charAt(0) == 't' || caCertChanged.charAt(0) == 'o';
-            }
-        }
-        if (caCertSave) {
-            *CA_cert = caCertParam.getValue();
-        }
-
-        bool httpAuthenticationSave = false;
-        String authChangedParam = String ("httpAuthenticationSave");
-        if(wifiManager.server->hasArg(authChangedParam)) {
-            String authChanged = String(wifiManager.server->arg(authChangedParam));
-            if (authChanged.length() > 0) {
-                httpAuthenticationSave = authChanged.charAt(0) == '1' || authChanged.charAt(0) == 't' || authChanged.charAt(0) == 'o';
-            }
-        }
-        if (httpAuthenticationSave) {
-            *httpAuthentication = httpAuthenticationParam.getValue();
-        }
-        ArduinoOcpp::configuration_save();
-    });
-
-    wifiManager.setDarkMode(true);
-
-    //wifiManager.setConfigPortalTimeout(CAPATITIVE_PORTAL_TIMEOUT / 1000); //if nobody logs in to the portal, continue after timeout 
-    wifiManager.setTimeout(CAPTIVE_PORTAL_TIMEOUT); //if nobody logs in to the portal, continue after timeout 
-    wifiManager.setConnectTimeout(WIFI_CONNECTION_TIMEOUT);
-    //wifiManager.setSaveConnect(true);
-    wifiManager.setAPClientCheck(true); // avoid timeout if client connected to softap
-    PRINTLN(F("[main] Start capatitive portal"));
-    
-    if (wifiManager.startConfigPortal("EVSE-Config", "evse1234")) {
-        return true;
-    } else {
-        return wifiManager.autoConnect("EVSE-Config", "evse1234");
-    }
-}
-
-bool Ocpp_URL::parse(String &ocppUrl) {
-    String inputUrl = String(ocppUrl); // wss://host.com:433/path
-    inputUrl.trim();
-
-    if (ocppUrl.isEmpty()) {
-        return false;
-    }
-    url = inputUrl;
-
-    inputUrl.toLowerCase();
-
-    if (inputUrl.startsWith("wss://")) {
-        isTLS = true;
-        port = 443;
-    } else if (inputUrl.startsWith("ws://")) {
-        isTLS = false;
-        port = 80;
-    } else {
-        return false;
-    }
-    inputUrl = inputUrl.substring(inputUrl.indexOf("://") + strlen("://")); // host.com:433/path
-    if (inputUrl.isEmpty()) {
-        return false;
-    }
-
-    host = String('\0');
-    for (uint i = 0; i < inputUrl.length(); i++) {
-        if (inputUrl.charAt(i) == ':') { //case host.com:433/path
-            host = inputUrl.substring(0, i);
-            uint16_t inputPort = 0;
-            for (unsigned int j = i + 1; j < inputUrl.length(); j++) {
-                if (isDigit(inputUrl.charAt(j))) {
-                    inputPort *= (uint16_t) 10;
-                    inputPort += inputUrl.charAt(j) - '0';
-                } else {
-                    break;
-                }
-            }
-            if (inputPort > 0) {
-                port = inputPort;
-            }
-            break;
-        } else if (inputUrl.charAt(i) == '/') { //case host.com/path
-            host = inputUrl.substring(0, i);
-            break;
-        }
-    }
-    if (host.isEmpty()) {
-        host = inputUrl;
-    }
-
-    return true;
-}
diff --git a/examples/SECC/platformio.ini b/examples/SECC/platformio.ini
deleted file mode 100644
index 72b36270..00000000
--- a/examples/SECC/platformio.ini
+++ /dev/null
@@ -1,21 +0,0 @@
-; matth-x/ArduinoOcpp
-; Copyright Matthias Akstaller 2019 - 2022
-; MIT License
-
-[env:esp32dev]
-platform = espressif32@3.3.2
-board = esp32dev
-framework = arduino
-lib_deps =
-    https://github.com/matth-x/ArduinoOcpp.git
-    https://github.com/tzapu/WiFiManager.git#4dcf0cc78bb031351d65e0f9b9271569df8720ed
-monitor_speed = 115200
-
-[env:nodemcuv2]
-platform = espressif8266@2.6.3
-board = nodemcuv2
-framework = arduino
-lib_deps = 
-    https://github.com/matth-x/ArduinoOcpp.git
-    https://github.com/tzapu/WiFiManager.git#4dcf0cc78bb031351d65e0f9b9271569df8720ed
-monitor_speed = 115200

From dedd54f74c0bb1e49bd9576ba31781d82f41dfdb Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Feb 2023 14:38:29 +0100
Subject: [PATCH 194/549] remove deprecated server socket

---
 CMakeLists.txt                      |   1 -
 src/ArduinoOcpp/Core/OcppServer.cpp | 169 ----------------------------
 src/ArduinoOcpp/Core/OcppServer.h   |  56 ---------
 src/ArduinoOcpp/Core/OcppSocket.cpp |  24 +---
 src/ArduinoOcpp/Core/OcppSocket.h   |  15 ---
 5 files changed, 1 insertion(+), 264 deletions(-)
 delete mode 100644 src/ArduinoOcpp/Core/OcppServer.cpp
 delete mode 100644 src/ArduinoOcpp/Core/OcppServer.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 1470b0e6..a5105b8a 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -17,7 +17,6 @@ set(AO_SRC
     src/ArduinoOcpp/Core/OcppModel.cpp
     src/ArduinoOcpp/Core/OcppOperation.cpp
     src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
-    src/ArduinoOcpp/Core/OcppServer.cpp
     src/ArduinoOcpp/Core/OcppSocket.cpp
     src/ArduinoOcpp/Core/OcppTime.cpp
     src/ArduinoOcpp/Core/OperationsQueue.cpp
diff --git a/src/ArduinoOcpp/Core/OcppServer.cpp b/src/ArduinoOcpp/Core/OcppServer.cpp
deleted file mode 100644
index 2614a66d..00000000
--- a/src/ArduinoOcpp/Core/OcppServer.cpp
+++ /dev/null
@@ -1,169 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#include <ArduinoOcpp/Core/OcppServer.h>
-#include <ArduinoOcpp/Debug.h>
-
-#ifndef AO_CUSTOM_WS
-
-#define DEBUG_OUT (AO_DBG_LEVEL >= AO_DL_INFO)
-
-#ifdef AO_TRAFFIC_OUT
-#define TRAFFIC_OUT true
-#else
-#define TRAFFIC_OUT false
-#endif
-
-using namespace ArduinoOcpp::EspWiFi;
-
-OcppServer::OcppServer() {
-    AO_DBG_WARN("OCPP Server only suitable for tests at the moment");
-    wsockServer.begin();
-    wsockServer.onEvent([this](WsClient num, WStype_t type, uint8_t * payload, size_t length) {
-        this->wsockEvent(num, type, payload, length);
-    });
-
-    instance = this;
-}
-
-void OcppServer::wsockEvent(WsClient num, WStype_t type, uint8_t * payload, size_t length) {
-
-    switch(type) {
-        case WStype_DISCONNECTED:
-            {
-                if (DEBUG_OUT) Serial.print(F("[OcppServer] WsClient disconnected! num = "));
-                if (DEBUG_OUT) Serial.println(num);                
-            }
-            break;
-        case WStype_CONNECTED:
-            {
-                IPAddress ip = wsockServer.remoteIP(num);
-                if (DEBUG_OUT) {
-                    Serial.print(F("[OcppServer] WsClient connected! num = "));
-                    Serial.print(num);
-                    Serial.print(F(", Connected from IP = "));
-                    ip.printTo(Serial);
-                    Serial.print(F(", with payload "));
-                    Serial.println((const char*) payload);
-                }
-
-                bool found = false;
-				for (auto route = receiveTXTrouting.begin(); route != receiveTXTrouting.end(); ++route) {
-                    if (ip == (*route).ip_addr) {
-                        if (DEBUG_OUT) Serial.print(F("[OcppServer] IPAddress matches existing route!\n"));
-                        (*route).num = num;
-                        found = true;
-                        break;
-                    }
-                }
-
-                if (!found) {
-                    Serial.print(F("[OcppServer] Unknown IP address! Please see addReceiveTXTcallback(IPAddress ...)\n"));
-                }
-            }
-            break;
-        case WStype_TEXT:
-            {
-                if (DEBUG_OUT || TRAFFIC_OUT) {
-                    Serial.print(F("[OcppServer] Get TXT from client: "));
-                    Serial.print(num);
-                    Serial.print(F(", TXT = "));
-                    Serial.println((const char*) payload);
-                }
-
-                bool found = false;
-                for (auto route = receiveTXTrouting.begin(); route != receiveTXTrouting.end(); ++route) {
-                    if (num == (*route).num) {
-                        if (DEBUG_OUT) Serial.print(F("\n"));
-                        if (!((*route).processTXT((const char*) payload, length))) {
-                            Serial.print(F("[OcppServer] Processing WebSocket input event failed!\n"));
-                        }
-                        found = true;
-                        break;
-                    }
-                }
-
-                if (!found) {
-                    Serial.print(F("[OcppServer] Received msg from unknown client!\n"));
-                }
-            }
-            break;
-        case WStype_PING:
-            // pong will be send automatically
-            Serial.printf("[OcppServer] get ping, client = %u\n", num);
-            break;
-        case WStype_PONG:
-            // answer to a ping we send
-            Serial.printf("[OcppServer] get pong, client = %u\n", num);
-            break;
-        case WStype_FRAGMENT_TEXT_START: //fragments are not supported
-        case WStype_BIN:
-        default:
-            Serial.print(F("[OcppServer] Unsupported WebSocket event type, client = "));
-            Serial.println(num);
-            break;
-    }
-}
-
-OcppServer *OcppServer::instance = NULL;
-
-OcppServer *OcppServer::getInstance() {
-    if (!instance){
-        instance = new OcppServer();
-    }
-    return instance;
-}
-
-void OcppServer::loop() {
-    wsockServer.loop();
-}
-
-void OcppServer::setReceiveTXTcallback(IPAddress &ip_addr, ReceiveTXTcallback &callback) {
-    /*
-     * Does route identified by ip_addr already exist?
-     */
-    std::vector<ReceiveTXTroute>::iterator result = std::find_if(receiveTXTrouting.begin(), receiveTXTrouting.end(),
-        [ip_addr](const ReceiveTXTroute &elem) {
-            return elem.ip_addr == ip_addr;
-        });
-    
-    if (result != receiveTXTrouting.end()) {
-        //found a route. Update callback
-        (*result).processTXT = callback;
-    } else {
-        //no route found. Add new one
-        ReceiveTXTroute route {};
-        route.ip_addr = ip_addr;
-        route.processTXT = callback;
-        receiveTXTrouting.push_back(route);
-    }
-}
-
-void OcppServer::removeReceiveTXTcallback(IPAddress &ip_addr) {
-    receiveTXTrouting.erase(std::remove_if(receiveTXTrouting.begin(), receiveTXTrouting.end(), 
-        [ip_addr](const ReceiveTXTroute &elem) {
-            return elem.ip_addr == ip_addr;
-        }), receiveTXTrouting.end());
-}
-
-bool OcppServer::sendTXT(IPAddress &ip_addr, std::string &out) {
-
-    WsClient mClient;
-
-    std::vector<ReceiveTXTroute>::iterator result = std::find_if(receiveTXTrouting.begin(), receiveTXTrouting.end(),
-        [ip_addr](const ReceiveTXTroute &elem) {
-            return elem.ip_addr == ip_addr;
-        });
-        
-    if (result != receiveTXTrouting.end()) {
-        mClient = (*result).num;
-    } else {
-        Serial.print(F("[OcppServer] Tried to send TXT for unregistered IP address! Abort\n"));
-        return false;
-    }
-
-    return wsockServer.sendTXT(mClient, out.c_str(), out.length());
-}
-
-#endif //ndef AO_CUSTOM_WS
diff --git a/src/ArduinoOcpp/Core/OcppServer.h b/src/ArduinoOcpp/Core/OcppServer.h
deleted file mode 100644
index 64b43afb..00000000
--- a/src/ArduinoOcpp/Core/OcppServer.h
+++ /dev/null
@@ -1,56 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#ifndef OCPPSERVER_H
-#define OCPPSERVER_H
-
-#include <vector>
-#include <ArduinoOcpp/Core/OcppSocket.h>
-
-namespace ArduinoOcpp {
-
-using WsClient = uint8_t;
-
-} //end namespace ArduinoOcpp
-
-#ifndef AO_CUSTOM_WS
-
-#include <WebSocketsServer.h>
-
-namespace ArduinoOcpp {
-namespace EspWiFi {
-
-struct ReceiveTXTroute {
-    IPAddress ip_addr;
-    WsClient num;
-    ReceiveTXTcallback processTXT;
-};
-
-class OcppServer {
-private:
-
-    std::vector<ReceiveTXTroute> receiveTXTrouting;
-
-    WebSocketsServer wsockServer = WebSocketsServer(80);
-
-    OcppServer();
-    static OcppServer *instance;
-public:
-    static OcppServer *getInstance();
-
-    void loop();
-
-    void wsockEvent(WsClient num, WStype_t type, uint8_t * payload, size_t length);
-
-    void setReceiveTXTcallback(IPAddress &ip_addr, ReceiveTXTcallback &callback);
-
-    void removeReceiveTXTcallback(IPAddress &ip_addr);
-
-    bool sendTXT(IPAddress &ip_addr, std::string &out);
-};
-
-} //end namespace EspWiFi
-} //end namespace ArduinoOcpp
-#endif //ndef AO_CUSTOM_WS
-#endif
diff --git a/src/ArduinoOcpp/Core/OcppSocket.cpp b/src/ArduinoOcpp/Core/OcppSocket.cpp
index 223261a9..be8c0348 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.cpp
+++ b/src/ArduinoOcpp/Core/OcppSocket.cpp
@@ -1,9 +1,8 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppSocket.h>
-#include <ArduinoOcpp/Core/OcppServer.h>
 #include <ArduinoOcpp/Debug.h>
 
 #ifndef AO_CUSTOM_WS
@@ -67,25 +66,4 @@ unsigned long OcppClientSocket::getLastRecv() {
     return lastRecv;
 }
 
-OcppServerSocket::OcppServerSocket(IPAddress &ip_addr) : ip_addr(ip_addr) {
-    
-}
-
-OcppServerSocket::~OcppServerSocket() {
-    OcppServer::getInstance()->removeReceiveTXTcallback(this->ip_addr);
-}
-
-void OcppServerSocket::loop() {
-    //nothing here. The client must call the EspWiFi server loop function
-}
-
-bool OcppServerSocket::sendTXT(std::string &out) {
-    AO_DBG_TRAFFIC_OUT(out.c_str());
-    return OcppServer::getInstance()->sendTXT(ip_addr, out);
-}
-
-void OcppServerSocket::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
-    OcppServer::getInstance()->setReceiveTXTcallback(ip_addr, callback);
-}
-
 #endif
diff --git a/src/ArduinoOcpp/Core/OcppSocket.h b/src/ArduinoOcpp/Core/OcppSocket.h
index c8b8e12d..1a30a71a 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.h
+++ b/src/ArduinoOcpp/Core/OcppSocket.h
@@ -66,7 +66,6 @@ class OcppEchoSocket : public OcppSocket {
 #ifndef AO_CUSTOM_WS
 
 #include <WebSocketsClient.h>
-#include <WebSocketsServer.h>
 
 namespace ArduinoOcpp {
 namespace EspWiFi {
@@ -87,20 +86,6 @@ class OcppClientSocket : public OcppSocket {
     unsigned long getLastRecv(); //get time of last successful receive in millis
 };
 
-class OcppServerSocket : public OcppSocket {
-private:
-    IPAddress ip_addr;
-public:
-    OcppServerSocket(IPAddress &ip_addr);
-    ~OcppServerSocket();
-
-    void loop();
-
-    bool sendTXT(std::string &out);
-
-    void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT);
-};
-
 } //end namespace EspWiFi
 } //end namespace ArduinoOcpp
 #endif //ndef AO_CUSTOM_WS

From afa1c183cf070e48f899dc6f7a13e54362415fd4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Feb 2023 17:11:35 +0100
Subject: [PATCH 195/549] return op type instead of debug print

---
 src/ArduinoOcpp/Core/OcppConnection.cpp  | 3 +--
 src/ArduinoOcpp/Core/OcppOperation.cpp   | 8 ++------
 src/ArduinoOcpp/Core/OcppOperation.h     | 2 +-
 src/ArduinoOcpp/Core/OperationsQueue.cpp | 3 +--
 4 files changed, 5 insertions(+), 11 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 6c5f886d..7a9617d2 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -67,8 +67,7 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
         if (timer->isExceeded() &&
                 //dropping operations out-of-order is only possible if they do not own an opNr
                 (!(*cached)->getStorageHandler() || (*cached)->getStorageHandler()->getOpNr() < 0)) {
-            AO_DBG_INFO("Discarding cached due to timeout:");
-            (*cached)->print_debug();
+            AO_DBG_INFO("Discarding cached due to timeout: %s", (*cached)->getOcppOperationType());
             cached = initiatedOcppOperations->erase_tail(cached);
         } else {
             ++cached;
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 9f89cc59..7067dee5 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -448,10 +448,6 @@ void OcppOperation::rebaseMsgId(int msgIdCounter) {
     getMessageID(); //apply msgIdCounter to this operation
 }
 
-void OcppOperation::print_debug() {
-    if (ocppMessage) {
-        AO_CONSOLE_PRINTF("OcppOperation of type %s\n", ocppMessage->getOcppOperationType());
-    } else {
-        AO_CONSOLE_PRINTF("OcppOperation (no type)\n");
-    }
+void OcppOperation::getOcppOperationType() {
+    return ocppMessage ? ocppMessage->getOcppOperationType() : "UNDEFINED";
 }
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index 83be63cd..0f4a9407 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -137,7 +137,7 @@ class OcppOperation {
 
     void rebaseMsgId(int msgIdCounter); //workaround; remove when random UUID msg IDs are introduced
 
-    void print_debug();
+    const char *getOcppOperationType();
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index 565e1629..96fd3480 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -174,8 +174,7 @@ void PersistentOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
         head = std::move(op);
     } else {
         if (tailCache.size() >= AO_OPERATIONCACHE_MAXSIZE) {
-            AO_DBG_INFO("Replace cached operation (cache full): ");
-            tailCache.front()->print_debug();
+            AO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOcppOperationType();
             tailCache.pop_front();
         }
 

From 83d9599b757e64b61a54a4e2511e7c12f68d696b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Feb 2023 18:13:41 +0100
Subject: [PATCH 196/549] reorganise heap memory management

---
 src/ArduinoOcpp/Core/FilesystemUtils.h  |  4 --
 src/ArduinoOcpp/Core/OcppConnection.cpp | 61 +++++++++++++------------
 src/ArduinoOcpp/Core/OcppError.h        |  8 ++--
 src/ArduinoOcpp/Platform.h              | 14 ++----
 4 files changed, 41 insertions(+), 46 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.h b/src/ArduinoOcpp/Core/FilesystemUtils.h
index 7976261a..77cbc179 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.h
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.h
@@ -9,10 +9,6 @@
 #include <ArduinoJson.h>
 #include <memory>
 
-#ifndef AO_MAX_JSON_CAPACITY
-#define AO_MAX_JSON_CAPACITY 4096
-#endif
-
 namespace ArduinoOcpp {
 
 class ArduinoJsonFileAdapter {
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 7a9617d2..56a55754 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -11,8 +11,6 @@
 
 #include <ArduinoOcpp/Debug.h>
 
-#define HEAP_GUARD 2000UL //will not accept JSON messages if it will result in less than HEAP_GUARD free bytes in heap
-
 size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_size);
 
 using namespace ArduinoOcpp;
@@ -109,45 +107,50 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
 
     AO_DBG_TRAFFIC_IN((int) length, payload);
     
-    bool deserializationSuccess = false;
+    size_t capacity_init = (3 * length) / 2;
+
+    //capacity = ceil capacity_init to the next power of two; should be at least 128
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>{nullptr};
-    size_t capacity = length + 100;
+    size_t capacity = 128;
+    while (capacity < capacity_init && capacity < AO_MAX_JSON_CAPACITY) {
+        capacity *= 2;
+    }
+    if (capacity > AO_MAX_JSON_CAPACITY) {
+        capacity = AO_MAX_JSON_CAPACITY;
+    }
 
+    DynamicJsonDocument doc;
     DeserializationError err = DeserializationError::NoMemory;
-    while (capacity + HEAP_GUARD < ao_avail_heap() && err == DeserializationError::NoMemory) {
-        doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
-        err = deserializeJson(*doc, payload, length);
 
-        capacity *= 3;
-        capacity /= 2;
+    while (err == DeserializationError::NoMemory && capacity <= AO_MAX_JSON_CAPACITY) {
+
+        doc = DynamicJsonDocument(capacity);
+        err = deserializeJson(doc, payload, length);
+
+        capacity *= 2;
     }
 
-    //TODO insert validateRpcHeader at suitable position
+    bool success = false;
 
     switch (err.code()) {
         case DeserializationError::Ok:
-            if (doc != nullptr){
-                int messageTypeId = (*doc)[0] | -1;
+            int messageTypeId = doc[0] | -1;
                 switch(messageTypeId) {
                     case MESSAGE_TYPE_CALL:
-                        handleReqMessage(*doc);      
-                        deserializationSuccess = true;
+                    handleReqMessage(doc);      
+                    success = true;
                         break;
                     case MESSAGE_TYPE_CALLRESULT:
-                        handleConfMessage(*doc);
-                        deserializationSuccess = true;
+                    handleConfMessage(doc);
+                    success = true;
                         break;
                     case MESSAGE_TYPE_CALLERROR:
-                        handleErrMessage(*doc);
-                        deserializationSuccess = true;
+                    handleErrMessage(doc);
+                    success = true;
                         break;
                     default:
                         AO_DBG_WARN("Invalid OCPP message! (though JSON has successfully been deserialized)");
                         break;
-                }
-            } else { //unlikely corner case
-                AO_DBG_ERR("Deserialization is okay but doc is nullptr");
             }
             break;
         case DeserializationError::InvalidInput:
@@ -155,7 +158,7 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
             break;
         case DeserializationError::NoMemory:
             {
-                AO_DBG_WARN("OOP! Incoming operation exceeds reserved heap. Input length = %zu, free heap = %u", length, ao_avail_heap());
+                AO_DBG_WARN("OOP! Incoming operation exceeds reserved heap. Input length = %zu, max capacity = %d", length, AO_MAX_JSON_CAPACITY);
 
                 /*
                  * If websocket input is of message type MESSAGE_TYPE_CALL, send back a message of type MESSAGE_TYPE_CALLERROR.
@@ -163,16 +166,16 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
                  * If the input type is MESSAGE_TYPE_CALLRESULT, it can be ignored. This controller will automatically resend the corresponding request message.
                  */
 
-                doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(200));
+                doc =  DynamicJsonDocument(200);
                 char onlyRpcHeader[200];
                 size_t onlyRpcHeader_len = removePayload(payload, length, onlyRpcHeader, sizeof(onlyRpcHeader));
                 DeserializationError err2 = deserializeJson(*doc, onlyRpcHeader, onlyRpcHeader_len);
                 if (err2.code() == DeserializationError::Ok) {
-                    int messageTypeId2 = (*doc)[0] | -1;
+                    int messageTypeId2 = doc[0] | -1;
                     if (messageTypeId2 == MESSAGE_TYPE_CALL) {
-                        deserializationSuccess = true;
-                        auto op = makeOcppOperation(new OutOfMemory(ao_avail_heap(), length));
-                        handleReqMessage(*doc, std::move(op));
+                        success = true;
+                        auto op = makeOcppOperation(new OutOfMemory(AO_MAX_JSON_CAPACITY, length));
+                        handleReqMessage(doc, std::move(op));
                     }
                 }
             }
@@ -182,7 +185,7 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
             break;
     }
 
-    return deserializationSuccess;
+    return success;
 }
 
 /**
diff --git a/src/ArduinoOcpp/Core/OcppError.h b/src/ArduinoOcpp/Core/OcppError.h
index f29514e3..7c412a74 100644
--- a/src/ArduinoOcpp/Core/OcppError.h
+++ b/src/ArduinoOcpp/Core/OcppError.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPPERROR_H
@@ -20,10 +20,10 @@ class NotImplemented : public OcppMessage {
 
 class OutOfMemory : public OcppMessage {
 private:
-    uint32_t freeHeap;
+    size_t maxCapacity;
     size_t msgLen;
 public:
-    OutOfMemory(uint32_t freeHeap, size_t msgLen) : freeHeap(freeHeap), msgLen(msgLen) { }
+    OutOfMemory(size_t maxCapacity, size_t msgLen) : maxCapacity(maxCapacity), msgLen(msgLen) { }
     const char *getErrorCode() {
         return "InternalError";
     }
@@ -33,7 +33,7 @@ class OutOfMemory : public OcppMessage {
     std::unique_ptr<DynamicJsonDocument> getErrorDetails() {
         auto errDoc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
         JsonObject err = errDoc->to<JsonObject>();
-        err["free_heap"] = freeHeap;
+        err["max_capacity"] = maxCapacity;
         err["msg_length"] = msgLen;
         return errDoc;
     }
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 04fa5306..06385767 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -84,15 +84,11 @@ unsigned long ao_tick_ms_unix();
 #endif
 #endif
 
-#ifndef ao_avail_heap
-#if AO_PLATFORM == AO_PLATFORM_ARDUINO
-#include <Arduino.h>
-#define ao_avail_heap ESP.getFreeHeap
-#elif AO_PLATFORM == AO_PLATFORM_ESPIDF
-#include "freertos/FreeRTOS.h"
-#define ao_avail_heap xPortGetFreeHeapSize
-#elif AO_PLATFORM == AO_PLATFORM_UNIX
-#define ao_avail_heap(X) 1000000 //suppress this technique on unix
+#ifndef AO_MAX_JSON_CAPACITY
+#if AO_PLATFORM == AO_PLATFORM_UNIX
+#define AO_MAX_JSON_CAPACITY 16384
+#else
+#define AO_MAX_JSON_CAPACITY 4096
 #endif
 #endif
 

From e9b24e0fd2d09dc810b0b900b2f87a47dfdefac4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Feb 2023 19:03:27 +0100
Subject: [PATCH 197/549] refactor and simplify Timeouts

---
 CMakeLists.txt                                |  1 -
 src/ArduinoOcpp.cpp                           | 28 +++---
 src/ArduinoOcpp.h                             | 13 ++-
 src/ArduinoOcpp/Core/OcppConnection.cpp       | 79 +++++++----------
 src/ArduinoOcpp/Core/OcppOperation.cpp        | 56 +++++-------
 src/ArduinoOcpp/Core/OcppOperation.h          | 16 ++--
 src/ArduinoOcpp/Core/OcppOperationCallbacks.h |  8 +-
 src/ArduinoOcpp/Core/OcppOperationTimeout.cpp | 87 -------------------
 src/ArduinoOcpp/Core/OcppOperationTimeout.h   | 69 ---------------
 src/ArduinoOcpp/Core/OperationsQueue.cpp      |  3 +-
 .../Authorization/AuthorizationService.cpp    |  3 +-
 src/ArduinoOcpp/Tasks/Boot/BootService.cpp    |  2 +-
 .../ChargePointStatusService.cpp              |  2 +-
 .../Tasks/Metering/MeteringService.cpp        |  4 +-
 14 files changed, 94 insertions(+), 277 deletions(-)
 delete mode 100644 src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
 delete mode 100644 src/ArduinoOcpp/Core/OcppOperationTimeout.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index a5105b8a..d330eea2 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -16,7 +16,6 @@ set(AO_SRC
     src/ArduinoOcpp/Core/OcppMessage.cpp
     src/ArduinoOcpp/Core/OcppModel.cpp
     src/ArduinoOcpp/Core/OcppOperation.cpp
-    src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
     src/ArduinoOcpp/Core/OcppSocket.cpp
     src/ArduinoOcpp/Core/OcppTime.cpp
     src/ArduinoOcpp/Core/OperationsQueue.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index dde5e2cc..3b014859 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -199,7 +199,7 @@ void OCPP_loop() {
     ocppEngine->loop();
 }
 
-void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -210,10 +210,10 @@ void bootNotification(const char *chargePointModel, const char *chargePointVendo
     (*credentials)["chargePointModel"] = (char*) chargePointModel;
     (*credentials)["chargePointVendor"] = (char*) chargePointVendor;
 
-    bootNotification(std::move(credentials), onConf, onAbort, onTimeout, onError, std::move(timeout));
+    bootNotification(std::move(credentials), onConf, onAbort, onTimeout, onError, timeout);
 }
 
-void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -229,13 +229,13 @@ void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveCon
     if (onError)
         bootNotification->setOnReceiveErrorListener(onError);
     if (timeout)
-        bootNotification->setTimeout(std::move(timeout));
+        bootNotification->setTimeout(timeout);
     else
-        bootNotification->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
+        bootNotification->setTimeout(0);
     ocppEngine->initiateOperation(std::move(bootNotification));
 }
 
-void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -255,9 +255,9 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
     if (onError)
         authorize->setOnReceiveErrorListener(onError);
     if (timeout)
-        authorize->setTimeout(std::move(timeout));
+        authorize->setTimeout(timeout);
     else
-        authorize->setTimeout(std::unique_ptr<Timeout>(new FixedTimeout(20000)));
+        authorize->setTimeout(20000);
     ocppEngine->initiateOperation(std::move(authorize));
 }
 
@@ -659,7 +659,7 @@ void setOnResetRequest(OnReceiveReqListener onReceiveReq) {
 
 #define OCPP_ID_OF_CONNECTOR 1
 
-bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
@@ -700,15 +700,15 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
     if (onError)
         startTransaction->setOnReceiveErrorListener(onError);
     if (timeout)
-        startTransaction->setTimeout(std::move(timeout));
+        startTransaction->setTimeout(timeout);
     else
-        startTransaction->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
+        startTransaction->setTimeout(0);
     ocppEngine->initiateOperation(std::move(startTransaction));
 
     return true;
 }
 
-bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, std::unique_ptr<Timeout> timeout) {
+bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
@@ -745,9 +745,9 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
     if (onError)
         stopTransaction->setOnReceiveErrorListener(onError);
     if (timeout)
-        stopTransaction->setTimeout(std::move(timeout));
+        stopTransaction->setTimeout(timeout);
     else
-        stopTransaction->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
+        stopTransaction->setTimeout(0);
     ocppEngine->initiateOperation(std::move(stopTransaction));
 
     return true;
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 80f3fd27..37b3b1ed 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -12,7 +12,6 @@
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <ArduinoOcpp/Core/OcppOperationCallbacks.h>
-#include <ArduinoOcpp/Core/OcppOperationTimeout.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h>
@@ -25,8 +24,6 @@ using ArduinoOcpp::OnAbortListener;
 using ArduinoOcpp::OnTimeoutListener;
 using ArduinoOcpp::OnReceiveErrorListener;
 
-using ArduinoOcpp::Timeout;
-
 #ifndef AO_CUSTOM_WS
 //use links2004/WebSockets library
 
@@ -138,7 +135,7 @@ void bootNotification(
             OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
             OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
             OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
-            std::unique_ptr<Timeout> timeout = nullptr); //custom timeout behavior, optional
+            unsigned int timeout = 0); //custom timeout behavior, optional
 
 //Alternative version for sending a complete BootNotification payload
 void bootNotification(
@@ -147,7 +144,7 @@ void bootNotification(
             OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
             OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
             OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
-            std::unique_ptr<Timeout> timeout = nullptr); //custom timeout behavior, optional
+            unsigned int timeout = 0); //custom timeout behavior, optional
 
 void authorize(
             const char *idTag,                           //RFID tag (e.g. ISO 14443 UID tag with 4 or 7 bytes)
@@ -155,7 +152,7 @@ void authorize(
             OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
             OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
             OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
-            std::unique_ptr<Timeout> timeout = nullptr); //custom timeout behavior, optional
+            unsigned int timeout = 0); //custom timeout behavior, optional
 
 /*
  * Transaction management.
@@ -343,8 +340,8 @@ void setOnRemoteStopTransactionReceiveReq(OnReceiveReqListener onReceiveReq);
 
 void setOnResetSendConf(OnSendConfListener onSendConf);
 
-bool startTransaction(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+bool startTransaction(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, unsigned int timeout = 0);
 
-bool stopTransaction(OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, std::unique_ptr<Timeout> timeout = nullptr);
+bool stopTransaction(OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, unsigned int timeout = 0);
 
 #endif
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 56a55754..662bd84e 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -35,41 +35,25 @@ void OcppConnection::setSocket(OcppSocket& sock) {
 
 void OcppConnection::loop(OcppSocket& ocppSock) {
 
-    /**
-     * Work through the initiatedOcppOperations queue. Start with the first element by calling req() on it. If
-     * the operation is (still) pending, it will return false and therefore each other queued element must
-     * wait until this operation is over. If an ocppOperation is finished, it returns true on a req() call, 
-     * can be dequeued and the following ocppOperation is processed.
+    /*
+     * Sort out timed out operations
      */
-
-    auto inited = initiatedOcppOperations->front();
-    if (inited) {
-        bool timeout = inited->sendReq(ocppSock); //The only reason to dequeue elements here is when a timeout occurs. Normally
-        if (timeout){                                       //the Conf msg processing routine dequeues finished elements
-            initiatedOcppOperations->pop_front();
+    initiatedOcppOperations->drop_if([] (std::unique_ptr<OcppOperation>& op) -> bool {
+        bool timed_out = op->isTimeoutExceeded();
+        if (timed_out) {
+            AO_DBG_INFO("operation timeout: %s", op->getOcppOperationType());
+            op->executeTimeout();
         }
-    }
+        return timed_out;
+    });
 
-    /*
-     * Activate timeout detection on the msgs other than the first in the queue.
+    /**
+     * Send pending req message
      */
 
-    auto cached = initiatedOcppOperations->begin_tail();
-    while (cached != initiatedOcppOperations->end_tail()) {
-        Timeout *timer = (*cached)->getTimeout();
-        if (!timer) {
-            ++cached; //no timeouts, nothing to do in this iteration
-            continue;
-        }
-        timer->tick(false); //false: did not send a frame prior to calling tick
-        if (timer->isExceeded() &&
-                //dropping operations out-of-order is only possible if they do not own an opNr
-                (!(*cached)->getStorageHandler() || (*cached)->getStorageHandler()->getOpNr() < 0)) {
-            AO_DBG_INFO("Discarding cached due to timeout: %s", (*cached)->getOcppOperationType());
-            cached = initiatedOcppOperations->erase_tail(cached);
-        } else {
-            ++cached;
-        }
+    auto inited = initiatedOcppOperations->front();
+    if (inited) {
+        inited->sendReq(ocppSock);
     }
     
     /**
@@ -84,8 +68,8 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
             received = receivedOcppOperations.erase(received);
         } else {
             //There will be another attempt to send this conf message in a future loop call.
-            //Go on with the next element in the queue, which is now at receivedOcppOperations[i+1]
-            ++received; //TODO review: this makes confs out-of-order. But if the first Op fails because of lacking RAM, this could save the device. 
+            //Go on with the next element in the queue.
+            ++received; //this makes confs out-of-order. But if the first Op fails because of lacking RAM, this could save the device. 
         }
     }
 }
@@ -106,7 +90,7 @@ void OcppConnection::initiateOperation(std::unique_ptr<OcppOperation> o){
 bool OcppConnection::receiveMessage(const char* payload, size_t length) {
 
     AO_DBG_TRAFFIC_IN((int) length, payload);
-    
+
     size_t capacity_init = (3 * length) / 2;
 
     //capacity = ceil capacity_init to the next power of two; should be at least 128
@@ -118,8 +102,8 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
     if (capacity > AO_MAX_JSON_CAPACITY) {
         capacity = AO_MAX_JSON_CAPACITY;
     }
-
-    DynamicJsonDocument doc;
+    
+    DynamicJsonDocument doc {0};
     DeserializationError err = DeserializationError::NoMemory;
 
     while (err == DeserializationError::NoMemory && capacity <= AO_MAX_JSON_CAPACITY) {
@@ -133,26 +117,27 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
     bool success = false;
 
     switch (err.code()) {
-        case DeserializationError::Ok:
+        case DeserializationError::Ok: {
             int messageTypeId = doc[0] | -1;
-                switch(messageTypeId) {
-                    case MESSAGE_TYPE_CALL:
+            switch(messageTypeId) {
+                case MESSAGE_TYPE_CALL:
                     handleReqMessage(doc);      
                     success = true;
-                        break;
-                    case MESSAGE_TYPE_CALLRESULT:
+                    break;
+                case MESSAGE_TYPE_CALLRESULT:
                     handleConfMessage(doc);
                     success = true;
-                        break;
-                    case MESSAGE_TYPE_CALLERROR:
+                    break;
+                case MESSAGE_TYPE_CALLERROR:
                     handleErrMessage(doc);
                     success = true;
-                        break;
-                    default:
-                        AO_DBG_WARN("Invalid OCPP message! (though JSON has successfully been deserialized)");
-                        break;
+                    break;
+                default:
+                    AO_DBG_WARN("Invalid OCPP message! (though JSON has successfully been deserialized)");
+                    break;
             }
             break;
+        }
         case DeserializationError::InvalidInput:
             AO_DBG_WARN("Invalid input! Not a JSON");
             break;
@@ -169,7 +154,7 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
                 doc =  DynamicJsonDocument(200);
                 char onlyRpcHeader[200];
                 size_t onlyRpcHeader_len = removePayload(payload, length, onlyRpcHeader, sizeof(onlyRpcHeader));
-                DeserializationError err2 = deserializeJson(*doc, onlyRpcHeader, onlyRpcHeader_len);
+                DeserializationError err2 = deserializeJson(doc, onlyRpcHeader, onlyRpcHeader_len);
                 if (err2.code() == DeserializationError::Ok) {
                     int messageTypeId2 = doc[0] | -1;
                     if (messageTypeId2 == MESSAGE_TYPE_CALL) {
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 7067dee5..97deceda 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppOperation.h>
@@ -47,18 +47,20 @@ void OcppOperation::setOcppModel(std::shared_ptr<OcppModel> oModel) {
     ocppMessage->setOcppModel(oModel);
 }
 
-void OcppOperation::setTimeout(std::unique_ptr<Timeout> to){
-    if (!to){
-        AO_DBG_ERR("Passed nullptr! Ignore");
-        return;
-    }
-    timeout = std::move(to);
-    timeout->setOnTimeoutListener(onTimeoutListener);
-    timeout->setOnAbortListener(onAbortListener);
+void OcppOperation::setTimeout(unsigned long timeout) {
+    this->timeout_period = timeout;
+}
+
+bool OcppOperation::isTimeoutExceeded() {
+    return timed_out || (timeout_period && ao_tick_ms() - timeout_start >= timeout_period);
 }
 
-Timeout *OcppOperation::getTimeout() {
-    return timeout.get();
+void OcppOperation::executeTimeout() {
+    if (!timed_out) {
+        onTimeoutListener();
+        onAbortListener();
+    }
+    timed_out = true;
 }
 
 void OcppOperation::setMessageID(const std::string &id){
@@ -78,18 +80,7 @@ const std::string *OcppOperation::getMessageID() {
     return &messageID;
 }
 
-bool OcppOperation::sendReq(OcppSocket& ocppSocket){
-
-    /*
-     * timeout behaviour
-     * 
-     * if timeout, print out error message and treat this operation as completed (-> return true)
-     */
-    if (timeout->isExceeded()) {
-        //cancel this operation
-        AO_DBG_INFO("%s has timed out! Discard operation", ocppMessage->getOcppOperationType());
-        return true;
-    }
+void OcppOperation::sendReq(OcppSocket& ocppSocket){
 
     /*
      * retry behaviour
@@ -98,18 +89,20 @@ bool OcppOperation::sendReq(OcppSocket& ocppSocket){
      */
     if (ao_tick_ms() <= retry_start + RETRY_INTERVAL * retry_interval_mult) {
         //NO retry
-        return false;
+        return;
     }
+
     // Do retry. Increase timer by factor 2
-    if (RETRY_INTERVAL * retry_interval_mult * 2 <= RETRY_INTERVAL_MAX)
+    if (RETRY_INTERVAL * retry_interval_mult * 2 <= RETRY_INTERVAL_MAX) {
         retry_interval_mult *= 2;
+    }
 
     /*
      * Create the OCPP message
      */
     auto requestPayload = ocppMessage->createReq();
     if (!requestPayload) {
-        return false;
+        return;
     }
 
     /*
@@ -141,8 +134,6 @@ bool OcppOperation::sendReq(OcppSocket& ocppSocket){
     
     bool success = ocppSocket.sendTXT(out);
 
-    timeout->tick(success);
-
     if (success) {
         AO_DBG_TRAFFIC_OUT(out.c_str());
         retry_start = ao_tick_ms();
@@ -151,8 +142,6 @@ bool OcppOperation::sendReq(OcppSocket& ocppSocket){
         retry_start = 0;
         retry_interval_mult = 1;
     }
-
-    return false;
 }
 
 bool OcppOperation::receiveConf(JsonDocument& confJson){
@@ -201,7 +190,7 @@ bool OcppOperation::receiveError(JsonDocument& confJson){
         onAbortListener();
     } else {
         //restart operation
-        timeout->restart();
+        timeout_start = ao_tick_ms();
         retry_start = 0;
         retry_interval_mult = 1;
     }
@@ -314,6 +303,9 @@ bool OcppOperation::sendConf(OcppSocket& ocppSocket){
 }
 
 void OcppOperation::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
+
+    timeout_start = ao_tick_ms();
+
     if (ocppMessage) {
 
         /*
@@ -448,6 +440,6 @@ void OcppOperation::rebaseMsgId(int msgIdCounter) {
     getMessageID(); //apply msgIdCounter to this operation
 }
 
-void OcppOperation::getOcppOperationType() {
+const char *OcppOperation::getOcppOperationType() {
     return ocppMessage ? ocppMessage->getOcppOperationType() : "UNDEFINED";
 }
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index 0f4a9407..ebcd6434 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -34,7 +34,9 @@ class OcppOperation {
     OnAbortListener onAbortListener = [] () {};
     bool reqExecuted = false;
 
-    std::unique_ptr<Timeout> timeout{new OfflineSensitiveTimeout(40000)};
+    unsigned long timeout_start = 0;
+    unsigned long timeout_period = 40000;
+    bool timed_out = false;
 
     const unsigned long RETRY_INTERVAL = 3000; //in ms; first retry after ... ms; second retry after 2 * ... ms; third after 4 ...
     const unsigned long RETRY_INTERVAL_MAX = 20000; //in ms; 
@@ -56,9 +58,11 @@ class OcppOperation {
 
     void setOcppModel(std::shared_ptr<OcppModel> oModel);
 
-    void setTimeout(std::unique_ptr<Timeout> timeout);
+    void setTimeout(unsigned long timeout); //0 = disable timeout
 
-    Timeout *getTimeout();
+    bool isTimeoutExceeded();
+
+    void executeTimeout(); //call Timeout handler
 
     /**
      * Sends the message(s) that belong to the OCPP Operation. This function puts a JSON message on the lower protocol layer.
@@ -66,11 +70,9 @@ class OcppOperation {
      * For instance operation Authorize: sends Authorize.req(idTag)
      * 
      * This function is usually called multiple times by the Arduino loop(). On first call, the request is initially sent. In the
-     * succeeding calls, the implementers decide to either resend the request, or do nothing as the operation is still pending. When
-     * the operation is completed (for example when conf() has been called), return true. When the operation is still pending, return
-     * false.
+     * succeeding calls, the implementers decide to either resend the request, or do nothing as the operation is still pending.
      */
-    bool sendReq(OcppSocket& ocppSocket);
+    void sendReq(OcppSocket& ocppSocket);
 
    /**
     * Decides if message belongs to this operation instance and if yes, proccesses it. For example, multiple instances of an
diff --git a/src/ArduinoOcpp/Core/OcppOperationCallbacks.h b/src/ArduinoOcpp/Core/OcppOperationCallbacks.h
index 957458a6..16e36f4e 100644
--- a/src/ArduinoOcpp/Core/OcppOperationCallbacks.h
+++ b/src/ArduinoOcpp/Core/OcppOperationCallbacks.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPP_OPERATION_CALLBACKS
@@ -8,16 +8,14 @@
 #include <ArduinoJson.h>
 #include <functional>
 
-#include <ArduinoOcpp/Core/OcppOperationTimeout.h>
-
 namespace ArduinoOcpp {
 
 using OnReceiveConfListener = std::function<void(JsonObject payload)>;
 using OnReceiveReqListener = std::function<void(JsonObject payload)>;
 using OnSendConfListener = std::function<void(JsonObject payload)>;
-//using OnTimeoutListener = std::function<void()>; //in OcppOperationTimeout. Workaround for circle include. Fix by extracting type definitions to new source file
+using OnTimeoutListener = std::function<void()>;
 using OnReceiveErrorListener = std::function<void(const char *code, const char *description, JsonObject details)>; //will be called if OCPP communication partner returns error code
-//using OnAbortListener = std::function<void()>; //will be called whenever the engine will stop trying to execute the operation normallythere is a timeout or error (onAbort = onTimeout || onReceiveError)
+using OnAbortListener = std::function<void()>; //will be called whenever the engine will stop trying to execute the operation normallythere is a timeout or error (onAbort = onTimeout || onReceiveError)
 
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/OcppOperationTimeout.cpp b/src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
deleted file mode 100644
index cd1eb25a..00000000
--- a/src/ArduinoOcpp/Core/OcppOperationTimeout.cpp
+++ /dev/null
@@ -1,87 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#include <ArduinoOcpp/Core/OcppOperationTimeout.h>
-#include <ArduinoOcpp/Platform.h>
-
-using namespace ArduinoOcpp;
-
-void Timeout::setOnTimeoutListener(OnTimeoutListener onTimeout) {
-    if (onTimeout)
-        onTimeoutListener = onTimeout;
-}
-
-void Timeout::setOnAbortListener(OnAbortListener onAbort) {
-    if (onAbort)
-        onAbortListener = onAbort;
-}
-
-void Timeout::trigger() {
-    if (!triggered && timerIsExceeded()) {
-        triggered = true;
-        onTimeoutListener();
-        onAbortListener();
-    }
-}
-void Timeout::tick(bool sendingSuccessful) {
-    timerTick(sendingSuccessful);
-    trigger();
-}
-void Timeout::restart() {
-    triggered = false;
-    timerRestart();
-}
-bool Timeout::isExceeded() {
-    bool exceeded = timerIsExceeded();
-    trigger();
-    return exceeded;
-}
-
-FixedTimeout::FixedTimeout(unsigned long TIMEOUT_DURATION) : TIMEOUT_DURATION(TIMEOUT_DURATION) { 
-    timeout_active = false;
-}
-
-void FixedTimeout::timerTick(bool sendingSuccessful) {
-    if (!timeout_active) {
-        timeout_active = true;
-        timeout_start = ao_tick_ms();
-    }
-}
-void FixedTimeout::timerRestart() {
-    timeout_start = ao_tick_ms();
-    timeout_active = false;
-}
-bool FixedTimeout::timerIsExceeded() {
-    return timeout_active && ao_tick_ms() - timeout_start >= TIMEOUT_DURATION;
-}
-
-
-OfflineSensitiveTimeout::OfflineSensitiveTimeout(unsigned long TIMEOUT_DURATION) : TIMEOUT_DURATION(TIMEOUT_DURATION) { 
-    timeout_active = false;
-}
-
-void OfflineSensitiveTimeout::timerTick(bool sendingSuccessful) {
-    unsigned long t = ao_tick_ms();
-    
-    if (!timeout_active) {
-        timeout_active = true;
-        timeout_start = t;
-        last_tick = t;
-    } else {
-        if (!sendingSuccessful) {
-            timeout_start += t - last_tick;
-        }
-    }
-
-    last_tick = t;
-}
-void OfflineSensitiveTimeout::timerRestart() {
-    unsigned long t = ao_tick_ms();
-    timeout_start = t;
-    last_tick = t;
-    timeout_active = false;
-}
-bool OfflineSensitiveTimeout::timerIsExceeded() {
-    return timeout_active && ao_tick_ms() - timeout_start >= TIMEOUT_DURATION;
-}
diff --git a/src/ArduinoOcpp/Core/OcppOperationTimeout.h b/src/ArduinoOcpp/Core/OcppOperationTimeout.h
deleted file mode 100644
index a6a2f0c6..00000000
--- a/src/ArduinoOcpp/Core/OcppOperationTimeout.h
+++ /dev/null
@@ -1,69 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#ifndef OCPPOPERATIONTIMEOUT_H
-#define OCPPOPERATIONTIMEOUT_H
-
-#include <functional>
-
-namespace ArduinoOcpp {
-
-using OnTimeoutListener = std::function<void()>;
-using OnAbortListener = std::function<void()>;
-
-class Timeout {
-private:
-    OnTimeoutListener onTimeoutListener = [] () {};
-    OnAbortListener onAbortListener = [] () {};
-    bool triggered = false;
-    void trigger();
-protected:
-    Timeout() = default;
-public:
-    void setOnTimeoutListener(OnTimeoutListener onTimeoutListener);
-    void setOnAbortListener(OnAbortListener onAbortListener);
-    virtual ~Timeout() = default;
-    void tick(bool sendingSuccessful);
-    virtual void timerTick(bool sendingSuccessful) = 0;
-    void restart();
-    virtual void timerRestart() = 0;
-    bool isExceeded();
-    virtual bool timerIsExceeded() = 0;
-};
-
-class FixedTimeout : public Timeout {
-private:
-    unsigned long TIMEOUT_DURATION;
-    unsigned long timeout_start;
-    bool timeout_active;
-public:
-    FixedTimeout(unsigned long TIMEOUT_EXPIRE);
-    void timerTick(bool sendingSuccessful);
-    void timerRestart();
-    bool timerIsExceeded();
-};
-
-class OfflineSensitiveTimeout : public Timeout {
-private:
-    unsigned long TIMEOUT_DURATION;
-    unsigned long timeout_start;
-    unsigned long last_tick;
-    bool timeout_active;
-public:
-    OfflineSensitiveTimeout(unsigned long TIMEOUT_EXPIRE);
-    void timerTick(bool sendingSuccessful);
-    void timerRestart();
-    bool timerIsExceeded();
-};
-
-class SuppressedTimeout : public Timeout {
-public:
-    SuppressedTimeout() = default;
-    void timerTick(bool sendingSuccessful) {}
-    void timerRestart() {}
-    bool timerIsExceeded() {return false;}
-};
-
-} //end namespace ArduinoOcpp
-#endif
\ No newline at end of file
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index 96fd3480..5634d1e7 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -174,7 +174,8 @@ void PersistentOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
         head = std::move(op);
     } else {
         if (tailCache.size() >= AO_OPERATIONCACHE_MAXSIZE) {
-            AO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOcppOperationType();
+            AO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOcppOperationType());
+            tailCache.front()->executeTimeout();
             tailCache.pop_front();
         }
 
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index 9845d9a9..3d39ead8 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -7,7 +7,6 @@
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/Core/OcppOperationTimeout.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -183,7 +182,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
                     context.getOcppModel().getOcppTime().getOcppTimestampNow(),
                     "LocalListConflict"));
 
-        statusNotification->setTimeout(std::unique_ptr<Timeout>(new FixedTimeout(60000)));
+        statusNotification->setTimeout(60000);
 
         context.initiateOperation(std::move(statusNotification));
     }
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
index 8fa433ea..0226dd35 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
@@ -62,7 +62,7 @@ void BootService::loop() {
      * this class and notify this class about the response
      */
     auto bootNotification = makeOcppOperation(new Ocpp16::BootNotification());
-    bootNotification->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
+    bootNotification->setTimeout(0);
     context.initiatePreBootOperation(std::move(bootNotification));
 
     lastBootNotification = ao_tick_ms();
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 781ee4b6..97ba992d 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -63,7 +63,7 @@ void ChargePointStatusService::loop() {
         auto transactionMsg = (*connector)->loop();
         if (transactionMsg != nullptr) {
             auto transactionOp = makeOcppOperation(transactionMsg);
-            transactionOp->setTimeout(std::unique_ptr<Timeout>(new SuppressedTimeout()));
+            transactionOp->setTimeout(0);
             context.initiateOperation(std::move(transactionOp));
         }
     }
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index 1bc2acb8..39b86905 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -25,7 +25,7 @@ void MeteringService::loop(){
         auto meterValuesMsg = connectors[i]->loop();
         if (meterValuesMsg != nullptr) {
             auto meterValues = makeOcppOperation(meterValuesMsg);
-            meterValues->setTimeout(std::unique_ptr<Timeout>{new FixedTimeout(120000)});
+            meterValues->setTimeout(120000);
             context.initiateOperation(std::move(meterValues));
         }
     }
@@ -73,7 +73,7 @@ std::unique_ptr<OcppOperation> MeteringService::takeTriggeredMeterValues(int con
         auto msg = connector->takeTriggeredMeterValues();
         if (msg) {
             auto meterValues = makeOcppOperation(msg);
-            meterValues->setTimeout(std::unique_ptr<Timeout>{new FixedTimeout(120000)});
+            meterValues->setTimeout(120000);
             return meterValues;
         }
         AO_DBG_DEBUG("Did not take any samples for connectorId %d", connectorId);

From c034f63165cb966a585c0ca231c6857d21297e23 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 Feb 2023 19:06:42 +0100
Subject: [PATCH 198/549] remove unused functions

---
 src/ArduinoOcpp/Core/OperationsQueue.cpp | 25 ------------------------
 src/ArduinoOcpp/Core/OperationsQueue.h   |  9 ---------
 2 files changed, 34 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index 5634d1e7..c4e3ed4d 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -48,19 +48,6 @@ void VolatileOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
     queue.push_back(std::move(op));
 }
 
-std::deque<std::unique_ptr<OcppOperation>>::iterator VolatileOperationsQueue::begin_tail() {
-    if (queue.begin() != queue.end()) {
-        return queue.begin() + 1;
-    } else {
-        return queue.end();
-    }
-}
-std::deque<std::unique_ptr<OcppOperation>>::iterator VolatileOperationsQueue::end_tail() {
-    return queue.end();
-}
-std::deque<std::unique_ptr<OcppOperation>>::iterator VolatileOperationsQueue::erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) {
-    return queue.erase(el);
-}
 void VolatileOperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) {
     queue.erase(std::remove_if(queue.begin(), queue.end(), pred), queue.end());
 }
@@ -191,15 +178,3 @@ void PersistentOperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppO
 
     tailCache.erase(std::remove_if(tailCache.begin(), tailCache.end(), pred), tailCache.end());
 }
-
-std::deque<std::unique_ptr<OcppOperation>>::iterator PersistentOperationsQueue::begin_tail() {
-    return tailCache.begin();
-}
-
-std::deque<std::unique_ptr<OcppOperation>>::iterator PersistentOperationsQueue::end_tail() {
-    return tailCache.end();
-}
-
-std::deque<std::unique_ptr<OcppOperation>>::iterator PersistentOperationsQueue::erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) {
-    return tailCache.erase(el);
-}
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.h b/src/ArduinoOcpp/Core/OperationsQueue.h
index ec46b5eb..b92082a7 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.h
+++ b/src/ArduinoOcpp/Core/OperationsQueue.h
@@ -26,9 +26,6 @@ class OperationsQueue {
 
     virtual void initiate(std::unique_ptr<OcppOperation> op) = 0;
 
-    virtual std::deque<std::unique_ptr<OcppOperation>>::iterator begin_tail() = 0; //iterator for all cached elements except head
-    virtual std::deque<std::unique_ptr<OcppOperation>>::iterator end_tail() = 0;
-    virtual std::deque<std::unique_ptr<OcppOperation>>::iterator erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) = 0;
     virtual void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) = 0; //drops operations from this queue where pred(operation) == true. Executes pred in order
 };
 
@@ -44,9 +41,6 @@ class VolatileOperationsQueue : public OperationsQueue {
 
     void initiate(std::unique_ptr<OcppOperation> op) override;
 
-    std::deque<std::unique_ptr<OcppOperation>>::iterator begin_tail() override; //iterator for all cached elements except head
-    std::deque<std::unique_ptr<OcppOperation>>::iterator end_tail() override;
-    std::deque<std::unique_ptr<OcppOperation>>::iterator erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) override;
     void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
 };
 
@@ -67,9 +61,6 @@ class PersistentOperationsQueue : public OperationsQueue {
 
     void initiate(std::unique_ptr<OcppOperation> op) override;
 
-    std::deque<std::unique_ptr<OcppOperation>>::iterator begin_tail() override; //iterator for all cached elements except head
-    std::deque<std::unique_ptr<OcppOperation>>::iterator end_tail() override;
-    std::deque<std::unique_ptr<OcppOperation>>::iterator erase_tail(std::deque<std::unique_ptr<OcppOperation>>::iterator el) override;
     void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
 
 };

From ff7b44bc49822d77272168f314871f0a64bdd06b Mon Sep 17 00:00:00 2001
From: pedro-fuoco <pedrofuoco6@gmail.com>
Date: Wed, 15 Mar 2023 18:27:56 -0300
Subject: [PATCH 199/549] float deserializer on AddMeterValue

---
 src/ArduinoOcpp.cpp                           |  8 ++++----
 src/ArduinoOcpp.h                             |  2 +-
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h | 13 +++++++++++++
 3 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index ff66cd90..e096d920 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -412,7 +412,7 @@ void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned in
     connector->addConnectorErrorCodeSampler(errorCodeInput);
 }
 
-void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
+void addMeterValueInput(std::function<float ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -438,10 +438,10 @@ void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measur
     if (phase)
         properties.setPhase(phase);
 
-    auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
-                                    new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
+    auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<float, ArduinoOcpp::SampledValueDeSerializer<float>>>(
+                                    new ArduinoOcpp::SampledValueSamplerConcrete<float, ArduinoOcpp::SampledValueDeSerializer<float>>(
                 properties,
-                [valueInput] (ArduinoOcpp::ReadingContext) -> int32_t {return valueInput();}));
+                [valueInput] (ArduinoOcpp::ReadingContext) {return valueInput();}));
     addMeterValueInput(std::move(valueSampler), connectorId);
 }
 
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index e0039efe..38a97913 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -206,7 +206,7 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
 
 void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned int connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
 
-void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr, unsigned int connectorId = 1); //integrate further metering Inputs
+void addMeterValueInput(std::function<float ()> valueInput, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr, unsigned int connectorId = 1); //integrate further metering Inputs
 
 void addMeterValueInput(std::unique_ptr<ArduinoOcpp::SampledValueSampler> valueInput, unsigned int connectorId = 1); //integrate further metering Inputs (more extensive alternative)
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
index 6e5f1867..ea9a007d 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -33,6 +33,19 @@ class SampledValueDeSerializer<int32_t> { // example class
     static int32_t toInteger(int32_t& val) {return val;}
 };
 
+template <>
+class SampledValueDeSerializer<float> { // Used in meterValues
+public:
+    static float deserialize(const char *str) {return atof(str);}
+    static bool ready(float& val) {return true;} //float is always valid
+    static std::string serialize(float& val) {
+        char str[20];
+        dtostrf(val,4,9,str);
+        return std::string(str);
+    }
+    static int32_t toInteger(float& val) {return (int32_t) val;}
+};
+
 class SampledValueProperties {
 private:
     std::string format;

From d7d223ebb3f5a11a0958bb4e3b6628299d01874d Mon Sep 17 00:00:00 2001
From: pedro-fuoco <pedrofuoco6@gmail.com>
Date: Wed, 15 Mar 2023 19:22:41 -0300
Subject: [PATCH 200/549] SSL and authentication on OCPP_initialize

---
 src/ArduinoOcpp.cpp | 9 ++++++---
 src/ArduinoOcpp.h   | 3 +++
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index ff66cd90..15b126cd 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -52,7 +52,7 @@ using namespace ArduinoOcpp::Facade;
 using namespace ArduinoOcpp::Ocpp16;
 
 #ifndef AO_CUSTOM_WS
-void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
+void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *login, const char *password, const char *fingerprint, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
     if (ocppEngine) {
         AO_DBG_WARN("Can't be called two times. Either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -61,8 +61,8 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     if (!webSocket)
         webSocket = new WebSocketsClient();
 
-    // server address, port and URL
-    webSocket->begin(CS_hostname, CS_port, CS_url, "ocpp1.6");
+    // server address, port, URL and SSL fingerprint
+    webSocket->beginSSL(CS_hostname, CS_port, CS_url, fingerprint, "ocpp1.6");
 
     // try ever 5000 again if connection has failed
     webSocket->setReconnectInterval(5000);
@@ -73,6 +73,9 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     // consider connection disconnected if pong is not received 2 times
     webSocket->enableHeartbeat(15000, 3000, 2); //comment this one out to for specific OCPP servers
 
+    // add authentication data (optional)
+    webSocket->setAuthorization(login, password);
+
     delete ocppSocket;
     ocppSocket = new EspWiFi::OcppClientSocket(webSocket);
 
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index e0039efe..735632d2 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -44,6 +44,9 @@ void OCPP_initialize(
             const char *CS_hostname, //e.g. "example.com"
             uint16_t CS_port,        //e.g. 80
             const char *CS_url,      //e.g. "ws://example.com/steve/websocket/CentralSystemService/charger001"
+            const char *login = "", //login present in the websocket message header
+            const char *password = "", //password present in the websocket message header
+            const char *fingerprint = "", //SSL fingerprint
             float V_eff = 230.f,     //Grid voltage of your country. e.g. 230.f (European voltage)
             ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 #endif

From 9ac49b3181f60801b6342e63de288659bbb271e0 Mon Sep 17 00:00:00 2001
From: pedro-fuoco <pedrofuoco6@gmail.com>
Date: Wed, 15 Mar 2023 19:47:23 -0300
Subject: [PATCH 201/549] float deserializer on setPowerMeterInput and
 setEnergyMeterInput

---
 src/ArduinoOcpp.cpp | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index e096d920..248845d4 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -324,8 +324,8 @@ void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connec
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Energy.Active.Import.Register");
     meterProperties.setUnit("Wh");
-    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
-                           new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
+    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<float, SampledValueDeSerializer<float>>>(
+                           new SampledValueSamplerConcrete<float, SampledValueDeSerializer<float>>(
             meterProperties,
             [energyInput] (ReadingContext) {return energyInput();}
     ));
@@ -347,8 +347,8 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Power.Active.Import");
     meterProperties.setUnit("W");
-    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
-                           new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
+    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<float, SampledValueDeSerializer<float>>>(
+                           new SampledValueSamplerConcrete<float, SampledValueDeSerializer<float>>(
             meterProperties,
             [powerInput] (ReadingContext) {return powerInput();}
     ));

From 34fa61b850c978d191dcfeb17eb3f1eaf7025b72 Mon Sep 17 00:00:00 2001
From: pedro-fuoco <pedrofuoco6@gmail.com>
Date: Tue, 21 Mar 2023 14:26:33 -0300
Subject: [PATCH 202/549] Using TLS based on url

---
 src/ArduinoOcpp.cpp | 14 +++++++++++---
 src/ArduinoOcpp.h   |  2 +-
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 15b126cd..1812287b 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -52,7 +52,7 @@ using namespace ArduinoOcpp::Facade;
 using namespace ArduinoOcpp::Ocpp16;
 
 #ifndef AO_CUSTOM_WS
-void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *login, const char *password, const char *fingerprint, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
+void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *login, const char *password, const char *CA_cert, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
     if (ocppEngine) {
         AO_DBG_WARN("Can't be called two times. Either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -61,8 +61,16 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     if (!webSocket)
         webSocket = new WebSocketsClient();
 
-    // server address, port, URL and SSL fingerprint
-    webSocket->beginSSL(CS_hostname, CS_port, CS_url, fingerprint, "ocpp1.6");
+    if (!strncmp(CS_url,"wss",3) || !strncmp(CS_url,"https",5))
+    {
+        // server address, port, URL and TLS certificate
+        webSocket->beginSslWithCA(CS_hostname, CS_port, CS_url, CA_cert, "ocpp1.6");
+    }
+    else
+    {
+        // server address, port, URL
+        webSocket->begin(CS_hostname, CS_port, CS_url, "ocpp1.6");
+    }
 
     // try ever 5000 again if connection has failed
     webSocket->setReconnectInterval(5000);
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 735632d2..ea0283df 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -46,7 +46,7 @@ void OCPP_initialize(
             const char *CS_url,      //e.g. "ws://example.com/steve/websocket/CentralSystemService/charger001"
             const char *login = "", //login present in the websocket message header
             const char *password = "", //password present in the websocket message header
-            const char *fingerprint = "", //SSL fingerprint
+            const char *CA_cert = NULL, //TLS certificate
             float V_eff = 230.f,     //Grid voltage of your country. e.g. 230.f (European voltage)
             ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 #endif

From 5b74c47e8ccbfcd0a697f5556d0d5da79ffb94dd Mon Sep 17 00:00:00 2001
From: Fbisinger <flobisi@gmx.de>
Date: Sat, 25 Mar 2023 21:27:02 +0100
Subject: [PATCH 203/549] fix pwm configuration for esp32 in secc example

---
 examples/SECC/main.cpp | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/examples/SECC/main.cpp b/examples/SECC/main.cpp
index ff98eb57..d1c3aaa1 100644
--- a/examples/SECC/main.cpp
+++ b/examples/SECC/main.cpp
@@ -25,6 +25,9 @@
  * Interface to the SECC (Supply Equipment Communication Controller, e.g. the SAE J1772 module)
  */
 #define AMPERAGE_PIN 4 //modulated as PWM
+#if defined(ESP32)
+#define PWM_CHANNEL 0 //PWM channel (only for ESP32)
+#endif
 
 #define EV_PLUG_PIN 14 // Input pin | Read if an EV is connected to the EVSE
 #if defined(ESP32)
@@ -132,9 +135,9 @@ void setup() {
     pinMode(AMPERAGE_PIN, OUTPUT);
 #if defined(ESP32)
     pinMode(AMPERAGE_PIN, OUTPUT);
-    ledcSetup(0, 1000, 8); //channel=0, freq=1000Hz, range=(2^8)-1
-    ledcAttachPin(AMPERAGE_PIN, 0);
-    ledcWrite(AMPERAGE_PIN, 256); //256 is constant +3.3V DC
+    ledcSetup(PWM_CHANNEL, 1000, 8); //channel=PWM_CHANNEL, freq=1000Hz, range=(2^8)-1
+    ledcAttachPin(AMPERAGE_PIN, PWM_CHANNEL); //pin, channel
+    ledcWrite(PWM_CHANNEL, 256); //channel, duty cycle (256 is constant +3.3V DC)
 #elif defined(ESP8266)
     analogWriteRange(255); //range=(2^8)-1
     analogWriteFreq(1000); //freq=1000Hz
@@ -257,7 +260,7 @@ void setup() {
         }
 
 #if defined(ESP32)
-        ledcWrite(AMPERAGE_PIN, pwmVal);
+        ledcWrite(PWM_CHANNEL, pwmVal);
 #elif defined(ESP8266)
         analogWrite(AMPERAGE_PIN, pwmVal);
 #endif

From 67445488325faacd7a9750419176bb9c66be4573 Mon Sep 17 00:00:00 2001
From: Fbisinger <flobisi@gmx.de>
Date: Sat, 25 Mar 2023 21:29:46 +0100
Subject: [PATCH 204/549] update readme

---
 examples/SECC/README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/examples/SECC/README.md b/examples/SECC/README.md
index e1f7a7b5..8543d558 100644
--- a/examples/SECC/README.md
+++ b/examples/SECC/README.md
@@ -6,17 +6,17 @@ With this sketch you can use an ESP8266/ESP32 as the central control unit of an
 
 The communication controller can connect to an SAE&nbsp;J1772 driver using the GPIO pins of the ESP. Furthermore, it can show the online status and charge point availability status via status LEDs. Displays, RFID readers or energy meters are not supported, though for your project you can integrate further HW components of course.
 
-You can find the interface descriptions in `main.ino`. Please be aware that although this program modulates the maximum charge rate with PWM analogous to the SAE&nbsp;J1772 standard, the PWM signal does not reflect the EVSE state. The latter is encoded via the other GPIO pins.
+You can find the interface descriptions in `main.cpp`. Please be aware that although this program modulates the maximum charge rate with PWM analogous to the SAE&nbsp;J1772 standard, the PWM signal does not reflect the EVSE state. The latter is encoded via the other GPIO pins.
 
 ## Usage
 
 - Create an empty project in the PlatformIO IDE.
 - Copy the `platformio.ini` from this directory to your root directory. Alternatively, just add `https://github.com/tzapu/WiFiManager.git` to the lib_deps of your `platformio.ini`.
-- Copy the `main.ino` from this example folder into your source directory. Adapt the pinout settings if needed.
+- Copy the `main.cpp` from this example folder into your source directory. Adapt the pinout settings if needed.
 - Finished. You should be able to compile and upload the sketch onto your ESP.
 
 When booting, the ESP opens up the Wi-Fi configuration portal. Please connect your PC to the network with the SSID `EVSE-Config` within the first 30s of the boot routine of the ESP (the portal has a timeout). The passphrase is `evse1234`.
 
 ## Standalone mode
 
-If you just want to check out ArduinoOcpp you can run this sketch on an ESP without any peripherals. The pinout of the ESP8266-NodeMCU&nbsp;board is already fully configured in `main.ino` so that board is the most convenient to start testing.
+If you just want to check out ArduinoOcpp you can run this sketch on an ESP without any peripherals. The pinout of the ESP8266-NodeMCU&nbsp;board is already fully configured in `main.cpp` so that board is the most convenient to start testing.

From ee1671ad58aeae406f1ad32dfd342ee6b44d5d0d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 26 Mar 2023 14:00:44 +0200
Subject: [PATCH 205/549] refactor RPC queue

---
 CMakeLists.txt                                |   1 +
 src/ArduinoOcpp.cpp                           |  79 ++++-
 src/ArduinoOcpp/Core/OcppConnection.cpp       | 220 +++++++------
 src/ArduinoOcpp/Core/OcppConnection.h         |  22 +-
 src/ArduinoOcpp/Core/OcppEngine.cpp           |  14 +-
 src/ArduinoOcpp/Core/OcppEngine.h             |   5 +
 src/ArduinoOcpp/Core/OcppError.h              |  21 +-
 src/ArduinoOcpp/Core/OcppMessage.cpp          |  11 +-
 src/ArduinoOcpp/Core/OcppMessage.h            |  19 +-
 src/ArduinoOcpp/Core/OcppOperation.cpp        | 282 +++++++----------
 src/ArduinoOcpp/Core/OcppOperation.h          |  41 +--
 src/ArduinoOcpp/Core/OcppOperationCallbacks.h |   1 -
 src/ArduinoOcpp/Core/OperationsQueue.cpp      |   5 -
 src/ArduinoOcpp/MessagesV16/Authorize.cpp     |   6 +-
 src/ArduinoOcpp/MessagesV16/Authorize.h       |   8 +-
 .../MessagesV16/BootNotification.cpp          |  68 +---
 .../MessagesV16/BootNotification.h            |  10 +-
 .../MessagesV16/CancelReservation.cpp         |   6 +-
 .../MessagesV16/CancelReservation.h           |   6 +-
 .../MessagesV16/ChangeAvailability.cpp        |   8 +-
 .../MessagesV16/ChangeAvailability.h          |   8 +-
 .../MessagesV16/ClearChargingProfile.cpp      |  14 +-
 .../MessagesV16/ClearChargingProfile.h        |  12 +-
 .../DiagnosticsStatusNotification.cpp         |  11 +-
 .../DiagnosticsStatusNotification.h           |   6 +-
 .../FirmwareStatusNotification.cpp            |  11 +-
 .../MessagesV16/FirmwareStatusNotification.h  |   6 +-
 .../MessagesV16/GetCompositeSchedule.cpp      |  24 +-
 .../MessagesV16/GetCompositeSchedule.h        |   8 +-
 .../MessagesV16/GetDiagnostics.cpp            |   8 +-
 src/ArduinoOcpp/MessagesV16/GetDiagnostics.h  |   8 +-
 .../MessagesV16/GetLocalListVersion.cpp       |   6 +-
 .../MessagesV16/GetLocalListVersion.h         |   7 +-
 src/ArduinoOcpp/MessagesV16/Heartbeat.cpp     |  16 +-
 src/ArduinoOcpp/MessagesV16/Heartbeat.h       |   9 +-
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp   |   6 +-
 src/ArduinoOcpp/MessagesV16/MeterValues.h     |   4 +-
 .../MessagesV16/RemoteStartTransaction.cpp    |  21 +-
 .../MessagesV16/RemoteStartTransaction.h      |   8 +-
 .../MessagesV16/RemoteStopTransaction.cpp     |   7 +-
 .../MessagesV16/RemoteStopTransaction.h       |   8 +-
 src/ArduinoOcpp/MessagesV16/ReserveNow.cpp    |  15 +-
 src/ArduinoOcpp/MessagesV16/ReserveNow.h      |   6 +-
 src/ArduinoOcpp/MessagesV16/Reset.cpp         |   7 +-
 src/ArduinoOcpp/MessagesV16/Reset.h           |   8 +-
 src/ArduinoOcpp/MessagesV16/SendLocalList.cpp |   8 +-
 src/ArduinoOcpp/MessagesV16/SendLocalList.h   |   6 +-
 .../MessagesV16/SetChargingProfile.cpp        |  14 +-
 .../MessagesV16/SetChargingProfile.h          |  10 +-
 .../MessagesV16/StartTransaction.cpp          |  61 +---
 .../MessagesV16/StartTransaction.h            |  13 +-
 .../MessagesV16/StatusNotification.cpp        |  36 ---
 .../MessagesV16/StatusNotification.h          |   6 +-
 .../MessagesV16/StopTransaction.cpp           |  61 +---
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |  15 +-
 .../MessagesV16/TriggerMessage.cpp            |  35 ++-
 src/ArduinoOcpp/MessagesV16/TriggerMessage.h  |   6 +-
 .../MessagesV16/UnlockConnector.cpp           |  10 +-
 src/ArduinoOcpp/MessagesV16/UnlockConnector.h |   8 +-
 .../MessagesV16/UpdateFirmware.cpp            |   7 +-
 src/ArduinoOcpp/MessagesV16/UpdateFirmware.h  |   8 +-
 src/ArduinoOcpp/OperationDeserializer.cpp     |  80 +++++
 src/ArduinoOcpp/OperationDeserializer.h       |  45 +++
 .../SimpleOcppOperationFactory.cpp            | 293 +-----------------
 src/ArduinoOcpp/SimpleOcppOperationFactory.h  |  30 +-
 .../Tasks/Authorization/AuthorizationList.cpp |  10 +-
 .../Authorization/AuthorizationService.cpp    |  15 +-
 src/ArduinoOcpp/Tasks/Boot/BootService.cpp    |  39 ++-
 src/ArduinoOcpp/Tasks/Boot/BootService.h      |   5 +-
 .../ChargePointStatusService.cpp              |  48 +++
 .../ChargePointStatus/ConnectorStatus.cpp     |   6 +-
 .../Tasks/Diagnostics/DiagnosticsService.cpp  |  10 +-
 .../FirmwareManagement/FirmwareService.cpp    |  11 +-
 .../Tasks/Heartbeat/HeartbeatService.cpp      |   8 +-
 .../Tasks/Heartbeat/HeartbeatService.h        |   2 +-
 .../Tasks/Metering/MeteringService.cpp        |  11 +-
 .../Tasks/Reservation/ReservationService.cpp  |  11 +-
 .../SmartCharging/SmartChargingService.cpp    |  12 +-
 tests/ChargingSessions.cpp                    |   9 +-
 79 files changed, 916 insertions(+), 1110 deletions(-)
 create mode 100644 src/ArduinoOcpp/OperationDeserializer.cpp
 create mode 100644 src/ArduinoOcpp/OperationDeserializer.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index d330eea2..9e66b668 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -50,6 +50,7 @@ set(AO_SRC
     src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
     src/ArduinoOcpp/Platform.cpp
     src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+    src/ArduinoOcpp/OperationDeserializer.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 3b014859..31f5f077 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -17,6 +17,7 @@
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Tasks/Boot/BootService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/OperationDeserializer.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
@@ -184,8 +185,6 @@ void OCPP_deinitialize() {
     webSocket = nullptr;
 #endif
 
-    simpleOcppFactory_deinitialize();
-
     fileSystemOpt = FilesystemOpt();
     voltage_eff = 230.f;
 }
@@ -218,8 +217,14 @@ void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveCon
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
+
+    //store credentials for later TriggerMessage
+    if (auto bootService = ocppEngine->getOcppModel().getBootService()) {
+        bootService->setChargePointCredentials(payload->as<JsonObject>());
+    }
+
     auto bootNotification = makeOcppOperation(
-        new BootNotification(std::move(payload)));
+        new BootNotification(ocppEngine->getOcppModel(), std::move(payload)));
     if (onConf)
         bootNotification->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -245,7 +250,7 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
         return;
     }
     auto authorize = makeOcppOperation(
-        new Authorize(idTag));
+        new Authorize(ocppEngine->getOcppModel(), idTag));
     if (onConf)
         authorize->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -634,27 +639,51 @@ OcppEngine *getOcppEngine() {
 }
 
 void setOnSetChargingProfileRequest(OnReceiveReqListener onReceiveReq) {
-     setOnSetChargingProfileRequestListener(onReceiveReq);
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    ocppEngine->getOperationDeserializer().setOnRequest("SetChargingProfile", onReceiveReq);
 }
 
 void setOnRemoteStartTransactionSendConf(OnSendConfListener onSendConf) {
-     setOnRemoteStartTransactionSendConfListener(onSendConf);
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    ocppEngine->getOperationDeserializer().setOnResponse("RemoteStartTransaction", onSendConf);
 }
 
 void setOnRemoteStopTransactionReceiveReq(OnReceiveReqListener onReceiveReq) {
-     setOnRemoteStopTransactionReceiveRequestListener(onReceiveReq);
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    ocppEngine->getOperationDeserializer().setOnRequest("RemoteStopTransaction", onReceiveReq);
 }
 
 void setOnRemoteStopTransactionSendConf(OnSendConfListener onSendConf) {
-     setOnRemoteStopTransactionSendConfListener(onSendConf);
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    ocppEngine->getOperationDeserializer().setOnResponse("RemoteStopTransaction", onSendConf);
 }
 
 void setOnResetSendConf(OnSendConfListener onSendConf) {
-     setOnResetSendConfListener(onSendConf);
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    ocppEngine->getOperationDeserializer().setOnResponse("Reset", onSendConf);
 }
 
 void setOnResetRequest(OnReceiveReqListener onReceiveReq) {
-     setOnResetReceiveRequestListener(onReceiveReq);
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    ocppEngine->getOperationDeserializer().setOnRequest("Reset", onReceiveReq);
 }
 
 #define OCPP_ID_OF_CONNECTOR 1
@@ -688,9 +717,22 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
             return false;
         }
     }
+
+    if (auto mService = ocppEngine->getOcppModel().getMeteringService()) {
+        auto meterStart = mService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionBegin);
+        if (meterStart && *meterStart) {
+            transaction->setMeterStart(meterStart->toInteger());
+        } else {
+            AO_DBG_ERR("MeterStart undefined");
+        }
+    }
+
+    transaction->setStartTimestamp(ocppEngine->getOcppModel().getOcppTime().getOcppTimestampNow());
+
+    transaction->commit();
     
     auto startTransaction = makeOcppOperation(
-        new StartTransaction(transaction));
+        new StartTransaction(ocppEngine->getOcppModel(), transaction));
     if (onConf)
         startTransaction->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -734,8 +776,21 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
     
     transaction->setStopReason("Local");
 
+    if (auto mService = ocppEngine->getOcppModel().getMeteringService()) {
+        auto meterStop = mService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
+        if (meterStop && *meterStop) {
+            transaction->setMeterStop(meterStop->toInteger());
+        } else {
+            AO_DBG_ERR("MeterStop undefined");
+        }
+    }
+
+    transaction->setStopTimestamp(ocppEngine->getOcppModel().getOcppTime().getOcppTimestampNow());
+
+    transaction->commit();
+
     auto stopTransaction = makeOcppOperation(
-        new StopTransaction(transaction));
+        new StopTransaction(ocppEngine->getOcppModel(), transaction));
     if (onConf)
         stopTransaction->setOnReceiveConfListener(onConf);
     if (onAbort)
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 662bd84e..0b153bdc 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -8,6 +8,7 @@
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/OcppError.h>
 #include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/OperationDeserializer.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -15,8 +16,8 @@ size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_siz
 
 using namespace ArduinoOcpp;
 
-OcppConnection::OcppConnection(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
-            : baseModel{baseModel}, filesystem{filesystem} {
+OcppConnection::OcppConnection(OperationDeserializer& operationDeserializer, std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
+            : operationDeserializer(operationDeserializer) {
     
     if (filesystem) {
         initiatedOcppOperations.reset(new PersistentOperationsQueue(baseModel, filesystem));
@@ -48,43 +49,83 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
     });
 
     /**
-     * Send pending req message
+     * Send and dequeue a pending confirmation message, if existing. If the first operation is awaiting,
+     * try with the subsequent operations.
+     * 
+     * If a message has been sent, terminate this loop() function.
      */
+    for (auto received = receivedOcppOperations.begin(); received != receivedOcppOperations.end(); ++received) {
+    
+        auto response = (*received)->createResponse();
 
-    auto inited = initiatedOcppOperations->front();
-    if (inited) {
-        inited->sendReq(ocppSock);
-    }
+        if (response) {
+            std::string out;
+            serializeJson(*response, out);
     
+            bool success = ocppSock.sendTXT(out);
+
+            if (success) {
+                AO_DBG_TRAFFIC_OUT(out.c_str());
+                received = receivedOcppOperations.erase(received);
+            }
+
+            return;
+        } //else: There will be another attempt to send this conf message in a future loop call.
+          //      Go on with the next element in the queue.
+    }
+
     /**
-     * Work through the receivedOcppOperations queue. Start with the first element by calling conf() on it. 
-     * If an ocppOperation is finished, it returns true on a conf() call, and is dequeued.
+     * Send pending req message
      */
+    auto initedOp = initiatedOcppOperations->front();
 
-    auto received = receivedOcppOperations.begin();
-    while (received != receivedOcppOperations.end()){
-        bool success = (*received)->sendConf(ocppSock);
-        if (success){
-            received = receivedOcppOperations.erase(received);
-        } else {
-            //There will be another attempt to send this conf message in a future loop call.
-            //Go on with the next element in the queue.
-            ++received; //this makes confs out-of-order. But if the first Op fails because of lacking RAM, this could save the device. 
-        }
+    if (!initedOp) {
+        //queue empty
+        return;
+    }
+
+    //check backoff time
+
+    if (initedOp->getTrialNo() == 0) {
+        //send immediately
+        sendBackoffPeriod = 0;
     }
+
+    if (ao_tick_ms() - sendBackoffTime < sendBackoffPeriod) {
+        //still in backoff period
+        return;
+    }
+
+    auto request = initedOp->createRequest();
+
+    if (!request) {
+        //request not ready yet or OOM
+        return;
+    }
+
+    //send request
+    std::string out;
+    serializeJson(*request, out);
+
+    bool success = ocppSock.sendTXT(out);
+
+    if (success) {
+        AO_DBG_TRAFFIC_OUT(out.c_str());
+    }
+
+    //update backoff time
+    sendBackoffTime = ao_tick_ms();
+    sendBackoffPeriod = std::min(sendBackoffPeriod + BACKOFF_PERIOD_INCREMENT, BACKOFF_PERIOD_MAX);
+    
 }
 
-void OcppConnection::initiateOperation(std::unique_ptr<OcppOperation> o){
-    if (!o) {
+void OcppConnection::sendRequest(std::unique_ptr<OcppOperation> op){
+    if (!op) {
         AO_DBG_ERR("Called with null. Ignore");
         return;
     }
-    if (!o->isFullyConfigured()){
-        AO_DBG_ERR("Called without the operation being configured and ready to send. Discard operation!");
-        return; //o gets destroyed
-    }
     
-    initiatedOcppOperations->initiate(std::move(o));
+    initiatedOcppOperations->initiate(std::move(op));
 }
 
 bool OcppConnection::receiveMessage(const char* payload, size_t length) {
@@ -119,52 +160,50 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
     switch (err.code()) {
         case DeserializationError::Ok: {
             int messageTypeId = doc[0] | -1;
-            switch(messageTypeId) {
-                case MESSAGE_TYPE_CALL:
-                    handleReqMessage(doc);      
-                    success = true;
-                    break;
-                case MESSAGE_TYPE_CALLRESULT:
-                    handleConfMessage(doc);
-                    success = true;
-                    break;
-                case MESSAGE_TYPE_CALLERROR:
-                    handleErrMessage(doc);
-                    success = true;
-                    break;
-                default:
-                    AO_DBG_WARN("Invalid OCPP message! (though JSON has successfully been deserialized)");
-                    break;
+
+            if (messageTypeId == MESSAGE_TYPE_CALL) {
+                receiveRequest(doc.as<JsonArray>());      
+                success = true;
+            } else if (messageTypeId == MESSAGE_TYPE_CALLRESULT ||
+                    messageTypeId == MESSAGE_TYPE_CALLERROR) {
+                receiveResponse(doc.as<JsonArray>());
+                success = true;
+            } else {
+                AO_DBG_WARN("Invalid OCPP message! (though JSON has successfully been deserialized)");
             }
-            break;
+            break; 
         }
         case DeserializationError::InvalidInput:
             AO_DBG_WARN("Invalid input! Not a JSON");
             break;
-        case DeserializationError::NoMemory:
-            {
-                AO_DBG_WARN("OOP! Incoming operation exceeds reserved heap. Input length = %zu, max capacity = %d", length, AO_MAX_JSON_CAPACITY);
-
-                /*
-                 * If websocket input is of message type MESSAGE_TYPE_CALL, send back a message of type MESSAGE_TYPE_CALLERROR.
-                 * Then the communication counterpart knows that this operation failed.
-                 * If the input type is MESSAGE_TYPE_CALLRESULT, it can be ignored. This controller will automatically resend the corresponding request message.
-                 */
-
-                doc =  DynamicJsonDocument(200);
-                char onlyRpcHeader[200];
-                size_t onlyRpcHeader_len = removePayload(payload, length, onlyRpcHeader, sizeof(onlyRpcHeader));
-                DeserializationError err2 = deserializeJson(doc, onlyRpcHeader, onlyRpcHeader_len);
-                if (err2.code() == DeserializationError::Ok) {
-                    int messageTypeId2 = doc[0] | -1;
-                    if (messageTypeId2 == MESSAGE_TYPE_CALL) {
-                        success = true;
-                        auto op = makeOcppOperation(new OutOfMemory(AO_MAX_JSON_CAPACITY, length));
-                        handleReqMessage(doc, std::move(op));
-                    }
+        case DeserializationError::NoMemory: {
+            AO_DBG_WARN("incoming operation exceeds buffer capacity. Input length = %zu, max capacity = %d", length, AO_MAX_JSON_CAPACITY);
+
+            /*
+                * If websocket input is of message type MESSAGE_TYPE_CALL, send back a message of type MESSAGE_TYPE_CALLERROR.
+                * Then the communication counterpart knows that this operation failed.
+                * If the input type is MESSAGE_TYPE_CALLRESULT, then abort the operation to avoid getting stalled.
+                */
+
+            doc = DynamicJsonDocument(200);
+            char onlyRpcHeader[200];
+            size_t onlyRpcHeader_len = removePayload(payload, length, onlyRpcHeader, sizeof(onlyRpcHeader));
+            DeserializationError err2 = deserializeJson(doc, onlyRpcHeader, onlyRpcHeader_len);
+            if (err2.code() == DeserializationError::Ok) {
+                int messageTypeId = doc[0] | -1;
+                if (messageTypeId == MESSAGE_TYPE_CALL) {
+                    success = true;
+                    auto op = makeOcppOperation(new MsgBufferExceeded(AO_MAX_JSON_CAPACITY, length));
+                    receiveRequest(doc.as<JsonArray>(), std::move(op));
+                } else if (messageTypeId == MESSAGE_TYPE_CALLRESULT ||
+                            messageTypeId == MESSAGE_TYPE_CALLERROR) {
+                    success = true;
+                    AO_DBG_WARN("crop incoming response");
+                    receiveResponse(doc.as<JsonArray>());
                 }
             }
             break;
+        }
         default:
             AO_DBG_WARN("Deserialization failed: %s", err.c_str());
             break;
@@ -180,13 +219,13 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
  * This function could result in improper behavior in Charging Stations, because messages are not
  * guaranteed to be received and therefore processed in the right order.
  */
-void OcppConnection::handleConfMessage(JsonDocument& json) {
+void OcppConnection::receiveResponse(JsonArray json) {
 
     bool success = false;
 
     initiatedOcppOperations->drop_if(
         [&json, &success] (std::unique_ptr<OcppOperation>& operation) {
-            bool match = operation->receiveConf(json);
+            bool match = operation->receiveResponse(json);
             if (match) {
                 success = true;
                 //operation will be deleted by the surrounding drop_if
@@ -196,56 +235,35 @@ void OcppConnection::handleConfMessage(JsonDocument& json) {
 
     if (!success) {
         //didn't find matching OcppOperation
-        AO_DBG_WARN("Received CALLRESULT doesn't match any pending operation");
-        (void)0;
+        if (json[0] == MESSAGE_TYPE_CALLERROR) {
+            AO_DBG_DEBUG("Received CALLERROR did not abort a pending operation");
+            (void)0;
+        } else {
+            AO_DBG_WARN("Received response doesn't match any pending operation");
+            (void)0;
+        }
     }
 }
 
-void OcppConnection::handleReqMessage(JsonDocument& json) {
-    auto op = makeFromJson(json);
+void OcppConnection::receiveRequest(JsonArray json) {
+    auto op = operationDeserializer.deserializeOperation(json[2] | "UNDEFINED");
     if (op == nullptr) {
-        AO_DBG_WARN("Couldn't make OppOperation from Request. Ignore request");
+        AO_DBG_WARN("OOM");
         return;
     }
-    handleReqMessage(json, std::move(op));
+    receiveRequest(json, std::move(op));
 }
 
-void OcppConnection::handleReqMessage(JsonDocument& json, std::unique_ptr<OcppOperation> op) {
-    if (op == nullptr) {
-        AO_DBG_ERR("Invalid argument");
-        return;
-    }
-    op->setOcppModel(baseModel);
-    op->receiveReq(json); //"fire" the operation
+void OcppConnection::receiveRequest(JsonArray json, std::unique_ptr<OcppOperation> op) {
+    op->receiveRequest(json); //execute the operation
     receivedOcppOperations.push_back(std::move(op)); //enqueue so loop() plans conf sending
 }
 
-void OcppConnection::handleErrMessage(JsonDocument& json) {
-
-    bool success = false;
-
-    initiatedOcppOperations->drop_if(
-        [&json, &success] (std::unique_ptr<OcppOperation>& operation) {
-            bool match = operation->receiveError(json);
-            if (match) {
-                success = true;
-                //operation will be deleted by the surrounding drop_if
-            }
-            return match;
-        }); //executes in order and drops every operation where predicate(op) == true
-
-    if (!success) {
-        //No OcppOperation was aborted because of the error message
-        AO_DBG_WARN("Received CALLERROR did not abort a pending operation");
-        (void)0;
-    }
-}
-
 /*
  * Tries to recover the Ocpp-Operation header from a broken message.
  * 
  * Example input: 
- * [2, "75705e50-682d-404e-b400-1bca33d41e19", "ChangeConfiguration", {"key":"now the msg breaks...
+ * [2, "75705e50-682d-404e-b400-1bca33d41e19", "ChangeConfiguration", {"key":"now the message breaks...
  * 
  * The Json library returns an error code when trying to deserialize that broken message. This
  * function searches for the first occurence of the character '{' and writes "}]" after it.
diff --git a/src/ArduinoOcpp/Core/OcppConnection.h b/src/ArduinoOcpp/Core/OcppConnection.h
index ca85cd05..92a8f239 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.h
+++ b/src/ArduinoOcpp/Core/OcppConnection.h
@@ -13,6 +13,7 @@
 
 namespace ArduinoOcpp {
 
+class OperationDeserializer;
 class OcppModel;
 class OcppSocket;
 class OcppOperation;
@@ -20,26 +21,29 @@ class FilesystemAdapter;
 
 class OcppConnection {
 private:
-    std::shared_ptr<OcppModel> baseModel;
-    std::shared_ptr<FilesystemAdapter> filesystem;
+    OperationDeserializer& operationDeserializer;
     
     std::unique_ptr<OperationsQueue> initiatedOcppOperations;
     std::deque<std::unique_ptr<OcppOperation>> receivedOcppOperations;
 
-    void handleConfMessage(JsonDocument& json);
-    void handleReqMessage(JsonDocument& json);
-    void handleReqMessage(JsonDocument& json, std::unique_ptr<OcppOperation> op);
-    void handleErrMessage(JsonDocument& json);
+    void receiveRequest(JsonArray json);
+    void receiveRequest(JsonArray json, std::unique_ptr<OcppOperation> op);
+    void receiveResponse(JsonArray json);
+
+    unsigned long sendBackoffTime = 0;
+    unsigned long sendBackoffPeriod = 0;
+    const unsigned long BACKOFF_PERIOD_MAX = 65536;
+    const unsigned long BACKOFF_PERIOD_INCREMENT = BACKOFF_PERIOD_MAX / 4;
 public:
-    OcppConnection(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem = nullptr);
+    OcppConnection(OperationDeserializer& operationDeserializer, std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem = nullptr);
 
     void setSocket(OcppSocket& sock);
 
     void loop(OcppSocket& ocppSock);
 
-    void initiateOperation(std::unique_ptr<OcppOperation> o); //send an OCPP operation request to the server
+    void sendRequest(std::unique_ptr<OcppOperation> o); //send an OCPP operation request to the server
     
-    bool receiveMessage(const char* payload, size_t length); //receive an OCPP operation from the server - either a confirmation or a request
+    bool receiveMessage(const char* payload, size_t length); //receive from  server: either a request or response
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/OcppEngine.cpp b/src/ArduinoOcpp/Core/OcppEngine.cpp
index b5880678..c84b734e 100644
--- a/src/ArduinoOcpp/Core/OcppEngine.cpp
+++ b/src/ArduinoOcpp/Core/OcppEngine.cpp
@@ -14,10 +14,10 @@ using namespace ArduinoOcpp;
 OcppEngine *ArduinoOcpp::defaultOcppEngine = nullptr;
 
 OcppEngine::OcppEngine(OcppSocket& ocppSocket, const OcppClock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem)
-        : oSock(ocppSocket), oModel{std::make_shared<OcppModel>(system_clock)}, oConn{oModel, filesystem} {
+        : oSock(ocppSocket), oModel{std::make_shared<OcppModel>(system_clock)}, oConn{operationDeserializer, oModel, filesystem} {
     defaultOcppEngine = this;
 
-    preBootConn = std::unique_ptr<OcppConnection>(new OcppConnection(oModel, nullptr)); //pre boot queue doesn't need persistency
+    preBootConn = std::unique_ptr<OcppConnection>(new OcppConnection(operationDeserializer, oModel, nullptr)); //pre boot queue doesn't need persistency
     preBootConn->setSocket(oSock);
 }
 
@@ -45,16 +45,14 @@ void OcppEngine::activatePostBootCommunication() {
 
 void OcppEngine::initiateOperation(std::unique_ptr<OcppOperation> op) {
     if (op) {
-        op->setOcppModel(oModel);
-        oConn.initiateOperation(std::move(op));
+        oConn.sendRequest(std::move(op));
     }
 }
 
 void OcppEngine::initiatePreBootOperation(std::unique_ptr<OcppOperation> op) {
     if (op) {
         if (preBootConn) {
-            op->setOcppModel(oModel);
-            preBootConn->initiateOperation(std::move(op));
+            preBootConn->sendRequest(std::move(op));
         } else {
             //not in pre boot mode anymore - initiate normally
             initiateOperation(std::move(op));
@@ -65,3 +63,7 @@ void OcppEngine::initiatePreBootOperation(std::unique_ptr<OcppOperation> op) {
 OcppModel& OcppEngine::getOcppModel() {
     return *oModel;
 }
+
+OperationDeserializer& OcppEngine::getOperationDeserializer() {
+    return operationDeserializer;
+}
diff --git a/src/ArduinoOcpp/Core/OcppEngine.h b/src/ArduinoOcpp/Core/OcppEngine.h
index 5615c75c..d3cb2dd9 100644
--- a/src/ArduinoOcpp/Core/OcppEngine.h
+++ b/src/ArduinoOcpp/Core/OcppEngine.h
@@ -6,18 +6,21 @@
 #define OCPPENGINE_H
 
 #include <ArduinoOcpp/Core/OcppConnection.h>
+#include <ArduinoOcpp/OperationDeserializer.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
 #include <memory>
 
 namespace ArduinoOcpp {
 
 class OcppSocket;
+class OperationDeserializer;
 class OcppModel;
 class FilesystemAdapter;
 
 class OcppEngine {
 private:
     OcppSocket& oSock;
+    OperationDeserializer operationDeserializer;
     std::shared_ptr<OcppModel> oModel;
     OcppConnection oConn;
 
@@ -37,6 +40,8 @@ class OcppEngine {
     void initiatePreBootOperation(std::unique_ptr<OcppOperation> op);
 
     OcppModel& getOcppModel();
+
+    OperationDeserializer& getOperationDeserializer();
 };
 
 extern OcppEngine *defaultOcppEngine;
diff --git a/src/ArduinoOcpp/Core/OcppError.h b/src/ArduinoOcpp/Core/OcppError.h
index 7c412a74..d880146c 100644
--- a/src/ArduinoOcpp/Core/OcppError.h
+++ b/src/ArduinoOcpp/Core/OcppError.h
@@ -18,17 +18,17 @@ class NotImplemented : public OcppMessage {
     }
 };
 
-class OutOfMemory : public OcppMessage {
+class MsgBufferExceeded : public OcppMessage {
 private:
     size_t maxCapacity;
     size_t msgLen;
 public:
-    OutOfMemory(size_t maxCapacity, size_t msgLen) : maxCapacity(maxCapacity), msgLen(msgLen) { }
+    MsgBufferExceeded(size_t maxCapacity, size_t msgLen) : maxCapacity(maxCapacity), msgLen(msgLen) { }
     const char *getErrorCode() {
-        return "InternalError";
+        return "GenericError";
     }
     const char *getErrorDescription() {
-        return "Too little free memory on the controller. Operation denied";
+        return "JSON too long or too many fields. Cannot deserialize";
     }
     std::unique_ptr<DynamicJsonDocument> getErrorDetails() {
         auto errDoc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
@@ -39,18 +39,5 @@ class OutOfMemory : public OcppMessage {
     }
 };
 
-class WebSocketError : public OcppMessage {
-private:
-    const char *description;
-public:
-    WebSocketError(const char *description) : description(description) { }
-    const char *getErrorCode() {
-        return "GenericError";
-    }
-    const char *getErrorDescription() {
-        return description;
-    }
-};
-
 } //end namespace ArduinoOcpp
 #endif
diff --git a/src/ArduinoOcpp/Core/OcppMessage.cpp b/src/ArduinoOcpp/Core/OcppMessage.cpp
index 9f6f7ea0..420ac6b8 100644
--- a/src/ArduinoOcpp/Core/OcppMessage.cpp
+++ b/src/ArduinoOcpp/Core/OcppMessage.cpp
@@ -17,15 +17,12 @@ const char* OcppMessage::getOcppOperationType(){
     return "CustomOperation";
 }
 
-void OcppMessage::setOcppModel(std::shared_ptr<OcppModel> ocppModel) {
-    if (!ocppModelInitialized) { //prevent the ocppModel from being overwritten
-        this->ocppModel = ocppModel; //can still be nullptr
-        ocppModelInitialized = true;
-    }
+void OcppMessage::initiate(StoredOperationHandler *rpcData) {
+    //called after initiateOperation(anyMsg)
 }
 
-void OcppMessage::initiate() {
-    //called after initiateOperation(anyMsg)
+bool OcppMessage::restore(StoredOperationHandler *rpcData) {
+    return false;
 }
 
 std::unique_ptr<DynamicJsonDocument> OcppMessage::createReq() {
diff --git a/src/ArduinoOcpp/Core/OcppMessage.h b/src/ArduinoOcpp/Core/OcppMessage.h
index 107de536..ba884f6a 100644
--- a/src/ArduinoOcpp/Core/OcppMessage.h
+++ b/src/ArduinoOcpp/Core/OcppMessage.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 /**
@@ -21,19 +21,13 @@
 #include <ArduinoJson.h>
 #include <memory>
 
+#include <ArduinoOcpp/Core/OperationStore.h>
+
 namespace ArduinoOcpp {
 
 std::unique_ptr<DynamicJsonDocument> createEmptyDocument();
 
-class OcppModel;
-class TransactionRPC;
-class StoredOperationHandler;
-
 class OcppMessage {
-private:
-    bool ocppModelInitialized = false;
-protected:
-    std::shared_ptr<OcppModel> ocppModel;
 public:
     OcppMessage();
 
@@ -41,12 +35,9 @@ class OcppMessage {
     
     virtual const char* getOcppOperationType();
 
-    void setOcppModel(std::shared_ptr<OcppModel> ocppModel);
-
-    virtual void initiate();
-    virtual bool initiate(StoredOperationHandler *rpcData) {return false;}
+    virtual void initiate(StoredOperationHandler *rpcData);
 
-    virtual bool restore(StoredOperationHandler *rpcData) {return false;}
+    virtual bool restore(StoredOperationHandler *rpcData);
 
     /**
      * Create the payload for the respective OCPP message
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 97deceda..49a07783 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -4,7 +4,6 @@
 
 #include <ArduinoOcpp/Core/OcppOperation.h>
 #include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/OperationStore.h>
@@ -35,18 +34,6 @@ void OcppOperation::setOcppMessage(std::unique_ptr<OcppMessage> msg){
     ocppMessage = std::move(msg);
 }
 
-void OcppOperation::setOcppModel(std::shared_ptr<OcppModel> oModel) {
-    if (!ocppMessage) {
-        AO_DBG_ERR("Must be called after setOcppMessage(). Abort");
-        return;
-    }
-    if (!oModel) {
-        AO_DBG_ERR("Passed nullptr. Ignore");
-        return;
-    }
-    ocppMessage->setOcppModel(oModel);
-}
-
 void OcppOperation::setTimeout(unsigned long timeout) {
     this->timeout_period = timeout;
 }
@@ -63,6 +50,10 @@ void OcppOperation::executeTimeout() {
     timed_out = true;
 }
 
+unsigned int OcppOperation::getTrialNo() {
+    return trialNo;
+}
+
 void OcppOperation::setMessageID(const std::string &id){
     if (!messageID.empty()){
         AO_DBG_WARN("MessageID is set twice or is set after first usage!");
@@ -70,146 +61,113 @@ void OcppOperation::setMessageID(const std::string &id){
     messageID = id;
 }
 
-const std::string *OcppOperation::getMessageID() {
-    if (messageID.empty()) {
-        char id_str [16] = {'\0'};
-        sprintf(id_str, "%d", unique_id_counter++);
-        messageID = std::string {id_str};
-        //messageID = std::to_string(unique_id_counter++);
-    }
-    return &messageID;
+const char *OcppOperation::getMessageID() {
+    return messageID.c_str();
 }
 
-void OcppOperation::sendReq(OcppSocket& ocppSocket){
-
-    /*
-     * retry behaviour
-     * 
-     * if retry, run the rest of this function, i.e. resend the message. If not, just return false
-     */
-    if (ao_tick_ms() <= retry_start + RETRY_INTERVAL * retry_interval_mult) {
-        //NO retry
-        return;
-    }
-
-    // Do retry. Increase timer by factor 2
-    if (RETRY_INTERVAL * retry_interval_mult * 2 <= RETRY_INTERVAL_MAX) {
-        retry_interval_mult *= 2;
-    }
+std::unique_ptr<DynamicJsonDocument> OcppOperation::createRequest(){
 
     /*
      * Create the OCPP message
      */
     auto requestPayload = ocppMessage->createReq();
     if (!requestPayload) {
-        return;
+        return nullptr;
     }
 
     /*
      * Create OCPP-J Remote Procedure Call header
      */
-    size_t json_buffsize = JSON_ARRAY_SIZE(4) + (getMessageID()->length() + 1) + requestPayload->capacity();
-    DynamicJsonDocument requestJson(json_buffsize);
+    size_t json_buffsize = JSON_ARRAY_SIZE(4) + (messageID.length() + 1) + requestPayload->capacity();
+    auto requestJson = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
 
-    requestJson.add(MESSAGE_TYPE_CALL);                    //MessageType
-    requestJson.add(*getMessageID());                      //Unique message ID
-    requestJson.add(ocppMessage->getOcppOperationType());  //Action
-    requestJson.add(*requestPayload);                      //Payload
+    requestJson->add(MESSAGE_TYPE_CALL);                    //MessageType
+    requestJson->add(messageID);                      //Unique message ID
+    requestJson->add(ocppMessage->getOcppOperationType());  //Action
+    requestJson->add(*requestPayload);                      //Payload
 
-    /*
-     * Serialize and send. Destroy serialization and JSON object. 
-     * 
-     * If sending was successful, start timer
-     * 
-     * Return that this function must be called again (-> false)
-     */
-    std::string out {};
-    serializeJson(requestJson, out);
+    if (AO_DBG_LEVEL >= AO_DL_DEBUG && ao_tick_ms() - debugRequest_start >= 10000) { //print contents on the console
+        debugRequest_start = ao_tick_ms();
 
-    if (printReqCounter > 5000) {
-        printReqCounter = 0;
-        AO_DBG_DEBUG("Try to send request: %s", out.c_str());
-    }
-    printReqCounter++;
-    
-    bool success = ocppSocket.sendTXT(out);
+        char *buf = new char[1024];
+        size_t len = 0;
+        if (buf) {
+            len = serializeJson(*requestJson, buf, 1024);
+        }
 
-    if (success) {
-        AO_DBG_TRAFFIC_OUT(out.c_str());
-        retry_start = ao_tick_ms();
-    } else {
-        //ocppSocket is not able to put any data on TCP stack. Maybe because we're offline
-        retry_start = 0;
-        retry_interval_mult = 1;
+        if (!buf || len < 1) {
+            AO_DBG_DEBUG("Try to send request: %s", ocppMessage->getOcppOperationType());
+        } else {
+            AO_DBG_DEBUG("Try to send request: %.*s ...", 128, ocppMessage->getOcppOperationType());
+        }
+
+        delete buf;
     }
+
+    trialNo++;
+
+    return requestJson;
 }
 
-bool OcppOperation::receiveConf(JsonDocument& confJson){
+bool OcppOperation::receiveResponse(JsonArray response){
     /*
      * check if messageIDs match. If yes, continue with this function. If not, return false for message not consumed
      */
-    if (*getMessageID() != confJson[1].as<std::string>()){
+    if (messageID != response[1].as<std::string>()){
         return false;
     }
 
-    /*
-     * Hand the payload over to the OcppMessage object
-     */
-    JsonObject payload = confJson[2];
-    ocppMessage->processConf(payload);
+    int messageTypeId = response[0] | -1;
 
-    /*
-     * Hand the payload over to the onReceiveConf Callback
-     */
-    onReceiveConfListener(payload);
+    if (messageTypeId == MESSAGE_TYPE_CALLRESULT) {
 
-    /*
-     * return true as this message has been consumed
-     */
-    return true;
-}
+        /*
+        * Hand the payload over to the OcppMessage object
+        */
+        JsonObject payload = response[2];
+        ocppMessage->processConf(payload);
 
-bool OcppOperation::receiveError(JsonDocument& confJson){
-    /*
-     * check if messageIDs match. If yes, continue with this function. If not, return false for message not consumed
-     */
-    if (*getMessageID() != confJson[1].as<std::string>()){
-        return false;
-    }
+        /*
+        * Hand the payload over to the onReceiveConf Callback
+        */
+        onReceiveConfListener(payload);
 
-    /*
-     * Hand the error over to the OcppMessage object
-     */
-    const char *errorCode = confJson[2];
-    const char *errorDescription = confJson[3];
-    JsonObject errorDetails = confJson[4];
-    bool abortOperation = ocppMessage->processErr(errorCode, errorDescription, errorDetails);
+        /*
+        * return true as this message has been consumed
+        */
+        return true;
+    } else if (messageTypeId == MESSAGE_TYPE_CALLERROR) {
 
-    if (abortOperation) {
-        onReceiveErrorListener(errorCode, errorDescription, errorDetails);
-        onAbortListener();
+        /*
+        * Hand the error over to the OcppMessage object
+        */
+        const char *errorCode = response[2];
+        const char *errorDescription = response[3];
+        JsonObject errorDetails = response[4];
+        bool abortOperation = ocppMessage->processErr(errorCode, errorDescription, errorDetails);
+
+        if (abortOperation) {
+            onReceiveErrorListener(errorCode, errorDescription, errorDetails);
+            onAbortListener();
+        }
+
+        return abortOperation;
     } else {
-        //restart operation
-        timeout_start = ao_tick_ms();
-        retry_start = 0;
-        retry_interval_mult = 1;
+        AO_DBG_WARN("invalid response");
+        return false; //don't discard this message but retry sending it
     }
 
-    return abortOperation;
 }
 
-bool OcppOperation::receiveReq(JsonDocument& reqJson){
+bool OcppOperation::receiveRequest(JsonArray request){
   
-    std::string reqId = reqJson[1];
-    setMessageID(reqId);
-
-    //TODO What if client receives requests two times? Can happen if previous conf is lost. In the Smart Charging Profile
-    //     it probably doesn't matter to repeat an operation on the EVSE. Change in future?
+    std::string msgId = request[1];
+    setMessageID(msgId);
     
     /*
      * Hand the payload over to the OcppOperation object
      */
-    JsonObject payload = reqJson[3];
+    JsonObject payload = request[3];
     ocppMessage->processReq(payload);
     
     /*
@@ -217,29 +175,22 @@ bool OcppOperation::receiveReq(JsonDocument& reqJson){
      */
     onReceiveReqListener(payload);
 
-    reqExecuted = true; //ensure that the conf is only sent after the req has been executed
-
-    return true; //true because everything was successful. If there will be an error check in future, this value becomes more reasonable
+    return true; //success
 }
 
-bool OcppOperation::sendConf(OcppSocket& ocppSocket){
-
-    if (!reqExecuted) {
-        //wait until req has been executed
-        return false;
-    }
+std::unique_ptr<DynamicJsonDocument> OcppOperation::createResponse(){
 
     /*
      * Create the OCPP message
      */
-    std::unique_ptr<DynamicJsonDocument> confJson = nullptr;
-    std::unique_ptr<DynamicJsonDocument> confPayload = ocppMessage->createConf();
+    std::unique_ptr<DynamicJsonDocument> response = nullptr;
+    std::unique_ptr<DynamicJsonDocument> payload = ocppMessage->createConf();
     std::unique_ptr<DynamicJsonDocument> errorDetails = nullptr;
     
     bool operationFailure = ocppMessage->getErrorCode() != nullptr;
 
-    if (!operationFailure && !confPayload) {
-        return false; //confirmation message still pending
+    if (!operationFailure && !payload) {
+        return nullptr; //confirmation message still pending
     }
 
     if (!operationFailure) {
@@ -247,12 +198,12 @@ bool OcppOperation::sendConf(OcppSocket& ocppSocket){
         /*
          * Create OCPP-J Remote Procedure Call header
          */
-        size_t json_buffsize = JSON_ARRAY_SIZE(3) + (getMessageID()->length() + 1) + confPayload->capacity();
-        confJson = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
+        size_t json_buffsize = JSON_ARRAY_SIZE(3) + (messageID.length() + 1) + payload->capacity();
+        response = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
 
-        confJson->add(MESSAGE_TYPE_CALLRESULT);   //MessageType
-        confJson->add(*getMessageID());            //Unique message ID
-        confJson->add(*confPayload);              //Payload
+        response->add(MESSAGE_TYPE_CALLRESULT);   //MessageType
+        response->add(messageID);            //Unique message ID
+        response->add(*payload);              //Payload
     } else {
         //operation failure. Send error message instead
 
@@ -269,69 +220,55 @@ bool OcppOperation::sendConf(OcppSocket& ocppSocket){
          * Create OCPP-J Remote Procedure Call header
          */
         size_t json_buffsize = JSON_ARRAY_SIZE(5)
-                    + (getMessageID()->length() + 1)
+                    + (messageID.length() + 1)
                     + strlen(errorCode) + 1
                     + strlen(errorDescription) + 1
                     + errorDetails->capacity();
-        confJson = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
+        response = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
 
-        confJson->add(MESSAGE_TYPE_CALLERROR);   //MessageType
-        confJson->add(*getMessageID());            //Unique message ID
-        confJson->add(errorCode);
-        confJson->add(errorDescription);
-        confJson->add(*errorDetails);              //Error description
+        response->add(MESSAGE_TYPE_CALLERROR);   //MessageType
+        response->add(messageID);            //Unique message ID
+        response->add(errorCode);
+        response->add(errorDescription);
+        response->add(*errorDetails);              //Error description
     }
 
-    /*
-     * Serialize and send. Destroy serialization and JSON object. 
-     */
-    std::string out {};
-    serializeJson(*confJson, out);
-    bool wsSuccess = ocppSocket.sendTXT(out);
-
-    if (wsSuccess) {
-        if (!operationFailure) {
-            AO_DBG_TRAFFIC_OUT(out.c_str());
-            onSendConfListener(confPayload->as<JsonObject>());
-        } else {
-            AO_DBG_WARN("Operation failed. JSON CallError message: %s", out.c_str());
-            onAbortListener();
-        }
-    }
-
-    return wsSuccess;
+    return response;
 }
 
 void OcppOperation::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
 
     timeout_start = ao_tick_ms();
+    debugRequest_start = ao_tick_ms();
+
+    //assign messageID
+    char id_str [16] = {'\0'};
+    sprintf(id_str, "%d", unique_id_counter++);
+    messageID = std::string {id_str};
 
     if (ocppMessage) {
 
         /*
-         * Create OCPP-J Remote Procedure Call header as storage data (doesn't necessarily have to comply with OCPP RPC header)
+         * Create OCPP-J Remote Procedure Call header storage entry
          */
-        if (opStorage) {
-            opStore = std::move(opStorage);
-            size_t json_buffsize = JSON_ARRAY_SIZE(3) + (getMessageID()->length() + 1);
+        opStore = std::move(opStorage);
+
+        if (opStore) {
+            size_t json_buffsize = JSON_ARRAY_SIZE(3) + (messageID.length() + 1);
             auto rpcData = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
 
             rpcData->add(MESSAGE_TYPE_CALL);                    //MessageType
-            rpcData->add(*getMessageID());                      //Unique message ID
+            rpcData->add(messageID);                      //Unique message ID
             rpcData->add(ocppMessage->getOcppOperationType());  //Action
 
             opStore->setRpc(std::move(rpcData));
         }
         
-        bool inited = ocppMessage->initiate(opStore.get());
+        ocppMessage->initiate(opStore.get());
 
         if (opStore) {
             opStore->clearBuffer();
         }
-        
-        if (!inited) { //legacy support
-            ocppMessage->initiate();
-        }
     } else {
         AO_DBG_ERR("Missing ocppMessage instance");
     }
@@ -372,9 +309,9 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
     }
 
     if (!strcmp(opType.c_str(), "StartTransaction")) { //TODO this will get a nicer solution
-        ocppMessage = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction());
+        ocppMessage = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction(*oModel.get(), nullptr));
     } else if (!strcmp(opType.c_str(), "StopTransaction")) {
-        ocppMessage = std::unique_ptr<OcppMessage>(new Ocpp16::StopTransaction());
+        ocppMessage = std::unique_ptr<OcppMessage>(new Ocpp16::StopTransaction(*oModel.get(), nullptr));
     }
 
     if (!ocppMessage) {
@@ -382,8 +319,6 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
         return false;
     }
 
-    ocppMessage->setOcppModel(oModel);
-
     bool success = ocppMessage->restore(opStore.get());
     opStore->clearBuffer();
 
@@ -431,15 +366,6 @@ void OcppOperation::setOnAbortListener(OnAbortListener onAbort) {
         onAbortListener = onAbort;
 }
 
-bool OcppOperation::isFullyConfigured(){
-    return ocppMessage != nullptr;
-}
-
-void OcppOperation::rebaseMsgId(int msgIdCounter) {
-    unique_id_counter = msgIdCounter;
-    getMessageID(); //apply msgIdCounter to this operation
-}
-
 const char *OcppOperation::getOcppOperationType() {
     return ocppMessage ? ocppMessage->getOcppOperationType() : "UNDEFINED";
 }
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/OcppOperation.h
index ebcd6434..a6cae079 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.h
+++ b/src/ArduinoOcpp/Core/OcppOperation.h
@@ -17,14 +17,12 @@ namespace ArduinoOcpp {
 
 class OcppMessage;
 class OcppModel;
-class OcppSocket;
 class StoredOperationHandler;
 
 class OcppOperation {
 private:
     std::string messageID {};
     std::unique_ptr<OcppMessage> ocppMessage;
-    const std::string *getMessageID();
     void setMessageID(const std::string &id);
     OnReceiveConfListener onReceiveConfListener = [] (JsonObject payload) {};
     OnReceiveReqListener onReceiveReqListener = [] (JsonObject payload) {};
@@ -32,18 +30,14 @@ class OcppOperation {
     OnTimeoutListener onTimeoutListener = [] () {};
     OnReceiveErrorListener onReceiveErrorListener = [] (const char *code, const char *description, JsonObject details) {};
     OnAbortListener onAbortListener = [] () {};
-    bool reqExecuted = false;
 
     unsigned long timeout_start = 0;
     unsigned long timeout_period = 40000;
     bool timed_out = false;
 
-    const unsigned long RETRY_INTERVAL = 3000; //in ms; first retry after ... ms; second retry after 2 * ... ms; third after 4 ...
-    const unsigned long RETRY_INTERVAL_MAX = 20000; //in ms; 
-    unsigned long retry_start = 0;
-    unsigned long retry_interval_mult = 1; // RETRY_INTERVAL * retry_interval_mult gives longer periods with each iteration
-
-    uint16_t printReqCounter = 0;
+    unsigned int trialNo = 0;
+    
+    unsigned long debugRequest_start = 0;
 
     std::unique_ptr<StoredOperationHandler> opStore;
 public:
@@ -56,14 +50,12 @@ class OcppOperation {
 
     void setOcppMessage(std::unique_ptr<OcppMessage> msg);
 
-    void setOcppModel(std::shared_ptr<OcppModel> oModel);
-
     void setTimeout(unsigned long timeout); //0 = disable timeout
-
     bool isTimeoutExceeded();
-
     void executeTimeout(); //call Timeout handler
 
+    unsigned int getTrialNo(); //how many times createRequest() has been tried (used for retry behavior)
+
     /**
      * Sends the message(s) that belong to the OCPP Operation. This function puts a JSON message on the lower protocol layer.
      * 
@@ -72,36 +64,28 @@ class OcppOperation {
      * This function is usually called multiple times by the Arduino loop(). On first call, the request is initially sent. In the
      * succeeding calls, the implementers decide to either resend the request, or do nothing as the operation is still pending.
      */
-    void sendReq(OcppSocket& ocppSocket);
+    std::unique_ptr<DynamicJsonDocument> createRequest();
 
    /**
-    * Decides if message belongs to this operation instance and if yes, proccesses it. For example, multiple instances of an
-    * operation type can run in the case of Metering Data being sent.
-    * 
-    * Returns true if JSON object has been consumed, false otherwise.
-    */
-    bool receiveConf(JsonDocument& json);
-
-    /**
-    * Decides if message belongs to this operation instance and if yes, notifies the OcppMessage object about the CallError.
+    * Decides if message belongs to this operation instance and if yes, proccesses it. Receives both Confirmations and Errors
     * 
     * Returns true if JSON object has been consumed, false otherwise.
     */
-    bool receiveError(JsonDocument& json);
+    bool receiveResponse(JsonArray json);
 
     /**
      * Processes the request in the JSON document. Returns true on success, false on error.
      * 
      * Returns false if the request doesn't belong to the corresponding operation instance
      */
-    bool receiveReq(JsonDocument& json);
+    bool receiveRequest(JsonArray json);
 
     /**
      * After processing a request sent by the communication counterpart, this function sends a confirmation
      * message. Returns true on success, false otherwise. Returns also true if a CallError has successfully
      * been sent
      */
-    bool sendConf(OcppSocket& ocppSocket);
+    std::unique_ptr<DynamicJsonDocument> createResponse();
 
     void initiate(std::unique_ptr<StoredOperationHandler> opStorage);
 
@@ -135,10 +119,7 @@ class OcppOperation {
      */
     void setOnAbortListener(OnAbortListener onAbort);
 
-    bool isFullyConfigured();
-
-    void rebaseMsgId(int msgIdCounter); //workaround; remove when random UUID msg IDs are introduced
-
+    const char *getMessageID();
     const char *getOcppOperationType();
 };
 
diff --git a/src/ArduinoOcpp/Core/OcppOperationCallbacks.h b/src/ArduinoOcpp/Core/OcppOperationCallbacks.h
index 16e36f4e..ab919635 100644
--- a/src/ArduinoOcpp/Core/OcppOperationCallbacks.h
+++ b/src/ArduinoOcpp/Core/OcppOperationCallbacks.h
@@ -17,6 +17,5 @@ using OnTimeoutListener = std::function<void()>;
 using OnReceiveErrorListener = std::function<void(const char *code, const char *description, JsonObject details)>; //will be called if OCPP communication partner returns error code
 using OnAbortListener = std::function<void()>; //will be called whenever the engine will stop trying to execute the operation normallythere is a timeout or error (onAbort = onTimeout || onReceiveError)
 
-
 } //end namespace ArduinoOcpp
 #endif
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index c4e3ed4d..72084cc1 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -123,11 +123,6 @@ void PersistentOperationsQueue::pop_front() {
                 AO_DBG_ERR("could not restore operation");
                 fetched.reset();
             }
-
-            if (!fetched->isFullyConfigured()) {
-                AO_DBG_ERR("stored op initialization failure");
-                fetched.reset();
-            }
         }
 
         if (fetched) {
diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.cpp b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
index d7c62672..a168a88f 100644
--- a/src/ArduinoOcpp/MessagesV16/Authorize.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
@@ -15,7 +15,7 @@ using ArduinoOcpp::Ocpp16::Authorize;
 //    snprintf(this->idTag, IDTAG_LEN_MAX + 1, "A0-00-00-00"); //Use a default payload. In the typical use case of this library, you probably you don't even need Authorization at all
 //}
 
-Authorize::Authorize(const char *idTagIn) {
+Authorize::Authorize(OcppModel& context, const char *idTagIn) : context(context) {
     if (idTagIn && strnlen(idTagIn, IDTAG_LEN_MAX + 2) <= IDTAG_LEN_MAX) {
         snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
     } else {
@@ -44,8 +44,8 @@ void Authorize::processConf(JsonObject payload){
         AO_DBG_INFO("Request has been denied. Reason: %s", idTagInfo);
     }
 
-    if (ocppModel && ocppModel->getAuthorizationService()) {
-        ocppModel->getAuthorizationService()->notifyAuthorization(idTag, payload["idTagInfo"]);
+    if (context.getAuthorizationService()) {
+        context.getAuthorizationService()->notifyAuthorization(idTag, payload["idTagInfo"]);
     }
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.h b/src/ArduinoOcpp/MessagesV16/Authorize.h
index 83ee7ee5..b4ace5db 100644
--- a/src/ArduinoOcpp/MessagesV16/Authorize.h
+++ b/src/ArduinoOcpp/MessagesV16/Authorize.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef AUTHORIZE_H
@@ -9,15 +9,19 @@
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class Authorize : public OcppMessage {
 private:
+    OcppModel& context;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
 public:
 //    Authorize();
 
-    Authorize(const char *idTag);
+    Authorize(OcppModel& context, const char *idTag);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
index 36ac3532..740ae185 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
@@ -12,11 +12,7 @@
 
 using ArduinoOcpp::Ocpp16::BootNotification;
 
-BootNotification::BootNotification() {
-    
-}
-
-BootNotification::BootNotification(std::unique_ptr<DynamicJsonDocument> payload) : credentials(std::move(payload)) {
+BootNotification::BootNotification(OcppModel& context, std::unique_ptr<DynamicJsonDocument> payload) : context(context), credentials(std::move(payload)) {
     
 }
 
@@ -24,56 +20,19 @@ const char* BootNotification::getOcppOperationType(){
     return "BootNotification";
 }
 
-void BootNotification::initiate() {
-    if (credentials &&
-            ocppModel && ocppModel->getBootService()) {
-        auto bootService = ocppModel->getBootService();
-        std::string credentialsJson;
-        auto written = serializeJson(*credentials, credentialsJson);
-        if (written < 2) {
-            AO_DBG_ERR("serialization error");
-            credentialsJson = "{}";
-        }
-        bootService->setChargePointCredentials(credentialsJson.c_str());
-        credentials.reset();
-    }
-}
-
 std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
-
-    if (ocppModel && ocppModel->getBootService()) {
-        auto bootService = ocppModel->getBootService();
-        const auto& cpCredentials = bootService->getChargePointCredentials();
-    
-        std::unique_ptr<DynamicJsonDocument> doc;
-        size_t capacity = JSON_OBJECT_SIZE(9) + cpCredentials.size();
-        DeserializationError err = DeserializationError::NoMemory;
-        while (err == DeserializationError::NoMemory) {
-            doc.reset(new DynamicJsonDocument(capacity));
-            err = deserializeJson(*doc, cpCredentials);
-
-            capacity *= 2;
-        }
-
-        if (!err) {
-            return doc;
-        } else {
-            AO_DBG_ERR("could not parse stored credentials: %s", err.c_str());
-        }
-    }
-
     if (credentials) {
         return std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(*credentials));
+    } else {
+        AO_DBG_ERR("payload undefined");
+        return createEmptyDocument();
     }
-    
-    AO_DBG_ERR("payload undefined");
-    return createEmptyDocument();
 }
 
-void BootNotification::processConf(JsonObject payload){
+void BootNotification::processConf(JsonObject payload) {
     const char* currentTime = payload["currentTime"] | "Invalid";
     if (strcmp(currentTime, "Invalid")) {
-        if (ocppModel && ocppModel->getOcppTime().setOcppTime(currentTime)) {
+        if (context.getOcppTime().setOcppTime(currentTime)) {
             //success
         } else {
             AO_DBG_ERR("Time string format violation. Expect format like 2022-02-01T20:53:32.486Z");
@@ -110,8 +69,7 @@ void BootNotification::processConf(JsonObject payload){
         }
     }
 
-    if (ocppModel && ocppModel->getBootService()) {
-        auto bootService = ocppModel->getBootService();
+    if (auto bootService = context.getBootService()) {
 
         if (status != RegistrationStatus::Accepted) {
             bootService->setRetryInterval(interval);
@@ -138,13 +96,11 @@ std::unique_ptr<DynamicJsonDocument> BootNotification::createConf(){
     //safety mechanism; in some test setups the library has to answer BootNotifications without valid system time
     OcppTimestamp ocppTimeReference = OcppTimestamp(2022,0,27,11,59,55); 
     OcppTimestamp ocppSelect = ocppTimeReference;
-    if (ocppModel) {
-        auto& ocppTime = ocppModel->getOcppTime();
-        OcppTimestamp ocppNow = ocppTime.getOcppTimestampNow();
-        if (ocppNow > ocppTimeReference) {
-            //time has already been set
-            ocppSelect = ocppNow;
-        }
+    auto& ocppTime = context.getOcppTime();
+    OcppTimestamp ocppNow = ocppTime.getOcppTimestampNow();
+    if (ocppNow > ocppTimeReference) {
+        //time has already been set
+        ocppSelect = ocppNow;
     }
 
     char ocppNowJson [JSONDATE_LENGTH + 1] = {'\0'};
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.h b/src/ArduinoOcpp/MessagesV16/BootNotification.h
index 1edee47b..b2285c52 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.h
@@ -14,23 +14,23 @@
 #define FW_VERSION_LEN_MAX      CiString50TypeLen
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class BootNotification : public OcppMessage {
 private:
+    OcppModel& context;
     std::unique_ptr<DynamicJsonDocument> credentials;
     const char *errorCode = nullptr;
 public:
-    BootNotification();
+    BootNotification(OcppModel& context, std::unique_ptr<DynamicJsonDocument> payload);
 
     ~BootNotification() = default;
 
-    BootNotification(std::unique_ptr<DynamicJsonDocument> payload);
-
     const char* getOcppOperationType();
 
-    void initiate();
-
     std::unique_ptr<DynamicJsonDocument> createReq();
 
     void processConf(JsonObject payload);
diff --git a/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp b/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
index 6c79381d..3405cb7f 100644
--- a/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
+++ b/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
@@ -9,7 +9,7 @@
 
 using ArduinoOcpp::Ocpp16::CancelReservation;
 
-CancelReservation::CancelReservation() {
+CancelReservation::CancelReservation(OcppModel& context) : context(context) {
   
 }
 
@@ -23,8 +23,8 @@ void CancelReservation::processReq(JsonObject payload) {
         return;
     }
 
-    if (ocppModel && ocppModel->getReservationService()) {
-        if (auto reservation = ocppModel->getReservationService()->getReservationById(payload["reservationId"])) {
+    if (context.getReservationService()) {
+        if (auto reservation = context.getReservationService()->getReservationById(payload["reservationId"])) {
             found = true;
             reservation->clear();
         }
diff --git a/src/ArduinoOcpp/MessagesV16/CancelReservation.h b/src/ArduinoOcpp/MessagesV16/CancelReservation.h
index 125a837b..f6c848aa 100644
--- a/src/ArduinoOcpp/MessagesV16/CancelReservation.h
+++ b/src/ArduinoOcpp/MessagesV16/CancelReservation.h
@@ -8,14 +8,18 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class CancelReservation : public OcppMessage {
 private:
+    OcppModel& context;
     bool found = false;
     const char *errorCode = nullptr;
 public:
-    CancelReservation();
+    CancelReservation(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
index 0d3687ec..69b6298c 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
@@ -10,7 +10,7 @@
 
 using ArduinoOcpp::Ocpp16::ChangeAvailability;
 
-ChangeAvailability::ChangeAvailability() {
+ChangeAvailability::ChangeAvailability(OcppModel& context) : context(context) {
 
 }
 
@@ -20,10 +20,10 @@ const char* ChangeAvailability::getOcppOperationType(){
 
 void ChangeAvailability::processReq(JsonObject payload) {
     int connectorId = payload["connectorId"] | -1;
-    if (!ocppModel || !ocppModel->getChargePointStatusService()) {
+    auto cpStatus = context.getChargePointStatusService();
+    if (!cpStatus) {
         return;
     }
-    auto cpStatus = ocppModel->getChargePointStatusService();
     if (connectorId < 0 || connectorId >= cpStatus->getNumConnectors()) {
         return;
     }
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
index c8f088c7..fbc36586 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
+++ b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CHANGEAVAILABILITY_H
@@ -8,14 +8,18 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class ChangeAvailability : public OcppMessage {
 private:
+    OcppModel& context;
     bool scheduled = false;
     bool accepted = false;
 public:
-    ChangeAvailability();
+    ChangeAvailability(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp b/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
index 5dced006..2d541170 100644
--- a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
@@ -11,7 +11,7 @@
 
 using ArduinoOcpp::Ocpp16::ClearChargingProfile;
 
-ClearChargingProfile::ClearChargingProfile() {
+ClearChargingProfile::ClearChargingProfile(OcppModel& context) : context(context) {
 
 }
 
@@ -63,12 +63,12 @@ void ClearChargingProfile::processReq(JsonObject payload) {
         return true;
     };
 
-    if (!ocppModel || !ocppModel->getSmartChargingService()) {
-        AO_DBG_ERR("SmartChargingService not initialized! Ignore request");
-        return;
+    if (auto scService = context.getSmartChargingService()) {
+        matchingProfilesFound = scService->clearChargingProfile(filter);
+    } else {
+        AO_DBG_ERR("SmartChargingService not initialized");
+        errorCode = "NotSupported";
     }
-
-    matchingProfilesFound = ocppModel->getSmartChargingService()->clearChargingProfile(filter);
 }
 
 std::unique_ptr<DynamicJsonDocument> ClearChargingProfile::createConf(){
diff --git a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h b/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h
index 43c14c54..11135688 100644
--- a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h
+++ b/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CLEARCHARGINGPROFILE_H
@@ -8,19 +8,27 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class ClearChargingProfile : public OcppMessage {
 private:
+    OcppModel& context;
     bool matchingProfilesFound = false;
+    const char *errorCode;
 public:
-    ClearChargingProfile();
+    ClearChargingProfile(OcppModel& context);
 
     const char* getOcppOperationType();
 
     void processReq(JsonObject payload);
 
     std::unique_ptr<DynamicJsonDocument> createConf();
+
+    const char *getErrorCode() {return errorCode;}
+    
 };
 
 } //end namespace Ocpp16
diff --git a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
index c53187f1..21cc18b5 100644
--- a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h>
@@ -9,15 +9,6 @@
 
 using ArduinoOcpp::Ocpp16::DiagnosticsStatusNotification;
 
-DiagnosticsStatusNotification::DiagnosticsStatusNotification() {
-    if (defaultOcppEngine && defaultOcppEngine->getOcppModel().getDiagnosticsService()) {
-        auto diagnosticsService = defaultOcppEngine->getOcppModel().getDiagnosticsService();
-        status = diagnosticsService->getDiagnosticsStatus();
-    } else {
-        status = DiagnosticsStatus::Idle;
-    }
-}
-
 DiagnosticsStatusNotification::DiagnosticsStatusNotification(DiagnosticsStatus status) : status(status) {
     
 }
diff --git a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h b/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h
index abf7db09..45a2091d 100644
--- a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
@@ -13,11 +13,9 @@ namespace Ocpp16 {
 
 class DiagnosticsStatusNotification : public OcppMessage {
 private:
-    DiagnosticsStatus status;
+    DiagnosticsStatus status = DiagnosticsStatus::Idle;
     static const char *cstrFromStatus(DiagnosticsStatus status);
 public:
-    DiagnosticsStatusNotification();
-
     DiagnosticsStatusNotification(DiagnosticsStatus status);
 
     const char* getOcppOperationType() {return "DiagnosticsStatusNotification"; }
diff --git a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
index 5737b790..6440925f 100644
--- a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h>
@@ -9,15 +9,6 @@
 
 using ArduinoOcpp::Ocpp16::FirmwareStatusNotification;
 
-FirmwareStatusNotification::FirmwareStatusNotification() {
-    if (defaultOcppEngine && defaultOcppEngine->getOcppModel().getFirmwareService()) {
-        auto firmwareService = defaultOcppEngine->getOcppModel().getFirmwareService();
-        status = firmwareService->getFirmwareStatus();
-    } else {
-        status = FirmwareStatus::Idle;
-    }
-}
-
 FirmwareStatusNotification::FirmwareStatusNotification(FirmwareStatus status) : status{status} {
 
 }
diff --git a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h b/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h
index 7f2a882f..d9fbb813 100644
--- a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
@@ -14,11 +14,9 @@ namespace Ocpp16 {
 
 class FirmwareStatusNotification : public OcppMessage {
 private:
-    FirmwareStatus status;
+    FirmwareStatus status = FirmwareStatus::Idle;
     static const char *cstrFromFwStatus(FirmwareStatus status);
 public:
-    FirmwareStatusNotification();
-
     FirmwareStatusNotification(FirmwareStatus status);
 
     const char* getOcppOperationType() {return "FirmwareStatusNotification"; }
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
index b45620ed..043c7ec5 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
@@ -12,11 +12,11 @@
 
 using ArduinoOcpp::Ocpp16::GetCompositeSchedule;
 
-GetCompositeSchedule::GetCompositeSchedule() {
+GetCompositeSchedule::GetCompositeSchedule(OcppModel& context) : context(context) {
 
 }
 
-const char* GetCompositeSchedule::getOcppOperationType(){
+const char* GetCompositeSchedule::getOcppOperationType() {
     return "GetCompositeSchedule";
 }
 
@@ -34,8 +34,8 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
         errorCode = "PropertyConstraintViolation";
     }
 
-    if (ocppModel && ocppModel->getChargePointStatusService()) {
-        if (connectorId >= ocppModel->getChargePointStatusService()->getNumConnectors()) {
+    if (auto cpService = context.getChargePointStatusService()) {
+        if (connectorId >= cpService->getNumConnectors()) {
             errorCode = "PropertyConstraintViolation";
         }
     }
@@ -44,21 +44,19 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
         errorCode = "FormationViolation";
     }
 
-    if (!ocppModel || !ocppModel->getSmartChargingService()) {
+    if (!context.getSmartChargingService()) {
         AO_DBG_ERR("SmartChargingService not initialized! Ignore request");
         errorCode = "NotSupported";
     }
 }
 
 std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
-    if (!ocppModel || !ocppModel->getSmartChargingService()) {
-        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
-        JsonObject payload = doc->to<JsonObject>();
-        payload["status"] = "Rejected";
-        return doc;
+    auto scService = context.getSmartChargingService();
+    if (!scService) {
+        AO_DBG_ERR("invalid state");
+        return createEmptyDocument();
     }
 
-    auto scService = ocppModel->getSmartChargingService();
     ChargingSchedule *composite = scService->getCompositeSchedule(connectorId, duration);
     DynamicJsonDocument *compositeJson {nullptr};
 
@@ -80,7 +78,7 @@ std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
         if (startSchedule[0] != '\0') {
             strncpy(scheduleStart, startSchedule, JSONDATE_LENGTH + 1);
         } else {
-            ocppModel->getOcppTime().getOcppTimestampNow().toJsonString(scheduleStart, JSONDATE_LENGTH + 1);
+            context.getOcppTime().getOcppTimestampNow().toJsonString(scheduleStart, JSONDATE_LENGTH + 1);
         }
         payload["scheduleStart"] = scheduleStart;
         
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
index 00482796..e9eeb401 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef GETCOMPOSITESCHEDULE_H
@@ -10,17 +10,21 @@
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class GetCompositeSchedule : public OcppMessage {
 private:
+    OcppModel& context;
     int connectorId {-1};
     otime_t duration {0};
     ChargingRateUnitType chargingRateUnit {ChargingRateUnitType::Watt};
 
     const char *errorCode {nullptr};
 public:
-    GetCompositeSchedule();
+    GetCompositeSchedule(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
index 6dd5fd72..e239c3f0 100644
--- a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/GetDiagnostics.h>
@@ -9,7 +9,7 @@
 
 using ArduinoOcpp::Ocpp16::GetDiagnostics;
 
-GetDiagnostics::GetDiagnostics() {
+GetDiagnostics::GetDiagnostics(OcppModel& context) : context(context) {
 
 }
 
@@ -53,8 +53,8 @@ void GetDiagnostics::processReq(JsonObject payload) {
 }
 
 std::unique_ptr<DynamicJsonDocument> GetDiagnostics::createConf(){
-    if (ocppModel && ocppModel->getDiagnosticsService()) {
-        fileName = ocppModel->getDiagnosticsService()->requestDiagnosticsUpload(location, retries, retryInterval, startTime, stopTime);
+    if (auto diagService = context.getDiagnosticsService()) {
+        fileName = diagService->requestDiagnosticsUpload(location, retries, retryInterval, startTime, stopTime);
     } else {
         AO_DBG_WARN("DiagnosticsService has not been initialized before! Please have a look at ArduinoOcpp.cpp for an example. Abort");
         return createEmptyDocument();
diff --git a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
index 52440d7c..23e68671 100644
--- a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
+++ b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef GETDIAGNOSTICS_H
@@ -9,10 +9,14 @@
 #include <ArduinoOcpp/Core/OcppTime.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class GetDiagnostics : public OcppMessage {
 private:
+    OcppModel& context;
     std::string location {};
     int retries = 1;
     unsigned long retryInterval = 180;
@@ -23,7 +27,7 @@ class GetDiagnostics : public OcppMessage {
     
     bool formatError = false;
 public:
-    GetDiagnostics();
+    GetDiagnostics(OcppModel& context);
 
     const char* getOcppOperationType() {return "GetDiagnostics";}
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
index 527261bc..04c9548b 100644
--- a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
@@ -9,7 +9,7 @@
 
 using ArduinoOcpp::Ocpp16::GetLocalListVersion;
 
-GetLocalListVersion::GetLocalListVersion() {
+GetLocalListVersion::GetLocalListVersion(OcppModel& context) : context(context) {
   
 }
 
@@ -24,8 +24,8 @@ void GetLocalListVersion::processReq(JsonObject payload) {
 std::unique_ptr<DynamicJsonDocument> GetLocalListVersion::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    if (ocppModel && ocppModel->getAuthorizationService()) {
-        payload["listVersion"] = ocppModel->getAuthorizationService()->getLocalListVersion();
+    if (auto authService = context.getAuthorizationService()) {
+        payload["listVersion"] = authService->getLocalListVersion();
     } else {
         payload["listVersion"] = -1;
     }
diff --git a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h
index f750cf36..c937342f 100644
--- a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h
+++ b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h
@@ -8,11 +8,16 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class GetLocalListVersion : public OcppMessage {
+private:
+    OcppModel& context;
 public:
-    GetLocalListVersion();
+    GetLocalListVersion(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp b/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
index d019079c..81f26996 100644
--- a/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/Heartbeat.h>
@@ -9,7 +9,7 @@
 
 using ArduinoOcpp::Ocpp16::Heartbeat;
 
-Heartbeat::Heartbeat()  {
+Heartbeat::Heartbeat(OcppModel& context) : context(context) {
   
 }
 
@@ -25,7 +25,7 @@ void Heartbeat::processConf(JsonObject payload) {
   
     const char* currentTime = payload["currentTime"] | "Invalid";
     if (strcmp(currentTime, "Invalid")) {
-        if (ocppModel && ocppModel->getOcppTime().setOcppTime(currentTime)) {
+        if (context.getOcppTime().setOcppTime(currentTime)) {
             //success
             AO_DBG_DEBUG("Request has been accepted");
         } else {
@@ -51,12 +51,10 @@ std::unique_ptr<DynamicJsonDocument> Heartbeat::createConf(){
     //safety mechanism; in some test setups the library could have to answer Heartbeats without valid system time
     OcppTimestamp ocppTimeReference = OcppTimestamp(2019,10,0,11,59,55); 
     OcppTimestamp ocppSelect = ocppTimeReference;
-    if (ocppModel) {
-        auto& ocppNow = ocppModel->getOcppTime().getOcppTimestampNow();
-        if (ocppNow > ocppTimeReference) {
-            //time has already been set
-            ocppSelect = ocppNow;
-        }
+    auto& ocppNow = context.getOcppTime().getOcppTimestampNow();
+    if (ocppNow > ocppTimeReference) {
+        //time has already been set
+        ocppSelect = ocppNow;
     }
 
     char ocppNowJson [JSONDATE_LENGTH + 1] = {'\0'};
diff --git a/src/ArduinoOcpp/MessagesV16/Heartbeat.h b/src/ArduinoOcpp/MessagesV16/Heartbeat.h
index cfde53c7..c035c386 100644
--- a/src/ArduinoOcpp/MessagesV16/Heartbeat.h
+++ b/src/ArduinoOcpp/MessagesV16/Heartbeat.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef HEARTBEAT_H
@@ -8,11 +8,16 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class Heartbeat : public OcppMessage {
+private:
+    OcppModel& context;
 public:
-    Heartbeat();
+    Heartbeat(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index 6af25835..e3e8f462 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
@@ -31,10 +31,6 @@ const char* MeterValues::getOcppOperationType(){
     return "MeterValues";
 }
 
-void MeterValues::initiate() {
-
-}
-
 std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
 
     size_t capacity = 0;
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.h b/src/ArduinoOcpp/MessagesV16/MeterValues.h
index 4c413c79..a0ef53de 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.h
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef METERVALUES_H
@@ -34,8 +34,6 @@ class MeterValues : public OcppMessage {
 
     const char* getOcppOperationType();
 
-    void initiate() override;
-
     std::unique_ptr<DynamicJsonDocument> createReq();
 
     void processConf(JsonObject payload);
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
index 664f03b7..8c52b1cc 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 
@@ -12,7 +12,7 @@
 
 using ArduinoOcpp::Ocpp16::RemoteStartTransaction;
 
-RemoteStartTransaction::RemoteStartTransaction() {
+RemoteStartTransaction::RemoteStartTransaction(OcppModel& context) : context(context) {
   
 }
 
@@ -55,8 +55,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
     bool canStartTransaction = false;
     if (connectorId >= 1) {
         //connectorId specified for given connector, try to start Transaction here
-        if (ocppModel && ocppModel->getConnectorStatus(connectorId)){
-            auto connector = ocppModel->getConnectorStatus(connectorId);
+        if (auto connector = context.getConnectorStatus(connectorId)){
             if (connector->getTransactionId() < 0 &&
                         connector->getAvailability() == AVAILABILITY_OPERATIVE &&
                         connector->getSessionIdTag() == nullptr) {
@@ -65,8 +64,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         }
     } else {
         //connectorId not specified. Find free connector
-        if (ocppModel && ocppModel->getChargePointStatusService()) {
-            auto cpStatusService = ocppModel->getChargePointStatusService();
+        if (auto cpStatusService = context.getChargePointStatusService()) {
             for (int i = 1; i < cpStatusService->getNumConnectors(); i++) {
                 auto connIter = cpStatusService->getConnector(i);
                 if (connIter->getTransactionId() < 0 && 
@@ -84,8 +82,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
 
         auto sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, AO_KEYVALUE_FN, false, false, true, false);
 
-        if (ocppModel && ocppModel->getSmartChargingService()) {
-            auto scService = ocppModel->getSmartChargingService();
+        if (auto scService = context.getSmartChargingService()) {
 
             if (*sRmtProfileId >= 0) {
                 int clearProfileId = *sRmtProfileId;
@@ -100,15 +97,13 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
             }
         }
 
-        if (ocppModel && ocppModel->getConnectorStatus(connectorId)) {
-            auto connector = ocppModel->getConnectorStatus(connectorId);
-
+        if (auto connector = context.getConnectorStatus(connectorId)) {
             connector->beginSession(idTag);
         }
 
         if (!chargingProfileDoc.isNull()
-                && (ocppModel && ocppModel->getSmartChargingService())) {
-            auto scService = ocppModel->getSmartChargingService();
+                && (context.getSmartChargingService())) {
+            auto scService = context.getSmartChargingService();
 
             JsonObject chargingProfile = chargingProfileDoc.as<JsonObject>();
             scService->setChargingProfile(chargingProfile);
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
index f3d077b6..bd076c3c 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef REMOTESTARTTRANSACTION_H
@@ -9,17 +9,21 @@
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class RemoteStartTransaction : public OcppMessage {
 private:
+    OcppModel& context;
     int connectorId;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
     DynamicJsonDocument chargingProfileDoc {0};
     
     const char *errorCode {nullptr};
 public:
-    RemoteStartTransaction();
+    RemoteStartTransaction(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
index 461398b8..2637c330 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/RemoteStopTransaction.h>
@@ -8,7 +8,7 @@
 
 using ArduinoOcpp::Ocpp16::RemoteStopTransaction;
 
-RemoteStopTransaction::RemoteStopTransaction() {
+RemoteStopTransaction::RemoteStopTransaction(OcppModel& context) : context(context) {
   
 }
 
@@ -26,8 +26,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
     
     bool canStopTransaction = false;
 
-    if (ocppModel && ocppModel->getChargePointStatusService()) {
-        auto cpStatusService = ocppModel->getChargePointStatusService();
+    if (auto cpStatusService = context.getChargePointStatusService()) {
         for (int i = 0; i < cpStatusService->getNumConnectors(); i++) {
             auto connIter = cpStatusService->getConnector(i);
             if (connIter->getTransactionId() == transactionId) {
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h
index c8a03a93..b6558941 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef REMOTESTOPTRANSACTION_H
@@ -8,13 +8,17 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class RemoteStopTransaction : public OcppMessage {
 private:
+    OcppModel& context;
     int transactionId;
 public:
-    RemoteStopTransaction();
+    RemoteStopTransaction(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
index 901f4e2d..a1429312 100644
--- a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
@@ -10,7 +10,7 @@
 
 using ArduinoOcpp::Ocpp16::ReserveNow;
 
-ReserveNow::ReserveNow() {
+ReserveNow::ReserveNow(OcppModel& context) : context(context) {
   
 }
 
@@ -42,13 +42,12 @@ void ReserveNow::processReq(JsonObject payload) {
 
     int connectorId = payload["connectorId"];
 
-    ReservationService *rService = nullptr;
-    ChargePointStatusService *cpService = nullptr;
-    if (ocppModel && ocppModel->getReservationService() &&
-                ocppModel->getChargePointStatusService() && ocppModel->getChargePointStatusService()->getConnector(0)) {
-        rService = ocppModel->getReservationService();
-        cpService = ocppModel->getChargePointStatusService();
-        ConnectorStatus *chargePoint = cpService->getConnector(0);
+    if (context.getReservationService() &&
+                context.getChargePointStatusService() &&
+                context.getChargePointStatusService()->getConnector(0)) {
+        auto rService = context.getReservationService();
+        auto cpService = context.getChargePointStatusService();
+        auto chargePoint = cpService->getConnector(0);
 
         if (connectorId >= cpService->getNumConnectors()) {
             errorCode = "PropertyConstraintViolation";
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.h b/src/ArduinoOcpp/MessagesV16/ReserveNow.h
index c8a2e8b5..8c762222 100644
--- a/src/ArduinoOcpp/MessagesV16/ReserveNow.h
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.h
@@ -8,14 +8,18 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class ReserveNow : public OcppMessage {
 private:
+    OcppModel& context;
     const char *errorCode = nullptr;
     const char *reservationStatus = nullptr;
 public:
-    ReserveNow();
+    ReserveNow(OcppModel& context);
 
     ~ReserveNow();
 
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.cpp b/src/ArduinoOcpp/MessagesV16/Reset.cpp
index 4283eea5..747b162b 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Reset.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/Reset.h>
@@ -8,7 +8,7 @@
 
 using ArduinoOcpp::Ocpp16::Reset;
 
-Reset::Reset() {
+Reset::Reset(OcppModel& context) : context(context) {
   
 }
 
@@ -23,8 +23,7 @@ void Reset::processReq(JsonObject payload) {
      */
     bool isHard = !strcmp(payload["type"] | "undefined", "Hard");
 
-    if (ocppModel && ocppModel->getChargePointStatusService()) {
-        auto cpsService = ocppModel->getChargePointStatusService();
+    if (auto cpsService = context.getChargePointStatusService()) {
         if (!cpsService->getExecuteReset()) {
             AO_DBG_ERR("No reset handler set. Abort operation");
             (void)0;
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.h b/src/ArduinoOcpp/MessagesV16/Reset.h
index 7693dddb..2acdb493 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.h
+++ b/src/ArduinoOcpp/MessagesV16/Reset.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef RESET_H
@@ -8,13 +8,17 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class Reset : public OcppMessage {
 private:
+    OcppModel& context;
     bool resetAccepted {false};
 public:
-    Reset();
+    Reset(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp b/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
index 9fef9a67..ab5f6966 100644
--- a/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
+++ b/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
@@ -8,7 +8,7 @@
 
 using ArduinoOcpp::Ocpp16::SendLocalList;
 
-SendLocalList::SendLocalList() {
+SendLocalList::SendLocalList(OcppModel& context) : context(context) {
   
 }
 
@@ -26,11 +26,9 @@ void SendLocalList::processReq(JsonObject payload) {
         return;
     }
 
-    AuthorizationService *authService;
+    auto authService = context.getAuthorizationService();
 
-    if (ocppModel && ocppModel->getAuthorizationService()) {
-        authService = ocppModel->getAuthorizationService();
-    } else {
+    if (!authService) {
         errorCode = "InternalError";
         return;
     }
diff --git a/src/ArduinoOcpp/MessagesV16/SendLocalList.h b/src/ArduinoOcpp/MessagesV16/SendLocalList.h
index 67852fe1..ee2a1dec 100644
--- a/src/ArduinoOcpp/MessagesV16/SendLocalList.h
+++ b/src/ArduinoOcpp/MessagesV16/SendLocalList.h
@@ -8,15 +8,19 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class SendLocalList : public OcppMessage {
 private:
+    OcppModel& context;
     const char *errorCode = nullptr;
     bool updateFailure = true;
     bool versionMismatch = false;
 public:
-    SendLocalList();
+    SendLocalList(OcppModel& context);
 
     ~SendLocalList();
 
diff --git a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
index 5006130a..5f5647da 100644
--- a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
+++ b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/SetChargingProfile.h>
@@ -9,13 +9,12 @@
 
 using ArduinoOcpp::Ocpp16::SetChargingProfile;
 
-SetChargingProfile::SetChargingProfile() {
+SetChargingProfile::SetChargingProfile(OcppModel& context) : context(context) {
 
 }
 
-SetChargingProfile::SetChargingProfile(std::unique_ptr<DynamicJsonDocument> payloadToClient) 
-  : payloadToClient{std::move(payloadToClient)} {
-
+SetChargingProfile::SetChargingProfile(OcppModel& context, std::unique_ptr<DynamicJsonDocument> payloadToClient)
+        : context(context), payloadToClient{std::move(payloadToClient)} {
 }
 
 SetChargingProfile::~SetChargingProfile() {
@@ -32,9 +31,8 @@ void SetChargingProfile::processReq(JsonObject payload) {
 
     JsonObject csChargingProfiles = payload["csChargingProfiles"];
 
-    if (ocppModel && ocppModel->getSmartChargingService()) {
-        auto smartChargingService = ocppModel->getSmartChargingService();
-        smartChargingService->setChargingProfile(csChargingProfiles);
+    if (auto scService = context.getSmartChargingService()) {
+        scService->setChargingProfile(csChargingProfiles);
     }
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.h b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.h
index 1ab388e7..ac58ff08 100644
--- a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.h
+++ b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef SETCHARGINGPROFILE_H
@@ -8,15 +8,19 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class SetChargingProfile : public OcppMessage {
 private:
+    OcppModel& context;
     std::unique_ptr<DynamicJsonDocument> payloadToClient;
 public:
-    SetChargingProfile();
+    SetChargingProfile(OcppModel& context);
 
-    SetChargingProfile(std::unique_ptr<DynamicJsonDocument> payloadToClient);
+    SetChargingProfile(OcppModel& context, std::unique_ptr<DynamicJsonDocument> payloadToClient);
 
     ~SetChargingProfile();
 
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 46c211f1..92eb0702 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -7,7 +7,6 @@
 #include <ArduinoOcpp/Core/OperationStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
-#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
@@ -16,67 +15,41 @@ using ArduinoOcpp::Ocpp16::StartTransaction;
 using ArduinoOcpp::TransactionRPC;
 
 
-StartTransaction::StartTransaction(std::shared_ptr<Transaction> transaction) : transaction(transaction) {
+StartTransaction::StartTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction) : context(context), transaction(transaction) {
     
 }
 
-const char* StartTransaction::getOcppOperationType() {
-    return "StartTransaction";
+StartTransaction::~StartTransaction() {
+    
 }
 
-void StartTransaction::initiate() {
-    if (ocppModel && transaction && !transaction->getStartRpcSync().isRequested()) {
-        //fill out tx data if not happened before
-
-        auto meteringService = ocppModel->getMeteringService();
-        if (transaction->getMeterStart() < 0 && meteringService) {
-            auto meterStart = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionBegin);
-            if (meterStart && *meterStart) {
-                transaction->setMeterStart(meterStart->toInteger());
-            } else {
-                AO_DBG_ERR("MeterStart undefined");
-            }
-        }
-
-        if (transaction->getStartTimestamp() <= MIN_TIME) {
-            transaction->setStartTimestamp(ocppModel->getOcppTime().getOcppTimestampNow());
-        }
-        
-        transaction->getStartRpcSync().setRequested();
-
-        transaction->commit();
-    }
-
-    AO_DBG_INFO("StartTransaction initiated");
+const char* StartTransaction::getOcppOperationType() {
+    return "StartTransaction";
 }
 
-bool StartTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!opStore || !ocppModel || !transaction) {
-        AO_DBG_ERR("-> legacy");
-        return false; //execute legacy initiate instead
+void StartTransaction::initiate(StoredOperationHandler *opStore) {
+    if (!transaction || transaction->getStartRpcSync().isRequested()) {
+        AO_DBG_ERR("initialization error");
+        return;
     }
     
     auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
     (*payload)["connectorId"] = transaction->getConnectorId();
     (*payload)["txNr"] = transaction->getTxNr();
 
-    opStore->setPayload(std::move(payload));
-
-    opStore->commit();
+    if (opStore) {
+        opStore->setPayload(std::move(payload));
+        opStore->commit();
+    }
 
     transaction->getStartRpcSync().setRequested();
 
     transaction->commit();
 
-    return true; //don't execute legacy initiate
+    AO_DBG_INFO("StartTransaction initiated");
 }
 
 bool StartTransaction::restore(StoredOperationHandler *opStore) {
-    if (!ocppModel) {
-        AO_DBG_ERR("invalid state");
-        return false;
-    }
-
     if (!opStore) {
         AO_DBG_ERR("invalid argument");
         return false;
@@ -95,7 +68,7 @@ bool StartTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
-    auto txStore = ocppModel->getTransactionStore();
+    auto txStore = context.getTransactionStore();
 
     if (!txStore) {
         AO_DBG_ERR("invalid state");
@@ -159,8 +132,8 @@ void StartTransaction::processConf(JsonObject payload) {
     transaction->getStartRpcSync().confirm();
     transaction->commit();
 
-    if (ocppModel && ocppModel->getAuthorizationService()) {
-        ocppModel->getAuthorizationService()->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
+    if (auto authService = context.getAuthorizationService()) {
+        authService->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
     }
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.h b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
index 4b43b535..f63b49fe 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef STARTTRANSACTION_H
@@ -12,25 +12,24 @@
 
 namespace ArduinoOcpp {
 
+class OcppModel;
 class Transaction;
-class TransactionRPC;
-class StoredOperationHandler;
 
 namespace Ocpp16 {
 
 class StartTransaction : public OcppMessage {
 private:
+    OcppModel& context;
     std::shared_ptr<Transaction> transaction;
 public:
 
-    StartTransaction(std::shared_ptr<Transaction> transaction);
+    StartTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction);
 
-    StartTransaction() = default; //for debugging only. Make this for the server pendant
+    ~StartTransaction();
 
     const char* getOcppOperationType();
 
-    void initiate();
-    bool initiate(StoredOperationHandler *opStore) override;
+    void initiate(StoredOperationHandler *opStore) override;
 
     bool restore(StoredOperationHandler *opStore) override;
 
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index 37670539..144ab2c0 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -54,38 +54,6 @@ const char* StatusNotification::getOcppOperationType(){
     return "StatusNotification";
 }
 
-void StatusNotification::initiate() {
-    //set the most recent EVSE status, but only if it hasn't been specified by the constructor before
-    if (currentStatus != OcppEvseState::NOT_SET) {
-        return;
-    }
-    
-    if (ocppModel && ocppModel->getChargePointStatusService()) {
-        auto cpsService = ocppModel->getChargePointStatusService();
-        if (connectorId < 0 || connectorId >= cpsService->getNumConnectors()) {
-            if (cpsService->getNumConnectors() == 2) {
-                //special case: EVSE has exactly 1 physical connector -> take status of the connector
-                connectorId = 1;
-            } else {
-                //generic EVSE: take status of the whole EVSE
-                connectorId = 0;
-            }
-        }
-        auto connector = cpsService->getConnector(connectorId);
-        if (connector && currentStatus == OcppEvseState::NOT_SET) {
-            currentStatus = connector->inferenceStatus();
-        }
-    }
-    
-    if (ocppModel && otimestamp == MIN_TIME) {
-        otimestamp = ocppModel->getOcppTime().getOcppTimestampNow();
-    }
-
-    if (currentStatus == OcppEvseState::NOT_SET) {
-        AO_DBG_ERR("Could not determine EVSE status");
-    }
-}
-
 //TODO if the status has changed again when sendReq() is called, abort the operation completely (note: if req is already sent, stick with listening to conf). The OcppEvseStateService will enqueue a new operation itself
 std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4) + (JSONDATE_LENGTH + 1)));
@@ -117,10 +85,6 @@ void StatusNotification::processConf(JsonObject payload) {
     */
 }
 
-StatusNotification::StatusNotification(int connectorId) : connectorId(connectorId) {
-    otimestamp = MIN_TIME;
-}
-
 /*
  * For debugging only
  */
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.h b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
index 5078044e..1ec9916d 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef STATUSNOTIFICATION_H
@@ -21,12 +21,8 @@ class StatusNotification : public OcppMessage {
 public:
     StatusNotification(int connectorId, OcppEvseState currentStatus, const OcppTimestamp &otimestamp, const char *errorCode = nullptr);
 
-    StatusNotification(int connectorId = -1);
-
     const char* getOcppOperationType();
 
-    void initiate();
-
     std::unique_ptr<DynamicJsonDocument> createReq();
 
     void processConf(JsonObject payload);
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index d34691cd..659fb3aa 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -16,52 +16,24 @@
 using ArduinoOcpp::Ocpp16::StopTransaction;
 using ArduinoOcpp::TransactionRPC;
 
-StopTransaction::StopTransaction(std::shared_ptr<Transaction> transaction)
-        : transaction(transaction) {
+StopTransaction::StopTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction)
+        : context(context), transaction(transaction) {
 
 }
 
-StopTransaction::StopTransaction(std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData)
-        : transaction(transaction), transactionData(std::move(transactionData)) {
+StopTransaction::StopTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData)
+        : context(context), transaction(transaction), transactionData(std::move(transactionData)) {
 
 }
 
-StopTransaction::StopTransaction() { }
-
-const char* StopTransaction::getOcppOperationType(){
+const char* StopTransaction::getOcppOperationType() {
     return "StopTransaction";
 }
 
-void StopTransaction::initiate() {
-
-    if (ocppModel && transaction && !transaction->getStopRpcSync().isRequested()) {
-        //fill out tx data if not happened before
-
-        auto meteringService = ocppModel->getMeteringService();
-        if (transaction->getMeterStop() < 0 && meteringService) {
-            auto meterStop = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
-            if (meterStop && *meterStop) {
-                transaction->setMeterStop(meterStop->toInteger());
-            } else {
-                AO_DBG_ERR("MeterStop undefined");
-            }
-        }
-
-        if (transaction->getStopTimestamp() <= MIN_TIME) {
-            transaction->setStopTimestamp(ocppModel->getOcppTime().getOcppTimestampNow());
-        }
-
-        transaction->getStopRpcSync().setRequested();
-
-        transaction->commit();
-    }
-    AO_DBG_INFO("StopTransaction initiated!");
-}
-
-bool StopTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!opStore || !ocppModel || !transaction) {
-        AO_DBG_ERR("-> legacy");
-        return false; //execute legacy initiate instead
+void StopTransaction::initiate(StoredOperationHandler *opStore) {
+    if (!transaction || transaction->getStartRpcSync().isRequested()) {
+        AO_DBG_ERR("initialization error");
+        return;
     }
     
     auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
@@ -76,15 +48,10 @@ bool StopTransaction::initiate(StoredOperationHandler *opStore) {
 
     transaction->commit();
 
-    return true; //don't execute legacy initiate
+    AO_DBG_INFO("StopTransaction initiated");
 }
 
 bool StopTransaction::restore(StoredOperationHandler *opStore) {
-    if (!ocppModel) {
-        AO_DBG_ERR("invalid state");
-        return false;
-    }
-
     if (!opStore) {
         AO_DBG_ERR("invalid argument");
         return false;
@@ -103,7 +70,7 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
-    auto txStore = ocppModel->getTransactionStore();
+    auto txStore = context.getTransactionStore();
 
     if (!txStore) {
         AO_DBG_ERR("invalid state");
@@ -116,7 +83,7 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
-    if (auto mSerivce = ocppModel->getMeteringService()) {
+    if (auto mSerivce = context.getMeteringService()) {
         if (auto txData = mSerivce->getStopTxMeterData(transaction.get())) {
             transactionData = txData->retrieveStopTxData();
         }
@@ -187,8 +154,8 @@ void StopTransaction::processConf(JsonObject payload) {
 
     AO_DBG_INFO("Request has been accepted!");
 
-    if (ocppModel && ocppModel->getAuthorizationService()) {
-        ocppModel->getAuthorizationService()->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
+    if (auto authService = context.getAuthorizationService()) {
+        authService->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
     }
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index 2e27ba8e..58f9cf82 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef STOPTRANSACTION_H
@@ -12,30 +12,29 @@
 
 namespace ArduinoOcpp {
 
+class OcppModel;
+
 class SampledValue;
 class MeterValue;
 
 class Transaction;
-class TransactionRPC;
 
 namespace Ocpp16 {
 
 class StopTransaction : public OcppMessage {
 private:
+    OcppModel& context;
     std::shared_ptr<Transaction> transaction;
     std::vector<std::unique_ptr<MeterValue>> transactionData;
 public:
 
-    StopTransaction(std::shared_ptr<Transaction> transaction);
+    StopTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction);
 
-    StopTransaction(std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData);
-    
-    StopTransaction(); //for debugging only. Make this for the server pendant
+    StopTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData);
 
     const char* getOcppOperationType() override;
 
-    void initiate() override;
-    bool initiate(StoredOperationHandler *opStore) override;
+    void initiate(StoredOperationHandler *opStore) override;
 
     bool restore(StoredOperationHandler *opStore) override;
 
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
index a18e1842..d3ce8ad2 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
@@ -5,6 +5,7 @@
 #include <ArduinoOcpp/MessagesV16/TriggerMessage.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
+#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
@@ -12,6 +13,10 @@
 
 using ArduinoOcpp::Ocpp16::TriggerMessage;
 
+TriggerMessage::TriggerMessage(OcppModel& context) : context(context) {
+
+}
+
 const char* TriggerMessage::getOcppOperationType(){
     return "TriggerMessage";
 }
@@ -26,8 +31,7 @@ void TriggerMessage::processReq(JsonObject payload) {
     statusMessage = "Rejected";
 
     if (!strcmp(requestedMessage, "MeterValues")) {
-        if (ocppModel && ocppModel->getMeteringService()) {
-            auto mService = ocppModel->getMeteringService();
+        if (auto mService = context.getMeteringService()) {
             if (connectorId < 0) {
                 auto nConnectors = mService->getNumConnectors();
                 for (decltype(nConnectors) i = 0; i < nConnectors; i++) {
@@ -40,21 +44,32 @@ void TriggerMessage::processReq(JsonObject payload) {
             }
         }
     } else if (!strcmp(requestedMessage, "StatusNotification")) {
-        if (ocppModel && ocppModel->getChargePointStatusService()) {
-            auto cpsService = ocppModel->getChargePointStatusService();
+        if (auto cpsService = context.getChargePointStatusService()) {
+            unsigned int cIdRangeBegin = 0, cIdRangeEnd = 0;
             if (connectorId < 0) {
-                auto nConnectors = cpsService->getNumConnectors();
-                for (decltype(nConnectors) i = 0; i < nConnectors; i++) {
-                    triggeredOperations.push_back(makeOcppOperation(requestedMessage, i));
-                }
+                cIdRangeEnd = cpsService->getNumConnectors();
             } else if (connectorId < cpsService->getNumConnectors()) {
-                triggeredOperations.push_back(makeOcppOperation(requestedMessage, connectorId));
+                cIdRangeBegin = connectorId;
+                cIdRangeEnd = connectorId + 1;
             } else {
                 errorCode = "PropertyConstraintViolation";
             }
+
+            for (auto i = cIdRangeBegin; i < cIdRangeEnd; i++) {
+                auto connector = cpsService->getConnector(i);
+
+                auto statusNotification = makeOcppOperation(new Ocpp16::StatusNotification(
+                            i,
+                            connector->inferenceStatus(), //will be determined in StatusNotification::initiate
+                            context.getOcppTime().getOcppTimestampNow()));
+
+                statusNotification->setTimeout(60000);
+
+                triggeredOperations.push_back(std::move(statusNotification));
+            }
         }
     } else {
-        auto msg = makeOcppOperation(requestedMessage, connectorId);
+        auto msg = defaultOcppEngine->getOperationDeserializer().deserializeOperation(requestedMessage);
         if (msg) {
             triggeredOperations.push_back(std::move(msg));
         } else {
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.h b/src/ArduinoOcpp/MessagesV16/TriggerMessage.h
index eb6128aa..26572d6d 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.h
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef TRIGGERMESSAGE_H
@@ -11,18 +11,20 @@
 
 namespace ArduinoOcpp {
 
+class OcppModel;
 class OcppOperation;
 
 namespace Ocpp16 {
 
 class TriggerMessage : public OcppMessage {
 private:
+    OcppModel& context;
     std::vector<std::unique_ptr<OcppOperation>> triggeredOperations;
     const char *statusMessage {nullptr};
 
     const char *errorCode = nullptr;
 public:
-    TriggerMessage() = default;
+    TriggerMessage(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
index ed6a338d..3c99fe51 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/UnlockConnector.h>
@@ -11,7 +11,7 @@ using ArduinoOcpp::Ocpp16::UnlockConnector;
 
 #define AO_UNLOCK_TIMEOUT 10000
 
-UnlockConnector::UnlockConnector() {
+UnlockConnector::UnlockConnector(OcppModel& context) : context(context) {
   
 }
 
@@ -23,13 +23,13 @@ void UnlockConnector::processReq(JsonObject payload) {
     
     auto connectorId = payload["connectorId"] | -1;
 
-    if (!ocppModel || !ocppModel->getConnectorStatus(connectorId)) {
+    auto connector = context.getConnectorStatus(connectorId);
+
+    if (!connector) {
         err = true;
         return;
     }
 
-    auto connector = ocppModel->getConnectorStatus(connectorId);
-
     connector->endSession("UnlockCommand");
 
     unlockConnector = connector->getOnUnlockConnector();
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
index f5625b9d..cf3922c5 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef UNLOCKCONNECTOR_H
@@ -10,16 +10,20 @@
 #include <functional>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class UnlockConnector : public OcppMessage {
 private:
+    OcppModel& context;
     bool err = false;
     std::function<PollResult<bool> ()> unlockConnector;
     PollResult<bool> cbUnlockResult;
     unsigned long timerStart = 0; //for timeout
 public:
-    UnlockConnector();
+    UnlockConnector(OcppModel& context);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
index 078f73b4..8e9cfe53 100644
--- a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/UpdateFirmware.h>
@@ -9,7 +9,7 @@
 
 using ArduinoOcpp::Ocpp16::UpdateFirmware;
 
-UpdateFirmware::UpdateFirmware() {
+UpdateFirmware::UpdateFirmware(OcppModel& context) : context(context) {
 
 }
 
@@ -41,8 +41,7 @@ void UpdateFirmware::processReq(JsonObject payload) {
 }
 
 std::unique_ptr<DynamicJsonDocument> UpdateFirmware::createConf(){
-    if (ocppModel && ocppModel->getFirmwareService()) {
-        auto fwService = ocppModel->getFirmwareService();
+    if (auto fwService = context.getFirmwareService()) {
         fwService->scheduleFirmwareUpdate(location, retreiveDate, retries, retryInterval);
     } else {
         AO_DBG_ERR("FirmwareService has not been initialized before! Please have a look at ArduinoOcpp.cpp for an example. Abort");
diff --git a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
index d4841031..656a9f7a 100644
--- a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
+++ b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef UPDATEFIRMWARE_H
@@ -9,17 +9,21 @@
 #include <ArduinoOcpp/Core/OcppTime.h>
 
 namespace ArduinoOcpp {
+
+class OcppModel;
+
 namespace Ocpp16 {
 
 class UpdateFirmware : public OcppMessage {
 private:
+  OcppModel& context;
   std::string location {};
   OcppTimestamp retreiveDate = OcppTimestamp();
   int retries = 1;
   unsigned long retryInterval = 180;
   bool formatError = false;
 public:
-  UpdateFirmware();
+  UpdateFirmware(OcppModel& context);
 
   const char* getOcppOperationType() {return "UpdateFirmware";}
 
diff --git a/src/ArduinoOcpp/OperationDeserializer.cpp b/src/ArduinoOcpp/OperationDeserializer.cpp
new file mode 100644
index 00000000..fd32f37e
--- /dev/null
+++ b/src/ArduinoOcpp/OperationDeserializer.cpp
@@ -0,0 +1,80 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/OperationDeserializer.h>
+#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/OcppOperation.h>
+#include <ArduinoOcpp/Core/OcppError.h>
+#include <ArduinoOcpp/Debug.h>
+#include <algorithm>
+
+using namespace ArduinoOcpp;
+
+OperationDeserializer::OperationDeserializer() {
+
+}
+
+OcppMessageCreator *OperationDeserializer::findCreator(const char *operationType) {
+    for (auto it = registry.begin(); it != registry.end(); ++it) {
+        if (!strcmp(it->operationType, operationType)) {
+            AO_DBG_ERR("success");
+            return &*it;
+        }
+    }
+    return nullptr;
+}
+
+void OperationDeserializer::registerOcppOperation(const char *operationType, std::function<OcppMessage*()> creator) {
+    registry.erase(std::remove_if(registry.begin(), registry.end(),
+                [operationType] (const OcppMessageCreator& el) {
+                    return !strcmp(operationType, el.operationType);
+                }),
+            registry.end());
+    
+    OcppMessageCreator entry;
+    entry.operationType = operationType;
+    entry.creator = creator;
+
+    registry.push_back(entry);
+
+    AO_DBG_DEBUG("registered operation %s", operationType);
+}
+
+void OperationDeserializer::setOnRequest(const char *operationType, OnReceiveReqListener onRequest) {
+    if (auto entry = findCreator(operationType)) {
+        entry->onRequest = onRequest;
+    } else {
+        AO_DBG_ERR("%s not registered", operationType);
+    }
+}
+
+void OperationDeserializer::setOnResponse(const char *operationType, OnSendConfListener onResponse) {
+    if (auto entry = findCreator(operationType)) {
+        entry->onResponse = onResponse;
+    } else {
+        AO_DBG_ERR("%s not registered", operationType);
+    }
+}
+
+std::unique_ptr<OcppOperation> OperationDeserializer::deserializeOperation(const char *operationType) {
+    
+    if (auto entry = findCreator(operationType)) {
+        auto payload = entry->creator();
+        if (payload) {
+            auto result = std::unique_ptr<OcppOperation>(new OcppOperation(
+                                std::unique_ptr<OcppMessage>(payload)));
+            result->setOnReceiveReqListener(entry->onRequest);
+            return result;
+        }
+    }
+
+    return std::unique_ptr<OcppOperation>(new OcppOperation(
+                std::unique_ptr<OcppMessage>(new NotImplemented())));
+}
+
+void OperationDeserializer::debugPrint() {
+    for (auto& creator : registry) {
+        AO_CONSOLE_PRINTF("[AO]     > %s\n", creator.operationType);
+    }
+}
diff --git a/src/ArduinoOcpp/OperationDeserializer.h b/src/ArduinoOcpp/OperationDeserializer.h
new file mode 100644
index 00000000..d41c9096
--- /dev/null
+++ b/src/ArduinoOcpp/OperationDeserializer.h
@@ -0,0 +1,45 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef OPERATIONDESERIALIZER_H
+#define OPERATIONDESERIALIZER_H
+
+#include <functional>
+#include <vector>
+#include <memory>
+#include <ArduinoJson.h>
+#include <ArduinoOcpp/Core/OcppOperationCallbacks.h>
+
+namespace ArduinoOcpp {
+
+class OcppMessage;
+class OcppOperation;
+
+struct OcppMessageCreator {
+    const char *operationType {nullptr};
+    std::function<OcppMessage*()> creator {nullptr};
+    OnReceiveReqListener onRequest {nullptr};
+    OnSendConfListener onResponse {nullptr};
+};
+
+class OperationDeserializer {
+private:
+    std::vector<OcppMessageCreator> registry;
+    OcppMessageCreator *findCreator(const char *operationType);
+
+public:
+    OperationDeserializer();
+
+    void registerOcppOperation(const char *operationType, std::function<OcppMessage*()> creator);
+    void setOnRequest(const char *operationType, OnReceiveReqListener onRequest);
+    void setOnResponse(const char *operationType, OnSendConfListener onResponse);
+    
+    std::unique_ptr<OcppOperation> deserializeOperation(const char *operationType);
+
+    void debugPrint();
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
index 4c302e04..82d947a6 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
@@ -3,303 +3,12 @@
 // MIT License
 
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
-
-#include <ArduinoOcpp/MessagesV16/Authorize.h>
-#include <ArduinoOcpp/MessagesV16/BootNotification.h>
-#include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
-#include <ArduinoOcpp/MessagesV16/Heartbeat.h>
-#include <ArduinoOcpp/MessagesV16/MeterValues.h>
-#include <ArduinoOcpp/MessagesV16/SetChargingProfile.h>
-#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
-#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
-#include <ArduinoOcpp/MessagesV16/TriggerMessage.h>
-#include <ArduinoOcpp/MessagesV16/RemoteStartTransaction.h>
-#include <ArduinoOcpp/Core/OcppError.h>
-#include <ArduinoOcpp/MessagesV16/RemoteStopTransaction.h>
-#include <ArduinoOcpp/MessagesV16/ChangeConfiguration.h>
-#include <ArduinoOcpp/MessagesV16/GetConfiguration.h>
-#include <ArduinoOcpp/MessagesV16/Reset.h>
-#include <ArduinoOcpp/MessagesV16/UpdateFirmware.h>
-#include <ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h>
-#include <ArduinoOcpp/MessagesV16/GetDiagnostics.h>
-#include <ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h>
-#include <ArduinoOcpp/MessagesV16/UnlockConnector.h>
-#include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
-#include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
-#include <ArduinoOcpp/MessagesV16/ClearCache.h>
-#include <ArduinoOcpp/MessagesV16/SendLocalList.h>
-#include <ArduinoOcpp/MessagesV16/GetLocalListVersion.h>
-#include <ArduinoOcpp/MessagesV16/ReserveNow.h>
-#include <ArduinoOcpp/MessagesV16/CancelReservation.h>
-
-#include <ArduinoOcpp/Debug.h>
-
-#include <string.h>
-#include <algorithm>
-#include <vector>
+#include <ArduinoOcpp/Core/OcppMessage.h>
 
 namespace ArduinoOcpp {
 
-class TBDeiniter {
-public:
-    virtual ~TBDeiniter() = default;
-};
-
-std::vector<std::unique_ptr<TBDeiniter>> toBeDeinitialized;
-
-template<class T>
-class TBDeiniterConcrete : public TBDeiniter {
-private:
-    T& obj;
-public:
-    TBDeiniterConcrete(T& obj) : obj(obj) { }
-    ~TBDeiniterConcrete() {obj = nullptr;}
-};
-
-template<class T>
-void deinit_afterwards(T& obj) {
-    toBeDeinitialized.emplace_back(std::unique_ptr<TBDeiniter>{new TBDeiniterConcrete<T>{obj}});
-}
-
-OnReceiveReqListener onAuthorizeRequest;
-void setOnAuthorizeRequestListener(OnReceiveReqListener listener){
-    onAuthorizeRequest = listener;
-    deinit_afterwards(onAuthorizeRequest);
-}
-
-OnReceiveReqListener onBootNotificationRequest;
-void setOnBootNotificationRequestListener(OnReceiveReqListener listener){
-    onBootNotificationRequest = listener;
-    deinit_afterwards(onBootNotificationRequest);
-}
-
-OnReceiveReqListener onSetChargingProfileRequest;
-void setOnSetChargingProfileRequestListener(OnReceiveReqListener listener){
-    onSetChargingProfileRequest = listener;
-    deinit_afterwards(onSetChargingProfileRequest);
-}
-
-OnReceiveReqListener onStartTransactionRequest;
-void setOnStartTransactionRequestListener(OnReceiveReqListener listener){
-    onStartTransactionRequest = listener;
-    deinit_afterwards(onStartTransactionRequest);
-}
-
-OnReceiveReqListener onTriggerMessageRequest;
-void setOnTriggerMessageRequestListener(OnReceiveReqListener listener){
-    onTriggerMessageRequest = listener;
-    deinit_afterwards(onTriggerMessageRequest);
-}
-
-OnReceiveReqListener onRemoteStartTransactionReceiveRequest;
-void setOnRemoteStartTransactionReceiveRequestListener(OnReceiveReqListener listener) {
-    onRemoteStartTransactionReceiveRequest = listener;
-    deinit_afterwards(onRemoteStartTransactionReceiveRequest);
-}
-
-OnSendConfListener onRemoteStartTransactionSendConf;
-void setOnRemoteStartTransactionSendConfListener(OnSendConfListener listener){
-    onRemoteStartTransactionSendConf = listener;
-    deinit_afterwards(onRemoteStartTransactionSendConf);
-}
-
-OnReceiveReqListener onRemoteStopTransactionReceiveRequest;
-void setOnRemoteStopTransactionReceiveRequestListener(OnReceiveReqListener listener){
-    onRemoteStopTransactionReceiveRequest = listener;
-    deinit_afterwards(onRemoteStopTransactionReceiveRequest);
-}
-
-OnSendConfListener onRemoteStopTransactionSendConf;
-void setOnRemoteStopTransactionSendConfListener(OnSendConfListener listener){
-    onRemoteStopTransactionSendConf = listener;
-    deinit_afterwards(onRemoteStopTransactionSendConf);
-}
-
-OnSendConfListener onChangeConfigurationReceiveReq;
-void setOnChangeConfigurationReceiveRequestListener(OnReceiveReqListener listener){
-    onChangeConfigurationReceiveReq = listener;
-    deinit_afterwards(onChangeConfigurationReceiveReq);
-}
-
-OnSendConfListener onChangeConfigurationSendConf;
-void setOnChangeConfigurationSendConfListener(OnSendConfListener listener){
-    onChangeConfigurationSendConf = listener;
-    deinit_afterwards(onChangeConfigurationSendConf);
-}
-
-OnSendConfListener onGetConfigurationReceiveReq;
-void setOnGetConfigurationReceiveReqListener(OnSendConfListener listener){
-    onGetConfigurationReceiveReq = listener;
-    deinit_afterwards(onGetConfigurationReceiveReq);
-}
-
-OnSendConfListener onGetConfigurationSendConf;
-void setOnGetConfigurationSendConfListener(OnSendConfListener listener){
-    onGetConfigurationSendConf = listener;
-    deinit_afterwards(onGetConfigurationSendConf);
-}
-
-OnSendConfListener onResetReceiveReq;
-void setOnResetReceiveRequestListener(OnReceiveReqListener listener) {
-    onResetReceiveReq = listener;
-    deinit_afterwards(onResetReceiveReq);
-}
-
-OnSendConfListener onResetSendConf;
-void setOnResetSendConfListener(OnSendConfListener listener){
-    onResetSendConf = listener;
-    deinit_afterwards(onResetSendConf);
-}
-
-OnReceiveReqListener onUpdateFirmwareReceiveReq;
-void setOnUpdateFirmwareReceiveRequestListener(OnReceiveReqListener listener) {
-    onUpdateFirmwareReceiveReq = listener;
-    deinit_afterwards(onUpdateFirmwareReceiveReq);
-}
-
-OnReceiveReqListener onMeterValuesReceiveReq;
-void setOnMeterValuesReceiveRequestListener(OnReceiveReqListener listener) {
-    onMeterValuesReceiveReq = listener;
-    deinit_afterwards(onMeterValuesReceiveReq);
-}
-
-struct CustomOcppMessageCreatorEntry {
-    const char *messageType;
-    OcppMessageCreator creator;
-    OnReceiveReqListener onReceiveReq;
-};
-
-std::vector<CustomOcppMessageCreatorEntry> customMessagesRegistry;
-void registerCustomOcppMessage(const char *messageType, OcppMessageCreator ocppMessageCreator, OnReceiveReqListener onReceiveReq) {
-    customMessagesRegistry.erase(std::remove_if(customMessagesRegistry.begin(),
-                                               customMessagesRegistry.end(),
-            [messageType](CustomOcppMessageCreatorEntry &el) {
-                return !strcmp(messageType, el.messageType);
-            }),
-        customMessagesRegistry.end());
-
-    CustomOcppMessageCreatorEntry entry;
-    entry.messageType = messageType;
-    entry.creator  = ocppMessageCreator;
-    entry.onReceiveReq = onReceiveReq;
-
-    customMessagesRegistry.push_back(entry);
-}
-
-void simpleOcppFactory_deinitialize() {
-    customMessagesRegistry.clear();
-    toBeDeinitialized.clear();
-}
-
-CustomOcppMessageCreatorEntry *makeCustomOcppMessage(const char *messageType) {
-    for (auto it = customMessagesRegistry.begin(); it != customMessagesRegistry.end(); ++it) {
-        if (!strcmp(it->messageType, messageType)) {
-            return &(*it);
-        }
-    }
-    return nullptr;
-}
-
-std::unique_ptr<OcppOperation> makeFromJson(const JsonDocument& json) {
-    const char* messageType = json[2];
-    return makeOcppOperation(messageType);
-}
-
-std::unique_ptr<OcppOperation> makeOcppOperation(const char *messageType, int connectorId) {
-    auto operation = makeOcppOperation();
-    auto msg = std::unique_ptr<OcppMessage>{nullptr};
-
-    if (CustomOcppMessageCreatorEntry *entry = makeCustomOcppMessage(messageType)) {
-        msg = std::unique_ptr<OcppMessage>(entry->creator());
-        operation->setOnReceiveReqListener(entry->onReceiveReq);
-    } else if (!strcmp(messageType, "Authorize")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::Authorize("A0-00-00-00")); //send default idTag
-        operation->setOnReceiveReqListener(onAuthorizeRequest);
-    } else if (!strcmp(messageType, "BootNotification")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::BootNotification());
-        operation->setOnReceiveReqListener(onBootNotificationRequest);
-    } else if (!strcmp(messageType, "GetCompositeSchedule")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::GetCompositeSchedule());
-    } else if (!strcmp(messageType, "Heartbeat")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::Heartbeat());
-    } else if (!strcmp(messageType, "MeterValues")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::MeterValues());
-        operation->setOnReceiveReqListener(onMeterValuesReceiveReq);
-    } else if (!strcmp(messageType, "SetChargingProfile")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::SetChargingProfile());
-        operation->setOnReceiveReqListener(onSetChargingProfileRequest);
-    } else if (!strcmp(messageType, "StatusNotification")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StatusNotification(connectorId));
-    } else if (!strcmp(messageType, "StartTransaction")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction());
-        operation->setOnReceiveReqListener(onStartTransactionRequest);
-    } else if (!strcmp(messageType, "StopTransaction")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::StopTransaction());
-    } else if (!strcmp(messageType, "TriggerMessage")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::TriggerMessage());
-        operation->setOnReceiveReqListener(onTriggerMessageRequest);
-    } else if (!strcmp(messageType, "RemoteStartTransaction")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::RemoteStartTransaction());
-        operation->setOnReceiveReqListener(onRemoteStartTransactionReceiveRequest);
-        operation->setOnSendConfListener(onRemoteStartTransactionSendConf);
-    } else if (!strcmp(messageType, "RemoteStopTransaction")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::RemoteStopTransaction());
-        operation->setOnReceiveReqListener(onRemoteStopTransactionReceiveRequest);
-        operation->setOnSendConfListener(onRemoteStopTransactionSendConf);
-    } else if (!strcmp(messageType, "ChangeConfiguration")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::ChangeConfiguration());
-        operation->setOnReceiveReqListener(onChangeConfigurationReceiveReq);
-        operation->setOnSendConfListener(onChangeConfigurationSendConf);
-    } else if (!strcmp(messageType, "GetConfiguration")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::GetConfiguration());
-        operation->setOnReceiveReqListener(onGetConfigurationReceiveReq);
-        operation->setOnSendConfListener(onGetConfigurationSendConf);
-    } else if (!strcmp(messageType, "Reset")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::Reset());
-        operation->setOnReceiveReqListener(onResetReceiveReq);
-        operation->setOnSendConfListener(onResetSendConf);
-    } else if (!strcmp(messageType, "UpdateFirmware")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::UpdateFirmware());
-        operation->setOnReceiveReqListener(onUpdateFirmwareReceiveReq);
-    } else if (!strcmp(messageType, "FirmwareStatusNotification")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::FirmwareStatusNotification());
-    } else if (!strcmp(messageType, "GetDiagnostics")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::GetDiagnostics());
-    } else if (!strcmp(messageType, "DiagnosticsStatusNotification")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::DiagnosticsStatusNotification());
-    } else if (!strcmp(messageType, "UnlockConnector")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::UnlockConnector());
-    } else if (!strcmp(messageType, "ClearChargingProfile")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::ClearChargingProfile());
-    } else if (!strcmp(messageType, "ChangeAvailability")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::ChangeAvailability());
-    } else if (!strcmp(messageType, "ClearCache")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::ClearCache());
-    } else if (!strcmp(messageType, "SendLocalList")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::SendLocalList());
-    } else if (!strcmp(messageType, "GetLocalListVersion")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::GetLocalListVersion());
-    } else if (!strcmp(messageType, "ReserveNow")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::ReserveNow());
-    } else if (!strcmp(messageType, "CancelReservation")) {
-        msg = std::unique_ptr<OcppMessage>(new Ocpp16::CancelReservation());
-    } else {
-        AO_DBG_WARN("Operation not supported");
-        msg = std::unique_ptr<OcppMessage>(new NotImplemented());
-    }
-
-    if (msg == nullptr) {
-        return nullptr;
-    } else {
-        operation->setOcppMessage(std::move(msg));
-        return operation;
-    }
-}
-
 std::unique_ptr<OcppOperation> makeOcppOperation(OcppMessage *msg){
     if (msg == nullptr) {
-        AO_DBG_ERR("msg is null");
         return nullptr;
     }
     auto operation = makeOcppOperation();
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.h b/src/ArduinoOcpp/SimpleOcppOperationFactory.h
index 875b90ad..6eefedbb 100644
--- a/src/ArduinoOcpp/SimpleOcppOperationFactory.h
+++ b/src/ArduinoOcpp/SimpleOcppOperationFactory.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef SIMPLEOCPPOPERATIONFACTORY_H
@@ -12,37 +12,11 @@
 
 namespace ArduinoOcpp {
 
-using OcppMessageCreator = std::function<OcppMessage*()>;
-
-std::unique_ptr<OcppOperation> makeFromJson(const JsonDocument& request);
+class OcppMessage;
 
 std::unique_ptr<OcppOperation> makeOcppOperation();
 
 std::unique_ptr<OcppOperation> makeOcppOperation(OcppMessage *msg);
 
-std::unique_ptr<OcppOperation> makeOcppOperation(const char *actionCode, int connectorId = -1);
-
-void registerCustomOcppMessage(const char *messageType, OcppMessageCreator ocppMessageCreator, OnReceiveReqListener onReceiveReq = NULL);
-
-void setOnAuthorizeRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnBootNotificationRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnSetChargingProfileRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnStartTransactionRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnTriggerMessageRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnRemoteStartTransactionReceiveRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnRemoteStartTransactionSendConfListener(OnSendConfListener onSendConf);
-void setOnRemoteStopTransactionReceiveRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnRemoteStopTransactionSendConfListener(OnSendConfListener onSendConf);
-void setOnChangeConfigurationReceiveRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnChangeConfigurationSendConfListener(OnSendConfListener onSendConf);
-void setOnGetConfigurationReceiveRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnGetConfigurationSendConfListener(OnSendConfListener onSendConf);
-void setOnResetReceiveRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnResetSendConfListener(OnSendConfListener onSendConf);
-void setOnUpdateFirmwareReceiveRequestListener(OnReceiveReqListener onReceiveReq);
-void setOnMeterValuesReceiveRequestListener(OnReceiveReqListener onReceiveReq);
-
-void simpleOcppFactory_deinitialize();
-
 } //end namespace ArduinoOcpp
 #endif
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
index d0c0473f..3ce894bc 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
@@ -52,7 +52,7 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
 
     JsonArray collection = payload["localAuthorizationList"];
 
-    for (int i = 0; i < collection.size(); i++) {
+    for (size_t i = 0; i < collection.size(); i++) {
 
         //check if JSON object is valid
         if (!collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAG(compact))) {
@@ -76,7 +76,7 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
         //also, build index here
         collection_index = std::vector<int>(collection.size(), -1);
 
-        for (int i = 0; i < collection.size(); i++) {
+        for (size_t i = 0; i < collection.size(); i++) {
 
             //check if locally stored auth info is present; if yes, apply it to the index
             AuthorizationData *found = get(collection[i][AUTHDATA_KEY_IDTAG(compact)]);
@@ -112,13 +112,13 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
     if (compact) {
         localAuthorizationList.clear();
 
-        for (int i = 0; i < collection.size(); i++) {
+        for (size_t i = 0; i < collection.size(); i++) {
             localAuthorizationList.push_back(AuthorizationData());
             localAuthorizationList.back().readJson(collection[i], compact);
         }
     } else if (differential) {
 
-        for (int i = 0; i < collection.size(); i++) {
+        for (size_t i = 0; i < collection.size(); i++) {
 
             //is entry a remove command?
             if (!collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
@@ -148,7 +148,7 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
     } else {
         localAuthorizationList.clear();
 
-        for (int i = 0; i < collection.size(); i++) {
+        for (size_t i = 0; i < collection.size(); i++) {
             if (collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
                 localAuthorizationList.push_back(AuthorizationData());
                 localAuthorizationList.back().readJson(collection[i], compact);
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index 3d39ead8..39e60145 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -3,9 +3,12 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/MessagesV16/GetLocalListVersion.h>
+#include <ArduinoOcpp/MessagesV16/SendLocalList.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Debug.h>
@@ -36,6 +39,11 @@ AuthorizationService::AuthorizationService(OcppEngine& context, std::shared_ptr<
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
 
+    context.getOperationDeserializer().registerOcppOperation("GetLocalListVersion", [&context] () {
+        return new Ocpp16::GetLocalListVersion(context.getOcppModel());});
+    context.getOperationDeserializer().registerOcppOperation("SendLocalList", [&context] () {
+        return new Ocpp16::SendLocalList(context.getOcppModel());});
+
     loadLists();
 }
 
@@ -176,9 +184,14 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     if (!equivalent) {
         //send error code "LocalListConflict" to server
 
+        OcppEvseState cpStatus;
+        if (auto cp = context.getOcppModel().getConnectorStatus(0)) {
+            cpStatus = cp->inferenceStatus();
+        }
+
         auto statusNotification = makeOcppOperation(new Ocpp16::StatusNotification(
                     0,
-                    OcppEvseState::NOT_SET, //will be determined in StatusNotification::initiate
+                    cpStatus, //will be determined in StatusNotification::initiate
                     context.getOcppModel().getOcppTime().getOcppTimestampNow(),
                     "LocalListConflict"));
 
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
index 0226dd35..8cad55f5 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
@@ -35,6 +35,10 @@ BootService::BootService(OcppEngine& context) : context(context) {
         AO_DBG_ERR("initialization error");
         (void)0;
     }
+
+    //Register message handler for TriggerMessage operation
+    context.getOperationDeserializer().registerOcppOperation("BootNotification", [this] () {
+        return new Ocpp16::BootNotification(this->context.getOcppModel(), getChargePointCredentials());});
 }
 
 void BootService::loop() {
@@ -61,26 +65,49 @@ void BootService::loop() {
      * Create BootNotification. The BootNotifaction object will fetch its paremeters from
      * this class and notify this class about the response
      */
-    auto bootNotification = makeOcppOperation(new Ocpp16::BootNotification());
+    auto bootNotification = makeOcppOperation(new Ocpp16::BootNotification(context.getOcppModel(), getChargePointCredentials()));
     bootNotification->setTimeout(0);
     context.initiatePreBootOperation(std::move(bootNotification));
 
     lastBootNotification = ao_tick_ms();
 }
 
-void BootService::setChargePointCredentials(const char *credentialsJson) {
-    cpCredentials = credentialsJson;
+void BootService::setChargePointCredentials(JsonObject credentials) {
+    auto written = serializeJson(credentials, cpCredentials);
+    if (written < 2) {
+        AO_DBG_ERR("serialization error");
+        cpCredentials = "{}";
+    }
+}
+
+void BootService::setChargePointCredentials(const char *credentials) {
+    cpCredentials = credentials;
     if (cpCredentials.size() < 2) {
         cpCredentials = "{}";
     }
 }
 
-std::string& BootService::getChargePointCredentials() {
+std::unique_ptr<DynamicJsonDocument> BootService::getChargePointCredentials() {
     if (cpCredentials.size() <= 2) {
-        cpCredentials = "{}";
+        return createEmptyDocument();
     }
 
-    return cpCredentials;
+    std::unique_ptr<DynamicJsonDocument> doc;
+    size_t capacity = JSON_OBJECT_SIZE(9) + cpCredentials.size();
+    DeserializationError err = DeserializationError::NoMemory;
+    while (err == DeserializationError::NoMemory && capacity <= AO_MAX_JSON_CAPACITY) {
+        doc.reset(new DynamicJsonDocument(capacity));
+        err = deserializeJson(*doc, cpCredentials);
+
+        capacity *= 2;
+    }
+
+    if (!err) {
+        return doc;
+    } else {
+        AO_DBG_ERR("could not parse stored credentials: %s", err.c_str());
+        return nullptr;
+    }
 }
 
 void BootService::notifyRegistrationStatus(RegistrationStatus status) {
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.h b/src/ArduinoOcpp/Tasks/Boot/BootService.h
index f6883986..e37a16bf 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.h
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.h
@@ -44,8 +44,9 @@ class BootService {
 
     void loop();
 
-    void setChargePointCredentials(const char *credentialsJson);
-    std::string& getChargePointCredentials();
+    void setChargePointCredentials(JsonObject credentials);
+    void setChargePointCredentials(const char *credentials); //credentials: serialized BootNotification payload
+    std::unique_ptr<DynamicJsonDocument> getChargePointCredentials();
 
     void notifyRegistrationStatus(RegistrationStatus status);
     void setRetryInterval(unsigned long interval);
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 97ba992d..42255f77 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -6,6 +6,20 @@
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
+#include <ArduinoOcpp/MessagesV16/ChangeConfiguration.h>
+#include <ArduinoOcpp/MessagesV16/ClearCache.h>
+#include <ArduinoOcpp/MessagesV16/GetConfiguration.h>
+#include <ArduinoOcpp/MessagesV16/RemoteStartTransaction.h>
+#include <ArduinoOcpp/MessagesV16/RemoteStopTransaction.h>
+#include <ArduinoOcpp/MessagesV16/Reset.h>
+#include <ArduinoOcpp/MessagesV16/TriggerMessage.h>
+#include <ArduinoOcpp/MessagesV16/UnlockConnector.h>
+
+#include <ArduinoOcpp/MessagesV16/Authorize.h>
+#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
+#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
+#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -52,6 +66,40 @@ ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned
      */
     declareConfiguration<bool>("AuthorizeRemoteTxRequests",false,CONFIGURATION_VOLATILE,false,true,false,false);
     declareConfiguration<int>("GetConfigurationMaxKeys",30,CONFIGURATION_VOLATILE,false,true,false,false);
+
+    
+    context.getOperationDeserializer().registerOcppOperation("ChangeAvailability", [&context] () {
+        return new Ocpp16::ChangeAvailability(context.getOcppModel());});
+    context.getOperationDeserializer().registerOcppOperation("ChangeConfiguration", [] () {
+        return new Ocpp16::ChangeConfiguration();});
+    context.getOperationDeserializer().registerOcppOperation("ClearCache", [] () {
+        return new Ocpp16::ClearCache();});
+    context.getOperationDeserializer().registerOcppOperation("GetConfiguration", [] () {
+        return new Ocpp16::GetConfiguration();});
+    context.getOperationDeserializer().registerOcppOperation("RemoteStartTransaction", [&context] () {
+        return new Ocpp16::RemoteStartTransaction(context.getOcppModel());});
+    context.getOperationDeserializer().registerOcppOperation("RemoteStopTransaction", [&context] () {
+        return new Ocpp16::RemoteStopTransaction(context.getOcppModel());});
+    context.getOperationDeserializer().registerOcppOperation("Reset", [&context] () {
+        return new Ocpp16::Reset(context.getOcppModel());});
+    context.getOperationDeserializer().registerOcppOperation("TriggerMessage", [&context] () {
+        return new Ocpp16::TriggerMessage(context.getOcppModel());});
+    context.getOperationDeserializer().registerOcppOperation("UnlockConnector", [&context] () {
+        return new Ocpp16::UnlockConnector(context.getOcppModel());});
+
+    /*
+     * Register further message handlers to support echo mode: when this library
+     * is connected with a WebSocket echo server, let it reply to its own requests.
+     * Mocking an OCPP Server on the same device makes running (unit) tests easier.
+     */
+    context.getOperationDeserializer().registerOcppOperation("Authorize", [&context] () {
+        return new Ocpp16::Authorize(context.getOcppModel(), nullptr);});
+    context.getOperationDeserializer().registerOcppOperation("StartTransaction", [&context] () {
+        return new Ocpp16::StartTransaction(context.getOcppModel(), nullptr);});
+    context.getOperationDeserializer().registerOcppOperation("StatusNotification", [&context] () {
+        return new Ocpp16::StatusNotification(-1, OcppEvseState::NOT_SET, OcppTimestamp());});
+    context.getOperationDeserializer().registerOcppOperation("StopTransaction", [&context] () {
+        return new Ocpp16::StopTransaction(context.getOcppModel(), nullptr);});
 }
 
 ChargePointStatusService::~ChargePointStatusService() {
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 052bd328..82cdbae9 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -266,7 +266,7 @@ OcppMessage *ConnectorStatus::loop() {
                     context.getMeteringService()->beginTxMeterData(transaction.get());
                 }
 
-                return new StartTransaction(transaction);
+                return new StartTransaction(context, transaction);
             }
         } else if (transaction->isRunning()) {
 
@@ -317,9 +317,9 @@ OcppMessage *ConnectorStatus::loop() {
                 }
 
                 if (stopTxData) {
-                    return new StopTransaction(std::move(transaction), stopTxData->retrieveStopTxData());
+                    return new StopTransaction(context, std::move(transaction), stopTxData->retrieveStopTxData());
                 } else {
-                    return new StopTransaction(std::move(transaction));
+                    return new StopTransaction(context, std::move(transaction));
                 }
             }
         }
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
index 8540b4d6..983d5ec2 100644
--- a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
+++ b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
@@ -9,6 +9,7 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
+#include <ArduinoOcpp/MessagesV16/GetDiagnostics.h>
 #include <ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h>
 
 using namespace ArduinoOcpp;
@@ -24,6 +25,13 @@ DiagnosticsService::DiagnosticsService(OcppEngine& context) : context(context) {
         fProfilePlus += fpId;
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
+    
+    context.getOperationDeserializer().registerOcppOperation("GetDiagnostics", [&context] () {
+        return new Ocpp16::GetDiagnostics(context.getOcppModel());});
+
+    //Register message handler for TriggerMessage operation
+    context.getOperationDeserializer().registerOcppOperation("DiagnosticsStatusNotification", [this] () {
+        return new Ocpp16::DiagnosticsStatusNotification(getDiagnosticsStatus());});
 }
 
 void DiagnosticsService::loop() {
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index eefc9e78..4eaf7124 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
@@ -7,8 +7,10 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/OperationDeserializer.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 
+#include <ArduinoOcpp/MessagesV16/UpdateFirmware.h>
 #include <ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h>
 
 #include <ArduinoOcpp/Platform.h>
@@ -27,6 +29,13 @@ FirmwareService::FirmwareService(OcppEngine& context) : context(context) {
         fProfilePlus += fpId;
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
+    
+    context.getOperationDeserializer().registerOcppOperation("UpdateFirmware", [&context] () {
+        return new Ocpp16::UpdateFirmware(context.getOcppModel());});
+
+    //Register message handler for TriggerMessage operation
+    context.getOperationDeserializer().registerOcppOperation("FirmwareStatusNotification", [this] () {
+        return new Ocpp16::FirmwareStatusNotification(getFirmwareStatus());});
 }
 
 void FirmwareService::setBuildNumber(const char *buildNumber) {
diff --git a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
index 06e57647..9a6a777e 100644
--- a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
+++ b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
@@ -14,6 +14,10 @@ using namespace ArduinoOcpp;
 HeartbeatService::HeartbeatService(OcppEngine& context) : context(context) {
     heartbeatInterval = declareConfiguration("HeartbeatInterval", 86400);
     lastHeartbeat = ao_tick_ms();
+
+    //Register message handler for TriggerMessage operation
+    context.getOperationDeserializer().registerOcppOperation("Heartbeat", [&context] () {
+        return new Ocpp16::Heartbeat(context.getOcppModel());});
 }
 
 void HeartbeatService::loop() {
@@ -24,7 +28,7 @@ void HeartbeatService::loop() {
     if (now - lastHeartbeat >= hbInterval) {
         lastHeartbeat = now;
 
-        auto heartbeat = makeOcppOperation("Heartbeat");
+        auto heartbeat = makeOcppOperation(new Ocpp16::Heartbeat(context.getOcppModel()));
         context.initiateOperation(std::move(heartbeat));
     }
 }
diff --git a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
index 05e2c57f..d1716130 100644
--- a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
+++ b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef HEARTBEATSERVICE_H
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index 39b86905..298a823b 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
@@ -7,6 +7,7 @@
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/MessagesV16/MeterValues.h>
 #include <ArduinoOcpp/Debug.h>
 
 using namespace ArduinoOcpp;
@@ -17,6 +18,14 @@ MeteringService::MeteringService(OcppEngine& context, int numConn, std::shared_p
     for (int i = 0; i < numConn; i++) {
         connectors.push_back(std::unique_ptr<ConnectorMeterValuesRecorder>(new ConnectorMeterValuesRecorder(context.getOcppModel(), i, meterStore)));
     }
+
+    /*
+     * Register further message handlers to support echo mode: when this library
+     * is connected with a WebSocket echo server, let it reply to its own requests.
+     * Mocking an OCPP Server on the same device makes running (unit) tests easier.
+     */
+    context.getOperationDeserializer().registerOcppOperation("MeterValues", [] () {
+        return new Ocpp16::MeterValues();});
 }
 
 void MeteringService::loop(){
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index dc10aea0..4e5629b5 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -7,6 +7,8 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/MessagesV16/CancelReservation.h>
+#include <ArduinoOcpp/MessagesV16/ReserveNow.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -32,6 +34,11 @@ ReservationService::ReservationService(OcppEngine& context, unsigned int numConn
         fProfilePlus += fpId;
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
+    
+    context.getOperationDeserializer().registerOcppOperation("CancelReservation", [&context] () {
+        return new Ocpp16::CancelReservation(context.getOcppModel());});
+    context.getOperationDeserializer().registerOcppOperation("ReserveNow", [&context] () {
+        return new Ocpp16::ReserveNow(context.getOcppModel());});
 }
 
 void ReservationService::loop() {
@@ -63,7 +70,7 @@ void ReservationService::loop() {
         }
 
         //check if tx with same idTag or reservationId has started
-        for (unsigned int cId = 1; cId < cpService->getNumConnectors(); cId++) {
+        for (int cId = 1; cId < cpService->getNumConnectors(); cId++) {
             auto& transaction = cpService->getConnector(cId)->getTransaction();
             if (transaction) {
                 const char *cIdTag = transaction->getIdTag();
@@ -156,7 +163,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
 
     unsigned int availableCount = 0;
     if (auto cpService = context.getOcppModel().getChargePointStatusService()) {
-        for (unsigned int iconn = 1; iconn < cpService->getNumConnectors(); iconn++) {
+        for (int iconn = 1; iconn < cpService->getNumConnectors(); iconn++) {
             if (iconn == connectorId) {
                 //don't count this connector
                 continue;
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index fc422b2a..d691c073 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
@@ -7,6 +7,9 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
+#include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
+#include <ArduinoOcpp/MessagesV16/SetChargingProfile.h>
 #include <ArduinoOcpp/Debug.h>
 
 #if !defined(AO_DEACTIVATE_FLASH) && defined(AO_DEACTIVATE_FLASH_SMARTCHARGING)
@@ -75,6 +78,13 @@ SmartChargingService::SmartChargingService(OcppEngine& context, float chargeLimi
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
 
+    context.getOperationDeserializer().registerOcppOperation("ClearChargingProfile", [&context] () {
+        return new Ocpp16::ClearChargingProfile(context.getOcppModel());});
+    context.getOperationDeserializer().registerOcppOperation("GetCompositeSchedule", [&context] () {
+        return new Ocpp16::GetCompositeSchedule(context.getOcppModel());});
+    context.getOperationDeserializer().registerOcppOperation("SetChargingProfile", [&context] () {
+        return new Ocpp16::SetChargingProfile(context.getOcppModel());});
+
     loadProfiles();
 }
 
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 58d45cb6..6209d272 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -18,6 +18,9 @@ TEST_CASE( "Charging sessions" ) {
     OcppEchoSocket echoSocket;
     OCPP_initialize(echoSocket);
 
+    auto engine = getOcppEngine();
+    auto& checkMsg = engine->getOperationDeserializer();
+
     ao_set_timer(custom_timer_cb);
 
     auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN);
@@ -27,7 +30,8 @@ TEST_CASE( "Charging sessions" ) {
     
     std::array<const char*, 2> expectedSN {"Available", "Available"};
     std::array<bool, 2> checkedSN {false, false};
-    registerCustomOcppMessage("StatusNotification", [] () {return new Ocpp16::StatusNotification();},
+    checkMsg.registerOcppOperation("StatusNotification", [] () -> OcppMessage* {return new Ocpp16::StatusNotification(0, OcppEvseState::NOT_SET, MIN_TIME);});
+    checkMsg.setOnRequest("StatusNotification",
         [&checkedSN, &expectedSN] (JsonObject request) {
             int connectorId = request["connectorId"] | -1;
             checkedSN[connectorId] = !strcmp(request["status"] | "Invalid", expectedSN[connectorId]);
@@ -38,7 +42,8 @@ TEST_CASE( "Charging sessions" ) {
     SECTION("Check idle state"){
 
         bool checkedBN = false;
-        registerCustomOcppMessage("BootNotification", [] () {return new Ocpp16::BootNotification();},
+        checkMsg.registerOcppOperation("BootNotification", [engine] () -> OcppMessage* {return new Ocpp16::BootNotification(engine->getOcppModel(), std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(0)));});
+        checkMsg.setOnRequest("BootNotification",
             [&checkedBN] (JsonObject request) {
                 checkedBN = !strcmp(request["chargePointModel"] | "Invalid", "dummy1234");
             });

From b27b6a1d015584ddf0355ee09fb4d35315645a88 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 26 Mar 2023 14:22:04 +0200
Subject: [PATCH 206/549] fix compiler warnings

---
 src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp | 2 +-
 src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp     | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index 39e60145..d8266350 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -184,7 +184,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     if (!equivalent) {
         //send error code "LocalListConflict" to server
 
-        OcppEvseState cpStatus;
+        OcppEvseState cpStatus = OcppEvseState::NOT_SET;
         if (auto cp = context.getOcppModel().getConnectorStatus(0)) {
             cpStatus = cp->inferenceStatus();
         }
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index 4e5629b5..1c0129a2 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -164,7 +164,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
     unsigned int availableCount = 0;
     if (auto cpService = context.getOcppModel().getChargePointStatusService()) {
         for (int iconn = 1; iconn < cpService->getNumConnectors(); iconn++) {
-            if (iconn == connectorId) {
+            if (iconn == (int) connectorId) {
                 //don't count this connector
                 continue;
             }
@@ -208,6 +208,7 @@ bool ReservationService::updateReservation(JsonObject payload) {
 //                payload.containsKey("parentIdTag") ? payload["parentIdTag"] : nullptr)) {
 //    if (auto reservation = getReservation(payload["connectorId"].as<int>())) {
         AO_DBG_DEBUG("found blocking reservation at connectorId %u", reservation->getConnectorId());
+        (void)reservation;
         return false;
     }
 

From ecd80fd39f99683478390a6525a20eedd6f617c0 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 28 Mar 2023 19:00:05 +0200
Subject: [PATCH 207/549] add Custom Message wrapper

---
 CMakeLists.txt                                |  1 +
 src/ArduinoOcpp/MessagesV16/CustomMessage.cpp | 99 +++++++++++++++++++
 src/ArduinoOcpp/MessagesV16/CustomMessage.h   | 69 +++++++++++++
 3 files changed, 169 insertions(+)
 create mode 100644 src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
 create mode 100644 src/ArduinoOcpp/MessagesV16/CustomMessage.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 9e66b668..bbb44630 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -27,6 +27,7 @@ set(AO_SRC
     src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
     src/ArduinoOcpp/MessagesV16/ClearCache.cpp
     src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
+    src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
     src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
     src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
     src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp b/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
new file mode 100644
index 00000000..029d7c26
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
@@ -0,0 +1,99 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/MessagesV16/CustomMessage.h>
+
+using ArduinoOcpp::Ocpp16::CustomMessage;
+
+CustomMessage::CustomMessage(const char *operationType,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
+            std::function<void (JsonObject)> fn_processConf,
+            std::function<bool (const char*, const char*, JsonObject)> fn_processErr,
+            std::function<void (StoredOperationHandler*)> fn_initiate,
+            std::function<bool (StoredOperationHandler*)> fn_restore) :
+        operationType{operationType},
+        fn_createReq{fn_createReq},
+        fn_processConf{fn_processConf},
+        fn_processErr{fn_processErr},
+        fn_initiate{fn_initiate},
+        fn_restore{fn_restore} {
+    
+}
+
+CustomMessage::CustomMessage(const char *operationType,
+            std::function<void (JsonObject)> fn_processReq,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf,
+            std::function<const char* ()> fn_getErrorCode,
+            std::function<const char* ()> fn_getErrorDescription,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_getErrorDetails) :
+        operationType{operationType},
+        fn_processReq{fn_processReq},
+        fn_createConf{fn_createConf},
+        fn_getErrorCode{fn_getErrorCode},
+        fn_getErrorDescription{fn_getErrorDescription},
+        fn_getErrorDetails{fn_getErrorDetails} {
+    
+}
+
+CustomMessage::~CustomMessage() {
+
+}
+
+const char* CustomMessage::getOcppOperationType() {
+    return operationType.c_str();
+}
+
+void CustomMessage::initiate(StoredOperationHandler *opStore) {
+    if (fn_initiate) {
+        fn_initiate(opStore);
+    }
+}
+
+bool CustomMessage::restore(StoredOperationHandler *opStore) {
+    if (fn_restore) {
+        return fn_restore(opStore);
+    } else {
+        return false;
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> CustomMessage::createReq() {
+    return fn_createReq();
+}
+
+void CustomMessage::processConf(JsonObject payload) {
+    return fn_processConf(payload);
+}
+
+void CustomMessage::processReq(JsonObject payload) {
+    return fn_processReq(payload);
+}
+
+std::unique_ptr<DynamicJsonDocument> CustomMessage::createConf() {
+    return fn_createConf();
+}
+
+const char *CustomMessage::getErrorCode() {
+    if (fn_getErrorCode) {
+        return fn_getErrorCode();
+    } else {
+        return nullptr;
+    }
+}
+
+const char *CustomMessage::getErrorDescription() {
+    if (fn_getErrorDescription) {
+        return fn_getErrorDescription();
+    } else {
+        return "";
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> CustomMessage::getErrorDetails() {
+    if (fn_getErrorDetails) {
+        return fn_getErrorDetails();
+    } else {
+        return createEmptyDocument();
+    }
+}
diff --git a/src/ArduinoOcpp/MessagesV16/CustomMessage.h b/src/ArduinoOcpp/MessagesV16/CustomMessage.h
new file mode 100644
index 00000000..84062bfa
--- /dev/null
+++ b/src/ArduinoOcpp/MessagesV16/CustomMessage.h
@@ -0,0 +1,69 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef FUNCTIONALMESSAGE_H
+#define FUNCTIONALMESSAGE_H
+
+#include <ArduinoOcpp/Core/OcppMessage.h>
+
+#include <functional>
+
+namespace ArduinoOcpp {
+
+namespace Ocpp16 {
+
+class CustomMessage : public OcppMessage {
+private:
+    std::string operationType;
+    std::function<void (StoredOperationHandler*)> fn_initiate; //optional
+    std::function<bool (StoredOperationHandler*)> fn_restore;  //optional
+    std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq;
+    std::function<void (JsonObject)> fn_processConf;
+    std::function<bool (const char*, const char*, JsonObject)> fn_processErr;  //optional
+    std::function<void (JsonObject)> fn_processReq;
+    std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf;
+    std::function<const char* ()> fn_getErrorCode;            //optional
+    std::function<const char* ()> fn_getErrorDescription;     //optional
+    std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_getErrorDetails; //optional
+public:
+
+    //for operations initiated at this device
+    CustomMessage(const char *operationType,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
+            std::function<void (JsonObject)> fn_processConf,
+            std::function<bool (const char*, const char*, JsonObject)> fn_processErr = nullptr,
+            std::function<void (StoredOperationHandler*)> fn_initiate = nullptr,
+            std::function<bool (StoredOperationHandler*)> fn_restore = nullptr);
+    
+    //for operations receied from remote
+    CustomMessage(const char *operationType,
+            std::function<void (JsonObject)> fn_processReq,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf,
+            std::function<const char* ()> fn_getErrorCode = nullptr,
+            std::function<const char* ()> fn_getErrorDescription = nullptr,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_getErrorDetails = nullptr);
+    
+    ~CustomMessage();
+
+    const char* getOcppOperationType() override;
+
+    void initiate(StoredOperationHandler *opStore) override;
+
+    bool restore(StoredOperationHandler *opStore) override;
+
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
+
+    void processConf(JsonObject payload) override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    const char *getErrorCode() override;
+    const char *getErrorDescription() override;
+    std::unique_ptr<DynamicJsonDocument> getErrorDetails() override;
+};
+
+} //end namespace Ocpp16
+} //end namespace ArduinoOcpp
+#endif

From 155f37f221ca837c6f97765293b12e8faef2bd97 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 28 Mar 2023 19:08:32 +0200
Subject: [PATCH 208/549] fix -Werror=reorder

---
 src/ArduinoOcpp/MessagesV16/CustomMessage.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp b/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
index 029d7c26..26b31d46 100644
--- a/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
@@ -13,11 +13,11 @@ CustomMessage::CustomMessage(const char *operationType,
             std::function<void (StoredOperationHandler*)> fn_initiate,
             std::function<bool (StoredOperationHandler*)> fn_restore) :
         operationType{operationType},
+        fn_initiate{fn_initiate},
+        fn_restore{fn_restore},
         fn_createReq{fn_createReq},
         fn_processConf{fn_processConf},
-        fn_processErr{fn_processErr},
-        fn_initiate{fn_initiate},
-        fn_restore{fn_restore} {
+        fn_processErr{fn_processErr} {
     
 }
 

From c186fbc0d5086a6105985156b1725817970e5af5 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 5 Apr 2023 22:29:40 +0200
Subject: [PATCH 209/549] minor fixes

---
 src/ArduinoOcpp/OperationDeserializer.cpp                    | 1 -
 src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp | 2 +-
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp  | 1 +
 3 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/OperationDeserializer.cpp b/src/ArduinoOcpp/OperationDeserializer.cpp
index fd32f37e..d10a3c8c 100644
--- a/src/ArduinoOcpp/OperationDeserializer.cpp
+++ b/src/ArduinoOcpp/OperationDeserializer.cpp
@@ -18,7 +18,6 @@ OperationDeserializer::OperationDeserializer() {
 OcppMessageCreator *OperationDeserializer::findCreator(const char *operationType) {
     for (auto it = registry.begin(); it != registry.end(); ++it) {
         if (!strcmp(it->operationType, operationType)) {
-            AO_DBG_ERR("success");
             return &*it;
         }
     }
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index d8266350..017c24df 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -99,7 +99,7 @@ AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag
     //check status
     if (authData->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
         AO_DBG_DEBUG("idTag %s local auth status %s", idTag, serializeAuthorizationStatus(authData->getAuthorizationStatus()));
-        return nullptr;
+        return authData;
     }
 
     return authData;
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 82cdbae9..03c6b50d 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -353,6 +353,7 @@ OcppMessage *ConnectorStatus::loop() {
     }
 
     if (reportedStatus != currentStatus &&
+            context.getOcppTime().getOcppTimestampNow() >= OcppTimestamp(2010,0,0,0,0,0) &&
             (*minimumStatusDuration <= 0 || //MinimumStatusDuration disabled
             ao_tick_ms() - t_statusTransition >= ((unsigned long) *minimumStatusDuration) * 1000UL)) {
         reportedStatus = currentStatus;

From f4934e97c1a81222d464f9059821d345596f6aa9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 8 Apr 2023 14:09:50 +0200
Subject: [PATCH 210/549] deploy docs initial commit

---
 .github/workflows/documentation.yml | 21 +++++++++++++++++++++
 docs/index.md                       |  4 ++++
 mkdocs.yml                          |  4 ++++
 3 files changed, 29 insertions(+)
 create mode 100644 .github/workflows/documentation.yml
 create mode 100644 docs/index.md
 create mode 100644 mkdocs.yml

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
new file mode 100644
index 00000000..0c13347e
--- /dev/null
+++ b/.github/workflows/documentation.yml
@@ -0,0 +1,21 @@
+name: documentation 
+on:
+  push:
+    branches:
+      - develop
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: 3.x
+      - uses: actions/cache@v2
+        with:
+          key: ${{ github.ref }}
+          path: .cache
+      - run: pip install mkdocs-material 
+      - run: mkdocs gh-deploy --force
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 00000000..6a06add1
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,4 @@
+# Getting Started with ArduinoOcpp
+
+Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.
+
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 00000000..b790c67f
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,4 @@
+site_name: ArduinoOcpp Docs
+
+theme:
+  name: material

From e7014e1c17603601e745fba070aa0a6277b62d61 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 8 Apr 2023 16:26:46 +0200
Subject: [PATCH 211/549] tx store fixes

---
 src/ArduinoOcpp/Core/OcppOperation.cpp          | 2 ++
 src/ArduinoOcpp/MessagesV16/StopTransaction.cpp | 9 +++++----
 src/ArduinoOcpp/Tasks/Boot/BootService.cpp      | 4 +++-
 3 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 49a07783..83b47f3b 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -308,6 +308,8 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
         //skip this step but don't abort restore
     }
 
+    timeout_period = 0; //disable timeout by default for restored msgs
+
     if (!strcmp(opType.c_str(), "StartTransaction")) { //TODO this will get a nicer solution
         ocppMessage = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction(*oModel.get(), nullptr));
     } else if (!strcmp(opType.c_str(), "StopTransaction")) {
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 659fb3aa..432dbf4d 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -31,7 +31,7 @@ const char* StopTransaction::getOcppOperationType() {
 }
 
 void StopTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!transaction || transaction->getStartRpcSync().isRequested()) {
+    if (!transaction || transaction->getStopRpcSync().isRequested()) {
         AO_DBG_ERR("initialization error");
         return;
     }
@@ -40,9 +40,10 @@ void StopTransaction::initiate(StoredOperationHandler *opStore) {
     (*payload)["connectorId"] = transaction->getConnectorId();
     (*payload)["txNr"] = transaction->getTxNr();
 
-    opStore->setPayload(std::move(payload));
-
-    opStore->commit();
+    if (opStore) {
+        opStore->setPayload(std::move(payload));
+        opStore->commit();
+    }
 
     transaction->getStopRpcSync().setRequested();
 
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
index 8cad55f5..04d85766 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
@@ -66,7 +66,7 @@ void BootService::loop() {
      * this class and notify this class about the response
      */
     auto bootNotification = makeOcppOperation(new Ocpp16::BootNotification(context.getOcppModel(), getChargePointCredentials()));
-    bootNotification->setTimeout(0);
+    bootNotification->setTimeout(interval_s * 1000UL);
     context.initiatePreBootOperation(std::move(bootNotification));
 
     lastBootNotification = ao_tick_ms();
@@ -112,6 +112,7 @@ std::unique_ptr<DynamicJsonDocument> BootService::getChargePointCredentials() {
 
 void BootService::notifyRegistrationStatus(RegistrationStatus status) {
     this->status = status;
+    lastBootNotification = ao_tick_ms();
 }
 
 void BootService::setRetryInterval(unsigned long interval_s) {
@@ -120,4 +121,5 @@ void BootService::setRetryInterval(unsigned long interval_s) {
     } else {
         this->interval_s = interval_s;
     }
+    lastBootNotification = ao_tick_ms();
 }

From 380d04de9e64542c025b3165b95c856e04cccdfe Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 8 Apr 2023 16:27:25 +0200
Subject: [PATCH 212/549] reset backoff timer when connection is active

---
 src/ArduinoOcpp/Core/OcppConnection.cpp |  8 +++++++-
 src/ArduinoOcpp/Core/OcppConnection.h   |  1 +
 src/ArduinoOcpp/Core/OcppSocket.cpp     | 26 +++++++++++++++++++++++--
 src/ArduinoOcpp/Core/OcppSocket.h       | 26 +++++++++++--------------
 4 files changed, 43 insertions(+), 18 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 0b153bdc..892a7225 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -87,10 +87,16 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
     //check backoff time
 
     if (initedOp->getTrialNo() == 0) {
-        //send immediately
+        //first trial -> send immediately
         sendBackoffPeriod = 0;
     }
 
+    if (sockTrackLastRecv != ocppSock.getLastRecv()) {
+        //connection active (again) -> send immediately
+        sendBackoffPeriod = 0;
+    }
+    sockTrackLastRecv = ocppSock.getLastRecv();
+
     if (ao_tick_ms() - sendBackoffTime < sendBackoffPeriod) {
         //still in backoff period
         return;
diff --git a/src/ArduinoOcpp/Core/OcppConnection.h b/src/ArduinoOcpp/Core/OcppConnection.h
index 92a8f239..c634092f 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.h
+++ b/src/ArduinoOcpp/Core/OcppConnection.h
@@ -32,6 +32,7 @@ class OcppConnection {
 
     unsigned long sendBackoffTime = 0;
     unsigned long sendBackoffPeriod = 0;
+    unsigned long sockTrackLastRecv = 0;
     const unsigned long BACKOFF_PERIOD_MAX = 65536;
     const unsigned long BACKOFF_PERIOD_INCREMENT = BACKOFF_PERIOD_MAX / 4;
 public:
diff --git a/src/ArduinoOcpp/Core/OcppSocket.cpp b/src/ArduinoOcpp/Core/OcppSocket.cpp
index be8c0348..11d78470 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.cpp
+++ b/src/ArduinoOcpp/Core/OcppSocket.cpp
@@ -5,10 +5,32 @@
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Debug.h>
 
-#ifndef AO_CUSTOM_WS
-
 using namespace ArduinoOcpp;
 
+void OcppEchoSocket::loop() { }
+
+bool OcppEchoSocket::sendTXT(std::string &out) {
+    if (!connected) {
+        return true;
+    }
+    if (receiveTXT) {
+        lastRecv = ao_tick_ms();
+        return receiveTXT(out.c_str(), out.length());
+    } else {
+        return false;
+    }
+}
+
+void OcppEchoSocket::setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) {
+    this->receiveTXT = receiveTXT;
+}
+
+unsigned long OcppEchoSocket::getLastRecv() {
+    return lastRecv;
+}
+
+#ifndef AO_CUSTOM_WS
+
 using namespace ArduinoOcpp::EspWiFi;
 
 OcppClientSocket::OcppClientSocket(WebSocketsClient *wsock) : wsock(wsock) {
diff --git a/src/ArduinoOcpp/Core/OcppSocket.h b/src/ArduinoOcpp/Core/OcppSocket.h
index 1a30a71a..ea89435e 100644
--- a/src/ArduinoOcpp/Core/OcppSocket.h
+++ b/src/ArduinoOcpp/Core/OcppSocket.h
@@ -34,6 +34,11 @@ class OcppSocket {
      * the socket. The socket should forward any incoming payload from the OCPP server to the receiveTXT callback
      */
     virtual void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) = 0;
+
+    /*
+     * Returns the timestamp of the last incoming message. Use ao_tick_ms() for creating the correct timestamp
+     */
+    virtual unsigned long getLastRecv() {return 0;}
 };
 
 class OcppEchoSocket : public OcppSocket {
@@ -41,21 +46,12 @@ class OcppEchoSocket : public OcppSocket {
     ReceiveTXTcallback receiveTXT;
 
     bool connected = true; //for simulating connection losses
+    unsigned long lastRecv = 0;
 public:
-    void loop() override { }
-    bool sendTXT(std::string &out) override {
-        if (!connected) {
-            return true;
-        }
-        if (receiveTXT) {
-            return receiveTXT(out.c_str(), out.length());
-        } else {
-            return false;
-        }
-    }
-    void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) override {
-        this->receiveTXT = receiveTXT;
-    }
+    void loop() override;
+    bool sendTXT(std::string &out) override;
+    void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) override;
+    unsigned long getLastRecv() override;
 
     void setConnected(bool connected) {this->connected = connected;}
     bool isConnected() {return connected;}
@@ -83,7 +79,7 @@ class OcppClientSocket : public OcppSocket {
 
     void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT);
 
-    unsigned long getLastRecv(); //get time of last successful receive in millis
+    unsigned long getLastRecv() override; //get time of last successful receive in millis
 };
 
 } //end namespace EspWiFi

From 0da4df1aa9b7fce37b8279d88b28f6361ae362e8 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 8 Apr 2023 18:03:26 +0200
Subject: [PATCH 213/549] add link to ArduinoOcppSimulator

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 56b2ca58..58c018ed 100644
--- a/README.md
+++ b/README.md
@@ -16,12 +16,14 @@ Fully integrated into the Arduino platform and the ESP32 / ESP8266. Runs on ESP-
 
 This library allows your EVSE to communicate with an OCPP Backend and to participate in commercial charging networks. You can integrate it into an existing firmware development, or start a new EVSE project from scratch with it.
 
-:heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve), [The Mobility House OCPP package](https://github.com/mobilityhouse/ocpp) and further commercial Central Systems
+:heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve) and [15+ commercial Central Systems](https://www.arduino-ocpp.com/#h.314525e8447cc93c_81)
 
 :heavy_check_mark: Tested in many charging stations
 
 :heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
+Try it (no hardware required): [ArduinoOcppSimulator](https://github.com/matth-x/ArduinoOcppSimulator)
+
 ### Features
 
 - handles the OCPP communication with the charging network

From e399e42178be074783f0f7fbbf36d57cde3fa917 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 10 Apr 2023 22:53:40 +0200
Subject: [PATCH 214/549] esp-idf v5.1 update

---
 CMakeLists.txt                                |  2 +-
 examples/ESP-IDF/README.md                    | 25 +++++++++++++------
 .../{AOcppMongoose => ArduinoJson}/.gitkeep   |  0
 .../components/ArduinoOcppMongoose/.gitkeep   |  0
 examples/ESP-IDF/components/README.md         |  3 ++-
 examples/ESP-IDF/include/README.md            |  9 -------
 src/ArduinoOcpp/Core/OcppTime.cpp             |  4 +++
 src/ArduinoOcpp/Core/OcppTime.h               |  2 ++
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h |  2 +-
 src/ArduinoOcpp_c.cpp                         |  2 +-
 10 files changed, 28 insertions(+), 21 deletions(-)
 rename examples/ESP-IDF/components/{AOcppMongoose => ArduinoJson}/.gitkeep (100%)
 create mode 100644 examples/ESP-IDF/components/ArduinoOcppMongoose/.gitkeep
 delete mode 100644 examples/ESP-IDF/include/README.md

diff --git a/CMakeLists.txt b/CMakeLists.txt
index bbb44630..9620627b 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -80,7 +80,7 @@ set(AO_SRC
 if(ESP_PLATFORM)
 
     idf_component_register(SRCS ${AO_SRC}
-                        INCLUDE_DIRS "./src" "${PROJECT_DIR}/include"
+                        INCLUDE_DIRS "./src" "../ArduinoJson/src"
                         PRIV_REQUIRES spiffs)
 
     target_compile_options(${COMPONENT_TARGET} PUBLIC
diff --git a/examples/ESP-IDF/README.md b/examples/ESP-IDF/README.md
index e62dce59..1b8fc17e 100644
--- a/examples/ESP-IDF/README.md
+++ b/examples/ESP-IDF/README.md
@@ -6,15 +6,16 @@ To run ArduinoOcpp on the ESP-IDF platform, please take this example as the star
 
 ### Dependencies
 
-Please clone the following repositories into the respective components-directory:
+Please clone the following repositories into the respective components-directories:
 
-- [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf) into `components/mongoose`
 - [ArduinoOcpp](https://github.com/matth-x/ArduinoOcpp) into `components/ArduinoOcpp`
-- [Mongoose adapter for ArduinoOcpp](https://github.com/matth-x/AOcppMongoose) into `components/AOcppMongoose`
+- [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf) into `components/mongoose`
+- [Mongoose adapter for ArduinoOcpp](https://github.com/matth-x/AOcppMongoose) into `components/ArduinoOcppMongoose`
+- [ArduinoJson](https://github.com/bblanchon/ArduinoJson) into `components/ArduinoJson`
 
-The following header-only library needs to go into the include-section:
+Alternatively, ArduinoJson can go into into an include folder as it is a header-only library:
 
-- [ArduinoJson header file](https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h), renamed and moved to `include/ArduinoJson.h`
+- [ArduinoJson header file](https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h), renamed and moved to `include/ArduinoJson.h`. Any other location will work too as long as the header file `ArduinoJson.h` is on the include-path and can be found by the statement `#include <ArduinoJson.h>`
 
 For setup, the following commands could come handy (change to the root directory of the ESP-IDF project first):
 
@@ -22,10 +23,19 @@ For setup, the following commands could come handy (change to the root directory
 rm components/mongoose/.gitkeep
 rm components/ArduinoOcpp/.gitkeep
 rm components/AOcppMongoose/.gitkeep
-git clone --recurse-submodules https://github.com/cesanta/mongoose-esp-idf.git components/mongoose
 git clone https://github.com/matth-x/ArduinoOcpp components/ArduinoOcpp
+git clone --recurse-submodules https://github.com/cesanta/mongoose-esp-idf.git components/mongoose
 git clone https://github.com/matth-x/AOcppMongoose components/AOcppMongoose
-wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./include/ArduinoJson.h
+git clone https://github.com/bblanchon/ArduinoJson
+```
+
+The setup is done if the following include statements work:
+
+```cpp
+#include <ArduinoOcpp.h>
+#include <mongoose.h>
+#include <ArduinoOcppMongooseClient.h>
+#include <ArduinoJson.h>
 ```
 
 ### Configure the project
@@ -42,4 +52,3 @@ In the `Example Configuration` menu:
     * Set `AuthorizationKey`, or leave empty if not necessary
 
 Optional: If you need, change the other options according to your requirements.
-
diff --git a/examples/ESP-IDF/components/AOcppMongoose/.gitkeep b/examples/ESP-IDF/components/ArduinoJson/.gitkeep
similarity index 100%
rename from examples/ESP-IDF/components/AOcppMongoose/.gitkeep
rename to examples/ESP-IDF/components/ArduinoJson/.gitkeep
diff --git a/examples/ESP-IDF/components/ArduinoOcppMongoose/.gitkeep b/examples/ESP-IDF/components/ArduinoOcppMongoose/.gitkeep
new file mode 100644
index 00000000..e69de29b
diff --git a/examples/ESP-IDF/components/README.md b/examples/ESP-IDF/components/README.md
index 4cd447ac..9ea00832 100644
--- a/examples/ESP-IDF/components/README.md
+++ b/examples/ESP-IDF/components/README.md
@@ -2,8 +2,9 @@
 
 The ESP-IDF integration requires at least the following components:
 
-- [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf)
 - [ArduinoOcpp](https://github.com/matth-x/ArduinoOcpp)
+- [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf)
 - [Mongoose adapter for ArduinoOcpp](https://github.com/matth-x/AOcppMongoose)
+- [ArduinoJson](https://github.com/bblanchon/ArduinoJson)
 
 This example only provides the folder structure. You need to clone every project into it in order to run the example.
diff --git a/examples/ESP-IDF/include/README.md b/examples/ESP-IDF/include/README.md
deleted file mode 100644
index 5e098b2f..00000000
--- a/examples/ESP-IDF/include/README.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## Includes
-
-[ArduinoJson](https://github.com/bblanchon/ArduinoJson) is the JSON (de)serializer of ArduinoOcpp and a dependency. It is a header-only library and can go into the `include` folder. Any other location will work too as long as the header file `ArduinoJson.h` is on the include-path, i.e. the following `#include` works:
-
-```cpp
-#include <ArduinoJson.h>
-```
-
-Version `6.19.4` is required. You can download [this header file](https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h), rename it into `ArduinoJson.h` and move it here.
diff --git a/src/ArduinoOcpp/Core/OcppTime.cpp b/src/ArduinoOcpp/Core/OcppTime.cpp
index 9a805e1a..dcc8fa05 100644
--- a/src/ArduinoOcpp/Core/OcppTime.cpp
+++ b/src/ArduinoOcpp/Core/OcppTime.cpp
@@ -34,6 +34,10 @@ OcppTimestamp::OcppTimestamp() {
     
 }
 
+OcppTimestamp::OcppTimestamp(const OcppTimestamp& other) {
+    *this = other;
+}
+
 int noDays(int month, int year) {
     return (month == 0 || month == 2 || month == 4 || month == 6 || month == 7 || month == 9 || month == 11) ? 31 :
             ((month == 3 || month == 5 || month == 8 || month == 10) ? 30 :
diff --git a/src/ArduinoOcpp/Core/OcppTime.h b/src/ArduinoOcpp/Core/OcppTime.h
index 2d18dedf..906558f8 100644
--- a/src/ArduinoOcpp/Core/OcppTime.h
+++ b/src/ArduinoOcpp/Core/OcppTime.h
@@ -43,6 +43,8 @@ class OcppTimestamp {
 
     OcppTimestamp();
 
+    OcppTimestamp(const OcppTimestamp& other);
+
     OcppTimestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second) :
                 year(year), month(month), day(day), hour(hour), minute(minute), second(second) { };
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
index 6e5f1867..2e0d0104 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -27,7 +27,7 @@ class SampledValueDeSerializer<int32_t> { // example class
     static bool ready(int32_t& val) {return true;} //int32_t is always valid
     static std::string serialize(int32_t& val) {
         char str [12] = {'\0'};
-        snprintf(str, 12, "%d", val);
+        snprintf(str, 12, "%ld", val);
         return std::string(str);
     }
     static int32_t toInteger(int32_t& val) {return val;}
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 970b0995..324d65fb 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -198,7 +198,7 @@ void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, Autho
 }
 
 void ao_beginTransaction(const char *idTag) {
-    ao_beginTransaction(idTag);
+    beginTransaction(idTag);
 }
 void ao_beginTransaction_m(unsigned int connectorId, const char *idTag) {
     beginTransaction(idTag, connectorId);

From 4b78cc8906b60756ed9c58b07942e7b618bb92e8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 11 Apr 2023 14:33:21 +0200
Subject: [PATCH 215/549] use type-safe format specifier

---
 src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp | 14 +++++++++++++-
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h   | 12 ++++--------
 2 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
index d687e8d6..c3a0b498 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
@@ -1,11 +1,23 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 #include <ArduinoOcpp/Debug.h>
+#include <cinttypes>
 
 using ArduinoOcpp::SampledValue;
+using ArduinoOcpp::SampledValueDeSerializer;
+
+int32_t SampledValueDeSerializer<int32_t>::deserialize(const char *str) {
+    return strtol(str, nullptr, 10);
+}
+
+std::string SampledValueDeSerializer<int32_t>::serialize(int32_t& val) {
+    char str [12] = {'\0'};
+    snprintf(str, 12, "%" PRId32, val);
+    return std::string(str);
+}
 
 //helper function
 namespace ArduinoOcpp {
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
index 2e0d0104..8153eaf5 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef SAMPLEDVALUE_H
@@ -23,14 +23,10 @@ class SampledValueDeSerializer {
 template <>
 class SampledValueDeSerializer<int32_t> { // example class
 public:
-    static int32_t deserialize(const char *str) {return strtol(str, nullptr,10);}
+    static int32_t deserialize(const char *str);
     static bool ready(int32_t& val) {return true;} //int32_t is always valid
-    static std::string serialize(int32_t& val) {
-        char str [12] = {'\0'};
-        snprintf(str, 12, "%ld", val);
-        return std::string(str);
-    }
-    static int32_t toInteger(int32_t& val) {return val;}
+    static std::string serialize(int32_t& val);
+    static int32_t toInteger(int32_t& val) {return val;} //no conversion required
 };
 
 class SampledValueProperties {

From a67f0bc8bbdb64950302cb9108bd2d8450f6cac8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 11 Apr 2023 19:15:18 +0200
Subject: [PATCH 216/549] clean up build flags and debug msgs

---
 CMakeLists.txt                                             | 7 ++-----
 src/ArduinoOcpp.cpp                                        | 2 +-
 src/ArduinoOcpp/Core/Configuration.cpp                     | 2 +-
 .../Tasks/SmartCharging/SmartChargingService.cpp           | 4 ++--
 4 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 9620627b..d6d9d82e 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -84,10 +84,11 @@ if(ESP_PLATFORM)
                         PRIV_REQUIRES spiffs)
 
     target_compile_options(${COMPONENT_TARGET} PUBLIC
+        -DAO_PLATFORM=AO_PLATFORM_ESPIDF
         -DAO_CUSTOM_WS
         -DAO_CUSTOM_UPDATER
         -DAO_CUSTOM_RESET
-        -DAO_PLATFORM=AO_PLATFORM_ESPIDF)
+        )
 
     return()
 endif()
@@ -104,8 +105,4 @@ target_compile_definitions(ArduinoOcpp PUBLIC
     AO_CUSTOM_WS
     AO_CUSTOM_UPDATER
     AO_CUSTOM_RESET
-    AO_DBG_LEVEL=AO_DL_DEBUG
-    AO_TRAFFIC_OUT
-    AO_FILENAME_PREFIX="./ao_store"
-    AO_DEACTIVATE_FLASH_SMARTCHARGING
     )
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 31f5f077..b25b757c 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -395,7 +395,7 @@ void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, unsi
         return;
     }
     if (connectorId != 1) {
-        AO_DBG_WARN("Smart charging for multiple connectorId %u not implemented yet", connectorId);
+        AO_DBG_WARN("Only one connector supported at the moment for Smart Charging");
         return;
     }
     auto& model = ocppEngine->getOcppModel();
diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 4285b554..4cf645b9 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -93,7 +93,7 @@ std::shared_ptr<Configuration<T>> declareConfiguration(const char *key, T defaul
     std::shared_ptr<ConfigurationContainer> container = getContainer(filename);
     
     if (!container) {
-        AO_DBG_INFO("init new configurations container: %s", filename);
+        AO_DBG_DEBUG("init new configurations container: %s", filename);
 
         container = createConfigurationContainer(filename);
         configurationContainers.push_back(container);
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index d691c073..34579751 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -18,7 +18,7 @@
 
 #ifndef AO_DEACTIVATE_FLASH
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#if AO_USE_FILEAPI == ESPIDF_SPIFFS
+#if AO_USE_FILEAPI == ESPIDF_SPIFFS || AO_USE_FILEAPI == POSIX_FILEAPI
 #define AO_DEACTIVATE_FLASH //migrate to File utils
 #endif
 #endif
@@ -47,7 +47,7 @@ SmartChargingService::SmartChargingService(OcppEngine& context, float chargeLimi
       : context(context), DEFAULT_CHARGE_LIMIT{chargeLimit}, V_eff{V_eff}, filesystemOpt{filesystemOpt} {
   
     if (numConnectors > 2) {
-        AO_DBG_ERR("Only one connector supported at the moment");
+        AO_DBG_WARN("Only one connector supported at the moment");
     }
     
     limitBeforeChange = -1.0f;

From 2e4d42daebe823e2c0d820322cedc973bd0561b9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 13 Apr 2023 20:30:07 +0200
Subject: [PATCH 217/549] unite authorization and transaction mechanism

---
 .github/workflows/tests.yml                   |   2 +-
 examples/ESP/main.cpp                         |  36 +-
 src/ArduinoOcpp.cpp                           |   6 +-
 src/ArduinoOcpp/Core/OcppConnection.cpp       |   2 +-
 src/ArduinoOcpp/Core/OcppOperation.cpp        |   2 +-
 src/ArduinoOcpp/MessagesV16/Authorize.cpp     |   8 +-
 .../MessagesV16/RemoteStartTransaction.cpp    |   2 +-
 .../MessagesV16/RemoteStopTransaction.cpp     |   2 +-
 src/ArduinoOcpp/MessagesV16/Reset.cpp         |   2 +-
 .../MessagesV16/UnlockConnector.cpp           |   2 +-
 .../Authorization/AuthorizationService.cpp    |   9 -
 .../ChargePointStatusService.cpp              |   2 +-
 .../ChargePointStatus/ConnectorStatus.cpp     | 330 ++++++++++++++----
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  31 +-
 .../Tasks/Transactions/Transaction.cpp        |   6 +
 .../Tasks/Transactions/Transaction.h          |   4 +
 16 files changed, 315 insertions(+), 131 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index f7ae612a..be1f1ff1 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -23,7 +23,7 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_USE_FILEAPI=POSIX_FILEAPI -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -DAO_DEACTIVATE_FLASH_SMARTCHARGING -o ./output -Wall
+      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -o ./output -Wall
     - name: Configure FS
       run: mkdir ao_store
     - name: Run tests
diff --git a/examples/ESP/main.cpp b/examples/ESP/main.cpp
index 0c7ea19a..da6bcddf 100644
--- a/examples/ESP/main.cpp
+++ b/examples/ESP/main.cpp
@@ -91,7 +91,7 @@ void loop() {
     OCPP_loop();
 
     /*
-     * Check internal OCPP state and bind EVSE hardware to it
+     * Energize EV plug if OCPP transaction is up and running
      */
     if (ocppPermitsCharge()) {
         //OCPP set up and transaction running. Energize the EV plug here
@@ -100,31 +100,29 @@ void loop() {
     }
 
     /*
-     * Detect if something physical happened at your EVSE and trigger the corresponding OCPP messages
+     * Use NFC reader to start and stop transactions
      */
     if (/* RFID chip detected? */ false) {
         String idTag = "0123456789ABCD"; //e.g. idTag = RFID.readIdTag();
 
         if (!getTransactionIdTag()) {
             //no idTag registered yet. Start a new transaction
+            Serial.printf("[main] Begin Transaction with idTag %s\n", idTag.c_str());
+
+            /*
+             * Begin Transaction. The OCPP lib will prepare transaction by checking the Authorization
+             * and listen to the ConnectorPlugged Input. When the Authorization succeeds and an EV
+             * is plugged, the OCPP lib will send the StartTransaction
+             */
+            auto ret = beginTransaction(idTag.c_str());
+
+            if (ret) {
+                Serial.println(F("[main] Transaction initiated. OCPP lib will send a StartTransaction when" \
+                                 "ConnectorPlugged Input becomes true and if the Authorization succeeds"));
+            } else {
+                Serial.println(F("[main] No transaction initiated"));
+            }
 
-            authorize(idTag.c_str(), [idTag] (JsonObject response) {
-                //check if user with idTag is authorized
-                if (!strcmp("Accepted", response["idTagInfo"]["status"] | "Invalid")){
-                    Serial.println(F("[main] User is authorized to start a transaction"));
-
-                    auto ret = beginTransaction(idTag.c_str()); //begin Tx locally
-
-                    if (ret) {
-                        Serial.println(F("[main] Transaction initiated. StartTransaction will be sent when ConnectorPlugged Input becomes true"));
-                    } else {
-                        Serial.println(F("[main] No transaction initiated"));
-                    }
-                } else {
-                    Serial.printf("[main] Authorize denied. Reason: %s\n", response["idTagInfo"]["status"] | "");
-                }
-            });
-            Serial.printf("[main] Authorizing user with idTag %s\n", idTag.c_str());
         } else {
             //Transaction already initiated. Check if to stop current Tx by RFID card
             if (idTag.equals(getTransactionIdTag())) {
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index b25b757c..92f8f171 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -280,7 +280,7 @@ bool beginTransaction(const char *idTag, unsigned int connectorId) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
-    connector->beginSession(idTag);
+    connector->beginTransaction(idTag);
     return true;
 }
 
@@ -295,7 +295,7 @@ bool endTransaction(const char *reason, unsigned int connectorId) {
         return false;
     }
     bool res = connector->getSessionIdTag();
-    connector->endSession(reason);
+    connector->endTransaction(reason);
     return res;
 }
 
@@ -767,7 +767,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         return false;
     }
 
-    connector->endSession("Local");
+    connector->endTransaction("Local");
 
     const char *idTag = transaction->getIdTag();
     if (idTag) {
diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/OcppConnection.cpp
index 892a7225..6c0301ea 100644
--- a/src/ArduinoOcpp/Core/OcppConnection.cpp
+++ b/src/ArduinoOcpp/Core/OcppConnection.cpp
@@ -93,7 +93,7 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
 
     if (sockTrackLastRecv != ocppSock.getLastRecv()) {
         //connection active (again) -> send immediately
-        sendBackoffPeriod = 0;
+        sendBackoffPeriod = std::min(sendBackoffPeriod, 1000UL);
     }
     sockTrackLastRecv = ocppSock.getLastRecv();
 
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index 83b47f3b..f0b2ad91 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -98,7 +98,7 @@ std::unique_ptr<DynamicJsonDocument> OcppOperation::createRequest(){
         if (!buf || len < 1) {
             AO_DBG_DEBUG("Try to send request: %s", ocppMessage->getOcppOperationType());
         } else {
-            AO_DBG_DEBUG("Try to send request: %.*s ...", 128, ocppMessage->getOcppOperationType());
+            AO_DBG_DEBUG("Try to send request: %.*s (...)", 128, buf);
         }
 
         delete buf;
diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.cpp b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
index a168a88f..7dcb593b 100644
--- a/src/ArduinoOcpp/MessagesV16/Authorize.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
@@ -11,16 +11,12 @@
 
 using ArduinoOcpp::Ocpp16::Authorize;
 
-//Authorize::Authorize() {
-//    snprintf(this->idTag, IDTAG_LEN_MAX + 1, "A0-00-00-00"); //Use a default payload. In the typical use case of this library, you probably you don't even need Authorization at all
-//}
-
 Authorize::Authorize(OcppModel& context, const char *idTagIn) : context(context) {
     if (idTagIn && strnlen(idTagIn, IDTAG_LEN_MAX + 2) <= IDTAG_LEN_MAX) {
         snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
     } else {
-        AO_DBG_WARN("Format violation of idTag. Use default idTag");
-        snprintf(idTag, IDTAG_LEN_MAX + 1, "A0-00-00-00");
+        AO_DBG_WARN("Format violation of idTag. Discard idTag");
+        (void)0;
     }
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
index 8c52b1cc..e3eb3e5c 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
@@ -98,7 +98,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         }
 
         if (auto connector = context.getConnectorStatus(connectorId)) {
-            connector->beginSession(idTag);
+            connector->beginTransaction(idTag);
         }
 
         if (!chargingProfileDoc.isNull()
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
index 2637c330..18cc7b6f 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
@@ -31,7 +31,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
             auto connIter = cpStatusService->getConnector(i);
             if (connIter->getTransactionId() == transactionId) {
                 canStopTransaction = true;
-                connIter->endSession("Remote");
+                connIter->endTransaction("Remote");
             }
         }
     }
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.cpp b/src/ArduinoOcpp/MessagesV16/Reset.cpp
index 747b162b..98f6b1f3 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Reset.cpp
@@ -35,7 +35,7 @@ void Reset::processReq(JsonObject payload) {
                 for (int i = 0; i < cpsService->getNumConnectors(); i++) {
                     auto connector = cpsService->getConnector(i);
                     if (connector) {
-                        connector->endSession(isHard ? "HardReset" : "SoftReset");
+                        connector->endTransaction(isHard ? "HardReset" : "SoftReset");
                     }
                 }
             }
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
index 3c99fe51..7f1dd015 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
@@ -30,7 +30,7 @@ void UnlockConnector::processReq(JsonObject payload) {
         return;
     }
 
-    connector->endSession("UnlockCommand");
+    connector->endTransaction("UnlockCommand");
 
     unlockConnector = connector->getOnUnlockConnector();
     if (unlockConnector != nullptr) {
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index 017c24df..be148441 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -87,15 +87,6 @@ AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag
         return nullptr;
     }
 
-    //check expiry
-    if (authData->getExpiryDate()) {
-        auto& tnow = context.getOcppModel().getOcppTime().getOcppTimestampNow();
-        if (tnow >= *authData->getExpiryDate()) {
-            AO_DBG_DEBUG("idTag %s local auth entry expired", idTag);
-            return nullptr;
-        }
-    }
-
     //check status
     if (authData->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
         AO_DBG_DEBUG("idTag %s local auth status %s", idTag, serializeAuthorizationStatus(authData->getAuthorizationStatus()));
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 42255f77..1d0eeb75 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -34,7 +34,7 @@ ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned
       : context(context) {
 
     for (unsigned int i = 0; i < numConn; i++) {
-        connectors.push_back(std::unique_ptr<ConnectorStatus>(new ConnectorStatus(context.getOcppModel(), i)));
+        connectors.push_back(std::unique_ptr<ConnectorStatus>(new ConnectorStatus(context, i)));
     }
     
     std::shared_ptr<Configuration<int>> numberOfConnectors =
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 03c6b50d..bb39fdd5 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -4,11 +4,13 @@
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h>
 
+#include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 
+#include <ArduinoOcpp/MessagesV16/Authorize.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
@@ -18,12 +20,15 @@
 
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+
+#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
-ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
-        : context(context), connectorId{connectorId}, txProcess(connectorId) {
+ConnectorStatus::ConnectorStatus(OcppEngine& context, int connectorId)
+        : context(context), model(context.getOcppModel()), connectorId{connectorId}, txProcess(connectorId) {
 
     char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
     snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, "AO_AVAIL_CONN_%d", connectorId);
@@ -35,10 +40,14 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
     stopTransactionOnEVSideDisconnect = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
     unlockConnectorOnEVSideDisconnect = declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
     localPreAuthorize = declareConfiguration<bool>("LocalPreAuthorize", false, CONFIGURATION_FN, true, true, true, false);
+    allowOfflineTxForUnknownId = ArduinoOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", false, CONFIGURATION_FN);
 
     //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
     silentOfflineTransactions = declareConfiguration<bool>("AO_SilentOfflineTransactions", false, CONFIGURATION_FN, true, true, true, false);
 
+    //how long the EVSE tries the Authorize request before it enters offline mode
+    authorizationTimeout = ArduinoOcpp::declareConfiguration<int>("AO_AuthorizationTimeout", 20, CONFIGURATION_FN);
+
     //FreeVend mode
     freeVendActive = declareConfiguration<bool>("AO_FreeVendActive", false, CONFIGURATION_FN, true, true, true, false);
     freeVendIdTag = declareConfiguration<const char*>("AO_FreeVendIdTag", "", CONFIGURATION_FN, true, true, true, false);
@@ -68,14 +77,15 @@ ConnectorStatus::ConnectorStatus(OcppModel& context, int connectorId)
         return cond == TxTrigger::Active ? TxEnableState::Active : TxEnableState::Inactive;
     });
     txProcess.addEnableStep([this] (TxTrigger cond) -> TxEnableState {
+        //check optional behavior UnlockConnectorOnEVSideDisconnect: if the 
         if (onConnectorLockPollTx) {
             return onConnectorLockPollTx(cond);
         }
         return cond == TxTrigger::Active ? TxEnableState::Active : TxEnableState::Inactive;
     });
 
-    if (context.getTransactionStore()) {
-        transaction = context.getTransactionStore()->getLatestTransaction(connectorId);
+    if (model.getTransactionStore()) {
+        transaction = model.getTransactionStore()->getLatestTransaction(connectorId);
     } else {
         AO_DBG_ERR("must initialize TxStore before ConnectorStatus");
         (void)0;
@@ -110,7 +120,7 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
             return OcppEvseState::SuspendedEV;
         }
         return OcppEvseState::Charging;
-    } else if (context.getReservationService() && context.getReservationService()->getReservation(connectorId)) {
+    } else if (model.getReservationService() && model.getReservationService()->getReservation(connectorId)) {
         return OcppEvseState::Reserved;
     } else if (!txProcess.existsActiveTrigger() && txProcess.getState() == TxEnableState::Inactive) {
         return OcppEvseState::Available;
@@ -169,16 +179,16 @@ OcppMessage *ConnectorStatus::loop() {
         //If the transaction is aborted (invalidated before started), delete all artifacts from flash
         //This is an optimization. The memory management will attempt to remove those files again later
         bool removed = true;
-        if (auto mService = context.getMeteringService()) {
+        if (auto mService = model.getMeteringService()) {
             removed &= mService->removeTxMeterData(connectorId, transaction->getTxNr());
         }
 
         if (removed) {
-            removed &= context.getTransactionStore()->remove(connectorId, transaction->getTxNr());
+            removed &= model.getTransactionStore()->remove(connectorId, transaction->getTxNr());
         }
 
         if (removed) {
-            context.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr()); //roll back creation of last tx entry
+            model.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr()); //roll back creation of last tx entry
         }
 
         AO_DBG_DEBUG("collect aborted transaction %u-%u %s", connectorId, transaction->getTxNr(), removed ? "" : "failure");
@@ -209,7 +219,7 @@ OcppMessage *ConnectorStatus::loop() {
                 !transaction->getStartRpcSync().isRequested() &&
                 transaction->getSessionTimestamp() > MIN_TIME &&
                 connectionTimeOut && *connectionTimeOut > 0 &&
-                context.getOcppTime().getOcppTimestampNow() - transaction->getSessionTimestamp() >= (otime_t) *connectionTimeOut) {
+                model.getOcppTime().getOcppTimestampNow() - transaction->getSessionTimestamp() >= (otime_t) *connectionTimeOut) {
                 
             AO_DBG_INFO("Session mngt: timeout");
             transaction->endSession();
@@ -238,7 +248,7 @@ OcppMessage *ConnectorStatus::loop() {
 
                 AO_DBG_INFO("Session mngt: trigger StartTransaction");
 
-                auto meteringService = context.getMeteringService();
+                auto meteringService = model.getMeteringService();
                 if (transaction->getMeterStart() < 0 && meteringService) {
                     auto meterStart = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionBegin);
                     if (meterStart && *meterStart) {
@@ -249,7 +259,7 @@ OcppMessage *ConnectorStatus::loop() {
                 }
 
                 if (transaction->getStartTimestamp() <= MIN_TIME) {
-                    transaction->setStartTimestamp(context.getOcppTime().getOcppTimestampNow());
+                    transaction->setStartTimestamp(model.getOcppTime().getOcppTimestampNow());
                 }
 
                 if (transaction->isSilent()) {
@@ -262,11 +272,11 @@ OcppMessage *ConnectorStatus::loop() {
 
                 transaction->commit();
 
-                if (context.getMeteringService()) {
-                    context.getMeteringService()->beginTxMeterData(transaction.get());
+                if (model.getMeteringService()) {
+                    model.getMeteringService()->beginTxMeterData(transaction.get());
                 }
 
-                return new StartTransaction(context, transaction);
+                return new StartTransaction(model, transaction);
             }
         } else if (transaction->isRunning()) {
 
@@ -285,16 +295,16 @@ OcppMessage *ConnectorStatus::loop() {
                     AO_DBG_INFO("silent Transaction: omit StopTx");
                     transaction->getStopRpcSync().setRequested();
                     transaction->getStopRpcSync().confirm();
-                    if (auto mService = context.getMeteringService()) {
+                    if (auto mService = model.getMeteringService()) {
                         mService->removeTxMeterData(connectorId, transaction->getTxNr());
                     }
-                    context.getTransactionStore()->remove(connectorId, transaction->getTxNr());
-                    context.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr());
+                    model.getTransactionStore()->remove(connectorId, transaction->getTxNr());
+                    model.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr());
                     transaction = nullptr;
                     return nullptr;
                 }
                 
-                auto meteringService = context.getMeteringService();
+                auto meteringService = model.getMeteringService();
                 if (transaction->getMeterStop() < 0 && meteringService) {
                     auto meterStop = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
                     if (meterStop && *meterStop) {
@@ -305,7 +315,7 @@ OcppMessage *ConnectorStatus::loop() {
                 }
 
                 if (transaction->getStopTimestamp() <= MIN_TIME) {
-                    transaction->setStopTimestamp(context.getOcppTime().getOcppTimestampNow());
+                    transaction->setStopTimestamp(model.getOcppTime().getOcppTimestampNow());
                 }
 
                 transaction->commit();
@@ -317,9 +327,9 @@ OcppMessage *ConnectorStatus::loop() {
                 }
 
                 if (stopTxData) {
-                    return new StopTransaction(context, std::move(transaction), stopTxData->retrieveStopTxData());
+                    return new StopTransaction(model, std::move(transaction), stopTxData->retrieveStopTxData());
                 } else {
-                    return new StopTransaction(context, std::move(transaction));
+                    return new StopTransaction(model, std::move(transaction));
                 }
             }
         }
@@ -333,7 +343,7 @@ OcppMessage *ConnectorStatus::loop() {
                 idTag = "A0000000";
             }
             AO_DBG_INFO("begin FreeVend Tx using idTag %s", idTag);
-            beginSession(idTag);
+            beginTransaction(idTag);
             
             if (!transaction) {
                 AO_DBG_ERR("could not begin FreeVend Tx");
@@ -353,11 +363,11 @@ OcppMessage *ConnectorStatus::loop() {
     }
 
     if (reportedStatus != currentStatus &&
-            context.getOcppTime().getOcppTimestampNow() >= OcppTimestamp(2010,0,0,0,0,0) &&
+            model.getOcppTime().getOcppTimestampNow() >= OcppTimestamp(2010,0,0,0,0,0) &&
             (*minimumStatusDuration <= 0 || //MinimumStatusDuration disabled
             ao_tick_ms() - t_statusTransition >= ((unsigned long) *minimumStatusDuration) * 1000UL)) {
         reportedStatus = currentStatus;
-        OcppTimestamp reportedTimestamp = context.getOcppTime().getOcppTimestampNow();
+        OcppTimestamp reportedTimestamp = model.getOcppTime().getOcppTimestampNow();
         reportedTimestamp -= (ao_tick_ms() - t_statusTransition) / 1000UL;
 
         return new StatusNotification(connectorId, reportedStatus, reportedTimestamp, getErrorCode());
@@ -376,50 +386,46 @@ const char *ConnectorStatus::getErrorCode() {
     return nullptr;
 }
 
-void ConnectorStatus::beginSession(const char *sessionIdTag) {
-    //(special case: tx already exists -> update the sessionIdTag and good)
-
-    if (!transaction) {
-        //no tx running, before creating new one, clean possible aorted tx
-
-        auto txr = context.getTransactionStore()->getTxEnd(connectorId);
-        auto txsize = context.getTransactionStore()->size(connectorId);
-        for (decltype(txsize) i = 0; i < txsize; i++) {
-            txr = (txr + MAX_TX_CNT - 1) % MAX_TX_CNT; //decrement by 1
-            
-            auto tx = context.getTransactionStore()->getTransaction(connectorId, txr);
-            //check if dangling silent tx, aborted tx, or corrupted entry (tx == null)
-            if (!tx || tx->isSilent() || tx->isAborted()) {
-                //yes, remove
-                bool removed = true;
-                if (auto mService = context.getMeteringService()) {
-                    removed &= mService->removeTxMeterData(connectorId, txr);
-                }
-                if (removed) {
-                    removed &= context.getTransactionStore()->remove(connectorId, txr);
-                }
-                if (removed) {
-                    context.getTransactionStore()->setTxEnd(connectorId, txr);
-                    AO_DBG_WARN("deleted dangling silent tx for new transaction");
-                } else {
-                    AO_DBG_ERR("memory corruption");
-                    break;
-                }
+void ConnectorStatus::allocateTransaction(const char *idTag) {
+
+    //clean possible aorted tx
+    auto txr = model.getTransactionStore()->getTxEnd(connectorId);
+    auto txsize = model.getTransactionStore()->size(connectorId);
+    for (decltype(txsize) i = 0; i < txsize; i++) {
+        txr = (txr + MAX_TX_CNT - 1) % MAX_TX_CNT; //decrement by 1
+        
+        auto tx = model.getTransactionStore()->getTransaction(connectorId, txr);
+        //check if dangling silent tx, aborted tx, or corrupted entry (tx == null)
+        if (!tx || tx->isSilent() || tx->isAborted()) {
+            //yes, remove
+            bool removed = true;
+            if (auto mService = model.getMeteringService()) {
+                removed &= mService->removeTxMeterData(connectorId, txr);
+            }
+            if (removed) {
+                removed &= model.getTransactionStore()->remove(connectorId, txr);
+            }
+            if (removed) {
+                model.getTransactionStore()->setTxEnd(connectorId, txr);
+                AO_DBG_WARN("deleted dangling silent tx for new transaction");
             } else {
-                //no, tx record trimmed, end
+                AO_DBG_ERR("memory corruption");
                 break;
             }
+        } else {
+            //no, tx record trimmed, end
+            break;
         }
-
-        //try to create new transaction
-        transaction = context.getTransactionStore()->createTransaction(connectorId);
     }
 
+    //try to create new transaction
+    transaction = model.getTransactionStore()->createTransaction(connectorId);
+
     if (!transaction) {
         //could not create transaction - now, try to replace tx history entry
 
-        auto txl = context.getTransactionStore()->getTxBegin(connectorId);
-        auto txsize = context.getTransactionStore()->size(connectorId);
+        auto txl = model.getTransactionStore()->getTxBegin(connectorId);
+        auto txsize = model.getTransactionStore()->size(connectorId);
 
         for (decltype(txsize) i = 0; i < txsize; i++) {
 
@@ -430,22 +436,22 @@ void ConnectorStatus::beginSession(const char *sessionIdTag) {
 
             //no transaction allocated, delete history entry to make space
 
-            auto txhist = context.getTransactionStore()->getTransaction(connectorId, txl);
+            auto txhist = model.getTransactionStore()->getTransaction(connectorId, txl);
             //oldest entry, now check if it's history and can be removed or corrupted entry
             if (!txhist || txhist->isCompleted()) {
                 //yes, remove
                 bool removed = true;
-                if (auto mService = context.getMeteringService()) {
+                if (auto mService = model.getMeteringService()) {
                     removed &= mService->removeTxMeterData(connectorId, txl);
                 }
                 if (removed) {
-                    removed &= context.getTransactionStore()->remove(connectorId, txl);
+                    removed &= model.getTransactionStore()->remove(connectorId, txl);
                 }
                 if (removed) {
-                    context.getTransactionStore()->setTxBegin(connectorId, (txl + 1) % MAX_TX_CNT);
+                    model.getTransactionStore()->setTxBegin(connectorId, (txl + 1) % MAX_TX_CNT);
                     AO_DBG_DEBUG("deleted tx history entry for new transaction");
 
-                    transaction = context.getTransactionStore()->createTransaction(connectorId);
+                    transaction = model.getTransactionStore()->createTransaction(connectorId);
                 } else {
                     AO_DBG_ERR("memory corruption");
                     break;
@@ -465,7 +471,7 @@ void ConnectorStatus::beginSession(const char *sessionIdTag) {
         //couldn't create normal transaction -> check if to start charging without real transaction
         if (silentOfflineTransactions && *silentOfflineTransactions) {
             //try to handle charging session without sending StartTx or StopTx to the server
-            transaction = context.getTransactionStore()->createTransaction(connectorId, true);
+            transaction = model.getTransactionStore()->createTransaction(connectorId, true);
 
             if (transaction) {
                 AO_DBG_DEBUG("created silent transaction");
@@ -475,32 +481,206 @@ void ConnectorStatus::beginSession(const char *sessionIdTag) {
     }
 
     if (!transaction) {
-        AO_DBG_ERR("could not allocate Tx");
         return;
     }
     
-    AO_DBG_DEBUG("Begin session with idTag %s, overwriting idTag %s", sessionIdTag != nullptr ? sessionIdTag : "", transaction->getIdTag());
-    if (!sessionIdTag || *sessionIdTag == '\0') {
+    if (!idTag || *idTag == '\0') {
         //input string is empty
-        transaction->setIdTag("A0-00-00-00");
+        transaction->setIdTag("");
     } else {
-        transaction->setIdTag(sessionIdTag);
+        transaction->setIdTag(idTag);
     }
 
-    transaction->setSessionTimestamp(context.getOcppTime().getOcppTimestampNow());
+    transaction->setSessionTimestamp(model.getOcppTime().getOcppTimestampNow());
+
+}
+
+std::shared_ptr<Transaction> ConnectorStatus::beginTransaction(const char *idTag) {
 
-    if (context.getReservationService()) {
-        if (auto reservation = context.getReservationService()->getReservation(connectorId, sessionIdTag, nullptr)) { //TODO set parentIdTag
-            if (reservation->matches(sessionIdTag, nullptr)) { //TODO set parentIdTag
+    if (transaction) {
+        AO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
+        return nullptr;
+    }
+
+    auto rService = model.getReservationService();
+    AuthorizationData *localAuth = nullptr;
+    bool expiredLocalAuth = false;
+
+    //check local OCPP whitelist
+    if (auto authService = model.getAuthorizationService()) {
+        
+        localAuth = authService->getLocalAuthorization(idTag);
+
+        //check if blocked by reservation
+        Reservation *reservation = nullptr;
+        if (localAuth && rService) {
+            reservation = rService->getReservation(
+                        connectorId,
+                        idTag,
+                        localAuth->getParentIdTag() ? localAuth->getParentIdTag() : nullptr);
+            if (reservation && !reservation->matches(
+                        idTag,
+                        localAuth->getParentIdTag() ? localAuth->getParentIdTag() : nullptr)) {
+                //reservation found for connector but does not match idTag or parentIdTag
+                AO_DBG_DEBUG("reservation blocks local auth at connector %u", connectorId);
+                localAuth = nullptr;;
+            }
+        }
+
+        if (localAuth && localAuth->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
+            AO_DBG_DEBUG("local auth denied (%s)", idTag);
+            localAuth = nullptr;
+        }
+
+        //check expiry
+        if (localAuth && localAuth->getExpiryDate()) {
+            auto& tnow = model.getOcppTime().getOcppTimestampNow();
+            if (tnow >= *localAuth->getExpiryDate()) {
+                AO_DBG_DEBUG("idTag %s local auth entry expired", idTag);
+                localAuth = nullptr;
+                expiredLocalAuth = true;
+            }
+        }
+    }
+
+    allocateTransaction(idTag);
+
+    if (!transaction) {
+        AO_DBG_ERR("could not allocate Tx");
+        return nullptr;
+    }
+
+    AO_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
+
+    //check for local preauthorization
+    if (localPreAuthorize && *localPreAuthorize) {
+        if (localAuth && localAuth->getAuthorizationStatus() == AuthorizationStatus::Accepted) {
+            AO_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
+
+            transaction->setAuthorized();
+        }
+    }
+
+    transaction->commit();
+
+    auto authorize = makeOcppOperation(new Ocpp16::Authorize(context.getOcppModel(), idTag));
+    authorize->setTimeout(authorizationTimeout && *authorizationTimeout > 0 ? *authorizationTimeout * 1000UL : 20UL * 1000UL);
+    auto tx = transaction;
+    authorize->setOnReceiveReqListener([this, tx] (JsonObject response) {
+        JsonObject idTagInfo = response["idTagInfo"];
+
+        if (strcmp("Accepted", idTagInfo["status"] | "UNDEFINED")) {
+            //Authorization rejected, abort transaction
+            AO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->getIdTag());
+            if (tx->isRunning()) {
+                //handle dangling Authorize request. Deauthorized tx will be handled according to StopTransactionOnInvalidId
+                tx->setIdTagDeauthorized();
+            } else {
+                tx->endSession();
+            }
+            tx->commit();
+            return;
+        }
+
+        if (model.getReservationService()) {
+            auto reservation = model.getReservationService()->getReservation(
+                        connectorId,
+                        tx->getIdTag(),
+                        idTagInfo["parentIdTag"] | (const char*) nullptr);
+            if (reservation && !reservation->matches(
+                        tx->getIdTag(),
+                        idTagInfo["parentIdTag"] | (const char*) nullptr)) {
+                //reservation found for connector but does not match idTag or parentIdTag
+                AO_DBG_INFO("connector %u reserved - abort transaction", connectorId);
+                tx->endSession();
+                tx->commit();
+                return;
+            }
+        }
+
+        AO_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
+        tx->setAuthorized();
+    });
+    authorize->setOnTimeoutListener([this, tx, localAuth, expiredLocalAuth] () {
+
+        if (expiredLocalAuth) {
+            //local auth entry exists, but is expired -> avoid offline tx
+            AO_DBG_DEBUG("Abort transaction process (%s), timeout, expired local auth", tx->getIdTag());
+            tx->endSession();
+            tx->commit();
+            return;
+        }
+        
+        if (localAuth) {
+            AO_DBG_DEBUG("Offline transaction process (%s), locally authorized", tx->getIdTag());
+            tx->setAuthorized();
+            tx->commit();
+            return;
+        }
+
+        if (model.getReservationService()) {
+            auto reservation = model.getReservationService()->getReservation(
+                        connectorId,
+                        tx->getIdTag());
+            if (reservation && !reservation->matches(
+                        tx->getIdTag())) {
+                //reservation found for connector but does not match idTag or parentIdTag
+                AO_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
+                tx->endSession();
+                tx->commit();
+                return;
+            }
+        }
+
+        if (allowOfflineTxForUnknownId && (bool) *allowOfflineTxForUnknownId) {
+            AO_DBG_DEBUG("Offline transaction process (%s), allow unknown ID", tx->getIdTag());
+            tx->setAuthorized();
+            tx->commit();
+            return;
+        }
+        
+        AO_DBG_DEBUG("Abort transaction process (%s): timeout", tx->getIdTag());
+        tx->endSession();
+        tx->commit();
+        return; //offline tx disabled
+    });
+    context.initiateOperation(std::move(authorize));
+
+    return transaction;
+}
+
+std::shared_ptr<Transaction> ConnectorStatus::beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
+    
+    if (transaction) {
+        AO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
+        return nullptr;
+    }
+
+    allocateTransaction(idTag);
+
+    if (!transaction) {
+        AO_DBG_ERR("could not allocate Tx");
+        return nullptr;
+    }
+    
+    AO_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
+
+    transaction->setAuthorized();
+    
+    if (model.getReservationService()) {
+        if (auto reservation = model.getReservationService()->getReservation(connectorId, idTag, nullptr)) { //TODO set parentIdTag
+            if (reservation->matches(idTag, nullptr)) { //TODO set parentIdTag
                 transaction->setReservationId(reservation->getReservationId());
             }
         }
     }
 
     transaction->commit();
+
+    return transaction;
 }
 
-void ConnectorStatus::endSession(const char *reason) {
+void ConnectorStatus::endTransaction(const char *reason) {
 
     if (!transaction) {
         AO_DBG_WARN("Cannot end session if no transaction running");
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 20dd84be..b6b5693e 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -22,17 +22,20 @@
 
 namespace ArduinoOcpp {
 
+class OcppEngine;
 class OcppModel;
 class OcppMessage;
 class Transaction;
 
 class ConnectorStatus {
 private:
-    OcppModel& context;
+    OcppEngine& context;
+    OcppModel& model;
     
     const int connectorId;
 
     std::shared_ptr<Transaction> transaction;
+    void allocateTransaction(const char *idTag);
 
     std::shared_ptr<Configuration<int>> availability;
     int availabilityVolatile = AVAILABILITY_OPERATIVE;
@@ -60,26 +63,32 @@ class ConnectorStatus {
     std::shared_ptr<Configuration<bool>> stopTransactionOnEVSideDisconnect;
     std::shared_ptr<Configuration<bool>> unlockConnectorOnEVSideDisconnect;
     std::shared_ptr<Configuration<bool>> localPreAuthorize;
+    std::shared_ptr<Configuration<bool>> allowOfflineTxForUnknownId;
 
     std::shared_ptr<Configuration<bool>> silentOfflineTransactions;
+    std::shared_ptr<Configuration<int>> authorizationTimeout; //in seconds
     std::shared_ptr<Configuration<bool>> freeVendActive;
     std::shared_ptr<Configuration<const char*>> freeVendIdTag;
     bool freeVendTrackPlugged = false;
 public:
-    ConnectorStatus(OcppModel& context, int connectorId);
+    ConnectorStatus(OcppEngine& context, int connectorId);
 
     /*
-     * Relation Session <-> Transaction
-     * Session: the EV user is authorized and the OCPP transaction can start immediately without
-     *          further confirmation by the user or the OCPP backend
-     * Transaction: started by "StartTransaction" and stopped by "StopTransaction".
+     * beginTransaction begins the transaction process which eventually leads to a StartTransaction
+     * request in the normal case.
      * 
-     * A session (between the EV user and the OCPP system) is on of two prerequisites to start a
-     * transaction. The other prerequisite is that the EV is properly connected to the EVSE
-     * (given by ConnectorPluggedSampler and no error code)
+     * If the transaction process begins successfully, a Transaction object is returned
+     * If no transaction process begins due to this call, nullptr is returned (e.g. memory allocation failed)
      */
-    void beginSession(const char *idTag);
-    void endSession(const char *reason = nullptr);
+    std::shared_ptr<Transaction> beginTransaction(const char *idTag);
+    std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag = nullptr);
+
+    /*
+     * End the current transaction process, if existing and not ended yet. This eventually leads to
+     * a StopTransaction request, if the transaction process has actually ended due to this call. It
+     * is safe to call this function at any time even if no transaction is running
+     */
+    void endTransaction(const char *reason = nullptr);
     const char *getSessionIdTag();
     uint16_t getSessionWriteCount();
     bool isTransactionRunning();
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index 4d435953..eae8b85c 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -23,6 +23,9 @@ bool Transaction::serializeSessionState(DynamicJsonDocument& out) {
     if (session.idTag[0] != '\0') {
         sessionState["idTag"] = session.idTag;
     }
+    if (session.authorized) {
+        sessionState["authorized"] = session.authorized;
+    }
     if (session.timestamp > MIN_TIME) {
         char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
         session.timestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
@@ -124,6 +127,9 @@ bool Transaction::deserializeSessionState(JsonObject state) {
             return false;
         }
     }
+    if (sessionState.containsKey("authorized")) {
+        session.authorized = sessionState["authorized"] | false;
+    }
     if (sessionState.containsKey("timestamp")) {
         session.timestamp.setTime(sessionState["timestamp"] | "Invalid");
     }
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index abd6e682..9989be17 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -94,6 +94,7 @@ class ChargingSession {
     friend class Transaction;
     
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
+    bool authorized = false;    //if the given idTag was authorized
     OcppTimestamp timestamp = MIN_TIME;
     int txProfileId = -1;
 
@@ -150,6 +151,9 @@ class Transaction {
     void setStopReason(const char *reason) {snprintf(stop.client.reason, REASON_LEN_MAX + 1, "%s", reason);}
     void endSession() {session.active = false;}
 
+    void setAuthorized() {session.authorized = true;}
+    bool isAuthorized() {return session.authorized && start.server.authorized;}
+
     void setIdTagDeauthorized() {start.server.authorized = false;}
     bool isIdTagDeauthorized() {return start.rpc.isConfirmed() && !start.server.authorized;}
 

From 0f1a11d98e7c7596759fd37c0978c1cad68cb1a7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 18 Apr 2023 15:11:28 +0200
Subject: [PATCH 218/549] customizable max file sizes

---
 src/ArduinoOcpp/Core/FilesystemAdapter.h      | 15 ++++++---
 src/ArduinoOcpp/Core/FilesystemUtils.cpp      |  8 ++---
 src/ArduinoOcpp/Core/OperationStore.cpp       | 26 +++++++--------
 src/ArduinoOcpp/Platform.h                    |  4 +--
 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp | 32 +++++++++----------
 .../Tasks/Transactions/TransactionStore.cpp   | 20 ++++++------
 6 files changed, 56 insertions(+), 49 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index 47e788b0..35b661f1 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef AO_FILESYSTEMADAPTER_H
@@ -9,8 +9,6 @@
 #define AO_FILENAME_PREFIX ""
 #endif
 
-#define MAX_PATH_SIZE 30
-
 #define ARDUINO_LITTLEFS 1
 #define ARDUINO_SPIFFS   2
 #define ESPIDF_SPIFFS    3
@@ -44,7 +42,7 @@ class FilesystemAdapter {
 
 #ifndef AO_DEACTIVATE_FLASH
 
-//Set default parameters; assume usage with Arduino if no build flags are present
+// choose FileAPI if not given by build flag; assume usage with Arduino if no build flags are present
 #ifndef AO_USE_FILEAPI
 #if AO_PLATFORM == AO_PLATFORM_ARDUINO
 #if defined(ESP32)
@@ -59,6 +57,15 @@ class FilesystemAdapter {
 #endif //switch-case AO_PLATFORM
 #endif //ndef AO_USE_FILEAPI
 
+// set default max path size parameters
+#ifndef AO_MAX_PATH_SIZE
+#if AO_USE_FILEAPI == POSIX_FILEAPI
+#define AO_MAX_PATH_SIZE 128
+#else
+#define AO_MAX_PATH_SIZE 30
+#endif
+#endif
+
 /*
  * Platform specific implementations. Currently supported:
  *     - Arduino LittleFs
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
index 8c3dfa9e..f394f9d8 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -15,8 +15,8 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
         return nullptr;
     }
 
-    if (strnlen(fn, MAX_PATH_SIZE) >= MAX_PATH_SIZE) {
-        AO_DBG_ERR("Fn too long: %.*s", MAX_PATH_SIZE, fn);
+    if (strnlen(fn, AO_MAX_PATH_SIZE) >= AO_MAX_PATH_SIZE) {
+        AO_DBG_ERR("Fn too long: %.*s", AO_MAX_PATH_SIZE, fn);
         return nullptr;
     }
     
@@ -81,8 +81,8 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
         return false;
     }
 
-    if (strnlen(fn, MAX_PATH_SIZE) >= MAX_PATH_SIZE) {
-        AO_DBG_ERR("Fn too long: %.*s", MAX_PATH_SIZE, fn);
+    if (strnlen(fn, AO_MAX_PATH_SIZE) >= AO_MAX_PATH_SIZE) {
+        AO_DBG_ERR("Fn too long: %.*s", AO_MAX_PATH_SIZE, fn);
         return false;
     }
 
diff --git a/src/ArduinoOcpp/Core/OperationStore.cpp b/src/ArduinoOcpp/Core/OperationStore.cpp
index 1f26d12f..fe1c1743 100644
--- a/src/ArduinoOcpp/Core/OperationStore.cpp
+++ b/src/ArduinoOcpp/Core/OperationStore.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/OperationStore.h>
@@ -35,9 +35,9 @@ bool StoredOperationHandler::commit() {
 
     opNr = context.reserveOpNr();
 
-    char fn [MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", opNr);
-    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", opNr);
+    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return false;
     }
@@ -67,9 +67,9 @@ bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
 
     opNr = opNrToLoad;
 
-    char fn [MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", opNr);
-    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", opNr);
+    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return false;
     }
@@ -110,9 +110,9 @@ OperationStore::OperationStore(std::shared_ptr<FilesystemAdapter> filesystem) :
         unsigned int misses = 0;
         unsigned int i = opEnd;
         while (misses < 3) {
-            char fn [MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", i);
-            if (ret < 0 || ret >= MAX_PATH_SIZE) {
+            char fn [AO_MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", i);
+            if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
                 AO_DBG_ERR("fn error: %i", ret);
                 misses++;
                 i = (i + 1) % AO_MAX_OPNR;
@@ -174,9 +174,9 @@ void OperationStore::advanceOpNr(unsigned int oldOpNr) {
     for (unsigned int i = 0; i < rangeSize; i++) {
         unsigned int op = ((unsigned int) *opBegin + i + AO_MAX_OPNR - AO_OPHISTORY_SIZE) % AO_MAX_OPNR;
 
-        char fn [MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", op);
-        if (ret < 0 || ret >= MAX_PATH_SIZE) {
+        char fn [AO_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", op);
+        if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             break;
         }
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 06385767..4733e805 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -44,8 +44,8 @@ void ao_console_out(const char *msg);
             do { \
                 X("[AO] CONSOLE ERROR: ao_set_console_out ignored if AO_CUSTOM_CONSOLE " \
                   "not defined\n"); \
-                char msg [100]; \
-                snprintf(msg, 100, "     > see %s:%i",__FILE__,__LINE__); \
+                char msg [196]; \
+                snprintf(msg, 196, "     > see %s:%i",__FILE__,__LINE__); \
                 X(msg); \
                 X("\n     > see ArduinoOcpp/Platform.h\n"); \
             } while (0)
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
index ec087987..921bba2d 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
@@ -53,9 +53,9 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
             mvIndex = mvCount ;
         }
 
-        char fn [MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvIndex);
-        if (ret < 0 || ret >= MAX_PATH_SIZE) {
+        char fn [AO_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvIndex);
+        if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             return false;
         }
@@ -107,9 +107,9 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
 
     while (misses < MISSES_LIMIT) { //search until region without mvs found
         
-        char fn [MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvCount);
-        if (ret < 0 || ret >= MAX_PATH_SIZE) {
+        char fn [AO_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvCount);
+        if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             return false; //all files have same length
         }
@@ -192,9 +192,9 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
     auto tx = std::make_shared<TransactionMeterData>(connectorId, txNr, filesystem);
     
     if (filesystem) {
-        char fn [MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, 0);
-        if (ret < 0 || ret >= MAX_PATH_SIZE) {
+        char fn [AO_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, 0);
+        if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             return nullptr; //cannot store
         }
@@ -247,9 +247,9 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
 
             while (misses < MISSES_LIMIT) { //search until region without mvs found
                 
-                char fn [MAX_PATH_SIZE] = {'\0'};
-                auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
-                if (ret < 0 || ret >= MAX_PATH_SIZE) {
+                char fn [AO_MAX_PATH_SIZE] = {'\0'};
+                auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
+                if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
                     AO_DBG_ERR("fn error: %i", ret);
                     return false; //all files have same length
                 }
@@ -272,9 +272,9 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
         for (unsigned int i = 0; i < mvCount; i++) {
             unsigned int sd = mvCount - 1U - i;
         
-            char fn [MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, sd);
-            if (ret < 0 || ret >= MAX_PATH_SIZE) {
+            char fn [AO_MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, sd);
+            if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
                 AO_DBG_ERR("fn error: %i", ret);
                 return false;
             }
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index 0d80e2f7..9e8855cc 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
@@ -73,9 +73,9 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
         return nullptr;
     }
 
-    char fn [MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, txNr);
-    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, txNr);
+    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return nullptr;
     }
@@ -168,9 +168,9 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
         return true;
     }
 
-    char fn [MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
-    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
+    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return false;
     }
@@ -197,9 +197,9 @@ bool ConnectorTransactionStore::remove(unsigned int txNr) {
         return true;
     }
 
-    char fn [MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, txNr);
-    if (ret < 0 || ret >= MAX_PATH_SIZE) {
+    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, txNr);
+    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return false;
     }

From de422dfc3767f30043128e6e8d1b2d1b505a2e4c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 19 Apr 2023 17:53:42 +0200
Subject: [PATCH 219/549] add authorization options

---
 src/ArduinoOcpp.cpp   | 19 +++++++++++++++++++
 src/ArduinoOcpp.h     | 25 ++++++++++++++++++++-----
 src/ArduinoOcpp_c.cpp |  7 +++++++
 src/ArduinoOcpp_c.h   |  3 +++
 4 files changed, 49 insertions(+), 5 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 92f8f171..bf01e73a 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -284,6 +284,25 @@ bool beginTransaction(const char *idTag, unsigned int connectorId) {
     return true;
 }
 
+bool beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return false;
+    }
+    if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX ||
+        !parentIdTag || strnlen(parentIdTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
+        AO_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        return false;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return false;
+    }
+    connector->beginTransaction_authorized(idTag, parentIdTag);
+    return true;
+}
+
 bool endTransaction(const char *reason, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 37b3b1ed..24aef795 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -157,15 +157,30 @@ void authorize(
 /*
  * Transaction management.
  * 
- * Begin the transaction process by creating a new transaction and setting its user identification.
- * The OCPP library will try to send a StartTransaction request with all data as soon as possible
- * after all requirements for a transaction are met (i.e. the connector is plugged).
+ * Begin the transaction process and prepare it. When all conditions for the transaction are true,
+ * eventually send a StartTransaction request to the OCPP server.
+ * Conditions:
+ *     1) the connector is operative (no faults reported, not set "Unavailable" by the backend)
+ *     2) no reservation blocks the connector
+ *     3) the idTag is authorized for charging. The transaction process will send an Authorize message
+ *        to the server for approval, except if the charger is offline, then the Local Authorization
+ *        rules will apply as in the specification.
+ *     4) the vehicle is already plugged or will be plugged soon (only applicable if the
+ *        ConnectorPlugged Input is set)
  * 
- * Returns true if it was possible to create a transaction. If it returned false, either another
- * transaction is still running or you need to try it again later.
+ * See beginTransaction_authorized for skipping steps 1) to 3)
+ * 
+ * Returns true if it was possible to create the transaction process. If it returned false, either
+ * another transaction process is still active or you need to try it again later.
  */
 bool beginTransaction(const char *idTag, unsigned int connectorId = 1);
 
+/*
+ * Begin the transaction process and skip the OCPP-side authorization. See beginTransaction(...) for a
+ * complete description
+ */
+bool beginTransaction_authorized(const char *idTag, const char *parentIdTag = nullptr, unsigned int connectorId = 1);
+
 /*
  * End the transaction process by terminating the transaction and setting a reason for its termination.
  * Please refer to OCPP 1.6 Specification - Edition 2 p. 90 for a list of valid reasons. "reason"
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 324d65fb..48699047 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -204,6 +204,13 @@ void ao_beginTransaction_m(unsigned int connectorId, const char *idTag) {
     beginTransaction(idTag, connectorId);
 }
 
+void ao_beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
+    beginTransaction_authorized(idTag, parentIdTag);
+}
+void ao_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag) {
+    beginTransaction_authorized(idTag, parentIdTag, connectorId);
+}
+
 bool ao_endTransaction(const char *reason) {
     return endTransaction(reason);
 }
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index c461ef9e..7a42ae96 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -88,6 +88,9 @@ void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, Autho
 void ao_beginTransaction(const char *idTag);
 void ao_beginTransaction_m(unsigned int connectorId, const char *idTag); //multiple connectors version
 
+void ao_beginTransaction_authorized(const char *idTag);
+void ao_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag);
+
 bool ao_endTransaction(const char *reason); //reason can be NULL
 bool ao_endTransaction_m(unsigned int connectorId, const char *reason); //reason can be NULL
 

From ad36e5c4775e47e57a90ff0475cb0d6dea2b5065 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 19 Apr 2023 20:58:52 +0200
Subject: [PATCH 220/549] delete corrupt Start-/StopTx records

---
 src/ArduinoOcpp/Core/OperationsQueue.cpp      | 29 ++++++++++---------
 .../MessagesV16/StartTransaction.cpp          |  6 ++++
 .../MessagesV16/StopTransaction.cpp           |  5 ++++
 3 files changed, 27 insertions(+), 13 deletions(-)

diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/OperationsQueue.cpp
index 72084cc1..6a664132 100644
--- a/src/ArduinoOcpp/Core/OperationsQueue.cpp
+++ b/src/ArduinoOcpp/Core/OperationsQueue.cpp
@@ -102,26 +102,29 @@ void PersistentOperationsQueue::pop_front() {
         
         std::unique_ptr<OcppOperation> fetched;
 
-        bool exists = false;
         unsigned int range = (opStore.getOpEnd() + AO_MAX_OPNR - nextOpNr) % AO_MAX_OPNR;
         for (size_t i = 0; i < range; i++) {
-            exists = storageHandler->restore(nextOpNr);
+            bool exists = storageHandler->restore(nextOpNr);
             if (exists) {
-                break;
-            }
-            nextOpNr++;
-            nextOpNr %= AO_MAX_OPNR;
-        }
+                //case B) -> load operation from flash and take it as front element
+
+                fetched = makeOcppOperation();
 
-        if (exists) {
-            //case B) -> load operation from flash and take it as front element
-            fetched = makeOcppOperation();
-            
-            bool success = fetched->restore(std::move(storageHandler), baseModel);
+                bool success = fetched->restore(std::move(storageHandler), baseModel);
+
+                if (success) {
+                    //loaded operation from flash and will place it at head position of the queue
+                    break;
+                }
 
-            if (!success) {
                 AO_DBG_ERR("could not restore operation");
                 fetched.reset();
+                opStore.advanceOpNr(nextOpNr);
+                nextOpNr = opStore.getOpBegin();
+            } else {
+                //didn't find anything at this slot. Try next slot
+                nextOpNr++;
+                nextOpNr %= AO_MAX_OPNR;
             }
         }
 
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 92eb0702..88eb64d8 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -7,6 +7,7 @@
 #include <ArduinoOcpp/Core/OperationStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
@@ -78,6 +79,11 @@ bool StartTransaction::restore(StoredOperationHandler *opStore) {
     transaction = txStore->getTransaction(connectorId, txNr);
     if (!transaction) {
         AO_DBG_ERR("referential integrity violation");
+
+        //clean up possible tx records
+        if (auto mSerivce = context.getMeteringService()) {
+            mSerivce->removeTxMeterData(connectorId, txNr);
+        }
         return false;
     }
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 432dbf4d..256cf810 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -81,6 +81,11 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
     transaction = txStore->getTransaction(connectorId, txNr);
     if (!transaction) {
         AO_DBG_ERR("referential integrity violation");
+
+        //clean up possible tx records
+        if (auto mSerivce = context.getMeteringService()) {
+            mSerivce->removeTxMeterData(connectorId, txNr);
+        }
         return false;
     }
 

From 98c2685d547e4436c7232442590635afdebf9941 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 21 Apr 2023 15:45:50 +0200
Subject: [PATCH 221/549] clear tx log (linux support)

---
 src/ArduinoOcpp.cpp                           |  2 +-
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp    | 44 ++++++++++++++++++-
 src/ArduinoOcpp/Core/FilesystemAdapter.h      |  2 +
 src/ArduinoOcpp/Core/FilesystemUtils.cpp      | 18 ++++++++
 src/ArduinoOcpp/Core/FilesystemUtils.h        |  2 +
 src/ArduinoOcpp/MessagesV16/ClearCache.cpp    | 22 ++++++++--
 src/ArduinoOcpp/MessagesV16/ClearCache.h      |  8 +++-
 .../ChargePointStatusService.cpp              |  6 +--
 .../ChargePointStatusService.h                |  3 +-
 9 files changed, 95 insertions(+), 12 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index bf01e73a..056b4f51 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -141,7 +141,7 @@ void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredent
     model.setBootService(std::unique_ptr<BootService>(
         new BootService(*ocppEngine)));
     model.setChargePointStatusService(std::unique_ptr<ChargePointStatusService>(
-        new ChargePointStatusService(*ocppEngine, AO_NUMCONNECTORS)));
+        new ChargePointStatusService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
         new HeartbeatService(*ocppEngine)));
     model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 3c04eb69..9ab208b7 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
@@ -145,6 +145,28 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     bool remove(const char *fn) override {
         return USE_FS.remove(fn);
     };
+    int ftw_root(std::function<int(const char *fpath)> fn) {
+#if AO_USE_FILEAPI == ARDUINO_LITTLEFS
+
+#elif AO_USE_FILEAPI == ARDUINO_SPIFFS
+        auto dir = USE_FS.open(AO_FILENAME_PREFIX);
+        if (!dir) {
+            AO_DBG_ERR("cannot open root directory: " AO_FILENAME_PREFIX);
+            return -1;
+        }
+
+        int err = 0;
+        while (auto entry = dir.openNextFile()) {
+            err = fn(entry.name());
+            if (err) {
+                break;
+            }
+        }
+        return err;
+#else
+#error
+#endif
+    }
 };
 
 std::weak_ptr<FilesystemAdapter> filesystemCache;
@@ -299,6 +321,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 #include <cstdio>
 #include <sys/stat.h>
+#include <dirent.h>
 
 namespace ArduinoOcpp {
 
@@ -358,6 +381,25 @@ class PosixFilesystemAdapter : public FilesystemAdapter {
     bool remove(const char *fn) override {
         return ::remove(fn) == 0;
     }
+
+    int ftw_root(std::function<int(const char *fpath)> fn) {
+        auto dir = opendir(AO_FILENAME_PREFIX); // use c_str() to convert the path string to a C-style string
+        if (!dir) {
+            AO_DBG_ERR("cannot open root directory: " AO_FILENAME_PREFIX);
+            return -1;
+        }
+
+        int err = 0;
+        while (auto entry = readdir(dir)) {
+            err = fn(entry->d_name);
+            if (err) {
+                break;
+            }
+        }
+
+        closedir(dir);
+        return err;
+    }
 };
 
 std::weak_ptr<FilesystemAdapter> filesystemCache;
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index 35b661f1..2f1e6b9b 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -15,6 +15,7 @@
 #define POSIX_FILEAPI    4
 
 #include <memory>
+#include <functional>
 #include <ArduinoOcpp/Platform.h>
 
 namespace ArduinoOcpp {
@@ -36,6 +37,7 @@ class FilesystemAdapter {
     virtual int stat(const char *path, size_t *size) = 0;
     virtual std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) = 0;
     virtual bool remove(const char *fn) = 0;
+    virtual int ftw_root(std::function<int(const char *fpath)> fn) = 0; //enumerate the files in the ao_store root folder
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
index f394f9d8..fe857ca5 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -114,3 +114,21 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
     AO_DBG_DEBUG("Wrote JSON file: %s", fn);
     return true;
 }
+
+bool FilesystemUtils::remove_all(std::shared_ptr<FilesystemAdapter> filesystem, const char *fpath_prefix) {
+    return filesystem->ftw_root([filesystem, fpath_prefix] (const char *fpath) {
+        if (!strncmp(fpath, fpath_prefix, strlen(fpath_prefix))) {
+
+            char fn [AO_MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "/%s", fpath);
+            if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
+                AO_DBG_ERR("fn error: %i", ret);
+                return -1;
+            }
+
+            filesystem->remove(fn);
+            //no error handling - just skip failed file
+        }
+        return 0;
+    }) == 0;
+}
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.h b/src/ArduinoOcpp/Core/FilesystemUtils.h
index 77cbc179..a5f56e1f 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.h
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.h
@@ -39,6 +39,8 @@ namespace FilesystemUtils {
 std::unique_ptr<DynamicJsonDocument> loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn);
 bool storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const DynamicJsonDocument& doc);
 
+bool remove_all(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn_prefix);
+
 }
 
 }
diff --git a/src/ArduinoOcpp/MessagesV16/ClearCache.cpp b/src/ArduinoOcpp/MessagesV16/ClearCache.cpp
index d761c135..5d6d36cd 100644
--- a/src/ArduinoOcpp/MessagesV16/ClearCache.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ClearCache.cpp
@@ -1,13 +1,14 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/ClearCache.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::ClearCache;
 
-ClearCache::ClearCache() {
+ClearCache::ClearCache(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
   
 }
 
@@ -16,12 +17,25 @@ const char* ClearCache::getOcppOperationType(){
 }
 
 void ClearCache::processReq(JsonObject payload) {
-    AO_DBG_WARN("Authorization Cache not supported - ClearCache is without effect");
+    AO_DBG_WARN("Clear transaction log (Authorization Cache not supported)");
+
+    if (!filesystem) {
+        //no persistency - nothing to do
+        return;
+    }
+
+    success &= FilesystemUtils::remove_all(filesystem, "sd");
+    success &= FilesystemUtils::remove_all(filesystem, "tx");
+    success &= FilesystemUtils::remove_all(filesystem, "op");
 }
 
 std::unique_ptr<DynamicJsonDocument> ClearCache::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    payload["status"] = "Accepted"; //"Accepted", because the intended postcondition is true
+    if (success) {
+        payload["status"] = "Accepted"; //"Accepted", because the intended postcondition is true
+    } else {
+        payload["status"] = "Rejected";
+    }
     return doc;
 }
diff --git a/src/ArduinoOcpp/MessagesV16/ClearCache.h b/src/ArduinoOcpp/MessagesV16/ClearCache.h
index ea166580..aa57a54c 100644
--- a/src/ArduinoOcpp/MessagesV16/ClearCache.h
+++ b/src/ArduinoOcpp/MessagesV16/ClearCache.h
@@ -1,18 +1,22 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CLEARCACHE_H
 #define CLEARCACHE_H
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
 
 class ClearCache : public OcppMessage {
+private:
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    bool success = true;
 public:
-    ClearCache();
+    ClearCache(std::shared_ptr<FilesystemAdapter> filesystem);
 
     const char* getOcppOperationType();
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
index 1d0eeb75..05d57626 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
@@ -30,7 +30,7 @@
 
 using namespace ArduinoOcpp;
 
-ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned int numConn)
+ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
       : context(context) {
 
     for (unsigned int i = 0; i < numConn; i++) {
@@ -72,8 +72,8 @@ ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned
         return new Ocpp16::ChangeAvailability(context.getOcppModel());});
     context.getOperationDeserializer().registerOcppOperation("ChangeConfiguration", [] () {
         return new Ocpp16::ChangeConfiguration();});
-    context.getOperationDeserializer().registerOcppOperation("ClearCache", [] () {
-        return new Ocpp16::ClearCache();});
+    context.getOperationDeserializer().registerOcppOperation("ClearCache", [filesystem] () {
+        return new Ocpp16::ClearCache(filesystem);});
     context.getOperationDeserializer().registerOcppOperation("GetConfiguration", [] () {
         return new Ocpp16::GetConfiguration();});
     context.getOperationDeserializer().registerOcppOperation("RemoteStartTransaction", [&context] () {
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
index fbed6540..ac020458 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
@@ -6,6 +6,7 @@
 #define CHARGEPOINTSTATUSSERVICE_H
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Platform.h>
 
 #include <vector>
@@ -29,7 +30,7 @@ class ChargePointStatusService {
     std::shared_ptr<Configuration<int>> resetRetries;
 
 public:
-    ChargePointStatusService(OcppEngine& context, unsigned int numConnectors);
+    ChargePointStatusService(OcppEngine& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
     ~ChargePointStatusService();
     

From f535a19bd472bf5bd7d0c2911b4d915b06abae0d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 21 Apr 2023 15:47:33 +0200
Subject: [PATCH 222/549] mkdocs theme update

---
 mkdocs.yml | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/mkdocs.yml b/mkdocs.yml
index b790c67f..1eba2507 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -2,3 +2,46 @@ site_name: ArduinoOcpp Docs
 
 theme:
   name: material
+  features:
+    - announce.dismiss
+    - content.action.edit
+    - content.action.view
+    - content.code.annotate
+    - content.code.copy
+    # - content.tabs.link
+    - content.tooltips
+    # - header.autohide
+    # - navigation.expand
+    - navigation.footer
+    - navigation.indexes
+    # - navigation.instant
+    # - navigation.prune
+    - navigation.sections
+    - navigation.tabs
+    # - navigation.tabs.sticky
+    - navigation.top
+    - navigation.tracking
+    - search.highlight
+    - search.share
+    - search.suggest
+    - toc.follow
+    # - toc.integrate
+  palette:
+    - scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  font:
+    text: Roboto
+    code: Roboto Mono
+  favicon: assets/favicon.png
+  icon:
+    logo: logo

From 63d597abe85637500404f26003f23809a536ef3d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 21 Apr 2023 17:50:29 +0200
Subject: [PATCH 223/549] add '/' to AO_FILENAME_PREFIX

---
 .github/workflows/platformless.yml                 |  2 +-
 .github/workflows/tests.yml                        |  2 +-
 src/ArduinoOcpp/Core/Configuration.h               |  6 +++---
 src/ArduinoOcpp/Core/FilesystemAdapter.h           |  2 +-
 src/ArduinoOcpp/Core/FilesystemUtils.cpp           |  2 +-
 src/ArduinoOcpp/Core/OperationStore.cpp            | 14 +++++---------
 .../Tasks/Authorization/AuthorizationService.cpp   |  2 +-
 src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp      | 14 +++++---------
 src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp  |  2 +-
 .../Tasks/Transactions/TransactionStore.cpp        | 12 ++++--------
 10 files changed, 23 insertions(+), 35 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index a380452c..a1f71993 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -23,4 +23,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_USE_FILEAPI=POSIX_FILEAPI -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -DAO_DEACTIVATE_FLASH_SMARTCHARGING -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_USE_FILEAPI=POSIX_FILEAPI -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store/"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -DAO_DEACTIVATE_FLASH_SMARTCHARGING -Wall
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index be1f1ff1..5565deb4 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -23,7 +23,7 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -o ./output -Wall
+      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store/"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -o ./output -Wall
     - name: Configure FS
       run: mkdir ao_store
     - name: Run tests
diff --git a/src/ArduinoOcpp/Core/Configuration.h b/src/ArduinoOcpp/Core/Configuration.h
index 5f815fde..0b62ff62 100644
--- a/src/ArduinoOcpp/Core/Configuration.h
+++ b/src/ArduinoOcpp/Core/Configuration.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONFIGURATION_H
@@ -13,9 +13,9 @@
 #include <memory>
 #include <vector>
 
-#define CONFIGURATION_FN (AO_FILENAME_PREFIX "/arduino-ocpp.cnf")
+#define CONFIGURATION_FN (AO_FILENAME_PREFIX "arduino-ocpp.cnf")
 #define CONFIGURATION_VOLATILE "/volatile"
-#define AO_KEYVALUE_FN (AO_FILENAME_PREFIX "/client-state.cnf")
+#define AO_KEYVALUE_FN (AO_FILENAME_PREFIX "client-state.cnf")
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index 2f1e6b9b..31fcce3f 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -6,7 +6,7 @@
 #define AO_FILESYSTEMADAPTER_H
 
 #ifndef AO_FILENAME_PREFIX
-#define AO_FILENAME_PREFIX ""
+#define AO_FILENAME_PREFIX "/"
 #endif
 
 #define ARDUINO_LITTLEFS 1
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
index fe857ca5..4a99b882 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -120,7 +120,7 @@ bool FilesystemUtils::remove_all(std::shared_ptr<FilesystemAdapter> filesystem,
         if (!strncmp(fpath, fpath_prefix, strlen(fpath_prefix))) {
 
             char fn [AO_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "/%s", fpath);
+            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "%s", fpath);
             if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
                 AO_DBG_ERR("fn error: %i", ret);
                 return -1;
diff --git a/src/ArduinoOcpp/Core/OperationStore.cpp b/src/ArduinoOcpp/Core/OperationStore.cpp
index fe1c1743..60283324 100644
--- a/src/ArduinoOcpp/Core/OperationStore.cpp
+++ b/src/ArduinoOcpp/Core/OperationStore.cpp
@@ -8,11 +8,7 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
-#ifndef AO_OPSTORE_DIR
-#define AO_OPSTORE_DIR AO_FILENAME_PREFIX "/"
-#endif
-
-#define AO_OPSTORE_FN AO_FILENAME_PREFIX "/opstore.cnf"
+#define AO_OPSTORE_FN AO_FILENAME_PREFIX "opstore.cnf"
 
 #define AO_OPHISTORY_SIZE 3
 
@@ -36,7 +32,7 @@ bool StoredOperationHandler::commit() {
     opNr = context.reserveOpNr();
 
     char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", opNr);
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "op" "-%u.jsn", opNr);
     if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return false;
@@ -68,7 +64,7 @@ bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
     opNr = opNrToLoad;
 
     char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", opNr);
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "op" "-%u.jsn", opNr);
     if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return false;
@@ -111,7 +107,7 @@ OperationStore::OperationStore(std::shared_ptr<FilesystemAdapter> filesystem) :
         unsigned int i = opEnd;
         while (misses < 3) {
             char fn [AO_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", i);
+            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "op" "-%u.jsn", i);
             if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
                 AO_DBG_ERR("fn error: %i", ret);
                 misses++;
@@ -175,7 +171,7 @@ void OperationStore::advanceOpNr(unsigned int oldOpNr) {
         unsigned int op = ((unsigned int) *opBegin + i + AO_MAX_OPNR - AO_OPHISTORY_SIZE) % AO_MAX_OPNR;
 
         char fn [AO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_OPSTORE_DIR "op" "-%u.jsn", op);
+        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "op" "-%u.jsn", op);
         if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             break;
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index be148441..e33140de 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -13,7 +13,7 @@
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Debug.h>
 
-#define AO_LOCALAUTHORIZATIONLIST_FN (AO_FILENAME_PREFIX "/localauth.jsn")
+#define AO_LOCALAUTHORIZATIONLIST_FN (AO_FILENAME_PREFIX "localauth.jsn")
 
 using namespace ArduinoOcpp;
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
index 921bba2d..6580afe5 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
@@ -9,10 +9,6 @@
 
 #include <algorithm>
 
-#ifndef AO_METERSTORE_DIR
-#define AO_METERSTORE_DIR AO_FILENAME_PREFIX "/"
-#endif
-
 #define AO_MAX_STOPTXDATA_LEN 4
 
 using namespace ArduinoOcpp;
@@ -54,7 +50,7 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
         }
 
         char fn [AO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvIndex);
+        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvIndex);
         if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             return false;
@@ -108,7 +104,7 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
     while (misses < MISSES_LIMIT) { //search until region without mvs found
         
         char fn [AO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvCount);
+        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvCount);
         if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             return false; //all files have same length
@@ -193,7 +189,7 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
     
     if (filesystem) {
         char fn [AO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, 0);
+        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, 0);
         if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             return nullptr; //cannot store
@@ -248,7 +244,7 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
             while (misses < MISSES_LIMIT) { //search until region without mvs found
                 
                 char fn [AO_MAX_PATH_SIZE] = {'\0'};
-                auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
+                auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
                 if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
                     AO_DBG_ERR("fn error: %i", ret);
                     return false; //all files have same length
@@ -273,7 +269,7 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
             unsigned int sd = mvCount - 1U - i;
         
             char fn [AO_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_METERSTORE_DIR "sd" "-%u-%u-%u.jsn", connectorId, txNr, sd);
+            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, sd);
             if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
                 AO_DBG_ERR("fn error: %i", ret);
                 return false;
diff --git a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
index dd25c4d9..a3b245c8 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
@@ -7,7 +7,7 @@
 #include <ArduinoOcpp/Debug.h>
 
 #ifndef RESERVATION_FN
-#define RESERVATION_FN (AO_FILENAME_PREFIX "/reservations.jsn")
+#define RESERVATION_FN (AO_FILENAME_PREFIX "reservations.jsn")
 #endif
 
 using namespace ArduinoOcpp;
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index 9e8855cc..f85353d7 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -14,11 +14,7 @@
 
 using namespace ArduinoOcpp;
 
-#ifndef AO_TXSTORE_DIR
-#define AO_TXSTORE_DIR AO_FILENAME_PREFIX "/"
-#endif
-
-#define AO_TXSTORE_META_FN AO_FILENAME_PREFIX "/txstore.jsn"
+#define AO_TXSTORE_META_FN AO_FILENAME_PREFIX "txstore.jsn"
 
 ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context, unsigned int connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context),
@@ -74,7 +70,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
     }
 
     char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, txNr);
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
     if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return nullptr;
@@ -169,7 +165,7 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
     }
 
     char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
     if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return false;
@@ -198,7 +194,7 @@ bool ConnectorTransactionStore::remove(unsigned int txNr) {
     }
 
     char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_TXSTORE_DIR "tx" "-%u-%u.jsn", connectorId, txNr);
+    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
     if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
         AO_DBG_ERR("fn error: %i", ret);
         return false;

From 8ff29954ff01df25832fb831ed1d1c3454c3d48e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 21 Apr 2023 18:13:49 +0200
Subject: [PATCH 224/549] clear log (ESP8266)

---
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp | 31 +++++++---------------
 1 file changed, 9 insertions(+), 22 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 9ab208b7..0477b6de 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -87,20 +87,6 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
 #endif
         } //end if mustMount()
 
-#if AO_DBG_LEVEL >= AO_DL_DEBUG
-        if (valid) {
-            File root = USE_FS.open("/");
-            File file = root.openNextFile();
-
-            AO_DBG_DEBUG("filesystem content:");
-            while(file) {
-                AO_CONSOLE_PRINTF("[AO]     > %s\n", file.name() ? file.name() : "null");
-                file = root.openNextFile();       
-            }
-
-            root.close();
-        }
-#endif //endif AO_DBG_LEVEL >= AO_DL_DBUG
     }
 
     ~ArduinoFilesystemAdapter() {
@@ -149,15 +135,16 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
 #if AO_USE_FILEAPI == ARDUINO_LITTLEFS
 
 #elif AO_USE_FILEAPI == ARDUINO_SPIFFS
-        auto dir = USE_FS.open(AO_FILENAME_PREFIX);
-        if (!dir) {
-            AO_DBG_ERR("cannot open root directory: " AO_FILENAME_PREFIX);
-            return -1;
-        }
-
+        auto dir = USE_FS.openDir(AO_FILENAME_PREFIX);
         int err = 0;
-        while (auto entry = dir.openNextFile()) {
-            err = fn(entry.name());
+        while (dir.next()) {
+            auto fname = dir.fileName();
+            if (fname.c_str()) {
+                err = fn(fname.c_str() + strlen(AO_FILENAME_PREFIX));
+            } else {
+                AO_DBG_ERR("fs error");
+                err = -1;
+            }
             if (err) {
                 break;
             }

From 9cd38982c5e7923b9298977d1a34e15626ae7def Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 22 Apr 2023 13:04:28 +0200
Subject: [PATCH 225/549] clear log (ESP32, Arduino)

---
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp | 23 ++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 0477b6de..26ecc61a 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -133,7 +133,30 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     };
     int ftw_root(std::function<int(const char *fpath)> fn) {
 #if AO_USE_FILEAPI == ARDUINO_LITTLEFS
+        auto dir = USE_FS.open(AO_FILENAME_PREFIX);
+        if (!dir) {
+            AO_DBG_ERR("cannot open root directory: " AO_FILENAME_PREFIX);
+            return -1;
+        }
+
+        int err = 0;
+        while (auto entry = dir.openNextFile()) {
+
+            char fname [AO_MAX_PATH_SIZE];
+            auto ret = snprintf(fname, AO_MAX_PATH_SIZE, "%s", entry.name() + strlen(AO_FILENAME_PREFIX));
+            entry.close();
 
+            if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
+                AO_DBG_ERR("fn error: %i", ret);
+                return -1;
+            }
+
+            err = fn(fname);
+            if (err) {
+                break;
+            }
+        }
+        return err;
 #elif AO_USE_FILEAPI == ARDUINO_SPIFFS
         auto dir = USE_FS.openDir(AO_FILENAME_PREFIX);
         int err = 0;

From 423ea39fa9a7c6cd3c2916213fdbb313f983ffd1 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 22 Apr 2023 15:39:22 +0200
Subject: [PATCH 226/549] clear log (ESP-IDF)

---
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp | 33 ++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 26ecc61a..08b6e0e2 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -208,6 +208,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 #elif AO_USE_FILEAPI == ESPIDF_SPIFFS
 
 #include <sys/stat.h>
+#include <dirent.h>
 #include "esp_spiffs.h"
 
 namespace ArduinoOcpp {
@@ -273,6 +274,38 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
     bool remove(const char *fn) override {
         return unlink(fn) == 0;
     }
+
+    int ftw_root(std::function<int(const char *fpath)> fn) {
+        //open AO root directory
+        char dname [AO_MAX_PATH_SIZE];
+        auto dlen = snprintf(dname, AO_MAX_PATH_SIZE, "%s", AO_FILENAME_PREFIX);
+        if (dlen < 0 || dlen >= AO_MAX_PATH_SIZE) {
+            AO_DBG_ERR("fn error: %i", dlen);
+            return -1;
+        }
+
+        // trim trailing '/' if not root directory
+        if (dlen >= 2 && dname[dlen - 1] == '/') {
+            dname[dlen - 1] = '\0';
+        }
+
+        auto dir = opendir(dname);
+        if (!dir) {
+            AO_DBG_ERR("cannot open root directory: %s", dname);
+            return -1;
+        }
+
+        int err = 0;
+        while (auto entry = readdir(dir)) {
+            err = fn(entry->d_name);
+            if (err) {
+                break;
+            }
+        }
+
+        closedir(dir);
+        return err;
+    }
 };
 
 std::weak_ptr<FilesystemAdapter> filesystemCache;

From 1af7df4ec28ee454405f2cd4ab8d24830466bd28 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 23 Apr 2023 17:50:39 +0200
Subject: [PATCH 227/549] fix stop reason if LocalPreAuth was deauthorized

---
 .../ChargePointStatus/ConnectorStatus.cpp     | 29 ++++++++-----------
 .../Tasks/Transactions/Transaction.cpp        |  8 +++--
 .../Tasks/Transactions/Transaction.h          | 21 +++++++-------
 3 files changed, 28 insertions(+), 30 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index bb39fdd5..30308503 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -64,7 +64,7 @@ ConnectorStatus::ConnectorStatus(OcppEngine& context, int connectorId)
      *     - instruct the tx-based meter to begin a transaction (if tx-based meter handler is set)
      */
     txProcess.addTrigger([this] () -> TxTrigger {
-        if (transaction && transaction->isInSession() && transaction->isActive()) {
+        if (transaction && transaction->isActive() && transaction->isAuthorized()) {
             return TxTrigger::Active;
         } else {
             return TxTrigger::Inactive;
@@ -205,7 +205,7 @@ OcppMessage *ConnectorStatus::loop() {
     if (transaction) { //begin exclusively transaction-related operations
             
         if (connectorPluggedSampler) {
-            if (transaction->isRunning() && transaction->isInSession() && !connectorPluggedSampler()) {
+            if (transaction->isRunning() && transaction->isActive() && !connectorPluggedSampler()) {
                 if (!stopTransactionOnEVSideDisconnect || *stopTransactionOnEVSideDisconnect) {
                     AO_DBG_DEBUG("Stop Tx due to EV disconnect");
                     transaction->setStopReason("EVDisconnected");
@@ -215,7 +215,7 @@ OcppMessage *ConnectorStatus::loop() {
             }
         }
 
-        if (transaction->isInSession() &&
+        if (transaction->isActive() &&
                 !transaction->getStartRpcSync().isRequested() &&
                 transaction->getSessionTimestamp() > MIN_TIME &&
                 connectionTimeOut && *connectionTimeOut > 0 &&
@@ -226,7 +226,7 @@ OcppMessage *ConnectorStatus::loop() {
             transaction->commit();
         }
 
-        if (transaction->isInSession() && transaction->isIdTagDeauthorized()) {
+        if (transaction->isActive() && transaction->isIdTagDeauthorized()) {
             if (!stopTransactionOnInvalidId || *stopTransactionOnInvalidId) {
                 AO_DBG_DEBUG("DeAuthorize session");
                 transaction->setStopReason("DeAuthorized");
@@ -280,7 +280,7 @@ OcppMessage *ConnectorStatus::loop() {
             }
         } else if (transaction->isRunning()) {
 
-            if (transaction->isInSession()) {
+            if (transaction->isActive()) {
                 AO_DBG_DEBUG("Tx process not active");
                 transaction->endSession();
                 transaction->commit();
@@ -407,7 +407,7 @@ void ConnectorStatus::allocateTransaction(const char *idTag) {
             }
             if (removed) {
                 model.getTransactionStore()->setTxEnd(connectorId, txr);
-                AO_DBG_WARN("deleted dangling silent tx for new transaction");
+                AO_DBG_WARN("deleted dangling silent or aborted tx for new transaction");
             } else {
                 AO_DBG_ERR("memory corruption");
                 break;
@@ -566,18 +566,13 @@ std::shared_ptr<Transaction> ConnectorStatus::beginTransaction(const char *idTag
     auto authorize = makeOcppOperation(new Ocpp16::Authorize(context.getOcppModel(), idTag));
     authorize->setTimeout(authorizationTimeout && *authorizationTimeout > 0 ? *authorizationTimeout * 1000UL : 20UL * 1000UL);
     auto tx = transaction;
-    authorize->setOnReceiveReqListener([this, tx] (JsonObject response) {
+    authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
         JsonObject idTagInfo = response["idTagInfo"];
 
         if (strcmp("Accepted", idTagInfo["status"] | "UNDEFINED")) {
             //Authorization rejected, abort transaction
             AO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->getIdTag());
-            if (tx->isRunning()) {
-                //handle dangling Authorize request. Deauthorized tx will be handled according to StopTransactionOnInvalidId
-                tx->setIdTagDeauthorized();
-            } else {
-                tx->endSession();
-            }
+            tx->setIdTagDeauthorized();
             tx->commit();
             return;
         }
@@ -668,8 +663,8 @@ std::shared_ptr<Transaction> ConnectorStatus::beginTransaction_authorized(const
     transaction->setAuthorized();
     
     if (model.getReservationService()) {
-        if (auto reservation = model.getReservationService()->getReservation(connectorId, idTag, nullptr)) { //TODO set parentIdTag
-            if (reservation->matches(idTag, nullptr)) { //TODO set parentIdTag
+        if (auto reservation = model.getReservationService()->getReservation(connectorId, idTag, parentIdTag)) {
+            if (reservation->matches(idTag, parentIdTag)) {
                 transaction->setReservationId(reservation->getReservationId());
             }
         }
@@ -687,7 +682,7 @@ void ConnectorStatus::endTransaction(const char *reason) {
         return;
     }
 
-    if (transaction->isInSession()) {
+    if (transaction->isActive()) {
         AO_DBG_DEBUG("End session with idTag %s for reason %s, %s previous reason",
                                 transaction->getIdTag(), reason ? reason : "undefined",
                                 *transaction->getStopReason() ? "overruled by" : "no");
@@ -706,7 +701,7 @@ const char *ConnectorStatus::getSessionIdTag() {
         return nullptr;
     }
 
-    return transaction->isInSession() ? transaction->getIdTag() : nullptr;
+    return transaction->isActive() ? transaction->getIdTag() : nullptr;
 }
 
 uint16_t ConnectorStatus::getSessionWriteCount() {
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index eae8b85c..7245bb6c 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -26,6 +26,9 @@ bool Transaction::serializeSessionState(DynamicJsonDocument& out) {
     if (session.authorized) {
         sessionState["authorized"] = session.authorized;
     }
+    if (session.deauthorized) {
+        sessionState["deauthorized"] = session.deauthorized;
+    }
     if (session.timestamp > MIN_TIME) {
         char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
         session.timestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
@@ -65,7 +68,6 @@ bool Transaction::serializeSessionState(DynamicJsonDocument& out) {
     if (start.rpc.confirmed) {
         JsonObject txStartServerSide = txStart.createNestedObject("server");
         txStartServerSide["transactionId"] = start.server.transactionId;
-        txStartServerSide["authorized"] = start.server.authorized;
     }
 
     JsonObject txStop = state.createNestedObject("stop");
@@ -130,6 +132,9 @@ bool Transaction::deserializeSessionState(JsonObject state) {
     if (sessionState.containsKey("authorized")) {
         session.authorized = sessionState["authorized"] | false;
     }
+    if (sessionState.containsKey("deauthorized")) {
+        session.deauthorized = sessionState["deauthorized"] | false;
+    }
     if (sessionState.containsKey("timestamp")) {
         session.timestamp.setTime(sessionState["timestamp"] | "Invalid");
     }
@@ -166,7 +171,6 @@ bool Transaction::deserializeSessionState(JsonObject state) {
     if (start.rpc.confirmed) {
         JsonObject txStartServerSide = txStart["server"];
         start.server.transactionId = txStartServerSide["transactionId"] | -1;
-        start.server.authorized = txStartServerSide["authorized"] | false;
     }
 
     JsonObject txStop = state["stop"];
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index 9989be17..c655597e 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -53,7 +53,6 @@ class ServerTransactionStart {
 private:
     friend class Transaction;
 
-    bool authorized = true;      //authorization status; only valid if confirmed = true
     int transactionId = -1; //only valid if confirmed = true
 };
 
@@ -95,6 +94,7 @@ class ChargingSession {
     
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
     bool authorized = false;    //if the given idTag was authorized
+    bool deauthorized = false;  //if the server revoked a local authorization
     OcppTimestamp timestamp = MIN_TIME;
     int txProfileId = -1;
 
@@ -137,12 +137,11 @@ class Transaction {
 
     bool isAborted() {return !start.rpc.requested && !session.active;}
     bool isCompleted() {return stop.rpc.isConfirmed();}
-    bool isPreparing() {return session.active && !start.rpc.isRequested() && !stop.rpc.isRequested();}
+    bool isPreparing() {return session.active && !start.rpc.isRequested();}
     bool isRunning() {return start.rpc.isRequested() && !stop.rpc.isRequested();}
-    bool isActive() {return session.active && !stop.rpc.isRequested();}
-    bool isInSession() {return isActive() && *session.idTag;}
+    bool isActive() {return session.active;}
 
-    const char *getIdTag() {return session.idTag;} //only for testing in StartTx.req
+    const char *getIdTag() {return session.idTag;}
     void setIdTag(const char *idTag) {snprintf(session.idTag, IDTAG_LEN_MAX + 1, "%s", idTag);}
     OcppTimestamp& getSessionTimestamp() {return session.timestamp;}
     void setSessionTimestamp(OcppTimestamp timestamp) {session.timestamp = timestamp;}
@@ -152,16 +151,16 @@ class Transaction {
     void endSession() {session.active = false;}
 
     void setAuthorized() {session.authorized = true;}
-    bool isAuthorized() {return session.authorized && start.server.authorized;}
+    bool isAuthorized() {return session.authorized;}
 
-    void setIdTagDeauthorized() {start.server.authorized = false;}
-    bool isIdTagDeauthorized() {return start.rpc.isConfirmed() && !start.server.authorized;}
+    void setIdTagDeauthorized() {session.deauthorized = true;}
+    bool isIdTagDeauthorized() {return session.deauthorized;}
 
     int getTransactionId() {return start.server.transactionId;}
     void setTransactionId(int transactionId) {start.server.transactionId = transactionId;}
 
     void setMeterStart(int32_t meter) {start.client.meter = meter;}
-    bool isMeterStartDefined() {return start.client.meter >= 0;} //should introduce extra variable later
+    bool isMeterStartDefined() {return start.client.meter >= 0;}
     int32_t getMeterStart() {return start.client.meter;}
 
     void setReservationId(int reservationId) {start.client.reservationId = reservationId;}
@@ -171,13 +170,13 @@ class Transaction {
     OcppTimestamp& getStartTimestamp() {return start.client.timestamp;}
 
     void setMeterStop(int32_t meter) {stop.client.meter = meter;}
-    bool isMeterStopDefined() {return stop.client.meter >= 0;} //should introduce extra variable later
+    bool isMeterStopDefined() {return stop.client.meter >= 0;}
     int32_t getMeterStop() {return stop.client.meter;}
 
     void setStopTimestamp(OcppTimestamp timestamp) {stop.client.timestamp = timestamp;}
     OcppTimestamp& getStopTimestamp() {return stop.client.timestamp;}
 
-    const char *getStopIdTag() {return stop.client.idTag;} //only for testing in StartTx.req
+    const char *getStopIdTag() {return stop.client.idTag;}
     void setStopIdTag(const char *idTag) {snprintf(stop.client.idTag, IDTAG_LEN_MAX + 1, "%s", idTag);}
 
     bool commit();

From 78e38dec8948e539e59d5a95fb2cd3b0a1b2c1dc Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 23 Apr 2023 18:03:06 +0200
Subject: [PATCH 228/549] skip authorization for direct StartTx

---
 src/ArduinoOcpp.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 056b4f51..509a0fe5 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -729,7 +729,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         }
         transaction->setIdTag(idTag);
     } else {
-        beginTransaction(idTag); //request new transaction object
+        beginTransaction_authorized(idTag); //request new transaction object
         transaction = connector->getTransaction();
         if (!transaction) {
             AO_DBG_WARN("Transaction queue full");

From 9ebac29f5271cc67b0237ec1db2bc3ebc5997983 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 23 Apr 2023 18:10:00 +0200
Subject: [PATCH 229/549] accept nullptr as param parentIdTag

---
 src/ArduinoOcpp.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 509a0fe5..2603bd53 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -290,7 +290,7 @@ bool beginTransaction_authorized(const char *idTag, const char *parentIdTag, uns
         return false;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX ||
-        !parentIdTag || strnlen(parentIdTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
+        (parentIdTag && strnlen(parentIdTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX)) {
         AO_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }

From 1ef18f01142062de88aef1b55fc6fa4e2498afc3 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 23 Apr 2023 19:41:30 +0200
Subject: [PATCH 230/549] fixes test runner

---
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp | 3 ++-
 src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp          | 2 +-
 tests/ChargingSessions.cpp                                  | 6 ++----
 tests/TransactionSafety.cpp                                 | 3 +--
 4 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 30308503..f2f63b51 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -343,7 +343,7 @@ OcppMessage *ConnectorStatus::loop() {
                 idTag = "A0000000";
             }
             AO_DBG_INFO("begin FreeVend Tx using idTag %s", idTag);
-            beginTransaction(idTag);
+            beginTransaction_authorized(idTag);
             
             if (!transaction) {
                 AO_DBG_ERR("could not begin FreeVend Tx");
@@ -595,6 +595,7 @@ std::shared_ptr<Transaction> ConnectorStatus::beginTransaction(const char *idTag
 
         AO_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
         tx->setAuthorized();
+        tx->commit();
     });
     authorize->setOnTimeoutListener([this, tx, localAuth, expiredLocalAuth] () {
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index 7245bb6c..abe8398e 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -211,7 +211,7 @@ bool Transaction::deserializeSessionState(JsonObject state) {
     }
 
     AO_DBG_DEBUG("DUMP TX");
-    AO_DBG_DEBUG("Session   | idTag %s", session.idTag);
+    AO_DBG_DEBUG("Session   | idTag %s, active: %i, authorized: %i, deauthorized: %i", session.idTag, session.active, session.authorized, session.deauthorized);
     AO_DBG_DEBUG("Start RPC | req: %i, conf: %i", start.rpc.requested, start.rpc.confirmed);
     AO_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  stop.rpc.requested, stop.rpc.confirmed);
     if (silent) {
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 6209d272..c0c87f6a 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -16,7 +16,7 @@ TEST_CASE( "Charging sessions" ) {
 
     //initialize OcppEngine with dummy socket
     OcppEchoSocket echoSocket;
-    OCPP_initialize(echoSocket);
+    OCPP_initialize(echoSocket, ChargerCredentials("test-runner1234"));
 
     auto engine = getOcppEngine();
     auto& checkMsg = engine->getOperationDeserializer();
@@ -37,15 +37,13 @@ TEST_CASE( "Charging sessions" ) {
             checkedSN[connectorId] = !strcmp(request["status"] | "Invalid", expectedSN[connectorId]);
         });
 
-    bootNotification("dummy1234", "");
-
     SECTION("Check idle state"){
 
         bool checkedBN = false;
         checkMsg.registerOcppOperation("BootNotification", [engine] () -> OcppMessage* {return new Ocpp16::BootNotification(engine->getOcppModel(), std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(0)));});
         checkMsg.setOnRequest("BootNotification",
             [&checkedBN] (JsonObject request) {
-                checkedBN = !strcmp(request["chargePointModel"] | "Invalid", "dummy1234");
+                checkedBN = !strcmp(request["chargePointModel"] | "Invalid", "test-runner1234");
             });
         
         loop();
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 7cd4f94f..61e76db9 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -24,8 +24,6 @@ TEST_CASE( "Transaction safety" ) {
     auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN);
         *connectionTimeOut = 30;
 
-    bootNotification("dummy1234", "");
-
     SECTION("Basic transaction") {
         AO_DBG_DEBUG("Basic transaction");
         loop();
@@ -58,6 +56,7 @@ TEST_CASE( "Transaction safety" ) {
         setConnectorPluggedInput([] () {return false;});
         loop();
         beginTransaction("mIdTag");
+        loop();
         OCPP_deinitialize(); //reset and jump to next section
     }
 

From 69c41f0a6e6f455f9786f6fa7f963c442f4f8f8f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 26 Apr 2023 14:25:15 +0200
Subject: [PATCH 231/549] fix ao_getOcppHandle signature

---
 src/ArduinoOcpp_c.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 48699047..a645e367 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -355,7 +355,7 @@ void ao_set_console_out_c(void (*console_out)(const char *msg)) {
     ao_set_console_out(console_out);
 }
 
-OcppHandle *getOcppHandle() {
+OcppHandle *ao_getOcppHandle() {
     return reinterpret_cast<OcppHandle*>(getOcppEngine());
 }
 

From 7d90b1e65e9a615821ea2f1ed9b6fd73091d2127 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 27 Apr 2023 15:18:35 +0200
Subject: [PATCH 232/549] type-safe format specifier

---
 .../Tasks/Metering/ConnectorMeterValuesRecorder.cpp            | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index bbfd9d44..d2be37e6 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -13,6 +13,7 @@
 #include <ArduinoOcpp/Debug.h>
 
 #include <cstddef>
+#include <cinttypes>
 
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
@@ -149,7 +150,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
         if (dt <= 0 ||                              //normal case: interval elapsed
                 dt > *ClockAlignedDataInterval) {   //special case: clock has been adjusted or first run
 
-            AO_DBG_DEBUG("Clock aligned measurement %ds: %s", dt,
+            AO_DBG_DEBUG("Clock aligned measurement %" PRId32 "s: %s", dt,
                 abs(dt) <= 60 ?
                 "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?

From 566a1f648342d80d2cd97bacf1f9dea890d6c6d6 Mon Sep 17 00:00:00 2001
From: Nelo Pauselli <nelopauselli@gmail.com>
Date: Thu, 27 Apr 2023 13:51:13 -0300
Subject: [PATCH 233/549] bugfix: recursive call in ao_beginTransaction method

---
 src/ArduinoOcpp_c.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 47a86783..654a058f 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -187,10 +187,10 @@ void ao_authorize(const char *idTag, OnAuthorize onConfirmation, OnOcppAbort onA
 }
 
 void ao_beginTransaction(const char *idTag) {
-    ao_beginTransaction(idTag);
+    beginTransaction(idTag);
 }
 void ao_beginTransaction_m(unsigned int connectorId, const char *idTag) {
-    beginTransaction(idTag, 1);
+    beginTransaction(idTag, connectorId);
 }
 
 bool ao_endTransaction(const char *reason) {

From e39f8b699bc213691cbe4f591b64c8aa7d9f087d Mon Sep 17 00:00:00 2001
From: Nelo Pauselli <nelopauselli@gmail.com>
Date: Thu, 27 Apr 2023 14:22:25 -0300
Subject: [PATCH 234/549] define dtostrf function for ESPIDF platform

---
 src/ArduinoOcpp/Platform.cpp                  | 8 ++++++++
 src/ArduinoOcpp/Platform.h                    | 4 ++++
 src/ArduinoOcpp/Tasks/Metering/SampledValue.h | 2 ++
 3 files changed, 14 insertions(+)

diff --git a/src/ArduinoOcpp/Platform.cpp b/src/ArduinoOcpp/Platform.cpp
index 463d7cd5..11966983 100644
--- a/src/ArduinoOcpp/Platform.cpp
+++ b/src/ArduinoOcpp/Platform.cpp
@@ -59,3 +59,11 @@ unsigned long ao_tick_ms_unix() {
     return (unsigned long) ms.count();
 }
 #endif
+
+#if AO_PLATFORM == AO_PLATFORM_ESPIDF
+void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target){
+    char fmt[20];
+    sprintf(fmt, "%%%d.%df", min_width, num_digits_after_decimal);
+    sprintf(target, fmt, value);
+}
+#endif
\ No newline at end of file
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 04fa5306..bdd17557 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -96,4 +96,8 @@ unsigned long ao_tick_ms_unix();
 #endif
 #endif
 
+#if AO_PLATFORM == AO_PLATFORM_ESPIDF
+void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target);
 #endif
+
+#endif
\ No newline at end of file
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
index ea9a007d..edf7cd77 100644
--- a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/SampledValue.h
@@ -9,6 +9,8 @@
 #include <memory>
 #include <functional>
 
+#include <ArduinoOcpp/Platform.h>
+
 namespace ArduinoOcpp {
 
 template <class T>

From 2e67f98151d212bed7220f23991f4059b2ff1fb1 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 29 Apr 2023 12:23:40 +0200
Subject: [PATCH 235/549] docs installation prerequisites (WIP)

---
 docs/index.md | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/docs/index.md b/docs/index.md
index 6a06add1..ee151832 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,4 +1,25 @@
 # Getting Started with ArduinoOcpp
 
-Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.
+This chapter shows how to kick-start your project which deals with OCPP.
 
+## Installation prerequisites
+
+Throughout these document pages, it is assumed that you already have set up your development environment and that you are familiar with the corresponding building, flashing and (basic) debugging routines. ArduinoOcpp runs in many environments (from the Arduino-IDE to proprietary microcontroller IDEs like the Code Composer Studio). If you do not have any preferences yet, it is highly recommended to get started with VSCode + the PlatformIO add-on, since it is the favorite setup of the community and therefore you find the most related information in the Issues pages of the main repository.
+
+There are many high-quality tutorials for out there for setting up VSCode + PIO. The following site covers everything you need to know:
+[https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/](https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/)
+
+Once that's done, adding ArduinoOcpp is no big deal anymore. However, let's discuss another very important tool for your project first.
+
+## OCPP Server prerequisites
+
+ArduinoOcpp is just a client, but all the magic of OCPP lives in the communication between a client and a server. Although it *is* possible to run ArduinoOcpp without a real server for testing purposes, the best approach for getting started is to get the hands on a real server. So you can always use the client in a practical setup, see immediate results and simplify development a lot.
+
+Perhaps you were already given access to an OCPP server for your project. Then you can use that, it should work fine. If you don't have a server already, it is highly recommended to get
+SteVe ([https://github.com/steve-community/steve](https://github.com/steve-community/steve)).
+It allows to control every detail of the OCPP operations and shows detail-rich information about the results. And again, it is the favorite test server of the community, so you will find the most related information on the Web. For the installation instructions, please refer to the
+[SteVe docs](https://github.com/steve-community/steve#configuration-and-installation).
+
+In case you can't wait to get started, you can make the first connection test with a WebSocket echo server as a fake OCPP service. ArduinoOcpp supports that: it can send all messages to an echo server which reflects all traffic. ArduinoOcpp gets back its own messages and replies to itself with mocked responses. Complicated, but it does work and the console will show a valid OCPP communication. An example echo server is given in the following section. For the further development though, you will definitely need a real OCPP server.
+
+*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*

From 46d3673b7b1935c6deba61b1060e5ca4fb5e7b8a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 14 May 2023 16:16:46 +0200
Subject: [PATCH 236/549] remove side-effect of allocateTx

---
 .../ChargePointStatus/ConnectorStatus.cpp     | 54 +++++++++++--------
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  2 +-
 2 files changed, 32 insertions(+), 24 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index f2f63b51..1b06c996 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -386,7 +386,9 @@ const char *ConnectorStatus::getErrorCode() {
     return nullptr;
 }
 
-void ConnectorStatus::allocateTransaction(const char *idTag) {
+std::shared_ptr<Transaction> ConnectorStatus::allocateTransaction() {
+
+    decltype(allocateTransaction()) tx;
 
     //clean possible aorted tx
     auto txr = model.getTransactionStore()->getTxEnd(connectorId);
@@ -419,9 +421,9 @@ void ConnectorStatus::allocateTransaction(const char *idTag) {
     }
 
     //try to create new transaction
-    transaction = model.getTransactionStore()->createTransaction(connectorId);
+    tx = model.getTransactionStore()->createTransaction(connectorId);
 
-    if (!transaction) {
+    if (!tx) {
         //could not create transaction - now, try to replace tx history entry
 
         auto txl = model.getTransactionStore()->getTxBegin(connectorId);
@@ -429,7 +431,7 @@ void ConnectorStatus::allocateTransaction(const char *idTag) {
 
         for (decltype(txsize) i = 0; i < txsize; i++) {
 
-            if (transaction) {
+            if (tx) {
                 //success, finished here
                 break;
             }
@@ -451,7 +453,7 @@ void ConnectorStatus::allocateTransaction(const char *idTag) {
                     model.getTransactionStore()->setTxBegin(connectorId, (txl + 1) % MAX_TX_CNT);
                     AO_DBG_DEBUG("deleted tx history entry for new transaction");
 
-                    transaction = model.getTransactionStore()->createTransaction(connectorId);
+                    tx = model.getTransactionStore()->createTransaction(connectorId);
                 } else {
                     AO_DBG_ERR("memory corruption");
                     break;
@@ -467,32 +469,20 @@ void ConnectorStatus::allocateTransaction(const char *idTag) {
         }
     }
 
-    if (!transaction) {
+    if (!tx) {
         //couldn't create normal transaction -> check if to start charging without real transaction
         if (silentOfflineTransactions && *silentOfflineTransactions) {
             //try to handle charging session without sending StartTx or StopTx to the server
-            transaction = model.getTransactionStore()->createTransaction(connectorId, true);
+            tx = model.getTransactionStore()->createTransaction(connectorId, true);
 
-            if (transaction) {
+            if (tx) {
                 AO_DBG_DEBUG("created silent transaction");
                 (void)0;
             }
         }
     }
 
-    if (!transaction) {
-        return;
-    }
-    
-    if (!idTag || *idTag == '\0') {
-        //input string is empty
-        transaction->setIdTag("");
-    } else {
-        transaction->setIdTag(idTag);
-    }
-
-    transaction->setSessionTimestamp(model.getOcppTime().getOcppTimestampNow());
-
+    return tx;
 }
 
 std::shared_ptr<Transaction> ConnectorStatus::beginTransaction(const char *idTag) {
@@ -543,13 +533,22 @@ std::shared_ptr<Transaction> ConnectorStatus::beginTransaction(const char *idTag
         }
     }
 
-    allocateTransaction(idTag);
+    transaction = allocateTransaction();
 
     if (!transaction) {
         AO_DBG_ERR("could not allocate Tx");
         return nullptr;
     }
 
+    if (!idTag || *idTag == '\0') {
+        //input string is empty
+        transaction->setIdTag("");
+    } else {
+        transaction->setIdTag(idTag);
+    }
+
+    transaction->setSessionTimestamp(model.getOcppTime().getOcppTimestampNow());
+
     AO_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
 
     //check for local preauthorization
@@ -652,12 +651,21 @@ std::shared_ptr<Transaction> ConnectorStatus::beginTransaction_authorized(const
         return nullptr;
     }
 
-    allocateTransaction(idTag);
+    transaction = allocateTransaction();
 
     if (!transaction) {
         AO_DBG_ERR("could not allocate Tx");
         return nullptr;
     }
+
+    if (!idTag || *idTag == '\0') {
+        //input string is empty
+        transaction->setIdTag("");
+    } else {
+        transaction->setIdTag(idTag);
+    }
+
+    transaction->setSessionTimestamp(model.getOcppTime().getOcppTimestampNow());
     
     AO_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index b6b5693e..2d0933c2 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -35,7 +35,7 @@ class ConnectorStatus {
     const int connectorId;
 
     std::shared_ptr<Transaction> transaction;
-    void allocateTransaction(const char *idTag);
+    std::shared_ptr<Transaction> allocateTransaction();
 
     std::shared_ptr<Configuration<int>> availability;
     int availabilityVolatile = AVAILABILITY_OPERATIVE;

From a9d32e74c5603342429720dd51e3d05d9de97bf4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 14 May 2023 17:34:29 +0200
Subject: [PATCH 237/549] allow custom use of transactions

---
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 2d0933c2..39c3e54a 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -35,7 +35,6 @@ class ConnectorStatus {
     const int connectorId;
 
     std::shared_ptr<Transaction> transaction;
-    std::shared_ptr<Transaction> allocateTransaction();
 
     std::shared_ptr<Configuration<int>> availability;
     int availabilityVolatile = AVAILABILITY_OPERATIVE;
@@ -96,6 +95,9 @@ class ConnectorStatus {
     int getTransactionIdSync();
     std::shared_ptr<Transaction>& getTransaction();
 
+    //create detached transaction - won't have any side-effects with the transaction handling of this lib
+    std::shared_ptr<Transaction> allocateTransaction(); 
+
     int getAvailability();
     void setAvailability(bool available);
     void setAvailabilityVolatile(bool available); //set inoperative state but keep only until reboot at most

From 82169541bdd312b9eba24a8f59a7aa69eb5b83c8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 15 May 2023 19:53:55 +0200
Subject: [PATCH 238/549] fix function signature

---
 src/ArduinoOcpp_c.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 7a42ae96..be08f030 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -88,7 +88,7 @@ void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, Autho
 void ao_beginTransaction(const char *idTag);
 void ao_beginTransaction_m(unsigned int connectorId, const char *idTag); //multiple connectors version
 
-void ao_beginTransaction_authorized(const char *idTag);
+void ao_beginTransaction_authorized(const char *idTag, const char *parentIdTag);
 void ao_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag);
 
 bool ao_endTransaction(const char *reason); //reason can be NULL

From cb3268f18a786b0793230de192a7712214b1b4ba Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 16 May 2023 12:09:44 +0200
Subject: [PATCH 239/549] fix config StopTransactionOnEVSideDisconnect

---
 .../Tasks/ChargePointStatus/ConnectorStatus.cpp       | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 1b06c996..ac271f6e 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -113,7 +113,8 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
     } else if (transaction && transaction->isRunning()) {
         //Transaction is currently running
         if (!ocppPermitsCharge() ||
-                (connectorEnergizedSampler && !connectorEnergizedSampler())) {
+                (connectorEnergizedSampler && !connectorEnergizedSampler()) ||
+                (!connectorEnergizedSampler && connectorPluggedSampler && !connectorPluggedSampler())) { //special case when StopTransactionOnEVSideDisconnect is false
             return OcppEvseState::SuspendedEVSE;
         }
         if (evRequestsEnergySampler && !evRequestsEnergySampler()) {
@@ -784,6 +785,14 @@ void ConnectorStatus::setAvailabilityVolatile(bool available) {
 void ConnectorStatus::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
     this->connectorPluggedSampler = connectorPlugged;
     txProcess.addTrigger([this] () -> TxTrigger {
+        
+        //special case when StopTransactionOnEVSideDisconnect is false
+        if (stopTransactionOnEVSideDisconnect && !*stopTransactionOnEVSideDisconnect &&
+                transaction && transaction->isRunning()) {
+            //ignore connectorPluggedSampler while transaction is running
+            return TxTrigger::Active;
+        }
+
         return connectorPluggedSampler() ? TxTrigger::Active : TxTrigger::Inactive;
     });
 }

From 3dd2b5d17491f972dc75da820c597f460b7392f7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 16 May 2023 12:40:14 +0200
Subject: [PATCH 240/549] fix status for StopTransactionOnEVSideDisconnect

---
 src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index ac271f6e..8c50eaac 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -112,9 +112,11 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
         return OcppEvseState::Unavailable;
     } else if (transaction && transaction->isRunning()) {
         //Transaction is currently running
+        if (connectorPluggedSampler && !connectorPluggedSampler()) { //special case when StopTransactionOnEVSideDisconnect is false
+            return OcppEvseState::SuspendedEV;
+        }
         if (!ocppPermitsCharge() ||
-                (connectorEnergizedSampler && !connectorEnergizedSampler()) ||
-                (!connectorEnergizedSampler && connectorPluggedSampler && !connectorPluggedSampler())) { //special case when StopTransactionOnEVSideDisconnect is false
+                (connectorEnergizedSampler && !connectorEnergizedSampler())) { 
             return OcppEvseState::SuspendedEVSE;
         }
         if (evRequestsEnergySampler && !evRequestsEnergySampler()) {

From 9b8f3717902ccaa30b846b566c420bbd39199667 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 21 May 2023 19:34:35 +0200
Subject: [PATCH 241/549] refactor tx process

---
 CMakeLists.txt                                |   1 -
 src/ArduinoOcpp.cpp                           |  21 +-
 src/ArduinoOcpp.h                             |  32 +--
 src/ArduinoOcpp/Tasks/Boot/BootService.cpp    |   1 +
 .../ChargePointStatus/ConnectorStatus.cpp     |  83 +++-----
 .../Tasks/ChargePointStatus/ConnectorStatus.h |  16 +-
 .../Transactions/TransactionPrerequisites.h   |  32 ---
 .../Tasks/Transactions/TransactionProcess.cpp |  89 ---------
 .../Tasks/Transactions/TransactionProcess.h   |  44 -----
 src/ArduinoOcpp_c.cpp                         |  56 ++----
 src/ArduinoOcpp_c.h                           |  15 +-
 tests/ChargingSessions.cpp                    |  66 +------
 tests/TransactionProcess.cpp                  | 185 ------------------
 tests/TransactionSafety.cpp                   |   1 +
 14 files changed, 76 insertions(+), 566 deletions(-)
 delete mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h
 delete mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
 delete mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
 delete mode 100644 tests/TransactionProcess.cpp

diff --git a/CMakeLists.txt b/CMakeLists.txt
index d6d9d82e..32ba9793 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -71,7 +71,6 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
     src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
-    src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
     src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
     src/ArduinoOcpp.cpp
     src/ArduinoOcpp_c.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 2603bd53..aff1916e 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -545,7 +545,7 @@ void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnect
     connector->setOnUnlockConnector(onUnlockConnectorInOut);
 }
 
-void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnectorInOut, unsigned int connectorId) {
+void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -555,10 +555,10 @@ void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp:
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->setConnectorLock(lockConnectorInOut);
+    connector->setStartTxReadyInput(startTxReady);
 }
 
-void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> txMeterInOut, unsigned int connectorId) {
+void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId) {
     if (!ocppEngine) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -568,7 +568,20 @@ void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->setTxBasedMeterUpdate(txMeterInOut);
+    connector->setStopTxReadyInput(stopTxReady);
+}
+
+void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId) {
+    if (!ocppEngine) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+    connector->setOccupiedInput(occupied);
 }
 
 bool isOperative(unsigned int connectorId) {
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 24aef795..8a35d70e 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -14,7 +14,6 @@
 #include <ArduinoOcpp/Core/OcppOperationCallbacks.h>
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Core/PollResult.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
@@ -264,34 +263,11 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handle
  */
 void setOnUnlockConnectorInOut(std::function<ArduinoOcpp::PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId = 1);
 
-/*
- * Set an Input/Output for setting the state of the connector lock. Called in the course of normal
- * transactions (not as part of UnlockConnector).
- * Param. values: 
- *     - TxTrigger::Active if connector should be locked
- *     - TxTrigger::Inactive if connector should be unlocked
- * Return values:
- *     - TxEnableState::Active if connector is locked and ready for transaction
- *     - TxEnableState::Inactive if connector lock is released
- *     - TxEnableState::Pending otherwise, e.g. if transitioning between the states
- */
-void setConnectorLockInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> lockConnectorInOut, unsigned int connectorId = 1);
+void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId = 1); //Input if the charger is ready for StartTransaction
 
-/*
- * Set an Input/Output to interact with a transaction-based energy meter. When this OCPP library is
- * about to start a transaction, it toggles the Output to the energy meter to TxTrigger::Active so
- * the energy meter can take a measurement right before a transaction. The same goes for the stop of
- * transactions. With the Input, the energy meter signals if the measurement is ready and the
- * transaction can finally start / stop.
- * Param. values:
- *     - TxTrigger::Active if the tx-based meter should be in transaction-mode
- *     - TxTrigger::Inactive if the tx-based meter should be in non-transaction-mode
- * Return values:
- *     - TxEnableState::Active if the tx-based meter confirms to be in the transaction-mode
- *     - TxEnableState::Inactive if the tx-based meter has transitioned into a non-transaction-mode
- *     - TxEnableState::Pending otherwise, e.g. if transitioning between the states
- */
-void setTxBasedMeterInOut(std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> txMeterInOut, unsigned int connectorId = 1);
+void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId = 1); //Input if charger is ready for StopTransaction
+
+void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId = 1); //Input if instead of Available, send StatusNotification Preparing / Finishing
 
 /*
  * Access further information about the internal state of the library
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
index 04d85766..e2f1c1c1 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
@@ -5,6 +5,7 @@
 #include <ArduinoOcpp/Tasks/Boot/BootService.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
index 8c50eaac..220342e8 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
@@ -28,7 +28,7 @@ using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
 ConnectorStatus::ConnectorStatus(OcppEngine& context, int connectorId)
-        : context(context), model(context.getOcppModel()), connectorId{connectorId}, txProcess(connectorId) {
+        : context(context), model(context.getOcppModel()), connectorId{connectorId} {
 
     char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
     snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, "AO_AVAIL_CONN_%d", connectorId);
@@ -56,34 +56,6 @@ ConnectorStatus::ConnectorStatus(OcppEngine& context, int connectorId)
         AO_DBG_ERR("Cannot declare availability");
     }
 
-    /*
-     * Initialize standard EVSE behavior.
-     * By default, transactions are triggered by a valid IdTag (+ connected plug as soon as set)
-     * The default necessary steps before starting a transaction are
-     *     - lock the connector (if handler is set)
-     *     - instruct the tx-based meter to begin a transaction (if tx-based meter handler is set)
-     */
-    txProcess.addTrigger([this] () -> TxTrigger {
-        if (transaction && transaction->isActive() && transaction->isAuthorized()) {
-            return TxTrigger::Active;
-        } else {
-            return TxTrigger::Inactive;
-        }
-    });
-    txProcess.addEnableStep([this] (TxTrigger cond) -> TxEnableState {
-        if (onTxBasedMeterPollTx) {
-            return onTxBasedMeterPollTx(cond);
-        }
-        return cond == TxTrigger::Active ? TxEnableState::Active : TxEnableState::Inactive;
-    });
-    txProcess.addEnableStep([this] (TxTrigger cond) -> TxEnableState {
-        //check optional behavior UnlockConnectorOnEVSideDisconnect: if the 
-        if (onConnectorLockPollTx) {
-            return onConnectorLockPollTx(cond);
-        }
-        return cond == TxTrigger::Active ? TxEnableState::Active : TxEnableState::Inactive;
-    });
-
     if (model.getTransactionStore()) {
         transaction = model.getTransactionStore()->getLatestTransaction(connectorId);
     } else {
@@ -125,7 +97,9 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
         return OcppEvseState::Charging;
     } else if (model.getReservationService() && model.getReservationService()->getReservation(connectorId)) {
         return OcppEvseState::Reserved;
-    } else if (!txProcess.existsActiveTrigger() && txProcess.getState() == TxEnableState::Inactive) {
+    } else if ((!transaction || !transaction->isActive()) &&                 //no transaction preparation
+               (!connectorPluggedSampler || !connectorPluggedSampler()) &&   //no vehicle plugged
+               (!occupiedInput || !occupiedInput())) {                       //occupied override clear
         return OcppEvseState::Available;
     } else {
         /*
@@ -203,8 +177,6 @@ OcppMessage *ConnectorStatus::loop() {
         transaction = nullptr;
     }
 
-    txProcess.evaluateProcessSteps();
-
     if (transaction) { //begin exclusively transaction-related operations
             
         if (connectorPluggedSampler) {
@@ -238,15 +210,17 @@ OcppMessage *ConnectorStatus::loop() {
             }
         }
 
-        auto txEnable = txProcess.getState();
-
         /*
         * Check conditions for start or stop transaction
         */
 
-        if (txEnable == TxEnableState::Active) {
-            
-            if (transaction->isPreparing() && !getErrorCode()) {
+        if (!transaction->isRunning()) {
+            //start tx?
+
+            if (transaction->isActive() && transaction->isAuthorized() &&  //tx must be authorized
+                    (!connectorPluggedSampler || connectorPluggedSampler()) && //if applicable, connector must be plugged
+                    !getErrorCode() && //only start tx if charger is free of error conditions
+                    (!startTxReadyInput || startTxReadyInput())) { //if defined, user Input for allowing StartTx must be true
                 //start Transaction
 
                 AO_DBG_INFO("Session mngt: trigger StartTransaction");
@@ -281,15 +255,11 @@ OcppMessage *ConnectorStatus::loop() {
 
                 return new StartTransaction(model, transaction);
             }
-        } else if (transaction->isRunning()) {
-
-            if (transaction->isActive()) {
-                AO_DBG_DEBUG("Tx process not active");
-                transaction->endSession();
-                transaction->commit();
-            }
+        } else  {
+            //stop tx?
 
-            if (txEnable == TxEnableState::Inactive) {
+            if (!transaction->isActive() &&
+                    (!stopTxReadyInput || stopTxReadyInput())) {
                 //stop transaction
 
                 AO_DBG_INFO("Session mngt: trigger StopTransaction");
@@ -786,17 +756,6 @@ void ConnectorStatus::setAvailabilityVolatile(bool available) {
 
 void ConnectorStatus::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
     this->connectorPluggedSampler = connectorPlugged;
-    txProcess.addTrigger([this] () -> TxTrigger {
-        
-        //special case when StopTransactionOnEVSideDisconnect is false
-        if (stopTransactionOnEVSideDisconnect && !*stopTransactionOnEVSideDisconnect &&
-                transaction && transaction->isRunning()) {
-            //ignore connectorPluggedSampler while transaction is running
-            return TxTrigger::Active;
-        }
-
-        return connectorPluggedSampler() ? TxTrigger::Active : TxTrigger::Inactive;
-    });
 }
 
 void ConnectorStatus::setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
@@ -819,10 +778,14 @@ std::function<PollResult<bool>()> ConnectorStatus::getOnUnlockConnector() {
     return this->onUnlockConnector;
 }
 
-void ConnectorStatus::setConnectorLock(std::function<TxEnableState(TxTrigger)> onConnectorLockPollTx) {
-    this->onConnectorLockPollTx = onConnectorLockPollTx;
+void ConnectorStatus::setStartTxReadyInput(std::function<bool()> startTxReady) {
+    this->startTxReadyInput = startTxReady;
+}
+
+void ConnectorStatus::setStopTxReadyInput(std::function<bool()> stopTxReady) {
+    this->stopTxReadyInput = stopTxReady;
 }
 
-void ConnectorStatus::setTxBasedMeterUpdate(std::function<TxEnableState(TxTrigger)> onTxBasedMeterPollTx) {
-    this->onTxBasedMeterPollTx = onTxBasedMeterPollTx;
+void ConnectorStatus::setOccupiedInput(std::function<bool()> occupied) {
+    this->occupiedInput = occupied;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
index 39c3e54a..af48084f 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
@@ -1,13 +1,11 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONNECTORSTATUS_H
 #define CONNECTORSTATUS_H
 
 #include <ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionProcess.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
@@ -52,10 +50,9 @@ class ConnectorStatus {
 
     std::function<PollResult<bool>()> onUnlockConnector;
 
-    std::function<TxEnableState(TxTrigger)> onConnectorLockPollTx;
-    std::function<TxEnableState(TxTrigger)> onTxBasedMeterPollTx;
-
-    TransactionProcess txProcess;
+    std::function<bool()> startTxReadyInput; //the StartTx request will be delayed while this Input is false
+    std::function<bool()> stopTxReadyInput; //the StopTx request will be delayed while this Input is false
+    std::function<bool()> occupiedInput; //instead of Available, go into Preparing / Finishing state
 
     std::shared_ptr<Configuration<int>> connectionTimeOut; //in seconds
     std::shared_ptr<Configuration<bool>> stopTransactionOnInvalidId;
@@ -116,8 +113,9 @@ class ConnectorStatus {
     void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector);
     std::function<PollResult<bool>()> getOnUnlockConnector();
 
-    void setConnectorLock(std::function<TxEnableState(TxTrigger)> lockConnector);
-    void setTxBasedMeterUpdate(std::function<TxEnableState(TxTrigger)> updateTxBasedMeter);
+    void setStartTxReadyInput(std::function<bool()> startTxReady);
+    void setStopTxReadyInput(std::function<bool()> stopTxReady);
+    void setOccupiedInput(std::function<bool()> occupied);
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h
deleted file mode 100644
index 9a503718..00000000
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h
+++ /dev/null
@@ -1,32 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#ifndef TXPREREQUISITES_H
-#define TXPREREQUISITES_H
-
-namespace ArduinoOcpp {
-
-/*
- * Type definitions for extending the transaction initiation process
- */
-
-enum class TxPrecondition {
-    Active,
-    Inactive
-};
-
-enum class TxTrigger {
-    Active,
-    Inactive
-};
-
-enum class TxEnableState {
-    Active,
-    Inactive,
-    Pending
-};
-
-}
-
-#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
deleted file mode 100644
index bc997715..00000000
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.cpp
+++ /dev/null
@@ -1,89 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#include <ArduinoOcpp/Tasks/Transactions/TransactionProcess.h>
-
-#include <ArduinoOcpp/Debug.h>
-
-using namespace ArduinoOcpp;
-
-TransactionProcess::TransactionProcess(unsigned int connectorId) {
-
-}
-
-/*
- * Evaluate the preconditions and triggers. If all are Active, then execute the transaction enable sequence.
- * That is an ordered sequence of preparation steps which must be true before the transaction can start. When
- * the transaction is finished, disable the preparation steps in reversed order.
- * 
- * txEnable is the output variable. See getState() for getting the result.
- */
-void TransactionProcess::evaluateProcessSteps() {
-
-#if AO_DBG_LEVEL >= AO_DL_DEBUG
-    //print transitions to debug console
-    TxEnableState txEnableBefore = txEnable;
-#endif
-
-    //Check Tx preconditions: Tx is only possible if all of them are true; search for a false precondition
-    auto txPrecondition = TxPrecondition::Active;
-    for (auto cond : txPreconditions) {
-        if (cond() != TxPrecondition::Active) {
-            txPrecondition = TxPrecondition::Inactive;
-            break;
-        }
-    }
-
-    //Check Tx triggers: all of them need to be true to trigger a tx; prepare that search here
-    auto txTrigger = txTriggers.empty() ? TxTrigger::Inactive : TxTrigger::Active;
-    if (txPrecondition != TxPrecondition::Active) { //Only trigger a tx if the preconditions are met
-        txTrigger = TxTrigger::Inactive;
-    }
-
-    //Determine if
-    // - No trigger is active      -> activeTriggerExists = false, txTrigger = Inactive
-    // - All triggers are active   -> activeTriggerExists = true,  txTrigger = Active
-    // - Some are active, some not -> activeTriggerExists = true,  txTrigger = Inactive
-    activeTriggerExists = false;
-    for (auto trigger = txTriggers.begin(); trigger != txTriggers.end(); trigger++) {
-        auto result = trigger->operator()();
-        if (result == TxTrigger::Active) {
-            activeTriggerExists = true;
-        } else {
-            txTrigger = TxTrigger::Inactive;
-        }
-    }
-
-    //Also check if all devices on the charger are enabled for the Tx
-    if (txTrigger == TxTrigger::Active) { //Search for an unready device
-        txEnable = TxEnableState::Active;
-
-        for (auto step = txEnableSequence.rbegin(); step != txEnableSequence.rend(); step++) {
-            auto result = step->operator()(TxTrigger::Active);
-            if (result != TxEnableState::Active) {
-                txEnable = TxEnableState::Pending;
-                break;
-            }
-        }
-    } else { //Search for a device that is still enabled
-        txEnable = TxEnableState::Inactive;
-
-        for (auto step = txEnableSequence.begin(); step != txEnableSequence.end(); step++) {
-            auto result = step->operator()(TxTrigger::Inactive);
-            if (result != TxEnableState::Inactive) {
-                txEnable = TxEnableState::Pending;
-                break;
-            }
-        }
-    }
-
-#if AO_DBG_LEVEL >= AO_DL_DEBUG
-    if (txEnableBefore != txEnable) {
-        AO_DBG_DEBUG("Transition from %s to %s",
-                    txEnableBefore == TxEnableState::Active ? "Active" : txEnableBefore == TxEnableState::Inactive ? "Inactive" : "Pending",
-                    txEnable == TxEnableState::Active ? "Active" : txEnable == TxEnableState::Inactive ? "Inactive" : "Pending");
-    }
-#endif
-
-}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
deleted file mode 100644
index 187ec1bd..00000000
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionProcess.h
+++ /dev/null
@@ -1,44 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
-// MIT License
-
-#ifndef TRANSACTIONPROCESS_H
-#define TRANSACTIONPROCESS_H
-
-#include <ArduinoOcpp/Tasks/Transactions/TransactionPrerequisites.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-
-#include <vector>
-#include <functional>
-
-namespace ArduinoOcpp {
-
-class TransactionProcess {
-private:
-    
-    std::vector<std::function<TxPrecondition()>> txPreconditions;
-    std::vector<std::function<TxTrigger()>> txTriggers;
-    std::vector<std::function<TxEnableState(TxTrigger)>> txEnableSequence;
-
-    bool activeTriggerExists = false;
-    TxEnableState txEnable {TxEnableState::Inactive}; // = Result of Trigger and Enable Sequence
-    
-public:
-
-    TransactionProcess(unsigned int connectorId);
-
-    void addPrecondition(std::function<TxPrecondition()> fn) {txPreconditions.push_back(fn);}
-
-    void addTrigger(std::function<TxTrigger()> fn) {txTriggers.push_back(fn);}
-
-    void addEnableStep(std::function<TxEnableState(TxTrigger)> fn) {txEnableSequence.push_back(fn);}
-
-    void evaluateProcessSteps();
-
-    bool existsActiveTrigger() {return activeTriggerExists;}
-    TxEnableState getState() {return txEnable;}
-};
-
-}
-
-#endif
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index a645e367..90445ad4 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -46,23 +46,6 @@ ArduinoOcpp::PollResult<bool> adaptScl(enum OptionalBool v) {
     }
 }
 
-enum TxTrigger_t adaptScl(ArduinoOcpp::TxTrigger v) {
-    return v == ArduinoOcpp::TxTrigger::Active ? TxTrigger_t::TxTrg_Active : TxTrigger_t::TxTrg_Inactive;
-}
-
-ArduinoOcpp::TxEnableState adaptScl(enum TxEnableState_t v) {
-    if (v == TxEna_Pending) {
-        return ArduinoOcpp::TxEnableState::Pending;
-    } else if (v == TxEna_Active) {
-        return ArduinoOcpp::TxEnableState::Active;
-    } else if (v == TxEna_Inactive) {
-        return ArduinoOcpp::TxEnableState::Inactive;
-    } else {
-        AO_DBG_ERR("illegal argument");
-        return ArduinoOcpp::TxEnableState::Inactive;
-    }
-}
-
 std::function<bool()> adaptFn(InputBool fn) {
     return fn;
 }
@@ -143,22 +126,6 @@ std::function<ArduinoOcpp::PollResult<bool>()> adaptFn(unsigned int connectorId,
     return [fn, connectorId] () {return adaptScl(fn(connectorId));};
 }
 
-std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> adaptFn(TxStepInOut fn) {
-    if (!fn) return nullptr;
-    return [fn] (ArduinoOcpp::TxTrigger trigger) -> ArduinoOcpp::TxEnableState {
-        auto res = fn(adaptScl(trigger));
-        return adaptScl(res);
-    };
-}
-
-std::function<ArduinoOcpp::TxEnableState(ArduinoOcpp::TxTrigger)> adaptFn(unsigned int connectorId, TxStepInOut_m fn) {
-    if (!fn) return nullptr;
-    return [fn, connectorId] (ArduinoOcpp::TxTrigger trigger) -> ArduinoOcpp::TxEnableState {
-        auto res = fn(connectorId, adaptScl(trigger));
-        return adaptScl(res);
-    };
-}
-
 void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
     bootNotification(chargePointModel, chargePointVendor, adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
@@ -305,18 +272,25 @@ void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnloc
     setOnUnlockConnectorInOut(adaptFn(connectorId, onUnlockConnectorInOut), connectorId);
 }
 
-void ao_setConnectorLockInOut(TxStepInOut lockConnectorInOut) {
-    setConnectorLockInOut(adaptFn(lockConnectorInOut));
+void ao_setStartTxReadyInput(InputBool startTxReady) {
+    setStartTxReadyInput(adaptFn(startTxReady));
+}
+void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxReady) {
+    setStartTxReadyInput(adaptFn(connectorId, startTxReady), connectorId);
+}
+
+void ao_setStopTxReadyInput(InputBool stopTxReady) {
+    setStopTxReadyInput(adaptFn(stopTxReady));
 }
-void ao_setConnectorLockInOut_m(unsigned int connectorId, TxStepInOut_m lockConnectorInOut) {
-    setConnectorLockInOut(adaptFn(connectorId, lockConnectorInOut), connectorId);
+void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady) {
+    setStopTxReadyInput(adaptFn(connectorId, stopTxReady), connectorId);
 }
 
-void ao_setTxBasedMeterInOut(TxStepInOut txMeterInOut) {
-    setTxBasedMeterInOut(adaptFn(txMeterInOut));
+void ao_setOccupiedInput(InputBool occupied) {
+    setOccupiedInput(adaptFn(occupied));
 }
-void ao_setTxBasedMeterInOut_m(unsigned int connectorId, TxStepInOut_m txMeterInOut) {
-    setTxBasedMeterInOut(adaptFn(connectorId, txMeterInOut), connectorId);
+void ao_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied) {
+    setOccupiedInput(adaptFn(connectorId, occupied), connectorId);
 }
 
 bool ao_isOperative() {
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index be08f030..156d3b57 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -39,10 +39,6 @@ typedef void (*OutputFloat_m)(unsigned int connectorId, float limit);
 enum OptionalBool {OptionalTrue, OptionalFalse, OptionalNone};
 typedef enum OptionalBool (*PollBool)();
 typedef enum OptionalBool (*PollBool_m)(unsigned int connectorId);
-enum TxTrigger_t {TxTrg_Active, TxTrg_Inactive};
-enum TxEnableState_t {TxEna_Active, TxEna_Inactive, TxEna_Pending};
-typedef enum TxEnableState_t (*TxStepInOut)(enum TxTrigger_t triggerIn);
-typedef enum TxEnableState_t (*TxStepInOut_m)(unsigned int connectorId, enum TxTrigger_t triggerIn);
 
 
 #ifdef __cplusplus
@@ -138,11 +134,14 @@ void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterVal
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
 void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);
 
-void ao_setConnectorLockInOut(TxStepInOut lockConnectorInOut);
-void ao_setConnectorLockInOut_m(unsigned int connectorId, TxStepInOut_m lockConnectorInOut);
+void ao_setStartTxReadyInput(InputBool startTxReady);
+void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxReady);
 
-void ao_setTxBasedMeterInOut(TxStepInOut txMeterInOut);
-void ao_setTxBasedMeterInOut_m(unsigned int connectorId, TxStepInOut_m txMeterInOut);
+void ao_setStartTxReadyInput(InputBool startTxReady);
+void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxReady);
+
+void ao_setOccupiedInput(InputBool occupied);
+void ao_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied);
 
 /*
  * Access further information about the internal state of the library
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index c0c87f6a..ff501cb9 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -2,6 +2,7 @@
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
@@ -171,71 +172,6 @@ TEST_CASE( "Charging sessions" ) {
         loop();
     }
 
-    SECTION("Advanced session management") {
-        bool connectorPlugged = false;
-        setConnectorPluggedInput([&connectorPlugged] () {return connectorPlugged;});
-
-        TxEnableState meterState = TxEnableState::Inactive;
-        setTxBasedMeterInOut([&meterState] (TxTrigger) {return meterState;});
-
-        TxEnableState lockState = TxEnableState::Inactive;
-        setConnectorLockInOut([&lockState] (TxTrigger) {return lockState;});
-
-        beginTransaction("mIdTag");
-        loop();
-        REQUIRE(!ocppPermitsCharge());
-
-        connectorPlugged = true;
-        loop();
-        REQUIRE(!ocppPermitsCharge());
-        
-        meterState = TxEnableState::Active;
-        loop();
-        REQUIRE(!ocppPermitsCharge());
-        
-        meterState = TxEnableState::Pending;
-        lockState = TxEnableState::Active;
-        loop();
-        REQUIRE(!ocppPermitsCharge());
-        
-        meterState = TxEnableState::Active;
-        lockState = TxEnableState::Pending;
-        loop();
-        REQUIRE(!ocppPermitsCharge());
-
-        checkedSN[1] = false;
-        expectedSN[1] = "Charging";
-        
-        lockState = TxEnableState::Active;
-        loop();
-        REQUIRE(ocppPermitsCharge());
-        REQUIRE(checkedSN[1]);
-
-        checkedSN[1] = false;
-        expectedSN[1] = "SuspendedEVSE";
-
-        lockState = TxEnableState::Pending;
-        loop();
-        REQUIRE(!ocppPermitsCharge());
-        REQUIRE(!getTransactionIdTag());
-        REQUIRE(checkedSN[1]);
-
-        checkedSN[1] = false;
-        expectedSN[1] = "Finishing";
-
-        meterState = TxEnableState::Inactive;
-        lockState = TxEnableState::Inactive;
-        loop();
-        REQUIRE(checkedSN[1]);
-
-        checkedSN[1] = false;
-        expectedSN[1] = "Available";
-
-        connectorPlugged = false;
-        loop();
-        REQUIRE(checkedSN[1]);
-    }
-
     OCPP_deinitialize();
 
 }
\ No newline at end of file
diff --git a/tests/TransactionProcess.cpp b/tests/TransactionProcess.cpp
deleted file mode 100644
index 0f0726f4..00000000
--- a/tests/TransactionProcess.cpp
+++ /dev/null
@@ -1,185 +0,0 @@
-#include <ArduinoOcpp/Tasks/Transactions/TransactionProcess.h>
-#include "./catch2/catch.hpp"
-#include "./helpers/testHelper.h"
-
-#include <array>
-
-using namespace ArduinoOcpp;
-
-TEST_CASE( "Transaction process - trivial" ) {
-
-    TransactionProcess txProcess {1};
-
-    SECTION("Trivial transaction process"){
-        txProcess.evaluateProcessSteps();
-        REQUIRE( !txProcess.existsActiveTrigger() );
-        REQUIRE( txProcess.getState() == TxEnableState::Inactive );
-    }
-
-    SECTION("Trivial transaction process with outputs"){
-        bool notified = false;
-        txProcess.addEnableStep([&notified] (TxTrigger trigger) -> TxEnableState {
-            REQUIRE( trigger == TxTrigger::Inactive );
-            notified = true;
-            return TxEnableState::Inactive;
-        });
-        txProcess.evaluateProcessSteps();
-        REQUIRE( notified );
-        REQUIRE( txProcess.getState() == TxEnableState::Inactive );
-    }
-}
-
-TEST_CASE("Transaction process - inputs") {
-
-    TransactionProcess txProcess {1};
-
-    TxPrecondition precondition = TxPrecondition::Active;
-    txProcess.addPrecondition([&precondition] () {
-        return precondition;
-    });
-
-    TxTrigger trigger = TxTrigger::Active;
-    txProcess.addTrigger([&trigger] () {
-        return trigger;
-    });
-
-    TxEnableState enable = TxEnableState::Active;
-    TxTrigger checkTrigger = TxTrigger::Active;
-    txProcess.addEnableStep([&enable, &checkTrigger] (TxTrigger input) {
-        REQUIRE(checkTrigger == input);
-        return enable;
-    });
-
-    SECTION("All active") {
-        txProcess.evaluateProcessSteps();
-        REQUIRE(txProcess.getState() == TxEnableState::Active);
-    }
-
-    SECTION("Precondition") {
-        precondition = TxPrecondition::Inactive;
-        checkTrigger = TxTrigger::Inactive;
-        txProcess.evaluateProcessSteps();
-        REQUIRE( txProcess.getState() != TxEnableState::Active );
-    }
-
-    SECTION("Trigger") {
-        trigger = TxTrigger::Inactive;
-        checkTrigger = TxTrigger::Inactive;
-        txProcess.evaluateProcessSteps();
-        REQUIRE( txProcess.getState() != TxEnableState::Active );
-    }
-
-    SECTION("Output enable") {
-        enable = TxEnableState::Inactive;
-        txProcess.evaluateProcessSteps();
-        REQUIRE( txProcess.getState() == TxEnableState::Pending );
-
-        enable = TxEnableState::Pending;
-        txProcess.evaluateProcessSteps();
-        REQUIRE( txProcess.getState() == TxEnableState::Pending );
-    }
-}
-
-TEST_CASE("Transaction process - execution order") {
-
-    TransactionProcess txProcess {1};
-
-    std::array<TxPrecondition, 2> preconditions {TxPrecondition::Active, TxPrecondition::Active};
-    for (unsigned int i = 0; i < preconditions.size(); i++) {
-        txProcess.addPrecondition([&preconditions, i] () {
-            return preconditions[i];
-        });
-    }
-    
-    std::array<TxTrigger, 2> triggers {TxTrigger::Active, TxTrigger::Active};
-    for (unsigned int i = 0; i < triggers.size(); i++) {
-        txProcess.addTrigger([&triggers, i] () {
-            return triggers[i];
-        });
-    }
-    
-    std::array<TxEnableState, 2> enableSteps {TxEnableState::Active, TxEnableState::Active};
-    std::array<int, 2> checkSeq {-1, -1};
-    int checkCount = 0;
-    for (unsigned int i = 0; i < enableSteps.size(); i++) {
-        txProcess.addEnableStep([&enableSteps, &checkSeq, &checkCount, i] (TxTrigger) {
-            checkSeq[i] = checkCount;
-            checkCount++;
-            return enableSteps[i];
-        });
-    }
-    
-    SECTION("Precondition"){
-        preconditions[0] = TxPrecondition::Inactive;
-        txProcess.evaluateProcessSteps();
-        REQUIRE( txProcess.getState() != TxEnableState::Active );
-
-        preconditions[0] = TxPrecondition::Active;
-        preconditions[1] = TxPrecondition::Inactive;
-        txProcess.evaluateProcessSteps();
-        REQUIRE( txProcess.getState() != TxEnableState::Active );
-    }
-
-    SECTION("Trigger") {
-        triggers[0] = TxTrigger::Inactive;
-        txProcess.evaluateProcessSteps();
-        REQUIRE( txProcess.getState() != TxEnableState::Active );
-        REQUIRE( txProcess.existsActiveTrigger());
-
-        triggers[0] = TxTrigger::Active;
-        triggers[1] = TxTrigger::Inactive;
-        txProcess.evaluateProcessSteps();
-        REQUIRE( txProcess.getState() != TxEnableState::Active );
-        REQUIRE( txProcess.existsActiveTrigger());
-    }
-
-    SECTION("Output enable - all active"){
-        txProcess.evaluateProcessSteps();
-        REQUIRE(checkSeq[0] == 1);
-        REQUIRE(checkSeq[1] == 0);
-    }
-
-    SECTION("Output enable - active pending"){
-        enableSteps[1] = TxEnableState::Pending;
-        txProcess.evaluateProcessSteps();
-        REQUIRE(checkSeq[0] == -1);
-        REQUIRE(checkSeq[1] == 0);
-    }
-
-    SECTION("Output enable - inactive"){
-        preconditions[0] = TxPrecondition::Inactive;
-        enableSteps[0] = TxEnableState::Inactive;
-        txProcess.evaluateProcessSteps();
-        REQUIRE(checkSeq[0] == 0);
-        REQUIRE(checkSeq[1] == 1);
-    }
-
-    SECTION("Output enable - inactive pending"){
-        preconditions[0] = TxPrecondition::Inactive;
-        enableSteps[0] = TxEnableState::Pending;
-        txProcess.evaluateProcessSteps();
-        REQUIRE(checkSeq[0] == 0);
-        REQUIRE(checkSeq[1] == -1);
-    }
-}
-
-TEST_CASE("Transaction process - begin new transaction") {
-    TransactionProcess txProcess {1};
-
-    txProcess.addPrecondition([] () {
-        return TxPrecondition::Active;
-    });
-
-    TxTrigger trigger = TxTrigger::Active;
-    txProcess.addTrigger([&trigger] () {
-        return trigger;
-    });
-
-    TxEnableState enable = TxEnableState::Active;
-    TxTrigger checkTrigger = TxTrigger::Active;
-    txProcess.addEnableStep([&enable, &checkTrigger] (TxTrigger input) {
-        checkTrigger = input;
-        return enable;
-    });
-
-}
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 61e76db9..e096374f 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -2,6 +2,7 @@
 #include <ArduinoOcpp/Core/OcppSocket.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>

From 57eb8f17ba73f9be8a75bd7f8c71d2702c6cd769 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 21 May 2023 21:38:25 +0200
Subject: [PATCH 242/549] add Configuration deiniter

---
 src/ArduinoOcpp.cpp                    | 2 ++
 src/ArduinoOcpp/Core/Configuration.cpp | 6 ++++++
 src/ArduinoOcpp/Core/Configuration.h   | 2 ++
 3 files changed, 10 insertions(+)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index aff1916e..5ccf4335 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -187,6 +187,8 @@ void OCPP_deinitialize() {
 
     fileSystemOpt = FilesystemOpt();
     voltage_eff = 230.f;
+
+    configuration_deinit();
 }
 
 void OCPP_loop() {
diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 4cf645b9..4ab64999 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -209,6 +209,12 @@ bool configuration_init(std::shared_ptr<FilesystemAdapter> _filesystem) {
     return success;
 }
 
+void configuration_deinit() {
+    configurationContainers.clear();
+    filesystem.reset();
+    configuration_inited = false;
+}
+
 bool configuration_save() {
     bool success = true;
 
diff --git a/src/ArduinoOcpp/Core/Configuration.h b/src/ArduinoOcpp/Core/Configuration.h
index 0b62ff62..9e421c3e 100644
--- a/src/ArduinoOcpp/Core/Configuration.h
+++ b/src/ArduinoOcpp/Core/Configuration.h
@@ -34,6 +34,8 @@ namespace Ocpp16 {
 }
 
 bool configuration_init(std::shared_ptr<FilesystemAdapter> filesytem);
+void configuration_deinit();
+
 bool configuration_save();
 
 } //end namespace ArduinoOcpp

From 5963a97d4dc7f9fdb50e73a7050f3009b62f5d4b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 21 May 2023 21:53:42 +0200
Subject: [PATCH 243/549] add more test cases

---
 src/ArduinoOcpp/Core/FilesystemUtils.cpp |   3 +-
 tests/ConfigurationBehavior.cpp          | 194 +++++++++++++++++++++++
 2 files changed, 196 insertions(+), 1 deletion(-)
 create mode 100644 tests/ConfigurationBehavior.cpp

diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
index 4a99b882..f4ca6605 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -117,7 +117,8 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
 
 bool FilesystemUtils::remove_all(std::shared_ptr<FilesystemAdapter> filesystem, const char *fpath_prefix) {
     return filesystem->ftw_root([filesystem, fpath_prefix] (const char *fpath) {
-        if (!strncmp(fpath, fpath_prefix, strlen(fpath_prefix))) {
+        if (!strncmp(fpath, fpath_prefix, strlen(fpath_prefix)) &&
+                fpath[0] != '.') {
 
             char fn [AO_MAX_PATH_SIZE] = {'\0'};
             auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "%s", fpath);
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
new file mode 100644
index 00000000..c4243808
--- /dev/null
+++ b/tests/ConfigurationBehavior.cpp
@@ -0,0 +1,194 @@
+#include <ArduinoOcpp.h>
+#include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
+#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+using namespace ArduinoOcpp;
+
+class CustomStartTransaction : public OcppMessage {
+private:
+    const char *status;
+public:
+    CustomStartTransaction(const char *status) : status(status) { };
+    const char *getOcppOperationType() override {return "StartTransaction";}
+    void processReq(JsonObject payload) override {
+        //ignore payload - result is determined at construction time
+    }
+    std::unique_ptr<DynamicJsonDocument> createConf() override {
+        auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2) + JSON_OBJECT_SIZE(1)));
+        auto payload = res->to<JsonObject>();
+        payload["idTagInfo"]["status"] = status;
+        payload["transactionId"] = 1000;
+        return res;
+    }
+};
+
+TEST_CASE( "Configuration Behavior" ) {
+
+    //clean state
+    auto filesystem = makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
+    AO_DBG_DEBUG("remove all");
+    FilesystemUtils::remove_all(filesystem, "");
+
+    //initialize OcppEngine with dummy socket
+    OcppEchoSocket echoSocket;
+    OCPP_initialize(echoSocket, ChargerCredentials("test-runner1234"));
+
+    auto engine = getOcppEngine();
+    auto& checkMsg = engine->getOperationDeserializer();
+
+    auto connector = engine->getOcppModel().getConnectorStatus(1);
+
+    ao_set_timer(custom_timer_cb);
+
+    loop();
+
+    SECTION("StopTransactionOnEVSideDisconnect") {
+        setConnectorPluggedInput([] () {return true;});
+        startTransaction("mIdTag");
+        loop();
+
+        auto config = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true);
+
+        SECTION("set true") {
+            *config = true;
+
+            setConnectorPluggedInput([] () {return false;});
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+        }
+
+        SECTION("set false") {
+            *config = false;
+
+            setConnectorPluggedInput([] () {return false;});
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::SuspendedEV);
+
+            endTransaction();
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+        }
+    }
+
+    SECTION("StopTransactionOnInvalidId") {
+        auto config = declareConfiguration<bool>("StopTransactionOnInvalidId", true);
+
+        checkMsg.registerOcppOperation("StartTransaction", [] () {return new CustomStartTransaction("Invalid");});
+
+        SECTION("set true") {
+            *config = true;
+
+            beginTransaction_authorized("mIdTag");
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+        }
+
+        SECTION("set false") {
+            *config = false;
+
+            beginTransaction_authorized("mIdTag");
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::SuspendedEVSE);
+
+            endTransaction();
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+        }
+    }
+
+    SECTION("AllowOfflineTxForUnknownId") {
+        auto config = declareConfiguration<bool>("AllowOfflineTxForUnknownId", true);
+        auto authorizationTimeout = ArduinoOcpp::declareConfiguration<int>("AO_AuthorizationTimeout", 1);
+        *authorizationTimeout = 1; //try normal Authorize for 1s, then enter offline mode
+
+        echoSocket.setConnected(false); //connection loss
+
+        SECTION("set true") {
+            *config = true;
+
+            beginTransaction("mIdTag");
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Charging);
+
+            endTransaction();
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+        }
+
+        SECTION("set false") {
+            *config = false;
+
+            beginTransaction("mIdTag");
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Preparing);
+
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+        }
+
+        endTransaction();
+        echoSocket.setConnected(true);
+    }
+
+    SECTION("LocalPreAuthorize") {
+        auto config = declareConfiguration<bool>("LocalPreAuthorize", true);
+        auto authorizationTimeout = ArduinoOcpp::declareConfiguration<int>("AO_AuthorizationTimeout", 20);
+        *authorizationTimeout = 300; //try normal Authorize for 5 minutes
+
+        auto localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", true, CONFIGURATION_FN, true, true, true, false);
+        *localAuthorizeOffline = true;
+        auto localAuthListEnabled = declareConfiguration<bool>("LocalAuthListEnabled", true, CONFIGURATION_FN, true, true, true, false);
+        *localAuthListEnabled = true;
+
+        //define local auth list with entry local-idtag
+        std::string localListMsg = "[2,\"testmsg-01\",\"SendLocalList\",{\"listVersion\":1,\"localAuthorizationList\":[{\"idTag\":\"local-idtag\",\"idTagInfo\":{\"status\":\"Accepted\"}}],\"updateType\":\"Full\"}]";
+        echoSocket.sendTXT(localListMsg);
+        loop();
+
+        echoSocket.setConnected(false); //connection loss
+
+        SECTION("set true - accepted idtag") {
+            *config = true;
+
+            beginTransaction("local-idtag");
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Charging);
+        }
+
+        SECTION("set false") {
+            *config = false;
+
+            beginTransaction("local-idtag");
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Preparing);
+
+            echoSocket.setConnected(true);
+            mtime += 20000; //Authorize will be retried after a few seconds
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Charging);
+        }
+
+        endTransaction();
+        echoSocket.setConnected(true);
+    }
+
+    OCPP_deinitialize();
+}

From d4d40d444ca74af36829a631f40f74236fc947a2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 22 May 2023 09:23:48 +0200
Subject: [PATCH 244/549] rename ChargePointStatus and ConnectorStatus

---
 CMakeLists.txt                                |  4 +-
 src/ArduinoOcpp.cpp                           | 52 ++++++++--------
 src/ArduinoOcpp/Core/OcppModel.cpp            | 12 ++--
 src/ArduinoOcpp/Core/OcppModel.h              | 12 ++--
 src/ArduinoOcpp/MessagesV16/Authorize.cpp     |  2 +-
 .../MessagesV16/ChangeAvailability.cpp        |  4 +-
 .../MessagesV16/GetCompositeSchedule.cpp      |  4 +-
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp   |  2 +-
 .../MessagesV16/RemoteStartTransaction.cpp    |  8 +--
 .../MessagesV16/RemoteStopTransaction.cpp     |  4 +-
 src/ArduinoOcpp/MessagesV16/ReserveNow.cpp    | 10 ++--
 src/ArduinoOcpp/MessagesV16/Reset.cpp         |  4 +-
 .../MessagesV16/StartTransaction.cpp          |  2 +-
 .../MessagesV16/StatusNotification.cpp        |  2 +-
 .../MessagesV16/StatusNotification.h          |  2 +-
 .../MessagesV16/StopTransaction.cpp           |  2 +-
 .../MessagesV16/TriggerMessage.cpp            |  4 +-
 .../MessagesV16/UnlockConnector.cpp           |  4 +-
 .../Authorization/AuthorizationService.cpp    |  4 +-
 src/ArduinoOcpp/Tasks/Boot/BootService.cpp    |  2 +-
 .../ChargeControlService.cpp}                 | 24 ++++----
 .../ChargeControlService.h}                   | 16 ++---
 .../Connector.cpp}                            | 60 +++++++++----------
 .../Connector.h}                              | 10 ++--
 .../OcppEvseState.h                           |  0
 .../FirmwareManagement/FirmwareService.cpp    |  6 +-
 .../Metering/ConnectorMeterValuesRecorder.cpp | 16 ++---
 .../Tasks/Reservation/ReservationService.cpp  |  8 +--
 .../SmartCharging/SmartChargingService.cpp    |  6 +-
 tests/ChargingSessions.cpp                    |  2 +-
 tests/ConfigurationBehavior.cpp               |  4 +-
 tests/TransactionSafety.cpp                   |  2 +-
 32 files changed, 147 insertions(+), 147 deletions(-)
 rename src/ArduinoOcpp/Tasks/{ChargePointStatus/ChargePointStatusService.cpp => ChargeControl/ChargeControlService.cpp} (89%)
 rename src/ArduinoOcpp/Tasks/{ChargePointStatus/ChargePointStatusService.h => ChargeControl/ChargeControlService.h} (76%)
 rename src/ArduinoOcpp/Tasks/{ChargePointStatus/ConnectorStatus.cpp => ChargeControl/Connector.cpp} (92%)
 rename src/ArduinoOcpp/Tasks/{ChargePointStatus/ConnectorStatus.h => ChargeControl/Connector.h} (95%)
 rename src/ArduinoOcpp/Tasks/{ChargePointStatus => ChargeControl}/OcppEvseState.h (100%)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 32ba9793..d9cf11cf 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -56,8 +56,8 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
     src/ArduinoOcpp/Tasks/Boot/BootService.cpp
-    src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
-    src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+    src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
+    src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
     src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
     src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
     src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 5ccf4335..2dc297ae 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -8,7 +8,7 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
@@ -140,8 +140,8 @@ void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredent
         new TransactionStore(AO_NUMCONNECTORS, filesystem)));
     model.setBootService(std::unique_ptr<BootService>(
         new BootService(*ocppEngine)));
-    model.setChargePointStatusService(std::unique_ptr<ChargePointStatusService>(
-        new ChargePointStatusService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
+    model.setChargeControlService(std::unique_ptr<ChargeControlService>(
+        new ChargeControlService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
         new HeartbeatService(*ocppEngine)));
     model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
@@ -166,8 +166,8 @@ void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredent
 #endif
 
 #if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
-    if (!model.getChargePointStatusService()->getExecuteReset())
-        model.getChargePointStatusService()->setExecuteReset(makeDefaultResetFn());
+    if (!model.getChargeControlService()->getExecuteReset())
+        model.getChargeControlService()->setExecuteReset(makeDefaultResetFn());
 #endif
 
     model.getBootService()->setChargePointCredentials(bootNotificationCredentials);
@@ -277,7 +277,7 @@ bool beginTransaction(const char *idTag, unsigned int connectorId) {
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -296,7 +296,7 @@ bool beginTransaction_authorized(const char *idTag, const char *parentIdTag, uns
         AO_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -310,7 +310,7 @@ bool endTransaction(const char *reason, unsigned int connectorId) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -325,7 +325,7 @@ bool isTransactionRunning(unsigned int connectorId) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -338,7 +338,7 @@ bool ocppPermitsCharge(unsigned int connectorId) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -351,7 +351,7 @@ void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int c
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -432,7 +432,7 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -445,7 +445,7 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -458,7 +458,7 @@ void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned in
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -518,7 +518,7 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
         return;
     }
 
-    if (auto csService = ocppEngine->getOcppModel().getChargePointStatusService()) {
+    if (auto csService = ocppEngine->getOcppModel().getChargeControlService()) {
         csService->setPreReset(onResetNotify);
     }
 }
@@ -529,7 +529,7 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute) {
         return;
     }
 
-    if (auto csService = ocppEngine->getOcppModel().getChargePointStatusService()) {
+    if (auto csService = ocppEngine->getOcppModel().getChargeControlService()) {
         csService->setExecuteReset(onResetExecute);
     }
 }
@@ -539,7 +539,7 @@ void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnect
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -552,7 +552,7 @@ void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int conne
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -565,7 +565,7 @@ void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connect
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -578,7 +578,7 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId)
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -592,8 +592,8 @@ bool isOperative(unsigned int connectorId) {
         return true; //assume "true" as default state
     }
     auto& model = ocppEngine->getOcppModel();
-    auto chargePoint = model.getConnectorStatus(OCPP_ID_OF_CP);
-    auto connector = model.getConnectorStatus(connectorId);
+    auto chargePoint = model.getConnector(OCPP_ID_OF_CP);
+    auto connector = model.getConnector(connectorId);
     if (!chargePoint || !connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return true; //assume "true" as default state
@@ -607,7 +607,7 @@ int getTransactionId(unsigned int connectorId) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return -1;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return -1;
@@ -620,7 +620,7 @@ const char *getTransactionIdTag(unsigned int connectorId) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return nullptr;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(connectorId);
+    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return nullptr;
@@ -731,7 +731,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    auto connector = ocppEngine->getOcppModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -789,7 +789,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnectorStatus(OCPP_ID_OF_CONNECTOR);
+    auto connector = ocppEngine->getOcppModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/OcppModel.cpp
index 9b8ce474..c4db9477 100644
--- a/src/ArduinoOcpp/Core/OcppModel.cpp
+++ b/src/ArduinoOcpp/Core/OcppModel.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
@@ -73,18 +73,18 @@ SmartChargingService* OcppModel::getSmartChargingService() const {
     return smartChargingService.get();
 }
 
-void OcppModel::setChargePointStatusService(std::unique_ptr<ChargePointStatusService> cpss){
+void OcppModel::setChargeControlService(std::unique_ptr<ChargeControlService> cpss){
     chargePointStatusService = std::move(cpss);
 }
 
-ChargePointStatusService *OcppModel::getChargePointStatusService() const {
+ChargeControlService *OcppModel::getChargeControlService() const {
     return chargePointStatusService.get();
 }
 
-ConnectorStatus *OcppModel::getConnectorStatus(int connectorId) const {
-    if (getChargePointStatusService() == nullptr) return nullptr;
+Connector *OcppModel::getConnector(int connectorId) const {
+    if (getChargeControlService() == nullptr) return nullptr;
 
-    auto result = getChargePointStatusService()->getConnector(connectorId);
+    auto result = getChargeControlService()->getConnector(connectorId);
     if (result == nullptr) {
         AO_DBG_ERR("Cannot fetch connector with given connectorId. Return nullptr");
         //no error catch 
diff --git a/src/ArduinoOcpp/Core/OcppModel.h b/src/ArduinoOcpp/Core/OcppModel.h
index c37d8bd8..6420c894 100644
--- a/src/ArduinoOcpp/Core/OcppModel.h
+++ b/src/ArduinoOcpp/Core/OcppModel.h
@@ -13,8 +13,8 @@ namespace ArduinoOcpp {
 
 class TransactionStore;
 class SmartChargingService;
-class ChargePointStatusService;
-class ConnectorStatus;
+class ChargeControlService;
+class Connector;
 class MeteringService;
 class FirmwareService;
 class DiagnosticsService;
@@ -27,7 +27,7 @@ class OcppModel {
 private:
     std::unique_ptr<TransactionStore> transactionStore;
     std::unique_ptr<SmartChargingService> smartChargingService;
-    std::unique_ptr<ChargePointStatusService> chargePointStatusService;
+    std::unique_ptr<ChargeControlService> chargePointStatusService;
     std::unique_ptr<MeteringService> meteringService;
     std::unique_ptr<FirmwareService> firmwareService;
     std::unique_ptr<DiagnosticsService> diagnosticsService;
@@ -55,9 +55,9 @@ class OcppModel {
     void setSmartChargingService(std::unique_ptr<SmartChargingService> scs);
     SmartChargingService* getSmartChargingService() const;
 
-    void setChargePointStatusService(std::unique_ptr<ChargePointStatusService> cpss);
-    ChargePointStatusService *getChargePointStatusService() const;
-    ConnectorStatus *getConnectorStatus(int connectorId) const;
+    void setChargeControlService(std::unique_ptr<ChargeControlService> cpss);
+    ChargeControlService *getChargeControlService() const;
+    Connector *getConnector(int connectorId) const;
 
     void setMeteringSerivce(std::unique_ptr<MeteringService> meteringService);
     MeteringService* getMeteringService() const;
diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.cpp b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
index 7dcb593b..4c5ca1aa 100644
--- a/src/ArduinoOcpp/MessagesV16/Authorize.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/MessagesV16/Authorize.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
index 69b6298c..68d0e12d 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 
 #include <functional>
 
@@ -20,7 +20,7 @@ const char* ChangeAvailability::getOcppOperationType(){
 
 void ChangeAvailability::processReq(JsonObject payload) {
     int connectorId = payload["connectorId"] | -1;
-    auto cpStatus = context.getChargePointStatusService();
+    auto cpStatus = context.getChargeControlService();
     if (!cpStatus) {
         return;
     }
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
index 043c7ec5..e39a94d6 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -34,7 +34,7 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
         errorCode = "PropertyConstraintViolation";
     }
 
-    if (auto cpService = context.getChargePointStatusService()) {
+    if (auto cpService = context.getChargeControlService()) {
         if (connectorId >= cpService->getNumConnectors()) {
             errorCode = "PropertyConstraintViolation";
         }
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index e3e8f462..5f77a362 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
index e3eb3e5c..0bdf1542 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
@@ -6,7 +6,7 @@
 #include <ArduinoOcpp/MessagesV16/RemoteStartTransaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -55,7 +55,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
     bool canStartTransaction = false;
     if (connectorId >= 1) {
         //connectorId specified for given connector, try to start Transaction here
-        if (auto connector = context.getConnectorStatus(connectorId)){
+        if (auto connector = context.getConnector(connectorId)){
             if (connector->getTransactionId() < 0 &&
                         connector->getAvailability() == AVAILABILITY_OPERATIVE &&
                         connector->getSessionIdTag() == nullptr) {
@@ -64,7 +64,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         }
     } else {
         //connectorId not specified. Find free connector
-        if (auto cpStatusService = context.getChargePointStatusService()) {
+        if (auto cpStatusService = context.getChargeControlService()) {
             for (int i = 1; i < cpStatusService->getNumConnectors(); i++) {
                 auto connIter = cpStatusService->getConnector(i);
                 if (connIter->getTransactionId() < 0 && 
@@ -97,7 +97,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
             }
         }
 
-        if (auto connector = context.getConnectorStatus(connectorId)) {
+        if (auto connector = context.getConnector(connectorId)) {
             connector->beginTransaction(idTag);
         }
 
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
index 18cc7b6f..32737b72 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/RemoteStopTransaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 
 using ArduinoOcpp::Ocpp16::RemoteStopTransaction;
 
@@ -26,7 +26,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
     
     bool canStopTransaction = false;
 
-    if (auto cpStatusService = context.getChargePointStatusService()) {
+    if (auto cpStatusService = context.getChargeControlService()) {
         for (int i = 0; i < cpStatusService->getNumConnectors(); i++) {
             auto connIter = cpStatusService->getConnector(i);
             if (connIter->getTransactionId() == transactionId) {
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
index a1429312..906f28a8 100644
--- a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/MessagesV16/ReserveNow.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Platform.h>
 
 using ArduinoOcpp::Ocpp16::ReserveNow;
@@ -43,10 +43,10 @@ void ReserveNow::processReq(JsonObject payload) {
     int connectorId = payload["connectorId"];
 
     if (context.getReservationService() &&
-                context.getChargePointStatusService() &&
-                context.getChargePointStatusService()->getConnector(0)) {
+                context.getChargeControlService() &&
+                context.getChargeControlService()->getConnector(0)) {
         auto rService = context.getReservationService();
-        auto cpService = context.getChargePointStatusService();
+        auto cpService = context.getChargeControlService();
         auto chargePoint = cpService->getConnector(0);
 
         if (connectorId >= cpService->getNumConnectors()) {
@@ -66,7 +66,7 @@ void ReserveNow::processReq(JsonObject payload) {
             return;
         }
 
-        ConnectorStatus *connector = nullptr;
+        Connector *connector = nullptr;
         
         if (connectorId > 0) {
             connector = cpService->getConnector(connectorId);
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.cpp b/src/ArduinoOcpp/MessagesV16/Reset.cpp
index 98f6b1f3..628e1f38 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Reset.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/Reset.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 
 using ArduinoOcpp::Ocpp16::Reset;
 
@@ -23,7 +23,7 @@ void Reset::processReq(JsonObject payload) {
      */
     bool isHard = !strcmp(payload["type"] | "undefined", "Hard");
 
-    if (auto cpsService = context.getChargePointStatusService()) {
+    if (auto cpsService = context.getChargeControlService()) {
         if (!cpsService->getExecuteReset()) {
             AO_DBG_ERR("No reset handler set. Abort operation");
             (void)0;
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 88eb64d8..e945cadb 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -6,7 +6,7 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OperationStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index 144ab2c0..6251e425 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Debug.h>
 
 #include <string.h>
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.h b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
index 1ec9916d..e89ec222 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
@@ -7,7 +7,7 @@
 
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/OcppTime.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 256cf810..b242425d 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -6,7 +6,7 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OperationStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
index d3ce8ad2..0cb26ec8 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/TriggerMessage.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
@@ -44,7 +44,7 @@ void TriggerMessage::processReq(JsonObject payload) {
             }
         }
     } else if (!strcmp(requestedMessage, "StatusNotification")) {
-        if (auto cpsService = context.getChargePointStatusService()) {
+        if (auto cpsService = context.getChargeControlService()) {
             unsigned int cIdRangeBegin = 0, cIdRangeEnd = 0;
             if (connectorId < 0) {
                 cIdRangeEnd = cpsService->getNumConnectors();
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
index 7f1dd015..08cf8f11 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/UnlockConnector.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::UnlockConnector;
@@ -23,7 +23,7 @@ void UnlockConnector::processReq(JsonObject payload) {
     
     auto connectorId = payload["connectorId"] | -1;
 
-    auto connector = context.getConnectorStatus(connectorId);
+    auto connector = context.getConnector(connectorId);
 
     if (!connector) {
         err = true;
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index e33140de..03ee04ab 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
@@ -176,7 +176,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
         //send error code "LocalListConflict" to server
 
         OcppEvseState cpStatus = OcppEvseState::NOT_SET;
-        if (auto cp = context.getOcppModel().getConnectorStatus(0)) {
+        if (auto cp = context.getOcppModel().getConnector(0)) {
             cpStatus = cp->inferenceStatus();
         }
 
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
index e2f1c1c1..8bfa83bd 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
@@ -8,7 +8,7 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
similarity index 89%
rename from src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
rename to src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
index 05d57626..376f7023 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
@@ -30,11 +30,11 @@
 
 using namespace ArduinoOcpp;
 
-ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
+ChargeControlService::ChargeControlService(OcppEngine& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
       : context(context) {
 
     for (unsigned int i = 0; i < numConn; i++) {
-        connectors.push_back(std::unique_ptr<ConnectorStatus>(new ConnectorStatus(context, i)));
+        connectors.push_back(std::unique_ptr<Connector>(new Connector(context, i)));
     }
     
     std::shared_ptr<Configuration<int>> numberOfConnectors =
@@ -102,11 +102,11 @@ ChargePointStatusService::ChargePointStatusService(OcppEngine& context, unsigned
         return new Ocpp16::StopTransaction(context.getOcppModel(), nullptr);});
 }
 
-ChargePointStatusService::~ChargePointStatusService() {
+ChargeControlService::~ChargeControlService() {
 
 }
 
-void ChargePointStatusService::loop() {
+void ChargeControlService::loop() {
     for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
         auto transactionMsg = (*connector)->loop();
         if (transactionMsg != nullptr) {
@@ -136,7 +136,7 @@ void ChargePointStatusService::loop() {
     }
 }
 
-ConnectorStatus *ChargePointStatusService::getConnector(int connectorId) {
+Connector *ChargeControlService::getConnector(int connectorId) {
     if (connectorId < 0 || connectorId >= (int) connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
@@ -145,27 +145,27 @@ ConnectorStatus *ChargePointStatusService::getConnector(int connectorId) {
     return connectors.at(connectorId).get();
 }
 
-int ChargePointStatusService::getNumConnectors() {
+int ChargeControlService::getNumConnectors() {
     return connectors.size();
 }
 
-void ChargePointStatusService::setPreReset(std::function<bool(bool)> preReset) {
+void ChargeControlService::setPreReset(std::function<bool(bool)> preReset) {
     this->preReset = preReset;
 }
 
-std::function<bool(bool)> ChargePointStatusService::getPreReset() {
+std::function<bool(bool)> ChargeControlService::getPreReset() {
     return this->preReset;
 }
 
-void ChargePointStatusService::setExecuteReset(std::function<void(bool)> executeReset) {
+void ChargeControlService::setExecuteReset(std::function<void(bool)> executeReset) {
     this->executeReset = executeReset;
 }
 
-std::function<void(bool)> ChargePointStatusService::getExecuteReset() {
+std::function<void(bool)> ChargeControlService::getExecuteReset() {
     return this->executeReset;
 }
 
-void ChargePointStatusService::initiateReset(bool isHard) {
+void ChargeControlService::initiateReset(bool isHard) {
     isHardReset = isHard;
     outstandingResetRetries = 1 + *resetRetries; //one initial try + no. of retries
     if (outstandingResetRetries > 5) {
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h
similarity index 76%
rename from src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
rename to src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h
index ac020458..d285cba1 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h
@@ -2,10 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef CHARGEPOINTSTATUSSERVICE_H
-#define CHARGEPOINTSTATUSSERVICE_H
+#ifndef CHARGECONTROLSERVICE_H
+#define CHARGECONTROLSERVICE_H
 
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Platform.h>
 
@@ -15,11 +15,11 @@ namespace ArduinoOcpp {
 
 class OcppEngine;
 
-class ChargePointStatusService {
+class ChargeControlService {
 private:
     OcppEngine& context;
     
-    std::vector<std::unique_ptr<ConnectorStatus>> connectors;
+    std::vector<std::unique_ptr<Connector>> connectors;
 
     std::function<bool(bool isHard)> preReset; //true: reset is possible; false: reject reset; Await: need more time to determine
     std::function<void(bool isHard)> executeReset; //please disconnect WebSocket (AO remains initialized), shut down device and restart with normal initialization routine; on failure reconnect WebSocket
@@ -30,13 +30,13 @@ class ChargePointStatusService {
     std::shared_ptr<Configuration<int>> resetRetries;
 
 public:
-    ChargePointStatusService(OcppEngine& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+    ChargeControlService(OcppEngine& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
-    ~ChargePointStatusService();
+    ~ChargeControlService();
     
     void loop();
 
-    ConnectorStatus *getConnector(int connectorId);
+    Connector *getConnector(int connectorId);
     int getNumConnectors();
 
     void setPreReset(std::function<bool(bool isHard)> preReset);
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
similarity index 92%
rename from src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
rename to src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index 220342e8..ff0610ce 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -2,11 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 
@@ -27,7 +27,7 @@
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
-ConnectorStatus::ConnectorStatus(OcppEngine& context, int connectorId)
+Connector::Connector(OcppEngine& context, int connectorId)
         : context(context), model(context.getOcppModel()), connectorId{connectorId} {
 
     char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
@@ -59,14 +59,14 @@ ConnectorStatus::ConnectorStatus(OcppEngine& context, int connectorId)
     if (model.getTransactionStore()) {
         transaction = model.getTransactionStore()->getLatestTransaction(connectorId);
     } else {
-        AO_DBG_ERR("must initialize TxStore before ConnectorStatus");
+        AO_DBG_ERR("must initialize TxStore before Connector");
         (void)0;
     }
 }
 
-OcppEvseState ConnectorStatus::inferenceStatus() {
+OcppEvseState Connector::inferenceStatus() {
     /*
-    * Handle special case: This is the ConnectorStatus for the whole CP (i.e. connectorId=0) --> only states Available, Unavailable, Faulted are possible
+    * Handle special case: This is the Connector for the whole CP (i.e. connectorId=0) --> only states Available, Unavailable, Faulted are possible
     */
     if (connectorId == 0) {
         if (getErrorCode() != nullptr) {
@@ -120,7 +120,7 @@ OcppEvseState ConnectorStatus::inferenceStatus() {
     return OcppEvseState::Faulted; //internal error
 }
 
-bool ConnectorStatus::ocppPermitsCharge() {
+bool Connector::ocppPermitsCharge() {
     if (connectorId == 0) {
         AO_DBG_WARN("not supported for connectorId == 0");
         return false;
@@ -140,7 +140,7 @@ bool ConnectorStatus::ocppPermitsCharge() {
             !suspendDeAuthorizedIdTag;
 }
 
-OcppMessage *ConnectorStatus::loop() {
+OcppMessage *Connector::loop() {
 
     if (!isTransactionRunning()) {
         if (*availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
@@ -349,7 +349,7 @@ OcppMessage *ConnectorStatus::loop() {
     return nullptr;
 }
 
-const char *ConnectorStatus::getErrorCode() {
+const char *Connector::getErrorCode() {
     for (auto s = connectorErrorCodeSamplers.begin(); s != connectorErrorCodeSamplers.end(); s++) {
         const char *err = s->operator()();
         if (err != nullptr) {
@@ -359,7 +359,7 @@ const char *ConnectorStatus::getErrorCode() {
     return nullptr;
 }
 
-std::shared_ptr<Transaction> ConnectorStatus::allocateTransaction() {
+std::shared_ptr<Transaction> Connector::allocateTransaction() {
 
     decltype(allocateTransaction()) tx;
 
@@ -458,7 +458,7 @@ std::shared_ptr<Transaction> ConnectorStatus::allocateTransaction() {
     return tx;
 }
 
-std::shared_ptr<Transaction> ConnectorStatus::beginTransaction(const char *idTag) {
+std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     if (transaction) {
         AO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
@@ -617,7 +617,7 @@ std::shared_ptr<Transaction> ConnectorStatus::beginTransaction(const char *idTag
     return transaction;
 }
 
-std::shared_ptr<Transaction> ConnectorStatus::beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
+std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
     
     if (transaction) {
         AO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
@@ -657,7 +657,7 @@ std::shared_ptr<Transaction> ConnectorStatus::beginTransaction_authorized(const
     return transaction;
 }
 
-void ConnectorStatus::endTransaction(const char *reason) {
+void Connector::endTransaction(const char *reason) {
 
     if (!transaction) {
         AO_DBG_WARN("Cannot end session if no transaction running");
@@ -677,7 +677,7 @@ void ConnectorStatus::endTransaction(const char *reason) {
     }
 }
 
-const char *ConnectorStatus::getSessionIdTag() {
+const char *Connector::getSessionIdTag() {
 
     if (!transaction) {
         return nullptr;
@@ -686,11 +686,11 @@ const char *ConnectorStatus::getSessionIdTag() {
     return transaction->isActive() ? transaction->getIdTag() : nullptr;
 }
 
-uint16_t ConnectorStatus::getSessionWriteCount() {
+uint16_t Connector::getSessionWriteCount() {
     return transaction ? transaction->getTxNr() : 0;
 }
 
-bool ConnectorStatus::isTransactionRunning() {
+bool Connector::isTransactionRunning() {
     if (!transaction) {
         return false;
     }
@@ -698,7 +698,7 @@ bool ConnectorStatus::isTransactionRunning() {
     return transaction->isRunning();
 }
 
-int ConnectorStatus::getTransactionId() {
+int Connector::getTransactionId() {
     
     if (!transaction) {
         return -1;
@@ -715,11 +715,11 @@ int ConnectorStatus::getTransactionId() {
     }
 }
 
-std::shared_ptr<Transaction>& ConnectorStatus::getTransaction() {
+std::shared_ptr<Transaction>& Connector::getTransaction() {
     return transaction;
 }
 
-int ConnectorStatus::getAvailability() {
+int Connector::getAvailability() {
     if (availabilityVolatile == AVAILABILITY_INOPERATIVE || *availability == AVAILABILITY_INOPERATIVE) {
         return AVAILABILITY_INOPERATIVE;
     } else if (availabilityVolatile == AVAILABILITY_INOPERATIVE_SCHEDULED || *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
@@ -729,7 +729,7 @@ int ConnectorStatus::getAvailability() {
     }
 }
 
-void ConnectorStatus::setAvailability(bool available) {
+void Connector::setAvailability(bool available) {
     if (available) {
         *availability = AVAILABILITY_OPERATIVE;
     } else {
@@ -742,7 +742,7 @@ void ConnectorStatus::setAvailability(bool available) {
     configuration_save();
 }
 
-void ConnectorStatus::setAvailabilityVolatile(bool available) {
+void Connector::setAvailabilityVolatile(bool available) {
     if (available) {
         availabilityVolatile = AVAILABILITY_OPERATIVE;
     } else {
@@ -754,38 +754,38 @@ void ConnectorStatus::setAvailabilityVolatile(bool available) {
     }
 }
 
-void ConnectorStatus::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
+void Connector::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
     this->connectorPluggedSampler = connectorPlugged;
 }
 
-void ConnectorStatus::setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
+void Connector::setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
     this->evRequestsEnergySampler = evRequestsEnergy;
 }
 
-void ConnectorStatus::setConnectorEnergizedSampler(std::function<bool()> connectorEnergized) {
+void Connector::setConnectorEnergizedSampler(std::function<bool()> connectorEnergized) {
     this->connectorEnergizedSampler = connectorEnergized;
 }
 
-void ConnectorStatus::addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode) {
+void Connector::addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode) {
     this->connectorErrorCodeSamplers.push_back(connectorErrorCode);
 }
 
-void ConnectorStatus::setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
+void Connector::setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
     this->onUnlockConnector = unlockConnector;
 }
 
-std::function<PollResult<bool>()> ConnectorStatus::getOnUnlockConnector() {
+std::function<PollResult<bool>()> Connector::getOnUnlockConnector() {
     return this->onUnlockConnector;
 }
 
-void ConnectorStatus::setStartTxReadyInput(std::function<bool()> startTxReady) {
+void Connector::setStartTxReadyInput(std::function<bool()> startTxReady) {
     this->startTxReadyInput = startTxReady;
 }
 
-void ConnectorStatus::setStopTxReadyInput(std::function<bool()> stopTxReady) {
+void Connector::setStopTxReadyInput(std::function<bool()> stopTxReady) {
     this->stopTxReadyInput = stopTxReady;
 }
 
-void ConnectorStatus::setOccupiedInput(std::function<bool()> occupied) {
+void Connector::setOccupiedInput(std::function<bool()> occupied) {
     this->occupiedInput = occupied;
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
similarity index 95%
rename from src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
rename to src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
index af48084f..0292f311 100644
--- a/src/ArduinoOcpp/Tasks/ChargePointStatus/ConnectorStatus.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
@@ -2,10 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef CONNECTORSTATUS_H
-#define CONNECTORSTATUS_H
+#ifndef CONNECTOR_H
+#define CONNECTOR_H
 
-#include <ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
@@ -25,7 +25,7 @@ class OcppModel;
 class OcppMessage;
 class Transaction;
 
-class ConnectorStatus {
+class Connector {
 private:
     OcppEngine& context;
     OcppModel& model;
@@ -67,7 +67,7 @@ class ConnectorStatus {
     std::shared_ptr<Configuration<const char*>> freeVendIdTag;
     bool freeVendTrackPlugged = false;
 public:
-    ConnectorStatus(OcppEngine& context, int connectorId);
+    Connector(OcppEngine& context, int connectorId);
 
     /*
      * beginTransaction begins the transaction process which eventually leads to a StartTransaction
diff --git a/src/ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h b/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/ChargePointStatus/OcppEvseState.h
rename to src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index 4eaf7124..7e66edde 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/OperationDeserializer.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
@@ -59,14 +59,14 @@ void FirmwareService::loop() {
     OcppTimestamp timestampNow = context.getOcppModel().getOcppTime().getOcppTimestampNow();
     if (retries > 0 && timestampNow >= retreiveDate) {
 
-        auto cpStatusService = context.getOcppModel().getChargePointStatusService();
+        auto cpStatusService = context.getOcppModel().getChargeControlService();
         
         //if (!downloadIssued) {
         if (stage == UpdateStage::Idle) {
             AO_DBG_INFO("Start update");
 
             if (cpStatusService) {
-                ConnectorStatus *evse = cpStatusService->getConnector(0);
+                Connector *evse = cpStatusService->getConnector(0);
                 evse->setAvailabilityVolatile(false);
             }
             if (onDownload == nullptr) {
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index d2be37e6..ae2f3942 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -6,7 +6,7 @@
 #include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
 #include <ArduinoOcpp/Platform.h>
@@ -103,8 +103,8 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
 OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
     bool txBreak = false;
-    if (context.getConnectorStatus(connectorId)) {
-        auto &curTx = context.getConnectorStatus(connectorId)->getTransaction();
+    if (context.getConnector(connectorId)) {
+        auto &curTx = context.getConnector(connectorId)->getTransaction();
         txBreak = (curTx && curTx->isRunning()) != trackTxRunning;
         trackTxRunning = (curTx && curTx->isRunning());
     }
@@ -119,9 +119,9 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
         return meterValues;
     }
 
-    if (context.getConnectorStatus(connectorId)) {
-        if (transaction != context.getConnectorStatus(connectorId)->getTransaction()) {
-            transaction = context.getConnectorStatus(connectorId)->getTransaction();
+    if (context.getConnector(connectorId)) {
+        if (transaction != context.getConnector(connectorId)->getTransaction()) {
+            transaction = context.getConnector(connectorId)->getTransaction();
         }
         
         if (transaction && transaction->isRunning() && !transaction->isSilent()) {
@@ -222,8 +222,8 @@ OcppMessage *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
     mv_now.push_back(std::move(sample));
 
     std::shared_ptr<Transaction> transaction = nullptr;
-    if (context.getConnectorStatus(connectorId)) {
-        transaction = context.getConnectorStatus(connectorId)->getTransaction();
+    if (context.getConnector(connectorId)) {
+        transaction = context.getConnector(connectorId)->getTransaction();
     }
 
     return new MeterValues(std::move(mv_now), connectorId, transaction);
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index 1c0129a2..f20423b6 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/MessagesV16/CancelReservation.h>
 #include <ArduinoOcpp/MessagesV16/ReserveNow.h>
@@ -43,7 +43,7 @@ ReservationService::ReservationService(OcppEngine& context, unsigned int numConn
 
 void ReservationService::loop() {
     //check if to end reservations
-    auto cpService = context.getOcppModel().getChargePointStatusService();
+    auto cpService = context.getOcppModel().getChargeControlService();
     if (!cpService) {
         return;
     }
@@ -53,7 +53,7 @@ void ReservationService::loop() {
             continue;
         }
 
-        if (auto connector = context.getOcppModel().getConnectorStatus(reservation.getConnectorId())) {
+        if (auto connector = context.getOcppModel().getConnector(reservation.getConnectorId())) {
 
             //check if connector went inoperative
             auto cStatus = connector->inferenceStatus();
@@ -162,7 +162,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
     }
 
     unsigned int availableCount = 0;
-    if (auto cpService = context.getOcppModel().getChargePointStatusService()) {
+    if (auto cpService = context.getOcppModel().getChargeControlService()) {
         for (int iconn = 1; iconn < cpService->getNumConnectors(); iconn++) {
             if (iconn == (int) connectorId) {
                 //don't count this connector
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index 34579751..7bb55899 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
 #include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
@@ -246,11 +246,11 @@ ChargingSchedule *SmartChargingService::getCompositeSchedule(int connectorId, ot
 }
 
 void SmartChargingService::refreshChargingSessionState() {
-    if (!context.getOcppModel().getConnectorStatus(SINGLE_CONNECTOR_ID)) {
+    if (!context.getOcppModel().getConnector(SINGLE_CONNECTOR_ID)) {
         return; //charging session state does not apply
     }
 
-    auto connector = context.getOcppModel().getConnectorStatus(SINGLE_CONNECTOR_ID);
+    auto connector = context.getOcppModel().getConnector(SINGLE_CONNECTOR_ID);
 
     if (!chargingSessionStateInitialized) {
         chargingSessionStateInitialized = true;
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index ff501cb9..41eb1c6f 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -3,7 +3,7 @@
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index c4243808..f4d64304 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
@@ -43,7 +43,7 @@ TEST_CASE( "Configuration Behavior" ) {
     auto engine = getOcppEngine();
     auto& checkMsg = engine->getOperationDeserializer();
 
-    auto connector = engine->getOcppModel().getConnectorStatus(1);
+    auto connector = engine->getOcppModel().getConnector(1);
 
     ao_set_timer(custom_timer_cb);
 
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index e096374f..dc244d3a 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -3,7 +3,7 @@
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Tasks/ChargePointStatus/ChargePointStatusService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>

From 5e756175b65d171256f9235228b1f9964dc4f1da Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 22 May 2023 14:15:00 +0200
Subject: [PATCH 245/549] isolate Reset and Connector

---
 CMakeLists.txt                                |   1 +
 src/ArduinoOcpp.cpp                           |  20 +++-
 src/ArduinoOcpp/Core/OcppModel.cpp            |  45 +++++---
 src/ArduinoOcpp/Core/OcppModel.h              |  23 ++--
 .../MessagesV16/ChangeAvailability.cpp        |  20 ++--
 .../MessagesV16/GetCompositeSchedule.cpp      |   8 +-
 .../MessagesV16/RemoteStartTransaction.cpp    |  20 ++--
 .../MessagesV16/RemoteStopTransaction.cpp     |  14 +--
 src/ArduinoOcpp/MessagesV16/ReserveNow.cpp    |  11 +-
 src/ArduinoOcpp/MessagesV16/Reset.cpp         |  17 ++-
 .../MessagesV16/TriggerMessage.cpp            |  42 ++++---
 .../Authorization/AuthorizationService.cpp    |   6 +-
 .../ChargeControl/ChargeControlService.cpp    | 103 +-----------------
 .../ChargeControl/ChargeControlService.h      |  38 -------
 .../Tasks/ChargeControl/Connector.cpp         |  29 +++--
 .../Tasks/ChargeControl/Connector.h           |   3 +-
 .../FirmwareManagement/FirmwareService.cpp    |  22 ++--
 .../Tasks/Reservation/ReservationService.cpp  |  12 +-
 src/ArduinoOcpp/Tasks/Reset/ResetService.cpp  | 100 +++++++++++++++++
 src/ArduinoOcpp/Tasks/Reset/ResetService.h    |  54 +++++++++
 20 files changed, 322 insertions(+), 266 deletions(-)
 create mode 100644 src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Reset/ResetService.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index d9cf11cf..618d2a4f 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -68,6 +68,7 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
     src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
     src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+    src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
     src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 2dc297ae..ad84b814 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -16,6 +16,7 @@
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Tasks/Boot/BootService.h>
+#include <ArduinoOcpp/Tasks/Reset/ResetService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/OperationDeserializer.h>
 #include <ArduinoOcpp/Core/Configuration.h>
@@ -142,12 +143,19 @@ void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredent
         new BootService(*ocppEngine)));
     model.setChargeControlService(std::unique_ptr<ChargeControlService>(
         new ChargeControlService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
+    std::vector<Connector> connectors;
+    for (unsigned int connectorId = 0; connectorId < AO_NUMCONNECTORS; connectorId++) {
+        connectors.push_back(Connector(*ocppEngine, connectorId));
+    }
+    model.setConnectors(std::move(connectors));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
         new HeartbeatService(*ocppEngine)));
     model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
         new AuthorizationService(*ocppEngine, filesystem)));
     model.setReservationService(std::unique_ptr<ReservationService>(
         new ReservationService(*ocppEngine, AO_NUMCONNECTORS)));
+    model.setResetService(std::unique_ptr<ResetService>(
+        new ResetService(*ocppEngine)));
     
 #if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
@@ -166,8 +174,8 @@ void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredent
 #endif
 
 #if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
-    if (!model.getChargeControlService()->getExecuteReset())
-        model.getChargeControlService()->setExecuteReset(makeDefaultResetFn());
+    if (!model.getResetService()->getExecuteReset())
+        model.getResetService()->setExecuteReset(makeDefaultResetFn());
 #endif
 
     model.getBootService()->setChargePointCredentials(bootNotificationCredentials);
@@ -518,8 +526,8 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
         return;
     }
 
-    if (auto csService = ocppEngine->getOcppModel().getChargeControlService()) {
-        csService->setPreReset(onResetNotify);
+    if (auto rService = ocppEngine->getOcppModel().getResetService()) {
+        rService->setPreReset(onResetNotify);
     }
 }
 
@@ -529,8 +537,8 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute) {
         return;
     }
 
-    if (auto csService = ocppEngine->getOcppModel().getChargeControlService()) {
-        csService->setExecuteReset(onResetExecute);
+    if (auto rService = ocppEngine->getOcppModel().getResetService()) {
+        rService->setExecuteReset(onResetExecute);
     }
 }
 
diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/OcppModel.cpp
index c4db9477..18c075c1 100644
--- a/src/ArduinoOcpp/Core/OcppModel.cpp
+++ b/src/ArduinoOcpp/Core/OcppModel.cpp
@@ -13,6 +13,7 @@
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Tasks/Boot/BootService.h>
+#include <ArduinoOcpp/Tasks/Reset/ResetService.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -35,8 +36,12 @@ void OcppModel::loop() {
         return;
     }
 
-    if (chargePointStatusService)
-        chargePointStatusService->loop();
+    for (auto& connector : connectors) {
+        connector.loop();
+    }
+
+    if (chargeControlService)
+        chargeControlService->loop();
     
     if (smartChargingService)
         smartChargingService->loop();
@@ -73,23 +78,29 @@ SmartChargingService* OcppModel::getSmartChargingService() const {
     return smartChargingService.get();
 }
 
-void OcppModel::setChargeControlService(std::unique_ptr<ChargeControlService> cpss){
-    chargePointStatusService = std::move(cpss);
+void OcppModel::setChargeControlService(std::unique_ptr<ChargeControlService> ccs) {
+    chargeControlService = std::move(ccs);
 }
 
-ChargeControlService *OcppModel::getChargeControlService() const {
-    return chargePointStatusService.get();
+ChargeControlService *OcppModel::getChargeControlService() {
+    return chargeControlService.get();
 }
 
-Connector *OcppModel::getConnector(int connectorId) const {
-    if (getChargeControlService() == nullptr) return nullptr;
+void OcppModel::setConnectors(std::vector<Connector>&& connectors) {
+    this->connectors = std::move(connectors);
+}
+
+unsigned int OcppModel::getNumConnectors() const {
+    return connectors.size();
+}
 
-    auto result = getChargeControlService()->getConnector(connectorId);
-    if (result == nullptr) {
-        AO_DBG_ERR("Cannot fetch connector with given connectorId. Return nullptr");
-        //no error catch 
+Connector *OcppModel::getConnector(unsigned int connectorId) {
+    if (connectorId >= connectors.size()) {
+        AO_DBG_ERR("connector with connectorId %u does not exist", connectorId);
+        return nullptr;
     }
-    return result;
+
+    return &connectors[connectorId];
 }
 
 void OcppModel::setMeteringSerivce(std::unique_ptr<MeteringService> ms) {
@@ -144,6 +155,14 @@ BootService *OcppModel::getBootService() const {
     return bootService.get();
 }
 
+void OcppModel::setResetService(std::unique_ptr<ResetService> rs) {
+    this->resetService = std::move(rs);
+}
+
+ResetService *OcppModel::getResetService() const {
+    return resetService.get();
+}
+
 OcppTime& OcppModel::getOcppTime() {
     return ocppTime;
 }
diff --git a/src/ArduinoOcpp/Core/OcppModel.h b/src/ArduinoOcpp/Core/OcppModel.h
index 6420c894..b00a0688 100644
--- a/src/ArduinoOcpp/Core/OcppModel.h
+++ b/src/ArduinoOcpp/Core/OcppModel.h
@@ -5,16 +5,16 @@
 #ifndef OCPPMODEL_H
 #define OCPPMODEL_H
 
-#include <ArduinoOcpp/Core/OcppTime.h>
-
 #include <memory>
 
+#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
+
 namespace ArduinoOcpp {
 
 class TransactionStore;
 class SmartChargingService;
 class ChargeControlService;
-class Connector;
 class MeteringService;
 class FirmwareService;
 class DiagnosticsService;
@@ -22,12 +22,14 @@ class HeartbeatService;
 class AuthorizationService;
 class ReservationService;
 class BootService;
+class ResetService;
 
 class OcppModel {
 private:
+    std::vector<Connector> connectors;
     std::unique_ptr<TransactionStore> transactionStore;
     std::unique_ptr<SmartChargingService> smartChargingService;
-    std::unique_ptr<ChargeControlService> chargePointStatusService;
+    std::unique_ptr<ChargeControlService> chargeControlService;
     std::unique_ptr<MeteringService> meteringService;
     std::unique_ptr<FirmwareService> firmwareService;
     std::unique_ptr<DiagnosticsService> diagnosticsService;
@@ -35,6 +37,7 @@ class OcppModel {
     std::unique_ptr<AuthorizationService> authorizationService;
     std::unique_ptr<ReservationService> reservationService;
     std::unique_ptr<BootService> bootService;
+    std::unique_ptr<ResetService> resetService;
     OcppTime ocppTime;
 
     bool runTasks = false;
@@ -55,9 +58,12 @@ class OcppModel {
     void setSmartChargingService(std::unique_ptr<SmartChargingService> scs);
     SmartChargingService* getSmartChargingService() const;
 
-    void setChargeControlService(std::unique_ptr<ChargeControlService> cpss);
-    ChargeControlService *getChargeControlService() const;
-    Connector *getConnector(int connectorId) const;
+    void setChargeControlService(std::unique_ptr<ChargeControlService> ccs);
+    ChargeControlService *getChargeControlService();
+
+    void setConnectors(std::vector<Connector>&& connectors);
+    unsigned int getNumConnectors() const;
+    Connector *getConnector(unsigned int connectorId);
 
     void setMeteringSerivce(std::unique_ptr<MeteringService> meteringService);
     MeteringService* getMeteringService() const;
@@ -79,6 +85,9 @@ class OcppModel {
     void setBootService(std::unique_ptr<BootService> bs);
     BootService *getBootService() const;
 
+    void setResetService(std::unique_ptr<ResetService> rs);
+    ResetService *getResetService() const;
+
     OcppTime &getOcppTime();
 };
 
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
index 68d0e12d..18126524 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 
 #include <functional>
 
@@ -20,11 +20,7 @@ const char* ChangeAvailability::getOcppOperationType(){
 
 void ChangeAvailability::processReq(JsonObject payload) {
     int connectorId = payload["connectorId"] | -1;
-    auto cpStatus = context.getChargeControlService();
-    if (!cpStatus) {
-        return;
-    }
-    if (connectorId < 0 || connectorId >= cpStatus->getNumConnectors()) {
+    if (connectorId < 0 || connectorId >= context.getNumConnectors()) {
         return;
     }
 
@@ -42,15 +38,17 @@ void ChangeAvailability::processReq(JsonObject payload) {
     }
 
     if (connectorId == 0) {
-        for (int i = 0; i < cpStatus->getNumConnectors(); i++) {
-            cpStatus->getConnector(i)->setAvailability(available);
-            if (cpStatus->getConnector(i)->getAvailability() == AVAILABILITY_INOPERATIVE_SCHEDULED) {
+        for (unsigned int cId = 0; cId < context.getNumConnectors(); cId++) {
+            auto connector = context.getConnector(cId);
+            connector->setAvailability(available);
+            if (connector->getAvailability() == AVAILABILITY_INOPERATIVE_SCHEDULED) {
                 scheduled = true;
             }
         }
     } else {
-        cpStatus->getConnector(connectorId)->setAvailability(available);
-        if (cpStatus->getConnector(connectorId)->getAvailability() == AVAILABILITY_INOPERATIVE_SCHEDULED) {
+        auto connector = context.getConnector(connectorId);
+        connector->setAvailability(available);
+        if (connector->getAvailability() == AVAILABILITY_INOPERATIVE_SCHEDULED) {
             scheduled = true;
         }
     }
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
index e39a94d6..472df037 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -34,10 +34,8 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
         errorCode = "PropertyConstraintViolation";
     }
 
-    if (auto cpService = context.getChargeControlService()) {
-        if (connectorId >= cpService->getNumConnectors()) {
-            errorCode = "PropertyConstraintViolation";
-        }
+    if (connectorId >= context.getNumConnectors()) {
+        errorCode = "PropertyConstraintViolation";
     }
 
     if (connectorId < 0 || !payload.containsKey("duration")) {
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
index 0bdf1542..5a6e9ee6 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
@@ -6,7 +6,7 @@
 #include <ArduinoOcpp/MessagesV16/RemoteStartTransaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -64,16 +64,14 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         }
     } else {
         //connectorId not specified. Find free connector
-        if (auto cpStatusService = context.getChargeControlService()) {
-            for (int i = 1; i < cpStatusService->getNumConnectors(); i++) {
-                auto connIter = cpStatusService->getConnector(i);
-                if (connIter->getTransactionId() < 0 && 
-                            connIter->getAvailability() == AVAILABILITY_OPERATIVE &&
-                            connIter->getSessionIdTag() == nullptr) {
-                    canStartTransaction = true;
-                    connectorId = i;
-                    break;
-                }
+        for (unsigned int cid = 1; cid < context.getNumConnectors(); cid++) {
+            auto connector = context.getConnector(cid);
+            if (connector->getTransactionId() < 0 && 
+                        connector->getAvailability() == AVAILABILITY_OPERATIVE &&
+                        connector->getSessionIdTag() == nullptr) {
+                canStartTransaction = true;
+                connectorId = cid;
+                break;
             }
         }
     }
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
index 32737b72..a352bf09 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/RemoteStopTransaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 
 using ArduinoOcpp::Ocpp16::RemoteStopTransaction;
 
@@ -26,13 +26,11 @@ std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
     
     bool canStopTransaction = false;
 
-    if (auto cpStatusService = context.getChargeControlService()) {
-        for (int i = 0; i < cpStatusService->getNumConnectors(); i++) {
-            auto connIter = cpStatusService->getConnector(i);
-            if (connIter->getTransactionId() == transactionId) {
-                canStopTransaction = true;
-                connIter->endTransaction("Remote");
-            }
+    for (unsigned int cId = 0; cId < context.getNumConnectors(); cId++) {
+        auto connector = context.getConnector(cId);
+        if (connector->getTransactionId() == transactionId) {
+            canStopTransaction = true;
+            connector->endTransaction("Remote");
         }
     }
 
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
index 906f28a8..ccc2a8d9 100644
--- a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/MessagesV16/ReserveNow.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Platform.h>
 
 using ArduinoOcpp::Ocpp16::ReserveNow;
@@ -43,13 +43,12 @@ void ReserveNow::processReq(JsonObject payload) {
     int connectorId = payload["connectorId"];
 
     if (context.getReservationService() &&
-                context.getChargeControlService() &&
-                context.getChargeControlService()->getConnector(0)) {
+                context.getNumConnectors() > 0) {
         auto rService = context.getReservationService();
         auto cpService = context.getChargeControlService();
-        auto chargePoint = cpService->getConnector(0);
+        auto chargePoint = context.getConnector(0);
 
-        if (connectorId >= cpService->getNumConnectors()) {
+        if (connectorId >= context.getNumConnectors()) {
             errorCode = "PropertyConstraintViolation";
             return;
         }
@@ -69,7 +68,7 @@ void ReserveNow::processReq(JsonObject payload) {
         Connector *connector = nullptr;
         
         if (connectorId > 0) {
-            connector = cpService->getConnector(connectorId);
+            connector = context.getConnector(connectorId);
         }
 
         if (chargePoint->inferenceStatus() == OcppEvseState::Faulted ||
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.cpp b/src/ArduinoOcpp/MessagesV16/Reset.cpp
index 628e1f38..17d71da6 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Reset.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/MessagesV16/Reset.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/Reset/ResetService.h>
 
 using ArduinoOcpp::Ocpp16::Reset;
 
@@ -23,20 +23,17 @@ void Reset::processReq(JsonObject payload) {
      */
     bool isHard = !strcmp(payload["type"] | "undefined", "Hard");
 
-    if (auto cpsService = context.getChargeControlService()) {
-        if (!cpsService->getExecuteReset()) {
+    if (auto rService = context.getResetService()) {
+        if (!rService->getExecuteReset()) {
             AO_DBG_ERR("No reset handler set. Abort operation");
             (void)0;
             //resetAccepted remains false
         } else {
-            if (!cpsService->getPreReset() || cpsService->getPreReset()(isHard) || isHard) {
+            if (!rService->getPreReset() || rService->getPreReset()(isHard) || isHard) {
                 resetAccepted = true;
-                cpsService->initiateReset(isHard);
-                for (int i = 0; i < cpsService->getNumConnectors(); i++) {
-                    auto connector = cpsService->getConnector(i);
-                    if (connector) {
-                        connector->endTransaction(isHard ? "HardReset" : "SoftReset");
-                    }
+                rService->initiateReset(isHard);
+                for (unsigned int cId = 0; cId < context.getNumConnectors(); cId++) {
+                    context.getConnector(cId)->endTransaction(isHard ? "HardReset" : "SoftReset");
                 }
             }
         }
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
index 0cb26ec8..78d0673b 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/TriggerMessage.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
@@ -34,8 +34,8 @@ void TriggerMessage::processReq(JsonObject payload) {
         if (auto mService = context.getMeteringService()) {
             if (connectorId < 0) {
                 auto nConnectors = mService->getNumConnectors();
-                for (decltype(nConnectors) i = 0; i < nConnectors; i++) {
-                    triggeredOperations.push_back(mService->takeTriggeredMeterValues(i));
+                for (decltype(nConnectors) cId = 0; cId < nConnectors; cId++) {
+                    triggeredOperations.push_back(mService->takeTriggeredMeterValues(cId));
                 }
             } else if (connectorId < mService->getNumConnectors()) {
                 triggeredOperations.push_back(mService->takeTriggeredMeterValues(connectorId));
@@ -44,29 +44,27 @@ void TriggerMessage::processReq(JsonObject payload) {
             }
         }
     } else if (!strcmp(requestedMessage, "StatusNotification")) {
-        if (auto cpsService = context.getChargeControlService()) {
-            unsigned int cIdRangeBegin = 0, cIdRangeEnd = 0;
-            if (connectorId < 0) {
-                cIdRangeEnd = cpsService->getNumConnectors();
-            } else if (connectorId < cpsService->getNumConnectors()) {
-                cIdRangeBegin = connectorId;
-                cIdRangeEnd = connectorId + 1;
-            } else {
-                errorCode = "PropertyConstraintViolation";
-            }
+        unsigned int cIdRangeBegin = 0, cIdRangeEnd = 0;
+        if (connectorId < 0) {
+            cIdRangeEnd = context.getNumConnectors();
+        } else if (connectorId < context.getNumConnectors()) {
+            cIdRangeBegin = connectorId;
+            cIdRangeEnd = connectorId + 1;
+        } else {
+            errorCode = "PropertyConstraintViolation";
+        }
 
-            for (auto i = cIdRangeBegin; i < cIdRangeEnd; i++) {
-                auto connector = cpsService->getConnector(i);
+        for (auto i = cIdRangeBegin; i < cIdRangeEnd; i++) {
+            auto connector = context.getConnector(i);
 
-                auto statusNotification = makeOcppOperation(new Ocpp16::StatusNotification(
-                            i,
-                            connector->inferenceStatus(), //will be determined in StatusNotification::initiate
-                            context.getOcppTime().getOcppTimestampNow()));
+            auto statusNotification = makeOcppOperation(new Ocpp16::StatusNotification(
+                        i,
+                        connector->inferenceStatus(), //will be determined in StatusNotification::initiate
+                        context.getOcppTime().getOcppTimestampNow()));
 
-                statusNotification->setTimeout(60000);
+            statusNotification->setTimeout(60000);
 
-                triggeredOperations.push_back(std::move(statusNotification));
-            }
+            triggeredOperations.push_back(std::move(statusNotification));
         }
     } else {
         auto msg = defaultOcppEngine->getOperationDeserializer().deserializeOperation(requestedMessage);
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index 03ee04ab..3e661221 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
@@ -176,8 +176,8 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
         //send error code "LocalListConflict" to server
 
         OcppEvseState cpStatus = OcppEvseState::NOT_SET;
-        if (auto cp = context.getOcppModel().getConnector(0)) {
-            cpStatus = cp->inferenceStatus();
+        if (context.getOcppModel().getNumConnectors() > 0) {
+            cpStatus = context.getOcppModel().getConnector(0)->inferenceStatus();
         }
 
         auto statusNotification = makeOcppOperation(new Ocpp16::StatusNotification(
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
index 376f7023..76b46afc 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
@@ -2,9 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
+#include <string>
+
 #include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
 #include <ArduinoOcpp/MessagesV16/ChangeConfiguration.h>
@@ -23,19 +24,10 @@
 
 #include <ArduinoOcpp/Debug.h>
 
-#include <memory>
-#include <string.h>
-
-#define RESET_DELAY 15000
-
 using namespace ArduinoOcpp;
 
-ChargeControlService::ChargeControlService(OcppEngine& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
-      : context(context) {
-
-    for (unsigned int i = 0; i < numConn; i++) {
-        connectors.push_back(std::unique_ptr<Connector>(new Connector(context, i)));
-    }
+ChargeControlService::ChargeControlService(OcppEngine& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
+        context(context) {
     
     std::shared_ptr<Configuration<int>> numberOfConnectors =
             declareConfiguration<int>("NumberOfConnectors", numConn >= 1 ? numConn - 1 : 0, CONFIGURATION_VOLATILE, false, true, false, false);
@@ -58,15 +50,12 @@ ChargeControlService::ChargeControlService(OcppEngine& context, unsigned int num
         fProfilePlus += fpIdRTrigger;
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
-
-    resetRetries = declareConfiguration<int>("ResetRetries", 2, CONFIGURATION_FN, true, true, false, false);
     
     /*
      * Further configuration keys which correspond to the Core profile
      */
     declareConfiguration<bool>("AuthorizeRemoteTxRequests",false,CONFIGURATION_VOLATILE,false,true,false,false);
     declareConfiguration<int>("GetConfigurationMaxKeys",30,CONFIGURATION_VOLATILE,false,true,false,false);
-
     
     context.getOperationDeserializer().registerOcppOperation("ChangeAvailability", [&context] () {
         return new Ocpp16::ChangeAvailability(context.getOcppModel());});
@@ -102,88 +91,6 @@ ChargeControlService::ChargeControlService(OcppEngine& context, unsigned int num
         return new Ocpp16::StopTransaction(context.getOcppModel(), nullptr);});
 }
 
-ChargeControlService::~ChargeControlService() {
-
-}
-
 void ChargeControlService::loop() {
-    for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
-        auto transactionMsg = (*connector)->loop();
-        if (transactionMsg != nullptr) {
-            auto transactionOp = makeOcppOperation(transactionMsg);
-            transactionOp->setTimeout(0);
-            context.initiateOperation(std::move(transactionOp));
-        }
-    }
-
-    if (outstandingResetRetries > 0 && ao_tick_ms() - t_resetRetry >= RESET_DELAY) {
-        t_resetRetry = ao_tick_ms();
-        outstandingResetRetries--;
-        if (executeReset) {
-            AO_DBG_INFO("Reset device");
-            executeReset(isHardReset);
-        } else {
-            AO_DBG_ERR("No Reset function set! Abort");
-            outstandingResetRetries = 0;
-        }
-        AO_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
-
-        if (outstandingResetRetries <= 0) {
-            for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
-                (*connector)->setAvailabilityVolatile(true);
-            }
-        }
-    }
-}
-
-Connector *ChargeControlService::getConnector(int connectorId) {
-    if (connectorId < 0 || connectorId >= (int) connectors.size()) {
-        AO_DBG_ERR("connectorId is out of bounds");
-        return nullptr;
-    }
-
-    return connectors.at(connectorId).get();
-}
-
-int ChargeControlService::getNumConnectors() {
-    return connectors.size();
-}
-
-void ChargeControlService::setPreReset(std::function<bool(bool)> preReset) {
-    this->preReset = preReset;
-}
-
-std::function<bool(bool)> ChargeControlService::getPreReset() {
-    return this->preReset;
-}
-
-void ChargeControlService::setExecuteReset(std::function<void(bool)> executeReset) {
-    this->executeReset = executeReset;
-}
-
-std::function<void(bool)> ChargeControlService::getExecuteReset() {
-    return this->executeReset;
-}
-
-void ChargeControlService::initiateReset(bool isHard) {
-    isHardReset = isHard;
-    outstandingResetRetries = 1 + *resetRetries; //one initial try + no. of retries
-    if (outstandingResetRetries > 5) {
-        AO_DBG_ERR("no. of reset trials exceeds 5");
-        outstandingResetRetries = 5;
-    }
-    t_resetRetry = ao_tick_ms();
-
-    for (auto connector = connectors.begin(); connector != connectors.end(); connector++) {
-        (*connector)->setAvailabilityVolatile(false);
-    }
-}
-
-#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
-std::function<void(bool isHard)> ArduinoOcpp::makeDefaultResetFn() {
-    return [] (bool isHard) {
-        AO_DBG_DEBUG("Perform ESP reset");
-        ESP.restart();
-    };
+    //do nothing
 }
-#endif //AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h
index d285cba1..3ea53697 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h
@@ -5,11 +5,7 @@
 #ifndef CHARGECONTROLSERVICE_H
 #define CHARGECONTROLSERVICE_H
 
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Platform.h>
-
-#include <vector>
 
 namespace ArduinoOcpp {
 
@@ -18,46 +14,12 @@ class OcppEngine;
 class ChargeControlService {
 private:
     OcppEngine& context;
-    
-    std::vector<std::unique_ptr<Connector>> connectors;
-
-    std::function<bool(bool isHard)> preReset; //true: reset is possible; false: reject reset; Await: need more time to determine
-    std::function<void(bool isHard)> executeReset; //please disconnect WebSocket (AO remains initialized), shut down device and restart with normal initialization routine; on failure reconnect WebSocket
-    unsigned int outstandingResetRetries = 0; //0 = do not reset device
-    bool isHardReset = false;
-    unsigned long t_resetRetry;
-
-    std::shared_ptr<Configuration<int>> resetRetries;
-
 public:
     ChargeControlService(OcppEngine& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
-    ~ChargeControlService();
-    
     void loop();
-
-    Connector *getConnector(int connectorId);
-    int getNumConnectors();
-
-    void setPreReset(std::function<bool(bool isHard)> preReset);
-    std::function<bool(bool isHard)> getPreReset();
-
-    void setExecuteReset(std::function<void(bool isHard)> executeReset);
-    std::function<void(bool isHard)> getExecuteReset();
-
-    void initiateReset(bool isHard);
 };
 
 } //end namespace ArduinoOcpp
 
-#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
-
-namespace ArduinoOcpp {
-
-std::function<void(bool isHard)> makeDefaultResetFn();
-
-}
-
-#endif //AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
-
 #endif
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index ff0610ce..55299bee 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -6,6 +6,7 @@
 
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/OcppOperation.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Core/Configuration.h>
@@ -140,7 +141,7 @@ bool Connector::ocppPermitsCharge() {
             !suspendDeAuthorizedIdTag;
 }
 
-OcppMessage *Connector::loop() {
+void Connector::loop() {
 
     if (!isTransactionRunning()) {
         if (*availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
@@ -244,7 +245,7 @@ OcppMessage *Connector::loop() {
                     transaction->getStartRpcSync().setRequested();
                     transaction->getStartRpcSync().confirm();
                     transaction->commit();
-                    return nullptr;
+                    return;
                 }
 
                 transaction->commit();
@@ -253,7 +254,10 @@ OcppMessage *Connector::loop() {
                     model.getMeteringService()->beginTxMeterData(transaction.get());
                 }
 
-                return new StartTransaction(model, transaction);
+                auto startTx = makeOcppOperation(new StartTransaction(model, transaction));
+                startTx->setTimeout(0);
+                context.initiateOperation(std::move(startTx));
+                return;
             }
         } else  {
             //stop tx?
@@ -274,7 +278,7 @@ OcppMessage *Connector::loop() {
                     model.getTransactionStore()->remove(connectorId, transaction->getTxNr());
                     model.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr());
                     transaction = nullptr;
-                    return nullptr;
+                    return;
                 }
                 
                 auto meteringService = model.getMeteringService();
@@ -299,11 +303,16 @@ OcppMessage *Connector::loop() {
                     stopTxData = meteringService->endTxMeterData(transaction.get());
                 }
 
+                std::unique_ptr<OcppOperation> stopTx;
+
                 if (stopTxData) {
-                    return new StopTransaction(model, std::move(transaction), stopTxData->retrieveStopTxData());
+                    stopTx = makeOcppOperation(new StopTransaction(model, std::move(transaction), stopTxData->retrieveStopTxData()));
                 } else {
-                    return new StopTransaction(model, std::move(transaction));
+                    stopTx = makeOcppOperation(new StopTransaction(model, std::move(transaction)));
                 }
+                stopTx->setTimeout(0);
+                context.initiateOperation(std::move(stopTx));
+                return;
             }
         }
     } //end transaction-related operations
@@ -343,10 +352,14 @@ OcppMessage *Connector::loop() {
         OcppTimestamp reportedTimestamp = model.getOcppTime().getOcppTimestampNow();
         reportedTimestamp -= (ao_tick_ms() - t_statusTransition) / 1000UL;
 
-        return new StatusNotification(connectorId, reportedStatus, reportedTimestamp, getErrorCode());
+        auto statusNotification = makeOcppOperation(
+                new StatusNotification(connectorId, reportedStatus, reportedTimestamp, getErrorCode()));
+        statusNotification->setTimeout(0);
+        context.initiateOperation(std::move(statusNotification));
+        return;
     }
 
-    return nullptr;
+    return;
 }
 
 const char *Connector::getErrorCode() {
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
index 0292f311..aeec7253 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
@@ -68,6 +68,7 @@ class Connector {
     bool freeVendTrackPlugged = false;
 public:
     Connector(OcppEngine& context, int connectorId);
+    Connector(Connector&& other) = default;
 
     /*
      * beginTransaction begins the transaction process which eventually leads to a StartTransaction
@@ -104,7 +105,7 @@ class Connector {
     void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized);
     void addConnectorErrorCodeSampler(std::function<const char*()> connectorErrorCode);
 
-    OcppMessage *loop();
+    void loop();
 
     OcppEvseState inferenceStatus();
 
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index 7e66edde..ed6ab816 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/OperationDeserializer.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
@@ -59,15 +59,13 @@ void FirmwareService::loop() {
     OcppTimestamp timestampNow = context.getOcppModel().getOcppTime().getOcppTimestampNow();
     if (retries > 0 && timestampNow >= retreiveDate) {
 
-        auto cpStatusService = context.getOcppModel().getChargeControlService();
-        
         //if (!downloadIssued) {
         if (stage == UpdateStage::Idle) {
             AO_DBG_INFO("Start update");
 
-            if (cpStatusService) {
-                Connector *evse = cpStatusService->getConnector(0);
-                evse->setAvailabilityVolatile(false);
+            if (context.getOcppModel().getNumConnectors() > 0) {
+                auto cp = context.getOcppModel().getConnector(0);
+                cp->setAvailabilityVolatile(false);
             }
             if (onDownload == nullptr) {
                 stage = UpdateStage::AfterDownload;
@@ -128,13 +126,11 @@ void FirmwareService::loop() {
         //if (!installationIssued) {
         if (stage == UpdateStage::AfterDownload) {
             bool ongoingTx = false;
-            if (cpStatusService) {
-                for (int i = 0; i < cpStatusService->getNumConnectors(); i++) {
-                    auto connector = cpStatusService->getConnector(i);
-                    if (connector && connector->getTransactionId() >= 0) {
-                        ongoingTx = true;
-                        break;
-                    }
+            for (unsigned int cId = 0; cId < context.getOcppModel().getNumConnectors(); cId++) {
+                auto connector = context.getOcppModel().getConnector(cId);
+                if (connector && connector->getTransactionId() >= 0) {
+                    ongoingTx = true;
+                    break;
                 }
             }
 
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index f20423b6..d3ea812f 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/MessagesV16/CancelReservation.h>
 #include <ArduinoOcpp/MessagesV16/ReserveNow.h>
@@ -70,8 +70,8 @@ void ReservationService::loop() {
         }
 
         //check if tx with same idTag or reservationId has started
-        for (int cId = 1; cId < cpService->getNumConnectors(); cId++) {
-            auto& transaction = cpService->getConnector(cId)->getTransaction();
+        for (unsigned int cId = 1; cId < context.getOcppModel().getNumConnectors(); cId++) {
+            auto& transaction = context.getOcppModel().getConnector(cId)->getTransaction();
             if (transaction) {
                 const char *cIdTag = transaction->getIdTag();
                 if (transaction->getReservationId() == reservation.getReservationId() || 
@@ -163,12 +163,12 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
 
     unsigned int availableCount = 0;
     if (auto cpService = context.getOcppModel().getChargeControlService()) {
-        for (int iconn = 1; iconn < cpService->getNumConnectors(); iconn++) {
-            if (iconn == (int) connectorId) {
+        for (unsigned int cId = 1; cId < context.getOcppModel().getNumConnectors(); cId++) {
+            if (cId == (int) connectorId) {
                 //don't count this connector
                 continue;
             }
-            if (auto connector = cpService->getConnector(iconn)) {
+            if (auto connector = context.getOcppModel().getConnector(cId)) {
                 if (connector->inferenceStatus() == OcppEvseState::Available) {
                     availableCount++;
                 }
diff --git a/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp b/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
new file mode 100644
index 00000000..5ed25fa7
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
@@ -0,0 +1,100 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Reset/ResetService.h>
+#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/MessagesV16/Reset.h>
+
+#include <ArduinoOcpp/MessagesV16/Authorize.h>
+#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
+#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
+#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
+
+#include <ArduinoOcpp/Debug.h>
+
+#include <memory>
+#include <string.h>
+
+#define RESET_DELAY 15000
+
+using namespace ArduinoOcpp;
+
+ResetService::ResetService(OcppEngine& context)
+      : context(context) {
+
+    resetRetries = declareConfiguration<int>("ResetRetries", 2, CONFIGURATION_FN, true, true, false, false);
+
+    context.getOperationDeserializer().registerOcppOperation("Reset", [&context] () {
+        return new Ocpp16::Reset(context.getOcppModel());});
+}
+
+ResetService::~ResetService() {
+
+}
+
+void ResetService::loop() {
+
+    if (outstandingResetRetries > 0 && ao_tick_ms() - t_resetRetry >= RESET_DELAY) {
+        t_resetRetry = ao_tick_ms();
+        outstandingResetRetries--;
+        if (executeReset) {
+            AO_DBG_INFO("Reset device");
+            executeReset(isHardReset);
+        } else {
+            AO_DBG_ERR("No Reset function set! Abort");
+            outstandingResetRetries = 0;
+        }
+        AO_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
+
+        if (outstandingResetRetries <= 0) {
+            for (unsigned int cId = 0; cId < context.getOcppModel().getNumConnectors(); cId++) {
+                auto connector = context.getOcppModel().getConnector(cId);
+                connector->setAvailabilityVolatile(true);
+            }
+        }
+    }
+}
+
+void ResetService::setPreReset(std::function<bool(bool)> preReset) {
+    this->preReset = preReset;
+}
+
+std::function<bool(bool)> ResetService::getPreReset() {
+    return this->preReset;
+}
+
+void ResetService::setExecuteReset(std::function<void(bool)> executeReset) {
+    this->executeReset = executeReset;
+}
+
+std::function<void(bool)> ResetService::getExecuteReset() {
+    return this->executeReset;
+}
+
+void ResetService::initiateReset(bool isHard) {
+    isHardReset = isHard;
+    outstandingResetRetries = 1 + *resetRetries; //one initial try + no. of retries
+    if (outstandingResetRetries > 5) {
+        AO_DBG_ERR("no. of reset trials exceeds 5");
+        outstandingResetRetries = 5;
+    }
+    t_resetRetry = ao_tick_ms();
+
+    for (unsigned int cId = 0; cId < context.getOcppModel().getNumConnectors(); cId++) {
+        auto connector = context.getOcppModel().getConnector(cId);
+        connector->setAvailabilityVolatile(false);
+    }
+}
+
+#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+std::function<void(bool isHard)> ArduinoOcpp::makeDefaultResetFn() {
+    return [] (bool isHard) {
+        AO_DBG_DEBUG("Perform ESP reset");
+        ESP.restart();
+    };
+}
+#endif //AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
diff --git a/src/ArduinoOcpp/Tasks/Reset/ResetService.h b/src/ArduinoOcpp/Tasks/Reset/ResetService.h
new file mode 100644
index 00000000..6e7dc43a
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Reset/ResetService.h
@@ -0,0 +1,54 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef RESETSERVICE_H
+#define RESETSERVICE_H
+
+#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
+
+namespace ArduinoOcpp {
+
+class OcppEngine;
+
+class ResetService {
+private:
+    OcppEngine& context;
+
+    std::function<bool(bool isHard)> preReset; //true: reset is possible; false: reject reset; Await: need more time to determine
+    std::function<void(bool isHard)> executeReset; //please disconnect WebSocket (AO remains initialized), shut down device and restart with normal initialization routine; on failure reconnect WebSocket
+    unsigned int outstandingResetRetries = 0; //0 = do not reset device
+    bool isHardReset = false;
+    unsigned long t_resetRetry;
+
+    std::shared_ptr<Configuration<int>> resetRetries;
+
+public:
+    ResetService(OcppEngine& context);
+
+    ~ResetService();
+    
+    void loop();
+
+    void setPreReset(std::function<bool(bool isHard)> preReset);
+    std::function<bool(bool isHard)> getPreReset();
+
+    void setExecuteReset(std::function<void(bool isHard)> executeReset);
+    std::function<void(bool isHard)> getExecuteReset();
+
+    void initiateReset(bool isHard);
+};
+
+} //end namespace ArduinoOcpp
+
+#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+
+namespace ArduinoOcpp {
+
+std::function<void(bool isHard)> makeDefaultResetFn();
+
+}
+
+#endif //AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+
+#endif

From e972be64593696a63c527c92d83b67ef6c7ca041 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 22 May 2023 15:21:33 +0200
Subject: [PATCH 246/549] fix compiler warnings

---
 .../MessagesV16/ChangeAvailability.cpp        | 11 ++++++++--
 .../MessagesV16/ChangeAvailability.h          |  4 ++++
 .../MessagesV16/GetCompositeSchedule.cpp      | 20 +++++++++--------
 src/ArduinoOcpp/MessagesV16/ReserveNow.cpp    |  3 +--
 .../MessagesV16/TriggerMessage.cpp            |  2 +-
 .../Tasks/Reservation/ReservationService.cpp  | 22 +++++++------------
 6 files changed, 34 insertions(+), 28 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
index 18126524..95f31787 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
@@ -19,8 +19,15 @@ const char* ChangeAvailability::getOcppOperationType(){
 }
 
 void ChangeAvailability::processReq(JsonObject payload) {
-    int connectorId = payload["connectorId"] | -1;
-    if (connectorId < 0 || connectorId >= context.getNumConnectors()) {
+    int connectorIdRaw = payload["connectorId"] | -1;
+    if (connectorIdRaw < 0) {
+        errorCode = "FormationViolation";
+        return;
+    }
+    unsigned int connectorId = (unsigned int) connectorIdRaw;
+
+    if (connectorId >= context.getNumConnectors()) {
+        errorCode = "PropertyConstraintViolation";
         return;
     }
 
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
index fbc36586..e9690028 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
+++ b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
@@ -18,6 +18,8 @@ class ChangeAvailability : public OcppMessage {
     OcppModel& context;
     bool scheduled = false;
     bool accepted = false;
+
+    const char *errorCode {nullptr};
 public:
     ChangeAvailability(OcppModel& context);
 
@@ -26,6 +28,8 @@ class ChangeAvailability : public OcppMessage {
     void processReq(JsonObject payload);
 
     std::unique_ptr<DynamicJsonDocument> createConf();
+
+    const char *getErrorCode() {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
index 472df037..2c404f95 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
@@ -24,6 +24,16 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
 
     connectorId = payload["connectorId"] | -1;
     duration = payload["duration"] | 0;
+
+    if (connectorId < 0 || !payload.containsKey("duration")) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    if ((unsigned int) connectorId >= context.getNumConnectors()) {
+        errorCode = "PropertyConstraintViolation";
+    }
+
     auto unitString =  payload["chargingRateUnit"] | "W";
 
     if (unitString[0] == 'A' || unitString[0] == 'a') {
@@ -34,14 +44,6 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
         errorCode = "PropertyConstraintViolation";
     }
 
-    if (connectorId >= context.getNumConnectors()) {
-        errorCode = "PropertyConstraintViolation";
-    }
-
-    if (connectorId < 0 || !payload.containsKey("duration")) {
-        errorCode = "FormationViolation";
-    }
-
     if (!context.getSmartChargingService()) {
         AO_DBG_ERR("SmartChargingService not initialized! Ignore request");
         errorCode = "NotSupported";
@@ -55,7 +57,7 @@ std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
         return createEmptyDocument();
     }
 
-    ChargingSchedule *composite = scService->getCompositeSchedule(connectorId, duration);
+    ChargingSchedule *composite = scService->getCompositeSchedule((unsigned int) connectorId, duration);
     DynamicJsonDocument *compositeJson {nullptr};
 
     if (composite) {
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
index ccc2a8d9..d936bf4f 100644
--- a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
@@ -40,12 +40,11 @@ void ReserveNow::processReq(JsonObject payload) {
         return;
     }
 
-    int connectorId = payload["connectorId"];
+    unsigned int connectorId = payload["connectorId"];
 
     if (context.getReservationService() &&
                 context.getNumConnectors() > 0) {
         auto rService = context.getReservationService();
-        auto cpService = context.getChargeControlService();
         auto chargePoint = context.getConnector(0);
 
         if (connectorId >= context.getNumConnectors()) {
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
index 78d0673b..8122361d 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
@@ -47,7 +47,7 @@ void TriggerMessage::processReq(JsonObject payload) {
         unsigned int cIdRangeBegin = 0, cIdRangeEnd = 0;
         if (connectorId < 0) {
             cIdRangeEnd = context.getNumConnectors();
-        } else if (connectorId < context.getNumConnectors()) {
+        } else if ((unsigned int) connectorId < context.getNumConnectors()) {
             cIdRangeBegin = connectorId;
             cIdRangeEnd = connectorId + 1;
         } else {
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index d3ea812f..5360c252 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -43,10 +43,6 @@ ReservationService::ReservationService(OcppEngine& context, unsigned int numConn
 
 void ReservationService::loop() {
     //check if to end reservations
-    auto cpService = context.getOcppModel().getChargeControlService();
-    if (!cpService) {
-        return;
-    }
 
     for (Reservation& reservation : reservations) {
         if (!reservation.isActive()) {
@@ -162,16 +158,14 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
     }
 
     unsigned int availableCount = 0;
-    if (auto cpService = context.getOcppModel().getChargeControlService()) {
-        for (unsigned int cId = 1; cId < context.getOcppModel().getNumConnectors(); cId++) {
-            if (cId == (int) connectorId) {
-                //don't count this connector
-                continue;
-            }
-            if (auto connector = context.getOcppModel().getConnector(cId)) {
-                if (connector->inferenceStatus() == OcppEvseState::Available) {
-                    availableCount++;
-                }
+    for (unsigned int cId = 1; cId < context.getOcppModel().getNumConnectors(); cId++) {
+        if (cId == connectorId) {
+            //don't count this connector
+            continue;
+        }
+        if (auto connector = context.getOcppModel().getConnector(cId)) {
+            if (connector->inferenceStatus() == OcppEvseState::Available) {
+                availableCount++;
             }
         }
     }

From ca03b132d89a6e2d05b0fa76f2d68b232ad0c2f7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 22 May 2023 15:30:07 +0200
Subject: [PATCH 247/549] remove superfluous includes

---
 src/ArduinoOcpp/MessagesV16/Authorize.cpp                       | 1 -
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp                     | 1 -
 src/ArduinoOcpp/MessagesV16/StartTransaction.cpp                | 1 -
 src/ArduinoOcpp/MessagesV16/StatusNotification.cpp              | 1 -
 src/ArduinoOcpp/MessagesV16/StopTransaction.cpp                 | 1 -
 src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp                 | 1 -
 src/ArduinoOcpp/Tasks/Boot/BootService.cpp                      | 1 -
 src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp               | 1 -
 src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp | 1 -
 src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp    | 1 -
 tests/ChargingSessions.cpp                                      | 1 -
 tests/ConfigurationBehavior.cpp                                 | 1 -
 tests/TransactionSafety.cpp                                     | 1 -
 13 files changed, 13 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.cpp b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
index 4c5ca1aa..707cecb0 100644
--- a/src/ArduinoOcpp/MessagesV16/Authorize.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
@@ -5,7 +5,6 @@
 #include <ArduinoOcpp/MessagesV16/Authorize.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index 5f77a362..99013807 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -4,7 +4,6 @@
 
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index e945cadb..1f89b5a6 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -6,7 +6,6 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OperationStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index 6251e425..be4db21f 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -4,7 +4,6 @@
 
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Debug.h>
 
 #include <string.h>
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index b242425d..e1c42d69 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -6,7 +6,6 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OperationStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
index 08cf8f11..9c41e057 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
@@ -4,7 +4,6 @@
 
 #include <ArduinoOcpp/MessagesV16/UnlockConnector.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::UnlockConnector;
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
index 8bfa83bd..a34c927a 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
@@ -8,7 +8,6 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index 55299bee..c9d2676a 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -7,7 +7,6 @@
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/OcppOperation.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index ae2f3942..cbb64044 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -6,7 +6,6 @@
 #include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
 #include <ArduinoOcpp/Platform.h>
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index 7bb55899..c2cd85e9 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -5,7 +5,6 @@
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
 #include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 41eb1c6f..7e4066c6 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -3,7 +3,6 @@
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index f4d64304..6c0820f3 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -5,7 +5,6 @@
 #include <ArduinoOcpp/Core/OcppMessage.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index dc244d3a..fa62bd88 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -3,7 +3,6 @@
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
 #include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>

From 1c784bd38ec9ba1abc1ffda8b3210f2ad8dc9719 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 22 May 2023 15:46:28 +0200
Subject: [PATCH 248/549] change name of ChargeControlService

---
 CMakeLists.txt                                     |  2 +-
 src/ArduinoOcpp.cpp                                |  6 +++---
 src/ArduinoOcpp/Core/OcppModel.cpp                 | 14 +++++++-------
 src/ArduinoOcpp/Core/OcppModel.h                   |  8 ++++----
 ...eControlService.cpp => ChargeControlCommon.cpp} |  6 +++---
 ...hargeControlService.h => ChargeControlCommon.h} |  8 ++++----
 6 files changed, 22 insertions(+), 22 deletions(-)
 rename src/ArduinoOcpp/Tasks/ChargeControl/{ChargeControlService.cpp => ChargeControlCommon.cpp} (95%)
 rename src/ArduinoOcpp/Tasks/ChargeControl/{ChargeControlService.h => ChargeControlCommon.h} (56%)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 618d2a4f..7e785555 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -56,7 +56,7 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
     src/ArduinoOcpp/Tasks/Boot/BootService.cpp
-    src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
+    src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
     src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
     src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
     src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index ad84b814..82d48ef6 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -8,7 +8,7 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h>
 #include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
@@ -141,8 +141,8 @@ void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredent
         new TransactionStore(AO_NUMCONNECTORS, filesystem)));
     model.setBootService(std::unique_ptr<BootService>(
         new BootService(*ocppEngine)));
-    model.setChargeControlService(std::unique_ptr<ChargeControlService>(
-        new ChargeControlService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
+    model.setChargeControlCommon(std::unique_ptr<ChargeControlCommon>(
+        new ChargeControlCommon(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
     std::vector<Connector> connectors;
     for (unsigned int connectorId = 0; connectorId < AO_NUMCONNECTORS; connectorId++) {
         connectors.push_back(Connector(*ocppEngine, connectorId));
diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/OcppModel.cpp
index 18c075c1..16dfa3f6 100644
--- a/src/ArduinoOcpp/Core/OcppModel.cpp
+++ b/src/ArduinoOcpp/Core/OcppModel.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Core/OcppModel.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
@@ -40,8 +40,8 @@ void OcppModel::loop() {
         connector.loop();
     }
 
-    if (chargeControlService)
-        chargeControlService->loop();
+    if (chargeControlCommon)
+        chargeControlCommon->loop();
     
     if (smartChargingService)
         smartChargingService->loop();
@@ -78,12 +78,12 @@ SmartChargingService* OcppModel::getSmartChargingService() const {
     return smartChargingService.get();
 }
 
-void OcppModel::setChargeControlService(std::unique_ptr<ChargeControlService> ccs) {
-    chargeControlService = std::move(ccs);
+void OcppModel::setChargeControlCommon(std::unique_ptr<ChargeControlCommon> ccs) {
+    chargeControlCommon = std::move(ccs);
 }
 
-ChargeControlService *OcppModel::getChargeControlService() {
-    return chargeControlService.get();
+ChargeControlCommon *OcppModel::getChargeControlCommon() {
+    return chargeControlCommon.get();
 }
 
 void OcppModel::setConnectors(std::vector<Connector>&& connectors) {
diff --git a/src/ArduinoOcpp/Core/OcppModel.h b/src/ArduinoOcpp/Core/OcppModel.h
index b00a0688..bda19104 100644
--- a/src/ArduinoOcpp/Core/OcppModel.h
+++ b/src/ArduinoOcpp/Core/OcppModel.h
@@ -14,7 +14,7 @@ namespace ArduinoOcpp {
 
 class TransactionStore;
 class SmartChargingService;
-class ChargeControlService;
+class ChargeControlCommon;
 class MeteringService;
 class FirmwareService;
 class DiagnosticsService;
@@ -29,7 +29,7 @@ class OcppModel {
     std::vector<Connector> connectors;
     std::unique_ptr<TransactionStore> transactionStore;
     std::unique_ptr<SmartChargingService> smartChargingService;
-    std::unique_ptr<ChargeControlService> chargeControlService;
+    std::unique_ptr<ChargeControlCommon> chargeControlCommon;
     std::unique_ptr<MeteringService> meteringService;
     std::unique_ptr<FirmwareService> firmwareService;
     std::unique_ptr<DiagnosticsService> diagnosticsService;
@@ -58,8 +58,8 @@ class OcppModel {
     void setSmartChargingService(std::unique_ptr<SmartChargingService> scs);
     SmartChargingService* getSmartChargingService() const;
 
-    void setChargeControlService(std::unique_ptr<ChargeControlService> ccs);
-    ChargeControlService *getChargeControlService();
+    void setChargeControlCommon(std::unique_ptr<ChargeControlCommon> ccs);
+    ChargeControlCommon *getChargeControlCommon();
 
     void setConnectors(std::vector<Connector>&& connectors);
     unsigned int getNumConnectors() const;
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
similarity index 95%
rename from src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
rename to src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
index 76b46afc..df5ca185 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
@@ -4,7 +4,7 @@
 
 #include <string>
 
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h>
+#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h>
 #include <ArduinoOcpp/Core/OcppEngine.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
@@ -26,7 +26,7 @@
 
 using namespace ArduinoOcpp;
 
-ChargeControlService::ChargeControlService(OcppEngine& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
+ChargeControlCommon::ChargeControlCommon(OcppEngine& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context) {
     
     std::shared_ptr<Configuration<int>> numberOfConnectors =
@@ -91,6 +91,6 @@ ChargeControlService::ChargeControlService(OcppEngine& context, unsigned int num
         return new Ocpp16::StopTransaction(context.getOcppModel(), nullptr);});
 }
 
-void ChargeControlService::loop() {
+void ChargeControlCommon::loop() {
     //do nothing
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h
similarity index 56%
rename from src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h
rename to src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h
index 3ea53697..1270bd2a 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlService.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef CHARGECONTROLSERVICE_H
-#define CHARGECONTROLSERVICE_H
+#ifndef CHARGECONTROLCOMMON_H
+#define CHARGECONTROLCOMMON_H
 
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
@@ -11,11 +11,11 @@ namespace ArduinoOcpp {
 
 class OcppEngine;
 
-class ChargeControlService {
+class ChargeControlCommon {
 private:
     OcppEngine& context;
 public:
-    ChargeControlService(OcppEngine& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+    ChargeControlCommon(OcppEngine& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
     void loop();
 };

From 623d0e271176fea3919831f60c2f4c1c5b685cc4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 May 2023 14:11:08 +0200
Subject: [PATCH 249/549] rename Core modules - split 1

---
 src/ArduinoOcpp/Core/{OcppSocket.cpp => Connection.cpp} | 0
 src/ArduinoOcpp/Core/{OcppSocket.h => Connection.h}     | 0
 src/ArduinoOcpp/Core/{OcppEngine.cpp => Context.cpp}    | 0
 src/ArduinoOcpp/Core/{OcppEngine.h => Context.h}        | 0
 src/ArduinoOcpp/Core/{OcppModel.cpp => Model.cpp}       | 0
 src/ArduinoOcpp/Core/{OcppModel.h => Model.h}           | 0
 6 files changed, 0 insertions(+), 0 deletions(-)
 rename src/ArduinoOcpp/Core/{OcppSocket.cpp => Connection.cpp} (100%)
 rename src/ArduinoOcpp/Core/{OcppSocket.h => Connection.h} (100%)
 rename src/ArduinoOcpp/Core/{OcppEngine.cpp => Context.cpp} (100%)
 rename src/ArduinoOcpp/Core/{OcppEngine.h => Context.h} (100%)
 rename src/ArduinoOcpp/Core/{OcppModel.cpp => Model.cpp} (100%)
 rename src/ArduinoOcpp/Core/{OcppModel.h => Model.h} (100%)

diff --git a/src/ArduinoOcpp/Core/OcppSocket.cpp b/src/ArduinoOcpp/Core/Connection.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppSocket.cpp
rename to src/ArduinoOcpp/Core/Connection.cpp
diff --git a/src/ArduinoOcpp/Core/OcppSocket.h b/src/ArduinoOcpp/Core/Connection.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppSocket.h
rename to src/ArduinoOcpp/Core/Connection.h
diff --git a/src/ArduinoOcpp/Core/OcppEngine.cpp b/src/ArduinoOcpp/Core/Context.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppEngine.cpp
rename to src/ArduinoOcpp/Core/Context.cpp
diff --git a/src/ArduinoOcpp/Core/OcppEngine.h b/src/ArduinoOcpp/Core/Context.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppEngine.h
rename to src/ArduinoOcpp/Core/Context.h
diff --git a/src/ArduinoOcpp/Core/OcppModel.cpp b/src/ArduinoOcpp/Core/Model.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppModel.cpp
rename to src/ArduinoOcpp/Core/Model.cpp
diff --git a/src/ArduinoOcpp/Core/OcppModel.h b/src/ArduinoOcpp/Core/Model.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppModel.h
rename to src/ArduinoOcpp/Core/Model.h

From 2d1eda6d74b6249a0265fe099f3540bf89666b1e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 May 2023 14:12:43 +0200
Subject: [PATCH 250/549] rename Core modules - split 2

---
 src/ArduinoOcpp/Core/{OcppMessage.cpp => Operation.cpp}           | 0
 src/ArduinoOcpp/Core/{OcppMessage.h => Operation.h}               | 0
 src/ArduinoOcpp/Core/{OcppOperation.cpp => Request.cpp}           | 0
 src/ArduinoOcpp/Core/{OcppOperation.h => Request.h}               | 0
 .../Core/{OcppOperationCallbacks.h => RequestCallbacks.h}         | 0
 5 files changed, 0 insertions(+), 0 deletions(-)
 rename src/ArduinoOcpp/Core/{OcppMessage.cpp => Operation.cpp} (100%)
 rename src/ArduinoOcpp/Core/{OcppMessage.h => Operation.h} (100%)
 rename src/ArduinoOcpp/Core/{OcppOperation.cpp => Request.cpp} (100%)
 rename src/ArduinoOcpp/Core/{OcppOperation.h => Request.h} (100%)
 rename src/ArduinoOcpp/Core/{OcppOperationCallbacks.h => RequestCallbacks.h} (100%)

diff --git a/src/ArduinoOcpp/Core/OcppMessage.cpp b/src/ArduinoOcpp/Core/Operation.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppMessage.cpp
rename to src/ArduinoOcpp/Core/Operation.cpp
diff --git a/src/ArduinoOcpp/Core/OcppMessage.h b/src/ArduinoOcpp/Core/Operation.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppMessage.h
rename to src/ArduinoOcpp/Core/Operation.h
diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/Request.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppOperation.cpp
rename to src/ArduinoOcpp/Core/Request.cpp
diff --git a/src/ArduinoOcpp/Core/OcppOperation.h b/src/ArduinoOcpp/Core/Request.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppOperation.h
rename to src/ArduinoOcpp/Core/Request.h
diff --git a/src/ArduinoOcpp/Core/OcppOperationCallbacks.h b/src/ArduinoOcpp/Core/RequestCallbacks.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppOperationCallbacks.h
rename to src/ArduinoOcpp/Core/RequestCallbacks.h

From 9720ae63e91a6faf3169fa2616cfdfd459262e8c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 May 2023 14:14:47 +0200
Subject: [PATCH 251/549] rename Core modules - split 3

---
 src/ArduinoOcpp/Core/{OcppConnection.cpp => RequestQueue.cpp} | 0
 src/ArduinoOcpp/Core/{OcppConnection.h => RequestQueue.h}     | 0
 src/ArduinoOcpp/Core/{OperationStore.cpp => RequestStore.cpp} | 0
 src/ArduinoOcpp/Core/{OperationStore.h => RequestStore.h}     | 0
 src/ArduinoOcpp/Core/{OcppTime.cpp => Time.cpp}               | 0
 src/ArduinoOcpp/Core/{OcppTime.h => Time.h}                   | 0
 6 files changed, 0 insertions(+), 0 deletions(-)
 rename src/ArduinoOcpp/Core/{OcppConnection.cpp => RequestQueue.cpp} (100%)
 rename src/ArduinoOcpp/Core/{OcppConnection.h => RequestQueue.h} (100%)
 rename src/ArduinoOcpp/Core/{OperationStore.cpp => RequestStore.cpp} (100%)
 rename src/ArduinoOcpp/Core/{OperationStore.h => RequestStore.h} (100%)
 rename src/ArduinoOcpp/Core/{OcppTime.cpp => Time.cpp} (100%)
 rename src/ArduinoOcpp/Core/{OcppTime.h => Time.h} (100%)

diff --git a/src/ArduinoOcpp/Core/OcppConnection.cpp b/src/ArduinoOcpp/Core/RequestQueue.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppConnection.cpp
rename to src/ArduinoOcpp/Core/RequestQueue.cpp
diff --git a/src/ArduinoOcpp/Core/OcppConnection.h b/src/ArduinoOcpp/Core/RequestQueue.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppConnection.h
rename to src/ArduinoOcpp/Core/RequestQueue.h
diff --git a/src/ArduinoOcpp/Core/OperationStore.cpp b/src/ArduinoOcpp/Core/RequestStore.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OperationStore.cpp
rename to src/ArduinoOcpp/Core/RequestStore.cpp
diff --git a/src/ArduinoOcpp/Core/OperationStore.h b/src/ArduinoOcpp/Core/RequestStore.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OperationStore.h
rename to src/ArduinoOcpp/Core/RequestStore.h
diff --git a/src/ArduinoOcpp/Core/OcppTime.cpp b/src/ArduinoOcpp/Core/Time.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppTime.cpp
rename to src/ArduinoOcpp/Core/Time.cpp
diff --git a/src/ArduinoOcpp/Core/OcppTime.h b/src/ArduinoOcpp/Core/Time.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppTime.h
rename to src/ArduinoOcpp/Core/Time.h

From ed19fd1a8e466eb4a44546413762c8e32963f11a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 May 2023 14:28:33 +0200
Subject: [PATCH 252/549] rename Core modules - split 4

---
 .../{OperationDeserializer.cpp => Core/OperationRegistry.cpp}     | 0
 .../{OperationDeserializer.h => Core/OperationRegistry.h}         | 0
 .../Core/{OperationsQueue.cpp => RequestQueueStorageStrategy.cpp} | 0
 .../Core/{OperationsQueue.h => RequestQueueStorageStrategy.h}     | 0
 .../SimpleRequestFactory.cpp}                                     | 0
 .../{SimpleOcppOperationFactory.h => Core/SimpleRequestFactory.h} | 0
 6 files changed, 0 insertions(+), 0 deletions(-)
 rename src/ArduinoOcpp/{OperationDeserializer.cpp => Core/OperationRegistry.cpp} (100%)
 rename src/ArduinoOcpp/{OperationDeserializer.h => Core/OperationRegistry.h} (100%)
 rename src/ArduinoOcpp/Core/{OperationsQueue.cpp => RequestQueueStorageStrategy.cpp} (100%)
 rename src/ArduinoOcpp/Core/{OperationsQueue.h => RequestQueueStorageStrategy.h} (100%)
 rename src/ArduinoOcpp/{SimpleOcppOperationFactory.cpp => Core/SimpleRequestFactory.cpp} (100%)
 rename src/ArduinoOcpp/{SimpleOcppOperationFactory.h => Core/SimpleRequestFactory.h} (100%)

diff --git a/src/ArduinoOcpp/OperationDeserializer.cpp b/src/ArduinoOcpp/Core/OperationRegistry.cpp
similarity index 100%
rename from src/ArduinoOcpp/OperationDeserializer.cpp
rename to src/ArduinoOcpp/Core/OperationRegistry.cpp
diff --git a/src/ArduinoOcpp/OperationDeserializer.h b/src/ArduinoOcpp/Core/OperationRegistry.h
similarity index 100%
rename from src/ArduinoOcpp/OperationDeserializer.h
rename to src/ArduinoOcpp/Core/OperationRegistry.h
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.cpp b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OperationsQueue.cpp
rename to src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
diff --git a/src/ArduinoOcpp/Core/OperationsQueue.h b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OperationsQueue.h
rename to src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.cpp b/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
similarity index 100%
rename from src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
rename to src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
diff --git a/src/ArduinoOcpp/SimpleOcppOperationFactory.h b/src/ArduinoOcpp/Core/SimpleRequestFactory.h
similarity index 100%
rename from src/ArduinoOcpp/SimpleOcppOperationFactory.h
rename to src/ArduinoOcpp/Core/SimpleRequestFactory.h

From 55666523971d5c327e1d12e0fb63d13203eac03e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 May 2023 16:41:05 +0200
Subject: [PATCH 253/549] rename Core modules - split 5

---
 CMakeLists.txt                                |  22 +-
 examples/ESP-IDF/main/main.c                  |   4 +-
 examples/ESP-TLS/main.cpp                     |   4 +-
 src/ArduinoOcpp.cpp                           | 248 +++++++++---------
 src/ArduinoOcpp.h                             |  22 +-
 src/ArduinoOcpp/Core/Connection.cpp           |  22 +-
 src/ArduinoOcpp/Core/Connection.h             |  12 +-
 src/ArduinoOcpp/Core/Context.cpp              |  62 ++---
 src/ArduinoOcpp/Core/Context.h                |  38 +--
 src/ArduinoOcpp/Core/Model.cpp                |  62 ++---
 src/ArduinoOcpp/Core/Model.h                  |  16 +-
 src/ArduinoOcpp/Core/OcppError.h              |   6 +-
 src/ArduinoOcpp/Core/Operation.cpp            |  26 +-
 src/ArduinoOcpp/Core/Operation.h              |  16 +-
 src/ArduinoOcpp/Core/OperationRegistry.cpp    |  32 +--
 src/ArduinoOcpp/Core/OperationRegistry.h      |  22 +-
 src/ArduinoOcpp/Core/Request.cpp              | 108 ++++----
 src/ArduinoOcpp/Core/Request.h                |  22 +-
 src/ArduinoOcpp/Core/RequestQueue.cpp         |  58 ++--
 src/ArduinoOcpp/Core/RequestQueue.h           |  28 +-
 .../Core/RequestQueueStorageStrategy.cpp      |  40 +--
 .../Core/RequestQueueStorageStrategy.h        |  54 ++--
 src/ArduinoOcpp/Core/RequestStore.cpp         |  12 +-
 src/ArduinoOcpp/Core/RequestStore.h           |  16 +-
 src/ArduinoOcpp/Core/SimpleRequestFactory.cpp |  14 +-
 src/ArduinoOcpp/Core/SimpleRequestFactory.h   |   8 +-
 src/ArduinoOcpp/Core/Time.cpp                 |  62 ++---
 src/ArduinoOcpp/Core/Time.h                   |  66 ++---
 src/ArduinoOcpp/MessagesV16/Authorize.cpp     |  10 +-
 src/ArduinoOcpp/MessagesV16/Authorize.h       |  12 +-
 .../MessagesV16/BootNotification.cpp          |  18 +-
 .../MessagesV16/BootNotification.h            |  12 +-
 .../MessagesV16/CancelReservation.cpp         |  10 +-
 .../MessagesV16/CancelReservation.h           |  12 +-
 .../MessagesV16/ChangeAvailability.cpp        |  14 +-
 .../MessagesV16/ChangeAvailability.h          |  12 +-
 .../MessagesV16/ChangeConfiguration.cpp       |   2 +-
 .../MessagesV16/ChangeConfiguration.h         |   6 +-
 src/ArduinoOcpp/MessagesV16/ClearCache.cpp    |   2 +-
 src/ArduinoOcpp/MessagesV16/ClearCache.h      |   6 +-
 .../MessagesV16/ClearChargingProfile.cpp      |   8 +-
 .../MessagesV16/ClearChargingProfile.h        |  12 +-
 src/ArduinoOcpp/MessagesV16/CustomMessage.cpp |   2 +-
 src/ArduinoOcpp/MessagesV16/CustomMessage.h   |   6 +-
 src/ArduinoOcpp/MessagesV16/DataTransfer.cpp  |   2 +-
 src/ArduinoOcpp/MessagesV16/DataTransfer.h    |   6 +-
 .../DiagnosticsStatusNotification.cpp         |   4 +-
 .../DiagnosticsStatusNotification.h           |   6 +-
 .../FirmwareStatusNotification.cpp            |   4 +-
 .../MessagesV16/FirmwareStatusNotification.h  |   6 +-
 .../MessagesV16/GetCompositeSchedule.cpp      |  14 +-
 .../MessagesV16/GetCompositeSchedule.h        |  14 +-
 .../MessagesV16/GetConfiguration.cpp          |   2 +-
 .../MessagesV16/GetConfiguration.h            |   6 +-
 .../MessagesV16/GetDiagnostics.cpp            |   6 +-
 src/ArduinoOcpp/MessagesV16/GetDiagnostics.h  |  18 +-
 .../MessagesV16/GetLocalListVersion.cpp       |   8 +-
 .../MessagesV16/GetLocalListVersion.h         |  12 +-
 src/ArduinoOcpp/MessagesV16/Heartbeat.cpp     |  14 +-
 src/ArduinoOcpp/MessagesV16/Heartbeat.h       |  12 +-
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp   |   4 +-
 src/ArduinoOcpp/MessagesV16/MeterValues.h     |   8 +-
 .../MessagesV16/RemoteStartTransaction.cpp    |  20 +-
 .../MessagesV16/RemoteStartTransaction.h      |  12 +-
 .../MessagesV16/RemoteStopTransaction.cpp     |  10 +-
 .../MessagesV16/RemoteStopTransaction.h       |  12 +-
 src/ArduinoOcpp/MessagesV16/ReserveNow.cpp    |  20 +-
 src/ArduinoOcpp/MessagesV16/ReserveNow.h      |  12 +-
 src/ArduinoOcpp/MessagesV16/Reset.cpp         |  12 +-
 src/ArduinoOcpp/MessagesV16/Reset.h           |  12 +-
 src/ArduinoOcpp/MessagesV16/SendLocalList.cpp |   8 +-
 src/ArduinoOcpp/MessagesV16/SendLocalList.h   |  12 +-
 .../MessagesV16/SetChargingProfile.cpp        |  12 +-
 .../MessagesV16/SetChargingProfile.h          |  14 +-
 .../MessagesV16/StartTransaction.cpp          |  20 +-
 .../MessagesV16/StartTransaction.h            |  14 +-
 .../MessagesV16/StatusNotification.cpp        |  14 +-
 .../MessagesV16/StatusNotification.h          |  12 +-
 .../MessagesV16/StopTransaction.cpp           |  30 +--
 src/ArduinoOcpp/MessagesV16/StopTransaction.h |  16 +-
 .../MessagesV16/TriggerMessage.cpp            |  28 +-
 src/ArduinoOcpp/MessagesV16/TriggerMessage.h  |  16 +-
 .../MessagesV16/UnlockConnector.cpp           |   8 +-
 src/ArduinoOcpp/MessagesV16/UnlockConnector.h |  12 +-
 .../MessagesV16/UpdateFirmware.cpp            |   6 +-
 src/ArduinoOcpp/MessagesV16/UpdateFirmware.h  |  16 +-
 .../Tasks/Authorization/AuthorizationData.cpp |   2 +-
 .../Tasks/Authorization/AuthorizationData.h   |   6 +-
 .../Authorization/AuthorizationService.h      |   6 +-
 src/ArduinoOcpp/Tasks/Boot/BootService.cpp    |  16 +-
 src/ArduinoOcpp/Tasks/Boot/BootService.h      |   6 +-
 .../ChargeControl/ChargeControlCommon.cpp     |  50 ++--
 .../Tasks/ChargeControl/ChargeControlCommon.h |   6 +-
 .../Tasks/ChargeControl/Connector.cpp         |  48 ++--
 .../Tasks/ChargeControl/Connector.h           |  12 +-
 .../Tasks/Diagnostics/DiagnosticsService.cpp  |  36 +--
 .../Tasks/Diagnostics/DiagnosticsService.h    |  26 +-
 .../FirmwareManagement/FirmwareService.cpp    |  44 ++--
 .../FirmwareManagement/FirmwareService.h      |  18 +-
 .../Tasks/Heartbeat/HeartbeatService.cpp      |  14 +-
 .../Tasks/Heartbeat/HeartbeatService.h        |   6 +-
 .../Metering/ConnectorMeterValuesRecorder.cpp |  28 +-
 .../Metering/ConnectorMeterValuesRecorder.h   |  14 +-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp |   4 +-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.h   |   8 +-
 .../Tasks/Metering/MeteringService.cpp        |  18 +-
 .../Tasks/Metering/MeteringService.h          |  10 +-
 .../Tasks/Reservation/Reservation.cpp         |   8 +-
 .../Tasks/Reservation/Reservation.h           |  12 +-
 .../Tasks/Reservation/ReservationService.cpp  |  26 +-
 .../Tasks/Reservation/ReservationService.h    |   6 +-
 src/ArduinoOcpp/Tasks/Reset/ResetService.cpp  |  20 +-
 src/ArduinoOcpp/Tasks/Reset/ResetService.h    |   6 +-
 .../SmartCharging/SmartChargingModel.cpp      |  12 +-
 .../Tasks/SmartCharging/SmartChargingModel.h  |  16 +-
 .../SmartCharging/SmartChargingService.cpp    |  56 ++--
 .../SmartCharging/SmartChargingService.h      |  14 +-
 .../Tasks/Transactions/Transaction.h          |  20 +-
 .../Tasks/Transactions/TransactionStore.cpp   |   2 +-
 src/ArduinoOcpp_c.cpp                         |  32 +--
 src/ArduinoOcpp_c.h                           |  34 +--
 tests/ChargingSessions.cpp                    |  22 +-
 tests/ConfigurationBehavior.cpp               |  38 +--
 tests/TransactionSafety.cpp                   |  14 +-
 tests/ocppEngineLifecycle.cpp                 |  14 +-
 125 files changed, 1235 insertions(+), 1235 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 7e785555..1e49088e 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -11,15 +11,15 @@ set(AO_SRC
     src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
     src/ArduinoOcpp/Core/FilesystemAdapter.cpp
     src/ArduinoOcpp/Core/FilesystemUtils.cpp
-    src/ArduinoOcpp/Core/OcppConnection.cpp
-    src/ArduinoOcpp/Core/OcppEngine.cpp
-    src/ArduinoOcpp/Core/OcppMessage.cpp
-    src/ArduinoOcpp/Core/OcppModel.cpp
-    src/ArduinoOcpp/Core/OcppOperation.cpp
-    src/ArduinoOcpp/Core/OcppSocket.cpp
-    src/ArduinoOcpp/Core/OcppTime.cpp
-    src/ArduinoOcpp/Core/OperationsQueue.cpp
-    src/ArduinoOcpp/Core/OperationStore.cpp
+    src/ArduinoOcpp/Core/RequestQueue.cpp
+    src/ArduinoOcpp/Core/Context.cpp
+    src/ArduinoOcpp/Core/Operation.cpp
+    src/ArduinoOcpp/Core/Model.cpp
+    src/ArduinoOcpp/Core/Request.cpp
+    src/ArduinoOcpp/Core/Connection.cpp
+    src/ArduinoOcpp/Core/Time.cpp
+    src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
+    src/ArduinoOcpp/Core/RequestStore.cpp
     src/ArduinoOcpp/MessagesV16/Authorize.cpp
     src/ArduinoOcpp/MessagesV16/BootNotification.cpp
     src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
@@ -50,8 +50,8 @@ set(AO_SRC
     src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
     src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
     src/ArduinoOcpp/Platform.cpp
-    src/ArduinoOcpp/SimpleOcppOperationFactory.cpp
-    src/ArduinoOcpp/OperationDeserializer.cpp
+    src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
+    src/ArduinoOcpp/Core/OperationRegistry.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
     src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
diff --git a/examples/ESP-IDF/main/main.c b/examples/ESP-IDF/main/main.c
index 14b7b005..b32fcaf1 100644
--- a/examples/ESP-IDF/main/main.c
+++ b/examples/ESP-IDF/main/main.c
@@ -156,7 +156,7 @@ void app_main(void)
     /* Initialize ArduinoOcpp */
     struct AO_FilesystemOpt fsopt = { .use = true, .mount = true, .formatFsOnFail = true};
 
-    AOcppSocket *osock = ao_makeOcppSocket(&mgr,
+    AConnection *osock = ao_makeConnection(&mgr,
             EXAMPLE_AO_OCPP_BACKEND, 
             EXAMPLE_AO_CHARGEBOXID, 
             EXAMPLE_AO_AUTHORIZATIONKEY, "", fsopt);
@@ -171,7 +171,7 @@ void app_main(void)
     }
     
     /* Deallocate ressources */
-    ao_deinitOcppSocket(osock);
+    ao_deinitConnection(osock);
     ao_deinitialize();
     mg_mgr_free(&mgr);
     return;
diff --git a/examples/ESP-TLS/main.cpp b/examples/ESP-TLS/main.cpp
index d5e9c450..680f2e6e 100644
--- a/examples/ESP-TLS/main.cpp
+++ b/examples/ESP-TLS/main.cpp
@@ -14,7 +14,7 @@ ESP8266WiFiMulti WiFiMulti;
 #endif
 
 #include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/OcppSocket.h> //need for setting TLS credentials
+#include <ArduinoOcpp/Core/Connection.h> //need for setting TLS credentials
 
 #define STASSID  "YOUR_WIFI_SSID"
 #define STAPSK   "YOUR_WIFI_PW"
@@ -66,7 +66,7 @@ emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
 )EOF";
 
 WebSocketsClient wsockSecure {};
-ArduinoOcpp::EspWiFi::OcppClientSocket osockSecure {&wsockSecure};
+ArduinoOcpp::EspWiFi::WSClient osockSecure {&wsockSecure};
 
 void setup() {
 
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 82d48ef6..da093724 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -4,8 +4,8 @@
 
 #include "ArduinoOcpp.h"
 
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h>
@@ -17,8 +17,8 @@
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Tasks/Boot/BootService.h>
 #include <ArduinoOcpp/Tasks/Reset/ResetService.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
-#include <ArduinoOcpp/OperationDeserializer.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <ArduinoOcpp/Core/OperationRegistry.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
@@ -34,10 +34,10 @@ namespace Facade {
 
 #ifndef AO_CUSTOM_WS
 WebSocketsClient *webSocket {nullptr};
-OcppSocket *ocppSocket {nullptr};
+Connection *connection {nullptr};
 #endif
 
-OcppEngine *ocppEngine {nullptr};
+Context *context {nullptr};
 std::shared_ptr<FilesystemAdapter> filesystem;
 FilesystemOpt fileSystemOpt {};
 float voltage_eff {230.f};
@@ -57,7 +57,7 @@ using namespace ArduinoOcpp::Ocpp16;
 
 #ifndef AO_CUSTOM_WS
 void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
-    if (ocppEngine) {
+    if (context) {
         AO_DBG_WARN("Can't be called two times. Either restart ESP, or call OCPP_deinitialize() before");
         return;
     }
@@ -77,10 +77,10 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     // consider connection disconnected if pong is not received 2 times
     webSocket->enableHeartbeat(15000, 3000, 2); //comment this one out to for specific OCPP servers
 
-    delete ocppSocket;
-    ocppSocket = new EspWiFi::OcppClientSocket(webSocket);
+    delete connection;
+    connection = new EspWiFi::WSClient(webSocket);
 
-    OCPP_initialize(*ocppSocket, ChargerCredentials(chargePointModel, chargePointVendor), V_eff, fsOpt);
+    OCPP_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), V_eff, fsOpt);
 }
 #endif
 
@@ -118,8 +118,8 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
     }
 }
 
-void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredentials, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
-    if (ocppEngine) {
+void OCPP_initialize(Connection& connection, const char *bootNotificationCredentials, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
+    if (context) {
         AO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call OCPP_deinitialize() before");
         return;
     }
@@ -134,43 +134,43 @@ void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredent
     
     configuration_init(filesystem); //call before each other library call
 
-    ocppEngine = new OcppEngine(ocppSocket, Clocks::DEFAULT_CLOCK, filesystem);
-    auto& model = ocppEngine->getOcppModel();
+    context = new Context(connection, Clocks::DEFAULT_CLOCK, filesystem);
+    auto& model = context->getModel();
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
         new TransactionStore(AO_NUMCONNECTORS, filesystem)));
     model.setBootService(std::unique_ptr<BootService>(
-        new BootService(*ocppEngine)));
+        new BootService(*context)));
     model.setChargeControlCommon(std::unique_ptr<ChargeControlCommon>(
-        new ChargeControlCommon(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
+        new ChargeControlCommon(*context, AO_NUMCONNECTORS, filesystem)));
     std::vector<Connector> connectors;
     for (unsigned int connectorId = 0; connectorId < AO_NUMCONNECTORS; connectorId++) {
-        connectors.push_back(Connector(*ocppEngine, connectorId));
+        connectors.push_back(Connector(*context, connectorId));
     }
     model.setConnectors(std::move(connectors));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
-        new HeartbeatService(*ocppEngine)));
+        new HeartbeatService(*context)));
     model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
-        new AuthorizationService(*ocppEngine, filesystem)));
+        new AuthorizationService(*context, filesystem)));
     model.setReservationService(std::unique_ptr<ReservationService>(
-        new ReservationService(*ocppEngine, AO_NUMCONNECTORS)));
+        new ReservationService(*context, AO_NUMCONNECTORS)));
     model.setResetService(std::unique_ptr<ResetService>(
-        new ResetService(*ocppEngine)));
+        new ResetService(*context)));
     
 #if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
-        EspWiFi::makeFirmwareService(*ocppEngine, "1234578901"))); //instantiate FW service + ESP installation routine
+        EspWiFi::makeFirmwareService(*context, "1234578901"))); //instantiate FW service + ESP installation routine
 #else
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
-        new FirmwareService(*ocppEngine))); //only instantiate FW service
+        new FirmwareService(*context))); //only instantiate FW service
 #endif
 
 #if !defined(AO_CUSTOM_DIAGNOSTICS) && !defined(AO_CUSTOM_WS)
     model.setDiagnosticsService(std::unique_ptr<DiagnosticsService>(
-        EspWiFi::makeDiagnosticsService(*ocppEngine))); //will only return "Rejected" because client needs to implement logging
+        EspWiFi::makeDiagnosticsService(*context))); //will only return "Rejected" because client needs to implement logging
 #else
     model.setDiagnosticsService(std::unique_ptr<DiagnosticsService>(
-        new DiagnosticsService(*ocppEngine)));
+        new DiagnosticsService(*context)));
 #endif
 
 #if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
@@ -183,12 +183,12 @@ void OCPP_initialize(OcppSocket& ocppSocket, const char *bootNotificationCredent
 
 void OCPP_deinitialize() {
     
-    delete ocppEngine;
-    ocppEngine = nullptr;
+    delete context;
+    context = nullptr;
 
 #ifndef AO_CUSTOM_WS
-    delete ocppSocket;
-    ocppSocket = nullptr;
+    delete connection;
+    connection = nullptr;
     delete webSocket;
     webSocket = nullptr;
 #endif
@@ -200,16 +200,16 @@ void OCPP_deinitialize() {
 }
 
 void OCPP_loop() {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return;
     }
 
-    ocppEngine->loop();
+    context->loop();
 }
 
 void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
@@ -223,18 +223,18 @@ void bootNotification(const char *chargePointModel, const char *chargePointVendo
 }
 
 void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
 
     //store credentials for later TriggerMessage
-    if (auto bootService = ocppEngine->getOcppModel().getBootService()) {
+    if (auto bootService = context->getModel().getBootService()) {
         bootService->setChargePointCredentials(payload->as<JsonObject>());
     }
 
-    auto bootNotification = makeOcppOperation(
-        new BootNotification(ocppEngine->getOcppModel(), std::move(payload)));
+    auto bootNotification = makeRequest(
+        new BootNotification(context->getModel(), std::move(payload)));
     if (onConf)
         bootNotification->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -247,11 +247,11 @@ void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveCon
         bootNotification->setTimeout(timeout);
     else
         bootNotification->setTimeout(0);
-    ocppEngine->initiateOperation(std::move(bootNotification));
+    context->initiateRequest(std::move(bootNotification));
 }
 
 void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
@@ -259,8 +259,8 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return;
     }
-    auto authorize = makeOcppOperation(
-        new Authorize(ocppEngine->getOcppModel(), idTag));
+    auto authorize = makeRequest(
+        new Authorize(context->getModel(), idTag));
     if (onConf)
         authorize->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -273,11 +273,11 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
         authorize->setTimeout(timeout);
     else
         authorize->setTimeout(20000);
-    ocppEngine->initiateOperation(std::move(authorize));
+    context->initiateRequest(std::move(authorize));
 }
 
 bool beginTransaction(const char *idTag, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
@@ -285,7 +285,7 @@ bool beginTransaction(const char *idTag, unsigned int connectorId) {
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -295,7 +295,7 @@ bool beginTransaction(const char *idTag, unsigned int connectorId) {
 }
 
 bool beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
@@ -304,7 +304,7 @@ bool beginTransaction_authorized(const char *idTag, const char *parentIdTag, uns
         AO_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -314,11 +314,11 @@ bool beginTransaction_authorized(const char *idTag, const char *parentIdTag, uns
 }
 
 bool endTransaction(const char *reason, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -329,11 +329,11 @@ bool endTransaction(const char *reason, unsigned int connectorId) {
 }
 
 bool isTransactionRunning(unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -342,11 +342,11 @@ bool isTransactionRunning(unsigned int connectorId) {
 }
 
 bool ocppPermitsCharge(unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -355,11 +355,11 @@ bool ocppPermitsCharge(unsigned int connectorId) {
 }
 
 void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -374,14 +374,14 @@ void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int c
 }
 
 void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto& model = ocppEngine->getOcppModel();
+    auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
+            new MeteringService(*context, AO_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Energy.Active.Import.Register");
@@ -396,15 +396,15 @@ void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connec
 }
 
 void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
 
-    auto& model = ocppEngine->getOcppModel();
+    auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
+            new MeteringService(*context, AO_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Power.Active.Import");
@@ -419,7 +419,7 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
 }
 
 void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
@@ -427,20 +427,20 @@ void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, unsi
         AO_DBG_WARN("Only one connector supported at the moment for Smart Charging");
         return;
     }
-    auto& model = ocppEngine->getOcppModel();
+    auto& model = context->getModel();
     if (!model.getSmartChargingService()) {
         model.setSmartChargingService(std::unique_ptr<SmartChargingService>(
-            new SmartChargingService(*ocppEngine, 11000.0f, voltage_eff, AO_NUMCONNECTORS, fileSystemOpt))); //default charging limit: 11kW
+            new SmartChargingService(*context, 11000.0f, voltage_eff, AO_NUMCONNECTORS, fileSystemOpt))); //default charging limit: 11kW
     }
     model.getSmartChargingService()->setOnLimitChange(chargingLimitOutput);
 }
 
 void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -449,11 +449,11 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
 }
 
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -462,11 +462,11 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
 }
 
 void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -475,7 +475,7 @@ void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned in
 }
 
 void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
@@ -508,46 +508,46 @@ void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measur
 }
 
 void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto& model = ocppEngine->getOcppModel();
+    auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*ocppEngine, AO_NUMCONNECTORS, filesystem)));
+            new MeteringService(*context, AO_NUMCONNECTORS, filesystem)));
     }
     model.getMeteringService()->addMeterValueSampler(connectorId, std::move(valueInput));
 }
 
 void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
 
-    if (auto rService = ocppEngine->getOcppModel().getResetService()) {
+    if (auto rService = context->getModel().getResetService()) {
         rService->setPreReset(onResetNotify);
     }
 }
 
 void setOnResetExecute(std::function<void(bool)> onResetExecute) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
 
-    if (auto rService = ocppEngine->getOcppModel().getResetService()) {
+    if (auto rService = context->getModel().getResetService()) {
         rService->setExecuteReset(onResetExecute);
     }
 }
 
 void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -556,11 +556,11 @@ void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnect
 }
 
 void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -569,11 +569,11 @@ void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int conne
 }
 
 void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -582,11 +582,11 @@ void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connect
 }
 
 void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
@@ -595,11 +595,11 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId)
 }
 
 bool isOperative(unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return true; //assume "true" as default state
     }
-    auto& model = ocppEngine->getOcppModel();
+    auto& model = context->getModel();
     auto chargePoint = model.getConnector(OCPP_ID_OF_CP);
     auto connector = model.getConnector(connectorId);
     if (!chargePoint || !connector) {
@@ -611,11 +611,11 @@ bool isOperative(unsigned int connectorId) {
 }
 
 int getTransactionId(unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return -1;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return -1;
@@ -624,11 +624,11 @@ int getTransactionId(unsigned int connectorId) {
 }
 
 const char *getTransactionIdTag(unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return nullptr;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(connectorId);
+    auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return nullptr;
@@ -637,7 +637,7 @@ const char *getTransactionIdTag(unsigned int connectorId) {
 }
 
 bool isBlockedByReservation(const char *idTag, unsigned int connectorId) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
         return false;
     }
@@ -645,7 +645,7 @@ bool isBlockedByReservation(const char *idTag, unsigned int connectorId) {
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
-    auto rService = ocppEngine->getOcppModel().getReservationService();
+    auto rService = context->getModel().getReservationService();
     if (!rService) {
         AO_DBG_ERR("Could not access reservations. Ignore");
         return false;
@@ -659,79 +659,79 @@ bool isBlockedByReservation(const char *idTag, unsigned int connectorId) {
 
 #if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
 ArduinoOcpp::FirmwareService *getFirmwareService() {
-    auto& model = ocppEngine->getOcppModel();
+    auto& model = context->getModel();
     return model.getFirmwareService();
 }
 #endif
 
 #if defined(AO_CUSTOM_DIAGNOSTICS) || defined(AO_CUSTOM_WS)
 ArduinoOcpp::DiagnosticsService *getDiagnosticsService() {
-    auto& model = ocppEngine->getOcppModel();
+    auto& model = context->getModel();
     return model.getDiagnosticsService();
 }
 #endif
 
-OcppEngine *getOcppEngine() {
-    if (!ocppEngine) {
+Context *getOcppContext() {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return nullptr;
     }
 
-    return ocppEngine;
+    return context;
 }
 
 void setOnSetChargingProfileRequest(OnReceiveReqListener onReceiveReq) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    ocppEngine->getOperationDeserializer().setOnRequest("SetChargingProfile", onReceiveReq);
+    context->getOperationRegistry().setOnRequest("SetChargingProfile", onReceiveReq);
 }
 
 void setOnRemoteStartTransactionSendConf(OnSendConfListener onSendConf) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    ocppEngine->getOperationDeserializer().setOnResponse("RemoteStartTransaction", onSendConf);
+    context->getOperationRegistry().setOnResponse("RemoteStartTransaction", onSendConf);
 }
 
 void setOnRemoteStopTransactionReceiveReq(OnReceiveReqListener onReceiveReq) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    ocppEngine->getOperationDeserializer().setOnRequest("RemoteStopTransaction", onReceiveReq);
+    context->getOperationRegistry().setOnRequest("RemoteStopTransaction", onReceiveReq);
 }
 
 void setOnRemoteStopTransactionSendConf(OnSendConfListener onSendConf) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    ocppEngine->getOperationDeserializer().setOnResponse("RemoteStopTransaction", onSendConf);
+    context->getOperationRegistry().setOnResponse("RemoteStopTransaction", onSendConf);
 }
 
 void setOnResetSendConf(OnSendConfListener onSendConf) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    ocppEngine->getOperationDeserializer().setOnResponse("Reset", onSendConf);
+    context->getOperationRegistry().setOnResponse("Reset", onSendConf);
 }
 
 void setOnResetRequest(OnReceiveReqListener onReceiveReq) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    ocppEngine->getOperationDeserializer().setOnRequest("Reset", onReceiveReq);
+    context->getOperationRegistry().setOnRequest("Reset", onReceiveReq);
 }
 
 #define OCPP_ID_OF_CONNECTOR 1
 
 bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
@@ -739,14 +739,14 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(OCPP_ID_OF_CONNECTOR);
+    auto connector = context->getModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     auto transaction = connector->getTransaction();
     if (transaction) {
-        if (transaction->getStartRpcSync().isRequested()) {
+        if (transaction->getStartRpcData().isRequested()) {
             AO_DBG_ERR("Transaction already in progress. Must call stopTransaction()");
             return false;
         }
@@ -760,7 +760,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         }
     }
 
-    if (auto mService = ocppEngine->getOcppModel().getMeteringService()) {
+    if (auto mService = context->getModel().getMeteringService()) {
         auto meterStart = mService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionBegin);
         if (meterStart && *meterStart) {
             transaction->setMeterStart(meterStart->toInteger());
@@ -769,12 +769,12 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         }
     }
 
-    transaction->setStartTimestamp(ocppEngine->getOcppModel().getOcppTime().getOcppTimestampNow());
+    transaction->setStartTimestamp(context->getModel().getTime().getTimestampNow());
 
     transaction->commit();
     
-    auto startTransaction = makeOcppOperation(
-        new StartTransaction(ocppEngine->getOcppModel(), transaction));
+    auto startTransaction = makeRequest(
+        new StartTransaction(context->getModel(), transaction));
     if (onConf)
         startTransaction->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -787,17 +787,17 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         startTransaction->setTimeout(timeout);
     else
         startTransaction->setTimeout(0);
-    ocppEngine->initiateOperation(std::move(startTransaction));
+    context->initiateRequest(std::move(startTransaction));
 
     return true;
 }
 
 bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
-    if (!ocppEngine) {
+    if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
     }
-    auto connector = ocppEngine->getOcppModel().getConnector(OCPP_ID_OF_CONNECTOR);
+    auto connector = context->getModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
@@ -818,7 +818,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
     
     transaction->setStopReason("Local");
 
-    if (auto mService = ocppEngine->getOcppModel().getMeteringService()) {
+    if (auto mService = context->getModel().getMeteringService()) {
         auto meterStop = mService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
         if (meterStop && *meterStop) {
             transaction->setMeterStop(meterStop->toInteger());
@@ -827,12 +827,12 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         }
     }
 
-    transaction->setStopTimestamp(ocppEngine->getOcppModel().getOcppTime().getOcppTimestampNow());
+    transaction->setStopTimestamp(context->getModel().getTime().getTimestampNow());
 
     transaction->commit();
 
-    auto stopTransaction = makeOcppOperation(
-        new StopTransaction(ocppEngine->getOcppModel(), transaction));
+    auto stopTransaction = makeRequest(
+        new StopTransaction(context->getModel(), transaction));
     if (onConf)
         stopTransaction->setOnReceiveConfListener(onConf);
     if (onAbort)
@@ -845,7 +845,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         stopTransaction->setTimeout(timeout);
     else
         stopTransaction->setTimeout(0);
-    ocppEngine->initiateOperation(std::move(stopTransaction));
+    context->initiateRequest(std::move(stopTransaction));
 
     return true;
 }
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 8a35d70e..65db1aa1 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -10,9 +10,9 @@
 #include <functional>
 
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
-#include <ArduinoOcpp/Core/OcppOperationCallbacks.h>
-#include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Core/Time.h>
+#include <ArduinoOcpp/Core/RequestCallbacks.h>
+#include <ArduinoOcpp/Core/Connection.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
@@ -75,18 +75,18 @@ struct ChargerCredentials {
 
 /*
  * Initialize the library with a WebSocket connection which is configured with protocol=ocpp1.6
- * (=OcppSocket), EVSE voltage and filesystem configuration. This library requires that you handle
+ * (=Connection), EVSE voltage and filesystem configuration. This library requires that you handle
  * establishing the connection and keeping it alive. Please refer to
  * https://github.com/matth-x/ArduinoOcpp/tree/master/examples/ESP-TLS for an example how to use it.
  * 
- * This GitHub project also delivers an OcppSocket implementation based on links2004/WebSockets. If
- * you need another WebSockets implementation, you can subclass the OcppSocket class and pass it to
+ * This GitHub project also delivers an Connection implementation based on links2004/WebSockets. If
+ * you need another WebSockets implementation, you can subclass the Connection class and pass it to
  * this initialize() function. Please refer to
- * https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/MongooseOcppSocketClient.cpp for
+ * https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/MongooseConnectionClient.cpp for
  * an example.
  */
 void OCPP_initialize(
-            ArduinoOcpp::OcppSocket& ocppSocket, //WebSocket adapter for ArduinoOcpp
+            ArduinoOcpp::Connection& connection, //WebSocket adapter for ArduinoOcpp
             const char *bootNotificationCredentials = ChargerCredentials("Demo Charger", "My Company Ltd."), //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             float V_eff = 230.f,                 //Grid voltage of your country. e.g. 230.f (European voltage)
             ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
@@ -311,12 +311,12 @@ ArduinoOcpp::DiagnosticsService *getDiagnosticsService();
 #endif
 
 namespace ArduinoOcpp {
-class OcppEngine;
+class Context;
 }
 
-//Get access to internal functions and data structures. The returned OcppEngine object allows
+//Get access to internal functions and data structures. The returned Context object allows
 //you to bypass the facade functions of this header and implement custom functionality.
-ArduinoOcpp::OcppEngine *getOcppEngine();
+ArduinoOcpp::Context *getOcppContext();
 
 /*
  * Deprecated functions or functions to be moved to ArduinoOcppExtended.h
diff --git a/src/ArduinoOcpp/Core/Connection.cpp b/src/ArduinoOcpp/Core/Connection.cpp
index 11d78470..509b7ce9 100644
--- a/src/ArduinoOcpp/Core/Connection.cpp
+++ b/src/ArduinoOcpp/Core/Connection.cpp
@@ -2,14 +2,14 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Core/Connection.h>
 #include <ArduinoOcpp/Debug.h>
 
 using namespace ArduinoOcpp;
 
-void OcppEchoSocket::loop() { }
+void LoopbackConnection::loop() { }
 
-bool OcppEchoSocket::sendTXT(std::string &out) {
+bool LoopbackConnection::sendTXT(std::string &out) {
     if (!connected) {
         return true;
     }
@@ -21,11 +21,11 @@ bool OcppEchoSocket::sendTXT(std::string &out) {
     }
 }
 
-void OcppEchoSocket::setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) {
+void LoopbackConnection::setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) {
     this->receiveTXT = receiveTXT;
 }
 
-unsigned long OcppEchoSocket::getLastRecv() {
+unsigned long LoopbackConnection::getLastRecv() {
     return lastRecv;
 }
 
@@ -33,19 +33,19 @@ unsigned long OcppEchoSocket::getLastRecv() {
 
 using namespace ArduinoOcpp::EspWiFi;
 
-OcppClientSocket::OcppClientSocket(WebSocketsClient *wsock) : wsock(wsock) {
+WSClient::WSClient(WebSocketsClient *wsock) : wsock(wsock) {
 
 }
 
-void OcppClientSocket::loop() {
+void WSClient::loop() {
     wsock->loop();
 }
 
-bool OcppClientSocket::sendTXT(std::string &out) {
+bool WSClient::sendTXT(std::string &out) {
     return wsock->sendTXT(out.c_str(), out.length());
 }
 
-void OcppClientSocket::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
+void WSClient::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
     auto& captureLastRecv = lastRecv;
     wsock->onEvent([callback, &captureLastRecv](WStype_t type, uint8_t * payload, size_t length) {
         switch (type) {
@@ -57,7 +57,7 @@ void OcppClientSocket::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
                 captureLastRecv = ao_tick_ms();
                 break;
             case WStype_TEXT:
-                if (callback((const char *) payload, length)) { //forward message to OcppEngine
+                if (callback((const char *) payload, length)) { //forward message to RequestQueue
                     captureLastRecv = ao_tick_ms();
                 } else {
                     AO_DBG_WARN("Processing WebSocket input event failed");
@@ -84,7 +84,7 @@ void OcppClientSocket::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
     });
 }
 
-unsigned long OcppClientSocket::getLastRecv() {
+unsigned long WSClient::getLastRecv() {
     return lastRecv;
 }
 
diff --git a/src/ArduinoOcpp/Core/Connection.h b/src/ArduinoOcpp/Core/Connection.h
index ea89435e..07e37caa 100644
--- a/src/ArduinoOcpp/Core/Connection.h
+++ b/src/ArduinoOcpp/Core/Connection.h
@@ -13,10 +13,10 @@ namespace ArduinoOcpp {
 
 using ReceiveTXTcallback = std::function<bool(const char*, size_t)>;
 
-class OcppSocket {
+class Connection {
 public:
-    OcppSocket() = default;
-    virtual ~OcppSocket() = default;
+    Connection() = default;
+    virtual ~Connection() = default;
 
     /*
      * The OCPP library will call this function frequently. If you need to execute regular routines, like
@@ -41,7 +41,7 @@ class OcppSocket {
     virtual unsigned long getLastRecv() {return 0;}
 };
 
-class OcppEchoSocket : public OcppSocket {
+class LoopbackConnection : public Connection {
 private:
     ReceiveTXTcallback receiveTXT;
 
@@ -66,12 +66,12 @@ class OcppEchoSocket : public OcppSocket {
 namespace ArduinoOcpp {
 namespace EspWiFi {
 
-class OcppClientSocket : public OcppSocket {
+class WSClient : public Connection {
 private:
     WebSocketsClient *wsock;
     unsigned long lastRecv = 0;
 public:
-    OcppClientSocket(WebSocketsClient *wsock);
+    WSClient(WebSocketsClient *wsock);
 
     void loop();
 
diff --git a/src/ArduinoOcpp/Core/Context.cpp b/src/ArduinoOcpp/Core/Context.cpp
index c84b734e..9aa34e76 100644
--- a/src/ArduinoOcpp/Core/Context.cpp
+++ b/src/ArduinoOcpp/Core/Context.cpp
@@ -2,68 +2,68 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppOperation.h>
-#include <ArduinoOcpp/Core/OcppSocket.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Request.h>
+#include <ArduinoOcpp/Core/Connection.h>
+#include <ArduinoOcpp/Core/Model.h>
 
 #include <ArduinoOcpp/Debug.h>
 
 using namespace ArduinoOcpp;
 
-OcppEngine *ArduinoOcpp::defaultOcppEngine = nullptr;
+Context *ArduinoOcpp::defaultContext = nullptr;
 
-OcppEngine::OcppEngine(OcppSocket& ocppSocket, const OcppClock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem)
-        : oSock(ocppSocket), oModel{std::make_shared<OcppModel>(system_clock)}, oConn{operationDeserializer, oModel, filesystem} {
-    defaultOcppEngine = this;
+Context::Context(Connection& connection, const Clock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem)
+        : connection(connection), model{std::make_shared<Model>(system_clock)}, reqQueue{operationRegistry, model, filesystem} {
+    defaultContext = this;
 
-    preBootConn = std::unique_ptr<OcppConnection>(new OcppConnection(operationDeserializer, oModel, nullptr)); //pre boot queue doesn't need persistency
-    preBootConn->setSocket(oSock);
+    preBootQueue = std::unique_ptr<RequestQueue>(new RequestQueue(operationRegistry, model, nullptr)); //pre boot queue doesn't need persistency
+    preBootQueue->setConnection(connection);
 }
 
-OcppEngine::~OcppEngine() {
-    defaultOcppEngine = nullptr;
+Context::~Context() {
+    defaultContext = nullptr;
 }
 
-void OcppEngine::loop() {
-    oSock.loop();
+void Context::loop() {
+    connection.loop();
 
-    if (preBootConn) {
-        preBootConn->loop(oSock);
+    if (preBootQueue) {
+        preBootQueue->loop(connection);
     } else {
-        oConn.loop(oSock);
+        reqQueue.loop(connection);
     }
 
-    oModel->loop();
+    model->loop();
 }
 
-void OcppEngine::activatePostBootCommunication() {
+void Context::activatePostBootCommunication() {
     //switch from pre boot connection to normal connetion
-    oConn.setSocket(oSock);
-    preBootConn.reset();
+    reqQueue.setConnection(connection);
+    preBootQueue.reset();
 }
 
-void OcppEngine::initiateOperation(std::unique_ptr<OcppOperation> op) {
+void Context::initiateRequest(std::unique_ptr<Request> op) {
     if (op) {
-        oConn.sendRequest(std::move(op));
+        reqQueue.sendRequest(std::move(op));
     }
 }
 
-void OcppEngine::initiatePreBootOperation(std::unique_ptr<OcppOperation> op) {
+void Context::initiatePreBootOperation(std::unique_ptr<Request> op) {
     if (op) {
-        if (preBootConn) {
-            preBootConn->sendRequest(std::move(op));
+        if (preBootQueue) {
+            preBootQueue->sendRequest(std::move(op));
         } else {
             //not in pre boot mode anymore - initiate normally
-            initiateOperation(std::move(op));
+            initiateRequest(std::move(op));
         }
     }
 }
 
-OcppModel& OcppEngine::getOcppModel() {
-    return *oModel;
+Model& Context::getModel() {
+    return *model;
 }
 
-OperationDeserializer& OcppEngine::getOperationDeserializer() {
-    return operationDeserializer;
+OperationRegistry& Context::getOperationRegistry() {
+    return operationRegistry;
 }
diff --git a/src/ArduinoOcpp/Core/Context.h b/src/ArduinoOcpp/Core/Context.h
index d3cb2dd9..02ad14f8 100644
--- a/src/ArduinoOcpp/Core/Context.h
+++ b/src/ArduinoOcpp/Core/Context.h
@@ -5,46 +5,46 @@
 #ifndef OCPPENGINE_H
 #define OCPPENGINE_H
 
-#include <ArduinoOcpp/Core/OcppConnection.h>
-#include <ArduinoOcpp/OperationDeserializer.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/RequestQueue.h>
+#include <ArduinoOcpp/Core/OperationRegistry.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <memory>
 
 namespace ArduinoOcpp {
 
-class OcppSocket;
-class OperationDeserializer;
-class OcppModel;
+class Connection;
+class OperationRegistry;
+class Model;
 class FilesystemAdapter;
 
-class OcppEngine {
+class Context {
 private:
-    OcppSocket& oSock;
-    OperationDeserializer operationDeserializer;
-    std::shared_ptr<OcppModel> oModel;
-    OcppConnection oConn;
+    Connection& connection;
+    OperationRegistry operationRegistry;
+    std::shared_ptr<Model> model;
+    RequestQueue reqQueue;
 
-    std::unique_ptr<OcppConnection> preBootConn;
+    std::unique_ptr<RequestQueue> preBootQueue;
 
 public:
-    OcppEngine(OcppSocket& ocppSocket, const OcppClock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem);
-    ~OcppEngine();
+    Context(Connection& connection, const Clock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem);
+    ~Context();
 
     void loop();
 
     void activatePostBootCommunication();
 
-    void initiateOperation(std::unique_ptr<OcppOperation> op);
+    void initiateRequest(std::unique_ptr<Request> op);
     
     //for BootNotification and TriggerMessage: initiate operations before the first BootNotification was accepted (pre-boot mode)
-    void initiatePreBootOperation(std::unique_ptr<OcppOperation> op);
+    void initiatePreBootOperation(std::unique_ptr<Request> op);
 
-    OcppModel& getOcppModel();
+    Model& getModel();
 
-    OperationDeserializer& getOperationDeserializer();
+    OperationRegistry& getOperationRegistry();
 };
 
-extern OcppEngine *defaultOcppEngine;
+extern Context *defaultContext;
 
 } //end namespace ArduinoOcpp
 
diff --git a/src/ArduinoOcpp/Core/Model.cpp b/src/ArduinoOcpp/Core/Model.cpp
index 16dfa3f6..0ad916c6 100644
--- a/src/ArduinoOcpp/Core/Model.cpp
+++ b/src/ArduinoOcpp/Core/Model.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h>
@@ -19,14 +19,14 @@
 
 using namespace ArduinoOcpp;
 
-OcppModel::OcppModel(const OcppClock& system_clock)
-        : ocppTime{system_clock} {
+Model::Model(const Clock& system_clock)
+        : time{system_clock} {
     
 }
 
-OcppModel::~OcppModel() = default;
+Model::~Model() = default;
 
-void OcppModel::loop() {
+void Model::loop() {
 
     if (bootService) {
         bootService->loop();
@@ -62,39 +62,39 @@ void OcppModel::loop() {
         reservationService->loop();
 }
 
-void OcppModel::setTransactionStore(std::unique_ptr<TransactionStore> ts) {
+void Model::setTransactionStore(std::unique_ptr<TransactionStore> ts) {
     transactionStore = std::move(ts);
 }
 
-TransactionStore *OcppModel::getTransactionStore() {
+TransactionStore *Model::getTransactionStore() {
     return transactionStore.get();
 }
 
-void OcppModel::setSmartChargingService(std::unique_ptr<SmartChargingService> scs) {
+void Model::setSmartChargingService(std::unique_ptr<SmartChargingService> scs) {
     smartChargingService = std::move(scs);
 }
 
-SmartChargingService* OcppModel::getSmartChargingService() const {
+SmartChargingService* Model::getSmartChargingService() const {
     return smartChargingService.get();
 }
 
-void OcppModel::setChargeControlCommon(std::unique_ptr<ChargeControlCommon> ccs) {
+void Model::setChargeControlCommon(std::unique_ptr<ChargeControlCommon> ccs) {
     chargeControlCommon = std::move(ccs);
 }
 
-ChargeControlCommon *OcppModel::getChargeControlCommon() {
+ChargeControlCommon *Model::getChargeControlCommon() {
     return chargeControlCommon.get();
 }
 
-void OcppModel::setConnectors(std::vector<Connector>&& connectors) {
+void Model::setConnectors(std::vector<Connector>&& connectors) {
     this->connectors = std::move(connectors);
 }
 
-unsigned int OcppModel::getNumConnectors() const {
+unsigned int Model::getNumConnectors() const {
     return connectors.size();
 }
 
-Connector *OcppModel::getConnector(unsigned int connectorId) {
+Connector *Model::getConnector(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
         AO_DBG_ERR("connector with connectorId %u does not exist", connectorId);
         return nullptr;
@@ -103,66 +103,66 @@ Connector *OcppModel::getConnector(unsigned int connectorId) {
     return &connectors[connectorId];
 }
 
-void OcppModel::setMeteringSerivce(std::unique_ptr<MeteringService> ms) {
+void Model::setMeteringSerivce(std::unique_ptr<MeteringService> ms) {
     meteringService = std::move(ms);
 }
 
-MeteringService* OcppModel::getMeteringService() const {
+MeteringService* Model::getMeteringService() const {
     return meteringService.get();
 }
 
-void OcppModel::setFirmwareService(std::unique_ptr<FirmwareService> fws) {
+void Model::setFirmwareService(std::unique_ptr<FirmwareService> fws) {
     firmwareService = std::move(fws);
 }
 
-FirmwareService *OcppModel::getFirmwareService() const {
+FirmwareService *Model::getFirmwareService() const {
     return firmwareService.get();
 }
 
-void OcppModel::setDiagnosticsService(std::unique_ptr<DiagnosticsService> ds) {
+void Model::setDiagnosticsService(std::unique_ptr<DiagnosticsService> ds) {
     diagnosticsService = std::move(ds);
 }
 
-DiagnosticsService *OcppModel::getDiagnosticsService() const {
+DiagnosticsService *Model::getDiagnosticsService() const {
     return diagnosticsService.get();
 }
 
-void OcppModel::setHeartbeatService(std::unique_ptr<HeartbeatService> hs) {
+void Model::setHeartbeatService(std::unique_ptr<HeartbeatService> hs) {
     heartbeatService = std::move(hs);
 }
 
-void OcppModel::setAuthorizationService(std::unique_ptr<AuthorizationService> as) {
+void Model::setAuthorizationService(std::unique_ptr<AuthorizationService> as) {
     authorizationService = std::move(as);
 }
 
-AuthorizationService *OcppModel::getAuthorizationService() {
+AuthorizationService *Model::getAuthorizationService() {
     return authorizationService.get();
 }
 
-void OcppModel::setReservationService(std::unique_ptr<ReservationService> rs) {
+void Model::setReservationService(std::unique_ptr<ReservationService> rs) {
     reservationService = std::move(rs);
 }
 
-ReservationService *OcppModel::getReservationService() {
+ReservationService *Model::getReservationService() {
     return reservationService.get();
 }
 
-void OcppModel::setBootService(std::unique_ptr<BootService> bs){
+void Model::setBootService(std::unique_ptr<BootService> bs){
     bootService = std::move(bs);
 }
 
-BootService *OcppModel::getBootService() const {
+BootService *Model::getBootService() const {
     return bootService.get();
 }
 
-void OcppModel::setResetService(std::unique_ptr<ResetService> rs) {
+void Model::setResetService(std::unique_ptr<ResetService> rs) {
     this->resetService = std::move(rs);
 }
 
-ResetService *OcppModel::getResetService() const {
+ResetService *Model::getResetService() const {
     return resetService.get();
 }
 
-OcppTime& OcppModel::getOcppTime() {
-    return ocppTime;
+Time& Model::getTime() {
+    return time;
 }
diff --git a/src/ArduinoOcpp/Core/Model.h b/src/ArduinoOcpp/Core/Model.h
index bda19104..b3b6846c 100644
--- a/src/ArduinoOcpp/Core/Model.h
+++ b/src/ArduinoOcpp/Core/Model.h
@@ -7,7 +7,7 @@
 
 #include <memory>
 
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 
 namespace ArduinoOcpp {
@@ -24,7 +24,7 @@ class ReservationService;
 class BootService;
 class ResetService;
 
-class OcppModel {
+class Model {
 private:
     std::vector<Connector> connectors;
     std::unique_ptr<TransactionStore> transactionStore;
@@ -38,15 +38,15 @@ class OcppModel {
     std::unique_ptr<ReservationService> reservationService;
     std::unique_ptr<BootService> bootService;
     std::unique_ptr<ResetService> resetService;
-    OcppTime ocppTime;
+    Time time;
 
     bool runTasks = false;
 
 public:
-    OcppModel(const OcppClock& system_clock);
-    OcppModel() = delete;
-    OcppModel(const OcppModel& rhs) = delete;
-    ~OcppModel();
+    Model(const Clock& system_clock);
+    Model() = delete;
+    Model(const Model& rhs) = delete;
+    ~Model();
 
     void loop();
 
@@ -88,7 +88,7 @@ class OcppModel {
     void setResetService(std::unique_ptr<ResetService> rs);
     ResetService *getResetService() const;
 
-    OcppTime &getOcppTime();
+    Time &getTime();
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/OcppError.h b/src/ArduinoOcpp/Core/OcppError.h
index d880146c..91f9d290 100644
--- a/src/ArduinoOcpp/Core/OcppError.h
+++ b/src/ArduinoOcpp/Core/OcppError.h
@@ -7,18 +7,18 @@
 
 #include <ArduinoJson.h>
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class NotImplemented : public OcppMessage {
+class NotImplemented : public Operation {
 public:
     const char *getErrorCode() {
         return "NotImplemented";
     }
 };
 
-class MsgBufferExceeded : public OcppMessage {
+class MsgBufferExceeded : public Operation {
 private:
     size_t maxCapacity;
     size_t msgLen;
diff --git a/src/ArduinoOcpp/Core/Operation.cpp b/src/ArduinoOcpp/Core/Operation.cpp
index 420ac6b8..c0b65c89 100644
--- a/src/ArduinoOcpp/Core/Operation.cpp
+++ b/src/ArduinoOcpp/Core/Operation.cpp
@@ -2,43 +2,43 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 #include <ArduinoOcpp/Debug.h>
 
-using ArduinoOcpp::OcppMessage;
+using ArduinoOcpp::Operation;
 
-OcppMessage::OcppMessage() {}
+Operation::Operation() {}
 
-OcppMessage::~OcppMessage() {}
+Operation::~Operation() {}
   
-const char* OcppMessage::getOcppOperationType(){
-    AO_DBG_ERR("Unsupported operation: getOcppOperationType() is not implemented");
+const char* Operation::getOperationType(){
+    AO_DBG_ERR("Unsupported operation: getOperationType() is not implemented");
     return "CustomOperation";
 }
 
-void OcppMessage::initiate(StoredOperationHandler *rpcData) {
-    //called after initiateOperation(anyMsg)
+void Operation::initiate(StoredOperationHandler *rpcData) {
+    //called after initiateRequest(anyMsg)
 }
 
-bool OcppMessage::restore(StoredOperationHandler *rpcData) {
+bool Operation::restore(StoredOperationHandler *rpcData) {
     return false;
 }
 
-std::unique_ptr<DynamicJsonDocument> OcppMessage::createReq() {
+std::unique_ptr<DynamicJsonDocument> Operation::createReq() {
     AO_DBG_ERR("Unsupported operation: createReq() is not implemented");
     return nullptr;
 }
 
-void OcppMessage::processConf(JsonObject payload) {
+void Operation::processConf(JsonObject payload) {
     AO_DBG_ERR("Unsupported operation: processConf() is not implemented");
 }
 
-void OcppMessage::processReq(JsonObject payload) {
+void Operation::processReq(JsonObject payload) {
     AO_DBG_ERR("Unsupported operation: processReq() is not implemented");
 }
 
-std::unique_ptr<DynamicJsonDocument> OcppMessage::createConf() {
+std::unique_ptr<DynamicJsonDocument> Operation::createConf() {
     AO_DBG_ERR("Unsupported operation: createConf() is not implemented");
     return nullptr;
 }
diff --git a/src/ArduinoOcpp/Core/Operation.h b/src/ArduinoOcpp/Core/Operation.h
index ba884f6a..b5e005fe 100644
--- a/src/ArduinoOcpp/Core/Operation.h
+++ b/src/ArduinoOcpp/Core/Operation.h
@@ -7,10 +7,10 @@
  * destination properly (the "Remote procedure call" header, e.g. message Id). Second, transmit the application data
  * as specified in the OCPP 1.6 document.
  * 
- * The remote procedure call (RPC) part is implemented by the class OcppOperation. The application data part is implemented by
- * the respective OcppMessage subclasses, e.g. BootNotification, StartTransaction, ect.
+ * The remote procedure call (RPC) part is implemented by the class Request. The application data part is implemented by
+ * the respective Operation subclasses, e.g. BootNotification, StartTransaction, ect.
  * 
- * The resulting structure is that the RPC header (=instance of OcppOperation) holds a reference to the payload
+ * The resulting structure is that the RPC header (=instance of Request) holds a reference to the payload
  * message creator (=instance of BootNotification, StartTransaction, ...). Both objects working together give the complete
  * OCPP operation.
  */
@@ -21,19 +21,19 @@
 #include <ArduinoJson.h>
 #include <memory>
 
-#include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/Core/RequestStore.h>
 
 namespace ArduinoOcpp {
 
 std::unique_ptr<DynamicJsonDocument> createEmptyDocument();
 
-class OcppMessage {
+class Operation {
 public:
-    OcppMessage();
+    Operation();
 
-    virtual ~OcppMessage();
+    virtual ~Operation();
     
-    virtual const char* getOcppOperationType();
+    virtual const char* getOperationType();
 
     virtual void initiate(StoredOperationHandler *rpcData);
 
diff --git a/src/ArduinoOcpp/Core/OperationRegistry.cpp b/src/ArduinoOcpp/Core/OperationRegistry.cpp
index d10a3c8c..e68873aa 100644
--- a/src/ArduinoOcpp/Core/OperationRegistry.cpp
+++ b/src/ArduinoOcpp/Core/OperationRegistry.cpp
@@ -2,20 +2,20 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/OperationDeserializer.h>
-#include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppOperation.h>
+#include <ArduinoOcpp/Core/OperationRegistry.h>
+#include <ArduinoOcpp/Core/Operation.h>
+#include <ArduinoOcpp/Core/Request.h>
 #include <ArduinoOcpp/Core/OcppError.h>
 #include <ArduinoOcpp/Debug.h>
 #include <algorithm>
 
 using namespace ArduinoOcpp;
 
-OperationDeserializer::OperationDeserializer() {
+OperationRegistry::OperationRegistry() {
 
 }
 
-OcppMessageCreator *OperationDeserializer::findCreator(const char *operationType) {
+OperationCreator *OperationRegistry::findCreator(const char *operationType) {
     for (auto it = registry.begin(); it != registry.end(); ++it) {
         if (!strcmp(it->operationType, operationType)) {
             return &*it;
@@ -24,14 +24,14 @@ OcppMessageCreator *OperationDeserializer::findCreator(const char *operationType
     return nullptr;
 }
 
-void OperationDeserializer::registerOcppOperation(const char *operationType, std::function<OcppMessage*()> creator) {
+void OperationRegistry::registerRequest(const char *operationType, std::function<Operation*()> creator) {
     registry.erase(std::remove_if(registry.begin(), registry.end(),
-                [operationType] (const OcppMessageCreator& el) {
+                [operationType] (const OperationCreator& el) {
                     return !strcmp(operationType, el.operationType);
                 }),
             registry.end());
     
-    OcppMessageCreator entry;
+    OperationCreator entry;
     entry.operationType = operationType;
     entry.creator = creator;
 
@@ -40,7 +40,7 @@ void OperationDeserializer::registerOcppOperation(const char *operationType, std
     AO_DBG_DEBUG("registered operation %s", operationType);
 }
 
-void OperationDeserializer::setOnRequest(const char *operationType, OnReceiveReqListener onRequest) {
+void OperationRegistry::setOnRequest(const char *operationType, OnReceiveReqListener onRequest) {
     if (auto entry = findCreator(operationType)) {
         entry->onRequest = onRequest;
     } else {
@@ -48,7 +48,7 @@ void OperationDeserializer::setOnRequest(const char *operationType, OnReceiveReq
     }
 }
 
-void OperationDeserializer::setOnResponse(const char *operationType, OnSendConfListener onResponse) {
+void OperationRegistry::setOnResponse(const char *operationType, OnSendConfListener onResponse) {
     if (auto entry = findCreator(operationType)) {
         entry->onResponse = onResponse;
     } else {
@@ -56,23 +56,23 @@ void OperationDeserializer::setOnResponse(const char *operationType, OnSendConfL
     }
 }
 
-std::unique_ptr<OcppOperation> OperationDeserializer::deserializeOperation(const char *operationType) {
+std::unique_ptr<Request> OperationRegistry::deserializeOperation(const char *operationType) {
     
     if (auto entry = findCreator(operationType)) {
         auto payload = entry->creator();
         if (payload) {
-            auto result = std::unique_ptr<OcppOperation>(new OcppOperation(
-                                std::unique_ptr<OcppMessage>(payload)));
+            auto result = std::unique_ptr<Request>(new Request(
+                                std::unique_ptr<Operation>(payload)));
             result->setOnReceiveReqListener(entry->onRequest);
             return result;
         }
     }
 
-    return std::unique_ptr<OcppOperation>(new OcppOperation(
-                std::unique_ptr<OcppMessage>(new NotImplemented())));
+    return std::unique_ptr<Request>(new Request(
+                std::unique_ptr<Operation>(new NotImplemented())));
 }
 
-void OperationDeserializer::debugPrint() {
+void OperationRegistry::debugPrint() {
     for (auto& creator : registry) {
         AO_CONSOLE_PRINTF("[AO]     > %s\n", creator.operationType);
     }
diff --git a/src/ArduinoOcpp/Core/OperationRegistry.h b/src/ArduinoOcpp/Core/OperationRegistry.h
index d41c9096..00ded65f 100644
--- a/src/ArduinoOcpp/Core/OperationRegistry.h
+++ b/src/ArduinoOcpp/Core/OperationRegistry.h
@@ -9,33 +9,33 @@
 #include <vector>
 #include <memory>
 #include <ArduinoJson.h>
-#include <ArduinoOcpp/Core/OcppOperationCallbacks.h>
+#include <ArduinoOcpp/Core/RequestCallbacks.h>
 
 namespace ArduinoOcpp {
 
-class OcppMessage;
-class OcppOperation;
+class Operation;
+class Request;
 
-struct OcppMessageCreator {
+struct OperationCreator {
     const char *operationType {nullptr};
-    std::function<OcppMessage*()> creator {nullptr};
+    std::function<Operation*()> creator {nullptr};
     OnReceiveReqListener onRequest {nullptr};
     OnSendConfListener onResponse {nullptr};
 };
 
-class OperationDeserializer {
+class OperationRegistry {
 private:
-    std::vector<OcppMessageCreator> registry;
-    OcppMessageCreator *findCreator(const char *operationType);
+    std::vector<OperationCreator> registry;
+    OperationCreator *findCreator(const char *operationType);
 
 public:
-    OperationDeserializer();
+    OperationRegistry();
 
-    void registerOcppOperation(const char *operationType, std::function<OcppMessage*()> creator);
+    void registerRequest(const char *operationType, std::function<Operation*()> creator);
     void setOnRequest(const char *operationType, OnReceiveReqListener onRequest);
     void setOnResponse(const char *operationType, OnSendConfListener onResponse);
     
-    std::unique_ptr<OcppOperation> deserializeOperation(const char *operationType);
+    std::unique_ptr<Request> deserializeOperation(const char *operationType);
 
     void debugPrint();
 };
diff --git a/src/ArduinoOcpp/Core/Request.cpp b/src/ArduinoOcpp/Core/Request.cpp
index f0b2ad91..6eb906f6 100644
--- a/src/ArduinoOcpp/Core/Request.cpp
+++ b/src/ArduinoOcpp/Core/Request.cpp
@@ -2,11 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OcppOperation.h>
-#include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Core/Request.h>
+#include <ArduinoOcpp/Core/Operation.h>
+#include <ArduinoOcpp/Core/Connection.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/Core/RequestStore.h>
 
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
@@ -18,31 +18,31 @@ int unique_id_counter = 1000000;
 
 using namespace ArduinoOcpp;
 
-OcppOperation::OcppOperation(std::unique_ptr<OcppMessage> msg) : ocppMessage(std::move(msg)) {
+Request::Request(std::unique_ptr<Operation> msg) : operation(std::move(msg)) {
 
 }
 
-OcppOperation::OcppOperation() {
+Request::Request() {
 
 }
 
-OcppOperation::~OcppOperation(){
+Request::~Request(){
 
 }
 
-void OcppOperation::setOcppMessage(std::unique_ptr<OcppMessage> msg){
-    ocppMessage = std::move(msg);
+void Request::setOperation(std::unique_ptr<Operation> msg){
+    operation = std::move(msg);
 }
 
-void OcppOperation::setTimeout(unsigned long timeout) {
+void Request::setTimeout(unsigned long timeout) {
     this->timeout_period = timeout;
 }
 
-bool OcppOperation::isTimeoutExceeded() {
+bool Request::isTimeoutExceeded() {
     return timed_out || (timeout_period && ao_tick_ms() - timeout_start >= timeout_period);
 }
 
-void OcppOperation::executeTimeout() {
+void Request::executeTimeout() {
     if (!timed_out) {
         onTimeoutListener();
         onAbortListener();
@@ -50,27 +50,27 @@ void OcppOperation::executeTimeout() {
     timed_out = true;
 }
 
-unsigned int OcppOperation::getTrialNo() {
+unsigned int Request::getTrialNo() {
     return trialNo;
 }
 
-void OcppOperation::setMessageID(const std::string &id){
+void Request::setMessageID(const std::string &id){
     if (!messageID.empty()){
         AO_DBG_WARN("MessageID is set twice or is set after first usage!");
     }
     messageID = id;
 }
 
-const char *OcppOperation::getMessageID() {
+const char *Request::getMessageID() {
     return messageID.c_str();
 }
 
-std::unique_ptr<DynamicJsonDocument> OcppOperation::createRequest(){
+std::unique_ptr<DynamicJsonDocument> Request::createRequest(){
 
     /*
      * Create the OCPP message
      */
-    auto requestPayload = ocppMessage->createReq();
+    auto requestPayload = operation->createReq();
     if (!requestPayload) {
         return nullptr;
     }
@@ -83,7 +83,7 @@ std::unique_ptr<DynamicJsonDocument> OcppOperation::createRequest(){
 
     requestJson->add(MESSAGE_TYPE_CALL);                    //MessageType
     requestJson->add(messageID);                      //Unique message ID
-    requestJson->add(ocppMessage->getOcppOperationType());  //Action
+    requestJson->add(operation->getOperationType());  //Action
     requestJson->add(*requestPayload);                      //Payload
 
     if (AO_DBG_LEVEL >= AO_DL_DEBUG && ao_tick_ms() - debugRequest_start >= 10000) { //print contents on the console
@@ -96,7 +96,7 @@ std::unique_ptr<DynamicJsonDocument> OcppOperation::createRequest(){
         }
 
         if (!buf || len < 1) {
-            AO_DBG_DEBUG("Try to send request: %s", ocppMessage->getOcppOperationType());
+            AO_DBG_DEBUG("Try to send request: %s", operation->getOperationType());
         } else {
             AO_DBG_DEBUG("Try to send request: %.*s (...)", 128, buf);
         }
@@ -109,7 +109,7 @@ std::unique_ptr<DynamicJsonDocument> OcppOperation::createRequest(){
     return requestJson;
 }
 
-bool OcppOperation::receiveResponse(JsonArray response){
+bool Request::receiveResponse(JsonArray response){
     /*
      * check if messageIDs match. If yes, continue with this function. If not, return false for message not consumed
      */
@@ -122,10 +122,10 @@ bool OcppOperation::receiveResponse(JsonArray response){
     if (messageTypeId == MESSAGE_TYPE_CALLRESULT) {
 
         /*
-        * Hand the payload over to the OcppMessage object
+        * Hand the payload over to the Operation object
         */
         JsonObject payload = response[2];
-        ocppMessage->processConf(payload);
+        operation->processConf(payload);
 
         /*
         * Hand the payload over to the onReceiveConf Callback
@@ -139,12 +139,12 @@ bool OcppOperation::receiveResponse(JsonArray response){
     } else if (messageTypeId == MESSAGE_TYPE_CALLERROR) {
 
         /*
-        * Hand the error over to the OcppMessage object
+        * Hand the error over to the Operation object
         */
         const char *errorCode = response[2];
         const char *errorDescription = response[3];
         JsonObject errorDetails = response[4];
-        bool abortOperation = ocppMessage->processErr(errorCode, errorDescription, errorDetails);
+        bool abortOperation = operation->processErr(errorCode, errorDescription, errorDetails);
 
         if (abortOperation) {
             onReceiveErrorListener(errorCode, errorDescription, errorDetails);
@@ -159,16 +159,16 @@ bool OcppOperation::receiveResponse(JsonArray response){
 
 }
 
-bool OcppOperation::receiveRequest(JsonArray request){
+bool Request::receiveRequest(JsonArray request){
   
     std::string msgId = request[1];
     setMessageID(msgId);
     
     /*
-     * Hand the payload over to the OcppOperation object
+     * Hand the payload over to the Request object
      */
     JsonObject payload = request[3];
-    ocppMessage->processReq(payload);
+    operation->processReq(payload);
     
     /*
      * Hand the payload over to the first Callback. It is a callback that notifies the client that request has been processed in the OCPP-library
@@ -178,16 +178,16 @@ bool OcppOperation::receiveRequest(JsonArray request){
     return true; //success
 }
 
-std::unique_ptr<DynamicJsonDocument> OcppOperation::createResponse(){
+std::unique_ptr<DynamicJsonDocument> Request::createResponse(){
 
     /*
      * Create the OCPP message
      */
     std::unique_ptr<DynamicJsonDocument> response = nullptr;
-    std::unique_ptr<DynamicJsonDocument> payload = ocppMessage->createConf();
+    std::unique_ptr<DynamicJsonDocument> payload = operation->createConf();
     std::unique_ptr<DynamicJsonDocument> errorDetails = nullptr;
     
-    bool operationFailure = ocppMessage->getErrorCode() != nullptr;
+    bool operationFailure = operation->getErrorCode() != nullptr;
 
     if (!operationFailure && !payload) {
         return nullptr; //confirmation message still pending
@@ -207,9 +207,9 @@ std::unique_ptr<DynamicJsonDocument> OcppOperation::createResponse(){
     } else {
         //operation failure. Send error message instead
 
-        const char *errorCode = ocppMessage->getErrorCode();
-        const char *errorDescription = ocppMessage->getErrorDescription();
-        errorDetails = std::unique_ptr<DynamicJsonDocument>(ocppMessage->getErrorDetails());
+        const char *errorCode = operation->getErrorCode();
+        const char *errorDescription = operation->getErrorDescription();
+        errorDetails = std::unique_ptr<DynamicJsonDocument>(operation->getErrorDetails());
         if (!errorCode) { //catch corner case when payload is null but errorCode is not set too!
             errorCode = "GenericError";
             errorDescription = "Could not create payload (createConf() returns Null)";
@@ -236,7 +236,7 @@ std::unique_ptr<DynamicJsonDocument> OcppOperation::createResponse(){
     return response;
 }
 
-void OcppOperation::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
+void Request::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
 
     timeout_start = ao_tick_ms();
     debugRequest_start = ao_tick_ms();
@@ -246,7 +246,7 @@ void OcppOperation::initiate(std::unique_ptr<StoredOperationHandler> opStorage)
     sprintf(id_str, "%d", unique_id_counter++);
     messageID = std::string {id_str};
 
-    if (ocppMessage) {
+    if (operation) {
 
         /*
          * Create OCPP-J Remote Procedure Call header storage entry
@@ -259,22 +259,22 @@ void OcppOperation::initiate(std::unique_ptr<StoredOperationHandler> opStorage)
 
             rpcData->add(MESSAGE_TYPE_CALL);                    //MessageType
             rpcData->add(messageID);                      //Unique message ID
-            rpcData->add(ocppMessage->getOcppOperationType());  //Action
+            rpcData->add(operation->getOperationType());  //Action
 
-            opStore->setRpc(std::move(rpcData));
+            opStore->setRpcData(std::move(rpcData));
         }
         
-        ocppMessage->initiate(opStore.get());
+        operation->initiate(opStore.get());
 
         if (opStore) {
             opStore->clearBuffer();
         }
     } else {
-        AO_DBG_ERR("Missing ocppMessage instance");
+        AO_DBG_ERR("Missing operation instance");
     }
 }
 
-bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<OcppModel> oModel) {
+bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<Model> model) {
     if (!opStorage) {
         AO_DBG_ERR("invalid argument");
         return false;
@@ -282,7 +282,7 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
 
     opStore = std::move(opStorage);
 
-    auto rpcData = opStore->getRpc();
+    auto rpcData = opStore->getRpcData();
     if (!rpcData) {
         AO_DBG_ERR("corrupted storage");
         return false;
@@ -311,21 +311,21 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
     timeout_period = 0; //disable timeout by default for restored msgs
 
     if (!strcmp(opType.c_str(), "StartTransaction")) { //TODO this will get a nicer solution
-        ocppMessage = std::unique_ptr<OcppMessage>(new Ocpp16::StartTransaction(*oModel.get(), nullptr));
+        operation = std::unique_ptr<Operation>(new Ocpp16::StartTransaction(*model.get(), nullptr));
     } else if (!strcmp(opType.c_str(), "StopTransaction")) {
-        ocppMessage = std::unique_ptr<OcppMessage>(new Ocpp16::StopTransaction(*oModel.get(), nullptr));
+        operation = std::unique_ptr<Operation>(new Ocpp16::StopTransaction(*model.get(), nullptr));
     }
 
-    if (!ocppMessage) {
+    if (!operation) {
         AO_DBG_ERR("cannot create msg");
         return false;
     }
 
-    bool success = ocppMessage->restore(opStore.get());
+    bool success = operation->restore(opStore.get());
     opStore->clearBuffer();
 
     if (success) {
-        AO_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), ocppMessage->getOcppOperationType());
+        AO_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), operation->getOperationType());
         (void)0;
     } else {
         AO_DBG_ERR("restore opNr %i error", opStore->getOpNr());
@@ -335,7 +335,7 @@ bool OcppOperation::restore(std::unique_ptr<StoredOperationHandler> opStorage, s
     return success;
 }
 
-void OcppOperation::setOnReceiveConfListener(OnReceiveConfListener onReceiveConf){
+void Request::setOnReceiveConfListener(OnReceiveConfListener onReceiveConf){
     if (onReceiveConf)
         onReceiveConfListener = onReceiveConf;
 }
@@ -343,31 +343,31 @@ void OcppOperation::setOnReceiveConfListener(OnReceiveConfListener onReceiveConf
 /**
  * Sets a Listener that is called after this machine processed a request by the communication counterpart
  */
-void OcppOperation::setOnReceiveReqListener(OnReceiveReqListener onReceiveReq){
+void Request::setOnReceiveReqListener(OnReceiveReqListener onReceiveReq){
     if (onReceiveReq)
         onReceiveReqListener = onReceiveReq;
 }
 
-void OcppOperation::setOnSendConfListener(OnSendConfListener onSendConf){
+void Request::setOnSendConfListener(OnSendConfListener onSendConf){
     if (onSendConf)
         onSendConfListener = onSendConf;
 }
 
-void OcppOperation::setOnTimeoutListener(OnTimeoutListener onTimeout) {
+void Request::setOnTimeoutListener(OnTimeoutListener onTimeout) {
     if (onTimeout)
         onTimeoutListener = onTimeout;
 }
 
-void OcppOperation::setOnReceiveErrorListener(OnReceiveErrorListener onReceiveError) {
+void Request::setOnReceiveErrorListener(OnReceiveErrorListener onReceiveError) {
     if (onReceiveError)
         onReceiveErrorListener = onReceiveError;
 }
 
-void OcppOperation::setOnAbortListener(OnAbortListener onAbort) {
+void Request::setOnAbortListener(OnAbortListener onAbort) {
     if (onAbort)
         onAbortListener = onAbort;
 }
 
-const char *OcppOperation::getOcppOperationType() {
-    return ocppMessage ? ocppMessage->getOcppOperationType() : "UNDEFINED";
+const char *Request::getOperationType() {
+    return operation ? operation->getOperationType() : "UNDEFINED";
 }
diff --git a/src/ArduinoOcpp/Core/Request.h b/src/ArduinoOcpp/Core/Request.h
index a6cae079..4538267a 100644
--- a/src/ArduinoOcpp/Core/Request.h
+++ b/src/ArduinoOcpp/Core/Request.h
@@ -11,18 +11,18 @@
 
 #include <memory>
 
-#include <ArduinoOcpp/Core/OcppOperationCallbacks.h>
+#include <ArduinoOcpp/Core/RequestCallbacks.h>
 
 namespace ArduinoOcpp {
 
-class OcppMessage;
-class OcppModel;
+class Operation;
+class Model;
 class StoredOperationHandler;
 
-class OcppOperation {
+class Request {
 private:
     std::string messageID {};
-    std::unique_ptr<OcppMessage> ocppMessage;
+    std::unique_ptr<Operation> operation;
     void setMessageID(const std::string &id);
     OnReceiveConfListener onReceiveConfListener = [] (JsonObject payload) {};
     OnReceiveReqListener onReceiveReqListener = [] (JsonObject payload) {};
@@ -42,13 +42,13 @@ class OcppOperation {
     std::unique_ptr<StoredOperationHandler> opStore;
 public:
 
-    OcppOperation(std::unique_ptr<OcppMessage> msg);
+    Request(std::unique_ptr<Operation> msg);
 
-    OcppOperation();
+    Request();
 
-    ~OcppOperation();
+    ~Request();
 
-    void setOcppMessage(std::unique_ptr<OcppMessage> msg);
+    void setOperation(std::unique_ptr<Operation> msg);
 
     void setTimeout(unsigned long timeout); //0 = disable timeout
     bool isTimeoutExceeded();
@@ -89,7 +89,7 @@ class OcppOperation {
 
     void initiate(std::unique_ptr<StoredOperationHandler> opStorage);
 
-    bool restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<OcppModel> oModel);
+    bool restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<Model> model);
 
     StoredOperationHandler *getStorageHandler() {return opStore.get();}
 
@@ -120,7 +120,7 @@ class OcppOperation {
     void setOnAbortListener(OnAbortListener onAbort);
 
     const char *getMessageID();
-    const char *getOcppOperationType();
+    const char *getOperationType();
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/RequestQueue.cpp b/src/ArduinoOcpp/Core/RequestQueue.cpp
index 6c0301ea..c8858bc4 100644
--- a/src/ArduinoOcpp/Core/RequestQueue.cpp
+++ b/src/ArduinoOcpp/Core/RequestQueue.cpp
@@ -2,13 +2,13 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OcppConnection.h>
-#include <ArduinoOcpp/Core/OcppOperation.h>
-#include <ArduinoOcpp/Core/OcppSocket.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/RequestQueue.h>
+#include <ArduinoOcpp/Core/Request.h>
+#include <ArduinoOcpp/Core/Connection.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/OcppError.h>
-#include <ArduinoOcpp/Core/OperationStore.h>
-#include <ArduinoOcpp/OperationDeserializer.h>
+#include <ArduinoOcpp/Core/RequestStore.h>
+#include <ArduinoOcpp/Core/OperationRegistry.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -16,17 +16,17 @@ size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_siz
 
 using namespace ArduinoOcpp;
 
-OcppConnection::OcppConnection(OperationDeserializer& operationDeserializer, std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
-            : operationDeserializer(operationDeserializer) {
+RequestQueue::RequestQueue(OperationRegistry& operationRegistry, std::shared_ptr<Model> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
+            : operationRegistry(operationRegistry) {
     
     if (filesystem) {
-        initiatedOcppOperations.reset(new PersistentOperationsQueue(baseModel, filesystem));
+        initiatedRequests.reset(new PersistentRequestQueue(baseModel, filesystem));
     } else {
-        initiatedOcppOperations.reset(new VolatileOperationsQueue());
+        initiatedRequests.reset(new VolatileRequestQueue());
     }
 }
 
-void OcppConnection::setSocket(OcppSocket& sock) {
+void RequestQueue::setConnection(Connection& sock) {
     ReceiveTXTcallback callback = [this] (const char *payload, size_t length) {
         return this->receiveMessage(payload, length);
     };
@@ -34,15 +34,15 @@ void OcppConnection::setSocket(OcppSocket& sock) {
     sock.setReceiveTXTcallback(callback);
 }
 
-void OcppConnection::loop(OcppSocket& ocppSock) {
+void RequestQueue::loop(Connection& ocppSock) {
 
     /*
      * Sort out timed out operations
      */
-    initiatedOcppOperations->drop_if([] (std::unique_ptr<OcppOperation>& op) -> bool {
+    initiatedRequests->drop_if([] (std::unique_ptr<Request>& op) -> bool {
         bool timed_out = op->isTimeoutExceeded();
         if (timed_out) {
-            AO_DBG_INFO("operation timeout: %s", op->getOcppOperationType());
+            AO_DBG_INFO("operation timeout: %s", op->getOperationType());
             op->executeTimeout();
         }
         return timed_out;
@@ -54,7 +54,7 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
      * 
      * If a message has been sent, terminate this loop() function.
      */
-    for (auto received = receivedOcppOperations.begin(); received != receivedOcppOperations.end(); ++received) {
+    for (auto received = receivedRequests.begin(); received != receivedRequests.end(); ++received) {
     
         auto response = (*received)->createResponse();
 
@@ -66,7 +66,7 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
 
             if (success) {
                 AO_DBG_TRAFFIC_OUT(out.c_str());
-                received = receivedOcppOperations.erase(received);
+                received = receivedRequests.erase(received);
             }
 
             return;
@@ -77,7 +77,7 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
     /**
      * Send pending req message
      */
-    auto initedOp = initiatedOcppOperations->front();
+    auto initedOp = initiatedRequests->front();
 
     if (!initedOp) {
         //queue empty
@@ -125,16 +125,16 @@ void OcppConnection::loop(OcppSocket& ocppSock) {
     
 }
 
-void OcppConnection::sendRequest(std::unique_ptr<OcppOperation> op){
+void RequestQueue::sendRequest(std::unique_ptr<Request> op){
     if (!op) {
         AO_DBG_ERR("Called with null. Ignore");
         return;
     }
     
-    initiatedOcppOperations->initiate(std::move(op));
+    initiatedRequests->push_back(std::move(op));
 }
 
-bool OcppConnection::receiveMessage(const char* payload, size_t length) {
+bool RequestQueue::receiveMessage(const char* payload, size_t length) {
 
     AO_DBG_TRAFFIC_IN((int) length, payload);
 
@@ -199,7 +199,7 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
                 int messageTypeId = doc[0] | -1;
                 if (messageTypeId == MESSAGE_TYPE_CALL) {
                     success = true;
-                    auto op = makeOcppOperation(new MsgBufferExceeded(AO_MAX_JSON_CAPACITY, length));
+                    auto op = makeRequest(new MsgBufferExceeded(AO_MAX_JSON_CAPACITY, length));
                     receiveRequest(doc.as<JsonArray>(), std::move(op));
                 } else if (messageTypeId == MESSAGE_TYPE_CALLRESULT ||
                             messageTypeId == MESSAGE_TYPE_CALLERROR) {
@@ -225,12 +225,12 @@ bool OcppConnection::receiveMessage(const char* payload, size_t length) {
  * This function could result in improper behavior in Charging Stations, because messages are not
  * guaranteed to be received and therefore processed in the right order.
  */
-void OcppConnection::receiveResponse(JsonArray json) {
+void RequestQueue::receiveResponse(JsonArray json) {
 
     bool success = false;
 
-    initiatedOcppOperations->drop_if(
-        [&json, &success] (std::unique_ptr<OcppOperation>& operation) {
+    initiatedRequests->drop_if(
+        [&json, &success] (std::unique_ptr<Request>& operation) {
             bool match = operation->receiveResponse(json);
             if (match) {
                 success = true;
@@ -240,7 +240,7 @@ void OcppConnection::receiveResponse(JsonArray json) {
         }); //executes in order and drops every operation where predicate(op) == true
 
     if (!success) {
-        //didn't find matching OcppOperation
+        //didn't find matching Request
         if (json[0] == MESSAGE_TYPE_CALLERROR) {
             AO_DBG_DEBUG("Received CALLERROR did not abort a pending operation");
             (void)0;
@@ -251,8 +251,8 @@ void OcppConnection::receiveResponse(JsonArray json) {
     }
 }
 
-void OcppConnection::receiveRequest(JsonArray json) {
-    auto op = operationDeserializer.deserializeOperation(json[2] | "UNDEFINED");
+void RequestQueue::receiveRequest(JsonArray json) {
+    auto op = operationRegistry.deserializeOperation(json[2] | "UNDEFINED");
     if (op == nullptr) {
         AO_DBG_WARN("OOM");
         return;
@@ -260,9 +260,9 @@ void OcppConnection::receiveRequest(JsonArray json) {
     receiveRequest(json, std::move(op));
 }
 
-void OcppConnection::receiveRequest(JsonArray json, std::unique_ptr<OcppOperation> op) {
+void RequestQueue::receiveRequest(JsonArray json, std::unique_ptr<Request> op) {
     op->receiveRequest(json); //execute the operation
-    receivedOcppOperations.push_back(std::move(op)); //enqueue so loop() plans conf sending
+    receivedRequests.push_back(std::move(op)); //enqueue so loop() plans conf sending
 }
 
 /*
diff --git a/src/ArduinoOcpp/Core/RequestQueue.h b/src/ArduinoOcpp/Core/RequestQueue.h
index c634092f..5ddd0f0b 100644
--- a/src/ArduinoOcpp/Core/RequestQueue.h
+++ b/src/ArduinoOcpp/Core/RequestQueue.h
@@ -5,7 +5,7 @@
 #ifndef OCPPCONNECTION_H
 #define OCPPCONNECTION_H
 
-#include <ArduinoOcpp/Core/OperationsQueue.h>
+#include <ArduinoOcpp/Core/RequestQueueStorageStrategy.h>
 
 #include <deque>
 #include <memory>
@@ -13,21 +13,21 @@
 
 namespace ArduinoOcpp {
 
-class OperationDeserializer;
-class OcppModel;
-class OcppSocket;
-class OcppOperation;
+class OperationRegistry;
+class Model;
+class Connection;
+class Request;
 class FilesystemAdapter;
 
-class OcppConnection {
+class RequestQueue {
 private:
-    OperationDeserializer& operationDeserializer;
+    OperationRegistry& operationRegistry;
     
-    std::unique_ptr<OperationsQueue> initiatedOcppOperations;
-    std::deque<std::unique_ptr<OcppOperation>> receivedOcppOperations;
+    std::unique_ptr<RequestQueueStorageStrategy> initiatedRequests;
+    std::deque<std::unique_ptr<Request>> receivedRequests;
 
     void receiveRequest(JsonArray json);
-    void receiveRequest(JsonArray json, std::unique_ptr<OcppOperation> op);
+    void receiveRequest(JsonArray json, std::unique_ptr<Request> op);
     void receiveResponse(JsonArray json);
 
     unsigned long sendBackoffTime = 0;
@@ -36,13 +36,13 @@ class OcppConnection {
     const unsigned long BACKOFF_PERIOD_MAX = 65536;
     const unsigned long BACKOFF_PERIOD_INCREMENT = BACKOFF_PERIOD_MAX / 4;
 public:
-    OcppConnection(OperationDeserializer& operationDeserializer, std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem = nullptr);
+    RequestQueue(OperationRegistry& operationRegistry, std::shared_ptr<Model> baseModel, std::shared_ptr<FilesystemAdapter> filesystem = nullptr);
 
-    void setSocket(OcppSocket& sock);
+    void setConnection(Connection& sock);
 
-    void loop(OcppSocket& ocppSock);
+    void loop(Connection& ocppSock);
 
-    void sendRequest(std::unique_ptr<OcppOperation> o); //send an OCPP operation request to the server
+    void sendRequest(std::unique_ptr<Request> o); //send an OCPP operation request to the server
     
     bool receiveMessage(const char* payload, size_t length); //receive from  server: either a request or response
 };
diff --git a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
index 6a664132..7c88fc9f 100644
--- a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
+++ b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
@@ -2,11 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OperationsQueue.h>
-#include <ArduinoOcpp/Core/OperationStore.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/RequestQueueStorageStrategy.h>
+#include <ArduinoOcpp/Core/RequestStore.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 
-#include <ArduinoOcpp/Core/OcppOperation.h>
+#include <ArduinoOcpp/Core/Request.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -16,15 +16,15 @@
 
 using namespace ArduinoOcpp;
 
-VolatileOperationsQueue::VolatileOperationsQueue() {
+VolatileRequestQueue::VolatileRequestQueue() {
 
 }
 
-VolatileOperationsQueue::~VolatileOperationsQueue() {
+VolatileRequestQueue::~VolatileRequestQueue() {
 
 }
 
-OcppOperation *VolatileOperationsQueue::front() {
+Request *VolatileRequestQueue::front() {
     if (!queue.empty()) {
         return queue.front().get();
     } else {
@@ -32,11 +32,11 @@ OcppOperation *VolatileOperationsQueue::front() {
     }
 }
 
-void VolatileOperationsQueue::pop_front() {
+void VolatileRequestQueue::pop_front() {
     queue.pop_front();
 }
 
-void VolatileOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
+void VolatileRequestQueue::push_back(std::unique_ptr<Request> op) {
 
     op->initiate(nullptr);
 
@@ -48,18 +48,18 @@ void VolatileOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
     queue.push_back(std::move(op));
 }
 
-void VolatileOperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) {
+void VolatileRequestQueue::drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) {
     queue.erase(std::remove_if(queue.begin(), queue.end(), pred), queue.end());
 }
 
-PersistentOperationsQueue::PersistentOperationsQueue(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
+PersistentRequestQueue::PersistentRequestQueue(std::shared_ptr<Model> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
             : opStore(filesystem), baseModel(baseModel) { }
 
-PersistentOperationsQueue::~PersistentOperationsQueue() {
+PersistentRequestQueue::~PersistentRequestQueue() {
 
 }
 
-OcppOperation *PersistentOperationsQueue::front() {
+Request *PersistentRequestQueue::front() {
     if (!head && !tailCache.empty()) {
         AO_DBG_ERR("invalid state");
         pop_front();
@@ -67,7 +67,7 @@ OcppOperation *PersistentOperationsQueue::front() {
     return head.get();
 }
 
-void PersistentOperationsQueue::pop_front() {
+void PersistentRequestQueue::pop_front() {
     
     if (head && head->getStorageHandler() && head->getStorageHandler()->getOpNr() >= 0) {
         opStore.advanceOpNr(head->getStorageHandler()->getOpNr());
@@ -86,7 +86,7 @@ void PersistentOperationsQueue::pop_front() {
      */
 
     auto found = std::find_if(tailCache.begin(), tailCache.end(),
-        [nextOpNr] (std::unique_ptr<OcppOperation>& op) {
+        [nextOpNr] (std::unique_ptr<Request>& op) {
             return op->getStorageHandler() &&
                    op->getStorageHandler()->getOpNr() >= 0 &&
                    (unsigned int) op->getStorageHandler()->getOpNr() == nextOpNr;
@@ -100,7 +100,7 @@ void PersistentOperationsQueue::pop_front() {
         //cache miss -> case B) or A) -> try to fetch operation from flash (check for case B)) or take first cached element as front
         auto storageHandler = opStore.makeOpHandler();
         
-        std::unique_ptr<OcppOperation> fetched;
+        std::unique_ptr<Request> fetched;
 
         unsigned int range = (opStore.getOpEnd() + AO_MAX_OPNR - nextOpNr) % AO_MAX_OPNR;
         for (size_t i = 0; i < range; i++) {
@@ -108,7 +108,7 @@ void PersistentOperationsQueue::pop_front() {
             if (exists) {
                 //case B) -> load operation from flash and take it as front element
 
-                fetched = makeOcppOperation();
+                fetched = makeRequest();
 
                 bool success = fetched->restore(std::move(storageHandler), baseModel);
 
@@ -146,7 +146,7 @@ void PersistentOperationsQueue::pop_front() {
     AO_DBG_VERBOSE("popped front");
 }
 
-void PersistentOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
+void PersistentRequestQueue::push_back(std::unique_ptr<Request> op) {
 
     op->initiate(opStore.makeOpHandler());
 
@@ -159,7 +159,7 @@ void PersistentOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
         head = std::move(op);
     } else {
         if (tailCache.size() >= AO_OPERATIONCACHE_MAXSIZE) {
-            AO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOcppOperationType());
+            AO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOperationType());
             tailCache.front()->executeTimeout();
             tailCache.pop_front();
         }
@@ -168,7 +168,7 @@ void PersistentOperationsQueue::initiate(std::unique_ptr<OcppOperation> op) {
     }
 }
 
-void PersistentOperationsQueue::drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) {
+void PersistentRequestQueue::drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) {
 
     while (head && pred(head)) {
         pop_front();
diff --git a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h
index b92082a7..13927be0 100644
--- a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h
+++ b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h
@@ -2,10 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OPERATIONSQUEUE_H
-#define OPERATIONSQUEUE_H
+#ifndef REQUESTQUEUESTORAGESTRATEGY_H
+#define REQUESTQUEUESTORAGESTRATEGY_H
 
-#include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/Core/RequestStore.h>
 
 #include <memory>
 #include <deque>
@@ -14,54 +14,54 @@
 namespace ArduinoOcpp {
 
 class FilesystemAdapter;
-class OcppOperation;
-class OcppModel;
+class Request;
+class Model;
 
-class OperationsQueue {
+class RequestQueueStorageStrategy {
 public:
-    virtual ~OperationsQueue() = default;
+    virtual ~RequestQueueStorageStrategy() = default;
 
-    virtual OcppOperation *front() = 0;
+    virtual Request *front() = 0;
     virtual void pop_front() = 0;
 
-    virtual void initiate(std::unique_ptr<OcppOperation> op) = 0;
+    virtual void push_back(std::unique_ptr<Request> op) = 0;
 
-    virtual void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) = 0; //drops operations from this queue where pred(operation) == true. Executes pred in order
+    virtual void drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) = 0; //drops operations from this queue where pred(operation) == true. Executes pred in order
 };
 
-class VolatileOperationsQueue : public OperationsQueue {
+class VolatileRequestQueue : public RequestQueueStorageStrategy {
 private:
-    std::deque<std::unique_ptr<OcppOperation>> queue;
+    std::deque<std::unique_ptr<Request>> queue;
 public:
-    VolatileOperationsQueue();
-    ~VolatileOperationsQueue();
+    VolatileRequestQueue();
+    ~VolatileRequestQueue();
 
-    OcppOperation *front() override;
+    Request *front() override;
     void pop_front() override;
 
-    void initiate(std::unique_ptr<OcppOperation> op) override;
+    void push_back(std::unique_ptr<Request> op) override;
 
-    void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
+    void drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
 };
 
-class PersistentOperationsQueue : public OperationsQueue {
+class PersistentRequestQueue : public RequestQueueStorageStrategy {
 private:
-    OperationStore opStore;
-    std::shared_ptr<OcppModel> baseModel;
+    RequestStore opStore;
+    std::shared_ptr<Model> baseModel;
 
-    std::unique_ptr<OcppOperation> head;
-    std::deque<std::unique_ptr<OcppOperation>> tailCache;
+    std::unique_ptr<Request> head;
+    std::deque<std::unique_ptr<Request>> tailCache;
 public:
 
-    PersistentOperationsQueue(std::shared_ptr<OcppModel> baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
-    ~PersistentOperationsQueue();
+    PersistentRequestQueue(std::shared_ptr<Model> baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
+    ~PersistentRequestQueue();
 
-    OcppOperation *front() override;
+    Request *front() override;
     void pop_front() override;
 
-    void initiate(std::unique_ptr<OcppOperation> op) override;
+    void push_back(std::unique_ptr<Request> op) override;
 
-    void drop_if(std::function<bool(std::unique_ptr<OcppOperation>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
+    void drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
 
 };
 
diff --git a/src/ArduinoOcpp/Core/RequestStore.cpp b/src/ArduinoOcpp/Core/RequestStore.cpp
index 60283324..54ebcc10 100644
--- a/src/ArduinoOcpp/Core/RequestStore.cpp
+++ b/src/ArduinoOcpp/Core/RequestStore.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/Core/RequestStore.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Core/Configuration.h>
@@ -95,7 +95,7 @@ bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
     return true;
 }
 
-OperationStore::OperationStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
+RequestStore::RequestStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
     opBegin = declareConfiguration<int>("AO_opBegin", 0, AO_OPSTORE_FN, false, false, true, false);
 
     if (!opBegin || *opBegin < 0) {
@@ -131,11 +131,11 @@ OperationStore::OperationStore(std::shared_ptr<FilesystemAdapter> filesystem) :
     }
 }
 
-std::unique_ptr<StoredOperationHandler> OperationStore::makeOpHandler() {
+std::unique_ptr<StoredOperationHandler> RequestStore::makeOpHandler() {
     return std::unique_ptr<StoredOperationHandler>(new StoredOperationHandler(*this, filesystem));
 }
 
-unsigned int OperationStore::reserveOpNr() {
+unsigned int RequestStore::reserveOpNr() {
     AO_DBG_DEBUG("reserved opNr %u", opEnd);
     auto res = opEnd;
     opEnd++;
@@ -143,7 +143,7 @@ unsigned int OperationStore::reserveOpNr() {
     return res;
 }
 
-void OperationStore::advanceOpNr(unsigned int oldOpNr) {
+void RequestStore::advanceOpNr(unsigned int oldOpNr) {
     if (!opBegin || *opBegin < 0) {
         AO_DBG_ERR("init failure");
         return;
@@ -195,7 +195,7 @@ void OperationStore::advanceOpNr(unsigned int oldOpNr) {
     configuration_save();
 }
 
-unsigned int OperationStore::getOpBegin() {
+unsigned int RequestStore::getOpBegin() {
     if (!opBegin || *opBegin < 0) {
         AO_DBG_ERR("invalid state");
         return 0;
diff --git a/src/ArduinoOcpp/Core/RequestStore.h b/src/ArduinoOcpp/Core/RequestStore.h
index 1cba6bf5..4370d11b 100644
--- a/src/ArduinoOcpp/Core/RequestStore.h
+++ b/src/ArduinoOcpp/Core/RequestStore.h
@@ -13,13 +13,13 @@
 
 namespace ArduinoOcpp {
 
-class OperationStore;
+class RequestStore;
 class FilesystemAdapter;
 template<class T> class Configuration;
 
 class StoredOperationHandler {
 private:
-    OperationStore& context;
+    RequestStore& context;
     int opNr = -1;
     std::shared_ptr<FilesystemAdapter> filesystem;
 
@@ -29,12 +29,12 @@ class StoredOperationHandler {
     bool isPersistent = false;
 
 public:
-    StoredOperationHandler(OperationStore& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {}
+    StoredOperationHandler(RequestStore& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {}
 
-    void setRpc(std::unique_ptr<DynamicJsonDocument> rpc) {this->rpc = std::move(rpc);}
+    void setRpcData(std::unique_ptr<DynamicJsonDocument> rpc) {this->rpc = std::move(rpc);}
     void setPayload(std::unique_ptr<DynamicJsonDocument> payload) {this->payload = std::move(payload);}
 
-    std::unique_ptr<DynamicJsonDocument> getRpc() {return std::move(rpc);}
+    std::unique_ptr<DynamicJsonDocument> getRpcData() {return std::move(rpc);}
     std::unique_ptr<DynamicJsonDocument> getPayload() {return std::move(payload);}
 
     bool commit();
@@ -45,15 +45,15 @@ class StoredOperationHandler {
     int getOpNr() {return isPersistent ? opNr : -1;}
 };
 
-class OperationStore {
+class RequestStore {
 private:
     std::shared_ptr<FilesystemAdapter> filesystem;
     std::shared_ptr<Configuration<int>> opBegin; //Tx-related operations are stored; index of the first pending operation
     unsigned int opEnd = 0; //one place after last number
 
 public:
-    OperationStore() = delete;
-    OperationStore(std::shared_ptr<FilesystemAdapter> filesystem);
+    RequestStore() = delete;
+    RequestStore(std::shared_ptr<FilesystemAdapter> filesystem);
 
     std::unique_ptr<StoredOperationHandler> makeOpHandler();
     std::unique_ptr<StoredOperationHandler> fetchOpHandler(unsigned int opNr);
diff --git a/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp b/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
index 82d947a6..abbd8c85 100644
--- a/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
+++ b/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
@@ -2,22 +2,22 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-std::unique_ptr<OcppOperation> makeOcppOperation(OcppMessage *msg){
+std::unique_ptr<Request> makeRequest(Operation *msg){
     if (msg == nullptr) {
         return nullptr;
     }
-    auto operation = makeOcppOperation();
-    operation->setOcppMessage(std::unique_ptr<OcppMessage>(msg));
+    auto operation = makeRequest();
+    operation->setOperation(std::unique_ptr<Operation>(msg));
     return operation;
 }
 
-std::unique_ptr<OcppOperation> makeOcppOperation(){
-    auto result = std::unique_ptr<OcppOperation>(new OcppOperation());
+std::unique_ptr<Request> makeRequest(){
+    auto result = std::unique_ptr<Request>(new Request());
     return result;
 }
 
diff --git a/src/ArduinoOcpp/Core/SimpleRequestFactory.h b/src/ArduinoOcpp/Core/SimpleRequestFactory.h
index 6eefedbb..94af6333 100644
--- a/src/ArduinoOcpp/Core/SimpleRequestFactory.h
+++ b/src/ArduinoOcpp/Core/SimpleRequestFactory.h
@@ -6,17 +6,17 @@
 #define SIMPLEOCPPOPERATIONFACTORY_H
 
 #include <ArduinoJson.h>
-#include <ArduinoOcpp/Core/OcppOperation.h>
+#include <ArduinoOcpp/Core/Request.h>
 #include <memory>
 #include <functional>
 
 namespace ArduinoOcpp {
 
-class OcppMessage;
+class Operation;
 
-std::unique_ptr<OcppOperation> makeOcppOperation();
+std::unique_ptr<Request> makeRequest();
 
-std::unique_ptr<OcppOperation> makeOcppOperation(OcppMessage *msg);
+std::unique_ptr<Request> makeRequest(Operation *msg);
 
 } //end namespace ArduinoOcpp
 #endif
diff --git a/src/ArduinoOcpp/Core/Time.cpp b/src/ArduinoOcpp/Core/Time.cpp
index dcc8fa05..57041794 100644
--- a/src/ArduinoOcpp/Core/Time.cpp
+++ b/src/ArduinoOcpp/Core/Time.cpp
@@ -2,15 +2,15 @@
 // Copyright Matthias Akstaller 2019 - 2022
 // MIT License
 
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/Platform.h>
 #include <string.h>
 #include <ctype.h>	
 
 namespace ArduinoOcpp {
 
-const OcppTimestamp MIN_TIME = OcppTimestamp(2010, 0, 0, 0, 0, 0);
-const OcppTimestamp MAX_TIME = OcppTimestamp(2037, 0, 0, 0, 0, 0);
+const Timestamp MIN_TIME = Timestamp(2010, 0, 0, 0, 0, 0);
+const Timestamp MAX_TIME = Timestamp(2037, 0, 0, 0, 0, 0);
 
 namespace Clocks {
 
@@ -20,7 +20,7 @@ otime_t lastClockValue = 0;
 /*
  * Basic clock implementation. Works if ao_tick_ms() is exact enough for you and if device doesn't go in sleep mode. 
  */
-OcppClock DEFAULT_CLOCK = [] () {
+Clock DEFAULT_CLOCK = [] () {
     unsigned long tReading = (ao_tick_ms() - lastClockReading) / 1000UL;
     if (tReading > 0) {
         lastClockValue += tReading;
@@ -30,11 +30,11 @@ OcppClock DEFAULT_CLOCK = [] () {
 } //end namespace Clocks
 
 
-OcppTimestamp::OcppTimestamp() {
+Timestamp::Timestamp() {
     
 }
 
-OcppTimestamp::OcppTimestamp(const OcppTimestamp& other) {
+Timestamp::Timestamp(const Timestamp& other) {
     *this = other;
 }
 
@@ -44,7 +44,7 @@ int noDays(int month, int year) {
             ((year % 4 == 0 && (year % 100 != 0 || year % 400 == 0)) ? 29 : 28));
 }
 
-bool OcppTimestamp::setTime(const char *jsonDateString) {
+bool Timestamp::setTime(const char *jsonDateString) {
 
     const int JSONDATE_MINLENGTH = 19;
 
@@ -110,7 +110,7 @@ bool OcppTimestamp::setTime(const char *jsonDateString) {
     return true;
 }
 
-bool OcppTimestamp::toJsonString(char *jsonDateString, size_t buffsize) const {
+bool Timestamp::toJsonString(char *jsonDateString, size_t buffsize) const {
     if (buffsize < JSONDATE_LENGTH + 1) return false;
 
     jsonDateString[0] = ((char) ((year / 1000) % 10)) + '0';
@@ -141,7 +141,7 @@ bool OcppTimestamp::toJsonString(char *jsonDateString, size_t buffsize) const {
     return true;
 }
 
-OcppTimestamp &OcppTimestamp::operator+=(int secs) {
+Timestamp &Timestamp::operator+=(int secs) {
 
     second += secs;
 
@@ -194,11 +194,11 @@ OcppTimestamp &OcppTimestamp::operator+=(int secs) {
     return *this;
 };
 
-OcppTimestamp &OcppTimestamp::operator-=(int secs) {
+Timestamp &Timestamp::operator-=(int secs) {
     return operator+=(-secs);
 }
 
-otime_t OcppTimestamp::operator-(const OcppTimestamp &rhs) const {
+otime_t Timestamp::operator-(const Timestamp &rhs) const {
     //dt = rhs - ocpp_base
     
     int16_t year_base, year_end;
@@ -228,7 +228,7 @@ otime_t OcppTimestamp::operator-(const OcppTimestamp &rhs) const {
     return dt;
 }
 
-OcppTimestamp &OcppTimestamp::operator=(const OcppTimestamp &rhs) {
+Timestamp &Timestamp::operator=(const Timestamp &rhs) {
     year = rhs.year;
     month = rhs.month;
     day = rhs.day;
@@ -239,25 +239,25 @@ OcppTimestamp &OcppTimestamp::operator=(const OcppTimestamp &rhs) {
     return *this;
 }
 
-OcppTimestamp operator+(const OcppTimestamp &lhs, int secs) {
-    OcppTimestamp res = lhs;
+Timestamp operator+(const Timestamp &lhs, int secs) {
+    Timestamp res = lhs;
     res += secs;
     return res;
 }
 
-OcppTimestamp operator-(const OcppTimestamp &lhs, int secs) {
+Timestamp operator-(const Timestamp &lhs, int secs) {
     return operator+(lhs, -secs);
 }
 
-bool operator==(const OcppTimestamp &lhs, const OcppTimestamp &rhs) {
+bool operator==(const Timestamp &lhs, const Timestamp &rhs) {
     return lhs.year == rhs.year && lhs.month == rhs.month && lhs.day == rhs.day && lhs.hour == rhs.hour && lhs.minute == rhs.minute && lhs.second == rhs.second;
 }
 
-bool operator!=(const OcppTimestamp &lhs, const OcppTimestamp &rhs) {
+bool operator!=(const Timestamp &lhs, const Timestamp &rhs) {
     return !(lhs == rhs);
 }
 
-bool operator<(const OcppTimestamp &lhs, const OcppTimestamp &rhs) {
+bool operator<(const Timestamp &lhs, const Timestamp &rhs) {
     if (lhs.year != rhs.year)
         return lhs.year < rhs.year;
     if (lhs.month != rhs.month)
@@ -273,26 +273,26 @@ bool operator<(const OcppTimestamp &lhs, const OcppTimestamp &rhs) {
     return false;  
 }
 
-bool operator<=(const OcppTimestamp &lhs, const OcppTimestamp &rhs) {
+bool operator<=(const Timestamp &lhs, const Timestamp &rhs) {
     return lhs < rhs || lhs == rhs;
 }
 
-bool operator>(const OcppTimestamp &lhs, const OcppTimestamp &rhs) {
+bool operator>(const Timestamp &lhs, const Timestamp &rhs) {
     return rhs < lhs;
 }
 
-bool operator>=(const OcppTimestamp &lhs, const OcppTimestamp &rhs) {
+bool operator>=(const Timestamp &lhs, const Timestamp &rhs) {
     return rhs <= lhs;
 }
 
 
-OcppTime::OcppTime(const OcppClock& system_clock) : system_clock(system_clock) {
+Time::Time(const Clock& system_clock) : system_clock(system_clock) {
 
 }
 
-bool OcppTime::setOcppTime(const char* jsonDateString) {
+bool Time::setTime(const char* jsonDateString) {
 
-    OcppTimestamp timestamp = OcppTimestamp();
+    Timestamp timestamp = Timestamp();
     
     if (!timestamp.setTime(jsonDateString)) {
         return false;
@@ -300,7 +300,7 @@ bool OcppTime::setOcppTime(const char* jsonDateString) {
 
     system_basetime = system_clock();
     ocpp_basetime = timestamp;
-    ocppTimeIsSet = true;
+    timeIsSet = true;
 
     currentTime = ocpp_basetime;
     previousUpdate = system_basetime;
@@ -308,11 +308,11 @@ bool OcppTime::setOcppTime(const char* jsonDateString) {
     return true;
 }
 
-otime_t OcppTime::getOcppTimeScalar() {
+otime_t Time::getTimeScalar() {
     return system_clock();
 }
 
-const OcppTimestamp &OcppTime::getOcppTimestampNow() {
+const Timestamp &Time::getTimestampNow() {
     otime_t tNow = system_clock();
     if (previousUpdate != tNow) {
         currentTime += (tNow - previousUpdate);
@@ -321,14 +321,14 @@ const OcppTimestamp &OcppTime::getOcppTimestampNow() {
     return currentTime;
 }
 
-OcppTimestamp OcppTime::createTimestamp(otime_t scalar) {
-    OcppTimestamp res = ocpp_basetime + (scalar - system_basetime);
+Timestamp Time::createTimestamp(otime_t scalar) {
+    Timestamp res = ocpp_basetime + (scalar - system_basetime);
 
     return res;
 }
 
-otime_t OcppTime::toOcppTimeScalar(const OcppTimestamp &otimestamp) {
-    return otimestamp.operator-(ocpp_basetime);
+otime_t Time::toTimeScalar(const Timestamp &timestamp) {
+    return timestamp.operator-(ocpp_basetime);
 }
 
 }
diff --git a/src/ArduinoOcpp/Core/Time.h b/src/ArduinoOcpp/Core/Time.h
index 906558f8..1d5bf5e4 100644
--- a/src/ArduinoOcpp/Core/Time.h
+++ b/src/ArduinoOcpp/Core/Time.h
@@ -13,7 +13,7 @@ namespace ArduinoOcpp {
 
 typedef int32_t otime_t; //requires 32bit signed integer or bigger
 #define OTIME_MAX ((otime_t) INT32_MAX)
-typedef std::function<otime_t()> OcppClock;
+typedef std::function<otime_t()> Clock;
 
 #define INFINITY_THLD (OTIME_MAX - ((otime_t) (400 * 24 * 3600))) //Upper limiter for valid time range. From this value on, a scalar time means "infinity". It's 400 days before the "year 2038" problem.
 #define JSONDATE_LENGTH 24
@@ -23,10 +23,10 @@ namespace Clocks {
 /*
  * Basic clock implementation. Works if ao_tick_ms() is exact enough for you and if device doesn't go in sleep mode. 
  */
-extern OcppClock DEFAULT_CLOCK;
+extern Clock DEFAULT_CLOCK;
 } //end namespace Clocks
 
-class OcppTimestamp {
+class Timestamp {
 private:
     /*
      * Internal representation of the current time. The initial values correspond to UNIX-time 0. January
@@ -41,11 +41,11 @@ class OcppTimestamp {
 
 public:
 
-    OcppTimestamp();
+    Timestamp();
 
-    OcppTimestamp(const OcppTimestamp& other);
+    Timestamp(const Timestamp& other);
 
-    OcppTimestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second) :
+    Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second) :
                 year(year), month(month), day(day), hour(hour), minute(minute), second(second) { };
 
     /**
@@ -65,48 +65,48 @@ class OcppTimestamp {
 
     bool toJsonString(char *out, size_t buffsize) const;
 
-    OcppTimestamp &operator=(const OcppTimestamp &rhs);
+    Timestamp &operator=(const Timestamp &rhs);
 
-    OcppTimestamp &operator+=(int secs);
-    OcppTimestamp &operator-=(int secs);
+    Timestamp &operator+=(int secs);
+    Timestamp &operator-=(int secs);
 
-    otime_t operator-(const OcppTimestamp &rhs) const;
+    otime_t operator-(const Timestamp &rhs) const;
 
-    friend OcppTimestamp operator+(const OcppTimestamp &lhs, int secs);
-    friend OcppTimestamp operator-(const OcppTimestamp &lhs, int secs);
+    friend Timestamp operator+(const Timestamp &lhs, int secs);
+    friend Timestamp operator-(const Timestamp &lhs, int secs);
 
-    friend bool operator==(const OcppTimestamp &lhs, const OcppTimestamp &rhs);
-    friend bool operator!=(const OcppTimestamp &lhs, const OcppTimestamp &rhs);
-    friend bool operator<(const OcppTimestamp &lhs, const OcppTimestamp &rhs);
-    friend bool operator<=(const OcppTimestamp &lhs, const OcppTimestamp &rhs);
-    friend bool operator>(const OcppTimestamp &lhs, const OcppTimestamp &rhs);
-    friend bool operator>=(const OcppTimestamp &lhs, const OcppTimestamp &rhs);
+    friend bool operator==(const Timestamp &lhs, const Timestamp &rhs);
+    friend bool operator!=(const Timestamp &lhs, const Timestamp &rhs);
+    friend bool operator<(const Timestamp &lhs, const Timestamp &rhs);
+    friend bool operator<=(const Timestamp &lhs, const Timestamp &rhs);
+    friend bool operator>(const Timestamp &lhs, const Timestamp &rhs);
+    friend bool operator>=(const Timestamp &lhs, const Timestamp &rhs);
 };
 
-extern const OcppTimestamp MIN_TIME;
-extern const OcppTimestamp MAX_TIME;
+extern const Timestamp MIN_TIME;
+extern const Timestamp MAX_TIME;
 
-class OcppTime {
+class Time {
 private:
 
-    OcppTimestamp ocpp_basetime = OcppTimestamp();
+    Timestamp ocpp_basetime = Timestamp();
     otime_t system_basetime = 0; //your system clock's time at the moment when the OCPP server's time was taken
-    bool ocppTimeIsSet = false;
+    bool timeIsSet = false;
 
-    OcppClock system_clock = [] () {return (otime_t) 0;};
+    Clock system_clock = [] () {return (otime_t) 0;};
 
-    OcppTimestamp currentTime = OcppTimestamp();
+    Timestamp currentTime = Timestamp();
     otime_t previousUpdate = -1;
 
 public:
 
-    OcppTime(const OcppClock& system_clock);
-    //OcppTime(const OcppTime& ocppTime) = default;
+    Time(const Clock& system_clock);
+    //Time(const Time& time) = default;
 
-    otime_t getOcppTimeScalar(); //returns current time of the OCPP server in non-UNIX but signed integer format. t2 - t1 is the time difference in seconds. 
-    const OcppTimestamp &getOcppTimestampNow();
-    OcppTimestamp createTimestamp(otime_t scalar); //creates a timestamp in a JSON-serializable format. createTimestamp(getOcppTimeScalar()) will return the current OCPP time
-    otime_t toOcppTimeScalar(const OcppTimestamp &otimestamp);
+    otime_t getTimeScalar(); //returns current time of the OCPP server in non-UNIX but signed integer format. t2 - t1 is the time difference in seconds. 
+    const Timestamp &getTimestampNow();
+    Timestamp createTimestamp(otime_t scalar); //creates a timestamp in a JSON-serializable format. createTimestamp(getTimeScalar()) will return the current OCPP time
+    otime_t toTimeScalar(const Timestamp &timestamp);
 
     /**
      * Expects a date string like
@@ -121,9 +121,9 @@ class OcppTime {
      * 
      * jsonDateString: 0-terminated string
      */
-    bool setOcppTime(const char* jsonDateString);
+    bool setTime(const char* jsonDateString);
 
-    bool isValid() {return ocppTimeIsSet;}
+    bool isValid() {return timeIsSet;}
 };
 
 }
diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.cpp b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
index 707cecb0..81bc7ae2 100644
--- a/src/ArduinoOcpp/MessagesV16/Authorize.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Authorize.cpp
@@ -3,14 +3,14 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/Authorize.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::Authorize;
 
-Authorize::Authorize(OcppModel& context, const char *idTagIn) : context(context) {
+Authorize::Authorize(Model& model, const char *idTagIn) : model(model) {
     if (idTagIn && strnlen(idTagIn, IDTAG_LEN_MAX + 2) <= IDTAG_LEN_MAX) {
         snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
     } else {
@@ -19,7 +19,7 @@ Authorize::Authorize(OcppModel& context, const char *idTagIn) : context(context)
     }
 }
 
-const char* Authorize::getOcppOperationType(){
+const char* Authorize::getOperationType(){
     return "Authorize";
 }
 
@@ -39,8 +39,8 @@ void Authorize::processConf(JsonObject payload){
         AO_DBG_INFO("Request has been denied. Reason: %s", idTagInfo);
     }
 
-    if (context.getAuthorizationService()) {
-        context.getAuthorizationService()->notifyAuthorization(idTag, payload["idTagInfo"]);
+    if (model.getAuthorizationService()) {
+        model.getAuthorizationService()->notifyAuthorization(idTag, payload["idTagInfo"]);
     }
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.h b/src/ArduinoOcpp/MessagesV16/Authorize.h
index b4ace5db..c75c611d 100644
--- a/src/ArduinoOcpp/MessagesV16/Authorize.h
+++ b/src/ArduinoOcpp/MessagesV16/Authorize.h
@@ -5,25 +5,25 @@
 #ifndef AUTHORIZE_H
 #define AUTHORIZE_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class Authorize : public OcppMessage {
+class Authorize : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
 public:
 //    Authorize();
 
-    Authorize(OcppModel& context, const char *idTag);
+    Authorize(Model& model, const char *idTag);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
index 740ae185..4ad37450 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Boot/BootService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
@@ -12,11 +12,11 @@
 
 using ArduinoOcpp::Ocpp16::BootNotification;
 
-BootNotification::BootNotification(OcppModel& context, std::unique_ptr<DynamicJsonDocument> payload) : context(context), credentials(std::move(payload)) {
+BootNotification::BootNotification(Model& model, std::unique_ptr<DynamicJsonDocument> payload) : model(model), credentials(std::move(payload)) {
     
 }
 
-const char* BootNotification::getOcppOperationType(){
+const char* BootNotification::getOperationType(){
     return "BootNotification";
 }
 
@@ -32,7 +32,7 @@ std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
 void BootNotification::processConf(JsonObject payload) {
     const char* currentTime = payload["currentTime"] | "Invalid";
     if (strcmp(currentTime, "Invalid")) {
-        if (context.getOcppTime().setOcppTime(currentTime)) {
+        if (model.getTime().setTime(currentTime)) {
             //success
         } else {
             AO_DBG_ERR("Time string format violation. Expect format like 2022-02-01T20:53:32.486Z");
@@ -69,7 +69,7 @@ void BootNotification::processConf(JsonObject payload) {
         }
     }
 
-    if (auto bootService = context.getBootService()) {
+    if (auto bootService = model.getBootService()) {
 
         if (status != RegistrationStatus::Accepted) {
             bootService->setRetryInterval(interval);
@@ -94,10 +94,10 @@ std::unique_ptr<DynamicJsonDocument> BootNotification::createConf(){
     JsonObject payload = doc->to<JsonObject>();
 
     //safety mechanism; in some test setups the library has to answer BootNotifications without valid system time
-    OcppTimestamp ocppTimeReference = OcppTimestamp(2022,0,27,11,59,55); 
-    OcppTimestamp ocppSelect = ocppTimeReference;
-    auto& ocppTime = context.getOcppTime();
-    OcppTimestamp ocppNow = ocppTime.getOcppTimestampNow();
+    Timestamp ocppTimeReference = Timestamp(2022,0,27,11,59,55); 
+    Timestamp ocppSelect = ocppTimeReference;
+    auto& ocppTime = model.getTime();
+    Timestamp ocppNow = ocppTime.getTimestampNow();
     if (ocppNow > ocppTimeReference) {
         //time has already been set
         ocppSelect = ocppNow;
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.h b/src/ArduinoOcpp/MessagesV16/BootNotification.h
index b2285c52..cf073475 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.h
@@ -5,7 +5,7 @@
 #ifndef BOOTNOTIFICATION_H
 #define BOOTNOTIFICATION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
 
 #define CP_MODEL_LEN_MAX        CiString20TypeLen
@@ -15,21 +15,21 @@
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class BootNotification : public OcppMessage {
+class BootNotification : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     std::unique_ptr<DynamicJsonDocument> credentials;
     const char *errorCode = nullptr;
 public:
-    BootNotification(OcppModel& context, std::unique_ptr<DynamicJsonDocument> payload);
+    BootNotification(Model& model, std::unique_ptr<DynamicJsonDocument> payload);
 
     ~BootNotification() = default;
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp b/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
index 3405cb7f..633900ac 100644
--- a/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
+++ b/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
@@ -3,17 +3,17 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/CancelReservation.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::CancelReservation;
 
-CancelReservation::CancelReservation(OcppModel& context) : context(context) {
+CancelReservation::CancelReservation(Model& model) : model(model) {
   
 }
 
-const char* CancelReservation::getOcppOperationType(){
+const char* CancelReservation::getOperationType(){
     return "CancelReservation";
 }
 
@@ -23,8 +23,8 @@ void CancelReservation::processReq(JsonObject payload) {
         return;
     }
 
-    if (context.getReservationService()) {
-        if (auto reservation = context.getReservationService()->getReservationById(payload["reservationId"])) {
+    if (model.getReservationService()) {
+        if (auto reservation = model.getReservationService()->getReservationById(payload["reservationId"])) {
             found = true;
             reservation->clear();
         }
diff --git a/src/ArduinoOcpp/MessagesV16/CancelReservation.h b/src/ArduinoOcpp/MessagesV16/CancelReservation.h
index f6c848aa..bc188792 100644
--- a/src/ArduinoOcpp/MessagesV16/CancelReservation.h
+++ b/src/ArduinoOcpp/MessagesV16/CancelReservation.h
@@ -5,23 +5,23 @@
 #ifndef CANCELRESERVATION_H
 #define CANCELRESERVATION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class CancelReservation : public OcppMessage {
+class CancelReservation : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     bool found = false;
     const char *errorCode = nullptr;
 public:
-    CancelReservation(OcppModel& context);
+    CancelReservation(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
index 95f31787..0a034366 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
@@ -3,18 +3,18 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 
 #include <functional>
 
 using ArduinoOcpp::Ocpp16::ChangeAvailability;
 
-ChangeAvailability::ChangeAvailability(OcppModel& context) : context(context) {
+ChangeAvailability::ChangeAvailability(Model& model) : model(model) {
 
 }
 
-const char* ChangeAvailability::getOcppOperationType(){
+const char* ChangeAvailability::getOperationType(){
     return "ChangeAvailability";
 }
 
@@ -26,7 +26,7 @@ void ChangeAvailability::processReq(JsonObject payload) {
     }
     unsigned int connectorId = (unsigned int) connectorIdRaw;
 
-    if (connectorId >= context.getNumConnectors()) {
+    if (connectorId >= model.getNumConnectors()) {
         errorCode = "PropertyConstraintViolation";
         return;
     }
@@ -45,15 +45,15 @@ void ChangeAvailability::processReq(JsonObject payload) {
     }
 
     if (connectorId == 0) {
-        for (unsigned int cId = 0; cId < context.getNumConnectors(); cId++) {
-            auto connector = context.getConnector(cId);
+        for (unsigned int cId = 0; cId < model.getNumConnectors(); cId++) {
+            auto connector = model.getConnector(cId);
             connector->setAvailability(available);
             if (connector->getAvailability() == AVAILABILITY_INOPERATIVE_SCHEDULED) {
                 scheduled = true;
             }
         }
     } else {
-        auto connector = context.getConnector(connectorId);
+        auto connector = model.getConnector(connectorId);
         connector->setAvailability(available);
         if (connector->getAvailability() == AVAILABILITY_INOPERATIVE_SCHEDULED) {
             scheduled = true;
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
index e9690028..70dc2196 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
+++ b/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
@@ -5,25 +5,25 @@
 #ifndef CHANGEAVAILABILITY_H
 #define CHANGEAVAILABILITY_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class ChangeAvailability : public OcppMessage {
+class ChangeAvailability : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     bool scheduled = false;
     bool accepted = false;
 
     const char *errorCode {nullptr};
 public:
-    ChangeAvailability(OcppModel& context);
+    ChangeAvailability(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
index 71373447..a0c0a378 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
@@ -15,7 +15,7 @@ ChangeConfiguration::ChangeConfiguration() {
   
 }
 
-const char* ChangeConfiguration::getOcppOperationType(){
+const char* ChangeConfiguration::getOperationType(){
     return "ChangeConfiguration";
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
index 9467cba8..ebf5e116 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
+++ b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
@@ -5,12 +5,12 @@
 #ifndef CHANGECONFIGURATION_H
 #define CHANGECONFIGURATION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
 
-class ChangeConfiguration : public OcppMessage {
+class ChangeConfiguration : public Operation {
 private:
     bool reject = false;
     bool rebootRequired = false;
@@ -21,7 +21,7 @@ class ChangeConfiguration : public OcppMessage {
 public:
     ChangeConfiguration();
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/ClearCache.cpp b/src/ArduinoOcpp/MessagesV16/ClearCache.cpp
index 5d6d36cd..10661052 100644
--- a/src/ArduinoOcpp/MessagesV16/ClearCache.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ClearCache.cpp
@@ -12,7 +12,7 @@ ClearCache::ClearCache(std::shared_ptr<FilesystemAdapter> filesystem) : filesyst
   
 }
 
-const char* ClearCache::getOcppOperationType(){
+const char* ClearCache::getOperationType(){
     return "ClearCache";
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/ClearCache.h b/src/ArduinoOcpp/MessagesV16/ClearCache.h
index aa57a54c..b0263364 100644
--- a/src/ArduinoOcpp/MessagesV16/ClearCache.h
+++ b/src/ArduinoOcpp/MessagesV16/ClearCache.h
@@ -5,20 +5,20 @@
 #ifndef CLEARCACHE_H
 #define CLEARCACHE_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
 
-class ClearCache : public OcppMessage {
+class ClearCache : public Operation {
 private:
     std::shared_ptr<FilesystemAdapter> filesystem;
     bool success = true;
 public:
     ClearCache(std::shared_ptr<FilesystemAdapter> filesystem);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp b/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
index 2d541170..26923568 100644
--- a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -11,11 +11,11 @@
 
 using ArduinoOcpp::Ocpp16::ClearChargingProfile;
 
-ClearChargingProfile::ClearChargingProfile(OcppModel& context) : context(context) {
+ClearChargingProfile::ClearChargingProfile(Model& model) : model(model) {
 
 }
 
-const char* ClearChargingProfile::getOcppOperationType(){
+const char* ClearChargingProfile::getOperationType(){
     return "ClearChargingProfile";
 }
 
@@ -63,7 +63,7 @@ void ClearChargingProfile::processReq(JsonObject payload) {
         return true;
     };
 
-    if (auto scService = context.getSmartChargingService()) {
+    if (auto scService = model.getSmartChargingService()) {
         matchingProfilesFound = scService->clearChargingProfile(filter);
     } else {
         AO_DBG_ERR("SmartChargingService not initialized");
diff --git a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h b/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h
index 11135688..98d76ba0 100644
--- a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h
+++ b/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h
@@ -5,23 +5,23 @@
 #ifndef CLEARCHARGINGPROFILE_H
 #define CLEARCHARGINGPROFILE_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class ClearChargingProfile : public OcppMessage {
+class ClearChargingProfile : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     bool matchingProfilesFound = false;
     const char *errorCode;
 public:
-    ClearChargingProfile(OcppModel& context);
+    ClearChargingProfile(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp b/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
index 26b31d46..790084ac 100644
--- a/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
@@ -40,7 +40,7 @@ CustomMessage::~CustomMessage() {
 
 }
 
-const char* CustomMessage::getOcppOperationType() {
+const char* CustomMessage::getOperationType() {
     return operationType.c_str();
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/CustomMessage.h b/src/ArduinoOcpp/MessagesV16/CustomMessage.h
index 84062bfa..b190fb4e 100644
--- a/src/ArduinoOcpp/MessagesV16/CustomMessage.h
+++ b/src/ArduinoOcpp/MessagesV16/CustomMessage.h
@@ -5,7 +5,7 @@
 #ifndef FUNCTIONALMESSAGE_H
 #define FUNCTIONALMESSAGE_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 #include <functional>
 
@@ -13,7 +13,7 @@ namespace ArduinoOcpp {
 
 namespace Ocpp16 {
 
-class CustomMessage : public OcppMessage {
+class CustomMessage : public Operation {
 private:
     std::string operationType;
     std::function<void (StoredOperationHandler*)> fn_initiate; //optional
@@ -46,7 +46,7 @@ class CustomMessage : public OcppMessage {
     
     ~CustomMessage();
 
-    const char* getOcppOperationType() override;
+    const char* getOperationType() override;
 
     void initiate(StoredOperationHandler *opStore) override;
 
diff --git a/src/ArduinoOcpp/MessagesV16/DataTransfer.cpp b/src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
index ee544883..a7816f74 100644
--- a/src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
+++ b/src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
@@ -11,7 +11,7 @@ DataTransfer::DataTransfer(const std::string &msg) {
     this->msg = msg;
 }
 
-const char* DataTransfer::getOcppOperationType(){
+const char* DataTransfer::getOperationType(){
     return "DataTransfer";
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/DataTransfer.h b/src/ArduinoOcpp/MessagesV16/DataTransfer.h
index f4bdf741..7b2e2346 100644
--- a/src/ArduinoOcpp/MessagesV16/DataTransfer.h
+++ b/src/ArduinoOcpp/MessagesV16/DataTransfer.h
@@ -5,18 +5,18 @@
 #ifndef DATATRANSFER_H
 #define DATATRANSFER_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
 
-class DataTransfer : public OcppMessage {
+class DataTransfer : public Operation {
 private:
     std::string msg {};
 public:
     DataTransfer(const std::string &msg);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
index 21cc18b5..bcc43b69 100644
--- a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
@@ -3,8 +3,8 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
 
 using ArduinoOcpp::Ocpp16::DiagnosticsStatusNotification;
diff --git a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h b/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h
index 45a2091d..c68938da 100644
--- a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h>
 
 #ifndef DIAGNOSTICSSTATUSNOTIFICATION_H
@@ -11,14 +11,14 @@
 namespace ArduinoOcpp {
 namespace Ocpp16 {
 
-class DiagnosticsStatusNotification : public OcppMessage {
+class DiagnosticsStatusNotification : public Operation {
 private:
     DiagnosticsStatus status = DiagnosticsStatus::Idle;
     static const char *cstrFromStatus(DiagnosticsStatus status);
 public:
     DiagnosticsStatusNotification(DiagnosticsStatus status);
 
-    const char* getOcppOperationType() {return "DiagnosticsStatusNotification"; }
+    const char* getOperationType() {return "DiagnosticsStatusNotification"; }
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
index 6440925f..f5b91845 100644
--- a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
@@ -3,8 +3,8 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 
 using ArduinoOcpp::Ocpp16::FirmwareStatusNotification;
diff --git a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h b/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h
index d9fbb813..b9b91afc 100644
--- a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h>
 
@@ -12,14 +12,14 @@
 namespace ArduinoOcpp {
 namespace Ocpp16 {
 
-class FirmwareStatusNotification : public OcppMessage {
+class FirmwareStatusNotification : public Operation {
 private:
     FirmwareStatus status = FirmwareStatus::Idle;
     static const char *cstrFromFwStatus(FirmwareStatus status);
 public:
     FirmwareStatusNotification(FirmwareStatus status);
 
-    const char* getOcppOperationType() {return "FirmwareStatusNotification"; }
+    const char* getOperationType() {return "FirmwareStatusNotification"; }
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
index 2c404f95..5abd782a 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
@@ -12,11 +12,11 @@
 
 using ArduinoOcpp::Ocpp16::GetCompositeSchedule;
 
-GetCompositeSchedule::GetCompositeSchedule(OcppModel& context) : context(context) {
+GetCompositeSchedule::GetCompositeSchedule(Model& model) : model(model) {
 
 }
 
-const char* GetCompositeSchedule::getOcppOperationType() {
+const char* GetCompositeSchedule::getOperationType() {
     return "GetCompositeSchedule";
 }
 
@@ -30,7 +30,7 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
         return;
     }
 
-    if ((unsigned int) connectorId >= context.getNumConnectors()) {
+    if ((unsigned int) connectorId >= model.getNumConnectors()) {
         errorCode = "PropertyConstraintViolation";
     }
 
@@ -44,14 +44,14 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
         errorCode = "PropertyConstraintViolation";
     }
 
-    if (!context.getSmartChargingService()) {
+    if (!model.getSmartChargingService()) {
         AO_DBG_ERR("SmartChargingService not initialized! Ignore request");
         errorCode = "NotSupported";
     }
 }
 
 std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
-    auto scService = context.getSmartChargingService();
+    auto scService = model.getSmartChargingService();
     if (!scService) {
         AO_DBG_ERR("invalid state");
         return createEmptyDocument();
@@ -78,7 +78,7 @@ std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
         if (startSchedule[0] != '\0') {
             strncpy(scheduleStart, startSchedule, JSONDATE_LENGTH + 1);
         } else {
-            context.getOcppTime().getOcppTimestampNow().toJsonString(scheduleStart, JSONDATE_LENGTH + 1);
+            model.getTime().getTimestampNow().toJsonString(scheduleStart, JSONDATE_LENGTH + 1);
         }
         payload["scheduleStart"] = scheduleStart;
         
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
index e9eeb401..f00f9e8e 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
@@ -5,28 +5,28 @@
 #ifndef GETCOMPOSITESCHEDULE_H
 #define GETCOMPOSITESCHEDULE_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Operation.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class GetCompositeSchedule : public OcppMessage {
+class GetCompositeSchedule : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     int connectorId {-1};
     otime_t duration {0};
     ChargingRateUnitType chargingRateUnit {ChargingRateUnitType::Watt};
 
     const char *errorCode {nullptr};
 public:
-    GetCompositeSchedule(OcppModel& context);
+    GetCompositeSchedule(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
index 63935a70..c4711990 100644
--- a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
@@ -12,7 +12,7 @@ GetConfiguration::GetConfiguration() {
 
 }
 
-const char* GetConfiguration::getOcppOperationType(){
+const char* GetConfiguration::getOperationType(){
     return "GetConfiguration";
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetConfiguration.h b/src/ArduinoOcpp/MessagesV16/GetConfiguration.h
index 3cfc0127..7e84ade7 100644
--- a/src/ArduinoOcpp/MessagesV16/GetConfiguration.h
+++ b/src/ArduinoOcpp/MessagesV16/GetConfiguration.h
@@ -5,20 +5,20 @@
 #ifndef GETCONFIGURATION_H
 #define GETCONFIGURATION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 #include <vector>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
 
-class GetConfiguration : public OcppMessage {
+class GetConfiguration : public Operation {
 private:
     std::vector<std::string> keys;
 public:
     GetConfiguration();
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
index e239c3f0..31ff8f1b 100644
--- a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
@@ -3,13 +3,13 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/GetDiagnostics.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::GetDiagnostics;
 
-GetDiagnostics::GetDiagnostics(OcppModel& context) : context(context) {
+GetDiagnostics::GetDiagnostics(Model& model) : model(model) {
 
 }
 
@@ -53,7 +53,7 @@ void GetDiagnostics::processReq(JsonObject payload) {
 }
 
 std::unique_ptr<DynamicJsonDocument> GetDiagnostics::createConf(){
-    if (auto diagService = context.getDiagnosticsService()) {
+    if (auto diagService = model.getDiagnosticsService()) {
         fileName = diagService->requestDiagnosticsUpload(location, retries, retryInterval, startTime, stopTime);
     } else {
         AO_DBG_WARN("DiagnosticsService has not been initialized before! Please have a look at ArduinoOcpp.cpp for an example. Abort");
diff --git a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
index 23e68671..66bd7408 100644
--- a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
+++ b/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
@@ -5,31 +5,31 @@
 #ifndef GETDIAGNOSTICS_H
 #define GETDIAGNOSTICS_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Operation.h>
+#include <ArduinoOcpp/Core/Time.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class GetDiagnostics : public OcppMessage {
+class GetDiagnostics : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     std::string location {};
     int retries = 1;
     unsigned long retryInterval = 180;
-    OcppTimestamp startTime = OcppTimestamp();
-    OcppTimestamp stopTime = OcppTimestamp();
+    Timestamp startTime = Timestamp();
+    Timestamp stopTime = Timestamp();
 
     std::string fileName {};
     
     bool formatError = false;
 public:
-    GetDiagnostics(OcppModel& context);
+    GetDiagnostics(Model& model);
 
-    const char* getOcppOperationType() {return "GetDiagnostics";}
+    const char* getOperationType() {return "GetDiagnostics";}
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
index 04c9548b..64869c0b 100644
--- a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
@@ -3,17 +3,17 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/GetLocalListVersion.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::GetLocalListVersion;
 
-GetLocalListVersion::GetLocalListVersion(OcppModel& context) : context(context) {
+GetLocalListVersion::GetLocalListVersion(Model& model) : model(model) {
   
 }
 
-const char* GetLocalListVersion::getOcppOperationType(){
+const char* GetLocalListVersion::getOperationType(){
     return "GetLocalListVersion";
 }
 
@@ -24,7 +24,7 @@ void GetLocalListVersion::processReq(JsonObject payload) {
 std::unique_ptr<DynamicJsonDocument> GetLocalListVersion::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    if (auto authService = context.getAuthorizationService()) {
+    if (auto authService = model.getAuthorizationService()) {
         payload["listVersion"] = authService->getLocalListVersion();
     } else {
         payload["listVersion"] = -1;
diff --git a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h
index c937342f..3e06d13d 100644
--- a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h
+++ b/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h
@@ -5,21 +5,21 @@
 #ifndef GETLOCALLISTVERSION_H
 #define GETLOCALLISTVERSION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class GetLocalListVersion : public OcppMessage {
+class GetLocalListVersion : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
 public:
-    GetLocalListVersion(OcppModel& context);
+    GetLocalListVersion(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp b/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
index 81f26996..e46be775 100644
--- a/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
@@ -3,17 +3,17 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/Heartbeat.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Debug.h>
 #include <string.h>
 
 using ArduinoOcpp::Ocpp16::Heartbeat;
 
-Heartbeat::Heartbeat(OcppModel& context) : context(context) {
+Heartbeat::Heartbeat(Model& model) : model(model) {
   
 }
 
-const char* Heartbeat::getOcppOperationType(){
+const char* Heartbeat::getOperationType(){
     return "Heartbeat";
 }
 
@@ -25,7 +25,7 @@ void Heartbeat::processConf(JsonObject payload) {
   
     const char* currentTime = payload["currentTime"] | "Invalid";
     if (strcmp(currentTime, "Invalid")) {
-        if (context.getOcppTime().setOcppTime(currentTime)) {
+        if (model.getTime().setTime(currentTime)) {
             //success
             AO_DBG_DEBUG("Request has been accepted");
         } else {
@@ -49,9 +49,9 @@ std::unique_ptr<DynamicJsonDocument> Heartbeat::createConf(){
     JsonObject payload = doc->to<JsonObject>();
 
     //safety mechanism; in some test setups the library could have to answer Heartbeats without valid system time
-    OcppTimestamp ocppTimeReference = OcppTimestamp(2019,10,0,11,59,55); 
-    OcppTimestamp ocppSelect = ocppTimeReference;
-    auto& ocppNow = context.getOcppTime().getOcppTimestampNow();
+    Timestamp ocppTimeReference = Timestamp(2019,10,0,11,59,55); 
+    Timestamp ocppSelect = ocppTimeReference;
+    auto& ocppNow = model.getTime().getTimestampNow();
     if (ocppNow > ocppTimeReference) {
         //time has already been set
         ocppSelect = ocppNow;
diff --git a/src/ArduinoOcpp/MessagesV16/Heartbeat.h b/src/ArduinoOcpp/MessagesV16/Heartbeat.h
index c035c386..0cbad4ec 100644
--- a/src/ArduinoOcpp/MessagesV16/Heartbeat.h
+++ b/src/ArduinoOcpp/MessagesV16/Heartbeat.h
@@ -5,21 +5,21 @@
 #ifndef HEARTBEAT_H
 #define HEARTBEAT_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class Heartbeat : public OcppMessage {
+class Heartbeat : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
 public:
-    Heartbeat(OcppModel& context);
+    Heartbeat(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index 99013807..492c9ba1 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
@@ -26,7 +26,7 @@ MeterValues::~MeterValues(){
 
 }
 
-const char* MeterValues::getOcppOperationType(){
+const char* MeterValues::getOperationType(){
     return "MeterValues";
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.h b/src/ArduinoOcpp/MessagesV16/MeterValues.h
index a0ef53de..bb895ab5 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.h
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.h
@@ -5,8 +5,8 @@
 #ifndef METERVALUES_H
 #define METERVALUES_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Operation.h>
+#include <ArduinoOcpp/Core/Time.h>
 
 #include <vector>
 
@@ -17,7 +17,7 @@ class Transaction;
 
 namespace Ocpp16 {
 
-class MeterValues : public OcppMessage {
+class MeterValues : public Operation {
 private:
     std::vector<std::unique_ptr<MeterValue>> meterValue;
 
@@ -32,7 +32,7 @@ class MeterValues : public OcppMessage {
 
     ~MeterValues();
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
index 5a6e9ee6..01284874 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
@@ -4,7 +4,7 @@
 
 
 #include <ArduinoOcpp/MessagesV16/RemoteStartTransaction.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
@@ -12,11 +12,11 @@
 
 using ArduinoOcpp::Ocpp16::RemoteStartTransaction;
 
-RemoteStartTransaction::RemoteStartTransaction(OcppModel& context) : context(context) {
+RemoteStartTransaction::RemoteStartTransaction(Model& model) : model(model) {
   
 }
 
-const char* RemoteStartTransaction::getOcppOperationType() {
+const char* RemoteStartTransaction::getOperationType() {
     return "RemoteStartTransaction";
 }
 
@@ -55,7 +55,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
     bool canStartTransaction = false;
     if (connectorId >= 1) {
         //connectorId specified for given connector, try to start Transaction here
-        if (auto connector = context.getConnector(connectorId)){
+        if (auto connector = model.getConnector(connectorId)){
             if (connector->getTransactionId() < 0 &&
                         connector->getAvailability() == AVAILABILITY_OPERATIVE &&
                         connector->getSessionIdTag() == nullptr) {
@@ -64,8 +64,8 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         }
     } else {
         //connectorId not specified. Find free connector
-        for (unsigned int cid = 1; cid < context.getNumConnectors(); cid++) {
-            auto connector = context.getConnector(cid);
+        for (unsigned int cid = 1; cid < model.getNumConnectors(); cid++) {
+            auto connector = model.getConnector(cid);
             if (connector->getTransactionId() < 0 && 
                         connector->getAvailability() == AVAILABILITY_OPERATIVE &&
                         connector->getSessionIdTag() == nullptr) {
@@ -80,7 +80,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
 
         auto sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, AO_KEYVALUE_FN, false, false, true, false);
 
-        if (auto scService = context.getSmartChargingService()) {
+        if (auto scService = model.getSmartChargingService()) {
 
             if (*sRmtProfileId >= 0) {
                 int clearProfileId = *sRmtProfileId;
@@ -95,13 +95,13 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
             }
         }
 
-        if (auto connector = context.getConnector(connectorId)) {
+        if (auto connector = model.getConnector(connectorId)) {
             connector->beginTransaction(idTag);
         }
 
         if (!chargingProfileDoc.isNull()
-                && (context.getSmartChargingService())) {
-            auto scService = context.getSmartChargingService();
+                && (model.getSmartChargingService())) {
+            auto scService = model.getSmartChargingService();
 
             JsonObject chargingProfile = chargingProfileDoc.as<JsonObject>();
             scService->setChargingProfile(chargingProfile);
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
index bd076c3c..0e66989a 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
@@ -5,27 +5,27 @@
 #ifndef REMOTESTARTTRANSACTION_H
 #define REMOTESTARTTRANSACTION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class RemoteStartTransaction : public OcppMessage {
+class RemoteStartTransaction : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     int connectorId;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
     DynamicJsonDocument chargingProfileDoc {0};
     
     const char *errorCode {nullptr};
 public:
-    RemoteStartTransaction(OcppModel& context);
+    RemoteStartTransaction(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
index a352bf09..489fa7c4 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
@@ -3,16 +3,16 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/RemoteStopTransaction.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 
 using ArduinoOcpp::Ocpp16::RemoteStopTransaction;
 
-RemoteStopTransaction::RemoteStopTransaction(OcppModel& context) : context(context) {
+RemoteStopTransaction::RemoteStopTransaction(Model& model) : model(model) {
   
 }
 
-const char* RemoteStopTransaction::getOcppOperationType(){
+const char* RemoteStopTransaction::getOperationType(){
     return "RemoteStopTransaction";
 }
 
@@ -26,8 +26,8 @@ std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
     
     bool canStopTransaction = false;
 
-    for (unsigned int cId = 0; cId < context.getNumConnectors(); cId++) {
-        auto connector = context.getConnector(cId);
+    for (unsigned int cId = 0; cId < model.getNumConnectors(); cId++) {
+        auto connector = model.getConnector(cId);
         if (connector->getTransactionId() == transactionId) {
             canStopTransaction = true;
             connector->endTransaction("Remote");
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h
index b6558941..48dc83e3 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h
@@ -5,22 +5,22 @@
 #ifndef REMOTESTOPTRANSACTION_H
 #define REMOTESTOPTRANSACTION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class RemoteStopTransaction : public OcppMessage {
+class RemoteStopTransaction : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     int transactionId;
 public:
-    RemoteStopTransaction(OcppModel& context);
+    RemoteStopTransaction(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
index d936bf4f..7ea39588 100644
--- a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
@@ -3,14 +3,14 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/ReserveNow.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Platform.h>
 
 using ArduinoOcpp::Ocpp16::ReserveNow;
 
-ReserveNow::ReserveNow(OcppModel& context) : context(context) {
+ReserveNow::ReserveNow(Model& model) : model(model) {
   
 }
 
@@ -18,7 +18,7 @@ ReserveNow::~ReserveNow() {
   
 }
 
-const char* ReserveNow::getOcppOperationType(){
+const char* ReserveNow::getOperationType(){
     return "ReserveNow";
 }
 
@@ -33,7 +33,7 @@ void ReserveNow::processReq(JsonObject payload) {
         return;
     }
 
-    OcppTimestamp validateTimestamp;
+    Timestamp validateTimestamp;
     if (!validateTimestamp.setTime(payload["expiryDate"])) {
         AO_DBG_WARN("bad time format");
         errorCode = "PropertyConstraintViolation";
@@ -42,12 +42,12 @@ void ReserveNow::processReq(JsonObject payload) {
 
     unsigned int connectorId = payload["connectorId"];
 
-    if (context.getReservationService() &&
-                context.getNumConnectors() > 0) {
-        auto rService = context.getReservationService();
-        auto chargePoint = context.getConnector(0);
+    if (model.getReservationService() &&
+                model.getNumConnectors() > 0) {
+        auto rService = model.getReservationService();
+        auto chargePoint = model.getConnector(0);
 
-        if (connectorId >= context.getNumConnectors()) {
+        if (connectorId >= model.getNumConnectors()) {
             errorCode = "PropertyConstraintViolation";
             return;
         }
@@ -67,7 +67,7 @@ void ReserveNow::processReq(JsonObject payload) {
         Connector *connector = nullptr;
         
         if (connectorId > 0) {
-            connector = context.getConnector(connectorId);
+            connector = model.getConnector(connectorId);
         }
 
         if (chargePoint->inferenceStatus() == OcppEvseState::Faulted ||
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.h b/src/ArduinoOcpp/MessagesV16/ReserveNow.h
index 8c762222..bff93718 100644
--- a/src/ArduinoOcpp/MessagesV16/ReserveNow.h
+++ b/src/ArduinoOcpp/MessagesV16/ReserveNow.h
@@ -5,25 +5,25 @@
 #ifndef RESERVENOW_H
 #define RESERVENOW_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class ReserveNow : public OcppMessage {
+class ReserveNow : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     const char *errorCode = nullptr;
     const char *reservationStatus = nullptr;
 public:
-    ReserveNow(OcppModel& context);
+    ReserveNow(Model& model);
 
     ~ReserveNow();
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.cpp b/src/ArduinoOcpp/MessagesV16/Reset.cpp
index 17d71da6..c78b3be4 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Reset.cpp
@@ -3,16 +3,16 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/Reset.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Reset/ResetService.h>
 
 using ArduinoOcpp::Ocpp16::Reset;
 
-Reset::Reset(OcppModel& context) : context(context) {
+Reset::Reset(Model& model) : model(model) {
   
 }
 
-const char* Reset::getOcppOperationType(){
+const char* Reset::getOperationType(){
     return "Reset";
 }
 
@@ -23,7 +23,7 @@ void Reset::processReq(JsonObject payload) {
      */
     bool isHard = !strcmp(payload["type"] | "undefined", "Hard");
 
-    if (auto rService = context.getResetService()) {
+    if (auto rService = model.getResetService()) {
         if (!rService->getExecuteReset()) {
             AO_DBG_ERR("No reset handler set. Abort operation");
             (void)0;
@@ -32,8 +32,8 @@ void Reset::processReq(JsonObject payload) {
             if (!rService->getPreReset() || rService->getPreReset()(isHard) || isHard) {
                 resetAccepted = true;
                 rService->initiateReset(isHard);
-                for (unsigned int cId = 0; cId < context.getNumConnectors(); cId++) {
-                    context.getConnector(cId)->endTransaction(isHard ? "HardReset" : "SoftReset");
+                for (unsigned int cId = 0; cId < model.getNumConnectors(); cId++) {
+                    model.getConnector(cId)->endTransaction(isHard ? "HardReset" : "SoftReset");
                 }
             }
         }
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.h b/src/ArduinoOcpp/MessagesV16/Reset.h
index 2acdb493..f79cbb11 100644
--- a/src/ArduinoOcpp/MessagesV16/Reset.h
+++ b/src/ArduinoOcpp/MessagesV16/Reset.h
@@ -5,22 +5,22 @@
 #ifndef RESET_H
 #define RESET_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class Reset : public OcppMessage {
+class Reset : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     bool resetAccepted {false};
 public:
-    Reset(OcppModel& context);
+    Reset(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp b/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
index ab5f6966..c7ef58b2 100644
--- a/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
+++ b/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
@@ -3,12 +3,12 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/SendLocalList.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 
 using ArduinoOcpp::Ocpp16::SendLocalList;
 
-SendLocalList::SendLocalList(OcppModel& context) : context(context) {
+SendLocalList::SendLocalList(Model& model) : model(model) {
   
 }
 
@@ -16,7 +16,7 @@ SendLocalList::~SendLocalList() {
   
 }
 
-const char* SendLocalList::getOcppOperationType(){
+const char* SendLocalList::getOperationType(){
     return "SendLocalList";
 }
 
@@ -26,7 +26,7 @@ void SendLocalList::processReq(JsonObject payload) {
         return;
     }
 
-    auto authService = context.getAuthorizationService();
+    auto authService = model.getAuthorizationService();
 
     if (!authService) {
         errorCode = "InternalError";
diff --git a/src/ArduinoOcpp/MessagesV16/SendLocalList.h b/src/ArduinoOcpp/MessagesV16/SendLocalList.h
index ee2a1dec..be31db31 100644
--- a/src/ArduinoOcpp/MessagesV16/SendLocalList.h
+++ b/src/ArduinoOcpp/MessagesV16/SendLocalList.h
@@ -5,26 +5,26 @@
 #ifndef SENDLOCALLIST_H
 #define SENDLOCALLIST_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class SendLocalList : public OcppMessage {
+class SendLocalList : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     const char *errorCode = nullptr;
     bool updateFailure = true;
     bool versionMismatch = false;
 public:
-    SendLocalList(OcppModel& context);
+    SendLocalList(Model& model);
 
     ~SendLocalList();
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
index 5f5647da..8d093b2f 100644
--- a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
+++ b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
@@ -3,25 +3,25 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/SetChargingProfile.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::SetChargingProfile;
 
-SetChargingProfile::SetChargingProfile(OcppModel& context) : context(context) {
+SetChargingProfile::SetChargingProfile(Model& model) : model(model) {
 
 }
 
-SetChargingProfile::SetChargingProfile(OcppModel& context, std::unique_ptr<DynamicJsonDocument> payloadToClient)
-        : context(context), payloadToClient{std::move(payloadToClient)} {
+SetChargingProfile::SetChargingProfile(Model& model, std::unique_ptr<DynamicJsonDocument> payloadToClient)
+        : model(model), payloadToClient{std::move(payloadToClient)} {
 }
 
 SetChargingProfile::~SetChargingProfile() {
 
 }
 
-const char* SetChargingProfile::getOcppOperationType(){
+const char* SetChargingProfile::getOperationType(){
     return "SetChargingProfile";
 }
 
@@ -31,7 +31,7 @@ void SetChargingProfile::processReq(JsonObject payload) {
 
     JsonObject csChargingProfiles = payload["csChargingProfiles"];
 
-    if (auto scService = context.getSmartChargingService()) {
+    if (auto scService = model.getSmartChargingService()) {
         scService->setChargingProfile(csChargingProfiles);
     }
 }
diff --git a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.h b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.h
index ac58ff08..91c30ab0 100644
--- a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.h
+++ b/src/ArduinoOcpp/MessagesV16/SetChargingProfile.h
@@ -5,26 +5,26 @@
 #ifndef SETCHARGINGPROFILE_H
 #define SETCHARGINGPROFILE_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class SetChargingProfile : public OcppMessage {
+class SetChargingProfile : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     std::unique_ptr<DynamicJsonDocument> payloadToClient;
 public:
-    SetChargingProfile(OcppModel& context);
+    SetChargingProfile(Model& model);
 
-    SetChargingProfile(OcppModel& context, std::unique_ptr<DynamicJsonDocument> payloadToClient);
+    SetChargingProfile(Model& model, std::unique_ptr<DynamicJsonDocument> payloadToClient);
 
     ~SetChargingProfile();
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 1f89b5a6..7b6a9a1d 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -3,8 +3,8 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Core/RequestStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
@@ -15,7 +15,7 @@ using ArduinoOcpp::Ocpp16::StartTransaction;
 using ArduinoOcpp::TransactionRPC;
 
 
-StartTransaction::StartTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction) : context(context), transaction(transaction) {
+StartTransaction::StartTransaction(Model& model, std::shared_ptr<Transaction> transaction) : model(model), transaction(transaction) {
     
 }
 
@@ -23,12 +23,12 @@ StartTransaction::~StartTransaction() {
     
 }
 
-const char* StartTransaction::getOcppOperationType() {
+const char* StartTransaction::getOperationType() {
     return "StartTransaction";
 }
 
 void StartTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!transaction || transaction->getStartRpcSync().isRequested()) {
+    if (!transaction || transaction->getStartRpcData().isRequested()) {
         AO_DBG_ERR("initialization error");
         return;
     }
@@ -42,7 +42,7 @@ void StartTransaction::initiate(StoredOperationHandler *opStore) {
         opStore->commit();
     }
 
-    transaction->getStartRpcSync().setRequested();
+    transaction->getStartRpcData().setRequested();
 
     transaction->commit();
 
@@ -68,7 +68,7 @@ bool StartTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
-    auto txStore = context.getTransactionStore();
+    auto txStore = model.getTransactionStore();
 
     if (!txStore) {
         AO_DBG_ERR("invalid state");
@@ -80,7 +80,7 @@ bool StartTransaction::restore(StoredOperationHandler *opStore) {
         AO_DBG_ERR("referential integrity violation");
 
         //clean up possible tx records
-        if (auto mSerivce = context.getMeteringService()) {
+        if (auto mSerivce = model.getMeteringService()) {
             mSerivce->removeTxMeterData(connectorId, txNr);
         }
         return false;
@@ -134,10 +134,10 @@ void StartTransaction::processConf(JsonObject payload) {
     int transactionId = payload["transactionId"] | -1;
     transaction->setTransactionId(transactionId);
 
-    transaction->getStartRpcSync().confirm();
+    transaction->getStartRpcData().confirm();
     transaction->commit();
 
-    if (auto authService = context.getAuthorizationService()) {
+    if (auto authService = model.getAuthorizationService()) {
         authService->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
     }
 }
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.h b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
index f63b49fe..7ad4a2fc 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.h
@@ -5,29 +5,29 @@
 #ifndef STARTTRANSACTION_H
 #define STARTTRANSACTION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Operation.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 class Transaction;
 
 namespace Ocpp16 {
 
-class StartTransaction : public OcppMessage {
+class StartTransaction : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     std::shared_ptr<Transaction> transaction;
 public:
 
-    StartTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction);
+    StartTransaction(Model& model, std::shared_ptr<Transaction> transaction);
 
     ~StartTransaction();
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void initiate(StoredOperationHandler *opStore) override;
 
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index be4db21f..4390f401 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Debug.h>
 
 #include <string.h>
@@ -43,13 +43,13 @@ const char *cstrFromOcppEveState(OcppEvseState state) {
 }
 }} //end namespaces
 
-StatusNotification::StatusNotification(int connectorId, OcppEvseState currentStatus, const OcppTimestamp &otimestamp, const char *errorCode) 
-  : connectorId(connectorId), currentStatus(currentStatus), otimestamp(otimestamp), errorCode(errorCode) {
+StatusNotification::StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, const char *errorCode) 
+  : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorCode(errorCode) {
 
     AO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
 }
 
-const char* StatusNotification::getOcppOperationType(){
+const char* StatusNotification::getOperationType(){
     return "StatusNotification";
 }
 
@@ -70,9 +70,9 @@ std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
 
     payload["status"] = cstrFromOcppEveState(currentStatus);
 
-    char timestamp[JSONDATE_LENGTH + 1] = {'\0'};
-    otimestamp.toJsonString(timestamp, JSONDATE_LENGTH + 1);
-    payload["timestamp"] = timestamp;
+    char timestamp_cstr[JSONDATE_LENGTH + 1] = {'\0'};
+    timestamp.toJsonString(timestamp_cstr, JSONDATE_LENGTH + 1);
+    payload["timestamp"] = timestamp_cstr;
 
     return doc;
 }
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.h b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
index e89ec222..bbf8e941 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
@@ -5,23 +5,23 @@
 #ifndef STATUSNOTIFICATION_H
 #define STATUSNOTIFICATION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Operation.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
 
-class StatusNotification : public OcppMessage {
+class StatusNotification : public Operation {
 private:
     int connectorId = 1;
     OcppEvseState currentStatus = OcppEvseState::NOT_SET;
-    OcppTimestamp otimestamp;
+    Timestamp timestamp;
     const char *errorCode = nullptr; //nullptr is equivalent to "NoError"
 public:
-    StatusNotification(int connectorId, OcppEvseState currentStatus, const OcppTimestamp &otimestamp, const char *errorCode = nullptr);
+    StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, const char *errorCode = nullptr);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     std::unique_ptr<DynamicJsonDocument> createReq();
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index e1c42d69..c061fef1 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -3,8 +3,8 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Core/OperationStore.h>
+#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Core/RequestStore.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
@@ -15,22 +15,22 @@
 using ArduinoOcpp::Ocpp16::StopTransaction;
 using ArduinoOcpp::TransactionRPC;
 
-StopTransaction::StopTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction)
-        : context(context), transaction(transaction) {
+StopTransaction::StopTransaction(Model& model, std::shared_ptr<Transaction> transaction)
+        : model(model), transaction(transaction) {
 
 }
 
-StopTransaction::StopTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData)
-        : context(context), transaction(transaction), transactionData(std::move(transactionData)) {
+StopTransaction::StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData)
+        : model(model), transaction(transaction), transactionData(std::move(transactionData)) {
 
 }
 
-const char* StopTransaction::getOcppOperationType() {
+const char* StopTransaction::getOperationType() {
     return "StopTransaction";
 }
 
 void StopTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!transaction || transaction->getStopRpcSync().isRequested()) {
+    if (!transaction || transaction->getStopRpcData().isRequested()) {
         AO_DBG_ERR("initialization error");
         return;
     }
@@ -44,7 +44,7 @@ void StopTransaction::initiate(StoredOperationHandler *opStore) {
         opStore->commit();
     }
 
-    transaction->getStopRpcSync().setRequested();
+    transaction->getStopRpcData().setRequested();
 
     transaction->commit();
 
@@ -70,7 +70,7 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
-    auto txStore = context.getTransactionStore();
+    auto txStore = model.getTransactionStore();
 
     if (!txStore) {
         AO_DBG_ERR("invalid state");
@@ -82,13 +82,13 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
         AO_DBG_ERR("referential integrity violation");
 
         //clean up possible tx records
-        if (auto mSerivce = context.getMeteringService()) {
+        if (auto mSerivce = model.getMeteringService()) {
             mSerivce->removeTxMeterData(connectorId, txNr);
         }
         return false;
     }
 
-    if (auto mSerivce = context.getMeteringService()) {
+    if (auto mSerivce = model.getMeteringService()) {
         if (auto txData = mSerivce->getStopTxMeterData(transaction.get())) {
             transactionData = txData->retrieveStopTxData();
         }
@@ -153,13 +153,13 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 void StopTransaction::processConf(JsonObject payload) {
 
     if (transaction) {
-        transaction->getStopRpcSync().confirm();
+        transaction->getStopRpcData().confirm();
         transaction->commit();
     }
 
     AO_DBG_INFO("Request has been accepted!");
 
-    if (auto authService = context.getAuthorizationService()) {
+    if (auto authService = model.getAuthorizationService()) {
         authService->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
     }
 }
@@ -167,7 +167,7 @@ void StopTransaction::processConf(JsonObject payload) {
 bool StopTransaction::processErr(const char *code, const char *description, JsonObject details) {
 
     if (transaction) {
-        transaction->getStopRpcSync().confirm(); //no retry behavior for now; consider data "arrived" at server
+        transaction->getStopRpcData().confirm(); //no retry behavior for now; consider data "arrived" at server
         transaction->commit();
     }
 
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
index 58f9cf82..6eed3894 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.h
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.h
@@ -5,14 +5,14 @@
 #ifndef STOPTRANSACTION_H
 #define STOPTRANSACTION_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Operation.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
 #include <vector>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 class SampledValue;
 class MeterValue;
@@ -21,18 +21,18 @@ class Transaction;
 
 namespace Ocpp16 {
 
-class StopTransaction : public OcppMessage {
+class StopTransaction : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     std::shared_ptr<Transaction> transaction;
     std::vector<std::unique_ptr<MeterValue>> transactionData;
 public:
 
-    StopTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction);
+    StopTransaction(Model& model, std::shared_ptr<Transaction> transaction);
 
-    StopTransaction(OcppModel& context, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData);
+    StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData);
 
-    const char* getOcppOperationType() override;
+    const char* getOperationType() override;
 
     void initiate(StoredOperationHandler *opStore) override;
 
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
index 8122361d..6c20af19 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
@@ -6,18 +6,18 @@
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::TriggerMessage;
 
-TriggerMessage::TriggerMessage(OcppModel& context) : context(context) {
+TriggerMessage::TriggerMessage(Model& model) : model(model) {
 
 }
 
-const char* TriggerMessage::getOcppOperationType(){
+const char* TriggerMessage::getOperationType(){
     return "TriggerMessage";
 }
 
@@ -31,7 +31,7 @@ void TriggerMessage::processReq(JsonObject payload) {
     statusMessage = "Rejected";
 
     if (!strcmp(requestedMessage, "MeterValues")) {
-        if (auto mService = context.getMeteringService()) {
+        if (auto mService = model.getMeteringService()) {
             if (connectorId < 0) {
                 auto nConnectors = mService->getNumConnectors();
                 for (decltype(nConnectors) cId = 0; cId < nConnectors; cId++) {
@@ -46,8 +46,8 @@ void TriggerMessage::processReq(JsonObject payload) {
     } else if (!strcmp(requestedMessage, "StatusNotification")) {
         unsigned int cIdRangeBegin = 0, cIdRangeEnd = 0;
         if (connectorId < 0) {
-            cIdRangeEnd = context.getNumConnectors();
-        } else if ((unsigned int) connectorId < context.getNumConnectors()) {
+            cIdRangeEnd = model.getNumConnectors();
+        } else if ((unsigned int) connectorId < model.getNumConnectors()) {
             cIdRangeBegin = connectorId;
             cIdRangeEnd = connectorId + 1;
         } else {
@@ -55,19 +55,19 @@ void TriggerMessage::processReq(JsonObject payload) {
         }
 
         for (auto i = cIdRangeBegin; i < cIdRangeEnd; i++) {
-            auto connector = context.getConnector(i);
+            auto connector = model.getConnector(i);
 
-            auto statusNotification = makeOcppOperation(new Ocpp16::StatusNotification(
+            auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
                         i,
                         connector->inferenceStatus(), //will be determined in StatusNotification::initiate
-                        context.getOcppTime().getOcppTimestampNow()));
+                        model.getTime().getTimestampNow()));
 
             statusNotification->setTimeout(60000);
 
             triggeredOperations.push_back(std::move(statusNotification));
         }
     } else {
-        auto msg = defaultOcppEngine->getOperationDeserializer().deserializeOperation(requestedMessage);
+        auto msg = defaultContext->getOperationRegistry().deserializeOperation(requestedMessage);
         if (msg) {
             triggeredOperations.push_back(std::move(msg));
         } else {
@@ -93,10 +93,10 @@ std::unique_ptr<DynamicJsonDocument> TriggerMessage::createConf(){
     
     payload["status"] = statusMessage;
 
-    if (defaultOcppEngine) {
+    if (defaultContext) {
         auto op = triggeredOperations.begin();
         while (op != triggeredOperations.end()) {
-            defaultOcppEngine->initiatePreBootOperation(std::move(triggeredOperations.front()));
+            defaultContext->initiatePreBootOperation(std::move(triggeredOperations.front()));
             op = triggeredOperations.erase(op);
         }
     }
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.h b/src/ArduinoOcpp/MessagesV16/TriggerMessage.h
index 26572d6d..380496d1 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.h
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.h
@@ -5,28 +5,28 @@
 #ifndef TRIGGERMESSAGE_H
 #define TRIGGERMESSAGE_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 
 #include <vector>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
-class OcppOperation;
+class Model;
+class Request;
 
 namespace Ocpp16 {
 
-class TriggerMessage : public OcppMessage {
+class TriggerMessage : public Operation {
 private:
-    OcppModel& context;
-    std::vector<std::unique_ptr<OcppOperation>> triggeredOperations;
+    Model& model;
+    std::vector<std::unique_ptr<Request>> triggeredOperations;
     const char *statusMessage {nullptr};
 
     const char *errorCode = nullptr;
 public:
-    TriggerMessage(OcppModel& context);
+    TriggerMessage(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
index 9c41e057..7cd94903 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
@@ -3,18 +3,18 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/UnlockConnector.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::UnlockConnector;
 
 #define AO_UNLOCK_TIMEOUT 10000
 
-UnlockConnector::UnlockConnector(OcppModel& context) : context(context) {
+UnlockConnector::UnlockConnector(Model& model) : model(model) {
   
 }
 
-const char* UnlockConnector::getOcppOperationType(){
+const char* UnlockConnector::getOperationType(){
     return "UnlockConnector";
 }
 
@@ -22,7 +22,7 @@ void UnlockConnector::processReq(JsonObject payload) {
     
     auto connectorId = payload["connectorId"] | -1;
 
-    auto connector = context.getConnector(connectorId);
+    auto connector = model.getConnector(connectorId);
 
     if (!connector) {
         err = true;
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
index cf3922c5..eeda9a90 100644
--- a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
+++ b/src/ArduinoOcpp/MessagesV16/UnlockConnector.h
@@ -5,27 +5,27 @@
 #ifndef UNLOCKCONNECTOR_H
 #define UNLOCKCONNECTOR_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <functional>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class UnlockConnector : public OcppMessage {
+class UnlockConnector : public Operation {
 private:
-    OcppModel& context;
+    Model& model;
     bool err = false;
     std::function<PollResult<bool> ()> unlockConnector;
     PollResult<bool> cbUnlockResult;
     unsigned long timerStart = 0; //for timeout
 public:
-    UnlockConnector(OcppModel& context);
+    UnlockConnector(Model& model);
 
-    const char* getOcppOperationType();
+    const char* getOperationType();
 
     void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
index 8e9cfe53..360d5de8 100644
--- a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
+++ b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
@@ -3,13 +3,13 @@
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/UpdateFirmware.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::UpdateFirmware;
 
-UpdateFirmware::UpdateFirmware(OcppModel& context) : context(context) {
+UpdateFirmware::UpdateFirmware(Model& model) : model(model) {
 
 }
 
@@ -41,7 +41,7 @@ void UpdateFirmware::processReq(JsonObject payload) {
 }
 
 std::unique_ptr<DynamicJsonDocument> UpdateFirmware::createConf(){
-    if (auto fwService = context.getFirmwareService()) {
+    if (auto fwService = model.getFirmwareService()) {
         fwService->scheduleFirmwareUpdate(location, retreiveDate, retries, retryInterval);
     } else {
         AO_DBG_ERR("FirmwareService has not been initialized before! Please have a look at ArduinoOcpp.cpp for an example. Abort");
diff --git a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
index 656a9f7a..d85b53b8 100644
--- a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
+++ b/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
@@ -5,27 +5,27 @@
 #ifndef UPDATEFIRMWARE_H
 #define UPDATEFIRMWARE_H
 
-#include <ArduinoOcpp/Core/OcppMessage.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Operation.h>
+#include <ArduinoOcpp/Core/Time.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 namespace Ocpp16 {
 
-class UpdateFirmware : public OcppMessage {
+class UpdateFirmware : public Operation {
 private:
-  OcppModel& context;
+  Model& model;
   std::string location {};
-  OcppTimestamp retreiveDate = OcppTimestamp();
+  Timestamp retreiveDate = Timestamp();
   int retries = 1;
   unsigned long retryInterval = 180;
   bool formatError = false;
 public:
-  UpdateFirmware(OcppModel& context);
+  UpdateFirmware(Model& model);
 
-  const char* getOcppOperationType() {return "UpdateFirmware";}
+  const char* getOperationType() {return "UpdateFirmware";}
 
   void processReq(JsonObject payload);
 
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
index b04ddc76..4f363c3f 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
@@ -43,7 +43,7 @@ void AuthorizationData::readJson(JsonObject entry, bool compact) {
     }
 
     if (idTagInfo.containsKey(AUTHDATA_KEY_EXPIRYDATE(compact))) {
-        expiryDate = std::unique_ptr<OcppTimestamp>(new OcppTimestamp());
+        expiryDate = std::unique_ptr<Timestamp>(new Timestamp());
         if (!expiryDate->setTime(idTagInfo[AUTHDATA_KEY_EXPIRYDATE(compact)])) {
             expiryDate.reset();
         }
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
index 8828dff1..5c2d806e 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
@@ -6,7 +6,7 @@
 #define AUTHORIZATIONDATA_H
 
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoJson.h>
 #include <memory>
 
@@ -37,7 +37,7 @@ class AuthorizationData {
     //data structure optimized for memory consumption
 
     std::unique_ptr<char[]> parentIdTag;
-    std::unique_ptr<OcppTimestamp> expiryDate;
+    std::unique_ptr<Timestamp> expiryDate;
 
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
 
@@ -55,7 +55,7 @@ class AuthorizationData {
     void writeJson(JsonObject& entry, bool compact = false); //compact: compressed representation for flash storage
 
     const char *getIdTag() const {return idTag;}
-    OcppTimestamp *getExpiryDate() const {return expiryDate.get();}
+    Timestamp *getExpiryDate() const {return expiryDate.get();}
     const char *getParentIdTag() const {return parentIdTag.get();}
     AuthorizationStatus getAuthorizationStatus() const {return status;}
 
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h
index 3d5e3cc0..0a92ea12 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h
@@ -11,11 +11,11 @@
 
 namespace ArduinoOcpp {
 
-class OcppEngine;
+class Context;
 
 class AuthorizationService {
 private:
-    OcppEngine& context;
+    Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
     AuthorizationList localAuthorizationList;
 
@@ -23,7 +23,7 @@ class AuthorizationService {
     std::shared_ptr<Configuration<bool>> localAuthListEnabled;
 
 public:
-    AuthorizationService(OcppEngine& context, std::shared_ptr<FilesystemAdapter> filesystem);
+    AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem);
     ~AuthorizationService();
 
     bool loadLists();
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
index a34c927a..31eea5ff 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
@@ -3,10 +3,10 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Boot/BootService.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
@@ -26,7 +26,7 @@ RegistrationStatus ArduinoOcpp::deserializeRegistrationStatus(const char *serial
     }
 }
 
-BootService::BootService(OcppEngine& context) : context(context) {
+BootService::BootService(Context& context) : context(context) {
     
     //if transactions can start before the BootNotification succeeds
     preBootTransactions = declareConfiguration<bool>("AO_PreBootTransactions", false, CONFIGURATION_FN, true, true, true, false);
@@ -37,8 +37,8 @@ BootService::BootService(OcppEngine& context) : context(context) {
     }
 
     //Register message handler for TriggerMessage operation
-    context.getOperationDeserializer().registerOcppOperation("BootNotification", [this] () {
-        return new Ocpp16::BootNotification(this->context.getOcppModel(), getChargePointCredentials());});
+    context.getOperationRegistry().registerRequest("BootNotification", [this] () {
+        return new Ocpp16::BootNotification(this->context.getModel(), getChargePointCredentials());});
 }
 
 void BootService::loop() {
@@ -49,7 +49,7 @@ void BootService::loop() {
     }
 
     if (!activatedModel && (status == RegistrationStatus::Accepted || *preBootTransactions)) {
-        context.getOcppModel().activateTasks();
+        context.getModel().activateTasks();
         activatedModel = true;
     }
 
@@ -65,7 +65,7 @@ void BootService::loop() {
      * Create BootNotification. The BootNotifaction object will fetch its paremeters from
      * this class and notify this class about the response
      */
-    auto bootNotification = makeOcppOperation(new Ocpp16::BootNotification(context.getOcppModel(), getChargePointCredentials()));
+    auto bootNotification = makeRequest(new Ocpp16::BootNotification(context.getModel(), getChargePointCredentials()));
     bootNotification->setTimeout(interval_s * 1000UL);
     context.initiatePreBootOperation(std::move(bootNotification));
 
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.h b/src/ArduinoOcpp/Tasks/Boot/BootService.h
index e37a16bf..9d20b4d3 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.h
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.h
@@ -21,11 +21,11 @@ enum class RegistrationStatus {
 
 RegistrationStatus deserializeRegistrationStatus(const char *serialized);
 
-class OcppEngine;
+class Context;
 
 class BootService {
 private:
-    OcppEngine& context;
+    Context& context;
 
     unsigned long interval_s = AO_BOOT_INTERVAL_DEFAULT;
     unsigned long lastBootNotification = -1UL / 2;
@@ -40,7 +40,7 @@ class BootService {
     bool activatedPostBootCommunication = false;
 
 public:
-    BootService(OcppEngine& context);
+    BootService(Context& context);
 
     void loop();
 
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
index df5ca185..4ef9e78a 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
@@ -5,7 +5,7 @@
 #include <string>
 
 #include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
 #include <ArduinoOcpp/MessagesV16/ChangeConfiguration.h>
@@ -26,7 +26,7 @@
 
 using namespace ArduinoOcpp;
 
-ChargeControlCommon::ChargeControlCommon(OcppEngine& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
+ChargeControlCommon::ChargeControlCommon(Context& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context) {
     
     std::shared_ptr<Configuration<int>> numberOfConnectors =
@@ -57,38 +57,38 @@ ChargeControlCommon::ChargeControlCommon(OcppEngine& context, unsigned int numCo
     declareConfiguration<bool>("AuthorizeRemoteTxRequests",false,CONFIGURATION_VOLATILE,false,true,false,false);
     declareConfiguration<int>("GetConfigurationMaxKeys",30,CONFIGURATION_VOLATILE,false,true,false,false);
     
-    context.getOperationDeserializer().registerOcppOperation("ChangeAvailability", [&context] () {
-        return new Ocpp16::ChangeAvailability(context.getOcppModel());});
-    context.getOperationDeserializer().registerOcppOperation("ChangeConfiguration", [] () {
+    context.getOperationRegistry().registerRequest("ChangeAvailability", [&context] () {
+        return new Ocpp16::ChangeAvailability(context.getModel());});
+    context.getOperationRegistry().registerRequest("ChangeConfiguration", [] () {
         return new Ocpp16::ChangeConfiguration();});
-    context.getOperationDeserializer().registerOcppOperation("ClearCache", [filesystem] () {
+    context.getOperationRegistry().registerRequest("ClearCache", [filesystem] () {
         return new Ocpp16::ClearCache(filesystem);});
-    context.getOperationDeserializer().registerOcppOperation("GetConfiguration", [] () {
+    context.getOperationRegistry().registerRequest("GetConfiguration", [] () {
         return new Ocpp16::GetConfiguration();});
-    context.getOperationDeserializer().registerOcppOperation("RemoteStartTransaction", [&context] () {
-        return new Ocpp16::RemoteStartTransaction(context.getOcppModel());});
-    context.getOperationDeserializer().registerOcppOperation("RemoteStopTransaction", [&context] () {
-        return new Ocpp16::RemoteStopTransaction(context.getOcppModel());});
-    context.getOperationDeserializer().registerOcppOperation("Reset", [&context] () {
-        return new Ocpp16::Reset(context.getOcppModel());});
-    context.getOperationDeserializer().registerOcppOperation("TriggerMessage", [&context] () {
-        return new Ocpp16::TriggerMessage(context.getOcppModel());});
-    context.getOperationDeserializer().registerOcppOperation("UnlockConnector", [&context] () {
-        return new Ocpp16::UnlockConnector(context.getOcppModel());});
+    context.getOperationRegistry().registerRequest("RemoteStartTransaction", [&context] () {
+        return new Ocpp16::RemoteStartTransaction(context.getModel());});
+    context.getOperationRegistry().registerRequest("RemoteStopTransaction", [&context] () {
+        return new Ocpp16::RemoteStopTransaction(context.getModel());});
+    context.getOperationRegistry().registerRequest("Reset", [&context] () {
+        return new Ocpp16::Reset(context.getModel());});
+    context.getOperationRegistry().registerRequest("TriggerMessage", [&context] () {
+        return new Ocpp16::TriggerMessage(context.getModel());});
+    context.getOperationRegistry().registerRequest("UnlockConnector", [&context] () {
+        return new Ocpp16::UnlockConnector(context.getModel());});
 
     /*
      * Register further message handlers to support echo mode: when this library
      * is connected with a WebSocket echo server, let it reply to its own requests.
      * Mocking an OCPP Server on the same device makes running (unit) tests easier.
      */
-    context.getOperationDeserializer().registerOcppOperation("Authorize", [&context] () {
-        return new Ocpp16::Authorize(context.getOcppModel(), nullptr);});
-    context.getOperationDeserializer().registerOcppOperation("StartTransaction", [&context] () {
-        return new Ocpp16::StartTransaction(context.getOcppModel(), nullptr);});
-    context.getOperationDeserializer().registerOcppOperation("StatusNotification", [&context] () {
-        return new Ocpp16::StatusNotification(-1, OcppEvseState::NOT_SET, OcppTimestamp());});
-    context.getOperationDeserializer().registerOcppOperation("StopTransaction", [&context] () {
-        return new Ocpp16::StopTransaction(context.getOcppModel(), nullptr);});
+    context.getOperationRegistry().registerRequest("Authorize", [&context] () {
+        return new Ocpp16::Authorize(context.getModel(), nullptr);});
+    context.getOperationRegistry().registerRequest("StartTransaction", [&context] () {
+        return new Ocpp16::StartTransaction(context.getModel(), nullptr);});
+    context.getOperationRegistry().registerRequest("StatusNotification", [&context] () {
+        return new Ocpp16::StatusNotification(-1, OcppEvseState::NOT_SET, Timestamp());});
+    context.getOperationRegistry().registerRequest("StopTransaction", [&context] () {
+        return new Ocpp16::StopTransaction(context.getModel(), nullptr);});
 }
 
 void ChargeControlCommon::loop() {
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h
index 1270bd2a..8da8adb2 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h
@@ -9,13 +9,13 @@
 
 namespace ArduinoOcpp {
 
-class OcppEngine;
+class Context;
 
 class ChargeControlCommon {
 private:
-    OcppEngine& context;
+    Context& context;
 public:
-    ChargeControlCommon(OcppEngine& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+    ChargeControlCommon(Context& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
     void loop();
 };
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index c9d2676a..57e23ff4 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -4,9 +4,9 @@
 
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Core/OcppOperation.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Core/Request.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 
@@ -22,13 +22,13 @@
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
-Connector::Connector(OcppEngine& context, int connectorId)
-        : context(context), model(context.getOcppModel()), connectorId{connectorId} {
+Connector::Connector(Context& context, int connectorId)
+        : context(context), model(context.getModel()), connectorId{connectorId} {
 
     char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
     snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, "AO_AVAIL_CONN_%d", connectorId);
@@ -194,7 +194,7 @@ void Connector::loop() {
                 !transaction->getStartRpcSync().isRequested() &&
                 transaction->getSessionTimestamp() > MIN_TIME &&
                 connectionTimeOut && *connectionTimeOut > 0 &&
-                model.getOcppTime().getOcppTimestampNow() - transaction->getSessionTimestamp() >= (otime_t) *connectionTimeOut) {
+                model.getTime().getTimestampNow() - transaction->getSessionTimestamp() >= (otime_t) *connectionTimeOut) {
                 
             AO_DBG_INFO("Session mngt: timeout");
             transaction->endSession();
@@ -236,7 +236,7 @@ void Connector::loop() {
                 }
 
                 if (transaction->getStartTimestamp() <= MIN_TIME) {
-                    transaction->setStartTimestamp(model.getOcppTime().getOcppTimestampNow());
+                    transaction->setStartTimestamp(model.getTime().getTimestampNow());
                 }
 
                 if (transaction->isSilent()) {
@@ -253,9 +253,9 @@ void Connector::loop() {
                     model.getMeteringService()->beginTxMeterData(transaction.get());
                 }
 
-                auto startTx = makeOcppOperation(new StartTransaction(model, transaction));
+                auto startTx = makeRequest(new StartTransaction(model, transaction));
                 startTx->setTimeout(0);
-                context.initiateOperation(std::move(startTx));
+                context.initiateRequest(std::move(startTx));
                 return;
             }
         } else  {
@@ -291,7 +291,7 @@ void Connector::loop() {
                 }
 
                 if (transaction->getStopTimestamp() <= MIN_TIME) {
-                    transaction->setStopTimestamp(model.getOcppTime().getOcppTimestampNow());
+                    transaction->setStopTimestamp(model.getTime().getTimestampNow());
                 }
 
                 transaction->commit();
@@ -302,15 +302,15 @@ void Connector::loop() {
                     stopTxData = meteringService->endTxMeterData(transaction.get());
                 }
 
-                std::unique_ptr<OcppOperation> stopTx;
+                std::unique_ptr<Request> stopTx;
 
                 if (stopTxData) {
-                    stopTx = makeOcppOperation(new StopTransaction(model, std::move(transaction), stopTxData->retrieveStopTxData()));
+                    stopTx = makeRequest(new StopTransaction(model, std::move(transaction), stopTxData->retrieveStopTxData()));
                 } else {
-                    stopTx = makeOcppOperation(new StopTransaction(model, std::move(transaction)));
+                    stopTx = makeRequest(new StopTransaction(model, std::move(transaction)));
                 }
                 stopTx->setTimeout(0);
-                context.initiateOperation(std::move(stopTx));
+                context.initiateRequest(std::move(stopTx));
                 return;
             }
         }
@@ -344,17 +344,17 @@ void Connector::loop() {
     }
 
     if (reportedStatus != currentStatus &&
-            model.getOcppTime().getOcppTimestampNow() >= OcppTimestamp(2010,0,0,0,0,0) &&
+            model.getTime().getTimestampNow() >= Timestamp(2010,0,0,0,0,0) &&
             (*minimumStatusDuration <= 0 || //MinimumStatusDuration disabled
             ao_tick_ms() - t_statusTransition >= ((unsigned long) *minimumStatusDuration) * 1000UL)) {
         reportedStatus = currentStatus;
-        OcppTimestamp reportedTimestamp = model.getOcppTime().getOcppTimestampNow();
+        Timestamp reportedTimestamp = model.getTime().getTimestampNow();
         reportedTimestamp -= (ao_tick_ms() - t_statusTransition) / 1000UL;
 
-        auto statusNotification = makeOcppOperation(
+        auto statusNotification = makeRequest(
                 new StatusNotification(connectorId, reportedStatus, reportedTimestamp, getErrorCode()));
         statusNotification->setTimeout(0);
-        context.initiateOperation(std::move(statusNotification));
+        context.initiateRequest(std::move(statusNotification));
         return;
     }
 
@@ -509,7 +509,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         //check expiry
         if (localAuth && localAuth->getExpiryDate()) {
-            auto& tnow = model.getOcppTime().getOcppTimestampNow();
+            auto& tnow = model.getTime().getTimestampNow();
             if (tnow >= *localAuth->getExpiryDate()) {
                 AO_DBG_DEBUG("idTag %s local auth entry expired", idTag);
                 localAuth = nullptr;
@@ -532,7 +532,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         transaction->setIdTag(idTag);
     }
 
-    transaction->setSessionTimestamp(model.getOcppTime().getOcppTimestampNow());
+    transaction->setSessionTimestamp(model.getTime().getTimestampNow());
 
     AO_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
 
@@ -547,7 +547,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     transaction->commit();
 
-    auto authorize = makeOcppOperation(new Ocpp16::Authorize(context.getOcppModel(), idTag));
+    auto authorize = makeRequest(new Ocpp16::Authorize(context.getModel(), idTag));
     authorize->setTimeout(authorizationTimeout && *authorizationTimeout > 0 ? *authorizationTimeout * 1000UL : 20UL * 1000UL);
     auto tx = transaction;
     authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
@@ -624,7 +624,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         tx->commit();
         return; //offline tx disabled
     });
-    context.initiateOperation(std::move(authorize));
+    context.initiateRequest(std::move(authorize));
 
     return transaction;
 }
@@ -650,7 +650,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
         transaction->setIdTag(idTag);
     }
 
-    transaction->setSessionTimestamp(model.getOcppTime().getOcppTimestampNow());
+    transaction->setSessionTimestamp(model.getTime().getTimestampNow());
     
     AO_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
 
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
index aeec7253..31ad264e 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
@@ -20,15 +20,15 @@
 
 namespace ArduinoOcpp {
 
-class OcppEngine;
-class OcppModel;
-class OcppMessage;
+class Context;
+class Model;
+class Operation;
 class Transaction;
 
 class Connector {
 private:
-    OcppEngine& context;
-    OcppModel& model;
+    Context& context;
+    Model& model;
     
     const int connectorId;
 
@@ -67,7 +67,7 @@ class Connector {
     std::shared_ptr<Configuration<const char*>> freeVendIdTag;
     bool freeVendTrackPlugged = false;
 public:
-    Connector(OcppEngine& context, int connectorId);
+    Connector(Context& context, int connectorId);
     Connector(Connector&& other) = default;
 
     /*
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
index 983d5ec2..ca1dd318 100644
--- a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
+++ b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
@@ -3,9 +3,9 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -15,7 +15,7 @@
 using namespace ArduinoOcpp;
 using Ocpp16::DiagnosticsStatus;
 
-DiagnosticsService::DiagnosticsService(OcppEngine& context) : context(context) {
+DiagnosticsService::DiagnosticsService(Context& context) : context(context) {
     const char *fpId = "FirmwareManagement";
     auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
     if (!strstr(*fProfile, fpId)) {
@@ -26,21 +26,21 @@ DiagnosticsService::DiagnosticsService(OcppEngine& context) : context(context) {
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
     
-    context.getOperationDeserializer().registerOcppOperation("GetDiagnostics", [&context] () {
-        return new Ocpp16::GetDiagnostics(context.getOcppModel());});
+    context.getOperationRegistry().registerRequest("GetDiagnostics", [&context] () {
+        return new Ocpp16::GetDiagnostics(context.getModel());});
 
     //Register message handler for TriggerMessage operation
-    context.getOperationDeserializer().registerOcppOperation("DiagnosticsStatusNotification", [this] () {
+    context.getOperationRegistry().registerRequest("DiagnosticsStatusNotification", [this] () {
         return new Ocpp16::DiagnosticsStatusNotification(getDiagnosticsStatus());});
 }
 
 void DiagnosticsService::loop() {
     auto notification = getDiagnosticsStatusNotification();
     if (notification) {
-        context.initiateOperation(std::move(notification));
+        context.initiateRequest(std::move(notification));
     }
 
-    const auto& timestampNow = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+    const auto& timestampNow = context.getModel().getTime().getTimestampNow();
     if (retries > 0 && timestampNow >= nextTry) {
 
         if (!uploadIssued) {
@@ -92,7 +92,7 @@ void DiagnosticsService::loop() {
 }
 
 //timestamps before year 2021 will be treated as "undefined"
-std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &location, int retries, unsigned int retryInterval, OcppTimestamp startTime, OcppTimestamp stopTime) {
+std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &location, int retries, unsigned int retryInterval, Timestamp startTime, Timestamp stopTime) {
     if (onUpload == nullptr) //maybe add further plausibility checks
         return nullptr;
     
@@ -101,11 +101,11 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
     this->retryInterval = retryInterval;
     this->startTime = startTime;
     
-    OcppTimestamp stopMin = OcppTimestamp(2021,0,0,0,0,0);
+    Timestamp stopMin = Timestamp(2021,0,0,0,0,0);
     if (stopTime >= stopMin) {
         this->stopTime = stopTime;
     } else {
-        auto newStop = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+        auto newStop = context.getModel().getTime().getTimestampNow();
         newStop += 3600 * 24 * 365; //set new stop time one year in future
         this->stopTime = newStop;
     }
@@ -127,7 +127,7 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
             dbuf,
             dbuf2);
 
-    nextTry = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+    nextTry = context.getModel().getTime().getTimestampNow();
     nextTry += 5; //wait for 5s before upload
     uploadIssued = false;
 
@@ -155,13 +155,13 @@ DiagnosticsStatus DiagnosticsService::getDiagnosticsStatus() {
     return DiagnosticsStatus::Idle;
 }
 
-std::unique_ptr<OcppOperation> DiagnosticsService::getDiagnosticsStatusNotification() {
+std::unique_ptr<Request> DiagnosticsService::getDiagnosticsStatusNotification() {
 
     if (getDiagnosticsStatus() != lastReportedStatus) {
         lastReportedStatus = getDiagnosticsStatus();
         if (lastReportedStatus != DiagnosticsStatus::Idle) {
-            OcppMessage *diagNotificationMsg = new Ocpp16::DiagnosticsStatusNotification(lastReportedStatus);
-            auto diagNotification = makeOcppOperation(diagNotificationMsg);
+            Operation *diagNotificationMsg = new Ocpp16::DiagnosticsStatusNotification(lastReportedStatus);
+            auto diagNotification = makeRequest(diagNotificationMsg);
             return diagNotification;
         }
     }
@@ -169,7 +169,7 @@ std::unique_ptr<OcppOperation> DiagnosticsService::getDiagnosticsStatusNotificat
     return nullptr;
 }
 
-void DiagnosticsService::setOnUpload(std::function<bool(const std::string &location, OcppTimestamp &startTime, OcppTimestamp &stopTime)> onUpload) {
+void DiagnosticsService::setOnUpload(std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload) {
     this->onUpload = onUpload;
 }
 
@@ -180,7 +180,7 @@ void DiagnosticsService::setOnUploadStatusSampler(std::function<UploadStatus()>
 #if !defined(AO_CUSTOM_DIAGNOSTICS) && !defined(AO_CUSTOM_WS)
 #if defined(ESP32) || defined(ESP8266)
 
-DiagnosticsService *EspWiFi::makeDiagnosticsService(OcppEngine& context) {
+DiagnosticsService *EspWiFi::makeDiagnosticsService(Context& context) {
     auto diagService = new DiagnosticsService(context);
 
     /*
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
index bdc7de55..19f205fe 100644
--- a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
+++ b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
@@ -7,7 +7,7 @@
 
 #include <functional>
 #include <memory>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h>
 #include <string>
 
@@ -19,42 +19,42 @@ enum class UploadStatus {
     UploadFailed
 };
 
-class OcppEngine;
-class OcppOperation;
+class Context;
+class Request;
 
 class DiagnosticsService {
 private:
-    OcppEngine& context;
+    Context& context;
     
     std::string location {};
     int retries = 0;
     unsigned int retryInterval = 0;
-    OcppTimestamp startTime = OcppTimestamp();
-    OcppTimestamp stopTime = OcppTimestamp();
+    Timestamp startTime = Timestamp();
+    Timestamp stopTime = Timestamp();
 
-    OcppTimestamp nextTry = OcppTimestamp();
+    Timestamp nextTry = Timestamp();
 
-    std::function<bool(const std::string &location, OcppTimestamp &startTime, OcppTimestamp &stopTime)> onUpload = nullptr;
+    std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload = nullptr;
     std::function<UploadStatus()> uploadStatusSampler = nullptr;
     bool uploadIssued = false;
 
-    std::unique_ptr<OcppOperation> getDiagnosticsStatusNotification();
+    std::unique_ptr<Request> getDiagnosticsStatusNotification();
 
     Ocpp16::DiagnosticsStatus lastReportedStatus = Ocpp16::DiagnosticsStatus::Idle;
 
 public:
-    DiagnosticsService(OcppEngine& context);
+    DiagnosticsService(Context& context);
 
     void loop();
 
     //timestamps before year 2021 will be treated as "undefined"
     //returns empty std::string if onUpload is missing or upload cannot be scheduled for another reason
     //returns fileName of diagnostics file to be uploaded if upload has been scheduled
-    std::string requestDiagnosticsUpload(const std::string &location, int retries = 1, unsigned int retryInterval = 0, OcppTimestamp startTime = OcppTimestamp(), OcppTimestamp stopTime = OcppTimestamp());
+    std::string requestDiagnosticsUpload(const std::string &location, int retries = 1, unsigned int retryInterval = 0, Timestamp startTime = Timestamp(), Timestamp stopTime = Timestamp());
 
     Ocpp16::DiagnosticsStatus getDiagnosticsStatus();
 
-    void setOnUpload(std::function<bool(const std::string &location, OcppTimestamp &startTime, OcppTimestamp &stopTime)> onUpload);
+    void setOnUpload(std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload);
 
     void setOnUploadStatusSampler(std::function<UploadStatus()> uploadStatusSampler);
 };
@@ -64,7 +64,7 @@ class DiagnosticsService {
 
 namespace EspWiFi {
 
-DiagnosticsService *makeDiagnosticsService(OcppEngine& context);
+DiagnosticsService *makeDiagnosticsService(Context& context);
 
 }
 
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index ed6ab816..e3839e19 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -3,12 +3,12 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/OperationDeserializer.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/OperationRegistry.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 
 #include <ArduinoOcpp/MessagesV16/UpdateFirmware.h>
 #include <ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h>
@@ -19,7 +19,7 @@
 using namespace ArduinoOcpp;
 using ArduinoOcpp::Ocpp16::FirmwareStatus;
 
-FirmwareService::FirmwareService(OcppEngine& context) : context(context) {
+FirmwareService::FirmwareService(Context& context) : context(context) {
     const char *fpId = "FirmwareManagement";
     auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
     if (!strstr(*fProfile, fpId)) {
@@ -30,11 +30,11 @@ FirmwareService::FirmwareService(OcppEngine& context) : context(context) {
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
     
-    context.getOperationDeserializer().registerOcppOperation("UpdateFirmware", [&context] () {
-        return new Ocpp16::UpdateFirmware(context.getOcppModel());});
+    context.getOperationRegistry().registerRequest("UpdateFirmware", [&context] () {
+        return new Ocpp16::UpdateFirmware(context.getModel());});
 
     //Register message handler for TriggerMessage operation
-    context.getOperationDeserializer().registerOcppOperation("FirmwareStatusNotification", [this] () {
+    context.getOperationRegistry().registerRequest("FirmwareStatusNotification", [this] () {
         return new Ocpp16::FirmwareStatusNotification(getFirmwareStatus());});
 }
 
@@ -49,22 +49,22 @@ void FirmwareService::setBuildNumber(const char *buildNumber) {
 void FirmwareService::loop() {
     auto notification = getFirmwareStatusNotification();
     if (notification) {
-        context.initiateOperation(std::move(notification));
+        context.initiateRequest(std::move(notification));
     }
 
     if (ao_tick_ms() - timestampTransition < delayTransition) {
         return;
     }
 
-    OcppTimestamp timestampNow = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+    Timestamp timestampNow = context.getModel().getTime().getTimestampNow();
     if (retries > 0 && timestampNow >= retreiveDate) {
 
         //if (!downloadIssued) {
         if (stage == UpdateStage::Idle) {
             AO_DBG_INFO("Start update");
 
-            if (context.getOcppModel().getNumConnectors() > 0) {
-                auto cp = context.getOcppModel().getConnector(0);
+            if (context.getModel().getNumConnectors() > 0) {
+                auto cp = context.getModel().getConnector(0);
                 cp->setAvailabilityVolatile(false);
             }
             if (onDownload == nullptr) {
@@ -126,8 +126,8 @@ void FirmwareService::loop() {
         //if (!installationIssued) {
         if (stage == UpdateStage::AfterDownload) {
             bool ongoingTx = false;
-            for (unsigned int cId = 0; cId < context.getOcppModel().getNumConnectors(); cId++) {
-                auto connector = context.getOcppModel().getConnector(cId);
+            for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
+                auto connector = context.getModel().getConnector(cId);
                 if (connector && connector->getTransactionId() >= 0) {
                     ongoingTx = true;
                     break;
@@ -198,7 +198,7 @@ void FirmwareService::loop() {
     }
 }
 
-void FirmwareService::scheduleFirmwareUpdate(const std::string &location, OcppTimestamp retreiveDate, int retries, unsigned int retryInterval) {
+void FirmwareService::scheduleFirmwareUpdate(const std::string &location, Timestamp retreiveDate, int retries, unsigned int retryInterval) {
     this->location = location;
     this->retreiveDate = retreiveDate;
     this->retries = retries;
@@ -248,7 +248,7 @@ FirmwareStatus FirmwareService::getFirmwareStatus() {
     return FirmwareStatus::Idle;
 }
 
-std::unique_ptr<OcppOperation> FirmwareService::getFirmwareStatusNotification() {
+std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
     /*
      * Check if FW has been updated previously, but only once
      */
@@ -262,8 +262,8 @@ std::unique_ptr<OcppOperation> FirmwareService::getFirmwareStatusNotification()
             configuration_save();
 
             lastReportedStatus = FirmwareStatus::Installed;
-            OcppMessage *fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
-            auto fwNotification = makeOcppOperation(fwNotificationMsg);
+            Operation *fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
+            auto fwNotification = makeRequest(fwNotificationMsg);
             return fwNotification;
         }
     }
@@ -271,8 +271,8 @@ std::unique_ptr<OcppOperation> FirmwareService::getFirmwareStatusNotification()
     if (getFirmwareStatus() != lastReportedStatus) {
         lastReportedStatus = getFirmwareStatus();
         if (lastReportedStatus != FirmwareStatus::Idle && lastReportedStatus != FirmwareStatus::Installed) {
-            OcppMessage *fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
-            auto fwNotification = makeOcppOperation(fwNotificationMsg);
+            Operation *fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
+            auto fwNotification = makeRequest(fwNotificationMsg);
             return fwNotification;
         }
     }
@@ -307,7 +307,7 @@ void FirmwareService::resetStage() {
 
 #include <HTTPUpdate.h>
 
-FirmwareService *EspWiFi::makeFirmwareService(OcppEngine& context, const char *buildNumber) {
+FirmwareService *EspWiFi::makeFirmwareService(Context& context, const char *buildNumber) {
     FirmwareService *fwService = new FirmwareService(context);
     fwService->setBuildNumber(buildNumber);
 
@@ -370,7 +370,7 @@ FirmwareService *EspWiFi::makeFirmwareService(OcppEngine& context, const char *b
 
 #include <ESP8266httpUpdate.h>
 
-FirmwareService *EspWiFi::makeFirmwareService(OcppEngine& context, const char *buildNumber) {
+FirmwareService *EspWiFi::makeFirmwareService(Context& context, const char *buildNumber) {
     FirmwareService *fwService = new FirmwareService(context);
     fwService->setBuildNumber(buildNumber);
 
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
index 2e888de7..52194a48 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
@@ -10,7 +10,7 @@
 
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 
 namespace ArduinoOcpp {
 
@@ -26,12 +26,12 @@ enum class InstallationStatus {
     InstallationFailed
 };
 
-class OcppEngine;
-class OcppOperation;
+class Context;
+class Request;
 
 class FirmwareService {
 private:
-    OcppEngine& context;
+    Context& context;
     
     std::shared_ptr<Configuration<const char *>> previousBuildNumber = NULL;
     const char *buildNumber = NULL;
@@ -46,7 +46,7 @@ class FirmwareService {
     bool checkedSuccessfulFwUpdate = false;
 
     std::string location {};
-    OcppTimestamp retreiveDate = OcppTimestamp();
+    Timestamp retreiveDate = Timestamp();
     int retries = 0;
     unsigned int retryInterval = 0;
 
@@ -67,16 +67,16 @@ class FirmwareService {
 
     void resetStage();
 
-    std::unique_ptr<OcppOperation> getFirmwareStatusNotification();
+    std::unique_ptr<Request> getFirmwareStatusNotification();
 
 public:
-    FirmwareService(OcppEngine& context);
+    FirmwareService(Context& context);
 
     void setBuildNumber(const char *buildNumber);
 
     void loop();
 
-    void scheduleFirmwareUpdate(const std::string &location, OcppTimestamp retreiveDate, int retries = 1, unsigned int retryInterval = 0);
+    void scheduleFirmwareUpdate(const std::string &location, Timestamp retreiveDate, int retries = 1, unsigned int retryInterval = 0);
 
     Ocpp16::FirmwareStatus getFirmwareStatus();
 
@@ -97,7 +97,7 @@ class FirmwareService {
 namespace ArduinoOcpp {
 namespace EspWiFi {
 
-FirmwareService *makeFirmwareService(OcppEngine& context, const char *buildNumber);
+FirmwareService *makeFirmwareService(Context& context, const char *buildNumber);
 
 }
 }
diff --git a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
index 9a6a777e..2053f19e 100644
--- a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
+++ b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
@@ -3,21 +3,21 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/Heartbeat.h>
 #include <ArduinoOcpp/Platform.h>
 
 using namespace ArduinoOcpp;
 
-HeartbeatService::HeartbeatService(OcppEngine& context) : context(context) {
+HeartbeatService::HeartbeatService(Context& context) : context(context) {
     heartbeatInterval = declareConfiguration("HeartbeatInterval", 86400);
     lastHeartbeat = ao_tick_ms();
 
     //Register message handler for TriggerMessage operation
-    context.getOperationDeserializer().registerOcppOperation("Heartbeat", [&context] () {
-        return new Ocpp16::Heartbeat(context.getOcppModel());});
+    context.getOperationRegistry().registerRequest("Heartbeat", [&context] () {
+        return new Ocpp16::Heartbeat(context.getModel());});
 }
 
 void HeartbeatService::loop() {
@@ -28,7 +28,7 @@ void HeartbeatService::loop() {
     if (now - lastHeartbeat >= hbInterval) {
         lastHeartbeat = now;
 
-        auto heartbeat = makeOcppOperation(new Ocpp16::Heartbeat(context.getOcppModel()));
-        context.initiateOperation(std::move(heartbeat));
+        auto heartbeat = makeRequest(new Ocpp16::Heartbeat(context.getModel()));
+        context.initiateRequest(std::move(heartbeat));
     }
 }
diff --git a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
index d1716130..c80f0f07 100644
--- a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
+++ b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
@@ -10,17 +10,17 @@
 
 namespace ArduinoOcpp {
 
-class OcppEngine;
+class Context;
 
 class HeartbeatService {
 private:
-    OcppEngine& context;
+    Context& context;
 
     unsigned long lastHeartbeat;
     std::shared_ptr<ArduinoOcpp::Configuration<int>> heartbeatInterval;
 
 public:
-    HeartbeatService(OcppEngine& context);
+    HeartbeatService(Context& context);
 
     void loop();
 };
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index cbb64044..57dab5b8 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h>
 #include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
 #include <ArduinoOcpp/Platform.h>
@@ -17,7 +17,7 @@
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
-ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, int connectorId, MeterStore& meterStore)
+ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(Model& context, int connectorId, MeterStore& meterStore)
         : context(context), connectorId{connectorId}, meterStore(meterStore) {
 
     auto MeterValuesSampledData = declareConfiguration<const char*>(
@@ -99,7 +99,7 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(OcppModel& context, i
     StopTxnAlignedData->setValidator(validateSelectString);
 }
 
-OcppMessage *ConnectorMeterValuesRecorder::loop() {
+Operation *ConnectorMeterValuesRecorder::loop() {
 
     bool txBreak = false;
     if (context.getConnector(connectorId)) {
@@ -144,7 +144,7 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
     if (*ClockAlignedDataInterval >= 1) {
 
-        auto& timestampNow = context.getOcppTime().getOcppTimestampNow();
+        auto& timestampNow = context.getTime().getTimestampNow();
         auto dt = nextAlignedTime - timestampNow;
         if (dt <= 0 ||                              //normal case: interval elapsed
                 dt > *ClockAlignedDataInterval) {   //special case: clock has been adjusted or first run
@@ -153,13 +153,13 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
                 abs(dt) <= 60 ?
                 "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
-                auto alignedMeterValues = alignedDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SampleClock);
+                auto alignedMeterValues = alignedDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::SampleClock);
                 if (alignedMeterValues) {
                     meterData.push_back(std::move(alignedMeterValues));
                 }
 
                 if (stopTxnData) {
-                    auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SampleClock);
+                    auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::SampleClock);
                     if (alignedStopTx) {
                         stopTxnData->addTxData(std::move(alignedStopTx));
                     }
@@ -167,10 +167,10 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
 
             }
             
-            OcppTimestamp midnightBase = OcppTimestamp(2010,0,0,0,0,0);
+            Timestamp midnightBase = Timestamp(2010,0,0,0,0,0);
             auto intervall = timestampNow - midnightBase;
             intervall %= 3600 * 24;
-            OcppTimestamp midnight = timestampNow - intervall;
+            Timestamp midnight = timestampNow - intervall;
             intervall += *ClockAlignedDataInterval;
             if (intervall >= 3600 * 24) {
                 //next measurement is tomorrow; set to precisely 00:00 
@@ -187,13 +187,13 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
         //record periodic tx data
 
         if (ao_tick_ms() - lastSampleTime >= (unsigned long) (*MeterValueSampleInterval * 1000)) {
-            auto sampleMeterValues = sampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SamplePeriodic);
+            auto sampleMeterValues = sampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::SamplePeriodic);
             if (sampleMeterValues) {
                 meterData.push_back(std::move(sampleMeterValues));
             }
 
             if (stopTxnData && StopTxnDataCapturePeriodic && *StopTxnDataCapturePeriodic) {
-                auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::SamplePeriodic);
+                auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::SamplePeriodic);
                 if (sampleStopTx) {
                     stopTxnData->addTxData(std::move(sampleStopTx));
                 }
@@ -209,9 +209,9 @@ OcppMessage *ConnectorMeterValuesRecorder::loop() {
     return nullptr; //successful method completition. Currently there is no reason to send a MeterValues Msg.
 }
 
-OcppMessage *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
+Operation *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
 
-    auto sample = sampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::Trigger);
+    auto sample = sampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::Trigger);
 
     if (!sample) {
         return nullptr;
@@ -258,7 +258,7 @@ void ConnectorMeterValuesRecorder::beginTxMeterData(Transaction *transaction) {
     }
 
     if (stopTxnData) {
-        auto sampleTxBegin = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionBegin);
+        auto sampleTxBegin = stopTxnSampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::TransactionBegin);
         if (sampleTxBegin) {
             stopTxnData->addTxData(std::move(sampleTxBegin));
         }
@@ -271,7 +271,7 @@ std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::endTxMeterDa
     }
 
     if (stopTxnData) {
-        auto sampleTxEnd = stopTxnSampledDataBuilder->takeSample(context.getOcppTime().getOcppTimestampNow(), ReadingContext::TransactionEnd);
+        auto sampleTxEnd = stopTxnSampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::TransactionEnd);
         if (sampleTxEnd) {
             stopTxnData->addTxData(std::move(sampleTxEnd));
         }
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index 514c594b..2546c979 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -19,14 +19,14 @@ namespace ArduinoOcpp {
 using PowerSampler = std::function<float()>;
 using EnergySampler = std::function<float()>;
 
-class OcppModel;
-class OcppMessage;
+class Model;
+class Operation;
 class Transaction;
 class MeterStore;
 
 class ConnectorMeterValuesRecorder {
 private:
-    OcppModel& context;
+    Model& context;
     const int connectorId;
     MeterStore& meterStore;
     
@@ -44,7 +44,7 @@ class ConnectorMeterValuesRecorder {
     std::shared_ptr<Configuration<const char *>> stopTxnAlignedDataSelect;
 
     unsigned long lastSampleTime = 0; //0 means not charging right now
-    OcppTimestamp nextAlignedTime;
+    Timestamp nextAlignedTime;
     std::shared_ptr<Transaction> transaction;
     bool trackTxRunning = false;
  
@@ -61,9 +61,9 @@ class ConnectorMeterValuesRecorder {
     std::shared_ptr<Configuration<bool>> MeterValuesInTxOnly;
     std::shared_ptr<Configuration<bool>> StopTxnDataCapturePeriodic;
 public:
-    ConnectorMeterValuesRecorder(OcppModel& context, int connectorId, MeterStore& meterStore);
+    ConnectorMeterValuesRecorder(Model& context, int connectorId, MeterStore& meterStore);
 
-    OcppMessage *loop();
+    Operation *loop();
 
     void setPowerSampler(PowerSampler powerSampler);
 
@@ -73,7 +73,7 @@ class ConnectorMeterValuesRecorder {
 
     std::unique_ptr<SampledValue> readTxEnergyMeter(ReadingContext context);
 
-    OcppMessage *takeTriggeredMeterValues();
+    Operation *takeTriggeredMeterValues();
 
     void beginTxMeterData(Transaction *transaction);
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
index ace0471e..c6b213ee 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
@@ -79,7 +79,7 @@ void MeterValueBuilder::updateObservedSamplers() {
     }
 }
 
-std::unique_ptr<MeterValue> MeterValueBuilder::takeSample(const OcppTimestamp& timestamp, const ReadingContext& context) {
+std::unique_ptr<MeterValue> MeterValueBuilder::takeSample(const Timestamp& timestamp, const ReadingContext& context) {
     if (select_observe != select->getValueRevision() || //OCPP server has changed configuration about which measurands to take
             samplers.size() != select_mask.size()) {    //Client has added another Measurand; synchronize lists
         AO_DBG_DEBUG("Updating observed samplers due to config change or samplers added");
@@ -104,7 +104,7 @@ std::unique_ptr<MeterValue> MeterValueBuilder::takeSample(const OcppTimestamp& t
 
 std::unique_ptr<MeterValue> MeterValueBuilder::deserializeSample(const JsonObject mvJson) {
 
-    OcppTimestamp timestamp;
+    Timestamp timestamp;
     bool ret = timestamp.setTime(mvJson["timestamp"] | "Invalid");
     if (!ret) {
         AO_DBG_ERR("invalid timestamp");
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
index d387cb10..ac9e274d 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
@@ -5,7 +5,7 @@
 #ifndef METERVALUE_H
 #define METERVALUE_H
 
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoJson.h>
@@ -16,10 +16,10 @@ namespace ArduinoOcpp {
 
 class MeterValue {
 private:
-    OcppTimestamp timestamp;
+    Timestamp timestamp;
     std::vector<std::unique_ptr<SampledValue>> sampledValue;
 public:
-    MeterValue(OcppTimestamp timestamp) : timestamp(timestamp) { }
+    MeterValue(Timestamp timestamp) : timestamp(timestamp) { }
     MeterValue(const MeterValue& other) = delete;
 
     void addSampledValue(std::unique_ptr<SampledValue> sample) {sampledValue.push_back(std::move(sample));}
@@ -40,7 +40,7 @@ class MeterValueBuilder {
     MeterValueBuilder(const std::vector<std::unique_ptr<SampledValueSampler>> &samplers,
             std::shared_ptr<Configuration<const char*>> samplers_select);
     
-    std::unique_ptr<MeterValue> takeSample(const OcppTimestamp& timestamp, const ReadingContext& context);
+    std::unique_ptr<MeterValue> takeSample(const Timestamp& timestamp, const ReadingContext& context);
 
     std::unique_ptr<MeterValue> deserializeSample(const JsonObject mvJson);
 };
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index 298a823b..d47d1fd8 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -4,19 +4,19 @@
 
 #include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/MessagesV16/MeterValues.h>
 #include <ArduinoOcpp/Debug.h>
 
 using namespace ArduinoOcpp;
 
-MeteringService::MeteringService(OcppEngine& context, int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
+MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
       : context(context), meterStore(filesystem) {
 
     for (int i = 0; i < numConn; i++) {
-        connectors.push_back(std::unique_ptr<ConnectorMeterValuesRecorder>(new ConnectorMeterValuesRecorder(context.getOcppModel(), i, meterStore)));
+        connectors.push_back(std::unique_ptr<ConnectorMeterValuesRecorder>(new ConnectorMeterValuesRecorder(context.getModel(), i, meterStore)));
     }
 
     /*
@@ -24,7 +24,7 @@ MeteringService::MeteringService(OcppEngine& context, int numConn, std::shared_p
      * is connected with a WebSocket echo server, let it reply to its own requests.
      * Mocking an OCPP Server on the same device makes running (unit) tests easier.
      */
-    context.getOperationDeserializer().registerOcppOperation("MeterValues", [] () {
+    context.getOperationRegistry().registerRequest("MeterValues", [] () {
         return new Ocpp16::MeterValues();});
 }
 
@@ -33,9 +33,9 @@ void MeteringService::loop(){
     for (unsigned int i = 0; i < connectors.size(); i++){
         auto meterValuesMsg = connectors[i]->loop();
         if (meterValuesMsg != nullptr) {
-            auto meterValues = makeOcppOperation(meterValuesMsg);
+            auto meterValues = makeRequest(meterValuesMsg);
             meterValues->setTimeout(120000);
-            context.initiateOperation(std::move(meterValues));
+            context.initiateRequest(std::move(meterValues));
         }
     }
 }
@@ -72,7 +72,7 @@ std::unique_ptr<SampledValue> MeteringService::readTxEnergyMeter(int connectorId
     return connectors[connectorId]->readTxEnergyMeter(context);
 }
 
-std::unique_ptr<OcppOperation> MeteringService::takeTriggeredMeterValues(int connectorId) {
+std::unique_ptr<Request> MeteringService::takeTriggeredMeterValues(int connectorId) {
     if (connectorId < 0 || connectorId >= (int) connectors.size()) {
         AO_DBG_ERR("connectorId out of bounds. Ignore");
         return nullptr;
@@ -81,7 +81,7 @@ std::unique_ptr<OcppOperation> MeteringService::takeTriggeredMeterValues(int con
     if (connector.get()) {
         auto msg = connector->takeTriggeredMeterValues();
         if (msg) {
-            auto meterValues = makeOcppOperation(msg);
+            auto meterValues = makeRequest(msg);
             meterValues->setTimeout(120000);
             return meterValues;
         }
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index 58390aea..3452aad7 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -18,18 +18,18 @@ namespace ArduinoOcpp {
 using PowerSampler = std::function<float()>;  //in Watts (W)
 using EnergySampler = std::function<float()>; //in Watt-hours (Wh)
 
-class OcppEngine;
-class OcppOperation;
+class Context;
+class Request;
 class FilesystemAdapter;
 
 class MeteringService {
 private:
-    OcppEngine& context;
+    Context& context;
     MeterStore meterStore;
 
     std::vector<std::unique_ptr<ConnectorMeterValuesRecorder>> connectors;
 public:
-    MeteringService(OcppEngine& context, int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+    MeteringService(Context& context, int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
     void loop();
 
@@ -41,7 +41,7 @@ class MeteringService {
 
     std::unique_ptr<SampledValue> readTxEnergyMeter(int connectorId, ReadingContext reason);
 
-    std::unique_ptr<OcppOperation> takeTriggeredMeterValues(int connectorId); //snapshot of all meters now
+    std::unique_ptr<Request> takeTriggeredMeterValues(int connectorId); //snapshot of all meters now
 
     void beginTxMeterData(Transaction *transaction);
 
diff --git a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
index a3b245c8..53ebc079 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Reservation/Reservation.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Debug.h>
 
 #ifndef RESERVATION_FN
@@ -12,7 +12,7 @@
 
 using namespace ArduinoOcpp;
 
-Reservation::Reservation(OcppModel& context, unsigned int slot) : context(context), slot(slot) {
+Reservation::Reservation(Model& model, unsigned int slot) : model(model), slot(slot) {
     const size_t KEY_SIZE = 50;
     char key [KEY_SIZE] = {'\0'};
 
@@ -44,7 +44,7 @@ bool Reservation::isActive() {
         return false;
     }
 
-    auto& t_now = context.getOcppTime().getOcppTimestampNow();
+    auto& t_now = model.getTime().getTimestampNow();
     if (t_now > expiryDate) {
         //reservation expired
         return false;
@@ -77,7 +77,7 @@ int Reservation::getConnectorId() {
     return *connectorId;
 }
 
-OcppTimestamp& Reservation::getExpiryDate() {
+Timestamp& Reservation::getExpiryDate() {
     return expiryDate;
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Reservation/Reservation.h b/src/ArduinoOcpp/Tasks/Reservation/Reservation.h
index d5a5e13f..c6cfcad1 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/Reservation.h
+++ b/src/ArduinoOcpp/Tasks/Reservation/Reservation.h
@@ -6,26 +6,26 @@
 #define RESERVATION_H
 
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 
 namespace ArduinoOcpp {
 
-class OcppModel;
+class Model;
 
 class Reservation {
 private:
-    OcppModel& context;
+    Model& model;
     const unsigned int slot;
 
     std::shared_ptr<Configuration<int>> connectorId;
     std::shared_ptr<Configuration<const char *>> expiryDateRaw;
-    OcppTimestamp expiryDate;
+    Timestamp expiryDate;
     std::shared_ptr<Configuration<const char *>> idTag;
     std::shared_ptr<Configuration<int>> reservationId;
     std::shared_ptr<Configuration<const char *>> parentIdTag;
 
 public:
-    Reservation(OcppModel& context, unsigned int slot);
+    Reservation(Model& model, unsigned int slot);
 
     bool isActive(); //if this object contains a valid, unexpired reservation
 
@@ -33,7 +33,7 @@ class Reservation {
     bool matches(const char *idTag, const char *parentIdTag = nullptr); //idTag == parentIdTag == nullptr -> return True
 
     int getConnectorId();
-    OcppTimestamp& getExpiryDate();
+    Timestamp& getExpiryDate();
     const char *getIdTag();
     int getReservationId();
     const char *getParentIdTag();
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index 5360c252..e0f0f495 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -3,8 +3,8 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/MessagesV16/CancelReservation.h>
@@ -14,11 +14,11 @@
 
 using namespace ArduinoOcpp;
 
-ReservationService::ReservationService(OcppEngine& context, unsigned int numConnectors) : context(context), maxReservations((int) numConnectors - 1) {
+ReservationService::ReservationService(Context& context, unsigned int numConnectors) : context(context), maxReservations((int) numConnectors - 1) {
     if (maxReservations > 0) {
         reservations.reserve((size_t) maxReservations);
         for (int i = 0; i < maxReservations; i++) {
-            reservations.push_back(Reservation(context.getOcppModel(), i));
+            reservations.push_back(Reservation(context.getModel(), i));
         }
     }
 
@@ -35,10 +35,10 @@ ReservationService::ReservationService(OcppEngine& context, unsigned int numConn
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
     
-    context.getOperationDeserializer().registerOcppOperation("CancelReservation", [&context] () {
-        return new Ocpp16::CancelReservation(context.getOcppModel());});
-    context.getOperationDeserializer().registerOcppOperation("ReserveNow", [&context] () {
-        return new Ocpp16::ReserveNow(context.getOcppModel());});
+    context.getOperationRegistry().registerRequest("CancelReservation", [&context] () {
+        return new Ocpp16::CancelReservation(context.getModel());});
+    context.getOperationRegistry().registerRequest("ReserveNow", [&context] () {
+        return new Ocpp16::ReserveNow(context.getModel());});
 }
 
 void ReservationService::loop() {
@@ -49,7 +49,7 @@ void ReservationService::loop() {
             continue;
         }
 
-        if (auto connector = context.getOcppModel().getConnector(reservation.getConnectorId())) {
+        if (auto connector = context.getModel().getConnector(reservation.getConnectorId())) {
 
             //check if connector went inoperative
             auto cStatus = connector->inferenceStatus();
@@ -66,8 +66,8 @@ void ReservationService::loop() {
         }
 
         //check if tx with same idTag or reservationId has started
-        for (unsigned int cId = 1; cId < context.getOcppModel().getNumConnectors(); cId++) {
-            auto& transaction = context.getOcppModel().getConnector(cId)->getTransaction();
+        for (unsigned int cId = 1; cId < context.getModel().getNumConnectors(); cId++) {
+            auto& transaction = context.getModel().getConnector(cId)->getTransaction();
             if (transaction) {
                 const char *cIdTag = transaction->getIdTag();
                 if (transaction->getReservationId() == reservation.getReservationId() || 
@@ -158,12 +158,12 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
     }
 
     unsigned int availableCount = 0;
-    for (unsigned int cId = 1; cId < context.getOcppModel().getNumConnectors(); cId++) {
+    for (unsigned int cId = 1; cId < context.getModel().getNumConnectors(); cId++) {
         if (cId == connectorId) {
             //don't count this connector
             continue;
         }
-        if (auto connector = context.getOcppModel().getConnector(cId)) {
+        if (auto connector = context.getModel().getConnector(cId)) {
             if (connector->inferenceStatus() == OcppEvseState::Available) {
                 availableCount++;
             }
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h
index d19a8003..55bbc852 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h
@@ -9,11 +9,11 @@
 
 namespace ArduinoOcpp {
 
-class OcppEngine;
+class Context;
 
 class ReservationService {
 private:
-    OcppEngine& context;
+    Context& context;
 
     const int maxReservations; // = number of physical connectors
     std::vector<Reservation> reservations;
@@ -21,7 +21,7 @@ class ReservationService {
     std::shared_ptr<Configuration<bool>> reserveConnectorZeroSupported;
 
 public:
-    ReservationService(OcppEngine& context, unsigned int numConnectors);
+    ReservationService(Context& context, unsigned int numConnectors);
 
     void loop();
 
diff --git a/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp b/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
index 5ed25fa7..aec3e1b1 100644
--- a/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
@@ -3,9 +3,9 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Reset/ResetService.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/Reset.h>
 
@@ -23,13 +23,13 @@
 
 using namespace ArduinoOcpp;
 
-ResetService::ResetService(OcppEngine& context)
+ResetService::ResetService(Context& context)
       : context(context) {
 
     resetRetries = declareConfiguration<int>("ResetRetries", 2, CONFIGURATION_FN, true, true, false, false);
 
-    context.getOperationDeserializer().registerOcppOperation("Reset", [&context] () {
-        return new Ocpp16::Reset(context.getOcppModel());});
+    context.getOperationRegistry().registerRequest("Reset", [&context] () {
+        return new Ocpp16::Reset(context.getModel());});
 }
 
 ResetService::~ResetService() {
@@ -51,8 +51,8 @@ void ResetService::loop() {
         AO_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
 
         if (outstandingResetRetries <= 0) {
-            for (unsigned int cId = 0; cId < context.getOcppModel().getNumConnectors(); cId++) {
-                auto connector = context.getOcppModel().getConnector(cId);
+            for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
+                auto connector = context.getModel().getConnector(cId);
                 connector->setAvailabilityVolatile(true);
             }
         }
@@ -84,8 +84,8 @@ void ResetService::initiateReset(bool isHard) {
     }
     t_resetRetry = ao_tick_ms();
 
-    for (unsigned int cId = 0; cId < context.getOcppModel().getNumConnectors(); cId++) {
-        auto connector = context.getOcppModel().getConnector(cId);
+    for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
+        auto connector = context.getModel().getConnector(cId);
         connector->setAvailabilityVolatile(false);
     }
 }
diff --git a/src/ArduinoOcpp/Tasks/Reset/ResetService.h b/src/ArduinoOcpp/Tasks/Reset/ResetService.h
index 6e7dc43a..3466d60e 100644
--- a/src/ArduinoOcpp/Tasks/Reset/ResetService.h
+++ b/src/ArduinoOcpp/Tasks/Reset/ResetService.h
@@ -9,11 +9,11 @@
 
 namespace ArduinoOcpp {
 
-class OcppEngine;
+class Context;
 
 class ResetService {
 private:
-    OcppEngine& context;
+    Context& context;
 
     std::function<bool(bool isHard)> preReset; //true: reset is possible; false: reject reset; Await: need more time to determine
     std::function<void(bool isHard)> executeReset; //please disconnect WebSocket (AO remains initialized), shut down device and restart with normal initialization routine; on failure reconnect WebSocket
@@ -24,7 +24,7 @@ class ResetService {
     std::shared_ptr<Configuration<int>> resetRetries;
 
 public:
-    ResetService(OcppEngine& context);
+    ResetService(Context& context);
 
     ~ResetService();
     
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
index 1a4b469e..d7532d77 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
@@ -61,7 +61,7 @@ ChargingSchedule::ChargingSchedule(JsonObject &json, ChargingProfileKindType cha
       , recurrencyKind(recurrencyKind) {  
   
     duration = json["duration"] | -1;
-    startSchedule = OcppTimestamp();
+    startSchedule = Timestamp();
     if (!startSchedule.setTime(json["startSchedule"] | "Invalid")) {
         //non-success
         startSchedule = MIN_TIME;
@@ -109,7 +109,7 @@ ChargingSchedule::ChargingSchedule(ChargingSchedule &other) {
     minChargingRate = other.minChargingRate;
 }
 
-ChargingSchedule::ChargingSchedule(const OcppTimestamp &startT, int duration) {
+ChargingSchedule::ChargingSchedule(const Timestamp &startT, int duration) {
     //create empty but valid Charging Schedule
     this->duration = duration;
     startSchedule = startT;
@@ -120,8 +120,8 @@ ChargingSchedule::ChargingSchedule(const OcppTimestamp &startT, int duration) {
     recurrencyKind = RecurrencyKindType::NOT_SET; //copied from ChargingProfile to increase cohesion of limit inferencing methods
 }
 
-bool ChargingSchedule::inferenceLimit(const OcppTimestamp &t, const OcppTimestamp &startOfCharging, float *limit, OcppTimestamp *nextChange) {
-    OcppTimestamp basis = OcppTimestamp(); //point in time to which schedule-related times are relative
+bool ChargingSchedule::inferenceLimit(const Timestamp &t, const Timestamp &startOfCharging, float *limit, Timestamp *nextChange) {
+    Timestamp basis = Timestamp(); //point in time to which schedule-related times are relative
     *nextChange = MAX_TIME; //defaulted to Infinity
     switch (chargingProfileKind) {
         case (ChargingProfileKindType::Absolute):
@@ -335,7 +335,7 @@ ChargingProfile::ChargingProfile(JsonObject &json){
     chargingSchedule = std::unique_ptr<ChargingSchedule>(new ChargingSchedule(schedule, chargingProfileKind, recurrencyKind));
 }
 
-bool ChargingProfile::inferenceLimit(const OcppTimestamp &t, const OcppTimestamp &startOfCharging, float *limit, OcppTimestamp *nextChange){
+bool ChargingProfile::inferenceLimit(const Timestamp &t, const Timestamp &startOfCharging, float *limit, Timestamp *nextChange){
     if (t > validTo && validTo > MIN_TIME) {
         *nextChange = MAX_TIME;
         return false; //no limit defined
@@ -348,7 +348,7 @@ bool ChargingProfile::inferenceLimit(const OcppTimestamp &t, const OcppTimestamp
     return chargingSchedule->inferenceLimit(t, startOfCharging, limit, nextChange);
 }
 
-bool ChargingProfile::inferenceLimit(const OcppTimestamp &t, float *limit, OcppTimestamp *nextChange){
+bool ChargingProfile::inferenceLimit(const Timestamp &t, float *limit, Timestamp *nextChange){
     return inferenceLimit(t, MAX_TIME, limit, nextChange);
 }
 
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
index 2cb8b37d..91fbc55c 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
@@ -6,7 +6,7 @@
 #define SMARTCHARGINGMODEL_H
 
 #include <ArduinoJson.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <memory>
 #include <vector>
 
@@ -54,7 +54,7 @@ class ChargingSchedulePeriod {
 class ChargingSchedule {
 private:
     int duration = -1;
-    OcppTimestamp startSchedule;
+    Timestamp startSchedule;
     ChargingRateUnitType chargingRateUnit;
     std::vector<std::unique_ptr<ChargingSchedulePeriod>> chargingSchedulePeriod;
     float minChargingRate = -1.0f;
@@ -64,7 +64,7 @@ class ChargingSchedule {
 public:
     ChargingSchedule(JsonObject &json, ChargingProfileKindType chargingProfileKind, RecurrencyKindType recurrencyKind);
     ChargingSchedule(ChargingSchedule &other);
-    ChargingSchedule(const OcppTimestamp &startSchedule, int duration);
+    ChargingSchedule(const Timestamp &startSchedule, int duration);
 
     /**
      * limit: output parameter
@@ -74,7 +74,7 @@ class ChargingSchedule {
      *       if true, limit and nextChange will be set according to this Schedule
      *       if false, only nextChange will be set
      */
-    bool inferenceLimit(const OcppTimestamp &t, const OcppTimestamp &startOfCharging, float *limit, OcppTimestamp *nextChange);
+    bool inferenceLimit(const Timestamp &t, const Timestamp &startOfCharging, float *limit, Timestamp *nextChange);
 
     bool addChargingSchedulePeriod(std::unique_ptr<ChargingSchedulePeriod> period);
 
@@ -97,8 +97,8 @@ class ChargingProfile {
     ChargingProfilePurposeType chargingProfilePurpose {ChargingProfilePurposeType::TxProfile};
     ChargingProfileKindType chargingProfileKind {ChargingProfileKindType::Relative}; //copied to ChargingSchedule to increase cohesion of limit inferencing methods
     RecurrencyKindType recurrencyKind {RecurrencyKindType::NOT_SET}; // copied to ChargingSchedule to increase cohesion
-    OcppTimestamp validFrom;
-    OcppTimestamp validTo;
+    Timestamp validFrom;
+    Timestamp validTo;
     std::unique_ptr<ChargingSchedule> chargingSchedule;
 public:
     ChargingProfile(JsonObject &json);
@@ -111,12 +111,12 @@ class ChargingProfile {
      *       if true, limit and nextChange will be set according to this Schedule
      *       if false, only nextChange will be set
      */
-    bool inferenceLimit(const OcppTimestamp &t, const OcppTimestamp &startOfCharging, float *limit, OcppTimestamp *nextChange);
+    bool inferenceLimit(const Timestamp &t, const Timestamp &startOfCharging, float *limit, Timestamp *nextChange);
 
     /*
     * Simpler function if startOfCharging is not available. Caution: This likely will differ from inference with startOfCharging
     */
-    bool inferenceLimit(const OcppTimestamp &t, float *limit, OcppTimestamp *nextChange);
+    bool inferenceLimit(const Timestamp &t, float *limit, Timestamp *nextChange);
 
     /*
     * Check if this profile belongs to transaction with ID txId or idTag alternatively
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index c2cd85e9..b0ddf74f 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -3,8 +3,8 @@
 // MIT License
 
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
 #include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
@@ -42,7 +42,7 @@
 
 using namespace::ArduinoOcpp;
 
-SmartChargingService::SmartChargingService(OcppEngine& context, float chargeLimit, float V_eff, int numConnectors, FilesystemOpt filesystemOpt)
+SmartChargingService::SmartChargingService(Context& context, float chargeLimit, float V_eff, int numConnectors, FilesystemOpt filesystemOpt)
       : context(context), DEFAULT_CHARGE_LIMIT{chargeLimit}, V_eff{V_eff}, filesystemOpt{filesystemOpt} {
   
     if (numConnectors > 2) {
@@ -77,12 +77,12 @@ SmartChargingService::SmartChargingService(OcppEngine& context, float chargeLimi
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
 
-    context.getOperationDeserializer().registerOcppOperation("ClearChargingProfile", [&context] () {
-        return new Ocpp16::ClearChargingProfile(context.getOcppModel());});
-    context.getOperationDeserializer().registerOcppOperation("GetCompositeSchedule", [&context] () {
-        return new Ocpp16::GetCompositeSchedule(context.getOcppModel());});
-    context.getOperationDeserializer().registerOcppOperation("SetChargingProfile", [&context] () {
-        return new Ocpp16::SetChargingProfile(context.getOcppModel());});
+    context.getOperationRegistry().registerRequest("ClearChargingProfile", [&context] () {
+        return new Ocpp16::ClearChargingProfile(context.getModel());});
+    context.getOperationRegistry().registerRequest("GetCompositeSchedule", [&context] () {
+        return new Ocpp16::GetCompositeSchedule(context.getModel());});
+    context.getOperationRegistry().registerRequest("SetChargingProfile", [&context] () {
+        return new Ocpp16::SetChargingProfile(context.getModel());});
 
     loadProfiles();
 }
@@ -94,10 +94,10 @@ void SmartChargingService::loop(){
     /**
      * check if to call onLimitChange
      */
-    if (context.getOcppModel().getOcppTime().getOcppTimestampNow() >= nextChange){
-        auto& tNow = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+    if (context.getModel().getTime().getTimestampNow() >= nextChange){
+        auto& tNow = context.getModel().getTime().getTimestampNow();
         float limit = -1.0f;
-        OcppTimestamp validTo = OcppTimestamp();
+        Timestamp validTo = Timestamp();
         inferenceLimit(tNow, &limit, &validTo);
 
 #if (AO_DBG_LEVEL >= AO_DL_INFO)
@@ -121,8 +121,8 @@ void SmartChargingService::loop(){
 
 float SmartChargingService::inferenceLimitNow(){
     float limit = 0.0f;
-    OcppTimestamp validTo = OcppTimestamp(); //not needed
-    auto& tNow = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+    Timestamp validTo = Timestamp(); //not needed
+    auto& tNow = context.getModel().getTime().getTimestampNow();
     inferenceLimit(tNow, &limit, &validTo);
     return limit;
 }
@@ -136,8 +136,8 @@ void SmartChargingService::setOnLimitChange(OnLimitChange onLtChg){
  * account if the next Profile will be a prevailing one. If the profile at time t ends before any
  * other profile engages, the end of this profile will be written into validToOutParam.
  */
-void SmartChargingService::inferenceLimit(const OcppTimestamp &t, float *limitOutParam, OcppTimestamp *validToOutParam){
-    OcppTimestamp validToMin = MAX_TIME;
+void SmartChargingService::inferenceLimit(const Timestamp &t, float *limitOutParam, Timestamp *validToOutParam){
+    Timestamp validToMin = MAX_TIME;
     /*
     * TxProfile rules over TxDefaultProfile. ChargePointMaxProfile rules over both of them
     * 
@@ -157,7 +157,7 @@ void SmartChargingService::inferenceLimit(const OcppTimestamp &t, float *limitOu
             continue;
         if (!TxProfile[i]->checkTransactionAssignment(chargingSessionTransactionID, *sRmtProfileId))
             continue;
-        OcppTimestamp nextChange = MAX_TIME;
+        Timestamp nextChange = MAX_TIME;
         limit_defined_tx = TxProfile[i]->inferenceLimit(t, chargingSessionStart, &limit_tx, &nextChange);
         if (nextChange < validToMin)
             validToMin = nextChange; //nextChange is always >= t here
@@ -172,7 +172,7 @@ void SmartChargingService::inferenceLimit(const OcppTimestamp &t, float *limitOu
     bool limit_defined_txdef = false;
     for (int i = CHARGEPROFILEMAXSTACKLEVEL - 1; i >= 0; i--){
         if (TxDefaultProfile[i] == NULL) continue;
-        OcppTimestamp nextChange = MAX_TIME;
+        Timestamp nextChange = MAX_TIME;
         limit_defined_txdef = TxDefaultProfile[i]->inferenceLimit(t, chargingSessionStart, &limit_txdef, &nextChange);
         if (nextChange < validToMin)
             validToMin = nextChange; //nextChange is always >= t here
@@ -187,7 +187,7 @@ void SmartChargingService::inferenceLimit(const OcppTimestamp &t, float *limitOu
     bool limit_defined_cpmax = false;
     for (int i = CHARGEPROFILEMAXSTACKLEVEL - 1; i >= 0; i--){
         if (ChargePointMaxProfile[i] == NULL) continue;
-        OcppTimestamp nextChange = MAX_TIME;
+        Timestamp nextChange = MAX_TIME;
         limit_defined_cpmax = ChargePointMaxProfile[i]->inferenceLimit(t, chargingSessionStart, &limit_cpmax, &nextChange);
         if (nextChange < validToMin)
             validToMin = nextChange; //nextChange is always >= t here
@@ -228,10 +228,10 @@ void SmartChargingService::inferenceLimit(const OcppTimestamp &t, float *limitOu
 }
 
 ChargingSchedule *SmartChargingService::getCompositeSchedule(int connectorId, otime_t duration){
-    auto& startSchedule = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+    auto& startSchedule = context.getModel().getTime().getTimestampNow();
     ChargingSchedule *result = new ChargingSchedule(startSchedule, duration);
-    OcppTimestamp periodBegin = OcppTimestamp(startSchedule);
-    OcppTimestamp periodStop = OcppTimestamp(startSchedule);
+    Timestamp periodBegin = Timestamp(startSchedule);
+    Timestamp periodStop = Timestamp(startSchedule);
     while (periodBegin - startSchedule < duration) {
         float limit = 0.f;
         inferenceLimit(periodBegin, &limit, &periodStop);
@@ -245,11 +245,11 @@ ChargingSchedule *SmartChargingService::getCompositeSchedule(int connectorId, ot
 }
 
 void SmartChargingService::refreshChargingSessionState() {
-    if (!context.getOcppModel().getConnector(SINGLE_CONNECTOR_ID)) {
+    if (!context.getModel().getConnector(SINGLE_CONNECTOR_ID)) {
         return; //charging session state does not apply
     }
 
-    auto connector = context.getOcppModel().getConnector(SINGLE_CONNECTOR_ID);
+    auto connector = context.getModel().getConnector(SINGLE_CONNECTOR_ID);
 
     if (!chargingSessionStateInitialized) {
         chargingSessionStateInitialized = true;
@@ -273,7 +273,7 @@ void SmartChargingService::refreshChargingSessionState() {
 
         bool txStartUpdated = false;
         if (chargingSessionTransactionID != 0 && connector->getTransactionId() >= 0) {
-            chargingSessionStart = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+            chargingSessionStart = context.getModel().getTime().getTimestampNow();
             txStartUpdated = true;
         } else if (chargingSessionTransactionID >= 0 && connector->getTransactionId() < 0) {
             chargingSessionStart = MAX_TIME;
@@ -287,7 +287,7 @@ void SmartChargingService::refreshChargingSessionState() {
             configuration_save();
         }
 
-        nextChange = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+        nextChange = context.getModel().getTime().getTimestampNow();
     }
   
     if (*sRmtProfileId >= 0 && //Remote profile set? Check if to delete
@@ -357,7 +357,7 @@ ChargingProfile *SmartChargingService::updateProfileStack(JsonObject json){
      * Invalidate the last limit inference by setting the nextChange to now. By the next loop()-call, the limit
      * and nextChange will be recalculated and onLimitChanged will be called.
      */
-    nextChange = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+    nextChange = context.getModel().getTime().getTimestampNow();
 
     return chargingProfile;
 }
@@ -412,7 +412,7 @@ bool SmartChargingService::clearChargingProfile(const std::function<bool(int, in
      * Invalidate the last limit inference by setting the nextChange to now. By the next loop()-call, the limit
      * and nextChange will be recalculated and onLimitChanged will be called.
      */
-    nextChange = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+    nextChange = context.getModel().getTime().getTimestampNow();
 
     return nMatches > 0;
 }
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
index ef288ee6..1a6babaa 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
@@ -14,17 +14,17 @@
 
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 
 namespace ArduinoOcpp {
 
 using OnLimitChange = std::function<void(float)>;
 
-class OcppEngine;
+class Context;
 
 class SmartChargingService {
 private:
-    OcppEngine& context;
+    Context& context;
     
     const float DEFAULT_CHARGE_LIMIT;
     const float V_eff; //use for approximation: chargingLimit in A * V_eff = chargingLimit in W
@@ -33,11 +33,11 @@ class SmartChargingService {
     ChargingProfile *TxProfile[CHARGEPROFILEMAXSTACKLEVEL];
     OnLimitChange onLimitChange = NULL;
     float limitBeforeChange;
-    OcppTimestamp nextChange;
+    Timestamp nextChange;
 
     bool chargingSessionStateInitialized {false};
     std::shared_ptr<Configuration<const char*>> txStartTime;
-    OcppTimestamp chargingSessionStart;
+    Timestamp chargingSessionStart;
     int chargingSessionTransactionID;
     std::shared_ptr<Configuration<int>> sRmtProfileId;
     uint16_t sRmtProfileIdRev {0};
@@ -50,10 +50,10 @@ class SmartChargingService {
     bool loadProfiles();
   
 public:
-    SmartChargingService(OcppEngine& context, float chargeLimit, float V_eff, int numConnectors, FilesystemOpt filesystemOpt = FilesystemOpt::Use_Mount_FormatOnFail);
+    SmartChargingService(Context& context, float chargeLimit, float V_eff, int numConnectors, FilesystemOpt filesystemOpt = FilesystemOpt::Use_Mount_FormatOnFail);
     void setChargingProfile(JsonObject json);
     bool clearChargingProfile(const std::function<bool(int, int, ChargingProfilePurposeType, int)>& filter);
-    void inferenceLimit(const OcppTimestamp &t, float *limit, OcppTimestamp *validTo);
+    void inferenceLimit(const Timestamp &t, float *limit, Timestamp *validTo);
     float inferenceLimitNow();
     void setOnLimitChange(OnLimitChange onLimitChange);
     ChargingSchedule *getCompositeSchedule(int connectorId, otime_t duration);
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index c655597e..e4bc6c68 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -5,7 +5,7 @@
 #ifndef TRANSACTION_H
 #define TRANSACTION_H
 
-#include <ArduinoOcpp/Core/OcppTime.h>
+#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
 #include <memory>
 #include <ArduinoJson.h>
@@ -44,7 +44,7 @@ class ClientTransactionStart {
 private:
     friend class Transaction;
 
-    OcppTimestamp timestamp = MIN_TIME;      //timestamp of StartTx; can be set before actually initiating
+    Timestamp timestamp = MIN_TIME;      //timestamp of StartTx; can be set before actually initiating
     int32_t meter = -1;           //meterStart of StartTx
     int reservationId = -1;
 };
@@ -70,7 +70,7 @@ class ClientTransactionStop {
     friend class Transaction;
 
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
-    OcppTimestamp timestamp = MIN_TIME;
+    Timestamp timestamp = MIN_TIME;
     int32_t meter = -1;
     char reason [REASON_LEN_MAX + 1] = {'\0'};
 };
@@ -95,7 +95,7 @@ class ChargingSession {
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
     bool authorized = false;    //if the given idTag was authorized
     bool deauthorized = false;  //if the server revoked a local authorization
-    OcppTimestamp timestamp = MIN_TIME;
+    Timestamp timestamp = MIN_TIME;
     int txProfileId = -1;
 
     bool active = true;         //true: ignore
@@ -143,8 +143,8 @@ class Transaction {
 
     const char *getIdTag() {return session.idTag;}
     void setIdTag(const char *idTag) {snprintf(session.idTag, IDTAG_LEN_MAX + 1, "%s", idTag);}
-    OcppTimestamp& getSessionTimestamp() {return session.timestamp;}
-    void setSessionTimestamp(OcppTimestamp timestamp) {session.timestamp = timestamp;}
+    Timestamp& getSessionTimestamp() {return session.timestamp;}
+    void setSessionTimestamp(Timestamp timestamp) {session.timestamp = timestamp;}
 
     const char *getStopReason() {return stop.client.reason;}
     void setStopReason(const char *reason) {snprintf(stop.client.reason, REASON_LEN_MAX + 1, "%s", reason);}
@@ -166,15 +166,15 @@ class Transaction {
     void setReservationId(int reservationId) {start.client.reservationId = reservationId;}
     int getReservationId() {return start.client.reservationId;}
 
-    void setStartTimestamp(OcppTimestamp timestamp) {start.client.timestamp = timestamp;}
-    OcppTimestamp& getStartTimestamp() {return start.client.timestamp;}
+    void setStartTimestamp(Timestamp timestamp) {start.client.timestamp = timestamp;}
+    Timestamp& getStartTimestamp() {return start.client.timestamp;}
 
     void setMeterStop(int32_t meter) {stop.client.meter = meter;}
     bool isMeterStopDefined() {return stop.client.meter >= 0;}
     int32_t getMeterStop() {return stop.client.meter;}
 
-    void setStopTimestamp(OcppTimestamp timestamp) {stop.client.timestamp = timestamp;}
-    OcppTimestamp& getStopTimestamp() {return stop.client.timestamp;}
+    void setStopTimestamp(Timestamp timestamp) {stop.client.timestamp = timestamp;}
+    Timestamp& getStopTimestamp() {return stop.client.timestamp;}
 
     const char *getStopIdTag() {return stop.client.idTag;}
     void setStopIdTag(const char *idTag) {snprintf(stop.client.idTag, IDTAG_LEN_MAX + 1, "%s", idTag);}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index f85353d7..569254a6 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -6,7 +6,7 @@
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 90445ad4..2689bff9 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -3,18 +3,18 @@
 
 #include <ArduinoOcpp/Debug.h>
 
-ArduinoOcpp::OcppSocket *ocppSocket = nullptr;
+ArduinoOcpp::Connection *ocppSocket = nullptr;
 
-void ao_initialize(AOcppSocket *osock, const char *chargePointModel, const char *chargePointVendor, float V_eff, struct AO_FilesystemOpt fsopt) {
+void ao_initialize(AConnection *osock, const char *chargePointModel, const char *chargePointVendor, float V_eff, struct AO_FilesystemOpt fsopt) {
     ao_initialize_full(osock, ChargerCredentials(chargePointModel, chargePointVendor), V_eff, fsopt);
 }
 
-void ao_initialize_full(AOcppSocket *osock, const char *bootNotificationCredentials, float V_eff, struct AO_FilesystemOpt fsopt) {
+void ao_initialize_full(AConnection *osock, const char *bootNotificationCredentials, float V_eff, struct AO_FilesystemOpt fsopt) {
     if (!osock) {
         AO_DBG_ERR("osock is null");
     }
 
-    ocppSocket = reinterpret_cast<ArduinoOcpp::OcppSocket*>(osock);
+    ocppSocket = reinterpret_cast<ArduinoOcpp::Connection*>(osock);
 
     ArduinoOcpp::FilesystemOpt adaptFsopt = fsopt;
 
@@ -96,7 +96,7 @@ std::function<void(void)> adaptFn(void (*fn)(void)) {
 
 char ao_recv_payload_buff [AO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
 
-std::function<void(JsonObject)> adaptFn(OnOcppMessage fn) {
+std::function<void(JsonObject)> adaptFn(OnMessage fn) {
     if (!fn) return nullptr;
     return [fn] (JsonObject payload) {
         auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
@@ -107,7 +107,7 @@ std::function<void(JsonObject)> adaptFn(OnOcppMessage fn) {
     };
 }
 
-ArduinoOcpp::OnReceiveErrorListener adaptFn(OnOcppError fn) {
+ArduinoOcpp::OnReceiveErrorListener adaptFn(OnCallError fn) {
     if (!fn) return nullptr;
     return [fn] (const char *code, const char *description, JsonObject details) {
         auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
@@ -126,11 +126,11 @@ std::function<ArduinoOcpp::PollResult<bool>()> adaptFn(unsigned int connectorId,
     return [fn, connectorId] () {return adaptScl(fn(connectorId));};
 }
 
-void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
     bootNotification(chargePointModel, chargePointVendor, adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
-void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+void ao_bootNotification_full(const char *payloadJson, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
     auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(9) + 230 + 9)); // BootNotification has at most 9 attributes with at most 230 chars + null terminators
     auto err = deserializeJson(*payload, payloadJson);
     if (err) {
@@ -321,7 +321,7 @@ bool ao_isBlockedByReservation_m(unsigned int connectorId, const char *idTag) {
     return isBlockedByReservation(idTag, connectorId);
 }
 
-void ao_setOnResetRequest(OnOcppMessage onRequest) {
+void ao_setOnResetRequest(OnMessage onRequest) {
     setOnResetRequest(adaptFn(onRequest));
 }
 
@@ -330,29 +330,29 @@ void ao_set_console_out_c(void (*console_out)(const char *msg)) {
 }
 
 OcppHandle *ao_getOcppHandle() {
-    return reinterpret_cast<OcppHandle*>(getOcppEngine());
+    return reinterpret_cast<OcppHandle*>(getOcppContext());
 }
 
-void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf) {
+void ao_onRemoteStartTransactionSendConf(OnMessage onSendConf) {
     setOnRemoteStopTransactionSendConf(adaptFn(onSendConf));
 }
 
-void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf) {
+void ao_onRemoteStopTransactionSendConf(OnMessage onSendConf) {
     setOnRemoteStopTransactionSendConf(adaptFn(onSendConf));
 }
 
-void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest) {
+void ao_onRemoteStopTransactionRequest(OnMessage onRequest) {
     setOnRemoteStopTransactionReceiveReq(adaptFn(onRequest));
 }
 
-void ao_onResetSendConf(OnOcppMessage onSendConf) {
+void ao_onResetSendConf(OnMessage onSendConf) {
     setOnResetSendConf(adaptFn(onSendConf));
 }
 
-void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+void ao_startTransaction(const char *idTag, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
     startTransaction(idTag, adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
-void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError) {
+void ao_stopTransaction(OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
     stopTransaction(adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 156d3b57..dbf3fb3d 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -4,8 +4,8 @@
 #include <stddef.h>
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
 
-struct AOcppSocket;
-typedef struct AOcppSocket AOcppSocket;
+struct AConnection;
+typedef struct AConnection AConnection;
 
 struct MeterValueInput;
 typedef struct MeterValueInput MeterValueInput;
@@ -13,10 +13,10 @@ typedef struct MeterValueInput MeterValueInput;
 struct OcppHandle;
 typedef struct OcppHandle OcppHandle;
 
-typedef void (*OnOcppMessage) (const char *payload, size_t len);
-typedef void (*OnOcppAbort)   ();
-typedef void (*OnOcppTimeout) ();
-typedef void (*OnOcppError)   (const char *code, const char *description, const char *details_json, size_t details_len);
+typedef void (*OnMessage) (const char *payload, size_t len);
+typedef void (*OnAbort)   ();
+typedef void (*OnTimeout) ();
+typedef void (*OnCallError)   (const char *code, const char *description, const char *details_json, size_t details_len);
 //typedef void (*ConfCallback)    (const char *payload, size_t len, void* user_data);
 //typedef void (*AbortCallback)   (void* user_data);
 //typedef void (*TimeoutCallback) (void* user_data);
@@ -50,7 +50,7 @@ extern "C" {
  */
 
 void ao_initialize(
-            AOcppSocket *osock,  //WebSocket adapter for ArduinoOcpp
+            AConnection *osock,  //WebSocket adapter for ArduinoOcpp
             const char *chargePointModel,     //model name of this charger (e.g. "")
             const char *chargePointVendor, //brand name
             float V_eff, //Grid voltage of your country. e.g. 230.f (European voltage)
@@ -58,7 +58,7 @@ void ao_initialize(
 
 //same as above, but more fields for the BootNotification
 void ao_initialize_full(
-            AOcppSocket *osock,  //WebSocket adapter for ArduinoOcpp
+            AConnection *osock,  //WebSocket adapter for ArduinoOcpp
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             float V_eff, //Grid voltage of your country. e.g. 230.f (European voltage)
             struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
@@ -71,9 +71,9 @@ void ao_loop();
  * Send OCPP operations
  */
 
-void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
 
-void ao_bootNotification_full(const char *payloadJson, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_bootNotification_full(const char *payloadJson, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
 
 void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data);
 
@@ -159,7 +159,7 @@ const char *ao_getTransactionIdTag_m(unsigned int connectorId);
 bool ao_isBlockedByReservation(const char *idTag);
 bool ao_isBlockedByReservation_m(unsigned int connectorId, const char *idTag);
 
-void ao_setOnResetRequest(OnOcppMessage onRequest);
+void ao_setOnResetRequest(OnMessage onRequest);
 
 /*
  * If build flag AO_CUSTOM_CONSOLE is set, all console output will be forwarded to the print
@@ -177,16 +177,16 @@ OcppHandle *ao_getOcppHandle();
  * Deprecated functions or functions to be moved to ArduinoOcppExtended.h
  */
 
-void ao_onRemoteStartTransactionSendConf(OnOcppMessage onSendConf); //important, energize the power plug here and capture the idTag
+void ao_onRemoteStartTransactionSendConf(OnMessage onSendConf); //important, energize the power plug here and capture the idTag
 
-void ao_onRemoteStopTransactionSendConf(OnOcppMessage onSendConf); //important, de-energize the power plug here
-void ao_onRemoteStopTransactionRequest(OnOcppMessage onRequest); //optional, to de-energize the power plug immediately
+void ao_onRemoteStopTransactionSendConf(OnMessage onSendConf); //important, de-energize the power plug here
+void ao_onRemoteStopTransactionRequest(OnMessage onRequest); //optional, to de-energize the power plug immediately
 
-void ao_setOnResetSendConf(OnOcppMessage onSendConf);
+void ao_setOnResetSendConf(OnMessage onSendConf);
 
-void ao_startTransaction(const char *idTag, OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_startTransaction(const char *idTag, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
 
-void ao_stopTransaction(OnOcppMessage onConfirmation, OnOcppAbort onAbort, OnOcppTimeout onTimeout, OnOcppError onError);
+void ao_stopTransaction(OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
 
 #ifdef __cplusplus
 }
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 7e4066c6..758948d6 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -1,9 +1,9 @@
 #include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/OcppSocket.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Connection.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include "./catch2/catch.hpp"
@@ -14,12 +14,12 @@ using namespace ArduinoOcpp;
 
 TEST_CASE( "Charging sessions" ) {
 
-    //initialize OcppEngine with dummy socket
-    OcppEchoSocket echoSocket;
-    OCPP_initialize(echoSocket, ChargerCredentials("test-runner1234"));
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-    auto engine = getOcppEngine();
-    auto& checkMsg = engine->getOperationDeserializer();
+    auto engine = getOcppContext();
+    auto& checkMsg = engine->getOperationRegistry();
 
     ao_set_timer(custom_timer_cb);
 
@@ -30,7 +30,7 @@ TEST_CASE( "Charging sessions" ) {
     
     std::array<const char*, 2> expectedSN {"Available", "Available"};
     std::array<bool, 2> checkedSN {false, false};
-    checkMsg.registerOcppOperation("StatusNotification", [] () -> OcppMessage* {return new Ocpp16::StatusNotification(0, OcppEvseState::NOT_SET, MIN_TIME);});
+    checkMsg.registerRequest("StatusNotification", [] () -> Operation* {return new Ocpp16::StatusNotification(0, OcppEvseState::NOT_SET, MIN_TIME);});
     checkMsg.setOnRequest("StatusNotification",
         [&checkedSN, &expectedSN] (JsonObject request) {
             int connectorId = request["connectorId"] | -1;
@@ -40,7 +40,7 @@ TEST_CASE( "Charging sessions" ) {
     SECTION("Check idle state"){
 
         bool checkedBN = false;
-        checkMsg.registerOcppOperation("BootNotification", [engine] () -> OcppMessage* {return new Ocpp16::BootNotification(engine->getOcppModel(), std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(0)));});
+        checkMsg.registerRequest("BootNotification", [engine] () -> Operation* {return new Ocpp16::BootNotification(engine->getModel(), std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(0)));});
         checkMsg.setOnRequest("BootNotification",
             [&checkedBN] (JsonObject request) {
                 checkedBN = !strcmp(request["chargePointModel"] | "Invalid", "test-runner1234");
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 6c0820f3..23af1a8a 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -1,8 +1,8 @@
 #include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/OcppSocket.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
-#include <ArduinoOcpp/Core/OcppMessage.h>
+#include <ArduinoOcpp/Core/Connection.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include "./catch2/catch.hpp"
@@ -10,12 +10,12 @@
 
 using namespace ArduinoOcpp;
 
-class CustomStartTransaction : public OcppMessage {
+class CustomStartTransaction : public Operation {
 private:
     const char *status;
 public:
     CustomStartTransaction(const char *status) : status(status) { };
-    const char *getOcppOperationType() override {return "StartTransaction";}
+    const char *getOperationType() override {return "StartTransaction";}
     void processReq(JsonObject payload) override {
         //ignore payload - result is determined at construction time
     }
@@ -35,14 +35,14 @@ TEST_CASE( "Configuration Behavior" ) {
     AO_DBG_DEBUG("remove all");
     FilesystemUtils::remove_all(filesystem, "");
 
-    //initialize OcppEngine with dummy socket
-    OcppEchoSocket echoSocket;
-    OCPP_initialize(echoSocket, ChargerCredentials("test-runner1234"));
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-    auto engine = getOcppEngine();
-    auto& checkMsg = engine->getOperationDeserializer();
+    auto engine = getOcppContext();
+    auto& checkMsg = engine->getOperationRegistry();
 
-    auto connector = engine->getOcppModel().getConnector(1);
+    auto connector = engine->getModel().getConnector(1);
 
     ao_set_timer(custom_timer_cb);
 
@@ -82,7 +82,7 @@ TEST_CASE( "Configuration Behavior" ) {
     SECTION("StopTransactionOnInvalidId") {
         auto config = declareConfiguration<bool>("StopTransactionOnInvalidId", true);
 
-        checkMsg.registerOcppOperation("StartTransaction", [] () {return new CustomStartTransaction("Invalid");});
+        checkMsg.registerRequest("StartTransaction", [] () {return new CustomStartTransaction("Invalid");});
 
         SECTION("set true") {
             *config = true;
@@ -113,7 +113,7 @@ TEST_CASE( "Configuration Behavior" ) {
         auto authorizationTimeout = ArduinoOcpp::declareConfiguration<int>("AO_AuthorizationTimeout", 1);
         *authorizationTimeout = 1; //try normal Authorize for 1s, then enter offline mode
 
-        echoSocket.setConnected(false); //connection loss
+        loopback.setConnected(false); //connection loss
 
         SECTION("set true") {
             *config = true;
@@ -141,7 +141,7 @@ TEST_CASE( "Configuration Behavior" ) {
         }
 
         endTransaction();
-        echoSocket.setConnected(true);
+        loopback.setConnected(true);
     }
 
     SECTION("LocalPreAuthorize") {
@@ -156,10 +156,10 @@ TEST_CASE( "Configuration Behavior" ) {
 
         //define local auth list with entry local-idtag
         std::string localListMsg = "[2,\"testmsg-01\",\"SendLocalList\",{\"listVersion\":1,\"localAuthorizationList\":[{\"idTag\":\"local-idtag\",\"idTagInfo\":{\"status\":\"Accepted\"}}],\"updateType\":\"Full\"}]";
-        echoSocket.sendTXT(localListMsg);
+        loopback.sendTXT(localListMsg);
         loop();
 
-        echoSocket.setConnected(false); //connection loss
+        loopback.setConnected(false); //connection loss
 
         SECTION("set true - accepted idtag") {
             *config = true;
@@ -178,7 +178,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
             REQUIRE(connector->inferenceStatus() == OcppEvseState::Preparing);
 
-            echoSocket.setConnected(true);
+            loopback.setConnected(true);
             mtime += 20000; //Authorize will be retried after a few seconds
             loop();
 
@@ -186,7 +186,7 @@ TEST_CASE( "Configuration Behavior" ) {
         }
 
         endTransaction();
-        echoSocket.setConnected(true);
+        loopback.setConnected(true);
     }
 
     OCPP_deinitialize();
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index fa62bd88..161c373e 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -1,9 +1,9 @@
 #include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/OcppSocket.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Connection.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
 #include <ArduinoOcpp/Debug.h>
@@ -15,9 +15,9 @@ using namespace ArduinoOcpp;
 
 TEST_CASE( "Transaction safety" ) {
 
-    //initialize OcppEngine with dummy socket
-    OcppEchoSocket echoSocket;
-    OCPP_initialize(echoSocket);
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+    OCPP_initialize(loopback);
 
     ao_set_timer(custom_timer_cb);
 
diff --git a/tests/ocppEngineLifecycle.cpp b/tests/ocppEngineLifecycle.cpp
index 441f298d..050c8593 100644
--- a/tests/ocppEngineLifecycle.cpp
+++ b/tests/ocppEngineLifecycle.cpp
@@ -1,24 +1,24 @@
 #include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/OcppSocket.h>
+#include <ArduinoOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
-TEST_CASE( "OcppEngine lifecycle" ) {
+TEST_CASE( "Context lifecycle" ) {
 
     //set console output to the cpp console to display outputs
     //ao_set_console_out(cpp_console_out);
 
-    //initialize OcppEngine with dummy socket
-    ArduinoOcpp::OcppEchoSocket echoSocket;
-    OCPP_initialize(echoSocket);
+    //initialize Context with dummy socket
+    ArduinoOcpp::LoopbackConnection loopback;
+    OCPP_initialize(loopback);
 
     SECTION("OCPP is initialized"){
-        REQUIRE( getOcppEngine() );
+        REQUIRE( getOcppContext() );
     }
 
     OCPP_deinitialize();
 
     SECTION("OCPP is deinitialized"){
-        REQUIRE( !( getOcppEngine() ) );
+        REQUIRE( !( getOcppContext() ) );
     }
 }

From da67488ece9a70c32fbf50f7f38f37d0f9922743 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 May 2023 17:21:41 +0200
Subject: [PATCH 254/549] fix #152

---
 src/ArduinoOcpp/Core/OcppOperation.cpp    | 4 ++++
 src/ArduinoOcpp/OperationDeserializer.cpp | 1 +
 2 files changed, 5 insertions(+)

diff --git a/src/ArduinoOcpp/Core/OcppOperation.cpp b/src/ArduinoOcpp/Core/OcppOperation.cpp
index f0b2ad91..0c844735 100644
--- a/src/ArduinoOcpp/Core/OcppOperation.cpp
+++ b/src/ArduinoOcpp/Core/OcppOperation.cpp
@@ -204,6 +204,10 @@ std::unique_ptr<DynamicJsonDocument> OcppOperation::createResponse(){
         response->add(MESSAGE_TYPE_CALLRESULT);   //MessageType
         response->add(messageID);            //Unique message ID
         response->add(*payload);              //Payload
+
+        if (onSendConfListener) {
+            onSendConfListener(payload->as<JsonObject>());
+        }
     } else {
         //operation failure. Send error message instead
 
diff --git a/src/ArduinoOcpp/OperationDeserializer.cpp b/src/ArduinoOcpp/OperationDeserializer.cpp
index d10a3c8c..f821d333 100644
--- a/src/ArduinoOcpp/OperationDeserializer.cpp
+++ b/src/ArduinoOcpp/OperationDeserializer.cpp
@@ -64,6 +64,7 @@ std::unique_ptr<OcppOperation> OperationDeserializer::deserializeOperation(const
             auto result = std::unique_ptr<OcppOperation>(new OcppOperation(
                                 std::unique_ptr<OcppMessage>(payload)));
             result->setOnReceiveReqListener(entry->onRequest);
+            result->setOnSendConfListener(entry->onResponse);
             return result;
         }
     }

From 7fad64afd2dd6a5e4f1e76f067ebca9c799583b0 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 May 2023 17:54:40 +0200
Subject: [PATCH 255/549] fix renaming

---
 src/ArduinoOcpp.cpp                           |  2 +-
 src/ArduinoOcpp/Core/OperationRegistry.cpp    |  3 +-
 src/ArduinoOcpp/Core/OperationRegistry.h      |  2 +-
 src/ArduinoOcpp/Core/Request.cpp              |  4 +++
 .../MessagesV16/StartTransaction.cpp          |  7 ++---
 .../MessagesV16/StopTransaction.cpp           |  9 +++---
 .../Authorization/AuthorizationService.cpp    | 29 ++++++++++---------
 src/ArduinoOcpp/Tasks/Boot/BootService.cpp    |  2 +-
 .../ChargeControl/ChargeControlCommon.cpp     | 26 ++++++++---------
 .../Tasks/Diagnostics/DiagnosticsService.cpp  |  4 +--
 .../FirmwareManagement/FirmwareService.cpp    |  4 +--
 .../Tasks/Heartbeat/HeartbeatService.cpp      |  2 +-
 .../Tasks/Metering/MeteringService.cpp        |  2 +-
 .../Tasks/Reservation/ReservationService.cpp  |  4 +--
 src/ArduinoOcpp/Tasks/Reset/ResetService.cpp  |  2 +-
 .../SmartCharging/SmartChargingService.cpp    |  6 ++--
 .../Tasks/Transactions/Transaction.cpp        |  4 +--
 .../Tasks/Transactions/Transaction.h          | 10 +++----
 tests/ChargingSessions.cpp                    |  4 +--
 tests/ConfigurationBehavior.cpp               |  2 +-
 20 files changed, 66 insertions(+), 62 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index da093724..035c4ac4 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -746,7 +746,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
     }
     auto transaction = connector->getTransaction();
     if (transaction) {
-        if (transaction->getStartRpcData().isRequested()) {
+        if (transaction->getStartRpcSync().isRequested()) {
             AO_DBG_ERR("Transaction already in progress. Must call stopTransaction()");
             return false;
         }
diff --git a/src/ArduinoOcpp/Core/OperationRegistry.cpp b/src/ArduinoOcpp/Core/OperationRegistry.cpp
index e68873aa..3252af5e 100644
--- a/src/ArduinoOcpp/Core/OperationRegistry.cpp
+++ b/src/ArduinoOcpp/Core/OperationRegistry.cpp
@@ -24,7 +24,7 @@ OperationCreator *OperationRegistry::findCreator(const char *operationType) {
     return nullptr;
 }
 
-void OperationRegistry::registerRequest(const char *operationType, std::function<Operation*()> creator) {
+void OperationRegistry::registerOperation(const char *operationType, std::function<Operation*()> creator) {
     registry.erase(std::remove_if(registry.begin(), registry.end(),
                 [operationType] (const OperationCreator& el) {
                     return !strcmp(operationType, el.operationType);
@@ -64,6 +64,7 @@ std::unique_ptr<Request> OperationRegistry::deserializeOperation(const char *ope
             auto result = std::unique_ptr<Request>(new Request(
                                 std::unique_ptr<Operation>(payload)));
             result->setOnReceiveReqListener(entry->onRequest);
+            result->setOnSendConfListener(entry->onResponse);
             return result;
         }
     }
diff --git a/src/ArduinoOcpp/Core/OperationRegistry.h b/src/ArduinoOcpp/Core/OperationRegistry.h
index 00ded65f..5b3d8c28 100644
--- a/src/ArduinoOcpp/Core/OperationRegistry.h
+++ b/src/ArduinoOcpp/Core/OperationRegistry.h
@@ -31,7 +31,7 @@ class OperationRegistry {
 public:
     OperationRegistry();
 
-    void registerRequest(const char *operationType, std::function<Operation*()> creator);
+    void registerOperation(const char *operationType, std::function<Operation*()> creator);
     void setOnRequest(const char *operationType, OnReceiveReqListener onRequest);
     void setOnResponse(const char *operationType, OnSendConfListener onResponse);
     
diff --git a/src/ArduinoOcpp/Core/Request.cpp b/src/ArduinoOcpp/Core/Request.cpp
index 6eb906f6..879b3e79 100644
--- a/src/ArduinoOcpp/Core/Request.cpp
+++ b/src/ArduinoOcpp/Core/Request.cpp
@@ -204,6 +204,10 @@ std::unique_ptr<DynamicJsonDocument> Request::createResponse(){
         response->add(MESSAGE_TYPE_CALLRESULT);   //MessageType
         response->add(messageID);            //Unique message ID
         response->add(*payload);              //Payload
+
+        if (onSendConfListener) {
+            onSendConfListener(payload->as<JsonObject>());
+        }
     } else {
         //operation failure. Send error message instead
 
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 7b6a9a1d..82998114 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -12,7 +12,6 @@
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::StartTransaction;
-using ArduinoOcpp::TransactionRPC;
 
 
 StartTransaction::StartTransaction(Model& model, std::shared_ptr<Transaction> transaction) : model(model), transaction(transaction) {
@@ -28,7 +27,7 @@ const char* StartTransaction::getOperationType() {
 }
 
 void StartTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!transaction || transaction->getStartRpcData().isRequested()) {
+    if (!transaction || transaction->getStartRpcSync().isRequested()) {
         AO_DBG_ERR("initialization error");
         return;
     }
@@ -42,7 +41,7 @@ void StartTransaction::initiate(StoredOperationHandler *opStore) {
         opStore->commit();
     }
 
-    transaction->getStartRpcData().setRequested();
+    transaction->getStartRpcSync().setRequested();
 
     transaction->commit();
 
@@ -134,7 +133,7 @@ void StartTransaction::processConf(JsonObject payload) {
     int transactionId = payload["transactionId"] | -1;
     transaction->setTransactionId(transactionId);
 
-    transaction->getStartRpcData().confirm();
+    transaction->getStartRpcSync().confirm();
     transaction->commit();
 
     if (auto authService = model.getAuthorizationService()) {
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index c061fef1..0cd87e0d 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -13,7 +13,6 @@
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::StopTransaction;
-using ArduinoOcpp::TransactionRPC;
 
 StopTransaction::StopTransaction(Model& model, std::shared_ptr<Transaction> transaction)
         : model(model), transaction(transaction) {
@@ -30,7 +29,7 @@ const char* StopTransaction::getOperationType() {
 }
 
 void StopTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!transaction || transaction->getStopRpcData().isRequested()) {
+    if (!transaction || transaction->getStopRpcSync().isRequested()) {
         AO_DBG_ERR("initialization error");
         return;
     }
@@ -44,7 +43,7 @@ void StopTransaction::initiate(StoredOperationHandler *opStore) {
         opStore->commit();
     }
 
-    transaction->getStopRpcData().setRequested();
+    transaction->getStopRpcSync().setRequested();
 
     transaction->commit();
 
@@ -153,7 +152,7 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 void StopTransaction::processConf(JsonObject payload) {
 
     if (transaction) {
-        transaction->getStopRpcData().confirm();
+        transaction->getStopRpcSync().confirm();
         transaction->commit();
     }
 
@@ -167,7 +166,7 @@ void StopTransaction::processConf(JsonObject payload) {
 bool StopTransaction::processErr(const char *code, const char *description, JsonObject details) {
 
     if (transaction) {
-        transaction->getStopRpcData().confirm(); //no retry behavior for now; consider data "arrived" at server
+        transaction->getStopRpcSync().confirm(); //no retry behavior for now; consider data "arrived" at server
         transaction->commit();
     }
 
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index 3e661221..4b594c4f 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -5,19 +5,20 @@
 #include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Core/OcppEngine.h>
-#include <ArduinoOcpp/Core/OcppModel.h>
+#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Core/OperationRegistry.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/MessagesV16/GetLocalListVersion.h>
 #include <ArduinoOcpp/MessagesV16/SendLocalList.h>
 #include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/SimpleOcppOperationFactory.h>
 #include <ArduinoOcpp/Debug.h>
 
 #define AO_LOCALAUTHORIZATIONLIST_FN (AO_FILENAME_PREFIX "localauth.jsn")
 
 using namespace ArduinoOcpp;
 
-AuthorizationService::AuthorizationService(OcppEngine& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
+AuthorizationService::AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
     localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", true, CONFIGURATION_FN, true, true, true, false);
     localAuthListEnabled = declareConfiguration<bool>("LocalAuthListEnabled", true, CONFIGURATION_FN, true, true, true, false);
@@ -39,10 +40,10 @@ AuthorizationService::AuthorizationService(OcppEngine& context, std::shared_ptr<
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
 
-    context.getOperationDeserializer().registerOcppOperation("GetLocalListVersion", [&context] () {
-        return new Ocpp16::GetLocalListVersion(context.getOcppModel());});
-    context.getOperationDeserializer().registerOcppOperation("SendLocalList", [&context] () {
-        return new Ocpp16::SendLocalList(context.getOcppModel());});
+    context.getOperationRegistry().registerOperation("GetLocalListVersion", [&context] () {
+        return new Ocpp16::GetLocalListVersion(context.getModel());});
+    context.getOperationRegistry().registerOperation("SendLocalList", [&context] () {
+        return new Ocpp16::SendLocalList(context.getModel());});
 
     loadLists();
 }
@@ -149,7 +150,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     }
 
     if (localStatus == AuthorizationStatus::Accepted && localInfo->getExpiryDate()) { //check for expiry
-        auto& t_now = context.getOcppModel().getOcppTime().getOcppTimestampNow();
+        auto& t_now = context.getModel().getTime().getTimestampNow();
         if (t_now > *localInfo->getExpiryDate()) {
             AO_DBG_DEBUG("local auth expired");
             localStatus = AuthorizationStatus::Expired;
@@ -176,18 +177,18 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
         //send error code "LocalListConflict" to server
 
         OcppEvseState cpStatus = OcppEvseState::NOT_SET;
-        if (context.getOcppModel().getNumConnectors() > 0) {
-            cpStatus = context.getOcppModel().getConnector(0)->inferenceStatus();
+        if (context.getModel().getNumConnectors() > 0) {
+            cpStatus = context.getModel().getConnector(0)->inferenceStatus();
         }
 
-        auto statusNotification = makeOcppOperation(new Ocpp16::StatusNotification(
+        auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
                     0,
                     cpStatus, //will be determined in StatusNotification::initiate
-                    context.getOcppModel().getOcppTime().getOcppTimestampNow(),
+                    context.getModel().getTime().getTimestampNow(),
                     "LocalListConflict"));
 
         statusNotification->setTimeout(60000);
 
-        context.initiateOperation(std::move(statusNotification));
+        context.initiateRequest(std::move(statusNotification));
     }
 }
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
index 31eea5ff..3cbea79e 100644
--- a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Tasks/Boot/BootService.cpp
@@ -37,7 +37,7 @@ BootService::BootService(Context& context) : context(context) {
     }
 
     //Register message handler for TriggerMessage operation
-    context.getOperationRegistry().registerRequest("BootNotification", [this] () {
+    context.getOperationRegistry().registerOperation("BootNotification", [this] () {
         return new Ocpp16::BootNotification(this->context.getModel(), getChargePointCredentials());});
 }
 
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
index 4ef9e78a..268fcc42 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
@@ -57,23 +57,23 @@ ChargeControlCommon::ChargeControlCommon(Context& context, unsigned int numConn,
     declareConfiguration<bool>("AuthorizeRemoteTxRequests",false,CONFIGURATION_VOLATILE,false,true,false,false);
     declareConfiguration<int>("GetConfigurationMaxKeys",30,CONFIGURATION_VOLATILE,false,true,false,false);
     
-    context.getOperationRegistry().registerRequest("ChangeAvailability", [&context] () {
+    context.getOperationRegistry().registerOperation("ChangeAvailability", [&context] () {
         return new Ocpp16::ChangeAvailability(context.getModel());});
-    context.getOperationRegistry().registerRequest("ChangeConfiguration", [] () {
+    context.getOperationRegistry().registerOperation("ChangeConfiguration", [] () {
         return new Ocpp16::ChangeConfiguration();});
-    context.getOperationRegistry().registerRequest("ClearCache", [filesystem] () {
+    context.getOperationRegistry().registerOperation("ClearCache", [filesystem] () {
         return new Ocpp16::ClearCache(filesystem);});
-    context.getOperationRegistry().registerRequest("GetConfiguration", [] () {
+    context.getOperationRegistry().registerOperation("GetConfiguration", [] () {
         return new Ocpp16::GetConfiguration();});
-    context.getOperationRegistry().registerRequest("RemoteStartTransaction", [&context] () {
+    context.getOperationRegistry().registerOperation("RemoteStartTransaction", [&context] () {
         return new Ocpp16::RemoteStartTransaction(context.getModel());});
-    context.getOperationRegistry().registerRequest("RemoteStopTransaction", [&context] () {
+    context.getOperationRegistry().registerOperation("RemoteStopTransaction", [&context] () {
         return new Ocpp16::RemoteStopTransaction(context.getModel());});
-    context.getOperationRegistry().registerRequest("Reset", [&context] () {
+    context.getOperationRegistry().registerOperation("Reset", [&context] () {
         return new Ocpp16::Reset(context.getModel());});
-    context.getOperationRegistry().registerRequest("TriggerMessage", [&context] () {
+    context.getOperationRegistry().registerOperation("TriggerMessage", [&context] () {
         return new Ocpp16::TriggerMessage(context.getModel());});
-    context.getOperationRegistry().registerRequest("UnlockConnector", [&context] () {
+    context.getOperationRegistry().registerOperation("UnlockConnector", [&context] () {
         return new Ocpp16::UnlockConnector(context.getModel());});
 
     /*
@@ -81,13 +81,13 @@ ChargeControlCommon::ChargeControlCommon(Context& context, unsigned int numConn,
      * is connected with a WebSocket echo server, let it reply to its own requests.
      * Mocking an OCPP Server on the same device makes running (unit) tests easier.
      */
-    context.getOperationRegistry().registerRequest("Authorize", [&context] () {
+    context.getOperationRegistry().registerOperation("Authorize", [&context] () {
         return new Ocpp16::Authorize(context.getModel(), nullptr);});
-    context.getOperationRegistry().registerRequest("StartTransaction", [&context] () {
+    context.getOperationRegistry().registerOperation("StartTransaction", [&context] () {
         return new Ocpp16::StartTransaction(context.getModel(), nullptr);});
-    context.getOperationRegistry().registerRequest("StatusNotification", [&context] () {
+    context.getOperationRegistry().registerOperation("StatusNotification", [&context] () {
         return new Ocpp16::StatusNotification(-1, OcppEvseState::NOT_SET, Timestamp());});
-    context.getOperationRegistry().registerRequest("StopTransaction", [&context] () {
+    context.getOperationRegistry().registerOperation("StopTransaction", [&context] () {
         return new Ocpp16::StopTransaction(context.getModel(), nullptr);});
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
index ca1dd318..4a32eb92 100644
--- a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
+++ b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
@@ -26,11 +26,11 @@ DiagnosticsService::DiagnosticsService(Context& context) : context(context) {
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
     
-    context.getOperationRegistry().registerRequest("GetDiagnostics", [&context] () {
+    context.getOperationRegistry().registerOperation("GetDiagnostics", [&context] () {
         return new Ocpp16::GetDiagnostics(context.getModel());});
 
     //Register message handler for TriggerMessage operation
-    context.getOperationRegistry().registerRequest("DiagnosticsStatusNotification", [this] () {
+    context.getOperationRegistry().registerOperation("DiagnosticsStatusNotification", [this] () {
         return new Ocpp16::DiagnosticsStatusNotification(getDiagnosticsStatus());});
 }
 
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index e3839e19..0e9ce508 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -30,11 +30,11 @@ FirmwareService::FirmwareService(Context& context) : context(context) {
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
     
-    context.getOperationRegistry().registerRequest("UpdateFirmware", [&context] () {
+    context.getOperationRegistry().registerOperation("UpdateFirmware", [&context] () {
         return new Ocpp16::UpdateFirmware(context.getModel());});
 
     //Register message handler for TriggerMessage operation
-    context.getOperationRegistry().registerRequest("FirmwareStatusNotification", [this] () {
+    context.getOperationRegistry().registerOperation("FirmwareStatusNotification", [this] () {
         return new Ocpp16::FirmwareStatusNotification(getFirmwareStatus());});
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
index 2053f19e..9fa4a0a9 100644
--- a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
+++ b/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
@@ -16,7 +16,7 @@ HeartbeatService::HeartbeatService(Context& context) : context(context) {
     lastHeartbeat = ao_tick_ms();
 
     //Register message handler for TriggerMessage operation
-    context.getOperationRegistry().registerRequest("Heartbeat", [&context] () {
+    context.getOperationRegistry().registerOperation("Heartbeat", [&context] () {
         return new Ocpp16::Heartbeat(context.getModel());});
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index d47d1fd8..5fc17d10 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -24,7 +24,7 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
      * is connected with a WebSocket echo server, let it reply to its own requests.
      * Mocking an OCPP Server on the same device makes running (unit) tests easier.
      */
-    context.getOperationRegistry().registerRequest("MeterValues", [] () {
+    context.getOperationRegistry().registerOperation("MeterValues", [] () {
         return new Ocpp16::MeterValues();});
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
index e0f0f495..1c056007 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
@@ -35,9 +35,9 @@ ReservationService::ReservationService(Context& context, unsigned int numConnect
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
     
-    context.getOperationRegistry().registerRequest("CancelReservation", [&context] () {
+    context.getOperationRegistry().registerOperation("CancelReservation", [&context] () {
         return new Ocpp16::CancelReservation(context.getModel());});
-    context.getOperationRegistry().registerRequest("ReserveNow", [&context] () {
+    context.getOperationRegistry().registerOperation("ReserveNow", [&context] () {
         return new Ocpp16::ReserveNow(context.getModel());});
 }
 
diff --git a/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp b/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
index aec3e1b1..1df88693 100644
--- a/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
@@ -28,7 +28,7 @@ ResetService::ResetService(Context& context)
 
     resetRetries = declareConfiguration<int>("ResetRetries", 2, CONFIGURATION_FN, true, true, false, false);
 
-    context.getOperationRegistry().registerRequest("Reset", [&context] () {
+    context.getOperationRegistry().registerOperation("Reset", [&context] () {
         return new Ocpp16::Reset(context.getModel());});
 }
 
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index b0ddf74f..dcc02435 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -77,11 +77,11 @@ SmartChargingService::SmartChargingService(Context& context, float chargeLimit,
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
 
-    context.getOperationRegistry().registerRequest("ClearChargingProfile", [&context] () {
+    context.getOperationRegistry().registerOperation("ClearChargingProfile", [&context] () {
         return new Ocpp16::ClearChargingProfile(context.getModel());});
-    context.getOperationRegistry().registerRequest("GetCompositeSchedule", [&context] () {
+    context.getOperationRegistry().registerOperation("GetCompositeSchedule", [&context] () {
         return new Ocpp16::GetCompositeSchedule(context.getModel());});
-    context.getOperationRegistry().registerRequest("SetChargingProfile", [&context] () {
+    context.getOperationRegistry().registerOperation("SetChargingProfile", [&context] () {
         return new Ocpp16::SetChargingProfile(context.getModel());});
 
     loadProfiles();
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index abe8398e..3cb7da73 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -9,7 +9,7 @@
 
 using namespace ArduinoOcpp;
 
-bool TransactionRPC::serializeSessionState(JsonObject rpc) {
+bool RpcSync::serializeSessionState(JsonObject rpc) {
     rpc["requested"] = requested;
     rpc["confirmed"] = confirmed;
     return true;
@@ -109,7 +109,7 @@ bool Transaction::serializeSessionState(DynamicJsonDocument& out) {
     return true;
 }
 
-bool TransactionRPC::deserializeSessionState(JsonObject rpc) {
+bool RpcSync::deserializeSessionState(JsonObject rpc) {
     if (rpc["requested"] | false) {
         requested = true;
     }
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index e4bc6c68..75f9b760 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -23,7 +23,7 @@ namespace ArduinoOcpp {
 
 class ConnectorTransactionStore;
 
-class TransactionRPC {
+class RpcSync {
 private:
     friend class Transaction;
     
@@ -60,7 +60,7 @@ class TransactionStart {
 private:
     friend class Transaction;
     
-    TransactionRPC rpc;
+    RpcSync rpc;
     ClientTransactionStart client;
     ServerTransactionStart server;
 };
@@ -83,7 +83,7 @@ class TransactionStop {
 private:
     friend class Transaction;
 
-    TransactionRPC rpc;
+    RpcSync rpc;
     ClientTransactionStop client;
     ServerTransactionStop server;
 };
@@ -131,9 +131,9 @@ class Transaction {
     unsigned int getTxNr() {return txNr;} //only valid if getConnectorId() >= 0
     void setTxNr(unsigned int txNr) {this->txNr = txNr;}
 
-    TransactionRPC& getStartRpcSync() {return start.rpc;}
+    RpcSync& getStartRpcSync() {return start.rpc;}
 
-    TransactionRPC& getStopRpcSync() {return stop.rpc;}
+    RpcSync& getStopRpcSync() {return stop.rpc;}
 
     bool isAborted() {return !start.rpc.requested && !session.active;}
     bool isCompleted() {return stop.rpc.isConfirmed();}
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 758948d6..b0505026 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -30,7 +30,7 @@ TEST_CASE( "Charging sessions" ) {
     
     std::array<const char*, 2> expectedSN {"Available", "Available"};
     std::array<bool, 2> checkedSN {false, false};
-    checkMsg.registerRequest("StatusNotification", [] () -> Operation* {return new Ocpp16::StatusNotification(0, OcppEvseState::NOT_SET, MIN_TIME);});
+    checkMsg.registerOperation("StatusNotification", [] () -> Operation* {return new Ocpp16::StatusNotification(0, OcppEvseState::NOT_SET, MIN_TIME);});
     checkMsg.setOnRequest("StatusNotification",
         [&checkedSN, &expectedSN] (JsonObject request) {
             int connectorId = request["connectorId"] | -1;
@@ -40,7 +40,7 @@ TEST_CASE( "Charging sessions" ) {
     SECTION("Check idle state"){
 
         bool checkedBN = false;
-        checkMsg.registerRequest("BootNotification", [engine] () -> Operation* {return new Ocpp16::BootNotification(engine->getModel(), std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(0)));});
+        checkMsg.registerOperation("BootNotification", [engine] () -> Operation* {return new Ocpp16::BootNotification(engine->getModel(), std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(0)));});
         checkMsg.setOnRequest("BootNotification",
             [&checkedBN] (JsonObject request) {
                 checkedBN = !strcmp(request["chargePointModel"] | "Invalid", "test-runner1234");
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 23af1a8a..50aed0c3 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -82,7 +82,7 @@ TEST_CASE( "Configuration Behavior" ) {
     SECTION("StopTransactionOnInvalidId") {
         auto config = declareConfiguration<bool>("StopTransactionOnInvalidId", true);
 
-        checkMsg.registerRequest("StartTransaction", [] () {return new CustomStartTransaction("Invalid");});
+        checkMsg.registerOperation("StartTransaction", [] () {return new CustomStartTransaction("Invalid");});
 
         SECTION("set true") {
             *config = true;

From 5ac5197eb4d88416c46829f150a9874c469dccb4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 May 2023 19:03:06 +0200
Subject: [PATCH 256/549] add unit tests in build system

---
 CMakeLists.txt | 41 +++++++++++++++++++++++++++++++++++++----
 1 file changed, 37 insertions(+), 4 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 1e49088e..9bb39ca7 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -96,13 +96,46 @@ endif()
 add_library(ArduinoOcpp ${AO_SRC})
 
 target_include_directories(ArduinoOcpp PUBLIC
-                            "./src"
-                            "../ArduinoJson/src"
-                            )
+    "./src"
+    "../ArduinoJson/src"
+)
 
 target_compile_definitions(ArduinoOcpp PUBLIC
     AO_PLATFORM=AO_PLATFORM_UNIX
     AO_CUSTOM_WS
     AO_CUSTOM_UPDATER
     AO_CUSTOM_RESET
-    )
+)
+
+# Unit tests
+
+set(AO_SRC_UNIT
+    tests/helpers/testHelper.cpp
+    tests/ocppEngineLifecycle.cpp
+    tests/TransactionSafety.cpp
+    tests/ChargingSessions.cpp
+    tests/ConfigurationBehavior.cpp
+)
+
+add_executable(ao_unit_tests
+    ${AO_SRC}
+    ${AO_SRC_UNIT}
+    ./tests/catch2/catchMain.cpp
+)
+
+target_include_directories(ao_unit_tests PUBLIC
+    "./tests/catch2"
+    "./tests/helpers"
+    "./src"
+)
+
+target_compile_definitions(ao_unit_tests PUBLIC
+    AO_PLATFORM=AO_PLATFORM_UNIX
+    AO_CUSTOM_TIMER
+    AO_CUSTOM_WS
+    AO_CUSTOM_UPDATER
+    AO_CUSTOM_RESET
+    AO_DBG_LEVEL=AO_DL_DEBUG
+    AO_TRAFFIC_OUT
+    AO_FILENAME_PREFIX="./ao_store/"
+)

From 8ef05f553c4afc12fdb13021e91eb384fb383abe Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 May 2023 19:06:16 +0200
Subject: [PATCH 257/549] fix stale tx (StopTransactionOnInvlidId)

---
 .../Tasks/ChargeControl/Connector.cpp         | 16 ++++++-----
 tests/ConfigurationBehavior.cpp               | 28 +++++++++++++++++++
 2 files changed, 37 insertions(+), 7 deletions(-)

diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index 57e23ff4..e2c18a8d 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -201,13 +201,15 @@ void Connector::loop() {
             transaction->commit();
         }
 
-        if (transaction->isActive() && transaction->isIdTagDeauthorized()) {
-            if (!stopTransactionOnInvalidId || *stopTransactionOnInvalidId) {
-                AO_DBG_DEBUG("DeAuthorize session");
-                transaction->setStopReason("DeAuthorized");
-                transaction->endSession();
-                transaction->commit();
-            }
+        if (transaction->isActive() &&
+                transaction->isIdTagDeauthorized() && ( //transaction has been deAuthorized
+                    !transaction->isRunning() ||        //if transaction hasn't started yet, always end
+                    !stopTransactionOnInvalidId || *stopTransactionOnInvalidId)) { //if transaction is running, behavior depends on StopTransactionOnInvalidId
+            
+            AO_DBG_DEBUG("DeAuthorize session");
+            transaction->setStopReason("DeAuthorized");
+            transaction->endSession();
+            transaction->commit();
         }
 
         /*
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 50aed0c3..100e826c 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -10,6 +10,23 @@
 
 using namespace ArduinoOcpp;
 
+class CustomAuthorize : public Operation {
+private:
+    const char *status;
+public:
+    CustomAuthorize(const char *status) : status(status) { };
+    const char *getOperationType() override {return "Authorize";}
+    void processReq(JsonObject payload) override {
+        //ignore payload - result is determined at construction time
+    }
+    std::unique_ptr<DynamicJsonDocument> createConf() override {
+        auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+        auto payload = res->to<JsonObject>();
+        payload["idTagInfo"]["status"] = status;
+        return res;
+    }
+};
+
 class CustomStartTransaction : public Operation {
 private:
     const char *status;
@@ -82,11 +99,17 @@ TEST_CASE( "Configuration Behavior" ) {
     SECTION("StopTransactionOnInvalidId") {
         auto config = declareConfiguration<bool>("StopTransactionOnInvalidId", true);
 
+        checkMsg.registerOperation("Authorize", [] () {return new CustomAuthorize("Invalid");});
         checkMsg.registerOperation("StartTransaction", [] () {return new CustomStartTransaction("Invalid");});
 
         SECTION("set true") {
             *config = true;
 
+            beginTransaction("mIdTag");
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+
             beginTransaction_authorized("mIdTag");
             loop();
 
@@ -96,6 +119,11 @@ TEST_CASE( "Configuration Behavior" ) {
         SECTION("set false") {
             *config = false;
 
+            beginTransaction("mIdTag");
+            loop();
+
+            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+
             beginTransaction_authorized("mIdTag");
             loop();
 

From efd570bcdc04c83234d2251f98a76a7f92257034 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 28 May 2023 20:12:08 +0200
Subject: [PATCH 258/549] refactor time

---
 src/ArduinoOcpp.cpp                           |   6 +-
 src/ArduinoOcpp.h                             |   1 -
 src/ArduinoOcpp/Core/Context.cpp              |   4 +-
 src/ArduinoOcpp/Core/Context.h                |   2 +-
 src/ArduinoOcpp/Core/Model.cpp                |   7 +-
 src/ArduinoOcpp/Core/Model.h                  |   7 +-
 src/ArduinoOcpp/Core/Time.cpp                 | 105 +++++++++---------
 src/ArduinoOcpp/Core/Time.h                   |  51 ++++-----
 .../MessagesV16/BootNotification.cpp          |   6 +-
 .../MessagesV16/GetCompositeSchedule.cpp      |   2 +-
 .../MessagesV16/GetCompositeSchedule.h        |   2 +-
 src/ArduinoOcpp/MessagesV16/Heartbeat.cpp     |   4 +-
 .../MessagesV16/TriggerMessage.cpp            |   2 +-
 .../Authorization/AuthorizationService.cpp    |   4 +-
 .../Tasks/ChargeControl/Connector.cpp         |  16 +--
 .../Tasks/Diagnostics/DiagnosticsService.cpp  |   6 +-
 .../FirmwareManagement/FirmwareService.cpp    |   2 +-
 .../Metering/ConnectorMeterValuesRecorder.cpp |  16 +--
 .../Tasks/Reservation/Reservation.cpp         |   2 +-
 .../SmartCharging/SmartChargingService.cpp    |  18 +--
 .../SmartCharging/SmartChargingService.h      |   2 +-
 21 files changed, 126 insertions(+), 139 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 035c4ac4..e8bd1391 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -134,7 +134,7 @@ void OCPP_initialize(Connection& connection, const char *bootNotificationCredent
     
     configuration_init(filesystem); //call before each other library call
 
-    context = new Context(connection, Clocks::DEFAULT_CLOCK, filesystem);
+    context = new Context(connection, filesystem);
     auto& model = context->getModel();
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
@@ -769,7 +769,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         }
     }
 
-    transaction->setStartTimestamp(context->getModel().getTime().getTimestampNow());
+    transaction->setStartTimestamp(context->getModel().getClock().now());
 
     transaction->commit();
     
@@ -827,7 +827,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         }
     }
 
-    transaction->setStopTimestamp(context->getModel().getTime().getTimestampNow());
+    transaction->setStopTimestamp(context->getModel().getClock().now());
 
     transaction->commit();
 
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 65db1aa1..e645f0b3 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -10,7 +10,6 @@
 #include <functional>
 
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
-#include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/Core/RequestCallbacks.h>
 #include <ArduinoOcpp/Core/Connection.h>
 #include <ArduinoOcpp/Core/PollResult.h>
diff --git a/src/ArduinoOcpp/Core/Context.cpp b/src/ArduinoOcpp/Core/Context.cpp
index 9aa34e76..aecc4530 100644
--- a/src/ArduinoOcpp/Core/Context.cpp
+++ b/src/ArduinoOcpp/Core/Context.cpp
@@ -13,8 +13,8 @@ using namespace ArduinoOcpp;
 
 Context *ArduinoOcpp::defaultContext = nullptr;
 
-Context::Context(Connection& connection, const Clock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem)
-        : connection(connection), model{std::make_shared<Model>(system_clock)}, reqQueue{operationRegistry, model, filesystem} {
+Context::Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem)
+        : connection(connection), model{std::make_shared<Model>()}, reqQueue{operationRegistry, model, filesystem} {
     defaultContext = this;
 
     preBootQueue = std::unique_ptr<RequestQueue>(new RequestQueue(operationRegistry, model, nullptr)); //pre boot queue doesn't need persistency
diff --git a/src/ArduinoOcpp/Core/Context.h b/src/ArduinoOcpp/Core/Context.h
index 02ad14f8..efd77bd0 100644
--- a/src/ArduinoOcpp/Core/Context.h
+++ b/src/ArduinoOcpp/Core/Context.h
@@ -27,7 +27,7 @@ class Context {
     std::unique_ptr<RequestQueue> preBootQueue;
 
 public:
-    Context(Connection& connection, const Clock& system_clock, std::shared_ptr<FilesystemAdapter> filesystem);
+    Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem);
     ~Context();
 
     void loop();
diff --git a/src/ArduinoOcpp/Core/Model.cpp b/src/ArduinoOcpp/Core/Model.cpp
index 0ad916c6..ba74fd7d 100644
--- a/src/ArduinoOcpp/Core/Model.cpp
+++ b/src/ArduinoOcpp/Core/Model.cpp
@@ -19,8 +19,7 @@
 
 using namespace ArduinoOcpp;
 
-Model::Model(const Clock& system_clock)
-        : time{system_clock} {
+Model::Model() {
     
 }
 
@@ -163,6 +162,6 @@ ResetService *Model::getResetService() const {
     return resetService.get();
 }
 
-Time& Model::getTime() {
-    return time;
+Clock& Model::getClock() {
+    return clock;
 }
diff --git a/src/ArduinoOcpp/Core/Model.h b/src/ArduinoOcpp/Core/Model.h
index b3b6846c..f6a4bc5c 100644
--- a/src/ArduinoOcpp/Core/Model.h
+++ b/src/ArduinoOcpp/Core/Model.h
@@ -38,13 +38,12 @@ class Model {
     std::unique_ptr<ReservationService> reservationService;
     std::unique_ptr<BootService> bootService;
     std::unique_ptr<ResetService> resetService;
-    Time time;
+    Clock clock;
 
     bool runTasks = false;
 
 public:
-    Model(const Clock& system_clock);
-    Model() = delete;
+    Model();
     Model(const Model& rhs) = delete;
     ~Model();
 
@@ -88,7 +87,7 @@ class Model {
     void setResetService(std::unique_ptr<ResetService> rs);
     ResetService *getResetService() const;
 
-    Time &getTime();
+    Clock &getClock();
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Core/Time.cpp b/src/ArduinoOcpp/Core/Time.cpp
index 57041794..fac883cf 100644
--- a/src/ArduinoOcpp/Core/Time.cpp
+++ b/src/ArduinoOcpp/Core/Time.cpp
@@ -1,9 +1,8 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Platform.h>
 #include <string.h>
 #include <ctype.h>	
 
@@ -12,24 +11,6 @@ namespace ArduinoOcpp {
 const Timestamp MIN_TIME = Timestamp(2010, 0, 0, 0, 0, 0);
 const Timestamp MAX_TIME = Timestamp(2037, 0, 0, 0, 0, 0);
 
-namespace Clocks {
-
-unsigned long lastClockReading = 0;
-otime_t lastClockValue = 0;
-
-/*
- * Basic clock implementation. Works if ao_tick_ms() is exact enough for you and if device doesn't go in sleep mode. 
- */
-Clock DEFAULT_CLOCK = [] () {
-    unsigned long tReading = (ao_tick_ms() - lastClockReading) / 1000UL;
-    if (tReading > 0) {
-        lastClockValue += tReading;
-        lastClockReading += tReading * 1000UL;
-    }
-    return lastClockValue;};
-} //end namespace Clocks
-
-
 Timestamp::Timestamp() {
     
 }
@@ -89,14 +70,29 @@ bool Timestamp::setTime(const char *jsonDateString) {
                 (jsonDateString[15] - '0');
     int second = (jsonDateString[17] - '0') * 10 +
                 (jsonDateString[18] - '0');
-    //ignore fractals
+
+    //optional fractals
+    int ms = 0;
+    if (jsonDateString[19] == '.') {
+        if (isdigit(jsonDateString[20]) ||   //1
+            isdigit(jsonDateString[21]) ||   //2
+            isdigit(jsonDateString[22])) {
+            
+            ms  =  (jsonDateString[20] - '0') * 100 +
+                    (jsonDateString[21] - '0') * 10 +
+                    (jsonDateString[22] - '0');
+        } else {
+            return false;
+        }
+    }
 
     if (year < 1970 || year >= 2038 ||
         month < 0 || month >= 12 ||
         day < 0 || day >= noDays(month, year) ||
         hour < 0 || hour >= 24 ||
         minute < 0 || minute >= 60 ||
-        second < 0 || second > 60) { //tolerate leap seconds -- (23:59:60) can be a valid time
+        second < 0 || second > 60 || //tolerate leap seconds -- (23:59:60) can be a valid time
+        ms < 0 || ms >= 1000) {
         return false;
     }
 
@@ -106,6 +102,7 @@ bool Timestamp::setTime(const char *jsonDateString) {
     this->hour = hour;
     this->minute = minute;
     this->second = second;
+    this->ms = ms;
     
     return true;
 }
@@ -133,9 +130,9 @@ bool Timestamp::toJsonString(char *jsonDateString, size_t buffsize) const {
     jsonDateString[17] = ((char) ((second / 10) % 10))  + '0';
     jsonDateString[18] = ((char) ((second / 1) % 10))  + '0';
     jsonDateString[19] = '.';
-    jsonDateString[20] = '0'; //ignore fractals
-    jsonDateString[21] = '0';
-    jsonDateString[22] = '0';
+    jsonDateString[20] = ((char) ((ms / 100) % 10))  + '0';
+    jsonDateString[21] = ((char) ((ms / 10) % 10))  + '0';
+    jsonDateString[22] = ((char) ((ms / 1) % 10))  + '0';
     jsonDateString[23] = 'Z';
 
     return true;
@@ -194,11 +191,26 @@ Timestamp &Timestamp::operator+=(int secs) {
     return *this;
 };
 
+Timestamp &Timestamp::addMilliseconds(int val) {
+
+    ms += val;
+
+    if (ms >= 0 && ms < 1000) return *this;
+    
+    auto dsecond = ms / 1000;
+    ms %= 1000;
+    if (ms < 0) {
+        dsecond--;
+        ms += 1000;
+    }
+    return this->operator+=(dsecond);
+}
+
 Timestamp &Timestamp::operator-=(int secs) {
     return operator+=(-secs);
 }
 
-otime_t Timestamp::operator-(const Timestamp &rhs) const {
+int Timestamp::operator-(const Timestamp &rhs) const {
     //dt = rhs - ocpp_base
     
     int16_t year_base, year_end;
@@ -224,7 +236,7 @@ otime_t Timestamp::operator-(const Timestamp &rhs) const {
         }
     }
 
-    otime_t dt = (lhsDays - rhsDays) * (24 * 3600) + (hour - rhs.hour) * 3600 + (minute - rhs.minute) * 60 + second - rhs.second;
+    int dt = (lhsDays - rhsDays) * (24 * 3600) + (hour - rhs.hour) * 3600 + (minute - rhs.minute) * 60 + second - rhs.second;
     return dt;
 }
 
@@ -235,6 +247,7 @@ Timestamp &Timestamp::operator=(const Timestamp &rhs) {
     hour = rhs.hour;
     minute = rhs.minute;
     second = rhs.second;
+    ms = rhs.ms;
 
     return *this;
 }
@@ -250,7 +263,7 @@ Timestamp operator-(const Timestamp &lhs, int secs) {
 }
 
 bool operator==(const Timestamp &lhs, const Timestamp &rhs) {
-    return lhs.year == rhs.year && lhs.month == rhs.month && lhs.day == rhs.day && lhs.hour == rhs.hour && lhs.minute == rhs.minute && lhs.second == rhs.second;
+    return lhs.year == rhs.year && lhs.month == rhs.month && lhs.day == rhs.day && lhs.hour == rhs.hour && lhs.minute == rhs.minute && lhs.second == rhs.second && lhs.ms == rhs.ms;
 }
 
 bool operator!=(const Timestamp &lhs, const Timestamp &rhs) {
@@ -270,6 +283,8 @@ bool operator<(const Timestamp &lhs, const Timestamp &rhs) {
         return lhs.minute < rhs.minute;
     if (lhs.second != rhs.second)
         return lhs.second < rhs.second;
+    if (lhs.ms != rhs.ms)
+        return lhs.ms < rhs.ms;
     return false;  
 }
 
@@ -286,11 +301,11 @@ bool operator>=(const Timestamp &lhs, const Timestamp &rhs) {
 }
 
 
-Time::Time(const Clock& system_clock) : system_clock(system_clock) {
+Clock::Clock() {
 
 }
 
-bool Time::setTime(const char* jsonDateString) {
+bool Clock::setTime(const char* jsonDateString) {
 
     Timestamp timestamp = Timestamp();
     
@@ -298,37 +313,23 @@ bool Time::setTime(const char* jsonDateString) {
         return false;
     }
 
-    system_basetime = system_clock();
+    system_basetime = ao_tick_ms();
     ocpp_basetime = timestamp;
-    timeIsSet = true;
 
     currentTime = ocpp_basetime;
-    previousUpdate = system_basetime;
+    lastUpdate = system_basetime;
 
     return true;
 }
 
-otime_t Time::getTimeScalar() {
-    return system_clock();
-}
+const Timestamp &Clock::now() {
+    auto tReading = ao_tick_ms();
+    auto delta = tReading - lastUpdate;
 
-const Timestamp &Time::getTimestampNow() {
-    otime_t tNow = system_clock();
-    if (previousUpdate != tNow) {
-        currentTime += (tNow - previousUpdate);
-        previousUpdate = tNow;
-    }
-    return currentTime;
-}
+    currentTime.addMilliseconds(delta);
+    lastUpdate = tReading;
 
-Timestamp Time::createTimestamp(otime_t scalar) {
-    Timestamp res = ocpp_basetime + (scalar - system_basetime);
-
-    return res;
-}
-
-otime_t Time::toTimeScalar(const Timestamp &timestamp) {
-    return timestamp.operator-(ocpp_basetime);
+    return currentTime;
 }
 
 }
diff --git a/src/ArduinoOcpp/Core/Time.h b/src/ArduinoOcpp/Core/Time.h
index 1d5bf5e4..2367d32c 100644
--- a/src/ArduinoOcpp/Core/Time.h
+++ b/src/ArduinoOcpp/Core/Time.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPPTIME_H
@@ -9,22 +9,11 @@
 #include <stdint.h>
 #include <stddef.h>
 
-namespace ArduinoOcpp {
-
-typedef int32_t otime_t; //requires 32bit signed integer or bigger
-#define OTIME_MAX ((otime_t) INT32_MAX)
-typedef std::function<otime_t()> Clock;
+#include <ArduinoOcpp/Platform.h>
 
-#define INFINITY_THLD (OTIME_MAX - ((otime_t) (400 * 24 * 3600))) //Upper limiter for valid time range. From this value on, a scalar time means "infinity". It's 400 days before the "year 2038" problem.
 #define JSONDATE_LENGTH 24
 
-namespace Clocks {
-
-/*
- * Basic clock implementation. Works if ao_tick_ms() is exact enough for you and if device doesn't go in sleep mode. 
- */
-extern Clock DEFAULT_CLOCK;
-} //end namespace Clocks
+namespace ArduinoOcpp {
 
 class Timestamp {
 private:
@@ -38,6 +27,7 @@ class Timestamp {
     int32_t hour = 0;
     int32_t minute = 0;
     int32_t second = 0;
+    int32_t ms = 0;
 
 public:
 
@@ -45,8 +35,8 @@ class Timestamp {
 
     Timestamp(const Timestamp& other);
 
-    Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second) :
-                year(year), month(month), day(day), hour(hour), minute(minute), second(second) { };
+    Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second, int32_t ms = 0) :
+                year(year), month(month), day(day), hour(hour), minute(minute), second(second), ms(ms) { };
 
     /**
      * Expects a date string like
@@ -67,10 +57,15 @@ class Timestamp {
 
     Timestamp &operator=(const Timestamp &rhs);
 
+    Timestamp &addMilliseconds(int ms);
+
+    /*
+     * Time periods are given in seconds for all of the following arithmetic operations
+     */
     Timestamp &operator+=(int secs);
     Timestamp &operator-=(int secs);
 
-    otime_t operator-(const Timestamp &rhs) const;
+    int operator-(const Timestamp &rhs) const;
 
     friend Timestamp operator+(const Timestamp &lhs, int secs);
     friend Timestamp operator-(const Timestamp &lhs, int secs);
@@ -86,27 +81,23 @@ class Timestamp {
 extern const Timestamp MIN_TIME;
 extern const Timestamp MAX_TIME;
 
-class Time {
+class Clock {
 private:
 
     Timestamp ocpp_basetime = Timestamp();
-    otime_t system_basetime = 0; //your system clock's time at the moment when the OCPP server's time was taken
-    bool timeIsSet = false;
-
-    Clock system_clock = [] () {return (otime_t) 0;};
+    decltype(ao_tick_ms()) system_basetime = 0; //the value of ao_tick_ms() when OCPP server's time was taken
+    decltype(ao_tick_ms()) lastUpdate = 0;
 
     Timestamp currentTime = Timestamp();
-    otime_t previousUpdate = -1;
 
 public:
 
-    Time(const Clock& system_clock);
-    //Time(const Time& time) = default;
+    Clock();
+    Clock(const Clock&) = delete;
+    Clock(const Clock&&) = delete;
+    Clock& operator=(const Clock&) = delete;
 
-    otime_t getTimeScalar(); //returns current time of the OCPP server in non-UNIX but signed integer format. t2 - t1 is the time difference in seconds. 
-    const Timestamp &getTimestampNow();
-    Timestamp createTimestamp(otime_t scalar); //creates a timestamp in a JSON-serializable format. createTimestamp(getTimeScalar()) will return the current OCPP time
-    otime_t toTimeScalar(const Timestamp &timestamp);
+    const Timestamp &now();
 
     /**
      * Expects a date string like
@@ -122,8 +113,6 @@ class Time {
      * jsonDateString: 0-terminated string
      */
     bool setTime(const char* jsonDateString);
-
-    bool isValid() {return timeIsSet;}
 };
 
 }
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
index 4ad37450..5cd9efd5 100644
--- a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/BootNotification.cpp
@@ -32,7 +32,7 @@ std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
 void BootNotification::processConf(JsonObject payload) {
     const char* currentTime = payload["currentTime"] | "Invalid";
     if (strcmp(currentTime, "Invalid")) {
-        if (model.getTime().setTime(currentTime)) {
+        if (model.getClock().setTime(currentTime)) {
             //success
         } else {
             AO_DBG_ERR("Time string format violation. Expect format like 2022-02-01T20:53:32.486Z");
@@ -96,8 +96,8 @@ std::unique_ptr<DynamicJsonDocument> BootNotification::createConf(){
     //safety mechanism; in some test setups the library has to answer BootNotifications without valid system time
     Timestamp ocppTimeReference = Timestamp(2022,0,27,11,59,55); 
     Timestamp ocppSelect = ocppTimeReference;
-    auto& ocppTime = model.getTime();
-    Timestamp ocppNow = ocppTime.getTimestampNow();
+    auto& ocppTime = model.getClock();
+    Timestamp ocppNow = ocppTime.now();
     if (ocppNow > ocppTimeReference) {
         //time has already been set
         ocppSelect = ocppNow;
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
index 5abd782a..7a329f3f 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
@@ -78,7 +78,7 @@ std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
         if (startSchedule[0] != '\0') {
             strncpy(scheduleStart, startSchedule, JSONDATE_LENGTH + 1);
         } else {
-            model.getTime().getTimestampNow().toJsonString(scheduleStart, JSONDATE_LENGTH + 1);
+            model.getClock().now().toJsonString(scheduleStart, JSONDATE_LENGTH + 1);
         }
         payload["scheduleStart"] = scheduleStart;
         
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
index f00f9e8e..dee0b167 100644
--- a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
+++ b/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
@@ -19,7 +19,7 @@ class GetCompositeSchedule : public Operation {
 private:
     Model& model;
     int connectorId {-1};
-    otime_t duration {0};
+    int duration {0};
     ChargingRateUnitType chargingRateUnit {ChargingRateUnitType::Watt};
 
     const char *errorCode {nullptr};
diff --git a/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp b/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
index e46be775..7e0975c4 100644
--- a/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
+++ b/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
@@ -25,7 +25,7 @@ void Heartbeat::processConf(JsonObject payload) {
   
     const char* currentTime = payload["currentTime"] | "Invalid";
     if (strcmp(currentTime, "Invalid")) {
-        if (model.getTime().setTime(currentTime)) {
+        if (model.getClock().setTime(currentTime)) {
             //success
             AO_DBG_DEBUG("Request has been accepted");
         } else {
@@ -51,7 +51,7 @@ std::unique_ptr<DynamicJsonDocument> Heartbeat::createConf(){
     //safety mechanism; in some test setups the library could have to answer Heartbeats without valid system time
     Timestamp ocppTimeReference = Timestamp(2019,10,0,11,59,55); 
     Timestamp ocppSelect = ocppTimeReference;
-    auto& ocppNow = model.getTime().getTimestampNow();
+    auto& ocppNow = model.getClock().now();
     if (ocppNow > ocppTimeReference) {
         //time has already been set
         ocppSelect = ocppNow;
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
index 6c20af19..ab8bbe38 100644
--- a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
@@ -60,7 +60,7 @@ void TriggerMessage::processReq(JsonObject payload) {
             auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
                         i,
                         connector->inferenceStatus(), //will be determined in StatusNotification::initiate
-                        model.getTime().getTimestampNow()));
+                        model.getClock().now()));
 
             statusNotification->setTimeout(60000);
 
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
index 4b594c4f..cc3395b7 100644
--- a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
@@ -150,7 +150,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     }
 
     if (localStatus == AuthorizationStatus::Accepted && localInfo->getExpiryDate()) { //check for expiry
-        auto& t_now = context.getModel().getTime().getTimestampNow();
+        auto& t_now = context.getModel().getClock().now();
         if (t_now > *localInfo->getExpiryDate()) {
             AO_DBG_DEBUG("local auth expired");
             localStatus = AuthorizationStatus::Expired;
@@ -184,7 +184,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
         auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
                     0,
                     cpStatus, //will be determined in StatusNotification::initiate
-                    context.getModel().getTime().getTimestampNow(),
+                    context.getModel().getClock().now(),
                     "LocalListConflict"));
 
         statusNotification->setTimeout(60000);
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index e2c18a8d..1239c7d7 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -194,7 +194,7 @@ void Connector::loop() {
                 !transaction->getStartRpcSync().isRequested() &&
                 transaction->getSessionTimestamp() > MIN_TIME &&
                 connectionTimeOut && *connectionTimeOut > 0 &&
-                model.getTime().getTimestampNow() - transaction->getSessionTimestamp() >= (otime_t) *connectionTimeOut) {
+                model.getClock().now() - transaction->getSessionTimestamp() >= *connectionTimeOut) {
                 
             AO_DBG_INFO("Session mngt: timeout");
             transaction->endSession();
@@ -238,7 +238,7 @@ void Connector::loop() {
                 }
 
                 if (transaction->getStartTimestamp() <= MIN_TIME) {
-                    transaction->setStartTimestamp(model.getTime().getTimestampNow());
+                    transaction->setStartTimestamp(model.getClock().now());
                 }
 
                 if (transaction->isSilent()) {
@@ -293,7 +293,7 @@ void Connector::loop() {
                 }
 
                 if (transaction->getStopTimestamp() <= MIN_TIME) {
-                    transaction->setStopTimestamp(model.getTime().getTimestampNow());
+                    transaction->setStopTimestamp(model.getClock().now());
                 }
 
                 transaction->commit();
@@ -346,11 +346,11 @@ void Connector::loop() {
     }
 
     if (reportedStatus != currentStatus &&
-            model.getTime().getTimestampNow() >= Timestamp(2010,0,0,0,0,0) &&
+            model.getClock().now() >= Timestamp(2010,0,0,0,0,0) &&
             (*minimumStatusDuration <= 0 || //MinimumStatusDuration disabled
             ao_tick_ms() - t_statusTransition >= ((unsigned long) *minimumStatusDuration) * 1000UL)) {
         reportedStatus = currentStatus;
-        Timestamp reportedTimestamp = model.getTime().getTimestampNow();
+        Timestamp reportedTimestamp = model.getClock().now();
         reportedTimestamp -= (ao_tick_ms() - t_statusTransition) / 1000UL;
 
         auto statusNotification = makeRequest(
@@ -511,7 +511,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         //check expiry
         if (localAuth && localAuth->getExpiryDate()) {
-            auto& tnow = model.getTime().getTimestampNow();
+            auto& tnow = model.getClock().now();
             if (tnow >= *localAuth->getExpiryDate()) {
                 AO_DBG_DEBUG("idTag %s local auth entry expired", idTag);
                 localAuth = nullptr;
@@ -534,7 +534,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         transaction->setIdTag(idTag);
     }
 
-    transaction->setSessionTimestamp(model.getTime().getTimestampNow());
+    transaction->setSessionTimestamp(model.getClock().now());
 
     AO_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
 
@@ -652,7 +652,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
         transaction->setIdTag(idTag);
     }
 
-    transaction->setSessionTimestamp(model.getTime().getTimestampNow());
+    transaction->setSessionTimestamp(model.getClock().now());
     
     AO_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
 
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
index 4a32eb92..fb51b9af 100644
--- a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
+++ b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
@@ -40,7 +40,7 @@ void DiagnosticsService::loop() {
         context.initiateRequest(std::move(notification));
     }
 
-    const auto& timestampNow = context.getModel().getTime().getTimestampNow();
+    const auto& timestampNow = context.getModel().getClock().now();
     if (retries > 0 && timestampNow >= nextTry) {
 
         if (!uploadIssued) {
@@ -105,7 +105,7 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
     if (stopTime >= stopMin) {
         this->stopTime = stopTime;
     } else {
-        auto newStop = context.getModel().getTime().getTimestampNow();
+        auto newStop = context.getModel().getClock().now();
         newStop += 3600 * 24 * 365; //set new stop time one year in future
         this->stopTime = newStop;
     }
@@ -127,7 +127,7 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
             dbuf,
             dbuf2);
 
-    nextTry = context.getModel().getTime().getTimestampNow();
+    nextTry = context.getModel().getClock().now();
     nextTry += 5; //wait for 5s before upload
     uploadIssued = false;
 
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index 0e9ce508..d37752b4 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -56,7 +56,7 @@ void FirmwareService::loop() {
         return;
     }
 
-    Timestamp timestampNow = context.getModel().getTime().getTimestampNow();
+    Timestamp timestampNow = context.getModel().getClock().now();
     if (retries > 0 && timestampNow >= retreiveDate) {
 
         //if (!downloadIssued) {
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 57dab5b8..b8b7e0b9 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -144,7 +144,7 @@ Operation *ConnectorMeterValuesRecorder::loop() {
 
     if (*ClockAlignedDataInterval >= 1) {
 
-        auto& timestampNow = context.getTime().getTimestampNow();
+        auto& timestampNow = context.getClock().now();
         auto dt = nextAlignedTime - timestampNow;
         if (dt <= 0 ||                              //normal case: interval elapsed
                 dt > *ClockAlignedDataInterval) {   //special case: clock has been adjusted or first run
@@ -153,13 +153,13 @@ Operation *ConnectorMeterValuesRecorder::loop() {
                 abs(dt) <= 60 ?
                 "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
-                auto alignedMeterValues = alignedDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::SampleClock);
+                auto alignedMeterValues = alignedDataBuilder->takeSample(context.getClock().now(), ReadingContext::SampleClock);
                 if (alignedMeterValues) {
                     meterData.push_back(std::move(alignedMeterValues));
                 }
 
                 if (stopTxnData) {
-                    auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::SampleClock);
+                    auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(context.getClock().now(), ReadingContext::SampleClock);
                     if (alignedStopTx) {
                         stopTxnData->addTxData(std::move(alignedStopTx));
                     }
@@ -187,13 +187,13 @@ Operation *ConnectorMeterValuesRecorder::loop() {
         //record periodic tx data
 
         if (ao_tick_ms() - lastSampleTime >= (unsigned long) (*MeterValueSampleInterval * 1000)) {
-            auto sampleMeterValues = sampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::SamplePeriodic);
+            auto sampleMeterValues = sampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::SamplePeriodic);
             if (sampleMeterValues) {
                 meterData.push_back(std::move(sampleMeterValues));
             }
 
             if (stopTxnData && StopTxnDataCapturePeriodic && *StopTxnDataCapturePeriodic) {
-                auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::SamplePeriodic);
+                auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::SamplePeriodic);
                 if (sampleStopTx) {
                     stopTxnData->addTxData(std::move(sampleStopTx));
                 }
@@ -211,7 +211,7 @@ Operation *ConnectorMeterValuesRecorder::loop() {
 
 Operation *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
 
-    auto sample = sampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::Trigger);
+    auto sample = sampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::Trigger);
 
     if (!sample) {
         return nullptr;
@@ -258,7 +258,7 @@ void ConnectorMeterValuesRecorder::beginTxMeterData(Transaction *transaction) {
     }
 
     if (stopTxnData) {
-        auto sampleTxBegin = stopTxnSampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::TransactionBegin);
+        auto sampleTxBegin = stopTxnSampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::TransactionBegin);
         if (sampleTxBegin) {
             stopTxnData->addTxData(std::move(sampleTxBegin));
         }
@@ -271,7 +271,7 @@ std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::endTxMeterDa
     }
 
     if (stopTxnData) {
-        auto sampleTxEnd = stopTxnSampledDataBuilder->takeSample(context.getTime().getTimestampNow(), ReadingContext::TransactionEnd);
+        auto sampleTxEnd = stopTxnSampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::TransactionEnd);
         if (sampleTxEnd) {
             stopTxnData->addTxData(std::move(sampleTxEnd));
         }
diff --git a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
index 53ebc079..09b6f349 100644
--- a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
+++ b/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
@@ -44,7 +44,7 @@ bool Reservation::isActive() {
         return false;
     }
 
-    auto& t_now = model.getTime().getTimestampNow();
+    auto& t_now = model.getClock().now();
     if (t_now > expiryDate) {
         //reservation expired
         return false;
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
index dcc02435..f4a1fc5b 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
@@ -94,8 +94,8 @@ void SmartChargingService::loop(){
     /**
      * check if to call onLimitChange
      */
-    if (context.getModel().getTime().getTimestampNow() >= nextChange){
-        auto& tNow = context.getModel().getTime().getTimestampNow();
+    if (context.getModel().getClock().now() >= nextChange){
+        auto& tNow = context.getModel().getClock().now();
         float limit = -1.0f;
         Timestamp validTo = Timestamp();
         inferenceLimit(tNow, &limit, &validTo);
@@ -122,7 +122,7 @@ void SmartChargingService::loop(){
 float SmartChargingService::inferenceLimitNow(){
     float limit = 0.0f;
     Timestamp validTo = Timestamp(); //not needed
-    auto& tNow = context.getModel().getTime().getTimestampNow();
+    auto& tNow = context.getModel().getClock().now();
     inferenceLimit(tNow, &limit, &validTo);
     return limit;
 }
@@ -227,8 +227,8 @@ void SmartChargingService::inferenceLimit(const Timestamp &t, float *limitOutPar
     }
 }
 
-ChargingSchedule *SmartChargingService::getCompositeSchedule(int connectorId, otime_t duration){
-    auto& startSchedule = context.getModel().getTime().getTimestampNow();
+ChargingSchedule *SmartChargingService::getCompositeSchedule(int connectorId, int duration){
+    auto& startSchedule = context.getModel().getClock().now();
     ChargingSchedule *result = new ChargingSchedule(startSchedule, duration);
     Timestamp periodBegin = Timestamp(startSchedule);
     Timestamp periodStop = Timestamp(startSchedule);
@@ -273,7 +273,7 @@ void SmartChargingService::refreshChargingSessionState() {
 
         bool txStartUpdated = false;
         if (chargingSessionTransactionID != 0 && connector->getTransactionId() >= 0) {
-            chargingSessionStart = context.getModel().getTime().getTimestampNow();
+            chargingSessionStart = context.getModel().getClock().now();
             txStartUpdated = true;
         } else if (chargingSessionTransactionID >= 0 && connector->getTransactionId() < 0) {
             chargingSessionStart = MAX_TIME;
@@ -287,7 +287,7 @@ void SmartChargingService::refreshChargingSessionState() {
             configuration_save();
         }
 
-        nextChange = context.getModel().getTime().getTimestampNow();
+        nextChange = context.getModel().getClock().now();
     }
   
     if (*sRmtProfileId >= 0 && //Remote profile set? Check if to delete
@@ -357,7 +357,7 @@ ChargingProfile *SmartChargingService::updateProfileStack(JsonObject json){
      * Invalidate the last limit inference by setting the nextChange to now. By the next loop()-call, the limit
      * and nextChange will be recalculated and onLimitChanged will be called.
      */
-    nextChange = context.getModel().getTime().getTimestampNow();
+    nextChange = context.getModel().getClock().now();
 
     return chargingProfile;
 }
@@ -412,7 +412,7 @@ bool SmartChargingService::clearChargingProfile(const std::function<bool(int, in
      * Invalidate the last limit inference by setting the nextChange to now. By the next loop()-call, the limit
      * and nextChange will be recalculated and onLimitChanged will be called.
      */
-    nextChange = context.getModel().getTime().getTimestampNow();
+    nextChange = context.getModel().getClock().now();
 
     return nMatches > 0;
 }
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
index 1a6babaa..e7390654 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
@@ -56,7 +56,7 @@ class SmartChargingService {
     void inferenceLimit(const Timestamp &t, float *limit, Timestamp *validTo);
     float inferenceLimitNow();
     void setOnLimitChange(OnLimitChange onLimitChange);
-    ChargingSchedule *getCompositeSchedule(int connectorId, otime_t duration);
+    ChargingSchedule *getCompositeSchedule(int connectorId, int duration);
     void loop();
 };
 

From 96dbb07f0e18112d071ef649ea7e30617d240ae9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 31 May 2023 21:58:44 +0200
Subject: [PATCH 259/549] tidy up Transaction entity

---
 CMakeLists.txt                                |   1 +
 src/ArduinoOcpp.cpp                           |  61 ++---
 src/ArduinoOcpp.h                             |  29 ++-
 .../MessagesV16/StartTransaction.cpp          |   6 +-
 .../MessagesV16/StopTransaction.cpp           |   8 +-
 .../Tasks/ChargeControl/Connector.cpp         |  36 +--
 .../Tasks/Transactions/Transaction.cpp        | 218 +----------------
 .../Tasks/Transactions/Transaction.h          | 204 +++++++---------
 .../Transactions/TransactionDeserialize.cpp   | 227 ++++++++++++++++++
 .../Transactions/TransactionDeserialize.h     |  19 ++
 .../Tasks/Transactions/TransactionStore.cpp   |   5 +-
 src/ArduinoOcpp_c.cpp                         |   8 +-
 tests/ChargingSessions.cpp                    |   2 +-
 13 files changed, 422 insertions(+), 402 deletions(-)
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.cpp
 create mode 100644 src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 9bb39ca7..8ca398fe 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -72,6 +72,7 @@ set(AO_SRC
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
     src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
     src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+    src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.cpp
     src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
     src/ArduinoOcpp.cpp
     src/ArduinoOcpp_c.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index e8bd1391..b19edd12 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -56,7 +56,7 @@ using namespace ArduinoOcpp::Facade;
 using namespace ArduinoOcpp::Ocpp16;
 
 #ifndef AO_CUSTOM_WS
-void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
+void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, float V_eff, FilesystemOpt fsOpt) {
     if (context) {
         AO_DBG_WARN("Can't be called two times. Either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -118,7 +118,7 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
     }
 }
 
-void OCPP_initialize(Connection& connection, const char *bootNotificationCredentials, float V_eff, ArduinoOcpp::FilesystemOpt fsOpt) {
+void OCPP_initialize(Connection& connection, const char *bootNotificationCredentials, float V_eff, FilesystemOpt fsOpt) {
     if (context) {
         AO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -276,41 +276,41 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
     context->initiateRequest(std::move(authorize));
 }
 
-bool beginTransaction(const char *idTag, unsigned int connectorId) {
+std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return false;
+        return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
         AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
-        return false;
+        return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
-        return false;
+        return nullptr;
     }
-    connector->beginTransaction(idTag);
-    return true;
+
+    return connector->beginTransaction(idTag);
 }
 
-bool beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
+std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return false;
+        return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX ||
         (parentIdTag && strnlen(parentIdTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX)) {
         AO_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
-        return false;
+        return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
-        return false;
+        return nullptr;
     }
-    connector->beginTransaction_authorized(idTag, parentIdTag);
-    return true;
+    
+    return connector->beginTransaction_authorized(idTag, parentIdTag);
 }
 
 bool endTransaction(const char *reason, unsigned int connectorId) {
@@ -500,10 +500,10 @@ void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measur
     if (phase)
         properties.setPhase(phase);
 
-    auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
-                                    new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
+    auto valueSampler = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
+                                    new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
                 properties,
-                [valueInput] (ArduinoOcpp::ReadingContext) -> int32_t {return valueInput();}));
+                [valueInput] (ReadingContext) -> int32_t {return valueInput();}));
     addMeterValueInput(std::move(valueSampler), connectorId);
 }
 
@@ -610,30 +610,19 @@ bool isOperative(unsigned int connectorId) {
        &&  (connector->getAvailability() != AVAILABILITY_INOPERATIVE);
 }
 
-int getTransactionId(unsigned int connectorId) {
-    if (!context) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
-        return -1;
-    }
-    auto connector = context->getModel().getConnector(connectorId);
-    if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return -1;
-    }
-    return connector->getTransactionId();
-}
+std::shared_ptr<Transaction> ao_undefinedTx;
 
-const char *getTransactionIdTag(unsigned int connectorId) {
+std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
     if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
-        return nullptr;
+        return ao_undefinedTx;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
-        return nullptr;
+        return ao_undefinedTx;
     }
-    return connector->getSessionIdTag();
+    return connector->getTransaction();
 }
 
 bool isBlockedByReservation(const char *idTag, unsigned int connectorId) {
@@ -658,14 +647,14 @@ bool isBlockedByReservation(const char *idTag, unsigned int connectorId) {
 }
 
 #if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
-ArduinoOcpp::FirmwareService *getFirmwareService() {
+FirmwareService *getFirmwareService() {
     auto& model = context->getModel();
     return model.getFirmwareService();
 }
 #endif
 
 #if defined(AO_CUSTOM_DIAGNOSTICS) || defined(AO_CUSTOM_WS)
-ArduinoOcpp::DiagnosticsService *getDiagnosticsService() {
+DiagnosticsService *getDiagnosticsService() {
     auto& model = context->getModel();
     return model.getDiagnosticsService();
 }
@@ -746,7 +735,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
     }
     auto transaction = connector->getTransaction();
     if (transaction) {
-        if (transaction->getStartRpcSync().isRequested()) {
+        if (transaction->getStartSync().isRequested()) {
             AO_DBG_ERR("Transaction already in progress. Must call stopTransaction()");
             return false;
         }
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index e645f0b3..3cc9b6f0 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -14,6 +14,7 @@
 #include <ArduinoOcpp/Core/Connection.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
 using ArduinoOcpp::OnReceiveReqListener;
@@ -168,16 +169,16 @@ void authorize(
  * 
  * See beginTransaction_authorized for skipping steps 1) to 3)
  * 
- * Returns true if it was possible to create the transaction process. If it returned false, either
- * another transaction process is still active or you need to try it again later.
+ * Returns the transaction object if it was possible to create the transaction process. Returns
+ * nullptr if either another transaction process is still active or you need to try it again later.
  */
-bool beginTransaction(const char *idTag, unsigned int connectorId = 1);
+std::shared_ptr<ArduinoOcpp::Transaction> beginTransaction(const char *idTag, unsigned int connectorId = 1);
 
 /*
  * Begin the transaction process and skip the OCPP-side authorization. See beginTransaction(...) for a
  * complete description
  */
-bool beginTransaction_authorized(const char *idTag, const char *parentIdTag = nullptr, unsigned int connectorId = 1);
+std::shared_ptr<ArduinoOcpp::Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag = nullptr, unsigned int connectorId = 1);
 
 /*
  * End the transaction process by terminating the transaction and setting a reason for its termination.
@@ -274,14 +275,23 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId =
 
 bool isOperative(unsigned int connectorId = 1); //if the charge point is operative or inoperative (see OCPP1.6 Edit2, p. 45)
 
-int getTransactionId(unsigned int connectorId = 1); //returns the txId if known, -1 if no transaction is running and 0 if txId not assigned yet
-
-const char *getTransactionIdTag(unsigned int connectorId = 1); //returns the authorization token if applicable, or nullptr otherwise
+/*
+ * Returns the current transaction process. Returns nullptr if no transaction is running, preparing or finishing
+ *
+ * See the class definition in ArduinoOcpp/Tasks/Transactions/Transaction.h for possible uses of this object
+ * 
+ * Examples:
+ * auto tx = getTransaction(); //fetch tx object
+ * if (tx) { //check if tx object exists
+ *     bool active = tx->isActive(); //active tells if the transaction is preparing or continuing to run
+ *     int transactionId = tx->getTransactionId(); //the transactionId as assigned by the OCPP server
+ *     bool deauthorized = tx->isIdTagDeauthorized(); //if StartTransaction has been rejected
+ * }
+ */
+std::shared_ptr<ArduinoOcpp::Transaction>& getTransaction(unsigned int connectorId = 1);
 
 bool isBlockedByReservation(const char *idTag, unsigned int connectorId = 1); //if the connector is already reserved for a different idTag
 
-void setOnResetRequest(OnReceiveReqListener onReceiveReq);
-
 /*
  * Configure the device management
  */
@@ -329,6 +339,7 @@ void setOnRemoteStopTransactionSendConf(OnSendConfListener onSendConf);
 void setOnRemoteStopTransactionReceiveReq(OnReceiveReqListener onReceiveReq);
 
 void setOnResetSendConf(OnSendConfListener onSendConf);
+void setOnResetRequest(OnReceiveReqListener onReceiveReq);
 
 bool startTransaction(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, unsigned int timeout = 0);
 
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
index 82998114..d75c7f3e 100644
--- a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
@@ -27,7 +27,7 @@ const char* StartTransaction::getOperationType() {
 }
 
 void StartTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!transaction || transaction->getStartRpcSync().isRequested()) {
+    if (!transaction || transaction->getStartSync().isRequested()) {
         AO_DBG_ERR("initialization error");
         return;
     }
@@ -41,7 +41,7 @@ void StartTransaction::initiate(StoredOperationHandler *opStore) {
         opStore->commit();
     }
 
-    transaction->getStartRpcSync().setRequested();
+    transaction->getStartSync().setRequested();
 
     transaction->commit();
 
@@ -133,7 +133,7 @@ void StartTransaction::processConf(JsonObject payload) {
     int transactionId = payload["transactionId"] | -1;
     transaction->setTransactionId(transactionId);
 
-    transaction->getStartRpcSync().confirm();
+    transaction->getStartSync().confirm();
     transaction->commit();
 
     if (auto authService = model.getAuthorizationService()) {
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
index 0cd87e0d..5a73dbf7 100644
--- a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
@@ -29,7 +29,7 @@ const char* StopTransaction::getOperationType() {
 }
 
 void StopTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!transaction || transaction->getStopRpcSync().isRequested()) {
+    if (!transaction || transaction->getStopSync().isRequested()) {
         AO_DBG_ERR("initialization error");
         return;
     }
@@ -43,7 +43,7 @@ void StopTransaction::initiate(StoredOperationHandler *opStore) {
         opStore->commit();
     }
 
-    transaction->getStopRpcSync().setRequested();
+    transaction->getStopSync().setRequested();
 
     transaction->commit();
 
@@ -152,7 +152,7 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 void StopTransaction::processConf(JsonObject payload) {
 
     if (transaction) {
-        transaction->getStopRpcSync().confirm();
+        transaction->getStopSync().confirm();
         transaction->commit();
     }
 
@@ -166,7 +166,7 @@ void StopTransaction::processConf(JsonObject payload) {
 bool StopTransaction::processErr(const char *code, const char *description, JsonObject details) {
 
     if (transaction) {
-        transaction->getStopRpcSync().confirm(); //no retry behavior for now; consider data "arrived" at server
+        transaction->getStopSync().confirm(); //no retry behavior for now; consider data "arrived" at server
         transaction->commit();
     }
 
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index 1239c7d7..712ae010 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -184,20 +184,20 @@ void Connector::loop() {
                 if (!stopTransactionOnEVSideDisconnect || *stopTransactionOnEVSideDisconnect) {
                     AO_DBG_DEBUG("Stop Tx due to EV disconnect");
                     transaction->setStopReason("EVDisconnected");
-                    transaction->endSession();
+                    transaction->setInactive();
                     transaction->commit();
                 }
             }
         }
 
         if (transaction->isActive() &&
-                !transaction->getStartRpcSync().isRequested() &&
-                transaction->getSessionTimestamp() > MIN_TIME &&
+                !transaction->getStartSync().isRequested() &&
+                transaction->getBeginTimestamp() > MIN_TIME &&
                 connectionTimeOut && *connectionTimeOut > 0 &&
-                model.getClock().now() - transaction->getSessionTimestamp() >= *connectionTimeOut) {
+                model.getClock().now() - transaction->getBeginTimestamp() >= *connectionTimeOut) {
                 
             AO_DBG_INFO("Session mngt: timeout");
-            transaction->endSession();
+            transaction->setInactive();
             transaction->commit();
         }
 
@@ -208,7 +208,7 @@ void Connector::loop() {
             
             AO_DBG_DEBUG("DeAuthorize session");
             transaction->setStopReason("DeAuthorized");
-            transaction->endSession();
+            transaction->setInactive();
             transaction->commit();
         }
 
@@ -243,8 +243,8 @@ void Connector::loop() {
 
                 if (transaction->isSilent()) {
                     AO_DBG_INFO("silent Transaction: omit StartTx");
-                    transaction->getStartRpcSync().setRequested();
-                    transaction->getStartRpcSync().confirm();
+                    transaction->getStartSync().setRequested();
+                    transaction->getStartSync().confirm();
                     transaction->commit();
                     return;
                 }
@@ -271,8 +271,8 @@ void Connector::loop() {
 
                 if (transaction->isSilent()) {
                     AO_DBG_INFO("silent Transaction: omit StopTx");
-                    transaction->getStopRpcSync().setRequested();
-                    transaction->getStopRpcSync().confirm();
+                    transaction->getStopSync().setRequested();
+                    transaction->getStopSync().confirm();
                     if (auto mService = model.getMeteringService()) {
                         mService->removeTxMeterData(connectorId, transaction->getTxNr());
                     }
@@ -534,7 +534,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         transaction->setIdTag(idTag);
     }
 
-    transaction->setSessionTimestamp(model.getClock().now());
+    transaction->setBeginTimestamp(model.getClock().now());
 
     AO_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
 
@@ -573,7 +573,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                         idTagInfo["parentIdTag"] | (const char*) nullptr)) {
                 //reservation found for connector but does not match idTag or parentIdTag
                 AO_DBG_INFO("connector %u reserved - abort transaction", connectorId);
-                tx->endSession();
+                tx->setInactive();
                 tx->commit();
                 return;
             }
@@ -588,7 +588,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         if (expiredLocalAuth) {
             //local auth entry exists, but is expired -> avoid offline tx
             AO_DBG_DEBUG("Abort transaction process (%s), timeout, expired local auth", tx->getIdTag());
-            tx->endSession();
+            tx->setInactive();
             tx->commit();
             return;
         }
@@ -608,7 +608,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                         tx->getIdTag())) {
                 //reservation found for connector but does not match idTag or parentIdTag
                 AO_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
-                tx->endSession();
+                tx->setInactive();
                 tx->commit();
                 return;
             }
@@ -622,7 +622,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         }
         
         AO_DBG_DEBUG("Abort transaction process (%s): timeout", tx->getIdTag());
-        tx->endSession();
+        tx->setInactive();
         tx->commit();
         return; //offline tx disabled
     });
@@ -652,7 +652,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
         transaction->setIdTag(idTag);
     }
 
-    transaction->setSessionTimestamp(model.getClock().now());
+    transaction->setBeginTimestamp(model.getClock().now());
     
     AO_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
 
@@ -686,7 +686,7 @@ void Connector::endTransaction(const char *reason) {
         if (reason) {
             transaction->setStopReason(reason);
         }
-        transaction->endSession();
+        transaction->setInactive();
         transaction->commit();
     }
 }
@@ -719,7 +719,7 @@ int Connector::getTransactionId() {
     }
 
     if (transaction->isRunning()) {
-        if (transaction->getStartRpcSync().isConfirmed()) {
+        if (transaction->getStartSync().isConfirmed()) {
             return transaction->getTransactionId();
         } else {
             return 0;
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
index 3cb7da73..c5ef958a 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
@@ -5,221 +5,21 @@
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 
-#include <ArduinoOcpp/Debug.h>
-
 using namespace ArduinoOcpp;
 
-bool RpcSync::serializeSessionState(JsonObject rpc) {
-    rpc["requested"] = requested;
-    rpc["confirmed"] = confirmed;
-    return true;
+bool Transaction::setIdTag(const char *idTag) {
+    auto ret = snprintf(this->idTag, IDTAG_LEN_MAX + 1, "%s", idTag);
+    return ret >= 0 && ret < IDTAG_LEN_MAX + 1;
 }
 
-bool Transaction::serializeSessionState(DynamicJsonDocument& out) {
-    out = DynamicJsonDocument(1024);
-    JsonObject state = out.to<JsonObject>();
-
-    JsonObject sessionState = state.createNestedObject("session");
-    if (session.idTag[0] != '\0') {
-        sessionState["idTag"] = session.idTag;
-    }
-    if (session.authorized) {
-        sessionState["authorized"] = session.authorized;
-    }
-    if (session.deauthorized) {
-        sessionState["deauthorized"] = session.deauthorized;
-    }
-    if (session.timestamp > MIN_TIME) {
-        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
-        session.timestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
-        sessionState["timestamp"] = timeStr;
-    }
-    if (session.txProfileId >= 0) {
-        sessionState["txProfileId"] = session.txProfileId;
-    }
-    if (!session.active) {
-        sessionState["active"] = session.active;
-    }
-
-    JsonObject txStart = state.createNestedObject("start");
-
-    JsonObject txStartRPC = txStart.createNestedObject("rpc");
-    if (!start.rpc.serializeSessionState(txStartRPC)) {
-        return false;
-    }
-
-    JsonObject txStartClientSide = txStart.createNestedObject("client");
-
-    if (start.client.timestamp > MIN_TIME) {
-        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
-        start.client.timestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
-        txStartClientSide["timestamp"] = timeStr;
-    }
-
-    if (start.client.meter >= 0) {
-        txStartClientSide["meter"] = start.client.meter;
-    }
-
-    if (start.client.reservationId >= 0) {
-        txStartClientSide["reservationId"] = start.client.reservationId;
-    }
-
-
-    if (start.rpc.confirmed) {
-        JsonObject txStartServerSide = txStart.createNestedObject("server");
-        txStartServerSide["transactionId"] = start.server.transactionId;
-    }
-
-    JsonObject txStop = state.createNestedObject("stop");
-
-    JsonObject txStopRPC = txStop.createNestedObject("rpc");
-    if (!stop.rpc.serializeSessionState(txStopRPC)) {
-        return false;
-    }
-
-    JsonObject txStopClientSide = txStop.createNestedObject("client");
-
-    if (stop.client.timestamp > MIN_TIME) {
-        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
-        stop.client.timestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
-        txStopClientSide["timestamp"] = timeStr;
-    }
-
-    if (stop.client.meter >= 0) {
-        txStopClientSide["meter"] = stop.client.meter;
-    }
-
-    if (stop.client.idTag[0] != '\0') {
-        txStopClientSide["idTag"] = stop.client.idTag;
-    }
-
-    if (stop.client.reason[0] != '\0') {
-        txStopClientSide["reason"] = stop.client.reason;
-    }
-
-    if (silent) {
-        state["silent"] = true;
-    }
-
-    if (out.overflowed()) {
-        AO_DBG_ERR("JSON capacity exceeded");
-        return false;
-    }
-
-    return true;
+bool Transaction::setStopIdTag(const char *idTag) {
+    auto ret = snprintf(stop_idTag, IDTAG_LEN_MAX + 1, "%s", idTag);
+    return ret >= 0 && ret < IDTAG_LEN_MAX + 1;
 }
 
-bool RpcSync::deserializeSessionState(JsonObject rpc) {
-    if (rpc["requested"] | false) {
-        requested = true;
-    }
-    if (rpc["confirmed"] | false) {
-        confirmed = true;
-    }
-    return true;
-}
-
-bool Transaction::deserializeSessionState(JsonObject state) {
-
-    JsonObject sessionState = state["session"];
-
-    if (sessionState.containsKey("idTag")) {
-        if (snprintf(session.idTag, sizeof(session.idTag), "%s", sessionState["idTag"] | "") < 0) {
-            AO_DBG_ERR("Read err");
-            return false;
-        }
-    }
-    if (sessionState.containsKey("authorized")) {
-        session.authorized = sessionState["authorized"] | false;
-    }
-    if (sessionState.containsKey("deauthorized")) {
-        session.deauthorized = sessionState["deauthorized"] | false;
-    }
-    if (sessionState.containsKey("timestamp")) {
-        session.timestamp.setTime(sessionState["timestamp"] | "Invalid");
-    }
-    if (sessionState.containsKey("txProfileId")) {
-        session.txProfileId = sessionState["txProfileId"] | -1;
-    }
-    if (sessionState.containsKey("active")) {
-        session.active = sessionState["active"] | true;
-    }
-
-    JsonObject txStart = state["start"];
-
-    if (txStart.containsKey("rpc")) {
-        JsonObject txStartRPC = txStart["rpc"];
-        if (!start.rpc.deserializeSessionState(txStartRPC)) {
-            return false;
-        }
-    }
-
-    JsonObject txStartClientSide = txStart["client"];
-
-    if (txStartClientSide.containsKey("timestamp")) {
-        start.client.timestamp.setTime(txStartClientSide["timestamp"] | "Invalid");
-    }
-
-    if (txStartClientSide.containsKey("meter")) {
-        start.client.meter = txStartClientSide["meter"] | 0;
-    }
-
-    if (txStartClientSide.containsKey("reservationId")) {
-        start.client.reservationId = txStartClientSide["reservationId"] | -1;
-    }
-
-    if (start.rpc.confirmed) {
-        JsonObject txStartServerSide = txStart["server"];
-        start.server.transactionId = txStartServerSide["transactionId"] | -1;
-    }
-
-    JsonObject txStop = state["stop"];
-
-    if (txStop.containsKey("rpc")) {
-        JsonObject txStopRPC = txStop["rpc"];
-        if (!stop.rpc.deserializeSessionState(txStopRPC)) {
-            return false;
-        }
-    }
-
-    JsonObject txStopClientSide = txStop["client"];
-
-    if (txStopClientSide.containsKey("timestamp")) {
-        stop.client.timestamp.setTime(txStopClientSide["timestamp"] | "Invalid");
-    }
-
-    if (txStopClientSide.containsKey("meter")) {
-        stop.client.meter = txStopClientSide["meter"] | 0;
-    }
-
-    if (txStopClientSide.containsKey("idTag")) {
-        if (snprintf(stop.client.idTag, sizeof(stop.client.idTag), "%s", txStopClientSide["idTag"] | "") < 0) {
-            AO_DBG_ERR("Read err");
-            return false;
-        }
-    }
-
-    if (txStopClientSide.containsKey("reason")) {
-        if (snprintf(stop.client.reason, sizeof(stop.client.reason), "%s", txStopClientSide["reason"] | "") < 0) {
-            AO_DBG_ERR("Read err");
-            return false;
-        }
-    }
-
-    if (state.containsKey("silent")) {
-        silent = state["silent"] | false;
-    }
-
-    AO_DBG_DEBUG("DUMP TX");
-    AO_DBG_DEBUG("Session   | idTag %s, active: %i, authorized: %i, deauthorized: %i", session.idTag, session.active, session.authorized, session.deauthorized);
-    AO_DBG_DEBUG("Start RPC | req: %i, conf: %i", start.rpc.requested, start.rpc.confirmed);
-    AO_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  stop.rpc.requested, stop.rpc.confirmed);
-    if (silent) {
-        AO_DBG_DEBUG("          | silent Tx");
-        (void)0;
-    }
-
-    return true;
+bool Transaction::setStopReason(const char *reason) {
+    auto ret = snprintf(stop_reason, REASON_LEN_MAX + 1, "%s", reason);
+    return ret >= 0 && ret < REASON_LEN_MAX + 1;
 }
 
 bool Transaction::commit() {
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index 75f9b760..13feb8b7 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -7,8 +7,6 @@
 
 #include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/MessagesV16/CiStrings.h>
-#include <memory>
-#include <ArduinoJson.h>
 
 namespace ArduinoOcpp {
 
@@ -17,105 +15,63 @@ namespace ArduinoOcpp {
  * The client side of a transaction is all data that is generated or collected at the charging station. The
  * server side is all transaction data that is assigned by the central system.
  * 
- * "ClientTransaction" is short for the client-side data, and the same goes for "ServerTranaction". The rest
- * of the terminology is documented in OCPP 1.6 Specification - Edition 2, sections 3.6, 4.8, 4.10 and 5.11. 
+ * See OCPP 1.6 Specification - Edition 2, sections 3.6, 4.8, 4.10 and 5.11. 
  */
 
 class ConnectorTransactionStore;
 
-class RpcSync {
+class SendStatus {
 private:
-    friend class Transaction;
-    
     bool requested = false;
     bool confirmed = false;
-
-    bool serializeSessionState(JsonObject out);
-    bool deserializeSessionState(JsonObject in);
 public:
     void setRequested() {this->requested = true;}
     bool isRequested() {return requested;}
     void confirm() {confirmed = true;}
     bool isConfirmed() {return confirmed;}
-    bool isCompleted() {return isRequested() && isConfirmed();}
-};
-
-class ClientTransactionStart {
-private:
-    friend class Transaction;
-
-    Timestamp timestamp = MIN_TIME;      //timestamp of StartTx; can be set before actually initiating
-    int32_t meter = -1;           //meterStart of StartTx
-    int reservationId = -1;
-};
-
-class ServerTransactionStart {
-private:
-    friend class Transaction;
-
-    int transactionId = -1; //only valid if confirmed = true
 };
 
-class TransactionStart {
-private:
-    friend class Transaction;
-    
-    RpcSync rpc;
-    ClientTransactionStart client;
-    ServerTransactionStart server;
-};
-
-class ClientTransactionStop {
-private:
-    friend class Transaction;
-
-    char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
-    Timestamp timestamp = MIN_TIME;
-    int32_t meter = -1;
-    char reason [REASON_LEN_MAX + 1] = {'\0'};
-};
-
-class ServerTransactionStop {
-//no data at the moment
-};
-
-class TransactionStop {
+class Transaction {
 private:
-    friend class Transaction;
+    ConnectorTransactionStore& context;
 
-    RpcSync rpc;
-    ClientTransactionStop client;
-    ServerTransactionStop server;
-};
+    bool active = true; //once active is false, the tx must stop (or cannot start at all)
 
-class ChargingSession {
-private:
-    friend class Transaction;
-    
+    /*
+     * Attributes existing before StartTransaction
+     */
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
     bool authorized = false;    //if the given idTag was authorized
     bool deauthorized = false;  //if the server revoked a local authorization
-    Timestamp timestamp = MIN_TIME;
+    Timestamp begin_timestamp = MIN_TIME;
+    int reservationId = -1;
     int txProfileId = -1;
 
-    bool active = true;         //true: ignore
-                                //false before StartTx init: abort 
-                                //false between StartTx init and StopTx init: end
-                                //false after StopTx init: ignore
-};
-
-class Transaction {
-private:
-    ConnectorTransactionStore& context;
-
-    ChargingSession session;
-    TransactionStart start;
-    TransactionStop stop;
+    /*
+     * Attributes of StartTransaction
+     */
+    SendStatus start_sync;
+    int32_t start_meter = -1;           //meterStart of StartTx
+    Timestamp start_timestamp = MIN_TIME;      //timestamp of StartTx; can be set before actually initiating
+    int transactionId = -1; //only valid if confirmed = true
 
+    /*
+     * Attributes of StopTransaction
+     */
+    SendStatus stop_sync;
+    char stop_idTag [IDTAG_LEN_MAX + 1] = {'\0'};
+    int32_t stop_meter = -1;
+    Timestamp stop_timestamp = MIN_TIME;
+    char stop_reason [REASON_LEN_MAX + 1] = {'\0'};
+
+    /*
+     * General attributes
+     */
     unsigned int connectorId = 0;
-    unsigned int txNr = 0;
+    unsigned int txNr = 0; //client-side key of this tx object (!= transactionId)
 
     bool silent = false; //silent Tx: process tx locally, without reporting to the server
+
 public:
     Transaction(ConnectorTransactionStore& context, unsigned int connectorId, unsigned int txNr, bool silent = false) : 
                 context(context),
@@ -123,63 +79,79 @@ class Transaction {
                 txNr(txNr),
                 silent(silent) {}
 
-    bool serializeSessionState(DynamicJsonDocument& out);
-    bool deserializeSessionState(JsonObject in);
+    /*
+     * data assigned by OCPP server
+     */
+    int getTransactionId() {return transactionId;}
+    bool isAuthorized() {return authorized;} //Authorize has been accepted
+    bool isIdTagDeauthorized() {return deauthorized;} //StartTransaction has been rejected
+
+    /*
+     * Transaction life cycle
+     */
+    bool isRunning() {return start_sync.isRequested() && !stop_sync.isRequested();} //tx is running
+    bool isActive() {return active;} //tx continues to run or is preparing
+    bool isAborted() {return !start_sync.isRequested() && !active;} //tx ended before startTx was sent
+    bool isCompleted() {return stop_sync.isConfirmed();} //tx ended and startTx and stopTx have been confirmed by server
+
+    /*
+     * After modifying a field of tx, commit to make the data persistent
+     */
+    bool commit();
 
-    unsigned int getConnectorId() {return connectorId;}
-    void setConnectorId(unsigned int connectorId) {this->connectorId = connectorId;}
-    unsigned int getTxNr() {return txNr;} //only valid if getConnectorId() >= 0
-    void setTxNr(unsigned int txNr) {this->txNr = txNr;}
+    /*
+     * Getters and setters for (mostly) internal use
+     */
+    void setInactive() {active = false;}
 
-    RpcSync& getStartRpcSync() {return start.rpc;}
+    bool setIdTag(const char *idTag);
+    const char *getIdTag() {return idTag;}
 
-    RpcSync& getStopRpcSync() {return stop.rpc;}
+    void setAuthorized() {authorized = true;}
+    void setIdTagDeauthorized() {deauthorized = true;}
 
-    bool isAborted() {return !start.rpc.requested && !session.active;}
-    bool isCompleted() {return stop.rpc.isConfirmed();}
-    bool isPreparing() {return session.active && !start.rpc.isRequested();}
-    bool isRunning() {return start.rpc.isRequested() && !stop.rpc.isRequested();}
-    bool isActive() {return session.active;}
+    void setBeginTimestamp(Timestamp timestamp) {begin_timestamp = timestamp;}
+    const Timestamp& getBeginTimestamp() {return begin_timestamp;}
 
-    const char *getIdTag() {return session.idTag;}
-    void setIdTag(const char *idTag) {snprintf(session.idTag, IDTAG_LEN_MAX + 1, "%s", idTag);}
-    Timestamp& getSessionTimestamp() {return session.timestamp;}
-    void setSessionTimestamp(Timestamp timestamp) {session.timestamp = timestamp;}
+    void setReservationId(int reservationId) {this->reservationId = reservationId;}
+    int getReservationId() {return reservationId;}
 
-    const char *getStopReason() {return stop.client.reason;}
-    void setStopReason(const char *reason) {snprintf(stop.client.reason, REASON_LEN_MAX + 1, "%s", reason);}
-    void endSession() {session.active = false;}
+    void setTxProfileId(int txProfileId) {this->txProfileId = txProfileId;}
+    int getTxProfileId() {return txProfileId;}
 
-    void setAuthorized() {session.authorized = true;}
-    bool isAuthorized() {return session.authorized;}
+    SendStatus& getStartSync() {return start_sync;}
 
-    void setIdTagDeauthorized() {session.deauthorized = true;}
-    bool isIdTagDeauthorized() {return session.deauthorized;}
+    void setMeterStart(int32_t meter) {start_meter = meter;}
+    bool isMeterStartDefined() {return start_meter >= 0;}
+    int32_t getMeterStart() {return start_meter;}
 
-    int getTransactionId() {return start.server.transactionId;}
-    void setTransactionId(int transactionId) {start.server.transactionId = transactionId;}
+    void setStartTimestamp(Timestamp timestamp) {start_timestamp = timestamp;}
+    const Timestamp& getStartTimestamp() {return start_timestamp;}
 
-    void setMeterStart(int32_t meter) {start.client.meter = meter;}
-    bool isMeterStartDefined() {return start.client.meter >= 0;}
-    int32_t getMeterStart() {return start.client.meter;}
+    void setTransactionId(int transactionId) {transactionId = transactionId;}
 
-    void setReservationId(int reservationId) {start.client.reservationId = reservationId;}
-    int getReservationId() {return start.client.reservationId;}
+    SendStatus& getStopSync() {return stop_sync;}
 
-    void setStartTimestamp(Timestamp timestamp) {start.client.timestamp = timestamp;}
-    Timestamp& getStartTimestamp() {return start.client.timestamp;}
+    bool setStopIdTag(const char *idTag);
+    const char *getStopIdTag() {return stop_idTag;}
 
-    void setMeterStop(int32_t meter) {stop.client.meter = meter;}
-    bool isMeterStopDefined() {return stop.client.meter >= 0;}
-    int32_t getMeterStop() {return stop.client.meter;}
+    void setMeterStop(int32_t meter) {stop_meter = meter;}
+    bool isMeterStopDefined() {return stop_meter >= 0;}
+    int32_t getMeterStop() {return stop_meter;}
 
-    void setStopTimestamp(Timestamp timestamp) {stop.client.timestamp = timestamp;}
-    Timestamp& getStopTimestamp() {return stop.client.timestamp;}
+    void setStopTimestamp(Timestamp timestamp) {stop_timestamp = timestamp;}
+    const Timestamp& getStopTimestamp() {return stop_timestamp;}
 
-    const char *getStopIdTag() {return stop.client.idTag;}
-    void setStopIdTag(const char *idTag) {snprintf(stop.client.idTag, IDTAG_LEN_MAX + 1, "%s", idTag);}
+    bool setStopReason(const char *reason);
+    const char *getStopReason() {return stop_reason;}
 
-    bool commit();
+    void setConnectorId(unsigned int connectorId) {this->connectorId = connectorId;}
+    unsigned int getConnectorId() {return connectorId;}
+
+    void setTxNr(unsigned int txNr) {this->txNr = txNr;}
+    unsigned int getTxNr() {return txNr;} //internal primary key of this tx object
+
+    void setSilent() {silent = true;}
     bool isSilent() {return silent;} //no data will be sent to server and server will not assign transactionId
 };
 
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.cpp
new file mode 100644
index 00000000..718aa24e
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.cpp
@@ -0,0 +1,227 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.h>
+#include <ArduinoOcpp/Debug.h>
+
+namespace ArduinoOcpp {
+
+bool serializeSendStatus(SendStatus& status, JsonObject out) {
+    if (status.isRequested()) {
+        out["requested"] = true;
+    }
+    if (status.isConfirmed()) {
+        out["confirmed"] = true;
+    }
+    return true;
+}
+
+bool deserializeSendStatus(SendStatus& status, JsonObject in) {
+    if (in["requested"] | false) {
+        status.setRequested();
+    }
+    if (in["confirmed"] | false) {
+        status.confirm();
+    }
+    return true;
+}
+
+bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
+    out = DynamicJsonDocument(1024);
+    JsonObject state = out.to<JsonObject>();
+
+    JsonObject sessionState = state.createNestedObject("session");
+    if (!tx.isActive()) {
+        sessionState["active"] = false;
+    }
+    if (tx.getIdTag()[0] != '\0') {
+        sessionState["idTag"] = tx.getIdTag();
+    }
+    if (tx.isAuthorized()) {
+        sessionState["authorized"] = true;
+    }
+    if (tx.isIdTagDeauthorized()) {
+        sessionState["deauthorized"] = true;
+    }
+    if (tx.getBeginTimestamp() > MIN_TIME) {
+        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+        tx.getBeginTimestamp().toJsonString(timeStr, JSONDATE_LENGTH + 1);
+        sessionState["timestamp"] = timeStr;
+    }
+    if (tx.getReservationId() >= 0) {
+        sessionState["reservationId"] = tx.getReservationId();
+    }
+    if (tx.getTxProfileId() >= 0) {
+        sessionState["txProfileId"] = tx.getTxProfileId();
+    }
+
+    JsonObject txStart = state.createNestedObject("start");
+
+    if (!serializeSendStatus(tx.getStartSync(), txStart)) {
+        return false;
+    }
+
+    if (tx.isMeterStartDefined()) {
+        txStart["meter"] = tx.getMeterStart();
+    }
+
+    if (tx.getStartTimestamp() > MIN_TIME) {
+        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+        tx.getStartTimestamp().toJsonString(timeStr, JSONDATE_LENGTH + 1);
+        txStart["timestamp"] = timeStr;
+    }
+
+    if (tx.getStartSync().isConfirmed()) {
+        txStart["transactionId"] = tx.getTransactionId();
+    }
+
+    JsonObject txStop = state.createNestedObject("stop");
+
+    if (!serializeSendStatus(tx.getStopSync(), txStop)) {
+        return false;
+    }
+
+    if (tx.getStopIdTag()[0] != '\0') {
+        txStop["idTag"] = tx.getStopIdTag();
+    }
+
+    if (tx.isMeterStopDefined() >= 0) {
+        txStop["meter"] = tx.getMeterStop();
+    }
+
+    if (tx.getStopTimestamp() > MIN_TIME) {
+        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+        tx.getStopTimestamp().toJsonString(timeStr, JSONDATE_LENGTH + 1);
+        txStop["timestamp"] = timeStr;
+    }
+
+    if (tx.getStopReason()[0] != '\0') {
+        txStop["reason"] = tx.getStopReason();
+    }
+
+    if (tx.isSilent()) {
+        state["silent"] = true;
+    }
+
+    if (out.overflowed()) {
+        AO_DBG_ERR("JSON capacity exceeded");
+        return false;
+    }
+
+    return true;
+}
+
+bool deserializeTransaction(Transaction& tx, JsonObject state) {
+
+    JsonObject sessionState = state["session"];
+
+    if (!(sessionState["active"] | true)) {
+        tx.setInactive();
+    }
+
+    if (sessionState.containsKey("idTag")) {
+        if (!tx.setIdTag(sessionState["idTag"] | "")) {
+            AO_DBG_ERR("read err");
+            return false;
+        }
+    }
+
+    if (sessionState["authorized"] | false) {
+        tx.setAuthorized();
+    }
+
+    if (sessionState["deauthorized"] | false) {
+        tx.setIdTagDeauthorized();
+    }
+
+    if (sessionState.containsKey("timestamp")) {
+        Timestamp timestamp;
+        if (!timestamp.setTime(sessionState["timestamp"] | "Invalid")) {
+            AO_DBG_ERR("read err");
+            return false;
+        }
+        tx.setBeginTimestamp(timestamp);
+    }
+
+    if (sessionState.containsKey("reservationId")) {
+        tx.setReservationId(sessionState["reservationId"] | -1);
+    }
+
+    if (sessionState.containsKey("txProfileId")) {
+        tx.setTxProfileId(sessionState["txProfileId"] | -1);
+    }
+
+    JsonObject txStart = state["start"];
+
+    if (!deserializeSendStatus(tx.getStartSync(), txStart)) {
+        return false;
+    }
+
+    if (txStart.containsKey("meter")) {
+        tx.setMeterStart(txStart["meter"] | 0);
+    }
+
+    if (txStart.containsKey("timestamp")) {
+        Timestamp timestamp;
+        if (!timestamp.setTime(sessionState["timestamp"] | "Invalid")) {
+            AO_DBG_ERR("read err");
+            return false;
+        }
+        tx.setStartTimestamp(timestamp);
+    }
+
+    if (txStart.containsKey("transactionId")) {
+        tx.setTransactionId(txStart["transactionId"] | -1);
+    }
+
+    JsonObject txStop = state["stop"];
+
+    if (!deserializeSendStatus(tx.getStopSync(), txStop)) {
+        return false;
+    }
+
+    if (txStop.containsKey("idTag")) {
+        if (!tx.setStopIdTag(txStop["idTag"] | "")) {
+            AO_DBG_ERR("read err");
+            return false;
+        }
+    }
+
+    if (txStop.containsKey("meter")) {
+        tx.setMeterStop(txStop["meter"] | 0);
+    }
+
+    if (txStop.containsKey("timestamp")) {
+        Timestamp timestamp;
+        if (!timestamp.setTime(txStop["timestamp"] | "Invalid")) {
+            AO_DBG_ERR("read err");
+            return false;
+        }
+        tx.setStopTimestamp(timestamp);
+    }
+
+    if (txStop.containsKey("reason")) {
+        if (!tx.setStopReason(txStop["reason"] | "")) {
+            AO_DBG_ERR("read err");
+            return false;
+        }
+    }
+
+    if (state["silent"] | false) {
+        tx.setSilent();
+    }
+
+    AO_DBG_DEBUG("DUMP TX");
+    AO_DBG_DEBUG("Session   | idTag %s, active: %i, authorized: %i, deauthorized: %i", tx.getIdTag(), tx.isActive(), tx.isAuthorized(), tx.isIdTagDeauthorized());
+    AO_DBG_DEBUG("Start RPC | req: %i, conf: %i", tx.getStartSync().isRequested(), tx.getStartSync().isConfirmed());
+    AO_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  tx.getStopSync().isRequested(), tx.getStopSync().isConfirmed());
+    if (tx.isSilent()) {
+        AO_DBG_DEBUG("          | silent Tx");
+        (void)0;
+    }
+
+    return true;
+}
+
+}
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.h
new file mode 100644
index 00000000..7e17a583
--- /dev/null
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.h
@@ -0,0 +1,19 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef TRANSACTIONDESERIALIZE_H
+#define TRANSACTIONDESERIALIZE_H
+
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+
+#include <ArduinoJson.h>
+
+namespace ArduinoOcpp {
+
+bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out);
+bool deserializeTransaction(Transaction& tx, JsonObject in);
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
index 569254a6..77f40789 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
@@ -4,6 +4,7 @@
 
 #include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Tasks/Transactions/TransactionDeSerialize.h>
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
@@ -91,7 +92,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
 
     auto transaction = std::make_shared<Transaction>(*this, connectorId, txNr);
     JsonObject txJson = doc->as<JsonObject>();
-    if (!transaction->deserializeSessionState(txJson)) {
+    if (!deserializeTransaction(*transaction, txJson)) {
         AO_DBG_ERR("deserialization error");
         return nullptr;
     }
@@ -172,7 +173,7 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
     }
     
     DynamicJsonDocument txDoc {0};
-    if (!transaction->serializeSessionState(txDoc)) {
+    if (!serializeTransaction(*transaction, txDoc)) {
         AO_DBG_ERR("Serialization error");
         return false;
     }
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 2689bff9..c390a223 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -301,17 +301,17 @@ bool ao_isOperative_m(unsigned int connectorId) {
 }
 
 int ao_getTransactionId() {
-    return getTransactionId();
+    return getTransaction() ? getTransaction()->getTransactionId() : -1;
 }
 int ao_getTransactionId_m(unsigned int connectorId) {
-    return getTransactionId(connectorId);
+    return getTransaction(connectorId) ? getTransaction(connectorId)->getTransactionId() : -1;
 }
 
 const char *ao_getTransactionIdTag() {
-    return getTransactionIdTag();
+    return getTransaction() ? getTransaction()->getIdTag() : nullptr;
 }
 const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
-    return getTransactionIdTag(connectorId);
+    return getTransaction(connectorId) ? getTransaction(connectorId)->getIdTag() : nullptr;
 }
 
 bool ao_isBlockedByReservation(const char *idTag) {
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index b0505026..02fcab36 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -52,7 +52,7 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE( checkedSN[0] );
         REQUIRE( checkedSN[1] );
         REQUIRE( isOperative() );
-        REQUIRE( !getTransactionIdTag() );
+        REQUIRE( !getTransaction() );
         REQUIRE( !ocppPermitsCharge() );
     }
 

From 0e0495a0125b0bcff0172cf8ba8a9d0b69eb7423 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 1 Jun 2023 19:42:56 +0200
Subject: [PATCH 260/549] rework API customization

---
 src/ArduinoOcpp.cpp   | 144 +++++++++++-----------------
 src/ArduinoOcpp.h     | 215 ++++++++++++++++++++++++++++++------------
 src/ArduinoOcpp_c.cpp |  75 ++++-----------
 src/ArduinoOcpp_c.h   |  23 +----
 4 files changed, 236 insertions(+), 221 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index b19edd12..a70df9a0 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -23,9 +23,9 @@
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
 #include <ArduinoOcpp/MessagesV16/Authorize.h>
-#include <ArduinoOcpp/MessagesV16/BootNotification.h>
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
+#include <ArduinoOcpp/MessagesV16/CustomMessage.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -47,6 +47,7 @@ float voltage_eff {230.f};
 #endif
 
 #define OCPP_ID_OF_CP 0
+#define OCPP_ID_OF_CONNECTOR 1
 
 } //end namespace ArduinoOcpp::Facade
 } //end namespace ArduinoOcpp
@@ -208,74 +209,6 @@ void OCPP_loop() {
     context->loop();
 }
 
-void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
-    if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-    
-    auto credentials = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-        JSON_OBJECT_SIZE(2) + strlen(chargePointModel) + strlen(chargePointVendor) + 2));
-    (*credentials)["chargePointModel"] = (char*) chargePointModel;
-    (*credentials)["chargePointVendor"] = (char*) chargePointVendor;
-
-    bootNotification(std::move(credentials), onConf, onAbort, onTimeout, onError, timeout);
-}
-
-void bootNotification(std::unique_ptr<DynamicJsonDocument> payload, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
-    if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-
-    //store credentials for later TriggerMessage
-    if (auto bootService = context->getModel().getBootService()) {
-        bootService->setChargePointCredentials(payload->as<JsonObject>());
-    }
-
-    auto bootNotification = makeRequest(
-        new BootNotification(context->getModel(), std::move(payload)));
-    if (onConf)
-        bootNotification->setOnReceiveConfListener(onConf);
-    if (onAbort)
-        bootNotification->setOnAbortListener(onAbort);
-    if (onTimeout)
-        bootNotification->setOnTimeoutListener(onTimeout);
-    if (onError)
-        bootNotification->setOnReceiveErrorListener(onError);
-    if (timeout)
-        bootNotification->setTimeout(timeout);
-    else
-        bootNotification->setTimeout(0);
-    context->initiateRequest(std::move(bootNotification));
-}
-
-void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
-    if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-    if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
-        return;
-    }
-    auto authorize = makeRequest(
-        new Authorize(context->getModel(), idTag));
-    if (onConf)
-        authorize->setOnReceiveConfListener(onConf);
-    if (onAbort)
-        authorize->setOnAbortListener(onAbort);
-    if (onTimeout)
-        authorize->setOnTimeoutListener(onTimeout);
-    if (onError)
-        authorize->setOnReceiveErrorListener(onError);
-    if (timeout)
-        authorize->setTimeout(timeout);
-    else
-        authorize->setTimeout(20000);
-    context->initiateRequest(std::move(authorize));
-}
-
 std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
@@ -669,56 +602,93 @@ Context *getOcppContext() {
     return context;
 }
 
-void setOnSetChargingProfileRequest(OnReceiveReqListener onReceiveReq) {
+void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onReceiveReq) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    context->getOperationRegistry().setOnRequest("SetChargingProfile", onReceiveReq);
-}
-
-void setOnRemoteStartTransactionSendConf(OnSendConfListener onSendConf) {
-    if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+    if (!operationType) {
+        AO_DBG_ERR("invalid args");
         return;
     }
-    context->getOperationRegistry().setOnResponse("RemoteStartTransaction", onSendConf);
+    context->getOperationRegistry().setOnRequest(operationType, onReceiveReq);
 }
 
-void setOnRemoteStopTransactionReceiveReq(OnReceiveReqListener onReceiveReq) {
+void setOnSendConf(const char *operationType, OnSendConfListener onSendConf) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    context->getOperationRegistry().setOnRequest("RemoteStopTransaction", onReceiveReq);
+    if (!operationType) {
+        AO_DBG_ERR("invalid args");
+        return;
+    }
+    context->getOperationRegistry().setOnResponse(operationType, onSendConf);
 }
 
-void setOnRemoteStopTransactionSendConf(OnSendConfListener onSendConf) {
+void sendCustomRequest(const char *operationType,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
+            std::function<void (JsonObject)> fn_processConf) {
+
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    context->getOperationRegistry().setOnResponse("RemoteStopTransaction", onSendConf);
+    if (!operationType || !fn_createReq || !fn_processConf) {
+        AO_DBG_ERR("invalid args");
+        return;
+    }
+
+    auto request = makeRequest(new CustomMessage(operationType, fn_createReq, fn_processConf));
+    context->initiateRequest(std::move(request));
 }
 
-void setOnResetSendConf(OnSendConfListener onSendConf) {
+void setCustomRequestHandler(const char *operationType,
+            std::function<void (JsonObject)> fn_processReq,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf) {
+
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    context->getOperationRegistry().setOnResponse("Reset", onSendConf);
+    if (!operationType || !fn_processReq || !fn_createConf) {
+        AO_DBG_ERR("invalid args");
+        return;
+    }
+
+    std::string captureOpType = operationType;
+
+    context->getOperationRegistry().registerOperation(operationType, [captureOpType, fn_processReq, fn_createConf] () {
+        return new CustomMessage(captureOpType.c_str(), fn_processReq, fn_createConf);
+    });
 }
 
-void setOnResetRequest(OnReceiveReqListener onReceiveReq) {
+void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    context->getOperationRegistry().setOnRequest("Reset", onReceiveReq);
+    if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
+        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        return;
+    }
+    auto authorize = makeRequest(
+        new Authorize(context->getModel(), idTag));
+    if (onConf)
+        authorize->setOnReceiveConfListener(onConf);
+    if (onAbort)
+        authorize->setOnAbortListener(onAbort);
+    if (onTimeout)
+        authorize->setOnTimeoutListener(onTimeout);
+    if (onError)
+        authorize->setOnReceiveErrorListener(onError);
+    if (timeout)
+        authorize->setTimeout(timeout);
+    else
+        authorize->setTimeout(20000);
+    context->initiateRequest(std::move(authorize));
 }
 
-#define OCPP_ID_OF_CONNECTOR 1
-
 bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 3cc9b6f0..7d79c904 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -101,58 +101,6 @@ void OCPP_deinitialize();
  */
 void OCPP_loop();
 
-/*
- * Send OCPP operations.
- * 
- * You only need to send the following operation types manually:
- *     - BootNotification: Notify the OCPP server that this EVSE is ready and start the OCPP
- *           routines.
- *     - Authorize: Validate an RFID tag before using it for a transaction
- * 
- * All other operation types are handled automatically by this library.
- * 
- * On receipt of the .conf() response the library calls the callback function
- * "OnReceiveConfListener onConf" and passes the OCPP payload to it.
- * 
- * For your first EVSE integration, the `onReceiveConfListener` is probably sufficient. For
- * advanced EVSE projects, the other listeners likely become relevant:
- * - `onAbortListener`: will be called whenever the engine stops trying to finish an operation
- *           normally which was initiated by this device.
- * - `onTimeoutListener`: will be executed when the operation is not answered until the timeout
- *           expires. Note that timeouts also trigger the `onAbortListener`.
- * - `onReceiveErrorListener`: will be called when the Central System returns a CallError.
- *           Again, each error also triggers the `onAbortListener`.
- * 
- * The functions for sending OCPP operations are non-blocking. The program will resume immediately
- * with the code after with the subsequent code in any case.
- */
-
-void bootNotification(
-            const char *chargePointModel,                //model name of the EVSE
-            const char *chargePointVendor,               //vendor name
-            OnReceiveConfListener onConf = nullptr,      //callback (confirmation received)
-            OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
-            OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
-            OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
-            unsigned int timeout = 0); //custom timeout behavior, optional
-
-//Alternative version for sending a complete BootNotification payload
-void bootNotification(
-            std::unique_ptr<DynamicJsonDocument> payload,//manually defined payload
-            OnReceiveConfListener onConf = nullptr,      //callback (confirmation received)
-            OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
-            OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
-            OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
-            unsigned int timeout = 0); //custom timeout behavior, optional
-
-void authorize(
-            const char *idTag,                           //RFID tag (e.g. ISO 14443 UID tag with 4 or 7 bytes)
-            OnReceiveConfListener onConf = nullptr,      //callback (confirmation received)
-            OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
-            OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
-            OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
-            unsigned int timeout = 0); //custom timeout behavior, optional
-
 /*
  * Transaction management.
  * 
@@ -284,6 +232,7 @@ bool isOperative(unsigned int connectorId = 1); //if the charge point is operati
  * auto tx = getTransaction(); //fetch tx object
  * if (tx) { //check if tx object exists
  *     bool active = tx->isActive(); //active tells if the transaction is preparing or continuing to run
+ *                                   //inactive means that the transaction is about to stop, stopped or won't be started anymore
  *     int transactionId = tx->getTransactionId(); //the transactionId as assigned by the OCPP server
  *     bool deauthorized = tx->isIdTagDeauthorized(); //if StartTransaction has been rejected
  * }
@@ -319,6 +268,10 @@ ArduinoOcpp::FirmwareService *getFirmwareService();
 ArduinoOcpp::DiagnosticsService *getDiagnosticsService();
 #endif
 
+/*
+ * Add features and customize the behavior of the OCPP client
+ */
+
 namespace ArduinoOcpp {
 class Context;
 }
@@ -328,21 +281,161 @@ class Context;
 ArduinoOcpp::Context *getOcppContext();
 
 /*
- * Deprecated functions or functions to be moved to ArduinoOcppExtended.h
+ * Set a listener which is notified when the OCPP lib processes an incoming operation of type
+ * operationType. After the operation has been interpreted, onReceiveReq will be called with
+ * the original message from the OCPP server.
+ * 
+ * Example usage:
+ * 
+ * setOnReceiveRequest("SetChargingProfile", [] (JsonObject payload) {
+ *     Serial.print("[main] received charging profile for connector: "; //Arduino print function
+ *     Serial.printf("update connector %i with chargingProfileId %i\n",
+ *             payload["connectorId"],                                  //ArduinoJson object access
+ *             payload["csChargingProfiles"]["chargingProfileId"]);
+ * });
  */
+void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onReceiveReq);
 
-void setOnSetChargingProfileRequest(OnReceiveReqListener onReceiveReq); //optional
+/*
+ * Set a listener which is notified when the OCPP lib sends the confirmation to an incoming
+ * operation of type operation type. onSendConf will be passed the original output of the
+ * OCPP lib.
+ * 
+ * Example usage:
+ * 
+ * setOnSendConf("RemoteStopTransaction", [] (JsonObject payload) -> void {
+ *     if (!strcmp(payload["status"], "Rejected")) {
+ *         //the OCPP lib rejected the RemoteStopTransaction command. In this example, the customer
+ *         //wishes to stop the running transaction in any case and to log this case
+ *         endTransaction("Remote"); //end transaction and send StopTransaction if a transaction is running
+ *         Serial.println("[main] override rejected RemoteStopTransaction"); //Arduino print function
+ *     }
+ * });
+ * 
+ */
+void setOnSendConf(const char *operationType, OnSendConfListener onSendConf);
 
-void setOnRemoteStartTransactionSendConf(OnSendConfListener onSendConf);
+/*
+ * Create and send an operation without using the built-in Operation class. This function bypasses
+ * the business logic which comes with this library. E.g. you can send unknown operations, extend
+ * OCPP or replace parts of the business logic with custom behavior.
+ * 
+ * Use case 1, extend the library by sending additional operations. E.g. DataTransfer:
+ * 
+ * sendCustomRequest("DataTransfer", [] () -> std::unique_ptr<DynamicJsonDocument> {
+ *     //will be called to create the request once this operation is being sent out
+ *     size_t capacity = JSON_OBJECT_SIZE(3) +
+ *                       JSON_OBJECT_SIZE(2); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
+ *     auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity)); 
+ *     JsonObject request = *res;
+ *     request["vendorId"] = "My company Ltd.";
+ *     request["messageId"] = "TargetValues";
+ *     request["data"]["battery_capacity"] = 89;
+ *     request["data"]["battery_soc"] = 34;
+ *     return res;
+ * }, [] (JsonObject response) -> void {
+ *     //will be called with the confirmation response of the server
+ *     if (!strcmp(response["status"], "Accepted")) {
+ *         //DataTransfer has been accepted
+ *         int max_energy = response["data"]["max_energy"];
+ *     }
+ * });
+ * 
+ * Use case 2, bypass the business logic of this library for custom behavior. E.g. StartTransaction:
+ * 
+ * sendCustomRequest("StartTransaction", [] () -> std::unique_ptr<DynamicJsonDocument> {
+ *     //will be called to create the request once this operation is being sent out
+ *     size_t capacity = JSON_OBJECT_SIZE(4); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
+ *     auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity)); 
+ *     JsonObject request = *res;
+ *     request["connectorId"] = 1;
+ *     request["idTag"] = "A9C3CE1D7B71EA";
+ *     request["meterStart"] = 1234;
+ *     request["timestamp"] = "2023-06-01T11:07:43Z"; //e.g. some historic transaction
+ *     return res;
+ * }, [] (JsonObject response) -> void {
+ *     //will be called with the confirmation response of the server
+ *     const char *status = response["idTagInfo"]["status"];
+ *     int transactionId = response["transactionId"];
+ * });
+ * 
+ * In Use case 2, the library won't send any further StatusNotification or StopTransaction on
+ * its own.
+ */
+void sendCustomRequest(const char *operationType,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
+            std::function<void (JsonObject)> fn_processConf);
 
-void setOnRemoteStopTransactionSendConf(OnSendConfListener onSendConf);
-void setOnRemoteStopTransactionReceiveReq(OnReceiveReqListener onReceiveReq);
+/*
+ * Set a custom handler for an incoming operation type. This will update the core Operation registry
+ * of the library, potentially replacing the built-in Operation handler and bypassing the
+ * business logic of this library.
+ * 
+ * Note that when replacing an operation handler, the attached listeners will be reset.
+ * 
+ * Example usage:
+ * 
+ * setCustomRequestHandler("DataTransfer", [] (JsonObject request) -> void {
+ *     //will be called with the request message from the server
+ *     const char *vendorId = request["vendorId"];
+ *     const char *messageId = request["messageId"];
+ *     int battery_capacity = request["data"]["battery_capacity"];
+ *     int battery_soc = request["data"]["battery_soc"];
+ * }, [] () -> std::unique_ptr<DynamicJsonDocument> {
+ *     //will be called  to create the response once this operation is being sent out
+ *     size_t capacity = JSON_OBJECT_SIZE(2) +
+ *                       JSON_OBJECT_SIZE(1); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
+ *     auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity)); 
+ *     JsonObject response = *res;
+ *     response["status"] = "Accepted";
+ *     response["data"]["max_energy"] = 59;
+ *     return res;
+ * });
+ */
+void setCustomRequestHandler(const char *operationType,
+            std::function<void (JsonObject)> fn_processReq,
+            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf);
 
-void setOnResetSendConf(OnSendConfListener onSendConf);
-void setOnResetRequest(OnReceiveReqListener onReceiveReq);
+/*
+ * Send OCPP operations manually not bypassing the internal business logic
+ * 
+ * On receipt of the .conf() response the library calls the callback function
+ * "OnReceiveConfListener onConf" and passes the OCPP payload to it.
+ * 
+ * For your first EVSE integration, the `onReceiveConfListener` is probably sufficient. For
+ * advanced EVSE projects, the other listeners likely become relevant:
+ * - `onAbortListener`: will be called whenever the engine stops trying to finish an operation
+ *           normally which was initiated by this device.
+ * - `onTimeoutListener`: will be executed when the operation is not answered until the timeout
+ *           expires. Note that timeouts also trigger the `onAbortListener`.
+ * - `onReceiveErrorListener`: will be called when the Central System returns a CallError.
+ *           Again, each error also triggers the `onAbortListener`.
+ * 
+ * The functions for sending OCPP operations are non-blocking. The program will resume immediately
+ * with the code after with the subsequent code in any case.
+ */
 
-bool startTransaction(const char *idTag, OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, unsigned int timeout = 0);
+void authorize(
+            const char *idTag,                           //RFID tag (e.g. ISO 14443 UID tag with 4 or 7 bytes)
+            OnReceiveConfListener onConf = nullptr,      //callback (confirmation received)
+            OnAbortListener onAbort = nullptr,           //callback (confirmation not received), optional
+            OnTimeoutListener onTimeout = nullptr,       //callback (timeout expired), optional
+            OnReceiveErrorListener onError = nullptr,    //callback (error code received), optional
+            unsigned int timeout = 0); //custom timeout behavior, optional
 
-bool stopTransaction(OnReceiveConfListener onConf = nullptr, OnAbortListener onAbort = nullptr, OnTimeoutListener onTimeout = nullptr, OnReceiveErrorListener onError = nullptr, unsigned int timeout = 0);
+bool startTransaction(
+            const char *idTag,
+            OnReceiveConfListener onConf = nullptr,
+            OnAbortListener onAbort = nullptr,
+            OnTimeoutListener onTimeout = nullptr,
+            OnReceiveErrorListener onError = nullptr,
+            unsigned int timeout = 0);
+
+bool stopTransaction(
+            OnReceiveConfListener onConf = nullptr,
+            OnAbortListener onAbort = nullptr,
+            OnTimeoutListener onTimeout = nullptr,
+            OnReceiveErrorListener onError = nullptr,
+            unsigned int timeout = 0);
 
 #endif
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index c390a223..cc8dba74 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -126,44 +126,6 @@ std::function<ArduinoOcpp::PollResult<bool>()> adaptFn(unsigned int connectorId,
     return [fn, connectorId] () {return adaptScl(fn(connectorId));};
 }
 
-void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
-    bootNotification(chargePointModel, chargePointVendor, adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
-}
-
-void ao_bootNotification_full(const char *payloadJson, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
-    auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(9) + 230 + 9)); // BootNotification has at most 9 attributes with at most 230 chars + null terminators
-    auto err = deserializeJson(*payload, payloadJson);
-    if (err) {
-        AO_DBG_ERR("Could not process input: %s", err.c_str());
-        (void)0;
-    }
-
-    bootNotification(std::move(payload), adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
-}
-
-void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
-    
-    std::string idTag_capture = idTag;
-
-    authorize(idTag,
-            onConfirmation ? [onConfirmation, idTag_capture, user_data] (JsonObject payload) {
-                    auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
-                    if (len <= 0) {AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
-                    onConfirmation(idTag_capture.c_str(), len > 0 ? ao_recv_payload_buff : "", len, user_data);
-                } : OnReceiveConfListener(nullptr),
-            onAbort ? [onAbort, idTag_capture, user_data] () -> void {
-                    onAbort(idTag_capture.c_str(), user_data);
-                } : OnAbortListener(nullptr),
-            onTimeout ? [onTimeout, idTag_capture, user_data] () {
-                    onTimeout(idTag_capture.c_str(), user_data);
-                } : OnTimeoutListener(nullptr),
-            onError ? [onError, idTag_capture, user_data] (const char *code, const char *description, JsonObject details) {
-                    auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
-                    if (len <= 0) {AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
-                    onError(idTag_capture.c_str(), code, description, len > 0 ? ao_recv_payload_buff : "", len, user_data);
-                } : OnReceiveErrorListener(nullptr));
-}
-
 void ao_beginTransaction(const char *idTag) {
     beginTransaction(idTag);
 }
@@ -321,10 +283,6 @@ bool ao_isBlockedByReservation_m(unsigned int connectorId, const char *idTag) {
     return isBlockedByReservation(idTag, connectorId);
 }
 
-void ao_setOnResetRequest(OnMessage onRequest) {
-    setOnResetRequest(adaptFn(onRequest));
-}
-
 void ao_set_console_out_c(void (*console_out)(const char *msg)) {
     ao_set_console_out(console_out);
 }
@@ -333,20 +291,27 @@ OcppHandle *ao_getOcppHandle() {
     return reinterpret_cast<OcppHandle*>(getOcppContext());
 }
 
-void ao_onRemoteStartTransactionSendConf(OnMessage onSendConf) {
-    setOnRemoteStopTransactionSendConf(adaptFn(onSendConf));
-}
-
-void ao_onRemoteStopTransactionSendConf(OnMessage onSendConf) {
-    setOnRemoteStopTransactionSendConf(adaptFn(onSendConf));
-}
-
-void ao_onRemoteStopTransactionRequest(OnMessage onRequest) {
-    setOnRemoteStopTransactionReceiveReq(adaptFn(onRequest));
-}
+void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
+    
+    std::string idTag_capture = idTag;
 
-void ao_onResetSendConf(OnMessage onSendConf) {
-    setOnResetSendConf(adaptFn(onSendConf));
+    authorize(idTag,
+            onConfirmation ? [onConfirmation, idTag_capture, user_data] (JsonObject payload) {
+                    auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+                    if (len <= 0) {AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
+                    onConfirmation(idTag_capture.c_str(), len > 0 ? ao_recv_payload_buff : "", len, user_data);
+                } : OnReceiveConfListener(nullptr),
+            onAbort ? [onAbort, idTag_capture, user_data] () -> void {
+                    onAbort(idTag_capture.c_str(), user_data);
+                } : OnAbortListener(nullptr),
+            onTimeout ? [onTimeout, idTag_capture, user_data] () {
+                    onTimeout(idTag_capture.c_str(), user_data);
+                } : OnTimeoutListener(nullptr),
+            onError ? [onError, idTag_capture, user_data] (const char *code, const char *description, JsonObject details) {
+                    auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+                    if (len <= 0) {AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
+                    onError(idTag_capture.c_str(), code, description, len > 0 ? ao_recv_payload_buff : "", len, user_data);
+                } : OnReceiveErrorListener(nullptr));
 }
 
 void ao_startTransaction(const char *idTag, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index dbf3fb3d..033151fd 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -67,15 +67,6 @@ void ao_initialize_full(
 void ao_deinitialize();
 
 void ao_loop();
-/*
- * Send OCPP operations
- */
-
-void ao_bootNotification(const char *chargePointModel, const char *chargePointVendor, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
-
-void ao_bootNotification_full(const char *payloadJson, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
-
-void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data);
 
 /*
  * Charging session management
@@ -159,7 +150,9 @@ const char *ao_getTransactionIdTag_m(unsigned int connectorId);
 bool ao_isBlockedByReservation(const char *idTag);
 bool ao_isBlockedByReservation_m(unsigned int connectorId, const char *idTag);
 
-void ao_setOnResetRequest(OnMessage onRequest);
+void ao_setOnReceiveRequest(const char *operationType, OnMessage onRequest);
+
+void ao_setOnSendConf(const char *operationType, OnMessage onConfirmation);
 
 /*
  * If build flag AO_CUSTOM_CONSOLE is set, all console output will be forwarded to the print
@@ -174,15 +167,9 @@ void ao_set_console_out_c(void (*console_out)(const char *msg));
 OcppHandle *ao_getOcppHandle();
 
 /*
- * Deprecated functions or functions to be moved to ArduinoOcppExtended.h
+ * Send OCPP operations
  */
-
-void ao_onRemoteStartTransactionSendConf(OnMessage onSendConf); //important, energize the power plug here and capture the idTag
-
-void ao_onRemoteStopTransactionSendConf(OnMessage onSendConf); //important, de-energize the power plug here
-void ao_onRemoteStopTransactionRequest(OnMessage onRequest); //optional, to de-energize the power plug immediately
-
-void ao_setOnResetSendConf(OnMessage onSendConf);
+void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data);
 
 void ao_startTransaction(const char *idTag, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
 

From 9d8c4555c09e58e03cafc2bb9c1bdfbd11a69efc Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 2 Jun 2023 13:34:19 +0200
Subject: [PATCH 261/549] rename Custom Operation class

---
 CMakeLists.txt                                |  2 +-
 src/ArduinoOcpp.cpp                           |  6 ++--
 ...{CustomMessage.cpp => CustomOperation.cpp} | 30 +++++++++----------
 .../{CustomMessage.h => CustomOperation.h}    |  8 ++---
 4 files changed, 23 insertions(+), 23 deletions(-)
 rename src/ArduinoOcpp/MessagesV16/{CustomMessage.cpp => CustomOperation.cpp} (70%)
 rename src/ArduinoOcpp/MessagesV16/{CustomMessage.h => CustomOperation.h} (94%)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 8ca398fe..6ec69167 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -27,7 +27,7 @@ set(AO_SRC
     src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
     src/ArduinoOcpp/MessagesV16/ClearCache.cpp
     src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
-    src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
+    src/ArduinoOcpp/MessagesV16/CustomOperation.cpp
     src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
     src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
     src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index a70df9a0..a4bac396 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -25,7 +25,7 @@
 #include <ArduinoOcpp/MessagesV16/Authorize.h>
 #include <ArduinoOcpp/MessagesV16/StartTransaction.h>
 #include <ArduinoOcpp/MessagesV16/StopTransaction.h>
-#include <ArduinoOcpp/MessagesV16/CustomMessage.h>
+#include <ArduinoOcpp/MessagesV16/CustomOperation.h>
 
 #include <ArduinoOcpp/Debug.h>
 
@@ -639,7 +639,7 @@ void sendCustomRequest(const char *operationType,
         return;
     }
 
-    auto request = makeRequest(new CustomMessage(operationType, fn_createReq, fn_processConf));
+    auto request = makeRequest(new CustomOperation(operationType, fn_createReq, fn_processConf));
     context->initiateRequest(std::move(request));
 }
 
@@ -659,7 +659,7 @@ void setCustomRequestHandler(const char *operationType,
     std::string captureOpType = operationType;
 
     context->getOperationRegistry().registerOperation(operationType, [captureOpType, fn_processReq, fn_createConf] () {
-        return new CustomMessage(captureOpType.c_str(), fn_processReq, fn_createConf);
+        return new CustomOperation(captureOpType.c_str(), fn_processReq, fn_createConf);
     });
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp b/src/ArduinoOcpp/MessagesV16/CustomOperation.cpp
similarity index 70%
rename from src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
rename to src/ArduinoOcpp/MessagesV16/CustomOperation.cpp
index 790084ac..841d530b 100644
--- a/src/ArduinoOcpp/MessagesV16/CustomMessage.cpp
+++ b/src/ArduinoOcpp/MessagesV16/CustomOperation.cpp
@@ -2,11 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/CustomMessage.h>
+#include <ArduinoOcpp/MessagesV16/CustomOperation.h>
 
-using ArduinoOcpp::Ocpp16::CustomMessage;
+using ArduinoOcpp::Ocpp16::CustomOperation;
 
-CustomMessage::CustomMessage(const char *operationType,
+CustomOperation::CustomOperation(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf,
             std::function<bool (const char*, const char*, JsonObject)> fn_processErr,
@@ -21,7 +21,7 @@ CustomMessage::CustomMessage(const char *operationType,
     
 }
 
-CustomMessage::CustomMessage(const char *operationType,
+CustomOperation::CustomOperation(const char *operationType,
             std::function<void (JsonObject)> fn_processReq,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf,
             std::function<const char* ()> fn_getErrorCode,
@@ -36,21 +36,21 @@ CustomMessage::CustomMessage(const char *operationType,
     
 }
 
-CustomMessage::~CustomMessage() {
+CustomOperation::~CustomOperation() {
 
 }
 
-const char* CustomMessage::getOperationType() {
+const char* CustomOperation::getOperationType() {
     return operationType.c_str();
 }
 
-void CustomMessage::initiate(StoredOperationHandler *opStore) {
+void CustomOperation::initiate(StoredOperationHandler *opStore) {
     if (fn_initiate) {
         fn_initiate(opStore);
     }
 }
 
-bool CustomMessage::restore(StoredOperationHandler *opStore) {
+bool CustomOperation::restore(StoredOperationHandler *opStore) {
     if (fn_restore) {
         return fn_restore(opStore);
     } else {
@@ -58,23 +58,23 @@ bool CustomMessage::restore(StoredOperationHandler *opStore) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> CustomMessage::createReq() {
+std::unique_ptr<DynamicJsonDocument> CustomOperation::createReq() {
     return fn_createReq();
 }
 
-void CustomMessage::processConf(JsonObject payload) {
+void CustomOperation::processConf(JsonObject payload) {
     return fn_processConf(payload);
 }
 
-void CustomMessage::processReq(JsonObject payload) {
+void CustomOperation::processReq(JsonObject payload) {
     return fn_processReq(payload);
 }
 
-std::unique_ptr<DynamicJsonDocument> CustomMessage::createConf() {
+std::unique_ptr<DynamicJsonDocument> CustomOperation::createConf() {
     return fn_createConf();
 }
 
-const char *CustomMessage::getErrorCode() {
+const char *CustomOperation::getErrorCode() {
     if (fn_getErrorCode) {
         return fn_getErrorCode();
     } else {
@@ -82,7 +82,7 @@ const char *CustomMessage::getErrorCode() {
     }
 }
 
-const char *CustomMessage::getErrorDescription() {
+const char *CustomOperation::getErrorDescription() {
     if (fn_getErrorDescription) {
         return fn_getErrorDescription();
     } else {
@@ -90,7 +90,7 @@ const char *CustomMessage::getErrorDescription() {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> CustomMessage::getErrorDetails() {
+std::unique_ptr<DynamicJsonDocument> CustomOperation::getErrorDetails() {
     if (fn_getErrorDetails) {
         return fn_getErrorDetails();
     } else {
diff --git a/src/ArduinoOcpp/MessagesV16/CustomMessage.h b/src/ArduinoOcpp/MessagesV16/CustomOperation.h
similarity index 94%
rename from src/ArduinoOcpp/MessagesV16/CustomMessage.h
rename to src/ArduinoOcpp/MessagesV16/CustomOperation.h
index b190fb4e..7b7d1018 100644
--- a/src/ArduinoOcpp/MessagesV16/CustomMessage.h
+++ b/src/ArduinoOcpp/MessagesV16/CustomOperation.h
@@ -13,7 +13,7 @@ namespace ArduinoOcpp {
 
 namespace Ocpp16 {
 
-class CustomMessage : public Operation {
+class CustomOperation : public Operation {
 private:
     std::string operationType;
     std::function<void (StoredOperationHandler*)> fn_initiate; //optional
@@ -29,7 +29,7 @@ class CustomMessage : public Operation {
 public:
 
     //for operations initiated at this device
-    CustomMessage(const char *operationType,
+    CustomOperation(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf,
             std::function<bool (const char*, const char*, JsonObject)> fn_processErr = nullptr,
@@ -37,14 +37,14 @@ class CustomMessage : public Operation {
             std::function<bool (StoredOperationHandler*)> fn_restore = nullptr);
     
     //for operations receied from remote
-    CustomMessage(const char *operationType,
+    CustomOperation(const char *operationType,
             std::function<void (JsonObject)> fn_processReq,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf,
             std::function<const char* ()> fn_getErrorCode = nullptr,
             std::function<const char* ()> fn_getErrorDescription = nullptr,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_getErrorDetails = nullptr);
     
-    ~CustomMessage();
+    ~CustomOperation();
 
     const char* getOperationType() override;
 

From 1fa206aa7dd5247416ecfa58c71d9e777e75af9d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 2 Jun 2023 13:45:30 +0200
Subject: [PATCH 262/549] update copyright notice

---
 LICENSE                                                         | 2 +-
 platformio.ini                                                  | 2 +-
 src/ArduinoOcpp/Core/Configuration.cpp                          | 2 +-
 src/ArduinoOcpp/Core/ConfigurationContainer.cpp                 | 2 +-
 src/ArduinoOcpp/Core/ConfigurationContainer.h                   | 2 +-
 src/ArduinoOcpp/Core/ConfigurationContainerFlash.h              | 2 +-
 src/ArduinoOcpp/Core/ConfigurationKeyValue.h                    | 2 +-
 src/ArduinoOcpp/Core/ConfigurationOptions.h                     | 2 +-
 src/ArduinoOcpp/Core/PollResult.h                               | 2 +-
 src/ArduinoOcpp/Core/RequestStore.h                             | 2 +-
 src/ArduinoOcpp/Debug.h                                         | 2 +-
 src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp             | 2 +-
 src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h               | 2 +-
 src/ArduinoOcpp/MessagesV16/CiStrings.h                         | 2 +-
 src/ArduinoOcpp/MessagesV16/DataTransfer.cpp                    | 2 +-
 src/ArduinoOcpp/MessagesV16/DataTransfer.h                      | 2 +-
 src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp                | 2 +-
 src/ArduinoOcpp/MessagesV16/GetConfiguration.h                  | 2 +-
 src/ArduinoOcpp/Platform.cpp                                    | 2 +-
 src/ArduinoOcpp/Platform.h                                      | 2 +-
 src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h             | 2 +-
 src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h          | 2 +-
 src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h           | 2 +-
 src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h      | 2 +-
 src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h       | 2 +-
 src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp | 2 +-
 src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h   | 2 +-
 src/ArduinoOcpp/Tasks/Metering/MeterStore.h                     | 2 +-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp                   | 2 +-
 src/ArduinoOcpp/Tasks/Metering/MeterValue.h                     | 2 +-
 src/ArduinoOcpp/Tasks/Metering/MeteringService.h                | 2 +-
 src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp      | 2 +-
 src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h        | 2 +-
 src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h      | 2 +-
 src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h           | 2 +-
 35 files changed, 35 insertions(+), 35 deletions(-)

diff --git a/LICENSE b/LICENSE
index c24c6219..4211ff4f 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019 - 2022 matth-x
+Copyright (c) 2019 - 2023 Matthias Akstaller
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/platformio.ini b/platformio.ini
index a04c0917..ec11a715 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -1,5 +1,5 @@
 ; matth-x/ArduinoOcpp
-; Copyright Matthias Akstaller 2019 - 2022
+; Copyright Matthias Akstaller 2019 - 2023
 ; MIT License
 
 [platformio]
diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 4ab64999..3eda35c6 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/Configuration.h>
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainer.cpp b/src/ArduinoOcpp/Core/ConfigurationContainer.cpp
index 9b3418b1..1fa7ffcf 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainer.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainer.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Core/ConfigurationContainer.h>
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainer.h b/src/ArduinoOcpp/Core/ConfigurationContainer.h
index 1074ff96..e7d0567a 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainer.h
+++ b/src/ArduinoOcpp/Core/ConfigurationContainer.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONFIGURATIONCONTAINER_H
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.h b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.h
index 865756de..d2ac33b7 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.h
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONFIGURATIONCONTAINERFLASH_H
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
index c3855774..381040fb 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONFIGURATIONKEYVALUE_H
diff --git a/src/ArduinoOcpp/Core/ConfigurationOptions.h b/src/ArduinoOcpp/Core/ConfigurationOptions.h
index a9e0f2b7..a45dca42 100644
--- a/src/ArduinoOcpp/Core/ConfigurationOptions.h
+++ b/src/ArduinoOcpp/Core/ConfigurationOptions.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONFIGURATIONOPTIONS_H
diff --git a/src/ArduinoOcpp/Core/PollResult.h b/src/ArduinoOcpp/Core/PollResult.h
index a21324f8..f6bd4934 100644
--- a/src/ArduinoOcpp/Core/PollResult.h
+++ b/src/ArduinoOcpp/Core/PollResult.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef POLLRESULT_H
diff --git a/src/ArduinoOcpp/Core/RequestStore.h b/src/ArduinoOcpp/Core/RequestStore.h
index 4370d11b..68e51cbd 100644
--- a/src/ArduinoOcpp/Core/RequestStore.h
+++ b/src/ArduinoOcpp/Core/RequestStore.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OPERATIONSTORE_H
diff --git a/src/ArduinoOcpp/Debug.h b/src/ArduinoOcpp/Debug.h
index 3eb8ab4c..df2478e6 100644
--- a/src/ArduinoOcpp/Debug.h
+++ b/src/ArduinoOcpp/Debug.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef AO_DEBUG_H
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
index a0c0a378..e4dc17b0 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/ChangeConfiguration.h>
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
index ebf5e116..d56b7188 100644
--- a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
+++ b/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CHANGECONFIGURATION_H
diff --git a/src/ArduinoOcpp/MessagesV16/CiStrings.h b/src/ArduinoOcpp/MessagesV16/CiStrings.h
index 2d84cdd7..c26a8b1d 100644
--- a/src/ArduinoOcpp/MessagesV16/CiStrings.h
+++ b/src/ArduinoOcpp/MessagesV16/CiStrings.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 /*
diff --git a/src/ArduinoOcpp/MessagesV16/DataTransfer.cpp b/src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
index a7816f74..72103581 100644
--- a/src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
+++ b/src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/DataTransfer.h>
diff --git a/src/ArduinoOcpp/MessagesV16/DataTransfer.h b/src/ArduinoOcpp/MessagesV16/DataTransfer.h
index 7b2e2346..f7fcaf89 100644
--- a/src/ArduinoOcpp/MessagesV16/DataTransfer.h
+++ b/src/ArduinoOcpp/MessagesV16/DataTransfer.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef DATATRANSFER_H
diff --git a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
index c4711990..8720a384 100644
--- a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
+++ b/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/MessagesV16/GetConfiguration.h>
diff --git a/src/ArduinoOcpp/MessagesV16/GetConfiguration.h b/src/ArduinoOcpp/MessagesV16/GetConfiguration.h
index 7e84ade7..3ac272b4 100644
--- a/src/ArduinoOcpp/MessagesV16/GetConfiguration.h
+++ b/src/ArduinoOcpp/MessagesV16/GetConfiguration.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef GETCONFIGURATION_H
diff --git a/src/ArduinoOcpp/Platform.cpp b/src/ArduinoOcpp/Platform.cpp
index 463d7cd5..95f3de79 100644
--- a/src/ArduinoOcpp/Platform.cpp
+++ b/src/ArduinoOcpp/Platform.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Platform.h>
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index 4733e805..443d04c4 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef AO_PLATFORM_H
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h b/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
index a3d9964a..e9e12e22 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPP_EVSE_STATE
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
index 19f205fe..bc219100 100644
--- a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
+++ b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef DIAGNOSTICSSERVICE_H
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h
index f9e7188a..bf67f8cd 100644
--- a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h
+++ b/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef DIAGNOSTICS_STATUS
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
index 52194a48..1e08e028 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef FIRMWARESERVICE_H
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h
index e6157654..82a0e39b 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef FIRMWARE_STATUS
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index b8b7e0b9..1c3a0d8d 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h>
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index 2546c979..a8b2ba08 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONNECTOR_METER_VALUES_RECORDER
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
index 1e6bef5f..a64dc35f 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterStore.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef METERSTORE_H
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
index c6b213ee..3092f03d 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
index ac9e274d..b5764e8a 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeterValue.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef METERVALUE_H
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index 3452aad7..86a4b2c8 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef METERINGSERVICE_H
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
index d7532d77..6195801a 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h>
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
index 91fbc55c..8e6a61aa 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef SMARTCHARGINGMODEL_H
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
index e7390654..e616ef57 100644
--- a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
+++ b/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef SMARTCHARGINGSERVICE_H
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
index 87954916..d0c451b8 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
@@ -1,5 +1,5 @@
 // matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2022
+// Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef TRANSACTIONSTORE_H

From 68e1f43053c24fb0fd3f3adb68bdf58267902183 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 3 Jun 2023 19:15:06 +0200
Subject: [PATCH 263/549] docs update

---
 docs/img/components_overview.svg  |  3 +++
 docs/img/components_selective.svg |  3 +++
 docs/index.md                     | 26 ++----------------
 docs/intro-tech.md                | 45 +++++++++++++++++++++++++++++++
 docs/prerequisites.md             | 33 +++++++++++++++++++++++
 5 files changed, 86 insertions(+), 24 deletions(-)
 create mode 100644 docs/img/components_overview.svg
 create mode 100644 docs/img/components_selective.svg
 create mode 100644 docs/intro-tech.md
 create mode 100644 docs/prerequisites.md

diff --git a/docs/img/components_overview.svg b/docs/img/components_overview.svg
new file mode 100644
index 00000000..174ecf99
--- /dev/null
+++ b/docs/img/components_overview.svg
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="335px" height="391px" viewBox="-0.5 -0.5 335 391"><defs/><g><rect x="-0.4" y="0" width="333.4" height="390" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="33" y="70" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 77px; margin-left: 34px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp library</div></div></div></foreignObject><text x="163" y="89" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp library</text></switch></g><rect x="43" y="110" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 135px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp API</div></div></div></foreignObject><text x="163" y="139" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp API</text></switch></g><rect x="43" y="170" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 195px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="163" y="199" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="43" y="230" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 255px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="163" y="259" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="73" y="20" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 35px; margin-left: 74px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware (main source)</div></div></div></foreignObject><text x="145" y="39" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware (main source)</text></switch></g><rect x="71.4" y="330" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 355px; margin-left: 72px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="163" y="359" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 145.47 50 L 152.25 113.67" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 152.8 118.89 L 148.58 112.3 L 152.25 113.67 L 155.54 111.56 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 163 290 L 163 323.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 163 328.88 L 159.5 321.88 L 163 323.63 L 166.5 321.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
diff --git a/docs/img/components_selective.svg b/docs/img/components_selective.svg
new file mode 100644
index 00000000..30e17ba8
--- /dev/null
+++ b/docs/img/components_selective.svg
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="603px" height="402px" viewBox="-0.5 -0.5 603 402"><defs/><g><rect x="17" y="0" width="580" height="400" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="27" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp library</div></div></div></foreignObject><text x="157" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp library</text></switch></g><rect x="37" y="130" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp API</div></div></div></foreignObject><text x="157" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp API</text></switch></g><rect x="37" y="190" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="157" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="37" y="250" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="157" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="0" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 1px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="72" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="65.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 66px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="157" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 157 310 L 157 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 157 348.88 L 153.5 341.88 L 157 343.63 L 160.5 341.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 72.47 70 L 86.44 253.65" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 86.84 258.89 L 82.81 252.17 L 86.44 253.65 L 89.79 251.64 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="327" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 328px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp library</div></div></div></foreignObject><text x="457" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp library</text></switch></g><rect x="337" y="130" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp API</div></div></div></foreignObject><text x="457" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp API</text></switch></g><rect x="337" y="190" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="457" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="337" y="250" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="457" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="457" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 458px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="529" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="365.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 366px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="457" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 457 310 L 457 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 457 348.88 L 453.5 341.88 L 457 343.63 L 460.5 341.88 Z" fill-opacity="0.1" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="all"/><path d="M 529.47 70 L 517.98 143.71" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 517.17 148.9 L 514.79 141.44 L 517.98 143.71 L 521.71 142.52 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 448.42 270.5 L 465 270.5 L 465 318.36 L 475.5 318.36 L 456.71 339.5 L 437.92 318.36 L 448.42 318.36 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="397" y="344" width="120" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 359px; margin-left: 398px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">custom RPC framework</div></div></div></foreignObject><text x="457" y="363" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">custom RPC framework</text></switch></g><path d="M 307 70 L 307 330" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><rect x="27" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example A) Only RPC framework selected</div></div></div></foreignObject><text x="167" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example A) Only RPC framework selected</text></switch></g><rect x="307" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 308px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example B) OCPP logic selected</div></div></div></foreignObject><text x="447" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example B) OCPP logic selected</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
index ee151832..96fd85e6 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,25 +1,3 @@
-# Getting Started with ArduinoOcpp
+ArduinoOcpp is an OCPP client which runs on microcontrollers and enables EVSEs to participate in OCPP charging networks. As a software library, it can be added to the firmware of the EVSE and will become a new part of it. If the EVSE has already an internet controller, then most likely, no extra hardware is required.
 
-This chapter shows how to kick-start your project which deals with OCPP.
-
-## Installation prerequisites
-
-Throughout these document pages, it is assumed that you already have set up your development environment and that you are familiar with the corresponding building, flashing and (basic) debugging routines. ArduinoOcpp runs in many environments (from the Arduino-IDE to proprietary microcontroller IDEs like the Code Composer Studio). If you do not have any preferences yet, it is highly recommended to get started with VSCode + the PlatformIO add-on, since it is the favorite setup of the community and therefore you find the most related information in the Issues pages of the main repository.
-
-There are many high-quality tutorials for out there for setting up VSCode + PIO. The following site covers everything you need to know:
-[https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/](https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/)
-
-Once that's done, adding ArduinoOcpp is no big deal anymore. However, let's discuss another very important tool for your project first.
-
-## OCPP Server prerequisites
-
-ArduinoOcpp is just a client, but all the magic of OCPP lives in the communication between a client and a server. Although it *is* possible to run ArduinoOcpp without a real server for testing purposes, the best approach for getting started is to get the hands on a real server. So you can always use the client in a practical setup, see immediate results and simplify development a lot.
-
-Perhaps you were already given access to an OCPP server for your project. Then you can use that, it should work fine. If you don't have a server already, it is highly recommended to get
-SteVe ([https://github.com/steve-community/steve](https://github.com/steve-community/steve)).
-It allows to control every detail of the OCPP operations and shows detail-rich information about the results. And again, it is the favorite test server of the community, so you will find the most related information on the Web. For the installation instructions, please refer to the
-[SteVe docs](https://github.com/steve-community/steve#configuration-and-installation).
-
-In case you can't wait to get started, you can make the first connection test with a WebSocket echo server as a fake OCPP service. ArduinoOcpp supports that: it can send all messages to an echo server which reflects all traffic. ArduinoOcpp gets back its own messages and replies to itself with mocked responses. Complicated, but it does work and the console will show a valid OCPP communication. An example echo server is given in the following section. For the further development though, you will definitely need a real OCPP server.
-
-*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*
+<!-- This chapter shows how to kick-start your OCPP project. -->
diff --git a/docs/intro-tech.md b/docs/intro-tech.md
new file mode 100644
index 00000000..435296e9
--- /dev/null
+++ b/docs/intro-tech.md
@@ -0,0 +1,45 @@
+# Technical introduction
+
+This chapter covers everything you need to know to understand ArduinoOcpp.
+
+## Scope of ArduinoOcpp
+
+The OCPP specification defines a charger data model, operations on the data model and the resulting physical behavior on the charger side. ArduinoOcpp implements the full scope of OCPP, i.e. a minimalistic data store for the data model, the OCPP operations and an interface to the surrounding firmware.
+
+Another part of OCPP is its messaging mechanism, the so-called Remote Procedure Calls (RPC) framework. ArduinoOcpp also implements the specified RPC framework with the required guarantees of message delivery or the corresponding error handling.
+
+At the lowest layer, OCPP relies on standard WebSockets. ArduinoOcpp works with any WebSocket library and has a lean interface to integrate them.
+
+The high-level API in `ArduinoOcpp.h` bundles all touch points of the EVSE firmware with the OCPP library.
+
+<p style="text-align:center">
+    <img src="../img/components_overview.svg">
+    <br />
+    <em>Overview of the architecture</em>
+</p>
+
+## High-level OCPP support
+
+Being a full implementation of OCPP, ArduinoOcpp handles the OCPP communication, i.e. it sends OCPP requests and processes incoming OCPP requests autonomously. The messages are triggered by the internal data model and by input from the high-level API. Incoming OCPP requests are used to update the internal data model and if an action on the charger is required, the library signals that to the main firmware through the high-level API.
+
+In consequence, the high-level API decouples the main firmware from the OCPP communication and hides the operations. This has the following good reasons:
+
+- The high-level API guarantees correctnes of the OCPP integration. As soon as the charger adopts it properly, it is fully OCPP-compliant
+- The hardware-near design decreases the integration effort into the firmware hugely
+- The API won't change substantially for the OCPP 2.0.1 upgrade. The EVSE will get OCPP 2.0.1 support on the fly by a later firmware update
+
+## Customizability
+
+One core principle of the architecture of ArduinoOcpp is the customizability and the selective usage of its components.
+
+Selective usage of components means that the EVSE firmware can use parts of ArduinoOcpp and work with its own implementation for the rest. In that case only the selected parts of ArduinoOcpp will be compiled into the firmware. For example, the main firmware can use the RPC framework and build a custom implementation of the OCPP logic on top of it. This could be necessary if the OCPP behavior should be tightly coupled to other modules of the firmware. In a different scenario, the EVSE firmware could already contain an extensive RPC framework and the OCPP client should reuse it. Then, only the business logic and high-level API are of interest.
+
+<p style="text-align:center">
+    <img src="../img/components_selective.svg">
+    <br />
+    <em>Selective usage of ArduinoOcpp</em>
+</p>
+
+Customizations of the library allow to integrate use cases for which the high-level API is too restrictive. The high-level API is designed to provide a facade for the expected usage of the library, but since the charging sector is driven by innovation, new use cases for OCPP emerge every day. If a custom use case cannot be integrated on the API level, the main firmware can access the internal data structures of ArduinoOcpp and complement the required functionality or replace parts of the internal behavior with custom implementations which fits the concrete scenarios better.
+
+*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*
diff --git a/docs/prerequisites.md b/docs/prerequisites.md
new file mode 100644
index 00000000..c6ce821b
--- /dev/null
+++ b/docs/prerequisites.md
@@ -0,0 +1,33 @@
+# Development tools and basic prerequisites
+
+This page explains how to work with this library using the appropriate development tools. Skip it if your IDE is set up and you already have an OCPP test server.
+
+## Development tools prerequisites
+
+Throughout these document pages, it is assumed that you already have set up your development environment and that you are familiar with the corresponding building, flashing and (basic) debugging routines. ArduinoOcpp runs in many environments (from the Arduino-IDE to proprietary microcontroller IDEs like the Code Composer Studio). If you do not have any preferences yet, it is highly recommended to get started with VSCode + the PlatformIO add-on, since it is the favorite setup of the community and therefore you find the most related information in the Issues pages of the main repository.
+
+There are many high-quality tutorials for out there for setting up VSCode + PIO. The following site covers everything you need to know:
+[https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/](https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/)
+
+Once that's done, adding ArduinoOcpp is no big deal anymore. However, let's discuss another very important tool for your project first.
+
+## OCPP Server prerequisites
+
+ArduinoOcpp is just a client, but all the magic of OCPP lives in the communication between a client and a server. Although it *is* possible to run ArduinoOcpp without a real server for testing purposes, the best approach for getting started is to get the hands on a real server. So you can always use the client in a practical setup, see immediate results and simplify development a lot.
+
+Perhaps you were already given access to an OCPP server for your project. Then you can use that, it should work fine. If you don't have a server already, it is highly recommended to get
+SteVe ([https://github.com/steve-community/steve](https://github.com/steve-community/steve)).
+It allows to control every detail of the OCPP operations and shows detail-rich information about the results. And again, it is the favorite test server of the community, so you will find the most related information on the Web. For the installation instructions, please refer to the
+[SteVe docs](https://github.com/steve-community/steve#configuration-and-installation).
+
+In case you can't wait to get started, you can make the first connection test with a WebSocket echo server as a fake OCPP service. ArduinoOcpp supports that: it can send all messages to an echo server which reflects all traffic. ArduinoOcpp gets back its own messages and replies to itself with mocked responses. Complicated, but it does work and the console will show a valid OCPP communication. An example echo server is given in the following section. For the further development though, you will definitely need a real OCPP server.
+
+## Project structure
+
+ArduinoOcpp is a library, i.e. it is not a full firmware, but just solves one specific task in your project which is the OCPP connectivity. The project structure should reflect this: typically you download ArduinoOcpp into a libraries or dependencies subfolder, while the main part of the development takes place in a main source folder. All dependencies of ArduinoOcpp (i.e. ArduinoJson, see the dependencies sections) should be located in the same libraries or dependencies folder.
+
+When the include paths are correctly set up, you should be able `#include <ArduinoOcpp.h>` at the top of your own source files. This setup keeps the OCPP library source separate from your integration and gives the project a clear structure.
+
+## Dependency managers
+
+Currently, the PlatformIO dependency manager is supported. In the `platformio.ini` manifest, you can add `matth-x/ArduinoOcpp` to the `lib_deps` section.

From e598b299997dc8c96acd60c5cf37f656e115b5aa Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 4 Jun 2023 19:51:10 +0200
Subject: [PATCH 264/549] docs update

---
 docs/index.md      |  2 ++
 docs/intro-tech.md | 30 ++++++++++++++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/docs/index.md b/docs/index.md
index 96fd85e6..a87c0f7b 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,3 +1,5 @@
 ArduinoOcpp is an OCPP client which runs on microcontrollers and enables EVSEs to participate in OCPP charging networks. As a software library, it can be added to the firmware of the EVSE and will become a new part of it. If the EVSE has already an internet controller, then most likely, no extra hardware is required.
 
 <!-- This chapter shows how to kick-start your OCPP project. -->
+
+*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*
diff --git a/docs/intro-tech.md b/docs/intro-tech.md
index 435296e9..d7a81909 100644
--- a/docs/intro-tech.md
+++ b/docs/intro-tech.md
@@ -42,4 +42,34 @@ Selective usage of components means that the EVSE firmware can use parts of Ardu
 
 Customizations of the library allow to integrate use cases for which the high-level API is too restrictive. The high-level API is designed to provide a facade for the expected usage of the library, but since the charging sector is driven by innovation, new use cases for OCPP emerge every day. If a custom use case cannot be integrated on the API level, the main firmware can access the internal data structures of ArduinoOcpp and complement the required functionality or replace parts of the internal behavior with custom implementations which fits the concrete scenarios better.
 
+## Main-loop paradigm
+
+ArduinoOcpp works with the common main-loop execution model of microcontrollers. After initialization, the EVSE firmware most likely enters a main-loop and repeats it infinitely. To run ArduinoOcpp, a call to its loop function must be placed into the main loop of the firmware. Then at each main-loop iteration, ArduinoOcpp executes its internal routines, i.e. it processes input data, updates its data model, executes operations and creates new output data. The ArduinoOcpp loop function does not block the main loop but executes immediately. This library does not contain any delay functions. Some activities of the library spread over many loop iterations like the start of a charging session which needs to await the approval of an NFC card and a hardware diagnosis of the high power electronics for example. All activities in ArduinoOcpp support the distribution over many loop calls, leading to a pseudo-parallel execution behavior.
+
+No separate RTOS task is needed and ArduinoOcpp does not have an internal mechanism for multi-task synchronization. However, it is of course possible to create a dedicated OCPP task, as long as extra care is taken of the synchronization.
+
+## How the API works
+
+The high-level API consists of four parts:
+
+- **Library lifecycle**: The library has initialize functions with a few initialization options. Dynamic system components like the WebSocket adapter need to be set at initialization time. The deinitialize function reverts the library into an unitialized state. That's useful for memory inspection tools like valgrind or to disable the OCPP communication. The loop function also counts as part of the lifecycle management.
+- **Sensor Inputs**: EVSEs are mechanical systems with a variety of sensor information. OCPP is used to send parts of the sensor readings to the server. The other part of the sensor data flows into the local charger model of ArduinoOcpp where it is further processed. To update ArduinoOcpp with the input data from the sensors, the firmware needs to bind the sensors to the library. An *Input-binding*, or in short *Input*, is a function which transfers the current sensor value to ArduinoOcpp. Inputs are callback functions which read a specific sensor value and pass the value in the return statement. The firmware defines those callback functions for each sensor and adds them to ArduinoOcpp during initialization. After initialization, ArduinoOcpp uses the callbacks and executes them to fetch the most recent sensor values. <br/>
+This concept is reused for the data *Outputs* of the library to the firmware, where the callback applies output data from ArduinoOcpp to the firmware.
+- **Transaction management**: OCPP considers EVSEs as vending machines. To enable payment processing and the billing of the EVSE usage, all charging activity is assigned to transactions. A big portion of OCPP is about transactions, their prerequisites, runtime and their termination scenarios. The ArduinoOcpp API breaks transactions down into an initiation and termination function and gives a transparent view on the current process status, authorization result and offline behavior strategy. For non-commercial setups, the transaction mechanism is the same but has only informational purposes.
+- **Device management**: ArduinoOcpp implements the OCPP side of the device management operations. For the actual execution, the firmware needs to provide the charger-side implementations of the operations to ArduinoOcpp by passing handler functions to the API. For example, the OCPP server can restart the charger. Upon receipt of the request, ArduinoOcpp terminates the transactions and eventually triggers the system restart using the handler function which the firmware has provided through the high-level API.
+
+## Transaction safety
+
+Software in EVSEs needs to withstand hazardous operating conditions. EVSEs are located on the street or in garages where the WiFi or LTE signal strength is often weak, leading to long offline periods or where random power cuts can occur. In addition to that, the lack of process virtualization on microcontrollers means that a malfunction in one part of the firmware leads to the crash of all other parts.
+
+The transaction process of ArduinoOcpp is robust against random failures or resets. A minimal transaction log on the flash storage ensures that each operation on a transaction is fully executed. It will always result in a consistent state between the EVSE and the OCPP server, even over resets of the microcontroller. The RPC queue facilitates this by tracking the delivery status of relevant messages. If the microcontroller is reset while the delivery status of a message is unknown, ArduinoOcpp takes up the message delivery again at the next start up and completes it.
+
+A requirement for the transaction safety feature is the availability of a journaling file system. Examples include LittleFS, SPIFFS and the POSIX file API, but some microcontroller platforms don't support this natively, so an extension would be required.
+
+## Unit testing
+
+ArduinoOcpp includes a number of unit tests based on the [Catch2](https://github.com/catchorg/Catch2) framework. A [GitHub Action](https://github.com/matth-x/ArduinoOcpp/actions) runs the unit tests against each new commit in the ArduinoOcpp repository, which ensures that new features don't break old code.
+
+The scope of the unit tests is to to ensure a correct implementation of OCPP and to validate the high-level API against its definition. For that, it is not necessary to establish an actual test connection to an OCPP server. In fact, real-world communication would disturb the tests and make them undeterministic. That's why the test suite is fully based on an integrated, tiny OCPP test server which the OCPP client reaches over a loopback connection. The test suite does not access the WebSocket library. When making the unit tests of the main firmware, it is not necessary to check the full OCPP communication, but only to validate correct usage of the high-level API. An example of how the library can be initialized with a loopback connection can be found in its test suite.
+
 *Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*

From 31fe3bdf73a8f2a9517b8cf22cdbdf32e73b8386 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 4 Jun 2023 21:24:34 +0200
Subject: [PATCH 265/549] docs - optimization measures

---
 docs/index.md      | 4 ++++
 docs/intro-tech.md | 8 +++++++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/index.md b/docs/index.md
index a87c0f7b..108d37af 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,5 +1,9 @@
 ArduinoOcpp is an OCPP client which runs on microcontrollers and enables EVSEs to participate in OCPP charging networks. As a software library, it can be added to the firmware of the EVSE and will become a new part of it. If the EVSE has already an internet controller, then most likely, no extra hardware is required.
 
+[Technical introduction](intro-tech)
+
+[Development tools and basic prerequisites](prerequisites)
+
 <!-- This chapter shows how to kick-start your OCPP project. -->
 
 *Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*
diff --git a/docs/intro-tech.md b/docs/intro-tech.md
index d7a81909..eff6f2d6 100644
--- a/docs/intro-tech.md
+++ b/docs/intro-tech.md
@@ -72,4 +72,10 @@ ArduinoOcpp includes a number of unit tests based on the [Catch2](https://github
 
 The scope of the unit tests is to to ensure a correct implementation of OCPP and to validate the high-level API against its definition. For that, it is not necessary to establish an actual test connection to an OCPP server. In fact, real-world communication would disturb the tests and make them undeterministic. That's why the test suite is fully based on an integrated, tiny OCPP test server which the OCPP client reaches over a loopback connection. The test suite does not access the WebSocket library. When making the unit tests of the main firmware, it is not necessary to check the full OCPP communication, but only to validate correct usage of the high-level API. An example of how the library can be initialized with a loopback connection can be found in its test suite.
 
-*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*
+## Microcontroller optimization
+
+As a library for microcontrollers, the design of ArduinoOcpp considers the strict memory limits and complies with the best practices of embedded software development. Also, a few measures were taken to optimize the memory usage which include the spare inclusion of external libraries, an optimization of the internal data structures and the exclusion of C++ run-time type information (RTTI) and exceptions. Features of C++ which may have a larger footprint and are carefully used are the standard template library (STL) and lambda functions. In fact, lambdas proved to be a powerful tool to deal with the complexity of asynchronous data processing in embedded systems. That's also why the high-level API has many functional parameters.
+
+Because of the high importance of C in the embedded world, ArduinoOcpp provides its high-level API in C too. It is typically simple to instruct the compiler to compile and link the C++-based library in a C-based firmware development. In case that the firmware requires custom features which are not part of the C-API, then the firmware can implement it in a new C++ source file, export the new functions to the C namespace and use it normally in the main source.
+
+While memory constraints are of concern, the execution time generally is not. OCPP is rather uncomplex on the algorithmic side for clients, since there is no need for elaborate planning algorithms or data transformations.

From 782f6617301b694c157b74b64de85db077addb12 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 4 Jun 2023 21:27:32 +0200
Subject: [PATCH 266/549] link docs page

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 58c018ed..3b4ad0cf 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,8 @@ Try it (no hardware required): [ArduinoOcppSimulator](https://github.com/matth-x
 
 For simple chargers, the necessary hardware and internet integration is usually far below 1000 LOCs.
 
+Technical introduction: [ArduinoOcpp Docs](https://matth-x.github.io/ArduinoOcpp/intro-tech)
+
 ## Developers guide
 
 Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`ArduinoOcpp.h`](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h).

From 1daa434da16a5292bff2f8fd07e2145b5a4c76a7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 13 Jun 2023 10:00:34 +0200
Subject: [PATCH 267/549] add ErrorCode information

---
 .../MessagesV16/StatusNotification.cpp        |  6 +--
 .../MessagesV16/StatusNotification.h          |  4 +-
 .../Tasks/ChargeControl/Connector.cpp         | 52 +++++++++++++++----
 .../Tasks/ChargeControl/Connector.h           |  5 +-
 .../Tasks/ChargeControl/OcppEvseState.h       | 16 ++++++
 5 files changed, 68 insertions(+), 15 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index 4390f401..9bae2c0c 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -43,9 +43,9 @@ const char *cstrFromOcppEveState(OcppEvseState state) {
 }
 }} //end namespaces
 
-StatusNotification::StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, const char *errorCode) 
-  : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorCode(errorCode) {
-
+StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, ErrorCode errorCode)
+        : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorCode(errorCode) {
+    
     AO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
 }
 
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.h b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
index bbf8e941..61d4bbec 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.h
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.h
@@ -17,9 +17,9 @@ class StatusNotification : public Operation {
     int connectorId = 1;
     OcppEvseState currentStatus = OcppEvseState::NOT_SET;
     Timestamp timestamp;
-    const char *errorCode = nullptr; //nullptr is equivalent to "NoError"
+    ErrorCode errorCode;
 public:
-    StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, const char *errorCode = nullptr);
+    StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, ErrorCode errorCode = nullptr);
 
     const char* getOperationType();
 
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index 712ae010..7d2d72f0 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -69,7 +69,7 @@ OcppEvseState Connector::inferenceStatus() {
     * Handle special case: This is the Connector for the whole CP (i.e. connectorId=0) --> only states Available, Unavailable, Faulted are possible
     */
     if (connectorId == 0) {
-        if (getErrorCode() != nullptr) {
+        if (isFaulted()) {
             return OcppEvseState::Faulted;
         } else if (getAvailability() == AVAILABILITY_INOPERATIVE) {
             return OcppEvseState::Unavailable;
@@ -78,7 +78,7 @@ OcppEvseState Connector::inferenceStatus() {
         }
     }
 
-    if (getErrorCode() != nullptr) {
+    if (isFaulted()) {
         return OcppEvseState::Faulted;
     } else if (getAvailability() == AVAILABILITY_INOPERATIVE) {
         return OcppEvseState::Unavailable;
@@ -136,7 +136,7 @@ bool Connector::ocppPermitsCharge() {
     return transaction &&
             transaction->isRunning() &&
             transaction->isActive() &&
-            !getErrorCode() &&
+            !isFaulted() &&
             !suspendDeAuthorizedIdTag;
 }
 
@@ -221,7 +221,7 @@ void Connector::loop() {
 
             if (transaction->isActive() && transaction->isAuthorized() &&  //tx must be authorized
                     (!connectorPluggedSampler || connectorPluggedSampler()) && //if applicable, connector must be plugged
-                    !getErrorCode() && //only start tx if charger is free of error conditions
+                    !isFaulted() && //only start tx if charger is free of error conditions
                     (!startTxReadyInput || startTxReadyInput())) { //if defined, user Input for allowing StartTx must be true
                 //start Transaction
 
@@ -338,6 +338,25 @@ void Connector::loop() {
     }
 
     auto inferedStatus = inferenceStatus();
+
+    for (auto i = std::min(errorCodeInputs.size(), trackErrorCodeInputs.size()); i >= 1; i--) {
+        auto index = i - 1;
+        auto error = errorCodeInputs[index].operator();
+        if (error.isError && !trackErrorCodeInputs[index]) {
+            //new error
+            auto statusNotification = makeRequest(
+                    new StatusNotification(connectorId, inferedStatus, model.getClock().now(), error));
+            statusNotification->setTimeout(0);
+            context.initiateRequest(std::move(statusNotification));
+
+            currentStatus = inferedStatus;
+            reportedStatus = inferedStatus;
+            trackErrorCodeInputs[index] = true;
+        } else if (!error.isError && trackErrorCodeInputs[index]) {
+            //reset error
+            trackErrorCodeInputs[index] = false;
+        }
+    }
     
     if (inferedStatus != currentStatus) {
         currentStatus = inferedStatus;
@@ -363,11 +382,19 @@ void Connector::loop() {
     return;
 }
 
+bool Connector::isFaulted() {
+    for (auto i = errorCodeInputs.begin(); i != errorCodeInputs.end(); ++i) {
+        if (i->operator().isFaulted) {
+            return true;
+        }
+    }
+}
+
 const char *Connector::getErrorCode() {
-    for (auto s = connectorErrorCodeSamplers.begin(); s != connectorErrorCodeSamplers.end(); s++) {
-        const char *err = s->operator()();
-        if (err != nullptr) {
-            return err;
+    for (auto i = errorCodeInputs.size(); i >= 1; i--) {
+        auto error = errorCodeInputs[i-1]->operator();
+        if (error.isError && error.errorCode) {
+            return error.errorCode;
         }
     }
     return nullptr;
@@ -781,7 +808,14 @@ void Connector::setConnectorEnergizedSampler(std::function<bool()> connectorEner
 }
 
 void Connector::addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode) {
-    this->connectorErrorCodeSamplers.push_back(connectorErrorCode);
+    addConnectorErrorCodeInput([connectorErrorCode] () -> ErrorCode {
+        return ErrorCode(connectorErrorCode());
+    });
+}
+
+void Connector::addConnectorErrorCodeInput(std::function<ErrorCode ()> errorCodeInput) {
+    this->errorCodeInputs.push_back(errorCodeInput);
+    this->trackErrorCodeInputs.push_back(false);
 }
 
 void Connector::setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
index 31ad264e..b80ddc5f 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
@@ -40,7 +40,9 @@ class Connector {
     std::function<bool()> connectorPluggedSampler;
     std::function<bool()> evRequestsEnergySampler;
     std::function<bool()> connectorEnergizedSampler;
-    std::vector<std::function<const char *()>> connectorErrorCodeSamplers;
+    std::vector<std::function<ErrorCode ()>> errorCodeInputs;
+    std::vector<bool> trackErrorCodeInputs;
+    bool isFaulted();
     const char *getErrorCode();
 
     OcppEvseState currentStatus = OcppEvseState::NOT_SET;
@@ -104,6 +106,7 @@ class Connector {
     void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy);
     void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized);
     void addConnectorErrorCodeSampler(std::function<const char*()> connectorErrorCode);
+    void addConnectorErrorCodeInput(std::function<ErrorCode ()> errorCodeInput);
 
     void loop();
 
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h b/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
index e9e12e22..83d4123f 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
@@ -20,5 +20,21 @@ enum class OcppEvseState {
     NOT_SET //internal value for "undefined"
 };
 
+struct ErrorCode {
+    bool isError = false; //if any error information is set
+    bool isFaulted = false; //if this is a severe error and the EVSE should go into the faulted state
+    const char *errorCode = nullptr; //error code reported by the ChargePoint
+    const char *info = nullptr; //Additional free format information related to the error
+    const char *vendorId = nullptr; //vendor-specific implementation identifier
+    const char *vendorErrorCode = nullptr; //vendor-specific error code
+
+    ErrorCode(const char *errorCode) : errorCode(errorCode) {
+        if (errorCode) {
+            isError = true;
+            isFaulted = true;
+        }
+    }
+};
+
 } //end namespace ArduinoOcpp
 #endif

From 984ac5f5ffeafd73d3f522d14736dbce67a80b71 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 13 Jun 2023 10:28:12 +0200
Subject: [PATCH 268/549] fix ErrorCode information

---
 .../MessagesV16/StatusNotification.cpp        | 19 +++++++++++++++----
 .../Tasks/ChargeControl/Connector.cpp         |  6 +++---
 2 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
index 9bae2c0c..1b0fb083 100644
--- a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
+++ b/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
@@ -43,7 +43,7 @@ const char *cstrFromOcppEveState(OcppEvseState state) {
 }
 }} //end namespaces
 
-StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, ErrorCode errorCode)
+StatusNotification::StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, ErrorCode errorCode)
         : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorCode(errorCode) {
     
     AO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
@@ -55,12 +55,23 @@ const char* StatusNotification::getOperationType(){
 
 //TODO if the status has changed again when sendReq() is called, abort the operation completely (note: if req is already sent, stick with listening to conf). The OcppEvseStateService will enqueue a new operation itself
 std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4) + (JSONDATE_LENGTH + 1)));
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(7) + (JSONDATE_LENGTH + 1)));
     JsonObject payload = doc->to<JsonObject>();
     
     payload["connectorId"] = connectorId;
-    if (errorCode != nullptr) {
-        payload["errorCode"] = errorCode;
+    if (errorCode.isError) {
+        if (errorCode.errorCode) {
+            payload["errorCode"] = errorCode.errorCode;
+        }
+        if (errorCode.info) {
+            payload["info"] = errorCode.info;
+        }
+        if (errorCode.vendorId) {
+            payload["vendorId"] = errorCode.vendorId;
+        }
+        if (errorCode.vendorErrorCode) {
+            payload["vendorErrorCode"] = errorCode.vendorErrorCode;
+        }
     } else if (currentStatus == OcppEvseState::NOT_SET) {
         AO_DBG_ERR("Reporting undefined status");
         payload["errorCode"] = "InternalError";
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index 7d2d72f0..d83d3e54 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -341,7 +341,7 @@ void Connector::loop() {
 
     for (auto i = std::min(errorCodeInputs.size(), trackErrorCodeInputs.size()); i >= 1; i--) {
         auto index = i - 1;
-        auto error = errorCodeInputs[index].operator();
+        auto error = errorCodeInputs[index].operator()();
         if (error.isError && !trackErrorCodeInputs[index]) {
             //new error
             auto statusNotification = makeRequest(
@@ -384,7 +384,7 @@ void Connector::loop() {
 
 bool Connector::isFaulted() {
     for (auto i = errorCodeInputs.begin(); i != errorCodeInputs.end(); ++i) {
-        if (i->operator().isFaulted) {
+        if (i->operator()().isFaulted) {
             return true;
         }
     }
@@ -392,7 +392,7 @@ bool Connector::isFaulted() {
 
 const char *Connector::getErrorCode() {
     for (auto i = errorCodeInputs.size(); i >= 1; i--) {
-        auto error = errorCodeInputs[i-1]->operator();
+        auto error = errorCodeInputs[i-1].operator()();
         if (error.isError && error.errorCode) {
             return error.errorCode;
         }

From f8a0496a0e8e27510f9393368147779dba1c71fa Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 13 Jun 2023 11:10:44 +0200
Subject: [PATCH 269/549] fix Error codes

---
 src/ArduinoOcpp/Core/Configuration.cpp            |  2 +-
 src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp | 10 ++++++----
 src/ArduinoOcpp/Tasks/ChargeControl/Connector.h   |  2 +-
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 3eda35c6..0eef3aa9 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -106,7 +106,7 @@ std::shared_ptr<Configuration<T>> declareConfiguration(const char *key, T defaul
     std::shared_ptr<AbstractConfiguration> configuration = container->getConfiguration(key);
 
     if (configuration && strcmp(configuration->getSerializedType(), SerializedType<T>::get())) {
-        AO_DBG_ERR("conflicting declared types. Discard old config");
+        AO_DBG_ERR("conflicting declared types for %s. Discard old config", key);
         container->removeConfiguration(configuration);
         configuration = nullptr;
     }
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index d83d3e54..7ff3939e 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -383,11 +383,13 @@ void Connector::loop() {
 }
 
 bool Connector::isFaulted() {
-    for (auto i = errorCodeInputs.begin(); i != errorCodeInputs.end(); ++i) {
-        if (i->operator()().isFaulted) {
+    //for (auto i = errorCodeInputs.begin(); i != errorCodeInputs.end(); ++i) {
+    for (size_t i = 0; i < errorCodeInputs.size(); i++) {
+        if (errorCodeInputs[i].operator()().isFaulted) {
             return true;
         }
     }
+    return false;
 }
 
 const char *Connector::getErrorCode() {
@@ -808,12 +810,12 @@ void Connector::setConnectorEnergizedSampler(std::function<bool()> connectorEner
 }
 
 void Connector::addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode) {
-    addConnectorErrorCodeInput([connectorErrorCode] () -> ErrorCode {
+    addErrorCodeInput([connectorErrorCode] () -> ErrorCode {
         return ErrorCode(connectorErrorCode());
     });
 }
 
-void Connector::addConnectorErrorCodeInput(std::function<ErrorCode ()> errorCodeInput) {
+void Connector::addErrorCodeInput(std::function<ErrorCode ()> errorCodeInput) {
     this->errorCodeInputs.push_back(errorCodeInput);
     this->trackErrorCodeInputs.push_back(false);
 }
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
index b80ddc5f..73050c18 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
@@ -106,7 +106,7 @@ class Connector {
     void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy);
     void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized);
     void addConnectorErrorCodeSampler(std::function<const char*()> connectorErrorCode);
-    void addConnectorErrorCodeInput(std::function<ErrorCode ()> errorCodeInput);
+    void addErrorCodeInput(std::function<ErrorCode ()> errorCodeInput);
 
     void loop();
 

From 0ddd1a3e4ecb5857e5bb5479793fbba251081b7d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 13 Jun 2023 19:27:36 +0200
Subject: [PATCH 270/549] fixes testing

---
 src/ArduinoOcpp.cpp                              |  2 --
 src/ArduinoOcpp/Core/Model.cpp                   |  3 +++
 src/ArduinoOcpp/Core/Time.cpp                    |  1 +
 .../MessagesV16/RemoteStartTransaction.cpp       |  2 +-
 .../Tasks/ChargeControl/OcppEvseState.h          |  2 ++
 .../Metering/ConnectorMeterValuesRecorder.cpp    |  8 --------
 .../Metering/ConnectorMeterValuesRecorder.h      |  6 ------
 .../Tasks/Metering/MeteringService.cpp           | 16 ----------------
 src/ArduinoOcpp/Tasks/Metering/MeteringService.h |  4 ----
 src/ArduinoOcpp/Tasks/Transactions/Transaction.h |  2 +-
 10 files changed, 8 insertions(+), 38 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index a4bac396..0434ea41 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -325,7 +325,6 @@ void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connec
             [energyInput] (ReadingContext) {return energyInput();}
     ));
     model.getMeteringService()->addMeterValueSampler(connectorId, std::move(mvs));
-    model.getMeteringService()->setEnergySampler(connectorId, energyInput);
 }
 
 void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId) {
@@ -348,7 +347,6 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
             [powerInput] (ReadingContext) {return powerInput();}
     ));
     model.getMeteringService()->addMeterValueSampler(connectorId, std::move(mvs));
-    model.getMeteringService()->setPowerSampler(connectorId, powerInput);
 }
 
 void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
diff --git a/src/ArduinoOcpp/Core/Model.cpp b/src/ArduinoOcpp/Core/Model.cpp
index ba74fd7d..2d14160e 100644
--- a/src/ArduinoOcpp/Core/Model.cpp
+++ b/src/ArduinoOcpp/Core/Model.cpp
@@ -59,6 +59,9 @@ void Model::loop() {
     
     if (reservationService)
         reservationService->loop();
+    
+    if (resetService)
+        resetService->loop();
 }
 
 void Model::setTransactionStore(std::unique_ptr<TransactionStore> ts) {
diff --git a/src/ArduinoOcpp/Core/Time.cpp b/src/ArduinoOcpp/Core/Time.cpp
index fac883cf..86afbb90 100644
--- a/src/ArduinoOcpp/Core/Time.cpp
+++ b/src/ArduinoOcpp/Core/Time.cpp
@@ -134,6 +134,7 @@ bool Timestamp::toJsonString(char *jsonDateString, size_t buffsize) const {
     jsonDateString[21] = ((char) ((ms / 10) % 10))  + '0';
     jsonDateString[22] = ((char) ((ms / 1) % 10))  + '0';
     jsonDateString[23] = 'Z';
+    jsonDateString[24] = '\0';
 
     return true;
 }
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
index 01284874..b80f75c2 100644
--- a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
@@ -96,7 +96,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         }
 
         if (auto connector = model.getConnector(connectorId)) {
-            connector->beginTransaction(idTag);
+            connector->beginTransaction_authorized(idTag);
         }
 
         if (!chargingProfileDoc.isNull()
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h b/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
index 83d4123f..1bd7db24 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
@@ -28,6 +28,8 @@ struct ErrorCode {
     const char *vendorId = nullptr; //vendor-specific implementation identifier
     const char *vendorErrorCode = nullptr; //vendor-specific error code
 
+    ErrorCode() = default;
+
     ErrorCode(const char *errorCode) : errorCode(errorCode) {
         if (errorCode) {
             isError = true;
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
index 1c3a0d8d..9c394d89 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
@@ -228,14 +228,6 @@ Operation *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
     return new MeterValues(std::move(mv_now), connectorId, transaction);
 }
 
-void ConnectorMeterValuesRecorder::setPowerSampler(PowerSampler ps){
-    this->powerSampler = ps;
-}
-
-void ConnectorMeterValuesRecorder::setEnergySampler(EnergySampler es){
-    this->energySampler = es;
-}
-
 void ConnectorMeterValuesRecorder::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
     if (!meterValueSampler->getProperties().getMeasurand().compare("Energy.Active.Import.Register")) {
         energySamplerIndex = samplers.size();
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
index a8b2ba08..1610704c 100644
--- a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
@@ -48,8 +48,6 @@ class ConnectorMeterValuesRecorder {
     std::shared_ptr<Transaction> transaction;
     bool trackTxRunning = false;
  
-    PowerSampler powerSampler = nullptr;
-    EnergySampler energySampler = nullptr;
     std::vector<std::unique_ptr<SampledValueSampler>> samplers;
     int energySamplerIndex {-1};
 
@@ -65,10 +63,6 @@ class ConnectorMeterValuesRecorder {
 
     Operation *loop();
 
-    void setPowerSampler(PowerSampler powerSampler);
-
-    void setEnergySampler(EnergySampler energySampler);
-
     void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler);
 
     std::unique_ptr<SampledValue> readTxEnergyMeter(ReadingContext context);
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
index 5fc17d10..3f55f244 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
@@ -40,22 +40,6 @@ void MeteringService::loop(){
     }
 }
 
-void MeteringService::setPowerSampler(int connectorId, PowerSampler ps){
-    if (connectorId < 0 || connectorId >= (int) connectors.size()) {
-        AO_DBG_ERR("connectorId is out of bounds");
-        return;
-    }
-    connectors[connectorId]->setPowerSampler(ps);
-}
-
-void MeteringService::setEnergySampler(int connectorId, EnergySampler es){
-    if (connectorId < 0 || connectorId >= (int) connectors.size()) {
-        AO_DBG_ERR("connectorId is out of bounds");
-        return;
-    }
-    connectors[connectorId]->setEnergySampler(es);
-}
-
 void MeteringService::addMeterValueSampler(int connectorId, std::unique_ptr<SampledValueSampler> meterValueSampler) {
     if (connectorId < 0 || connectorId >= (int) connectors.size()) {
         AO_DBG_ERR("connectorId is out of bounds");
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
index 86a4b2c8..180807af 100644
--- a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Tasks/Metering/MeteringService.h
@@ -33,10 +33,6 @@ class MeteringService {
 
     void loop();
 
-    void setPowerSampler(int connectorId, PowerSampler powerSampler);
-
-    void setEnergySampler(int connectorId, EnergySampler energySampler);
-
     void addMeterValueSampler(int connectorId, std::unique_ptr<SampledValueSampler> meterValueSampler);
 
     std::unique_ptr<SampledValue> readTxEnergyMeter(int connectorId, ReadingContext reason);
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
index 13feb8b7..622c4423 100644
--- a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Tasks/Transactions/Transaction.h
@@ -128,7 +128,7 @@ class Transaction {
     void setStartTimestamp(Timestamp timestamp) {start_timestamp = timestamp;}
     const Timestamp& getStartTimestamp() {return start_timestamp;}
 
-    void setTransactionId(int transactionId) {transactionId = transactionId;}
+    void setTransactionId(int transactionId) {this->transactionId = transactionId;}
 
     SendStatus& getStopSync() {return stop_sync;}
 

From 2a00a8e04d4b5c29235b3870a15162cc0a73f7fa Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 13 Jun 2023 23:34:49 +0200
Subject: [PATCH 271/549] docs update

---
 docs/intro-tech.md |  6 ++++--
 docs/modules.md    | 27 +++++++++++++++++++++++++++
 2 files changed, 31 insertions(+), 2 deletions(-)
 create mode 100644 docs/modules.md

diff --git a/docs/intro-tech.md b/docs/intro-tech.md
index eff6f2d6..8729cf80 100644
--- a/docs/intro-tech.md
+++ b/docs/intro-tech.md
@@ -74,8 +74,10 @@ The scope of the unit tests is to to ensure a correct implementation of OCPP and
 
 ## Microcontroller optimization
 
-As a library for microcontrollers, the design of ArduinoOcpp considers the strict memory limits and complies with the best practices of embedded software development. Also, a few measures were taken to optimize the memory usage which include the spare inclusion of external libraries, an optimization of the internal data structures and the exclusion of C++ run-time type information (RTTI) and exceptions. Features of C++ which may have a larger footprint and are carefully used are the standard template library (STL) and lambda functions. In fact, lambdas proved to be a powerful tool to deal with the complexity of asynchronous data processing in embedded systems. That's also why the high-level API has many functional parameters.
+As a library for microcontrollers, the design of ArduinoOcpp considers the strict memory limits and complies with the best practices of embedded software development. Also, a few measures were taken to optimize the memory usage which include the spare inclusion of external libraries, an optimization of the internal data structures and the exclusion of C++ run-time type information (RTTI) and exceptions. Features of C++ which may have a larger footprint are carefully used such as the standard template library (STL) and lambda functions. The STL increases the robustness of the code and lambdas prove to be a powerful tool to deal with the complexity of asynchronous data processing in embedded systems. That's also why the high-level API has many functional parameters.
 
 Because of the high importance of C in the embedded world, ArduinoOcpp provides its high-level API in C too. It is typically simple to instruct the compiler to compile and link the C++-based library in a C-based firmware development. In case that the firmware requires custom features which are not part of the C-API, then the firmware can implement it in a new C++ source file, export the new functions to the C namespace and use it normally in the main source.
 
-While memory constraints are of concern, the execution time generally is not. OCPP is rather uncomplex on the algorithmic side for clients, since there is no need for elaborate planning algorithms or data transformations.
+While memory constraints are of concern, the execution time generally is not. OCPP is rather uncomplex on the algorithmic side for clients, since there is no need for elaborate planning algorithms or complex data transformations.
+
+Although ArduinoOcpp is optimized for the usage on microcontrollers, it is also suitable for embedded Linux systems. With more memory available, the upper limits of the internal data structures can be increased, leading to a more versatile support of charging use cases. Also, the separation of the charger firmware into multiple processes can lead to more robustness. ArduinoOcpp can be extended by an inter-process communication (IPC) interface to run in a separate process.
diff --git a/docs/modules.md b/docs/modules.md
new file mode 100644
index 00000000..2f578138
--- /dev/null
+++ b/docs/modules.md
@@ -0,0 +1,27 @@
+# Internal datastructures
+
+The API exposes some of the internal datastructures to the main firmware. This chapter gives an overview of their fields and shows how to use them to achieve the desired behavior.
+
+## Context object
+
+The *Context* wraps all runtime data of ArduinoOcpp. Every data object this library creates (except only the Configuration) can be rechaed through the Context instance. So it is the basic entry point to the internals of the library. The structure of the context follows the main architecture as described in [this introduction](intro-tech) and consists of the Request queue and message deserializer for the RPC framework and the Model object for the OCPP model and behavior (see below).
+
+When the library is initialized, `getOcppContext()` returns the current Context object.
+
+## Model object
+
+The *Model* represents the OCPP device model and behavior. OCPP defines a rough charger model, i.e. the hardware parts of the charger and their basic functionality in relation to the OCPP operations. Furthermore, OCPP specifies a few only software related features like the reservation of the charger. This charger model is implemented as straightforward C++ data structures and corresponding algorithms.
+
+Following the structure of the feature profiles in OCPP, the model implementation is split into functional blocks in ArduinoOcpp as well. Each functional block has a top-level *Service* class, executing the behavior in their scope. Consequently, the *Model* object is composed of *Service* objects, it owns them and provides access to them. The following subsections contain a description of each function block.
+
+### Authorization
+
+The *AuthorizationService* manages the authorization information of user identifiers or *idTags*. If the local authorization features of OCPP are enabled, then this Service stores a whitelist and blacklist of *idTags* or maintains a cache of recently authorized identifiers. A further responsibility is to determine if the given authorization data is still valid according to the rules in the OCPP specification.
+
+A single *idTag* and its authorization information is represented by the *AuthorizationData* class. It has public getter functions to retreive the authorization information. The list containing those entries is implemented in the *AuthorizationList* class. It has a search function for the *AuthorizationData* by *idTag*.
+
+### Boot
+
+The **BootService** implements the behavior around the *BootNotification* message.
+
+*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*

From 1d146b36ed25036726c8e5bcd7e6435268f11001 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 15 Jun 2023 20:06:54 +0200
Subject: [PATCH 272/549] testing fixes

---
 src/ArduinoOcpp.cpp                           |   9 +-
 .../Tasks/ChargeControl/Connector.cpp         |  21 ++-
 .../FirmwareManagement/FirmwareService.cpp    | 128 +++++++++---------
 .../FirmwareManagement/FirmwareService.h      |  14 +-
 src/ArduinoOcpp/Tasks/Reset/ResetService.cpp  |  13 ++
 5 files changed, 104 insertions(+), 81 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 0434ea41..40157275 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -157,10 +157,11 @@ void OCPP_initialize(Connection& connection, const char *bootNotificationCredent
         new ReservationService(*context, AO_NUMCONNECTORS)));
     model.setResetService(std::unique_ptr<ResetService>(
         new ResetService(*context)));
+
     
 #if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
-        EspWiFi::makeFirmwareService(*context, "1234578901"))); //instantiate FW service + ESP installation routine
+        EspWiFi::makeFirmwareService(*context))); //instantiate FW service + ESP installation routine
 #else
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
         new FirmwareService(*context))); //only instantiate FW service
@@ -180,6 +181,12 @@ void OCPP_initialize(Connection& connection, const char *bootNotificationCredent
 #endif
 
     model.getBootService()->setChargePointCredentials(bootNotificationCredentials);
+
+    auto credsJson = model.getBootService()->getChargePointCredentials();
+    if (credsJson && credsJson->containsKey("firmwareVersion")) {
+        model.getFirmwareService()->setBuildNumber((*credsJson)["firmwareVersion"]);
+    }
+    credsJson.reset();
 }
 
 void OCPP_deinitialize() {
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
index 7ff3939e..b54a118e 100644
--- a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
@@ -702,22 +702,21 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
 
 void Connector::endTransaction(const char *reason) {
 
-    if (!transaction) {
-        AO_DBG_WARN("Cannot end session if no transaction running");
+    if (!transaction || !transaction->isActive()) {
+        //transaction already ended / not active anymore
         return;
     }
 
-    if (transaction->isActive()) {
-        AO_DBG_DEBUG("End session with idTag %s for reason %s, %s previous reason",
-                                transaction->getIdTag(), reason ? reason : "undefined",
-                                *transaction->getStopReason() ? "overruled by" : "no");
+    AO_DBG_DEBUG("End session with idTag %s for reason %s, %s previous reason",
+                            transaction->getIdTag(), reason ? reason : "undefined",
+                            *transaction->getStopReason() ? "overruled by" : "no");
 
-        if (reason) {
-            transaction->setStopReason(reason);
-        }
-        transaction->setInactive();
-        transaction->commit();
+    if (reason) {
+        transaction->setStopReason(reason);
     }
+    
+    transaction->setInactive();
+    transaction->commit();
 }
 
 const char *Connector::getSessionIdTag() {
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index d37752b4..b0364a15 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -6,6 +6,7 @@
 #include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Core/Model.h>
 #include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/OperationRegistry.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
@@ -16,6 +17,11 @@
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
 
+//debug option: update immediately and don't wait for the retreive date
+#ifndef AO_IGNORE_FW_RETR_DATE
+#define AO_IGNORE_FW_RETR_DATE 0
+#endif
+
 using namespace ArduinoOcpp;
 using ArduinoOcpp::Ocpp16::FirmwareStatus;
 
@@ -42,7 +48,7 @@ void FirmwareService::setBuildNumber(const char *buildNumber) {
     if (buildNumber == nullptr)
         return;
     this->buildNumber = buildNumber;
-    previousBuildNumber = declareConfiguration<const char*>("BUILD_NUMBER", buildNumber, AO_KEYVALUE_FN, false, false, true, false);
+    previousBuildNumber = declareConfiguration<const char*>("BUILD_NUMBER", this->buildNumber.c_str(), AO_KEYVALUE_FN, false, false, true, false);
     checkedSuccessfulFwUpdate = false; //--> CS will be notified
 }
 
@@ -56,10 +62,9 @@ void FirmwareService::loop() {
         return;
     }
 
-    Timestamp timestampNow = context.getModel().getClock().now();
+    auto& timestampNow = context.getModel().getClock().now();
     if (retries > 0 && timestampNow >= retreiveDate) {
 
-        //if (!downloadIssued) {
         if (stage == UpdateStage::Idle) {
             AO_DBG_INFO("Start update");
 
@@ -78,57 +83,49 @@ void FirmwareService::loop() {
             }
         }
 
-        //if (!onDownloadCalled) {
         if (stage == UpdateStage::AwaitDownload) {
             AO_DBG_INFO("Start download");
             stage = UpdateStage::Downloading;
             if (onDownload != nullptr) {
                 onDownload(location);
                 timestampTransition = ao_tick_ms();
-                delayTransition = 30000; //give the download at least 30s
+                delayTransition = downloadStatusSampler ? 1000 : 30000; //give the download at least 30s
                 return;
             }
         }
 
-        const int DOWNLOAD_TIMEOUT = 120;
-        //if (downloadIssued && !installationIssued &&
         if (stage == UpdateStage::Downloading) {
 
-            //check if client reports download to be finished
-            if (downloadStatusSampler != nullptr && downloadStatusSampler() == DownloadStatus::Downloaded) {
-                stage = UpdateStage::AfterDownload;
-            }
+            if (downloadStatusSampler) {
+                //check if client reports download to be finished
 
-            //if client doesn't report download state, assume download to be finished (at least 30s download time have passed until here)
-            if (downloadStatusSampler == nullptr) {
-                stage = UpdateStage::AfterDownload;
-            }
-
-            //check for timeout or error condition
-            if (timestampNow - retreiveDate >= DOWNLOAD_TIMEOUT
-                    || (downloadStatusSampler != nullptr && downloadStatusSampler() == DownloadStatus::DownloadFailed)) {
-                
-                AO_DBG_INFO("Download timeout or failed! Retry");
-                if (retryInterval < DOWNLOAD_TIMEOUT)
+                if (downloadStatusSampler() == DownloadStatus::Downloaded) {
+                    //passed download stage
+                    stage = UpdateStage::AfterDownload;
+                } else if (downloadStatusSampler() == DownloadStatus::DownloadFailed) {
+                    AO_DBG_INFO("Download timeout or failed! Retry");
                     retreiveDate = timestampNow;
-                else
                     retreiveDate += retryInterval;
-                retries--;
-                resetStage();
+                    retries--;
+                    resetStage();
 
-                timestampTransition = ao_tick_ms();
-                delayTransition = 10000;
-                return;
+                    timestampTransition = ao_tick_ms();
+                    delayTransition = 10000;
+                    return;
+                }
+            } else {
+                //if client doesn't report download state, assume download to be finished (at least 30s download time have passed until here)
+                if (downloadStatusSampler == nullptr) {
+                    stage = UpdateStage::AfterDownload;
+                }
             }
-
         }
 
-        //if (!installationIssued) {
         if (stage == UpdateStage::AfterDownload) {
             bool ongoingTx = false;
             for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
                 auto connector = context.getModel().getConnector(cId);
-                if (connector && connector->getTransactionId() >= 0) {
+                if (connector && connector->getTransaction() && connector->getTransaction()->isRunning()) {
                     ongoingTx = true;
                     break;
                 }
@@ -149,44 +146,41 @@ void FirmwareService::loop() {
             AO_DBG_INFO("Installing");
             stage = UpdateStage::Installing;
 
-            if (onInstall != nullptr) {
+            if (onInstall) {
                 onInstall(location); //should restart the device on success
             } else {
                 AO_DBG_WARN("onInstall must be set! (see setOnInstall). Will abort");
             }
 
             timestampTransition = ao_tick_ms();
-            delayTransition = 40000;
+            delayTransition = installationStatusSampler ? 1000 : 120 * 1000;
             return;
         }
 
         if (stage == UpdateStage::Installing) {
 
-            //check if client reports installation to be finished
-            if (installationStatusSampler == nullptr || installationStatusSampler() == InstallationStatus::Installed) {
-                        //if client doesn't report installation state, assume download to be finished (at least 40s installation time have passed until here)
-                
-                //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
-                resetStage();
-                retries = 0; //End of update routine. Client must reboot on its own
-                return;
-            }
-
-            //check for timeout or error condition
-            const int INSTALLATION_TIMEOUT = 120;
-            if ((timestampNow - retreiveDate >= INSTALLATION_TIMEOUT + DOWNLOAD_TIMEOUT)
-                    || (installationStatusSampler != nullptr && installationStatusSampler() == InstallationStatus::InstallationFailed)) {
-
-                AO_DBG_INFO("Installation timeout or failed! Retry");
-                if (retryInterval < INSTALLATION_TIMEOUT + DOWNLOAD_TIMEOUT)
+            if (installationStatusSampler) {
+                if (installationStatusSampler() == InstallationStatus::Installed) {
+                    AO_DBG_INFO("FW update finished");
+                    //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
+                    resetStage();
+                    retries = 0; //End of update routine. Client must reboot on its own
+                } else if (installationStatusSampler() == InstallationStatus::InstallationFailed) {
+                    AO_DBG_INFO("Installation timeout or failed! Retry");
                     retreiveDate = timestampNow;
-                else
                     retreiveDate += retryInterval;
-                retries--;
-                resetStage();
+                    retries--;
+                    resetStage();
 
-                timestampTransition = ao_tick_ms();
-                delayTransition = 10000;
+                    timestampTransition = ao_tick_ms();
+                    delayTransition = 10000;
+                }
+                return;
+            } else {
+                AO_DBG_INFO("FW update finished");
+                //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
+                resetStage();
+                retries = 0; //End of update routine. Client must reboot on its own
                 return;
             }
         }
@@ -204,6 +198,11 @@ void FirmwareService::scheduleFirmwareUpdate(const std::string &location, Timest
     this->retries = retries;
     this->retryInterval = retryInterval;
 
+    if (AO_IGNORE_FW_RETR_DATE) {
+        AO_DBG_DEBUG("ignore FW update retreive date");
+        this->retreiveDate = context.getModel().getClock().now();
+    }
+
     char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
     this->retreiveDate.toJsonString(dbuf, JSONDATE_LENGTH + 1);
 
@@ -217,6 +216,9 @@ void FirmwareService::scheduleFirmwareUpdate(const std::string &location, Timest
             this->retries,
             this->retryInterval);
 
+    timestampTransition = ao_tick_ms();
+    delayTransition = 1000;
+
     resetStage();
 }
 
@@ -252,15 +254,19 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
     /*
      * Check if FW has been updated previously, but only once
      */
-    if (!checkedSuccessfulFwUpdate && buildNumber != nullptr && previousBuildNumber != nullptr) {
+    if (!checkedSuccessfulFwUpdate && !buildNumber.empty() && previousBuildNumber != nullptr) {
         checkedSuccessfulFwUpdate = true;
+
+        AO_DBG_DEBUG("Previous build number: %s, new build number: %s", *previousBuildNumber, buildNumber.c_str());
         
         size_t buildNoSize = previousBuildNumber->getBuffsize();
-        if (strncmp(buildNumber, *previousBuildNumber, buildNoSize)) {
+        if (strncmp(buildNumber.c_str(), *previousBuildNumber, buildNoSize)) {
             //new FW
-            previousBuildNumber->setValue(buildNumber, strlen(buildNumber) + 1);
+            previousBuildNumber->setValue(buildNumber.c_str(), buildNumber.length() + 1);
             configuration_save();
 
+            buildNumber.clear();
+
             lastReportedStatus = FirmwareStatus::Installed;
             Operation *fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
             auto fwNotification = makeRequest(fwNotificationMsg);
@@ -307,9 +313,8 @@ void FirmwareService::resetStage() {
 
 #include <HTTPUpdate.h>
 
-FirmwareService *EspWiFi::makeFirmwareService(Context& context, const char *buildNumber) {
+FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
     FirmwareService *fwService = new FirmwareService(context);
-    fwService->setBuildNumber(buildNumber);
 
     /*
      * example of how to integrate a separate download phase (optional)
@@ -370,9 +375,8 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context, const char *buil
 
 #include <ESP8266httpUpdate.h>
 
-FirmwareService *EspWiFi::makeFirmwareService(Context& context, const char *buildNumber) {
+FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
     FirmwareService *fwService = new FirmwareService(context);
-    fwService->setBuildNumber(buildNumber);
 
     fwService->setOnInstall([fwService] (const std::string &location) {
         
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
index 1e08e028..a2440787 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
@@ -33,13 +33,13 @@ class FirmwareService {
 private:
     Context& context;
     
-    std::shared_ptr<Configuration<const char *>> previousBuildNumber = NULL;
-    const char *buildNumber = NULL;
+    std::shared_ptr<Configuration<const char *>> previousBuildNumber;
+    std::string buildNumber;
 
-    std::function<DownloadStatus()> downloadStatusSampler = NULL;
+    std::function<DownloadStatus()> downloadStatusSampler;
     bool downloadIssued = false;
 
-    std::function<InstallationStatus()> installationStatusSampler = NULL;
+    std::function<InstallationStatus()> installationStatusSampler;
     bool installationIssued = false;
 
     Ocpp16::FirmwareStatus lastReportedStatus = Ocpp16::FirmwareStatus::Idle;
@@ -50,8 +50,8 @@ class FirmwareService {
     int retries = 0;
     unsigned int retryInterval = 0;
 
-    std::function<bool(const std::string &location)> onDownload = NULL;
-    std::function<bool(const std::string &location)> onInstall = NULL;
+    std::function<bool(const std::string &location)> onDownload;
+    std::function<bool(const std::string &location)> onInstall;
 
     unsigned long delayTransition = 0;
     unsigned long timestampTransition = 0;
@@ -97,7 +97,7 @@ class FirmwareService {
 namespace ArduinoOcpp {
 namespace EspWiFi {
 
-FirmwareService *makeFirmwareService(Context& context, const char *buildNumber);
+FirmwareService *makeFirmwareService(Context& context);
 
 }
 }
diff --git a/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp b/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
index 1df88693..e1cfadad 100644
--- a/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
+++ b/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
@@ -55,6 +55,19 @@ void ResetService::loop() {
                 auto connector = context.getModel().getConnector(cId);
                 connector->setAvailabilityVolatile(true);
             }
+
+            OcppEvseState cpStatus = OcppEvseState::NOT_SET;
+            if (context.getModel().getNumConnectors() > 0) {
+                cpStatus = context.getModel().getConnector(0)->inferenceStatus();
+            }
+
+            auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
+                        0,
+                        cpStatus, //will be determined in StatusNotification::initiate
+                        context.getModel().getClock().now(),
+                        "ResetFailure"));
+            statusNotification->setTimeout(60000);
+            context.initiateRequest(std::move(statusNotification));
         }
     }
 }

From 70479e2cf82bd7269ed83d670bbd2a1ba2cde249 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 15 Jun 2023 23:23:02 +0200
Subject: [PATCH 273/549] fix AO_DEACTIVATE_FLASH define

---
 src/ArduinoOcpp/Core/FilesystemAdapter.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index 31fcce3f..b9a0a286 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -42,8 +42,6 @@ class FilesystemAdapter {
 
 } //end namespace ArduinoOcpp
 
-#ifndef AO_DEACTIVATE_FLASH
-
 // choose FileAPI if not given by build flag; assume usage with Arduino if no build flags are present
 #ifndef AO_USE_FILEAPI
 #if AO_PLATFORM == AO_PLATFORM_ARDUINO
@@ -68,6 +66,8 @@ class FilesystemAdapter {
 #endif
 #endif
 
+#ifndef AO_DEACTIVATE_FLASH
+
 /*
  * Platform specific implementations. Currently supported:
  *     - Arduino LittleFs

From 3776e483f0f933dfbcf4eb78f45bf988e620685c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 15 Jun 2023 23:23:42 +0200
Subject: [PATCH 274/549] add dbg msg formatter options

---
 src/ArduinoOcpp/Debug.h | 50 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/src/ArduinoOcpp/Debug.h b/src/ArduinoOcpp/Debug.h
index df2478e6..a8d842eb 100644
--- a/src/ArduinoOcpp/Debug.h
+++ b/src/ArduinoOcpp/Debug.h
@@ -18,6 +18,51 @@
 #define AO_DBG_LEVEL AO_DL_INFO  //default
 #endif
 
+#define AO_DF_MINIMAL 0x00   //don't reveal origin of a debug message
+#define AO_DF_MODULE_LINE 0x01 //print module by file name and line number
+#define AO_DF_FILE_LINE 0x02 //print file and line number
+#define AO_DF_FULL    0x03   //print path and file and line numbr
+
+#ifndef AO_DBG_FORMAT
+#define AO_DBG_FORMAT AO_DF_FILE_LINE //default
+#endif
+
+
+#if AO_DBG_FORMAT == AO_DF_MINIMAL
+#define AO_DBG(level, X)   \
+    do {                        \
+        AO_CONSOLE_PRINTF("[AO] ");           \
+        AO_CONSOLE_PRINTF X;  \
+        AO_CONSOLE_PRINTF("\n");         \
+    } while (0);
+
+#elif AO_DBG_FORMAT == AO_DF_MODULE_LINE
+#define AO_DBG(level, X)   \
+    do {                        \
+        const char *_ao_file = __FILE__;         \
+        size_t _ao_l = sizeof(__FILE__);         \
+        size_t _ao_r = _ao_l;         \
+        while (_ao_l > 0 && _ao_file[_ao_l-1] != '/' && _ao_file[_ao_l-1] != '\\') {         \
+            _ao_l--;         \
+            if (_ao_file[_ao_l] == '.') _ao_r = _ao_l;         \
+        }         \
+        AO_CONSOLE_PRINTF("[AO] %s (%.*s:%i): ",level, (int) (_ao_r - _ao_l), _ao_file + _ao_l,__LINE__);           \
+        AO_CONSOLE_PRINTF X;  \
+        AO_CONSOLE_PRINTF("\n");         \
+    } while (0);
+
+#elif AO_DBG_FORMAT == AO_DF_FILE_LINE
+#define AO_DBG(level, X)   \
+    do {                        \
+        const char *_ao_file = __FILE__;         \
+        size_t _ao_l = sizeof(__FILE__);         \
+        for (; _ao_l > 0 && _ao_file[_ao_l-1] != '/' && _ao_file[_ao_l-1] != '\\'; _ao_l--);         \
+        AO_CONSOLE_PRINTF("[AO] %s (%s:%i): ",level, _ao_file + _ao_l,__LINE__);           \
+        AO_CONSOLE_PRINTF X;  \
+        AO_CONSOLE_PRINTF("\n");         \
+    } while (0);
+
+#elif AO_DBG_FORMAT == AO_DF_FULL
 #define AO_DBG(level, X)   \
     do {                        \
         AO_CONSOLE_PRINTF("[AO] %s (%s:%i): ",level, __FILE__,__LINE__);           \
@@ -25,6 +70,11 @@
         AO_CONSOLE_PRINTF("\n");         \
     } while (0);
 
+#else
+#error invalid AO_DBG_FORMAT definition
+#endif
+
+
 #if AO_DBG_LEVEL >= AO_DL_ERROR
 #define AO_DBG_ERR(...) AO_DBG("ERROR",(__VA_ARGS__))
 #else

From 024f3d0f8b61aa4d8823db7c6a88d11ca3cd5915 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 15 Jun 2023 23:26:31 +0200
Subject: [PATCH 275/549] fix printf arg type

---
 src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
index b0364a15..6a4b5da2 100644
--- a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
@@ -257,7 +257,7 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
     if (!checkedSuccessfulFwUpdate && !buildNumber.empty() && previousBuildNumber != nullptr) {
         checkedSuccessfulFwUpdate = true;
 
-        AO_DBG_DEBUG("Previous build number: %s, new build number: %s", *previousBuildNumber, buildNumber.c_str());
+        AO_DBG_DEBUG("Previous build number: %s, new build number: %s", (const char*) *previousBuildNumber, buildNumber.c_str());
         
         size_t buildNoSize = previousBuildNumber->getBuffsize();
         if (strncmp(buildNumber.c_str(), *previousBuildNumber, buildNoSize)) {

From 91ae0593c680c2be0bcf5fabe1c656eec7810f54 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 16 Jun 2023 17:35:23 +0200
Subject: [PATCH 276/549] fixes integration test

---
 src/ArduinoOcpp.cpp                         | 2 +-
 src/ArduinoOcpp/MessagesV16/MeterValues.cpp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 40157275..402253bb 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -368,7 +368,7 @@ void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, unsi
     auto& model = context->getModel();
     if (!model.getSmartChargingService()) {
         model.setSmartChargingService(std::unique_ptr<SmartChargingService>(
-            new SmartChargingService(*context, 11000.0f, voltage_eff, AO_NUMCONNECTORS, fileSystemOpt))); //default charging limit: 11kW
+            new SmartChargingService(*context, -1.f, voltage_eff, AO_NUMCONNECTORS, fileSystemOpt))); //default charging limit: 11kW
     }
     model.getSmartChargingService()->setOnLimitChange(chargingLimitOutput);
 }
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
index 492c9ba1..acb19d1a 100644
--- a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
+++ b/src/ArduinoOcpp/MessagesV16/MeterValues.cpp
@@ -53,7 +53,7 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
     auto payload = doc->to<JsonObject>();
     payload["connectorId"] = connectorId;
 
-    if (transaction && !transaction->isSilent()) { //add txId if MVs are assigned to a tx with txId
+    if (transaction && transaction->getTransactionId() > 0) { //add txId if MVs are assigned to a tx with txId
         payload["transactionId"] = transaction->getTransactionId();
     }
 

From 55583ba22c68a4c524a164add47baa24e853bd21 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 17 Jun 2023 12:25:50 +0200
Subject: [PATCH 277/549] rename folder structure

---
 src/ArduinoOcpp/{Core => }/Context.cpp                            | 0
 src/ArduinoOcpp/{Core => }/Context.h                              | 0
 .../{Tasks => Model}/Authorization/AuthorizationData.cpp          | 0
 .../{Tasks => Model}/Authorization/AuthorizationData.h            | 0
 .../{Tasks => Model}/Authorization/AuthorizationList.cpp          | 0
 .../{Tasks => Model}/Authorization/AuthorizationList.h            | 0
 .../{Tasks => Model}/Authorization/AuthorizationService.cpp       | 0
 .../{Tasks => Model}/Authorization/AuthorizationService.h         | 0
 src/ArduinoOcpp/{Tasks => Model}/Boot/BootService.cpp             | 0
 src/ArduinoOcpp/{Tasks => Model}/Boot/BootService.h               | 0
 .../{Tasks => Model}/ChargeControl/ChargeControlCommon.cpp        | 0
 .../{Tasks => Model}/ChargeControl/ChargeControlCommon.h          | 0
 src/ArduinoOcpp/{Tasks => Model}/ChargeControl/Connector.cpp      | 0
 src/ArduinoOcpp/{Tasks => Model}/ChargeControl/Connector.h        | 0
 src/ArduinoOcpp/{Tasks => Model}/ChargeControl/OcppEvseState.h    | 0
 .../{Tasks => Model}/Diagnostics/DiagnosticsService.cpp           | 0
 src/ArduinoOcpp/{Tasks => Model}/Diagnostics/DiagnosticsService.h | 0
 src/ArduinoOcpp/{Tasks => Model}/Diagnostics/DiagnosticsStatus.h  | 0
 .../{Tasks => Model}/FirmwareManagement/FirmwareService.cpp       | 0
 .../{Tasks => Model}/FirmwareManagement/FirmwareService.h         | 0
 .../{Tasks => Model}/FirmwareManagement/FirmwareStatus.h          | 0
 src/ArduinoOcpp/{Tasks => Model}/Heartbeat/HeartbeatService.cpp   | 0
 src/ArduinoOcpp/{Tasks => Model}/Heartbeat/HeartbeatService.h     | 0
 .../{Tasks => Model}/Metering/ConnectorMeterValuesRecorder.cpp    | 0
 .../{Tasks => Model}/Metering/ConnectorMeterValuesRecorder.h      | 0
 src/ArduinoOcpp/{Tasks => Model}/Metering/MeterStore.cpp          | 0
 src/ArduinoOcpp/{Tasks => Model}/Metering/MeterStore.h            | 0
 src/ArduinoOcpp/{Tasks => Model}/Metering/MeterValue.cpp          | 0
 src/ArduinoOcpp/{Tasks => Model}/Metering/MeterValue.h            | 0
 src/ArduinoOcpp/{Tasks => Model}/Metering/MeteringService.cpp     | 0
 src/ArduinoOcpp/{Tasks => Model}/Metering/MeteringService.h       | 0
 src/ArduinoOcpp/{Tasks => Model}/Metering/SampledValue.cpp        | 0
 src/ArduinoOcpp/{Tasks => Model}/Metering/SampledValue.h          | 0
 src/ArduinoOcpp/{Core => Model}/Model.cpp                         | 0
 src/ArduinoOcpp/{Core => Model}/Model.h                           | 0
 src/ArduinoOcpp/{Tasks => Model}/Reservation/Reservation.cpp      | 0
 src/ArduinoOcpp/{Tasks => Model}/Reservation/Reservation.h        | 0
 .../{Tasks => Model}/Reservation/ReservationService.cpp           | 0
 src/ArduinoOcpp/{Tasks => Model}/Reservation/ReservationService.h | 0
 src/ArduinoOcpp/{Tasks => Model}/Reset/ResetService.cpp           | 0
 src/ArduinoOcpp/{Tasks => Model}/Reset/ResetService.h             | 0
 .../{Tasks => Model}/SmartCharging/SmartChargingModel.cpp         | 0
 .../{Tasks => Model}/SmartCharging/SmartChargingModel.h           | 0
 .../{Tasks => Model}/SmartCharging/SmartChargingService.cpp       | 0
 .../{Tasks => Model}/SmartCharging/SmartChargingService.h         | 0
 src/ArduinoOcpp/{Tasks => Model}/Transactions/Transaction.cpp     | 0
 src/ArduinoOcpp/{Tasks => Model}/Transactions/Transaction.h       | 0
 .../{Tasks => Model}/Transactions/TransactionDeserialize.cpp      | 0
 .../{Tasks => Model}/Transactions/TransactionDeserialize.h        | 0
 .../{Tasks => Model}/Transactions/TransactionStore.cpp            | 0
 src/ArduinoOcpp/{Tasks => Model}/Transactions/TransactionStore.h  | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/Authorize.cpp         | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/Authorize.h           | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/BootNotification.cpp  | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/BootNotification.h    | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/CancelReservation.cpp | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/CancelReservation.h   | 0
 .../{MessagesV16 => Operations}/ChangeAvailability.cpp            | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/ChangeAvailability.h  | 0
 .../{MessagesV16 => Operations}/ChangeConfiguration.cpp           | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/ChangeConfiguration.h | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/CiStrings.h           | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/ClearCache.cpp        | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/ClearCache.h          | 0
 .../{MessagesV16 => Operations}/ClearChargingProfile.cpp          | 0
 .../{MessagesV16 => Operations}/ClearChargingProfile.h            | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/CustomOperation.cpp   | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/CustomOperation.h     | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/DataTransfer.cpp      | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/DataTransfer.h        | 0
 .../{MessagesV16 => Operations}/DiagnosticsStatusNotification.cpp | 0
 .../{MessagesV16 => Operations}/DiagnosticsStatusNotification.h   | 0
 .../{MessagesV16 => Operations}/FirmwareStatusNotification.cpp    | 0
 .../{MessagesV16 => Operations}/FirmwareStatusNotification.h      | 0
 .../{MessagesV16 => Operations}/GetCompositeSchedule.cpp          | 0
 .../{MessagesV16 => Operations}/GetCompositeSchedule.h            | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/GetConfiguration.cpp  | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/GetConfiguration.h    | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/GetDiagnostics.cpp    | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/GetDiagnostics.h      | 0
 .../{MessagesV16 => Operations}/GetLocalListVersion.cpp           | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/GetLocalListVersion.h | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/Heartbeat.cpp         | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/Heartbeat.h           | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/MeterValues.cpp       | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/MeterValues.h         | 0
 .../{MessagesV16 => Operations}/RemoteStartTransaction.cpp        | 0
 .../{MessagesV16 => Operations}/RemoteStartTransaction.h          | 0
 .../{MessagesV16 => Operations}/RemoteStopTransaction.cpp         | 0
 .../{MessagesV16 => Operations}/RemoteStopTransaction.h           | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/ReserveNow.cpp        | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/ReserveNow.h          | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/Reset.cpp             | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/Reset.h               | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/SendLocalList.cpp     | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/SendLocalList.h       | 0
 .../{MessagesV16 => Operations}/SetChargingProfile.cpp            | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/SetChargingProfile.h  | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/StartTransaction.cpp  | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/StartTransaction.h    | 0
 .../{MessagesV16 => Operations}/StatusNotification.cpp            | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/StatusNotification.h  | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/StopTransaction.cpp   | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/StopTransaction.h     | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/TriggerMessage.cpp    | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/TriggerMessage.h      | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/UnlockConnector.cpp   | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/UnlockConnector.h     | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/UpdateFirmware.cpp    | 0
 src/ArduinoOcpp/{MessagesV16 => Operations}/UpdateFirmware.h      | 0
 110 files changed, 0 insertions(+), 0 deletions(-)
 rename src/ArduinoOcpp/{Core => }/Context.cpp (100%)
 rename src/ArduinoOcpp/{Core => }/Context.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Authorization/AuthorizationData.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Authorization/AuthorizationData.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Authorization/AuthorizationList.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Authorization/AuthorizationList.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Authorization/AuthorizationService.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Authorization/AuthorizationService.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Boot/BootService.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Boot/BootService.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/ChargeControl/ChargeControlCommon.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/ChargeControl/ChargeControlCommon.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/ChargeControl/Connector.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/ChargeControl/Connector.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/ChargeControl/OcppEvseState.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Diagnostics/DiagnosticsService.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Diagnostics/DiagnosticsService.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Diagnostics/DiagnosticsStatus.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/FirmwareManagement/FirmwareService.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/FirmwareManagement/FirmwareService.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/FirmwareManagement/FirmwareStatus.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Heartbeat/HeartbeatService.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Heartbeat/HeartbeatService.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/ConnectorMeterValuesRecorder.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/ConnectorMeterValuesRecorder.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/MeterStore.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/MeterStore.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/MeterValue.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/MeterValue.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/MeteringService.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/MeteringService.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/SampledValue.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Metering/SampledValue.h (100%)
 rename src/ArduinoOcpp/{Core => Model}/Model.cpp (100%)
 rename src/ArduinoOcpp/{Core => Model}/Model.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Reservation/Reservation.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Reservation/Reservation.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Reservation/ReservationService.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Reservation/ReservationService.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Reset/ResetService.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Reset/ResetService.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/SmartCharging/SmartChargingModel.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/SmartCharging/SmartChargingModel.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/SmartCharging/SmartChargingService.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/SmartCharging/SmartChargingService.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Transactions/Transaction.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Transactions/Transaction.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Transactions/TransactionDeserialize.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Transactions/TransactionDeserialize.h (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Transactions/TransactionStore.cpp (100%)
 rename src/ArduinoOcpp/{Tasks => Model}/Transactions/TransactionStore.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/Authorize.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/Authorize.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/BootNotification.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/BootNotification.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/CancelReservation.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/CancelReservation.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ChangeAvailability.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ChangeAvailability.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ChangeConfiguration.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ChangeConfiguration.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/CiStrings.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ClearCache.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ClearCache.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ClearChargingProfile.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ClearChargingProfile.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/CustomOperation.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/CustomOperation.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/DataTransfer.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/DataTransfer.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/DiagnosticsStatusNotification.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/DiagnosticsStatusNotification.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/FirmwareStatusNotification.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/FirmwareStatusNotification.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/GetCompositeSchedule.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/GetCompositeSchedule.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/GetConfiguration.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/GetConfiguration.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/GetDiagnostics.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/GetDiagnostics.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/GetLocalListVersion.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/GetLocalListVersion.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/Heartbeat.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/Heartbeat.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/MeterValues.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/MeterValues.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/RemoteStartTransaction.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/RemoteStartTransaction.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/RemoteStopTransaction.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/RemoteStopTransaction.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ReserveNow.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/ReserveNow.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/Reset.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/Reset.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/SendLocalList.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/SendLocalList.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/SetChargingProfile.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/SetChargingProfile.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/StartTransaction.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/StartTransaction.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/StatusNotification.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/StatusNotification.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/StopTransaction.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/StopTransaction.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/TriggerMessage.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/TriggerMessage.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/UnlockConnector.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/UnlockConnector.h (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/UpdateFirmware.cpp (100%)
 rename src/ArduinoOcpp/{MessagesV16 => Operations}/UpdateFirmware.h (100%)

diff --git a/src/ArduinoOcpp/Core/Context.cpp b/src/ArduinoOcpp/Context.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/Context.cpp
rename to src/ArduinoOcpp/Context.cpp
diff --git a/src/ArduinoOcpp/Core/Context.h b/src/ArduinoOcpp/Context.h
similarity index 100%
rename from src/ArduinoOcpp/Core/Context.h
rename to src/ArduinoOcpp/Context.h
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
rename to src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h b/src/ArduinoOcpp/Model/Authorization/AuthorizationData.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.h
rename to src/ArduinoOcpp/Model/Authorization/AuthorizationData.h
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
rename to src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h b/src/ArduinoOcpp/Model/Authorization/AuthorizationList.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.h
rename to src/ArduinoOcpp/Model/Authorization/AuthorizationList.h
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
rename to src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
diff --git a/src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.h
rename to src/ArduinoOcpp/Model/Authorization/AuthorizationService.h
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.cpp b/src/ArduinoOcpp/Model/Boot/BootService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Boot/BootService.cpp
rename to src/ArduinoOcpp/Model/Boot/BootService.cpp
diff --git a/src/ArduinoOcpp/Tasks/Boot/BootService.h b/src/ArduinoOcpp/Model/Boot/BootService.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Boot/BootService.h
rename to src/ArduinoOcpp/Model/Boot/BootService.h
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
rename to src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h
rename to src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
rename to src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/ChargeControl/Connector.h
rename to src/ArduinoOcpp/Model/ChargeControl/Connector.h
diff --git a/src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h b/src/ArduinoOcpp/Model/ChargeControl/OcppEvseState.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h
rename to src/ArduinoOcpp/Model/ChargeControl/OcppEvseState.h
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
rename to src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
rename to src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
diff --git a/src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsStatus.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h
rename to src/ArduinoOcpp/Model/Diagnostics/DiagnosticsStatus.h
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
rename to src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h
rename to src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h
diff --git a/src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareStatus.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h
rename to src/ArduinoOcpp/Model/FirmwareManagement/FirmwareStatus.h
diff --git a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp b/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
rename to src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
diff --git a/src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h b/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h
rename to src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.h
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
rename to src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp
diff --git a/src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h
rename to src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp b/src/ArduinoOcpp/Model/Metering/MeterStore.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
rename to src/ArduinoOcpp/Model/Metering/MeterStore.cpp
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterStore.h b/src/ArduinoOcpp/Model/Metering/MeterStore.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/MeterStore.h
rename to src/ArduinoOcpp/Model/Metering/MeterStore.h
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp b/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
rename to src/ArduinoOcpp/Model/Metering/MeterValue.cpp
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeterValue.h b/src/ArduinoOcpp/Model/Metering/MeterValue.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/MeterValue.h
rename to src/ArduinoOcpp/Model/Metering/MeterValue.h
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
rename to src/ArduinoOcpp/Model/Metering/MeteringService.cpp
diff --git a/src/ArduinoOcpp/Tasks/Metering/MeteringService.h b/src/ArduinoOcpp/Model/Metering/MeteringService.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/MeteringService.h
rename to src/ArduinoOcpp/Model/Metering/MeteringService.h
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp b/src/ArduinoOcpp/Model/Metering/SampledValue.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
rename to src/ArduinoOcpp/Model/Metering/SampledValue.cpp
diff --git a/src/ArduinoOcpp/Tasks/Metering/SampledValue.h b/src/ArduinoOcpp/Model/Metering/SampledValue.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Metering/SampledValue.h
rename to src/ArduinoOcpp/Model/Metering/SampledValue.h
diff --git a/src/ArduinoOcpp/Core/Model.cpp b/src/ArduinoOcpp/Model/Model.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/Model.cpp
rename to src/ArduinoOcpp/Model/Model.cpp
diff --git a/src/ArduinoOcpp/Core/Model.h b/src/ArduinoOcpp/Model/Model.h
similarity index 100%
rename from src/ArduinoOcpp/Core/Model.h
rename to src/ArduinoOcpp/Model/Model.h
diff --git a/src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp b/src/ArduinoOcpp/Model/Reservation/Reservation.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
rename to src/ArduinoOcpp/Model/Reservation/Reservation.cpp
diff --git a/src/ArduinoOcpp/Tasks/Reservation/Reservation.h b/src/ArduinoOcpp/Model/Reservation/Reservation.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Reservation/Reservation.h
rename to src/ArduinoOcpp/Model/Reservation/Reservation.h
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
rename to src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
diff --git a/src/ArduinoOcpp/Tasks/Reservation/ReservationService.h b/src/ArduinoOcpp/Model/Reservation/ReservationService.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Reservation/ReservationService.h
rename to src/ArduinoOcpp/Model/Reservation/ReservationService.h
diff --git a/src/ArduinoOcpp/Tasks/Reset/ResetService.cpp b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
rename to src/ArduinoOcpp/Model/Reset/ResetService.cpp
diff --git a/src/ArduinoOcpp/Tasks/Reset/ResetService.h b/src/ArduinoOcpp/Model/Reset/ResetService.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Reset/ResetService.h
rename to src/ArduinoOcpp/Model/Reset/ResetService.h
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
rename to src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h
rename to src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
rename to src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
diff --git a/src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h
rename to src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
rename to src/ArduinoOcpp/Model/Transactions/Transaction.cpp
diff --git a/src/ArduinoOcpp/Tasks/Transactions/Transaction.h b/src/ArduinoOcpp/Model/Transactions/Transaction.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Transactions/Transaction.h
rename to src/ArduinoOcpp/Model/Transactions/Transaction.h
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.cpp b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.cpp
rename to src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.h b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.h
rename to src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
rename to src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
diff --git a/src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h b/src/ArduinoOcpp/Model/Transactions/TransactionStore.h
similarity index 100%
rename from src/ArduinoOcpp/Tasks/Transactions/TransactionStore.h
rename to src/ArduinoOcpp/Model/Transactions/TransactionStore.h
diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.cpp b/src/ArduinoOcpp/Operations/Authorize.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/Authorize.cpp
rename to src/ArduinoOcpp/Operations/Authorize.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/Authorize.h b/src/ArduinoOcpp/Operations/Authorize.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/Authorize.h
rename to src/ArduinoOcpp/Operations/Authorize.h
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.cpp b/src/ArduinoOcpp/Operations/BootNotification.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/BootNotification.cpp
rename to src/ArduinoOcpp/Operations/BootNotification.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/BootNotification.h b/src/ArduinoOcpp/Operations/BootNotification.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/BootNotification.h
rename to src/ArduinoOcpp/Operations/BootNotification.h
diff --git a/src/ArduinoOcpp/MessagesV16/CancelReservation.cpp b/src/ArduinoOcpp/Operations/CancelReservation.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
rename to src/ArduinoOcpp/Operations/CancelReservation.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/CancelReservation.h b/src/ArduinoOcpp/Operations/CancelReservation.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/CancelReservation.h
rename to src/ArduinoOcpp/Operations/CancelReservation.h
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp b/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
rename to src/ArduinoOcpp/Operations/ChangeAvailability.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeAvailability.h b/src/ArduinoOcpp/Operations/ChangeAvailability.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ChangeAvailability.h
rename to src/ArduinoOcpp/Operations/ChangeAvailability.h
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp b/src/ArduinoOcpp/Operations/ChangeConfiguration.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
rename to src/ArduinoOcpp/Operations/ChangeConfiguration.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h b/src/ArduinoOcpp/Operations/ChangeConfiguration.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ChangeConfiguration.h
rename to src/ArduinoOcpp/Operations/ChangeConfiguration.h
diff --git a/src/ArduinoOcpp/MessagesV16/CiStrings.h b/src/ArduinoOcpp/Operations/CiStrings.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/CiStrings.h
rename to src/ArduinoOcpp/Operations/CiStrings.h
diff --git a/src/ArduinoOcpp/MessagesV16/ClearCache.cpp b/src/ArduinoOcpp/Operations/ClearCache.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ClearCache.cpp
rename to src/ArduinoOcpp/Operations/ClearCache.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/ClearCache.h b/src/ArduinoOcpp/Operations/ClearCache.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ClearCache.h
rename to src/ArduinoOcpp/Operations/ClearCache.h
diff --git a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp b/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
rename to src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h b/src/ArduinoOcpp/Operations/ClearChargingProfile.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ClearChargingProfile.h
rename to src/ArduinoOcpp/Operations/ClearChargingProfile.h
diff --git a/src/ArduinoOcpp/MessagesV16/CustomOperation.cpp b/src/ArduinoOcpp/Operations/CustomOperation.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/CustomOperation.cpp
rename to src/ArduinoOcpp/Operations/CustomOperation.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/CustomOperation.h b/src/ArduinoOcpp/Operations/CustomOperation.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/CustomOperation.h
rename to src/ArduinoOcpp/Operations/CustomOperation.h
diff --git a/src/ArduinoOcpp/MessagesV16/DataTransfer.cpp b/src/ArduinoOcpp/Operations/DataTransfer.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
rename to src/ArduinoOcpp/Operations/DataTransfer.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/DataTransfer.h b/src/ArduinoOcpp/Operations/DataTransfer.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/DataTransfer.h
rename to src/ArduinoOcpp/Operations/DataTransfer.h
diff --git a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp b/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
rename to src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h b/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h
rename to src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.h
diff --git a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp b/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
rename to src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h b/src/ArduinoOcpp/Operations/FirmwareStatusNotification.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h
rename to src/ArduinoOcpp/Operations/FirmwareStatusNotification.h
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp b/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
rename to src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h b/src/ArduinoOcpp/Operations/GetCompositeSchedule.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.h
rename to src/ArduinoOcpp/Operations/GetCompositeSchedule.h
diff --git a/src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp b/src/ArduinoOcpp/Operations/GetConfiguration.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
rename to src/ArduinoOcpp/Operations/GetConfiguration.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/GetConfiguration.h b/src/ArduinoOcpp/Operations/GetConfiguration.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/GetConfiguration.h
rename to src/ArduinoOcpp/Operations/GetConfiguration.h
diff --git a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp b/src/ArduinoOcpp/Operations/GetDiagnostics.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
rename to src/ArduinoOcpp/Operations/GetDiagnostics.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/GetDiagnostics.h b/src/ArduinoOcpp/Operations/GetDiagnostics.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/GetDiagnostics.h
rename to src/ArduinoOcpp/Operations/GetDiagnostics.h
diff --git a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp b/src/ArduinoOcpp/Operations/GetLocalListVersion.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
rename to src/ArduinoOcpp/Operations/GetLocalListVersion.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h b/src/ArduinoOcpp/Operations/GetLocalListVersion.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/GetLocalListVersion.h
rename to src/ArduinoOcpp/Operations/GetLocalListVersion.h
diff --git a/src/ArduinoOcpp/MessagesV16/Heartbeat.cpp b/src/ArduinoOcpp/Operations/Heartbeat.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
rename to src/ArduinoOcpp/Operations/Heartbeat.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/Heartbeat.h b/src/ArduinoOcpp/Operations/Heartbeat.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/Heartbeat.h
rename to src/ArduinoOcpp/Operations/Heartbeat.h
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.cpp b/src/ArduinoOcpp/Operations/MeterValues.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/MeterValues.cpp
rename to src/ArduinoOcpp/Operations/MeterValues.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/MeterValues.h b/src/ArduinoOcpp/Operations/MeterValues.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/MeterValues.h
rename to src/ArduinoOcpp/Operations/MeterValues.h
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
rename to src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h b/src/ArduinoOcpp/Operations/RemoteStartTransaction.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.h
rename to src/ArduinoOcpp/Operations/RemoteStartTransaction.h
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
rename to src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h b/src/ArduinoOcpp/Operations/RemoteStopTransaction.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.h
rename to src/ArduinoOcpp/Operations/RemoteStopTransaction.h
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.cpp b/src/ArduinoOcpp/Operations/ReserveNow.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
rename to src/ArduinoOcpp/Operations/ReserveNow.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/ReserveNow.h b/src/ArduinoOcpp/Operations/ReserveNow.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/ReserveNow.h
rename to src/ArduinoOcpp/Operations/ReserveNow.h
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.cpp b/src/ArduinoOcpp/Operations/Reset.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/Reset.cpp
rename to src/ArduinoOcpp/Operations/Reset.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/Reset.h b/src/ArduinoOcpp/Operations/Reset.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/Reset.h
rename to src/ArduinoOcpp/Operations/Reset.h
diff --git a/src/ArduinoOcpp/MessagesV16/SendLocalList.cpp b/src/ArduinoOcpp/Operations/SendLocalList.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
rename to src/ArduinoOcpp/Operations/SendLocalList.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/SendLocalList.h b/src/ArduinoOcpp/Operations/SendLocalList.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/SendLocalList.h
rename to src/ArduinoOcpp/Operations/SendLocalList.h
diff --git a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp b/src/ArduinoOcpp/Operations/SetChargingProfile.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
rename to src/ArduinoOcpp/Operations/SetChargingProfile.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/SetChargingProfile.h b/src/ArduinoOcpp/Operations/SetChargingProfile.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/SetChargingProfile.h
rename to src/ArduinoOcpp/Operations/SetChargingProfile.h
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.cpp b/src/ArduinoOcpp/Operations/StartTransaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
rename to src/ArduinoOcpp/Operations/StartTransaction.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/StartTransaction.h b/src/ArduinoOcpp/Operations/StartTransaction.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/StartTransaction.h
rename to src/ArduinoOcpp/Operations/StartTransaction.h
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.cpp b/src/ArduinoOcpp/Operations/StatusNotification.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
rename to src/ArduinoOcpp/Operations/StatusNotification.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/StatusNotification.h b/src/ArduinoOcpp/Operations/StatusNotification.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/StatusNotification.h
rename to src/ArduinoOcpp/Operations/StatusNotification.h
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.cpp b/src/ArduinoOcpp/Operations/StopTransaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
rename to src/ArduinoOcpp/Operations/StopTransaction.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/StopTransaction.h b/src/ArduinoOcpp/Operations/StopTransaction.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/StopTransaction.h
rename to src/ArduinoOcpp/Operations/StopTransaction.h
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
rename to src/ArduinoOcpp/Operations/TriggerMessage.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/TriggerMessage.h b/src/ArduinoOcpp/Operations/TriggerMessage.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/TriggerMessage.h
rename to src/ArduinoOcpp/Operations/TriggerMessage.h
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp b/src/ArduinoOcpp/Operations/UnlockConnector.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
rename to src/ArduinoOcpp/Operations/UnlockConnector.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/UnlockConnector.h b/src/ArduinoOcpp/Operations/UnlockConnector.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/UnlockConnector.h
rename to src/ArduinoOcpp/Operations/UnlockConnector.h
diff --git a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp b/src/ArduinoOcpp/Operations/UpdateFirmware.cpp
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
rename to src/ArduinoOcpp/Operations/UpdateFirmware.cpp
diff --git a/src/ArduinoOcpp/MessagesV16/UpdateFirmware.h b/src/ArduinoOcpp/Operations/UpdateFirmware.h
similarity index 100%
rename from src/ArduinoOcpp/MessagesV16/UpdateFirmware.h
rename to src/ArduinoOcpp/Operations/UpdateFirmware.h

From 9fa433b6747cd9a29617bfad2d9c59963403ef4c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 17 Jun 2023 12:53:39 +0200
Subject: [PATCH 278/549] adopt renamed folder structure

---
 CMakeLists.txt                                | 106 +++++++++---------
 src/ArduinoOcpp.cpp                           |  34 +++---
 src/ArduinoOcpp.h                             |  14 +--
 src/ArduinoOcpp/Context.cpp                   |   4 +-
 src/ArduinoOcpp/Context.h                     |   5 +-
 src/ArduinoOcpp/Core/Request.cpp              |   6 +-
 .../Model/Authorization/AuthorizationData.cpp |   2 +-
 .../Model/Authorization/AuthorizationData.h   |   2 +-
 .../Model/Authorization/AuthorizationList.cpp |   2 +-
 .../Model/Authorization/AuthorizationList.h   |   2 +-
 .../Authorization/AuthorizationService.cpp    |  14 +--
 .../Authorization/AuthorizationService.h      |   2 +-
 src/ArduinoOcpp/Model/Boot/BootService.cpp    |   8 +-
 .../ChargeControl/ChargeControlCommon.cpp     |  30 ++---
 .../Model/ChargeControl/Connector.cpp         |  24 ++--
 .../Model/ChargeControl/Connector.h           |   4 +-
 .../Model/Diagnostics/DiagnosticsService.cpp  |  10 +-
 .../Model/Diagnostics/DiagnosticsService.h    |   2 +-
 .../FirmwareManagement/FirmwareService.cpp    |  14 +--
 .../FirmwareManagement/FirmwareService.h      |   2 +-
 .../Model/Heartbeat/HeartbeatService.cpp      |   6 +-
 .../Metering/ConnectorMeterValuesRecorder.cpp |  10 +-
 .../Metering/ConnectorMeterValuesRecorder.h   |   6 +-
 src/ArduinoOcpp/Model/Metering/MeterStore.cpp |   2 +-
 src/ArduinoOcpp/Model/Metering/MeterStore.h   |   4 +-
 src/ArduinoOcpp/Model/Metering/MeterValue.cpp |   2 +-
 src/ArduinoOcpp/Model/Metering/MeterValue.h   |   2 +-
 .../Model/Metering/MeteringService.cpp        |   8 +-
 .../Model/Metering/MeteringService.h          |   6 +-
 .../Model/Metering/SampledValue.cpp           |   2 +-
 src/ArduinoOcpp/Model/Model.cpp               |  24 ++--
 src/ArduinoOcpp/Model/Model.h                 |   2 +-
 .../Model/Reservation/Reservation.cpp         |   4 +-
 .../Model/Reservation/ReservationService.cpp  |  14 +--
 .../Model/Reservation/ReservationService.h    |   2 +-
 src/ArduinoOcpp/Model/Reset/ResetService.cpp  |  16 +--
 .../SmartCharging/SmartChargingModel.cpp      |   2 +-
 .../SmartCharging/SmartChargingService.cpp    |  12 +-
 .../SmartCharging/SmartChargingService.h      |   2 +-
 .../Model/Transactions/Transaction.cpp        |   4 +-
 .../Model/Transactions/Transaction.h          |   2 +-
 .../Transactions/TransactionDeserialize.cpp   |   2 +-
 .../Transactions/TransactionDeserialize.h     |   2 +-
 .../Model/Transactions/TransactionStore.cpp   |  10 +-
 .../Model/Transactions/TransactionStore.h     |   2 +-
 src/ArduinoOcpp/Operations/Authorize.cpp      |   6 +-
 src/ArduinoOcpp/Operations/Authorize.h        |   2 +-
 .../Operations/BootNotification.cpp           |   6 +-
 src/ArduinoOcpp/Operations/BootNotification.h |   2 +-
 .../Operations/CancelReservation.cpp          |   6 +-
 .../Operations/ChangeAvailability.cpp         |   6 +-
 .../Operations/ChangeConfiguration.cpp        |   2 +-
 src/ArduinoOcpp/Operations/ClearCache.cpp     |   2 +-
 .../Operations/ClearChargingProfile.cpp       |   6 +-
 .../Operations/CustomOperation.cpp            |   2 +-
 src/ArduinoOcpp/Operations/DataTransfer.cpp   |   2 +-
 .../DiagnosticsStatusNotification.cpp         |   8 +-
 .../DiagnosticsStatusNotification.h           |   2 +-
 .../Operations/FirmwareStatusNotification.cpp |   8 +-
 .../Operations/FirmwareStatusNotification.h   |   2 +-
 .../Operations/GetCompositeSchedule.cpp       |   8 +-
 .../Operations/GetCompositeSchedule.h         |   2 +-
 .../Operations/GetConfiguration.cpp           |   2 +-
 src/ArduinoOcpp/Operations/GetDiagnostics.cpp |   6 +-
 .../Operations/GetLocalListVersion.cpp        |   6 +-
 src/ArduinoOcpp/Operations/Heartbeat.cpp      |   4 +-
 src/ArduinoOcpp/Operations/MeterValues.cpp    |   8 +-
 .../Operations/RemoteStartTransaction.cpp     |   8 +-
 .../Operations/RemoteStartTransaction.h       |   2 +-
 .../Operations/RemoteStopTransaction.cpp      |   6 +-
 src/ArduinoOcpp/Operations/ReserveNow.cpp     |   8 +-
 src/ArduinoOcpp/Operations/Reset.cpp          |   6 +-
 src/ArduinoOcpp/Operations/SendLocalList.cpp  |   6 +-
 .../Operations/SetChargingProfile.cpp         |   6 +-
 .../Operations/StartTransaction.cpp           |  12 +-
 src/ArduinoOcpp/Operations/StartTransaction.h |   4 +-
 .../Operations/StatusNotification.cpp         |   4 +-
 .../Operations/StatusNotification.h           |   2 +-
 .../Operations/StopTransaction.cpp            |  14 +--
 src/ArduinoOcpp/Operations/StopTransaction.h  |   2 +-
 src/ArduinoOcpp/Operations/TriggerMessage.cpp |  12 +-
 .../Operations/UnlockConnector.cpp            |   4 +-
 src/ArduinoOcpp/Operations/UpdateFirmware.cpp |   6 +-
 tests/ChargingSessions.cpp                    |   8 +-
 tests/ConfigurationBehavior.cpp               |   4 +-
 tests/TransactionSafety.cpp                   |   8 +-
 86 files changed, 327 insertions(+), 328 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 6ec69167..5211a98a 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -12,68 +12,68 @@ set(AO_SRC
     src/ArduinoOcpp/Core/FilesystemAdapter.cpp
     src/ArduinoOcpp/Core/FilesystemUtils.cpp
     src/ArduinoOcpp/Core/RequestQueue.cpp
-    src/ArduinoOcpp/Core/Context.cpp
+    src/ArduinoOcpp/Context.cpp
     src/ArduinoOcpp/Core/Operation.cpp
-    src/ArduinoOcpp/Core/Model.cpp
+    src/ArduinoOcpp/Model/Model.cpp
     src/ArduinoOcpp/Core/Request.cpp
     src/ArduinoOcpp/Core/Connection.cpp
     src/ArduinoOcpp/Core/Time.cpp
     src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
     src/ArduinoOcpp/Core/RequestStore.cpp
-    src/ArduinoOcpp/MessagesV16/Authorize.cpp
-    src/ArduinoOcpp/MessagesV16/BootNotification.cpp
-    src/ArduinoOcpp/MessagesV16/CancelReservation.cpp
-    src/ArduinoOcpp/MessagesV16/ChangeAvailability.cpp
-    src/ArduinoOcpp/MessagesV16/ChangeConfiguration.cpp
-    src/ArduinoOcpp/MessagesV16/ClearCache.cpp
-    src/ArduinoOcpp/MessagesV16/ClearChargingProfile.cpp
-    src/ArduinoOcpp/MessagesV16/CustomOperation.cpp
-    src/ArduinoOcpp/MessagesV16/DataTransfer.cpp
-    src/ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.cpp
-    src/ArduinoOcpp/MessagesV16/FirmwareStatusNotification.cpp
-    src/ArduinoOcpp/MessagesV16/GetCompositeSchedule.cpp
-    src/ArduinoOcpp/MessagesV16/GetConfiguration.cpp
-    src/ArduinoOcpp/MessagesV16/GetDiagnostics.cpp
-    src/ArduinoOcpp/MessagesV16/GetLocalListVersion.cpp
-    src/ArduinoOcpp/MessagesV16/Heartbeat.cpp
-    src/ArduinoOcpp/MessagesV16/MeterValues.cpp
-    src/ArduinoOcpp/MessagesV16/RemoteStartTransaction.cpp
-    src/ArduinoOcpp/MessagesV16/RemoteStopTransaction.cpp
-    src/ArduinoOcpp/MessagesV16/ReserveNow.cpp
-    src/ArduinoOcpp/MessagesV16/Reset.cpp
-    src/ArduinoOcpp/MessagesV16/SendLocalList.cpp
-    src/ArduinoOcpp/MessagesV16/SetChargingProfile.cpp
-    src/ArduinoOcpp/MessagesV16/StartTransaction.cpp
-    src/ArduinoOcpp/MessagesV16/StatusNotification.cpp
-    src/ArduinoOcpp/MessagesV16/StopTransaction.cpp
-    src/ArduinoOcpp/MessagesV16/TriggerMessage.cpp
-    src/ArduinoOcpp/MessagesV16/UnlockConnector.cpp
-    src/ArduinoOcpp/MessagesV16/UpdateFirmware.cpp
+    src/ArduinoOcpp/Operations/Authorize.cpp
+    src/ArduinoOcpp/Operations/BootNotification.cpp
+    src/ArduinoOcpp/Operations/CancelReservation.cpp
+    src/ArduinoOcpp/Operations/ChangeAvailability.cpp
+    src/ArduinoOcpp/Operations/ChangeConfiguration.cpp
+    src/ArduinoOcpp/Operations/ClearCache.cpp
+    src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
+    src/ArduinoOcpp/Operations/CustomOperation.cpp
+    src/ArduinoOcpp/Operations/DataTransfer.cpp
+    src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
+    src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
+    src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
+    src/ArduinoOcpp/Operations/GetConfiguration.cpp
+    src/ArduinoOcpp/Operations/GetDiagnostics.cpp
+    src/ArduinoOcpp/Operations/GetLocalListVersion.cpp
+    src/ArduinoOcpp/Operations/Heartbeat.cpp
+    src/ArduinoOcpp/Operations/MeterValues.cpp
+    src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
+    src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
+    src/ArduinoOcpp/Operations/ReserveNow.cpp
+    src/ArduinoOcpp/Operations/Reset.cpp
+    src/ArduinoOcpp/Operations/SendLocalList.cpp
+    src/ArduinoOcpp/Operations/SetChargingProfile.cpp
+    src/ArduinoOcpp/Operations/StartTransaction.cpp
+    src/ArduinoOcpp/Operations/StatusNotification.cpp
+    src/ArduinoOcpp/Operations/StopTransaction.cpp
+    src/ArduinoOcpp/Operations/TriggerMessage.cpp
+    src/ArduinoOcpp/Operations/UnlockConnector.cpp
+    src/ArduinoOcpp/Operations/UpdateFirmware.cpp
     src/ArduinoOcpp/Platform.cpp
     src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
     src/ArduinoOcpp/Core/OperationRegistry.cpp
-    src/ArduinoOcpp/Tasks/Authorization/AuthorizationData.cpp
-    src/ArduinoOcpp/Tasks/Authorization/AuthorizationList.cpp
-    src/ArduinoOcpp/Tasks/Authorization/AuthorizationService.cpp
-    src/ArduinoOcpp/Tasks/Boot/BootService.cpp
-    src/ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.cpp
-    src/ArduinoOcpp/Tasks/ChargeControl/Connector.cpp
-    src/ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.cpp
-    src/ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.cpp
-    src/ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.cpp
-    src/ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.cpp
-    src/ArduinoOcpp/Tasks/Metering/MeteringService.cpp
-    src/ArduinoOcpp/Tasks/Metering/MeterStore.cpp
-    src/ArduinoOcpp/Tasks/Metering/MeterValue.cpp
-    src/ArduinoOcpp/Tasks/Metering/SampledValue.cpp
-    src/ArduinoOcpp/Tasks/Reservation/Reservation.cpp
-    src/ArduinoOcpp/Tasks/Reservation/ReservationService.cpp
-    src/ArduinoOcpp/Tasks/Reset/ResetService.cpp
-    src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.cpp
-    src/ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.cpp
-    src/ArduinoOcpp/Tasks/Transactions/Transaction.cpp
-    src/ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.cpp
-    src/ArduinoOcpp/Tasks/Transactions/TransactionStore.cpp
+    src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp
+    src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp
+    src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
+    src/ArduinoOcpp/Model/Boot/BootService.cpp
+    src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
+    src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+    src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
+    src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
+    src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
+    src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp
+    src/ArduinoOcpp/Model/Metering/MeteringService.cpp
+    src/ArduinoOcpp/Model/Metering/MeterStore.cpp
+    src/ArduinoOcpp/Model/Metering/MeterValue.cpp
+    src/ArduinoOcpp/Model/Metering/SampledValue.cpp
+    src/ArduinoOcpp/Model/Reservation/Reservation.cpp
+    src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
+    src/ArduinoOcpp/Model/Reset/ResetService.cpp
+    src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
+    src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+    src/ArduinoOcpp/Model/Transactions/Transaction.cpp
+    src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
+    src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
     src/ArduinoOcpp.cpp
     src/ArduinoOcpp_c.cpp
 )
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 402253bb..f48ecb87 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -4,28 +4,28 @@
 
 #include "ArduinoOcpp.h"
 
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h>
-#include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
-#include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
-#include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Tasks/Boot/BootService.h>
-#include <ArduinoOcpp/Tasks/Reset/ResetService.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Metering/MeteringService.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h>
+#include <ArduinoOcpp/Model/Heartbeat/HeartbeatService.h>
+#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
+#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Model/Boot/BootService.h>
+#include <ArduinoOcpp/Model/Reset/ResetService.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/OperationRegistry.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
-#include <ArduinoOcpp/MessagesV16/Authorize.h>
-#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
-#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
-#include <ArduinoOcpp/MessagesV16/CustomOperation.h>
+#include <ArduinoOcpp/Operations/Authorize.h>
+#include <ArduinoOcpp/Operations/StartTransaction.h>
+#include <ArduinoOcpp/Operations/StopTransaction.h>
+#include <ArduinoOcpp/Operations/CustomOperation.h>
 
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 7d79c904..2baa4fb7 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -13,8 +13,8 @@
 #include <ArduinoOcpp/Core/RequestCallbacks.h>
 #include <ArduinoOcpp/Core/Connection.h>
 #include <ArduinoOcpp/Core/PollResult.h>
-#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Metering/SampledValue.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
 using ArduinoOcpp::OnReceiveReqListener;
@@ -226,7 +226,7 @@ bool isOperative(unsigned int connectorId = 1); //if the charge point is operati
 /*
  * Returns the current transaction process. Returns nullptr if no transaction is running, preparing or finishing
  *
- * See the class definition in ArduinoOcpp/Tasks/Transactions/Transaction.h for possible uses of this object
+ * See the class definition in ArduinoOcpp/Model/Transactions/Transaction.h for possible uses of this object
  * 
  * Examples:
  * auto tx = getTransaction(); //fetch tx object
@@ -246,24 +246,24 @@ bool isBlockedByReservation(const char *idTag, unsigned int connectorId = 1); //
  */
 
 #if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
-#include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
+#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
 
 /*
  * You need to configure this object if FW updates are relevant for you. This project already
  * brings a simple configuration for the ESP32 and ESP8266 for prototyping purposes, however
  * for the productive system you will have to develop a configuration targeting the specific
  * OCPP backend.
- * See ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h 
+ * See ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h 
  */
 ArduinoOcpp::FirmwareService *getFirmwareService();
 #endif
 
 #if defined(AO_CUSTOM_DIAGNOSTICS) || defined(AO_CUSTOM_WS)
-#include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
+#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
 /*
  * This library implements the OCPP messaging side of Diagnostics, but no logging or the
  * log upload to your backend.
- * To integrate Diagnostics, see ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h
+ * To integrate Diagnostics, see ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
  */
 ArduinoOcpp::DiagnosticsService *getDiagnosticsService();
 #endif
diff --git a/src/ArduinoOcpp/Context.cpp b/src/ArduinoOcpp/Context.cpp
index aecc4530..8184ad25 100644
--- a/src/ArduinoOcpp/Context.cpp
+++ b/src/ArduinoOcpp/Context.cpp
@@ -2,10 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Context.h>
 #include <ArduinoOcpp/Core/Request.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Model/Model.h>
 
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Context.h b/src/ArduinoOcpp/Context.h
index efd77bd0..d9fea7cc 100644
--- a/src/ArduinoOcpp/Context.h
+++ b/src/ArduinoOcpp/Context.h
@@ -2,12 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OCPPENGINE_H
-#define OCPPENGINE_H
+#ifndef AO_CONTEXT_H
+#define AO_CONTEXT_H
 
 #include <ArduinoOcpp/Core/RequestQueue.h>
 #include <ArduinoOcpp/Core/OperationRegistry.h>
-#include <ArduinoOcpp/Core/Time.h>
 #include <memory>
 
 namespace ArduinoOcpp {
diff --git a/src/ArduinoOcpp/Core/Request.cpp b/src/ArduinoOcpp/Core/Request.cpp
index 879b3e79..5f824e25 100644
--- a/src/ArduinoOcpp/Core/Request.cpp
+++ b/src/ArduinoOcpp/Core/Request.cpp
@@ -5,11 +5,11 @@
 #include <ArduinoOcpp/Core/Request.h>
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/RequestStore.h>
 
-#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
-#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
+#include <ArduinoOcpp/Operations/StartTransaction.h>
+#include <ArduinoOcpp/Operations/StopTransaction.h>
 
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp
index 4f363c3f..b2a4cf9a 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationData.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationData.h>
 
 using namespace ArduinoOcpp;
 
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationData.h b/src/ArduinoOcpp/Model/Authorization/AuthorizationData.h
index 5c2d806e..3f050771 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationData.h
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationData.h
@@ -5,7 +5,7 @@
 #ifndef AUTHORIZATIONDATA_H
 #define AUTHORIZATIONDATA_H
 
-#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Operations/CiStrings.h>
 #include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoJson.h>
 #include <memory>
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp
index 3ce894bc..d8924ae6 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationList.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationList.h>
 #include <ArduinoOcpp/Debug.h>
 
 #include <algorithm>
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationList.h b/src/ArduinoOcpp/Model/Authorization/AuthorizationList.h
index 1e300914..936d5581 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationList.h
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationList.h
@@ -5,7 +5,7 @@
 #ifndef AUTHORIZATIONLIST_H
 #define AUTHORIZATIONLIST_H
 
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationData.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationData.h>
 #include <vector>
 
 #ifndef AO_LocalAuthListMaxLength
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
index cc3395b7..e3c9a330 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
@@ -2,16 +2,16 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/OperationRegistry.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/MessagesV16/GetLocalListVersion.h>
-#include <ArduinoOcpp/MessagesV16/SendLocalList.h>
-#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
+#include <ArduinoOcpp/Operations/GetLocalListVersion.h>
+#include <ArduinoOcpp/Operations/SendLocalList.h>
+#include <ArduinoOcpp/Operations/StatusNotification.h>
 #include <ArduinoOcpp/Debug.h>
 
 #define AO_LOCALAUTHORIZATIONLIST_FN (AO_FILENAME_PREFIX "localauth.jsn")
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.h b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.h
index 0a92ea12..6ae504d1 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.h
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.h
@@ -5,7 +5,7 @@
 #ifndef AUTHORIZATIONSERVICE_H
 #define AUTHORIZATIONSERVICE_H
 
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationList.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationList.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 
diff --git a/src/ArduinoOcpp/Model/Boot/BootService.cpp b/src/ArduinoOcpp/Model/Boot/BootService.cpp
index 3cbea79e..4a3af66d 100644
--- a/src/ArduinoOcpp/Model/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Model/Boot/BootService.cpp
@@ -2,12 +2,12 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Boot/BootService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Model/Boot/BootService.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/MessagesV16/BootNotification.h>
+#include <ArduinoOcpp/Operations/BootNotification.h>
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
index 268fcc42..b0206c0b 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
@@ -4,23 +4,23 @@
 
 #include <string>
 
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h>
-#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h>
+#include <ArduinoOcpp/Context.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
-#include <ArduinoOcpp/MessagesV16/ChangeConfiguration.h>
-#include <ArduinoOcpp/MessagesV16/ClearCache.h>
-#include <ArduinoOcpp/MessagesV16/GetConfiguration.h>
-#include <ArduinoOcpp/MessagesV16/RemoteStartTransaction.h>
-#include <ArduinoOcpp/MessagesV16/RemoteStopTransaction.h>
-#include <ArduinoOcpp/MessagesV16/Reset.h>
-#include <ArduinoOcpp/MessagesV16/TriggerMessage.h>
-#include <ArduinoOcpp/MessagesV16/UnlockConnector.h>
+#include <ArduinoOcpp/Operations/ChangeAvailability.h>
+#include <ArduinoOcpp/Operations/ChangeConfiguration.h>
+#include <ArduinoOcpp/Operations/ClearCache.h>
+#include <ArduinoOcpp/Operations/GetConfiguration.h>
+#include <ArduinoOcpp/Operations/RemoteStartTransaction.h>
+#include <ArduinoOcpp/Operations/RemoteStopTransaction.h>
+#include <ArduinoOcpp/Operations/Reset.h>
+#include <ArduinoOcpp/Operations/TriggerMessage.h>
+#include <ArduinoOcpp/Operations/UnlockConnector.h>
 
-#include <ArduinoOcpp/MessagesV16/Authorize.h>
-#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
-#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
+#include <ArduinoOcpp/Operations/Authorize.h>
+#include <ArduinoOcpp/Operations/StartTransaction.h>
+#include <ArduinoOcpp/Operations/StatusNotification.h>
+#include <ArduinoOcpp/Operations/StopTransaction.h>
 
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index b54a118e..5ad1bb31 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -2,25 +2,25 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Request.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 
-#include <ArduinoOcpp/MessagesV16/Authorize.h>
-#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
-#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
-#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Operations/Authorize.h>
+#include <ArduinoOcpp/Operations/StatusNotification.h>
+#include <ArduinoOcpp/Operations/StartTransaction.h>
+#include <ArduinoOcpp/Operations/StopTransaction.h>
+#include <ArduinoOcpp/Operations/CiStrings.h>
 
 #include <ArduinoOcpp/Debug.h>
 
-#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
-#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Model/Metering/MeteringService.h>
+#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
 
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index 73050c18..c2f3cc71 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -5,10 +5,10 @@
 #ifndef CONNECTOR_H
 #define CONNECTOR_H
 
-#include <ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h>
+#include <ArduinoOcpp/Model/ChargeControl/OcppEvseState.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
-#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Operations/CiStrings.h>
 
 #include <vector>
 #include <functional>
diff --git a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
index fb51b9af..c92d436f 100644
--- a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -2,15 +2,15 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
-#include <ArduinoOcpp/MessagesV16/GetDiagnostics.h>
-#include <ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h>
+#include <ArduinoOcpp/Operations/GetDiagnostics.h>
+#include <ArduinoOcpp/Operations/DiagnosticsStatusNotification.h>
 
 using namespace ArduinoOcpp;
 using Ocpp16::DiagnosticsStatus;
diff --git a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
index bc219100..91034cb6 100644
--- a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -8,7 +8,7 @@
 #include <functional>
 #include <memory>
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h>
+#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsStatus.h>
 #include <string>
 
 namespace ArduinoOcpp {
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 6a4b5da2..8e47b5b3 100644
--- a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -2,17 +2,17 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/OperationRegistry.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 
-#include <ArduinoOcpp/MessagesV16/UpdateFirmware.h>
-#include <ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h>
+#include <ArduinoOcpp/Operations/UpdateFirmware.h>
+#include <ArduinoOcpp/Operations/FirmwareStatusNotification.h>
 
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h
index a2440787..1646cfdf 100644
--- a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h
+++ b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h
@@ -9,7 +9,7 @@
 #include <memory>
 
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
-#include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h>
+#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareStatus.h>
 #include <ArduinoOcpp/Core/Time.h>
 
 namespace ArduinoOcpp {
diff --git a/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
index 9fa4a0a9..5ab458da 100644
--- a/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
+++ b/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
@@ -2,11 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
-#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Model/Heartbeat/HeartbeatService.h>
+#include <ArduinoOcpp/Context.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/MessagesV16/Heartbeat.h>
+#include <ArduinoOcpp/Operations/Heartbeat.h>
 #include <ArduinoOcpp/Platform.h>
 
 using namespace ArduinoOcpp;
diff --git a/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp
index 9c394d89..58574be7 100644
--- a/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp
@@ -2,12 +2,12 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h>
-#include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h>
+#include <ArduinoOcpp/Model/Metering/MeterStore.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/MessagesV16/MeterValues.h>
+#include <ArduinoOcpp/Operations/MeterValues.h>
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h
index 1610704c..6345c1fd 100644
--- a/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h
@@ -9,9 +9,9 @@
 #include <memory>
 #include <vector>
 
-#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
-#include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Metering/MeterValue.h>
+#include <ArduinoOcpp/Model/Metering/MeterStore.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 
 namespace ArduinoOcpp {
diff --git a/src/ArduinoOcpp/Model/Metering/MeterStore.cpp b/src/ArduinoOcpp/Model/Metering/MeterStore.cpp
index 6580afe5..3421c132 100644
--- a/src/ArduinoOcpp/Model/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeterStore.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
+#include <ArduinoOcpp/Model/Metering/MeterStore.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 
 #include <ArduinoOcpp/Debug.h>
diff --git a/src/ArduinoOcpp/Model/Metering/MeterStore.h b/src/ArduinoOcpp/Model/Metering/MeterStore.h
index a64dc35f..d7be981b 100644
--- a/src/ArduinoOcpp/Model/Metering/MeterStore.h
+++ b/src/ArduinoOcpp/Model/Metering/MeterStore.h
@@ -5,8 +5,8 @@
 #ifndef METERSTORE_H
 #define METERSTORE_H
 
-#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Metering/MeterValue.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
 #include <vector>
diff --git a/src/ArduinoOcpp/Model/Metering/MeterValue.cpp b/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
index 3092f03d..b05ef612 100644
--- a/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
+#include <ArduinoOcpp/Model/Metering/MeterValue.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Model/Metering/MeterValue.h b/src/ArduinoOcpp/Model/Metering/MeterValue.h
index b5764e8a..9a5505f7 100644
--- a/src/ArduinoOcpp/Model/Metering/MeterValue.h
+++ b/src/ArduinoOcpp/Model/Metering/MeterValue.h
@@ -6,7 +6,7 @@
 #define METERVALUE_H
 
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
+#include <ArduinoOcpp/Model/Metering/SampledValue.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoJson.h>
 #include <memory>
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
index 3f55f244..c571b151 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
@@ -2,12 +2,12 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Model/Metering/MeteringService.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <ArduinoOcpp/Context.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/MessagesV16/MeterValues.h>
+#include <ArduinoOcpp/Operations/MeterValues.h>
 #include <ArduinoOcpp/Debug.h>
 
 using namespace ArduinoOcpp;
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringService.h b/src/ArduinoOcpp/Model/Metering/MeteringService.h
index 180807af..e41eec88 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Model/Metering/MeteringService.h
@@ -9,9 +9,9 @@
 #include <vector>
 #include <memory>
 
-#include <ArduinoOcpp/Tasks/Metering/ConnectorMeterValuesRecorder.h>
-#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
-#include <ArduinoOcpp/Tasks/Metering/MeterStore.h>
+#include <ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h>
+#include <ArduinoOcpp/Model/Metering/SampledValue.h>
+#include <ArduinoOcpp/Model/Metering/MeterStore.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Model/Metering/SampledValue.cpp b/src/ArduinoOcpp/Model/Metering/SampledValue.cpp
index c3a0b498..43e92400 100644
--- a/src/ArduinoOcpp/Model/Metering/SampledValue.cpp
+++ b/src/ArduinoOcpp/Model/Metering/SampledValue.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
+#include <ArduinoOcpp/Model/Metering/SampledValue.h>
 #include <ArduinoOcpp/Debug.h>
 #include <cinttypes>
 
diff --git a/src/ArduinoOcpp/Model/Model.cpp b/src/ArduinoOcpp/Model/Model.cpp
index 2d14160e..d2285094 100644
--- a/src/ArduinoOcpp/Model/Model.cpp
+++ b/src/ArduinoOcpp/Model/Model.cpp
@@ -2,18 +2,18 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/ChargeControlCommon.h>
-#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
-#include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
-#include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Tasks/Heartbeat/HeartbeatService.h>
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Tasks/Boot/BootService.h>
-#include <ArduinoOcpp/Tasks/Reset/ResetService.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h>
+#include <ArduinoOcpp/Model/Metering/MeteringService.h>
+#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
+#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
+#include <ArduinoOcpp/Model/Heartbeat/HeartbeatService.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Model/Boot/BootService.h>
+#include <ArduinoOcpp/Model/Reset/ResetService.h>
 
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Model/Model.h b/src/ArduinoOcpp/Model/Model.h
index f6a4bc5c..d7cf006e 100644
--- a/src/ArduinoOcpp/Model/Model.h
+++ b/src/ArduinoOcpp/Model/Model.h
@@ -8,7 +8,7 @@
 #include <memory>
 
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Model/Reservation/Reservation.cpp b/src/ArduinoOcpp/Model/Reservation/Reservation.cpp
index 09b6f349..94d51617 100644
--- a/src/ArduinoOcpp/Model/Reservation/Reservation.cpp
+++ b/src/ArduinoOcpp/Model/Reservation/Reservation.cpp
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Reservation/Reservation.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Model/Reservation/Reservation.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Debug.h>
 
 #ifndef RESERVATION_FN
diff --git a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
index 1c056007..457b5712 100644
--- a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
@@ -2,13 +2,13 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
-#include <ArduinoOcpp/MessagesV16/CancelReservation.h>
-#include <ArduinoOcpp/MessagesV16/ReserveNow.h>
+#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <ArduinoOcpp/Operations/CancelReservation.h>
+#include <ArduinoOcpp/Operations/ReserveNow.h>
 
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Model/Reservation/ReservationService.h b/src/ArduinoOcpp/Model/Reservation/ReservationService.h
index 55bbc852..38fb807c 100644
--- a/src/ArduinoOcpp/Model/Reservation/ReservationService.h
+++ b/src/ArduinoOcpp/Model/Reservation/ReservationService.h
@@ -5,7 +5,7 @@
 #ifndef RESERVATIONSERVICE_H
 #define RESERVATIONSERVICE_H
 
-#include <ArduinoOcpp/Tasks/Reservation/Reservation.h>
+#include <ArduinoOcpp/Model/Reservation/Reservation.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Model/Reset/ResetService.cpp b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
index e1cfadad..637b23f5 100644
--- a/src/ArduinoOcpp/Model/Reset/ResetService.cpp
+++ b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
@@ -2,17 +2,17 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Reset/ResetService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Model/Reset/ResetService.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/MessagesV16/Reset.h>
+#include <ArduinoOcpp/Operations/Reset.h>
 
-#include <ArduinoOcpp/MessagesV16/Authorize.h>
-#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
-#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
+#include <ArduinoOcpp/Operations/Authorize.h>
+#include <ArduinoOcpp/Operations/StartTransaction.h>
+#include <ArduinoOcpp/Operations/StatusNotification.h>
+#include <ArduinoOcpp/Operations/StopTransaction.h>
 
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
index 6195801a..30613312 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h>
 #include <ArduinoOcpp/Debug.h>
 
 #include <string.h>
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
index f4a1fc5b..fbf94e1b 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -2,13 +2,13 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
-#include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
-#include <ArduinoOcpp/MessagesV16/SetChargingProfile.h>
+#include <ArduinoOcpp/Operations/ClearChargingProfile.h>
+#include <ArduinoOcpp/Operations/GetCompositeSchedule.h>
+#include <ArduinoOcpp/Operations/SetChargingProfile.h>
 #include <ArduinoOcpp/Debug.h>
 
 #if !defined(AO_DEACTIVATE_FLASH) && defined(AO_DEACTIVATE_FLASH_SMARTCHARGING)
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
index e616ef57..94249ae8 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
@@ -12,7 +12,7 @@
 #include <ArduinoJson.h>
 #include <functional>
 
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/Time.h>
 
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
index c5ef958a..540457e3 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
 
 using namespace ArduinoOcpp;
 
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.h b/src/ArduinoOcpp/Model/Transactions/Transaction.h
index 622c4423..f10d1c6b 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.h
@@ -6,7 +6,7 @@
 #define TRANSACTION_H
 
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Operations/CiStrings.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
index 718aa24e..fa645f0d 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Transactions/TransactionDeserialize.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionDeserialize.h>
 #include <ArduinoOcpp/Debug.h>
 
 namespace ArduinoOcpp {
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
index 7e17a583..ccf80cc2 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
@@ -5,7 +5,7 @@
 #ifndef TRANSACTIONDESERIALIZE_H
 #define TRANSACTIONDESERIALIZE_H
 
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 
 #include <ArduinoJson.h>
 
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
index 77f40789..62f3e01a 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
@@ -2,11 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionDeSerialize.h>
-#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
-#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionDeSerialize.h>
+#include <ArduinoOcpp/Operations/StartTransaction.h>
+#include <ArduinoOcpp/Operations/StopTransaction.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Debug.h>
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionStore.h b/src/ArduinoOcpp/Model/Transactions/TransactionStore.h
index d0c451b8..04dfbb11 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionStore.h
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionStore.h
@@ -5,7 +5,7 @@
 #ifndef TRANSACTIONSTORE_H
 #define TRANSACTIONSTORE_H
 
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <deque>
diff --git a/src/ArduinoOcpp/Operations/Authorize.cpp b/src/ArduinoOcpp/Operations/Authorize.cpp
index 81bc7ae2..3c848c2b 100644
--- a/src/ArduinoOcpp/Operations/Authorize.cpp
+++ b/src/ArduinoOcpp/Operations/Authorize.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/Authorize.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Operations/Authorize.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
 
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Operations/Authorize.h b/src/ArduinoOcpp/Operations/Authorize.h
index c75c611d..335a8412 100644
--- a/src/ArduinoOcpp/Operations/Authorize.h
+++ b/src/ArduinoOcpp/Operations/Authorize.h
@@ -6,7 +6,7 @@
 #define AUTHORIZE_H
 
 #include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Operations/CiStrings.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Operations/BootNotification.cpp b/src/ArduinoOcpp/Operations/BootNotification.cpp
index 5cd9efd5..be43b585 100644
--- a/src/ArduinoOcpp/Operations/BootNotification.cpp
+++ b/src/ArduinoOcpp/Operations/BootNotification.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/BootNotification.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Boot/BootService.h>
+#include <ArduinoOcpp/Operations/BootNotification.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Boot/BootService.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Operations/BootNotification.h b/src/ArduinoOcpp/Operations/BootNotification.h
index cf073475..57eac862 100644
--- a/src/ArduinoOcpp/Operations/BootNotification.h
+++ b/src/ArduinoOcpp/Operations/BootNotification.h
@@ -6,7 +6,7 @@
 #define BOOTNOTIFICATION_H
 
 #include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Operations/CiStrings.h>
 
 #define CP_MODEL_LEN_MAX        CiString20TypeLen
 #define CP_SERIALNUMBER_LEN_MAX CiString25TypeLen
diff --git a/src/ArduinoOcpp/Operations/CancelReservation.cpp b/src/ArduinoOcpp/Operations/CancelReservation.cpp
index 633900ac..04433b6f 100644
--- a/src/ArduinoOcpp/Operations/CancelReservation.cpp
+++ b/src/ArduinoOcpp/Operations/CancelReservation.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/CancelReservation.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Operations/CancelReservation.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::CancelReservation;
diff --git a/src/ArduinoOcpp/Operations/ChangeAvailability.cpp b/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
index 0a034366..c9b12f7f 100644
--- a/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
+++ b/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/ChangeAvailability.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Operations/ChangeAvailability.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 
 #include <functional>
 
diff --git a/src/ArduinoOcpp/Operations/ChangeConfiguration.cpp b/src/ArduinoOcpp/Operations/ChangeConfiguration.cpp
index e4dc17b0..aebfa9c3 100644
--- a/src/ArduinoOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/ArduinoOcpp/Operations/ChangeConfiguration.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/ChangeConfiguration.h>
+#include <ArduinoOcpp/Operations/ChangeConfiguration.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Operations/ClearCache.cpp b/src/ArduinoOcpp/Operations/ClearCache.cpp
index 10661052..15e4789e 100644
--- a/src/ArduinoOcpp/Operations/ClearCache.cpp
+++ b/src/ArduinoOcpp/Operations/ClearCache.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/ClearCache.h>
+#include <ArduinoOcpp/Operations/ClearCache.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp b/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
index 26923568..d42281a3 100644
--- a/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
+++ b/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/ClearChargingProfile.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Operations/ClearChargingProfile.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
 #include <functional>
diff --git a/src/ArduinoOcpp/Operations/CustomOperation.cpp b/src/ArduinoOcpp/Operations/CustomOperation.cpp
index 841d530b..f600a19d 100644
--- a/src/ArduinoOcpp/Operations/CustomOperation.cpp
+++ b/src/ArduinoOcpp/Operations/CustomOperation.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/CustomOperation.h>
+#include <ArduinoOcpp/Operations/CustomOperation.h>
 
 using ArduinoOcpp::Ocpp16::CustomOperation;
 
diff --git a/src/ArduinoOcpp/Operations/DataTransfer.cpp b/src/ArduinoOcpp/Operations/DataTransfer.cpp
index 72103581..da46e054 100644
--- a/src/ArduinoOcpp/Operations/DataTransfer.cpp
+++ b/src/ArduinoOcpp/Operations/DataTransfer.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/DataTransfer.h>
+#include <ArduinoOcpp/Operations/DataTransfer.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::DataTransfer;
diff --git a/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp b/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
index bcc43b69..a6fc7169 100644
--- a/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
+++ b/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
@@ -2,10 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/DiagnosticsStatusNotification.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
+#include <ArduinoOcpp/Operations/DiagnosticsStatusNotification.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
 
 using ArduinoOcpp::Ocpp16::DiagnosticsStatusNotification;
 
diff --git a/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.h b/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.h
index c68938da..87f95368 100644
--- a/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.h
+++ b/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.h
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsStatus.h>
+#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsStatus.h>
 
 #ifndef DIAGNOSTICSSTATUSNOTIFICATION_H
 #define DIAGNOSTICSSTATUSNOTIFICATION_H
diff --git a/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp b/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
index f5b91845..b25c49dc 100644
--- a/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
+++ b/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
@@ -2,10 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/FirmwareStatusNotification.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
+#include <ArduinoOcpp/Operations/FirmwareStatusNotification.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
 
 using ArduinoOcpp::Ocpp16::FirmwareStatusNotification;
 
diff --git a/src/ArduinoOcpp/Operations/FirmwareStatusNotification.h b/src/ArduinoOcpp/Operations/FirmwareStatusNotification.h
index b9b91afc..99313946 100644
--- a/src/ArduinoOcpp/Operations/FirmwareStatusNotification.h
+++ b/src/ArduinoOcpp/Operations/FirmwareStatusNotification.h
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/Core/Operation.h>
 
-#include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareStatus.h>
+#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareStatus.h>
 
 #ifndef FIRMWARESTATUSNOTIFICATION_H
 #define FIRMWARESTATUSNOTIFICATION_H
diff --git a/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp b/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
index 7a329f3f..37958d31 100644
--- a/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
@@ -2,10 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/GetCompositeSchedule.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Operations/GetCompositeSchedule.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
 #include <functional>
diff --git a/src/ArduinoOcpp/Operations/GetCompositeSchedule.h b/src/ArduinoOcpp/Operations/GetCompositeSchedule.h
index dee0b167..ba8a64e4 100644
--- a/src/ArduinoOcpp/Operations/GetCompositeSchedule.h
+++ b/src/ArduinoOcpp/Operations/GetCompositeSchedule.h
@@ -7,7 +7,7 @@
 
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingModel.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Operations/GetConfiguration.cpp b/src/ArduinoOcpp/Operations/GetConfiguration.cpp
index 8720a384..3e1dbff8 100644
--- a/src/ArduinoOcpp/Operations/GetConfiguration.cpp
+++ b/src/ArduinoOcpp/Operations/GetConfiguration.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/GetConfiguration.h>
+#include <ArduinoOcpp/Operations/GetConfiguration.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Operations/GetDiagnostics.cpp b/src/ArduinoOcpp/Operations/GetDiagnostics.cpp
index 31ff8f1b..a3eaf975 100644
--- a/src/ArduinoOcpp/Operations/GetDiagnostics.cpp
+++ b/src/ArduinoOcpp/Operations/GetDiagnostics.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/GetDiagnostics.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Diagnostics/DiagnosticsService.h>
+#include <ArduinoOcpp/Operations/GetDiagnostics.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::GetDiagnostics;
diff --git a/src/ArduinoOcpp/Operations/GetLocalListVersion.cpp b/src/ArduinoOcpp/Operations/GetLocalListVersion.cpp
index 64869c0b..037fbf60 100644
--- a/src/ArduinoOcpp/Operations/GetLocalListVersion.cpp
+++ b/src/ArduinoOcpp/Operations/GetLocalListVersion.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/GetLocalListVersion.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Operations/GetLocalListVersion.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::GetLocalListVersion;
diff --git a/src/ArduinoOcpp/Operations/Heartbeat.cpp b/src/ArduinoOcpp/Operations/Heartbeat.cpp
index 7e0975c4..dbeb46ce 100644
--- a/src/ArduinoOcpp/Operations/Heartbeat.cpp
+++ b/src/ArduinoOcpp/Operations/Heartbeat.cpp
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/Heartbeat.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Operations/Heartbeat.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Debug.h>
 #include <string.h>
 
diff --git a/src/ArduinoOcpp/Operations/MeterValues.cpp b/src/ArduinoOcpp/Operations/MeterValues.cpp
index acb19d1a..d411da5c 100644
--- a/src/ArduinoOcpp/Operations/MeterValues.cpp
+++ b/src/ArduinoOcpp/Operations/MeterValues.cpp
@@ -2,10 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/MeterValues.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Operations/MeterValues.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Metering/MeterValue.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::MeterValues;
diff --git a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
index b80f75c2..afb2d011 100644
--- a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
@@ -3,11 +3,11 @@
 // MIT License
 
 
-#include <ArduinoOcpp/MessagesV16/RemoteStartTransaction.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Operations/RemoteStartTransaction.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::RemoteStartTransaction;
diff --git a/src/ArduinoOcpp/Operations/RemoteStartTransaction.h b/src/ArduinoOcpp/Operations/RemoteStartTransaction.h
index 0e66989a..a58e5d94 100644
--- a/src/ArduinoOcpp/Operations/RemoteStartTransaction.h
+++ b/src/ArduinoOcpp/Operations/RemoteStartTransaction.h
@@ -6,7 +6,7 @@
 #define REMOTESTARTTRANSACTION_H
 
 #include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Operations/CiStrings.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
index 489fa7c4..2490eaf0 100644
--- a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/RemoteStopTransaction.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Operations/RemoteStopTransaction.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 
 using ArduinoOcpp::Ocpp16::RemoteStopTransaction;
 
diff --git a/src/ArduinoOcpp/Operations/ReserveNow.cpp b/src/ArduinoOcpp/Operations/ReserveNow.cpp
index 7ea39588..d4840bea 100644
--- a/src/ArduinoOcpp/Operations/ReserveNow.cpp
+++ b/src/ArduinoOcpp/Operations/ReserveNow.cpp
@@ -2,10 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/ReserveNow.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Operations/ReserveNow.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Platform.h>
 
 using ArduinoOcpp::Ocpp16::ReserveNow;
diff --git a/src/ArduinoOcpp/Operations/Reset.cpp b/src/ArduinoOcpp/Operations/Reset.cpp
index c78b3be4..d217cf99 100644
--- a/src/ArduinoOcpp/Operations/Reset.cpp
+++ b/src/ArduinoOcpp/Operations/Reset.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/Reset.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Reset/ResetService.h>
+#include <ArduinoOcpp/Operations/Reset.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Reset/ResetService.h>
 
 using ArduinoOcpp::Ocpp16::Reset;
 
diff --git a/src/ArduinoOcpp/Operations/SendLocalList.cpp b/src/ArduinoOcpp/Operations/SendLocalList.cpp
index c7ef58b2..46e44b07 100644
--- a/src/ArduinoOcpp/Operations/SendLocalList.cpp
+++ b/src/ArduinoOcpp/Operations/SendLocalList.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/SendLocalList.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Operations/SendLocalList.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
 
 using ArduinoOcpp::Ocpp16::SendLocalList;
 
diff --git a/src/ArduinoOcpp/Operations/SetChargingProfile.cpp b/src/ArduinoOcpp/Operations/SetChargingProfile.cpp
index 8d093b2f..465c2463 100644
--- a/src/ArduinoOcpp/Operations/SetChargingProfile.cpp
+++ b/src/ArduinoOcpp/Operations/SetChargingProfile.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/SetChargingProfile.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Operations/SetChargingProfile.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::SetChargingProfile;
diff --git a/src/ArduinoOcpp/Operations/StartTransaction.cpp b/src/ArduinoOcpp/Operations/StartTransaction.cpp
index d75c7f3e..ce21e1d3 100644
--- a/src/ArduinoOcpp/Operations/StartTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/StartTransaction.cpp
@@ -2,13 +2,13 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/StartTransaction.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Operations/StartTransaction.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/RequestStore.h>
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Model/Metering/MeteringService.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::StartTransaction;
diff --git a/src/ArduinoOcpp/Operations/StartTransaction.h b/src/ArduinoOcpp/Operations/StartTransaction.h
index 7ad4a2fc..d742d38b 100644
--- a/src/ArduinoOcpp/Operations/StartTransaction.h
+++ b/src/ArduinoOcpp/Operations/StartTransaction.h
@@ -7,8 +7,8 @@
 
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/MessagesV16/CiStrings.h>
-#include <ArduinoOcpp/Tasks/Metering/SampledValue.h>
+#include <ArduinoOcpp/Operations/CiStrings.h>
+#include <ArduinoOcpp/Model/Metering/SampledValue.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.cpp b/src/ArduinoOcpp/Operations/StatusNotification.cpp
index 1b0fb083..238a0f4d 100644
--- a/src/ArduinoOcpp/Operations/StatusNotification.cpp
+++ b/src/ArduinoOcpp/Operations/StatusNotification.cpp
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Operations/StatusNotification.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Debug.h>
 
 #include <string.h>
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.h b/src/ArduinoOcpp/Operations/StatusNotification.h
index 61d4bbec..16b86491 100644
--- a/src/ArduinoOcpp/Operations/StatusNotification.h
+++ b/src/ArduinoOcpp/Operations/StatusNotification.h
@@ -7,7 +7,7 @@
 
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/OcppEvseState.h>
+#include <ArduinoOcpp/Model/ChargeControl/OcppEvseState.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
diff --git a/src/ArduinoOcpp/Operations/StopTransaction.cpp b/src/ArduinoOcpp/Operations/StopTransaction.cpp
index 5a73dbf7..8b16d814 100644
--- a/src/ArduinoOcpp/Operations/StopTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/StopTransaction.cpp
@@ -2,14 +2,14 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/StopTransaction.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Operations/StopTransaction.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/RequestStore.h>
-#include <ArduinoOcpp/Tasks/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
-#include <ArduinoOcpp/Tasks/Metering/MeterValue.h>
-#include <ArduinoOcpp/Tasks/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Tasks/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
+#include <ArduinoOcpp/Model/Metering/MeteringService.h>
+#include <ArduinoOcpp/Model/Metering/MeterValue.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::StopTransaction;
diff --git a/src/ArduinoOcpp/Operations/StopTransaction.h b/src/ArduinoOcpp/Operations/StopTransaction.h
index 6eed3894..c88a87d9 100644
--- a/src/ArduinoOcpp/Operations/StopTransaction.h
+++ b/src/ArduinoOcpp/Operations/StopTransaction.h
@@ -7,7 +7,7 @@
 
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/MessagesV16/CiStrings.h>
+#include <ArduinoOcpp/Operations/CiStrings.h>
 #include <vector>
 
 namespace ArduinoOcpp {
diff --git a/src/ArduinoOcpp/Operations/TriggerMessage.cpp b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
index ab8bbe38..6dfb2039 100644
--- a/src/ArduinoOcpp/Operations/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
@@ -2,12 +2,12 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/TriggerMessage.h>
-#include <ArduinoOcpp/Tasks/ChargeControl/Connector.h>
-#include <ArduinoOcpp/Tasks/Metering/MeteringService.h>
-#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Core/Context.h>
+#include <ArduinoOcpp/Operations/TriggerMessage.h>
+#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/Metering/MeteringService.h>
+#include <ArduinoOcpp/Operations/StatusNotification.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Context.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/src/ArduinoOcpp/Operations/UnlockConnector.cpp b/src/ArduinoOcpp/Operations/UnlockConnector.cpp
index 7cd94903..502e109d 100644
--- a/src/ArduinoOcpp/Operations/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/Operations/UnlockConnector.cpp
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/UnlockConnector.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Operations/UnlockConnector.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::UnlockConnector;
diff --git a/src/ArduinoOcpp/Operations/UpdateFirmware.cpp b/src/ArduinoOcpp/Operations/UpdateFirmware.cpp
index 360d5de8..9f13b625 100644
--- a/src/ArduinoOcpp/Operations/UpdateFirmware.cpp
+++ b/src/ArduinoOcpp/Operations/UpdateFirmware.cpp
@@ -2,9 +2,9 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/MessagesV16/UpdateFirmware.h>
-#include <ArduinoOcpp/Core/Model.h>
-#include <ArduinoOcpp/Tasks/FirmwareManagement/FirmwareService.h>
+#include <ArduinoOcpp/Operations/UpdateFirmware.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::UpdateFirmware;
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 02fcab36..c9d04f1d 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -1,11 +1,11 @@
 #include <ArduinoOcpp.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/MessagesV16/BootNotification.h>
-#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
+#include <ArduinoOcpp/Operations/BootNotification.h>
+#include <ArduinoOcpp/Operations/StatusNotification.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 100e826c..a08dfdbc 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -1,7 +1,7 @@
 #include <ArduinoOcpp.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 161c373e..17fe0eed 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -1,11 +1,11 @@
 #include <ArduinoOcpp.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Model.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/MessagesV16/BootNotification.h>
-#include <ArduinoOcpp/MessagesV16/StatusNotification.h>
+#include <ArduinoOcpp/Operations/BootNotification.h>
+#include <ArduinoOcpp/Operations/StatusNotification.h>
 #include <ArduinoOcpp/Debug.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"

From 443de651fb6e019ba92079fe8fa684a7aa681e90 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 17 Jun 2023 14:24:55 +0200
Subject: [PATCH 279/549] code cleanup

---
 src/ArduinoOcpp.cpp                           | 17 ++++++++++++-
 src/ArduinoOcpp.h                             | 21 ++++++++++++++--
 src/ArduinoOcpp/Context.cpp                   | 13 ++++------
 src/ArduinoOcpp/Context.h                     | 12 ++++------
 src/ArduinoOcpp/Core/Connection.h             |  4 ++--
 src/ArduinoOcpp/Core/Operation.h              |  4 ++--
 src/ArduinoOcpp/Core/OperationRegistry.h      |  4 ++--
 src/ArduinoOcpp/Core/Request.cpp              | 10 ++++----
 src/ArduinoOcpp/Core/Request.h                |  6 ++---
 src/ArduinoOcpp/Core/RequestCallbacks.h       |  4 ++--
 src/ArduinoOcpp/Core/RequestQueue.cpp         |  2 +-
 src/ArduinoOcpp/Core/RequestQueue.h           |  6 ++---
 .../Core/RequestQueueStorageStrategy.cpp      |  2 +-
 .../Core/RequestQueueStorageStrategy.h        |  4 ++--
 src/ArduinoOcpp/Core/RequestStore.h           |  4 ++--
 src/ArduinoOcpp/Core/SimpleRequestFactory.h   |  4 ++--
 src/ArduinoOcpp/Core/Time.h                   |  4 ++--
 .../ChargeControl/ChargeControlCommon.cpp     |  2 +-
 .../Model/ChargeControl/Connector.cpp         | 14 +++--------
 .../Model/ChargeControl/Connector.h           |  2 --
 src/ArduinoOcpp/Model/Model.h                 |  4 ++--
 .../SmartCharging/SmartChargingService.cpp    |  1 +
 src/ArduinoOcpp/Operations/CustomOperation.h  |  4 ++--
 src/ArduinoOcpp/Operations/TriggerMessage.cpp | 24 +++++++++----------
 src/ArduinoOcpp/Operations/TriggerMessage.h   |  6 ++---
 25 files changed, 97 insertions(+), 81 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index f48ecb87..72df9e5a 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -268,6 +268,20 @@ bool endTransaction(const char *reason, unsigned int connectorId) {
     return res;
 }
 
+bool isTransactionActive(unsigned int connectorId) {
+    if (!context) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return false;
+    }
+    auto connector = context->getModel().getConnector(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return false;
+    }
+    auto& tx = connector->getTransaction();
+    return tx ? tx->isActive() : false;
+}
+
 bool isTransactionRunning(unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
@@ -278,7 +292,8 @@ bool isTransactionRunning(unsigned int connectorId) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
-    return connector->isTransactionRunning();
+    auto& tx = connector->getTransaction();
+    return tx ? tx->isRunning() : false;
 }
 
 bool ocppPermitsCharge(unsigned int connectorId) {
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 2baa4fb7..ea82590d 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -142,9 +142,26 @@ std::shared_ptr<ArduinoOcpp::Transaction> beginTransaction_authorized(const char
 bool endTransaction(const char *reason = nullptr, unsigned int connectorId = 1);
 
 /*
- * Returns if the library has started the transaction by sending a StartTransaction and if it hasn't
- * been stopped already by sending a StopTransaction.
+ * Get information about the current Transaction lifecycle. A transaction can enter the following
+ * states:
+ *     - Idle: no transaction running or being started
+ *     - Preparing: before a potential transaction
+ *     - Aborted: transaction not started and never will be started
+ *     - Running: transaction started and running
+ *     - Running/StopTxAwait: transaction still running but will end at the next possible time
+ *     - Finished: transaction stopped
+ * 
+ * isTransactionActive() and isTransactionRunning() give the status by combining them:
+ * 
+ *     State               | isTransactionActive() | isTransactionRunning()
+ *     --------------------+-----------------------+-----------------------
+ *     Preparing           | true                  | false
+ *     Running             | true                  | true
+ *     Running/StopTxAwait | false                 | true
+ *     Finished / Aborted  |                       |
+ *                  / Idle | false                 | false
  */
+bool isTransactionActive(unsigned int connectorId = 1);
 bool isTransactionRunning(unsigned int connectorId = 1);
 
 /* 
diff --git a/src/ArduinoOcpp/Context.cpp b/src/ArduinoOcpp/Context.cpp
index 8184ad25..b6b51ef7 100644
--- a/src/ArduinoOcpp/Context.cpp
+++ b/src/ArduinoOcpp/Context.cpp
@@ -11,18 +11,15 @@
 
 using namespace ArduinoOcpp;
 
-Context *ArduinoOcpp::defaultContext = nullptr;
-
 Context::Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem)
-        : connection(connection), model{std::make_shared<Model>()}, reqQueue{operationRegistry, model, filesystem} {
-    defaultContext = this;
+        : connection(connection), model{}, reqQueue{operationRegistry, &model, filesystem} {
 
-    preBootQueue = std::unique_ptr<RequestQueue>(new RequestQueue(operationRegistry, model, nullptr)); //pre boot queue doesn't need persistency
+    preBootQueue = std::unique_ptr<RequestQueue>(new RequestQueue(operationRegistry, &model, nullptr)); //pre boot queue doesn't need persistency
     preBootQueue->setConnection(connection);
 }
 
 Context::~Context() {
-    defaultContext = nullptr;
+
 }
 
 void Context::loop() {
@@ -34,7 +31,7 @@ void Context::loop() {
         reqQueue.loop(connection);
     }
 
-    model->loop();
+    model.loop();
 }
 
 void Context::activatePostBootCommunication() {
@@ -61,7 +58,7 @@ void Context::initiatePreBootOperation(std::unique_ptr<Request> op) {
 }
 
 Model& Context::getModel() {
-    return *model;
+    return model;
 }
 
 OperationRegistry& Context::getOperationRegistry() {
diff --git a/src/ArduinoOcpp/Context.h b/src/ArduinoOcpp/Context.h
index d9fea7cc..d8a0b015 100644
--- a/src/ArduinoOcpp/Context.h
+++ b/src/ArduinoOcpp/Context.h
@@ -5,22 +5,22 @@
 #ifndef AO_CONTEXT_H
 #define AO_CONTEXT_H
 
-#include <ArduinoOcpp/Core/RequestQueue.h>
-#include <ArduinoOcpp/Core/OperationRegistry.h>
 #include <memory>
 
+#include <ArduinoOcpp/Core/OperationRegistry.h>
+#include <ArduinoOcpp/Core/RequestQueue.h>
+#include <ArduinoOcpp/Model/Model.h>
+
 namespace ArduinoOcpp {
 
 class Connection;
-class OperationRegistry;
-class Model;
 class FilesystemAdapter;
 
 class Context {
 private:
     Connection& connection;
     OperationRegistry operationRegistry;
-    std::shared_ptr<Model> model;
+    Model model;
     RequestQueue reqQueue;
 
     std::unique_ptr<RequestQueue> preBootQueue;
@@ -43,8 +43,6 @@ class Context {
     OperationRegistry& getOperationRegistry();
 };
 
-extern Context *defaultContext;
-
 } //end namespace ArduinoOcpp
 
 #endif
diff --git a/src/ArduinoOcpp/Core/Connection.h b/src/ArduinoOcpp/Core/Connection.h
index 07e37caa..f4487da7 100644
--- a/src/ArduinoOcpp/Core/Connection.h
+++ b/src/ArduinoOcpp/Core/Connection.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OCPPSOCKET_H
-#define OCPPSOCKET_H
+#ifndef AO_CONNECTION_H
+#define AO_CONNECTION_H
 
 #include <functional>
 #include <memory>
diff --git a/src/ArduinoOcpp/Core/Operation.h b/src/ArduinoOcpp/Core/Operation.h
index b5e005fe..4f13d3fd 100644
--- a/src/ArduinoOcpp/Core/Operation.h
+++ b/src/ArduinoOcpp/Core/Operation.h
@@ -15,8 +15,8 @@
  * OCPP operation.
  */
 
- #ifndef OCPPMESSAGE_H
- #define OCPPMESSAGE_H
+ #ifndef AO_OPERATION_H
+ #define AO_OPERATION_H
 
 #include <ArduinoJson.h>
 #include <memory>
diff --git a/src/ArduinoOcpp/Core/OperationRegistry.h b/src/ArduinoOcpp/Core/OperationRegistry.h
index 5b3d8c28..1ea2d5a3 100644
--- a/src/ArduinoOcpp/Core/OperationRegistry.h
+++ b/src/ArduinoOcpp/Core/OperationRegistry.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OPERATIONDESERIALIZER_H
-#define OPERATIONDESERIALIZER_H
+#ifndef AO_OPERATIONREGISTRY_H
+#define AO_OPERATIONREGISTRY_H
 
 #include <functional>
 #include <vector>
diff --git a/src/ArduinoOcpp/Core/Request.cpp b/src/ArduinoOcpp/Core/Request.cpp
index 5f824e25..72c7d378 100644
--- a/src/ArduinoOcpp/Core/Request.cpp
+++ b/src/ArduinoOcpp/Core/Request.cpp
@@ -278,7 +278,7 @@ void Request::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
     }
 }
 
-bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<Model> model) {
+bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *model) {
     if (!opStorage) {
         AO_DBG_ERR("invalid argument");
         return false;
@@ -314,10 +314,10 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, std::sh
 
     timeout_period = 0; //disable timeout by default for restored msgs
 
-    if (!strcmp(opType.c_str(), "StartTransaction")) { //TODO this will get a nicer solution
-        operation = std::unique_ptr<Operation>(new Ocpp16::StartTransaction(*model.get(), nullptr));
-    } else if (!strcmp(opType.c_str(), "StopTransaction")) {
-        operation = std::unique_ptr<Operation>(new Ocpp16::StopTransaction(*model.get(), nullptr));
+    if (!strcmp(opType.c_str(), "StartTransaction") && model) { //TODO this will get a nicer solution
+        operation = std::unique_ptr<Operation>(new Ocpp16::StartTransaction(*model, nullptr));
+    } else if (!strcmp(opType.c_str(), "StopTransaction") && model) {
+        operation = std::unique_ptr<Operation>(new Ocpp16::StopTransaction(*model, nullptr));
     }
 
     if (!operation) {
diff --git a/src/ArduinoOcpp/Core/Request.h b/src/ArduinoOcpp/Core/Request.h
index 4538267a..a522916d 100644
--- a/src/ArduinoOcpp/Core/Request.h
+++ b/src/ArduinoOcpp/Core/Request.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OCPPOPERATION_H
-#define OCPPOPERATION_H
+#ifndef AO_REQUEST_H
+#define AO_REQUEST_H
 
 #define MESSAGE_TYPE_CALL 2
 #define MESSAGE_TYPE_CALLRESULT 3
@@ -89,7 +89,7 @@ class Request {
 
     void initiate(std::unique_ptr<StoredOperationHandler> opStorage);
 
-    bool restore(std::unique_ptr<StoredOperationHandler> opStorage, std::shared_ptr<Model> model);
+    bool restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *model);
 
     StoredOperationHandler *getStorageHandler() {return opStore.get();}
 
diff --git a/src/ArduinoOcpp/Core/RequestCallbacks.h b/src/ArduinoOcpp/Core/RequestCallbacks.h
index ab919635..a2e0dcc5 100644
--- a/src/ArduinoOcpp/Core/RequestCallbacks.h
+++ b/src/ArduinoOcpp/Core/RequestCallbacks.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OCPP_OPERATION_CALLBACKS
-#define OCPP_OPERATION_CALLBACKS
+#ifndef AO_REQUESTCALLBACKS_H
+#define AO_REQUESTCALLBACKS_H
 
 #include <ArduinoJson.h>
 #include <functional>
diff --git a/src/ArduinoOcpp/Core/RequestQueue.cpp b/src/ArduinoOcpp/Core/RequestQueue.cpp
index c8858bc4..7c840884 100644
--- a/src/ArduinoOcpp/Core/RequestQueue.cpp
+++ b/src/ArduinoOcpp/Core/RequestQueue.cpp
@@ -16,7 +16,7 @@ size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_siz
 
 using namespace ArduinoOcpp;
 
-RequestQueue::RequestQueue(OperationRegistry& operationRegistry, std::shared_ptr<Model> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
+RequestQueue::RequestQueue(OperationRegistry& operationRegistry, Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
             : operationRegistry(operationRegistry) {
     
     if (filesystem) {
diff --git a/src/ArduinoOcpp/Core/RequestQueue.h b/src/ArduinoOcpp/Core/RequestQueue.h
index 5ddd0f0b..63f5c459 100644
--- a/src/ArduinoOcpp/Core/RequestQueue.h
+++ b/src/ArduinoOcpp/Core/RequestQueue.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OCPPCONNECTION_H
-#define OCPPCONNECTION_H
+#ifndef AO_REQUESTQUEUE_H
+#define AO_REQUESTQUEUE_H
 
 #include <ArduinoOcpp/Core/RequestQueueStorageStrategy.h>
 
@@ -36,7 +36,7 @@ class RequestQueue {
     const unsigned long BACKOFF_PERIOD_MAX = 65536;
     const unsigned long BACKOFF_PERIOD_INCREMENT = BACKOFF_PERIOD_MAX / 4;
 public:
-    RequestQueue(OperationRegistry& operationRegistry, std::shared_ptr<Model> baseModel, std::shared_ptr<FilesystemAdapter> filesystem = nullptr);
+    RequestQueue(OperationRegistry& operationRegistry, Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem = nullptr);
 
     void setConnection(Connection& sock);
 
diff --git a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
index 7c88fc9f..0b948318 100644
--- a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
+++ b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
@@ -52,7 +52,7 @@ void VolatileRequestQueue::drop_if(std::function<bool(std::unique_ptr<Request>&)
     queue.erase(std::remove_if(queue.begin(), queue.end(), pred), queue.end());
 }
 
-PersistentRequestQueue::PersistentRequestQueue(std::shared_ptr<Model> baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
+PersistentRequestQueue::PersistentRequestQueue(Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
             : opStore(filesystem), baseModel(baseModel) { }
 
 PersistentRequestQueue::~PersistentRequestQueue() {
diff --git a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h
index 13927be0..f7844231 100644
--- a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h
+++ b/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h
@@ -47,13 +47,13 @@ class VolatileRequestQueue : public RequestQueueStorageStrategy {
 class PersistentRequestQueue : public RequestQueueStorageStrategy {
 private:
     RequestStore opStore;
-    std::shared_ptr<Model> baseModel;
+    Model *baseModel;
 
     std::unique_ptr<Request> head;
     std::deque<std::unique_ptr<Request>> tailCache;
 public:
 
-    PersistentRequestQueue(std::shared_ptr<Model> baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
+    PersistentRequestQueue(Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
     ~PersistentRequestQueue();
 
     Request *front() override;
diff --git a/src/ArduinoOcpp/Core/RequestStore.h b/src/ArduinoOcpp/Core/RequestStore.h
index 68e51cbd..570696bd 100644
--- a/src/ArduinoOcpp/Core/RequestStore.h
+++ b/src/ArduinoOcpp/Core/RequestStore.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OPERATIONSTORE_H
-#define OPERATIONSTORE_H
+#ifndef AO_REQUESTSTORE_H
+#define AO_REQUESTSTORE_H
 
 #include <memory>
 #include <deque>
diff --git a/src/ArduinoOcpp/Core/SimpleRequestFactory.h b/src/ArduinoOcpp/Core/SimpleRequestFactory.h
index 94af6333..3853bcc7 100644
--- a/src/ArduinoOcpp/Core/SimpleRequestFactory.h
+++ b/src/ArduinoOcpp/Core/SimpleRequestFactory.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef SIMPLEOCPPOPERATIONFACTORY_H
-#define SIMPLEOCPPOPERATIONFACTORY_H
+#ifndef AO_SIMPLEREQUESTFACTORY_H
+#define AO_SIMPLEREQUESTFACTORY_H
 
 #include <ArduinoJson.h>
 #include <ArduinoOcpp/Core/Request.h>
diff --git a/src/ArduinoOcpp/Core/Time.h b/src/ArduinoOcpp/Core/Time.h
index 2367d32c..21ab36cd 100644
--- a/src/ArduinoOcpp/Core/Time.h
+++ b/src/ArduinoOcpp/Core/Time.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OCPPTIME_H
-#define OCPPTIME_H
+#ifndef AO_TIME_H
+#define AO_TIME_H
 
 #include <functional>
 #include <stdint.h>
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
index b0206c0b..8a1706c1 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
@@ -72,7 +72,7 @@ ChargeControlCommon::ChargeControlCommon(Context& context, unsigned int numConn,
     context.getOperationRegistry().registerOperation("Reset", [&context] () {
         return new Ocpp16::Reset(context.getModel());});
     context.getOperationRegistry().registerOperation("TriggerMessage", [&context] () {
-        return new Ocpp16::TriggerMessage(context.getModel());});
+        return new Ocpp16::TriggerMessage(context);});
     context.getOperationRegistry().registerOperation("UnlockConnector", [&context] () {
         return new Ocpp16::UnlockConnector(context.getModel());});
 
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index 5ad1bb31..ea27de29 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -142,7 +142,7 @@ bool Connector::ocppPermitsCharge() {
 
 void Connector::loop() {
 
-    if (!isTransactionRunning()) {
+    if (!transaction || !transaction->isRunning()) {
         if (*availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
             *availability = AVAILABILITY_INOPERATIVE;
             configuration_save();
@@ -732,14 +732,6 @@ uint16_t Connector::getSessionWriteCount() {
     return transaction ? transaction->getTxNr() : 0;
 }
 
-bool Connector::isTransactionRunning() {
-    if (!transaction) {
-        return false;
-    }
-
-    return transaction->isRunning();
-}
-
 int Connector::getTransactionId() {
     
     if (!transaction) {
@@ -775,7 +767,7 @@ void Connector::setAvailability(bool available) {
     if (available) {
         *availability = AVAILABILITY_OPERATIVE;
     } else {
-        if (isTransactionRunning()) {
+        if (transaction && transaction->isRunning()) {
             *availability = AVAILABILITY_INOPERATIVE_SCHEDULED;
         } else {
             *availability = AVAILABILITY_INOPERATIVE;
@@ -788,7 +780,7 @@ void Connector::setAvailabilityVolatile(bool available) {
     if (available) {
         availabilityVolatile = AVAILABILITY_OPERATIVE;
     } else {
-        if (isTransactionRunning()) {
+        if (!transaction || !transaction->isRunning()) {
             availabilityVolatile = AVAILABILITY_INOPERATIVE_SCHEDULED;
         } else {
             availabilityVolatile = AVAILABILITY_INOPERATIVE;
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index c2f3cc71..a69a6ac8 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -90,9 +90,7 @@ class Connector {
     void endTransaction(const char *reason = nullptr);
     const char *getSessionIdTag();
     uint16_t getSessionWriteCount();
-    bool isTransactionRunning();
     int getTransactionId();
-    int getTransactionIdSync();
     std::shared_ptr<Transaction>& getTransaction();
 
     //create detached transaction - won't have any side-effects with the transaction handling of this lib
diff --git a/src/ArduinoOcpp/Model/Model.h b/src/ArduinoOcpp/Model/Model.h
index d7cf006e..c093cb72 100644
--- a/src/ArduinoOcpp/Model/Model.h
+++ b/src/ArduinoOcpp/Model/Model.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OCPPMODEL_H
-#define OCPPMODEL_H
+#ifndef AO_MODEL_H
+#define AO_MODEL_H
 
 #include <memory>
 
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
index fbf94e1b..6f4d863f 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -5,6 +5,7 @@
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Operations/ClearChargingProfile.h>
 #include <ArduinoOcpp/Operations/GetCompositeSchedule.h>
diff --git a/src/ArduinoOcpp/Operations/CustomOperation.h b/src/ArduinoOcpp/Operations/CustomOperation.h
index 7b7d1018..fad204a8 100644
--- a/src/ArduinoOcpp/Operations/CustomOperation.h
+++ b/src/ArduinoOcpp/Operations/CustomOperation.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef FUNCTIONALMESSAGE_H
-#define FUNCTIONALMESSAGE_H
+#ifndef AO_CUSTOMOPERATION_H
+#define AO_CUSTOMOPERATION_H
 
 #include <ArduinoOcpp/Core/Operation.h>
 
diff --git a/src/ArduinoOcpp/Operations/TriggerMessage.cpp b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
index 6dfb2039..b5466aca 100644
--- a/src/ArduinoOcpp/Operations/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
@@ -13,7 +13,7 @@
 
 using ArduinoOcpp::Ocpp16::TriggerMessage;
 
-TriggerMessage::TriggerMessage(Model& model) : model(model) {
+TriggerMessage::TriggerMessage(Context& context) : context(context) {
 
 }
 
@@ -31,7 +31,7 @@ void TriggerMessage::processReq(JsonObject payload) {
     statusMessage = "Rejected";
 
     if (!strcmp(requestedMessage, "MeterValues")) {
-        if (auto mService = model.getMeteringService()) {
+        if (auto mService = context.getModel().getMeteringService()) {
             if (connectorId < 0) {
                 auto nConnectors = mService->getNumConnectors();
                 for (decltype(nConnectors) cId = 0; cId < nConnectors; cId++) {
@@ -46,8 +46,8 @@ void TriggerMessage::processReq(JsonObject payload) {
     } else if (!strcmp(requestedMessage, "StatusNotification")) {
         unsigned int cIdRangeBegin = 0, cIdRangeEnd = 0;
         if (connectorId < 0) {
-            cIdRangeEnd = model.getNumConnectors();
-        } else if ((unsigned int) connectorId < model.getNumConnectors()) {
+            cIdRangeEnd = context.getModel().getNumConnectors();
+        } else if ((unsigned int) connectorId < context.getModel().getNumConnectors()) {
             cIdRangeBegin = connectorId;
             cIdRangeEnd = connectorId + 1;
         } else {
@@ -55,19 +55,19 @@ void TriggerMessage::processReq(JsonObject payload) {
         }
 
         for (auto i = cIdRangeBegin; i < cIdRangeEnd; i++) {
-            auto connector = model.getConnector(i);
+            auto connector = context.getModel().getConnector(i);
 
             auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
                         i,
                         connector->inferenceStatus(), //will be determined in StatusNotification::initiate
-                        model.getClock().now()));
+                        context.getModel().getClock().now()));
 
             statusNotification->setTimeout(60000);
 
             triggeredOperations.push_back(std::move(statusNotification));
         }
     } else {
-        auto msg = defaultContext->getOperationRegistry().deserializeOperation(requestedMessage);
+        auto msg = context.getOperationRegistry().deserializeOperation(requestedMessage);
         if (msg) {
             triggeredOperations.push_back(std::move(msg));
         } else {
@@ -93,12 +93,10 @@ std::unique_ptr<DynamicJsonDocument> TriggerMessage::createConf(){
     
     payload["status"] = statusMessage;
 
-    if (defaultContext) {
-        auto op = triggeredOperations.begin();
-        while (op != triggeredOperations.end()) {
-            defaultContext->initiatePreBootOperation(std::move(triggeredOperations.front()));
-            op = triggeredOperations.erase(op);
-        }
+    auto op = triggeredOperations.begin();
+    while (op != triggeredOperations.end()) {
+        context.initiatePreBootOperation(std::move(triggeredOperations.front()));
+        op = triggeredOperations.erase(op);
     }
 
     return doc;
diff --git a/src/ArduinoOcpp/Operations/TriggerMessage.h b/src/ArduinoOcpp/Operations/TriggerMessage.h
index 380496d1..ca0b2c87 100644
--- a/src/ArduinoOcpp/Operations/TriggerMessage.h
+++ b/src/ArduinoOcpp/Operations/TriggerMessage.h
@@ -11,20 +11,20 @@
 
 namespace ArduinoOcpp {
 
-class Model;
+class Context;
 class Request;
 
 namespace Ocpp16 {
 
 class TriggerMessage : public Operation {
 private:
-    Model& model;
+    Context& context;
     std::vector<std::unique_ptr<Request>> triggeredOperations;
     const char *statusMessage {nullptr};
 
     const char *errorCode = nullptr;
 public:
-    TriggerMessage(Model& model);
+    TriggerMessage(Context& context);
 
     const char* getOperationType();
 

From c53f707c4ef91f654d10cafcdd650ef3608bcdf4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 20 Jun 2023 17:57:38 +0200
Subject: [PATCH 280/549] Smart Charging multiple connectors + safety update

---
 CMakeLists.txt                                |   1 +
 src/ArduinoOcpp.cpp                           |  75 +-
 src/ArduinoOcpp.h                             |   6 +-
 .../SmartCharging/SmartChargingModel.cpp      | 588 ++++++-----
 .../Model/SmartCharging/SmartChargingModel.h  |  87 +-
 .../SmartCharging/SmartChargingService.cpp    | 990 ++++++++++--------
 .../SmartCharging/SmartChargingService.h      | 123 ++-
 .../Transactions/TransactionDeserialize.cpp   |   2 +-
 .../Operations/ClearChargingProfile.cpp       |  18 +-
 .../Operations/ClearChargingProfile.h         |   6 +-
 .../Operations/GetCompositeSchedule.cpp       |  74 +-
 .../Operations/GetCompositeSchedule.h         |  11 +-
 .../Operations/RemoteStartTransaction.cpp     | 106 +-
 .../Operations/RemoteStartTransaction.h       |   6 +-
 .../Operations/SetChargingProfile.cpp         |  76 +-
 .../Operations/SetChargingProfile.h           |  16 +-
 src/ArduinoOcpp_c.cpp                         |   4 +-
 tests/ChargingSessions.cpp                    |   2 +-
 tests/SmartCharging.cpp                       | 572 ++++++++++
 19 files changed, 1868 insertions(+), 895 deletions(-)
 create mode 100644 tests/SmartCharging.cpp

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 5211a98a..8c3e85cb 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -116,6 +116,7 @@ set(AO_SRC_UNIT
     tests/TransactionSafety.cpp
     tests/ChargingSessions.cpp
     tests/ConfigurationBehavior.cpp
+    tests/SmartCharging.cpp
 )
 
 add_executable(ao_unit_tests
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 72df9e5a..15585d2b 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -371,21 +371,84 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
     model.getMeteringService()->addMeterValueSampler(connectorId, std::move(mvs));
 }
 
-void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
+void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
-    if (connectorId != 1) {
-        AO_DBG_WARN("Only one connector supported at the moment for Smart Charging");
+    if (!context->getModel().getConnector(connectorId)) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+
+    if (chargingLimitOutput) {
+        setSmartChargingOutput([chargingLimitOutput] (float power, float current, int nphases) -> void {
+            chargingLimitOutput(power);
+        }, connectorId);
+    } else {
+        setSmartChargingOutput(nullptr, connectorId);
+    }
+
+    if (auto scService = context->getModel().getSmartChargingService()) {
+        if (chargingLimitOutput) {
+            scService->updateAllowedChargingRateUnit(true, false);
+        } else {
+            scService->updateAllowedChargingRateUnit(false, false);
+        }
+    }
+}
+
+void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
+    if (!context) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    if (!context->getModel().getConnector(connectorId)) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+
+    if (chargingLimitOutput) {
+        setSmartChargingOutput([chargingLimitOutput] (float power, float current, int nphases) -> void {
+            chargingLimitOutput(current);
+        }, connectorId);
+    } else {
+        setSmartChargingOutput(nullptr, connectorId);
+    }
+
+    if (auto scService = context->getModel().getSmartChargingService()) {
+        if (chargingLimitOutput) {
+            scService->updateAllowedChargingRateUnit(false, true);
+        } else {
+            scService->updateAllowedChargingRateUnit(false, false);
+        }
+    }
+}
+
+void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOutput, unsigned int connectorId) {
+    if (!context) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
     }
+    if (!context->getModel().getConnector(connectorId)) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+
     auto& model = context->getModel();
-    if (!model.getSmartChargingService()) {
+    if (!model.getSmartChargingService() && chargingLimitOutput) {
         model.setSmartChargingService(std::unique_ptr<SmartChargingService>(
-            new SmartChargingService(*context, -1.f, voltage_eff, AO_NUMCONNECTORS, fileSystemOpt))); //default charging limit: 11kW
+            new SmartChargingService(*context, filesystem, AO_NUMCONNECTORS)));
+    }
+
+    if (auto scService = context->getModel().getSmartChargingService()) {
+        scService->setSmartChargingOutput(connectorId, chargingLimitOutput);
+        if (chargingLimitOutput) {
+            scService->updateAllowedChargingRateUnit(true, true);
+        } else {
+            scService->updateAllowedChargingRateUnit(false, false);
+        }
     }
-    model.getSmartChargingService()->setOnLimitChange(chargingLimitOutput);
 }
 
 void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorId) {
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index ea82590d..17b8f21b 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -198,7 +198,11 @@ void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connec
 
 void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId = 1); //Input of the power meter reading
 
-void setSmartChargingOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId = 1); //Output for the Smart Charging limit
+//Smart Charging Output, alternative for Watts only, Current only, or Watts x Current x numberPhases. Only one
+//of them can be set at a time
+void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId = 1); //Output (in Watts) for the Smart Charging limit
+void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId = 1); //Output (in Amps) for the Smart Charging limit
+void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOutput, unsigned int connectorId = 1); //Output (in Watts, Amps, numberPhases) for the Smart Charging limit
 
 /*
  * Define the Inputs and Outputs of this library. (Advanced)
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
index 30613312..ff22482f 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -10,125 +10,22 @@
 
 using namespace ArduinoOcpp;
 
-ChargingSchedulePeriod::ChargingSchedulePeriod(JsonObject &json){
-    startPeriod = json["startPeriod"];
-    limit = json["limit"]; //one fractural digit at most
-    numberPhases = json["numberPhases"] | -1;
+ChargeRate ArduinoOcpp::chargeRate_min(const ChargeRate& a, const ChargeRate& b) {
+    ChargeRate res;
+    res.power = std::min(a.power, b.power);
+    res.current = std::min(a.current, b.current);
+    res.nphases = std::min(a.nphases, b.nphases);
+    return res;
 }
 
-ChargingSchedulePeriod::ChargingSchedulePeriod(int startPeriod, float limit){
-    this->startPeriod = startPeriod;
-    this->limit = limit;
-    numberPhases = -1; //support later
-}
-
-int ChargingSchedulePeriod::getStartPeriod(){
-    return this->startPeriod;
-}
-
-float ChargingSchedulePeriod::getLimit(){
-    return this->limit;
-}
-
-void ChargingSchedulePeriod::scale(float factor){
-    limit *= factor;
-    if (limit < 0.f)
-        limit *= -1.f;
-}
-
-void ChargingSchedulePeriod::add(float value){
-    limit += value;
-    if (limit < 0.f)
-        limit = 0;
-}
-
-int ChargingSchedulePeriod::getNumberPhases(){
-    return this->numberPhases;
-}
-
-void ChargingSchedulePeriod::printPeriod(){
-    AO_DBG_VERBOSE("CHARGING SCHEDULE PERIOD:\n" \
-                "      startPeriod: %i\n" \
-                "      limit: %f\n" \
-                "      numberPhases: %i\n",
-                startPeriod,
-                limit,
-                numberPhases);
-}
-
-ChargingSchedule::ChargingSchedule(JsonObject &json, ChargingProfileKindType chargingProfileKind, RecurrencyKindType recurrencyKind)
-      : chargingProfileKind(chargingProfileKind)
-      , recurrencyKind(recurrencyKind) {  
-  
-    duration = json["duration"] | -1;
-    startSchedule = Timestamp();
-    if (!startSchedule.setTime(json["startSchedule"] | "Invalid")) {
-        //non-success
-        startSchedule = MIN_TIME;
-    }
-    const char *unit = json["chargingRateUnit"] | "__Invalid";
-    if (unit[0] == 'a' || unit[0] == 'A') {
-        chargingRateUnit = ChargingRateUnitType::Amp;
-    } else {
-        chargingRateUnit = ChargingRateUnitType::Watt;
-    }
-    
-    JsonArray periodJsonArray = json["chargingSchedulePeriod"];
-    for (JsonObject periodJson : periodJsonArray) {
-        auto period = std::unique_ptr<ChargingSchedulePeriod>(new ChargingSchedulePeriod(periodJson));
-        chargingSchedulePeriod.push_back(std::move(period));
-    }
-
-    //Expecting sorted list of periods but specification doesn't garantuee it
-    std::sort(chargingSchedulePeriod.begin(), chargingSchedulePeriod.end(),
-        [] (const std::unique_ptr<ChargingSchedulePeriod> &p1, const std::unique_ptr<ChargingSchedulePeriod> &p2) {
-            return p1->getStartPeriod() < p2->getStartPeriod();
-    });
-    
-    minChargingRate = json["minChargingRate"] | -1.0f;
-}
-
-ChargingSchedule::ChargingSchedule(ChargingSchedule &other) {
-    chargingProfileKind = other.chargingProfileKind;
-    recurrencyKind = other.recurrencyKind;  
-    duration = other.duration;
-    startSchedule = other.startSchedule;
-    chargingRateUnit = other.chargingRateUnit;
-
-    for (auto period = other.chargingSchedulePeriod.begin(); period != other.chargingSchedulePeriod.end(); period++) {
-        auto p = std::unique_ptr<ChargingSchedulePeriod>(new ChargingSchedulePeriod(**period));
-        chargingSchedulePeriod.push_back(std::move(p));
-    }
-
-    //Expecting sorted list of periods but specification doesn't garantuee it
-    std::sort(chargingSchedulePeriod.begin(), chargingSchedulePeriod.end(),
-        [] (const std::unique_ptr<ChargingSchedulePeriod> &p1, const std::unique_ptr<ChargingSchedulePeriod> &p2) {
-            return p1->getStartPeriod() < p2->getStartPeriod();
-    });
-    
-    minChargingRate = other.minChargingRate;
-}
-
-ChargingSchedule::ChargingSchedule(const Timestamp &startT, int duration) {
-    //create empty but valid Charging Schedule
-    this->duration = duration;
-    startSchedule = startT;
-    chargingRateUnit = ChargingRateUnitType::Watt;
-    //float minChargingRate = 0.f;
-
-    chargingProfileKind = ChargingProfileKindType::Absolute; //copied from ChargingProfile to increase cohesion of limit inferencing methods
-    recurrencyKind = RecurrencyKindType::NOT_SET; //copied from ChargingProfile to increase cohesion of limit inferencing methods
-}
-
-bool ChargingSchedule::inferenceLimit(const Timestamp &t, const Timestamp &startOfCharging, float *limit, Timestamp *nextChange) {
+bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &startOfCharging, ChargeRate& limit, Timestamp& nextChange) {
     Timestamp basis = Timestamp(); //point in time to which schedule-related times are relative
-    *nextChange = MAX_TIME; //defaulted to Infinity
     switch (chargingProfileKind) {
         case (ChargingProfileKindType::Absolute):
             //check if schedule is not valid yet but begins in future
             if (startSchedule > t) {
                 //not valid YET
-                *nextChange = startSchedule;
+                nextChange = std::min(nextChange, startSchedule);
                 return false;
             }
             //If charging profile is absolute, prefer startSchedule as basis. If absent, use chargingStart instead. If absent, no
@@ -145,14 +42,14 @@ bool ChargingSchedule::inferenceLimit(const Timestamp &t, const Timestamp &start
         case (ChargingProfileKindType::Recurring):
             if (recurrencyKind == RecurrencyKindType::Daily) {
                 basis = t - ((t - startSchedule) % (24 * 3600));
-                *nextChange = basis + (24 * 3600); //constrain nextChange to basis + one day
+                nextChange = std::min(nextChange, basis + (24 * 3600)); //constrain nextChange to basis + one day
             } else if (recurrencyKind == RecurrencyKindType::Weekly) {
                 basis = t - ((t - startSchedule) % (7 * 24 * 3600));
-                *nextChange = basis + (7 * 24 * 3600);
+                nextChange = std::min(nextChange, basis + (7 * 24 * 3600));
             } else {
                 AO_DBG_ERR("Recurring ChargingProfile but no RecurrencyKindType set. Undefined behavior, assume 'Daily'");
                 basis = t - ((t - startSchedule) % (24 * 3600));
-                *nextChange = basis + (24 * 3600);
+                nextChange = std::min(nextChange, basis + (24 * 3600));
             }
             break;
         case (ChargingProfileKindType::Relative):
@@ -181,9 +78,7 @@ bool ChargingSchedule::inferenceLimit(const Timestamp &t, const Timestamp &start
         if (t_toBasis >= duration) { //"duration" is given relative to basis
             return false;
         } else {
-            if (*nextChange - basis > duration) {
-                *nextChange = basis + duration;
-            } 
+            nextChange = std::min(nextChange, basis + duration);
         }
     }
 
@@ -193,74 +88,62 @@ bool ChargingSchedule::inferenceLimit(const Timestamp &t, const Timestamp &start
     * will remain the time determined before.
     */
     float limit_res = -1.0f; //If limit_res is still -1 after the loop, the inference process failed
+    int nphases_res = -1;
     for (auto period = chargingSchedulePeriod.begin(); period != chargingSchedulePeriod.end(); period++) {
-        if ((*period)->getStartPeriod() > t_toBasis) {
+        if (period->startPeriod > t_toBasis) {
             // found the first period that comes after t_toBasis.
-            *nextChange = basis + (*period)->getStartPeriod();
+            nextChange = basis + period->startPeriod;
+            nextChange = std::min(nextChange, basis + period->startPeriod);
             break; //The currently valid limit was set the iteration before
         }
-        limit_res = (*period)->getLimit();
-
+        limit_res = period->limit;
+        nphases_res = period->numberPhases;
     }
     
     if (limit_res >= 0.0f) {
-        *limit = std::max(limit_res, minChargingRate);
+        limit_res = std::max(limit_res, minChargingRate);
+
+        if (chargingRateUnit == ChargingRateUnitType::Amp) {
+            limit.current = limit_res;
+        } else {
+            limit.power = limit_res;
+        }
+
+        limit.nphases = nphases_res;
         return true;
     } else {
         return false; //No limit was found. Either there is no ChargingProfilePeriod, or each period begins after t_toBasis
     }
 }
 
-bool ChargingSchedule::addChargingSchedulePeriod(std::unique_ptr<ChargingSchedulePeriod> period) {
-    if (!period) return false;
-
-    if (period->getStartPeriod() >= duration) {
-        return false;
-    }
-
-    chargingSchedulePeriod.push_back(std::move(period));
-    return true;
-}
-
-void ChargingSchedule::scale(float factor) {
-    for (auto p = chargingSchedulePeriod.begin(); p != chargingSchedulePeriod.end(); p++) {
-        (*p)->scale(factor);
-    }
-}
-
-void ChargingSchedule::translate(float offset) {
-    for (auto p = chargingSchedulePeriod.begin(); p != chargingSchedulePeriod.end(); p++) {
-        (*p)->add(offset);
-    }
-}
-
-DynamicJsonDocument *ChargingSchedule::toJsonDocument() {
+bool ChargingSchedule::toJson(DynamicJsonDocument& doc) {
     size_t capacity = 0;
     capacity += JSON_OBJECT_SIZE(5); //no of fields of ChargingSchedule
     capacity += JSONDATE_LENGTH + 1; //startSchedule
     capacity += JSON_ARRAY_SIZE(chargingSchedulePeriod.size()) + chargingSchedulePeriod.size() * JSON_OBJECT_SIZE(3);
 
-    DynamicJsonDocument *result = new DynamicJsonDocument(capacity);
-    JsonObject payload = result->to<JsonObject>();
-    if (duration >= 0)
-        payload["duration"] = duration;
+    doc = DynamicJsonDocument(capacity);
+    if (duration >= 0) {
+        doc["duration"] = duration;
+    }
     char startScheduleJson [JSONDATE_LENGTH + 1] = {'\0'};
     startSchedule.toJsonString(startScheduleJson, JSONDATE_LENGTH + 1);
-    payload["startSchedule"] = startScheduleJson;
-    payload["chargingRateUnit"] = chargingRateUnit == (ChargingRateUnitType::Amp) ? "A" : "W";
-    JsonArray periodArray = payload.createNestedArray("chargingSchedulePeriod");
+    doc["startSchedule"] = startScheduleJson;
+    doc["chargingRateUnit"] = chargingRateUnit == (ChargingRateUnitType::Amp) ? "A" : "W";
+    JsonArray periodArray = doc.createNestedArray("chargingSchedulePeriod");
     for (auto period = chargingSchedulePeriod.begin(); period != chargingSchedulePeriod.end(); period++) {
         JsonObject entry = periodArray.createNestedObject();
-        entry["startPeriod"] = (*period)->getStartPeriod();
-        entry["limit"] = (*period)->getLimit();
-        if ((*period)->getNumberPhases() >= 0) {
-            entry["numberPhases"] = (*period)->getNumberPhases();
+        entry["startPeriod"] = period->startPeriod;
+        entry["limit"] = period->limit;
+        if (period->numberPhases != 3) {
+            entry["numberPhases"] = period->numberPhases;
         }
     }
-    if (minChargingRate >= 0)
-        payload["minChargeRate"] = minChargingRate;
-    
-    return result;
+    if (minChargingRate >= 0) {
+        doc["minChargeRate"] = minChargingRate;
+    }
+
+    return true;
 }
 
 void ChargingSchedule::printSchedule(){
@@ -268,11 +151,11 @@ void ChargingSchedule::printSchedule(){
     char tmp[JSONDATE_LENGTH + 1] = {'\0'};
     startSchedule.toJsonString(tmp, JSONDATE_LENGTH + 1);
 
-    AO_DBG_VERBOSE("CHARGING SCHEDULE:\n" \
-                "    duration: %i\n" \
-                "    startSchedule: %s\n" \
-                "    chargingRateUnit: %s\n" \
-                "    minChargingRate: %f\n",
+    AO_CONSOLE_PRINTF("   > CHARGING SCHEDULE:\n" \
+                "       > duration: %i\n" \
+                "       > startSchedule: %s\n" \
+                "       > chargingRateUnit: %s\n" \
+                "       > minChargingRate: %f\n",
                 duration,
                 tmp,
                 chargingRateUnit == (ChargingRateUnitType::Amp) ? "A" :
@@ -280,99 +163,38 @@ void ChargingSchedule::printSchedule(){
                 minChargingRate);
 
     for (auto period = chargingSchedulePeriod.begin(); period != chargingSchedulePeriod.end(); period++) {
-        (*period)->printPeriod();
+        AO_CONSOLE_PRINTF("       > CHARGING SCHEDULE PERIOD:\n" \
+                "           > startPeriod: %i\n" \
+                "           > limit: %f\n" \
+                "           > numberPhases: %i\n",
+                period->startPeriod,
+                period->limit,
+                period->numberPhases);
     }
 }
 
-ChargingProfile::ChargingProfile(JsonObject &json){
-  
-    chargingProfileId = json["chargingProfileId"] | -1;
-    transactionId = json["transactionId"] | -1;
-    stackLevel = json["stackLevel"] | 0;
-    
-    const char *chargingProfilePurposeStr = json["chargingProfilePurpose"] | "Invalid";
-    if (!strcmp(chargingProfilePurposeStr, "ChargePointMaxProfile")) {
-        chargingProfilePurpose = ChargingProfilePurposeType::ChargePointMaxProfile;
-    } else if (!strcmp(chargingProfilePurposeStr, "TxDefaultProfile")) {
-        chargingProfilePurpose = ChargingProfilePurposeType::TxDefaultProfile;
-    //} else if (!strcmp(chargingProfilePurposeStr, "TxProfile")) {
-    } else {
-        chargingProfilePurpose = ChargingProfilePurposeType::TxProfile;
-    }
-    const char *chargingProfileKindStr = json["chargingProfileKind"] | "Invalid";
-    if (!strcmp(chargingProfileKindStr, "Absolute")) {
-        chargingProfileKind = ChargingProfileKindType::Absolute;
-    } else if (!strcmp(chargingProfileKindStr, "Recurring")) {
-        chargingProfileKind = ChargingProfileKindType::Recurring;
-    //} else if (!strcmp(chargingProfileKindStr, "Relative")) {
-    } else {
-        chargingProfileKind = ChargingProfileKindType::Relative;
-    }
-    const char *recurrencyKindStr = json["recurrencyKind"] | "Invalid";
-    if (!strcmp(recurrencyKindStr, "Daily")) {
-        recurrencyKind = RecurrencyKindType::Daily;
-    } else if (!strcmp(recurrencyKindStr, "Weekly")) {
-        recurrencyKind = RecurrencyKindType::Weekly;
-    } else {
-        recurrencyKind = RecurrencyKindType::NOT_SET; //not part of OCPP 1.6
-    }
-
-    AO_DBG_DEBUG("Deserialize JSON: chargingProfileId=%i, chargingProfilePurpose=%s, recurrencyKind=%s", chargingProfileId, chargingProfilePurposeStr, recurrencyKindStr);
-
-    if (!validFrom.setTime(json["validFrom"] | "Invalid")) {
-        //non-success
-        AO_DBG_DEBUG("validFrom undefined. Expect format like 2022-02-01T20:53:32.486Z. Assume unlimited validity");
-        validFrom = MIN_TIME;
-    }
-
-    if (!validTo.setTime(json["validTo"] | "Invalid")) {
-        //non-success
-        AO_DBG_DEBUG("validTo undefined. Expect format like 2022-02-01T20:53:32.486Z. Assume unlimited validity");
-        validTo = MIN_TIME;
-    }
-
-    JsonObject schedule = json["chargingSchedule"]; 
-    chargingSchedule = std::unique_ptr<ChargingSchedule>(new ChargingSchedule(schedule, chargingProfileKind, recurrencyKind));
-}
-
-bool ChargingProfile::inferenceLimit(const Timestamp &t, const Timestamp &startOfCharging, float *limit, Timestamp *nextChange){
+bool ChargingProfile::calculateLimit(const Timestamp &t, const Timestamp &startOfCharging, ChargeRate& limit, Timestamp& nextChange){
     if (t > validTo && validTo > MIN_TIME) {
-        *nextChange = MAX_TIME;
         return false; //no limit defined
     }
     if (t < validFrom) {
-        *nextChange = validFrom;
+        nextChange = std::min(nextChange, validFrom);
         return false; //no limit defined
     }
 
-    return chargingSchedule->inferenceLimit(t, startOfCharging, limit, nextChange);
+    return chargingSchedule.calculateLimit(t, startOfCharging, limit, nextChange);
 }
 
-bool ChargingProfile::inferenceLimit(const Timestamp &t, float *limit, Timestamp *nextChange){
-    return inferenceLimit(t, MAX_TIME, limit, nextChange);
+bool ChargingProfile::calculateLimit(const Timestamp &t, ChargeRate& limit, Timestamp& nextChange){
+    return calculateLimit(t, MAX_TIME, limit, nextChange);
 }
 
-bool ChargingProfile::checkTransactionAssignment(int txId, int profileId) {
-    if (chargingProfilePurpose != ChargingProfilePurposeType::TxProfile) {
-        AO_DBG_ERR("assignment only exists for TxProfiles");
-        return true; //does not apply to this profile -> no restriction
-    }
-
-    if (txId <= 0 && profileId < 0) {
-        //no search parameters set
-        return true;
-    }
-
-    if (chargingProfileId >= 0 && profileId >= 0) { //profileIDs are valid
-        return chargingProfileId == profileId; //return if they match (case of remote charging profiles)
-    }
+int ChargingProfile::getChargingProfileId() {
+    return chargingProfileId;
+}
 
-    if (transactionId > 0 && txId > 0) { //txIDs are valid
-        return transactionId == txId; //return if they do match
-    }
-    
-    AO_DBG_DEBUG("Neither txIds nor profileIDs apply");
-    return true;
+int ChargingProfile::getTransactionId() {
+    return transactionId;
 }
 
 int ChargingProfile::getStackLevel(){
@@ -383,8 +205,80 @@ ChargingProfilePurposeType ChargingProfile::getChargingProfilePurpose(){
     return chargingProfilePurpose;
 }
 
-int ChargingProfile::getChargingProfileId() {
-    return chargingProfileId;
+bool ChargingProfile::toJson(DynamicJsonDocument& doc) {
+    
+    DynamicJsonDocument chargingScheduleDoc {0};
+    if (!chargingSchedule.toJson(chargingScheduleDoc)) {
+        return false;
+    }
+
+    doc = DynamicJsonDocument(
+            JSON_OBJECT_SIZE(9) +
+            JSON_OBJECT_SIZE(1) +
+                chargingScheduleDoc.memoryUsage());
+    
+    doc["chargingProfileId"] = chargingProfileId;
+    if (transactionId >= 0) {
+        doc["transactionId"] = transactionId;
+    }
+    doc["stackLevel"] = stackLevel;
+
+    switch (chargingProfilePurpose) {
+        case (ChargingProfilePurposeType::ChargePointMaxProfile):
+            doc["chargingProfilePurpose"] = "ChargePointMaxProfile";
+            break;
+        case (ChargingProfilePurposeType::TxDefaultProfile):
+            doc["chargingProfilePurpose"] = "TxDefaultProfile";
+            break;
+        case (ChargingProfilePurposeType::TxProfile):
+            doc["chargingProfilePurpose"] = "TxProfile";
+            break;
+    }
+
+    switch (chargingProfileKind) {
+        case (ChargingProfileKindType::Absolute):
+            doc["chargingProfileKind"] = "Absolute";
+            break;
+        case (ChargingProfileKindType::Recurring):
+            doc["chargingProfileKind"] = "Recurring";
+            break;
+        case (ChargingProfileKindType::Relative):
+            doc["chargingProfileKind"] = "Relative";
+            break;
+    }
+
+    switch (recurrencyKind) {
+        case (RecurrencyKindType::Daily):
+            doc["recurrencyKind"] = "Daily";
+            break;
+        case (RecurrencyKindType::Weekly):
+            doc["recurrencyKind"] = "Weekly";
+            break;
+        default:
+            break;
+    }
+
+    char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+
+    if (validFrom > MIN_TIME) {
+        if (!validFrom.toJsonString(timeStr, JSONDATE_LENGTH + 1)) {
+            AO_DBG_ERR("serialization error");
+            return false;
+        }
+        doc["validFrom"] = timeStr;
+    }
+
+    if (validTo > MIN_TIME) {
+        if (!validTo.toJsonString(timeStr, JSONDATE_LENGTH + 1)) {
+            AO_DBG_ERR("serialization error");
+            return false;
+        }
+        doc["validTo"] = timeStr;
+    }
+
+    doc["chargingSchedule"] = chargingScheduleDoc;
+
+    return true;
 }
 
 void ChargingProfile::printProfile(){
@@ -394,15 +288,15 @@ void ChargingProfile::printProfile(){
     char tmp2[JSONDATE_LENGTH + 1] = {'\0'};
     validTo.toJsonString(tmp2, JSONDATE_LENGTH + 1);
 
-    AO_DBG_VERBOSE("CHARGING PROFILE:\n" \
-                "  chargingProfileId: %i\n" \
-                "  transactionId: %i\n" \
-                "  stackLevel: %i\n" \
-                "  chargingProfilePurpose: %s\n" \
-                "  chargingProfileKind: %s\n" \
-                "  recurrencyKind: %s\n" \
-                "  validFrom: %s\n" \
-                "  validTo: %s\n",
+    AO_CONSOLE_PRINTF("   > CHARGING PROFILE:\n" \
+                "   > chargingProfileId: %i\n" \
+                "   > transactionId: %i\n" \
+                "   > stackLevel: %i\n" \
+                "   > chargingProfilePurpose: %s\n" \
+                "   > chargingProfileKind: %s\n" \
+                "   > recurrencyKind: %s\n" \
+                "   > validFrom: %s\n" \
+                "   > validTo: %s\n",
                 chargingProfileId,
                 transactionId,
                 stackLevel,
@@ -419,5 +313,187 @@ void ChargingProfile::printProfile(){
                 tmp2
                 );
 
-    chargingSchedule->printSchedule();
+    chargingSchedule.printSchedule();
+}
+
+namespace ArduinoOcpp {
+
+bool loadChargingSchedulePeriod(JsonObject& json, ChargingSchedulePeriod& out) {
+    int startPeriod = json["startPeriod"] | -1;
+    if (startPeriod >= 0) {
+        out.startPeriod = startPeriod;
+    } else {
+        AO_DBG_WARN("format violation");
+        return false;
+    }
+
+    float limit = json["limit"] | -1.f;
+    if (limit >= 0.f) {
+        out.limit = limit;
+    } else {
+        AO_DBG_WARN("format violation");
+        return false;
+    }
+
+    if (json.containsKey("numberPhases")) {
+        int numberPhases = json["numberPhases"];
+        if (numberPhases >= 0 && numberPhases <= 3) {
+            out.numberPhases = numberPhases;
+        } else {
+            AO_DBG_WARN("format violation");
+            return false;
+        }
+    }
+
+    return true;
+}
+
+} //end namespace ArduinoOcpp
+
+bool ArduinoOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
+    if (json.containsKey("duration")) {
+        int duration = json["duration"] | -1;
+        if (duration >= 0) {
+            out.duration = duration;
+        } else {
+            AO_DBG_WARN("format violation");
+            return false;
+        }
+    }
+
+    if (json.containsKey("startSchedule")) {
+        if (!out.startSchedule.setTime(json["startSchedule"] | "Invalid")) {
+            //non-success
+            AO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            return false;
+        }
+    } else {
+        out.startSchedule = MIN_TIME;
+    }
+
+    const char *unit = json["chargingRateUnit"] | "_Undefined";
+    if (unit[0] == 'a' || unit[0] == 'A') {
+        out.chargingRateUnit = ChargingRateUnitType::Amp;
+    } else if (unit[0] == 'w' || unit[0] == 'W') {
+        out.chargingRateUnit = ChargingRateUnitType::Watt;
+    } else {
+        AO_DBG_WARN("format violation");
+        return false;
+    }
+    
+    JsonArray periodJsonArray = json["chargingSchedulePeriod"];
+    if (periodJsonArray.size() < 1) {
+        AO_DBG_WARN("format violation");
+        return false;
+    }
+
+    for (JsonObject periodJson : periodJsonArray) {
+        out.chargingSchedulePeriod.push_back(ChargingSchedulePeriod());
+        if (!loadChargingSchedulePeriod(periodJson, out.chargingSchedulePeriod.back())) {
+            return false;
+        }
+    }
+    
+    if (json.containsKey("minChargingRate")) {
+        float minChargingRate = json["minChargingRate"];
+        if (minChargingRate >= 0.f) {
+            out.minChargingRate = minChargingRate;
+        } else {
+            AO_DBG_WARN("format violation");
+            return false;
+        }
+    }
+
+    return true;
+}
+
+std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& json) {
+    auto res = std::unique_ptr<ChargingProfile>(new ChargingProfile());
+
+    int chargingProfileId = json["chargingProfileId"] | -1;
+    if (chargingProfileId >= 0) {
+        res->chargingProfileId = chargingProfileId;
+    } else {
+        AO_DBG_WARN("format violation");
+        return nullptr;
+    }
+
+    int transactionId = json["transactionId"] | -1;
+    if (transactionId >= 0) {
+        res->transactionId = transactionId;
+    }
+
+    int stackLevel = json["stackLevel"] | -1;
+    if (stackLevel >= 0 && stackLevel <= CHARGEPROFILEMAXSTACKLEVEL) {
+        res->stackLevel = stackLevel;
+    } else {
+        AO_DBG_WARN("format violation");
+        return nullptr;
+    }
+
+    const char *chargingProfilePurposeStr = json["chargingProfilePurpose"] | "Invalid";
+    if (!strcmp(chargingProfilePurposeStr, "ChargePointMaxProfile")) {
+        res->chargingProfilePurpose = ChargingProfilePurposeType::ChargePointMaxProfile;
+    } else if (!strcmp(chargingProfilePurposeStr, "TxDefaultProfile")) {
+        res->chargingProfilePurpose = ChargingProfilePurposeType::TxDefaultProfile;
+    } else if (!strcmp(chargingProfilePurposeStr, "TxProfile")) {
+        res->chargingProfilePurpose = ChargingProfilePurposeType::TxProfile;
+    } else {
+        AO_DBG_WARN("format violation");
+        return nullptr;
+    }
+
+    const char *chargingProfileKindStr = json["chargingProfileKind"] | "Invalid";
+    if (!strcmp(chargingProfileKindStr, "Absolute")) {
+        res->chargingProfileKind = ChargingProfileKindType::Absolute;
+    } else if (!strcmp(chargingProfileKindStr, "Recurring")) {
+        res->chargingProfileKind = ChargingProfileKindType::Recurring;
+    } else if (!strcmp(chargingProfileKindStr, "Relative")) {
+        res->chargingProfileKind = ChargingProfileKindType::Relative;
+    } else {
+        AO_DBG_WARN("format violation");
+        return nullptr;
+    }
+
+    const char *recurrencyKindStr = json["recurrencyKind"] | "Invalid";
+    if (!strcmp(recurrencyKindStr, "Daily")) {
+        res->recurrencyKind = RecurrencyKindType::Daily;
+    } else if (!strcmp(recurrencyKindStr, "Weekly")) {
+        res->recurrencyKind = RecurrencyKindType::Weekly;
+    }
+
+    AO_DBG_DEBUG("Deserialize JSON: chargingProfileId=%i, chargingProfilePurpose=%s, recurrencyKind=%s", chargingProfileId, chargingProfilePurposeStr, recurrencyKindStr);
+
+    if (json.containsKey("validFrom")) {
+        if (!res->validFrom.setTime(json["validFrom"] | "Invalid")) {
+            //non-success
+            AO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            return nullptr;
+        }
+    } else {
+        res->validFrom = MIN_TIME;
+    }
+
+    if (json.containsKey("validTo")) {
+        if (!res->validTo.setTime(json["validTo"] | "Invalid")) {
+            //non-success
+            AO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            return nullptr;
+        }
+    } else {
+        res->validTo = MIN_TIME;
+    }
+
+    JsonObject scheduleJson = json["chargingSchedule"];
+    ChargingSchedule& schedule = res->chargingSchedule;
+    auto success = loadChargingSchedule(scheduleJson, schedule);
+    if (!success) {
+        return nullptr;
+    }
+
+    //duplicate some fields to chargingSchedule to simplify the max charge rate calculation
+    schedule.chargingProfileKind = res->chargingProfileKind;
+    schedule.recurrencyKind = res->recurrencyKind;
+
+    return res;
 }
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h
index 8e6a61aa..f4084da5 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h
@@ -5,10 +5,17 @@
 #ifndef SMARTCHARGINGMODEL_H
 #define SMARTCHARGINGMODEL_H
 
-#include <ArduinoJson.h>
-#include <ArduinoOcpp/Core/Time.h>
+#define CHARGEPROFILEMAXSTACKLEVEL 8
+#define CHARGINGSCHEDULEMAXPERIODS 24
+#define MAXCHARGINGPROFILESINSTALLED 10
+
 #include <memory>
 #include <vector>
+#include <limits>
+
+#include <ArduinoJson.h>
+
+#include <ArduinoOcpp/Core/Time.h>
 
 namespace ArduinoOcpp {
 
@@ -35,36 +42,41 @@ enum class ChargingRateUnitType {
     Amp
 };
 
+struct ChargeRate {
+    float power = std::numeric_limits<float>::max();
+    float current = std::numeric_limits<float>::max();
+    int nphases = std::numeric_limits<int>::max();
+
+    bool operator==(const ChargeRate& rhs) {
+        return power == rhs.power &&
+               current == rhs.current &&
+               nphases == rhs.nphases;
+    }
+    bool operator!=(const ChargeRate& rhs) {
+        return !(*this == rhs);
+    }
+};
+
+//returns a new vector with the minimum of each component
+ChargeRate chargeRate_min(const ChargeRate& a, const ChargeRate& b);
+
 class ChargingSchedulePeriod {
-private:
-    int startPeriod;
-    float limit; //one fractural digit at most
-    int numberPhases = -1;
 public:
-    ChargingSchedulePeriod(JsonObject &json);
-    ChargingSchedulePeriod(int startPeriod, float limit);
-    int getStartPeriod();
-    float getLimit();
-    void scale(float factor);
-    void add(float value);
-    int getNumberPhases();
-    void printPeriod();
+    int startPeriod;
+    float limit;
+    int numberPhases = 3;
 };
 
 class ChargingSchedule {
-private:
+public:
     int duration = -1;
     Timestamp startSchedule;
     ChargingRateUnitType chargingRateUnit;
-    std::vector<std::unique_ptr<ChargingSchedulePeriod>> chargingSchedulePeriod;
+    std::vector<ChargingSchedulePeriod> chargingSchedulePeriod;
     float minChargingRate = -1.0f;
 
     ChargingProfileKindType chargingProfileKind; //copied from ChargingProfile to increase cohesion of limit inferencing methods
-    RecurrencyKindType recurrencyKind; //copied from ChargingProfile to increase cohesion of limit inferencing methods
-public:
-    ChargingSchedule(JsonObject &json, ChargingProfileKindType chargingProfileKind, RecurrencyKindType recurrencyKind);
-    ChargingSchedule(ChargingSchedule &other);
-    ChargingSchedule(const Timestamp &startSchedule, int duration);
+    RecurrencyKindType recurrencyKind = RecurrencyKindType::NOT_SET; //copied from ChargingProfile to increase cohesion of limit inferencing methods
 
     /**
      * limit: output parameter
@@ -74,14 +86,9 @@ class ChargingSchedule {
      *       if true, limit and nextChange will be set according to this Schedule
      *       if false, only nextChange will be set
      */
-    bool inferenceLimit(const Timestamp &t, const Timestamp &startOfCharging, float *limit, Timestamp *nextChange);
-
-    bool addChargingSchedulePeriod(std::unique_ptr<ChargingSchedulePeriod> period);
+    bool calculateLimit(const Timestamp &t, const Timestamp &startOfCharging, ChargeRate& limit, Timestamp& nextChange);
 
-    void scale(float factor);
-    void translate(float offset);
-
-    DynamicJsonDocument *toJsonDocument();
+    bool toJson(DynamicJsonDocument& out);
 
     /*
     * print on console
@@ -90,7 +97,7 @@ class ChargingSchedule {
 };
 
 class ChargingProfile {
-private:
+public:
     int chargingProfileId = -1;
     int transactionId = -1;
     int stackLevel = 0;
@@ -99,9 +106,7 @@ class ChargingProfile {
     RecurrencyKindType recurrencyKind {RecurrencyKindType::NOT_SET}; // copied to ChargingSchedule to increase cohesion
     Timestamp validFrom;
     Timestamp validTo;
-    std::unique_ptr<ChargingSchedule> chargingSchedule;
-public:
-    ChargingProfile(JsonObject &json);
+    ChargingSchedule chargingSchedule;
 
     /**
      * limit: output parameter
@@ -111,23 +116,20 @@ class ChargingProfile {
      *       if true, limit and nextChange will be set according to this Schedule
      *       if false, only nextChange will be set
      */
-    bool inferenceLimit(const Timestamp &t, const Timestamp &startOfCharging, float *limit, Timestamp *nextChange);
+    bool calculateLimit(const Timestamp &t, const Timestamp &startOfCharging, ChargeRate& limit, Timestamp& nextChange);
 
     /*
     * Simpler function if startOfCharging is not available. Caution: This likely will differ from inference with startOfCharging
     */
-    bool inferenceLimit(const Timestamp &t, float *limit, Timestamp *nextChange);
-
-    /*
-    * Check if this profile belongs to transaction with ID txId or idTag alternatively
-    */
-    bool checkTransactionAssignment(int txId, int profileId);
+    bool calculateLimit(const Timestamp &t, ChargeRate& limit, Timestamp& nextChange);
 
+    int getChargingProfileId();
+    int getTransactionId();
     int getStackLevel();
     
     ChargingProfilePurposeType getChargingProfilePurpose();
 
-    int getChargingProfileId();
+    bool toJson(DynamicJsonDocument& out);
 
     /*
     * print on console
@@ -135,5 +137,10 @@ class ChargingProfile {
     void printProfile();
 };
 
+std::unique_ptr<ChargingProfile> loadChargingProfile(JsonObject& json);
+
+bool loadChargingSchedule(JsonObject& json, ChargingSchedule& out);
+
 } //end namespace ArduinoOcpp
+
 #endif
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
index 6f4d863f..6d8ddb70 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -7,64 +7,69 @@
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Operations/ClearChargingProfile.h>
 #include <ArduinoOcpp/Operations/GetCompositeSchedule.h>
 #include <ArduinoOcpp/Operations/SetChargingProfile.h>
 #include <ArduinoOcpp/Debug.h>
 
-#if !defined(AO_DEACTIVATE_FLASH) && defined(AO_DEACTIVATE_FLASH_SMARTCHARGING)
-#define AO_DEACTIVATE_FLASH
-#endif
+using namespace::ArduinoOcpp;
 
-#ifndef AO_DEACTIVATE_FLASH
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#if AO_USE_FILEAPI == ESPIDF_SPIFFS || AO_USE_FILEAPI == POSIX_FILEAPI
-#define AO_DEACTIVATE_FLASH //migrate to File utils
-#endif
-#endif
+SmartChargingConnector::SmartChargingConnector(Model& model, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ProfileStack& ChargePointMaxProfile, ProfileStack& ChargePointTxDefaultProfile) :
+        model{model}, filesystem{filesystem}, connectorId{connectorId}, ChargePointMaxProfile{ChargePointMaxProfile}, ChargePointTxDefaultProfile{ChargePointTxDefaultProfile} {
+    
+}
 
-#ifndef AO_DEACTIVATE_FLASH
-#if defined(ESP32)
-#include <LITTLEFS.h>
-#define USE_FS LITTLEFS
-#else
-#include <FS.h>
-#define USE_FS SPIFFS
-#endif
-#endif
+SmartChargingConnector::~SmartChargingConnector() {
 
-#define SINGLE_CONNECTOR_ID 1
+}
 
-#define PROFILE_FN_PREFIX "/ocpp-"
-#define PROFILE_FN_SUFFIX ".cnf"
-#define PROFILE_FN_MAXSIZE 30
-#define PROFILE_CUSTOM_CAPACITY 500
-#define PROFILE_MAX_CAPACITY 4000
+void SmartChargingConnector::loop(){
 
-using namespace::ArduinoOcpp;
+    trackTransaction();
+
+    /**
+     * check if to call onLimitChange
+     */
+    auto& tnow = model.getClock().now();
+
+    if (tnow >= nextChange){
+
+        ChargeRate limit;
+        nextChange = MAX_TIME; //reset nextChange to default value and refresh it
+
+        calculateLimit(tnow, limit, nextChange);
 
-SmartChargingService::SmartChargingService(Context& context, float chargeLimit, float V_eff, int numConnectors, FilesystemOpt filesystemOpt)
-      : context(context), DEFAULT_CHARGE_LIMIT{chargeLimit}, V_eff{V_eff}, filesystemOpt{filesystemOpt} {
-  
-    if (numConnectors > 2) {
-        AO_DBG_WARN("Only one connector supported at the moment");
+        if (trackLimitOutput != limit) {
+            if (limitOutput) {
+
+                limitOutput(
+                    limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
+                    limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
+                    limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
+                trackLimitOutput = limit;
+            }
+        }
+    }
+}
+
+void SmartChargingConnector::setSmartChargingOutput(std::function<void(float,float,int)> limitOutput) {
+    if (this->limitOutput) {
+        AO_DBG_WARN("replacing existing SmartChargingOutput");
+        (void)0;
     }
+    this->limitOutput = limitOutput;
+}
+
+SmartChargingService::SmartChargingService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int numConnectors)
+      : context(context), filesystem{filesystem}, numConnectors(numConnectors) {
     
-    limitBeforeChange = -1.0f;
-    nextChange = MIN_TIME;
-    chargingSessionStart = MAX_TIME;
-    char max_timestamp [JSONDATE_LENGTH + 1] = {'\0'};
-    chargingSessionStart.toJsonString(max_timestamp, JSONDATE_LENGTH + 1);
-    txStartTime = declareConfiguration<const char*>("AO_TXSTARTTIME_CONN_1", max_timestamp, AO_KEYVALUE_FN, false, false, true, false);
-    chargingSessionTransactionID = -1;
-    sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, AO_KEYVALUE_FN, false, false, true, false);
-    for (int i = 0; i < CHARGEPROFILEMAXSTACKLEVEL; i++) {
-        ChargePointMaxProfile[i] = NULL;
-        TxDefaultProfile[i] = NULL;
-        TxProfile[i] = NULL;
+    for (unsigned int cId = 1; cId < numConnectors; cId++) {
+        connectors.push_back(std::move(SmartChargingConnector(context.getModel(), filesystem, cId, ChargePointMaxProfile, ChargePointTxDefaultProfile)));
     }
+
     declareConfiguration<int>("ChargeProfileMaxStackLevel", CHARGEPROFILEMAXSTACKLEVEL, CONFIGURATION_VOLATILE, false, true, false, false);
-    declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit ", "Power", CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE, false);
     declareConfiguration<int>("ChargingScheduleMaxPeriods", CHARGINGSCHEDULEMAXPERIODS, CONFIGURATION_VOLATILE, false, true, false, false);
     declareConfiguration<int>("MaxChargingProfilesInstalled", MAXCHARGINGPROFILESINSTALLED, CONFIGURATION_VOLATILE, false, true, false, false);
 
@@ -78,249 +83,422 @@ SmartChargingService::SmartChargingService(Context& context, float chargeLimit,
         fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
     }
 
-    context.getOperationRegistry().registerOperation("ClearChargingProfile", [&context] () {
-        return new Ocpp16::ClearChargingProfile(context.getModel());});
-    context.getOperationRegistry().registerOperation("GetCompositeSchedule", [&context] () {
-        return new Ocpp16::GetCompositeSchedule(context.getModel());});
-    context.getOperationRegistry().registerOperation("SetChargingProfile", [&context] () {
-        return new Ocpp16::SetChargingProfile(context.getModel());});
+    context.getOperationRegistry().registerOperation("ClearChargingProfile", [this] () {
+        return new Ocpp16::ClearChargingProfile(*this);});
+    context.getOperationRegistry().registerOperation("GetCompositeSchedule", [&context, this] () {
+        return new Ocpp16::GetCompositeSchedule(context.getModel(), *this);});
+    context.getOperationRegistry().registerOperation("SetChargingProfile", [&context, this] () {
+        return new Ocpp16::SetChargingProfile(context.getModel(), *this);});
 
     loadProfiles();
 }
 
+SmartChargingService::~SmartChargingService() {
+
+}
+
+void SmartChargingService::updateAllowedChargingRateUnit(bool powerSupported, bool currentSupported) {
+    if ((powerSupported != this->powerSupported) || (currentSupported != this->currentSupported)) {
+
+        auto chargingScheduleAllowedChargingRateUnit = declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE, false);
+        if (chargingScheduleAllowedChargingRateUnit) {
+            if (powerSupported && currentSupported) {
+                *chargingScheduleAllowedChargingRateUnit = "Current,Power";
+            } else if (powerSupported) {
+                *chargingScheduleAllowedChargingRateUnit = "Power";
+            } else if (currentSupported) {
+                *chargingScheduleAllowedChargingRateUnit = "Current";
+            }
+        }
+
+        this->powerSupported = powerSupported;
+        this->currentSupported = currentSupported;
+    }
+}
+
+void SmartChargingService::setSmartChargingOutput(unsigned int connectorId, std::function<void(float,float,int)> limitOutput) {
+    if ((connectorId > 0 && !getScConnectorById(connectorId))) {
+        AO_DBG_ERR("invalid args");
+        return;
+    }
+
+    if (connectorId == 0) {
+        if (this->limitOutput) {
+            AO_DBG_WARN("replacing existing SmartChargingOutput");
+            (void)0;
+        }
+        this->limitOutput = limitOutput;
+    } else {
+        getScConnectorById(connectorId)->setSmartChargingOutput(limitOutput);
+    }
+}
+
 void SmartChargingService::loop(){
 
-    refreshChargingSessionState();
+    for (size_t i = 0; i < connectors.size(); i++) {
+        connectors[i].loop();
+    }
 
     /**
      * check if to call onLimitChange
      */
-    if (context.getModel().getClock().now() >= nextChange){
-        auto& tNow = context.getModel().getClock().now();
-        float limit = -1.0f;
-        Timestamp validTo = Timestamp();
-        inferenceLimit(tNow, &limit, &validTo);
+    auto& tnow = context.getModel().getClock().now();
+
+    if (tnow >= nextChange){
+        
+        ChargeRate limit;
+        nextChange = MAX_TIME; //reset nextChange to default value and refresh it
+
+        calculateLimit(tnow, limit, nextChange);
 
 #if (AO_DBG_LEVEL >= AO_DL_INFO)
         char timestamp1[JSONDATE_LENGTH + 1] = {'\0'};
-        nextChange.toJsonString(timestamp1, JSONDATE_LENGTH + 1);
+        tnow.toJsonString(timestamp1, JSONDATE_LENGTH + 1);
         char timestamp2[JSONDATE_LENGTH + 1] = {'\0'};
-        validTo.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
-        AO_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = %f",
-                            timestamp1, timestamp2, limit);
+        nextChange.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
+        AO_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = {%f,%f,%i}",
+                            timestamp1, timestamp2, limit.power, limit.current, limit.nphases);
 #endif
 
-        nextChange = validTo;
-        if (limit != limitBeforeChange){
-            if (onLimitChange != NULL) {
-                onLimitChange(limit);
+        if (trackLimitOutput != limit) {
+            if (limitOutput) {
+
+                limitOutput(
+                    limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
+                    limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
+                    limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
+                trackLimitOutput = limit;
             }
         }
-        limitBeforeChange = limit;
     }
 }
 
-float SmartChargingService::inferenceLimitNow(){
-    float limit = 0.0f;
-    Timestamp validTo = Timestamp(); //not needed
-    auto& tNow = context.getModel().getClock().now();
-    inferenceLimit(tNow, &limit, &validTo);
-    return limit;
-}
+void SmartChargingConnector::trackTransaction() {
+
+    Transaction *tx = nullptr;
+    if (model.getConnector(connectorId)) {
+        tx = model.getConnector(connectorId)->getTransaction().get();
+    }
 
-void SmartChargingService::setOnLimitChange(OnLimitChange onLtChg){
-    onLimitChange = onLtChg;
+    bool update = false;
+
+    if (tx) {
+        if (tx->getTxProfileId() != trackTxRmtProfileId) {
+            update = true;
+            trackTxRmtProfileId = tx->getTxProfileId();
+        }
+        if (tx->getStartSync().isRequested() && tx->getStartTimestamp() != trackTxStart) {
+            update = true;
+            trackTxStart = tx->getStartTimestamp();
+        }
+        if (tx->getStartSync().isConfirmed() && tx->getTransactionId() != trackTxId) {
+            update = true;
+            trackTxId = tx->getTransactionId();
+        }
+    } else {
+        //check if transaction has just been completed
+        if (trackTxRmtProfileId >= 0 || trackTxStart < MAX_TIME || trackTxId >= 0) {
+            //yes, clear data
+            update = true;
+            trackTxRmtProfileId = -1;
+            trackTxStart = MAX_TIME;
+            trackTxId = -1;
+
+            clearChargingProfile([this] (int, int connectorId, ChargingProfilePurposeType purpose, int) {
+                return purpose == ChargingProfilePurposeType::TxProfile &&
+                       (int) this->connectorId == connectorId;
+            });
+        }
+    }
+
+    if (update) {
+        nextChange = model.getClock().now(); //will refresh limit calculation
+    }
 }
 
-/**
- * validToOutParam: The begin of the next SmartCharging restriction after time t. It is not taken into
- * account if the next Profile will be a prevailing one. If the profile at time t ends before any
- * other profile engages, the end of this profile will be written into validToOutParam.
+/*
+ * limitOut: the calculated maximum charge rate at the moment, or the default value if no limit is defined
+ * validToOut: The begin of the next SmartCharging restriction after time t
  */
-void SmartChargingService::inferenceLimit(const Timestamp &t, float *limitOutParam, Timestamp *validToOutParam){
-    Timestamp validToMin = MAX_TIME;
-    /*
-    * TxProfile rules over TxDefaultProfile. ChargePointMaxProfile rules over both of them
-    * 
-    * if (TxProfile is present)
-    *       take limit from TxProfile with the highest stackLevel
-    * else
-    *       take limit from TxDefaultProfile with the highest stackLevel
-    * take maximum from ChargePointMaxProfile with the highest stackLevel
-    * return minimum(limit, maximum from ChargePointMaxProfile)
-    */
-
-    //evaluate limit from TxProfiles
-    float limit_tx = 0.0f;
-    bool limit_defined_tx = false;
-    for (int i = CHARGEPROFILEMAXSTACKLEVEL - 1; i >= 0; i--) {
-        if (!TxProfile[i])
-            continue;
-        if (!TxProfile[i]->checkTransactionAssignment(chargingSessionTransactionID, *sRmtProfileId))
-            continue;
-        Timestamp nextChange = MAX_TIME;
-        limit_defined_tx = TxProfile[i]->inferenceLimit(t, chargingSessionStart, &limit_tx, &nextChange);
-        if (nextChange < validToMin)
-            validToMin = nextChange; //nextChange is always >= t here
-        if (limit_defined_tx) {
-            //The valid profile with the highest stack level is found. It prevails over any other so end this loop.
-            break;
+void SmartChargingConnector::calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut) {
+
+    //initialize output parameters with the default values
+    limitOut = ChargeRate();
+    validToOut = MAX_TIME;
+
+    bool txLimitDefined = false;
+    ChargeRate txLimit;
+
+    //first, check if TxProfile is defined and limits charging
+    for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+        if (TxProfile[i] && ((trackTxRmtProfileId >= 0 && trackTxRmtProfileId == TxProfile[i]->getChargingProfileId()) ||
+                                TxProfile[i]->getTransactionId() < 0 ||
+                                trackTxId == TxProfile[i]->getTransactionId())) {
+            ChargeRate crOut;
+            bool defined = TxProfile[i]->calculateLimit(t, trackTxStart, crOut, validToOut);
+            if (defined) {
+                txLimitDefined = true;
+                txLimit = crOut;
+                break;
+            }
         }
     }
 
-    //evaluate limit from TxDefaultProfiles
-    float limit_txdef = 0.0f;
-    bool limit_defined_txdef = false;
-    for (int i = CHARGEPROFILEMAXSTACKLEVEL - 1; i >= 0; i--){
-        if (TxDefaultProfile[i] == NULL) continue;
-        Timestamp nextChange = MAX_TIME;
-        limit_defined_txdef = TxDefaultProfile[i]->inferenceLimit(t, chargingSessionStart, &limit_txdef, &nextChange);
-        if (nextChange < validToMin)
-            validToMin = nextChange; //nextChange is always >= t here
-        if (limit_defined_txdef) {
-            //The valid profile with the highest stack level is found. It prevails over any other so end this loop.
-            break;
+    //if no TxProfile limits charging, check the TxDefaultProfiles for this connector
+    if (!txLimitDefined && trackTxStart < MAX_TIME) {
+        for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+            if (TxDefaultProfile[i]) {
+                ChargeRate crOut;
+                bool defined = TxDefaultProfile[i]->calculateLimit(t, trackTxStart, crOut, validToOut);
+                if (defined) {
+                    txLimitDefined = true;
+                    txLimit = crOut;
+                    break;
+                }
+            }
         }
     }
 
-    //evaluate limit from ChargePointMaxProfile
-    float limit_cpmax = 0.0f;
-    bool limit_defined_cpmax = false;
-    for (int i = CHARGEPROFILEMAXSTACKLEVEL - 1; i >= 0; i--){
-        if (ChargePointMaxProfile[i] == NULL) continue;
-        Timestamp nextChange = MAX_TIME;
-        limit_defined_cpmax = ChargePointMaxProfile[i]->inferenceLimit(t, chargingSessionStart, &limit_cpmax, &nextChange);
-        if (nextChange < validToMin)
-            validToMin = nextChange; //nextChange is always >= t here
-        if (limit_defined_cpmax) {
-            //The valid profile with the highest stack level is found. It prevails over any other so end this loop.
-            break;
+    //if no appropriate TxDefaultProfile is set for this connector, search in the general TxDefaultProfiles
+    if (!txLimitDefined && trackTxStart < MAX_TIME) {
+        for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+            if (ChargePointTxDefaultProfile[i]) {
+                ChargeRate crOut;
+                bool defined = ChargePointTxDefaultProfile[i]->calculateLimit(t, trackTxStart, crOut, validToOut);
+                if (defined) {
+                    txLimitDefined = true;
+                    txLimit = crOut;
+                    break;
+                }
+            }
         }
     }
 
-    *validToOutParam = validToMin; //validTo output parameter has successfully been determined here
-
-    //choose which limit to set according to specification
-    bool applicable_profile_found = false;
-    if (limit_defined_txdef){
-        *limitOutParam = limit_txdef;
-        applicable_profile_found = true;
-    }
-    if (limit_defined_tx){
-        *limitOutParam = limit_tx;
-        applicable_profile_found = true;
-    }
-    if (limit_defined_cpmax){
-        //Warning: This block MUST be rewritten when multiple connector support is introduced
-        if (applicable_profile_found) {
-            if (limit_cpmax < *limitOutParam){
-                //TxProfile or TxDefaultProfile exceeds the maximum for the whole CP 
-                *limitOutParam = limit_cpmax;
-            } //else: TxProfile or TxDefaultProfile are within their boundary. Do nothing
-        } else {
-            //No TxProfile or TxDefaultProfile found. The limit is set to the maximum of the CP
-            *limitOutParam = limit_cpmax;
+    ChargeRate cpLimit;
+
+    //the calculated maximum charge rate is also limited by the ChargePointMaxProfiles
+    for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+        if (ChargePointMaxProfile[i]) {
+            ChargeRate crOut;
+            bool defined = ChargePointMaxProfile[i]->calculateLimit(t, MAX_TIME, crOut, validToOut);
+            if (defined) {
+                cpLimit = crOut;
+                break;
+            }
         }
-        applicable_profile_found = true;
     }
-    if (!applicable_profile_found) {
-        *limitOutParam = DEFAULT_CHARGE_LIMIT;
+
+    //apply ChargePointMaxProfile value to calculated limit
+    limitOut = chargeRate_min(txLimit, cpLimit);
+}
+
+/*
+ * limitOut: the calculated maximum charge rate at the moment, or the default value if no limit is defined
+ * validToOut: The begin of the next SmartCharging restriction after time t
+ */
+void SmartChargingService::calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut){
+    
+    //initialize output parameters with the default values
+    limitOut = ChargeRate();
+    validToOut = MAX_TIME;
+
+    //get ChargePointMaxProfile with the highest stackLevel
+    for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+        if (ChargePointMaxProfile[i]) {
+            ChargeRate crOut;
+            bool defined = ChargePointMaxProfile[i]->calculateLimit(t, MAX_TIME, crOut, validToOut);
+            if (defined) {
+                limitOut = crOut;
+                break;
+            }
+        }
     }
 }
 
-ChargingSchedule *SmartChargingService::getCompositeSchedule(int connectorId, int duration){
-    auto& startSchedule = context.getModel().getClock().now();
-    ChargingSchedule *result = new ChargingSchedule(startSchedule, duration);
+std::unique_ptr<ChargingSchedule> SmartChargingConnector::getCompositeSchedule(int duration, ChargingRateUnitType_Optional unit) {
+    
+    auto& startSchedule = model.getClock().now();
+
+    auto schedule = std::unique_ptr<ChargingSchedule>(new ChargingSchedule());
+    schedule->duration = duration;
+    schedule->startSchedule = startSchedule;
+    schedule->chargingProfileKind = ChargingProfileKindType::Absolute;
+    schedule->recurrencyKind = RecurrencyKindType::NOT_SET;
+
+    auto& periods = schedule->chargingSchedulePeriod;
+
     Timestamp periodBegin = Timestamp(startSchedule);
     Timestamp periodStop = Timestamp(startSchedule);
-    while (periodBegin - startSchedule < duration) {
-        float limit = 0.f;
-        inferenceLimit(periodBegin, &limit, &periodStop);
-        auto p = std::unique_ptr<ChargingSchedulePeriod>(new ChargingSchedulePeriod(periodBegin - startSchedule, limit));
-        if (!result->addChargingSchedulePeriod(std::move(p))) {
-            break;
+
+    while (periodBegin - startSchedule < duration && periods.size() < CHARGINGSCHEDULEMAXPERIODS) {
+
+        //calculate limit
+        ChargeRate limit;
+        calculateLimit(periodBegin, limit, periodStop);
+
+        //if the unit is still unspecified, guess by taking the unit of the first limit
+        if (unit == ChargingRateUnitType_Optional::None) {
+            if (limit.power < limit.current) {
+                unit = ChargingRateUnitType_Optional::Watt;
+            } else {
+                unit = ChargingRateUnitType_Optional::Amp;
+            }
         }
+
+        periods.push_back(ChargingSchedulePeriod());
+        float limit_opt = unit == ChargingRateUnitType_Optional::Watt ? limit.power : limit.current;
+        periods.back().limit = limit_opt != std::numeric_limits<float>::max() ? limit_opt : -1.f,
+        periods.back().numberPhases = limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1;
+        periods.back().startPeriod = periodBegin - startSchedule;
+        
         periodBegin = periodStop;
     }
-    return result;
-}
 
-void SmartChargingService::refreshChargingSessionState() {
-    if (!context.getModel().getConnector(SINGLE_CONNECTOR_ID)) {
-        return; //charging session state does not apply
+    if (unit == ChargingRateUnitType_Optional::Watt) {
+        schedule->chargingRateUnit = ChargingRateUnitType::Watt;
+    } else {
+        schedule->chargingRateUnit = ChargingRateUnitType::Amp;
     }
 
-    auto connector = context.getModel().getConnector(SINGLE_CONNECTOR_ID);
+    return schedule;
+}
 
-    if (!chargingSessionStateInitialized) {
-        chargingSessionStateInitialized = true;
+size_t SmartChargingConnector::getChargingProfilesCount() {
+    size_t chargingProfilesCount = 0;
+    for (size_t i = 0; i < CHARGEPROFILEMAXSTACKLEVEL + 1; i++) {
+        if (ChargePointTxDefaultProfile[i]) {
+            chargingProfilesCount++;
+        }
+        if (ChargePointMaxProfile[i]) {
+            chargingProfilesCount++;
+        }
+    }
+    return chargingProfilesCount;
+}
 
-        chargingSessionStart.setTime(*txStartTime);
-        chargingSessionTransactionID = connector->getTransactionId();
-        sessionIdTagRev = connector->getSessionWriteCount();
-        sRmtProfileIdRev = sRmtProfileId->getValueRevision();
+std::unique_ptr<ChargingSchedule> SmartChargingService::getCompositeSchedule(unsigned int connectorId, int duration, ChargingRateUnitType_Optional unit) {
 
-        //fuzzy check if session engaged at reboot (during first loop run)
-        auto chargingSessionStartCheck = MAX_TIME;
-        chargingSessionStartCheck -= 1000000; 
-        if (chargingSessionStart >= chargingSessionStartCheck) {
-            //charging session start lies in future -> null-value -> no charging session before reboot
-            chargingSessionTransactionID = -1;
+    if (connectorId > 0 && !getScConnectorById(connectorId)) {
+        AO_DBG_ERR("invalid args");
+        return nullptr;
+    }
+    
+    if (unit == ChargingRateUnitType_Optional::None) {
+        if (powerSupported && !currentSupported) {
+            unit = ChargingRateUnitType_Optional::Watt;
+        } else if (!powerSupported && currentSupported) {
+            unit = ChargingRateUnitType_Optional::Amp;
         }
     }
 
-    if (connector->getTransactionId() != chargingSessionTransactionID) {
-        //transition!
+    if (connectorId > 0) {
+        return getScConnectorById(connectorId)->getCompositeSchedule(duration, unit);
+    }
+    
+    auto& startSchedule = context.getModel().getClock().now();
+
+    auto schedule = std::unique_ptr<ChargingSchedule>(new ChargingSchedule());
+    schedule->duration = duration;
+    schedule->startSchedule = startSchedule;
+    schedule->chargingProfileKind = ChargingProfileKindType::Absolute;
+    schedule->recurrencyKind = RecurrencyKindType::NOT_SET;
 
-        bool txStartUpdated = false;
-        if (chargingSessionTransactionID != 0 && connector->getTransactionId() >= 0) {
-            chargingSessionStart = context.getModel().getClock().now();
-            txStartUpdated = true;
-        } else if (chargingSessionTransactionID >= 0 && connector->getTransactionId() < 0) {
-            chargingSessionStart = MAX_TIME;
-            txStartUpdated = true;
-        }
+    auto& periods = schedule->chargingSchedulePeriod;
 
-        if (txStartUpdated) {
-            char timestamp [JSONDATE_LENGTH + 1] = {'\0'};
-            chargingSessionStart.toJsonString(timestamp, JSONDATE_LENGTH + 1);
-            *txStartTime = timestamp;
-            configuration_save();
+    Timestamp periodBegin = Timestamp(startSchedule);
+    Timestamp periodStop = Timestamp(startSchedule);
+
+    while (periodBegin - startSchedule < duration && periods.size() < CHARGINGSCHEDULEMAXPERIODS) {
+
+        //calculate limit
+        ChargeRate limit;
+        calculateLimit(periodBegin, limit, periodStop);
+
+        //if the unit is still unspecified, guess by taking the unit of the first limit
+        if (unit == ChargingRateUnitType_Optional::None) {
+            if (limit.power < limit.current) {
+                unit = ChargingRateUnitType_Optional::Watt;
+            } else {
+                unit = ChargingRateUnitType_Optional::Amp;
+            }
         }
 
-        nextChange = context.getModel().getClock().now();
+        periods.push_back(ChargingSchedulePeriod());
+        float limit_opt = unit == ChargingRateUnitType_Optional::Watt ? limit.power : limit.current;
+        periods.back().limit = limit_opt != std::numeric_limits<float>::max() ? limit_opt : -1.f;
+        periods.back().numberPhases = limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1;
+        periods.back().startPeriod = periodBegin - startSchedule;
+
+        periodBegin = periodStop;
     }
-  
-    if (*sRmtProfileId >= 0 && //Remote profile set? Check if to delete
-            (!connector->getSessionIdTag()    //Always delete Rmt profile if there is no session
-            || (sessionIdTagRev != connector->getSessionWriteCount() && sRmtProfileIdRev == sRmtProfileId->getValueRevision()))) {
-                                               //Alternaternively delete if session state has been overwritten
-        
-        //after RemoteTx session expired, clean charging profile
-        int clearProfileId = *sRmtProfileId;
-        bool ret = clearChargingProfile([clearProfileId] (int id, int, ChargingProfilePurposeType, int) {
-            return id == clearProfileId;
-        });
-        (void)ret;
 
-        AO_DBG_DEBUG("Clearing RmtTx Charging Profile after session expiry: %s", ret ? "success" : "already cleared");
+    if (unit == ChargingRateUnitType_Optional::Watt) {
+        schedule->chargingRateUnit = ChargingRateUnitType::Watt;
+    } else {
+        schedule->chargingRateUnit = ChargingRateUnitType::Amp;
+    }
+
+    return schedule;
+}
+
+bool SmartChargingService::setChargingProfile(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile) {
+
+    if ((connectorId > 0 && !getScConnectorById(connectorId)) || !chargingProfile) {
+        AO_DBG_ERR("invalid args");
+        return false;
+    }
+
+    int chargingProfileId = chargingProfile->getChargingProfileId();
+    clearChargingProfile([chargingProfileId] (int id, int, ChargingProfilePurposeType, int) {
+        return id == chargingProfileId;
+    });
+
+    bool success = false;
 
-        *sRmtProfileId = -1;
+    auto profilePtr = updateProfiles(connectorId, std::move(chargingProfile));
+
+    if (profilePtr) {
+        success = SmartChargingServiceUtils::storeProfile(filesystem, connectorId, profilePtr);
+
+        if (!success) {
+            clearChargingProfile([chargingProfileId] (int id, int, ChargingProfilePurposeType, int) {
+                return id == chargingProfileId;
+            });
+        }
     }
 
-    chargingSessionTransactionID = connector->getTransactionId();
-    sessionIdTagRev = connector->getSessionWriteCount();
-    sRmtProfileIdRev = sRmtProfileId->getValueRevision();
+    return success;
 }
 
-void SmartChargingService::setChargingProfile(JsonObject json) {
-    ChargingProfile *pointer = updateProfileStack(json);
-    if (pointer)
-        writeProfileToFlash(json, pointer);
+ChargingProfile *SmartChargingConnector::updateProfiles(std::unique_ptr<ChargingProfile> chargingProfile) {
+    
+    int stackLevel = chargingProfile->getStackLevel(); //already validated
+    
+    switch (chargingProfile->getChargingProfilePurpose()) {
+        case (ChargingProfilePurposeType::ChargePointMaxProfile):
+            break;
+        case (ChargingProfilePurposeType::TxDefaultProfile):
+            TxDefaultProfile[stackLevel] = std::move(chargingProfile);
+            return TxDefaultProfile[stackLevel].get();
+        case (ChargingProfilePurposeType::TxProfile):
+            TxProfile[stackLevel] = std::move(chargingProfile);
+            return TxProfile[stackLevel].get();
+    }
+
+    AO_DBG_ERR("invalid args");
+    return nullptr;
+}
+
+void SmartChargingConnector::notifyProfilesUpdated() {
+    nextChange = model.getClock().now();
 }
 
-ChargingProfile *SmartChargingService::updateProfileStack(JsonObject json){
-    ChargingProfile *chargingProfile = new ChargingProfile(json);
+ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile){
+
+    if ((connectorId > 0 && !getScConnectorById(connectorId)) || !chargingProfile) {
+        AO_DBG_ERR("invalid args");
+        return nullptr;
+    }
 
     if (AO_DBG_LEVEL >= AO_DL_VERBOSE) {
         AO_DBG_VERBOSE("Charging Profile internal model:");
@@ -328,83 +506,112 @@ ChargingProfile *SmartChargingService::updateProfileStack(JsonObject json){
     }
 
     int stackLevel = chargingProfile->getStackLevel();
-    if (stackLevel >= CHARGEPROFILEMAXSTACKLEVEL || stackLevel < 0) {
-        AO_DBG_ERR("Stacklevel of Charging Profile is smaller or greater than CHARGEPROFILEMAXSTACKLEVEL");
-        stackLevel = CHARGEPROFILEMAXSTACKLEVEL - 1;
+    if (stackLevel< 0 || stackLevel >= CHARGEPROFILEMAXSTACKLEVEL + 1) {
+        AO_DBG_ERR("input validation failed");
+        return nullptr;
+    }
+
+    size_t chargingProfilesCount = 0;
+    for (size_t i = 0; i < CHARGEPROFILEMAXSTACKLEVEL + 1; i++) {
+        if (ChargePointTxDefaultProfile[i]) {
+            chargingProfilesCount++;
+        }
+        if (ChargePointMaxProfile[i]) {
+            chargingProfilesCount++;
+        }
+    }
+    for (size_t i = 0; i < connectors.size(); i++) {
+        chargingProfilesCount += connectors[i].getChargingProfilesCount();
+    }
+
+    if (chargingProfilesCount >= MAXCHARGINGPROFILESINSTALLED) {
+        AO_DBG_WARN("number of maximum charging profiles exceeded");
+        return nullptr;
     }
 
-    ChargingProfile **profilePurposeStack; //select which stack this profile belongs to due to its purpose
+    ChargingProfile *res = nullptr;
 
     switch (chargingProfile->getChargingProfilePurpose()) {
+        case (ChargingProfilePurposeType::ChargePointMaxProfile):
+            if (connectorId != 0) {
+                AO_DBG_WARN("invalid charging profile");
+                return nullptr;
+            }
+            ChargePointMaxProfile[stackLevel] = std::move(chargingProfile);
+            res = ChargePointMaxProfile[stackLevel].get();
+            break;
         case (ChargingProfilePurposeType::TxDefaultProfile):
-            profilePurposeStack = TxDefaultProfile;
+            if (connectorId == 0) {
+                ChargePointTxDefaultProfile[stackLevel] = std::move(chargingProfile);
+                res = ChargePointTxDefaultProfile[stackLevel].get();
+            } else {
+                if (!getScConnectorById(connectorId)) {
+                    AO_DBG_WARN("invalid charging profile");
+                    return nullptr;
+                }
+                res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
+            }
             break;
         case (ChargingProfilePurposeType::TxProfile):
-            profilePurposeStack = TxProfile;
-            break;
-        default:
-            //case (ChargingProfilePurposeType::ChargePointMaxProfile):
-            profilePurposeStack = ChargePointMaxProfile;
+            if (!getScConnectorById(connectorId)) {
+                AO_DBG_WARN("invalid charging profile");
+                return nullptr;
+            }
+            res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
             break;
     }
-    
-    if (profilePurposeStack[stackLevel] != NULL){
-        delete profilePurposeStack[stackLevel];
-    }
-
-    profilePurposeStack[stackLevel] = chargingProfile;
 
     /**
      * Invalidate the last limit inference by setting the nextChange to now. By the next loop()-call, the limit
      * and nextChange will be recalculated and onLimitChanged will be called.
      */
-    nextChange = context.getModel().getClock().now();
+    if (res) {
+        nextChange = context.getModel().getClock().now();
+        for (size_t i = 0; i < connectors.size(); i++) {
+            connectors[i].notifyProfilesUpdated();
+        }
+    }
 
-    return chargingProfile;
+    return res;
 }
 
-bool SmartChargingService::clearChargingProfile(const std::function<bool(int, int, ChargingProfilePurposeType, int)>& filter) {
-    int nMatches = 0;
+bool SmartChargingConnector::clearChargingProfile(const std::function<bool(int, int, ChargingProfilePurposeType, int)> filter) {
+    bool found = false;
 
-    ChargingProfile **profileStacks [] = {ChargePointMaxProfile, TxDefaultProfile, TxProfile};
+    ProfileStack *profileStacks [] = {&TxProfile, &TxDefaultProfile};
 
-    for (ChargingProfile **profileStack : profileStacks) {
-        for (int iLevel = 0; iLevel < CHARGEPROFILEMAXSTACKLEVEL; iLevel++) {
-            ChargingProfile *chargingProfile = profileStack[iLevel];
-            if (chargingProfile == NULL)
-                continue;
+    for (auto stack : profileStacks) {
+        for (size_t iLevel = 0; iLevel < stack->size(); iLevel++) {
+            if (auto& profile = stack->at(iLevel)) {
+                if (profile && filter(profile->getChargingProfileId(), connectorId, profile->getChargingProfilePurpose(), iLevel)) {
+                    found = true;
+                    SmartChargingServiceUtils::removeProfile(filesystem, connectorId, profile->getChargingProfilePurpose(), iLevel);
+                    profile.reset();
+                }
+            }
+        }
+    }
 
-            //                                                               -1: multiple connectors are not supported yet for Smart Charging
-            bool tbCleared = filter(chargingProfile->getChargingProfileId(), -1, chargingProfile->getChargingProfilePurpose(), iLevel);
-
-            if (tbCleared) {
-                nMatches++;
-
-#ifndef AO_DEACTIVATE_FLASH
-                if (filesystemOpt.accessAllowed()) {
-                    char fn [PROFILE_FN_MAXSIZE] = {'\0'};
-
-                    switch (chargingProfile->getChargingProfilePurpose()) {
-                        case (ChargingProfilePurposeType::ChargePointMaxProfile):
-                            snprintf(fn, PROFILE_FN_MAXSIZE, PROFILE_FN_PREFIX "CpMaxProfile-%d" PROFILE_FN_SUFFIX, chargingProfile->getStackLevel());
-                            break;
-                        case (ChargingProfilePurposeType::TxDefaultProfile):
-                            snprintf(fn, PROFILE_FN_MAXSIZE, PROFILE_FN_PREFIX "TxDefProfile-%d" PROFILE_FN_SUFFIX, chargingProfile->getStackLevel());
-                            break;
-                        case (ChargingProfilePurposeType::TxProfile):
-                            snprintf(fn, PROFILE_FN_MAXSIZE, PROFILE_FN_PREFIX "TxProfile-%d"    PROFILE_FN_SUFFIX, chargingProfile->getStackLevel());
-                            break;
-                    }
-
-                    if (USE_FS.exists(fn)) {
-                        USE_FS.remove(fn);
-                    }
-                } else {
-                    AO_DBG_DEBUG("Prohibit access to FS");
+    return found;
+}
+
+bool SmartChargingService::clearChargingProfile(std::function<bool(int, int, ChargingProfilePurposeType, int)> filter) {
+    bool found = false;
+
+    for (size_t cId = 0; cId < connectors.size(); cId++) {
+        found |= connectors[cId].clearChargingProfile(filter);
+    }
+
+    ProfileStack *profileStacks [] = {&ChargePointMaxProfile, &ChargePointTxDefaultProfile};
+
+    for (auto stack : profileStacks) {
+        for (size_t iLevel = 0; iLevel < stack->size(); iLevel++) {
+            if (auto& profile = stack->at(iLevel)) {
+                if (filter(profile->getChargingProfileId(), 0, profile->getChargingProfilePurpose(), iLevel)) {
+                    found = true;
+                    SmartChargingServiceUtils::removeProfile(filesystem, 0, profile->getChargingProfilePurpose(), iLevel);
+                    profile.reset();
                 }
-#endif
-                delete chargingProfile;
-                profileStack[iLevel] = nullptr;
             }
         }
     }
@@ -414,172 +621,137 @@ bool SmartChargingService::clearChargingProfile(const std::function<bool(int, in
      * and nextChange will be recalculated and onLimitChanged will be called.
      */
     nextChange = context.getModel().getClock().now();
+    for (size_t i = 0; i < connectors.size(); i++) {
+        connectors[i].notifyProfilesUpdated();
+    }
 
-    return nMatches > 0;
+    return found;
 }
 
-bool SmartChargingService::writeProfileToFlash(JsonObject json, ChargingProfile *chargingProfile) {
-#ifndef AO_DEACTIVATE_FLASH
+bool SmartChargingService::loadProfiles() {
+
+    bool success = true;
 
-    if (!filesystemOpt.accessAllowed()) {
-        AO_DBG_DEBUG("Prohibit access to FS");
-        return true;
+    if (!filesystem) {
+        AO_DBG_DEBUG("no filesystem");
+        return true; //not an error
     }
 
-    char fn [PROFILE_FN_MAXSIZE] = {'\0'};
+    ChargingProfilePurposeType purposes[] = {ChargingProfilePurposeType::ChargePointMaxProfile, ChargingProfilePurposeType::TxDefaultProfile, ChargingProfilePurposeType::TxProfile};
 
-    switch (chargingProfile->getChargingProfilePurpose()) {
-        case (ChargingProfilePurposeType::ChargePointMaxProfile):
-            snprintf(fn, PROFILE_FN_MAXSIZE, PROFILE_FN_PREFIX "CpMaxProfile-%d" PROFILE_FN_SUFFIX, chargingProfile->getStackLevel());
-            break;
-        case (ChargingProfilePurposeType::TxDefaultProfile):
-            snprintf(fn, PROFILE_FN_MAXSIZE, PROFILE_FN_PREFIX "TxDefProfile-%d" PROFILE_FN_SUFFIX, chargingProfile->getStackLevel());
-            break;
-        case (ChargingProfilePurposeType::TxProfile):
-            snprintf(fn, PROFILE_FN_MAXSIZE, PROFILE_FN_PREFIX "TxProfile-%d"    PROFILE_FN_SUFFIX, chargingProfile->getStackLevel());
-            break;
-    }
+    char fn [AO_MAX_PATH_SIZE] = {'\0'};
 
-    if (USE_FS.exists(fn)) {
-        USE_FS.remove(fn);
-    }
+    for (auto purpose : purposes) {
+        for (unsigned int cId = 0; cId < numConnectors; cId++) {
+            if (cId > 0 && purpose == ChargingProfilePurposeType::ChargePointMaxProfile) {
+                continue;
+            }
+            for (unsigned int iLevel = 0; iLevel < CHARGEPROFILEMAXSTACKLEVEL; iLevel++) {
 
-    File file = USE_FS.open(fn, "w");
+                if (!SmartChargingServiceUtils::printProfileFileName(fn, AO_MAX_PATH_SIZE, cId, purpose, iLevel)) {
+                    return false;
+                }
 
-    if (!file) {
-        AO_DBG_ERR("Unable to save: could not save profile: %s", fn);
-        return false;
-    }
+                size_t msize = 0;
+                if (filesystem->stat(fn, &msize) != 0) {
+                    continue; //There is not a profile on the stack iStack with stacklevel iLevel. Normal case, just continue.
+                }
 
-    // Serialize JSON to file
-    if (serializeJson(json, file) == 0) {
-        AO_DBG_ERR("Unable to save: could not serialize JSON for profile: %s", fn);
-        file.close();
-        return false;
-    }
+                auto profileDoc = FilesystemUtils::loadJson(filesystem, fn);
+                if (!profileDoc) {
+                    success = false;
+                    AO_DBG_ERR("profile corrupt: %s, remove", fn);
+                    filesystem->remove(fn);
+                    continue;
+                }
 
-    //success
-    file.close();
+                JsonObject profileJson = profileDoc->as<JsonObject>();
+                auto chargingProfile = loadChargingProfile(profileJson);
 
-    AO_DBG_DEBUG("Saving profile successful");
+                bool valid = false;
+                if (chargingProfile) {
+                    valid = updateProfiles(cId, std::move(chargingProfile));
+                }
+                if (!valid) {
+                    success = false;
+                    AO_DBG_ERR("profile corrupt: %s, remove", fn);
+                    filesystem->remove(fn);
+                }
+            }
+        }
+    }
 
-#endif //ndef AO_DEACTIVATE_FLASH
-    return true;
+    return success;
 }
 
-bool SmartChargingService::loadProfiles() {
-
-    bool success = true;
+SmartChargingConnector *SmartChargingService::getScConnectorById(unsigned int connectorId) {
+    if (connectorId == 0) {
+        return nullptr;
+    }
 
-#ifndef AO_DEACTIVATE_FLASH
-    if (!filesystemOpt.accessAllowed()) {
-        AO_DBG_DEBUG("Prohibit access to FS");
-        return true;
+    if (connectorId - 1 >= connectors.size()) {
+        return nullptr;
     }
 
-    ChargingProfilePurposeType purposes[] = {ChargingProfilePurposeType::ChargePointMaxProfile, ChargingProfilePurposeType::TxDefaultProfile, ChargingProfilePurposeType::TxProfile};
+    return &connectors[connectorId-1];
+}
 
-    char fn [PROFILE_FN_MAXSIZE] = {'\0'};
+bool SmartChargingServiceUtils::printProfileFileName(char *out, size_t bufsize, unsigned int connectorId, ChargingProfilePurposeType purpose, unsigned int stackLevel) {
+    int pret = 0;
 
-    for (const ChargingProfilePurposeType purpose : purposes) {
+    switch (purpose) {
+        case (ChargingProfilePurposeType::ChargePointMaxProfile):
+            pret = snprintf(out, bufsize, AO_FILENAME_PREFIX "sc-cm-%u.jsn", stackLevel);
+            break;
+        case (ChargingProfilePurposeType::TxDefaultProfile):
+            pret = snprintf(out, bufsize, AO_FILENAME_PREFIX "sc-td-%u-%u.jsn", connectorId, stackLevel);
+            break;
+        case (ChargingProfilePurposeType::TxProfile):
+            pret = snprintf(out, bufsize, AO_FILENAME_PREFIX "sc-tx-%u-%u.jsn", connectorId, stackLevel);
+            break;
+    }
 
-        for (int iLevel = 0; iLevel < CHARGEPROFILEMAXSTACKLEVEL; iLevel++) {
+    if (pret < 0 || pret >= bufsize) {
+        AO_DBG_ERR("fn error: %i", pret);
+        return false;
+    }
 
-            switch (purpose) {
-                case (ChargingProfilePurposeType::ChargePointMaxProfile):
-                    snprintf(fn, PROFILE_FN_MAXSIZE, PROFILE_FN_PREFIX "CpMaxProfile-%d" PROFILE_FN_SUFFIX, iLevel);
-                    break;
-                case (ChargingProfilePurposeType::TxDefaultProfile):
-                    snprintf(fn, PROFILE_FN_MAXSIZE, PROFILE_FN_PREFIX "TxDefProfile-%d" PROFILE_FN_SUFFIX, iLevel);
-                    break;
-                case (ChargingProfilePurposeType::TxProfile):
-                    snprintf(fn, PROFILE_FN_MAXSIZE, PROFILE_FN_PREFIX "TxProfile-%d"    PROFILE_FN_SUFFIX, iLevel);
-                    break;
-            }
+    return true;
+}
 
-            if (!USE_FS.exists(fn)) {
-                continue; //There is not a profile on the stack iStack with stacklevel iLevel. Normal case, just continue.
-            }
-            
-            File file = USE_FS.open(fn, "r");
+bool SmartChargingServiceUtils::storeProfile(std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ChargingProfile *chargingProfile) {
 
-            if (file) {
-                AO_DBG_DEBUG("Load profile from file: %s", fn);
-            } else {
-                AO_DBG_ERR("Unable to initialize: could not open file for profile: %s", fn);
-                success = false;
-                continue;
-            }
+    if (!filesystem) {
+        return false;
+    }
 
-            if (!file.available()) {
-                AO_DBG_ERR("Unable to initialize: empty file for profile: %s", fn);
-                file.close();
-                success = false;
-                continue;
-            }
+    DynamicJsonDocument chargingProfileJson {0};
+    if (!chargingProfile->toJson(chargingProfileJson)) {
+        return false;
+    }
 
-            int file_size = file.size();
+    char fn [AO_MAX_PATH_SIZE] = {'\0'};
 
-            if (file_size < 2) {
-                AO_DBG_ERR("Unable to initialize: too short for json: %s", fn);
-                success = false;
-                continue;
-            }
-            
-            size_t capacity = 2*file_size;
-            if (capacity < PROFILE_CUSTOM_CAPACITY)
-                capacity = PROFILE_CUSTOM_CAPACITY;
-            if (capacity > PROFILE_MAX_CAPACITY)
-                capacity = PROFILE_MAX_CAPACITY;
-
-            while (capacity <= PROFILE_MAX_CAPACITY) {
-                bool increaseCapacity = false;
-                bool error = true;
-
-                DynamicJsonDocument profileDoc(capacity);
-
-                DeserializationError jsonError = deserializeJson(profileDoc, file);
-                switch (jsonError.code()) {
-                    case DeserializationError::Ok:
-                        error = false;
-                        break;
-                    case DeserializationError::InvalidInput:
-                        AO_DBG_ERR("Unable to initialize: invalid json in file: %s", fn);
-                        success = false;
-                        break;
-                    case DeserializationError::NoMemory:
-                        increaseCapacity = true;
-                        error = false;
-                        break;
-                    default:
-                        AO_DBG_ERR("Unable to initialize: error in file: %s", fn);
-                        success = false;
-                        break;
-                }
+    if (!printProfileFileName(fn, AO_MAX_PATH_SIZE, connectorId, chargingProfile->getChargingProfilePurpose(), chargingProfile->getStackLevel())) {
+        return false;
+    }
 
-                if (error) {
-                    break;
-                }
+    return FilesystemUtils::storeJson(filesystem, fn, chargingProfileJson);
+}
 
-                if (increaseCapacity) {
-                    capacity *= 3;
-                    capacity /= 2;
-                    file.seek(0, SeekSet); //rewind file to beginning
-                    AO_DBG_DEBUG("Initialization: increase JsonCapacity to %zu for file: %s", capacity, fn);
-                    continue;
-                }
+bool SmartChargingServiceUtils::removeProfile(std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ChargingProfilePurposeType purpose, unsigned int stackLevel) {
 
-                JsonObject profileJson = profileDoc.as<JsonObject>();
-                updateProfileStack(profileJson);
+    if (!filesystem) {
+        return false;
+    }
 
-                profileDoc.clear();
-                break;
-            }
+    char fn [AO_MAX_PATH_SIZE] = {'\0'};
 
-            file.close();
-        }
+    if (!printProfileFileName(fn, AO_MAX_PATH_SIZE, connectorId, purpose, stackLevel)) {
+        return false;
     }
 
-#endif //ndef AO_DEACTIVATE_FLASH
-    return success;
+    return filesystem->remove(fn);
 }
+
+
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
index 94249ae8..1bc1b96e 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
@@ -5,60 +5,117 @@
 #ifndef SMARTCHARGINGSERVICE_H
 #define SMARTCHARGINGSERVICE_H
 
-#define CHARGEPROFILEMAXSTACKLEVEL 8
-#define CHARGINGSCHEDULEMAXPERIODS 24
-#define MAXCHARGINGPROFILESINSTALLED 10
+#include <functional>
+#include <array>
 
 #include <ArduinoJson.h>
-#include <functional>
 
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/Time.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
 
 namespace ArduinoOcpp {
 
-using OnLimitChange = std::function<void(float)>;
+enum class ChargingRateUnitType_Optional {
+    Watt,
+    Amp,
+    None
+};
 
 class Context;
+class Model;
+
+using ProfileStack = std::array<std::unique_ptr<ChargingProfile>, CHARGEPROFILEMAXSTACKLEVEL + 1>;
+
+class SmartChargingConnector {
+private:
+    Model& model;
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    const unsigned int connectorId;
+
+    ProfileStack& ChargePointMaxProfile;
+    ProfileStack& ChargePointTxDefaultProfile;
+    ProfileStack TxDefaultProfile;
+    ProfileStack TxProfile;
+
+    std::function<void(float,float,int)> limitOutput;
+
+    int trackTxRmtProfileId = -1; //optional Charging Profile ID when tx is started via RemoteStartTx
+    Timestamp trackTxStart = MAX_TIME; //time basis for relative profiles
+    int trackTxId = -1; //transactionId assigned by OCPP server
+
+    Timestamp nextChange = MIN_TIME;
+
+    ChargeRate trackLimitOutput;
+
+public:
+    SmartChargingConnector(Model& model, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ProfileStack& ChargePointMaxProfile, ProfileStack& ChargePointTxDefaultProfile);
+    SmartChargingConnector(SmartChargingConnector&&) = default;
+    ~SmartChargingConnector();
+
+    void loop();
+
+    void setSmartChargingOutput(std::function<void(float,float,int)> limitOutput); //read maximum Watt x Amps x numberPhases
+
+    void calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut);
+
+    void trackTransaction();
+
+    ChargingProfile *updateProfiles(std::unique_ptr<ChargingProfile> chargingProfile);
+
+    void notifyProfilesUpdated();
+
+    bool clearChargingProfile(std::function<bool(int, int, ChargingProfilePurposeType, int)> filter);
+
+    std::unique_ptr<ChargingSchedule> getCompositeSchedule(int duration, ChargingRateUnitType_Optional unit);
+
+    size_t getChargingProfilesCount();
+};
 
 class SmartChargingService {
 private:
     Context& context;
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    std::vector<SmartChargingConnector> connectors; //connectorId 0 excluded
+    SmartChargingConnector *getScConnectorById(unsigned int connectorId);
+    unsigned int numConnectors; //connectorId 0 included
     
-    const float DEFAULT_CHARGE_LIMIT;
-    const float V_eff; //use for approximation: chargingLimit in A * V_eff = chargingLimit in W
-    ChargingProfile *ChargePointMaxProfile[CHARGEPROFILEMAXSTACKLEVEL];
-    ChargingProfile *TxDefaultProfile[CHARGEPROFILEMAXSTACKLEVEL];
-    ChargingProfile *TxProfile[CHARGEPROFILEMAXSTACKLEVEL];
-    OnLimitChange onLimitChange = NULL;
-    float limitBeforeChange;
-    Timestamp nextChange;
-
-    bool chargingSessionStateInitialized {false};
-    std::shared_ptr<Configuration<const char*>> txStartTime;
-    Timestamp chargingSessionStart;
-    int chargingSessionTransactionID;
-    std::shared_ptr<Configuration<int>> sRmtProfileId;
-    uint16_t sRmtProfileIdRev {0};
-    uint16_t sessionIdTagRev {0};
-    void refreshChargingSessionState();
-
-    ChargingProfile *updateProfileStack(JsonObject json);
-    FilesystemOpt filesystemOpt;
-    bool writeProfileToFlash(JsonObject json, ChargingProfile *chargingProfile);
+    ProfileStack ChargePointMaxProfile;
+    ProfileStack ChargePointTxDefaultProfile;
+
+    std::function<void(float,float,int)> limitOutput;
+    ChargeRate trackLimitOutput;
+    bool powerSupported = false;
+    bool currentSupported = false;
+
+    Timestamp nextChange = MIN_TIME;
+
+    ChargingProfile *updateProfiles(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile);
     bool loadProfiles();
   
 public:
-    SmartChargingService(Context& context, float chargeLimit, float V_eff, int numConnectors, FilesystemOpt filesystemOpt = FilesystemOpt::Use_Mount_FormatOnFail);
-    void setChargingProfile(JsonObject json);
-    bool clearChargingProfile(const std::function<bool(int, int, ChargingProfilePurposeType, int)>& filter);
-    void inferenceLimit(const Timestamp &t, float *limit, Timestamp *validTo);
-    float inferenceLimitNow();
-    void setOnLimitChange(OnLimitChange onLimitChange);
-    ChargingSchedule *getCompositeSchedule(int connectorId, int duration);
+    SmartChargingService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int numConnectors);
+    ~SmartChargingService();
+
+    void setSmartChargingOutput(unsigned int connectorId, std::function<void(float,float,int)> limitOutput); //read maximum Watt x Amps x numberPhases
+    void updateAllowedChargingRateUnit(bool powerSupported, bool currentSupported); //set supported measurand of SmartChargingOutput
+
+    bool setChargingProfile(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile);
+
+    bool clearChargingProfile(std::function<bool(int, int, ChargingProfilePurposeType, int)> filter);
+    void calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut);
+    std::unique_ptr<ChargingSchedule> getCompositeSchedule(unsigned int connectorId, int duration, ChargingRateUnitType_Optional unit = ChargingRateUnitType_Optional::None);
     void loop();
 };
 
+//filesystem-related helper functions
+namespace SmartChargingServiceUtils {
+bool printProfileFileName(char *out, size_t bufsize, unsigned int connectorId, ChargingProfilePurposeType purpose, unsigned int stackLevel);
+bool storeProfile(std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ChargingProfile *chargingProfile);
+bool removeProfile(std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ChargingProfilePurposeType purpose, unsigned int stackLevel);
+}
+
 } //end namespace ArduinoOcpp
+
 #endif
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
index fa645f0d..d58fb80e 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -86,7 +86,7 @@ bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
         txStop["idTag"] = tx.getStopIdTag();
     }
 
-    if (tx.isMeterStopDefined() >= 0) {
+    if (tx.isMeterStopDefined()) {
         txStop["meter"] = tx.getMeterStop();
     }
 
diff --git a/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp b/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
index d42281a3..3d86ce30 100644
--- a/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
+++ b/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
@@ -3,7 +3,6 @@
 // MIT License
 
 #include <ArduinoOcpp/Operations/ClearChargingProfile.h>
-#include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -11,7 +10,7 @@
 
 using ArduinoOcpp::Ocpp16::ClearChargingProfile;
 
-ClearChargingProfile::ClearChargingProfile(Model& model) : model(model) {
+ClearChargingProfile::ClearChargingProfile(SmartChargingService& scService) : scService{scService} {
 
 }
 
@@ -25,13 +24,17 @@ void ClearChargingProfile::processReq(JsonObject payload) {
             (int chargingProfileId, int connectorId, ChargingProfilePurposeType chargingProfilePurpose, int stackLevel) {
         
         if (payload.containsKey("id")) {
-            if (chargingProfileId != (payload["id"] | -1)) {
+            if (chargingProfileId == (payload["id"] | -1)) {
+                return true;
+            } else {
                 return false;
             }
         }
 
         if (payload.containsKey("connectorId")) {
-            AO_DBG_WARN("Smart Charging does not implement multiple connectors yet. Ignore connectorId");
+            if (connectorId != (payload["connectorId"] | -1)) {
+                return false;
+            }
         }
 
         if (payload.containsKey("chargingProfilePurpose")) {
@@ -63,12 +66,7 @@ void ClearChargingProfile::processReq(JsonObject payload) {
         return true;
     };
 
-    if (auto scService = model.getSmartChargingService()) {
-        matchingProfilesFound = scService->clearChargingProfile(filter);
-    } else {
-        AO_DBG_ERR("SmartChargingService not initialized");
-        errorCode = "NotSupported";
-    }
+    matchingProfilesFound = scService.clearChargingProfile(filter);
 }
 
 std::unique_ptr<DynamicJsonDocument> ClearChargingProfile::createConf(){
diff --git a/src/ArduinoOcpp/Operations/ClearChargingProfile.h b/src/ArduinoOcpp/Operations/ClearChargingProfile.h
index 98d76ba0..522b0cf0 100644
--- a/src/ArduinoOcpp/Operations/ClearChargingProfile.h
+++ b/src/ArduinoOcpp/Operations/ClearChargingProfile.h
@@ -9,17 +9,17 @@
 
 namespace ArduinoOcpp {
 
-class Model;
+class SmartChargingService;
 
 namespace Ocpp16 {
 
 class ClearChargingProfile : public Operation {
 private:
-    Model& model;
+    SmartChargingService& scService;
     bool matchingProfilesFound = false;
     const char *errorCode;
 public:
-    ClearChargingProfile(Model& model);
+    ClearChargingProfile(SmartChargingService& scService);
 
     const char* getOperationType();
 
diff --git a/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp b/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
index 37958d31..3956b078 100644
--- a/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
@@ -4,15 +4,12 @@
 
 #include <ArduinoOcpp/Operations/GetCompositeSchedule.h>
 #include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Debug.h>
 
-#include <functional>
-
 using ArduinoOcpp::Ocpp16::GetCompositeSchedule;
 
-GetCompositeSchedule::GetCompositeSchedule(Model& model) : model(model) {
+GetCompositeSchedule::GetCompositeSchedule(Model& model, SmartChargingService& scService) : model{model}, scService{scService} {
 
 }
 
@@ -34,63 +31,46 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
         errorCode = "PropertyConstraintViolation";
     }
 
-    auto unitString =  payload["chargingRateUnit"] | "W";
-
-    if (unitString[0] == 'A' || unitString[0] == 'a') {
-        chargingRateUnit = ChargingRateUnitType::Amp;
-    } else if (unitString[0] == 'W' || unitString[0] == 'w') {
-        chargingRateUnit = ChargingRateUnitType::Watt;
-    } else {
-        errorCode = "PropertyConstraintViolation";
-    }
+    const char *unitStr =  payload["chargingRateUnit"] | "_Undefined";
 
-    if (!model.getSmartChargingService()) {
-        AO_DBG_ERR("SmartChargingService not initialized! Ignore request");
-        errorCode = "NotSupported";
+    if (unitStr[0] == 'A' || unitStr[0] == 'a') {
+        chargingRateUnit = ChargingRateUnitType_Optional::Amp;
+    } else if (unitStr[0] == 'W' || unitStr[0] == 'w') {
+        chargingRateUnit = ChargingRateUnitType_Optional::Watt;
     }
 }
 
 std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
-    auto scService = model.getSmartChargingService();
-    if (!scService) {
-        AO_DBG_ERR("invalid state");
-        return createEmptyDocument();
-    }
 
-    ChargingSchedule *composite = scService->getCompositeSchedule((unsigned int) connectorId, duration);
-    DynamicJsonDocument *compositeJson {nullptr};
+    bool success = false;
 
-    if (composite) {
-        compositeJson = composite->toJsonDocument();
+    auto chargingSchedule = scService.getCompositeSchedule((unsigned int) connectorId, duration, chargingRateUnit);
+    DynamicJsonDocument chargingScheduleDoc {0};
+
+    if (chargingSchedule) {
+        success = chargingSchedule->toJson(chargingScheduleDoc);
     }
 
-    std::unique_ptr<DynamicJsonDocument> doc;
+    char scheduleStart_str [JSONDATE_LENGTH + 1] = {'\0'};
+
+    if (success && chargingSchedule) {
+        success = chargingSchedule->startSchedule.toJsonString(scheduleStart_str, JSONDATE_LENGTH + 1);
+    }
 
-    if (compositeJson) {
-        doc.reset(new DynamicJsonDocument(JSON_OBJECT_SIZE(4) + JSONDATE_LENGTH + 1 + compositeJson->capacity()));
+    if (success && chargingSchedule) {
+        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                        JSON_OBJECT_SIZE(4) +
+                        chargingScheduleDoc.memoryUsage()));
         JsonObject payload = doc->to<JsonObject>();
         payload["status"] = "Accepted";
-        if (connectorId > 0)
-            payload["connectorId"] = connectorId;
-
-        char scheduleStart [JSONDATE_LENGTH + 1] {'\0'};
-        auto startSchedule = (*compositeJson)["startSchedule"] | "";
-        if (startSchedule[0] != '\0') {
-            strncpy(scheduleStart, startSchedule, JSONDATE_LENGTH + 1);
-        } else {
-            model.getClock().now().toJsonString(scheduleStart, JSONDATE_LENGTH + 1);
-        }
-        payload["scheduleStart"] = scheduleStart;
-        
-        payload["chargingSchedule"] = *compositeJson;
+        payload["connectorId"] = connectorId;
+        payload["scheduleStart"] = scheduleStart_str;
+        payload["chargingSchedule"] = chargingScheduleDoc;
+        return doc;
     } else {
-        doc.reset(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
         JsonObject payload = doc->to<JsonObject>();
         payload["status"] = "Rejected";
+        return doc;
     }
-
-    delete compositeJson;
-    delete composite;
-
-    return doc;
 }
diff --git a/src/ArduinoOcpp/Operations/GetCompositeSchedule.h b/src/ArduinoOcpp/Operations/GetCompositeSchedule.h
index ba8a64e4..4a4368e0 100644
--- a/src/ArduinoOcpp/Operations/GetCompositeSchedule.h
+++ b/src/ArduinoOcpp/Operations/GetCompositeSchedule.h
@@ -7,7 +7,7 @@
 
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
 
 namespace ArduinoOcpp {
 
@@ -18,13 +18,14 @@ namespace Ocpp16 {
 class GetCompositeSchedule : public Operation {
 private:
     Model& model;
-    int connectorId {-1};
-    int duration {0};
-    ChargingRateUnitType chargingRateUnit {ChargingRateUnitType::Watt};
+    SmartChargingService& scService;
+    int connectorId = -1;
+    int duration = -1;
+    ChargingRateUnitType_Optional chargingRateUnit = ChargingRateUnitType_Optional::None;
 
     const char *errorCode {nullptr};
 public:
-    GetCompositeSchedule(Model& model);
+    GetCompositeSchedule(Model& model, SmartChargingService& scService);
 
     const char* getOperationType();
 
diff --git a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
index afb2d011..d81bd4a9 100644
--- a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
@@ -5,9 +5,9 @@
 
 #include <ArduinoOcpp/Operations/RemoteStartTransaction.h>
 #include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::RemoteStartTransaction;
@@ -23,28 +23,44 @@ const char* RemoteStartTransaction::getOperationType() {
 void RemoteStartTransaction::processReq(JsonObject payload) {
     connectorId = payload["connectorId"] | -1;
 
-    const char *idTagIn = payload["idTag"] | "";
-    size_t len = strnlen(idTagIn, IDTAG_LEN_MAX + 2);
-    if (len <= IDTAG_LEN_MAX) {
-        snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
+    if (!payload.containsKey("idTag")) {
+        errorCode = "FormationViolation";
+        return;
     }
 
-    if (*idTag == '\0') {
-        AO_DBG_WARN("idTag format violation");
-        errorCode = "FormationViolation";
+    const char *idTagIn = payload["idTag"] | "";
+    size_t len = strnlen(idTagIn, IDTAG_LEN_MAX + 1);
+    if (len > 0 && len <= IDTAG_LEN_MAX) {
+        snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
+    } else {
+        errorCode = "PropertyConstraintViolation";
+        errorDescription = "idTag empty or too long";
+        return;
     }
 
-    if (payload.containsKey("chargingProfile")) {
+    if (payload.containsKey("chargingProfile") && model.getSmartChargingService()) {
         AO_DBG_INFO("Setting Charging profile via RemoteStartTransaction");
 
-        JsonObject chargingProfile = payload["chargingProfile"];
-        if ((chargingProfile["chargingProfileId"] | -1) < 0) {
-            AO_DBG_WARN("RemoteStartTx profile requires non-negative chargingProfileId");
-            errorCode = chargingProfile.containsKey("chargingProfileId") ? 
-                        "PropertyConstraintViolation" : "FormationViolation";
+        JsonObject chargingProfileJson = payload["chargingProfile"];
+        chargingProfile = loadChargingProfile(chargingProfileJson);
+
+        if (!chargingProfile) {
+            errorCode = "PropertyConstraintViolation";
+            errorDescription = "chargingProfile validation failed";
+            return;
+        }
+
+        if (chargingProfile->getChargingProfilePurpose() != ChargingProfilePurposeType::TxProfile) {
+            errorCode = "PropertyConstraintViolation";
+            errorDescription = "Can only set TxProfile here";
+            return;
+        }
+
+        if (chargingProfile->getChargingProfileId() < 0) {
+            errorCode = "PropertyConstraintViolation";
+            errorDescription = "RemoteStartTx profile requires non-negative chargingProfileId";
+            return;
         }
-        chargingProfileDoc = DynamicJsonDocument(chargingProfile.memoryUsage()); //copy TxProfile
-        chargingProfileDoc.set(chargingProfile);
     }
 }
 
@@ -52,14 +68,14 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
     
-    bool canStartTransaction = false;
+    Connector *selectConnector = nullptr;
     if (connectorId >= 1) {
         //connectorId specified for given connector, try to start Transaction here
         if (auto connector = model.getConnector(connectorId)){
             if (connector->getTransactionId() < 0 &&
                         connector->getAvailability() == AVAILABILITY_OPERATIVE &&
-                        connector->getSessionIdTag() == nullptr) {
-                canStartTransaction = true;
+                        !connector->getTransaction()) {
+                selectConnector = connector;
             }
         }
     } else {
@@ -68,49 +84,41 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
             auto connector = model.getConnector(cid);
             if (connector->getTransactionId() < 0 && 
                         connector->getAvailability() == AVAILABILITY_OPERATIVE &&
-                        connector->getSessionIdTag() == nullptr) {
-                canStartTransaction = true;
+                        !connector->getTransaction()) {
+                selectConnector = connector;
                 connectorId = cid;
                 break;
             }
         }
     }
 
-    if (canStartTransaction) {
-
-        auto sRmtProfileId = declareConfiguration<int>("AO_SRMTPROFILEID_CONN_1", -1, AO_KEYVALUE_FN, false, false, true, false);
+    if (selectConnector) {
 
-        if (auto scService = model.getSmartChargingService()) {
+        bool success = true;
 
-            if (*sRmtProfileId >= 0) {
-                int clearProfileId = *sRmtProfileId;
-                bool ret = scService->clearChargingProfile([clearProfileId](int id, int, ChargingProfilePurposeType, int) {
-                    return id == clearProfileId;
-                });
-                (void)ret;
+        int chargingProfileId = -1; //keep Id after moving charging profile to SCService
 
-                *sRmtProfileId = -1;
-                AO_DBG_DEBUG("Cleared Charging Profile from previous RemoteStartTx: %s", ret ? "success" : "already cleared");
-                configuration_save();
-            }
+        if (chargingProfile && model.getSmartChargingService()) {
+            chargingProfileId = chargingProfile->getChargingProfileId();
+            success = model.getSmartChargingService()->setChargingProfile(connectorId, std::move(chargingProfile));
         }
 
-        if (auto connector = model.getConnector(connectorId)) {
-            connector->beginTransaction_authorized(idTag);
+        if (success) {
+            auto tx = selectConnector->beginTransaction_authorized(idTag);
+            if (tx) {
+                if (chargingProfileId >= 0) {
+                    tx->setTxProfileId(chargingProfileId);
+                }
+            } else {
+                success = false;
+            }
         }
 
-        if (!chargingProfileDoc.isNull()
-                && (model.getSmartChargingService())) {
-            auto scService = model.getSmartChargingService();
-
-            JsonObject chargingProfile = chargingProfileDoc.as<JsonObject>();
-            scService->setChargingProfile(chargingProfile);
-            *sRmtProfileId = chargingProfile["chargingProfileId"].as<int>();
-            AO_DBG_DEBUG("Charging Profile from RemoteStartTx set");
-            configuration_save();
+        if (success) {
+            payload["status"] = "Accepted";
+        } else {
+            payload["status"] = "Rejected";
         }
-
-        payload["status"] = "Accepted";
     } else {
         AO_DBG_INFO("No connector to start transaction");
         payload["status"] = "Rejected";
@@ -123,7 +131,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createReq() {
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
 
-    payload["idTag"] = "A0-00-00-00";
+    payload["idTag"] = "A0000000";
 
     return doc;
 }
diff --git a/src/ArduinoOcpp/Operations/RemoteStartTransaction.h b/src/ArduinoOcpp/Operations/RemoteStartTransaction.h
index a58e5d94..4911efb9 100644
--- a/src/ArduinoOcpp/Operations/RemoteStartTransaction.h
+++ b/src/ArduinoOcpp/Operations/RemoteStartTransaction.h
@@ -11,6 +11,7 @@
 namespace ArduinoOcpp {
 
 class Model;
+class ChargingProfile;
 
 namespace Ocpp16 {
 
@@ -19,9 +20,11 @@ class RemoteStartTransaction : public Operation {
     Model& model;
     int connectorId;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
-    DynamicJsonDocument chargingProfileDoc {0};
+
+    std::unique_ptr<ChargingProfile> chargingProfile;
     
     const char *errorCode {nullptr};
+    const char *errorDescription = "";
 public:
     RemoteStartTransaction(Model& model);
 
@@ -36,6 +39,7 @@ class RemoteStartTransaction : public Operation {
     std::unique_ptr<DynamicJsonDocument> createConf();
 
     const char *getErrorCode() {return errorCode;}
+    const char *getErrorDescription() override {return errorDescription;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/ArduinoOcpp/Operations/SetChargingProfile.cpp b/src/ArduinoOcpp/Operations/SetChargingProfile.cpp
index 465c2463..a137d9d6 100644
--- a/src/ArduinoOcpp/Operations/SetChargingProfile.cpp
+++ b/src/ArduinoOcpp/Operations/SetChargingProfile.cpp
@@ -5,18 +5,15 @@
 #include <ArduinoOcpp/Operations/SetChargingProfile.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::SetChargingProfile;
 
-SetChargingProfile::SetChargingProfile(Model& model) : model(model) {
+SetChargingProfile::SetChargingProfile(Model& model, SmartChargingService& scService) : model(model), scService(scService) {
 
 }
 
-SetChargingProfile::SetChargingProfile(Model& model, std::unique_ptr<DynamicJsonDocument> payloadToClient)
-        : model(model), payloadToClient{std::move(payloadToClient)} {
-}
-
 SetChargingProfile::~SetChargingProfile() {
 
 }
@@ -27,33 +24,64 @@ const char* SetChargingProfile::getOperationType(){
 
 void SetChargingProfile::processReq(JsonObject payload) {
 
-    //int connectorID = payload["connectorId"];
+    int connectorId = payload["connectorId"] | -1;
+    if (connectorId < 0 || !payload.containsKey("csChargingProfiles")) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    if ((unsigned int) connectorId >= model.getNumConnectors()) {
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
 
     JsonObject csChargingProfiles = payload["csChargingProfiles"];
 
-    if (auto scService = model.getSmartChargingService()) {
-        scService->setChargingProfile(csChargingProfiles);
+    auto chargingProfile = loadChargingProfile(csChargingProfiles);
+    if (!chargingProfile) {
+        errorCode = "PropertyConstraintViolation";
+        errorDescription = "csChargingProfiles validation failed";
+        return;
     }
-}
 
-std::unique_ptr<DynamicJsonDocument> SetChargingProfile::createConf(){ //TODO review
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
-    JsonObject payload = doc->to<JsonObject>();
-    payload["status"] = "Accepted";
-    return doc;
-}
+    if (chargingProfile->getChargingProfilePurpose() == ChargingProfilePurposeType::TxProfile) {
+        // if TxProfile, check if a transaction is running
 
-std::unique_ptr<DynamicJsonDocument> SetChargingProfile::createReq() {
-    if (payloadToClient != nullptr) {
-        auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(*payloadToClient));
-        return result;
+        if (connectorId == 0) {
+            errorCode = "PropertyConstraintViolation";
+            errorDescription = "Cannot set TxProfile at connectorId 0";
+            return;
+        }
+        Connector *connector = model.getConnector(connectorId);
+        if (!connector) {
+            errorCode = "PropertyConstraintViolation";
+            return;
+        }
+        if (!connector->getTransaction() || !connector->getTransaction()->isRunning()) {
+            //no transaction running, reject profile
+            accepted = false;
+            return;
+        }
+
+        //seems good
+    } else if (chargingProfile->getChargingProfilePurpose() == ChargingProfilePurposeType::ChargePointMaxProfile) {
+        if (connectorId > 0) {
+            errorCode = "PropertyConstraintViolation";
+            errorDescription = "Cannot set ChargePointMaxProfile at connectorId > 0";
+            return;
+        }
     }
-    return nullptr;
+
+    accepted = scService.setChargingProfile(connectorId, std::move(chargingProfile));
 }
 
-void SetChargingProfile::processConf(JsonObject payload) {
-    const char* status = payload["status"] | "Invalid";
-    if (strcmp(status, "Accepted")) {
-        AO_DBG_WARN("Send profile: rejected by client");
+std::unique_ptr<DynamicJsonDocument> SetChargingProfile::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+    if (accepted) {
+        payload["status"] = "Accepted";
+    } else {
+        payload["status"] = "Rejected";
     }
+    return doc;
 }
diff --git a/src/ArduinoOcpp/Operations/SetChargingProfile.h b/src/ArduinoOcpp/Operations/SetChargingProfile.h
index 91c30ab0..99bed3a0 100644
--- a/src/ArduinoOcpp/Operations/SetChargingProfile.h
+++ b/src/ArduinoOcpp/Operations/SetChargingProfile.h
@@ -10,17 +10,20 @@
 namespace ArduinoOcpp {
 
 class Model;
+class SmartChargingService;
 
 namespace Ocpp16 {
 
 class SetChargingProfile : public Operation {
 private:
     Model& model;
-    std::unique_ptr<DynamicJsonDocument> payloadToClient;
-public:
-    SetChargingProfile(Model& model);
+    SmartChargingService& scService;
 
-    SetChargingProfile(Model& model, std::unique_ptr<DynamicJsonDocument> payloadToClient);
+    bool accepted = false;
+    const char *errorCode = nullptr;
+    const char *errorDescription = "";
+public:
+    SetChargingProfile(Model& model, SmartChargingService& scService);
 
     ~SetChargingProfile();
 
@@ -30,9 +33,8 @@ class SetChargingProfile : public Operation {
 
     std::unique_ptr<DynamicJsonDocument> createConf();
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
-
-    void processConf(JsonObject payload);
+    const char *getErrorCode() override {return errorCode;}
+    const char *getErrorDescription() override {return errorDescription;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index cc8dba74..c958a0c5 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -183,10 +183,10 @@ void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat_m powerInput)
 }
 
 void ao_setSmartChargingOutput(OutputFloat chargingLimitOutput) {
-    setSmartChargingOutput(adaptFn(chargingLimitOutput));
+    setSmartChargingPowerOutput(adaptFn(chargingLimitOutput));
 }
 void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputFloat_m chargingLimitOutput) {
-    setSmartChargingOutput(adaptFn(connectorId, chargingLimitOutput), connectorId);
+    setSmartChargingPowerOutput(adaptFn(connectorId, chargingLimitOutput), connectorId);
 }
 
 void ao_setEvReadyInput(InputBool evReadyInput) {
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index c9d04f1d..9e8fc6b2 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -173,4 +173,4 @@ TEST_CASE( "Charging sessions" ) {
 
     OCPP_deinitialize();
 
-}
\ No newline at end of file
+}
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
new file mode 100644
index 00000000..b2de40df
--- /dev/null
+++ b/tests/SmartCharging.cpp
@@ -0,0 +1,572 @@
+#include <ArduinoOcpp.h>
+#include <ArduinoOcpp/Core/Connection.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Operations/CustomOperation.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
+#define SCPROFILE_0                            "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\",\"validFrom\":\"2022-06-12T00:00:00.000Z\",\"validTo\":\"2023-06-21T00:00:00.000Z\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-06-18T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":18000,\"limit\":32,\"numberPhases\":3}],\"minChargingRate\":6}}}]";
+#define SCPROFILE_0_ALT_SAME_ID                "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":1,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\",\"validFrom\":\"2022-06-12T00:00:00.000Z\",\"validTo\":\"2023-06-21T00:00:00.000Z\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-06-18T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":18000,\"limit\":32,\"numberPhases\":3}],\"minChargingRate\":6}}}]";
+#define SCPROFILE_0_ALT_SAME_STACKEVEL_PURPOSE "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":1,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\",\"validFrom\":\"2022-06-12T00:00:00.000Z\",\"validTo\":\"2023-06-21T00:00:00.000Z\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-06-18T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":18000,\"limit\":32,\"numberPhases\":3}],\"minChargingRate\":6}}}]";
+
+#define SCPROFILE_1_ABSOLUTE_LIMIT_16A         "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":1,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]";
+
+#define SCPROFILE_2_RELATIVE_TXDEF_24A         "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":2,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Relative\",\"chargingSchedule\":{\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":24,\"numberPhases\":3}]}}}]";
+
+#define SCPROFILE_3_TXPROF_TXID123_20A         "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":3,\"transactionId\":123,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxProfile\",\"chargingProfileKind\":\"Relative\",\"chargingSchedule\":{\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":20,\"numberPhases\":3}]}}}]";
+
+#define SCPROFILE_4_VALID_FROM_2024_16A        "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":4,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"validFrom\":\"2024-01-01T00:00:00.000Z\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]";
+#define SCPROFILE_5_VALID_UNTIL_2022_16A       "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":5,\"stackLevel\":1,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"validTo\":  \"2022-01-01T00:00:00.000Z\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]";
+
+#define SCPROFILE_6_MULTIPLE_PERIODS_16A_20A   "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":6,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":3600,\"limit\":20,\"numberPhases\":3}]}}}]";
+
+#define SCPROFILE_7_RECURRING_DAY_2H_16A_20A   "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":7,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\", \"chargingSchedule\":{\"duration\":7200,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":3600,\"limit\":20,\"numberPhases\":3}]}}}]";
+#define SCPROFILE_8_RECURRING_WEEK_2H_10A_12A  "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":8,\"stackLevel\":1,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Weekly\",\"chargingSchedule\":{\"duration\":7200,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":10,\"numberPhases\":3},{\"startPeriod\":3600,\"limit\":12,\"numberPhases\":3}]}}}]";
+
+#define SCPROFILE_9_VIA_RMTSTARTTX_20A         "[2,\"testmsg\",\"RemoteStartTransaction\",{\"connectorId\":1,\"idTag\":\"mIdTag\",\"chargingProfile\":{\"chargingProfileId\":9,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxProfile\",\"chargingProfileKind\":\"Relative\",\"chargingSchedule\":{\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":20,\"numberPhases\":1}]}}}]";
+
+#define SCPROFILE_10_ABSOLUTE_LIMIT_5KW        "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":10,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":5000,\"numberPhases\":3}]}}}]";
+
+
+using namespace ArduinoOcpp;
+
+
+TEST_CASE( "SmartCharging" ) {
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+    auto context = getOcppContext();
+    auto& model = context->getModel();
+
+    ao_set_timer(custom_timer_cb);
+
+    model.getClock().setTime(BASE_TIME);
+
+    endTransaction();
+
+    SECTION("Load Smart Charging Service"){
+
+        REQUIRE(!model.getSmartChargingService());
+
+        setSmartChargingOutput([] (float, float, int) {});
+
+        REQUIRE(model.getSmartChargingService());
+    }
+
+    setSmartChargingOutput([] (float, float, int) {});
+    auto scService = model.getSmartChargingService();
+
+    scService->clearChargingProfile([] (int, int, ChargingProfilePurposeType, int) {
+        return true;
+    });
+
+    SECTION("Set Charging Profile and clear") {
+
+        unsigned int count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return true;
+        });
+
+        REQUIRE(count == 0);
+
+        std::string out = SCPROFILE_0;
+        loopback.sendTXT(out);
+
+        //check if filter works by comparing the outcome of returning false and true and repeating the test
+        count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return false;
+        });
+
+        REQUIRE(count == 1);
+
+        count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return true;
+        });
+
+        REQUIRE(count == 1);
+
+        count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return true;
+        });
+
+        REQUIRE(count == 0);
+    }
+
+    SECTION("Charging Profiles persistency over reboots") {
+
+        std::string out = SCPROFILE_0;
+        loopback.sendTXT(out);
+
+        OCPP_deinitialize();
+
+        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        setSmartChargingOutput([] (float, float, int) {});
+        scService = model.getSmartChargingService();
+
+        unsigned int count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return true;
+        });
+
+        REQUIRE (count == 1);
+    }
+
+    SECTION("Set conflicting profile") {
+
+        std::string out = SCPROFILE_0;
+        loopback.sendTXT(out);
+
+        out = SCPROFILE_0_ALT_SAME_ID;
+        loopback.sendTXT(out);
+
+        unsigned int count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return true;
+        });
+
+        REQUIRE(count == 1);
+
+        out = SCPROFILE_0;
+        loopback.sendTXT(out);
+
+        out = SCPROFILE_0_ALT_SAME_STACKEVEL_PURPOSE;
+        loopback.sendTXT(out);
+
+        count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return true;
+        });
+
+        REQUIRE(count == 1);
+    }
+
+    SECTION("Set charging profile via RmtStartTx") {
+        
+        float current = -1.f;
+        setSmartChargingOutput([&current] (float, float limit_current, int) {
+            current = limit_current;
+        });
+
+        loop();
+
+        std::string out = SCPROFILE_9_VIA_RMTSTARTTX_20A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE((current > 19.99f && current < 20.01f));
+
+        endTransaction();
+
+        loop();
+    }
+
+    SECTION("Set ChargePointMaxProfile - Absolute") {
+        
+        float current = -1.f;
+        setSmartChargingOutput([&current] (float, float limit_current, int) {
+            current = limit_current;
+        });
+
+        std::string out = SCPROFILE_1_ABSOLUTE_LIMIT_16A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE((current > 15.99f && current < 16.01f));
+    }
+
+    SECTION("Set TxDefaultProfile - Relative") {
+
+        float current = -1.f;
+        setSmartChargingOutput([&current] (float, float limit_current, int) {
+            current = limit_current;
+        });
+        
+        std::string out = SCPROFILE_2_RELATIVE_TXDEF_24A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE(current < 0.f);
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        REQUIRE((current > 23.99f && current < 24.01f));
+
+        endTransaction();
+
+        loop();
+
+        REQUIRE(current < 0.f);
+    }
+
+    SECTION("Set TxProfile - tx fit and mismatch") {
+
+        float current = -1.f;
+        setSmartChargingOutput([&current] (float, float limit_current, int) {
+            current = limit_current;
+        });
+        
+        //send before transaction - expect rejection
+        std::string out = SCPROFILE_3_TXPROF_TXID123_20A;
+        loopback.sendTXT(out);
+
+        unsigned int count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return true;
+        });
+
+        REQUIRE(count == 0);
+
+        loop();
+        beginTransaction_authorized("mIdTag");
+
+        //send during transaction but wrong txId - expect rejection
+        out = SCPROFILE_3_TXPROF_TXID123_20A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return true;
+        });
+
+        REQUIRE(count == 0);
+
+        getTransaction()->setTransactionId(123);
+
+        //send during tx with matchin txId - accept
+        out = SCPROFILE_3_TXPROF_TXID123_20A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE((current > 19.99f && current < 20.01f));
+
+        endTransaction();
+
+        loop();
+
+        //check if SCService deleted TxProfiles after tx
+        count = 0;
+        scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
+            count++;
+            return true;
+        });
+
+        REQUIRE(count == 0);
+    }
+
+    SECTION("Time validity check") {
+
+        float current = -1.f;
+        setSmartChargingOutput([&current] (float, float limit_current, int) {
+            current = limit_current;
+        });
+        
+        std::string out = SCPROFILE_4_VALID_FROM_2024_16A;
+        loopback.sendTXT(out);
+
+        out = SCPROFILE_5_VALID_UNTIL_2022_16A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE(current < 0.f);
+
+        //now reach validity period of future profile
+        model.getClock().setTime("2024-01-01T00:00:00.000Z");
+
+        loop();
+
+        REQUIRE((current > 15.99f && current < 16.01f));
+    }
+
+    SECTION("Multiple periods") {
+        
+        float current = -1.f;
+        setSmartChargingOutput([&current] (float, float limit_current, int) {
+            current = limit_current;
+        });
+
+        std::string out = SCPROFILE_6_MULTIPLE_PERIODS_16A_20A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE((current > 15.99f && current < 16.01f));
+
+        //now reach next period
+        model.getClock().setTime("2023-01-01T01:00:00.000Z");
+
+        loop();
+
+        REQUIRE((current > 19.99f && current < 20.01f));
+    }
+
+    SECTION("Recurring profiles - Daily") {
+        
+        float current = -1.f;
+        setSmartChargingOutput([&current] (float, float limit_current, int) {
+            current = limit_current;
+        });
+
+        std::string out = SCPROFILE_7_RECURRING_DAY_2H_16A_20A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE((current > 15.99f && current < 16.01f));
+
+        //now exceed duration
+        model.getClock().setTime("2023-01-01T02:00:00.000Z");
+
+        loop();
+
+        REQUIRE(current < 0.f);
+
+        //check second period three days afterwards
+        model.getClock().setTime("2023-01-04T01:00:00.000Z");
+
+        loop();
+
+        REQUIRE((current > 19.99f && current < 20.01f));
+    }
+
+    SECTION("Recurring profiles - Weekly") {
+        
+        float current = -1.f;
+        setSmartChargingOutput([&current] (float, float limit_current, int) {
+            current = limit_current;
+        });
+
+        std::string out = SCPROFILE_8_RECURRING_WEEK_2H_10A_12A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE((current > 9.99f && current < 10.01f));
+
+        //now exceed duration
+        model.getClock().setTime("2023-01-01T02:00:00.000Z");
+
+        loop();
+
+        REQUIRE(current < 0.f);
+
+        //check second period three weeks afterwards
+        model.getClock().setTime("2023-01-22T01:00:00.000Z");
+
+        loop();
+
+        REQUIRE((current > 11.99f && current < 12.01f));
+    }
+
+    SECTION("Stacking recurring profiles") {
+
+        float current = -1.f;
+        setSmartChargingOutput([&current] (float, float limit_current, int) {
+            current = limit_current;
+        });
+
+        std::string out = SCPROFILE_7_RECURRING_DAY_2H_16A_20A; //stackLevel: 0
+        loopback.sendTXT(out);
+
+        out = SCPROFILE_8_RECURRING_WEEK_2H_10A_12A; //stackLevel: 1
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE((current > 9.99f && current < 10.01f)); //Weekly schedule prevails
+
+        //check again during the week
+        model.getClock().setTime("2023-01-03T00:00:00.000Z");
+
+        loop();
+
+        REQUIRE((current > 15.99f && current < 16.01f)); //Weekly schedule out of duration, only Daily defined
+
+        //check again three weeks later
+        model.getClock().setTime("2023-01-22T00:00:00.000Z");
+
+        loop();
+
+        REQUIRE((current > 9.99f && current < 10.01f)); //Weekly schedule prevails again
+
+        //check again during the week
+        model.getClock().setTime("2023-01-23T00:00:00.000Z");
+
+        loop();
+
+        REQUIRE((current > 15.99f && current < 16.01f)); //Weekly schedule out of duration again, only Daily defined again
+    }
+
+    SECTION("TxProfile capped by ChargePointMaxProfile") {
+
+        float current = -1.f;
+        int numberPhases = -1;
+        setSmartChargingOutput([&current, &numberPhases] (float, float limit_current, int limit_numberPhases) {
+            current = limit_current;
+            numberPhases = limit_numberPhases;
+        });
+
+        loop();
+
+        std::string out = SCPROFILE_9_VIA_RMTSTARTTX_20A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        out = SCPROFILE_1_ABSOLUTE_LIMIT_16A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE((current > 15.99f && current < 16.01f)); //current limited by ChargePointMaxProfile
+        REQUIRE(numberPhases == 1); //numberPhases limited by TxProfile
+
+        endTransaction();
+
+        loop();
+    }
+
+    SECTION("TxProfile and ChargePointMaxProfile with mixed units") {
+
+        float power = -1.f;
+        float current = -1.f;
+        setSmartChargingOutput([&power, &current] (float limit_power, float limit_current, int) {
+            power = limit_power;
+            current = limit_current;
+        });
+
+        loop();
+
+        std::string out = SCPROFILE_9_VIA_RMTSTARTTX_20A;
+        loopback.sendTXT(out);
+
+        loop();
+
+        out = SCPROFILE_10_ABSOLUTE_LIMIT_5KW;
+        loopback.sendTXT(out);
+
+        loop();
+
+        REQUIRE((power > 4999.f && power < 5001.f)); //ChargePointMaxProfile defines power
+        REQUIRE((current > 19.99f && current < 20.01f)); //TxProfile defines current
+
+        endTransaction();
+
+        loop();
+    }
+
+    SECTION("Get composite schedule") {
+
+        std::string out = SCPROFILE_6_MULTIPLE_PERIODS_16A_20A;
+        loopback.sendTXT(out);
+
+        bool checkProcessed = false;
+
+        auto getCompositeSchedule = makeRequest(new Ocpp16::CustomOperation(
+                "GetCompositeSchedule",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(3)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = 1;
+                    payload["duration"] = 86400;
+                    payload["chargingRateUnit"] = "A";
+                    return doc;},
+                [&checkProcessed, &model] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE(payload["status"] == "Accepted");
+                    REQUIRE(payload["connectorId"] == 1);
+                    
+                    char checkScheduleStart [JSONDATE_LENGTH + 1];
+                    model.getClock().now().toJsonString(checkScheduleStart, JSONDATE_LENGTH + 1);
+                    REQUIRE(!strcmp(payload["scheduleStart"], checkScheduleStart));
+
+                    JsonObject chargingScheduleJson = payload["chargingSchedule"];
+                    ChargingSchedule schedule;
+                    bool success = loadChargingSchedule(chargingScheduleJson, schedule);
+
+                    REQUIRE(success);
+                    REQUIRE(schedule.chargingSchedulePeriod.size() == 2);
+
+                    REQUIRE((schedule.chargingSchedulePeriod[0].limit > 15.99f &&
+                            schedule.chargingSchedulePeriod[0].limit < 16.01f));
+                    REQUIRE(schedule.chargingSchedulePeriod[0].startPeriod == 0);
+
+                    REQUIRE((schedule.chargingSchedulePeriod[1].limit > 19.99f &&
+                            schedule.chargingSchedulePeriod[1].limit < 20.01f));
+                    REQUIRE(schedule.chargingSchedulePeriod[1].startPeriod == 3600);
+                }
+        ));
+
+        context->initiateRequest(std::move(getCompositeSchedule));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+    }
+
+    SECTION("Get composite schedule with definition gap") {
+
+        std::string out = SCPROFILE_7_RECURRING_DAY_2H_16A_20A;
+        loopback.sendTXT(out);
+
+        auto schedule = scService->getCompositeSchedule(1, 86401);
+
+        REQUIRE(schedule != nullptr);
+        REQUIRE(schedule->duration == 86401);
+        REQUIRE(schedule->chargingSchedulePeriod.size() == 4);
+        
+        REQUIRE((schedule->chargingSchedulePeriod[0].limit > 15.99f &&
+                schedule->chargingSchedulePeriod[0].limit < 16.01f));
+        REQUIRE(schedule->chargingSchedulePeriod[0].startPeriod == 0);
+
+        REQUIRE((schedule->chargingSchedulePeriod[1].limit > 19.99f &&
+                schedule->chargingSchedulePeriod[1].limit < 20.01f));
+        REQUIRE(schedule->chargingSchedulePeriod[1].startPeriod == 3600);
+
+        REQUIRE(schedule->chargingSchedulePeriod[2].limit < 0.f); //undefined during this period
+        REQUIRE(schedule->chargingSchedulePeriod[2].startPeriod == 2 * 3600);
+
+        REQUIRE((schedule->chargingSchedulePeriod[3].limit > 15.99f &&
+                schedule->chargingSchedulePeriod[3].limit < 16.01f));
+        REQUIRE(schedule->chargingSchedulePeriod[3].startPeriod == 86400);
+    }
+
+    scService->clearChargingProfile([] (int, int, ChargingProfilePurposeType, int) {
+        return true;
+    });
+
+    OCPP_deinitialize();
+
+}

From 9326a5d2da2b673e6a75487c34189a146329d4e4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 20 Jun 2023 19:26:41 +0200
Subject: [PATCH 281/549] clean up code

---
 .../SmartCharging/SmartChargingModel.cpp      | 116 +--
 .../SmartCharging/SmartChargingService.cpp    | 878 +++++++++---------
 .../SmartCharging/SmartChargingService.h      |  15 +-
 3 files changed, 506 insertions(+), 503 deletions(-)

diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
index ff22482f..af1fe1a3 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -186,7 +186,7 @@ bool ChargingProfile::calculateLimit(const Timestamp &t, const Timestamp &startO
 }
 
 bool ChargingProfile::calculateLimit(const Timestamp &t, ChargeRate& limit, Timestamp& nextChange){
-    return calculateLimit(t, MAX_TIME, limit, nextChange);
+    return calculateLimit(t, MIN_TIME, limit, nextChange);
 }
 
 int ChargingProfile::getChargingProfileId() {
@@ -350,63 +350,6 @@ bool loadChargingSchedulePeriod(JsonObject& json, ChargingSchedulePeriod& out) {
 
 } //end namespace ArduinoOcpp
 
-bool ArduinoOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
-    if (json.containsKey("duration")) {
-        int duration = json["duration"] | -1;
-        if (duration >= 0) {
-            out.duration = duration;
-        } else {
-            AO_DBG_WARN("format violation");
-            return false;
-        }
-    }
-
-    if (json.containsKey("startSchedule")) {
-        if (!out.startSchedule.setTime(json["startSchedule"] | "Invalid")) {
-            //non-success
-            AO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
-            return false;
-        }
-    } else {
-        out.startSchedule = MIN_TIME;
-    }
-
-    const char *unit = json["chargingRateUnit"] | "_Undefined";
-    if (unit[0] == 'a' || unit[0] == 'A') {
-        out.chargingRateUnit = ChargingRateUnitType::Amp;
-    } else if (unit[0] == 'w' || unit[0] == 'W') {
-        out.chargingRateUnit = ChargingRateUnitType::Watt;
-    } else {
-        AO_DBG_WARN("format violation");
-        return false;
-    }
-    
-    JsonArray periodJsonArray = json["chargingSchedulePeriod"];
-    if (periodJsonArray.size() < 1) {
-        AO_DBG_WARN("format violation");
-        return false;
-    }
-
-    for (JsonObject periodJson : periodJsonArray) {
-        out.chargingSchedulePeriod.push_back(ChargingSchedulePeriod());
-        if (!loadChargingSchedulePeriod(periodJson, out.chargingSchedulePeriod.back())) {
-            return false;
-        }
-    }
-    
-    if (json.containsKey("minChargingRate")) {
-        float minChargingRate = json["minChargingRate"];
-        if (minChargingRate >= 0.f) {
-            out.minChargingRate = minChargingRate;
-        } else {
-            AO_DBG_WARN("format violation");
-            return false;
-        }
-    }
-
-    return true;
-}
-
 std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& json) {
     auto res = std::unique_ptr<ChargingProfile>(new ChargingProfile());
 
@@ -497,3 +440,60 @@ std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& js
 
     return res;
 }
+
+bool ArduinoOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
+    if (json.containsKey("duration")) {
+        int duration = json["duration"] | -1;
+        if (duration >= 0) {
+            out.duration = duration;
+        } else {
+            AO_DBG_WARN("format violation");
+            return false;
+        }
+    }
+
+    if (json.containsKey("startSchedule")) {
+        if (!out.startSchedule.setTime(json["startSchedule"] | "Invalid")) {
+            //non-success
+            AO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            return false;
+        }
+    } else {
+        out.startSchedule = MIN_TIME;
+    }
+
+    const char *unit = json["chargingRateUnit"] | "_Undefined";
+    if (unit[0] == 'a' || unit[0] == 'A') {
+        out.chargingRateUnit = ChargingRateUnitType::Amp;
+    } else if (unit[0] == 'w' || unit[0] == 'W') {
+        out.chargingRateUnit = ChargingRateUnitType::Watt;
+    } else {
+        AO_DBG_WARN("format violation");
+        return false;
+    }
+    
+    JsonArray periodJsonArray = json["chargingSchedulePeriod"];
+    if (periodJsonArray.size() < 1) {
+        AO_DBG_WARN("format violation");
+        return false;
+    }
+
+    for (JsonObject periodJson : periodJsonArray) {
+        out.chargingSchedulePeriod.push_back(ChargingSchedulePeriod());
+        if (!loadChargingSchedulePeriod(periodJson, out.chargingSchedulePeriod.back())) {
+            return false;
+        }
+    }
+    
+    if (json.containsKey("minChargingRate")) {
+        float minChargingRate = json["minChargingRate"];
+        if (minChargingRate >= 0.f) {
+            out.minChargingRate = minChargingRate;
+        } else {
+            AO_DBG_WARN("format violation");
+            return false;
+        }
+    }
+
+    return true;
+}
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
index 6d8ddb70..eff8fb5b 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -24,198 +24,6 @@ SmartChargingConnector::~SmartChargingConnector() {
 
 }
 
-void SmartChargingConnector::loop(){
-
-    trackTransaction();
-
-    /**
-     * check if to call onLimitChange
-     */
-    auto& tnow = model.getClock().now();
-
-    if (tnow >= nextChange){
-
-        ChargeRate limit;
-        nextChange = MAX_TIME; //reset nextChange to default value and refresh it
-
-        calculateLimit(tnow, limit, nextChange);
-
-        if (trackLimitOutput != limit) {
-            if (limitOutput) {
-
-                limitOutput(
-                    limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
-                    limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
-                    limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
-                trackLimitOutput = limit;
-            }
-        }
-    }
-}
-
-void SmartChargingConnector::setSmartChargingOutput(std::function<void(float,float,int)> limitOutput) {
-    if (this->limitOutput) {
-        AO_DBG_WARN("replacing existing SmartChargingOutput");
-        (void)0;
-    }
-    this->limitOutput = limitOutput;
-}
-
-SmartChargingService::SmartChargingService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int numConnectors)
-      : context(context), filesystem{filesystem}, numConnectors(numConnectors) {
-    
-    for (unsigned int cId = 1; cId < numConnectors; cId++) {
-        connectors.push_back(std::move(SmartChargingConnector(context.getModel(), filesystem, cId, ChargePointMaxProfile, ChargePointTxDefaultProfile)));
-    }
-
-    declareConfiguration<int>("ChargeProfileMaxStackLevel", CHARGEPROFILEMAXSTACKLEVEL, CONFIGURATION_VOLATILE, false, true, false, false);
-    declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE, false);
-    declareConfiguration<int>("ChargingScheduleMaxPeriods", CHARGINGSCHEDULEMAXPERIODS, CONFIGURATION_VOLATILE, false, true, false, false);
-    declareConfiguration<int>("MaxChargingProfilesInstalled", MAXCHARGINGPROFILESINSTALLED, CONFIGURATION_VOLATILE, false, true, false, false);
-
-    const char *fpId = "SmartCharging";
-    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
-    if (!strstr(*fProfile, fpId)) {
-        auto fProfilePlus = std::string(*fProfile);
-        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
-            fProfilePlus += ",";
-        fProfilePlus += fpId;
-        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
-    }
-
-    context.getOperationRegistry().registerOperation("ClearChargingProfile", [this] () {
-        return new Ocpp16::ClearChargingProfile(*this);});
-    context.getOperationRegistry().registerOperation("GetCompositeSchedule", [&context, this] () {
-        return new Ocpp16::GetCompositeSchedule(context.getModel(), *this);});
-    context.getOperationRegistry().registerOperation("SetChargingProfile", [&context, this] () {
-        return new Ocpp16::SetChargingProfile(context.getModel(), *this);});
-
-    loadProfiles();
-}
-
-SmartChargingService::~SmartChargingService() {
-
-}
-
-void SmartChargingService::updateAllowedChargingRateUnit(bool powerSupported, bool currentSupported) {
-    if ((powerSupported != this->powerSupported) || (currentSupported != this->currentSupported)) {
-
-        auto chargingScheduleAllowedChargingRateUnit = declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE, false);
-        if (chargingScheduleAllowedChargingRateUnit) {
-            if (powerSupported && currentSupported) {
-                *chargingScheduleAllowedChargingRateUnit = "Current,Power";
-            } else if (powerSupported) {
-                *chargingScheduleAllowedChargingRateUnit = "Power";
-            } else if (currentSupported) {
-                *chargingScheduleAllowedChargingRateUnit = "Current";
-            }
-        }
-
-        this->powerSupported = powerSupported;
-        this->currentSupported = currentSupported;
-    }
-}
-
-void SmartChargingService::setSmartChargingOutput(unsigned int connectorId, std::function<void(float,float,int)> limitOutput) {
-    if ((connectorId > 0 && !getScConnectorById(connectorId))) {
-        AO_DBG_ERR("invalid args");
-        return;
-    }
-
-    if (connectorId == 0) {
-        if (this->limitOutput) {
-            AO_DBG_WARN("replacing existing SmartChargingOutput");
-            (void)0;
-        }
-        this->limitOutput = limitOutput;
-    } else {
-        getScConnectorById(connectorId)->setSmartChargingOutput(limitOutput);
-    }
-}
-
-void SmartChargingService::loop(){
-
-    for (size_t i = 0; i < connectors.size(); i++) {
-        connectors[i].loop();
-    }
-
-    /**
-     * check if to call onLimitChange
-     */
-    auto& tnow = context.getModel().getClock().now();
-
-    if (tnow >= nextChange){
-        
-        ChargeRate limit;
-        nextChange = MAX_TIME; //reset nextChange to default value and refresh it
-
-        calculateLimit(tnow, limit, nextChange);
-
-#if (AO_DBG_LEVEL >= AO_DL_INFO)
-        char timestamp1[JSONDATE_LENGTH + 1] = {'\0'};
-        tnow.toJsonString(timestamp1, JSONDATE_LENGTH + 1);
-        char timestamp2[JSONDATE_LENGTH + 1] = {'\0'};
-        nextChange.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
-        AO_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = {%f,%f,%i}",
-                            timestamp1, timestamp2, limit.power, limit.current, limit.nphases);
-#endif
-
-        if (trackLimitOutput != limit) {
-            if (limitOutput) {
-
-                limitOutput(
-                    limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
-                    limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
-                    limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
-                trackLimitOutput = limit;
-            }
-        }
-    }
-}
-
-void SmartChargingConnector::trackTransaction() {
-
-    Transaction *tx = nullptr;
-    if (model.getConnector(connectorId)) {
-        tx = model.getConnector(connectorId)->getTransaction().get();
-    }
-
-    bool update = false;
-
-    if (tx) {
-        if (tx->getTxProfileId() != trackTxRmtProfileId) {
-            update = true;
-            trackTxRmtProfileId = tx->getTxProfileId();
-        }
-        if (tx->getStartSync().isRequested() && tx->getStartTimestamp() != trackTxStart) {
-            update = true;
-            trackTxStart = tx->getStartTimestamp();
-        }
-        if (tx->getStartSync().isConfirmed() && tx->getTransactionId() != trackTxId) {
-            update = true;
-            trackTxId = tx->getTransactionId();
-        }
-    } else {
-        //check if transaction has just been completed
-        if (trackTxRmtProfileId >= 0 || trackTxStart < MAX_TIME || trackTxId >= 0) {
-            //yes, clear data
-            update = true;
-            trackTxRmtProfileId = -1;
-            trackTxStart = MAX_TIME;
-            trackTxId = -1;
-
-            clearChargingProfile([this] (int, int connectorId, ChargingProfilePurposeType purpose, int) {
-                return purpose == ChargingProfilePurposeType::TxProfile &&
-                       (int) this->connectorId == connectorId;
-            });
-        }
-    }
-
-    if (update) {
-        nextChange = model.getClock().now(); //will refresh limit calculation
-    }
-}
-
 /*
  * limitOut: the calculated maximum charge rate at the moment, or the default value if no limit is defined
  * validToOut: The begin of the next SmartCharging restriction after time t
@@ -280,7 +88,7 @@ void SmartChargingConnector::calculateLimit(const Timestamp &t, ChargeRate& limi
     for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
         if (ChargePointMaxProfile[i]) {
             ChargeRate crOut;
-            bool defined = ChargePointMaxProfile[i]->calculateLimit(t, MAX_TIME, crOut, validToOut);
+            bool defined = ChargePointMaxProfile[i]->calculateLimit(t, trackTxStart, crOut, validToOut);
             if (defined) {
                 cpLimit = crOut;
                 break;
@@ -292,45 +100,145 @@ void SmartChargingConnector::calculateLimit(const Timestamp &t, ChargeRate& limi
     limitOut = chargeRate_min(txLimit, cpLimit);
 }
 
-/*
- * limitOut: the calculated maximum charge rate at the moment, or the default value if no limit is defined
- * validToOut: The begin of the next SmartCharging restriction after time t
- */
-void SmartChargingService::calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut){
-    
-    //initialize output parameters with the default values
-    limitOut = ChargeRate();
-    validToOut = MAX_TIME;
+void SmartChargingConnector::trackTransaction() {
 
-    //get ChargePointMaxProfile with the highest stackLevel
-    for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
-        if (ChargePointMaxProfile[i]) {
-            ChargeRate crOut;
-            bool defined = ChargePointMaxProfile[i]->calculateLimit(t, MAX_TIME, crOut, validToOut);
-            if (defined) {
-                limitOut = crOut;
-                break;
-            }
-        }
+    Transaction *tx = nullptr;
+    if (model.getConnector(connectorId)) {
+        tx = model.getConnector(connectorId)->getTransaction().get();
     }
-}
-
-std::unique_ptr<ChargingSchedule> SmartChargingConnector::getCompositeSchedule(int duration, ChargingRateUnitType_Optional unit) {
-    
-    auto& startSchedule = model.getClock().now();
 
-    auto schedule = std::unique_ptr<ChargingSchedule>(new ChargingSchedule());
-    schedule->duration = duration;
-    schedule->startSchedule = startSchedule;
-    schedule->chargingProfileKind = ChargingProfileKindType::Absolute;
-    schedule->recurrencyKind = RecurrencyKindType::NOT_SET;
+    bool update = false;
 
-    auto& periods = schedule->chargingSchedulePeriod;
+    if (tx) {
+        if (tx->getTxProfileId() != trackTxRmtProfileId) {
+            update = true;
+            trackTxRmtProfileId = tx->getTxProfileId();
+        }
+        if (tx->getStartSync().isRequested() && tx->getStartTimestamp() != trackTxStart) {
+            update = true;
+            trackTxStart = tx->getStartTimestamp();
+        }
+        if (tx->getStartSync().isConfirmed() && tx->getTransactionId() != trackTxId) {
+            update = true;
+            trackTxId = tx->getTransactionId();
+        }
+    } else {
+        //check if transaction has just been completed
+        if (trackTxRmtProfileId >= 0 || trackTxStart < MAX_TIME || trackTxId >= 0) {
+            //yes, clear data
+            update = true;
+            trackTxRmtProfileId = -1;
+            trackTxStart = MAX_TIME;
+            trackTxId = -1;
 
-    Timestamp periodBegin = Timestamp(startSchedule);
-    Timestamp periodStop = Timestamp(startSchedule);
+            clearChargingProfile([this] (int, int connectorId, ChargingProfilePurposeType purpose, int) {
+                return purpose == ChargingProfilePurposeType::TxProfile &&
+                       (int) this->connectorId == connectorId;
+            });
+        }
+    }
 
-    while (periodBegin - startSchedule < duration && periods.size() < CHARGINGSCHEDULEMAXPERIODS) {
+    if (update) {
+        nextChange = model.getClock().now(); //will refresh limit calculation
+    }
+}
+
+void SmartChargingConnector::loop(){
+
+    trackTransaction();
+
+    /**
+     * check if to call onLimitChange
+     */
+    auto& tnow = model.getClock().now();
+
+    if (tnow >= nextChange){
+
+        ChargeRate limit;
+        nextChange = MAX_TIME; //reset nextChange to default value and refresh it
+
+        calculateLimit(tnow, limit, nextChange);
+
+        if (trackLimitOutput != limit) {
+            if (limitOutput) {
+
+                limitOutput(
+                    limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
+                    limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
+                    limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
+                trackLimitOutput = limit;
+            }
+        }
+    }
+}
+
+void SmartChargingConnector::setSmartChargingOutput(std::function<void(float,float,int)> limitOutput) {
+    if (this->limitOutput) {
+        AO_DBG_WARN("replacing existing SmartChargingOutput");
+        (void)0;
+    }
+    this->limitOutput = limitOutput;
+}
+
+ChargingProfile *SmartChargingConnector::updateProfiles(std::unique_ptr<ChargingProfile> chargingProfile) {
+    
+    int stackLevel = chargingProfile->getStackLevel(); //already validated
+    
+    switch (chargingProfile->getChargingProfilePurpose()) {
+        case (ChargingProfilePurposeType::ChargePointMaxProfile):
+            break;
+        case (ChargingProfilePurposeType::TxDefaultProfile):
+            TxDefaultProfile[stackLevel] = std::move(chargingProfile);
+            return TxDefaultProfile[stackLevel].get();
+        case (ChargingProfilePurposeType::TxProfile):
+            TxProfile[stackLevel] = std::move(chargingProfile);
+            return TxProfile[stackLevel].get();
+    }
+
+    AO_DBG_ERR("invalid args");
+    return nullptr;
+}
+
+void SmartChargingConnector::notifyProfilesUpdated() {
+    nextChange = model.getClock().now();
+}
+
+bool SmartChargingConnector::clearChargingProfile(const std::function<bool(int, int, ChargingProfilePurposeType, int)> filter) {
+    bool found = false;
+
+    ProfileStack *profileStacks [] = {&TxProfile, &TxDefaultProfile};
+
+    for (auto stack : profileStacks) {
+        for (size_t iLevel = 0; iLevel < stack->size(); iLevel++) {
+            if (auto& profile = stack->at(iLevel)) {
+                if (profile && filter(profile->getChargingProfileId(), connectorId, profile->getChargingProfilePurpose(), iLevel)) {
+                    found = true;
+                    SmartChargingServiceUtils::removeProfile(filesystem, connectorId, profile->getChargingProfilePurpose(), iLevel);
+                    profile.reset();
+                }
+            }
+        }
+    }
+
+    return found;
+}
+
+std::unique_ptr<ChargingSchedule> SmartChargingConnector::getCompositeSchedule(int duration, ChargingRateUnitType_Optional unit) {
+    
+    auto& startSchedule = model.getClock().now();
+
+    auto schedule = std::unique_ptr<ChargingSchedule>(new ChargingSchedule());
+    schedule->duration = duration;
+    schedule->startSchedule = startSchedule;
+    schedule->chargingProfileKind = ChargingProfileKindType::Absolute;
+    schedule->recurrencyKind = RecurrencyKindType::NOT_SET;
+
+    auto& periods = schedule->chargingSchedulePeriod;
+
+    Timestamp periodBegin = Timestamp(startSchedule);
+    Timestamp periodStop = Timestamp(startSchedule);
+
+    while (periodBegin - startSchedule < duration && periods.size() < CHARGINGSCHEDULEMAXPERIODS) {
 
         //calculate limit
         ChargeRate limit;
@@ -376,69 +284,289 @@ size_t SmartChargingConnector::getChargingProfilesCount() {
     return chargingProfilesCount;
 }
 
-std::unique_ptr<ChargingSchedule> SmartChargingService::getCompositeSchedule(unsigned int connectorId, int duration, ChargingRateUnitType_Optional unit) {
+SmartChargingConnector *SmartChargingService::getScConnectorById(unsigned int connectorId) {
+    if (connectorId == 0) {
+        return nullptr;
+    }
 
-    if (connectorId > 0 && !getScConnectorById(connectorId)) {
-        AO_DBG_ERR("invalid args");
+    if (connectorId - 1 >= connectors.size()) {
         return nullptr;
     }
+
+    return &connectors[connectorId-1];
+}
+
+SmartChargingService::SmartChargingService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int numConnectors)
+      : context(context), filesystem{filesystem}, numConnectors(numConnectors) {
     
-    if (unit == ChargingRateUnitType_Optional::None) {
-        if (powerSupported && !currentSupported) {
-            unit = ChargingRateUnitType_Optional::Watt;
-        } else if (!powerSupported && currentSupported) {
-            unit = ChargingRateUnitType_Optional::Amp;
+    for (unsigned int cId = 1; cId < numConnectors; cId++) {
+        connectors.push_back(std::move(SmartChargingConnector(context.getModel(), filesystem, cId, ChargePointMaxProfile, ChargePointTxDefaultProfile)));
+    }
+
+    declareConfiguration<int>("ChargeProfileMaxStackLevel", CHARGEPROFILEMAXSTACKLEVEL, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE, false);
+    declareConfiguration<int>("ChargingScheduleMaxPeriods", CHARGINGSCHEDULEMAXPERIODS, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<int>("MaxChargingProfilesInstalled", MAXCHARGINGPROFILESINSTALLED, CONFIGURATION_VOLATILE, false, true, false, false);
+
+    const char *fpId = "SmartCharging";
+    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
+    if (!strstr(*fProfile, fpId)) {
+        auto fProfilePlus = std::string(*fProfile);
+        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
+            fProfilePlus += ",";
+        fProfilePlus += fpId;
+        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+    }
+
+    context.getOperationRegistry().registerOperation("ClearChargingProfile", [this] () {
+        return new Ocpp16::ClearChargingProfile(*this);});
+    context.getOperationRegistry().registerOperation("GetCompositeSchedule", [&context, this] () {
+        return new Ocpp16::GetCompositeSchedule(context.getModel(), *this);});
+    context.getOperationRegistry().registerOperation("SetChargingProfile", [&context, this] () {
+        return new Ocpp16::SetChargingProfile(context.getModel(), *this);});
+
+    loadProfiles();
+}
+
+SmartChargingService::~SmartChargingService() {
+
+}
+
+ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile){
+
+    if ((connectorId > 0 && !getScConnectorById(connectorId)) || !chargingProfile) {
+        AO_DBG_ERR("invalid args");
+        return nullptr;
+    }
+
+    if (AO_DBG_LEVEL >= AO_DL_VERBOSE) {
+        AO_DBG_VERBOSE("Charging Profile internal model:");
+        chargingProfile->printProfile();
+    }
+
+    int stackLevel = chargingProfile->getStackLevel();
+    if (stackLevel< 0 || stackLevel >= CHARGEPROFILEMAXSTACKLEVEL + 1) {
+        AO_DBG_ERR("input validation failed");
+        return nullptr;
+    }
+
+    size_t chargingProfilesCount = 0;
+    for (size_t i = 0; i < CHARGEPROFILEMAXSTACKLEVEL + 1; i++) {
+        if (ChargePointTxDefaultProfile[i]) {
+            chargingProfilesCount++;
+        }
+        if (ChargePointMaxProfile[i]) {
+            chargingProfilesCount++;
+        }
+    }
+    for (size_t i = 0; i < connectors.size(); i++) {
+        chargingProfilesCount += connectors[i].getChargingProfilesCount();
+    }
+
+    if (chargingProfilesCount >= MAXCHARGINGPROFILESINSTALLED) {
+        AO_DBG_WARN("number of maximum charging profiles exceeded");
+        return nullptr;
+    }
+
+    ChargingProfile *res = nullptr;
+
+    switch (chargingProfile->getChargingProfilePurpose()) {
+        case (ChargingProfilePurposeType::ChargePointMaxProfile):
+            if (connectorId != 0) {
+                AO_DBG_WARN("invalid charging profile");
+                return nullptr;
+            }
+            ChargePointMaxProfile[stackLevel] = std::move(chargingProfile);
+            res = ChargePointMaxProfile[stackLevel].get();
+            break;
+        case (ChargingProfilePurposeType::TxDefaultProfile):
+            if (connectorId == 0) {
+                ChargePointTxDefaultProfile[stackLevel] = std::move(chargingProfile);
+                res = ChargePointTxDefaultProfile[stackLevel].get();
+            } else {
+                if (!getScConnectorById(connectorId)) {
+                    AO_DBG_WARN("invalid charging profile");
+                    return nullptr;
+                }
+                res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
+            }
+            break;
+        case (ChargingProfilePurposeType::TxProfile):
+            if (!getScConnectorById(connectorId)) {
+                AO_DBG_WARN("invalid charging profile");
+                return nullptr;
+            }
+            res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
+            break;
+    }
+
+    /**
+     * Invalidate the last limit inference by setting the nextChange to now. By the next loop()-call, the limit
+     * and nextChange will be recalculated and onLimitChanged will be called.
+     */
+    if (res) {
+        nextChange = context.getModel().getClock().now();
+        for (size_t i = 0; i < connectors.size(); i++) {
+            connectors[i].notifyProfilesUpdated();
         }
     }
 
-    if (connectorId > 0) {
-        return getScConnectorById(connectorId)->getCompositeSchedule(duration, unit);
+    return res;
+}
+
+bool SmartChargingService::loadProfiles() {
+
+    bool success = true;
+
+    if (!filesystem) {
+        AO_DBG_DEBUG("no filesystem");
+        return true; //not an error
     }
+
+    ChargingProfilePurposeType purposes[] = {ChargingProfilePurposeType::ChargePointMaxProfile, ChargingProfilePurposeType::TxDefaultProfile, ChargingProfilePurposeType::TxProfile};
+
+    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+
+    for (auto purpose : purposes) {
+        for (unsigned int cId = 0; cId < numConnectors; cId++) {
+            if (cId > 0 && purpose == ChargingProfilePurposeType::ChargePointMaxProfile) {
+                continue;
+            }
+            for (unsigned int iLevel = 0; iLevel < CHARGEPROFILEMAXSTACKLEVEL; iLevel++) {
+
+                if (!SmartChargingServiceUtils::printProfileFileName(fn, AO_MAX_PATH_SIZE, cId, purpose, iLevel)) {
+                    return false;
+                }
+
+                size_t msize = 0;
+                if (filesystem->stat(fn, &msize) != 0) {
+                    continue; //There is not a profile on the stack iStack with stacklevel iLevel. Normal case, just continue.
+                }
+
+                auto profileDoc = FilesystemUtils::loadJson(filesystem, fn);
+                if (!profileDoc) {
+                    success = false;
+                    AO_DBG_ERR("profile corrupt: %s, remove", fn);
+                    filesystem->remove(fn);
+                    continue;
+                }
+
+                JsonObject profileJson = profileDoc->as<JsonObject>();
+                auto chargingProfile = loadChargingProfile(profileJson);
+
+                bool valid = false;
+                if (chargingProfile) {
+                    valid = updateProfiles(cId, std::move(chargingProfile));
+                }
+                if (!valid) {
+                    success = false;
+                    AO_DBG_ERR("profile corrupt: %s, remove", fn);
+                    filesystem->remove(fn);
+                }
+            }
+        }
+    }
+
+    return success;
+}
+
+/*
+ * limitOut: the calculated maximum charge rate at the moment, or the default value if no limit is defined
+ * validToOut: The begin of the next SmartCharging restriction after time t
+ */
+void SmartChargingService::calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut){
     
-    auto& startSchedule = context.getModel().getClock().now();
+    //initialize output parameters with the default values
+    limitOut = ChargeRate();
+    validToOut = MAX_TIME;
 
-    auto schedule = std::unique_ptr<ChargingSchedule>(new ChargingSchedule());
-    schedule->duration = duration;
-    schedule->startSchedule = startSchedule;
-    schedule->chargingProfileKind = ChargingProfileKindType::Absolute;
-    schedule->recurrencyKind = RecurrencyKindType::NOT_SET;
+    //get ChargePointMaxProfile with the highest stackLevel
+    for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+        if (ChargePointMaxProfile[i]) {
+            ChargeRate crOut;
+            bool defined = ChargePointMaxProfile[i]->calculateLimit(t, crOut, validToOut);
+            if (defined) {
+                limitOut = crOut;
+                break;
+            }
+        }
+    }
+}
 
-    auto& periods = schedule->chargingSchedulePeriod;
+void SmartChargingService::loop(){
 
-    Timestamp periodBegin = Timestamp(startSchedule);
-    Timestamp periodStop = Timestamp(startSchedule);
+    for (size_t i = 0; i < connectors.size(); i++) {
+        connectors[i].loop();
+    }
 
-    while (periodBegin - startSchedule < duration && periods.size() < CHARGINGSCHEDULEMAXPERIODS) {
+    /**
+     * check if to call onLimitChange
+     */
+    auto& tnow = context.getModel().getClock().now();
 
-        //calculate limit
+    if (tnow >= nextChange){
+        
         ChargeRate limit;
-        calculateLimit(periodBegin, limit, periodStop);
+        nextChange = MAX_TIME; //reset nextChange to default value and refresh it
 
-        //if the unit is still unspecified, guess by taking the unit of the first limit
-        if (unit == ChargingRateUnitType_Optional::None) {
-            if (limit.power < limit.current) {
-                unit = ChargingRateUnitType_Optional::Watt;
-            } else {
-                unit = ChargingRateUnitType_Optional::Amp;
+        calculateLimit(tnow, limit, nextChange);
+
+#if (AO_DBG_LEVEL >= AO_DL_INFO)
+        char timestamp1[JSONDATE_LENGTH + 1] = {'\0'};
+        tnow.toJsonString(timestamp1, JSONDATE_LENGTH + 1);
+        char timestamp2[JSONDATE_LENGTH + 1] = {'\0'};
+        nextChange.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
+        AO_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = {%f,%f,%i}",
+                            timestamp1, timestamp2, limit.power, limit.current, limit.nphases);
+#endif
+
+        if (trackLimitOutput != limit) {
+            if (limitOutput) {
+
+                limitOutput(
+                    limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
+                    limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
+                    limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
+                trackLimitOutput = limit;
             }
         }
+    }
+}
 
-        periods.push_back(ChargingSchedulePeriod());
-        float limit_opt = unit == ChargingRateUnitType_Optional::Watt ? limit.power : limit.current;
-        periods.back().limit = limit_opt != std::numeric_limits<float>::max() ? limit_opt : -1.f;
-        periods.back().numberPhases = limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1;
-        periods.back().startPeriod = periodBegin - startSchedule;
-
-        periodBegin = periodStop;
+void SmartChargingService::setSmartChargingOutput(unsigned int connectorId, std::function<void(float,float,int)> limitOutput) {
+    if ((connectorId > 0 && !getScConnectorById(connectorId))) {
+        AO_DBG_ERR("invalid args");
+        return;
     }
 
-    if (unit == ChargingRateUnitType_Optional::Watt) {
-        schedule->chargingRateUnit = ChargingRateUnitType::Watt;
+    if (connectorId == 0) {
+        if (this->limitOutput) {
+            AO_DBG_WARN("replacing existing SmartChargingOutput");
+            (void)0;
+        }
+        this->limitOutput = limitOutput;
     } else {
-        schedule->chargingRateUnit = ChargingRateUnitType::Amp;
+        getScConnectorById(connectorId)->setSmartChargingOutput(limitOutput);
     }
+}
 
-    return schedule;
+void SmartChargingService::updateAllowedChargingRateUnit(bool powerSupported, bool currentSupported) {
+    if ((powerSupported != this->powerSupported) || (currentSupported != this->currentSupported)) {
+
+        auto chargingScheduleAllowedChargingRateUnit = declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE, false);
+        if (chargingScheduleAllowedChargingRateUnit) {
+            if (powerSupported && currentSupported) {
+                *chargingScheduleAllowedChargingRateUnit = "Current,Power";
+            } else if (powerSupported) {
+                *chargingScheduleAllowedChargingRateUnit = "Power";
+            } else if (currentSupported) {
+                *chargingScheduleAllowedChargingRateUnit = "Current";
+            }
+        }
+
+        this->powerSupported = powerSupported;
+        this->currentSupported = currentSupported;
+    }
 }
 
 bool SmartChargingService::setChargingProfile(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile) {
@@ -470,131 +598,6 @@ bool SmartChargingService::setChargingProfile(unsigned int connectorId, std::uni
     return success;
 }
 
-ChargingProfile *SmartChargingConnector::updateProfiles(std::unique_ptr<ChargingProfile> chargingProfile) {
-    
-    int stackLevel = chargingProfile->getStackLevel(); //already validated
-    
-    switch (chargingProfile->getChargingProfilePurpose()) {
-        case (ChargingProfilePurposeType::ChargePointMaxProfile):
-            break;
-        case (ChargingProfilePurposeType::TxDefaultProfile):
-            TxDefaultProfile[stackLevel] = std::move(chargingProfile);
-            return TxDefaultProfile[stackLevel].get();
-        case (ChargingProfilePurposeType::TxProfile):
-            TxProfile[stackLevel] = std::move(chargingProfile);
-            return TxProfile[stackLevel].get();
-    }
-
-    AO_DBG_ERR("invalid args");
-    return nullptr;
-}
-
-void SmartChargingConnector::notifyProfilesUpdated() {
-    nextChange = model.getClock().now();
-}
-
-ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile){
-
-    if ((connectorId > 0 && !getScConnectorById(connectorId)) || !chargingProfile) {
-        AO_DBG_ERR("invalid args");
-        return nullptr;
-    }
-
-    if (AO_DBG_LEVEL >= AO_DL_VERBOSE) {
-        AO_DBG_VERBOSE("Charging Profile internal model:");
-        chargingProfile->printProfile();
-    }
-
-    int stackLevel = chargingProfile->getStackLevel();
-    if (stackLevel< 0 || stackLevel >= CHARGEPROFILEMAXSTACKLEVEL + 1) {
-        AO_DBG_ERR("input validation failed");
-        return nullptr;
-    }
-
-    size_t chargingProfilesCount = 0;
-    for (size_t i = 0; i < CHARGEPROFILEMAXSTACKLEVEL + 1; i++) {
-        if (ChargePointTxDefaultProfile[i]) {
-            chargingProfilesCount++;
-        }
-        if (ChargePointMaxProfile[i]) {
-            chargingProfilesCount++;
-        }
-    }
-    for (size_t i = 0; i < connectors.size(); i++) {
-        chargingProfilesCount += connectors[i].getChargingProfilesCount();
-    }
-
-    if (chargingProfilesCount >= MAXCHARGINGPROFILESINSTALLED) {
-        AO_DBG_WARN("number of maximum charging profiles exceeded");
-        return nullptr;
-    }
-
-    ChargingProfile *res = nullptr;
-
-    switch (chargingProfile->getChargingProfilePurpose()) {
-        case (ChargingProfilePurposeType::ChargePointMaxProfile):
-            if (connectorId != 0) {
-                AO_DBG_WARN("invalid charging profile");
-                return nullptr;
-            }
-            ChargePointMaxProfile[stackLevel] = std::move(chargingProfile);
-            res = ChargePointMaxProfile[stackLevel].get();
-            break;
-        case (ChargingProfilePurposeType::TxDefaultProfile):
-            if (connectorId == 0) {
-                ChargePointTxDefaultProfile[stackLevel] = std::move(chargingProfile);
-                res = ChargePointTxDefaultProfile[stackLevel].get();
-            } else {
-                if (!getScConnectorById(connectorId)) {
-                    AO_DBG_WARN("invalid charging profile");
-                    return nullptr;
-                }
-                res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
-            }
-            break;
-        case (ChargingProfilePurposeType::TxProfile):
-            if (!getScConnectorById(connectorId)) {
-                AO_DBG_WARN("invalid charging profile");
-                return nullptr;
-            }
-            res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
-            break;
-    }
-
-    /**
-     * Invalidate the last limit inference by setting the nextChange to now. By the next loop()-call, the limit
-     * and nextChange will be recalculated and onLimitChanged will be called.
-     */
-    if (res) {
-        nextChange = context.getModel().getClock().now();
-        for (size_t i = 0; i < connectors.size(); i++) {
-            connectors[i].notifyProfilesUpdated();
-        }
-    }
-
-    return res;
-}
-
-bool SmartChargingConnector::clearChargingProfile(const std::function<bool(int, int, ChargingProfilePurposeType, int)> filter) {
-    bool found = false;
-
-    ProfileStack *profileStacks [] = {&TxProfile, &TxDefaultProfile};
-
-    for (auto stack : profileStacks) {
-        for (size_t iLevel = 0; iLevel < stack->size(); iLevel++) {
-            if (auto& profile = stack->at(iLevel)) {
-                if (profile && filter(profile->getChargingProfileId(), connectorId, profile->getChargingProfilePurpose(), iLevel)) {
-                    found = true;
-                    SmartChargingServiceUtils::removeProfile(filesystem, connectorId, profile->getChargingProfilePurpose(), iLevel);
-                    profile.reset();
-                }
-            }
-        }
-    }
-
-    return found;
-}
-
 bool SmartChargingService::clearChargingProfile(std::function<bool(int, int, ChargingProfilePurposeType, int)> filter) {
     bool found = false;
 
@@ -628,72 +631,69 @@ bool SmartChargingService::clearChargingProfile(std::function<bool(int, int, Cha
     return found;
 }
 
-bool SmartChargingService::loadProfiles() {
-
-    bool success = true;
+std::unique_ptr<ChargingSchedule> SmartChargingService::getCompositeSchedule(unsigned int connectorId, int duration, ChargingRateUnitType_Optional unit) {
 
-    if (!filesystem) {
-        AO_DBG_DEBUG("no filesystem");
-        return true; //not an error
+    if (connectorId > 0 && !getScConnectorById(connectorId)) {
+        AO_DBG_ERR("invalid args");
+        return nullptr;
+    }
+    
+    if (unit == ChargingRateUnitType_Optional::None) {
+        if (powerSupported && !currentSupported) {
+            unit = ChargingRateUnitType_Optional::Watt;
+        } else if (!powerSupported && currentSupported) {
+            unit = ChargingRateUnitType_Optional::Amp;
+        }
     }
 
-    ChargingProfilePurposeType purposes[] = {ChargingProfilePurposeType::ChargePointMaxProfile, ChargingProfilePurposeType::TxDefaultProfile, ChargingProfilePurposeType::TxProfile};
-
-    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+    if (connectorId > 0) {
+        return getScConnectorById(connectorId)->getCompositeSchedule(duration, unit);
+    }
+    
+    auto& startSchedule = context.getModel().getClock().now();
 
-    for (auto purpose : purposes) {
-        for (unsigned int cId = 0; cId < numConnectors; cId++) {
-            if (cId > 0 && purpose == ChargingProfilePurposeType::ChargePointMaxProfile) {
-                continue;
-            }
-            for (unsigned int iLevel = 0; iLevel < CHARGEPROFILEMAXSTACKLEVEL; iLevel++) {
+    auto schedule = std::unique_ptr<ChargingSchedule>(new ChargingSchedule());
+    schedule->duration = duration;
+    schedule->startSchedule = startSchedule;
+    schedule->chargingProfileKind = ChargingProfileKindType::Absolute;
+    schedule->recurrencyKind = RecurrencyKindType::NOT_SET;
 
-                if (!SmartChargingServiceUtils::printProfileFileName(fn, AO_MAX_PATH_SIZE, cId, purpose, iLevel)) {
-                    return false;
-                }
+    auto& periods = schedule->chargingSchedulePeriod;
 
-                size_t msize = 0;
-                if (filesystem->stat(fn, &msize) != 0) {
-                    continue; //There is not a profile on the stack iStack with stacklevel iLevel. Normal case, just continue.
-                }
+    Timestamp periodBegin = Timestamp(startSchedule);
+    Timestamp periodStop = Timestamp(startSchedule);
 
-                auto profileDoc = FilesystemUtils::loadJson(filesystem, fn);
-                if (!profileDoc) {
-                    success = false;
-                    AO_DBG_ERR("profile corrupt: %s, remove", fn);
-                    filesystem->remove(fn);
-                    continue;
-                }
+    while (periodBegin - startSchedule < duration && periods.size() < CHARGINGSCHEDULEMAXPERIODS) {
 
-                JsonObject profileJson = profileDoc->as<JsonObject>();
-                auto chargingProfile = loadChargingProfile(profileJson);
+        //calculate limit
+        ChargeRate limit;
+        calculateLimit(periodBegin, limit, periodStop);
 
-                bool valid = false;
-                if (chargingProfile) {
-                    valid = updateProfiles(cId, std::move(chargingProfile));
-                }
-                if (!valid) {
-                    success = false;
-                    AO_DBG_ERR("profile corrupt: %s, remove", fn);
-                    filesystem->remove(fn);
-                }
+        //if the unit is still unspecified, guess by taking the unit of the first limit
+        if (unit == ChargingRateUnitType_Optional::None) {
+            if (limit.power < limit.current) {
+                unit = ChargingRateUnitType_Optional::Watt;
+            } else {
+                unit = ChargingRateUnitType_Optional::Amp;
             }
         }
-    }
 
-    return success;
-}
+        periods.push_back(ChargingSchedulePeriod());
+        float limit_opt = unit == ChargingRateUnitType_Optional::Watt ? limit.power : limit.current;
+        periods.back().limit = limit_opt != std::numeric_limits<float>::max() ? limit_opt : -1.f;
+        periods.back().numberPhases = limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1;
+        periods.back().startPeriod = periodBegin - startSchedule;
 
-SmartChargingConnector *SmartChargingService::getScConnectorById(unsigned int connectorId) {
-    if (connectorId == 0) {
-        return nullptr;
+        periodBegin = periodStop;
     }
 
-    if (connectorId - 1 >= connectors.size()) {
-        return nullptr;
+    if (unit == ChargingRateUnitType_Optional::Watt) {
+        schedule->chargingRateUnit = ChargingRateUnitType::Watt;
+    } else {
+        schedule->chargingRateUnit = ChargingRateUnitType::Amp;
     }
 
-    return &connectors[connectorId-1];
+    return schedule;
 }
 
 bool SmartChargingServiceUtils::printProfileFileName(char *out, size_t bufsize, unsigned int connectorId, ChargingProfilePurposeType purpose, unsigned int stackLevel) {
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
index 1bc1b96e..a95cc696 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
@@ -49,6 +49,10 @@ class SmartChargingConnector {
 
     ChargeRate trackLimitOutput;
 
+    void calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut);
+
+    void trackTransaction();
+
 public:
     SmartChargingConnector(Model& model, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ProfileStack& ChargePointMaxProfile, ProfileStack& ChargePointTxDefaultProfile);
     SmartChargingConnector(SmartChargingConnector&&) = default;
@@ -58,10 +62,6 @@ class SmartChargingConnector {
 
     void setSmartChargingOutput(std::function<void(float,float,int)> limitOutput); //read maximum Watt x Amps x numberPhases
 
-    void calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut);
-
-    void trackTransaction();
-
     ChargingProfile *updateProfiles(std::unique_ptr<ChargingProfile> chargingProfile);
 
     void notifyProfilesUpdated();
@@ -93,20 +93,23 @@ class SmartChargingService {
 
     ChargingProfile *updateProfiles(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile);
     bool loadProfiles();
+
+    void calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut);
   
 public:
     SmartChargingService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int numConnectors);
     ~SmartChargingService();
 
+    void loop();
+
     void setSmartChargingOutput(unsigned int connectorId, std::function<void(float,float,int)> limitOutput); //read maximum Watt x Amps x numberPhases
     void updateAllowedChargingRateUnit(bool powerSupported, bool currentSupported); //set supported measurand of SmartChargingOutput
 
     bool setChargingProfile(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile);
 
     bool clearChargingProfile(std::function<bool(int, int, ChargingProfilePurposeType, int)> filter);
-    void calculateLimit(const Timestamp &t, ChargeRate& limitOut, Timestamp& validToOut);
+
     std::unique_ptr<ChargingSchedule> getCompositeSchedule(unsigned int connectorId, int duration, ChargingRateUnitType_Optional unit = ChargingRateUnitType_Optional::None);
-    void loop();
 };
 
 //filesystem-related helper functions

From 552c47692b2666b2942b4f56f505480914aa46e6 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 20 Jun 2023 19:53:26 +0200
Subject: [PATCH 282/549] restore getTransactionIdTag

---
 src/ArduinoOcpp.cpp | 14 ++++++++++++++
 src/ArduinoOcpp.h   |  6 ++++++
 2 files changed, 20 insertions(+)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 15585d2b..c6ef19c6 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -641,6 +641,20 @@ std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
     return connector->getTransaction();
 }
 
+const char *getTransactionIdTag(unsigned int connectorId) {
+    if (!context) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return nullptr;
+    }
+    auto connector = context->getModel().getConnector(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return nullptr;
+    }
+    auto& tx = connector->getTransaction();
+    return tx ? tx->getIdTag() : nullptr;
+}
+
 bool isBlockedByReservation(const char *idTag, unsigned int connectorId) {
     if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 17b8f21b..b4af1a72 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -260,6 +260,12 @@ bool isOperative(unsigned int connectorId = 1); //if the charge point is operati
  */
 std::shared_ptr<ArduinoOcpp::Transaction>& getTransaction(unsigned int connectorId = 1);
 
+/*
+ * Get the idTag which has been used to start the transaction. If no transaction process is
+ * running, this function returns nullptr
+ */
+const char *getTransactionIdTag(unsigned int connectorId = 1);
+
 bool isBlockedByReservation(const char *idTag, unsigned int connectorId = 1); //if the connector is already reserved for a different idTag
 
 /*

From 0ae59f8d5c7131ff822a89bb7d8fcb1d1b0f0d49 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 20 Jun 2023 19:53:37 +0200
Subject: [PATCH 283/549] update examples

---
 examples/ESP-TLS/main.cpp | 1 +
 examples/ESP/main.cpp     | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/examples/ESP-TLS/main.cpp b/examples/ESP-TLS/main.cpp
index 680f2e6e..c91bc498 100644
--- a/examples/ESP-TLS/main.cpp
+++ b/examples/ESP-TLS/main.cpp
@@ -117,6 +117,7 @@ void setup() {
     wsockSecure.setReconnectInterval(5000);
     wsockSecure.enableHeartbeat(15000, 3000, 2);
     wsockSecure.setAuthorization(OCPP_AUTH_ID, OCPP_AUTH_KEY); // => Authorization: Basic QUwxMDAwOgABAgMEBQYH////////////////
+    
     OCPP_initialize(osockSecure, ChargerCredentials("My Charging Station", "My company name"));
 
     /*
diff --git a/examples/ESP/main.cpp b/examples/ESP/main.cpp
index da6bcddf..f01e175e 100644
--- a/examples/ESP/main.cpp
+++ b/examples/ESP/main.cpp
@@ -70,7 +70,7 @@ void setup() {
         return 0.f;
     });
 
-    setSmartChargingOutput([](float limit) {
+    setSmartChargingCurrentOutput([](float limit) {
         //set the SAE J1772 Control Pilot value here
         Serial.printf("[main] Smart Charging allows maximum charge rate: %.0f\n", limit);
     });
@@ -105,8 +105,8 @@ void loop() {
     if (/* RFID chip detected? */ false) {
         String idTag = "0123456789ABCD"; //e.g. idTag = RFID.readIdTag();
 
-        if (!getTransactionIdTag()) {
-            //no idTag registered yet. Start a new transaction
+        if (!getTransaction()) {
+            //no transaction running or preparing. Begin a new transaction
             Serial.printf("[main] Begin Transaction with idTag %s\n", idTag.c_str());
 
             /*

From 6f058232512aecda7fd94f640e6f17780b94a741 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 21 Jun 2023 20:53:50 +0200
Subject: [PATCH 284/549] fix compilation issues

---
 .github/workflows/platformless.yml                     |  2 +-
 src/ArduinoOcpp/Core/Connection.h                      | 10 ++++++++++
 .../Model/SmartCharging/SmartChargingService.cpp       |  4 ++--
 src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp    |  2 +-
 4 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index a1f71993..06873bcb 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -23,4 +23,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_USE_FILEAPI=POSIX_FILEAPI -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store/"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -DAO_DEACTIVATE_FLASH_SMARTCHARGING -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_FILENAME_PREFIX='"./ao_store/"' -DAO_PLATFORM=AO_PLATFORM_UNIX -Wall
diff --git a/src/ArduinoOcpp/Core/Connection.h b/src/ArduinoOcpp/Core/Connection.h
index f4487da7..540f1e6e 100644
--- a/src/ArduinoOcpp/Core/Connection.h
+++ b/src/ArduinoOcpp/Core/Connection.h
@@ -9,6 +9,16 @@
 #include <memory>
 #include <string>
 
+#include <ArduinoOcpp/Platform.h>
+
+//On all platforms other than Arduino, the integrated WS lib (links2004/arduinoWebSockets) cannot be
+//used. On Arduino it's usage is optional.
+#ifndef AO_CUSTOM_WS
+#if AO_PLATFORM != AO_PLATFORM_ARDUINO
+#define AO_CUSTOM_WS
+#endif
+#endif //ndef AO_CUSTOM_WS
+
 namespace ArduinoOcpp {
 
 using ReceiveTXTcallback = std::function<bool(const char*, size_t)>;
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
index eff8fb5b..6f1afd26 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -16,7 +16,7 @@
 using namespace::ArduinoOcpp;
 
 SmartChargingConnector::SmartChargingConnector(Model& model, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ProfileStack& ChargePointMaxProfile, ProfileStack& ChargePointTxDefaultProfile) :
-        model{model}, filesystem{filesystem}, connectorId{connectorId}, ChargePointMaxProfile{ChargePointMaxProfile}, ChargePointTxDefaultProfile{ChargePointTxDefaultProfile} {
+        model(model), filesystem{filesystem}, connectorId{connectorId}, ChargePointMaxProfile(ChargePointMaxProfile), ChargePointTxDefaultProfile(ChargePointTxDefaultProfile) {
     
 }
 
@@ -711,7 +711,7 @@ bool SmartChargingServiceUtils::printProfileFileName(char *out, size_t bufsize,
             break;
     }
 
-    if (pret < 0 || pret >= bufsize) {
+    if (pret < 0 || (size_t) pret >= bufsize) {
         AO_DBG_ERR("fn error: %i", pret);
         return false;
     }
diff --git a/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp b/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
index 3956b078..11f0771f 100644
--- a/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
+++ b/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
@@ -9,7 +9,7 @@
 
 using ArduinoOcpp::Ocpp16::GetCompositeSchedule;
 
-GetCompositeSchedule::GetCompositeSchedule(Model& model, SmartChargingService& scService) : model{model}, scService{scService} {
+GetCompositeSchedule::GetCompositeSchedule(Model& model, SmartChargingService& scService) : model(model), scService(scService) {
 
 }
 

From 41d9b2cff1155803388f8aef3ad8d7901f89f457 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 21 Jun 2023 20:58:20 +0200
Subject: [PATCH 285/549] fix compilation issues II

---
 src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp b/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
index 62f3e01a..c80320de 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Model/Transactions/TransactionDeSerialize.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionDeserialize.h>
 #include <ArduinoOcpp/Operations/StartTransaction.h>
 #include <ArduinoOcpp/Operations/StopTransaction.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>

From 241d074c729943ad5acefcbf84d065daf980ee01 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 21 Jun 2023 21:04:14 +0200
Subject: [PATCH 286/549] fix compilation issues III

---
 src/ArduinoOcpp/Operations/ClearChargingProfile.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp b/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
index 3d86ce30..38259050 100644
--- a/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
+++ b/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
@@ -10,7 +10,7 @@
 
 using ArduinoOcpp::Ocpp16::ClearChargingProfile;
 
-ClearChargingProfile::ClearChargingProfile(SmartChargingService& scService) : scService{scService} {
+ClearChargingProfile::ClearChargingProfile(SmartChargingService& scService) : scService(scService) {
 
 }
 

From 20cfed7d9a6647da415015067b7ce874c974571b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 22 Jun 2023 12:30:59 +0200
Subject: [PATCH 287/549] build unit tests using cmake

---
 .github/workflows/tests.yml | 8 +++++---
 CMakeLists.txt              | 3 +++
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 5565deb4..206bddab 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -16,15 +16,17 @@ jobs:
     - name: Get gcc compiler
       run: |
         sudo apt update
-        sudo apt install build-essential
+        sudo apt install build-essential cmake
         sudo apt -y install gcc-9 g++-9
         g++ --version
         echo "g++ version must be 9.4.0"
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
+    - name: Generate CMake build files
+      run: cmake -S . -B ./build
     - name: Compile
-      run: g++ -std=c++14 -I ./src $(find ./src ./tests -type f -iregex ".*\.cpp") -DAO_CUSTOM_WS -DAO_CUSTOM_UPDATER -DAO_CUSTOM_RESET -DAO_DBG_LEVEL=AO_DL_DEBUG -DAO_TRAFFIC_OUT -DAO_FILENAME_PREFIX='"./ao_store/"' -DAO_PLATFORM=AO_PLATFORM_UNIX -DAO_CUSTOM_TIMER -o ./output -Wall
+      run: cmake --build ./build -j 16 --target ao_unit_tests
     - name: Configure FS
       run: mkdir ao_store
     - name: Run tests
-      run: ./output
+      run: ./build/ao_unit_tests
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 8c3e85cb..00e40f8a 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -4,6 +4,9 @@
 
 cmake_minimum_required(VERSION 3.15)
 
+project(ArduinoOcpp
+        VERSION 0.2.0)
+
 set(AO_SRC
     src/ArduinoOcpp/Core/Configuration.cpp
     src/ArduinoOcpp/Core/ConfigurationContainer.cpp

From 08e687aa6a4f922afefd7d3584d09d6de8817c1c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 23 Jun 2023 22:28:41 +0200
Subject: [PATCH 288/549] add recovery mode

---
 src/ArduinoOcpp.cpp                        | 45 +++++++++----
 src/ArduinoOcpp/Context.cpp                |  4 +-
 src/ArduinoOcpp/Context.h                  |  2 +-
 src/ArduinoOcpp/Core/FilesystemUtils.cpp   |  7 +-
 src/ArduinoOcpp/Core/FilesystemUtils.h     |  2 +-
 src/ArduinoOcpp/Model/Boot/BootService.cpp | 77 +++++++++++++++++++++-
 src/ArduinoOcpp/Model/Boot/BootService.h   | 20 +++++-
 src/ArduinoOcpp/Operations/ClearCache.cpp  |  8 ++-
 8 files changed, 141 insertions(+), 24 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index c6ef19c6..f86543c5 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -21,6 +21,7 @@
 #include <ArduinoOcpp/Core/OperationRegistry.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
 
 #include <ArduinoOcpp/Operations/Authorize.h>
 #include <ArduinoOcpp/Operations/StartTransaction.h>
@@ -39,8 +40,6 @@ Connection *connection {nullptr};
 
 Context *context {nullptr};
 std::shared_ptr<FilesystemAdapter> filesystem;
-FilesystemOpt fileSystemOpt {};
-float voltage_eff {230.f};
 
 #ifndef AO_NUMCONNECTORS
 #define AO_NUMCONNECTORS 2
@@ -125,23 +124,38 @@ void OCPP_initialize(Connection& connection, const char *bootNotificationCredent
         return;
     }
 
-    voltage_eff = V_eff;
-    fileSystemOpt = fsOpt;
-
 #ifndef AO_DEACTIVATE_FLASH
-    filesystem = makeDefaultFilesystemAdapter(fileSystemOpt);
+    filesystem = makeDefaultFilesystemAdapter(fsOpt);
 #endif
     AO_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "error");
+
+    BootStats bootstats;
+    BootService::loadBootStats(filesystem, bootstats);
+
+    if (bootstats.getBootFailureCount() > 3) {
+        AO_DBG_ERR("multiple initialization failures detected");
+        if (filesystem) {
+            bool success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
+                return strcmp(fname, "ocpp-creds.jsn");
+            });
+            AO_DBG_ERR("clear local state folder (except WS creds): %s", success ? "success" : "not completed");
+
+            bootstats = BootStats();
+        }
+    }
+
+    bootstats.bootNr++; //assign new boot number to this run
+    BootService::storeBootStats(filesystem, bootstats);
     
     configuration_init(filesystem); //call before each other library call
 
-    context = new Context(connection, filesystem);
+    context = new Context(connection, filesystem, bootstats.bootNr);
     auto& model = context->getModel();
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
         new TransactionStore(AO_NUMCONNECTORS, filesystem)));
     model.setBootService(std::unique_ptr<BootService>(
-        new BootService(*context)));
+        new BootService(*context, filesystem)));
     model.setChargeControlCommon(std::unique_ptr<ChargeControlCommon>(
         new ChargeControlCommon(*context, AO_NUMCONNECTORS, filesystem)));
     std::vector<Connector> connectors;
@@ -158,7 +172,6 @@ void OCPP_initialize(Connection& connection, const char *bootNotificationCredent
     model.setResetService(std::unique_ptr<ResetService>(
         new ResetService(*context)));
 
-    
 #if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
         EspWiFi::makeFirmwareService(*context))); //instantiate FW service + ESP installation routine
@@ -190,6 +203,17 @@ void OCPP_initialize(Connection& connection, const char *bootNotificationCredent
 }
 
 void OCPP_deinitialize() {
+
+    if (context) {
+        //release bootstats recovery mechanism
+        BootStats bootstats;
+        BootService::loadBootStats(filesystem, bootstats);
+        if (bootstats.lastBootSuccess != bootstats.bootNr) {
+            AO_DBG_DEBUG("boot success timer override");
+            bootstats.lastBootSuccess = bootstats.bootNr;
+            BootService::storeBootStats(filesystem, bootstats);
+        }
+    }
     
     delete context;
     context = nullptr;
@@ -201,8 +225,7 @@ void OCPP_deinitialize() {
     webSocket = nullptr;
 #endif
 
-    fileSystemOpt = FilesystemOpt();
-    voltage_eff = 230.f;
+    filesystem.reset();
 
     configuration_deinit();
 }
diff --git a/src/ArduinoOcpp/Context.cpp b/src/ArduinoOcpp/Context.cpp
index b6b51ef7..2e437518 100644
--- a/src/ArduinoOcpp/Context.cpp
+++ b/src/ArduinoOcpp/Context.cpp
@@ -11,8 +11,8 @@
 
 using namespace ArduinoOcpp;
 
-Context::Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem)
-        : connection(connection), model{}, reqQueue{operationRegistry, &model, filesystem} {
+Context::Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr)
+        : connection(connection), model{bootNr}, reqQueue{operationRegistry, &model, filesystem} {
 
     preBootQueue = std::unique_ptr<RequestQueue>(new RequestQueue(operationRegistry, &model, nullptr)); //pre boot queue doesn't need persistency
     preBootQueue->setConnection(connection);
diff --git a/src/ArduinoOcpp/Context.h b/src/ArduinoOcpp/Context.h
index d8a0b015..48a4c5e7 100644
--- a/src/ArduinoOcpp/Context.h
+++ b/src/ArduinoOcpp/Context.h
@@ -26,7 +26,7 @@ class Context {
     std::unique_ptr<RequestQueue> preBootQueue;
 
 public:
-    Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem);
+    Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr);
     ~Context();
 
     void loop();
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
index f4ca6605..2cd40346 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.cpp
@@ -115,10 +115,9 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
     return true;
 }
 
-bool FilesystemUtils::remove_all(std::shared_ptr<FilesystemAdapter> filesystem, const char *fpath_prefix) {
-    return filesystem->ftw_root([filesystem, fpath_prefix] (const char *fpath) {
-        if (!strncmp(fpath, fpath_prefix, strlen(fpath_prefix)) &&
-                fpath[0] != '.') {
+bool FilesystemUtils::remove_if(std::shared_ptr<FilesystemAdapter> filesystem, std::function<bool(const char*)> pred) {
+    return filesystem->ftw_root([filesystem, pred] (const char *fpath) {
+        if (pred(fpath) && fpath[0] != '.') {
 
             char fn [AO_MAX_PATH_SIZE] = {'\0'};
             auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "%s", fpath);
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.h b/src/ArduinoOcpp/Core/FilesystemUtils.h
index a5f56e1f..92c7ce30 100644
--- a/src/ArduinoOcpp/Core/FilesystemUtils.h
+++ b/src/ArduinoOcpp/Core/FilesystemUtils.h
@@ -39,7 +39,7 @@ namespace FilesystemUtils {
 std::unique_ptr<DynamicJsonDocument> loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn);
 bool storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const DynamicJsonDocument& doc);
 
-bool remove_all(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn_prefix);
+bool remove_if(std::shared_ptr<FilesystemAdapter> filesystem, std::function<bool(const char*)> pred);
 
 }
 
diff --git a/src/ArduinoOcpp/Model/Boot/BootService.cpp b/src/ArduinoOcpp/Model/Boot/BootService.cpp
index 4a3af66d..12b1cf81 100644
--- a/src/ArduinoOcpp/Model/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Model/Boot/BootService.cpp
@@ -2,15 +2,22 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
+#include <limits>
+
 #include <ArduinoOcpp/Model/Boot/BootService.h>
 #include <ArduinoOcpp/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Operations/BootNotification.h>
 #include <ArduinoOcpp/Platform.h>
 #include <ArduinoOcpp/Debug.h>
 
+#ifndef AO_BOOTSTATS_LONGTIME_MS
+#define AO_BOOTSTATS_LONGTIME_MS 180 * 1000
+#endif
+
 using namespace ArduinoOcpp;
 
 RegistrationStatus ArduinoOcpp::deserializeRegistrationStatus(const char *serialized) {
@@ -26,7 +33,7 @@ RegistrationStatus ArduinoOcpp::deserializeRegistrationStatus(const char *serial
     }
 }
 
-BootService::BootService(Context& context) : context(context) {
+BootService::BootService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
     //if transactions can start before the BootNotification succeeds
     preBootTransactions = declareConfiguration<bool>("AO_PreBootTransactions", false, CONFIGURATION_FN, true, true, true, false);
@@ -43,6 +50,20 @@ BootService::BootService(Context& context) : context(context) {
 
 void BootService::loop() {
 
+    if (!executedFirstTime) {
+        executedFirstTime = true;
+        firstExecutionTimestamp = ao_tick_ms();
+    }
+
+    if (!executedLongTime && ao_tick_ms() - firstExecutionTimestamp >= AO_BOOTSTATS_LONGTIME_MS) {
+        executedLongTime = true;
+        AO_DBG_DEBUG("boot success timer reached");
+        BootStats bootstats;
+        loadBootStats(filesystem, bootstats);
+        bootstats.lastBootSuccess = bootstats.bootNr;
+        storeBootStats(filesystem, bootstats);
+    }
+
     if (!activatedPostBootCommunication && status == RegistrationStatus::Accepted) {
         context.activatePostBootCommunication();
         activatedPostBootCommunication = true;
@@ -123,3 +144,57 @@ void BootService::setRetryInterval(unsigned long interval_s) {
     }
     lastBootNotification = ao_tick_ms();
 }
+
+bool BootService::loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& bstats) {
+    if (!filesystem) {
+        return false;
+    }
+
+    size_t msize = 0;
+    if (filesystem->stat(AO_FILENAME_PREFIX "bootstats.jsn", &msize) == 0) {
+        
+        bool success = true;
+
+        auto json = FilesystemUtils::loadJson(filesystem, AO_FILENAME_PREFIX "bootstats.jsn");
+        if (json) {
+            int bootNrIn = (*json)["bootNr"] | -1;
+            if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
+                bstats.bootNr = (uint16_t) bootNrIn;
+            } else {
+                success = false;
+            }
+
+            int lastSuccessIn = (*json)["lastSuccess"] | -1;
+            if (lastSuccessIn >= 0 && lastSuccessIn <= std::numeric_limits<uint16_t>::max()) {
+                bstats.lastBootSuccess = (uint16_t) lastSuccessIn;
+            } else {
+                success = false;
+            }
+        } else {
+            success = false;
+        }
+
+        if (!success) {
+            AO_DBG_ERR("bootstats corrupted");
+            filesystem->remove(AO_FILENAME_PREFIX "bootstats.jsn");
+            bstats = BootStats();
+        }
+
+        return success;
+    } else {
+        return false;
+    }
+}
+
+bool BootService::storeBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats bstats) {
+    if (!filesystem) {
+        return false;
+    }
+
+    DynamicJsonDocument json {JSON_OBJECT_SIZE(2)};
+
+    json["bootNr"] = bstats.bootNr;
+    json["lastSuccess"] = bstats.lastBootSuccess;
+
+    return FilesystemUtils::storeJson(filesystem, AO_FILENAME_PREFIX "bootstats.jsn", json);
+}
diff --git a/src/ArduinoOcpp/Model/Boot/BootService.h b/src/ArduinoOcpp/Model/Boot/BootService.h
index 9d20b4d3..4844e8d4 100644
--- a/src/ArduinoOcpp/Model/Boot/BootService.h
+++ b/src/ArduinoOcpp/Model/Boot/BootService.h
@@ -6,12 +6,22 @@
 #define BOOTSERVICE_H
 
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <memory>
 
 #define AO_BOOT_INTERVAL_DEFAULT 60
 
 namespace ArduinoOcpp {
 
+struct BootStats {
+    uint16_t bootNr = 0;
+    uint16_t lastBootSuccess = 0;
+
+    uint16_t getBootFailureCount() {
+        return bootNr - lastBootSuccess;
+    }
+};
+
 enum class RegistrationStatus {
     Accepted,
     Pending,
@@ -26,6 +36,7 @@ class Context;
 class BootService {
 private:
     Context& context;
+    std::shared_ptr<FilesystemAdapter> filesystem;
 
     unsigned long interval_s = AO_BOOT_INTERVAL_DEFAULT;
     unsigned long lastBootNotification = -1UL / 2;
@@ -39,8 +50,12 @@ class BootService {
     bool activatedModel = false;
     bool activatedPostBootCommunication = false;
 
+    unsigned long firstExecutionTimestamp = 0;
+    bool executedFirstTime = false;
+    bool executedLongTime = false;
+
 public:
-    BootService(Context& context);
+    BootService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem);
 
     void loop();
 
@@ -50,6 +65,9 @@ class BootService {
 
     void notifyRegistrationStatus(RegistrationStatus status);
     void setRetryInterval(unsigned long interval);
+
+    static bool loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& out);
+    static bool storeBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats bstats);
 };
 
 }
diff --git a/src/ArduinoOcpp/Operations/ClearCache.cpp b/src/ArduinoOcpp/Operations/ClearCache.cpp
index 15e4789e..a3e8e823 100644
--- a/src/ArduinoOcpp/Operations/ClearCache.cpp
+++ b/src/ArduinoOcpp/Operations/ClearCache.cpp
@@ -24,9 +24,11 @@ void ClearCache::processReq(JsonObject payload) {
         return;
     }
 
-    success &= FilesystemUtils::remove_all(filesystem, "sd");
-    success &= FilesystemUtils::remove_all(filesystem, "tx");
-    success &= FilesystemUtils::remove_all(filesystem, "op");
+    success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
+        return !strncmp(fname, "sd", strlen("sd")) ||
+               !strncmp(fname, "tx", strlen("tx")) ||
+               !strncmp(fname, "op", strlen("op"));
+    });
 }
 
 std::unique_ptr<DynamicJsonDocument> ClearCache::createConf(){

From 4ede1b71641861a6ea349a839b2a763c49e9e3ae Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 23 Jun 2023 22:29:43 +0200
Subject: [PATCH 289/549] calc timestamps of preboot txs

---
 src/ArduinoOcpp/Core/Time.cpp                 |   8 +
 src/ArduinoOcpp/Core/Time.h                   |   9 +-
 .../Authorization/AuthorizationService.cpp    |   8 +-
 .../Model/ChargeControl/Connector.cpp         |   4 +-
 src/ArduinoOcpp/Model/Metering/MeterValue.cpp |  21 ++-
 src/ArduinoOcpp/Model/Metering/MeterValue.h   |   5 +
 .../Model/Metering/SampledValue.cpp           |   7 +-
 src/ArduinoOcpp/Model/Metering/SampledValue.h |   2 +
 src/ArduinoOcpp/Model/Model.cpp               |   6 +-
 src/ArduinoOcpp/Model/Model.h                 |   6 +-
 .../Model/Transactions/Transaction.h          |   8 +
 .../Transactions/TransactionDeserialize.cpp   |  44 +++--
 .../Operations/StartTransaction.cpp           |  39 +++--
 .../Operations/StopTransaction.cpp            |  54 +++++-
 tests/ChargingSessions.cpp                    | 162 ++++++++++++++++++
 tests/ConfigurationBehavior.cpp               |   2 +-
 16 files changed, 344 insertions(+), 41 deletions(-)

diff --git a/src/ArduinoOcpp/Core/Time.cpp b/src/ArduinoOcpp/Core/Time.cpp
index 86afbb90..cc086405 100644
--- a/src/ArduinoOcpp/Core/Time.cpp
+++ b/src/ArduinoOcpp/Core/Time.cpp
@@ -333,4 +333,12 @@ const Timestamp &Clock::now() {
     return currentTime;
 }
 
+Timestamp Clock::adjustPrebootTimestamp(const Timestamp& t) {
+    auto systemtime_in = t - Timestamp();
+    if (systemtime_in > (int) system_basetime / 1000) {
+        return ocpp_basetime;
+    }
+    return ocpp_basetime - ((int) (system_basetime / 1000) - systemtime_in);
+}
+
 }
diff --git a/src/ArduinoOcpp/Core/Time.h b/src/ArduinoOcpp/Core/Time.h
index 21ab36cd..6b586572 100644
--- a/src/ArduinoOcpp/Core/Time.h
+++ b/src/ArduinoOcpp/Core/Time.h
@@ -105,7 +105,7 @@ class Clock {
      * 
      * as generated in JavaScript by calling toJSON() on a Date object
      * 
-     * Only processes the first 19 characters. The subsequent are ignored until terminating 0.
+     * Only processes the first 23 characters. The subsequent are ignored
      * 
      * Has a semi-sophisticated type check included. Will return true on successful time set and false if
      * the given string is not a JSON Date string.
@@ -113,6 +113,13 @@ class Clock {
      * jsonDateString: 0-terminated string
      */
     bool setTime(const char* jsonDateString);
+
+    /*
+     * Timestamps which were taken before the Clock was initially set can be adjusted retrospectively. Two
+     * conditions must be true: the Clock was set in the meantime and the Timestamp was taken at the same
+     * run of this library. The caller must check this
+     */
+    Timestamp adjustPrebootTimestamp(const Timestamp& t);
 };
 
 }
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
index e3c9a330..9fa74fd6 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
@@ -55,7 +55,13 @@ AuthorizationService::~AuthorizationService() {
 bool AuthorizationService::loadLists() {
     if (!filesystem) {
         AO_DBG_WARN("no fs access");
-        return false;
+        return true;
+    }
+
+    size_t msize = 0;
+    if (filesystem->stat(AO_LOCALAUTHORIZATIONLIST_FN, &msize) != 0) {
+        AO_DBG_DEBUG("no local authorization list stored already");
+        return true;
     }
     
     auto doc = FilesystemUtils::loadJson(filesystem, AO_LOCALAUTHORIZATIONLIST_FN);
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index ea27de29..88ba1a29 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -239,6 +239,7 @@ void Connector::loop() {
 
                 if (transaction->getStartTimestamp() <= MIN_TIME) {
                     transaction->setStartTimestamp(model.getClock().now());
+                    transaction->setStartBootNr(model.getBootNr());
                 }
 
                 if (transaction->isSilent()) {
@@ -294,6 +295,7 @@ void Connector::loop() {
 
                 if (transaction->getStopTimestamp() <= MIN_TIME) {
                     transaction->setStopTimestamp(model.getClock().now());
+                    transaction->setStopBootNr(model.getBootNr());
                 }
 
                 transaction->commit();
@@ -578,7 +580,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     transaction->commit();
 
-    auto authorize = makeRequest(new Ocpp16::Authorize(context.getModel(), idTag));
+    auto authorize = makeRequest(new Authorize(context.getModel(), idTag));
     authorize->setTimeout(authorizationTimeout && *authorizationTimeout > 0 ? *authorizationTimeout * 1000UL : 20UL * 1000UL);
     auto tx = transaction;
     authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
diff --git a/src/ArduinoOcpp/Model/Metering/MeterValue.cpp b/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
index b05ef612..9d218be8 100644
--- a/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
@@ -6,8 +6,7 @@
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Debug.h>
 
-using ArduinoOcpp::MeterValue;
-using ArduinoOcpp::MeterValueBuilder;
+using namespace ArduinoOcpp;
 
 std::unique_ptr<DynamicJsonDocument> MeterValue::toJson() {
     size_t capacity = 0;
@@ -39,6 +38,24 @@ std::unique_ptr<DynamicJsonDocument> MeterValue::toJson() {
     return result;
 }
 
+const Timestamp& MeterValue::getTimestamp() {
+    return timestamp;
+}
+
+void MeterValue::setTimestamp(Timestamp timestamp) {
+    this->timestamp = timestamp;
+}
+
+ReadingContext MeterValue::getReadingContext() {
+    //all sampledValues have the same ReadingContext. Just get the first result
+    for (auto sample = sampledValue.begin(); sample != sampledValue.end(); sample++) {
+        if ((*sample)->getReadingContext() != ReadingContext::NOT_SET) {
+            return (*sample)->getReadingContext();
+        }
+    }
+    return ReadingContext::NOT_SET;
+}
+
 MeterValueBuilder::MeterValueBuilder(const std::vector<std::unique_ptr<SampledValueSampler>> &samplers,
             std::shared_ptr<Configuration<const char*>> samplers_select) :
             samplers(samplers),
diff --git a/src/ArduinoOcpp/Model/Metering/MeterValue.h b/src/ArduinoOcpp/Model/Metering/MeterValue.h
index 9a5505f7..5455c12f 100644
--- a/src/ArduinoOcpp/Model/Metering/MeterValue.h
+++ b/src/ArduinoOcpp/Model/Metering/MeterValue.h
@@ -25,6 +25,11 @@ class MeterValue {
     void addSampledValue(std::unique_ptr<SampledValue> sample) {sampledValue.push_back(std::move(sample));}
 
     std::unique_ptr<DynamicJsonDocument> toJson();
+
+    const Timestamp& getTimestamp();
+    void setTimestamp(Timestamp timestamp);
+
+    ReadingContext getReadingContext();
 };
 
 class MeterValueBuilder {
diff --git a/src/ArduinoOcpp/Model/Metering/SampledValue.cpp b/src/ArduinoOcpp/Model/Metering/SampledValue.cpp
index 43e92400..a934e83d 100644
--- a/src/ArduinoOcpp/Model/Metering/SampledValue.cpp
+++ b/src/ArduinoOcpp/Model/Metering/SampledValue.cpp
@@ -6,8 +6,7 @@
 #include <ArduinoOcpp/Debug.h>
 #include <cinttypes>
 
-using ArduinoOcpp::SampledValue;
-using ArduinoOcpp::SampledValueDeSerializer;
+using namespace ArduinoOcpp;
 
 int32_t SampledValueDeSerializer<int32_t>::deserialize(const char *str) {
     return strtol(str, nullptr, 10);
@@ -110,3 +109,7 @@ std::unique_ptr<DynamicJsonDocument> SampledValue::toJson() {
         payload["unit"] = properties.getUnit();
     return result;
 }
+
+ReadingContext SampledValue::getReadingContext() {
+    return context;
+}
diff --git a/src/ArduinoOcpp/Model/Metering/SampledValue.h b/src/ArduinoOcpp/Model/Metering/SampledValue.h
index 8153eaf5..80411fd2 100644
--- a/src/ArduinoOcpp/Model/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Model/Metering/SampledValue.h
@@ -90,6 +90,8 @@ class SampledValue {
 
     virtual operator bool() = 0;
     virtual int32_t toInteger() = 0;
+
+    ReadingContext getReadingContext();
 };
 
 template <class T, class DeSerializer>
diff --git a/src/ArduinoOcpp/Model/Model.cpp b/src/ArduinoOcpp/Model/Model.cpp
index d2285094..830cc855 100644
--- a/src/ArduinoOcpp/Model/Model.cpp
+++ b/src/ArduinoOcpp/Model/Model.cpp
@@ -19,7 +19,7 @@
 
 using namespace ArduinoOcpp;
 
-Model::Model() {
+Model::Model(uint16_t bootNr) : bootNr(bootNr) {
     
 }
 
@@ -168,3 +168,7 @@ ResetService *Model::getResetService() const {
 Clock& Model::getClock() {
     return clock;
 }
+
+uint16_t Model::getBootNr() {
+    return bootNr;
+}
diff --git a/src/ArduinoOcpp/Model/Model.h b/src/ArduinoOcpp/Model/Model.h
index c093cb72..1c190426 100644
--- a/src/ArduinoOcpp/Model/Model.h
+++ b/src/ArduinoOcpp/Model/Model.h
@@ -42,8 +42,10 @@ class Model {
 
     bool runTasks = false;
 
+    const uint16_t bootNr = 0; //each boot of this lib has a unique number
+
 public:
-    Model();
+    Model(uint16_t bootNr = 0);
     Model(const Model& rhs) = delete;
     ~Model();
 
@@ -88,6 +90,8 @@ class Model {
     ResetService *getResetService() const;
 
     Clock &getClock();
+
+    uint16_t getBootNr();
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.h b/src/ArduinoOcpp/Model/Transactions/Transaction.h
index f10d1c6b..77809df1 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.h
@@ -53,6 +53,7 @@ class Transaction {
     SendStatus start_sync;
     int32_t start_meter = -1;           //meterStart of StartTx
     Timestamp start_timestamp = MIN_TIME;      //timestamp of StartTx; can be set before actually initiating
+    uint16_t start_bootNr = 0;
     int transactionId = -1; //only valid if confirmed = true
 
     /*
@@ -62,6 +63,7 @@ class Transaction {
     char stop_idTag [IDTAG_LEN_MAX + 1] = {'\0'};
     int32_t stop_meter = -1;
     Timestamp stop_timestamp = MIN_TIME;
+    uint16_t stop_bootNr = 0;
     char stop_reason [REASON_LEN_MAX + 1] = {'\0'};
 
     /*
@@ -128,6 +130,9 @@ class Transaction {
     void setStartTimestamp(Timestamp timestamp) {start_timestamp = timestamp;}
     const Timestamp& getStartTimestamp() {return start_timestamp;}
 
+    void setStartBootNr(uint16_t bootNr) {start_bootNr = bootNr;} 
+    uint16_t getStartBootNr() {return start_bootNr;}
+
     void setTransactionId(int transactionId) {this->transactionId = transactionId;}
 
     SendStatus& getStopSync() {return stop_sync;}
@@ -142,6 +147,9 @@ class Transaction {
     void setStopTimestamp(Timestamp timestamp) {stop_timestamp = timestamp;}
     const Timestamp& getStopTimestamp() {return stop_timestamp;}
 
+    void setStopBootNr(uint16_t bootNr) {stop_bootNr = bootNr;} 
+    uint16_t getStopBootNr() {return stop_bootNr;}
+
     bool setStopReason(const char *reason);
     const char *getStopReason() {return stop_reason;}
 
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
index d58fb80e..27d75f69 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -2,6 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
+#include <limits>
+
 #include <ArduinoOcpp/Model/Transactions/TransactionDeserialize.h>
 #include <ArduinoOcpp/Debug.h>
 
@@ -66,11 +68,11 @@ bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
         txStart["meter"] = tx.getMeterStart();
     }
 
-    if (tx.getStartTimestamp() > MIN_TIME) {
-        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
-        tx.getStartTimestamp().toJsonString(timeStr, JSONDATE_LENGTH + 1);
-        txStart["timestamp"] = timeStr;
-    }
+    char startTimeStr [JSONDATE_LENGTH + 1] = {'\0'};
+    tx.getStartTimestamp().toJsonString(startTimeStr, JSONDATE_LENGTH + 1);
+    txStart["timestamp"] = startTimeStr;
+
+    txStart["bootNr"] = tx.getStartBootNr();
 
     if (tx.getStartSync().isConfirmed()) {
         txStart["transactionId"] = tx.getTransactionId();
@@ -90,11 +92,11 @@ bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
         txStop["meter"] = tx.getMeterStop();
     }
 
-    if (tx.getStopTimestamp() > MIN_TIME) {
-        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
-        tx.getStopTimestamp().toJsonString(timeStr, JSONDATE_LENGTH + 1);
-        txStop["timestamp"] = timeStr;
-    }
+    char stopTimeStr [JSONDATE_LENGTH + 1] = {'\0'};
+    tx.getStopTimestamp().toJsonString(stopTimeStr, JSONDATE_LENGTH + 1);
+    txStop["timestamp"] = stopTimeStr;
+    
+    txStop["bootNr"] = tx.getStopBootNr();
 
     if (tx.getStopReason()[0] != '\0') {
         txStop["reason"] = tx.getStopReason();
@@ -164,13 +166,23 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
 
     if (txStart.containsKey("timestamp")) {
         Timestamp timestamp;
-        if (!timestamp.setTime(sessionState["timestamp"] | "Invalid")) {
+        if (!timestamp.setTime(txStart["timestamp"] | "Invalid")) {
             AO_DBG_ERR("read err");
             return false;
         }
         tx.setStartTimestamp(timestamp);
     }
 
+    if (txStart.containsKey("bootNr")) {
+        int bootNrIn = txStart["bootNr"];
+        if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
+            tx.setStartBootNr((uint16_t) bootNrIn);
+        } else {
+            AO_DBG_ERR("read err");
+            return false;
+        }
+    }
+
     if (txStart.containsKey("transactionId")) {
         tx.setTransactionId(txStart["transactionId"] | -1);
     }
@@ -201,6 +213,16 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
         tx.setStopTimestamp(timestamp);
     }
 
+    if (txStop.containsKey("bootNr")) {
+        int bootNrIn = txStop["bootNr"];
+        if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
+            tx.setStopBootNr((uint16_t) bootNrIn);
+        } else {
+            AO_DBG_ERR("read err");
+            return false;
+        }
+    }
+
     if (txStop.containsKey("reason")) {
         if (!tx.setStopReason(txStop["reason"] | "")) {
             AO_DBG_ERR("read err");
diff --git a/src/ArduinoOcpp/Operations/StartTransaction.cpp b/src/ArduinoOcpp/Operations/StartTransaction.cpp
index ce21e1d3..8f1c3547 100644
--- a/src/ArduinoOcpp/Operations/StartTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/StartTransaction.cpp
@@ -85,6 +85,22 @@ bool StartTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
+    if (transaction->getStartTimestamp() < MIN_TIME &&
+            transaction->getStartBootNr() != model.getBootNr()) {
+        //time not set, cannot be restored anymore -> invalid tx
+        AO_DBG_ERR("cannot recover tx from previus run");
+
+        //clean up possible tx records
+        if (auto mSerivce = model.getMeteringService()) {
+            mSerivce->removeTxMeterData(connectorId, txNr);
+        }
+
+        transaction->setSilent();
+        transaction->setInactive();
+        transaction->commit();
+        return false;
+    }
+
     return true;
 }
 
@@ -98,25 +114,24 @@ std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
     JsonObject payload = doc->to<JsonObject>();
 
     payload["connectorId"] = transaction->getConnectorId();
-
-    if (transaction->getIdTag() && *transaction->getIdTag()) {
-        payload["idTag"] = (char*) transaction->getIdTag();
-    }
-
-    if (transaction->isMeterStartDefined()) {
-        payload["meterStart"] = transaction->getMeterStart();
-    }
+    payload["idTag"] = (char*) transaction->getIdTag();
+    payload["meterStart"] = transaction->getMeterStart();
 
     if (transaction->getReservationId() >= 0) {
         payload["reservationId"] = transaction->getReservationId();
     }
 
-    if (transaction->getStartTimestamp() > MIN_TIME) {
-        char timestamp[JSONDATE_LENGTH + 1] = {'\0'};
-        transaction->getStartTimestamp().toJsonString(timestamp, JSONDATE_LENGTH + 1);
-        payload["timestamp"] = timestamp;
+    if (transaction->getStartTimestamp() < MIN_TIME &&
+            transaction->getStartBootNr() == model.getBootNr()) {
+        AO_DBG_DEBUG("adjust preboot StartTx timestamp");
+        Timestamp adjusted = model.getClock().adjustPrebootTimestamp(transaction->getStartTimestamp());
+        transaction->setStartTimestamp(adjusted);
     }
 
+    char timestamp[JSONDATE_LENGTH + 1] = {'\0'};
+    transaction->getStartTimestamp().toJsonString(timestamp, JSONDATE_LENGTH + 1);
+    payload["timestamp"] = timestamp;
+
     return doc;
 }
 
diff --git a/src/ArduinoOcpp/Operations/StopTransaction.cpp b/src/ArduinoOcpp/Operations/StopTransaction.cpp
index 8b16d814..f92a8659 100644
--- a/src/ArduinoOcpp/Operations/StopTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/StopTransaction.cpp
@@ -87,6 +87,17 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
         return false;
     }
 
+    if (transaction->isSilent()) {
+        //transaction has been set silent after initializing StopTx - discard operation record
+        AO_DBG_WARN("tx has been set silent - discard StopTx");
+
+        //clean up possible tx records
+        if (auto mSerivce = model.getMeteringService()) {
+            mSerivce->removeTxMeterData(connectorId, txNr);
+        }
+        return false;
+    }
+
     if (auto mSerivce = model.getMeteringService()) {
         if (auto txData = mSerivce->getStopTxMeterData(transaction.get())) {
             transactionData = txData->retrieveStopTxData();
@@ -98,6 +109,37 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
 
 std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
+    /*
+     * Adjust timestamps in case they were taken before initial Clock setting
+     */
+    if (transaction->getStopTimestamp() < MIN_TIME) {
+        //Timestamp taken before Clock value defined. Determine timestamp
+        if (transaction->getStopBootNr() == model.getBootNr()) {
+            //possible to calculate real timestamp
+            Timestamp adjusted = model.getClock().adjustPrebootTimestamp(transaction->getStopTimestamp());
+            transaction->setStopTimestamp(adjusted);
+        } else if (transaction->getStartTimestamp() >= MIN_TIME) {
+            AO_DBG_WARN("set stopTime = startTime because correct time is not available");
+            transaction->setStopTimestamp(transaction->getStartTimestamp() + 1); //1s behind startTime to keep order in backend DB
+        } else {
+            AO_DBG_ERR("failed to determine StopTx timestamp");
+            (void)0; //send invalid value
+        }
+    }
+
+    for (auto mv = transactionData.begin(); mv != transactionData.end(); mv++) {
+        if ((*mv)->getTimestamp() < MIN_TIME) {
+            //time off. Try to adjust, otherwise send invalid value
+            if ((*mv)->getReadingContext() == ReadingContext::TransactionBegin) {
+                (*mv)->setTimestamp(transaction->getStartTimestamp());
+            } else if ((*mv)->getReadingContext() == ReadingContext::TransactionEnd) {
+                (*mv)->setTimestamp(transaction->getStopTimestamp());
+            } else {
+                (*mv)->setTimestamp(transaction->getStartTimestamp() + 1);
+            }
+        }
+    }
+
     std::vector<std::unique_ptr<DynamicJsonDocument>> txDataJson;
     size_t txDataJson_size = 0;
     for (auto mv = transactionData.begin(); mv != transactionData.end(); mv++) {
@@ -126,15 +168,11 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
         payload["idTag"] = (char*) transaction->getStopIdTag();
     }
 
-    if (transaction->isMeterStopDefined()) {
-        payload["meterStop"] = transaction->getMeterStop();
-    }
+    payload["meterStop"] = transaction->getMeterStop();
 
-    if (transaction->getStopTimestamp() > MIN_TIME) {
-        char timestamp [JSONDATE_LENGTH + 1] = {'\0'};
-        transaction->getStopTimestamp().toJsonString(timestamp, JSONDATE_LENGTH + 1);
-        payload["timestamp"] = timestamp;
-    }
+    char timestamp[JSONDATE_LENGTH + 1] = {'\0'};
+    transaction->getStopTimestamp().toJsonString(timestamp, JSONDATE_LENGTH + 1);
+    payload["timestamp"] = timestamp;
 
     payload["transactionId"] = transaction->getTransactionId();
     
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 9e8fc6b2..ed52cfa7 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -9,6 +9,8 @@
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
 using namespace ArduinoOcpp;
 
 
@@ -171,6 +173,166 @@ TEST_CASE( "Charging sessions" ) {
         loop();
     }
 
+    SECTION("Preboot transactions - tx before BootNotification") {
+        OCPP_deinitialize();
+
+        loopback.setConnected(false);
+        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        configuration_save();
+
+        loop();
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        REQUIRE(isTransactionRunning());
+
+        mtime += 3600 * 1000; //transaction duration ~1h
+
+        endTransaction();
+
+        loop();
+
+        mtime += 3600 * 1000; //set base time one hour later
+
+        bool checkStartProcessed = false;
+
+        getOcppContext()->getModel().getClock().setTime(BASE_TIME);
+        Timestamp basetime = Timestamp();
+        basetime.setTime(BASE_TIME);
+
+        getOcppContext()->getOperationRegistry().setOnRequest("StartTransaction", 
+            [&checkStartProcessed, basetime] (JsonObject payload) {
+                checkStartProcessed = true;
+                Timestamp timestamp;
+                timestamp.setTime(payload["timestamp"].as<const char*>());                
+
+                auto adjustmentDelay = basetime - timestamp;
+                REQUIRE((adjustmentDelay > 2 * 3600 - 10 && adjustmentDelay < 2 * 3600 + 10));
+            });
+        
+        bool checkStopProcessed = false;
+
+        getOcppContext()->getOperationRegistry().setOnRequest("StopTransaction", 
+            [&checkStopProcessed, basetime] (JsonObject payload) {
+                checkStopProcessed = true;
+                Timestamp timestamp;
+                timestamp.setTime(payload["timestamp"].as<const char*>());                
+
+                auto adjustmentDelay = basetime - timestamp;
+                REQUIRE((adjustmentDelay > 3600 - 10 && adjustmentDelay < 3600 + 10));
+            });
+        
+        loopback.setConnected(true);
+        loop();
+
+        REQUIRE(checkStartProcessed);
+        REQUIRE(checkStopProcessed);
+    }
+
+    SECTION("Preboot transactions - lose StartTx timestamp") {
+
+        OCPP_deinitialize();
+
+        loopback.setConnected(false);
+        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        configuration_save();
+
+        loop();
+
+        beginTransaction_authorized("mIdTag");
+        loop();
+
+        REQUIRE(isTransactionRunning());
+
+        OCPP_deinitialize();
+
+        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        configuration_save();
+
+        bool checkProcessed = false;
+
+        getOcppContext()->getOperationRegistry().setOnRequest("StartTransaction", [&checkProcessed] (JsonObject) {
+            checkProcessed = true;
+        });
+
+        getOcppContext()->getOperationRegistry().setOnRequest("StopTransaction", [&checkProcessed] (JsonObject) {
+            checkProcessed = true;
+        });
+
+        loopback.setConnected(true);
+
+        loop();
+
+        REQUIRE(!isTransactionRunning());
+        REQUIRE(!checkProcessed);
+    }
+
+    SECTION("Preboot transactions - lose StopTx timestamp") {
+        
+        const char *starTxTimestampStr = "2023-02-01T00:00:00.000Z";
+        getOcppContext()->getModel().getClock().setTime(starTxTimestampStr);
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        REQUIRE(isTransactionRunning());
+
+        OCPP_deinitialize();
+
+        loopback.setConnected(false);
+        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        configuration_save();
+
+        loop();
+
+        REQUIRE(isTransactionRunning());
+
+        endTransaction();
+
+        loop();
+
+        REQUIRE(!isTransactionRunning());
+
+        OCPP_deinitialize();
+
+        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        configuration_save();
+
+        bool checkProcessed = false;
+
+        getOcppContext()->getOperationRegistry().setOnRequest("StopTransaction",
+            [&checkProcessed, starTxTimestampStr] (JsonObject payload) {
+                checkProcessed = true;
+                Timestamp timestamp;
+                timestamp.setTime(payload["timestamp"].as<const char*>());
+
+                Timestamp starTxTimestamp = Timestamp();
+                starTxTimestamp.setTime(starTxTimestampStr);
+
+                auto adjustmentDelay = timestamp - starTxTimestamp;
+                REQUIRE(adjustmentDelay == 1);
+            });
+
+        loopback.setConnected(true);
+
+        loop();
+
+        REQUIRE(checkProcessed);
+    }
+
     OCPP_deinitialize();
 
 }
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index a08dfdbc..4d7da2b0 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -50,7 +50,7 @@ TEST_CASE( "Configuration Behavior" ) {
     //clean state
     auto filesystem = makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
     AO_DBG_DEBUG("remove all");
-    FilesystemUtils::remove_all(filesystem, "");
+    FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;

From 24da650fe31824d559c6d7c61c60d6a4843e5b65 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 24 Jun 2023 20:37:11 +0200
Subject: [PATCH 290/549] add tx notifications and refactor

---
 examples/ESP-IDF/main/main.c                  |   2 +-
 src/ArduinoOcpp.cpp                           |  22 ++-
 src/ArduinoOcpp.h                             |   6 +-
 .../Authorization/AuthorizationService.cpp    |   4 +-
 .../ChargeControl/ChargeControlCommon.cpp     |   2 +-
 ...OcppEvseState.h => ChargePointErrorCode.h} |  20 +--
 .../Model/ChargeControl/ChargePointStatus.h   |  25 +++
 .../Model/ChargeControl/Connector.cpp         | 149 ++++++++++--------
 .../Model/ChargeControl/Connector.h           |  23 ++-
 .../Model/ChargeControl/Notification.h        |  29 ++++
 .../Model/Reservation/ReservationService.cpp  |   6 +-
 src/ArduinoOcpp/Model/Reset/ResetService.cpp  |   4 +-
 .../SmartCharging/SmartChargingModel.cpp      |   4 +-
 .../Model/SmartCharging/SmartChargingModel.h  |   8 +-
 .../SmartCharging/SmartChargingService.cpp    |   4 +-
 .../Operations/ChangeAvailability.cpp         |   4 +-
 .../Operations/RemoteStartTransaction.cpp     |   5 +-
 src/ArduinoOcpp/Operations/ReserveNow.cpp     |  10 +-
 .../Operations/StatusNotification.cpp         |  30 ++--
 .../Operations/StatusNotification.h           |   9 +-
 src/ArduinoOcpp/Operations/TriggerMessage.cpp |   2 +-
 .../Operations/UnlockConnector.cpp            |   1 +
 src/ArduinoOcpp_c.cpp                         |   8 +-
 src/ArduinoOcpp_c.h                           |   2 -
 tests/ChargingSessions.cpp                    |  60 ++++++-
 tests/ConfigurationBehavior.cpp               |  30 ++--
 tests/SmartCharging.cpp                       |   2 +-
 27 files changed, 309 insertions(+), 162 deletions(-)
 rename src/ArduinoOcpp/Model/ChargeControl/{OcppEvseState.h => ChargePointErrorCode.h} (73%)
 create mode 100644 src/ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h
 create mode 100644 src/ArduinoOcpp/Model/ChargeControl/Notification.h

diff --git a/examples/ESP-IDF/main/main.c b/examples/ESP-IDF/main/main.c
index b32fcaf1..8da7040a 100644
--- a/examples/ESP-IDF/main/main.c
+++ b/examples/ESP-IDF/main/main.c
@@ -160,7 +160,7 @@ void app_main(void)
             EXAMPLE_AO_OCPP_BACKEND, 
             EXAMPLE_AO_CHARGEBOXID, 
             EXAMPLE_AO_AUTHORIZATIONKEY, "", fsopt);
-    ao_initialize(osock, 230.f /* European grid voltage */, fsopt);
+    ao_initialize(osock, fsopt);
 
     ao_bootNotification("ESP-IDF charger", "Your brand name here", NULL, NULL, NULL, NULL); //send first OCPP message
 
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index f86543c5..3c139489 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -56,7 +56,7 @@ using namespace ArduinoOcpp::Facade;
 using namespace ArduinoOcpp::Ocpp16;
 
 #ifndef AO_CUSTOM_WS
-void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, float V_eff, FilesystemOpt fsOpt) {
+void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt) {
     if (context) {
         AO_DBG_WARN("Can't be called two times. Either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -80,7 +80,7 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     delete connection;
     connection = new EspWiFi::WSClient(webSocket);
 
-    OCPP_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), V_eff, fsOpt);
+    OCPP_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), fsOpt);
 }
 #endif
 
@@ -118,7 +118,7 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
     }
 }
 
-void OCPP_initialize(Connection& connection, const char *bootNotificationCredentials, float V_eff, FilesystemOpt fsOpt) {
+void OCPP_initialize(Connection& connection, const char *bootNotificationCredentials, FilesystemOpt fsOpt) {
     if (context) {
         AO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call OCPP_deinitialize() before");
         return;
@@ -645,8 +645,7 @@ bool isOperative(unsigned int connectorId) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return true; //assume "true" as default state
     }
-    return (chargePoint->getAvailability() != AVAILABILITY_INOPERATIVE)
-       &&  (connector->getAvailability() != AVAILABILITY_INOPERATIVE);
+    return chargePoint->isOperative() && connector->isOperative();
 }
 
 std::shared_ptr<Transaction> ao_undefinedTx;
@@ -678,6 +677,19 @@ const char *getTransactionIdTag(unsigned int connectorId) {
     return tx ? tx->getIdTag() : nullptr;
 }
 
+void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId) {
+    if (!context) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    auto connector = context->getModel().getConnector(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+    connector->setTxNotificationOutput(notificationOutput);
+}
+
 bool isBlockedByReservation(const char *idTag, unsigned int connectorId) {
     if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index b4af1a72..99a77ddf 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -15,6 +15,7 @@
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Model/Metering/SampledValue.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/ChargeControl/Notification.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
 using ArduinoOcpp::OnReceiveReqListener;
@@ -88,7 +89,6 @@ struct ChargerCredentials {
 void OCPP_initialize(
             ArduinoOcpp::Connection& connection, //WebSocket adapter for ArduinoOcpp
             const char *bootNotificationCredentials = ChargerCredentials("Demo Charger", "My Company Ltd."), //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
-            float V_eff = 230.f,                 //Grid voltage of your country. e.g. 230.f (European voltage)
             ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 /*
@@ -242,7 +242,7 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId =
  * Access further information about the internal state of the library
  */
 
-bool isOperative(unsigned int connectorId = 1); //if the charge point is operative or inoperative (see OCPP1.6 Edit2, p. 45)
+bool isOperative(unsigned int connectorId = 1); //if the charge point is operative (see OCPP1.6 Edit2, p. 45) and ready for transactions
 
 /*
  * Returns the current transaction process. Returns nullptr if no transaction is running, preparing or finishing
@@ -266,6 +266,8 @@ std::shared_ptr<ArduinoOcpp::Transaction>& getTransaction(unsigned int connector
  */
 const char *getTransactionIdTag(unsigned int connectorId = 1);
 
+void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId = 1);
+
 bool isBlockedByReservation(const char *idTag, unsigned int connectorId = 1); //if the connector is already reserved for a different idTag
 
 /*
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
index 9fa74fd6..8333b49b 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
@@ -182,9 +182,9 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     if (!equivalent) {
         //send error code "LocalListConflict" to server
 
-        OcppEvseState cpStatus = OcppEvseState::NOT_SET;
+        ChargePointStatus cpStatus = ChargePointStatus::NOT_SET;
         if (context.getModel().getNumConnectors() > 0) {
-            cpStatus = context.getModel().getConnector(0)->inferenceStatus();
+            cpStatus = context.getModel().getConnector(0)->getStatus();
         }
 
         auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
index 8a1706c1..6c591108 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
@@ -86,7 +86,7 @@ ChargeControlCommon::ChargeControlCommon(Context& context, unsigned int numConn,
     context.getOperationRegistry().registerOperation("StartTransaction", [&context] () {
         return new Ocpp16::StartTransaction(context.getModel(), nullptr);});
     context.getOperationRegistry().registerOperation("StatusNotification", [&context] () {
-        return new Ocpp16::StatusNotification(-1, OcppEvseState::NOT_SET, Timestamp());});
+        return new Ocpp16::StatusNotification(-1, ChargePointStatus::NOT_SET, Timestamp());});
     context.getOperationRegistry().registerOperation("StopTransaction", [&context] () {
         return new Ocpp16::StopTransaction(context.getModel(), nullptr);});
 }
diff --git a/src/ArduinoOcpp/Model/ChargeControl/OcppEvseState.h b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h
similarity index 73%
rename from src/ArduinoOcpp/Model/ChargeControl/OcppEvseState.h
rename to src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h
index 1bd7db24..40fb6beb 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/OcppEvseState.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h
@@ -2,24 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef OCPP_EVSE_STATE
-#define OCPP_EVSE_STATE
+#ifndef AO_CHARGEPOINTERRORCODE_H
+#define AO_CHARGEPOINTERRORCODE_H
 
 namespace ArduinoOcpp {
 
-enum class OcppEvseState {
-    Available,
-    Preparing,
-    Charging,
-    SuspendedEVSE,
-    SuspendedEV,
-    Finishing,
-    Reserved,
-    Unavailable,
-    Faulted,
-    NOT_SET //internal value for "undefined"
-};
-
 struct ErrorCode {
     bool isError = false; //if any error information is set
     bool isFaulted = false; //if this is a severe error and the EVSE should go into the faulted state
@@ -38,5 +25,6 @@ struct ErrorCode {
     }
 };
 
-} //end namespace ArduinoOcpp
+}
+
 #endif
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h b/src/ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h
new file mode 100644
index 00000000..3504a8c0
--- /dev/null
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h
@@ -0,0 +1,25 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef OCPP_EVSE_STATE
+#define OCPP_EVSE_STATE
+
+namespace ArduinoOcpp {
+
+enum class ChargePointStatus {
+    Available,
+    Preparing,
+    Charging,
+    SuspendedEVSE,
+    SuspendedEV,
+    Finishing,
+    Reserved,
+    Unavailable,
+    Faulted,
+    NOT_SET //internal value for "undefined"
+};
+
+} //end namespace ArduinoOcpp
+
+#endif
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index 88ba1a29..e241b20b 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -32,7 +32,7 @@ Connector::Connector(Context& context, int connectorId)
 
     char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
     snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, "AO_AVAIL_CONN_%d", connectorId);
-    availability = declareConfiguration<int>(availabilityKey, AVAILABILITY_OPERATIVE, AO_KEYVALUE_FN, false, false, true, false);
+    availability = declareConfiguration<bool>(availabilityKey, true, AO_KEYVALUE_FN, false, false, true, false);
 
     connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN, true, true, true, false);
     minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
@@ -64,60 +64,60 @@ Connector::Connector(Context& context, int connectorId)
     }
 }
 
-OcppEvseState Connector::inferenceStatus() {
+ChargePointStatus Connector::getStatus() {
     /*
     * Handle special case: This is the Connector for the whole CP (i.e. connectorId=0) --> only states Available, Unavailable, Faulted are possible
     */
     if (connectorId == 0) {
         if (isFaulted()) {
-            return OcppEvseState::Faulted;
-        } else if (getAvailability() == AVAILABILITY_INOPERATIVE) {
-            return OcppEvseState::Unavailable;
+            return ChargePointStatus::Faulted;
+        } else if (!isOperative()) {
+            return ChargePointStatus::Unavailable;
         } else {
-            return OcppEvseState::Available;
+            return ChargePointStatus::Available;
         }
     }
 
     if (isFaulted()) {
-        return OcppEvseState::Faulted;
-    } else if (getAvailability() == AVAILABILITY_INOPERATIVE) {
-        return OcppEvseState::Unavailable;
+        return ChargePointStatus::Faulted;
+    } else if (!isOperative()) {
+        return ChargePointStatus::Unavailable;
     } else if (transaction && transaction->isRunning()) {
         //Transaction is currently running
         if (connectorPluggedSampler && !connectorPluggedSampler()) { //special case when StopTransactionOnEVSideDisconnect is false
-            return OcppEvseState::SuspendedEV;
+            return ChargePointStatus::SuspendedEV;
         }
         if (!ocppPermitsCharge() ||
                 (connectorEnergizedSampler && !connectorEnergizedSampler())) { 
-            return OcppEvseState::SuspendedEVSE;
+            return ChargePointStatus::SuspendedEVSE;
         }
         if (evRequestsEnergySampler && !evRequestsEnergySampler()) {
-            return OcppEvseState::SuspendedEV;
+            return ChargePointStatus::SuspendedEV;
         }
-        return OcppEvseState::Charging;
+        return ChargePointStatus::Charging;
     } else if (model.getReservationService() && model.getReservationService()->getReservation(connectorId)) {
-        return OcppEvseState::Reserved;
+        return ChargePointStatus::Reserved;
     } else if ((!transaction || !transaction->isActive()) &&                 //no transaction preparation
                (!connectorPluggedSampler || !connectorPluggedSampler()) &&   //no vehicle plugged
                (!occupiedInput || !occupiedInput())) {                       //occupied override clear
-        return OcppEvseState::Available;
+        return ChargePointStatus::Available;
     } else {
         /*
          * Either in Preparing or Finishing state. Only way to know is from previous state
          */
         const auto previous = currentStatus;
-        if (previous == OcppEvseState::Finishing ||
-                previous == OcppEvseState::Charging ||
-                previous == OcppEvseState::SuspendedEV ||
-                previous == OcppEvseState::SuspendedEVSE) {
-            return OcppEvseState::Finishing;
+        if (previous == ChargePointStatus::Finishing ||
+                previous == ChargePointStatus::Charging ||
+                previous == ChargePointStatus::SuspendedEV ||
+                previous == ChargePointStatus::SuspendedEVSE) {
+            return ChargePointStatus::Finishing;
         } else {
-            return OcppEvseState::Preparing;
+            return ChargePointStatus::Preparing;
         }
     }
 
-    AO_DBG_VERBOSE("Cannot infere status");
-    return OcppEvseState::Faulted; //internal error
+    AO_DBG_DEBUG("status undefined");
+    return ChargePointStatus::Faulted; //internal error
 }
 
 bool Connector::ocppPermitsCharge() {
@@ -142,14 +142,8 @@ bool Connector::ocppPermitsCharge() {
 
 void Connector::loop() {
 
-    if (!transaction || !transaction->isRunning()) {
-        if (*availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
-            *availability = AVAILABILITY_INOPERATIVE;
-            configuration_save();
-        }
-        if (availabilityVolatile == AVAILABILITY_INOPERATIVE_SCHEDULED) {
-            availabilityVolatile = AVAILABILITY_INOPERATIVE;
-        }
+    if (!trackLoopExecute) {
+        trackLoopExecute = true;
     }
 
     if (transaction && transaction->isAborted()) {
@@ -199,6 +193,8 @@ void Connector::loop() {
             AO_DBG_INFO("Session mngt: timeout");
             transaction->setInactive();
             transaction->commit();
+
+            updateTxNotification(TxNotification::ConnectionTimeout);
         }
 
         if (transaction->isActive() &&
@@ -221,7 +217,7 @@ void Connector::loop() {
 
             if (transaction->isActive() && transaction->isAuthorized() &&  //tx must be authorized
                     (!connectorPluggedSampler || connectorPluggedSampler()) && //if applicable, connector must be plugged
-                    !isFaulted() && //only start tx if charger is free of error conditions
+                    isOperative() && //only start tx if charger is free of error conditions
                     (!startTxReadyInput || startTxReadyInput())) { //if defined, user Input for allowing StartTx must be true
                 //start Transaction
 
@@ -242,6 +238,8 @@ void Connector::loop() {
                     transaction->setStartBootNr(model.getBootNr());
                 }
 
+                updateTxNotification(TxNotification::StartTx);
+
                 if (transaction->isSilent()) {
                     AO_DBG_INFO("silent Transaction: omit StartTx");
                     transaction->getStartSync().setRequested();
@@ -258,6 +256,14 @@ void Connector::loop() {
 
                 auto startTx = makeRequest(new StartTransaction(model, transaction));
                 startTx->setTimeout(0);
+                startTx->setOnReceiveConfListener([this] (JsonObject response) {
+                    //fetch authorization status from StartTransaction.conf() for user notification
+
+                    const char* idTagInfoStatus = response["idTagInfo"]["status"] | "_Undefined";
+                    if (strcmp(idTagInfoStatus, "Accepted")) {
+                        updateTxNotification(TxNotification::DeAuthorized);
+                    }
+                });
                 context.initiateRequest(std::move(startTx));
                 return;
             }
@@ -272,6 +278,7 @@ void Connector::loop() {
 
                 if (transaction->isSilent()) {
                     AO_DBG_INFO("silent Transaction: omit StopTx");
+                    updateTxNotification(TxNotification::StopTx);
                     transaction->getStopSync().setRequested();
                     transaction->getStopSync().confirm();
                     if (auto mService = model.getMeteringService()) {
@@ -300,6 +307,8 @@ void Connector::loop() {
 
                 transaction->commit();
 
+                updateTxNotification(TxNotification::StopTx);
+
                 std::shared_ptr<TransactionMeterData> stopTxData;
 
                 if (meteringService) {
@@ -339,7 +348,7 @@ void Connector::loop() {
         freeVendTrackPlugged = connectorPluggedSampler();
     }
 
-    auto inferedStatus = inferenceStatus();
+    auto status = getStatus();
 
     for (auto i = std::min(errorCodeInputs.size(), trackErrorCodeInputs.size()); i >= 1; i--) {
         auto index = i - 1;
@@ -347,12 +356,12 @@ void Connector::loop() {
         if (error.isError && !trackErrorCodeInputs[index]) {
             //new error
             auto statusNotification = makeRequest(
-                    new StatusNotification(connectorId, inferedStatus, model.getClock().now(), error));
+                    new StatusNotification(connectorId, status, model.getClock().now(), error));
             statusNotification->setTimeout(0);
             context.initiateRequest(std::move(statusNotification));
 
-            currentStatus = inferedStatus;
-            reportedStatus = inferedStatus;
+            currentStatus = status;
+            reportedStatus = status;
             trackErrorCodeInputs[index] = true;
         } else if (!error.isError && trackErrorCodeInputs[index]) {
             //reset error
@@ -360,8 +369,8 @@ void Connector::loop() {
         }
     }
     
-    if (inferedStatus != currentStatus) {
-        currentStatus = inferedStatus;
+    if (status != currentStatus) {
+        currentStatus = status;
         t_statusTransition = ao_tick_ms();
         AO_DBG_DEBUG("Status changed%s", *minimumStatusDuration ? ", will report delayed" : "");
     }
@@ -575,6 +584,8 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             AO_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
 
             transaction->setAuthorized();
+
+            updateTxNotification(TxNotification::Authorized);
         }
     }
 
@@ -591,6 +602,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             AO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->getIdTag());
             tx->setIdTagDeauthorized();
             tx->commit();
+            updateTxNotification(TxNotification::AuthorizationRejected);
             return;
         }
 
@@ -606,6 +618,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                 AO_DBG_INFO("connector %u reserved - abort transaction", connectorId);
                 tx->setInactive();
                 tx->commit();
+                updateTxNotification(TxNotification::ReservationConflict);
                 return;
             }
         }
@@ -613,6 +626,8 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         AO_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
         tx->setAuthorized();
         tx->commit();
+
+        updateTxNotification(TxNotification::Authorized);
     });
     authorize->setOnTimeoutListener([this, tx, localAuth, expiredLocalAuth] () {
 
@@ -621,6 +636,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             AO_DBG_DEBUG("Abort transaction process (%s), timeout, expired local auth", tx->getIdTag());
             tx->setInactive();
             tx->commit();
+            updateTxNotification(TxNotification::AuthorizationTimeout);
             return;
         }
         
@@ -628,6 +644,8 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             AO_DBG_DEBUG("Offline transaction process (%s), locally authorized", tx->getIdTag());
             tx->setAuthorized();
             tx->commit();
+
+            updateTxNotification(TxNotification::Authorized);
             return;
         }
 
@@ -641,6 +659,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                 AO_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
                 tx->setInactive();
                 tx->commit();
+                updateTxNotification(TxNotification::ReservationConflict);
                 return;
             }
         }
@@ -649,12 +668,14 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             AO_DBG_DEBUG("Offline transaction process (%s), allow unknown ID", tx->getIdTag());
             tx->setAuthorized();
             tx->commit();
+            updateTxNotification(TxNotification::Authorized);
             return;
         }
         
         AO_DBG_DEBUG("Abort transaction process (%s): timeout", tx->getIdTag());
         tx->setInactive();
         tx->commit();
+        updateTxNotification(TxNotification::AuthorizationTimeout);
         return; //offline tx disabled
     });
     context.initiateRequest(std::move(authorize));
@@ -697,6 +718,8 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
         }
     }
 
+    updateTxNotification(TxNotification::Authorized);
+
     transaction->commit();
 
     return transaction;
@@ -755,39 +778,29 @@ std::shared_ptr<Transaction>& Connector::getTransaction() {
     return transaction;
 }
 
-int Connector::getAvailability() {
-    if (availabilityVolatile == AVAILABILITY_INOPERATIVE || *availability == AVAILABILITY_INOPERATIVE) {
-        return AVAILABILITY_INOPERATIVE;
-    } else if (availabilityVolatile == AVAILABILITY_INOPERATIVE_SCHEDULED || *availability == AVAILABILITY_INOPERATIVE_SCHEDULED) {
-        return AVAILABILITY_INOPERATIVE_SCHEDULED;
-    } else {
-        return AVAILABILITY_OPERATIVE;
+bool Connector::isOperative() {
+    if (isFaulted()) {
+        return false;
+    }
+
+    if (!trackLoopExecute) {
+        return false;
     }
+
+    if (transaction && transaction->isRunning()) {
+        return true;
+    }
+
+    return availabilityVolatile && *availability;
 }
 
 void Connector::setAvailability(bool available) {
-    if (available) {
-        *availability = AVAILABILITY_OPERATIVE;
-    } else {
-        if (transaction && transaction->isRunning()) {
-            *availability = AVAILABILITY_INOPERATIVE_SCHEDULED;
-        } else {
-            *availability = AVAILABILITY_INOPERATIVE;
-        }
-    }
+    *availability = available;
     configuration_save();
 }
 
 void Connector::setAvailabilityVolatile(bool available) {
-    if (available) {
-        availabilityVolatile = AVAILABILITY_OPERATIVE;
-    } else {
-        if (!transaction || !transaction->isRunning()) {
-            availabilityVolatile = AVAILABILITY_INOPERATIVE_SCHEDULED;
-        } else {
-            availabilityVolatile = AVAILABILITY_INOPERATIVE;
-        }
-    }
+    availabilityVolatile = available;
 }
 
 void Connector::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
@@ -832,3 +845,13 @@ void Connector::setStopTxReadyInput(std::function<bool()> stopTxReady) {
 void Connector::setOccupiedInput(std::function<bool()> occupied) {
     this->occupiedInput = occupied;
 }
+
+void Connector::setTxNotificationOutput(std::function<void(TxNotification, Transaction*)> txNotificationOutput) {
+    this->txNotificationOutput = txNotificationOutput;
+}
+
+void Connector::updateTxNotification(TxNotification event) {
+    if (txNotificationOutput) {
+        txNotificationOutput(event, transaction.get());
+    }
+}
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index a69a6ac8..829080ef 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -5,7 +5,9 @@
 #ifndef CONNECTOR_H
 #define CONNECTOR_H
 
-#include <ArduinoOcpp/Model/ChargeControl/OcppEvseState.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
+#include <ArduinoOcpp/Model/ChargeControl/Notification.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Operations/CiStrings.h>
@@ -34,8 +36,8 @@ class Connector {
 
     std::shared_ptr<Transaction> transaction;
 
-    std::shared_ptr<Configuration<int>> availability;
-    int availabilityVolatile = AVAILABILITY_OPERATIVE;
+    std::shared_ptr<Configuration<bool>> availability;
+    bool availabilityVolatile = true;
 
     std::function<bool()> connectorPluggedSampler;
     std::function<bool()> evRequestsEnergySampler;
@@ -45,9 +47,9 @@ class Connector {
     bool isFaulted();
     const char *getErrorCode();
 
-    OcppEvseState currentStatus = OcppEvseState::NOT_SET;
+    ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
     std::shared_ptr<Configuration<int>> minimumStatusDuration; //in seconds
-    OcppEvseState reportedStatus = OcppEvseState::NOT_SET;
+    ChargePointStatus reportedStatus = ChargePointStatus::NOT_SET;
     unsigned long t_statusTransition = 0;
 
     std::function<PollResult<bool>()> onUnlockConnector;
@@ -56,6 +58,8 @@ class Connector {
     std::function<bool()> stopTxReadyInput; //the StopTx request will be delayed while this Input is false
     std::function<bool()> occupiedInput; //instead of Available, go into Preparing / Finishing state
 
+    std::function<void(TxNotification,Transaction*)> txNotificationOutput;
+
     std::shared_ptr<Configuration<int>> connectionTimeOut; //in seconds
     std::shared_ptr<Configuration<bool>> stopTransactionOnInvalidId;
     std::shared_ptr<Configuration<bool>> stopTransactionOnEVSideDisconnect;
@@ -68,6 +72,8 @@ class Connector {
     std::shared_ptr<Configuration<bool>> freeVendActive;
     std::shared_ptr<Configuration<const char*>> freeVendIdTag;
     bool freeVendTrackPlugged = false;
+
+    bool trackLoopExecute = false; //if loop has been executed once
 public:
     Connector(Context& context, int connectorId);
     Connector(Connector&& other) = default;
@@ -96,7 +102,7 @@ class Connector {
     //create detached transaction - won't have any side-effects with the transaction handling of this lib
     std::shared_ptr<Transaction> allocateTransaction(); 
 
-    int getAvailability();
+    bool isOperative();
     void setAvailability(bool available);
     void setAvailabilityVolatile(bool available); //set inoperative state but keep only until reboot at most
     void setAuthorizationProvider(std::function<const char *()> authorization);
@@ -108,7 +114,7 @@ class Connector {
 
     void loop();
 
-    OcppEvseState inferenceStatus();
+    ChargePointStatus getStatus();
 
     bool ocppPermitsCharge();
 
@@ -118,6 +124,9 @@ class Connector {
     void setStartTxReadyInput(std::function<bool()> startTxReady);
     void setStopTxReadyInput(std::function<bool()> stopTxReady);
     void setOccupiedInput(std::function<bool()> occupied);
+
+    void setTxNotificationOutput(std::function<void(TxNotification, Transaction*)> txNotificationOutput);
+    void updateTxNotification(TxNotification event);
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Notification.h b/src/ArduinoOcpp/Model/ChargeControl/Notification.h
new file mode 100644
index 00000000..1e5ca6f8
--- /dev/null
+++ b/src/ArduinoOcpp/Model/ChargeControl/Notification.h
@@ -0,0 +1,29 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef AO_NOTIFICATION_H
+#define AO_NOTIFICATION_H
+
+namespace ArduinoOcpp {
+
+enum class TxNotification {
+    //Authorization events
+    Authorized, //success
+    AuthorizationRejected, //IdTag not authorized
+    AuthorizationTimeout, //authorization failed - offline
+    ReservationConflict, //connector reserved for other IdTag
+
+    ConnectionTimeout, //user took to long to plug vehicle after the authorization
+    DeAuthorized, //server rejected StartTx
+    RemoteStart, //authorized via RemoteStartTransaction
+    RemoteStop, //stopped via RemoteStopTransaction
+
+    //Tx lifecycle events
+    StartTx,
+    StopTx,
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
index 457b5712..d7075c7e 100644
--- a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
@@ -52,8 +52,8 @@ void ReservationService::loop() {
         if (auto connector = context.getModel().getConnector(reservation.getConnectorId())) {
 
             //check if connector went inoperative
-            auto cStatus = connector->inferenceStatus();
-            if (cStatus == OcppEvseState::Faulted || cStatus == OcppEvseState::Unavailable) {
+            auto cStatus = connector->getStatus();
+            if (cStatus == ChargePointStatus::Faulted || cStatus == ChargePointStatus::Unavailable) {
                 reservation.clear();
                 continue;
             }
@@ -164,7 +164,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
             continue;
         }
         if (auto connector = context.getModel().getConnector(cId)) {
-            if (connector->inferenceStatus() == OcppEvseState::Available) {
+            if (connector->getStatus() == ChargePointStatus::Available) {
                 availableCount++;
             }
         }
diff --git a/src/ArduinoOcpp/Model/Reset/ResetService.cpp b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
index 637b23f5..2066108b 100644
--- a/src/ArduinoOcpp/Model/Reset/ResetService.cpp
+++ b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
@@ -56,9 +56,9 @@ void ResetService::loop() {
                 connector->setAvailabilityVolatile(true);
             }
 
-            OcppEvseState cpStatus = OcppEvseState::NOT_SET;
+            ChargePointStatus cpStatus = ChargePointStatus::NOT_SET;
             if (context.getModel().getNumConnectors() > 0) {
-                cpStatus = context.getModel().getConnector(0)->inferenceStatus();
+                cpStatus = context.getModel().getConnector(0)->getStatus();
             }
 
             auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
index af1fe1a3..d0904bab 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -73,7 +73,7 @@ bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &start
     if (duration > 0){
         //duration is set
 
-        //check if duration is exceeded and if yes, abort inferencing limit
+        //check if duration is exceeded and if yes, abort limit algorithm
         //if no, the duration is an upper limit for the validity of the schedule
         if (t_toBasis >= duration) { //"duration" is given relative to basis
             return false;
@@ -87,7 +87,7 @@ bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &start
     * and make nextChange equal the beginning of the following period. If the right period is the last one, nextChange
     * will remain the time determined before.
     */
-    float limit_res = -1.0f; //If limit_res is still -1 after the loop, the inference process failed
+    float limit_res = -1.0f; //If limit_res is still -1 after the loop, the limit algorithm failed
     int nphases_res = -1;
     for (auto period = chargingSchedulePeriod.begin(); period != chargingSchedulePeriod.end(); period++) {
         if (period->startPeriod > t_toBasis) {
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h
index f4084da5..46071c61 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h
@@ -75,8 +75,8 @@ class ChargingSchedule {
     std::vector<ChargingSchedulePeriod> chargingSchedulePeriod;
     float minChargingRate = -1.0f;
 
-    ChargingProfileKindType chargingProfileKind; //copied from ChargingProfile to increase cohesion of limit inferencing methods
-    RecurrencyKindType recurrencyKind = RecurrencyKindType::NOT_SET; //copied from ChargingProfile to increase cohesion of limit inferencing methods
+    ChargingProfileKindType chargingProfileKind; //copied from ChargingProfile to increase cohesion of limit algorithms
+    RecurrencyKindType recurrencyKind = RecurrencyKindType::NOT_SET; //copied from ChargingProfile to increase cohesion of limit algorithms
 
     /**
      * limit: output parameter
@@ -102,7 +102,7 @@ class ChargingProfile {
     int transactionId = -1;
     int stackLevel = 0;
     ChargingProfilePurposeType chargingProfilePurpose {ChargingProfilePurposeType::TxProfile};
-    ChargingProfileKindType chargingProfileKind {ChargingProfileKindType::Relative}; //copied to ChargingSchedule to increase cohesion of limit inferencing methods
+    ChargingProfileKindType chargingProfileKind {ChargingProfileKindType::Relative}; //copied to ChargingSchedule to increase cohesion of limit algorithms
     RecurrencyKindType recurrencyKind {RecurrencyKindType::NOT_SET}; // copied to ChargingSchedule to increase cohesion
     Timestamp validFrom;
     Timestamp validTo;
@@ -119,7 +119,7 @@ class ChargingProfile {
     bool calculateLimit(const Timestamp &t, const Timestamp &startOfCharging, ChargeRate& limit, Timestamp& nextChange);
 
     /*
-    * Simpler function if startOfCharging is not available. Caution: This likely will differ from inference with startOfCharging
+    * Simpler function if startOfCharging is not available. Caution: This likely will differ from function with startOfCharging
     */
     bool calculateLimit(const Timestamp &t, ChargeRate& limit, Timestamp& nextChange);
 
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
index 6f1afd26..b424bc76 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -401,7 +401,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
     }
 
     /**
-     * Invalidate the last limit inference by setting the nextChange to now. By the next loop()-call, the limit
+     * Invalidate the last limit by setting the nextChange to now. By the next loop()-call, the limit
      * and nextChange will be recalculated and onLimitChanged will be called.
      */
     if (res) {
@@ -620,7 +620,7 @@ bool SmartChargingService::clearChargingProfile(std::function<bool(int, int, Cha
     }
 
     /**
-     * Invalidate the last limit inference by setting the nextChange to now. By the next loop()-call, the limit
+     * Invalidate the last limit by setting the nextChange to now. By the next loop()-call, the limit
      * and nextChange will be recalculated and onLimitChanged will be called.
      */
     nextChange = context.getModel().getClock().now();
diff --git a/src/ArduinoOcpp/Operations/ChangeAvailability.cpp b/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
index c9b12f7f..0e7a785a 100644
--- a/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
+++ b/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
@@ -48,14 +48,14 @@ void ChangeAvailability::processReq(JsonObject payload) {
         for (unsigned int cId = 0; cId < model.getNumConnectors(); cId++) {
             auto connector = model.getConnector(cId);
             connector->setAvailability(available);
-            if (connector->getAvailability() == AVAILABILITY_INOPERATIVE_SCHEDULED) {
+            if (connector->isOperative() && !available) {
                 scheduled = true;
             }
         }
     } else {
         auto connector = model.getConnector(connectorId);
         connector->setAvailability(available);
-        if (connector->getAvailability() == AVAILABILITY_INOPERATIVE_SCHEDULED) {
+        if (connector->isOperative() && !available) {
             scheduled = true;
         }
     }
diff --git a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
index d81bd4a9..4513c941 100644
--- a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
@@ -73,7 +73,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         //connectorId specified for given connector, try to start Transaction here
         if (auto connector = model.getConnector(connectorId)){
             if (connector->getTransactionId() < 0 &&
-                        connector->getAvailability() == AVAILABILITY_OPERATIVE &&
+                        connector->isOperative() &&
                         !connector->getTransaction()) {
                 selectConnector = connector;
             }
@@ -83,7 +83,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         for (unsigned int cid = 1; cid < model.getNumConnectors(); cid++) {
             auto connector = model.getConnector(cid);
             if (connector->getTransactionId() < 0 && 
-                        connector->getAvailability() == AVAILABILITY_OPERATIVE &&
+                        connector->isOperative() &&
                         !connector->getTransaction()) {
                 selectConnector = connector;
                 connectorId = cid;
@@ -105,6 +105,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
 
         if (success) {
             auto tx = selectConnector->beginTransaction_authorized(idTag);
+            selectConnector->updateTxNotification(TxNotification::RemoteStart);
             if (tx) {
                 if (chargingProfileId >= 0) {
                     tx->setTxProfileId(chargingProfileId);
diff --git a/src/ArduinoOcpp/Operations/ReserveNow.cpp b/src/ArduinoOcpp/Operations/ReserveNow.cpp
index d4840bea..60d9e70d 100644
--- a/src/ArduinoOcpp/Operations/ReserveNow.cpp
+++ b/src/ArduinoOcpp/Operations/ReserveNow.cpp
@@ -70,19 +70,19 @@ void ReserveNow::processReq(JsonObject payload) {
             connector = model.getConnector(connectorId);
         }
 
-        if (chargePoint->inferenceStatus() == OcppEvseState::Faulted ||
-                (connector && connector->inferenceStatus() == OcppEvseState::Faulted)) {
+        if (chargePoint->getStatus() == ChargePointStatus::Faulted ||
+                (connector && connector->getStatus() == ChargePointStatus::Faulted)) {
             reservationStatus = "Faulted";
             return;
         }
 
-        if (chargePoint->getAvailability() != AVAILABILITY_OPERATIVE ||
-                (connector && connector->getAvailability() == AVAILABILITY_INOPERATIVE)) {
+        if (chargePoint->getStatus() == ChargePointStatus::Unavailable ||
+                (connector && connector->getStatus() == ChargePointStatus::Unavailable)) {
             reservationStatus = "Unavailable";
             return;
         }
 
-        if (connector && connector->inferenceStatus() != OcppEvseState::Available) {
+        if (connector && connector->getStatus() != ChargePointStatus::Available) {
             reservationStatus = "Occupied";
             return;
         }
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.cpp b/src/ArduinoOcpp/Operations/StatusNotification.cpp
index 238a0f4d..c078c955 100644
--- a/src/ArduinoOcpp/Operations/StatusNotification.cpp
+++ b/src/ArduinoOcpp/Operations/StatusNotification.cpp
@@ -13,37 +13,37 @@ using ArduinoOcpp::Ocpp16::StatusNotification;
 //helper function
 namespace ArduinoOcpp {
 namespace Ocpp16 {
-const char *cstrFromOcppEveState(OcppEvseState state) {
+const char *cstrFromOcppEveState(ChargePointStatus state) {
     switch (state) {
-        case (OcppEvseState::Available):
+        case (ChargePointStatus::Available):
             return "Available";
-        case (OcppEvseState::Preparing):
+        case (ChargePointStatus::Preparing):
             return "Preparing";
-        case (OcppEvseState::Charging):
+        case (ChargePointStatus::Charging):
             return "Charging";
-        case (OcppEvseState::SuspendedEVSE):
+        case (ChargePointStatus::SuspendedEVSE):
             return "SuspendedEVSE";
-        case (OcppEvseState::SuspendedEV):
+        case (ChargePointStatus::SuspendedEV):
             return "SuspendedEV";
-        case (OcppEvseState::Finishing):
+        case (ChargePointStatus::Finishing):
             return "Finishing";
-        case (OcppEvseState::Reserved):
+        case (ChargePointStatus::Reserved):
             return "Reserved";
-        case (OcppEvseState::Unavailable):
+        case (ChargePointStatus::Unavailable):
             return "Unavailable";
-        case (OcppEvseState::Faulted):
+        case (ChargePointStatus::Faulted):
             return "Faulted";
         default:
-            AO_DBG_ERR("OcppEvseState not specified");
+            AO_DBG_ERR("ChargePointStatus not specified");
             (void)0;
             /* fall through */
-        case (OcppEvseState::NOT_SET):
+        case (ChargePointStatus::NOT_SET):
             return "NOT_SET";
     }
 }
 }} //end namespaces
 
-StatusNotification::StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, ErrorCode errorCode)
+StatusNotification::StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorCode errorCode)
         : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorCode(errorCode) {
     
     AO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
@@ -53,7 +53,7 @@ const char* StatusNotification::getOperationType(){
     return "StatusNotification";
 }
 
-//TODO if the status has changed again when sendReq() is called, abort the operation completely (note: if req is already sent, stick with listening to conf). The OcppEvseStateService will enqueue a new operation itself
+//TODO if the status has changed again when sendReq() is called, abort the operation completely (note: if req is already sent, stick with listening to conf). The ChargePointStatusService will enqueue a new operation itself
 std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(7) + (JSONDATE_LENGTH + 1)));
     JsonObject payload = doc->to<JsonObject>();
@@ -72,7 +72,7 @@ std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
         if (errorCode.vendorErrorCode) {
             payload["vendorErrorCode"] = errorCode.vendorErrorCode;
         }
-    } else if (currentStatus == OcppEvseState::NOT_SET) {
+    } else if (currentStatus == ChargePointStatus::NOT_SET) {
         AO_DBG_ERR("Reporting undefined status");
         payload["errorCode"] = "InternalError";
     } else {
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.h b/src/ArduinoOcpp/Operations/StatusNotification.h
index 16b86491..4aef15d7 100644
--- a/src/ArduinoOcpp/Operations/StatusNotification.h
+++ b/src/ArduinoOcpp/Operations/StatusNotification.h
@@ -7,7 +7,8 @@
 
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Model/ChargeControl/OcppEvseState.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
@@ -15,11 +16,11 @@ namespace Ocpp16 {
 class StatusNotification : public Operation {
 private:
     int connectorId = 1;
-    OcppEvseState currentStatus = OcppEvseState::NOT_SET;
+    ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
     Timestamp timestamp;
     ErrorCode errorCode;
 public:
-    StatusNotification(int connectorId, OcppEvseState currentStatus, const Timestamp &timestamp, ErrorCode errorCode = nullptr);
+    StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorCode errorCode = nullptr);
 
     const char* getOperationType();
 
@@ -32,7 +33,7 @@ class StatusNotification : public Operation {
     std::unique_ptr<DynamicJsonDocument> createConf();
 };
 
-const char *cstrFromOcppEveState(OcppEvseState state);
+const char *cstrFromOcppEveState(ChargePointStatus state);
 
 } //end namespace Ocpp16
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Operations/TriggerMessage.cpp b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
index b5466aca..2a6512e3 100644
--- a/src/ArduinoOcpp/Operations/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
@@ -59,7 +59,7 @@ void TriggerMessage::processReq(JsonObject payload) {
 
             auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
                         i,
-                        connector->inferenceStatus(), //will be determined in StatusNotification::initiate
+                        connector->getStatus(), //will be determined in StatusNotification::initiate
                         context.getModel().getClock().now()));
 
             statusNotification->setTimeout(60000);
diff --git a/src/ArduinoOcpp/Operations/UnlockConnector.cpp b/src/ArduinoOcpp/Operations/UnlockConnector.cpp
index 502e109d..a16d20a8 100644
--- a/src/ArduinoOcpp/Operations/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/Operations/UnlockConnector.cpp
@@ -30,6 +30,7 @@ void UnlockConnector::processReq(JsonObject payload) {
     }
 
     connector->endTransaction("UnlockCommand");
+    connector->updateTxNotification(TxNotification::RemoteStop);
 
     unlockConnector = connector->getOnUnlockConnector();
     if (unlockConnector != nullptr) {
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index c958a0c5..e121314e 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -5,11 +5,11 @@
 
 ArduinoOcpp::Connection *ocppSocket = nullptr;
 
-void ao_initialize(AConnection *osock, const char *chargePointModel, const char *chargePointVendor, float V_eff, struct AO_FilesystemOpt fsopt) {
-    ao_initialize_full(osock, ChargerCredentials(chargePointModel, chargePointVendor), V_eff, fsopt);
+void ao_initialize(AConnection *osock, const char *chargePointModel, const char *chargePointVendor, struct AO_FilesystemOpt fsopt) {
+    ao_initialize_full(osock, ChargerCredentials(chargePointModel, chargePointVendor), fsopt);
 }
 
-void ao_initialize_full(AConnection *osock, const char *bootNotificationCredentials, float V_eff, struct AO_FilesystemOpt fsopt) {
+void ao_initialize_full(AConnection *osock, const char *bootNotificationCredentials, struct AO_FilesystemOpt fsopt) {
     if (!osock) {
         AO_DBG_ERR("osock is null");
     }
@@ -18,7 +18,7 @@ void ao_initialize_full(AConnection *osock, const char *bootNotificationCredenti
 
     ArduinoOcpp::FilesystemOpt adaptFsopt = fsopt;
 
-    OCPP_initialize(*ocppSocket, bootNotificationCredentials, V_eff, adaptFsopt);
+    OCPP_initialize(*ocppSocket, bootNotificationCredentials, adaptFsopt);
 }
 
 void ao_deinitialize() {
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 033151fd..60000dbd 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -53,14 +53,12 @@ void ao_initialize(
             AConnection *osock,  //WebSocket adapter for ArduinoOcpp
             const char *chargePointModel,     //model name of this charger (e.g. "")
             const char *chargePointVendor, //brand name
-            float V_eff, //Grid voltage of your country. e.g. 230.f (European voltage)
             struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 //same as above, but more fields for the BootNotification
 void ao_initialize_full(
             AConnection *osock,  //WebSocket adapter for ArduinoOcpp
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
-            float V_eff, //Grid voltage of your country. e.g. 230.f (European voltage)
             struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index ed52cfa7..045ac623 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -6,6 +6,7 @@
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Operations/BootNotification.h>
 #include <ArduinoOcpp/Operations/StatusNotification.h>
+#include <ArduinoOcpp/Operations/CustomOperation.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
@@ -32,7 +33,7 @@ TEST_CASE( "Charging sessions" ) {
     
     std::array<const char*, 2> expectedSN {"Available", "Available"};
     std::array<bool, 2> checkedSN {false, false};
-    checkMsg.registerOperation("StatusNotification", [] () -> Operation* {return new Ocpp16::StatusNotification(0, OcppEvseState::NOT_SET, MIN_TIME);});
+    checkMsg.registerOperation("StatusNotification", [] () -> Operation* {return new Ocpp16::StatusNotification(0, ChargePointStatus::NOT_SET, MIN_TIME);});
     checkMsg.setOnRequest("StatusNotification",
         [&checkedSN, &expectedSN] (JsonObject request) {
             int connectorId = request["connectorId"] | -1;
@@ -48,6 +49,8 @@ TEST_CASE( "Charging sessions" ) {
                 checkedBN = !strcmp(request["chargePointModel"] | "Invalid", "test-runner1234");
             });
         
+        REQUIRE( !isOperative() ); //not operative before reaching loop stage
+
         loop();
         loop();
         REQUIRE( checkedBN );
@@ -333,6 +336,61 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE(checkProcessed);
     }
 
+    SECTION("Set Unavaible"){
+
+        beginTransaction("mIdTag");
+
+        loop();
+
+        auto connector = getOcppContext()->getModel().getConnector(1);
+        REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
+        REQUIRE(isOperative());
+
+        bool checkProcessed = false;
+
+        auto changeAvailability = makeRequest(new Ocpp16::CustomOperation(
+                "ChangeAvailability",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = 1;
+                    payload["type"] = "Inoperative";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE(!strcmp(payload["status"], "Scheduled"));}));
+
+        getOcppContext()->initiateRequest(std::move(changeAvailability));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+        REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
+        REQUIRE(isOperative());
+
+        OCPP_deinitialize();
+
+        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+        connector = getOcppContext()->getModel().getConnector(1);
+
+        loop();
+
+        REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
+        REQUIRE(isOperative());
+
+        endTransaction();
+
+        loop();
+
+        REQUIRE(connector->getStatus() == ChargePointStatus::Unavailable);
+        REQUIRE(!isOperative());
+
+        connector->setAvailability(true);
+    }
+
     OCPP_deinitialize();
 
 }
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 4d7da2b0..ad4eed95 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -78,7 +78,7 @@ TEST_CASE( "Configuration Behavior" ) {
             setConnectorPluggedInput([] () {return false;});
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
         }
 
         SECTION("set false") {
@@ -87,12 +87,12 @@ TEST_CASE( "Configuration Behavior" ) {
             setConnectorPluggedInput([] () {return false;});
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::SuspendedEV);
+            REQUIRE(connector->getStatus() == ChargePointStatus::SuspendedEV);
 
             endTransaction();
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
         }
     }
 
@@ -108,12 +108,12 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("mIdTag");
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
 
             beginTransaction_authorized("mIdTag");
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
         }
 
         SECTION("set false") {
@@ -122,17 +122,17 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("mIdTag");
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
 
             beginTransaction_authorized("mIdTag");
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::SuspendedEVSE);
+            REQUIRE(connector->getStatus() == ChargePointStatus::SuspendedEVSE);
 
             endTransaction();
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
         }
     }
 
@@ -149,23 +149,23 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("mIdTag");
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Charging);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
 
             endTransaction();
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
         }
 
         SECTION("set false") {
             *config = false;
 
             beginTransaction("mIdTag");
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Preparing);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Preparing);
 
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
         }
 
         endTransaction();
@@ -195,7 +195,7 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("local-idtag");
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Charging);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
         }
 
         SECTION("set false") {
@@ -204,13 +204,13 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("local-idtag");
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Preparing);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Preparing);
 
             loopback.setConnected(true);
             mtime += 20000; //Authorize will be retried after a few seconds
             loop();
 
-            REQUIRE(connector->inferenceStatus() == OcppEvseState::Charging);
+            REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
         }
 
         endTransaction();
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index b2de40df..f0f89489 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -505,7 +505,7 @@ TEST_CASE( "SmartCharging" ) {
                     //receive conf
                     checkProcessed = true;
 
-                    REQUIRE(payload["status"] == "Accepted");
+                    REQUIRE(!strcmp(payload["status"], "Accepted"));
                     REQUIRE(payload["connectorId"] == 1);
                     
                     char checkScheduleStart [JSONDATE_LENGTH + 1];

From 18c8dd8c8ddf202d8f61ca3ab79020b16f62773c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 24 Jun 2023 20:54:47 +0200
Subject: [PATCH 291/549] remove superfluous functions

---
 src/ArduinoOcpp.cpp                           |  2 +-
 .../Model/ChargeControl/Connector.cpp         | 30 -------------------
 .../Model/ChargeControl/Connector.h           |  4 +--
 .../Model/Reservation/ReservationService.cpp  |  2 +-
 .../Operations/RemoteStartTransaction.cpp     | 10 +++----
 .../Operations/RemoteStopTransaction.cpp      |  4 ++-
 src/ArduinoOcpp_c.cpp                         |  4 +--
 7 files changed, 12 insertions(+), 44 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 3c139489..bce5bd94 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -286,7 +286,7 @@ bool endTransaction(const char *reason, unsigned int connectorId) {
         AO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
-    bool res = connector->getSessionIdTag();
+    auto res = isTransactionActive(connectorId);
     connector->endTransaction(reason);
     return res;
 }
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index e241b20b..256cef06 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -744,36 +744,6 @@ void Connector::endTransaction(const char *reason) {
     transaction->commit();
 }
 
-const char *Connector::getSessionIdTag() {
-
-    if (!transaction) {
-        return nullptr;
-    }
-
-    return transaction->isActive() ? transaction->getIdTag() : nullptr;
-}
-
-uint16_t Connector::getSessionWriteCount() {
-    return transaction ? transaction->getTxNr() : 0;
-}
-
-int Connector::getTransactionId() {
-    
-    if (!transaction) {
-        return -1;
-    }
-
-    if (transaction->isRunning()) {
-        if (transaction->getStartSync().isConfirmed()) {
-            return transaction->getTransactionId();
-        } else {
-            return 0;
-        }
-    } else {
-        return -1;
-    }
-}
-
 std::shared_ptr<Transaction>& Connector::getTransaction() {
     return transaction;
 }
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index 829080ef..3d0494ec 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -94,9 +94,7 @@ class Connector {
      * is safe to call this function at any time even if no transaction is running
      */
     void endTransaction(const char *reason = nullptr);
-    const char *getSessionIdTag();
-    uint16_t getSessionWriteCount();
-    int getTransactionId();
+    
     std::shared_ptr<Transaction>& getTransaction();
 
     //create detached transaction - won't have any side-effects with the transaction handling of this lib
diff --git a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
index d7075c7e..18eb5052 100644
--- a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
@@ -59,7 +59,7 @@ void ReservationService::loop() {
             }
 
             //check if other tx started at this connector (e.g. due to RemoteStartTransaction)
-            if (connector->getSessionIdTag()) {
+            if (connector->getTransaction() && connector->getTransaction()->isActive()) {
                 reservation.clear();
                 continue;
             }
diff --git a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
index 4513c941..de41c5a5 100644
--- a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
@@ -72,9 +72,8 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
     if (connectorId >= 1) {
         //connectorId specified for given connector, try to start Transaction here
         if (auto connector = model.getConnector(connectorId)){
-            if (connector->getTransactionId() < 0 &&
-                        connector->isOperative() &&
-                        !connector->getTransaction()) {
+            if (!connector->getTransaction() &&
+                        connector->isOperative()) {
                 selectConnector = connector;
             }
         }
@@ -82,9 +81,8 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
         //connectorId not specified. Find free connector
         for (unsigned int cid = 1; cid < model.getNumConnectors(); cid++) {
             auto connector = model.getConnector(cid);
-            if (connector->getTransactionId() < 0 && 
-                        connector->isOperative() &&
-                        !connector->getTransaction()) {
+            if (!connector->getTransaction() &&
+                        connector->isOperative()) {
                 selectConnector = connector;
                 connectorId = cid;
                 break;
diff --git a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
index 2490eaf0..47a45fb4 100644
--- a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
@@ -5,6 +5,7 @@
 #include <ArduinoOcpp/Operations/RemoteStopTransaction.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 
 using ArduinoOcpp::Ocpp16::RemoteStopTransaction;
 
@@ -28,7 +29,8 @@ std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
 
     for (unsigned int cId = 0; cId < model.getNumConnectors(); cId++) {
         auto connector = model.getConnector(cId);
-        if (connector->getTransactionId() == transactionId) {
+        if (connector->getTransaction() &&
+                connector->getTransaction()->getTransactionId() == transactionId) {
             canStopTransaction = true;
             connector->endTransaction("Remote");
         }
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index e121314e..ca538e5c 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -270,10 +270,10 @@ int ao_getTransactionId_m(unsigned int connectorId) {
 }
 
 const char *ao_getTransactionIdTag() {
-    return getTransaction() ? getTransaction()->getIdTag() : nullptr;
+    return getTransactionIdTag();
 }
 const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
-    return getTransaction(connectorId) ? getTransaction(connectorId)->getIdTag() : nullptr;
+    return getTransactionIdTag(connectorId);
 }
 
 bool ao_isBlockedByReservation(const char *idTag) {

From b2cbd75bf79803a4602e98740423d98472474a18 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 24 Jun 2023 21:08:50 +0200
Subject: [PATCH 292/549] fix compilation issues

---
 src/ArduinoOcpp.h          | 1 -
 tests/ChargingSessions.cpp | 3 +++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 99a77ddf..0d6b3848 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -43,7 +43,6 @@ void OCPP_initialize(
             const char *CS_url,      //e.g. "ws://example.com/steve/websocket/CentralSystemService/charger001"
             const char *chargePointModel = "Demo Charger",     //model name of this charger
             const char *chargePointVendor = "My Company Ltd.", //brand name
-            float V_eff = 230.f,     //Grid voltage of your country. e.g. 230.f (European voltage)
             ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 #endif
 
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 045ac623..d3a8ad12 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -389,6 +389,9 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE(!isOperative());
 
         connector->setAvailability(true);
+
+        REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+        REQUIRE(isOperative());
     }
 
     OCPP_deinitialize();

From d305954182c97e7dd0ebb93565e558ab558c8b24 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 26 Jun 2023 22:03:10 +0200
Subject: [PATCH 293/549] more consistent naming

---
 CMakeLists.txt                                |  2 +-
 src/ArduinoOcpp.cpp                           | 12 ++--
 .../Model/ChargeControl/Connector.cpp         | 34 +++++------
 .../Model/ChargeControl/Connector.h           | 14 ++---
 .../Model/Diagnostics/DiagnosticsService.cpp  | 16 ++---
 .../Model/Diagnostics/DiagnosticsService.h    |  4 +-
 .../FirmwareManagement/FirmwareService.cpp    | 58 +++++++++----------
 .../FirmwareManagement/FirmwareService.h      |  8 +--
 ...luesRecorder.cpp => MeteringConnector.cpp} | 18 +++---
 ...erValuesRecorder.h => MeteringConnector.h} | 11 ++--
 .../Model/Metering/MeteringService.cpp        |  2 +-
 .../Model/Metering/MeteringService.h          |  7 +--
 12 files changed, 90 insertions(+), 96 deletions(-)
 rename src/ArduinoOcpp/Model/Metering/{ConnectorMeterValuesRecorder.cpp => MeteringConnector.cpp} (92%)
 rename src/ArduinoOcpp/Model/Metering/{ConnectorMeterValuesRecorder.h => MeteringConnector.h} (88%)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 00e40f8a..dc51e6b2 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -64,7 +64,7 @@ set(AO_SRC
     src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
     src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
     src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
-    src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp
+    src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
     src/ArduinoOcpp/Model/Metering/MeteringService.cpp
     src/ArduinoOcpp/Model/Metering/MeterStore.cpp
     src/ArduinoOcpp/Model/Metering/MeterValue.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index bce5bd94..261e005b 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -342,12 +342,12 @@ void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int c
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->setConnectorPluggedSampler(pluggedInput);
+    connector->setConnectorPluggedInput(pluggedInput);
 
     if (pluggedInput) {
-        AO_DBG_INFO("Added ConnectorPluggedSampler. Transaction-management is in auto mode now");
+        AO_DBG_INFO("Added ConnectorPluggedInput. Transaction-management is in auto mode now");
     } else {
-        AO_DBG_INFO("Reset ConnectorPluggedSampler. Transaction-management is in manual mode now");
+        AO_DBG_INFO("Reset ConnectorPluggedInput. Transaction-management is in manual mode now");
     }
 }
 
@@ -484,7 +484,7 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->setEvRequestsEnergySampler(evReadyInput);
+    connector->setEvReadyInput(evReadyInput);
 }
 
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId) {
@@ -497,7 +497,7 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->setConnectorEnergizedSampler(evseReadyInput);
+    connector->setEvseReadyInput(evseReadyInput);
 }
 
 void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned int connectorId) {
@@ -510,7 +510,7 @@ void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned in
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->addConnectorErrorCodeSampler(errorCodeInput);
+    connector->addErrorCodeInput(errorCodeInput);
 }
 
 void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index 256cef06..2f2ea987 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -84,21 +84,21 @@ ChargePointStatus Connector::getStatus() {
         return ChargePointStatus::Unavailable;
     } else if (transaction && transaction->isRunning()) {
         //Transaction is currently running
-        if (connectorPluggedSampler && !connectorPluggedSampler()) { //special case when StopTransactionOnEVSideDisconnect is false
+        if (connectorPluggedInput && !connectorPluggedInput()) { //special case when StopTransactionOnEVSideDisconnect is false
             return ChargePointStatus::SuspendedEV;
         }
         if (!ocppPermitsCharge() ||
-                (connectorEnergizedSampler && !connectorEnergizedSampler())) { 
+                (evseReadyInput && !evseReadyInput())) { 
             return ChargePointStatus::SuspendedEVSE;
         }
-        if (evRequestsEnergySampler && !evRequestsEnergySampler()) {
+        if (evReadyInput && !evReadyInput()) {
             return ChargePointStatus::SuspendedEV;
         }
         return ChargePointStatus::Charging;
     } else if (model.getReservationService() && model.getReservationService()->getReservation(connectorId)) {
         return ChargePointStatus::Reserved;
     } else if ((!transaction || !transaction->isActive()) &&                 //no transaction preparation
-               (!connectorPluggedSampler || !connectorPluggedSampler()) &&   //no vehicle plugged
+               (!connectorPluggedInput || !connectorPluggedInput()) &&   //no vehicle plugged
                (!occupiedInput || !occupiedInput())) {                       //occupied override clear
         return ChargePointStatus::Available;
     } else {
@@ -173,8 +173,8 @@ void Connector::loop() {
 
     if (transaction) { //begin exclusively transaction-related operations
             
-        if (connectorPluggedSampler) {
-            if (transaction->isRunning() && transaction->isActive() && !connectorPluggedSampler()) {
+        if (connectorPluggedInput) {
+            if (transaction->isRunning() && transaction->isActive() && !connectorPluggedInput()) {
                 if (!stopTransactionOnEVSideDisconnect || *stopTransactionOnEVSideDisconnect) {
                     AO_DBG_DEBUG("Stop Tx due to EV disconnect");
                     transaction->setStopReason("EVDisconnected");
@@ -216,7 +216,7 @@ void Connector::loop() {
             //start tx?
 
             if (transaction->isActive() && transaction->isAuthorized() &&  //tx must be authorized
-                    (!connectorPluggedSampler || connectorPluggedSampler()) && //if applicable, connector must be plugged
+                    (!connectorPluggedInput || connectorPluggedInput()) && //if applicable, connector must be plugged
                     isOperative() && //only start tx if charger is free of error conditions
                     (!startTxReadyInput || startTxReadyInput())) { //if defined, user Input for allowing StartTx must be true
                 //start Transaction
@@ -330,8 +330,8 @@ void Connector::loop() {
     } //end transaction-related operations
 
     //handle FreeVend mode
-    if (freeVendActive && *freeVendActive && connectorPluggedSampler) {
-        if (!freeVendTrackPlugged && connectorPluggedSampler() && !transaction) {
+    if (freeVendActive && *freeVendActive && connectorPluggedInput) {
+        if (!freeVendTrackPlugged && connectorPluggedInput() && !transaction) {
             const char *idTag = freeVendIdTag && *freeVendIdTag ? *freeVendIdTag : "";
             if (!idTag || *idTag == '\0') {
                 idTag = "A0000000";
@@ -345,7 +345,7 @@ void Connector::loop() {
             }
         }
 
-        freeVendTrackPlugged = connectorPluggedSampler();
+        freeVendTrackPlugged = connectorPluggedInput();
     }
 
     auto status = getStatus();
@@ -773,19 +773,19 @@ void Connector::setAvailabilityVolatile(bool available) {
     availabilityVolatile = available;
 }
 
-void Connector::setConnectorPluggedSampler(std::function<bool()> connectorPlugged) {
-    this->connectorPluggedSampler = connectorPlugged;
+void Connector::setConnectorPluggedInput(std::function<bool()> connectorPlugged) {
+    this->connectorPluggedInput = connectorPlugged;
 }
 
-void Connector::setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy) {
-    this->evRequestsEnergySampler = evRequestsEnergy;
+void Connector::setEvReadyInput(std::function<bool()> evRequestsEnergy) {
+    this->evReadyInput = evRequestsEnergy;
 }
 
-void Connector::setConnectorEnergizedSampler(std::function<bool()> connectorEnergized) {
-    this->connectorEnergizedSampler = connectorEnergized;
+void Connector::setEvseReadyInput(std::function<bool()> connectorEnergized) {
+    this->evseReadyInput = connectorEnergized;
 }
 
-void Connector::addConnectorErrorCodeSampler(std::function<const char *()> connectorErrorCode) {
+void Connector::addErrorCodeInput(std::function<const char *()> connectorErrorCode) {
     addErrorCodeInput([connectorErrorCode] () -> ErrorCode {
         return ErrorCode(connectorErrorCode());
     });
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index 3d0494ec..1403a7f8 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -39,9 +39,9 @@ class Connector {
     std::shared_ptr<Configuration<bool>> availability;
     bool availabilityVolatile = true;
 
-    std::function<bool()> connectorPluggedSampler;
-    std::function<bool()> evRequestsEnergySampler;
-    std::function<bool()> connectorEnergizedSampler;
+    std::function<bool()> connectorPluggedInput;
+    std::function<bool()> evReadyInput;
+    std::function<bool()> evseReadyInput;
     std::vector<std::function<ErrorCode ()>> errorCodeInputs;
     std::vector<bool> trackErrorCodeInputs;
     bool isFaulted();
@@ -104,10 +104,10 @@ class Connector {
     void setAvailability(bool available);
     void setAvailabilityVolatile(bool available); //set inoperative state but keep only until reboot at most
     void setAuthorizationProvider(std::function<const char *()> authorization);
-    void setConnectorPluggedSampler(std::function<bool()> connectorPlugged);
-    void setEvRequestsEnergySampler(std::function<bool()> evRequestsEnergy);
-    void setConnectorEnergizedSampler(std::function<bool()> connectorEnergized);
-    void addConnectorErrorCodeSampler(std::function<const char*()> connectorErrorCode);
+    void setConnectorPluggedInput(std::function<bool()> connectorPlugged);
+    void setEvReadyInput(std::function<bool()> evRequestsEnergy);
+    void setEvseReadyInput(std::function<bool()> connectorEnergized);
+    void addErrorCodeInput(std::function<const char*()> connectorErrorCode);
     void addErrorCodeInput(std::function<ErrorCode ()> errorCodeInput);
 
     void loop();
diff --git a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
index c92d436f..45e9109f 100644
--- a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -56,7 +56,7 @@ void DiagnosticsService::loop() {
         }
 
         if (uploadIssued) {
-            if (uploadStatusSampler != nullptr && uploadStatusSampler() == UploadStatus::Uploaded) {
+            if (uploadStatusInput != nullptr && uploadStatusInput() == UploadStatus::Uploaded) {
                 //success!
                 AO_DBG_DEBUG("end upload routine (by status)")
                 uploadIssued = false;
@@ -66,10 +66,10 @@ void DiagnosticsService::loop() {
             //check if maximum time elapsed or failed
             const int UPLOAD_TIMEOUT = 60;
             if (timestampNow - nextTry >= UPLOAD_TIMEOUT
-                    || (uploadStatusSampler != nullptr && uploadStatusSampler() == UploadStatus::UploadFailed)) {
+                    || (uploadStatusInput != nullptr && uploadStatusInput() == UploadStatus::UploadFailed)) {
                 //maximum upload time elapsed or failed
 
-                if (uploadStatusSampler == nullptr) {
+                if (uploadStatusInput == nullptr) {
                     //No way to find out if failed. But maximum time has elapsed. Assume success
                     AO_DBG_DEBUG("end upload routine (by timer)");
                     uploadIssued = false;
@@ -140,8 +140,8 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
 
 DiagnosticsStatus DiagnosticsService::getDiagnosticsStatus() {
     if (uploadIssued) {
-        if (uploadStatusSampler != nullptr) {
-            switch (uploadStatusSampler()) {
+        if (uploadStatusInput != nullptr) {
+            switch (uploadStatusInput()) {
                 case UploadStatus::NotUploaded:
                     return DiagnosticsStatus::Uploading;
                 case UploadStatus::Uploaded:
@@ -173,8 +173,8 @@ void DiagnosticsService::setOnUpload(std::function<bool(const std::string &locat
     this->onUpload = onUpload;
 }
 
-void DiagnosticsService::setOnUploadStatusSampler(std::function<UploadStatus()> uploadStatusSampler) {
-    this->uploadStatusSampler = uploadStatusSampler;
+void DiagnosticsService::setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput) {
+    this->uploadStatusInput = uploadStatusInput;
 }
 
 #if !defined(AO_CUSTOM_DIAGNOSTICS) && !defined(AO_CUSTOM_WS)
@@ -184,7 +184,7 @@ DiagnosticsService *EspWiFi::makeDiagnosticsService(Context& context) {
     auto diagService = new DiagnosticsService(context);
 
     /*
-     * add onUpload and uploadStatusSampler when logging was implemented
+     * add onUpload and uploadStatusInput when logging was implemented
      */
 
     return diagService;
diff --git a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
index 91034cb6..eb58c7e2 100644
--- a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -35,7 +35,7 @@ class DiagnosticsService {
     Timestamp nextTry = Timestamp();
 
     std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload = nullptr;
-    std::function<UploadStatus()> uploadStatusSampler = nullptr;
+    std::function<UploadStatus()> uploadStatusInput = nullptr;
     bool uploadIssued = false;
 
     std::unique_ptr<Request> getDiagnosticsStatusNotification();
@@ -56,7 +56,7 @@ class DiagnosticsService {
 
     void setOnUpload(std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload);
 
-    void setOnUploadStatusSampler(std::function<UploadStatus()> uploadStatusSampler);
+    void setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput);
 };
 
 #if !defined(AO_CUSTOM_DIAGNOSTICS) && !defined(AO_CUSTOM_WS)
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 8e47b5b3..a8df3996 100644
--- a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -89,20 +89,20 @@ void FirmwareService::loop() {
             if (onDownload != nullptr) {
                 onDownload(location);
                 timestampTransition = ao_tick_ms();
-                delayTransition = downloadStatusSampler ? 1000 : 30000; //give the download at least 30s
+                delayTransition = downloadStatusInput ? 1000 : 30000; //give the download at least 30s
                 return;
             }
         }
 
         if (stage == UpdateStage::Downloading) {
 
-            if (downloadStatusSampler) {
+            if (downloadStatusInput) {
                 //check if client reports download to be finished
 
-                if (downloadStatusSampler() == DownloadStatus::Downloaded) {
+                if (downloadStatusInput() == DownloadStatus::Downloaded) {
                     //passed download stage
                     stage = UpdateStage::AfterDownload;
-                } else if (downloadStatusSampler() == DownloadStatus::DownloadFailed) {
+                } else if (downloadStatusInput() == DownloadStatus::DownloadFailed) {
                     AO_DBG_INFO("Download timeout or failed! Retry");
                     retreiveDate = timestampNow;
                     retreiveDate += retryInterval;
@@ -115,7 +115,7 @@ void FirmwareService::loop() {
                 }
             } else {
                 //if client doesn't report download state, assume download to be finished (at least 30s download time have passed until here)
-                if (downloadStatusSampler == nullptr) {
+                if (downloadStatusInput == nullptr) {
                     stage = UpdateStage::AfterDownload;
                 }
             }
@@ -153,19 +153,19 @@ void FirmwareService::loop() {
             }
 
             timestampTransition = ao_tick_ms();
-            delayTransition = installationStatusSampler ? 1000 : 120 * 1000;
+            delayTransition = installationStatusInput ? 1000 : 120 * 1000;
             return;
         }
 
         if (stage == UpdateStage::Installing) {
 
-            if (installationStatusSampler) {
-                if (installationStatusSampler() == InstallationStatus::Installed) {
+            if (installationStatusInput) {
+                if (installationStatusInput() == InstallationStatus::Installed) {
                     AO_DBG_INFO("FW update finished");
                     //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
                     resetStage();
                     retries = 0; //End of update routine. Client must reboot on its own
-                } else if (installationStatusSampler() == InstallationStatus::InstallationFailed) {
+                } else if (installationStatusInput() == InstallationStatus::InstallationFailed) {
                     AO_DBG_INFO("Installation timeout or failed! Retry");
                     retreiveDate = timestampNow;
                     retreiveDate += retryInterval;
@@ -224,10 +224,10 @@ void FirmwareService::scheduleFirmwareUpdate(const std::string &location, Timest
 
 FirmwareStatus FirmwareService::getFirmwareStatus() {
     if (installationIssued) {
-        if (installationStatusSampler != nullptr) {
-            if (installationStatusSampler() == InstallationStatus::Installed) {
+        if (installationStatusInput != nullptr) {
+            if (installationStatusInput() == InstallationStatus::Installed) {
                 return FirmwareStatus::Installed;
-            } else if (installationStatusSampler() == InstallationStatus::InstallationFailed) {
+            } else if (installationStatusInput() == InstallationStatus::InstallationFailed) {
                 return FirmwareStatus::InstallationFailed;
             }
         }
@@ -236,10 +236,10 @@ FirmwareStatus FirmwareService::getFirmwareStatus() {
     }
     
     if (downloadIssued) {
-        if (downloadStatusSampler != nullptr) {
-            if (downloadStatusSampler() == DownloadStatus::Downloaded) {
+        if (downloadStatusInput != nullptr) {
+            if (downloadStatusInput() == DownloadStatus::Downloaded) {
                 return FirmwareStatus::Downloaded;
-            } else if (downloadStatusSampler() == DownloadStatus::DownloadFailed) {
+            } else if (downloadStatusInput() == DownloadStatus::DownloadFailed) {
                 return FirmwareStatus::DownloadFailed;
             }
         }
@@ -290,16 +290,16 @@ void FirmwareService::setOnDownload(std::function<bool(const std::string &locati
     this->onDownload = onDownload;
 }
 
-void FirmwareService::setDownloadStatusSampler(std::function<DownloadStatus()> downloadStatusSampler) {
-    this->downloadStatusSampler = downloadStatusSampler;
+void FirmwareService::setDownloadStatusInput(std::function<DownloadStatus()> downloadStatusInput) {
+    this->downloadStatusInput = downloadStatusInput;
 }
 
 void FirmwareService::setOnInstall(std::function<bool(const std::string &location)> onInstall) {
     this->onInstall = onInstall;
 }
 
-void FirmwareService::setInstallationStatusSampler(std::function<InstallationStatus()> installationStatusSampler) {
-    this->installationStatusSampler = installationStatusSampler;
+void FirmwareService::setInstallationStatusInput(std::function<InstallationStatus()> installationStatusInput) {
+    this->installationStatusInput = installationStatusInput;
 }
 
 void FirmwareService::resetStage() {
@@ -326,7 +326,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
         return true;
     });
 
-    fwService->setDownloadStatusSampler([] () {
+    fwService->setDownloadStatusInput([] () {
         //report the download progress
         //...
         return DownloadStatus::NotDownloaded;
@@ -335,7 +335,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 
     fwService->setOnInstall([fwService] (const std::string &location) {
 
-        fwService->setInstallationStatusSampler([](){return InstallationStatus::NotInstalled;});
+        fwService->setInstallationStatusInput([](){return InstallationStatus::NotInstalled;});
 
         WiFiClient client;
         //WiFiClientSecure client;
@@ -347,15 +347,15 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 
         switch (ret) {
             case HTTP_UPDATE_FAILED:
-                fwService->setInstallationStatusSampler([](){return InstallationStatus::InstallationFailed;});
+                fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
                 AO_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", httpUpdate.getLastError(), httpUpdate.getLastErrorString().c_str());
                 break;
             case HTTP_UPDATE_NO_UPDATES:
-                fwService->setInstallationStatusSampler([](){return InstallationStatus::InstallationFailed;});
+                fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
                 AO_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
                 break;
             case HTTP_UPDATE_OK:
-                fwService->setInstallationStatusSampler([](){return InstallationStatus::Installed;});
+                fwService->setInstallationStatusInput([](){return InstallationStatus::Installed;});
                 AO_DBG_INFO("HTTP_UPDATE_OK");
                 ESP.restart();
                 break;
@@ -364,7 +364,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
         return true;
     });
 
-    fwService->setInstallationStatusSampler([] () {
+    fwService->setInstallationStatusInput([] () {
         return InstallationStatus::NotInstalled;
     });
 
@@ -391,15 +391,15 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 
         switch (ret) {
             case HTTP_UPDATE_FAILED:
-                fwService->setInstallationStatusSampler([](){return InstallationStatus::InstallationFailed;});
+                fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
                 AO_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", ESPhttpUpdate.getLastError(), ESPhttpUpdate.getLastErrorString().c_str());
                 break;
             case HTTP_UPDATE_NO_UPDATES:
-                fwService->setInstallationStatusSampler([](){return InstallationStatus::InstallationFailed;});
+                fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
                 AO_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
                 break;
             case HTTP_UPDATE_OK:
-                fwService->setInstallationStatusSampler([](){return InstallationStatus::Installed;});
+                fwService->setInstallationStatusInput([](){return InstallationStatus::Installed;});
                 AO_DBG_INFO("HTTP_UPDATE_OK");
                 ESP.restart();
                 break;
@@ -408,7 +408,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
         return true;
     });
 
-    fwService->setInstallationStatusSampler([] () {
+    fwService->setInstallationStatusInput([] () {
         return InstallationStatus::NotInstalled;
     });
 
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h
index 1646cfdf..f094ef14 100644
--- a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h
+++ b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h
@@ -36,10 +36,10 @@ class FirmwareService {
     std::shared_ptr<Configuration<const char *>> previousBuildNumber;
     std::string buildNumber;
 
-    std::function<DownloadStatus()> downloadStatusSampler;
+    std::function<DownloadStatus()> downloadStatusInput;
     bool downloadIssued = false;
 
-    std::function<InstallationStatus()> installationStatusSampler;
+    std::function<InstallationStatus()> installationStatusInput;
     bool installationIssued = false;
 
     Ocpp16::FirmwareStatus lastReportedStatus = Ocpp16::FirmwareStatus::Idle;
@@ -82,11 +82,11 @@ class FirmwareService {
 
     void setOnDownload(std::function<bool(const std::string &location)> onDownload);
 
-    void setDownloadStatusSampler(std::function<DownloadStatus()> downloadStatusSampler);
+    void setDownloadStatusInput(std::function<DownloadStatus()> downloadStatusInput);
 
     void setOnInstall(std::function<bool(const std::string &location)> onInstall);
 
-    void setInstallationStatusSampler(std::function<InstallationStatus()> installationStatusSampler);
+    void setInstallationStatusInput(std::function<InstallationStatus()> installationStatusInput);
 };
 
 } //endif namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
similarity index 92%
rename from src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp
rename to src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
index 58574be7..0bae157b 100644
--- a/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h>
+#include <ArduinoOcpp/Model/Metering/MeteringConnector.h>
 #include <ArduinoOcpp/Model/Metering/MeterStore.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Model/Model.h>
@@ -17,7 +17,7 @@
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
-ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(Model& context, int connectorId, MeterStore& meterStore)
+MeteringConnector::MeteringConnector(Model& context, int connectorId, MeterStore& meterStore)
         : context(context), connectorId{connectorId}, meterStore(meterStore) {
 
     auto MeterValuesSampledData = declareConfiguration<const char*>(
@@ -99,7 +99,7 @@ ConnectorMeterValuesRecorder::ConnectorMeterValuesRecorder(Model& context, int c
     StopTxnAlignedData->setValidator(validateSelectString);
 }
 
-Operation *ConnectorMeterValuesRecorder::loop() {
+Operation *MeteringConnector::loop() {
 
     bool txBreak = false;
     if (context.getConnector(connectorId)) {
@@ -209,7 +209,7 @@ Operation *ConnectorMeterValuesRecorder::loop() {
     return nullptr; //successful method completition. Currently there is no reason to send a MeterValues Msg.
 }
 
-Operation *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
+Operation *MeteringConnector::takeTriggeredMeterValues() {
 
     auto sample = sampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::Trigger);
 
@@ -228,14 +228,14 @@ Operation *ConnectorMeterValuesRecorder::takeTriggeredMeterValues() {
     return new MeterValues(std::move(mv_now), connectorId, transaction);
 }
 
-void ConnectorMeterValuesRecorder::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
+void MeteringConnector::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
     if (!meterValueSampler->getProperties().getMeasurand().compare("Energy.Active.Import.Register")) {
         energySamplerIndex = samplers.size();
     }
     samplers.push_back(std::move(meterValueSampler));
 }
 
-std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readTxEnergyMeter(ReadingContext context) {
+std::unique_ptr<SampledValue> MeteringConnector::readTxEnergyMeter(ReadingContext context) {
     if (energySamplerIndex >= 0 && (size_t) energySamplerIndex < samplers.size()) {
         return samplers[energySamplerIndex]->takeValue(context);
     } else {
@@ -244,7 +244,7 @@ std::unique_ptr<SampledValue> ConnectorMeterValuesRecorder::readTxEnergyMeter(Re
     }
 }
 
-void ConnectorMeterValuesRecorder::beginTxMeterData(Transaction *transaction) {
+void MeteringConnector::beginTxMeterData(Transaction *transaction) {
     if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
         stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction);
     }
@@ -257,7 +257,7 @@ void ConnectorMeterValuesRecorder::beginTxMeterData(Transaction *transaction) {
     }
 }
 
-std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::endTxMeterData(Transaction *transaction) {
+std::shared_ptr<TransactionMeterData> MeteringConnector::endTxMeterData(Transaction *transaction) {
     if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
         stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction);
     }
@@ -272,7 +272,7 @@ std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::endTxMeterDa
     return std::move(stopTxnData);
 }
 
-std::shared_ptr<TransactionMeterData> ConnectorMeterValuesRecorder::getStopTxMeterData(Transaction *transaction) {
+std::shared_ptr<TransactionMeterData> MeteringConnector::getStopTxMeterData(Transaction *transaction) {
     auto txData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction);
 
     if (!txData) {
diff --git a/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h b/src/ArduinoOcpp/Model/Metering/MeteringConnector.h
similarity index 88%
rename from src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h
rename to src/ArduinoOcpp/Model/Metering/MeteringConnector.h
index 6345c1fd..44896d0d 100644
--- a/src/ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h
+++ b/src/ArduinoOcpp/Model/Metering/MeteringConnector.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef CONNECTOR_METER_VALUES_RECORDER
-#define CONNECTOR_METER_VALUES_RECORDER
+#ifndef METERING_CONNECTOR_H
+#define METERING_CONNECTOR_H
 
 #include <functional>
 #include <memory>
@@ -16,15 +16,12 @@
 
 namespace ArduinoOcpp {
 
-using PowerSampler = std::function<float()>;
-using EnergySampler = std::function<float()>;
-
 class Model;
 class Operation;
 class Transaction;
 class MeterStore;
 
-class ConnectorMeterValuesRecorder {
+class MeteringConnector {
 private:
     Model& context;
     const int connectorId;
@@ -59,7 +56,7 @@ class ConnectorMeterValuesRecorder {
     std::shared_ptr<Configuration<bool>> MeterValuesInTxOnly;
     std::shared_ptr<Configuration<bool>> StopTxnDataCapturePeriodic;
 public:
-    ConnectorMeterValuesRecorder(Model& context, int connectorId, MeterStore& meterStore);
+    MeteringConnector(Model& context, int connectorId, MeterStore& meterStore);
 
     Operation *loop();
 
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
index c571b151..b9c03bda 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
@@ -16,7 +16,7 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
       : context(context), meterStore(filesystem) {
 
     for (int i = 0; i < numConn; i++) {
-        connectors.push_back(std::unique_ptr<ConnectorMeterValuesRecorder>(new ConnectorMeterValuesRecorder(context.getModel(), i, meterStore)));
+        connectors.push_back(std::unique_ptr<MeteringConnector>(new MeteringConnector(context.getModel(), i, meterStore)));
     }
 
     /*
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringService.h b/src/ArduinoOcpp/Model/Metering/MeteringService.h
index e41eec88..3acaa4a0 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringService.h
+++ b/src/ArduinoOcpp/Model/Metering/MeteringService.h
@@ -9,15 +9,12 @@
 #include <vector>
 #include <memory>
 
-#include <ArduinoOcpp/Model/Metering/ConnectorMeterValuesRecorder.h>
+#include <ArduinoOcpp/Model/Metering/MeteringConnector.h>
 #include <ArduinoOcpp/Model/Metering/SampledValue.h>
 #include <ArduinoOcpp/Model/Metering/MeterStore.h>
 
 namespace ArduinoOcpp {
 
-using PowerSampler = std::function<float()>;  //in Watts (W)
-using EnergySampler = std::function<float()>; //in Watt-hours (Wh)
-
 class Context;
 class Request;
 class FilesystemAdapter;
@@ -27,7 +24,7 @@ class MeteringService {
     Context& context;
     MeterStore meterStore;
 
-    std::vector<std::unique_ptr<ConnectorMeterValuesRecorder>> connectors;
+    std::vector<std::unique_ptr<MeteringConnector>> connectors;
 public:
     MeteringService(Context& context, int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 

From b20f48b1b993c9adb0a2adfced85ddc9b5bb6e5c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 26 Jun 2023 22:18:00 +0200
Subject: [PATCH 294/549] review ownership of pointers

---
 src/ArduinoOcpp/Core/SimpleRequestFactory.cpp | 14 ++++--
 src/ArduinoOcpp/Core/SimpleRequestFactory.h   |  3 +-
 .../FirmwareManagement/FirmwareService.cpp    |  4 +-
 .../Model/Metering/MeteringConnector.cpp      | 46 +++++++++----------
 .../Model/Metering/MeteringConnector.h        | 10 ++--
 .../Model/Metering/MeteringService.cpp        |  4 +-
 6 files changed, 43 insertions(+), 38 deletions(-)

diff --git a/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp b/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
index abbd8c85..66b55fde 100644
--- a/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
+++ b/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
@@ -7,13 +7,17 @@
 
 namespace ArduinoOcpp {
 
-std::unique_ptr<Request> makeRequest(Operation *msg){
-    if (msg == nullptr) {
+std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> operation){
+    if (operation == nullptr) {
         return nullptr;
     }
-    auto operation = makeRequest();
-    operation->setOperation(std::unique_ptr<Operation>(msg));
-    return operation;
+    auto request = makeRequest();
+    request->setOperation(std::move(operation));
+    return request;
+}
+
+std::unique_ptr<Request> makeRequest(Operation *operation) {
+    return makeRequest(std::unique_ptr<Operation>(operation));
 }
 
 std::unique_ptr<Request> makeRequest(){
diff --git a/src/ArduinoOcpp/Core/SimpleRequestFactory.h b/src/ArduinoOcpp/Core/SimpleRequestFactory.h
index 3853bcc7..ed099d50 100644
--- a/src/ArduinoOcpp/Core/SimpleRequestFactory.h
+++ b/src/ArduinoOcpp/Core/SimpleRequestFactory.h
@@ -16,7 +16,8 @@ class Operation;
 
 std::unique_ptr<Request> makeRequest();
 
-std::unique_ptr<Request> makeRequest(Operation *msg);
+std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> op);
+std::unique_ptr<Request> makeRequest(Operation *op); //takes ownership of op
 
 } //end namespace ArduinoOcpp
 #endif
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
index a8df3996..17688459 100644
--- a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -268,7 +268,7 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
             buildNumber.clear();
 
             lastReportedStatus = FirmwareStatus::Installed;
-            Operation *fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
+            auto fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
             auto fwNotification = makeRequest(fwNotificationMsg);
             return fwNotification;
         }
@@ -277,7 +277,7 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
     if (getFirmwareStatus() != lastReportedStatus) {
         lastReportedStatus = getFirmwareStatus();
         if (lastReportedStatus != FirmwareStatus::Idle && lastReportedStatus != FirmwareStatus::Installed) {
-            Operation *fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
+            auto fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
             auto fwNotification = makeRequest(fwNotificationMsg);
             return fwNotification;
         }
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
index 0bae157b..ebc32df4 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
@@ -17,8 +17,8 @@
 using namespace ArduinoOcpp;
 using namespace ArduinoOcpp::Ocpp16;
 
-MeteringConnector::MeteringConnector(Model& context, int connectorId, MeterStore& meterStore)
-        : context(context), connectorId{connectorId}, meterStore(meterStore) {
+MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore& meterStore)
+        : model(model), connectorId{connectorId}, meterStore(meterStore) {
 
     auto MeterValuesSampledData = declareConfiguration<const char*>(
         "MeterValuesSampledData",
@@ -99,11 +99,11 @@ MeteringConnector::MeteringConnector(Model& context, int connectorId, MeterStore
     StopTxnAlignedData->setValidator(validateSelectString);
 }
 
-Operation *MeteringConnector::loop() {
+std::unique_ptr<Operation> MeteringConnector::loop() {
 
     bool txBreak = false;
-    if (context.getConnector(connectorId)) {
-        auto &curTx = context.getConnector(connectorId)->getTransaction();
+    if (model.getConnector(connectorId)) {
+        auto &curTx = model.getConnector(connectorId)->getTransaction();
         txBreak = (curTx && curTx->isRunning()) != trackTxRunning;
         trackTxRunning = (curTx && curTx->isRunning());
     }
@@ -113,14 +113,14 @@ Operation *MeteringConnector::loop() {
     }
 
     if ((txBreak || meterData.size() >= (size_t) *MeterValueCacheSize) && !meterData.empty()) {
-        auto meterValues = new MeterValues(std::move(meterData), connectorId, transaction);
+        auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(std::move(meterData), connectorId, transaction));
         meterData.clear();
         return meterValues;
     }
 
-    if (context.getConnector(connectorId)) {
-        if (transaction != context.getConnector(connectorId)->getTransaction()) {
-            transaction = context.getConnector(connectorId)->getTransaction();
+    if (model.getConnector(connectorId)) {
+        if (transaction != model.getConnector(connectorId)->getTransaction()) {
+            transaction = model.getConnector(connectorId)->getTransaction();
         }
         
         if (transaction && transaction->isRunning() && !transaction->isSilent()) {
@@ -144,7 +144,7 @@ Operation *MeteringConnector::loop() {
 
     if (*ClockAlignedDataInterval >= 1) {
 
-        auto& timestampNow = context.getClock().now();
+        auto& timestampNow = model.getClock().now();
         auto dt = nextAlignedTime - timestampNow;
         if (dt <= 0 ||                              //normal case: interval elapsed
                 dt > *ClockAlignedDataInterval) {   //special case: clock has been adjusted or first run
@@ -153,13 +153,13 @@ Operation *MeteringConnector::loop() {
                 abs(dt) <= 60 ?
                 "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
-                auto alignedMeterValues = alignedDataBuilder->takeSample(context.getClock().now(), ReadingContext::SampleClock);
+                auto alignedMeterValues = alignedDataBuilder->takeSample(model.getClock().now(), ReadingContext::SampleClock);
                 if (alignedMeterValues) {
                     meterData.push_back(std::move(alignedMeterValues));
                 }
 
                 if (stopTxnData) {
-                    auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(context.getClock().now(), ReadingContext::SampleClock);
+                    auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(model.getClock().now(), ReadingContext::SampleClock);
                     if (alignedStopTx) {
                         stopTxnData->addTxData(std::move(alignedStopTx));
                     }
@@ -187,13 +187,13 @@ Operation *MeteringConnector::loop() {
         //record periodic tx data
 
         if (ao_tick_ms() - lastSampleTime >= (unsigned long) (*MeterValueSampleInterval * 1000)) {
-            auto sampleMeterValues = sampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::SamplePeriodic);
+            auto sampleMeterValues = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::SamplePeriodic);
             if (sampleMeterValues) {
                 meterData.push_back(std::move(sampleMeterValues));
             }
 
             if (stopTxnData && StopTxnDataCapturePeriodic && *StopTxnDataCapturePeriodic) {
-                auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::SamplePeriodic);
+                auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::SamplePeriodic);
                 if (sampleStopTx) {
                     stopTxnData->addTxData(std::move(sampleStopTx));
                 }
@@ -209,9 +209,9 @@ Operation *MeteringConnector::loop() {
     return nullptr; //successful method completition. Currently there is no reason to send a MeterValues Msg.
 }
 
-Operation *MeteringConnector::takeTriggeredMeterValues() {
+std::unique_ptr<Operation> MeteringConnector::takeTriggeredMeterValues() {
 
-    auto sample = sampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::Trigger);
+    auto sample = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::Trigger);
 
     if (!sample) {
         return nullptr;
@@ -221,11 +221,11 @@ Operation *MeteringConnector::takeTriggeredMeterValues() {
     mv_now.push_back(std::move(sample));
 
     std::shared_ptr<Transaction> transaction = nullptr;
-    if (context.getConnector(connectorId)) {
-        transaction = context.getConnector(connectorId)->getTransaction();
+    if (model.getConnector(connectorId)) {
+        transaction = model.getConnector(connectorId)->getTransaction();
     }
 
-    return new MeterValues(std::move(mv_now), connectorId, transaction);
+    return std::unique_ptr<MeterValues>(new MeterValues(std::move(mv_now), connectorId, transaction));
 }
 
 void MeteringConnector::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
@@ -235,9 +235,9 @@ void MeteringConnector::addMeterValueSampler(std::unique_ptr<SampledValueSampler
     samplers.push_back(std::move(meterValueSampler));
 }
 
-std::unique_ptr<SampledValue> MeteringConnector::readTxEnergyMeter(ReadingContext context) {
+std::unique_ptr<SampledValue> MeteringConnector::readTxEnergyMeter(ReadingContext model) {
     if (energySamplerIndex >= 0 && (size_t) energySamplerIndex < samplers.size()) {
-        return samplers[energySamplerIndex]->takeValue(context);
+        return samplers[energySamplerIndex]->takeValue(model);
     } else {
         AO_DBG_DEBUG("Called readTxEnergyMeter(), but no energySampler or handling strategy set");
         return nullptr;
@@ -250,7 +250,7 @@ void MeteringConnector::beginTxMeterData(Transaction *transaction) {
     }
 
     if (stopTxnData) {
-        auto sampleTxBegin = stopTxnSampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::TransactionBegin);
+        auto sampleTxBegin = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::TransactionBegin);
         if (sampleTxBegin) {
             stopTxnData->addTxData(std::move(sampleTxBegin));
         }
@@ -263,7 +263,7 @@ std::shared_ptr<TransactionMeterData> MeteringConnector::endTxMeterData(Transact
     }
 
     if (stopTxnData) {
-        auto sampleTxEnd = stopTxnSampledDataBuilder->takeSample(context.getClock().now(), ReadingContext::TransactionEnd);
+        auto sampleTxEnd = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::TransactionEnd);
         if (sampleTxEnd) {
             stopTxnData->addTxData(std::move(sampleTxEnd));
         }
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringConnector.h b/src/ArduinoOcpp/Model/Metering/MeteringConnector.h
index 44896d0d..2948fc76 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringConnector.h
+++ b/src/ArduinoOcpp/Model/Metering/MeteringConnector.h
@@ -23,7 +23,7 @@ class MeterStore;
 
 class MeteringConnector {
 private:
-    Model& context;
+    Model& model;
     const int connectorId;
     MeterStore& meterStore;
     
@@ -56,15 +56,15 @@ class MeteringConnector {
     std::shared_ptr<Configuration<bool>> MeterValuesInTxOnly;
     std::shared_ptr<Configuration<bool>> StopTxnDataCapturePeriodic;
 public:
-    MeteringConnector(Model& context, int connectorId, MeterStore& meterStore);
+    MeteringConnector(Model& model, int connectorId, MeterStore& meterStore);
 
-    Operation *loop();
+    std::unique_ptr<Operation> loop();
 
     void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler);
 
-    std::unique_ptr<SampledValue> readTxEnergyMeter(ReadingContext context);
+    std::unique_ptr<SampledValue> readTxEnergyMeter(ReadingContext model);
 
-    Operation *takeTriggeredMeterValues();
+    std::unique_ptr<Operation> takeTriggeredMeterValues();
 
     void beginTxMeterData(Transaction *transaction);
 
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
index b9c03bda..edec295a 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
@@ -33,7 +33,7 @@ void MeteringService::loop(){
     for (unsigned int i = 0; i < connectors.size(); i++){
         auto meterValuesMsg = connectors[i]->loop();
         if (meterValuesMsg != nullptr) {
-            auto meterValues = makeRequest(meterValuesMsg);
+            auto meterValues = makeRequest(std::move(meterValuesMsg));
             meterValues->setTimeout(120000);
             context.initiateRequest(std::move(meterValues));
         }
@@ -65,7 +65,7 @@ std::unique_ptr<Request> MeteringService::takeTriggeredMeterValues(int connector
     if (connector.get()) {
         auto msg = connector->takeTriggeredMeterValues();
         if (msg) {
-            auto meterValues = makeRequest(msg);
+            auto meterValues = makeRequest(std::move(msg));
             meterValues->setTimeout(120000);
             return meterValues;
         }

From ff855f5268ed7d27336f4389dc15bdfdb5aedd74 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 26 Jun 2023 22:21:20 +0200
Subject: [PATCH 295/549] add struct ErrorCode to facade

---
 src/ArduinoOcpp.cpp | 13 +++++++++++++
 src/ArduinoOcpp.h   |  2 ++
 2 files changed, 15 insertions(+)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 261e005b..1ed0316f 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -513,6 +513,19 @@ void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned in
     connector->addErrorCodeInput(errorCodeInput);
 }
 
+void addErrorCodeInput(std::function<ArduinoOcpp::ErrorCode()> errorCodeInput, unsigned int connectorId) {
+    if (!context) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+    auto connector = context->getModel().getConnector(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return;
+    }
+    connector->addErrorCodeInput(errorCodeInput);
+}
+
 void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 0d6b3848..4aa17b6f 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -16,6 +16,7 @@
 #include <ArduinoOcpp/Model/Metering/SampledValue.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Model/ChargeControl/Notification.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
 using ArduinoOcpp::OnReceiveReqListener;
@@ -214,6 +215,7 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId = 1); //Input if EVSE allows charge (= PWM signal on)
 
 void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned int connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
+void addErrorCodeInput(std::function<ArduinoOcpp::ErrorCode()> errorCodeInput, unsigned int connectorId = 1);
 
 void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr, unsigned int connectorId = 1); //integrate further metering Inputs
 

From 28a89768c9e4b77a61d413ee8a7224264e9cd16c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 26 Jun 2023 22:30:05 +0200
Subject: [PATCH 296/549] fix compilation error

---
 src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
index ebc32df4..33f1525b 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
@@ -115,7 +115,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
     if ((txBreak || meterData.size() >= (size_t) *MeterValueCacheSize) && !meterData.empty()) {
         auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(std::move(meterData), connectorId, transaction));
         meterData.clear();
-        return meterValues;
+        return std::move(meterValues);
     }
 
     if (model.getConnector(connectorId)) {

From 0b8a09517c7b972ae4aa060de7f996ec17b9731e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 27 Jun 2023 15:48:46 +0200
Subject: [PATCH 297/549] improve Error input

---
 CMakeLists.txt                                |   1 +
 src/ArduinoOcpp.cpp                           |   6 +-
 src/ArduinoOcpp.h                             |   5 +-
 .../Authorization/AuthorizationService.cpp    |   2 +-
 .../ChargeControl/ChargePointErrorCode.cpp    | 121 ++++++++++++++++++
 .../ChargeControl/ChargePointErrorCode.h      |  61 ++++++++-
 .../Model/ChargeControl/Connector.cpp         |  42 +++---
 .../Model/ChargeControl/Connector.h           |  10 +-
 src/ArduinoOcpp/Model/Reset/ResetService.cpp  |   2 +-
 .../Operations/StatusNotification.cpp         |  22 ++--
 .../Operations/StatusNotification.h           |   4 +-
 src/ArduinoOcpp_c.cpp                         |  12 +-
 src/ArduinoOcpp_c.h                           |   7 +-
 13 files changed, 238 insertions(+), 57 deletions(-)
 create mode 100644 src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp

diff --git a/CMakeLists.txt b/CMakeLists.txt
index dc51e6b2..35752dca 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -60,6 +60,7 @@ set(AO_SRC
     src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
     src/ArduinoOcpp/Model/Boot/BootService.cpp
     src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
+    src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp
     src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
     src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
     src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 1ed0316f..e90223c3 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -500,7 +500,7 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
     connector->setEvseReadyInput(evseReadyInput);
 }
 
-void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned int connectorId) {
+void addErrorCodeInput(std::function<ArduinoOcpp::ErrorCode()> errorCodeInput, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -513,7 +513,7 @@ void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned in
     connector->addErrorCodeInput(errorCodeInput);
 }
 
-void addErrorCodeInput(std::function<ArduinoOcpp::ErrorCode()> errorCodeInput, unsigned int connectorId) {
+void addErrorDataInput(std::function<ArduinoOcpp::ErrorData()> errorDataInput, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -523,7 +523,7 @@ void addErrorCodeInput(std::function<ArduinoOcpp::ErrorCode()> errorCodeInput, u
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->addErrorCodeInput(errorCodeInput);
+    connector->addErrorDataInput(errorDataInput);
 }
 
 void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 4aa17b6f..4dbb56cd 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -24,6 +24,7 @@ using ArduinoOcpp::OnSendConfListener;
 using ArduinoOcpp::OnAbortListener;
 using ArduinoOcpp::OnTimeoutListener;
 using ArduinoOcpp::OnReceiveErrorListener;
+using ArduinoOcpp::ChargePointErrorCode;
 
 #ifndef AO_CUSTOM_WS
 //use links2004/WebSockets library
@@ -214,8 +215,8 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
 
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId = 1); //Input if EVSE allows charge (= PWM signal on)
 
-void addErrorCodeInput(std::function<const char *()> errorCodeInput, unsigned int connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
-void addErrorCodeInput(std::function<ArduinoOcpp::ErrorCode()> errorCodeInput, unsigned int connectorId = 1);
+void addErrorCodeInput(std::function<ArduinoOcpp::ErrorCode()> errorCodeInput, unsigned int connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
+void addErrorDataInput(std::function<ArduinoOcpp::ErrorData()> errorDataInput, unsigned int connectorId = 1);
 
 void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr, unsigned int connectorId = 1); //integrate further metering Inputs
 
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
index 8333b49b..0cd447d8 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
@@ -191,7 +191,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
                     0,
                     cpStatus, //will be determined in StatusNotification::initiate
                     context.getModel().getClock().now(),
-                    "LocalListConflict"));
+                    ChargePointErrorCode::LocalListConflict));
 
         statusNotification->setTimeout(60000);
 
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp
new file mode 100644
index 00000000..9d15f7b4
--- /dev/null
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp
@@ -0,0 +1,121 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
+
+using namespace ArduinoOcpp;
+
+const char *ArduinoOcpp::serializeErrorCode(ErrorCode code) {
+    const char *res = "InternalError";
+    
+    switch (code) {
+        case ErrorCode::ConnectorLockFailure:
+            res = "ConnectorLockFailure";
+            break;
+        case ErrorCode::EVCommunicationError:
+            res = "EVCommunicationError";
+            break;
+        case ErrorCode::GroundFailure:
+            res = "GroundFailure";
+            break;
+        case ErrorCode::HighTemperature:
+            res = "HighTemperature";
+            break;
+        case ErrorCode::InternalError:
+            res = "InternalError";
+            break;
+        case ErrorCode::LocalListConflict:
+            res = "LocalListConflict";
+            break;
+        case ErrorCode::NoError:
+            res = "NoError";
+            break;
+        case ErrorCode::OtherError:
+            res = "OtherError";
+            break;
+        case ErrorCode::OverCurrentFailure:
+            res = "OverCurrentFailure";
+            break;
+        case ErrorCode::OverVoltage:
+            res = "OverVoltage";
+            break;
+        case ErrorCode::PowerMeterFailure:
+            res = "PowerMeterFailure";
+            break;
+        case ErrorCode::PowerSwitchFailure:
+            res = "PowerSwitchFailure";
+            break;
+        case ErrorCode::ReaderFailure:
+            res = "ReaderFailure";
+            break;
+        case ErrorCode::ResetFailure:
+            res = "ResetFailure";
+            break;
+        case ErrorCode::UnderVoltage:
+            res = "UnderVoltage";
+            break;
+        case ErrorCode::WeakSignal:
+            res = "WeakSignal";
+            break;
+    }
+
+    return res;
+}
+
+ChargePointErrorCode ArduinoOcpp::adaptErrorCode(ChargePointErrorCode_c code) {
+    ChargePointErrorCode res = ChargePointErrorCode::InternalError;
+    
+    switch (code) {
+        case ChargePointErrorCode_c::ConnectorLockFailure:
+            res = ChargePointErrorCode::ConnectorLockFailure;
+            break;
+        case ChargePointErrorCode_c::EVCommunicationError:
+            res = ChargePointErrorCode::EVCommunicationError;
+            break;
+        case ChargePointErrorCode_c::GroundFailure:
+            res = ChargePointErrorCode::GroundFailure;
+            break;
+        case ChargePointErrorCode_c::HighTemperature:
+            res = ChargePointErrorCode::HighTemperature;
+            break;
+        case ChargePointErrorCode_c::InternalError:
+            res = ChargePointErrorCode::InternalError;
+            break;
+        case ChargePointErrorCode_c::LocalListConflict:
+            res = ChargePointErrorCode::LocalListConflict;
+            break;
+        case ChargePointErrorCode_c::NoError:
+            res = ChargePointErrorCode::NoError;
+            break;
+        case ChargePointErrorCode_c::OtherError:
+            res = ChargePointErrorCode::OtherError;
+            break;
+        case ChargePointErrorCode_c::OverCurrentFailure:
+            res = ChargePointErrorCode::OverCurrentFailure;
+            break;
+        case ChargePointErrorCode_c::OverVoltage:
+            res = ChargePointErrorCode::OverVoltage;
+            break;
+        case ChargePointErrorCode_c::PowerMeterFailure:
+            res = ChargePointErrorCode::PowerMeterFailure;
+            break;
+        case ChargePointErrorCode_c::PowerSwitchFailure:
+            res = ChargePointErrorCode::PowerSwitchFailure;
+            break;
+        case ChargePointErrorCode_c::ReaderFailure:
+            res = ChargePointErrorCode::ReaderFailure;
+            break;
+        case ChargePointErrorCode_c::ResetFailure:
+            res = ChargePointErrorCode::ResetFailure;
+            break;
+        case ChargePointErrorCode_c::UnderVoltage:
+            res = ChargePointErrorCode::UnderVoltage;
+            break;
+        case ChargePointErrorCode_c::WeakSignal:
+            res = ChargePointErrorCode::WeakSignal;
+            break;
+    }
+
+    return res;
+}
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h
index 40fb6beb..0dab4e4a 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h
@@ -5,20 +5,70 @@
 #ifndef AO_CHARGEPOINTERRORCODE_H
 #define AO_CHARGEPOINTERRORCODE_H
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+enum ChargePointErrorCode_c {
+    ConnectorLockFailure,
+    EVCommunicationError,
+    GroundFailure,
+    HighTemperature,
+    InternalError,
+    LocalListConflict,
+    NoError,
+    OtherError,
+    OverCurrentFailure,
+    OverVoltage,
+    PowerMeterFailure,
+    PowerSwitchFailure,
+    ReaderFailure,
+    ResetFailure,
+    UnderVoltage,
+    WeakSignal
+};
+
+#ifdef __cplusplus
+}
+
 namespace ArduinoOcpp {
 
-struct ErrorCode {
+enum class ChargePointErrorCode {
+    ConnectorLockFailure,
+    EVCommunicationError,
+    GroundFailure,
+    HighTemperature,
+    InternalError,
+    LocalListConflict,
+    NoError,
+    OtherError,
+    OverCurrentFailure,
+    OverVoltage,
+    PowerMeterFailure,
+    PowerSwitchFailure,
+    ReaderFailure,
+    ResetFailure,
+    UnderVoltage,
+    WeakSignal
+};
+
+using ErrorCode = ChargePointErrorCode;
+
+const char *serializeErrorCode(ErrorCode code);
+ChargePointErrorCode adaptErrorCode(ChargePointErrorCode_c code);
+
+struct ErrorData {
     bool isError = false; //if any error information is set
     bool isFaulted = false; //if this is a severe error and the EVSE should go into the faulted state
-    const char *errorCode = nullptr; //error code reported by the ChargePoint
+    ErrorCode errorCode = ErrorCode::NoError; //error code reported by the ChargePoint
     const char *info = nullptr; //Additional free format information related to the error
     const char *vendorId = nullptr; //vendor-specific implementation identifier
     const char *vendorErrorCode = nullptr; //vendor-specific error code
 
-    ErrorCode() = default;
+    ErrorData() = default;
 
-    ErrorCode(const char *errorCode) : errorCode(errorCode) {
-        if (errorCode) {
+    ErrorData(ErrorCode errorCode) : errorCode(errorCode) {
+        if (errorCode != ErrorCode::NoError) {
             isError = true;
             isFaulted = true;
         }
@@ -26,5 +76,6 @@ struct ErrorCode {
 };
 
 }
+#endif //__cplusplus
 
 #endif
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index 2f2ea987..d8974abd 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -350,10 +350,10 @@ void Connector::loop() {
 
     auto status = getStatus();
 
-    for (auto i = std::min(errorCodeInputs.size(), trackErrorCodeInputs.size()); i >= 1; i--) {
+    for (auto i = std::min(errorDataInputs.size(), trackErrorDataInputs.size()); i >= 1; i--) {
         auto index = i - 1;
-        auto error = errorCodeInputs[index].operator()();
-        if (error.isError && !trackErrorCodeInputs[index]) {
+        auto error = errorDataInputs[index].operator()();
+        if (error.isError && !trackErrorDataInputs[index]) {
             //new error
             auto statusNotification = makeRequest(
                     new StatusNotification(connectorId, status, model.getClock().now(), error));
@@ -362,10 +362,10 @@ void Connector::loop() {
 
             currentStatus = status;
             reportedStatus = status;
-            trackErrorCodeInputs[index] = true;
-        } else if (!error.isError && trackErrorCodeInputs[index]) {
+            trackErrorDataInputs[index] = true;
+        } else if (!error.isError && trackErrorDataInputs[index]) {
             //reset error
-            trackErrorCodeInputs[index] = false;
+            trackErrorDataInputs[index] = false;
         }
     }
     
@@ -394,23 +394,23 @@ void Connector::loop() {
 }
 
 bool Connector::isFaulted() {
-    //for (auto i = errorCodeInputs.begin(); i != errorCodeInputs.end(); ++i) {
-    for (size_t i = 0; i < errorCodeInputs.size(); i++) {
-        if (errorCodeInputs[i].operator()().isFaulted) {
+    //for (auto i = errorDataInputs.begin(); i != errorDataInputs.end(); ++i) {
+    for (size_t i = 0; i < errorDataInputs.size(); i++) {
+        if (errorDataInputs[i].operator()().isFaulted) {
             return true;
         }
     }
     return false;
 }
 
-const char *Connector::getErrorCode() {
-    for (auto i = errorCodeInputs.size(); i >= 1; i--) {
-        auto error = errorCodeInputs[i-1].operator()();
-        if (error.isError && error.errorCode) {
+ChargePointErrorCode Connector::getErrorCode() {
+    for (auto i = errorDataInputs.size(); i >= 1; i--) {
+        auto error = errorDataInputs[i-1].operator()();
+        if (error.isError && error.errorCode != ErrorCode::NoError) {
             return error.errorCode;
         }
     }
-    return nullptr;
+    return ErrorCode::NoError;
 }
 
 std::shared_ptr<Transaction> Connector::allocateTransaction() {
@@ -718,8 +718,6 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
         }
     }
 
-    updateTxNotification(TxNotification::Authorized);
-
     transaction->commit();
 
     return transaction;
@@ -785,15 +783,15 @@ void Connector::setEvseReadyInput(std::function<bool()> connectorEnergized) {
     this->evseReadyInput = connectorEnergized;
 }
 
-void Connector::addErrorCodeInput(std::function<const char *()> connectorErrorCode) {
-    addErrorCodeInput([connectorErrorCode] () -> ErrorCode {
-        return ErrorCode(connectorErrorCode());
+void Connector::addErrorCodeInput(std::function<ErrorCode ()> connectorErrorCode) {
+    addErrorDataInput([connectorErrorCode] () -> ErrorData {
+        return ErrorData(connectorErrorCode());
     });
 }
 
-void Connector::addErrorCodeInput(std::function<ErrorCode ()> errorCodeInput) {
-    this->errorCodeInputs.push_back(errorCodeInput);
-    this->trackErrorCodeInputs.push_back(false);
+void Connector::addErrorDataInput(std::function<ErrorData ()> errorDataInput) {
+    this->errorDataInputs.push_back(errorDataInput);
+    this->trackErrorDataInputs.push_back(false);
 }
 
 void Connector::setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index 1403a7f8..2d55b511 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -42,10 +42,10 @@ class Connector {
     std::function<bool()> connectorPluggedInput;
     std::function<bool()> evReadyInput;
     std::function<bool()> evseReadyInput;
-    std::vector<std::function<ErrorCode ()>> errorCodeInputs;
-    std::vector<bool> trackErrorCodeInputs;
+    std::vector<std::function<ErrorData ()>> errorDataInputs;
+    std::vector<bool> trackErrorDataInputs;
     bool isFaulted();
-    const char *getErrorCode();
+    ChargePointErrorCode getErrorCode();
 
     ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
     std::shared_ptr<Configuration<int>> minimumStatusDuration; //in seconds
@@ -107,8 +107,8 @@ class Connector {
     void setConnectorPluggedInput(std::function<bool()> connectorPlugged);
     void setEvReadyInput(std::function<bool()> evRequestsEnergy);
     void setEvseReadyInput(std::function<bool()> connectorEnergized);
-    void addErrorCodeInput(std::function<const char*()> connectorErrorCode);
-    void addErrorCodeInput(std::function<ErrorCode ()> errorCodeInput);
+    void addErrorCodeInput(std::function<ErrorCode ()> connectorErrorCode);
+    void addErrorDataInput(std::function<ErrorData ()> errorCodeInput);
 
     void loop();
 
diff --git a/src/ArduinoOcpp/Model/Reset/ResetService.cpp b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
index 2066108b..994b5abc 100644
--- a/src/ArduinoOcpp/Model/Reset/ResetService.cpp
+++ b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
@@ -65,7 +65,7 @@ void ResetService::loop() {
                         0,
                         cpStatus, //will be determined in StatusNotification::initiate
                         context.getModel().getClock().now(),
-                        "ResetFailure"));
+                        ChargePointErrorCode::ResetFailure));
             statusNotification->setTimeout(60000);
             context.initiateRequest(std::move(statusNotification));
         }
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.cpp b/src/ArduinoOcpp/Operations/StatusNotification.cpp
index c078c955..5f2bf4ff 100644
--- a/src/ArduinoOcpp/Operations/StatusNotification.cpp
+++ b/src/ArduinoOcpp/Operations/StatusNotification.cpp
@@ -43,8 +43,8 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
 }
 }} //end namespaces
 
-StatusNotification::StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorCode errorCode)
-        : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorCode(errorCode) {
+StatusNotification::StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData)
+        : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorData(errorData) {
     
     AO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
 }
@@ -59,18 +59,16 @@ std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
     JsonObject payload = doc->to<JsonObject>();
     
     payload["connectorId"] = connectorId;
-    if (errorCode.isError) {
-        if (errorCode.errorCode) {
-            payload["errorCode"] = errorCode.errorCode;
+    if (errorData.isError) {
+        payload["errorCode"] = serializeErrorCode(errorData.errorCode);
+        if (errorData.info) {
+            payload["info"] = errorData.info;
         }
-        if (errorCode.info) {
-            payload["info"] = errorCode.info;
+        if (errorData.vendorId) {
+            payload["vendorId"] = errorData.vendorId;
         }
-        if (errorCode.vendorId) {
-            payload["vendorId"] = errorCode.vendorId;
-        }
-        if (errorCode.vendorErrorCode) {
-            payload["vendorErrorCode"] = errorCode.vendorErrorCode;
+        if (errorData.vendorErrorCode) {
+            payload["vendorErrorCode"] = errorData.vendorErrorCode;
         }
     } else if (currentStatus == ChargePointStatus::NOT_SET) {
         AO_DBG_ERR("Reporting undefined status");
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.h b/src/ArduinoOcpp/Operations/StatusNotification.h
index 4aef15d7..fa0b7157 100644
--- a/src/ArduinoOcpp/Operations/StatusNotification.h
+++ b/src/ArduinoOcpp/Operations/StatusNotification.h
@@ -18,9 +18,9 @@ class StatusNotification : public Operation {
     int connectorId = 1;
     ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
     Timestamp timestamp;
-    ErrorCode errorCode;
+    ErrorData errorData;
 public:
-    StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorCode errorCode = nullptr);
+    StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData = ErrorCode::NoError);
 
     const char* getOperationType();
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index ca538e5c..434f9ad0 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -54,6 +54,14 @@ std::function<bool()> adaptFn(unsigned int connectorId, InputBool_m fn) {
     return [fn, connectorId] () {return fn(connectorId);};
 }
 
+std::function<ChargePointErrorCode()> adaptFn(InputErrorCode fn) {
+    return [fn] () {return ArduinoOcpp::adaptErrorCode(fn());};
+}
+
+std::function<ChargePointErrorCode()> adaptFn(unsigned int connectorId, InputErrorCode_m fn) {
+    return [fn, connectorId] () {return ArduinoOcpp::adaptErrorCode(fn(connectorId));};
+}
+
 std::function<const char*()> adaptFn(InputString fn) {
     return fn;
 }
@@ -203,10 +211,10 @@ void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput
     setEvseReadyInput(adaptFn(connectorId, evseReadyInput), connectorId);
 }
 
-void ao_addErrorCodeInput(InputString errorCodeInput) {
+void ao_addErrorCodeInput(InputErrorCode errorCodeInput) {
     addErrorCodeInput(adaptFn(errorCodeInput));
 }
-void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput) {
+void ao_addErrorCodeInput_m(unsigned int connectorId, InputErrorCode_m errorCodeInput) {
     addErrorCodeInput(adaptFn(connectorId, errorCodeInput), connectorId);
 }
 
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 60000dbd..fe00734e 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -3,6 +3,7 @@
 
 #include <stddef.h>
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
 
 struct AConnection;
 typedef struct AConnection AConnection;
@@ -34,6 +35,8 @@ typedef bool  (*InputBool)();
 typedef bool  (*InputBool_m)(unsigned int connectorId);
 typedef const char* (*InputString)();
 typedef const char* (*InputString_m)(unsigned int connectorId);
+typedef ChargePointErrorCode_c (*InputErrorCode)();
+typedef ChargePointErrorCode_c (*InputErrorCode_m)(unsigned int connectorId);
 typedef void (*OutputFloat)(float limit);
 typedef void (*OutputFloat_m)(unsigned int connectorId, float limit);
 enum OptionalBool {OptionalTrue, OptionalFalse, OptionalNone};
@@ -111,8 +114,8 @@ void ao_setEvReadyInput_m(unsigned int connectorId, InputBool_m evReadyInput);
 void ao_setEvseReadyInput(InputBool evseReadyInput);
 void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput);
 
-void ao_addErrorCodeInput(InputString errorCodeInput);
-void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput);
+void ao_addErrorCodeInput(InputErrorCode errorCodeInput);
+void ao_addErrorCodeInput_m(unsigned int connectorId, InputErrorCode_m errorCodeInput);
 
 void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
 void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL

From e72bedc7db076c34d2c6db9485945ea9d880f692 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 28 Jun 2023 17:09:34 +0200
Subject: [PATCH 298/549] add stop idTag in API, add enum StopTxReason

---
 src/ArduinoOcpp.cpp                           |  8 +-
 src/ArduinoOcpp.h                             | 19 +++--
 .../Model/ChargeControl/Connector.cpp         | 23 ++++--
 .../Model/ChargeControl/Connector.h           |  4 +-
 .../Model/Transactions/Transaction.cpp        |  5 --
 .../Model/Transactions/Transaction.h          | 20 ++++-
 .../Transactions/TransactionDeserialize.cpp   | 80 ++++++++++++++++++-
 .../Transactions/TransactionDeserialize.h     |  3 +
 src/ArduinoOcpp/Operations/CiStrings.h        |  3 -
 .../Operations/RemoteStopTransaction.cpp      |  2 +-
 .../Operations/StopTransaction.cpp            |  6 +-
 .../Operations/UnlockConnector.cpp            |  2 +-
 src/ArduinoOcpp_c.cpp                         | 15 +++-
 src/ArduinoOcpp_c.h                           |  4 +-
 tests/ChargingSessions.cpp                    |  4 +-
 15 files changed, 149 insertions(+), 49 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index e90223c3..93143a44 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -276,7 +276,7 @@ std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, cons
     return connector->beginTransaction_authorized(idTag, parentIdTag);
 }
 
-bool endTransaction(const char *reason, unsigned int connectorId) {
+bool endTransaction(const char *idTag, StopTxReason reason, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
@@ -287,7 +287,7 @@ bool endTransaction(const char *reason, unsigned int connectorId) {
         return false;
     }
     auto res = isTransactionActive(connectorId);
-    connector->endTransaction(reason);
+    connector->endTransaction(idTag, reason);
     return res;
 }
 
@@ -913,14 +913,12 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         return false;
     }
 
-    connector->endTransaction("Local");
+    connector->endTransaction(transaction->getIdTag(), StopTxReason::Local);
 
     const char *idTag = transaction->getIdTag();
     if (idTag) {
         transaction->setStopIdTag(idTag);
     }
-    
-    transaction->setStopReason("Local");
 
     if (auto mService = context->getModel().getMeteringService()) {
         auto meterStop = mService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 4dbb56cd..063c1cd2 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -25,6 +25,7 @@ using ArduinoOcpp::OnAbortListener;
 using ArduinoOcpp::OnTimeoutListener;
 using ArduinoOcpp::OnReceiveErrorListener;
 using ArduinoOcpp::ChargePointErrorCode;
+using ArduinoOcpp::StopTxReason;
 
 #ifndef AO_CUSTOM_WS
 //use links2004/WebSockets library
@@ -131,16 +132,20 @@ std::shared_ptr<ArduinoOcpp::Transaction> beginTransaction_authorized(const char
 
 /*
  * End the transaction process by terminating the transaction and setting a reason for its termination.
- * Please refer to OCPP 1.6 Specification - Edition 2 p. 90 for a list of valid reasons. "reason"
- * can also be nullptr.
+ * 
+ * If the transaction is ended by swiping an RFID card, then idTag should contain its identifier. If
+ * charging stops for a different reason than swiping the card, idTag should be null or empty.
+ * 
+ * Please refer to OCPP 1.6 Specification - Edition 2 p. 90 for a list of reasons.
  * 
  * It is safe to call this function at any time, i.e. when no transaction runs or when the transaction
- * has already been ended. For example you can place `endTransaction("Reboot");` in the beginning of
- * the program just to ensure that there is no transaction from a previous run.
+ * has already been ended. For example you can place
+ *     `endTransaction(nullptr, StopTransactionReason::Reboot);`
+ * in the beginning of the program just to ensure that there is no transaction from a previous run.
  * 
- * Returns true if this action actually ended a transaction. False otherwise
+ * Returns true if there is a transaction which could eventually be ended by this action
  */
-bool endTransaction(const char *reason = nullptr, unsigned int connectorId = 1);
+bool endTransaction(const char *idTag = nullptr, StopTxReason reason = StopTxReason::Local, unsigned int connectorId = 1);
 
 /*
  * Get information about the current Transaction lifecycle. A transaction can enter the following
@@ -338,7 +343,7 @@ void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onRecei
  *     if (!strcmp(payload["status"], "Rejected")) {
  *         //the OCPP lib rejected the RemoteStopTransaction command. In this example, the customer
  *         //wishes to stop the running transaction in any case and to log this case
- *         endTransaction("Remote"); //end transaction and send StopTransaction if a transaction is running
+ *         endTransaction(nullptr, StopTxReason::Remote); //end transaction and send StopTransaction
  *         Serial.println("[main] override rejected RemoteStopTransaction"); //Arduino print function
  *     }
  * });
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index d8974abd..c2b07009 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -177,7 +177,7 @@ void Connector::loop() {
             if (transaction->isRunning() && transaction->isActive() && !connectorPluggedInput()) {
                 if (!stopTransactionOnEVSideDisconnect || *stopTransactionOnEVSideDisconnect) {
                     AO_DBG_DEBUG("Stop Tx due to EV disconnect");
-                    transaction->setStopReason("EVDisconnected");
+                    transaction->setStopReason(StopTxReason::EVDisconnected);
                     transaction->setInactive();
                     transaction->commit();
                 }
@@ -203,7 +203,7 @@ void Connector::loop() {
                     !stopTransactionOnInvalidId || *stopTransactionOnInvalidId)) { //if transaction is running, behavior depends on StopTransactionOnInvalidId
             
             AO_DBG_DEBUG("DeAuthorize session");
-            transaction->setStopReason("DeAuthorized");
+            transaction->setStopReason(StopTxReason::DeAuthorized);
             transaction->setInactive();
             transaction->commit();
         }
@@ -723,21 +723,28 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
     return transaction;
 }
 
-void Connector::endTransaction(const char *reason) {
+void Connector::endTransaction(const char *idTag, StopTxReason reason) {
 
     if (!transaction || !transaction->isActive()) {
         //transaction already ended / not active anymore
         return;
     }
 
-    AO_DBG_DEBUG("End session with idTag %s for reason %s, %s previous reason",
-                            transaction->getIdTag(), reason ? reason : "undefined",
-                            *transaction->getStopReason() ? "overruled by" : "no");
+    if (idTag && *idTag != '\0' && !strcmp(idTag, transaction->getIdTag())) {
+        //given stop idTag differs from start idTag. Make Authorization check first
 
-    if (reason) {
-        transaction->setStopReason(reason);
+        AO_DBG_WARN("authorization status of stop idTag not checked automatically yet");
+        (void)0;
+    }
+
+    AO_DBG_DEBUG("End session started by idTag %s",
+                            transaction->getIdTag());
+    
+    if (idTag && *idTag != '\0') {
+        transaction->setStopIdTag(idTag);
     }
     
+    transaction->setStopReason(reason);
     transaction->setInactive();
     transaction->commit();
 }
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index 2d55b511..98aab06b 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -8,6 +8,7 @@
 #include <ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h>
 #include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
 #include <ArduinoOcpp/Model/ChargeControl/Notification.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Operations/CiStrings.h>
@@ -25,7 +26,6 @@ namespace ArduinoOcpp {
 class Context;
 class Model;
 class Operation;
-class Transaction;
 
 class Connector {
 private:
@@ -93,7 +93,7 @@ class Connector {
      * a StopTransaction request, if the transaction process has actually ended due to this call. It
      * is safe to call this function at any time even if no transaction is running
      */
-    void endTransaction(const char *reason = nullptr);
+    void endTransaction(const char *idTag = nullptr, StopTxReason reason = StopTxReason::Local);
     
     std::shared_ptr<Transaction>& getTransaction();
 
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
index 540457e3..c9e9d041 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
@@ -17,11 +17,6 @@ bool Transaction::setStopIdTag(const char *idTag) {
     return ret >= 0 && ret < IDTAG_LEN_MAX + 1;
 }
 
-bool Transaction::setStopReason(const char *reason) {
-    auto ret = snprintf(stop_reason, REASON_LEN_MAX + 1, "%s", reason);
-    return ret >= 0 && ret < REASON_LEN_MAX + 1;
-}
-
 bool Transaction::commit() {
     return context.commit(this);
 }
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.h b/src/ArduinoOcpp/Model/Transactions/Transaction.h
index 77809df1..f193374a 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.h
@@ -10,6 +10,20 @@
 
 namespace ArduinoOcpp {
 
+enum class StopTxReason {
+    DeAuthorized,
+    EmergencyStop,
+    EVDisconnected,
+    HardReset,
+    Local,
+    Other,
+    PowerLoss,
+    Reboot,
+    Remote,
+    SoftReset,
+    UnlockCommand
+};
+
 /*
  * A transaction is initiated by the client (charging station) and processed by the server (central system).
  * The client side of a transaction is all data that is generated or collected at the charging station. The
@@ -64,7 +78,7 @@ class Transaction {
     int32_t stop_meter = -1;
     Timestamp stop_timestamp = MIN_TIME;
     uint16_t stop_bootNr = 0;
-    char stop_reason [REASON_LEN_MAX + 1] = {'\0'};
+    StopTxReason stop_reason = StopTxReason::Local;
 
     /*
      * General attributes
@@ -150,8 +164,8 @@ class Transaction {
     void setStopBootNr(uint16_t bootNr) {stop_bootNr = bootNr;} 
     uint16_t getStopBootNr() {return stop_bootNr;}
 
-    bool setStopReason(const char *reason);
-    const char *getStopReason() {return stop_reason;}
+    void setStopReason(StopTxReason reason) {stop_reason = reason;}
+    StopTxReason getStopReason() {return stop_reason;}
 
     void setConnectorId(unsigned int connectorId) {this->connectorId = connectorId;}
     unsigned int getConnectorId() {return connectorId;}
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
index 27d75f69..02474868 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -9,6 +9,78 @@
 
 namespace ArduinoOcpp {
 
+const char *serializeStopTxReason(StopTxReason reason) {
+    const char *res = "Local";
+
+    switch (reason) {
+        case StopTxReason::DeAuthorized:
+            res = "DeAuthorized";
+            break;
+        case StopTxReason::EmergencyStop:
+            res = "EmergencyStop";
+            break;
+        case StopTxReason::EVDisconnected:
+            res = "EVDisconnected";
+            break;
+        case StopTxReason::HardReset:
+            res = "HardReset";
+            break;
+        case StopTxReason::Local:
+            res = "Local";
+            break;
+        case StopTxReason::Other:
+            res = "Other";
+            break;
+        case StopTxReason::PowerLoss:
+            res = "PowerLoss";
+            break;
+        case StopTxReason::Reboot:
+            res = "Reboot";
+            break;
+        case StopTxReason::Remote:
+            res = "Remote";
+            break;
+        case StopTxReason::SoftReset:
+            res = "SoftReset";
+            break;
+        case StopTxReason::UnlockCommand:
+            res = "UnlockCommand";
+            break;
+    }
+
+    return res;
+}
+
+bool deserializeStopTxReason(const char *reason_cstr, StopTxReason& out) {
+    if (!strcmp(reason_cstr, "DeAuthorized")) {
+        out = StopTxReason::DeAuthorized;
+    } else if (!strcmp(reason_cstr, "EmergencyStop")) {
+        out = StopTxReason::EmergencyStop;
+    } else if (!strcmp(reason_cstr, "EVDisconnected")) {
+        out = StopTxReason::EVDisconnected;
+    } else if (!strcmp(reason_cstr, "HardReset")) {
+        out = StopTxReason::HardReset;
+    } else if (!strcmp(reason_cstr, "Local")) {
+        out = StopTxReason::Local;
+    } else if (!strcmp(reason_cstr, "Other")) {
+        out = StopTxReason::Other;
+    } else if (!strcmp(reason_cstr, "PowerLoss")) {
+        out = StopTxReason::PowerLoss;
+    } else if (!strcmp(reason_cstr, "Reboot")) {
+        out = StopTxReason::Reboot;
+    } else if (!strcmp(reason_cstr, "Remote")) {
+        out = StopTxReason::Remote;
+    } else if (!strcmp(reason_cstr, "SoftReset")) {
+        out = StopTxReason::SoftReset;
+    } else if (!strcmp(reason_cstr, "UnlockCommand")) {
+        out = StopTxReason::UnlockCommand;
+    } else {
+        return false;
+    }
+
+    return true;
+}
+
 bool serializeSendStatus(SendStatus& status, JsonObject out) {
     if (status.isRequested()) {
         out["requested"] = true;
@@ -98,8 +170,8 @@ bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
     
     txStop["bootNr"] = tx.getStopBootNr();
 
-    if (tx.getStopReason()[0] != '\0') {
-        txStop["reason"] = tx.getStopReason();
+    if (tx.getStopReason() != StopTxReason::Local) {
+        txStop["reason"] = serializeStopTxReason(tx.getStopReason());
     }
 
     if (tx.isSilent()) {
@@ -224,10 +296,12 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
     }
 
     if (txStop.containsKey("reason")) {
-        if (!tx.setStopReason(txStop["reason"] | "")) {
+        StopTxReason mreason = StopTxReason::Local;
+        if (!deserializeStopTxReason(txStop["reason"] | "_Undefined", mreason)) {
             AO_DBG_ERR("read err");
             return false;
         }
+        tx.setStopReason(mreason);
     }
 
     if (state["silent"] | false) {
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
index ccf80cc2..32a04600 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
@@ -11,6 +11,9 @@
 
 namespace ArduinoOcpp {
 
+const char *serializeStopTxReason(StopTxReason reason);
+bool deserializeStopTxReason(const char *reason_cstr, StopTxReason& out);
+
 bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out);
 bool deserializeTransaction(Transaction& tx, JsonObject in);
 
diff --git a/src/ArduinoOcpp/Operations/CiStrings.h b/src/ArduinoOcpp/Operations/CiStrings.h
index c26a8b1d..bf7a3ef3 100644
--- a/src/ArduinoOcpp/Operations/CiStrings.h
+++ b/src/ArduinoOcpp/Operations/CiStrings.h
@@ -19,7 +19,4 @@
 #define IDTAG_LEN_MAX CiString20TypeLen
 #define CONF_KEYLEN_MAX CiString50TypeLen
 
-//not specified by OCPP
-#define REASON_LEN_MAX CiString25TypeLen
-
 #endif
diff --git a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
index 47a45fb4..e20267a2 100644
--- a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
@@ -32,7 +32,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
         if (connector->getTransaction() &&
                 connector->getTransaction()->getTransactionId() == transactionId) {
             canStopTransaction = true;
-            connector->endTransaction("Remote");
+            connector->endTransaction(nullptr, StopTxReason::Remote);
         }
     }
 
diff --git a/src/ArduinoOcpp/Operations/StopTransaction.cpp b/src/ArduinoOcpp/Operations/StopTransaction.cpp
index f92a8659..c6f99706 100644
--- a/src/ArduinoOcpp/Operations/StopTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/StopTransaction.cpp
@@ -10,6 +10,7 @@
 #include <ArduinoOcpp/Model/Metering/MeterValue.h>
 #include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <ArduinoOcpp/Model/Transactions/TransactionDeserialize.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::StopTransaction;
@@ -160,7 +161,6 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
                 JSON_OBJECT_SIZE(6) + //total of 6 fields
                 (IDTAG_LEN_MAX + 1) + //stop idTag
                 (JSONDATE_LENGTH + 1) + //timestamp string
-                (REASON_LEN_MAX + 1) + //reason string
                 txDataDoc.capacity()));
     JsonObject payload = doc->to<JsonObject>();
 
@@ -176,8 +176,8 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
     payload["transactionId"] = transaction->getTransactionId();
     
-    if (transaction->getStopReason() && *transaction->getStopReason()) {
-        payload["reason"] = (char*) transaction->getStopReason();
+    if (transaction->getStopReason() != StopTxReason::Local) {
+        payload["reason"] = serializeStopTxReason(transaction->getStopReason());
     }
 
     if (!transactionData.empty()) {
diff --git a/src/ArduinoOcpp/Operations/UnlockConnector.cpp b/src/ArduinoOcpp/Operations/UnlockConnector.cpp
index a16d20a8..3f9d8d72 100644
--- a/src/ArduinoOcpp/Operations/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/Operations/UnlockConnector.cpp
@@ -29,7 +29,7 @@ void UnlockConnector::processReq(JsonObject payload) {
         return;
     }
 
-    connector->endTransaction("UnlockCommand");
+    connector->endTransaction(nullptr, StopTxReason::UnlockCommand);
     connector->updateTxNotification(TxNotification::RemoteStop);
 
     unlockConnector = connector->getOnUnlockConnector();
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 434f9ad0..e5da40b6 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -1,6 +1,8 @@
 #include "ArduinoOcpp_c.h"
 #include "ArduinoOcpp.h"
 
+#include <ArduinoOcpp/Model/Transactions/TransactionDeserialize.h>
+
 #include <ArduinoOcpp/Debug.h>
 
 ArduinoOcpp::Connection *ocppSocket = nullptr;
@@ -148,11 +150,16 @@ void ao_beginTransaction_authorized_m(unsigned int connectorId, const char *idTa
     beginTransaction_authorized(idTag, parentIdTag, connectorId);
 }
 
-bool ao_endTransaction(const char *reason) {
-    return endTransaction(reason);
+bool ao_endTransaction(const char *idTag, const char *reason_cstr) {
+    return ao_endTransaction_m(1, idTag, reason_cstr);
 }
-bool ao_endTransaction_m(unsigned int connectorId, const char *reason) {
-    return endTransaction(reason, connectorId);
+bool ao_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason_cstr) {
+    StopTxReason reason = StopTxReason::Local;
+    if (reason_cstr && !ArduinoOcpp::deserializeStopTxReason(reason_cstr, reason)) {
+        AO_DBG_ERR("invalid reason");
+        reason = StopTxReason::Local;
+    }
+    return endTransaction(idTag, reason, connectorId);
 }
 
 bool ao_isTransactionRunning() {
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index fe00734e..f65804cb 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -79,8 +79,8 @@ void ao_beginTransaction_m(unsigned int connectorId, const char *idTag); //multi
 void ao_beginTransaction_authorized(const char *idTag, const char *parentIdTag);
 void ao_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag);
 
-bool ao_endTransaction(const char *reason); //reason can be NULL
-bool ao_endTransaction_m(unsigned int connectorId, const char *reason); //reason can be NULL
+bool ao_endTransaction(const char *idTag, const char *reason); //idTag, reason can be NULL
+bool ao_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason); //idTag, reason can be NULL
 
 bool ao_isTransactionRunning();
 bool ao_isTransactionRunning_m(unsigned int connectorId);
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index d3a8ad12..28b395dd 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -141,7 +141,7 @@ TEST_CASE( "Charging sessions" ) {
         }
 
         SECTION("via session management - deauthorize") {
-            endTransaction("Local");
+            endTransaction();
             loop();
             REQUIRE(checkedSN[1]);
             REQUIRE(!ocppPermitsCharge());
@@ -150,7 +150,7 @@ TEST_CASE( "Charging sessions" ) {
         SECTION("via session management - deauthorize first") {
             expectedSN[1] = "Finishing";
             setConnectorPluggedInput([] () {return true;});
-            endTransaction("Local");
+            endTransaction();
             loop();
             REQUIRE(checkedSN[1]);
             REQUIRE(!ocppPermitsCharge());

From 49dd8f1767723c26e470b238d992f45c16f039f9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 29 Jun 2023 16:20:02 +0200
Subject: [PATCH 299/549] add Codecov report upload

---
 .github/workflows/tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 206bddab..aa9d76f3 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -30,3 +30,6 @@ jobs:
       run: mkdir ao_store
     - name: Run tests
       run: ./build/ao_unit_tests
+    - name: Upload coverage reports to Codecov
+      uses: codecov/codecov-action@v3
+      env: CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

From 8569048fb821531123b29c62f3b7c874fae0c1d7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 29 Jun 2023 16:26:53 +0200
Subject: [PATCH 300/549] fix syntax error

---
 .github/workflows/tests.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index aa9d76f3..d642d39a 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -32,4 +32,5 @@ jobs:
       run: ./build/ao_unit_tests
     - name: Upload coverage reports to Codecov
       uses: codecov/codecov-action@v3
-      env: CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+      env:
+        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

From a8b897327e7af5e7cf9b9b37112441570ba89fa4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 29 Jun 2023 17:55:01 +0200
Subject: [PATCH 301/549] collect coverage information

---
 .github/workflows/tests.yml |  2 ++
 CMakeLists.txt              | 10 ++++++++++
 2 files changed, 12 insertions(+)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index d642d39a..6745831a 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -30,6 +30,8 @@ jobs:
       run: mkdir ao_store
     - name: Run tests
       run: ./build/ao_unit_tests
+    - name: Create coverage report
+      run: gcovr --exclude test --exclude src/ArduinoJson.h > coverage.info
     - name: Upload coverage reports to Codecov
       uses: codecov/codecov-action@v3
       env:
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 35752dca..935a80f3 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,3 +145,13 @@ target_compile_definitions(ao_unit_tests PUBLIC
     AO_TRAFFIC_OUT
     AO_FILENAME_PREFIX="./ao_store/"
 )
+
+target_compile_options(ao_unit_tests PUBLIC
+    -O0
+    -g
+    --coverage
+)
+
+target_link_options(ao_unit_tests PUBLIC
+    --coverage
+)

From 289082914c33c8a5792ebe06795e6e7825f656eb Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 29 Jun 2023 17:58:26 +0200
Subject: [PATCH 302/549] add gcovr dependency

---
 .github/workflows/tests.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 6745831a..04bb69d9 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -13,10 +13,10 @@ jobs:
     steps:
     - name: Check out repository code
       uses: actions/checkout@v3
-    - name: Get gcc compiler
+    - name: Get build tools
       run: |
         sudo apt update
-        sudo apt install build-essential cmake
+        sudo apt install build-essential cmake gcovr
         sudo apt -y install gcc-9 g++-9
         g++ --version
         echo "g++ version must be 9.4.0"

From ac573f6e528a90e18ac82f6023fda6eec3ff01f4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 29 Jun 2023 18:12:08 +0200
Subject: [PATCH 303/549] select cobertura coverage report format

---
 .github/workflows/tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 04bb69d9..869217cb 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -31,7 +31,7 @@ jobs:
     - name: Run tests
       run: ./build/ao_unit_tests
     - name: Create coverage report
-      run: gcovr --exclude test --exclude src/ArduinoJson.h > coverage.info
+      run: gcovr --cobertura -e test -e src/ArduinoJson.h > coverage.xml
     - name: Upload coverage reports to Codecov
       uses: codecov/codecov-action@v3
       env:

From d2074e9757db47318c3be735198738fce41b2e49 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 29 Jun 2023 18:20:52 +0200
Subject: [PATCH 304/549] fix gcovr statement

---
 .github/workflows/tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 869217cb..784a30f4 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -31,7 +31,7 @@ jobs:
     - name: Run tests
       run: ./build/ao_unit_tests
     - name: Create coverage report
-      run: gcovr --cobertura -e test -e src/ArduinoJson.h > coverage.xml
+      run: gcovr --xml -e test -e src/ArduinoJson.h -o coverage.xml
     - name: Upload coverage reports to Codecov
       uses: codecov/codecov-action@v3
       env:

From e353114e8ffb60351554a75ae98ea22aa1c36116 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 30 Jun 2023 19:01:19 +0200
Subject: [PATCH 305/549] remove enum StopTxReason

---
 src/ArduinoOcpp.cpp                           | 25 +-----
 src/ArduinoOcpp.h                             | 10 +--
 .../Model/ChargeControl/Connector.cpp         | 10 ++-
 .../Model/ChargeControl/Connector.h           |  4 +-
 .../Model/Transactions/Transaction.cpp        |  5 ++
 .../Model/Transactions/Transaction.h          | 20 +----
 .../Transactions/TransactionDeserialize.cpp   | 80 +------------------
 .../Transactions/TransactionDeserialize.h     |  3 -
 src/ArduinoOcpp/Operations/CiStrings.h        |  3 +
 .../Operations/RemoteStopTransaction.cpp      |  2 +-
 .../Operations/StopTransaction.cpp            |  6 +-
 .../Operations/UnlockConnector.cpp            |  2 +-
 src/ArduinoOcpp_c.cpp                         | 20 +----
 src/ArduinoOcpp_c.h                           |  3 -
 14 files changed, 36 insertions(+), 157 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 93143a44..dd4eadc2 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -276,7 +276,7 @@ std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, cons
     return connector->beginTransaction_authorized(idTag, parentIdTag);
 }
 
-bool endTransaction(const char *idTag, StopTxReason reason, unsigned int connectorId) {
+bool endTransaction(const char *idTag, const char *reason, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return false;
@@ -703,27 +703,6 @@ void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,Ardu
     connector->setTxNotificationOutput(notificationOutput);
 }
 
-bool isBlockedByReservation(const char *idTag, unsigned int connectorId) {
-    if (!context) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
-        return false;
-    }
-    if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
-        return false;
-    }
-    auto rService = context->getModel().getReservationService();
-    if (!rService) {
-        AO_DBG_ERR("Could not access reservations. Ignore");
-        return false;
-    }
-    if (auto reservation = rService->getReservation(connectorId, idTag)) {
-        return !reservation->matches(idTag);
-    }
-
-    return false; //no reservation -> nothing blocked
-}
-
 #if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
 FirmwareService *getFirmwareService() {
     auto& model = context->getModel();
@@ -913,7 +892,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         return false;
     }
 
-    connector->endTransaction(transaction->getIdTag(), StopTxReason::Local);
+    connector->endTransaction(transaction->getIdTag(), "Local");
 
     const char *idTag = transaction->getIdTag();
     if (idTag) {
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 063c1cd2..14e8a5c4 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -25,7 +25,6 @@ using ArduinoOcpp::OnAbortListener;
 using ArduinoOcpp::OnTimeoutListener;
 using ArduinoOcpp::OnReceiveErrorListener;
 using ArduinoOcpp::ChargePointErrorCode;
-using ArduinoOcpp::StopTxReason;
 
 #ifndef AO_CUSTOM_WS
 //use links2004/WebSockets library
@@ -136,7 +135,8 @@ std::shared_ptr<ArduinoOcpp::Transaction> beginTransaction_authorized(const char
  * If the transaction is ended by swiping an RFID card, then idTag should contain its identifier. If
  * charging stops for a different reason than swiping the card, idTag should be null or empty.
  * 
- * Please refer to OCPP 1.6 Specification - Edition 2 p. 90 for a list of reasons.
+ * Please refer to OCPP 1.6 Specification - Edition 2 p. 90 for a list of valid reasons. "reason"
+ * can also be nullptr.
  * 
  * It is safe to call this function at any time, i.e. when no transaction runs or when the transaction
  * has already been ended. For example you can place
@@ -145,7 +145,7 @@ std::shared_ptr<ArduinoOcpp::Transaction> beginTransaction_authorized(const char
  * 
  * Returns true if there is a transaction which could eventually be ended by this action
  */
-bool endTransaction(const char *idTag = nullptr, StopTxReason reason = StopTxReason::Local, unsigned int connectorId = 1);
+bool endTransaction(const char *idTag = nullptr, const char *reason = nullptr, unsigned int connectorId = 1);
 
 /*
  * Get information about the current Transaction lifecycle. A transaction can enter the following
@@ -275,8 +275,6 @@ const char *getTransactionIdTag(unsigned int connectorId = 1);
 
 void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId = 1);
 
-bool isBlockedByReservation(const char *idTag, unsigned int connectorId = 1); //if the connector is already reserved for a different idTag
-
 /*
  * Configure the device management
  */
@@ -343,7 +341,7 @@ void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onRecei
  *     if (!strcmp(payload["status"], "Rejected")) {
  *         //the OCPP lib rejected the RemoteStopTransaction command. In this example, the customer
  *         //wishes to stop the running transaction in any case and to log this case
- *         endTransaction(nullptr, StopTxReason::Remote); //end transaction and send StopTransaction
+ *         endTransaction(nullptr, "Remote"); //end transaction and send StopTransaction
  *         Serial.println("[main] override rejected RemoteStopTransaction"); //Arduino print function
  *     }
  * });
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index c2b07009..b3c7f41b 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -177,7 +177,7 @@ void Connector::loop() {
             if (transaction->isRunning() && transaction->isActive() && !connectorPluggedInput()) {
                 if (!stopTransactionOnEVSideDisconnect || *stopTransactionOnEVSideDisconnect) {
                     AO_DBG_DEBUG("Stop Tx due to EV disconnect");
-                    transaction->setStopReason(StopTxReason::EVDisconnected);
+                    transaction->setStopReason("EVDisconnected");
                     transaction->setInactive();
                     transaction->commit();
                 }
@@ -203,7 +203,7 @@ void Connector::loop() {
                     !stopTransactionOnInvalidId || *stopTransactionOnInvalidId)) { //if transaction is running, behavior depends on StopTransactionOnInvalidId
             
             AO_DBG_DEBUG("DeAuthorize session");
-            transaction->setStopReason(StopTxReason::DeAuthorized);
+            transaction->setStopReason("DeAuthorized");
             transaction->setInactive();
             transaction->commit();
         }
@@ -723,7 +723,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
     return transaction;
 }
 
-void Connector::endTransaction(const char *idTag, StopTxReason reason) {
+void Connector::endTransaction(const char *idTag, const char *reason) {
 
     if (!transaction || !transaction->isActive()) {
         //transaction already ended / not active anymore
@@ -744,7 +744,9 @@ void Connector::endTransaction(const char *idTag, StopTxReason reason) {
         transaction->setStopIdTag(idTag);
     }
     
-    transaction->setStopReason(reason);
+    if (reason) {
+        transaction->setStopReason(reason);
+    }
     transaction->setInactive();
     transaction->commit();
 }
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index 98aab06b..b202fb40 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -8,7 +8,6 @@
 #include <ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h>
 #include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
 #include <ArduinoOcpp/Model/ChargeControl/Notification.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Operations/CiStrings.h>
@@ -26,6 +25,7 @@ namespace ArduinoOcpp {
 class Context;
 class Model;
 class Operation;
+class Transaction;
 
 class Connector {
 private:
@@ -93,7 +93,7 @@ class Connector {
      * a StopTransaction request, if the transaction process has actually ended due to this call. It
      * is safe to call this function at any time even if no transaction is running
      */
-    void endTransaction(const char *idTag = nullptr, StopTxReason reason = StopTxReason::Local);
+    void endTransaction(const char *idTag = nullptr, const char *reason = nullptr);
     
     std::shared_ptr<Transaction>& getTransaction();
 
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
index c9e9d041..540457e3 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
@@ -17,6 +17,11 @@ bool Transaction::setStopIdTag(const char *idTag) {
     return ret >= 0 && ret < IDTAG_LEN_MAX + 1;
 }
 
+bool Transaction::setStopReason(const char *reason) {
+    auto ret = snprintf(stop_reason, REASON_LEN_MAX + 1, "%s", reason);
+    return ret >= 0 && ret < REASON_LEN_MAX + 1;
+}
+
 bool Transaction::commit() {
     return context.commit(this);
 }
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.h b/src/ArduinoOcpp/Model/Transactions/Transaction.h
index f193374a..77809df1 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.h
@@ -10,20 +10,6 @@
 
 namespace ArduinoOcpp {
 
-enum class StopTxReason {
-    DeAuthorized,
-    EmergencyStop,
-    EVDisconnected,
-    HardReset,
-    Local,
-    Other,
-    PowerLoss,
-    Reboot,
-    Remote,
-    SoftReset,
-    UnlockCommand
-};
-
 /*
  * A transaction is initiated by the client (charging station) and processed by the server (central system).
  * The client side of a transaction is all data that is generated or collected at the charging station. The
@@ -78,7 +64,7 @@ class Transaction {
     int32_t stop_meter = -1;
     Timestamp stop_timestamp = MIN_TIME;
     uint16_t stop_bootNr = 0;
-    StopTxReason stop_reason = StopTxReason::Local;
+    char stop_reason [REASON_LEN_MAX + 1] = {'\0'};
 
     /*
      * General attributes
@@ -164,8 +150,8 @@ class Transaction {
     void setStopBootNr(uint16_t bootNr) {stop_bootNr = bootNr;} 
     uint16_t getStopBootNr() {return stop_bootNr;}
 
-    void setStopReason(StopTxReason reason) {stop_reason = reason;}
-    StopTxReason getStopReason() {return stop_reason;}
+    bool setStopReason(const char *reason);
+    const char *getStopReason() {return stop_reason;}
 
     void setConnectorId(unsigned int connectorId) {this->connectorId = connectorId;}
     unsigned int getConnectorId() {return connectorId;}
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
index 02474868..27d75f69 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -9,78 +9,6 @@
 
 namespace ArduinoOcpp {
 
-const char *serializeStopTxReason(StopTxReason reason) {
-    const char *res = "Local";
-
-    switch (reason) {
-        case StopTxReason::DeAuthorized:
-            res = "DeAuthorized";
-            break;
-        case StopTxReason::EmergencyStop:
-            res = "EmergencyStop";
-            break;
-        case StopTxReason::EVDisconnected:
-            res = "EVDisconnected";
-            break;
-        case StopTxReason::HardReset:
-            res = "HardReset";
-            break;
-        case StopTxReason::Local:
-            res = "Local";
-            break;
-        case StopTxReason::Other:
-            res = "Other";
-            break;
-        case StopTxReason::PowerLoss:
-            res = "PowerLoss";
-            break;
-        case StopTxReason::Reboot:
-            res = "Reboot";
-            break;
-        case StopTxReason::Remote:
-            res = "Remote";
-            break;
-        case StopTxReason::SoftReset:
-            res = "SoftReset";
-            break;
-        case StopTxReason::UnlockCommand:
-            res = "UnlockCommand";
-            break;
-    }
-
-    return res;
-}
-
-bool deserializeStopTxReason(const char *reason_cstr, StopTxReason& out) {
-    if (!strcmp(reason_cstr, "DeAuthorized")) {
-        out = StopTxReason::DeAuthorized;
-    } else if (!strcmp(reason_cstr, "EmergencyStop")) {
-        out = StopTxReason::EmergencyStop;
-    } else if (!strcmp(reason_cstr, "EVDisconnected")) {
-        out = StopTxReason::EVDisconnected;
-    } else if (!strcmp(reason_cstr, "HardReset")) {
-        out = StopTxReason::HardReset;
-    } else if (!strcmp(reason_cstr, "Local")) {
-        out = StopTxReason::Local;
-    } else if (!strcmp(reason_cstr, "Other")) {
-        out = StopTxReason::Other;
-    } else if (!strcmp(reason_cstr, "PowerLoss")) {
-        out = StopTxReason::PowerLoss;
-    } else if (!strcmp(reason_cstr, "Reboot")) {
-        out = StopTxReason::Reboot;
-    } else if (!strcmp(reason_cstr, "Remote")) {
-        out = StopTxReason::Remote;
-    } else if (!strcmp(reason_cstr, "SoftReset")) {
-        out = StopTxReason::SoftReset;
-    } else if (!strcmp(reason_cstr, "UnlockCommand")) {
-        out = StopTxReason::UnlockCommand;
-    } else {
-        return false;
-    }
-
-    return true;
-}
-
 bool serializeSendStatus(SendStatus& status, JsonObject out) {
     if (status.isRequested()) {
         out["requested"] = true;
@@ -170,8 +98,8 @@ bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
     
     txStop["bootNr"] = tx.getStopBootNr();
 
-    if (tx.getStopReason() != StopTxReason::Local) {
-        txStop["reason"] = serializeStopTxReason(tx.getStopReason());
+    if (tx.getStopReason()[0] != '\0') {
+        txStop["reason"] = tx.getStopReason();
     }
 
     if (tx.isSilent()) {
@@ -296,12 +224,10 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
     }
 
     if (txStop.containsKey("reason")) {
-        StopTxReason mreason = StopTxReason::Local;
-        if (!deserializeStopTxReason(txStop["reason"] | "_Undefined", mreason)) {
+        if (!tx.setStopReason(txStop["reason"] | "")) {
             AO_DBG_ERR("read err");
             return false;
         }
-        tx.setStopReason(mreason);
     }
 
     if (state["silent"] | false) {
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
index 32a04600..ccf80cc2 100644
--- a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
+++ b/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
@@ -11,9 +11,6 @@
 
 namespace ArduinoOcpp {
 
-const char *serializeStopTxReason(StopTxReason reason);
-bool deserializeStopTxReason(const char *reason_cstr, StopTxReason& out);
-
 bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out);
 bool deserializeTransaction(Transaction& tx, JsonObject in);
 
diff --git a/src/ArduinoOcpp/Operations/CiStrings.h b/src/ArduinoOcpp/Operations/CiStrings.h
index bf7a3ef3..c26a8b1d 100644
--- a/src/ArduinoOcpp/Operations/CiStrings.h
+++ b/src/ArduinoOcpp/Operations/CiStrings.h
@@ -19,4 +19,7 @@
 #define IDTAG_LEN_MAX CiString20TypeLen
 #define CONF_KEYLEN_MAX CiString50TypeLen
 
+//not specified by OCPP
+#define REASON_LEN_MAX CiString25TypeLen
+
 #endif
diff --git a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
index e20267a2..f940dc3b 100644
--- a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
@@ -32,7 +32,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
         if (connector->getTransaction() &&
                 connector->getTransaction()->getTransactionId() == transactionId) {
             canStopTransaction = true;
-            connector->endTransaction(nullptr, StopTxReason::Remote);
+            connector->endTransaction(nullptr, "Remote");
         }
     }
 
diff --git a/src/ArduinoOcpp/Operations/StopTransaction.cpp b/src/ArduinoOcpp/Operations/StopTransaction.cpp
index c6f99706..f92a8659 100644
--- a/src/ArduinoOcpp/Operations/StopTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/StopTransaction.cpp
@@ -10,7 +10,6 @@
 #include <ArduinoOcpp/Model/Metering/MeterValue.h>
 #include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Model/Transactions/TransactionDeserialize.h>
 #include <ArduinoOcpp/Debug.h>
 
 using ArduinoOcpp::Ocpp16::StopTransaction;
@@ -161,6 +160,7 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
                 JSON_OBJECT_SIZE(6) + //total of 6 fields
                 (IDTAG_LEN_MAX + 1) + //stop idTag
                 (JSONDATE_LENGTH + 1) + //timestamp string
+                (REASON_LEN_MAX + 1) + //reason string
                 txDataDoc.capacity()));
     JsonObject payload = doc->to<JsonObject>();
 
@@ -176,8 +176,8 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
     payload["transactionId"] = transaction->getTransactionId();
     
-    if (transaction->getStopReason() != StopTxReason::Local) {
-        payload["reason"] = serializeStopTxReason(transaction->getStopReason());
+    if (transaction->getStopReason() && *transaction->getStopReason()) {
+        payload["reason"] = (char*) transaction->getStopReason();
     }
 
     if (!transactionData.empty()) {
diff --git a/src/ArduinoOcpp/Operations/UnlockConnector.cpp b/src/ArduinoOcpp/Operations/UnlockConnector.cpp
index 3f9d8d72..845cdf5a 100644
--- a/src/ArduinoOcpp/Operations/UnlockConnector.cpp
+++ b/src/ArduinoOcpp/Operations/UnlockConnector.cpp
@@ -29,7 +29,7 @@ void UnlockConnector::processReq(JsonObject payload) {
         return;
     }
 
-    connector->endTransaction(nullptr, StopTxReason::UnlockCommand);
+    connector->endTransaction(nullptr, "UnlockCommand");
     connector->updateTxNotification(TxNotification::RemoteStop);
 
     unlockConnector = connector->getOnUnlockConnector();
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index e5da40b6..9f6ba07c 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -1,8 +1,6 @@
 #include "ArduinoOcpp_c.h"
 #include "ArduinoOcpp.h"
 
-#include <ArduinoOcpp/Model/Transactions/TransactionDeserialize.h>
-
 #include <ArduinoOcpp/Debug.h>
 
 ArduinoOcpp::Connection *ocppSocket = nullptr;
@@ -150,15 +148,10 @@ void ao_beginTransaction_authorized_m(unsigned int connectorId, const char *idTa
     beginTransaction_authorized(idTag, parentIdTag, connectorId);
 }
 
-bool ao_endTransaction(const char *idTag, const char *reason_cstr) {
-    return ao_endTransaction_m(1, idTag, reason_cstr);
+bool ao_endTransaction(const char *idTag, const char *reason) {
+    return endTransaction(idTag, reason);
 }
-bool ao_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason_cstr) {
-    StopTxReason reason = StopTxReason::Local;
-    if (reason_cstr && !ArduinoOcpp::deserializeStopTxReason(reason_cstr, reason)) {
-        AO_DBG_ERR("invalid reason");
-        reason = StopTxReason::Local;
-    }
+bool ao_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason) {
     return endTransaction(idTag, reason, connectorId);
 }
 
@@ -291,13 +284,6 @@ const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
     return getTransactionIdTag(connectorId);
 }
 
-bool ao_isBlockedByReservation(const char *idTag) {
-    return isBlockedByReservation(idTag);
-}
-bool ao_isBlockedByReservation_m(unsigned int connectorId, const char *idTag) {
-    return isBlockedByReservation(idTag, connectorId);
-}
-
 void ao_set_console_out_c(void (*console_out)(const char *msg)) {
     ao_set_console_out(console_out);
 }
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index f65804cb..38d6b17f 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -148,9 +148,6 @@ int ao_getTransactionId_m(unsigned int connectorId);
 const char *ao_getTransactionIdTag();
 const char *ao_getTransactionIdTag_m(unsigned int connectorId);
 
-bool ao_isBlockedByReservation(const char *idTag);
-bool ao_isBlockedByReservation_m(unsigned int connectorId, const char *idTag);
-
 void ao_setOnReceiveRequest(const char *operationType, OnMessage onRequest);
 
 void ao_setOnSendConf(const char *operationType, OnMessage onConfirmation);

From 7b181a8045bc4ba9f091b4316311eb8dea484401 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 30 Jun 2023 19:46:35 +0200
Subject: [PATCH 306/549] remove enum ErrorCode

---
 CMakeLists.txt                                |   1 -
 src/ArduinoOcpp.cpp                           |   2 +-
 src/ArduinoOcpp.h                             |   5 +-
 .../Authorization/AuthorizationService.cpp    |   2 +-
 .../ChargeControl/ChargePointErrorCode.cpp    | 121 ------------------
 .../ChargeControl/ChargePointErrorCode.h      |  81 ------------
 .../ChargeControl/ChargePointErrorData.h      |  30 +++++
 .../Model/ChargeControl/Connector.cpp         |   8 +-
 .../Model/ChargeControl/Connector.h           |   6 +-
 src/ArduinoOcpp/Model/Reset/ResetService.cpp  |   2 +-
 src/ArduinoOcpp/Operations/CiStrings.h        |   2 +-
 .../Operations/StatusNotification.cpp         |   4 +-
 .../Operations/StatusNotification.h           |   4 +-
 src/ArduinoOcpp_c.cpp                         |  12 +-
 src/ArduinoOcpp_c.h                           |   8 +-
 15 files changed, 53 insertions(+), 235 deletions(-)
 delete mode 100644 src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp
 delete mode 100644 src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h
 create mode 100644 src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 935a80f3..fa381503 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -60,7 +60,6 @@ set(AO_SRC
     src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
     src/ArduinoOcpp/Model/Boot/BootService.cpp
     src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
-    src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp
     src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
     src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
     src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index dd4eadc2..db34776c 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -500,7 +500,7 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
     connector->setEvseReadyInput(evseReadyInput);
 }
 
-void addErrorCodeInput(std::function<ArduinoOcpp::ErrorCode()> errorCodeInput, unsigned int connectorId) {
+void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 14e8a5c4..04e774fe 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -16,7 +16,7 @@
 #include <ArduinoOcpp/Model/Metering/SampledValue.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Model/ChargeControl/Notification.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
 using ArduinoOcpp::OnReceiveReqListener;
@@ -24,7 +24,6 @@ using ArduinoOcpp::OnSendConfListener;
 using ArduinoOcpp::OnAbortListener;
 using ArduinoOcpp::OnTimeoutListener;
 using ArduinoOcpp::OnReceiveErrorListener;
-using ArduinoOcpp::ChargePointErrorCode;
 
 #ifndef AO_CUSTOM_WS
 //use links2004/WebSockets library
@@ -220,7 +219,7 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
 
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId = 1); //Input if EVSE allows charge (= PWM signal on)
 
-void addErrorCodeInput(std::function<ArduinoOcpp::ErrorCode()> errorCodeInput, unsigned int connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
+void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
 void addErrorDataInput(std::function<ArduinoOcpp::ErrorData()> errorDataInput, unsigned int connectorId = 1);
 
 void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr, unsigned int connectorId = 1); //integrate further metering Inputs
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
index 0cd447d8..8333b49b 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
@@ -191,7 +191,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
                     0,
                     cpStatus, //will be determined in StatusNotification::initiate
                     context.getModel().getClock().now(),
-                    ChargePointErrorCode::LocalListConflict));
+                    "LocalListConflict"));
 
         statusNotification->setTimeout(60000);
 
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp
deleted file mode 100644
index 9d15f7b4..00000000
--- a/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.cpp
+++ /dev/null
@@ -1,121 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2023
-// MIT License
-
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
-
-using namespace ArduinoOcpp;
-
-const char *ArduinoOcpp::serializeErrorCode(ErrorCode code) {
-    const char *res = "InternalError";
-    
-    switch (code) {
-        case ErrorCode::ConnectorLockFailure:
-            res = "ConnectorLockFailure";
-            break;
-        case ErrorCode::EVCommunicationError:
-            res = "EVCommunicationError";
-            break;
-        case ErrorCode::GroundFailure:
-            res = "GroundFailure";
-            break;
-        case ErrorCode::HighTemperature:
-            res = "HighTemperature";
-            break;
-        case ErrorCode::InternalError:
-            res = "InternalError";
-            break;
-        case ErrorCode::LocalListConflict:
-            res = "LocalListConflict";
-            break;
-        case ErrorCode::NoError:
-            res = "NoError";
-            break;
-        case ErrorCode::OtherError:
-            res = "OtherError";
-            break;
-        case ErrorCode::OverCurrentFailure:
-            res = "OverCurrentFailure";
-            break;
-        case ErrorCode::OverVoltage:
-            res = "OverVoltage";
-            break;
-        case ErrorCode::PowerMeterFailure:
-            res = "PowerMeterFailure";
-            break;
-        case ErrorCode::PowerSwitchFailure:
-            res = "PowerSwitchFailure";
-            break;
-        case ErrorCode::ReaderFailure:
-            res = "ReaderFailure";
-            break;
-        case ErrorCode::ResetFailure:
-            res = "ResetFailure";
-            break;
-        case ErrorCode::UnderVoltage:
-            res = "UnderVoltage";
-            break;
-        case ErrorCode::WeakSignal:
-            res = "WeakSignal";
-            break;
-    }
-
-    return res;
-}
-
-ChargePointErrorCode ArduinoOcpp::adaptErrorCode(ChargePointErrorCode_c code) {
-    ChargePointErrorCode res = ChargePointErrorCode::InternalError;
-    
-    switch (code) {
-        case ChargePointErrorCode_c::ConnectorLockFailure:
-            res = ChargePointErrorCode::ConnectorLockFailure;
-            break;
-        case ChargePointErrorCode_c::EVCommunicationError:
-            res = ChargePointErrorCode::EVCommunicationError;
-            break;
-        case ChargePointErrorCode_c::GroundFailure:
-            res = ChargePointErrorCode::GroundFailure;
-            break;
-        case ChargePointErrorCode_c::HighTemperature:
-            res = ChargePointErrorCode::HighTemperature;
-            break;
-        case ChargePointErrorCode_c::InternalError:
-            res = ChargePointErrorCode::InternalError;
-            break;
-        case ChargePointErrorCode_c::LocalListConflict:
-            res = ChargePointErrorCode::LocalListConflict;
-            break;
-        case ChargePointErrorCode_c::NoError:
-            res = ChargePointErrorCode::NoError;
-            break;
-        case ChargePointErrorCode_c::OtherError:
-            res = ChargePointErrorCode::OtherError;
-            break;
-        case ChargePointErrorCode_c::OverCurrentFailure:
-            res = ChargePointErrorCode::OverCurrentFailure;
-            break;
-        case ChargePointErrorCode_c::OverVoltage:
-            res = ChargePointErrorCode::OverVoltage;
-            break;
-        case ChargePointErrorCode_c::PowerMeterFailure:
-            res = ChargePointErrorCode::PowerMeterFailure;
-            break;
-        case ChargePointErrorCode_c::PowerSwitchFailure:
-            res = ChargePointErrorCode::PowerSwitchFailure;
-            break;
-        case ChargePointErrorCode_c::ReaderFailure:
-            res = ChargePointErrorCode::ReaderFailure;
-            break;
-        case ChargePointErrorCode_c::ResetFailure:
-            res = ChargePointErrorCode::ResetFailure;
-            break;
-        case ChargePointErrorCode_c::UnderVoltage:
-            res = ChargePointErrorCode::UnderVoltage;
-            break;
-        case ChargePointErrorCode_c::WeakSignal:
-            res = ChargePointErrorCode::WeakSignal;
-            break;
-    }
-
-    return res;
-}
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h
deleted file mode 100644
index 0dab4e4a..00000000
--- a/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h
+++ /dev/null
@@ -1,81 +0,0 @@
-// matth-x/ArduinoOcpp
-// Copyright Matthias Akstaller 2019 - 2023
-// MIT License
-
-#ifndef AO_CHARGEPOINTERRORCODE_H
-#define AO_CHARGEPOINTERRORCODE_H
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-enum ChargePointErrorCode_c {
-    ConnectorLockFailure,
-    EVCommunicationError,
-    GroundFailure,
-    HighTemperature,
-    InternalError,
-    LocalListConflict,
-    NoError,
-    OtherError,
-    OverCurrentFailure,
-    OverVoltage,
-    PowerMeterFailure,
-    PowerSwitchFailure,
-    ReaderFailure,
-    ResetFailure,
-    UnderVoltage,
-    WeakSignal
-};
-
-#ifdef __cplusplus
-}
-
-namespace ArduinoOcpp {
-
-enum class ChargePointErrorCode {
-    ConnectorLockFailure,
-    EVCommunicationError,
-    GroundFailure,
-    HighTemperature,
-    InternalError,
-    LocalListConflict,
-    NoError,
-    OtherError,
-    OverCurrentFailure,
-    OverVoltage,
-    PowerMeterFailure,
-    PowerSwitchFailure,
-    ReaderFailure,
-    ResetFailure,
-    UnderVoltage,
-    WeakSignal
-};
-
-using ErrorCode = ChargePointErrorCode;
-
-const char *serializeErrorCode(ErrorCode code);
-ChargePointErrorCode adaptErrorCode(ChargePointErrorCode_c code);
-
-struct ErrorData {
-    bool isError = false; //if any error information is set
-    bool isFaulted = false; //if this is a severe error and the EVSE should go into the faulted state
-    ErrorCode errorCode = ErrorCode::NoError; //error code reported by the ChargePoint
-    const char *info = nullptr; //Additional free format information related to the error
-    const char *vendorId = nullptr; //vendor-specific implementation identifier
-    const char *vendorErrorCode = nullptr; //vendor-specific error code
-
-    ErrorData() = default;
-
-    ErrorData(ErrorCode errorCode) : errorCode(errorCode) {
-        if (errorCode != ErrorCode::NoError) {
-            isError = true;
-            isFaulted = true;
-        }
-    }
-};
-
-}
-#endif //__cplusplus
-
-#endif
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h
new file mode 100644
index 00000000..632b37d3
--- /dev/null
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h
@@ -0,0 +1,30 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef AO_CHARGEPOINTERRORCODE_H
+#define AO_CHARGEPOINTERRORCODE_H
+
+namespace ArduinoOcpp {
+
+struct ErrorData {
+    bool isError = false; //if any error information is set
+    bool isFaulted = false; //if this is a severe error and the EVSE should go into the faulted state
+    const char *errorCode = nullptr; //see ChargePointErrorCode (p. 76/77) for possible values
+    const char *info = nullptr; //Additional free format information related to the error
+    const char *vendorId = nullptr; //vendor-specific implementation identifier
+    const char *vendorErrorCode = nullptr; //vendor-specific error code
+
+    ErrorData() = default;
+
+    ErrorData(const char *errorCode = nullptr) : errorCode(errorCode) {
+        if (errorCode) {
+            isError = true;
+            isFaulted = true;
+        }
+    }
+};
+
+}
+
+#endif
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index b3c7f41b..771e8225 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -403,14 +403,14 @@ bool Connector::isFaulted() {
     return false;
 }
 
-ChargePointErrorCode Connector::getErrorCode() {
+const char *Connector::getErrorCode() {
     for (auto i = errorDataInputs.size(); i >= 1; i--) {
         auto error = errorDataInputs[i-1].operator()();
-        if (error.isError && error.errorCode != ErrorCode::NoError) {
+        if (error.isError && error.errorCode) {
             return error.errorCode;
         }
     }
-    return ErrorCode::NoError;
+    return nullptr;
 }
 
 std::shared_ptr<Transaction> Connector::allocateTransaction() {
@@ -792,7 +792,7 @@ void Connector::setEvseReadyInput(std::function<bool()> connectorEnergized) {
     this->evseReadyInput = connectorEnergized;
 }
 
-void Connector::addErrorCodeInput(std::function<ErrorCode ()> connectorErrorCode) {
+void Connector::addErrorCodeInput(std::function<const char*()> connectorErrorCode) {
     addErrorDataInput([connectorErrorCode] () -> ErrorData {
         return ErrorData(connectorErrorCode());
     });
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index b202fb40..209dabee 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -6,7 +6,7 @@
 #define CONNECTOR_H
 
 #include <ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h>
 #include <ArduinoOcpp/Model/ChargeControl/Notification.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
@@ -45,7 +45,7 @@ class Connector {
     std::vector<std::function<ErrorData ()>> errorDataInputs;
     std::vector<bool> trackErrorDataInputs;
     bool isFaulted();
-    ChargePointErrorCode getErrorCode();
+    const char *getErrorCode();
 
     ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
     std::shared_ptr<Configuration<int>> minimumStatusDuration; //in seconds
@@ -107,7 +107,7 @@ class Connector {
     void setConnectorPluggedInput(std::function<bool()> connectorPlugged);
     void setEvReadyInput(std::function<bool()> evRequestsEnergy);
     void setEvseReadyInput(std::function<bool()> connectorEnergized);
-    void addErrorCodeInput(std::function<ErrorCode ()> connectorErrorCode);
+    void addErrorCodeInput(std::function<const char*()> connectorErrorCode);
     void addErrorDataInput(std::function<ErrorData ()> errorCodeInput);
 
     void loop();
diff --git a/src/ArduinoOcpp/Model/Reset/ResetService.cpp b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
index 994b5abc..2066108b 100644
--- a/src/ArduinoOcpp/Model/Reset/ResetService.cpp
+++ b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
@@ -65,7 +65,7 @@ void ResetService::loop() {
                         0,
                         cpStatus, //will be determined in StatusNotification::initiate
                         context.getModel().getClock().now(),
-                        ChargePointErrorCode::ResetFailure));
+                        "ResetFailure"));
             statusNotification->setTimeout(60000);
             context.initiateRequest(std::move(statusNotification));
         }
diff --git a/src/ArduinoOcpp/Operations/CiStrings.h b/src/ArduinoOcpp/Operations/CiStrings.h
index c26a8b1d..cab1ceb4 100644
--- a/src/ArduinoOcpp/Operations/CiStrings.h
+++ b/src/ArduinoOcpp/Operations/CiStrings.h
@@ -20,6 +20,6 @@
 #define CONF_KEYLEN_MAX CiString50TypeLen
 
 //not specified by OCPP
-#define REASON_LEN_MAX CiString25TypeLen
+#define REASON_LEN_MAX 15
 
 #endif
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.cpp b/src/ArduinoOcpp/Operations/StatusNotification.cpp
index 5f2bf4ff..1c7979a1 100644
--- a/src/ArduinoOcpp/Operations/StatusNotification.cpp
+++ b/src/ArduinoOcpp/Operations/StatusNotification.cpp
@@ -60,7 +60,9 @@ std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
     
     payload["connectorId"] = connectorId;
     if (errorData.isError) {
-        payload["errorCode"] = serializeErrorCode(errorData.errorCode);
+        if (errorData.errorCode) {
+            payload["errorCode"] = errorData.errorCode;
+        }
         if (errorData.info) {
             payload["info"] = errorData.info;
         }
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.h b/src/ArduinoOcpp/Operations/StatusNotification.h
index fa0b7157..a55df9ba 100644
--- a/src/ArduinoOcpp/Operations/StatusNotification.h
+++ b/src/ArduinoOcpp/Operations/StatusNotification.h
@@ -8,7 +8,7 @@
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
@@ -20,7 +20,7 @@ class StatusNotification : public Operation {
     Timestamp timestamp;
     ErrorData errorData;
 public:
-    StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData = ErrorCode::NoError);
+    StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData = nullptr);
 
     const char* getOperationType();
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 9f6ba07c..bfe3b40e 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -54,14 +54,6 @@ std::function<bool()> adaptFn(unsigned int connectorId, InputBool_m fn) {
     return [fn, connectorId] () {return fn(connectorId);};
 }
 
-std::function<ChargePointErrorCode()> adaptFn(InputErrorCode fn) {
-    return [fn] () {return ArduinoOcpp::adaptErrorCode(fn());};
-}
-
-std::function<ChargePointErrorCode()> adaptFn(unsigned int connectorId, InputErrorCode_m fn) {
-    return [fn, connectorId] () {return ArduinoOcpp::adaptErrorCode(fn(connectorId));};
-}
-
 std::function<const char*()> adaptFn(InputString fn) {
     return fn;
 }
@@ -211,10 +203,10 @@ void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput
     setEvseReadyInput(adaptFn(connectorId, evseReadyInput), connectorId);
 }
 
-void ao_addErrorCodeInput(InputErrorCode errorCodeInput) {
+void ao_addErrorCodeInput(InputString errorCodeInput) {
     addErrorCodeInput(adaptFn(errorCodeInput));
 }
-void ao_addErrorCodeInput_m(unsigned int connectorId, InputErrorCode_m errorCodeInput) {
+void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput) {
     addErrorCodeInput(adaptFn(connectorId, errorCodeInput), connectorId);
 }
 
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 38d6b17f..2c80c584 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -3,7 +3,7 @@
 
 #include <stddef.h>
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorCode.h>
+#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h>
 
 struct AConnection;
 typedef struct AConnection AConnection;
@@ -35,8 +35,6 @@ typedef bool  (*InputBool)();
 typedef bool  (*InputBool_m)(unsigned int connectorId);
 typedef const char* (*InputString)();
 typedef const char* (*InputString_m)(unsigned int connectorId);
-typedef ChargePointErrorCode_c (*InputErrorCode)();
-typedef ChargePointErrorCode_c (*InputErrorCode_m)(unsigned int connectorId);
 typedef void (*OutputFloat)(float limit);
 typedef void (*OutputFloat_m)(unsigned int connectorId, float limit);
 enum OptionalBool {OptionalTrue, OptionalFalse, OptionalNone};
@@ -114,8 +112,8 @@ void ao_setEvReadyInput_m(unsigned int connectorId, InputBool_m evReadyInput);
 void ao_setEvseReadyInput(InputBool evseReadyInput);
 void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput);
 
-void ao_addErrorCodeInput(InputErrorCode errorCodeInput);
-void ao_addErrorCodeInput_m(unsigned int connectorId, InputErrorCode_m errorCodeInput);
+void ao_addErrorCodeInput(InputString errorCodeInput);
+void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput);
 
 void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
 void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL

From 4f80e0a1185b57da5aefa9fd0411faecd2d9c46d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 30 Jun 2023 20:29:23 +0200
Subject: [PATCH 307/549] change to lcov

---
 .github/workflows/tests.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 784a30f4..3a0f6def 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -16,7 +16,7 @@ jobs:
     - name: Get build tools
       run: |
         sudo apt update
-        sudo apt install build-essential cmake gcovr
+        sudo apt install build-essential cmake
         sudo apt -y install gcc-9 g++-9
         g++ --version
         echo "g++ version must be 9.4.0"
@@ -31,7 +31,7 @@ jobs:
     - name: Run tests
       run: ./build/ao_unit_tests
     - name: Create coverage report
-      run: gcovr --xml -e test -e src/ArduinoJson.h -o coverage.xml
+      run: lcov --remove coverage.info '/usr/*' '*/tests/*' '*/ArduinoJson.h' --output-file coverage.info
     - name: Upload coverage reports to Codecov
       uses: codecov/codecov-action@v3
       env:

From 8f0fe850a85ca185651f5ad075337a2e9ecc7f83 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 30 Jun 2023 20:34:00 +0200
Subject: [PATCH 308/549] add dependency lcov

---
 .github/workflows/tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 3a0f6def..8fa82b6e 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -16,7 +16,7 @@ jobs:
     - name: Get build tools
       run: |
         sudo apt update
-        sudo apt install build-essential cmake
+        sudo apt install build-essential cmake lcov
         sudo apt -y install gcc-9 g++-9
         g++ --version
         echo "g++ version must be 9.4.0"

From 6fe67c9af48a09242079f7649262d134801ea462 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 30 Jun 2023 20:38:41 +0200
Subject: [PATCH 309/549] fix lcov command

---
 .github/workflows/tests.yml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 8fa82b6e..ef417bb4 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -31,7 +31,9 @@ jobs:
     - name: Run tests
       run: ./build/ao_unit_tests
     - name: Create coverage report
-      run: lcov --remove coverage.info '/usr/*' '*/tests/*' '*/ArduinoJson.h' --output-file coverage.info
+      run: |
+        lcov --directory . --capture --output-file coverage.info
+        lcov --remove coverage.info '/usr/*' '*/tests/*' '*/ArduinoJson.h' --output-file coverage.info
     - name: Upload coverage reports to Codecov
       uses: codecov/codecov-action@v3
       env:

From dfb027ab2c8f2b51ee48d9b03939fcb237c50f8c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 30 Jun 2023 23:58:53 +0200
Subject: [PATCH 310/549] update C and C++ API

---
 .github/workflows/tests.yml                   |  1 +
 CMakeLists.txt                                |  1 +
 src/ArduinoOcpp.cpp                           | 93 +++++++++---------
 src/ArduinoOcpp.h                             | 60 ++++++------
 .../Model/ChargeControl/Notification.cpp      | 48 ++++++++++
 .../Model/ChargeControl/Notification.h        | 35 ++++++-
 .../Model/Transactions/Transaction.cpp        | 55 +++++++++++
 .../Model/Transactions/Transaction.h          | 37 ++++++++
 src/ArduinoOcpp_c.cpp                         | 94 ++++++++++++++-----
 src/ArduinoOcpp_c.h                           | 70 +++++++-------
 10 files changed, 360 insertions(+), 134 deletions(-)
 create mode 100644 src/ArduinoOcpp/Model/ChargeControl/Notification.cpp

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index ef417bb4..f69e8b32 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -34,6 +34,7 @@ jobs:
       run: |
         lcov --directory . --capture --output-file coverage.info
         lcov --remove coverage.info '/usr/*' '*/tests/*' '*/ArduinoJson.h' --output-file coverage.info
+        lcov --list coverage.info
     - name: Upload coverage reports to Codecov
       uses: codecov/codecov-action@v3
       env:
diff --git a/CMakeLists.txt b/CMakeLists.txt
index fa381503..a7b4feb1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -61,6 +61,7 @@ set(AO_SRC
     src/ArduinoOcpp/Model/Boot/BootService.cpp
     src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
     src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+    src/ArduinoOcpp/Model/ChargeControl/Notification.cpp
     src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
     src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
     src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index db34776c..05b42651 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -19,7 +19,6 @@
 #include <ArduinoOcpp/Model/Reset/ResetService.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/OperationRegistry.h>
-#include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 
@@ -319,6 +318,35 @@ bool isTransactionRunning(unsigned int connectorId) {
     return tx ? tx->isRunning() : false;
 }
 
+const char *getTransactionIdTag(unsigned int connectorId) {
+    if (!context) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return nullptr;
+    }
+    auto connector = context->getModel().getConnector(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return nullptr;
+    }
+    auto& tx = connector->getTransaction();
+    return tx ? tx->getIdTag() : nullptr;
+}
+
+std::shared_ptr<Transaction> ao_undefinedTx;
+
+std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
+    if (!context) {
+        AO_DBG_WARN("Please call OCPP_initialize before");
+        return ao_undefinedTx;
+    }
+    auto connector = context->getModel().getConnector(connectorId);
+    if (!connector) {
+        AO_DBG_ERR("Could not find connector. Ignore");
+        return ao_undefinedTx;
+    }
+    return connector->getTransaction();
+}
+
 bool ocppPermitsCharge(unsigned int connectorId) {
     if (!context) {
         AO_DBG_WARN("Please call OCPP_initialize before");
@@ -594,7 +622,7 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute) {
     }
 }
 
-void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId) {
+void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -604,7 +632,7 @@ void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnect
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->setOnUnlockConnector(onUnlockConnectorInOut);
+    connector->setOccupiedInput(occupied);
 }
 
 void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId) {
@@ -633,7 +661,7 @@ void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connect
     connector->setStopTxReadyInput(stopTxReady);
 }
 
-void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId) {
+void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
         return;
@@ -643,64 +671,35 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId)
         AO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
-    connector->setOccupiedInput(occupied);
-}
-
-bool isOperative(unsigned int connectorId) {
-    if (!context) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
-        return true; //assume "true" as default state
-    }
-    auto& model = context->getModel();
-    auto chargePoint = model.getConnector(OCPP_ID_OF_CP);
-    auto connector = model.getConnector(connectorId);
-    if (!chargePoint || !connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return true; //assume "true" as default state
-    }
-    return chargePoint->isOperative() && connector->isOperative();
-}
-
-std::shared_ptr<Transaction> ao_undefinedTx;
-
-std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
-    if (!context) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
-        return ao_undefinedTx;
-    }
-    auto connector = context->getModel().getConnector(connectorId);
-    if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return ao_undefinedTx;
-    }
-    return connector->getTransaction();
+    connector->setTxNotificationOutput(notificationOutput);
 }
 
-const char *getTransactionIdTag(unsigned int connectorId) {
+void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return nullptr;
+        return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
-        return nullptr;
+        return;
     }
-    auto& tx = connector->getTransaction();
-    return tx ? tx->getIdTag() : nullptr;
+    connector->setOnUnlockConnector(onUnlockConnectorInOut);
 }
 
-void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId) {
+bool isOperative(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
+        AO_DBG_WARN("Please call OCPP_initialize before");
+        return true; //assume "true" as default state
     }
-    auto connector = context->getModel().getConnector(connectorId);
-    if (!connector) {
+    auto& model = context->getModel();
+    auto chargePoint = model.getConnector(OCPP_ID_OF_CP);
+    auto connector = model.getConnector(connectorId);
+    if (!chargePoint || !connector) {
         AO_DBG_ERR("Could not find connector. Ignore");
-        return;
+        return true; //assume "true" as default state
     }
-    connector->setTxNotificationOutput(notificationOutput);
+    return chargePoint->isOperative() && connector->isOperative();
 }
 
 #if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 04e774fe..ba77cea9 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -169,6 +169,28 @@ bool endTransaction(const char *idTag = nullptr, const char *reason = nullptr, u
 bool isTransactionActive(unsigned int connectorId = 1);
 bool isTransactionRunning(unsigned int connectorId = 1);
 
+/*
+ * Get the idTag which has been used to start the transaction. If no transaction process is
+ * running, this function returns nullptr
+ */
+const char *getTransactionIdTag(unsigned int connectorId = 1);
+
+/*
+ * Returns the current transaction process. Returns nullptr if no transaction is running, preparing or finishing
+ *
+ * See the class definition in ArduinoOcpp/Model/Transactions/Transaction.h for possible uses of this object
+ * 
+ * Examples:
+ * auto tx = getTransaction(); //fetch tx object
+ * if (tx) { //check if tx object exists
+ *     bool active = tx->isActive(); //active tells if the transaction is preparing or continuing to run
+ *                                   //inactive means that the transaction is about to stop, stopped or won't be started anymore
+ *     int transactionId = tx->getTransactionId(); //the transactionId as assigned by the OCPP server
+ *     bool deauthorized = tx->isIdTagDeauthorized(); //if StartTransaction has been rejected
+ * }
+ */
+std::shared_ptr<ArduinoOcpp::Transaction>& getTransaction(unsigned int connectorId = 1);
+
 /* 
  * Returns if the OCPP library allows the EVSE to charge at the moment.
  *
@@ -230,6 +252,14 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify); //call onResetNo
 
 void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handler. This function should reboot this controller immediately. Already defined for the ESP32 on Arduino
 
+void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId = 1); //Input if instead of Available, send StatusNotification Preparing / Finishing
+
+void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId = 1); //Input if the charger is ready for StartTransaction
+
+void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId = 1); //Input if charger is ready for StopTransaction
+
+void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId = 1);
+
 /*
  * Set an InputOutput (reads and sets information at the same time) for forcing to unlock the
  * connector. Called as part of the OCPP operation "UnlockConnector"
@@ -238,42 +268,12 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handle
  */
 void setOnUnlockConnectorInOut(std::function<ArduinoOcpp::PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId = 1);
 
-void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId = 1); //Input if the charger is ready for StartTransaction
-
-void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId = 1); //Input if charger is ready for StopTransaction
-
-void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId = 1); //Input if instead of Available, send StatusNotification Preparing / Finishing
-
 /*
  * Access further information about the internal state of the library
  */
 
 bool isOperative(unsigned int connectorId = 1); //if the charge point is operative (see OCPP1.6 Edit2, p. 45) and ready for transactions
 
-/*
- * Returns the current transaction process. Returns nullptr if no transaction is running, preparing or finishing
- *
- * See the class definition in ArduinoOcpp/Model/Transactions/Transaction.h for possible uses of this object
- * 
- * Examples:
- * auto tx = getTransaction(); //fetch tx object
- * if (tx) { //check if tx object exists
- *     bool active = tx->isActive(); //active tells if the transaction is preparing or continuing to run
- *                                   //inactive means that the transaction is about to stop, stopped or won't be started anymore
- *     int transactionId = tx->getTransactionId(); //the transactionId as assigned by the OCPP server
- *     bool deauthorized = tx->isIdTagDeauthorized(); //if StartTransaction has been rejected
- * }
- */
-std::shared_ptr<ArduinoOcpp::Transaction>& getTransaction(unsigned int connectorId = 1);
-
-/*
- * Get the idTag which has been used to start the transaction. If no transaction process is
- * running, this function returns nullptr
- */
-const char *getTransactionIdTag(unsigned int connectorId = 1);
-
-void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId = 1);
-
 /*
  * Configure the device management
  */
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Notification.cpp b/src/ArduinoOcpp/Model/ChargeControl/Notification.cpp
new file mode 100644
index 00000000..4262d5a0
--- /dev/null
+++ b/src/ArduinoOcpp/Model/ChargeControl/Notification.cpp
@@ -0,0 +1,48 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <ArduinoOcpp/Model/ChargeControl/Notification.h>
+
+namespace ArduinoOcpp {
+
+AOTxNotification_c convertTxNotification(TxNotification txn) {
+    auto res = AOTxNotification_c::AuthorizationRejected;
+    
+    switch (txn) {
+        case TxNotification::AuthorizationRejected:
+            res = AOTxNotification_c::AuthorizationRejected;
+            break;
+        case TxNotification::AuthorizationTimeout:
+            res = AOTxNotification_c::AuthorizationTimeout;
+            break;
+        case TxNotification::Authorized:
+            res = AOTxNotification_c::Authorized;
+            break;
+        case TxNotification::ConnectionTimeout:
+            res = AOTxNotification_c::ConnectionTimeout;
+            break;
+        case TxNotification::DeAuthorized:
+            res = AOTxNotification_c::DeAuthorized;
+            break;
+        case TxNotification::RemoteStart:
+            res = AOTxNotification_c::RemoteStart;
+            break;
+        case TxNotification::RemoteStop:
+            res = AOTxNotification_c::RemoteStop;
+            break;
+        case TxNotification::ReservationConflict:
+            res = AOTxNotification_c::ReservationConflict;
+            break;
+        case TxNotification::StartTx:
+            res = AOTxNotification_c::StartTx;
+            break;
+        case TxNotification::StopTx:
+            res = AOTxNotification_c::StopTx;
+            break;
+    }
+
+    return res;
+}
+
+} //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Notification.h b/src/ArduinoOcpp/Model/ChargeControl/Notification.h
index 1e5ca6f8..d6faa848 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Notification.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Notification.h
@@ -5,6 +5,8 @@
 #ifndef AO_NOTIFICATION_H
 #define AO_NOTIFICATION_H
 
+#ifdef __cplusplus
+
 namespace ArduinoOcpp {
 
 enum class TxNotification {
@@ -24,6 +26,37 @@ enum class TxNotification {
     StopTx,
 };
 
-}
+} //end namespace ArduinoOcpp
+
+extern "C" {
+#endif //__cplusplus
+
+enum AOTxNotification_c {
+    //Authorization events
+    Authorized, //success
+    AuthorizationRejected, //IdTag not authorized
+    AuthorizationTimeout, //authorization failed - offline
+    ReservationConflict, //connector reserved for other IdTag
+
+    ConnectionTimeout, //user took to long to plug vehicle after the authorization
+    DeAuthorized, //server rejected StartTx
+    RemoteStart, //authorized via RemoteStartTransaction
+    RemoteStop, //stopped via RemoteStopTransaction
+
+    //Tx lifecycle events
+    StartTx,
+    StopTx,
+};
+
+#ifdef __cplusplus
+} //end extern "C"
+
+namespace ArduinoOcpp {
+
+AOTxNotification_c convertTxNotification(TxNotification txn);
+
+} //end namespace ArduinoOcpp
+
+#endif //__cplusplus
 
 #endif
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
index 540457e3..16c89d7b 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
@@ -25,3 +25,58 @@ bool Transaction::setStopReason(const char *reason) {
 bool Transaction::commit() {
     return context.commit(this);
 }
+
+int ao_tx_getTransactionId(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getTransactionId();
+}
+bool ao_tx_isAuthorized(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isAuthorized();
+}
+bool ao_tx_isIdTagDeauthorized(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isIdTagDeauthorized();
+}
+
+bool ao_tx_isRunning(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isRunning();
+}
+bool ao_tx_isActive(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isActive();
+}
+bool ao_tx_isAborted(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isAborted();
+}
+bool ao_tx_isCompleted(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isCompleted();
+}
+
+const char *ao_tx_getIdTag(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getIdTag();
+}
+
+bool ao_tx_getBeginTimestamp(AOTransaction_c *tx, char *buf, size_t len) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getBeginTimestamp().toJsonString(buf, len);
+}
+
+int32_t ao_tx_getMeterStart(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getMeterStart();
+}
+
+bool ao_tx_getStartTimestamp(AOTransaction_c *tx, char *buf, size_t len) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStartTimestamp().toJsonString(buf, len);
+}
+
+const char *ao_tx_getStopIdTag(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStopIdTag();
+}
+
+int32_t ao_tx_getMeterStop(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getMeterStop();
+}
+
+bool ao_tx_getStopTimestamp(AOTransaction_c *tx, char *buf, size_t len) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStopTimestamp().toJsonString(buf, len);
+}
+
+const char *ao_tx_getStopReason(AOTransaction_c *tx) {
+    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStopReason();
+}
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.h b/src/ArduinoOcpp/Model/Transactions/Transaction.h
index 77809df1..c4dbac6b 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.h
@@ -5,6 +5,8 @@
 #ifndef TRANSACTION_H
 #define TRANSACTION_H
 
+#ifdef __cplusplus
+
 #include <ArduinoOcpp/Core/Time.h>
 #include <ArduinoOcpp/Operations/CiStrings.h>
 
@@ -165,4 +167,39 @@ class Transaction {
 
 }
 
+extern "C" {
+#endif //__cplusplus
+
+struct AOTransaction_c;
+typedef struct AOTransaction_c AOTransaction_c;
+
+int ao_tx_getTransactionId(AOTransaction_c *tx);
+bool ao_tx_isAuthorized(AOTransaction_c *tx);
+bool ao_tx_isIdTagDeauthorized(AOTransaction_c *tx);
+
+bool ao_tx_isRunning(AOTransaction_c *tx);
+bool ao_tx_isActive(AOTransaction_c *tx);
+bool ao_tx_isAborted(AOTransaction_c *tx);
+bool ao_tx_isCompleted(AOTransaction_c *tx);
+
+const char *ao_tx_getIdTag(AOTransaction_c *tx);
+
+bool ao_tx_getBeginTimestamp(AOTransaction_c *tx, char *buf, size_t len);
+
+int32_t ao_tx_getMeterStart(AOTransaction_c *tx);
+
+bool ao_tx_getStartTimestamp(AOTransaction_c *tx, char *buf, size_t len);
+
+const char *ao_tx_getStopIdTag(AOTransaction_c *tx);
+
+int32_t ao_tx_getMeterStop(AOTransaction_c *tx);
+
+bool ao_tx_getStopTimestamp(AOTransaction_c *tx, char *buf, size_t len);
+
+const char *ao_tx_getStopReason(AOTransaction_c *tx);
+
+#ifdef __cplusplus
+} //end extern "C"
+#endif
+
 #endif
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index bfe3b40e..7b7eac7a 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -1,3 +1,7 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
 #include "ArduinoOcpp_c.h"
 #include "ArduinoOcpp.h"
 
@@ -5,16 +9,16 @@
 
 ArduinoOcpp::Connection *ocppSocket = nullptr;
 
-void ao_initialize(AConnection *osock, const char *chargePointModel, const char *chargePointVendor, struct AO_FilesystemOpt fsopt) {
-    ao_initialize_full(osock, ChargerCredentials(chargePointModel, chargePointVendor), fsopt);
+void ao_initialize(OcppConnection *conn, const char *chargePointModel, const char *chargePointVendor, struct AO_FilesystemOpt fsopt) {
+    ao_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt);
 }
 
-void ao_initialize_full(AConnection *osock, const char *bootNotificationCredentials, struct AO_FilesystemOpt fsopt) {
-    if (!osock) {
-        AO_DBG_ERR("osock is null");
+void ao_initialize_full(OcppConnection *conn, const char *bootNotificationCredentials, struct AO_FilesystemOpt fsopt) {
+    if (!conn) {
+        AO_DBG_ERR("conn is null");
     }
 
-    ocppSocket = reinterpret_cast<ArduinoOcpp::Connection*>(osock);
+    ocppSocket = reinterpret_cast<ArduinoOcpp::Connection*>(conn);
 
     ArduinoOcpp::FilesystemOpt adaptFsopt = fsopt;
 
@@ -82,6 +86,14 @@ std::function<void(float)> adaptFn(OutputFloat fn) {
     return fn;
 }
 
+std::function<void(float, float, int)> adaptFn(OutputSmartCharging fn) {
+    return fn;
+}
+
+std::function<void(float, float, int)> adaptFn(unsigned int connectorId, OutputSmartCharging_m fn) {
+    return [fn, connectorId] (float power, float current, int nphases) {fn(connectorId, power, current, nphases);};
+}
+
 std::function<void(float)> adaptFn(unsigned int connectorId, OutputFloat_m fn) {
     return [fn, connectorId] (float value) {return fn(connectorId, value);};
 }
@@ -147,6 +159,13 @@ bool ao_endTransaction_m(unsigned int connectorId, const char *idTag, const char
     return endTransaction(idTag, reason, connectorId);
 }
 
+bool ao_isTransactionActive() {
+    return isTransactionActive();
+}
+bool ao_isTransactionActive_m(unsigned int connectorId) {
+    return isTransactionActive(connectorId);
+}
+
 bool ao_isTransactionRunning() {
     return isTransactionRunning();
 }
@@ -154,6 +173,13 @@ bool ao_isTransactionRunning_m(unsigned int connectorId) {
     return isTransactionRunning(connectorId);
 }
 
+const char *ao_getTransactionIdTag() {
+    return getTransactionIdTag();
+}
+const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
+    return getTransactionIdTag(connectorId);
+}
+
 bool ao_ocppPermitsCharge() {
     return ocppPermitsCharge();
 }
@@ -182,11 +208,23 @@ void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat_m powerInput)
     setPowerMeterInput(adaptFn(connectorId, powerInput), connectorId);
 }
 
-void ao_setSmartChargingOutput(OutputFloat chargingLimitOutput) {
-    setSmartChargingPowerOutput(adaptFn(chargingLimitOutput));
+void ao_setSmartChargingPowerOutput(OutputFloat maxPowerOutput) {
+    setSmartChargingPowerOutput(adaptFn(maxPowerOutput));
+}
+void ao_setSmartChargingPowerOutput_m(unsigned int connectorId, OutputFloat_m maxPowerOutput) {
+    setSmartChargingPowerOutput(adaptFn(connectorId, maxPowerOutput), connectorId);
 }
-void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputFloat_m chargingLimitOutput) {
-    setSmartChargingPowerOutput(adaptFn(connectorId, chargingLimitOutput), connectorId);
+void ao_setSmartChargingCurrentOutput(OutputFloat maxCurrentOutput) {
+    setSmartChargingCurrentOutput(adaptFn(maxCurrentOutput));
+}
+void ao_setSmartChargingCurrentOutput_m(unsigned int connectorId, OutputFloat_m maxCurrentOutput) {
+    setSmartChargingCurrentOutput(adaptFn(connectorId, maxCurrentOutput), connectorId);
+}
+void ao_setSmartChargingOutput(OutputSmartCharging chargingLimitOutput) {
+    setSmartChargingOutput(adaptFn(chargingLimitOutput));
+}
+void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputSmartCharging_m chargingLimitOutput) {
+    setSmartChargingOutput(adaptFn(connectorId, chargingLimitOutput), connectorId);
 }
 
 void ao_setEvReadyInput(InputBool evReadyInput) {
@@ -226,6 +264,13 @@ void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterVal
     
     addMeterValueInput(std::move(svs), connectorId);
 }
+void ao_setOnResetNotify(bool (*onResetNotify)(bool)) {
+    setOnResetNotify([onResetNotify] (bool isHard) {return onResetNotify(isHard);});
+}
+
+void ao_setOnResetExecute(void (*onResetExecute)(bool)) {
+    setOnResetExecute([onResetExecute] (bool isHard) {onResetExecute(isHard);});
+}
 
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut) {
     setOnUnlockConnectorInOut(adaptFn(onUnlockConnectorInOut));
@@ -248,6 +293,17 @@ void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady)
     setStopTxReadyInput(adaptFn(connectorId, stopTxReady), connectorId);
 }
 
+void ao_setTxNotificationOutput(void (*notificationOutput)(AOTxNotification_c, AOTransaction_c*)) {
+    setTxNotificationOutput([notificationOutput] (ArduinoOcpp::TxNotification notification, ArduinoOcpp::Transaction *tx) {
+        notificationOutput(convertTxNotification(notification), reinterpret_cast<AOTransaction_c*>(tx));
+    });
+}
+void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AOTxNotification_c, AOTransaction_c*)) {
+    setTxNotificationOutput([notificationOutput, connectorId] (ArduinoOcpp::TxNotification notification, ArduinoOcpp::Transaction *tx) {
+        notificationOutput(connectorId, convertTxNotification(notification), reinterpret_cast<AOTransaction_c*>(tx));
+    });
+}
+
 void ao_setOccupiedInput(InputBool occupied) {
     setOccupiedInput(adaptFn(occupied));
 }
@@ -262,28 +318,18 @@ bool ao_isOperative_m(unsigned int connectorId) {
     return isOperative(connectorId);
 }
 
-int ao_getTransactionId() {
-    return getTransaction() ? getTransaction()->getTransactionId() : -1;
-}
-int ao_getTransactionId_m(unsigned int connectorId) {
-    return getTransaction(connectorId) ? getTransaction(connectorId)->getTransactionId() : -1;
+void ao_setOnReceiveRequest(const char *operationType, OnMessage onRequest) {
+    setOnReceiveRequest(operationType, adaptFn(onRequest));
 }
 
-const char *ao_getTransactionIdTag() {
-    return getTransactionIdTag();
-}
-const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
-    return getTransactionIdTag(connectorId);
+void ao_setOnSendConf(const char *operationType, OnMessage onConfirmation) {
+    setOnSendConf(operationType, adaptFn(onConfirmation));
 }
 
 void ao_set_console_out_c(void (*console_out)(const char *msg)) {
     ao_set_console_out(console_out);
 }
 
-OcppHandle *ao_getOcppHandle() {
-    return reinterpret_cast<OcppHandle*>(getOcppContext());
-}
-
 void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
     
     std::string idTag_capture = idTag;
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 2c80c584..350dc170 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -1,27 +1,26 @@
+// matth-x/ArduinoOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
 #ifndef ARDUINOOCPP_C_H
 #define ARDUINOOCPP_C_H
 
 #include <stddef.h>
+
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h>
+#include <ArduinoOcpp/Model/ChargeControl/Notification.h>
+#include <ArduinoOcpp/Model/Transactions/Transaction.h>
 
-struct AConnection;
-typedef struct AConnection AConnection;
+struct OcppConnection;
+typedef struct OcppConnection OcppConnection;
 
 struct MeterValueInput;
 typedef struct MeterValueInput MeterValueInput;
 
-struct OcppHandle;
-typedef struct OcppHandle OcppHandle;
-
 typedef void (*OnMessage) (const char *payload, size_t len);
 typedef void (*OnAbort)   ();
 typedef void (*OnTimeout) ();
 typedef void (*OnCallError)   (const char *code, const char *description, const char *details_json, size_t details_len);
-//typedef void (*ConfCallback)    (const char *payload, size_t len, void* user_data);
-//typedef void (*AbortCallback)   (void* user_data);
-//typedef void (*TimeoutCallback) (void* user_data);
-//typedef void (*ErrorCallback)   (const char *code, const char *description, const char *details_json, size_t details_len, void* user_data);
 typedef void (*AuthorizeConfCallback)    (const char *idTag, const char *payload, size_t len, void *user_data);
 typedef void (*AuthorizeAbortCallback)   (const char *idTag, void* user_data);
 typedef void (*AuthorizeTimeoutCallback) (const char *idTag, void* user_data);
@@ -37,6 +36,8 @@ typedef const char* (*InputString)();
 typedef const char* (*InputString_m)(unsigned int connectorId);
 typedef void (*OutputFloat)(float limit);
 typedef void (*OutputFloat_m)(unsigned int connectorId, float limit);
+typedef void (*OutputSmartCharging)(float power, float current, int nphases);
+typedef void (*OutputSmartCharging_m)(unsigned int connectorId, float power, float current, int nphases);
 enum OptionalBool {OptionalTrue, OptionalFalse, OptionalNone};
 typedef enum OptionalBool (*PollBool)();
 typedef enum OptionalBool (*PollBool_m)(unsigned int connectorId);
@@ -51,14 +52,14 @@ extern "C" {
  */
 
 void ao_initialize(
-            AConnection *osock,  //WebSocket adapter for ArduinoOcpp
+            OcppConnection *conn,  //WebSocket adapter for ArduinoOcpp
             const char *chargePointModel,     //model name of this charger (e.g. "")
             const char *chargePointVendor, //brand name
             struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 //same as above, but more fields for the BootNotification
 void ao_initialize_full(
-            AConnection *osock,  //WebSocket adapter for ArduinoOcpp
+            OcppConnection *conn,  //WebSocket adapter for ArduinoOcpp
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
@@ -80,9 +81,15 @@ void ao_beginTransaction_authorized_m(unsigned int connectorId, const char *idTa
 bool ao_endTransaction(const char *idTag, const char *reason); //idTag, reason can be NULL
 bool ao_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason); //idTag, reason can be NULL
 
+bool ao_isTransactionActive();
+bool ao_isTransactionActive_m(unsigned int connectorId);
+
 bool ao_isTransactionRunning();
 bool ao_isTransactionRunning_m(unsigned int connectorId);
 
+const char *ao_getTransactionIdTag();
+const char *ao_getTransactionIdTag_m(unsigned int connectorId);
+
 bool ao_ocppPermitsCharge();
 bool ao_ocppPermitsCharge_m(unsigned int connectorId);
 
@@ -99,8 +106,12 @@ void ao_setEnergyMeterInput_m(unsigned int connectorId, InputInt_m energyInput);
 void ao_setPowerMeterInput(InputFloat powerInput);
 void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat_m powerInput);
 
-void ao_setSmartChargingOutput(OutputFloat chargingLimitOutput);
-void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputFloat_m chargingLimitOutput);
+void ao_setSmartChargingPowerOutput(OutputFloat maxPowerOutput);
+void ao_setSmartChargingPowerOutput_m(unsigned int connectorId, OutputFloat_m maxPowerOutput);
+void ao_setSmartChargingCurrentOutput(OutputFloat maxCurrentOutput);
+void ao_setSmartChargingCurrentOutput_m(unsigned int connectorId, OutputFloat_m maxCurrentOutput);
+void ao_setSmartChargingOutput(OutputSmartCharging chargingLimitOutput);
+void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputSmartCharging_m chargingLimitOutput);
 
 /*
  * Define the Inputs and Outputs of this library. (Advanced)
@@ -121,17 +132,24 @@ void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt_m valueInput,
 void ao_addMeterValueInput(MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 
-void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
-void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);
+void ao_setOnResetNotify(bool (*onResetNotify)(bool));
 
-void ao_setStartTxReadyInput(InputBool startTxReady);
-void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxReady);
+void ao_setOnResetExecute(void (*onResetExecute)(bool));
+
+void ao_setOccupiedInput(InputBool occupied);
+void ao_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied);
 
 void ao_setStartTxReadyInput(InputBool startTxReady);
 void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxReady);
 
-void ao_setOccupiedInput(InputBool occupied);
-void ao_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied);
+void ao_setStopTxReadyInput(InputBool stopTxReady);
+void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady);
+
+void ao_setTxNotificationOutput(void (*notificationOutput)(AOTxNotification_c, AOTransaction_c*));
+void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AOTxNotification_c, AOTransaction_c*));
+
+void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
+void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);
 
 /*
  * Access further information about the internal state of the library
@@ -140,12 +158,6 @@ void ao_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied);
 bool ao_isOperative();
 bool ao_isOperative_m(unsigned int connectorId);
 
-int ao_getTransactionId();
-int ao_getTransactionId_m(unsigned int connectorId);
-
-const char *ao_getTransactionIdTag();
-const char *ao_getTransactionIdTag_m(unsigned int connectorId);
-
 void ao_setOnReceiveRequest(const char *operationType, OnMessage onRequest);
 
 void ao_setOnSendConf(const char *operationType, OnMessage onConfirmation);
@@ -156,12 +168,6 @@ void ao_setOnSendConf(const char *operationType, OnMessage onConfirmation);
  */
 void ao_set_console_out_c(void (*console_out)(const char *msg));
 
-/*
- * Get access to the internals
- */
-
-OcppHandle *ao_getOcppHandle();
-
 /*
  * Send OCPP operations
  */

From 3647f899c294f0413e7059be008e58c2c9bf6308 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 1 Jul 2023 15:18:50 +0200
Subject: [PATCH 311/549] add API test case

---
 CMakeLists.txt        |   1 +
 src/ArduinoOcpp.cpp   |  44 +++++------
 src/ArduinoOcpp.h     |   8 +-
 src/ArduinoOcpp_c.cpp |  14 ++--
 src/ArduinoOcpp_c.h   |   8 +-
 tests/Api.cpp         | 175 ++++++++++++++++++++++++++++++++++++++++++
 6 files changed, 213 insertions(+), 37 deletions(-)
 create mode 100644 tests/Api.cpp

diff --git a/CMakeLists.txt b/CMakeLists.txt
index a7b4feb1..5bebbd8f 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -121,6 +121,7 @@ set(AO_SRC_UNIT
     tests/ChargingSessions.cpp
     tests/ConfigurationBehavior.cpp
     tests/SmartCharging.cpp
+    tests/Api.cpp
 )
 
 add_executable(ao_unit_tests
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 05b42651..2cd9bf9a 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -600,28 +600,6 @@ void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigne
     model.getMeteringService()->addMeterValueSampler(connectorId, std::move(valueInput));
 }
 
-void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
-    if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-
-    if (auto rService = context->getModel().getResetService()) {
-        rService->setPreReset(onResetNotify);
-    }
-}
-
-void setOnResetExecute(std::function<void(bool)> onResetExecute) {
-    if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
-        return;
-    }
-
-    if (auto rService = context->getModel().getResetService()) {
-        rService->setExecuteReset(onResetExecute);
-    }
-}
-
 void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
@@ -702,6 +680,28 @@ bool isOperative(unsigned int connectorId) {
     return chargePoint->isOperative() && connector->isOperative();
 }
 
+void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
+    if (!context) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+
+    if (auto rService = context->getModel().getResetService()) {
+        rService->setPreReset(onResetNotify);
+    }
+}
+
+void setOnResetExecute(std::function<void(bool)> onResetExecute) {
+    if (!context) {
+        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        return;
+    }
+
+    if (auto rService = context->getModel().getResetService()) {
+        rService->setExecuteReset(onResetExecute);
+    }
+}
+
 #if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
 FirmwareService *getFirmwareService() {
     auto& model = context->getModel();
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index ba77cea9..9fedc7f7 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -248,10 +248,6 @@ void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measur
 
 void addMeterValueInput(std::unique_ptr<ArduinoOcpp::SampledValueSampler> valueInput, unsigned int connectorId = 1); //integrate further metering Inputs (more extensive alternative)
 
-void setOnResetNotify(std::function<bool(bool)> onResetNotify); //call onResetNotify(isHard) before Reset. If you return false, Reset will be aborted. Optional
-
-void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handler. This function should reboot this controller immediately. Already defined for the ESP32 on Arduino
-
 void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId = 1); //Input if instead of Available, send StatusNotification Preparing / Finishing
 
 void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId = 1); //Input if the charger is ready for StartTransaction
@@ -278,6 +274,10 @@ bool isOperative(unsigned int connectorId = 1); //if the charge point is operati
  * Configure the device management
  */
 
+void setOnResetNotify(std::function<bool(bool)> onResetNotify); //call onResetNotify(isHard) before Reset. If you return false, Reset will be aborted. Optional
+
+void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handler. This function should reboot this controller immediately. Already defined for the ESP32 on Arduino
+
 #if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
 #include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 7b7eac7a..2820a744 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -264,13 +264,6 @@ void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterVal
     
     addMeterValueInput(std::move(svs), connectorId);
 }
-void ao_setOnResetNotify(bool (*onResetNotify)(bool)) {
-    setOnResetNotify([onResetNotify] (bool isHard) {return onResetNotify(isHard);});
-}
-
-void ao_setOnResetExecute(void (*onResetExecute)(bool)) {
-    setOnResetExecute([onResetExecute] (bool isHard) {onResetExecute(isHard);});
-}
 
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut) {
     setOnUnlockConnectorInOut(adaptFn(onUnlockConnectorInOut));
@@ -317,6 +310,13 @@ bool ao_isOperative() {
 bool ao_isOperative_m(unsigned int connectorId) {
     return isOperative(connectorId);
 }
+void ao_setOnResetNotify(bool (*onResetNotify)(bool)) {
+    setOnResetNotify([onResetNotify] (bool isHard) {return onResetNotify(isHard);});
+}
+
+void ao_setOnResetExecute(void (*onResetExecute)(bool)) {
+    setOnResetExecute([onResetExecute] (bool isHard) {onResetExecute(isHard);});
+}
 
 void ao_setOnReceiveRequest(const char *operationType, OnMessage onRequest) {
     setOnReceiveRequest(operationType, adaptFn(onRequest));
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 350dc170..3423f3d0 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -132,10 +132,6 @@ void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt_m valueInput,
 void ao_addMeterValueInput(MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 
-void ao_setOnResetNotify(bool (*onResetNotify)(bool));
-
-void ao_setOnResetExecute(void (*onResetExecute)(bool));
-
 void ao_setOccupiedInput(InputBool occupied);
 void ao_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied);
 
@@ -158,6 +154,10 @@ void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnloc
 bool ao_isOperative();
 bool ao_isOperative_m(unsigned int connectorId);
 
+void ao_setOnResetNotify(bool (*onResetNotify)(bool));
+
+void ao_setOnResetExecute(void (*onResetExecute)(bool));
+
 void ao_setOnReceiveRequest(const char *operationType, OnMessage onRequest);
 
 void ao_setOnSendConf(const char *operationType, OnMessage onConfirmation);
diff --git a/tests/Api.cpp b/tests/Api.cpp
new file mode 100644
index 00000000..86a94647
--- /dev/null
+++ b/tests/Api.cpp
@@ -0,0 +1,175 @@
+#include <ArduinoOcpp.h>
+#include <ArduinoOcpp/Core/Connection.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <ArduinoOcpp/Operations/CustomOperation.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+#define SCPROFILE "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]";
+
+using namespace ArduinoOcpp;
+
+TEST_CASE( "C++ API test" ) {
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+    auto context = getOcppContext();
+    auto& model = context->getModel();
+
+    ao_set_timer(custom_timer_cb);
+
+    model.getClock().setTime(BASE_TIME);
+
+    endTransaction();
+
+    SECTION("Run all functions") {
+
+        //Set all possible Inputs and outputs
+        std::array<bool, 1024> checkpoints {false};
+        size_t ncheck = 0;
+
+        setConnectorPluggedInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
+        setEnergyMeterInput([c = &checkpoints[ncheck++]] () -> float {*c = true; return 0.f;});
+        setPowerMeterInput([c = &checkpoints[ncheck++]] () -> float {*c = true; return 0.f;});
+        setSmartChargingPowerOutput([] (float) {}); //overridden by CurrentOutput
+        setSmartChargingCurrentOutput([] (float) {}); //overridden by generic SmartChargingOutput
+        setSmartChargingOutput([c = &checkpoints[ncheck++]] (float, float, int) {*c = true;});
+        setEvReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
+        setEvseReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
+        addErrorCodeInput([c = &checkpoints[ncheck++]] () -> const char* {*c = true; return nullptr;});
+        addErrorDataInput([c = &checkpoints[ncheck++]] () -> ArduinoOcpp::ErrorData {*c = true; return nullptr;});
+        addMeterValueInput([c = &checkpoints[ncheck++]] () -> int32_t {*c = true; return 0.f;},
+                "Current.Import");
+
+        ArduinoOcpp::SampledValueProperties svprops;
+        svprops.setMeasurand("Current.Offered");
+        auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
+                                        new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
+                    svprops,
+                    [c = &checkpoints[ncheck++]] (ArduinoOcpp::ReadingContext) -> int32_t {*c = true; return 0;}));
+        addMeterValueInput(std::move(valueSampler));
+
+        setOccupiedInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return false;});
+        setStartTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
+        setStopTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
+        setTxNotificationOutput([c = &checkpoints[ncheck++]] (ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*) {*c = true;});
+        setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> ArduinoOcpp::PollResult<bool> {*c = true; return true;});
+
+        setOnResetNotify([c = &checkpoints[ncheck++]] (bool) -> bool {*c = true; return true;});
+        setOnResetExecute([c = &checkpoints[ncheck++]] (bool) {*c = true;});
+
+        REQUIRE( getFirmwareService() != nullptr );
+        REQUIRE( getDiagnosticsService() != nullptr );
+        REQUIRE( getOcppContext() != nullptr );
+
+        setOnReceiveRequest("StatusNotification", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
+        setOnSendConf("StatusNotification", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
+        sendCustomRequest("DataTransfer", [c = &checkpoints[ncheck++]] () {
+            *c = true;
+            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            doc->to<JsonObject>();
+            return doc;
+        }, [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
+        setCustomRequestHandler("DataTransfer", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;}, [c = &checkpoints[ncheck++]] () {
+            *c = true;
+            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            doc->to<JsonObject>();
+            return doc;
+        });
+
+        //set configuration which uses all Inputs and Outputs
+
+        auto MeterValuesSampledData = ArduinoOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        *MeterValuesSampledData = "Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered";
+
+        std::string out = SCPROFILE;
+        loopback.sendTXT(out);
+
+        //run tx management
+
+        OCPP_loop();
+
+        loop();
+
+        beginTransaction("mIdTag");
+
+        loop();
+
+        REQUIRE(isTransactionActive());
+        REQUIRE(isTransactionRunning());
+        REQUIRE(getTransactionIdTag() != nullptr);
+        REQUIRE(getTransaction() != nullptr);
+        REQUIRE(ocppPermitsCharge());
+
+        endTransaction();
+
+        loop();
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        mtime += 3600 * 1000;
+
+        loop();
+
+        endTransaction();
+
+        loop();
+
+        authorize("mIdTag", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
+        startTransaction("mIdTag", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
+
+        loop();
+
+        stopTransaction([c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
+
+        //occupied Input will be validated when vehiclePlugged is false or undefined
+        setConnectorPluggedInput(nullptr);
+
+        loop();
+
+        //run device management
+
+        REQUIRE(isOperative());
+
+        sendCustomRequest("UnlockConnector", [] () {
+            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            (*doc)["connectorId"] = 1;
+            return doc;
+        }, [] (JsonObject) {});
+
+        sendCustomRequest("Reset", [] () {
+            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            (*doc)["type"] = "Hard";
+            return doc;
+        }, [] (JsonObject) {});
+
+        loop();
+
+        mtime += 3600 * 1000;
+
+        loop();
+        
+        AO_DBG_DEBUG("added %zu checkpoints", ncheck);
+
+        bool checkpointsPassed = true;
+        for (unsigned int i = 0; i < ncheck; i++) {
+            if (!checkpoints[i]) {
+                AO_DBG_ERR("missed checkpoint %u", i);
+                checkpointsPassed = false;
+            }
+        }
+
+        REQUIRE(checkpointsPassed);
+    }
+
+    OCPP_deinitialize();
+}

From f08ca30198a13e74d3240c8aa2d6dc2cbf68a2e4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 1 Jul 2023 18:20:23 +0200
Subject: [PATCH 312/549] add C-API test case

---
 CMakeLists.txt        |   1 +
 src/ArduinoOcpp_c.cpp |  13 ++-
 src/ArduinoOcpp_c.h   |   3 +
 tests/Api.cpp         | 190 ++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 206 insertions(+), 1 deletion(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 5bebbd8f..3ca11629 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -138,6 +138,7 @@ target_include_directories(ao_unit_tests PUBLIC
 
 target_compile_definitions(ao_unit_tests PUBLIC
     AO_PLATFORM=AO_PLATFORM_UNIX
+    AO_NUMCONNECTORS=3
     AO_CUSTOM_TIMER
     AO_CUSTOM_WS
     AO_CUSTOM_UPDATER
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 2820a744..d699e1f7 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -180,6 +180,17 @@ const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
     return getTransactionIdTag(connectorId);
 }
 
+AOTransaction_c *ao_getTransaction() {
+    return ao_getTransaction_m(1);
+}
+AOTransaction_c *ao_getTransaction_m(unsigned int connectorId) {
+    if (getTransaction(connectorId)) {
+        return reinterpret_cast<AOTransaction_c*>(getTransaction(connectorId).get());
+    } else {
+        return NULL;
+    }
+}
+
 bool ao_ocppPermitsCharge() {
     return ocppPermitsCharge();
 }
@@ -294,7 +305,7 @@ void ao_setTxNotificationOutput(void (*notificationOutput)(AOTxNotification_c, A
 void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AOTxNotification_c, AOTransaction_c*)) {
     setTxNotificationOutput([notificationOutput, connectorId] (ArduinoOcpp::TxNotification notification, ArduinoOcpp::Transaction *tx) {
         notificationOutput(connectorId, convertTxNotification(notification), reinterpret_cast<AOTransaction_c*>(tx));
-    });
+    }, connectorId);
 }
 
 void ao_setOccupiedInput(InputBool occupied) {
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 3423f3d0..4c535ff3 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -90,6 +90,9 @@ bool ao_isTransactionRunning_m(unsigned int connectorId);
 const char *ao_getTransactionIdTag();
 const char *ao_getTransactionIdTag_m(unsigned int connectorId);
 
+AOTransaction_c *ao_getTransaction();
+AOTransaction_c *ao_getTransaction_m(unsigned int connectorId);
+
 bool ao_ocppPermitsCharge();
 bool ao_ocppPermitsCharge_m(unsigned int connectorId);
 
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 86a94647..7bff2dde 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -172,4 +172,194 @@ TEST_CASE( "C++ API test" ) {
     }
 
     OCPP_deinitialize();
+
+    REQUIRE(!getOcppContext());
+}
+
+#include <ArduinoOcpp_c.h>
+#include <ArduinoOcpp/Core/ConfigurationOptions.h>
+
+std::array<bool, 1024> checkpointsc {false};
+size_t ncheckc = 0;
+
+TEST_CASE( "C API test" ) {
+
+    //initialize Context with dummy socket
+    struct AO_FilesystemOpt fsopt;
+    fsopt.use = true;
+    fsopt.mount = true;
+    fsopt.formatFsOnFail = true;
+
+    LoopbackConnection loopback;
+    ao_initialize(reinterpret_cast<OcppConnection*>(&loopback), "test-runner1234", "vendor", fsopt);
+    
+    auto context = getOcppContext();
+    auto& model = context->getModel();
+
+    ao_set_timer(custom_timer_cb);
+
+    model.getClock().setTime(BASE_TIME);
+
+    ao_endTransaction(NULL, NULL);
+
+    SECTION("Run all functions") {
+
+        ao_setConnectorPluggedInput([] () -> bool {checkpointsc[0] = true; return true;}); ncheckc++;
+        ao_setConnectorPluggedInput_m(2, [] (unsigned int) -> bool {checkpointsc[1] = true; return true;}); ncheckc++;
+        ao_setEnergyMeterInput([] () -> int {checkpointsc[2] = true; return 0;}); ncheckc++;
+        ao_setEnergyMeterInput_m(2, [] (unsigned int) -> int {checkpointsc[3] = true; return 0;}); ncheckc++;
+        ao_setPowerMeterInput([] () -> float {checkpointsc[4] = true; return 0.f;}); ncheckc++;
+        ao_setPowerMeterInput_m(2, [] (unsigned int) -> float {checkpointsc[5] = true; return 0.f;}); ncheckc++;
+        ao_setSmartChargingPowerOutput([] (float) {}); //overridden by CurrentOutput
+        ao_setSmartChargingPowerOutput_m(2, [] (unsigned int, float) {}); //overridden by CurrentOutput
+        ao_setSmartChargingCurrentOutput([] (float) {}); //overridden by generic SmartChargingOutput
+        ao_setSmartChargingCurrentOutput_m(2, [] (unsigned int, float) {}); //overridden by generic SmartChargingOutput
+        ao_setSmartChargingOutput([] (float, float, int) {checkpointsc[6] = true;}); ncheckc++;
+        ao_setSmartChargingOutput_m(2, [] (unsigned int, float, float, int) {checkpointsc[7] = true;}); ncheckc++;
+        ao_setEvReadyInput([] () -> bool {checkpointsc[8] = true; return true;}); ncheckc++;
+        ao_setEvReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[9] = true; return true;}); ncheckc++;
+        ao_setEvseReadyInput([] () -> bool {checkpointsc[10] = true; return true;}); ncheckc++;
+        ao_setEvseReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[11] = true; return true;}); ncheckc++;
+        ao_addErrorCodeInput([] () -> const char* {checkpointsc[12] = true; return nullptr;}); ncheckc++;
+        ao_addErrorCodeInput_m(2, [] (unsigned int) -> const char* {checkpointsc[13] = true; return nullptr;}); ncheckc++;
+        ao_addMeterValueInputInt([] () -> int {checkpointsc[14] = true; return 0;}, "Current.Import", "A", NULL, NULL); ncheckc++;
+        ao_addMeterValueInputInt_m(2, [] (unsigned int) -> int {checkpointsc[15] = true; return 0;}, "Current.Import", "A", NULL, NULL); ncheckc++;
+        
+        ArduinoOcpp::SampledValueProperties svprops;
+        svprops.setMeasurand("Current.Offered");
+        auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
+                                        new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
+                    svprops,
+                    [] (ArduinoOcpp::ReadingContext) -> int32_t {checkpointsc[16] = true; return 0;})); ncheckc++;
+        ao_addMeterValueInput(reinterpret_cast<MeterValueInput*>(valueSampler.release()));
+
+        valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
+                                        new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
+                    svprops,
+                    [] (ArduinoOcpp::ReadingContext) -> int32_t {checkpointsc[17] = true; return 0;})); ncheckc++;
+        ao_addMeterValueInput_m(2, reinterpret_cast<MeterValueInput*>(valueSampler.release()));
+
+        ao_setOccupiedInput([] () -> bool {checkpointsc[18] = true; return true;}); ncheckc++;
+        ao_setOccupiedInput_m(2, [] (unsigned int) -> bool {checkpointsc[19] = true; return true;}); ncheckc++;
+        ao_setStartTxReadyInput([] () -> bool {checkpointsc[20] = true; return true;}); ncheckc++;
+        ao_setStartTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[21] = true; return true;}); ncheckc++;
+        ao_setStopTxReadyInput([] () -> bool {checkpointsc[22] = true; return true;}); ncheckc++;
+        ao_setStopTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[23] = true; return true;}); ncheckc++;
+        ao_setTxNotificationOutput([] (AOTxNotification_c, AOTransaction_c*) {checkpointsc[24] = true;}); ncheckc++;
+        ao_setTxNotificationOutput_m(2, [] (unsigned int, AOTxNotification_c, AOTransaction_c*) {checkpointsc[25] = true;}); ncheckc++;
+        ao_setOnUnlockConnectorInOut([] () -> OptionalBool {checkpointsc[26] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
+        ao_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> OptionalBool {checkpointsc[27] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
+
+        ao_setOnResetNotify([] (bool) -> bool {checkpointsc[28] = true; return true;}); ncheckc++;
+        ao_setOnResetExecute([] (bool) {checkpointsc[29] = true;}); ncheckc++;
+
+        ao_setOnReceiveRequest("StatusNotification", [] (const char*,size_t) {checkpointsc[30] = true;}); ncheckc++;
+        ao_setOnSendConf("StatusNotification", [] (const char*,size_t) {checkpointsc[31] = true;}); ncheckc++;
+
+        //set configuration which uses all Inputs and Outputs
+
+        auto MeterValuesSampledData = ArduinoOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        *MeterValuesSampledData = "Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered";
+
+        std::string out = SCPROFILE;
+        loopback.sendTXT(out);
+
+        //run tx management
+
+        ao_loop();
+
+        loop();
+
+        ao_beginTransaction("mIdTag");
+        ao_beginTransaction_m(2, "mIdTag");
+
+        loop();
+
+        REQUIRE(ao_isTransactionActive());
+        REQUIRE(ao_isTransactionActive_m(2));
+        REQUIRE(ao_isTransactionRunning());
+        REQUIRE(ao_isTransactionRunning_m(2));
+        REQUIRE(ao_getTransactionIdTag() != nullptr);
+        REQUIRE(ao_getTransactionIdTag_m(2) != nullptr);
+        REQUIRE(ao_getTransaction() != nullptr);
+        REQUIRE(ao_getTransaction_m(2) != nullptr);
+        REQUIRE(ao_ocppPermitsCharge());
+        REQUIRE(ao_ocppPermitsCharge_m(2));
+
+        ao_endTransaction(NULL, NULL);
+        ao_endTransaction_m(2, NULL, NULL);
+
+        loop();
+
+        ao_beginTransaction_authorized("mIdTag", NULL);
+        ao_beginTransaction_authorized_m(2, "mIdTag", NULL);
+
+        loop();
+
+        mtime += 3600 * 1000;
+
+        loop();
+
+        ao_endTransaction(NULL, NULL);
+        ao_endTransaction_m(2, NULL, NULL);
+
+        loop();
+
+        ao_authorize("mIdTag", [] (const char*,const char*,size_t,void*) {checkpointsc[32] = true;}, NULL, NULL, NULL, NULL); ncheckc++;
+        ao_startTransaction("mIdTag", [] (const char*,size_t) {checkpointsc[33] = true;}, NULL, NULL, NULL); ncheckc++;
+
+        loop();
+
+        ao_stopTransaction([] (const char*,size_t) {checkpointsc[34] = true;}, NULL, NULL, NULL); ncheckc++;
+
+        //occupied Input will be validated when vehiclePlugged is false or undefined
+        ao_setConnectorPluggedInput([] () {return false;});
+        ao_setConnectorPluggedInput_m(2,[] (unsigned int) {return false;});
+
+        loop();
+
+        //run device management
+
+        REQUIRE(ao_isOperative());
+        REQUIRE(ao_isOperative_m(2));
+
+        sendCustomRequest("UnlockConnector", [] () {
+            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            (*doc)["connectorId"] = 1;
+            return doc;
+        }, [] (JsonObject) {});
+        sendCustomRequest("UnlockConnector", [] () {
+            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            (*doc)["connectorId"] = 2;
+            return doc;
+        }, [] (JsonObject) {});
+
+        sendCustomRequest("Reset", [] () {
+            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            (*doc)["type"] = "Hard";
+            return doc;
+        }, [] (JsonObject) {});
+
+        loop();
+
+        mtime += 3600 * 1000;
+
+        loop();
+        
+        AO_DBG_DEBUG("added %zu checkpoints", ncheckc);
+
+        bool checkpointsPassed = true;
+        for (unsigned int i = 0; i < ncheckc; i++) {
+            if (!checkpointsc[i]) {
+                AO_DBG_ERR("missed checkpoint %u", i);
+                checkpointsPassed = false;
+            }
+        }
+
+        REQUIRE(checkpointsPassed);
+    }
+
+    ao_deinitialize();
+
+    REQUIRE(!getOcppContext());
 }

From 968408b06315d5fd601861b22b3e10255bdfb249 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 1 Jul 2023 19:02:11 +0200
Subject: [PATCH 313/549] consistent C handler naming

---
 .../Model/ChargeControl/Notification.cpp      | 24 ++++++-------
 .../Model/ChargeControl/Notification.h        |  4 +--
 .../Model/Transactions/Transaction.cpp        | 30 ++++++++--------
 .../Model/Transactions/Transaction.h          | 34 +++++++++----------
 src/ArduinoOcpp_c.cpp                         | 18 +++++-----
 src/ArduinoOcpp_c.h                           | 16 ++++-----
 tests/Api.cpp                                 |  6 ++--
 7 files changed, 66 insertions(+), 66 deletions(-)

diff --git a/src/ArduinoOcpp/Model/ChargeControl/Notification.cpp b/src/ArduinoOcpp/Model/ChargeControl/Notification.cpp
index 4262d5a0..ed1dd976 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Notification.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Notification.cpp
@@ -6,39 +6,39 @@
 
 namespace ArduinoOcpp {
 
-AOTxNotification_c convertTxNotification(TxNotification txn) {
-    auto res = AOTxNotification_c::AuthorizationRejected;
+AO_TxNotification convertTxNotification(TxNotification txn) {
+    auto res = AO_TxNotification::AuthorizationRejected;
     
     switch (txn) {
         case TxNotification::AuthorizationRejected:
-            res = AOTxNotification_c::AuthorizationRejected;
+            res = AO_TxNotification::AuthorizationRejected;
             break;
         case TxNotification::AuthorizationTimeout:
-            res = AOTxNotification_c::AuthorizationTimeout;
+            res = AO_TxNotification::AuthorizationTimeout;
             break;
         case TxNotification::Authorized:
-            res = AOTxNotification_c::Authorized;
+            res = AO_TxNotification::Authorized;
             break;
         case TxNotification::ConnectionTimeout:
-            res = AOTxNotification_c::ConnectionTimeout;
+            res = AO_TxNotification::ConnectionTimeout;
             break;
         case TxNotification::DeAuthorized:
-            res = AOTxNotification_c::DeAuthorized;
+            res = AO_TxNotification::DeAuthorized;
             break;
         case TxNotification::RemoteStart:
-            res = AOTxNotification_c::RemoteStart;
+            res = AO_TxNotification::RemoteStart;
             break;
         case TxNotification::RemoteStop:
-            res = AOTxNotification_c::RemoteStop;
+            res = AO_TxNotification::RemoteStop;
             break;
         case TxNotification::ReservationConflict:
-            res = AOTxNotification_c::ReservationConflict;
+            res = AO_TxNotification::ReservationConflict;
             break;
         case TxNotification::StartTx:
-            res = AOTxNotification_c::StartTx;
+            res = AO_TxNotification::StartTx;
             break;
         case TxNotification::StopTx:
-            res = AOTxNotification_c::StopTx;
+            res = AO_TxNotification::StopTx;
             break;
     }
 
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Notification.h b/src/ArduinoOcpp/Model/ChargeControl/Notification.h
index d6faa848..2c660cdd 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Notification.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Notification.h
@@ -31,7 +31,7 @@ enum class TxNotification {
 extern "C" {
 #endif //__cplusplus
 
-enum AOTxNotification_c {
+enum AO_TxNotification {
     //Authorization events
     Authorized, //success
     AuthorizationRejected, //IdTag not authorized
@@ -53,7 +53,7 @@ enum AOTxNotification_c {
 
 namespace ArduinoOcpp {
 
-AOTxNotification_c convertTxNotification(TxNotification txn);
+AO_TxNotification convertTxNotification(TxNotification txn);
 
 } //end namespace ArduinoOcpp
 
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
index 16c89d7b..d733a018 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.cpp
@@ -26,57 +26,57 @@ bool Transaction::commit() {
     return context.commit(this);
 }
 
-int ao_tx_getTransactionId(AOTransaction_c *tx) {
+int ao_tx_getTransactionId(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getTransactionId();
 }
-bool ao_tx_isAuthorized(AOTransaction_c *tx) {
+bool ao_tx_isAuthorized(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isAuthorized();
 }
-bool ao_tx_isIdTagDeauthorized(AOTransaction_c *tx) {
+bool ao_tx_isIdTagDeauthorized(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isIdTagDeauthorized();
 }
 
-bool ao_tx_isRunning(AOTransaction_c *tx) {
+bool ao_tx_isRunning(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isRunning();
 }
-bool ao_tx_isActive(AOTransaction_c *tx) {
+bool ao_tx_isActive(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isActive();
 }
-bool ao_tx_isAborted(AOTransaction_c *tx) {
+bool ao_tx_isAborted(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isAborted();
 }
-bool ao_tx_isCompleted(AOTransaction_c *tx) {
+bool ao_tx_isCompleted(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isCompleted();
 }
 
-const char *ao_tx_getIdTag(AOTransaction_c *tx) {
+const char *ao_tx_getIdTag(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getIdTag();
 }
 
-bool ao_tx_getBeginTimestamp(AOTransaction_c *tx, char *buf, size_t len) {
+bool ao_tx_getBeginTimestamp(AO_Transaction *tx, char *buf, size_t len) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getBeginTimestamp().toJsonString(buf, len);
 }
 
-int32_t ao_tx_getMeterStart(AOTransaction_c *tx) {
+int32_t ao_tx_getMeterStart(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getMeterStart();
 }
 
-bool ao_tx_getStartTimestamp(AOTransaction_c *tx, char *buf, size_t len) {
+bool ao_tx_getStartTimestamp(AO_Transaction *tx, char *buf, size_t len) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStartTimestamp().toJsonString(buf, len);
 }
 
-const char *ao_tx_getStopIdTag(AOTransaction_c *tx) {
+const char *ao_tx_getStopIdTag(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStopIdTag();
 }
 
-int32_t ao_tx_getMeterStop(AOTransaction_c *tx) {
+int32_t ao_tx_getMeterStop(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getMeterStop();
 }
 
-bool ao_tx_getStopTimestamp(AOTransaction_c *tx, char *buf, size_t len) {
+bool ao_tx_getStopTimestamp(AO_Transaction *tx, char *buf, size_t len) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStopTimestamp().toJsonString(buf, len);
 }
 
-const char *ao_tx_getStopReason(AOTransaction_c *tx) {
+const char *ao_tx_getStopReason(AO_Transaction *tx) {
     return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStopReason();
 }
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.h b/src/ArduinoOcpp/Model/Transactions/Transaction.h
index c4dbac6b..7e9bbf53 100644
--- a/src/ArduinoOcpp/Model/Transactions/Transaction.h
+++ b/src/ArduinoOcpp/Model/Transactions/Transaction.h
@@ -170,33 +170,33 @@ class Transaction {
 extern "C" {
 #endif //__cplusplus
 
-struct AOTransaction_c;
-typedef struct AOTransaction_c AOTransaction_c;
+struct AO_Transaction;
+typedef struct AO_Transaction AO_Transaction;
 
-int ao_tx_getTransactionId(AOTransaction_c *tx);
-bool ao_tx_isAuthorized(AOTransaction_c *tx);
-bool ao_tx_isIdTagDeauthorized(AOTransaction_c *tx);
+int ao_tx_getTransactionId(AO_Transaction *tx);
+bool ao_tx_isAuthorized(AO_Transaction *tx);
+bool ao_tx_isIdTagDeauthorized(AO_Transaction *tx);
 
-bool ao_tx_isRunning(AOTransaction_c *tx);
-bool ao_tx_isActive(AOTransaction_c *tx);
-bool ao_tx_isAborted(AOTransaction_c *tx);
-bool ao_tx_isCompleted(AOTransaction_c *tx);
+bool ao_tx_isRunning(AO_Transaction *tx);
+bool ao_tx_isActive(AO_Transaction *tx);
+bool ao_tx_isAborted(AO_Transaction *tx);
+bool ao_tx_isCompleted(AO_Transaction *tx);
 
-const char *ao_tx_getIdTag(AOTransaction_c *tx);
+const char *ao_tx_getIdTag(AO_Transaction *tx);
 
-bool ao_tx_getBeginTimestamp(AOTransaction_c *tx, char *buf, size_t len);
+bool ao_tx_getBeginTimestamp(AO_Transaction *tx, char *buf, size_t len);
 
-int32_t ao_tx_getMeterStart(AOTransaction_c *tx);
+int32_t ao_tx_getMeterStart(AO_Transaction *tx);
 
-bool ao_tx_getStartTimestamp(AOTransaction_c *tx, char *buf, size_t len);
+bool ao_tx_getStartTimestamp(AO_Transaction *tx, char *buf, size_t len);
 
-const char *ao_tx_getStopIdTag(AOTransaction_c *tx);
+const char *ao_tx_getStopIdTag(AO_Transaction *tx);
 
-int32_t ao_tx_getMeterStop(AOTransaction_c *tx);
+int32_t ao_tx_getMeterStop(AO_Transaction *tx);
 
-bool ao_tx_getStopTimestamp(AOTransaction_c *tx, char *buf, size_t len);
+bool ao_tx_getStopTimestamp(AO_Transaction *tx, char *buf, size_t len);
 
-const char *ao_tx_getStopReason(AOTransaction_c *tx);
+const char *ao_tx_getStopReason(AO_Transaction *tx);
 
 #ifdef __cplusplus
 } //end extern "C"
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index d699e1f7..9301faf1 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -9,11 +9,11 @@
 
 ArduinoOcpp::Connection *ocppSocket = nullptr;
 
-void ao_initialize(OcppConnection *conn, const char *chargePointModel, const char *chargePointVendor, struct AO_FilesystemOpt fsopt) {
+void ao_initialize(AO_Connection *conn, const char *chargePointModel, const char *chargePointVendor, struct AO_FilesystemOpt fsopt) {
     ao_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt);
 }
 
-void ao_initialize_full(OcppConnection *conn, const char *bootNotificationCredentials, struct AO_FilesystemOpt fsopt) {
+void ao_initialize_full(AO_Connection *conn, const char *bootNotificationCredentials, struct AO_FilesystemOpt fsopt) {
     if (!conn) {
         AO_DBG_ERR("conn is null");
     }
@@ -180,12 +180,12 @@ const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
     return getTransactionIdTag(connectorId);
 }
 
-AOTransaction_c *ao_getTransaction() {
+AO_Transaction *ao_getTransaction() {
     return ao_getTransaction_m(1);
 }
-AOTransaction_c *ao_getTransaction_m(unsigned int connectorId) {
+AO_Transaction *ao_getTransaction_m(unsigned int connectorId) {
     if (getTransaction(connectorId)) {
-        return reinterpret_cast<AOTransaction_c*>(getTransaction(connectorId).get());
+        return reinterpret_cast<AO_Transaction*>(getTransaction(connectorId).get());
     } else {
         return NULL;
     }
@@ -297,14 +297,14 @@ void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady)
     setStopTxReadyInput(adaptFn(connectorId, stopTxReady), connectorId);
 }
 
-void ao_setTxNotificationOutput(void (*notificationOutput)(AOTxNotification_c, AOTransaction_c*)) {
+void ao_setTxNotificationOutput(void (*notificationOutput)(AO_TxNotification, AO_Transaction*)) {
     setTxNotificationOutput([notificationOutput] (ArduinoOcpp::TxNotification notification, ArduinoOcpp::Transaction *tx) {
-        notificationOutput(convertTxNotification(notification), reinterpret_cast<AOTransaction_c*>(tx));
+        notificationOutput(convertTxNotification(notification), reinterpret_cast<AO_Transaction*>(tx));
     });
 }
-void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AOTxNotification_c, AOTransaction_c*)) {
+void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AO_TxNotification, AO_Transaction*)) {
     setTxNotificationOutput([notificationOutput, connectorId] (ArduinoOcpp::TxNotification notification, ArduinoOcpp::Transaction *tx) {
-        notificationOutput(connectorId, convertTxNotification(notification), reinterpret_cast<AOTransaction_c*>(tx));
+        notificationOutput(connectorId, convertTxNotification(notification), reinterpret_cast<AO_Transaction*>(tx));
     }, connectorId);
 }
 
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 4c535ff3..03df6611 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -11,8 +11,8 @@
 #include <ArduinoOcpp/Model/ChargeControl/Notification.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 
-struct OcppConnection;
-typedef struct OcppConnection OcppConnection;
+struct AO_Connection;
+typedef struct AO_Connection AO_Connection;
 
 struct MeterValueInput;
 typedef struct MeterValueInput MeterValueInput;
@@ -52,14 +52,14 @@ extern "C" {
  */
 
 void ao_initialize(
-            OcppConnection *conn,  //WebSocket adapter for ArduinoOcpp
+            AO_Connection *conn,  //WebSocket adapter for ArduinoOcpp
             const char *chargePointModel,     //model name of this charger (e.g. "")
             const char *chargePointVendor, //brand name
             struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 //same as above, but more fields for the BootNotification
 void ao_initialize_full(
-            OcppConnection *conn,  //WebSocket adapter for ArduinoOcpp
+            AO_Connection *conn,  //WebSocket adapter for ArduinoOcpp
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
@@ -90,8 +90,8 @@ bool ao_isTransactionRunning_m(unsigned int connectorId);
 const char *ao_getTransactionIdTag();
 const char *ao_getTransactionIdTag_m(unsigned int connectorId);
 
-AOTransaction_c *ao_getTransaction();
-AOTransaction_c *ao_getTransaction_m(unsigned int connectorId);
+AO_Transaction *ao_getTransaction();
+AO_Transaction *ao_getTransaction_m(unsigned int connectorId);
 
 bool ao_ocppPermitsCharge();
 bool ao_ocppPermitsCharge_m(unsigned int connectorId);
@@ -144,8 +144,8 @@ void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxRead
 void ao_setStopTxReadyInput(InputBool stopTxReady);
 void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady);
 
-void ao_setTxNotificationOutput(void (*notificationOutput)(AOTxNotification_c, AOTransaction_c*));
-void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AOTxNotification_c, AOTransaction_c*));
+void ao_setTxNotificationOutput(void (*notificationOutput)(AO_TxNotification, AO_Transaction*));
+void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AO_TxNotification, AO_Transaction*));
 
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
 void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 7bff2dde..dc368a00 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -191,7 +191,7 @@ TEST_CASE( "C API test" ) {
     fsopt.formatFsOnFail = true;
 
     LoopbackConnection loopback;
-    ao_initialize(reinterpret_cast<OcppConnection*>(&loopback), "test-runner1234", "vendor", fsopt);
+    ao_initialize(reinterpret_cast<AO_Connection*>(&loopback), "test-runner1234", "vendor", fsopt);
     
     auto context = getOcppContext();
     auto& model = context->getModel();
@@ -245,8 +245,8 @@ TEST_CASE( "C API test" ) {
         ao_setStartTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[21] = true; return true;}); ncheckc++;
         ao_setStopTxReadyInput([] () -> bool {checkpointsc[22] = true; return true;}); ncheckc++;
         ao_setStopTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[23] = true; return true;}); ncheckc++;
-        ao_setTxNotificationOutput([] (AOTxNotification_c, AOTransaction_c*) {checkpointsc[24] = true;}); ncheckc++;
-        ao_setTxNotificationOutput_m(2, [] (unsigned int, AOTxNotification_c, AOTransaction_c*) {checkpointsc[25] = true;}); ncheckc++;
+        ao_setTxNotificationOutput([] (AO_TxNotification, AO_Transaction*) {checkpointsc[24] = true;}); ncheckc++;
+        ao_setTxNotificationOutput_m(2, [] (unsigned int, AO_TxNotification, AO_Transaction*) {checkpointsc[25] = true;}); ncheckc++;
         ao_setOnUnlockConnectorInOut([] () -> OptionalBool {checkpointsc[26] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
         ao_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> OptionalBool {checkpointsc[27] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
 

From 5326be586cdf8ee722d04952ae53514f8a964941 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 1 Jul 2023 22:07:28 +0200
Subject: [PATCH 314/549] fix config validation for measurands

---
 .../Model/Metering/MeteringConnector.cpp      | 75 ++++---------------
 .../Model/Metering/MeteringConnector.h        |  2 +
 .../Model/Metering/MeteringService.cpp        | 63 ++++++++++++++++
 3 files changed, 80 insertions(+), 60 deletions(-)

diff --git a/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
index 33f1525b..5c1c5153 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
@@ -20,39 +20,19 @@ using namespace ArduinoOcpp::Ocpp16;
 MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore& meterStore)
         : model(model), connectorId{connectorId}, meterStore(meterStore) {
 
-    auto MeterValuesSampledData = declareConfiguration<const char*>(
-        "MeterValuesSampledData",
-        "Energy.Active.Import.Register,Power.Active.Import",
-        CONFIGURATION_FN,
-        true,true,true,false
-    );
+    auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData", "", CONFIGURATION_FN);
     declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
     MeterValueCacheSize = declareConfiguration("AO_MeterValueCacheSize", 1, CONFIGURATION_FN, true, true, true, false);
     MeterValueSampleInterval = declareConfiguration("MeterValueSampleInterval", 60);
     
-    auto StopTxnSampledData = declareConfiguration<const char*>(
-        "StopTxnSampledData",
-        "",
-        CONFIGURATION_FN,
-        true,true,true,false
-    );
+    auto StopTxnSampledData = declareConfiguration<const char*>("StopTxnSampledData", "", CONFIGURATION_FN);
     declareConfiguration<int>("StopTxnSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
     
-    auto MeterValuesAlignedData = declareConfiguration<const char*>(
-        "MeterValuesAlignedData",
-        "Energy.Active.Import.Register,Power.Active.Import",
-        CONFIGURATION_FN,
-        true,true,true,false
-    );
+    auto MeterValuesAlignedData = declareConfiguration<const char*>("MeterValuesAlignedData", "", CONFIGURATION_FN);
     declareConfiguration<int>("MeterValuesAlignedDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
     ClockAlignedDataInterval  = declareConfiguration("ClockAlignedDataInterval", 0);
     
-    auto StopTxnAlignedData = declareConfiguration<const char*>(
-        "StopTxnAlignedData",
-        "",
-        CONFIGURATION_FN,
-        true,true,true,false
-    );
+    auto StopTxnAlignedData = declareConfiguration<const char*>("StopTxnAlignedData", "", CONFIGURATION_FN);
 
     MeterValuesInTxOnly = declareConfiguration<bool>("AO_MeterValuesInTxOnly", true, CONFIGURATION_FN, true, true, true, false);
     StopTxnDataCapturePeriodic = declareConfiguration<bool>("AO_StopTxnDataCapturePeriodic", false, CONFIGURATION_FN, true, true, true, false);
@@ -61,42 +41,6 @@ MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore&
     alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData));
     stopTxnSampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnSampledData));
     stopTxnAlignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnAlignedData));
-
-    std::function<bool(const char*)> validateSelectString = [this] (const char *csl) {
-        bool isValid = true;
-        const char *l = csl; //the beginning of an entry of the comma-separated list
-        const char *r = l; //one place after the last character of the entry beginning with l
-        while (*l) {
-            if (*l == ',') {
-                l++;
-                continue;
-            }
-            r = l + 1;
-            while (*r != '\0' && *r != ',') {
-                r++;
-            }
-            bool found = false;
-            for (size_t i = 0; i < samplers.size(); i++) {
-                auto &measurand = samplers[i]->getProperties().getMeasurand();
-                if ((std::ptrdiff_t) measurand.length() == r - l &&                              //same length
-                        !strncmp(l, measurand.c_str(), measurand.length())) {   //same content
-                    found = true;
-                    break;
-                }
-            }
-            if (!found) {
-                isValid = false;
-                AO_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
-                break;
-            }
-            l = r;
-        }
-        return isValid;
-    };
-    MeterValuesSampledData->setValidator(validateSelectString);
-    StopTxnSampledData->setValidator(validateSelectString);
-    MeterValuesAlignedData->setValidator(validateSelectString);
-    StopTxnAlignedData->setValidator(validateSelectString);
 }
 
 std::unique_ptr<Operation> MeteringConnector::loop() {
@@ -282,3 +226,14 @@ std::shared_ptr<TransactionMeterData> MeteringConnector::getStopTxMeterData(Tran
 
     return txData;
 }
+
+bool MeteringConnector::existsSampler(const char *measurand, size_t len) {
+    for (size_t i = 0; i < samplers.size(); i++) {
+        if (samplers[i]->getProperties().getMeasurand().length() == len &&
+                !strncmp(measurand, samplers[i]->getProperties().getMeasurand().c_str(), len)) {
+            return true;
+        }
+    }
+
+    return false;
+}
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringConnector.h b/src/ArduinoOcpp/Model/Metering/MeteringConnector.h
index 2948fc76..f30b9727 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringConnector.h
+++ b/src/ArduinoOcpp/Model/Metering/MeteringConnector.h
@@ -72,6 +72,8 @@ class MeteringConnector {
 
     std::shared_ptr<TransactionMeterData> getStopTxMeterData(Transaction *transaction);
 
+    bool existsSampler(const char *measurand, size_t len);
+
 };
 
 } //end namespace ArduinoOcpp
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
index edec295a..3b3d4b52 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
@@ -5,6 +5,7 @@
 #include <ArduinoOcpp/Model/Metering/MeteringService.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Operations/MeterValues.h>
@@ -15,10 +16,72 @@ using namespace ArduinoOcpp;
 MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
       : context(context), meterStore(filesystem) {
 
+    auto MeterValuesSampledData = declareConfiguration<const char*>(
+        "MeterValuesSampledData",
+        "Energy.Active.Import.Register,Power.Active.Import",
+        CONFIGURATION_FN,
+        true,true,true,false
+    );
+    
+    auto StopTxnSampledData = declareConfiguration<const char*>(
+        "StopTxnSampledData",
+        "",
+        CONFIGURATION_FN,
+        true,true,true,false
+    );
+    
+    auto MeterValuesAlignedData = declareConfiguration<const char*>(
+        "MeterValuesAlignedData",
+        "Energy.Active.Import.Register,Power.Active.Import",
+        CONFIGURATION_FN,
+        true,true,true,false
+    );
+    
+    auto StopTxnAlignedData = declareConfiguration<const char*>(
+        "StopTxnAlignedData",
+        "",
+        CONFIGURATION_FN,
+        true,true,true,false
+    );
+    
     for (int i = 0; i < numConn; i++) {
         connectors.push_back(std::unique_ptr<MeteringConnector>(new MeteringConnector(context.getModel(), i, meterStore)));
     }
 
+    std::function<bool(const char*)> validateSelectString = [this] (const char *csl) {
+        bool isValid = true;
+        const char *l = csl; //the beginning of an entry of the comma-separated list
+        const char *r = l; //one place after the last character of the entry beginning with l
+        while (*l) {
+            if (*l == ',') {
+                l++;
+                continue;
+            }
+            r = l + 1;
+            while (*r != '\0' && *r != ',') {
+                r++;
+            }
+            bool found = false;
+            for (size_t cId = 0; cId < connectors.size(); cId++) {
+                if (connectors[cId]->existsSampler(l, (size_t) (r - l))) {
+                    found = true;
+                    break;
+                }
+            }
+            if (!found) {
+                isValid = false;
+                AO_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
+                break;
+            }
+            l = r;
+        }
+        return isValid;
+    };
+    MeterValuesSampledData->setValidator(validateSelectString);
+    StopTxnSampledData->setValidator(validateSelectString);
+    MeterValuesAlignedData->setValidator(validateSelectString);
+    StopTxnAlignedData->setValidator(validateSelectString);
+
     /*
      * Register further message handlers to support echo mode: when this library
      * is connected with a WebSocket echo server, let it reply to its own requests.

From a5ada3aab25fabeca839a96d523d752d11603b5c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 1 Jul 2023 23:41:53 +0200
Subject: [PATCH 315/549] add Metering test case

---
 CMakeLists.txt                                |   1 +
 src/ArduinoOcpp/Model/Metering/MeterStore.cpp |  10 +-
 src/ArduinoOcpp/Model/Metering/MeterValue.cpp |   4 +
 tests/Api.cpp                                 |   8 +-
 tests/Metering.cpp                            | 330 ++++++++++++++++++
 5 files changed, 343 insertions(+), 10 deletions(-)
 create mode 100644 tests/Metering.cpp

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 3ca11629..8d30db9c 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -122,6 +122,7 @@ set(AO_SRC_UNIT
     tests/ConfigurationBehavior.cpp
     tests/SmartCharging.cpp
     tests/Api.cpp
+    tests/Metering.cpp
 )
 
 add_executable(ao_unit_tests
diff --git a/src/ArduinoOcpp/Model/Metering/MeterStore.cpp b/src/ArduinoOcpp/Model/Metering/MeterStore.cpp
index 3421c132..ba1e792f 100644
--- a/src/ArduinoOcpp/Model/Metering/MeterStore.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeterStore.cpp
@@ -99,12 +99,13 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
     }
 
     const unsigned int MISSES_LIMIT = 3;
+    unsigned int i = 0;
     unsigned int misses = 0;
 
     while (misses < MISSES_LIMIT) { //search until region without mvs found
         
         char fn [AO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvCount);
+        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
         if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
             AO_DBG_ERR("fn error: %i", ret);
             return false; //all files have same length
@@ -114,7 +115,7 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
 
         if (!doc) {
             misses++;
-            mvCount++;
+            i++;
             continue;
         }
 
@@ -124,7 +125,7 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
         if (!mv) {
             AO_DBG_ERR("Deserialization error");
             misses++;
-            mvCount++;
+            i++;
             continue;
         }
 
@@ -135,7 +136,8 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
 
         txData.push_back(std::move(mv));
 
-        mvCount++;
+        mvCount = i;
+        i++;
         misses = 0;
     }
 
diff --git a/src/ArduinoOcpp/Model/Metering/MeterValue.cpp b/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
index 9d218be8..3a86d356 100644
--- a/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeterValue.cpp
@@ -71,6 +71,10 @@ void MeterValueBuilder::updateObservedSamplers() {
         select_mask.resize(samplers.size(), false);
         select_n = 0;
     }
+
+    for (size_t i = 0; i < select_mask.size(); i++) {
+        select_mask[i] = false;
+    }
     
     auto selectStr = select->operator const char *();
     size_t sl = 0, sr = 0;
diff --git a/tests/Api.cpp b/tests/Api.cpp
index dc368a00..114a74a3 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -4,20 +4,16 @@
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Operations/CustomOperation.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 #define SCPROFILE "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]";
 
-using namespace ArduinoOcpp;
-
 TEST_CASE( "C++ API test" ) {
 
     //initialize Context with dummy socket
-    LoopbackConnection loopback;
+    ArduinoOcpp::LoopbackConnection loopback;
     OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto context = getOcppContext();
@@ -190,7 +186,7 @@ TEST_CASE( "C API test" ) {
     fsopt.mount = true;
     fsopt.formatFsOnFail = true;
 
-    LoopbackConnection loopback;
+    ArduinoOcpp::LoopbackConnection loopback;
     ao_initialize(reinterpret_cast<AO_Connection*>(&loopback), "test-runner1234", "vendor", fsopt);
     
     auto context = getOcppContext();
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
new file mode 100644
index 00000000..0bbbfad9
--- /dev/null
+++ b/tests/Metering.cpp
@@ -0,0 +1,330 @@
+#include <ArduinoOcpp.h>
+#include <ArduinoOcpp/Core/Connection.h>
+#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Model/Model.h>
+#include <ArduinoOcpp/Core/Configuration.h>
+#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
+using namespace ArduinoOcpp;
+
+TEST_CASE("Metering") {
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+    auto context = getOcppContext();
+    auto& model = context->getModel();
+
+    ao_set_timer(custom_timer_cb);
+
+    model.getClock().setTime(BASE_TIME);
+
+    endTransaction();
+
+    SECTION("Configure Metering Service") {
+
+        addMeterValueInput([] () {
+            return 0;
+        }, "Energy.Active.Import.Register");
+
+        addMeterValueInput([] () {
+            return 0;
+        }, "Voltage");
+
+        auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        *MeterValuesSampledData = "";
+
+        bool checkProcessed = false;
+
+        //set up measurands and check validation
+        sendCustomRequest("ChangeConfiguration",
+            [] () {
+                //create req
+                auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                auto payload = doc->to<JsonObject>();
+                payload["key"] = "MeterValuesSampledData";
+                payload["value"] = "Energy.Active.Import.Register,INVALID,Voltage"; //invalid request
+                return doc;
+            }, [&checkProcessed] (JsonObject payload) {
+                checkProcessed = true;
+                REQUIRE(!strcmp(payload["status"], "Rejected"));
+            });
+
+        loop();
+
+        REQUIRE(checkProcessed);
+        REQUIRE(!strcmp((const char*) *MeterValuesSampledData, ""));
+
+        checkProcessed = false;
+
+        sendCustomRequest("ChangeConfiguration",
+            [] () {
+                //create req
+                auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                auto payload = doc->to<JsonObject>();
+                payload["key"] = "MeterValuesSampledData";
+                payload["value"] = "Voltage,Energy.Active.Import.Register"; //valid request
+                return doc;
+            }, [&checkProcessed, &model] (JsonObject payload) {
+                checkProcessed = true;
+                REQUIRE(!strcmp(payload["status"], "Accepted"));
+            });
+
+        loop();
+
+        REQUIRE(checkProcessed);
+        REQUIRE(!strcmp((const char*) *MeterValuesSampledData, "Voltage,Energy.Active.Import.Register"));
+    }
+
+    SECTION("Capture Periodic data") {
+
+        Timestamp base;
+        base.setTime(BASE_TIME);
+
+        addMeterValueInput([base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        *MeterValuesSampledData = "Energy.Active.Import.Register";
+
+        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        *MeterValueSampleInterval = 10;
+
+        auto MeterValueCacheSize = declareConfiguration("AO_MeterValueCacheSize", 0, CONFIGURATION_FN);
+        *MeterValueCacheSize = 2;
+
+        bool checkProcessed = false;
+
+        setOnReceiveRequest("MeterValues", [base, &checkProcessed] (JsonObject payload) {
+            checkProcessed = true;
+            Timestamp t0, t1;
+            t0.setTime(payload["meterValue"][0]["timestamp"] | "");
+            t1.setTime(payload["meterValue"][1]["timestamp"] | "");
+
+            REQUIRE((t0 - base >= 10 && t0 - base <= 11));
+            REQUIRE((t1 - base >= 20 && t1 - base <= 21));
+
+            REQUIRE(!strcmp(payload["meterValue"][0]["sampledValue"][0]["context"] | "", "Sample.Periodic"));
+        });
+
+        loop();
+
+        model.getClock().setTime(BASE_TIME);
+
+        auto trackMtime = mtime;
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        mtime = trackMtime + 10 * 1000;
+
+        loop(),
+
+        mtime = trackMtime + 20 * 1000;
+
+        loop();
+
+        endTransaction();
+
+        loop();
+
+        REQUIRE(checkProcessed);
+    }
+
+    SECTION("Capture Clock-aligned data") {
+
+        Timestamp base;
+        base.setTime(BASE_TIME);
+
+        addMeterValueInput([base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        //disablee sampled data
+        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        *MeterValueSampleInterval = 0;
+
+        auto ClockAlignedDataInterval  = declareConfiguration("ClockAlignedDataInterval", 0, CONFIGURATION_FN);
+        *ClockAlignedDataInterval = 900;
+
+        auto MeterValuesAlignedData = declareConfiguration<const char*>("MeterValuesAlignedData", "", CONFIGURATION_FN);
+        *MeterValuesAlignedData = "Energy.Active.Import.Register";
+
+        auto MeterValueCacheSize = declareConfiguration("AO_MeterValueCacheSize", 0, CONFIGURATION_FN);
+        *MeterValueCacheSize = 2;
+
+        bool checkProcessed = false;
+
+        setOnReceiveRequest("MeterValues", [base, &checkProcessed] (JsonObject payload) {
+            checkProcessed = true;
+            Timestamp t0, t1;
+            t0.setTime(payload["meterValue"][0]["timestamp"] | "");
+            t1.setTime(payload["meterValue"][1]["timestamp"] | "");
+
+            REQUIRE((t0 - base >= 900 && t0 - base <= 901));
+            REQUIRE((t1 - base >= 1800 && t1 - base <= 1801));
+
+            REQUIRE(!strcmp(payload["meterValue"][0]["sampledValue"][0]["context"] | "", "Sample.Clock"));
+        });
+
+        model.getClock().setTime("2023-01-01T00:00:10Z");
+        loop();
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        model.getClock().setTime("2023-01-01T00:10:00Z");
+        loop();
+
+        model.getClock().setTime("2023-01-01T00:15:00Z");
+        loop();
+
+        model.getClock().setTime("2023-01-01T00:29:50Z");
+        loop();
+
+        model.getClock().setTime("2023-01-01T00:30:00Z");
+        loop();
+
+        endTransaction();
+
+        loop();
+
+        REQUIRE(checkProcessed);
+    }
+
+    SECTION("Capture transaction-aligned data") {
+
+        Timestamp base;
+        base.setTime(BASE_TIME);
+
+        addMeterValueInput([base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        *MeterValueSampleInterval = 10;
+
+        auto StopTxnSampledData = declareConfiguration<const char*>("StopTxnSampledData", "", CONFIGURATION_FN);
+        *StopTxnSampledData = "Energy.Active.Import.Register";
+
+        loop();
+
+        model.getClock().setTime(BASE_TIME);
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        OCPP_deinitialize(); //check if StopData is stored over reboots
+
+        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        addMeterValueInput([base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        bool checkProcessed = false;
+
+        setOnReceiveRequest("StopTransaction", [base, &checkProcessed] (JsonObject payload) {
+            checkProcessed = true;
+            Timestamp t0, t1;
+            t0.setTime(payload["transactionData"][0]["timestamp"] | "");
+            t1.setTime(payload["transactionData"][1]["timestamp"] | "");
+
+            REQUIRE((t0 - base >= 0 && t0 - base <= 1));
+            REQUIRE((t1 - base >= 3600 && t1 - base <= 3601));
+
+            REQUIRE(!strcmp(payload["transactionData"][0]["sampledValue"][0]["context"] | "", "Transaction.Begin"));
+            REQUIRE(!strcmp(payload["transactionData"][1]["sampledValue"][0]["context"] | "", "Transaction.End"));
+        });
+
+        loop();
+
+        model.getClock().setTime("2023-01-01T01:00:00Z");
+
+        endTransaction();
+
+        loop();
+
+        REQUIRE(checkProcessed);
+    }
+
+    SECTION("Change measurands live") {
+
+        Timestamp base;
+        base.setTime(BASE_TIME);
+
+        addMeterValueInput([base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        addMeterValueInput([] () {
+            return 3600;
+        }, "Power.Active.Import");
+
+        auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        *MeterValuesSampledData = "Energy.Active.Import.Register";
+
+        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        *MeterValueSampleInterval = 10;
+
+        auto MeterValueCacheSize = declareConfiguration("AO_MeterValueCacheSize", 0, CONFIGURATION_FN);
+        *MeterValueCacheSize = 10;
+
+        bool checkProcessed = false;
+
+        setOnReceiveRequest("MeterValues", [base, &checkProcessed] (JsonObject payload) {
+            checkProcessed = true;
+            Timestamp t0, t1;
+            t0.setTime(payload["meterValue"][0]["timestamp"] | "");
+            t1.setTime(payload["meterValue"][1]["timestamp"] | "");
+
+            REQUIRE((t0 - base >= 10 && t0 - base <= 11));
+            REQUIRE((t1 - base >= 20 && t1 - base <= 21));
+            
+            REQUIRE(!strcmp(payload["meterValue"][0]["sampledValue"][0]["measurand"] | "", "Energy.Active.Import.Register"));
+            REQUIRE(!strcmp(payload["meterValue"][1]["sampledValue"][0]["measurand"] | "", "Power.Active.Import"));
+        });
+
+        loop();
+
+        model.getClock().setTime(BASE_TIME);
+
+        auto trackMtime = mtime;
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        mtime = trackMtime + 10 * 1000;
+
+        loop();
+
+        *MeterValuesSampledData = "Power.Active.Import";
+
+        mtime = trackMtime + 20 * 1000;
+
+        loop();
+
+        endTransaction();
+
+        loop();
+
+        REQUIRE(checkProcessed);
+    }
+
+    OCPP_deinitialize();
+}

From f05a1ebe13a22f9e99401dbd3d20b1b3a7f36141 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 2 Jul 2023 18:41:11 +0200
Subject: [PATCH 316/549] more consistent function names

---
 examples/ESP-TLS/main.cpp                  |  4 +-
 examples/ESP/main.cpp                      |  4 +-
 src/ArduinoOcpp.cpp                        | 92 +++++++++++-----------
 src/ArduinoOcpp.h                          | 22 +++---
 src/ArduinoOcpp/Core/Configuration.cpp     |  2 +-
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp |  2 +-
 src/ArduinoOcpp/Core/FilesystemAdapter.h   |  2 +-
 src/ArduinoOcpp_c.cpp                      |  6 +-
 tests/Api.cpp                              | 20 ++---
 tests/ChargingSessions.cpp                 | 28 +++----
 tests/ConfigurationBehavior.cpp            |  4 +-
 tests/Metering.cpp                         | 12 +--
 tests/SmartCharging.cpp                    |  8 +-
 tests/TransactionSafety.cpp                | 16 ++--
 tests/helpers/testHelper.cpp               |  2 +-
 tests/ocppEngineLifecycle.cpp              |  4 +-
 16 files changed, 114 insertions(+), 114 deletions(-)

diff --git a/examples/ESP-TLS/main.cpp b/examples/ESP-TLS/main.cpp
index c91bc498..be9deb19 100644
--- a/examples/ESP-TLS/main.cpp
+++ b/examples/ESP-TLS/main.cpp
@@ -118,7 +118,7 @@ void setup() {
     wsockSecure.enableHeartbeat(15000, 3000, 2);
     wsockSecure.setAuthorization(OCPP_AUTH_ID, OCPP_AUTH_KEY); // => Authorization: Basic QUwxMDAwOgABAgMEBQYH////////////////
     
-    OCPP_initialize(osockSecure, ChargerCredentials("My Charging Station", "My company name"));
+    ocpp_initialize(osockSecure, ChargerCredentials("My Charging Station", "My company name"));
 
     /*
      * ... see ArduinoOcpp.h for how to integrate the EVSE hardware.
@@ -133,7 +133,7 @@ void loop() {
     /*
      * Execute all charge point routines and handle WebSocket
      */
-    OCPP_loop();
+    ocpp_loop();
 
     //... see ArduinoOcpp.h and the other examples for how to integrate the EVSE hardware.
 }
diff --git a/examples/ESP/main.cpp b/examples/ESP/main.cpp
index f01e175e..9aeee3fd 100644
--- a/examples/ESP/main.cpp
+++ b/examples/ESP/main.cpp
@@ -60,7 +60,7 @@ void setup() {
     /*
      * Initialize the OCPP library
      */
-    OCPP_initialize(OCPP_HOST, OCPP_PORT, OCPP_URL, "My Charging Station", "My company name");
+    ocpp_initialize(OCPP_HOST, OCPP_PORT, OCPP_URL, "My Charging Station", "My company name");
 
     /*
      * Integrate OCPP functionality. You can leave out the following part if your EVSE doesn't need it.
@@ -88,7 +88,7 @@ void loop() {
     /*
      * Do all OCPP stuff (process WebSocket input, send recorded meter values to Central System, etc.)
      */
-    OCPP_loop();
+    ocpp_loop();
 
     /*
      * Energize EV plug if OCPP transaction is up and running
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 2cd9bf9a..cb9f17c3 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -55,9 +55,9 @@ using namespace ArduinoOcpp::Facade;
 using namespace ArduinoOcpp::Ocpp16;
 
 #ifndef AO_CUSTOM_WS
-void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt) {
+void ocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt) {
     if (context) {
-        AO_DBG_WARN("Can't be called two times. Either restart ESP, or call OCPP_deinitialize() before");
+        AO_DBG_WARN("Can't be called two times. Either restart ESP, or call ocpp_deinitialize() before");
         return;
     }
 
@@ -79,7 +79,7 @@ void OCPP_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     delete connection;
     connection = new EspWiFi::WSClient(webSocket);
 
-    OCPP_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), fsOpt);
+    ocpp_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), fsOpt);
 }
 #endif
 
@@ -117,9 +117,9 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
     }
 }
 
-void OCPP_initialize(Connection& connection, const char *bootNotificationCredentials, FilesystemOpt fsOpt) {
+void ocpp_initialize(Connection& connection, const char *bootNotificationCredentials, FilesystemOpt fsOpt) {
     if (context) {
-        AO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call OCPP_deinitialize() before");
+        AO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call ocpp_deinitialize() before");
         return;
     }
 
@@ -201,7 +201,7 @@ void OCPP_initialize(Connection& connection, const char *bootNotificationCredent
     credsJson.reset();
 }
 
-void OCPP_deinitialize() {
+void ocpp_deinitialize() {
 
     if (context) {
         //release bootstats recovery mechanism
@@ -229,9 +229,9 @@ void OCPP_deinitialize() {
     configuration_deinit();
 }
 
-void OCPP_loop() {
+void ocpp_loop() {
     if (!context) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
+        AO_DBG_WARN("Please call ocpp_initialize before");
         return;
     }
 
@@ -240,7 +240,7 @@ void OCPP_loop() {
 
 std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
@@ -258,7 +258,7 @@ std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int co
 
 std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX ||
@@ -277,7 +277,7 @@ std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, cons
 
 bool endTransaction(const char *idTag, const char *reason, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -292,7 +292,7 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
 
 bool isTransactionActive(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -306,7 +306,7 @@ bool isTransactionActive(unsigned int connectorId) {
 
 bool isTransactionRunning(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -320,7 +320,7 @@ bool isTransactionRunning(unsigned int connectorId) {
 
 const char *getTransactionIdTag(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -336,7 +336,7 @@ std::shared_ptr<Transaction> ao_undefinedTx;
 
 std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
+        AO_DBG_WARN("Please call ocpp_initialize before");
         return ao_undefinedTx;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -349,7 +349,7 @@ std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
 
 bool ocppPermitsCharge(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
+        AO_DBG_WARN("Please call ocpp_initialize before");
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -362,7 +362,7 @@ bool ocppPermitsCharge(unsigned int connectorId) {
 
 void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -381,7 +381,7 @@ void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int c
 
 void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto& model = context->getModel();
@@ -402,7 +402,7 @@ void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connec
 
 void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
 
@@ -424,7 +424,7 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
 
 void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
@@ -451,7 +451,7 @@ void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput,
 
 void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
@@ -478,7 +478,7 @@ void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutpu
 
 void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
@@ -504,7 +504,7 @@ void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOu
 
 void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -517,7 +517,7 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
 
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -530,7 +530,7 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
 
 void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -543,7 +543,7 @@ void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int
 
 void addErrorDataInput(std::function<ArduinoOcpp::ErrorData()> errorDataInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -556,7 +556,7 @@ void addErrorDataInput(std::function<ArduinoOcpp::ErrorData()> errorDataInput, u
 
 void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
 
@@ -589,7 +589,7 @@ void addMeterValueInput(std::function<int32_t ()> valueInput, const char *measur
 
 void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto& model = context->getModel();
@@ -602,7 +602,7 @@ void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigne
 
 void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -615,7 +615,7 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId)
 
 void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -628,7 +628,7 @@ void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int conne
 
 void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -641,7 +641,7 @@ void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connect
 
 void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -654,7 +654,7 @@ void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,Ardu
 
 void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
@@ -667,7 +667,7 @@ void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnect
 
 bool isOperative(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_WARN("Please call OCPP_initialize before");
+        AO_DBG_WARN("Please call ocpp_initialize before");
         return true; //assume "true" as default state
     }
     auto& model = context->getModel();
@@ -682,7 +682,7 @@ bool isOperative(unsigned int connectorId) {
 
 void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
 
@@ -693,7 +693,7 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
 
 void setOnResetExecute(std::function<void(bool)> onResetExecute) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
 
@@ -718,7 +718,7 @@ DiagnosticsService *getDiagnosticsService() {
 
 Context *getOcppContext() {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return nullptr;
     }
 
@@ -727,7 +727,7 @@ Context *getOcppContext() {
 
 void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onReceiveReq) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     if (!operationType) {
@@ -739,7 +739,7 @@ void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onRecei
 
 void setOnSendConf(const char *operationType, OnSendConfListener onSendConf) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     if (!operationType) {
@@ -749,12 +749,12 @@ void setOnSendConf(const char *operationType, OnSendConfListener onSendConf) {
     context->getOperationRegistry().setOnResponse(operationType, onSendConf);
 }
 
-void sendCustomRequest(const char *operationType,
+void sendRequest(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf) {
 
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     if (!operationType || !fn_createReq || !fn_processConf) {
@@ -766,12 +766,12 @@ void sendCustomRequest(const char *operationType,
     context->initiateRequest(std::move(request));
 }
 
-void setCustomRequestHandler(const char *operationType,
+void setRequestHandler(const char *operationType,
             std::function<void (JsonObject)> fn_processReq,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf) {
 
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     if (!operationType || !fn_processReq || !fn_createConf) {
@@ -788,7 +788,7 @@ void setCustomRequestHandler(const char *operationType,
 
 void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
@@ -814,7 +814,7 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
 
 bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return false;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
@@ -876,7 +876,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
 
 bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call OCPP_initialize before
+        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(OCPP_ID_OF_CONNECTOR);
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 9fedc7f7..bd6291f6 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -38,7 +38,7 @@ using ArduinoOcpp::OnReceiveErrorListener;
  * This is a convenience function only available for Arduino. For a full initialization with TLS,
  * please refer to https://github.com/matth-x/ArduinoOcpp/tree/master/examples/ESP-TLS
  */
-void OCPP_initialize(
+void ocpp_initialize(
             const char *CS_hostname, //e.g. "example.com"
             uint16_t CS_port,        //e.g. 80
             const char *CS_url,      //e.g. "ws://example.com/steve/websocket/CentralSystemService/charger001"
@@ -48,11 +48,11 @@ void OCPP_initialize(
 #endif
 
 /*
- * Convenience initialization: use this for passing the BootNotification payload JSON to the OCPP_initialize(...) below
+ * Convenience initialization: use this for passing the BootNotification payload JSON to the ocpp_initialize(...) below
  *
  * Example usage:
  * 
- *     OCPP_initialize(osock, ChargerCredentials("Demo Charger", "My Company Ltd."));
+ *     ocpp_initialize(osock, ChargerCredentials("Demo Charger", "My Company Ltd."));
  * 
  * For a description of the fields, refer to OCPP 1.6 Specification - Edition 2 p. 60
  */
@@ -86,7 +86,7 @@ struct ChargerCredentials {
  * https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/MongooseConnectionClient.cpp for
  * an example.
  */
-void OCPP_initialize(
+void ocpp_initialize(
             ArduinoOcpp::Connection& connection, //WebSocket adapter for ArduinoOcpp
             const char *bootNotificationCredentials = ChargerCredentials("Demo Charger", "My Company Ltd."), //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
@@ -94,12 +94,12 @@ void OCPP_initialize(
 /*
  * Stop the OCPP library and release allocated resources.
  */
-void OCPP_deinitialize();
+void ocpp_deinitialize();
 
 /*
  * To be called in the main loop (e.g. place it inside loop())
  */
-void OCPP_loop();
+void ocpp_loop();
 
 /*
  * Transaction management.
@@ -355,7 +355,7 @@ void setOnSendConf(const char *operationType, OnSendConfListener onSendConf);
  * 
  * Use case 1, extend the library by sending additional operations. E.g. DataTransfer:
  * 
- * sendCustomRequest("DataTransfer", [] () -> std::unique_ptr<DynamicJsonDocument> {
+ * sendRequest("DataTransfer", [] () -> std::unique_ptr<DynamicJsonDocument> {
  *     //will be called to create the request once this operation is being sent out
  *     size_t capacity = JSON_OBJECT_SIZE(3) +
  *                       JSON_OBJECT_SIZE(2); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
@@ -376,7 +376,7 @@ void setOnSendConf(const char *operationType, OnSendConfListener onSendConf);
  * 
  * Use case 2, bypass the business logic of this library for custom behavior. E.g. StartTransaction:
  * 
- * sendCustomRequest("StartTransaction", [] () -> std::unique_ptr<DynamicJsonDocument> {
+ * sendRequest("StartTransaction", [] () -> std::unique_ptr<DynamicJsonDocument> {
  *     //will be called to create the request once this operation is being sent out
  *     size_t capacity = JSON_OBJECT_SIZE(4); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
  *     auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity)); 
@@ -395,7 +395,7 @@ void setOnSendConf(const char *operationType, OnSendConfListener onSendConf);
  * In Use case 2, the library won't send any further StatusNotification or StopTransaction on
  * its own.
  */
-void sendCustomRequest(const char *operationType,
+void sendRequest(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf);
 
@@ -408,7 +408,7 @@ void sendCustomRequest(const char *operationType,
  * 
  * Example usage:
  * 
- * setCustomRequestHandler("DataTransfer", [] (JsonObject request) -> void {
+ * setRequestHandler("DataTransfer", [] (JsonObject request) -> void {
  *     //will be called with the request message from the server
  *     const char *vendorId = request["vendorId"];
  *     const char *messageId = request["messageId"];
@@ -425,7 +425,7 @@ void sendCustomRequest(const char *operationType,
  *     return res;
  * });
  */
-void setCustomRequestHandler(const char *operationType,
+void setRequestHandler(const char *operationType,
             std::function<void (JsonObject)> fn_processReq,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf);
 
diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 0eef3aa9..334d7653 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -172,7 +172,7 @@ bool configuration_inited = false;
 bool configuration_init(std::shared_ptr<FilesystemAdapter> _filesystem) {
     if (configuration_inited)
         return true; //configuration_init() already called; tolerate multiple calls so user can use this store for
-                     //credentials outside ArduinoOcpp which need to be loaded before OCPP_initialize()
+                     //credentials outside ArduinoOcpp which need to be loaded before ocpp_initialize()
     
     filesystem = _filesystem;
 
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index 08b6e0e2..afad4f15 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -15,7 +15,7 @@
  *     - ESP-IDF SPIFFS
  *     - POSIX-like API (tested on Ubuntu 20.04)
  * 
- * You can add support for other file systems by passing a custom adapter to OCPP_initialize(...)
+ * You can add support for other file systems by passing a custom adapter to ocpp_initialize(...)
  */
 
 
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index b9a0a286..fec2e767 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -75,7 +75,7 @@ class FilesystemAdapter {
  *     - ESP-IDF SPIFFS
  *     - POSIX-like API (tested on Ubuntu 20.04)
  * 
- * You can add support for other file systems by passing a custom adapter to OCPP_initialize(...)
+ * You can add support for other file systems by passing a custom adapter to ocpp_initialize(...)
  */
 
 #if AO_USE_FILEAPI == ARDUINO_LITTLEFS || \
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 9301faf1..b6452a12 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -22,15 +22,15 @@ void ao_initialize_full(AO_Connection *conn, const char *bootNotificationCredent
 
     ArduinoOcpp::FilesystemOpt adaptFsopt = fsopt;
 
-    OCPP_initialize(*ocppSocket, bootNotificationCredentials, adaptFsopt);
+    ocpp_initialize(*ocppSocket, bootNotificationCredentials, adaptFsopt);
 }
 
 void ao_deinitialize() {
-    OCPP_deinitialize();
+    ocpp_deinitialize();
 }
 
 void ao_loop() {
-    OCPP_loop();
+    ocpp_loop();
 }
 
 /*
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 114a74a3..0325be6b 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -14,7 +14,7 @@ TEST_CASE( "C++ API test" ) {
 
     //initialize Context with dummy socket
     ArduinoOcpp::LoopbackConnection loopback;
-    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto context = getOcppContext();
     auto& model = context->getModel();
@@ -67,13 +67,13 @@ TEST_CASE( "C++ API test" ) {
 
         setOnReceiveRequest("StatusNotification", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
         setOnSendConf("StatusNotification", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
-        sendCustomRequest("DataTransfer", [c = &checkpoints[ncheck++]] () {
+        sendRequest("DataTransfer", [c = &checkpoints[ncheck++]] () {
             *c = true;
             auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
             doc->to<JsonObject>();
             return doc;
         }, [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
-        setCustomRequestHandler("DataTransfer", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;}, [c = &checkpoints[ncheck++]] () {
+        setRequestHandler("DataTransfer", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;}, [c = &checkpoints[ncheck++]] () {
             *c = true;
             auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
             doc->to<JsonObject>();
@@ -90,7 +90,7 @@ TEST_CASE( "C++ API test" ) {
 
         //run tx management
 
-        OCPP_loop();
+        ocpp_loop();
 
         loop();
 
@@ -136,13 +136,13 @@ TEST_CASE( "C++ API test" ) {
 
         REQUIRE(isOperative());
 
-        sendCustomRequest("UnlockConnector", [] () {
+        sendRequest("UnlockConnector", [] () {
             auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
             (*doc)["connectorId"] = 1;
             return doc;
         }, [] (JsonObject) {});
 
-        sendCustomRequest("Reset", [] () {
+        sendRequest("Reset", [] () {
             auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
             (*doc)["type"] = "Hard";
             return doc;
@@ -167,7 +167,7 @@ TEST_CASE( "C++ API test" ) {
         REQUIRE(checkpointsPassed);
     }
 
-    OCPP_deinitialize();
+    ocpp_deinitialize();
 
     REQUIRE(!getOcppContext());
 }
@@ -319,18 +319,18 @@ TEST_CASE( "C API test" ) {
         REQUIRE(ao_isOperative());
         REQUIRE(ao_isOperative_m(2));
 
-        sendCustomRequest("UnlockConnector", [] () {
+        sendRequest("UnlockConnector", [] () {
             auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
             (*doc)["connectorId"] = 1;
             return doc;
         }, [] (JsonObject) {});
-        sendCustomRequest("UnlockConnector", [] () {
+        sendRequest("UnlockConnector", [] () {
             auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
             (*doc)["connectorId"] = 2;
             return doc;
         }, [] (JsonObject) {});
 
-        sendCustomRequest("Reset", [] () {
+        sendRequest("Reset", [] () {
             auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
             (*doc)["type"] = "Hard";
             return doc;
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 28b395dd..1b93add1 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -19,7 +19,7 @@ TEST_CASE( "Charging sessions" ) {
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto engine = getOcppContext();
     auto& checkMsg = engine->getOperationRegistry();
@@ -177,10 +177,10 @@ TEST_CASE( "Charging sessions" ) {
     }
 
     SECTION("Preboot transactions - tx before BootNotification") {
-        OCPP_deinitialize();
+        ocpp_deinitialize();
 
         loopback.setConnected(false);
-        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
@@ -238,10 +238,10 @@ TEST_CASE( "Charging sessions" ) {
 
     SECTION("Preboot transactions - lose StartTx timestamp") {
 
-        OCPP_deinitialize();
+        ocpp_deinitialize();
 
         loopback.setConnected(false);
-        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
@@ -253,9 +253,9 @@ TEST_CASE( "Charging sessions" ) {
 
         REQUIRE(isTransactionRunning());
 
-        OCPP_deinitialize();
+        ocpp_deinitialize();
 
-        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
@@ -289,10 +289,10 @@ TEST_CASE( "Charging sessions" ) {
 
         REQUIRE(isTransactionRunning());
 
-        OCPP_deinitialize();
+        ocpp_deinitialize();
 
         loopback.setConnected(false);
-        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
@@ -307,9 +307,9 @@ TEST_CASE( "Charging sessions" ) {
 
         REQUIRE(!isTransactionRunning());
 
-        OCPP_deinitialize();
+        ocpp_deinitialize();
 
-        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
@@ -371,9 +371,9 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
         REQUIRE(isOperative());
 
-        OCPP_deinitialize();
+        ocpp_deinitialize();
 
-        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
         connector = getOcppContext()->getModel().getConnector(1);
 
         loop();
@@ -394,6 +394,6 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE(isOperative());
     }
 
-    OCPP_deinitialize();
+    ocpp_deinitialize();
 
 }
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index ad4eed95..6a403fc5 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -54,7 +54,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto engine = getOcppContext();
     auto& checkMsg = engine->getOperationRegistry();
@@ -217,5 +217,5 @@ TEST_CASE( "Configuration Behavior" ) {
         loopback.setConnected(true);
     }
 
-    OCPP_deinitialize();
+    ocpp_deinitialize();
 }
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 0bbbfad9..a222c70c 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -15,7 +15,7 @@ TEST_CASE("Metering") {
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto context = getOcppContext();
     auto& model = context->getModel();
@@ -42,7 +42,7 @@ TEST_CASE("Metering") {
         bool checkProcessed = false;
 
         //set up measurands and check validation
-        sendCustomRequest("ChangeConfiguration",
+        sendRequest("ChangeConfiguration",
             [] () {
                 //create req
                 auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
@@ -62,7 +62,7 @@ TEST_CASE("Metering") {
 
         checkProcessed = false;
 
-        sendCustomRequest("ChangeConfiguration",
+        sendRequest("ChangeConfiguration",
             [] () {
                 //create req
                 auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
@@ -226,9 +226,9 @@ TEST_CASE("Metering") {
 
         loop();
 
-        OCPP_deinitialize(); //check if StopData is stored over reboots
+        ocpp_deinitialize(); //check if StopData is stored over reboots
 
-        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         addMeterValueInput([base] () {
             //simulate 3600W consumption
@@ -326,5 +326,5 @@ TEST_CASE("Metering") {
         REQUIRE(checkProcessed);
     }
 
-    OCPP_deinitialize();
+    ocpp_deinitialize();
 }
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index f0f89489..4eb48cd5 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -41,7 +41,7 @@ TEST_CASE( "SmartCharging" ) {
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto context = getOcppContext();
     auto& model = context->getModel();
@@ -112,9 +112,9 @@ TEST_CASE( "SmartCharging" ) {
         std::string out = SCPROFILE_0;
         loopback.sendTXT(out);
 
-        OCPP_deinitialize();
+        ocpp_deinitialize();
 
-        OCPP_initialize(loopback, ChargerCredentials("test-runner1234"));
+        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         setSmartChargingOutput([] (float, float, int) {});
         scService = model.getSmartChargingService();
@@ -567,6 +567,6 @@ TEST_CASE( "SmartCharging" ) {
         return true;
     });
 
-    OCPP_deinitialize();
+    ocpp_deinitialize();
 
 }
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 17fe0eed..c338db98 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -17,7 +17,7 @@ TEST_CASE( "Transaction safety" ) {
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    OCPP_initialize(loopback);
+    ocpp_initialize(loopback);
 
     ao_set_timer(custom_timer_cb);
 
@@ -34,7 +34,7 @@ TEST_CASE( "Transaction safety" ) {
         loop();
         REQUIRE(!ocppPermitsCharge());
 
-        OCPP_deinitialize();
+        ocpp_deinitialize();
     }
 
     SECTION("Managed transaction") {
@@ -48,7 +48,7 @@ TEST_CASE( "Transaction safety" ) {
         loop();
         REQUIRE(!ocppPermitsCharge());
         
-        OCPP_deinitialize();
+        ocpp_deinitialize();
     }
 
     SECTION("Reset during transaction 01 - interrupt initiation") {
@@ -57,7 +57,7 @@ TEST_CASE( "Transaction safety" ) {
         loop();
         beginTransaction("mIdTag");
         loop();
-        OCPP_deinitialize(); //reset and jump to next section
+        ocpp_deinitialize(); //reset and jump to next section
     }
 
     SECTION("Reset during transaction 02 - interrupt initiation second time") {
@@ -65,7 +65,7 @@ TEST_CASE( "Transaction safety" ) {
         setConnectorPluggedInput([] () {return false;});
         loop();
         REQUIRE(!ocppPermitsCharge());
-        OCPP_deinitialize();
+        ocpp_deinitialize();
     }
 
     SECTION("Reset during transaction 03 - interrupt running tx") {
@@ -73,7 +73,7 @@ TEST_CASE( "Transaction safety" ) {
         setConnectorPluggedInput([] () {return true;});
         loop();
         REQUIRE(ocppPermitsCharge());
-        OCPP_deinitialize();
+        ocpp_deinitialize();
     }
 
     SECTION("Reset during transaction 04 - interrupt stopping tx") {
@@ -82,7 +82,7 @@ TEST_CASE( "Transaction safety" ) {
         loop();
         REQUIRE(ocppPermitsCharge());
         endTransaction();
-        OCPP_deinitialize();
+        ocpp_deinitialize();
     }
 
     SECTION("Reset during transaction 06 - check tx finished") {
@@ -90,7 +90,7 @@ TEST_CASE( "Transaction safety" ) {
         setConnectorPluggedInput([] () {return true;});
         loop();
         REQUIRE(!ocppPermitsCharge());
-        OCPP_deinitialize();
+        ocpp_deinitialize();
     }
 
 }
diff --git a/tests/helpers/testHelper.cpp b/tests/helpers/testHelper.cpp
index 171fb793..fd8af688 100644
--- a/tests/helpers/testHelper.cpp
+++ b/tests/helpers/testHelper.cpp
@@ -15,6 +15,6 @@ unsigned long custom_timer_cb() {
 void loop() {
     for (int i = 0; i < 30; i++) {
         mtime += 100;
-        OCPP_loop();
+        ocpp_loop();
     }
 }
diff --git a/tests/ocppEngineLifecycle.cpp b/tests/ocppEngineLifecycle.cpp
index 050c8593..68ee669e 100644
--- a/tests/ocppEngineLifecycle.cpp
+++ b/tests/ocppEngineLifecycle.cpp
@@ -10,13 +10,13 @@ TEST_CASE( "Context lifecycle" ) {
 
     //initialize Context with dummy socket
     ArduinoOcpp::LoopbackConnection loopback;
-    OCPP_initialize(loopback);
+    ocpp_initialize(loopback);
 
     SECTION("OCPP is initialized"){
         REQUIRE( getOcppContext() );
     }
 
-    OCPP_deinitialize();
+    ocpp_deinitialize();
 
     SECTION("OCPP is deinitialized"){
         REQUIRE( !( getOcppContext() ) );

From 2b5e8f5fff27a933226f9932b2cb013b4a491708 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 2 Jul 2023 18:43:57 +0200
Subject: [PATCH 317/549] move Context module into Core subfolder

---
 CMakeLists.txt                                               | 2 +-
 src/ArduinoOcpp.cpp                                          | 2 +-
 src/ArduinoOcpp/{ => Core}/Context.cpp                       | 2 +-
 src/ArduinoOcpp/{ => Core}/Context.h                         | 0
 src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp | 2 +-
 src/ArduinoOcpp/Model/Boot/BootService.cpp                   | 2 +-
 src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp  | 2 +-
 src/ArduinoOcpp/Model/ChargeControl/Connector.cpp            | 2 +-
 src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp     | 2 +-
 src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp | 2 +-
 src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp         | 2 +-
 src/ArduinoOcpp/Model/Metering/MeteringService.cpp           | 2 +-
 src/ArduinoOcpp/Model/Reservation/ReservationService.cpp     | 2 +-
 src/ArduinoOcpp/Model/Reset/ResetService.cpp                 | 2 +-
 src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp | 2 +-
 src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp | 2 +-
 src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp    | 2 +-
 src/ArduinoOcpp/Operations/TriggerMessage.cpp                | 2 +-
 tests/Api.cpp                                                | 2 +-
 tests/ChargingSessions.cpp                                   | 2 +-
 tests/ConfigurationBehavior.cpp                              | 2 +-
 tests/Metering.cpp                                           | 2 +-
 tests/SmartCharging.cpp                                      | 2 +-
 tests/TransactionSafety.cpp                                  | 2 +-
 24 files changed, 23 insertions(+), 23 deletions(-)
 rename src/ArduinoOcpp/{ => Core}/Context.cpp (97%)
 rename src/ArduinoOcpp/{ => Core}/Context.h (100%)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 8d30db9c..c6883544 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -15,7 +15,7 @@ set(AO_SRC
     src/ArduinoOcpp/Core/FilesystemAdapter.cpp
     src/ArduinoOcpp/Core/FilesystemUtils.cpp
     src/ArduinoOcpp/Core/RequestQueue.cpp
-    src/ArduinoOcpp/Context.cpp
+    src/ArduinoOcpp/Core/Context.cpp
     src/ArduinoOcpp/Core/Operation.cpp
     src/ArduinoOcpp/Model/Model.cpp
     src/ArduinoOcpp/Core/Request.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index cb9f17c3..64670180 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -4,7 +4,7 @@
 
 #include "ArduinoOcpp.h"
 
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/Metering/MeteringService.h>
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
diff --git a/src/ArduinoOcpp/Context.cpp b/src/ArduinoOcpp/Core/Context.cpp
similarity index 97%
rename from src/ArduinoOcpp/Context.cpp
rename to src/ArduinoOcpp/Core/Context.cpp
index 2e437518..ee316797 100644
--- a/src/ArduinoOcpp/Context.cpp
+++ b/src/ArduinoOcpp/Core/Context.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Core/Request.h>
 #include <ArduinoOcpp/Core/Connection.h>
 #include <ArduinoOcpp/Model/Model.h>
diff --git a/src/ArduinoOcpp/Context.h b/src/ArduinoOcpp/Core/Context.h
similarity index 100%
rename from src/ArduinoOcpp/Context.h
rename to src/ArduinoOcpp/Core/Context.h
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
index 8333b49b..e37cc1ab 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
 #include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/OperationRegistry.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
diff --git a/src/ArduinoOcpp/Model/Boot/BootService.cpp b/src/ArduinoOcpp/Model/Boot/BootService.cpp
index 12b1cf81..5c717b74 100644
--- a/src/ArduinoOcpp/Model/Boot/BootService.cpp
+++ b/src/ArduinoOcpp/Model/Boot/BootService.cpp
@@ -5,7 +5,7 @@
 #include <limits>
 
 #include <ArduinoOcpp/Model/Boot/BootService.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
index 6c591108..7429b0a3 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
@@ -5,7 +5,7 @@
 #include <string>
 
 #include <ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Operations/ChangeAvailability.h>
 #include <ArduinoOcpp/Operations/ChangeConfiguration.h>
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index 771e8225..7a178398 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Request.h>
 #include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
diff --git a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 45e9109f..7f8ce5cf 100644
--- a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 17688459..d6f3a96c 100644
--- a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
diff --git a/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
index 5ab458da..8d558fe4 100644
--- a/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
+++ b/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Model/Heartbeat/HeartbeatService.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Operations/Heartbeat.h>
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
index 3b3d4b52..e0b770b8 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringService.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/Model/Metering/MeteringService.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
diff --git a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
index 18eb5052..01d58433 100644
--- a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Model/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/ChargeControl/Connector.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
diff --git a/src/ArduinoOcpp/Model/Reset/ResetService.cpp b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
index 2066108b..fb576eb8 100644
--- a/src/ArduinoOcpp/Model/Reset/ResetService.cpp
+++ b/src/ArduinoOcpp/Model/Reset/ResetService.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Model/Reset/ResetService.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Core/Configuration.h>
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
index b424bc76..3567088b 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/Configuration.h>
diff --git a/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp b/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
index a6fc7169..51855d2f 100644
--- a/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
+++ b/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Operations/DiagnosticsStatusNotification.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
 
diff --git a/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp b/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
index b25c49dc..2ee252a7 100644
--- a/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
+++ b/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Operations/FirmwareStatusNotification.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
 
diff --git a/src/ArduinoOcpp/Operations/TriggerMessage.cpp b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
index 2a6512e3..849a9e4e 100644
--- a/src/ArduinoOcpp/Operations/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
@@ -7,7 +7,7 @@
 #include <ArduinoOcpp/Model/Metering/MeteringService.h>
 #include <ArduinoOcpp/Operations/StatusNotification.h>
 #include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
 #include <ArduinoOcpp/Debug.h>
 
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 0325be6b..866999b2 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -1,6 +1,6 @@
 #include <ArduinoOcpp.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 1b93add1..25a6637b 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -1,6 +1,6 @@
 #include <ArduinoOcpp.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 6a403fc5..9ac05e11 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -1,6 +1,6 @@
 #include <ArduinoOcpp.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Configuration.h>
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index a222c70c..c795841a 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -1,6 +1,6 @@
 #include <ArduinoOcpp.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index 4eb48cd5..0c26c37e 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -1,6 +1,6 @@
 #include <ArduinoOcpp.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index c338db98..7b37c74f 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -1,6 +1,6 @@
 #include <ArduinoOcpp.h>
 #include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Context.h>
+#include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/SimpleRequestFactory.h>

From 41d533033ddb1c548bd5f5728376091e655ce98b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 2 Jul 2023 18:55:57 +0200
Subject: [PATCH 318/549] remove superfluous declarations

---
 src/ArduinoOcpp/Model/ChargeControl/Connector.h | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index 209dabee..01226313 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -16,10 +16,6 @@
 #include <functional>
 #include <memory>
 
-#define AVAILABILITY_OPERATIVE 2
-#define AVAILABILITY_INOPERATIVE_SCHEDULED 1
-#define AVAILABILITY_INOPERATIVE 0
-
 namespace ArduinoOcpp {
 
 class Context;
@@ -103,7 +99,6 @@ class Connector {
     bool isOperative();
     void setAvailability(bool available);
     void setAvailabilityVolatile(bool available); //set inoperative state but keep only until reboot at most
-    void setAuthorizationProvider(std::function<const char *()> authorization);
     void setConnectorPluggedInput(std::function<bool()> connectorPlugged);
     void setEvReadyInput(std::function<bool()> evRequestsEnergy);
     void setEvseReadyInput(std::function<bool()> connectorEnergized);

From 1a1696f8e27e9baac9215d6c824746fbc71f76e5 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 2 Jul 2023 20:03:01 +0200
Subject: [PATCH 319/549] esp-idf fixes

---
 CMakeLists.txt        | 5 +++--
 src/ArduinoOcpp_c.cpp | 4 ++--
 src/ArduinoOcpp_c.h   | 4 ++--
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index c6883544..a268d05b 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -4,8 +4,6 @@
 
 cmake_minimum_required(VERSION 3.15)
 
-project(ArduinoOcpp
-        VERSION 0.2.0)
 
 set(AO_SRC
     src/ArduinoOcpp/Core/Configuration.cpp
@@ -98,6 +96,9 @@ if(ESP_PLATFORM)
     return()
 endif()
 
+project(ArduinoOcpp
+        VERSION 0.2.0)
+
 add_library(ArduinoOcpp ${AO_SRC})
 
 target_include_directories(ArduinoOcpp PUBLIC
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index b6452a12..7fd4051c 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -297,12 +297,12 @@ void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady)
     setStopTxReadyInput(adaptFn(connectorId, stopTxReady), connectorId);
 }
 
-void ao_setTxNotificationOutput(void (*notificationOutput)(AO_TxNotification, AO_Transaction*)) {
+void ao_setTxNotificationOutput(void (*notificationOutput)(enum AO_TxNotification, AO_Transaction*)) {
     setTxNotificationOutput([notificationOutput] (ArduinoOcpp::TxNotification notification, ArduinoOcpp::Transaction *tx) {
         notificationOutput(convertTxNotification(notification), reinterpret_cast<AO_Transaction*>(tx));
     });
 }
-void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AO_TxNotification, AO_Transaction*)) {
+void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, enum AO_TxNotification, AO_Transaction*)) {
     setTxNotificationOutput([notificationOutput, connectorId] (ArduinoOcpp::TxNotification notification, ArduinoOcpp::Transaction *tx) {
         notificationOutput(connectorId, convertTxNotification(notification), reinterpret_cast<AO_Transaction*>(tx));
     }, connectorId);
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 03df6611..7105ad9f 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -144,8 +144,8 @@ void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxRead
 void ao_setStopTxReadyInput(InputBool stopTxReady);
 void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady);
 
-void ao_setTxNotificationOutput(void (*notificationOutput)(AO_TxNotification, AO_Transaction*));
-void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AO_TxNotification, AO_Transaction*));
+void ao_setTxNotificationOutput(void (*notificationOutput)(enum AO_TxNotification, AO_Transaction*));
+void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, enum AO_TxNotification, AO_Transaction*));
 
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
 void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);

From 000d78285e21e512051377542e4281929ad765bc Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 2 Jul 2023 20:18:58 +0200
Subject: [PATCH 320/549] fix Unix build

---
 src/ArduinoOcpp/Platform.cpp | 4 ++--
 src/ArduinoOcpp/Platform.h   | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/ArduinoOcpp/Platform.cpp b/src/ArduinoOcpp/Platform.cpp
index 9e12b004..45767710 100644
--- a/src/ArduinoOcpp/Platform.cpp
+++ b/src/ArduinoOcpp/Platform.cpp
@@ -60,10 +60,10 @@ unsigned long ao_tick_ms_unix() {
 }
 #endif
 
-#if AO_PLATFORM == AO_PLATFORM_ESPIDF
+#if AO_PLATFORM != AO_PLATFORM_ARDUINO
 void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target){
     char fmt[20];
     sprintf(fmt, "%%%d.%df", min_width, num_digits_after_decimal);
     sprintf(target, fmt, value);
 }
-#endif
\ No newline at end of file
+#endif
diff --git a/src/ArduinoOcpp/Platform.h b/src/ArduinoOcpp/Platform.h
index c6a3b19a..1842383e 100644
--- a/src/ArduinoOcpp/Platform.h
+++ b/src/ArduinoOcpp/Platform.h
@@ -92,8 +92,8 @@ unsigned long ao_tick_ms_unix();
 #endif
 #endif
 
-#if AO_PLATFORM == AO_PLATFORM_ESPIDF
+#if AO_PLATFORM != AO_PLATFORM_ARDUINO
 void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target);
 #endif
 
-#endif
\ No newline at end of file
+#endif

From 08961d3136042badeb569e3d287374ecec585765 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 2 Jul 2023 20:30:36 +0200
Subject: [PATCH 321/549] update CI

---
 .github/workflows/documentation.yml | 2 +-
 .github/workflows/pio.yml           | 1 +
 .github/workflows/platformless.yml  | 1 +
 .github/workflows/tests.yml         | 3 ++-
 README.md                           | 2 ++
 5 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 0c13347e..bd1cd75b 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -2,7 +2,7 @@ name: documentation
 on:
   push:
     branches:
-      - develop
+      - master
 permissions:
   contents: write
 jobs:
diff --git a/.github/workflows/pio.yml b/.github/workflows/pio.yml
index 819bc365..7167d595 100644
--- a/.github/workflows/pio.yml
+++ b/.github/workflows/pio.yml
@@ -3,6 +3,7 @@ name: PlatformIO CI
 on:
   push:
     branches:
+      - master
       - develop
 
 jobs:
diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 06873bcb..e2765113 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -3,6 +3,7 @@ name: Default Compilation
 on:
   push:
     branches:
+      - master
       - develop
 
 jobs:
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index f69e8b32..bdcf279c 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -1,8 +1,9 @@
-name: Test Runner
+name: Unit tests
 
 on:
   push:
     branches:
+      - master
       - develop
 
 jobs:
diff --git a/README.md b/README.md
index 9acb685c..87b113b7 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,8 @@
 # <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; ArduinoOcpp
 
 [![Build Status]( https://github.com/matth-x/ArduinoOcpp/workflows/PlatformIO%20CI/badge.svg)](https://github.com/matth-x/ArduinoOcpp/actions)
+[![Unit tests]( https://github.com/matth-x/ArduinoOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/ArduinoOcpp/actions)
+[![codecov](https://codecov.io/github/matth-x/ArduinoOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/ArduinoOcpp)
 
 OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with Espressif, NXP, Texas Instruments and STM.
 

From 931ecae73a2016db3bb6641f10fe8216e7bda73b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 2 Jul 2023 21:20:23 +0200
Subject: [PATCH 322/549] update readme

---
 README.md | 36 ++++++++++++++++++++----------------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index 87b113b7..37595cdd 100644
--- a/README.md
+++ b/README.md
@@ -8,15 +8,15 @@ OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
 
-PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
+Try it (no hardware required): [ArduinoOcppSimulator](https://github.com/matth-x/ArduinoOcppSimulator)
 
-Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
+Technical introduction: [ArduinoOcpp Docs](https://matth-x.github.io/ArduinoOcpp/intro-tech)
 
 Fully integrated into the Arduino platform and the ESP32 / ESP8266. Runs on ESP-IDF, FreeRTOS and generic embedded C/C++ platforms.
 
 ## Make your EVSE ready for OCPP :car::electric_plug::battery:
 
-This library allows your EVSE to communicate with an OCPP Backend and to participate in commercial charging networks. You can integrate it into an existing firmware development, or start a new EVSE project from scratch with it.
+This library allows EVSEs to communicate with an OCPP Backend and to participate in commercial charging networks. You can integrate it into an existing firmware development, or start a new EVSE project from scratch with it.
 
 :heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve) and [15+ commercial Central Systems](https://www.arduino-ocpp.com/#h.314525e8447cc93c_81)
 
@@ -24,42 +24,42 @@ This library allows your EVSE to communicate with an OCPP Backend and to partici
 
 :heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
-Try it (no hardware required): [ArduinoOcppSimulator](https://github.com/matth-x/ArduinoOcppSimulator)
-
 ### Features
 
 - handles the OCPP communication with the charging network
 - implements the standard OCPP charging process
-- provides an API for the integration of the hardware modules of your EVSE
+- provides an API for the integration of the hardware modules of the EVSE
 - works with any TLS implementation and WebSocket library. E.g.
    - Arduino networking stack: [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets), or
    - generic embedded systems: [Mongoose Networking Library](https://github.com/cesanta/mongoose)
 
-For simple chargers, the necessary hardware and internet integration is usually far below 1000 LOCs.
-
-Technical introduction: [ArduinoOcpp Docs](https://matth-x.github.io/ArduinoOcpp/intro-tech)
+The necessary hardware and internet integration is usually far below 1000 LOCs.
 
 ## Developers guide
 
-Please take `examples/ESP/main.cpp` as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`ArduinoOcpp.h`](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h).
+Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`ArduinoOcpp.h`](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h).
+
+PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
 
 ### Dependencies
 
 Mandatory:
 
-- [bblanchon/ArduinoJSON](https://github.com/bblanchon/ArduinoJson) (please upgrade to version `6.19.1`)
+- [bblanchon/ArduinoJSON](https://github.com/bblanchon/ArduinoJson)
 
 If compiled with the Arduino integration:
 
-- [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (please upgrade to version `2.3.6`)
+- [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (version `2.3.6`)
 
 In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
 
-### Next development steps
+### OCPP 2.0.1 and ISO 15118
+
+The OCPP 2.0.1 upgrade is being worked on. Further details will be announced soon.
+
+ISO 15118 is a must-have for future chargers. It will hugely improve the security and user-friendliness of EV charging. ArduinoOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is being verified now in a proprietary firmware development.
 
-- [x] reach full compliance to OCPP 1.6 Smart Charging Profile
-- [ ] integrate Authorization Cache
-- [ ] **get ready for OCPP 2.0.1 and ISO 15118**
+However, no public reference for an ISO 15118 integration exists at the moment. If your company can imagine to work on an open source ISO 15118 client, I would be happy to get in touch for a collaboration on an open source OCPP 2.0.1 + ISO 15118 solution.
 
 ## Supported Feature Profiles
 
@@ -72,8 +72,12 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 | **Local auth list management** | :heavy_check_mark: |
 | **Reservation** | :heavy_check_mark: |
 
+Fully OCPP 1.6 compliant :heavy_check_mark:
+
 ## Further help
 
+Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
+
 I hope this guide can help you to successfully integrate an OCPP controller into your EVSE. If something needs clarification or if you have a question, please send me a message.
 
 :envelope: : matthias A⊤ arduino-ocpp DО⊤ com

From e2dcaf450d334dc8d1f78eae090efaa36810e03f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 2 Jul 2023 21:24:08 +0200
Subject: [PATCH 323/549] change links order

---
 README.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 37595cdd..b3b850c8 100644
--- a/README.md
+++ b/README.md
@@ -8,9 +8,9 @@ OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
 
-Try it (no hardware required): [ArduinoOcppSimulator](https://github.com/matth-x/ArduinoOcppSimulator)
+PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
 
-Technical introduction: [ArduinoOcpp Docs](https://matth-x.github.io/ArduinoOcpp/intro-tech)
+Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
 Fully integrated into the Arduino platform and the ESP32 / ESP8266. Runs on ESP-IDF, FreeRTOS and generic embedded C/C++ platforms.
 
@@ -24,6 +24,10 @@ This library allows EVSEs to communicate with an OCPP Backend and to participate
 
 :heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
+Technical introduction: [ArduinoOcpp Docs](https://matth-x.github.io/ArduinoOcpp/intro-tech)
+
+Try it (no hardware required): [ArduinoOcppSimulator](https://github.com/matth-x/ArduinoOcppSimulator)
+
 ### Features
 
 - handles the OCPP communication with the charging network
@@ -39,8 +43,6 @@ The necessary hardware and internet integration is usually far below 1000 LOCs.
 
 Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`ArduinoOcpp.h`](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h).
 
-PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
-
 ### Dependencies
 
 Mandatory:
@@ -76,8 +78,6 @@ Fully OCPP 1.6 compliant :heavy_check_mark:
 
 ## Further help
 
-Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
-
 I hope this guide can help you to successfully integrate an OCPP controller into your EVSE. If something needs clarification or if you have a question, please send me a message.
 
 :envelope: : matthias A⊤ arduino-ocpp DО⊤ com

From 26373684b2fdc4237e90db71b0dd7e1201871789 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 3 Jul 2023 19:04:59 +0200
Subject: [PATCH 324/549] update docs

---
 README.md                  |  6 +++---
 docs/intro-tech.md         |  2 +-
 docs/modules.md            |  6 ++++--
 docs/stylesheets/extra.css |  3 +++
 mkdocs.yml                 | 13 ++++++++-----
 5 files changed, 19 insertions(+), 11 deletions(-)
 create mode 100644 docs/stylesheets/extra.css

diff --git a/README.md b/README.md
index b3b850c8..90050034 100644
--- a/README.md
+++ b/README.md
@@ -55,13 +55,13 @@ If compiled with the Arduino integration:
 
 In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
 
-### OCPP 2.0.1 and ISO 15118
+## OCPP 2.0.1 and ISO 15118
 
 The OCPP 2.0.1 upgrade is being worked on. Further details will be announced soon.
 
-ISO 15118 is a must-have for future chargers. It will hugely improve the security and user-friendliness of EV charging. ArduinoOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is being verified now in a proprietary firmware development.
+ISO 15118 is a must-have for future chargers. It will hugely improve the security and user-friendliness of EV charging. ArduinoOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is being validated now in a proprietary firmware development.
 
-However, no public reference for an ISO 15118 integration exists at the moment. If your company can imagine to work on an open source ISO 15118 client, I would be happy to get in touch for a collaboration on an open source OCPP 2.0.1 + ISO 15118 solution.
+However, no public ISO 15118 integration exists at the moment. If your company considers working on an open source ISO 15118 stack, it would be great to discuss a potential collaboration on an open source OCPP 2.0.1 + ISO 15118 solution.
 
 ## Supported Feature Profiles
 
diff --git a/docs/intro-tech.md b/docs/intro-tech.md
index 8729cf80..f223d984 100644
--- a/docs/intro-tech.md
+++ b/docs/intro-tech.md
@@ -1,6 +1,6 @@
 # Technical introduction
 
-This chapter covers everything you need to know to understand ArduinoOcpp.
+This chapter covers the technical concepts of ArduinoOcpp.
 
 ## Scope of ArduinoOcpp
 
diff --git a/docs/modules.md b/docs/modules.md
index 2f578138..10c8449c 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -4,7 +4,7 @@ The API exposes some of the internal datastructures to the main firmware. This c
 
 ## Context object
 
-The *Context* wraps all runtime data of ArduinoOcpp. Every data object this library creates (except only the Configuration) can be rechaed through the Context instance. So it is the basic entry point to the internals of the library. The structure of the context follows the main architecture as described in [this introduction](intro-tech) and consists of the Request queue and message deserializer for the RPC framework and the Model object for the OCPP model and behavior (see below).
+The *Context* contains all runtime data of ArduinoOcpp. Every data object which this library creates is stored in the Context instance, except only the Configuration. So it is the basic entry point to the internals of the library. The structure of the context follows the main architecture as described in [this introduction](intro-tech) and consists of the Request queue and message deserializer for the RPC framework and the Model object for the OCPP model and behavior (see below).
 
 When the library is initialized, `getOcppContext()` returns the current Context object.
 
@@ -12,7 +12,9 @@ When the library is initialized, `getOcppContext()` returns the current Context
 
 The *Model* represents the OCPP device model and behavior. OCPP defines a rough charger model, i.e. the hardware parts of the charger and their basic functionality in relation to the OCPP operations. Furthermore, OCPP specifies a few only software related features like the reservation of the charger. This charger model is implemented as straightforward C++ data structures and corresponding algorithms.
 
-Following the structure of the feature profiles in OCPP, the model implementation is split into functional blocks in ArduinoOcpp as well. Each functional block has a top-level *Service* class, executing the behavior in their scope. Consequently, the *Model* object is composed of *Service* objects, it owns them and provides access to them. The following subsections contain a description of each function block.
+The implementation of the Model is structured into a top-level Model class and the subordinate Service classes. Each Service class represents a functional block of the OCPP specification and implements the corresponding data structures and functionality. The definition of the functional blocks in ArduinoOcpp is very similar to the feature profiles in OCPP. Only the Core profile is split into multiple functional blocks to keep a smaller module scope.
+
+The following subsections contain a description of each functional block.
 
 ### Authorization
 
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
new file mode 100644
index 00000000..fc5e6a38
--- /dev/null
+++ b/docs/stylesheets/extra.css
@@ -0,0 +1,3 @@
+:root {
+    --md-primary-fg-color:        #2984C7;
+  }
diff --git a/mkdocs.yml b/mkdocs.yml
index 1eba2507..0ff96606 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,4 +1,4 @@
-site_name: ArduinoOcpp Docs
+site_name: ArduinoOcpp docs
 
 theme:
   name: material
@@ -28,14 +28,14 @@ theme:
     # - toc.integrate
   palette:
     - scheme: default
-      primary: indigo
-      accent: indigo
+      primary: custom
+      accent: custom
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
     - scheme: slate
-      primary: indigo
-      accent: indigo
+      primary: custom
+      accent: custom
       toggle:
         icon: material/brightness-4
         name: Switch to light mode
@@ -45,3 +45,6 @@ theme:
   favicon: assets/favicon.png
   icon:
     logo: logo
+
+extra_css:
+  - stylesheets/extra.css

From 0c7fdb05c041f22c943eeec68b2af770b9426d36 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 4 Jul 2023 18:50:50 +0200
Subject: [PATCH 325/549] fix Metering at connectorId 0, fractional digits

---
 .../Model/Metering/MeteringConnector.cpp      |  4 +-
 src/ArduinoOcpp/Model/Metering/SampledValue.h |  2 +-
 src/ArduinoOcpp_c.cpp                         |  4 +-
 src/ArduinoOcpp_c.h                           |  4 +-
 tests/Api.cpp                                 |  7 ++--
 tests/Metering.cpp                            | 40 +++++++++++++++++++
 6 files changed, 50 insertions(+), 11 deletions(-)

diff --git a/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
index 5c1c5153..f2e0c0ed 100644
--- a/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
@@ -78,8 +78,8 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         } else {
             //check outside of transaction
 
-            if (!MeterValuesInTxOnly || *MeterValuesInTxOnly) {
-                //don't take any MeterValues outside of transactions
+            if (connectorId != 0 && (!MeterValuesInTxOnly || *MeterValuesInTxOnly)) {
+                //don't take any MeterValues outside of transactions on connectorIds other than 0
                 meterData.clear();
                 return nullptr;
             }
diff --git a/src/ArduinoOcpp/Model/Metering/SampledValue.h b/src/ArduinoOcpp/Model/Metering/SampledValue.h
index 43602237..939423ff 100644
--- a/src/ArduinoOcpp/Model/Metering/SampledValue.h
+++ b/src/ArduinoOcpp/Model/Metering/SampledValue.h
@@ -38,7 +38,7 @@ class SampledValueDeSerializer<float> { // Used in meterValues
     static bool ready(float& val) {return true;} //float is always valid
     static std::string serialize(float& val) {
         char str[20];
-        dtostrf(val,4,9,str);
+        dtostrf(val,4,1,str);
         return std::string(str);
     }
     static int32_t toInteger(float& val) {return (int32_t) val;}
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 7fd4051c..fe629b85 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -259,10 +259,10 @@ void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInp
     addErrorCodeInput(adaptFn(connectorId, errorCodeInput), connectorId);
 }
 
-void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
+void ao_addMeterValueInputFloat(InputFloat valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
     addMeterValueInput(adaptFn(valueInput), measurand, unit, location, phase, 1);
 }
-void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
+void ao_addMeterValueInputFloat_m(unsigned int connectorId, InputFloat_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
     addMeterValueInput(adaptFn(connectorId, valueInput), measurand, unit, location, phase, connectorId);
 }
 
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 7105ad9f..19b44fb5 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -129,8 +129,8 @@ void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput
 void ao_addErrorCodeInput(InputString errorCodeInput);
 void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput);
 
-void ao_addMeterValueInputInt(InputInt valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
-void ao_addMeterValueInputInt_m(unsigned int connectorId, InputInt_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
+void ao_addMeterValueInputFloat(InputFloat valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
+void ao_addMeterValueInputFloat_m(unsigned int connectorId, InputFloat_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
 
 void ao_addMeterValueInput(MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput); //takes ownership of meterValueInput
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 866999b2..3a112c8f 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -41,8 +41,7 @@ TEST_CASE( "C++ API test" ) {
         setEvseReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         addErrorCodeInput([c = &checkpoints[ncheck++]] () -> const char* {*c = true; return nullptr;});
         addErrorDataInput([c = &checkpoints[ncheck++]] () -> ArduinoOcpp::ErrorData {*c = true; return nullptr;});
-        addMeterValueInput([c = &checkpoints[ncheck++]] () -> int32_t {*c = true; return 0.f;},
-                "Current.Import");
+        addMeterValueInput([c = &checkpoints[ncheck++]] () -> float {*c = true; return 0.f;}, "Current.Import");
 
         ArduinoOcpp::SampledValueProperties svprops;
         svprops.setMeasurand("Current.Offered");
@@ -218,8 +217,8 @@ TEST_CASE( "C API test" ) {
         ao_setEvseReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[11] = true; return true;}); ncheckc++;
         ao_addErrorCodeInput([] () -> const char* {checkpointsc[12] = true; return nullptr;}); ncheckc++;
         ao_addErrorCodeInput_m(2, [] (unsigned int) -> const char* {checkpointsc[13] = true; return nullptr;}); ncheckc++;
-        ao_addMeterValueInputInt([] () -> int {checkpointsc[14] = true; return 0;}, "Current.Import", "A", NULL, NULL); ncheckc++;
-        ao_addMeterValueInputInt_m(2, [] (unsigned int) -> int {checkpointsc[15] = true; return 0;}, "Current.Import", "A", NULL, NULL); ncheckc++;
+        ao_addMeterValueInputFloat([] () -> float {checkpointsc[14] = true; return 0.f;}, "Current.Import", "A", NULL, NULL); ncheckc++;
+        ao_addMeterValueInputFloat_m(2, [] (unsigned int) -> float {checkpointsc[15] = true; return 0.f;}, "Current.Import", "A", NULL, NULL); ncheckc++;
         
         ArduinoOcpp::SampledValueProperties svprops;
         svprops.setMeasurand("Current.Offered");
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index c795841a..bad0aa4d 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -261,6 +261,46 @@ TEST_CASE("Metering") {
         REQUIRE(checkProcessed);
     }
 
+    SECTION("Capture measurements at connectorId 0") {
+
+        Timestamp base;
+        base.setTime(BASE_TIME);
+
+        const unsigned int connectorId = 0;
+
+        addMeterValueInput([base] () {
+                //simulate 3600W consumption
+                return 3600;
+            }, 
+            "Power.Active.Import",
+            nullptr,
+            nullptr,
+            nullptr,
+            connectorId);
+
+        auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        *MeterValuesSampledData = "Power.Active.Import";
+
+        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        *MeterValueSampleInterval = 10;
+
+        bool checkProcessed = false;
+
+        setOnReceiveRequest("MeterValues", [base, &checkProcessed] (JsonObject payload) {
+            checkProcessed = true;
+            REQUIRE((!strcmp(payload["meterValue"][0]["sampledValue"][0]["value"] | "", "3600") ||
+                     !strcmp(payload["meterValue"][0]["sampledValue"][0]["value"] | "", "3600.0")));
+        });
+
+        loop();
+
+        mtime += 10 * 1000;
+
+        loop();
+
+        REQUIRE(checkProcessed);
+    }
+
     SECTION("Change measurands live") {
 
         Timestamp base;

From b8ccc8da4a6324c816c2949dfa1a887aec31bd74 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 4 Jul 2023 19:48:25 +0200
Subject: [PATCH 326/549] allow getOcppContext to check if inited

---
 src/ArduinoOcpp.cpp | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 516cb2b2..3ad30fa0 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -717,11 +717,6 @@ DiagnosticsService *getDiagnosticsService() {
 #endif
 
 Context *getOcppContext() {
-    if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
-        return nullptr;
-    }
-
     return context;
 }
 

From 00e42d78cc7dd6bfa739081fbb38d925e8e1adf5 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 5 Jul 2023 13:31:25 +0200
Subject: [PATCH 327/549] allow setting custom FS via API

---
 src/ArduinoOcpp.cpp                        | 10 ++-
 src/ArduinoOcpp.h                          |  4 +-
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp | 10 +--
 src/ArduinoOcpp/Core/FilesystemAdapter.h   | 75 +++++++++-------------
 src/ArduinoOcpp_c.cpp                      |  2 +-
 5 files changed, 46 insertions(+), 55 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 3ad30fa0..3e28670c 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -79,7 +79,7 @@ void ocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     delete connection;
     connection = new EspWiFi::WSClient(webSocket);
 
-    ocpp_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), fsOpt);
+    ocpp_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), makeDefaultFilesystemAdapter(fsOpt));
 }
 #endif
 
@@ -117,16 +117,14 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
     }
 }
 
-void ocpp_initialize(Connection& connection, const char *bootNotificationCredentials, FilesystemOpt fsOpt) {
+void ocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs) {
     if (context) {
         AO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call ocpp_deinitialize() before");
         return;
     }
 
-#ifndef AO_DEACTIVATE_FLASH
-    filesystem = makeDefaultFilesystemAdapter(fsOpt);
-#endif
-    AO_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "error");
+    filesystem = fs;
+    AO_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "deactivated");
 
     BootStats bootstats;
     BootService::loadBootStats(filesystem, bootstats);
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 7a2b99f4..5830c70a 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -10,6 +10,7 @@
 #include <functional>
 
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
+#include <ArduinoOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoOcpp/Core/RequestCallbacks.h>
 #include <ArduinoOcpp/Core/Connection.h>
 #include <ArduinoOcpp/Core/PollResult.h>
@@ -89,7 +90,8 @@ struct ChargerCredentials {
 void ocpp_initialize(
             ArduinoOcpp::Connection& connection, //WebSocket adapter for ArduinoOcpp
             const char *bootNotificationCredentials = ChargerCredentials("Demo Charger", "My Company Ltd."), //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
-            ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            std::shared_ptr<ArduinoOcpp::FilesystemAdapter> filesystem =
+                ArduinoOcpp::makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail)); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 /*
  * Stop the OCPP library and release allocated resources.
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index afad4f15..0165e9f3 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -6,8 +6,6 @@
 #include <ArduinoOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
 #include <ArduinoOcpp/Debug.h>
 
-#ifndef AO_DEACTIVATE_FLASH
-
 /*
  * Platform specific implementations. Currently supported:
  *     - Arduino LittleFs
@@ -469,6 +467,10 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 } //end namespace ArduinoOcpp
 
-#endif //switch-case AO_USE_FILEAPI
+#else //filesystem disabled
+
+std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
+    return nullptr;
+}
 
-#endif //!AO_DEACTIVATE_FLASH
+#endif //switch-case AO_USE_FILEAPI
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/ArduinoOcpp/Core/FilesystemAdapter.h
index fec2e767..bc7eb435 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.h
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.h
@@ -5,43 +5,22 @@
 #ifndef AO_FILESYSTEMADAPTER_H
 #define AO_FILESYSTEMADAPTER_H
 
+#include <memory>
+#include <functional>
+
+#include <ArduinoOcpp/Platform.h>
+#include <ArduinoOcpp/Core/ConfigurationOptions.h>
+
 #ifndef AO_FILENAME_PREFIX
 #define AO_FILENAME_PREFIX "/"
 #endif
 
+#define DISABLE_FS       0
 #define ARDUINO_LITTLEFS 1
 #define ARDUINO_SPIFFS   2
 #define ESPIDF_SPIFFS    3
 #define POSIX_FILEAPI    4
 
-#include <memory>
-#include <functional>
-#include <ArduinoOcpp/Platform.h>
-
-namespace ArduinoOcpp {
-
-class FileAdapter {
-public:
-    virtual ~FileAdapter() = default;
-    virtual size_t read(char *buf, size_t len) = 0;
-    virtual size_t write(const char *buf, size_t len) = 0;
-    virtual size_t seek(size_t offset) = 0;
-    // virtual void close() = 0; implemented in deconstructor
-
-    virtual int read() = 0;
-};
-
-class FilesystemAdapter {
-public:
-    virtual ~FilesystemAdapter() = default;
-    virtual int stat(const char *path, size_t *size) = 0;
-    virtual std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) = 0;
-    virtual bool remove(const char *fn) = 0;
-    virtual int ftw_root(std::function<int(const char *fpath)> fn) = 0; //enumerate the files in the ao_store root folder
-};
-
-} //end namespace ArduinoOcpp
-
 // choose FileAPI if not given by build flag; assume usage with Arduino if no build flags are present
 #ifndef AO_USE_FILEAPI
 #if AO_PLATFORM == AO_PLATFORM_ARDUINO
@@ -54,6 +33,8 @@ class FilesystemAdapter {
 #define AO_USE_FILEAPI ESPIDF_SPIFFS
 #elif AO_PLATFORM == AO_PLATFORM_UNIX
 #define AO_USE_FILEAPI POSIX_FILEAPI
+#else
+#define AO_USE_FILEAPI DISABLE_FS
 #endif //switch-case AO_PLATFORM
 #endif //ndef AO_USE_FILEAPI
 
@@ -66,32 +47,40 @@ class FilesystemAdapter {
 #endif
 #endif
 
-#ifndef AO_DEACTIVATE_FLASH
+namespace ArduinoOcpp {
+
+class FileAdapter {
+public:
+    virtual ~FileAdapter() = default;
+    virtual size_t read(char *buf, size_t len) = 0;
+    virtual size_t write(const char *buf, size_t len) = 0;
+    virtual size_t seek(size_t offset) = 0;
+
+    virtual int read() = 0;
+};
+
+class FilesystemAdapter {
+public:
+    virtual ~FilesystemAdapter() = default;
+    virtual int stat(const char *path, size_t *size) = 0;
+    virtual std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) = 0;
+    virtual bool remove(const char *fn) = 0;
+    virtual int ftw_root(std::function<int(const char *fpath)> fn) = 0; //enumerate the files in the ao_store root folder
+};
 
 /*
- * Platform specific implementations. Currently supported:
+ * Platform specific implementation. Currently supported:
  *     - Arduino LittleFs
  *     - Arduino SPIFFS
  *     - ESP-IDF SPIFFS
  *     - POSIX-like API (tested on Ubuntu 20.04)
  * 
  * You can add support for other file systems by passing a custom adapter to ocpp_initialize(...)
+ * 
+ * Returns null if platform is not supported or Filesystem is disabled
  */
-
-#if AO_USE_FILEAPI == ARDUINO_LITTLEFS || \
-    AO_USE_FILEAPI == ARDUINO_SPIFFS || \
-    AO_USE_FILEAPI == ESPIDF_SPIFFS || \
-    AO_USE_FILEAPI == POSIX_FILEAPI
-
-#include <ArduinoOcpp/Core/ConfigurationOptions.h>
-
-namespace ArduinoOcpp {
-
 std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config);
 
 } //end namespace ArduinoOcpp
-#endif
-
-#endif //ndef AO_DEACTIVATE_FLASH
 
 #endif
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index fe629b85..4415b717 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -22,7 +22,7 @@ void ao_initialize_full(AO_Connection *conn, const char *bootNotificationCredent
 
     ArduinoOcpp::FilesystemOpt adaptFsopt = fsopt;
 
-    ocpp_initialize(*ocppSocket, bootNotificationCredentials, adaptFsopt);
+    ocpp_initialize(*ocppSocket, bootNotificationCredentials, ArduinoOcpp::makeDefaultFilesystemAdapter(adaptFsopt));
 }
 
 void ao_deinitialize() {

From 20ff3cd222aa788d8f5a59ab2d1d2f25d340b52f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 21 Jul 2023 17:11:04 +0200
Subject: [PATCH 328/549] update docs

---
 docs/modules.md | 29 ++++++++++++++++++-----------
 1 file changed, 18 insertions(+), 11 deletions(-)

diff --git a/docs/modules.md b/docs/modules.md
index 10c8449c..e0e598ec 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -1,29 +1,36 @@
-# Internal datastructures
+# Modules
 
-The API exposes some of the internal datastructures to the main firmware. This chapter gives an overview of their fields and shows how to use them to achieve the desired behavior.
+This chapter gives an overview of the class structure of ArduinoOcpp.
 
-## Context object
+## Context
 
 The *Context* contains all runtime data of ArduinoOcpp. Every data object which this library creates is stored in the Context instance, except only the Configuration. So it is the basic entry point to the internals of the library. The structure of the context follows the main architecture as described in [this introduction](intro-tech) and consists of the Request queue and message deserializer for the RPC framework and the Model object for the OCPP model and behavior (see below).
 
 When the library is initialized, `getOcppContext()` returns the current Context object.
 
-## Model object
+## Model
 
 The *Model* represents the OCPP device model and behavior. OCPP defines a rough charger model, i.e. the hardware parts of the charger and their basic functionality in relation to the OCPP operations. Furthermore, OCPP specifies a few only software related features like the reservation of the charger. This charger model is implemented as straightforward C++ data structures and corresponding algorithms.
 
 The implementation of the Model is structured into a top-level Model class and the subordinate Service classes. Each Service class represents a functional block of the OCPP specification and implements the corresponding data structures and functionality. The definition of the functional blocks in ArduinoOcpp is very similar to the feature profiles in OCPP. Only the Core profile is split into multiple functional blocks to keep a smaller module scope.
 
-The following subsections contain a description of each functional block.
+The following list contains the resulting functional blocks:
 
-### Authorization
+- **Authorization**: local information of user identifiers and their authorization status
+- **Boot**: implementation of the *preboot* behavior, i.e. sending and processing the BootNotification message
+- **ChargingSession**: management of charging sessions and control of the high power charging hardware
+- **Diagnostics**: GetDiagnostics upload routine
+- **FirmwareManagement**: UpdateFirmware download routine
+- **Heartbeat**: periodic OCPP Heartbeats (not including WebSocket ping-pongs)
+- **Metering**: periodic MeterValue messages and local caching
+- **Reservation**: management of Reservation lists and their effect on the authorization routine
+- **Reset**: execution of OCPP Reset message
+- **Transactions**: transaction journal behind StartTransaction and StopTransaction messages and *Transaction* class for extensions of the transaction mechanism
 
-The *AuthorizationService* manages the authorization information of user identifiers or *idTags*. If the local authorization features of OCPP are enabled, then this Service stores a whitelist and blacklist of *idTags* or maintains a cache of recently authorized identifiers. A further responsibility is to determine if the given authorization data is still valid according to the rules in the OCPP specification.
+## Requests
 
-A single *idTag* and its authorization information is represented by the *AuthorizationData* class. It has public getter functions to retreive the authorization information. The list containing those entries is implemented in the *AuthorizationList* class. It has a search function for the *AuthorizationData* by *idTag*.
+The *Request* class and all similarly named classes implement the Remote Procdure Call (RPC) framework of OCPP. A request executes an operation on the remote end of an OCPP connection. If a charger sends a request to a server, then the server will update its data base with the payload and vice versa. After receiving a request, each node replies with a confirmation, acknowledging the successful execution of the operation or notifying about an error.
 
-### Boot
-
-The **BootService** implements the behavior around the *BootNotification* message.
+When being offline, outgoing requests must be queued before sending which is implemented in *RequestQueue*. Queueing is especially challenging for longer offline periods when the number of cached messages exceeds memory limits. To address this, messages are swapped to the flash memory when the queue limit is reached as implemented in the *RequestStore* and *RequestQueueStorageStrategy* class. Incoming messages can be processed directly and don't have an extensive queueing mechanism.
 
 *Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*

From d92a0ae8a1c026d13cbc7ec0e733346a10546e8c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 23 Jul 2023 20:40:31 +0200
Subject: [PATCH 329/549] update docs

---
 docs/img/favicon.png | Bin 0 -> 9687 bytes
 docs/index.md        |   2 ++
 docs/modules.md      |  24 ++++++++++++++++++++++--
 mkdocs.yml           |   2 +-
 4 files changed, 25 insertions(+), 3 deletions(-)
 create mode 100644 docs/img/favicon.png

diff --git a/docs/img/favicon.png b/docs/img/favicon.png
new file mode 100644
index 0000000000000000000000000000000000000000..87b3df3c42ed752833850693a273e069e1987ba3
GIT binary patch
literal 9687
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
Z|35Z%iW2p-)ieMA002ovPDHLkV1o0>c(MQh

literal 0
HcmV?d00001

diff --git a/docs/index.md b/docs/index.md
index 108d37af..08667de5 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -2,6 +2,8 @@ ArduinoOcpp is an OCPP client which runs on microcontrollers and enables EVSEs t
 
 [Technical introduction](intro-tech)
 
+[Modules](modules)
+
 [Development tools and basic prerequisites](prerequisites)
 
 <!-- This chapter shows how to kick-start your OCPP project. -->
diff --git a/docs/modules.md b/docs/modules.md
index e0e598ec..12f017ae 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -31,6 +31,26 @@ The following list contains the resulting functional blocks:
 
 The *Request* class and all similarly named classes implement the Remote Procdure Call (RPC) framework of OCPP. A request executes an operation on the remote end of an OCPP connection. If a charger sends a request to a server, then the server will update its data base with the payload and vice versa. After receiving a request, each node replies with a confirmation, acknowledging the successful execution of the operation or notifying about an error.
 
-When being offline, outgoing requests must be queued before sending which is implemented in *RequestQueue*. Queueing is especially challenging for longer offline periods when the number of cached messages exceeds memory limits. To address this, messages are swapped to the flash memory when the queue limit is reached as implemented in the *RequestStore* and *RequestQueueStorageStrategy* class. Incoming messages can be processed directly and don't have an extensive queueing mechanism.
+When being offline, outgoing requests must be queued before sending which is implemented in *RequestQueue*. Queueing is especially challenging for longer offline periods when the number of cached messages exceeds the memory limit. To address this, messages are swapped to the flash memory when the queue limit is reached as implemented in the *RequestStore* and *RequestQueueStorageStrategy* class. Incoming messages can be processed directly and don't have an extensive queueing mechanism.
 
-*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*
+## Operations
+
+Every OCPP operation (e.g. Heartbeat, BootNotification) has a dedicated class for creating outgoing messages, interpreting incoming messages, executing the specified OCPP action and handling responses. Operations work on the data structures of the Model layer.
+
+To send operations to the OCPP server, they must be wrapped into a Request object. The RPC framework and operations are separated modules. While the RPC framework (including the Request class) deals with the messaging mechanism and transfering data to the other OCPP device, operations define the effect on the OCPP model and data structure and execute the desired action. The operation classes inherit from *Operation* which is the interface visible to the Request class.
+
+Incoming messages are unmarshalled using the *OperationRegistry*. During the initialization phase of the library, the Model classes register all supported operations with their name and an instantiator. The instantiator, when executed, provides the Request interpreter with an instance of the corresponding Operation subclasses. It is possible to extend ArduinoOcpp by adding new Operation instantiators to the registry, or to modify the behavior by overriding the default Operation implementations. In addition to that, event handlers can be set which the RPC queue will notify with the payload once operations are sent or received.
+
+## Configuration
+
+Configurations like the HeartbeatInterval are managed by the *Configuration* module which consists of
+
+- *AbstractConfiguration*: a single configuration as a key-value pair without value type
+- *Configuration*: a concrete configuration with value like `bool` or `const char*`. Inherits from AbstractConfiguration
+- *ConfigurationContainer*: a collection of AbstractConfigurations and an optional storage implementation. Multiple containers can be set for a separation of the configurations and different storage strategies. Each container has a unique file name
+- *ConfigurationContainerVolatile*: no persistency and access to the file system
+- *ConfigurationContainerFlash*: persistency by storing JSON files on the flash
+
+If another storage implementation is required (e.g. for syncing with an external configuration manager), then it's possible to add a custom ConfigurationContainer.
+
+In the initialization phase, ArduinoOcpp loads the built-in Configurations with hard-coded factory defaults and a default storage structure. To customize the factory defaults or which ConfigurationContainers will be used, the Configuration module must be initialized before loading the library. To do so, call `configuration_init(...)`. Then the factory defaults can be applied by calling `declareConfiguration<T>(...)` with the desired default value. To use a custom ConfigurationContainer, call `addConfigurationContainer(...)` with the custom implementation. When the library is loaded afterwards, it will use the previously provided Configurations / Containers and create only the data structure which hasn't been set already.
diff --git a/mkdocs.yml b/mkdocs.yml
index 0ff96606..50025440 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -42,7 +42,7 @@ theme:
   font:
     text: Roboto
     code: Roboto Mono
-  favicon: assets/favicon.png
+  favicon: img/favicon.png
   icon:
     logo: logo
 

From bdfe9bef51c5d5eb1fc2554afa4f76c4f547f942 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 24 Jul 2023 21:20:43 +0200
Subject: [PATCH 330/549] update docs

---
 docs/modules.md  |  6 +++---
 docs/security.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+), 3 deletions(-)
 create mode 100644 docs/security.md

diff --git a/docs/modules.md b/docs/modules.md
index 12f017ae..ed30afd8 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -46,10 +46,10 @@ Incoming messages are unmarshalled using the *OperationRegistry*. During the ini
 Configurations like the HeartbeatInterval are managed by the *Configuration* module which consists of
 
 - *AbstractConfiguration*: a single configuration as a key-value pair without value type
-- *Configuration*: a concrete configuration with value like `bool` or `const char*`. Inherits from AbstractConfiguration
+    - *Configuration*: a concrete configuration with a value type like `bool` or `const char*`. Inherits from AbstractConfiguration
 - *ConfigurationContainer*: a collection of AbstractConfigurations and an optional storage implementation. Multiple containers can be set for a separation of the configurations and different storage strategies. Each container has a unique file name
-- *ConfigurationContainerVolatile*: no persistency and access to the file system
-- *ConfigurationContainerFlash*: persistency by storing JSON files on the flash
+    - *ConfigurationContainerVolatile*: no persistency and access to the file system
+    - *ConfigurationContainerFlash*: persistency by storing JSON files on the flash
 
 If another storage implementation is required (e.g. for syncing with an external configuration manager), then it's possible to add a custom ConfigurationContainer.
 
diff --git a/docs/security.md b/docs/security.md
new file mode 100644
index 00000000..dcbf97ea
--- /dev/null
+++ b/docs/security.md
@@ -0,0 +1,47 @@
+# Security
+
+ArduinoOcpp is designed to be compatible with IoT devices which leads to special considerations regarding cyber security. This section describes the challenges and security concepts of ArduinoOcpp.
+
+## Challenges of using microcontrollers in safety-critical environments
+
+The two challenges are as follows:
+
+1. Lack of process virtualization in RTOS operating systems
+2. Less attention for potential vulnerabilities in the used libraries
+
+In a general purpose OS like Linux, the internet communication modules of an application typically run in a different process than the data base or the hardware supervision / control function. In contrast, on a typical RTOS, all modules are compiled into the same binary, sharing the same address space and lifecycle when being executed. This means that once the network stack crashes, all software on the chip is reset and a vulnerability on the network stack could be exploited to read or manipulate the data of the full runtime environment.
+
+Challenge 2) is due to the fact that OCPP uses standard web technology (WebSocket over TLS), but microcontrollers are missing out the most widespread networking software like OpenSSL or the networking libraries of Linux. The available networking libraries for microcontrollers are also audited well (e.g. lwIP, mbedTLS), but in general there is more attention on potential vulnerabilites in the Linux world, because a huge share of commercial IT systems is based on Linux.
+
+On the upside, an advantage of microcontrollers is their single purpose usage and thus, reduced complexity. Many security breaches are caused by misconfigured and often even superflous software components (e.g. due to overlooked open ports) which are not a regular part of a microcontroller firmware.
+
+## Security measures of ArduinoOcpp
+
+To address the challenges, the following measures were taken:
+
+- Input sanitazion: ArduinoOcpp only accepts the JSON format for all input. It is validated by ArduinoJson. Every JSON value is checked against the expected format and for conformity with the OCPP specification before using it. The JSON object is discarded immediately after interpretation
+- Transaction safety: to address crashes and random reboots of the microcontroller during operation, all activities of the OCPP library are programmed so that they will either be resumed or fully reverted after reboots, preventing inconsistent states. See also [Transaction safety](../intro-tech/#transaction-safety)
+- Careful choice of the dependencies: the mandatory dependency, [ArduinoJson](https://github.com/bblanchon/ArduinoJson), has a test coverage of nearly 100% and is fuzzed. The same goes for the recommended WebSocket library, [Mongoose](https://github.com/cesanta/mongoose). Both projects are very relevant in their field with over 6k and 9k stars on GitHub
+
+Two further measures would be beneficial and could be requested via support request:
+
+- OCPP fuzzer: as a stateful application protocol, there are specific challenges of developing a fuzzer. An open source fuzzing framework for OCPP could reveal vulnerabilities and be of use for other OCPP projects as well
+- Precautious memory allocation: migrating memory management to the stack where possible and thorough heap allocation failure tests would reduce the potential of vulnerabilities
+
+## Measures to be taken by the EVSE vendor
+
+As a general rule, the communication controller which is exposed to the internet shouldn't be used for safety-critical tasks on the charging hardware. That's because the networking stack is a very complex piece of software which very likely still has open bugs which can crash the controller despite all the effort to improve it. Safety-critical tasks on the charging hardware shouldn't rely on a controller which could crash at any time because of incoming network traffic. To mitigate this, either the OCPP library and internet functionality should be placed onto a separate chip, or the most vital safety functionality should get its own controller.
+
+The recommended [Mongoose WebSocket adapter for ArduinoOcpp](https://github.com/matth-x/ArduinoOcppMongoose) supports the OCPP Security Profile 2 (TLS with Basic Authentication) and needs to be provided with the necessary TLS certificate.
+
+Most IoT-controllers have built-in mechanisms to ensure the authenticity of their firmware. For example, the Espressif32 supports [Secure Boot](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/secure-boot-v2.html) which is a signature verification of the installed firmware before that firmware is executed. Many platforms also have a built-in signature verification for incoming OTA firmware updates. To prove the authenticity of the charger to the OCPP server, it is also important to keep the WebSocket key secret by [encrypting the flash memory](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/flash-encryption.html). These security mechanisms heavily depend on the host controller which runs ArduinoOcpp. It is the responsibility of the main firmware to make proper use of them.
+
+## OCPP Security Whitepaper and ISO 15118
+
+With ArduinoOcpp, the recommended way of handling certificates on microcontrollers is to compile them into the firmware binary and to rely on the built-in firmware signature checks of the host microcontroller platform. This lean approach results in a smaller attack vector compared to establishing a separate infrastructure for the server- and firmware certificate. It can be assumed that the OTA functionality of the microcontrollers is thoroughly tested and consequently, reaching a comparable level of robustness requires much effort.
+
+In case the certificate handling mechanism of the Security Whitepaper is preferred, then the EVSE vendor needs to implement it via a custom extension. Unfortunately, this mechanism hasn't been requested yet and is not natively supported by ArduinoOcpp yet (but could be requested over a support contract). The new custom operations can be implemented by extending the class `Operation`. A handler for incoming messages can be registered via `OperationRegistry::registerOperation(...)`. To send custom operations to the server, use `Context::initiateRequest(...)`.
+
+A further challenge for microcontrollers is the relatively low processor speed which becomes relevant for a potential ISO 15118 integration. Some incoming message types (`AuthorizationReq` and `MeteringReceiptReq`) include a signature which needs to be verified on the communications controller of the EVSE. Moreover, messages in the of the ISO 15118 V2G protocol have a maximum round trip time (which is 2 seconds for the message types in question) and so the signature verification is time-contrained. [These benchmarks](https://web.archive.org/web/20230724184529/https://www.oryx-embedded.com/benchmark/espressif/crypto-esp32.html) for the Espressif32 show that for some signature algorithms, the verification time can get close or exceed the timing requirements of ISO 15118 if done on the processor only. As a consequence, hardware acceleration by the crypto-core is mandatory to ensure a robust communication between the EVSE and EV. Before making a communications controller with ISO 15118 support, the performance of the host controller should be benchmarked and checked against the requirements.
+
+*Disclaimer: the outlined risks in this section are not a complete list. Also, every system has unique security challenges which require individual attention. In doubt, please consult an IT-security specialist.*

From 6932804dc5d308d477053d29b81a6b0bbcd5a56f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 26 Jul 2023 16:34:48 +0200
Subject: [PATCH 331/549] update docs

---
 docs/security.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/security.md b/docs/security.md
index dcbf97ea..2a1864b0 100644
--- a/docs/security.md
+++ b/docs/security.md
@@ -26,11 +26,11 @@ To address the challenges, the following measures were taken:
 Two further measures would be beneficial and could be requested via support request:
 
 - OCPP fuzzer: as a stateful application protocol, there are specific challenges of developing a fuzzer. An open source fuzzing framework for OCPP could reveal vulnerabilities and be of use for other OCPP projects as well
-- Precautious memory allocation: migrating memory management to the stack where possible and thorough heap allocation failure tests would reduce the potential of vulnerabilities
+- Precautious memory allocation: migrating memory management to the stack and where possible would simplify code analysis and reduce the potential of vulnerabilities
 
 ## Measures to be taken by the EVSE vendor
 
-As a general rule, the communication controller which is exposed to the internet shouldn't be used for safety-critical tasks on the charging hardware. That's because the networking stack is a very complex piece of software which very likely still has open bugs which can crash the controller despite all the effort to improve it. Safety-critical tasks on the charging hardware shouldn't rely on a controller which could crash at any time because of incoming network traffic. To mitigate this, either the OCPP library and internet functionality should be placed onto a separate chip, or the most vital safety functionality should get its own controller.
+As a general rule, the communication controller which is exposed to the internet shouldn't be used for safety-critical tasks on the charging hardware. That's because the networking stack is a very complex piece of software which very likely still has open bugs which can crash the controller despite all the effort to improve it. Safety-critical tasks on the charging hardware shouldn't rely on a controller which could crash at any time because of incoming network traffic. To mitigate this, either the OCPP library and internet functionality should be placed onto a separate chip, or the most vital safety functionality should get a dedicated controller.
 
 The recommended [Mongoose WebSocket adapter for ArduinoOcpp](https://github.com/matth-x/ArduinoOcppMongoose) supports the OCPP Security Profile 2 (TLS with Basic Authentication) and needs to be provided with the necessary TLS certificate.
 
@@ -38,10 +38,10 @@ Most IoT-controllers have built-in mechanisms to ensure the authenticity of thei
 
 ## OCPP Security Whitepaper and ISO 15118
 
-With ArduinoOcpp, the recommended way of handling certificates on microcontrollers is to compile them into the firmware binary and to rely on the built-in firmware signature checks of the host microcontroller platform. This lean approach results in a smaller attack vector compared to establishing a separate infrastructure for the server- and firmware certificate. It can be assumed that the OTA functionality of the microcontrollers is thoroughly tested and consequently, reaching a comparable level of robustness requires much effort.
+With ArduinoOcpp, the recommended way of handling certificates on microcontrollers is to compile them into the firmware binary and to rely on the built-in firmware signature checks of the host microcontroller platform. This lean approach results in a smaller attack vector compared to establishing a separate infrastructure for the server- and firmware certificate. It can be assumed that the OTA functionality of the microcontrollers is thoroughly tested and consequently, reaching a comparable level of robustness would require much effort.
 
-In case the certificate handling mechanism of the Security Whitepaper is preferred, then the EVSE vendor needs to implement it via a custom extension. Unfortunately, this mechanism hasn't been requested yet and is not natively supported by ArduinoOcpp yet (but could be requested over a support contract). The new custom operations can be implemented by extending the class `Operation`. A handler for incoming messages can be registered via `OperationRegistry::registerOperation(...)`. To send custom operations to the server, use `Context::initiateRequest(...)`.
+In case the certificate handling mechanism of the Security Whitepaper is preferred, then the EVSE vendor needs to implement it via a custom extension. Unfortunately, this mechanism hasn't been requested yet and is not natively supported by ArduinoOcpp yet. The new custom operations can be implemented by extending the class `Operation`. A handler for incoming messages can be registered via `OperationRegistry::registerOperation(...)`. To send custom messages to the server, use `Context::initiateRequest(...)`.
 
-A further challenge for microcontrollers is the relatively low processor speed which becomes relevant for a potential ISO 15118 integration. Some incoming message types (`AuthorizationReq` and `MeteringReceiptReq`) include a signature which needs to be verified on the communications controller of the EVSE. Moreover, messages in the of the ISO 15118 V2G protocol have a maximum round trip time (which is 2 seconds for the message types in question) and so the signature verification is time-contrained. [These benchmarks](https://web.archive.org/web/20230724184529/https://www.oryx-embedded.com/benchmark/espressif/crypto-esp32.html) for the Espressif32 show that for some signature algorithms, the verification time can get close or exceed the timing requirements of ISO 15118 if done on the processor only. As a consequence, hardware acceleration by the crypto-core is mandatory to ensure a robust communication between the EVSE and EV. Before making a communications controller with ISO 15118 support, the performance of the host controller should be benchmarked and checked against the requirements.
+A further challenge for microcontrollers is the relatively low processor speed which becomes relevant for a potential ISO 15118 integration. Some incoming message types (`AuthorizationReq` and `MeteringReceiptReq`) include a signature which needs to be verified on the communications controller of the EVSE. Moreover, messages in the ISO 15118 V2G protocol have a maximum round trip time (which is 2 seconds for the message types in question) and so the signature verification is time-contrained. [These benchmarks](https://web.archive.org/web/20230724184529/https://www.oryx-embedded.com/benchmark/espressif/crypto-esp32.html) for the Espressif32 show that for some signature algorithms, the verification time can get close or exceed the timing requirements of ISO 15118 if done on the processor only. As a consequence, hardware acceleration by the crypto-core is mandatory to ensure a robust communication between the EVSE and EV. Before making a communications controller with ISO 15118 support, the performance of the host controller should be benchmarked and checked against the requirements.
 
 *Disclaimer: the outlined risks in this section are not a complete list. Also, every system has unique security challenges which require individual attention. In doubt, please consult an IT-security specialist.*

From 5f6b45ebf7b62d77d175cd5c49c82fa0eec5ee0e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 27 Jul 2023 15:02:09 +0200
Subject: [PATCH 332/549] add esp-idf CI

---
 .github/workflows/esp-idf.yml | 46 +++++++++++++++++++++++++++++++++++
 examples/ESP-IDF/main/main.c  | 10 +++-----
 2 files changed, 50 insertions(+), 6 deletions(-)
 create mode 100644 .github/workflows/esp-idf.yml

diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
new file mode 100644
index 00000000..0ed1a8aa
--- /dev/null
+++ b/.github/workflows/esp-idf.yml
@@ -0,0 +1,46 @@
+name: ESP-IDF CI
+
+on:
+  push:
+    branches:
+      - master
+      - develop
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout ESP-IDF example folder structure
+      uses: actions/checkout@v3
+      with:
+        sparse-checkout: examples/ESP-IDF
+    - name: Clean sumodules folders template
+      run: rm -r ./examples/ESP-IDF/components/*
+    - name: Checkout main repo
+      uses: actions/checkout@v3
+      with:
+        path: examples/ESP-IDF/components/ArduinoOcpp
+    - name: Checkout Mongoose
+      uses: actions/checkout@v3
+      with:
+        repository: cesanta/mongoose-esp-idf
+        path: examples/ESP-IDF/components/mongoose
+        submodules: 'recursive'
+    - name: Checkout Mongoose WS adapter
+      uses: actions/checkout@v3
+      with:
+        repository: matth-x/ArduinoOcppMongoose
+        path: examples/ESP-IDF/components/ArduinoOcppMongoose
+    - name: Checkout ArduinoJson
+      uses: actions/checkout@v3
+      with:
+        repository: bblanchon/ArduinoJson
+        path: examples/ESP-IDF/components/ArduinoJson
+    - name: esp-idf build
+      uses: espressif/esp-idf-ci-action@v1
+      with:
+        esp_idf_version: v4.4
+        target: esp32
+        path: './examples/ESP-IDF'
diff --git a/examples/ESP-IDF/main/main.c b/examples/ESP-IDF/main/main.c
index 8da7040a..4d39eca3 100644
--- a/examples/ESP-IDF/main/main.c
+++ b/examples/ESP-IDF/main/main.c
@@ -19,7 +19,7 @@
 /* ArduinoOcpp includes */
 #include <mongoose.h>
 #include <ArduinoOcpp_c.h> //C-facade of ArduinoOcpp
-#include <AOcppMongooseClient_c.h> //WebSocket integration for ESP-IDF
+#include <ArduinoOcppMongooseClient_c.h> //WebSocket integration for ESP-IDF
 
 /* The examples use WiFi configuration that you can set via project configuration menu
 
@@ -156,13 +156,11 @@ void app_main(void)
     /* Initialize ArduinoOcpp */
     struct AO_FilesystemOpt fsopt = { .use = true, .mount = true, .formatFsOnFail = true};
 
-    AConnection *osock = ao_makeConnection(&mgr,
+    AO_Connection *osock = ao_makeConnection(&mgr,
             EXAMPLE_AO_OCPP_BACKEND, 
             EXAMPLE_AO_CHARGEBOXID, 
             EXAMPLE_AO_AUTHORIZATIONKEY, "", fsopt);
-    ao_initialize(osock, fsopt);
-
-    ao_bootNotification("ESP-IDF charger", "Your brand name here", NULL, NULL, NULL, NULL); //send first OCPP message
+    ao_initialize(osock, "ESP-IDF charger", "Your brand name here", fsopt);
 
     /* Enter infinite loop */
     while (1) {
@@ -171,8 +169,8 @@ void app_main(void)
     }
     
     /* Deallocate ressources */
-    ao_deinitConnection(osock);
     ao_deinitialize();
+    ao_deinitConnection(osock);
     mg_mgr_free(&mgr);
     return;
 }

From b05ef234dbc09ae27df06b10d8d6eb5bbe459787 Mon Sep 17 00:00:00 2001
From: zhushengsheng001 <139214977+zhushengsheng001@users.noreply.github.com>
Date: Sat, 29 Jul 2023 08:05:54 +0800
Subject: [PATCH 333/549] Update ConfigurationKeyValue.cpp

 fix memory check error reported by "valgrind --tool=memcheck --leak-check=full --show-leak-kinds=all ..."
---
 src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index b3dafcaa..5bfa77b4 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -133,11 +133,11 @@ const T &Configuration<T>::operator=(const T & newVal) {
             printValue(newVal);
             AO_CONSOLE_PRINTF("\n");
         }
-        initializedValue = true;
-        if (value != newVal) {
+        if (initializedValue == true && value != newVal) {
             value_revision++;
         }
         value = newVal;
+        initializedValue = true;
     } else {
         AO_DBG_ERR("Tried to override read-only configuration:");
         AO_CONSOLE_PRINTF("[AO]     > Key = ");

From afc1fe9bffb87fe6d12601b4424cea4a58d6be71 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 31 Jul 2023 13:15:45 +0200
Subject: [PATCH 334/549] trigger CI on PR

---
 .github/workflows/esp-idf.yml      | 2 ++
 .github/workflows/pio.yml          | 2 ++
 .github/workflows/platformless.yml | 2 ++
 .github/workflows/tests.yml        | 2 ++
 4 files changed, 8 insertions(+)

diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
index 0ed1a8aa..4513cf88 100644
--- a/.github/workflows/esp-idf.yml
+++ b/.github/workflows/esp-idf.yml
@@ -6,6 +6,8 @@ on:
       - master
       - develop
 
+  pull_request:
+
 jobs:
   build:
 
diff --git a/.github/workflows/pio.yml b/.github/workflows/pio.yml
index 7167d595..d0fcb568 100644
--- a/.github/workflows/pio.yml
+++ b/.github/workflows/pio.yml
@@ -6,6 +6,8 @@ on:
       - master
       - develop
 
+  pull_request:
+
 jobs:
   build:
 
diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index e2765113..24f3ce1c 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -6,6 +6,8 @@ on:
       - master
       - develop
 
+  pull_request:
+
 jobs:
 
   compile-platform:
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index bdcf279c..0f79f34e 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -6,6 +6,8 @@ on:
       - master
       - develop
 
+  pull_request:
+
 jobs:
 
   compile-and-run:

From f55a0a21596f13cb633f97cdcd0b458ba24ae5c0 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 3 Aug 2023 14:17:43 +0200
Subject: [PATCH 335/549] remove uninitialized error code (fixes #164)

---
 src/ArduinoOcpp/Operations/ClearChargingProfile.h | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/ArduinoOcpp/Operations/ClearChargingProfile.h b/src/ArduinoOcpp/Operations/ClearChargingProfile.h
index 522b0cf0..657cc9cb 100644
--- a/src/ArduinoOcpp/Operations/ClearChargingProfile.h
+++ b/src/ArduinoOcpp/Operations/ClearChargingProfile.h
@@ -17,7 +17,6 @@ class ClearChargingProfile : public Operation {
 private:
     SmartChargingService& scService;
     bool matchingProfilesFound = false;
-    const char *errorCode;
 public:
     ClearChargingProfile(SmartChargingService& scService);
 
@@ -26,8 +25,6 @@ class ClearChargingProfile : public Operation {
     void processReq(JsonObject payload);
 
     std::unique_ptr<DynamicJsonDocument> createConf();
-
-    const char *getErrorCode() {return errorCode;}
     
 };
 

From 63f28f1880d8572c96465134b23008877c4dc314 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 6 Aug 2023 20:30:54 +0200
Subject: [PATCH 336/549] refactor Configs to allow custom storage class

---
 src/ArduinoOcpp/Core/Configuration.cpp        |  19 +--
 .../Core/ConfigurationContainer.cpp           |   4 +-
 .../Core/ConfigurationContainerFlash.cpp      |  25 ++-
 .../Core/ConfigurationKeyValue.cpp            | 155 +++++-------------
 src/ArduinoOcpp/Core/ConfigurationKeyValue.h  |  14 +-
 .../Authorization/AuthorizationService.cpp    |   2 +-
 .../ChargeControl/ChargeControlCommon.cpp     |   4 +-
 .../Model/Diagnostics/DiagnosticsService.cpp  |   2 +-
 .../FirmwareManagement/FirmwareService.cpp    |   4 +-
 .../Model/Reservation/ReservationService.cpp  |   2 +-
 .../SmartCharging/SmartChargingService.cpp    |   2 +-
 11 files changed, 80 insertions(+), 153 deletions(-)

diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/ArduinoOcpp/Core/Configuration.cpp
index 334d7653..e8db8fcf 100644
--- a/src/ArduinoOcpp/Core/Configuration.cpp
+++ b/src/ArduinoOcpp/Core/Configuration.cpp
@@ -17,31 +17,24 @@ std::shared_ptr<FilesystemAdapter> filesystem;
 template<class T>
 std::shared_ptr<Configuration<T>> createConfiguration(const char *key, T value) {
 
-    std::shared_ptr<Configuration<T>> configuration = std::make_shared<Configuration<T>>();
-        
-    if (!configuration->setKey(key)) {
-        AO_DBG_ERR("Cannot set key! Abort");
+    if (!key || !*key) {
+        AO_DBG_ERR("invalid args");
         return nullptr;
     }
 
-    *configuration = value;
+    std::shared_ptr<Configuration<T>> configuration = std::make_shared<Configuration<T>>(key, value);
 
     return configuration;
 }
 
 std::shared_ptr<Configuration<const char *>> createConfiguration(const char *key, const char *value) {
 
-    std::shared_ptr<Configuration<const char*>> configuration = std::make_shared<Configuration<const char*>>();
-        
-    if (!configuration->setKey(key)) {
-        AO_DBG_ERR("Cannot set key! Abort");
+    if (!key || !*key || !value) {
+        AO_DBG_ERR("invalid args");
         return nullptr;
     }
 
-    if (!configuration->setValue(value, strlen(value) + 1)) {
-        AO_DBG_ERR("Cannot set value! Abort");
-        return nullptr;
-    }
+    std::shared_ptr<Configuration<const char*>> configuration = std::make_shared<Configuration<const char*>>(key, value);
 
     return configuration;
 }
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainer.cpp b/src/ArduinoOcpp/Core/ConfigurationContainer.cpp
index 1fa7ffcf..e420080d 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainer.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainer.cpp
@@ -8,11 +8,11 @@ namespace ArduinoOcpp {
 
 std::shared_ptr<AbstractConfiguration> ConfigurationContainer::getConfiguration(const char *key) {
     for (std::vector<std::shared_ptr<AbstractConfiguration>>::iterator configuration = configurations.begin(); configuration != configurations.end(); configuration++) {
-        if ((*configuration)->keyEquals(key)) {
+        if (!strcmp(key, (*configuration)->getKey())) {
             return *configuration;
         }
     }
-    return NULL;
+    return nullptr;
 }
 
 bool ConfigurationContainer::removeConfiguration(std::shared_ptr<AbstractConfiguration> configuration) {
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
index 079da8ed..68192084 100644
--- a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
@@ -58,18 +58,27 @@ bool ConfigurationContainerFlash::load() {
     }
 
     for (JsonObject config : configurationsArray) {
+        const char *key = config["key"] | "";
+        if (!*key || !config.containsKey("value")) {
+            AO_DBG_ERR("corrupt config");
+            continue;
+        }
+
         const char *type = config["type"] | "Undefined";
 
         std::shared_ptr<AbstractConfiguration> configuration = nullptr;
 
-        if (!strcmp(type, SerializedType<int>::get())){
-            configuration = std::make_shared<Configuration<int>>(config);
-        } else if (!strcmp(type, SerializedType<float>::get())){
-            configuration = std::make_shared<Configuration<float>>(config);
-        } else if (!strcmp(type, SerializedType<bool>::get())){
-            configuration = std::make_shared<Configuration<bool>>(config);
-        } else if (!strcmp(type, SerializedType<const char *>::get())){
-            configuration = std::make_shared<Configuration<const char *>>(config);
+        if (!strcmp(type, SerializedType<int>::get()) && config["value"].is<int>()){
+            configuration = std::make_shared<Configuration<int>>(key, config["value"].as<int>());
+        } else if (!strcmp(type, SerializedType<float>::get()) && config["value"].is<float>()){
+            configuration = std::make_shared<Configuration<float>>(key, config["value"].as<float>());
+        } else if (!strcmp(type, SerializedType<bool>::get()) && config["value"].is<bool>()){
+            configuration = std::make_shared<Configuration<bool>>(key, config["value"].as<bool>());
+        } else if (!strcmp(type, SerializedType<const char *>::get()) && config["value"].is<const char*>()){
+            configuration = std::make_shared<Configuration<const char *>>(key, config["value"].as<const char*>());
+        } else {
+            AO_DBG_ERR("corrupt config");
+            continue;
         }
 
         if (configuration) {
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index 5bfa77b4..6dc5543c 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -14,23 +14,34 @@
 
 namespace ArduinoOcpp {
 
-AbstractConfiguration::AbstractConfiguration() {
+int toCStringValue(char *buf, size_t length, int value) {
+    return snprintf(buf, length, "%d", value);
+}
 
+int toCStringValue(char *buf, size_t length, float value) {
+    int ilength = (int) std::min((size_t) 100, length);
+    return snprintf(buf, length, "%.*g", ilength >= 7 ? ilength - 7 : 0, value);
 }
 
-AbstractConfiguration::AbstractConfiguration(JsonObject &storedKeyValuePair) {
-    if (!setKey(storedKeyValuePair["key"] | "")) {
-        AO_DBG_ERR("validation error");
+int toCStringValue(char *buf, size_t length, bool value) {
+    return snprintf(buf, length, "%s", value ? "true" : "false");
+}
+
+AbstractConfiguration::AbstractConfiguration(const char *key) {
+    if (!key || !*key) {
+        AO_DBG_ERR("invalid argument");
+        return;
     }
+
+    this->key = key;
 }
 
 AbstractConfiguration::~AbstractConfiguration() {
 
 }
 
-void AbstractConfiguration::printKey() {
-    AO_CONSOLE_PRINTF("%s", key.c_str());
-    (void)0;
+const char *AbstractConfiguration::getKey() {
+    return key.c_str();
 }
 
 size_t AbstractConfiguration::getStorageHeaderJsonCapacity() {
@@ -58,21 +69,6 @@ bool AbstractConfiguration::isValid() {
     return initializedValue && !key.empty();
 }
 
-bool AbstractConfiguration::setKey(const char *newKey) {
-    if (!key.empty()) {
-        AO_DBG_ERR("cannot override key");
-        return false;
-    }
-
-    if (!newKey || *newKey == '\0') {
-        AO_DBG_ERR("invalid argument");
-        return false;
-    }
-
-    key = newKey;
-    return true;
-}
-
 void AbstractConfiguration::requireRebootWhenChanged() {
     rebootRequiredWhenChanged = true;
 }
@@ -85,53 +81,20 @@ uint16_t AbstractConfiguration::getValueRevision() {
     return value_revision;
 }
 
-bool AbstractConfiguration::keyEquals(const char *other) {
-    return !key.compare(other);
-}
-
-template <class T>
-Configuration<T>::Configuration() {
-
-}
-
-Configuration<const char *>::Configuration() {
-
-}
-
 template<class T>
-Configuration<T>::Configuration(JsonObject &storedKeyValuePair) : AbstractConfiguration(storedKeyValuePair) {
-    auto jsonEntry = storedKeyValuePair["value"].as<JsonVariant>();
-    if (jsonEntry.is<T>()) {
-        this->operator=(jsonEntry.as<T>());
-    } else {
-        AO_DBG_ERR("Type mismatch: cannot deserialize Json to given type");
-    }
-}
-
-//helper functions
-void printValue(int value) {
-    AO_CONSOLE_PRINTF("%i", value);
-}
-
-void printValue(float value) {
-    AO_CONSOLE_PRINTF("%f", value);
-}
-
-void printValue(bool value) {
-    AO_CONSOLE_PRINTF("%s", value ? "true" : "false");
+Configuration<T>::Configuration(const char *key, T value) : AbstractConfiguration(key) {
+    this->operator=(value);
 }
 
 template <class T>
 const T &Configuration<T>::operator=(const T & newVal) {
 
     if (permissionLocalClientCanWrite() || !initializedValue) {
-        if (AO_DBG_LEVEL >= AO_DL_DEBUG && !initializedValue) {
-            AO_DBG_DEBUG("Initialized config object:");
-            AO_CONSOLE_PRINTF("[AO]     > Key = ");
-            printKey();
-            AO_CONSOLE_PRINTF(", value = ");
-            printValue(newVal);
-            AO_CONSOLE_PRINTF("\n");
+        if (!initializedValue) {
+            const size_t VALUE_MAXSIZE = 50;
+            char value_str [VALUE_MAXSIZE] = {'\0'};
+            toCStringValue(value_str, VALUE_MAXSIZE, newVal);
+            AO_DBG_DEBUG("add config: key = %s, value = %s\n", getKey(), value_str);
         }
         if (initializedValue == true && value != newVal) {
             value_revision++;
@@ -139,10 +102,7 @@ const T &Configuration<T>::operator=(const T & newVal) {
         value = newVal;
         initializedValue = true;
     } else {
-        AO_DBG_ERR("Tried to override read-only configuration:");
-        AO_CONSOLE_PRINTF("[AO]     > Key = ");
-        printKey();
-        AO_CONSOLE_PRINTF("\n");
+        AO_DBG_ERR("Tried to override read-only configuration: %s", getKey());
     }
     return newVal;
 }
@@ -183,19 +143,6 @@ std::unique_ptr<DynamicJsonDocument> Configuration<T>::toJsonStorageEntry() {
     return doc;
 }
 
-int toCStringValue(char *buf, size_t length, int value) {
-    return snprintf(buf, length, "%d", value);
-}
-
-int toCStringValue(char *buf, size_t length, float value) {
-    int ilength = (int) std::min((size_t) 100, length);
-    return snprintf(buf, length, "%.*g", ilength >= 7 ? ilength - 7 : 0, value);
-}
-
-int toCStringValue(char *buf, size_t length, bool value) {
-    return snprintf(buf, length, "%s", value ? "true" : "false");
-}
-
 template<class T>
 std::unique_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
     if (!isValid()) {
@@ -247,35 +194,28 @@ std::unique_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonOcppMsgE
     return doc;
 }
 
-Configuration<const char *>::Configuration(JsonObject &storedKeyValuePair) : AbstractConfiguration(storedKeyValuePair) {
-    if (storedKeyValuePair["value"].as<JsonVariant>().is<const char*>()) {
-        const char *storedValue = storedKeyValuePair["value"].as<JsonVariant>().as<const char*>();
-        if (storedValue) {
-            size_t storedValueSize = strlen(storedValue) + 1;
-            storedValueSize++;
-            setValue(storedValue, storedValueSize);
-        } else {
-            AO_DBG_WARN("Stored value is empty");
-        }
-    } else {
-        AO_DBG_ERR("Type mismatch: cannot deserialize Json to given type");
+Configuration<const char *>::Configuration(const char *key, const char *value) : AbstractConfiguration(key) {
+    if (!value) {
+        AO_DBG_ERR("invalid args");
+        return;
     }
+
+    this->operator=(value);
 }
 
 Configuration<const char *>::~Configuration() {
 
 }
 
-bool Configuration<const char *>::setValue(const char *new_value, size_t buffsize) {
-    if (!permissionLocalClientCanWrite() && initializedValue) {
-        AO_DBG_ERR("Tried to override read-only configuration:");
-        AO_CONSOLE_PRINTF("[AO]     > Key = ");
-        return false;
+const char *Configuration<const char *>::operator=(const char *new_value) {
+    if (!new_value) {
+        AO_DBG_ERR("invalid args");
+        return new_value;
     }
 
-    if (!new_value) {
-        AO_DBG_ERR("Argument is null. No change");
-        return false;
+    if (!permissionLocalClientCanWrite() && initializedValue) {
+        AO_DBG_ERR("Tried to override read-only configuration: %s", getKey());
+        return new_value;
     }
 
     if (value.compare(new_value) || !initializedValue) {
@@ -283,21 +223,12 @@ bool Configuration<const char *>::setValue(const char *new_value, size_t buffsiz
         value_revision++;
     }
     
-    if (AO_DBG_LEVEL >= AO_DL_DEBUG && !initializedValue) {
-        AO_DBG_DEBUG("Initialized config object:");
-        AO_CONSOLE_PRINTF("[AO]     > Key = ");
-        printKey();
-        AO_CONSOLE_PRINTF(", value = %s\n", value.c_str());
+    if (!initializedValue) {
+        AO_DBG_DEBUG("add config: key = %s, value = %s\n", getKey(), value.c_str());
+        (void)0;
     }
     initializedValue = true;
-    return true;
-}
-
-const char *Configuration<const char *>::operator=(const char *newVal) {
-    if (!setValue(newVal, strlen(newVal) + 1)) {
-        AO_DBG_ERR("Setting value in operator= was unsuccessful");
-    }
-    return newVal;
+    return new_value;
 }
 
 Configuration<const char *>::operator const char*() {
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
index 381040fb..044fc58f 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.h
@@ -25,8 +25,7 @@ class AbstractConfiguration {
     uint16_t value_revision = 0; //number of memory-relevant changes of subclass-member "value" (deleting counts too). This will be important for the client to detect if there was a change
     bool initializedValue = false;
 
-    AbstractConfiguration();
-    AbstractConfiguration(JsonObject &storedKeyValuePair);
+    AbstractConfiguration(const char *key);
     size_t getStorageHeaderJsonCapacity();
     void storeStorageHeader(JsonObject &keyValuePair);
     size_t getOcppMsgHeaderJsonCapacity();
@@ -36,14 +35,12 @@ class AbstractConfiguration {
     bool permissionLocalClientCanWrite() {return localClientCanWrite;}
 public:
     virtual ~AbstractConfiguration();
-    bool setKey(const char *key);
-    void printKey();
+    const char *getKey();
 
     void requireRebootWhenChanged();
     bool requiresRebootWhenChanged();
 
     uint16_t getValueRevision();
-    bool keyEquals(const char *other);
 
     virtual std::unique_ptr<DynamicJsonDocument> toJsonStorageEntry() = 0;
     virtual std::unique_ptr<DynamicJsonDocument> toJsonOcppMsgEntry() = 0;
@@ -74,8 +71,7 @@ class Configuration : public AbstractConfiguration {
     T value;
     size_t getValueJsonCapacity();
 public:
-    Configuration();
-    Configuration(JsonObject &storedKeyValuePair);
+    Configuration(const char *key, T value);
     const T &operator=(const T & newVal);
     operator T();
     bool isValid();
@@ -94,10 +90,8 @@ class Configuration<const char *> : public AbstractConfiguration {
 
     std::function<bool(const char*)> validator;
 public:
-    Configuration();
-    Configuration(JsonObject &storedKeyValuePair);
+    Configuration(const char *key, const char *value);
     ~Configuration();
-    bool setValue(const char *newVal, size_t buffsize);
     const char *operator=(const char *newVal);
     operator const char*();
     bool isValid();
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
index e37cc1ab..0e96f232 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
@@ -37,7 +37,7 @@ AuthorizationService::AuthorizationService(Context& context, std::shared_ptr<Fil
         if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
             fProfilePlus += ",";
         fProfilePlus += fpId;
-        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+        *fProfile = fProfilePlus.c_str();
     }
 
     context.getOperationRegistry().registerOperation("GetLocalListVersion", [&context] () {
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
index 7429b0a3..a60876dc 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
@@ -41,14 +41,14 @@ ChargeControlCommon::ChargeControlCommon(Context& context, unsigned int numConn,
         if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
             fProfilePlus += ",";
         fProfilePlus += fpIdCore;
-        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+        *fProfile = fProfilePlus.c_str();
     }
     if (!strstr(*fProfile, fpIdRTrigger)) {
         auto fProfilePlus = std::string(*fProfile);
         if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
             fProfilePlus += ",";
         fProfilePlus += fpIdRTrigger;
-        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+        *fProfile = fProfilePlus.c_str();
     }
     
     /*
diff --git a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 7f8ce5cf..ea58b3d7 100644
--- a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -23,7 +23,7 @@ DiagnosticsService::DiagnosticsService(Context& context) : context(context) {
         if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
             fProfilePlus += ",";
         fProfilePlus += fpId;
-        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+        *fProfile = fProfilePlus.c_str();
     }
     
     context.getOperationRegistry().registerOperation("GetDiagnostics", [&context] () {
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
index d6f3a96c..602b74f7 100644
--- a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -33,7 +33,7 @@ FirmwareService::FirmwareService(Context& context) : context(context) {
         if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
             fProfilePlus += ",";
         fProfilePlus += fpId;
-        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+        *fProfile = fProfilePlus.c_str();
     }
     
     context.getOperationRegistry().registerOperation("UpdateFirmware", [&context] () {
@@ -262,7 +262,7 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
         size_t buildNoSize = previousBuildNumber->getBuffsize();
         if (strncmp(buildNumber.c_str(), *previousBuildNumber, buildNoSize)) {
             //new FW
-            previousBuildNumber->setValue(buildNumber.c_str(), buildNumber.length() + 1);
+            *previousBuildNumber = buildNumber.c_str();
             configuration_save();
 
             buildNumber.clear();
diff --git a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
index 01d58433..d7eb9ec2 100644
--- a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
@@ -32,7 +32,7 @@ ReservationService::ReservationService(Context& context, unsigned int numConnect
         if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
             fProfilePlus += ",";
         fProfilePlus += fpId;
-        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+        *fProfile = fProfilePlus.c_str();
     }
     
     context.getOperationRegistry().registerOperation("CancelReservation", [&context] () {
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
index 3567088b..d91da23b 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -315,7 +315,7 @@ SmartChargingService::SmartChargingService(Context& context, std::shared_ptr<Fil
         if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
             fProfilePlus += ",";
         fProfilePlus += fpId;
-        fProfile->setValue(fProfilePlus.c_str(), fProfilePlus.length() + 1);
+        *fProfile = fProfilePlus.c_str();
     }
 
     context.getOperationRegistry().registerOperation("ClearChargingProfile", [this] () {

From 65aca572346948e6f607ceb977848eda39c7e27e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 7 Aug 2023 16:58:40 +0200
Subject: [PATCH 337/549] send msg retry after reconnect instead of offline

---
 src/ArduinoOcpp/Core/Connection.cpp   | 8 +++++++-
 src/ArduinoOcpp/Core/Connection.h     | 9 ++++++++-
 src/ArduinoOcpp/Core/RequestQueue.cpp | 4 ++--
 src/ArduinoOcpp/Core/RequestQueue.h   | 4 ++--
 4 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/src/ArduinoOcpp/Core/Connection.cpp b/src/ArduinoOcpp/Core/Connection.cpp
index 509b7ce9..d787b2de 100644
--- a/src/ArduinoOcpp/Core/Connection.cpp
+++ b/src/ArduinoOcpp/Core/Connection.cpp
@@ -47,7 +47,8 @@ bool WSClient::sendTXT(std::string &out) {
 
 void WSClient::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
     auto& captureLastRecv = lastRecv;
-    wsock->onEvent([callback, &captureLastRecv](WStype_t type, uint8_t * payload, size_t length) {
+    auto& captureLastConnected = lastConnected;
+    wsock->onEvent([callback, &captureLastRecv, &captureLastConnected](WStype_t type, uint8_t * payload, size_t length) {
         switch (type) {
             case WStype_DISCONNECTED:
                 AO_DBG_INFO("Disconnected");
@@ -55,6 +56,7 @@ void WSClient::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
             case WStype_CONNECTED:
                 AO_DBG_INFO("Connected to url: %s", payload);
                 captureLastRecv = ao_tick_ms();
+                captureLastConnected = ao_tick_ms();
                 break;
             case WStype_TEXT:
                 if (callback((const char *) payload, length)) { //forward message to RequestQueue
@@ -88,4 +90,8 @@ unsigned long WSClient::getLastRecv() {
     return lastRecv;
 }
 
+unsigned long WSClient::getLastConnected() {
+    return lastConnected;
+}
+
 #endif
diff --git a/src/ArduinoOcpp/Core/Connection.h b/src/ArduinoOcpp/Core/Connection.h
index 540f1e6e..a162e70a 100644
--- a/src/ArduinoOcpp/Core/Connection.h
+++ b/src/ArduinoOcpp/Core/Connection.h
@@ -49,6 +49,11 @@ class Connection {
      * Returns the timestamp of the last incoming message. Use ao_tick_ms() for creating the correct timestamp
      */
     virtual unsigned long getLastRecv() {return 0;}
+
+    /*
+     * Returns the timestamp of the last time a connection got successfully established. Use ao_tick_ms() for creating the correct timestamp
+     */
+    virtual unsigned long getLastConnected() {return 0;}
 };
 
 class LoopbackConnection : public Connection {
@@ -79,7 +84,7 @@ namespace EspWiFi {
 class WSClient : public Connection {
 private:
     WebSocketsClient *wsock;
-    unsigned long lastRecv = 0;
+    unsigned long lastRecv = 0, lastConnected = 0;
 public:
     WSClient(WebSocketsClient *wsock);
 
@@ -90,6 +95,8 @@ class WSClient : public Connection {
     void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT);
 
     unsigned long getLastRecv() override; //get time of last successful receive in millis
+
+    unsigned long getLastConnected() override; //get last connection creation in millis
 };
 
 } //end namespace EspWiFi
diff --git a/src/ArduinoOcpp/Core/RequestQueue.cpp b/src/ArduinoOcpp/Core/RequestQueue.cpp
index 7c840884..82383042 100644
--- a/src/ArduinoOcpp/Core/RequestQueue.cpp
+++ b/src/ArduinoOcpp/Core/RequestQueue.cpp
@@ -91,11 +91,11 @@ void RequestQueue::loop(Connection& ocppSock) {
         sendBackoffPeriod = 0;
     }
 
-    if (sockTrackLastRecv != ocppSock.getLastRecv()) {
+    if (sockTrackLastConnected != ocppSock.getLastConnected()) {
         //connection active (again) -> send immediately
         sendBackoffPeriod = std::min(sendBackoffPeriod, 1000UL);
     }
-    sockTrackLastRecv = ocppSock.getLastRecv();
+    sockTrackLastConnected = ocppSock.getLastConnected();
 
     if (ao_tick_ms() - sendBackoffTime < sendBackoffPeriod) {
         //still in backoff period
diff --git a/src/ArduinoOcpp/Core/RequestQueue.h b/src/ArduinoOcpp/Core/RequestQueue.h
index 63f5c459..a6615337 100644
--- a/src/ArduinoOcpp/Core/RequestQueue.h
+++ b/src/ArduinoOcpp/Core/RequestQueue.h
@@ -32,8 +32,8 @@ class RequestQueue {
 
     unsigned long sendBackoffTime = 0;
     unsigned long sendBackoffPeriod = 0;
-    unsigned long sockTrackLastRecv = 0;
-    const unsigned long BACKOFF_PERIOD_MAX = 65536;
+    unsigned long sockTrackLastConnected = 0;
+    const unsigned long BACKOFF_PERIOD_MAX = 1048576;
     const unsigned long BACKOFF_PERIOD_INCREMENT = BACKOFF_PERIOD_MAX / 4;
 public:
     RequestQueue(OperationRegistry& operationRegistry, Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem = nullptr);

From 272e5a2ccc7b1a25f71e014585aa9f0f09f590f8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 7 Aug 2023 17:59:09 +0200
Subject: [PATCH 338/549] backoff period not entered while known offline

---
 src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp | 4 ++--
 src/ArduinoOcpp/Core/Connection.cpp            | 2 +-
 src/ArduinoOcpp/Core/RequestQueue.cpp          | 9 ++++-----
 3 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
index 6dc5543c..1e251e48 100644
--- a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
@@ -94,7 +94,7 @@ const T &Configuration<T>::operator=(const T & newVal) {
             const size_t VALUE_MAXSIZE = 50;
             char value_str [VALUE_MAXSIZE] = {'\0'};
             toCStringValue(value_str, VALUE_MAXSIZE, newVal);
-            AO_DBG_DEBUG("add config: key = %s, value = %s\n", getKey(), value_str);
+            AO_DBG_DEBUG("add config: key = %s, value = %s", getKey(), value_str);
         }
         if (initializedValue == true && value != newVal) {
             value_revision++;
@@ -224,7 +224,7 @@ const char *Configuration<const char *>::operator=(const char *new_value) {
     }
     
     if (!initializedValue) {
-        AO_DBG_DEBUG("add config: key = %s, value = %s\n", getKey(), value.c_str());
+        AO_DBG_DEBUG("add config: key = %s, value = %s", getKey(), value.c_str());
         (void)0;
     }
     initializedValue = true;
diff --git a/src/ArduinoOcpp/Core/Connection.cpp b/src/ArduinoOcpp/Core/Connection.cpp
index d787b2de..364895c0 100644
--- a/src/ArduinoOcpp/Core/Connection.cpp
+++ b/src/ArduinoOcpp/Core/Connection.cpp
@@ -11,7 +11,7 @@ void LoopbackConnection::loop() { }
 
 bool LoopbackConnection::sendTXT(std::string &out) {
     if (!connected) {
-        return true;
+        return false;
     }
     if (receiveTXT) {
         lastRecv = ao_tick_ms();
diff --git a/src/ArduinoOcpp/Core/RequestQueue.cpp b/src/ArduinoOcpp/Core/RequestQueue.cpp
index 82383042..da79ad46 100644
--- a/src/ArduinoOcpp/Core/RequestQueue.cpp
+++ b/src/ArduinoOcpp/Core/RequestQueue.cpp
@@ -117,12 +117,11 @@ void RequestQueue::loop(Connection& ocppSock) {
 
     if (success) {
         AO_DBG_TRAFFIC_OUT(out.c_str());
-    }
 
-    //update backoff time
-    sendBackoffTime = ao_tick_ms();
-    sendBackoffPeriod = std::min(sendBackoffPeriod + BACKOFF_PERIOD_INCREMENT, BACKOFF_PERIOD_MAX);
-    
+        //update backoff time
+        sendBackoffTime = ao_tick_ms();
+        sendBackoffPeriod = std::min(sendBackoffPeriod + BACKOFF_PERIOD_INCREMENT, BACKOFF_PERIOD_MAX);
+    }
 }
 
 void RequestQueue::sendRequest(std::unique_ptr<Request> op){

From aa1c253434bfb4113512a7112864311de4a06cbe Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 14 Aug 2023 15:47:40 +0200
Subject: [PATCH 339/549] connectorId 0 inoperative only after all tx ended

---
 src/ArduinoOcpp/Model/ChargeControl/Connector.cpp | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index 7a178398..dba1484d 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -764,8 +764,17 @@ bool Connector::isOperative() {
         return false;
     }
 
-    if (transaction && transaction->isRunning()) {
-        return true;
+    //check for running transaction(s) - if yes then the connector is always operative
+    if (connectorId == 0) {
+        for (unsigned int cId = 1; cId < model.getNumConnectors(); cId++) {
+            if (model.getConnector(cId)->getTransaction() && model.getConnector(cId)->getTransaction()->isRunning()) {
+                return true;
+            }
+        }
+    } else {
+        if (transaction && transaction->isRunning()) {
+            return true;
+        }
     }
 
     return availabilityVolatile && *availability;

From c5923cb191d4c023585c79bd9a0f5f99d2a8fa91 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 18 Aug 2023 19:09:34 +0200
Subject: [PATCH 340/549] upgrade ESP32 platform version

---
 library.json                               | 39 ++++++++--------------
 library.properties                         |  2 +-
 platformio.ini                             | 11 +++---
 src/ArduinoOcpp/Core/FilesystemAdapter.cpp | 18 ++++++++--
 4 files changed, 33 insertions(+), 37 deletions(-)

diff --git a/library.json b/library.json
index 5fb9c93d..723b1e4c 100644
--- a/library.json
+++ b/library.json
@@ -1,6 +1,6 @@
 {
     "name": "ArduinoOcpp",
-    "version": "0.2.0",
+    "version": "0.3.0",
     "description": "OCPP 1.6 Client for the ESP8266 and ESP32",
     "keywords": "OCPP, 1.6, OCPP 1.6, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, EVSE, Charge Point",
     "repository":
@@ -22,18 +22,12 @@
         {
             "owner": "bblanchon",
             "name": "ArduinoJson",
-            "version": "6.19.1"
+            "version": "6.20.1"
         },
         {
             "owner": "links2004",
             "name": "WebSockets",
-            "version": "2.3.6"
-        },
-        {
-            "owner": "lorol",
-            "name": "LittleFS_esp32",
-            "version": "1.0.5",
-            "platforms": ["espressif32"]
+            "version": "2.4.1"
         }
       ],
     "frameworks": "arduino",
@@ -43,19 +37,14 @@
         "include":
         [
             "src/*",
-            "examples/ESP/*",
-            "examples/ESP-TLS/*",
-            "examples/SECC/*",
+            "examples/*",
             "platformio.ini",
             "library.json",
+            "library.properties",
             "README.md",
+            "CMakeLists.txt",
+            "docs/*",
             "LICENSE"
-        ],
-        "exclude":
-        [
-            "src/sdkconfig*",
-            "examples/SECC/WiFiManager*",
-            "src/main*"
         ]
     },
 
@@ -75,13 +64,11 @@
           ]
       },
       {
-        "name": "EVSE Communications Controller",
-        "base": "examples/SECC",
+        "name": "ESP-IDF integration",
+        "base": "examples/ESP-IDF",
         "files": [
-            "main.cpp",
-            "platformio.ini",
-            "README.md"
+            "main.c"
         ]
-    }
-  ]
-  }
\ No newline at end of file
+      }
+    ]
+}
diff --git a/library.properties b/library.properties
index 7e944f3f..5b7df003 100644
--- a/library.properties
+++ b/library.properties
@@ -1,5 +1,5 @@
 name=ArduinoOcpp
-version=0.1.0
+version=0.3.0
 author=Matthias Akstaller
 maintainer=Matthias Akstaller
 sentence=OCPP 1.6 Client for the ESP8266 and ESP32 (more coming soon)
diff --git a/platformio.ini b/platformio.ini
index ec11a715..e5c55973 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -8,8 +8,8 @@ default_envs = esp32-development-board
 [common]
 framework = arduino
 lib_deps =
-    bblanchon/ArduinoJson@6.19.1
-    links2004/WebSockets@2.3.6
+    bblanchon/ArduinoJson@6.20.1
+    links2004/WebSockets@2.4.1
 monitor_speed = 115200
 
 [env:nodemcuv2]
@@ -24,16 +24,13 @@ build_flags =
     -D ARDUINOJSON_ENABLE_STD_STRING=1
 
 [env:esp32-development-board]
-platform = espressif32@3.5.0
+platform = espressif32@6.0.1
 board = esp-wrover-kit
 framework = ${common.framework}
-lib_deps =
-    ${common.lib_deps}
-    lorol/LittleFS_esp32@1.0.5
+lib_deps = ${common.lib_deps}
 monitor_speed = ${common.monitor_speed}
 build_flags =
     -D AO_DBG_LEVEL=AO_DL_INFO ; flood the serial monitor with information about the internal state
     -DAO_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
-    -DCONFIG_LITTLEFS_FOR_IDF_3_2
 board_build.partitions = min_spiffs.csv
 upload_speed = 921600
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
index afad4f15..d546ca1f 100644
--- a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
+++ b/src/ArduinoOcpp/Core/FilesystemAdapter.cpp
@@ -22,8 +22,9 @@
 #if AO_USE_FILEAPI == ARDUINO_LITTLEFS || AO_USE_FILEAPI == ARDUINO_SPIFFS
 
 #if AO_USE_FILEAPI == ARDUINO_LITTLEFS
-#include <LITTLEFS.h>
-#define USE_FS LITTLEFS
+#include <LittleFS.h>
+#include <vfs_api.h>
+#define USE_FS LittleFS
 #elif AO_USE_FILEAPI == ARDUINO_SPIFFS
 #include <FS.h>
 #define USE_FS SPIFFS
@@ -98,6 +99,14 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     operator bool() {return valid;}
 
     int stat(const char *path, size_t *size) override {
+#if AO_USE_FILEAPI == ARDUINO_LITTLEFS
+        struct ::stat st;
+        auto ret = ::stat(path, &st);
+        if (ret == 0) {
+            *size = st.st_size;
+        }
+        return ret;
+#elif AO_USE_FILEAPI == ARDUINO_SPIFFS
         if (!USE_FS.exists(path)) {
             return -1;
         }
@@ -117,7 +126,10 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
 
         f.close();
         return status;
-    }
+#else
+#error
+#endif
+    } //end stat
 
     std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {
         File file = USE_FS.open(fn, mode);

From e7d9d7440e839df64ba42fe18306c03dc4a8b2c2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 18 Aug 2023 20:59:32 +0200
Subject: [PATCH 341/549] better debug msg readability

---
 src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
index 3567088b..c80fe1bc 100644
--- a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -517,7 +517,10 @@ void SmartChargingService::loop(){
         char timestamp2[JSONDATE_LENGTH + 1] = {'\0'};
         nextChange.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
         AO_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = {%f,%f,%i}",
-                            timestamp1, timestamp2, limit.power, limit.current, limit.nphases);
+                            timestamp1, timestamp2,
+                            limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
+                            limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
+                            limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
 #endif
 
         if (trackLimitOutput != limit) {

From 6bbbd128ff5e6981d04c66c1cddb4095d31b8c7b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 18 Aug 2023 21:24:03 +0200
Subject: [PATCH 342/549] update PIO registry manifest

---
 library.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/library.json b/library.json
index 723b1e4c..23e5fc3d 100644
--- a/library.json
+++ b/library.json
@@ -67,7 +67,7 @@
         "name": "ESP-IDF integration",
         "base": "examples/ESP-IDF",
         "files": [
-            "main.c"
+            "main/main.c"
         ]
       }
     ]

From 6aaefcb05f5b688da5bd7fe5647c1665b5ab8429 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 19 Aug 2023 21:58:36 +0200
Subject: [PATCH 343/549] reorder params of TxNotification output

---
 src/ArduinoOcpp.cpp                               |  2 +-
 src/ArduinoOcpp.h                                 |  2 +-
 src/ArduinoOcpp/Model/ChargeControl/Connector.cpp |  4 ++--
 src/ArduinoOcpp/Model/ChargeControl/Connector.h   |  4 ++--
 src/ArduinoOcpp_c.cpp                             | 12 ++++++------
 src/ArduinoOcpp_c.h                               |  4 ++--
 6 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index 3e28670c..aa5752ac 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -637,7 +637,7 @@ void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connect
     connector->setStopTxReadyInput(stopTxReady);
 }
 
-void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId) {
+void setTxNotificationOutput(std::function<void(ArduinoOcpp::Transaction*,ArduinoOcpp::TxNotification)> notificationOutput, unsigned int connectorId) {
     if (!context) {
         AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
         return;
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index 5830c70a..d8c30a83 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -256,7 +256,7 @@ void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int conne
 
 void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId = 1); //Input if charger is ready for StopTransaction
 
-void setTxNotificationOutput(std::function<void(ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*)> notificationOutput, unsigned int connectorId = 1);
+void setTxNotificationOutput(std::function<void(ArduinoOcpp::Transaction*,ArduinoOcpp::TxNotification)> notificationOutput, unsigned int connectorId = 1); //called when transaction state changes (see TxNotification for possible events). Transaction can be null
 
 /*
  * Set an InputOutput (reads and sets information at the same time) for forcing to unlock the
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
index dba1484d..0c6a1201 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
@@ -832,12 +832,12 @@ void Connector::setOccupiedInput(std::function<bool()> occupied) {
     this->occupiedInput = occupied;
 }
 
-void Connector::setTxNotificationOutput(std::function<void(TxNotification, Transaction*)> txNotificationOutput) {
+void Connector::setTxNotificationOutput(std::function<void(Transaction*, TxNotification)> txNotificationOutput) {
     this->txNotificationOutput = txNotificationOutput;
 }
 
 void Connector::updateTxNotification(TxNotification event) {
     if (txNotificationOutput) {
-        txNotificationOutput(event, transaction.get());
+        txNotificationOutput(transaction.get(), event);
     }
 }
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
index 01226313..ce195d97 100644
--- a/src/ArduinoOcpp/Model/ChargeControl/Connector.h
+++ b/src/ArduinoOcpp/Model/ChargeControl/Connector.h
@@ -54,7 +54,7 @@ class Connector {
     std::function<bool()> stopTxReadyInput; //the StopTx request will be delayed while this Input is false
     std::function<bool()> occupiedInput; //instead of Available, go into Preparing / Finishing state
 
-    std::function<void(TxNotification,Transaction*)> txNotificationOutput;
+    std::function<void(Transaction*,TxNotification)> txNotificationOutput;
 
     std::shared_ptr<Configuration<int>> connectionTimeOut; //in seconds
     std::shared_ptr<Configuration<bool>> stopTransactionOnInvalidId;
@@ -118,7 +118,7 @@ class Connector {
     void setStopTxReadyInput(std::function<bool()> stopTxReady);
     void setOccupiedInput(std::function<bool()> occupied);
 
-    void setTxNotificationOutput(std::function<void(TxNotification, Transaction*)> txNotificationOutput);
+    void setTxNotificationOutput(std::function<void(Transaction*,TxNotification)> txNotificationOutput);
     void updateTxNotification(TxNotification event);
 };
 
diff --git a/src/ArduinoOcpp_c.cpp b/src/ArduinoOcpp_c.cpp
index 4415b717..3a19ea86 100644
--- a/src/ArduinoOcpp_c.cpp
+++ b/src/ArduinoOcpp_c.cpp
@@ -297,14 +297,14 @@ void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady)
     setStopTxReadyInput(adaptFn(connectorId, stopTxReady), connectorId);
 }
 
-void ao_setTxNotificationOutput(void (*notificationOutput)(enum AO_TxNotification, AO_Transaction*)) {
-    setTxNotificationOutput([notificationOutput] (ArduinoOcpp::TxNotification notification, ArduinoOcpp::Transaction *tx) {
-        notificationOutput(convertTxNotification(notification), reinterpret_cast<AO_Transaction*>(tx));
+void ao_setTxNotificationOutput(void (*notificationOutput)(AO_Transaction*, enum AO_TxNotification)) {
+    setTxNotificationOutput([notificationOutput] (ArduinoOcpp::Transaction *tx, ArduinoOcpp::TxNotification notification) {
+        notificationOutput(reinterpret_cast<AO_Transaction*>(tx), convertTxNotification(notification));
     });
 }
-void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, enum AO_TxNotification, AO_Transaction*)) {
-    setTxNotificationOutput([notificationOutput, connectorId] (ArduinoOcpp::TxNotification notification, ArduinoOcpp::Transaction *tx) {
-        notificationOutput(connectorId, convertTxNotification(notification), reinterpret_cast<AO_Transaction*>(tx));
+void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AO_Transaction*, enum AO_TxNotification)) {
+    setTxNotificationOutput([notificationOutput, connectorId] (ArduinoOcpp::Transaction *tx, ArduinoOcpp::TxNotification notification) {
+        notificationOutput(connectorId, reinterpret_cast<AO_Transaction*>(tx), convertTxNotification(notification));
     }, connectorId);
 }
 
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 19b44fb5..227a25bf 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -144,8 +144,8 @@ void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxRead
 void ao_setStopTxReadyInput(InputBool stopTxReady);
 void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady);
 
-void ao_setTxNotificationOutput(void (*notificationOutput)(enum AO_TxNotification, AO_Transaction*));
-void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, enum AO_TxNotification, AO_Transaction*));
+void ao_setTxNotificationOutput(void (*notificationOutput)(AO_Transaction*, enum AO_TxNotification));
+void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AO_Transaction*, enum AO_TxNotification));
 
 void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
 void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);

From 9324090b806a610ec1f9a81c0d4cc58c489409a9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 19 Aug 2023 22:45:18 +0200
Subject: [PATCH 344/549] fix test case

---
 tests/Api.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/Api.cpp b/tests/Api.cpp
index 3a112c8f..6675689a 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -54,7 +54,7 @@ TEST_CASE( "C++ API test" ) {
         setOccupiedInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return false;});
         setStartTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setStopTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
-        setTxNotificationOutput([c = &checkpoints[ncheck++]] (ArduinoOcpp::TxNotification,ArduinoOcpp::Transaction*) {*c = true;});
+        setTxNotificationOutput([c = &checkpoints[ncheck++]] (ArduinoOcpp::Transaction*, ArduinoOcpp::TxNotification) {*c = true;});
         setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> ArduinoOcpp::PollResult<bool> {*c = true; return true;});
 
         setOnResetNotify([c = &checkpoints[ncheck++]] (bool) -> bool {*c = true; return true;});
@@ -240,8 +240,8 @@ TEST_CASE( "C API test" ) {
         ao_setStartTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[21] = true; return true;}); ncheckc++;
         ao_setStopTxReadyInput([] () -> bool {checkpointsc[22] = true; return true;}); ncheckc++;
         ao_setStopTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[23] = true; return true;}); ncheckc++;
-        ao_setTxNotificationOutput([] (AO_TxNotification, AO_Transaction*) {checkpointsc[24] = true;}); ncheckc++;
-        ao_setTxNotificationOutput_m(2, [] (unsigned int, AO_TxNotification, AO_Transaction*) {checkpointsc[25] = true;}); ncheckc++;
+        ao_setTxNotificationOutput([] (AO_Transaction*, AO_TxNotification) {checkpointsc[24] = true;}); ncheckc++;
+        ao_setTxNotificationOutput_m(2, [] (unsigned int, AO_Transaction*, AO_TxNotification) {checkpointsc[25] = true;}); ncheckc++;
         ao_setOnUnlockConnectorInOut([] () -> OptionalBool {checkpointsc[26] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
         ao_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> OptionalBool {checkpointsc[27] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
 

From 295640610cb6996e97d101d87e8d019b57b07277 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 19 Aug 2023 23:01:58 +0200
Subject: [PATCH 345/549] rename module ConnectorBase

---
 .../Model/{ChargeControl => ConnectorBase}/ChargePointErrorData.h | 0
 .../Model/{ChargeControl => ConnectorBase}/ChargePointStatus.h    | 0
 .../Model/{ChargeControl => ConnectorBase}/Connector.cpp          | 0
 .../Model/{ChargeControl => ConnectorBase}/Connector.h            | 0
 .../ConnectorsCommon.cpp}                                         | 0
 .../ChargeControlCommon.h => ConnectorBase/ConnectorsCommon.h}    | 0
 .../Model/{ChargeControl => ConnectorBase}/Notification.cpp       | 0
 .../Model/{ChargeControl => ConnectorBase}/Notification.h         | 0
 8 files changed, 0 insertions(+), 0 deletions(-)
 rename src/ArduinoOcpp/Model/{ChargeControl => ConnectorBase}/ChargePointErrorData.h (100%)
 rename src/ArduinoOcpp/Model/{ChargeControl => ConnectorBase}/ChargePointStatus.h (100%)
 rename src/ArduinoOcpp/Model/{ChargeControl => ConnectorBase}/Connector.cpp (100%)
 rename src/ArduinoOcpp/Model/{ChargeControl => ConnectorBase}/Connector.h (100%)
 rename src/ArduinoOcpp/Model/{ChargeControl/ChargeControlCommon.cpp => ConnectorBase/ConnectorsCommon.cpp} (100%)
 rename src/ArduinoOcpp/Model/{ChargeControl/ChargeControlCommon.h => ConnectorBase/ConnectorsCommon.h} (100%)
 rename src/ArduinoOcpp/Model/{ChargeControl => ConnectorBase}/Notification.cpp (100%)
 rename src/ArduinoOcpp/Model/{ChargeControl => ConnectorBase}/Notification.h (100%)

diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h b/src/ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h
rename to src/ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h b/src/ArduinoOcpp/Model/ConnectorBase/ChargePointStatus.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h
rename to src/ArduinoOcpp/Model/ConnectorBase/ChargePointStatus.h
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.cpp b/src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
rename to src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Connector.h b/src/ArduinoOcpp/Model/ConnectorBase/Connector.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ChargeControl/Connector.h
rename to src/ArduinoOcpp/Model/ConnectorBase/Connector.h
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp b/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
rename to src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
diff --git a/src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h b/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h
rename to src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Notification.cpp b/src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/ChargeControl/Notification.cpp
rename to src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp
diff --git a/src/ArduinoOcpp/Model/ChargeControl/Notification.h b/src/ArduinoOcpp/Model/ConnectorBase/Notification.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ChargeControl/Notification.h
rename to src/ArduinoOcpp/Model/ConnectorBase/Notification.h

From 6e594d8403c82160879d99d246b7c22d39e8e07c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 19 Aug 2023 23:07:27 +0200
Subject: [PATCH 346/549] rename module ConnectorBase in source

---
 CMakeLists.txt                                         |  6 +++---
 src/ArduinoOcpp.cpp                                    |  6 +++---
 src/ArduinoOcpp.h                                      |  4 ++--
 .../Model/Authorization/AuthorizationService.cpp       |  2 +-
 src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp      |  2 +-
 src/ArduinoOcpp/Model/ConnectorBase/Connector.h        |  6 +++---
 .../Model/ConnectorBase/ConnectorsCommon.cpp           |  6 +++---
 src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h |  4 ++--
 src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp   |  2 +-
 .../Model/FirmwareManagement/FirmwareService.cpp       |  2 +-
 src/ArduinoOcpp/Model/Model.cpp                        |  6 +++---
 src/ArduinoOcpp/Model/Model.h                          | 10 +++++-----
 .../Model/Reservation/ReservationService.cpp           |  2 +-
 src/ArduinoOcpp/Operations/ChangeAvailability.cpp      |  2 +-
 src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp  |  2 +-
 src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp   |  2 +-
 src/ArduinoOcpp/Operations/ReserveNow.cpp              |  2 +-
 src/ArduinoOcpp/Operations/StatusNotification.h        |  4 ++--
 src/ArduinoOcpp/Operations/TriggerMessage.cpp          |  2 +-
 src/ArduinoOcpp_c.h                                    |  2 +-
 20 files changed, 37 insertions(+), 37 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index a268d05b..51bab471 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -57,9 +57,9 @@ set(AO_SRC
     src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp
     src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
     src/ArduinoOcpp/Model/Boot/BootService.cpp
-    src/ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.cpp
-    src/ArduinoOcpp/Model/ChargeControl/Connector.cpp
-    src/ArduinoOcpp/Model/ChargeControl/Notification.cpp
+    src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+    src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp
+    src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp
     src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
     src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
     src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
diff --git a/src/ArduinoOcpp.cpp b/src/ArduinoOcpp.cpp
index aa5752ac..0861288e 100644
--- a/src/ArduinoOcpp.cpp
+++ b/src/ArduinoOcpp.cpp
@@ -8,7 +8,7 @@
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/Metering/MeteringService.h>
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h>
+#include <ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h>
 #include <ArduinoOcpp/Model/Heartbeat/HeartbeatService.h>
 #include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
@@ -153,8 +153,8 @@ void ocpp_initialize(Connection& connection, const char *bootNotificationCredent
         new TransactionStore(AO_NUMCONNECTORS, filesystem)));
     model.setBootService(std::unique_ptr<BootService>(
         new BootService(*context, filesystem)));
-    model.setChargeControlCommon(std::unique_ptr<ChargeControlCommon>(
-        new ChargeControlCommon(*context, AO_NUMCONNECTORS, filesystem)));
+    model.setConnectorsCommon(std::unique_ptr<ConnectorsCommon>(
+        new ConnectorsCommon(*context, AO_NUMCONNECTORS, filesystem)));
     std::vector<Connector> connectors;
     for (unsigned int connectorId = 0; connectorId < AO_NUMCONNECTORS; connectorId++) {
         connectors.push_back(Connector(*context, connectorId));
diff --git a/src/ArduinoOcpp.h b/src/ArduinoOcpp.h
index d8c30a83..de2cd4ec 100644
--- a/src/ArduinoOcpp.h
+++ b/src/ArduinoOcpp.h
@@ -16,8 +16,8 @@
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Model/Metering/SampledValue.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Model/ChargeControl/Notification.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Notification.h>
+#include <ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h>
 
 using ArduinoOcpp::OnReceiveConfListener;
 using ArduinoOcpp::OnReceiveReqListener;
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
index 0e96f232..8be9883d 100644
--- a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 #include <ArduinoOcpp/Core/FilesystemUtils.h>
 #include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp b/src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp
index 0c6a1201..959107df 100644
--- a/src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 
 #include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/Connector.h b/src/ArduinoOcpp/Model/ConnectorBase/Connector.h
index ce195d97..50603ef4 100644
--- a/src/ArduinoOcpp/Model/ConnectorBase/Connector.h
+++ b/src/ArduinoOcpp/Model/ConnectorBase/Connector.h
@@ -5,9 +5,9 @@
 #ifndef CONNECTOR_H
 #define CONNECTOR_H
 
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h>
-#include <ArduinoOcpp/Model/ChargeControl/Notification.h>
+#include <ArduinoOcpp/Model/ConnectorBase/ChargePointStatus.h>
+#include <ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Notification.h>
 #include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoOcpp/Core/PollResult.h>
 #include <ArduinoOcpp/Operations/CiStrings.h>
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index a60876dc..7fc0c16b 100644
--- a/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -4,7 +4,7 @@
 
 #include <string>
 
-#include <ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h>
+#include <ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h>
 #include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Operations/ChangeAvailability.h>
@@ -26,7 +26,7 @@
 
 using namespace ArduinoOcpp;
 
-ChargeControlCommon::ChargeControlCommon(Context& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
+ConnectorsCommon::ConnectorsCommon(Context& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context) {
     
     std::shared_ptr<Configuration<int>> numberOfConnectors =
@@ -91,6 +91,6 @@ ChargeControlCommon::ChargeControlCommon(Context& context, unsigned int numConn,
         return new Ocpp16::StopTransaction(context.getModel(), nullptr);});
 }
 
-void ChargeControlCommon::loop() {
+void ConnectorsCommon::loop() {
     //do nothing
 }
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h b/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h
index 8da8adb2..7851d04c 100644
--- a/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h
+++ b/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h
@@ -11,11 +11,11 @@ namespace ArduinoOcpp {
 
 class Context;
 
-class ChargeControlCommon {
+class ConnectorsCommon {
 private:
     Context& context;
 public:
-    ChargeControlCommon(Context& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
+    ConnectorsCommon(Context& context, unsigned int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
     void loop();
 };
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp b/src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp
index ed1dd976..6684441e 100644
--- a/src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp
+++ b/src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp
@@ -2,7 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/ChargeControl/Notification.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Notification.h>
 
 namespace ArduinoOcpp {
 
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 602b74f7..75062da7 100644
--- a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Core/Configuration.h>
 #include <ArduinoOcpp/Core/OperationRegistry.h>
diff --git a/src/ArduinoOcpp/Model/Model.cpp b/src/ArduinoOcpp/Model/Model.cpp
index 830cc855..51fd9035 100644
--- a/src/ArduinoOcpp/Model/Model.cpp
+++ b/src/ArduinoOcpp/Model/Model.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargeControlCommon.h>
+#include <ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h>
 #include <ArduinoOcpp/Model/Metering/MeteringService.h>
 #include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
 #include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
@@ -80,11 +80,11 @@ SmartChargingService* Model::getSmartChargingService() const {
     return smartChargingService.get();
 }
 
-void Model::setChargeControlCommon(std::unique_ptr<ChargeControlCommon> ccs) {
+void Model::setConnectorsCommon(std::unique_ptr<ConnectorsCommon> ccs) {
     chargeControlCommon = std::move(ccs);
 }
 
-ChargeControlCommon *Model::getChargeControlCommon() {
+ConnectorsCommon *Model::getConnectorsCommon() {
     return chargeControlCommon.get();
 }
 
diff --git a/src/ArduinoOcpp/Model/Model.h b/src/ArduinoOcpp/Model/Model.h
index 1c190426..736380fa 100644
--- a/src/ArduinoOcpp/Model/Model.h
+++ b/src/ArduinoOcpp/Model/Model.h
@@ -8,13 +8,13 @@
 #include <memory>
 
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 
 namespace ArduinoOcpp {
 
 class TransactionStore;
 class SmartChargingService;
-class ChargeControlCommon;
+class ConnectorsCommon;
 class MeteringService;
 class FirmwareService;
 class DiagnosticsService;
@@ -29,7 +29,7 @@ class Model {
     std::vector<Connector> connectors;
     std::unique_ptr<TransactionStore> transactionStore;
     std::unique_ptr<SmartChargingService> smartChargingService;
-    std::unique_ptr<ChargeControlCommon> chargeControlCommon;
+    std::unique_ptr<ConnectorsCommon> chargeControlCommon;
     std::unique_ptr<MeteringService> meteringService;
     std::unique_ptr<FirmwareService> firmwareService;
     std::unique_ptr<DiagnosticsService> diagnosticsService;
@@ -59,8 +59,8 @@ class Model {
     void setSmartChargingService(std::unique_ptr<SmartChargingService> scs);
     SmartChargingService* getSmartChargingService() const;
 
-    void setChargeControlCommon(std::unique_ptr<ChargeControlCommon> ccs);
-    ChargeControlCommon *getChargeControlCommon();
+    void setConnectorsCommon(std::unique_ptr<ConnectorsCommon> ccs);
+    ConnectorsCommon *getConnectorsCommon();
 
     void setConnectors(std::vector<Connector>&& connectors);
     unsigned int getNumConnectors() const;
diff --git a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
index d7eb9ec2..c9b9edec 100644
--- a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Model/Reservation/ReservationService.h>
 #include <ArduinoOcpp/Core/Context.h>
 #include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Operations/CancelReservation.h>
 #include <ArduinoOcpp/Operations/ReserveNow.h>
diff --git a/src/ArduinoOcpp/Operations/ChangeAvailability.cpp b/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
index 0e7a785a..1e1732b1 100644
--- a/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
+++ b/src/ArduinoOcpp/Operations/ChangeAvailability.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/Operations/ChangeAvailability.h>
 #include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 
 #include <functional>
 
diff --git a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
index de41c5a5..67eb0f2a 100644
--- a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
@@ -5,7 +5,7 @@
 
 #include <ArduinoOcpp/Operations/RemoteStartTransaction.h>
 #include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 #include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 #include <ArduinoOcpp/Debug.h>
diff --git a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
index f940dc3b..5e9e3d4b 100644
--- a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
+++ b/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
@@ -4,7 +4,7 @@
 
 #include <ArduinoOcpp/Operations/RemoteStopTransaction.h>
 #include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 
 using ArduinoOcpp::Ocpp16::RemoteStopTransaction;
diff --git a/src/ArduinoOcpp/Operations/ReserveNow.cpp b/src/ArduinoOcpp/Operations/ReserveNow.cpp
index 60d9e70d..3f1cb6ae 100644
--- a/src/ArduinoOcpp/Operations/ReserveNow.cpp
+++ b/src/ArduinoOcpp/Operations/ReserveNow.cpp
@@ -5,7 +5,7 @@
 #include <ArduinoOcpp/Operations/ReserveNow.h>
 #include <ArduinoOcpp/Model/Model.h>
 #include <ArduinoOcpp/Model/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 #include <ArduinoOcpp/Platform.h>
 
 using ArduinoOcpp::Ocpp16::ReserveNow;
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.h b/src/ArduinoOcpp/Operations/StatusNotification.h
index a55df9ba..872d0935 100644
--- a/src/ArduinoOcpp/Operations/StatusNotification.h
+++ b/src/ArduinoOcpp/Operations/StatusNotification.h
@@ -7,8 +7,8 @@
 
 #include <ArduinoOcpp/Core/Operation.h>
 #include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointStatus.h>
-#include <ArduinoOcpp/Model/ChargeControl/ChargePointErrorData.h>
+#include <ArduinoOcpp/Model/ConnectorBase/ChargePointStatus.h>
+#include <ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h>
 
 namespace ArduinoOcpp {
 namespace Ocpp16 {
diff --git a/src/ArduinoOcpp/Operations/TriggerMessage.cpp b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
index 849a9e4e..84ad0bcf 100644
--- a/src/ArduinoOcpp/Operations/TriggerMessage.cpp
+++ b/src/ArduinoOcpp/Operations/TriggerMessage.cpp
@@ -3,7 +3,7 @@
 // MIT License
 
 #include <ArduinoOcpp/Operations/TriggerMessage.h>
-#include <ArduinoOcpp/Model/ChargeControl/Connector.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
 #include <ArduinoOcpp/Model/Metering/MeteringService.h>
 #include <ArduinoOcpp/Operations/StatusNotification.h>
 #include <ArduinoOcpp/Model/Model.h>
diff --git a/src/ArduinoOcpp_c.h b/src/ArduinoOcpp_c.h
index 227a25bf..1672d7e3 100644
--- a/src/ArduinoOcpp_c.h
+++ b/src/ArduinoOcpp_c.h
@@ -8,7 +8,7 @@
 #include <stddef.h>
 
 #include <ArduinoOcpp/Core/ConfigurationOptions.h>
-#include <ArduinoOcpp/Model/ChargeControl/Notification.h>
+#include <ArduinoOcpp/Model/ConnectorBase/Notification.h>
 #include <ArduinoOcpp/Model/Transactions/Transaction.h>
 
 struct AO_Connection;

From cab4fc160b6867b2c38c9ec726211bda0e77b002 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 20 Aug 2023 18:44:28 +0200
Subject: [PATCH 347/549] change naming for release I

---
 src/{ArduinoOcpp.cpp => MicroOcpp.cpp}                            | 0
 src/{ArduinoOcpp.h => MicroOcpp.h}                                | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Configuration.cpp             | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Configuration.h               | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationContainer.cpp    | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationContainer.h      | 0
 .../Core/ConfigurationContainerFlash.cpp                          | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationContainerFlash.h | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationKeyValue.cpp     | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationKeyValue.h       | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationOptions.h        | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Connection.cpp                | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Connection.h                  | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Context.cpp                   | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Context.h                     | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/FilesystemAdapter.cpp         | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/FilesystemAdapter.h           | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/FilesystemUtils.cpp           | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/FilesystemUtils.h             | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/OcppError.h                   | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Operation.cpp                 | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Operation.h                   | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/OperationRegistry.cpp         | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/OperationRegistry.h           | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/PollResult.h                  | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Request.cpp                   | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Request.h                     | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/RequestCallbacks.h            | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/RequestQueue.cpp              | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/RequestQueue.h                | 0
 .../Core/RequestQueueStorageStrategy.cpp                          | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/RequestQueueStorageStrategy.h | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/RequestStore.cpp              | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/RequestStore.h                | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/SimpleRequestFactory.cpp      | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/SimpleRequestFactory.h        | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Time.cpp                      | 0
 src/{ArduinoOcpp => MicroOcpp}/Core/Time.h                        | 0
 src/{ArduinoOcpp => MicroOcpp}/Debug.h                            | 0
 .../Model/Authorization/AuthorizationData.cpp                     | 0
 .../Model/Authorization/AuthorizationData.h                       | 0
 .../Model/Authorization/AuthorizationList.cpp                     | 0
 .../Model/Authorization/AuthorizationList.h                       | 0
 .../Model/Authorization/AuthorizationService.cpp                  | 0
 .../Model/Authorization/AuthorizationService.h                    | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Boot/BootService.cpp         | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Boot/BootService.h           | 0
 .../Model/ConnectorBase/ChargePointErrorData.h                    | 0
 .../Model/ConnectorBase/ChargePointStatus.h                       | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/Connector.cpp  | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/Connector.h    | 0
 .../Model/ConnectorBase/ConnectorsCommon.cpp                      | 0
 .../Model/ConnectorBase/ConnectorsCommon.h                        | 0
 .../Model/ConnectorBase/Notification.cpp                          | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/Notification.h | 0
 .../Model/Diagnostics/DiagnosticsService.cpp                      | 0
 .../Model/Diagnostics/DiagnosticsService.h                        | 0
 .../Model/Diagnostics/DiagnosticsStatus.h                         | 0
 .../Model/FirmwareManagement/FirmwareService.cpp                  | 0
 .../Model/FirmwareManagement/FirmwareService.h                    | 0
 .../Model/FirmwareManagement/FirmwareStatus.h                     | 0
 .../Model/Heartbeat/HeartbeatService.cpp                          | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Heartbeat/HeartbeatService.h | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeterStore.cpp      | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeterStore.h        | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeterValue.cpp      | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeterValue.h        | 0
 .../Model/Metering/MeteringConnector.cpp                          | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeteringConnector.h | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeteringService.cpp | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeteringService.h   | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Metering/SampledValue.cpp    | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Metering/SampledValue.h      | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Model.cpp                    | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Model.h                      | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Reservation/Reservation.cpp  | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Reservation/Reservation.h    | 0
 .../Model/Reservation/ReservationService.cpp                      | 0
 .../Model/Reservation/ReservationService.h                        | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Reset/ResetService.cpp       | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Reset/ResetService.h         | 0
 .../Model/SmartCharging/SmartChargingModel.cpp                    | 0
 .../Model/SmartCharging/SmartChargingModel.h                      | 0
 .../Model/SmartCharging/SmartChargingService.cpp                  | 0
 .../Model/SmartCharging/SmartChargingService.h                    | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Transactions/Transaction.cpp | 0
 src/{ArduinoOcpp => MicroOcpp}/Model/Transactions/Transaction.h   | 0
 .../Model/Transactions/TransactionDeserialize.cpp                 | 0
 .../Model/Transactions/TransactionDeserialize.h                   | 0
 .../Model/Transactions/TransactionStore.cpp                       | 0
 .../Model/Transactions/TransactionStore.h                         | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/Authorize.cpp           | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/Authorize.h             | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/BootNotification.cpp    | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/BootNotification.h      | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/CancelReservation.cpp   | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/CancelReservation.h     | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/ChangeAvailability.cpp  | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/ChangeAvailability.h    | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/ChangeConfiguration.cpp | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/ChangeConfiguration.h   | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/CiStrings.h             | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/ClearCache.cpp          | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/ClearCache.h            | 0
 .../Operations/ClearChargingProfile.cpp                           | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/ClearChargingProfile.h  | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/CustomOperation.cpp     | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/CustomOperation.h       | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/DataTransfer.cpp        | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/DataTransfer.h          | 0
 .../Operations/DiagnosticsStatusNotification.cpp                  | 0
 .../Operations/DiagnosticsStatusNotification.h                    | 0
 .../Operations/FirmwareStatusNotification.cpp                     | 0
 .../Operations/FirmwareStatusNotification.h                       | 0
 .../Operations/GetCompositeSchedule.cpp                           | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/GetCompositeSchedule.h  | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/GetConfiguration.cpp    | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/GetConfiguration.h      | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/GetDiagnostics.cpp      | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/GetDiagnostics.h        | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/GetLocalListVersion.cpp | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/GetLocalListVersion.h   | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/Heartbeat.cpp           | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/Heartbeat.h             | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/MeterValues.cpp         | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/MeterValues.h           | 0
 .../Operations/RemoteStartTransaction.cpp                         | 0
 .../Operations/RemoteStartTransaction.h                           | 0
 .../Operations/RemoteStopTransaction.cpp                          | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/RemoteStopTransaction.h | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/ReserveNow.cpp          | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/ReserveNow.h            | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/Reset.cpp               | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/Reset.h                 | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/SendLocalList.cpp       | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/SendLocalList.h         | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/SetChargingProfile.cpp  | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/SetChargingProfile.h    | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/StartTransaction.cpp    | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/StartTransaction.h      | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/StatusNotification.cpp  | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/StatusNotification.h    | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/StopTransaction.cpp     | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/StopTransaction.h       | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/TriggerMessage.cpp      | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/TriggerMessage.h        | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/UnlockConnector.cpp     | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/UnlockConnector.h       | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/UpdateFirmware.cpp      | 0
 src/{ArduinoOcpp => MicroOcpp}/Operations/UpdateFirmware.h        | 0
 src/{ArduinoOcpp => MicroOcpp}/Platform.cpp                       | 0
 src/{ArduinoOcpp => MicroOcpp}/Platform.h                         | 0
 src/{ArduinoOcpp_c.cpp => MicroOcpp_c.cpp}                        | 0
 src/{ArduinoOcpp_c.h => MicroOcpp_c.h}                            | 0
 154 files changed, 0 insertions(+), 0 deletions(-)
 rename src/{ArduinoOcpp.cpp => MicroOcpp.cpp} (100%)
 rename src/{ArduinoOcpp.h => MicroOcpp.h} (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Configuration.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Configuration.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationContainer.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationContainer.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationContainerFlash.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationContainerFlash.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationKeyValue.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationKeyValue.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/ConfigurationOptions.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Connection.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Connection.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Context.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Context.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/FilesystemAdapter.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/FilesystemAdapter.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/FilesystemUtils.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/FilesystemUtils.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/OcppError.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Operation.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Operation.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/OperationRegistry.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/OperationRegistry.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/PollResult.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Request.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Request.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/RequestCallbacks.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/RequestQueue.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/RequestQueue.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/RequestQueueStorageStrategy.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/RequestQueueStorageStrategy.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/RequestStore.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/RequestStore.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/SimpleRequestFactory.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/SimpleRequestFactory.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Time.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Core/Time.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Debug.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Authorization/AuthorizationData.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Authorization/AuthorizationData.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Authorization/AuthorizationList.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Authorization/AuthorizationList.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Authorization/AuthorizationService.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Authorization/AuthorizationService.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Boot/BootService.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Boot/BootService.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/ChargePointErrorData.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/ChargePointStatus.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/Connector.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/Connector.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/ConnectorsCommon.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/ConnectorsCommon.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/Notification.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/ConnectorBase/Notification.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Diagnostics/DiagnosticsService.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Diagnostics/DiagnosticsService.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Diagnostics/DiagnosticsStatus.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/FirmwareManagement/FirmwareService.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/FirmwareManagement/FirmwareService.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/FirmwareManagement/FirmwareStatus.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Heartbeat/HeartbeatService.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Heartbeat/HeartbeatService.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeterStore.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeterStore.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeterValue.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeterValue.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeteringConnector.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeteringConnector.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeteringService.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/MeteringService.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/SampledValue.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Metering/SampledValue.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Model.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Model.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Reservation/Reservation.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Reservation/Reservation.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Reservation/ReservationService.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Reservation/ReservationService.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Reset/ResetService.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Reset/ResetService.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/SmartCharging/SmartChargingModel.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/SmartCharging/SmartChargingModel.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/SmartCharging/SmartChargingService.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/SmartCharging/SmartChargingService.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Transactions/Transaction.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Transactions/Transaction.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Transactions/TransactionDeserialize.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Transactions/TransactionDeserialize.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Transactions/TransactionStore.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Model/Transactions/TransactionStore.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/Authorize.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/Authorize.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/BootNotification.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/BootNotification.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/CancelReservation.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/CancelReservation.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ChangeAvailability.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ChangeAvailability.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ChangeConfiguration.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ChangeConfiguration.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/CiStrings.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ClearCache.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ClearCache.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ClearChargingProfile.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ClearChargingProfile.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/CustomOperation.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/CustomOperation.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/DataTransfer.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/DataTransfer.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/DiagnosticsStatusNotification.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/DiagnosticsStatusNotification.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/FirmwareStatusNotification.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/FirmwareStatusNotification.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/GetCompositeSchedule.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/GetCompositeSchedule.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/GetConfiguration.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/GetConfiguration.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/GetDiagnostics.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/GetDiagnostics.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/GetLocalListVersion.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/GetLocalListVersion.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/Heartbeat.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/Heartbeat.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/MeterValues.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/MeterValues.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/RemoteStartTransaction.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/RemoteStartTransaction.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/RemoteStopTransaction.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/RemoteStopTransaction.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ReserveNow.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/ReserveNow.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/Reset.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/Reset.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/SendLocalList.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/SendLocalList.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/SetChargingProfile.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/SetChargingProfile.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/StartTransaction.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/StartTransaction.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/StatusNotification.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/StatusNotification.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/StopTransaction.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/StopTransaction.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/TriggerMessage.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/TriggerMessage.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/UnlockConnector.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/UnlockConnector.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/UpdateFirmware.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Operations/UpdateFirmware.h (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Platform.cpp (100%)
 rename src/{ArduinoOcpp => MicroOcpp}/Platform.h (100%)
 rename src/{ArduinoOcpp_c.cpp => MicroOcpp_c.cpp} (100%)
 rename src/{ArduinoOcpp_c.h => MicroOcpp_c.h} (100%)

diff --git a/src/ArduinoOcpp.cpp b/src/MicroOcpp.cpp
similarity index 100%
rename from src/ArduinoOcpp.cpp
rename to src/MicroOcpp.cpp
diff --git a/src/ArduinoOcpp.h b/src/MicroOcpp.h
similarity index 100%
rename from src/ArduinoOcpp.h
rename to src/MicroOcpp.h
diff --git a/src/ArduinoOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/Configuration.cpp
rename to src/MicroOcpp/Core/Configuration.cpp
diff --git a/src/ArduinoOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
similarity index 100%
rename from src/ArduinoOcpp/Core/Configuration.h
rename to src/MicroOcpp/Core/Configuration.h
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/ConfigurationContainer.cpp
rename to src/MicroOcpp/Core/ConfigurationContainer.cpp
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
similarity index 100%
rename from src/ArduinoOcpp/Core/ConfigurationContainer.h
rename to src/MicroOcpp/Core/ConfigurationContainer.h
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
rename to src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
diff --git a/src/ArduinoOcpp/Core/ConfigurationContainerFlash.h b/src/MicroOcpp/Core/ConfigurationContainerFlash.h
similarity index 100%
rename from src/ArduinoOcpp/Core/ConfigurationContainerFlash.h
rename to src/MicroOcpp/Core/ConfigurationContainerFlash.h
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
rename to src/MicroOcpp/Core/ConfigurationKeyValue.cpp
diff --git a/src/ArduinoOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
similarity index 100%
rename from src/ArduinoOcpp/Core/ConfigurationKeyValue.h
rename to src/MicroOcpp/Core/ConfigurationKeyValue.h
diff --git a/src/ArduinoOcpp/Core/ConfigurationOptions.h b/src/MicroOcpp/Core/ConfigurationOptions.h
similarity index 100%
rename from src/ArduinoOcpp/Core/ConfigurationOptions.h
rename to src/MicroOcpp/Core/ConfigurationOptions.h
diff --git a/src/ArduinoOcpp/Core/Connection.cpp b/src/MicroOcpp/Core/Connection.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/Connection.cpp
rename to src/MicroOcpp/Core/Connection.cpp
diff --git a/src/ArduinoOcpp/Core/Connection.h b/src/MicroOcpp/Core/Connection.h
similarity index 100%
rename from src/ArduinoOcpp/Core/Connection.h
rename to src/MicroOcpp/Core/Connection.h
diff --git a/src/ArduinoOcpp/Core/Context.cpp b/src/MicroOcpp/Core/Context.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/Context.cpp
rename to src/MicroOcpp/Core/Context.cpp
diff --git a/src/ArduinoOcpp/Core/Context.h b/src/MicroOcpp/Core/Context.h
similarity index 100%
rename from src/ArduinoOcpp/Core/Context.h
rename to src/MicroOcpp/Core/Context.h
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/FilesystemAdapter.cpp
rename to src/MicroOcpp/Core/FilesystemAdapter.cpp
diff --git a/src/ArduinoOcpp/Core/FilesystemAdapter.h b/src/MicroOcpp/Core/FilesystemAdapter.h
similarity index 100%
rename from src/ArduinoOcpp/Core/FilesystemAdapter.h
rename to src/MicroOcpp/Core/FilesystemAdapter.h
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.cpp b/src/MicroOcpp/Core/FilesystemUtils.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/FilesystemUtils.cpp
rename to src/MicroOcpp/Core/FilesystemUtils.cpp
diff --git a/src/ArduinoOcpp/Core/FilesystemUtils.h b/src/MicroOcpp/Core/FilesystemUtils.h
similarity index 100%
rename from src/ArduinoOcpp/Core/FilesystemUtils.h
rename to src/MicroOcpp/Core/FilesystemUtils.h
diff --git a/src/ArduinoOcpp/Core/OcppError.h b/src/MicroOcpp/Core/OcppError.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OcppError.h
rename to src/MicroOcpp/Core/OcppError.h
diff --git a/src/ArduinoOcpp/Core/Operation.cpp b/src/MicroOcpp/Core/Operation.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/Operation.cpp
rename to src/MicroOcpp/Core/Operation.cpp
diff --git a/src/ArduinoOcpp/Core/Operation.h b/src/MicroOcpp/Core/Operation.h
similarity index 100%
rename from src/ArduinoOcpp/Core/Operation.h
rename to src/MicroOcpp/Core/Operation.h
diff --git a/src/ArduinoOcpp/Core/OperationRegistry.cpp b/src/MicroOcpp/Core/OperationRegistry.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/OperationRegistry.cpp
rename to src/MicroOcpp/Core/OperationRegistry.cpp
diff --git a/src/ArduinoOcpp/Core/OperationRegistry.h b/src/MicroOcpp/Core/OperationRegistry.h
similarity index 100%
rename from src/ArduinoOcpp/Core/OperationRegistry.h
rename to src/MicroOcpp/Core/OperationRegistry.h
diff --git a/src/ArduinoOcpp/Core/PollResult.h b/src/MicroOcpp/Core/PollResult.h
similarity index 100%
rename from src/ArduinoOcpp/Core/PollResult.h
rename to src/MicroOcpp/Core/PollResult.h
diff --git a/src/ArduinoOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/Request.cpp
rename to src/MicroOcpp/Core/Request.cpp
diff --git a/src/ArduinoOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
similarity index 100%
rename from src/ArduinoOcpp/Core/Request.h
rename to src/MicroOcpp/Core/Request.h
diff --git a/src/ArduinoOcpp/Core/RequestCallbacks.h b/src/MicroOcpp/Core/RequestCallbacks.h
similarity index 100%
rename from src/ArduinoOcpp/Core/RequestCallbacks.h
rename to src/MicroOcpp/Core/RequestCallbacks.h
diff --git a/src/ArduinoOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/RequestQueue.cpp
rename to src/MicroOcpp/Core/RequestQueue.cpp
diff --git a/src/ArduinoOcpp/Core/RequestQueue.h b/src/MicroOcpp/Core/RequestQueue.h
similarity index 100%
rename from src/ArduinoOcpp/Core/RequestQueue.h
rename to src/MicroOcpp/Core/RequestQueue.h
diff --git a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
rename to src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
diff --git a/src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h b/src/MicroOcpp/Core/RequestQueueStorageStrategy.h
similarity index 100%
rename from src/ArduinoOcpp/Core/RequestQueueStorageStrategy.h
rename to src/MicroOcpp/Core/RequestQueueStorageStrategy.h
diff --git a/src/ArduinoOcpp/Core/RequestStore.cpp b/src/MicroOcpp/Core/RequestStore.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/RequestStore.cpp
rename to src/MicroOcpp/Core/RequestStore.cpp
diff --git a/src/ArduinoOcpp/Core/RequestStore.h b/src/MicroOcpp/Core/RequestStore.h
similarity index 100%
rename from src/ArduinoOcpp/Core/RequestStore.h
rename to src/MicroOcpp/Core/RequestStore.h
diff --git a/src/ArduinoOcpp/Core/SimpleRequestFactory.cpp b/src/MicroOcpp/Core/SimpleRequestFactory.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
rename to src/MicroOcpp/Core/SimpleRequestFactory.cpp
diff --git a/src/ArduinoOcpp/Core/SimpleRequestFactory.h b/src/MicroOcpp/Core/SimpleRequestFactory.h
similarity index 100%
rename from src/ArduinoOcpp/Core/SimpleRequestFactory.h
rename to src/MicroOcpp/Core/SimpleRequestFactory.h
diff --git a/src/ArduinoOcpp/Core/Time.cpp b/src/MicroOcpp/Core/Time.cpp
similarity index 100%
rename from src/ArduinoOcpp/Core/Time.cpp
rename to src/MicroOcpp/Core/Time.cpp
diff --git a/src/ArduinoOcpp/Core/Time.h b/src/MicroOcpp/Core/Time.h
similarity index 100%
rename from src/ArduinoOcpp/Core/Time.h
rename to src/MicroOcpp/Core/Time.h
diff --git a/src/ArduinoOcpp/Debug.h b/src/MicroOcpp/Debug.h
similarity index 100%
rename from src/ArduinoOcpp/Debug.h
rename to src/MicroOcpp/Debug.h
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp
rename to src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationData.h b/src/MicroOcpp/Model/Authorization/AuthorizationData.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Authorization/AuthorizationData.h
rename to src/MicroOcpp/Model/Authorization/AuthorizationData.h
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp
rename to src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationList.h b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Authorization/AuthorizationList.h
rename to src/MicroOcpp/Model/Authorization/AuthorizationList.h
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
rename to src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
diff --git a/src/ArduinoOcpp/Model/Authorization/AuthorizationService.h b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Authorization/AuthorizationService.h
rename to src/MicroOcpp/Model/Authorization/AuthorizationService.h
diff --git a/src/ArduinoOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Boot/BootService.cpp
rename to src/MicroOcpp/Model/Boot/BootService.cpp
diff --git a/src/ArduinoOcpp/Model/Boot/BootService.h b/src/MicroOcpp/Model/Boot/BootService.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Boot/BootService.h
rename to src/MicroOcpp/Model/Boot/BootService.h
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h b/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h
rename to src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/ChargePointStatus.h b/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ConnectorBase/ChargePointStatus.h
rename to src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp
rename to src/MicroOcpp/Model/ConnectorBase/Connector.cpp
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ConnectorBase/Connector.h
rename to src/MicroOcpp/Model/ConnectorBase/Connector.h
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
rename to src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h
rename to src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp b/src/MicroOcpp/Model/ConnectorBase/Notification.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp
rename to src/MicroOcpp/Model/ConnectorBase/Notification.cpp
diff --git a/src/ArduinoOcpp/Model/ConnectorBase/Notification.h b/src/MicroOcpp/Model/ConnectorBase/Notification.h
similarity index 100%
rename from src/ArduinoOcpp/Model/ConnectorBase/Notification.h
rename to src/MicroOcpp/Model/ConnectorBase/Notification.h
diff --git a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
rename to src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
diff --git a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
rename to src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
diff --git a/src/ArduinoOcpp/Model/Diagnostics/DiagnosticsStatus.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Diagnostics/DiagnosticsStatus.h
rename to src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
rename to src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
similarity index 100%
rename from src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h
rename to src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
diff --git a/src/ArduinoOcpp/Model/FirmwareManagement/FirmwareStatus.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h
similarity index 100%
rename from src/ArduinoOcpp/Model/FirmwareManagement/FirmwareStatus.h
rename to src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h
diff --git a/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
rename to src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
diff --git a/src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.h b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.h
rename to src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
diff --git a/src/ArduinoOcpp/Model/Metering/MeterStore.cpp b/src/MicroOcpp/Model/Metering/MeterStore.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/MeterStore.cpp
rename to src/MicroOcpp/Model/Metering/MeterStore.cpp
diff --git a/src/ArduinoOcpp/Model/Metering/MeterStore.h b/src/MicroOcpp/Model/Metering/MeterStore.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/MeterStore.h
rename to src/MicroOcpp/Model/Metering/MeterStore.h
diff --git a/src/ArduinoOcpp/Model/Metering/MeterValue.cpp b/src/MicroOcpp/Model/Metering/MeterValue.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/MeterValue.cpp
rename to src/MicroOcpp/Model/Metering/MeterValue.cpp
diff --git a/src/ArduinoOcpp/Model/Metering/MeterValue.h b/src/MicroOcpp/Model/Metering/MeterValue.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/MeterValue.h
rename to src/MicroOcpp/Model/Metering/MeterValue.h
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
rename to src/MicroOcpp/Model/Metering/MeteringConnector.cpp
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringConnector.h b/src/MicroOcpp/Model/Metering/MeteringConnector.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/MeteringConnector.h
rename to src/MicroOcpp/Model/Metering/MeteringConnector.h
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/MeteringService.cpp
rename to src/MicroOcpp/Model/Metering/MeteringService.cpp
diff --git a/src/ArduinoOcpp/Model/Metering/MeteringService.h b/src/MicroOcpp/Model/Metering/MeteringService.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/MeteringService.h
rename to src/MicroOcpp/Model/Metering/MeteringService.h
diff --git a/src/ArduinoOcpp/Model/Metering/SampledValue.cpp b/src/MicroOcpp/Model/Metering/SampledValue.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/SampledValue.cpp
rename to src/MicroOcpp/Model/Metering/SampledValue.cpp
diff --git a/src/ArduinoOcpp/Model/Metering/SampledValue.h b/src/MicroOcpp/Model/Metering/SampledValue.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Metering/SampledValue.h
rename to src/MicroOcpp/Model/Metering/SampledValue.h
diff --git a/src/ArduinoOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Model.cpp
rename to src/MicroOcpp/Model/Model.cpp
diff --git a/src/ArduinoOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Model.h
rename to src/MicroOcpp/Model/Model.h
diff --git a/src/ArduinoOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Reservation/Reservation.cpp
rename to src/MicroOcpp/Model/Reservation/Reservation.cpp
diff --git a/src/ArduinoOcpp/Model/Reservation/Reservation.h b/src/MicroOcpp/Model/Reservation/Reservation.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Reservation/Reservation.h
rename to src/MicroOcpp/Model/Reservation/Reservation.h
diff --git a/src/ArduinoOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
rename to src/MicroOcpp/Model/Reservation/ReservationService.cpp
diff --git a/src/ArduinoOcpp/Model/Reservation/ReservationService.h b/src/MicroOcpp/Model/Reservation/ReservationService.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Reservation/ReservationService.h
rename to src/MicroOcpp/Model/Reservation/ReservationService.h
diff --git a/src/ArduinoOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Reset/ResetService.cpp
rename to src/MicroOcpp/Model/Reset/ResetService.cpp
diff --git a/src/ArduinoOcpp/Model/Reset/ResetService.h b/src/MicroOcpp/Model/Reset/ResetService.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Reset/ResetService.h
rename to src/MicroOcpp/Model/Reset/ResetService.h
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
rename to src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
similarity index 100%
rename from src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h
rename to src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
rename to src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
diff --git a/src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
similarity index 100%
rename from src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.h
rename to src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.cpp b/src/MicroOcpp/Model/Transactions/Transaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Transactions/Transaction.cpp
rename to src/MicroOcpp/Model/Transactions/Transaction.cpp
diff --git a/src/ArduinoOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Transactions/Transaction.h
rename to src/MicroOcpp/Model/Transactions/Transaction.h
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
rename to src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.h
rename to src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
similarity index 100%
rename from src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
rename to src/MicroOcpp/Model/Transactions/TransactionStore.cpp
diff --git a/src/ArduinoOcpp/Model/Transactions/TransactionStore.h b/src/MicroOcpp/Model/Transactions/TransactionStore.h
similarity index 100%
rename from src/ArduinoOcpp/Model/Transactions/TransactionStore.h
rename to src/MicroOcpp/Model/Transactions/TransactionStore.h
diff --git a/src/ArduinoOcpp/Operations/Authorize.cpp b/src/MicroOcpp/Operations/Authorize.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/Authorize.cpp
rename to src/MicroOcpp/Operations/Authorize.cpp
diff --git a/src/ArduinoOcpp/Operations/Authorize.h b/src/MicroOcpp/Operations/Authorize.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/Authorize.h
rename to src/MicroOcpp/Operations/Authorize.h
diff --git a/src/ArduinoOcpp/Operations/BootNotification.cpp b/src/MicroOcpp/Operations/BootNotification.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/BootNotification.cpp
rename to src/MicroOcpp/Operations/BootNotification.cpp
diff --git a/src/ArduinoOcpp/Operations/BootNotification.h b/src/MicroOcpp/Operations/BootNotification.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/BootNotification.h
rename to src/MicroOcpp/Operations/BootNotification.h
diff --git a/src/ArduinoOcpp/Operations/CancelReservation.cpp b/src/MicroOcpp/Operations/CancelReservation.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/CancelReservation.cpp
rename to src/MicroOcpp/Operations/CancelReservation.cpp
diff --git a/src/ArduinoOcpp/Operations/CancelReservation.h b/src/MicroOcpp/Operations/CancelReservation.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/CancelReservation.h
rename to src/MicroOcpp/Operations/CancelReservation.h
diff --git a/src/ArduinoOcpp/Operations/ChangeAvailability.cpp b/src/MicroOcpp/Operations/ChangeAvailability.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/ChangeAvailability.cpp
rename to src/MicroOcpp/Operations/ChangeAvailability.cpp
diff --git a/src/ArduinoOcpp/Operations/ChangeAvailability.h b/src/MicroOcpp/Operations/ChangeAvailability.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/ChangeAvailability.h
rename to src/MicroOcpp/Operations/ChangeAvailability.h
diff --git a/src/ArduinoOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/ChangeConfiguration.cpp
rename to src/MicroOcpp/Operations/ChangeConfiguration.cpp
diff --git a/src/ArduinoOcpp/Operations/ChangeConfiguration.h b/src/MicroOcpp/Operations/ChangeConfiguration.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/ChangeConfiguration.h
rename to src/MicroOcpp/Operations/ChangeConfiguration.h
diff --git a/src/ArduinoOcpp/Operations/CiStrings.h b/src/MicroOcpp/Operations/CiStrings.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/CiStrings.h
rename to src/MicroOcpp/Operations/CiStrings.h
diff --git a/src/ArduinoOcpp/Operations/ClearCache.cpp b/src/MicroOcpp/Operations/ClearCache.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/ClearCache.cpp
rename to src/MicroOcpp/Operations/ClearCache.cpp
diff --git a/src/ArduinoOcpp/Operations/ClearCache.h b/src/MicroOcpp/Operations/ClearCache.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/ClearCache.h
rename to src/MicroOcpp/Operations/ClearCache.h
diff --git a/src/ArduinoOcpp/Operations/ClearChargingProfile.cpp b/src/MicroOcpp/Operations/ClearChargingProfile.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
rename to src/MicroOcpp/Operations/ClearChargingProfile.cpp
diff --git a/src/ArduinoOcpp/Operations/ClearChargingProfile.h b/src/MicroOcpp/Operations/ClearChargingProfile.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/ClearChargingProfile.h
rename to src/MicroOcpp/Operations/ClearChargingProfile.h
diff --git a/src/ArduinoOcpp/Operations/CustomOperation.cpp b/src/MicroOcpp/Operations/CustomOperation.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/CustomOperation.cpp
rename to src/MicroOcpp/Operations/CustomOperation.cpp
diff --git a/src/ArduinoOcpp/Operations/CustomOperation.h b/src/MicroOcpp/Operations/CustomOperation.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/CustomOperation.h
rename to src/MicroOcpp/Operations/CustomOperation.h
diff --git a/src/ArduinoOcpp/Operations/DataTransfer.cpp b/src/MicroOcpp/Operations/DataTransfer.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/DataTransfer.cpp
rename to src/MicroOcpp/Operations/DataTransfer.cpp
diff --git a/src/ArduinoOcpp/Operations/DataTransfer.h b/src/MicroOcpp/Operations/DataTransfer.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/DataTransfer.h
rename to src/MicroOcpp/Operations/DataTransfer.h
diff --git a/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
rename to src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
diff --git a/src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.h b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.h
rename to src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
diff --git a/src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp b/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
rename to src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
diff --git a/src/ArduinoOcpp/Operations/FirmwareStatusNotification.h b/src/MicroOcpp/Operations/FirmwareStatusNotification.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/FirmwareStatusNotification.h
rename to src/MicroOcpp/Operations/FirmwareStatusNotification.h
diff --git a/src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp b/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
rename to src/MicroOcpp/Operations/GetCompositeSchedule.cpp
diff --git a/src/ArduinoOcpp/Operations/GetCompositeSchedule.h b/src/MicroOcpp/Operations/GetCompositeSchedule.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/GetCompositeSchedule.h
rename to src/MicroOcpp/Operations/GetCompositeSchedule.h
diff --git a/src/ArduinoOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/GetConfiguration.cpp
rename to src/MicroOcpp/Operations/GetConfiguration.cpp
diff --git a/src/ArduinoOcpp/Operations/GetConfiguration.h b/src/MicroOcpp/Operations/GetConfiguration.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/GetConfiguration.h
rename to src/MicroOcpp/Operations/GetConfiguration.h
diff --git a/src/ArduinoOcpp/Operations/GetDiagnostics.cpp b/src/MicroOcpp/Operations/GetDiagnostics.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/GetDiagnostics.cpp
rename to src/MicroOcpp/Operations/GetDiagnostics.cpp
diff --git a/src/ArduinoOcpp/Operations/GetDiagnostics.h b/src/MicroOcpp/Operations/GetDiagnostics.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/GetDiagnostics.h
rename to src/MicroOcpp/Operations/GetDiagnostics.h
diff --git a/src/ArduinoOcpp/Operations/GetLocalListVersion.cpp b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/GetLocalListVersion.cpp
rename to src/MicroOcpp/Operations/GetLocalListVersion.cpp
diff --git a/src/ArduinoOcpp/Operations/GetLocalListVersion.h b/src/MicroOcpp/Operations/GetLocalListVersion.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/GetLocalListVersion.h
rename to src/MicroOcpp/Operations/GetLocalListVersion.h
diff --git a/src/ArduinoOcpp/Operations/Heartbeat.cpp b/src/MicroOcpp/Operations/Heartbeat.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/Heartbeat.cpp
rename to src/MicroOcpp/Operations/Heartbeat.cpp
diff --git a/src/ArduinoOcpp/Operations/Heartbeat.h b/src/MicroOcpp/Operations/Heartbeat.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/Heartbeat.h
rename to src/MicroOcpp/Operations/Heartbeat.h
diff --git a/src/ArduinoOcpp/Operations/MeterValues.cpp b/src/MicroOcpp/Operations/MeterValues.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/MeterValues.cpp
rename to src/MicroOcpp/Operations/MeterValues.cpp
diff --git a/src/ArduinoOcpp/Operations/MeterValues.h b/src/MicroOcpp/Operations/MeterValues.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/MeterValues.h
rename to src/MicroOcpp/Operations/MeterValues.h
diff --git a/src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
rename to src/MicroOcpp/Operations/RemoteStartTransaction.cpp
diff --git a/src/ArduinoOcpp/Operations/RemoteStartTransaction.h b/src/MicroOcpp/Operations/RemoteStartTransaction.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/RemoteStartTransaction.h
rename to src/MicroOcpp/Operations/RemoteStartTransaction.h
diff --git a/src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp b/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
rename to src/MicroOcpp/Operations/RemoteStopTransaction.cpp
diff --git a/src/ArduinoOcpp/Operations/RemoteStopTransaction.h b/src/MicroOcpp/Operations/RemoteStopTransaction.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/RemoteStopTransaction.h
rename to src/MicroOcpp/Operations/RemoteStopTransaction.h
diff --git a/src/ArduinoOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/ReserveNow.cpp
rename to src/MicroOcpp/Operations/ReserveNow.cpp
diff --git a/src/ArduinoOcpp/Operations/ReserveNow.h b/src/MicroOcpp/Operations/ReserveNow.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/ReserveNow.h
rename to src/MicroOcpp/Operations/ReserveNow.h
diff --git a/src/ArduinoOcpp/Operations/Reset.cpp b/src/MicroOcpp/Operations/Reset.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/Reset.cpp
rename to src/MicroOcpp/Operations/Reset.cpp
diff --git a/src/ArduinoOcpp/Operations/Reset.h b/src/MicroOcpp/Operations/Reset.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/Reset.h
rename to src/MicroOcpp/Operations/Reset.h
diff --git a/src/ArduinoOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/SendLocalList.cpp
rename to src/MicroOcpp/Operations/SendLocalList.cpp
diff --git a/src/ArduinoOcpp/Operations/SendLocalList.h b/src/MicroOcpp/Operations/SendLocalList.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/SendLocalList.h
rename to src/MicroOcpp/Operations/SendLocalList.h
diff --git a/src/ArduinoOcpp/Operations/SetChargingProfile.cpp b/src/MicroOcpp/Operations/SetChargingProfile.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/SetChargingProfile.cpp
rename to src/MicroOcpp/Operations/SetChargingProfile.cpp
diff --git a/src/ArduinoOcpp/Operations/SetChargingProfile.h b/src/MicroOcpp/Operations/SetChargingProfile.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/SetChargingProfile.h
rename to src/MicroOcpp/Operations/SetChargingProfile.h
diff --git a/src/ArduinoOcpp/Operations/StartTransaction.cpp b/src/MicroOcpp/Operations/StartTransaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/StartTransaction.cpp
rename to src/MicroOcpp/Operations/StartTransaction.cpp
diff --git a/src/ArduinoOcpp/Operations/StartTransaction.h b/src/MicroOcpp/Operations/StartTransaction.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/StartTransaction.h
rename to src/MicroOcpp/Operations/StartTransaction.h
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.cpp b/src/MicroOcpp/Operations/StatusNotification.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/StatusNotification.cpp
rename to src/MicroOcpp/Operations/StatusNotification.cpp
diff --git a/src/ArduinoOcpp/Operations/StatusNotification.h b/src/MicroOcpp/Operations/StatusNotification.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/StatusNotification.h
rename to src/MicroOcpp/Operations/StatusNotification.h
diff --git a/src/ArduinoOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/StopTransaction.cpp
rename to src/MicroOcpp/Operations/StopTransaction.cpp
diff --git a/src/ArduinoOcpp/Operations/StopTransaction.h b/src/MicroOcpp/Operations/StopTransaction.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/StopTransaction.h
rename to src/MicroOcpp/Operations/StopTransaction.h
diff --git a/src/ArduinoOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/TriggerMessage.cpp
rename to src/MicroOcpp/Operations/TriggerMessage.cpp
diff --git a/src/ArduinoOcpp/Operations/TriggerMessage.h b/src/MicroOcpp/Operations/TriggerMessage.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/TriggerMessage.h
rename to src/MicroOcpp/Operations/TriggerMessage.h
diff --git a/src/ArduinoOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/UnlockConnector.cpp
rename to src/MicroOcpp/Operations/UnlockConnector.cpp
diff --git a/src/ArduinoOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/UnlockConnector.h
rename to src/MicroOcpp/Operations/UnlockConnector.h
diff --git a/src/ArduinoOcpp/Operations/UpdateFirmware.cpp b/src/MicroOcpp/Operations/UpdateFirmware.cpp
similarity index 100%
rename from src/ArduinoOcpp/Operations/UpdateFirmware.cpp
rename to src/MicroOcpp/Operations/UpdateFirmware.cpp
diff --git a/src/ArduinoOcpp/Operations/UpdateFirmware.h b/src/MicroOcpp/Operations/UpdateFirmware.h
similarity index 100%
rename from src/ArduinoOcpp/Operations/UpdateFirmware.h
rename to src/MicroOcpp/Operations/UpdateFirmware.h
diff --git a/src/ArduinoOcpp/Platform.cpp b/src/MicroOcpp/Platform.cpp
similarity index 100%
rename from src/ArduinoOcpp/Platform.cpp
rename to src/MicroOcpp/Platform.cpp
diff --git a/src/ArduinoOcpp/Platform.h b/src/MicroOcpp/Platform.h
similarity index 100%
rename from src/ArduinoOcpp/Platform.h
rename to src/MicroOcpp/Platform.h
diff --git a/src/ArduinoOcpp_c.cpp b/src/MicroOcpp_c.cpp
similarity index 100%
rename from src/ArduinoOcpp_c.cpp
rename to src/MicroOcpp_c.cpp
diff --git a/src/ArduinoOcpp_c.h b/src/MicroOcpp_c.h
similarity index 100%
rename from src/ArduinoOcpp_c.h
rename to src/MicroOcpp_c.h

From 38cd2207f9ee01565dcddf92afcb8213b3c54a89 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 20 Aug 2023 22:32:39 +0200
Subject: [PATCH 348/549] change naming for release II

---
 .github/workflows/esp-idf.yml                 |   6 +-
 .github/workflows/platformless.yml            |   2 +-
 .github/workflows/tests.yml                   |   6 +-
 CMakeLists.txt                                | 208 ++++++------
 README.md                                     |  20 +-
 docs/img/components_overview.svg              |   2 +-
 docs/img/components_selective.svg             |   2 +-
 docs/index.md                                 |   4 +-
 docs/intro-tech.md                            |  44 +--
 docs/modules.md                               |  10 +-
 docs/prerequisites.md                         |  14 +-
 docs/security.md                              |  14 +-
 examples/ESP-IDF/CMakeLists.txt               |   4 +-
 examples/ESP-IDF/Makefile                     |   2 +-
 examples/ESP-IDF/README.md                    |  18 +-
 examples/ESP-IDF/components/README.md         |   4 +-
 examples/ESP-IDF/main/Kconfig.projbuild       |   6 +-
 examples/ESP-IDF/main/main.c                  |  34 +-
 examples/ESP-IDF/partitions.csv               |   2 +-
 examples/ESP-IDF/sdkconfig                    |   6 +-
 examples/ESP-TLS/main.cpp                     |  16 +-
 examples/ESP/main.cpp                         |  12 +-
 library.json                                  |   4 +-
 library.properties                            |   4 +-
 mkdocs.yml                                    |   2 +-
 platformio.ini                                |  10 +-
 src/MicroOcpp.cpp                             | 302 +++++++++---------
 src/MicroOcpp.h                               | 100 +++---
 src/MicroOcpp/Core/Configuration.cpp          |  32 +-
 src/MicroOcpp/Core/Configuration.h            |  18 +-
 src/MicroOcpp/Core/ConfigurationContainer.cpp |   8 +-
 src/MicroOcpp/Core/ConfigurationContainer.h   |   8 +-
 .../Core/ConfigurationContainerFlash.cpp      |  50 +--
 .../Core/ConfigurationContainerFlash.h        |  10 +-
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp  |  24 +-
 src/MicroOcpp/Core/ConfigurationKeyValue.h    |   6 +-
 src/MicroOcpp/Core/ConfigurationOptions.h     |  10 +-
 src/MicroOcpp/Core/Connection.cpp             |  38 +--
 src/MicroOcpp/Core/Connection.h               |  32 +-
 src/MicroOcpp/Core/Context.cpp                |  14 +-
 src/MicroOcpp/Core/Context.h                  |  16 +-
 src/MicroOcpp/Core/FilesystemAdapter.cpp      | 118 +++----
 src/MicroOcpp/Core/FilesystemAdapter.h        |  52 +--
 src/MicroOcpp/Core/FilesystemUtils.cpp        |  60 ++--
 src/MicroOcpp/Core/FilesystemUtils.h          |  10 +-
 src/MicroOcpp/Core/OcppError.h                |   8 +-
 src/MicroOcpp/Core/Operation.cpp              |  20 +-
 src/MicroOcpp/Core/Operation.h                |  12 +-
 src/MicroOcpp/Core/OperationRegistry.cpp      |  22 +-
 src/MicroOcpp/Core/OperationRegistry.h        |  10 +-
 src/MicroOcpp/Core/PollResult.h               |  10 +-
 src/MicroOcpp/Core/Request.cpp                |  58 ++--
 src/MicroOcpp/Core/Request.h                  |  12 +-
 src/MicroOcpp/Core/RequestCallbacks.h         |  10 +-
 src/MicroOcpp/Core/RequestQueue.cpp           |  60 ++--
 src/MicroOcpp/Core/RequestQueue.h             |  12 +-
 .../Core/RequestQueueStorageStrategy.cpp      |  42 +--
 .../Core/RequestQueueStorageStrategy.h        |   6 +-
 src/MicroOcpp/Core/RequestStore.cpp           | 106 +++---
 src/MicroOcpp/Core/RequestStore.h             |  10 +-
 src/MicroOcpp/Core/SimpleRequestFactory.cpp   |  10 +-
 src/MicroOcpp/Core/SimpleRequestFactory.h     |  12 +-
 src/MicroOcpp/Core/Time.cpp                   |  20 +-
 src/MicroOcpp/Core/Time.h                     |  16 +-
 src/MicroOcpp/Debug.h                         | 144 ++++-----
 .../Model/Authorization/AuthorizationData.cpp |  10 +-
 .../Model/Authorization/AuthorizationData.h   |   8 +-
 .../Model/Authorization/AuthorizationList.cpp |  14 +-
 .../Model/Authorization/AuthorizationList.h   |  12 +-
 .../Authorization/AuthorizationService.cpp    |  58 ++--
 .../Authorization/AuthorizationService.h      |  10 +-
 src/MicroOcpp/Model/Boot/BootService.cpp      |  68 ++--
 src/MicroOcpp/Model/Boot/BootService.h        |  12 +-
 .../ConnectorBase/ChargePointErrorData.h      |   8 +-
 .../Model/ConnectorBase/ChargePointStatus.h   |   6 +-
 .../Model/ConnectorBase/Connector.cpp         | 146 ++++-----
 src/MicroOcpp/Model/ConnectorBase/Connector.h |  18 +-
 .../Model/ConnectorBase/ConnectorsCommon.cpp  |  38 +--
 .../Model/ConnectorBase/ConnectorsCommon.h    |   8 +-
 .../Model/ConnectorBase/Notification.cpp      |  32 +-
 .../Model/ConnectorBase/Notification.h        |  18 +-
 .../Model/Diagnostics/DiagnosticsService.cpp  |  38 +--
 .../Model/Diagnostics/DiagnosticsService.h    |  14 +-
 .../Model/Diagnostics/DiagnosticsStatus.h     |   6 +-
 .../FirmwareManagement/FirmwareService.cpp    |  94 +++---
 .../FirmwareManagement/FirmwareService.h      |  18 +-
 .../Model/FirmwareManagement/FirmwareStatus.h |   6 +-
 .../Model/Heartbeat/HeartbeatService.cpp      |  20 +-
 .../Model/Heartbeat/HeartbeatService.h        |   8 +-
 src/MicroOcpp/Model/Metering/MeterStore.cpp   |  96 +++---
 src/MicroOcpp/Model/Metering/MeterStore.h     |  10 +-
 src/MicroOcpp/Model/Metering/MeterValue.cpp   |  18 +-
 src/MicroOcpp/Model/Metering/MeterValue.h     |  10 +-
 .../Model/Metering/MeteringConnector.cpp      |  42 +--
 .../Model/Metering/MeteringConnector.h        |  14 +-
 .../Model/Metering/MeteringService.cpp        |  44 +--
 .../Model/Metering/MeteringService.h          |  12 +-
 src/MicroOcpp/Model/Metering/SampledValue.cpp |  18 +-
 src/MicroOcpp/Model/Metering/SampledValue.h   |   8 +-
 src/MicroOcpp/Model/Model.cpp                 |  32 +-
 src/MicroOcpp/Model/Model.h                   |  14 +-
 .../Model/Reservation/Reservation.cpp         |  14 +-
 src/MicroOcpp/Model/Reservation/Reservation.h |   8 +-
 .../Model/Reservation/ReservationService.cpp  |  30 +-
 .../Model/Reservation/ReservationService.h    |   6 +-
 src/MicroOcpp/Model/Reset/ResetService.cpp    |  48 +--
 src/MicroOcpp/Model/Reset/ResetService.h      |  16 +-
 .../SmartCharging/SmartChargingModel.cpp      |  64 ++--
 .../Model/SmartCharging/SmartChargingModel.h  |   8 +-
 .../SmartCharging/SmartChargingService.cpp    |  82 ++---
 .../SmartCharging/SmartChargingService.h      |  14 +-
 .../Model/Transactions/Transaction.cpp        |  68 ++--
 .../Model/Transactions/Transaction.h          |  42 +--
 .../Transactions/TransactionDeserialize.cpp   |  36 +--
 .../Transactions/TransactionDeserialize.h     |   6 +-
 .../Model/Transactions/TransactionStore.cpp   | 118 +++----
 .../Model/Transactions/TransactionStore.h     |  14 +-
 src/MicroOcpp/Operations/Authorize.cpp        |  18 +-
 src/MicroOcpp/Operations/Authorize.h          |  10 +-
 src/MicroOcpp/Operations/BootNotification.cpp |  22 +-
 src/MicroOcpp/Operations/BootNotification.h   |  10 +-
 .../Operations/CancelReservation.cpp          |  12 +-
 src/MicroOcpp/Operations/CancelReservation.h  |   8 +-
 .../Operations/ChangeAvailability.cpp         |  10 +-
 src/MicroOcpp/Operations/ChangeAvailability.h |   8 +-
 .../Operations/ChangeConfiguration.cpp        |  24 +-
 .../Operations/ChangeConfiguration.h          |   8 +-
 src/MicroOcpp/Operations/CiStrings.h          |   2 +-
 src/MicroOcpp/Operations/ClearCache.cpp       |  12 +-
 src/MicroOcpp/Operations/ClearCache.h         |  10 +-
 .../Operations/ClearChargingProfile.cpp       |  10 +-
 .../Operations/ClearChargingProfile.h         |   8 +-
 src/MicroOcpp/Operations/CustomOperation.cpp  |   6 +-
 src/MicroOcpp/Operations/CustomOperation.h    |  12 +-
 src/MicroOcpp/Operations/DataTransfer.cpp     |  12 +-
 src/MicroOcpp/Operations/DataTransfer.h       |   8 +-
 .../DiagnosticsStatusNotification.cpp         |  12 +-
 .../DiagnosticsStatusNotification.h           |  10 +-
 .../Operations/FirmwareStatusNotification.cpp |  12 +-
 .../Operations/FirmwareStatusNotification.h   |  10 +-
 .../Operations/GetCompositeSchedule.cpp       |  12 +-
 .../Operations/GetCompositeSchedule.h         |  12 +-
 src/MicroOcpp/Operations/GetConfiguration.cpp |  14 +-
 src/MicroOcpp/Operations/GetConfiguration.h   |   8 +-
 src/MicroOcpp/Operations/GetDiagnostics.cpp   |  20 +-
 src/MicroOcpp/Operations/GetDiagnostics.h     |  10 +-
 .../Operations/GetLocalListVersion.cpp        |  12 +-
 .../Operations/GetLocalListVersion.h          |   8 +-
 src/MicroOcpp/Operations/Heartbeat.cpp        |  16 +-
 src/MicroOcpp/Operations/Heartbeat.h          |   8 +-
 src/MicroOcpp/Operations/MeterValues.cpp      |  18 +-
 src/MicroOcpp/Operations/MeterValues.h        |  10 +-
 .../Operations/RemoteStartTransaction.cpp     |  20 +-
 .../Operations/RemoteStartTransaction.h       |  10 +-
 .../Operations/RemoteStopTransaction.cpp      |  12 +-
 .../Operations/RemoteStopTransaction.h        |   8 +-
 src/MicroOcpp/Operations/ReserveNow.cpp       |  18 +-
 src/MicroOcpp/Operations/ReserveNow.h         |   8 +-
 src/MicroOcpp/Operations/Reset.cpp            |  12 +-
 src/MicroOcpp/Operations/Reset.h              |   8 +-
 src/MicroOcpp/Operations/SendLocalList.cpp    |  12 +-
 src/MicroOcpp/Operations/SendLocalList.h      |   8 +-
 .../Operations/SetChargingProfile.cpp         |  14 +-
 src/MicroOcpp/Operations/SetChargingProfile.h |   8 +-
 src/MicroOcpp/Operations/StartTransaction.cpp |  42 +--
 src/MicroOcpp/Operations/StartTransaction.h   |  14 +-
 .../Operations/StatusNotification.cpp         |  18 +-
 src/MicroOcpp/Operations/StatusNotification.h |  14 +-
 src/MicroOcpp/Operations/StopTransaction.cpp  |  48 +--
 src/MicroOcpp/Operations/StopTransaction.h    |  14 +-
 src/MicroOcpp/Operations/TriggerMessage.cpp   |  26 +-
 src/MicroOcpp/Operations/TriggerMessage.h     |   8 +-
 src/MicroOcpp/Operations/UnlockConnector.cpp  |  18 +-
 src/MicroOcpp/Operations/UnlockConnector.h    |  10 +-
 src/MicroOcpp/Operations/UpdateFirmware.cpp   |  18 +-
 src/MicroOcpp/Operations/UpdateFirmware.h     |  10 +-
 src/MicroOcpp/Platform.cpp                    |  52 +--
 src/MicroOcpp/Platform.h                      |  88 ++---
 src/MicroOcpp_c.cpp                           | 210 ++++++------
 src/MicroOcpp_c.h                             | 148 ++++-----
 tests/Api.cpp                                 | 208 ++++++------
 tests/ChargingSessions.cpp                    |  60 ++--
 tests/ConfigurationBehavior.cpp               |  30 +-
 tests/Metering.cpp                            |  30 +-
 tests/SmartCharging.cpp                       |  28 +-
 tests/TransactionSafety.cpp                   |  52 +--
 tests/helpers/testHelper.cpp                  |   6 +-
 tests/ocppEngineLifecycle.cpp                 |  12 +-
 188 files changed, 2616 insertions(+), 2614 deletions(-)

diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
index 4513cf88..50f34083 100644
--- a/.github/workflows/esp-idf.yml
+++ b/.github/workflows/esp-idf.yml
@@ -23,7 +23,7 @@ jobs:
     - name: Checkout main repo
       uses: actions/checkout@v3
       with:
-        path: examples/ESP-IDF/components/ArduinoOcpp
+        path: examples/ESP-IDF/components/MicroOcpp
     - name: Checkout Mongoose
       uses: actions/checkout@v3
       with:
@@ -33,8 +33,8 @@ jobs:
     - name: Checkout Mongoose WS adapter
       uses: actions/checkout@v3
       with:
-        repository: matth-x/ArduinoOcppMongoose
-        path: examples/ESP-IDF/components/ArduinoOcppMongoose
+        repository: matth-x/MicroOcppMongoose
+        path: examples/ESP-IDF/components/MicroOcppMongoose
     - name: Checkout ArduinoJson
       uses: actions/checkout@v3
       with:
diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 24f3ce1c..c6e638d7 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -26,4 +26,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DAO_FILENAME_PREFIX='"./ao_store/"' -DAO_PLATFORM=AO_PLATFORM_UNIX -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DMOCPP_FILENAME_PREFIX='"./mo_store/"' -DMOCPP_PLATFORM=MOCPP_PLATFORM_UNIX -Wall
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 0f79f34e..886500d1 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -28,11 +28,11 @@ jobs:
     - name: Generate CMake build files
       run: cmake -S . -B ./build
     - name: Compile
-      run: cmake --build ./build -j 16 --target ao_unit_tests
+      run: cmake --build ./build -j 16 --target mo_unit_tests
     - name: Configure FS
-      run: mkdir ao_store
+      run: mkdir mo_store
     - name: Run tests
-      run: ./build/ao_unit_tests
+      run: ./build/mo_unit_tests
     - name: Create coverage report
       run: |
         lcov --directory . --capture --output-file coverage.info
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 51bab471..20262899 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,121 +1,121 @@
-# matth-x/ArduinoOcpp
+# matth-x/MicroOcpp
 # Copyright Matthias Akstaller 2019 - 2023
 # MIT License
 
 cmake_minimum_required(VERSION 3.15)
 
 
-set(AO_SRC
-    src/ArduinoOcpp/Core/Configuration.cpp
-    src/ArduinoOcpp/Core/ConfigurationContainer.cpp
-    src/ArduinoOcpp/Core/ConfigurationContainerFlash.cpp
-    src/ArduinoOcpp/Core/ConfigurationKeyValue.cpp
-    src/ArduinoOcpp/Core/FilesystemAdapter.cpp
-    src/ArduinoOcpp/Core/FilesystemUtils.cpp
-    src/ArduinoOcpp/Core/RequestQueue.cpp
-    src/ArduinoOcpp/Core/Context.cpp
-    src/ArduinoOcpp/Core/Operation.cpp
-    src/ArduinoOcpp/Model/Model.cpp
-    src/ArduinoOcpp/Core/Request.cpp
-    src/ArduinoOcpp/Core/Connection.cpp
-    src/ArduinoOcpp/Core/Time.cpp
-    src/ArduinoOcpp/Core/RequestQueueStorageStrategy.cpp
-    src/ArduinoOcpp/Core/RequestStore.cpp
-    src/ArduinoOcpp/Operations/Authorize.cpp
-    src/ArduinoOcpp/Operations/BootNotification.cpp
-    src/ArduinoOcpp/Operations/CancelReservation.cpp
-    src/ArduinoOcpp/Operations/ChangeAvailability.cpp
-    src/ArduinoOcpp/Operations/ChangeConfiguration.cpp
-    src/ArduinoOcpp/Operations/ClearCache.cpp
-    src/ArduinoOcpp/Operations/ClearChargingProfile.cpp
-    src/ArduinoOcpp/Operations/CustomOperation.cpp
-    src/ArduinoOcpp/Operations/DataTransfer.cpp
-    src/ArduinoOcpp/Operations/DiagnosticsStatusNotification.cpp
-    src/ArduinoOcpp/Operations/FirmwareStatusNotification.cpp
-    src/ArduinoOcpp/Operations/GetCompositeSchedule.cpp
-    src/ArduinoOcpp/Operations/GetConfiguration.cpp
-    src/ArduinoOcpp/Operations/GetDiagnostics.cpp
-    src/ArduinoOcpp/Operations/GetLocalListVersion.cpp
-    src/ArduinoOcpp/Operations/Heartbeat.cpp
-    src/ArduinoOcpp/Operations/MeterValues.cpp
-    src/ArduinoOcpp/Operations/RemoteStartTransaction.cpp
-    src/ArduinoOcpp/Operations/RemoteStopTransaction.cpp
-    src/ArduinoOcpp/Operations/ReserveNow.cpp
-    src/ArduinoOcpp/Operations/Reset.cpp
-    src/ArduinoOcpp/Operations/SendLocalList.cpp
-    src/ArduinoOcpp/Operations/SetChargingProfile.cpp
-    src/ArduinoOcpp/Operations/StartTransaction.cpp
-    src/ArduinoOcpp/Operations/StatusNotification.cpp
-    src/ArduinoOcpp/Operations/StopTransaction.cpp
-    src/ArduinoOcpp/Operations/TriggerMessage.cpp
-    src/ArduinoOcpp/Operations/UnlockConnector.cpp
-    src/ArduinoOcpp/Operations/UpdateFirmware.cpp
-    src/ArduinoOcpp/Platform.cpp
-    src/ArduinoOcpp/Core/SimpleRequestFactory.cpp
-    src/ArduinoOcpp/Core/OperationRegistry.cpp
-    src/ArduinoOcpp/Model/Authorization/AuthorizationData.cpp
-    src/ArduinoOcpp/Model/Authorization/AuthorizationList.cpp
-    src/ArduinoOcpp/Model/Authorization/AuthorizationService.cpp
-    src/ArduinoOcpp/Model/Boot/BootService.cpp
-    src/ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
-    src/ArduinoOcpp/Model/ConnectorBase/Connector.cpp
-    src/ArduinoOcpp/Model/ConnectorBase/Notification.cpp
-    src/ArduinoOcpp/Model/Diagnostics/DiagnosticsService.cpp
-    src/ArduinoOcpp/Model/FirmwareManagement/FirmwareService.cpp
-    src/ArduinoOcpp/Model/Heartbeat/HeartbeatService.cpp
-    src/ArduinoOcpp/Model/Metering/MeteringConnector.cpp
-    src/ArduinoOcpp/Model/Metering/MeteringService.cpp
-    src/ArduinoOcpp/Model/Metering/MeterStore.cpp
-    src/ArduinoOcpp/Model/Metering/MeterValue.cpp
-    src/ArduinoOcpp/Model/Metering/SampledValue.cpp
-    src/ArduinoOcpp/Model/Reservation/Reservation.cpp
-    src/ArduinoOcpp/Model/Reservation/ReservationService.cpp
-    src/ArduinoOcpp/Model/Reset/ResetService.cpp
-    src/ArduinoOcpp/Model/SmartCharging/SmartChargingModel.cpp
-    src/ArduinoOcpp/Model/SmartCharging/SmartChargingService.cpp
-    src/ArduinoOcpp/Model/Transactions/Transaction.cpp
-    src/ArduinoOcpp/Model/Transactions/TransactionDeserialize.cpp
-    src/ArduinoOcpp/Model/Transactions/TransactionStore.cpp
-    src/ArduinoOcpp.cpp
-    src/ArduinoOcpp_c.cpp
+set(MOCPP_SRC
+    src/MicroOcpp/Core/Configuration.cpp
+    src/MicroOcpp/Core/ConfigurationContainer.cpp
+    src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+    src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+    src/MicroOcpp/Core/FilesystemAdapter.cpp
+    src/MicroOcpp/Core/FilesystemUtils.cpp
+    src/MicroOcpp/Core/RequestQueue.cpp
+    src/MicroOcpp/Core/Context.cpp
+    src/MicroOcpp/Core/Operation.cpp
+    src/MicroOcpp/Model/Model.cpp
+    src/MicroOcpp/Core/Request.cpp
+    src/MicroOcpp/Core/Connection.cpp
+    src/MicroOcpp/Core/Time.cpp
+    src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
+    src/MicroOcpp/Core/RequestStore.cpp
+    src/MicroOcpp/Operations/Authorize.cpp
+    src/MicroOcpp/Operations/BootNotification.cpp
+    src/MicroOcpp/Operations/CancelReservation.cpp
+    src/MicroOcpp/Operations/ChangeAvailability.cpp
+    src/MicroOcpp/Operations/ChangeConfiguration.cpp
+    src/MicroOcpp/Operations/ClearCache.cpp
+    src/MicroOcpp/Operations/ClearChargingProfile.cpp
+    src/MicroOcpp/Operations/CustomOperation.cpp
+    src/MicroOcpp/Operations/DataTransfer.cpp
+    src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
+    src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
+    src/MicroOcpp/Operations/GetCompositeSchedule.cpp
+    src/MicroOcpp/Operations/GetConfiguration.cpp
+    src/MicroOcpp/Operations/GetDiagnostics.cpp
+    src/MicroOcpp/Operations/GetLocalListVersion.cpp
+    src/MicroOcpp/Operations/Heartbeat.cpp
+    src/MicroOcpp/Operations/MeterValues.cpp
+    src/MicroOcpp/Operations/RemoteStartTransaction.cpp
+    src/MicroOcpp/Operations/RemoteStopTransaction.cpp
+    src/MicroOcpp/Operations/ReserveNow.cpp
+    src/MicroOcpp/Operations/Reset.cpp
+    src/MicroOcpp/Operations/SendLocalList.cpp
+    src/MicroOcpp/Operations/SetChargingProfile.cpp
+    src/MicroOcpp/Operations/StartTransaction.cpp
+    src/MicroOcpp/Operations/StatusNotification.cpp
+    src/MicroOcpp/Operations/StopTransaction.cpp
+    src/MicroOcpp/Operations/TriggerMessage.cpp
+    src/MicroOcpp/Operations/UnlockConnector.cpp
+    src/MicroOcpp/Operations/UpdateFirmware.cpp
+    src/MicroOcpp/Platform.cpp
+    src/MicroOcpp/Core/SimpleRequestFactory.cpp
+    src/MicroOcpp/Core/OperationRegistry.cpp
+    src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
+    src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
+    src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+    src/MicroOcpp/Model/Boot/BootService.cpp
+    src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+    src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+    src/MicroOcpp/Model/ConnectorBase/Notification.cpp
+    src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+    src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+    src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
+    src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+    src/MicroOcpp/Model/Metering/MeteringService.cpp
+    src/MicroOcpp/Model/Metering/MeterStore.cpp
+    src/MicroOcpp/Model/Metering/MeterValue.cpp
+    src/MicroOcpp/Model/Metering/SampledValue.cpp
+    src/MicroOcpp/Model/Reservation/Reservation.cpp
+    src/MicroOcpp/Model/Reservation/ReservationService.cpp
+    src/MicroOcpp/Model/Reset/ResetService.cpp
+    src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
+    src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+    src/MicroOcpp/Model/Transactions/Transaction.cpp
+    src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
+    src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+    src/MicroOcpp.cpp
+    src/MicroOcpp_c.cpp
 )
 
 if(ESP_PLATFORM)
 
-    idf_component_register(SRCS ${AO_SRC}
+    idf_component_register(SRCS ${MOCPP_SRC}
                         INCLUDE_DIRS "./src" "../ArduinoJson/src"
                         PRIV_REQUIRES spiffs)
 
     target_compile_options(${COMPONENT_TARGET} PUBLIC
-        -DAO_PLATFORM=AO_PLATFORM_ESPIDF
-        -DAO_CUSTOM_WS
-        -DAO_CUSTOM_UPDATER
-        -DAO_CUSTOM_RESET
+        -DMOCPP_PLATFORM=MOCPP_PLATFORM_ESPIDF
+        -DMOCPP_CUSTOM_WS
+        -DMOCPP_CUSTOM_UPDATER
+        -DMOCPP_CUSTOM_RESET
         )
 
     return()
 endif()
 
-project(ArduinoOcpp
+project(MicroOcpp
         VERSION 0.2.0)
 
-add_library(ArduinoOcpp ${AO_SRC})
+add_library(MicroOcpp ${MOCPP_SRC})
 
-target_include_directories(ArduinoOcpp PUBLIC
+target_include_directories(MicroOcpp PUBLIC
     "./src"
     "../ArduinoJson/src"
 )
 
-target_compile_definitions(ArduinoOcpp PUBLIC
-    AO_PLATFORM=AO_PLATFORM_UNIX
-    AO_CUSTOM_WS
-    AO_CUSTOM_UPDATER
-    AO_CUSTOM_RESET
+target_compile_definitions(MicroOcpp PUBLIC
+    MOCPP_PLATFORM=MOCPP_PLATFORM_UNIX
+    MOCPP_CUSTOM_WS
+    MOCPP_CUSTOM_UPDATER
+    MOCPP_CUSTOM_RESET
 )
 
 # Unit tests
 
-set(AO_SRC_UNIT
+set(MOCPP_SRC_UNIT
     tests/helpers/testHelper.cpp
     tests/ocppEngineLifecycle.cpp
     tests/TransactionSafety.cpp
@@ -126,36 +126,36 @@ set(AO_SRC_UNIT
     tests/Metering.cpp
 )
 
-add_executable(ao_unit_tests
-    ${AO_SRC}
-    ${AO_SRC_UNIT}
+add_executable(mo_unit_tests
+    ${MOCPP_SRC}
+    ${MOCPP_SRC_UNIT}
     ./tests/catch2/catchMain.cpp
 )
 
-target_include_directories(ao_unit_tests PUBLIC
+target_include_directories(mo_unit_tests PUBLIC
     "./tests/catch2"
     "./tests/helpers"
     "./src"
 )
 
-target_compile_definitions(ao_unit_tests PUBLIC
-    AO_PLATFORM=AO_PLATFORM_UNIX
-    AO_NUMCONNECTORS=3
-    AO_CUSTOM_TIMER
-    AO_CUSTOM_WS
-    AO_CUSTOM_UPDATER
-    AO_CUSTOM_RESET
-    AO_DBG_LEVEL=AO_DL_DEBUG
-    AO_TRAFFIC_OUT
-    AO_FILENAME_PREFIX="./ao_store/"
+target_compile_definitions(mo_unit_tests PUBLIC
+    MOCPP_PLATFORM=MOCPP_PLATFORM_UNIX
+    MOCPP_NUMCONNECTORS=3
+    MOCPP_CUSTOM_TIMER
+    MOCPP_CUSTOM_WS
+    MOCPP_CUSTOM_UPDATER
+    MOCPP_CUSTOM_RESET
+    MOCPP_DBG_LEVEL=MOCPP_DL_DEBUG
+    MOCPP_TRAFFIC_OUT
+    MOCPP_FILENAME_PREFIX="./mo_store/"
 )
 
-target_compile_options(ao_unit_tests PUBLIC
+target_compile_options(mo_unit_tests PUBLIC
     -O0
     -g
     --coverage
 )
 
-target_link_options(ao_unit_tests PUBLIC
+target_link_options(mo_unit_tests PUBLIC
     --coverage
 )
diff --git a/README.md b/README.md
index 90050034..e72d0e0e 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,14 @@
-# <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; ArduinoOcpp
+# <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; MicroOcpp
 
-[![Build Status]( https://github.com/matth-x/ArduinoOcpp/workflows/PlatformIO%20CI/badge.svg)](https://github.com/matth-x/ArduinoOcpp/actions)
-[![Unit tests]( https://github.com/matth-x/ArduinoOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/ArduinoOcpp/actions)
-[![codecov](https://codecov.io/github/matth-x/ArduinoOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/ArduinoOcpp)
+[![Build Status]( https://github.com/matth-x/MicroOcpp/workflows/PlatformIO%20CI/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
+[![Unit tests]( https://github.com/matth-x/MicroOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
+[![codecov](https://codecov.io/github/matth-x/MicroOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/MicroOcpp)
 
 OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with Espressif, NXP, Texas Instruments and STM.
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
 
-PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
+PlatformIO package: [MicroOcpp](https://platformio.org/lib/show/11975/MicroOcpp)
 
 Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
@@ -24,9 +24,9 @@ This library allows EVSEs to communicate with an OCPP Backend and to participate
 
 :heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
-Technical introduction: [ArduinoOcpp Docs](https://matth-x.github.io/ArduinoOcpp/intro-tech)
+Technical introduction: [MicroOcpp Docs](https://matth-x.github.io/MicroOcpp/intro-tech)
 
-Try it (no hardware required): [ArduinoOcppSimulator](https://github.com/matth-x/ArduinoOcppSimulator)
+Try it (no hardware required): [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)
 
 ### Features
 
@@ -41,7 +41,7 @@ The necessary hardware and internet integration is usually far below 1000 LOCs.
 
 ## Developers guide
 
-Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`ArduinoOcpp.h`](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h).
+Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h).
 
 ### Dependencies
 
@@ -53,13 +53,13 @@ If compiled with the Arduino integration:
 
 - [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (version `2.3.6`)
 
-In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp` in the PIO library manager.
+In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp` in the PIO library manager.
 
 ## OCPP 2.0.1 and ISO 15118
 
 The OCPP 2.0.1 upgrade is being worked on. Further details will be announced soon.
 
-ISO 15118 is a must-have for future chargers. It will hugely improve the security and user-friendliness of EV charging. ArduinoOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is being validated now in a proprietary firmware development.
+ISO 15118 is a must-have for future chargers. It will hugely improve the security and user-friendliness of EV charging. MicroOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is being validated now in a proprietary firmware development.
 
 However, no public ISO 15118 integration exists at the moment. If your company considers working on an open source ISO 15118 stack, it would be great to discuss a potential collaboration on an open source OCPP 2.0.1 + ISO 15118 solution.
 
diff --git a/docs/img/components_overview.svg b/docs/img/components_overview.svg
index 174ecf99..d5dbf07f 100644
--- a/docs/img/components_overview.svg
+++ b/docs/img/components_overview.svg
@@ -1,3 +1,3 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="335px" height="391px" viewBox="-0.5 -0.5 335 391"><defs/><g><rect x="-0.4" y="0" width="333.4" height="390" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="33" y="70" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 77px; margin-left: 34px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp library</div></div></div></foreignObject><text x="163" y="89" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp library</text></switch></g><rect x="43" y="110" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 135px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp API</div></div></div></foreignObject><text x="163" y="139" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp API</text></switch></g><rect x="43" y="170" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 195px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="163" y="199" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="43" y="230" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 255px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="163" y="259" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="73" y="20" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 35px; margin-left: 74px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware (main source)</div></div></div></foreignObject><text x="145" y="39" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware (main source)</text></switch></g><rect x="71.4" y="330" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 355px; margin-left: 72px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="163" y="359" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 145.47 50 L 152.25 113.67" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 152.8 118.89 L 148.58 112.3 L 152.25 113.67 L 155.54 111.56 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 163 290 L 163 323.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 163 328.88 L 159.5 321.88 L 163 323.63 L 166.5 321.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="335px" height="391px" viewBox="-0.5 -0.5 335 391"><defs/><g><rect x="-0.4" y="0" width="333.4" height="390" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="33" y="70" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 77px; margin-left: 34px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp library</div></div></div></foreignObject><text x="163" y="89" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp library</text></switch></g><rect x="43" y="110" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 135px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp API</div></div></div></foreignObject><text x="163" y="139" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp API</text></switch></g><rect x="43" y="170" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 195px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="163" y="199" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="43" y="230" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 255px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="163" y="259" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="73" y="20" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 35px; margin-left: 74px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware (main source)</div></div></div></foreignObject><text x="145" y="39" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware (main source)</text></switch></g><rect x="71.4" y="330" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 355px; margin-left: 72px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="163" y="359" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 145.47 50 L 152.25 113.67" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 152.8 118.89 L 148.58 112.3 L 152.25 113.67 L 155.54 111.56 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 163 290 L 163 323.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 163 328.88 L 159.5 321.88 L 163 323.63 L 166.5 321.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
diff --git a/docs/img/components_selective.svg b/docs/img/components_selective.svg
index 30e17ba8..e2dedf65 100644
--- a/docs/img/components_selective.svg
+++ b/docs/img/components_selective.svg
@@ -1,3 +1,3 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="603px" height="402px" viewBox="-0.5 -0.5 603 402"><defs/><g><rect x="17" y="0" width="580" height="400" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="27" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp library</div></div></div></foreignObject><text x="157" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp library</text></switch></g><rect x="37" y="130" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp API</div></div></div></foreignObject><text x="157" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp API</text></switch></g><rect x="37" y="190" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="157" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="37" y="250" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="157" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="0" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 1px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="72" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="65.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 66px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="157" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 157 310 L 157 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 157 348.88 L 153.5 341.88 L 157 343.63 L 160.5 341.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 72.47 70 L 86.44 253.65" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 86.84 258.89 L 82.81 252.17 L 86.44 253.65 L 89.79 251.64 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="327" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 328px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp library</div></div></div></foreignObject><text x="457" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp library</text></switch></g><rect x="337" y="130" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">ArduinoOcpp API</div></div></div></foreignObject><text x="457" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ArduinoOcpp API</text></switch></g><rect x="337" y="190" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="457" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="337" y="250" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="457" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="457" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 458px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="529" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="365.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 366px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="457" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 457 310 L 457 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 457 348.88 L 453.5 341.88 L 457 343.63 L 460.5 341.88 Z" fill-opacity="0.1" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="all"/><path d="M 529.47 70 L 517.98 143.71" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 517.17 148.9 L 514.79 141.44 L 517.98 143.71 L 521.71 142.52 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 448.42 270.5 L 465 270.5 L 465 318.36 L 475.5 318.36 L 456.71 339.5 L 437.92 318.36 L 448.42 318.36 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="397" y="344" width="120" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 359px; margin-left: 398px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">custom RPC framework</div></div></div></foreignObject><text x="457" y="363" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">custom RPC framework</text></switch></g><path d="M 307 70 L 307 330" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><rect x="27" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example A) Only RPC framework selected</div></div></div></foreignObject><text x="167" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example A) Only RPC framework selected</text></switch></g><rect x="307" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 308px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example B) OCPP logic selected</div></div></div></foreignObject><text x="447" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example B) OCPP logic selected</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="603px" height="402px" viewBox="-0.5 -0.5 603 402"><defs/><g><rect x="17" y="0" width="580" height="400" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="27" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp library</div></div></div></foreignObject><text x="157" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp library</text></switch></g><rect x="37" y="130" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp API</div></div></div></foreignObject><text x="157" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp API</text></switch></g><rect x="37" y="190" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="157" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="37" y="250" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="157" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="0" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 1px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="72" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="65.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 66px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="157" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 157 310 L 157 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 157 348.88 L 153.5 341.88 L 157 343.63 L 160.5 341.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 72.47 70 L 86.44 253.65" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 86.84 258.89 L 82.81 252.17 L 86.44 253.65 L 89.79 251.64 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="327" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 328px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp library</div></div></div></foreignObject><text x="457" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp library</text></switch></g><rect x="337" y="130" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp API</div></div></div></foreignObject><text x="457" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp API</text></switch></g><rect x="337" y="190" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="457" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="337" y="250" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="457" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="457" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 458px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="529" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="365.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 366px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="457" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 457 310 L 457 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 457 348.88 L 453.5 341.88 L 457 343.63 L 460.5 341.88 Z" fill-opacity="0.1" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="all"/><path d="M 529.47 70 L 517.98 143.71" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 517.17 148.9 L 514.79 141.44 L 517.98 143.71 L 521.71 142.52 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 448.42 270.5 L 465 270.5 L 465 318.36 L 475.5 318.36 L 456.71 339.5 L 437.92 318.36 L 448.42 318.36 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="397" y="344" width="120" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 359px; margin-left: 398px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">custom RPC framework</div></div></div></foreignObject><text x="457" y="363" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">custom RPC framework</text></switch></g><path d="M 307 70 L 307 330" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><rect x="27" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example A) Only RPC framework selected</div></div></div></foreignObject><text x="167" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example A) Only RPC framework selected</text></switch></g><rect x="307" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 308px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example B) OCPP logic selected</div></div></div></foreignObject><text x="447" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example B) OCPP logic selected</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
index 08667de5..66e396c2 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,4 +1,4 @@
-ArduinoOcpp is an OCPP client which runs on microcontrollers and enables EVSEs to participate in OCPP charging networks. As a software library, it can be added to the firmware of the EVSE and will become a new part of it. If the EVSE has already an internet controller, then most likely, no extra hardware is required.
+MicroOcpp is an OCPP client which runs on microcontrollers and enables EVSEs to participate in OCPP charging networks. As a software library, it can be added to the firmware of the EVSE and will become a new part of it. If the EVSE has already an internet controller, then most likely, no extra hardware is required.
 
 [Technical introduction](intro-tech)
 
@@ -8,4 +8,4 @@ ArduinoOcpp is an OCPP client which runs on microcontrollers and enables EVSEs t
 
 <!-- This chapter shows how to kick-start your OCPP project. -->
 
-*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/ArduinoOcpp) or the [API description](https://github.com/matth-x/ArduinoOcpp/blob/master/src/ArduinoOcpp.h) as reference.*
+*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/MicroOcpp) or the [API description](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h) as reference.*
diff --git a/docs/intro-tech.md b/docs/intro-tech.md
index f223d984..60648074 100644
--- a/docs/intro-tech.md
+++ b/docs/intro-tech.md
@@ -1,16 +1,16 @@
 # Technical introduction
 
-This chapter covers the technical concepts of ArduinoOcpp.
+This chapter covers the technical concepts of MicroOcpp.
 
-## Scope of ArduinoOcpp
+## Scope of MicroOcpp
 
-The OCPP specification defines a charger data model, operations on the data model and the resulting physical behavior on the charger side. ArduinoOcpp implements the full scope of OCPP, i.e. a minimalistic data store for the data model, the OCPP operations and an interface to the surrounding firmware.
+The OCPP specification defines a charger data model, operations on the data model and the resulting physical behavior on the charger side. MicroOcpp implements the full scope of OCPP, i.e. a minimalistic data store for the data model, the OCPP operations and an interface to the surrounding firmware.
 
-Another part of OCPP is its messaging mechanism, the so-called Remote Procedure Calls (RPC) framework. ArduinoOcpp also implements the specified RPC framework with the required guarantees of message delivery or the corresponding error handling.
+Another part of OCPP is its messaging mechanism, the so-called Remote Procedure Calls (RPC) framework. MicroOcpp also implements the specified RPC framework with the required guarantees of message delivery or the corresponding error handling.
 
-At the lowest layer, OCPP relies on standard WebSockets. ArduinoOcpp works with any WebSocket library and has a lean interface to integrate them.
+At the lowest layer, OCPP relies on standard WebSockets. MicroOcpp works with any WebSocket library and has a lean interface to integrate them.
 
-The high-level API in `ArduinoOcpp.h` bundles all touch points of the EVSE firmware with the OCPP library.
+The high-level API in `MicroOcpp.h` bundles all touch points of the EVSE firmware with the OCPP library.
 
 <p style="text-align:center">
     <img src="../img/components_overview.svg">
@@ -20,7 +20,7 @@ The high-level API in `ArduinoOcpp.h` bundles all touch points of the EVSE firmw
 
 ## High-level OCPP support
 
-Being a full implementation of OCPP, ArduinoOcpp handles the OCPP communication, i.e. it sends OCPP requests and processes incoming OCPP requests autonomously. The messages are triggered by the internal data model and by input from the high-level API. Incoming OCPP requests are used to update the internal data model and if an action on the charger is required, the library signals that to the main firmware through the high-level API.
+Being a full implementation of OCPP, MicroOcpp handles the OCPP communication, i.e. it sends OCPP requests and processes incoming OCPP requests autonomously. The messages are triggered by the internal data model and by input from the high-level API. Incoming OCPP requests are used to update the internal data model and if an action on the charger is required, the library signals that to the main firmware through the high-level API.
 
 In consequence, the high-level API decouples the main firmware from the OCPP communication and hides the operations. This has the following good reasons:
 
@@ -30,54 +30,54 @@ In consequence, the high-level API decouples the main firmware from the OCPP com
 
 ## Customizability
 
-One core principle of the architecture of ArduinoOcpp is the customizability and the selective usage of its components.
+One core principle of the architecture of MicroOcpp is the customizability and the selective usage of its components.
 
-Selective usage of components means that the EVSE firmware can use parts of ArduinoOcpp and work with its own implementation for the rest. In that case only the selected parts of ArduinoOcpp will be compiled into the firmware. For example, the main firmware can use the RPC framework and build a custom implementation of the OCPP logic on top of it. This could be necessary if the OCPP behavior should be tightly coupled to other modules of the firmware. In a different scenario, the EVSE firmware could already contain an extensive RPC framework and the OCPP client should reuse it. Then, only the business logic and high-level API are of interest.
+Selective usage of components means that the EVSE firmware can use parts of MicroOcpp and work with its own implementation for the rest. In that case only the selected parts of MicroOcpp will be compiled into the firmware. For example, the main firmware can use the RPC framework and build a custom implementation of the OCPP logic on top of it. This could be necessary if the OCPP behavior should be tightly coupled to other modules of the firmware. In a different scenario, the EVSE firmware could already contain an extensive RPC framework and the OCPP client should reuse it. Then, only the business logic and high-level API are of interest.
 
 <p style="text-align:center">
     <img src="../img/components_selective.svg">
     <br />
-    <em>Selective usage of ArduinoOcpp</em>
+    <em>Selective usage of MicroOcpp</em>
 </p>
 
-Customizations of the library allow to integrate use cases for which the high-level API is too restrictive. The high-level API is designed to provide a facade for the expected usage of the library, but since the charging sector is driven by innovation, new use cases for OCPP emerge every day. If a custom use case cannot be integrated on the API level, the main firmware can access the internal data structures of ArduinoOcpp and complement the required functionality or replace parts of the internal behavior with custom implementations which fits the concrete scenarios better.
+Customizations of the library allow to integrate use cases for which the high-level API is too restrictive. The high-level API is designed to provide a facade for the expected usage of the library, but since the charging sector is driven by innovation, new use cases for OCPP emerge every day. If a custom use case cannot be integrated on the API level, the main firmware can access the internal data structures of MicroOcpp and complement the required functionality or replace parts of the internal behavior with custom implementations which fits the concrete scenarios better.
 
 ## Main-loop paradigm
 
-ArduinoOcpp works with the common main-loop execution model of microcontrollers. After initialization, the EVSE firmware most likely enters a main-loop and repeats it infinitely. To run ArduinoOcpp, a call to its loop function must be placed into the main loop of the firmware. Then at each main-loop iteration, ArduinoOcpp executes its internal routines, i.e. it processes input data, updates its data model, executes operations and creates new output data. The ArduinoOcpp loop function does not block the main loop but executes immediately. This library does not contain any delay functions. Some activities of the library spread over many loop iterations like the start of a charging session which needs to await the approval of an NFC card and a hardware diagnosis of the high power electronics for example. All activities in ArduinoOcpp support the distribution over many loop calls, leading to a pseudo-parallel execution behavior.
+MicroOcpp works with the common main-loop execution model of microcontrollers. After initialization, the EVSE firmware most likely enters a main-loop and repeats it infinitely. To run MicroOcpp, a call to its loop function must be placed into the main loop of the firmware. Then at each main-loop iteration, MicroOcpp executes its internal routines, i.e. it processes input data, updates its data model, executes operations and creates new output data. The MicroOcpp loop function does not block the main loop but executes immediately. This library does not contain any delay functions. Some activities of the library spread over many loop iterations like the start of a charging session which needs to await the approval of an NFC card and a hardware diagnosis of the high power electronics for example. All activities in MicroOcpp support the distribution over many loop calls, leading to a pseudo-parallel execution behavior.
 
-No separate RTOS task is needed and ArduinoOcpp does not have an internal mechanism for multi-task synchronization. However, it is of course possible to create a dedicated OCPP task, as long as extra care is taken of the synchronization.
+No separate RTOS task is needed and MicroOcpp does not have an internal mechanism for multi-task synchronization. However, it is of course possible to create a dedicated OCPP task, as long as extra care is taken of the synchronization.
 
 ## How the API works
 
 The high-level API consists of four parts:
 
 - **Library lifecycle**: The library has initialize functions with a few initialization options. Dynamic system components like the WebSocket adapter need to be set at initialization time. The deinitialize function reverts the library into an unitialized state. That's useful for memory inspection tools like valgrind or to disable the OCPP communication. The loop function also counts as part of the lifecycle management.
-- **Sensor Inputs**: EVSEs are mechanical systems with a variety of sensor information. OCPP is used to send parts of the sensor readings to the server. The other part of the sensor data flows into the local charger model of ArduinoOcpp where it is further processed. To update ArduinoOcpp with the input data from the sensors, the firmware needs to bind the sensors to the library. An *Input-binding*, or in short *Input*, is a function which transfers the current sensor value to ArduinoOcpp. Inputs are callback functions which read a specific sensor value and pass the value in the return statement. The firmware defines those callback functions for each sensor and adds them to ArduinoOcpp during initialization. After initialization, ArduinoOcpp uses the callbacks and executes them to fetch the most recent sensor values. <br/>
-This concept is reused for the data *Outputs* of the library to the firmware, where the callback applies output data from ArduinoOcpp to the firmware.
-- **Transaction management**: OCPP considers EVSEs as vending machines. To enable payment processing and the billing of the EVSE usage, all charging activity is assigned to transactions. A big portion of OCPP is about transactions, their prerequisites, runtime and their termination scenarios. The ArduinoOcpp API breaks transactions down into an initiation and termination function and gives a transparent view on the current process status, authorization result and offline behavior strategy. For non-commercial setups, the transaction mechanism is the same but has only informational purposes.
-- **Device management**: ArduinoOcpp implements the OCPP side of the device management operations. For the actual execution, the firmware needs to provide the charger-side implementations of the operations to ArduinoOcpp by passing handler functions to the API. For example, the OCPP server can restart the charger. Upon receipt of the request, ArduinoOcpp terminates the transactions and eventually triggers the system restart using the handler function which the firmware has provided through the high-level API.
+- **Sensor Inputs**: EVSEs are mechanical systems with a variety of sensor information. OCPP is used to send parts of the sensor readings to the server. The other part of the sensor data flows into the local charger model of MicroOcpp where it is further processed. To update MicroOcpp with the input data from the sensors, the firmware needs to bind the sensors to the library. An *Input-binding*, or in short *Input*, is a function which transfers the current sensor value to MicroOcpp. Inputs are callback functions which read a specific sensor value and pass the value in the return statement. The firmware defines those callback functions for each sensor and adds them to MicroOcpp during initialization. After initialization, MicroOcpp uses the callbacks and executes them to fetch the most recent sensor values. <br/>
+This concept is reused for the data *Outputs* of the library to the firmware, where the callback applies output data from MicroOcpp to the firmware.
+- **Transaction management**: OCPP considers EVSEs as vending machines. To enable payment processing and the billing of the EVSE usage, all charging activity is assigned to transactions. A big portion of OCPP is about transactions, their prerequisites, runtime and their termination scenarios. The MicroOcpp API breaks transactions down into an initiation and termination function and gives a transparent view on the current process status, authorization result and offline behavior strategy. For non-commercial setups, the transaction mechanism is the same but has only informational purposes.
+- **Device management**: MicroOcpp implements the OCPP side of the device management operations. For the actual execution, the firmware needs to provide the charger-side implementations of the operations to MicroOcpp by passing handler functions to the API. For example, the OCPP server can restart the charger. Upon receipt of the request, MicroOcpp terminates the transactions and eventually triggers the system restart using the handler function which the firmware has provided through the high-level API.
 
 ## Transaction safety
 
 Software in EVSEs needs to withstand hazardous operating conditions. EVSEs are located on the street or in garages where the WiFi or LTE signal strength is often weak, leading to long offline periods or where random power cuts can occur. In addition to that, the lack of process virtualization on microcontrollers means that a malfunction in one part of the firmware leads to the crash of all other parts.
 
-The transaction process of ArduinoOcpp is robust against random failures or resets. A minimal transaction log on the flash storage ensures that each operation on a transaction is fully executed. It will always result in a consistent state between the EVSE and the OCPP server, even over resets of the microcontroller. The RPC queue facilitates this by tracking the delivery status of relevant messages. If the microcontroller is reset while the delivery status of a message is unknown, ArduinoOcpp takes up the message delivery again at the next start up and completes it.
+The transaction process of MicroOcpp is robust against random failures or resets. A minimal transaction log on the flash storage ensures that each operation on a transaction is fully executed. It will always result in a consistent state between the EVSE and the OCPP server, even over resets of the microcontroller. The RPC queue facilitates this by tracking the delivery status of relevant messages. If the microcontroller is reset while the delivery status of a message is unknown, MicroOcpp takes up the message delivery again at the next start up and completes it.
 
 A requirement for the transaction safety feature is the availability of a journaling file system. Examples include LittleFS, SPIFFS and the POSIX file API, but some microcontroller platforms don't support this natively, so an extension would be required.
 
 ## Unit testing
 
-ArduinoOcpp includes a number of unit tests based on the [Catch2](https://github.com/catchorg/Catch2) framework. A [GitHub Action](https://github.com/matth-x/ArduinoOcpp/actions) runs the unit tests against each new commit in the ArduinoOcpp repository, which ensures that new features don't break old code.
+MicroOcpp includes a number of unit tests based on the [Catch2](https://github.com/catchorg/Catch2) framework. A [GitHub Action](https://github.com/matth-x/MicroOcpp/actions) runs the unit tests against each new commit in the MicroOcpp repository, which ensures that new features don't break old code.
 
 The scope of the unit tests is to to ensure a correct implementation of OCPP and to validate the high-level API against its definition. For that, it is not necessary to establish an actual test connection to an OCPP server. In fact, real-world communication would disturb the tests and make them undeterministic. That's why the test suite is fully based on an integrated, tiny OCPP test server which the OCPP client reaches over a loopback connection. The test suite does not access the WebSocket library. When making the unit tests of the main firmware, it is not necessary to check the full OCPP communication, but only to validate correct usage of the high-level API. An example of how the library can be initialized with a loopback connection can be found in its test suite.
 
 ## Microcontroller optimization
 
-As a library for microcontrollers, the design of ArduinoOcpp considers the strict memory limits and complies with the best practices of embedded software development. Also, a few measures were taken to optimize the memory usage which include the spare inclusion of external libraries, an optimization of the internal data structures and the exclusion of C++ run-time type information (RTTI) and exceptions. Features of C++ which may have a larger footprint are carefully used such as the standard template library (STL) and lambda functions. The STL increases the robustness of the code and lambdas prove to be a powerful tool to deal with the complexity of asynchronous data processing in embedded systems. That's also why the high-level API has many functional parameters.
+As a library for microcontrollers, the design of MicroOcpp considers the strict memory limits and complies with the best practices of embedded software development. Also, a few measures were taken to optimize the memory usage which include the spare inclusion of external libraries, an optimization of the internal data structures and the exclusion of C++ run-time type information (RTTI) and exceptions. Features of C++ which may have a larger footprint are carefully used such as the standard template library (STL) and lambda functions. The STL increases the robustness of the code and lambdas prove to be a powerful tool to deal with the complexity of asynchronous data processing in embedded systems. That's also why the high-level API has many functional parameters.
 
-Because of the high importance of C in the embedded world, ArduinoOcpp provides its high-level API in C too. It is typically simple to instruct the compiler to compile and link the C++-based library in a C-based firmware development. In case that the firmware requires custom features which are not part of the C-API, then the firmware can implement it in a new C++ source file, export the new functions to the C namespace and use it normally in the main source.
+Because of the high importance of C in the embedded world, MicroOcpp provides its high-level API in C too. It is typically simple to instruct the compiler to compile and link the C++-based library in a C-based firmware development. In case that the firmware requires custom features which are not part of the C-API, then the firmware can implement it in a new C++ source file, export the new functions to the C namespace and use it normally in the main source.
 
 While memory constraints are of concern, the execution time generally is not. OCPP is rather uncomplex on the algorithmic side for clients, since there is no need for elaborate planning algorithms or complex data transformations.
 
-Although ArduinoOcpp is optimized for the usage on microcontrollers, it is also suitable for embedded Linux systems. With more memory available, the upper limits of the internal data structures can be increased, leading to a more versatile support of charging use cases. Also, the separation of the charger firmware into multiple processes can lead to more robustness. ArduinoOcpp can be extended by an inter-process communication (IPC) interface to run in a separate process.
+Although MicroOcpp is optimized for the usage on microcontrollers, it is also suitable for embedded Linux systems. With more memory available, the upper limits of the internal data structures can be increased, leading to a more versatile support of charging use cases. Also, the separation of the charger firmware into multiple processes can lead to more robustness. MicroOcpp can be extended by an inter-process communication (IPC) interface to run in a separate process.
diff --git a/docs/modules.md b/docs/modules.md
index ed30afd8..5fa0a21b 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -1,10 +1,10 @@
 # Modules
 
-This chapter gives an overview of the class structure of ArduinoOcpp.
+This chapter gives an overview of the class structure of MicroOcpp.
 
 ## Context
 
-The *Context* contains all runtime data of ArduinoOcpp. Every data object which this library creates is stored in the Context instance, except only the Configuration. So it is the basic entry point to the internals of the library. The structure of the context follows the main architecture as described in [this introduction](intro-tech) and consists of the Request queue and message deserializer for the RPC framework and the Model object for the OCPP model and behavior (see below).
+The *Context* contains all runtime data of MicroOcpp. Every data object which this library creates is stored in the Context instance, except only the Configuration. So it is the basic entry point to the internals of the library. The structure of the context follows the main architecture as described in [this introduction](intro-tech) and consists of the Request queue and message deserializer for the RPC framework and the Model object for the OCPP model and behavior (see below).
 
 When the library is initialized, `getOcppContext()` returns the current Context object.
 
@@ -12,7 +12,7 @@ When the library is initialized, `getOcppContext()` returns the current Context
 
 The *Model* represents the OCPP device model and behavior. OCPP defines a rough charger model, i.e. the hardware parts of the charger and their basic functionality in relation to the OCPP operations. Furthermore, OCPP specifies a few only software related features like the reservation of the charger. This charger model is implemented as straightforward C++ data structures and corresponding algorithms.
 
-The implementation of the Model is structured into a top-level Model class and the subordinate Service classes. Each Service class represents a functional block of the OCPP specification and implements the corresponding data structures and functionality. The definition of the functional blocks in ArduinoOcpp is very similar to the feature profiles in OCPP. Only the Core profile is split into multiple functional blocks to keep a smaller module scope.
+The implementation of the Model is structured into a top-level Model class and the subordinate Service classes. Each Service class represents a functional block of the OCPP specification and implements the corresponding data structures and functionality. The definition of the functional blocks in MicroOcpp is very similar to the feature profiles in OCPP. Only the Core profile is split into multiple functional blocks to keep a smaller module scope.
 
 The following list contains the resulting functional blocks:
 
@@ -39,7 +39,7 @@ Every OCPP operation (e.g. Heartbeat, BootNotification) has a dedicated class fo
 
 To send operations to the OCPP server, they must be wrapped into a Request object. The RPC framework and operations are separated modules. While the RPC framework (including the Request class) deals with the messaging mechanism and transfering data to the other OCPP device, operations define the effect on the OCPP model and data structure and execute the desired action. The operation classes inherit from *Operation* which is the interface visible to the Request class.
 
-Incoming messages are unmarshalled using the *OperationRegistry*. During the initialization phase of the library, the Model classes register all supported operations with their name and an instantiator. The instantiator, when executed, provides the Request interpreter with an instance of the corresponding Operation subclasses. It is possible to extend ArduinoOcpp by adding new Operation instantiators to the registry, or to modify the behavior by overriding the default Operation implementations. In addition to that, event handlers can be set which the RPC queue will notify with the payload once operations are sent or received.
+Incoming messages are unmarshalled using the *OperationRegistry*. During the initialization phase of the library, the Model classes register all supported operations with their name and an instantiator. The instantiator, when executed, provides the Request interpreter with an instance of the corresponding Operation subclasses. It is possible to extend MicroOcpp by adding new Operation instantiators to the registry, or to modify the behavior by overriding the default Operation implementations. In addition to that, event handlers can be set which the RPC queue will notify with the payload once operations are sent or received.
 
 ## Configuration
 
@@ -53,4 +53,4 @@ Configurations like the HeartbeatInterval are managed by the *Configuration* mod
 
 If another storage implementation is required (e.g. for syncing with an external configuration manager), then it's possible to add a custom ConfigurationContainer.
 
-In the initialization phase, ArduinoOcpp loads the built-in Configurations with hard-coded factory defaults and a default storage structure. To customize the factory defaults or which ConfigurationContainers will be used, the Configuration module must be initialized before loading the library. To do so, call `configuration_init(...)`. Then the factory defaults can be applied by calling `declareConfiguration<T>(...)` with the desired default value. To use a custom ConfigurationContainer, call `addConfigurationContainer(...)` with the custom implementation. When the library is loaded afterwards, it will use the previously provided Configurations / Containers and create only the data structure which hasn't been set already.
+In the initialization phase, MicroOcpp loads the built-in Configurations with hard-coded factory defaults and a default storage structure. To customize the factory defaults or which ConfigurationContainers will be used, the Configuration module must be initialized before loading the library. To do so, call `configuration_init(...)`. Then the factory defaults can be applied by calling `declareConfiguration<T>(...)` with the desired default value. To use a custom ConfigurationContainer, call `addConfigurationContainer(...)` with the custom implementation. When the library is loaded afterwards, it will use the previously provided Configurations / Containers and create only the data structure which hasn't been set already.
diff --git a/docs/prerequisites.md b/docs/prerequisites.md
index c6ce821b..3abcd786 100644
--- a/docs/prerequisites.md
+++ b/docs/prerequisites.md
@@ -4,30 +4,30 @@ This page explains how to work with this library using the appropriate developme
 
 ## Development tools prerequisites
 
-Throughout these document pages, it is assumed that you already have set up your development environment and that you are familiar with the corresponding building, flashing and (basic) debugging routines. ArduinoOcpp runs in many environments (from the Arduino-IDE to proprietary microcontroller IDEs like the Code Composer Studio). If you do not have any preferences yet, it is highly recommended to get started with VSCode + the PlatformIO add-on, since it is the favorite setup of the community and therefore you find the most related information in the Issues pages of the main repository.
+Throughout these document pages, it is assumed that you already have set up your development environment and that you are familiar with the corresponding building, flashing and (basic) debugging routines. MicroOcpp runs in many environments (from the Arduino-IDE to proprietary microcontroller IDEs like the Code Composer Studio). If you do not have any preferences yet, it is highly recommended to get started with VSCode + the PlatformIO add-on, since it is the favorite setup of the community and therefore you find the most related information in the Issues pages of the main repository.
 
 There are many high-quality tutorials for out there for setting up VSCode + PIO. The following site covers everything you need to know:
 [https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/](https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/)
 
-Once that's done, adding ArduinoOcpp is no big deal anymore. However, let's discuss another very important tool for your project first.
+Once that's done, adding MicroOcpp is no big deal anymore. However, let's discuss another very important tool for your project first.
 
 ## OCPP Server prerequisites
 
-ArduinoOcpp is just a client, but all the magic of OCPP lives in the communication between a client and a server. Although it *is* possible to run ArduinoOcpp without a real server for testing purposes, the best approach for getting started is to get the hands on a real server. So you can always use the client in a practical setup, see immediate results and simplify development a lot.
+MicroOcpp is just a client, but all the magic of OCPP lives in the communication between a client and a server. Although it *is* possible to run MicroOcpp without a real server for testing purposes, the best approach for getting started is to get the hands on a real server. So you can always use the client in a practical setup, see immediate results and simplify development a lot.
 
 Perhaps you were already given access to an OCPP server for your project. Then you can use that, it should work fine. If you don't have a server already, it is highly recommended to get
 SteVe ([https://github.com/steve-community/steve](https://github.com/steve-community/steve)).
 It allows to control every detail of the OCPP operations and shows detail-rich information about the results. And again, it is the favorite test server of the community, so you will find the most related information on the Web. For the installation instructions, please refer to the
 [SteVe docs](https://github.com/steve-community/steve#configuration-and-installation).
 
-In case you can't wait to get started, you can make the first connection test with a WebSocket echo server as a fake OCPP service. ArduinoOcpp supports that: it can send all messages to an echo server which reflects all traffic. ArduinoOcpp gets back its own messages and replies to itself with mocked responses. Complicated, but it does work and the console will show a valid OCPP communication. An example echo server is given in the following section. For the further development though, you will definitely need a real OCPP server.
+In case you can't wait to get started, you can make the first connection test with a WebSocket echo server as a fake OCPP service. MicroOcpp supports that: it can send all messages to an echo server which reflects all traffic. MicroOcpp gets back its own messages and replies to itself with mocked responses. Complicated, but it does work and the console will show a valid OCPP communication. An example echo server is given in the following section. For the further development though, you will definitely need a real OCPP server.
 
 ## Project structure
 
-ArduinoOcpp is a library, i.e. it is not a full firmware, but just solves one specific task in your project which is the OCPP connectivity. The project structure should reflect this: typically you download ArduinoOcpp into a libraries or dependencies subfolder, while the main part of the development takes place in a main source folder. All dependencies of ArduinoOcpp (i.e. ArduinoJson, see the dependencies sections) should be located in the same libraries or dependencies folder.
+MicroOcpp is a library, i.e. it is not a full firmware, but just solves one specific task in your project which is the OCPP connectivity. The project structure should reflect this: typically you download MicroOcpp into a libraries or dependencies subfolder, while the main part of the development takes place in a main source folder. All dependencies of MicroOcpp (i.e. ArduinoJson, see the dependencies sections) should be located in the same libraries or dependencies folder.
 
-When the include paths are correctly set up, you should be able `#include <ArduinoOcpp.h>` at the top of your own source files. This setup keeps the OCPP library source separate from your integration and gives the project a clear structure.
+When the include paths are correctly set up, you should be able `#include <MicroOcpp.h>` at the top of your own source files. This setup keeps the OCPP library source separate from your integration and gives the project a clear structure.
 
 ## Dependency managers
 
-Currently, the PlatformIO dependency manager is supported. In the `platformio.ini` manifest, you can add `matth-x/ArduinoOcpp` to the `lib_deps` section.
+Currently, the PlatformIO dependency manager is supported. In the `platformio.ini` manifest, you can add `matth-x/MicroOcpp` to the `lib_deps` section.
diff --git a/docs/security.md b/docs/security.md
index 2a1864b0..8875b455 100644
--- a/docs/security.md
+++ b/docs/security.md
@@ -1,6 +1,6 @@
 # Security
 
-ArduinoOcpp is designed to be compatible with IoT devices which leads to special considerations regarding cyber security. This section describes the challenges and security concepts of ArduinoOcpp.
+MicroOcpp is designed to be compatible with IoT devices which leads to special considerations regarding cyber security. This section describes the challenges and security concepts of MicroOcpp.
 
 ## Challenges of using microcontrollers in safety-critical environments
 
@@ -15,11 +15,11 @@ Challenge 2) is due to the fact that OCPP uses standard web technology (WebSocke
 
 On the upside, an advantage of microcontrollers is their single purpose usage and thus, reduced complexity. Many security breaches are caused by misconfigured and often even superflous software components (e.g. due to overlooked open ports) which are not a regular part of a microcontroller firmware.
 
-## Security measures of ArduinoOcpp
+## Security measures of MicroOcpp
 
 To address the challenges, the following measures were taken:
 
-- Input sanitazion: ArduinoOcpp only accepts the JSON format for all input. It is validated by ArduinoJson. Every JSON value is checked against the expected format and for conformity with the OCPP specification before using it. The JSON object is discarded immediately after interpretation
+- Input sanitazion: MicroOcpp only accepts the JSON format for all input. It is validated by ArduinoJson. Every JSON value is checked against the expected format and for conformity with the OCPP specification before using it. The JSON object is discarded immediately after interpretation
 - Transaction safety: to address crashes and random reboots of the microcontroller during operation, all activities of the OCPP library are programmed so that they will either be resumed or fully reverted after reboots, preventing inconsistent states. See also [Transaction safety](../intro-tech/#transaction-safety)
 - Careful choice of the dependencies: the mandatory dependency, [ArduinoJson](https://github.com/bblanchon/ArduinoJson), has a test coverage of nearly 100% and is fuzzed. The same goes for the recommended WebSocket library, [Mongoose](https://github.com/cesanta/mongoose). Both projects are very relevant in their field with over 6k and 9k stars on GitHub
 
@@ -32,15 +32,15 @@ Two further measures would be beneficial and could be requested via support requ
 
 As a general rule, the communication controller which is exposed to the internet shouldn't be used for safety-critical tasks on the charging hardware. That's because the networking stack is a very complex piece of software which very likely still has open bugs which can crash the controller despite all the effort to improve it. Safety-critical tasks on the charging hardware shouldn't rely on a controller which could crash at any time because of incoming network traffic. To mitigate this, either the OCPP library and internet functionality should be placed onto a separate chip, or the most vital safety functionality should get a dedicated controller.
 
-The recommended [Mongoose WebSocket adapter for ArduinoOcpp](https://github.com/matth-x/ArduinoOcppMongoose) supports the OCPP Security Profile 2 (TLS with Basic Authentication) and needs to be provided with the necessary TLS certificate.
+The recommended [Mongoose WebSocket adapter for MicroOcpp](https://github.com/matth-x/MicroOcppMongoose) supports the OCPP Security Profile 2 (TLS with Basic Authentication) and needs to be provided with the necessary TLS certificate.
 
-Most IoT-controllers have built-in mechanisms to ensure the authenticity of their firmware. For example, the Espressif32 supports [Secure Boot](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/secure-boot-v2.html) which is a signature verification of the installed firmware before that firmware is executed. Many platforms also have a built-in signature verification for incoming OTA firmware updates. To prove the authenticity of the charger to the OCPP server, it is also important to keep the WebSocket key secret by [encrypting the flash memory](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/flash-encryption.html). These security mechanisms heavily depend on the host controller which runs ArduinoOcpp. It is the responsibility of the main firmware to make proper use of them.
+Most IoT-controllers have built-in mechanisms to ensure the authenticity of their firmware. For example, the Espressif32 supports [Secure Boot](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/secure-boot-v2.html) which is a signature verification of the installed firmware before that firmware is executed. Many platforms also have a built-in signature verification for incoming OTA firmware updates. To prove the authenticity of the charger to the OCPP server, it is also important to keep the WebSocket key secret by [encrypting the flash memory](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/flash-encryption.html). These security mechanisms heavily depend on the host controller which runs MicroOcpp. It is the responsibility of the main firmware to make proper use of them.
 
 ## OCPP Security Whitepaper and ISO 15118
 
-With ArduinoOcpp, the recommended way of handling certificates on microcontrollers is to compile them into the firmware binary and to rely on the built-in firmware signature checks of the host microcontroller platform. This lean approach results in a smaller attack vector compared to establishing a separate infrastructure for the server- and firmware certificate. It can be assumed that the OTA functionality of the microcontrollers is thoroughly tested and consequently, reaching a comparable level of robustness would require much effort.
+With MicroOcpp, the recommended way of handling certificates on microcontrollers is to compile them into the firmware binary and to rely on the built-in firmware signature checks of the host microcontroller platform. This lean approach results in a smaller attack vector compared to establishing a separate infrastructure for the server- and firmware certificate. It can be assumed that the OTA functionality of the microcontrollers is thoroughly tested and consequently, reaching a comparable level of robustness would require much effort.
 
-In case the certificate handling mechanism of the Security Whitepaper is preferred, then the EVSE vendor needs to implement it via a custom extension. Unfortunately, this mechanism hasn't been requested yet and is not natively supported by ArduinoOcpp yet. The new custom operations can be implemented by extending the class `Operation`. A handler for incoming messages can be registered via `OperationRegistry::registerOperation(...)`. To send custom messages to the server, use `Context::initiateRequest(...)`.
+In case the certificate handling mechanism of the Security Whitepaper is preferred, then the EVSE vendor needs to implement it via a custom extension. Unfortunately, this mechanism hasn't been requested yet and is not natively supported by MicroOcpp yet. The new custom operations can be implemented by extending the class `Operation`. A handler for incoming messages can be registered via `OperationRegistry::registerOperation(...)`. To send custom messages to the server, use `Context::initiateRequest(...)`.
 
 A further challenge for microcontrollers is the relatively low processor speed which becomes relevant for a potential ISO 15118 integration. Some incoming message types (`AuthorizationReq` and `MeteringReceiptReq`) include a signature which needs to be verified on the communications controller of the EVSE. Moreover, messages in the ISO 15118 V2G protocol have a maximum round trip time (which is 2 seconds for the message types in question) and so the signature verification is time-contrained. [These benchmarks](https://web.archive.org/web/20230724184529/https://www.oryx-embedded.com/benchmark/espressif/crypto-esp32.html) for the Espressif32 show that for some signature algorithms, the verification time can get close or exceed the timing requirements of ISO 15118 if done on the processor only. As a consequence, hardware acceleration by the crypto-core is mandatory to ensure a robust communication between the EVSE and EV. Before making a communications controller with ISO 15118 support, the performance of the host controller should be benchmarked and checked against the requirements.
 
diff --git a/examples/ESP-IDF/CMakeLists.txt b/examples/ESP-IDF/CMakeLists.txt
index 5358fdcb..bc4961b6 100644
--- a/examples/ESP-IDF/CMakeLists.txt
+++ b/examples/ESP-IDF/CMakeLists.txt
@@ -3,6 +3,6 @@
 cmake_minimum_required(VERSION 3.5)
 
 include($ENV{IDF_PATH}/tools/cmake/project.cmake)
-project(ao_example)
+project(mo_example)
 
-idf_build_set_property(COMPILE_OPTIONS -DAO_TRAFFIC_OUT APPEND)
+idf_build_set_property(COMPILE_OPTIONS -DMOCPP_TRAFFIC_OUT APPEND)
diff --git a/examples/ESP-IDF/Makefile b/examples/ESP-IDF/Makefile
index 3ad0575f..e6da8227 100644
--- a/examples/ESP-IDF/Makefile
+++ b/examples/ESP-IDF/Makefile
@@ -3,6 +3,6 @@
 # project subdirectory.
 #
 
-PROJECT_NAME := ao_example
+PROJECT_NAME := mo_example
 
 include $(IDF_PATH)/make/project.mk
diff --git a/examples/ESP-IDF/README.md b/examples/ESP-IDF/README.md
index 1b8fc17e..b735ce89 100644
--- a/examples/ESP-IDF/README.md
+++ b/examples/ESP-IDF/README.md
@@ -1,6 +1,6 @@
 # ESP-IDF integration example
 
-To run ArduinoOcpp on the ESP-IDF platform, please take this example as the starting point. It is widely based on the [Wi-Fi Station Example](https://github.com/espressif/esp-idf/tree/release/v4.4/examples/wifi/getting_started/station) of Espressif. This example works with the ESP-IDF version `4.4`. For a general guide how to setup and use the ESP-IDF, please refer to the documentation of Espressif.
+To run MicroOcpp on the ESP-IDF platform, please take this example as the starting point. It is widely based on the [Wi-Fi Station Example](https://github.com/espressif/esp-idf/tree/release/v4.4/examples/wifi/getting_started/station) of Espressif. This example works with the ESP-IDF version `4.4`. For a general guide how to setup and use the ESP-IDF, please refer to the documentation of Espressif.
 
 ## Setup guide
 
@@ -8,9 +8,9 @@ To run ArduinoOcpp on the ESP-IDF platform, please take this example as the star
 
 Please clone the following repositories into the respective components-directories:
 
-- [ArduinoOcpp](https://github.com/matth-x/ArduinoOcpp) into `components/ArduinoOcpp`
+- [MicroOcpp](https://github.com/matth-x/MicroOcpp) into `components/MicroOcpp`
 - [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf) into `components/mongoose`
-- [Mongoose adapter for ArduinoOcpp](https://github.com/matth-x/AOcppMongoose) into `components/ArduinoOcppMongoose`
+- [Mongoose adapter for MicroOcpp](https://github.com/matth-x/MicroOcppMongoose) into `components/MicroOcppMongoose`
 - [ArduinoJson](https://github.com/bblanchon/ArduinoJson) into `components/ArduinoJson`
 
 Alternatively, ArduinoJson can go into into an include folder as it is a header-only library:
@@ -21,20 +21,20 @@ For setup, the following commands could come handy (change to the root directory
 
 ```
 rm components/mongoose/.gitkeep
-rm components/ArduinoOcpp/.gitkeep
-rm components/AOcppMongoose/.gitkeep
-git clone https://github.com/matth-x/ArduinoOcpp components/ArduinoOcpp
+rm components/MicroOcpp/.gitkeep
+rm components/MicroOcppMongoose/.gitkeep
+git clone https://github.com/matth-x/MicroOcpp components/MicroOcpp
 git clone --recurse-submodules https://github.com/cesanta/mongoose-esp-idf.git components/mongoose
-git clone https://github.com/matth-x/AOcppMongoose components/AOcppMongoose
+git clone https://github.com/matth-x/MicroOcppMongoose components/MicroOcppMongoose
 git clone https://github.com/bblanchon/ArduinoJson
 ```
 
 The setup is done if the following include statements work:
 
 ```cpp
-#include <ArduinoOcpp.h>
+#include <MicroOcpp.h>
 #include <mongoose.h>
-#include <ArduinoOcppMongooseClient.h>
+#include <MicroOcppMongooseClient.h>
 #include <ArduinoJson.h>
 ```
 
diff --git a/examples/ESP-IDF/components/README.md b/examples/ESP-IDF/components/README.md
index 9ea00832..67d997d3 100644
--- a/examples/ESP-IDF/components/README.md
+++ b/examples/ESP-IDF/components/README.md
@@ -2,9 +2,9 @@
 
 The ESP-IDF integration requires at least the following components:
 
-- [ArduinoOcpp](https://github.com/matth-x/ArduinoOcpp)
+- [MicroOcpp](https://github.com/matth-x/MicroOcpp)
 - [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf)
-- [Mongoose adapter for ArduinoOcpp](https://github.com/matth-x/AOcppMongoose)
+- [Mongoose adapter for MicroOcpp](https://github.com/matth-x/MicroOcppMongoose)
 - [ArduinoJson](https://github.com/bblanchon/ArduinoJson)
 
 This example only provides the folder structure. You need to clone every project into it in order to run the example.
diff --git a/examples/ESP-IDF/main/Kconfig.projbuild b/examples/ESP-IDF/main/Kconfig.projbuild
index 420f3095..1bc06e45 100644
--- a/examples/ESP-IDF/main/Kconfig.projbuild
+++ b/examples/ESP-IDF/main/Kconfig.projbuild
@@ -18,19 +18,19 @@ menu "Example Configuration"
         help
             Set the Maximum retry to avoid station reconnecting to the AP unlimited when the AP is really inexistent.
     
-    config AO_OCPP_BACKEND
+    config MOCPP_OCPP_BACKEND
         string "OCPP backend URL"
         default "ws://echo.websocket.events/"
         help
             URL of the OCPP backend
     
-    config AO_CHARGEBOXID
+    config MOCPP_CHARGEBOXID
         string "ChargeBoxId"
         default ""
         help
             ChargeBoxId as it appears in the WebSocket connection URL
 
-    config AO_AUTHORIZATIONKEY
+    config MOCPP_AUTHORIZATIONKEY
         string "Authorization Key"
         default ""
         help
diff --git a/examples/ESP-IDF/main/main.c b/examples/ESP-IDF/main/main.c
index 4d39eca3..60e6e355 100644
--- a/examples/ESP-IDF/main/main.c
+++ b/examples/ESP-IDF/main/main.c
@@ -16,10 +16,10 @@
 #include "lwip/err.h"
 #include "lwip/sys.h"
 
-/* ArduinoOcpp includes */
+/* MicroOcpp includes */
 #include <mongoose.h>
-#include <ArduinoOcpp_c.h> //C-facade of ArduinoOcpp
-#include <ArduinoOcppMongooseClient_c.h> //WebSocket integration for ESP-IDF
+#include <MicroOcpp_c.h> //C-facade of MicroOcpp
+#include <MicroOcppMongooseClient_c.h> //WebSocket integration for ESP-IDF
 
 /* The examples use WiFi configuration that you can set via project configuration menu
 
@@ -29,9 +29,9 @@
 #define EXAMPLE_ESP_WIFI_SSID      CONFIG_ESP_WIFI_SSID
 #define EXAMPLE_ESP_WIFI_PASS      CONFIG_ESP_WIFI_PASSWORD
 #define EXAMPLE_ESP_MAXIMUM_RETRY  CONFIG_ESP_MAXIMUM_RETRY
-#define EXAMPLE_AO_OCPP_BACKEND    CONFIG_AO_OCPP_BACKEND
-#define EXAMPLE_AO_CHARGEBOXID     CONFIG_AO_CHARGEBOXID
-#define EXAMPLE_AO_AUTHORIZATIONKEY CONFIG_AO_AUTHORIZATIONKEY
+#define EXAMPLE_MOCPP_OCPP_BACKEND    CONFIG_MOCPP_OCPP_BACKEND
+#define EXAMPLE_MOCPP_CHARGEBOXID     CONFIG_MOCPP_CHARGEBOXID
+#define EXAMPLE_MOCPP_AUTHORIZATIONKEY CONFIG_MOCPP_AUTHORIZATIONKEY
 
 /* FreeRTOS event group to signal when we are connected*/
 static EventGroupHandle_t s_wifi_event_group;
@@ -148,29 +148,29 @@ void app_main(void)
     ESP_LOGI(TAG, "ESP_WIFI_MODE_STA");
     wifi_init_sta();
 
-    /* Initialize Mongoose (necessary for ArduinoOcpp)*/
+    /* Initialize Mongoose (necessary for MicroOcpp)*/
     struct mg_mgr mgr;        // Event manager
     mg_mgr_init(&mgr);        // Initialise event manager
     mg_log_set(MG_LL_DEBUG);  // Set log level
 
-    /* Initialize ArduinoOcpp */
-    struct AO_FilesystemOpt fsopt = { .use = true, .mount = true, .formatFsOnFail = true};
+    /* Initialize MicroOcpp */
+    struct OCPP_FilesystemOpt fsopt = { .use = true, .mount = true, .formatFsOnFail = true};
 
-    AO_Connection *osock = ao_makeConnection(&mgr,
-            EXAMPLE_AO_OCPP_BACKEND, 
-            EXAMPLE_AO_CHARGEBOXID, 
-            EXAMPLE_AO_AUTHORIZATIONKEY, "", fsopt);
-    ao_initialize(osock, "ESP-IDF charger", "Your brand name here", fsopt);
+    OCPP_Connection *osock = ocpp_makeConnection(&mgr,
+            EXAMPLE_MOCPP_OCPP_BACKEND, 
+            EXAMPLE_MOCPP_CHARGEBOXID, 
+            EXAMPLE_MOCPP_AUTHORIZATIONKEY, "", fsopt);
+    ocpp_initialize(osock, "ESP-IDF charger", "Your brand name here", fsopt);
 
     /* Enter infinite loop */
     while (1) {
         mg_mgr_poll(&mgr, 10);
-        ao_loop();
+        ocpp_loop();
     }
     
     /* Deallocate ressources */
-    ao_deinitialize();
-    ao_deinitConnection(osock);
+    ocpp_deinitialize();
+    ocpp_deinitConnection(osock);
     mg_mgr_free(&mgr);
     return;
 }
diff --git a/examples/ESP-IDF/partitions.csv b/examples/ESP-IDF/partitions.csv
index d521f8bf..a9ab150b 100644
--- a/examples/ESP-IDF/partitions.csv
+++ b/examples/ESP-IDF/partitions.csv
@@ -4,4 +4,4 @@ otadata,  data, ota,     ,        0x2000,
 phy_init, data, phy,     ,        0x1000,
 ota_0,    app,  ota_0,   ,        0x190000,
 ota_1,    app,  ota_1,   ,        0x190000,
-ao,       data, spiffs,  ,        0xD0000,
\ No newline at end of file
+mo,       data, spiffs,  ,        0xD0000,
\ No newline at end of file
diff --git a/examples/ESP-IDF/sdkconfig b/examples/ESP-IDF/sdkconfig
index 4e8f5df7..1cab0a8c 100644
--- a/examples/ESP-IDF/sdkconfig
+++ b/examples/ESP-IDF/sdkconfig
@@ -137,9 +137,9 @@ CONFIG_PARTITION_TABLE_MD5=y
 CONFIG_ESP_WIFI_SSID="myssid"
 CONFIG_ESP_WIFI_PASSWORD="mypassword"
 CONFIG_ESP_MAXIMUM_RETRY=5
-CONFIG_AO_OCPP_BACKEND="ws://echo.websocket.events/"
-CONFIG_AO_CHARGEBOXID=""
-CONFIG_AO_AUTHORIZATIONKEY=""
+CONFIG_MOCPP_OCPP_BACKEND="ws://echo.websocket.events/"
+CONFIG_MOCPP_CHARGEBOXID=""
+CONFIG_MOCPP_AUTHORIZATIONKEY=""
 # end of Example Configuration
 
 #
diff --git a/examples/ESP-TLS/main.cpp b/examples/ESP-TLS/main.cpp
index be9deb19..5a4a6d74 100644
--- a/examples/ESP-TLS/main.cpp
+++ b/examples/ESP-TLS/main.cpp
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -13,8 +13,8 @@ ESP8266WiFiMulti WiFiMulti;
 #error only ESP32 or ESP8266 supported at the moment
 #endif
 
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/Connection.h> //need for setting TLS credentials
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h> //need for setting TLS credentials
 
 #define STASSID  "YOUR_WIFI_SSID"
 #define STAPSK   "YOUR_WIFI_PW"
@@ -66,7 +66,7 @@ emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
 )EOF";
 
 WebSocketsClient wsockSecure {};
-ArduinoOcpp::EspWiFi::WSClient osockSecure {&wsockSecure};
+MicroOcpp::EspWiFi::WSClient osockSecure {&wsockSecure};
 
 void setup() {
 
@@ -118,10 +118,10 @@ void setup() {
     wsockSecure.enableHeartbeat(15000, 3000, 2);
     wsockSecure.setAuthorization(OCPP_AUTH_ID, OCPP_AUTH_KEY); // => Authorization: Basic QUwxMDAwOgABAgMEBQYH////////////////
     
-    ocpp_initialize(osockSecure, ChargerCredentials("My Charging Station", "My company name"));
+    mocpp_initialize(osockSecure, ChargerCredentials("My Charging Station", "My company name"));
 
     /*
-     * ... see ArduinoOcpp.h for how to integrate the EVSE hardware.
+     * ... see MicroOcpp.h for how to integrate the EVSE hardware.
      *
      * This example only showcases the TLS connection. For examples about the HW integration,
      * please see the other examples
@@ -133,7 +133,7 @@ void loop() {
     /*
      * Execute all charge point routines and handle WebSocket
      */
-    ocpp_loop();
+    mocpp_loop();
 
-    //... see ArduinoOcpp.h and the other examples for how to integrate the EVSE hardware.
+    //... see MicroOcpp.h and the other examples for how to integrate the EVSE hardware.
 }
diff --git a/examples/ESP/main.cpp b/examples/ESP/main.cpp
index 9aeee3fd..1e47c7c7 100644
--- a/examples/ESP/main.cpp
+++ b/examples/ESP/main.cpp
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -13,7 +13,7 @@ ESP8266WiFiMulti WiFiMulti;
 #error only ESP32 or ESP8266 supported at the moment
 #endif
 
-#include <ArduinoOcpp.h>
+#include <MicroOcpp.h>
 
 #define STASSID "YOUR_WIFI_SSID"
 #define STAPSK  "YOUR_WIFI_PW"
@@ -60,7 +60,7 @@ void setup() {
     /*
      * Initialize the OCPP library
      */
-    ocpp_initialize(OCPP_HOST, OCPP_PORT, OCPP_URL, "My Charging Station", "My company name");
+    mocpp_initialize(OCPP_HOST, OCPP_PORT, OCPP_URL, "My Charging Station", "My company name");
 
     /*
      * Integrate OCPP functionality. You can leave out the following part if your EVSE doesn't need it.
@@ -80,7 +80,7 @@ void setup() {
         return false;
     });
 
-    //... see ArduinoOcpp.h for more settings
+    //... see MicroOcpp.h for more settings
 }
 
 void loop() {
@@ -88,7 +88,7 @@ void loop() {
     /*
      * Do all OCPP stuff (process WebSocket input, send recorded meter values to Central System, etc.)
      */
-    ocpp_loop();
+    mocpp_loop();
 
     /*
      * Energize EV plug if OCPP transaction is up and running
@@ -136,5 +136,5 @@ void loop() {
         }
     }
 
-    //... see ArduinoOcpp.h for more possibilities
+    //... see MicroOcpp.h for more possibilities
 }
diff --git a/library.json b/library.json
index 23e5fc3d..f6a1613c 100644
--- a/library.json
+++ b/library.json
@@ -1,12 +1,12 @@
 {
-    "name": "ArduinoOcpp",
+    "name": "MicroOcpp",
     "version": "0.3.0",
     "description": "OCPP 1.6 Client for the ESP8266 and ESP32",
     "keywords": "OCPP, 1.6, OCPP 1.6, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, EVSE, Charge Point",
     "repository":
     {
         "type": "git",
-        "url": "https://github.com/matth-x/ArduinoOcpp/"
+        "url": "https://github.com/matth-x/MicroOcpp/"
     },
     "authors":
     [
diff --git a/library.properties b/library.properties
index 5b7df003..451b466e 100644
--- a/library.properties
+++ b/library.properties
@@ -1,9 +1,9 @@
-name=ArduinoOcpp
+name=MicroOcpp
 version=0.3.0
 author=Matthias Akstaller
 maintainer=Matthias Akstaller
 sentence=OCPP 1.6 Client for the ESP8266 and ESP32 (more coming soon)
 paragraph=
 category=Communication
-url=https://github.com/matth-x/ArduinoOcpp/
+url=https://github.com/matth-x/MicroOcpp/
 architectures=espressif8266, espressif32
diff --git a/mkdocs.yml b/mkdocs.yml
index 50025440..2f047d41 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,4 +1,4 @@
-site_name: ArduinoOcpp docs
+site_name: MicroOcpp docs
 
 theme:
   name: material
diff --git a/platformio.ini b/platformio.ini
index e5c55973..9af4a05c 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -1,4 +1,4 @@
-; matth-x/ArduinoOcpp
+; matth-x/MicroOcpp
 ; Copyright Matthias Akstaller 2019 - 2023
 ; MIT License
 
@@ -19,8 +19,8 @@ framework = ${common.framework}
 lib_deps = ${common.lib_deps}
 monitor_speed = ${common.monitor_speed}
 build_flags =
-    -D AO_DBG_LEVEL=AO_DL_INFO ; flood the serial monitor with information about the internal state
-    -DAO_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
+    -D MOCPP_DBG_LEVEL=MOCPP_DL_INFO ; flood the serial monitor with information about the internal state
+    -DMOCPP_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
     -D ARDUINOJSON_ENABLE_STD_STRING=1
 
 [env:esp32-development-board]
@@ -30,7 +30,7 @@ framework = ${common.framework}
 lib_deps = ${common.lib_deps}
 monitor_speed = ${common.monitor_speed}
 build_flags =
-    -D AO_DBG_LEVEL=AO_DL_INFO ; flood the serial monitor with information about the internal state
-    -DAO_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
+    -D MOCPP_DBG_LEVEL=MOCPP_DL_INFO ; flood the serial monitor with information about the internal state
+    -DMOCPP_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
 board_build.partitions = min_spiffs.csv
 upload_speed = 921600
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 89f9f2ac..e30df97a 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -1,38 +1,38 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include "ArduinoOcpp.h"
-
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Metering/MeteringService.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h>
-#include <ArduinoOcpp/Model/Heartbeat/HeartbeatService.h>
-#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
-#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Model/Boot/BootService.h>
-#include <ArduinoOcpp/Model/Reset/ResetService.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Core/OperationRegistry.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-
-#include <ArduinoOcpp/Operations/Authorize.h>
-#include <ArduinoOcpp/Operations/StartTransaction.h>
-#include <ArduinoOcpp/Operations/StopTransaction.h>
-#include <ArduinoOcpp/Operations/CustomOperation.h>
-
-#include <ArduinoOcpp/Debug.h>
-
-namespace ArduinoOcpp {
+#include "MicroOcpp.h"
+
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Metering/MeteringService.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h>
+#include <MicroOcpp/Model/Heartbeat/HeartbeatService.h>
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
+#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Model/Reservation/ReservationService.h>
+#include <MicroOcpp/Model/Boot/BootService.h>
+#include <MicroOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/OperationRegistry.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+
+#include <MicroOcpp/Operations/Authorize.h>
+#include <MicroOcpp/Operations/StartTransaction.h>
+#include <MicroOcpp/Operations/StopTransaction.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+
+#include <MicroOcpp/Debug.h>
+
+namespace MicroOcpp {
 namespace Facade {
 
-#ifndef AO_CUSTOM_WS
+#ifndef MOCPP_CUSTOM_WS
 WebSocketsClient *webSocket {nullptr};
 Connection *connection {nullptr};
 #endif
@@ -40,24 +40,24 @@ Connection *connection {nullptr};
 Context *context {nullptr};
 std::shared_ptr<FilesystemAdapter> filesystem;
 
-#ifndef AO_NUMCONNECTORS
-#define AO_NUMCONNECTORS 2
+#ifndef MOCPP_NUMCONNECTORS
+#define MOCPP_NUMCONNECTORS 2
 #endif
 
 #define OCPP_ID_OF_CP 0
 #define OCPP_ID_OF_CONNECTOR 1
 
-} //end namespace ArduinoOcpp::Facade
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp::Facade
+} //end namespace MicroOcpp
 
-using namespace ArduinoOcpp;
-using namespace ArduinoOcpp::Facade;
-using namespace ArduinoOcpp::Ocpp16;
+using namespace MicroOcpp;
+using namespace MicroOcpp::Facade;
+using namespace MicroOcpp::Ocpp16;
 
-#ifndef AO_CUSTOM_WS
-void ocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt, const char *login, const char *password, const char *CA_cert) {
+#ifndef MOCPP_CUSTOM_WS
+void mocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt, const char *login, const char *password, const char *CA_cert) {
     if (context) {
-        AO_DBG_WARN("Can't be called two times. Either restart ESP, or call ocpp_deinitialize() before");
+        MOCPP_DBG_WARN("Can't be called two times. Either restart ESP, or call mocpp_deinitialize() before");
         return;
     }
 
@@ -92,7 +92,7 @@ void ocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_u
     delete connection;
     connection = new EspWiFi::WSClient(webSocket);
 
-    ocpp_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), makeDefaultFilesystemAdapter(fsOpt));
+    mocpp_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), makeDefaultFilesystemAdapter(fsOpt));
 }
 #endif
 
@@ -119,36 +119,36 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
         creds["meterType"] = meterType;
     
     if (creds.overflowed()) {
-        AO_DBG_ERR("Charger Credentials too long");
+        MOCPP_DBG_ERR("Charger Credentials too long");
     }
 
     size_t written = serializeJson(creds, payload, 512);
 
     if (written < 2) {
-        AO_DBG_ERR("Charger Credentials could not be written");
+        MOCPP_DBG_ERR("Charger Credentials could not be written");
         sprintf(payload, "{}");
     }
 }
 
-void ocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs) {
+void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs) {
     if (context) {
-        AO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call ocpp_deinitialize() before");
+        MOCPP_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call mocpp_deinitialize() before");
         return;
     }
 
     filesystem = fs;
-    AO_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "deactivated");
+    MOCPP_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "deactivated");
 
     BootStats bootstats;
     BootService::loadBootStats(filesystem, bootstats);
 
     if (bootstats.getBootFailureCount() > 3) {
-        AO_DBG_ERR("multiple initialization failures detected");
+        MOCPP_DBG_ERR("multiple initialization failures detected");
         if (filesystem) {
             bool success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
                 return strcmp(fname, "ocpp-creds.jsn");
             });
-            AO_DBG_ERR("clear local state folder (except WS creds): %s", success ? "success" : "not completed");
+            MOCPP_DBG_ERR("clear local state folder (except WS creds): %s", success ? "success" : "not completed");
 
             bootstats = BootStats();
         }
@@ -163,13 +163,13 @@ void ocpp_initialize(Connection& connection, const char *bootNotificationCredent
     auto& model = context->getModel();
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
-        new TransactionStore(AO_NUMCONNECTORS, filesystem)));
+        new TransactionStore(MOCPP_NUMCONNECTORS, filesystem)));
     model.setBootService(std::unique_ptr<BootService>(
         new BootService(*context, filesystem)));
     model.setConnectorsCommon(std::unique_ptr<ConnectorsCommon>(
-        new ConnectorsCommon(*context, AO_NUMCONNECTORS, filesystem)));
+        new ConnectorsCommon(*context, MOCPP_NUMCONNECTORS, filesystem)));
     std::vector<Connector> connectors;
-    for (unsigned int connectorId = 0; connectorId < AO_NUMCONNECTORS; connectorId++) {
+    for (unsigned int connectorId = 0; connectorId < MOCPP_NUMCONNECTORS; connectorId++) {
         connectors.push_back(Connector(*context, connectorId));
     }
     model.setConnectors(std::move(connectors));
@@ -178,11 +178,11 @@ void ocpp_initialize(Connection& connection, const char *bootNotificationCredent
     model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
         new AuthorizationService(*context, filesystem)));
     model.setReservationService(std::unique_ptr<ReservationService>(
-        new ReservationService(*context, AO_NUMCONNECTORS)));
+        new ReservationService(*context, MOCPP_NUMCONNECTORS)));
     model.setResetService(std::unique_ptr<ResetService>(
         new ResetService(*context)));
 
-#if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+#if !defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
         EspWiFi::makeFirmwareService(*context))); //instantiate FW service + ESP installation routine
 #else
@@ -190,7 +190,7 @@ void ocpp_initialize(Connection& connection, const char *bootNotificationCredent
         new FirmwareService(*context))); //only instantiate FW service
 #endif
 
-#if !defined(AO_CUSTOM_DIAGNOSTICS) && !defined(AO_CUSTOM_WS)
+#if !defined(MOCPP_CUSTOM_DIAGNOSTICS) && !defined(MOCPP_CUSTOM_WS)
     model.setDiagnosticsService(std::unique_ptr<DiagnosticsService>(
         EspWiFi::makeDiagnosticsService(*context))); //will only return "Rejected" because client needs to implement logging
 #else
@@ -198,7 +198,7 @@ void ocpp_initialize(Connection& connection, const char *bootNotificationCredent
         new DiagnosticsService(*context)));
 #endif
 
-#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
     if (!model.getResetService()->getExecuteReset())
         model.getResetService()->setExecuteReset(makeDefaultResetFn());
 #endif
@@ -212,14 +212,14 @@ void ocpp_initialize(Connection& connection, const char *bootNotificationCredent
     credsJson.reset();
 }
 
-void ocpp_deinitialize() {
+void mocpp_deinitialize() {
 
     if (context) {
         //release bootstats recovery mechanism
         BootStats bootstats;
         BootService::loadBootStats(filesystem, bootstats);
         if (bootstats.lastBootSuccess != bootstats.bootNr) {
-            AO_DBG_DEBUG("boot success timer override");
+            MOCPP_DBG_DEBUG("boot success timer override");
             bootstats.lastBootSuccess = bootstats.bootNr;
             BootService::storeBootStats(filesystem, bootstats);
         }
@@ -228,7 +228,7 @@ void ocpp_deinitialize() {
     delete context;
     context = nullptr;
 
-#ifndef AO_CUSTOM_WS
+#ifndef MOCPP_CUSTOM_WS
     delete connection;
     connection = nullptr;
     delete webSocket;
@@ -240,9 +240,9 @@ void ocpp_deinitialize() {
     configuration_deinit();
 }
 
-void ocpp_loop() {
+void mocpp_loop() {
     if (!context) {
-        AO_DBG_WARN("Please call ocpp_initialize before");
+        MOCPP_DBG_WARN("Please call mocpp_initialize before");
         return;
     }
 
@@ -251,16 +251,16 @@ void ocpp_loop() {
 
 std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        MOCPP_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return nullptr;
     }
 
@@ -269,17 +269,17 @@ std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int co
 
 std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX ||
         (parentIdTag && strnlen(parentIdTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX)) {
-        AO_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        MOCPP_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return nullptr;
     }
     
@@ -288,12 +288,12 @@ std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, cons
 
 bool endTransaction(const char *idTag, const char *reason, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     auto res = isTransactionActive(connectorId);
@@ -303,12 +303,12 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
 
 bool isTransactionActive(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     auto& tx = connector->getTransaction();
@@ -317,12 +317,12 @@ bool isTransactionActive(unsigned int connectorId) {
 
 bool isTransactionRunning(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     auto& tx = connector->getTransaction();
@@ -331,41 +331,41 @@ bool isTransactionRunning(unsigned int connectorId) {
 
 const char *getTransactionIdTag(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return nullptr;
     }
     auto& tx = connector->getTransaction();
     return tx ? tx->getIdTag() : nullptr;
 }
 
-std::shared_ptr<Transaction> ao_undefinedTx;
+std::shared_ptr<Transaction> mocpp_undefinedTx;
 
 std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_WARN("Please call ocpp_initialize before");
-        return ao_undefinedTx;
+        MOCPP_DBG_WARN("Please call mocpp_initialize before");
+        return mocpp_undefinedTx;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
-        return ao_undefinedTx;
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        return mocpp_undefinedTx;
     }
     return connector->getTransaction();
 }
 
 bool ocppPermitsCharge(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_WARN("Please call ocpp_initialize before");
+        MOCPP_DBG_WARN("Please call mocpp_initialize before");
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     return connector->ocppPermitsCharge();
@@ -373,32 +373,32 @@ bool ocppPermitsCharge(unsigned int connectorId) {
 
 void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setConnectorPluggedInput(pluggedInput);
 
     if (pluggedInput) {
-        AO_DBG_INFO("Added ConnectorPluggedInput. Transaction-management is in auto mode now");
+        MOCPP_DBG_INFO("Added ConnectorPluggedInput. Transaction-management is in auto mode now");
     } else {
-        AO_DBG_INFO("Reset ConnectorPluggedInput. Transaction-management is in manual mode now");
+        MOCPP_DBG_INFO("Reset ConnectorPluggedInput. Transaction-management is in manual mode now");
     }
 }
 
 void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*context, AO_NUMCONNECTORS, filesystem)));
+            new MeteringService(*context, MOCPP_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Energy.Active.Import.Register");
@@ -413,14 +413,14 @@ void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connec
 
 void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
 
     auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*context, AO_NUMCONNECTORS, filesystem)));
+            new MeteringService(*context, MOCPP_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Power.Active.Import");
@@ -435,11 +435,11 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
 
 void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
 
@@ -462,11 +462,11 @@ void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput,
 
 void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
 
@@ -489,18 +489,18 @@ void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutpu
 
 void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
 
     auto& model = context->getModel();
     if (!model.getSmartChargingService() && chargingLimitOutput) {
         model.setSmartChargingService(std::unique_ptr<SmartChargingService>(
-            new SmartChargingService(*context, filesystem, AO_NUMCONNECTORS)));
+            new SmartChargingService(*context, filesystem, MOCPP_NUMCONNECTORS)));
     }
 
     if (auto scService = context->getModel().getSmartChargingService()) {
@@ -515,12 +515,12 @@ void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOu
 
 void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setEvReadyInput(evReadyInput);
@@ -528,12 +528,12 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
 
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setEvseReadyInput(evseReadyInput);
@@ -541,25 +541,25 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
 
 void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->addErrorCodeInput(errorCodeInput);
 }
 
-void addErrorDataInput(std::function<ArduinoOcpp::ErrorData()> errorDataInput, unsigned int connectorId) {
+void addErrorDataInput(std::function<MicroOcpp::ErrorData()> errorDataInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->addErrorDataInput(errorDataInput);
@@ -567,22 +567,22 @@ void addErrorDataInput(std::function<ArduinoOcpp::ErrorData()> errorDataInput, u
 
 void addMeterValueInput(std::function<float ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
 
     if (!valueInput) {
-        AO_DBG_ERR("value undefined");
+        MOCPP_DBG_ERR("value undefined");
         return;
     }
 
     if (!measurand) {
         measurand = "Energy.Active.Import.Register";
-        AO_DBG_WARN("Measurand unspecified; assume %s", measurand);
+        MOCPP_DBG_WARN("Measurand unspecified; assume %s", measurand);
     }
 
     SampledValueProperties properties;
-    properties.setMeasurand(measurand); //mandatory for AO
+    properties.setMeasurand(measurand); //mandatory for MO
 
     if (unit)
         properties.setUnit(unit);
@@ -591,34 +591,34 @@ void addMeterValueInput(std::function<float ()> valueInput, const char *measuran
     if (phase)
         properties.setPhase(phase);
 
-    auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<float, ArduinoOcpp::SampledValueDeSerializer<float>>>(
-                                    new ArduinoOcpp::SampledValueSamplerConcrete<float, ArduinoOcpp::SampledValueDeSerializer<float>>(
+    auto valueSampler = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<float, MicroOcpp::SampledValueDeSerializer<float>>>(
+                                    new MicroOcpp::SampledValueSamplerConcrete<float, MicroOcpp::SampledValueDeSerializer<float>>(
                 properties,
-                [valueInput] (ArduinoOcpp::ReadingContext) {return valueInput();}));
+                [valueInput] (MicroOcpp::ReadingContext) {return valueInput();}));
     addMeterValueInput(std::move(valueSampler), connectorId);
 }
 
 void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*context, AO_NUMCONNECTORS, filesystem)));
+            new MeteringService(*context, MOCPP_NUMCONNECTORS, filesystem)));
     }
     model.getMeteringService()->addMeterValueSampler(connectorId, std::move(valueInput));
 }
 
 void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setOccupiedInput(occupied);
@@ -626,12 +626,12 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId)
 
 void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setStartTxReadyInput(startTxReady);
@@ -639,25 +639,25 @@ void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int conne
 
 void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setStopTxReadyInput(stopTxReady);
 }
 
-void setTxNotificationOutput(std::function<void(ArduinoOcpp::Transaction*,ArduinoOcpp::TxNotification)> notificationOutput, unsigned int connectorId) {
+void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcpp::TxNotification)> notificationOutput, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setTxNotificationOutput(notificationOutput);
@@ -665,12 +665,12 @@ void setTxNotificationOutput(std::function<void(ArduinoOcpp::Transaction*,Arduin
 
 void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setOnUnlockConnector(onUnlockConnectorInOut);
@@ -678,14 +678,14 @@ void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnect
 
 bool isOperative(unsigned int connectorId) {
     if (!context) {
-        AO_DBG_WARN("Please call ocpp_initialize before");
+        MOCPP_DBG_WARN("Please call mocpp_initialize before");
         return true; //assume "true" as default state
     }
     auto& model = context->getModel();
     auto chargePoint = model.getConnector(OCPP_ID_OF_CP);
     auto connector = model.getConnector(connectorId);
     if (!chargePoint || !connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return true; //assume "true" as default state
     }
     return chargePoint->isOperative() && connector->isOperative();
@@ -693,7 +693,7 @@ bool isOperative(unsigned int connectorId) {
 
 void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
 
@@ -704,7 +704,7 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
 
 void setOnResetExecute(std::function<void(bool)> onResetExecute) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
 
@@ -713,14 +713,14 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute) {
     }
 }
 
-#if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
+#if defined(MOCPP_CUSTOM_UPDATER) || defined(MOCPP_CUSTOM_WS)
 FirmwareService *getFirmwareService() {
     auto& model = context->getModel();
     return model.getFirmwareService();
 }
 #endif
 
-#if defined(AO_CUSTOM_DIAGNOSTICS) || defined(AO_CUSTOM_WS)
+#if defined(MOCPP_CUSTOM_DIAGNOSTICS) || defined(MOCPP_CUSTOM_WS)
 DiagnosticsService *getDiagnosticsService() {
     auto& model = context->getModel();
     return model.getDiagnosticsService();
@@ -733,11 +733,11 @@ Context *getOcppContext() {
 
 void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onReceiveReq) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!operationType) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return;
     }
     context->getOperationRegistry().setOnRequest(operationType, onReceiveReq);
@@ -745,11 +745,11 @@ void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onRecei
 
 void setOnSendConf(const char *operationType, OnSendConfListener onSendConf) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!operationType) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return;
     }
     context->getOperationRegistry().setOnResponse(operationType, onSendConf);
@@ -760,11 +760,11 @@ void sendRequest(const char *operationType,
             std::function<void (JsonObject)> fn_processConf) {
 
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!operationType || !fn_createReq || !fn_processConf) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return;
     }
 
@@ -777,11 +777,11 @@ void setRequestHandler(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf) {
 
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!operationType || !fn_processReq || !fn_createConf) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return;
     }
 
@@ -794,11 +794,11 @@ void setRequestHandler(const char *operationType,
 
 void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        MOCPP_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return;
     }
     auto authorize = makeRequest(
@@ -820,22 +820,22 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
 
 bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        AO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        MOCPP_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
     auto connector = context->getModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     auto transaction = connector->getTransaction();
     if (transaction) {
         if (transaction->getStartSync().isRequested()) {
-            AO_DBG_ERR("Transaction already in progress. Must call stopTransaction()");
+            MOCPP_DBG_ERR("Transaction already in progress. Must call stopTransaction()");
             return false;
         }
         transaction->setIdTag(idTag);
@@ -843,7 +843,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         beginTransaction_authorized(idTag); //request new transaction object
         transaction = connector->getTransaction();
         if (!transaction) {
-            AO_DBG_WARN("Transaction queue full");
+            MOCPP_DBG_WARN("Transaction queue full");
             return false;
         }
     }
@@ -853,7 +853,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         if (meterStart && *meterStart) {
             transaction->setMeterStart(meterStart->toInteger());
         } else {
-            AO_DBG_ERR("MeterStart undefined");
+            MOCPP_DBG_ERR("MeterStart undefined");
         }
     }
 
@@ -882,18 +882,18 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
 
 bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        AO_DBG_ERR("OCPP uninitialized"); //please call ocpp_initialize before
+        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
-        AO_DBG_ERR("Could not find connector. Ignore");
+        MOCPP_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
 
     auto transaction = connector->getTransaction();
     if (!transaction || !transaction->isRunning()) {
-        AO_DBG_ERR("No running Tx to stop");
+        MOCPP_DBG_ERR("No running Tx to stop");
         return false;
     }
 
@@ -909,7 +909,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         if (meterStop && *meterStop) {
             transaction->setMeterStop(meterStop->toInteger());
         } else {
-            AO_DBG_ERR("MeterStop undefined");
+            MOCPP_DBG_ERR("MeterStop undefined");
         }
     }
 
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 60d569d7..1db7588c 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -9,54 +9,54 @@
 #include <memory>
 #include <functional>
 
-#include <ArduinoOcpp/Core/ConfigurationOptions.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Core/RequestCallbacks.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/PollResult.h>
-#include <ArduinoOcpp/Model/Metering/SampledValue.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Notification.h>
-#include <ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h>
-
-using ArduinoOcpp::OnReceiveConfListener;
-using ArduinoOcpp::OnReceiveReqListener;
-using ArduinoOcpp::OnSendConfListener;
-using ArduinoOcpp::OnAbortListener;
-using ArduinoOcpp::OnTimeoutListener;
-using ArduinoOcpp::OnReceiveErrorListener;
-
-#ifndef AO_CUSTOM_WS
+#include <MicroOcpp/Core/ConfigurationOptions.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/RequestCallbacks.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/PollResult.h>
+#include <MicroOcpp/Model/Metering/SampledValue.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/ConnectorBase/Notification.h>
+#include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
+
+using MicroOcpp::OnReceiveConfListener;
+using MicroOcpp::OnReceiveReqListener;
+using MicroOcpp::OnSendConfListener;
+using MicroOcpp::OnAbortListener;
+using MicroOcpp::OnTimeoutListener;
+using MicroOcpp::OnReceiveErrorListener;
+
+#ifndef MOCPP_CUSTOM_WS
 //use links2004/WebSockets library
 
 /*
  * Initialize the library with the OCPP URL, EVSE voltage and filesystem configuration.
  * 
  * If the connections fails, please refer to 
- * https://github.com/matth-x/ArduinoOcpp/issues/36#issuecomment-989716573 for recommendations on
+ * https://github.com/matth-x/MicroOcpp/issues/36#issuecomment-989716573 for recommendations on
  * how to track down the issue with the connection.
  * 
  * This is a convenience function only available for Arduino. For a full initialization with TLS,
- * please refer to https://github.com/matth-x/ArduinoOcpp/tree/master/examples/ESP-TLS
+ * please refer to https://github.com/matth-x/MicroOcpp/tree/master/examples/ESP-TLS
  */
-void ocpp_initialize(
+void mocpp_initialize(
             const char *CS_hostname, //e.g. "example.com"
             uint16_t CS_port,        //e.g. 80
             const char *CS_url,      //e.g. "ws://example.com/steve/websocket/CentralSystemService/charger001"
             const char *chargePointModel = "Demo Charger",     //model name of this charger
             const char *chargePointVendor = "My Company Ltd.", //brand name
-            ArduinoOcpp::FilesystemOpt fsOpt = ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            MicroOcpp::FilesystemOpt fsOpt = MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
             const char *login = "", //login present in the websocket message header
             const char *password = "", //password present in the websocket message header
             const char *CA_cert = NULL); //TLS certificate
 #endif
 
 /*
- * Convenience initialization: use this for passing the BootNotification payload JSON to the ocpp_initialize(...) below
+ * Convenience initialization: use this for passing the BootNotification payload JSON to the mocpp_initialize(...) below
  *
  * Example usage:
  * 
- *     ocpp_initialize(osock, ChargerCredentials("Demo Charger", "My Company Ltd."));
+ *     mocpp_initialize(osock, ChargerCredentials("Demo Charger", "My Company Ltd."));
  * 
  * For a description of the fields, refer to OCPP 1.6 Specification - Edition 2 p. 60
  */
@@ -82,7 +82,7 @@ struct ChargerCredentials {
  * Initialize the library with a WebSocket connection which is configured with protocol=ocpp1.6
  * (=Connection), EVSE voltage and filesystem configuration. This library requires that you handle
  * establishing the connection and keeping it alive. Please refer to
- * https://github.com/matth-x/ArduinoOcpp/tree/master/examples/ESP-TLS for an example how to use it.
+ * https://github.com/matth-x/MicroOcpp/tree/master/examples/ESP-TLS for an example how to use it.
  * 
  * This GitHub project also delivers an Connection implementation based on links2004/WebSockets. If
  * you need another WebSockets implementation, you can subclass the Connection class and pass it to
@@ -90,21 +90,21 @@ struct ChargerCredentials {
  * https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/MongooseConnectionClient.cpp for
  * an example.
  */
-void ocpp_initialize(
-            ArduinoOcpp::Connection& connection, //WebSocket adapter for ArduinoOcpp
+void mocpp_initialize(
+            MicroOcpp::Connection& connection, //WebSocket adapter for MicroOcpp
             const char *bootNotificationCredentials = ChargerCredentials("Demo Charger", "My Company Ltd."), //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
-            std::shared_ptr<ArduinoOcpp::FilesystemAdapter> filesystem =
-                ArduinoOcpp::makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail)); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            std::shared_ptr<MicroOcpp::FilesystemAdapter> filesystem =
+                MicroOcpp::makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail)); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 /*
  * Stop the OCPP library and release allocated resources.
  */
-void ocpp_deinitialize();
+void mocpp_deinitialize();
 
 /*
  * To be called in the main loop (e.g. place it inside loop())
  */
-void ocpp_loop();
+void mocpp_loop();
 
 /*
  * Transaction management.
@@ -125,13 +125,13 @@ void ocpp_loop();
  * Returns the transaction object if it was possible to create the transaction process. Returns
  * nullptr if either another transaction process is still active or you need to try it again later.
  */
-std::shared_ptr<ArduinoOcpp::Transaction> beginTransaction(const char *idTag, unsigned int connectorId = 1);
+std::shared_ptr<MicroOcpp::Transaction> beginTransaction(const char *idTag, unsigned int connectorId = 1);
 
 /*
  * Begin the transaction process and skip the OCPP-side authorization. See beginTransaction(...) for a
  * complete description
  */
-std::shared_ptr<ArduinoOcpp::Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag = nullptr, unsigned int connectorId = 1);
+std::shared_ptr<MicroOcpp::Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag = nullptr, unsigned int connectorId = 1);
 
 /*
  * End the transaction process by terminating the transaction and setting a reason for its termination.
@@ -183,7 +183,7 @@ const char *getTransactionIdTag(unsigned int connectorId = 1);
 /*
  * Returns the current transaction process. Returns nullptr if no transaction is running, preparing or finishing
  *
- * See the class definition in ArduinoOcpp/Model/Transactions/Transaction.h for possible uses of this object
+ * See the class definition in MicroOcpp/Model/Transactions/Transaction.h for possible uses of this object
  * 
  * Examples:
  * auto tx = getTransaction(); //fetch tx object
@@ -194,7 +194,7 @@ const char *getTransactionIdTag(unsigned int connectorId = 1);
  *     bool deauthorized = tx->isIdTagDeauthorized(); //if StartTransaction has been rejected
  * }
  */
-std::shared_ptr<ArduinoOcpp::Transaction>& getTransaction(unsigned int connectorId = 1);
+std::shared_ptr<MicroOcpp::Transaction>& getTransaction(unsigned int connectorId = 1);
 
 /* 
  * Returns if the OCPP library allows the EVSE to charge at the moment.
@@ -247,11 +247,11 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId = 1); //Input if EVSE allows charge (= PWM signal on)
 
 void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int connectorId = 1); //Input for Error codes (please refer to OCPP 1.6, Edit2, p. 71 and 72 for valid error codes)
-void addErrorDataInput(std::function<ArduinoOcpp::ErrorData()> errorDataInput, unsigned int connectorId = 1);
+void addErrorDataInput(std::function<MicroOcpp::ErrorData()> errorDataInput, unsigned int connectorId = 1);
 
 void addMeterValueInput(std::function<float ()> valueInput, const char *measurand = nullptr, const char *unit = nullptr, const char *location = nullptr, const char *phase = nullptr, unsigned int connectorId = 1); //integrate further metering Inputs
 
-void addMeterValueInput(std::unique_ptr<ArduinoOcpp::SampledValueSampler> valueInput, unsigned int connectorId = 1); //integrate further metering Inputs (more extensive alternative)
+void addMeterValueInput(std::unique_ptr<MicroOcpp::SampledValueSampler> valueInput, unsigned int connectorId = 1); //integrate further metering Inputs (more extensive alternative)
 
 void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId = 1); //Input if instead of Available, send StatusNotification Preparing / Finishing
 
@@ -259,7 +259,7 @@ void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int conne
 
 void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId = 1); //Input if charger is ready for StopTransaction
 
-void setTxNotificationOutput(std::function<void(ArduinoOcpp::Transaction*,ArduinoOcpp::TxNotification)> notificationOutput, unsigned int connectorId = 1); //called when transaction state changes (see TxNotification for possible events). Transaction can be null
+void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcpp::TxNotification)> notificationOutput, unsigned int connectorId = 1); //called when transaction state changes (see TxNotification for possible events). Transaction can be null
 
 /*
  * Set an InputOutput (reads and sets information at the same time) for forcing to unlock the
@@ -267,7 +267,7 @@ void setTxNotificationOutput(std::function<void(ArduinoOcpp::Transaction*,Arduin
  * Return values: true on success, false on failure, PollResult::Await if not known yet
  * Continues to call the Cb as long as it returns PollResult::Await
  */
-void setOnUnlockConnectorInOut(std::function<ArduinoOcpp::PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId = 1);
+void setOnUnlockConnectorInOut(std::function<MicroOcpp::PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId = 1);
 
 /*
  * Access further information about the internal state of the library
@@ -283,40 +283,40 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify); //call onResetNo
 
 void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handler. This function should reboot this controller immediately. Already defined for the ESP32 on Arduino
 
-#if defined(AO_CUSTOM_UPDATER) || defined(AO_CUSTOM_WS)
-#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
+#if defined(MOCPP_CUSTOM_UPDATER) || defined(MOCPP_CUSTOM_WS)
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
 
 /*
  * You need to configure this object if FW updates are relevant for you. This project already
  * brings a simple configuration for the ESP32 and ESP8266 for prototyping purposes, however
  * for the productive system you will have to develop a configuration targeting the specific
  * OCPP backend.
- * See ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h 
+ * See MicroOcpp/Model/FirmwareManagement/FirmwareService.h 
  */
-ArduinoOcpp::FirmwareService *getFirmwareService();
+MicroOcpp::FirmwareService *getFirmwareService();
 #endif
 
-#if defined(AO_CUSTOM_DIAGNOSTICS) || defined(AO_CUSTOM_WS)
-#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
+#if defined(MOCPP_CUSTOM_DIAGNOSTICS) || defined(MOCPP_CUSTOM_WS)
+#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
 /*
  * This library implements the OCPP messaging side of Diagnostics, but no logging or the
  * log upload to your backend.
- * To integrate Diagnostics, see ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h
+ * To integrate Diagnostics, see MicroOcpp/Model/Diagnostics/DiagnosticsService.h
  */
-ArduinoOcpp::DiagnosticsService *getDiagnosticsService();
+MicroOcpp::DiagnosticsService *getDiagnosticsService();
 #endif
 
 /*
  * Add features and customize the behavior of the OCPP client
  */
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 class Context;
 }
 
 //Get access to internal functions and data structures. The returned Context object allows
 //you to bypass the facade functions of this header and implement custom functionality.
-ArduinoOcpp::Context *getOcppContext();
+MicroOcpp::Context *getOcppContext();
 
 /*
  * Set a listener which is notified when the OCPP lib processes an incoming operation of type
diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index e8db8fcf..7cae2967 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Debug.h>
 
 #include <string.h>
 #include <vector>
 #include <algorithm>
 #include <ArduinoJson.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 std::shared_ptr<FilesystemAdapter> filesystem;
 
@@ -18,7 +18,7 @@ template<class T>
 std::shared_ptr<Configuration<T>> createConfiguration(const char *key, T value) {
 
     if (!key || !*key) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return nullptr;
     }
 
@@ -30,7 +30,7 @@ std::shared_ptr<Configuration<T>> createConfiguration(const char *key, T value)
 std::shared_ptr<Configuration<const char *>> createConfiguration(const char *key, const char *value) {
 
     if (!key || !*key || !value) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return nullptr;
     }
 
@@ -86,20 +86,20 @@ std::shared_ptr<Configuration<T>> declareConfiguration(const char *key, T defaul
     std::shared_ptr<ConfigurationContainer> container = getContainer(filename);
     
     if (!container) {
-        AO_DBG_DEBUG("init new configurations container: %s", filename);
+        MOCPP_DBG_DEBUG("init new configurations container: %s", filename);
 
         container = createConfigurationContainer(filename);
         configurationContainers.push_back(container);
 
         if (!container->load()) {
-            AO_DBG_WARN("Cannot load file contents. Path will be overwritten");
+            MOCPP_DBG_WARN("Cannot load file contents. Path will be overwritten");
         }
     }
 
     std::shared_ptr<AbstractConfiguration> configuration = container->getConfiguration(key);
 
     if (configuration && strcmp(configuration->getSerializedType(), SerializedType<T>::get())) {
-        AO_DBG_ERR("conflicting declared types for %s. Discard old config", key);
+        MOCPP_DBG_ERR("conflicting declared types for %s. Discard old config", key);
         container->removeConfiguration(configuration);
         configuration = nullptr;
     }
@@ -111,7 +111,7 @@ std::shared_ptr<Configuration<T>> declareConfiguration(const char *key, T defaul
         configuration = std::static_pointer_cast<AbstractConfiguration>(configurationConcrete);
 
         if (!configuration) {
-            AO_DBG_ERR("Cannot find configuration stored from previous session and cannot create new one! Abort");
+            MOCPP_DBG_ERR("Cannot find configuration stored from previous session and cannot create new one! Abort");
             return nullptr;
         }
         container->addConfiguration(configuration);
@@ -165,7 +165,7 @@ bool configuration_inited = false;
 bool configuration_init(std::shared_ptr<FilesystemAdapter> _filesystem) {
     if (configuration_inited)
         return true; //configuration_init() already called; tolerate multiple calls so user can use this store for
-                     //credentials outside ArduinoOcpp which need to be loaded before ocpp_initialize()
+                     //credentials outside MicroOcpp which need to be loaded before mocpp_initialize()
     
     filesystem = _filesystem;
 
@@ -185,14 +185,14 @@ bool configuration_init(std::shared_ptr<FilesystemAdapter> _filesystem) {
     bool success = true;
 
     if (containerDefault) {
-        AO_DBG_DEBUG("Found default container before calling configuration_init(). If you added");
-        AO_DBG_DEBUG(" > the container manually, please ensure to call load(). If not, it is a hint");
-        AO_DBG_DEBUG(" > that declareConfiguration() was called too early");
+        MOCPP_DBG_DEBUG("Found default container before calling configuration_init(). If you added");
+        MOCPP_DBG_DEBUG(" > the container manually, please ensure to call load(). If not, it is a hint");
+        MOCPP_DBG_DEBUG(" > that declareConfiguration() was called too early");
         (void)0;
     } else {
         containerDefault = createConfigurationContainer(CONFIGURATION_FN);
         if (!containerDefault->load()) {
-            AO_DBG_ERR("Loading default configurations file failed");
+            MOCPP_DBG_ERR("Loading default configurations file failed");
             success = false;
         }
         configurationContainers.push_back(containerDefault);
@@ -230,4 +230,4 @@ template std::shared_ptr<Configuration<float>> declareConfiguration(const char *
 template std::shared_ptr<Configuration<bool>> declareConfiguration(const char *key, bool defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
 template std::shared_ptr<Configuration<const char *>> declareConfiguration(const char *key, const char *defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index 9e421c3e..24c1a6b7 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -1,23 +1,23 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONFIGURATION_H
 #define CONFIGURATION_H
 
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
-#include <ArduinoOcpp/Core/ConfigurationOptions.h>
-#include <ArduinoOcpp/Core/ConfigurationContainerFlash.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/ConfigurationOptions.h>
+#include <MicroOcpp/Core/ConfigurationContainerFlash.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 
 #include <memory>
 #include <vector>
 
-#define CONFIGURATION_FN (AO_FILENAME_PREFIX "arduino-ocpp.cnf")
+#define CONFIGURATION_FN (MOCPP_FILENAME_PREFIX "arduino-ocpp.cnf")
 #define CONFIGURATION_VOLATILE "/volatile"
-#define AO_KEYVALUE_FN (AO_FILENAME_PREFIX "client-state.cnf")
+#define MOCPP_KEYVALUE_FN (MOCPP_FILENAME_PREFIX "client-state.cnf")
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 template <class T>
 std::shared_ptr<Configuration<T>> declareConfiguration(const char *key, T defaultValue, const char *filename = CONFIGURATION_FN, bool remotePeerCanWrite = true, bool remotePeerCanRead = true, bool localClientCanWrite = true, bool rebootRequiredWhenChanged = false);
@@ -38,5 +38,5 @@ void configuration_deinit();
 
 bool configuration_save();
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index e420080d..b3e4041a 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -1,10 +1,10 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/ConfigurationContainer.h>
+#include <MicroOcpp/Core/ConfigurationContainer.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 std::shared_ptr<AbstractConfiguration> ConfigurationContainer::getConfiguration(const char *key) {
     for (std::vector<std::shared_ptr<AbstractConfiguration>>::iterator configuration = configurations.begin(); configuration != configurations.end(); configuration++) {
@@ -71,4 +71,4 @@ bool ConfigurationContainer::configurationsUpdated() {
     return updated;
 }
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index e7d0567a..0a6ac509 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -8,9 +8,9 @@
 #include <vector>
 #include <memory>
 
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class ConfigurationContainer {
 private:
@@ -49,6 +49,6 @@ class ConfigurationContainerVolatile : public ConfigurationContainer {
     bool save() {return true;}
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index 68192084..2d5cd77b 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/ConfigurationContainerFlash.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Core/ConfigurationContainerFlash.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Debug.h>
 
 #include <algorithm>
 
 #define MAX_CONFIGURATIONS 50
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 bool ConfigurationContainerFlash::load() {
 
@@ -19,7 +19,7 @@ bool ConfigurationContainerFlash::load() {
     }
 
     if (configurations.size() > 0) {
-        AO_DBG_ERR("Error: declared configurations before calling container->load(). " \
+        MOCPP_DBG_ERR("Error: declared configurations before calling container->load(). " \
                     "All previously declared values won't be written back");
         (void)0;
     }
@@ -27,13 +27,13 @@ bool ConfigurationContainerFlash::load() {
     size_t file_size = 0;
     if (filesystem->stat(getFilename(), &file_size) != 0 // file does not exist
             || file_size == 0) {                         // file exists, but empty
-        AO_DBG_DEBUG("Populate FS: create configuration file");
+        MOCPP_DBG_DEBUG("Populate FS: create configuration file");
         return save();
     }
 
     auto doc = FilesystemUtils::loadJson(filesystem, getFilename());
     if (!doc) {
-        AO_DBG_ERR("failed to load %s", getFilename());
+        MOCPP_DBG_ERR("failed to load %s", getFilename());
         return false;
     }
 
@@ -41,26 +41,28 @@ bool ConfigurationContainerFlash::load() {
 
     JsonObject configHeader = root["head"];
 
-    if (strcmp(configHeader["content-type"] | "Invalid", "ao_configuration_file")) {
-        AO_DBG_ERR("Unable to initialize: unrecognized configuration file format");
+    if (strcmp(configHeader["content-type"] | "Invalid", "ocpp_config_file") &&
+            strcmp(configHeader["content-type"] | "Invalid", "ao_configuration_file")) { //backwards-compatibility
+        MOCPP_DBG_ERR("Unable to initialize: unrecognized configuration file format");
         return false;
     }
 
-    if (strcmp(configHeader["version"] | "Invalid", "1.1")) {
-        AO_DBG_ERR("Unable to initialize: unsupported version");
+    if (strcmp(configHeader["version"] | "Invalid", "2.0") &&
+            strcmp(configHeader["version"] | "Invalid", "1.1")) { //backwards-compatibility
+        MOCPP_DBG_ERR("Unable to initialize: unsupported version");
         return false;
     }
     
     JsonArray configurationsArray = root["configurations"];
     if (configurationsArray.size() > MAX_CONFIGURATIONS) {
-        AO_DBG_ERR("Unable to initialize: configurations_len is too big (=%zu)", configurationsArray.size());
+        MOCPP_DBG_ERR("Unable to initialize: configurations_len is too big (=%zu)", configurationsArray.size());
         return false;
     }
 
     for (JsonObject config : configurationsArray) {
         const char *key = config["key"] | "";
         if (!*key || !config.containsKey("value")) {
-            AO_DBG_ERR("corrupt config");
+            MOCPP_DBG_ERR("corrupt config");
             continue;
         }
 
@@ -77,20 +79,20 @@ bool ConfigurationContainerFlash::load() {
         } else if (!strcmp(type, SerializedType<const char *>::get()) && config["value"].is<const char*>()){
             configuration = std::make_shared<Configuration<const char *>>(key, config["value"].as<const char*>());
         } else {
-            AO_DBG_ERR("corrupt config");
+            MOCPP_DBG_ERR("corrupt config");
             continue;
         }
 
         if (configuration) {
             configurations.push_back(configuration);
         } else {
-            AO_DBG_ERR("Initialization fault: could not read key-value pair %s of type %s", config["key"].as<const char *>(), config["type"].as<const char *>());
+            MOCPP_DBG_ERR("Initialization fault: could not read key-value pair %s of type %s", config["key"].as<const char *>(), config["type"].as<const char *>());
         }
     }
 
     configurationsUpdated();
 
-    AO_DBG_DEBUG("Initialization finished");
+    MOCPP_DBG_DEBUG("Initialization finished");
     return true;
 }
 
@@ -113,8 +115,8 @@ bool ConfigurationContainerFlash::save() {
         if (entry) {
             size_t capacity = entry->memoryUsage(); //entry payload size
 
-            if (jsonCapacity + capacity + JSON_ARRAY_SIZE(entries.size() + 1)  > AO_MAX_JSON_CAPACITY) {
-                AO_DBG_ERR("configs JSON exceeds maximum capacity (%s, %zu entries). Crop configs file (by FCFS)", getFilename(), entries.size());
+            if (jsonCapacity + capacity + JSON_ARRAY_SIZE(entries.size() + 1)  > MOCPP_MAX_JSON_CAPACITY) {
+                MOCPP_DBG_ERR("configs JSON exceeds maximum capacity (%s, %zu entries). Crop configs file (by FCFS)", getFilename(), entries.size());
                 break;
             }
 
@@ -127,8 +129,8 @@ bool ConfigurationContainerFlash::save() {
 
     DynamicJsonDocument doc {jsonCapacity};
     JsonObject head = doc.createNestedObject("head");
-    head["content-type"] = "ao_configuration_file";
-    head["version"] = "1.1";
+    head["content-type"] = "ocpp_config_file";
+    head["version"] = "2.0";
 
     JsonArray configurationsArray = doc.createNestedArray("configurations");
     for (auto entry = entries.begin(); entry != entries.end(); entry++) {
@@ -138,12 +140,12 @@ bool ConfigurationContainerFlash::save() {
     bool success = FilesystemUtils::storeJson(filesystem, getFilename(), doc);
 
     if (success) {
-        AO_DBG_DEBUG("Saving configurations finished");
+        MOCPP_DBG_DEBUG("Saving configurations finished");
     } else {
-        AO_DBG_ERR("could not save configs file: %s", getFilename());
+        MOCPP_DBG_ERR("could not save configs file: %s", getFilename());
     }
 
     return success;
 }
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.h b/src/MicroOcpp/Core/ConfigurationContainerFlash.h
index d2ac33b7..20574ce2 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.h
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONFIGURATIONCONTAINERFLASH_H
 #define CONFIGURATIONCONTAINERFLASH_H
 
-#include <ArduinoOcpp/Core/ConfigurationContainer.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/ConfigurationContainer.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class ConfigurationContainerFlash : public ConfigurationContainer {
     std::shared_ptr<FilesystemAdapter> filesystem;
@@ -24,6 +24,6 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
 
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index 1e251e48..9012c4a9 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -1,9 +1,9 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Debug.h>
 
 #include <string.h>
 #include <vector>
@@ -12,7 +12,7 @@
 #define KEY_MAXLEN 60
 #define STRING_VAL_MAXLEN 2000 //allow TLS certificates in ...
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 int toCStringValue(char *buf, size_t length, int value) {
     return snprintf(buf, length, "%d", value);
@@ -29,7 +29,7 @@ int toCStringValue(char *buf, size_t length, bool value) {
 
 AbstractConfiguration::AbstractConfiguration(const char *key) {
     if (!key || !*key) {
-        AO_DBG_ERR("invalid argument");
+        MOCPP_DBG_ERR("invalid argument");
         return;
     }
 
@@ -94,7 +94,7 @@ const T &Configuration<T>::operator=(const T & newVal) {
             const size_t VALUE_MAXSIZE = 50;
             char value_str [VALUE_MAXSIZE] = {'\0'};
             toCStringValue(value_str, VALUE_MAXSIZE, newVal);
-            AO_DBG_DEBUG("add config: key = %s, value = %s", getKey(), value_str);
+            MOCPP_DBG_DEBUG("add config: key = %s, value = %s", getKey(), value_str);
         }
         if (initializedValue == true && value != newVal) {
             value_revision++;
@@ -102,7 +102,7 @@ const T &Configuration<T>::operator=(const T & newVal) {
         value = newVal;
         initializedValue = true;
     } else {
-        AO_DBG_ERR("Tried to override read-only configuration: %s", getKey());
+        MOCPP_DBG_ERR("Tried to override read-only configuration: %s", getKey());
     }
     return newVal;
 }
@@ -196,7 +196,7 @@ std::unique_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonOcppMsgE
 
 Configuration<const char *>::Configuration(const char *key, const char *value) : AbstractConfiguration(key) {
     if (!value) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return;
     }
 
@@ -209,12 +209,12 @@ Configuration<const char *>::~Configuration() {
 
 const char *Configuration<const char *>::operator=(const char *new_value) {
     if (!new_value) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return new_value;
     }
 
     if (!permissionLocalClientCanWrite() && initializedValue) {
-        AO_DBG_ERR("Tried to override read-only configuration: %s", getKey());
+        MOCPP_DBG_ERR("Tried to override read-only configuration: %s", getKey());
         return new_value;
     }
 
@@ -224,7 +224,7 @@ const char *Configuration<const char *>::operator=(const char *new_value) {
     }
     
     if (!initializedValue) {
-        AO_DBG_DEBUG("add config: key = %s, value = %s", getKey(), value.c_str());
+        MOCPP_DBG_DEBUG("add config: key = %s, value = %s", getKey(), value.c_str());
         (void)0;
     }
     initializedValue = true;
@@ -256,4 +256,4 @@ template class Configuration<float>;
 template class Configuration<bool>;
 template class Configuration<const char *>;
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index 044fc58f..e2e8ab48 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -10,7 +10,7 @@
 #include <functional>
 #include <string>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class AbstractConfiguration {
 private:
@@ -106,6 +106,6 @@ class Configuration<const char *> : public AbstractConfiguration {
     std::function<bool(const char*)> getValidator();
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Core/ConfigurationOptions.h b/src/MicroOcpp/Core/ConfigurationOptions.h
index a45dca42..1cda7a91 100644
--- a/src/MicroOcpp/Core/ConfigurationOptions.h
+++ b/src/MicroOcpp/Core/ConfigurationOptions.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -11,7 +11,7 @@
 extern "C" {
 #endif
 
-struct AO_FilesystemOpt {
+struct OCPP_FilesystemOpt {
     bool use;
     bool mount;
     bool formatFsOnFail;
@@ -20,7 +20,7 @@ struct AO_FilesystemOpt {
 #ifdef __cplusplus
 }
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class FilesystemOpt{
 private:
@@ -46,7 +46,7 @@ class FilesystemOpt{
                 break;
         }
     }
-    FilesystemOpt(struct AO_FilesystemOpt fsopt) {
+    FilesystemOpt(struct OCPP_FilesystemOpt fsopt) {
         this->use = fsopt.use;
         this->mount = fsopt.mount;
         this->formatFsOnFail = fsopt.formatFsOnFail;
@@ -57,7 +57,7 @@ class FilesystemOpt{
     bool formatOnFail() {return formatFsOnFail;}
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif //__cplusplus
 
diff --git a/src/MicroOcpp/Core/Connection.cpp b/src/MicroOcpp/Core/Connection.cpp
index 364895c0..658fc31c 100644
--- a/src/MicroOcpp/Core/Connection.cpp
+++ b/src/MicroOcpp/Core/Connection.cpp
@@ -1,11 +1,11 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Debug.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 void LoopbackConnection::loop() { }
 
@@ -14,7 +14,7 @@ bool LoopbackConnection::sendTXT(std::string &out) {
         return false;
     }
     if (receiveTXT) {
-        lastRecv = ao_tick_ms();
+        lastRecv = mocpp_tick_ms();
         return receiveTXT(out.c_str(), out.length());
     } else {
         return false;
@@ -29,9 +29,9 @@ unsigned long LoopbackConnection::getLastRecv() {
     return lastRecv;
 }
 
-#ifndef AO_CUSTOM_WS
+#ifndef MOCPP_CUSTOM_WS
 
-using namespace ArduinoOcpp::EspWiFi;
+using namespace MicroOcpp::EspWiFi;
 
 WSClient::WSClient(WebSocketsClient *wsock) : wsock(wsock) {
 
@@ -51,36 +51,36 @@ void WSClient::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
     wsock->onEvent([callback, &captureLastRecv, &captureLastConnected](WStype_t type, uint8_t * payload, size_t length) {
         switch (type) {
             case WStype_DISCONNECTED:
-                AO_DBG_INFO("Disconnected");
+                MOCPP_DBG_INFO("Disconnected");
                 break;
             case WStype_CONNECTED:
-                AO_DBG_INFO("Connected to url: %s", payload);
-                captureLastRecv = ao_tick_ms();
-                captureLastConnected = ao_tick_ms();
+                MOCPP_DBG_INFO("Connected to url: %s", payload);
+                captureLastRecv = mocpp_tick_ms();
+                captureLastConnected = mocpp_tick_ms();
                 break;
             case WStype_TEXT:
                 if (callback((const char *) payload, length)) { //forward message to RequestQueue
-                    captureLastRecv = ao_tick_ms();
+                    captureLastRecv = mocpp_tick_ms();
                 } else {
-                    AO_DBG_WARN("Processing WebSocket input event failed");
+                    MOCPP_DBG_WARN("Processing WebSocket input event failed");
                 }
                 break;
             case WStype_BIN:
-                AO_DBG_WARN("Binary data stream not supported");
+                MOCPP_DBG_WARN("Binary data stream not supported");
                 break;
             case WStype_PING:
                 // pong will be send automatically
-                AO_DBG_TRAFFIC_IN(8, "WS ping");
-                captureLastRecv = ao_tick_ms();
+                MOCPP_DBG_TRAFFIC_IN(8, "WS ping");
+                captureLastRecv = mocpp_tick_ms();
                 break;
             case WStype_PONG:
                 // answer to a ping we send
-                AO_DBG_TRAFFIC_IN(8, "WS pong");
-                captureLastRecv = ao_tick_ms();
+                MOCPP_DBG_TRAFFIC_IN(8, "WS pong");
+                captureLastRecv = mocpp_tick_ms();
                 break;
             case WStype_FRAGMENT_TEXT_START: //fragments are not supported
             default:
-                AO_DBG_WARN("Unsupported WebSocket event type");
+                MOCPP_DBG_WARN("Unsupported WebSocket event type");
                 break;
         }
     });
diff --git a/src/MicroOcpp/Core/Connection.h b/src/MicroOcpp/Core/Connection.h
index a162e70a..2513d85a 100644
--- a/src/MicroOcpp/Core/Connection.h
+++ b/src/MicroOcpp/Core/Connection.h
@@ -1,25 +1,25 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_CONNECTION_H
-#define AO_CONNECTION_H
+#ifndef MOCPP_CONNECTION_H
+#define MOCPP_CONNECTION_H
 
 #include <functional>
 #include <memory>
 #include <string>
 
-#include <ArduinoOcpp/Platform.h>
+#include <MicroOcpp/Platform.h>
 
 //On all platforms other than Arduino, the integrated WS lib (links2004/arduinoWebSockets) cannot be
 //used. On Arduino it's usage is optional.
-#ifndef AO_CUSTOM_WS
-#if AO_PLATFORM != AO_PLATFORM_ARDUINO
-#define AO_CUSTOM_WS
+#ifndef MOCPP_CUSTOM_WS
+#if MOCPP_PLATFORM != MOCPP_PLATFORM_ARDUINO
+#define MOCPP_CUSTOM_WS
 #endif
-#endif //ndef AO_CUSTOM_WS
+#endif //ndef MOCPP_CUSTOM_WS
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 using ReceiveTXTcallback = std::function<bool(const char*, size_t)>;
 
@@ -46,12 +46,12 @@ class Connection {
     virtual void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) = 0;
 
     /*
-     * Returns the timestamp of the last incoming message. Use ao_tick_ms() for creating the correct timestamp
+     * Returns the timestamp of the last incoming message. Use mocpp_tick_ms() for creating the correct timestamp
      */
     virtual unsigned long getLastRecv() {return 0;}
 
     /*
-     * Returns the timestamp of the last time a connection got successfully established. Use ao_tick_ms() for creating the correct timestamp
+     * Returns the timestamp of the last time a connection got successfully established. Use mocpp_tick_ms() for creating the correct timestamp
      */
     virtual unsigned long getLastConnected() {return 0;}
 };
@@ -72,13 +72,13 @@ class LoopbackConnection : public Connection {
     bool isConnected() {return connected;}
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
-#ifndef AO_CUSTOM_WS
+#ifndef MOCPP_CUSTOM_WS
 
 #include <WebSocketsClient.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace EspWiFi {
 
 class WSClient : public Connection {
@@ -100,6 +100,6 @@ class WSClient : public Connection {
 };
 
 } //end namespace EspWiFi
-} //end namespace ArduinoOcpp
-#endif //ndef AO_CUSTOM_WS
+} //end namespace MicroOcpp
+#endif //ndef MOCPP_CUSTOM_WS
 #endif
diff --git a/src/MicroOcpp/Core/Context.cpp b/src/MicroOcpp/Core/Context.cpp
index ee316797..425354ac 100644
--- a/src/MicroOcpp/Core/Context.cpp
+++ b/src/MicroOcpp/Core/Context.cpp
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Request.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Model/Model.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 Context::Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr)
         : connection(connection), model{bootNr}, reqQueue{operationRegistry, &model, filesystem} {
diff --git a/src/MicroOcpp/Core/Context.h b/src/MicroOcpp/Core/Context.h
index 48a4c5e7..55000737 100644
--- a/src/MicroOcpp/Core/Context.h
+++ b/src/MicroOcpp/Core/Context.h
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_CONTEXT_H
-#define AO_CONTEXT_H
+#ifndef MOCPP_CONTEXT_H
+#define MOCPP_CONTEXT_H
 
 #include <memory>
 
-#include <ArduinoOcpp/Core/OperationRegistry.h>
-#include <ArduinoOcpp/Core/RequestQueue.h>
-#include <ArduinoOcpp/Model/Model.h>
+#include <MicroOcpp/Core/OperationRegistry.h>
+#include <MicroOcpp/Core/RequestQueue.h>
+#include <MicroOcpp/Model/Model.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Connection;
 class FilesystemAdapter;
@@ -43,6 +43,6 @@ class Context {
     OperationRegistry& getOperationRegistry();
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 56cc5097..4082cf86 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -1,10 +1,10 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
+#include <MicroOcpp/Debug.h>
 
 /*
  * Platform specific implementations. Currently supported:
@@ -13,22 +13,22 @@
  *     - ESP-IDF SPIFFS
  *     - POSIX-like API (tested on Ubuntu 20.04)
  * 
- * You can add support for other file systems by passing a custom adapter to ocpp_initialize(...)
+ * You can add support for other file systems by passing a custom adapter to mocpp_initialize(...)
  */
 
 
-#if AO_USE_FILEAPI == ARDUINO_LITTLEFS || AO_USE_FILEAPI == ARDUINO_SPIFFS
+#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS || MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
 
-#if AO_USE_FILEAPI == ARDUINO_LITTLEFS
+#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
 #include <LittleFS.h>
 #include <vfs_api.h>
 #define USE_FS LittleFS
-#elif AO_USE_FILEAPI == ARDUINO_SPIFFS
+#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
 #include <FS.h>
 #define USE_FS SPIFFS
 #endif
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class ArduinoFileAdapter : public FileAdapter {
     File file;
@@ -64,21 +64,21 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
         valid = true;
 
         if (config.mustMount()) { 
-#if AO_USE_FILEAPI == ARDUINO_LITTLEFS
+#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
             if(!USE_FS.begin(config.formatOnFail())) {
-                AO_DBG_ERR("Error while mounting LITTLEFS");
+                MOCPP_DBG_ERR("Error while mounting LITTLEFS");
                 valid = false;
             } else {
-                AO_DBG_DEBUG("LittleFS mount success");
+                MOCPP_DBG_DEBUG("LittleFS mount success");
             }
-#elif AO_USE_FILEAPI == ARDUINO_SPIFFS
+#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
             //ESP8266
             SPIFFSConfig cfg;
             cfg.setAutoFormat(config.formatOnFail());
             SPIFFS.setConfig(cfg);
 
             if (!SPIFFS.begin()) {
-                AO_DBG_ERR("Unable to initialize: unable to mount SPIFFS");
+                MOCPP_DBG_ERR("Unable to initialize: unable to mount SPIFFS");
                 valid = false;
             }
 #else
@@ -97,14 +97,14 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     operator bool() {return valid;}
 
     int stat(const char *path, size_t *size) override {
-#if AO_USE_FILEAPI == ARDUINO_LITTLEFS
+#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
         struct ::stat st;
         auto ret = ::stat(path, &st);
         if (ret == 0) {
             *size = st.st_size;
         }
         return ret;
-#elif AO_USE_FILEAPI == ARDUINO_SPIFFS
+#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
         if (!USE_FS.exists(path)) {
             return -1;
         }
@@ -118,7 +118,7 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
             *size = f.size();
             status = 0;
         } else {
-            //fetch more information for directory when ArduinoOcpp also uses them
+            //fetch more information for directory when MicroOcpp also uses them
             //status = 0;
         }
 
@@ -132,7 +132,7 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {
         File file = USE_FS.open(fn, mode);
         if (file && !file.isDirectory()) {
-            AO_DBG_DEBUG("File open successful: %s", fn);
+            MOCPP_DBG_DEBUG("File open successful: %s", fn);
             return std::unique_ptr<FileAdapter>(new ArduinoFileAdapter(std::move(file)));
         } else {
             return nullptr;
@@ -142,22 +142,22 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
         return USE_FS.remove(fn);
     };
     int ftw_root(std::function<int(const char *fpath)> fn) {
-#if AO_USE_FILEAPI == ARDUINO_LITTLEFS
-        auto dir = USE_FS.open(AO_FILENAME_PREFIX);
+#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
+        auto dir = USE_FS.open(MOCPP_FILENAME_PREFIX);
         if (!dir) {
-            AO_DBG_ERR("cannot open root directory: " AO_FILENAME_PREFIX);
+            MOCPP_DBG_ERR("cannot open root directory: " MOCPP_FILENAME_PREFIX);
             return -1;
         }
 
         int err = 0;
         while (auto entry = dir.openNextFile()) {
 
-            char fname [AO_MAX_PATH_SIZE];
-            auto ret = snprintf(fname, AO_MAX_PATH_SIZE, "%s", entry.name() + strlen(AO_FILENAME_PREFIX));
+            char fname [MOCPP_MAX_PATH_SIZE];
+            auto ret = snprintf(fname, MOCPP_MAX_PATH_SIZE, "%s", entry.name() + strlen(MOCPP_FILENAME_PREFIX));
             entry.close();
 
-            if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-                AO_DBG_ERR("fn error: %i", ret);
+            if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+                MOCPP_DBG_ERR("fn error: %i", ret);
                 return -1;
             }
 
@@ -167,15 +167,15 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
             }
         }
         return err;
-#elif AO_USE_FILEAPI == ARDUINO_SPIFFS
-        auto dir = USE_FS.openDir(AO_FILENAME_PREFIX);
+#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
+        auto dir = USE_FS.openDir(MOCPP_FILENAME_PREFIX);
         int err = 0;
         while (dir.next()) {
             auto fname = dir.fileName();
             if (fname.c_str()) {
-                err = fn(fname.c_str() + strlen(AO_FILENAME_PREFIX));
+                err = fn(fname.c_str() + strlen(MOCPP_FILENAME_PREFIX));
             } else {
-                AO_DBG_ERR("fs error");
+                MOCPP_DBG_ERR("fs error");
                 err = -1;
             }
             if (err) {
@@ -198,7 +198,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     if (!config.accessAllowed()) {
-        AO_DBG_DEBUG("Access to Arduino FS not allowed by config");
+        MOCPP_DBG_DEBUG("Access to Arduino FS not allowed by config");
         return nullptr;
     }
 
@@ -213,15 +213,15 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 }
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
-#elif AO_USE_FILEAPI == ESPIDF_SPIFFS
+#elif MOCPP_USE_FILEAPI == ESPIDF_SPIFFS
 
 #include <sys/stat.h>
 #include <dirent.h>
 #include "esp_spiffs.h"
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class EspIdfFileAdapter : public FileAdapter {
     FILE *file {nullptr};
@@ -257,8 +257,8 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
 
     ~EspIdfFilesystemAdapter() {
         if (config.mustMount()) {
-            esp_vfs_spiffs_unregister("ao"); //partition label
-            AO_DBG_DEBUG("SPIFFS unmounted");
+            esp_vfs_spiffs_unregister("mo"); //partition label
+            MOCPP_DBG_DEBUG("SPIFFS unmounted");
         }
     }
 
@@ -276,7 +276,7 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
         if (file) {
             return std::unique_ptr<FileAdapter>(new EspIdfFileAdapter(std::move(file)));
         } else {
-            AO_DBG_DEBUG("Failed to open file path %s", fn);
+            MOCPP_DBG_DEBUG("Failed to open file path %s", fn);
             return nullptr;
         }
     }
@@ -286,11 +286,11 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
     }
 
     int ftw_root(std::function<int(const char *fpath)> fn) {
-        //open AO root directory
-        char dname [AO_MAX_PATH_SIZE];
-        auto dlen = snprintf(dname, AO_MAX_PATH_SIZE, "%s", AO_FILENAME_PREFIX);
-        if (dlen < 0 || dlen >= AO_MAX_PATH_SIZE) {
-            AO_DBG_ERR("fn error: %i", dlen);
+        //open MO root directory
+        char dname [MOCPP_MAX_PATH_SIZE];
+        auto dlen = snprintf(dname, MOCPP_MAX_PATH_SIZE, "%s", MOCPP_FILENAME_PREFIX);
+        if (dlen < 0 || dlen >= MOCPP_MAX_PATH_SIZE) {
+            MOCPP_DBG_ERR("fn error: %i", dlen);
             return -1;
         }
 
@@ -301,7 +301,7 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
 
         auto dir = opendir(dname);
         if (!dir) {
-            AO_DBG_ERR("cannot open root directory: %s", dname);
+            MOCPP_DBG_ERR("cannot open root directory: %s", dname);
             return -1;
         }
 
@@ -327,7 +327,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     if (!config.accessAllowed()) {
-        AO_DBG_DEBUG("Access to ESP-IDF SPIFFS not allowed by config");
+        MOCPP_DBG_DEBUG("Access to ESP-IDF SPIFFS not allowed by config");
         return nullptr;
     }
 
@@ -337,8 +337,8 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
         mounted = false;
         
         esp_vfs_spiffs_conf_t conf = {
-            .base_path = AO_FILENAME_PREFIX,
-            .partition_label = "ao", //also see deconstructor
+            .base_path = MOCPP_FILENAME_PREFIX,
+            .partition_label = "mo", //also see deconstructor
             .max_files = 5,
             .format_if_mount_failed = config.formatOnFail()
         };
@@ -347,14 +347,14 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
         if (ret == ESP_OK) {
             mounted = true;
-            AO_DBG_DEBUG("SPIFFS mounted");
+            MOCPP_DBG_DEBUG("SPIFFS mounted");
         } else {
             if (ret == ESP_FAIL) {
-                AO_DBG_ERR("Failed to mount or format filesystem");
+                MOCPP_DBG_ERR("Failed to mount or format filesystem");
             } else if (ret == ESP_ERR_NOT_FOUND) {
-                AO_DBG_ERR("Failed to find SPIFFS partition");
+                MOCPP_DBG_ERR("Failed to find SPIFFS partition");
             } else {
-                AO_DBG_ERR("Failed to initialize SPIFFS (%s)", esp_err_to_name(ret));
+                MOCPP_DBG_ERR("Failed to initialize SPIFFS (%s)", esp_err_to_name(ret));
             }
         }
     }
@@ -368,15 +368,15 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 }
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
-#elif AO_USE_FILEAPI == POSIX_FILEAPI
+#elif MOCPP_USE_FILEAPI == POSIX_FILEAPI
 
 #include <cstdio>
 #include <sys/stat.h>
 #include <dirent.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class PosixFileAdapter : public FileAdapter {
     FILE *file {nullptr};
@@ -426,7 +426,7 @@ class PosixFilesystemAdapter : public FilesystemAdapter {
         if (file) {
             return std::unique_ptr<FileAdapter>(new PosixFileAdapter(std::move(file)));
         } else {
-            AO_DBG_DEBUG("Failed to open file path %s", fn);
+            MOCPP_DBG_DEBUG("Failed to open file path %s", fn);
             return nullptr;
         }
     }
@@ -436,9 +436,9 @@ class PosixFilesystemAdapter : public FilesystemAdapter {
     }
 
     int ftw_root(std::function<int(const char *fpath)> fn) {
-        auto dir = opendir(AO_FILENAME_PREFIX); // use c_str() to convert the path string to a C-style string
+        auto dir = opendir(MOCPP_FILENAME_PREFIX); // use c_str() to convert the path string to a C-style string
         if (!dir) {
-            AO_DBG_ERR("cannot open root directory: " AO_FILENAME_PREFIX);
+            MOCPP_DBG_ERR("cannot open root directory: " MOCPP_FILENAME_PREFIX);
             return -1;
         }
 
@@ -464,12 +464,12 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     if (!config.accessAllowed()) {
-        AO_DBG_DEBUG("Access to FS not allowed by config");
+        MOCPP_DBG_DEBUG("Access to FS not allowed by config");
         return nullptr;
     }
 
     if (config.mustMount()) {
-        AO_DBG_DEBUG("Skip mounting on UNIX host");
+        MOCPP_DBG_DEBUG("Skip mounting on UNIX host");
     }
 
     auto fs = std::shared_ptr<FilesystemAdapter>(new PosixFilesystemAdapter(config));
@@ -477,7 +477,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     return fs;
 }
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #else //filesystem disabled
 
@@ -485,4 +485,4 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     return nullptr;
 }
 
-#endif //switch-case AO_USE_FILEAPI
+#endif //switch-case MOCPP_USE_FILEAPI
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.h b/src/MicroOcpp/Core/FilesystemAdapter.h
index bc7eb435..8a78e3cd 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.h
+++ b/src/MicroOcpp/Core/FilesystemAdapter.h
@@ -1,18 +1,18 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_FILESYSTEMADAPTER_H
-#define AO_FILESYSTEMADAPTER_H
+#ifndef MOCPP_FILESYSTEMADAPTER_H
+#define MOCPP_FILESYSTEMADAPTER_H
 
 #include <memory>
 #include <functional>
 
-#include <ArduinoOcpp/Platform.h>
-#include <ArduinoOcpp/Core/ConfigurationOptions.h>
+#include <MicroOcpp/Platform.h>
+#include <MicroOcpp/Core/ConfigurationOptions.h>
 
-#ifndef AO_FILENAME_PREFIX
-#define AO_FILENAME_PREFIX "/"
+#ifndef MOCPP_FILENAME_PREFIX
+#define MOCPP_FILENAME_PREFIX "/"
 #endif
 
 #define DISABLE_FS       0
@@ -22,32 +22,32 @@
 #define POSIX_FILEAPI    4
 
 // choose FileAPI if not given by build flag; assume usage with Arduino if no build flags are present
-#ifndef AO_USE_FILEAPI
-#if AO_PLATFORM == AO_PLATFORM_ARDUINO
+#ifndef MOCPP_USE_FILEAPI
+#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO
 #if defined(ESP32)
-#define AO_USE_FILEAPI ARDUINO_LITTLEFS
+#define MOCPP_USE_FILEAPI ARDUINO_LITTLEFS
 #else
-#define AO_USE_FILEAPI ARDUINO_SPIFFS
+#define MOCPP_USE_FILEAPI ARDUINO_SPIFFS
 #endif
-#elif AO_PLATFORM == AO_PLATFORM_ESPIDF
-#define AO_USE_FILEAPI ESPIDF_SPIFFS
-#elif AO_PLATFORM == AO_PLATFORM_UNIX
-#define AO_USE_FILEAPI POSIX_FILEAPI
+#elif MOCPP_PLATFORM == MOCPP_PLATFORM_ESPIDF
+#define MOCPP_USE_FILEAPI ESPIDF_SPIFFS
+#elif MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
+#define MOCPP_USE_FILEAPI POSIX_FILEAPI
 #else
-#define AO_USE_FILEAPI DISABLE_FS
-#endif //switch-case AO_PLATFORM
-#endif //ndef AO_USE_FILEAPI
+#define MOCPP_USE_FILEAPI DISABLE_FS
+#endif //switch-case MOCPP_PLATFORM
+#endif //ndef MOCPP_USE_FILEAPI
 
 // set default max path size parameters
-#ifndef AO_MAX_PATH_SIZE
-#if AO_USE_FILEAPI == POSIX_FILEAPI
-#define AO_MAX_PATH_SIZE 128
+#ifndef MOCPP_MAX_PATH_SIZE
+#if MOCPP_USE_FILEAPI == POSIX_FILEAPI
+#define MOCPP_MAX_PATH_SIZE 128
 #else
-#define AO_MAX_PATH_SIZE 30
+#define MOCPP_MAX_PATH_SIZE 30
 #endif
 #endif
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class FileAdapter {
 public:
@@ -65,7 +65,7 @@ class FilesystemAdapter {
     virtual int stat(const char *path, size_t *size) = 0;
     virtual std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) = 0;
     virtual bool remove(const char *fn) = 0;
-    virtual int ftw_root(std::function<int(const char *fpath)> fn) = 0; //enumerate the files in the ao_store root folder
+    virtual int ftw_root(std::function<int(const char *fpath)> fn) = 0; //enumerate the files in the mo_store root folder
 };
 
 /*
@@ -75,12 +75,12 @@ class FilesystemAdapter {
  *     - ESP-IDF SPIFFS
  *     - POSIX-like API (tested on Ubuntu 20.04)
  * 
- * You can add support for other file systems by passing a custom adapter to ocpp_initialize(...)
+ * You can add support for other file systems by passing a custom adapter to mocpp_initialize(...)
  * 
  * Returns null if platform is not supported or Filesystem is disabled
  */
 std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config);
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Core/FilesystemUtils.cpp b/src/MicroOcpp/Core/FilesystemUtils.cpp
index 2cd40346..dc409417 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.cpp
+++ b/src/MicroOcpp/Core/FilesystemUtils.cpp
@@ -1,40 +1,40 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
+#include <MicroOcpp/Debug.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn) {
     if (!filesystem || !fn || *fn == '\0') {
-        AO_DBG_ERR("Format error");
+        MOCPP_DBG_ERR("Format error");
         return nullptr;
     }
 
-    if (strnlen(fn, AO_MAX_PATH_SIZE) >= AO_MAX_PATH_SIZE) {
-        AO_DBG_ERR("Fn too long: %.*s", AO_MAX_PATH_SIZE, fn);
+    if (strnlen(fn, MOCPP_MAX_PATH_SIZE) >= MOCPP_MAX_PATH_SIZE) {
+        MOCPP_DBG_ERR("Fn too long: %.*s", MOCPP_MAX_PATH_SIZE, fn);
         return nullptr;
     }
     
     size_t fsize = 0;
     if (filesystem->stat(fn, &fsize) != 0) {
-        AO_DBG_DEBUG("File does not exist: %s", fn);
+        MOCPP_DBG_DEBUG("File does not exist: %s", fn);
         return nullptr;
     }
 
     if (fsize < 2) {
-        AO_DBG_ERR("File too small for JSON, collect %s", fn);
+        MOCPP_DBG_ERR("File too small for JSON, collect %s", fn);
         filesystem->remove(fn);
         return nullptr;
     }
 
     auto file = filesystem->open(fn, "r");
     if (!file) {
-        AO_DBG_ERR("Could not open file %s", fn);
+        MOCPP_DBG_ERR("Could not open file %s", fn);
         return nullptr;
     }
 
@@ -43,18 +43,18 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
     //capacity = ceil capacity_init to the next power of two; should be at least 128
 
     size_t capacity = 128;
-    while (capacity < capacity_init && capacity < AO_MAX_JSON_CAPACITY) {
+    while (capacity < capacity_init && capacity < MOCPP_MAX_JSON_CAPACITY) {
         capacity *= 2;
     }
-    if (capacity > AO_MAX_JSON_CAPACITY) {
-        capacity = AO_MAX_JSON_CAPACITY;
+    if (capacity > MOCPP_MAX_JSON_CAPACITY) {
+        capacity = MOCPP_MAX_JSON_CAPACITY;
     }
     
     auto doc = std::unique_ptr<DynamicJsonDocument>(nullptr);
     DeserializationError err = DeserializationError::NoMemory;
     ArduinoJsonFileAdapter fileReader {file.get()};
 
-    while (err == DeserializationError::NoMemory && capacity <= AO_MAX_JSON_CAPACITY) {
+    while (err == DeserializationError::NoMemory && capacity <= MOCPP_MAX_JSON_CAPACITY) {
 
         doc.reset(new DynamicJsonDocument(capacity));
         err = deserializeJson(*doc, fileReader);
@@ -65,35 +65,35 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
     }
 
     if (err) {
-        AO_DBG_ERR("Error deserializing file %s: %s", fn, err.c_str());
+        MOCPP_DBG_ERR("Error deserializing file %s: %s", fn, err.c_str());
         //skip this file
         return nullptr;
     }
 
-    AO_DBG_DEBUG("Loaded JSON file: %s", fn);
+    MOCPP_DBG_DEBUG("Loaded JSON file: %s", fn);
 
     return doc;
 }
 
 bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const DynamicJsonDocument& doc) {
     if (!filesystem || !fn || *fn == '\0') {
-        AO_DBG_ERR("Format error");
+        MOCPP_DBG_ERR("Format error");
         return false;
     }
 
-    if (strnlen(fn, AO_MAX_PATH_SIZE) >= AO_MAX_PATH_SIZE) {
-        AO_DBG_ERR("Fn too long: %.*s", AO_MAX_PATH_SIZE, fn);
+    if (strnlen(fn, MOCPP_MAX_PATH_SIZE) >= MOCPP_MAX_PATH_SIZE) {
+        MOCPP_DBG_ERR("Fn too long: %.*s", MOCPP_MAX_PATH_SIZE, fn);
         return false;
     }
 
     if (doc.isNull() || doc.overflowed()) {
-        AO_DBG_ERR("Invalid JSON %s", fn);
+        MOCPP_DBG_ERR("Invalid JSON %s", fn);
         return false;
     }
 
     auto file = filesystem->open(fn, "w");
     if (!file) {
-        AO_DBG_ERR("Could not open file %s", fn);
+        MOCPP_DBG_ERR("Could not open file %s", fn);
         return false;
     }
 
@@ -102,16 +102,16 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
     size_t written = serializeJson(doc, fileWriter);
 
     if (written < 2) {
-        AO_DBG_ERR("Error writing file %s", fn);
+        MOCPP_DBG_ERR("Error writing file %s", fn);
         size_t file_size = 0;
         if (filesystem->stat(fn, &file_size) == 0) {
-            AO_DBG_DEBUG("Collect invalid file %s", fn);
+            MOCPP_DBG_DEBUG("Collect invalid file %s", fn);
             filesystem->remove(fn);
         }
         return false;
     }
 
-    AO_DBG_DEBUG("Wrote JSON file: %s", fn);
+    MOCPP_DBG_DEBUG("Wrote JSON file: %s", fn);
     return true;
 }
 
@@ -119,10 +119,10 @@ bool FilesystemUtils::remove_if(std::shared_ptr<FilesystemAdapter> filesystem, s
     return filesystem->ftw_root([filesystem, pred] (const char *fpath) {
         if (pred(fpath) && fpath[0] != '.') {
 
-            char fn [AO_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "%s", fpath);
-            if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-                AO_DBG_ERR("fn error: %i", ret);
+            char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "%s", fpath);
+            if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+                MOCPP_DBG_ERR("fn error: %i", ret);
                 return -1;
             }
 
diff --git a/src/MicroOcpp/Core/FilesystemUtils.h b/src/MicroOcpp/Core/FilesystemUtils.h
index 92c7ce30..4f4e3f16 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.h
+++ b/src/MicroOcpp/Core/FilesystemUtils.h
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_FILESYSTEMUTILS_H
-#define AO_FILESYSTEMUTILS_H
+#ifndef MOCPP_FILESYSTEMUTILS_H
+#define MOCPP_FILESYSTEMUTILS_H
 
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoJson.h>
 #include <memory>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class ArduinoJsonFileAdapter {
 private:
diff --git a/src/MicroOcpp/Core/OcppError.h b/src/MicroOcpp/Core/OcppError.h
index 91f9d290..0c8e4a04 100644
--- a/src/MicroOcpp/Core/OcppError.h
+++ b/src/MicroOcpp/Core/OcppError.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -7,9 +7,9 @@
 
 #include <ArduinoJson.h>
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class NotImplemented : public Operation {
 public:
@@ -39,5 +39,5 @@ class MsgBufferExceeded : public Operation {
     }
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Core/Operation.cpp b/src/MicroOcpp/Core/Operation.cpp
index c0b65c89..6bac9bc0 100644
--- a/src/MicroOcpp/Core/Operation.cpp
+++ b/src/MicroOcpp/Core/Operation.cpp
@@ -1,19 +1,19 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Operation;
+using MicroOcpp::Operation;
 
 Operation::Operation() {}
 
 Operation::~Operation() {}
   
 const char* Operation::getOperationType(){
-    AO_DBG_ERR("Unsupported operation: getOperationType() is not implemented");
+    MOCPP_DBG_ERR("Unsupported operation: getOperationType() is not implemented");
     return "CustomOperation";
 }
 
@@ -26,24 +26,24 @@ bool Operation::restore(StoredOperationHandler *rpcData) {
 }
 
 std::unique_ptr<DynamicJsonDocument> Operation::createReq() {
-    AO_DBG_ERR("Unsupported operation: createReq() is not implemented");
+    MOCPP_DBG_ERR("Unsupported operation: createReq() is not implemented");
     return nullptr;
 }
 
 void Operation::processConf(JsonObject payload) {
-    AO_DBG_ERR("Unsupported operation: processConf() is not implemented");
+    MOCPP_DBG_ERR("Unsupported operation: processConf() is not implemented");
 }
 
 void Operation::processReq(JsonObject payload) {
-    AO_DBG_ERR("Unsupported operation: processReq() is not implemented");
+    MOCPP_DBG_ERR("Unsupported operation: processReq() is not implemented");
 }
 
 std::unique_ptr<DynamicJsonDocument> Operation::createConf() {
-    AO_DBG_ERR("Unsupported operation: createConf() is not implemented");
+    MOCPP_DBG_ERR("Unsupported operation: createConf() is not implemented");
     return nullptr;
 }
 
-std::unique_ptr<DynamicJsonDocument> ArduinoOcpp::createEmptyDocument() {
+std::unique_ptr<DynamicJsonDocument> MicroOcpp::createEmptyDocument() {
     auto emptyDoc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(0));
     emptyDoc->to<JsonObject>();
     return emptyDoc;
diff --git a/src/MicroOcpp/Core/Operation.h b/src/MicroOcpp/Core/Operation.h
index 4f13d3fd..18cd9cd6 100644
--- a/src/MicroOcpp/Core/Operation.h
+++ b/src/MicroOcpp/Core/Operation.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -15,15 +15,15 @@
  * OCPP operation.
  */
 
- #ifndef AO_OPERATION_H
- #define AO_OPERATION_H
+ #ifndef MOCPP_OPERATION_H
+ #define MOCPP_OPERATION_H
 
 #include <ArduinoJson.h>
 #include <memory>
 
-#include <ArduinoOcpp/Core/RequestStore.h>
+#include <MicroOcpp/Core/RequestStore.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 std::unique_ptr<DynamicJsonDocument> createEmptyDocument();
 
@@ -73,5 +73,5 @@ class Operation {
     virtual std::unique_ptr<DynamicJsonDocument> getErrorDetails() {return createEmptyDocument();}
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
  #endif
diff --git a/src/MicroOcpp/Core/OperationRegistry.cpp b/src/MicroOcpp/Core/OperationRegistry.cpp
index 3252af5e..4700360d 100644
--- a/src/MicroOcpp/Core/OperationRegistry.cpp
+++ b/src/MicroOcpp/Core/OperationRegistry.cpp
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/OperationRegistry.h>
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Request.h>
-#include <ArduinoOcpp/Core/OcppError.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Core/OperationRegistry.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Core/OcppError.h>
+#include <MicroOcpp/Debug.h>
 #include <algorithm>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 OperationRegistry::OperationRegistry() {
 
@@ -37,14 +37,14 @@ void OperationRegistry::registerOperation(const char *operationType, std::functi
 
     registry.push_back(entry);
 
-    AO_DBG_DEBUG("registered operation %s", operationType);
+    MOCPP_DBG_DEBUG("registered operation %s", operationType);
 }
 
 void OperationRegistry::setOnRequest(const char *operationType, OnReceiveReqListener onRequest) {
     if (auto entry = findCreator(operationType)) {
         entry->onRequest = onRequest;
     } else {
-        AO_DBG_ERR("%s not registered", operationType);
+        MOCPP_DBG_ERR("%s not registered", operationType);
     }
 }
 
@@ -52,7 +52,7 @@ void OperationRegistry::setOnResponse(const char *operationType, OnSendConfListe
     if (auto entry = findCreator(operationType)) {
         entry->onResponse = onResponse;
     } else {
-        AO_DBG_ERR("%s not registered", operationType);
+        MOCPP_DBG_ERR("%s not registered", operationType);
     }
 }
 
@@ -75,6 +75,6 @@ std::unique_ptr<Request> OperationRegistry::deserializeOperation(const char *ope
 
 void OperationRegistry::debugPrint() {
     for (auto& creator : registry) {
-        AO_CONSOLE_PRINTF("[AO]     > %s\n", creator.operationType);
+        MOCPP_CONSOLE_PRINTF("[OCPP]     > %s\n", creator.operationType);
     }
 }
diff --git a/src/MicroOcpp/Core/OperationRegistry.h b/src/MicroOcpp/Core/OperationRegistry.h
index 1ea2d5a3..02dad9ff 100644
--- a/src/MicroOcpp/Core/OperationRegistry.h
+++ b/src/MicroOcpp/Core/OperationRegistry.h
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_OPERATIONREGISTRY_H
-#define AO_OPERATIONREGISTRY_H
+#ifndef MOCPP_OPERATIONREGISTRY_H
+#define MOCPP_OPERATIONREGISTRY_H
 
 #include <functional>
 #include <vector>
 #include <memory>
 #include <ArduinoJson.h>
-#include <ArduinoOcpp/Core/RequestCallbacks.h>
+#include <MicroOcpp/Core/RequestCallbacks.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Operation;
 class Request;
diff --git a/src/MicroOcpp/Core/PollResult.h b/src/MicroOcpp/Core/PollResult.h
index f6bd4934..aaa81349 100644
--- a/src/MicroOcpp/Core/PollResult.h
+++ b/src/MicroOcpp/Core/PollResult.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -6,9 +6,9 @@
 #define POLLRESULT_H
 
 #include <utility>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 template <class T>
 class PollResult {
@@ -28,7 +28,7 @@ class PollResult {
     PollResult(PollResult<T>&& other) : ready(other.ready), value(std::move(other.value)) {}
     T&& toValue() {
         if (!ready) {
-            AO_DBG_ERR("Not ready");
+            MOCPP_DBG_ERR("Not ready");
             (void)0;
         }
         ready = false;
@@ -36,7 +36,7 @@ class PollResult {
     }
     T& getValue() const {
         if (!ready) {
-            AO_DBG_ERR("Not ready");
+            MOCPP_DBG_ERR("Not ready");
             (void)0;
         }
         return *value;
diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index 72c7d378..be4d299f 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -1,22 +1,22 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Request.h>
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/RequestStore.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/RequestStore.h>
 
-#include <ArduinoOcpp/Operations/StartTransaction.h>
-#include <ArduinoOcpp/Operations/StopTransaction.h>
+#include <MicroOcpp/Operations/StartTransaction.h>
+#include <MicroOcpp/Operations/StopTransaction.h>
 
-#include <ArduinoOcpp/Platform.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Platform.h>
+#include <MicroOcpp/Debug.h>
 
 int unique_id_counter = 1000000;
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 Request::Request(std::unique_ptr<Operation> msg) : operation(std::move(msg)) {
 
@@ -39,7 +39,7 @@ void Request::setTimeout(unsigned long timeout) {
 }
 
 bool Request::isTimeoutExceeded() {
-    return timed_out || (timeout_period && ao_tick_ms() - timeout_start >= timeout_period);
+    return timed_out || (timeout_period && mocpp_tick_ms() - timeout_start >= timeout_period);
 }
 
 void Request::executeTimeout() {
@@ -56,7 +56,7 @@ unsigned int Request::getTrialNo() {
 
 void Request::setMessageID(const std::string &id){
     if (!messageID.empty()){
-        AO_DBG_WARN("MessageID is set twice or is set after first usage!");
+        MOCPP_DBG_WARN("MessageID is set twice or is set after first usage!");
     }
     messageID = id;
 }
@@ -86,8 +86,8 @@ std::unique_ptr<DynamicJsonDocument> Request::createRequest(){
     requestJson->add(operation->getOperationType());  //Action
     requestJson->add(*requestPayload);                      //Payload
 
-    if (AO_DBG_LEVEL >= AO_DL_DEBUG && ao_tick_ms() - debugRequest_start >= 10000) { //print contents on the console
-        debugRequest_start = ao_tick_ms();
+    if (MOCPP_DBG_LEVEL >= MOCPP_DL_DEBUG && mocpp_tick_ms() - debugRequest_start >= 10000) { //print contents on the console
+        debugRequest_start = mocpp_tick_ms();
 
         char *buf = new char[1024];
         size_t len = 0;
@@ -96,9 +96,9 @@ std::unique_ptr<DynamicJsonDocument> Request::createRequest(){
         }
 
         if (!buf || len < 1) {
-            AO_DBG_DEBUG("Try to send request: %s", operation->getOperationType());
+            MOCPP_DBG_DEBUG("Try to send request: %s", operation->getOperationType());
         } else {
-            AO_DBG_DEBUG("Try to send request: %.*s (...)", 128, buf);
+            MOCPP_DBG_DEBUG("Try to send request: %.*s (...)", 128, buf);
         }
 
         delete buf;
@@ -153,7 +153,7 @@ bool Request::receiveResponse(JsonArray response){
 
         return abortOperation;
     } else {
-        AO_DBG_WARN("invalid response");
+        MOCPP_DBG_WARN("invalid response");
         return false; //don't discard this message but retry sending it
     }
 
@@ -242,8 +242,8 @@ std::unique_ptr<DynamicJsonDocument> Request::createResponse(){
 
 void Request::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
 
-    timeout_start = ao_tick_ms();
-    debugRequest_start = ao_tick_ms();
+    timeout_start = mocpp_tick_ms();
+    debugRequest_start = mocpp_tick_ms();
 
     //assign messageID
     char id_str [16] = {'\0'};
@@ -274,13 +274,13 @@ void Request::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
             opStore->clearBuffer();
         }
     } else {
-        AO_DBG_ERR("Missing operation instance");
+        MOCPP_DBG_ERR("Missing operation instance");
     }
 }
 
 bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *model) {
     if (!opStorage) {
-        AO_DBG_ERR("invalid argument");
+        MOCPP_DBG_ERR("invalid argument");
         return false;
     }
 
@@ -288,14 +288,14 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
 
     auto rpcData = opStore->getRpcData();
     if (!rpcData) {
-        AO_DBG_ERR("corrupted storage");
+        MOCPP_DBG_ERR("corrupted storage");
         return false;
     }
 
     messageID = (*rpcData)[1] | std::string();
     std::string opType = (*rpcData)[2] | std::string();
     if (messageID.empty() || opType.empty()) {
-        AO_DBG_ERR("corrupted storage");
+        MOCPP_DBG_ERR("corrupted storage");
         messageID.clear();
         return false;
     }
@@ -303,11 +303,11 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
     int parsedMessageID = -1;
     if (sscanf(messageID.c_str(), "%d", &parsedMessageID) == 1) {
         if (parsedMessageID > unique_id_counter) {
-            AO_DBG_DEBUG("restore unique_id_counter with %d", parsedMessageID);
+            MOCPP_DBG_DEBUG("restore unique_id_counter with %d", parsedMessageID);
             unique_id_counter = parsedMessageID + 1; //next unique value is parsedId + 1
         }
     } else {
-        AO_DBG_ERR("cannot set unique msgID counter");
+        MOCPP_DBG_ERR("cannot set unique msgID counter");
         (void)0;
         //skip this step but don't abort restore
     }
@@ -321,7 +321,7 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
     }
 
     if (!operation) {
-        AO_DBG_ERR("cannot create msg");
+        MOCPP_DBG_ERR("cannot create msg");
         return false;
     }
 
@@ -329,10 +329,10 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
     opStore->clearBuffer();
 
     if (success) {
-        AO_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), operation->getOperationType());
+        MOCPP_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), operation->getOperationType());
         (void)0;
     } else {
-        AO_DBG_ERR("restore opNr %i error", opStore->getOpNr());
+        MOCPP_DBG_ERR("restore opNr %i error", opStore->getOpNr());
         (void)0;
     }
 
diff --git a/src/MicroOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
index a522916d..f1058b7e 100644
--- a/src/MicroOcpp/Core/Request.h
+++ b/src/MicroOcpp/Core/Request.h
@@ -1,9 +1,9 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_REQUEST_H
-#define AO_REQUEST_H
+#ifndef MOCPP_REQUEST_H
+#define MOCPP_REQUEST_H
 
 #define MESSAGE_TYPE_CALL 2
 #define MESSAGE_TYPE_CALLRESULT 3
@@ -11,9 +11,9 @@
 
 #include <memory>
 
-#include <ArduinoOcpp/Core/RequestCallbacks.h>
+#include <MicroOcpp/Core/RequestCallbacks.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Operation;
 class Model;
@@ -123,6 +123,6 @@ class Request {
     const char *getOperationType();
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
  #endif
diff --git a/src/MicroOcpp/Core/RequestCallbacks.h b/src/MicroOcpp/Core/RequestCallbacks.h
index a2e0dcc5..b7aa2909 100644
--- a/src/MicroOcpp/Core/RequestCallbacks.h
+++ b/src/MicroOcpp/Core/RequestCallbacks.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_REQUESTCALLBACKS_H
-#define AO_REQUESTCALLBACKS_H
+#ifndef MOCPP_REQUESTCALLBACKS_H
+#define MOCPP_REQUESTCALLBACKS_H
 
 #include <ArduinoJson.h>
 #include <functional>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 using OnReceiveConfListener = std::function<void(JsonObject payload)>;
 using OnReceiveReqListener = std::function<void(JsonObject payload)>;
@@ -17,5 +17,5 @@ using OnTimeoutListener = std::function<void()>;
 using OnReceiveErrorListener = std::function<void(const char *code, const char *description, JsonObject details)>; //will be called if OCPP communication partner returns error code
 using OnAbortListener = std::function<void()>; //will be called whenever the engine will stop trying to execute the operation normallythere is a timeout or error (onAbort = onTimeout || onReceiveError)
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index da79ad46..1625415e 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -1,20 +1,20 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/RequestQueue.h>
-#include <ArduinoOcpp/Core/Request.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Core/OcppError.h>
-#include <ArduinoOcpp/Core/RequestStore.h>
-#include <ArduinoOcpp/Core/OperationRegistry.h>
+#include <MicroOcpp/Core/RequestQueue.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/OcppError.h>
+#include <MicroOcpp/Core/RequestStore.h>
+#include <MicroOcpp/Core/OperationRegistry.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
 size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_size);
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 RequestQueue::RequestQueue(OperationRegistry& operationRegistry, Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
             : operationRegistry(operationRegistry) {
@@ -42,7 +42,7 @@ void RequestQueue::loop(Connection& ocppSock) {
     initiatedRequests->drop_if([] (std::unique_ptr<Request>& op) -> bool {
         bool timed_out = op->isTimeoutExceeded();
         if (timed_out) {
-            AO_DBG_INFO("operation timeout: %s", op->getOperationType());
+            MOCPP_DBG_INFO("operation timeout: %s", op->getOperationType());
             op->executeTimeout();
         }
         return timed_out;
@@ -65,7 +65,7 @@ void RequestQueue::loop(Connection& ocppSock) {
             bool success = ocppSock.sendTXT(out);
 
             if (success) {
-                AO_DBG_TRAFFIC_OUT(out.c_str());
+                MOCPP_DBG_TRAFFIC_OUT(out.c_str());
                 received = receivedRequests.erase(received);
             }
 
@@ -97,7 +97,7 @@ void RequestQueue::loop(Connection& ocppSock) {
     }
     sockTrackLastConnected = ocppSock.getLastConnected();
 
-    if (ao_tick_ms() - sendBackoffTime < sendBackoffPeriod) {
+    if (mocpp_tick_ms() - sendBackoffTime < sendBackoffPeriod) {
         //still in backoff period
         return;
     }
@@ -116,17 +116,17 @@ void RequestQueue::loop(Connection& ocppSock) {
     bool success = ocppSock.sendTXT(out);
 
     if (success) {
-        AO_DBG_TRAFFIC_OUT(out.c_str());
+        MOCPP_DBG_TRAFFIC_OUT(out.c_str());
 
         //update backoff time
-        sendBackoffTime = ao_tick_ms();
+        sendBackoffTime = mocpp_tick_ms();
         sendBackoffPeriod = std::min(sendBackoffPeriod + BACKOFF_PERIOD_INCREMENT, BACKOFF_PERIOD_MAX);
     }
 }
 
 void RequestQueue::sendRequest(std::unique_ptr<Request> op){
     if (!op) {
-        AO_DBG_ERR("Called with null. Ignore");
+        MOCPP_DBG_ERR("Called with null. Ignore");
         return;
     }
     
@@ -135,24 +135,24 @@ void RequestQueue::sendRequest(std::unique_ptr<Request> op){
 
 bool RequestQueue::receiveMessage(const char* payload, size_t length) {
 
-    AO_DBG_TRAFFIC_IN((int) length, payload);
+    MOCPP_DBG_TRAFFIC_IN((int) length, payload);
 
     size_t capacity_init = (3 * length) / 2;
 
     //capacity = ceil capacity_init to the next power of two; should be at least 128
 
     size_t capacity = 128;
-    while (capacity < capacity_init && capacity < AO_MAX_JSON_CAPACITY) {
+    while (capacity < capacity_init && capacity < MOCPP_MAX_JSON_CAPACITY) {
         capacity *= 2;
     }
-    if (capacity > AO_MAX_JSON_CAPACITY) {
-        capacity = AO_MAX_JSON_CAPACITY;
+    if (capacity > MOCPP_MAX_JSON_CAPACITY) {
+        capacity = MOCPP_MAX_JSON_CAPACITY;
     }
     
     DynamicJsonDocument doc {0};
     DeserializationError err = DeserializationError::NoMemory;
 
-    while (err == DeserializationError::NoMemory && capacity <= AO_MAX_JSON_CAPACITY) {
+    while (err == DeserializationError::NoMemory && capacity <= MOCPP_MAX_JSON_CAPACITY) {
 
         doc = DynamicJsonDocument(capacity);
         err = deserializeJson(doc, payload, length);
@@ -174,15 +174,15 @@ bool RequestQueue::receiveMessage(const char* payload, size_t length) {
                 receiveResponse(doc.as<JsonArray>());
                 success = true;
             } else {
-                AO_DBG_WARN("Invalid OCPP message! (though JSON has successfully been deserialized)");
+                MOCPP_DBG_WARN("Invalid OCPP message! (though JSON has successfully been deserialized)");
             }
             break; 
         }
         case DeserializationError::InvalidInput:
-            AO_DBG_WARN("Invalid input! Not a JSON");
+            MOCPP_DBG_WARN("Invalid input! Not a JSON");
             break;
         case DeserializationError::NoMemory: {
-            AO_DBG_WARN("incoming operation exceeds buffer capacity. Input length = %zu, max capacity = %d", length, AO_MAX_JSON_CAPACITY);
+            MOCPP_DBG_WARN("incoming operation exceeds buffer capacity. Input length = %zu, max capacity = %d", length, MOCPP_MAX_JSON_CAPACITY);
 
             /*
                 * If websocket input is of message type MESSAGE_TYPE_CALL, send back a message of type MESSAGE_TYPE_CALLERROR.
@@ -198,19 +198,19 @@ bool RequestQueue::receiveMessage(const char* payload, size_t length) {
                 int messageTypeId = doc[0] | -1;
                 if (messageTypeId == MESSAGE_TYPE_CALL) {
                     success = true;
-                    auto op = makeRequest(new MsgBufferExceeded(AO_MAX_JSON_CAPACITY, length));
+                    auto op = makeRequest(new MsgBufferExceeded(MOCPP_MAX_JSON_CAPACITY, length));
                     receiveRequest(doc.as<JsonArray>(), std::move(op));
                 } else if (messageTypeId == MESSAGE_TYPE_CALLRESULT ||
                             messageTypeId == MESSAGE_TYPE_CALLERROR) {
                     success = true;
-                    AO_DBG_WARN("crop incoming response");
+                    MOCPP_DBG_WARN("crop incoming response");
                     receiveResponse(doc.as<JsonArray>());
                 }
             }
             break;
         }
         default:
-            AO_DBG_WARN("Deserialization failed: %s", err.c_str());
+            MOCPP_DBG_WARN("Deserialization failed: %s", err.c_str());
             break;
     }
 
@@ -241,10 +241,10 @@ void RequestQueue::receiveResponse(JsonArray json) {
     if (!success) {
         //didn't find matching Request
         if (json[0] == MESSAGE_TYPE_CALLERROR) {
-            AO_DBG_DEBUG("Received CALLERROR did not abort a pending operation");
+            MOCPP_DBG_DEBUG("Received CALLERROR did not abort a pending operation");
             (void)0;
         } else {
-            AO_DBG_WARN("Received response doesn't match any pending operation");
+            MOCPP_DBG_WARN("Received response doesn't match any pending operation");
             (void)0;
         }
     }
@@ -253,7 +253,7 @@ void RequestQueue::receiveResponse(JsonArray json) {
 void RequestQueue::receiveRequest(JsonArray json) {
     auto op = operationRegistry.deserializeOperation(json[2] | "UNDEFINED");
     if (op == nullptr) {
-        AO_DBG_WARN("OOM");
+        MOCPP_DBG_WARN("OOM");
         return;
     }
     receiveRequest(json, std::move(op));
diff --git a/src/MicroOcpp/Core/RequestQueue.h b/src/MicroOcpp/Core/RequestQueue.h
index a6615337..b6b37af2 100644
--- a/src/MicroOcpp/Core/RequestQueue.h
+++ b/src/MicroOcpp/Core/RequestQueue.h
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_REQUESTQUEUE_H
-#define AO_REQUESTQUEUE_H
+#ifndef MOCPP_REQUESTQUEUE_H
+#define MOCPP_REQUESTQUEUE_H
 
-#include <ArduinoOcpp/Core/RequestQueueStorageStrategy.h>
+#include <MicroOcpp/Core/RequestQueueStorageStrategy.h>
 
 #include <deque>
 #include <memory>
 #include <ArduinoJson.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class OperationRegistry;
 class Model;
@@ -47,5 +47,5 @@ class RequestQueue {
     bool receiveMessage(const char* payload, size_t length); //receive from  server: either a request or response
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
index 0b948318..816dec3d 100644
--- a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
+++ b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
@@ -1,20 +1,20 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/RequestQueueStorageStrategy.h>
-#include <ArduinoOcpp/Core/RequestStore.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/RequestQueueStorageStrategy.h>
+#include <MicroOcpp/Core/RequestStore.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
 
-#include <ArduinoOcpp/Core/Request.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Debug.h>
 
 #include <algorithm>
 
-#define AO_OPERATIONCACHE_MAXSIZE 10
+#define MOCPP_OPERATIONCACHE_MAXSIZE 10
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 VolatileRequestQueue::VolatileRequestQueue() {
 
@@ -40,8 +40,8 @@ void VolatileRequestQueue::push_back(std::unique_ptr<Request> op) {
 
     op->initiate(nullptr);
 
-    if (queue.size() >= AO_OPERATIONCACHE_MAXSIZE) {
-        AO_DBG_WARN("unsafe number of cached operations");
+    if (queue.size() >= MOCPP_OPERATIONCACHE_MAXSIZE) {
+        MOCPP_DBG_WARN("unsafe number of cached operations");
         (void)0;
     }
 
@@ -61,7 +61,7 @@ PersistentRequestQueue::~PersistentRequestQueue() {
 
 Request *PersistentRequestQueue::front() {
     if (!head && !tailCache.empty()) {
-        AO_DBG_ERR("invalid state");
+        MOCPP_DBG_ERR("invalid state");
         pop_front();
     }
     return head.get();
@@ -71,7 +71,7 @@ void PersistentRequestQueue::pop_front() {
     
     if (head && head->getStorageHandler() && head->getStorageHandler()->getOpNr() >= 0) {
         opStore.advanceOpNr(head->getStorageHandler()->getOpNr());
-        AO_DBG_DEBUG("advanced %i to %u", head->getStorageHandler()->getOpNr(), opStore.getOpBegin());
+        MOCPP_DBG_DEBUG("advanced %i to %u", head->getStorageHandler()->getOpNr(), opStore.getOpBegin());
     }
 
     head.reset();
@@ -102,7 +102,7 @@ void PersistentRequestQueue::pop_front() {
         
         std::unique_ptr<Request> fetched;
 
-        unsigned int range = (opStore.getOpEnd() + AO_MAX_OPNR - nextOpNr) % AO_MAX_OPNR;
+        unsigned int range = (opStore.getOpEnd() + MOCPP_MAX_OPNR - nextOpNr) % MOCPP_MAX_OPNR;
         for (size_t i = 0; i < range; i++) {
             bool exists = storageHandler->restore(nextOpNr);
             if (exists) {
@@ -117,21 +117,21 @@ void PersistentRequestQueue::pop_front() {
                     break;
                 }
 
-                AO_DBG_ERR("could not restore operation");
+                MOCPP_DBG_ERR("could not restore operation");
                 fetched.reset();
                 opStore.advanceOpNr(nextOpNr);
                 nextOpNr = opStore.getOpBegin();
             } else {
                 //didn't find anything at this slot. Try next slot
                 nextOpNr++;
-                nextOpNr %= AO_MAX_OPNR;
+                nextOpNr %= MOCPP_MAX_OPNR;
             }
         }
 
         if (fetched) {
             //found operation in flash -> case B)
             head = std::move(fetched);
-            AO_DBG_DEBUG("restored operation from flash");
+            MOCPP_DBG_DEBUG("restored operation from flash");
         } else {
             //no operation anymore in flash -> case A) -> take next queued operation in tailCache
             if (tailCache.empty()) {
@@ -143,7 +143,7 @@ void PersistentRequestQueue::pop_front() {
         }
     }
 
-    AO_DBG_VERBOSE("popped front");
+    MOCPP_DBG_VERBOSE("popped front");
 }
 
 void PersistentRequestQueue::push_back(std::unique_ptr<Request> op) {
@@ -151,15 +151,15 @@ void PersistentRequestQueue::push_back(std::unique_ptr<Request> op) {
     op->initiate(opStore.makeOpHandler());
 
     if (!head && !tailCache.empty()) {
-        AO_DBG_ERR("invalid state");
+        MOCPP_DBG_ERR("invalid state");
         pop_front();
     }
 
     if (!head) {
         head = std::move(op);
     } else {
-        if (tailCache.size() >= AO_OPERATIONCACHE_MAXSIZE) {
-            AO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOperationType());
+        if (tailCache.size() >= MOCPP_OPERATIONCACHE_MAXSIZE) {
+            MOCPP_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOperationType());
             tailCache.front()->executeTimeout();
             tailCache.pop_front();
         }
diff --git a/src/MicroOcpp/Core/RequestQueueStorageStrategy.h b/src/MicroOcpp/Core/RequestQueueStorageStrategy.h
index f7844231..6d46e978 100644
--- a/src/MicroOcpp/Core/RequestQueueStorageStrategy.h
+++ b/src/MicroOcpp/Core/RequestQueueStorageStrategy.h
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef REQUESTQUEUESTORAGESTRATEGY_H
 #define REQUESTQUEUESTORAGESTRATEGY_H
 
-#include <ArduinoOcpp/Core/RequestStore.h>
+#include <MicroOcpp/Core/RequestStore.h>
 
 #include <memory>
 #include <deque>
 #include <functional>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class FilesystemAdapter;
 class Request;
diff --git a/src/MicroOcpp/Core/RequestStore.cpp b/src/MicroOcpp/Core/RequestStore.cpp
index 54ebcc10..07ac9e83 100644
--- a/src/MicroOcpp/Core/RequestStore.cpp
+++ b/src/MicroOcpp/Core/RequestStore.cpp
@@ -1,40 +1,40 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/RequestStore.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Core/RequestStore.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Debug.h>
 
-#define AO_OPSTORE_FN AO_FILENAME_PREFIX "opstore.cnf"
+#define MOCPP_OPSTORE_FN MOCPP_FILENAME_PREFIX "opstore.cnf"
 
-#define AO_OPHISTORY_SIZE 3
+#define MOCPP_OPHISTORY_SIZE 3
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 bool StoredOperationHandler::commit() {
     if (isPersistent) {
-        AO_DBG_ERR("cannot call two times");
+        MOCPP_DBG_ERR("cannot call two times");
         return false;
     }
     if (!filesystem) {
-        AO_DBG_DEBUG("filesystem");
+        MOCPP_DBG_DEBUG("filesystem");
         return false;
     }
 
     if (!rpc || !payload) {
-        AO_DBG_ERR("unitialized");
+        MOCPP_DBG_ERR("unitialized");
         return false;
     }
 
     opNr = context.reserveOpNr();
 
-    char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "op" "-%u.jsn", opNr);
-    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-        AO_DBG_ERR("fn error: %i", ret);
+    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "op" "-%u.jsn", opNr);
+    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+        MOCPP_DBG_ERR("fn error: %i", ret);
         return false;
     }
 
@@ -43,7 +43,7 @@ bool StoredOperationHandler::commit() {
     doc["payload"] = *payload;
 
     if (!FilesystemUtils::storeJson(filesystem, fn, doc)) {
-        AO_DBG_ERR("FS error");
+        MOCPP_DBG_ERR("FS error");
         return false;
     }
 
@@ -53,32 +53,32 @@ bool StoredOperationHandler::commit() {
 
 bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
     if (isPersistent) {
-        AO_DBG_ERR("cannot restore after commit");
+        MOCPP_DBG_ERR("cannot restore after commit");
         return false;
     }
     if (!filesystem) {
-        AO_DBG_DEBUG("filesystem");
+        MOCPP_DBG_DEBUG("filesystem");
         return false;
     }
 
     opNr = opNrToLoad;
 
-    char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "op" "-%u.jsn", opNr);
-    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-        AO_DBG_ERR("fn error: %i", ret);
+    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "op" "-%u.jsn", opNr);
+    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+        MOCPP_DBG_ERR("fn error: %i", ret);
         return false;
     }
 
     size_t msize;
     if (filesystem->stat(fn, &msize) != 0) {
-        AO_DBG_VERBOSE("operation %u does not exist", opNr);
+        MOCPP_DBG_VERBOSE("operation %u does not exist", opNr);
         return false;
     }
 
     auto doc = FilesystemUtils::loadJson(filesystem, fn);
     if (!doc) {
-        AO_DBG_ERR("FS error");
+        MOCPP_DBG_ERR("FS error");
         return false;
     }
     
@@ -96,36 +96,36 @@ bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
 }
 
 RequestStore::RequestStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
-    opBegin = declareConfiguration<int>("AO_opBegin", 0, AO_OPSTORE_FN, false, false, true, false);
+    opBegin = declareConfiguration<int>("MO_opBegin", 0, MOCPP_OPSTORE_FN, false, false, true, false);
 
     if (!opBegin || *opBegin < 0) {
-        AO_DBG_ERR("init failure");
+        MOCPP_DBG_ERR("init failure");
     } else if (filesystem) {
         opEnd = *opBegin;
 
         unsigned int misses = 0;
         unsigned int i = opEnd;
         while (misses < 3) {
-            char fn [AO_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "op" "-%u.jsn", i);
-            if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-                AO_DBG_ERR("fn error: %i", ret);
+            char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "op" "-%u.jsn", i);
+            if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+                MOCPP_DBG_ERR("fn error: %i", ret);
                 misses++;
-                i = (i + 1) % AO_MAX_OPNR;
+                i = (i + 1) % MOCPP_MAX_OPNR;
                 continue;
             }
 
             size_t msize;
             if (filesystem->stat(fn, &msize) != 0) {
-                AO_DBG_DEBUG("operation %u does not exist", i);
+                MOCPP_DBG_DEBUG("operation %u does not exist", i);
                 misses++;
-                i = (i + 1) % AO_MAX_OPNR;
+                i = (i + 1) % MOCPP_MAX_OPNR;
                 continue;
             }
 
             //file exists
             misses = 0;
-            i = (i + 1) % AO_MAX_OPNR;
+            i = (i + 1) % MOCPP_MAX_OPNR;
             opEnd = i;
         }
     }
@@ -136,68 +136,68 @@ std::unique_ptr<StoredOperationHandler> RequestStore::makeOpHandler() {
 }
 
 unsigned int RequestStore::reserveOpNr() {
-    AO_DBG_DEBUG("reserved opNr %u", opEnd);
+    MOCPP_DBG_DEBUG("reserved opNr %u", opEnd);
     auto res = opEnd;
     opEnd++;
-    opEnd %= AO_MAX_OPNR;
+    opEnd %= MOCPP_MAX_OPNR;
     return res;
 }
 
 void RequestStore::advanceOpNr(unsigned int oldOpNr) {
     if (!opBegin || *opBegin < 0) {
-        AO_DBG_ERR("init failure");
+        MOCPP_DBG_ERR("init failure");
         return;
     }
 
     if (oldOpNr != (unsigned int) *opBegin) {
-        if ((oldOpNr + AO_MAX_OPNR - (unsigned int) *opBegin) % AO_MAX_OPNR < 100) {
-            AO_DBG_ERR("synchronization failure - try to fix");
+        if ((oldOpNr + MOCPP_MAX_OPNR - (unsigned int) *opBegin) % MOCPP_MAX_OPNR < 100) {
+            MOCPP_DBG_ERR("synchronization failure - try to fix");
             (void)0;
         } else {
-            AO_DBG_ERR("synchronization failure");
+            MOCPP_DBG_ERR("synchronization failure");
             return;
         }
     }
 
-    unsigned int opNr = (oldOpNr + 1) % AO_MAX_OPNR;
+    unsigned int opNr = (oldOpNr + 1) % MOCPP_MAX_OPNR;
 
     //delete range [*opBegin ... opNr)
 
-    unsigned int rangeSize = (opNr + AO_MAX_OPNR - (unsigned int) *opBegin) % AO_MAX_OPNR;
+    unsigned int rangeSize = (opNr + MOCPP_MAX_OPNR - (unsigned int) *opBegin) % MOCPP_MAX_OPNR;
 
-    AO_DBG_DEBUG("delete %u operations", rangeSize);
+    MOCPP_DBG_DEBUG("delete %u operations", rangeSize);
 
     for (unsigned int i = 0; i < rangeSize; i++) {
-        unsigned int op = ((unsigned int) *opBegin + i + AO_MAX_OPNR - AO_OPHISTORY_SIZE) % AO_MAX_OPNR;
+        unsigned int op = ((unsigned int) *opBegin + i + MOCPP_MAX_OPNR - MOCPP_OPHISTORY_SIZE) % MOCPP_MAX_OPNR;
 
-        char fn [AO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "op" "-%u.jsn", op);
-        if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-            AO_DBG_ERR("fn error: %i", ret);
+        char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "op" "-%u.jsn", op);
+        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+            MOCPP_DBG_ERR("fn error: %i", ret);
             break;
         }
 
         size_t msize;
         if (filesystem->stat(fn, &msize) != 0) {
-            AO_DBG_DEBUG("operation %u does not exist", i);
+            MOCPP_DBG_DEBUG("operation %u does not exist", i);
             continue;
         }
 
         bool success = filesystem->remove(fn);
         if (!success) {
-            AO_DBG_ERR("error deleting %s", fn);
+            MOCPP_DBG_ERR("error deleting %s", fn);
             (void)0;
         }
     }
 
-    AO_DBG_DEBUG("advance opBegin: %u", opNr);
+    MOCPP_DBG_DEBUG("advance opBegin: %u", opNr);
     *opBegin = opNr;
     configuration_save();
 }
 
 unsigned int RequestStore::getOpBegin() {
     if (!opBegin || *opBegin < 0) {
-        AO_DBG_ERR("invalid state");
+        MOCPP_DBG_ERR("invalid state");
         return 0;
     }
     return (unsigned int) *opBegin;
diff --git a/src/MicroOcpp/Core/RequestStore.h b/src/MicroOcpp/Core/RequestStore.h
index 570696bd..e327bb6b 100644
--- a/src/MicroOcpp/Core/RequestStore.h
+++ b/src/MicroOcpp/Core/RequestStore.h
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_REQUESTSTORE_H
-#define AO_REQUESTSTORE_H
+#ifndef MOCPP_REQUESTSTORE_H
+#define MOCPP_REQUESTSTORE_H
 
 #include <memory>
 #include <deque>
 #include <ArduinoJson.h>
 
-#define AO_MAX_OPNR 10000
+#define MOCPP_MAX_OPNR 10000
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class RequestStore;
 class FilesystemAdapter;
diff --git a/src/MicroOcpp/Core/SimpleRequestFactory.cpp b/src/MicroOcpp/Core/SimpleRequestFactory.cpp
index 66b55fde..baf7a7ca 100644
--- a/src/MicroOcpp/Core/SimpleRequestFactory.cpp
+++ b/src/MicroOcpp/Core/SimpleRequestFactory.cpp
@@ -1,11 +1,11 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> operation){
     if (operation == nullptr) {
@@ -25,4 +25,4 @@ std::unique_ptr<Request> makeRequest(){
     return result;
 }
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/SimpleRequestFactory.h b/src/MicroOcpp/Core/SimpleRequestFactory.h
index ed099d50..499fde57 100644
--- a/src/MicroOcpp/Core/SimpleRequestFactory.h
+++ b/src/MicroOcpp/Core/SimpleRequestFactory.h
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_SIMPLEREQUESTFACTORY_H
-#define AO_SIMPLEREQUESTFACTORY_H
+#ifndef MOCPP_SIMPLEREQUESTFACTORY_H
+#define MOCPP_SIMPLEREQUESTFACTORY_H
 
 #include <ArduinoJson.h>
-#include <ArduinoOcpp/Core/Request.h>
+#include <MicroOcpp/Core/Request.h>
 #include <memory>
 #include <functional>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Operation;
 
@@ -19,5 +19,5 @@ std::unique_ptr<Request> makeRequest();
 std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> op);
 std::unique_ptr<Request> makeRequest(Operation *op); //takes ownership of op
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Core/Time.cpp b/src/MicroOcpp/Core/Time.cpp
index cc086405..6437600b 100644
--- a/src/MicroOcpp/Core/Time.cpp
+++ b/src/MicroOcpp/Core/Time.cpp
@@ -1,12 +1,12 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Time.h>
 #include <string.h>
 #include <ctype.h>	
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 const Timestamp MIN_TIME = Timestamp(2010, 0, 0, 0, 0, 0);
 const Timestamp MAX_TIME = Timestamp(2037, 0, 0, 0, 0, 0);
@@ -212,7 +212,7 @@ Timestamp &Timestamp::operator-=(int secs) {
 }
 
 int Timestamp::operator-(const Timestamp &rhs) const {
-    //dt = rhs - ocpp_base
+    //dt = rhs - mocpp_base
     
     int16_t year_base, year_end;
     if (year <= rhs.year) {
@@ -314,17 +314,17 @@ bool Clock::setTime(const char* jsonDateString) {
         return false;
     }
 
-    system_basetime = ao_tick_ms();
-    ocpp_basetime = timestamp;
+    system_basetime = mocpp_tick_ms();
+    mocpp_basetime = timestamp;
 
-    currentTime = ocpp_basetime;
+    currentTime = mocpp_basetime;
     lastUpdate = system_basetime;
 
     return true;
 }
 
 const Timestamp &Clock::now() {
-    auto tReading = ao_tick_ms();
+    auto tReading = mocpp_tick_ms();
     auto delta = tReading - lastUpdate;
 
     currentTime.addMilliseconds(delta);
@@ -336,9 +336,9 @@ const Timestamp &Clock::now() {
 Timestamp Clock::adjustPrebootTimestamp(const Timestamp& t) {
     auto systemtime_in = t - Timestamp();
     if (systemtime_in > (int) system_basetime / 1000) {
-        return ocpp_basetime;
+        return mocpp_basetime;
     }
-    return ocpp_basetime - ((int) (system_basetime / 1000) - systemtime_in);
+    return mocpp_basetime - ((int) (system_basetime / 1000) - systemtime_in);
 }
 
 }
diff --git a/src/MicroOcpp/Core/Time.h b/src/MicroOcpp/Core/Time.h
index 6b586572..97c62b02 100644
--- a/src/MicroOcpp/Core/Time.h
+++ b/src/MicroOcpp/Core/Time.h
@@ -1,19 +1,19 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_TIME_H
-#define AO_TIME_H
+#ifndef MOCPP_TIME_H
+#define MOCPP_TIME_H
 
 #include <functional>
 #include <stdint.h>
 #include <stddef.h>
 
-#include <ArduinoOcpp/Platform.h>
+#include <MicroOcpp/Platform.h>
 
 #define JSONDATE_LENGTH 24
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Timestamp {
 private:
@@ -84,9 +84,9 @@ extern const Timestamp MAX_TIME;
 class Clock {
 private:
 
-    Timestamp ocpp_basetime = Timestamp();
-    decltype(ao_tick_ms()) system_basetime = 0; //the value of ao_tick_ms() when OCPP server's time was taken
-    decltype(ao_tick_ms()) lastUpdate = 0;
+    Timestamp mocpp_basetime = Timestamp();
+    decltype(mocpp_tick_ms()) system_basetime = 0; //the value of mocpp_tick_ms() when OCPP server's time was taken
+    decltype(mocpp_tick_ms()) lastUpdate = 0;
 
     Timestamp currentTime = Timestamp();
 
diff --git a/src/MicroOcpp/Debug.h b/src/MicroOcpp/Debug.h
index a8d842eb..6ab73ed5 100644
--- a/src/MicroOcpp/Debug.h
+++ b/src/MicroOcpp/Debug.h
@@ -1,127 +1,127 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_DEBUG_H
-#define AO_DEBUG_H
+#ifndef MOCPP_DEBUG_H
+#define MOCPP_DEBUG_H
 
-#include <ArduinoOcpp/Platform.h>
+#include <MicroOcpp/Platform.h>
 
-#define AO_DL_NONE 0x00     //suppress all output to the console
-#define AO_DL_ERROR 0x01    //report failures
-#define AO_DL_WARN 0x02     //report observed or assumed inconsistent state
-#define AO_DL_INFO 0x03     //make internal state apparent
-#define AO_DL_DEBUG 0x04    //relevant info for debugging
-#define AO_DL_VERBOSE 0x05  //all output
+#define MOCPP_DL_NONE 0x00     //suppress all output to the console
+#define MOCPP_DL_ERROR 0x01    //report failures
+#define MOCPP_DL_WARN 0x02     //report observed or assumed inconsistent state
+#define MOCPP_DL_INFO 0x03     //make internal state apparent
+#define MOCPP_DL_DEBUG 0x04    //relevant info for debugging
+#define MOCPP_DL_VERBOSE 0x05  //all output
 
-#ifndef AO_DBG_LEVEL
-#define AO_DBG_LEVEL AO_DL_INFO  //default
+#ifndef MOCPP_DBG_LEVEL
+#define MOCPP_DBG_LEVEL MOCPP_DL_INFO  //default
 #endif
 
-#define AO_DF_MINIMAL 0x00   //don't reveal origin of a debug message
-#define AO_DF_MODULE_LINE 0x01 //print module by file name and line number
-#define AO_DF_FILE_LINE 0x02 //print file and line number
-#define AO_DF_FULL    0x03   //print path and file and line numbr
+#define MOCPP_DF_MINIMAL 0x00   //don't reveal origin of a debug message
+#define MOCPP_DF_MODULE_LINE 0x01 //print module by file name and line number
+#define MOCPP_DF_FILE_LINE 0x02 //print file and line number
+#define MOCPP_DF_FULL    0x03   //print path and file and line numbr
 
-#ifndef AO_DBG_FORMAT
-#define AO_DBG_FORMAT AO_DF_FILE_LINE //default
+#ifndef MOCPP_DBG_FORMAT
+#define MOCPP_DBG_FORMAT MOCPP_DF_FILE_LINE //default
 #endif
 
 
-#if AO_DBG_FORMAT == AO_DF_MINIMAL
-#define AO_DBG(level, X)   \
+#if MOCPP_DBG_FORMAT == MOCPP_DF_MINIMAL
+#define MOCPP_DBG(level, X)   \
     do {                        \
-        AO_CONSOLE_PRINTF("[AO] ");           \
-        AO_CONSOLE_PRINTF X;  \
-        AO_CONSOLE_PRINTF("\n");         \
+        MOCPP_CONSOLE_PRINTF("[OCPP] ");           \
+        MOCPP_CONSOLE_PRINTF X;  \
+        MOCPP_CONSOLE_PRINTF("\n");         \
     } while (0);
 
-#elif AO_DBG_FORMAT == AO_DF_MODULE_LINE
-#define AO_DBG(level, X)   \
+#elif MOCPP_DBG_FORMAT == MOCPP_DF_MODULE_LINE
+#define MOCPP_DBG(level, X)   \
     do {                        \
-        const char *_ao_file = __FILE__;         \
-        size_t _ao_l = sizeof(__FILE__);         \
-        size_t _ao_r = _ao_l;         \
-        while (_ao_l > 0 && _ao_file[_ao_l-1] != '/' && _ao_file[_ao_l-1] != '\\') {         \
-            _ao_l--;         \
-            if (_ao_file[_ao_l] == '.') _ao_r = _ao_l;         \
+        const char *_mo_file = __FILE__;         \
+        size_t _mo_l = sizeof(__FILE__);         \
+        size_t _mo_r = _mo_l;         \
+        while (_mo_l > 0 && _mo_file[_mo_l-1] != '/' && _mo_file[_mo_l-1] != '\\') {         \
+            _mo_l--;         \
+            if (_mo_file[_mo_l] == '.') _mo_r = _mo_l;         \
         }         \
-        AO_CONSOLE_PRINTF("[AO] %s (%.*s:%i): ",level, (int) (_ao_r - _ao_l), _ao_file + _ao_l,__LINE__);           \
-        AO_CONSOLE_PRINTF X;  \
-        AO_CONSOLE_PRINTF("\n");         \
+        MOCPP_CONSOLE_PRINTF("[OCPP] %s (%.*s:%i): ",level, (int) (_mo_r - _mo_l), _mo_file + _mo_l,__LINE__);           \
+        MOCPP_CONSOLE_PRINTF X;  \
+        MOCPP_CONSOLE_PRINTF("\n");         \
     } while (0);
 
-#elif AO_DBG_FORMAT == AO_DF_FILE_LINE
-#define AO_DBG(level, X)   \
+#elif MOCPP_DBG_FORMAT == MOCPP_DF_FILE_LINE
+#define MOCPP_DBG(level, X)   \
     do {                        \
-        const char *_ao_file = __FILE__;         \
-        size_t _ao_l = sizeof(__FILE__);         \
-        for (; _ao_l > 0 && _ao_file[_ao_l-1] != '/' && _ao_file[_ao_l-1] != '\\'; _ao_l--);         \
-        AO_CONSOLE_PRINTF("[AO] %s (%s:%i): ",level, _ao_file + _ao_l,__LINE__);           \
-        AO_CONSOLE_PRINTF X;  \
-        AO_CONSOLE_PRINTF("\n");         \
+        const char *_mo_file = __FILE__;         \
+        size_t _mo_l = sizeof(__FILE__);         \
+        for (; _mo_l > 0 && _mo_file[_mo_l-1] != '/' && _mo_file[_mo_l-1] != '\\'; _mo_l--);         \
+        MOCPP_CONSOLE_PRINTF("[OCPP] %s (%s:%i): ",level, _mo_file + _mo_l,__LINE__);           \
+        MOCPP_CONSOLE_PRINTF X;  \
+        MOCPP_CONSOLE_PRINTF("\n");         \
     } while (0);
 
-#elif AO_DBG_FORMAT == AO_DF_FULL
-#define AO_DBG(level, X)   \
+#elif MOCPP_DBG_FORMAT == MOCPP_DF_FULL
+#define MOCPP_DBG(level, X)   \
     do {                        \
-        AO_CONSOLE_PRINTF("[AO] %s (%s:%i): ",level, __FILE__,__LINE__);           \
-        AO_CONSOLE_PRINTF X;  \
-        AO_CONSOLE_PRINTF("\n");         \
+        MOCPP_CONSOLE_PRINTF("[OCPP] %s (%s:%i): ",level, __FILE__,__LINE__);           \
+        MOCPP_CONSOLE_PRINTF X;  \
+        MOCPP_CONSOLE_PRINTF("\n");         \
     } while (0);
 
 #else
-#error invalid AO_DBG_FORMAT definition
+#error invalid MOCPP_DBG_FORMAT definition
 #endif
 
 
-#if AO_DBG_LEVEL >= AO_DL_ERROR
-#define AO_DBG_ERR(...) AO_DBG("ERROR",(__VA_ARGS__))
+#if MOCPP_DBG_LEVEL >= MOCPP_DL_ERROR
+#define MOCPP_DBG_ERR(...) MOCPP_DBG("ERROR",(__VA_ARGS__))
 #else
-#define AO_DBG_ERR(...)
+#define MOCPP_DBG_ERR(...)
 #endif
 
-#if AO_DBG_LEVEL >= AO_DL_WARN
-#define AO_DBG_WARN(...) AO_DBG("warning",(__VA_ARGS__))
+#if MOCPP_DBG_LEVEL >= MOCPP_DL_WARN
+#define MOCPP_DBG_WARN(...) MOCPP_DBG("warning",(__VA_ARGS__))
 #else
-#define AO_DBG_WARN(...)
+#define MOCPP_DBG_WARN(...)
 #endif
 
-#if AO_DBG_LEVEL >= AO_DL_INFO
-#define AO_DBG_INFO(...) AO_DBG("info",(__VA_ARGS__))
+#if MOCPP_DBG_LEVEL >= MOCPP_DL_INFO
+#define MOCPP_DBG_INFO(...) MOCPP_DBG("info",(__VA_ARGS__))
 #else
-#define AO_DBG_INFO(...)
+#define MOCPP_DBG_INFO(...)
 #endif
 
-#if AO_DBG_LEVEL >= AO_DL_DEBUG
-#define AO_DBG_DEBUG(...) AO_DBG("debug",(__VA_ARGS__))
+#if MOCPP_DBG_LEVEL >= MOCPP_DL_DEBUG
+#define MOCPP_DBG_DEBUG(...) MOCPP_DBG("debug",(__VA_ARGS__))
 #else
-#define AO_DBG_DEBUG(...)
+#define MOCPP_DBG_DEBUG(...)
 #endif
 
-#if AO_DBG_LEVEL >= AO_DL_VERBOSE
-#define AO_DBG_VERBOSE(...) AO_DBG("verbose",(__VA_ARGS__))
+#if MOCPP_DBG_LEVEL >= MOCPP_DL_VERBOSE
+#define MOCPP_DBG_VERBOSE(...) MOCPP_DBG("verbose",(__VA_ARGS__))
 #else
-#define AO_DBG_VERBOSE(...)
+#define MOCPP_DBG_VERBOSE(...)
 #endif
 
-#ifdef AO_TRAFFIC_OUT
+#ifdef MOCPP_TRAFFIC_OUT
 
-#define AO_DBG_TRAFFIC_OUT(...)   \
+#define MOCPP_DBG_TRAFFIC_OUT(...)   \
     do {                        \
-        AO_CONSOLE_PRINTF("[AO] Send: %s",__VA_ARGS__);           \
-        AO_CONSOLE_PRINTF("\n");         \
+        MOCPP_CONSOLE_PRINTF("[OCPP] Send: %s",__VA_ARGS__);           \
+        MOCPP_CONSOLE_PRINTF("\n");         \
     } while (0)
 
-#define AO_DBG_TRAFFIC_IN(...)   \
+#define MOCPP_DBG_TRAFFIC_IN(...)   \
     do {                        \
-        AO_CONSOLE_PRINTF("[AO] Recv: %.*s",__VA_ARGS__);           \
-        AO_CONSOLE_PRINTF("\n");         \
+        MOCPP_CONSOLE_PRINTF("[OCPP] Recv: %.*s",__VA_ARGS__);           \
+        MOCPP_CONSOLE_PRINTF("\n");         \
     } while (0)
 
 #else
-#define AO_DBG_TRAFFIC_OUT(...)
-#define AO_DBG_TRAFFIC_IN(...)
+#define MOCPP_DBG_TRAFFIC_OUT(...)
+#define MOCPP_DBG_TRAFFIC_IN(...)
 #endif
 
 #endif
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
index b2a4cf9a..140164a8 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
@@ -1,10 +1,10 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Authorization/AuthorizationData.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationData.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 AuthorizationData::AuthorizationData() {
 
@@ -116,7 +116,7 @@ void AuthorizationData::reset() {
     idTag[0] = '\0';
 }
 
-const char *ArduinoOcpp::serializeAuthorizationStatus(AuthorizationStatus status) {
+const char *MicroOcpp::serializeAuthorizationStatus(AuthorizationStatus status) {
     switch (status) {
         case (AuthorizationStatus::Accepted):
             return "Accepted";
@@ -133,7 +133,7 @@ const char *ArduinoOcpp::serializeAuthorizationStatus(AuthorizationStatus status
     }
 }
 
-ArduinoOcpp::AuthorizationStatus ArduinoOcpp::deserializeAuthorizationStatus(const char *cstr) {
+MicroOcpp::AuthorizationStatus MicroOcpp::deserializeAuthorizationStatus(const char *cstr) {
     if (!cstr) {
         return AuthorizationStatus::UNDEFINED;
     }
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationData.h b/src/MicroOcpp/Model/Authorization/AuthorizationData.h
index 3f050771..69f1592c 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationData.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationData.h
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef AUTHORIZATIONDATA_H
 #define AUTHORIZATIONDATA_H
 
-#include <ArduinoOcpp/Operations/CiStrings.h>
-#include <ArduinoOcpp/Core/Time.h>
+#include <MicroOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Core/Time.h>
 #include <ArduinoJson.h>
 #include <memory>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 enum class AuthorizationStatus : uint8_t {
     Accepted,
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
index d8924ae6..f3414fd1 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Authorization/AuthorizationList.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationList.h>
+#include <MicroOcpp/Debug.h>
 
 #include <algorithm>
 #include <numeric>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 AuthorizationList::AuthorizationList() {
 
@@ -18,7 +18,7 @@ AuthorizationList::~AuthorizationList() {
     
 }
 
-ArduinoOcpp::AuthorizationData *AuthorizationList::get(const char *idTag) {
+MicroOcpp::AuthorizationData *AuthorizationList::get(const char *idTag) {
     //binary search
 
     if (!idTag) {
@@ -102,8 +102,8 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
         }
     }
 
-    if (resultingListLength > AO_LocalAuthListMaxLength) {
-        AO_DBG_WARN("localAuthList capacity exceeded");
+    if (resultingListLength > MOCPP_LocalAuthListMaxLength) {
+        MOCPP_DBG_WARN("localAuthList capacity exceeded");
         return false;
     }
 
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.h b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
index 936d5581..27978df2 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
@@ -1,20 +1,20 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef AUTHORIZATIONLIST_H
 #define AUTHORIZATIONLIST_H
 
-#include <ArduinoOcpp/Model/Authorization/AuthorizationData.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationData.h>
 #include <vector>
 
-#ifndef AO_LocalAuthListMaxLength
-#define AO_LocalAuthListMaxLength 48
+#ifndef MOCPP_LocalAuthListMaxLength
+#define MOCPP_LocalAuthListMaxLength 48
 #endif
 
-#define AO_SendLocalListMaxLength AO_LocalAuthListMaxLength
+#define MOCPP_SendLocalListMaxLength MOCPP_LocalAuthListMaxLength
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class AuthorizationList {
 private:
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 8be9883d..3d7f27d5 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -1,32 +1,32 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/OperationRegistry.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Operations/GetLocalListVersion.h>
-#include <ArduinoOcpp/Operations/SendLocalList.h>
-#include <ArduinoOcpp/Operations/StatusNotification.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/OperationRegistry.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Operations/GetLocalListVersion.h>
+#include <MicroOcpp/Operations/SendLocalList.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+#include <MicroOcpp/Debug.h>
 
-#define AO_LOCALAUTHORIZATIONLIST_FN (AO_FILENAME_PREFIX "localauth.jsn")
+#define MOCPP_LOCALAUTHORIZATIONLIST_FN (MOCPP_FILENAME_PREFIX "localauth.jsn")
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 AuthorizationService::AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
     localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", true, CONFIGURATION_FN, true, true, true, false);
     localAuthListEnabled = declareConfiguration<bool>("LocalAuthListEnabled", true, CONFIGURATION_FN, true, true, true, false);
-    declareConfiguration<int>("LocalAuthListMaxLength", AO_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, false, true, false, false);
-    declareConfiguration<int>("SendLocalListMaxLength", AO_SendLocalListMaxLength, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<int>("LocalAuthListMaxLength", MOCPP_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, false, true, false, false);
+    declareConfiguration<int>("SendLocalListMaxLength", MOCPP_SendLocalListMaxLength, CONFIGURATION_VOLATILE, false, true, false, false);
 
     if (!localAuthorizeOffline || !localAuthListEnabled) {
-        AO_DBG_ERR("initialization error");
+        MOCPP_DBG_ERR("initialization error");
     }
 
     //append "LocalAuthListManagement" to FeatureProfiles list
@@ -54,26 +54,26 @@ AuthorizationService::~AuthorizationService() {
 
 bool AuthorizationService::loadLists() {
     if (!filesystem) {
-        AO_DBG_WARN("no fs access");
+        MOCPP_DBG_WARN("no fs access");
         return true;
     }
 
     size_t msize = 0;
-    if (filesystem->stat(AO_LOCALAUTHORIZATIONLIST_FN, &msize) != 0) {
-        AO_DBG_DEBUG("no local authorization list stored already");
+    if (filesystem->stat(MOCPP_LOCALAUTHORIZATIONLIST_FN, &msize) != 0) {
+        MOCPP_DBG_DEBUG("no local authorization list stored already");
         return true;
     }
     
-    auto doc = FilesystemUtils::loadJson(filesystem, AO_LOCALAUTHORIZATIONLIST_FN);
+    auto doc = FilesystemUtils::loadJson(filesystem, MOCPP_LOCALAUTHORIZATIONLIST_FN);
     if (!doc) {
-        AO_DBG_ERR("failed to load %s", AO_LOCALAUTHORIZATIONLIST_FN);
+        MOCPP_DBG_ERR("failed to load %s", MOCPP_LOCALAUTHORIZATIONLIST_FN);
         return false;
     }
 
     JsonObject root = doc->as<JsonObject>();
 
     if (!localAuthorizationList.readJson(root, true)) {
-        AO_DBG_ERR("list read failure");
+        MOCPP_DBG_ERR("list read failure");
         return false;
     }
 
@@ -96,7 +96,7 @@ AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag
 
     //check status
     if (authData->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
-        AO_DBG_DEBUG("idTag %s local auth status %s", idTag, serializeAuthorizationStatus(authData->getAuthorizationStatus()));
+        MOCPP_DBG_DEBUG("idTag %s local auth status %s", idTag, serializeAuthorizationStatus(authData->getAuthorizationStatus()));
         return authData;
     }
 
@@ -112,7 +112,7 @@ bool AuthorizationService::updateLocalList(JsonObject payload) {
 
         JsonObject root = doc.to<JsonObject>();
         localAuthorizationList.writeJson(root, true);
-        success = FilesystemUtils::storeJson(filesystem, AO_LOCALAUTHORIZATIONLIST_FN, doc);
+        success = FilesystemUtils::storeJson(filesystem, MOCPP_LOCALAUTHORIZATIONLIST_FN, doc);
 
         if (!success) {
             loadLists();
@@ -158,7 +158,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     if (localStatus == AuthorizationStatus::Accepted && localInfo->getExpiryDate()) { //check for expiry
         auto& t_now = context.getModel().getClock().now();
         if (t_now > *localInfo->getExpiryDate()) {
-            AO_DBG_DEBUG("local auth expired");
+            MOCPP_DBG_DEBUG("local auth expired");
             localStatus = AuthorizationStatus::Expired;
         }
     }
@@ -166,18 +166,18 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     bool equivalent = true;
 
     if (incomingStatus != localStatus) {
-        AO_DBG_WARN("local auth list status conflict");
+        MOCPP_DBG_WARN("local auth list status conflict");
         equivalent = false;
     }
 
     //check if parentIdTag definitions mismatch
     if (equivalent &&
             strcmp(localInfo->getParentIdTag() ? localInfo->getParentIdTag() : "", idTagInfo["parentIdTag"] | "")) {
-        AO_DBG_WARN("local auth list parentIdTag conflict");
+        MOCPP_DBG_WARN("local auth list parentIdTag conflict");
         equivalent = false;
     }
 
-    AO_DBG_DEBUG("idTag %s fully evaluated: %s conflict", idTag, equivalent ? "no" : "contains");
+    MOCPP_DBG_DEBUG("idTag %s fully evaluated: %s conflict", idTag, equivalent ? "no" : "contains");
 
     if (!equivalent) {
         //send error code "LocalListConflict" to server
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.h b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
index 6ae504d1..89289ffb 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef AUTHORIZATIONSERVICE_H
 #define AUTHORIZATIONSERVICE_H
 
-#include <ArduinoOcpp/Model/Authorization/AuthorizationList.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Core/Configuration.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationList.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Configuration.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Context;
 
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index 5c717b74..fbcf3dde 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -1,26 +1,26 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <limits>
 
-#include <ArduinoOcpp/Model/Boot/BootService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Operations/BootNotification.h>
-#include <ArduinoOcpp/Platform.h>
-#include <ArduinoOcpp/Debug.h>
-
-#ifndef AO_BOOTSTATS_LONGTIME_MS
-#define AO_BOOTSTATS_LONGTIME_MS 180 * 1000
+#include <MicroOcpp/Model/Boot/BootService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Operations/BootNotification.h>
+#include <MicroOcpp/Platform.h>
+#include <MicroOcpp/Debug.h>
+
+#ifndef MOCPP_BOOTSTATS_LONGTIME_MS
+#define MOCPP_BOOTSTATS_LONGTIME_MS 180 * 1000
 #endif
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
-RegistrationStatus ArduinoOcpp::deserializeRegistrationStatus(const char *serialized) {
+RegistrationStatus MicroOcpp::deserializeRegistrationStatus(const char *serialized) {
     if (!strcmp(serialized, "Accepted")) {
         return RegistrationStatus::Accepted;
     } else if (!strcmp(serialized, "Pending")) {
@@ -28,7 +28,7 @@ RegistrationStatus ArduinoOcpp::deserializeRegistrationStatus(const char *serial
     } else if (!strcmp(serialized, "Rejected")) {
         return RegistrationStatus::Rejected;
     } else {
-        AO_DBG_ERR("deserialization error");
+        MOCPP_DBG_ERR("deserialization error");
         return RegistrationStatus::UNDEFINED;
     }
 }
@@ -36,10 +36,10 @@ RegistrationStatus ArduinoOcpp::deserializeRegistrationStatus(const char *serial
 BootService::BootService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
     //if transactions can start before the BootNotification succeeds
-    preBootTransactions = declareConfiguration<bool>("AO_PreBootTransactions", false, CONFIGURATION_FN, true, true, true, false);
+    preBootTransactions = declareConfiguration<bool>("MO_PreBootTransactions", false, CONFIGURATION_FN, true, true, true, false);
     
     if (!preBootTransactions) {
-        AO_DBG_ERR("initialization error");
+        MOCPP_DBG_ERR("initialization error");
         (void)0;
     }
 
@@ -52,12 +52,12 @@ void BootService::loop() {
 
     if (!executedFirstTime) {
         executedFirstTime = true;
-        firstExecutionTimestamp = ao_tick_ms();
+        firstExecutionTimestamp = mocpp_tick_ms();
     }
 
-    if (!executedLongTime && ao_tick_ms() - firstExecutionTimestamp >= AO_BOOTSTATS_LONGTIME_MS) {
+    if (!executedLongTime && mocpp_tick_ms() - firstExecutionTimestamp >= MOCPP_BOOTSTATS_LONGTIME_MS) {
         executedLongTime = true;
-        AO_DBG_DEBUG("boot success timer reached");
+        MOCPP_DBG_DEBUG("boot success timer reached");
         BootStats bootstats;
         loadBootStats(filesystem, bootstats);
         bootstats.lastBootSuccess = bootstats.bootNr;
@@ -78,7 +78,7 @@ void BootService::loop() {
         return;
     }
     
-    if (ao_tick_ms() - lastBootNotification < (interval_s * 1000UL)) {
+    if (mocpp_tick_ms() - lastBootNotification < (interval_s * 1000UL)) {
         return;
     }
 
@@ -90,13 +90,13 @@ void BootService::loop() {
     bootNotification->setTimeout(interval_s * 1000UL);
     context.initiatePreBootOperation(std::move(bootNotification));
 
-    lastBootNotification = ao_tick_ms();
+    lastBootNotification = mocpp_tick_ms();
 }
 
 void BootService::setChargePointCredentials(JsonObject credentials) {
     auto written = serializeJson(credentials, cpCredentials);
     if (written < 2) {
-        AO_DBG_ERR("serialization error");
+        MOCPP_DBG_ERR("serialization error");
         cpCredentials = "{}";
     }
 }
@@ -116,7 +116,7 @@ std::unique_ptr<DynamicJsonDocument> BootService::getChargePointCredentials() {
     std::unique_ptr<DynamicJsonDocument> doc;
     size_t capacity = JSON_OBJECT_SIZE(9) + cpCredentials.size();
     DeserializationError err = DeserializationError::NoMemory;
-    while (err == DeserializationError::NoMemory && capacity <= AO_MAX_JSON_CAPACITY) {
+    while (err == DeserializationError::NoMemory && capacity <= MOCPP_MAX_JSON_CAPACITY) {
         doc.reset(new DynamicJsonDocument(capacity));
         err = deserializeJson(*doc, cpCredentials);
 
@@ -126,23 +126,23 @@ std::unique_ptr<DynamicJsonDocument> BootService::getChargePointCredentials() {
     if (!err) {
         return doc;
     } else {
-        AO_DBG_ERR("could not parse stored credentials: %s", err.c_str());
+        MOCPP_DBG_ERR("could not parse stored credentials: %s", err.c_str());
         return nullptr;
     }
 }
 
 void BootService::notifyRegistrationStatus(RegistrationStatus status) {
     this->status = status;
-    lastBootNotification = ao_tick_ms();
+    lastBootNotification = mocpp_tick_ms();
 }
 
 void BootService::setRetryInterval(unsigned long interval_s) {
     if (interval_s == 0) {
-        this->interval_s = AO_BOOT_INTERVAL_DEFAULT;
+        this->interval_s = MOCPP_BOOT_INTERVAL_DEFAULT;
     } else {
         this->interval_s = interval_s;
     }
-    lastBootNotification = ao_tick_ms();
+    lastBootNotification = mocpp_tick_ms();
 }
 
 bool BootService::loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& bstats) {
@@ -151,11 +151,11 @@ bool BootService::loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, B
     }
 
     size_t msize = 0;
-    if (filesystem->stat(AO_FILENAME_PREFIX "bootstats.jsn", &msize) == 0) {
+    if (filesystem->stat(MOCPP_FILENAME_PREFIX "bootstats.jsn", &msize) == 0) {
         
         bool success = true;
 
-        auto json = FilesystemUtils::loadJson(filesystem, AO_FILENAME_PREFIX "bootstats.jsn");
+        auto json = FilesystemUtils::loadJson(filesystem, MOCPP_FILENAME_PREFIX "bootstats.jsn");
         if (json) {
             int bootNrIn = (*json)["bootNr"] | -1;
             if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
@@ -175,8 +175,8 @@ bool BootService::loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, B
         }
 
         if (!success) {
-            AO_DBG_ERR("bootstats corrupted");
-            filesystem->remove(AO_FILENAME_PREFIX "bootstats.jsn");
+            MOCPP_DBG_ERR("bootstats corrupted");
+            filesystem->remove(MOCPP_FILENAME_PREFIX "bootstats.jsn");
             bstats = BootStats();
         }
 
@@ -196,5 +196,5 @@ bool BootService::storeBootStats(std::shared_ptr<FilesystemAdapter> filesystem,
     json["bootNr"] = bstats.bootNr;
     json["lastSuccess"] = bstats.lastBootSuccess;
 
-    return FilesystemUtils::storeJson(filesystem, AO_FILENAME_PREFIX "bootstats.jsn", json);
+    return FilesystemUtils::storeJson(filesystem, MOCPP_FILENAME_PREFIX "bootstats.jsn", json);
 }
diff --git a/src/MicroOcpp/Model/Boot/BootService.h b/src/MicroOcpp/Model/Boot/BootService.h
index 4844e8d4..ba3017f6 100644
--- a/src/MicroOcpp/Model/Boot/BootService.h
+++ b/src/MicroOcpp/Model/Boot/BootService.h
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef BOOTSERVICE_H
 #define BOOTSERVICE_H
 
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <memory>
 
-#define AO_BOOT_INTERVAL_DEFAULT 60
+#define MOCPP_BOOT_INTERVAL_DEFAULT 60
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 struct BootStats {
     uint16_t bootNr = 0;
@@ -38,7 +38,7 @@ class BootService {
     Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
 
-    unsigned long interval_s = AO_BOOT_INTERVAL_DEFAULT;
+    unsigned long interval_s = MOCPP_BOOT_INTERVAL_DEFAULT;
     unsigned long lastBootNotification = -1UL / 2;
 
     RegistrationStatus status = RegistrationStatus::Pending;
diff --git a/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h b/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
index 632b37d3..95a82e5e 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
@@ -1,11 +1,11 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_CHARGEPOINTERRORCODE_H
-#define AO_CHARGEPOINTERRORCODE_H
+#ifndef MOCPP_CHARGEPOINTERRORCODE_H
+#define MOCPP_CHARGEPOINTERRORCODE_H
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 struct ErrorData {
     bool isError = false; //if any error information is set
diff --git a/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h b/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
index 3504a8c0..308e04b8 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
@@ -1,11 +1,11 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef OCPP_EVSE_STATE
 #define OCPP_EVSE_STATE
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 enum class ChargePointStatus {
     Available,
@@ -20,6 +20,6 @@ enum class ChargePointStatus {
     NOT_SET //internal value for "undefined"
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 959107df..0a200398 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -1,38 +1,38 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
 
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Request.h>
-#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Core/Configuration.h>
 
-#include <ArduinoOcpp/Operations/Authorize.h>
-#include <ArduinoOcpp/Operations/StatusNotification.h>
-#include <ArduinoOcpp/Operations/StartTransaction.h>
-#include <ArduinoOcpp/Operations/StopTransaction.h>
-#include <ArduinoOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Operations/Authorize.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+#include <MicroOcpp/Operations/StartTransaction.h>
+#include <MicroOcpp/Operations/StopTransaction.h>
+#include <MicroOcpp/Operations/CiStrings.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
-#include <ArduinoOcpp/Model/Metering/MeteringService.h>
-#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Model/Metering/MeteringService.h>
+#include <MicroOcpp/Model/Reservation/ReservationService.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
 
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
 
-using namespace ArduinoOcpp;
-using namespace ArduinoOcpp::Ocpp16;
+using namespace MicroOcpp;
+using namespace MicroOcpp::Ocpp16;
 
 Connector::Connector(Context& context, int connectorId)
         : context(context), model(context.getModel()), connectorId{connectorId} {
 
     char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
-    snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, "AO_AVAIL_CONN_%d", connectorId);
-    availability = declareConfiguration<bool>(availabilityKey, true, AO_KEYVALUE_FN, false, false, true, false);
+    snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, "MO_AVAIL_CONN_%d", connectorId);
+    availability = declareConfiguration<bool>(availabilityKey, true, MOCPP_KEYVALUE_FN, false, false, true, false);
 
     connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN, true, true, true, false);
     minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
@@ -40,26 +40,26 @@ Connector::Connector(Context& context, int connectorId)
     stopTransactionOnEVSideDisconnect = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
     unlockConnectorOnEVSideDisconnect = declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
     localPreAuthorize = declareConfiguration<bool>("LocalPreAuthorize", false, CONFIGURATION_FN, true, true, true, false);
-    allowOfflineTxForUnknownId = ArduinoOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", false, CONFIGURATION_FN);
+    allowOfflineTxForUnknownId = MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", false, CONFIGURATION_FN);
 
     //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
-    silentOfflineTransactions = declareConfiguration<bool>("AO_SilentOfflineTransactions", false, CONFIGURATION_FN, true, true, true, false);
+    silentOfflineTransactions = declareConfiguration<bool>("MO_SilentOfflineTransactions", false, CONFIGURATION_FN, true, true, true, false);
 
     //how long the EVSE tries the Authorize request before it enters offline mode
-    authorizationTimeout = ArduinoOcpp::declareConfiguration<int>("AO_AuthorizationTimeout", 20, CONFIGURATION_FN);
+    authorizationTimeout = MicroOcpp::declareConfiguration<int>("MO_AuthorizationTimeout", 20, CONFIGURATION_FN);
 
     //FreeVend mode
-    freeVendActive = declareConfiguration<bool>("AO_FreeVendActive", false, CONFIGURATION_FN, true, true, true, false);
-    freeVendIdTag = declareConfiguration<const char*>("AO_FreeVendIdTag", "", CONFIGURATION_FN, true, true, true, false);
+    freeVendActive = declareConfiguration<bool>("MO_FreeVendActive", false, CONFIGURATION_FN, true, true, true, false);
+    freeVendIdTag = declareConfiguration<const char*>("MO_FreeVendIdTag", "", CONFIGURATION_FN, true, true, true, false);
 
     if (!availability) {
-        AO_DBG_ERR("Cannot declare availability");
+        MOCPP_DBG_ERR("Cannot declare availability");
     }
 
     if (model.getTransactionStore()) {
         transaction = model.getTransactionStore()->getLatestTransaction(connectorId);
     } else {
-        AO_DBG_ERR("must initialize TxStore before Connector");
+        MOCPP_DBG_ERR("must initialize TxStore before Connector");
         (void)0;
     }
 }
@@ -116,13 +116,13 @@ ChargePointStatus Connector::getStatus() {
         }
     }
 
-    AO_DBG_DEBUG("status undefined");
+    MOCPP_DBG_DEBUG("status undefined");
     return ChargePointStatus::Faulted; //internal error
 }
 
 bool Connector::ocppPermitsCharge() {
     if (connectorId == 0) {
-        AO_DBG_WARN("not supported for connectorId == 0");
+        MOCPP_DBG_WARN("not supported for connectorId == 0");
         return false;
     }
 
@@ -162,12 +162,12 @@ void Connector::loop() {
             model.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr()); //roll back creation of last tx entry
         }
 
-        AO_DBG_DEBUG("collect aborted transaction %u-%u %s", connectorId, transaction->getTxNr(), removed ? "" : "failure");
+        MOCPP_DBG_DEBUG("collect aborted transaction %u-%u %s", connectorId, transaction->getTxNr(), removed ? "" : "failure");
         transaction = nullptr;
     }
 
     if (transaction && transaction->isCompleted()) {
-        AO_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
+        MOCPP_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
         transaction = nullptr;
     }
 
@@ -176,7 +176,7 @@ void Connector::loop() {
         if (connectorPluggedInput) {
             if (transaction->isRunning() && transaction->isActive() && !connectorPluggedInput()) {
                 if (!stopTransactionOnEVSideDisconnect || *stopTransactionOnEVSideDisconnect) {
-                    AO_DBG_DEBUG("Stop Tx due to EV disconnect");
+                    MOCPP_DBG_DEBUG("Stop Tx due to EV disconnect");
                     transaction->setStopReason("EVDisconnected");
                     transaction->setInactive();
                     transaction->commit();
@@ -190,7 +190,7 @@ void Connector::loop() {
                 connectionTimeOut && *connectionTimeOut > 0 &&
                 model.getClock().now() - transaction->getBeginTimestamp() >= *connectionTimeOut) {
                 
-            AO_DBG_INFO("Session mngt: timeout");
+            MOCPP_DBG_INFO("Session mngt: timeout");
             transaction->setInactive();
             transaction->commit();
 
@@ -202,7 +202,7 @@ void Connector::loop() {
                     !transaction->isRunning() ||        //if transaction hasn't started yet, always end
                     !stopTransactionOnInvalidId || *stopTransactionOnInvalidId)) { //if transaction is running, behavior depends on StopTransactionOnInvalidId
             
-            AO_DBG_DEBUG("DeAuthorize session");
+            MOCPP_DBG_DEBUG("DeAuthorize session");
             transaction->setStopReason("DeAuthorized");
             transaction->setInactive();
             transaction->commit();
@@ -221,7 +221,7 @@ void Connector::loop() {
                     (!startTxReadyInput || startTxReadyInput())) { //if defined, user Input for allowing StartTx must be true
                 //start Transaction
 
-                AO_DBG_INFO("Session mngt: trigger StartTransaction");
+                MOCPP_DBG_INFO("Session mngt: trigger StartTransaction");
 
                 auto meteringService = model.getMeteringService();
                 if (transaction->getMeterStart() < 0 && meteringService) {
@@ -229,7 +229,7 @@ void Connector::loop() {
                     if (meterStart && *meterStart) {
                         transaction->setMeterStart(meterStart->toInteger());
                     } else {
-                        AO_DBG_ERR("MeterStart undefined");
+                        MOCPP_DBG_ERR("MeterStart undefined");
                     }
                 }
 
@@ -241,7 +241,7 @@ void Connector::loop() {
                 updateTxNotification(TxNotification::StartTx);
 
                 if (transaction->isSilent()) {
-                    AO_DBG_INFO("silent Transaction: omit StartTx");
+                    MOCPP_DBG_INFO("silent Transaction: omit StartTx");
                     transaction->getStartSync().setRequested();
                     transaction->getStartSync().confirm();
                     transaction->commit();
@@ -274,10 +274,10 @@ void Connector::loop() {
                     (!stopTxReadyInput || stopTxReadyInput())) {
                 //stop transaction
 
-                AO_DBG_INFO("Session mngt: trigger StopTransaction");
+                MOCPP_DBG_INFO("Session mngt: trigger StopTransaction");
 
                 if (transaction->isSilent()) {
-                    AO_DBG_INFO("silent Transaction: omit StopTx");
+                    MOCPP_DBG_INFO("silent Transaction: omit StopTx");
                     updateTxNotification(TxNotification::StopTx);
                     transaction->getStopSync().setRequested();
                     transaction->getStopSync().confirm();
@@ -296,7 +296,7 @@ void Connector::loop() {
                     if (meterStop && *meterStop) {
                         transaction->setMeterStop(meterStop->toInteger());
                     } else {
-                        AO_DBG_ERR("MeterStop undefined");
+                        MOCPP_DBG_ERR("MeterStop undefined");
                     }
                 }
 
@@ -336,11 +336,11 @@ void Connector::loop() {
             if (!idTag || *idTag == '\0') {
                 idTag = "A0000000";
             }
-            AO_DBG_INFO("begin FreeVend Tx using idTag %s", idTag);
+            MOCPP_DBG_INFO("begin FreeVend Tx using idTag %s", idTag);
             beginTransaction_authorized(idTag);
             
             if (!transaction) {
-                AO_DBG_ERR("could not begin FreeVend Tx");
+                MOCPP_DBG_ERR("could not begin FreeVend Tx");
                 (void)0;
             }
         }
@@ -371,17 +371,17 @@ void Connector::loop() {
     
     if (status != currentStatus) {
         currentStatus = status;
-        t_statusTransition = ao_tick_ms();
-        AO_DBG_DEBUG("Status changed%s", *minimumStatusDuration ? ", will report delayed" : "");
+        t_statusTransition = mocpp_tick_ms();
+        MOCPP_DBG_DEBUG("Status changed%s", *minimumStatusDuration ? ", will report delayed" : "");
     }
 
     if (reportedStatus != currentStatus &&
             model.getClock().now() >= Timestamp(2010,0,0,0,0,0) &&
             (*minimumStatusDuration <= 0 || //MinimumStatusDuration disabled
-            ao_tick_ms() - t_statusTransition >= ((unsigned long) *minimumStatusDuration) * 1000UL)) {
+            mocpp_tick_ms() - t_statusTransition >= ((unsigned long) *minimumStatusDuration) * 1000UL)) {
         reportedStatus = currentStatus;
         Timestamp reportedTimestamp = model.getClock().now();
-        reportedTimestamp -= (ao_tick_ms() - t_statusTransition) / 1000UL;
+        reportedTimestamp -= (mocpp_tick_ms() - t_statusTransition) / 1000UL;
 
         auto statusNotification = makeRequest(
                 new StatusNotification(connectorId, reportedStatus, reportedTimestamp, getErrorCode()));
@@ -436,9 +436,9 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
             }
             if (removed) {
                 model.getTransactionStore()->setTxEnd(connectorId, txr);
-                AO_DBG_WARN("deleted dangling silent or aborted tx for new transaction");
+                MOCPP_DBG_WARN("deleted dangling silent or aborted tx for new transaction");
             } else {
-                AO_DBG_ERR("memory corruption");
+                MOCPP_DBG_ERR("memory corruption");
                 break;
             }
         } else {
@@ -478,16 +478,16 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
                 }
                 if (removed) {
                     model.getTransactionStore()->setTxBegin(connectorId, (txl + 1) % MAX_TX_CNT);
-                    AO_DBG_DEBUG("deleted tx history entry for new transaction");
+                    MOCPP_DBG_DEBUG("deleted tx history entry for new transaction");
 
                     tx = model.getTransactionStore()->createTransaction(connectorId);
                 } else {
-                    AO_DBG_ERR("memory corruption");
+                    MOCPP_DBG_ERR("memory corruption");
                     break;
                 }
             } else {
                 //no, end of history reached, don't delete further tx
-                AO_DBG_DEBUG("cannot delete more tx");
+                MOCPP_DBG_DEBUG("cannot delete more tx");
                 break;
             }
 
@@ -503,7 +503,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
             tx = model.getTransactionStore()->createTransaction(connectorId, true);
 
             if (tx) {
-                AO_DBG_DEBUG("created silent transaction");
+                MOCPP_DBG_DEBUG("created silent transaction");
                 (void)0;
             }
         }
@@ -515,7 +515,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
 std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     if (transaction) {
-        AO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
+        MOCPP_DBG_WARN("tx process still running. Please call endTransaction(...) before");
         return nullptr;
     }
 
@@ -539,13 +539,13 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                         idTag,
                         localAuth->getParentIdTag() ? localAuth->getParentIdTag() : nullptr)) {
                 //reservation found for connector but does not match idTag or parentIdTag
-                AO_DBG_DEBUG("reservation blocks local auth at connector %u", connectorId);
+                MOCPP_DBG_DEBUG("reservation blocks local auth at connector %u", connectorId);
                 localAuth = nullptr;;
             }
         }
 
         if (localAuth && localAuth->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
-            AO_DBG_DEBUG("local auth denied (%s)", idTag);
+            MOCPP_DBG_DEBUG("local auth denied (%s)", idTag);
             localAuth = nullptr;
         }
 
@@ -553,7 +553,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         if (localAuth && localAuth->getExpiryDate()) {
             auto& tnow = model.getClock().now();
             if (tnow >= *localAuth->getExpiryDate()) {
-                AO_DBG_DEBUG("idTag %s local auth entry expired", idTag);
+                MOCPP_DBG_DEBUG("idTag %s local auth entry expired", idTag);
                 localAuth = nullptr;
                 expiredLocalAuth = true;
             }
@@ -563,7 +563,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     transaction = allocateTransaction();
 
     if (!transaction) {
-        AO_DBG_ERR("could not allocate Tx");
+        MOCPP_DBG_ERR("could not allocate Tx");
         return nullptr;
     }
 
@@ -576,12 +576,12 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     transaction->setBeginTimestamp(model.getClock().now());
 
-    AO_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
+    MOCPP_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
 
     //check for local preauthorization
     if (localPreAuthorize && *localPreAuthorize) {
         if (localAuth && localAuth->getAuthorizationStatus() == AuthorizationStatus::Accepted) {
-            AO_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
+            MOCPP_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
 
             transaction->setAuthorized();
 
@@ -599,7 +599,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         if (strcmp("Accepted", idTagInfo["status"] | "UNDEFINED")) {
             //Authorization rejected, abort transaction
-            AO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->getIdTag());
+            MOCPP_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->getIdTag());
             tx->setIdTagDeauthorized();
             tx->commit();
             updateTxNotification(TxNotification::AuthorizationRejected);
@@ -615,7 +615,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                         tx->getIdTag(),
                         idTagInfo["parentIdTag"] | (const char*) nullptr)) {
                 //reservation found for connector but does not match idTag or parentIdTag
-                AO_DBG_INFO("connector %u reserved - abort transaction", connectorId);
+                MOCPP_DBG_INFO("connector %u reserved - abort transaction", connectorId);
                 tx->setInactive();
                 tx->commit();
                 updateTxNotification(TxNotification::ReservationConflict);
@@ -623,7 +623,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             }
         }
 
-        AO_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
+        MOCPP_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
         tx->setAuthorized();
         tx->commit();
 
@@ -633,7 +633,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         if (expiredLocalAuth) {
             //local auth entry exists, but is expired -> avoid offline tx
-            AO_DBG_DEBUG("Abort transaction process (%s), timeout, expired local auth", tx->getIdTag());
+            MOCPP_DBG_DEBUG("Abort transaction process (%s), timeout, expired local auth", tx->getIdTag());
             tx->setInactive();
             tx->commit();
             updateTxNotification(TxNotification::AuthorizationTimeout);
@@ -641,7 +641,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         }
         
         if (localAuth) {
-            AO_DBG_DEBUG("Offline transaction process (%s), locally authorized", tx->getIdTag());
+            MOCPP_DBG_DEBUG("Offline transaction process (%s), locally authorized", tx->getIdTag());
             tx->setAuthorized();
             tx->commit();
 
@@ -656,7 +656,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             if (reservation && !reservation->matches(
                         tx->getIdTag())) {
                 //reservation found for connector but does not match idTag or parentIdTag
-                AO_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
+                MOCPP_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
                 tx->setInactive();
                 tx->commit();
                 updateTxNotification(TxNotification::ReservationConflict);
@@ -665,14 +665,14 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         }
 
         if (allowOfflineTxForUnknownId && (bool) *allowOfflineTxForUnknownId) {
-            AO_DBG_DEBUG("Offline transaction process (%s), allow unknown ID", tx->getIdTag());
+            MOCPP_DBG_DEBUG("Offline transaction process (%s), allow unknown ID", tx->getIdTag());
             tx->setAuthorized();
             tx->commit();
             updateTxNotification(TxNotification::Authorized);
             return;
         }
         
-        AO_DBG_DEBUG("Abort transaction process (%s): timeout", tx->getIdTag());
+        MOCPP_DBG_DEBUG("Abort transaction process (%s): timeout", tx->getIdTag());
         tx->setInactive();
         tx->commit();
         updateTxNotification(TxNotification::AuthorizationTimeout);
@@ -686,14 +686,14 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
     
     if (transaction) {
-        AO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
+        MOCPP_DBG_WARN("tx process still running. Please call endTransaction(...) before");
         return nullptr;
     }
 
     transaction = allocateTransaction();
 
     if (!transaction) {
-        AO_DBG_ERR("could not allocate Tx");
+        MOCPP_DBG_ERR("could not allocate Tx");
         return nullptr;
     }
 
@@ -706,7 +706,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
 
     transaction->setBeginTimestamp(model.getClock().now());
     
-    AO_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
+    MOCPP_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
 
     transaction->setAuthorized();
     
@@ -733,11 +733,11 @@ void Connector::endTransaction(const char *idTag, const char *reason) {
     if (idTag && *idTag != '\0' && !strcmp(idTag, transaction->getIdTag())) {
         //given stop idTag differs from start idTag. Make Authorization check first
 
-        AO_DBG_WARN("authorization status of stop idTag not checked automatically yet");
+        MOCPP_DBG_WARN("authorization status of stop idTag not checked automatically yet");
         (void)0;
     }
 
-    AO_DBG_DEBUG("End session started by idTag %s",
+    MOCPP_DBG_DEBUG("End session started by idTag %s",
                             transaction->getIdTag());
     
     if (idTag && *idTag != '\0') {
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 50603ef4..7e3e8333 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -1,22 +1,22 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CONNECTOR_H
 #define CONNECTOR_H
 
-#include <ArduinoOcpp/Model/ConnectorBase/ChargePointStatus.h>
-#include <ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Notification.h>
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
-#include <ArduinoOcpp/Core/PollResult.h>
-#include <ArduinoOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
+#include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
+#include <MicroOcpp/Model/ConnectorBase/Notification.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/PollResult.h>
+#include <MicroOcpp/Operations/CiStrings.h>
 
 #include <vector>
 #include <functional>
 #include <memory>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Context;
 class Model;
@@ -122,5 +122,5 @@ class Connector {
     void updateTxNotification(TxNotification event);
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index 7fc0c16b..f7147d64 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -1,30 +1,30 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <string>
 
-#include <ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Operations/ChangeAvailability.h>
-#include <ArduinoOcpp/Operations/ChangeConfiguration.h>
-#include <ArduinoOcpp/Operations/ClearCache.h>
-#include <ArduinoOcpp/Operations/GetConfiguration.h>
-#include <ArduinoOcpp/Operations/RemoteStartTransaction.h>
-#include <ArduinoOcpp/Operations/RemoteStopTransaction.h>
-#include <ArduinoOcpp/Operations/Reset.h>
-#include <ArduinoOcpp/Operations/TriggerMessage.h>
-#include <ArduinoOcpp/Operations/UnlockConnector.h>
+#include <MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Operations/ChangeAvailability.h>
+#include <MicroOcpp/Operations/ChangeConfiguration.h>
+#include <MicroOcpp/Operations/ClearCache.h>
+#include <MicroOcpp/Operations/GetConfiguration.h>
+#include <MicroOcpp/Operations/RemoteStartTransaction.h>
+#include <MicroOcpp/Operations/RemoteStopTransaction.h>
+#include <MicroOcpp/Operations/Reset.h>
+#include <MicroOcpp/Operations/TriggerMessage.h>
+#include <MicroOcpp/Operations/UnlockConnector.h>
 
-#include <ArduinoOcpp/Operations/Authorize.h>
-#include <ArduinoOcpp/Operations/StartTransaction.h>
-#include <ArduinoOcpp/Operations/StatusNotification.h>
-#include <ArduinoOcpp/Operations/StopTransaction.h>
+#include <MicroOcpp/Operations/Authorize.h>
+#include <MicroOcpp/Operations/StartTransaction.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+#include <MicroOcpp/Operations/StopTransaction.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 ConnectorsCommon::ConnectorsCommon(Context& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context) {
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
index 7851d04c..b3848a5d 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CHARGECONTROLCOMMON_H
 #define CHARGECONTROLCOMMON_H
 
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Context;
 
@@ -20,6 +20,6 @@ class ConnectorsCommon {
     void loop();
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Model/ConnectorBase/Notification.cpp b/src/MicroOcpp/Model/ConnectorBase/Notification.cpp
index 6684441e..2e0b53d5 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Notification.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Notification.cpp
@@ -1,48 +1,48 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/ConnectorBase/Notification.h>
+#include <MicroOcpp/Model/ConnectorBase/Notification.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
-AO_TxNotification convertTxNotification(TxNotification txn) {
-    auto res = AO_TxNotification::AuthorizationRejected;
+OCPP_TxNotification convertTxNotification(TxNotification txn) {
+    auto res = OCPP_TxNotification::AuthorizationRejected;
     
     switch (txn) {
         case TxNotification::AuthorizationRejected:
-            res = AO_TxNotification::AuthorizationRejected;
+            res = OCPP_TxNotification::AuthorizationRejected;
             break;
         case TxNotification::AuthorizationTimeout:
-            res = AO_TxNotification::AuthorizationTimeout;
+            res = OCPP_TxNotification::AuthorizationTimeout;
             break;
         case TxNotification::Authorized:
-            res = AO_TxNotification::Authorized;
+            res = OCPP_TxNotification::Authorized;
             break;
         case TxNotification::ConnectionTimeout:
-            res = AO_TxNotification::ConnectionTimeout;
+            res = OCPP_TxNotification::ConnectionTimeout;
             break;
         case TxNotification::DeAuthorized:
-            res = AO_TxNotification::DeAuthorized;
+            res = OCPP_TxNotification::DeAuthorized;
             break;
         case TxNotification::RemoteStart:
-            res = AO_TxNotification::RemoteStart;
+            res = OCPP_TxNotification::RemoteStart;
             break;
         case TxNotification::RemoteStop:
-            res = AO_TxNotification::RemoteStop;
+            res = OCPP_TxNotification::RemoteStop;
             break;
         case TxNotification::ReservationConflict:
-            res = AO_TxNotification::ReservationConflict;
+            res = OCPP_TxNotification::ReservationConflict;
             break;
         case TxNotification::StartTx:
-            res = AO_TxNotification::StartTx;
+            res = OCPP_TxNotification::StartTx;
             break;
         case TxNotification::StopTx:
-            res = AO_TxNotification::StopTx;
+            res = OCPP_TxNotification::StopTx;
             break;
     }
 
     return res;
 }
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/ConnectorBase/Notification.h b/src/MicroOcpp/Model/ConnectorBase/Notification.h
index 2c660cdd..bee6cea0 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Notification.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Notification.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_NOTIFICATION_H
-#define AO_NOTIFICATION_H
+#ifndef MOCPP_NOTIFICATION_H
+#define MOCPP_NOTIFICATION_H
 
 #ifdef __cplusplus
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 enum class TxNotification {
     //Authorization events
@@ -26,12 +26,12 @@ enum class TxNotification {
     StopTx,
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 extern "C" {
 #endif //__cplusplus
 
-enum AO_TxNotification {
+enum OCPP_TxNotification {
     //Authorization events
     Authorized, //success
     AuthorizationRejected, //IdTag not authorized
@@ -51,11 +51,11 @@ enum AO_TxNotification {
 #ifdef __cplusplus
 } //end extern "C"
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
-AO_TxNotification convertTxNotification(TxNotification txn);
+OCPP_TxNotification convertTxNotification(TxNotification txn);
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif //__cplusplus
 
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index ea58b3d7..6908fe1d 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -1,18 +1,18 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Debug.h>
 
-#include <ArduinoOcpp/Operations/GetDiagnostics.h>
-#include <ArduinoOcpp/Operations/DiagnosticsStatusNotification.h>
+#include <MicroOcpp/Operations/GetDiagnostics.h>
+#include <MicroOcpp/Operations/DiagnosticsStatusNotification.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 using Ocpp16::DiagnosticsStatus;
 
 DiagnosticsService::DiagnosticsService(Context& context) : context(context) {
@@ -45,11 +45,11 @@ void DiagnosticsService::loop() {
 
         if (!uploadIssued) {
             if (onUpload != nullptr) {
-                AO_DBG_DEBUG("Call onUpload");
+                MOCPP_DBG_DEBUG("Call onUpload");
                 onUpload(location, startTime, stopTime);
                 uploadIssued = true;
             } else {
-                AO_DBG_ERR("onUpload must be set! (see setOnUpload). Will abort");
+                MOCPP_DBG_ERR("onUpload must be set! (see setOnUpload). Will abort");
                 retries = 0;
                 uploadIssued = false;
             }
@@ -58,7 +58,7 @@ void DiagnosticsService::loop() {
         if (uploadIssued) {
             if (uploadStatusInput != nullptr && uploadStatusInput() == UploadStatus::Uploaded) {
                 //success!
-                AO_DBG_DEBUG("end upload routine (by status)")
+                MOCPP_DBG_DEBUG("end upload routine (by status)")
                 uploadIssued = false;
                 retries = 0;
             }
@@ -71,12 +71,12 @@ void DiagnosticsService::loop() {
 
                 if (uploadStatusInput == nullptr) {
                     //No way to find out if failed. But maximum time has elapsed. Assume success
-                    AO_DBG_DEBUG("end upload routine (by timer)");
+                    MOCPP_DBG_DEBUG("end upload routine (by timer)");
                     uploadIssued = false;
                     retries = 0;
                 } else {
                     //either we have UploadFailed status or (NotDownloaded + timeout) here
-                    AO_DBG_WARN("Upload timeout or failed");
+                    MOCPP_DBG_WARN("Upload timeout or failed");
                     const int TRANSITION_DELAY = 10;
                     if (retryInterval <= UPLOAD_TIMEOUT + TRANSITION_DELAY) {
                         nextTry = timestampNow;
@@ -115,7 +115,7 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
     this->startTime.toJsonString(dbuf, JSONDATE_LENGTH + 1);
     this->stopTime.toJsonString(dbuf2, JSONDATE_LENGTH + 1);
 
-    AO_DBG_INFO("Scheduled Diagnostics upload!\n" \
+    MOCPP_DBG_INFO("Scheduled Diagnostics upload!\n" \
                     "                  location = %s\n" \
                     "                  retries = %i" \
                     ", retryInterval = %u" \
@@ -132,7 +132,7 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
     uploadIssued = false;
 
     nextTry.toJsonString(dbuf, JSONDATE_LENGTH + 1);
-    AO_DBG_DEBUG("Initial try at %s", dbuf);
+    MOCPP_DBG_DEBUG("Initial try at %s", dbuf);
 
     return "diagnostics.log";
 }
@@ -177,7 +177,7 @@ void DiagnosticsService::setOnUploadStatusInput(std::function<UploadStatus()> up
     this->uploadStatusInput = uploadStatusInput;
 }
 
-#if !defined(AO_CUSTOM_DIAGNOSTICS) && !defined(AO_CUSTOM_WS)
+#if !defined(MOCPP_CUSTOM_DIAGNOSTICS) && !defined(MOCPP_CUSTOM_WS)
 #if defined(ESP32) || defined(ESP8266)
 
 DiagnosticsService *EspWiFi::makeDiagnosticsService(Context& context) {
@@ -191,4 +191,4 @@ DiagnosticsService *EspWiFi::makeDiagnosticsService(Context& context) {
 }
 
 #endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+#endif //!defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
index eb58c7e2..17a02263 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -7,11 +7,11 @@
 
 #include <functional>
 #include <memory>
-#include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsStatus.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h>
 #include <string>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 enum class UploadStatus {
     NotUploaded,
@@ -59,7 +59,7 @@ class DiagnosticsService {
     void setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput);
 };
 
-#if !defined(AO_CUSTOM_DIAGNOSTICS) && !defined(AO_CUSTOM_WS)
+#if !defined(MOCPP_CUSTOM_DIAGNOSTICS) && !defined(MOCPP_CUSTOM_WS)
 #if defined(ESP32) || defined(ESP8266)
 
 namespace EspWiFi {
@@ -69,8 +69,8 @@ DiagnosticsService *makeDiagnosticsService(Context& context);
 }
 
 #endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+#endif //!defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h
index bf67f8cd..1cf9da4d 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h
@@ -1,11 +1,11 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef DIAGNOSTICS_STATUS
 #define DIAGNOSTICS_STATUS
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 
 enum class DiagnosticsStatus {
@@ -16,5 +16,5 @@ enum class DiagnosticsStatus {
 };
 
 }
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 75062da7..f897d3a9 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -1,29 +1,29 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/OperationRegistry.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/OperationRegistry.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
 
-#include <ArduinoOcpp/Operations/UpdateFirmware.h>
-#include <ArduinoOcpp/Operations/FirmwareStatusNotification.h>
+#include <MicroOcpp/Operations/UpdateFirmware.h>
+#include <MicroOcpp/Operations/FirmwareStatusNotification.h>
 
-#include <ArduinoOcpp/Platform.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Platform.h>
+#include <MicroOcpp/Debug.h>
 
 //debug option: update immediately and don't wait for the retreive date
-#ifndef AO_IGNORE_FW_RETR_DATE
-#define AO_IGNORE_FW_RETR_DATE 0
+#ifndef MOCPP_IGNORE_FW_RETR_DATE
+#define MOCPP_IGNORE_FW_RETR_DATE 0
 #endif
 
-using namespace ArduinoOcpp;
-using ArduinoOcpp::Ocpp16::FirmwareStatus;
+using namespace MicroOcpp;
+using MicroOcpp::Ocpp16::FirmwareStatus;
 
 FirmwareService::FirmwareService(Context& context) : context(context) {
     const char *fpId = "FirmwareManagement";
@@ -48,7 +48,7 @@ void FirmwareService::setBuildNumber(const char *buildNumber) {
     if (buildNumber == nullptr)
         return;
     this->buildNumber = buildNumber;
-    previousBuildNumber = declareConfiguration<const char*>("BUILD_NUMBER", this->buildNumber.c_str(), AO_KEYVALUE_FN, false, false, true, false);
+    previousBuildNumber = declareConfiguration<const char*>("BUILD_NUMBER", this->buildNumber.c_str(), MOCPP_KEYVALUE_FN, false, false, true, false);
     checkedSuccessfulFwUpdate = false; //--> CS will be notified
 }
 
@@ -58,7 +58,7 @@ void FirmwareService::loop() {
         context.initiateRequest(std::move(notification));
     }
 
-    if (ao_tick_ms() - timestampTransition < delayTransition) {
+    if (mocpp_tick_ms() - timestampTransition < delayTransition) {
         return;
     }
 
@@ -66,7 +66,7 @@ void FirmwareService::loop() {
     if (retries > 0 && timestampNow >= retreiveDate) {
 
         if (stage == UpdateStage::Idle) {
-            AO_DBG_INFO("Start update");
+            MOCPP_DBG_INFO("Start update");
 
             if (context.getModel().getNumConnectors() > 0) {
                 auto cp = context.getModel().getConnector(0);
@@ -77,18 +77,18 @@ void FirmwareService::loop() {
             } else {
                 downloadIssued = true;
                 stage = UpdateStage::AwaitDownload;
-                timestampTransition = ao_tick_ms();
+                timestampTransition = mocpp_tick_ms();
                 delayTransition = 5000; //delay between state "Downloading" and actually starting the download
                 return;
             }
         }
 
         if (stage == UpdateStage::AwaitDownload) {
-            AO_DBG_INFO("Start download");
+            MOCPP_DBG_INFO("Start download");
             stage = UpdateStage::Downloading;
             if (onDownload != nullptr) {
                 onDownload(location);
-                timestampTransition = ao_tick_ms();
+                timestampTransition = mocpp_tick_ms();
                 delayTransition = downloadStatusInput ? 1000 : 30000; //give the download at least 30s
                 return;
             }
@@ -103,13 +103,13 @@ void FirmwareService::loop() {
                     //passed download stage
                     stage = UpdateStage::AfterDownload;
                 } else if (downloadStatusInput() == DownloadStatus::DownloadFailed) {
-                    AO_DBG_INFO("Download timeout or failed! Retry");
+                    MOCPP_DBG_INFO("Download timeout or failed! Retry");
                     retreiveDate = timestampNow;
                     retreiveDate += retryInterval;
                     retries--;
                     resetStage();
 
-                    timestampTransition = ao_tick_ms();
+                    timestampTransition = mocpp_tick_ms();
                     delayTransition = 10000;
                     return;
                 }
@@ -135,7 +135,7 @@ void FirmwareService::loop() {
                 stage = UpdateStage::AwaitInstallation;
                 installationIssued = true;
 
-                timestampTransition = ao_tick_ms();
+                timestampTransition = mocpp_tick_ms();
                 delayTransition = 10000;
             }
 
@@ -143,16 +143,16 @@ void FirmwareService::loop() {
         }
 
         if (stage == UpdateStage::AwaitInstallation) {
-            AO_DBG_INFO("Installing");
+            MOCPP_DBG_INFO("Installing");
             stage = UpdateStage::Installing;
 
             if (onInstall) {
                 onInstall(location); //should restart the device on success
             } else {
-                AO_DBG_WARN("onInstall must be set! (see setOnInstall). Will abort");
+                MOCPP_DBG_WARN("onInstall must be set! (see setOnInstall). Will abort");
             }
 
-            timestampTransition = ao_tick_ms();
+            timestampTransition = mocpp_tick_ms();
             delayTransition = installationStatusInput ? 1000 : 120 * 1000;
             return;
         }
@@ -161,23 +161,23 @@ void FirmwareService::loop() {
 
             if (installationStatusInput) {
                 if (installationStatusInput() == InstallationStatus::Installed) {
-                    AO_DBG_INFO("FW update finished");
+                    MOCPP_DBG_INFO("FW update finished");
                     //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
                     resetStage();
                     retries = 0; //End of update routine. Client must reboot on its own
                 } else if (installationStatusInput() == InstallationStatus::InstallationFailed) {
-                    AO_DBG_INFO("Installation timeout or failed! Retry");
+                    MOCPP_DBG_INFO("Installation timeout or failed! Retry");
                     retreiveDate = timestampNow;
                     retreiveDate += retryInterval;
                     retries--;
                     resetStage();
 
-                    timestampTransition = ao_tick_ms();
+                    timestampTransition = mocpp_tick_ms();
                     delayTransition = 10000;
                 }
                 return;
             } else {
-                AO_DBG_INFO("FW update finished");
+                MOCPP_DBG_INFO("FW update finished");
                 //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
                 resetStage();
                 retries = 0; //End of update routine. Client must reboot on its own
@@ -186,7 +186,7 @@ void FirmwareService::loop() {
         }
 
         //should never reach this code
-        AO_DBG_ERR("Firmware update failed");
+        MOCPP_DBG_ERR("Firmware update failed");
         retries = 0;
         resetStage();
     }
@@ -198,15 +198,15 @@ void FirmwareService::scheduleFirmwareUpdate(const std::string &location, Timest
     this->retries = retries;
     this->retryInterval = retryInterval;
 
-    if (AO_IGNORE_FW_RETR_DATE) {
-        AO_DBG_DEBUG("ignore FW update retreive date");
+    if (MOCPP_IGNORE_FW_RETR_DATE) {
+        MOCPP_DBG_DEBUG("ignore FW update retreive date");
         this->retreiveDate = context.getModel().getClock().now();
     }
 
     char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
     this->retreiveDate.toJsonString(dbuf, JSONDATE_LENGTH + 1);
 
-    AO_DBG_INFO("Scheduled FW update!\n" \
+    MOCPP_DBG_INFO("Scheduled FW update!\n" \
                     "                  location = %s\n" \
                     "                  retrieveDate = %s\n" \
                     "                  retries = %i" \
@@ -216,7 +216,7 @@ void FirmwareService::scheduleFirmwareUpdate(const std::string &location, Timest
             this->retries,
             this->retryInterval);
 
-    timestampTransition = ao_tick_ms();
+    timestampTransition = mocpp_tick_ms();
     delayTransition = 1000;
 
     resetStage();
@@ -257,7 +257,7 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
     if (!checkedSuccessfulFwUpdate && !buildNumber.empty() && previousBuildNumber != nullptr) {
         checkedSuccessfulFwUpdate = true;
 
-        AO_DBG_DEBUG("Previous build number: %s, new build number: %s", (const char*) *previousBuildNumber, buildNumber.c_str());
+        MOCPP_DBG_DEBUG("Previous build number: %s, new build number: %s", (const char*) *previousBuildNumber, buildNumber.c_str());
         
         size_t buildNoSize = previousBuildNumber->getBuffsize();
         if (strncmp(buildNumber.c_str(), *previousBuildNumber, buildNoSize)) {
@@ -308,7 +308,7 @@ void FirmwareService::resetStage() {
     installationIssued = false;
 }
 
-#if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+#if !defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
 #if defined(ESP32)
 
 #include <HTTPUpdate.h>
@@ -348,15 +348,15 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
         switch (ret) {
             case HTTP_UPDATE_FAILED:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                AO_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", httpUpdate.getLastError(), httpUpdate.getLastErrorString().c_str());
+                MOCPP_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", httpUpdate.getLastError(), httpUpdate.getLastErrorString().c_str());
                 break;
             case HTTP_UPDATE_NO_UPDATES:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                AO_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
+                MOCPP_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
                 break;
             case HTTP_UPDATE_OK:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::Installed;});
-                AO_DBG_INFO("HTTP_UPDATE_OK");
+                MOCPP_DBG_INFO("HTTP_UPDATE_OK");
                 ESP.restart();
                 break;
         }
@@ -392,15 +392,15 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
         switch (ret) {
             case HTTP_UPDATE_FAILED:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                AO_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", ESPhttpUpdate.getLastError(), ESPhttpUpdate.getLastErrorString().c_str());
+                MOCPP_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", ESPhttpUpdate.getLastError(), ESPhttpUpdate.getLastErrorString().c_str());
                 break;
             case HTTP_UPDATE_NO_UPDATES:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                AO_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
+                MOCPP_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
                 break;
             case HTTP_UPDATE_OK:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::Installed;});
-                AO_DBG_INFO("HTTP_UPDATE_OK");
+                MOCPP_DBG_INFO("HTTP_UPDATE_OK");
                 ESP.restart();
                 break;
         }
@@ -416,4 +416,4 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 }
 
 #endif //defined(ESP8266)
-#endif //!defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+#endif //!defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
index f094ef14..1637f842 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -8,11 +8,11 @@
 #include <functional>
 #include <memory>
 
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
-#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareStatus.h>
-#include <ArduinoOcpp/Core/Time.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h>
+#include <MicroOcpp/Core/Time.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 enum class DownloadStatus {
     NotDownloaded, // == before download or during download
@@ -89,12 +89,12 @@ class FirmwareService {
     void setInstallationStatusInput(std::function<InstallationStatus()> installationStatusInput);
 };
 
-} //endif namespace ArduinoOcpp
+} //endif namespace MicroOcpp
 
-#if !defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+#if !defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
 #if defined(ESP32) || defined(ESP8266)
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace EspWiFi {
 
 FirmwareService *makeFirmwareService(Context& context);
@@ -103,6 +103,6 @@ FirmwareService *makeFirmwareService(Context& context);
 }
 
 #endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(AO_CUSTOM_UPDATER) && !defined(AO_CUSTOM_WS)
+#endif //!defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
 
 #endif
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h
index 82a0e39b..0688af12 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h
@@ -1,11 +1,11 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef FIRMWARE_STATUS
 #define FIRMWARE_STATUS
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 
 enum class FirmwareStatus {
@@ -19,5 +19,5 @@ enum class FirmwareStatus {
 };
 
 }
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
index 8d558fe4..0756e82b 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
@@ -1,19 +1,19 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Heartbeat/HeartbeatService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Operations/Heartbeat.h>
-#include <ArduinoOcpp/Platform.h>
+#include <MicroOcpp/Model/Heartbeat/HeartbeatService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Operations/Heartbeat.h>
+#include <MicroOcpp/Platform.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 HeartbeatService::HeartbeatService(Context& context) : context(context) {
     heartbeatInterval = declareConfiguration("HeartbeatInterval", 86400);
-    lastHeartbeat = ao_tick_ms();
+    lastHeartbeat = mocpp_tick_ms();
 
     //Register message handler for TriggerMessage operation
     context.getOperationRegistry().registerOperation("Heartbeat", [&context] () {
@@ -23,7 +23,7 @@ HeartbeatService::HeartbeatService(Context& context) : context(context) {
 void HeartbeatService::loop() {
     unsigned long hbInterval = *heartbeatInterval;
     hbInterval *= 1000UL; //conversion s -> ms
-    unsigned long now = ao_tick_ms();
+    unsigned long now = mocpp_tick_ms();
 
     if (now - lastHeartbeat >= hbInterval) {
         lastHeartbeat = now;
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
index c80f0f07..0ee4f3dd 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef HEARTBEATSERVICE_H
 #define HEARTBEATSERVICE_H
 
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <memory>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Context;
 
@@ -17,7 +17,7 @@ class HeartbeatService {
     Context& context;
 
     unsigned long lastHeartbeat;
-    std::shared_ptr<ArduinoOcpp::Configuration<int>> heartbeatInterval;
+    std::shared_ptr<MicroOcpp::Configuration<int>> heartbeatInterval;
 
 public:
     HeartbeatService(Context& context);
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.cpp b/src/MicroOcpp/Model/Metering/MeterStore.cpp
index ba1e792f..0712fe8b 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterStore.cpp
@@ -1,44 +1,44 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Metering/MeterStore.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Model/Metering/MeterStore.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
 #include <algorithm>
 
-#define AO_MAX_STOPTXDATA_LEN 4
+#define MOCPP_MAX_STOPTXDATA_LEN 4
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 TransactionMeterData::TransactionMeterData(unsigned int connectorId, unsigned int txNr, std::shared_ptr<FilesystemAdapter> filesystem)
         : connectorId(connectorId), txNr(txNr), filesystem{filesystem} {
     
     if (!filesystem) {
-        AO_DBG_DEBUG("volatile mode");
+        MOCPP_DBG_DEBUG("volatile mode");
         (void)0;
     }
 }
 
 bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
     if (isFinalized()) {
-        AO_DBG_ERR("immutable");
+        MOCPP_DBG_ERR("immutable");
         return false;
     }
 
     if (!mv) {
-        AO_DBG_ERR("null");
+        MOCPP_DBG_ERR("null");
         return false;
     }
 
-    if (AO_MAX_STOPTXDATA_LEN <= 0) {
+    if (MOCPP_MAX_STOPTXDATA_LEN <= 0) {
         //txData off
         return true;
     }
 
-    bool replaceLast = mvCount >= AO_MAX_STOPTXDATA_LEN; //txData size exceeded? overwrite last entry instead of appending
+    bool replaceLast = mvCount >= MOCPP_MAX_STOPTXDATA_LEN; //txData size exceeded? overwrite last entry instead of appending
 
     if (filesystem) {
 
@@ -49,21 +49,21 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
             mvIndex = mvCount ;
         }
 
-        char fn [AO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvIndex);
-        if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-            AO_DBG_ERR("fn error: %i", ret);
+        char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvIndex);
+        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+            MOCPP_DBG_ERR("fn error: %i", ret);
             return false;
         }
 
         auto mvDoc = mv->toJson();
         if (!mvDoc) {
-            AO_DBG_ERR("MV not ready yet");
+            MOCPP_DBG_ERR("MV not ready yet");
             return false;
         }
 
         if (!FilesystemUtils::storeJson(filesystem, fn, *mvDoc)) {
-            AO_DBG_ERR("FS error");
+            MOCPP_DBG_ERR("FS error");
             return false;
         }
 
@@ -74,27 +74,27 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
 
     if (replaceLast) {
         txData.back() = std::move(mv);
-        AO_DBG_DEBUG("updated latest sd");
+        MOCPP_DBG_DEBUG("updated latest sd");
     } else {
         txData.push_back(std::move(mv));
-        AO_DBG_DEBUG("added sd");
+        MOCPP_DBG_DEBUG("added sd");
     }
     return true;
 }
 
 std::vector<std::unique_ptr<MeterValue>> TransactionMeterData::retrieveStopTxData() {
     if (isFinalized()) {
-        AO_DBG_ERR("Can only retrieve once");
+        MOCPP_DBG_ERR("Can only retrieve once");
         return decltype(txData) {};
     }
     finalize();
-    AO_DBG_DEBUG("creating sd");
+    MOCPP_DBG_DEBUG("creating sd");
     return std::move(txData);
 }
 
 bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
     if (!filesystem) {
-        AO_DBG_DEBUG("No FS - nothing to restore");
+        MOCPP_DBG_DEBUG("No FS - nothing to restore");
         return true;
     }
 
@@ -104,10 +104,10 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
 
     while (misses < MISSES_LIMIT) { //search until region without mvs found
         
-        char fn [AO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
-        if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-            AO_DBG_ERR("fn error: %i", ret);
+        char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
+        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+            MOCPP_DBG_ERR("fn error: %i", ret);
             return false; //all files have same length
         }
 
@@ -123,14 +123,14 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
         std::unique_ptr<MeterValue> mv = mvBuilder.deserializeSample(mvJson);
 
         if (!mv) {
-            AO_DBG_ERR("Deserialization error");
+            MOCPP_DBG_ERR("Deserialization error");
             misses++;
             i++;
             continue;
         }
 
-        if (txData.size() >= AO_MAX_STOPTXDATA_LEN) {
-            AO_DBG_ERR("corrupted memory");
+        if (txData.size() >= MOCPP_MAX_STOPTXDATA_LEN) {
+            MOCPP_DBG_ERR("corrupted memory");
             return false;
         }
 
@@ -141,14 +141,14 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
         misses = 0;
     }
 
-    AO_DBG_DEBUG("Restored %zu meter values", txData.size());
+    MOCPP_DBG_DEBUG("Restored %zu meter values", txData.size());
     return true;
 }
 
 MeterStore::MeterStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem {filesystem} {
 
     if (!filesystem) {
-        AO_DBG_DEBUG("volatile mode");
+        MOCPP_DBG_DEBUG("volatile mode");
         (void)0;
     }
 }
@@ -190,10 +190,10 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
     auto tx = std::make_shared<TransactionMeterData>(connectorId, txNr, filesystem);
     
     if (filesystem) {
-        char fn [AO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, 0);
-        if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-            AO_DBG_ERR("fn error: %i", ret);
+        char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, 0);
+        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+            MOCPP_DBG_ERR("fn error: %i", ret);
             return nullptr; //cannot store
         }
 
@@ -203,14 +203,14 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
         if (exists) {
             if (!tx->restore(mvBuilder)) {
                 remove(connectorId, txNr);
-                AO_DBG_ERR("removed corrupted tx entries");
+                MOCPP_DBG_ERR("removed corrupted tx entries");
             }
         }
     }
 
     txMeterData.push_back(tx);
 
-    AO_DBG_DEBUG("Added txNr %u, now holding %zu txs", txNr, txMeterData.size());
+    MOCPP_DBG_DEBUG("Added txNr %u, now holding %zu txs", txNr, txMeterData.size());
 
     return tx;
 }
@@ -245,10 +245,10 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
 
             while (misses < MISSES_LIMIT) { //search until region without mvs found
                 
-                char fn [AO_MAX_PATH_SIZE] = {'\0'};
-                auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
-                if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-                    AO_DBG_ERR("fn error: %i", ret);
+                char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+                auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
+                if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+                    MOCPP_DBG_ERR("fn error: %i", ret);
                     return false; //all files have same length
                 }
 
@@ -265,15 +265,15 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
             }
         }
 
-        AO_DBG_DEBUG("remove %u mvs for txNr %u", mvCount, txNr);
+        MOCPP_DBG_DEBUG("remove %u mvs for txNr %u", mvCount, txNr);
 
         for (unsigned int i = 0; i < mvCount; i++) {
             unsigned int sd = mvCount - 1U - i;
         
-            char fn [AO_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, sd);
-            if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-                AO_DBG_ERR("fn error: %i", ret);
+            char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, sd);
+            if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+                MOCPP_DBG_ERR("fn error: %i", ret);
                 return false;
             }
 
@@ -290,10 +290,10 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
             txMeterData.end());
 
     if (success) {
-        AO_DBG_DEBUG("Removed meter values for cId %u, txNr %u", connectorId, txNr);
+        MOCPP_DBG_DEBUG("Removed meter values for cId %u, txNr %u", connectorId, txNr);
         (void)0;
     } else {
-        AO_DBG_DEBUG("corrupted fs");
+        MOCPP_DBG_DEBUG("corrupted fs");
     }
 
     return success;
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.h b/src/MicroOcpp/Model/Metering/MeterStore.h
index d7be981b..356bf8f3 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.h
+++ b/src/MicroOcpp/Model/Metering/MeterStore.h
@@ -1,18 +1,18 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef METERSTORE_H
 #define METERSTORE_H
 
-#include <ArduinoOcpp/Model/Metering/MeterValue.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Model/Metering/MeterValue.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 
 #include <vector>
 #include <deque>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class TransactionMeterData {
 private:
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.cpp b/src/MicroOcpp/Model/Metering/MeterValue.cpp
index 3a86d356..7004067b 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterValue.cpp
@@ -1,12 +1,12 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Metering/MeterValue.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Metering/MeterValue.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Debug.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 std::unique_ptr<DynamicJsonDocument> MeterValue::toJson() {
     size_t capacity = 0;
@@ -103,7 +103,7 @@ void MeterValueBuilder::updateObservedSamplers() {
 std::unique_ptr<MeterValue> MeterValueBuilder::takeSample(const Timestamp& timestamp, const ReadingContext& context) {
     if (select_observe != select->getValueRevision() || //OCPP server has changed configuration about which measurands to take
             samplers.size() != select_mask.size()) {    //Client has added another Measurand; synchronize lists
-        AO_DBG_DEBUG("Updating observed samplers due to config change or samplers added");
+        MOCPP_DBG_DEBUG("Updating observed samplers due to config change or samplers added");
         updateObservedSamplers();
         select_observe = select->getValueRevision();
     }
@@ -128,7 +128,7 @@ std::unique_ptr<MeterValue> MeterValueBuilder::deserializeSample(const JsonObjec
     Timestamp timestamp;
     bool ret = timestamp.setTime(mvJson["timestamp"] | "Invalid");
     if (!ret) {
-        AO_DBG_ERR("invalid timestamp");
+        MOCPP_DBG_ERR("invalid timestamp");
         return nullptr;
     }
 
@@ -148,13 +148,13 @@ std::unique_ptr<MeterValue> MeterValueBuilder::deserializeSample(const JsonObjec
                 if (dVal) {
                     sample->addSampledValue(std::move(dVal));
                 } else {
-                    AO_DBG_ERR("deserialization error");
+                    MOCPP_DBG_ERR("deserialization error");
                 }
                 break;
             }
         }
     }
 
-    AO_DBG_VERBOSE("deserialized MV");
+    MOCPP_DBG_VERBOSE("deserialized MV");
     return sample;
 }
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.h b/src/MicroOcpp/Model/Metering/MeterValue.h
index 5455c12f..46f48454 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.h
+++ b/src/MicroOcpp/Model/Metering/MeterValue.h
@@ -1,18 +1,18 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef METERVALUE_H
 #define METERVALUE_H
 
-#include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Model/Metering/SampledValue.h>
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Model/Metering/SampledValue.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <ArduinoJson.h>
 #include <memory>
 #include <vector>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class MeterValue {
 private:
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index f2e0c0ed..37e4eaad 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -1,28 +1,28 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Metering/MeteringConnector.h>
-#include <ArduinoOcpp/Model/Metering/MeterStore.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Operations/MeterValues.h>
-#include <ArduinoOcpp/Platform.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Metering/MeteringConnector.h>
+#include <MicroOcpp/Model/Metering/MeterStore.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Operations/MeterValues.h>
+#include <MicroOcpp/Platform.h>
+#include <MicroOcpp/Debug.h>
 
 #include <cstddef>
 #include <cinttypes>
 
-using namespace ArduinoOcpp;
-using namespace ArduinoOcpp::Ocpp16;
+using namespace MicroOcpp;
+using namespace MicroOcpp::Ocpp16;
 
 MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore& meterStore)
         : model(model), connectorId{connectorId}, meterStore(meterStore) {
 
     auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData", "", CONFIGURATION_FN);
     declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
-    MeterValueCacheSize = declareConfiguration("AO_MeterValueCacheSize", 1, CONFIGURATION_FN, true, true, true, false);
+    MeterValueCacheSize = declareConfiguration("MO_MeterValueCacheSize", 1, CONFIGURATION_FN, true, true, true, false);
     MeterValueSampleInterval = declareConfiguration("MeterValueSampleInterval", 60);
     
     auto StopTxnSampledData = declareConfiguration<const char*>("StopTxnSampledData", "", CONFIGURATION_FN);
@@ -34,8 +34,8 @@ MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore&
     
     auto StopTxnAlignedData = declareConfiguration<const char*>("StopTxnAlignedData", "", CONFIGURATION_FN);
 
-    MeterValuesInTxOnly = declareConfiguration<bool>("AO_MeterValuesInTxOnly", true, CONFIGURATION_FN, true, true, true, false);
-    StopTxnDataCapturePeriodic = declareConfiguration<bool>("AO_StopTxnDataCapturePeriodic", false, CONFIGURATION_FN, true, true, true, false);
+    MeterValuesInTxOnly = declareConfiguration<bool>("MO_MeterValuesInTxOnly", true, CONFIGURATION_FN, true, true, true, false);
+    StopTxnDataCapturePeriodic = declareConfiguration<bool>("MO_StopTxnDataCapturePeriodic", false, CONFIGURATION_FN, true, true, true, false);
 
     sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesSampledData));
     alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData));
@@ -53,7 +53,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
     }
 
     if (txBreak) {
-        lastSampleTime = ao_tick_ms();
+        lastSampleTime = mocpp_tick_ms();
     }
 
     if ((txBreak || meterData.size() >= (size_t) *MeterValueCacheSize) && !meterData.empty()) {
@@ -71,7 +71,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
             //check during transaction
 
             if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
-                AO_DBG_WARN("reload stopTxnData");
+                MOCPP_DBG_WARN("reload stopTxnData");
                 //reload (e.g. after power cut during transaction)
                 stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction.get());
             }
@@ -93,7 +93,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         if (dt <= 0 ||                              //normal case: interval elapsed
                 dt > *ClockAlignedDataInterval) {   //special case: clock has been adjusted or first run
 
-            AO_DBG_DEBUG("Clock aligned measurement %" PRId32 "s: %s", dt,
+            MOCPP_DBG_DEBUG("Clock aligned measurement %" PRId32 "s: %s", dt,
                 abs(dt) <= 60 ?
                 "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
@@ -130,7 +130,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
     if (*MeterValueSampleInterval >= 1) {
         //record periodic tx data
 
-        if (ao_tick_ms() - lastSampleTime >= (unsigned long) (*MeterValueSampleInterval * 1000)) {
+        if (mocpp_tick_ms() - lastSampleTime >= (unsigned long) (*MeterValueSampleInterval * 1000)) {
             auto sampleMeterValues = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::SamplePeriodic);
             if (sampleMeterValues) {
                 meterData.push_back(std::move(sampleMeterValues));
@@ -142,7 +142,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
                     stopTxnData->addTxData(std::move(sampleStopTx));
                 }
             }
-            lastSampleTime = ao_tick_ms();
+            lastSampleTime = mocpp_tick_ms();
         }   
     }
 
@@ -183,7 +183,7 @@ std::unique_ptr<SampledValue> MeteringConnector::readTxEnergyMeter(ReadingContex
     if (energySamplerIndex >= 0 && (size_t) energySamplerIndex < samplers.size()) {
         return samplers[energySamplerIndex]->takeValue(model);
     } else {
-        AO_DBG_DEBUG("Called readTxEnergyMeter(), but no energySampler or handling strategy set");
+        MOCPP_DBG_DEBUG("Called readTxEnergyMeter(), but no energySampler or handling strategy set");
         return nullptr;
     }
 }
@@ -220,7 +220,7 @@ std::shared_ptr<TransactionMeterData> MeteringConnector::getStopTxMeterData(Tran
     auto txData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction);
 
     if (!txData) {
-        AO_DBG_ERR("could not create TxData");
+        MOCPP_DBG_ERR("could not create TxData");
         return nullptr;
     }
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.h b/src/MicroOcpp/Model/Metering/MeteringConnector.h
index f30b9727..76d2bdb3 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.h
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -9,12 +9,12 @@
 #include <memory>
 #include <vector>
 
-#include <ArduinoOcpp/Model/Metering/MeterValue.h>
-#include <ArduinoOcpp/Model/Metering/MeterStore.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Model/Metering/MeterValue.h>
+#include <MicroOcpp/Model/Metering/MeterStore.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 class Operation;
@@ -76,5 +76,5 @@ class MeteringConnector {
 
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index e0b770b8..271dc460 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Metering/MeteringService.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Operations/MeterValues.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Metering/MeteringService.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Operations/MeterValues.h>
+#include <MicroOcpp/Debug.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
       : context(context), meterStore(filesystem) {
@@ -70,7 +70,7 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
             }
             if (!found) {
                 isValid = false;
-                AO_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
+                MOCPP_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
                 break;
             }
             l = r;
@@ -105,7 +105,7 @@ void MeteringService::loop(){
 
 void MeteringService::addMeterValueSampler(int connectorId, std::unique_ptr<SampledValueSampler> meterValueSampler) {
     if (connectorId < 0 || connectorId >= (int) connectors.size()) {
-        AO_DBG_ERR("connectorId is out of bounds");
+        MOCPP_DBG_ERR("connectorId is out of bounds");
         return;
     }
     connectors[connectorId]->addMeterValueSampler(std::move(meterValueSampler));
@@ -113,7 +113,7 @@ void MeteringService::addMeterValueSampler(int connectorId, std::unique_ptr<Samp
 
 std::unique_ptr<SampledValue> MeteringService::readTxEnergyMeter(int connectorId, ReadingContext context) {
     if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
-        AO_DBG_ERR("connectorId is out of bounds");
+        MOCPP_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
     return connectors[connectorId]->readTxEnergyMeter(context);
@@ -121,7 +121,7 @@ std::unique_ptr<SampledValue> MeteringService::readTxEnergyMeter(int connectorId
 
 std::unique_ptr<Request> MeteringService::takeTriggeredMeterValues(int connectorId) {
     if (connectorId < 0 || connectorId >= (int) connectors.size()) {
-        AO_DBG_ERR("connectorId out of bounds. Ignore");
+        MOCPP_DBG_ERR("connectorId out of bounds. Ignore");
         return nullptr;
     }
     auto& connector = connectors.at(connectorId);
@@ -132,21 +132,21 @@ std::unique_ptr<Request> MeteringService::takeTriggeredMeterValues(int connector
             meterValues->setTimeout(120000);
             return meterValues;
         }
-        AO_DBG_DEBUG("Did not take any samples for connectorId %d", connectorId);
+        MOCPP_DBG_DEBUG("Did not take any samples for connectorId %d", connectorId);
         return nullptr;
     }
-    AO_DBG_ERR("Could not find connector");
+    MOCPP_DBG_ERR("Could not find connector");
     return nullptr;
 }
 
 void MeteringService::beginTxMeterData(Transaction *transaction) {
     if (!transaction) {
-        AO_DBG_ERR("invalid argument");
+        MOCPP_DBG_ERR("invalid argument");
         return;
     }
     auto connectorId = transaction->getConnectorId();
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("connectorId is out of bounds");
+        MOCPP_DBG_ERR("connectorId is out of bounds");
         return;
     }
     auto& connector = connectors[connectorId];
@@ -156,12 +156,12 @@ void MeteringService::beginTxMeterData(Transaction *transaction) {
 
 std::shared_ptr<TransactionMeterData> MeteringService::endTxMeterData(Transaction *transaction) {
     if (!transaction) {
-        AO_DBG_ERR("invalid argument");
+        MOCPP_DBG_ERR("invalid argument");
         return nullptr;
     }
     auto connectorId = transaction->getConnectorId();
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("connectorId is out of bounds");
+        MOCPP_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
     auto& connector = connectors[connectorId];
@@ -171,12 +171,12 @@ std::shared_ptr<TransactionMeterData> MeteringService::endTxMeterData(Transactio
 
 std::shared_ptr<TransactionMeterData> MeteringService::getStopTxMeterData(Transaction *transaction) {
     if (!transaction) {
-        AO_DBG_ERR("invalid argument");
+        MOCPP_DBG_ERR("invalid argument");
         return nullptr;
     }
     auto connectorId = transaction->getConnectorId();
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("connectorId is out of bounds");
+        MOCPP_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
     auto& connector = connectors[connectorId];
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.h b/src/MicroOcpp/Model/Metering/MeteringService.h
index 3acaa4a0..0f2f7afc 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.h
+++ b/src/MicroOcpp/Model/Metering/MeteringService.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -9,11 +9,11 @@
 #include <vector>
 #include <memory>
 
-#include <ArduinoOcpp/Model/Metering/MeteringConnector.h>
-#include <ArduinoOcpp/Model/Metering/SampledValue.h>
-#include <ArduinoOcpp/Model/Metering/MeterStore.h>
+#include <MicroOcpp/Model/Metering/MeteringConnector.h>
+#include <MicroOcpp/Model/Metering/SampledValue.h>
+#include <MicroOcpp/Model/Metering/MeterStore.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Context;
 class Request;
@@ -47,5 +47,5 @@ class MeteringService {
     int getNumConnectors() {return connectors.size();}
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Model/Metering/SampledValue.cpp b/src/MicroOcpp/Model/Metering/SampledValue.cpp
index a934e83d..6c7a8f76 100644
--- a/src/MicroOcpp/Model/Metering/SampledValue.cpp
+++ b/src/MicroOcpp/Model/Metering/SampledValue.cpp
@@ -1,12 +1,12 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Metering/SampledValue.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Metering/SampledValue.h>
+#include <MicroOcpp/Debug.h>
 #include <cinttypes>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 int32_t SampledValueDeSerializer<int32_t>::deserialize(const char *str) {
     return strtol(str, nullptr, 10);
@@ -19,7 +19,7 @@ std::string SampledValueDeSerializer<int32_t>::serialize(int32_t& val) {
 }
 
 //helper function
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 const char *serializeReadingContext(ReadingContext context) {
     switch (context) {
@@ -40,7 +40,7 @@ const char *serializeReadingContext(ReadingContext context) {
         case (ReadingContext::Trigger):
             return "Trigger";
         default:
-            AO_DBG_ERR("ReadingContext not specified");
+            MOCPP_DBG_ERR("ReadingContext not specified");
             /* fall through */
         case (ReadingContext::NOT_SET):
             return nullptr;
@@ -48,12 +48,12 @@ const char *serializeReadingContext(ReadingContext context) {
 }
 ReadingContext deserializeReadingContext(const char *context) {
     if (!context) {
-        AO_DBG_ERR("Invalid argument");
+        MOCPP_DBG_ERR("Invalid argument");
         return ReadingContext::NOT_SET;
     }
 
     if (!strcmp(context, "NOT_SET")) {
-        AO_DBG_DEBUG("Deserialize Null-ReadingContext");
+        MOCPP_DBG_DEBUG("Deserialize Null-ReadingContext");
         return ReadingContext::NOT_SET;
     } else if (!strcmp(context, "Sample.Periodic")) {
         return ReadingContext::SamplePeriodic;
@@ -73,7 +73,7 @@ ReadingContext deserializeReadingContext(const char *context) {
         return ReadingContext::Trigger;
     }
 
-    AO_DBG_ERR("ReadingContext not specified %.10s", context);
+    MOCPP_DBG_ERR("ReadingContext not specified %.10s", context);
     return ReadingContext::NOT_SET;
 }
 }} //end namespaces
diff --git a/src/MicroOcpp/Model/Metering/SampledValue.h b/src/MicroOcpp/Model/Metering/SampledValue.h
index 939423ff..5f12b4b8 100644
--- a/src/MicroOcpp/Model/Metering/SampledValue.h
+++ b/src/MicroOcpp/Model/Metering/SampledValue.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -9,9 +9,9 @@
 #include <memory>
 #include <functional>
 
-#include <ArduinoOcpp/Platform.h>
+#include <MicroOcpp/Platform.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 template <class T>
 class SampledValueDeSerializer {
@@ -156,6 +156,6 @@ class SampledValueSamplerConcrete : public SampledValueSampler {
     }
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 51fd9035..527a26a1 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -1,23 +1,23 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Model/ConnectorBase/ConnectorsCommon.h>
-#include <ArduinoOcpp/Model/Metering/MeteringService.h>
-#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
-#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Model/Heartbeat/HeartbeatService.h>
-#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Model/Boot/BootService.h>
-#include <ArduinoOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h>
+#include <MicroOcpp/Model/Metering/MeteringService.h>
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
+#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
+#include <MicroOcpp/Model/Heartbeat/HeartbeatService.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Model/Reservation/ReservationService.h>
+#include <MicroOcpp/Model/Boot/BootService.h>
+#include <MicroOcpp/Model/Reset/ResetService.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 Model::Model(uint16_t bootNr) : bootNr(bootNr) {
     
@@ -98,7 +98,7 @@ unsigned int Model::getNumConnectors() const {
 
 Connector *Model::getConnector(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("connector with connectorId %u does not exist", connectorId);
+        MOCPP_DBG_ERR("connector with connectorId %u does not exist", connectorId);
         return nullptr;
     }
 
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 736380fa..89c9e553 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_MODEL_H
-#define AO_MODEL_H
+#ifndef MOCPP_MODEL_H
+#define MOCPP_MODEL_H
 
 #include <memory>
 
-#include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class TransactionStore;
 class SmartChargingService;
@@ -94,6 +94,6 @@ class Model {
     uint16_t getBootNr();
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
index 94d51617..f643e818 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.cpp
+++ b/src/MicroOcpp/Model/Reservation/Reservation.cpp
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Reservation/Reservation.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Reservation/Reservation.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Debug.h>
 
 #ifndef RESERVATION_FN
-#define RESERVATION_FN (AO_FILENAME_PREFIX "reservations.jsn")
+#define RESERVATION_FN (MOCPP_FILENAME_PREFIX "reservations.jsn")
 #endif
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 Reservation::Reservation(Model& model, unsigned int slot) : model(model), slot(slot) {
     const size_t KEY_SIZE = 50;
@@ -33,7 +33,7 @@ Reservation::Reservation(Model& model, unsigned int slot) : model(model), slot(s
     parentIdTag = declareConfiguration<const char*>(key, "", RESERVATION_FN, false, false, true, false);
 
     if (!connectorId || !expiryDateRaw || !idTag || !reservationId || !parentIdTag) {
-        AO_DBG_ERR("initialization failure");
+        MOCPP_DBG_ERR("initialization failure");
         (void)0;
     }
 }
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.h b/src/MicroOcpp/Model/Reservation/Reservation.h
index c6cfcad1..fba0061f 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.h
+++ b/src/MicroOcpp/Model/Reservation/Reservation.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef RESERVATION_H
 #define RESERVATION_H
 
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/Time.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index c9b9edec..b9dcfe7e 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -1,18 +1,18 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Operations/CancelReservation.h>
-#include <ArduinoOcpp/Operations/ReserveNow.h>
+#include <MicroOcpp/Model/Reservation/ReservationService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Operations/CancelReservation.h>
+#include <MicroOcpp/Operations/ReserveNow.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 ReservationService::ReservationService(Context& context, unsigned int numConnectors) : context(context), maxReservations((int) numConnectors - 1) {
     if (maxReservations > 0) {
@@ -83,7 +83,7 @@ void ReservationService::loop() {
 
 Reservation *ReservationService::getReservation(unsigned int connectorId) {
     if (connectorId == 0) {
-        AO_DBG_DEBUG("tried to fetch connectorId 0");
+        MOCPP_DBG_DEBUG("tried to fetch connectorId 0");
         return nullptr; //cannot fetch for connectorId 0 because multiple reservations are possible at a time
     }
 
@@ -98,7 +98,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId) {
 
 Reservation *ReservationService::getReservation(const char *idTag, const char *parentIdTag) {
     if (idTag == nullptr) {
-        AO_DBG_ERR("invalid input");
+        MOCPP_DBG_ERR("invalid input");
         return nullptr;
     }
 
@@ -141,7 +141,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
 
     if (reserveConnectorZeroSupported && !*reserveConnectorZeroSupported) {
         //no connectorZero check - all done
-        AO_DBG_DEBUG("no reservation");
+        MOCPP_DBG_DEBUG("no reservation");
         return nullptr;
     }
 
@@ -201,7 +201,7 @@ bool ReservationService::updateReservation(JsonObject payload) {
 //                payload["idTag"],
 //                payload.containsKey("parentIdTag") ? payload["parentIdTag"] : nullptr)) {
 //    if (auto reservation = getReservation(payload["connectorId"].as<int>())) {
-        AO_DBG_DEBUG("found blocking reservation at connectorId %u", reservation->getConnectorId());
+        MOCPP_DBG_DEBUG("found blocking reservation at connectorId %u", reservation->getConnectorId());
         (void)reservation;
         return false;
     }
@@ -214,6 +214,6 @@ bool ReservationService::updateReservation(JsonObject payload) {
         }
     }
 
-    AO_DBG_ERR("error finding blocking reservation");
+    MOCPP_DBG_ERR("error finding blocking reservation");
     return false;
 }
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.h b/src/MicroOcpp/Model/Reservation/ReservationService.h
index 38fb807c..fb1cd289 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.h
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef RESERVATIONSERVICE_H
 #define RESERVATIONSERVICE_H
 
-#include <ArduinoOcpp/Model/Reservation/Reservation.h>
+#include <MicroOcpp/Model/Reservation/Reservation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Context;
 
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index fb576eb8..7e342fbb 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -1,27 +1,27 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Reset/ResetService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Operations/Reset.h>
+#include <MicroOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Operations/Reset.h>
 
-#include <ArduinoOcpp/Operations/Authorize.h>
-#include <ArduinoOcpp/Operations/StartTransaction.h>
-#include <ArduinoOcpp/Operations/StatusNotification.h>
-#include <ArduinoOcpp/Operations/StopTransaction.h>
+#include <MicroOcpp/Operations/Authorize.h>
+#include <MicroOcpp/Operations/StartTransaction.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+#include <MicroOcpp/Operations/StopTransaction.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
 #include <memory>
 #include <string.h>
 
 #define RESET_DELAY 15000
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 ResetService::ResetService(Context& context)
       : context(context) {
@@ -38,17 +38,17 @@ ResetService::~ResetService() {
 
 void ResetService::loop() {
 
-    if (outstandingResetRetries > 0 && ao_tick_ms() - t_resetRetry >= RESET_DELAY) {
-        t_resetRetry = ao_tick_ms();
+    if (outstandingResetRetries > 0 && mocpp_tick_ms() - t_resetRetry >= RESET_DELAY) {
+        t_resetRetry = mocpp_tick_ms();
         outstandingResetRetries--;
         if (executeReset) {
-            AO_DBG_INFO("Reset device");
+            MOCPP_DBG_INFO("Reset device");
             executeReset(isHardReset);
         } else {
-            AO_DBG_ERR("No Reset function set! Abort");
+            MOCPP_DBG_ERR("No Reset function set! Abort");
             outstandingResetRetries = 0;
         }
-        AO_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
+        MOCPP_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
 
         if (outstandingResetRetries <= 0) {
             for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
@@ -92,10 +92,10 @@ void ResetService::initiateReset(bool isHard) {
     isHardReset = isHard;
     outstandingResetRetries = 1 + *resetRetries; //one initial try + no. of retries
     if (outstandingResetRetries > 5) {
-        AO_DBG_ERR("no. of reset trials exceeds 5");
+        MOCPP_DBG_ERR("no. of reset trials exceeds 5");
         outstandingResetRetries = 5;
     }
-    t_resetRetry = ao_tick_ms();
+    t_resetRetry = mocpp_tick_ms();
 
     for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
         auto connector = context.getModel().getConnector(cId);
@@ -103,11 +103,11 @@ void ResetService::initiateReset(bool isHard) {
     }
 }
 
-#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
-std::function<void(bool isHard)> ArduinoOcpp::makeDefaultResetFn() {
+#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+std::function<void(bool isHard)> MicroOcpp::makeDefaultResetFn() {
     return [] (bool isHard) {
-        AO_DBG_DEBUG("Perform ESP reset");
+        MOCPP_DBG_DEBUG("Perform ESP reset");
         ESP.restart();
     };
 }
-#endif //AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+#endif //MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
diff --git a/src/MicroOcpp/Model/Reset/ResetService.h b/src/MicroOcpp/Model/Reset/ResetService.h
index 3466d60e..ce8c27d7 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.h
+++ b/src/MicroOcpp/Model/Reset/ResetService.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef RESETSERVICE_H
 #define RESETSERVICE_H
 
-#include <ArduinoOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Context;
 
@@ -16,7 +16,7 @@ class ResetService {
     Context& context;
 
     std::function<bool(bool isHard)> preReset; //true: reset is possible; false: reject reset; Await: need more time to determine
-    std::function<void(bool isHard)> executeReset; //please disconnect WebSocket (AO remains initialized), shut down device and restart with normal initialization routine; on failure reconnect WebSocket
+    std::function<void(bool isHard)> executeReset; //please disconnect WebSocket (MO remains initialized), shut down device and restart with normal initialization routine; on failure reconnect WebSocket
     unsigned int outstandingResetRetries = 0; //0 = do not reset device
     bool isHardReset = false;
     unsigned long t_resetRetry;
@@ -39,16 +39,16 @@ class ResetService {
     void initiateReset(bool isHard);
 };
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
-#if AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 std::function<void(bool isHard)> makeDefaultResetFn();
 
 }
 
-#endif //AO_PLATFORM == AO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+#endif //MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
 
 #endif
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
index d0904bab..1e27223e 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingModel.h>
+#include <MicroOcpp/Debug.h>
 
 #include <string.h>
 #include <algorithm>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
-ChargeRate ArduinoOcpp::chargeRate_min(const ChargeRate& a, const ChargeRate& b) {
+ChargeRate MicroOcpp::chargeRate_min(const ChargeRate& a, const ChargeRate& b) {
     ChargeRate res;
     res.power = std::min(a.power, b.power);
     res.current = std::min(a.current, b.current);
@@ -35,7 +35,7 @@ bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &start
             } else if (startOfCharging > MIN_TIME && startOfCharging < t) {
                 basis = startOfCharging;
             } else {
-                AO_DBG_ERR("Absolute profile, but neither startSchedule, nor start of charging are set. Undefined behavior, abort");
+                MOCPP_DBG_ERR("Absolute profile, but neither startSchedule, nor start of charging are set. Undefined behavior, abort");
                 return false;
             }
             break;
@@ -47,7 +47,7 @@ bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &start
                 basis = t - ((t - startSchedule) % (7 * 24 * 3600));
                 nextChange = std::min(nextChange, basis + (7 * 24 * 3600));
             } else {
-                AO_DBG_ERR("Recurring ChargingProfile but no RecurrencyKindType set. Undefined behavior, assume 'Daily'");
+                MOCPP_DBG_ERR("Recurring ChargingProfile but no RecurrencyKindType set. Undefined behavior, assume 'Daily'");
                 basis = t - ((t - startSchedule) % (24 * 3600));
                 nextChange = std::min(nextChange, basis + (24 * 3600));
             }
@@ -64,7 +64,7 @@ bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &start
     }
 
     if (t < basis) { //check for error
-        AO_DBG_ERR("time basis is smaller than t, but t must be >= basis");
+        MOCPP_DBG_ERR("time basis is smaller than t, but t must be >= basis");
         return false;
     }
     
@@ -151,7 +151,7 @@ void ChargingSchedule::printSchedule(){
     char tmp[JSONDATE_LENGTH + 1] = {'\0'};
     startSchedule.toJsonString(tmp, JSONDATE_LENGTH + 1);
 
-    AO_CONSOLE_PRINTF("   > CHARGING SCHEDULE:\n" \
+    MOCPP_CONSOLE_PRINTF("   > CHARGING SCHEDULE:\n" \
                 "       > duration: %i\n" \
                 "       > startSchedule: %s\n" \
                 "       > chargingRateUnit: %s\n" \
@@ -163,7 +163,7 @@ void ChargingSchedule::printSchedule(){
                 minChargingRate);
 
     for (auto period = chargingSchedulePeriod.begin(); period != chargingSchedulePeriod.end(); period++) {
-        AO_CONSOLE_PRINTF("       > CHARGING SCHEDULE PERIOD:\n" \
+        MOCPP_CONSOLE_PRINTF("       > CHARGING SCHEDULE PERIOD:\n" \
                 "           > startPeriod: %i\n" \
                 "           > limit: %f\n" \
                 "           > numberPhases: %i\n",
@@ -262,7 +262,7 @@ bool ChargingProfile::toJson(DynamicJsonDocument& doc) {
 
     if (validFrom > MIN_TIME) {
         if (!validFrom.toJsonString(timeStr, JSONDATE_LENGTH + 1)) {
-            AO_DBG_ERR("serialization error");
+            MOCPP_DBG_ERR("serialization error");
             return false;
         }
         doc["validFrom"] = timeStr;
@@ -270,7 +270,7 @@ bool ChargingProfile::toJson(DynamicJsonDocument& doc) {
 
     if (validTo > MIN_TIME) {
         if (!validTo.toJsonString(timeStr, JSONDATE_LENGTH + 1)) {
-            AO_DBG_ERR("serialization error");
+            MOCPP_DBG_ERR("serialization error");
             return false;
         }
         doc["validTo"] = timeStr;
@@ -288,7 +288,7 @@ void ChargingProfile::printProfile(){
     char tmp2[JSONDATE_LENGTH + 1] = {'\0'};
     validTo.toJsonString(tmp2, JSONDATE_LENGTH + 1);
 
-    AO_CONSOLE_PRINTF("   > CHARGING PROFILE:\n" \
+    MOCPP_CONSOLE_PRINTF("   > CHARGING PROFILE:\n" \
                 "   > chargingProfileId: %i\n" \
                 "   > transactionId: %i\n" \
                 "   > stackLevel: %i\n" \
@@ -316,14 +316,14 @@ void ChargingProfile::printProfile(){
     chargingSchedule.printSchedule();
 }
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 bool loadChargingSchedulePeriod(JsonObject& json, ChargingSchedulePeriod& out) {
     int startPeriod = json["startPeriod"] | -1;
     if (startPeriod >= 0) {
         out.startPeriod = startPeriod;
     } else {
-        AO_DBG_WARN("format violation");
+        MOCPP_DBG_WARN("format violation");
         return false;
     }
 
@@ -331,7 +331,7 @@ bool loadChargingSchedulePeriod(JsonObject& json, ChargingSchedulePeriod& out) {
     if (limit >= 0.f) {
         out.limit = limit;
     } else {
-        AO_DBG_WARN("format violation");
+        MOCPP_DBG_WARN("format violation");
         return false;
     }
 
@@ -340,7 +340,7 @@ bool loadChargingSchedulePeriod(JsonObject& json, ChargingSchedulePeriod& out) {
         if (numberPhases >= 0 && numberPhases <= 3) {
             out.numberPhases = numberPhases;
         } else {
-            AO_DBG_WARN("format violation");
+            MOCPP_DBG_WARN("format violation");
             return false;
         }
     }
@@ -348,16 +348,16 @@ bool loadChargingSchedulePeriod(JsonObject& json, ChargingSchedulePeriod& out) {
     return true;
 }
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
-std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& json) {
+std::unique_ptr<ChargingProfile> MicroOcpp::loadChargingProfile(JsonObject& json) {
     auto res = std::unique_ptr<ChargingProfile>(new ChargingProfile());
 
     int chargingProfileId = json["chargingProfileId"] | -1;
     if (chargingProfileId >= 0) {
         res->chargingProfileId = chargingProfileId;
     } else {
-        AO_DBG_WARN("format violation");
+        MOCPP_DBG_WARN("format violation");
         return nullptr;
     }
 
@@ -370,7 +370,7 @@ std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& js
     if (stackLevel >= 0 && stackLevel <= CHARGEPROFILEMAXSTACKLEVEL) {
         res->stackLevel = stackLevel;
     } else {
-        AO_DBG_WARN("format violation");
+        MOCPP_DBG_WARN("format violation");
         return nullptr;
     }
 
@@ -382,7 +382,7 @@ std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& js
     } else if (!strcmp(chargingProfilePurposeStr, "TxProfile")) {
         res->chargingProfilePurpose = ChargingProfilePurposeType::TxProfile;
     } else {
-        AO_DBG_WARN("format violation");
+        MOCPP_DBG_WARN("format violation");
         return nullptr;
     }
 
@@ -394,7 +394,7 @@ std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& js
     } else if (!strcmp(chargingProfileKindStr, "Relative")) {
         res->chargingProfileKind = ChargingProfileKindType::Relative;
     } else {
-        AO_DBG_WARN("format violation");
+        MOCPP_DBG_WARN("format violation");
         return nullptr;
     }
 
@@ -405,12 +405,12 @@ std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& js
         res->recurrencyKind = RecurrencyKindType::Weekly;
     }
 
-    AO_DBG_DEBUG("Deserialize JSON: chargingProfileId=%i, chargingProfilePurpose=%s, recurrencyKind=%s", chargingProfileId, chargingProfilePurposeStr, recurrencyKindStr);
+    MOCPP_DBG_DEBUG("Deserialize JSON: chargingProfileId=%i, chargingProfilePurpose=%s, recurrencyKind=%s", chargingProfileId, chargingProfilePurposeStr, recurrencyKindStr);
 
     if (json.containsKey("validFrom")) {
         if (!res->validFrom.setTime(json["validFrom"] | "Invalid")) {
             //non-success
-            AO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            MOCPP_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
             return nullptr;
         }
     } else {
@@ -420,7 +420,7 @@ std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& js
     if (json.containsKey("validTo")) {
         if (!res->validTo.setTime(json["validTo"] | "Invalid")) {
             //non-success
-            AO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            MOCPP_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
             return nullptr;
         }
     } else {
@@ -441,13 +441,13 @@ std::unique_ptr<ChargingProfile> ArduinoOcpp::loadChargingProfile(JsonObject& js
     return res;
 }
 
-bool ArduinoOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
+bool MicroOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
     if (json.containsKey("duration")) {
         int duration = json["duration"] | -1;
         if (duration >= 0) {
             out.duration = duration;
         } else {
-            AO_DBG_WARN("format violation");
+            MOCPP_DBG_WARN("format violation");
             return false;
         }
     }
@@ -455,7 +455,7 @@ bool ArduinoOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out)
     if (json.containsKey("startSchedule")) {
         if (!out.startSchedule.setTime(json["startSchedule"] | "Invalid")) {
             //non-success
-            AO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            MOCPP_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
             return false;
         }
     } else {
@@ -468,13 +468,13 @@ bool ArduinoOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out)
     } else if (unit[0] == 'w' || unit[0] == 'W') {
         out.chargingRateUnit = ChargingRateUnitType::Watt;
     } else {
-        AO_DBG_WARN("format violation");
+        MOCPP_DBG_WARN("format violation");
         return false;
     }
     
     JsonArray periodJsonArray = json["chargingSchedulePeriod"];
     if (periodJsonArray.size() < 1) {
-        AO_DBG_WARN("format violation");
+        MOCPP_DBG_WARN("format violation");
         return false;
     }
 
@@ -490,7 +490,7 @@ bool ArduinoOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out)
         if (minChargingRate >= 0.f) {
             out.minChargingRate = minChargingRate;
         } else {
-            AO_DBG_WARN("format violation");
+            MOCPP_DBG_WARN("format violation");
             return false;
         }
     }
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
index 46071c61..abd62c1f 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -15,9 +15,9 @@
 
 #include <ArduinoJson.h>
 
-#include <ArduinoOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Time.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 enum class ChargingProfilePurposeType {
     ChargePointMaxProfile,
@@ -141,6 +141,6 @@ std::unique_ptr<ChargingProfile> loadChargingProfile(JsonObject& json);
 
 bool loadChargingSchedule(JsonObject& json, ChargingSchedule& out);
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index 09f050b1..092999a9 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -1,19 +1,19 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Operations/ClearChargingProfile.h>
-#include <ArduinoOcpp/Operations/GetCompositeSchedule.h>
-#include <ArduinoOcpp/Operations/SetChargingProfile.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Operations/ClearChargingProfile.h>
+#include <MicroOcpp/Operations/GetCompositeSchedule.h>
+#include <MicroOcpp/Operations/SetChargingProfile.h>
+#include <MicroOcpp/Debug.h>
 
-using namespace::ArduinoOcpp;
+using namespace::MicroOcpp;
 
 SmartChargingConnector::SmartChargingConnector(Model& model, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ProfileStack& ChargePointMaxProfile, ProfileStack& ChargePointTxDefaultProfile) :
         model(model), filesystem{filesystem}, connectorId{connectorId}, ChargePointMaxProfile(ChargePointMaxProfile), ChargePointTxDefaultProfile(ChargePointTxDefaultProfile) {
@@ -174,7 +174,7 @@ void SmartChargingConnector::loop(){
 
 void SmartChargingConnector::setSmartChargingOutput(std::function<void(float,float,int)> limitOutput) {
     if (this->limitOutput) {
-        AO_DBG_WARN("replacing existing SmartChargingOutput");
+        MOCPP_DBG_WARN("replacing existing SmartChargingOutput");
         (void)0;
     }
     this->limitOutput = limitOutput;
@@ -195,7 +195,7 @@ ChargingProfile *SmartChargingConnector::updateProfiles(std::unique_ptr<Charging
             return TxProfile[stackLevel].get();
     }
 
-    AO_DBG_ERR("invalid args");
+    MOCPP_DBG_ERR("invalid args");
     return nullptr;
 }
 
@@ -335,18 +335,18 @@ SmartChargingService::~SmartChargingService() {
 ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile){
 
     if ((connectorId > 0 && !getScConnectorById(connectorId)) || !chargingProfile) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return nullptr;
     }
 
-    if (AO_DBG_LEVEL >= AO_DL_VERBOSE) {
-        AO_DBG_VERBOSE("Charging Profile internal model:");
+    if (MOCPP_DBG_LEVEL >= MOCPP_DL_VERBOSE) {
+        MOCPP_DBG_VERBOSE("Charging Profile internal model:");
         chargingProfile->printProfile();
     }
 
     int stackLevel = chargingProfile->getStackLevel();
     if (stackLevel< 0 || stackLevel >= CHARGEPROFILEMAXSTACKLEVEL + 1) {
-        AO_DBG_ERR("input validation failed");
+        MOCPP_DBG_ERR("input validation failed");
         return nullptr;
     }
 
@@ -364,7 +364,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
     }
 
     if (chargingProfilesCount >= MAXCHARGINGPROFILESINSTALLED) {
-        AO_DBG_WARN("number of maximum charging profiles exceeded");
+        MOCPP_DBG_WARN("number of maximum charging profiles exceeded");
         return nullptr;
     }
 
@@ -373,7 +373,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
     switch (chargingProfile->getChargingProfilePurpose()) {
         case (ChargingProfilePurposeType::ChargePointMaxProfile):
             if (connectorId != 0) {
-                AO_DBG_WARN("invalid charging profile");
+                MOCPP_DBG_WARN("invalid charging profile");
                 return nullptr;
             }
             ChargePointMaxProfile[stackLevel] = std::move(chargingProfile);
@@ -385,7 +385,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
                 res = ChargePointTxDefaultProfile[stackLevel].get();
             } else {
                 if (!getScConnectorById(connectorId)) {
-                    AO_DBG_WARN("invalid charging profile");
+                    MOCPP_DBG_WARN("invalid charging profile");
                     return nullptr;
                 }
                 res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
@@ -393,7 +393,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
             break;
         case (ChargingProfilePurposeType::TxProfile):
             if (!getScConnectorById(connectorId)) {
-                AO_DBG_WARN("invalid charging profile");
+                MOCPP_DBG_WARN("invalid charging profile");
                 return nullptr;
             }
             res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
@@ -419,13 +419,13 @@ bool SmartChargingService::loadProfiles() {
     bool success = true;
 
     if (!filesystem) {
-        AO_DBG_DEBUG("no filesystem");
+        MOCPP_DBG_DEBUG("no filesystem");
         return true; //not an error
     }
 
     ChargingProfilePurposeType purposes[] = {ChargingProfilePurposeType::ChargePointMaxProfile, ChargingProfilePurposeType::TxDefaultProfile, ChargingProfilePurposeType::TxProfile};
 
-    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
 
     for (auto purpose : purposes) {
         for (unsigned int cId = 0; cId < numConnectors; cId++) {
@@ -434,7 +434,7 @@ bool SmartChargingService::loadProfiles() {
             }
             for (unsigned int iLevel = 0; iLevel < CHARGEPROFILEMAXSTACKLEVEL; iLevel++) {
 
-                if (!SmartChargingServiceUtils::printProfileFileName(fn, AO_MAX_PATH_SIZE, cId, purpose, iLevel)) {
+                if (!SmartChargingServiceUtils::printProfileFileName(fn, MOCPP_MAX_PATH_SIZE, cId, purpose, iLevel)) {
                     return false;
                 }
 
@@ -446,7 +446,7 @@ bool SmartChargingService::loadProfiles() {
                 auto profileDoc = FilesystemUtils::loadJson(filesystem, fn);
                 if (!profileDoc) {
                     success = false;
-                    AO_DBG_ERR("profile corrupt: %s, remove", fn);
+                    MOCPP_DBG_ERR("profile corrupt: %s, remove", fn);
                     filesystem->remove(fn);
                     continue;
                 }
@@ -460,7 +460,7 @@ bool SmartChargingService::loadProfiles() {
                 }
                 if (!valid) {
                     success = false;
-                    AO_DBG_ERR("profile corrupt: %s, remove", fn);
+                    MOCPP_DBG_ERR("profile corrupt: %s, remove", fn);
                     filesystem->remove(fn);
                 }
             }
@@ -511,12 +511,12 @@ void SmartChargingService::loop(){
 
         calculateLimit(tnow, limit, nextChange);
 
-#if (AO_DBG_LEVEL >= AO_DL_INFO)
+#if (MOCPP_DBG_LEVEL >= MOCPP_DL_INFO)
         char timestamp1[JSONDATE_LENGTH + 1] = {'\0'};
         tnow.toJsonString(timestamp1, JSONDATE_LENGTH + 1);
         char timestamp2[JSONDATE_LENGTH + 1] = {'\0'};
         nextChange.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
-        AO_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = {%f,%f,%i}",
+        MOCPP_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = {%f,%f,%i}",
                             timestamp1, timestamp2,
                             limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
                             limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
@@ -538,13 +538,13 @@ void SmartChargingService::loop(){
 
 void SmartChargingService::setSmartChargingOutput(unsigned int connectorId, std::function<void(float,float,int)> limitOutput) {
     if ((connectorId > 0 && !getScConnectorById(connectorId))) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return;
     }
 
     if (connectorId == 0) {
         if (this->limitOutput) {
-            AO_DBG_WARN("replacing existing SmartChargingOutput");
+            MOCPP_DBG_WARN("replacing existing SmartChargingOutput");
             (void)0;
         }
         this->limitOutput = limitOutput;
@@ -575,7 +575,7 @@ void SmartChargingService::updateAllowedChargingRateUnit(bool powerSupported, bo
 bool SmartChargingService::setChargingProfile(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile) {
 
     if ((connectorId > 0 && !getScConnectorById(connectorId)) || !chargingProfile) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return false;
     }
 
@@ -637,7 +637,7 @@ bool SmartChargingService::clearChargingProfile(std::function<bool(int, int, Cha
 std::unique_ptr<ChargingSchedule> SmartChargingService::getCompositeSchedule(unsigned int connectorId, int duration, ChargingRateUnitType_Optional unit) {
 
     if (connectorId > 0 && !getScConnectorById(connectorId)) {
-        AO_DBG_ERR("invalid args");
+        MOCPP_DBG_ERR("invalid args");
         return nullptr;
     }
     
@@ -704,18 +704,18 @@ bool SmartChargingServiceUtils::printProfileFileName(char *out, size_t bufsize,
 
     switch (purpose) {
         case (ChargingProfilePurposeType::ChargePointMaxProfile):
-            pret = snprintf(out, bufsize, AO_FILENAME_PREFIX "sc-cm-%u.jsn", stackLevel);
+            pret = snprintf(out, bufsize, MOCPP_FILENAME_PREFIX "sc-cm-%u.jsn", stackLevel);
             break;
         case (ChargingProfilePurposeType::TxDefaultProfile):
-            pret = snprintf(out, bufsize, AO_FILENAME_PREFIX "sc-td-%u-%u.jsn", connectorId, stackLevel);
+            pret = snprintf(out, bufsize, MOCPP_FILENAME_PREFIX "sc-td-%u-%u.jsn", connectorId, stackLevel);
             break;
         case (ChargingProfilePurposeType::TxProfile):
-            pret = snprintf(out, bufsize, AO_FILENAME_PREFIX "sc-tx-%u-%u.jsn", connectorId, stackLevel);
+            pret = snprintf(out, bufsize, MOCPP_FILENAME_PREFIX "sc-tx-%u-%u.jsn", connectorId, stackLevel);
             break;
     }
 
     if (pret < 0 || (size_t) pret >= bufsize) {
-        AO_DBG_ERR("fn error: %i", pret);
+        MOCPP_DBG_ERR("fn error: %i", pret);
         return false;
     }
 
@@ -733,9 +733,9 @@ bool SmartChargingServiceUtils::storeProfile(std::shared_ptr<FilesystemAdapter>
         return false;
     }
 
-    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
 
-    if (!printProfileFileName(fn, AO_MAX_PATH_SIZE, connectorId, chargingProfile->getChargingProfilePurpose(), chargingProfile->getStackLevel())) {
+    if (!printProfileFileName(fn, MOCPP_MAX_PATH_SIZE, connectorId, chargingProfile->getChargingProfilePurpose(), chargingProfile->getStackLevel())) {
         return false;
     }
 
@@ -748,9 +748,9 @@ bool SmartChargingServiceUtils::removeProfile(std::shared_ptr<FilesystemAdapter>
         return false;
     }
 
-    char fn [AO_MAX_PATH_SIZE] = {'\0'};
+    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
 
-    if (!printProfileFileName(fn, AO_MAX_PATH_SIZE, connectorId, purpose, stackLevel)) {
+    if (!printProfileFileName(fn, MOCPP_MAX_PATH_SIZE, connectorId, purpose, stackLevel)) {
         return false;
     }
 
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
index a95cc696..f4dfa8ee 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -10,12 +10,12 @@
 
 #include <ArduinoJson.h>
 
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingModel.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingModel.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 enum class ChargingRateUnitType_Optional {
     Watt,
@@ -119,6 +119,6 @@ bool storeProfile(std::shared_ptr<FilesystemAdapter> filesystem, unsigned int co
 bool removeProfile(std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ChargingProfilePurposeType purpose, unsigned int stackLevel);
 }
 
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.cpp b/src/MicroOcpp/Model/Transactions/Transaction.cpp
index d733a018..9c6535fa 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.cpp
+++ b/src/MicroOcpp/Model/Transactions/Transaction.cpp
@@ -1,11 +1,11 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 bool Transaction::setIdTag(const char *idTag) {
     auto ret = snprintf(this->idTag, IDTAG_LEN_MAX + 1, "%s", idTag);
@@ -26,57 +26,57 @@ bool Transaction::commit() {
     return context.commit(this);
 }
 
-int ao_tx_getTransactionId(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getTransactionId();
+int ocpp_tx_getTransactionId(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getTransactionId();
 }
-bool ao_tx_isAuthorized(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isAuthorized();
+bool ocpp_tx_isAuthorized(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isAuthorized();
 }
-bool ao_tx_isIdTagDeauthorized(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isIdTagDeauthorized();
+bool ocpp_tx_isIdTagDeauthorized(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isIdTagDeauthorized();
 }
 
-bool ao_tx_isRunning(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isRunning();
+bool ocpp_tx_isRunning(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isRunning();
 }
-bool ao_tx_isActive(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isActive();
+bool ocpp_tx_isActive(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isActive();
 }
-bool ao_tx_isAborted(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isAborted();
+bool ocpp_tx_isAborted(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isAborted();
 }
-bool ao_tx_isCompleted(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->isCompleted();
+bool ocpp_tx_isCompleted(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isCompleted();
 }
 
-const char *ao_tx_getIdTag(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getIdTag();
+const char *ocpp_tx_getIdTag(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getIdTag();
 }
 
-bool ao_tx_getBeginTimestamp(AO_Transaction *tx, char *buf, size_t len) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getBeginTimestamp().toJsonString(buf, len);
+bool ocpp_tx_getBeginTimestamp(OCPP_Transaction *tx, char *buf, size_t len) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getBeginTimestamp().toJsonString(buf, len);
 }
 
-int32_t ao_tx_getMeterStart(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getMeterStart();
+int32_t ocpp_tx_getMeterStart(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getMeterStart();
 }
 
-bool ao_tx_getStartTimestamp(AO_Transaction *tx, char *buf, size_t len) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStartTimestamp().toJsonString(buf, len);
+bool ocpp_tx_getStartTimestamp(OCPP_Transaction *tx, char *buf, size_t len) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getStartTimestamp().toJsonString(buf, len);
 }
 
-const char *ao_tx_getStopIdTag(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStopIdTag();
+const char *ocpp_tx_getStopIdTag(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getStopIdTag();
 }
 
-int32_t ao_tx_getMeterStop(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getMeterStop();
+int32_t ocpp_tx_getMeterStop(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getMeterStop();
 }
 
-bool ao_tx_getStopTimestamp(AO_Transaction *tx, char *buf, size_t len) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStopTimestamp().toJsonString(buf, len);
+bool ocpp_tx_getStopTimestamp(OCPP_Transaction *tx, char *buf, size_t len) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getStopTimestamp().toJsonString(buf, len);
 }
 
-const char *ao_tx_getStopReason(AO_Transaction *tx) {
-    return reinterpret_cast<ArduinoOcpp::Transaction*>(tx)->getStopReason();
+const char *ocpp_tx_getStopReason(OCPP_Transaction *tx) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getStopReason();
 }
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index 7e9bbf53..1c711da6 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -7,10 +7,10 @@
 
 #ifdef __cplusplus
 
-#include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Operations/CiStrings.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 /*
  * A transaction is initiated by the client (charging station) and processed by the server (central system).
@@ -170,33 +170,33 @@ class Transaction {
 extern "C" {
 #endif //__cplusplus
 
-struct AO_Transaction;
-typedef struct AO_Transaction AO_Transaction;
+struct OCPP_Transaction;
+typedef struct OCPP_Transaction OCPP_Transaction;
 
-int ao_tx_getTransactionId(AO_Transaction *tx);
-bool ao_tx_isAuthorized(AO_Transaction *tx);
-bool ao_tx_isIdTagDeauthorized(AO_Transaction *tx);
+int ocpp_tx_getTransactionId(OCPP_Transaction *tx);
+bool ocpp_tx_isAuthorized(OCPP_Transaction *tx);
+bool ocpp_tx_isIdTagDeauthorized(OCPP_Transaction *tx);
 
-bool ao_tx_isRunning(AO_Transaction *tx);
-bool ao_tx_isActive(AO_Transaction *tx);
-bool ao_tx_isAborted(AO_Transaction *tx);
-bool ao_tx_isCompleted(AO_Transaction *tx);
+bool ocpp_tx_isRunning(OCPP_Transaction *tx);
+bool ocpp_tx_isActive(OCPP_Transaction *tx);
+bool ocpp_tx_isAborted(OCPP_Transaction *tx);
+bool ocpp_tx_isCompleted(OCPP_Transaction *tx);
 
-const char *ao_tx_getIdTag(AO_Transaction *tx);
+const char *ocpp_tx_getIdTag(OCPP_Transaction *tx);
 
-bool ao_tx_getBeginTimestamp(AO_Transaction *tx, char *buf, size_t len);
+bool ocpp_tx_getBeginTimestamp(OCPP_Transaction *tx, char *buf, size_t len);
 
-int32_t ao_tx_getMeterStart(AO_Transaction *tx);
+int32_t ocpp_tx_getMeterStart(OCPP_Transaction *tx);
 
-bool ao_tx_getStartTimestamp(AO_Transaction *tx, char *buf, size_t len);
+bool ocpp_tx_getStartTimestamp(OCPP_Transaction *tx, char *buf, size_t len);
 
-const char *ao_tx_getStopIdTag(AO_Transaction *tx);
+const char *ocpp_tx_getStopIdTag(OCPP_Transaction *tx);
 
-int32_t ao_tx_getMeterStop(AO_Transaction *tx);
+int32_t ocpp_tx_getMeterStop(OCPP_Transaction *tx);
 
-bool ao_tx_getStopTimestamp(AO_Transaction *tx, char *buf, size_t len);
+bool ocpp_tx_getStopTimestamp(OCPP_Transaction *tx, char *buf, size_t len);
 
-const char *ao_tx_getStopReason(AO_Transaction *tx);
+const char *ocpp_tx_getStopReason(OCPP_Transaction *tx);
 
 #ifdef __cplusplus
 } //end extern "C"
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
index 27d75f69..44089460 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #include <limits>
 
-#include <ArduinoOcpp/Model/Transactions/TransactionDeserialize.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Transactions/TransactionDeserialize.h>
+#include <MicroOcpp/Debug.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 bool serializeSendStatus(SendStatus& status, JsonObject out) {
     if (status.isRequested()) {
@@ -107,7 +107,7 @@ bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
     }
 
     if (out.overflowed()) {
-        AO_DBG_ERR("JSON capacity exceeded");
+        MOCPP_DBG_ERR("JSON capacity exceeded");
         return false;
     }
 
@@ -124,7 +124,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
 
     if (sessionState.containsKey("idTag")) {
         if (!tx.setIdTag(sessionState["idTag"] | "")) {
-            AO_DBG_ERR("read err");
+            MOCPP_DBG_ERR("read err");
             return false;
         }
     }
@@ -140,7 +140,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
     if (sessionState.containsKey("timestamp")) {
         Timestamp timestamp;
         if (!timestamp.setTime(sessionState["timestamp"] | "Invalid")) {
-            AO_DBG_ERR("read err");
+            MOCPP_DBG_ERR("read err");
             return false;
         }
         tx.setBeginTimestamp(timestamp);
@@ -167,7 +167,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
     if (txStart.containsKey("timestamp")) {
         Timestamp timestamp;
         if (!timestamp.setTime(txStart["timestamp"] | "Invalid")) {
-            AO_DBG_ERR("read err");
+            MOCPP_DBG_ERR("read err");
             return false;
         }
         tx.setStartTimestamp(timestamp);
@@ -178,7 +178,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
         if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
             tx.setStartBootNr((uint16_t) bootNrIn);
         } else {
-            AO_DBG_ERR("read err");
+            MOCPP_DBG_ERR("read err");
             return false;
         }
     }
@@ -195,7 +195,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
 
     if (txStop.containsKey("idTag")) {
         if (!tx.setStopIdTag(txStop["idTag"] | "")) {
-            AO_DBG_ERR("read err");
+            MOCPP_DBG_ERR("read err");
             return false;
         }
     }
@@ -207,7 +207,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
     if (txStop.containsKey("timestamp")) {
         Timestamp timestamp;
         if (!timestamp.setTime(txStop["timestamp"] | "Invalid")) {
-            AO_DBG_ERR("read err");
+            MOCPP_DBG_ERR("read err");
             return false;
         }
         tx.setStopTimestamp(timestamp);
@@ -218,14 +218,14 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
         if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
             tx.setStopBootNr((uint16_t) bootNrIn);
         } else {
-            AO_DBG_ERR("read err");
+            MOCPP_DBG_ERR("read err");
             return false;
         }
     }
 
     if (txStop.containsKey("reason")) {
         if (!tx.setStopReason(txStop["reason"] | "")) {
-            AO_DBG_ERR("read err");
+            MOCPP_DBG_ERR("read err");
             return false;
         }
     }
@@ -234,12 +234,12 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
         tx.setSilent();
     }
 
-    AO_DBG_DEBUG("DUMP TX");
-    AO_DBG_DEBUG("Session   | idTag %s, active: %i, authorized: %i, deauthorized: %i", tx.getIdTag(), tx.isActive(), tx.isAuthorized(), tx.isIdTagDeauthorized());
-    AO_DBG_DEBUG("Start RPC | req: %i, conf: %i", tx.getStartSync().isRequested(), tx.getStartSync().isConfirmed());
-    AO_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  tx.getStopSync().isRequested(), tx.getStopSync().isConfirmed());
+    MOCPP_DBG_DEBUG("DUMP TX");
+    MOCPP_DBG_DEBUG("Session   | idTag %s, active: %i, authorized: %i, deauthorized: %i", tx.getIdTag(), tx.isActive(), tx.isAuthorized(), tx.isIdTagDeauthorized());
+    MOCPP_DBG_DEBUG("Start RPC | req: %i, conf: %i", tx.getStartSync().isRequested(), tx.getStartSync().isConfirmed());
+    MOCPP_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  tx.getStopSync().isRequested(), tx.getStopSync().isConfirmed());
     if (tx.isSilent()) {
-        AO_DBG_DEBUG("          | silent Tx");
+        MOCPP_DBG_DEBUG("          | silent Tx");
         (void)0;
     }
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
index ccf80cc2..b1f3e200 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef TRANSACTIONDESERIALIZE_H
 #define TRANSACTIONDESERIALIZE_H
 
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
 
 #include <ArduinoJson.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out);
 bool deserializeTransaction(Transaction& tx, JsonObject in);
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
index c80320de..ccbf8c7d 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
@@ -1,21 +1,21 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Model/Transactions/TransactionDeserialize.h>
-#include <ArduinoOcpp/Operations/StartTransaction.h>
-#include <ArduinoOcpp/Operations/StopTransaction.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/Transactions/TransactionDeserialize.h>
+#include <MicroOcpp/Operations/StartTransaction.h>
+#include <MicroOcpp/Operations/StopTransaction.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Debug.h>
 
 #include <algorithm>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
-#define AO_TXSTORE_META_FN AO_FILENAME_PREFIX "txstore.jsn"
+#define MOCPP_TXSTORE_META_FN MOCPP_FILENAME_PREFIX "txstore.jsn"
 
 ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context, unsigned int connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context),
@@ -23,17 +23,17 @@ ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context,
         filesystem(filesystem) {
 
     char key [30] = {'\0'};
-    if (snprintf(key, 30, "AO_txEnd_%u", connectorId) < 0) {
-        AO_DBG_ERR("Invalid key");
+    if (snprintf(key, 30, "MO_txEnd_%u", connectorId) < 0) {
+        MOCPP_DBG_ERR("Invalid key");
         (void)0;
     }
-    txEnd = declareConfiguration<int>(key, 0, AO_TXSTORE_META_FN, false, false, true, false);
+    txEnd = declareConfiguration<int>(key, 0, MOCPP_TXSTORE_META_FN, false, false, true, false);
 
-    if (snprintf(key, 30, "AO_txBegin_%u", connectorId) < 0) {
-        AO_DBG_ERR("Invalid key");
+    if (snprintf(key, 30, "MO_txBegin_%u", connectorId) < 0) {
+        MOCPP_DBG_ERR("Invalid key");
         (void)0;
     }
-    txBegin = declareConfiguration<int>(key, 0, AO_TXSTORE_META_FN, false, false, true, false);
+    txBegin = declareConfiguration<int>(key, 0, MOCPP_TXSTORE_META_FN, false, false, true, false);
 }
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned int txNr) {
@@ -66,34 +66,34 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
     //cache miss - load tx from flash if existent
     
     if (!filesystem) {
-        AO_DBG_DEBUG("no FS adapter");
+        MOCPP_DBG_DEBUG("no FS adapter");
         return nullptr;
     }
 
-    char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
-    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-        AO_DBG_ERR("fn error: %i", ret);
+    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
+    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+        MOCPP_DBG_ERR("fn error: %i", ret);
         return nullptr;
     }
 
     size_t msize;
     if (filesystem->stat(fn, &msize) != 0) {
-        AO_DBG_DEBUG("%u-%u does not exist", connectorId, txNr);
+        MOCPP_DBG_DEBUG("%u-%u does not exist", connectorId, txNr);
         return nullptr;
     }
 
     auto doc = FilesystemUtils::loadJson(filesystem, fn);
 
     if (!doc) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return nullptr;
     }
 
     auto transaction = std::make_shared<Transaction>(*this, connectorId, txNr);
     JsonObject txJson = doc->as<JsonObject>();
     if (!deserializeTransaction(*transaction, txJson)) {
-        AO_DBG_ERR("deserialization error");
+        MOCPP_DBG_ERR("deserialization error");
         return nullptr;
     }
 
@@ -111,12 +111,12 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
 std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool silent) {
     
     if (!txBegin || *txBegin < 0 || !txEnd || *txEnd < 0) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return nullptr;
     }
 
     //check if maximum number of queued tx already reached
-    if ((*txEnd + MAX_TX_CNT - *txBegin) % MAX_TX_CNT >= AO_TXRECORD_SIZE) {
+    if ((*txEnd + MAX_TX_CNT - *txBegin) % MAX_TX_CNT >= MOCPP_TXRECORD_SIZE) {
         //limit reached
 
         if (!silent) {
@@ -132,7 +132,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool s
     configuration_save();
 
     if (!commit(transaction.get())) {
-        AO_DBG_ERR("FS error");
+        MOCPP_DBG_ERR("FS error");
         return nullptr;
     }
 
@@ -149,7 +149,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool s
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::getLatestTransaction() {
     if (!txEnd || *txEnd < 0) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return nullptr;
     }
 
@@ -161,25 +161,25 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getLatestTransaction() {
 bool ConnectorTransactionStore::commit(Transaction *transaction) {
 
     if (!filesystem) {
-        AO_DBG_DEBUG("no FS: nothing to commit");
+        MOCPP_DBG_DEBUG("no FS: nothing to commit");
         return true;
     }
 
-    char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
-    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-        AO_DBG_ERR("fn error: %i", ret);
+    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
+    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+        MOCPP_DBG_ERR("fn error: %i", ret);
         return false;
     }
     
     DynamicJsonDocument txDoc {0};
     if (!serializeTransaction(*transaction, txDoc)) {
-        AO_DBG_ERR("Serialization error");
+        MOCPP_DBG_ERR("Serialization error");
         return false;
     }
 
     if (!FilesystemUtils::storeJson(filesystem, fn, txDoc)) {
-        AO_DBG_ERR("FS error");
+        MOCPP_DBG_ERR("FS error");
         return false;
     }
 
@@ -190,31 +190,31 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
 bool ConnectorTransactionStore::remove(unsigned int txNr) {
 
     if (!filesystem) {
-        AO_DBG_DEBUG("no FS: nothing to remove");
+        MOCPP_DBG_DEBUG("no FS: nothing to remove");
         return true;
     }
 
-    char fn [AO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, AO_MAX_PATH_SIZE, AO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
-    if (ret < 0 || ret >= AO_MAX_PATH_SIZE) {
-        AO_DBG_ERR("fn error: %i", ret);
+    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
+    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+        MOCPP_DBG_ERR("fn error: %i", ret);
         return false;
     }
 
     size_t msize;
     if (filesystem->stat(fn, &msize) != 0) {
-        AO_DBG_DEBUG("%s already removed", fn);
+        MOCPP_DBG_DEBUG("%s already removed", fn);
         return true;
     }
 
-    AO_DBG_DEBUG("remove %s", fn);
+    MOCPP_DBG_DEBUG("remove %s", fn);
     
     return filesystem->remove(fn);
 }
 
 int ConnectorTransactionStore::getTxBegin() {
     if (!txBegin || *txBegin < 0) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return -1;
     }
 
@@ -223,7 +223,7 @@ int ConnectorTransactionStore::getTxBegin() {
 
 int ConnectorTransactionStore::getTxEnd() {
     if (!txBegin || *txBegin < 0) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return -1;
     }
 
@@ -232,7 +232,7 @@ int ConnectorTransactionStore::getTxEnd() {
 
 void ConnectorTransactionStore::setTxBegin(unsigned int txNr) {
     if (!txBegin || *txBegin < 0) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return;
     }
 
@@ -242,7 +242,7 @@ void ConnectorTransactionStore::setTxBegin(unsigned int txNr) {
 
 void ConnectorTransactionStore::setTxEnd(unsigned int txNr) {
     if (!txBegin || *txBegin < 0 || !txEnd || *txEnd < 0) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return;
     }
 
@@ -252,7 +252,7 @@ void ConnectorTransactionStore::setTxEnd(unsigned int txNr) {
 
 unsigned int ConnectorTransactionStore::size() {
     if (!txBegin || *txBegin < 0 || !txEnd || *txEnd < 0) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return 0;
     }
 
@@ -269,7 +269,7 @@ TransactionStore::TransactionStore(unsigned int nConnectors, std::shared_ptr<Fil
 
 std::shared_ptr<Transaction> TransactionStore::getLatestTransaction(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
+        MOCPP_DBG_ERR("Invalid connectorId");
         return nullptr;
     }
     return connectors[connectorId]->getLatestTransaction();
@@ -277,12 +277,12 @@ std::shared_ptr<Transaction> TransactionStore::getLatestTransaction(unsigned int
 
 bool TransactionStore::commit(Transaction *transaction) {
     if (!transaction) {
-        AO_DBG_ERR("Invalid arg");
+        MOCPP_DBG_ERR("Invalid arg");
         return false;
     }
     auto connectorId = transaction->getConnectorId();
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid tx");
+        MOCPP_DBG_ERR("Invalid tx");
         return false;
     }
     return connectors[connectorId]->commit(transaction);
@@ -290,7 +290,7 @@ bool TransactionStore::commit(Transaction *transaction) {
 
 std::shared_ptr<Transaction> TransactionStore::getTransaction(unsigned int connectorId, unsigned int txNr) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
+        MOCPP_DBG_ERR("Invalid connectorId");
         return nullptr;
     }
     return connectors[connectorId]->getTransaction(txNr);
@@ -298,7 +298,7 @@ std::shared_ptr<Transaction> TransactionStore::getTransaction(unsigned int conne
 
 std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int connectorId, bool silent) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
+        MOCPP_DBG_ERR("Invalid connectorId");
         return nullptr;
     }
     return connectors[connectorId]->createTransaction(silent);
@@ -306,7 +306,7 @@ std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int co
 
 bool TransactionStore::remove(unsigned int connectorId, unsigned int txNr) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
+        MOCPP_DBG_ERR("Invalid connectorId");
         return false;
     }
     return connectors[connectorId]->remove(txNr);
@@ -314,7 +314,7 @@ bool TransactionStore::remove(unsigned int connectorId, unsigned int txNr) {
 
 int TransactionStore::getTxBegin(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
+        MOCPP_DBG_ERR("Invalid connectorId");
         return -1;
     }
     return connectors[connectorId]->getTxBegin();
@@ -322,7 +322,7 @@ int TransactionStore::getTxBegin(unsigned int connectorId) {
 
 int TransactionStore::getTxEnd(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
+        MOCPP_DBG_ERR("Invalid connectorId");
         return -1;
     }
     return connectors[connectorId]->getTxEnd();
@@ -330,7 +330,7 @@ int TransactionStore::getTxEnd(unsigned int connectorId) {
 
 void TransactionStore::setTxBegin(unsigned int connectorId, unsigned int txNr) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
+        MOCPP_DBG_ERR("Invalid connectorId");
         return;
     }
     return connectors[connectorId]->setTxBegin(txNr);
@@ -338,7 +338,7 @@ void TransactionStore::setTxBegin(unsigned int connectorId, unsigned int txNr) {
 
 void TransactionStore::setTxEnd(unsigned int connectorId, unsigned int txNr) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
+        MOCPP_DBG_ERR("Invalid connectorId");
         return;
     }
     return connectors[connectorId]->setTxEnd(txNr);
@@ -346,7 +346,7 @@ void TransactionStore::setTxEnd(unsigned int connectorId, unsigned int txNr) {
 
 unsigned int TransactionStore::size(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        AO_DBG_ERR("Invalid connectorId");
+        MOCPP_DBG_ERR("Invalid connectorId");
         return 0;
     }
     return connectors[connectorId]->size();
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.h b/src/MicroOcpp/Model/Transactions/TransactionStore.h
index 04dfbb11..a83d609d 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.h
@@ -1,22 +1,22 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef TRANSACTIONSTORE_H
 #define TRANSACTIONSTORE_H
 
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <deque>
 
 #define MAX_TX_CNT 100000U
 
-#ifndef AO_TXRECORD_SIZE
-#define AO_TXRECORD_SIZE 4 //no. of tx to hold on flash storage
+#ifndef MOCPP_TXRECORD_SIZE
+#define MOCPP_TXRECORD_SIZE 4 //no. of tx to hold on flash storage
 #endif
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class TransactionStore;
 
diff --git a/src/MicroOcpp/Operations/Authorize.cpp b/src/MicroOcpp/Operations/Authorize.cpp
index 3c848c2b..b367c81e 100644
--- a/src/MicroOcpp/Operations/Authorize.cpp
+++ b/src/MicroOcpp/Operations/Authorize.cpp
@@ -1,20 +1,20 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/Authorize.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Operations/Authorize.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::Authorize;
+using MicroOcpp::Ocpp16::Authorize;
 
 Authorize::Authorize(Model& model, const char *idTagIn) : model(model) {
     if (idTagIn && strnlen(idTagIn, IDTAG_LEN_MAX + 2) <= IDTAG_LEN_MAX) {
         snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
     } else {
-        AO_DBG_WARN("Format violation of idTag. Discard idTag");
+        MOCPP_DBG_WARN("Format violation of idTag. Discard idTag");
         (void)0;
     }
 }
@@ -34,9 +34,9 @@ void Authorize::processConf(JsonObject payload){
     const char *idTagInfo = payload["idTagInfo"]["status"] | "not specified";
 
     if (!strcmp(idTagInfo, "Accepted")) {
-        AO_DBG_INFO("Request has been accepted");
+        MOCPP_DBG_INFO("Request has been accepted");
     } else {
-        AO_DBG_INFO("Request has been denied. Reason: %s", idTagInfo);
+        MOCPP_DBG_INFO("Request has been denied. Reason: %s", idTagInfo);
     }
 
     if (model.getAuthorizationService()) {
diff --git a/src/MicroOcpp/Operations/Authorize.h b/src/MicroOcpp/Operations/Authorize.h
index 335a8412..fb86917e 100644
--- a/src/MicroOcpp/Operations/Authorize.h
+++ b/src/MicroOcpp/Operations/Authorize.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef AUTHORIZE_H
 #define AUTHORIZE_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Operations/CiStrings.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -36,6 +36,6 @@ class Authorize : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Operations/BootNotification.cpp b/src/MicroOcpp/Operations/BootNotification.cpp
index be43b585..41f79575 100644
--- a/src/MicroOcpp/Operations/BootNotification.cpp
+++ b/src/MicroOcpp/Operations/BootNotification.cpp
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/BootNotification.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Boot/BootService.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/BootNotification.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Boot/BootService.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Debug.h>
 
 #include <string.h>
 
-using ArduinoOcpp::Ocpp16::BootNotification;
+using MicroOcpp::Ocpp16::BootNotification;
 
 BootNotification::BootNotification(Model& model, std::unique_ptr<DynamicJsonDocument> payload) : model(model), credentials(std::move(payload)) {
     
@@ -24,7 +24,7 @@ std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
     if (credentials) {
         return std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(*credentials));
     } else {
-        AO_DBG_ERR("payload undefined");
+        MOCPP_DBG_ERR("payload undefined");
         return createEmptyDocument();
     }
 }
@@ -35,12 +35,12 @@ void BootNotification::processConf(JsonObject payload) {
         if (model.getClock().setTime(currentTime)) {
             //success
         } else {
-            AO_DBG_ERR("Time string format violation. Expect format like 2022-02-01T20:53:32.486Z");
+            MOCPP_DBG_ERR("Time string format violation. Expect format like 2022-02-01T20:53:32.486Z");
             errorCode = "PropertyConstraintViolation";
             return;
         }
     } else {
-        AO_DBG_ERR("Missing attribute currentTime");
+        MOCPP_DBG_ERR("Missing attribute currentTime");
         errorCode = "FormationViolation";
         return;
     }
@@ -78,7 +78,7 @@ void BootNotification::processConf(JsonObject payload) {
         bootService->notifyRegistrationStatus(status);
     }
 
-    AO_DBG_INFO("request has been %s", status == RegistrationStatus::Accepted ? "Accepted" :
+    MOCPP_DBG_INFO("request has been %s", status == RegistrationStatus::Accepted ? "Accepted" :
                                        status == RegistrationStatus::Pending ? "replied with Pending" :
                                        "Rejected");
 }
diff --git a/src/MicroOcpp/Operations/BootNotification.h b/src/MicroOcpp/Operations/BootNotification.h
index 57eac862..41acdad1 100644
--- a/src/MicroOcpp/Operations/BootNotification.h
+++ b/src/MicroOcpp/Operations/BootNotification.h
@@ -1,19 +1,19 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef BOOTNOTIFICATION_H
 #define BOOTNOTIFICATION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Operations/CiStrings.h>
 
 #define CP_MODEL_LEN_MAX        CiString20TypeLen
 #define CP_SERIALNUMBER_LEN_MAX CiString25TypeLen
 #define CP_VENDOR_LEN_MAX       CiString20TypeLen
 #define FW_VERSION_LEN_MAX      CiString50TypeLen
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -43,6 +43,6 @@ class BootNotification : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Operations/CancelReservation.cpp b/src/MicroOcpp/Operations/CancelReservation.cpp
index 04433b6f..25088fe7 100644
--- a/src/MicroOcpp/Operations/CancelReservation.cpp
+++ b/src/MicroOcpp/Operations/CancelReservation.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/CancelReservation.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/CancelReservation.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Reservation/ReservationService.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::CancelReservation;
+using MicroOcpp::Ocpp16::CancelReservation;
 
 CancelReservation::CancelReservation(Model& model) : model(model) {
   
diff --git a/src/MicroOcpp/Operations/CancelReservation.h b/src/MicroOcpp/Operations/CancelReservation.h
index bc188792..99b6787e 100644
--- a/src/MicroOcpp/Operations/CancelReservation.h
+++ b/src/MicroOcpp/Operations/CancelReservation.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CANCELRESERVATION_H
 #define CANCELRESERVATION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -31,6 +31,6 @@ class CancelReservation : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.cpp b/src/MicroOcpp/Operations/ChangeAvailability.cpp
index 1e1732b1..7f52bdc0 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.cpp
+++ b/src/MicroOcpp/Operations/ChangeAvailability.cpp
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/ChangeAvailability.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Operations/ChangeAvailability.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
 
 #include <functional>
 
-using ArduinoOcpp::Ocpp16::ChangeAvailability;
+using MicroOcpp::Ocpp16::ChangeAvailability;
 
 ChangeAvailability::ChangeAvailability(Model& model) : model(model) {
 
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.h b/src/MicroOcpp/Operations/ChangeAvailability.h
index 70dc2196..afecdece 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.h
+++ b/src/MicroOcpp/Operations/ChangeAvailability.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CHANGEAVAILABILITY_H
 #define CHANGEAVAILABILITY_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -33,5 +33,5 @@ class ChangeAvailability : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
index aebfa9c3..20b82ef1 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/ChangeConfiguration.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/ChangeConfiguration.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Debug.h>
 
 #include <cmath> //for isnan check
 #include <cctype> //for tolower
 
-using ArduinoOcpp::Ocpp16::ChangeConfiguration;
+using MicroOcpp::Ocpp16::ChangeConfiguration;
 
 ChangeConfiguration::ChangeConfiguration() {
   
@@ -23,13 +23,13 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     const char *key = payload["key"] | "";
     if (strlen(key) < 1) {
         errorCode = "FormationViolation";
-        AO_DBG_WARN("Could not read key");
+        MOCPP_DBG_WARN("Could not read key");
         return;
     }
 
     if (!payload["value"].is<const char *>()) {
         errorCode = "FormationViolation";
-        AO_DBG_WARN("Message is lacking value");
+        MOCPP_DBG_WARN("Message is lacking value");
         return;
     }
 
@@ -44,7 +44,7 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     }
 
     if (!configuration->permissionRemotePeerCanWrite()) {
-        AO_DBG_WARN("Trying to override readonly value");
+        MOCPP_DBG_WARN("Trying to override readonly value");
 
         if (configuration->permissionRemotePeerCanRead()) {
             readOnly = true;
@@ -113,7 +113,7 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     }
 
     if (nDigits > INT_MAXDIGITS) {
-        AO_DBG_DEBUG("Possible integer overflow: key = %s, value = %s", key, value);
+        MOCPP_DBG_DEBUG("Possible integer overflow: key = %s, value = %s", key, value);
         convertibleInt = false;
     }
 
@@ -150,21 +150,21 @@ void ChangeConfiguration::processReq(JsonObject payload) {
         if (validator && !validator(value)) {
             //validator exists and validation fails
             reject = true;
-            AO_DBG_WARN("validation failed for key=%s value=%s", key, value);
+            MOCPP_DBG_WARN("validation failed for key=%s value=%s", key, value);
             return;
         }
 
         *configurationConcrete = value;
     } else {
         reject = true;
-        AO_DBG_WARN("Value has incompatible type");
+        MOCPP_DBG_WARN("Value has incompatible type");
         return;
     }
 
     //success
 
     if (!configuration_save()) {
-        AO_DBG_ERR("could not write changes to flash");
+        MOCPP_DBG_ERR("could not write changes to flash");
         errorCode = "InternalError";
         return;
     }
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.h b/src/MicroOcpp/Operations/ChangeConfiguration.h
index d56b7188..bef65928 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.h
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CHANGECONFIGURATION_H
 #define CHANGECONFIGURATION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 
 class ChangeConfiguration : public Operation {
@@ -32,5 +32,5 @@ class ChangeConfiguration : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/CiStrings.h b/src/MicroOcpp/Operations/CiStrings.h
index cab1ceb4..a963fde6 100644
--- a/src/MicroOcpp/Operations/CiStrings.h
+++ b/src/MicroOcpp/Operations/CiStrings.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
diff --git a/src/MicroOcpp/Operations/ClearCache.cpp b/src/MicroOcpp/Operations/ClearCache.cpp
index a3e8e823..10f0b0e6 100644
--- a/src/MicroOcpp/Operations/ClearCache.cpp
+++ b/src/MicroOcpp/Operations/ClearCache.cpp
@@ -1,12 +1,12 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/ClearCache.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/ClearCache.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::ClearCache;
+using MicroOcpp::Ocpp16::ClearCache;
 
 ClearCache::ClearCache(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
   
@@ -17,7 +17,7 @@ const char* ClearCache::getOperationType(){
 }
 
 void ClearCache::processReq(JsonObject payload) {
-    AO_DBG_WARN("Clear transaction log (Authorization Cache not supported)");
+    MOCPP_DBG_WARN("Clear transaction log (Authorization Cache not supported)");
 
     if (!filesystem) {
         //no persistency - nothing to do
diff --git a/src/MicroOcpp/Operations/ClearCache.h b/src/MicroOcpp/Operations/ClearCache.h
index b0263364..7bcc7e77 100644
--- a/src/MicroOcpp/Operations/ClearCache.h
+++ b/src/MicroOcpp/Operations/ClearCache.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CLEARCACHE_H
 #define CLEARCACHE_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 
 class ClearCache : public Operation {
@@ -26,5 +26,5 @@ class ClearCache : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/ClearChargingProfile.cpp b/src/MicroOcpp/Operations/ClearChargingProfile.cpp
index 38259050..cd6f5bb5 100644
--- a/src/MicroOcpp/Operations/ClearChargingProfile.cpp
+++ b/src/MicroOcpp/Operations/ClearChargingProfile.cpp
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/ClearChargingProfile.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/ClearChargingProfile.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <MicroOcpp/Debug.h>
 
 #include <functional>
 
-using ArduinoOcpp::Ocpp16::ClearChargingProfile;
+using MicroOcpp::Ocpp16::ClearChargingProfile;
 
 ClearChargingProfile::ClearChargingProfile(SmartChargingService& scService) : scService(scService) {
 
diff --git a/src/MicroOcpp/Operations/ClearChargingProfile.h b/src/MicroOcpp/Operations/ClearChargingProfile.h
index 657cc9cb..cd4f9b44 100644
--- a/src/MicroOcpp/Operations/ClearChargingProfile.h
+++ b/src/MicroOcpp/Operations/ClearChargingProfile.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef CLEARCHARGINGPROFILE_H
 #define CLEARCHARGINGPROFILE_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class SmartChargingService;
 
@@ -29,5 +29,5 @@ class ClearChargingProfile : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/CustomOperation.cpp b/src/MicroOcpp/Operations/CustomOperation.cpp
index f600a19d..0ff7080f 100644
--- a/src/MicroOcpp/Operations/CustomOperation.cpp
+++ b/src/MicroOcpp/Operations/CustomOperation.cpp
@@ -1,10 +1,10 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
 
-using ArduinoOcpp::Ocpp16::CustomOperation;
+using MicroOcpp::Ocpp16::CustomOperation;
 
 CustomOperation::CustomOperation(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
diff --git a/src/MicroOcpp/Operations/CustomOperation.h b/src/MicroOcpp/Operations/CustomOperation.h
index fad204a8..e158bb70 100644
--- a/src/MicroOcpp/Operations/CustomOperation.h
+++ b/src/MicroOcpp/Operations/CustomOperation.h
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_CUSTOMOPERATION_H
-#define AO_CUSTOMOPERATION_H
+#ifndef MOCPP_CUSTOMOPERATION_H
+#define MOCPP_CUSTOMOPERATION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
 #include <functional>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 namespace Ocpp16 {
 
@@ -65,5 +65,5 @@ class CustomOperation : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/DataTransfer.cpp b/src/MicroOcpp/Operations/DataTransfer.cpp
index da46e054..5dd0bfd7 100644
--- a/src/MicroOcpp/Operations/DataTransfer.cpp
+++ b/src/MicroOcpp/Operations/DataTransfer.cpp
@@ -1,11 +1,11 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/DataTransfer.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/DataTransfer.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::DataTransfer;
+using MicroOcpp::Ocpp16::DataTransfer;
 
 DataTransfer::DataTransfer(const std::string &msg) {
     this->msg = msg;
@@ -27,8 +27,8 @@ void DataTransfer::processConf(JsonObject payload){
     std::string status = payload["status"] | "Invalid";
 
     if (status == "Accepted") {
-        AO_DBG_DEBUG("Request has been accepted");
+        MOCPP_DBG_DEBUG("Request has been accepted");
     } else {
-        AO_DBG_INFO("Request has been denied");
+        MOCPP_DBG_INFO("Request has been denied");
     }
 }
diff --git a/src/MicroOcpp/Operations/DataTransfer.h b/src/MicroOcpp/Operations/DataTransfer.h
index f7fcaf89..0c9416fd 100644
--- a/src/MicroOcpp/Operations/DataTransfer.h
+++ b/src/MicroOcpp/Operations/DataTransfer.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef DATATRANSFER_H
 #define DATATRANSFER_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 
 class DataTransfer : public Operation {
@@ -25,5 +25,5 @@ class DataTransfer : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
index 51855d2f..c220b6fa 100644
--- a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
+++ b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/DiagnosticsStatusNotification.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
+#include <MicroOcpp/Operations/DiagnosticsStatusNotification.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
 
-using ArduinoOcpp::Ocpp16::DiagnosticsStatusNotification;
+using MicroOcpp::Ocpp16::DiagnosticsStatusNotification;
 
 DiagnosticsStatusNotification::DiagnosticsStatusNotification(DiagnosticsStatus status) : status(status) {
     
diff --git a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
index 87f95368..a13bc36a 100644
--- a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
+++ b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsStatus.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h>
 
 #ifndef DIAGNOSTICSSTATUSNOTIFICATION_H
 #define DIAGNOSTICSSTATUSNOTIFICATION_H
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 
 class DiagnosticsStatusNotification : public Operation {
@@ -27,6 +27,6 @@ class DiagnosticsStatusNotification : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp b/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
index 2ee252a7..20d28a60 100644
--- a/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
+++ b/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/FirmwareStatusNotification.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
+#include <MicroOcpp/Operations/FirmwareStatusNotification.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
 
-using ArduinoOcpp::Ocpp16::FirmwareStatusNotification;
+using MicroOcpp::Ocpp16::FirmwareStatusNotification;
 
 FirmwareStatusNotification::FirmwareStatusNotification(FirmwareStatus status) : status{status} {
 
diff --git a/src/MicroOcpp/Operations/FirmwareStatusNotification.h b/src/MicroOcpp/Operations/FirmwareStatusNotification.h
index 99313946..11c1cadf 100644
--- a/src/MicroOcpp/Operations/FirmwareStatusNotification.h
+++ b/src/MicroOcpp/Operations/FirmwareStatusNotification.h
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareStatus.h>
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h>
 
 #ifndef FIRMWARESTATUSNOTIFICATION_H
 #define FIRMWARESTATUSNOTIFICATION_H
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 
 class FirmwareStatusNotification : public Operation {
@@ -28,6 +28,6 @@ class FirmwareStatusNotification : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Operations/GetCompositeSchedule.cpp b/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
index 11f0771f..40a314ed 100644
--- a/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
+++ b/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/GetCompositeSchedule.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/GetCompositeSchedule.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::GetCompositeSchedule;
+using MicroOcpp::Ocpp16::GetCompositeSchedule;
 
 GetCompositeSchedule::GetCompositeSchedule(Model& model, SmartChargingService& scService) : model(model), scService(scService) {
 
diff --git a/src/MicroOcpp/Operations/GetCompositeSchedule.h b/src/MicroOcpp/Operations/GetCompositeSchedule.h
index 4a4368e0..a54320c7 100644
--- a/src/MicroOcpp/Operations/GetCompositeSchedule.h
+++ b/src/MicroOcpp/Operations/GetCompositeSchedule.h
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef GETCOMPOSITESCHEDULE_H
 #define GETCOMPOSITESCHEDULE_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -37,5 +37,5 @@ class GetCompositeSchedule : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index 3e1dbff8..dc101064 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -1,12 +1,12 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/GetConfiguration.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/GetConfiguration.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::GetConfiguration;
+using MicroOcpp::Ocpp16::GetConfiguration;
 
 GetConfiguration::GetConfiguration() {
 
@@ -62,7 +62,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
     capacity += JSON_ARRAY_SIZE(configurationKeysJson.size())
                 + JSON_ARRAY_SIZE(unknownKeys.size());
     
-    AO_DBG_DEBUG("GetConfiguration capacity: %zu", capacity);
+    MOCPP_DBG_DEBUG("GetConfiguration capacity: %zu", capacity);
     
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
 
@@ -76,7 +76,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
     if (unknownKeys.size() > 0) {
         JsonArray jsonUnknownKey = payload.createNestedArray("unknownKey");
         for (auto unknownKey = unknownKeys.begin(); unknownKey != unknownKeys.end(); unknownKey++) {
-            AO_DBG_DEBUG("Unknown key: %s", unknownKey->c_str())
+            MOCPP_DBG_DEBUG("Unknown key: %s", unknownKey->c_str())
             jsonUnknownKey.add(*unknownKey);
         }
     }
diff --git a/src/MicroOcpp/Operations/GetConfiguration.h b/src/MicroOcpp/Operations/GetConfiguration.h
index 3ac272b4..eb4a63e7 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.h
+++ b/src/MicroOcpp/Operations/GetConfiguration.h
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef GETCONFIGURATION_H
 #define GETCONFIGURATION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
 #include <vector>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 
 class GetConfiguration : public Operation {
@@ -27,5 +27,5 @@ class GetConfiguration : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.cpp b/src/MicroOcpp/Operations/GetDiagnostics.cpp
index a3eaf975..3d317a7b 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.cpp
+++ b/src/MicroOcpp/Operations/GetDiagnostics.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/GetDiagnostics.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Diagnostics/DiagnosticsService.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/GetDiagnostics.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::GetDiagnostics;
+using MicroOcpp::Ocpp16::GetDiagnostics;
 
 GetDiagnostics::GetDiagnostics(Model& model) : model(model) {
 
@@ -24,7 +24,7 @@ void GetDiagnostics::processReq(JsonObject payload) {
     //check location URL. Maybe introduce Same-Origin-Policy?
     if (location.empty()) {
         formatError = true;
-        AO_DBG_WARN("Could not read location. Abort");
+        MOCPP_DBG_WARN("Could not read location. Abort");
         return;
     }
     
@@ -36,7 +36,7 @@ void GetDiagnostics::processReq(JsonObject payload) {
         const char *startTimeRaw = payload["startTime"] | "Invalid";
         if (!startTime.setTime(startTimeRaw)) {
             formatError = true;
-            AO_DBG_WARN("Could not read startTime. Abort");
+            MOCPP_DBG_WARN("Could not read startTime. Abort");
             return;
         }
     }
@@ -46,7 +46,7 @@ void GetDiagnostics::processReq(JsonObject payload) {
         const char *stopTimeRaw = payload["stopTime"] | "Invalid";
         if (!stopTime.setTime(stopTimeRaw)) {
             formatError = true;
-            AO_DBG_WARN("Could not read stopTime. Abort");
+            MOCPP_DBG_WARN("Could not read stopTime. Abort");
             return;
         }
     }
@@ -56,7 +56,7 @@ std::unique_ptr<DynamicJsonDocument> GetDiagnostics::createConf(){
     if (auto diagService = model.getDiagnosticsService()) {
         fileName = diagService->requestDiagnosticsUpload(location, retries, retryInterval, startTime, stopTime);
     } else {
-        AO_DBG_WARN("DiagnosticsService has not been initialized before! Please have a look at ArduinoOcpp.cpp for an example. Abort");
+        MOCPP_DBG_WARN("DiagnosticsService has not been initialized before! Please have a look at MicroOcpp.cpp for an example. Abort");
         return createEmptyDocument();
     }
 
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.h b/src/MicroOcpp/Operations/GetDiagnostics.h
index 66bd7408..beec2974 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.h
+++ b/src/MicroOcpp/Operations/GetDiagnostics.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef GETDIAGNOSTICS_H
 #define GETDIAGNOSTICS_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Time.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -39,6 +39,6 @@ class GetDiagnostics : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.cpp b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
index 037fbf60..7c0a2c67 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.cpp
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/GetLocalListVersion.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/GetLocalListVersion.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::GetLocalListVersion;
+using MicroOcpp::Ocpp16::GetLocalListVersion;
 
 GetLocalListVersion::GetLocalListVersion(Model& model) : model(model) {
   
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.h b/src/MicroOcpp/Operations/GetLocalListVersion.h
index 3e06d13d..08b0c6d3 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.h
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef GETLOCALLISTVERSION_H
 #define GETLOCALLISTVERSION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -27,5 +27,5 @@ class GetLocalListVersion : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/Heartbeat.cpp b/src/MicroOcpp/Operations/Heartbeat.cpp
index dbeb46ce..21f187b0 100644
--- a/src/MicroOcpp/Operations/Heartbeat.cpp
+++ b/src/MicroOcpp/Operations/Heartbeat.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/Heartbeat.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/Heartbeat.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Debug.h>
 #include <string.h>
 
-using ArduinoOcpp::Ocpp16::Heartbeat;
+using MicroOcpp::Ocpp16::Heartbeat;
 
 Heartbeat::Heartbeat(Model& model) : model(model) {
   
@@ -27,12 +27,12 @@ void Heartbeat::processConf(JsonObject payload) {
     if (strcmp(currentTime, "Invalid")) {
         if (model.getClock().setTime(currentTime)) {
             //success
-            AO_DBG_DEBUG("Request has been accepted");
+            MOCPP_DBG_DEBUG("Request has been accepted");
         } else {
-            AO_DBG_WARN("Could not read time string. Expect format like 2020-02-01T20:53:32.486Z");
+            MOCPP_DBG_WARN("Could not read time string. Expect format like 2020-02-01T20:53:32.486Z");
         }
     } else {
-        AO_DBG_WARN("Missing field currentTime. Expect format like 2020-02-01T20:53:32.486Z");
+        MOCPP_DBG_WARN("Missing field currentTime. Expect format like 2020-02-01T20:53:32.486Z");
     }
 }
 
diff --git a/src/MicroOcpp/Operations/Heartbeat.h b/src/MicroOcpp/Operations/Heartbeat.h
index 0cbad4ec..b9fd7e1a 100644
--- a/src/MicroOcpp/Operations/Heartbeat.h
+++ b/src/MicroOcpp/Operations/Heartbeat.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef HEARTBEAT_H
 #define HEARTBEAT_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -31,5 +31,5 @@ class Heartbeat : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/MeterValues.cpp b/src/MicroOcpp/Operations/MeterValues.cpp
index d411da5c..8133ff2a 100644
--- a/src/MicroOcpp/Operations/MeterValues.cpp
+++ b/src/MicroOcpp/Operations/MeterValues.cpp
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/MeterValues.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Metering/MeterValue.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/MeterValues.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Metering/MeterValue.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::MeterValues;
+using MicroOcpp::Ocpp16::MeterValues;
 
 #define ENERGY_METER_TIMEOUT_MS 30 * 1000  //after waiting for 30s, send MeterValues without missing readings
 
@@ -41,7 +41,7 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
             capacity += entry->capacity();
             entries.push_back(std::move(entry));
         } else {
-            AO_DBG_ERR("Energy meter reading not convertible to JSON");
+            MOCPP_DBG_ERR("Energy meter reading not convertible to JSON");
             (void)0;
         }
     }
@@ -66,7 +66,7 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
 }
 
 void MeterValues::processConf(JsonObject payload) {
-    AO_DBG_DEBUG("Request has been confirmed");
+    MOCPP_DBG_DEBUG("Request has been confirmed");
 }
 
 
diff --git a/src/MicroOcpp/Operations/MeterValues.h b/src/MicroOcpp/Operations/MeterValues.h
index bb895ab5..2d785e67 100644
--- a/src/MicroOcpp/Operations/MeterValues.h
+++ b/src/MicroOcpp/Operations/MeterValues.h
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef METERVALUES_H
 #define METERVALUES_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Time.h>
 
 #include <vector>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class MeterValue;
 class Transaction;
@@ -44,5 +44,5 @@ class MeterValues : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
index 67eb0f2a..be294aaa 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 
-#include <ArduinoOcpp/Operations/RemoteStartTransaction.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/RemoteStartTransaction.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::RemoteStartTransaction;
+using MicroOcpp::Ocpp16::RemoteStartTransaction;
 
 RemoteStartTransaction::RemoteStartTransaction(Model& model) : model(model) {
   
@@ -39,7 +39,7 @@ void RemoteStartTransaction::processReq(JsonObject payload) {
     }
 
     if (payload.containsKey("chargingProfile") && model.getSmartChargingService()) {
-        AO_DBG_INFO("Setting Charging profile via RemoteStartTransaction");
+        MOCPP_DBG_INFO("Setting Charging profile via RemoteStartTransaction");
 
         JsonObject chargingProfileJson = payload["chargingProfile"];
         chargingProfile = loadChargingProfile(chargingProfileJson);
@@ -119,7 +119,7 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
             payload["status"] = "Rejected";
         }
     } else {
-        AO_DBG_INFO("No connector to start transaction");
+        MOCPP_DBG_INFO("No connector to start transaction");
         payload["status"] = "Rejected";
     }
     
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.h b/src/MicroOcpp/Operations/RemoteStartTransaction.h
index 4911efb9..73fd6b9e 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef REMOTESTARTTRANSACTION_H
 #define REMOTESTARTTRANSACTION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Operations/CiStrings.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 class ChargingProfile;
@@ -43,5 +43,5 @@ class RemoteStartTransaction : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/RemoteStopTransaction.cpp b/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
index 5e9e3d4b..f73a138d 100644
--- a/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/RemoteStopTransaction.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Operations/RemoteStopTransaction.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
 
-using ArduinoOcpp::Ocpp16::RemoteStopTransaction;
+using MicroOcpp::Ocpp16::RemoteStopTransaction;
 
 RemoteStopTransaction::RemoteStopTransaction(Model& model) : model(model) {
   
diff --git a/src/MicroOcpp/Operations/RemoteStopTransaction.h b/src/MicroOcpp/Operations/RemoteStopTransaction.h
index 48dc83e3..96bd97a3 100644
--- a/src/MicroOcpp/Operations/RemoteStopTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStopTransaction.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef REMOTESTOPTRANSACTION_H
 #define REMOTESTOPTRANSACTION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -28,5 +28,5 @@ class RemoteStopTransaction : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index 3f1cb6ae..ff5811ef 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/ReserveNow.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Reservation/ReservationService.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
-#include <ArduinoOcpp/Platform.h>
+#include <MicroOcpp/Operations/ReserveNow.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Reservation/ReservationService.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Platform.h>
 
-using ArduinoOcpp::Ocpp16::ReserveNow;
+using MicroOcpp::Ocpp16::ReserveNow;
 
 ReserveNow::ReserveNow(Model& model) : model(model) {
   
@@ -35,7 +35,7 @@ void ReserveNow::processReq(JsonObject payload) {
 
     Timestamp validateTimestamp;
     if (!validateTimestamp.setTime(payload["expiryDate"])) {
-        AO_DBG_WARN("bad time format");
+        MOCPP_DBG_WARN("bad time format");
         errorCode = "PropertyConstraintViolation";
         return;
     }
@@ -104,7 +104,7 @@ std::unique_ptr<DynamicJsonDocument> ReserveNow::createConf(){
     if (reservationStatus) {
         payload["status"] = reservationStatus;
     } else {
-        AO_DBG_ERR("didn't set reservationStatus");
+        MOCPP_DBG_ERR("didn't set reservationStatus");
         payload["status"] = "Rejected";
     }
     
diff --git a/src/MicroOcpp/Operations/ReserveNow.h b/src/MicroOcpp/Operations/ReserveNow.h
index bff93718..b3aa5fd0 100644
--- a/src/MicroOcpp/Operations/ReserveNow.h
+++ b/src/MicroOcpp/Operations/ReserveNow.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef RESERVENOW_H
 #define RESERVENOW_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -33,6 +33,6 @@ class ReserveNow : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Operations/Reset.cpp b/src/MicroOcpp/Operations/Reset.cpp
index d217cf99..3c3d78dc 100644
--- a/src/MicroOcpp/Operations/Reset.cpp
+++ b/src/MicroOcpp/Operations/Reset.cpp
@@ -1,12 +1,12 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/Reset.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Operations/Reset.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Reset/ResetService.h>
 
-using ArduinoOcpp::Ocpp16::Reset;
+using MicroOcpp::Ocpp16::Reset;
 
 Reset::Reset(Model& model) : model(model) {
   
@@ -25,7 +25,7 @@ void Reset::processReq(JsonObject payload) {
 
     if (auto rService = model.getResetService()) {
         if (!rService->getExecuteReset()) {
-            AO_DBG_ERR("No reset handler set. Abort operation");
+            MOCPP_DBG_ERR("No reset handler set. Abort operation");
             (void)0;
             //resetAccepted remains false
         } else {
diff --git a/src/MicroOcpp/Operations/Reset.h b/src/MicroOcpp/Operations/Reset.h
index f79cbb11..db55b521 100644
--- a/src/MicroOcpp/Operations/Reset.h
+++ b/src/MicroOcpp/Operations/Reset.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef RESET_H
 #define RESET_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -28,5 +28,5 @@ class Reset : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 46e44b07..8670a4bd 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -1,12 +1,12 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/SendLocalList.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Operations/SendLocalList.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
 
-using ArduinoOcpp::Ocpp16::SendLocalList;
+using MicroOcpp::Ocpp16::SendLocalList;
 
 SendLocalList::SendLocalList(Model& model) : model(model) {
   
@@ -33,7 +33,7 @@ void SendLocalList::processReq(JsonObject payload) {
         return;
     }
 
-    if (payload["localAuthorizationList"].as<JsonArray>().size() > AO_SendLocalListMaxLength) {
+    if (payload["localAuthorizationList"].as<JsonArray>().size() > MOCPP_SendLocalListMaxLength) {
         errorCode = "OccurenceConstraintViolation";
     }
 
diff --git a/src/MicroOcpp/Operations/SendLocalList.h b/src/MicroOcpp/Operations/SendLocalList.h
index be31db31..cb3660ae 100644
--- a/src/MicroOcpp/Operations/SendLocalList.h
+++ b/src/MicroOcpp/Operations/SendLocalList.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef SENDLOCALLIST_H
 #define SENDLOCALLIST_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -34,5 +34,5 @@ class SendLocalList : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/SetChargingProfile.cpp b/src/MicroOcpp/Operations/SetChargingProfile.cpp
index a137d9d6..14b47605 100644
--- a/src/MicroOcpp/Operations/SetChargingProfile.cpp
+++ b/src/MicroOcpp/Operations/SetChargingProfile.cpp
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/SetChargingProfile.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/SetChargingProfile.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::SetChargingProfile;
+using MicroOcpp::Ocpp16::SetChargingProfile;
 
 SetChargingProfile::SetChargingProfile(Model& model, SmartChargingService& scService) : model(model), scService(scService) {
 
diff --git a/src/MicroOcpp/Operations/SetChargingProfile.h b/src/MicroOcpp/Operations/SetChargingProfile.h
index 99bed3a0..2dc84ca4 100644
--- a/src/MicroOcpp/Operations/SetChargingProfile.h
+++ b/src/MicroOcpp/Operations/SetChargingProfile.h
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef SETCHARGINGPROFILE_H
 #define SETCHARGINGPROFILE_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 class SmartChargingService;
@@ -38,5 +38,5 @@ class SetChargingProfile : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/StartTransaction.cpp b/src/MicroOcpp/Operations/StartTransaction.cpp
index 8f1c3547..486b3210 100644
--- a/src/MicroOcpp/Operations/StartTransaction.cpp
+++ b/src/MicroOcpp/Operations/StartTransaction.cpp
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/StartTransaction.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/RequestStore.h>
-#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Model/Metering/MeteringService.h>
-#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/StartTransaction.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/RequestStore.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Model/Metering/MeteringService.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::StartTransaction;
+using MicroOcpp::Ocpp16::StartTransaction;
 
 
 StartTransaction::StartTransaction(Model& model, std::shared_ptr<Transaction> transaction) : model(model), transaction(transaction) {
@@ -28,7 +28,7 @@ const char* StartTransaction::getOperationType() {
 
 void StartTransaction::initiate(StoredOperationHandler *opStore) {
     if (!transaction || transaction->getStartSync().isRequested()) {
-        AO_DBG_ERR("initialization error");
+        MOCPP_DBG_ERR("initialization error");
         return;
     }
     
@@ -45,38 +45,38 @@ void StartTransaction::initiate(StoredOperationHandler *opStore) {
 
     transaction->commit();
 
-    AO_DBG_INFO("StartTransaction initiated");
+    MOCPP_DBG_INFO("StartTransaction initiated");
 }
 
 bool StartTransaction::restore(StoredOperationHandler *opStore) {
     if (!opStore) {
-        AO_DBG_ERR("invalid argument");
+        MOCPP_DBG_ERR("invalid argument");
         return false;
     }
 
     auto payload = opStore->getPayload();
     if (!payload) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return false;
     }
 
     int connectorId = (*payload)["connectorId"] | -1;
     int txNr = (*payload)["txNr"] | -1;
     if (connectorId < 0 || txNr < 0) {
-        AO_DBG_ERR("record incomplete");
+        MOCPP_DBG_ERR("record incomplete");
         return false;
     }
 
     auto txStore = model.getTransactionStore();
 
     if (!txStore) {
-        AO_DBG_ERR("invalid state");
+        MOCPP_DBG_ERR("invalid state");
         return false;
     }
 
     transaction = txStore->getTransaction(connectorId, txNr);
     if (!transaction) {
-        AO_DBG_ERR("referential integrity violation");
+        MOCPP_DBG_ERR("referential integrity violation");
 
         //clean up possible tx records
         if (auto mSerivce = model.getMeteringService()) {
@@ -88,7 +88,7 @@ bool StartTransaction::restore(StoredOperationHandler *opStore) {
     if (transaction->getStartTimestamp() < MIN_TIME &&
             transaction->getStartBootNr() != model.getBootNr()) {
         //time not set, cannot be restored anymore -> invalid tx
-        AO_DBG_ERR("cannot recover tx from previus run");
+        MOCPP_DBG_ERR("cannot recover tx from previus run");
 
         //clean up possible tx records
         if (auto mSerivce = model.getMeteringService()) {
@@ -123,7 +123,7 @@ std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
 
     if (transaction->getStartTimestamp() < MIN_TIME &&
             transaction->getStartBootNr() == model.getBootNr()) {
-        AO_DBG_DEBUG("adjust preboot StartTx timestamp");
+        MOCPP_DBG_DEBUG("adjust preboot StartTx timestamp");
         Timestamp adjusted = model.getClock().adjustPrebootTimestamp(transaction->getStartTimestamp());
         transaction->setStartTimestamp(adjusted);
     }
@@ -139,9 +139,9 @@ void StartTransaction::processConf(JsonObject payload) {
 
     const char* idTagInfoStatus = payload["idTagInfo"]["status"] | "not specified";
     if (!strcmp(idTagInfoStatus, "Accepted")) {
-        AO_DBG_INFO("Request has been accepted");
+        MOCPP_DBG_INFO("Request has been accepted");
     } else {
-        AO_DBG_INFO("Request has been denied. Reason: %s", idTagInfoStatus);
+        MOCPP_DBG_INFO("Request has been denied. Reason: %s", idTagInfoStatus);
         transaction->setIdTagDeauthorized();
     }
 
diff --git a/src/MicroOcpp/Operations/StartTransaction.h b/src/MicroOcpp/Operations/StartTransaction.h
index d742d38b..59c68453 100644
--- a/src/MicroOcpp/Operations/StartTransaction.h
+++ b/src/MicroOcpp/Operations/StartTransaction.h
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef STARTTRANSACTION_H
 #define STARTTRANSACTION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Operations/CiStrings.h>
-#include <ArduinoOcpp/Model/Metering/SampledValue.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Model/Metering/SampledValue.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 class Transaction;
@@ -43,5 +43,5 @@ class StartTransaction : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/StatusNotification.cpp b/src/MicroOcpp/Operations/StatusNotification.cpp
index 1c7979a1..e354700c 100644
--- a/src/MicroOcpp/Operations/StatusNotification.cpp
+++ b/src/MicroOcpp/Operations/StatusNotification.cpp
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/StatusNotification.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Debug.h>
 
 #include <string.h>
 
-using ArduinoOcpp::Ocpp16::StatusNotification;
+using MicroOcpp::Ocpp16::StatusNotification;
 
 //helper function
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 const char *cstrFromOcppEveState(ChargePointStatus state) {
     switch (state) {
@@ -34,7 +34,7 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
         case (ChargePointStatus::Faulted):
             return "Faulted";
         default:
-            AO_DBG_ERR("ChargePointStatus not specified");
+            MOCPP_DBG_ERR("ChargePointStatus not specified");
             (void)0;
             /* fall through */
         case (ChargePointStatus::NOT_SET):
@@ -46,7 +46,7 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
 StatusNotification::StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData)
         : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorData(errorData) {
     
-    AO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
+    MOCPP_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
 }
 
 const char* StatusNotification::getOperationType(){
@@ -73,7 +73,7 @@ std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
             payload["vendorErrorCode"] = errorData.vendorErrorCode;
         }
     } else if (currentStatus == ChargePointStatus::NOT_SET) {
-        AO_DBG_ERR("Reporting undefined status");
+        MOCPP_DBG_ERR("Reporting undefined status");
         payload["errorCode"] = "InternalError";
     } else {
         payload["errorCode"] = "NoError";
diff --git a/src/MicroOcpp/Operations/StatusNotification.h b/src/MicroOcpp/Operations/StatusNotification.h
index 872d0935..cd82e3f8 100644
--- a/src/MicroOcpp/Operations/StatusNotification.h
+++ b/src/MicroOcpp/Operations/StatusNotification.h
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef STATUSNOTIFICATION_H
 #define STATUSNOTIFICATION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Model/ConnectorBase/ChargePointStatus.h>
-#include <ArduinoOcpp/Model/ConnectorBase/ChargePointErrorData.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
+#include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 namespace Ocpp16 {
 
 class StatusNotification : public Operation {
@@ -36,5 +36,5 @@ class StatusNotification : public Operation {
 const char *cstrFromOcppEveState(ChargePointStatus state);
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
index f92a8659..c8c83df9 100644
--- a/src/MicroOcpp/Operations/StopTransaction.cpp
+++ b/src/MicroOcpp/Operations/StopTransaction.cpp
@@ -1,25 +1,25 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/StopTransaction.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/RequestStore.h>
-#include <ArduinoOcpp/Model/Authorization/AuthorizationService.h>
-#include <ArduinoOcpp/Model/Metering/MeteringService.h>
-#include <ArduinoOcpp/Model/Metering/MeterValue.h>
-#include <ArduinoOcpp/Model/Transactions/TransactionStore.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/StopTransaction.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/RequestStore.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Model/Metering/MeteringService.h>
+#include <MicroOcpp/Model/Metering/MeterValue.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::StopTransaction;
+using MicroOcpp::Ocpp16::StopTransaction;
 
 StopTransaction::StopTransaction(Model& model, std::shared_ptr<Transaction> transaction)
         : model(model), transaction(transaction) {
 
 }
 
-StopTransaction::StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData)
+StopTransaction::StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<MicroOcpp::MeterValue>> transactionData)
         : model(model), transaction(transaction), transactionData(std::move(transactionData)) {
 
 }
@@ -30,7 +30,7 @@ const char* StopTransaction::getOperationType() {
 
 void StopTransaction::initiate(StoredOperationHandler *opStore) {
     if (!transaction || transaction->getStopSync().isRequested()) {
-        AO_DBG_ERR("initialization error");
+        MOCPP_DBG_ERR("initialization error");
         return;
     }
     
@@ -47,38 +47,38 @@ void StopTransaction::initiate(StoredOperationHandler *opStore) {
 
     transaction->commit();
 
-    AO_DBG_INFO("StopTransaction initiated");
+    MOCPP_DBG_INFO("StopTransaction initiated");
 }
 
 bool StopTransaction::restore(StoredOperationHandler *opStore) {
     if (!opStore) {
-        AO_DBG_ERR("invalid argument");
+        MOCPP_DBG_ERR("invalid argument");
         return false;
     }
 
     auto payload = opStore->getPayload();
     if (!payload) {
-        AO_DBG_ERR("memory corruption");
+        MOCPP_DBG_ERR("memory corruption");
         return false;
     }
 
     int connectorId = (*payload)["connectorId"] | -1;
     int txNr = (*payload)["txNr"] | -1;
     if (connectorId < 0 || txNr < 0) {
-        AO_DBG_ERR("record incomplete");
+        MOCPP_DBG_ERR("record incomplete");
         return false;
     }
 
     auto txStore = model.getTransactionStore();
 
     if (!txStore) {
-        AO_DBG_ERR("invalid state");
+        MOCPP_DBG_ERR("invalid state");
         return false;
     }
 
     transaction = txStore->getTransaction(connectorId, txNr);
     if (!transaction) {
-        AO_DBG_ERR("referential integrity violation");
+        MOCPP_DBG_ERR("referential integrity violation");
 
         //clean up possible tx records
         if (auto mSerivce = model.getMeteringService()) {
@@ -89,7 +89,7 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
 
     if (transaction->isSilent()) {
         //transaction has been set silent after initializing StopTx - discard operation record
-        AO_DBG_WARN("tx has been set silent - discard StopTx");
+        MOCPP_DBG_WARN("tx has been set silent - discard StopTx");
 
         //clean up possible tx records
         if (auto mSerivce = model.getMeteringService()) {
@@ -119,10 +119,10 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
             Timestamp adjusted = model.getClock().adjustPrebootTimestamp(transaction->getStopTimestamp());
             transaction->setStopTimestamp(adjusted);
         } else if (transaction->getStartTimestamp() >= MIN_TIME) {
-            AO_DBG_WARN("set stopTime = startTime because correct time is not available");
+            MOCPP_DBG_WARN("set stopTime = startTime because correct time is not available");
             transaction->setStopTimestamp(transaction->getStartTimestamp() + 1); //1s behind startTime to keep order in backend DB
         } else {
-            AO_DBG_ERR("failed to determine StopTx timestamp");
+            MOCPP_DBG_ERR("failed to determine StopTx timestamp");
             (void)0; //send invalid value
         }
     }
@@ -194,7 +194,7 @@ void StopTransaction::processConf(JsonObject payload) {
         transaction->commit();
     }
 
-    AO_DBG_INFO("Request has been accepted!");
+    MOCPP_DBG_INFO("Request has been accepted!");
 
     if (auto authService = model.getAuthorizationService()) {
         authService->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
@@ -208,7 +208,7 @@ bool StopTransaction::processErr(const char *code, const char *description, Json
         transaction->commit();
     }
 
-    AO_DBG_ERR("Server error, data loss!");
+    MOCPP_DBG_ERR("Server error, data loss!");
 
     return false;
 }
diff --git a/src/MicroOcpp/Operations/StopTransaction.h b/src/MicroOcpp/Operations/StopTransaction.h
index c88a87d9..49cf7fd5 100644
--- a/src/MicroOcpp/Operations/StopTransaction.h
+++ b/src/MicroOcpp/Operations/StopTransaction.h
@@ -1,16 +1,16 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef STOPTRANSACTION_H
 #define STOPTRANSACTION_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Time.h>
-#include <ArduinoOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Operations/CiStrings.h>
 #include <vector>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -30,7 +30,7 @@ class StopTransaction : public Operation {
 
     StopTransaction(Model& model, std::shared_ptr<Transaction> transaction);
 
-    StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<ArduinoOcpp::MeterValue>> transactionData);
+    StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<MicroOcpp::MeterValue>> transactionData);
 
     const char* getOperationType() override;
 
@@ -50,5 +50,5 @@ class StopTransaction : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
index 84ad0bcf..99cf8ee9 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.cpp
+++ b/src/MicroOcpp/Operations/TriggerMessage.cpp
@@ -1,17 +1,17 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/TriggerMessage.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Connector.h>
-#include <ArduinoOcpp/Model/Metering/MeteringService.h>
-#include <ArduinoOcpp/Operations/StatusNotification.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/TriggerMessage.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Model/Metering/MeteringService.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::TriggerMessage;
+using MicroOcpp::Ocpp16::TriggerMessage;
 
 TriggerMessage::TriggerMessage(Context& context) : context(context) {
 
@@ -26,7 +26,7 @@ void TriggerMessage::processReq(JsonObject payload) {
     const char *requestedMessage = payload["requestedMessage"] | "Invalid";
     const int connectorId = payload["connectorId"] | -1;
 
-    AO_DBG_INFO("Execute for message type %s, connectorId = %i", requestedMessage, connectorId);
+    MOCPP_DBG_INFO("Execute for message type %s, connectorId = %i", requestedMessage, connectorId);
 
     statusMessage = "Rejected";
 
@@ -79,9 +79,9 @@ void TriggerMessage::processReq(JsonObject payload) {
         statusMessage = "Accepted";
     } else {
         if (errorCode) {
-            AO_DBG_ERR("errorCode: %s", errorCode);
+            MOCPP_DBG_ERR("errorCode: %s", errorCode);
         } else {
-            AO_DBG_WARN("TriggerMessage denied. statusMessage: %s", statusMessage);
+            MOCPP_DBG_WARN("TriggerMessage denied. statusMessage: %s", statusMessage);
         }
     }
 
diff --git a/src/MicroOcpp/Operations/TriggerMessage.h b/src/MicroOcpp/Operations/TriggerMessage.h
index ca0b2c87..b8cc8507 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.h
+++ b/src/MicroOcpp/Operations/TriggerMessage.h
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef TRIGGERMESSAGE_H
 #define TRIGGERMESSAGE_H
 
-#include <ArduinoOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Operation.h>
 
 #include <vector>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Context;
 class Request;
@@ -36,5 +36,5 @@ class TriggerMessage : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index 845cdf5a..eb7b002f 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/UnlockConnector.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/UnlockConnector.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::UnlockConnector;
+using MicroOcpp::Ocpp16::UnlockConnector;
 
-#define AO_UNLOCK_TIMEOUT 10000
+#define MOCPP_UNLOCK_TIMEOUT 10000
 
 UnlockConnector::UnlockConnector(Model& model) : model(model) {
   
@@ -36,14 +36,14 @@ void UnlockConnector::processReq(JsonObject payload) {
     if (unlockConnector != nullptr) {
         cbUnlockResult = unlockConnector();
     } else {
-        AO_DBG_WARN("Unlock CB undefined");
+        MOCPP_DBG_WARN("Unlock CB undefined");
     }
 
-    timerStart = ao_tick_ms();
+    timerStart = mocpp_tick_ms();
 }
 
 std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
-    if (!err && ao_tick_ms() - timerStart < AO_UNLOCK_TIMEOUT) {
+    if (!err && mocpp_tick_ms() - timerStart < MOCPP_UNLOCK_TIMEOUT) {
         //do poll and if more time is needed, delay creation of conf msg
 
         if (unlockConnector) {
diff --git a/src/MicroOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
index eeda9a90..9c207a5d 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.h
+++ b/src/MicroOcpp/Operations/UnlockConnector.h
@@ -1,15 +1,15 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef UNLOCKCONNECTOR_H
 #define UNLOCKCONNECTOR_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/PollResult.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/PollResult.h>
 #include <functional>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -33,5 +33,5 @@ class UnlockConnector : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.cpp b/src/MicroOcpp/Operations/UpdateFirmware.cpp
index 9f13b625..cdfba5fd 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.cpp
+++ b/src/MicroOcpp/Operations/UpdateFirmware.cpp
@@ -1,13 +1,13 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Operations/UpdateFirmware.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Model/FirmwareManagement/FirmwareService.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Operations/UpdateFirmware.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
+#include <MicroOcpp/Debug.h>
 
-using ArduinoOcpp::Ocpp16::UpdateFirmware;
+using MicroOcpp::Ocpp16::UpdateFirmware;
 
 UpdateFirmware::UpdateFirmware(Model& model) : model(model) {
 
@@ -24,7 +24,7 @@ void UpdateFirmware::processReq(JsonObject payload) {
     //check location URL. Maybe introduce Same-Origin-Policy?
     if (location.empty()) {
         formatError = true;
-        AO_DBG_WARN("Could not read location. Abort");
+        MOCPP_DBG_WARN("Could not read location. Abort");
         return;
     }
 
@@ -32,7 +32,7 @@ void UpdateFirmware::processReq(JsonObject payload) {
     const char *retrieveDateRaw = payload["retrieveDate"] | "Invalid";
     if (!retreiveDate.setTime(retrieveDateRaw)) {
         formatError = true;
-        AO_DBG_WARN("Could not read retrieveDate. Abort");
+        MOCPP_DBG_WARN("Could not read retrieveDate. Abort");
         return;
     }
     
@@ -44,7 +44,7 @@ std::unique_ptr<DynamicJsonDocument> UpdateFirmware::createConf(){
     if (auto fwService = model.getFirmwareService()) {
         fwService->scheduleFirmwareUpdate(location, retreiveDate, retries, retryInterval);
     } else {
-        AO_DBG_ERR("FirmwareService has not been initialized before! Please have a look at ArduinoOcpp.cpp for an example. Abort");
+        MOCPP_DBG_ERR("FirmwareService has not been initialized before! Please have a look at MicroOcpp.cpp for an example. Abort");
     }
 
     return createEmptyDocument();
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.h b/src/MicroOcpp/Operations/UpdateFirmware.h
index d85b53b8..79b2954b 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.h
+++ b/src/MicroOcpp/Operations/UpdateFirmware.h
@@ -1,14 +1,14 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
 #ifndef UPDATEFIRMWARE_H
 #define UPDATEFIRMWARE_H
 
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Time.h>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 class Model;
 
@@ -35,6 +35,6 @@ class UpdateFirmware : public Operation {
 };
 
 } //end namespace Ocpp16
-} //end namespace ArduinoOcpp
+} //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Platform.cpp b/src/MicroOcpp/Platform.cpp
index 45767710..fa167aad 100644
--- a/src/MicroOcpp/Platform.cpp
+++ b/src/MicroOcpp/Platform.cpp
@@ -1,66 +1,66 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include <ArduinoOcpp/Platform.h>
+#include <MicroOcpp/Platform.h>
 
-#ifdef AO_CUSTOM_CONSOLE
+#ifdef MOCPP_CUSTOM_CONSOLE
 
-namespace ArduinoOcpp {
-void (*ao_console_out_impl)(const char *msg) = nullptr;
+namespace MicroOcpp {
+void (*mocpp_console_out_impl)(const char *msg) = nullptr;
 }
 
-void ArduinoOcpp::ao_console_out(const char *msg) {
-    if (ao_console_out_impl) {
-        ao_console_out_impl(msg);
+void MicroOcpp::mocpp_console_out(const char *msg) {
+    if (mocpp_console_out_impl) {
+        mocpp_console_out_impl(msg);
     }
 }
 
-void ao_set_console_out(void (*console_out)(const char *msg)) {
-    ArduinoOcpp::ao_console_out_impl = console_out;
-    console_out("[AO] console initialized\n");
+void mo_set_console_out(void (*console_out)(const char *msg)) {
+    MicroOcpp::mocpp_console_out_impl = console_out;
+    console_out("[OCPP] console initialized\n");
 }
 
 #endif
 
-#ifdef AO_CUSTOM_TIMER
-unsigned long (*ao_tick_ms_impl)() = nullptr;
+#ifdef MOCPP_CUSTOM_TIMER
+unsigned long (*mocpp_tick_ms_impl)() = nullptr;
 
-void ao_set_timer(unsigned long (*get_ms)()) {
-    ao_tick_ms_impl = get_ms;
+void mocpp_set_timer(unsigned long (*get_ms)()) {
+    mocpp_tick_ms_impl = get_ms;
 }
 
-unsigned long ao_tick_ms_custom() {
-    if (ao_tick_ms_impl) {
-        return ao_tick_ms_impl();
+unsigned long mocpp_tick_ms_custom() {
+    if (mocpp_tick_ms_impl) {
+        return mocpp_tick_ms_impl();
     } else {
         return 0;
     }
 }
 #endif
 
-#if AO_PLATFORM == AO_PLATFORM_UNIX
+#if MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
 #include <chrono>
 
-namespace ArduinoOcpp {
+namespace MicroOcpp {
 
 std::chrono::steady_clock::time_point clock_reference;
 bool clock_initialized = false;
 
 }
 
-unsigned long ao_tick_ms_unix() {
-    if (!ArduinoOcpp::clock_initialized) {
-        ArduinoOcpp::clock_reference = std::chrono::steady_clock::now();
-        ArduinoOcpp::clock_initialized = true;
+unsigned long mocpp_tick_ms_unix() {
+    if (!MicroOcpp::clock_initialized) {
+        MicroOcpp::clock_reference = std::chrono::steady_clock::now();
+        MicroOcpp::clock_initialized = true;
     }
     std::chrono::milliseconds ms = std::chrono::duration_cast<std::chrono::milliseconds>(
-        std::chrono::steady_clock::now() - ArduinoOcpp::clock_reference);
+        std::chrono::steady_clock::now() - MicroOcpp::clock_reference);
     return (unsigned long) ms.count();
 }
 #endif
 
-#if AO_PLATFORM != AO_PLATFORM_ARDUINO
+#if MOCPP_PLATFORM != MOCPP_PLATFORM_ARDUINO
 void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target){
     char fmt[20];
     sprintf(fmt, "%%%d.%df", min_width, num_digits_after_decimal);
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index 1842383e..88a833c4 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -1,9 +1,9 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef AO_PLATFORM_H
-#define AO_PLATFORM_H
+#ifndef MOCPP_PLATFORM_H
+#define MOCPP_PLATFORM_H
 
 #ifdef __cplusplus
 #define EXT_C extern "C"
@@ -11,88 +11,88 @@
 #define EXT_C
 #endif
 
-#define AO_PLATFORM_ARDUINO 0
-#define AO_PLATFORM_ESPIDF  1
-#define AO_PLATFORM_UNIX    2
+#define MOCPP_PLATFORM_ARDUINO 0
+#define MOCPP_PLATFORM_ESPIDF  1
+#define MOCPP_PLATFORM_UNIX    2
 
-#ifndef AO_PLATFORM
-#define AO_PLATFORM AO_PLATFORM_ARDUINO
+#ifndef MOCPP_PLATFORM
+#define MOCPP_PLATFORM MOCPP_PLATFORM_ARDUINO
 #endif
 
-#ifdef AO_CUSTOM_CONSOLE
+#ifdef MOCPP_CUSTOM_CONSOLE
 #include <cstdio>
 
-#ifndef AO_CUSTOM_CONSOLE_MAXMSGSIZE
-#define AO_CUSTOM_CONSOLE_MAXMSGSIZE 196
+#ifndef MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE
+#define MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE 196
 #endif
 
-void ao_set_console_out(void (*console_out)(const char *msg));
+void mo_set_console_out(void (*console_out)(const char *msg));
 
-namespace ArduinoOcpp {
-void ao_console_out(const char *msg);
+namespace MicroOcpp {
+void mocpp_console_out(const char *msg);
 }
-#define AO_CONSOLE_PRINTF(X, ...) \
+#define MOCPP_CONSOLE_PRINTF(X, ...) \
             do { \
-                char msg [AO_CUSTOM_CONSOLE_MAXMSGSIZE]; \
-                if (snprintf(msg, AO_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__) < 0) { \
-                    sprintf(msg + AO_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
+                char msg [MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE]; \
+                if (snprintf(msg, MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__) < 0) { \
+                    sprintf(msg + MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
                 } \
-                ArduinoOcpp::ao_console_out(msg); \
+                MicroOcpp::mocpp_console_out(msg); \
             } while (0)
 #else
-#define ao_set_console_out(X) \
+#define mo_set_console_out(X) \
             do { \
-                X("[AO] CONSOLE ERROR: ao_set_console_out ignored if AO_CUSTOM_CONSOLE " \
+                X("[OCPP] CONSOLE ERROR: mo_set_console_out ignored if MOCPP_CUSTOM_CONSOLE " \
                   "not defined\n"); \
                 char msg [196]; \
                 snprintf(msg, 196, "     > see %s:%i",__FILE__,__LINE__); \
                 X(msg); \
-                X("\n     > see ArduinoOcpp/Platform.h\n"); \
+                X("\n     > see MicroOcpp/Platform.h\n"); \
             } while (0)
 
-#if AO_PLATFORM == AO_PLATFORM_ARDUINO
+#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO
 #include <Arduino.h>
-#ifndef AO_USE_SERIAL
-#define AO_USE_SERIAL Serial
+#ifndef MOCPP_USE_SERIAL
+#define MOCPP_USE_SERIAL Serial
 #endif
 
-#define AO_CONSOLE_PRINTF(X, ...) AO_USE_SERIAL.printf_P(PSTR(X), ##__VA_ARGS__)
-#elif AO_PLATFORM == AO_PLATFORM_ESPIDF || AO_PLATFORM == AO_PLATFORM_UNIX
+#define MOCPP_CONSOLE_PRINTF(X, ...) MOCPP_USE_SERIAL.printf_P(PSTR(X), ##__VA_ARGS__)
+#elif MOCPP_PLATFORM == MOCPP_PLATFORM_ESPIDF || MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
 #include <stdio.h>
 
-#define AO_CONSOLE_PRINTF(X, ...) printf(X, ##__VA_ARGS__)
+#define MOCPP_CONSOLE_PRINTF(X, ...) printf(X, ##__VA_ARGS__)
 #endif
 #endif
 
-#ifdef AO_CUSTOM_TIMER
-void ao_set_timer(unsigned long (*get_ms)());
+#ifdef MOCPP_CUSTOM_TIMER
+void mocpp_set_timer(unsigned long (*get_ms)());
 
-unsigned long ao_tick_ms_custom();
-#define ao_tick_ms ao_tick_ms_custom
+unsigned long mocpp_tick_ms_custom();
+#define mocpp_tick_ms mocpp_tick_ms_custom
 #else
 
-#if AO_PLATFORM == AO_PLATFORM_ARDUINO
+#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO
 #include <Arduino.h>
-#define ao_tick_ms millis
-#elif AO_PLATFORM == AO_PLATFORM_ESPIDF
+#define mocpp_tick_ms millis
+#elif MOCPP_PLATFORM == MOCPP_PLATFORM_ESPIDF
 #include "freertos/FreeRTOS.h"
 #include "freertos/task.h"
-#define ao_tick_ms(X) ((xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ)
-#elif AO_PLATFORM == AO_PLATFORM_UNIX
-unsigned long ao_tick_ms_unix();
-#define ao_tick_ms ao_tick_ms_unix
+#define mocpp_tick_ms(X) ((xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ)
+#elif MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
+unsigned long mocpp_tick_ms_unix();
+#define mocpp_tick_ms mocpp_tick_ms_unix
 #endif
 #endif
 
-#ifndef AO_MAX_JSON_CAPACITY
-#if AO_PLATFORM == AO_PLATFORM_UNIX
-#define AO_MAX_JSON_CAPACITY 16384
+#ifndef MOCPP_MAX_JSON_CAPACITY
+#if MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
+#define MOCPP_MAX_JSON_CAPACITY 16384
 #else
-#define AO_MAX_JSON_CAPACITY 4096
+#define MOCPP_MAX_JSON_CAPACITY 4096
 #endif
 #endif
 
-#if AO_PLATFORM != AO_PLATFORM_ARDUINO
+#if MOCPP_PLATFORM != MOCPP_PLATFORM_ARDUINO
 void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target);
 #endif
 
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 3a19ea86..87a9e2bf 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -1,51 +1,51 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#include "ArduinoOcpp_c.h"
-#include "ArduinoOcpp.h"
+#include "MicroOcpp_c.h"
+#include "MicroOcpp.h"
 
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp/Debug.h>
 
-ArduinoOcpp::Connection *ocppSocket = nullptr;
+MicroOcpp::Connection *ocppSocket = nullptr;
 
-void ao_initialize(AO_Connection *conn, const char *chargePointModel, const char *chargePointVendor, struct AO_FilesystemOpt fsopt) {
-    ao_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt);
+void ocpp_initialize(OCPP_Connection *conn, const char *chargePointModel, const char *chargePointVendor, struct OCPP_FilesystemOpt fsopt) {
+    ocpp_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt);
 }
 
-void ao_initialize_full(AO_Connection *conn, const char *bootNotificationCredentials, struct AO_FilesystemOpt fsopt) {
+void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt) {
     if (!conn) {
-        AO_DBG_ERR("conn is null");
+        MOCPP_DBG_ERR("conn is null");
     }
 
-    ocppSocket = reinterpret_cast<ArduinoOcpp::Connection*>(conn);
+    ocppSocket = reinterpret_cast<MicroOcpp::Connection*>(conn);
 
-    ArduinoOcpp::FilesystemOpt adaptFsopt = fsopt;
+    MicroOcpp::FilesystemOpt adaptFsopt = fsopt;
 
-    ocpp_initialize(*ocppSocket, bootNotificationCredentials, ArduinoOcpp::makeDefaultFilesystemAdapter(adaptFsopt));
+    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt));
 }
 
-void ao_deinitialize() {
-    ocpp_deinitialize();
+void ocpp_deinitialize() {
+    mocpp_deinitialize();
 }
 
-void ao_loop() {
-    ocpp_loop();
+void ocpp_loop() {
+    mocpp_loop();
 }
 
 /*
  * Helper functions for transforming callback functions from C-style to C++style
  */
 
-ArduinoOcpp::PollResult<bool> adaptScl(enum OptionalBool v) {
+MicroOcpp::PollResult<bool> adaptScl(enum OptionalBool v) {
     if (v == OptionalTrue) {
         return true;
     } else if (v == OptionalFalse) {
         return false;
     } else if (v == OptionalNone) {
-        return ArduinoOcpp::PollResult<bool>::Await();
+        return MicroOcpp::PollResult<bool>::Await();
     } else {
-        AO_DBG_ERR("illegal argument");
+        MOCPP_DBG_ERR("illegal argument");
         return false;
     }
 }
@@ -102,254 +102,254 @@ std::function<void(void)> adaptFn(void (*fn)(void)) {
     return fn;
 }
 
-#ifndef AO_RECEIVE_PAYLOAD_BUFSIZE
-#define AO_RECEIVE_PAYLOAD_BUFSIZE 512
+#ifndef MOCPP_RECEIVE_PAYLOAD_BUFSIZE
+#define MOCPP_RECEIVE_PAYLOAD_BUFSIZE 512
 #endif
 
-char ao_recv_payload_buff [AO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
+char ocpp_recv_payload_buff [MOCPP_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
 
 std::function<void(JsonObject)> adaptFn(OnMessage fn) {
     if (!fn) return nullptr;
     return [fn] (JsonObject payload) {
-        auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+        auto len = serializeJson(payload, ocpp_recv_payload_buff, MOCPP_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
-            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+            MOCPP_DBG_WARN("Received payload buffer exceeded. Continue without payload");
         }
-        fn(len > 0 ? ao_recv_payload_buff : "", len);
+        fn(len > 0 ? ocpp_recv_payload_buff : "", len);
     };
 }
 
-ArduinoOcpp::OnReceiveErrorListener adaptFn(OnCallError fn) {
+MicroOcpp::OnReceiveErrorListener adaptFn(OnCallError fn) {
     if (!fn) return nullptr;
     return [fn] (const char *code, const char *description, JsonObject details) {
-        auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
+        auto len = serializeJson(details, ocpp_recv_payload_buff, MOCPP_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
-            AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+            MOCPP_DBG_WARN("Received payload buffer exceeded. Continue without payload");
         }
-        fn(code, description, len > 0 ? ao_recv_payload_buff : "", len);
+        fn(code, description, len > 0 ? ocpp_recv_payload_buff : "", len);
     };
 }
 
-std::function<ArduinoOcpp::PollResult<bool>()> adaptFn(PollBool fn) {
+std::function<MicroOcpp::PollResult<bool>()> adaptFn(PollBool fn) {
     return [fn] () {return adaptScl(fn());};
 }
 
-std::function<ArduinoOcpp::PollResult<bool>()> adaptFn(unsigned int connectorId, PollBool_m fn) {
+std::function<MicroOcpp::PollResult<bool>()> adaptFn(unsigned int connectorId, PollBool_m fn) {
     return [fn, connectorId] () {return adaptScl(fn(connectorId));};
 }
 
-void ao_beginTransaction(const char *idTag) {
+void ocpp_beginTransaction(const char *idTag) {
     beginTransaction(idTag);
 }
-void ao_beginTransaction_m(unsigned int connectorId, const char *idTag) {
+void ocpp_beginTransaction_m(unsigned int connectorId, const char *idTag) {
     beginTransaction(idTag, connectorId);
 }
 
-void ao_beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
+void ocpp_beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
     beginTransaction_authorized(idTag, parentIdTag);
 }
-void ao_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag) {
+void ocpp_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag) {
     beginTransaction_authorized(idTag, parentIdTag, connectorId);
 }
 
-bool ao_endTransaction(const char *idTag, const char *reason) {
+bool ocpp_endTransaction(const char *idTag, const char *reason) {
     return endTransaction(idTag, reason);
 }
-bool ao_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason) {
+bool ocpp_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason) {
     return endTransaction(idTag, reason, connectorId);
 }
 
-bool ao_isTransactionActive() {
+bool ocpp_isTransactionActive() {
     return isTransactionActive();
 }
-bool ao_isTransactionActive_m(unsigned int connectorId) {
+bool ocpp_isTransactionActive_m(unsigned int connectorId) {
     return isTransactionActive(connectorId);
 }
 
-bool ao_isTransactionRunning() {
+bool ocpp_isTransactionRunning() {
     return isTransactionRunning();
 }
-bool ao_isTransactionRunning_m(unsigned int connectorId) {
+bool ocpp_isTransactionRunning_m(unsigned int connectorId) {
     return isTransactionRunning(connectorId);
 }
 
-const char *ao_getTransactionIdTag() {
+const char *ocpp_getTransactionIdTag() {
     return getTransactionIdTag();
 }
-const char *ao_getTransactionIdTag_m(unsigned int connectorId) {
+const char *ocpp_getTransactionIdTag_m(unsigned int connectorId) {
     return getTransactionIdTag(connectorId);
 }
 
-AO_Transaction *ao_getTransaction() {
-    return ao_getTransaction_m(1);
+OCPP_Transaction *ocpp_getTransaction() {
+    return ocpp_getTransaction_m(1);
 }
-AO_Transaction *ao_getTransaction_m(unsigned int connectorId) {
+OCPP_Transaction *ocpp_getTransaction_m(unsigned int connectorId) {
     if (getTransaction(connectorId)) {
-        return reinterpret_cast<AO_Transaction*>(getTransaction(connectorId).get());
+        return reinterpret_cast<OCPP_Transaction*>(getTransaction(connectorId).get());
     } else {
         return NULL;
     }
 }
 
-bool ao_ocppPermitsCharge() {
+bool ocpp_ocppPermitsCharge() {
     return ocppPermitsCharge();
 }
-bool ao_ocppPermitsCharge_m(unsigned int connectorId) {
+bool ocpp_ocppPermitsCharge_m(unsigned int connectorId) {
     return ocppPermitsCharge(connectorId);
 }
 
-void ao_setConnectorPluggedInput(InputBool pluggedInput) {
+void ocpp_setConnectorPluggedInput(InputBool pluggedInput) {
     setConnectorPluggedInput(adaptFn(pluggedInput));
 }
-void ao_setConnectorPluggedInput_m(unsigned int connectorId, InputBool_m pluggedInput) {
+void ocpp_setConnectorPluggedInput_m(unsigned int connectorId, InputBool_m pluggedInput) {
     setConnectorPluggedInput(adaptFn(connectorId, pluggedInput), connectorId);
 }
 
-void ao_setEnergyMeterInput(InputInt energyInput) {
+void ocpp_setEnergyMeterInput(InputInt energyInput) {
     setEnergyMeterInput(adaptFn(energyInput));
 }
-void ao_setEnergyMeterInput_m(unsigned int connectorId, InputInt_m energyInput) {
+void ocpp_setEnergyMeterInput_m(unsigned int connectorId, InputInt_m energyInput) {
     setEnergyMeterInput(adaptFn(connectorId, energyInput), connectorId);
 }
 
-void ao_setPowerMeterInput(InputFloat powerInput) {
+void ocpp_setPowerMeterInput(InputFloat powerInput) {
     setPowerMeterInput(adaptFn(powerInput));
 }
-void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat_m powerInput) {
+void ocpp_setPowerMeterInput_m(unsigned int connectorId, InputFloat_m powerInput) {
     setPowerMeterInput(adaptFn(connectorId, powerInput), connectorId);
 }
 
-void ao_setSmartChargingPowerOutput(OutputFloat maxPowerOutput) {
+void ocpp_setSmartChargingPowerOutput(OutputFloat maxPowerOutput) {
     setSmartChargingPowerOutput(adaptFn(maxPowerOutput));
 }
-void ao_setSmartChargingPowerOutput_m(unsigned int connectorId, OutputFloat_m maxPowerOutput) {
+void ocpp_setSmartChargingPowerOutput_m(unsigned int connectorId, OutputFloat_m maxPowerOutput) {
     setSmartChargingPowerOutput(adaptFn(connectorId, maxPowerOutput), connectorId);
 }
-void ao_setSmartChargingCurrentOutput(OutputFloat maxCurrentOutput) {
+void ocpp_setSmartChargingCurrentOutput(OutputFloat maxCurrentOutput) {
     setSmartChargingCurrentOutput(adaptFn(maxCurrentOutput));
 }
-void ao_setSmartChargingCurrentOutput_m(unsigned int connectorId, OutputFloat_m maxCurrentOutput) {
+void ocpp_setSmartChargingCurrentOutput_m(unsigned int connectorId, OutputFloat_m maxCurrentOutput) {
     setSmartChargingCurrentOutput(adaptFn(connectorId, maxCurrentOutput), connectorId);
 }
-void ao_setSmartChargingOutput(OutputSmartCharging chargingLimitOutput) {
+void ocpp_setSmartChargingOutput(OutputSmartCharging chargingLimitOutput) {
     setSmartChargingOutput(adaptFn(chargingLimitOutput));
 }
-void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputSmartCharging_m chargingLimitOutput) {
+void ocpp_setSmartChargingOutput_m(unsigned int connectorId, OutputSmartCharging_m chargingLimitOutput) {
     setSmartChargingOutput(adaptFn(connectorId, chargingLimitOutput), connectorId);
 }
 
-void ao_setEvReadyInput(InputBool evReadyInput) {
+void ocpp_setEvReadyInput(InputBool evReadyInput) {
     setEvReadyInput(adaptFn(evReadyInput));
 }
-void ao_setEvReadyInput_m(unsigned int connectorId, InputBool_m evReadyInput) {
+void ocpp_setEvReadyInput_m(unsigned int connectorId, InputBool_m evReadyInput) {
     setEvReadyInput(adaptFn(connectorId, evReadyInput), connectorId);
 }
 
-void ao_setEvseReadyInput(InputBool evseReadyInput) {
+void ocpp_setEvseReadyInput(InputBool evseReadyInput) {
     setEvseReadyInput(adaptFn(evseReadyInput));
 }
-void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput) {
+void ocpp_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput) {
     setEvseReadyInput(adaptFn(connectorId, evseReadyInput), connectorId);
 }
 
-void ao_addErrorCodeInput(InputString errorCodeInput) {
+void ocpp_addErrorCodeInput(InputString errorCodeInput) {
     addErrorCodeInput(adaptFn(errorCodeInput));
 }
-void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput) {
+void ocpp_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput) {
     addErrorCodeInput(adaptFn(connectorId, errorCodeInput), connectorId);
 }
 
-void ao_addMeterValueInputFloat(InputFloat valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
+void ocpp_addMeterValueInputFloat(InputFloat valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
     addMeterValueInput(adaptFn(valueInput), measurand, unit, location, phase, 1);
 }
-void ao_addMeterValueInputFloat_m(unsigned int connectorId, InputFloat_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
+void ocpp_addMeterValueInputFloat_m(unsigned int connectorId, InputFloat_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase) {
     addMeterValueInput(adaptFn(connectorId, valueInput), measurand, unit, location, phase, connectorId);
 }
 
-void ao_addMeterValueInput(MeterValueInput *meterValueInput) {
-    ao_addMeterValueInput_m(1, meterValueInput);
+void ocpp_addMeterValueInput(MeterValueInput *meterValueInput) {
+    ocpp_addMeterValueInput_m(1, meterValueInput);
 }
-void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput) {
-    auto svs = std::unique_ptr<ArduinoOcpp::SampledValueSampler>(
-        reinterpret_cast<ArduinoOcpp::SampledValueSampler*>(meterValueInput));
+void ocpp_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput) {
+    auto svs = std::unique_ptr<MicroOcpp::SampledValueSampler>(
+        reinterpret_cast<MicroOcpp::SampledValueSampler*>(meterValueInput));
     
     addMeterValueInput(std::move(svs), connectorId);
 }
 
-void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut) {
+void ocpp_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut) {
     setOnUnlockConnectorInOut(adaptFn(onUnlockConnectorInOut));
 }
-void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut) {
+void ocpp_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut) {
     setOnUnlockConnectorInOut(adaptFn(connectorId, onUnlockConnectorInOut), connectorId);
 }
 
-void ao_setStartTxReadyInput(InputBool startTxReady) {
+void ocpp_setStartTxReadyInput(InputBool startTxReady) {
     setStartTxReadyInput(adaptFn(startTxReady));
 }
-void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxReady) {
+void ocpp_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxReady) {
     setStartTxReadyInput(adaptFn(connectorId, startTxReady), connectorId);
 }
 
-void ao_setStopTxReadyInput(InputBool stopTxReady) {
+void ocpp_setStopTxReadyInput(InputBool stopTxReady) {
     setStopTxReadyInput(adaptFn(stopTxReady));
 }
-void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady) {
+void ocpp_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady) {
     setStopTxReadyInput(adaptFn(connectorId, stopTxReady), connectorId);
 }
 
-void ao_setTxNotificationOutput(void (*notificationOutput)(AO_Transaction*, enum AO_TxNotification)) {
-    setTxNotificationOutput([notificationOutput] (ArduinoOcpp::Transaction *tx, ArduinoOcpp::TxNotification notification) {
-        notificationOutput(reinterpret_cast<AO_Transaction*>(tx), convertTxNotification(notification));
+void ocpp_setTxNotificationOutput(void (*notificationOutput)(OCPP_Transaction*, enum OCPP_TxNotification)) {
+    setTxNotificationOutput([notificationOutput] (MicroOcpp::Transaction *tx, MicroOcpp::TxNotification notification) {
+        notificationOutput(reinterpret_cast<OCPP_Transaction*>(tx), convertTxNotification(notification));
     });
 }
-void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AO_Transaction*, enum AO_TxNotification)) {
-    setTxNotificationOutput([notificationOutput, connectorId] (ArduinoOcpp::Transaction *tx, ArduinoOcpp::TxNotification notification) {
-        notificationOutput(connectorId, reinterpret_cast<AO_Transaction*>(tx), convertTxNotification(notification));
+void ocpp_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, OCPP_Transaction*, enum OCPP_TxNotification)) {
+    setTxNotificationOutput([notificationOutput, connectorId] (MicroOcpp::Transaction *tx, MicroOcpp::TxNotification notification) {
+        notificationOutput(connectorId, reinterpret_cast<OCPP_Transaction*>(tx), convertTxNotification(notification));
     }, connectorId);
 }
 
-void ao_setOccupiedInput(InputBool occupied) {
+void ocpp_setOccupiedInput(InputBool occupied) {
     setOccupiedInput(adaptFn(occupied));
 }
-void ao_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied) {
+void ocpp_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied) {
     setOccupiedInput(adaptFn(connectorId, occupied), connectorId);
 }
 
-bool ao_isOperative() {
+bool ocpp_isOperative() {
     return isOperative();
 }
-bool ao_isOperative_m(unsigned int connectorId) {
+bool ocpp_isOperative_m(unsigned int connectorId) {
     return isOperative(connectorId);
 }
-void ao_setOnResetNotify(bool (*onResetNotify)(bool)) {
+void ocpp_setOnResetNotify(bool (*onResetNotify)(bool)) {
     setOnResetNotify([onResetNotify] (bool isHard) {return onResetNotify(isHard);});
 }
 
-void ao_setOnResetExecute(void (*onResetExecute)(bool)) {
+void ocpp_setOnResetExecute(void (*onResetExecute)(bool)) {
     setOnResetExecute([onResetExecute] (bool isHard) {onResetExecute(isHard);});
 }
 
-void ao_setOnReceiveRequest(const char *operationType, OnMessage onRequest) {
+void ocpp_setOnReceiveRequest(const char *operationType, OnMessage onRequest) {
     setOnReceiveRequest(operationType, adaptFn(onRequest));
 }
 
-void ao_setOnSendConf(const char *operationType, OnMessage onConfirmation) {
+void ocpp_setOnSendConf(const char *operationType, OnMessage onConfirmation) {
     setOnSendConf(operationType, adaptFn(onConfirmation));
 }
 
-void ao_set_console_out_c(void (*console_out)(const char *msg)) {
-    ao_set_console_out(console_out);
+void ocpp_set_console_out_c(void (*console_out)(const char *msg)) {
+    mo_set_console_out(console_out);
 }
 
-void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
+void ocpp_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
     
     std::string idTag_capture = idTag;
 
     authorize(idTag,
             onConfirmation ? [onConfirmation, idTag_capture, user_data] (JsonObject payload) {
-                    auto len = serializeJson(payload, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
-                    if (len <= 0) {AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
-                    onConfirmation(idTag_capture.c_str(), len > 0 ? ao_recv_payload_buff : "", len, user_data);
+                    auto len = serializeJson(payload, ocpp_recv_payload_buff, MOCPP_RECEIVE_PAYLOAD_BUFSIZE);
+                    if (len <= 0) {MOCPP_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
+                    onConfirmation(idTag_capture.c_str(), len > 0 ? ocpp_recv_payload_buff : "", len, user_data);
                 } : OnReceiveConfListener(nullptr),
             onAbort ? [onAbort, idTag_capture, user_data] () -> void {
                     onAbort(idTag_capture.c_str(), user_data);
@@ -358,16 +358,16 @@ void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, Autho
                     onTimeout(idTag_capture.c_str(), user_data);
                 } : OnTimeoutListener(nullptr),
             onError ? [onError, idTag_capture, user_data] (const char *code, const char *description, JsonObject details) {
-                    auto len = serializeJson(details, ao_recv_payload_buff, AO_RECEIVE_PAYLOAD_BUFSIZE);
-                    if (len <= 0) {AO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
-                    onError(idTag_capture.c_str(), code, description, len > 0 ? ao_recv_payload_buff : "", len, user_data);
+                    auto len = serializeJson(details, ocpp_recv_payload_buff, MOCPP_RECEIVE_PAYLOAD_BUFSIZE);
+                    if (len <= 0) {MOCPP_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
+                    onError(idTag_capture.c_str(), code, description, len > 0 ? ocpp_recv_payload_buff : "", len, user_data);
                 } : OnReceiveErrorListener(nullptr));
 }
 
-void ao_startTransaction(const char *idTag, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
+void ocpp_startTransaction(const char *idTag, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
     startTransaction(idTag, adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
 
-void ao_stopTransaction(OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
+void ocpp_stopTransaction(OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError) {
     stopTransaction(adaptFn(onConfirmation), adaptFn(onAbort), adaptFn(onTimeout), adaptFn(onError));
 }
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index 1672d7e3..6c1969e2 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -1,4 +1,4 @@
-// matth-x/ArduinoOcpp
+// matth-x/MicroOcpp
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
@@ -7,12 +7,12 @@
 
 #include <stddef.h>
 
-#include <ArduinoOcpp/Core/ConfigurationOptions.h>
-#include <ArduinoOcpp/Model/ConnectorBase/Notification.h>
-#include <ArduinoOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/ConfigurationOptions.h>
+#include <MicroOcpp/Model/ConnectorBase/Notification.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
 
-struct AO_Connection;
-typedef struct AO_Connection AO_Connection;
+struct OCPP_Connection;
+typedef struct OCPP_Connection OCPP_Connection;
 
 struct MeterValueInput;
 typedef struct MeterValueInput MeterValueInput;
@@ -48,137 +48,137 @@ extern "C" {
 #endif
 
 /*
- * Please refer to ArduinoOcpp.h for the documentation
+ * Please refer to MicroOcpp.h for the documentation
  */
 
-void ao_initialize(
-            AO_Connection *conn,  //WebSocket adapter for ArduinoOcpp
+void ocpp_initialize(
+            OCPP_Connection *conn,  //WebSocket adapter for MicroOcpp
             const char *chargePointModel,     //model name of this charger (e.g. "")
             const char *chargePointVendor, //brand name
-            struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            struct OCPP_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 //same as above, but more fields for the BootNotification
-void ao_initialize_full(
-            AO_Connection *conn,  //WebSocket adapter for ArduinoOcpp
+void ocpp_initialize_full(
+            OCPP_Connection *conn,  //WebSocket adapter for MicroOcpp
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
-            struct AO_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            struct OCPP_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
 
 
-void ao_deinitialize();
+void ocpp_deinitialize();
 
-void ao_loop();
+void ocpp_loop();
 
 /*
  * Charging session management
  */
 
-void ao_beginTransaction(const char *idTag);
-void ao_beginTransaction_m(unsigned int connectorId, const char *idTag); //multiple connectors version
+void ocpp_beginTransaction(const char *idTag);
+void ocpp_beginTransaction_m(unsigned int connectorId, const char *idTag); //multiple connectors version
 
-void ao_beginTransaction_authorized(const char *idTag, const char *parentIdTag);
-void ao_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag);
+void ocpp_beginTransaction_authorized(const char *idTag, const char *parentIdTag);
+void ocpp_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag);
 
-bool ao_endTransaction(const char *idTag, const char *reason); //idTag, reason can be NULL
-bool ao_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason); //idTag, reason can be NULL
+bool ocpp_endTransaction(const char *idTag, const char *reason); //idTag, reason can be NULL
+bool ocpp_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason); //idTag, reason can be NULL
 
-bool ao_isTransactionActive();
-bool ao_isTransactionActive_m(unsigned int connectorId);
+bool ocpp_isTransactionActive();
+bool ocpp_isTransactionActive_m(unsigned int connectorId);
 
-bool ao_isTransactionRunning();
-bool ao_isTransactionRunning_m(unsigned int connectorId);
+bool ocpp_isTransactionRunning();
+bool ocpp_isTransactionRunning_m(unsigned int connectorId);
 
-const char *ao_getTransactionIdTag();
-const char *ao_getTransactionIdTag_m(unsigned int connectorId);
+const char *ocpp_getTransactionIdTag();
+const char *ocpp_getTransactionIdTag_m(unsigned int connectorId);
 
-AO_Transaction *ao_getTransaction();
-AO_Transaction *ao_getTransaction_m(unsigned int connectorId);
+OCPP_Transaction *ocpp_getTransaction();
+OCPP_Transaction *ocpp_getTransaction_m(unsigned int connectorId);
 
-bool ao_ocppPermitsCharge();
-bool ao_ocppPermitsCharge_m(unsigned int connectorId);
+bool ocpp_ocppPermitsCharge();
+bool ocpp_ocppPermitsCharge_m(unsigned int connectorId);
 
 /*
  * Define the Inputs and Outputs of this library.
  */
 
-void ao_setConnectorPluggedInput(InputBool pluggedInput);
-void ao_setConnectorPluggedInput_m(unsigned int connectorId, InputBool_m pluggedInput);
+void ocpp_setConnectorPluggedInput(InputBool pluggedInput);
+void ocpp_setConnectorPluggedInput_m(unsigned int connectorId, InputBool_m pluggedInput);
 
-void ao_setEnergyMeterInput(InputInt energyInput);
-void ao_setEnergyMeterInput_m(unsigned int connectorId, InputInt_m energyInput);
+void ocpp_setEnergyMeterInput(InputInt energyInput);
+void ocpp_setEnergyMeterInput_m(unsigned int connectorId, InputInt_m energyInput);
 
-void ao_setPowerMeterInput(InputFloat powerInput);
-void ao_setPowerMeterInput_m(unsigned int connectorId, InputFloat_m powerInput);
+void ocpp_setPowerMeterInput(InputFloat powerInput);
+void ocpp_setPowerMeterInput_m(unsigned int connectorId, InputFloat_m powerInput);
 
-void ao_setSmartChargingPowerOutput(OutputFloat maxPowerOutput);
-void ao_setSmartChargingPowerOutput_m(unsigned int connectorId, OutputFloat_m maxPowerOutput);
-void ao_setSmartChargingCurrentOutput(OutputFloat maxCurrentOutput);
-void ao_setSmartChargingCurrentOutput_m(unsigned int connectorId, OutputFloat_m maxCurrentOutput);
-void ao_setSmartChargingOutput(OutputSmartCharging chargingLimitOutput);
-void ao_setSmartChargingOutput_m(unsigned int connectorId, OutputSmartCharging_m chargingLimitOutput);
+void ocpp_setSmartChargingPowerOutput(OutputFloat maxPowerOutput);
+void ocpp_setSmartChargingPowerOutput_m(unsigned int connectorId, OutputFloat_m maxPowerOutput);
+void ocpp_setSmartChargingCurrentOutput(OutputFloat maxCurrentOutput);
+void ocpp_setSmartChargingCurrentOutput_m(unsigned int connectorId, OutputFloat_m maxCurrentOutput);
+void ocpp_setSmartChargingOutput(OutputSmartCharging chargingLimitOutput);
+void ocpp_setSmartChargingOutput_m(unsigned int connectorId, OutputSmartCharging_m chargingLimitOutput);
 
 /*
  * Define the Inputs and Outputs of this library. (Advanced)
  */
 
-void ao_setEvReadyInput(InputBool evReadyInput);
-void ao_setEvReadyInput_m(unsigned int connectorId, InputBool_m evReadyInput);
+void ocpp_setEvReadyInput(InputBool evReadyInput);
+void ocpp_setEvReadyInput_m(unsigned int connectorId, InputBool_m evReadyInput);
 
-void ao_setEvseReadyInput(InputBool evseReadyInput);
-void ao_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput);
+void ocpp_setEvseReadyInput(InputBool evseReadyInput);
+void ocpp_setEvseReadyInput_m(unsigned int connectorId, InputBool_m evseReadyInput);
 
-void ao_addErrorCodeInput(InputString errorCodeInput);
-void ao_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput);
+void ocpp_addErrorCodeInput(InputString errorCodeInput);
+void ocpp_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeInput);
 
-void ao_addMeterValueInputFloat(InputFloat valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
-void ao_addMeterValueInputFloat_m(unsigned int connectorId, InputFloat_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
+void ocpp_addMeterValueInputFloat(InputFloat valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
+void ocpp_addMeterValueInputFloat_m(unsigned int connectorId, InputFloat_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
 
-void ao_addMeterValueInput(MeterValueInput *meterValueInput); //takes ownership of meterValueInput
-void ao_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput); //takes ownership of meterValueInput
+void ocpp_addMeterValueInput(MeterValueInput *meterValueInput); //takes ownership of meterValueInput
+void ocpp_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 
-void ao_setOccupiedInput(InputBool occupied);
-void ao_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied);
+void ocpp_setOccupiedInput(InputBool occupied);
+void ocpp_setOccupiedInput_m(unsigned int connectorId, InputBool_m occupied);
 
-void ao_setStartTxReadyInput(InputBool startTxReady);
-void ao_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxReady);
+void ocpp_setStartTxReadyInput(InputBool startTxReady);
+void ocpp_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxReady);
 
-void ao_setStopTxReadyInput(InputBool stopTxReady);
-void ao_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady);
+void ocpp_setStopTxReadyInput(InputBool stopTxReady);
+void ocpp_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady);
 
-void ao_setTxNotificationOutput(void (*notificationOutput)(AO_Transaction*, enum AO_TxNotification));
-void ao_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, AO_Transaction*, enum AO_TxNotification));
+void ocpp_setTxNotificationOutput(void (*notificationOutput)(OCPP_Transaction*, enum OCPP_TxNotification));
+void ocpp_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, OCPP_Transaction*, enum OCPP_TxNotification));
 
-void ao_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
-void ao_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);
+void ocpp_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
+void ocpp_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);
 
 /*
  * Access further information about the internal state of the library
  */
 
-bool ao_isOperative();
-bool ao_isOperative_m(unsigned int connectorId);
+bool ocpp_isOperative();
+bool ocpp_isOperative_m(unsigned int connectorId);
 
-void ao_setOnResetNotify(bool (*onResetNotify)(bool));
+void ocpp_setOnResetNotify(bool (*onResetNotify)(bool));
 
-void ao_setOnResetExecute(void (*onResetExecute)(bool));
+void ocpp_setOnResetExecute(void (*onResetExecute)(bool));
 
-void ao_setOnReceiveRequest(const char *operationType, OnMessage onRequest);
+void ocpp_setOnReceiveRequest(const char *operationType, OnMessage onRequest);
 
-void ao_setOnSendConf(const char *operationType, OnMessage onConfirmation);
+void ocpp_setOnSendConf(const char *operationType, OnMessage onConfirmation);
 
 /*
- * If build flag AO_CUSTOM_CONSOLE is set, all console output will be forwarded to the print
+ * If build flag MOCPP_CUSTOM_CONSOLE is set, all console output will be forwarded to the print
  * function given by this setter. The parameter msg will also by null-terminated c-strings.
  */
-void ao_set_console_out_c(void (*console_out)(const char *msg));
+void ocpp_set_console_out_c(void (*console_out)(const char *msg));
 
 /*
  * Send OCPP operations
  */
-void ao_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data);
+void ocpp_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data);
 
-void ao_startTransaction(const char *idTag, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
+void ocpp_startTransaction(const char *idTag, OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
 
-void ao_stopTransaction(OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
+void ocpp_stopTransaction(OnMessage onConfirmation, OnAbort onAbort, OnTimeout onTimeout, OnCallError onError);
 
 #ifdef __cplusplus
 }
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 6675689a..c1985076 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -1,9 +1,9 @@
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
@@ -13,13 +13,13 @@
 TEST_CASE( "C++ API test" ) {
 
     //initialize Context with dummy socket
-    ArduinoOcpp::LoopbackConnection loopback;
-    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+    MicroOcpp::LoopbackConnection loopback;
+    mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto context = getOcppContext();
     auto& model = context->getModel();
 
-    ao_set_timer(custom_timer_cb);
+    mocpp_set_timer(custom_timer_cb);
 
     model.getClock().setTime(BASE_TIME);
 
@@ -40,22 +40,22 @@ TEST_CASE( "C++ API test" ) {
         setEvReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setEvseReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         addErrorCodeInput([c = &checkpoints[ncheck++]] () -> const char* {*c = true; return nullptr;});
-        addErrorDataInput([c = &checkpoints[ncheck++]] () -> ArduinoOcpp::ErrorData {*c = true; return nullptr;});
+        addErrorDataInput([c = &checkpoints[ncheck++]] () -> MicroOcpp::ErrorData {*c = true; return nullptr;});
         addMeterValueInput([c = &checkpoints[ncheck++]] () -> float {*c = true; return 0.f;}, "Current.Import");
 
-        ArduinoOcpp::SampledValueProperties svprops;
+        MicroOcpp::SampledValueProperties svprops;
         svprops.setMeasurand("Current.Offered");
-        auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
-                                        new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
+        auto valueSampler = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>>(
+                                        new MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>(
                     svprops,
-                    [c = &checkpoints[ncheck++]] (ArduinoOcpp::ReadingContext) -> int32_t {*c = true; return 0;}));
+                    [c = &checkpoints[ncheck++]] (MicroOcpp::ReadingContext) -> int32_t {*c = true; return 0;}));
         addMeterValueInput(std::move(valueSampler));
 
         setOccupiedInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return false;});
         setStartTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setStopTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
-        setTxNotificationOutput([c = &checkpoints[ncheck++]] (ArduinoOcpp::Transaction*, ArduinoOcpp::TxNotification) {*c = true;});
-        setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> ArduinoOcpp::PollResult<bool> {*c = true; return true;});
+        setTxNotificationOutput([c = &checkpoints[ncheck++]] (MicroOcpp::Transaction*, MicroOcpp::TxNotification) {*c = true;});
+        setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> MicroOcpp::PollResult<bool> {*c = true; return true;});
 
         setOnResetNotify([c = &checkpoints[ncheck++]] (bool) -> bool {*c = true; return true;});
         setOnResetExecute([c = &checkpoints[ncheck++]] (bool) {*c = true;});
@@ -81,7 +81,7 @@ TEST_CASE( "C++ API test" ) {
 
         //set configuration which uses all Inputs and Outputs
 
-        auto MeterValuesSampledData = ArduinoOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        auto MeterValuesSampledData = MicroOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
         *MeterValuesSampledData = "Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered";
 
         std::string out = SCPROFILE;
@@ -89,7 +89,7 @@ TEST_CASE( "C++ API test" ) {
 
         //run tx management
 
-        ocpp_loop();
+        mocpp_loop();
 
         loop();
 
@@ -153,12 +153,12 @@ TEST_CASE( "C++ API test" ) {
 
         loop();
         
-        AO_DBG_DEBUG("added %zu checkpoints", ncheck);
+        MOCPP_DBG_DEBUG("added %zu checkpoints", ncheck);
 
         bool checkpointsPassed = true;
         for (unsigned int i = 0; i < ncheck; i++) {
             if (!checkpoints[i]) {
-                AO_DBG_ERR("missed checkpoint %u", i);
+                MOCPP_DBG_ERR("missed checkpoint %u", i);
                 checkpointsPassed = false;
             }
         }
@@ -166,13 +166,13 @@ TEST_CASE( "C++ API test" ) {
         REQUIRE(checkpointsPassed);
     }
 
-    ocpp_deinitialize();
+    mocpp_deinitialize();
 
     REQUIRE(!getOcppContext());
 }
 
-#include <ArduinoOcpp_c.h>
-#include <ArduinoOcpp/Core/ConfigurationOptions.h>
+#include <MicroOcpp_c.h>
+#include <MicroOcpp/Core/ConfigurationOptions.h>
 
 std::array<bool, 1024> checkpointsc {false};
 size_t ncheckc = 0;
@@ -180,80 +180,80 @@ size_t ncheckc = 0;
 TEST_CASE( "C API test" ) {
 
     //initialize Context with dummy socket
-    struct AO_FilesystemOpt fsopt;
+    struct OCPP_FilesystemOpt fsopt;
     fsopt.use = true;
     fsopt.mount = true;
     fsopt.formatFsOnFail = true;
 
-    ArduinoOcpp::LoopbackConnection loopback;
-    ao_initialize(reinterpret_cast<AO_Connection*>(&loopback), "test-runner1234", "vendor", fsopt);
+    MicroOcpp::LoopbackConnection loopback;
+    ocpp_initialize(reinterpret_cast<OCPP_Connection*>(&loopback), "test-runner1234", "vendor", fsopt);
     
     auto context = getOcppContext();
     auto& model = context->getModel();
 
-    ao_set_timer(custom_timer_cb);
+    mocpp_set_timer(custom_timer_cb);
 
     model.getClock().setTime(BASE_TIME);
 
-    ao_endTransaction(NULL, NULL);
+    ocpp_endTransaction(NULL, NULL);
 
     SECTION("Run all functions") {
 
-        ao_setConnectorPluggedInput([] () -> bool {checkpointsc[0] = true; return true;}); ncheckc++;
-        ao_setConnectorPluggedInput_m(2, [] (unsigned int) -> bool {checkpointsc[1] = true; return true;}); ncheckc++;
-        ao_setEnergyMeterInput([] () -> int {checkpointsc[2] = true; return 0;}); ncheckc++;
-        ao_setEnergyMeterInput_m(2, [] (unsigned int) -> int {checkpointsc[3] = true; return 0;}); ncheckc++;
-        ao_setPowerMeterInput([] () -> float {checkpointsc[4] = true; return 0.f;}); ncheckc++;
-        ao_setPowerMeterInput_m(2, [] (unsigned int) -> float {checkpointsc[5] = true; return 0.f;}); ncheckc++;
-        ao_setSmartChargingPowerOutput([] (float) {}); //overridden by CurrentOutput
-        ao_setSmartChargingPowerOutput_m(2, [] (unsigned int, float) {}); //overridden by CurrentOutput
-        ao_setSmartChargingCurrentOutput([] (float) {}); //overridden by generic SmartChargingOutput
-        ao_setSmartChargingCurrentOutput_m(2, [] (unsigned int, float) {}); //overridden by generic SmartChargingOutput
-        ao_setSmartChargingOutput([] (float, float, int) {checkpointsc[6] = true;}); ncheckc++;
-        ao_setSmartChargingOutput_m(2, [] (unsigned int, float, float, int) {checkpointsc[7] = true;}); ncheckc++;
-        ao_setEvReadyInput([] () -> bool {checkpointsc[8] = true; return true;}); ncheckc++;
-        ao_setEvReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[9] = true; return true;}); ncheckc++;
-        ao_setEvseReadyInput([] () -> bool {checkpointsc[10] = true; return true;}); ncheckc++;
-        ao_setEvseReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[11] = true; return true;}); ncheckc++;
-        ao_addErrorCodeInput([] () -> const char* {checkpointsc[12] = true; return nullptr;}); ncheckc++;
-        ao_addErrorCodeInput_m(2, [] (unsigned int) -> const char* {checkpointsc[13] = true; return nullptr;}); ncheckc++;
-        ao_addMeterValueInputFloat([] () -> float {checkpointsc[14] = true; return 0.f;}, "Current.Import", "A", NULL, NULL); ncheckc++;
-        ao_addMeterValueInputFloat_m(2, [] (unsigned int) -> float {checkpointsc[15] = true; return 0.f;}, "Current.Import", "A", NULL, NULL); ncheckc++;
+        ocpp_setConnectorPluggedInput([] () -> bool {checkpointsc[0] = true; return true;}); ncheckc++;
+        ocpp_setConnectorPluggedInput_m(2, [] (unsigned int) -> bool {checkpointsc[1] = true; return true;}); ncheckc++;
+        ocpp_setEnergyMeterInput([] () -> int {checkpointsc[2] = true; return 0;}); ncheckc++;
+        ocpp_setEnergyMeterInput_m(2, [] (unsigned int) -> int {checkpointsc[3] = true; return 0;}); ncheckc++;
+        ocpp_setPowerMeterInput([] () -> float {checkpointsc[4] = true; return 0.f;}); ncheckc++;
+        ocpp_setPowerMeterInput_m(2, [] (unsigned int) -> float {checkpointsc[5] = true; return 0.f;}); ncheckc++;
+        ocpp_setSmartChargingPowerOutput([] (float) {}); //overridden by CurrentOutput
+        ocpp_setSmartChargingPowerOutput_m(2, [] (unsigned int, float) {}); //overridden by CurrentOutput
+        ocpp_setSmartChargingCurrentOutput([] (float) {}); //overridden by generic SmartChargingOutput
+        ocpp_setSmartChargingCurrentOutput_m(2, [] (unsigned int, float) {}); //overridden by generic SmartChargingOutput
+        ocpp_setSmartChargingOutput([] (float, float, int) {checkpointsc[6] = true;}); ncheckc++;
+        ocpp_setSmartChargingOutput_m(2, [] (unsigned int, float, float, int) {checkpointsc[7] = true;}); ncheckc++;
+        ocpp_setEvReadyInput([] () -> bool {checkpointsc[8] = true; return true;}); ncheckc++;
+        ocpp_setEvReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[9] = true; return true;}); ncheckc++;
+        ocpp_setEvseReadyInput([] () -> bool {checkpointsc[10] = true; return true;}); ncheckc++;
+        ocpp_setEvseReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[11] = true; return true;}); ncheckc++;
+        ocpp_addErrorCodeInput([] () -> const char* {checkpointsc[12] = true; return nullptr;}); ncheckc++;
+        ocpp_addErrorCodeInput_m(2, [] (unsigned int) -> const char* {checkpointsc[13] = true; return nullptr;}); ncheckc++;
+        ocpp_addMeterValueInputFloat([] () -> float {checkpointsc[14] = true; return 0.f;}, "Current.Import", "A", NULL, NULL); ncheckc++;
+        ocpp_addMeterValueInputFloat_m(2, [] (unsigned int) -> float {checkpointsc[15] = true; return 0.f;}, "Current.Import", "A", NULL, NULL); ncheckc++;
         
-        ArduinoOcpp::SampledValueProperties svprops;
+        MicroOcpp::SampledValueProperties svprops;
         svprops.setMeasurand("Current.Offered");
-        auto valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
-                                        new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
+        auto valueSampler = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>>(
+                                        new MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>(
                     svprops,
-                    [] (ArduinoOcpp::ReadingContext) -> int32_t {checkpointsc[16] = true; return 0;})); ncheckc++;
-        ao_addMeterValueInput(reinterpret_cast<MeterValueInput*>(valueSampler.release()));
+                    [] (MicroOcpp::ReadingContext) -> int32_t {checkpointsc[16] = true; return 0;})); ncheckc++;
+        ocpp_addMeterValueInput(reinterpret_cast<MeterValueInput*>(valueSampler.release()));
 
-        valueSampler = std::unique_ptr<ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>>(
-                                        new ArduinoOcpp::SampledValueSamplerConcrete<int32_t, ArduinoOcpp::SampledValueDeSerializer<int32_t>>(
+        valueSampler = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>>(
+                                        new MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>(
                     svprops,
-                    [] (ArduinoOcpp::ReadingContext) -> int32_t {checkpointsc[17] = true; return 0;})); ncheckc++;
-        ao_addMeterValueInput_m(2, reinterpret_cast<MeterValueInput*>(valueSampler.release()));
-
-        ao_setOccupiedInput([] () -> bool {checkpointsc[18] = true; return true;}); ncheckc++;
-        ao_setOccupiedInput_m(2, [] (unsigned int) -> bool {checkpointsc[19] = true; return true;}); ncheckc++;
-        ao_setStartTxReadyInput([] () -> bool {checkpointsc[20] = true; return true;}); ncheckc++;
-        ao_setStartTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[21] = true; return true;}); ncheckc++;
-        ao_setStopTxReadyInput([] () -> bool {checkpointsc[22] = true; return true;}); ncheckc++;
-        ao_setStopTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[23] = true; return true;}); ncheckc++;
-        ao_setTxNotificationOutput([] (AO_Transaction*, AO_TxNotification) {checkpointsc[24] = true;}); ncheckc++;
-        ao_setTxNotificationOutput_m(2, [] (unsigned int, AO_Transaction*, AO_TxNotification) {checkpointsc[25] = true;}); ncheckc++;
-        ao_setOnUnlockConnectorInOut([] () -> OptionalBool {checkpointsc[26] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
-        ao_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> OptionalBool {checkpointsc[27] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
-
-        ao_setOnResetNotify([] (bool) -> bool {checkpointsc[28] = true; return true;}); ncheckc++;
-        ao_setOnResetExecute([] (bool) {checkpointsc[29] = true;}); ncheckc++;
-
-        ao_setOnReceiveRequest("StatusNotification", [] (const char*,size_t) {checkpointsc[30] = true;}); ncheckc++;
-        ao_setOnSendConf("StatusNotification", [] (const char*,size_t) {checkpointsc[31] = true;}); ncheckc++;
+                    [] (MicroOcpp::ReadingContext) -> int32_t {checkpointsc[17] = true; return 0;})); ncheckc++;
+        ocpp_addMeterValueInput_m(2, reinterpret_cast<MeterValueInput*>(valueSampler.release()));
+
+        ocpp_setOccupiedInput([] () -> bool {checkpointsc[18] = true; return true;}); ncheckc++;
+        ocpp_setOccupiedInput_m(2, [] (unsigned int) -> bool {checkpointsc[19] = true; return true;}); ncheckc++;
+        ocpp_setStartTxReadyInput([] () -> bool {checkpointsc[20] = true; return true;}); ncheckc++;
+        ocpp_setStartTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[21] = true; return true;}); ncheckc++;
+        ocpp_setStopTxReadyInput([] () -> bool {checkpointsc[22] = true; return true;}); ncheckc++;
+        ocpp_setStopTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[23] = true; return true;}); ncheckc++;
+        ocpp_setTxNotificationOutput([] (OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[24] = true;}); ncheckc++;
+        ocpp_setTxNotificationOutput_m(2, [] (unsigned int, OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[25] = true;}); ncheckc++;
+        ocpp_setOnUnlockConnectorInOut([] () -> OptionalBool {checkpointsc[26] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
+        ocpp_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> OptionalBool {checkpointsc[27] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
+
+        ocpp_setOnResetNotify([] (bool) -> bool {checkpointsc[28] = true; return true;}); ncheckc++;
+        ocpp_setOnResetExecute([] (bool) {checkpointsc[29] = true;}); ncheckc++;
+
+        ocpp_setOnReceiveRequest("StatusNotification", [] (const char*,size_t) {checkpointsc[30] = true;}); ncheckc++;
+        ocpp_setOnSendConf("StatusNotification", [] (const char*,size_t) {checkpointsc[31] = true;}); ncheckc++;
 
         //set configuration which uses all Inputs and Outputs
 
-        auto MeterValuesSampledData = ArduinoOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        auto MeterValuesSampledData = MicroOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
         *MeterValuesSampledData = "Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered";
 
         std::string out = SCPROFILE;
@@ -261,33 +261,33 @@ TEST_CASE( "C API test" ) {
 
         //run tx management
 
-        ao_loop();
+        ocpp_loop();
 
         loop();
 
-        ao_beginTransaction("mIdTag");
-        ao_beginTransaction_m(2, "mIdTag");
+        ocpp_beginTransaction("mIdTag");
+        ocpp_beginTransaction_m(2, "mIdTag");
 
         loop();
 
-        REQUIRE(ao_isTransactionActive());
-        REQUIRE(ao_isTransactionActive_m(2));
-        REQUIRE(ao_isTransactionRunning());
-        REQUIRE(ao_isTransactionRunning_m(2));
-        REQUIRE(ao_getTransactionIdTag() != nullptr);
-        REQUIRE(ao_getTransactionIdTag_m(2) != nullptr);
-        REQUIRE(ao_getTransaction() != nullptr);
-        REQUIRE(ao_getTransaction_m(2) != nullptr);
-        REQUIRE(ao_ocppPermitsCharge());
-        REQUIRE(ao_ocppPermitsCharge_m(2));
+        REQUIRE(ocpp_isTransactionActive());
+        REQUIRE(ocpp_isTransactionActive_m(2));
+        REQUIRE(ocpp_isTransactionRunning());
+        REQUIRE(ocpp_isTransactionRunning_m(2));
+        REQUIRE(ocpp_getTransactionIdTag() != nullptr);
+        REQUIRE(ocpp_getTransactionIdTag_m(2) != nullptr);
+        REQUIRE(ocpp_getTransaction() != nullptr);
+        REQUIRE(ocpp_getTransaction_m(2) != nullptr);
+        REQUIRE(ocpp_ocppPermitsCharge());
+        REQUIRE(ocpp_ocppPermitsCharge_m(2));
 
-        ao_endTransaction(NULL, NULL);
-        ao_endTransaction_m(2, NULL, NULL);
+        ocpp_endTransaction(NULL, NULL);
+        ocpp_endTransaction_m(2, NULL, NULL);
 
         loop();
 
-        ao_beginTransaction_authorized("mIdTag", NULL);
-        ao_beginTransaction_authorized_m(2, "mIdTag", NULL);
+        ocpp_beginTransaction_authorized("mIdTag", NULL);
+        ocpp_beginTransaction_authorized_m(2, "mIdTag", NULL);
 
         loop();
 
@@ -295,28 +295,28 @@ TEST_CASE( "C API test" ) {
 
         loop();
 
-        ao_endTransaction(NULL, NULL);
-        ao_endTransaction_m(2, NULL, NULL);
+        ocpp_endTransaction(NULL, NULL);
+        ocpp_endTransaction_m(2, NULL, NULL);
 
         loop();
 
-        ao_authorize("mIdTag", [] (const char*,const char*,size_t,void*) {checkpointsc[32] = true;}, NULL, NULL, NULL, NULL); ncheckc++;
-        ao_startTransaction("mIdTag", [] (const char*,size_t) {checkpointsc[33] = true;}, NULL, NULL, NULL); ncheckc++;
+        ocpp_authorize("mIdTag", [] (const char*,const char*,size_t,void*) {checkpointsc[32] = true;}, NULL, NULL, NULL, NULL); ncheckc++;
+        ocpp_startTransaction("mIdTag", [] (const char*,size_t) {checkpointsc[33] = true;}, NULL, NULL, NULL); ncheckc++;
 
         loop();
 
-        ao_stopTransaction([] (const char*,size_t) {checkpointsc[34] = true;}, NULL, NULL, NULL); ncheckc++;
+        ocpp_stopTransaction([] (const char*,size_t) {checkpointsc[34] = true;}, NULL, NULL, NULL); ncheckc++;
 
         //occupied Input will be validated when vehiclePlugged is false or undefined
-        ao_setConnectorPluggedInput([] () {return false;});
-        ao_setConnectorPluggedInput_m(2,[] (unsigned int) {return false;});
+        ocpp_setConnectorPluggedInput([] () {return false;});
+        ocpp_setConnectorPluggedInput_m(2,[] (unsigned int) {return false;});
 
         loop();
 
         //run device management
 
-        REQUIRE(ao_isOperative());
-        REQUIRE(ao_isOperative_m(2));
+        REQUIRE(ocpp_isOperative());
+        REQUIRE(ocpp_isOperative_m(2));
 
         sendRequest("UnlockConnector", [] () {
             auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
@@ -341,12 +341,12 @@ TEST_CASE( "C API test" ) {
 
         loop();
         
-        AO_DBG_DEBUG("added %zu checkpoints", ncheckc);
+        MOCPP_DBG_DEBUG("added %zu checkpoints", ncheckc);
 
         bool checkpointsPassed = true;
         for (unsigned int i = 0; i < ncheckc; i++) {
             if (!checkpointsc[i]) {
-                AO_DBG_ERR("missed checkpoint %u", i);
+                MOCPP_DBG_ERR("missed checkpoint %u", i);
                 checkpointsPassed = false;
             }
         }
@@ -354,7 +354,7 @@ TEST_CASE( "C API test" ) {
         REQUIRE(checkpointsPassed);
     }
 
-    ao_deinitialize();
+    ocpp_deinitialize();
 
     REQUIRE(!getOcppContext());
 }
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 25a6637b..cc51a45a 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -1,30 +1,30 @@
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Operations/BootNotification.h>
-#include <ArduinoOcpp/Operations/StatusNotification.h>
-#include <ArduinoOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Operations/BootNotification.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 
 TEST_CASE( "Charging sessions" ) {
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+    mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto engine = getOcppContext();
     auto& checkMsg = engine->getOperationRegistry();
 
-    ao_set_timer(custom_timer_cb);
+    mocpp_set_timer(custom_timer_cb);
 
     auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN);
         *connectionTimeOut = 30;
@@ -177,12 +177,12 @@ TEST_CASE( "Charging sessions" ) {
     }
 
     SECTION("Preboot transactions - tx before BootNotification") {
-        ocpp_deinitialize();
+        mocpp_deinitialize();
 
         loopback.setConnected(false);
-        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         loop();
@@ -238,12 +238,12 @@ TEST_CASE( "Charging sessions" ) {
 
     SECTION("Preboot transactions - lose StartTx timestamp") {
 
-        ocpp_deinitialize();
+        mocpp_deinitialize();
 
         loopback.setConnected(false);
-        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         loop();
@@ -253,11 +253,11 @@ TEST_CASE( "Charging sessions" ) {
 
         REQUIRE(isTransactionRunning());
 
-        ocpp_deinitialize();
+        mocpp_deinitialize();
 
-        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         bool checkProcessed = false;
@@ -289,12 +289,12 @@ TEST_CASE( "Charging sessions" ) {
 
         REQUIRE(isTransactionRunning());
 
-        ocpp_deinitialize();
+        mocpp_deinitialize();
 
         loopback.setConnected(false);
-        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         loop();
@@ -307,11 +307,11 @@ TEST_CASE( "Charging sessions" ) {
 
         REQUIRE(!isTransactionRunning());
 
-        ocpp_deinitialize();
+        mocpp_deinitialize();
 
-        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("AO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         bool checkProcessed = false;
@@ -371,9 +371,9 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
         REQUIRE(isOperative());
 
-        ocpp_deinitialize();
+        mocpp_deinitialize();
 
-        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
         connector = getOcppContext()->getModel().getConnector(1);
 
         loop();
@@ -394,6 +394,6 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE(isOperative());
     }
 
-    ocpp_deinitialize();
+    mocpp_deinitialize();
 
 }
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 9ac05e11..8872647a 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -1,14 +1,14 @@
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Operation.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 class CustomAuthorize : public Operation {
 private:
@@ -48,20 +48,20 @@ class CustomStartTransaction : public Operation {
 TEST_CASE( "Configuration Behavior" ) {
 
     //clean state
-    auto filesystem = makeDefaultFilesystemAdapter(ArduinoOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
-    AO_DBG_DEBUG("remove all");
+    auto filesystem = makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
+    MOCPP_DBG_DEBUG("remove all");
     FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+    mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto engine = getOcppContext();
     auto& checkMsg = engine->getOperationRegistry();
 
     auto connector = engine->getModel().getConnector(1);
 
-    ao_set_timer(custom_timer_cb);
+    mocpp_set_timer(custom_timer_cb);
 
     loop();
 
@@ -138,7 +138,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
     SECTION("AllowOfflineTxForUnknownId") {
         auto config = declareConfiguration<bool>("AllowOfflineTxForUnknownId", true);
-        auto authorizationTimeout = ArduinoOcpp::declareConfiguration<int>("AO_AuthorizationTimeout", 1);
+        auto authorizationTimeout = MicroOcpp::declareConfiguration<int>("MO_AuthorizationTimeout", 1);
         *authorizationTimeout = 1; //try normal Authorize for 1s, then enter offline mode
 
         loopback.setConnected(false); //connection loss
@@ -174,7 +174,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
     SECTION("LocalPreAuthorize") {
         auto config = declareConfiguration<bool>("LocalPreAuthorize", true);
-        auto authorizationTimeout = ArduinoOcpp::declareConfiguration<int>("AO_AuthorizationTimeout", 20);
+        auto authorizationTimeout = MicroOcpp::declareConfiguration<int>("MO_AuthorizationTimeout", 20);
         *authorizationTimeout = 300; //try normal Authorize for 5 minutes
 
         auto localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", true, CONFIGURATION_FN, true, true, true, false);
@@ -217,5 +217,5 @@ TEST_CASE( "Configuration Behavior" ) {
         loopback.setConnected(true);
     }
 
-    ocpp_deinitialize();
+    mocpp_deinitialize();
 }
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index bad0aa4d..3889a428 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -1,26 +1,26 @@
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 TEST_CASE("Metering") {
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+    mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto context = getOcppContext();
     auto& model = context->getModel();
 
-    ao_set_timer(custom_timer_cb);
+    mocpp_set_timer(custom_timer_cb);
 
     model.getClock().setTime(BASE_TIME);
 
@@ -97,7 +97,7 @@ TEST_CASE("Metering") {
         auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
         *MeterValueSampleInterval = 10;
 
-        auto MeterValueCacheSize = declareConfiguration("AO_MeterValueCacheSize", 0, CONFIGURATION_FN);
+        auto MeterValueCacheSize = declareConfiguration("MO_MeterValueCacheSize", 0, CONFIGURATION_FN);
         *MeterValueCacheSize = 2;
 
         bool checkProcessed = false;
@@ -159,7 +159,7 @@ TEST_CASE("Metering") {
         auto MeterValuesAlignedData = declareConfiguration<const char*>("MeterValuesAlignedData", "", CONFIGURATION_FN);
         *MeterValuesAlignedData = "Energy.Active.Import.Register";
 
-        auto MeterValueCacheSize = declareConfiguration("AO_MeterValueCacheSize", 0, CONFIGURATION_FN);
+        auto MeterValueCacheSize = declareConfiguration("MO_MeterValueCacheSize", 0, CONFIGURATION_FN);
         *MeterValueCacheSize = 2;
 
         bool checkProcessed = false;
@@ -226,9 +226,9 @@ TEST_CASE("Metering") {
 
         loop();
 
-        ocpp_deinitialize(); //check if StopData is stored over reboots
+        mocpp_deinitialize(); //check if StopData is stored over reboots
 
-        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         addMeterValueInput([base] () {
             //simulate 3600W consumption
@@ -321,7 +321,7 @@ TEST_CASE("Metering") {
         auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
         *MeterValueSampleInterval = 10;
 
-        auto MeterValueCacheSize = declareConfiguration("AO_MeterValueCacheSize", 0, CONFIGURATION_FN);
+        auto MeterValueCacheSize = declareConfiguration("MO_MeterValueCacheSize", 0, CONFIGURATION_FN);
         *MeterValueCacheSize = 10;
 
         bool checkProcessed = false;
@@ -366,5 +366,5 @@ TEST_CASE("Metering") {
         REQUIRE(checkProcessed);
     }
 
-    ocpp_deinitialize();
+    mocpp_deinitialize();
 }
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index 0c26c37e..76b7f004 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -1,11 +1,11 @@
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Model/SmartCharging/SmartChargingService.h>
-#include <ArduinoOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
@@ -34,19 +34,19 @@
 #define SCPROFILE_10_ABSOLUTE_LIMIT_5KW        "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":10,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":5000,\"numberPhases\":3}]}}}]";
 
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 
 TEST_CASE( "SmartCharging" ) {
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+    mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
     auto context = getOcppContext();
     auto& model = context->getModel();
 
-    ao_set_timer(custom_timer_cb);
+    mocpp_set_timer(custom_timer_cb);
 
     model.getClock().setTime(BASE_TIME);
 
@@ -112,9 +112,9 @@ TEST_CASE( "SmartCharging" ) {
         std::string out = SCPROFILE_0;
         loopback.sendTXT(out);
 
-        ocpp_deinitialize();
+        mocpp_deinitialize();
 
-        ocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         setSmartChargingOutput([] (float, float, int) {});
         scService = model.getSmartChargingService();
@@ -567,6 +567,6 @@ TEST_CASE( "SmartCharging" ) {
         return true;
     });
 
-    ocpp_deinitialize();
+    mocpp_deinitialize();
 
 }
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 7b37c74f..1c75265a 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -1,31 +1,31 @@
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/Connection.h>
-#include <ArduinoOcpp/Core/Context.h>
-#include <ArduinoOcpp/Model/Model.h>
-#include <ArduinoOcpp/Core/Configuration.h>
-#include <ArduinoOcpp/Core/SimpleRequestFactory.h>
-#include <ArduinoOcpp/Operations/BootNotification.h>
-#include <ArduinoOcpp/Operations/StatusNotification.h>
-#include <ArduinoOcpp/Debug.h>
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Operations/BootNotification.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+#include <MicroOcpp/Debug.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 
 TEST_CASE( "Transaction safety" ) {
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
-    ocpp_initialize(loopback);
+    mocpp_initialize(loopback);
 
-    ao_set_timer(custom_timer_cb);
+    mocpp_set_timer(custom_timer_cb);
 
     auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN);
         *connectionTimeOut = 30;
 
     SECTION("Basic transaction") {
-        AO_DBG_DEBUG("Basic transaction");
+        MOCPP_DBG_DEBUG("Basic transaction");
         loop();
         startTransaction("mIdTag");
         loop();
@@ -34,11 +34,11 @@ TEST_CASE( "Transaction safety" ) {
         loop();
         REQUIRE(!ocppPermitsCharge());
 
-        ocpp_deinitialize();
+        mocpp_deinitialize();
     }
 
     SECTION("Managed transaction") {
-        AO_DBG_DEBUG("Managed transaction");
+        MOCPP_DBG_DEBUG("Managed transaction");
         loop();
         setConnectorPluggedInput([] () {return true;});
         beginTransaction("mIdTag");
@@ -48,49 +48,49 @@ TEST_CASE( "Transaction safety" ) {
         loop();
         REQUIRE(!ocppPermitsCharge());
         
-        ocpp_deinitialize();
+        mocpp_deinitialize();
     }
 
     SECTION("Reset during transaction 01 - interrupt initiation") {
-        AO_DBG_DEBUG("Reset during transaction 01 - interrupt initiation");
+        MOCPP_DBG_DEBUG("Reset during transaction 01 - interrupt initiation");
         setConnectorPluggedInput([] () {return false;});
         loop();
         beginTransaction("mIdTag");
         loop();
-        ocpp_deinitialize(); //reset and jump to next section
+        mocpp_deinitialize(); //reset and jump to next section
     }
 
     SECTION("Reset during transaction 02 - interrupt initiation second time") {
-        AO_DBG_DEBUG("Reset during transaction 02 - interrupt initiation second time");
+        MOCPP_DBG_DEBUG("Reset during transaction 02 - interrupt initiation second time");
         setConnectorPluggedInput([] () {return false;});
         loop();
         REQUIRE(!ocppPermitsCharge());
-        ocpp_deinitialize();
+        mocpp_deinitialize();
     }
 
     SECTION("Reset during transaction 03 - interrupt running tx") {
-        AO_DBG_DEBUG("Reset during transaction 03 - interrupt running tx");
+        MOCPP_DBG_DEBUG("Reset during transaction 03 - interrupt running tx");
         setConnectorPluggedInput([] () {return true;});
         loop();
         REQUIRE(ocppPermitsCharge());
-        ocpp_deinitialize();
+        mocpp_deinitialize();
     }
 
     SECTION("Reset during transaction 04 - interrupt stopping tx") {
-        AO_DBG_DEBUG("Reset during transaction 04 - interrupt stopping tx");
+        MOCPP_DBG_DEBUG("Reset during transaction 04 - interrupt stopping tx");
         setConnectorPluggedInput([] () {return true;});
         loop();
         REQUIRE(ocppPermitsCharge());
         endTransaction();
-        ocpp_deinitialize();
+        mocpp_deinitialize();
     }
 
     SECTION("Reset during transaction 06 - check tx finished") {
-        AO_DBG_DEBUG("Reset during transaction 06 - check tx finished");
+        MOCPP_DBG_DEBUG("Reset during transaction 06 - check tx finished");
         setConnectorPluggedInput([] () {return true;});
         loop();
         REQUIRE(!ocppPermitsCharge());
-        ocpp_deinitialize();
+        mocpp_deinitialize();
     }
 
 }
diff --git a/tests/helpers/testHelper.cpp b/tests/helpers/testHelper.cpp
index fd8af688..a6aec2a4 100644
--- a/tests/helpers/testHelper.cpp
+++ b/tests/helpers/testHelper.cpp
@@ -1,7 +1,7 @@
 #include <iostream>
-#include <ArduinoOcpp.h>
+#include <MicroOcpp.h>
 
-using namespace ArduinoOcpp;
+using namespace MicroOcpp;
 
 void cpp_console_out(const char *msg) {
     std::cout << msg;
@@ -15,6 +15,6 @@ unsigned long custom_timer_cb() {
 void loop() {
     for (int i = 0; i < 30; i++) {
         mtime += 100;
-        ocpp_loop();
+        mocpp_loop();
     }
 }
diff --git a/tests/ocppEngineLifecycle.cpp b/tests/ocppEngineLifecycle.cpp
index 68ee669e..1b90e4fe 100644
--- a/tests/ocppEngineLifecycle.cpp
+++ b/tests/ocppEngineLifecycle.cpp
@@ -1,22 +1,22 @@
-#include <ArduinoOcpp.h>
-#include <ArduinoOcpp/Core/Connection.h>
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
 TEST_CASE( "Context lifecycle" ) {
 
     //set console output to the cpp console to display outputs
-    //ao_set_console_out(cpp_console_out);
+    //mo_set_console_out(cpp_console_out);
 
     //initialize Context with dummy socket
-    ArduinoOcpp::LoopbackConnection loopback;
-    ocpp_initialize(loopback);
+    MicroOcpp::LoopbackConnection loopback;
+    mocpp_initialize(loopback);
 
     SECTION("OCPP is initialized"){
         REQUIRE( getOcppContext() );
     }
 
-    ocpp_deinitialize();
+    mocpp_deinitialize();
 
     SECTION("OCPP is deinitialized"){
         REQUIRE( !( getOcppContext() ) );

From 9d63ce28eab3c8c983e4aa8f9f088fdce6535ee0 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 20 Aug 2023 22:57:17 +0200
Subject: [PATCH 349/549] change naming for release III

---
 src/MicroOcpp.cpp                   | 2 +-
 src/MicroOcpp/Core/Configuration.h  | 4 ++--
 src/MicroOcpp/Core/RequestStore.cpp | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index e30df97a..d09fa363 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -146,7 +146,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         MOCPP_DBG_ERR("multiple initialization failures detected");
         if (filesystem) {
             bool success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
-                return strcmp(fname, "ocpp-creds.jsn");
+                return strcmp(fname, "ws-conn.jsn");
             });
             MOCPP_DBG_ERR("clear local state folder (except WS creds): %s", success ? "success" : "not completed");
 
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index 24c1a6b7..08ad6705 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -13,9 +13,9 @@
 #include <memory>
 #include <vector>
 
-#define CONFIGURATION_FN (MOCPP_FILENAME_PREFIX "arduino-ocpp.cnf")
+#define CONFIGURATION_FN (MOCPP_FILENAME_PREFIX "ocpp-config.jsn")
 #define CONFIGURATION_VOLATILE "/volatile"
-#define MOCPP_KEYVALUE_FN (MOCPP_FILENAME_PREFIX "client-state.cnf")
+#define MOCPP_KEYVALUE_FN (MOCPP_FILENAME_PREFIX "client-state.jsn")
 
 namespace MicroOcpp {
 
diff --git a/src/MicroOcpp/Core/RequestStore.cpp b/src/MicroOcpp/Core/RequestStore.cpp
index 07ac9e83..6d4c442e 100644
--- a/src/MicroOcpp/Core/RequestStore.cpp
+++ b/src/MicroOcpp/Core/RequestStore.cpp
@@ -8,7 +8,7 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Debug.h>
 
-#define MOCPP_OPSTORE_FN MOCPP_FILENAME_PREFIX "opstore.cnf"
+#define MOCPP_OPSTORE_FN MOCPP_FILENAME_PREFIX "opstore.jsn"
 
 #define MOCPP_OPHISTORY_SIZE 3
 

From 62dda000ba4b87f8e22623a074d26080711d55dc Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 21 Aug 2023 01:04:39 +0200
Subject: [PATCH 350/549] update readme

---
 README.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index e72d0e0e..c36489d6 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,16 @@
-# <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; MicroOcpp
+# <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; MicroOcpp (ArduinoOcpp)
 
 [![Build Status]( https://github.com/matth-x/MicroOcpp/workflows/PlatformIO%20CI/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
 [![Unit tests]( https://github.com/matth-x/MicroOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
-[![codecov](https://codecov.io/github/matth-x/MicroOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/MicroOcpp)
+[![codecov](https://codecov.io/github/matth-x/ArduinoOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/ArduinoOcpp)
+
+**Formerly ArduinoOcpp**: *since the first release in 2020, ArduinoOcpp has increasingly been used on other platforms than Arduino. The goal of this project has evolved to fit seamlessly in a high variety of microcontroller firmwares and so the dependency on Arduino was dropped some time ago. The new name reflects the purpose of this project better and prevents any confusion. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
 
 OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with Espressif, NXP, Texas Instruments and STM.
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
 
-PlatformIO package: [MicroOcpp](https://platformio.org/lib/show/11975/MicroOcpp)
+PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
 
 Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
@@ -53,7 +55,7 @@ If compiled with the Arduino integration:
 
 - [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (version `2.3.6`)
 
-In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp` in the PIO library manager.
+In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp@0.3.0` in the PIO library manager.
 
 ## OCPP 2.0.1 and ISO 15118
 

From b441f08360671e13476fab501f4cb8dd5a142acb Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 21 Aug 2023 01:31:05 +0200
Subject: [PATCH 351/549] add migration guide

---
 README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/README.md b/README.md
index c36489d6..64fdb507 100644
--- a/README.md
+++ b/README.md
@@ -41,6 +41,30 @@ Try it (no hardware required): [MicroOcppSimulator](https://github.com/matth-x/M
 
 The necessary hardware and internet integration is usually far below 1000 LOCs.
 
+## Migrating to v1.0
+
+With the new project name, the API has been freezed for the v1.0 release. To migrate existing projects, find and replace the keywords in the following.
+
+If using the C-facade (skip if you don't use anything from *ArduinoOcpp_c.h*):
+- `AO_Connection` to `OCPP_Connection`
+- `AO_Transaction` to `OCPP_Transaction`
+- `AO_FilesystemOpt` to `OCPP_FilesystemOpt`
+- `AO_TxNotification` to `OCPP_TxNotification`
+- `ao_set_console_out_c` to `ocpp_set_console_out_c`
+
+Change this in any case:
+- `ArduinoOcpp` to `MicroOcpp`
+- `"AO_` to `"MO_`
+- `AO_` to `MOCPP_`
+- `ocpp_` to `mocpp_`
+
+Change this if used anywhere:
+- `ao_set_console_out` to `mocpp_set_console_out`
+- `ao_tick_ms` to `mocpp_tick_ms`
+
+If using the C-facade, change this as the final step:
+- `ao_` to `ocpp_`
+
 ## Developers guide
 
 Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h).

From 99a0925a2202476e7539d1a3c8f07e3c267975ba Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Mon, 21 Aug 2023 01:40:16 +0200
Subject: [PATCH 352/549] link to migration guide and issue

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 64fdb507..99a76e6a 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 [![Unit tests]( https://github.com/matth-x/MicroOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
 [![codecov](https://codecov.io/github/matth-x/ArduinoOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/ArduinoOcpp)
 
-**Formerly ArduinoOcpp**: *since the first release in 2020, ArduinoOcpp has increasingly been used on other platforms than Arduino. The goal of this project has evolved to fit seamlessly in a high variety of microcontroller firmwares and so the dependency on Arduino was dropped some time ago. The new name reflects the purpose of this project better and prevents any confusion. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
+**Formerly ArduinoOcpp ([migration guide](https://github.com/matth-x/MicroOcpp#migrating-to-v10))**: *since the first release in 2020, ArduinoOcpp has increasingly been used on other platforms than Arduino. The goal of this project has evolved to fit seamlessly in a high variety of microcontroller firmwares and so the dependency on Arduino was dropped some time ago. The new name reflects the purpose of this project better and prevents any confusion. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
 
 OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with Espressif, NXP, Texas Instruments and STM.
 
@@ -65,6 +65,8 @@ Change this if used anywhere:
 If using the C-facade, change this as the final step:
 - `ao_` to `ocpp_`
 
+**If something is missing in this guide, please share the issue here:** https://github.com/matth-x/MicroOcpp/issues/176
+
 ## Developers guide
 
 Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h).

From ec1ac629cb8411dab01f286a5531d683c427b1f4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 23 Aug 2023 16:18:57 +0200
Subject: [PATCH 353/549] custom prefix for configuration extension

---
 src/MicroOcpp/Core/Configuration.h                    |  4 ++++
 src/MicroOcpp/Core/RequestStore.cpp                   |  2 +-
 src/MicroOcpp/Model/Boot/BootService.cpp              |  2 +-
 src/MicroOcpp/Model/ConnectorBase/Connector.cpp       | 10 +++++-----
 src/MicroOcpp/Model/Metering/MeteringConnector.cpp    |  6 +++---
 src/MicroOcpp/Model/Transactions/TransactionStore.cpp |  4 ++--
 tests/ChargingSessions.cpp                            | 10 +++++-----
 tests/ConfigurationBehavior.cpp                       |  4 ++--
 tests/Metering.cpp                                    |  6 +++---
 9 files changed, 26 insertions(+), 22 deletions(-)

diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index 08ad6705..fe12de14 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -17,6 +17,10 @@
 #define CONFIGURATION_VOLATILE "/volatile"
 #define MOCPP_KEYVALUE_FN (MOCPP_FILENAME_PREFIX "client-state.jsn")
 
+#ifndef MOCPP_CONFIG_EXT_PREFIX
+#define MOCPP_CONFIG_EXT_PREFIX "Cst_"
+#endif
+
 namespace MicroOcpp {
 
 template <class T>
diff --git a/src/MicroOcpp/Core/RequestStore.cpp b/src/MicroOcpp/Core/RequestStore.cpp
index 6d4c442e..bdb7222c 100644
--- a/src/MicroOcpp/Core/RequestStore.cpp
+++ b/src/MicroOcpp/Core/RequestStore.cpp
@@ -96,7 +96,7 @@ bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
 }
 
 RequestStore::RequestStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
-    opBegin = declareConfiguration<int>("MO_opBegin", 0, MOCPP_OPSTORE_FN, false, false, true, false);
+    opBegin = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "opBegin", 0, MOCPP_OPSTORE_FN, false, false, true, false);
 
     if (!opBegin || *opBegin < 0) {
         MOCPP_DBG_ERR("init failure");
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index fbcf3dde..822224da 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -36,7 +36,7 @@ RegistrationStatus MicroOcpp::deserializeRegistrationStatus(const char *serializ
 BootService::BootService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
     //if transactions can start before the BootNotification succeeds
-    preBootTransactions = declareConfiguration<bool>("MO_PreBootTransactions", false, CONFIGURATION_FN, true, true, true, false);
+    preBootTransactions = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", false, CONFIGURATION_FN, true, true, true, false);
     
     if (!preBootTransactions) {
         MOCPP_DBG_ERR("initialization error");
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 0a200398..e26bc7ba 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -31,7 +31,7 @@ Connector::Connector(Context& context, int connectorId)
         : context(context), model(context.getModel()), connectorId{connectorId} {
 
     char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
-    snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, "MO_AVAIL_CONN_%d", connectorId);
+    snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, MOCPP_CONFIG_EXT_PREFIX "AVAIL_CONN_%d", connectorId);
     availability = declareConfiguration<bool>(availabilityKey, true, MOCPP_KEYVALUE_FN, false, false, true, false);
 
     connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN, true, true, true, false);
@@ -43,14 +43,14 @@ Connector::Connector(Context& context, int connectorId)
     allowOfflineTxForUnknownId = MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", false, CONFIGURATION_FN);
 
     //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
-    silentOfflineTransactions = declareConfiguration<bool>("MO_SilentOfflineTransactions", false, CONFIGURATION_FN, true, true, true, false);
+    silentOfflineTransactions = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "SilentOfflineTransactions", false, CONFIGURATION_FN, true, true, true, false);
 
     //how long the EVSE tries the Authorize request before it enters offline mode
-    authorizationTimeout = MicroOcpp::declareConfiguration<int>("MO_AuthorizationTimeout", 20, CONFIGURATION_FN);
+    authorizationTimeout = MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20, CONFIGURATION_FN);
 
     //FreeVend mode
-    freeVendActive = declareConfiguration<bool>("MO_FreeVendActive", false, CONFIGURATION_FN, true, true, true, false);
-    freeVendIdTag = declareConfiguration<const char*>("MO_FreeVendIdTag", "", CONFIGURATION_FN, true, true, true, false);
+    freeVendActive = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "FreeVendActive", false, CONFIGURATION_FN, true, true, true, false);
+    freeVendIdTag = declareConfiguration<const char*>(MOCPP_CONFIG_EXT_PREFIX "FreeVendIdTag", "", CONFIGURATION_FN, true, true, true, false);
 
     if (!availability) {
         MOCPP_DBG_ERR("Cannot declare availability");
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index 37e4eaad..ee8097df 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -22,7 +22,7 @@ MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore&
 
     auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData", "", CONFIGURATION_FN);
     declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
-    MeterValueCacheSize = declareConfiguration("MO_MeterValueCacheSize", 1, CONFIGURATION_FN, true, true, true, false);
+    MeterValueCacheSize = declareConfiguration(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 1, CONFIGURATION_FN, true, true, true, false);
     MeterValueSampleInterval = declareConfiguration("MeterValueSampleInterval", 60);
     
     auto StopTxnSampledData = declareConfiguration<const char*>("StopTxnSampledData", "", CONFIGURATION_FN);
@@ -34,8 +34,8 @@ MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore&
     
     auto StopTxnAlignedData = declareConfiguration<const char*>("StopTxnAlignedData", "", CONFIGURATION_FN);
 
-    MeterValuesInTxOnly = declareConfiguration<bool>("MO_MeterValuesInTxOnly", true, CONFIGURATION_FN, true, true, true, false);
-    StopTxnDataCapturePeriodic = declareConfiguration<bool>("MO_StopTxnDataCapturePeriodic", false, CONFIGURATION_FN, true, true, true, false);
+    MeterValuesInTxOnly = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "MeterValuesInTxOnly", true, CONFIGURATION_FN, true, true, true, false);
+    StopTxnDataCapturePeriodic = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "StopTxnDataCapturePeriodic", false, CONFIGURATION_FN, true, true, true, false);
 
     sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesSampledData));
     alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData));
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
index ccbf8c7d..84e9a4f8 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
@@ -23,13 +23,13 @@ ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context,
         filesystem(filesystem) {
 
     char key [30] = {'\0'};
-    if (snprintf(key, 30, "MO_txEnd_%u", connectorId) < 0) {
+    if (snprintf(key, 30, MOCPP_CONFIG_EXT_PREFIX "txEnd_%u", connectorId) < 0) {
         MOCPP_DBG_ERR("Invalid key");
         (void)0;
     }
     txEnd = declareConfiguration<int>(key, 0, MOCPP_TXSTORE_META_FN, false, false, true, false);
 
-    if (snprintf(key, 30, "MO_txBegin_%u", connectorId) < 0) {
+    if (snprintf(key, 30, MOCPP_CONFIG_EXT_PREFIX "txBegin_%u", connectorId) < 0) {
         MOCPP_DBG_ERR("Invalid key");
         (void)0;
     }
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index cc51a45a..494af7e4 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -182,7 +182,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         loop();
@@ -243,7 +243,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         loop();
@@ -257,7 +257,7 @@ TEST_CASE( "Charging sessions" ) {
 
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         bool checkProcessed = false;
@@ -294,7 +294,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         loop();
@@ -311,7 +311,7 @@ TEST_CASE( "Charging sessions" ) {
 
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>("MO_PreBootTransactions", true, CONFIGURATION_FN) = true;
+        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
         configuration_save();
 
         bool checkProcessed = false;
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 8872647a..fa3c747c 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -138,7 +138,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
     SECTION("AllowOfflineTxForUnknownId") {
         auto config = declareConfiguration<bool>("AllowOfflineTxForUnknownId", true);
-        auto authorizationTimeout = MicroOcpp::declareConfiguration<int>("MO_AuthorizationTimeout", 1);
+        auto authorizationTimeout = MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 1);
         *authorizationTimeout = 1; //try normal Authorize for 1s, then enter offline mode
 
         loopback.setConnected(false); //connection loss
@@ -174,7 +174,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
     SECTION("LocalPreAuthorize") {
         auto config = declareConfiguration<bool>("LocalPreAuthorize", true);
-        auto authorizationTimeout = MicroOcpp::declareConfiguration<int>("MO_AuthorizationTimeout", 20);
+        auto authorizationTimeout = MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
         *authorizationTimeout = 300; //try normal Authorize for 5 minutes
 
         auto localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", true, CONFIGURATION_FN, true, true, true, false);
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 3889a428..3e82ee41 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -97,7 +97,7 @@ TEST_CASE("Metering") {
         auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
         *MeterValueSampleInterval = 10;
 
-        auto MeterValueCacheSize = declareConfiguration("MO_MeterValueCacheSize", 0, CONFIGURATION_FN);
+        auto MeterValueCacheSize = declareConfiguration(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
         *MeterValueCacheSize = 2;
 
         bool checkProcessed = false;
@@ -159,7 +159,7 @@ TEST_CASE("Metering") {
         auto MeterValuesAlignedData = declareConfiguration<const char*>("MeterValuesAlignedData", "", CONFIGURATION_FN);
         *MeterValuesAlignedData = "Energy.Active.Import.Register";
 
-        auto MeterValueCacheSize = declareConfiguration("MO_MeterValueCacheSize", 0, CONFIGURATION_FN);
+        auto MeterValueCacheSize = declareConfiguration(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
         *MeterValueCacheSize = 2;
 
         bool checkProcessed = false;
@@ -321,7 +321,7 @@ TEST_CASE("Metering") {
         auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
         *MeterValueSampleInterval = 10;
 
-        auto MeterValueCacheSize = declareConfiguration("MO_MeterValueCacheSize", 0, CONFIGURATION_FN);
+        auto MeterValueCacheSize = declareConfiguration(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
         *MeterValueCacheSize = 10;
 
         bool checkProcessed = false;

From 1eff6e5dd9cc7b8676febe740136c8a7ecfdbe09 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 23 Aug 2023 17:22:32 +0200
Subject: [PATCH 354/549] update docs

---
 README.md         | 42 +++++++-----------------------------------
 docs/index.md     |  4 ++++
 docs/migration.md | 29 +++++++++++++++++++++++++++++
 3 files changed, 40 insertions(+), 35 deletions(-)
 create mode 100644 docs/migration.md

diff --git a/README.md b/README.md
index 99a76e6a..287cdd05 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 [![Unit tests]( https://github.com/matth-x/MicroOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
 [![codecov](https://codecov.io/github/matth-x/ArduinoOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/ArduinoOcpp)
 
-**Formerly ArduinoOcpp ([migration guide](https://github.com/matth-x/MicroOcpp#migrating-to-v10))**: *since the first release in 2020, ArduinoOcpp has increasingly been used on other platforms than Arduino. The goal of this project has evolved to fit seamlessly in a high variety of microcontroller firmwares and so the dependency on Arduino was dropped some time ago. The new name reflects the purpose of this project better and prevents any confusion. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
+**Formerly ArduinoOcpp ([migration guide](https://matth-x.github.io/MicroOcpp/migration/))**: *since the first release in 2020, ArduinoOcpp has increasingly been used on other platforms than Arduino. The goal of this project has evolved to fit seamlessly in a high variety of microcontroller firmwares and so the dependency on Arduino was dropped some time ago. The new name reflects the purpose of this project better and prevents potential confusion. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
 
 OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with Espressif, NXP, Texas Instruments and STM.
 
@@ -41,35 +41,9 @@ Try it (no hardware required): [MicroOcppSimulator](https://github.com/matth-x/M
 
 The necessary hardware and internet integration is usually far below 1000 LOCs.
 
-## Migrating to v1.0
-
-With the new project name, the API has been freezed for the v1.0 release. To migrate existing projects, find and replace the keywords in the following.
-
-If using the C-facade (skip if you don't use anything from *ArduinoOcpp_c.h*):
-- `AO_Connection` to `OCPP_Connection`
-- `AO_Transaction` to `OCPP_Transaction`
-- `AO_FilesystemOpt` to `OCPP_FilesystemOpt`
-- `AO_TxNotification` to `OCPP_TxNotification`
-- `ao_set_console_out_c` to `ocpp_set_console_out_c`
-
-Change this in any case:
-- `ArduinoOcpp` to `MicroOcpp`
-- `"AO_` to `"MO_`
-- `AO_` to `MOCPP_`
-- `ocpp_` to `mocpp_`
-
-Change this if used anywhere:
-- `ao_set_console_out` to `mocpp_set_console_out`
-- `ao_tick_ms` to `mocpp_tick_ms`
-
-If using the C-facade, change this as the final step:
-- `ao_` to `ocpp_`
-
-**If something is missing in this guide, please share the issue here:** https://github.com/matth-x/MicroOcpp/issues/176
-
 ## Developers guide
 
-Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h).
+Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h). Also check out the [Docs](https://matth-x.github.io/MicroOcpp).
 
 ### Dependencies
 
@@ -79,17 +53,15 @@ Mandatory:
 
 If compiled with the Arduino integration:
 
-- [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (version `2.3.6`)
+- [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (version `2.4.1`)
 
 In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp@0.3.0` in the PIO library manager.
 
 ## OCPP 2.0.1 and ISO 15118
 
-The OCPP 2.0.1 upgrade is being worked on. Further details will be announced soon.
-
-ISO 15118 is a must-have for future chargers. It will hugely improve the security and user-friendliness of EV charging. MicroOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is being validated now in a proprietary firmware development.
+**The call for funding for the OCPP 2.0.1 upgrade has been opened.** The version 1.6 support has successfully been funded by private companies who share an interest in using this technology. OCPP is most often seen as a non-differentiating feature of chargers and is therefore perfectly suited for Open Source collaboration. If your company has an interest in the OCPP 2.0.1 upgrade, please use the contact details at the end of this page to receive a pitch with all advantages of joining the group of funders.
 
-However, no public ISO 15118 integration exists at the moment. If your company considers working on an open source ISO 15118 stack, it would be great to discuss a potential collaboration on an open source OCPP 2.0.1 + ISO 15118 solution.
+ISO 15118 will improve the security and user-friendliness of EV charging. MicroOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is already being validated at the moment. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
 
 ## Supported Feature Profiles
 
@@ -106,8 +78,8 @@ Fully OCPP 1.6 compliant :heavy_check_mark:
 
 ## Further help
 
-I hope this guide can help you to successfully integrate an OCPP controller into your EVSE. If something needs clarification or if you have a question, please send me a message.
+I hope the given documentation and guidance can help you to successfully integrate an OCPP controller into your EVSE. If something needs clarification or if you have a question, please send me a message.
 
-:envelope: : matthias A⊤ arduino-ocpp DО⊤ com
+:envelope: : matthias [A⊤] arduino-ocpp [DО⊤] com
 
 If you want professional assistance for your EVSE project, you can contact me as well. I'm looking forward to hearing about your ideas!
diff --git a/docs/index.md b/docs/index.md
index 66e396c2..11eac9d1 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -2,10 +2,14 @@ MicroOcpp is an OCPP client which runs on microcontrollers and enables EVSEs to
 
 [Technical introduction](intro-tech)
 
+[Migrating to v1.0](migration)
+
 [Modules](modules)
 
 [Development tools and basic prerequisites](prerequisites)
 
+[Security whitepaper](security)
+
 <!-- This chapter shows how to kick-start your OCPP project. -->
 
 *Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/MicroOcpp) or the [API description](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h) as reference.*
diff --git a/docs/migration.md b/docs/migration.md
new file mode 100644
index 00000000..81fd4b73
--- /dev/null
+++ b/docs/migration.md
@@ -0,0 +1,29 @@
+# Migrating to v1.0
+
+The API has been continously improved to best suit the common use cases for MicroOcpp. Moreover, the project has been given a new name to prevent confusion with the relation to the Arduino platform and to reflect the project goals properly. With the new project name, the API has been frozen for the v1.0 release. To migrate existing projects, find and replace the keywords in the following.
+
+If using the C-facade (skip if you don't use anything from *ArduinoOcpp_c.h*):
+
+- `AO_Connection` to `OCPP_Connection`
+- `AO_Transaction` to `OCPP_Transaction`
+- `AO_FilesystemOpt` to `OCPP_FilesystemOpt`
+- `AO_TxNotification` to `OCPP_TxNotification`
+- `ao_set_console_out_c` to `ocpp_set_console_out_c`
+
+Change this in any case:
+
+- `ArduinoOcpp` to `MicroOcpp`
+- `"AO_` to `"Cst_` (define build flag `MOCPP_CONFIG_EXT_PREFIX="AO_"` to keep old config keys)
+- `AO_` to `MOCPP_`
+- `ocpp_` to `mocpp_`
+
+Change this if used anywhere:
+
+- `ao_set_console_out` to `mocpp_set_console_out`
+- `ao_tick_ms` to `mocpp_tick_ms`
+
+If using the C-facade, change this as the final step:
+
+- `ao_` to `ocpp_`
+
+**If something is missing in this guide, please share the issue here:** [https://github.com/matth-x/MicroOcpp/issues/176](https://github.com/matth-x/MicroOcpp/issues/176)

From 5a949250c9537cbf01ad65e4ef4d6e30b644da91 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 27 Aug 2023 17:16:07 +0200
Subject: [PATCH 355/549] add platform definition MOCPP_PLATFORM_NONE

---
 .github/workflows/platformless.yml            |  2 +-
 src/MicroOcpp/Core/FilesystemAdapter.cpp      |  4 ++++
 .../SmartCharging/SmartChargingModel.cpp      | 14 +++++++------
 src/MicroOcpp/Platform.h                      | 21 ++++++++++++++-----
 4 files changed, 29 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index c6e638d7..e7a17ace 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -26,4 +26,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DMOCPP_FILENAME_PREFIX='"./mo_store/"' -DMOCPP_PLATFORM=MOCPP_PLATFORM_UNIX -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DMOCPP_PLATFORM=MOCPP_PLATFORM_NONE -Wall
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 4082cf86..a6a48eb7 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -481,8 +481,12 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 #else //filesystem disabled
 
+namespace MicroOcpp {
+
 std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
     return nullptr;
 }
 
+} //end namespace MicroOcpp
+
 #endif //switch-case MOCPP_USE_FILEAPI
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
index 1e27223e..82cc84bf 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -292,17 +292,19 @@ void ChargingProfile::printProfile(){
                 "   > chargingProfileId: %i\n" \
                 "   > transactionId: %i\n" \
                 "   > stackLevel: %i\n" \
-                "   > chargingProfilePurpose: %s\n" \
-                "   > chargingProfileKind: %s\n" \
-                "   > recurrencyKind: %s\n" \
-                "   > validFrom: %s\n" \
-                "   > validTo: %s\n",
+                "   > chargingProfilePurpose: %s\n",
                 chargingProfileId,
                 transactionId,
                 stackLevel,
                 chargingProfilePurpose == (ChargingProfilePurposeType::ChargePointMaxProfile) ? "ChargePointMaxProfile" :
                     chargingProfilePurpose == (ChargingProfilePurposeType::TxDefaultProfile) ? "TxDefaultProfile" :
-                    chargingProfilePurpose == (ChargingProfilePurposeType::TxProfile) ? "TxProfile" : "Error",
+                    chargingProfilePurpose == (ChargingProfilePurposeType::TxProfile) ? "TxProfile" : "Error"
+                );
+    MOCPP_CONSOLE_PRINTF(
+                "   > chargingProfileKind: %s\n" \
+                "   > recurrencyKind: %s\n" \
+                "   > validFrom: %s\n" \
+                "   > validTo: %s\n",
                 chargingProfileKind == (ChargingProfileKindType::Absolute) ? "Absolute" :
                     chargingProfileKind == (ChargingProfileKindType::Recurring) ? "Recurring" :
                     chargingProfileKind == (ChargingProfileKindType::Relative) ? "Relative" : "Error",
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index 88a833c4..926336c5 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -11,19 +11,29 @@
 #define EXT_C
 #endif
 
-#define MOCPP_PLATFORM_ARDUINO 0
-#define MOCPP_PLATFORM_ESPIDF  1
-#define MOCPP_PLATFORM_UNIX    2
+#define MOCPP_PLATFORM_NONE    0
+#define MOCPP_PLATFORM_ARDUINO 1
+#define MOCPP_PLATFORM_ESPIDF  2
+#define MOCPP_PLATFORM_UNIX    3
 
 #ifndef MOCPP_PLATFORM
 #define MOCPP_PLATFORM MOCPP_PLATFORM_ARDUINO
 #endif
 
+#if MOCPP_PLATFORM == MOCPP_PLATFORM_NONE
+#ifndef MOCPP_CUSTOM_CONSOLE
+#define MOCPP_CUSTOM_CONSOLE
+#endif
+#ifndef MOCPP_CUSTOM_TIMER
+#define MOCPP_CUSTOM_TIMER
+#endif
+#endif
+
 #ifdef MOCPP_CUSTOM_CONSOLE
 #include <cstdio>
 
 #ifndef MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE
-#define MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE 196
+#define MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE 192
 #endif
 
 void mo_set_console_out(void (*console_out)(const char *msg));
@@ -34,7 +44,8 @@ void mocpp_console_out(const char *msg);
 #define MOCPP_CONSOLE_PRINTF(X, ...) \
             do { \
                 char msg [MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE]; \
-                if (snprintf(msg, MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__) < 0) { \
+                auto _mo_ret = snprintf(msg, MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__); \
+                if (_mo_ret < 0 || _mo_ret >= MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE) { \
                     sprintf(msg + MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
                 } \
                 MicroOcpp::mocpp_console_out(msg); \

From 5abe75edd461c09f2224895552817ff7def8ac1c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 27 Aug 2023 19:42:25 +0200
Subject: [PATCH 356/549] fix delete statement

---
 src/MicroOcpp/Core/Request.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index be4d299f..fe3184e7 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -101,7 +101,7 @@ std::unique_ptr<DynamicJsonDocument> Request::createRequest(){
             MOCPP_DBG_DEBUG("Try to send request: %.*s (...)", 128, buf);
         }
 
-        delete buf;
+        delete[] buf;
     }
 
     trialNo++;

From 3b487817d9f741ca3d1903fc2263463b7bc03625 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 27 Aug 2023 20:05:30 +0200
Subject: [PATCH 357/549] fix compiler warnings

---
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp         |  2 +-
 src/MicroOcpp/Core/FilesystemAdapter.cpp             | 10 +++++-----
 src/MicroOcpp/Core/OcppError.h                       |  8 ++++----
 src/MicroOcpp/Operations/Authorize.h                 | 12 +++++-------
 src/MicroOcpp/Operations/BootNotification.h          | 12 ++++++------
 src/MicroOcpp/Operations/CancelReservation.h         |  8 ++++----
 src/MicroOcpp/Operations/ChangeAvailability.h        |  8 ++++----
 src/MicroOcpp/Operations/ChangeConfiguration.h       |  8 ++++----
 src/MicroOcpp/Operations/ClearCache.h                |  6 +++---
 src/MicroOcpp/Operations/ClearChargingProfile.h      |  6 +++---
 src/MicroOcpp/Operations/DataTransfer.h              |  6 +++---
 .../Operations/DiagnosticsStatusNotification.h       |  6 +++---
 .../Operations/FirmwareStatusNotification.h          |  6 +++---
 src/MicroOcpp/Operations/GetCompositeSchedule.h      |  8 ++++----
 src/MicroOcpp/Operations/GetConfiguration.h          |  6 +++---
 src/MicroOcpp/Operations/GetDiagnostics.h            |  8 ++++----
 src/MicroOcpp/Operations/GetLocalListVersion.h       |  6 +++---
 src/MicroOcpp/Operations/Heartbeat.h                 | 10 +++++-----
 src/MicroOcpp/Operations/MeterValues.h               | 10 +++++-----
 src/MicroOcpp/Operations/RemoteStartTransaction.h    | 12 ++++++------
 src/MicroOcpp/Operations/RemoteStopTransaction.h     |  6 +++---
 src/MicroOcpp/Operations/ReserveNow.h                |  8 ++++----
 src/MicroOcpp/Operations/Reset.h                     |  6 +++---
 src/MicroOcpp/Operations/SendLocalList.h             |  8 ++++----
 src/MicroOcpp/Operations/SetChargingProfile.h        |  6 +++---
 src/MicroOcpp/Operations/StartTransaction.h          | 10 +++++-----
 src/MicroOcpp/Operations/StatusNotification.h        | 10 +++++-----
 src/MicroOcpp/Operations/TriggerMessage.h            |  8 ++++----
 src/MicroOcpp/Operations/UnlockConnector.h           |  6 +++---
 src/MicroOcpp/Operations/UpdateFirmware.h            |  8 ++++----
 30 files changed, 116 insertions(+), 118 deletions(-)

diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index 9012c4a9..9e97ff95 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -254,6 +254,6 @@ std::function<bool(const char*)> Configuration<const char *>::getValidator() {
 template class Configuration<int>;
 template class Configuration<float>;
 template class Configuration<bool>;
-template class Configuration<const char *>;
+//template class Configuration<const char *>; //no effect after explicit specialization
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index a6a48eb7..6de8d5ef 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -141,7 +141,7 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     bool remove(const char *fn) override {
         return USE_FS.remove(fn);
     };
-    int ftw_root(std::function<int(const char *fpath)> fn) {
+    int ftw_root(std::function<int(const char *fpath)> fn) override {
 #if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
         auto dir = USE_FS.open(MOCPP_FILENAME_PREFIX);
         if (!dir) {
@@ -244,7 +244,7 @@ class EspIdfFileAdapter : public FileAdapter {
         return fseek(file, offset, SEEK_SET);
     }
 
-    int read() {
+    int read() override {
         return fgetc(file);
     }
 };
@@ -285,7 +285,7 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
         return unlink(fn) == 0;
     }
 
-    int ftw_root(std::function<int(const char *fpath)> fn) {
+    int ftw_root(std::function<int(const char *fpath)> fn) override {
         //open MO root directory
         char dname [MOCPP_MAX_PATH_SIZE];
         auto dlen = snprintf(dname, MOCPP_MAX_PATH_SIZE, "%s", MOCPP_FILENAME_PREFIX);
@@ -399,7 +399,7 @@ class PosixFileAdapter : public FileAdapter {
         return fseek(file, offset, SEEK_SET);
     }
 
-    int read() {
+    int read() override {
         return fgetc(file);
     }
 };
@@ -435,7 +435,7 @@ class PosixFilesystemAdapter : public FilesystemAdapter {
         return ::remove(fn) == 0;
     }
 
-    int ftw_root(std::function<int(const char *fpath)> fn) {
+    int ftw_root(std::function<int(const char *fpath)> fn) override {
         auto dir = opendir(MOCPP_FILENAME_PREFIX); // use c_str() to convert the path string to a C-style string
         if (!dir) {
             MOCPP_DBG_ERR("cannot open root directory: " MOCPP_FILENAME_PREFIX);
diff --git a/src/MicroOcpp/Core/OcppError.h b/src/MicroOcpp/Core/OcppError.h
index 0c8e4a04..a2d24cf3 100644
--- a/src/MicroOcpp/Core/OcppError.h
+++ b/src/MicroOcpp/Core/OcppError.h
@@ -13,7 +13,7 @@ namespace MicroOcpp {
 
 class NotImplemented : public Operation {
 public:
-    const char *getErrorCode() {
+    const char *getErrorCode() override {
         return "NotImplemented";
     }
 };
@@ -24,13 +24,13 @@ class MsgBufferExceeded : public Operation {
     size_t msgLen;
 public:
     MsgBufferExceeded(size_t maxCapacity, size_t msgLen) : maxCapacity(maxCapacity), msgLen(msgLen) { }
-    const char *getErrorCode() {
+    const char *getErrorCode() override {
         return "GenericError";
     }
-    const char *getErrorDescription() {
+    const char *getErrorDescription() override {
         return "JSON too long or too many fields. Cannot deserialize";
     }
-    std::unique_ptr<DynamicJsonDocument> getErrorDetails() {
+    std::unique_ptr<DynamicJsonDocument> getErrorDetails() override {
         auto errDoc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
         JsonObject err = errDoc->to<JsonObject>();
         err["max_capacity"] = maxCapacity;
diff --git a/src/MicroOcpp/Operations/Authorize.h b/src/MicroOcpp/Operations/Authorize.h
index fb86917e..7f070e6c 100644
--- a/src/MicroOcpp/Operations/Authorize.h
+++ b/src/MicroOcpp/Operations/Authorize.h
@@ -19,19 +19,17 @@ class Authorize : public Operation {
     Model& model;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
 public:
-//    Authorize();
-
     Authorize(Model& model, const char *idTag);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
 };
 
diff --git a/src/MicroOcpp/Operations/BootNotification.h b/src/MicroOcpp/Operations/BootNotification.h
index 41acdad1..4a85833f 100644
--- a/src/MicroOcpp/Operations/BootNotification.h
+++ b/src/MicroOcpp/Operations/BootNotification.h
@@ -29,17 +29,17 @@ class BootNotification : public Operation {
 
     ~BootNotification() = default;
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return errorCode;}
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/CancelReservation.h b/src/MicroOcpp/Operations/CancelReservation.h
index 99b6787e..b268a8fd 100644
--- a/src/MicroOcpp/Operations/CancelReservation.h
+++ b/src/MicroOcpp/Operations/CancelReservation.h
@@ -21,13 +21,13 @@ class CancelReservation : public Operation {
 public:
     CancelReservation(Model& model);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return errorCode;}
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.h b/src/MicroOcpp/Operations/ChangeAvailability.h
index afecdece..00fd2b7a 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.h
+++ b/src/MicroOcpp/Operations/ChangeAvailability.h
@@ -23,13 +23,13 @@ class ChangeAvailability : public Operation {
 public:
     ChangeAvailability(Model& model);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return errorCode;}
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.h b/src/MicroOcpp/Operations/ChangeConfiguration.h
index bef65928..55cb6b47 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.h
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.h
@@ -21,13 +21,13 @@ class ChangeConfiguration : public Operation {
 public:
     ChangeConfiguration();
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return errorCode;}
+    const char *getErrorCode() override {return errorCode;}
 
 };
 
diff --git a/src/MicroOcpp/Operations/ClearCache.h b/src/MicroOcpp/Operations/ClearCache.h
index 7bcc7e77..e49a6969 100644
--- a/src/MicroOcpp/Operations/ClearCache.h
+++ b/src/MicroOcpp/Operations/ClearCache.h
@@ -18,11 +18,11 @@ class ClearCache : public Operation {
 public:
     ClearCache(std::shared_ptr<FilesystemAdapter> filesystem);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/ClearChargingProfile.h b/src/MicroOcpp/Operations/ClearChargingProfile.h
index cd4f9b44..e7befe8a 100644
--- a/src/MicroOcpp/Operations/ClearChargingProfile.h
+++ b/src/MicroOcpp/Operations/ClearChargingProfile.h
@@ -20,11 +20,11 @@ class ClearChargingProfile : public Operation {
 public:
     ClearChargingProfile(SmartChargingService& scService);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
     
 };
 
diff --git a/src/MicroOcpp/Operations/DataTransfer.h b/src/MicroOcpp/Operations/DataTransfer.h
index 0c9416fd..c8faa586 100644
--- a/src/MicroOcpp/Operations/DataTransfer.h
+++ b/src/MicroOcpp/Operations/DataTransfer.h
@@ -16,11 +16,11 @@ class DataTransfer : public Operation {
 public:
     DataTransfer(const std::string &msg);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
     
 };
 
diff --git a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
index a13bc36a..7dcd0b3b 100644
--- a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
+++ b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
@@ -18,11 +18,11 @@ class DiagnosticsStatusNotification : public Operation {
 public:
     DiagnosticsStatusNotification(DiagnosticsStatus status);
 
-    const char* getOperationType() {return "DiagnosticsStatusNotification"; }
+    const char* getOperationType() override {return "DiagnosticsStatusNotification"; }
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
 };
 
diff --git a/src/MicroOcpp/Operations/FirmwareStatusNotification.h b/src/MicroOcpp/Operations/FirmwareStatusNotification.h
index 11c1cadf..3e0feb97 100644
--- a/src/MicroOcpp/Operations/FirmwareStatusNotification.h
+++ b/src/MicroOcpp/Operations/FirmwareStatusNotification.h
@@ -19,11 +19,11 @@ class FirmwareStatusNotification : public Operation {
 public:
     FirmwareStatusNotification(FirmwareStatus status);
 
-    const char* getOperationType() {return "FirmwareStatusNotification"; }
+    const char* getOperationType() override {return "FirmwareStatusNotification"; }
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
 };
 
diff --git a/src/MicroOcpp/Operations/GetCompositeSchedule.h b/src/MicroOcpp/Operations/GetCompositeSchedule.h
index a54320c7..6e1d0fae 100644
--- a/src/MicroOcpp/Operations/GetCompositeSchedule.h
+++ b/src/MicroOcpp/Operations/GetCompositeSchedule.h
@@ -27,13 +27,13 @@ class GetCompositeSchedule : public Operation {
 public:
     GetCompositeSchedule(Model& model, SmartChargingService& scService);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return errorCode;}
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/GetConfiguration.h b/src/MicroOcpp/Operations/GetConfiguration.h
index eb4a63e7..b317d63c 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.h
+++ b/src/MicroOcpp/Operations/GetConfiguration.h
@@ -18,11 +18,11 @@ class GetConfiguration : public Operation {
 public:
     GetConfiguration();
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
 };
 
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.h b/src/MicroOcpp/Operations/GetDiagnostics.h
index beec2974..0c5cd16d 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.h
+++ b/src/MicroOcpp/Operations/GetDiagnostics.h
@@ -29,13 +29,13 @@ class GetDiagnostics : public Operation {
 public:
     GetDiagnostics(Model& model);
 
-    const char* getOperationType() {return "GetDiagnostics";}
+    const char* getOperationType() override {return "GetDiagnostics";}
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return formatError ? "FormationViolation" : nullptr;}
+    const char *getErrorCode() override {return formatError ? "FormationViolation" : nullptr;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.h b/src/MicroOcpp/Operations/GetLocalListVersion.h
index 08b0c6d3..90e6d099 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.h
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.h
@@ -19,11 +19,11 @@ class GetLocalListVersion : public Operation {
 public:
     GetLocalListVersion(Model& model);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/Heartbeat.h b/src/MicroOcpp/Operations/Heartbeat.h
index b9fd7e1a..23855e39 100644
--- a/src/MicroOcpp/Operations/Heartbeat.h
+++ b/src/MicroOcpp/Operations/Heartbeat.h
@@ -19,15 +19,15 @@ class Heartbeat : public Operation {
 public:
     Heartbeat(Model& model);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/MeterValues.h b/src/MicroOcpp/Operations/MeterValues.h
index 2d785e67..d778040f 100644
--- a/src/MicroOcpp/Operations/MeterValues.h
+++ b/src/MicroOcpp/Operations/MeterValues.h
@@ -32,15 +32,15 @@ class MeterValues : public Operation {
 
     ~MeterValues();
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.h b/src/MicroOcpp/Operations/RemoteStartTransaction.h
index 73fd6b9e..ea3e64d8 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.h
@@ -28,17 +28,17 @@ class RemoteStartTransaction : public Operation {
 public:
     RemoteStartTransaction(Model& model);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return errorCode;}
+    const char *getErrorCode() override {return errorCode;}
     const char *getErrorDescription() override {return errorDescription;}
 };
 
diff --git a/src/MicroOcpp/Operations/RemoteStopTransaction.h b/src/MicroOcpp/Operations/RemoteStopTransaction.h
index 96bd97a3..2f778957 100644
--- a/src/MicroOcpp/Operations/RemoteStopTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStopTransaction.h
@@ -20,11 +20,11 @@ class RemoteStopTransaction : public Operation {
 public:
     RemoteStopTransaction(Model& model);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/ReserveNow.h b/src/MicroOcpp/Operations/ReserveNow.h
index b3aa5fd0..ddaba236 100644
--- a/src/MicroOcpp/Operations/ReserveNow.h
+++ b/src/MicroOcpp/Operations/ReserveNow.h
@@ -23,13 +23,13 @@ class ReserveNow : public Operation {
 
     ~ReserveNow();
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return errorCode;}
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/Reset.h b/src/MicroOcpp/Operations/Reset.h
index db55b521..fd150fef 100644
--- a/src/MicroOcpp/Operations/Reset.h
+++ b/src/MicroOcpp/Operations/Reset.h
@@ -20,11 +20,11 @@ class Reset : public Operation {
 public:
     Reset(Model& model);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/SendLocalList.h b/src/MicroOcpp/Operations/SendLocalList.h
index cb3660ae..21f4b990 100644
--- a/src/MicroOcpp/Operations/SendLocalList.h
+++ b/src/MicroOcpp/Operations/SendLocalList.h
@@ -24,13 +24,13 @@ class SendLocalList : public Operation {
 
     ~SendLocalList();
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return errorCode;}
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/SetChargingProfile.h b/src/MicroOcpp/Operations/SetChargingProfile.h
index 2dc84ca4..3d0cb425 100644
--- a/src/MicroOcpp/Operations/SetChargingProfile.h
+++ b/src/MicroOcpp/Operations/SetChargingProfile.h
@@ -27,11 +27,11 @@ class SetChargingProfile : public Operation {
 
     ~SetChargingProfile();
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
     const char *getErrorDescription() override {return errorDescription;}
diff --git a/src/MicroOcpp/Operations/StartTransaction.h b/src/MicroOcpp/Operations/StartTransaction.h
index 59c68453..f4e22311 100644
--- a/src/MicroOcpp/Operations/StartTransaction.h
+++ b/src/MicroOcpp/Operations/StartTransaction.h
@@ -27,19 +27,19 @@ class StartTransaction : public Operation {
 
     ~StartTransaction();
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
     void initiate(StoredOperationHandler *opStore) override;
 
     bool restore(StoredOperationHandler *opStore) override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/StatusNotification.h b/src/MicroOcpp/Operations/StatusNotification.h
index cd82e3f8..74f329d6 100644
--- a/src/MicroOcpp/Operations/StatusNotification.h
+++ b/src/MicroOcpp/Operations/StatusNotification.h
@@ -22,15 +22,15 @@ class StatusNotification : public Operation {
 public:
     StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData = nullptr);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq();
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
 
-    void processConf(JsonObject payload);
+    void processConf(JsonObject payload) override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 const char *cstrFromOcppEveState(ChargePointStatus state);
diff --git a/src/MicroOcpp/Operations/TriggerMessage.h b/src/MicroOcpp/Operations/TriggerMessage.h
index b8cc8507..df77d42b 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.h
+++ b/src/MicroOcpp/Operations/TriggerMessage.h
@@ -26,13 +26,13 @@ class TriggerMessage : public Operation {
 public:
     TriggerMessage(Context& context);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() {return errorCode;}
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
index 9c207a5d..7489ad03 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.h
+++ b/src/MicroOcpp/Operations/UnlockConnector.h
@@ -25,11 +25,11 @@ class UnlockConnector : public Operation {
 public:
     UnlockConnector(Model& model);
 
-    const char* getOperationType();
+    const char* getOperationType() override;
 
-    void processReq(JsonObject payload);
+    void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf();
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.h b/src/MicroOcpp/Operations/UpdateFirmware.h
index 79b2954b..8c99a754 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.h
+++ b/src/MicroOcpp/Operations/UpdateFirmware.h
@@ -25,13 +25,13 @@ class UpdateFirmware : public Operation {
 public:
   UpdateFirmware(Model& model);
 
-  const char* getOperationType() {return "UpdateFirmware";}
+  const char* getOperationType() override {return "UpdateFirmware";}
 
-  void processReq(JsonObject payload);
+  void processReq(JsonObject payload) override;
 
-  std::unique_ptr<DynamicJsonDocument> createConf();
+  std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-  const char *getErrorCode() {if (formatError) return "FormationViolation"; else return NULL;}
+  const char *getErrorCode() override {if (formatError) return "FormationViolation"; else return NULL;}
 };
 
 } //end namespace Ocpp16

From 5d429ba47654f58d204b62408db7ffda69549cd7 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 29 Aug 2023 23:11:43 +0200
Subject: [PATCH 358/549] add simulator preview

---
 README.md | 24 +++++++++++++++++++-----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 287cdd05..46e4db0f 100644
--- a/README.md
+++ b/README.md
@@ -10,9 +10,9 @@ OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
 
-PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
+Technical introduction: [MicroOcpp Docs](https://matth-x.github.io/MicroOcpp/intro-tech)
 
-Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
+Try it (online): [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)
 
 Fully integrated into the Arduino platform and the ESP32 / ESP8266. Runs on ESP-IDF, FreeRTOS and generic embedded C/C++ platforms.
 
@@ -26,9 +26,7 @@ This library allows EVSEs to communicate with an OCPP Backend and to participate
 
 :heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
-Technical introduction: [MicroOcpp Docs](https://matth-x.github.io/MicroOcpp/intro-tech)
-
-Try it (no hardware required): [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)
+Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
 ### Features
 
@@ -41,8 +39,24 @@ Try it (no hardware required): [MicroOcppSimulator](https://github.com/matth-x/M
 
 The necessary hardware and internet integration is usually far below 1000 LOCs.
 
+## Demo App
+
+*Main repository: [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)*
+
+(Beta) The Simulator is a demo & development tool which allows to quickly assess the compatibility of MicroOcpp with OCPP backends. It simulates a full charging station, adds a GUI and basic controls to MicroOcpp and runs in the browser (using WebAssembly): [Try it](https://demo.micro-ocpp.com/)
+
+[![Screenshot](https://github.com/agruenb/arduino-ocpp-dashboard/blob/master/docs/img/status_page.png)](https://demo.micro-ocpp.com/)
+
+### Usage
+
+**OCPP server setup**: Navigate to "Control Center". In the WebSocket options, add the OCPP backend URL, charge box ID and authorization key if existent. Press "Update WebSocket" to save. The Simulator should connect to the OCPP server. To check the connection status, it could be helpful to open the developer tools of the browser.
+
+**RFID authentication**: Go to "Control Center" > "Connectors" > "Transaction" and update the idTag with the desired value.
+
 ## Developers guide
 
+PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
+
 Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h). Also check out the [Docs](https://matth-x.github.io/MicroOcpp).
 
 ### Dependencies

From 20677a310ce54e1a1f6ace76d5e874e9a654a20f Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 5 Sep 2023 13:13:07 +0200
Subject: [PATCH 359/549] add WebSocket address for demo app

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 46e4db0f..8e90d7b0 100644
--- a/README.md
+++ b/README.md
@@ -51,6 +51,8 @@ The necessary hardware and internet integration is usually far below 1000 LOCs.
 
 **OCPP server setup**: Navigate to "Control Center". In the WebSocket options, add the OCPP backend URL, charge box ID and authorization key if existent. Press "Update WebSocket" to save. The Simulator should connect to the OCPP server. To check the connection status, it could be helpful to open the developer tools of the browser.
 
+If you don't have an OCPP server at hand, leave the charge box ID blank and enter the following backend address: `wss://echo.websocket.events/` (this server is sponsored by Lob.com)
+
 **RFID authentication**: Go to "Control Center" > "Connectors" > "Transaction" and update the idTag with the desired value.
 
 ## Developers guide
@@ -73,7 +75,7 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 
 ## OCPP 2.0.1 and ISO 15118
 
-**The call for funding for the OCPP 2.0.1 upgrade has been opened.** The version 1.6 support has successfully been funded by private companies who share an interest in using this technology. OCPP is most often seen as a non-differentiating feature of chargers and is therefore perfectly suited for Open Source collaboration. If your company has an interest in the OCPP 2.0.1 upgrade, please use the contact details at the end of this page to receive a pitch with all advantages of joining the group of funders.
+**The call for funding for the OCPP 2.0.1 upgrade has been opened.** The version 1.6 support has successfully been funded by private companies who share an interest in using this technology. OCPP is most often seen as a non-differentiating feature of chargers and is therefore perfectly suited for Open Source collaboration. If your company has an interest in the OCPP 2.0.1 upgrade, please use the contact details at the end of this page to receive more details about all advantages of participating in the funding campaign.
 
 ISO 15118 will improve the security and user-friendliness of EV charging. MicroOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is already being validated at the moment. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
 

From 64e8803b4adfca591fce44bf59482d7605ea8832 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 10 Sep 2023 15:12:07 +0200
Subject: [PATCH 360/549] fix memory leaks in unit tests

---
 tests/Metering.cpp      | 2 +-
 tests/SmartCharging.cpp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 3e82ee41..cef49369 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -252,7 +252,7 @@ TEST_CASE("Metering") {
 
         loop();
 
-        model.getClock().setTime("2023-01-01T01:00:00Z");
+        getOcppContext()->getModel().getClock().setTime("2023-01-01T01:00:00Z");
 
         endTransaction();
 
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index 76b7f004..1887051d 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -117,7 +117,7 @@ TEST_CASE( "SmartCharging" ) {
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         setSmartChargingOutput([] (float, float, int) {});
-        scService = model.getSmartChargingService();
+        scService = getOcppContext()->getModel().getSmartChargingService();
 
         unsigned int count = 0;
         scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {

From 618d9ad583fd2e1100604b32a1e2303592c14446 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Mon, 11 Sep 2023 21:26:44 +0200
Subject: [PATCH 361/549] Update README.md

---
 README.md | 70 +++++++++++++++++++------------------------------------
 1 file changed, 24 insertions(+), 46 deletions(-)

diff --git a/README.md b/README.md
index 8e90d7b0..2cd30dd1 100644
--- a/README.md
+++ b/README.md
@@ -4,50 +4,27 @@
 [![Unit tests]( https://github.com/matth-x/MicroOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
 [![codecov](https://codecov.io/github/matth-x/ArduinoOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/ArduinoOcpp)
 
-**Formerly ArduinoOcpp ([migration guide](https://matth-x.github.io/MicroOcpp/migration/))**: *since the first release in 2020, ArduinoOcpp has increasingly been used on other platforms than Arduino. The goal of this project has evolved to fit seamlessly in a high variety of microcontroller firmwares and so the dependency on Arduino was dropped some time ago. The new name reflects the purpose of this project better and prevents potential confusion. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
-
-OCPP-J 1.6 client for embedded microcontrollers. Portable C/C++. Compatible with Espressif, NXP, Texas Instruments and STM.
-
-Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp)
-
-Technical introduction: [MicroOcpp Docs](https://matth-x.github.io/MicroOcpp/intro-tech)
+OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif, Arduino, NXP, STM and Linux and more.
 
-Try it (online): [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)
-
-Fully integrated into the Arduino platform and the ESP32 / ESP8266. Runs on ESP-IDF, FreeRTOS and generic embedded C/C++ platforms.
-
-## Make your EVSE ready for OCPP :car::electric_plug::battery:
+**Formerly ArduinoOcpp ([migration guide](https://matth-x.github.io/MicroOcpp/migration/))**: *since the first release in 2020, ArduinoOcpp has increasingly been used on other platforms than Arduino. The goal of this project has evolved to fit seamlessly in a high variety of microcontroller firmwares and so the dependency on Arduino was dropped some time ago. The new name reflects the purpose of this project better and prevents potential confusion. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
 
-This library allows EVSEs to communicate with an OCPP Backend and to participate in commercial charging networks. You can integrate it into an existing firmware development, or start a new EVSE project from scratch with it.
+Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
 :heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve) and [15+ commercial Central Systems](https://www.arduino-ocpp.com/#h.314525e8447cc93c_81)
 
-:heavy_check_mark: Tested in many charging stations
-
 :heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
-Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
-
-### Features
-
-- handles the OCPP communication with the charging network
-- implements the standard OCPP charging process
-- provides an API for the integration of the hardware modules of the EVSE
-- works with any TLS implementation and WebSocket library. E.g.
-   - Arduino networking stack: [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets), or
-   - generic embedded systems: [Mongoose Networking Library](https://github.com/cesanta/mongoose)
-
-The necessary hardware and internet integration is usually far below 1000 LOCs.
+:heavy_check_mark: Supports all OCPP 1.6 feature profiles
 
-## Demo App
+## Tester / Demo App
 
 *Main repository: [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)*
 
-(Beta) The Simulator is a demo & development tool which allows to quickly assess the compatibility of MicroOcpp with OCPP backends. It simulates a full charging station, adds a GUI and basic controls to MicroOcpp and runs in the browser (using WebAssembly): [Try it](https://demo.micro-ocpp.com/)
+(Beta) The Simulator is a demo & development tool for MicroOcpp which allows to quickly assess the compatibility with different OCPP backends. It simulates a full charging station, adds a GUI and a mocked hardware binding to MicroOcpp and runs in the browser (using WebAssembly): [Try it](https://demo.micro-ocpp.com/)
 
 [![Screenshot](https://github.com/agruenb/arduino-ocpp-dashboard/blob/master/docs/img/status_page.png)](https://demo.micro-ocpp.com/)
 
-### Usage
+#### Usage
 
 **OCPP server setup**: Navigate to "Control Center". In the WebSocket options, add the OCPP backend URL, charge box ID and authorization key if existent. Press "Update WebSocket" to save. The Simulator should connect to the OCPP server. To check the connection status, it could be helpful to open the developer tools of the browser.
 
@@ -59,6 +36,8 @@ If you don't have an OCPP server at hand, leave the charge box ID blank and ente
 
 PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
 
+MicroOcpp is an implementation of the OCPP communication behavior. It automatically initiates the corresponding OCPP operations once the hardware status changes or the RFID input is updated with a new value. Conversely it processes new data from the server, stores it locally and updates the hardware controls when applicable.
+
 Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h). Also check out the [Docs](https://matth-x.github.io/MicroOcpp).
 
 ### Dependencies
@@ -75,27 +54,26 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 
 ## OCPP 2.0.1 and ISO 15118
 
-**The call for funding for the OCPP 2.0.1 upgrade has been opened.** The version 1.6 support has successfully been funded by private companies who share an interest in using this technology. OCPP is most often seen as a non-differentiating feature of chargers and is therefore perfectly suited for Open Source collaboration. If your company has an interest in the OCPP 2.0.1 upgrade, please use the contact details at the end of this page to receive more details about all advantages of participating in the funding campaign.
+**The call for funding for the OCPP 2.0.1 upgrade is open.** The version 1.6 support has successfully been funded by private companies who share an interest in using this technology. OCPP is most often seen as a non-differentiating feature of chargers and is therefore perfectly suited for Open Source collaboration. If your company has an interest in the OCPP 2.0.1 upgrade, please use the contact details at the end of this page to receive more details about all advantages of participating in the funding campaign.
 
-ISO 15118 will improve the security and user-friendliness of EV charging. MicroOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is already being validated at the moment. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
+MicroOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is already being validated at the moment. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
 
-## Supported Feature Profiles
+## Related projects
 
-| Feature profile | supported | in progress |
-| -------------- | :---------: | :-----------: |
-| **Core** | :heavy_check_mark: |
-| **Smart charging** | :heavy_check_mark: |
-| **Remote trigger** | :heavy_check_mark: |
-| **Firmware management** | :heavy_check_mark: |
-| **Local auth list management** | :heavy_check_mark: |
-| **Reservation** | :heavy_check_mark: |
+Full EVSE operating systems:
+- [OpenEVSE](https://github.com/OpenEVSE/openevse_esp32_firmware)
+- [EVerest](https://github.com/EVerest/EVerest)
+- [SwitchEV](https://github.com/SwitchEV/josev)
 
-Fully OCPP 1.6 compliant :heavy_check_mark:
+OCPP RPC frameworks and protocol buffers:
+- [libocpp](https://github.com/EVerest/libocpp) (EVerest)
+- [Mobility House Python package](https://github.com/mobilityhouse/ocpp)
+- [Node.js module](https://github.com/mikuso/ocpp-rpc)
 
-## Further help
+*How is this OCPP lib different?* The scope of MicroOcpp matches the scope of the OCPP standard as close as possible. The standard defines the charger behavior to a large extend and the API of MicroOcpp ensures that the the charger behavior matches the OCPP messages precisely. This prevents compatibility breaks with different OCPP servers. Apart from that, MicroOcpp doesn't add any extra features like a web dashboard. *Full EVSE operating systems* do include everything which is needed on a charger. *OCPP RPC frameworks and protocol buffers* leave the OCPP communication behavior fully open to the vendor.
 
-I hope the given documentation and guidance can help you to successfully integrate an OCPP controller into your EVSE. If something needs clarification or if you have a question, please send me a message.
+## Contact details
 
-:envelope: : matthias [A⊤] arduino-ocpp [DО⊤] com
+I hope the given documentation and guidance can help you to successfully integrate an OCPP controller into your EVSE. I will be happy if you reach out!
 
-If you want professional assistance for your EVSE project, you can contact me as well. I'm looking forward to hearing about your ideas!
+:envelope: : matthias [A⊤] arduino-ocpp [DО⊤] com

From 8e3995b12fd22dcffa62b0ce3e5b6cd87c966634 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 12 Sep 2023 00:08:18 +0200
Subject: [PATCH 362/549] Update README.md

---
 README.md | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/README.md b/README.md
index 2cd30dd1..96487856 100644
--- a/README.md
+++ b/README.md
@@ -58,20 +58,6 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 
 MicroOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is already being validated at the moment. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
 
-## Related projects
-
-Full EVSE operating systems:
-- [OpenEVSE](https://github.com/OpenEVSE/openevse_esp32_firmware)
-- [EVerest](https://github.com/EVerest/EVerest)
-- [SwitchEV](https://github.com/SwitchEV/josev)
-
-OCPP RPC frameworks and protocol buffers:
-- [libocpp](https://github.com/EVerest/libocpp) (EVerest)
-- [Mobility House Python package](https://github.com/mobilityhouse/ocpp)
-- [Node.js module](https://github.com/mikuso/ocpp-rpc)
-
-*How is this OCPP lib different?* The scope of MicroOcpp matches the scope of the OCPP standard as close as possible. The standard defines the charger behavior to a large extend and the API of MicroOcpp ensures that the the charger behavior matches the OCPP messages precisely. This prevents compatibility breaks with different OCPP servers. Apart from that, MicroOcpp doesn't add any extra features like a web dashboard. *Full EVSE operating systems* do include everything which is needed on a charger. *OCPP RPC frameworks and protocol buffers* leave the OCPP communication behavior fully open to the vendor.
-
 ## Contact details
 
 I hope the given documentation and guidance can help you to successfully integrate an OCPP controller into your EVSE. I will be happy if you reach out!

From 7185fb515b326f8de21725f4380ef038b024742b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 13 Sep 2023 15:48:35 +0200
Subject: [PATCH 363/549] add compact debug msg option

---
 src/MicroOcpp/Debug.h | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/MicroOcpp/Debug.h b/src/MicroOcpp/Debug.h
index 6ab73ed5..b627abe0 100644
--- a/src/MicroOcpp/Debug.h
+++ b/src/MicroOcpp/Debug.h
@@ -19,9 +19,9 @@
 #endif
 
 #define MOCPP_DF_MINIMAL 0x00   //don't reveal origin of a debug message
-#define MOCPP_DF_MODULE_LINE 0x01 //print module by file name and line number
+#define MOCPP_DF_COMPACT 0x01   //print module by file name and line number
 #define MOCPP_DF_FILE_LINE 0x02 //print file and line number
-#define MOCPP_DF_FULL    0x03   //print path and file and line numbr
+#define MOCPP_DF_FULL 0x03      //print path and file and line numbr
 
 #ifndef MOCPP_DBG_FORMAT
 #define MOCPP_DBG_FORMAT MOCPP_DF_FILE_LINE //default
@@ -31,12 +31,11 @@
 #if MOCPP_DBG_FORMAT == MOCPP_DF_MINIMAL
 #define MOCPP_DBG(level, X)   \
     do {                        \
-        MOCPP_CONSOLE_PRINTF("[OCPP] ");           \
         MOCPP_CONSOLE_PRINTF X;  \
         MOCPP_CONSOLE_PRINTF("\n");         \
     } while (0);
 
-#elif MOCPP_DBG_FORMAT == MOCPP_DF_MODULE_LINE
+#elif MOCPP_DBG_FORMAT == MOCPP_DF_COMPACT
 #define MOCPP_DBG(level, X)   \
     do {                        \
         const char *_mo_file = __FILE__;         \
@@ -46,7 +45,7 @@
             _mo_l--;         \
             if (_mo_file[_mo_l] == '.') _mo_r = _mo_l;         \
         }         \
-        MOCPP_CONSOLE_PRINTF("[OCPP] %s (%.*s:%i): ",level, (int) (_mo_r - _mo_l), _mo_file + _mo_l,__LINE__);           \
+        MOCPP_CONSOLE_PRINTF("%.*s:%i ", (int) (_mo_r - _mo_l), _mo_file + _mo_l,__LINE__);           \
         MOCPP_CONSOLE_PRINTF X;  \
         MOCPP_CONSOLE_PRINTF("\n");         \
     } while (0);

From 8621f89be920440a6ea206df170931c2163db912 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 14 Sep 2023 12:11:36 +0200
Subject: [PATCH 364/549] stat workaround on arduino-esp32

---
 src/MicroOcpp/Core/FilesystemAdapter.cpp | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 6de8d5ef..7d026d9e 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -21,7 +21,6 @@
 
 #if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
 #include <LittleFS.h>
-#include <vfs_api.h>
 #define USE_FS LittleFS
 #elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
 #include <FS.h>
@@ -97,14 +96,6 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     operator bool() {return valid;}
 
     int stat(const char *path, size_t *size) override {
-#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
-        struct ::stat st;
-        auto ret = ::stat(path, &st);
-        if (ret == 0) {
-            *size = st.st_size;
-        }
-        return ret;
-#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
         if (!USE_FS.exists(path)) {
             return -1;
         }
@@ -124,9 +115,6 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
 
         f.close();
         return status;
-#else
-#error
-#endif
     } //end stat
 
     std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {

From dea20fd81b623eb77e282331609d94c83e5a47b2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 14 Sep 2023 13:04:12 +0200
Subject: [PATCH 365/549] fix stat on arduino-esp32

---
 src/MicroOcpp/Core/FilesystemAdapter.cpp | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 7d026d9e..b503d6b9 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -21,6 +21,7 @@
 
 #if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
 #include <LittleFS.h>
+#include <vfs_api.h>
 #define USE_FS LittleFS
 #elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
 #include <FS.h>
@@ -96,6 +97,20 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     operator bool() {return valid;}
 
     int stat(const char *path, size_t *size) override {
+#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
+        char partition_path [MOCPP_MAX_PATH_SIZE];
+        auto ret = snprintf(partition_path, MOCPP_MAX_PATH_SIZE, "/littlefs%s", path);
+        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
+            MOCPP_DBG_ERR("fn error: %i", ret);
+            return -1;
+        }
+        struct ::stat st;
+        auto status = ::stat(partition_path, &st);
+        if (status == 0) {
+            *size = st.st_size;
+        }
+        return status;
+#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
         if (!USE_FS.exists(path)) {
             return -1;
         }
@@ -115,6 +130,9 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
 
         f.close();
         return status;
+#else
+#error
+#endif
     } //end stat
 
     std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {

From cb27b491dc936951474d3440ef44de5ff93713f2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 14 Sep 2023 14:11:07 +0200
Subject: [PATCH 366/549] fix ftw on arduino-esp32

---
 src/MicroOcpp/Core/FilesystemAdapter.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index b503d6b9..580d23ee 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -159,7 +159,7 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
         while (auto entry = dir.openNextFile()) {
 
             char fname [MOCPP_MAX_PATH_SIZE];
-            auto ret = snprintf(fname, MOCPP_MAX_PATH_SIZE, "%s", entry.name() + strlen(MOCPP_FILENAME_PREFIX));
+            auto ret = snprintf(fname, MOCPP_MAX_PATH_SIZE, "%s", entry.name());
             entry.close();
 
             if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {

From c05bd1c17e4c22087d2f2ed8c5a135bb37c80f9e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 14 Sep 2023 14:32:44 +0200
Subject: [PATCH 367/549] limit auto-recovery

---
 src/MicroOcpp.cpp | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index d09fa363..b286fd19 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -146,9 +146,13 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         MOCPP_DBG_ERR("multiple initialization failures detected");
         if (filesystem) {
             bool success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
-                return strcmp(fname, "ws-conn.jsn");
+                return !strncmp(fname, "sd", strlen("sd")) ||
+                       !strncmp(fname, "tx", strlen("tx")) ||
+                       !strncmp(fname, "op", strlen("op")) ||
+                       !strncmp(fname, "sc-", strlen("sc-")) ||
+                       !strncmp(fname, "reservation", strlen("reservation"));
             });
-            MOCPP_DBG_ERR("clear local state folder (except WS creds): %s", success ? "success" : "not completed");
+            MOCPP_DBG_ERR("clear local state files (recovery): %s", success ? "success" : "not completed");
 
             bootstats = BootStats();
         }

From b6a702ee683392f3393f281497a0df8fb25e2194 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 14 Sep 2023 20:44:05 +0200
Subject: [PATCH 368/549] add valgrind, ASan, UBSan

---
 .github/workflows/tests.yml | 14 ++++++++++++--
 tests/ChargingSessions.cpp  |  4 +++-
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 886500d1..0a3df6c0 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -19,12 +19,12 @@ jobs:
     - name: Get build tools
       run: |
         sudo apt update
-        sudo apt install build-essential cmake lcov
+        sudo apt install build-essential cmake lcov valgrind
         sudo apt -y install gcc-9 g++-9
         g++ --version
         echo "g++ version must be 9.4.0"
     - name: Get ArduinoJson
-      run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
+      run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.21.3/ArduinoJson-v6.21.3.h -O ./src/ArduinoJson.h
     - name: Generate CMake build files
       run: cmake -S . -B ./build
     - name: Compile
@@ -33,6 +33,16 @@ jobs:
       run: mkdir mo_store
     - name: Run tests
       run: ./build/mo_unit_tests
+    - name: Run tests (valgrind)
+      run: valgrind --error-exitcode=1 --leak-check=full ./build/mo_unit_tests
+    - name: Generate CMake build files (AddressSanitizer, UndefinedBehaviorSanitizer)
+      run: |
+        rm -r ./build
+        cmake -S . -B ./build -DCMAKE_CXX_FLAGS="-fsanitize=address -fsanitize=undefined" -DCMAKE_EXE_LINKER_FLAGS="-fsanitize=address -fsanitize=undefined"
+    - name: Compile (ASan, UBSan)
+      run: cmake --build ./build -j 16 --target mo_unit_tests
+    - name: Run tests (ASan, UBSan)
+      run: ./build/mo_unit_tests
     - name: Create coverage report
       run: |
         lcov --directory . --capture --output-file coverage.info
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 494af7e4..40ed3087 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -37,7 +37,9 @@ TEST_CASE( "Charging sessions" ) {
     checkMsg.setOnRequest("StatusNotification",
         [&checkedSN, &expectedSN] (JsonObject request) {
             int connectorId = request["connectorId"] | -1;
-            checkedSN[connectorId] = !strcmp(request["status"] | "Invalid", expectedSN[connectorId]);
+            if (connectorId == 0 || connectorId == 1) { //only test single connector case here
+                checkedSN[connectorId] = !strcmp(request["status"] | "Invalid", expectedSN[connectorId]);
+            }
         });
 
     SECTION("Check idle state"){

From 7a72b6bc0579ccf0282160813c7a051a22f18841 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Thu, 14 Sep 2023 22:41:39 +0200
Subject: [PATCH 369/549] Update README.md

---
 README.md | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 96487856..baa58257 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
 
 OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif, Arduino, NXP, STM and Linux and more.
 
-**Formerly ArduinoOcpp ([migration guide](https://matth-x.github.io/MicroOcpp/migration/))**: *since the first release in 2020, ArduinoOcpp has increasingly been used on other platforms than Arduino. The goal of this project has evolved to fit seamlessly in a high variety of microcontroller firmwares and so the dependency on Arduino was dropped some time ago. The new name reflects the purpose of this project better and prevents potential confusion. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
+**Formerly ArduinoOcpp ([migration guide](https://matth-x.github.io/MicroOcpp/migration/))**: *the initial version of this library used the Arduino API but this dependency was dropped some time ago and the old name has become outdated. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
 
@@ -54,9 +54,21 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 
 ## OCPP 2.0.1 and ISO 15118
 
-**The call for funding for the OCPP 2.0.1 upgrade is open.** The version 1.6 support has successfully been funded by private companies who share an interest in using this technology. OCPP is most often seen as a non-differentiating feature of chargers and is therefore perfectly suited for Open Source collaboration. If your company has an interest in the OCPP 2.0.1 upgrade, please use the contact details at the end of this page to receive more details about all advantages of participating in the funding campaign.
+**The call for funding for the OCPP 2.0.1 upgrade is open.** The version 1.6 support has successfully been funded by private companies who share an interest in using this technology. OCPP is most often seen as a non-differentiating feature of chargers and is therefore perfectly suited for Open Source collaboration. If your company needs OCPP 2.0.1, please use the contact details at the end of this page to receive the more details about the funding plan and why it is beneficial to engage in the upgrade (for hardware manufacturers and CPOs).
 
-MicroOcpp facilitates the integration of ISO 15118 by handling its OCPP-side communication. This is already being validated at the moment. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
+MicroOcpp is a good foundation for starting the OCPP 2.0.1 development:
+
+:tada: Tested by hundreds, including backend operators. The [Simulator](https://github.com/matth-x/MicroOcppSimulator) encourages quick compatibility tests
+
+:hammer: Comes with development tools and a CI/CD specialized for OCPP
+
+:man_teacher: Academic background: started as a research project, evolved into enterprise software
+
+:closed_lock_with_key: Unit tests with valgrind, [AddressSanitizer](https://github.com/google/sanitizers/wiki/AddressSanitizer) and [UndefinedBehaviorSanitizer](https://clang.llvm.org/docs/UndefinedBehaviorSanitizer.html)
+
+:heart: Contributions are highly welcome. Open to building a team
+
+A note on ISO 15118: this library facilitates the integration of ISO 15118 by handling its OCPP-side communication. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
 
 ## Contact details
 

From bbde9450a344aece5fd29ea6932fbb2b0651ddf4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 15 Sep 2023 13:47:56 +0200
Subject: [PATCH 370/549] getLastConnected() to pure virtual fn

---
 src/MicroOcpp/Core/Connection.cpp | 11 +++++++++++
 src/MicroOcpp/Core/Connection.h   |  6 ++++--
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/src/MicroOcpp/Core/Connection.cpp b/src/MicroOcpp/Core/Connection.cpp
index 658fc31c..966d35ff 100644
--- a/src/MicroOcpp/Core/Connection.cpp
+++ b/src/MicroOcpp/Core/Connection.cpp
@@ -29,6 +29,17 @@ unsigned long LoopbackConnection::getLastRecv() {
     return lastRecv;
 }
 
+unsigned long LoopbackConnection::getLastConnected() {
+    return lastConn;
+}
+
+void LoopbackConnection::setConnected(bool connected) {
+    if (connected) {
+        lastConn = mocpp_tick_ms();
+    }
+    this->connected = connected;
+}
+
 #ifndef MOCPP_CUSTOM_WS
 
 using namespace MicroOcpp::EspWiFi;
diff --git a/src/MicroOcpp/Core/Connection.h b/src/MicroOcpp/Core/Connection.h
index 2513d85a..e4ac4b3a 100644
--- a/src/MicroOcpp/Core/Connection.h
+++ b/src/MicroOcpp/Core/Connection.h
@@ -53,7 +53,7 @@ class Connection {
     /*
      * Returns the timestamp of the last time a connection got successfully established. Use mocpp_tick_ms() for creating the correct timestamp
      */
-    virtual unsigned long getLastConnected() {return 0;}
+    virtual unsigned long getLastConnected() = 0;
 };
 
 class LoopbackConnection : public Connection {
@@ -62,13 +62,15 @@ class LoopbackConnection : public Connection {
 
     bool connected = true; //for simulating connection losses
     unsigned long lastRecv = 0;
+    unsigned long lastConn = 0;
 public:
     void loop() override;
     bool sendTXT(std::string &out) override;
     void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) override;
     unsigned long getLastRecv() override;
+    unsigned long getLastConnected() override;
 
-    void setConnected(bool connected) {this->connected = connected;}
+    void setConnected(bool connected);
     bool isConnected() {return connected;}
 };
 

From ef64c7b797e3493192bdae292e4b56517b1f8aaf Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 15 Sep 2023 17:10:24 +0200
Subject: [PATCH 371/549] replace std::string in Connection with c-string

---
 src/MicroOcpp/Core/Connection.cpp   |   6 +-
 src/MicroOcpp/Core/Connection.h     |   7 +-
 src/MicroOcpp/Core/RequestQueue.cpp |   4 +-
 tests/Api.cpp                       |   8 +--
 tests/ConfigurationBehavior.cpp     |   4 +-
 tests/SmartCharging.cpp             | 101 +++++++++++-----------------
 6 files changed, 51 insertions(+), 79 deletions(-)

diff --git a/src/MicroOcpp/Core/Connection.cpp b/src/MicroOcpp/Core/Connection.cpp
index 966d35ff..daba4485 100644
--- a/src/MicroOcpp/Core/Connection.cpp
+++ b/src/MicroOcpp/Core/Connection.cpp
@@ -9,13 +9,13 @@ using namespace MicroOcpp;
 
 void LoopbackConnection::loop() { }
 
-bool LoopbackConnection::sendTXT(std::string &out) {
+bool LoopbackConnection::sendTXT(const char *msg, size_t length) {
     if (!connected) {
         return false;
     }
     if (receiveTXT) {
         lastRecv = mocpp_tick_ms();
-        return receiveTXT(out.c_str(), out.length());
+        return receiveTXT(msg, length);
     } else {
         return false;
     }
@@ -52,7 +52,7 @@ void WSClient::loop() {
     wsock->loop();
 }
 
-bool WSClient::sendTXT(std::string &out) {
+bool WSClient::sendTXT(const char *msg, size_t length) {
     return wsock->sendTXT(out.c_str(), out.length());
 }
 
diff --git a/src/MicroOcpp/Core/Connection.h b/src/MicroOcpp/Core/Connection.h
index e4ac4b3a..27f095b6 100644
--- a/src/MicroOcpp/Core/Connection.h
+++ b/src/MicroOcpp/Core/Connection.h
@@ -7,7 +7,6 @@
 
 #include <functional>
 #include <memory>
-#include <string>
 
 #include <MicroOcpp/Platform.h>
 
@@ -37,7 +36,7 @@ class Connection {
     /*
      * The OCPP library calls this function for sending out OCPP messages to the server
      */
-    virtual bool sendTXT(std::string &out) = 0;
+    virtual bool sendTXT(const char *msg, size_t length) = 0;
 
     /*
      * The OCPP library calls this function once during initialization. It passes a callback function to
@@ -65,7 +64,7 @@ class LoopbackConnection : public Connection {
     unsigned long lastConn = 0;
 public:
     void loop() override;
-    bool sendTXT(std::string &out) override;
+    bool sendTXT(const char *msg, size_t length) override;
     void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) override;
     unsigned long getLastRecv() override;
     unsigned long getLastConnected() override;
@@ -92,7 +91,7 @@ class WSClient : public Connection {
 
     void loop();
 
-    bool sendTXT(std::string &out);
+    bool sendTXT(const char *msg, size_t length);
 
     void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT);
 
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index 1625415e..3f5e8704 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -62,7 +62,7 @@ void RequestQueue::loop(Connection& ocppSock) {
             std::string out;
             serializeJson(*response, out);
     
-            bool success = ocppSock.sendTXT(out);
+            bool success = ocppSock.sendTXT(out.c_str(), out.length());
 
             if (success) {
                 MOCPP_DBG_TRAFFIC_OUT(out.c_str());
@@ -113,7 +113,7 @@ void RequestQueue::loop(Connection& ocppSock) {
     std::string out;
     serializeJson(*request, out);
 
-    bool success = ocppSock.sendTXT(out);
+    bool success = ocppSock.sendTXT(out.c_str(), out.length());
 
     if (success) {
         MOCPP_DBG_TRAFFIC_OUT(out.c_str());
diff --git a/tests/Api.cpp b/tests/Api.cpp
index c1985076..215d7692 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -8,7 +8,7 @@
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
-#define SCPROFILE "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]";
+#define SCPROFILE "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]"
 
 TEST_CASE( "C++ API test" ) {
 
@@ -84,8 +84,7 @@ TEST_CASE( "C++ API test" ) {
         auto MeterValuesSampledData = MicroOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
         *MeterValuesSampledData = "Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered";
 
-        std::string out = SCPROFILE;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE, strlen(SCPROFILE));
 
         //run tx management
 
@@ -256,8 +255,7 @@ TEST_CASE( "C API test" ) {
         auto MeterValuesSampledData = MicroOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
         *MeterValuesSampledData = "Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered";
 
-        std::string out = SCPROFILE;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE, strlen(SCPROFILE));
 
         //run tx management
 
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index fa3c747c..ab85b8e4 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -183,8 +183,8 @@ TEST_CASE( "Configuration Behavior" ) {
         *localAuthListEnabled = true;
 
         //define local auth list with entry local-idtag
-        std::string localListMsg = "[2,\"testmsg-01\",\"SendLocalList\",{\"listVersion\":1,\"localAuthorizationList\":[{\"idTag\":\"local-idtag\",\"idTagInfo\":{\"status\":\"Accepted\"}}],\"updateType\":\"Full\"}]";
-        loopback.sendTXT(localListMsg);
+        const char *localListMsg = "[2,\"testmsg-01\",\"SendLocalList\",{\"listVersion\":1,\"localAuthorizationList\":[{\"idTag\":\"local-idtag\",\"idTagInfo\":{\"status\":\"Accepted\"}}],\"updateType\":\"Full\"}]";
+        loopback.sendTXT(localListMsg, strlen(localListMsg));
         loop();
 
         loopback.setConnected(false); //connection loss
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index 1887051d..acc821ab 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -11,27 +11,27 @@
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 
-#define SCPROFILE_0                            "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\",\"validFrom\":\"2022-06-12T00:00:00.000Z\",\"validTo\":\"2023-06-21T00:00:00.000Z\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-06-18T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":18000,\"limit\":32,\"numberPhases\":3}],\"minChargingRate\":6}}}]";
-#define SCPROFILE_0_ALT_SAME_ID                "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":1,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\",\"validFrom\":\"2022-06-12T00:00:00.000Z\",\"validTo\":\"2023-06-21T00:00:00.000Z\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-06-18T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":18000,\"limit\":32,\"numberPhases\":3}],\"minChargingRate\":6}}}]";
-#define SCPROFILE_0_ALT_SAME_STACKEVEL_PURPOSE "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":1,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\",\"validFrom\":\"2022-06-12T00:00:00.000Z\",\"validTo\":\"2023-06-21T00:00:00.000Z\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-06-18T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":18000,\"limit\":32,\"numberPhases\":3}],\"minChargingRate\":6}}}]";
+#define SCPROFILE_0                            "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\",\"validFrom\":\"2022-06-12T00:00:00.000Z\",\"validTo\":\"2023-06-21T00:00:00.000Z\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-06-18T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":18000,\"limit\":32,\"numberPhases\":3}],\"minChargingRate\":6}}}]"
+#define SCPROFILE_0_ALT_SAME_ID                "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":1,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\",\"validFrom\":\"2022-06-12T00:00:00.000Z\",\"validTo\":\"2023-06-21T00:00:00.000Z\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-06-18T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":18000,\"limit\":32,\"numberPhases\":3}],\"minChargingRate\":6}}}]"
+#define SCPROFILE_0_ALT_SAME_STACKEVEL_PURPOSE "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":1,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\",\"validFrom\":\"2022-06-12T00:00:00.000Z\",\"validTo\":\"2023-06-21T00:00:00.000Z\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-06-18T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":18000,\"limit\":32,\"numberPhases\":3}],\"minChargingRate\":6}}}]"
 
-#define SCPROFILE_1_ABSOLUTE_LIMIT_16A         "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":1,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]";
+#define SCPROFILE_1_ABSOLUTE_LIMIT_16A         "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":1,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]"
 
-#define SCPROFILE_2_RELATIVE_TXDEF_24A         "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":2,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Relative\",\"chargingSchedule\":{\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":24,\"numberPhases\":3}]}}}]";
+#define SCPROFILE_2_RELATIVE_TXDEF_24A         "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":2,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxDefaultProfile\",\"chargingProfileKind\":\"Relative\",\"chargingSchedule\":{\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":24,\"numberPhases\":3}]}}}]"
 
-#define SCPROFILE_3_TXPROF_TXID123_20A         "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":3,\"transactionId\":123,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxProfile\",\"chargingProfileKind\":\"Relative\",\"chargingSchedule\":{\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":20,\"numberPhases\":3}]}}}]";
+#define SCPROFILE_3_TXPROF_TXID123_20A         "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":1,\"csChargingProfiles\":{\"chargingProfileId\":3,\"transactionId\":123,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxProfile\",\"chargingProfileKind\":\"Relative\",\"chargingSchedule\":{\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":20,\"numberPhases\":3}]}}}]"
 
-#define SCPROFILE_4_VALID_FROM_2024_16A        "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":4,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"validFrom\":\"2024-01-01T00:00:00.000Z\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]";
-#define SCPROFILE_5_VALID_UNTIL_2022_16A       "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":5,\"stackLevel\":1,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"validTo\":  \"2022-01-01T00:00:00.000Z\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]";
+#define SCPROFILE_4_VALID_FROM_2024_16A        "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":4,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"validFrom\":\"2024-01-01T00:00:00.000Z\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]"
+#define SCPROFILE_5_VALID_UNTIL_2022_16A       "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":5,\"stackLevel\":1,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"validTo\":  \"2022-01-01T00:00:00.000Z\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]"
 
-#define SCPROFILE_6_MULTIPLE_PERIODS_16A_20A   "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":6,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":3600,\"limit\":20,\"numberPhases\":3}]}}}]";
+#define SCPROFILE_6_MULTIPLE_PERIODS_16A_20A   "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":6,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":3600,\"limit\":20,\"numberPhases\":3}]}}}]"
 
-#define SCPROFILE_7_RECURRING_DAY_2H_16A_20A   "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":7,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\", \"chargingSchedule\":{\"duration\":7200,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":3600,\"limit\":20,\"numberPhases\":3}]}}}]";
-#define SCPROFILE_8_RECURRING_WEEK_2H_10A_12A  "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":8,\"stackLevel\":1,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Weekly\",\"chargingSchedule\":{\"duration\":7200,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":10,\"numberPhases\":3},{\"startPeriod\":3600,\"limit\":12,\"numberPhases\":3}]}}}]";
+#define SCPROFILE_7_RECURRING_DAY_2H_16A_20A   "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":7,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Daily\", \"chargingSchedule\":{\"duration\":7200,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3},{\"startPeriod\":3600,\"limit\":20,\"numberPhases\":3}]}}}]"
+#define SCPROFILE_8_RECURRING_WEEK_2H_10A_12A  "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":8,\"stackLevel\":1,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Recurring\",\"recurrencyKind\":\"Weekly\",\"chargingSchedule\":{\"duration\":7200,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":10,\"numberPhases\":3},{\"startPeriod\":3600,\"limit\":12,\"numberPhases\":3}]}}}]"
 
-#define SCPROFILE_9_VIA_RMTSTARTTX_20A         "[2,\"testmsg\",\"RemoteStartTransaction\",{\"connectorId\":1,\"idTag\":\"mIdTag\",\"chargingProfile\":{\"chargingProfileId\":9,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxProfile\",\"chargingProfileKind\":\"Relative\",\"chargingSchedule\":{\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":20,\"numberPhases\":1}]}}}]";
+#define SCPROFILE_9_VIA_RMTSTARTTX_20A         "[2,\"testmsg\",\"RemoteStartTransaction\",{\"connectorId\":1,\"idTag\":\"mIdTag\",\"chargingProfile\":{\"chargingProfileId\":9,\"stackLevel\":0,\"chargingProfilePurpose\":\"TxProfile\",\"chargingProfileKind\":\"Relative\",\"chargingSchedule\":{\"chargingRateUnit\":\"A\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":20,\"numberPhases\":1}]}}}]"
 
-#define SCPROFILE_10_ABSOLUTE_LIMIT_5KW        "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":10,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":5000,\"numberPhases\":3}]}}}]";
+#define SCPROFILE_10_ABSOLUTE_LIMIT_5KW        "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":10,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":5000,\"numberPhases\":3}]}}}]"
 
 
 using namespace MicroOcpp;
@@ -78,8 +78,7 @@ TEST_CASE( "SmartCharging" ) {
 
         REQUIRE(count == 0);
 
-        std::string out = SCPROFILE_0;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_0, strlen(SCPROFILE_0));
 
         //check if filter works by comparing the outcome of returning false and true and repeating the test
         count = 0;
@@ -109,8 +108,7 @@ TEST_CASE( "SmartCharging" ) {
 
     SECTION("Charging Profiles persistency over reboots") {
 
-        std::string out = SCPROFILE_0;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_0, strlen(SCPROFILE_0));
 
         mocpp_deinitialize();
 
@@ -130,11 +128,9 @@ TEST_CASE( "SmartCharging" ) {
 
     SECTION("Set conflicting profile") {
 
-        std::string out = SCPROFILE_0;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_0, strlen(SCPROFILE_0));
 
-        out = SCPROFILE_0_ALT_SAME_ID;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_0_ALT_SAME_ID, strlen(SCPROFILE_0_ALT_SAME_ID));
 
         unsigned int count = 0;
         scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
@@ -144,11 +140,9 @@ TEST_CASE( "SmartCharging" ) {
 
         REQUIRE(count == 1);
 
-        out = SCPROFILE_0;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_0, strlen(SCPROFILE_0));
 
-        out = SCPROFILE_0_ALT_SAME_STACKEVEL_PURPOSE;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_0_ALT_SAME_STACKEVEL_PURPOSE, strlen(SCPROFILE_0_ALT_SAME_STACKEVEL_PURPOSE));
 
         count = 0;
         scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
@@ -168,8 +162,7 @@ TEST_CASE( "SmartCharging" ) {
 
         loop();
 
-        std::string out = SCPROFILE_9_VIA_RMTSTARTTX_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_9_VIA_RMTSTARTTX_20A, strlen(SCPROFILE_9_VIA_RMTSTARTTX_20A));
 
         loop();
 
@@ -187,8 +180,7 @@ TEST_CASE( "SmartCharging" ) {
             current = limit_current;
         });
 
-        std::string out = SCPROFILE_1_ABSOLUTE_LIMIT_16A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_1_ABSOLUTE_LIMIT_16A, strlen(SCPROFILE_1_ABSOLUTE_LIMIT_16A));
 
         loop();
 
@@ -202,8 +194,7 @@ TEST_CASE( "SmartCharging" ) {
             current = limit_current;
         });
         
-        std::string out = SCPROFILE_2_RELATIVE_TXDEF_24A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_2_RELATIVE_TXDEF_24A, strlen(SCPROFILE_2_RELATIVE_TXDEF_24A));
 
         loop();
 
@@ -230,8 +221,7 @@ TEST_CASE( "SmartCharging" ) {
         });
         
         //send before transaction - expect rejection
-        std::string out = SCPROFILE_3_TXPROF_TXID123_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_3_TXPROF_TXID123_20A, strlen(SCPROFILE_3_TXPROF_TXID123_20A));
 
         unsigned int count = 0;
         scService->clearChargingProfile([&count] (int, int, ChargingProfilePurposeType, int) {
@@ -245,8 +235,7 @@ TEST_CASE( "SmartCharging" ) {
         beginTransaction_authorized("mIdTag");
 
         //send during transaction but wrong txId - expect rejection
-        out = SCPROFILE_3_TXPROF_TXID123_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_3_TXPROF_TXID123_20A, strlen(SCPROFILE_3_TXPROF_TXID123_20A));
 
         loop();
 
@@ -261,8 +250,7 @@ TEST_CASE( "SmartCharging" ) {
         getTransaction()->setTransactionId(123);
 
         //send during tx with matchin txId - accept
-        out = SCPROFILE_3_TXPROF_TXID123_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_3_TXPROF_TXID123_20A, strlen(SCPROFILE_3_TXPROF_TXID123_20A));
 
         loop();
 
@@ -289,11 +277,9 @@ TEST_CASE( "SmartCharging" ) {
             current = limit_current;
         });
         
-        std::string out = SCPROFILE_4_VALID_FROM_2024_16A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_4_VALID_FROM_2024_16A, strlen(SCPROFILE_4_VALID_FROM_2024_16A));
 
-        out = SCPROFILE_5_VALID_UNTIL_2022_16A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_5_VALID_UNTIL_2022_16A, strlen(SCPROFILE_5_VALID_UNTIL_2022_16A));
 
         loop();
 
@@ -314,8 +300,7 @@ TEST_CASE( "SmartCharging" ) {
             current = limit_current;
         });
 
-        std::string out = SCPROFILE_6_MULTIPLE_PERIODS_16A_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_6_MULTIPLE_PERIODS_16A_20A, strlen(SCPROFILE_6_MULTIPLE_PERIODS_16A_20A));
 
         loop();
 
@@ -336,8 +321,7 @@ TEST_CASE( "SmartCharging" ) {
             current = limit_current;
         });
 
-        std::string out = SCPROFILE_7_RECURRING_DAY_2H_16A_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_7_RECURRING_DAY_2H_16A_20A, strlen(SCPROFILE_7_RECURRING_DAY_2H_16A_20A));
 
         loop();
 
@@ -365,8 +349,7 @@ TEST_CASE( "SmartCharging" ) {
             current = limit_current;
         });
 
-        std::string out = SCPROFILE_8_RECURRING_WEEK_2H_10A_12A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_8_RECURRING_WEEK_2H_10A_12A, strlen(SCPROFILE_8_RECURRING_WEEK_2H_10A_12A));
 
         loop();
 
@@ -394,11 +377,9 @@ TEST_CASE( "SmartCharging" ) {
             current = limit_current;
         });
 
-        std::string out = SCPROFILE_7_RECURRING_DAY_2H_16A_20A; //stackLevel: 0
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_7_RECURRING_DAY_2H_16A_20A, strlen(SCPROFILE_7_RECURRING_DAY_2H_16A_20A)); //stackLevel: 0
 
-        out = SCPROFILE_8_RECURRING_WEEK_2H_10A_12A; //stackLevel: 1
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_8_RECURRING_WEEK_2H_10A_12A, strlen(SCPROFILE_8_RECURRING_WEEK_2H_10A_12A)); //stackLevel: 1
 
         loop();
 
@@ -437,13 +418,11 @@ TEST_CASE( "SmartCharging" ) {
 
         loop();
 
-        std::string out = SCPROFILE_9_VIA_RMTSTARTTX_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_9_VIA_RMTSTARTTX_20A, strlen(SCPROFILE_9_VIA_RMTSTARTTX_20A));
 
         loop();
 
-        out = SCPROFILE_1_ABSOLUTE_LIMIT_16A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_1_ABSOLUTE_LIMIT_16A, strlen(SCPROFILE_1_ABSOLUTE_LIMIT_16A));
 
         loop();
 
@@ -466,13 +445,11 @@ TEST_CASE( "SmartCharging" ) {
 
         loop();
 
-        std::string out = SCPROFILE_9_VIA_RMTSTARTTX_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_9_VIA_RMTSTARTTX_20A, strlen(SCPROFILE_9_VIA_RMTSTARTTX_20A));
 
         loop();
 
-        out = SCPROFILE_10_ABSOLUTE_LIMIT_5KW;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_10_ABSOLUTE_LIMIT_5KW, strlen(SCPROFILE_10_ABSOLUTE_LIMIT_5KW));
 
         loop();
 
@@ -486,8 +463,7 @@ TEST_CASE( "SmartCharging" ) {
 
     SECTION("Get composite schedule") {
 
-        std::string out = SCPROFILE_6_MULTIPLE_PERIODS_16A_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_6_MULTIPLE_PERIODS_16A_20A, strlen(SCPROFILE_6_MULTIPLE_PERIODS_16A_20A));
 
         bool checkProcessed = false;
 
@@ -538,8 +514,7 @@ TEST_CASE( "SmartCharging" ) {
 
     SECTION("Get composite schedule with definition gap") {
 
-        std::string out = SCPROFILE_7_RECURRING_DAY_2H_16A_20A;
-        loopback.sendTXT(out);
+        loopback.sendTXT(SCPROFILE_7_RECURRING_DAY_2H_16A_20A, strlen(SCPROFILE_7_RECURRING_DAY_2H_16A_20A));
 
         auto schedule = scService->getCompositeSchedule(1, 86401);
 

From de3c532385a09ac651044665799ac9d2f01ac4dd Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 16 Sep 2023 12:38:24 +0200
Subject: [PATCH 372/549] Config optimiziation initial draft

---
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp | 495 +++++++++++++------
 src/MicroOcpp/Core/ConfigurationKeyValue.h   | 122 ++---
 2 files changed, 394 insertions(+), 223 deletions(-)

diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index 9e97ff95..a75ffe26 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -10,7 +10,11 @@
 #include <ArduinoJson.h>
 
 #define KEY_MAXLEN 60
-#define STRING_VAL_MAXLEN 2000 //allow TLS certificates in ...
+#define STRING_VAL_MAXLEN 512
+
+#ifndef MOCPP_CONFIG_TYPECHECK
+#define MOCPP_CONFIG_TYPECHECK 1 //enable this for debugging
+#endif
 
 namespace MicroOcpp {
 
@@ -27,233 +31,416 @@ int toCStringValue(char *buf, size_t length, bool value) {
     return snprintf(buf, length, "%s", value ? "true" : "false");
 }
 
-AbstractConfiguration::AbstractConfiguration(const char *key) {
-    if (!key || !*key) {
-        MOCPP_DBG_ERR("invalid argument");
-        return;
-    }
 
-    this->key = key;
+
+uint16_t Configuration::getValueRevision() {
+    return value_revision;
 }
 
-AbstractConfiguration::~AbstractConfiguration() {
+void Configuration::setRequiresReboot() {
+    rebootRequired = true;
+}
 
+bool Configuration::getRequiresReboot() {
+    return rebootRequired;
 }
 
-const char *AbstractConfiguration::getKey() {
-    return key.c_str();
+void Configuration::revokeWritePermission() {
+    writePermission = false;
 }
 
-size_t AbstractConfiguration::getStorageHeaderJsonCapacity() {
-    return key.length() + 1;
+bool Configuration::getWritePermission() {
+    return writePermission;
 }
 
-void AbstractConfiguration::storeStorageHeader(JsonObject &keyValuePair) {
-    keyValuePair["key"] = key;
+void Configuration::revokeReadPermission() {
+    readPermission = false;
 }
 
-size_t AbstractConfiguration::getOcppMsgHeaderJsonCapacity() {
-    return key.size() + 1;
+bool Configuration::getReadPermission() {
+    return readPermission;
 }
 
-void AbstractConfiguration::storeOcppMsgHeader(JsonObject &keyValuePair) {
-    keyValuePair["key"] = key;
-    if (remotePeerCanWrite) {
-        keyValuePair["readonly"] = false;
-    } else {
-        keyValuePair["readonly"] = true;
-    }
+void Configuration::setValidator(std::function<bool(const char*)> validator) {
+    this->validator = validator;
 }
 
-bool AbstractConfiguration::isValid() {
-    return initializedValue && !key.empty();
+std::function<bool(const char*)> Configuration::getValidator() {
+    return validator;
 }
 
-void AbstractConfiguration::requireRebootWhenChanged() {
-    rebootRequiredWhenChanged = true;
+namespace ConfigHelpers {
+
+bool initKey(const char *dest, const char *src) {
+    dest = src;
+    return true;
 }
 
-bool AbstractConfiguration::requiresRebootWhenChanged() {
-    return rebootRequiredWhenChanged;
+bool initKey(char *dest, const char *src) {
+    size_t len = strlen(src);
+    dest = (char*) malloc(len + 1);
+    if (!dest) {
+        return false;
+    }
+    strcpy(dest, src);
+    return true;
 }
 
-uint16_t AbstractConfiguration::getValueRevision() {
-    return value_revision;
+void deinitKey(const char *key) {
+    (void)key;
+}
+
+void deinitKey(char *key) {
+    free(key);
 }
 
 template<class T>
-Configuration<T>::Configuration(const char *key, T value) : AbstractConfiguration(key) {
-    this->operator=(value);
+void deinitValue(T) { }
+
+template<>
+void deinitValue(char *val) {
+    free(val);
 }
 
-template <class T>
-const T &Configuration<T>::operator=(const T & newVal) {
+template<class T>
+T getNull();
 
-    if (permissionLocalClientCanWrite() || !initializedValue) {
-        if (!initializedValue) {
-            const size_t VALUE_MAXSIZE = 50;
-            char value_str [VALUE_MAXSIZE] = {'\0'};
-            toCStringValue(value_str, VALUE_MAXSIZE, newVal);
-            MOCPP_DBG_DEBUG("add config: key = %s, value = %s", getKey(), value_str);
-        }
-        if (initializedValue == true && value != newVal) {
-            value_revision++;
-        }
-        value = newVal;
-        initializedValue = true;
-    } else {
-        MOCPP_DBG_ERR("Tried to override read-only configuration: %s", getKey());
-    }
-    return newVal;
+template<>
+int getNull() {return 0;}
+
+template<>
+float getNull() {return 0.f;}
+
+template<>
+char *getNull() {return nullptr;}
+
+template<>
+const char *getNull() {return nullptr;}
+
+template<class T, class U>
+T as(U) {return getNull<T>();}
+
+template<>
+int as(int v) {return v;}
+
+template<>
+float as(float v) {return v;}
+
+template<>
+const char *as(char *v) {return v;}
+
+template<>
+const char *as(const char *v) {return v;}
+
+
+template<class T>
+struct TConfigType {
+    static TConfig get() {return TConfig::None;}
+};
+
+template<> struct TConfigType<int> {static TConfig get() {return TConfig::Int;}};
+template<> struct TConfigType<float> {static TConfig get() {return TConfig::Float;}};
+template<> struct TConfigType<const char*> {static TConfig get() {return TConfig::String;}};
+template<> struct TConfigType<bool> {static TConfig get() {return TConfig::Bool;}};
+
+} //end namespace ConfigHelpers
+
+
+template<class K, class T>
+ConfigConcrete<K,T>::ConfigConcrete() {
+    key = nullptr;
+    val = ConfigHelpers::getNull<T>();
 }
 
-template <class T>
-Configuration<T>::operator T() {
-    return value;
+template<class K, class T>
+ConfigConcrete<K,T>::~ConfigConcrete() {
+    ConfigHelpers::deinitKey(key);
 }
 
-template<class T>
-bool Configuration<T>::isValid() {
-    return AbstractConfiguration::isValid();
+template<class K, class T>
+ConfigConcrete<K,T>::ConfigConcrete() {
+
 }
 
-template<class T>
-size_t Configuration<T>::getValueJsonCapacity() {
-    return 0;
+template<class K, class T>
+ConfigConcrete<K,T>::ConfigConcrete() {
+
 }
 
-size_t Configuration<const char *>::getValueJsonCapacity() {
-    return value.size() + 1;
+template<class K, class T>
+ConfigConcrete<K,T>::ConfigConcrete() {
+
 }
 
-template<class T>
-std::unique_ptr<DynamicJsonDocument> Configuration<T>::toJsonStorageEntry() {
-    if (!isValid()) {
-        return nullptr;
+template<class K, class T>
+ConfigConcrete<K,T>::~ConfigConcrete() {
+    ConfigHelpers::deinitKey(key);
+}
+
+template<class K, class T>
+bool ConfigConcrete<K,T>::setKey(const char *key) {
+    return ConfigHelpers::initKey(this->key, key);
+}
+
+template<class K, class T>
+const char *ConfigConcrete<K,T>::getKey() {
+    return key;
+}
+
+template<class K, class T>
+int ConfigConcrete<K,T>::getInt() {
+#if MOCPP_CONFIG_TYPECHECK
+    if (getType() != TConfig::Int) {
+        MOCPP_DBG_ERR("type err");
     }
-    size_t capacity = getStorageHeaderJsonCapacity()
-                + getValueJsonCapacity()
-                + JSON_OBJECT_SIZE(3); //type, header, value
-    
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
-    JsonObject keyValuePair = doc->to<JsonObject>();
-    keyValuePair["type"] = SerializedType<T>::get();
-    storeStorageHeader(keyValuePair);
-    keyValuePair["value"] = value;
-    return doc;
+#endif
+    return ConfigHelpers::as<int>(val);
 }
 
-template<class T>
-std::unique_ptr<DynamicJsonDocument> Configuration<T>::toJsonOcppMsgEntry() {
-    if (!isValid()) {
-        return nullptr;
+template<class K, class T>
+bool ConfigConcrete<K,T>::getBool() {
+#if MOCPP_CONFIG_TYPECHECK
+    if (getType() != TConfig::Bool) {
+        MOCPP_DBG_ERR("type err");
     }
-    size_t capacity = getOcppMsgHeaderJsonCapacity()
-                + JSON_OBJECT_SIZE(3); //header (key + readonly), value
+#endif
+    return ConfigHelpers::as<bool>(val);
+}
 
-    const size_t VALUE_MAXSIZE = 50;
-    char value_str [VALUE_MAXSIZE] = {'\0'};
-    toCStringValue(value_str, VALUE_MAXSIZE, value);
-    capacity += strlen(value_str) + 1;
-    
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
-    JsonObject keyValuePair = doc->to<JsonObject>();
-    storeOcppMsgHeader(keyValuePair);
-    keyValuePair["value"] = value_str;
-    return doc;
+template<class K, class T>
+const char *ConfigConcrete<K,T>::getString() {
+#if MOCPP_CONFIG_TYPECHECK
+    if (getType() != TConfig::String) {
+        MOCPP_DBG_ERR("type err");
+    }
+#endif
+    return ConfigHelpers::as<const char*>(val);
 }
 
-std::unique_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonStorageEntry() {
-    if (!isValid()) {
-        return nullptr;
+template<class K, class T>
+void ConfigConcrete<K,T>::setInt(int v) {
+#if MOCPP_CONFIG_TYPECHECK
+    if (getType() != TConfig::Int) {
+        MOCPP_DBG_ERR("type err");
     }
-    size_t capacity = getStorageHeaderJsonCapacity()
-                + getValueJsonCapacity()
-                + JSON_OBJECT_SIZE(3); //type, header, value
-    
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
-    JsonObject keyValuePair = doc->to<JsonObject>();
-    keyValuePair["type"] = SerializedType<const char *>::get();
-    storeStorageHeader(keyValuePair);
-    keyValuePair["value"] = value;
-    return doc;
+#endif
+    value_revision++;
+    val = ConfigHelpers::as<T>(v);
 }
 
-std::unique_ptr<DynamicJsonDocument> Configuration<const char *>::toJsonOcppMsgEntry() {
-    if (!isValid()) {
-        return nullptr;
+template<class K, class T>
+void ConfigConcrete<K,T>::setBool(bool v) {
+#if MOCPP_CONFIG_TYPECHECK
+    if (getType() != TConfig::Bool) {
+        MOCPP_DBG_ERR("type err");
     }
-    size_t capacity = getOcppMsgHeaderJsonCapacity()
-                + getValueJsonCapacity()
-                + JSON_OBJECT_SIZE(3); //header (key + readonly), value
-    
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
-    JsonObject keyValuePair = doc->to<JsonObject>();
-    storeOcppMsgHeader(keyValuePair);
-    keyValuePair["value"] = value;
-    return doc;
+#endif
+    value_revision++;
+    val = ConfigHelpers::as<T>(v);
 }
 
-Configuration<const char *>::Configuration(const char *key, const char *value) : AbstractConfiguration(key) {
-    if (!value) {
-        MOCPP_DBG_ERR("invalid args");
-        return;
+template<class K, class T>
+bool ConfigConcrete<K,T>::setString(const char *src) {
+#if MOCPP_CONFIG_TYPECHECK
+    if (getType() != TConfig::String) {
+        MOCPP_DBG_ERR("type err");
+    }
+#endif
+    value_revision++;
+    auto dest = ConfigHelpers::as<char*>(val);
+    if (dest) {
+        free(dest);
+        dest = nullptr;
     }
+    if (src && dest) {
+        size_t len = strlen(src);
+        dest = (char*) malloc(len + 1);
+        if (!dest) {
+            return false;
+        }
+        strcpy(dest, src);
+    }
+    return true;
+}
 
-    this->operator=(value);
+template<class K, class T>
+TConfig ConfigConcrete<K,T>::getType() {
+    return ConfigHelpers::TConfigType<T>::get();
 }
 
-Configuration<const char *>::~Configuration() {
 
+bool deserializeTConfig(TConfig& out, const char *serialized) {
+    if (!strcmp(serialized, "int")) {
+        out = TConfig::Int;
+    } else if (!strcmp(serialized, "bool")) {
+        out = TConfig::Bool;
+    } else if (!strcmp(serialized, "string")) {
+        out = TConfig::String;
+    } else {
+        out = TConfig::None;
+        MOCPP_DBG_WARN("config type error");
+    }
+    return out;
+}
+
+const char *serializeTConfig(TConfig type) {
+    switch (type) {
+        case (TConfig::Int):
+            return "int";
+        case (TConfig::Bool):
+            return "bool";
+        case (TConfig::String):
+            return "string";
+        case (TConfig::None):
+            MOCPP_DBG_WARN("config type error");
+            return "undefined";
+    }
 }
 
-const char *Configuration<const char *>::operator=(const char *new_value) {
-    if (!new_value) {
-        MOCPP_DBG_ERR("invalid args");
-        return new_value;
+std::unique_ptr<Configuration> deserializeConfigInternal(JsonObject stored) {
+    
+    TConfig ctype = TConfig::None;
+    if (!deserializeTConfig(ctype, stored["type"] | "_Undefined") || ctype == TConfig::None) {
+        return nullptr;
     }
 
-    if (!permissionLocalClientCanWrite() && initializedValue) {
-        MOCPP_DBG_ERR("Tried to override read-only configuration: %s", getKey());
-        return new_value;
+    if (!stored.containsKey("value")) {
+        return nullptr;
     }
 
-    if (value.compare(new_value) || !initializedValue) {
-        value = new_value;
-        value_revision++;
+    std::unique_ptr<Configuration> res;
+
+    switch (ctype) {
+        case (TConfig::Int):
+            if (!stored["value"].is<int>()) {
+                return nullptr;
+            }
+            res = std::unique_ptr<ConfigConcrete<char*,int>>(new ConfigConcrete<char*,int>());
+            if (!res) {
+                return nullptr;
+            }
+            res->setInt(stored["value"] | 0);
+            break;
+        case (TConfig::Bool):
+            if (!stored["value"].is<bool>()) {
+                return nullptr;
+            }
+            res = std::unique_ptr<ConfigConcrete<char*,bool>>(new ConfigConcrete<char*,bool>());
+            if (!res) {
+                return nullptr;
+            }
+            res->setBool(stored["value"] | false);
+            break;
+        case (TConfig::String):
+            if (!stored["value"].is<const char*>()) {
+                return nullptr;
+            }
+            res = std::unique_ptr<ConfigConcrete<char*,const char*>>(new ConfigConcrete<char*,const char*>());
+            if (!res) {
+                return nullptr;
+            }
+            res->setString(stored["value"] | "");
+            break;
+        case (TConfig::None):
+            return nullptr;
     }
     
-    if (!initializedValue) {
-        MOCPP_DBG_DEBUG("add config: key = %s, value = %s", getKey(), value.c_str());
-        (void)0;
+    const char *key = stored["key"] | "";
+    if (!*key) {
+        return nullptr;
     }
-    initializedValue = true;
-    return new_value;
-}
 
-Configuration<const char *>::operator const char*() {
-    return value.c_str();
-}
+    if (!res->setKey(key)) {
+        return nullptr;
+    }
 
-bool Configuration<const char *>::isValid() {
-    return AbstractConfiguration::isValid();
+    return res;
 }
 
-size_t Configuration<const char *>::getBuffsize() {
-    return value.size() + 1;
-}
+bool serializeConfigInternal(Configuration& config, JsonObject out) {
 
-void Configuration<const char *>::setValidator(std::function<bool(const char*)> validator) {
-    this->validator = validator;
+    out["key"] = config.getKey();
+    
+    switch (config.getType()) {
+        case TConfig::Int:
+            out["type"] = "int";
+            out["value"] = config.getInt();
+            break;
+        case TConfig::Bool:
+            out["type"] = "bool";
+            out["value"] = config.getBool();
+            break;
+        case TConfig::String:
+            out["type"] = "string";
+            out["value"] = config.getString();
+            break;
+        case TConfig::None:
+            MOCPP_DBG_ERR("invalid config");
+            out.clear();
+            return false;
+            break;
+    }
+
+    return true;
 }
 
-std::function<bool(const char*)> Configuration<const char *>::getValidator() {
-    return this->validator;
+bool serializeConfigOcpp(Configuration& config, DynamicJsonDocument& out) {
+
+    const size_t PRIMITIVE_VALUESIZE = 30;
+    char vbuf [PRIMITIVE_VALUESIZE];
+    const char *v = vbuf;
+    size_t vcapacity = 0;
+    switch(config.getType()) {
+        case TConfig::Int: {
+            auto ret = snprintf(valuebuf, PRIMITIVE_VALUESIZE, "%i", config.getInt());
+            if (ret < 0 || ret >= PRIMITIVE_VALUESIZE) {
+                return false;
+            }
+            v = vbuf;
+            vcapacity = ret;
+            break;
+        }
+        case TConfig::Bool: {
+            v = config.getBool() ? "true" : "false";
+            vcapacity = 0;
+            break;
+        }
+        case TConfig::String: {
+            v = config.getString();
+            if (!v) {
+                MOCPP_DBG_ERR("invalid config");
+                return nullptr;
+            }
+            vcapacity = 0;
+            break;
+        }
+        case TConfig::None: {
+            MOCPP_DBG_ERR("invalid config");
+            return false;
+        }
+    }
+
+    out.reset(JSON_OBJECT_SIZE(3) + vcapacity);
+
+    out["key"] = config.getKey();
+    out["readonly"] = !config.getWritePermission();
+    if (vcapacity > 0) {
+        //value has capacity, copy string
+        out["value"] = (char*) v;
+    } else {
+        //value is static, no-copy mode
+        out["value"] = v;
+    }
+
+    return true;
 }
 
-template class Configuration<int>;
-template class Configuration<float>;
-template class Configuration<bool>;
+template class ConfigConcrete<char*,int>;
+template class ConfigConcrete<char*,bool>;
+template class ConfigConcrete<char*,const char*>;
+template class ConfigConcrete<const char*,int>;
+template class ConfigConcrete<const char*,bool>;
+template class ConfigConcrete<const char*,const char*>;
 //template class Configuration<const char *>; //no effect after explicit specialization
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index e2e8ab48..e1c99882 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -12,98 +12,82 @@
 
 namespace MicroOcpp {
 
-class AbstractConfiguration {
-private:
-    std::string key;
+enum TConfig : uint8_t {
+    None,
+    Int,
+    Float,
+    String,
+    Bool
+};
 
-    bool rebootRequiredWhenChanged = false;
+class Configuration {
+private:
+    std::function<bool(const char*)> validator;
 
-    bool remotePeerCanWrite = true;
-    bool remotePeerCanRead = true;
-    bool localClientCanWrite = true;
+    bool rebootRequired = false;
+    bool writePermission = true;
+    bool readPermission = true;
 protected:
-    uint16_t value_revision = 0; //number of memory-relevant changes of subclass-member "value" (deleting counts too). This will be important for the client to detect if there was a change
-    bool initializedValue = false;
+    uint16_t value_revision = 0;
+public:
 
-    AbstractConfiguration(const char *key);
-    size_t getStorageHeaderJsonCapacity();
-    void storeStorageHeader(JsonObject &keyValuePair);
-    size_t getOcppMsgHeaderJsonCapacity();
-    void storeOcppMsgHeader(JsonObject &keyValuePair);
-    bool isValid();
+    virtual const char *getKey() = 0;
 
-    bool permissionLocalClientCanWrite() {return localClientCanWrite;}
-public:
-    virtual ~AbstractConfiguration();
-    const char *getKey();
+    virtual void setInt(int) = 0;
+    virtual void setBool(bool) = 0;
+    virtual bool setString(const char*) = 0;
 
-    void requireRebootWhenChanged();
-    bool requiresRebootWhenChanged();
+    virtual int getInt() = 0;
+    virtual bool getBool() = 0;
+    virtual const char *getString() = 0;
 
-    uint16_t getValueRevision();
+    virtual TConfig getType() = 0;
 
-    virtual std::unique_ptr<DynamicJsonDocument> toJsonStorageEntry() = 0;
-    virtual std::unique_ptr<DynamicJsonDocument> toJsonOcppMsgEntry() = 0;
+    uint16_t getValueRevision(); 
 
-    virtual const char *getSerializedType() = 0;
+    void setRequiresReboot();
+    bool getRequiresReboot();
 
-    bool permissionRemotePeerCanWrite() {return remotePeerCanWrite;}
-    bool permissionRemotePeerCanRead() {return remotePeerCanRead;}
-    void revokePermissionRemotePeerCanWrite() {remotePeerCanWrite = false;}
-    void revokePermissionRemotePeerCanRead() {remotePeerCanRead = false;}
-    void revokePermissionLocalClientCanWrite() {localClientCanWrite = false;}
-};
+    void revokeWritePermission();
+    bool getWritePermission();
 
+    void revokeReadPermission();
+    bool getReadPermission();
 
-template<class T>
-struct SerializedType {
-    static const char *get() {return "undefined";}
+    void setValidator(std::function<bool(const char*)> validator);
+    std::function<bool(const char*)> getValidator();
 };
 
-template<> struct SerializedType<int> {static const char *get() {return "int";}};
-template<> struct SerializedType<float> {static const char *get() {return "float";}};
-template<> struct SerializedType<bool> {static const char *get() {return "bool";}};
-template<> struct SerializedType<const char*> {static const char *get() {return "string";}};
-
-template <class T>
-class Configuration : public AbstractConfiguration {
+template<class K, class T>
+class ConfigConcrete : public Configuration {
 private:
-    T value;
-    size_t getValueJsonCapacity();
+    K key;
+    T val;
 public:
-    Configuration(const char *key, T value);
-    const T &operator=(const T & newVal);
-    operator T();
-    bool isValid();
 
-    std::unique_ptr<DynamicJsonDocument> toJsonStorageEntry();
-    std::unique_ptr<DynamicJsonDocument> toJsonOcppMsgEntry();
+    ConfigConcrete();
 
-    const char *getSerializedType() {return SerializedType<T>::get();} //returns "int" or "float" as written to the configuration Json file
-};
+    ~ConfigConcrete() {
+        ConfigHelpers::deinitKey(key);
+    }
 
-template <>
-class Configuration<const char *> : public AbstractConfiguration {
-private:
-    std::string value;
-    size_t getValueJsonCapacity();
+    bool setKey(const char *key);
 
-    std::function<bool(const char*)> validator;
-public:
-    Configuration(const char *key, const char *value);
-    ~Configuration();
-    const char *operator=(const char *newVal);
-    operator const char*();
-    bool isValid();
-    size_t getBuffsize();
+    const char *getKey() override;
 
-    std::unique_ptr<DynamicJsonDocument> toJsonStorageEntry();
-    std::unique_ptr<DynamicJsonDocument> toJsonOcppMsgEntry();
+    int getInt() override;
 
-    const char *getSerializedType() {return SerializedType<const char *>::get();}
+    bool getBool() override;
 
-    void setValidator(std::function<bool(const char*)> validator);
-    std::function<bool(const char*)> getValidator();
+    const char *getString() override;
+
+    void setInt(int v) override;
+
+    void setBool(bool v) override;
+
+    bool setString(const char *v) override;
+
+    TConfig getType() override;
 };
 
 } //end namespace MicroOcpp

From 8944c708b74b11afe183a844a6a68f6b0d53b747 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 17 Sep 2023 21:02:07 +0200
Subject: [PATCH 373/549] Configuration optimized memory layout (draft)

---
 src/MicroOcpp/Core/Configuration.cpp          | 188 ++-----
 src/MicroOcpp/Core/Configuration.h            |  16 +-
 src/MicroOcpp/Core/ConfigurationContainer.cpp | 119 +++--
 src/MicroOcpp/Core/ConfigurationContainer.h   |  55 +-
 .../Core/ConfigurationContainerFlash.cpp      | 335 +++++++++----
 .../Core/ConfigurationContainerFlash.h        |  14 +-
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp  | 474 +++++++-----------
 src/MicroOcpp/Core/ConfigurationKeyValue.h    |  89 ++--
 src/MicroOcpp/Operations/GetConfiguration.cpp |   1 +
 9 files changed, 624 insertions(+), 667 deletions(-)

diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index 7cae2967..c25dc7dc 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -12,60 +12,33 @@
 
 namespace MicroOcpp {
 
-std::shared_ptr<FilesystemAdapter> filesystem;
-
-template<class T>
-std::shared_ptr<Configuration<T>> createConfiguration(const char *key, T value) {
-
-    if (!key || !*key) {
-        MOCPP_DBG_ERR("invalid args");
-        return nullptr;
-    }
+namespace ConfigurationLocal {
 
-    std::shared_ptr<Configuration<T>> configuration = std::make_shared<Configuration<T>>(key, value);
+std::shared_ptr<FilesystemAdapter> filesystem;
+std::vector<std::shared_ptr<ConfigurationContainer>> configurationContainers;
 
-    return configuration;
 }
 
-std::shared_ptr<Configuration<const char *>> createConfiguration(const char *key, const char *value) {
-
-    if (!key || !*key || !value) {
-        MOCPP_DBG_ERR("invalid args");
-        return nullptr;
-    }
-
-    std::shared_ptr<Configuration<const char*>> configuration = std::make_shared<Configuration<const char*>>(key, value);
-
-    return configuration;
-}
+using namespace ConfigurationLocal;
 
-std::unique_ptr<ConfigurationContainer> createConfigurationContainer(const char *filename) {
+std::unique_ptr<ConfigurationContainer> createConfigurationContainer(const char *filename, bool accessible) {
     //create non-persistent Configuration store (i.e. lives only in RAM) if
     //     - Flash FS usage is switched off OR
     //     - Filename starts with "/volatile"
     if (!filesystem ||
                  !strncmp(filename, CONFIGURATION_VOLATILE, strlen(CONFIGURATION_VOLATILE))) {
-        return std::unique_ptr<ConfigurationContainer>(new ConfigurationContainerVolatile(filename));
+        return makeConfigurationContainerVolatile(filename, accessible);
     } else {
-        //create persistent Configuration store. This is the normal caseS
-        return std::unique_ptr<ConfigurationContainer>(new ConfigurationContainerFlash(filesystem, filename));
+        //create persistent Configuration store. This is the normal case
+        return makeConfigurationContainerFlash(filesystem, filename, accessible);
     }
 }
 
-std::vector<std::shared_ptr<ConfigurationContainer>> configurationContainers;
 
 void addConfigurationContainer(std::shared_ptr<ConfigurationContainer> container) {
     configurationContainers.push_back(container);
 }
 
-std::vector<std::shared_ptr<ConfigurationContainer>>::iterator getConfigurationContainersBegin() {
-    return configurationContainers.begin();
-}
-
-std::vector<std::shared_ptr<ConfigurationContainer>>::iterator getConfigurationContainersEnd() {
-    return configurationContainers.end();
-}
-
 std::shared_ptr<ConfigurationContainer> getContainer(const char *filename) {
     std::vector<std::shared_ptr<ConfigurationContainer>>::iterator container = std::find_if(configurationContainers.begin(), configurationContainers.end(),
         [filename](std::shared_ptr<ConfigurationContainer> &elem) {
@@ -80,139 +53,86 @@ std::shared_ptr<ConfigurationContainer> getContainer(const char *filename) {
 }
 
 template<class T>
-std::shared_ptr<Configuration<T>> declareConfiguration(const char *key, T defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged) {
-    //already existent? --> stored in last session --> do set default content, but set writepermission flag
-    
-    std::shared_ptr<ConfigurationContainer> container = getContainer(filename);
+std::shared_ptr<Configuration> declareConfiguration(const char *key, T factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible) {
+
+    auto container = getContainer(filename);
     
     if (!container) {
         MOCPP_DBG_DEBUG("init new configurations container: %s", filename);
 
-        container = createConfigurationContainer(filename);
+        container = createConfigurationContainer(filename, accessible);
+        if (!container) {
+            MOCPP_DBG_ERR("OOM");
+            return nullptr;
+        }
         configurationContainers.push_back(container);
 
         if (!container->load()) {
             MOCPP_DBG_WARN("Cannot load file contents. Path will be overwritten");
+            (void)0;
         }
     }
 
-    std::shared_ptr<AbstractConfiguration> configuration = container->getConfiguration(key);
-
-    if (configuration && strcmp(configuration->getSerializedType(), SerializedType<T>::get())) {
-        MOCPP_DBG_ERR("conflicting declared types for %s. Discard old config", key);
-        container->removeConfiguration(configuration);
-        configuration = nullptr;
+    if (container->isAccessible() != accessible) {
+        MOCPP_DBG_ERR("key %s: declared %s but config file is %s", key, accessible ? "accessible" : "inaccessible", container->isAccessible() ? "accessible" : "inaccessible");
+        (void)0;
     }
 
-    std::shared_ptr<Configuration<T>> configurationConcrete = std::static_pointer_cast<Configuration<T>>(configuration);
-
-    if (!configurationConcrete) {
-        configurationConcrete = createConfiguration<T>(key, defaultValue);
-        configuration = std::static_pointer_cast<AbstractConfiguration>(configurationConcrete);
+    std::shared_ptr<Configuration> configuration;
 
-        if (!configuration) {
-            MOCPP_DBG_ERR("Cannot find configuration stored from previous session and cannot create new one! Abort");
-            return nullptr;
-        }
-        container->addConfiguration(configuration);
+    switch (convertType<T>()) {
+        case TConfig::Int:
+            configuration = container->declareConfigurationInt(key, factoryDef, readonly, rebootRequired);
+            break;
+        case TConfig::Bool:
+            configuration = container->declareConfigurationBool(key, factoryDef, readonly, rebootRequired);
+            break;
+        case TConfig::String:
+            configuration = container->declareConfigurationString(key, factoryDef, readonly, rebootRequired);
+            break;
     }
 
-    if (!remotePeerCanWrite)
-        configuration->revokePermissionRemotePeerCanWrite();
-    if (!remotePeerCanRead)
-        configuration->revokePermissionRemotePeerCanRead();
-    if (!localClientCanWrite)
-        configuration->revokePermissionLocalClientCanWrite();
-    if (rebootRequiredWhenChanged)
-        configuration->requireRebootWhenChanged();
-
-    return configurationConcrete;
+    return configuration;
 }
 
-namespace Ocpp16 {
-
-std::shared_ptr<AbstractConfiguration> getConfiguration(const char *key) {
-    std::shared_ptr<AbstractConfiguration> result = nullptr;
-
-    for (auto container = configurationContainers.begin(); container != configurationContainers.end(); container++) {
-        result = (*container)->getConfiguration(key);
-        if (result)
-            return result;
+Configuration *getConfigurationPublic(const char *key) {
+    for (auto& container : configurationContainers) {
+        if (container->isAccessible()) {
+            if (auto res = container->getConfiguration(key)) {
+                return res;
+            }
+        }
     }
+
     return nullptr;
 }
 
-std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> getAllConfigurations() { //TODO maybe change to iterator?
-    auto result = std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>>(
-                              new std::vector<std::shared_ptr<AbstractConfiguration>>()
-    );
+std::vector<ConfigurationContainer*> getConfigurationContainersPublic() {
+    std::vector<ConfigurationContainer*> res;
 
-    for (auto container = configurationContainers.begin(); container != configurationContainers.end(); container++) {
-        for (auto config = (*container)->configurationsIteratorBegin(); config != (*container)->configurationsIteratorEnd(); config++) {
-            if ((*config)->permissionRemotePeerCanRead()) {
-                result->push_back(*config);
-            }
+    for (auto& container : configurationContainers) {
+        if (container->isAccessible()) {
+            res.push_back(container.get());
         }
     }
 
-    return result;
+    return res;
 }
 
-} //end namespace Ocpp16
-
-bool configuration_inited = false;
-
 bool configuration_init(std::shared_ptr<FilesystemAdapter> _filesystem) {
-    if (configuration_inited)
-        return true; //configuration_init() already called; tolerate multiple calls so user can use this store for
-                     //credentials outside MicroOcpp which need to be loaded before mocpp_initialize()
-    
     filesystem = _filesystem;
-
-    if (!filesystem) {
-        configuration_inited = true;
-        return true; //no filesystem, nothing can go wrong
-    }
-
-    std::shared_ptr<ConfigurationContainer> containerDefault = nullptr;
-    for (auto container = configurationContainers.begin(); container != configurationContainers.end(); container++) {
-        if (!strcmp((*container)->getFilename(), CONFIGURATION_FN)) {
-            containerDefault = (*container);
-            break;
-        }
-    }
-
-    bool success = true;
-
-    if (containerDefault) {
-        MOCPP_DBG_DEBUG("Found default container before calling configuration_init(). If you added");
-        MOCPP_DBG_DEBUG(" > the container manually, please ensure to call load(). If not, it is a hint");
-        MOCPP_DBG_DEBUG(" > that declareConfiguration() was called too early");
-        (void)0;
-    } else {
-        containerDefault = createConfigurationContainer(CONFIGURATION_FN);
-        if (!containerDefault->load()) {
-            MOCPP_DBG_ERR("Loading default configurations file failed");
-            success = false;
-        }
-        configurationContainers.push_back(containerDefault);
-    }
-
-    configuration_inited = success;
-    return success;
 }
 
 void configuration_deinit() {
     configurationContainers.clear();
     filesystem.reset();
-    configuration_inited = false;
 }
 
 bool configuration_save() {
     bool success = true;
 
-    for (auto container = configurationContainers.begin(); container != configurationContainers.end(); container++) {
-        if (!(*container)->save()) {
+    for (auto& container : configurationContainers) {
+        if (!container->save()) {
             success = false;
         }
     }
@@ -220,14 +140,8 @@ bool configuration_save() {
     return success;
 }
 
-template std::shared_ptr<Configuration<int>> createConfiguration(const char *key, int value);
-template std::shared_ptr<Configuration<float>> createConfiguration(const char *key, float value);
-template std::shared_ptr<Configuration<bool>> createConfiguration(const char *key, bool value);
-template std::shared_ptr<Configuration<const char *>> createConfiguration(const char *key, const char * value);
-
-template std::shared_ptr<Configuration<int>> declareConfiguration(const char *key, int defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
-template std::shared_ptr<Configuration<float>> declareConfiguration(const char *key, float defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
-template std::shared_ptr<Configuration<bool>> declareConfiguration(const char *key, bool defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
-template std::shared_ptr<Configuration<const char *>> declareConfiguration(const char *key, const char *defaultValue, const char *filename, bool remotePeerCanWrite, bool remotePeerCanRead, bool localClientCanWrite, bool rebootRequiredWhenChanged);
+template std::shared_ptr<Configuration> declareConfiguration<int>(const char *key, int factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible);
+template std::shared_ptr<Configuration> declareConfiguration<bool>(const char *key, bool factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible);
+template std::shared_ptr<Configuration> declareConfiguration<const char*>(const char *key, const char *factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible);
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index fe12de14..1b70ac8f 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -6,7 +6,6 @@
 #define CONFIGURATION_H
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
-#include <MicroOcpp/Core/ConfigurationOptions.h>
 #include <MicroOcpp/Core/ConfigurationContainerFlash.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 
@@ -23,19 +22,16 @@
 
 namespace MicroOcpp {
 
+/*
+ * 
+ */
 template <class T>
-std::shared_ptr<Configuration<T>> declareConfiguration(const char *key, T defaultValue, const char *filename = CONFIGURATION_FN, bool remotePeerCanWrite = true, bool remotePeerCanRead = true, bool localClientCanWrite = true, bool rebootRequiredWhenChanged = false);
+std::shared_ptr<Configuration> declareConfiguration(const char *key, T defaultValue, const char *filename = CONFIGURATION_FN, bool readonly = false, bool rebootRequired = false, bool accessible = true);
 
 void addConfigurationContainer(std::shared_ptr<ConfigurationContainer> container);
-std::vector<std::shared_ptr<ConfigurationContainer>>::iterator getConfigurationContainersBegin();
-std::vector<std::shared_ptr<ConfigurationContainer>>::iterator getConfigurationContainersEnd();
 
-
-namespace Ocpp16 {
-
-    std::shared_ptr<AbstractConfiguration> getConfiguration(const char *key);
-    std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> getAllConfigurations();
-}
+Configuration *getConfigurationPublic(const char *key);
+std::vector<ConfigurationContainer*> getConfigurationContainersPublic();
 
 bool configuration_init(std::shared_ptr<FilesystemAdapter> filesytem);
 void configuration_deinit();
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index b3e4041a..4d0f2afd 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -4,71 +4,106 @@
 
 #include <MicroOcpp/Core/ConfigurationContainer.h>
 
+#include <MicroOcpp/Debug.h>
+
 namespace MicroOcpp {
 
-std::shared_ptr<AbstractConfiguration> ConfigurationContainer::getConfiguration(const char *key) {
-    for (std::vector<std::shared_ptr<AbstractConfiguration>>::iterator configuration = configurations.begin(); configuration != configurations.end(); configuration++) {
-        if (!strcmp(key, (*configuration)->getKey())) {
-            return *configuration;
+std::shared_ptr<Configuration> ConfigurationPool::getConfiguration_typesafe(const char *key, TConfig type) {
+    for (auto entry = configurations.begin(); entry != configurations.end();entry++) {
+        if ((*entry)->getKey() && !strcmp((*entry)->getKey(), key)) {
+            //found entry
+            if ((*entry)->getType() == type) {
+                return *entry;
+            } else {
+                MOCPP_DBG_ERR("conflicting types for %s - discard old config", key);
+                configurations.erase(entry);
+                break;
+            }
         }
     }
     return nullptr;
 }
 
-bool ConfigurationContainer::removeConfiguration(std::shared_ptr<AbstractConfiguration> configuration) {
+template<class T>
+std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration(const char *key, T factoryDef, bool readonly = false, bool rebootRequired = false) {
     
-    auto config = configurations.begin();
-    auto config_rev = configurations_revision.begin();
-    while (config != configurations.end()) {
-        if ((*config) == configuration) {
-            configurations.erase(config);
-            if (config_rev != configurations_revision.end())
-                configurations_revision.erase(config_rev);
-            return true;
+    std::shared_ptr<Configuration> res = getConfiguration_typesafe(key, convertType<T>());
+
+    if (!res) {
+        //config doesn't exist yet
+        res = makeConfigInt(key, factoryDef);
+        if (!res) {
+            //allocation failure - OOM
+            MOCPP_DBG_ERR("OOM");
+            return nullptr;
         }
-        config++;
-        if (config_rev != configurations_revision.end())
-            config_rev++;
+        configurations.push_back(res);
     }
 
-    return false;
-}
+    if (readonly) {
+        res->setReadOnly();
+    }
+
+    if (rebootRequired) {
+        res->setRequiresReboot();
+    }
 
-void ConfigurationContainer::addConfiguration(std::shared_ptr<AbstractConfiguration> configuration) {
-    configurations.push_back(configuration);
+    return res;
 }
 
-bool ConfigurationContainer::configurationsUpdated() {
-    bool updated = false;
+size_t ConfigurationPool::getConfigurationCount() const {
+        return configurations.size();
+    }
 
-    auto config = configurations.begin();
-    auto config_rev = configurations_revision.begin();
-    while (config != configurations.end()) {
-        if (config_rev == configurations_revision.end()) {
-            //vectors are not the same length -> added configurations
-            updated = true;
-            break;
-        }
+Configuration *ConfigurationPool::getConfiguration(size_t i) const {
+    return configurations[i].get();
+}
 
-        if ((*config)->getValueRevision() != *config_rev) {
-            updated = true;
-            break;
+Configuration *ConfigurationPool::getConfiguration(const char *key) const {
+    for (auto& entry : configurations) {
+        if (!strcmp(entry->getKey(), key)) {
+            return entry.get();
         }
+    }
+}
 
-        config++;
-        config_rev++;
+class ConfigurationContainerVolatile : public ConfigurationContainer {
+private:
+    ConfigurationPool container;
+public:
+    ConfigurationContainerVolatile(const char *filename, bool accessible) : ConfigurationContainer(filename, accessible) { }
+
+    bool load() override {return true;}
+
+    bool save() override {return true;}
+
+    std::shared_ptr<Configuration> declareConfigurationInt(const char *key, int factoryDef, bool readonly = false, bool rebootRequired = false) override {
+        return container.declareConfiguration<int>(key, factoryDef, readonly, rebootRequired);
     }
 
-    if (updated) {
-        configurations_revision.erase(config_rev, configurations_revision.end());
+    std::shared_ptr<Configuration> declareConfigurationBool(const char *key, bool factoryDef, bool readonly = false, bool rebootRequired = false) override {
+        return container.declareConfiguration<bool>(key, factoryDef, readonly, rebootRequired);
+    }
 
-        while (config != configurations.end()) {
-            configurations_revision.push_back((*config)->getValueRevision());
-            config++;
-        }
+    std::shared_ptr<Configuration> declareConfigurationString(const char *key, const char*factoryDef, bool readonly = false, bool rebootRequired = false) override {
+        return container.declareConfiguration<const char*>(key, factoryDef, readonly, rebootRequired);
+    }
+
+    size_t getConfigurationCount() override {
+        return container.getConfigurationCount();
+    }
+
+    Configuration *getConfiguration(size_t i) override {
+        return container.getConfiguration(i);
+    }
+
+    Configuration *getConfiguration(const char *key) override {
+        return container.getConfiguration(key);
     }
+};
 
-    return updated;
+std::unique_ptr<ConfigurationContainer> makeConfigurationContainerVolatile(const char *filename, bool accessible) {
+    return std::unique_ptr<ConfigurationContainer>(new ConfigurationContainerVolatile(filename, accessible));
 }
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index 0a6ac509..0c504fb1 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -14,41 +14,52 @@ namespace MicroOcpp {
 
 class ConfigurationContainer {
 private:
-    std::vector<uint16_t> configurations_revision;
     const char *filename;
-
-protected:
-    std::vector<std::shared_ptr<AbstractConfiguration>> configurations;
-
-    ConfigurationContainer(const char *filename) : filename(filename) { }
-
-    //Checks if configurations_revision is equal to (for all) configurations->getValueRevision(). If not, it refreshes the record
-    bool configurationsUpdated();
+    bool accessible;
 public:
-    virtual ~ConfigurationContainer() = default;
+    ConfigurationContainer(const char *filename, bool accessible) : filename(filename), accessible(accessible) { }
 
-    virtual bool load() = 0;
+    const char *getFilename() {return filename;}
+    bool isAccessible() {return accessible;}
 
+    virtual bool load() = 0; //called at the end of mocpp_intialize, to load the configurations with the stored value
     virtual bool save() = 0;
 
-    const char *getFilename() {return filename;};
-
-    std::shared_ptr<AbstractConfiguration> getConfiguration(const char *key);
-    std::vector<std::shared_ptr<AbstractConfiguration>>::iterator configurationsIteratorBegin() {return configurations.begin();}
-    std::vector<std::shared_ptr<AbstractConfiguration>>::iterator configurationsIteratorEnd() {return configurations.end();}
-    bool removeConfiguration(std::shared_ptr<AbstractConfiguration> configuration);
-    void addConfiguration(std::shared_ptr<AbstractConfiguration> configuration);
+    virtual std::shared_ptr<Configuration> declareConfigurationInt(const char *key, int factoryDef, bool readonly = false, bool rebootRequired = false) = 0;
+    virtual std::shared_ptr<Configuration> declareConfigurationBool(const char *key, bool factoryDef, bool readonly = false, bool rebootRequired = false) = 0;
+    virtual std::shared_ptr<Configuration> declareConfigurationString(const char *key, const char *factoryDef, bool readonly = false, bool rebootRequired = false) = 0;
+    
+    virtual size_t getConfigurationCount() = 0;
+    virtual Configuration *getConfiguration(size_t i) = 0;
+    virtual Configuration *getConfiguration(const char *key) = 0;
 };
 
-class ConfigurationContainerVolatile : public ConfigurationContainer {
+//Utils class only used for internal ConfigurationContainer implementations
+class ConfigurationPool {
+private:
+    std::vector<std::shared_ptr<Configuration>> configurations;
+
+    std::shared_ptr<Configuration> getConfiguration_typesafe(const char *key, TConfig type);
+
 public:
-    ConfigurationContainerVolatile(const char *filename) : ConfigurationContainer(filename) { }
+    template<class T>
+    std::shared_ptr<Configuration> declareConfiguration(const char *key, T factoryDef, bool readonly = false, bool rebootRequired = false);
+    
+    std::vector<std::shared_ptr<Configuration>>& getConfigurations();
+    
+    size_t getConfigurationCount() const;
 
-    bool load() {return true;}
+    Configuration *getConfiguration(size_t i) const;
 
-    bool save() {return true;}
+    Configuration *getConfiguration(const char *key) const;
 };
 
+template<> std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<int>(const char *key, int factoryDef, bool readonly, bool rebootRequired);
+template<> std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<bool>(const char *key, bool factoryDef, bool readonly, bool rebootRequired);
+template<> std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<const char*>(const char *key, const char *factoryDef, bool readonly, bool rebootRequired);
+
+std::unique_ptr<ConfigurationContainer> makeConfigurationContainerVolatile(const char *filename, bool accessible);
+
 } //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index 2d5cd77b..4f3a0b79 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -6,146 +6,291 @@
 #include <MicroOcpp/Core/FilesystemUtils.h>
 #include <MicroOcpp/Debug.h>
 
-#include <algorithm>
-
 #define MAX_CONFIGURATIONS 50
 
 namespace MicroOcpp {
 
-bool ConfigurationContainerFlash::load() {
+class ConfigurationContainerFlash : public ConfigurationContainer {
+private:
+    ConfigurationPool container;
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    uint16_t revisionSum = 0;
 
-    if (!filesystem) {
-        return false;
+    std::vector<std::string> keyPool;
+    
+    void clearKeyPool(const char *key) {
+        keyPool.erase(std::remove_if(keyPool.begin(), keyPool.end(), 
+            [key] (std::string& k) {
+                return !k.compare(key);
+            }));
     }
 
-    if (configurations.size() > 0) {
-        MOCPP_DBG_ERR("Error: declared configurations before calling container->load(). " \
-                    "All previously declared values won't be written back");
-        (void)0;
-    }
+    bool configurationsUpdated() {
+        auto revisionSum_old = revisionSum;
 
-    size_t file_size = 0;
-    if (filesystem->stat(getFilename(), &file_size) != 0 // file does not exist
-            || file_size == 0) {                         // file exists, but empty
-        MOCPP_DBG_DEBUG("Populate FS: create configuration file");
-        return save();
-    }
+        revisionSum = 0;
+        auto& configurations = container.getConfigurations();
+        for (size_t i = 0; i < configurations.size(); i++) {
+            revisionSum += configurations[i]->getValueRevision();
+        }
 
-    auto doc = FilesystemUtils::loadJson(filesystem, getFilename());
-    if (!doc) {
-        MOCPP_DBG_ERR("failed to load %s", getFilename());
-        return false;
+        return revisionSum == revisionSum_old;
     }
+public:
+    ConfigurationContainerFlash(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename, bool accessible) :
+            ConfigurationContainer(filename, accessible), filesystem(filesystem) { }
 
-    JsonObject root = doc->as<JsonObject>();
+    ~ConfigurationContainerFlash() = default;
 
-    JsonObject configHeader = root["head"];
+    bool load() override {
 
-    if (strcmp(configHeader["content-type"] | "Invalid", "ocpp_config_file") &&
-            strcmp(configHeader["content-type"] | "Invalid", "ao_configuration_file")) { //backwards-compatibility
-        MOCPP_DBG_ERR("Unable to initialize: unrecognized configuration file format");
-        return false;
-    }
+        if (!filesystem) {
+            return false;
+        }
 
-    if (strcmp(configHeader["version"] | "Invalid", "2.0") &&
-            strcmp(configHeader["version"] | "Invalid", "1.1")) { //backwards-compatibility
-        MOCPP_DBG_ERR("Unable to initialize: unsupported version");
-        return false;
-    }
-    
-    JsonArray configurationsArray = root["configurations"];
-    if (configurationsArray.size() > MAX_CONFIGURATIONS) {
-        MOCPP_DBG_ERR("Unable to initialize: configurations_len is too big (=%zu)", configurationsArray.size());
-        return false;
-    }
+        auto& configurations = container.getConfigurations();
 
-    for (JsonObject config : configurationsArray) {
-        const char *key = config["key"] | "";
-        if (!*key || !config.containsKey("value")) {
-            MOCPP_DBG_ERR("corrupt config");
-            continue;
+        size_t file_size = 0;
+        if (filesystem->stat(getFilename(), &file_size) != 0 // file does not exist
+                || file_size == 0) {                         // file exists, but empty
+            MOCPP_DBG_DEBUG("Populate FS: create configuration file");
+            return save();
         }
 
-        const char *type = config["type"] | "Undefined";
+        auto doc = FilesystemUtils::loadJson(filesystem, getFilename());
+        if (!doc) {
+            MOCPP_DBG_ERR("failed to load %s", getFilename());
+            return false;
+        }
 
-        std::shared_ptr<AbstractConfiguration> configuration = nullptr;
+        JsonObject root = doc->as<JsonObject>();
 
-        if (!strcmp(type, SerializedType<int>::get()) && config["value"].is<int>()){
-            configuration = std::make_shared<Configuration<int>>(key, config["value"].as<int>());
-        } else if (!strcmp(type, SerializedType<float>::get()) && config["value"].is<float>()){
-            configuration = std::make_shared<Configuration<float>>(key, config["value"].as<float>());
-        } else if (!strcmp(type, SerializedType<bool>::get()) && config["value"].is<bool>()){
-            configuration = std::make_shared<Configuration<bool>>(key, config["value"].as<bool>());
-        } else if (!strcmp(type, SerializedType<const char *>::get()) && config["value"].is<const char*>()){
-            configuration = std::make_shared<Configuration<const char *>>(key, config["value"].as<const char*>());
-        } else {
-            MOCPP_DBG_ERR("corrupt config");
-            continue;
+        JsonObject configHeader = root["head"];
+
+        if (strcmp(configHeader["content-type"] | "Invalid", "ocpp_config_file") &&
+                strcmp(configHeader["content-type"] | "Invalid", "ao_configuration_file")) { //backwards-compatibility
+            MOCPP_DBG_ERR("Unable to initialize: unrecognized configuration file format");
+            return false;
         }
 
-        if (configuration) {
-            configurations.push_back(configuration);
-        } else {
-            MOCPP_DBG_ERR("Initialization fault: could not read key-value pair %s of type %s", config["key"].as<const char *>(), config["type"].as<const char *>());
+        if (strcmp(configHeader["version"] | "Invalid", "2.0") &&
+                strcmp(configHeader["version"] | "Invalid", "1.1")) { //backwards-compatibility
+            MOCPP_DBG_ERR("Unable to initialize: unsupported version");
+            return false;
+        }
+        
+        JsonArray configurationsArray = root["configurations"];
+        if (configurationsArray.size() > MAX_CONFIGURATIONS) {
+            MOCPP_DBG_ERR("Unable to initialize: configurations_len is too big (=%zu)", configurationsArray.size());
+            return false;
         }
-    }
 
-    configurationsUpdated();
+        for (JsonObject stored : configurationsArray) {
+            TConfig type;
+            if (!deserializeTConfig(stored["type"] | "_Undefined", type)) {
+                MOCPP_DBG_ERR("corrupt config");
+                continue;
+            }
 
-    MOCPP_DBG_DEBUG("Initialization finished");
-    return true;
-}
+            const char *key = stored["key"] | "";
+            if (!*key) {
+                MOCPP_DBG_ERR("corrupt config");
+                continue;
+            }
 
-bool ConfigurationContainerFlash::save() {
+            if (!stored.containsKey("value")) {
+                MOCPP_DBG_ERR("corrupt config");
+                continue;
+            }
+            
+            std::string key_pooled;
 
-    if (!filesystem) {
-        return false;
-    }
+            Configuration *config = container.getConfiguration(key);
+            if (!config || config->getType() != type) {
+                key_pooled = key;
+                config = nullptr;
+            }
+
+            switch (type) {
+                case TConfig::Int: {
+                    if (!stored["value"].is<int>()) {
+                        MOCPP_DBG_ERR("corrupt config");
+                        continue;
+                    }
+                    int value = stored["value"] | 0;
+                    if (config) {
+                        //config already exists
+                        config->setInt(value);
+                    } else {
+                        //create new config
+                        config = container.declareConfiguration<int>(key_pooled.c_str(), value).get();
+                    }
+                    break;
+                }
+                case (TConfig::Bool):
+                    if (!stored["value"].is<bool>()) {
+                        MOCPP_DBG_ERR("corrupt config");
+                        continue;
+                    }
+                    bool value = stored["value"] | false;
+                    if (config) {
+                        //config already exists
+                        config->setBool(value);
+                    } else {
+                        //create new config
+                        config = container.declareConfiguration<bool>(key_pooled.c_str(), value).get();
+                    }
+                    break;
+                case (TConfig::String):
+                    if (!stored["value"].is<const char*>()) {
+                        MOCPP_DBG_ERR("corrupt config");
+                        continue;
+                    }
+                    const char *value = stored["value"] | "";
+                    if (config) {
+                        //config already exists
+                        config->setBool(value);
+                    } else {
+                        //create new config
+                        config = container.declareConfiguration<bool>(key_pooled.c_str(), value).get();
+                    }
+                    break;
+            }
+
+            if (config) {
+                //success
+
+                if (!key_pooled.empty()) {
+                    //allocated key, need to store
+                    keyPool.push_back(std::string(key));
+                }
+            } else {
+                MOCPP_DBG_ERR("OOM: %s", key);
+                (void)0;
+            }
+        }
 
-    if (!configurationsUpdated()) {
-        return true; //nothing to be done
+        configurationsUpdated();
+
+        MOCPP_DBG_DEBUG("Initialization finished");
+        return true;
     }
 
-    size_t jsonCapacity = 2 * JSON_OBJECT_SIZE(2); //head + configurations + head payload
+    bool save() override {
+
+        if (!filesystem) {
+            return false;
+        }
+
+        if (!configurationsUpdated()) {
+            return true; //nothing to be done
+        }
+
+        auto& configurations = container.getConfigurations();
+
+        size_t jsonCapacity = 2 * JSON_OBJECT_SIZE(2); //head + configurations + head payload
+        jsonCapacity += JSON_ARRAY_SIZE(configurations.size()); //configurations array
+        jsonCapacity += configurations.size() * JSON_OBJECT_SIZE(3); //config entries in array
+
+        if (jsonCapacity > MOCPP_MAX_JSON_CAPACITY) {
+            MOCPP_DBG_ERR("configs JSON exceeds maximum capacity (%s, %zu entries). Crop configs file (by FCFS)", getFilename(), configurations.size());
+            jsonCapacity = MOCPP_MAX_JSON_CAPACITY;
+        }
+
+        DynamicJsonDocument doc {jsonCapacity};
+        JsonObject head = doc.createNestedObject("head");
+        head["content-type"] = "ocpp_config_file";
+        head["version"] = "2.0";
+
+        JsonArray configurationsArray = doc.createNestedArray("configurations");
 
-    std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
+        size_t trackCapacity = 0;
 
-    for (auto config = configurations.begin(); config != configurations.end(); config++) {
-        auto entry = (*config)->toJsonStorageEntry();
-        if (entry) {
-            size_t capacity = entry->memoryUsage(); //entry payload size
+        for (size_t i = 0; i < configurations.size(); i++) {
+            auto& config = *configurations[i];
+            if (!config.getKey()) {
+                MOCPP_DBG_ERR("corrupt config");
+                continue;
+            }
 
-            if (jsonCapacity + capacity + JSON_ARRAY_SIZE(entries.size() + 1)  > MOCPP_MAX_JSON_CAPACITY) {
-                MOCPP_DBG_ERR("configs JSON exceeds maximum capacity (%s, %zu entries). Crop configs file (by FCFS)", getFilename(), entries.size());
+            size_t entryCapacity = JSON_OBJECT_SIZE(3) + (JSON_ARRAY_SIZE(2) - JSON_ARRAY_SIZE(1));
+            if (trackCapacity + entryCapacity > MOCPP_MAX_JSON_CAPACITY) {
                 break;
             }
 
-            entries.push_back(std::move(entry));
-            jsonCapacity += capacity;
+            trackCapacity += entryCapacity;
+
+            auto stored = configurationsArray.createNestedObject();
+
+            stored["type"] = serializeTConfig(config.getType());
+            stored["key"] = config.getKey();
+            
+            switch (config.getType()) {
+                case TConfig::Int:
+                    stored["value"] = config.getInt();
+                    break;
+                case TConfig::Bool:
+                    stored["value"] = config.getBool();
+                    break;
+                case TConfig::String:
+                    if (!config.getString()) {
+                        MOCPP_DBG_ERR("corrupt config");
+                        configurationsArray.remove(configurationsArray.size());
+                        break;
+                    }
+                    stored["value"] = config.getString();
+                    break;
+            }
         }
+
+        bool success = FilesystemUtils::storeJson(filesystem, getFilename(), doc);
+
+        if (success) {
+            MOCPP_DBG_DEBUG("Saving configurations finished");
+        } else {
+            MOCPP_DBG_ERR("could not save configs file: %s", getFilename());
+        }
+
+        return success;
     }
 
-    jsonCapacity += JSON_ARRAY_SIZE(entries.size());
+    std::shared_ptr<Configuration> declareConfigurationInt(const char *key, int factoryDef, bool readonly = false, bool rebootRequired = false) override {
+        auto res = container.declareConfiguration<int>(key, factoryDef, readonly, rebootRequired);
+        if (res) res->setKey(key);
+        clearKeyPool(key);
+        return res;
+    }
+
+    std::shared_ptr<Configuration> declareConfigurationBool(const char *key, bool factoryDef, bool readonly = false, bool rebootRequired = false) override {
+        auto res = container.declareConfiguration<bool>(key, factoryDef, readonly, rebootRequired);
+        if (res) res->setKey(key);
+        clearKeyPool(key);
+        return res;
+    }
 
-    DynamicJsonDocument doc {jsonCapacity};
-    JsonObject head = doc.createNestedObject("head");
-    head["content-type"] = "ocpp_config_file";
-    head["version"] = "2.0";
+    std::shared_ptr<Configuration> declareConfigurationString(const char *key, const char*factoryDef, bool readonly = false, bool rebootRequired = false) override {
+        auto res = container.declareConfiguration<const char*>(key, factoryDef, readonly, rebootRequired);
+        if (res) res->setKey(key);
+        clearKeyPool(key);
+        return res;
+    }
 
-    JsonArray configurationsArray = doc.createNestedArray("configurations");
-    for (auto entry = entries.begin(); entry != entries.end(); entry++) {
-        configurationsArray.add((*entry)->as<JsonObject>());
+    size_t getConfigurationCount() override {
+        return container.getConfigurationCount();
     }
 
-    bool success = FilesystemUtils::storeJson(filesystem, getFilename(), doc);
+    Configuration *getConfiguration(size_t i) override {
+        return container.getConfiguration(i);
+    }
 
-    if (success) {
-        MOCPP_DBG_DEBUG("Saving configurations finished");
-    } else {
-        MOCPP_DBG_ERR("could not save configs file: %s", getFilename());
+    Configuration *getConfiguration(const char *key) override {
+        return container.getConfiguration(key);
     }
 
-    return success;
+};
+
+std::unique_ptr<ConfigurationContainer> makeConfigurationContainerFlash(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename, bool accessible) {
+    return std::unique_ptr<ConfigurationContainer>(new ConfigurationContainerFlash(filesystem, filename, accessible));
 }
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.h b/src/MicroOcpp/Core/ConfigurationContainerFlash.h
index 20574ce2..ecab3f69 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.h
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.h
@@ -10,19 +10,7 @@
 
 namespace MicroOcpp {
 
-class ConfigurationContainerFlash : public ConfigurationContainer {
-    std::shared_ptr<FilesystemAdapter> filesystem;
-public:
-    ConfigurationContainerFlash(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename) :
-            ConfigurationContainer(filename), filesystem(filesystem) { }
-
-    ~ConfigurationContainerFlash() = default;
-
-    bool load();
-
-    bool save();
-
-};
+std::unique_ptr<ConfigurationContainer> makeConfigurationContainerFlash(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename, bool accessible);
 
 } //end namespace MicroOcpp
 
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index a75ffe26..b6393199 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -18,6 +18,10 @@
 
 namespace MicroOcpp {
 
+template<> TConfig convertType<int>() {return TConfig::Int;}
+template<> TConfig convertType<bool>() {return TConfig::Bool;}
+template<> TConfig convertType<const char*>() {return TConfig::String;}
+
 int toCStringValue(char *buf, size_t length, int value) {
     return snprintf(buf, length, "%d", value);
 }
@@ -31,256 +35,241 @@ int toCStringValue(char *buf, size_t length, bool value) {
     return snprintf(buf, length, "%s", value ? "true" : "false");
 }
 
-
-
-uint16_t Configuration::getValueRevision() {
-    return value_revision;
-}
-
-void Configuration::setRequiresReboot() {
-    rebootRequired = true;
+void Configuration::setInt(int) {
+#if MOCPP_CONFIG_TYPECHECK
+    MOCPP_DBG_ERR("type err");
+#endif
 }
 
-bool Configuration::getRequiresReboot() {
-    return rebootRequired;
+void Configuration::setBool(bool) {
+#if MOCPP_CONFIG_TYPECHECK
+    MOCPP_DBG_ERR("type err");
+#endif
 }
 
-void Configuration::revokeWritePermission() {
-    writePermission = false;
+bool Configuration::setString(const char*) {
+#if MOCPP_CONFIG_TYPECHECK
+    MOCPP_DBG_ERR("type err");
+#endif
 }
 
-bool Configuration::getWritePermission() {
-    return writePermission;
+int Configuration::getInt() {
+#if MOCPP_CONFIG_TYPECHECK
+    MOCPP_DBG_ERR("type err");
+#endif
+    return 0;
 }
 
-void Configuration::revokeReadPermission() {
-    readPermission = false;
+bool Configuration::getBool() {
+#if MOCPP_CONFIG_TYPECHECK
+    MOCPP_DBG_ERR("type err");
+#endif
+    return false;
 }
 
-bool Configuration::getReadPermission() {
-    return readPermission;
+const char *Configuration::getString() {
+#if MOCPP_CONFIG_TYPECHECK
+    MOCPP_DBG_ERR("type err");
+#endif
+    return nullptr;
 }
 
-void Configuration::setValidator(std::function<bool(const char*)> validator) {
-    this->validator = validator;
+revision_t Configuration::getValueRevision() {
+    return value_revision;
 }
 
-std::function<bool(const char*)> Configuration::getValidator() {
-    return validator;
+void Configuration::setRequiresReboot() {
+    rebootRequired = true;
 }
 
-namespace ConfigHelpers {
-
-bool initKey(const char *dest, const char *src) {
-    dest = src;
-    return true;
+bool Configuration::getRequiresReboot() {
+    return rebootRequired;
 }
 
-bool initKey(char *dest, const char *src) {
-    size_t len = strlen(src);
-    dest = (char*) malloc(len + 1);
-    if (!dest) {
-        return false;
-    }
-    strcpy(dest, src);
-    return true;
+void Configuration::setReadOnly() {
+    readOnly = true;
 }
 
-void deinitKey(const char *key) {
-    (void)key;
+bool Configuration::getReadOnly() {
+    return readOnly;
 }
 
-void deinitKey(char *key) {
-    free(key);
-}
+/*
+ * Default implementations of the Configuration interface.
+ *
+ * How to use custom implementations: for each OCPP config, pass a config instance to the OCPP lib
+ * before its initialization stage. Then the library won't create new config objects but 
+ */
 
-template<class T>
-void deinitValue(T) { }
+class ConfigInt : public Configuration {
+private:
+    const char *key = nullptr;
+    int val = 0;
+public:
 
-template<>
-void deinitValue(char *val) {
-    free(val);
-}
+    ~ConfigInt() = default;
 
-template<class T>
-T getNull();
+    bool setKey(const char *key) override {
+        this->key = key;
+        return true;
+    }
 
-template<>
-int getNull() {return 0;}
+    const char *getKey() override {
+        return key;
+    }
 
-template<>
-float getNull() {return 0.f;}
+    TConfig getType() override {
+        return TConfig::Int;
+    }
 
-template<>
-char *getNull() {return nullptr;}
+    void setInt(int val) override {
+        this->val = val;
+    }
 
-template<>
-const char *getNull() {return nullptr;}
+    int getInt() override {
+        return val;
+    }
+};
 
-template<class T, class U>
-T as(U) {return getNull<T>();}
+class ConfigBool : public Configuration {
+private:
+    const char *key = nullptr;
+    bool val = false;
+public:
 
-template<>
-int as(int v) {return v;}
+    ~ConfigBool() = default;
 
-template<>
-float as(float v) {return v;}
+    bool setKey(const char *key) override {
+        this->key = key;
+        return true;
+    }
 
-template<>
-const char *as(char *v) {return v;}
+    const char *getKey() override {
+        return key;
+    }
 
-template<>
-const char *as(const char *v) {return v;}
+    TConfig getType() override {
+        return TConfig::Bool;
+    }
 
+    void setBool(bool val) override {
+        this->val = val;
+    }
 
-template<class T>
-struct TConfigType {
-    static TConfig get() {return TConfig::None;}
+    bool getBool() override {
+        return val;
+    }
 };
 
-template<> struct TConfigType<int> {static TConfig get() {return TConfig::Int;}};
-template<> struct TConfigType<float> {static TConfig get() {return TConfig::Float;}};
-template<> struct TConfigType<const char*> {static TConfig get() {return TConfig::String;}};
-template<> struct TConfigType<bool> {static TConfig get() {return TConfig::Bool;}};
-
-} //end namespace ConfigHelpers
-
-
-template<class K, class T>
-ConfigConcrete<K,T>::ConfigConcrete() {
-    key = nullptr;
-    val = ConfigHelpers::getNull<T>();
-}
-
-template<class K, class T>
-ConfigConcrete<K,T>::~ConfigConcrete() {
-    ConfigHelpers::deinitKey(key);
-}
-
-template<class K, class T>
-ConfigConcrete<K,T>::ConfigConcrete() {
-
-}
+class ConfigString : public Configuration {
+private:
+    const char *key = nullptr;
+    char *val = nullptr;
+public:
+    ConfigString() = default;
+    ConfigString(const ConfigString&) = delete;
+    ConfigString& operator=(const ConfigString&) = delete;
+
+    ~ConfigString() {
+        free(val);
+    }
 
-template<class K, class T>
-ConfigConcrete<K,T>::ConfigConcrete() {
+    bool setKey(const char *key) override {
+        this->key = key;
+        return true;
+    }
 
-}
+    const char *getKey() override {
+        return key;
+    }
 
-template<class K, class T>
-ConfigConcrete<K,T>::ConfigConcrete() {
+    TConfig getType() override {
+        return TConfig::String;
+    }
 
-}
+    bool setString(const char *src) override {
+        if (!this->val && !src) {
+            return true;
+        }
 
-template<class K, class T>
-ConfigConcrete<K,T>::~ConfigConcrete() {
-    ConfigHelpers::deinitKey(key);
-}
+        if (this->val && src && !strcmp(this->val, src)) {
+            return true;
+        }
 
-template<class K, class T>
-bool ConfigConcrete<K,T>::setKey(const char *key) {
-    return ConfigHelpers::initKey(this->key, key);
-}
+        size_t size = 0;
+        if (src) {
+            size = strlen(src) + 1;
+        }
 
-template<class K, class T>
-const char *ConfigConcrete<K,T>::getKey() {
-    return key;
-}
+        if (size > MOCPP_CONFIG_MAX_VALSTRSIZE) {
+            return false;
+        }
 
-template<class K, class T>
-int ConfigConcrete<K,T>::getInt() {
-#if MOCPP_CONFIG_TYPECHECK
-    if (getType() != TConfig::Int) {
-        MOCPP_DBG_ERR("type err");
-    }
-#endif
-    return ConfigHelpers::as<int>(val);
-}
+        value_revision++;
 
-template<class K, class T>
-bool ConfigConcrete<K,T>::getBool() {
-#if MOCPP_CONFIG_TYPECHECK
-    if (getType() != TConfig::Bool) {
-        MOCPP_DBG_ERR("type err");
-    }
-#endif
-    return ConfigHelpers::as<bool>(val);
-}
+        if (this->val) {
+            free(this->val);
+            this->val = nullptr;
+        }
 
-template<class K, class T>
-const char *ConfigConcrete<K,T>::getString() {
-#if MOCPP_CONFIG_TYPECHECK
-    if (getType() != TConfig::String) {
-        MOCPP_DBG_ERR("type err");
-    }
-#endif
-    return ConfigHelpers::as<const char*>(val);
-}
+        if (src) {
+            this->val = (char*) malloc(size);
+            if (!this->val) {
+                return false;
+            }
+            strcpy(this->val, src);
+        }
 
-template<class K, class T>
-void ConfigConcrete<K,T>::setInt(int v) {
-#if MOCPP_CONFIG_TYPECHECK
-    if (getType() != TConfig::Int) {
-        MOCPP_DBG_ERR("type err");
+        return true;
     }
-#endif
-    value_revision++;
-    val = ConfigHelpers::as<T>(v);
-}
 
-template<class K, class T>
-void ConfigConcrete<K,T>::setBool(bool v) {
-#if MOCPP_CONFIG_TYPECHECK
-    if (getType() != TConfig::Bool) {
-        MOCPP_DBG_ERR("type err");
+    const char *getString() override {
+        return val;
     }
-#endif
-    value_revision++;
-    val = ConfigHelpers::as<T>(v);
-}
+};
 
-template<class K, class T>
-bool ConfigConcrete<K,T>::setString(const char *src) {
-#if MOCPP_CONFIG_TYPECHECK
-    if (getType() != TConfig::String) {
-        MOCPP_DBG_ERR("type err");
-    }
-#endif
-    value_revision++;
-    auto dest = ConfigHelpers::as<char*>(val);
-    if (dest) {
-        free(dest);
-        dest = nullptr;
+template<class T>
+std::unique_ptr<Configuration> makeConfig(const char *key, T val) {
+    std::unique_ptr<ConfigInt> res;
+    switch (convertType<T>()) {
+        case TConfig::Int:
+            res = std::unique_ptr<ConfigInt>(new ConfigInt());
+            if (res) res->setInt(val);
+            break;
+        case TConfig::Bool:
+            res = std::unique_ptr<ConfigBool>(new ConfigBool());
+            if (res) res->setBool(val);
+            break;
+        case TConfig::String:
+            res = std::unique_ptr<ConfigString>(new ConfigString());
+            if (res) res->setString(val);
+            break;
     }
-    if (src && dest) {
-        size_t len = strlen(src);
-        dest = (char*) malloc(len + 1);
-        if (!dest) {
-            return false;
-        }
-        strcpy(dest, src);
+    if (!res) {
+        return nullptr;
     }
-    return true;
-}
-
-template<class K, class T>
-TConfig ConfigConcrete<K,T>::getType() {
-    return ConfigHelpers::TConfigType<T>::get();
+    res->setKey(key);
+    return res;
 }
 
+template<> std::unique_ptr<Configuration> makeConfig<int>(const char *key, int val);
+template<> std::unique_ptr<Configuration> makeConfig<bool>(const char *key, bool val);
+template<> std::unique_ptr<Configuration> makeConfig<const char*>(const char *key, const char *val);
 
-bool deserializeTConfig(TConfig& out, const char *serialized) {
+bool deserializeTConfig(const char *serialized, TConfig& out) {
     if (!strcmp(serialized, "int")) {
         out = TConfig::Int;
+        return true;
     } else if (!strcmp(serialized, "bool")) {
         out = TConfig::Bool;
+        return true;
     } else if (!strcmp(serialized, "string")) {
         out = TConfig::String;
+        return true;
     } else {
-        out = TConfig::None;
         MOCPP_DBG_WARN("config type error");
+        return false;
     }
-    return out;
 }
 
 const char *serializeTConfig(TConfig type) {
@@ -291,139 +280,47 @@ const char *serializeTConfig(TConfig type) {
             return "bool";
         case (TConfig::String):
             return "string";
-        case (TConfig::None):
-            MOCPP_DBG_WARN("config type error");
-            return "undefined";
     }
 }
 
-std::unique_ptr<Configuration> deserializeConfigInternal(JsonObject stored) {
-    
-    TConfig ctype = TConfig::None;
-    if (!deserializeTConfig(ctype, stored["type"] | "_Undefined") || ctype == TConfig::None) {
-        return nullptr;
-    }
-
-    if (!stored.containsKey("value")) {
-        return nullptr;
-    }
-
-    std::unique_ptr<Configuration> res;
-
-    switch (ctype) {
-        case (TConfig::Int):
-            if (!stored["value"].is<int>()) {
-                return nullptr;
-            }
-            res = std::unique_ptr<ConfigConcrete<char*,int>>(new ConfigConcrete<char*,int>());
-            if (!res) {
-                return nullptr;
-            }
-            res->setInt(stored["value"] | 0);
-            break;
-        case (TConfig::Bool):
-            if (!stored["value"].is<bool>()) {
-                return nullptr;
-            }
-            res = std::unique_ptr<ConfigConcrete<char*,bool>>(new ConfigConcrete<char*,bool>());
-            if (!res) {
-                return nullptr;
-            }
-            res->setBool(stored["value"] | false);
-            break;
-        case (TConfig::String):
-            if (!stored["value"].is<const char*>()) {
-                return nullptr;
-            }
-            res = std::unique_ptr<ConfigConcrete<char*,const char*>>(new ConfigConcrete<char*,const char*>());
-            if (!res) {
-                return nullptr;
-            }
-            res->setString(stored["value"] | "");
-            break;
-        case (TConfig::None):
-            return nullptr;
-    }
-    
-    const char *key = stored["key"] | "";
-    if (!*key) {
-        return nullptr;
-    }
+bool serializeConfigOcpp(Configuration& config, DynamicJsonDocument& out) {
 
-    if (!res->setKey(key)) {
-        return nullptr;
+    if (!config.getKey()) {
+        return false;
     }
-
-    return res;
-}
-
-bool serializeConfigInternal(Configuration& config, JsonObject out) {
-
-    out["key"] = config.getKey();
     
-    switch (config.getType()) {
-        case TConfig::Int:
-            out["type"] = "int";
-            out["value"] = config.getInt();
-            break;
-        case TConfig::Bool:
-            out["type"] = "bool";
-            out["value"] = config.getBool();
-            break;
-        case TConfig::String:
-            out["type"] = "string";
-            out["value"] = config.getString();
-            break;
-        case TConfig::None:
-            MOCPP_DBG_ERR("invalid config");
-            out.clear();
-            return false;
-            break;
-    }
-
-    return true;
-}
-
-bool serializeConfigOcpp(Configuration& config, DynamicJsonDocument& out) {
-
     const size_t PRIMITIVE_VALUESIZE = 30;
     char vbuf [PRIMITIVE_VALUESIZE];
     const char *v = vbuf;
     size_t vcapacity = 0;
     switch(config.getType()) {
         case TConfig::Int: {
-            auto ret = snprintf(valuebuf, PRIMITIVE_VALUESIZE, "%i", config.getInt());
+            auto ret = snprintf(vbuf, PRIMITIVE_VALUESIZE, "%i", config.getInt());
             if (ret < 0 || ret >= PRIMITIVE_VALUESIZE) {
                 return false;
             }
             v = vbuf;
-            vcapacity = ret;
+            vcapacity = ret + 1;
             break;
         }
-        case TConfig::Bool: {
+        case TConfig::Bool:
             v = config.getBool() ? "true" : "false";
             vcapacity = 0;
             break;
-        }
-        case TConfig::String: {
+        case TConfig::String:
             v = config.getString();
             if (!v) {
                 MOCPP_DBG_ERR("invalid config");
-                return nullptr;
+                return false;
             }
             vcapacity = 0;
             break;
-        }
-        case TConfig::None: {
-            MOCPP_DBG_ERR("invalid config");
-            return false;
-        }
     }
 
-    out.reset(JSON_OBJECT_SIZE(3) + vcapacity);
+    out = DynamicJsonDocument(JSON_OBJECT_SIZE(3) + vcapacity);
 
     out["key"] = config.getKey();
-    out["readonly"] = !config.getWritePermission();
+    out["readonly"] = config.getReadOnly();
     if (vcapacity > 0) {
         //value has capacity, copy string
         out["value"] = (char*) v;
@@ -435,12 +332,5 @@ bool serializeConfigOcpp(Configuration& config, DynamicJsonDocument& out) {
     return true;
 }
 
-template class ConfigConcrete<char*,int>;
-template class ConfigConcrete<char*,bool>;
-template class ConfigConcrete<char*,const char*>;
-template class ConfigConcrete<const char*,int>;
-template class ConfigConcrete<const char*,bool>;
-template class ConfigConcrete<const char*,const char*>;
-//template class Configuration<const char *>; //no effect after explicit specialization
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index e1c99882..49398ac7 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -7,88 +7,65 @@
 
 #include <ArduinoJson.h>
 #include <memory>
-#include <functional>
-#include <string>
+
+#define MOCPP_CONFIG_MAX_VALSTRSIZE 128
 
 namespace MicroOcpp {
 
+using revision_t = uint16_t;
+
 enum TConfig : uint8_t {
-    None,
     Int,
-    Float,
-    String,
-    Bool
+    Bool,
+    String
 };
 
+template<class T>
+TConfig convertType();
+
 class Configuration {
+protected:
+    revision_t value_revision = 0; //write access counter; used to check if this config has been changed
 private:
-    std::function<bool(const char*)> validator;
-
     bool rebootRequired = false;
-    bool writePermission = true;
-    bool readPermission = true;
-protected:
-    uint16_t value_revision = 0;
+    bool readOnly = false;
 public:
+    virtual ~Configuration();
 
+    virtual bool setKey(const char *key) = 0;
     virtual const char *getKey() = 0;
 
-    virtual void setInt(int) = 0;
-    virtual void setBool(bool) = 0;
-    virtual bool setString(const char*) = 0;
+    virtual void setInt(int);
+    virtual void setBool(bool);
+    virtual bool setString(const char*);
 
-    virtual int getInt() = 0;
-    virtual bool getBool() = 0;
-    virtual const char *getString() = 0;
+    virtual int getInt();
+    virtual bool getBool();
+    virtual const char *getString();
 
     virtual TConfig getType() = 0;
 
-    uint16_t getValueRevision(); 
+    revision_t getValueRevision(); 
 
     void setRequiresReboot();
     bool getRequiresReboot();
 
-    void revokeWritePermission();
-    bool getWritePermission();
-
-    void revokeReadPermission();
-    bool getReadPermission();
-
-    void setValidator(std::function<bool(const char*)> validator);
-    std::function<bool(const char*)> getValidator();
+    void setReadOnly();
+    bool getReadOnly();
 };
 
-template<class K, class T>
-class ConfigConcrete : public Configuration {
-private:
-    K key;
-    T val;
-public:
-
-    ConfigConcrete();
-
-    ~ConfigConcrete() {
-        ConfigHelpers::deinitKey(key);
-    }
-
-    bool setKey(const char *key);
-
-    const char *getKey() override;
-
-    int getInt() override;
+/*
+ * Default implementations of the Configuration interface.
+ *
+ * How to use custom implementations: for each OCPP config, pass a config instance to the OCPP lib
+ * before its initialization stage. Then the library won't create new config objects but 
+ */
 
-    bool getBool() override;
+template<class T>
+std::unique_ptr<Configuration> makeConfig(const char *key, T val);
 
-    const char *getString() override;
-
-    void setInt(int v) override;
-
-    void setBool(bool v) override;
-
-    bool setString(const char *v) override;
-
-    TConfig getType() override;
-};
+const char *serializeTConfig(TConfig type);
+bool deserializeTConfig(const char *serialized, TConfig& out);
 
 } //end namespace MicroOcpp
 
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index dc101064..f9e5c320 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -27,6 +27,7 @@ void GetConfiguration::processReq(JsonObject payload) {
 std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
 
     std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> configurationKeys;
+    std::vector<Configuration*> configurations;
     std::vector<std::string> unknownKeys;
 
     if (keys.size() == 0){ //return all existing keys

From 869ae30cd869e447e2b098ee755975ffcef250c4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 17 Sep 2023 22:18:05 +0200
Subject: [PATCH 374/549] Change- and GetConf configs optimization (draft)

---
 src/MicroOcpp/Core/Configuration.cpp          |  28 ++++
 src/MicroOcpp/Core/Configuration.h            |   3 +
 src/MicroOcpp/Core/ConfigurationContainer.cpp |   2 +-
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp  |   8 +-
 src/MicroOcpp/Core/ConfigurationKeyValue.h    |   6 +-
 .../Operations/ChangeConfiguration.cpp        |  44 ++----
 src/MicroOcpp/Operations/GetConfiguration.cpp | 135 +++++++++++++-----
 src/MicroOcpp/Operations/GetConfiguration.h   |   6 +
 8 files changed, 156 insertions(+), 76 deletions(-)

diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index c25dc7dc..6b78e8af 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -12,10 +12,16 @@
 
 namespace MicroOcpp {
 
+struct Validator {
+    const char *key = nullptr;
+    std::function<bool(const char*)> checkValue;
+};
+
 namespace ConfigurationLocal {
 
 std::shared_ptr<FilesystemAdapter> filesystem;
 std::vector<std::shared_ptr<ConfigurationContainer>> configurationContainers;
+std::vector<Validator> validators;
 
 }
 
@@ -95,6 +101,27 @@ std::shared_ptr<Configuration> declareConfiguration(const char *key, T factoryDe
     return configuration;
 }
 
+std::function<bool(const char*)> *getConfigurationValidator(const char *key) {
+    for (auto& v : validators) {
+        if (!strcmp(v.key, key)) {
+            return &v.checkValue;
+        }
+    }
+    return nullptr;
+}
+
+void registerConfigurationValidator(const char *key, std::function<bool(const char*)> validator) {
+    for (auto& v : validators) {
+        if (!strcmp(v.key, key)) {
+            v.checkValue = validator;
+            return;
+        }
+    }
+    validators.push_back(Validator{key, validator});
+}
+
+
+
 Configuration *getConfigurationPublic(const char *key) {
     for (auto& container : configurationContainers) {
         if (container->isAccessible()) {
@@ -125,6 +152,7 @@ bool configuration_init(std::shared_ptr<FilesystemAdapter> _filesystem) {
 
 void configuration_deinit() {
     configurationContainers.clear();
+    validators.clear();
     filesystem.reset();
 }
 
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index 1b70ac8f..0dc941cf 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -28,6 +28,9 @@ namespace MicroOcpp {
 template <class T>
 std::shared_ptr<Configuration> declareConfiguration(const char *key, T defaultValue, const char *filename = CONFIGURATION_FN, bool readonly = false, bool rebootRequired = false, bool accessible = true);
 
+std::function<bool(const char*)> *getConfigurationValidator(const char *key);
+void registerConfigurationValidator(const char *key, std::function<bool(const char*)> validator);
+
 void addConfigurationContainer(std::shared_ptr<ConfigurationContainer> container);
 
 Configuration *getConfigurationPublic(const char *key);
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index 4d0f2afd..df92370c 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -45,7 +45,7 @@ std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration(const cha
     }
 
     if (rebootRequired) {
-        res->setRequiresReboot();
+        res->setRebootRequired();
     }
 
     return res;
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index b6393199..bb6868d1 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -78,11 +78,11 @@ revision_t Configuration::getValueRevision() {
     return value_revision;
 }
 
-void Configuration::setRequiresReboot() {
+void Configuration::setRebootRequired() {
     rebootRequired = true;
 }
 
-bool Configuration::getRequiresReboot() {
+bool Configuration::isRebootRequired() {
     return rebootRequired;
 }
 
@@ -90,7 +90,7 @@ void Configuration::setReadOnly() {
     readOnly = true;
 }
 
-bool Configuration::getReadOnly() {
+bool Configuration::isReadOnly() {
     return readOnly;
 }
 
@@ -320,7 +320,7 @@ bool serializeConfigOcpp(Configuration& config, DynamicJsonDocument& out) {
     out = DynamicJsonDocument(JSON_OBJECT_SIZE(3) + vcapacity);
 
     out["key"] = config.getKey();
-    out["readonly"] = config.getReadOnly();
+    out["readonly"] = config.isReadOnly();
     if (vcapacity > 0) {
         //value has capacity, copy string
         out["value"] = (char*) v;
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index 49398ac7..2f81eaea 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -47,11 +47,11 @@ class Configuration {
 
     revision_t getValueRevision(); 
 
-    void setRequiresReboot();
-    bool getRequiresReboot();
+    void setRebootRequired();
+    bool isRebootRequired();
 
     void setReadOnly();
-    bool getReadOnly();
+    bool isReadOnly();
 };
 
 /*
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
index 20b82ef1..c7fe18fd 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
@@ -21,7 +21,7 @@ const char* ChangeConfiguration::getOperationType(){
 
 void ChangeConfiguration::processReq(JsonObject payload) {
     const char *key = payload["key"] | "";
-    if (strlen(key) < 1) {
+    if (!*key) {
         errorCode = "FormationViolation";
         MOCPP_DBG_WARN("Could not read key");
         return;
@@ -35,7 +35,7 @@ void ChangeConfiguration::processReq(JsonObject payload) {
 
     const char *value = payload["value"];
 
-    std::shared_ptr<AbstractConfiguration> configuration = getConfiguration(key);
+    std::shared_ptr<Configuration> configuration = getConfigurationPublic(key);
 
     if (!configuration) {
         //configuration not found or hidden configuration
@@ -43,15 +43,9 @@ void ChangeConfiguration::processReq(JsonObject payload) {
         return;
     }
 
-    if (!configuration->permissionRemotePeerCanWrite()) {
+    if (configuration->isReadOnly()) {
         MOCPP_DBG_WARN("Trying to override readonly value");
-
-        if (configuration->permissionRemotePeerCanRead()) {
-            readOnly = true;
-        } else {
-            //can neither read nor write -> hidden config
-            notSupported = true;
-        }
+        readOnly = true;
         return;
     }
 
@@ -133,47 +127,35 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     
     //Store (parsed) value to Config
 
-    if (!strcmp(configuration->getSerializedType(), SerializedType<int>::get()) && convertibleInt) {
-        std::shared_ptr<Configuration<int>> configurationConcrete = std::static_pointer_cast<Configuration<int>>(configuration);
-        *configurationConcrete = numInt;
-    } else if (!strcmp(configuration->getSerializedType(), SerializedType<float>::get()) && convertibleFloat) {
-        std::shared_ptr<Configuration<float>> configurationConcrete = std::static_pointer_cast<Configuration<float>>(configuration);
-        *configurationConcrete = numFloat;
-    } else if (!strcmp(configuration->getSerializedType(), SerializedType<bool>::get()) && convertibleBool) {
-        std::shared_ptr<Configuration<bool>> configurationConcrete = std::static_pointer_cast<Configuration<bool>>(configuration);
-        *configurationConcrete = numBool;
-    } else if (!strcmp(configuration->getSerializedType(), SerializedType<const char *>::get())) {
-        std::shared_ptr<Configuration<const char *>> configurationConcrete = std::static_pointer_cast<Configuration<const char *>>(configuration);
-        
+    if (configuration->getType() == TConfig::Int && convertibleInt) {
+        configuration->setInt(numInt);
+    } else if (configuration->getType() == TConfig::Bool && convertibleBool) {
+        configuration->setBool(numBool);
+    } else if (configuration->getType() == TConfig::String) {
         //string configurations can have a validator
-        auto validator = configurationConcrete->getValidator();
-        if (validator && !validator(value)) {
+        auto validator = getConfigurationValidator(key);
+        if (validator && !(*validator)(value)) {
             //validator exists and validation fails
             reject = true;
             MOCPP_DBG_WARN("validation failed for key=%s value=%s", key, value);
             return;
         }
-
-        *configurationConcrete = value;
+        configuration->setString(value);
     } else {
         reject = true;
         MOCPP_DBG_WARN("Value has incompatible type");
         return;
     }
 
-    //success
-
     if (!configuration_save()) {
         MOCPP_DBG_ERR("could not write changes to flash");
         errorCode = "InternalError";
         return;
     }
 
-    if (configuration->requiresRebootWhenChanged()) {
+    if (configuration->isRebootRequired()) {
         rebootRequired = true;
     }
-
-    //success
 }
 
 std::unique_ptr<DynamicJsonDocument> ChangeConfiguration::createConf(){
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index f9e5c320..99eee304 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -26,59 +26,120 @@ void GetConfiguration::processReq(JsonObject payload) {
 
 std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
 
-    std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>> configurationKeys;
     std::vector<Configuration*> configurations;
-    std::vector<std::string> unknownKeys;
-
-    if (keys.size() == 0){ //return all existing keys
-        configurationKeys = getAllConfigurations();
-    } else { //only return keys that were searched using the "key" parameter
-        configurationKeys = std::unique_ptr<std::vector<std::shared_ptr<AbstractConfiguration>>>(
-                                        new std::vector<std::shared_ptr<AbstractConfiguration>>()
-        );
-        for (size_t i = 0; i < keys.size(); i++) {
-            std::shared_ptr<AbstractConfiguration> entry = getConfiguration(keys.at(i).c_str());
-            if (entry)
-                configurationKeys->push_back(entry);
-            else
-                unknownKeys.push_back(keys.at(i).c_str());
+    std::vector<const char*> unknownKeys;
+
+    auto containers = getConfigurationContainersPublic();
+
+    if (keys.empty()) {
+        //return all existing keys
+        for (auto container : containers) {
+            for (size_t i = 0; i < container->getConfigurationCount(); i++) {
+                if (!container->getConfiguration(i)->getKey()) {
+                    MOCPP_DBG_ERR("invalid config");
+                    continue;
+                }
+                configurations.push_back(container->getConfiguration(i));
+            }
+        }
+    } else {
+        //only return keys that were searched using the "key" parameter
+        for (auto& key : keys) {
+            Configuration *res = nullptr;
+            for (auto container : containers) {
+                if (res = container->getConfiguration(key.c_str())) {
+                    break;
+                }
+            }
+
+            if (res) {
+                configurations.push_back(res);
+            } else {
+                unknownKeys.push_back(key.c_str());
+            }
         }
     }
 
-    size_t capacity = JSON_OBJECT_SIZE(2); //configurationKey, unknownKey
-    std::vector<std::unique_ptr<DynamicJsonDocument>> configurationKeysJson;
-
-    for (auto confKey = configurationKeys->begin(); confKey != configurationKeys->end(); confKey++) {
-        auto entry = (*confKey)->toJsonOcppMsgEntry();
-        if (entry) {
-            capacity += entry->memoryUsage();
-            configurationKeysJson.push_back(std::move(entry));
+    #define VALUE_BUFSIZE 30
+
+    //capacity of the resulting document
+    size_t jcapacity = JSON_OBJECT_SIZE(2); //document root: configurationKey, unknownKey
+
+    jcapacity += JSON_ARRAY_SIZE(configurations.size()) + configurations.size() * JSON_OBJECT_SIZE(3); //configurationKey: [{"key":...},{"key":...}]
+    for (auto config : configurations) {
+        //need to store ints by copied string: measure necessary capacity
+        if (config->getType() == TConfig::Int) {
+            char vbuf [VALUE_BUFSIZE];
+            auto ret = snprintf(vbuf, VALUE_BUFSIZE, "%i", config.getInt());
+            if (ret < 0 || ret >= VALUE_BUFSIZE) {
+                continue;
+            }
+            jcapacity = ret + 1;
         }
     }
 
-    for (auto unknownKey = unknownKeys.begin(); unknownKey != unknownKeys.end(); unknownKey++) {
-        capacity += unknownKey->length() + 1;
+    jcapacity += JSON_ARRAY_SIZE(unknownKeys.size());
+    
+    MOCPP_DBG_DEBUG("GetConfiguration capacity: %zu", jcapacity);
+
+    std::unique_ptr<DynamicJsonDocument> doc;
+
+    if (jcapacity <= MOCPP_MAX_JSON_CAPACITY) {
+        doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(jcapacity));
     }
 
-    capacity += JSON_ARRAY_SIZE(configurationKeysJson.size())
-                + JSON_ARRAY_SIZE(unknownKeys.size());
-    
-    MOCPP_DBG_DEBUG("GetConfiguration capacity: %zu", capacity);
-    
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
+    if (!doc || doc->capacity() < jcapacity) {
+        if (doc) {MOCPP_DBG_ERR("OOM");(void)0;}
+
+        errorCode = "InternalError";
+        errorDescription = "Query too big. Try fewer keys";
+        return nullptr;
+    }
 
     JsonObject payload = doc->to<JsonObject>();
     
     JsonArray jsonConfigurationKey = payload.createNestedArray("configurationKey");
-    for (size_t i = 0; i < configurationKeys->size(); i++) {
-        jsonConfigurationKey.add(configurationKeysJson.at(i)->as<JsonObject>());
+    for (auto config : configurations) {
+        char vbuf [VALUE_BUFSIZE];
+        const char *v = "";
+        switch (config->getType()) {
+            case TConfig::Int: {
+                auto ret = snprintf(vbuf, VALUE_BUFSIZE, "%i", config.getInt());
+                if (ret < 0 || ret >= VALUE_BUFSIZE) {
+                    MOCPP_DBG_ERR("value error");
+                    continue;
+                }
+                v = vbuf;
+            }
+            case TConfig::Bool:
+                v = config.getBool() ? "true" : "false";
+                break;
+            case TConfig::String:
+                v = config.getString();
+                if (!v) {
+                    MOCPP_DBG_ERR("invalid config");
+                    continue;
+                }
+                break;
+        }
+
+        JsonObject jconfig = jsonConfigurationKey.createNestedObject();
+        jconfig["key"] = config.getKey();
+        jconfig["readonly"] = config.isReadOnly();
+        if (v == vbuf) {
+            //value points to buffer on stack, needs to be copied into JSON memory pool
+            jconfig["value"] = (char*) v;
+        } else {
+            //value is static, no-copy mode
+            jconfig["value"] = v;
+        }
     }
 
-    if (unknownKeys.size() > 0) {
+    if (!unknownKeys.empty()) {
         JsonArray jsonUnknownKey = payload.createNestedArray("unknownKey");
-        for (auto unknownKey = unknownKeys.begin(); unknownKey != unknownKeys.end(); unknownKey++) {
-            MOCPP_DBG_DEBUG("Unknown key: %s", unknownKey->c_str())
-            jsonUnknownKey.add(*unknownKey);
+        for (auto key : unknownKeys) {
+            MOCPP_DBG_DEBUG("Unknown key: %s", key)
+            jsonUnknownKey.add(key);
         }
     }
 
diff --git a/src/MicroOcpp/Operations/GetConfiguration.h b/src/MicroOcpp/Operations/GetConfiguration.h
index b317d63c..47da8519 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.h
+++ b/src/MicroOcpp/Operations/GetConfiguration.h
@@ -15,6 +15,9 @@ namespace Ocpp16 {
 class GetConfiguration : public Operation {
 private:
     std::vector<std::string> keys;
+
+    const char *errorCode {nullptr};
+    const char *errorDescription = "";
 public:
     GetConfiguration();
 
@@ -24,6 +27,9 @@ class GetConfiguration : public Operation {
 
     std::unique_ptr<DynamicJsonDocument> createConf() override;
 
+    const char *getErrorCode() override {return errorCode;}
+    const char *getErrorDescription() override {return errorDescription;}
+
 };
 
 } //end namespace Ocpp16

From cff36dcf83e62aa5bc2ad7dafd03b0f2dbe80434 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 19 Sep 2023 16:42:23 +0200
Subject: [PATCH 375/549] configs fixes and migration

---
 src/MicroOcpp.cpp                             |  10 +-
 src/MicroOcpp/Core/Configuration.cpp          |  74 +++++++---
 src/MicroOcpp/Core/Configuration.h            |   7 +-
 src/MicroOcpp/Core/ConfigurationContainer.cpp |  19 ++-
 src/MicroOcpp/Core/ConfigurationContainer.h   |   6 +-
 .../Core/ConfigurationContainerFlash.cpp      |  70 +++++----
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp  | 133 ++++++------------
 src/MicroOcpp/Core/ConfigurationKeyValue.h    |   6 +-
 src/MicroOcpp/Core/RequestStore.cpp           |  25 ++--
 src/MicroOcpp/Core/RequestStore.h             |   4 +-
 .../Authorization/AuthorizationService.cpp    |  31 ++--
 .../Authorization/AuthorizationService.h      |   4 +-
 src/MicroOcpp/Model/Boot/BootService.cpp      |   6 +-
 src/MicroOcpp/Model/Boot/BootService.h        |   2 +-
 .../Model/ConnectorBase/Connector.cpp         |  71 +++++-----
 src/MicroOcpp/Model/ConnectorBase/Connector.h |  32 +++--
 .../Model/ConnectorBase/ConnectorsCommon.cpp  |  26 +---
 .../Model/Diagnostics/DiagnosticsService.cpp  |  10 --
 .../FirmwareManagement/FirmwareService.cpp    |  20 +--
 .../FirmwareManagement/FirmwareService.h      |   2 +-
 .../Model/Heartbeat/HeartbeatService.cpp      |   4 +-
 .../Model/Heartbeat/HeartbeatService.h        |   2 +-
 src/MicroOcpp/Model/Metering/MeterValue.cpp   |  21 +--
 src/MicroOcpp/Model/Metering/MeterValue.h     |   6 +-
 .../Model/Metering/MeteringConnector.cpp      |  54 +++----
 .../Model/Metering/MeteringConnector.h        |  18 +--
 .../Model/Metering/MeteringService.cpp        |  42 ++----
 src/MicroOcpp/Model/Model.cpp                 |  90 +++++++++++-
 src/MicroOcpp/Model/Model.h                   |   7 +-
 .../Model/Reservation/Reservation.cpp         |  82 ++++++-----
 src/MicroOcpp/Model/Reservation/Reservation.h |  27 +++-
 .../Model/Reservation/ReservationService.cpp  |  69 ++++-----
 .../Model/Reservation/ReservationService.h    |   6 +-
 src/MicroOcpp/Model/Reset/ResetService.cpp    |   4 +-
 src/MicroOcpp/Model/Reset/ResetService.h      |   4 +-
 .../SmartCharging/SmartChargingService.cpp    |  28 ++--
 .../Model/Transactions/TransactionStore.cpp   |  56 ++++----
 .../Model/Transactions/TransactionStore.h     |  15 +-
 src/MicroOcpp/Operations/BootNotification.cpp |   6 +-
 .../Operations/ChangeConfiguration.cpp        |   2 +-
 src/MicroOcpp/Operations/GetConfiguration.cpp |  16 +--
 src/MicroOcpp/Operations/ReserveNow.cpp       |   4 +-
 tests/Api.cpp                                 |   9 +-
 tests/ChargingSessions.cpp                    |  21 +--
 tests/ConfigurationBehavior.cpp               |  41 +++---
 tests/Metering.cpp                            |  67 ++++-----
 tests/SmartCharging.cpp                       |   1 +
 tests/TransactionSafety.cpp                   |   4 +-
 tests/ocppEngineLifecycle.cpp                 |   1 +
 49 files changed, 669 insertions(+), 596 deletions(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index b286fd19..6ed3fbd7 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -136,6 +136,8 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         return;
     }
 
+    MOCPP_DBG_DEBUG("initialize OCPP");
+
     filesystem = fs;
     MOCPP_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "deactivated");
 
@@ -172,9 +174,9 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new BootService(*context, filesystem)));
     model.setConnectorsCommon(std::unique_ptr<ConnectorsCommon>(
         new ConnectorsCommon(*context, MOCPP_NUMCONNECTORS, filesystem)));
-    std::vector<Connector> connectors;
+    std::vector<std::unique_ptr<Connector>> connectors;
     for (unsigned int connectorId = 0; connectorId < MOCPP_NUMCONNECTORS; connectorId++) {
-        connectors.push_back(Connector(*context, connectorId));
+        connectors.emplace_back(new Connector(*context, connectorId));
     }
     model.setConnectors(std::move(connectors));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
@@ -214,6 +216,8 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         model.getFirmwareService()->setBuildNumber((*credsJson)["firmwareVersion"]);
     }
     credsJson.reset();
+
+    configuration_load();
 }
 
 void mocpp_deinitialize() {
@@ -242,6 +246,8 @@ void mocpp_deinitialize() {
     filesystem.reset();
 
     configuration_deinit();
+
+    MOCPP_DBG_DEBUG("deinitialized OCPP\n");
 }
 
 void mocpp_loop() {
diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index 6b78e8af..dfcf3f6a 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -15,6 +15,9 @@ namespace MicroOcpp {
 struct Validator {
     const char *key = nullptr;
     std::function<bool(const char*)> checkValue;
+    Validator(const char *key, std::function<bool(const char*)> checkValue) : key(key), checkValue(checkValue) {
+
+    }
 };
 
 namespace ConfigurationLocal {
@@ -58,8 +61,7 @@ std::shared_ptr<ConfigurationContainer> getContainer(const char *filename) {
     }
 }
 
-template<class T>
-std::shared_ptr<Configuration> declareConfiguration(const char *key, T factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible) {
+ConfigurationContainer *declareContainer(const char *filename, bool accessible) {
 
     auto container = getContainer(filename);
     
@@ -72,33 +74,38 @@ std::shared_ptr<Configuration> declareConfiguration(const char *key, T factoryDe
             return nullptr;
         }
         configurationContainers.push_back(container);
-
-        if (!container->load()) {
-            MOCPP_DBG_WARN("Cannot load file contents. Path will be overwritten");
-            (void)0;
-        }
     }
 
     if (container->isAccessible() != accessible) {
-        MOCPP_DBG_ERR("key %s: declared %s but config file is %s", key, accessible ? "accessible" : "inaccessible", container->isAccessible() ? "accessible" : "inaccessible");
+        MOCPP_DBG_ERR("%s: conflicting accessibility declarations (expect %s)", filename, container->isAccessible() ? "accessible" : "inaccessible");
         (void)0;
     }
 
-    std::shared_ptr<Configuration> configuration;
-
-    switch (convertType<T>()) {
-        case TConfig::Int:
-            configuration = container->declareConfigurationInt(key, factoryDef, readonly, rebootRequired);
-            break;
-        case TConfig::Bool:
-            configuration = container->declareConfigurationBool(key, factoryDef, readonly, rebootRequired);
-            break;
-        case TConfig::String:
-            configuration = container->declareConfigurationString(key, factoryDef, readonly, rebootRequired);
-            break;
+    return container.get();
+}
+
+template<>
+std::shared_ptr<Configuration> declareConfiguration<int>(const char *key, int factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible) {
+    if (auto container = declareContainer(filename, accessible)) {
+        return container->declareConfigurationInt(key, factoryDef, readonly, rebootRequired);
+    }
+    return nullptr;
+}
+
+template<>
+std::shared_ptr<Configuration> declareConfiguration<bool>(const char *key, bool factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible) {
+    if (auto container = declareContainer(filename, accessible)) {
+        return container->declareConfigurationBool(key, factoryDef, readonly, rebootRequired);
     }
+    return nullptr;
+}
 
-    return configuration;
+template<>
+std::shared_ptr<Configuration> declareConfiguration<const char*>(const char *key, const char *factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible) {
+    if (auto container = declareContainer(filename, accessible)) {
+        return container->declareConfigurationString(key, factoryDef, readonly, rebootRequired);
+    }
+    return nullptr;
 }
 
 std::function<bool(const char*)> *getConfigurationValidator(const char *key) {
@@ -148,6 +155,7 @@ std::vector<ConfigurationContainer*> getConfigurationContainersPublic() {
 
 bool configuration_init(std::shared_ptr<FilesystemAdapter> _filesystem) {
     filesystem = _filesystem;
+    return true;
 }
 
 void configuration_deinit() {
@@ -156,6 +164,30 @@ void configuration_deinit() {
     filesystem.reset();
 }
 
+bool configuration_load() {
+    bool success = true;
+
+    for (auto& container : configurationContainers) {
+        if (!container->load()) {
+            success = false;
+        }
+    }
+
+    return success;
+}
+
+bool configuration_load(const char *filename) {
+    bool success = true;
+
+    for (auto& container : configurationContainers) {
+        if (!strcmp(filename, container->getFilename()) && !container->load()) {
+            success = false;
+        }
+    }
+
+    return success;
+}
+
 bool configuration_save() {
     bool success = true;
 
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index 0dc941cf..a872d840 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -16,10 +16,6 @@
 #define CONFIGURATION_VOLATILE "/volatile"
 #define MOCPP_KEYVALUE_FN (MOCPP_FILENAME_PREFIX "client-state.jsn")
 
-#ifndef MOCPP_CONFIG_EXT_PREFIX
-#define MOCPP_CONFIG_EXT_PREFIX "Cst_"
-#endif
-
 namespace MicroOcpp {
 
 /*
@@ -39,6 +35,9 @@ std::vector<ConfigurationContainer*> getConfigurationContainersPublic();
 bool configuration_init(std::shared_ptr<FilesystemAdapter> filesytem);
 void configuration_deinit();
 
+bool configuration_load();
+bool configuration_load(const char *filename);
+
 bool configuration_save();
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index df92370c..a5581364 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -8,6 +8,10 @@
 
 namespace MicroOcpp {
 
+ConfigurationContainer::~ConfigurationContainer() {
+
+}
+
 std::shared_ptr<Configuration> ConfigurationPool::getConfiguration_typesafe(const char *key, TConfig type) {
     for (auto entry = configurations.begin(); entry != configurations.end();entry++) {
         if ((*entry)->getKey() && !strcmp((*entry)->getKey(), key)) {
@@ -25,13 +29,13 @@ std::shared_ptr<Configuration> ConfigurationPool::getConfiguration_typesafe(cons
 }
 
 template<class T>
-std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration(const char *key, T factoryDef, bool readonly = false, bool rebootRequired = false) {
+std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration(const char *key, T factoryDef, bool readonly, bool rebootRequired) {
     
     std::shared_ptr<Configuration> res = getConfiguration_typesafe(key, convertType<T>());
 
     if (!res) {
         //config doesn't exist yet
-        res = makeConfigInt(key, factoryDef);
+        res = makeConfig<T>(key, factoryDef);
         if (!res) {
             //allocation failure - OOM
             MOCPP_DBG_ERR("OOM");
@@ -51,6 +55,14 @@ std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration(const cha
     return res;
 }
 
+template std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<int>(const char *key, int factoryDef, bool readonly, bool rebootRequired);
+template std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<bool>(const char *key, bool factoryDef, bool readonly, bool rebootRequired);
+template std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<const char*>(const char *key, const char *factoryDef, bool readonly, bool rebootRequired);
+
+std::vector<std::shared_ptr<Configuration>>& ConfigurationPool::getConfigurations() {
+    return configurations;
+}
+
 size_t ConfigurationPool::getConfigurationCount() const {
         return configurations.size();
     }
@@ -61,10 +73,11 @@ Configuration *ConfigurationPool::getConfiguration(size_t i) const {
 
 Configuration *ConfigurationPool::getConfiguration(const char *key) const {
     for (auto& entry : configurations) {
-        if (!strcmp(entry->getKey(), key)) {
+        if (entry->getKey() && !strcmp(entry->getKey(), key)) {
             return entry.get();
         }
     }
+    return nullptr;
 }
 
 class ConfigurationContainerVolatile : public ConfigurationContainer {
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index 0c504fb1..94988078 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -19,6 +19,8 @@ class ConfigurationContainer {
 public:
     ConfigurationContainer(const char *filename, bool accessible) : filename(filename), accessible(accessible) { }
 
+    virtual ~ConfigurationContainer();
+
     const char *getFilename() {return filename;}
     bool isAccessible() {return accessible;}
 
@@ -54,10 +56,6 @@ class ConfigurationPool {
     Configuration *getConfiguration(const char *key) const;
 };
 
-template<> std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<int>(const char *key, int factoryDef, bool readonly, bool rebootRequired);
-template<> std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<bool>(const char *key, bool factoryDef, bool readonly, bool rebootRequired);
-template<> std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<const char*>(const char *key, const char *factoryDef, bool readonly, bool rebootRequired);
-
 std::unique_ptr<ConfigurationContainer> makeConfigurationContainerVolatile(const char *filename, bool accessible);
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index 4f3a0b79..1068cbb5 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -3,6 +3,8 @@
 // MIT License
 
 #include <MicroOcpp/Core/ConfigurationContainerFlash.h>
+
+#include <algorithm>
 #include <MicroOcpp/Core/FilesystemUtils.h>
 #include <MicroOcpp/Debug.h>
 
@@ -16,13 +18,20 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
     std::shared_ptr<FilesystemAdapter> filesystem;
     uint16_t revisionSum = 0;
 
-    std::vector<std::string> keyPool;
+    bool loaded = false;
+
+    std::vector<std::unique_ptr<char[]>> keyPool;
     
     void clearKeyPool(const char *key) {
         keyPool.erase(std::remove_if(keyPool.begin(), keyPool.end(), 
-            [key] (std::string& k) {
-                return !k.compare(key);
-            }));
+            [key] (const std::unique_ptr<char[]>& k) {
+#if MOCPP_DBG_LEVEL >= MOCPP_DL_VERBOSE
+                if (!strcmp(k.get(), key)) {
+                    MOCPP_DBG_VERBOSE("clear key %s", key);
+                }
+#endif
+                return !strcmp(k.get(), key);
+            }), keyPool.end());
     }
 
     bool configurationsUpdated() {
@@ -30,20 +39,22 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
 
         revisionSum = 0;
         auto& configurations = container.getConfigurations();
-        for (size_t i = 0; i < configurations.size(); i++) {
-            revisionSum += configurations[i]->getValueRevision();
+        for (auto& config : configurations) {
+            revisionSum += config->getValueRevision();
         }
 
-        return revisionSum == revisionSum_old;
+        return revisionSum != revisionSum_old;
     }
 public:
     ConfigurationContainerFlash(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename, bool accessible) :
             ConfigurationContainer(filename, accessible), filesystem(filesystem) { }
 
-    ~ConfigurationContainerFlash() = default;
-
     bool load() override {
 
+        if (loaded) {
+            return true;
+        }
+
         if (!filesystem) {
             return false;
         }
@@ -103,11 +114,12 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                 continue;
             }
             
-            std::string key_pooled;
+            std::unique_ptr<char[]> key_pooled;
 
             Configuration *config = container.getConfiguration(key);
             if (!config || config->getType() != type) {
-                key_pooled = key;
+                key_pooled.reset(new char[strlen(key) + 1]);
+                strcpy(key_pooled.get(), key);
                 config = nullptr;
             }
 
@@ -123,11 +135,11 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                         config->setInt(value);
                     } else {
                         //create new config
-                        config = container.declareConfiguration<int>(key_pooled.c_str(), value).get();
+                        config = container.declareConfiguration<int>(key_pooled.get(), value).get();
                     }
                     break;
                 }
-                case (TConfig::Bool):
+                case TConfig::Bool: {
                     if (!stored["value"].is<bool>()) {
                         MOCPP_DBG_ERR("corrupt config");
                         continue;
@@ -138,10 +150,11 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                         config->setBool(value);
                     } else {
                         //create new config
-                        config = container.declareConfiguration<bool>(key_pooled.c_str(), value).get();
+                        config = container.declareConfiguration<bool>(key_pooled.get(), value).get();
                     }
                     break;
-                case (TConfig::String):
+                }
+                case TConfig::String: {
                     if (!stored["value"].is<const char*>()) {
                         MOCPP_DBG_ERR("corrupt config");
                         continue;
@@ -149,20 +162,21 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                     const char *value = stored["value"] | "";
                     if (config) {
                         //config already exists
-                        config->setBool(value);
+                        config->setString(value);
                     } else {
                         //create new config
-                        config = container.declareConfiguration<bool>(key_pooled.c_str(), value).get();
+                        config = container.declareConfiguration<const char*>(key_pooled.get(), value).get();
                     }
                     break;
+                }
             }
 
             if (config) {
                 //success
 
-                if (!key_pooled.empty()) {
+                if (key_pooled) {
                     //allocated key, need to store
-                    keyPool.push_back(std::string(key));
+                    keyPool.push_back(std::move(key_pooled));
                 }
             } else {
                 MOCPP_DBG_ERR("OOM: %s", key);
@@ -173,6 +187,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         configurationsUpdated();
 
         MOCPP_DBG_DEBUG("Initialization finished");
+        loaded = true;
         return true;
     }
 
@@ -188,6 +203,14 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
 
         auto& configurations = container.getConfigurations();
 
+        //during mocpp_deinitialize(), key owners are destructed. Don't store if this container is affected
+        for (auto& config : configurations) {
+            if (!config->getKey()) {
+                MOCPP_DBG_DEBUG("don't write back container with destructed key(s)");
+                return false;
+            }
+        }
+
         size_t jsonCapacity = 2 * JSON_OBJECT_SIZE(2); //head + configurations + head payload
         jsonCapacity += JSON_ARRAY_SIZE(configurations.size()); //configurations array
         jsonCapacity += configurations.size() * JSON_OBJECT_SIZE(3); //config entries in array
@@ -208,10 +231,6 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
 
         for (size_t i = 0; i < configurations.size(); i++) {
             auto& config = *configurations[i];
-            if (!config.getKey()) {
-                MOCPP_DBG_ERR("corrupt config");
-                continue;
-            }
 
             size_t entryCapacity = JSON_OBJECT_SIZE(3) + (JSON_ARRAY_SIZE(2) - JSON_ARRAY_SIZE(1));
             if (trackCapacity + entryCapacity > MOCPP_MAX_JSON_CAPACITY) {
@@ -233,11 +252,6 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                     stored["value"] = config.getBool();
                     break;
                 case TConfig::String:
-                    if (!config.getString()) {
-                        MOCPP_DBG_ERR("corrupt config");
-                        configurationsArray.remove(configurationsArray.size());
-                        break;
-                    }
                     stored["value"] = config.getString();
                     break;
             }
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index bb6868d1..d44536e7 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -22,17 +22,8 @@ template<> TConfig convertType<int>() {return TConfig::Int;}
 template<> TConfig convertType<bool>() {return TConfig::Bool;}
 template<> TConfig convertType<const char*>() {return TConfig::String;}
 
-int toCStringValue(char *buf, size_t length, int value) {
-    return snprintf(buf, length, "%d", value);
-}
-
-int toCStringValue(char *buf, size_t length, float value) {
-    int ilength = (int) std::min((size_t) 100, length);
-    return snprintf(buf, length, "%.*g", ilength >= 7 ? ilength - 7 : 0, value);
-}
+Configuration::~Configuration() {
 
-int toCStringValue(char *buf, size_t length, bool value) {
-    return snprintf(buf, length, "%s", value ? "true" : "false");
 }
 
 void Configuration::setInt(int) {
@@ -51,6 +42,7 @@ bool Configuration::setString(const char*) {
 #if MOCPP_CONFIG_TYPECHECK
     MOCPP_DBG_ERR("type err");
 #endif
+    return false;
 }
 
 int Configuration::getInt() {
@@ -71,7 +63,7 @@ const char *Configuration::getString() {
 #if MOCPP_CONFIG_TYPECHECK
     MOCPP_DBG_ERR("type err");
 #endif
-    return nullptr;
+    return "";
 }
 
 revision_t Configuration::getValueRevision() {
@@ -124,6 +116,7 @@ class ConfigInt : public Configuration {
 
     void setInt(int val) override {
         this->val = val;
+        value_revision++;
     }
 
     int getInt() override {
@@ -154,6 +147,7 @@ class ConfigBool : public Configuration {
 
     void setBool(bool val) override {
         this->val = val;
+        value_revision++;
     }
 
     bool getBool() override {
@@ -168,6 +162,7 @@ class ConfigString : public Configuration {
 public:
     ConfigString() = default;
     ConfigString(const ConfigString&) = delete;
+    ConfigString(ConfigString&&) = delete;
     ConfigString& operator=(const ConfigString&) = delete;
 
     ~ConfigString() {
@@ -188,7 +183,9 @@ class ConfigString : public Configuration {
     }
 
     bool setString(const char *src) override {
-        if (!this->val && !src) {
+        bool src_empty = !src || !*src;
+
+        if (!val && src_empty) {
             return true;
         }
 
@@ -197,7 +194,7 @@ class ConfigString : public Configuration {
         }
 
         size_t size = 0;
-        if (src) {
+        if (!src_empty) {
             size = strlen(src) + 1;
         }
 
@@ -212,7 +209,7 @@ class ConfigString : public Configuration {
             this->val = nullptr;
         }
 
-        if (src) {
+        if (!src_empty) {
             this->val = (char*) malloc(size);
             if (!this->val) {
                 return false;
@@ -224,37 +221,42 @@ class ConfigString : public Configuration {
     }
 
     const char *getString() override {
+        if (!val) {
+            return "";
+        }
         return val;
     }
 };
 
-template<class T>
-std::unique_ptr<Configuration> makeConfig(const char *key, T val) {
-    std::unique_ptr<ConfigInt> res;
-    switch (convertType<T>()) {
-        case TConfig::Int:
-            res = std::unique_ptr<ConfigInt>(new ConfigInt());
-            if (res) res->setInt(val);
-            break;
-        case TConfig::Bool:
-            res = std::unique_ptr<ConfigBool>(new ConfigBool());
-            if (res) res->setBool(val);
-            break;
-        case TConfig::String:
-            res = std::unique_ptr<ConfigString>(new ConfigString());
-            if (res) res->setString(val);
-            break;
+template<>
+std::unique_ptr<Configuration> makeConfig<int>(const char *key, int val) {
+    auto res = std::unique_ptr<Configuration>(new ConfigInt());
+    if (res) {
+        res->setKey(key);
+        res->setInt(val);
     }
-    if (!res) {
-        return nullptr;
+    return res;
+};
+
+template<>
+std::unique_ptr<Configuration> makeConfig<bool>(const char *key, bool val) {
+    auto res = std::unique_ptr<Configuration>(new ConfigBool());
+    if (res) {
+        res->setKey(key);
+        res->setBool(val);
     }
-    res->setKey(key);
     return res;
-}
+};
 
-template<> std::unique_ptr<Configuration> makeConfig<int>(const char *key, int val);
-template<> std::unique_ptr<Configuration> makeConfig<bool>(const char *key, bool val);
-template<> std::unique_ptr<Configuration> makeConfig<const char*>(const char *key, const char *val);
+template<>
+std::unique_ptr<Configuration> makeConfig<const char*>(const char *key, const char *val) {
+    auto res = std::unique_ptr<Configuration>(new ConfigString());
+    if (res) {
+        res->setKey(key);
+        res->setString(val);
+    }
+    return res;
+};
 
 bool deserializeTConfig(const char *serialized, TConfig& out) {
     if (!strcmp(serialized, "int")) {
@@ -274,63 +276,14 @@ bool deserializeTConfig(const char *serialized, TConfig& out) {
 
 const char *serializeTConfig(TConfig type) {
     switch (type) {
-        case (TConfig::Int):
+        case TConfig::Int:
             return "int";
-        case (TConfig::Bool):
-            return "bool";
-        case (TConfig::String):
-            return "string";
-    }
-}
-
-bool serializeConfigOcpp(Configuration& config, DynamicJsonDocument& out) {
-
-    if (!config.getKey()) {
-        return false;
-    }
-    
-    const size_t PRIMITIVE_VALUESIZE = 30;
-    char vbuf [PRIMITIVE_VALUESIZE];
-    const char *v = vbuf;
-    size_t vcapacity = 0;
-    switch(config.getType()) {
-        case TConfig::Int: {
-            auto ret = snprintf(vbuf, PRIMITIVE_VALUESIZE, "%i", config.getInt());
-            if (ret < 0 || ret >= PRIMITIVE_VALUESIZE) {
-                return false;
-            }
-            v = vbuf;
-            vcapacity = ret + 1;
-            break;
-        }
         case TConfig::Bool:
-            v = config.getBool() ? "true" : "false";
-            vcapacity = 0;
-            break;
+            return "bool";
         case TConfig::String:
-            v = config.getString();
-            if (!v) {
-                MOCPP_DBG_ERR("invalid config");
-                return false;
-            }
-            vcapacity = 0;
-            break;
-    }
-
-    out = DynamicJsonDocument(JSON_OBJECT_SIZE(3) + vcapacity);
-
-    out["key"] = config.getKey();
-    out["readonly"] = config.isReadOnly();
-    if (vcapacity > 0) {
-        //value has capacity, copy string
-        out["value"] = (char*) v;
-    } else {
-        //value is static, no-copy mode
-        out["value"] = v;
+            return "string";
     }
-
-    return true;
+    return "_Undefined";
 }
 
-
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index 2f81eaea..5b064cf1 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -10,6 +10,10 @@
 
 #define MOCPP_CONFIG_MAX_VALSTRSIZE 128
 
+#ifndef MOCPP_CONFIG_EXT_PREFIX
+#define MOCPP_CONFIG_EXT_PREFIX "Cst_"
+#endif
+
 namespace MicroOcpp {
 
 using revision_t = uint16_t;
@@ -41,7 +45,7 @@ class Configuration {
 
     virtual int getInt();
     virtual bool getBool();
-    virtual const char *getString();
+    virtual const char *getString(); //always returns c-string (empty if undefined)
 
     virtual TConfig getType() = 0;
 
diff --git a/src/MicroOcpp/Core/RequestStore.cpp b/src/MicroOcpp/Core/RequestStore.cpp
index bdb7222c..e5f4dac0 100644
--- a/src/MicroOcpp/Core/RequestStore.cpp
+++ b/src/MicroOcpp/Core/RequestStore.cpp
@@ -96,12 +96,13 @@ bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
 }
 
 RequestStore::RequestStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
-    opBegin = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "opBegin", 0, MOCPP_OPSTORE_FN, false, false, true, false);
+    opBeginInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "opBegin", 0, MOCPP_OPSTORE_FN, false, false, false);
+    configuration_load(MOCPP_OPSTORE_FN);
 
-    if (!opBegin || *opBegin < 0) {
+    if (!opBeginInt || opBeginInt->getInt() < 0) {
         MOCPP_DBG_ERR("init failure");
     } else if (filesystem) {
-        opEnd = *opBegin;
+        opEnd = opBeginInt->getInt();
 
         unsigned int misses = 0;
         unsigned int i = opEnd;
@@ -144,13 +145,13 @@ unsigned int RequestStore::reserveOpNr() {
 }
 
 void RequestStore::advanceOpNr(unsigned int oldOpNr) {
-    if (!opBegin || *opBegin < 0) {
+    if (!opBeginInt || opBeginInt->getInt() < 0) {
         MOCPP_DBG_ERR("init failure");
         return;
     }
 
-    if (oldOpNr != (unsigned int) *opBegin) {
-        if ((oldOpNr + MOCPP_MAX_OPNR - (unsigned int) *opBegin) % MOCPP_MAX_OPNR < 100) {
+    if (oldOpNr != (unsigned int) opBeginInt->getInt()) {
+        if ((oldOpNr + MOCPP_MAX_OPNR - (unsigned int) opBeginInt->getInt()) % MOCPP_MAX_OPNR < 100) {
             MOCPP_DBG_ERR("synchronization failure - try to fix");
             (void)0;
         } else {
@@ -161,14 +162,14 @@ void RequestStore::advanceOpNr(unsigned int oldOpNr) {
 
     unsigned int opNr = (oldOpNr + 1) % MOCPP_MAX_OPNR;
 
-    //delete range [*opBegin ... opNr)
+    //delete range [opBeginInt->getInt() ... opNr)
 
-    unsigned int rangeSize = (opNr + MOCPP_MAX_OPNR - (unsigned int) *opBegin) % MOCPP_MAX_OPNR;
+    unsigned int rangeSize = (opNr + MOCPP_MAX_OPNR - (unsigned int) opBeginInt->getInt()) % MOCPP_MAX_OPNR;
 
     MOCPP_DBG_DEBUG("delete %u operations", rangeSize);
 
     for (unsigned int i = 0; i < rangeSize; i++) {
-        unsigned int op = ((unsigned int) *opBegin + i + MOCPP_MAX_OPNR - MOCPP_OPHISTORY_SIZE) % MOCPP_MAX_OPNR;
+        unsigned int op = ((unsigned int) opBeginInt->getInt() + i + MOCPP_MAX_OPNR - MOCPP_OPHISTORY_SIZE) % MOCPP_MAX_OPNR;
 
         char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
         auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "op" "-%u.jsn", op);
@@ -191,14 +192,14 @@ void RequestStore::advanceOpNr(unsigned int oldOpNr) {
     }
 
     MOCPP_DBG_DEBUG("advance opBegin: %u", opNr);
-    *opBegin = opNr;
+    opBeginInt->setInt(opNr);
     configuration_save();
 }
 
 unsigned int RequestStore::getOpBegin() {
-    if (!opBegin || *opBegin < 0) {
+    if (!opBeginInt || opBeginInt->getInt() < 0) {
         MOCPP_DBG_ERR("invalid state");
         return 0;
     }
-    return (unsigned int) *opBegin;
+    return (unsigned int) opBeginInt->getInt();
 }
diff --git a/src/MicroOcpp/Core/RequestStore.h b/src/MicroOcpp/Core/RequestStore.h
index e327bb6b..e276539f 100644
--- a/src/MicroOcpp/Core/RequestStore.h
+++ b/src/MicroOcpp/Core/RequestStore.h
@@ -15,7 +15,7 @@ namespace MicroOcpp {
 
 class RequestStore;
 class FilesystemAdapter;
-template<class T> class Configuration;
+class Configuration;
 
 class StoredOperationHandler {
 private:
@@ -48,7 +48,7 @@ class StoredOperationHandler {
 class RequestStore {
 private:
     std::shared_ptr<FilesystemAdapter> filesystem;
-    std::shared_ptr<Configuration<int>> opBegin; //Tx-related operations are stored; index of the first pending operation
+    std::shared_ptr<Configuration> opBeginInt; //Tx-related operations are stored; index of the first pending operation
     unsigned int opEnd = 0; //one place after last number
 
 public:
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 3d7f27d5..7cb03fe7 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -20,26 +20,15 @@ using namespace MicroOcpp;
 
 AuthorizationService::AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
-    localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", true, CONFIGURATION_FN, true, true, true, false);
-    localAuthListEnabled = declareConfiguration<bool>("LocalAuthListEnabled", true, CONFIGURATION_FN, true, true, true, false);
-    declareConfiguration<int>("LocalAuthListMaxLength", MOCPP_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, false, true, false, false);
-    declareConfiguration<int>("SendLocalListMaxLength", MOCPP_SendLocalListMaxLength, CONFIGURATION_VOLATILE, false, true, false, false);
+    localAuthorizeOfflineBool = declareConfiguration<bool>("LocalAuthorizeOffline", true);
+    localAuthListEnabledBool = declareConfiguration<bool>("LocalAuthListEnabled", true);
+    declareConfiguration<int>("LocalAuthListMaxLength", MOCPP_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<int>("SendLocalListMaxLength", MOCPP_SendLocalListMaxLength, CONFIGURATION_VOLATILE, true);
 
-    if (!localAuthorizeOffline || !localAuthListEnabled) {
+    if (!localAuthorizeOfflineBool || !localAuthListEnabledBool) {
         MOCPP_DBG_ERR("initialization error");
     }
-
-    //append "LocalAuthListManagement" to FeatureProfiles list
-    const char *fpId = "LocalAuthListManagement";
-    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
-    if (!strstr(*fProfile, fpId)) {
-        auto fProfilePlus = std::string(*fProfile);
-        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
-            fProfilePlus += ",";
-        fProfilePlus += fpId;
-        *fProfile = fProfilePlus.c_str();
-    }
-
+    
     context.getOperationRegistry().registerOperation("GetLocalListVersion", [&context] () {
         return new Ocpp16::GetLocalListVersion(context.getModel());});
     context.getOperationRegistry().registerOperation("SendLocalList", [&context] () {
@@ -81,11 +70,11 @@ bool AuthorizationService::loadLists() {
 }
 
 AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag) {
-    if (!*localAuthorizeOffline) {
+    if (!localAuthorizeOfflineBool->getBool()) {
         return nullptr;
     }
 
-    if (!*localAuthListEnabled) {
+    if (!localAuthListEnabledBool->getBool()) {
         return nullptr; //auth cache will follow
     }
 
@@ -125,11 +114,11 @@ bool AuthorizationService::updateLocalList(JsonObject payload) {
 void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idTagInfo) {
     //check local list conflicts. In future: also update authorization cache
 
-    if (!*localAuthorizeOffline) {
+    if (!localAuthorizeOfflineBool->getBool()) {
         return;
     }
 
-    if (!*localAuthListEnabled) {
+    if (!localAuthListEnabledBool->getBool()) {
         return; //auth cache will follow
     }
 
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.h b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
index 89289ffb..4deb4bc6 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
@@ -19,8 +19,8 @@ class AuthorizationService {
     std::shared_ptr<FilesystemAdapter> filesystem;
     AuthorizationList localAuthorizationList;
 
-    std::shared_ptr<Configuration<bool>> localAuthorizeOffline;
-    std::shared_ptr<Configuration<bool>> localAuthListEnabled;
+    std::shared_ptr<Configuration> localAuthorizeOfflineBool;
+    std::shared_ptr<Configuration> localAuthListEnabledBool;
 
 public:
     AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem);
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index 822224da..98a960c5 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -36,9 +36,9 @@ RegistrationStatus MicroOcpp::deserializeRegistrationStatus(const char *serializ
 BootService::BootService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
     //if transactions can start before the BootNotification succeeds
-    preBootTransactions = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", false, CONFIGURATION_FN, true, true, true, false);
+    preBootTransactionsBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", false);
     
-    if (!preBootTransactions) {
+    if (!preBootTransactionsBool) {
         MOCPP_DBG_ERR("initialization error");
         (void)0;
     }
@@ -69,7 +69,7 @@ void BootService::loop() {
         activatedPostBootCommunication = true;
     }
 
-    if (!activatedModel && (status == RegistrationStatus::Accepted || *preBootTransactions)) {
+    if (!activatedModel && (status == RegistrationStatus::Accepted || preBootTransactionsBool->getBool())) {
         context.getModel().activateTasks();
         activatedModel = true;
     }
diff --git a/src/MicroOcpp/Model/Boot/BootService.h b/src/MicroOcpp/Model/Boot/BootService.h
index ba3017f6..2c542e3d 100644
--- a/src/MicroOcpp/Model/Boot/BootService.h
+++ b/src/MicroOcpp/Model/Boot/BootService.h
@@ -45,7 +45,7 @@ class BootService {
     
     std::string cpCredentials;
 
-    std::shared_ptr<Configuration<bool>> preBootTransactions;
+    std::shared_ptr<Configuration> preBootTransactionsBool;
 
     bool activatedModel = false;
     bool activatedPostBootCommunication = false;
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index e26bc7ba..f9d6d91e 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -30,30 +30,29 @@ using namespace MicroOcpp::Ocpp16;
 Connector::Connector(Context& context, int connectorId)
         : context(context), model(context.getModel()), connectorId{connectorId} {
 
-    char availabilityKey [CONF_KEYLEN_MAX + 1] = {'\0'};
-    snprintf(availabilityKey, CONF_KEYLEN_MAX + 1, MOCPP_CONFIG_EXT_PREFIX "AVAIL_CONN_%d", connectorId);
-    availability = declareConfiguration<bool>(availabilityKey, true, MOCPP_KEYVALUE_FN, false, false, true, false);
-
-    connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN, true, true, true, false);
-    minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN, true, true, true, false);
-    stopTransactionOnInvalidId = declareConfiguration<bool>("StopTransactionOnInvalidId", true, CONFIGURATION_FN, true, true, true, false);
-    stopTransactionOnEVSideDisconnect = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
-    unlockConnectorOnEVSideDisconnect = declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", true, CONFIGURATION_FN, true, true, true, false);
-    localPreAuthorize = declareConfiguration<bool>("LocalPreAuthorize", false, CONFIGURATION_FN, true, true, true, false);
-    allowOfflineTxForUnknownId = MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", false, CONFIGURATION_FN);
+    snprintf(availabilityBoolKey, sizeof(availabilityBoolKey), MOCPP_CONFIG_EXT_PREFIX "AVAIL_CONN_%d", connectorId);
+    availabilityBool = declareConfiguration<bool>(availabilityBoolKey, true, MOCPP_KEYVALUE_FN, false, false, false);
+    
+    connectionTimeOutInt = declareConfiguration<int>("ConnectionTimeOut", 30);
+    minimumStatusDurationInt = declareConfiguration<int>("MinimumStatusDuration", 0);
+    stopTransactionOnInvalidIdBool = declareConfiguration<bool>("StopTransactionOnInvalidId", true);
+    stopTransactionOnEVSideDisconnectBool = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true);
+    declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", true, CONFIGURATION_VOLATILE, true);
+    localPreAuthorizeBool = declareConfiguration<bool>("LocalPreAuthorize", false);
+    allowOfflineTxForUnknownIdBool = MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", false);
 
     //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
-    silentOfflineTransactions = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "SilentOfflineTransactions", false, CONFIGURATION_FN, true, true, true, false);
+    silentOfflineTransactionsBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "SilentOfflineTransactions", false);
 
     //how long the EVSE tries the Authorize request before it enters offline mode
-    authorizationTimeout = MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20, CONFIGURATION_FN);
+    authorizationTimeoutInt = MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
 
     //FreeVend mode
-    freeVendActive = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "FreeVendActive", false, CONFIGURATION_FN, true, true, true, false);
-    freeVendIdTag = declareConfiguration<const char*>(MOCPP_CONFIG_EXT_PREFIX "FreeVendIdTag", "", CONFIGURATION_FN, true, true, true, false);
+    freeVendActiveBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "FreeVendActive", false);
+    freeVendIdTagString = declareConfiguration<const char*>(MOCPP_CONFIG_EXT_PREFIX "FreeVendIdTag", "");
 
-    if (!availability) {
-        MOCPP_DBG_ERR("Cannot declare availability");
+    if (!availabilityBool) {
+        MOCPP_DBG_ERR("Cannot declare availabilityBool");
     }
 
     if (model.getTransactionStore()) {
@@ -64,6 +63,12 @@ Connector::Connector(Context& context, int connectorId)
     }
 }
 
+Connector::~Connector() {
+    if (availabilityBool->getKey() == availabilityBoolKey) {
+        availabilityBool->setKey(nullptr);
+    }
+}
+
 ChargePointStatus Connector::getStatus() {
     /*
     * Handle special case: This is the Connector for the whole CP (i.e. connectorId=0) --> only states Available, Unavailable, Faulted are possible
@@ -129,7 +134,7 @@ bool Connector::ocppPermitsCharge() {
     bool suspendDeAuthorizedIdTag = transaction && transaction->isIdTagDeauthorized(); //if idTag status is "DeAuthorized" and if charging should stop
     
     //check special case for DeAuthorized idTags: FreeVend mode
-    if (suspendDeAuthorizedIdTag && freeVendActive && *freeVendActive) {
+    if (suspendDeAuthorizedIdTag && freeVendActiveBool && freeVendActiveBool->getBool()) {
         suspendDeAuthorizedIdTag = false;
     }
 
@@ -175,7 +180,7 @@ void Connector::loop() {
             
         if (connectorPluggedInput) {
             if (transaction->isRunning() && transaction->isActive() && !connectorPluggedInput()) {
-                if (!stopTransactionOnEVSideDisconnect || *stopTransactionOnEVSideDisconnect) {
+                if (!stopTransactionOnEVSideDisconnectBool || stopTransactionOnEVSideDisconnectBool->getBool()) {
                     MOCPP_DBG_DEBUG("Stop Tx due to EV disconnect");
                     transaction->setStopReason("EVDisconnected");
                     transaction->setInactive();
@@ -187,8 +192,8 @@ void Connector::loop() {
         if (transaction->isActive() &&
                 !transaction->getStartSync().isRequested() &&
                 transaction->getBeginTimestamp() > MIN_TIME &&
-                connectionTimeOut && *connectionTimeOut > 0 &&
-                model.getClock().now() - transaction->getBeginTimestamp() >= *connectionTimeOut) {
+                connectionTimeOutInt && connectionTimeOutInt->getInt() > 0 &&
+                model.getClock().now() - transaction->getBeginTimestamp() >= connectionTimeOutInt->getInt()) {
                 
             MOCPP_DBG_INFO("Session mngt: timeout");
             transaction->setInactive();
@@ -200,7 +205,7 @@ void Connector::loop() {
         if (transaction->isActive() &&
                 transaction->isIdTagDeauthorized() && ( //transaction has been deAuthorized
                     !transaction->isRunning() ||        //if transaction hasn't started yet, always end
-                    !stopTransactionOnInvalidId || *stopTransactionOnInvalidId)) { //if transaction is running, behavior depends on StopTransactionOnInvalidId
+                    !stopTransactionOnInvalidIdBool || stopTransactionOnInvalidIdBool->getBool())) { //if transaction is running, behavior depends on StopTransactionOnInvalidId
             
             MOCPP_DBG_DEBUG("DeAuthorize session");
             transaction->setStopReason("DeAuthorized");
@@ -330,9 +335,9 @@ void Connector::loop() {
     } //end transaction-related operations
 
     //handle FreeVend mode
-    if (freeVendActive && *freeVendActive && connectorPluggedInput) {
+    if (freeVendActiveBool && freeVendActiveBool->getBool() && connectorPluggedInput) {
         if (!freeVendTrackPlugged && connectorPluggedInput() && !transaction) {
-            const char *idTag = freeVendIdTag && *freeVendIdTag ? *freeVendIdTag : "";
+            const char *idTag = freeVendIdTagString ? freeVendIdTagString->getString() : "";
             if (!idTag || *idTag == '\0') {
                 idTag = "A0000000";
             }
@@ -372,13 +377,13 @@ void Connector::loop() {
     if (status != currentStatus) {
         currentStatus = status;
         t_statusTransition = mocpp_tick_ms();
-        MOCPP_DBG_DEBUG("Status changed%s", *minimumStatusDuration ? ", will report delayed" : "");
+        MOCPP_DBG_DEBUG("Status changed%s", minimumStatusDurationInt->getInt() ? ", will report delayed" : "");
     }
 
     if (reportedStatus != currentStatus &&
             model.getClock().now() >= Timestamp(2010,0,0,0,0,0) &&
-            (*minimumStatusDuration <= 0 || //MinimumStatusDuration disabled
-            mocpp_tick_ms() - t_statusTransition >= ((unsigned long) *minimumStatusDuration) * 1000UL)) {
+            (minimumStatusDurationInt->getInt() <= 0 || //MinimumStatusDuration disabled
+            mocpp_tick_ms() - t_statusTransition >= ((unsigned long) minimumStatusDurationInt->getInt()) * 1000UL)) {
         reportedStatus = currentStatus;
         Timestamp reportedTimestamp = model.getClock().now();
         reportedTimestamp -= (mocpp_tick_ms() - t_statusTransition) / 1000UL;
@@ -498,7 +503,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
 
     if (!tx) {
         //couldn't create normal transaction -> check if to start charging without real transaction
-        if (silentOfflineTransactions && *silentOfflineTransactions) {
+        if (silentOfflineTransactionsBool && silentOfflineTransactionsBool->getBool()) {
             //try to handle charging session without sending StartTx or StopTx to the server
             tx = model.getTransactionStore()->createTransaction(connectorId, true);
 
@@ -579,7 +584,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     MOCPP_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
 
     //check for local preauthorization
-    if (localPreAuthorize && *localPreAuthorize) {
+    if (localPreAuthorizeBool && localPreAuthorizeBool->getBool()) {
         if (localAuth && localAuth->getAuthorizationStatus() == AuthorizationStatus::Accepted) {
             MOCPP_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
 
@@ -592,7 +597,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     transaction->commit();
 
     auto authorize = makeRequest(new Authorize(context.getModel(), idTag));
-    authorize->setTimeout(authorizationTimeout && *authorizationTimeout > 0 ? *authorizationTimeout * 1000UL : 20UL * 1000UL);
+    authorize->setTimeout(authorizationTimeoutInt && authorizationTimeoutInt->getInt() > 0 ? authorizationTimeoutInt->getInt() * 1000UL : 20UL * 1000UL);
     auto tx = transaction;
     authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
         JsonObject idTagInfo = response["idTagInfo"];
@@ -664,7 +669,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             }
         }
 
-        if (allowOfflineTxForUnknownId && (bool) *allowOfflineTxForUnknownId) {
+        if (allowOfflineTxForUnknownIdBool && allowOfflineTxForUnknownIdBool->getBool()) {
             MOCPP_DBG_DEBUG("Offline transaction process (%s), allow unknown ID", tx->getIdTag());
             tx->setAuthorized();
             tx->commit();
@@ -777,11 +782,11 @@ bool Connector::isOperative() {
         }
     }
 
-    return availabilityVolatile && *availability;
+    return availabilityVolatile && availabilityBool->getBool();
 }
 
 void Connector::setAvailability(bool available) {
-    *availability = available;
+    availabilityBool->setBool(available);
     configuration_save();
 }
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 7e3e8333..63159566 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -32,7 +32,8 @@ class Connector {
 
     std::shared_ptr<Transaction> transaction;
 
-    std::shared_ptr<Configuration<bool>> availability;
+    std::shared_ptr<Configuration> availabilityBool;
+    char availabilityBoolKey [sizeof(MOCPP_CONFIG_EXT_PREFIX "AVAIL_CONN_xxxx") + 1];
     bool availabilityVolatile = true;
 
     std::function<bool()> connectorPluggedInput;
@@ -44,7 +45,7 @@ class Connector {
     const char *getErrorCode();
 
     ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
-    std::shared_ptr<Configuration<int>> minimumStatusDuration; //in seconds
+    std::shared_ptr<Configuration> minimumStatusDurationInt; //in seconds
     ChargePointStatus reportedStatus = ChargePointStatus::NOT_SET;
     unsigned long t_statusTransition = 0;
 
@@ -56,23 +57,26 @@ class Connector {
 
     std::function<void(Transaction*,TxNotification)> txNotificationOutput;
 
-    std::shared_ptr<Configuration<int>> connectionTimeOut; //in seconds
-    std::shared_ptr<Configuration<bool>> stopTransactionOnInvalidId;
-    std::shared_ptr<Configuration<bool>> stopTransactionOnEVSideDisconnect;
-    std::shared_ptr<Configuration<bool>> unlockConnectorOnEVSideDisconnect;
-    std::shared_ptr<Configuration<bool>> localPreAuthorize;
-    std::shared_ptr<Configuration<bool>> allowOfflineTxForUnknownId;
-
-    std::shared_ptr<Configuration<bool>> silentOfflineTransactions;
-    std::shared_ptr<Configuration<int>> authorizationTimeout; //in seconds
-    std::shared_ptr<Configuration<bool>> freeVendActive;
-    std::shared_ptr<Configuration<const char*>> freeVendIdTag;
+    std::shared_ptr<Configuration> connectionTimeOutInt; //in seconds
+    std::shared_ptr<Configuration> stopTransactionOnInvalidIdBool;
+    std::shared_ptr<Configuration> stopTransactionOnEVSideDisconnectBool;
+    std::shared_ptr<Configuration> localPreAuthorizeBool;
+    std::shared_ptr<Configuration> allowOfflineTxForUnknownIdBool;
+
+    std::shared_ptr<Configuration> silentOfflineTransactionsBool;
+    std::shared_ptr<Configuration> authorizationTimeoutInt; //in seconds
+    std::shared_ptr<Configuration> freeVendActiveBool;
+    std::shared_ptr<Configuration> freeVendIdTagString;
     bool freeVendTrackPlugged = false;
 
     bool trackLoopExecute = false; //if loop has been executed once
 public:
     Connector(Context& context, int connectorId);
-    Connector(Connector&& other) = default;
+    Connector(const Connector&) = delete;
+    Connector(Connector&&) = delete;
+    Connector& operator=(const Connector&) = delete;
+
+    ~Connector();
 
     /*
      * beginTransaction begins the transaction process which eventually leads to a StartTransaction
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index f7147d64..98ea559f 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -29,33 +29,13 @@ using namespace MicroOcpp;
 ConnectorsCommon::ConnectorsCommon(Context& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context) {
     
-    std::shared_ptr<Configuration<int>> numberOfConnectors =
-            declareConfiguration<int>("NumberOfConnectors", numConn >= 1 ? numConn - 1 : 0, CONFIGURATION_VOLATILE, false, true, false, false);
-
-    const char *fpId = "Core,RemoteTrigger";
-    const char *fpIdCore = "Core";
-    const char *fpIdRTrigger = "RemoteTrigger";
-    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
-    if (!strstr(*fProfile, fpIdCore)) {
-        auto fProfilePlus = std::string(*fProfile);
-        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
-            fProfilePlus += ",";
-        fProfilePlus += fpIdCore;
-        *fProfile = fProfilePlus.c_str();
-    }
-    if (!strstr(*fProfile, fpIdRTrigger)) {
-        auto fProfilePlus = std::string(*fProfile);
-        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
-            fProfilePlus += ",";
-        fProfilePlus += fpIdRTrigger;
-        *fProfile = fProfilePlus.c_str();
-    }
+    declareConfiguration<int>("NumberOfConnectors", numConn >= 1 ? numConn - 1 : 0, CONFIGURATION_VOLATILE, true);
     
     /*
      * Further configuration keys which correspond to the Core profile
      */
-    declareConfiguration<bool>("AuthorizeRemoteTxRequests",false,CONFIGURATION_VOLATILE,false,true,false,false);
-    declareConfiguration<int>("GetConfigurationMaxKeys",30,CONFIGURATION_VOLATILE,false,true,false,false);
+    declareConfiguration<bool>("AuthorizeRemoteTxRequests", false, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<int>("GetConfigurationMaxKeys", 30, CONFIGURATION_VOLATILE, true);
     
     context.getOperationRegistry().registerOperation("ChangeAvailability", [&context] () {
         return new Ocpp16::ChangeAvailability(context.getModel());});
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 6908fe1d..861e7fe1 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -6,7 +6,6 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
-#include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Debug.h>
 
 #include <MicroOcpp/Operations/GetDiagnostics.h>
@@ -16,15 +15,6 @@ using namespace MicroOcpp;
 using Ocpp16::DiagnosticsStatus;
 
 DiagnosticsService::DiagnosticsService(Context& context) : context(context) {
-    const char *fpId = "FirmwareManagement";
-    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
-    if (!strstr(*fProfile, fpId)) {
-        auto fProfilePlus = std::string(*fProfile);
-        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
-            fProfilePlus += ",";
-        fProfilePlus += fpId;
-        *fProfile = fProfilePlus.c_str();
-    }
     
     context.getOperationRegistry().registerOperation("GetDiagnostics", [&context] () {
         return new Ocpp16::GetDiagnostics(context.getModel());});
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index f897d3a9..80ea675b 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -26,15 +26,6 @@ using namespace MicroOcpp;
 using MicroOcpp::Ocpp16::FirmwareStatus;
 
 FirmwareService::FirmwareService(Context& context) : context(context) {
-    const char *fpId = "FirmwareManagement";
-    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
-    if (!strstr(*fProfile, fpId)) {
-        auto fProfilePlus = std::string(*fProfile);
-        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
-            fProfilePlus += ",";
-        fProfilePlus += fpId;
-        *fProfile = fProfilePlus.c_str();
-    }
     
     context.getOperationRegistry().registerOperation("UpdateFirmware", [&context] () {
         return new Ocpp16::UpdateFirmware(context.getModel());});
@@ -48,7 +39,7 @@ void FirmwareService::setBuildNumber(const char *buildNumber) {
     if (buildNumber == nullptr)
         return;
     this->buildNumber = buildNumber;
-    previousBuildNumber = declareConfiguration<const char*>("BUILD_NUMBER", this->buildNumber.c_str(), MOCPP_KEYVALUE_FN, false, false, true, false);
+    previousBuildNumberString = declareConfiguration<const char*>("BUILD_NUMBER", this->buildNumber.c_str(), MOCPP_KEYVALUE_FN, false, false, false);
     checkedSuccessfulFwUpdate = false; //--> CS will be notified
 }
 
@@ -254,15 +245,14 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
     /*
      * Check if FW has been updated previously, but only once
      */
-    if (!checkedSuccessfulFwUpdate && !buildNumber.empty() && previousBuildNumber != nullptr) {
+    if (!checkedSuccessfulFwUpdate && !buildNumber.empty() && previousBuildNumberString != nullptr) {
         checkedSuccessfulFwUpdate = true;
 
-        MOCPP_DBG_DEBUG("Previous build number: %s, new build number: %s", (const char*) *previousBuildNumber, buildNumber.c_str());
+        MOCPP_DBG_DEBUG("Previous build number: %s, new build number: %s", previousBuildNumberString->getString(), buildNumber.c_str());
         
-        size_t buildNoSize = previousBuildNumber->getBuffsize();
-        if (strncmp(buildNumber.c_str(), *previousBuildNumber, buildNoSize)) {
+        if (buildNumber.compare(previousBuildNumberString->getString())) {
             //new FW
-            *previousBuildNumber = buildNumber.c_str();
+            previousBuildNumberString->setString(buildNumber.c_str());
             configuration_save();
 
             buildNumber.clear();
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
index 1637f842..45aefaad 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
@@ -33,7 +33,7 @@ class FirmwareService {
 private:
     Context& context;
     
-    std::shared_ptr<Configuration<const char *>> previousBuildNumber;
+    std::shared_ptr<Configuration> previousBuildNumberString;
     std::string buildNumber;
 
     std::function<DownloadStatus()> downloadStatusInput;
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
index 0756e82b..1de66747 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
@@ -12,7 +12,7 @@
 using namespace MicroOcpp;
 
 HeartbeatService::HeartbeatService(Context& context) : context(context) {
-    heartbeatInterval = declareConfiguration("HeartbeatInterval", 86400);
+    heartbeatIntervalInt = declareConfiguration<int>("HeartbeatInterval", 86400);
     lastHeartbeat = mocpp_tick_ms();
 
     //Register message handler for TriggerMessage operation
@@ -21,7 +21,7 @@ HeartbeatService::HeartbeatService(Context& context) : context(context) {
 }
 
 void HeartbeatService::loop() {
-    unsigned long hbInterval = *heartbeatInterval;
+    unsigned long hbInterval = heartbeatIntervalInt->getInt();
     hbInterval *= 1000UL; //conversion s -> ms
     unsigned long now = mocpp_tick_ms();
 
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
index 0ee4f3dd..5820612b 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
@@ -17,7 +17,7 @@ class HeartbeatService {
     Context& context;
 
     unsigned long lastHeartbeat;
-    std::shared_ptr<MicroOcpp::Configuration<int>> heartbeatInterval;
+    std::shared_ptr<Configuration> heartbeatIntervalInt;
 
 public:
     HeartbeatService(Context& context);
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.cpp b/src/MicroOcpp/Model/Metering/MeterValue.cpp
index 7004067b..052a9c9a 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterValue.cpp
@@ -57,12 +57,12 @@ ReadingContext MeterValue::getReadingContext() {
 }
 
 MeterValueBuilder::MeterValueBuilder(const std::vector<std::unique_ptr<SampledValueSampler>> &samplers,
-            std::shared_ptr<Configuration<const char*>> samplers_select) :
+            std::shared_ptr<Configuration> samplersSelectStr) :
             samplers(samplers),
-            select(samplers_select) {
+            selectString(samplersSelectStr) {
         
     updateObservedSamplers();
-    select_observe = select->getValueRevision();
+    select_observe = selectString->getValueRevision();
 }
 
 void MeterValueBuilder::updateObservedSamplers() {
@@ -76,11 +76,12 @@ void MeterValueBuilder::updateObservedSamplers() {
         select_mask[i] = false;
     }
     
-    auto selectStr = select->operator const char *();
+    auto sstring = selectString->getString();
+    auto ssize = strlen(sstring) + 1;
     size_t sl = 0, sr = 0;
-    while (selectStr && sl < select->getBuffsize()) {
-        while (sr < select->getBuffsize()) {
-            if (selectStr[sr] == ',') {
+    while (sstring && sl < ssize) {
+        while (sr < ssize) {
+            if (sstring[sr] == ',') {
                 break;
             }
             sr++;
@@ -88,7 +89,7 @@ void MeterValueBuilder::updateObservedSamplers() {
 
         if (sr != sl + 1) {
             for (size_t i = 0; i < samplers.size(); i++) {
-                if (!strncmp(samplers[i]->getProperties().getMeasurand().c_str(), selectStr + sl, sr - sl)) {
+                if (!strncmp(samplers[i]->getProperties().getMeasurand().c_str(), sstring + sl, sr - sl)) {
                     select_mask[i] = true;
                     select_n++;
                 }
@@ -101,11 +102,11 @@ void MeterValueBuilder::updateObservedSamplers() {
 }
 
 std::unique_ptr<MeterValue> MeterValueBuilder::takeSample(const Timestamp& timestamp, const ReadingContext& context) {
-    if (select_observe != select->getValueRevision() || //OCPP server has changed configuration about which measurands to take
+    if (select_observe != selectString->getValueRevision() || //OCPP server has changed configuration about which measurands to take
             samplers.size() != select_mask.size()) {    //Client has added another Measurand; synchronize lists
         MOCPP_DBG_DEBUG("Updating observed samplers due to config change or samplers added");
         updateObservedSamplers();
-        select_observe = select->getValueRevision();
+        select_observe = selectString->getValueRevision();
     }
 
     if (select_n == 0) {
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.h b/src/MicroOcpp/Model/Metering/MeterValue.h
index 46f48454..352994b3 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.h
+++ b/src/MicroOcpp/Model/Metering/MeterValue.h
@@ -35,15 +35,15 @@ class MeterValue {
 class MeterValueBuilder {
 private:
     const std::vector<std::unique_ptr<SampledValueSampler>> &samplers;
-    std::shared_ptr<Configuration<const char*>> select;
+    std::shared_ptr<Configuration> selectString;
     std::vector<bool> select_mask;
     unsigned int select_n {0};
-    decltype(select->getValueRevision()) select_observe;
+    decltype(selectString->getValueRevision()) select_observe;
 
     void updateObservedSamplers();
 public:
     MeterValueBuilder(const std::vector<std::unique_ptr<SampledValueSampler>> &samplers,
-            std::shared_ptr<Configuration<const char*>> samplers_select);
+            std::shared_ptr<Configuration> samplersSelectStr);
     
     std::unique_ptr<MeterValue> takeSample(const Timestamp& timestamp, const ReadingContext& context);
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index ee8097df..0decf121 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -20,27 +20,27 @@ using namespace MicroOcpp::Ocpp16;
 MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore& meterStore)
         : model(model), connectorId{connectorId}, meterStore(meterStore) {
 
-    auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData", "", CONFIGURATION_FN);
-    declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
-    MeterValueCacheSize = declareConfiguration(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 1, CONFIGURATION_FN, true, true, true, false);
-    MeterValueSampleInterval = declareConfiguration("MeterValueSampleInterval", 60);
+    auto meterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData", "");
+    declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
+    meterValueCacheSizeInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 1);
+    meterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval", 60);
     
-    auto StopTxnSampledData = declareConfiguration<const char*>("StopTxnSampledData", "", CONFIGURATION_FN);
-    declareConfiguration<int>("StopTxnSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
+    auto stopTxnSampledDataString = declareConfiguration<const char*>("StopTxnSampledData", "");
+    declareConfiguration<int>("StopTxnSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
     
-    auto MeterValuesAlignedData = declareConfiguration<const char*>("MeterValuesAlignedData", "", CONFIGURATION_FN);
-    declareConfiguration<int>("MeterValuesAlignedDataMaxLength", 8, CONFIGURATION_VOLATILE, false, true, false, false);
-    ClockAlignedDataInterval  = declareConfiguration("ClockAlignedDataInterval", 0);
+    auto meterValuesAlignedDataString = declareConfiguration<const char*>("MeterValuesAlignedData", "");
+    declareConfiguration<int>("MeterValuesAlignedDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
+    clockAlignedDataIntervalInt  = declareConfiguration<int>("ClockAlignedDataInterval", 0);
     
-    auto StopTxnAlignedData = declareConfiguration<const char*>("StopTxnAlignedData", "", CONFIGURATION_FN);
+    auto stopTxnAlignedDataString = declareConfiguration<const char*>("StopTxnAlignedData", "");
 
-    MeterValuesInTxOnly = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "MeterValuesInTxOnly", true, CONFIGURATION_FN, true, true, true, false);
-    StopTxnDataCapturePeriodic = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "StopTxnDataCapturePeriodic", false, CONFIGURATION_FN, true, true, true, false);
+    meterValuesInTxOnlyBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "MeterValuesInTxOnly", true);
+    stopTxnDataCapturePeriodicBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "StopTxnDataCapturePeriodic", false);
 
-    sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesSampledData));
-    alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, MeterValuesAlignedData));
-    stopTxnSampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnSampledData));
-    stopTxnAlignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, StopTxnAlignedData));
+    sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, meterValuesSampledDataString));
+    alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, meterValuesAlignedDataString));
+    stopTxnSampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, stopTxnSampledDataString));
+    stopTxnAlignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, stopTxnAlignedDataString));
 }
 
 std::unique_ptr<Operation> MeteringConnector::loop() {
@@ -56,7 +56,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         lastSampleTime = mocpp_tick_ms();
     }
 
-    if ((txBreak || meterData.size() >= (size_t) *MeterValueCacheSize) && !meterData.empty()) {
+    if ((txBreak || meterData.size() >= (size_t) meterValueCacheSizeInt->getInt()) && !meterData.empty()) {
         auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(std::move(meterData), connectorId, transaction));
         meterData.clear();
         return std::move(meterValues);
@@ -78,7 +78,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         } else {
             //check outside of transaction
 
-            if (connectorId != 0 && (!MeterValuesInTxOnly || *MeterValuesInTxOnly)) {
+            if (connectorId != 0 && meterValuesInTxOnlyBool->getBool()) {
                 //don't take any MeterValues outside of transactions on connectorIds other than 0
                 meterData.clear();
                 return nullptr;
@@ -86,12 +86,12 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         }
     }
 
-    if (*ClockAlignedDataInterval >= 1) {
+    if (clockAlignedDataIntervalInt->getInt() >= 1) {
 
         auto& timestampNow = model.getClock().now();
         auto dt = nextAlignedTime - timestampNow;
         if (dt <= 0 ||                              //normal case: interval elapsed
-                dt > *ClockAlignedDataInterval) {   //special case: clock has been adjusted or first run
+                dt > clockAlignedDataIntervalInt->getInt()) {   //special case: clock has been adjusted or first run
 
             MOCPP_DBG_DEBUG("Clock aligned measurement %" PRId32 "s: %s", dt,
                 abs(dt) <= 60 ?
@@ -115,28 +115,28 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
             auto intervall = timestampNow - midnightBase;
             intervall %= 3600 * 24;
             Timestamp midnight = timestampNow - intervall;
-            intervall += *ClockAlignedDataInterval;
+            intervall += clockAlignedDataIntervalInt->getInt();
             if (intervall >= 3600 * 24) {
                 //next measurement is tomorrow; set to precisely 00:00 
                 nextAlignedTime = midnight;
                 nextAlignedTime += 3600 * 24;
             } else {
-                intervall /= *ClockAlignedDataInterval;
-                nextAlignedTime = midnight + (intervall * *ClockAlignedDataInterval);
+                intervall /= clockAlignedDataIntervalInt->getInt();
+                nextAlignedTime = midnight + (intervall * clockAlignedDataIntervalInt->getInt());
             }
         }
     }
 
-    if (*MeterValueSampleInterval >= 1) {
+    if (meterValueSampleIntervalInt->getInt() >= 1) {
         //record periodic tx data
 
-        if (mocpp_tick_ms() - lastSampleTime >= (unsigned long) (*MeterValueSampleInterval * 1000)) {
+        if (mocpp_tick_ms() - lastSampleTime >= (unsigned long) (meterValueSampleIntervalInt->getInt() * 1000)) {
             auto sampleMeterValues = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::SamplePeriodic);
             if (sampleMeterValues) {
                 meterData.push_back(std::move(sampleMeterValues));
             }
 
-            if (stopTxnData && StopTxnDataCapturePeriodic && *StopTxnDataCapturePeriodic) {
+            if (stopTxnData && stopTxnDataCapturePeriodicBool->getBool()) {
                 auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::SamplePeriodic);
                 if (sampleStopTx) {
                     stopTxnData->addTxData(std::move(sampleStopTx));
@@ -146,7 +146,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         }   
     }
 
-    if (*ClockAlignedDataInterval < 1 && *MeterValueSampleInterval < 1) {
+    if (clockAlignedDataIntervalInt->getInt() < 1 && meterValueSampleIntervalInt->getInt() < 1) {
         meterData.clear();
     }
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.h b/src/MicroOcpp/Model/Metering/MeteringConnector.h
index 76d2bdb3..72ab1d82 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.h
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.h
@@ -35,10 +35,10 @@ class MeteringConnector {
     std::unique_ptr<MeterValueBuilder> stopTxnSampledDataBuilder;
     std::unique_ptr<MeterValueBuilder> stopTxnAlignedDataBuilder;
 
-    std::shared_ptr<Configuration<const char *>> sampledDataSelect;
-    std::shared_ptr<Configuration<const char *>> alignedDataSelect;
-    std::shared_ptr<Configuration<const char *>> stopTxnSampledDataSelect;
-    std::shared_ptr<Configuration<const char *>> stopTxnAlignedDataSelect;
+    std::shared_ptr<Configuration> sampledDataSelectString;
+    std::shared_ptr<Configuration> alignedDataSelectString;
+    std::shared_ptr<Configuration> stopTxnSampledDataSelectString;
+    std::shared_ptr<Configuration> stopTxnAlignedDataSelectString;
 
     unsigned long lastSampleTime = 0; //0 means not charging right now
     Timestamp nextAlignedTime;
@@ -48,13 +48,13 @@ class MeteringConnector {
     std::vector<std::unique_ptr<SampledValueSampler>> samplers;
     int energySamplerIndex {-1};
 
-    std::shared_ptr<Configuration<int>> MeterValueSampleInterval;
-    std::shared_ptr<Configuration<int>> MeterValueCacheSize;
+    std::shared_ptr<Configuration> meterValueSampleIntervalInt;
+    std::shared_ptr<Configuration> meterValueCacheSizeInt;
 
-    std::shared_ptr<Configuration<int>> ClockAlignedDataInterval;
+    std::shared_ptr<Configuration> clockAlignedDataIntervalInt;
 
-    std::shared_ptr<Configuration<bool>> MeterValuesInTxOnly;
-    std::shared_ptr<Configuration<bool>> StopTxnDataCapturePeriodic;
+    std::shared_ptr<Configuration> meterValuesInTxOnlyBool;
+    std::shared_ptr<Configuration> stopTxnDataCapturePeriodicBool;
 public:
     MeteringConnector(Model& model, int connectorId, MeterStore& meterStore);
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index 271dc460..53fe8d50 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -16,36 +16,14 @@ using namespace MicroOcpp;
 MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
       : context(context), meterStore(filesystem) {
 
-    auto MeterValuesSampledData = declareConfiguration<const char*>(
-        "MeterValuesSampledData",
-        "Energy.Active.Import.Register,Power.Active.Import",
-        CONFIGURATION_FN,
-        true,true,true,false
-    );
-    
-    auto StopTxnSampledData = declareConfiguration<const char*>(
-        "StopTxnSampledData",
-        "",
-        CONFIGURATION_FN,
-        true,true,true,false
-    );
-    
-    auto MeterValuesAlignedData = declareConfiguration<const char*>(
-        "MeterValuesAlignedData",
-        "Energy.Active.Import.Register,Power.Active.Import",
-        CONFIGURATION_FN,
-        true,true,true,false
-    );
-    
-    auto StopTxnAlignedData = declareConfiguration<const char*>(
-        "StopTxnAlignedData",
-        "",
-        CONFIGURATION_FN,
-        true,true,true,false
-    );
+    //set factory defaults for Metering-related config keys
+    declareConfiguration<const char*>("MeterValuesSampledData", "Energy.Active.Import.Register,Power.Active.Import");
+    declareConfiguration<const char*>("StopTxnSampledData", "");
+    declareConfiguration<const char*>("MeterValuesAlignedData", "Energy.Active.Import.Register,Power.Active.Import");
+    declareConfiguration<const char*>("StopTxnAlignedData", "");
     
     for (int i = 0; i < numConn; i++) {
-        connectors.push_back(std::unique_ptr<MeteringConnector>(new MeteringConnector(context.getModel(), i, meterStore)));
+        connectors.emplace_back(new MeteringConnector(context.getModel(), i, meterStore));
     }
 
     std::function<bool(const char*)> validateSelectString = [this] (const char *csl) {
@@ -77,10 +55,10 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
         }
         return isValid;
     };
-    MeterValuesSampledData->setValidator(validateSelectString);
-    StopTxnSampledData->setValidator(validateSelectString);
-    MeterValuesAlignedData->setValidator(validateSelectString);
-    StopTxnAlignedData->setValidator(validateSelectString);
+    registerConfigurationValidator("MeterValuesSampledData", validateSelectString);
+    registerConfigurationValidator("StopTxnSampledData", validateSelectString);
+    registerConfigurationValidator("MeterValuesAlignedData", validateSelectString);
+    registerConfigurationValidator("StopTxnAlignedData", validateSelectString);
 
     /*
      * Register further message handlers to support echo mode: when this library
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 527a26a1..835459f5 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -3,6 +3,9 @@
 // MIT License
 
 #include <MicroOcpp/Model/Model.h>
+
+#include <string>
+
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
 #include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h>
@@ -15,12 +18,14 @@
 #include <MicroOcpp/Model/Boot/BootService.h>
 #include <MicroOcpp/Model/Reset/ResetService.h>
 
+#include <MicroOcpp/Core/Configuration.h>
+
 #include <MicroOcpp/Debug.h>
 
 using namespace MicroOcpp;
 
 Model::Model(uint16_t bootNr) : bootNr(bootNr) {
-    
+
 }
 
 Model::~Model() = default;
@@ -31,12 +36,17 @@ void Model::loop() {
         bootService->loop();
     }
 
+    if (capabilitiesUpdated) {
+        updateSupportedStandardProfiles();
+        capabilitiesUpdated = false;
+    }
+
     if (!runTasks) {
         return;
     }
 
     for (auto& connector : connectors) {
-        connector.loop();
+        connector->loop();
     }
 
     if (chargeControlCommon)
@@ -66,6 +76,7 @@ void Model::loop() {
 
 void Model::setTransactionStore(std::unique_ptr<TransactionStore> ts) {
     transactionStore = std::move(ts);
+    capabilitiesUpdated = true;
 }
 
 TransactionStore *Model::getTransactionStore() {
@@ -74,6 +85,7 @@ TransactionStore *Model::getTransactionStore() {
 
 void Model::setSmartChargingService(std::unique_ptr<SmartChargingService> scs) {
     smartChargingService = std::move(scs);
+    capabilitiesUpdated = true;
 }
 
 SmartChargingService* Model::getSmartChargingService() const {
@@ -82,14 +94,16 @@ SmartChargingService* Model::getSmartChargingService() const {
 
 void Model::setConnectorsCommon(std::unique_ptr<ConnectorsCommon> ccs) {
     chargeControlCommon = std::move(ccs);
+    capabilitiesUpdated = true;
 }
 
 ConnectorsCommon *Model::getConnectorsCommon() {
     return chargeControlCommon.get();
 }
 
-void Model::setConnectors(std::vector<Connector>&& connectors) {
+void Model::setConnectors(std::vector<std::unique_ptr<Connector>>&& connectors) {
     this->connectors = std::move(connectors);
+    capabilitiesUpdated = true;
 }
 
 unsigned int Model::getNumConnectors() const {
@@ -102,11 +116,12 @@ Connector *Model::getConnector(unsigned int connectorId) {
         return nullptr;
     }
 
-    return &connectors[connectorId];
+    return connectors[connectorId].get();
 }
 
 void Model::setMeteringSerivce(std::unique_ptr<MeteringService> ms) {
     meteringService = std::move(ms);
+    capabilitiesUpdated = true;
 }
 
 MeteringService* Model::getMeteringService() const {
@@ -115,6 +130,7 @@ MeteringService* Model::getMeteringService() const {
 
 void Model::setFirmwareService(std::unique_ptr<FirmwareService> fws) {
     firmwareService = std::move(fws);
+    capabilitiesUpdated = true;
 }
 
 FirmwareService *Model::getFirmwareService() const {
@@ -123,6 +139,7 @@ FirmwareService *Model::getFirmwareService() const {
 
 void Model::setDiagnosticsService(std::unique_ptr<DiagnosticsService> ds) {
     diagnosticsService = std::move(ds);
+    capabilitiesUpdated = true;
 }
 
 DiagnosticsService *Model::getDiagnosticsService() const {
@@ -131,10 +148,12 @@ DiagnosticsService *Model::getDiagnosticsService() const {
 
 void Model::setHeartbeatService(std::unique_ptr<HeartbeatService> hs) {
     heartbeatService = std::move(hs);
+    capabilitiesUpdated = true;
 }
 
 void Model::setAuthorizationService(std::unique_ptr<AuthorizationService> as) {
     authorizationService = std::move(as);
+    capabilitiesUpdated = true;
 }
 
 AuthorizationService *Model::getAuthorizationService() {
@@ -143,6 +162,7 @@ AuthorizationService *Model::getAuthorizationService() {
 
 void Model::setReservationService(std::unique_ptr<ReservationService> rs) {
     reservationService = std::move(rs);
+    capabilitiesUpdated = true;
 }
 
 ReservationService *Model::getReservationService() {
@@ -151,6 +171,7 @@ ReservationService *Model::getReservationService() {
 
 void Model::setBootService(std::unique_ptr<BootService> bs){
     bootService = std::move(bs);
+    capabilitiesUpdated = true;
 }
 
 BootService *Model::getBootService() const {
@@ -159,6 +180,7 @@ BootService *Model::getBootService() const {
 
 void Model::setResetService(std::unique_ptr<ResetService> rs) {
     this->resetService = std::move(rs);
+    capabilitiesUpdated = true;
 }
 
 ResetService *Model::getResetService() const {
@@ -172,3 +194,63 @@ Clock& Model::getClock() {
 uint16_t Model::getBootNr() {
     return bootNr;
 }
+
+void Model::updateSupportedStandardProfiles() {
+
+    auto supportedFeatureProfilesString =
+        declareConfiguration<const char*>("SupportedFeatureProfiles", "", CONFIGURATION_VOLATILE, true);
+    
+    if (!supportedFeatureProfilesString) {
+        MOCPP_DBG_ERR("OOM");
+        return;
+    }
+
+    std::string buf = supportedFeatureProfilesString->getString();
+
+    if (chargeControlCommon &&
+            heartbeatService &&
+            bootService) {
+        if (!strstr(supportedFeatureProfilesString->getString(), "Core")) {
+            if (!buf.empty()) buf += ',';
+            buf += "Core";
+        }
+    }
+
+    if (firmwareService &&
+            diagnosticsService) {
+        if (!strstr(supportedFeatureProfilesString->getString(), "FirmwareManagement")) {
+            if (!buf.empty()) buf += ',';
+            buf += "FirmwareManagement";
+        }
+    }
+
+    if (authorizationService) {
+        if (!strstr(supportedFeatureProfilesString->getString(), "LocalAuthListManagement")) {
+            if (!buf.empty()) buf += ',';
+            buf += "LocalAuthListManagement";
+        }
+    }
+
+    if (reservationService) {
+        if (!strstr(supportedFeatureProfilesString->getString(), "Reservation")) {
+            if (!buf.empty()) buf += ',';
+            buf += "Reservation";
+        }
+    }
+
+    if (smartChargingService) {
+        if (!strstr(supportedFeatureProfilesString->getString(), "SmartCharging")) {
+            if (!buf.empty()) buf += ',';
+            buf += "SmartCharging";
+        }
+    }
+
+    if (!strstr(supportedFeatureProfilesString->getString(), "RemoteTrigger")) {
+        if (!buf.empty()) buf += ',';
+        buf += "RemoteTrigger";
+    }
+
+    supportedFeatureProfilesString->setString(buf.c_str());
+
+    MOCPP_DBG_DEBUG("supported feature profiles: %s", buf.c_str());
+}
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 89c9e553..d8f744dd 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -26,7 +26,7 @@ class ResetService;
 
 class Model {
 private:
-    std::vector<Connector> connectors;
+    std::vector<std::unique_ptr<Connector>> connectors;
     std::unique_ptr<TransactionStore> transactionStore;
     std::unique_ptr<SmartChargingService> smartChargingService;
     std::unique_ptr<ConnectorsCommon> chargeControlCommon;
@@ -40,6 +40,9 @@ class Model {
     std::unique_ptr<ResetService> resetService;
     Clock clock;
 
+    bool capabilitiesUpdated = true;
+    void updateSupportedStandardProfiles();
+
     bool runTasks = false;
 
     const uint16_t bootNr = 0; //each boot of this lib has a unique number
@@ -62,7 +65,7 @@ class Model {
     void setConnectorsCommon(std::unique_ptr<ConnectorsCommon> ccs);
     ConnectorsCommon *getConnectorsCommon();
 
-    void setConnectors(std::vector<Connector>&& connectors);
+    void setConnectors(std::vector<std::unique_ptr<Connector>>&& connectors);
     unsigned int getNumConnectors() const;
     Connector *getConnector(unsigned int connectorId);
 
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
index f643e818..efa5952b 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.cpp
+++ b/src/MicroOcpp/Model/Reservation/Reservation.cpp
@@ -13,33 +13,49 @@
 using namespace MicroOcpp;
 
 Reservation::Reservation(Model& model, unsigned int slot) : model(model), slot(slot) {
-    const size_t KEY_SIZE = 50;
-    char key [KEY_SIZE] = {'\0'};
-
-    snprintf(key, KEY_SIZE, "cid_%u", slot);
-    connectorId = declareConfiguration<int>(key, -1, RESERVATION_FN, false, false, true, false);
+    
+    snprintf(connectorIdKey, sizeof(connectorIdKey), MOCPP_RESERVATION_CID_KEY "%u", slot);
+    connectorIdInt = declareConfiguration<int>(connectorIdKey, -1, RESERVATION_FN, false, false, false);
 
-    snprintf(key, KEY_SIZE, "expdt_%u", slot);
-    expiryDateRaw = declareConfiguration<const char*>(key, "", RESERVATION_FN, false, false, true, false);
-    expiryDate.setTime(*expiryDateRaw);
+    snprintf(expiryDateRawKey, sizeof(expiryDateRawKey), MOCPP_RESERVATION_EXPDATE_KEY "%u", slot);
+    expiryDateRawString = declareConfiguration<const char*>(expiryDateRawKey, "", RESERVATION_FN, false, false, false);
+    expiryDate.setTime(expiryDateRawString->getString());
     
-    snprintf(key, KEY_SIZE, "idt_%u", slot);
-    idTag = declareConfiguration<const char*>(key, "", RESERVATION_FN, false, false, true, false);
+    snprintf(idTagKey, sizeof(idTagKey), MOCPP_RESERVATION_IDTAG_KEY "%u", slot);
+    idTagString = declareConfiguration<const char*>(idTagKey, "", RESERVATION_FN, false, false, false);
 
-    snprintf(key, KEY_SIZE, "rsvid_%u", slot);
-    reservationId = declareConfiguration<int>(key, -1, RESERVATION_FN, false, false, true, false);
+    snprintf(reservationIdKey, sizeof(reservationIdKey), MOCPP_RESERVATION_RESID_KEY "%u", slot);
+    reservationIdInt = declareConfiguration<int>(reservationIdKey, -1, RESERVATION_FN, false, false, false);
 
-    snprintf(key, KEY_SIZE, "pidt_%u", slot);
-    parentIdTag = declareConfiguration<const char*>(key, "", RESERVATION_FN, false, false, true, false);
+    snprintf(parentIdTagKey, sizeof(parentIdTagKey), MOCPP_RESERVATION_PARENTID_KEY "%u", slot);
+    parentIdTagString = declareConfiguration<const char*>(parentIdTagKey, "", RESERVATION_FN, false, false, false);
 
-    if (!connectorId || !expiryDateRaw || !idTag || !reservationId || !parentIdTag) {
+    if (!connectorIdInt || !expiryDateRawString || !idTagString || !reservationIdInt || !parentIdTagString) {
         MOCPP_DBG_ERR("initialization failure");
         (void)0;
     }
 }
 
+Reservation::~Reservation() {
+    if (connectorIdInt->getKey() == connectorIdKey) {
+        connectorIdInt->setKey(nullptr);
+    }
+    if (expiryDateRawString->getKey() == expiryDateRawKey) {
+        expiryDateRawString->setKey(nullptr);
+    }
+    if (idTagString->getKey() == idTagKey) {
+        idTagString->setKey(nullptr);
+    }
+    if (reservationIdInt->getKey() == reservationIdKey) {
+        reservationIdInt->setKey(nullptr);
+    }
+    if (parentIdTagString->getKey() == parentIdTagKey) {
+        parentIdTagString->setKey(nullptr);
+    }
+}
+
 bool Reservation::isActive() {
-    if (*connectorId < 0) {
+    if (connectorIdInt->getInt() < 0) {
         //reservation invalidated
         return false;
     }
@@ -54,7 +70,7 @@ bool Reservation::isActive() {
 }
 
 bool Reservation::matches(unsigned int connectorId) {
-    return (int) connectorId == *this->connectorId;
+    return (int) connectorId == connectorIdInt->getInt();
 }
 
 bool Reservation::matches(const char *idTag, const char *parentIdTag) {
@@ -62,11 +78,11 @@ bool Reservation::matches(const char *idTag, const char *parentIdTag) {
         return true;
     }
 
-    if (idTag && !strcmp(idTag, *this->idTag)) {
+    if (idTag && !strcmp(idTag, idTagString->getString())) {
         return true;
     }
 
-    if (parentIdTag && !strcmp(parentIdTag, *this->parentIdTag)) {
+    if (parentIdTag && !strcmp(parentIdTag, parentIdTagString->getString())) {
         return true;
     }
 
@@ -74,7 +90,7 @@ bool Reservation::matches(const char *idTag, const char *parentIdTag) {
 }
 
 int Reservation::getConnectorId() {
-    return *connectorId;
+    return connectorIdInt->getInt();
 }
 
 Timestamp& Reservation::getExpiryDate() {
@@ -82,35 +98,35 @@ Timestamp& Reservation::getExpiryDate() {
 }
 
 const char *Reservation::getIdTag() {
-    return *idTag;
+    return idTagString->getString();
 }
 
 int Reservation::getReservationId() {
-    return *reservationId;
+    return reservationIdInt->getInt();
 }
 
 const char *Reservation::getParentIdTag() {
-    return parentIdTag->getBuffsize() <= 1 ? (const char *) nullptr : *parentIdTag;
+    return parentIdTagString->getString();
 }
 
 void Reservation::update(JsonObject payload) {
-    *connectorId = payload["connectorId"] | -1;
+    connectorIdInt->setInt(payload["connectorId"] | -1);
     expiryDate.setTime(payload["expiryDate"]);
-    *expiryDateRaw = payload["expiryDate"].as<const char*>();
-    *idTag = payload["idTag"].as<const char*>();
-    *reservationId = payload["reservationId"] | -1;
-    *parentIdTag = payload["parentIdTag"] | "";
+    expiryDateRawString->setString(payload["expiryDate"] | "");
+    idTagString->setString(payload["idTag"] | "");
+    reservationIdInt->setInt(payload["reservationId"] | -1);
+    parentIdTagString->setString(payload["parentIdTag"] | "");
 
     configuration_save();
 }
 
 void Reservation::clear() {
-    *connectorId = -1;
+    connectorIdInt->setInt(-1);
     expiryDate = MIN_TIME;
-    *expiryDateRaw = "";
-    *idTag = "";
-    *reservationId = -1;
-    *parentIdTag = "";
+    expiryDateRawString->setString("");
+    idTagString->setString("");
+    reservationIdInt->setInt(-1);
+    parentIdTagString->setString("");
 
     configuration_save();
 }
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.h b/src/MicroOcpp/Model/Reservation/Reservation.h
index fba0061f..222c3adf 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.h
+++ b/src/MicroOcpp/Model/Reservation/Reservation.h
@@ -8,6 +8,12 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/Time.h>
 
+#define MOCPP_RESERVATION_CID_KEY "cid_"
+#define MOCPP_RESERVATION_EXPDATE_KEY "expdt_"
+#define MOCPP_RESERVATION_IDTAG_KEY "idt_"
+#define MOCPP_RESERVATION_RESID_KEY "rsvid_"
+#define MOCPP_RESERVATION_PARENTID_KEY "pidt_"
+
 namespace MicroOcpp {
 
 class Model;
@@ -17,15 +23,26 @@ class Reservation {
     Model& model;
     const unsigned int slot;
 
-    std::shared_ptr<Configuration<int>> connectorId;
-    std::shared_ptr<Configuration<const char *>> expiryDateRaw;
+    std::shared_ptr<Configuration> connectorIdInt;
+    char connectorIdKey [sizeof(MOCPP_RESERVATION_CID_KEY "xxx") + 1]; //"xxx" = placeholder for digits
+    std::shared_ptr<Configuration> expiryDateRawString;
+    char expiryDateRawKey [sizeof(MOCPP_RESERVATION_EXPDATE_KEY "xxx") + 1];
+
     Timestamp expiryDate;
-    std::shared_ptr<Configuration<const char *>> idTag;
-    std::shared_ptr<Configuration<int>> reservationId;
-    std::shared_ptr<Configuration<const char *>> parentIdTag;
+    std::shared_ptr<Configuration> idTagString;
+    char idTagKey [sizeof(MOCPP_RESERVATION_IDTAG_KEY "xxx") + 1];
+    std::shared_ptr<Configuration> reservationIdInt;
+    char reservationIdKey [sizeof(MOCPP_RESERVATION_RESID_KEY "xxx") + 1];
+    std::shared_ptr<Configuration> parentIdTagString;
+    char parentIdTagKey [sizeof(MOCPP_RESERVATION_PARENTID_KEY "xxx") + 1];
 
 public:
     Reservation(Model& model, unsigned int slot);
+    Reservation(const Reservation&) = delete;
+    Reservation(Reservation&&) = delete;
+    Reservation& operator=(const Reservation&) = delete;
+
+    ~Reservation();
 
     bool isActive(); //if this object contains a valid, unexpired reservation
 
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index b9dcfe7e..63b34182 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -18,22 +18,11 @@ ReservationService::ReservationService(Context& context, unsigned int numConnect
     if (maxReservations > 0) {
         reservations.reserve((size_t) maxReservations);
         for (int i = 0; i < maxReservations; i++) {
-            reservations.push_back(Reservation(context.getModel(), i));
+            reservations.push_back(std::unique_ptr<Reservation>(new Reservation(context.getModel(), i)));
         }
     }
 
-    reserveConnectorZeroSupported = declareConfiguration<bool>("ReserveConnectorZeroSupported", true, CONFIGURATION_VOLATILE, false, true, false, false);
-
-    //append "Reservation" to FeatureProfiles list
-    const char *fpId = "Reservation";
-    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
-    if (!strstr(*fProfile, fpId)) {
-        auto fProfilePlus = std::string(*fProfile);
-        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
-            fProfilePlus += ",";
-        fProfilePlus += fpId;
-        *fProfile = fProfilePlus.c_str();
-    }
+    reserveConnectorZeroSupportedBool = declareConfiguration<bool>("ReserveConnectorZeroSupported", true, CONFIGURATION_VOLATILE, true);
     
     context.getOperationRegistry().registerOperation("CancelReservation", [&context] () {
         return new Ocpp16::CancelReservation(context.getModel());});
@@ -44,23 +33,23 @@ ReservationService::ReservationService(Context& context, unsigned int numConnect
 void ReservationService::loop() {
     //check if to end reservations
 
-    for (Reservation& reservation : reservations) {
-        if (!reservation.isActive()) {
+    for (auto& reservation : reservations) {
+        if (!reservation->isActive()) {
             continue;
         }
 
-        if (auto connector = context.getModel().getConnector(reservation.getConnectorId())) {
+        if (auto connector = context.getModel().getConnector(reservation->getConnectorId())) {
 
             //check if connector went inoperative
             auto cStatus = connector->getStatus();
             if (cStatus == ChargePointStatus::Faulted || cStatus == ChargePointStatus::Unavailable) {
-                reservation.clear();
+                reservation->clear();
                 continue;
             }
 
             //check if other tx started at this connector (e.g. due to RemoteStartTransaction)
             if (connector->getTransaction() && connector->getTransaction()->isActive()) {
-                reservation.clear();
+                reservation->clear();
                 continue;
             }
         }
@@ -70,10 +59,10 @@ void ReservationService::loop() {
             auto& transaction = context.getModel().getConnector(cId)->getTransaction();
             if (transaction) {
                 const char *cIdTag = transaction->getIdTag();
-                if (transaction->getReservationId() == reservation.getReservationId() || 
-                        (cIdTag && !strcmp(cIdTag, reservation.getIdTag()))) {
+                if (transaction->getReservationId() == reservation->getReservationId() || 
+                        (cIdTag && !strcmp(cIdTag, reservation->getIdTag()))) {
                     
-                    reservation.clear();
+                    reservation->clear();
                     break;
                 }
             }
@@ -87,9 +76,9 @@ Reservation *ReservationService::getReservation(unsigned int connectorId) {
         return nullptr; //cannot fetch for connectorId 0 because multiple reservations are possible at a time
     }
 
-    for (Reservation& reservation : reservations) {
-        if (reservation.isActive() && reservation.matches(connectorId)) {
-            return &reservation;
+    for (auto& reservation : reservations) {
+        if (reservation->isActive() && reservation->matches(connectorId)) {
+            return reservation.get();
         }
     }
     
@@ -104,18 +93,18 @@ Reservation *ReservationService::getReservation(const char *idTag, const char *p
 
     Reservation *connectorReservation = nullptr;
 
-    for (Reservation& reservation : reservations) {
-        if (!reservation.isActive()) {
+    for (auto& reservation : reservations) {
+        if (!reservation->isActive()) {
             continue;
         }
 
         //TODO check for parentIdTag
 
-        if (reservation.matches(idTag, parentIdTag)) {
-            if (reservation.getConnectorId() == 0) {
-                return &reservation; //reservation at connectorId 0 has higher priority
+        if (reservation->matches(idTag, parentIdTag)) {
+            if (reservation->getConnectorId() == 0) {
+                return reservation.get(); //reservation at connectorId 0 has higher priority
             } else {
-                connectorReservation = &reservation;
+                connectorReservation = reservation.get();
             }
         }
     }
@@ -139,7 +128,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
         }
     }
 
-    if (reserveConnectorZeroSupported && !*reserveConnectorZeroSupported) {
+    if (reserveConnectorZeroSupportedBool && !reserveConnectorZeroSupportedBool->getBool()) {
         //no connectorZero check - all done
         MOCPP_DBG_DEBUG("no reservation");
         return nullptr;
@@ -150,10 +139,10 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
 
     //Check if there are enough free connectors to satisfy all reservations at connectorId 0
     unsigned int unspecifiedReservations = 0;
-    for (Reservation& ires : reservations) {
-        if (ires.isActive() && ires.getConnectorId() == 0) {
+    for (auto& reservation : reservations) {
+        if (reservation->isActive() && reservation->getConnectorId() == 0) {
             unspecifiedReservations++;
-            blockingReservation = &ires;
+            blockingReservation = reservation.get();
         }
     }
 
@@ -180,9 +169,9 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
 }
 
 Reservation *ReservationService::getReservationById(int reservationId) {
-    for (Reservation& reservation : reservations) {
-        if (reservation.isActive() && reservation.getReservationId() == reservationId) {
-            return &reservation;
+    for (auto& reservation : reservations) {
+        if (reservation->isActive() && reservation->getReservationId() == reservationId) {
+            return reservation.get();
         }
     }
 
@@ -207,9 +196,9 @@ bool ReservationService::updateReservation(JsonObject payload) {
     }
 
     //update free reservation slot
-    for (Reservation& reservation : reservations) {
-        if (!reservation.isActive()) {
-            reservation.update(payload);
+    for (auto& reservation : reservations) {
+        if (!reservation->isActive()) {
+            reservation->update(payload);
             return true;
         }
     }
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.h b/src/MicroOcpp/Model/Reservation/ReservationService.h
index fb1cd289..40876e41 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.h
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.h
@@ -7,6 +7,8 @@
 
 #include <MicroOcpp/Model/Reservation/Reservation.h>
 
+#include <memory>
+
 namespace MicroOcpp {
 
 class Context;
@@ -16,9 +18,9 @@ class ReservationService {
     Context& context;
 
     const int maxReservations; // = number of physical connectors
-    std::vector<Reservation> reservations;
+    std::vector<std::unique_ptr<Reservation>> reservations;
 
-    std::shared_ptr<Configuration<bool>> reserveConnectorZeroSupported;
+    std::shared_ptr<Configuration> reserveConnectorZeroSupportedBool;
 
 public:
     ReservationService(Context& context, unsigned int numConnectors);
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index 7e342fbb..68a3ea1b 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -26,7 +26,7 @@ using namespace MicroOcpp;
 ResetService::ResetService(Context& context)
       : context(context) {
 
-    resetRetries = declareConfiguration<int>("ResetRetries", 2, CONFIGURATION_FN, true, true, false, false);
+    resetRetriesInt = declareConfiguration<int>("ResetRetries", 2);
 
     context.getOperationRegistry().registerOperation("Reset", [&context] () {
         return new Ocpp16::Reset(context.getModel());});
@@ -90,7 +90,7 @@ std::function<void(bool)> ResetService::getExecuteReset() {
 
 void ResetService::initiateReset(bool isHard) {
     isHardReset = isHard;
-    outstandingResetRetries = 1 + *resetRetries; //one initial try + no. of retries
+    outstandingResetRetries = 1 + resetRetriesInt->getInt(); //one initial try + no. of retries
     if (outstandingResetRetries > 5) {
         MOCPP_DBG_ERR("no. of reset trials exceeds 5");
         outstandingResetRetries = 5;
diff --git a/src/MicroOcpp/Model/Reset/ResetService.h b/src/MicroOcpp/Model/Reset/ResetService.h
index ce8c27d7..992785e3 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.h
+++ b/src/MicroOcpp/Model/Reset/ResetService.h
@@ -5,6 +5,8 @@
 #ifndef RESETSERVICE_H
 #define RESETSERVICE_H
 
+#include <functional>
+
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 
 namespace MicroOcpp {
@@ -21,7 +23,7 @@ class ResetService {
     bool isHardReset = false;
     unsigned long t_resetRetry;
 
-    std::shared_ptr<Configuration<int>> resetRetries;
+    std::shared_ptr<Configuration> resetRetriesInt;
 
 public:
     ResetService(Context& context);
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index 092999a9..da04bf6b 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -303,20 +303,10 @@ SmartChargingService::SmartChargingService(Context& context, std::shared_ptr<Fil
         connectors.push_back(std::move(SmartChargingConnector(context.getModel(), filesystem, cId, ChargePointMaxProfile, ChargePointTxDefaultProfile)));
     }
 
-    declareConfiguration<int>("ChargeProfileMaxStackLevel", CHARGEPROFILEMAXSTACKLEVEL, CONFIGURATION_VOLATILE, false, true, false, false);
-    declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE, false);
-    declareConfiguration<int>("ChargingScheduleMaxPeriods", CHARGINGSCHEDULEMAXPERIODS, CONFIGURATION_VOLATILE, false, true, false, false);
-    declareConfiguration<int>("MaxChargingProfilesInstalled", MAXCHARGINGPROFILESINSTALLED, CONFIGURATION_VOLATILE, false, true, false, false);
-
-    const char *fpId = "SmartCharging";
-    auto fProfile = declareConfiguration<const char*>("SupportedFeatureProfiles",fpId, CONFIGURATION_VOLATILE, false, true, true, false);
-    if (!strstr(*fProfile, fpId)) {
-        auto fProfilePlus = std::string(*fProfile);
-        if (!fProfilePlus.empty() && fProfilePlus.back() != ',')
-            fProfilePlus += ",";
-        fProfilePlus += fpId;
-        *fProfile = fProfilePlus.c_str();
-    }
+    declareConfiguration<int>("ChargeProfileMaxStackLevel", CHARGEPROFILEMAXSTACKLEVEL, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE);
+    declareConfiguration<int>("ChargingScheduleMaxPeriods", CHARGINGSCHEDULEMAXPERIODS, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<int>("MaxChargingProfilesInstalled", MAXCHARGINGPROFILESINSTALLED, CONFIGURATION_VOLATILE, true);
 
     context.getOperationRegistry().registerOperation("ClearChargingProfile", [this] () {
         return new Ocpp16::ClearChargingProfile(*this);});
@@ -556,14 +546,14 @@ void SmartChargingService::setSmartChargingOutput(unsigned int connectorId, std:
 void SmartChargingService::updateAllowedChargingRateUnit(bool powerSupported, bool currentSupported) {
     if ((powerSupported != this->powerSupported) || (currentSupported != this->currentSupported)) {
 
-        auto chargingScheduleAllowedChargingRateUnit = declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE, false);
-        if (chargingScheduleAllowedChargingRateUnit) {
+        auto chargingScheduleAllowedChargingRateUnitString = declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE);
+        if (chargingScheduleAllowedChargingRateUnitString) {
             if (powerSupported && currentSupported) {
-                *chargingScheduleAllowedChargingRateUnit = "Current,Power";
+                chargingScheduleAllowedChargingRateUnitString->setString("Current,Power");
             } else if (powerSupported) {
-                *chargingScheduleAllowedChargingRateUnit = "Power";
+                chargingScheduleAllowedChargingRateUnitString->setString("Power");
             } else if (currentSupported) {
-                *chargingScheduleAllowedChargingRateUnit = "Current";
+                chargingScheduleAllowedChargingRateUnitString->setString("Current");
             }
         }
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
index 84e9a4f8..7897dc0f 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
@@ -22,18 +22,20 @@ ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context,
         connectorId(connectorId),
         filesystem(filesystem) {
 
-    char key [30] = {'\0'};
-    if (snprintf(key, 30, MOCPP_CONFIG_EXT_PREFIX "txEnd_%u", connectorId) < 0) {
-        MOCPP_DBG_ERR("Invalid key");
-        (void)0;
-    }
-    txEnd = declareConfiguration<int>(key, 0, MOCPP_TXSTORE_META_FN, false, false, true, false);
+    snprintf(txBeginKey, sizeof(txBeginKey), MOCPP_TXSTORE_TXBEGIN_KEY "%u", connectorId);
+    txBeginInt = declareConfiguration<int>(txBeginKey, 0, MOCPP_TXSTORE_META_FN, false, false, false);
+
+    snprintf(txEndKey, sizeof(txEndKey), MOCPP_TXSTORE_TXEND_KEY "%u", connectorId);
+    txEndInt = declareConfiguration<int>(txEndKey, 0, MOCPP_TXSTORE_META_FN, false, false, false);
+}
 
-    if (snprintf(key, 30, MOCPP_CONFIG_EXT_PREFIX "txBegin_%u", connectorId) < 0) {
-        MOCPP_DBG_ERR("Invalid key");
-        (void)0;
+ConnectorTransactionStore::~ConnectorTransactionStore() {
+    if (txBeginInt->getKey() == txBeginKey) {
+        txBeginInt->setKey(nullptr);
+    }
+    if (txEndInt->getKey() == txEndKey) {
+        txEndInt->setKey(nullptr);
     }
-    txBegin = declareConfiguration<int>(key, 0, MOCPP_TXSTORE_META_FN, false, false, true, false);
 }
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned int txNr) {
@@ -110,13 +112,13 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool silent) {
     
-    if (!txBegin || *txBegin < 0 || !txEnd || *txEnd < 0) {
+    if (!txBeginInt || txBeginInt->getInt() < 0 || !txEndInt || txEndInt->getInt() < 0) {
         MOCPP_DBG_ERR("memory corruption");
         return nullptr;
     }
 
     //check if maximum number of queued tx already reached
-    if ((*txEnd + MAX_TX_CNT - *txBegin) % MAX_TX_CNT >= MOCPP_TXRECORD_SIZE) {
+    if ((txEndInt->getInt() + MAX_TX_CNT - txBeginInt->getInt()) % MAX_TX_CNT >= MOCPP_TXRECORD_SIZE) {
         //limit reached
 
         if (!silent) {
@@ -126,9 +128,9 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool s
         //special case: silent tx -> create tx anyway, but should be deleted immediately after charging session
     }
 
-    auto transaction = std::make_shared<Transaction>(*this, connectorId, (unsigned int) *txEnd, silent);
+    auto transaction = std::make_shared<Transaction>(*this, connectorId, (unsigned int) txEndInt->getInt(), silent);
 
-    *txEnd = (*txEnd + 1) % MAX_TX_CNT;
+    txEndInt->setInt((txEndInt->getInt() + 1) % MAX_TX_CNT);
     configuration_save();
 
     if (!commit(transaction.get())) {
@@ -148,12 +150,12 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool s
 }
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::getLatestTransaction() {
-    if (!txEnd || *txEnd < 0) {
+    if (!txEndInt || txEndInt->getInt() < 0) {
         MOCPP_DBG_ERR("memory corruption");
         return nullptr;
     }
 
-    unsigned int latest = ((unsigned int) *txEnd + MAX_TX_CNT - 1) % MAX_TX_CNT;
+    unsigned int latest = ((unsigned int) txEndInt->getInt() + MAX_TX_CNT - 1) % MAX_TX_CNT;
 
     return getTransaction(latest);
 }
@@ -213,50 +215,50 @@ bool ConnectorTransactionStore::remove(unsigned int txNr) {
 }
 
 int ConnectorTransactionStore::getTxBegin() {
-    if (!txBegin || *txBegin < 0) {
+    if (!txBeginInt || txBeginInt->getInt() < 0) {
         MOCPP_DBG_ERR("memory corruption");
         return -1;
     }
 
-    return *txBegin;
+    return txBeginInt->getInt();
 }
 
 int ConnectorTransactionStore::getTxEnd() {
-    if (!txBegin || *txBegin < 0) {
+    if (!txEndInt || txEndInt->getInt() < 0) {
         MOCPP_DBG_ERR("memory corruption");
         return -1;
     }
 
-    return *txEnd;
+    return txEndInt->getInt();
 }
 
 void ConnectorTransactionStore::setTxBegin(unsigned int txNr) {
-    if (!txBegin || *txBegin < 0) {
+    if (!txBeginInt || txBeginInt->getInt() < 0) {
         MOCPP_DBG_ERR("memory corruption");
         return;
     }
 
-    *txBegin = txNr;
+    txBeginInt->setInt(txNr);
     configuration_save();
 }
 
 void ConnectorTransactionStore::setTxEnd(unsigned int txNr) {
-    if (!txBegin || *txBegin < 0 || !txEnd || *txEnd < 0) {
+    if (!txBeginInt || txBeginInt->getInt() < 0 || !txEndInt || txEndInt->getInt() < 0) {
         MOCPP_DBG_ERR("memory corruption");
         return;
     }
 
-    *txEnd = txNr;
+    txEndInt->setInt(txNr);
     configuration_save();
 }
 
 unsigned int ConnectorTransactionStore::size() {
-    if (!txBegin || *txBegin < 0 || !txEnd || *txEnd < 0) {
+    if (!txBeginInt || txBeginInt->getInt() < 0 || !txEndInt || txEndInt->getInt() < 0) {
         MOCPP_DBG_ERR("memory corruption");
         return 0;
     }
 
-    return (*txEnd + MAX_TX_CNT - *txBegin) % MAX_TX_CNT;
+    return (txEndInt->getInt() + MAX_TX_CNT - txBeginInt->getInt()) % MAX_TX_CNT;
 }
 
 TransactionStore::TransactionStore(unsigned int nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
@@ -265,6 +267,8 @@ TransactionStore::TransactionStore(unsigned int nConnectors, std::shared_ptr<Fil
         connectors.push_back(std::unique_ptr<ConnectorTransactionStore>(
             new ConnectorTransactionStore(*this, i, filesystem)));
     }
+
+    configuration_load(MOCPP_TXSTORE_META_FN);
 }
 
 std::shared_ptr<Transaction> TransactionStore::getLatestTransaction(unsigned int connectorId) {
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.h b/src/MicroOcpp/Model/Transactions/TransactionStore.h
index a83d609d..5933142a 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.h
@@ -16,6 +16,9 @@
 #define MOCPP_TXRECORD_SIZE 4 //no. of tx to hold on flash storage
 #endif
 
+#define MOCPP_TXSTORE_TXBEGIN_KEY "txBegin_"
+#define MOCPP_TXSTORE_TXEND_KEY "txEnd_"
+
 namespace MicroOcpp {
 
 class TransactionStore;
@@ -26,13 +29,21 @@ class ConnectorTransactionStore {
     const unsigned int connectorId;
 
     std::shared_ptr<FilesystemAdapter> filesystem;
-    std::shared_ptr<Configuration<int>> txBegin; //if txNr < txBegin, tx has been safely deleted
-    std::shared_ptr<Configuration<int>> txEnd;
+    std::shared_ptr<Configuration> txBeginInt; //if txNr < txBegin, tx has been safely deleted
+    char txBeginKey [sizeof(MOCPP_TXSTORE_TXBEGIN_KEY "xxx") + 1]; //"xxx": placeholder for connectorId
+
+    std::shared_ptr<Configuration> txEndInt;
+    char txEndKey [sizeof(MOCPP_TXSTORE_TXEND_KEY "xxx") + 1];
     
     std::deque<std::weak_ptr<Transaction>> transactions;
 
 public:
     ConnectorTransactionStore(TransactionStore& context, unsigned int connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
+    ConnectorTransactionStore(const ConnectorTransactionStore&) = delete;
+    ConnectorTransactionStore(ConnectorTransactionStore&&) = delete;
+    ConnectorTransactionStore& operator=(const ConnectorTransactionStore&) = delete;
+
+    ~ConnectorTransactionStore();
     
     std::shared_ptr<Transaction> getLatestTransaction();
     bool commit(Transaction *transaction);
diff --git a/src/MicroOcpp/Operations/BootNotification.cpp b/src/MicroOcpp/Operations/BootNotification.cpp
index 41f79575..68298b1f 100644
--- a/src/MicroOcpp/Operations/BootNotification.cpp
+++ b/src/MicroOcpp/Operations/BootNotification.cpp
@@ -61,9 +61,9 @@ void BootNotification::processConf(JsonObject payload) {
     if (status == RegistrationStatus::Accepted) {
         //only write if in valid range
         if (interval >= 1) {
-            std::shared_ptr<Configuration<int>> intervalConf = declareConfiguration<int>("HeartbeatInterval", 86400);
-            if (intervalConf && interval != *intervalConf) {
-                *intervalConf = interval;
+            auto heartbeatIntervalInt = declareConfiguration<int>("HeartbeatInterval", 86400);
+            if (heartbeatIntervalInt && interval != heartbeatIntervalInt->getInt()) {
+                heartbeatIntervalInt->setInt(interval);
                 configuration_save();
             }
         }
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
index c7fe18fd..c0562424 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
@@ -35,7 +35,7 @@ void ChangeConfiguration::processReq(JsonObject payload) {
 
     const char *value = payload["value"];
 
-    std::shared_ptr<Configuration> configuration = getConfigurationPublic(key);
+    auto configuration = getConfigurationPublic(key);
 
     if (!configuration) {
         //configuration not found or hidden configuration
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index 99eee304..ad472a7a 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -70,7 +70,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
         //need to store ints by copied string: measure necessary capacity
         if (config->getType() == TConfig::Int) {
             char vbuf [VALUE_BUFSIZE];
-            auto ret = snprintf(vbuf, VALUE_BUFSIZE, "%i", config.getInt());
+            auto ret = snprintf(vbuf, VALUE_BUFSIZE, "%i", config->getInt());
             if (ret < 0 || ret >= VALUE_BUFSIZE) {
                 continue;
             }
@@ -104,7 +104,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
         const char *v = "";
         switch (config->getType()) {
             case TConfig::Int: {
-                auto ret = snprintf(vbuf, VALUE_BUFSIZE, "%i", config.getInt());
+                auto ret = snprintf(vbuf, VALUE_BUFSIZE, "%i", config->getInt());
                 if (ret < 0 || ret >= VALUE_BUFSIZE) {
                     MOCPP_DBG_ERR("value error");
                     continue;
@@ -112,20 +112,16 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
                 v = vbuf;
             }
             case TConfig::Bool:
-                v = config.getBool() ? "true" : "false";
+                v = config->getBool() ? "true" : "false";
                 break;
             case TConfig::String:
-                v = config.getString();
-                if (!v) {
-                    MOCPP_DBG_ERR("invalid config");
-                    continue;
-                }
+                v = config->getString();
                 break;
         }
 
         JsonObject jconfig = jsonConfigurationKey.createNestedObject();
-        jconfig["key"] = config.getKey();
-        jconfig["readonly"] = config.isReadOnly();
+        jconfig["key"] = config->getKey();
+        jconfig["readonly"] = config->isReadOnly();
         if (v == vbuf) {
             //value points to buffer on stack, needs to be copied into JSON memory pool
             jconfig["value"] = (char*) v;
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index ff5811ef..e3ef457d 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -52,8 +52,8 @@ void ReserveNow::processReq(JsonObject payload) {
             return;
         }
 
-        auto reserveConnectorZeroSupported = declareConfiguration<bool>("ReserveConnectorZeroSupported", true, CONFIGURATION_VOLATILE);
-        if (connectorId == 0 && (!reserveConnectorZeroSupported || !*reserveConnectorZeroSupported)) {
+        auto reserveConnectorZeroSupportedBool = declareConfiguration<bool>("ReserveConnectorZeroSupported", true, CONFIGURATION_VOLATILE);
+        if (connectorId == 0 && (!reserveConnectorZeroSupportedBool || !reserveConnectorZeroSupportedBool->getBool())) {
             reservationStatus = "Rejected";
             return;
         }
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 215d7692..efbd8d08 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -11,6 +11,7 @@
 #define SCPROFILE "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]"
 
 TEST_CASE( "C++ API test" ) {
+    printf("\nRun %s\n",  "C++ API test");
 
     //initialize Context with dummy socket
     MicroOcpp::LoopbackConnection loopback;
@@ -81,8 +82,8 @@ TEST_CASE( "C++ API test" ) {
 
         //set configuration which uses all Inputs and Outputs
 
-        auto MeterValuesSampledData = MicroOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
-        *MeterValuesSampledData = "Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered";
+        auto MeterValuesSampledDataString = MicroOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered");
 
         loopback.sendTXT(SCPROFILE, strlen(SCPROFILE));
 
@@ -252,8 +253,8 @@ TEST_CASE( "C API test" ) {
 
         //set configuration which uses all Inputs and Outputs
 
-        auto MeterValuesSampledData = MicroOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
-        *MeterValuesSampledData = "Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered";
+        auto MeterValuesSampledDataString = MicroOcpp::declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Energy.Active.Import.Register,Power.Active.Import,Current.Import,Current.Offered");
 
         loopback.sendTXT(SCPROFILE, strlen(SCPROFILE));
 
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 40ed3087..87b5a4a5 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -16,6 +16,7 @@ using namespace MicroOcpp;
 
 
 TEST_CASE( "Charging sessions" ) {
+    printf("\nRun %s\n",  "Charging sessions");
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
@@ -26,10 +27,10 @@ TEST_CASE( "Charging sessions" ) {
 
     mocpp_set_timer(custom_timer_cb);
 
-    auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN);
-        *connectionTimeOut = 30;
-    auto minimumStatusDuration = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN);
-        *minimumStatusDuration = 0;
+    auto connectionTimeOutInt = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN);
+    connectionTimeOutInt->setInt(30);
+    auto minimumStatusDurationInt = declareConfiguration<int>("MinimumStatusDuration", 0, CONFIGURATION_FN);
+    minimumStatusDurationInt->setInt(0);
     
     std::array<const char*, 2> expectedSN {"Available", "Available"};
     std::array<bool, 2> checkedSN {false, false};
@@ -118,7 +119,7 @@ TEST_CASE( "Charging sessions" ) {
 
             checkedSN[1] = false;
             expectedSN[1] = "Available";
-            mtime += *connectionTimeOut * 1000;
+            mtime += connectionTimeOutInt->getInt() * 1000;
             loop();
             REQUIRE(checkedSN[1]);
         }
@@ -184,7 +185,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
+        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         loop();
@@ -245,7 +246,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
+        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         loop();
@@ -259,7 +260,7 @@ TEST_CASE( "Charging sessions" ) {
 
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
+        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         bool checkProcessed = false;
@@ -296,7 +297,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
+        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         loop();
@@ -313,7 +314,7 @@ TEST_CASE( "Charging sessions" ) {
 
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        *declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN) = true;
+        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         bool checkProcessed = false;
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index ab85b8e4..1943aca6 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -46,9 +46,10 @@ class CustomStartTransaction : public Operation {
 };
 
 TEST_CASE( "Configuration Behavior" ) {
+    printf("\nRun %s\n",  "Configuration Behavior");
 
     //clean state
-    auto filesystem = makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail);
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
     MOCPP_DBG_DEBUG("remove all");
     FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
 
@@ -70,10 +71,10 @@ TEST_CASE( "Configuration Behavior" ) {
         startTransaction("mIdTag");
         loop();
 
-        auto config = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true);
+        auto configBool = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true);
 
         SECTION("set true") {
-            *config = true;
+            configBool->setBool(true);
 
             setConnectorPluggedInput([] () {return false;});
             loop();
@@ -82,7 +83,7 @@ TEST_CASE( "Configuration Behavior" ) {
         }
 
         SECTION("set false") {
-            *config = false;
+            configBool->setBool(false);
 
             setConnectorPluggedInput([] () {return false;});
             loop();
@@ -97,13 +98,13 @@ TEST_CASE( "Configuration Behavior" ) {
     }
 
     SECTION("StopTransactionOnInvalidId") {
-        auto config = declareConfiguration<bool>("StopTransactionOnInvalidId", true);
+        auto configBool = declareConfiguration<bool>("StopTransactionOnInvalidId", true);
 
         checkMsg.registerOperation("Authorize", [] () {return new CustomAuthorize("Invalid");});
         checkMsg.registerOperation("StartTransaction", [] () {return new CustomStartTransaction("Invalid");});
 
         SECTION("set true") {
-            *config = true;
+            configBool->setBool(true);
 
             beginTransaction("mIdTag");
             loop();
@@ -117,7 +118,7 @@ TEST_CASE( "Configuration Behavior" ) {
         }
 
         SECTION("set false") {
-            *config = false;
+            configBool->setBool(false);
 
             beginTransaction("mIdTag");
             loop();
@@ -137,14 +138,14 @@ TEST_CASE( "Configuration Behavior" ) {
     }
 
     SECTION("AllowOfflineTxForUnknownId") {
-        auto config = declareConfiguration<bool>("AllowOfflineTxForUnknownId", true);
-        auto authorizationTimeout = MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 1);
-        *authorizationTimeout = 1; //try normal Authorize for 1s, then enter offline mode
+        auto configBool = declareConfiguration<bool>("AllowOfflineTxForUnknownId", true);
+        auto authorizationTimeoutInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 1);
+        authorizationTimeoutInt->setInt(1); //try normal Authorize for 1s, then enter offline mode
 
         loopback.setConnected(false); //connection loss
 
         SECTION("set true") {
-            *config = true;
+            configBool->setBool(true);
 
             beginTransaction("mIdTag");
             loop();
@@ -158,7 +159,7 @@ TEST_CASE( "Configuration Behavior" ) {
         }
 
         SECTION("set false") {
-            *config = false;
+            configBool->setBool(false);
 
             beginTransaction("mIdTag");
             REQUIRE(connector->getStatus() == ChargePointStatus::Preparing);
@@ -173,14 +174,12 @@ TEST_CASE( "Configuration Behavior" ) {
     }
 
     SECTION("LocalPreAuthorize") {
-        auto config = declareConfiguration<bool>("LocalPreAuthorize", true);
-        auto authorizationTimeout = MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
-        *authorizationTimeout = 300; //try normal Authorize for 5 minutes
+        auto configBool = declareConfiguration<bool>("LocalPreAuthorize", true);
+        auto authorizationTimeoutInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
+        authorizationTimeoutInt->setInt(300); //try normal Authorize for 5 minutes
 
-        auto localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", true, CONFIGURATION_FN, true, true, true, false);
-        *localAuthorizeOffline = true;
-        auto localAuthListEnabled = declareConfiguration<bool>("LocalAuthListEnabled", true, CONFIGURATION_FN, true, true, true, false);
-        *localAuthListEnabled = true;
+        declareConfiguration<bool>("LocalAuthorizeOffline", true)->setBool(true);
+        declareConfiguration<bool>("LocalAuthListEnabled", true)->setBool(true);
 
         //define local auth list with entry local-idtag
         const char *localListMsg = "[2,\"testmsg-01\",\"SendLocalList\",{\"listVersion\":1,\"localAuthorizationList\":[{\"idTag\":\"local-idtag\",\"idTagInfo\":{\"status\":\"Accepted\"}}],\"updateType\":\"Full\"}]";
@@ -190,7 +189,7 @@ TEST_CASE( "Configuration Behavior" ) {
         loopback.setConnected(false); //connection loss
 
         SECTION("set true - accepted idtag") {
-            *config = true;
+            configBool->setBool(true);
 
             beginTransaction("local-idtag");
             loop();
@@ -199,7 +198,7 @@ TEST_CASE( "Configuration Behavior" ) {
         }
 
         SECTION("set false") {
-            *config = false;
+            configBool->setBool(false);
 
             beginTransaction("local-idtag");
             loop();
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index cef49369..84561cbb 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -12,6 +12,7 @@
 using namespace MicroOcpp;
 
 TEST_CASE("Metering") {
+    printf("\nRun %s\n",  "Metering");
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
@@ -36,8 +37,8 @@ TEST_CASE("Metering") {
             return 0;
         }, "Voltage");
 
-        auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
-        *MeterValuesSampledData = "";
+        auto MeterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData","");
+        MeterValuesSampledDataString->setString("");
 
         bool checkProcessed = false;
 
@@ -58,7 +59,7 @@ TEST_CASE("Metering") {
         loop();
 
         REQUIRE(checkProcessed);
-        REQUIRE(!strcmp((const char*) *MeterValuesSampledData, ""));
+        REQUIRE(!strcmp(MeterValuesSampledDataString->getString(), ""));
 
         checkProcessed = false;
 
@@ -78,7 +79,7 @@ TEST_CASE("Metering") {
         loop();
 
         REQUIRE(checkProcessed);
-        REQUIRE(!strcmp((const char*) *MeterValuesSampledData, "Voltage,Energy.Active.Import.Register"));
+        REQUIRE(!strcmp(MeterValuesSampledDataString->getString(), "Voltage,Energy.Active.Import.Register"));
     }
 
     SECTION("Capture Periodic data") {
@@ -91,14 +92,14 @@ TEST_CASE("Metering") {
             return getOcppContext()->getModel().getClock().now() - base;
         }, "Energy.Active.Import.Register");
 
-        auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
-        *MeterValuesSampledData = "Energy.Active.Import.Register";
+        auto MeterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Energy.Active.Import.Register");
 
-        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
-        *MeterValueSampleInterval = 10;
+        auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        MeterValueSampleIntervalInt->setInt(10);
 
-        auto MeterValueCacheSize = declareConfiguration(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
-        *MeterValueCacheSize = 2;
+        auto MeterValueCacheSizeInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0);
+        MeterValueCacheSizeInt->setInt(2);
 
         bool checkProcessed = false;
 
@@ -150,17 +151,17 @@ TEST_CASE("Metering") {
         }, "Energy.Active.Import.Register");
 
         //disablee sampled data
-        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
-        *MeterValueSampleInterval = 0;
+        auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        MeterValueSampleIntervalInt->setInt(0);
 
-        auto ClockAlignedDataInterval  = declareConfiguration("ClockAlignedDataInterval", 0, CONFIGURATION_FN);
-        *ClockAlignedDataInterval = 900;
+        auto ClockAlignedDataIntervalInt  = declareConfiguration<int>("ClockAlignedDataInterval", 0, CONFIGURATION_FN);
+        ClockAlignedDataIntervalInt->setInt(900);
 
-        auto MeterValuesAlignedData = declareConfiguration<const char*>("MeterValuesAlignedData", "", CONFIGURATION_FN);
-        *MeterValuesAlignedData = "Energy.Active.Import.Register";
+        auto MeterValuesAlignedDataString = declareConfiguration<const char*>("MeterValuesAlignedData", "", CONFIGURATION_FN);
+        MeterValuesAlignedDataString->setString("Energy.Active.Import.Register");
 
-        auto MeterValueCacheSize = declareConfiguration(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
-        *MeterValueCacheSize = 2;
+        auto MeterValueCacheSizeInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
+        MeterValueCacheSizeInt->setInt(2);
 
         bool checkProcessed = false;
 
@@ -212,11 +213,11 @@ TEST_CASE("Metering") {
             return getOcppContext()->getModel().getClock().now() - base;
         }, "Energy.Active.Import.Register");
 
-        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
-        *MeterValueSampleInterval = 10;
+        auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        MeterValueSampleIntervalInt->setInt(10);
 
-        auto StopTxnSampledData = declareConfiguration<const char*>("StopTxnSampledData", "", CONFIGURATION_FN);
-        *StopTxnSampledData = "Energy.Active.Import.Register";
+        auto StopTxnSampledDataString = declareConfiguration<const char*>("StopTxnSampledData", "", CONFIGURATION_FN);
+        StopTxnSampledDataString->setString("Energy.Active.Import.Register");
 
         loop();
 
@@ -278,11 +279,11 @@ TEST_CASE("Metering") {
             nullptr,
             connectorId);
 
-        auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
-        *MeterValuesSampledData = "Power.Active.Import";
+        auto MeterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Power.Active.Import");
 
-        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
-        *MeterValueSampleInterval = 10;
+        auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        MeterValueSampleIntervalInt->setInt(10);
 
         bool checkProcessed = false;
 
@@ -315,14 +316,14 @@ TEST_CASE("Metering") {
             return 3600;
         }, "Power.Active.Import");
 
-        auto MeterValuesSampledData = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
-        *MeterValuesSampledData = "Energy.Active.Import.Register";
+        auto MeterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Energy.Active.Import.Register");
 
-        auto MeterValueSampleInterval = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
-        *MeterValueSampleInterval = 10;
+        auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        MeterValueSampleIntervalInt->setInt(10);
 
-        auto MeterValueCacheSize = declareConfiguration(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
-        *MeterValueCacheSize = 10;
+        auto MeterValueCacheSizeInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
+        MeterValueCacheSizeInt->setInt(10);
 
         bool checkProcessed = false;
 
@@ -353,7 +354,7 @@ TEST_CASE("Metering") {
 
         loop();
 
-        *MeterValuesSampledData = "Power.Active.Import";
+        MeterValuesSampledDataString->setString("Power.Active.Import");
 
         mtime = trackMtime + 20 * 1000;
 
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index acc821ab..81d73791 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -38,6 +38,7 @@ using namespace MicroOcpp;
 
 
 TEST_CASE( "SmartCharging" ) {
+    printf("\nRun %s\n",  "SmartCharging");
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 1c75265a..18bcfac9 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -14,6 +14,7 @@ using namespace MicroOcpp;
 
 
 TEST_CASE( "Transaction safety" ) {
+    printf("\nRun %s\n",  "Transaction safety");
 
     //initialize Context with dummy socket
     LoopbackConnection loopback;
@@ -21,8 +22,7 @@ TEST_CASE( "Transaction safety" ) {
 
     mocpp_set_timer(custom_timer_cb);
 
-    auto connectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 30, CONFIGURATION_FN);
-        *connectionTimeOut = 30;
+    declareConfiguration<int>("ConnectionTimeOut", 30)->setInt(30);
 
     SECTION("Basic transaction") {
         MOCPP_DBG_DEBUG("Basic transaction");
diff --git a/tests/ocppEngineLifecycle.cpp b/tests/ocppEngineLifecycle.cpp
index 1b90e4fe..496eb374 100644
--- a/tests/ocppEngineLifecycle.cpp
+++ b/tests/ocppEngineLifecycle.cpp
@@ -4,6 +4,7 @@
 #include "./helpers/testHelper.h"
 
 TEST_CASE( "Context lifecycle" ) {
+    printf("\nRun %s\n",  "Context lifecycle");
 
     //set console output to the cpp console to display outputs
     //mo_set_console_out(cpp_console_out);

From b892867b2c9d558da1978ed99251f6ae0dedbe23 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 20 Sep 2023 21:26:07 +0200
Subject: [PATCH 376/549] clean up ConfigurationContainer interface

---
 src/MicroOcpp/Core/Configuration.cpp          | 102 +++++++++++------
 src/MicroOcpp/Core/Configuration.h            |   3 +-
 src/MicroOcpp/Core/ConfigurationContainer.cpp | 105 ++++--------------
 src/MicroOcpp/Core/ConfigurationContainer.h   |  29 +----
 .../Core/ConfigurationContainerFlash.cpp      |  96 +++++++++-------
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp  |  41 +++----
 src/MicroOcpp/Core/ConfigurationKeyValue.h    |   4 +-
 src/MicroOcpp/Operations/GetConfiguration.cpp |   2 +-
 8 files changed, 170 insertions(+), 212 deletions(-)

diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index dfcf3f6a..30b46cd0 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -84,30 +84,84 @@ ConfigurationContainer *declareContainer(const char *filename, bool accessible)
     return container.get();
 }
 
-template<>
-std::shared_ptr<Configuration> declareConfiguration<int>(const char *key, int factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible) {
-    if (auto container = declareContainer(filename, accessible)) {
-        return container->declareConfigurationInt(key, factoryDef, readonly, rebootRequired);
+std::shared_ptr<Configuration> loadConfiguration(TConfig type, const char *key, bool accessible) {
+    for (auto& container : configurationContainers) {
+        if (auto config = container->getConfiguration(key)) {
+            if (config->getType() != type) {
+                MOCPP_DBG_ERR("conflicting type for %s - remove old config", key);
+                container->removeConfiguration(config.get());
+                continue;
+            }
+            if (container->isAccessible() != accessible) {
+                MOCPP_DBG_ERR("conflicting accessibility for %s", key);
+                (void)0;
+            }
+            container->loadStaticKey(*config.get(), key);
+            return config;
+        }
     }
     return nullptr;
 }
 
+template<class T>
+bool loadFactoryDefault(Configuration& config, T loadFactoryDefault);
+
 template<>
-std::shared_ptr<Configuration> declareConfiguration<bool>(const char *key, bool factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible) {
-    if (auto container = declareContainer(filename, accessible)) {
-        return container->declareConfigurationBool(key, factoryDef, readonly, rebootRequired);
-    }
-    return nullptr;
+bool loadFactoryDefault<int>(Configuration& config, int factoryDef) {
+    config.setInt(factoryDef);
+    return true;
 }
 
 template<>
-std::shared_ptr<Configuration> declareConfiguration<const char*>(const char *key, const char *factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible) {
-    if (auto container = declareContainer(filename, accessible)) {
-        return container->declareConfigurationString(key, factoryDef, readonly, rebootRequired);
+bool loadFactoryDefault<bool>(Configuration& config, bool factoryDef) {
+    config.setBool(factoryDef);
+    return true;
+}
+
+template<>
+bool loadFactoryDefault<const char*>(Configuration& config, const char *factoryDef) {
+    return config.setString(factoryDef);
+}
+
+void loadPermissions(Configuration& config, bool readonly, bool rebootRequired) {
+    if (readonly) {
+        config.setReadOnly();
+    }
+
+    if (rebootRequired) {
+        config.setRebootRequired();
     }
-    return nullptr;
 }
 
+template<class T>
+std::shared_ptr<Configuration> declareConfiguration(const char *key, T factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible) {
+
+    std::shared_ptr<Configuration> res = loadConfiguration(convertType<T>(), key, accessible);
+    if (!res) {
+        auto container = declareContainer(filename, accessible);
+        if (!container) {
+            return nullptr;
+        }
+
+        res = container->createConfiguration(convertType<T>(), key);
+        if (!res) {
+            return nullptr;
+        }
+
+        if (!loadFactoryDefault(*res.get(), factoryDef)) {
+            container->removeConfiguration(res.get());
+            return nullptr;
+        }
+    }
+
+    loadPermissions(*res.get(), readonly, rebootRequired);
+    return res;
+}
+
+template std::shared_ptr<Configuration> declareConfiguration<int>(const char *key, int factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible);
+template std::shared_ptr<Configuration> declareConfiguration<bool>(const char *key, bool factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible);
+template std::shared_ptr<Configuration> declareConfiguration<const char*>(const char *key, const char *factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible);
+
 std::function<bool(const char*)> *getConfigurationValidator(const char *key) {
     for (auto& v : validators) {
         if (!strcmp(v.key, key)) {
@@ -127,13 +181,11 @@ void registerConfigurationValidator(const char *key, std::function<bool(const ch
     validators.push_back(Validator{key, validator});
 }
 
-
-
 Configuration *getConfigurationPublic(const char *key) {
     for (auto& container : configurationContainers) {
         if (container->isAccessible()) {
             if (auto res = container->getConfiguration(key)) {
-                return res;
+                return res.get();
             }
         }
     }
@@ -164,23 +216,11 @@ void configuration_deinit() {
     filesystem.reset();
 }
 
-bool configuration_load() {
-    bool success = true;
-
-    for (auto& container : configurationContainers) {
-        if (!container->load()) {
-            success = false;
-        }
-    }
-
-    return success;
-}
-
 bool configuration_load(const char *filename) {
     bool success = true;
 
     for (auto& container : configurationContainers) {
-        if (!strcmp(filename, container->getFilename()) && !container->load()) {
+        if ((!filename || !strcmp(filename, container->getFilename())) && !container->load()) {
             success = false;
         }
     }
@@ -200,8 +240,4 @@ bool configuration_save() {
     return success;
 }
 
-template std::shared_ptr<Configuration> declareConfiguration<int>(const char *key, int factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible);
-template std::shared_ptr<Configuration> declareConfiguration<bool>(const char *key, bool factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible);
-template std::shared_ptr<Configuration> declareConfiguration<const char*>(const char *key, const char *factoryDef, const char *filename, bool readonly, bool rebootRequired, bool accessible);
-
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index a872d840..7b4e3259 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -35,8 +35,7 @@ std::vector<ConfigurationContainer*> getConfigurationContainersPublic();
 bool configuration_init(std::shared_ptr<FilesystemAdapter> filesytem);
 void configuration_deinit();
 
-bool configuration_load();
-bool configuration_load(const char *filename);
+bool configuration_load(const char *filename = nullptr);
 
 bool configuration_save();
 
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index a5581364..e325acc2 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -12,77 +12,9 @@ ConfigurationContainer::~ConfigurationContainer() {
 
 }
 
-std::shared_ptr<Configuration> ConfigurationPool::getConfiguration_typesafe(const char *key, TConfig type) {
-    for (auto entry = configurations.begin(); entry != configurations.end();entry++) {
-        if ((*entry)->getKey() && !strcmp((*entry)->getKey(), key)) {
-            //found entry
-            if ((*entry)->getType() == type) {
-                return *entry;
-            } else {
-                MOCPP_DBG_ERR("conflicting types for %s - discard old config", key);
-                configurations.erase(entry);
-                break;
-            }
-        }
-    }
-    return nullptr;
-}
-
-template<class T>
-std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration(const char *key, T factoryDef, bool readonly, bool rebootRequired) {
-    
-    std::shared_ptr<Configuration> res = getConfiguration_typesafe(key, convertType<T>());
-
-    if (!res) {
-        //config doesn't exist yet
-        res = makeConfig<T>(key, factoryDef);
-        if (!res) {
-            //allocation failure - OOM
-            MOCPP_DBG_ERR("OOM");
-            return nullptr;
-        }
-        configurations.push_back(res);
-    }
-
-    if (readonly) {
-        res->setReadOnly();
-    }
-
-    if (rebootRequired) {
-        res->setRebootRequired();
-    }
-
-    return res;
-}
-
-template std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<int>(const char *key, int factoryDef, bool readonly, bool rebootRequired);
-template std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<bool>(const char *key, bool factoryDef, bool readonly, bool rebootRequired);
-template std::shared_ptr<Configuration> ConfigurationPool::declareConfiguration<const char*>(const char *key, const char *factoryDef, bool readonly, bool rebootRequired);
-
-std::vector<std::shared_ptr<Configuration>>& ConfigurationPool::getConfigurations() {
-    return configurations;
-}
-
-size_t ConfigurationPool::getConfigurationCount() const {
-        return configurations.size();
-    }
-
-Configuration *ConfigurationPool::getConfiguration(size_t i) const {
-    return configurations[i].get();
-}
-
-Configuration *ConfigurationPool::getConfiguration(const char *key) const {
-    for (auto& entry : configurations) {
-        if (entry->getKey() && !strcmp(entry->getKey(), key)) {
-            return entry.get();
-        }
-    }
-    return nullptr;
-}
-
 class ConfigurationContainerVolatile : public ConfigurationContainer {
 private:
-    ConfigurationPool container;
+    std::vector<std::shared_ptr<Configuration>> configurations;
 public:
     ConfigurationContainerVolatile(const char *filename, bool accessible) : ConfigurationContainer(filename, accessible) { }
 
@@ -90,28 +22,39 @@ class ConfigurationContainerVolatile : public ConfigurationContainer {
 
     bool save() override {return true;}
 
-    std::shared_ptr<Configuration> declareConfigurationInt(const char *key, int factoryDef, bool readonly = false, bool rebootRequired = false) override {
-        return container.declareConfiguration<int>(key, factoryDef, readonly, rebootRequired);
-    }
-
-    std::shared_ptr<Configuration> declareConfigurationBool(const char *key, bool factoryDef, bool readonly = false, bool rebootRequired = false) override {
-        return container.declareConfiguration<bool>(key, factoryDef, readonly, rebootRequired);
+    std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) override {
+        std::shared_ptr<Configuration> res = makeConfiguration(type, key);
+        if (!res) {
+            //allocation failure - OOM
+            MOCPP_DBG_ERR("OOM");
+            return nullptr;
+        }
+        configurations.push_back(res);
+        return res;
     }
 
-    std::shared_ptr<Configuration> declareConfigurationString(const char *key, const char*factoryDef, bool readonly = false, bool rebootRequired = false) override {
-        return container.declareConfiguration<const char*>(key, factoryDef, readonly, rebootRequired);
+    void removeConfiguration(Configuration *config) override {
+        configurations.erase(std::remove_if(configurations.begin(), configurations.end(),
+            [config] (std::shared_ptr<Configuration>& entry) {
+                return entry.get() == config;
+            }), configurations.end());
     }
 
     size_t getConfigurationCount() override {
-        return container.getConfigurationCount();
+        return configurations.size();
     }
 
     Configuration *getConfiguration(size_t i) override {
-        return container.getConfiguration(i);
+        return configurations[i].get();
     }
 
-    Configuration *getConfiguration(const char *key) override {
-        return container.getConfiguration(key);
+    std::shared_ptr<Configuration> getConfiguration(const char *key) override {
+        for (auto& entry : configurations) {
+            if (entry->getKey() && !strcmp(entry->getKey(), key)) {
+                return entry;
+            }
+        }
+        return nullptr;
     }
 };
 
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index 94988078..740dd55f 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -27,33 +27,14 @@ class ConfigurationContainer {
     virtual bool load() = 0; //called at the end of mocpp_intialize, to load the configurations with the stored value
     virtual bool save() = 0;
 
-    virtual std::shared_ptr<Configuration> declareConfigurationInt(const char *key, int factoryDef, bool readonly = false, bool rebootRequired = false) = 0;
-    virtual std::shared_ptr<Configuration> declareConfigurationBool(const char *key, bool factoryDef, bool readonly = false, bool rebootRequired = false) = 0;
-    virtual std::shared_ptr<Configuration> declareConfigurationString(const char *key, const char *factoryDef, bool readonly = false, bool rebootRequired = false) = 0;
-    
+    virtual std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) = 0;
+    virtual void removeConfiguration(Configuration *config) = 0;
+
     virtual size_t getConfigurationCount() = 0;
     virtual Configuration *getConfiguration(size_t i) = 0;
-    virtual Configuration *getConfiguration(const char *key) = 0;
-};
-
-//Utils class only used for internal ConfigurationContainer implementations
-class ConfigurationPool {
-private:
-    std::vector<std::shared_ptr<Configuration>> configurations;
-
-    std::shared_ptr<Configuration> getConfiguration_typesafe(const char *key, TConfig type);
-
-public:
-    template<class T>
-    std::shared_ptr<Configuration> declareConfiguration(const char *key, T factoryDef, bool readonly = false, bool rebootRequired = false);
-    
-    std::vector<std::shared_ptr<Configuration>>& getConfigurations();
-    
-    size_t getConfigurationCount() const;
-
-    Configuration *getConfiguration(size_t i) const;
+    virtual std::shared_ptr<Configuration> getConfiguration(const char *key) = 0;
 
-    Configuration *getConfiguration(const char *key) const;
+    virtual void loadStaticKey(Configuration& config, const char *key) { } //possible optimization: can replace internal key with passed key
 };
 
 std::unique_ptr<ConfigurationContainer> makeConfigurationContainerVolatile(const char *filename, bool accessible);
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index 1068cbb5..6430afe0 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -14,7 +14,7 @@ namespace MicroOcpp {
 
 class ConfigurationContainerFlash : public ConfigurationContainer {
 private:
-    ConfigurationPool container;
+    std::vector<std::shared_ptr<Configuration>> configurations;
     std::shared_ptr<FilesystemAdapter> filesystem;
     uint16_t revisionSum = 0;
 
@@ -25,11 +25,11 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
     void clearKeyPool(const char *key) {
         keyPool.erase(std::remove_if(keyPool.begin(), keyPool.end(), 
             [key] (const std::unique_ptr<char[]>& k) {
-#if MOCPP_DBG_LEVEL >= MOCPP_DL_VERBOSE
+                #if MOCPP_DBG_LEVEL >= MOCPP_DL_VERBOSE
                 if (!strcmp(k.get(), key)) {
                     MOCPP_DBG_VERBOSE("clear key %s", key);
                 }
-#endif
+                #endif
                 return !strcmp(k.get(), key);
             }), keyPool.end());
     }
@@ -38,7 +38,6 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         auto revisionSum_old = revisionSum;
 
         revisionSum = 0;
-        auto& configurations = container.getConfigurations();
         for (auto& config : configurations) {
             revisionSum += config->getValueRevision();
         }
@@ -59,8 +58,6 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
             return false;
         }
 
-        auto& configurations = container.getConfigurations();
-
         size_t file_size = 0;
         if (filesystem->stat(getFilename(), &file_size) != 0 // file does not exist
                 || file_size == 0) {                         // file exists, but empty
@@ -116,11 +113,15 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
             
             std::unique_ptr<char[]> key_pooled;
 
-            Configuration *config = container.getConfiguration(key);
-            if (!config || config->getType() != type) {
+            auto config = getConfiguration(key).get();
+            if (config && config->getType() != type) {
+                MOCPP_DBG_ERR("conflicting type for %s - remove old config", key);
+                removeConfiguration(config);
+                config = nullptr;
+            }
+            if (!config) {
                 key_pooled.reset(new char[strlen(key) + 1]);
                 strcpy(key_pooled.get(), key);
-                config = nullptr;
             }
 
             switch (type) {
@@ -130,12 +131,12 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                         continue;
                     }
                     int value = stored["value"] | 0;
+                    if (!config) {
+                        //create new config
+                        config = createConfiguration(TConfig::Int, key_pooled.get()).get();
+                    }
                     if (config) {
-                        //config already exists
                         config->setInt(value);
-                    } else {
-                        //create new config
-                        config = container.declareConfiguration<int>(key_pooled.get(), value).get();
                     }
                     break;
                 }
@@ -145,12 +146,12 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                         continue;
                     }
                     bool value = stored["value"] | false;
+                    if (!config) {
+                        //create new config
+                        config = createConfiguration(TConfig::Bool, key_pooled.get()).get();
+                    }
                     if (config) {
-                        //config already exists
                         config->setBool(value);
-                    } else {
-                        //create new config
-                        config = container.declareConfiguration<bool>(key_pooled.get(), value).get();
                     }
                     break;
                 }
@@ -160,12 +161,12 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                         continue;
                     }
                     const char *value = stored["value"] | "";
+                    if (!config) {
+                        //create new config
+                        config = createConfiguration(TConfig::String, key_pooled.get()).get();
+                    }
                     if (config) {
-                        //config already exists
                         config->setString(value);
-                    } else {
-                        //create new config
-                        config = container.declareConfiguration<const char*>(key_pooled.get(), value).get();
                     }
                     break;
                 }
@@ -201,8 +202,6 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
             return true; //nothing to be done
         }
 
-        auto& configurations = container.getConfigurations();
-
         //during mocpp_deinitialize(), key owners are destructed. Don't store if this container is affected
         for (auto& config : configurations) {
             if (!config->getKey()) {
@@ -268,39 +267,50 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         return success;
     }
 
-    std::shared_ptr<Configuration> declareConfigurationInt(const char *key, int factoryDef, bool readonly = false, bool rebootRequired = false) override {
-        auto res = container.declareConfiguration<int>(key, factoryDef, readonly, rebootRequired);
-        if (res) res->setKey(key);
-        clearKeyPool(key);
-        return res;
-    }
-
-    std::shared_ptr<Configuration> declareConfigurationBool(const char *key, bool factoryDef, bool readonly = false, bool rebootRequired = false) override {
-        auto res = container.declareConfiguration<bool>(key, factoryDef, readonly, rebootRequired);
-        if (res) res->setKey(key);
-        clearKeyPool(key);
+    std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) override {
+        std::shared_ptr<Configuration> res = makeConfiguration(type, key);
+        if (!res) {
+            //allocation failure - OOM
+            MOCPP_DBG_ERR("OOM");
+            return nullptr;
+        }
+        configurations.push_back(res);
         return res;
     }
 
-    std::shared_ptr<Configuration> declareConfigurationString(const char *key, const char*factoryDef, bool readonly = false, bool rebootRequired = false) override {
-        auto res = container.declareConfiguration<const char*>(key, factoryDef, readonly, rebootRequired);
-        if (res) res->setKey(key);
-        clearKeyPool(key);
-        return res;
+    void removeConfiguration(Configuration *config) override {
+        configurations.erase(std::remove_if(configurations.begin(), configurations.end(),
+            [this, config] (std::shared_ptr<Configuration>& entry) {
+                bool match = entry.get() == config;
+                if (match && config->getKey()) {
+                    std::string key_cpy = config->getKey();
+                    this->clearKeyPool(key_cpy.c_str());
+                }
+                return match;
+            }), configurations.end());
     }
 
     size_t getConfigurationCount() override {
-        return container.getConfigurationCount();
+        return configurations.size();
     }
 
     Configuration *getConfiguration(size_t i) override {
-        return container.getConfiguration(i);
+        return configurations[i].get();
     }
 
-    Configuration *getConfiguration(const char *key) override {
-        return container.getConfiguration(key);
+    std::shared_ptr<Configuration> getConfiguration(const char *key) override {
+        for (auto& entry : configurations) {
+            if (entry->getKey() && !strcmp(entry->getKey(), key)) {
+                return entry;
+            }
+        }
+        return nullptr;
     }
 
+    void loadStaticKey(Configuration& config, const char *key) override {
+        config.setKey(key);
+        clearKeyPool(key);
+    }
 };
 
 std::unique_ptr<ConfigurationContainer> makeConfigurationContainerFlash(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename, bool accessible) {
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index d44536e7..00ecc6be 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -228,33 +228,24 @@ class ConfigString : public Configuration {
     }
 };
 
-template<>
-std::unique_ptr<Configuration> makeConfig<int>(const char *key, int val) {
-    auto res = std::unique_ptr<Configuration>(new ConfigInt());
-    if (res) {
-        res->setKey(key);
-        res->setInt(val);
-    }
-    return res;
-};
-
-template<>
-std::unique_ptr<Configuration> makeConfig<bool>(const char *key, bool val) {
-    auto res = std::unique_ptr<Configuration>(new ConfigBool());
-    if (res) {
-        res->setKey(key);
-        res->setBool(val);
+std::unique_ptr<Configuration> makeConfiguration(TConfig type, const char *key) {
+    std::unique_ptr<Configuration> res;
+    switch (type) {
+        case TConfig::Int:
+            res.reset(new ConfigInt());
+            break;
+        case TConfig::Bool:
+            res.reset(new ConfigBool());
+            break;
+        case TConfig::String:
+            res.reset(new ConfigString());
+            break;
     }
-    return res;
-};
-
-template<>
-std::unique_ptr<Configuration> makeConfig<const char*>(const char *key, const char *val) {
-    auto res = std::unique_ptr<Configuration>(new ConfigString());
-    if (res) {
-        res->setKey(key);
-        res->setString(val);
+    if (!res) {
+        MOCPP_DBG_ERR("OOM");
+        return nullptr;
     }
+    res->setKey(key);
     return res;
 };
 
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index 5b064cf1..6afdfb2f 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -64,9 +64,7 @@ class Configuration {
  * How to use custom implementations: for each OCPP config, pass a config instance to the OCPP lib
  * before its initialization stage. Then the library won't create new config objects but 
  */
-
-template<class T>
-std::unique_ptr<Configuration> makeConfig(const char *key, T val);
+std::unique_ptr<Configuration> makeConfiguration(TConfig type, const char *key);
 
 const char *serializeTConfig(TConfig type);
 bool deserializeTConfig(const char *serialized, TConfig& out);
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index ad472a7a..5506cb07 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -47,7 +47,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
         for (auto& key : keys) {
             Configuration *res = nullptr;
             for (auto container : containers) {
-                if (res = container->getConfiguration(key.c_str())) {
+                if (res = container->getConfiguration(key.c_str()).get()) {
                     break;
                 }
             }

From 44b1df89a3a967a72348ea36f8ec87ad0789fd14 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 21 Sep 2023 15:39:20 +0200
Subject: [PATCH 377/549] binary size optimization

---
 src/MicroOcpp/Core/ConfigurationContainer.cpp      | 11 +++++++----
 src/MicroOcpp/Core/ConfigurationContainer.h        |  2 +-
 src/MicroOcpp/Core/ConfigurationContainerFlash.cpp | 10 +++-------
 3 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index e325acc2..e473b2a0 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -34,10 +34,13 @@ class ConfigurationContainerVolatile : public ConfigurationContainer {
     }
 
     void removeConfiguration(Configuration *config) override {
-        configurations.erase(std::remove_if(configurations.begin(), configurations.end(),
-            [config] (std::shared_ptr<Configuration>& entry) {
-                return entry.get() == config;
-            }), configurations.end());
+        for (auto entry = configurations.begin(); entry != configurations.end();) {
+            if (entry.get() == config) {
+                entry = configurations.erase(entry);
+            } else {
+                entry++;
+            }
+        }
     }
 
     size_t getConfigurationCount() override {
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index 740dd55f..9de8b499 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -34,7 +34,7 @@ class ConfigurationContainer {
     virtual Configuration *getConfiguration(size_t i) = 0;
     virtual std::shared_ptr<Configuration> getConfiguration(const char *key) = 0;
 
-    virtual void loadStaticKey(Configuration& config, const char *key) { } //possible optimization: can replace internal key with passed key
+    virtual void loadStaticKey(Configuration& config, const char *key) { } //possible optimization: can replace internal key with passed static key
 };
 
 std::unique_ptr<ConfigurationContainer> makeConfigurationContainerVolatile(const char *filename, bool accessible);
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index 6430afe0..9eaa44ba 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -279,14 +279,10 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
     }
 
     void removeConfiguration(Configuration *config) override {
+        clearKeyPool(config->getKey());
         configurations.erase(std::remove_if(configurations.begin(), configurations.end(),
-            [this, config] (std::shared_ptr<Configuration>& entry) {
-                bool match = entry.get() == config;
-                if (match && config->getKey()) {
-                    std::string key_cpy = config->getKey();
-                    this->clearKeyPool(key_cpy.c_str());
-                }
-                return match;
+            [config] (std::shared_ptr<Configuration>& entry) {
+                return entry.get() == config;
             }), configurations.end());
     }
 

From f2ef4a3fbfe9f36f844b70c0a5ba3e298b771592 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 21 Sep 2023 17:04:08 +0200
Subject: [PATCH 378/549] fix pointer access

---
 src/MicroOcpp/Core/ConfigurationContainer.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index e473b2a0..cae0ccae 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -35,7 +35,7 @@ class ConfigurationContainerVolatile : public ConfigurationContainer {
 
     void removeConfiguration(Configuration *config) override {
         for (auto entry = configurations.begin(); entry != configurations.end();) {
-            if (entry.get() == config) {
+            if (entry->get() == config) {
                 entry = configurations.erase(entry);
             } else {
                 entry++;

From c923c724dccb41819e35140f7afc565d0ac3b768 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 21 Sep 2023 19:00:35 +0200
Subject: [PATCH 379/549] fix SetChargingProfile JSON overflow

---
 src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
index 82cc84bf..e9950eac 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -213,10 +213,10 @@ bool ChargingProfile::toJson(DynamicJsonDocument& doc) {
     }
 
     doc = DynamicJsonDocument(
-            JSON_OBJECT_SIZE(9) +
-            JSON_OBJECT_SIZE(1) +
-                chargingScheduleDoc.memoryUsage());
-    
+            JSON_OBJECT_SIZE(9) + //no. of fields in ChargingProfile
+            2 * (JSONDATE_LENGTH + 1) + //validFrom and validTo
+            chargingScheduleDoc.memoryUsage()); //nested JSON object
+
     doc["chargingProfileId"] = chargingProfileId;
     if (transactionId >= 0) {
         doc["transactionId"] = transactionId;

From 42215f0c515d7834344e52ccf9e455361ff61442 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 21 Sep 2023 20:08:20 +0200
Subject: [PATCH 380/549] allow custom filename for diagnostics upload

---
 .../Model/Diagnostics/DiagnosticsService.cpp      | 11 ++++++++---
 .../Model/Diagnostics/DiagnosticsService.h        | 15 +++++++++------
 2 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 6908fe1d..ca655717 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -94,7 +94,7 @@ void DiagnosticsService::loop() {
 //timestamps before year 2021 will be treated as "undefined"
 std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &location, int retries, unsigned int retryInterval, Timestamp startTime, Timestamp stopTime) {
     if (onUpload == nullptr) //maybe add further plausibility checks
-        return nullptr;
+        return std::string{};
     
     this->location = location;
     this->retries = retries;
@@ -134,10 +134,15 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
     nextTry.toJsonString(dbuf, JSONDATE_LENGTH + 1);
     MOCPP_DBG_DEBUG("Initial try at %s", dbuf);
 
-    return "diagnostics.log";
+    std::string fileName;
+    if (createFilename) {
+        fileName = createFilename();
+    } else {
+        fileName = "diagnostics.log";
+    }
+    return fileName;
 }
 
-
 DiagnosticsStatus DiagnosticsService::getDiagnosticsStatus() {
     if (uploadIssued) {
         if (uploadStatusInput != nullptr) {
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
index 17a02263..aa0ceeec 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -26,16 +26,17 @@ class DiagnosticsService {
 private:
     Context& context;
     
-    std::string location {};
+    std::string location;
     int retries = 0;
     unsigned int retryInterval = 0;
-    Timestamp startTime = Timestamp();
-    Timestamp stopTime = Timestamp();
+    Timestamp startTime;
+    Timestamp stopTime;
 
-    Timestamp nextTry = Timestamp();
+    Timestamp nextTry;
 
-    std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload = nullptr;
-    std::function<UploadStatus()> uploadStatusInput = nullptr;
+    std::function<std::string()> createFilename;
+    std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload;
+    std::function<UploadStatus()> uploadStatusInput;
     bool uploadIssued = false;
 
     std::unique_ptr<Request> getDiagnosticsStatusNotification();
@@ -54,6 +55,8 @@ class DiagnosticsService {
 
     Ocpp16::DiagnosticsStatus getDiagnosticsStatus();
 
+    void setCreateFilename(std::function<std::string()> createFn); //create a new filename which will be used for the subsequent upload tries
+
     void setOnUpload(std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload);
 
     void setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput);

From 783e5097e3989bac106096bc1a34d92cc70ffde8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 21 Sep 2023 20:46:30 +0200
Subject: [PATCH 381/549] fix custom diag fn callback

---
 src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp | 8 ++++++--
 src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h   | 4 ++--
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index ca655717..964e7793 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -135,8 +135,8 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
     MOCPP_DBG_DEBUG("Initial try at %s", dbuf);
 
     std::string fileName;
-    if (createFilename) {
-        fileName = createFilename();
+    if (refreshFilename) {
+        fileName = refreshFilename();
     } else {
         fileName = "diagnostics.log";
     }
@@ -174,6 +174,10 @@ std::unique_ptr<Request> DiagnosticsService::getDiagnosticsStatusNotification()
     return nullptr;
 }
 
+void DiagnosticsService::setRefreshFilename(std::function<std::string()> refreshFn) {
+    this->refreshFilename = refreshFn;
+}
+
 void DiagnosticsService::setOnUpload(std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload) {
     this->onUpload = onUpload;
 }
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
index aa0ceeec..4edb160e 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -34,7 +34,7 @@ class DiagnosticsService {
 
     Timestamp nextTry;
 
-    std::function<std::string()> createFilename;
+    std::function<std::string()> refreshFilename;
     std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload;
     std::function<UploadStatus()> uploadStatusInput;
     bool uploadIssued = false;
@@ -55,7 +55,7 @@ class DiagnosticsService {
 
     Ocpp16::DiagnosticsStatus getDiagnosticsStatus();
 
-    void setCreateFilename(std::function<std::string()> createFn); //create a new filename which will be used for the subsequent upload tries
+    void setRefreshFilename(std::function<std::string()> refreshFn); //refresh a new filename which will be used for the subsequent upload tries
 
     void setOnUpload(std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload);
 

From 44d032ea770eed0de1cbaa2ee059cb3676a7d85f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 22 Sep 2023 22:55:53 +0200
Subject: [PATCH 382/549] Configuration unit tests

---
 CMakeLists.txt                                |   1 +
 src/MicroOcpp/Core/Configuration.cpp          |   1 +
 src/MicroOcpp/Core/Configuration.h            |   2 +-
 .../Core/ConfigurationContainerFlash.cpp      |   5 +-
 .../Operations/ChangeConfiguration.cpp        |  20 +-
 src/MicroOcpp/Operations/GetConfiguration.cpp |   3 +-
 tests/Configuration.cpp                       | 510 ++++++++++++++++++
 7 files changed, 530 insertions(+), 12 deletions(-)
 create mode 100644 tests/Configuration.cpp

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 20262899..86150458 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -124,6 +124,7 @@ set(MOCPP_SRC_UNIT
     tests/SmartCharging.cpp
     tests/Api.cpp
     tests/Metering.cpp
+    tests/Configuration.cpp
 )
 
 add_executable(mo_unit_tests
diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index 30b46cd0..25efaa1e 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -3,6 +3,7 @@
 // MIT License
 
 #include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/ConfigurationContainerFlash.h>
 #include <MicroOcpp/Debug.h>
 
 #include <string.h>
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index 7b4e3259..ad5b1392 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -6,7 +6,7 @@
 #define CONFIGURATION_H
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
-#include <MicroOcpp/Core/ConfigurationContainerFlash.h>
+#include <MicroOcpp/Core/ConfigurationContainer.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 
 #include <memory>
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index 9eaa44ba..32caf4fb 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -279,11 +279,14 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
     }
 
     void removeConfiguration(Configuration *config) override {
-        clearKeyPool(config->getKey());
+        const char *key = config->getKey();
         configurations.erase(std::remove_if(configurations.begin(), configurations.end(),
             [config] (std::shared_ptr<Configuration>& entry) {
                 return entry.get() == config;
             }), configurations.end());
+        if (key) {
+            clearKeyPool(key);
+        }
     }
 
     size_t getConfigurationCount() override {
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
index c0562424..c789ccee 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
@@ -124,7 +124,17 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     } else {
         convertibleBool = false;
     }
-    
+
+    //check against optional validator
+
+    auto validator = getConfigurationValidator(key);
+    if (validator && !(*validator)(value)) {
+        //validator exists and validation fails
+        reject = true;
+        MOCPP_DBG_WARN("validation failed for key=%s value=%s", key, value);
+        return;
+    }
+
     //Store (parsed) value to Config
 
     if (configuration->getType() == TConfig::Int && convertibleInt) {
@@ -132,14 +142,6 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     } else if (configuration->getType() == TConfig::Bool && convertibleBool) {
         configuration->setBool(numBool);
     } else if (configuration->getType() == TConfig::String) {
-        //string configurations can have a validator
-        auto validator = getConfigurationValidator(key);
-        if (validator && !(*validator)(value)) {
-            //validator exists and validation fails
-            reject = true;
-            MOCPP_DBG_WARN("validation failed for key=%s value=%s", key, value);
-            return;
-        }
         configuration->setString(value);
     } else {
         reject = true;
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index 5506cb07..a8089827 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -74,7 +74,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
             if (ret < 0 || ret >= VALUE_BUFSIZE) {
                 continue;
             }
-            jcapacity = ret + 1;
+            jcapacity += ret + 1;
         }
     }
 
@@ -110,6 +110,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
                     continue;
                 }
                 v = vbuf;
+                break;
             }
             case TConfig::Bool:
                 v = config->getBool() ? "true" : "false";
diff --git a/tests/Configuration.cpp b/tests/Configuration.cpp
new file mode 100644
index 00000000..bf2e2a71
--- /dev/null
+++ b/tests/Configuration.cpp
@@ -0,0 +1,510 @@
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/ConfigurationContainer.h>
+#include <MicroOcpp/Core/ConfigurationContainerFlash.h>
+
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+
+using namespace MicroOcpp;
+
+#define GET_CONFIG_ALL "[2,\"test-msg\",\"GetConfiguration\",{}]"
+#define KNOWN_KEY "__ExistingKey"
+#define UNKOWN_KEY "__UnknownKey"
+#define GET_CONFIG_KNOWN_UNKOWN "[2,\"test-mst\",\"GetConfiguration\",{\"key\":[\"" KNOWN_KEY "\",\"" UNKOWN_KEY "\"]}]"
+
+TEST_CASE( "Configuration" ) {
+    printf("\nRun %s\n",  "Configuration");
+
+    //clean state
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
+    MOCPP_DBG_DEBUG("remove all");
+    FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+
+    LoopbackConnection loopback; //initialize Context with dummy socket
+
+    mocpp_set_timer(custom_timer_cb);
+
+    SECTION("Basic container operations"){
+        std::unique_ptr<ConfigurationContainer> container;
+
+        SECTION("Volatile storage") {
+            container = makeConfigurationContainerVolatile(CONFIGURATION_VOLATILE "/volatile1", true);
+        }
+
+        SECTION("Persistent storage") {
+            container = makeConfigurationContainerFlash(filesystem, MOCPP_FILENAME_PREFIX "persistent1.jsn", true);
+        }
+
+        //check emptyness
+        REQUIRE( container->getConfigurationCount() == 0 );
+
+        //add first config, fetch by index
+        auto configFirst = container->createConfiguration(TConfig::Int, "cFirst");
+        REQUIRE( container->getConfigurationCount() == 1 );
+        REQUIRE( container->getConfiguration((size_t) 0) == configFirst.get());
+
+        //add one config of each type
+        auto cInt = container->createConfiguration(TConfig::Int, "cInt");
+        auto cBool = container->createConfiguration(TConfig::Bool, "cBool");
+        auto cString = container->createConfiguration(TConfig::String, "cString");
+        
+        REQUIRE( container->getConfigurationCount() == 4 );
+
+        //fetch config by key
+        REQUIRE( container->getConfiguration(cBool->getKey()) == cBool);
+
+        //remove config
+        container->removeConfiguration(cBool.get());
+        REQUIRE( container->getConfigurationCount() == 3 );
+        REQUIRE( container->getConfiguration(cBool->getKey()) == nullptr);
+
+        //clean container
+        container->removeConfiguration(container->getConfiguration((size_t) 0));
+        container->removeConfiguration(container->getConfiguration((size_t) 0));
+        container->removeConfiguration(container->getConfiguration((size_t) 0));
+        REQUIRE( container->getConfigurationCount() == 0 );
+    }
+
+    SECTION("Persistency on filesystem") {
+
+        auto container = makeConfigurationContainerFlash(filesystem, MOCPP_FILENAME_PREFIX "persistent1.jsn", true);
+
+        //trivial load call
+        REQUIRE( container->load() );
+        REQUIRE( container->getConfigurationCount() == 0 );
+
+        //add config, store, load again
+        auto cString = container->createConfiguration(TConfig::String, "cString");
+        cString->setString("mValue");
+
+        REQUIRE( container->save() ); //store
+
+        container.reset(); //destroy
+
+        //...load again
+        auto container2 = makeConfigurationContainerFlash(filesystem, MOCPP_FILENAME_PREFIX "persistent1.jsn", true);
+        REQUIRE( container2->getConfigurationCount() == 0 );
+        REQUIRE( container2->load() );
+        REQUIRE( container2->getConfigurationCount() == 1 );
+
+        auto cString2 = container2->getConfiguration("cString");
+        REQUIRE( cString2 != nullptr );
+        REQUIRE( !strcmp(cString2->getString(), "mValue") );
+    }
+
+    SECTION("Configuration API") {
+
+        //declare configs
+        REQUIRE( configuration_init(filesystem) );
+        auto cInt = declareConfiguration<int>("cInt", 42);
+        REQUIRE( cInt != nullptr );
+        declareConfiguration<bool>("cBool", true);
+        declareConfiguration<const char*>("cString", "mValue");
+
+        //fetch config
+        REQUIRE( getConfigurationPublic("cInt")->getInt() == 42 );
+
+        //store, destroy, reload
+        REQUIRE( configuration_save() );
+        cInt.reset();
+        configuration_deinit();
+        REQUIRE( getConfigurationPublic("cInt") == nullptr);
+
+        REQUIRE( configuration_init(filesystem) ); //reload
+
+        //fetch configs (declare with different factory default - should remain at original value)
+        auto cInt2 = declareConfiguration<int>("cInt", -1);
+        auto cBool2 = declareConfiguration<bool>("cBool", false);
+        auto cString2 = declareConfiguration<const char*>("cString", "no effect");
+        REQUIRE( configuration_load() ); //load config objects with stored values
+
+        //check load result
+        REQUIRE( cInt2->getInt() == 42 );
+        REQUIRE( cBool2->getBool() == true );
+        REQUIRE( !strcmp(cString2->getString(), "mValue") );
+
+        //declare config twice
+        auto cInt3 = declareConfiguration<int>("cInt", -1);
+        REQUIRE( cInt3 == cInt2 );
+
+        //declare config twice but in different container
+        auto cInt4 = declareConfiguration<int>("cInt", -1, CONFIGURATION_VOLATILE);
+        REQUIRE( cInt4 == cInt2 );
+
+        //declare config twice but with conflicting type (will supersede old type because to simplify FW upgrades)
+        auto cNewType = declareConfiguration<const char*>("cInt", "mValue2");
+        REQUIRE( cNewType != cInt2 );
+        REQUIRE( !strcmp(cNewType->getString(), "mValue2") );
+        
+        //store, destroy, reload
+        REQUIRE( configuration_save() );
+        configuration_deinit();
+        REQUIRE( getConfigurationPublic("cInt") == nullptr);
+        REQUIRE( configuration_init(filesystem) ); //reload
+        auto cNewType2 = declareConfiguration<const char*>("cInt", "no effect");
+        REQUIRE( configuration_load() );
+        REQUIRE( !strcmp(cNewType2->getString(), "mValue2") );
+
+        //get config before declared (container needs to be declared already at this point)
+        auto cString3 = getConfigurationPublic("cString");
+        REQUIRE( !strcmp(cString3->getString(), "mValue") );
+        configuration_deinit();
+
+        //value needs to outlive container
+        configuration_init(filesystem);
+        auto cString4 = declareConfiguration<const char *>("cString2", "mValue3");
+        configuration_deinit();
+        REQUIRE( !strcmp(cString4->getString(), "mValue3") );
+
+        MOCPP_DBG_DEBUG("remove all");
+        FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+
+        //config accessibility / permissions
+        configuration_init(filesystem);
+        bool readonly = false;
+        bool rebootRequired = false;
+        bool isPublic = true;
+        auto cInt6 = declareConfiguration<int>("cInt", 42, CONFIGURATION_FN, readonly, rebootRequired, isPublic);
+        REQUIRE( !cInt6->isReadOnly() );
+        REQUIRE( !cInt6->isRebootRequired() );
+        REQUIRE( getConfigurationPublic("cInt") );
+
+        //revoke permissions
+        readonly = true;
+        rebootRequired = true;
+        declareConfiguration<int>("cInt", 42, CONFIGURATION_FN, readonly, rebootRequired, isPublic);
+        REQUIRE( cInt6->isReadOnly() );
+        REQUIRE( cInt6->isRebootRequired() );
+
+        //revoked permissions cannot be reverted
+        readonly = false;
+        rebootRequired = false;
+        auto cInt7 = declareConfiguration<int>("cInt", 42, CONFIGURATION_FN, readonly, rebootRequired, isPublic);
+        REQUIRE( cInt7->isReadOnly() );
+        REQUIRE( cInt7->isRebootRequired() );
+
+        //accessibility cannot be changed after first initialization
+        isPublic = false;
+        declareConfiguration<int>("cInt", 42, CONFIGURATION_FN, false, rebootRequired, isPublic);
+        declareConfiguration<int>("cInt2", 42, CONFIGURATION_FN, false, rebootRequired, isPublic);
+        REQUIRE( getConfigurationPublic("cInt") );
+        REQUIRE( getConfigurationPublic("cInt2") );
+
+        //create config in hidden container
+        isPublic = false;
+        auto cHidden = declareConfiguration<int>("cHidden", 42, MOCPP_FILENAME_PREFIX "hidden.jsn", false, false, isPublic);
+        REQUIRE( !getConfigurationPublic("cHidden") );
+        
+        //hidden container cannot be fetched
+        auto configsPublic = getConfigurationContainersPublic();
+        REQUIRE( configsPublic.size() == 1 );
+
+        configuration_deinit();
+    }
+
+    SECTION("ContainerFlash memory optimization") {
+
+        //key storage optimization: the static key provided by declareConfiguration is preferred. If
+        //no static key is available for the config (if the config is loaded from flash without being
+        //declared before), then a key on the heap is allocated. If the config is later allocated,
+        //the heap-key is replaced by the static key
+
+        const char *key_static = "cInt";
+
+        configuration_init(filesystem);
+        auto cInt = declareConfiguration<int>(key_static, 42);
+        configuration_save();
+        configuration_deinit();
+
+        configuration_init(filesystem);
+        declareConfiguration<int>("dummy", 23); //dummy config to declare CONFIGURATION_FN
+        configuration_load();
+        const char *key_heap = getConfigurationPublic(key_static)->getKey();
+        REQUIRE( key_heap != key_static );
+        
+        declareConfiguration<int>(key_static, 42); //replace heap key with static key here
+
+        const char *key_replaced = getConfigurationPublic(key_static)->getKey();
+        REQUIRE( key_replaced == key_static );
+
+        configuration_deinit();
+    }
+
+    SECTION("Main lib integration") {
+
+        //basic lifecycle
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        REQUIRE( getConfigurationPublic("ConnectionTimeOut") );
+        REQUIRE( !getConfigurationContainersPublic().empty() );
+        mocpp_deinitialize();
+        REQUIRE( !getConfigurationPublic("ConnectionTimeOut") );
+        REQUIRE( getConfigurationContainersPublic().empty() );
+
+        //modify standard config ConnectionTimeOut. This config is not modified by the main lib during normal initialization / deinitialization
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        auto config = getConfigurationPublic("ConnectionTimeOut");
+
+        config->setInt(1234); //update
+        configuration_save(); //write back
+
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        REQUIRE( getConfigurationPublic("ConnectionTimeOut")->getInt() == 1234 );
+
+        mocpp_deinitialize();
+    }
+
+    SECTION("GetConfiguration") {
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        loop();
+
+        declareConfiguration<int>(KNOWN_KEY, 1234, MOCPP_FILENAME_PREFIX "persistent1.jsn", false);
+
+        bool checkProcessed = false;
+
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "GetConfiguration",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    JsonArray configurationKey = payload["configurationKey"];
+
+                    bool foundCustomConfig = false;
+                    bool foundStandardConfig = false;
+                    for (JsonObject keyvalue : configurationKey) {
+                        MOCPP_DBG_DEBUG("key %s", keyvalue["key"] | "_Undefined");
+                        if (!strcmp(keyvalue["key"] | "_Undefined", KNOWN_KEY)) {
+                            foundCustomConfig = true;
+                            REQUIRE( (keyvalue["readonly"] | true) == false );
+                            REQUIRE( !strcmp(keyvalue["value"] | "_Undefined", "1234") );
+                        } else if (!strcmp(keyvalue["key"] | "_Undefined", "ConnectionTimeOut")) {
+                            foundStandardConfig = true;
+                        }
+                    }
+
+                    REQUIRE( foundCustomConfig );
+                    REQUIRE( foundStandardConfig );
+                }
+        )));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+
+        checkProcessed = false;
+
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "GetConfiguration",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    auto key = payload.createNestedArray("key");
+                    key.add(KNOWN_KEY);
+                    key.add(UNKOWN_KEY);
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    JsonArray configurationKey = payload["configurationKey"];
+
+                    bool foundCustomConfig = false;
+                    for (JsonObject keyvalue : configurationKey) {
+                        if (!strcmp(keyvalue["key"] | "_Undefined", KNOWN_KEY)) {
+                            foundCustomConfig = true;
+                            break;
+                        }
+                    }
+                    REQUIRE( foundCustomConfig );
+
+                    JsonArray unknownKey = payload["unknownKey"];
+
+                    bool foundUnkownKey = false;
+                    for (const char *key : unknownKey) {
+                        if (!strcmp(key, UNKOWN_KEY)) {
+                            foundUnkownKey = true;
+                        }
+                    }
+
+                    REQUIRE( foundUnkownKey );
+                }
+        )));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+
+        mocpp_deinitialize();
+    }
+
+    SECTION("ChangeConfiguration") {
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        loop();
+
+        declareConfiguration<int>(KNOWN_KEY, 0, MOCPP_FILENAME_PREFIX "persistent1.jsn", false);
+
+        //update existing config
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeConfiguration",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = KNOWN_KEY;
+                    payload["value"] = "1234";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE(checkProcessed);
+        REQUIRE( getConfigurationPublic(KNOWN_KEY)->getInt() == 1234 );
+
+        //try to update not existing key
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeConfiguration",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = UNKOWN_KEY;
+                    payload["value"] = "no effect";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "NotSupported") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        //try to update config with malformatted value
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeConfiguration",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = KNOWN_KEY;
+                    payload["value"] = "not convertible to int";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Rejected") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        //try to update config with value validation
+        //value is valid if it begins with 1
+        registerConfigurationValidator(KNOWN_KEY, [] (const char *v) {
+            return v[0] == '1';
+        });
+
+        //validation success
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeConfiguration",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = KNOWN_KEY;
+                    payload["value"] = "100234";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( getConfigurationPublic(KNOWN_KEY)->getInt() == 100234 );
+
+        //validation failure
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeConfiguration",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = KNOWN_KEY;
+                    payload["value"] = "4321";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Rejected") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( getConfigurationPublic(KNOWN_KEY)->getInt() == 100234 ); //keep old value
+
+        mocpp_deinitialize();
+    }
+
+    SECTION("Define factory defaults for standard configs") {
+
+        //set factory default for standard config ConnectionTimeOut
+        configuration_init(filesystem);
+        auto factoryConnectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 1234, MOCPP_FILENAME_PREFIX "factory.jsn");
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        auto connectionTimeout2 = declareConfiguration<int>("ConnectionTimeOut", 4321);
+        REQUIRE( connectionTimeout2->getInt() == 1234 );
+        REQUIRE( connectionTimeout2 == factoryConnectionTimeOut );
+
+        configuration_save();
+        mocpp_deinitialize();
+
+        //this time, factory default is not given (will lead to duplicates, should be considered in sanitization)
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        REQUIRE( getConfigurationPublic("ConnectionTimeOut")->getInt() != 1234 );
+        mocpp_deinitialize();
+
+        //provide factory default again
+        configuration_init(filesystem);
+        declareConfiguration<int>("ConnectionTimeOut", 4321, MOCPP_FILENAME_PREFIX "factory.jsn");
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        REQUIRE( getConfigurationPublic("ConnectionTimeOut")->getInt() == 1234 );
+        mocpp_deinitialize();
+
+    }
+
+}

From f146b219934b1a2cffc8d3b2956847926bc6fbd7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 23 Sep 2023 14:37:50 +0200
Subject: [PATCH 383/549] fix Arduino WebSocket integration

---
 src/MicroOcpp/Core/Connection.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/Connection.cpp b/src/MicroOcpp/Core/Connection.cpp
index daba4485..50a2e180 100644
--- a/src/MicroOcpp/Core/Connection.cpp
+++ b/src/MicroOcpp/Core/Connection.cpp
@@ -53,7 +53,7 @@ void WSClient::loop() {
 }
 
 bool WSClient::sendTXT(const char *msg, size_t length) {
-    return wsock->sendTXT(out.c_str(), out.length());
+    return wsock->sendTXT(msg, length);
 }
 
 void WSClient::setReceiveTXTcallback(ReceiveTXTcallback &callback) {

From 813839c04ad05b9d24c49d60b66a31b25c90a984 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 23 Sep 2023 14:47:19 +0200
Subject: [PATCH 384/549] fix enum TConfig scope

---
 src/MicroOcpp/Core/ConfigurationKeyValue.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index 6afdfb2f..f3757cf5 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -18,7 +18,7 @@ namespace MicroOcpp {
 
 using revision_t = uint16_t;
 
-enum TConfig : uint8_t {
+enum class TConfig : uint8_t {
     Int,
     Bool,
     String

From a7914de52d69a77931b476300b77559031678c20 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 23 Sep 2023 15:06:08 +0200
Subject: [PATCH 385/549] fix ESP-IDF integration

---
 src/MicroOcpp/Operations/GetConfiguration.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index a8089827..3b75f50f 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -47,7 +47,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
         for (auto& key : keys) {
             Configuration *res = nullptr;
             for (auto container : containers) {
-                if (res = container->getConfiguration(key.c_str()).get()) {
+                if ((res = container->getConfiguration(key.c_str()).get())) {
                     break;
                 }
             }

From 43757eefa754ebd2021cb801571eab490ac2083c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 23 Sep 2023 15:19:34 +0200
Subject: [PATCH 386/549] fix ESP-IDF workflow

---
 .github/workflows/esp-idf.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
index 50f34083..5d1da976 100644
--- a/.github/workflows/esp-idf.yml
+++ b/.github/workflows/esp-idf.yml
@@ -34,6 +34,7 @@ jobs:
       uses: actions/checkout@v3
       with:
         repository: matth-x/MicroOcppMongoose
+        ref: 642006f0629b715dce44a913a5c4b77f3f8953bb
         path: examples/ESP-IDF/components/MicroOcppMongoose
     - name: Checkout ArduinoJson
       uses: actions/checkout@v3

From 2b8177697cef77718f90368fe4cca36ffec5b3ca Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 23 Sep 2023 19:44:01 +0200
Subject: [PATCH 387/549] Update README.md

---
 README.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index baa58257..da7ab8cd 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,16 @@
-# <img src="https://user-images.githubusercontent.com/63792403/133922028-fefc8abb-fde9-460b-826f-09a458502d17.png" alt="Icon" height="24"> &nbsp; MicroOcpp (ArduinoOcpp)
+# <img src="https://github.com/matth-x/MicroOcpp/assets/63792403/1c49d1ad-7afc-48d3-a54e-9aef2d4886db" alt="Icon" height="24"> &nbsp; MicroOcpp
 
 [![Build Status]( https://github.com/matth-x/MicroOcpp/workflows/PlatformIO%20CI/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
 [![Unit tests]( https://github.com/matth-x/MicroOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
 [![codecov](https://codecov.io/github/matth-x/ArduinoOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/ArduinoOcpp)
 
-OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif, Arduino, NXP, STM and Linux and more.
+OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif, Arduino, NXP, STM, Linux and more.
 
 **Formerly ArduinoOcpp ([migration guide](https://matth-x.github.io/MicroOcpp/migration/))**: *the initial version of this library used the Arduino API but this dependency was dropped some time ago and the old name has become outdated. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
 
-Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.arduino-ocpp.com](https://www.arduino-ocpp.com)
+Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.micro-ocpp.com](https://www.micro-ocpp.com)
 
-:heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve) and [15+ commercial Central Systems](https://www.arduino-ocpp.com/#h.314525e8447cc93c_81)
+:heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve) and [15+ commercial Central Systems](https://www.micro-ocpp.com/#h.314525e8447cc93c_81)
 
 :heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
@@ -22,7 +22,7 @@ Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/mas
 
 (Beta) The Simulator is a demo & development tool for MicroOcpp which allows to quickly assess the compatibility with different OCPP backends. It simulates a full charging station, adds a GUI and a mocked hardware binding to MicroOcpp and runs in the browser (using WebAssembly): [Try it](https://demo.micro-ocpp.com/)
 
-[![Screenshot](https://github.com/agruenb/arduino-ocpp-dashboard/blob/master/docs/img/status_page.png)](https://demo.micro-ocpp.com/)
+<div align="center"><img src="https://github.com/matth-x/MicroOcpp/assets/63792403/27f2819b-41fd-41a7-88a8-9e673b8a88b8" alt="Screenshot" width="800em" href="https://demo.micro-ocpp.com/"></div>
 
 #### Usage
 
@@ -62,9 +62,9 @@ MicroOcpp is a good foundation for starting the OCPP 2.0.1 development:
 
 :hammer: Comes with development tools and a CI/CD specialized for OCPP
 
-:man_teacher: Academic background: started as a research project, evolved into enterprise software
+:man_teacher: Academic background: roots in a research project
 
-:closed_lock_with_key: Unit tests with valgrind, [AddressSanitizer](https://github.com/google/sanitizers/wiki/AddressSanitizer) and [UndefinedBehaviorSanitizer](https://clang.llvm.org/docs/UndefinedBehaviorSanitizer.html)
+:closed_lock_with_key: Unit tests with valgrind, AddressSanitizer and UndefinedBehaviorSanitizer
 
 :heart: Contributions are highly welcome. Open to building a team
 

From 763097b0789ed4184382346ca85890f0aed7fa94 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 23 Sep 2023 20:49:55 +0200
Subject: [PATCH 388/549] update reservation with atomic attributes

---
 .../Model/Reservation/Reservation.cpp         | 17 +++++----
 src/MicroOcpp/Model/Reservation/Reservation.h |  2 +-
 .../Model/Reservation/ReservationService.cpp  | 10 +++---
 .../Model/Reservation/ReservationService.h    |  2 +-
 src/MicroOcpp/Operations/ReserveNow.cpp       | 36 ++++++++++++-------
 5 files changed, 41 insertions(+), 26 deletions(-)

diff --git a/src/MicroOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
index efa5952b..8a18c464 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.cpp
+++ b/src/MicroOcpp/Model/Reservation/Reservation.cpp
@@ -109,13 +109,16 @@ const char *Reservation::getParentIdTag() {
     return parentIdTagString->getString();
 }
 
-void Reservation::update(JsonObject payload) {
-    connectorIdInt->setInt(payload["connectorId"] | -1);
-    expiryDate.setTime(payload["expiryDate"]);
-    expiryDateRawString->setString(payload["expiryDate"] | "");
-    idTagString->setString(payload["idTag"] | "");
-    reservationIdInt->setInt(payload["reservationId"] | -1);
-    parentIdTagString->setString(payload["parentIdTag"] | "");
+void Reservation::update(int reservationId, unsigned int connectorId, Timestamp expiryDate, const char *idTag, const char *parentIdTag) {
+    reservationIdInt->setInt(reservationId);
+    connectorIdInt->setInt((int) connectorId);
+    this->expiryDate = expiryDate;
+    char expiryDate_cstr [JSONDATE_LENGTH + 1];
+    if (this->expiryDate.toJsonString(expiryDate_cstr, JSONDATE_LENGTH + 1)) {
+        expiryDateRawString->setString(expiryDate_cstr);
+    }
+    idTagString->setString(idTag);
+    parentIdTagString->setString(parentIdTag);
 
     configuration_save();
 }
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.h b/src/MicroOcpp/Model/Reservation/Reservation.h
index 222c3adf..8bcb3922 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.h
+++ b/src/MicroOcpp/Model/Reservation/Reservation.h
@@ -55,7 +55,7 @@ class Reservation {
     int getReservationId();
     const char *getParentIdTag();
 
-    void update(JsonObject payload);
+    void update(int reservationId, unsigned int connectorId, Timestamp expiryDate, const char *idTag, const char *parentIdTag = nullptr);
     void clear();
 };
 
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index 63b34182..1882a321 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -178,15 +178,15 @@ Reservation *ReservationService::getReservationById(int reservationId) {
     return nullptr;
 }
 
-bool ReservationService::updateReservation(JsonObject payload) {
-    if (auto reservation = getReservationById(payload["reservationId"])) {
-        reservation->update(payload);
+bool ReservationService::updateReservation(int reservationId, unsigned int connectorId, Timestamp expiryDate, const char *idTag, const char *parentIdTag) {
+    if (auto reservation = getReservationById(reservationId)) {
+        reservation->update(reservationId, connectorId, expiryDate, idTag, parentIdTag);
         return true;
     }
 
 // Alternative condition: avoids that one idTag can make two reservations at a time. The specification doesn't
 // mention that double-reservations should be possible but it seems to mean it. 
-    if (auto reservation = getReservation(payload["connectorId"], nullptr, nullptr)) {
+    if (auto reservation = getReservation(connectorId, nullptr, nullptr)) {
 //                payload["idTag"],
 //                payload.containsKey("parentIdTag") ? payload["parentIdTag"] : nullptr)) {
 //    if (auto reservation = getReservation(payload["connectorId"].as<int>())) {
@@ -198,7 +198,7 @@ bool ReservationService::updateReservation(JsonObject payload) {
     //update free reservation slot
     for (auto& reservation : reservations) {
         if (!reservation->isActive()) {
-            reservation->update(payload);
+            reservation->update(reservationId, connectorId, expiryDate, idTag, parentIdTag);
             return true;
         }
     }
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.h b/src/MicroOcpp/Model/Reservation/ReservationService.h
index 40876e41..87a6a486 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.h
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.h
@@ -39,7 +39,7 @@ class ReservationService {
 
     Reservation *getReservationById(int reservationId);
 
-    bool updateReservation(JsonObject payload);
+    bool updateReservation(int reservationId, unsigned int connectorId, Timestamp expiryDate, const char *idTag, const char *parentIdTag = nullptr);
 };
 
 }
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index e3ef457d..9b256b3f 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -33,33 +33,45 @@ void ReserveNow::processReq(JsonObject payload) {
         return;
     }
 
-    Timestamp validateTimestamp;
-    if (!validateTimestamp.setTime(payload["expiryDate"])) {
+    int connectorId = payload["connectorId"] | -1;
+    if (connectorId < 0 || connectorId >= model.getNumConnectors()) {
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
+
+    Timestamp expiryDate;
+    if (!expiryDate.setTime(payload["expiryDate"])) {
         MOCPP_DBG_WARN("bad time format");
         errorCode = "PropertyConstraintViolation";
         return;
     }
 
-    unsigned int connectorId = payload["connectorId"];
+    const char *idTag = payload["idTag"] | "";
+    if (!*idTag) {
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
+
+    const char *parentIdTag = nullptr;
+    if (payload.containsKey("parentIdTag")) {
+        parentIdTag = payload["parentIdTag"];
+    }
+
+    int reservationId = payload["reservationId"] | -1;
 
     if (model.getReservationService() &&
                 model.getNumConnectors() > 0) {
         auto rService = model.getReservationService();
         auto chargePoint = model.getConnector(0);
 
-        if (connectorId >= model.getNumConnectors()) {
-            errorCode = "PropertyConstraintViolation";
-            return;
-        }
-
         auto reserveConnectorZeroSupportedBool = declareConfiguration<bool>("ReserveConnectorZeroSupported", true, CONFIGURATION_VOLATILE);
         if (connectorId == 0 && (!reserveConnectorZeroSupportedBool || !reserveConnectorZeroSupportedBool->getBool())) {
             reservationStatus = "Rejected";
             return;
         }
 
-        if (auto reservation = rService->getReservationById(payload["reservationId"])) {
-            reservation->update(payload);
+        if (auto reservation = rService->getReservationById(reservationId)) {
+            reservation->update(reservationId, (unsigned int) connectorId, expiryDate, idTag, parentIdTag);
             reservationStatus = "Accepted";
             return;
         }
@@ -67,7 +79,7 @@ void ReserveNow::processReq(JsonObject payload) {
         Connector *connector = nullptr;
         
         if (connectorId > 0) {
-            connector = model.getConnector(connectorId);
+            connector = model.getConnector((unsigned int) connectorId);
         }
 
         if (chargePoint->getStatus() == ChargePointStatus::Faulted ||
@@ -87,7 +99,7 @@ void ReserveNow::processReq(JsonObject payload) {
             return;
         }
 
-        if (rService->updateReservation(payload)) {
+        if (rService->updateReservation(reservationId, (unsigned int) connectorId, expiryDate, idTag, parentIdTag)) {
             reservationStatus = "Accepted";
         } else {
             reservationStatus = "Occupied";

From 04c32583b0fb37dc9dae004cc50c2b684d8ad827 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 23 Sep 2023 21:39:58 +0200
Subject: [PATCH 389/549] fix beginTx clears Reservation (addresses #191)

---
 CMakeLists.txt                                |  1 +
 .../Model/Reservation/ReservationService.cpp  |  2 +-
 tests/Reservation.cpp                         | 71 +++++++++++++++++++
 3 files changed, 73 insertions(+), 1 deletion(-)
 create mode 100644 tests/Reservation.cpp

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 86150458..ac3ecb15 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -125,6 +125,7 @@ set(MOCPP_SRC_UNIT
     tests/Api.cpp
     tests/Metering.cpp
     tests/Configuration.cpp
+    tests/Reservation.cpp
 )
 
 add_executable(mo_unit_tests
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index 1882a321..9d7800af 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -48,7 +48,7 @@ void ReservationService::loop() {
             }
 
             //check if other tx started at this connector (e.g. due to RemoteStartTransaction)
-            if (connector->getTransaction() && connector->getTransaction()->isActive()) {
+            if (connector->getTransaction() && connector->getTransaction()->isAuthorized()) {
                 reservation->clear();
                 continue;
             }
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
new file mode 100644
index 00000000..95d23f0f
--- /dev/null
+++ b/tests/Reservation.cpp
@@ -0,0 +1,71 @@
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Model/Reservation/ReservationService.h>
+
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
+using namespace MicroOcpp;
+
+TEST_CASE( "Reservation" ) {
+    printf("\nRun %s\n",  "Reservation");
+
+    //clean state
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
+    FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+
+    mocpp_set_timer(custom_timer_cb);
+
+    SECTION("Basic reservation") {
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        auto& model = getOcppContext()->getModel();
+        model.getClock().setTime(BASE_TIME);
+
+        loop();
+
+        auto connector = model.getConnector(1);
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        auto rService = model.getReservationService();
+        REQUIRE( rService );
+
+        //set reservation
+        int reservationId = 1;
+        unsigned int connectorId = 1;
+        Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
+        const char *idTag = "mIdTag";
+        const char *parentIdTag = nullptr;
+
+        rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
+        
+        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+
+        //transaction blocked by reservation
+        bool checkTxRejected = false;
+        setTxNotificationOutput([&checkTxRejected] (Transaction*, TxNotification txNotification) {
+            if (txNotification == TxNotification::ReservationConflict) {
+                checkTxRejected = true;
+            }
+        });
+
+        beginTransaction("wrong idTag");
+        loop();
+        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( checkTxRejected );
+
+        mocpp_deinitialize();
+    }
+}

From 3728edce2fa4a8de25ccefa5390a46925aa646d1 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 24 Sep 2023 14:51:25 +0200
Subject: [PATCH 390/549] fix reservationId in StartTx (addresses #154)

---
 .../Model/ConnectorBase/Connector.cpp         | 158 +++++++++++-------
 .../Model/Reservation/ReservationService.cpp  |   4 +-
 tests/Reservation.cpp                         |  13 +-
 3 files changed, 108 insertions(+), 67 deletions(-)

diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index f9d6d91e..ba2933e0 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -524,47 +524,62 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         return nullptr;
     }
 
-    auto rService = model.getReservationService();
+    MOCPP_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
+    
     AuthorizationData *localAuth = nullptr;
-    bool expiredLocalAuth = false;
+    bool offlineBlockedAuth = false; //if offline authorization will be blocked by local auth list entry
 
     //check local OCPP whitelist
-    if (auto authService = model.getAuthorizationService()) {
+    if (model.getAuthorizationService()) {
+        localAuth = model.getAuthorizationService()->getLocalAuthorization(idTag);
         
-        localAuth = authService->getLocalAuthorization(idTag);
-
-        //check if blocked by reservation
-        Reservation *reservation = nullptr;
-        if (localAuth && rService) {
-            reservation = rService->getReservation(
-                        connectorId,
-                        idTag,
-                        localAuth->getParentIdTag() ? localAuth->getParentIdTag() : nullptr);
-            if (reservation && !reservation->matches(
-                        idTag,
-                        localAuth->getParentIdTag() ? localAuth->getParentIdTag() : nullptr)) {
-                //reservation found for connector but does not match idTag or parentIdTag
-                MOCPP_DBG_DEBUG("reservation blocks local auth at connector %u", connectorId);
-                localAuth = nullptr;;
-            }
-        }
-
+        //check authorization status
         if (localAuth && localAuth->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
             MOCPP_DBG_DEBUG("local auth denied (%s)", idTag);
+            offlineBlockedAuth = true;
             localAuth = nullptr;
         }
 
         //check expiry
-        if (localAuth && localAuth->getExpiryDate()) {
-            auto& tnow = model.getClock().now();
-            if (tnow >= *localAuth->getExpiryDate()) {
-                MOCPP_DBG_DEBUG("idTag %s local auth entry expired", idTag);
+        if (localAuth && localAuth->getExpiryDate() && *localAuth->getExpiryDate() < model.getClock().now()) {
+            MOCPP_DBG_DEBUG("idTag %s local auth entry expired", idTag);
+            offlineBlockedAuth = true;
+            localAuth = nullptr;
+        }
+    }
+
+    Reservation *reservation = nullptr;
+    bool offlineBlockedResv = false; //if offline authorization will be blocked by reservation
+
+    //check if blocked by reservation
+    if (model.getReservationService()) {
+        const char *parentIdTag = localAuth ? localAuth->getParentIdTag() : nullptr;
+
+        reservation = model.getReservationService()->getReservation(
+                connectorId,
+                idTag,
+                parentIdTag);
+
+        if (reservation && !reservation->matches(
+                    idTag,
+                    parentIdTag)) {
+            //reservation blocks connector
+            offlineBlockedResv = true; //when offline, tx is always blocked
+
+            //if parentIdTag is known, abort this tx immediately, otherwise wait for Authorize.conf to decide
+            if (parentIdTag) {
+                //parentIdTag known
+                MOCPP_DBG_INFO("connector %u reserved - abort transaction", connectorId);
+                updateTxNotification(TxNotification::ReservationConflict);
+                return nullptr;
+            } else {
+                //parentIdTag unkown but local authorization failed in any case
+                MOCPP_DBG_INFO("connector %u reserved - no local auth", connectorId);
                 localAuth = nullptr;
-                expiredLocalAuth = true;
             }
         }
     }
-
+    
     transaction = allocateTransaction();
 
     if (!transaction) {
@@ -581,17 +596,16 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     transaction->setBeginTimestamp(model.getClock().now());
 
-    MOCPP_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
-
     //check for local preauthorization
-    if (localPreAuthorizeBool && localPreAuthorizeBool->getBool()) {
-        if (localAuth && localAuth->getAuthorizationStatus() == AuthorizationStatus::Accepted) {
-            MOCPP_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
-
-            transaction->setAuthorized();
+    if (localAuth && localPreAuthorizeBool && localPreAuthorizeBool->getBool()) {
+        MOCPP_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
 
-            updateTxNotification(TxNotification::Authorized);
+        if (reservation) {
+            transaction->setReservationId(reservation->getReservationId());
         }
+        transaction->setAuthorized();
+
+        updateTxNotification(TxNotification::Authorized);
     }
 
     transaction->commit();
@@ -616,15 +630,21 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                         connectorId,
                         tx->getIdTag(),
                         idTagInfo["parentIdTag"] | (const char*) nullptr);
-            if (reservation && !reservation->matches(
-                        tx->getIdTag(),
-                        idTagInfo["parentIdTag"] | (const char*) nullptr)) {
-                //reservation found for connector but does not match idTag or parentIdTag
-                MOCPP_DBG_INFO("connector %u reserved - abort transaction", connectorId);
-                tx->setInactive();
-                tx->commit();
-                updateTxNotification(TxNotification::ReservationConflict);
-                return;
+            if (reservation) {
+                //reservation found for connector
+                if (reservation->matches(
+                            tx->getIdTag(),
+                            idTagInfo["parentIdTag"] | (const char*) nullptr)) {
+                    MOCPP_DBG_INFO("connector %u matches reservationId %i", connectorId, reservation->getReservationId());
+                    tx->setReservationId(reservation->getReservationId());
+                } else {
+                    //reservation found for connector but does not match idTag or parentIdTag
+                    MOCPP_DBG_INFO("connector %u reserved - abort transaction", connectorId);
+                    tx->setInactive();
+                    tx->commit();
+                    updateTxNotification(TxNotification::ReservationConflict);
+                    return;
+                }
             }
         }
 
@@ -634,9 +654,19 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         updateTxNotification(TxNotification::Authorized);
     });
-    authorize->setOnTimeoutListener([this, tx, localAuth, expiredLocalAuth] () {
 
-        if (expiredLocalAuth) {
+    //capture local auth and reservation check in for timeout handler
+    bool localAuthFound = localAuth;
+    bool reservationFound = reservation;
+    int reservationId = reservation ? reservation->getReservationId() : -1;
+    authorize->setOnTimeoutListener([this, tx,
+                offlineBlockedAuth, 
+                offlineBlockedResv, 
+                localAuthFound,
+                reservationFound,
+                reservationId] () {
+
+        if (offlineBlockedAuth) {
             //local auth entry exists, but is expired -> avoid offline tx
             MOCPP_DBG_DEBUG("Abort transaction process (%s), timeout, expired local auth", tx->getIdTag());
             tx->setInactive();
@@ -644,9 +674,21 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             updateTxNotification(TxNotification::AuthorizationTimeout);
             return;
         }
-        
-        if (localAuth) {
+
+        if (offlineBlockedResv) {
+            //reservation found for connector but does not match idTag or parentIdTag
+            MOCPP_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
+            tx->setInactive();
+            tx->commit();
+            updateTxNotification(TxNotification::ReservationConflict);
+            return;
+        }
+
+        if (localAuthFound) {
             MOCPP_DBG_DEBUG("Offline transaction process (%s), locally authorized", tx->getIdTag());
+            if (reservationFound) {
+                tx->setReservationId(reservationId);
+            }
             tx->setAuthorized();
             tx->commit();
 
@@ -654,29 +696,17 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             return;
         }
 
-        if (model.getReservationService()) {
-            auto reservation = model.getReservationService()->getReservation(
-                        connectorId,
-                        tx->getIdTag());
-            if (reservation && !reservation->matches(
-                        tx->getIdTag())) {
-                //reservation found for connector but does not match idTag or parentIdTag
-                MOCPP_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
-                tx->setInactive();
-                tx->commit();
-                updateTxNotification(TxNotification::ReservationConflict);
-                return;
-            }
-        }
-
         if (allowOfflineTxForUnknownIdBool && allowOfflineTxForUnknownIdBool->getBool()) {
             MOCPP_DBG_DEBUG("Offline transaction process (%s), allow unknown ID", tx->getIdTag());
+            if (reservationFound) {
+                tx->setReservationId(reservationId);
+            }
             tx->setAuthorized();
             tx->commit();
             updateTxNotification(TxNotification::Authorized);
             return;
         }
-        
+
         MOCPP_DBG_DEBUG("Abort transaction process (%s): timeout", tx->getIdTag());
         tx->setInactive();
         tx->commit();
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index 9d7800af..fe906e52 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -57,11 +57,11 @@ void ReservationService::loop() {
         //check if tx with same idTag or reservationId has started
         for (unsigned int cId = 1; cId < context.getModel().getNumConnectors(); cId++) {
             auto& transaction = context.getModel().getConnector(cId)->getTransaction();
-            if (transaction) {
+            if (transaction && transaction->isAuthorized()) {
                 const char *cIdTag = transaction->getIdTag();
                 if (transaction->getReservationId() == reservation->getReservationId() || 
                         (cIdTag && !strcmp(cIdTag, reservation->getIdTag()))) {
-                    
+
                     reservation->clear();
                     break;
                 }
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index 95d23f0f..3064e15c 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -43,7 +43,7 @@ TEST_CASE( "Reservation" ) {
         REQUIRE( rService );
 
         //set reservation
-        int reservationId = 1;
+        int reservationId = 123;
         unsigned int connectorId = 1;
         Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
         const char *idTag = "mIdTag";
@@ -66,6 +66,17 @@ TEST_CASE( "Reservation" ) {
         REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
         REQUIRE( checkTxRejected );
 
+        //idTag matches reservation
+        beginTransaction("mIdTag");
+        loop();
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getTransaction()->getReservationId() == reservationId );
+
+        //reservation is reset after tx
+        endTransaction();
+        loop();
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
         mocpp_deinitialize();
     }
 }

From c7ab7e2c502465a9995f41a25e95a9780d213939 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 24 Sep 2023 17:58:37 +0200
Subject: [PATCH 391/549] further Reservation tests and fixes

---
 .../Model/Reservation/Reservation.cpp         |  11 +-
 src/MicroOcpp/Model/Reservation/Reservation.h |   6 +-
 .../Model/Reservation/ReservationService.cpp  |   6 +-
 tests/Configuration.cpp                       |   2 -
 tests/Reservation.cpp                         | 384 +++++++++++++++++-
 5 files changed, 390 insertions(+), 19 deletions(-)

diff --git a/src/MicroOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
index 8a18c464..62af789f 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.cpp
+++ b/src/MicroOcpp/Model/Reservation/Reservation.cpp
@@ -6,10 +6,6 @@
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Debug.h>
 
-#ifndef RESERVATION_FN
-#define RESERVATION_FN (MOCPP_FILENAME_PREFIX "reservations.jsn")
-#endif
-
 using namespace MicroOcpp;
 
 Reservation::Reservation(Model& model, unsigned int slot) : model(model), slot(slot) {
@@ -19,7 +15,6 @@ Reservation::Reservation(Model& model, unsigned int slot) : model(model), slot(s
 
     snprintf(expiryDateRawKey, sizeof(expiryDateRawKey), MOCPP_RESERVATION_EXPDATE_KEY "%u", slot);
     expiryDateRawString = declareConfiguration<const char*>(expiryDateRawKey, "", RESERVATION_FN, false, false, false);
-    expiryDate.setTime(expiryDateRawString->getString());
     
     snprintf(idTagKey, sizeof(idTagKey), MOCPP_RESERVATION_IDTAG_KEY "%u", slot);
     idTagString = declareConfiguration<const char*>(idTagKey, "", RESERVATION_FN, false, false, false);
@@ -60,8 +55,7 @@ bool Reservation::isActive() {
         return false;
     }
 
-    auto& t_now = model.getClock().now();
-    if (t_now > expiryDate) {
+    if (model.getClock().now() > getExpiryDate()) {
         //reservation expired
         return false;
     }
@@ -94,6 +88,9 @@ int Reservation::getConnectorId() {
 }
 
 Timestamp& Reservation::getExpiryDate() {
+    if (expiryDate == MIN_TIME && *expiryDateRawString->getString()) {
+        expiryDate.setTime(expiryDateRawString->getString());
+    }
     return expiryDate;
 }
 
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.h b/src/MicroOcpp/Model/Reservation/Reservation.h
index 8bcb3922..11f9a851 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.h
+++ b/src/MicroOcpp/Model/Reservation/Reservation.h
@@ -8,6 +8,10 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/Time.h>
 
+#ifndef RESERVATION_FN
+#define RESERVATION_FN (MOCPP_FILENAME_PREFIX "reservations.jsn")
+#endif
+
 #define MOCPP_RESERVATION_CID_KEY "cid_"
 #define MOCPP_RESERVATION_EXPDATE_KEY "expdt_"
 #define MOCPP_RESERVATION_IDTAG_KEY "idt_"
@@ -28,7 +32,7 @@ class Reservation {
     std::shared_ptr<Configuration> expiryDateRawString;
     char expiryDateRawKey [sizeof(MOCPP_RESERVATION_EXPDATE_KEY "xxx") + 1];
 
-    Timestamp expiryDate;
+    Timestamp expiryDate = MIN_TIME;
     std::shared_ptr<Configuration> idTagString;
     char idTagKey [sizeof(MOCPP_RESERVATION_IDTAG_KEY "xxx") + 1];
     std::shared_ptr<Configuration> reservationIdInt;
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index fe906e52..1c58ac09 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -18,7 +18,7 @@ ReservationService::ReservationService(Context& context, unsigned int numConnect
     if (maxReservations > 0) {
         reservations.reserve((size_t) maxReservations);
         for (int i = 0; i < maxReservations; i++) {
-            reservations.push_back(std::unique_ptr<Reservation>(new Reservation(context.getModel(), i)));
+            reservations.emplace_back(new Reservation(context.getModel(), i));
         }
     }
 
@@ -180,6 +180,10 @@ Reservation *ReservationService::getReservationById(int reservationId) {
 
 bool ReservationService::updateReservation(int reservationId, unsigned int connectorId, Timestamp expiryDate, const char *idTag, const char *parentIdTag) {
     if (auto reservation = getReservationById(reservationId)) {
+        if (getReservation(connectorId) && getReservation(connectorId) != reservation && getReservation(connectorId)->isActive()) {
+            MOCPP_DBG_DEBUG("found blocking reservation at connectorId %u", connectorId);
+            return false; //cannot transfer reservation to other connector with existing reservation
+        }
         reservation->update(reservationId, connectorId, expiryDate, idTag, parentIdTag);
         return true;
     }
diff --git a/tests/Configuration.cpp b/tests/Configuration.cpp
index bf2e2a71..a392b472 100644
--- a/tests/Configuration.cpp
+++ b/tests/Configuration.cpp
@@ -25,7 +25,6 @@ TEST_CASE( "Configuration" ) {
 
     //clean state
     auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
-    MOCPP_DBG_DEBUG("remove all");
     FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
 
     LoopbackConnection loopback; //initialize Context with dummy socket
@@ -164,7 +163,6 @@ TEST_CASE( "Configuration" ) {
         configuration_deinit();
         REQUIRE( !strcmp(cString4->getString(), "mValue3") );
 
-        MOCPP_DBG_DEBUG("remove all");
         FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
 
         //config accessibility / permissions
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index 3064e15c..fb698639 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -29,17 +29,16 @@ TEST_CASE( "Reservation" ) {
 
     mocpp_set_timer(custom_timer_cb);
 
-    SECTION("Basic reservation") {
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
-        auto& model = getOcppContext()->getModel();
-        model.getClock().setTime(BASE_TIME);
+    mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+    auto& model = getOcppContext()->getModel();
+    auto rService = model.getReservationService();
+    auto connector = model.getConnector(1);
+    model.getClock().setTime(BASE_TIME);
 
-        loop();
+    loop();
 
-        auto connector = model.getConnector(1);
+    SECTION("Basic reservation") {
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
-
-        auto rService = model.getReservationService();
         REQUIRE( rService );
 
         //set reservation
@@ -77,6 +76,375 @@ TEST_CASE( "Reservation" ) {
         loop();
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
+        //RemoteStartTx - idTag doesn't match. The tx will start anyway assuming some start trigger in the backend prevails over reservations in the backend implementation
+        rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
+        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "RemoteStartTransaction",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTag"] = "wrong idTag";
+                    return doc;},
+                [] (JsonObject) { } //ignore conf
+        )));
+        loop();
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getTransaction()->getReservationId() != reservationId );
+
+        //reservation is reset after tx
+        endTransaction();
+        loop();
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //RemoteStartTx - idTag does match
+        rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
+        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "RemoteStartTransaction",
+                [idTag] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTag"] = idTag;
+                    return doc;},
+                [] (JsonObject) { } //ignore conf
+        )));
+        loop();
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getTransaction()->getReservationId() == reservationId );
+
+        //reservation is reset after tx
+        endTransaction();
+        loop();
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+    }
+
+    SECTION("Tx on other connector") {
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //set reservation
+        int reservationId = 123;
+        unsigned int connectorIdResvd = 1; //reserve connector 1
+        unsigned int connectorIdOther = 2; //start charging on other connector
+        Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
+        const char *idTag = "mIdTag";
+        const char *parentIdTag = nullptr;
+
+        rService->updateReservation(reservationId, connectorIdResvd, expiryDate, idTag, parentIdTag);
+        REQUIRE( model.getConnector(connectorIdResvd)->getStatus() == ChargePointStatus::Reserved );
+
+        beginTransaction(idTag, connectorIdOther);
+        loop();
+        REQUIRE( model.getConnector(connectorIdResvd)->getStatus() == ChargePointStatus::Available ); //reservation on first connector withdrawed
+        REQUIRE( model.getConnector(connectorIdOther)->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( getTransaction(connectorIdOther)->getReservationId() == reservationId ); //reservation transferred to other connector
+
+        endTransaction(nullptr, nullptr, connectorIdOther);
+        loop();
+        REQUIRE( model.getConnector(connectorIdOther)->getStatus() == ChargePointStatus::Available );
+    }
+
+    SECTION("parentIdTag") {
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //set reservation
+        int reservationId = 123;
+        unsigned int connectorId = 1;
+        Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
+        const char *idTag = "mIdTag";
+        const char *parentIdTag = "mParentIdTag";
+        
+        rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
+        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+
+        bool checkProcessed = false;
+        getOcppContext()->getOperationRegistry().registerOperation("Authorize",
+            [parentIdTag, &checkProcessed] () {
+                return new Ocpp16::CustomOperation("Authorize",
+                    [] (JsonObject) {}, //ignore req payload
+                    [parentIdTag, &checkProcessed] () {
+                        //create conf
+                        checkProcessed = true;
+                        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                                JSON_OBJECT_SIZE(1) + //payload root
+                                JSON_OBJECT_SIZE(3))); //idTagInfo
+                        auto payload = doc->to<JsonObject>();
+                        payload["idTagInfo"]["parentIdTag"] = parentIdTag;
+                        payload["idTagInfo"]["status"] = "Accepted";
+                        return doc;});
+            });
+        beginTransaction("other idTag");
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getTransaction()->getReservationId() == reservationId );
+
+        //reset tx
+        endTransaction();
+        loop();
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+    }
+
+    SECTION("ConnectorZero") {
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //set reservation
+        Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
+        const char *idTag = "mIdTag";
+        const char *parentIdTag = nullptr;
+
+        //if connector 0 is reserved, accept at most one further reservation
+        REQUIRE( rService->updateReservation(1000, 0, expiryDate, idTag, parentIdTag) );
+        REQUIRE( rService->updateReservation(1001, 1, expiryDate, idTag, parentIdTag) );
+        REQUIRE( !rService->updateReservation(1002, 2, expiryDate, idTag, parentIdTag) );
+        REQUIRE( model.getConnector(2)->getStatus() == ChargePointStatus::Available );
+
+        //reset reservations
+        rService->getReservationById(1000)->clear();
+        rService->getReservationById(1001)->clear();
+        REQUIRE( model.getConnector(1)->getStatus() == ChargePointStatus::Available );
+
+        //if connector 0 is reserved, ensure that at least one physical connector remains available for the idTag of the reservation
+        REQUIRE( rService->updateReservation(1000, 0, expiryDate, idTag, parentIdTag) );
+
+        beginTransaction("other idTag", 1);
+        loop();
+        REQUIRE( model.getConnector(1)->getStatus() == ChargePointStatus::Charging );
+
+        bool checkTxRejected = false;
+        setTxNotificationOutput([&checkTxRejected] (Transaction*, TxNotification txNotification) {
+            if (txNotification == TxNotification::ReservationConflict) {
+                checkTxRejected = true;
+            }
+        }, 2);
+
+        beginTransaction("other idTag 2", 2);
+        loop();
+        REQUIRE( checkTxRejected );
+        REQUIRE( model.getConnector(2)->getStatus() == ChargePointStatus::Available );
+        
+
+        endTransaction(nullptr, nullptr, 1);
+        loop();
+    }
+
+    SECTION("Expiry date") {
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //set reservation
+        int reservationId = 123;
+        unsigned int connectorId = 1;
+        Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
+        const char *idTag = "mIdTag";
+        const char *parentIdTag = nullptr;
+
+        rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
+        
+        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+
+        Timestamp expired = expiryDate + 1;
+        char expired_cstr [JSONDATE_LENGTH + 1];
+        expired.toJsonString(expired_cstr, JSONDATE_LENGTH + 1);
+        model.getClock().setTime(expired_cstr);
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+    }
+
+    SECTION("Reservation persistency") {
+        unsigned int connectorId = 1;
+        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus::Available );
+
+        //set reservation
+        int reservationId = 123;
+        Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
+        const char *idTag = "mIdTag";
+        const char *parentIdTag = "mParentIdTag";
+
+        getOcppContext()->getModel().getReservationService()->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
+        
+        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus::Reserved );
+
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        getOcppContext()->getModel().getClock().setTime(BASE_TIME);
+        loop();
+
+        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus::Reserved );
+
+        auto reservation = getOcppContext()->getModel().getReservationService()->getReservationById(reservationId);
+        REQUIRE( reservation->getReservationId() == reservationId );
+        REQUIRE( reservation->getConnectorId() == connectorId );
+        REQUIRE( reservation->getExpiryDate() == expiryDate );
+        REQUIRE( !strcmp(reservation->getIdTag(), idTag) );
+        REQUIRE( !strcmp(reservation->getParentIdTag(), parentIdTag) );
+
+        reservation->clear();
+
         mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        getOcppContext()->getModel().getClock().setTime(BASE_TIME);
+        loop();
+
+        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus::Available );
+    }
+
+    SECTION("ReserveNow") {
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //set reservation
+        int reservationId = 123;
+        unsigned int connectorId = 1;
+        Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
+        const char *idTag = "mIdTag";
+        const char *parentIdTag = nullptr;
+
+        //simple reservation
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ReserveNow",
+                [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            JSON_OBJECT_SIZE(5) + 
+                            JSONDATE_LENGTH + 1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = connectorId;
+                    char expiryDate_cstr [JSONDATE_LENGTH + 1];
+                    expiryDate.toJsonString(expiryDate_cstr, JSONDATE_LENGTH + 1);
+                    payload["expiryDate"] = expiryDate_cstr;
+                    payload["idTag"] = idTag;
+                    payload["parentIdTag"] = parentIdTag;
+                    payload["reservationId"] = reservationId;
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+
+        model.getReservationService()->getReservationById(reservationId)->clear();
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //reserve while charger is in Faulted state
+        const char *errorCode = "OtherError";
+        addErrorCodeInput([&errorCode] () {return errorCode;});
+        REQUIRE( connector->getStatus() == ChargePointStatus::Faulted );
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ReserveNow",
+                [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            JSON_OBJECT_SIZE(5) + 
+                            JSONDATE_LENGTH + 1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = connectorId;
+                    char expiryDate_cstr [JSONDATE_LENGTH + 1];
+                    expiryDate.toJsonString(expiryDate_cstr, JSONDATE_LENGTH + 1);
+                    payload["expiryDate"] = expiryDate_cstr;
+                    payload["idTag"] = idTag;
+                    payload["parentIdTag"] = parentIdTag;
+                    payload["reservationId"] = reservationId;
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Faulted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( connector->getStatus() == ChargePointStatus::Faulted );
+
+        errorCode = nullptr; //reset error
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //reserve while connector is already occupied
+        setConnectorPluggedInput([] {return true;}); //plug EV
+        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ReserveNow",
+                [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            JSON_OBJECT_SIZE(5) + 
+                            JSONDATE_LENGTH + 1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = connectorId;
+                    char expiryDate_cstr [JSONDATE_LENGTH + 1];
+                    expiryDate.toJsonString(expiryDate_cstr, JSONDATE_LENGTH + 1);
+                    payload["expiryDate"] = expiryDate_cstr;
+                    payload["idTag"] = idTag;
+                    payload["parentIdTag"] = parentIdTag;
+                    payload["reservationId"] = reservationId;
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Occupied") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+
+        setConnectorPluggedInput(nullptr); //reset ConnectorPluggedInput
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //Rejected ReserveNow status not possible
+
+        //reserve while connector is inoperative
+        connector->setAvailabilityVolatile(false);
+        REQUIRE( connector->getStatus() == ChargePointStatus::Unavailable );
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ReserveNow",
+                [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            JSON_OBJECT_SIZE(5) + 
+                            JSONDATE_LENGTH + 1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = connectorId;
+                    char expiryDate_cstr [JSONDATE_LENGTH + 1];
+                    expiryDate.toJsonString(expiryDate_cstr, JSONDATE_LENGTH + 1);
+                    payload["expiryDate"] = expiryDate_cstr;
+                    payload["idTag"] = idTag;
+                    payload["parentIdTag"] = parentIdTag;
+                    payload["reservationId"] = reservationId;
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Unavailable") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( connector->getStatus() == ChargePointStatus::Unavailable );
+
+        connector->setAvailabilityVolatile(true); //revert Unavailable status
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
     }
+
+    mocpp_deinitialize();
 }

From ac566e1ee88e5f6fd1b75247606a9355a5b3efe8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 24 Sep 2023 18:12:29 +0200
Subject: [PATCH 392/549] add CancelReservation test

---
 tests/Reservation.cpp | 56 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index fb698639..cf113f03 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -446,5 +446,61 @@ TEST_CASE( "Reservation" ) {
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
     }
 
+    SECTION("CancelReservation") {
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //set reservation
+        int reservationId = 123;
+        unsigned int connectorId = 1;
+        Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
+        const char *idTag = "mIdTag";
+        const char *parentIdTag = nullptr;
+
+        rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
+        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+
+        //CancelReservation successfully
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "CancelReservation",
+                [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["reservationId"] = reservationId;
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        //CancelReservation while no reservation exists
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "CancelReservation",
+                [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["reservationId"] = reservationId;
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Rejected") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+    }
+
     mocpp_deinitialize();
 }

From d785b7f9657e3cfc7d22f5951808e38030f980d7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 27 Sep 2023 20:42:56 +0200
Subject: [PATCH 393/549] fix esp-idf SPIFFS integration

---
 examples/ESP-IDF/CMakeLists.txt          |  1 +
 examples/ESP-IDF/README.md               |  7 ++-----
 src/MicroOcpp/Core/FilesystemAdapter.cpp | 16 ++++++++++++++--
 3 files changed, 17 insertions(+), 7 deletions(-)

diff --git a/examples/ESP-IDF/CMakeLists.txt b/examples/ESP-IDF/CMakeLists.txt
index bc4961b6..bb1869c5 100644
--- a/examples/ESP-IDF/CMakeLists.txt
+++ b/examples/ESP-IDF/CMakeLists.txt
@@ -6,3 +6,4 @@ include($ENV{IDF_PATH}/tools/cmake/project.cmake)
 project(mo_example)
 
 idf_build_set_property(COMPILE_OPTIONS -DMOCPP_TRAFFIC_OUT APPEND)
+idf_build_set_property(COMPILE_OPTIONS -DMOCPP_FILENAME_PREFIX="/mo_store/" APPEND)
diff --git a/examples/ESP-IDF/README.md b/examples/ESP-IDF/README.md
index b735ce89..702e21ae 100644
--- a/examples/ESP-IDF/README.md
+++ b/examples/ESP-IDF/README.md
@@ -13,20 +13,17 @@ Please clone the following repositories into the respective components-directori
 - [Mongoose adapter for MicroOcpp](https://github.com/matth-x/MicroOcppMongoose) into `components/MicroOcppMongoose`
 - [ArduinoJson](https://github.com/bblanchon/ArduinoJson) into `components/ArduinoJson`
 
-Alternatively, ArduinoJson can go into into an include folder as it is a header-only library:
-
-- [ArduinoJson header file](https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h), renamed and moved to `include/ArduinoJson.h`. Any other location will work too as long as the header file `ArduinoJson.h` is on the include-path and can be found by the statement `#include <ArduinoJson.h>`
-
 For setup, the following commands could come handy (change to the root directory of the ESP-IDF project first):
 
 ```
 rm components/mongoose/.gitkeep
 rm components/MicroOcpp/.gitkeep
 rm components/MicroOcppMongoose/.gitkeep
+rm components/ArduinoJson/.gitkeep
 git clone https://github.com/matth-x/MicroOcpp components/MicroOcpp
 git clone --recurse-submodules https://github.com/cesanta/mongoose-esp-idf.git components/mongoose
 git clone https://github.com/matth-x/MicroOcppMongoose components/MicroOcppMongoose
-git clone https://github.com/bblanchon/ArduinoJson
+git clone https://github.com/bblanchon/ArduinoJson components/ArduinoJson
 ```
 
 The setup is done if the following include statements work:
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 580d23ee..30da85ff 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -6,6 +6,8 @@
 #include <MicroOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
 #include <MicroOcpp/Debug.h>
 
+#include <cstring>
+
 /*
  * Platform specific implementations. Currently supported:
  *     - Arduino LittleFs
@@ -341,9 +343,19 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
     if (config.mustMount()) {
         mounted = false;
-        
+
+        char fn_prefix [MOCPP_MAX_PATH_SIZE];
+        auto fn_prefix_len = snprintf(fn_prefix, MOCPP_MAX_PATH_SIZE, "%.*s", ((int) strlen(MOCPP_FILENAME_PREFIX)) - 1, MOCPP_FILENAME_PREFIX);
+        if (fn_prefix_len < 0 || fn_prefix_len >= MOCPP_MAX_PATH_SIZE) {
+            MOCPP_DBG_ERR("MOCPP_FILENAME_PREFIX error %i", fn_prefix_len);
+            return nullptr;
+        } else if (fn_prefix_len == 0) {
+            MOCPP_DBG_ERR("MOCPP_FILENAME_PREFIX cannot be root on ESP-IDF");
+            return nullptr;
+        }
+
         esp_vfs_spiffs_conf_t conf = {
-            .base_path = MOCPP_FILENAME_PREFIX,
+            .base_path = fn_prefix,
             .partition_label = "mo", //also see deconstructor
             .max_files = 5,
             .format_if_mount_failed = config.formatOnFail()

From 38f1e6bd629ccbae35ede7e134b794d7e8a170c3 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Thu, 28 Sep 2023 22:18:08 +0200
Subject: [PATCH 394/549] add benchmarks

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index da7ab8cd..8e2df168 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,23 @@ If you don't have an OCPP server at hand, leave the charge box ID blank and ente
 
 **RFID authentication**: Go to "Control Center" > "Connectors" > "Transaction" and update the idTag with the desired value.
 
+## Benchmarks
+
+*Full report: [MicroOcpp benchmark (esp-idf)](https://github.com/matth-x/MicroOcpp-benchmark)*
+
+The following measurements were taken on the ESP32 @ 160MHz and represent the optimistic best case scenario for a charger with two physical connectors (i.e. compiled with `-Os`, disabled debug output and logs).
+
+| Description | Value |
+| :--- | ---: |
+| Flash size (minimal) | 121,170 B |
+| Heap occupation (idle) | 12,308 B |
+| Heap occupation (peak) | 21,916 B |
+| Initailization | 21 ms |
+| `loop()` call (idle) | 0.05 ms |
+| Large message sent | 5 ms |
+
+In practical setups, the execution time is largely determined by IO delays and the heap occupation is significantly influenced by the configuration with reservation, local authorization and charging profile lists.
+
 ## Developers guide
 
 PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)

From b0f416c5c92a10df85c96a446f8dcf13fc550d06 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 1 Oct 2023 19:53:50 +0200
Subject: [PATCH 395/549] option to not clean aborted tx in tx journal

---
 src/MicroOcpp/Model/ConnectorBase/Connector.cpp | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index ba2933e0..0d2462e9 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -24,6 +24,10 @@
 
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 
+#ifndef MOCPP_TX_CLEAN_ABORTED
+#define MOCPP_TX_CLEAN_ABORTED 1
+#endif
+
 using namespace MicroOcpp;
 using namespace MicroOcpp::Ocpp16;
 
@@ -151,7 +155,7 @@ void Connector::loop() {
         trackLoopExecute = true;
     }
 
-    if (transaction && transaction->isAborted()) {
+    if (transaction && transaction->isAborted() && MOCPP_TX_CLEAN_ABORTED) {
         //If the transaction is aborted (invalidated before started), delete all artifacts from flash
         //This is an optimization. The memory management will attempt to remove those files again later
         bool removed = true;
@@ -171,6 +175,11 @@ void Connector::loop() {
         transaction = nullptr;
     }
 
+    if (transaction && transaction->isAborted()) {
+        MOCPP_DBG_DEBUG("collect aborted transaction %u-%u", connectorId, transaction->getTxNr());
+        transaction = nullptr;
+    }
+
     if (transaction && transaction->isCompleted()) {
         MOCPP_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
         transaction = nullptr;
@@ -430,7 +439,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
         
         auto tx = model.getTransactionStore()->getTransaction(connectorId, txr);
         //check if dangling silent tx, aborted tx, or corrupted entry (tx == null)
-        if (!tx || tx->isSilent() || tx->isAborted()) {
+        if (!tx || tx->isSilent() || (tx->isAborted() && MOCPP_TX_CLEAN_ABORTED)) {
             //yes, remove
             bool removed = true;
             if (auto mService = model.getMeteringService()) {
@@ -472,7 +481,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
 
             auto txhist = model.getTransactionStore()->getTransaction(connectorId, txl);
             //oldest entry, now check if it's history and can be removed or corrupted entry
-            if (!txhist || txhist->isCompleted()) {
+            if (!txhist || txhist->isCompleted() || txhist->isAborted()) {
                 //yes, remove
                 bool removed = true;
                 if (auto mService = model.getMeteringService()) {

From cce3d815e4519c3b2748d7d495272e37cdf96b40 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 2 Oct 2023 14:35:24 +0200
Subject: [PATCH 396/549] fix endTransaction params (fixes #202)

---
 examples/ESP/main.cpp              | 2 +-
 src/MicroOcpp/Operations/Reset.cpp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/ESP/main.cpp b/examples/ESP/main.cpp
index 1e47c7c7..198d39a6 100644
--- a/examples/ESP/main.cpp
+++ b/examples/ESP/main.cpp
@@ -129,7 +129,7 @@ void loop() {
                 //card matches -> user can stop Tx
                 Serial.println(F("[main] End transaction by RFID card"));
 
-                endTransaction();
+                endTransaction(idTag.c_str());
             } else {
                 Serial.println(F("[main] Cannot end transaction by RFID card (different card?)"));
             }
diff --git a/src/MicroOcpp/Operations/Reset.cpp b/src/MicroOcpp/Operations/Reset.cpp
index 3c3d78dc..208c7d1b 100644
--- a/src/MicroOcpp/Operations/Reset.cpp
+++ b/src/MicroOcpp/Operations/Reset.cpp
@@ -33,7 +33,7 @@ void Reset::processReq(JsonObject payload) {
                 resetAccepted = true;
                 rService->initiateReset(isHard);
                 for (unsigned int cId = 0; cId < model.getNumConnectors(); cId++) {
-                    model.getConnector(cId)->endTransaction(isHard ? "HardReset" : "SoftReset");
+                    model.getConnector(cId)->endTransaction(nullptr, isHard ? "HardReset" : "SoftReset");
                 }
             }
         }

From edd9ff60b5cf17c09c3561d86830be460b5ebcf9 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 8 Oct 2023 16:00:57 +0200
Subject: [PATCH 397/549] extend ConfigContainerVolatile with addConfig

---
 src/MicroOcpp/Core/ConfigurationContainer.cpp | 85 ++++++++++---------
 src/MicroOcpp/Core/ConfigurationContainer.h   | 21 ++++-
 2 files changed, 66 insertions(+), 40 deletions(-)

diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index cae0ccae..3a26879b 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -6,63 +6,70 @@
 
 #include <MicroOcpp/Debug.h>
 
-namespace MicroOcpp {
+using namespace MicroOcpp;
 
 ConfigurationContainer::~ConfigurationContainer() {
 
 }
 
-class ConfigurationContainerVolatile : public ConfigurationContainer {
-private:
-    std::vector<std::shared_ptr<Configuration>> configurations;
-public:
-    ConfigurationContainerVolatile(const char *filename, bool accessible) : ConfigurationContainer(filename, accessible) { }
+ConfigurationContainerVolatile::ConfigurationContainerVolatile(const char *filename, bool accessible) : ConfigurationContainer(filename, accessible) {
 
-    bool load() override {return true;}
+}
 
-    bool save() override {return true;}
+bool ConfigurationContainerVolatile::load() {
+    return true;
+}
 
-    std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) override {
-        std::shared_ptr<Configuration> res = makeConfiguration(type, key);
-        if (!res) {
-            //allocation failure - OOM
-            MOCPP_DBG_ERR("OOM");
-            return nullptr;
-        }
-        configurations.push_back(res);
-        return res;
+bool ConfigurationContainerVolatile::save() {
+    return true;
+}
+
+std::shared_ptr<Configuration> ConfigurationContainerVolatile::createConfiguration(TConfig type, const char *key) {
+    std::shared_ptr<Configuration> res = makeConfiguration(type, key);
+    if (!res) {
+        //allocation failure - OOM
+        MOCPP_DBG_ERR("OOM");
+        return nullptr;
     }
+    configurations.push_back(res);
+    return res;
+}
 
-    void removeConfiguration(Configuration *config) override {
-        for (auto entry = configurations.begin(); entry != configurations.end();) {
-            if (entry->get() == config) {
-                entry = configurations.erase(entry);
-            } else {
-                entry++;
-            }
+void ConfigurationContainerVolatile::removeConfiguration(Configuration *config) {
+    for (auto entry = configurations.begin(); entry != configurations.end();) {
+        if (entry->get() == config) {
+            entry = configurations.erase(entry);
+        } else {
+            entry++;
         }
     }
+}
 
-    size_t getConfigurationCount() override {
-        return configurations.size();
-    }
+size_t ConfigurationContainerVolatile::getConfigurationCount() {
+    return configurations.size();
+}
 
-    Configuration *getConfiguration(size_t i) override {
-        return configurations[i].get();
-    }
+Configuration *ConfigurationContainerVolatile::getConfiguration(size_t i) {
+    return configurations[i].get();
+}
 
-    std::shared_ptr<Configuration> getConfiguration(const char *key) override {
-        for (auto& entry : configurations) {
-            if (entry->getKey() && !strcmp(entry->getKey(), key)) {
-                return entry;
-            }
+std::shared_ptr<Configuration> ConfigurationContainerVolatile::getConfiguration(const char *key) {
+    for (auto& entry : configurations) {
+        if (entry->getKey() && !strcmp(entry->getKey(), key)) {
+            return entry;
         }
-        return nullptr;
     }
-};
+    return nullptr;
+}
+
+void ConfigurationContainerVolatile::addConfiguration(std::shared_ptr<Configuration> c) {
+    configurations.push_back(std::move(c));
+}
+
+namespace MicroOcpp {
 
-std::unique_ptr<ConfigurationContainer> makeConfigurationContainerVolatile(const char *filename, bool accessible) {
-    return std::unique_ptr<ConfigurationContainer>(new ConfigurationContainerVolatile(filename, accessible));
+std::unique_ptr<ConfigurationContainerVolatile> makeConfigurationContainerVolatile(const char *filename, bool accessible) {
+    return std::unique_ptr<ConfigurationContainerVolatile>(new ConfigurationContainerVolatile(filename, accessible));
 }
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index 9de8b499..f771fa64 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -37,7 +37,26 @@ class ConfigurationContainer {
     virtual void loadStaticKey(Configuration& config, const char *key) { } //possible optimization: can replace internal key with passed static key
 };
 
-std::unique_ptr<ConfigurationContainer> makeConfigurationContainerVolatile(const char *filename, bool accessible);
+class ConfigurationContainerVolatile : public ConfigurationContainer {
+private:
+    std::vector<std::shared_ptr<Configuration>> configurations;
+public:
+    ConfigurationContainerVolatile(const char *filename, bool accessible);
+
+    //ConfigurationContainer definitions
+    bool load() override;
+    bool save() override;
+    std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) override;
+    void removeConfiguration(Configuration *config) override;
+    size_t getConfigurationCount() override;
+    Configuration *getConfiguration(size_t i) override;
+    std::shared_ptr<Configuration> getConfiguration(const char *key) override;
+
+    //add custom Configuration object
+    void addConfiguration(std::shared_ptr<Configuration> c);
+};
+
+std::unique_ptr<ConfigurationContainerVolatile> makeConfigurationContainerVolatile(const char *filename, bool accessible);
 
 } //end namespace MicroOcpp
 

From d3f93a7eedd6bdaf49ed79f3dccb96fc6ba5a725 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 8 Oct 2023 18:03:25 +0200
Subject: [PATCH 398/549] fix unimplemented createConf can stall RPC queue

---
 src/MicroOcpp/Core/Operation.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/MicroOcpp/Core/Operation.cpp b/src/MicroOcpp/Core/Operation.cpp
index 6bac9bc0..b3ca3a14 100644
--- a/src/MicroOcpp/Core/Operation.cpp
+++ b/src/MicroOcpp/Core/Operation.cpp
@@ -27,7 +27,7 @@ bool Operation::restore(StoredOperationHandler *rpcData) {
 
 std::unique_ptr<DynamicJsonDocument> Operation::createReq() {
     MOCPP_DBG_ERR("Unsupported operation: createReq() is not implemented");
-    return nullptr;
+    return createEmptyDocument();
 }
 
 void Operation::processConf(JsonObject payload) {
@@ -40,7 +40,7 @@ void Operation::processReq(JsonObject payload) {
 
 std::unique_ptr<DynamicJsonDocument> Operation::createConf() {
     MOCPP_DBG_ERR("Unsupported operation: createConf() is not implemented");
-    return nullptr;
+    return createEmptyDocument();
 }
 
 std::unique_ptr<DynamicJsonDocument> MicroOcpp::createEmptyDocument() {

From e0bb7d4a5d7cb9a18d788f292f324704661d172d Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 8 Oct 2023 18:17:14 +0200
Subject: [PATCH 399/549] fix GetDiag double execution; cosmetic changes

---
 .../Model/Diagnostics/DiagnosticsService.cpp  | 12 +++--
 .../Model/Diagnostics/DiagnosticsService.h    |  8 +--
 src/MicroOcpp/Operations/GetDiagnostics.cpp   | 49 ++++++++-----------
 src/MicroOcpp/Operations/GetDiagnostics.h     | 20 +++-----
 4 files changed, 38 insertions(+), 51 deletions(-)

diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index e83c063f..7a83ffa8 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -16,8 +16,8 @@ using Ocpp16::DiagnosticsStatus;
 
 DiagnosticsService::DiagnosticsService(Context& context) : context(context) {
     
-    context.getOperationRegistry().registerOperation("GetDiagnostics", [&context] () {
-        return new Ocpp16::GetDiagnostics(context.getModel());});
+    context.getOperationRegistry().registerOperation("GetDiagnostics", [this] () {
+        return new Ocpp16::GetDiagnostics(*this);});
 
     //Register message handler for TriggerMessage operation
     context.getOperationRegistry().registerOperation("DiagnosticsStatusNotification", [this] () {
@@ -36,7 +36,7 @@ void DiagnosticsService::loop() {
         if (!uploadIssued) {
             if (onUpload != nullptr) {
                 MOCPP_DBG_DEBUG("Call onUpload");
-                onUpload(location, startTime, stopTime);
+                onUpload(location.c_str(), startTime, stopTime);
                 uploadIssued = true;
             } else {
                 MOCPP_DBG_ERR("onUpload must be set! (see setOnUpload). Will abort");
@@ -82,7 +82,7 @@ void DiagnosticsService::loop() {
 }
 
 //timestamps before year 2021 will be treated as "undefined"
-std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &location, int retries, unsigned int retryInterval, Timestamp startTime, Timestamp stopTime) {
+std::string DiagnosticsService::requestDiagnosticsUpload(const char *location, unsigned int retries, unsigned int retryInterval, Timestamp startTime, Timestamp stopTime) {
     if (onUpload == nullptr) //maybe add further plausibility checks
         return std::string{};
     
@@ -100,6 +100,7 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
         this->stopTime = newStop;
     }
     
+#if MOCPP_DBG_LEVEL >= MOCPP_DL_INFO
     char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
     char dbuf2 [JSONDATE_LENGTH + 1] = {'\0'};
     this->startTime.toJsonString(dbuf, JSONDATE_LENGTH + 1);
@@ -116,6 +117,7 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const std::string &loca
             this->retryInterval,
             dbuf,
             dbuf2);
+#endif
 
     nextTry = context.getModel().getClock().now();
     nextTry += 5; //wait for 5s before upload
@@ -168,7 +170,7 @@ void DiagnosticsService::setRefreshFilename(std::function<std::string()> refresh
     this->refreshFilename = refreshFn;
 }
 
-void DiagnosticsService::setOnUpload(std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload) {
+void DiagnosticsService::setOnUpload(std::function<bool(const char *location, Timestamp &startTime, Timestamp &stopTime)> onUpload) {
     this->onUpload = onUpload;
 }
 
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
index 4edb160e..99368d93 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -27,7 +27,7 @@ class DiagnosticsService {
     Context& context;
     
     std::string location;
-    int retries = 0;
+    unsigned int retries = 0;
     unsigned int retryInterval = 0;
     Timestamp startTime;
     Timestamp stopTime;
@@ -35,7 +35,7 @@ class DiagnosticsService {
     Timestamp nextTry;
 
     std::function<std::string()> refreshFilename;
-    std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload;
+    std::function<bool(const char *location, Timestamp &startTime, Timestamp &stopTime)> onUpload;
     std::function<UploadStatus()> uploadStatusInput;
     bool uploadIssued = false;
 
@@ -51,13 +51,13 @@ class DiagnosticsService {
     //timestamps before year 2021 will be treated as "undefined"
     //returns empty std::string if onUpload is missing or upload cannot be scheduled for another reason
     //returns fileName of diagnostics file to be uploaded if upload has been scheduled
-    std::string requestDiagnosticsUpload(const std::string &location, int retries = 1, unsigned int retryInterval = 0, Timestamp startTime = Timestamp(), Timestamp stopTime = Timestamp());
+    std::string requestDiagnosticsUpload(const char *location, unsigned int retries = 1, unsigned int retryInterval = 0, Timestamp startTime = Timestamp(), Timestamp stopTime = Timestamp());
 
     Ocpp16::DiagnosticsStatus getDiagnosticsStatus();
 
     void setRefreshFilename(std::function<std::string()> refreshFn); //refresh a new filename which will be used for the subsequent upload tries
 
-    void setOnUpload(std::function<bool(const std::string &location, Timestamp &startTime, Timestamp &stopTime)> onUpload);
+    void setOnUpload(std::function<bool(const char *location, Timestamp &startTime, Timestamp &stopTime)> onUpload);
 
     void setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput);
 };
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.cpp b/src/MicroOcpp/Operations/GetDiagnostics.cpp
index 3d317a7b..6e6d4fe2 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.cpp
+++ b/src/MicroOcpp/Operations/GetDiagnostics.cpp
@@ -9,57 +9,48 @@
 
 using MicroOcpp::Ocpp16::GetDiagnostics;
 
-GetDiagnostics::GetDiagnostics(Model& model) : model(model) {
+GetDiagnostics::GetDiagnostics(DiagnosticsService& diagService) : diagService(diagService) {
 
 }
 
 void GetDiagnostics::processReq(JsonObject payload) {
-    /*
-     * Process the application data here. Note: you have to implement the FW update procedure in your client code. You have to set
-     * a onSendConfListener in which you initiate a FW update (e.g. calling ESPhttpUpdate.update(...) )
-     */
 
-    const char *loc = payload["location"] | "";
-    location = loc;
+    const char *location = payload["location"] | "";
     //check location URL. Maybe introduce Same-Origin-Policy?
-    if (location.empty()) {
-        formatError = true;
-        MOCPP_DBG_WARN("Could not read location. Abort");
+    if (!*location) {
+        errorCode = "FormationViolation";
         return;
     }
     
-    retries = payload["retries"] | 1;
-    retryInterval = payload["retryInterval"] | 180;
+    int retries = payload["retries"] | 1;
+    int retryInterval = payload["retryInterval"] | 180;
+    if (retries < 0 || retryInterval < 0) {
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
 
-    //check the integrity of startTime
+    Timestamp startTime;
     if (payload.containsKey("startTime")) {
-        const char *startTimeRaw = payload["startTime"] | "Invalid";
-        if (!startTime.setTime(startTimeRaw)) {
-            formatError = true;
-            MOCPP_DBG_WARN("Could not read startTime. Abort");
+        if (!startTime.setTime(payload["startTime"] | "Invalid")) {
+            errorCode = "PropertyConstraintViolation";
+            MOCPP_DBG_WARN("bad time format");
             return;
         }
     }
 
-    //check the integrity of stopTime
+    Timestamp stopTime;
     if (payload.containsKey("startTime")) {
-        const char *stopTimeRaw = payload["stopTime"] | "Invalid";
-        if (!stopTime.setTime(stopTimeRaw)) {
-            formatError = true;
-            MOCPP_DBG_WARN("Could not read stopTime. Abort");
+        if (!stopTime.setTime(payload["stopTime"] | "Invalid")) {
+            errorCode = "PropertyConstraintViolation";
+            MOCPP_DBG_WARN("bad time format");
             return;
         }
     }
+
+    fileName = diagService.requestDiagnosticsUpload(location, (unsigned int) retries, (unsigned int) retryInterval, startTime, stopTime);
 }
 
 std::unique_ptr<DynamicJsonDocument> GetDiagnostics::createConf(){
-    if (auto diagService = model.getDiagnosticsService()) {
-        fileName = diagService->requestDiagnosticsUpload(location, retries, retryInterval, startTime, stopTime);
-    } else {
-        MOCPP_DBG_WARN("DiagnosticsService has not been initialized before! Please have a look at MicroOcpp.cpp for an example. Abort");
-        return createEmptyDocument();
-    }
-
     if (fileName.empty()) {
         return createEmptyDocument();
     } else {
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.h b/src/MicroOcpp/Operations/GetDiagnostics.h
index 0c5cd16d..22c14983 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.h
+++ b/src/MicroOcpp/Operations/GetDiagnostics.h
@@ -10,24 +10,18 @@
 
 namespace MicroOcpp {
 
-class Model;
+class DiagnosticsService;
 
 namespace Ocpp16 {
 
 class GetDiagnostics : public Operation {
 private:
-    Model& model;
-    std::string location {};
-    int retries = 1;
-    unsigned long retryInterval = 180;
-    Timestamp startTime = Timestamp();
-    Timestamp stopTime = Timestamp();
-
-    std::string fileName {};
-    
-    bool formatError = false;
+    DiagnosticsService& diagService;
+    std::string fileName;
+
+    const char *errorCode = nullptr;
 public:
-    GetDiagnostics(Model& model);
+    GetDiagnostics(DiagnosticsService& diagService);
 
     const char* getOperationType() override {return "GetDiagnostics";}
 
@@ -35,7 +29,7 @@ class GetDiagnostics : public Operation {
 
     std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-    const char *getErrorCode() override {return formatError ? "FormationViolation" : nullptr;}
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16

From 565f6d4b0f306ce642db5d0b23c9184f9b262a74 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 8 Oct 2023 19:02:17 +0200
Subject: [PATCH 400/549] fix UpdateFw double execution; cosmetic changes

---
 .../FirmwareManagement/FirmwareService.cpp    | 28 ++++++------
 .../FirmwareManagement/FirmwareService.h      | 16 +++----
 src/MicroOcpp/Operations/UpdateFirmware.cpp   | 43 +++++++++----------
 src/MicroOcpp/Operations/UpdateFirmware.h     | 15 +++----
 4 files changed, 50 insertions(+), 52 deletions(-)

diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 80ea675b..2c2519cc 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -27,8 +27,8 @@ using MicroOcpp::Ocpp16::FirmwareStatus;
 
 FirmwareService::FirmwareService(Context& context) : context(context) {
     
-    context.getOperationRegistry().registerOperation("UpdateFirmware", [&context] () {
-        return new Ocpp16::UpdateFirmware(context.getModel());});
+    context.getOperationRegistry().registerOperation("UpdateFirmware", [this] () {
+        return new Ocpp16::UpdateFirmware(*this);});
 
     //Register message handler for TriggerMessage operation
     context.getOperationRegistry().registerOperation("FirmwareStatusNotification", [this] () {
@@ -78,7 +78,7 @@ void FirmwareService::loop() {
             MOCPP_DBG_INFO("Start download");
             stage = UpdateStage::Downloading;
             if (onDownload != nullptr) {
-                onDownload(location);
+                onDownload(location.c_str());
                 timestampTransition = mocpp_tick_ms();
                 delayTransition = downloadStatusInput ? 1000 : 30000; //give the download at least 30s
                 return;
@@ -138,7 +138,7 @@ void FirmwareService::loop() {
             stage = UpdateStage::Installing;
 
             if (onInstall) {
-                onInstall(location); //should restart the device on success
+                onInstall(location.c_str()); //should restart the device on success
             } else {
                 MOCPP_DBG_WARN("onInstall must be set! (see setOnInstall). Will abort");
             }
@@ -183,7 +183,7 @@ void FirmwareService::loop() {
     }
 }
 
-void FirmwareService::scheduleFirmwareUpdate(const std::string &location, Timestamp retreiveDate, int retries, unsigned int retryInterval) {
+void FirmwareService::scheduleFirmwareUpdate(const char *location, Timestamp retreiveDate, unsigned int retries, unsigned int retryInterval) {
     this->location = location;
     this->retreiveDate = retreiveDate;
     this->retries = retries;
@@ -197,15 +197,17 @@ void FirmwareService::scheduleFirmwareUpdate(const std::string &location, Timest
     char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
     this->retreiveDate.toJsonString(dbuf, JSONDATE_LENGTH + 1);
 
+#if MOCPP_DBG_LEVEL >= MOCPP_DL_INFO
     MOCPP_DBG_INFO("Scheduled FW update!\n" \
                     "                  location = %s\n" \
                     "                  retrieveDate = %s\n" \
-                    "                  retries = %i" \
+                    "                  retries = %u" \
                     ", retryInterval = %u",
             this->location.c_str(),
             dbuf,
             this->retries,
             this->retryInterval);
+#endif
 
     timestampTransition = mocpp_tick_ms();
     delayTransition = 1000;
@@ -276,7 +278,7 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
     return nullptr;
 }
 
-void FirmwareService::setOnDownload(std::function<bool(const std::string &location)> onDownload) {
+void FirmwareService::setOnDownload(std::function<bool(const char *location)> onDownload) {
     this->onDownload = onDownload;
 }
 
@@ -284,7 +286,7 @@ void FirmwareService::setDownloadStatusInput(std::function<DownloadStatus()> dow
     this->downloadStatusInput = downloadStatusInput;
 }
 
-void FirmwareService::setOnInstall(std::function<bool(const std::string &location)> onInstall) {
+void FirmwareService::setOnInstall(std::function<bool(const char *location)> onInstall) {
     this->onInstall = onInstall;
 }
 
@@ -310,7 +312,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
      * example of how to integrate a separate download phase (optional)
      */
 #if 0 //separate download phase
-    fwService->setOnDownload([] (const std::string &location) {
+    fwService->setOnDownload([] (const char *location) {
         //download the new binary
         //...
         return true;
@@ -323,7 +325,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
     });
 #endif //separate download phase
 
-    fwService->setOnInstall([fwService] (const std::string &location) {
+    fwService->setOnInstall([fwService] (const char *location) {
 
         fwService->setInstallationStatusInput([](){return InstallationStatus::NotInstalled;});
 
@@ -333,7 +335,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
         client.setTimeout(60); //in seconds
         
         // httpUpdate.setLedPin(LED_BUILTIN, HIGH);
-        t_httpUpdate_return ret = httpUpdate.update(client, location.c_str());
+        t_httpUpdate_return ret = httpUpdate.update(client, location);
 
         switch (ret) {
             case HTTP_UPDATE_FAILED:
@@ -368,7 +370,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
     FirmwareService *fwService = new FirmwareService(context);
 
-    fwService->setOnInstall([fwService] (const std::string &location) {
+    fwService->setOnInstall([fwService] (const char *location) {
         
         WiFiClient client;
         //WiFiClientSecure client;
@@ -377,7 +379,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 
         //ESPhttpUpdate.setLedPin(downloadStatusLedPin);
 
-        HTTPUpdateResult ret = ESPhttpUpdate.update(client, location.c_str());
+        HTTPUpdateResult ret = ESPhttpUpdate.update(client, location);
 
         switch (ret) {
             case HTTP_UPDATE_FAILED:
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
index 45aefaad..43a27406 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
@@ -45,13 +45,13 @@ class FirmwareService {
     Ocpp16::FirmwareStatus lastReportedStatus = Ocpp16::FirmwareStatus::Idle;
     bool checkedSuccessfulFwUpdate = false;
 
-    std::string location {};
-    Timestamp retreiveDate = Timestamp();
-    int retries = 0;
+    std::string location;
+    Timestamp retreiveDate;
+    unsigned int retries = 0;
     unsigned int retryInterval = 0;
 
-    std::function<bool(const std::string &location)> onDownload;
-    std::function<bool(const std::string &location)> onInstall;
+    std::function<bool(const char *location)> onDownload;
+    std::function<bool(const char *location)> onInstall;
 
     unsigned long delayTransition = 0;
     unsigned long timestampTransition = 0;
@@ -76,15 +76,15 @@ class FirmwareService {
 
     void loop();
 
-    void scheduleFirmwareUpdate(const std::string &location, Timestamp retreiveDate, int retries = 1, unsigned int retryInterval = 0);
+    void scheduleFirmwareUpdate(const char *location, Timestamp retreiveDate, unsigned int retries = 1, unsigned int retryInterval = 0);
 
     Ocpp16::FirmwareStatus getFirmwareStatus();
 
-    void setOnDownload(std::function<bool(const std::string &location)> onDownload);
+    void setOnDownload(std::function<bool(const char *location)> onDownload);
 
     void setDownloadStatusInput(std::function<DownloadStatus()> downloadStatusInput);
 
-    void setOnInstall(std::function<bool(const std::string &location)> onInstall);
+    void setOnInstall(std::function<bool(const char *location)> onInstall);
 
     void setInstallationStatusInput(std::function<InstallationStatus()> installationStatusInput);
 };
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.cpp b/src/MicroOcpp/Operations/UpdateFirmware.cpp
index cdfba5fd..b6300573 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.cpp
+++ b/src/MicroOcpp/Operations/UpdateFirmware.cpp
@@ -9,43 +9,42 @@
 
 using MicroOcpp::Ocpp16::UpdateFirmware;
 
-UpdateFirmware::UpdateFirmware(Model& model) : model(model) {
+UpdateFirmware::UpdateFirmware(FirmwareService& fwService) : fwService(fwService) {
 
 }
 
 void UpdateFirmware::processReq(JsonObject payload) {
-    /*
-     * Process the application data here. Note: you have to implement the FW update procedure in your client code. You have to set
-     * a onSendConfListener in which you initiate a FW update (e.g. calling ESPhttpUpdate.update(...) )
-     */
 
-    const char *loc = payload["location"] | "";
-    location = loc;
+    const char *location = payload["location"] | "";
     //check location URL. Maybe introduce Same-Origin-Policy?
-    if (location.empty()) {
-        formatError = true;
-        MOCPP_DBG_WARN("Could not read location. Abort");
+    if (!*location) {
+        errorCode = "FormationViolation";
+        return;
+    }
+    
+    int retries = payload["retries"] | 1;
+    int retryInterval = payload["retryInterval"] | 180;
+    if (retries < 0 || retryInterval < 0) {
+        errorCode = "PropertyConstraintViolation";
         return;
     }
 
     //check the integrity of retrieveDate
-    const char *retrieveDateRaw = payload["retrieveDate"] | "Invalid";
-    if (!retreiveDate.setTime(retrieveDateRaw)) {
-        formatError = true;
-        MOCPP_DBG_WARN("Could not read retrieveDate. Abort");
+    if (!payload.containsKey("retrieveDate")) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    Timestamp retrieveDate;
+    if (!retrieveDate.setTime(payload["retrieveDate"] | "Invalid")) {
+        errorCode = "PropertyConstraintViolation";
+        MOCPP_DBG_WARN("bad time format");
         return;
     }
     
-    retries = payload["retries"] | 1;
-    retryInterval = payload["retryInterval"] | 180;
+    fwService.scheduleFirmwareUpdate(location, retrieveDate, (unsigned int) retries, (unsigned int) retryInterval);
 }
 
 std::unique_ptr<DynamicJsonDocument> UpdateFirmware::createConf(){
-    if (auto fwService = model.getFirmwareService()) {
-        fwService->scheduleFirmwareUpdate(location, retreiveDate, retries, retryInterval);
-    } else {
-        MOCPP_DBG_ERR("FirmwareService has not been initialized before! Please have a look at MicroOcpp.cpp for an example. Abort");
-    }
-
     return createEmptyDocument();
 }
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.h b/src/MicroOcpp/Operations/UpdateFirmware.h
index 8c99a754..8efeba37 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.h
+++ b/src/MicroOcpp/Operations/UpdateFirmware.h
@@ -10,20 +10,17 @@
 
 namespace MicroOcpp {
 
-class Model;
+class FirmwareService;
 
 namespace Ocpp16 {
 
 class UpdateFirmware : public Operation {
 private:
-  Model& model;
-  std::string location {};
-  Timestamp retreiveDate = Timestamp();
-  int retries = 1;
-  unsigned long retryInterval = 180;
-  bool formatError = false;
+  FirmwareService& fwService;
+
+  const char *errorCode = nullptr;
 public:
-  UpdateFirmware(Model& model);
+  UpdateFirmware(FirmwareService& fwService);
 
   const char* getOperationType() override {return "UpdateFirmware";}
 
@@ -31,7 +28,7 @@ class UpdateFirmware : public Operation {
 
   std::unique_ptr<DynamicJsonDocument> createConf() override;
 
-  const char *getErrorCode() override {if (formatError) return "FormationViolation"; else return NULL;}
+  const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16

From 7db7a53b0db01a42d8aa93617cece33e01170952 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 8 Oct 2023 19:03:09 +0200
Subject: [PATCH 401/549] fix double executions

---
 .../Operations/RemoteStartTransaction.cpp     | 34 +++++++++----------
 .../Operations/RemoteStartTransaction.h       |  4 +--
 .../Operations/RemoteStopTransaction.cpp      | 20 +++++------
 .../Operations/RemoteStopTransaction.h        |  6 +++-
 src/MicroOcpp/Operations/TriggerMessage.cpp   | 31 +++++------------
 src/MicroOcpp/Operations/TriggerMessage.h     |  4 +--
 6 files changed, 42 insertions(+), 57 deletions(-)

diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
index be294aaa..5c6d9d06 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
@@ -21,23 +21,23 @@ const char* RemoteStartTransaction::getOperationType() {
 }
 
 void RemoteStartTransaction::processReq(JsonObject payload) {
-    connectorId = payload["connectorId"] | -1;
+    int connectorId = payload["connectorId"] | -1;
 
     if (!payload.containsKey("idTag")) {
         errorCode = "FormationViolation";
         return;
     }
 
-    const char *idTagIn = payload["idTag"] | "";
-    size_t len = strnlen(idTagIn, IDTAG_LEN_MAX + 1);
-    if (len > 0 && len <= IDTAG_LEN_MAX) {
-        snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
-    } else {
+    const char *idTag = payload["idTag"] | "";
+    size_t len = strnlen(idTag, IDTAG_LEN_MAX + 1);
+    if (len == 0 || len > IDTAG_LEN_MAX) {
         errorCode = "PropertyConstraintViolation";
         errorDescription = "idTag empty or too long";
         return;
     }
 
+    std::unique_ptr<ChargingProfile> chargingProfile;
+
     if (payload.containsKey("chargingProfile") && model.getSmartChargingService()) {
         MOCPP_DBG_INFO("Setting Charging profile via RemoteStartTransaction");
 
@@ -62,12 +62,7 @@ void RemoteStartTransaction::processReq(JsonObject payload) {
             return;
         }
     }
-}
 
-std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
-    JsonObject payload = doc->to<JsonObject>();
-    
     Connector *selectConnector = nullptr;
     if (connectorId >= 1) {
         //connectorId specified for given connector, try to start Transaction here
@@ -113,16 +108,21 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
             }
         }
 
-        if (success) {
-            payload["status"] = "Accepted";
-        } else {
-            payload["status"] = "Rejected";
-        }
+        accepted = success;
     } else {
         MOCPP_DBG_INFO("No connector to start transaction");
+        accepted = false;
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+    if (accepted) {
+        payload["status"] = "Accepted";
+    } else {
         payload["status"] = "Rejected";
     }
-    
     return doc;
 }
 
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.h b/src/MicroOcpp/Operations/RemoteStartTransaction.h
index ea3e64d8..90b78483 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.h
@@ -18,10 +18,8 @@ namespace Ocpp16 {
 class RemoteStartTransaction : public Operation {
 private:
     Model& model;
-    int connectorId;
-    char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
 
-    std::unique_ptr<ChargingProfile> chargingProfile;
+    bool accepted = false;
     
     const char *errorCode {nullptr};
     const char *errorDescription = "";
diff --git a/src/MicroOcpp/Operations/RemoteStopTransaction.cpp b/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
index f73a138d..f19dd969 100644
--- a/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
@@ -18,29 +18,29 @@ const char* RemoteStopTransaction::getOperationType(){
 }
 
 void RemoteStopTransaction::processReq(JsonObject payload) {
-    transactionId = payload["transactionId"] | -1;
-}
 
-std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
-    JsonObject payload = doc->to<JsonObject>();
-    
-    bool canStopTransaction = false;
+    if (!payload.containsKey("transactionId")) {
+        errorCode = "FormationViolation";
+    }
+    int transactionId = payload["transactionId"];
 
     for (unsigned int cId = 0; cId < model.getNumConnectors(); cId++) {
         auto connector = model.getConnector(cId);
         if (connector->getTransaction() &&
                 connector->getTransaction()->getTransactionId() == transactionId) {
-            canStopTransaction = true;
             connector->endTransaction(nullptr, "Remote");
+            accepted = true;
         }
     }
+}
 
-    if (canStopTransaction){
+std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+    if (accepted){
         payload["status"] = "Accepted";
     } else {
         payload["status"] = "Rejected";
     }
-    
     return doc;
 }
diff --git a/src/MicroOcpp/Operations/RemoteStopTransaction.h b/src/MicroOcpp/Operations/RemoteStopTransaction.h
index 2f778957..984de7e5 100644
--- a/src/MicroOcpp/Operations/RemoteStopTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStopTransaction.h
@@ -16,7 +16,9 @@ namespace Ocpp16 {
 class RemoteStopTransaction : public Operation {
 private:
     Model& model;
-    int transactionId;
+    bool accepted = false;
+
+    const char *errorCode = nullptr;
 public:
     RemoteStopTransaction(Model& model);
 
@@ -25,6 +27,8 @@ class RemoteStopTransaction : public Operation {
     void processReq(JsonObject payload) override;
 
     std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
index 99cf8ee9..7f0965e5 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.cpp
+++ b/src/MicroOcpp/Operations/TriggerMessage.cpp
@@ -35,10 +35,12 @@ void TriggerMessage::processReq(JsonObject payload) {
             if (connectorId < 0) {
                 auto nConnectors = mService->getNumConnectors();
                 for (decltype(nConnectors) cId = 0; cId < nConnectors; cId++) {
-                    triggeredOperations.push_back(mService->takeTriggeredMeterValues(cId));
+                    context.initiatePreBootOperation(mService->takeTriggeredMeterValues(cId));
+                    statusMessage = "Accepted";
                 }
             } else if (connectorId < mService->getNumConnectors()) {
-                triggeredOperations.push_back(mService->takeTriggeredMeterValues(connectorId));
+                context.initiatePreBootOperation(mService->takeTriggeredMeterValues(connectorId));
+                statusMessage = "Accepted";
             } else {
                 errorCode = "PropertyConstraintViolation";
             }
@@ -64,40 +66,23 @@ void TriggerMessage::processReq(JsonObject payload) {
 
             statusNotification->setTimeout(60000);
 
-            triggeredOperations.push_back(std::move(statusNotification));
+            context.initiatePreBootOperation(std::move(statusNotification));
+            statusMessage = "Accepted";
         }
     } else {
         auto msg = context.getOperationRegistry().deserializeOperation(requestedMessage);
         if (msg) {
-            triggeredOperations.push_back(std::move(msg));
+            context.initiatePreBootOperation(std::move(msg));
+            statusMessage = "Accepted";
         } else {
             statusMessage = "NotImplemented";
         }
     }
-
-    if (!triggeredOperations.empty()) {
-        statusMessage = "Accepted";
-    } else {
-        if (errorCode) {
-            MOCPP_DBG_ERR("errorCode: %s", errorCode);
-        } else {
-            MOCPP_DBG_WARN("TriggerMessage denied. statusMessage: %s", statusMessage);
-        }
-    }
-
 }
 
 std::unique_ptr<DynamicJsonDocument> TriggerMessage::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    
     payload["status"] = statusMessage;
-
-    auto op = triggeredOperations.begin();
-    while (op != triggeredOperations.end()) {
-        context.initiatePreBootOperation(std::move(triggeredOperations.front()));
-        op = triggeredOperations.erase(op);
-    }
-
     return doc;
 }
diff --git a/src/MicroOcpp/Operations/TriggerMessage.h b/src/MicroOcpp/Operations/TriggerMessage.h
index df77d42b..b6f91025 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.h
+++ b/src/MicroOcpp/Operations/TriggerMessage.h
@@ -12,15 +12,13 @@
 namespace MicroOcpp {
 
 class Context;
-class Request;
 
 namespace Ocpp16 {
 
 class TriggerMessage : public Operation {
 private:
     Context& context;
-    std::vector<std::unique_ptr<Request>> triggeredOperations;
-    const char *statusMessage {nullptr};
+    const char *statusMessage = nullptr;
 
     const char *errorCode = nullptr;
 public:

From 2418cc4cd9c009e513055585f630898952442f9e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 15 Oct 2023 15:41:00 +0200
Subject: [PATCH 402/549] apply ConnectionTimeOut only when unplugged

---
 .../Model/ConnectorBase/Connector.cpp         | 23 ++++++++++---------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 0d2462e9..4e34b5f4 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -196,19 +196,20 @@ void Connector::loop() {
                     transaction->commit();
                 }
             }
-        }
 
-        if (transaction->isActive() &&
-                !transaction->getStartSync().isRequested() &&
-                transaction->getBeginTimestamp() > MIN_TIME &&
-                connectionTimeOutInt && connectionTimeOutInt->getInt() > 0 &&
-                model.getClock().now() - transaction->getBeginTimestamp() >= connectionTimeOutInt->getInt()) {
-                
-            MOCPP_DBG_INFO("Session mngt: timeout");
-            transaction->setInactive();
-            transaction->commit();
+            if (transaction->isActive() &&
+                    !transaction->getStartSync().isRequested() &&
+                    transaction->getBeginTimestamp() > MIN_TIME &&
+                    connectionTimeOutInt && connectionTimeOutInt->getInt() > 0 &&
+                    !connectorPluggedInput() &&
+                    model.getClock().now() - transaction->getBeginTimestamp() >= connectionTimeOutInt->getInt()) {
+
+                MOCPP_DBG_INFO("Session mngt: timeout");
+                transaction->setInactive();
+                transaction->commit();
 
-            updateTxNotification(TxNotification::ConnectionTimeout);
+                updateTxNotification(TxNotification::ConnectionTimeout);
+            }
         }
 
         if (transaction->isActive() &&

From 5d36bd62ce7cb26d326c416f3ab86a2f3f1c8370 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 15 Oct 2023 23:07:11 +0200
Subject: [PATCH 403/549] update Auth module for testability

---
 .../Model/Authorization/AuthorizationList.cpp | 80 +++++++++----------
 .../Model/Authorization/AuthorizationList.h   |  9 ++-
 .../Authorization/AuthorizationService.cpp    | 39 +++++----
 .../Authorization/AuthorizationService.h      |  6 +-
 src/MicroOcpp/Operations/SendLocalList.cpp    | 19 +++--
 src/MicroOcpp/Operations/SendLocalList.h      |  6 +-
 6 files changed, 83 insertions(+), 76 deletions(-)

diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
index f3414fd1..61a3468a 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
@@ -41,52 +41,48 @@ MicroOcpp::AuthorizationData *AuthorizationList::get(const char *idTag) {
     return nullptr;
 }
 
-bool AuthorizationList::readJson(JsonObject payload, bool compact) {
-
-    bool differential = !strcmp("Differential", payload["updateType"] | "Invalid"); //if Json also contains delete commands
+bool AuthorizationList::readJson(JsonArray authlistJson, int listVersion, bool differential, bool compact) {
 
     if (compact) {
         //compact representations don't contain remove commands
         differential = false;
     }
 
-    JsonArray collection = payload["localAuthorizationList"];
-
-    for (size_t i = 0; i < collection.size(); i++) {
+    for (size_t i = 0; i < authlistJson.size(); i++) {
 
         //check if JSON object is valid
-        if (!collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAG(compact))) {
+        if (!authlistJson[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAG(compact))) {
             return false;
         }
     }
 
-    std::vector<int> collection_index;
+    std::vector<int> authlist_index;
     std::vector<int> remove_list;
 
     unsigned int resultingListLength = 0;
 
     if (!differential) {
         //every entry will insert an idTag
-        resultingListLength = collection.size();
+        resultingListLength = authlistJson.size();
     } else {
         //update type is differential; only unkown entries will insert an idTag
 
         resultingListLength = localAuthorizationList.size();
 
         //also, build index here
-        collection_index = std::vector<int>(collection.size(), -1);
+        authlist_index = std::vector<int>(authlistJson.size(), -1);
 
-        for (size_t i = 0; i < collection.size(); i++) {
+        for (size_t i = 0; i < authlistJson.size(); i++) {
 
             //check if locally stored auth info is present; if yes, apply it to the index
-            AuthorizationData *found = get(collection[i][AUTHDATA_KEY_IDTAG(compact)]);
+            AuthorizationData *found = get(authlistJson[i][AUTHDATA_KEY_IDTAG(compact)]);
 
             if (found) {
 
-                collection_index[i] = (int) (found - localAuthorizationList.data());
+                authlist_index[i] = (int) (found - localAuthorizationList.data());
 
                 //remove or update?
-                if (!collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
+                if (!authlistJson[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
                     //this entry should be removed
                     found->reset(); //mark for deletion
                     remove_list.push_back((int) (found - localAuthorizationList.data()));
@@ -94,7 +90,7 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
                 } //else: this entry should be updated
             } else {
                 //insert or ignore?
-                if (collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
+                if (authlistJson[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
                     //add
                     resultingListLength++;
                 } //else: ignore
@@ -112,46 +108,46 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
     if (compact) {
         localAuthorizationList.clear();
 
-        for (size_t i = 0; i < collection.size(); i++) {
+        for (size_t i = 0; i < authlistJson.size(); i++) {
             localAuthorizationList.push_back(AuthorizationData());
-            localAuthorizationList.back().readJson(collection[i], compact);
+            localAuthorizationList.back().readJson(authlistJson[i], compact);
         }
     } else if (differential) {
 
-        for (size_t i = 0; i < collection.size(); i++) {
+        for (size_t i = 0; i < authlistJson.size(); i++) {
 
             //is entry a remove command?
-            if (!collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
+            if (!authlistJson[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
                 continue; //yes, remove command, will be deleted afterwards
             }
 
             //update, or insert
 
-            if (collection_index[i] < 0) {
+            if (authlist_index[i] < 0) {
                 //auth list does not contain idTag yet -> insert new entry
 
                 //reuse removed AuthData object?
                 if (!remove_list.empty()) {
                     //yes, reuse
-                    collection_index[i] = remove_list.back();
+                    authlist_index[i] = remove_list.back();
                     remove_list.pop_back();
                 } else {
                     //no, create new
-                    collection_index[i] = localAuthorizationList.size();
+                    authlist_index[i] = localAuthorizationList.size();
                     localAuthorizationList.push_back(AuthorizationData());
                 }
             }
 
-            localAuthorizationList[collection_index[i]].readJson(collection[i], compact);
+            localAuthorizationList[authlist_index[i]].readJson(authlistJson[i], compact);
         }
 
     } else {
         localAuthorizationList.clear();
 
-        for (size_t i = 0; i < collection.size(); i++) {
-            if (collection[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
+        for (size_t i = 0; i < authlistJson.size(); i++) {
+            if (authlistJson[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
                 localAuthorizationList.push_back(AuthorizationData());
-                localAuthorizationList.back().readJson(collection[i], compact);
+                localAuthorizationList.back().readJson(authlistJson[i], compact);
             }
         }
     }
@@ -166,10 +162,10 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
                 return strcmp(lhs.getIdTag(), rhs.getIdTag()) < 0;
             });
     
-    listVersion = payload["listVersion"] | 0;
-    
+    this->listVersion = listVersion;
+
     if (localAuthorizationList.empty()) {
-        listVersion = 0;
+        this->listVersion = 0;
     }
 
     return true;
@@ -177,24 +173,24 @@ bool AuthorizationList::readJson(JsonObject payload, bool compact) {
 
 void AuthorizationList::clear() {
     localAuthorizationList.clear();
+    listVersion = 0;
 }
 
-size_t AuthorizationList::getJsonCapacity(bool compact) {
-    return JSON_OBJECT_SIZE(3) +
-           JSON_ARRAY_SIZE(localAuthorizationList.size()) +
-            std::accumulate(localAuthorizationList.begin(), localAuthorizationList.end(), 0,
-                    [] (const int& acc, const AuthorizationData& v) {
-                        return acc + (int) v.getJsonCapacity();
-                    } );
+size_t AuthorizationList::getJsonCapacity() {
+    size_t res = JSON_ARRAY_SIZE(localAuthorizationList.size());
+    for (auto& entry : localAuthorizationList) {
+        res += entry.getJsonCapacity();
+    }
+    return res;
 }
 
-void AuthorizationList::writeJson(JsonObject& payload, bool compact) {
-    payload["listVersion"] = listVersion;
-
-    JsonArray collection = payload.createNestedArray("localAuthorizationList");
-
+void AuthorizationList::writeJson(JsonArray authListOut, bool compact) {
     for (auto& entry : localAuthorizationList) {
-        JsonObject entryJson = collection.createNestedObject();
+        JsonObject entryJson = authListOut.createNestedObject();
         entry.writeJson(entryJson, compact);
     }
 }
+
+size_t AuthorizationList::size() {
+    return localAuthorizationList.size();
+}
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.h b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
index 27978df2..07e2ebb4 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
@@ -12,7 +12,9 @@
 #define MOCPP_LocalAuthListMaxLength 48
 #endif
 
+#ifndef MOCPP_SendLocalListMaxLength
 #define MOCPP_SendLocalListMaxLength MOCPP_LocalAuthListMaxLength
+#endif
 
 namespace MicroOcpp {
 
@@ -26,13 +28,14 @@ class AuthorizationList {
 
     AuthorizationData *get(const char *idTag);
 
-    bool readJson(JsonObject payload, bool compact = false); //compact: if true, then use compact non-ocpp representation
+    bool readJson(JsonArray localAuthorizationList, int listVersion, bool differential = false, bool compact = false); //compact: if true, then use compact non-ocpp representation
     void clear();
 
-    size_t getJsonCapacity(bool compact = false);
-    void writeJson(JsonObject& entry, bool compact = false);
+    size_t getJsonCapacity();
+    void writeJson(JsonArray authListOut, bool compact = false);
 
     int getListVersion() {return listVersion;}
+    size_t size(); //used in unit tests
 
 };
 
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 7cb03fe7..465723de 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -20,19 +20,18 @@ using namespace MicroOcpp;
 
 AuthorizationService::AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
-    localAuthorizeOfflineBool = declareConfiguration<bool>("LocalAuthorizeOffline", true);
     localAuthListEnabledBool = declareConfiguration<bool>("LocalAuthListEnabled", true);
     declareConfiguration<int>("LocalAuthListMaxLength", MOCPP_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, true);
     declareConfiguration<int>("SendLocalListMaxLength", MOCPP_SendLocalListMaxLength, CONFIGURATION_VOLATILE, true);
 
-    if (!localAuthorizeOfflineBool || !localAuthListEnabledBool) {
+    if (!localAuthListEnabledBool) {
         MOCPP_DBG_ERR("initialization error");
     }
     
     context.getOperationRegistry().registerOperation("GetLocalListVersion", [&context] () {
         return new Ocpp16::GetLocalListVersion(context.getModel());});
-    context.getOperationRegistry().registerOperation("SendLocalList", [&context] () {
-        return new Ocpp16::SendLocalList(context.getModel());});
+    context.getOperationRegistry().registerOperation("SendLocalList", [this] () {
+        return new Ocpp16::SendLocalList(*this);});
 
     loadLists();
 }
@@ -61,7 +60,9 @@ bool AuthorizationService::loadLists() {
 
     JsonObject root = doc->as<JsonObject>();
 
-    if (!localAuthorizationList.readJson(root, true)) {
+    int listVersion = root["listVersion"] | 0;
+    
+    if (!localAuthorizationList.readJson(root["localAuthorizationList"].as<JsonArray>(), listVersion, false, true)) {
         MOCPP_DBG_ERR("list read failure");
         return false;
     }
@@ -70,10 +71,6 @@ bool AuthorizationService::loadLists() {
 }
 
 AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag) {
-    if (!localAuthorizeOfflineBool->getBool()) {
-        return nullptr;
-    }
-
     if (!localAuthListEnabledBool->getBool()) {
         return nullptr; //auth cache will follow
     }
@@ -92,15 +89,27 @@ AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag
     return authData;
 }
 
-bool AuthorizationService::updateLocalList(JsonObject payload) {
-    bool success = localAuthorizationList.readJson(payload);
+int AuthorizationService::getLocalListVersion() {
+    return localAuthorizationList.getListVersion();
+}
+
+size_t AuthorizationService::getLocalListSize() {
+    return localAuthorizationList.size();
+}
+
+bool AuthorizationService::updateLocalList(JsonArray localAuthorizationListJson, int listVersion, bool differential) {
+    bool success = localAuthorizationList.readJson(localAuthorizationListJson, listVersion, differential, false);
 
     if (success) {
         
-        DynamicJsonDocument doc (localAuthorizationList.getJsonCapacity());
+        DynamicJsonDocument doc (
+                JSON_OBJECT_SIZE(3) +
+                localAuthorizationList.getJsonCapacity());
 
         JsonObject root = doc.to<JsonObject>();
-        localAuthorizationList.writeJson(root, true);
+        root["listVersion"] = listVersion;
+        JsonArray authListCompact = root.createNestedArray("localAuthorizationList");
+        localAuthorizationList.writeJson(authListCompact, true);
         success = FilesystemUtils::storeJson(filesystem, MOCPP_LOCALAUTHORIZATIONLIST_FN, doc);
 
         if (!success) {
@@ -114,10 +123,6 @@ bool AuthorizationService::updateLocalList(JsonObject payload) {
 void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idTagInfo) {
     //check local list conflicts. In future: also update authorization cache
 
-    if (!localAuthorizeOfflineBool->getBool()) {
-        return;
-    }
-
     if (!localAuthListEnabledBool->getBool()) {
         return; //auth cache will follow
     }
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.h b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
index 4deb4bc6..8a2c6043 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
@@ -19,7 +19,6 @@ class AuthorizationService {
     std::shared_ptr<FilesystemAdapter> filesystem;
     AuthorizationList localAuthorizationList;
 
-    std::shared_ptr<Configuration> localAuthorizeOfflineBool;
     std::shared_ptr<Configuration> localAuthListEnabledBool;
 
 public:
@@ -30,9 +29,10 @@ class AuthorizationService {
 
     AuthorizationData *getLocalAuthorization(const char *idTag);
 
-    int getLocalListVersion() {return localAuthorizationList.getListVersion();}
+    int getLocalListVersion();
+    size_t getLocalListSize(); //number of entries in current localAuthList; used in unit tests
 
-    bool updateLocalList(JsonObject payload);
+    bool updateLocalList(JsonArray localAuthorizationListJson, int listVersion, bool differential);
 
     void notifyAuthorization(const char *idTag, JsonObject idTagInfo);
 };
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 8670a4bd..7ef232ec 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -8,7 +8,7 @@
 
 using MicroOcpp::Ocpp16::SendLocalList;
 
-SendLocalList::SendLocalList(Model& model) : model(model) {
+SendLocalList::SendLocalList(AuthorizationService& authService) : authService(authService) {
   
 }
 
@@ -26,25 +26,28 @@ void SendLocalList::processReq(JsonObject payload) {
         return;
     }
 
-    auto authService = model.getAuthorizationService();
-
-    if (!authService) {
-        errorCode = "InternalError";
+    if (!payload["localAuthorizationList"].is<JsonArray>()) {
+        errorCode = "FormationViolation";
         return;
     }
 
-    if (payload["localAuthorizationList"].as<JsonArray>().size() > MOCPP_SendLocalListMaxLength) {
+    JsonArray localAuthorizationList = payload["localAuthorizationList"];
+
+    if (localAuthorizationList.size() > MOCPP_SendLocalListMaxLength) {
         errorCode = "OccurenceConstraintViolation";
+        return;
     }
 
+    bool differential = !strcmp("Differential", payload["updateType"] | "Invalid"); //updateType Differential or Full
+
     int listVersion = payload["listVersion"];
 
-    if (authService->getLocalListVersion() >= listVersion) {
+    if (differential && authService.getLocalListVersion() >= listVersion) {
         versionMismatch = true;
         return;
     }
 
-    updateFailure = !authService->updateLocalList(payload);
+    updateFailure = !authService.updateLocalList(localAuthorizationList, listVersion, differential);
 }
 
 std::unique_ptr<DynamicJsonDocument> SendLocalList::createConf(){
diff --git a/src/MicroOcpp/Operations/SendLocalList.h b/src/MicroOcpp/Operations/SendLocalList.h
index 21f4b990..496b8126 100644
--- a/src/MicroOcpp/Operations/SendLocalList.h
+++ b/src/MicroOcpp/Operations/SendLocalList.h
@@ -9,18 +9,18 @@
 
 namespace MicroOcpp {
 
-class Model;
+class AuthorizationService;
 
 namespace Ocpp16 {
 
 class SendLocalList : public Operation {
 private:
-    Model& model;
+    AuthorizationService& authService;
     const char *errorCode = nullptr;
     bool updateFailure = true;
     bool versionMismatch = false;
 public:
-    SendLocalList(Model& model);
+    SendLocalList(AuthorizationService& authService);
 
     ~SendLocalList();
 

From aadbada660dbf6180ddd284def06a963f7896247 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 15 Oct 2023 23:07:55 +0200
Subject: [PATCH 404/549] LocalAuthList unit tests and fixes

---
 CMakeLists.txt                                |   3 +
 src/MicroOcpp/Core/RequestQueue.cpp           |   2 +-
 .../Model/ConnectorBase/Connector.cpp         |   5 +-
 src/MicroOcpp/Model/ConnectorBase/Connector.h |   1 +
 .../Model/ConnectorBase/ConnectorsCommon.cpp  |   2 +-
 .../Operations/ChangeAvailability.cpp         |   1 +
 src/MicroOcpp/Operations/CustomOperation.cpp  |   7 +
 src/MicroOcpp/Operations/CustomOperation.h    |   2 +
 tests/LocalAuthList.cpp                       | 889 ++++++++++++++++++
 9 files changed, 908 insertions(+), 4 deletions(-)
 create mode 100644 tests/LocalAuthList.cpp

diff --git a/CMakeLists.txt b/CMakeLists.txt
index ac3ecb15..f3ec28bb 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -126,6 +126,7 @@ set(MOCPP_SRC_UNIT
     tests/Metering.cpp
     tests/Configuration.cpp
     tests/Reservation.cpp
+    tests/LocalAuthList.cpp
 )
 
 add_executable(mo_unit_tests
@@ -150,6 +151,8 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MOCPP_DBG_LEVEL=MOCPP_DL_DEBUG
     MOCPP_TRAFFIC_OUT
     MOCPP_FILENAME_PREFIX="./mo_store/"
+    MOCPP_LocalAuthListMaxLength=8
+    MOCPP_SendLocalListMaxLength=4
 )
 
 target_compile_options(mo_unit_tests PUBLIC
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index 3f5e8704..9c24cae1 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -66,7 +66,7 @@ void RequestQueue::loop(Connection& ocppSock) {
 
             if (success) {
                 MOCPP_DBG_TRAFFIC_OUT(out.c_str());
-                received = receivedRequests.erase(received);
+                receivedRequests.erase(received);
             }
 
             return;
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 4e34b5f4..5749d850 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -43,6 +43,7 @@ Connector::Connector(Context& context, int connectorId)
     stopTransactionOnEVSideDisconnectBool = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true);
     declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", true, CONFIGURATION_VOLATILE, true);
     localPreAuthorizeBool = declareConfiguration<bool>("LocalPreAuthorize", false);
+    localAuthorizeOfflineBool = declareConfiguration<bool>("LocalAuthorizeOffline", true);
     allowOfflineTxForUnknownIdBool = MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", false);
 
     //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
@@ -542,7 +543,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     //check local OCPP whitelist
     if (model.getAuthorizationService()) {
         localAuth = model.getAuthorizationService()->getLocalAuthorization(idTag);
-        
+
         //check authorization status
         if (localAuth && localAuth->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
             MOCPP_DBG_DEBUG("local auth denied (%s)", idTag);
@@ -694,7 +695,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             return;
         }
 
-        if (localAuthFound) {
+        if (localAuthFound && localAuthorizeOfflineBool && localAuthorizeOfflineBool->getBool()) {
             MOCPP_DBG_DEBUG("Offline transaction process (%s), locally authorized", tx->getIdTag());
             if (reservationFound) {
                 tx->setReservationId(reservationId);
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 63159566..b1ce7182 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -61,6 +61,7 @@ class Connector {
     std::shared_ptr<Configuration> stopTransactionOnInvalidIdBool;
     std::shared_ptr<Configuration> stopTransactionOnEVSideDisconnectBool;
     std::shared_ptr<Configuration> localPreAuthorizeBool;
+    std::shared_ptr<Configuration> localAuthorizeOfflineBool;
     std::shared_ptr<Configuration> allowOfflineTxForUnknownIdBool;
 
     std::shared_ptr<Configuration> silentOfflineTransactionsBool;
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index 98ea559f..2a31817b 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -62,7 +62,7 @@ ConnectorsCommon::ConnectorsCommon(Context& context, unsigned int numConn, std::
      * Mocking an OCPP Server on the same device makes running (unit) tests easier.
      */
     context.getOperationRegistry().registerOperation("Authorize", [&context] () {
-        return new Ocpp16::Authorize(context.getModel(), nullptr);});
+        return new Ocpp16::Authorize(context.getModel(), "");});
     context.getOperationRegistry().registerOperation("StartTransaction", [&context] () {
         return new Ocpp16::StartTransaction(context.getModel(), nullptr);});
     context.getOperationRegistry().registerOperation("StatusNotification", [&context] () {
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.cpp b/src/MicroOcpp/Operations/ChangeAvailability.cpp
index 7f52bdc0..ae66235d 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.cpp
+++ b/src/MicroOcpp/Operations/ChangeAvailability.cpp
@@ -41,6 +41,7 @@ void ChangeAvailability::processReq(JsonObject payload) {
         accepted = true;
         available = false;
     } else {
+        errorCode = "PropertyConstraintViolation";
         return;
     }
 
diff --git a/src/MicroOcpp/Operations/CustomOperation.cpp b/src/MicroOcpp/Operations/CustomOperation.cpp
index 0ff7080f..59eef187 100644
--- a/src/MicroOcpp/Operations/CustomOperation.cpp
+++ b/src/MicroOcpp/Operations/CustomOperation.cpp
@@ -66,6 +66,13 @@ void CustomOperation::processConf(JsonObject payload) {
     return fn_processConf(payload);
 }
 
+bool CustomOperation::processErr(const char *code, const char *description, JsonObject details) {
+    if (fn_processErr) {
+        return fn_processErr(code, description, details);
+    }
+    return true;
+}
+
 void CustomOperation::processReq(JsonObject payload) {
     return fn_processReq(payload);
 }
diff --git a/src/MicroOcpp/Operations/CustomOperation.h b/src/MicroOcpp/Operations/CustomOperation.h
index e158bb70..81d5b3ef 100644
--- a/src/MicroOcpp/Operations/CustomOperation.h
+++ b/src/MicroOcpp/Operations/CustomOperation.h
@@ -56,6 +56,8 @@ class CustomOperation : public Operation {
 
     void processConf(JsonObject payload) override;
 
+    bool processErr(const char *code, const char *description, JsonObject details) override;
+
     void processReq(JsonObject payload) override;
 
     std::unique_ptr<DynamicJsonDocument> createConf() override;
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
new file mode 100644
index 00000000..684cc5ab
--- /dev/null
+++ b/tests/LocalAuthList.cpp
@@ -0,0 +1,889 @@
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Model/Authorization/AuthorizationService.h>
+
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
+using namespace MicroOcpp;
+
+void generateAuthList(JsonArray out, size_t size, bool compact) {
+    for (size_t i = 0; i < size; i++) {
+        JsonObject authData = out.createNestedObject();
+        JsonObject idTagInfo;
+        if (compact) {
+            //flat structure
+            idTagInfo = authData;
+        } else {
+            //nested idTagInfo
+            idTagInfo = authData["idTagInfo"].to<JsonObject>();
+        }
+
+        char buf [IDTAG_LEN_MAX + 1];
+        sprintf(buf, "mIdTag%zu", i);
+        authData[AUTHDATA_KEY_IDTAG(compact)] = buf;
+        idTagInfo[AUTHDATA_KEY_STATUS(compact)] = "Accepted";
+    }
+}
+
+TEST_CASE( "LocalAuth" ) {
+    printf("\nRun %s\n",  "LocalAuth");
+
+    //clean state
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
+    FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+
+    mocpp_set_timer(custom_timer_cb);
+
+    mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+    auto& model = getOcppContext()->getModel();
+    auto authService = model.getAuthorizationService();
+    auto connector = model.getConnector(1);
+    model.getClock().setTime(BASE_TIME);
+
+    loop();
+    
+    //enable local auth
+    declareConfiguration<bool>("LocalAuthListEnabled", true)->setBool(true);
+
+    //set Authorize timeout after which the charger is considered offline
+    const unsigned long AUTH_TIMEOUT_MS = 60000;
+    MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", -1)->setInt(AUTH_TIMEOUT_MS / 1000);
+
+    //fetch local auth configs
+    auto localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", false);
+    auto localPreAuthorize = declareConfiguration<bool>("LocalPreAuthorize", false);
+
+    SECTION("Basic local auth - LocalPreAuthorize") {
+
+        localAuthorizeOffline->setBool(false);
+        localPreAuthorize->setBool(true);
+        
+        //set local list
+        StaticJsonDocument<256> localAuthList;
+        localAuthList[0]["idTag"] = "mIdTag";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+
+        REQUIRE( authService->updateLocalList(localAuthList.as<JsonArray>(), 1, false) );
+
+        REQUIRE( authService->getLocalListSize() == 1 );
+        REQUIRE( authService->getLocalAuthorization("mIdTag") != nullptr );
+        REQUIRE( authService->getLocalAuthorization("mIdTag")->getAuthorizationStatus() == AuthorizationStatus::Accepted );
+
+        //check TX notification
+        bool checkTxAuthorized = false;
+        setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
+            if (txNotification == TxNotification::Authorized) {
+                checkTxAuthorized = true;
+            }
+        });
+
+        //begin transaction and delay Authorize request - tx should start immediately
+        loopback.setConnected(false); //Authorize delayed by short offline period
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        beginTransaction("mIdTag");
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( checkTxAuthorized );
+
+        loopback.setConnected(true);
+        endTransaction();
+        loop();
+
+        //begin transaction delay Authorize request, but idTag doesn't match local list - tx should start when online again
+        checkTxAuthorized = false;
+        loopback.setConnected(false);
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        beginTransaction("wrong idTag");
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( !checkTxAuthorized );
+
+        loopback.setConnected(true);
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( checkTxAuthorized );
+
+        endTransaction();
+        loop();
+    }
+
+    SECTION("Basic local auth - LocalAuthorizeOffline") {
+
+        localAuthorizeOffline->setBool(true);
+        localPreAuthorize->setBool(false);
+
+        //set local list
+        StaticJsonDocument<256> localAuthList;
+        localAuthList[0]["idTag"] = "mIdTag";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), 1, false);
+
+        //check TX notification
+        bool checkTxAuthorized = false;
+        setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
+            if (txNotification == TxNotification::Authorized) {
+                checkTxAuthorized = true;
+            }
+        });
+
+        //make charger offline and begin tx - tx should begin after Authorize timeout
+        loopback.setConnected(false);
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        ulong t_before = mocpp_tick_ms();
+
+        beginTransaction("mIdTag");
+        loop();
+
+        REQUIRE( mocpp_tick_ms() - t_before < AUTH_TIMEOUT_MS ); //if this fails, increase AUTH_TIMEOUT_MS
+        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( !checkTxAuthorized );
+
+        mtime += AUTH_TIMEOUT_MS - (mocpp_tick_ms() - t_before); //increment clock so that auth timeout is exceeded
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( checkTxAuthorized );
+
+        loopback.setConnected(true);
+        endTransaction();
+        loop();
+
+        //make charger offline and begin tx, but idTag doesn't match - tx should be aborted
+        bool checkTxTimeout = false;
+        setTxNotificationOutput([&checkTxTimeout] (Transaction*, TxNotification txNotification) {
+            if (txNotification == TxNotification::AuthorizationTimeout) {
+                checkTxTimeout = true;
+            }
+        });
+        loopback.setConnected(false);
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        t_before = mocpp_tick_ms();
+
+        beginTransaction("wrong idTag");
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( !checkTxTimeout );
+
+        mtime += AUTH_TIMEOUT_MS - (mocpp_tick_ms() - t_before); //increment clock so that auth timeout is exceeded
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( checkTxTimeout );
+
+        loopback.setConnected(true);
+        loop();
+    }
+
+    SECTION("Basic local auth - AllowOfflineTxForUnknownId") {
+
+        localAuthorizeOffline->setBool(false);
+        localPreAuthorize->setBool(false);
+        MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", true)->setBool(true);
+
+        //check TX notification
+        bool checkTxAuthorized = false;
+        setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
+            if (txNotification == TxNotification::Authorized) {
+                checkTxAuthorized = true;
+            }
+        });
+
+        //make charger offline and begin tx - tx should begin after Authorize timeout
+        loopback.setConnected(false);
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        ulong t_before = mocpp_tick_ms();
+
+        beginTransaction("unknownIdTag");
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( !checkTxAuthorized );
+
+        mtime += AUTH_TIMEOUT_MS - (mocpp_tick_ms() - t_before); //increment clock so that auth timeout is exceeded
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( checkTxAuthorized );
+
+        loopback.setConnected(true);
+        endTransaction();
+        loop();
+    }
+
+    SECTION("Local auth list entry expired / unauthorized") {
+
+        localPreAuthorize->setBool(true);
+
+        //set local list with expired / unauthorized entry
+        StaticJsonDocument<512> localAuthList;
+        localAuthList[0]["idTag"] = "mIdTagExpired";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        localAuthList[0]["idTagInfo"]["expiryDate"] = BASE_TIME; //is in past
+        localAuthList[1]["idTag"] = "mIdTagUnauthorized";
+        localAuthList[1]["idTagInfo"]["status"] = "Blocked";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), 1, false);
+        REQUIRE( authService->getLocalAuthorization("mIdTagExpired") );
+        REQUIRE( authService->getLocalAuthorization("mIdTagUnauthorized") );
+
+        REQUIRE( authService->getLocalAuthorization("mIdTagExpired") );
+
+        //begin transaction and delay Authorize request - cannot PreAuthorize because entry is expired
+        loopback.setConnected(false); //Authorize delayed by short offline period
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        beginTransaction("mIdTagExpired");
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+
+        loopback.setConnected(true);
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+
+        endTransaction();
+        loop();
+
+        //begin transaction and delay Authorize request - cannot PreAuthorize because entry is unauthorized
+        loopback.setConnected(false); //Authorize delayed by short offline period
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        beginTransaction("mIdTagUnauthorized");
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+
+        loopback.setConnected(true);
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        endTransaction();
+        loop();
+    }
+
+    SECTION("Mix local authorization modes") {
+
+        localAuthorizeOffline->setBool(true);
+        localPreAuthorize->setBool(true);
+        MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", true)->setBool(true);
+
+        //set local list with accepted and accepted entry
+        StaticJsonDocument<512> localAuthList;
+        localAuthList[0]["idTag"] = "mIdTagExpired";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        localAuthList[0]["idTagInfo"]["expiryDate"] = BASE_TIME; //is in past
+        localAuthList[1]["idTag"] = "mIdTagAccepted";
+        localAuthList[1]["idTagInfo"]["status"] = "Accepted";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), 1, false);
+        REQUIRE( authService->getLocalAuthorization("mIdTagExpired") );
+        REQUIRE( authService->getLocalAuthorization("mIdTagAccepted") );
+
+        //begin transaction and delay Authorize request - tx should start immediately
+        loopback.setConnected(false);
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        beginTransaction("mIdTagAccepted");
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+
+        loopback.setConnected(true);
+        endTransaction();
+        loop();
+
+        //begin transaction, but idTag is expired - AllowOfflineTxForUnknownId must not apply
+        loopback.setConnected(false);
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        ulong t_before = mocpp_tick_ms();
+
+        beginTransaction("mIdTagExpired");
+        loop();
+
+        REQUIRE( mocpp_tick_ms() - t_before < AUTH_TIMEOUT_MS ); //if this fails, increase AUTH_TIMEOUT_MS
+        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+
+        mtime += AUTH_TIMEOUT_MS - (mocpp_tick_ms() - t_before); //increment clock so that auth timeout is exceeded
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        loopback.setConnected(true);
+        loop();
+    }
+
+    SECTION("DeAuthorize locally authorized tx") {
+
+        localAuthorizeOffline->setBool(false);
+        localPreAuthorize->setBool(true);
+
+        //check TX notification
+        bool checkTxAuthorized = false;
+        setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
+            if (txNotification == TxNotification::Authorized) {
+                checkTxAuthorized = true;
+            }
+        });
+
+        //set local list
+        StaticJsonDocument<256> localAuthList;
+        localAuthList[0]["idTag"] = "mIdTag";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), 1, false);
+
+        //patch Authorize so it will reject all idTags
+        getOcppContext()->getOperationRegistry().registerOperation("Authorize", [] () {
+            return new Ocpp16::CustomOperation("Authorize",
+                [] (JsonObject) {}, //ignore req
+                [] () {
+                    //create conf
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTagInfo"]["status"] = "Blocked";
+                    return doc;
+                });});
+
+        //begin transaction and delay Authorize request - tx should start immediately
+        loopback.setConnected(false); //Authorize delayed by short offline period
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        beginTransaction("mIdTag");
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( checkTxAuthorized );
+
+        //check TX notification
+        bool checkTxRejected = false;
+        setTxNotificationOutput([&checkTxRejected] (Transaction*, TxNotification txNotification) {
+            if (txNotification == TxNotification::AuthorizationRejected) {
+                checkTxRejected = true;
+            }
+        });
+
+        loopback.setConnected(true);
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( checkTxRejected );
+
+        loop();
+    }
+
+    SECTION("LocalListConflict") {
+
+        //patch Authorize so it will reject all idTags
+        bool checkAuthorize = false;
+        getOcppContext()->getOperationRegistry().registerOperation("Authorize", [&checkAuthorize] () {
+            return new Ocpp16::CustomOperation("Authorize",
+                [&checkAuthorize] (JsonObject) {
+                    checkAuthorize = true;
+                },
+                [] () {
+                    //create conf
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTagInfo"]["status"] = "Blocked";
+                    return doc;
+                });});
+        
+        //patch StartTransaction so it will DeAuthorize all txs
+        bool checkStartTx = false;
+        getOcppContext()->getOperationRegistry().registerOperation("StartTransaction", [&checkStartTx] () {
+            return new Ocpp16::CustomOperation("StartTransaction",
+                [&checkStartTx] (JsonObject) {
+                    checkStartTx = true;
+                },
+                [] () {
+                    //create conf
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            JSON_OBJECT_SIZE(2) + JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTagInfo"]["status"] = "Blocked";
+                    payload["transactionId"] = 1000;
+                    return doc;
+                });});
+        
+        //check resulting StatusNotification message
+        bool checkLocalListConflict = false;
+        getOcppContext()->getOperationRegistry().registerOperation("StatusNotification", [&checkLocalListConflict] () {
+            return new Ocpp16::CustomOperation("StatusNotification",
+                [&checkLocalListConflict] (JsonObject payload) {
+                    if (payload["connectorId"] == 0 &&
+                            !strcmp(payload["errorCode"] | "_Undefined", "LocalListConflict")) {
+                        checkLocalListConflict = true;
+                    }
+                }, 
+                [] () {
+                    //create conf
+                    return createEmptyDocument();
+                });});
+
+        //set local list
+        StaticJsonDocument<256> localAuthList;
+        localAuthList[0]["idTag"] = "mIdTag";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), 1, false);
+
+        //send Authorize and StartTx and check if they trigger LocalListConflict
+        beginTransaction("mIdTag");
+        loop();
+        REQUIRE( checkLocalListConflict );
+        REQUIRE( checkAuthorize );
+        REQUIRE( !checkStartTx );
+
+        checkLocalListConflict = false;
+        checkAuthorize = false;
+        beginTransaction_authorized("mIdTag");
+        loop();
+        REQUIRE( checkLocalListConflict );
+        REQUIRE( !checkAuthorize );
+        REQUIRE( checkStartTx );
+    }
+
+    SECTION("Update local list") {
+
+        REQUIRE( authService->getLocalListSize() == 0 ); //idle, empty local list
+
+        //set local list
+        int localListVersion = 42;
+        StaticJsonDocument<256> localAuthList;
+        localAuthList[0]["idTag"] = "mIdTag";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, false);
+        REQUIRE( authService->getLocalListVersion() == localListVersion );
+        REQUIRE( authService->getLocalListSize() == 1 );
+        REQUIRE( authService->getLocalAuthorization("mIdTag") != nullptr );
+
+        //overwrite list
+        localListVersion++;
+        localAuthList.clear();
+        localAuthList[0]["idTag"] = "mIdTag2";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, false);
+        REQUIRE( authService->getLocalListVersion() == localListVersion );
+        REQUIRE( authService->getLocalListSize() == 1 );
+        REQUIRE( authService->getLocalAuthorization("mIdTag") == nullptr );
+        REQUIRE( authService->getLocalAuthorization("mIdTag2") != nullptr );
+
+        //reset list
+        localListVersion++;
+        localAuthList.clear();
+        localAuthList.to<JsonArray>();
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, false);
+        REQUIRE( authService->getLocalListVersion() == 0 ); //localListVersion is ignored - empty list always resets version
+        REQUIRE( authService->getLocalListSize() == 0 );
+
+        //consecutive updates in Differential mode
+        localListVersion = 1;
+        localAuthList.clear();
+        localAuthList[0]["idTag"] = "mIdTag";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, true);
+        REQUIRE( authService->getLocalListVersion() == localListVersion );
+        REQUIRE( authService->getLocalListSize() == 1 );
+
+        //append further entry
+        localListVersion++;
+        localAuthList.clear();
+        localAuthList[0]["idTag"] = "mIdTag2";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, true);
+        REQUIRE( authService->getLocalListVersion() == localListVersion );
+        REQUIRE( authService->getLocalListSize() == 2 );
+
+        //overwrite previous entry
+        REQUIRE( authService->getLocalAuthorization("mIdTag")->getAuthorizationStatus() == AuthorizationStatus::Accepted );
+        localListVersion++;
+        localAuthList.clear();
+        localAuthList[0]["idTag"] = "mIdTag";
+        localAuthList[0]["idTagInfo"]["status"] = "Blocked";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, true);
+        REQUIRE( authService->getLocalListVersion() == localListVersion );
+        REQUIRE( authService->getLocalListSize() == 2 );
+        REQUIRE( authService->getLocalAuthorization("mIdTag")->getAuthorizationStatus() == AuthorizationStatus::Blocked );
+
+        //empty update keeps previous entries
+        localListVersion++;
+        localAuthList.clear();
+        localAuthList.to<JsonArray>();
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, true);
+        REQUIRE( authService->getLocalListVersion() == localListVersion );
+        REQUIRE( authService->getLocalListSize() == 2 );
+
+        //delete entries
+        localListVersion++;
+        localAuthList.clear();
+        localAuthList[0]["idTag"] = "mIdTag";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, true);
+        REQUIRE( authService->getLocalListVersion() == localListVersion );
+        REQUIRE( authService->getLocalListSize() == 1 );
+
+        localListVersion++;
+        localAuthList.clear();
+        localAuthList[0]["idTag"] = "mIdTag2";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, true);
+        REQUIRE( authService->getLocalListVersion() == 0 );
+        REQUIRE( authService->getLocalListSize() == 0 );
+    }
+
+    SECTION("LocalList persistency") {
+
+        int listVersion = 42;
+
+        StaticJsonDocument<512> localAuthList;
+        localAuthList[0]["idTag"] = "mIdTagMinimal";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        localAuthList[1]["idTag"] = "mIdTagFull";
+        localAuthList[1]["idTagInfo"]["expiryDate"] = BASE_TIME;
+        localAuthList[1]["idTagInfo"]["parentIdTag"] = "mParentIdTag";
+        localAuthList[1]["idTagInfo"]["status"] = "Blocked";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), listVersion, false);
+
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        authService = getOcppContext()->getModel().getAuthorizationService();
+
+        REQUIRE( authService->getLocalListVersion() == listVersion );
+        REQUIRE( authService->getLocalListSize() == 2 );
+        auto auth0 = authService->getLocalAuthorization("mIdTagMinimal");
+        REQUIRE( auth0 != nullptr );
+        REQUIRE( !strcmp(auth0->getIdTag(), "mIdTagMinimal") );
+        REQUIRE( auth0->getExpiryDate() == nullptr );
+        REQUIRE( auth0->getParentIdTag() == nullptr );
+        REQUIRE( auth0->getAuthorizationStatus() == AuthorizationStatus::Accepted );
+        
+        auto auth1 = authService->getLocalAuthorization("mIdTagFull");
+        REQUIRE( auth1 != nullptr );
+        REQUIRE( !strcmp(auth1->getIdTag(), "mIdTagFull") );
+        REQUIRE( auth1->getExpiryDate() != nullptr );
+        Timestamp baseTimeParsed;
+        baseTimeParsed.setTime(BASE_TIME);
+        REQUIRE( *auth1->getExpiryDate() == baseTimeParsed );
+        REQUIRE( !strcmp(auth1->getParentIdTag(), "mParentIdTag") );
+        REQUIRE( auth1->getAuthorizationStatus() == AuthorizationStatus::Blocked );
+    }
+
+    SECTION("SendLocalList") {
+
+        int listVersion = 42;
+        size_t listSize = 2;
+        std::string populatedEntryIdTag; //local auth list entry to be fully populated
+        
+        //Full update - happy path
+        bool checkAccepted = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("SendLocalList",
+                [&listVersion, &listSize, &populatedEntryIdTag] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            4096));
+                    auto payload = doc->to<JsonObject>();
+                    payload["listVersion"] = listVersion;
+                    generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSize, false);
+
+                    //fully populate first entry
+                    populatedEntryIdTag = payload["localAuthorizationList"][0]["idTag"] | "_Undefined";
+                    payload["localAuthorizationList"][0]["idTagInfo"]["expiryDate"] = BASE_TIME;
+                    payload["localAuthorizationList"][0]["idTagInfo"]["parentIdTag"] = "mParentIdTag";
+                    payload["localAuthorizationList"][0]["idTagInfo"]["status"] = "Blocked";
+                    payload["updateType"] = "Full";
+                    return doc;
+                },
+                [&checkAccepted] (JsonObject payload) {
+                    //process conf
+                    checkAccepted = !strcmp(payload["status"] | "_Undefined", "Accepted");
+                })));
+        
+        loop();
+        REQUIRE( authService->getLocalListVersion() == listVersion );
+        REQUIRE( authService->getLocalListSize() == listSize );
+        REQUIRE( !populatedEntryIdTag.empty() );
+        auto localAuth = authService->getLocalAuthorization(populatedEntryIdTag.c_str());
+        REQUIRE( localAuth != nullptr );
+        Timestamp baseTimeParsed;
+        baseTimeParsed.setTime(BASE_TIME);
+        REQUIRE( localAuth->getExpiryDate() );
+        REQUIRE( *localAuth->getExpiryDate() == baseTimeParsed );
+        REQUIRE( !strcmp(localAuth->getIdTag(), populatedEntryIdTag.c_str()) );
+        REQUIRE( !strcmp(localAuth->getParentIdTag(), "mParentIdTag") );
+        REQUIRE( localAuth->getAuthorizationStatus() == AuthorizationStatus::Blocked );
+        REQUIRE( checkAccepted );
+
+        //Differential update - happy path
+        listVersion++;
+        listSize++; //add one extra entry and update all others
+
+        checkAccepted = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("SendLocalList",
+                [&listVersion, &listSize] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            1024));
+                    auto payload = doc->to<JsonObject>();
+                    payload["listVersion"] = listVersion;
+                    generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSize, false);
+                    payload["updateType"] = "Differential";
+                    return doc;
+                },
+                [&checkAccepted] (JsonObject payload) {
+                    //process conf
+                    checkAccepted = !strcmp(payload["status"] | "_Undefined", "Accepted");
+                })));
+        
+        loop();
+        REQUIRE( authService->getLocalListVersion() == listVersion );
+        REQUIRE( authService->getLocalListSize() == listSize );
+        REQUIRE( checkAccepted );
+
+        //Differential update - version mismatch
+        size_t listSizeInvalid = listSize + 1;
+
+        bool checkVersionMismatch = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("SendLocalList",
+                [&listVersion, &listSizeInvalid] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            1024));
+                    auto payload = doc->to<JsonObject>();
+                    payload["listVersion"] = listVersion;
+                    generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSizeInvalid, false);
+                    payload["updateType"] = "Differential";
+                    return doc;
+                },
+                [&checkVersionMismatch] (JsonObject payload) {
+                    //process conf
+                    checkVersionMismatch = !strcmp(payload["status"] | "_Undefined", "VersionMismatch");
+                })));
+        
+        loop();
+        REQUIRE( authService->getLocalListVersion() == listVersion );
+        REQUIRE( authService->getLocalListSize() == listSize );
+        REQUIRE( checkVersionMismatch );
+
+        //Boundary check - maximum entries per SendLocalList
+        listVersion = 42;
+        listSize = (size_t) declareConfiguration<int>("SendLocalListMaxLength", -1)->getInt();
+
+        checkAccepted = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("SendLocalList",
+                [&listVersion, &listSize] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            4096));
+                    auto payload = doc->to<JsonObject>();
+                    payload["listVersion"] = listVersion;
+                    generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSize, false);
+                    payload["updateType"] = "Full";
+                    return doc;
+                },
+                [&checkAccepted] (JsonObject payload) {
+                    //process conf
+                    checkAccepted = !strcmp(payload["status"] | "_Undefined", "Accepted");
+                })));
+        
+        loop();
+        REQUIRE( authService->getLocalListVersion() == listVersion );
+        REQUIRE( authService->getLocalListSize() == listSize );
+        REQUIRE( checkAccepted );
+
+        //Boundary check - maximum entries per SendLocalList in Differential mode
+        listVersion++;
+
+        checkAccepted = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("SendLocalList",
+                [&listVersion, &listSize] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            4096));
+                    auto payload = doc->to<JsonObject>();
+                    payload["listVersion"] = listVersion;
+                    generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSize, false);
+                    payload["updateType"] = "Differential";
+                    return doc;
+                },
+                [&checkAccepted] (JsonObject payload) {
+                    //process conf
+                    checkAccepted = !strcmp(payload["status"] | "_Undefined", "Accepted");
+                })));
+        
+        loop();
+        REQUIRE( authService->getLocalListVersion() == listVersion );
+        REQUIRE( authService->getLocalListSize() == listSize );
+        REQUIRE( checkAccepted );
+
+        //Boundary check - exceed maximum entries per SendLocalList
+        int listVersionInvalid = listVersion + 1;
+        listSizeInvalid = listSize + 1;
+
+        bool errOccurence = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("SendLocalList",
+                [&listVersionInvalid, &listSizeInvalid] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            4096));
+                    auto payload = doc->to<JsonObject>();
+                    payload["listVersion"] = listVersionInvalid;
+                    generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSizeInvalid, false);
+                    payload["updateType"] = "Full";
+                    return doc;
+                },
+                [] (JsonObject) { }, //ignore conf
+                [&errOccurence] (const char *errorCode, const char*, JsonObject) {
+                    errOccurence = !strcmp(errorCode, "OccurenceConstraintViolation");
+                    return true;
+                })));
+        
+        loop();
+        REQUIRE( authService->getLocalListVersion() == listVersion );
+        REQUIRE( authService->getLocalListSize() == listSize );
+        REQUIRE( errOccurence );
+
+        //Boundary check - exceed maximum local list size by multiple Differerntial updates
+
+        //clear local list
+        StaticJsonDocument<64> emptyDoc;
+        emptyDoc.to<JsonArray>();
+        authService->updateLocalList(emptyDoc.as<JsonArray>(), 1, false);
+
+        size_t localAuthListMaxLength = (size_t) declareConfiguration<int>("LocalAuthListMaxLength", -1)->getInt();
+
+        //send Differential lists with 2 entries: update an existing entry and add a new entry
+        for (size_t i = 1; i < localAuthListMaxLength; i++) {
+            //Full update - happy path
+            bool checkAccepted = false;
+            getOcppContext()->initiateRequest(makeRequest(
+                new Ocpp16::CustomOperation("SendLocalList",
+                    [&i] () {
+                        //create req
+                        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                                1024));
+                        auto payload = doc->to<JsonObject>();
+                        payload["listVersion"] = (int) i;
+
+                        char buf [IDTAG_LEN_MAX + 1];
+                        sprintf(buf, "mIdTag%zu", i-1);
+                        payload["localAuthorizationList"][0]["idTag"] = buf;
+                        payload["localAuthorizationList"][0]["idTagInfo"]["status"] = "Accepted";
+
+                        sprintf(buf, "mIdTag%zu", i);
+                        payload["localAuthorizationList"][1]["idTag"] = buf;
+                        payload["localAuthorizationList"][1]["idTagInfo"]["status"] = "Accepted";
+
+                        payload["updateType"] = "Differential";
+                        return doc;
+                    },
+                    [&checkAccepted] (JsonObject payload) {
+                        //process conf
+                        checkAccepted = !strcmp(payload["status"] | "_Undefined", "Accepted");
+                    })));
+            
+            loop();
+            REQUIRE( authService->getLocalListVersion() == i );
+            REQUIRE( authService->getLocalListSize() == i + 1 );
+            REQUIRE( checkAccepted );
+        }
+
+        //now exceed local list by sending overflow entry
+        listVersion = authService->getLocalListVersion();
+        listVersionInvalid = listVersion + 1;
+        listSize = authService->getLocalListSize();
+
+        bool checkFailed = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("SendLocalList",
+                [&listVersionInvalid] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            1024));
+                    auto payload = doc->to<JsonObject>();
+                    payload["listVersion"] = listVersionInvalid;
+
+                    //update already existing entry
+                    char buf [IDTAG_LEN_MAX + 1];
+                    sprintf(buf, "mIdTag%zu", 0UL);
+                    payload["localAuthorizationList"][0]["idTag"] = buf;
+                    payload["localAuthorizationList"][0]["idTagInfo"]["status"] = "Accepted";
+
+                    //additional overflowing entry
+                    payload["localAuthorizationList"][1]["idTag"] = "overflow idTag";
+                    payload["localAuthorizationList"][1]["idTagInfo"]["status"] = "Accepted";
+
+                    payload["updateType"] = "Differential";
+                    return doc;
+                },
+                [&checkFailed] (JsonObject payload) {
+                    //process conf
+                    checkFailed = !strcmp(payload["status"] | "_Undefined", "Failed");
+                })));
+        loop();
+        REQUIRE( authService->getLocalListVersion() == listVersion );
+        REQUIRE( authService->getLocalListSize() == listSize );
+        REQUIRE( checkFailed );
+    }
+
+    SECTION("GetLocalListVersion") {
+
+        int localListVersion = 42;
+        StaticJsonDocument<256> localAuthList;
+        localAuthList[0]["idTag"] = "mIdTag";
+        localAuthList[0]["idTagInfo"]["status"] = "Accepted";
+        authService->updateLocalList(localAuthList.as<JsonArray>(), localListVersion, false);
+
+        int checkListVerion = -1;
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("GetLocalListVersion",
+                [] () {
+                    //create req
+                    return createEmptyDocument();
+                },
+                [&checkListVerion] (JsonObject payload) {
+                    //process conf
+                    checkListVerion = payload["listVersion"] | -1;
+                })));
+
+        loop();
+        REQUIRE( checkListVerion == localListVersion );
+    }
+
+    mocpp_deinitialize();
+}

From 74e13dc2874227fb5945a6fa22abc471a1718145 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 17 Oct 2023 21:18:05 +0200
Subject: [PATCH 405/549] add auto recovery switch

---
 src/MicroOcpp.cpp | 11 ++++++-----
 src/MicroOcpp.h   |  6 ++++--
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 6ed3fbd7..2e53f855 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -28,6 +28,7 @@
 #include <MicroOcpp/Operations/CustomOperation.h>
 
 #include <MicroOcpp/Debug.h>
+#include <MicroOcpp/Version.h>
 
 namespace MicroOcpp {
 namespace Facade {
@@ -55,7 +56,7 @@ using namespace MicroOcpp::Facade;
 using namespace MicroOcpp::Ocpp16;
 
 #ifndef MOCPP_CUSTOM_WS
-void mocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt, const char *login, const char *password, const char *CA_cert) {
+void mocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt, const char *login, const char *password, const char *CA_cert, bool autoRecover) {
     if (context) {
         MOCPP_DBG_WARN("Can't be called two times. Either restart ESP, or call mocpp_deinitialize() before");
         return;
@@ -92,7 +93,7 @@ void mocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_
     delete connection;
     connection = new EspWiFi::WSClient(webSocket);
 
-    mocpp_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), makeDefaultFilesystemAdapter(fsOpt));
+    mocpp_initialize(*connection, ChargerCredentials(chargePointModel, chargePointVendor), makeDefaultFilesystemAdapter(fsOpt), autoRecover);
 }
 #endif
 
@@ -130,7 +131,7 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
     }
 }
 
-void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs) {
+void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs, bool autoRecover) {
     if (context) {
         MOCPP_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call mocpp_deinitialize() before");
         return;
@@ -144,7 +145,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     BootStats bootstats;
     BootService::loadBootStats(filesystem, bootstats);
 
-    if (bootstats.getBootFailureCount() > 3) {
+    if (autoRecover && bootstats.getBootFailureCount() > 3) {
         MOCPP_DBG_ERR("multiple initialization failures detected");
         if (filesystem) {
             bool success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
@@ -162,7 +163,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
 
     bootstats.bootNr++; //assign new boot number to this run
     BootService::storeBootStats(filesystem, bootstats);
-    
+
     configuration_init(filesystem); //call before each other library call
 
     context = new Context(connection, filesystem, bootstats.bootNr);
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 1db7588c..f63f039e 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -48,7 +48,8 @@ void mocpp_initialize(
             MicroOcpp::FilesystemOpt fsOpt = MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
             const char *login = "", //login present in the websocket message header
             const char *password = "", //password present in the websocket message header
-            const char *CA_cert = NULL); //TLS certificate
+            const char *CA_cert = NULL, //TLS certificate
+            bool autoRecover = false); //automatically sanitize the local data store when the lib detects recurring crashes. Not recommended during development
 #endif
 
 /*
@@ -94,7 +95,8 @@ void mocpp_initialize(
             MicroOcpp::Connection& connection, //WebSocket adapter for MicroOcpp
             const char *bootNotificationCredentials = ChargerCredentials("Demo Charger", "My Company Ltd."), //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             std::shared_ptr<MicroOcpp::FilesystemAdapter> filesystem =
-                MicroOcpp::makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail)); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+                MicroOcpp::makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail), //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            bool autoRecover = false); //automatically sanitize the local data store when the lib detects recurring crashes. Not recommended during development
 
 /*
  * Stop the OCPP library and release allocated resources.

From c334e5f75b5112c2547a43930a2959ca99af4d3b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 17 Oct 2023 22:03:35 +0200
Subject: [PATCH 406/549] add version specifier

---
 src/MicroOcpp/Version.h | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 src/MicroOcpp/Version.h

diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
new file mode 100644
index 00000000..28626b49
--- /dev/null
+++ b/src/MicroOcpp/Version.h
@@ -0,0 +1 @@
+#define MOCPP_VERSION "0.4.0"

From a532509d9a86ccad65d44242747e052acbe4dd53 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 17 Oct 2023 22:17:07 +0200
Subject: [PATCH 407/549] more concise Configuration function names

---
 src/MicroOcpp/Core/Configuration.cpp          |  4 ++--
 src/MicroOcpp/Core/ConfigurationContainer.cpp |  6 ++---
 src/MicroOcpp/Core/ConfigurationContainer.h   | 10 ++++----
 .../Core/ConfigurationContainerFlash.cpp      |  6 ++---
 src/MicroOcpp/Operations/GetConfiguration.cpp |  2 +-
 tests/Configuration.cpp                       | 24 +++++++++----------
 6 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index 25efaa1e..24a64287 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -90,7 +90,7 @@ std::shared_ptr<Configuration> loadConfiguration(TConfig type, const char *key,
         if (auto config = container->getConfiguration(key)) {
             if (config->getType() != type) {
                 MOCPP_DBG_ERR("conflicting type for %s - remove old config", key);
-                container->removeConfiguration(config.get());
+                container->remove(config.get());
                 continue;
             }
             if (container->isAccessible() != accessible) {
@@ -150,7 +150,7 @@ std::shared_ptr<Configuration> declareConfiguration(const char *key, T factoryDe
         }
 
         if (!loadFactoryDefault(*res.get(), factoryDef)) {
-            container->removeConfiguration(res.get());
+            container->remove(res.get());
             return nullptr;
         }
     }
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index 3a26879b..56f3462e 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -35,7 +35,7 @@ std::shared_ptr<Configuration> ConfigurationContainerVolatile::createConfigurati
     return res;
 }
 
-void ConfigurationContainerVolatile::removeConfiguration(Configuration *config) {
+void ConfigurationContainerVolatile::remove(Configuration *config) {
     for (auto entry = configurations.begin(); entry != configurations.end();) {
         if (entry->get() == config) {
             entry = configurations.erase(entry);
@@ -45,7 +45,7 @@ void ConfigurationContainerVolatile::removeConfiguration(Configuration *config)
     }
 }
 
-size_t ConfigurationContainerVolatile::getConfigurationCount() {
+size_t ConfigurationContainerVolatile::size() {
     return configurations.size();
 }
 
@@ -62,7 +62,7 @@ std::shared_ptr<Configuration> ConfigurationContainerVolatile::getConfiguration(
     return nullptr;
 }
 
-void ConfigurationContainerVolatile::addConfiguration(std::shared_ptr<Configuration> c) {
+void ConfigurationContainerVolatile::add(std::shared_ptr<Configuration> c) {
     configurations.push_back(std::move(c));
 }
 
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index f771fa64..52804e3b 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -28,9 +28,9 @@ class ConfigurationContainer {
     virtual bool save() = 0;
 
     virtual std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) = 0;
-    virtual void removeConfiguration(Configuration *config) = 0;
+    virtual void remove(Configuration *config) = 0;
 
-    virtual size_t getConfigurationCount() = 0;
+    virtual size_t size() = 0;
     virtual Configuration *getConfiguration(size_t i) = 0;
     virtual std::shared_ptr<Configuration> getConfiguration(const char *key) = 0;
 
@@ -47,13 +47,13 @@ class ConfigurationContainerVolatile : public ConfigurationContainer {
     bool load() override;
     bool save() override;
     std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) override;
-    void removeConfiguration(Configuration *config) override;
-    size_t getConfigurationCount() override;
+    void remove(Configuration *config) override;
+    size_t size() override;
     Configuration *getConfiguration(size_t i) override;
     std::shared_ptr<Configuration> getConfiguration(const char *key) override;
 
     //add custom Configuration object
-    void addConfiguration(std::shared_ptr<Configuration> c);
+    void add(std::shared_ptr<Configuration> c);
 };
 
 std::unique_ptr<ConfigurationContainerVolatile> makeConfigurationContainerVolatile(const char *filename, bool accessible);
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index 32caf4fb..e587472d 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -116,7 +116,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
             auto config = getConfiguration(key).get();
             if (config && config->getType() != type) {
                 MOCPP_DBG_ERR("conflicting type for %s - remove old config", key);
-                removeConfiguration(config);
+                remove(config);
                 config = nullptr;
             }
             if (!config) {
@@ -278,7 +278,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         return res;
     }
 
-    void removeConfiguration(Configuration *config) override {
+    void remove(Configuration *config) override {
         const char *key = config->getKey();
         configurations.erase(std::remove_if(configurations.begin(), configurations.end(),
             [config] (std::shared_ptr<Configuration>& entry) {
@@ -289,7 +289,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         }
     }
 
-    size_t getConfigurationCount() override {
+    size_t size() override {
         return configurations.size();
     }
 
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index 3b75f50f..67b27d30 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -34,7 +34,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
     if (keys.empty()) {
         //return all existing keys
         for (auto container : containers) {
-            for (size_t i = 0; i < container->getConfigurationCount(); i++) {
+            for (size_t i = 0; i < container->size(); i++) {
                 if (!container->getConfiguration(i)->getKey()) {
                     MOCPP_DBG_ERR("invalid config");
                     continue;
diff --git a/tests/Configuration.cpp b/tests/Configuration.cpp
index a392b472..4a078079 100644
--- a/tests/Configuration.cpp
+++ b/tests/Configuration.cpp
@@ -43,11 +43,11 @@ TEST_CASE( "Configuration" ) {
         }
 
         //check emptyness
-        REQUIRE( container->getConfigurationCount() == 0 );
+        REQUIRE( container->size() == 0 );
 
         //add first config, fetch by index
         auto configFirst = container->createConfiguration(TConfig::Int, "cFirst");
-        REQUIRE( container->getConfigurationCount() == 1 );
+        REQUIRE( container->size() == 1 );
         REQUIRE( container->getConfiguration((size_t) 0) == configFirst.get());
 
         //add one config of each type
@@ -55,21 +55,21 @@ TEST_CASE( "Configuration" ) {
         auto cBool = container->createConfiguration(TConfig::Bool, "cBool");
         auto cString = container->createConfiguration(TConfig::String, "cString");
         
-        REQUIRE( container->getConfigurationCount() == 4 );
+        REQUIRE( container->size() == 4 );
 
         //fetch config by key
         REQUIRE( container->getConfiguration(cBool->getKey()) == cBool);
 
         //remove config
-        container->removeConfiguration(cBool.get());
-        REQUIRE( container->getConfigurationCount() == 3 );
+        container->remove(cBool.get());
+        REQUIRE( container->size() == 3 );
         REQUIRE( container->getConfiguration(cBool->getKey()) == nullptr);
 
         //clean container
-        container->removeConfiguration(container->getConfiguration((size_t) 0));
-        container->removeConfiguration(container->getConfiguration((size_t) 0));
-        container->removeConfiguration(container->getConfiguration((size_t) 0));
-        REQUIRE( container->getConfigurationCount() == 0 );
+        container->remove(container->getConfiguration((size_t) 0));
+        container->remove(container->getConfiguration((size_t) 0));
+        container->remove(container->getConfiguration((size_t) 0));
+        REQUIRE( container->size() == 0 );
     }
 
     SECTION("Persistency on filesystem") {
@@ -78,7 +78,7 @@ TEST_CASE( "Configuration" ) {
 
         //trivial load call
         REQUIRE( container->load() );
-        REQUIRE( container->getConfigurationCount() == 0 );
+        REQUIRE( container->size() == 0 );
 
         //add config, store, load again
         auto cString = container->createConfiguration(TConfig::String, "cString");
@@ -90,9 +90,9 @@ TEST_CASE( "Configuration" ) {
 
         //...load again
         auto container2 = makeConfigurationContainerFlash(filesystem, MOCPP_FILENAME_PREFIX "persistent1.jsn", true);
-        REQUIRE( container2->getConfigurationCount() == 0 );
+        REQUIRE( container2->size() == 0 );
         REQUIRE( container2->load() );
-        REQUIRE( container2->getConfigurationCount() == 1 );
+        REQUIRE( container2->size() == 1 );
 
         auto cString2 = container2->getConfiguration("cString");
         REQUIRE( cString2 != nullptr );

From fb9a027f7f348eb7a2ed852a71fea69812e40806 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 17 Oct 2023 22:21:47 +0200
Subject: [PATCH 408/549] change MOCPP_ into MO_

---
 .github/workflows/platformless.yml            |   2 +-
 CMakeLists.txt                                |  50 ++---
 docs/migration.md                             |   4 +-
 examples/ESP-IDF/CMakeLists.txt               |   4 +-
 examples/ESP-IDF/main/Kconfig.projbuild       |   6 +-
 examples/ESP-IDF/main/main.c                  |  12 +-
 examples/ESP-IDF/sdkconfig                    |   6 +-
 platformio.ini                                |   8 +-
 src/MicroOcpp.cpp                             | 210 +++++++++---------
 src/MicroOcpp.h                               |   6 +-
 src/MicroOcpp/Core/Configuration.cpp          |  10 +-
 src/MicroOcpp/Core/Configuration.h            |   4 +-
 src/MicroOcpp/Core/ConfigurationContainer.cpp |   2 +-
 .../Core/ConfigurationContainerFlash.cpp      |  48 ++--
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp  |  34 +--
 src/MicroOcpp/Core/ConfigurationKeyValue.h    |   6 +-
 src/MicroOcpp/Core/Connection.cpp             |  16 +-
 src/MicroOcpp/Core/Connection.h               |  16 +-
 src/MicroOcpp/Core/Context.h                  |   4 +-
 src/MicroOcpp/Core/FilesystemAdapter.cpp      | 104 ++++-----
 src/MicroOcpp/Core/FilesystemAdapter.h        |  38 ++--
 src/MicroOcpp/Core/FilesystemUtils.cpp        |  48 ++--
 src/MicroOcpp/Core/FilesystemUtils.h          |   4 +-
 src/MicroOcpp/Core/Operation.cpp              |  10 +-
 src/MicroOcpp/Core/Operation.h                |   4 +-
 src/MicroOcpp/Core/OperationRegistry.cpp      |   8 +-
 src/MicroOcpp/Core/OperationRegistry.h        |   4 +-
 src/MicroOcpp/Core/PollResult.h               |   4 +-
 src/MicroOcpp/Core/Request.cpp                |  28 +--
 src/MicroOcpp/Core/Request.h                  |   4 +-
 src/MicroOcpp/Core/RequestCallbacks.h         |   4 +-
 src/MicroOcpp/Core/RequestQueue.cpp           |  36 +--
 src/MicroOcpp/Core/RequestQueue.h             |   4 +-
 .../Core/RequestQueueStorageStrategy.cpp      |  26 +--
 src/MicroOcpp/Core/RequestStore.cpp           |  94 ++++----
 src/MicroOcpp/Core/RequestStore.h             |   6 +-
 src/MicroOcpp/Core/SimpleRequestFactory.h     |   4 +-
 src/MicroOcpp/Core/Time.h                     |   4 +-
 src/MicroOcpp/Debug.h                         | 120 +++++-----
 .../Model/Authorization/AuthorizationList.cpp |   4 +-
 .../Model/Authorization/AuthorizationList.h   |   8 +-
 .../Authorization/AuthorizationService.cpp    |  32 +--
 src/MicroOcpp/Model/Boot/BootService.cpp      |  32 +--
 src/MicroOcpp/Model/Boot/BootService.h        |   4 +-
 .../ConnectorBase/ChargePointErrorData.h      |   4 +-
 .../Model/ConnectorBase/Connector.cpp         | 114 +++++-----
 src/MicroOcpp/Model/ConnectorBase/Connector.h |   2 +-
 .../Model/ConnectorBase/Notification.h        |   4 +-
 .../Model/Diagnostics/DiagnosticsService.cpp  |  20 +-
 .../Model/Diagnostics/DiagnosticsService.h    |   4 +-
 .../FirmwareManagement/FirmwareService.cpp    |  50 ++---
 .../FirmwareManagement/FirmwareService.h      |   4 +-
 src/MicroOcpp/Model/Metering/MeterStore.cpp   |  86 +++----
 src/MicroOcpp/Model/Metering/MeterValue.cpp   |   8 +-
 .../Model/Metering/MeteringConnector.cpp      |  14 +-
 .../Model/Metering/MeteringService.cpp        |  24 +-
 src/MicroOcpp/Model/Metering/SampledValue.cpp |   8 +-
 src/MicroOcpp/Model/Model.cpp                 |   6 +-
 src/MicroOcpp/Model/Model.h                   |   4 +-
 .../Model/Reservation/Reservation.cpp         |  12 +-
 src/MicroOcpp/Model/Reservation/Reservation.h |  22 +-
 .../Model/Reservation/ReservationService.cpp  |  12 +-
 src/MicroOcpp/Model/Reset/ResetService.cpp    |  14 +-
 src/MicroOcpp/Model/Reset/ResetService.h      |   4 +-
 .../SmartCharging/SmartChargingModel.cpp      |  48 ++--
 .../SmartCharging/SmartChargingService.cpp    |  58 ++---
 .../Transactions/TransactionDeserialize.cpp   |  28 +--
 .../Model/Transactions/TransactionStore.cpp   |  96 ++++----
 .../Model/Transactions/TransactionStore.h     |  12 +-
 src/MicroOcpp/Operations/Authorize.cpp        |   6 +-
 src/MicroOcpp/Operations/BootNotification.cpp |   8 +-
 .../Operations/ChangeConfiguration.cpp        |  14 +-
 src/MicroOcpp/Operations/ClearCache.cpp       |   2 +-
 src/MicroOcpp/Operations/CustomOperation.h    |   4 +-
 src/MicroOcpp/Operations/DataTransfer.cpp     |   4 +-
 src/MicroOcpp/Operations/GetConfiguration.cpp |  12 +-
 src/MicroOcpp/Operations/GetDiagnostics.cpp   |   4 +-
 src/MicroOcpp/Operations/Heartbeat.cpp        |   6 +-
 src/MicroOcpp/Operations/MeterValues.cpp      |   4 +-
 .../Operations/RemoteStartTransaction.cpp     |   4 +-
 src/MicroOcpp/Operations/ReserveNow.cpp       |   4 +-
 src/MicroOcpp/Operations/Reset.cpp            |   2 +-
 src/MicroOcpp/Operations/SendLocalList.cpp    |   2 +-
 src/MicroOcpp/Operations/StartTransaction.cpp |  22 +-
 .../Operations/StatusNotification.cpp         |   6 +-
 src/MicroOcpp/Operations/StopTransaction.cpp  |  24 +-
 src/MicroOcpp/Operations/TriggerMessage.cpp   |   2 +-
 src/MicroOcpp/Operations/UnlockConnector.cpp  |   6 +-
 src/MicroOcpp/Operations/UpdateFirmware.cpp   |   2 +-
 src/MicroOcpp/Platform.cpp                    |   8 +-
 src/MicroOcpp/Platform.h                      |  74 +++---
 src/MicroOcpp/Version.h                       |   2 +-
 src/MicroOcpp_c.cpp                           |  26 +--
 src/MicroOcpp_c.h                             |   2 +-
 tests/Api.cpp                                 |   8 +-
 tests/ChargingSessions.cpp                    |  10 +-
 tests/Configuration.cpp                       |  18 +-
 tests/ConfigurationBehavior.cpp               |   6 +-
 tests/LocalAuthList.cpp                       |   2 +-
 tests/Metering.cpp                            |   6 +-
 tests/TransactionSafety.cpp                   |  14 +-
 101 files changed, 1027 insertions(+), 1027 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index e7a17ace..1e461d48 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -26,4 +26,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DMOCPP_PLATFORM=MOCPP_PLATFORM_NONE -Wall
+      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DMO_PLATFORM=MO_PLATFORM_NONE -Wall
diff --git a/CMakeLists.txt b/CMakeLists.txt
index f3ec28bb..95810e11 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -5,7 +5,7 @@
 cmake_minimum_required(VERSION 3.15)
 
 
-set(MOCPP_SRC
+set(MO_SRC
     src/MicroOcpp/Core/Configuration.cpp
     src/MicroOcpp/Core/ConfigurationContainer.cpp
     src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -82,15 +82,15 @@ set(MOCPP_SRC
 
 if(ESP_PLATFORM)
 
-    idf_component_register(SRCS ${MOCPP_SRC}
+    idf_component_register(SRCS ${MO_SRC}
                         INCLUDE_DIRS "./src" "../ArduinoJson/src"
                         PRIV_REQUIRES spiffs)
 
     target_compile_options(${COMPONENT_TARGET} PUBLIC
-        -DMOCPP_PLATFORM=MOCPP_PLATFORM_ESPIDF
-        -DMOCPP_CUSTOM_WS
-        -DMOCPP_CUSTOM_UPDATER
-        -DMOCPP_CUSTOM_RESET
+        -DMO_PLATFORM=MO_PLATFORM_ESPIDF
+        -DMO_CUSTOM_WS
+        -DMO_CUSTOM_UPDATER
+        -DMO_CUSTOM_RESET
         )
 
     return()
@@ -99,7 +99,7 @@ endif()
 project(MicroOcpp
         VERSION 0.2.0)
 
-add_library(MicroOcpp ${MOCPP_SRC})
+add_library(MicroOcpp ${MO_SRC})
 
 target_include_directories(MicroOcpp PUBLIC
     "./src"
@@ -107,15 +107,15 @@ target_include_directories(MicroOcpp PUBLIC
 )
 
 target_compile_definitions(MicroOcpp PUBLIC
-    MOCPP_PLATFORM=MOCPP_PLATFORM_UNIX
-    MOCPP_CUSTOM_WS
-    MOCPP_CUSTOM_UPDATER
-    MOCPP_CUSTOM_RESET
+    MO_PLATFORM=MO_PLATFORM_UNIX
+    MO_CUSTOM_WS
+    MO_CUSTOM_UPDATER
+    MO_CUSTOM_RESET
 )
 
 # Unit tests
 
-set(MOCPP_SRC_UNIT
+set(MO_SRC_UNIT
     tests/helpers/testHelper.cpp
     tests/ocppEngineLifecycle.cpp
     tests/TransactionSafety.cpp
@@ -130,8 +130,8 @@ set(MOCPP_SRC_UNIT
 )
 
 add_executable(mo_unit_tests
-    ${MOCPP_SRC}
-    ${MOCPP_SRC_UNIT}
+    ${MO_SRC}
+    ${MO_SRC_UNIT}
     ./tests/catch2/catchMain.cpp
 )
 
@@ -142,17 +142,17 @@ target_include_directories(mo_unit_tests PUBLIC
 )
 
 target_compile_definitions(mo_unit_tests PUBLIC
-    MOCPP_PLATFORM=MOCPP_PLATFORM_UNIX
-    MOCPP_NUMCONNECTORS=3
-    MOCPP_CUSTOM_TIMER
-    MOCPP_CUSTOM_WS
-    MOCPP_CUSTOM_UPDATER
-    MOCPP_CUSTOM_RESET
-    MOCPP_DBG_LEVEL=MOCPP_DL_DEBUG
-    MOCPP_TRAFFIC_OUT
-    MOCPP_FILENAME_PREFIX="./mo_store/"
-    MOCPP_LocalAuthListMaxLength=8
-    MOCPP_SendLocalListMaxLength=4
+    MO_PLATFORM=MO_PLATFORM_UNIX
+    MO_NUMCONNECTORS=3
+    MO_CUSTOM_TIMER
+    MO_CUSTOM_WS
+    MO_CUSTOM_UPDATER
+    MO_CUSTOM_RESET
+    MO_DBG_LEVEL=MO_DL_DEBUG
+    MO_TRAFFIC_OUT
+    MO_FILENAME_PREFIX="./mo_store/"
+    MO_LocalAuthListMaxLength=8
+    MO_SendLocalListMaxLength=4
 )
 
 target_compile_options(mo_unit_tests PUBLIC
diff --git a/docs/migration.md b/docs/migration.md
index 81fd4b73..fed7bd10 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -13,8 +13,8 @@ If using the C-facade (skip if you don't use anything from *ArduinoOcpp_c.h*):
 Change this in any case:
 
 - `ArduinoOcpp` to `MicroOcpp`
-- `"AO_` to `"Cst_` (define build flag `MOCPP_CONFIG_EXT_PREFIX="AO_"` to keep old config keys)
-- `AO_` to `MOCPP_`
+- `"AO_` to `"Cst_` (define build flag `MO_CONFIG_EXT_PREFIX="AO_"` to keep old config keys)
+- `AO_` to `MO_`
 - `ocpp_` to `mocpp_`
 
 Change this if used anywhere:
diff --git a/examples/ESP-IDF/CMakeLists.txt b/examples/ESP-IDF/CMakeLists.txt
index bb1869c5..63fe414b 100644
--- a/examples/ESP-IDF/CMakeLists.txt
+++ b/examples/ESP-IDF/CMakeLists.txt
@@ -5,5 +5,5 @@ cmake_minimum_required(VERSION 3.5)
 include($ENV{IDF_PATH}/tools/cmake/project.cmake)
 project(mo_example)
 
-idf_build_set_property(COMPILE_OPTIONS -DMOCPP_TRAFFIC_OUT APPEND)
-idf_build_set_property(COMPILE_OPTIONS -DMOCPP_FILENAME_PREFIX="/mo_store/" APPEND)
+idf_build_set_property(COMPILE_OPTIONS -DMO_TRAFFIC_OUT APPEND)
+idf_build_set_property(COMPILE_OPTIONS -DMO_FILENAME_PREFIX="/mo_store/" APPEND)
diff --git a/examples/ESP-IDF/main/Kconfig.projbuild b/examples/ESP-IDF/main/Kconfig.projbuild
index 1bc06e45..32aa3a1e 100644
--- a/examples/ESP-IDF/main/Kconfig.projbuild
+++ b/examples/ESP-IDF/main/Kconfig.projbuild
@@ -18,19 +18,19 @@ menu "Example Configuration"
         help
             Set the Maximum retry to avoid station reconnecting to the AP unlimited when the AP is really inexistent.
     
-    config MOCPP_OCPP_BACKEND
+    config MO_OCPP_BACKEND
         string "OCPP backend URL"
         default "ws://echo.websocket.events/"
         help
             URL of the OCPP backend
     
-    config MOCPP_CHARGEBOXID
+    config MO_CHARGEBOXID
         string "ChargeBoxId"
         default ""
         help
             ChargeBoxId as it appears in the WebSocket connection URL
 
-    config MOCPP_AUTHORIZATIONKEY
+    config MO_AUTHORIZATIONKEY
         string "Authorization Key"
         default ""
         help
diff --git a/examples/ESP-IDF/main/main.c b/examples/ESP-IDF/main/main.c
index 60e6e355..ea961913 100644
--- a/examples/ESP-IDF/main/main.c
+++ b/examples/ESP-IDF/main/main.c
@@ -29,9 +29,9 @@
 #define EXAMPLE_ESP_WIFI_SSID      CONFIG_ESP_WIFI_SSID
 #define EXAMPLE_ESP_WIFI_PASS      CONFIG_ESP_WIFI_PASSWORD
 #define EXAMPLE_ESP_MAXIMUM_RETRY  CONFIG_ESP_MAXIMUM_RETRY
-#define EXAMPLE_MOCPP_OCPP_BACKEND    CONFIG_MOCPP_OCPP_BACKEND
-#define EXAMPLE_MOCPP_CHARGEBOXID     CONFIG_MOCPP_CHARGEBOXID
-#define EXAMPLE_MOCPP_AUTHORIZATIONKEY CONFIG_MOCPP_AUTHORIZATIONKEY
+#define EXAMPLE_MO_OCPP_BACKEND    CONFIG_MO_OCPP_BACKEND
+#define EXAMPLE_MO_CHARGEBOXID     CONFIG_MO_CHARGEBOXID
+#define EXAMPLE_MO_AUTHORIZATIONKEY CONFIG_MO_AUTHORIZATIONKEY
 
 /* FreeRTOS event group to signal when we are connected*/
 static EventGroupHandle_t s_wifi_event_group;
@@ -157,9 +157,9 @@ void app_main(void)
     struct OCPP_FilesystemOpt fsopt = { .use = true, .mount = true, .formatFsOnFail = true};
 
     OCPP_Connection *osock = ocpp_makeConnection(&mgr,
-            EXAMPLE_MOCPP_OCPP_BACKEND, 
-            EXAMPLE_MOCPP_CHARGEBOXID, 
-            EXAMPLE_MOCPP_AUTHORIZATIONKEY, "", fsopt);
+            EXAMPLE_MO_OCPP_BACKEND, 
+            EXAMPLE_MO_CHARGEBOXID, 
+            EXAMPLE_MO_AUTHORIZATIONKEY, "", fsopt);
     ocpp_initialize(osock, "ESP-IDF charger", "Your brand name here", fsopt);
 
     /* Enter infinite loop */
diff --git a/examples/ESP-IDF/sdkconfig b/examples/ESP-IDF/sdkconfig
index 1cab0a8c..52bcb0b6 100644
--- a/examples/ESP-IDF/sdkconfig
+++ b/examples/ESP-IDF/sdkconfig
@@ -137,9 +137,9 @@ CONFIG_PARTITION_TABLE_MD5=y
 CONFIG_ESP_WIFI_SSID="myssid"
 CONFIG_ESP_WIFI_PASSWORD="mypassword"
 CONFIG_ESP_MAXIMUM_RETRY=5
-CONFIG_MOCPP_OCPP_BACKEND="ws://echo.websocket.events/"
-CONFIG_MOCPP_CHARGEBOXID=""
-CONFIG_MOCPP_AUTHORIZATIONKEY=""
+CONFIG_MO_OCPP_BACKEND="ws://echo.websocket.events/"
+CONFIG_MO_CHARGEBOXID=""
+CONFIG_MO_AUTHORIZATIONKEY=""
 # end of Example Configuration
 
 #
diff --git a/platformio.ini b/platformio.ini
index 9af4a05c..55258120 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -19,8 +19,8 @@ framework = ${common.framework}
 lib_deps = ${common.lib_deps}
 monitor_speed = ${common.monitor_speed}
 build_flags =
-    -D MOCPP_DBG_LEVEL=MOCPP_DL_INFO ; flood the serial monitor with information about the internal state
-    -DMOCPP_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
+    -D MO_DBG_LEVEL=MO_DL_INFO ; flood the serial monitor with information about the internal state
+    -DMO_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
     -D ARDUINOJSON_ENABLE_STD_STRING=1
 
 [env:esp32-development-board]
@@ -30,7 +30,7 @@ framework = ${common.framework}
 lib_deps = ${common.lib_deps}
 monitor_speed = ${common.monitor_speed}
 build_flags =
-    -D MOCPP_DBG_LEVEL=MOCPP_DL_INFO ; flood the serial monitor with information about the internal state
-    -DMOCPP_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
+    -D MO_DBG_LEVEL=MO_DL_INFO ; flood the serial monitor with information about the internal state
+    -DMO_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
 board_build.partitions = min_spiffs.csv
 upload_speed = 921600
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 2e53f855..ea078334 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -33,7 +33,7 @@
 namespace MicroOcpp {
 namespace Facade {
 
-#ifndef MOCPP_CUSTOM_WS
+#ifndef MO_CUSTOM_WS
 WebSocketsClient *webSocket {nullptr};
 Connection *connection {nullptr};
 #endif
@@ -41,8 +41,8 @@ Connection *connection {nullptr};
 Context *context {nullptr};
 std::shared_ptr<FilesystemAdapter> filesystem;
 
-#ifndef MOCPP_NUMCONNECTORS
-#define MOCPP_NUMCONNECTORS 2
+#ifndef MO_NUMCONNECTORS
+#define MO_NUMCONNECTORS 2
 #endif
 
 #define OCPP_ID_OF_CP 0
@@ -55,10 +55,10 @@ using namespace MicroOcpp;
 using namespace MicroOcpp::Facade;
 using namespace MicroOcpp::Ocpp16;
 
-#ifndef MOCPP_CUSTOM_WS
+#ifndef MO_CUSTOM_WS
 void mocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt, const char *login, const char *password, const char *CA_cert, bool autoRecover) {
     if (context) {
-        MOCPP_DBG_WARN("Can't be called two times. Either restart ESP, or call mocpp_deinitialize() before");
+        MO_DBG_WARN("Can't be called two times. Either restart ESP, or call mocpp_deinitialize() before");
         return;
     }
 
@@ -120,33 +120,33 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
         creds["meterType"] = meterType;
     
     if (creds.overflowed()) {
-        MOCPP_DBG_ERR("Charger Credentials too long");
+        MO_DBG_ERR("Charger Credentials too long");
     }
 
     size_t written = serializeJson(creds, payload, 512);
 
     if (written < 2) {
-        MOCPP_DBG_ERR("Charger Credentials could not be written");
+        MO_DBG_ERR("Charger Credentials could not be written");
         sprintf(payload, "{}");
     }
 }
 
 void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs, bool autoRecover) {
     if (context) {
-        MOCPP_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call mocpp_deinitialize() before");
+        MO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call mocpp_deinitialize() before");
         return;
     }
 
-    MOCPP_DBG_DEBUG("initialize OCPP");
+    MO_DBG_DEBUG("initialize OCPP");
 
     filesystem = fs;
-    MOCPP_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "deactivated");
+    MO_DBG_DEBUG("filesystem %s", filesystem ? "loaded" : "deactivated");
 
     BootStats bootstats;
     BootService::loadBootStats(filesystem, bootstats);
 
     if (autoRecover && bootstats.getBootFailureCount() > 3) {
-        MOCPP_DBG_ERR("multiple initialization failures detected");
+        MO_DBG_ERR("multiple initialization failures detected");
         if (filesystem) {
             bool success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
                 return !strncmp(fname, "sd", strlen("sd")) ||
@@ -155,7 +155,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
                        !strncmp(fname, "sc-", strlen("sc-")) ||
                        !strncmp(fname, "reservation", strlen("reservation"));
             });
-            MOCPP_DBG_ERR("clear local state files (recovery): %s", success ? "success" : "not completed");
+            MO_DBG_ERR("clear local state files (recovery): %s", success ? "success" : "not completed");
 
             bootstats = BootStats();
         }
@@ -170,13 +170,13 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     auto& model = context->getModel();
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
-        new TransactionStore(MOCPP_NUMCONNECTORS, filesystem)));
+        new TransactionStore(MO_NUMCONNECTORS, filesystem)));
     model.setBootService(std::unique_ptr<BootService>(
         new BootService(*context, filesystem)));
     model.setConnectorsCommon(std::unique_ptr<ConnectorsCommon>(
-        new ConnectorsCommon(*context, MOCPP_NUMCONNECTORS, filesystem)));
+        new ConnectorsCommon(*context, MO_NUMCONNECTORS, filesystem)));
     std::vector<std::unique_ptr<Connector>> connectors;
-    for (unsigned int connectorId = 0; connectorId < MOCPP_NUMCONNECTORS; connectorId++) {
+    for (unsigned int connectorId = 0; connectorId < MO_NUMCONNECTORS; connectorId++) {
         connectors.emplace_back(new Connector(*context, connectorId));
     }
     model.setConnectors(std::move(connectors));
@@ -185,11 +185,11 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
         new AuthorizationService(*context, filesystem)));
     model.setReservationService(std::unique_ptr<ReservationService>(
-        new ReservationService(*context, MOCPP_NUMCONNECTORS)));
+        new ReservationService(*context, MO_NUMCONNECTORS)));
     model.setResetService(std::unique_ptr<ResetService>(
         new ResetService(*context)));
 
-#if !defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
+#if !defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
         EspWiFi::makeFirmwareService(*context))); //instantiate FW service + ESP installation routine
 #else
@@ -197,7 +197,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new FirmwareService(*context))); //only instantiate FW service
 #endif
 
-#if !defined(MOCPP_CUSTOM_DIAGNOSTICS) && !defined(MOCPP_CUSTOM_WS)
+#if !defined(MO_CUSTOM_DIAGNOSTICS) && !defined(MO_CUSTOM_WS)
     model.setDiagnosticsService(std::unique_ptr<DiagnosticsService>(
         EspWiFi::makeDiagnosticsService(*context))); //will only return "Rejected" because client needs to implement logging
 #else
@@ -205,7 +205,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new DiagnosticsService(*context)));
 #endif
 
-#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
     if (!model.getResetService()->getExecuteReset())
         model.getResetService()->setExecuteReset(makeDefaultResetFn());
 #endif
@@ -228,7 +228,7 @@ void mocpp_deinitialize() {
         BootStats bootstats;
         BootService::loadBootStats(filesystem, bootstats);
         if (bootstats.lastBootSuccess != bootstats.bootNr) {
-            MOCPP_DBG_DEBUG("boot success timer override");
+            MO_DBG_DEBUG("boot success timer override");
             bootstats.lastBootSuccess = bootstats.bootNr;
             BootService::storeBootStats(filesystem, bootstats);
         }
@@ -237,7 +237,7 @@ void mocpp_deinitialize() {
     delete context;
     context = nullptr;
 
-#ifndef MOCPP_CUSTOM_WS
+#ifndef MO_CUSTOM_WS
     delete connection;
     connection = nullptr;
     delete webSocket;
@@ -248,12 +248,12 @@ void mocpp_deinitialize() {
 
     configuration_deinit();
 
-    MOCPP_DBG_DEBUG("deinitialized OCPP\n");
+    MO_DBG_DEBUG("deinitialized OCPP\n");
 }
 
 void mocpp_loop() {
     if (!context) {
-        MOCPP_DBG_WARN("Please call mocpp_initialize before");
+        MO_DBG_WARN("Please call mocpp_initialize before");
         return;
     }
 
@@ -262,16 +262,16 @@ void mocpp_loop() {
 
 std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        MOCPP_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        MO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return nullptr;
     }
 
@@ -280,17 +280,17 @@ std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int co
 
 std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX ||
         (parentIdTag && strnlen(parentIdTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX)) {
-        MOCPP_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        MO_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return nullptr;
     }
     
@@ -299,12 +299,12 @@ std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, cons
 
 bool endTransaction(const char *idTag, const char *reason, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     auto res = isTransactionActive(connectorId);
@@ -314,12 +314,12 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
 
 bool isTransactionActive(unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     auto& tx = connector->getTransaction();
@@ -328,12 +328,12 @@ bool isTransactionActive(unsigned int connectorId) {
 
 bool isTransactionRunning(unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     auto& tx = connector->getTransaction();
@@ -342,12 +342,12 @@ bool isTransactionRunning(unsigned int connectorId) {
 
 const char *getTransactionIdTag(unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return nullptr;
     }
     auto& tx = connector->getTransaction();
@@ -358,12 +358,12 @@ std::shared_ptr<Transaction> mocpp_undefinedTx;
 
 std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_WARN("Please call mocpp_initialize before");
+        MO_DBG_WARN("Please call mocpp_initialize before");
         return mocpp_undefinedTx;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return mocpp_undefinedTx;
     }
     return connector->getTransaction();
@@ -371,12 +371,12 @@ std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
 
 bool ocppPermitsCharge(unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_WARN("Please call mocpp_initialize before");
+        MO_DBG_WARN("Please call mocpp_initialize before");
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     return connector->ocppPermitsCharge();
@@ -384,32 +384,32 @@ bool ocppPermitsCharge(unsigned int connectorId) {
 
 void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setConnectorPluggedInput(pluggedInput);
 
     if (pluggedInput) {
-        MOCPP_DBG_INFO("Added ConnectorPluggedInput. Transaction-management is in auto mode now");
+        MO_DBG_INFO("Added ConnectorPluggedInput. Transaction-management is in auto mode now");
     } else {
-        MOCPP_DBG_INFO("Reset ConnectorPluggedInput. Transaction-management is in manual mode now");
+        MO_DBG_INFO("Reset ConnectorPluggedInput. Transaction-management is in manual mode now");
     }
 }
 
 void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*context, MOCPP_NUMCONNECTORS, filesystem)));
+            new MeteringService(*context, MO_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Energy.Active.Import.Register");
@@ -424,14 +424,14 @@ void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connec
 
 void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
 
     auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*context, MOCPP_NUMCONNECTORS, filesystem)));
+            new MeteringService(*context, MO_NUMCONNECTORS, filesystem)));
     }
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Power.Active.Import");
@@ -446,11 +446,11 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
 
 void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
 
@@ -473,11 +473,11 @@ void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput,
 
 void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
 
@@ -500,18 +500,18 @@ void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutpu
 
 void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
 
     auto& model = context->getModel();
     if (!model.getSmartChargingService() && chargingLimitOutput) {
         model.setSmartChargingService(std::unique_ptr<SmartChargingService>(
-            new SmartChargingService(*context, filesystem, MOCPP_NUMCONNECTORS)));
+            new SmartChargingService(*context, filesystem, MO_NUMCONNECTORS)));
     }
 
     if (auto scService = context->getModel().getSmartChargingService()) {
@@ -526,12 +526,12 @@ void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOu
 
 void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setEvReadyInput(evReadyInput);
@@ -539,12 +539,12 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
 
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setEvseReadyInput(evseReadyInput);
@@ -552,12 +552,12 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
 
 void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->addErrorCodeInput(errorCodeInput);
@@ -565,12 +565,12 @@ void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int
 
 void addErrorDataInput(std::function<MicroOcpp::ErrorData()> errorDataInput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->addErrorDataInput(errorDataInput);
@@ -578,18 +578,18 @@ void addErrorDataInput(std::function<MicroOcpp::ErrorData()> errorDataInput, uns
 
 void addMeterValueInput(std::function<float ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
 
     if (!valueInput) {
-        MOCPP_DBG_ERR("value undefined");
+        MO_DBG_ERR("value undefined");
         return;
     }
 
     if (!measurand) {
         measurand = "Energy.Active.Import.Register";
-        MOCPP_DBG_WARN("Measurand unspecified; assume %s", measurand);
+        MO_DBG_WARN("Measurand unspecified; assume %s", measurand);
     }
 
     SampledValueProperties properties;
@@ -611,25 +611,25 @@ void addMeterValueInput(std::function<float ()> valueInput, const char *measuran
 
 void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*context, MOCPP_NUMCONNECTORS, filesystem)));
+            new MeteringService(*context, MO_NUMCONNECTORS, filesystem)));
     }
     model.getMeteringService()->addMeterValueSampler(connectorId, std::move(valueInput));
 }
 
 void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setOccupiedInput(occupied);
@@ -637,12 +637,12 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId)
 
 void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setStartTxReadyInput(startTxReady);
@@ -650,12 +650,12 @@ void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int conne
 
 void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setStopTxReadyInput(stopTxReady);
@@ -663,12 +663,12 @@ void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connect
 
 void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcpp::TxNotification)> notificationOutput, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setTxNotificationOutput(notificationOutput);
@@ -676,12 +676,12 @@ void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcp
 
 void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return;
     }
     connector->setOnUnlockConnector(onUnlockConnectorInOut);
@@ -689,14 +689,14 @@ void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnect
 
 bool isOperative(unsigned int connectorId) {
     if (!context) {
-        MOCPP_DBG_WARN("Please call mocpp_initialize before");
+        MO_DBG_WARN("Please call mocpp_initialize before");
         return true; //assume "true" as default state
     }
     auto& model = context->getModel();
     auto chargePoint = model.getConnector(OCPP_ID_OF_CP);
     auto connector = model.getConnector(connectorId);
     if (!chargePoint || !connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return true; //assume "true" as default state
     }
     return chargePoint->isOperative() && connector->isOperative();
@@ -704,7 +704,7 @@ bool isOperative(unsigned int connectorId) {
 
 void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
 
@@ -715,7 +715,7 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
 
 void setOnResetExecute(std::function<void(bool)> onResetExecute) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
 
@@ -724,14 +724,14 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute) {
     }
 }
 
-#if defined(MOCPP_CUSTOM_UPDATER) || defined(MOCPP_CUSTOM_WS)
+#if defined(MO_CUSTOM_UPDATER) || defined(MO_CUSTOM_WS)
 FirmwareService *getFirmwareService() {
     auto& model = context->getModel();
     return model.getFirmwareService();
 }
 #endif
 
-#if defined(MOCPP_CUSTOM_DIAGNOSTICS) || defined(MOCPP_CUSTOM_WS)
+#if defined(MO_CUSTOM_DIAGNOSTICS) || defined(MO_CUSTOM_WS)
 DiagnosticsService *getDiagnosticsService() {
     auto& model = context->getModel();
     return model.getDiagnosticsService();
@@ -744,11 +744,11 @@ Context *getOcppContext() {
 
 void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onReceiveReq) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!operationType) {
-        MOCPP_DBG_ERR("invalid args");
+        MO_DBG_ERR("invalid args");
         return;
     }
     context->getOperationRegistry().setOnRequest(operationType, onReceiveReq);
@@ -756,11 +756,11 @@ void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onRecei
 
 void setOnSendConf(const char *operationType, OnSendConfListener onSendConf) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!operationType) {
-        MOCPP_DBG_ERR("invalid args");
+        MO_DBG_ERR("invalid args");
         return;
     }
     context->getOperationRegistry().setOnResponse(operationType, onSendConf);
@@ -771,11 +771,11 @@ void sendRequest(const char *operationType,
             std::function<void (JsonObject)> fn_processConf) {
 
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!operationType || !fn_createReq || !fn_processConf) {
-        MOCPP_DBG_ERR("invalid args");
+        MO_DBG_ERR("invalid args");
         return;
     }
 
@@ -788,11 +788,11 @@ void setRequestHandler(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf) {
 
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!operationType || !fn_processReq || !fn_createConf) {
-        MOCPP_DBG_ERR("invalid args");
+        MO_DBG_ERR("invalid args");
         return;
     }
 
@@ -805,11 +805,11 @@ void setRequestHandler(const char *operationType,
 
 void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        MOCPP_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        MO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return;
     }
     auto authorize = makeRequest(
@@ -831,22 +831,22 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
 
 bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
-        MOCPP_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
+        MO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
         return false;
     }
     auto connector = context->getModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
     auto transaction = connector->getTransaction();
     if (transaction) {
         if (transaction->getStartSync().isRequested()) {
-            MOCPP_DBG_ERR("Transaction already in progress. Must call stopTransaction()");
+            MO_DBG_ERR("Transaction already in progress. Must call stopTransaction()");
             return false;
         }
         transaction->setIdTag(idTag);
@@ -854,7 +854,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         beginTransaction_authorized(idTag); //request new transaction object
         transaction = connector->getTransaction();
         if (!transaction) {
-            MOCPP_DBG_WARN("Transaction queue full");
+            MO_DBG_WARN("Transaction queue full");
             return false;
         }
     }
@@ -864,7 +864,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         if (meterStart && *meterStart) {
             transaction->setMeterStart(meterStart->toInteger());
         } else {
-            MOCPP_DBG_ERR("MeterStart undefined");
+            MO_DBG_ERR("MeterStart undefined");
         }
     }
 
@@ -893,18 +893,18 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
 
 bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        MOCPP_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
-        MOCPP_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("Could not find connector. Ignore");
         return false;
     }
 
     auto transaction = connector->getTransaction();
     if (!transaction || !transaction->isRunning()) {
-        MOCPP_DBG_ERR("No running Tx to stop");
+        MO_DBG_ERR("No running Tx to stop");
         return false;
     }
 
@@ -920,7 +920,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         if (meterStop && *meterStop) {
             transaction->setMeterStop(meterStop->toInteger());
         } else {
-            MOCPP_DBG_ERR("MeterStop undefined");
+            MO_DBG_ERR("MeterStop undefined");
         }
     }
 
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index f63f039e..5ef1244c 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -26,7 +26,7 @@ using MicroOcpp::OnAbortListener;
 using MicroOcpp::OnTimeoutListener;
 using MicroOcpp::OnReceiveErrorListener;
 
-#ifndef MOCPP_CUSTOM_WS
+#ifndef MO_CUSTOM_WS
 //use links2004/WebSockets library
 
 /*
@@ -285,7 +285,7 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify); //call onResetNo
 
 void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handler. This function should reboot this controller immediately. Already defined for the ESP32 on Arduino
 
-#if defined(MOCPP_CUSTOM_UPDATER) || defined(MOCPP_CUSTOM_WS)
+#if defined(MO_CUSTOM_UPDATER) || defined(MO_CUSTOM_WS)
 #include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
 
 /*
@@ -298,7 +298,7 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handle
 MicroOcpp::FirmwareService *getFirmwareService();
 #endif
 
-#if defined(MOCPP_CUSTOM_DIAGNOSTICS) || defined(MOCPP_CUSTOM_WS)
+#if defined(MO_CUSTOM_DIAGNOSTICS) || defined(MO_CUSTOM_WS)
 #include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
 /*
  * This library implements the OCPP messaging side of Diagnostics, but no logging or the
diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index 24a64287..8c40e547 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -67,18 +67,18 @@ ConfigurationContainer *declareContainer(const char *filename, bool accessible)
     auto container = getContainer(filename);
     
     if (!container) {
-        MOCPP_DBG_DEBUG("init new configurations container: %s", filename);
+        MO_DBG_DEBUG("init new configurations container: %s", filename);
 
         container = createConfigurationContainer(filename, accessible);
         if (!container) {
-            MOCPP_DBG_ERR("OOM");
+            MO_DBG_ERR("OOM");
             return nullptr;
         }
         configurationContainers.push_back(container);
     }
 
     if (container->isAccessible() != accessible) {
-        MOCPP_DBG_ERR("%s: conflicting accessibility declarations (expect %s)", filename, container->isAccessible() ? "accessible" : "inaccessible");
+        MO_DBG_ERR("%s: conflicting accessibility declarations (expect %s)", filename, container->isAccessible() ? "accessible" : "inaccessible");
         (void)0;
     }
 
@@ -89,12 +89,12 @@ std::shared_ptr<Configuration> loadConfiguration(TConfig type, const char *key,
     for (auto& container : configurationContainers) {
         if (auto config = container->getConfiguration(key)) {
             if (config->getType() != type) {
-                MOCPP_DBG_ERR("conflicting type for %s - remove old config", key);
+                MO_DBG_ERR("conflicting type for %s - remove old config", key);
                 container->remove(config.get());
                 continue;
             }
             if (container->isAccessible() != accessible) {
-                MOCPP_DBG_ERR("conflicting accessibility for %s", key);
+                MO_DBG_ERR("conflicting accessibility for %s", key);
                 (void)0;
             }
             container->loadStaticKey(*config.get(), key);
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index ad5b1392..66c9d43f 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -12,9 +12,9 @@
 #include <memory>
 #include <vector>
 
-#define CONFIGURATION_FN (MOCPP_FILENAME_PREFIX "ocpp-config.jsn")
+#define CONFIGURATION_FN (MO_FILENAME_PREFIX "ocpp-config.jsn")
 #define CONFIGURATION_VOLATILE "/volatile"
-#define MOCPP_KEYVALUE_FN (MOCPP_FILENAME_PREFIX "client-state.jsn")
+#define MO_KEYVALUE_FN (MO_FILENAME_PREFIX "client-state.jsn")
 
 namespace MicroOcpp {
 
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index 56f3462e..4af4c359 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -28,7 +28,7 @@ std::shared_ptr<Configuration> ConfigurationContainerVolatile::createConfigurati
     std::shared_ptr<Configuration> res = makeConfiguration(type, key);
     if (!res) {
         //allocation failure - OOM
-        MOCPP_DBG_ERR("OOM");
+        MO_DBG_ERR("OOM");
         return nullptr;
     }
     configurations.push_back(res);
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index e587472d..df494327 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -25,9 +25,9 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
     void clearKeyPool(const char *key) {
         keyPool.erase(std::remove_if(keyPool.begin(), keyPool.end(), 
             [key] (const std::unique_ptr<char[]>& k) {
-                #if MOCPP_DBG_LEVEL >= MOCPP_DL_VERBOSE
+                #if MO_DBG_LEVEL >= MO_DL_VERBOSE
                 if (!strcmp(k.get(), key)) {
-                    MOCPP_DBG_VERBOSE("clear key %s", key);
+                    MO_DBG_VERBOSE("clear key %s", key);
                 }
                 #endif
                 return !strcmp(k.get(), key);
@@ -61,13 +61,13 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         size_t file_size = 0;
         if (filesystem->stat(getFilename(), &file_size) != 0 // file does not exist
                 || file_size == 0) {                         // file exists, but empty
-            MOCPP_DBG_DEBUG("Populate FS: create configuration file");
+            MO_DBG_DEBUG("Populate FS: create configuration file");
             return save();
         }
 
         auto doc = FilesystemUtils::loadJson(filesystem, getFilename());
         if (!doc) {
-            MOCPP_DBG_ERR("failed to load %s", getFilename());
+            MO_DBG_ERR("failed to load %s", getFilename());
             return false;
         }
 
@@ -77,37 +77,37 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
 
         if (strcmp(configHeader["content-type"] | "Invalid", "ocpp_config_file") &&
                 strcmp(configHeader["content-type"] | "Invalid", "ao_configuration_file")) { //backwards-compatibility
-            MOCPP_DBG_ERR("Unable to initialize: unrecognized configuration file format");
+            MO_DBG_ERR("Unable to initialize: unrecognized configuration file format");
             return false;
         }
 
         if (strcmp(configHeader["version"] | "Invalid", "2.0") &&
                 strcmp(configHeader["version"] | "Invalid", "1.1")) { //backwards-compatibility
-            MOCPP_DBG_ERR("Unable to initialize: unsupported version");
+            MO_DBG_ERR("Unable to initialize: unsupported version");
             return false;
         }
         
         JsonArray configurationsArray = root["configurations"];
         if (configurationsArray.size() > MAX_CONFIGURATIONS) {
-            MOCPP_DBG_ERR("Unable to initialize: configurations_len is too big (=%zu)", configurationsArray.size());
+            MO_DBG_ERR("Unable to initialize: configurations_len is too big (=%zu)", configurationsArray.size());
             return false;
         }
 
         for (JsonObject stored : configurationsArray) {
             TConfig type;
             if (!deserializeTConfig(stored["type"] | "_Undefined", type)) {
-                MOCPP_DBG_ERR("corrupt config");
+                MO_DBG_ERR("corrupt config");
                 continue;
             }
 
             const char *key = stored["key"] | "";
             if (!*key) {
-                MOCPP_DBG_ERR("corrupt config");
+                MO_DBG_ERR("corrupt config");
                 continue;
             }
 
             if (!stored.containsKey("value")) {
-                MOCPP_DBG_ERR("corrupt config");
+                MO_DBG_ERR("corrupt config");
                 continue;
             }
             
@@ -115,7 +115,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
 
             auto config = getConfiguration(key).get();
             if (config && config->getType() != type) {
-                MOCPP_DBG_ERR("conflicting type for %s - remove old config", key);
+                MO_DBG_ERR("conflicting type for %s - remove old config", key);
                 remove(config);
                 config = nullptr;
             }
@@ -127,7 +127,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
             switch (type) {
                 case TConfig::Int: {
                     if (!stored["value"].is<int>()) {
-                        MOCPP_DBG_ERR("corrupt config");
+                        MO_DBG_ERR("corrupt config");
                         continue;
                     }
                     int value = stored["value"] | 0;
@@ -142,7 +142,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                 }
                 case TConfig::Bool: {
                     if (!stored["value"].is<bool>()) {
-                        MOCPP_DBG_ERR("corrupt config");
+                        MO_DBG_ERR("corrupt config");
                         continue;
                     }
                     bool value = stored["value"] | false;
@@ -157,7 +157,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                 }
                 case TConfig::String: {
                     if (!stored["value"].is<const char*>()) {
-                        MOCPP_DBG_ERR("corrupt config");
+                        MO_DBG_ERR("corrupt config");
                         continue;
                     }
                     const char *value = stored["value"] | "";
@@ -180,14 +180,14 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                     keyPool.push_back(std::move(key_pooled));
                 }
             } else {
-                MOCPP_DBG_ERR("OOM: %s", key);
+                MO_DBG_ERR("OOM: %s", key);
                 (void)0;
             }
         }
 
         configurationsUpdated();
 
-        MOCPP_DBG_DEBUG("Initialization finished");
+        MO_DBG_DEBUG("Initialization finished");
         loaded = true;
         return true;
     }
@@ -205,7 +205,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         //during mocpp_deinitialize(), key owners are destructed. Don't store if this container is affected
         for (auto& config : configurations) {
             if (!config->getKey()) {
-                MOCPP_DBG_DEBUG("don't write back container with destructed key(s)");
+                MO_DBG_DEBUG("don't write back container with destructed key(s)");
                 return false;
             }
         }
@@ -214,9 +214,9 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         jsonCapacity += JSON_ARRAY_SIZE(configurations.size()); //configurations array
         jsonCapacity += configurations.size() * JSON_OBJECT_SIZE(3); //config entries in array
 
-        if (jsonCapacity > MOCPP_MAX_JSON_CAPACITY) {
-            MOCPP_DBG_ERR("configs JSON exceeds maximum capacity (%s, %zu entries). Crop configs file (by FCFS)", getFilename(), configurations.size());
-            jsonCapacity = MOCPP_MAX_JSON_CAPACITY;
+        if (jsonCapacity > MO_MAX_JSON_CAPACITY) {
+            MO_DBG_ERR("configs JSON exceeds maximum capacity (%s, %zu entries). Crop configs file (by FCFS)", getFilename(), configurations.size());
+            jsonCapacity = MO_MAX_JSON_CAPACITY;
         }
 
         DynamicJsonDocument doc {jsonCapacity};
@@ -232,7 +232,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
             auto& config = *configurations[i];
 
             size_t entryCapacity = JSON_OBJECT_SIZE(3) + (JSON_ARRAY_SIZE(2) - JSON_ARRAY_SIZE(1));
-            if (trackCapacity + entryCapacity > MOCPP_MAX_JSON_CAPACITY) {
+            if (trackCapacity + entryCapacity > MO_MAX_JSON_CAPACITY) {
                 break;
             }
 
@@ -259,9 +259,9 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         bool success = FilesystemUtils::storeJson(filesystem, getFilename(), doc);
 
         if (success) {
-            MOCPP_DBG_DEBUG("Saving configurations finished");
+            MO_DBG_DEBUG("Saving configurations finished");
         } else {
-            MOCPP_DBG_ERR("could not save configs file: %s", getFilename());
+            MO_DBG_ERR("could not save configs file: %s", getFilename());
         }
 
         return success;
@@ -271,7 +271,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
         std::shared_ptr<Configuration> res = makeConfiguration(type, key);
         if (!res) {
             //allocation failure - OOM
-            MOCPP_DBG_ERR("OOM");
+            MO_DBG_ERR("OOM");
             return nullptr;
         }
         configurations.push_back(res);
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index 00ecc6be..52097583 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -12,8 +12,8 @@
 #define KEY_MAXLEN 60
 #define STRING_VAL_MAXLEN 512
 
-#ifndef MOCPP_CONFIG_TYPECHECK
-#define MOCPP_CONFIG_TYPECHECK 1 //enable this for debugging
+#ifndef MO_CONFIG_TYPECHECK
+#define MO_CONFIG_TYPECHECK 1 //enable this for debugging
 #endif
 
 namespace MicroOcpp {
@@ -27,41 +27,41 @@ Configuration::~Configuration() {
 }
 
 void Configuration::setInt(int) {
-#if MOCPP_CONFIG_TYPECHECK
-    MOCPP_DBG_ERR("type err");
+#if MO_CONFIG_TYPECHECK
+    MO_DBG_ERR("type err");
 #endif
 }
 
 void Configuration::setBool(bool) {
-#if MOCPP_CONFIG_TYPECHECK
-    MOCPP_DBG_ERR("type err");
+#if MO_CONFIG_TYPECHECK
+    MO_DBG_ERR("type err");
 #endif
 }
 
 bool Configuration::setString(const char*) {
-#if MOCPP_CONFIG_TYPECHECK
-    MOCPP_DBG_ERR("type err");
+#if MO_CONFIG_TYPECHECK
+    MO_DBG_ERR("type err");
 #endif
     return false;
 }
 
 int Configuration::getInt() {
-#if MOCPP_CONFIG_TYPECHECK
-    MOCPP_DBG_ERR("type err");
+#if MO_CONFIG_TYPECHECK
+    MO_DBG_ERR("type err");
 #endif
     return 0;
 }
 
 bool Configuration::getBool() {
-#if MOCPP_CONFIG_TYPECHECK
-    MOCPP_DBG_ERR("type err");
+#if MO_CONFIG_TYPECHECK
+    MO_DBG_ERR("type err");
 #endif
     return false;
 }
 
 const char *Configuration::getString() {
-#if MOCPP_CONFIG_TYPECHECK
-    MOCPP_DBG_ERR("type err");
+#if MO_CONFIG_TYPECHECK
+    MO_DBG_ERR("type err");
 #endif
     return "";
 }
@@ -198,7 +198,7 @@ class ConfigString : public Configuration {
             size = strlen(src) + 1;
         }
 
-        if (size > MOCPP_CONFIG_MAX_VALSTRSIZE) {
+        if (size > MO_CONFIG_MAX_VALSTRSIZE) {
             return false;
         }
 
@@ -242,7 +242,7 @@ std::unique_ptr<Configuration> makeConfiguration(TConfig type, const char *key)
             break;
     }
     if (!res) {
-        MOCPP_DBG_ERR("OOM");
+        MO_DBG_ERR("OOM");
         return nullptr;
     }
     res->setKey(key);
@@ -260,7 +260,7 @@ bool deserializeTConfig(const char *serialized, TConfig& out) {
         out = TConfig::String;
         return true;
     } else {
-        MOCPP_DBG_WARN("config type error");
+        MO_DBG_WARN("config type error");
         return false;
     }
 }
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index f3757cf5..8af972cb 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -8,10 +8,10 @@
 #include <ArduinoJson.h>
 #include <memory>
 
-#define MOCPP_CONFIG_MAX_VALSTRSIZE 128
+#define MO_CONFIG_MAX_VALSTRSIZE 128
 
-#ifndef MOCPP_CONFIG_EXT_PREFIX
-#define MOCPP_CONFIG_EXT_PREFIX "Cst_"
+#ifndef MO_CONFIG_EXT_PREFIX
+#define MO_CONFIG_EXT_PREFIX "Cst_"
 #endif
 
 namespace MicroOcpp {
diff --git a/src/MicroOcpp/Core/Connection.cpp b/src/MicroOcpp/Core/Connection.cpp
index 50a2e180..73e64c3c 100644
--- a/src/MicroOcpp/Core/Connection.cpp
+++ b/src/MicroOcpp/Core/Connection.cpp
@@ -40,7 +40,7 @@ void LoopbackConnection::setConnected(bool connected) {
     this->connected = connected;
 }
 
-#ifndef MOCPP_CUSTOM_WS
+#ifndef MO_CUSTOM_WS
 
 using namespace MicroOcpp::EspWiFi;
 
@@ -62,10 +62,10 @@ void WSClient::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
     wsock->onEvent([callback, &captureLastRecv, &captureLastConnected](WStype_t type, uint8_t * payload, size_t length) {
         switch (type) {
             case WStype_DISCONNECTED:
-                MOCPP_DBG_INFO("Disconnected");
+                MO_DBG_INFO("Disconnected");
                 break;
             case WStype_CONNECTED:
-                MOCPP_DBG_INFO("Connected to url: %s", payload);
+                MO_DBG_INFO("Connected to url: %s", payload);
                 captureLastRecv = mocpp_tick_ms();
                 captureLastConnected = mocpp_tick_ms();
                 break;
@@ -73,25 +73,25 @@ void WSClient::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
                 if (callback((const char *) payload, length)) { //forward message to RequestQueue
                     captureLastRecv = mocpp_tick_ms();
                 } else {
-                    MOCPP_DBG_WARN("Processing WebSocket input event failed");
+                    MO_DBG_WARN("Processing WebSocket input event failed");
                 }
                 break;
             case WStype_BIN:
-                MOCPP_DBG_WARN("Binary data stream not supported");
+                MO_DBG_WARN("Binary data stream not supported");
                 break;
             case WStype_PING:
                 // pong will be send automatically
-                MOCPP_DBG_TRAFFIC_IN(8, "WS ping");
+                MO_DBG_TRAFFIC_IN(8, "WS ping");
                 captureLastRecv = mocpp_tick_ms();
                 break;
             case WStype_PONG:
                 // answer to a ping we send
-                MOCPP_DBG_TRAFFIC_IN(8, "WS pong");
+                MO_DBG_TRAFFIC_IN(8, "WS pong");
                 captureLastRecv = mocpp_tick_ms();
                 break;
             case WStype_FRAGMENT_TEXT_START: //fragments are not supported
             default:
-                MOCPP_DBG_WARN("Unsupported WebSocket event type");
+                MO_DBG_WARN("Unsupported WebSocket event type");
                 break;
         }
     });
diff --git a/src/MicroOcpp/Core/Connection.h b/src/MicroOcpp/Core/Connection.h
index 27f095b6..2dbed0e5 100644
--- a/src/MicroOcpp/Core/Connection.h
+++ b/src/MicroOcpp/Core/Connection.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_CONNECTION_H
-#define MOCPP_CONNECTION_H
+#ifndef MO_CONNECTION_H
+#define MO_CONNECTION_H
 
 #include <functional>
 #include <memory>
@@ -12,11 +12,11 @@
 
 //On all platforms other than Arduino, the integrated WS lib (links2004/arduinoWebSockets) cannot be
 //used. On Arduino it's usage is optional.
-#ifndef MOCPP_CUSTOM_WS
-#if MOCPP_PLATFORM != MOCPP_PLATFORM_ARDUINO
-#define MOCPP_CUSTOM_WS
+#ifndef MO_CUSTOM_WS
+#if MO_PLATFORM != MO_PLATFORM_ARDUINO
+#define MO_CUSTOM_WS
 #endif
-#endif //ndef MOCPP_CUSTOM_WS
+#endif //ndef MO_CUSTOM_WS
 
 namespace MicroOcpp {
 
@@ -75,7 +75,7 @@ class LoopbackConnection : public Connection {
 
 } //end namespace MicroOcpp
 
-#ifndef MOCPP_CUSTOM_WS
+#ifndef MO_CUSTOM_WS
 
 #include <WebSocketsClient.h>
 
@@ -102,5 +102,5 @@ class WSClient : public Connection {
 
 } //end namespace EspWiFi
 } //end namespace MicroOcpp
-#endif //ndef MOCPP_CUSTOM_WS
+#endif //ndef MO_CUSTOM_WS
 #endif
diff --git a/src/MicroOcpp/Core/Context.h b/src/MicroOcpp/Core/Context.h
index 55000737..dfe5ff2c 100644
--- a/src/MicroOcpp/Core/Context.h
+++ b/src/MicroOcpp/Core/Context.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_CONTEXT_H
-#define MOCPP_CONTEXT_H
+#ifndef MO_CONTEXT_H
+#define MO_CONTEXT_H
 
 #include <memory>
 
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 30da85ff..a74331e6 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -19,13 +19,13 @@
  */
 
 
-#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS || MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
+#if MO_USE_FILEAPI == ARDUINO_LITTLEFS || MO_USE_FILEAPI == ARDUINO_SPIFFS
 
-#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
+#if MO_USE_FILEAPI == ARDUINO_LITTLEFS
 #include <LittleFS.h>
 #include <vfs_api.h>
 #define USE_FS LittleFS
-#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
+#elif MO_USE_FILEAPI == ARDUINO_SPIFFS
 #include <FS.h>
 #define USE_FS SPIFFS
 #endif
@@ -66,21 +66,21 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
         valid = true;
 
         if (config.mustMount()) { 
-#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
+#if MO_USE_FILEAPI == ARDUINO_LITTLEFS
             if(!USE_FS.begin(config.formatOnFail())) {
-                MOCPP_DBG_ERR("Error while mounting LITTLEFS");
+                MO_DBG_ERR("Error while mounting LITTLEFS");
                 valid = false;
             } else {
-                MOCPP_DBG_DEBUG("LittleFS mount success");
+                MO_DBG_DEBUG("LittleFS mount success");
             }
-#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
+#elif MO_USE_FILEAPI == ARDUINO_SPIFFS
             //ESP8266
             SPIFFSConfig cfg;
             cfg.setAutoFormat(config.formatOnFail());
             SPIFFS.setConfig(cfg);
 
             if (!SPIFFS.begin()) {
-                MOCPP_DBG_ERR("Unable to initialize: unable to mount SPIFFS");
+                MO_DBG_ERR("Unable to initialize: unable to mount SPIFFS");
                 valid = false;
             }
 #else
@@ -99,11 +99,11 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     operator bool() {return valid;}
 
     int stat(const char *path, size_t *size) override {
-#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
-        char partition_path [MOCPP_MAX_PATH_SIZE];
-        auto ret = snprintf(partition_path, MOCPP_MAX_PATH_SIZE, "/littlefs%s", path);
-        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-            MOCPP_DBG_ERR("fn error: %i", ret);
+#if MO_USE_FILEAPI == ARDUINO_LITTLEFS
+        char partition_path [MO_MAX_PATH_SIZE];
+        auto ret = snprintf(partition_path, MO_MAX_PATH_SIZE, "/littlefs%s", path);
+        if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+            MO_DBG_ERR("fn error: %i", ret);
             return -1;
         }
         struct ::stat st;
@@ -112,7 +112,7 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
             *size = st.st_size;
         }
         return status;
-#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
+#elif MO_USE_FILEAPI == ARDUINO_SPIFFS
         if (!USE_FS.exists(path)) {
             return -1;
         }
@@ -140,7 +140,7 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
     std::unique_ptr<FileAdapter> open(const char *fn, const char *mode) override {
         File file = USE_FS.open(fn, mode);
         if (file && !file.isDirectory()) {
-            MOCPP_DBG_DEBUG("File open successful: %s", fn);
+            MO_DBG_DEBUG("File open successful: %s", fn);
             return std::unique_ptr<FileAdapter>(new ArduinoFileAdapter(std::move(file)));
         } else {
             return nullptr;
@@ -150,22 +150,22 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
         return USE_FS.remove(fn);
     };
     int ftw_root(std::function<int(const char *fpath)> fn) override {
-#if MOCPP_USE_FILEAPI == ARDUINO_LITTLEFS
-        auto dir = USE_FS.open(MOCPP_FILENAME_PREFIX);
+#if MO_USE_FILEAPI == ARDUINO_LITTLEFS
+        auto dir = USE_FS.open(MO_FILENAME_PREFIX);
         if (!dir) {
-            MOCPP_DBG_ERR("cannot open root directory: " MOCPP_FILENAME_PREFIX);
+            MO_DBG_ERR("cannot open root directory: " MO_FILENAME_PREFIX);
             return -1;
         }
 
         int err = 0;
         while (auto entry = dir.openNextFile()) {
 
-            char fname [MOCPP_MAX_PATH_SIZE];
-            auto ret = snprintf(fname, MOCPP_MAX_PATH_SIZE, "%s", entry.name());
+            char fname [MO_MAX_PATH_SIZE];
+            auto ret = snprintf(fname, MO_MAX_PATH_SIZE, "%s", entry.name());
             entry.close();
 
-            if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-                MOCPP_DBG_ERR("fn error: %i", ret);
+            if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+                MO_DBG_ERR("fn error: %i", ret);
                 return -1;
             }
 
@@ -175,15 +175,15 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
             }
         }
         return err;
-#elif MOCPP_USE_FILEAPI == ARDUINO_SPIFFS
-        auto dir = USE_FS.openDir(MOCPP_FILENAME_PREFIX);
+#elif MO_USE_FILEAPI == ARDUINO_SPIFFS
+        auto dir = USE_FS.openDir(MO_FILENAME_PREFIX);
         int err = 0;
         while (dir.next()) {
             auto fname = dir.fileName();
             if (fname.c_str()) {
-                err = fn(fname.c_str() + strlen(MOCPP_FILENAME_PREFIX));
+                err = fn(fname.c_str() + strlen(MO_FILENAME_PREFIX));
             } else {
-                MOCPP_DBG_ERR("fs error");
+                MO_DBG_ERR("fs error");
                 err = -1;
             }
             if (err) {
@@ -206,7 +206,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     if (!config.accessAllowed()) {
-        MOCPP_DBG_DEBUG("Access to Arduino FS not allowed by config");
+        MO_DBG_DEBUG("Access to Arduino FS not allowed by config");
         return nullptr;
     }
 
@@ -223,7 +223,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 } //end namespace MicroOcpp
 
-#elif MOCPP_USE_FILEAPI == ESPIDF_SPIFFS
+#elif MO_USE_FILEAPI == ESPIDF_SPIFFS
 
 #include <sys/stat.h>
 #include <dirent.h>
@@ -266,7 +266,7 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
     ~EspIdfFilesystemAdapter() {
         if (config.mustMount()) {
             esp_vfs_spiffs_unregister("mo"); //partition label
-            MOCPP_DBG_DEBUG("SPIFFS unmounted");
+            MO_DBG_DEBUG("SPIFFS unmounted");
         }
     }
 
@@ -284,7 +284,7 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
         if (file) {
             return std::unique_ptr<FileAdapter>(new EspIdfFileAdapter(std::move(file)));
         } else {
-            MOCPP_DBG_DEBUG("Failed to open file path %s", fn);
+            MO_DBG_DEBUG("Failed to open file path %s", fn);
             return nullptr;
         }
     }
@@ -295,10 +295,10 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
 
     int ftw_root(std::function<int(const char *fpath)> fn) override {
         //open MO root directory
-        char dname [MOCPP_MAX_PATH_SIZE];
-        auto dlen = snprintf(dname, MOCPP_MAX_PATH_SIZE, "%s", MOCPP_FILENAME_PREFIX);
-        if (dlen < 0 || dlen >= MOCPP_MAX_PATH_SIZE) {
-            MOCPP_DBG_ERR("fn error: %i", dlen);
+        char dname [MO_MAX_PATH_SIZE];
+        auto dlen = snprintf(dname, MO_MAX_PATH_SIZE, "%s", MO_FILENAME_PREFIX);
+        if (dlen < 0 || dlen >= MO_MAX_PATH_SIZE) {
+            MO_DBG_ERR("fn error: %i", dlen);
             return -1;
         }
 
@@ -309,7 +309,7 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
 
         auto dir = opendir(dname);
         if (!dir) {
-            MOCPP_DBG_ERR("cannot open root directory: %s", dname);
+            MO_DBG_ERR("cannot open root directory: %s", dname);
             return -1;
         }
 
@@ -335,7 +335,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     if (!config.accessAllowed()) {
-        MOCPP_DBG_DEBUG("Access to ESP-IDF SPIFFS not allowed by config");
+        MO_DBG_DEBUG("Access to ESP-IDF SPIFFS not allowed by config");
         return nullptr;
     }
 
@@ -344,13 +344,13 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     if (config.mustMount()) {
         mounted = false;
 
-        char fn_prefix [MOCPP_MAX_PATH_SIZE];
-        auto fn_prefix_len = snprintf(fn_prefix, MOCPP_MAX_PATH_SIZE, "%.*s", ((int) strlen(MOCPP_FILENAME_PREFIX)) - 1, MOCPP_FILENAME_PREFIX);
-        if (fn_prefix_len < 0 || fn_prefix_len >= MOCPP_MAX_PATH_SIZE) {
-            MOCPP_DBG_ERR("MOCPP_FILENAME_PREFIX error %i", fn_prefix_len);
+        char fn_prefix [MO_MAX_PATH_SIZE];
+        auto fn_prefix_len = snprintf(fn_prefix, MO_MAX_PATH_SIZE, "%.*s", ((int) strlen(MO_FILENAME_PREFIX)) - 1, MO_FILENAME_PREFIX);
+        if (fn_prefix_len < 0 || fn_prefix_len >= MO_MAX_PATH_SIZE) {
+            MO_DBG_ERR("MO_FILENAME_PREFIX error %i", fn_prefix_len);
             return nullptr;
         } else if (fn_prefix_len == 0) {
-            MOCPP_DBG_ERR("MOCPP_FILENAME_PREFIX cannot be root on ESP-IDF");
+            MO_DBG_ERR("MO_FILENAME_PREFIX cannot be root on ESP-IDF");
             return nullptr;
         }
 
@@ -365,14 +365,14 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
         if (ret == ESP_OK) {
             mounted = true;
-            MOCPP_DBG_DEBUG("SPIFFS mounted");
+            MO_DBG_DEBUG("SPIFFS mounted");
         } else {
             if (ret == ESP_FAIL) {
-                MOCPP_DBG_ERR("Failed to mount or format filesystem");
+                MO_DBG_ERR("Failed to mount or format filesystem");
             } else if (ret == ESP_ERR_NOT_FOUND) {
-                MOCPP_DBG_ERR("Failed to find SPIFFS partition");
+                MO_DBG_ERR("Failed to find SPIFFS partition");
             } else {
-                MOCPP_DBG_ERR("Failed to initialize SPIFFS (%s)", esp_err_to_name(ret));
+                MO_DBG_ERR("Failed to initialize SPIFFS (%s)", esp_err_to_name(ret));
             }
         }
     }
@@ -388,7 +388,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 } //end namespace MicroOcpp
 
-#elif MOCPP_USE_FILEAPI == POSIX_FILEAPI
+#elif MO_USE_FILEAPI == POSIX_FILEAPI
 
 #include <cstdio>
 #include <sys/stat.h>
@@ -444,7 +444,7 @@ class PosixFilesystemAdapter : public FilesystemAdapter {
         if (file) {
             return std::unique_ptr<FileAdapter>(new PosixFileAdapter(std::move(file)));
         } else {
-            MOCPP_DBG_DEBUG("Failed to open file path %s", fn);
+            MO_DBG_DEBUG("Failed to open file path %s", fn);
             return nullptr;
         }
     }
@@ -454,9 +454,9 @@ class PosixFilesystemAdapter : public FilesystemAdapter {
     }
 
     int ftw_root(std::function<int(const char *fpath)> fn) override {
-        auto dir = opendir(MOCPP_FILENAME_PREFIX); // use c_str() to convert the path string to a C-style string
+        auto dir = opendir(MO_FILENAME_PREFIX); // use c_str() to convert the path string to a C-style string
         if (!dir) {
-            MOCPP_DBG_ERR("cannot open root directory: " MOCPP_FILENAME_PREFIX);
+            MO_DBG_ERR("cannot open root directory: " MO_FILENAME_PREFIX);
             return -1;
         }
 
@@ -482,12 +482,12 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     if (!config.accessAllowed()) {
-        MOCPP_DBG_DEBUG("Access to FS not allowed by config");
+        MO_DBG_DEBUG("Access to FS not allowed by config");
         return nullptr;
     }
 
     if (config.mustMount()) {
-        MOCPP_DBG_DEBUG("Skip mounting on UNIX host");
+        MO_DBG_DEBUG("Skip mounting on UNIX host");
     }
 
     auto fs = std::shared_ptr<FilesystemAdapter>(new PosixFilesystemAdapter(config));
@@ -507,4 +507,4 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 } //end namespace MicroOcpp
 
-#endif //switch-case MOCPP_USE_FILEAPI
+#endif //switch-case MO_USE_FILEAPI
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.h b/src/MicroOcpp/Core/FilesystemAdapter.h
index 8a78e3cd..df1e2671 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.h
+++ b/src/MicroOcpp/Core/FilesystemAdapter.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_FILESYSTEMADAPTER_H
-#define MOCPP_FILESYSTEMADAPTER_H
+#ifndef MO_FILESYSTEMADAPTER_H
+#define MO_FILESYSTEMADAPTER_H
 
 #include <memory>
 #include <functional>
@@ -11,8 +11,8 @@
 #include <MicroOcpp/Platform.h>
 #include <MicroOcpp/Core/ConfigurationOptions.h>
 
-#ifndef MOCPP_FILENAME_PREFIX
-#define MOCPP_FILENAME_PREFIX "/"
+#ifndef MO_FILENAME_PREFIX
+#define MO_FILENAME_PREFIX "/"
 #endif
 
 #define DISABLE_FS       0
@@ -22,28 +22,28 @@
 #define POSIX_FILEAPI    4
 
 // choose FileAPI if not given by build flag; assume usage with Arduino if no build flags are present
-#ifndef MOCPP_USE_FILEAPI
-#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO
+#ifndef MO_USE_FILEAPI
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO
 #if defined(ESP32)
-#define MOCPP_USE_FILEAPI ARDUINO_LITTLEFS
+#define MO_USE_FILEAPI ARDUINO_LITTLEFS
 #else
-#define MOCPP_USE_FILEAPI ARDUINO_SPIFFS
+#define MO_USE_FILEAPI ARDUINO_SPIFFS
 #endif
-#elif MOCPP_PLATFORM == MOCPP_PLATFORM_ESPIDF
-#define MOCPP_USE_FILEAPI ESPIDF_SPIFFS
-#elif MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
-#define MOCPP_USE_FILEAPI POSIX_FILEAPI
+#elif MO_PLATFORM == MO_PLATFORM_ESPIDF
+#define MO_USE_FILEAPI ESPIDF_SPIFFS
+#elif MO_PLATFORM == MO_PLATFORM_UNIX
+#define MO_USE_FILEAPI POSIX_FILEAPI
 #else
-#define MOCPP_USE_FILEAPI DISABLE_FS
-#endif //switch-case MOCPP_PLATFORM
-#endif //ndef MOCPP_USE_FILEAPI
+#define MO_USE_FILEAPI DISABLE_FS
+#endif //switch-case MO_PLATFORM
+#endif //ndef MO_USE_FILEAPI
 
 // set default max path size parameters
-#ifndef MOCPP_MAX_PATH_SIZE
-#if MOCPP_USE_FILEAPI == POSIX_FILEAPI
-#define MOCPP_MAX_PATH_SIZE 128
+#ifndef MO_MAX_PATH_SIZE
+#if MO_USE_FILEAPI == POSIX_FILEAPI
+#define MO_MAX_PATH_SIZE 128
 #else
-#define MOCPP_MAX_PATH_SIZE 30
+#define MO_MAX_PATH_SIZE 30
 #endif
 #endif
 
diff --git a/src/MicroOcpp/Core/FilesystemUtils.cpp b/src/MicroOcpp/Core/FilesystemUtils.cpp
index dc409417..22f85863 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.cpp
+++ b/src/MicroOcpp/Core/FilesystemUtils.cpp
@@ -11,30 +11,30 @@ using namespace MicroOcpp;
 
 std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn) {
     if (!filesystem || !fn || *fn == '\0') {
-        MOCPP_DBG_ERR("Format error");
+        MO_DBG_ERR("Format error");
         return nullptr;
     }
 
-    if (strnlen(fn, MOCPP_MAX_PATH_SIZE) >= MOCPP_MAX_PATH_SIZE) {
-        MOCPP_DBG_ERR("Fn too long: %.*s", MOCPP_MAX_PATH_SIZE, fn);
+    if (strnlen(fn, MO_MAX_PATH_SIZE) >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("Fn too long: %.*s", MO_MAX_PATH_SIZE, fn);
         return nullptr;
     }
     
     size_t fsize = 0;
     if (filesystem->stat(fn, &fsize) != 0) {
-        MOCPP_DBG_DEBUG("File does not exist: %s", fn);
+        MO_DBG_DEBUG("File does not exist: %s", fn);
         return nullptr;
     }
 
     if (fsize < 2) {
-        MOCPP_DBG_ERR("File too small for JSON, collect %s", fn);
+        MO_DBG_ERR("File too small for JSON, collect %s", fn);
         filesystem->remove(fn);
         return nullptr;
     }
 
     auto file = filesystem->open(fn, "r");
     if (!file) {
-        MOCPP_DBG_ERR("Could not open file %s", fn);
+        MO_DBG_ERR("Could not open file %s", fn);
         return nullptr;
     }
 
@@ -43,18 +43,18 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
     //capacity = ceil capacity_init to the next power of two; should be at least 128
 
     size_t capacity = 128;
-    while (capacity < capacity_init && capacity < MOCPP_MAX_JSON_CAPACITY) {
+    while (capacity < capacity_init && capacity < MO_MAX_JSON_CAPACITY) {
         capacity *= 2;
     }
-    if (capacity > MOCPP_MAX_JSON_CAPACITY) {
-        capacity = MOCPP_MAX_JSON_CAPACITY;
+    if (capacity > MO_MAX_JSON_CAPACITY) {
+        capacity = MO_MAX_JSON_CAPACITY;
     }
     
     auto doc = std::unique_ptr<DynamicJsonDocument>(nullptr);
     DeserializationError err = DeserializationError::NoMemory;
     ArduinoJsonFileAdapter fileReader {file.get()};
 
-    while (err == DeserializationError::NoMemory && capacity <= MOCPP_MAX_JSON_CAPACITY) {
+    while (err == DeserializationError::NoMemory && capacity <= MO_MAX_JSON_CAPACITY) {
 
         doc.reset(new DynamicJsonDocument(capacity));
         err = deserializeJson(*doc, fileReader);
@@ -65,35 +65,35 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
     }
 
     if (err) {
-        MOCPP_DBG_ERR("Error deserializing file %s: %s", fn, err.c_str());
+        MO_DBG_ERR("Error deserializing file %s: %s", fn, err.c_str());
         //skip this file
         return nullptr;
     }
 
-    MOCPP_DBG_DEBUG("Loaded JSON file: %s", fn);
+    MO_DBG_DEBUG("Loaded JSON file: %s", fn);
 
     return doc;
 }
 
 bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const DynamicJsonDocument& doc) {
     if (!filesystem || !fn || *fn == '\0') {
-        MOCPP_DBG_ERR("Format error");
+        MO_DBG_ERR("Format error");
         return false;
     }
 
-    if (strnlen(fn, MOCPP_MAX_PATH_SIZE) >= MOCPP_MAX_PATH_SIZE) {
-        MOCPP_DBG_ERR("Fn too long: %.*s", MOCPP_MAX_PATH_SIZE, fn);
+    if (strnlen(fn, MO_MAX_PATH_SIZE) >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("Fn too long: %.*s", MO_MAX_PATH_SIZE, fn);
         return false;
     }
 
     if (doc.isNull() || doc.overflowed()) {
-        MOCPP_DBG_ERR("Invalid JSON %s", fn);
+        MO_DBG_ERR("Invalid JSON %s", fn);
         return false;
     }
 
     auto file = filesystem->open(fn, "w");
     if (!file) {
-        MOCPP_DBG_ERR("Could not open file %s", fn);
+        MO_DBG_ERR("Could not open file %s", fn);
         return false;
     }
 
@@ -102,16 +102,16 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
     size_t written = serializeJson(doc, fileWriter);
 
     if (written < 2) {
-        MOCPP_DBG_ERR("Error writing file %s", fn);
+        MO_DBG_ERR("Error writing file %s", fn);
         size_t file_size = 0;
         if (filesystem->stat(fn, &file_size) == 0) {
-            MOCPP_DBG_DEBUG("Collect invalid file %s", fn);
+            MO_DBG_DEBUG("Collect invalid file %s", fn);
             filesystem->remove(fn);
         }
         return false;
     }
 
-    MOCPP_DBG_DEBUG("Wrote JSON file: %s", fn);
+    MO_DBG_DEBUG("Wrote JSON file: %s", fn);
     return true;
 }
 
@@ -119,10 +119,10 @@ bool FilesystemUtils::remove_if(std::shared_ptr<FilesystemAdapter> filesystem, s
     return filesystem->ftw_root([filesystem, pred] (const char *fpath) {
         if (pred(fpath) && fpath[0] != '.') {
 
-            char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "%s", fpath);
-            if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-                MOCPP_DBG_ERR("fn error: %i", ret);
+            char fn [MO_MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "%s", fpath);
+            if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+                MO_DBG_ERR("fn error: %i", ret);
                 return -1;
             }
 
diff --git a/src/MicroOcpp/Core/FilesystemUtils.h b/src/MicroOcpp/Core/FilesystemUtils.h
index 4f4e3f16..1845d3cd 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.h
+++ b/src/MicroOcpp/Core/FilesystemUtils.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_FILESYSTEMUTILS_H
-#define MOCPP_FILESYSTEMUTILS_H
+#ifndef MO_FILESYSTEMUTILS_H
+#define MO_FILESYSTEMUTILS_H
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <ArduinoJson.h>
diff --git a/src/MicroOcpp/Core/Operation.cpp b/src/MicroOcpp/Core/Operation.cpp
index b3ca3a14..9dc887fa 100644
--- a/src/MicroOcpp/Core/Operation.cpp
+++ b/src/MicroOcpp/Core/Operation.cpp
@@ -13,7 +13,7 @@ Operation::Operation() {}
 Operation::~Operation() {}
   
 const char* Operation::getOperationType(){
-    MOCPP_DBG_ERR("Unsupported operation: getOperationType() is not implemented");
+    MO_DBG_ERR("Unsupported operation: getOperationType() is not implemented");
     return "CustomOperation";
 }
 
@@ -26,20 +26,20 @@ bool Operation::restore(StoredOperationHandler *rpcData) {
 }
 
 std::unique_ptr<DynamicJsonDocument> Operation::createReq() {
-    MOCPP_DBG_ERR("Unsupported operation: createReq() is not implemented");
+    MO_DBG_ERR("Unsupported operation: createReq() is not implemented");
     return createEmptyDocument();
 }
 
 void Operation::processConf(JsonObject payload) {
-    MOCPP_DBG_ERR("Unsupported operation: processConf() is not implemented");
+    MO_DBG_ERR("Unsupported operation: processConf() is not implemented");
 }
 
 void Operation::processReq(JsonObject payload) {
-    MOCPP_DBG_ERR("Unsupported operation: processReq() is not implemented");
+    MO_DBG_ERR("Unsupported operation: processReq() is not implemented");
 }
 
 std::unique_ptr<DynamicJsonDocument> Operation::createConf() {
-    MOCPP_DBG_ERR("Unsupported operation: createConf() is not implemented");
+    MO_DBG_ERR("Unsupported operation: createConf() is not implemented");
     return createEmptyDocument();
 }
 
diff --git a/src/MicroOcpp/Core/Operation.h b/src/MicroOcpp/Core/Operation.h
index 18cd9cd6..0018a453 100644
--- a/src/MicroOcpp/Core/Operation.h
+++ b/src/MicroOcpp/Core/Operation.h
@@ -15,8 +15,8 @@
  * OCPP operation.
  */
 
- #ifndef MOCPP_OPERATION_H
- #define MOCPP_OPERATION_H
+ #ifndef MO_OPERATION_H
+ #define MO_OPERATION_H
 
 #include <ArduinoJson.h>
 #include <memory>
diff --git a/src/MicroOcpp/Core/OperationRegistry.cpp b/src/MicroOcpp/Core/OperationRegistry.cpp
index 4700360d..2960c24d 100644
--- a/src/MicroOcpp/Core/OperationRegistry.cpp
+++ b/src/MicroOcpp/Core/OperationRegistry.cpp
@@ -37,14 +37,14 @@ void OperationRegistry::registerOperation(const char *operationType, std::functi
 
     registry.push_back(entry);
 
-    MOCPP_DBG_DEBUG("registered operation %s", operationType);
+    MO_DBG_DEBUG("registered operation %s", operationType);
 }
 
 void OperationRegistry::setOnRequest(const char *operationType, OnReceiveReqListener onRequest) {
     if (auto entry = findCreator(operationType)) {
         entry->onRequest = onRequest;
     } else {
-        MOCPP_DBG_ERR("%s not registered", operationType);
+        MO_DBG_ERR("%s not registered", operationType);
     }
 }
 
@@ -52,7 +52,7 @@ void OperationRegistry::setOnResponse(const char *operationType, OnSendConfListe
     if (auto entry = findCreator(operationType)) {
         entry->onResponse = onResponse;
     } else {
-        MOCPP_DBG_ERR("%s not registered", operationType);
+        MO_DBG_ERR("%s not registered", operationType);
     }
 }
 
@@ -75,6 +75,6 @@ std::unique_ptr<Request> OperationRegistry::deserializeOperation(const char *ope
 
 void OperationRegistry::debugPrint() {
     for (auto& creator : registry) {
-        MOCPP_CONSOLE_PRINTF("[OCPP]     > %s\n", creator.operationType);
+        MO_CONSOLE_PRINTF("[OCPP]     > %s\n", creator.operationType);
     }
 }
diff --git a/src/MicroOcpp/Core/OperationRegistry.h b/src/MicroOcpp/Core/OperationRegistry.h
index 02dad9ff..23bba2e4 100644
--- a/src/MicroOcpp/Core/OperationRegistry.h
+++ b/src/MicroOcpp/Core/OperationRegistry.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_OPERATIONREGISTRY_H
-#define MOCPP_OPERATIONREGISTRY_H
+#ifndef MO_OPERATIONREGISTRY_H
+#define MO_OPERATIONREGISTRY_H
 
 #include <functional>
 #include <vector>
diff --git a/src/MicroOcpp/Core/PollResult.h b/src/MicroOcpp/Core/PollResult.h
index aaa81349..802f305c 100644
--- a/src/MicroOcpp/Core/PollResult.h
+++ b/src/MicroOcpp/Core/PollResult.h
@@ -28,7 +28,7 @@ class PollResult {
     PollResult(PollResult<T>&& other) : ready(other.ready), value(std::move(other.value)) {}
     T&& toValue() {
         if (!ready) {
-            MOCPP_DBG_ERR("Not ready");
+            MO_DBG_ERR("Not ready");
             (void)0;
         }
         ready = false;
@@ -36,7 +36,7 @@ class PollResult {
     }
     T& getValue() const {
         if (!ready) {
-            MOCPP_DBG_ERR("Not ready");
+            MO_DBG_ERR("Not ready");
             (void)0;
         }
         return *value;
diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index fe3184e7..c3dd1821 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -56,7 +56,7 @@ unsigned int Request::getTrialNo() {
 
 void Request::setMessageID(const std::string &id){
     if (!messageID.empty()){
-        MOCPP_DBG_WARN("MessageID is set twice or is set after first usage!");
+        MO_DBG_WARN("MessageID is set twice or is set after first usage!");
     }
     messageID = id;
 }
@@ -86,7 +86,7 @@ std::unique_ptr<DynamicJsonDocument> Request::createRequest(){
     requestJson->add(operation->getOperationType());  //Action
     requestJson->add(*requestPayload);                      //Payload
 
-    if (MOCPP_DBG_LEVEL >= MOCPP_DL_DEBUG && mocpp_tick_ms() - debugRequest_start >= 10000) { //print contents on the console
+    if (MO_DBG_LEVEL >= MO_DL_DEBUG && mocpp_tick_ms() - debugRequest_start >= 10000) { //print contents on the console
         debugRequest_start = mocpp_tick_ms();
 
         char *buf = new char[1024];
@@ -96,9 +96,9 @@ std::unique_ptr<DynamicJsonDocument> Request::createRequest(){
         }
 
         if (!buf || len < 1) {
-            MOCPP_DBG_DEBUG("Try to send request: %s", operation->getOperationType());
+            MO_DBG_DEBUG("Try to send request: %s", operation->getOperationType());
         } else {
-            MOCPP_DBG_DEBUG("Try to send request: %.*s (...)", 128, buf);
+            MO_DBG_DEBUG("Try to send request: %.*s (...)", 128, buf);
         }
 
         delete[] buf;
@@ -153,7 +153,7 @@ bool Request::receiveResponse(JsonArray response){
 
         return abortOperation;
     } else {
-        MOCPP_DBG_WARN("invalid response");
+        MO_DBG_WARN("invalid response");
         return false; //don't discard this message but retry sending it
     }
 
@@ -274,13 +274,13 @@ void Request::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
             opStore->clearBuffer();
         }
     } else {
-        MOCPP_DBG_ERR("Missing operation instance");
+        MO_DBG_ERR("Missing operation instance");
     }
 }
 
 bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *model) {
     if (!opStorage) {
-        MOCPP_DBG_ERR("invalid argument");
+        MO_DBG_ERR("invalid argument");
         return false;
     }
 
@@ -288,14 +288,14 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
 
     auto rpcData = opStore->getRpcData();
     if (!rpcData) {
-        MOCPP_DBG_ERR("corrupted storage");
+        MO_DBG_ERR("corrupted storage");
         return false;
     }
 
     messageID = (*rpcData)[1] | std::string();
     std::string opType = (*rpcData)[2] | std::string();
     if (messageID.empty() || opType.empty()) {
-        MOCPP_DBG_ERR("corrupted storage");
+        MO_DBG_ERR("corrupted storage");
         messageID.clear();
         return false;
     }
@@ -303,11 +303,11 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
     int parsedMessageID = -1;
     if (sscanf(messageID.c_str(), "%d", &parsedMessageID) == 1) {
         if (parsedMessageID > unique_id_counter) {
-            MOCPP_DBG_DEBUG("restore unique_id_counter with %d", parsedMessageID);
+            MO_DBG_DEBUG("restore unique_id_counter with %d", parsedMessageID);
             unique_id_counter = parsedMessageID + 1; //next unique value is parsedId + 1
         }
     } else {
-        MOCPP_DBG_ERR("cannot set unique msgID counter");
+        MO_DBG_ERR("cannot set unique msgID counter");
         (void)0;
         //skip this step but don't abort restore
     }
@@ -321,7 +321,7 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
     }
 
     if (!operation) {
-        MOCPP_DBG_ERR("cannot create msg");
+        MO_DBG_ERR("cannot create msg");
         return false;
     }
 
@@ -329,10 +329,10 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
     opStore->clearBuffer();
 
     if (success) {
-        MOCPP_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), operation->getOperationType());
+        MO_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), operation->getOperationType());
         (void)0;
     } else {
-        MOCPP_DBG_ERR("restore opNr %i error", opStore->getOpNr());
+        MO_DBG_ERR("restore opNr %i error", opStore->getOpNr());
         (void)0;
     }
 
diff --git a/src/MicroOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
index f1058b7e..07a56627 100644
--- a/src/MicroOcpp/Core/Request.h
+++ b/src/MicroOcpp/Core/Request.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_REQUEST_H
-#define MOCPP_REQUEST_H
+#ifndef MO_REQUEST_H
+#define MO_REQUEST_H
 
 #define MESSAGE_TYPE_CALL 2
 #define MESSAGE_TYPE_CALLRESULT 3
diff --git a/src/MicroOcpp/Core/RequestCallbacks.h b/src/MicroOcpp/Core/RequestCallbacks.h
index b7aa2909..33209a8d 100644
--- a/src/MicroOcpp/Core/RequestCallbacks.h
+++ b/src/MicroOcpp/Core/RequestCallbacks.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_REQUESTCALLBACKS_H
-#define MOCPP_REQUESTCALLBACKS_H
+#ifndef MO_REQUESTCALLBACKS_H
+#define MO_REQUESTCALLBACKS_H
 
 #include <ArduinoJson.h>
 #include <functional>
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index 9c24cae1..b247d0de 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -42,7 +42,7 @@ void RequestQueue::loop(Connection& ocppSock) {
     initiatedRequests->drop_if([] (std::unique_ptr<Request>& op) -> bool {
         bool timed_out = op->isTimeoutExceeded();
         if (timed_out) {
-            MOCPP_DBG_INFO("operation timeout: %s", op->getOperationType());
+            MO_DBG_INFO("operation timeout: %s", op->getOperationType());
             op->executeTimeout();
         }
         return timed_out;
@@ -65,7 +65,7 @@ void RequestQueue::loop(Connection& ocppSock) {
             bool success = ocppSock.sendTXT(out.c_str(), out.length());
 
             if (success) {
-                MOCPP_DBG_TRAFFIC_OUT(out.c_str());
+                MO_DBG_TRAFFIC_OUT(out.c_str());
                 receivedRequests.erase(received);
             }
 
@@ -116,7 +116,7 @@ void RequestQueue::loop(Connection& ocppSock) {
     bool success = ocppSock.sendTXT(out.c_str(), out.length());
 
     if (success) {
-        MOCPP_DBG_TRAFFIC_OUT(out.c_str());
+        MO_DBG_TRAFFIC_OUT(out.c_str());
 
         //update backoff time
         sendBackoffTime = mocpp_tick_ms();
@@ -126,7 +126,7 @@ void RequestQueue::loop(Connection& ocppSock) {
 
 void RequestQueue::sendRequest(std::unique_ptr<Request> op){
     if (!op) {
-        MOCPP_DBG_ERR("Called with null. Ignore");
+        MO_DBG_ERR("Called with null. Ignore");
         return;
     }
     
@@ -135,24 +135,24 @@ void RequestQueue::sendRequest(std::unique_ptr<Request> op){
 
 bool RequestQueue::receiveMessage(const char* payload, size_t length) {
 
-    MOCPP_DBG_TRAFFIC_IN((int) length, payload);
+    MO_DBG_TRAFFIC_IN((int) length, payload);
 
     size_t capacity_init = (3 * length) / 2;
 
     //capacity = ceil capacity_init to the next power of two; should be at least 128
 
     size_t capacity = 128;
-    while (capacity < capacity_init && capacity < MOCPP_MAX_JSON_CAPACITY) {
+    while (capacity < capacity_init && capacity < MO_MAX_JSON_CAPACITY) {
         capacity *= 2;
     }
-    if (capacity > MOCPP_MAX_JSON_CAPACITY) {
-        capacity = MOCPP_MAX_JSON_CAPACITY;
+    if (capacity > MO_MAX_JSON_CAPACITY) {
+        capacity = MO_MAX_JSON_CAPACITY;
     }
     
     DynamicJsonDocument doc {0};
     DeserializationError err = DeserializationError::NoMemory;
 
-    while (err == DeserializationError::NoMemory && capacity <= MOCPP_MAX_JSON_CAPACITY) {
+    while (err == DeserializationError::NoMemory && capacity <= MO_MAX_JSON_CAPACITY) {
 
         doc = DynamicJsonDocument(capacity);
         err = deserializeJson(doc, payload, length);
@@ -174,15 +174,15 @@ bool RequestQueue::receiveMessage(const char* payload, size_t length) {
                 receiveResponse(doc.as<JsonArray>());
                 success = true;
             } else {
-                MOCPP_DBG_WARN("Invalid OCPP message! (though JSON has successfully been deserialized)");
+                MO_DBG_WARN("Invalid OCPP message! (though JSON has successfully been deserialized)");
             }
             break; 
         }
         case DeserializationError::InvalidInput:
-            MOCPP_DBG_WARN("Invalid input! Not a JSON");
+            MO_DBG_WARN("Invalid input! Not a JSON");
             break;
         case DeserializationError::NoMemory: {
-            MOCPP_DBG_WARN("incoming operation exceeds buffer capacity. Input length = %zu, max capacity = %d", length, MOCPP_MAX_JSON_CAPACITY);
+            MO_DBG_WARN("incoming operation exceeds buffer capacity. Input length = %zu, max capacity = %d", length, MO_MAX_JSON_CAPACITY);
 
             /*
                 * If websocket input is of message type MESSAGE_TYPE_CALL, send back a message of type MESSAGE_TYPE_CALLERROR.
@@ -198,19 +198,19 @@ bool RequestQueue::receiveMessage(const char* payload, size_t length) {
                 int messageTypeId = doc[0] | -1;
                 if (messageTypeId == MESSAGE_TYPE_CALL) {
                     success = true;
-                    auto op = makeRequest(new MsgBufferExceeded(MOCPP_MAX_JSON_CAPACITY, length));
+                    auto op = makeRequest(new MsgBufferExceeded(MO_MAX_JSON_CAPACITY, length));
                     receiveRequest(doc.as<JsonArray>(), std::move(op));
                 } else if (messageTypeId == MESSAGE_TYPE_CALLRESULT ||
                             messageTypeId == MESSAGE_TYPE_CALLERROR) {
                     success = true;
-                    MOCPP_DBG_WARN("crop incoming response");
+                    MO_DBG_WARN("crop incoming response");
                     receiveResponse(doc.as<JsonArray>());
                 }
             }
             break;
         }
         default:
-            MOCPP_DBG_WARN("Deserialization failed: %s", err.c_str());
+            MO_DBG_WARN("Deserialization failed: %s", err.c_str());
             break;
     }
 
@@ -241,10 +241,10 @@ void RequestQueue::receiveResponse(JsonArray json) {
     if (!success) {
         //didn't find matching Request
         if (json[0] == MESSAGE_TYPE_CALLERROR) {
-            MOCPP_DBG_DEBUG("Received CALLERROR did not abort a pending operation");
+            MO_DBG_DEBUG("Received CALLERROR did not abort a pending operation");
             (void)0;
         } else {
-            MOCPP_DBG_WARN("Received response doesn't match any pending operation");
+            MO_DBG_WARN("Received response doesn't match any pending operation");
             (void)0;
         }
     }
@@ -253,7 +253,7 @@ void RequestQueue::receiveResponse(JsonArray json) {
 void RequestQueue::receiveRequest(JsonArray json) {
     auto op = operationRegistry.deserializeOperation(json[2] | "UNDEFINED");
     if (op == nullptr) {
-        MOCPP_DBG_WARN("OOM");
+        MO_DBG_WARN("OOM");
         return;
     }
     receiveRequest(json, std::move(op));
diff --git a/src/MicroOcpp/Core/RequestQueue.h b/src/MicroOcpp/Core/RequestQueue.h
index b6b37af2..5ce7e03d 100644
--- a/src/MicroOcpp/Core/RequestQueue.h
+++ b/src/MicroOcpp/Core/RequestQueue.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_REQUESTQUEUE_H
-#define MOCPP_REQUESTQUEUE_H
+#ifndef MO_REQUESTQUEUE_H
+#define MO_REQUESTQUEUE_H
 
 #include <MicroOcpp/Core/RequestQueueStorageStrategy.h>
 
diff --git a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
index 816dec3d..caa7e0e0 100644
--- a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
+++ b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
@@ -12,7 +12,7 @@
 
 #include <algorithm>
 
-#define MOCPP_OPERATIONCACHE_MAXSIZE 10
+#define MO_OPERATIONCACHE_MAXSIZE 10
 
 using namespace MicroOcpp;
 
@@ -40,8 +40,8 @@ void VolatileRequestQueue::push_back(std::unique_ptr<Request> op) {
 
     op->initiate(nullptr);
 
-    if (queue.size() >= MOCPP_OPERATIONCACHE_MAXSIZE) {
-        MOCPP_DBG_WARN("unsafe number of cached operations");
+    if (queue.size() >= MO_OPERATIONCACHE_MAXSIZE) {
+        MO_DBG_WARN("unsafe number of cached operations");
         (void)0;
     }
 
@@ -61,7 +61,7 @@ PersistentRequestQueue::~PersistentRequestQueue() {
 
 Request *PersistentRequestQueue::front() {
     if (!head && !tailCache.empty()) {
-        MOCPP_DBG_ERR("invalid state");
+        MO_DBG_ERR("invalid state");
         pop_front();
     }
     return head.get();
@@ -71,7 +71,7 @@ void PersistentRequestQueue::pop_front() {
     
     if (head && head->getStorageHandler() && head->getStorageHandler()->getOpNr() >= 0) {
         opStore.advanceOpNr(head->getStorageHandler()->getOpNr());
-        MOCPP_DBG_DEBUG("advanced %i to %u", head->getStorageHandler()->getOpNr(), opStore.getOpBegin());
+        MO_DBG_DEBUG("advanced %i to %u", head->getStorageHandler()->getOpNr(), opStore.getOpBegin());
     }
 
     head.reset();
@@ -102,7 +102,7 @@ void PersistentRequestQueue::pop_front() {
         
         std::unique_ptr<Request> fetched;
 
-        unsigned int range = (opStore.getOpEnd() + MOCPP_MAX_OPNR - nextOpNr) % MOCPP_MAX_OPNR;
+        unsigned int range = (opStore.getOpEnd() + MO_MAX_OPNR - nextOpNr) % MO_MAX_OPNR;
         for (size_t i = 0; i < range; i++) {
             bool exists = storageHandler->restore(nextOpNr);
             if (exists) {
@@ -117,21 +117,21 @@ void PersistentRequestQueue::pop_front() {
                     break;
                 }
 
-                MOCPP_DBG_ERR("could not restore operation");
+                MO_DBG_ERR("could not restore operation");
                 fetched.reset();
                 opStore.advanceOpNr(nextOpNr);
                 nextOpNr = opStore.getOpBegin();
             } else {
                 //didn't find anything at this slot. Try next slot
                 nextOpNr++;
-                nextOpNr %= MOCPP_MAX_OPNR;
+                nextOpNr %= MO_MAX_OPNR;
             }
         }
 
         if (fetched) {
             //found operation in flash -> case B)
             head = std::move(fetched);
-            MOCPP_DBG_DEBUG("restored operation from flash");
+            MO_DBG_DEBUG("restored operation from flash");
         } else {
             //no operation anymore in flash -> case A) -> take next queued operation in tailCache
             if (tailCache.empty()) {
@@ -143,7 +143,7 @@ void PersistentRequestQueue::pop_front() {
         }
     }
 
-    MOCPP_DBG_VERBOSE("popped front");
+    MO_DBG_VERBOSE("popped front");
 }
 
 void PersistentRequestQueue::push_back(std::unique_ptr<Request> op) {
@@ -151,15 +151,15 @@ void PersistentRequestQueue::push_back(std::unique_ptr<Request> op) {
     op->initiate(opStore.makeOpHandler());
 
     if (!head && !tailCache.empty()) {
-        MOCPP_DBG_ERR("invalid state");
+        MO_DBG_ERR("invalid state");
         pop_front();
     }
 
     if (!head) {
         head = std::move(op);
     } else {
-        if (tailCache.size() >= MOCPP_OPERATIONCACHE_MAXSIZE) {
-            MOCPP_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOperationType());
+        if (tailCache.size() >= MO_OPERATIONCACHE_MAXSIZE) {
+            MO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOperationType());
             tailCache.front()->executeTimeout();
             tailCache.pop_front();
         }
diff --git a/src/MicroOcpp/Core/RequestStore.cpp b/src/MicroOcpp/Core/RequestStore.cpp
index e5f4dac0..4fa602af 100644
--- a/src/MicroOcpp/Core/RequestStore.cpp
+++ b/src/MicroOcpp/Core/RequestStore.cpp
@@ -8,33 +8,33 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Debug.h>
 
-#define MOCPP_OPSTORE_FN MOCPP_FILENAME_PREFIX "opstore.jsn"
+#define MO_OPSTORE_FN MO_FILENAME_PREFIX "opstore.jsn"
 
-#define MOCPP_OPHISTORY_SIZE 3
+#define MO_OPHISTORY_SIZE 3
 
 using namespace MicroOcpp;
 
 bool StoredOperationHandler::commit() {
     if (isPersistent) {
-        MOCPP_DBG_ERR("cannot call two times");
+        MO_DBG_ERR("cannot call two times");
         return false;
     }
     if (!filesystem) {
-        MOCPP_DBG_DEBUG("filesystem");
+        MO_DBG_DEBUG("filesystem");
         return false;
     }
 
     if (!rpc || !payload) {
-        MOCPP_DBG_ERR("unitialized");
+        MO_DBG_ERR("unitialized");
         return false;
     }
 
     opNr = context.reserveOpNr();
 
-    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "op" "-%u.jsn", opNr);
-    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-        MOCPP_DBG_ERR("fn error: %i", ret);
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "op" "-%u.jsn", opNr);
+    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("fn error: %i", ret);
         return false;
     }
 
@@ -43,7 +43,7 @@ bool StoredOperationHandler::commit() {
     doc["payload"] = *payload;
 
     if (!FilesystemUtils::storeJson(filesystem, fn, doc)) {
-        MOCPP_DBG_ERR("FS error");
+        MO_DBG_ERR("FS error");
         return false;
     }
 
@@ -53,32 +53,32 @@ bool StoredOperationHandler::commit() {
 
 bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
     if (isPersistent) {
-        MOCPP_DBG_ERR("cannot restore after commit");
+        MO_DBG_ERR("cannot restore after commit");
         return false;
     }
     if (!filesystem) {
-        MOCPP_DBG_DEBUG("filesystem");
+        MO_DBG_DEBUG("filesystem");
         return false;
     }
 
     opNr = opNrToLoad;
 
-    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "op" "-%u.jsn", opNr);
-    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-        MOCPP_DBG_ERR("fn error: %i", ret);
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "op" "-%u.jsn", opNr);
+    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("fn error: %i", ret);
         return false;
     }
 
     size_t msize;
     if (filesystem->stat(fn, &msize) != 0) {
-        MOCPP_DBG_VERBOSE("operation %u does not exist", opNr);
+        MO_DBG_VERBOSE("operation %u does not exist", opNr);
         return false;
     }
 
     auto doc = FilesystemUtils::loadJson(filesystem, fn);
     if (!doc) {
-        MOCPP_DBG_ERR("FS error");
+        MO_DBG_ERR("FS error");
         return false;
     }
     
@@ -96,37 +96,37 @@ bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
 }
 
 RequestStore::RequestStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
-    opBeginInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "opBegin", 0, MOCPP_OPSTORE_FN, false, false, false);
-    configuration_load(MOCPP_OPSTORE_FN);
+    opBeginInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "opBegin", 0, MO_OPSTORE_FN, false, false, false);
+    configuration_load(MO_OPSTORE_FN);
 
     if (!opBeginInt || opBeginInt->getInt() < 0) {
-        MOCPP_DBG_ERR("init failure");
+        MO_DBG_ERR("init failure");
     } else if (filesystem) {
         opEnd = opBeginInt->getInt();
 
         unsigned int misses = 0;
         unsigned int i = opEnd;
         while (misses < 3) {
-            char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "op" "-%u.jsn", i);
-            if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-                MOCPP_DBG_ERR("fn error: %i", ret);
+            char fn [MO_MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "op" "-%u.jsn", i);
+            if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+                MO_DBG_ERR("fn error: %i", ret);
                 misses++;
-                i = (i + 1) % MOCPP_MAX_OPNR;
+                i = (i + 1) % MO_MAX_OPNR;
                 continue;
             }
 
             size_t msize;
             if (filesystem->stat(fn, &msize) != 0) {
-                MOCPP_DBG_DEBUG("operation %u does not exist", i);
+                MO_DBG_DEBUG("operation %u does not exist", i);
                 misses++;
-                i = (i + 1) % MOCPP_MAX_OPNR;
+                i = (i + 1) % MO_MAX_OPNR;
                 continue;
             }
 
             //file exists
             misses = 0;
-            i = (i + 1) % MOCPP_MAX_OPNR;
+            i = (i + 1) % MO_MAX_OPNR;
             opEnd = i;
         }
     }
@@ -137,68 +137,68 @@ std::unique_ptr<StoredOperationHandler> RequestStore::makeOpHandler() {
 }
 
 unsigned int RequestStore::reserveOpNr() {
-    MOCPP_DBG_DEBUG("reserved opNr %u", opEnd);
+    MO_DBG_DEBUG("reserved opNr %u", opEnd);
     auto res = opEnd;
     opEnd++;
-    opEnd %= MOCPP_MAX_OPNR;
+    opEnd %= MO_MAX_OPNR;
     return res;
 }
 
 void RequestStore::advanceOpNr(unsigned int oldOpNr) {
     if (!opBeginInt || opBeginInt->getInt() < 0) {
-        MOCPP_DBG_ERR("init failure");
+        MO_DBG_ERR("init failure");
         return;
     }
 
     if (oldOpNr != (unsigned int) opBeginInt->getInt()) {
-        if ((oldOpNr + MOCPP_MAX_OPNR - (unsigned int) opBeginInt->getInt()) % MOCPP_MAX_OPNR < 100) {
-            MOCPP_DBG_ERR("synchronization failure - try to fix");
+        if ((oldOpNr + MO_MAX_OPNR - (unsigned int) opBeginInt->getInt()) % MO_MAX_OPNR < 100) {
+            MO_DBG_ERR("synchronization failure - try to fix");
             (void)0;
         } else {
-            MOCPP_DBG_ERR("synchronization failure");
+            MO_DBG_ERR("synchronization failure");
             return;
         }
     }
 
-    unsigned int opNr = (oldOpNr + 1) % MOCPP_MAX_OPNR;
+    unsigned int opNr = (oldOpNr + 1) % MO_MAX_OPNR;
 
     //delete range [opBeginInt->getInt() ... opNr)
 
-    unsigned int rangeSize = (opNr + MOCPP_MAX_OPNR - (unsigned int) opBeginInt->getInt()) % MOCPP_MAX_OPNR;
+    unsigned int rangeSize = (opNr + MO_MAX_OPNR - (unsigned int) opBeginInt->getInt()) % MO_MAX_OPNR;
 
-    MOCPP_DBG_DEBUG("delete %u operations", rangeSize);
+    MO_DBG_DEBUG("delete %u operations", rangeSize);
 
     for (unsigned int i = 0; i < rangeSize; i++) {
-        unsigned int op = ((unsigned int) opBeginInt->getInt() + i + MOCPP_MAX_OPNR - MOCPP_OPHISTORY_SIZE) % MOCPP_MAX_OPNR;
+        unsigned int op = ((unsigned int) opBeginInt->getInt() + i + MO_MAX_OPNR - MO_OPHISTORY_SIZE) % MO_MAX_OPNR;
 
-        char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "op" "-%u.jsn", op);
-        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-            MOCPP_DBG_ERR("fn error: %i", ret);
+        char fn [MO_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "op" "-%u.jsn", op);
+        if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+            MO_DBG_ERR("fn error: %i", ret);
             break;
         }
 
         size_t msize;
         if (filesystem->stat(fn, &msize) != 0) {
-            MOCPP_DBG_DEBUG("operation %u does not exist", i);
+            MO_DBG_DEBUG("operation %u does not exist", i);
             continue;
         }
 
         bool success = filesystem->remove(fn);
         if (!success) {
-            MOCPP_DBG_ERR("error deleting %s", fn);
+            MO_DBG_ERR("error deleting %s", fn);
             (void)0;
         }
     }
 
-    MOCPP_DBG_DEBUG("advance opBegin: %u", opNr);
+    MO_DBG_DEBUG("advance opBegin: %u", opNr);
     opBeginInt->setInt(opNr);
     configuration_save();
 }
 
 unsigned int RequestStore::getOpBegin() {
     if (!opBeginInt || opBeginInt->getInt() < 0) {
-        MOCPP_DBG_ERR("invalid state");
+        MO_DBG_ERR("invalid state");
         return 0;
     }
     return (unsigned int) opBeginInt->getInt();
diff --git a/src/MicroOcpp/Core/RequestStore.h b/src/MicroOcpp/Core/RequestStore.h
index e276539f..e6320ef5 100644
--- a/src/MicroOcpp/Core/RequestStore.h
+++ b/src/MicroOcpp/Core/RequestStore.h
@@ -2,14 +2,14 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_REQUESTSTORE_H
-#define MOCPP_REQUESTSTORE_H
+#ifndef MO_REQUESTSTORE_H
+#define MO_REQUESTSTORE_H
 
 #include <memory>
 #include <deque>
 #include <ArduinoJson.h>
 
-#define MOCPP_MAX_OPNR 10000
+#define MO_MAX_OPNR 10000
 
 namespace MicroOcpp {
 
diff --git a/src/MicroOcpp/Core/SimpleRequestFactory.h b/src/MicroOcpp/Core/SimpleRequestFactory.h
index 499fde57..11c1f1c2 100644
--- a/src/MicroOcpp/Core/SimpleRequestFactory.h
+++ b/src/MicroOcpp/Core/SimpleRequestFactory.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_SIMPLEREQUESTFACTORY_H
-#define MOCPP_SIMPLEREQUESTFACTORY_H
+#ifndef MO_SIMPLEREQUESTFACTORY_H
+#define MO_SIMPLEREQUESTFACTORY_H
 
 #include <ArduinoJson.h>
 #include <MicroOcpp/Core/Request.h>
diff --git a/src/MicroOcpp/Core/Time.h b/src/MicroOcpp/Core/Time.h
index 97c62b02..83e3bd27 100644
--- a/src/MicroOcpp/Core/Time.h
+++ b/src/MicroOcpp/Core/Time.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_TIME_H
-#define MOCPP_TIME_H
+#ifndef MO_TIME_H
+#define MO_TIME_H
 
 #include <functional>
 #include <stdint.h>
diff --git a/src/MicroOcpp/Debug.h b/src/MicroOcpp/Debug.h
index b627abe0..02ae7c20 100644
--- a/src/MicroOcpp/Debug.h
+++ b/src/MicroOcpp/Debug.h
@@ -2,41 +2,41 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_DEBUG_H
-#define MOCPP_DEBUG_H
+#ifndef MO_DEBUG_H
+#define MO_DEBUG_H
 
 #include <MicroOcpp/Platform.h>
 
-#define MOCPP_DL_NONE 0x00     //suppress all output to the console
-#define MOCPP_DL_ERROR 0x01    //report failures
-#define MOCPP_DL_WARN 0x02     //report observed or assumed inconsistent state
-#define MOCPP_DL_INFO 0x03     //make internal state apparent
-#define MOCPP_DL_DEBUG 0x04    //relevant info for debugging
-#define MOCPP_DL_VERBOSE 0x05  //all output
+#define MO_DL_NONE 0x00     //suppress all output to the console
+#define MO_DL_ERROR 0x01    //report failures
+#define MO_DL_WARN 0x02     //report observed or assumed inconsistent state
+#define MO_DL_INFO 0x03     //make internal state apparent
+#define MO_DL_DEBUG 0x04    //relevant info for debugging
+#define MO_DL_VERBOSE 0x05  //all output
 
-#ifndef MOCPP_DBG_LEVEL
-#define MOCPP_DBG_LEVEL MOCPP_DL_INFO  //default
+#ifndef MO_DBG_LEVEL
+#define MO_DBG_LEVEL MO_DL_INFO  //default
 #endif
 
-#define MOCPP_DF_MINIMAL 0x00   //don't reveal origin of a debug message
-#define MOCPP_DF_COMPACT 0x01   //print module by file name and line number
-#define MOCPP_DF_FILE_LINE 0x02 //print file and line number
-#define MOCPP_DF_FULL 0x03      //print path and file and line numbr
+#define MO_DF_MINIMAL 0x00   //don't reveal origin of a debug message
+#define MO_DF_COMPACT 0x01   //print module by file name and line number
+#define MO_DF_FILE_LINE 0x02 //print file and line number
+#define MO_DF_FULL 0x03      //print path and file and line numbr
 
-#ifndef MOCPP_DBG_FORMAT
-#define MOCPP_DBG_FORMAT MOCPP_DF_FILE_LINE //default
+#ifndef MO_DBG_FORMAT
+#define MO_DBG_FORMAT MO_DF_FILE_LINE //default
 #endif
 
 
-#if MOCPP_DBG_FORMAT == MOCPP_DF_MINIMAL
-#define MOCPP_DBG(level, X)   \
+#if MO_DBG_FORMAT == MO_DF_MINIMAL
+#define MO_DBG(level, X)   \
     do {                        \
-        MOCPP_CONSOLE_PRINTF X;  \
-        MOCPP_CONSOLE_PRINTF("\n");         \
+        MO_CONSOLE_PRINTF X;  \
+        MO_CONSOLE_PRINTF("\n");         \
     } while (0);
 
-#elif MOCPP_DBG_FORMAT == MOCPP_DF_COMPACT
-#define MOCPP_DBG(level, X)   \
+#elif MO_DBG_FORMAT == MO_DF_COMPACT
+#define MO_DBG(level, X)   \
     do {                        \
         const char *_mo_file = __FILE__;         \
         size_t _mo_l = sizeof(__FILE__);         \
@@ -45,82 +45,82 @@
             _mo_l--;         \
             if (_mo_file[_mo_l] == '.') _mo_r = _mo_l;         \
         }         \
-        MOCPP_CONSOLE_PRINTF("%.*s:%i ", (int) (_mo_r - _mo_l), _mo_file + _mo_l,__LINE__);           \
-        MOCPP_CONSOLE_PRINTF X;  \
-        MOCPP_CONSOLE_PRINTF("\n");         \
+        MO_CONSOLE_PRINTF("%.*s:%i ", (int) (_mo_r - _mo_l), _mo_file + _mo_l,__LINE__);           \
+        MO_CONSOLE_PRINTF X;  \
+        MO_CONSOLE_PRINTF("\n");         \
     } while (0);
 
-#elif MOCPP_DBG_FORMAT == MOCPP_DF_FILE_LINE
-#define MOCPP_DBG(level, X)   \
+#elif MO_DBG_FORMAT == MO_DF_FILE_LINE
+#define MO_DBG(level, X)   \
     do {                        \
         const char *_mo_file = __FILE__;         \
         size_t _mo_l = sizeof(__FILE__);         \
         for (; _mo_l > 0 && _mo_file[_mo_l-1] != '/' && _mo_file[_mo_l-1] != '\\'; _mo_l--);         \
-        MOCPP_CONSOLE_PRINTF("[OCPP] %s (%s:%i): ",level, _mo_file + _mo_l,__LINE__);           \
-        MOCPP_CONSOLE_PRINTF X;  \
-        MOCPP_CONSOLE_PRINTF("\n");         \
+        MO_CONSOLE_PRINTF("[OCPP] %s (%s:%i): ",level, _mo_file + _mo_l,__LINE__);           \
+        MO_CONSOLE_PRINTF X;  \
+        MO_CONSOLE_PRINTF("\n");         \
     } while (0);
 
-#elif MOCPP_DBG_FORMAT == MOCPP_DF_FULL
-#define MOCPP_DBG(level, X)   \
+#elif MO_DBG_FORMAT == MO_DF_FULL
+#define MO_DBG(level, X)   \
     do {                        \
-        MOCPP_CONSOLE_PRINTF("[OCPP] %s (%s:%i): ",level, __FILE__,__LINE__);           \
-        MOCPP_CONSOLE_PRINTF X;  \
-        MOCPP_CONSOLE_PRINTF("\n");         \
+        MO_CONSOLE_PRINTF("[OCPP] %s (%s:%i): ",level, __FILE__,__LINE__);           \
+        MO_CONSOLE_PRINTF X;  \
+        MO_CONSOLE_PRINTF("\n");         \
     } while (0);
 
 #else
-#error invalid MOCPP_DBG_FORMAT definition
+#error invalid MO_DBG_FORMAT definition
 #endif
 
 
-#if MOCPP_DBG_LEVEL >= MOCPP_DL_ERROR
-#define MOCPP_DBG_ERR(...) MOCPP_DBG("ERROR",(__VA_ARGS__))
+#if MO_DBG_LEVEL >= MO_DL_ERROR
+#define MO_DBG_ERR(...) MO_DBG("ERROR",(__VA_ARGS__))
 #else
-#define MOCPP_DBG_ERR(...)
+#define MO_DBG_ERR(...)
 #endif
 
-#if MOCPP_DBG_LEVEL >= MOCPP_DL_WARN
-#define MOCPP_DBG_WARN(...) MOCPP_DBG("warning",(__VA_ARGS__))
+#if MO_DBG_LEVEL >= MO_DL_WARN
+#define MO_DBG_WARN(...) MO_DBG("warning",(__VA_ARGS__))
 #else
-#define MOCPP_DBG_WARN(...)
+#define MO_DBG_WARN(...)
 #endif
 
-#if MOCPP_DBG_LEVEL >= MOCPP_DL_INFO
-#define MOCPP_DBG_INFO(...) MOCPP_DBG("info",(__VA_ARGS__))
+#if MO_DBG_LEVEL >= MO_DL_INFO
+#define MO_DBG_INFO(...) MO_DBG("info",(__VA_ARGS__))
 #else
-#define MOCPP_DBG_INFO(...)
+#define MO_DBG_INFO(...)
 #endif
 
-#if MOCPP_DBG_LEVEL >= MOCPP_DL_DEBUG
-#define MOCPP_DBG_DEBUG(...) MOCPP_DBG("debug",(__VA_ARGS__))
+#if MO_DBG_LEVEL >= MO_DL_DEBUG
+#define MO_DBG_DEBUG(...) MO_DBG("debug",(__VA_ARGS__))
 #else
-#define MOCPP_DBG_DEBUG(...)
+#define MO_DBG_DEBUG(...)
 #endif
 
-#if MOCPP_DBG_LEVEL >= MOCPP_DL_VERBOSE
-#define MOCPP_DBG_VERBOSE(...) MOCPP_DBG("verbose",(__VA_ARGS__))
+#if MO_DBG_LEVEL >= MO_DL_VERBOSE
+#define MO_DBG_VERBOSE(...) MO_DBG("verbose",(__VA_ARGS__))
 #else
-#define MOCPP_DBG_VERBOSE(...)
+#define MO_DBG_VERBOSE(...)
 #endif
 
-#ifdef MOCPP_TRAFFIC_OUT
+#ifdef MO_TRAFFIC_OUT
 
-#define MOCPP_DBG_TRAFFIC_OUT(...)   \
+#define MO_DBG_TRAFFIC_OUT(...)   \
     do {                        \
-        MOCPP_CONSOLE_PRINTF("[OCPP] Send: %s",__VA_ARGS__);           \
-        MOCPP_CONSOLE_PRINTF("\n");         \
+        MO_CONSOLE_PRINTF("[OCPP] Send: %s",__VA_ARGS__);           \
+        MO_CONSOLE_PRINTF("\n");         \
     } while (0)
 
-#define MOCPP_DBG_TRAFFIC_IN(...)   \
+#define MO_DBG_TRAFFIC_IN(...)   \
     do {                        \
-        MOCPP_CONSOLE_PRINTF("[OCPP] Recv: %.*s",__VA_ARGS__);           \
-        MOCPP_CONSOLE_PRINTF("\n");         \
+        MO_CONSOLE_PRINTF("[OCPP] Recv: %.*s",__VA_ARGS__);           \
+        MO_CONSOLE_PRINTF("\n");         \
     } while (0)
 
 #else
-#define MOCPP_DBG_TRAFFIC_OUT(...)
-#define MOCPP_DBG_TRAFFIC_IN(...)
+#define MO_DBG_TRAFFIC_OUT(...)
+#define MO_DBG_TRAFFIC_IN(...)
 #endif
 
 #endif
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
index 61a3468a..9dfaff85 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
@@ -98,8 +98,8 @@ bool AuthorizationList::readJson(JsonArray authlistJson, int listVersion, bool d
         }
     }
 
-    if (resultingListLength > MOCPP_LocalAuthListMaxLength) {
-        MOCPP_DBG_WARN("localAuthList capacity exceeded");
+    if (resultingListLength > MO_LocalAuthListMaxLength) {
+        MO_DBG_WARN("localAuthList capacity exceeded");
         return false;
     }
 
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.h b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
index 07e2ebb4..f2c57ac2 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
@@ -8,12 +8,12 @@
 #include <MicroOcpp/Model/Authorization/AuthorizationData.h>
 #include <vector>
 
-#ifndef MOCPP_LocalAuthListMaxLength
-#define MOCPP_LocalAuthListMaxLength 48
+#ifndef MO_LocalAuthListMaxLength
+#define MO_LocalAuthListMaxLength 48
 #endif
 
-#ifndef MOCPP_SendLocalListMaxLength
-#define MOCPP_SendLocalListMaxLength MOCPP_LocalAuthListMaxLength
+#ifndef MO_SendLocalListMaxLength
+#define MO_SendLocalListMaxLength MO_LocalAuthListMaxLength
 #endif
 
 namespace MicroOcpp {
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 465723de..36011afd 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -14,18 +14,18 @@
 #include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Debug.h>
 
-#define MOCPP_LOCALAUTHORIZATIONLIST_FN (MOCPP_FILENAME_PREFIX "localauth.jsn")
+#define MO_LOCALAUTHORIZATIONLIST_FN (MO_FILENAME_PREFIX "localauth.jsn")
 
 using namespace MicroOcpp;
 
 AuthorizationService::AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
     localAuthListEnabledBool = declareConfiguration<bool>("LocalAuthListEnabled", true);
-    declareConfiguration<int>("LocalAuthListMaxLength", MOCPP_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, true);
-    declareConfiguration<int>("SendLocalListMaxLength", MOCPP_SendLocalListMaxLength, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<int>("LocalAuthListMaxLength", MO_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<int>("SendLocalListMaxLength", MO_SendLocalListMaxLength, CONFIGURATION_VOLATILE, true);
 
     if (!localAuthListEnabledBool) {
-        MOCPP_DBG_ERR("initialization error");
+        MO_DBG_ERR("initialization error");
     }
     
     context.getOperationRegistry().registerOperation("GetLocalListVersion", [&context] () {
@@ -42,19 +42,19 @@ AuthorizationService::~AuthorizationService() {
 
 bool AuthorizationService::loadLists() {
     if (!filesystem) {
-        MOCPP_DBG_WARN("no fs access");
+        MO_DBG_WARN("no fs access");
         return true;
     }
 
     size_t msize = 0;
-    if (filesystem->stat(MOCPP_LOCALAUTHORIZATIONLIST_FN, &msize) != 0) {
-        MOCPP_DBG_DEBUG("no local authorization list stored already");
+    if (filesystem->stat(MO_LOCALAUTHORIZATIONLIST_FN, &msize) != 0) {
+        MO_DBG_DEBUG("no local authorization list stored already");
         return true;
     }
     
-    auto doc = FilesystemUtils::loadJson(filesystem, MOCPP_LOCALAUTHORIZATIONLIST_FN);
+    auto doc = FilesystemUtils::loadJson(filesystem, MO_LOCALAUTHORIZATIONLIST_FN);
     if (!doc) {
-        MOCPP_DBG_ERR("failed to load %s", MOCPP_LOCALAUTHORIZATIONLIST_FN);
+        MO_DBG_ERR("failed to load %s", MO_LOCALAUTHORIZATIONLIST_FN);
         return false;
     }
 
@@ -63,7 +63,7 @@ bool AuthorizationService::loadLists() {
     int listVersion = root["listVersion"] | 0;
     
     if (!localAuthorizationList.readJson(root["localAuthorizationList"].as<JsonArray>(), listVersion, false, true)) {
-        MOCPP_DBG_ERR("list read failure");
+        MO_DBG_ERR("list read failure");
         return false;
     }
 
@@ -82,7 +82,7 @@ AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag
 
     //check status
     if (authData->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
-        MOCPP_DBG_DEBUG("idTag %s local auth status %s", idTag, serializeAuthorizationStatus(authData->getAuthorizationStatus()));
+        MO_DBG_DEBUG("idTag %s local auth status %s", idTag, serializeAuthorizationStatus(authData->getAuthorizationStatus()));
         return authData;
     }
 
@@ -110,7 +110,7 @@ bool AuthorizationService::updateLocalList(JsonArray localAuthorizationListJson,
         root["listVersion"] = listVersion;
         JsonArray authListCompact = root.createNestedArray("localAuthorizationList");
         localAuthorizationList.writeJson(authListCompact, true);
-        success = FilesystemUtils::storeJson(filesystem, MOCPP_LOCALAUTHORIZATIONLIST_FN, doc);
+        success = FilesystemUtils::storeJson(filesystem, MO_LOCALAUTHORIZATIONLIST_FN, doc);
 
         if (!success) {
             loadLists();
@@ -152,7 +152,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     if (localStatus == AuthorizationStatus::Accepted && localInfo->getExpiryDate()) { //check for expiry
         auto& t_now = context.getModel().getClock().now();
         if (t_now > *localInfo->getExpiryDate()) {
-            MOCPP_DBG_DEBUG("local auth expired");
+            MO_DBG_DEBUG("local auth expired");
             localStatus = AuthorizationStatus::Expired;
         }
     }
@@ -160,18 +160,18 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     bool equivalent = true;
 
     if (incomingStatus != localStatus) {
-        MOCPP_DBG_WARN("local auth list status conflict");
+        MO_DBG_WARN("local auth list status conflict");
         equivalent = false;
     }
 
     //check if parentIdTag definitions mismatch
     if (equivalent &&
             strcmp(localInfo->getParentIdTag() ? localInfo->getParentIdTag() : "", idTagInfo["parentIdTag"] | "")) {
-        MOCPP_DBG_WARN("local auth list parentIdTag conflict");
+        MO_DBG_WARN("local auth list parentIdTag conflict");
         equivalent = false;
     }
 
-    MOCPP_DBG_DEBUG("idTag %s fully evaluated: %s conflict", idTag, equivalent ? "no" : "contains");
+    MO_DBG_DEBUG("idTag %s fully evaluated: %s conflict", idTag, equivalent ? "no" : "contains");
 
     if (!equivalent) {
         //send error code "LocalListConflict" to server
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index 98a960c5..20c07c0e 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -14,8 +14,8 @@
 #include <MicroOcpp/Platform.h>
 #include <MicroOcpp/Debug.h>
 
-#ifndef MOCPP_BOOTSTATS_LONGTIME_MS
-#define MOCPP_BOOTSTATS_LONGTIME_MS 180 * 1000
+#ifndef MO_BOOTSTATS_LONGTIME_MS
+#define MO_BOOTSTATS_LONGTIME_MS 180 * 1000
 #endif
 
 using namespace MicroOcpp;
@@ -28,7 +28,7 @@ RegistrationStatus MicroOcpp::deserializeRegistrationStatus(const char *serializ
     } else if (!strcmp(serialized, "Rejected")) {
         return RegistrationStatus::Rejected;
     } else {
-        MOCPP_DBG_ERR("deserialization error");
+        MO_DBG_ERR("deserialization error");
         return RegistrationStatus::UNDEFINED;
     }
 }
@@ -36,10 +36,10 @@ RegistrationStatus MicroOcpp::deserializeRegistrationStatus(const char *serializ
 BootService::BootService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     
     //if transactions can start before the BootNotification succeeds
-    preBootTransactionsBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", false);
+    preBootTransactionsBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", false);
     
     if (!preBootTransactionsBool) {
-        MOCPP_DBG_ERR("initialization error");
+        MO_DBG_ERR("initialization error");
         (void)0;
     }
 
@@ -55,9 +55,9 @@ void BootService::loop() {
         firstExecutionTimestamp = mocpp_tick_ms();
     }
 
-    if (!executedLongTime && mocpp_tick_ms() - firstExecutionTimestamp >= MOCPP_BOOTSTATS_LONGTIME_MS) {
+    if (!executedLongTime && mocpp_tick_ms() - firstExecutionTimestamp >= MO_BOOTSTATS_LONGTIME_MS) {
         executedLongTime = true;
-        MOCPP_DBG_DEBUG("boot success timer reached");
+        MO_DBG_DEBUG("boot success timer reached");
         BootStats bootstats;
         loadBootStats(filesystem, bootstats);
         bootstats.lastBootSuccess = bootstats.bootNr;
@@ -96,7 +96,7 @@ void BootService::loop() {
 void BootService::setChargePointCredentials(JsonObject credentials) {
     auto written = serializeJson(credentials, cpCredentials);
     if (written < 2) {
-        MOCPP_DBG_ERR("serialization error");
+        MO_DBG_ERR("serialization error");
         cpCredentials = "{}";
     }
 }
@@ -116,7 +116,7 @@ std::unique_ptr<DynamicJsonDocument> BootService::getChargePointCredentials() {
     std::unique_ptr<DynamicJsonDocument> doc;
     size_t capacity = JSON_OBJECT_SIZE(9) + cpCredentials.size();
     DeserializationError err = DeserializationError::NoMemory;
-    while (err == DeserializationError::NoMemory && capacity <= MOCPP_MAX_JSON_CAPACITY) {
+    while (err == DeserializationError::NoMemory && capacity <= MO_MAX_JSON_CAPACITY) {
         doc.reset(new DynamicJsonDocument(capacity));
         err = deserializeJson(*doc, cpCredentials);
 
@@ -126,7 +126,7 @@ std::unique_ptr<DynamicJsonDocument> BootService::getChargePointCredentials() {
     if (!err) {
         return doc;
     } else {
-        MOCPP_DBG_ERR("could not parse stored credentials: %s", err.c_str());
+        MO_DBG_ERR("could not parse stored credentials: %s", err.c_str());
         return nullptr;
     }
 }
@@ -138,7 +138,7 @@ void BootService::notifyRegistrationStatus(RegistrationStatus status) {
 
 void BootService::setRetryInterval(unsigned long interval_s) {
     if (interval_s == 0) {
-        this->interval_s = MOCPP_BOOT_INTERVAL_DEFAULT;
+        this->interval_s = MO_BOOT_INTERVAL_DEFAULT;
     } else {
         this->interval_s = interval_s;
     }
@@ -151,11 +151,11 @@ bool BootService::loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, B
     }
 
     size_t msize = 0;
-    if (filesystem->stat(MOCPP_FILENAME_PREFIX "bootstats.jsn", &msize) == 0) {
+    if (filesystem->stat(MO_FILENAME_PREFIX "bootstats.jsn", &msize) == 0) {
         
         bool success = true;
 
-        auto json = FilesystemUtils::loadJson(filesystem, MOCPP_FILENAME_PREFIX "bootstats.jsn");
+        auto json = FilesystemUtils::loadJson(filesystem, MO_FILENAME_PREFIX "bootstats.jsn");
         if (json) {
             int bootNrIn = (*json)["bootNr"] | -1;
             if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
@@ -175,8 +175,8 @@ bool BootService::loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, B
         }
 
         if (!success) {
-            MOCPP_DBG_ERR("bootstats corrupted");
-            filesystem->remove(MOCPP_FILENAME_PREFIX "bootstats.jsn");
+            MO_DBG_ERR("bootstats corrupted");
+            filesystem->remove(MO_FILENAME_PREFIX "bootstats.jsn");
             bstats = BootStats();
         }
 
@@ -196,5 +196,5 @@ bool BootService::storeBootStats(std::shared_ptr<FilesystemAdapter> filesystem,
     json["bootNr"] = bstats.bootNr;
     json["lastSuccess"] = bstats.lastBootSuccess;
 
-    return FilesystemUtils::storeJson(filesystem, MOCPP_FILENAME_PREFIX "bootstats.jsn", json);
+    return FilesystemUtils::storeJson(filesystem, MO_FILENAME_PREFIX "bootstats.jsn", json);
 }
diff --git a/src/MicroOcpp/Model/Boot/BootService.h b/src/MicroOcpp/Model/Boot/BootService.h
index 2c542e3d..67776eed 100644
--- a/src/MicroOcpp/Model/Boot/BootService.h
+++ b/src/MicroOcpp/Model/Boot/BootService.h
@@ -9,7 +9,7 @@
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <memory>
 
-#define MOCPP_BOOT_INTERVAL_DEFAULT 60
+#define MO_BOOT_INTERVAL_DEFAULT 60
 
 namespace MicroOcpp {
 
@@ -38,7 +38,7 @@ class BootService {
     Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
 
-    unsigned long interval_s = MOCPP_BOOT_INTERVAL_DEFAULT;
+    unsigned long interval_s = MO_BOOT_INTERVAL_DEFAULT;
     unsigned long lastBootNotification = -1UL / 2;
 
     RegistrationStatus status = RegistrationStatus::Pending;
diff --git a/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h b/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
index 95a82e5e..d78981b1 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_CHARGEPOINTERRORCODE_H
-#define MOCPP_CHARGEPOINTERRORCODE_H
+#ifndef MO_CHARGEPOINTERRORCODE_H
+#define MO_CHARGEPOINTERRORCODE_H
 
 namespace MicroOcpp {
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 5749d850..3540a70f 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -24,8 +24,8 @@
 
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 
-#ifndef MOCPP_TX_CLEAN_ABORTED
-#define MOCPP_TX_CLEAN_ABORTED 1
+#ifndef MO_TX_CLEAN_ABORTED
+#define MO_TX_CLEAN_ABORTED 1
 #endif
 
 using namespace MicroOcpp;
@@ -34,8 +34,8 @@ using namespace MicroOcpp::Ocpp16;
 Connector::Connector(Context& context, int connectorId)
         : context(context), model(context.getModel()), connectorId{connectorId} {
 
-    snprintf(availabilityBoolKey, sizeof(availabilityBoolKey), MOCPP_CONFIG_EXT_PREFIX "AVAIL_CONN_%d", connectorId);
-    availabilityBool = declareConfiguration<bool>(availabilityBoolKey, true, MOCPP_KEYVALUE_FN, false, false, false);
+    snprintf(availabilityBoolKey, sizeof(availabilityBoolKey), MO_CONFIG_EXT_PREFIX "AVAIL_CONN_%d", connectorId);
+    availabilityBool = declareConfiguration<bool>(availabilityBoolKey, true, MO_KEYVALUE_FN, false, false, false);
     
     connectionTimeOutInt = declareConfiguration<int>("ConnectionTimeOut", 30);
     minimumStatusDurationInt = declareConfiguration<int>("MinimumStatusDuration", 0);
@@ -47,23 +47,23 @@ Connector::Connector(Context& context, int connectorId)
     allowOfflineTxForUnknownIdBool = MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", false);
 
     //if the EVSE goes offline, can it continue to charge without sending StartTx / StopTx to the server when going online again?
-    silentOfflineTransactionsBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "SilentOfflineTransactions", false);
+    silentOfflineTransactionsBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "SilentOfflineTransactions", false);
 
     //how long the EVSE tries the Authorize request before it enters offline mode
-    authorizationTimeoutInt = MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
+    authorizationTimeoutInt = MicroOcpp::declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
 
     //FreeVend mode
-    freeVendActiveBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "FreeVendActive", false);
-    freeVendIdTagString = declareConfiguration<const char*>(MOCPP_CONFIG_EXT_PREFIX "FreeVendIdTag", "");
+    freeVendActiveBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "FreeVendActive", false);
+    freeVendIdTagString = declareConfiguration<const char*>(MO_CONFIG_EXT_PREFIX "FreeVendIdTag", "");
 
     if (!availabilityBool) {
-        MOCPP_DBG_ERR("Cannot declare availabilityBool");
+        MO_DBG_ERR("Cannot declare availabilityBool");
     }
 
     if (model.getTransactionStore()) {
         transaction = model.getTransactionStore()->getLatestTransaction(connectorId);
     } else {
-        MOCPP_DBG_ERR("must initialize TxStore before Connector");
+        MO_DBG_ERR("must initialize TxStore before Connector");
         (void)0;
     }
 }
@@ -126,13 +126,13 @@ ChargePointStatus Connector::getStatus() {
         }
     }
 
-    MOCPP_DBG_DEBUG("status undefined");
+    MO_DBG_DEBUG("status undefined");
     return ChargePointStatus::Faulted; //internal error
 }
 
 bool Connector::ocppPermitsCharge() {
     if (connectorId == 0) {
-        MOCPP_DBG_WARN("not supported for connectorId == 0");
+        MO_DBG_WARN("not supported for connectorId == 0");
         return false;
     }
 
@@ -156,7 +156,7 @@ void Connector::loop() {
         trackLoopExecute = true;
     }
 
-    if (transaction && transaction->isAborted() && MOCPP_TX_CLEAN_ABORTED) {
+    if (transaction && transaction->isAborted() && MO_TX_CLEAN_ABORTED) {
         //If the transaction is aborted (invalidated before started), delete all artifacts from flash
         //This is an optimization. The memory management will attempt to remove those files again later
         bool removed = true;
@@ -172,17 +172,17 @@ void Connector::loop() {
             model.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr()); //roll back creation of last tx entry
         }
 
-        MOCPP_DBG_DEBUG("collect aborted transaction %u-%u %s", connectorId, transaction->getTxNr(), removed ? "" : "failure");
+        MO_DBG_DEBUG("collect aborted transaction %u-%u %s", connectorId, transaction->getTxNr(), removed ? "" : "failure");
         transaction = nullptr;
     }
 
     if (transaction && transaction->isAborted()) {
-        MOCPP_DBG_DEBUG("collect aborted transaction %u-%u", connectorId, transaction->getTxNr());
+        MO_DBG_DEBUG("collect aborted transaction %u-%u", connectorId, transaction->getTxNr());
         transaction = nullptr;
     }
 
     if (transaction && transaction->isCompleted()) {
-        MOCPP_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
+        MO_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
         transaction = nullptr;
     }
 
@@ -191,7 +191,7 @@ void Connector::loop() {
         if (connectorPluggedInput) {
             if (transaction->isRunning() && transaction->isActive() && !connectorPluggedInput()) {
                 if (!stopTransactionOnEVSideDisconnectBool || stopTransactionOnEVSideDisconnectBool->getBool()) {
-                    MOCPP_DBG_DEBUG("Stop Tx due to EV disconnect");
+                    MO_DBG_DEBUG("Stop Tx due to EV disconnect");
                     transaction->setStopReason("EVDisconnected");
                     transaction->setInactive();
                     transaction->commit();
@@ -205,7 +205,7 @@ void Connector::loop() {
                     !connectorPluggedInput() &&
                     model.getClock().now() - transaction->getBeginTimestamp() >= connectionTimeOutInt->getInt()) {
 
-                MOCPP_DBG_INFO("Session mngt: timeout");
+                MO_DBG_INFO("Session mngt: timeout");
                 transaction->setInactive();
                 transaction->commit();
 
@@ -218,7 +218,7 @@ void Connector::loop() {
                     !transaction->isRunning() ||        //if transaction hasn't started yet, always end
                     !stopTransactionOnInvalidIdBool || stopTransactionOnInvalidIdBool->getBool())) { //if transaction is running, behavior depends on StopTransactionOnInvalidId
             
-            MOCPP_DBG_DEBUG("DeAuthorize session");
+            MO_DBG_DEBUG("DeAuthorize session");
             transaction->setStopReason("DeAuthorized");
             transaction->setInactive();
             transaction->commit();
@@ -237,7 +237,7 @@ void Connector::loop() {
                     (!startTxReadyInput || startTxReadyInput())) { //if defined, user Input for allowing StartTx must be true
                 //start Transaction
 
-                MOCPP_DBG_INFO("Session mngt: trigger StartTransaction");
+                MO_DBG_INFO("Session mngt: trigger StartTransaction");
 
                 auto meteringService = model.getMeteringService();
                 if (transaction->getMeterStart() < 0 && meteringService) {
@@ -245,7 +245,7 @@ void Connector::loop() {
                     if (meterStart && *meterStart) {
                         transaction->setMeterStart(meterStart->toInteger());
                     } else {
-                        MOCPP_DBG_ERR("MeterStart undefined");
+                        MO_DBG_ERR("MeterStart undefined");
                     }
                 }
 
@@ -257,7 +257,7 @@ void Connector::loop() {
                 updateTxNotification(TxNotification::StartTx);
 
                 if (transaction->isSilent()) {
-                    MOCPP_DBG_INFO("silent Transaction: omit StartTx");
+                    MO_DBG_INFO("silent Transaction: omit StartTx");
                     transaction->getStartSync().setRequested();
                     transaction->getStartSync().confirm();
                     transaction->commit();
@@ -290,10 +290,10 @@ void Connector::loop() {
                     (!stopTxReadyInput || stopTxReadyInput())) {
                 //stop transaction
 
-                MOCPP_DBG_INFO("Session mngt: trigger StopTransaction");
+                MO_DBG_INFO("Session mngt: trigger StopTransaction");
 
                 if (transaction->isSilent()) {
-                    MOCPP_DBG_INFO("silent Transaction: omit StopTx");
+                    MO_DBG_INFO("silent Transaction: omit StopTx");
                     updateTxNotification(TxNotification::StopTx);
                     transaction->getStopSync().setRequested();
                     transaction->getStopSync().confirm();
@@ -312,7 +312,7 @@ void Connector::loop() {
                     if (meterStop && *meterStop) {
                         transaction->setMeterStop(meterStop->toInteger());
                     } else {
-                        MOCPP_DBG_ERR("MeterStop undefined");
+                        MO_DBG_ERR("MeterStop undefined");
                     }
                 }
 
@@ -352,11 +352,11 @@ void Connector::loop() {
             if (!idTag || *idTag == '\0') {
                 idTag = "A0000000";
             }
-            MOCPP_DBG_INFO("begin FreeVend Tx using idTag %s", idTag);
+            MO_DBG_INFO("begin FreeVend Tx using idTag %s", idTag);
             beginTransaction_authorized(idTag);
             
             if (!transaction) {
-                MOCPP_DBG_ERR("could not begin FreeVend Tx");
+                MO_DBG_ERR("could not begin FreeVend Tx");
                 (void)0;
             }
         }
@@ -388,7 +388,7 @@ void Connector::loop() {
     if (status != currentStatus) {
         currentStatus = status;
         t_statusTransition = mocpp_tick_ms();
-        MOCPP_DBG_DEBUG("Status changed%s", minimumStatusDurationInt->getInt() ? ", will report delayed" : "");
+        MO_DBG_DEBUG("Status changed%s", minimumStatusDurationInt->getInt() ? ", will report delayed" : "");
     }
 
     if (reportedStatus != currentStatus &&
@@ -441,7 +441,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
         
         auto tx = model.getTransactionStore()->getTransaction(connectorId, txr);
         //check if dangling silent tx, aborted tx, or corrupted entry (tx == null)
-        if (!tx || tx->isSilent() || (tx->isAborted() && MOCPP_TX_CLEAN_ABORTED)) {
+        if (!tx || tx->isSilent() || (tx->isAborted() && MO_TX_CLEAN_ABORTED)) {
             //yes, remove
             bool removed = true;
             if (auto mService = model.getMeteringService()) {
@@ -452,9 +452,9 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
             }
             if (removed) {
                 model.getTransactionStore()->setTxEnd(connectorId, txr);
-                MOCPP_DBG_WARN("deleted dangling silent or aborted tx for new transaction");
+                MO_DBG_WARN("deleted dangling silent or aborted tx for new transaction");
             } else {
-                MOCPP_DBG_ERR("memory corruption");
+                MO_DBG_ERR("memory corruption");
                 break;
             }
         } else {
@@ -494,16 +494,16 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
                 }
                 if (removed) {
                     model.getTransactionStore()->setTxBegin(connectorId, (txl + 1) % MAX_TX_CNT);
-                    MOCPP_DBG_DEBUG("deleted tx history entry for new transaction");
+                    MO_DBG_DEBUG("deleted tx history entry for new transaction");
 
                     tx = model.getTransactionStore()->createTransaction(connectorId);
                 } else {
-                    MOCPP_DBG_ERR("memory corruption");
+                    MO_DBG_ERR("memory corruption");
                     break;
                 }
             } else {
                 //no, end of history reached, don't delete further tx
-                MOCPP_DBG_DEBUG("cannot delete more tx");
+                MO_DBG_DEBUG("cannot delete more tx");
                 break;
             }
 
@@ -519,7 +519,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
             tx = model.getTransactionStore()->createTransaction(connectorId, true);
 
             if (tx) {
-                MOCPP_DBG_DEBUG("created silent transaction");
+                MO_DBG_DEBUG("created silent transaction");
                 (void)0;
             }
         }
@@ -531,11 +531,11 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
 std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     if (transaction) {
-        MOCPP_DBG_WARN("tx process still running. Please call endTransaction(...) before");
+        MO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
         return nullptr;
     }
 
-    MOCPP_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
+    MO_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
     
     AuthorizationData *localAuth = nullptr;
     bool offlineBlockedAuth = false; //if offline authorization will be blocked by local auth list entry
@@ -546,14 +546,14 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         //check authorization status
         if (localAuth && localAuth->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
-            MOCPP_DBG_DEBUG("local auth denied (%s)", idTag);
+            MO_DBG_DEBUG("local auth denied (%s)", idTag);
             offlineBlockedAuth = true;
             localAuth = nullptr;
         }
 
         //check expiry
         if (localAuth && localAuth->getExpiryDate() && *localAuth->getExpiryDate() < model.getClock().now()) {
-            MOCPP_DBG_DEBUG("idTag %s local auth entry expired", idTag);
+            MO_DBG_DEBUG("idTag %s local auth entry expired", idTag);
             offlineBlockedAuth = true;
             localAuth = nullptr;
         }
@@ -580,12 +580,12 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             //if parentIdTag is known, abort this tx immediately, otherwise wait for Authorize.conf to decide
             if (parentIdTag) {
                 //parentIdTag known
-                MOCPP_DBG_INFO("connector %u reserved - abort transaction", connectorId);
+                MO_DBG_INFO("connector %u reserved - abort transaction", connectorId);
                 updateTxNotification(TxNotification::ReservationConflict);
                 return nullptr;
             } else {
                 //parentIdTag unkown but local authorization failed in any case
-                MOCPP_DBG_INFO("connector %u reserved - no local auth", connectorId);
+                MO_DBG_INFO("connector %u reserved - no local auth", connectorId);
                 localAuth = nullptr;
             }
         }
@@ -594,7 +594,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     transaction = allocateTransaction();
 
     if (!transaction) {
-        MOCPP_DBG_ERR("could not allocate Tx");
+        MO_DBG_ERR("could not allocate Tx");
         return nullptr;
     }
 
@@ -609,7 +609,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     //check for local preauthorization
     if (localAuth && localPreAuthorizeBool && localPreAuthorizeBool->getBool()) {
-        MOCPP_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
+        MO_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
 
         if (reservation) {
             transaction->setReservationId(reservation->getReservationId());
@@ -629,7 +629,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         if (strcmp("Accepted", idTagInfo["status"] | "UNDEFINED")) {
             //Authorization rejected, abort transaction
-            MOCPP_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->getIdTag());
+            MO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->getIdTag());
             tx->setIdTagDeauthorized();
             tx->commit();
             updateTxNotification(TxNotification::AuthorizationRejected);
@@ -646,11 +646,11 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                 if (reservation->matches(
                             tx->getIdTag(),
                             idTagInfo["parentIdTag"] | (const char*) nullptr)) {
-                    MOCPP_DBG_INFO("connector %u matches reservationId %i", connectorId, reservation->getReservationId());
+                    MO_DBG_INFO("connector %u matches reservationId %i", connectorId, reservation->getReservationId());
                     tx->setReservationId(reservation->getReservationId());
                 } else {
                     //reservation found for connector but does not match idTag or parentIdTag
-                    MOCPP_DBG_INFO("connector %u reserved - abort transaction", connectorId);
+                    MO_DBG_INFO("connector %u reserved - abort transaction", connectorId);
                     tx->setInactive();
                     tx->commit();
                     updateTxNotification(TxNotification::ReservationConflict);
@@ -659,7 +659,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             }
         }
 
-        MOCPP_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
+        MO_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
         tx->setAuthorized();
         tx->commit();
 
@@ -679,7 +679,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         if (offlineBlockedAuth) {
             //local auth entry exists, but is expired -> avoid offline tx
-            MOCPP_DBG_DEBUG("Abort transaction process (%s), timeout, expired local auth", tx->getIdTag());
+            MO_DBG_DEBUG("Abort transaction process (%s), timeout, expired local auth", tx->getIdTag());
             tx->setInactive();
             tx->commit();
             updateTxNotification(TxNotification::AuthorizationTimeout);
@@ -688,7 +688,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         if (offlineBlockedResv) {
             //reservation found for connector but does not match idTag or parentIdTag
-            MOCPP_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
+            MO_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
             tx->setInactive();
             tx->commit();
             updateTxNotification(TxNotification::ReservationConflict);
@@ -696,7 +696,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         }
 
         if (localAuthFound && localAuthorizeOfflineBool && localAuthorizeOfflineBool->getBool()) {
-            MOCPP_DBG_DEBUG("Offline transaction process (%s), locally authorized", tx->getIdTag());
+            MO_DBG_DEBUG("Offline transaction process (%s), locally authorized", tx->getIdTag());
             if (reservationFound) {
                 tx->setReservationId(reservationId);
             }
@@ -708,7 +708,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         }
 
         if (allowOfflineTxForUnknownIdBool && allowOfflineTxForUnknownIdBool->getBool()) {
-            MOCPP_DBG_DEBUG("Offline transaction process (%s), allow unknown ID", tx->getIdTag());
+            MO_DBG_DEBUG("Offline transaction process (%s), allow unknown ID", tx->getIdTag());
             if (reservationFound) {
                 tx->setReservationId(reservationId);
             }
@@ -718,7 +718,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             return;
         }
 
-        MOCPP_DBG_DEBUG("Abort transaction process (%s): timeout", tx->getIdTag());
+        MO_DBG_DEBUG("Abort transaction process (%s): timeout", tx->getIdTag());
         tx->setInactive();
         tx->commit();
         updateTxNotification(TxNotification::AuthorizationTimeout);
@@ -732,14 +732,14 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
     
     if (transaction) {
-        MOCPP_DBG_WARN("tx process still running. Please call endTransaction(...) before");
+        MO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
         return nullptr;
     }
 
     transaction = allocateTransaction();
 
     if (!transaction) {
-        MOCPP_DBG_ERR("could not allocate Tx");
+        MO_DBG_ERR("could not allocate Tx");
         return nullptr;
     }
 
@@ -752,7 +752,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
 
     transaction->setBeginTimestamp(model.getClock().now());
     
-    MOCPP_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
+    MO_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
 
     transaction->setAuthorized();
     
@@ -779,11 +779,11 @@ void Connector::endTransaction(const char *idTag, const char *reason) {
     if (idTag && *idTag != '\0' && !strcmp(idTag, transaction->getIdTag())) {
         //given stop idTag differs from start idTag. Make Authorization check first
 
-        MOCPP_DBG_WARN("authorization status of stop idTag not checked automatically yet");
+        MO_DBG_WARN("authorization status of stop idTag not checked automatically yet");
         (void)0;
     }
 
-    MOCPP_DBG_DEBUG("End session started by idTag %s",
+    MO_DBG_DEBUG("End session started by idTag %s",
                             transaction->getIdTag());
     
     if (idTag && *idTag != '\0') {
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index b1ce7182..3b5e6196 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -33,7 +33,7 @@ class Connector {
     std::shared_ptr<Transaction> transaction;
 
     std::shared_ptr<Configuration> availabilityBool;
-    char availabilityBoolKey [sizeof(MOCPP_CONFIG_EXT_PREFIX "AVAIL_CONN_xxxx") + 1];
+    char availabilityBoolKey [sizeof(MO_CONFIG_EXT_PREFIX "AVAIL_CONN_xxxx") + 1];
     bool availabilityVolatile = true;
 
     std::function<bool()> connectorPluggedInput;
diff --git a/src/MicroOcpp/Model/ConnectorBase/Notification.h b/src/MicroOcpp/Model/ConnectorBase/Notification.h
index bee6cea0..eb437365 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Notification.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Notification.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_NOTIFICATION_H
-#define MOCPP_NOTIFICATION_H
+#ifndef MO_NOTIFICATION_H
+#define MO_NOTIFICATION_H
 
 #ifdef __cplusplus
 
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 7a83ffa8..dfe44caa 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -35,11 +35,11 @@ void DiagnosticsService::loop() {
 
         if (!uploadIssued) {
             if (onUpload != nullptr) {
-                MOCPP_DBG_DEBUG("Call onUpload");
+                MO_DBG_DEBUG("Call onUpload");
                 onUpload(location.c_str(), startTime, stopTime);
                 uploadIssued = true;
             } else {
-                MOCPP_DBG_ERR("onUpload must be set! (see setOnUpload). Will abort");
+                MO_DBG_ERR("onUpload must be set! (see setOnUpload). Will abort");
                 retries = 0;
                 uploadIssued = false;
             }
@@ -48,7 +48,7 @@ void DiagnosticsService::loop() {
         if (uploadIssued) {
             if (uploadStatusInput != nullptr && uploadStatusInput() == UploadStatus::Uploaded) {
                 //success!
-                MOCPP_DBG_DEBUG("end upload routine (by status)")
+                MO_DBG_DEBUG("end upload routine (by status)")
                 uploadIssued = false;
                 retries = 0;
             }
@@ -61,12 +61,12 @@ void DiagnosticsService::loop() {
 
                 if (uploadStatusInput == nullptr) {
                     //No way to find out if failed. But maximum time has elapsed. Assume success
-                    MOCPP_DBG_DEBUG("end upload routine (by timer)");
+                    MO_DBG_DEBUG("end upload routine (by timer)");
                     uploadIssued = false;
                     retries = 0;
                 } else {
                     //either we have UploadFailed status or (NotDownloaded + timeout) here
-                    MOCPP_DBG_WARN("Upload timeout or failed");
+                    MO_DBG_WARN("Upload timeout or failed");
                     const int TRANSITION_DELAY = 10;
                     if (retryInterval <= UPLOAD_TIMEOUT + TRANSITION_DELAY) {
                         nextTry = timestampNow;
@@ -100,13 +100,13 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const char *location, u
         this->stopTime = newStop;
     }
     
-#if MOCPP_DBG_LEVEL >= MOCPP_DL_INFO
+#if MO_DBG_LEVEL >= MO_DL_INFO
     char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
     char dbuf2 [JSONDATE_LENGTH + 1] = {'\0'};
     this->startTime.toJsonString(dbuf, JSONDATE_LENGTH + 1);
     this->stopTime.toJsonString(dbuf2, JSONDATE_LENGTH + 1);
 
-    MOCPP_DBG_INFO("Scheduled Diagnostics upload!\n" \
+    MO_DBG_INFO("Scheduled Diagnostics upload!\n" \
                     "                  location = %s\n" \
                     "                  retries = %i" \
                     ", retryInterval = %u" \
@@ -124,7 +124,7 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const char *location, u
     uploadIssued = false;
 
     nextTry.toJsonString(dbuf, JSONDATE_LENGTH + 1);
-    MOCPP_DBG_DEBUG("Initial try at %s", dbuf);
+    MO_DBG_DEBUG("Initial try at %s", dbuf);
 
     std::string fileName;
     if (refreshFilename) {
@@ -178,7 +178,7 @@ void DiagnosticsService::setOnUploadStatusInput(std::function<UploadStatus()> up
     this->uploadStatusInput = uploadStatusInput;
 }
 
-#if !defined(MOCPP_CUSTOM_DIAGNOSTICS) && !defined(MOCPP_CUSTOM_WS)
+#if !defined(MO_CUSTOM_DIAGNOSTICS) && !defined(MO_CUSTOM_WS)
 #if defined(ESP32) || defined(ESP8266)
 
 DiagnosticsService *EspWiFi::makeDiagnosticsService(Context& context) {
@@ -192,4 +192,4 @@ DiagnosticsService *EspWiFi::makeDiagnosticsService(Context& context) {
 }
 
 #endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
+#endif //!defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
index 99368d93..cd7d2654 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -62,7 +62,7 @@ class DiagnosticsService {
     void setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput);
 };
 
-#if !defined(MOCPP_CUSTOM_DIAGNOSTICS) && !defined(MOCPP_CUSTOM_WS)
+#if !defined(MO_CUSTOM_DIAGNOSTICS) && !defined(MO_CUSTOM_WS)
 #if defined(ESP32) || defined(ESP8266)
 
 namespace EspWiFi {
@@ -72,7 +72,7 @@ DiagnosticsService *makeDiagnosticsService(Context& context);
 }
 
 #endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
+#endif //!defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
 
 } //end namespace MicroOcpp
 
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 2c2519cc..1c125370 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -18,8 +18,8 @@
 #include <MicroOcpp/Debug.h>
 
 //debug option: update immediately and don't wait for the retreive date
-#ifndef MOCPP_IGNORE_FW_RETR_DATE
-#define MOCPP_IGNORE_FW_RETR_DATE 0
+#ifndef MO_IGNORE_FW_RETR_DATE
+#define MO_IGNORE_FW_RETR_DATE 0
 #endif
 
 using namespace MicroOcpp;
@@ -39,7 +39,7 @@ void FirmwareService::setBuildNumber(const char *buildNumber) {
     if (buildNumber == nullptr)
         return;
     this->buildNumber = buildNumber;
-    previousBuildNumberString = declareConfiguration<const char*>("BUILD_NUMBER", this->buildNumber.c_str(), MOCPP_KEYVALUE_FN, false, false, false);
+    previousBuildNumberString = declareConfiguration<const char*>("BUILD_NUMBER", this->buildNumber.c_str(), MO_KEYVALUE_FN, false, false, false);
     checkedSuccessfulFwUpdate = false; //--> CS will be notified
 }
 
@@ -57,7 +57,7 @@ void FirmwareService::loop() {
     if (retries > 0 && timestampNow >= retreiveDate) {
 
         if (stage == UpdateStage::Idle) {
-            MOCPP_DBG_INFO("Start update");
+            MO_DBG_INFO("Start update");
 
             if (context.getModel().getNumConnectors() > 0) {
                 auto cp = context.getModel().getConnector(0);
@@ -75,7 +75,7 @@ void FirmwareService::loop() {
         }
 
         if (stage == UpdateStage::AwaitDownload) {
-            MOCPP_DBG_INFO("Start download");
+            MO_DBG_INFO("Start download");
             stage = UpdateStage::Downloading;
             if (onDownload != nullptr) {
                 onDownload(location.c_str());
@@ -94,7 +94,7 @@ void FirmwareService::loop() {
                     //passed download stage
                     stage = UpdateStage::AfterDownload;
                 } else if (downloadStatusInput() == DownloadStatus::DownloadFailed) {
-                    MOCPP_DBG_INFO("Download timeout or failed! Retry");
+                    MO_DBG_INFO("Download timeout or failed! Retry");
                     retreiveDate = timestampNow;
                     retreiveDate += retryInterval;
                     retries--;
@@ -134,13 +134,13 @@ void FirmwareService::loop() {
         }
 
         if (stage == UpdateStage::AwaitInstallation) {
-            MOCPP_DBG_INFO("Installing");
+            MO_DBG_INFO("Installing");
             stage = UpdateStage::Installing;
 
             if (onInstall) {
                 onInstall(location.c_str()); //should restart the device on success
             } else {
-                MOCPP_DBG_WARN("onInstall must be set! (see setOnInstall). Will abort");
+                MO_DBG_WARN("onInstall must be set! (see setOnInstall). Will abort");
             }
 
             timestampTransition = mocpp_tick_ms();
@@ -152,12 +152,12 @@ void FirmwareService::loop() {
 
             if (installationStatusInput) {
                 if (installationStatusInput() == InstallationStatus::Installed) {
-                    MOCPP_DBG_INFO("FW update finished");
+                    MO_DBG_INFO("FW update finished");
                     //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
                     resetStage();
                     retries = 0; //End of update routine. Client must reboot on its own
                 } else if (installationStatusInput() == InstallationStatus::InstallationFailed) {
-                    MOCPP_DBG_INFO("Installation timeout or failed! Retry");
+                    MO_DBG_INFO("Installation timeout or failed! Retry");
                     retreiveDate = timestampNow;
                     retreiveDate += retryInterval;
                     retries--;
@@ -168,7 +168,7 @@ void FirmwareService::loop() {
                 }
                 return;
             } else {
-                MOCPP_DBG_INFO("FW update finished");
+                MO_DBG_INFO("FW update finished");
                 //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
                 resetStage();
                 retries = 0; //End of update routine. Client must reboot on its own
@@ -177,7 +177,7 @@ void FirmwareService::loop() {
         }
 
         //should never reach this code
-        MOCPP_DBG_ERR("Firmware update failed");
+        MO_DBG_ERR("Firmware update failed");
         retries = 0;
         resetStage();
     }
@@ -189,16 +189,16 @@ void FirmwareService::scheduleFirmwareUpdate(const char *location, Timestamp ret
     this->retries = retries;
     this->retryInterval = retryInterval;
 
-    if (MOCPP_IGNORE_FW_RETR_DATE) {
-        MOCPP_DBG_DEBUG("ignore FW update retreive date");
+    if (MO_IGNORE_FW_RETR_DATE) {
+        MO_DBG_DEBUG("ignore FW update retreive date");
         this->retreiveDate = context.getModel().getClock().now();
     }
 
     char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
     this->retreiveDate.toJsonString(dbuf, JSONDATE_LENGTH + 1);
 
-#if MOCPP_DBG_LEVEL >= MOCPP_DL_INFO
-    MOCPP_DBG_INFO("Scheduled FW update!\n" \
+#if MO_DBG_LEVEL >= MO_DL_INFO
+    MO_DBG_INFO("Scheduled FW update!\n" \
                     "                  location = %s\n" \
                     "                  retrieveDate = %s\n" \
                     "                  retries = %u" \
@@ -250,7 +250,7 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
     if (!checkedSuccessfulFwUpdate && !buildNumber.empty() && previousBuildNumberString != nullptr) {
         checkedSuccessfulFwUpdate = true;
 
-        MOCPP_DBG_DEBUG("Previous build number: %s, new build number: %s", previousBuildNumberString->getString(), buildNumber.c_str());
+        MO_DBG_DEBUG("Previous build number: %s, new build number: %s", previousBuildNumberString->getString(), buildNumber.c_str());
         
         if (buildNumber.compare(previousBuildNumberString->getString())) {
             //new FW
@@ -300,7 +300,7 @@ void FirmwareService::resetStage() {
     installationIssued = false;
 }
 
-#if !defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
+#if !defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
 #if defined(ESP32)
 
 #include <HTTPUpdate.h>
@@ -340,15 +340,15 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
         switch (ret) {
             case HTTP_UPDATE_FAILED:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                MOCPP_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", httpUpdate.getLastError(), httpUpdate.getLastErrorString().c_str());
+                MO_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", httpUpdate.getLastError(), httpUpdate.getLastErrorString().c_str());
                 break;
             case HTTP_UPDATE_NO_UPDATES:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                MOCPP_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
+                MO_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
                 break;
             case HTTP_UPDATE_OK:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::Installed;});
-                MOCPP_DBG_INFO("HTTP_UPDATE_OK");
+                MO_DBG_INFO("HTTP_UPDATE_OK");
                 ESP.restart();
                 break;
         }
@@ -384,15 +384,15 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
         switch (ret) {
             case HTTP_UPDATE_FAILED:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                MOCPP_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", ESPhttpUpdate.getLastError(), ESPhttpUpdate.getLastErrorString().c_str());
+                MO_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", ESPhttpUpdate.getLastError(), ESPhttpUpdate.getLastErrorString().c_str());
                 break;
             case HTTP_UPDATE_NO_UPDATES:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                MOCPP_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
+                MO_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
                 break;
             case HTTP_UPDATE_OK:
                 fwService->setInstallationStatusInput([](){return InstallationStatus::Installed;});
-                MOCPP_DBG_INFO("HTTP_UPDATE_OK");
+                MO_DBG_INFO("HTTP_UPDATE_OK");
                 ESP.restart();
                 break;
         }
@@ -408,4 +408,4 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 }
 
 #endif //defined(ESP8266)
-#endif //!defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
+#endif //!defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
index 43a27406..cf9376d2 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
@@ -91,7 +91,7 @@ class FirmwareService {
 
 } //endif namespace MicroOcpp
 
-#if !defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
+#if !defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
 #if defined(ESP32) || defined(ESP8266)
 
 namespace MicroOcpp {
@@ -103,6 +103,6 @@ FirmwareService *makeFirmwareService(Context& context);
 }
 
 #endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(MOCPP_CUSTOM_UPDATER) && !defined(MOCPP_CUSTOM_WS)
+#endif //!defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
 
 #endif
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.cpp b/src/MicroOcpp/Model/Metering/MeterStore.cpp
index 0712fe8b..324fbbe2 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterStore.cpp
@@ -9,7 +9,7 @@
 
 #include <algorithm>
 
-#define MOCPP_MAX_STOPTXDATA_LEN 4
+#define MO_MAX_STOPTXDATA_LEN 4
 
 using namespace MicroOcpp;
 
@@ -17,28 +17,28 @@ TransactionMeterData::TransactionMeterData(unsigned int connectorId, unsigned in
         : connectorId(connectorId), txNr(txNr), filesystem{filesystem} {
     
     if (!filesystem) {
-        MOCPP_DBG_DEBUG("volatile mode");
+        MO_DBG_DEBUG("volatile mode");
         (void)0;
     }
 }
 
 bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
     if (isFinalized()) {
-        MOCPP_DBG_ERR("immutable");
+        MO_DBG_ERR("immutable");
         return false;
     }
 
     if (!mv) {
-        MOCPP_DBG_ERR("null");
+        MO_DBG_ERR("null");
         return false;
     }
 
-    if (MOCPP_MAX_STOPTXDATA_LEN <= 0) {
+    if (MO_MAX_STOPTXDATA_LEN <= 0) {
         //txData off
         return true;
     }
 
-    bool replaceLast = mvCount >= MOCPP_MAX_STOPTXDATA_LEN; //txData size exceeded? overwrite last entry instead of appending
+    bool replaceLast = mvCount >= MO_MAX_STOPTXDATA_LEN; //txData size exceeded? overwrite last entry instead of appending
 
     if (filesystem) {
 
@@ -49,21 +49,21 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
             mvIndex = mvCount ;
         }
 
-        char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvIndex);
-        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-            MOCPP_DBG_ERR("fn error: %i", ret);
+        char fn [MO_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, mvIndex);
+        if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+            MO_DBG_ERR("fn error: %i", ret);
             return false;
         }
 
         auto mvDoc = mv->toJson();
         if (!mvDoc) {
-            MOCPP_DBG_ERR("MV not ready yet");
+            MO_DBG_ERR("MV not ready yet");
             return false;
         }
 
         if (!FilesystemUtils::storeJson(filesystem, fn, *mvDoc)) {
-            MOCPP_DBG_ERR("FS error");
+            MO_DBG_ERR("FS error");
             return false;
         }
 
@@ -74,27 +74,27 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
 
     if (replaceLast) {
         txData.back() = std::move(mv);
-        MOCPP_DBG_DEBUG("updated latest sd");
+        MO_DBG_DEBUG("updated latest sd");
     } else {
         txData.push_back(std::move(mv));
-        MOCPP_DBG_DEBUG("added sd");
+        MO_DBG_DEBUG("added sd");
     }
     return true;
 }
 
 std::vector<std::unique_ptr<MeterValue>> TransactionMeterData::retrieveStopTxData() {
     if (isFinalized()) {
-        MOCPP_DBG_ERR("Can only retrieve once");
+        MO_DBG_ERR("Can only retrieve once");
         return decltype(txData) {};
     }
     finalize();
-    MOCPP_DBG_DEBUG("creating sd");
+    MO_DBG_DEBUG("creating sd");
     return std::move(txData);
 }
 
 bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
     if (!filesystem) {
-        MOCPP_DBG_DEBUG("No FS - nothing to restore");
+        MO_DBG_DEBUG("No FS - nothing to restore");
         return true;
     }
 
@@ -104,10 +104,10 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
 
     while (misses < MISSES_LIMIT) { //search until region without mvs found
         
-        char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
-        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-            MOCPP_DBG_ERR("fn error: %i", ret);
+        char fn [MO_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
+        if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+            MO_DBG_ERR("fn error: %i", ret);
             return false; //all files have same length
         }
 
@@ -123,14 +123,14 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
         std::unique_ptr<MeterValue> mv = mvBuilder.deserializeSample(mvJson);
 
         if (!mv) {
-            MOCPP_DBG_ERR("Deserialization error");
+            MO_DBG_ERR("Deserialization error");
             misses++;
             i++;
             continue;
         }
 
-        if (txData.size() >= MOCPP_MAX_STOPTXDATA_LEN) {
-            MOCPP_DBG_ERR("corrupted memory");
+        if (txData.size() >= MO_MAX_STOPTXDATA_LEN) {
+            MO_DBG_ERR("corrupted memory");
             return false;
         }
 
@@ -141,14 +141,14 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
         misses = 0;
     }
 
-    MOCPP_DBG_DEBUG("Restored %zu meter values", txData.size());
+    MO_DBG_DEBUG("Restored %zu meter values", txData.size());
     return true;
 }
 
 MeterStore::MeterStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem {filesystem} {
 
     if (!filesystem) {
-        MOCPP_DBG_DEBUG("volatile mode");
+        MO_DBG_DEBUG("volatile mode");
         (void)0;
     }
 }
@@ -190,10 +190,10 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
     auto tx = std::make_shared<TransactionMeterData>(connectorId, txNr, filesystem);
     
     if (filesystem) {
-        char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, 0);
-        if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-            MOCPP_DBG_ERR("fn error: %i", ret);
+        char fn [MO_MAX_PATH_SIZE] = {'\0'};
+        auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, 0);
+        if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+            MO_DBG_ERR("fn error: %i", ret);
             return nullptr; //cannot store
         }
 
@@ -203,14 +203,14 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
         if (exists) {
             if (!tx->restore(mvBuilder)) {
                 remove(connectorId, txNr);
-                MOCPP_DBG_ERR("removed corrupted tx entries");
+                MO_DBG_ERR("removed corrupted tx entries");
             }
         }
     }
 
     txMeterData.push_back(tx);
 
-    MOCPP_DBG_DEBUG("Added txNr %u, now holding %zu txs", txNr, txMeterData.size());
+    MO_DBG_DEBUG("Added txNr %u, now holding %zu txs", txNr, txMeterData.size());
 
     return tx;
 }
@@ -245,10 +245,10 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
 
             while (misses < MISSES_LIMIT) { //search until region without mvs found
                 
-                char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-                auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
-                if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-                    MOCPP_DBG_ERR("fn error: %i", ret);
+                char fn [MO_MAX_PATH_SIZE] = {'\0'};
+                auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, i);
+                if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+                    MO_DBG_ERR("fn error: %i", ret);
                     return false; //all files have same length
                 }
 
@@ -265,15 +265,15 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
             }
         }
 
-        MOCPP_DBG_DEBUG("remove %u mvs for txNr %u", mvCount, txNr);
+        MO_DBG_DEBUG("remove %u mvs for txNr %u", mvCount, txNr);
 
         for (unsigned int i = 0; i < mvCount; i++) {
             unsigned int sd = mvCount - 1U - i;
         
-            char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, sd);
-            if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-                MOCPP_DBG_ERR("fn error: %i", ret);
+            char fn [MO_MAX_PATH_SIZE] = {'\0'};
+            auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "sd" "-%u-%u-%u.jsn", connectorId, txNr, sd);
+            if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+                MO_DBG_ERR("fn error: %i", ret);
                 return false;
             }
 
@@ -290,10 +290,10 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
             txMeterData.end());
 
     if (success) {
-        MOCPP_DBG_DEBUG("Removed meter values for cId %u, txNr %u", connectorId, txNr);
+        MO_DBG_DEBUG("Removed meter values for cId %u, txNr %u", connectorId, txNr);
         (void)0;
     } else {
-        MOCPP_DBG_DEBUG("corrupted fs");
+        MO_DBG_DEBUG("corrupted fs");
     }
 
     return success;
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.cpp b/src/MicroOcpp/Model/Metering/MeterValue.cpp
index 052a9c9a..45fd41ef 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterValue.cpp
@@ -104,7 +104,7 @@ void MeterValueBuilder::updateObservedSamplers() {
 std::unique_ptr<MeterValue> MeterValueBuilder::takeSample(const Timestamp& timestamp, const ReadingContext& context) {
     if (select_observe != selectString->getValueRevision() || //OCPP server has changed configuration about which measurands to take
             samplers.size() != select_mask.size()) {    //Client has added another Measurand; synchronize lists
-        MOCPP_DBG_DEBUG("Updating observed samplers due to config change or samplers added");
+        MO_DBG_DEBUG("Updating observed samplers due to config change or samplers added");
         updateObservedSamplers();
         select_observe = selectString->getValueRevision();
     }
@@ -129,7 +129,7 @@ std::unique_ptr<MeterValue> MeterValueBuilder::deserializeSample(const JsonObjec
     Timestamp timestamp;
     bool ret = timestamp.setTime(mvJson["timestamp"] | "Invalid");
     if (!ret) {
-        MOCPP_DBG_ERR("invalid timestamp");
+        MO_DBG_ERR("invalid timestamp");
         return nullptr;
     }
 
@@ -149,13 +149,13 @@ std::unique_ptr<MeterValue> MeterValueBuilder::deserializeSample(const JsonObjec
                 if (dVal) {
                     sample->addSampledValue(std::move(dVal));
                 } else {
-                    MOCPP_DBG_ERR("deserialization error");
+                    MO_DBG_ERR("deserialization error");
                 }
                 break;
             }
         }
     }
 
-    MOCPP_DBG_VERBOSE("deserialized MV");
+    MO_DBG_VERBOSE("deserialized MV");
     return sample;
 }
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index 0decf121..fb84a24a 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -22,7 +22,7 @@ MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore&
 
     auto meterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData", "");
     declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
-    meterValueCacheSizeInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 1);
+    meterValueCacheSizeInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "MeterValueCacheSize", 1);
     meterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval", 60);
     
     auto stopTxnSampledDataString = declareConfiguration<const char*>("StopTxnSampledData", "");
@@ -34,8 +34,8 @@ MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore&
     
     auto stopTxnAlignedDataString = declareConfiguration<const char*>("StopTxnAlignedData", "");
 
-    meterValuesInTxOnlyBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "MeterValuesInTxOnly", true);
-    stopTxnDataCapturePeriodicBool = declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "StopTxnDataCapturePeriodic", false);
+    meterValuesInTxOnlyBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "MeterValuesInTxOnly", true);
+    stopTxnDataCapturePeriodicBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "StopTxnDataCapturePeriodic", false);
 
     sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, meterValuesSampledDataString));
     alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, meterValuesAlignedDataString));
@@ -71,7 +71,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
             //check during transaction
 
             if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
-                MOCPP_DBG_WARN("reload stopTxnData");
+                MO_DBG_WARN("reload stopTxnData");
                 //reload (e.g. after power cut during transaction)
                 stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction.get());
             }
@@ -93,7 +93,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         if (dt <= 0 ||                              //normal case: interval elapsed
                 dt > clockAlignedDataIntervalInt->getInt()) {   //special case: clock has been adjusted or first run
 
-            MOCPP_DBG_DEBUG("Clock aligned measurement %" PRId32 "s: %s", dt,
+            MO_DBG_DEBUG("Clock aligned measurement %" PRId32 "s: %s", dt,
                 abs(dt) <= 60 ?
                 "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
@@ -183,7 +183,7 @@ std::unique_ptr<SampledValue> MeteringConnector::readTxEnergyMeter(ReadingContex
     if (energySamplerIndex >= 0 && (size_t) energySamplerIndex < samplers.size()) {
         return samplers[energySamplerIndex]->takeValue(model);
     } else {
-        MOCPP_DBG_DEBUG("Called readTxEnergyMeter(), but no energySampler or handling strategy set");
+        MO_DBG_DEBUG("Called readTxEnergyMeter(), but no energySampler or handling strategy set");
         return nullptr;
     }
 }
@@ -220,7 +220,7 @@ std::shared_ptr<TransactionMeterData> MeteringConnector::getStopTxMeterData(Tran
     auto txData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction);
 
     if (!txData) {
-        MOCPP_DBG_ERR("could not create TxData");
+        MO_DBG_ERR("could not create TxData");
         return nullptr;
     }
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index 53fe8d50..b2bc7373 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -48,7 +48,7 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
             }
             if (!found) {
                 isValid = false;
-                MOCPP_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
+                MO_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
                 break;
             }
             l = r;
@@ -83,7 +83,7 @@ void MeteringService::loop(){
 
 void MeteringService::addMeterValueSampler(int connectorId, std::unique_ptr<SampledValueSampler> meterValueSampler) {
     if (connectorId < 0 || connectorId >= (int) connectors.size()) {
-        MOCPP_DBG_ERR("connectorId is out of bounds");
+        MO_DBG_ERR("connectorId is out of bounds");
         return;
     }
     connectors[connectorId]->addMeterValueSampler(std::move(meterValueSampler));
@@ -91,7 +91,7 @@ void MeteringService::addMeterValueSampler(int connectorId, std::unique_ptr<Samp
 
 std::unique_ptr<SampledValue> MeteringService::readTxEnergyMeter(int connectorId, ReadingContext context) {
     if (connectorId < 0 || (size_t) connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("connectorId is out of bounds");
+        MO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
     return connectors[connectorId]->readTxEnergyMeter(context);
@@ -99,7 +99,7 @@ std::unique_ptr<SampledValue> MeteringService::readTxEnergyMeter(int connectorId
 
 std::unique_ptr<Request> MeteringService::takeTriggeredMeterValues(int connectorId) {
     if (connectorId < 0 || connectorId >= (int) connectors.size()) {
-        MOCPP_DBG_ERR("connectorId out of bounds. Ignore");
+        MO_DBG_ERR("connectorId out of bounds. Ignore");
         return nullptr;
     }
     auto& connector = connectors.at(connectorId);
@@ -110,21 +110,21 @@ std::unique_ptr<Request> MeteringService::takeTriggeredMeterValues(int connector
             meterValues->setTimeout(120000);
             return meterValues;
         }
-        MOCPP_DBG_DEBUG("Did not take any samples for connectorId %d", connectorId);
+        MO_DBG_DEBUG("Did not take any samples for connectorId %d", connectorId);
         return nullptr;
     }
-    MOCPP_DBG_ERR("Could not find connector");
+    MO_DBG_ERR("Could not find connector");
     return nullptr;
 }
 
 void MeteringService::beginTxMeterData(Transaction *transaction) {
     if (!transaction) {
-        MOCPP_DBG_ERR("invalid argument");
+        MO_DBG_ERR("invalid argument");
         return;
     }
     auto connectorId = transaction->getConnectorId();
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("connectorId is out of bounds");
+        MO_DBG_ERR("connectorId is out of bounds");
         return;
     }
     auto& connector = connectors[connectorId];
@@ -134,12 +134,12 @@ void MeteringService::beginTxMeterData(Transaction *transaction) {
 
 std::shared_ptr<TransactionMeterData> MeteringService::endTxMeterData(Transaction *transaction) {
     if (!transaction) {
-        MOCPP_DBG_ERR("invalid argument");
+        MO_DBG_ERR("invalid argument");
         return nullptr;
     }
     auto connectorId = transaction->getConnectorId();
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("connectorId is out of bounds");
+        MO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
     auto& connector = connectors[connectorId];
@@ -149,12 +149,12 @@ std::shared_ptr<TransactionMeterData> MeteringService::endTxMeterData(Transactio
 
 std::shared_ptr<TransactionMeterData> MeteringService::getStopTxMeterData(Transaction *transaction) {
     if (!transaction) {
-        MOCPP_DBG_ERR("invalid argument");
+        MO_DBG_ERR("invalid argument");
         return nullptr;
     }
     auto connectorId = transaction->getConnectorId();
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("connectorId is out of bounds");
+        MO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
     auto& connector = connectors[connectorId];
diff --git a/src/MicroOcpp/Model/Metering/SampledValue.cpp b/src/MicroOcpp/Model/Metering/SampledValue.cpp
index 6c7a8f76..c08ce851 100644
--- a/src/MicroOcpp/Model/Metering/SampledValue.cpp
+++ b/src/MicroOcpp/Model/Metering/SampledValue.cpp
@@ -40,7 +40,7 @@ const char *serializeReadingContext(ReadingContext context) {
         case (ReadingContext::Trigger):
             return "Trigger";
         default:
-            MOCPP_DBG_ERR("ReadingContext not specified");
+            MO_DBG_ERR("ReadingContext not specified");
             /* fall through */
         case (ReadingContext::NOT_SET):
             return nullptr;
@@ -48,12 +48,12 @@ const char *serializeReadingContext(ReadingContext context) {
 }
 ReadingContext deserializeReadingContext(const char *context) {
     if (!context) {
-        MOCPP_DBG_ERR("Invalid argument");
+        MO_DBG_ERR("Invalid argument");
         return ReadingContext::NOT_SET;
     }
 
     if (!strcmp(context, "NOT_SET")) {
-        MOCPP_DBG_DEBUG("Deserialize Null-ReadingContext");
+        MO_DBG_DEBUG("Deserialize Null-ReadingContext");
         return ReadingContext::NOT_SET;
     } else if (!strcmp(context, "Sample.Periodic")) {
         return ReadingContext::SamplePeriodic;
@@ -73,7 +73,7 @@ ReadingContext deserializeReadingContext(const char *context) {
         return ReadingContext::Trigger;
     }
 
-    MOCPP_DBG_ERR("ReadingContext not specified %.10s", context);
+    MO_DBG_ERR("ReadingContext not specified %.10s", context);
     return ReadingContext::NOT_SET;
 }
 }} //end namespaces
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 835459f5..f0bd7beb 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -112,7 +112,7 @@ unsigned int Model::getNumConnectors() const {
 
 Connector *Model::getConnector(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("connector with connectorId %u does not exist", connectorId);
+        MO_DBG_ERR("connector with connectorId %u does not exist", connectorId);
         return nullptr;
     }
 
@@ -201,7 +201,7 @@ void Model::updateSupportedStandardProfiles() {
         declareConfiguration<const char*>("SupportedFeatureProfiles", "", CONFIGURATION_VOLATILE, true);
     
     if (!supportedFeatureProfilesString) {
-        MOCPP_DBG_ERR("OOM");
+        MO_DBG_ERR("OOM");
         return;
     }
 
@@ -252,5 +252,5 @@ void Model::updateSupportedStandardProfiles() {
 
     supportedFeatureProfilesString->setString(buf.c_str());
 
-    MOCPP_DBG_DEBUG("supported feature profiles: %s", buf.c_str());
+    MO_DBG_DEBUG("supported feature profiles: %s", buf.c_str());
 }
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index d8f744dd..1273153f 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_MODEL_H
-#define MOCPP_MODEL_H
+#ifndef MO_MODEL_H
+#define MO_MODEL_H
 
 #include <memory>
 
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
index 62af789f..302ac8cb 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.cpp
+++ b/src/MicroOcpp/Model/Reservation/Reservation.cpp
@@ -10,23 +10,23 @@ using namespace MicroOcpp;
 
 Reservation::Reservation(Model& model, unsigned int slot) : model(model), slot(slot) {
     
-    snprintf(connectorIdKey, sizeof(connectorIdKey), MOCPP_RESERVATION_CID_KEY "%u", slot);
+    snprintf(connectorIdKey, sizeof(connectorIdKey), MO_RESERVATION_CID_KEY "%u", slot);
     connectorIdInt = declareConfiguration<int>(connectorIdKey, -1, RESERVATION_FN, false, false, false);
 
-    snprintf(expiryDateRawKey, sizeof(expiryDateRawKey), MOCPP_RESERVATION_EXPDATE_KEY "%u", slot);
+    snprintf(expiryDateRawKey, sizeof(expiryDateRawKey), MO_RESERVATION_EXPDATE_KEY "%u", slot);
     expiryDateRawString = declareConfiguration<const char*>(expiryDateRawKey, "", RESERVATION_FN, false, false, false);
     
-    snprintf(idTagKey, sizeof(idTagKey), MOCPP_RESERVATION_IDTAG_KEY "%u", slot);
+    snprintf(idTagKey, sizeof(idTagKey), MO_RESERVATION_IDTAG_KEY "%u", slot);
     idTagString = declareConfiguration<const char*>(idTagKey, "", RESERVATION_FN, false, false, false);
 
-    snprintf(reservationIdKey, sizeof(reservationIdKey), MOCPP_RESERVATION_RESID_KEY "%u", slot);
+    snprintf(reservationIdKey, sizeof(reservationIdKey), MO_RESERVATION_RESID_KEY "%u", slot);
     reservationIdInt = declareConfiguration<int>(reservationIdKey, -1, RESERVATION_FN, false, false, false);
 
-    snprintf(parentIdTagKey, sizeof(parentIdTagKey), MOCPP_RESERVATION_PARENTID_KEY "%u", slot);
+    snprintf(parentIdTagKey, sizeof(parentIdTagKey), MO_RESERVATION_PARENTID_KEY "%u", slot);
     parentIdTagString = declareConfiguration<const char*>(parentIdTagKey, "", RESERVATION_FN, false, false, false);
 
     if (!connectorIdInt || !expiryDateRawString || !idTagString || !reservationIdInt || !parentIdTagString) {
-        MOCPP_DBG_ERR("initialization failure");
+        MO_DBG_ERR("initialization failure");
         (void)0;
     }
 }
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.h b/src/MicroOcpp/Model/Reservation/Reservation.h
index 11f9a851..6722df1b 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.h
+++ b/src/MicroOcpp/Model/Reservation/Reservation.h
@@ -9,14 +9,14 @@
 #include <MicroOcpp/Core/Time.h>
 
 #ifndef RESERVATION_FN
-#define RESERVATION_FN (MOCPP_FILENAME_PREFIX "reservations.jsn")
+#define RESERVATION_FN (MO_FILENAME_PREFIX "reservations.jsn")
 #endif
 
-#define MOCPP_RESERVATION_CID_KEY "cid_"
-#define MOCPP_RESERVATION_EXPDATE_KEY "expdt_"
-#define MOCPP_RESERVATION_IDTAG_KEY "idt_"
-#define MOCPP_RESERVATION_RESID_KEY "rsvid_"
-#define MOCPP_RESERVATION_PARENTID_KEY "pidt_"
+#define MO_RESERVATION_CID_KEY "cid_"
+#define MO_RESERVATION_EXPDATE_KEY "expdt_"
+#define MO_RESERVATION_IDTAG_KEY "idt_"
+#define MO_RESERVATION_RESID_KEY "rsvid_"
+#define MO_RESERVATION_PARENTID_KEY "pidt_"
 
 namespace MicroOcpp {
 
@@ -28,17 +28,17 @@ class Reservation {
     const unsigned int slot;
 
     std::shared_ptr<Configuration> connectorIdInt;
-    char connectorIdKey [sizeof(MOCPP_RESERVATION_CID_KEY "xxx") + 1]; //"xxx" = placeholder for digits
+    char connectorIdKey [sizeof(MO_RESERVATION_CID_KEY "xxx") + 1]; //"xxx" = placeholder for digits
     std::shared_ptr<Configuration> expiryDateRawString;
-    char expiryDateRawKey [sizeof(MOCPP_RESERVATION_EXPDATE_KEY "xxx") + 1];
+    char expiryDateRawKey [sizeof(MO_RESERVATION_EXPDATE_KEY "xxx") + 1];
 
     Timestamp expiryDate = MIN_TIME;
     std::shared_ptr<Configuration> idTagString;
-    char idTagKey [sizeof(MOCPP_RESERVATION_IDTAG_KEY "xxx") + 1];
+    char idTagKey [sizeof(MO_RESERVATION_IDTAG_KEY "xxx") + 1];
     std::shared_ptr<Configuration> reservationIdInt;
-    char reservationIdKey [sizeof(MOCPP_RESERVATION_RESID_KEY "xxx") + 1];
+    char reservationIdKey [sizeof(MO_RESERVATION_RESID_KEY "xxx") + 1];
     std::shared_ptr<Configuration> parentIdTagString;
-    char parentIdTagKey [sizeof(MOCPP_RESERVATION_PARENTID_KEY "xxx") + 1];
+    char parentIdTagKey [sizeof(MO_RESERVATION_PARENTID_KEY "xxx") + 1];
 
 public:
     Reservation(Model& model, unsigned int slot);
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index 1c58ac09..63782cda 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -72,7 +72,7 @@ void ReservationService::loop() {
 
 Reservation *ReservationService::getReservation(unsigned int connectorId) {
     if (connectorId == 0) {
-        MOCPP_DBG_DEBUG("tried to fetch connectorId 0");
+        MO_DBG_DEBUG("tried to fetch connectorId 0");
         return nullptr; //cannot fetch for connectorId 0 because multiple reservations are possible at a time
     }
 
@@ -87,7 +87,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId) {
 
 Reservation *ReservationService::getReservation(const char *idTag, const char *parentIdTag) {
     if (idTag == nullptr) {
-        MOCPP_DBG_ERR("invalid input");
+        MO_DBG_ERR("invalid input");
         return nullptr;
     }
 
@@ -130,7 +130,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
 
     if (reserveConnectorZeroSupportedBool && !reserveConnectorZeroSupportedBool->getBool()) {
         //no connectorZero check - all done
-        MOCPP_DBG_DEBUG("no reservation");
+        MO_DBG_DEBUG("no reservation");
         return nullptr;
     }
 
@@ -181,7 +181,7 @@ Reservation *ReservationService::getReservationById(int reservationId) {
 bool ReservationService::updateReservation(int reservationId, unsigned int connectorId, Timestamp expiryDate, const char *idTag, const char *parentIdTag) {
     if (auto reservation = getReservationById(reservationId)) {
         if (getReservation(connectorId) && getReservation(connectorId) != reservation && getReservation(connectorId)->isActive()) {
-            MOCPP_DBG_DEBUG("found blocking reservation at connectorId %u", connectorId);
+            MO_DBG_DEBUG("found blocking reservation at connectorId %u", connectorId);
             return false; //cannot transfer reservation to other connector with existing reservation
         }
         reservation->update(reservationId, connectorId, expiryDate, idTag, parentIdTag);
@@ -194,7 +194,7 @@ bool ReservationService::updateReservation(int reservationId, unsigned int conne
 //                payload["idTag"],
 //                payload.containsKey("parentIdTag") ? payload["parentIdTag"] : nullptr)) {
 //    if (auto reservation = getReservation(payload["connectorId"].as<int>())) {
-        MOCPP_DBG_DEBUG("found blocking reservation at connectorId %u", reservation->getConnectorId());
+        MO_DBG_DEBUG("found blocking reservation at connectorId %u", reservation->getConnectorId());
         (void)reservation;
         return false;
     }
@@ -207,6 +207,6 @@ bool ReservationService::updateReservation(int reservationId, unsigned int conne
         }
     }
 
-    MOCPP_DBG_ERR("error finding blocking reservation");
+    MO_DBG_ERR("error finding blocking reservation");
     return false;
 }
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index 68a3ea1b..43f7b680 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -42,13 +42,13 @@ void ResetService::loop() {
         t_resetRetry = mocpp_tick_ms();
         outstandingResetRetries--;
         if (executeReset) {
-            MOCPP_DBG_INFO("Reset device");
+            MO_DBG_INFO("Reset device");
             executeReset(isHardReset);
         } else {
-            MOCPP_DBG_ERR("No Reset function set! Abort");
+            MO_DBG_ERR("No Reset function set! Abort");
             outstandingResetRetries = 0;
         }
-        MOCPP_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
+        MO_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
 
         if (outstandingResetRetries <= 0) {
             for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
@@ -92,7 +92,7 @@ void ResetService::initiateReset(bool isHard) {
     isHardReset = isHard;
     outstandingResetRetries = 1 + resetRetriesInt->getInt(); //one initial try + no. of retries
     if (outstandingResetRetries > 5) {
-        MOCPP_DBG_ERR("no. of reset trials exceeds 5");
+        MO_DBG_ERR("no. of reset trials exceeds 5");
         outstandingResetRetries = 5;
     }
     t_resetRetry = mocpp_tick_ms();
@@ -103,11 +103,11 @@ void ResetService::initiateReset(bool isHard) {
     }
 }
 
-#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
 std::function<void(bool isHard)> MicroOcpp::makeDefaultResetFn() {
     return [] (bool isHard) {
-        MOCPP_DBG_DEBUG("Perform ESP reset");
+        MO_DBG_DEBUG("Perform ESP reset");
         ESP.restart();
     };
 }
-#endif //MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+#endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
diff --git a/src/MicroOcpp/Model/Reset/ResetService.h b/src/MicroOcpp/Model/Reset/ResetService.h
index 992785e3..f4409aa0 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.h
+++ b/src/MicroOcpp/Model/Reset/ResetService.h
@@ -43,7 +43,7 @@ class ResetService {
 
 } //end namespace MicroOcpp
 
-#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
 
 namespace MicroOcpp {
 
@@ -51,6 +51,6 @@ std::function<void(bool isHard)> makeDefaultResetFn();
 
 }
 
-#endif //MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+#endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
 
 #endif
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
index e9950eac..e8355f61 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -35,7 +35,7 @@ bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &start
             } else if (startOfCharging > MIN_TIME && startOfCharging < t) {
                 basis = startOfCharging;
             } else {
-                MOCPP_DBG_ERR("Absolute profile, but neither startSchedule, nor start of charging are set. Undefined behavior, abort");
+                MO_DBG_ERR("Absolute profile, but neither startSchedule, nor start of charging are set. Undefined behavior, abort");
                 return false;
             }
             break;
@@ -47,7 +47,7 @@ bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &start
                 basis = t - ((t - startSchedule) % (7 * 24 * 3600));
                 nextChange = std::min(nextChange, basis + (7 * 24 * 3600));
             } else {
-                MOCPP_DBG_ERR("Recurring ChargingProfile but no RecurrencyKindType set. Undefined behavior, assume 'Daily'");
+                MO_DBG_ERR("Recurring ChargingProfile but no RecurrencyKindType set. Undefined behavior, assume 'Daily'");
                 basis = t - ((t - startSchedule) % (24 * 3600));
                 nextChange = std::min(nextChange, basis + (24 * 3600));
             }
@@ -64,7 +64,7 @@ bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &start
     }
 
     if (t < basis) { //check for error
-        MOCPP_DBG_ERR("time basis is smaller than t, but t must be >= basis");
+        MO_DBG_ERR("time basis is smaller than t, but t must be >= basis");
         return false;
     }
     
@@ -151,7 +151,7 @@ void ChargingSchedule::printSchedule(){
     char tmp[JSONDATE_LENGTH + 1] = {'\0'};
     startSchedule.toJsonString(tmp, JSONDATE_LENGTH + 1);
 
-    MOCPP_CONSOLE_PRINTF("   > CHARGING SCHEDULE:\n" \
+    MO_CONSOLE_PRINTF("   > CHARGING SCHEDULE:\n" \
                 "       > duration: %i\n" \
                 "       > startSchedule: %s\n" \
                 "       > chargingRateUnit: %s\n" \
@@ -163,7 +163,7 @@ void ChargingSchedule::printSchedule(){
                 minChargingRate);
 
     for (auto period = chargingSchedulePeriod.begin(); period != chargingSchedulePeriod.end(); period++) {
-        MOCPP_CONSOLE_PRINTF("       > CHARGING SCHEDULE PERIOD:\n" \
+        MO_CONSOLE_PRINTF("       > CHARGING SCHEDULE PERIOD:\n" \
                 "           > startPeriod: %i\n" \
                 "           > limit: %f\n" \
                 "           > numberPhases: %i\n",
@@ -262,7 +262,7 @@ bool ChargingProfile::toJson(DynamicJsonDocument& doc) {
 
     if (validFrom > MIN_TIME) {
         if (!validFrom.toJsonString(timeStr, JSONDATE_LENGTH + 1)) {
-            MOCPP_DBG_ERR("serialization error");
+            MO_DBG_ERR("serialization error");
             return false;
         }
         doc["validFrom"] = timeStr;
@@ -270,7 +270,7 @@ bool ChargingProfile::toJson(DynamicJsonDocument& doc) {
 
     if (validTo > MIN_TIME) {
         if (!validTo.toJsonString(timeStr, JSONDATE_LENGTH + 1)) {
-            MOCPP_DBG_ERR("serialization error");
+            MO_DBG_ERR("serialization error");
             return false;
         }
         doc["validTo"] = timeStr;
@@ -288,7 +288,7 @@ void ChargingProfile::printProfile(){
     char tmp2[JSONDATE_LENGTH + 1] = {'\0'};
     validTo.toJsonString(tmp2, JSONDATE_LENGTH + 1);
 
-    MOCPP_CONSOLE_PRINTF("   > CHARGING PROFILE:\n" \
+    MO_CONSOLE_PRINTF("   > CHARGING PROFILE:\n" \
                 "   > chargingProfileId: %i\n" \
                 "   > transactionId: %i\n" \
                 "   > stackLevel: %i\n" \
@@ -300,7 +300,7 @@ void ChargingProfile::printProfile(){
                     chargingProfilePurpose == (ChargingProfilePurposeType::TxDefaultProfile) ? "TxDefaultProfile" :
                     chargingProfilePurpose == (ChargingProfilePurposeType::TxProfile) ? "TxProfile" : "Error"
                 );
-    MOCPP_CONSOLE_PRINTF(
+    MO_CONSOLE_PRINTF(
                 "   > chargingProfileKind: %s\n" \
                 "   > recurrencyKind: %s\n" \
                 "   > validFrom: %s\n" \
@@ -325,7 +325,7 @@ bool loadChargingSchedulePeriod(JsonObject& json, ChargingSchedulePeriod& out) {
     if (startPeriod >= 0) {
         out.startPeriod = startPeriod;
     } else {
-        MOCPP_DBG_WARN("format violation");
+        MO_DBG_WARN("format violation");
         return false;
     }
 
@@ -333,7 +333,7 @@ bool loadChargingSchedulePeriod(JsonObject& json, ChargingSchedulePeriod& out) {
     if (limit >= 0.f) {
         out.limit = limit;
     } else {
-        MOCPP_DBG_WARN("format violation");
+        MO_DBG_WARN("format violation");
         return false;
     }
 
@@ -342,7 +342,7 @@ bool loadChargingSchedulePeriod(JsonObject& json, ChargingSchedulePeriod& out) {
         if (numberPhases >= 0 && numberPhases <= 3) {
             out.numberPhases = numberPhases;
         } else {
-            MOCPP_DBG_WARN("format violation");
+            MO_DBG_WARN("format violation");
             return false;
         }
     }
@@ -359,7 +359,7 @@ std::unique_ptr<ChargingProfile> MicroOcpp::loadChargingProfile(JsonObject& json
     if (chargingProfileId >= 0) {
         res->chargingProfileId = chargingProfileId;
     } else {
-        MOCPP_DBG_WARN("format violation");
+        MO_DBG_WARN("format violation");
         return nullptr;
     }
 
@@ -372,7 +372,7 @@ std::unique_ptr<ChargingProfile> MicroOcpp::loadChargingProfile(JsonObject& json
     if (stackLevel >= 0 && stackLevel <= CHARGEPROFILEMAXSTACKLEVEL) {
         res->stackLevel = stackLevel;
     } else {
-        MOCPP_DBG_WARN("format violation");
+        MO_DBG_WARN("format violation");
         return nullptr;
     }
 
@@ -384,7 +384,7 @@ std::unique_ptr<ChargingProfile> MicroOcpp::loadChargingProfile(JsonObject& json
     } else if (!strcmp(chargingProfilePurposeStr, "TxProfile")) {
         res->chargingProfilePurpose = ChargingProfilePurposeType::TxProfile;
     } else {
-        MOCPP_DBG_WARN("format violation");
+        MO_DBG_WARN("format violation");
         return nullptr;
     }
 
@@ -396,7 +396,7 @@ std::unique_ptr<ChargingProfile> MicroOcpp::loadChargingProfile(JsonObject& json
     } else if (!strcmp(chargingProfileKindStr, "Relative")) {
         res->chargingProfileKind = ChargingProfileKindType::Relative;
     } else {
-        MOCPP_DBG_WARN("format violation");
+        MO_DBG_WARN("format violation");
         return nullptr;
     }
 
@@ -407,12 +407,12 @@ std::unique_ptr<ChargingProfile> MicroOcpp::loadChargingProfile(JsonObject& json
         res->recurrencyKind = RecurrencyKindType::Weekly;
     }
 
-    MOCPP_DBG_DEBUG("Deserialize JSON: chargingProfileId=%i, chargingProfilePurpose=%s, recurrencyKind=%s", chargingProfileId, chargingProfilePurposeStr, recurrencyKindStr);
+    MO_DBG_DEBUG("Deserialize JSON: chargingProfileId=%i, chargingProfilePurpose=%s, recurrencyKind=%s", chargingProfileId, chargingProfilePurposeStr, recurrencyKindStr);
 
     if (json.containsKey("validFrom")) {
         if (!res->validFrom.setTime(json["validFrom"] | "Invalid")) {
             //non-success
-            MOCPP_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            MO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
             return nullptr;
         }
     } else {
@@ -422,7 +422,7 @@ std::unique_ptr<ChargingProfile> MicroOcpp::loadChargingProfile(JsonObject& json
     if (json.containsKey("validTo")) {
         if (!res->validTo.setTime(json["validTo"] | "Invalid")) {
             //non-success
-            MOCPP_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            MO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
             return nullptr;
         }
     } else {
@@ -449,7 +449,7 @@ bool MicroOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
         if (duration >= 0) {
             out.duration = duration;
         } else {
-            MOCPP_DBG_WARN("format violation");
+            MO_DBG_WARN("format violation");
             return false;
         }
     }
@@ -457,7 +457,7 @@ bool MicroOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
     if (json.containsKey("startSchedule")) {
         if (!out.startSchedule.setTime(json["startSchedule"] | "Invalid")) {
             //non-success
-            MOCPP_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
+            MO_DBG_WARN("datetime format violation, expect format like 2022-02-01T20:53:32.486Z");
             return false;
         }
     } else {
@@ -470,13 +470,13 @@ bool MicroOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
     } else if (unit[0] == 'w' || unit[0] == 'W') {
         out.chargingRateUnit = ChargingRateUnitType::Watt;
     } else {
-        MOCPP_DBG_WARN("format violation");
+        MO_DBG_WARN("format violation");
         return false;
     }
     
     JsonArray periodJsonArray = json["chargingSchedulePeriod"];
     if (periodJsonArray.size() < 1) {
-        MOCPP_DBG_WARN("format violation");
+        MO_DBG_WARN("format violation");
         return false;
     }
 
@@ -492,7 +492,7 @@ bool MicroOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
         if (minChargingRate >= 0.f) {
             out.minChargingRate = minChargingRate;
         } else {
-            MOCPP_DBG_WARN("format violation");
+            MO_DBG_WARN("format violation");
             return false;
         }
     }
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index da04bf6b..a3c6be08 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -174,7 +174,7 @@ void SmartChargingConnector::loop(){
 
 void SmartChargingConnector::setSmartChargingOutput(std::function<void(float,float,int)> limitOutput) {
     if (this->limitOutput) {
-        MOCPP_DBG_WARN("replacing existing SmartChargingOutput");
+        MO_DBG_WARN("replacing existing SmartChargingOutput");
         (void)0;
     }
     this->limitOutput = limitOutput;
@@ -195,7 +195,7 @@ ChargingProfile *SmartChargingConnector::updateProfiles(std::unique_ptr<Charging
             return TxProfile[stackLevel].get();
     }
 
-    MOCPP_DBG_ERR("invalid args");
+    MO_DBG_ERR("invalid args");
     return nullptr;
 }
 
@@ -325,18 +325,18 @@ SmartChargingService::~SmartChargingService() {
 ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile){
 
     if ((connectorId > 0 && !getScConnectorById(connectorId)) || !chargingProfile) {
-        MOCPP_DBG_ERR("invalid args");
+        MO_DBG_ERR("invalid args");
         return nullptr;
     }
 
-    if (MOCPP_DBG_LEVEL >= MOCPP_DL_VERBOSE) {
-        MOCPP_DBG_VERBOSE("Charging Profile internal model:");
+    if (MO_DBG_LEVEL >= MO_DL_VERBOSE) {
+        MO_DBG_VERBOSE("Charging Profile internal model:");
         chargingProfile->printProfile();
     }
 
     int stackLevel = chargingProfile->getStackLevel();
     if (stackLevel< 0 || stackLevel >= CHARGEPROFILEMAXSTACKLEVEL + 1) {
-        MOCPP_DBG_ERR("input validation failed");
+        MO_DBG_ERR("input validation failed");
         return nullptr;
     }
 
@@ -354,7 +354,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
     }
 
     if (chargingProfilesCount >= MAXCHARGINGPROFILESINSTALLED) {
-        MOCPP_DBG_WARN("number of maximum charging profiles exceeded");
+        MO_DBG_WARN("number of maximum charging profiles exceeded");
         return nullptr;
     }
 
@@ -363,7 +363,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
     switch (chargingProfile->getChargingProfilePurpose()) {
         case (ChargingProfilePurposeType::ChargePointMaxProfile):
             if (connectorId != 0) {
-                MOCPP_DBG_WARN("invalid charging profile");
+                MO_DBG_WARN("invalid charging profile");
                 return nullptr;
             }
             ChargePointMaxProfile[stackLevel] = std::move(chargingProfile);
@@ -375,7 +375,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
                 res = ChargePointTxDefaultProfile[stackLevel].get();
             } else {
                 if (!getScConnectorById(connectorId)) {
-                    MOCPP_DBG_WARN("invalid charging profile");
+                    MO_DBG_WARN("invalid charging profile");
                     return nullptr;
                 }
                 res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
@@ -383,7 +383,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
             break;
         case (ChargingProfilePurposeType::TxProfile):
             if (!getScConnectorById(connectorId)) {
-                MOCPP_DBG_WARN("invalid charging profile");
+                MO_DBG_WARN("invalid charging profile");
                 return nullptr;
             }
             res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
@@ -409,13 +409,13 @@ bool SmartChargingService::loadProfiles() {
     bool success = true;
 
     if (!filesystem) {
-        MOCPP_DBG_DEBUG("no filesystem");
+        MO_DBG_DEBUG("no filesystem");
         return true; //not an error
     }
 
     ChargingProfilePurposeType purposes[] = {ChargingProfilePurposeType::ChargePointMaxProfile, ChargingProfilePurposeType::TxDefaultProfile, ChargingProfilePurposeType::TxProfile};
 
-    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
 
     for (auto purpose : purposes) {
         for (unsigned int cId = 0; cId < numConnectors; cId++) {
@@ -424,7 +424,7 @@ bool SmartChargingService::loadProfiles() {
             }
             for (unsigned int iLevel = 0; iLevel < CHARGEPROFILEMAXSTACKLEVEL; iLevel++) {
 
-                if (!SmartChargingServiceUtils::printProfileFileName(fn, MOCPP_MAX_PATH_SIZE, cId, purpose, iLevel)) {
+                if (!SmartChargingServiceUtils::printProfileFileName(fn, MO_MAX_PATH_SIZE, cId, purpose, iLevel)) {
                     return false;
                 }
 
@@ -436,7 +436,7 @@ bool SmartChargingService::loadProfiles() {
                 auto profileDoc = FilesystemUtils::loadJson(filesystem, fn);
                 if (!profileDoc) {
                     success = false;
-                    MOCPP_DBG_ERR("profile corrupt: %s, remove", fn);
+                    MO_DBG_ERR("profile corrupt: %s, remove", fn);
                     filesystem->remove(fn);
                     continue;
                 }
@@ -450,7 +450,7 @@ bool SmartChargingService::loadProfiles() {
                 }
                 if (!valid) {
                     success = false;
-                    MOCPP_DBG_ERR("profile corrupt: %s, remove", fn);
+                    MO_DBG_ERR("profile corrupt: %s, remove", fn);
                     filesystem->remove(fn);
                 }
             }
@@ -501,12 +501,12 @@ void SmartChargingService::loop(){
 
         calculateLimit(tnow, limit, nextChange);
 
-#if (MOCPP_DBG_LEVEL >= MOCPP_DL_INFO)
+#if (MO_DBG_LEVEL >= MO_DL_INFO)
         char timestamp1[JSONDATE_LENGTH + 1] = {'\0'};
         tnow.toJsonString(timestamp1, JSONDATE_LENGTH + 1);
         char timestamp2[JSONDATE_LENGTH + 1] = {'\0'};
         nextChange.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
-        MOCPP_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = {%f,%f,%i}",
+        MO_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = {%f,%f,%i}",
                             timestamp1, timestamp2,
                             limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
                             limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
@@ -528,13 +528,13 @@ void SmartChargingService::loop(){
 
 void SmartChargingService::setSmartChargingOutput(unsigned int connectorId, std::function<void(float,float,int)> limitOutput) {
     if ((connectorId > 0 && !getScConnectorById(connectorId))) {
-        MOCPP_DBG_ERR("invalid args");
+        MO_DBG_ERR("invalid args");
         return;
     }
 
     if (connectorId == 0) {
         if (this->limitOutput) {
-            MOCPP_DBG_WARN("replacing existing SmartChargingOutput");
+            MO_DBG_WARN("replacing existing SmartChargingOutput");
             (void)0;
         }
         this->limitOutput = limitOutput;
@@ -565,7 +565,7 @@ void SmartChargingService::updateAllowedChargingRateUnit(bool powerSupported, bo
 bool SmartChargingService::setChargingProfile(unsigned int connectorId, std::unique_ptr<ChargingProfile> chargingProfile) {
 
     if ((connectorId > 0 && !getScConnectorById(connectorId)) || !chargingProfile) {
-        MOCPP_DBG_ERR("invalid args");
+        MO_DBG_ERR("invalid args");
         return false;
     }
 
@@ -627,7 +627,7 @@ bool SmartChargingService::clearChargingProfile(std::function<bool(int, int, Cha
 std::unique_ptr<ChargingSchedule> SmartChargingService::getCompositeSchedule(unsigned int connectorId, int duration, ChargingRateUnitType_Optional unit) {
 
     if (connectorId > 0 && !getScConnectorById(connectorId)) {
-        MOCPP_DBG_ERR("invalid args");
+        MO_DBG_ERR("invalid args");
         return nullptr;
     }
     
@@ -694,18 +694,18 @@ bool SmartChargingServiceUtils::printProfileFileName(char *out, size_t bufsize,
 
     switch (purpose) {
         case (ChargingProfilePurposeType::ChargePointMaxProfile):
-            pret = snprintf(out, bufsize, MOCPP_FILENAME_PREFIX "sc-cm-%u.jsn", stackLevel);
+            pret = snprintf(out, bufsize, MO_FILENAME_PREFIX "sc-cm-%u.jsn", stackLevel);
             break;
         case (ChargingProfilePurposeType::TxDefaultProfile):
-            pret = snprintf(out, bufsize, MOCPP_FILENAME_PREFIX "sc-td-%u-%u.jsn", connectorId, stackLevel);
+            pret = snprintf(out, bufsize, MO_FILENAME_PREFIX "sc-td-%u-%u.jsn", connectorId, stackLevel);
             break;
         case (ChargingProfilePurposeType::TxProfile):
-            pret = snprintf(out, bufsize, MOCPP_FILENAME_PREFIX "sc-tx-%u-%u.jsn", connectorId, stackLevel);
+            pret = snprintf(out, bufsize, MO_FILENAME_PREFIX "sc-tx-%u-%u.jsn", connectorId, stackLevel);
             break;
     }
 
     if (pret < 0 || (size_t) pret >= bufsize) {
-        MOCPP_DBG_ERR("fn error: %i", pret);
+        MO_DBG_ERR("fn error: %i", pret);
         return false;
     }
 
@@ -723,9 +723,9 @@ bool SmartChargingServiceUtils::storeProfile(std::shared_ptr<FilesystemAdapter>
         return false;
     }
 
-    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
 
-    if (!printProfileFileName(fn, MOCPP_MAX_PATH_SIZE, connectorId, chargingProfile->getChargingProfilePurpose(), chargingProfile->getStackLevel())) {
+    if (!printProfileFileName(fn, MO_MAX_PATH_SIZE, connectorId, chargingProfile->getChargingProfilePurpose(), chargingProfile->getStackLevel())) {
         return false;
     }
 
@@ -738,9 +738,9 @@ bool SmartChargingServiceUtils::removeProfile(std::shared_ptr<FilesystemAdapter>
         return false;
     }
 
-    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
 
-    if (!printProfileFileName(fn, MOCPP_MAX_PATH_SIZE, connectorId, purpose, stackLevel)) {
+    if (!printProfileFileName(fn, MO_MAX_PATH_SIZE, connectorId, purpose, stackLevel)) {
         return false;
     }
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
index 44089460..b1262ff5 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -107,7 +107,7 @@ bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
     }
 
     if (out.overflowed()) {
-        MOCPP_DBG_ERR("JSON capacity exceeded");
+        MO_DBG_ERR("JSON capacity exceeded");
         return false;
     }
 
@@ -124,7 +124,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
 
     if (sessionState.containsKey("idTag")) {
         if (!tx.setIdTag(sessionState["idTag"] | "")) {
-            MOCPP_DBG_ERR("read err");
+            MO_DBG_ERR("read err");
             return false;
         }
     }
@@ -140,7 +140,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
     if (sessionState.containsKey("timestamp")) {
         Timestamp timestamp;
         if (!timestamp.setTime(sessionState["timestamp"] | "Invalid")) {
-            MOCPP_DBG_ERR("read err");
+            MO_DBG_ERR("read err");
             return false;
         }
         tx.setBeginTimestamp(timestamp);
@@ -167,7 +167,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
     if (txStart.containsKey("timestamp")) {
         Timestamp timestamp;
         if (!timestamp.setTime(txStart["timestamp"] | "Invalid")) {
-            MOCPP_DBG_ERR("read err");
+            MO_DBG_ERR("read err");
             return false;
         }
         tx.setStartTimestamp(timestamp);
@@ -178,7 +178,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
         if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
             tx.setStartBootNr((uint16_t) bootNrIn);
         } else {
-            MOCPP_DBG_ERR("read err");
+            MO_DBG_ERR("read err");
             return false;
         }
     }
@@ -195,7 +195,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
 
     if (txStop.containsKey("idTag")) {
         if (!tx.setStopIdTag(txStop["idTag"] | "")) {
-            MOCPP_DBG_ERR("read err");
+            MO_DBG_ERR("read err");
             return false;
         }
     }
@@ -207,7 +207,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
     if (txStop.containsKey("timestamp")) {
         Timestamp timestamp;
         if (!timestamp.setTime(txStop["timestamp"] | "Invalid")) {
-            MOCPP_DBG_ERR("read err");
+            MO_DBG_ERR("read err");
             return false;
         }
         tx.setStopTimestamp(timestamp);
@@ -218,14 +218,14 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
         if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
             tx.setStopBootNr((uint16_t) bootNrIn);
         } else {
-            MOCPP_DBG_ERR("read err");
+            MO_DBG_ERR("read err");
             return false;
         }
     }
 
     if (txStop.containsKey("reason")) {
         if (!tx.setStopReason(txStop["reason"] | "")) {
-            MOCPP_DBG_ERR("read err");
+            MO_DBG_ERR("read err");
             return false;
         }
     }
@@ -234,12 +234,12 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
         tx.setSilent();
     }
 
-    MOCPP_DBG_DEBUG("DUMP TX");
-    MOCPP_DBG_DEBUG("Session   | idTag %s, active: %i, authorized: %i, deauthorized: %i", tx.getIdTag(), tx.isActive(), tx.isAuthorized(), tx.isIdTagDeauthorized());
-    MOCPP_DBG_DEBUG("Start RPC | req: %i, conf: %i", tx.getStartSync().isRequested(), tx.getStartSync().isConfirmed());
-    MOCPP_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  tx.getStopSync().isRequested(), tx.getStopSync().isConfirmed());
+    MO_DBG_DEBUG("DUMP TX");
+    MO_DBG_DEBUG("Session   | idTag %s, active: %i, authorized: %i, deauthorized: %i", tx.getIdTag(), tx.isActive(), tx.isAuthorized(), tx.isIdTagDeauthorized());
+    MO_DBG_DEBUG("Start RPC | req: %i, conf: %i", tx.getStartSync().isRequested(), tx.getStartSync().isConfirmed());
+    MO_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  tx.getStopSync().isRequested(), tx.getStopSync().isConfirmed());
     if (tx.isSilent()) {
-        MOCPP_DBG_DEBUG("          | silent Tx");
+        MO_DBG_DEBUG("          | silent Tx");
         (void)0;
     }
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
index 7897dc0f..dc5ff934 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
@@ -15,18 +15,18 @@
 
 using namespace MicroOcpp;
 
-#define MOCPP_TXSTORE_META_FN MOCPP_FILENAME_PREFIX "txstore.jsn"
+#define MO_TXSTORE_META_FN MO_FILENAME_PREFIX "txstore.jsn"
 
 ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context, unsigned int connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context),
         connectorId(connectorId),
         filesystem(filesystem) {
 
-    snprintf(txBeginKey, sizeof(txBeginKey), MOCPP_TXSTORE_TXBEGIN_KEY "%u", connectorId);
-    txBeginInt = declareConfiguration<int>(txBeginKey, 0, MOCPP_TXSTORE_META_FN, false, false, false);
+    snprintf(txBeginKey, sizeof(txBeginKey), MO_TXSTORE_TXBEGIN_KEY "%u", connectorId);
+    txBeginInt = declareConfiguration<int>(txBeginKey, 0, MO_TXSTORE_META_FN, false, false, false);
 
-    snprintf(txEndKey, sizeof(txEndKey), MOCPP_TXSTORE_TXEND_KEY "%u", connectorId);
-    txEndInt = declareConfiguration<int>(txEndKey, 0, MOCPP_TXSTORE_META_FN, false, false, false);
+    snprintf(txEndKey, sizeof(txEndKey), MO_TXSTORE_TXEND_KEY "%u", connectorId);
+    txEndInt = declareConfiguration<int>(txEndKey, 0, MO_TXSTORE_META_FN, false, false, false);
 }
 
 ConnectorTransactionStore::~ConnectorTransactionStore() {
@@ -68,34 +68,34 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
     //cache miss - load tx from flash if existent
     
     if (!filesystem) {
-        MOCPP_DBG_DEBUG("no FS adapter");
+        MO_DBG_DEBUG("no FS adapter");
         return nullptr;
     }
 
-    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
-    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-        MOCPP_DBG_ERR("fn error: %i", ret);
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
+    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("fn error: %i", ret);
         return nullptr;
     }
 
     size_t msize;
     if (filesystem->stat(fn, &msize) != 0) {
-        MOCPP_DBG_DEBUG("%u-%u does not exist", connectorId, txNr);
+        MO_DBG_DEBUG("%u-%u does not exist", connectorId, txNr);
         return nullptr;
     }
 
     auto doc = FilesystemUtils::loadJson(filesystem, fn);
 
     if (!doc) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return nullptr;
     }
 
     auto transaction = std::make_shared<Transaction>(*this, connectorId, txNr);
     JsonObject txJson = doc->as<JsonObject>();
     if (!deserializeTransaction(*transaction, txJson)) {
-        MOCPP_DBG_ERR("deserialization error");
+        MO_DBG_ERR("deserialization error");
         return nullptr;
     }
 
@@ -113,12 +113,12 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
 std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool silent) {
     
     if (!txBeginInt || txBeginInt->getInt() < 0 || !txEndInt || txEndInt->getInt() < 0) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return nullptr;
     }
 
     //check if maximum number of queued tx already reached
-    if ((txEndInt->getInt() + MAX_TX_CNT - txBeginInt->getInt()) % MAX_TX_CNT >= MOCPP_TXRECORD_SIZE) {
+    if ((txEndInt->getInt() + MAX_TX_CNT - txBeginInt->getInt()) % MAX_TX_CNT >= MO_TXRECORD_SIZE) {
         //limit reached
 
         if (!silent) {
@@ -134,7 +134,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool s
     configuration_save();
 
     if (!commit(transaction.get())) {
-        MOCPP_DBG_ERR("FS error");
+        MO_DBG_ERR("FS error");
         return nullptr;
     }
 
@@ -151,7 +151,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool s
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::getLatestTransaction() {
     if (!txEndInt || txEndInt->getInt() < 0) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return nullptr;
     }
 
@@ -163,25 +163,25 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getLatestTransaction() {
 bool ConnectorTransactionStore::commit(Transaction *transaction) {
 
     if (!filesystem) {
-        MOCPP_DBG_DEBUG("no FS: nothing to commit");
+        MO_DBG_DEBUG("no FS: nothing to commit");
         return true;
     }
 
-    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
-    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-        MOCPP_DBG_ERR("fn error: %i", ret);
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
+    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("fn error: %i", ret);
         return false;
     }
     
     DynamicJsonDocument txDoc {0};
     if (!serializeTransaction(*transaction, txDoc)) {
-        MOCPP_DBG_ERR("Serialization error");
+        MO_DBG_ERR("Serialization error");
         return false;
     }
 
     if (!FilesystemUtils::storeJson(filesystem, fn, txDoc)) {
-        MOCPP_DBG_ERR("FS error");
+        MO_DBG_ERR("FS error");
         return false;
     }
 
@@ -192,31 +192,31 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
 bool ConnectorTransactionStore::remove(unsigned int txNr) {
 
     if (!filesystem) {
-        MOCPP_DBG_DEBUG("no FS: nothing to remove");
+        MO_DBG_DEBUG("no FS: nothing to remove");
         return true;
     }
 
-    char fn [MOCPP_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MOCPP_MAX_PATH_SIZE, MOCPP_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
-    if (ret < 0 || ret >= MOCPP_MAX_PATH_SIZE) {
-        MOCPP_DBG_ERR("fn error: %i", ret);
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
+    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("fn error: %i", ret);
         return false;
     }
 
     size_t msize;
     if (filesystem->stat(fn, &msize) != 0) {
-        MOCPP_DBG_DEBUG("%s already removed", fn);
+        MO_DBG_DEBUG("%s already removed", fn);
         return true;
     }
 
-    MOCPP_DBG_DEBUG("remove %s", fn);
+    MO_DBG_DEBUG("remove %s", fn);
     
     return filesystem->remove(fn);
 }
 
 int ConnectorTransactionStore::getTxBegin() {
     if (!txBeginInt || txBeginInt->getInt() < 0) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return -1;
     }
 
@@ -225,7 +225,7 @@ int ConnectorTransactionStore::getTxBegin() {
 
 int ConnectorTransactionStore::getTxEnd() {
     if (!txEndInt || txEndInt->getInt() < 0) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return -1;
     }
 
@@ -234,7 +234,7 @@ int ConnectorTransactionStore::getTxEnd() {
 
 void ConnectorTransactionStore::setTxBegin(unsigned int txNr) {
     if (!txBeginInt || txBeginInt->getInt() < 0) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return;
     }
 
@@ -244,7 +244,7 @@ void ConnectorTransactionStore::setTxBegin(unsigned int txNr) {
 
 void ConnectorTransactionStore::setTxEnd(unsigned int txNr) {
     if (!txBeginInt || txBeginInt->getInt() < 0 || !txEndInt || txEndInt->getInt() < 0) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return;
     }
 
@@ -254,7 +254,7 @@ void ConnectorTransactionStore::setTxEnd(unsigned int txNr) {
 
 unsigned int ConnectorTransactionStore::size() {
     if (!txBeginInt || txBeginInt->getInt() < 0 || !txEndInt || txEndInt->getInt() < 0) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return 0;
     }
 
@@ -268,12 +268,12 @@ TransactionStore::TransactionStore(unsigned int nConnectors, std::shared_ptr<Fil
             new ConnectorTransactionStore(*this, i, filesystem)));
     }
 
-    configuration_load(MOCPP_TXSTORE_META_FN);
+    configuration_load(MO_TXSTORE_META_FN);
 }
 
 std::shared_ptr<Transaction> TransactionStore::getLatestTransaction(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid connectorId");
+        MO_DBG_ERR("Invalid connectorId");
         return nullptr;
     }
     return connectors[connectorId]->getLatestTransaction();
@@ -281,12 +281,12 @@ std::shared_ptr<Transaction> TransactionStore::getLatestTransaction(unsigned int
 
 bool TransactionStore::commit(Transaction *transaction) {
     if (!transaction) {
-        MOCPP_DBG_ERR("Invalid arg");
+        MO_DBG_ERR("Invalid arg");
         return false;
     }
     auto connectorId = transaction->getConnectorId();
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid tx");
+        MO_DBG_ERR("Invalid tx");
         return false;
     }
     return connectors[connectorId]->commit(transaction);
@@ -294,7 +294,7 @@ bool TransactionStore::commit(Transaction *transaction) {
 
 std::shared_ptr<Transaction> TransactionStore::getTransaction(unsigned int connectorId, unsigned int txNr) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid connectorId");
+        MO_DBG_ERR("Invalid connectorId");
         return nullptr;
     }
     return connectors[connectorId]->getTransaction(txNr);
@@ -302,7 +302,7 @@ std::shared_ptr<Transaction> TransactionStore::getTransaction(unsigned int conne
 
 std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int connectorId, bool silent) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid connectorId");
+        MO_DBG_ERR("Invalid connectorId");
         return nullptr;
     }
     return connectors[connectorId]->createTransaction(silent);
@@ -310,7 +310,7 @@ std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int co
 
 bool TransactionStore::remove(unsigned int connectorId, unsigned int txNr) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid connectorId");
+        MO_DBG_ERR("Invalid connectorId");
         return false;
     }
     return connectors[connectorId]->remove(txNr);
@@ -318,7 +318,7 @@ bool TransactionStore::remove(unsigned int connectorId, unsigned int txNr) {
 
 int TransactionStore::getTxBegin(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid connectorId");
+        MO_DBG_ERR("Invalid connectorId");
         return -1;
     }
     return connectors[connectorId]->getTxBegin();
@@ -326,7 +326,7 @@ int TransactionStore::getTxBegin(unsigned int connectorId) {
 
 int TransactionStore::getTxEnd(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid connectorId");
+        MO_DBG_ERR("Invalid connectorId");
         return -1;
     }
     return connectors[connectorId]->getTxEnd();
@@ -334,7 +334,7 @@ int TransactionStore::getTxEnd(unsigned int connectorId) {
 
 void TransactionStore::setTxBegin(unsigned int connectorId, unsigned int txNr) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid connectorId");
+        MO_DBG_ERR("Invalid connectorId");
         return;
     }
     return connectors[connectorId]->setTxBegin(txNr);
@@ -342,7 +342,7 @@ void TransactionStore::setTxBegin(unsigned int connectorId, unsigned int txNr) {
 
 void TransactionStore::setTxEnd(unsigned int connectorId, unsigned int txNr) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid connectorId");
+        MO_DBG_ERR("Invalid connectorId");
         return;
     }
     return connectors[connectorId]->setTxEnd(txNr);
@@ -350,7 +350,7 @@ void TransactionStore::setTxEnd(unsigned int connectorId, unsigned int txNr) {
 
 unsigned int TransactionStore::size(unsigned int connectorId) {
     if (connectorId >= connectors.size()) {
-        MOCPP_DBG_ERR("Invalid connectorId");
+        MO_DBG_ERR("Invalid connectorId");
         return 0;
     }
     return connectors[connectorId]->size();
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.h b/src/MicroOcpp/Model/Transactions/TransactionStore.h
index 5933142a..c643bd6b 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.h
@@ -12,12 +12,12 @@
 
 #define MAX_TX_CNT 100000U
 
-#ifndef MOCPP_TXRECORD_SIZE
-#define MOCPP_TXRECORD_SIZE 4 //no. of tx to hold on flash storage
+#ifndef MO_TXRECORD_SIZE
+#define MO_TXRECORD_SIZE 4 //no. of tx to hold on flash storage
 #endif
 
-#define MOCPP_TXSTORE_TXBEGIN_KEY "txBegin_"
-#define MOCPP_TXSTORE_TXEND_KEY "txEnd_"
+#define MO_TXSTORE_TXBEGIN_KEY "txBegin_"
+#define MO_TXSTORE_TXEND_KEY "txEnd_"
 
 namespace MicroOcpp {
 
@@ -30,10 +30,10 @@ class ConnectorTransactionStore {
 
     std::shared_ptr<FilesystemAdapter> filesystem;
     std::shared_ptr<Configuration> txBeginInt; //if txNr < txBegin, tx has been safely deleted
-    char txBeginKey [sizeof(MOCPP_TXSTORE_TXBEGIN_KEY "xxx") + 1]; //"xxx": placeholder for connectorId
+    char txBeginKey [sizeof(MO_TXSTORE_TXBEGIN_KEY "xxx") + 1]; //"xxx": placeholder for connectorId
 
     std::shared_ptr<Configuration> txEndInt;
-    char txEndKey [sizeof(MOCPP_TXSTORE_TXEND_KEY "xxx") + 1];
+    char txEndKey [sizeof(MO_TXSTORE_TXEND_KEY "xxx") + 1];
     
     std::deque<std::weak_ptr<Transaction>> transactions;
 
diff --git a/src/MicroOcpp/Operations/Authorize.cpp b/src/MicroOcpp/Operations/Authorize.cpp
index b367c81e..3528f04c 100644
--- a/src/MicroOcpp/Operations/Authorize.cpp
+++ b/src/MicroOcpp/Operations/Authorize.cpp
@@ -14,7 +14,7 @@ Authorize::Authorize(Model& model, const char *idTagIn) : model(model) {
     if (idTagIn && strnlen(idTagIn, IDTAG_LEN_MAX + 2) <= IDTAG_LEN_MAX) {
         snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
     } else {
-        MOCPP_DBG_WARN("Format violation of idTag. Discard idTag");
+        MO_DBG_WARN("Format violation of idTag. Discard idTag");
         (void)0;
     }
 }
@@ -34,9 +34,9 @@ void Authorize::processConf(JsonObject payload){
     const char *idTagInfo = payload["idTagInfo"]["status"] | "not specified";
 
     if (!strcmp(idTagInfo, "Accepted")) {
-        MOCPP_DBG_INFO("Request has been accepted");
+        MO_DBG_INFO("Request has been accepted");
     } else {
-        MOCPP_DBG_INFO("Request has been denied. Reason: %s", idTagInfo);
+        MO_DBG_INFO("Request has been denied. Reason: %s", idTagInfo);
     }
 
     if (model.getAuthorizationService()) {
diff --git a/src/MicroOcpp/Operations/BootNotification.cpp b/src/MicroOcpp/Operations/BootNotification.cpp
index 68298b1f..f59c1bfe 100644
--- a/src/MicroOcpp/Operations/BootNotification.cpp
+++ b/src/MicroOcpp/Operations/BootNotification.cpp
@@ -24,7 +24,7 @@ std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
     if (credentials) {
         return std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(*credentials));
     } else {
-        MOCPP_DBG_ERR("payload undefined");
+        MO_DBG_ERR("payload undefined");
         return createEmptyDocument();
     }
 }
@@ -35,12 +35,12 @@ void BootNotification::processConf(JsonObject payload) {
         if (model.getClock().setTime(currentTime)) {
             //success
         } else {
-            MOCPP_DBG_ERR("Time string format violation. Expect format like 2022-02-01T20:53:32.486Z");
+            MO_DBG_ERR("Time string format violation. Expect format like 2022-02-01T20:53:32.486Z");
             errorCode = "PropertyConstraintViolation";
             return;
         }
     } else {
-        MOCPP_DBG_ERR("Missing attribute currentTime");
+        MO_DBG_ERR("Missing attribute currentTime");
         errorCode = "FormationViolation";
         return;
     }
@@ -78,7 +78,7 @@ void BootNotification::processConf(JsonObject payload) {
         bootService->notifyRegistrationStatus(status);
     }
 
-    MOCPP_DBG_INFO("request has been %s", status == RegistrationStatus::Accepted ? "Accepted" :
+    MO_DBG_INFO("request has been %s", status == RegistrationStatus::Accepted ? "Accepted" :
                                        status == RegistrationStatus::Pending ? "replied with Pending" :
                                        "Rejected");
 }
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
index c789ccee..16f0b029 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
@@ -23,13 +23,13 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     const char *key = payload["key"] | "";
     if (!*key) {
         errorCode = "FormationViolation";
-        MOCPP_DBG_WARN("Could not read key");
+        MO_DBG_WARN("Could not read key");
         return;
     }
 
     if (!payload["value"].is<const char *>()) {
         errorCode = "FormationViolation";
-        MOCPP_DBG_WARN("Message is lacking value");
+        MO_DBG_WARN("Message is lacking value");
         return;
     }
 
@@ -44,7 +44,7 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     }
 
     if (configuration->isReadOnly()) {
-        MOCPP_DBG_WARN("Trying to override readonly value");
+        MO_DBG_WARN("Trying to override readonly value");
         readOnly = true;
         return;
     }
@@ -107,7 +107,7 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     }
 
     if (nDigits > INT_MAXDIGITS) {
-        MOCPP_DBG_DEBUG("Possible integer overflow: key = %s, value = %s", key, value);
+        MO_DBG_DEBUG("Possible integer overflow: key = %s, value = %s", key, value);
         convertibleInt = false;
     }
 
@@ -131,7 +131,7 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     if (validator && !(*validator)(value)) {
         //validator exists and validation fails
         reject = true;
-        MOCPP_DBG_WARN("validation failed for key=%s value=%s", key, value);
+        MO_DBG_WARN("validation failed for key=%s value=%s", key, value);
         return;
     }
 
@@ -145,12 +145,12 @@ void ChangeConfiguration::processReq(JsonObject payload) {
         configuration->setString(value);
     } else {
         reject = true;
-        MOCPP_DBG_WARN("Value has incompatible type");
+        MO_DBG_WARN("Value has incompatible type");
         return;
     }
 
     if (!configuration_save()) {
-        MOCPP_DBG_ERR("could not write changes to flash");
+        MO_DBG_ERR("could not write changes to flash");
         errorCode = "InternalError";
         return;
     }
diff --git a/src/MicroOcpp/Operations/ClearCache.cpp b/src/MicroOcpp/Operations/ClearCache.cpp
index 10f0b0e6..d6afc1b8 100644
--- a/src/MicroOcpp/Operations/ClearCache.cpp
+++ b/src/MicroOcpp/Operations/ClearCache.cpp
@@ -17,7 +17,7 @@ const char* ClearCache::getOperationType(){
 }
 
 void ClearCache::processReq(JsonObject payload) {
-    MOCPP_DBG_WARN("Clear transaction log (Authorization Cache not supported)");
+    MO_DBG_WARN("Clear transaction log (Authorization Cache not supported)");
 
     if (!filesystem) {
         //no persistency - nothing to do
diff --git a/src/MicroOcpp/Operations/CustomOperation.h b/src/MicroOcpp/Operations/CustomOperation.h
index 81d5b3ef..4fe07dcf 100644
--- a/src/MicroOcpp/Operations/CustomOperation.h
+++ b/src/MicroOcpp/Operations/CustomOperation.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_CUSTOMOPERATION_H
-#define MOCPP_CUSTOMOPERATION_H
+#ifndef MO_CUSTOMOPERATION_H
+#define MO_CUSTOMOPERATION_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/DataTransfer.cpp b/src/MicroOcpp/Operations/DataTransfer.cpp
index 5dd0bfd7..a7f4af1c 100644
--- a/src/MicroOcpp/Operations/DataTransfer.cpp
+++ b/src/MicroOcpp/Operations/DataTransfer.cpp
@@ -27,8 +27,8 @@ void DataTransfer::processConf(JsonObject payload){
     std::string status = payload["status"] | "Invalid";
 
     if (status == "Accepted") {
-        MOCPP_DBG_DEBUG("Request has been accepted");
+        MO_DBG_DEBUG("Request has been accepted");
     } else {
-        MOCPP_DBG_INFO("Request has been denied");
+        MO_DBG_INFO("Request has been denied");
     }
 }
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index 67b27d30..a8b3804c 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -36,7 +36,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
         for (auto container : containers) {
             for (size_t i = 0; i < container->size(); i++) {
                 if (!container->getConfiguration(i)->getKey()) {
-                    MOCPP_DBG_ERR("invalid config");
+                    MO_DBG_ERR("invalid config");
                     continue;
                 }
                 configurations.push_back(container->getConfiguration(i));
@@ -80,16 +80,16 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
 
     jcapacity += JSON_ARRAY_SIZE(unknownKeys.size());
     
-    MOCPP_DBG_DEBUG("GetConfiguration capacity: %zu", jcapacity);
+    MO_DBG_DEBUG("GetConfiguration capacity: %zu", jcapacity);
 
     std::unique_ptr<DynamicJsonDocument> doc;
 
-    if (jcapacity <= MOCPP_MAX_JSON_CAPACITY) {
+    if (jcapacity <= MO_MAX_JSON_CAPACITY) {
         doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(jcapacity));
     }
 
     if (!doc || doc->capacity() < jcapacity) {
-        if (doc) {MOCPP_DBG_ERR("OOM");(void)0;}
+        if (doc) {MO_DBG_ERR("OOM");(void)0;}
 
         errorCode = "InternalError";
         errorDescription = "Query too big. Try fewer keys";
@@ -106,7 +106,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
             case TConfig::Int: {
                 auto ret = snprintf(vbuf, VALUE_BUFSIZE, "%i", config->getInt());
                 if (ret < 0 || ret >= VALUE_BUFSIZE) {
-                    MOCPP_DBG_ERR("value error");
+                    MO_DBG_ERR("value error");
                     continue;
                 }
                 v = vbuf;
@@ -135,7 +135,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
     if (!unknownKeys.empty()) {
         JsonArray jsonUnknownKey = payload.createNestedArray("unknownKey");
         for (auto key : unknownKeys) {
-            MOCPP_DBG_DEBUG("Unknown key: %s", key)
+            MO_DBG_DEBUG("Unknown key: %s", key)
             jsonUnknownKey.add(key);
         }
     }
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.cpp b/src/MicroOcpp/Operations/GetDiagnostics.cpp
index 6e6d4fe2..93a76d83 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.cpp
+++ b/src/MicroOcpp/Operations/GetDiagnostics.cpp
@@ -33,7 +33,7 @@ void GetDiagnostics::processReq(JsonObject payload) {
     if (payload.containsKey("startTime")) {
         if (!startTime.setTime(payload["startTime"] | "Invalid")) {
             errorCode = "PropertyConstraintViolation";
-            MOCPP_DBG_WARN("bad time format");
+            MO_DBG_WARN("bad time format");
             return;
         }
     }
@@ -42,7 +42,7 @@ void GetDiagnostics::processReq(JsonObject payload) {
     if (payload.containsKey("startTime")) {
         if (!stopTime.setTime(payload["stopTime"] | "Invalid")) {
             errorCode = "PropertyConstraintViolation";
-            MOCPP_DBG_WARN("bad time format");
+            MO_DBG_WARN("bad time format");
             return;
         }
     }
diff --git a/src/MicroOcpp/Operations/Heartbeat.cpp b/src/MicroOcpp/Operations/Heartbeat.cpp
index 21f187b0..7d358a6d 100644
--- a/src/MicroOcpp/Operations/Heartbeat.cpp
+++ b/src/MicroOcpp/Operations/Heartbeat.cpp
@@ -27,12 +27,12 @@ void Heartbeat::processConf(JsonObject payload) {
     if (strcmp(currentTime, "Invalid")) {
         if (model.getClock().setTime(currentTime)) {
             //success
-            MOCPP_DBG_DEBUG("Request has been accepted");
+            MO_DBG_DEBUG("Request has been accepted");
         } else {
-            MOCPP_DBG_WARN("Could not read time string. Expect format like 2020-02-01T20:53:32.486Z");
+            MO_DBG_WARN("Could not read time string. Expect format like 2020-02-01T20:53:32.486Z");
         }
     } else {
-        MOCPP_DBG_WARN("Missing field currentTime. Expect format like 2020-02-01T20:53:32.486Z");
+        MO_DBG_WARN("Missing field currentTime. Expect format like 2020-02-01T20:53:32.486Z");
     }
 }
 
diff --git a/src/MicroOcpp/Operations/MeterValues.cpp b/src/MicroOcpp/Operations/MeterValues.cpp
index 8133ff2a..4e44dfad 100644
--- a/src/MicroOcpp/Operations/MeterValues.cpp
+++ b/src/MicroOcpp/Operations/MeterValues.cpp
@@ -41,7 +41,7 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
             capacity += entry->capacity();
             entries.push_back(std::move(entry));
         } else {
-            MOCPP_DBG_ERR("Energy meter reading not convertible to JSON");
+            MO_DBG_ERR("Energy meter reading not convertible to JSON");
             (void)0;
         }
     }
@@ -66,7 +66,7 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
 }
 
 void MeterValues::processConf(JsonObject payload) {
-    MOCPP_DBG_DEBUG("Request has been confirmed");
+    MO_DBG_DEBUG("Request has been confirmed");
 }
 
 
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
index 5c6d9d06..4e06486e 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
@@ -39,7 +39,7 @@ void RemoteStartTransaction::processReq(JsonObject payload) {
     std::unique_ptr<ChargingProfile> chargingProfile;
 
     if (payload.containsKey("chargingProfile") && model.getSmartChargingService()) {
-        MOCPP_DBG_INFO("Setting Charging profile via RemoteStartTransaction");
+        MO_DBG_INFO("Setting Charging profile via RemoteStartTransaction");
 
         JsonObject chargingProfileJson = payload["chargingProfile"];
         chargingProfile = loadChargingProfile(chargingProfileJson);
@@ -110,7 +110,7 @@ void RemoteStartTransaction::processReq(JsonObject payload) {
 
         accepted = success;
     } else {
-        MOCPP_DBG_INFO("No connector to start transaction");
+        MO_DBG_INFO("No connector to start transaction");
         accepted = false;
     }
 }
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index 9b256b3f..6dab67ae 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -41,7 +41,7 @@ void ReserveNow::processReq(JsonObject payload) {
 
     Timestamp expiryDate;
     if (!expiryDate.setTime(payload["expiryDate"])) {
-        MOCPP_DBG_WARN("bad time format");
+        MO_DBG_WARN("bad time format");
         errorCode = "PropertyConstraintViolation";
         return;
     }
@@ -116,7 +116,7 @@ std::unique_ptr<DynamicJsonDocument> ReserveNow::createConf(){
     if (reservationStatus) {
         payload["status"] = reservationStatus;
     } else {
-        MOCPP_DBG_ERR("didn't set reservationStatus");
+        MO_DBG_ERR("didn't set reservationStatus");
         payload["status"] = "Rejected";
     }
     
diff --git a/src/MicroOcpp/Operations/Reset.cpp b/src/MicroOcpp/Operations/Reset.cpp
index 208c7d1b..9a799739 100644
--- a/src/MicroOcpp/Operations/Reset.cpp
+++ b/src/MicroOcpp/Operations/Reset.cpp
@@ -25,7 +25,7 @@ void Reset::processReq(JsonObject payload) {
 
     if (auto rService = model.getResetService()) {
         if (!rService->getExecuteReset()) {
-            MOCPP_DBG_ERR("No reset handler set. Abort operation");
+            MO_DBG_ERR("No reset handler set. Abort operation");
             (void)0;
             //resetAccepted remains false
         } else {
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 7ef232ec..70895af5 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -33,7 +33,7 @@ void SendLocalList::processReq(JsonObject payload) {
 
     JsonArray localAuthorizationList = payload["localAuthorizationList"];
 
-    if (localAuthorizationList.size() > MOCPP_SendLocalListMaxLength) {
+    if (localAuthorizationList.size() > MO_SendLocalListMaxLength) {
         errorCode = "OccurenceConstraintViolation";
         return;
     }
diff --git a/src/MicroOcpp/Operations/StartTransaction.cpp b/src/MicroOcpp/Operations/StartTransaction.cpp
index 486b3210..80ecb961 100644
--- a/src/MicroOcpp/Operations/StartTransaction.cpp
+++ b/src/MicroOcpp/Operations/StartTransaction.cpp
@@ -28,7 +28,7 @@ const char* StartTransaction::getOperationType() {
 
 void StartTransaction::initiate(StoredOperationHandler *opStore) {
     if (!transaction || transaction->getStartSync().isRequested()) {
-        MOCPP_DBG_ERR("initialization error");
+        MO_DBG_ERR("initialization error");
         return;
     }
     
@@ -45,38 +45,38 @@ void StartTransaction::initiate(StoredOperationHandler *opStore) {
 
     transaction->commit();
 
-    MOCPP_DBG_INFO("StartTransaction initiated");
+    MO_DBG_INFO("StartTransaction initiated");
 }
 
 bool StartTransaction::restore(StoredOperationHandler *opStore) {
     if (!opStore) {
-        MOCPP_DBG_ERR("invalid argument");
+        MO_DBG_ERR("invalid argument");
         return false;
     }
 
     auto payload = opStore->getPayload();
     if (!payload) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return false;
     }
 
     int connectorId = (*payload)["connectorId"] | -1;
     int txNr = (*payload)["txNr"] | -1;
     if (connectorId < 0 || txNr < 0) {
-        MOCPP_DBG_ERR("record incomplete");
+        MO_DBG_ERR("record incomplete");
         return false;
     }
 
     auto txStore = model.getTransactionStore();
 
     if (!txStore) {
-        MOCPP_DBG_ERR("invalid state");
+        MO_DBG_ERR("invalid state");
         return false;
     }
 
     transaction = txStore->getTransaction(connectorId, txNr);
     if (!transaction) {
-        MOCPP_DBG_ERR("referential integrity violation");
+        MO_DBG_ERR("referential integrity violation");
 
         //clean up possible tx records
         if (auto mSerivce = model.getMeteringService()) {
@@ -88,7 +88,7 @@ bool StartTransaction::restore(StoredOperationHandler *opStore) {
     if (transaction->getStartTimestamp() < MIN_TIME &&
             transaction->getStartBootNr() != model.getBootNr()) {
         //time not set, cannot be restored anymore -> invalid tx
-        MOCPP_DBG_ERR("cannot recover tx from previus run");
+        MO_DBG_ERR("cannot recover tx from previus run");
 
         //clean up possible tx records
         if (auto mSerivce = model.getMeteringService()) {
@@ -123,7 +123,7 @@ std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
 
     if (transaction->getStartTimestamp() < MIN_TIME &&
             transaction->getStartBootNr() == model.getBootNr()) {
-        MOCPP_DBG_DEBUG("adjust preboot StartTx timestamp");
+        MO_DBG_DEBUG("adjust preboot StartTx timestamp");
         Timestamp adjusted = model.getClock().adjustPrebootTimestamp(transaction->getStartTimestamp());
         transaction->setStartTimestamp(adjusted);
     }
@@ -139,9 +139,9 @@ void StartTransaction::processConf(JsonObject payload) {
 
     const char* idTagInfoStatus = payload["idTagInfo"]["status"] | "not specified";
     if (!strcmp(idTagInfoStatus, "Accepted")) {
-        MOCPP_DBG_INFO("Request has been accepted");
+        MO_DBG_INFO("Request has been accepted");
     } else {
-        MOCPP_DBG_INFO("Request has been denied. Reason: %s", idTagInfoStatus);
+        MO_DBG_INFO("Request has been denied. Reason: %s", idTagInfoStatus);
         transaction->setIdTagDeauthorized();
     }
 
diff --git a/src/MicroOcpp/Operations/StatusNotification.cpp b/src/MicroOcpp/Operations/StatusNotification.cpp
index e354700c..4820ba8d 100644
--- a/src/MicroOcpp/Operations/StatusNotification.cpp
+++ b/src/MicroOcpp/Operations/StatusNotification.cpp
@@ -34,7 +34,7 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
         case (ChargePointStatus::Faulted):
             return "Faulted";
         default:
-            MOCPP_DBG_ERR("ChargePointStatus not specified");
+            MO_DBG_ERR("ChargePointStatus not specified");
             (void)0;
             /* fall through */
         case (ChargePointStatus::NOT_SET):
@@ -46,7 +46,7 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
 StatusNotification::StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData)
         : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorData(errorData) {
     
-    MOCPP_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
+    MO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
 }
 
 const char* StatusNotification::getOperationType(){
@@ -73,7 +73,7 @@ std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
             payload["vendorErrorCode"] = errorData.vendorErrorCode;
         }
     } else if (currentStatus == ChargePointStatus::NOT_SET) {
-        MOCPP_DBG_ERR("Reporting undefined status");
+        MO_DBG_ERR("Reporting undefined status");
         payload["errorCode"] = "InternalError";
     } else {
         payload["errorCode"] = "NoError";
diff --git a/src/MicroOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
index c8c83df9..4eec404a 100644
--- a/src/MicroOcpp/Operations/StopTransaction.cpp
+++ b/src/MicroOcpp/Operations/StopTransaction.cpp
@@ -30,7 +30,7 @@ const char* StopTransaction::getOperationType() {
 
 void StopTransaction::initiate(StoredOperationHandler *opStore) {
     if (!transaction || transaction->getStopSync().isRequested()) {
-        MOCPP_DBG_ERR("initialization error");
+        MO_DBG_ERR("initialization error");
         return;
     }
     
@@ -47,38 +47,38 @@ void StopTransaction::initiate(StoredOperationHandler *opStore) {
 
     transaction->commit();
 
-    MOCPP_DBG_INFO("StopTransaction initiated");
+    MO_DBG_INFO("StopTransaction initiated");
 }
 
 bool StopTransaction::restore(StoredOperationHandler *opStore) {
     if (!opStore) {
-        MOCPP_DBG_ERR("invalid argument");
+        MO_DBG_ERR("invalid argument");
         return false;
     }
 
     auto payload = opStore->getPayload();
     if (!payload) {
-        MOCPP_DBG_ERR("memory corruption");
+        MO_DBG_ERR("memory corruption");
         return false;
     }
 
     int connectorId = (*payload)["connectorId"] | -1;
     int txNr = (*payload)["txNr"] | -1;
     if (connectorId < 0 || txNr < 0) {
-        MOCPP_DBG_ERR("record incomplete");
+        MO_DBG_ERR("record incomplete");
         return false;
     }
 
     auto txStore = model.getTransactionStore();
 
     if (!txStore) {
-        MOCPP_DBG_ERR("invalid state");
+        MO_DBG_ERR("invalid state");
         return false;
     }
 
     transaction = txStore->getTransaction(connectorId, txNr);
     if (!transaction) {
-        MOCPP_DBG_ERR("referential integrity violation");
+        MO_DBG_ERR("referential integrity violation");
 
         //clean up possible tx records
         if (auto mSerivce = model.getMeteringService()) {
@@ -89,7 +89,7 @@ bool StopTransaction::restore(StoredOperationHandler *opStore) {
 
     if (transaction->isSilent()) {
         //transaction has been set silent after initializing StopTx - discard operation record
-        MOCPP_DBG_WARN("tx has been set silent - discard StopTx");
+        MO_DBG_WARN("tx has been set silent - discard StopTx");
 
         //clean up possible tx records
         if (auto mSerivce = model.getMeteringService()) {
@@ -119,10 +119,10 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
             Timestamp adjusted = model.getClock().adjustPrebootTimestamp(transaction->getStopTimestamp());
             transaction->setStopTimestamp(adjusted);
         } else if (transaction->getStartTimestamp() >= MIN_TIME) {
-            MOCPP_DBG_WARN("set stopTime = startTime because correct time is not available");
+            MO_DBG_WARN("set stopTime = startTime because correct time is not available");
             transaction->setStopTimestamp(transaction->getStartTimestamp() + 1); //1s behind startTime to keep order in backend DB
         } else {
-            MOCPP_DBG_ERR("failed to determine StopTx timestamp");
+            MO_DBG_ERR("failed to determine StopTx timestamp");
             (void)0; //send invalid value
         }
     }
@@ -194,7 +194,7 @@ void StopTransaction::processConf(JsonObject payload) {
         transaction->commit();
     }
 
-    MOCPP_DBG_INFO("Request has been accepted!");
+    MO_DBG_INFO("Request has been accepted!");
 
     if (auto authService = model.getAuthorizationService()) {
         authService->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
@@ -208,7 +208,7 @@ bool StopTransaction::processErr(const char *code, const char *description, Json
         transaction->commit();
     }
 
-    MOCPP_DBG_ERR("Server error, data loss!");
+    MO_DBG_ERR("Server error, data loss!");
 
     return false;
 }
diff --git a/src/MicroOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
index 7f0965e5..7e47a64f 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.cpp
+++ b/src/MicroOcpp/Operations/TriggerMessage.cpp
@@ -26,7 +26,7 @@ void TriggerMessage::processReq(JsonObject payload) {
     const char *requestedMessage = payload["requestedMessage"] | "Invalid";
     const int connectorId = payload["connectorId"] | -1;
 
-    MOCPP_DBG_INFO("Execute for message type %s, connectorId = %i", requestedMessage, connectorId);
+    MO_DBG_INFO("Execute for message type %s, connectorId = %i", requestedMessage, connectorId);
 
     statusMessage = "Rejected";
 
diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index eb7b002f..a46acf15 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -8,7 +8,7 @@
 
 using MicroOcpp::Ocpp16::UnlockConnector;
 
-#define MOCPP_UNLOCK_TIMEOUT 10000
+#define MO_UNLOCK_TIMEOUT 10000
 
 UnlockConnector::UnlockConnector(Model& model) : model(model) {
   
@@ -36,14 +36,14 @@ void UnlockConnector::processReq(JsonObject payload) {
     if (unlockConnector != nullptr) {
         cbUnlockResult = unlockConnector();
     } else {
-        MOCPP_DBG_WARN("Unlock CB undefined");
+        MO_DBG_WARN("Unlock CB undefined");
     }
 
     timerStart = mocpp_tick_ms();
 }
 
 std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
-    if (!err && mocpp_tick_ms() - timerStart < MOCPP_UNLOCK_TIMEOUT) {
+    if (!err && mocpp_tick_ms() - timerStart < MO_UNLOCK_TIMEOUT) {
         //do poll and if more time is needed, delay creation of conf msg
 
         if (unlockConnector) {
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.cpp b/src/MicroOcpp/Operations/UpdateFirmware.cpp
index b6300573..8664ffe0 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.cpp
+++ b/src/MicroOcpp/Operations/UpdateFirmware.cpp
@@ -38,7 +38,7 @@ void UpdateFirmware::processReq(JsonObject payload) {
     Timestamp retrieveDate;
     if (!retrieveDate.setTime(payload["retrieveDate"] | "Invalid")) {
         errorCode = "PropertyConstraintViolation";
-        MOCPP_DBG_WARN("bad time format");
+        MO_DBG_WARN("bad time format");
         return;
     }
     
diff --git a/src/MicroOcpp/Platform.cpp b/src/MicroOcpp/Platform.cpp
index fa167aad..daefcd72 100644
--- a/src/MicroOcpp/Platform.cpp
+++ b/src/MicroOcpp/Platform.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp/Platform.h>
 
-#ifdef MOCPP_CUSTOM_CONSOLE
+#ifdef MO_CUSTOM_CONSOLE
 
 namespace MicroOcpp {
 void (*mocpp_console_out_impl)(const char *msg) = nullptr;
@@ -23,7 +23,7 @@ void mo_set_console_out(void (*console_out)(const char *msg)) {
 
 #endif
 
-#ifdef MOCPP_CUSTOM_TIMER
+#ifdef MO_CUSTOM_TIMER
 unsigned long (*mocpp_tick_ms_impl)() = nullptr;
 
 void mocpp_set_timer(unsigned long (*get_ms)()) {
@@ -39,7 +39,7 @@ unsigned long mocpp_tick_ms_custom() {
 }
 #endif
 
-#if MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
+#if MO_PLATFORM == MO_PLATFORM_UNIX
 #include <chrono>
 
 namespace MicroOcpp {
@@ -60,7 +60,7 @@ unsigned long mocpp_tick_ms_unix() {
 }
 #endif
 
-#if MOCPP_PLATFORM != MOCPP_PLATFORM_ARDUINO
+#if MO_PLATFORM != MO_PLATFORM_ARDUINO
 void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target){
     char fmt[20];
     sprintf(fmt, "%%%d.%df", min_width, num_digits_after_decimal);
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index 926336c5..f1435659 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -2,8 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
-#ifndef MOCPP_PLATFORM_H
-#define MOCPP_PLATFORM_H
+#ifndef MO_PLATFORM_H
+#define MO_PLATFORM_H
 
 #ifdef __cplusplus
 #define EXT_C extern "C"
@@ -11,29 +11,29 @@
 #define EXT_C
 #endif
 
-#define MOCPP_PLATFORM_NONE    0
-#define MOCPP_PLATFORM_ARDUINO 1
-#define MOCPP_PLATFORM_ESPIDF  2
-#define MOCPP_PLATFORM_UNIX    3
+#define MO_PLATFORM_NONE    0
+#define MO_PLATFORM_ARDUINO 1
+#define MO_PLATFORM_ESPIDF  2
+#define MO_PLATFORM_UNIX    3
 
-#ifndef MOCPP_PLATFORM
-#define MOCPP_PLATFORM MOCPP_PLATFORM_ARDUINO
+#ifndef MO_PLATFORM
+#define MO_PLATFORM MO_PLATFORM_ARDUINO
 #endif
 
-#if MOCPP_PLATFORM == MOCPP_PLATFORM_NONE
-#ifndef MOCPP_CUSTOM_CONSOLE
-#define MOCPP_CUSTOM_CONSOLE
+#if MO_PLATFORM == MO_PLATFORM_NONE
+#ifndef MO_CUSTOM_CONSOLE
+#define MO_CUSTOM_CONSOLE
 #endif
-#ifndef MOCPP_CUSTOM_TIMER
-#define MOCPP_CUSTOM_TIMER
+#ifndef MO_CUSTOM_TIMER
+#define MO_CUSTOM_TIMER
 #endif
 #endif
 
-#ifdef MOCPP_CUSTOM_CONSOLE
+#ifdef MO_CUSTOM_CONSOLE
 #include <cstdio>
 
-#ifndef MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE
-#define MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE 192
+#ifndef MO_CUSTOM_CONSOLE_MAXMSGSIZE
+#define MO_CUSTOM_CONSOLE_MAXMSGSIZE 192
 #endif
 
 void mo_set_console_out(void (*console_out)(const char *msg));
@@ -41,19 +41,19 @@ void mo_set_console_out(void (*console_out)(const char *msg));
 namespace MicroOcpp {
 void mocpp_console_out(const char *msg);
 }
-#define MOCPP_CONSOLE_PRINTF(X, ...) \
+#define MO_CONSOLE_PRINTF(X, ...) \
             do { \
-                char msg [MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE]; \
-                auto _mo_ret = snprintf(msg, MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__); \
-                if (_mo_ret < 0 || _mo_ret >= MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE) { \
-                    sprintf(msg + MOCPP_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
+                char msg [MO_CUSTOM_CONSOLE_MAXMSGSIZE]; \
+                auto _mo_ret = snprintf(msg, MO_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__); \
+                if (_mo_ret < 0 || _mo_ret >= MO_CUSTOM_CONSOLE_MAXMSGSIZE) { \
+                    sprintf(msg + MO_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
                 } \
                 MicroOcpp::mocpp_console_out(msg); \
             } while (0)
 #else
 #define mo_set_console_out(X) \
             do { \
-                X("[OCPP] CONSOLE ERROR: mo_set_console_out ignored if MOCPP_CUSTOM_CONSOLE " \
+                X("[OCPP] CONSOLE ERROR: mo_set_console_out ignored if MO_CUSTOM_CONSOLE " \
                   "not defined\n"); \
                 char msg [196]; \
                 snprintf(msg, 196, "     > see %s:%i",__FILE__,__LINE__); \
@@ -61,49 +61,49 @@ void mocpp_console_out(const char *msg);
                 X("\n     > see MicroOcpp/Platform.h\n"); \
             } while (0)
 
-#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO
 #include <Arduino.h>
-#ifndef MOCPP_USE_SERIAL
-#define MOCPP_USE_SERIAL Serial
+#ifndef MO_USE_SERIAL
+#define MO_USE_SERIAL Serial
 #endif
 
-#define MOCPP_CONSOLE_PRINTF(X, ...) MOCPP_USE_SERIAL.printf_P(PSTR(X), ##__VA_ARGS__)
-#elif MOCPP_PLATFORM == MOCPP_PLATFORM_ESPIDF || MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
+#define MO_CONSOLE_PRINTF(X, ...) MO_USE_SERIAL.printf_P(PSTR(X), ##__VA_ARGS__)
+#elif MO_PLATFORM == MO_PLATFORM_ESPIDF || MO_PLATFORM == MO_PLATFORM_UNIX
 #include <stdio.h>
 
-#define MOCPP_CONSOLE_PRINTF(X, ...) printf(X, ##__VA_ARGS__)
+#define MO_CONSOLE_PRINTF(X, ...) printf(X, ##__VA_ARGS__)
 #endif
 #endif
 
-#ifdef MOCPP_CUSTOM_TIMER
+#ifdef MO_CUSTOM_TIMER
 void mocpp_set_timer(unsigned long (*get_ms)());
 
 unsigned long mocpp_tick_ms_custom();
 #define mocpp_tick_ms mocpp_tick_ms_custom
 #else
 
-#if MOCPP_PLATFORM == MOCPP_PLATFORM_ARDUINO
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO
 #include <Arduino.h>
 #define mocpp_tick_ms millis
-#elif MOCPP_PLATFORM == MOCPP_PLATFORM_ESPIDF
+#elif MO_PLATFORM == MO_PLATFORM_ESPIDF
 #include "freertos/FreeRTOS.h"
 #include "freertos/task.h"
 #define mocpp_tick_ms(X) ((xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ)
-#elif MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
+#elif MO_PLATFORM == MO_PLATFORM_UNIX
 unsigned long mocpp_tick_ms_unix();
 #define mocpp_tick_ms mocpp_tick_ms_unix
 #endif
 #endif
 
-#ifndef MOCPP_MAX_JSON_CAPACITY
-#if MOCPP_PLATFORM == MOCPP_PLATFORM_UNIX
-#define MOCPP_MAX_JSON_CAPACITY 16384
+#ifndef MO_MAX_JSON_CAPACITY
+#if MO_PLATFORM == MO_PLATFORM_UNIX
+#define MO_MAX_JSON_CAPACITY 16384
 #else
-#define MOCPP_MAX_JSON_CAPACITY 4096
+#define MO_MAX_JSON_CAPACITY 4096
 #endif
 #endif
 
-#if MOCPP_PLATFORM != MOCPP_PLATFORM_ARDUINO
+#if MO_PLATFORM != MO_PLATFORM_ARDUINO
 void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target);
 #endif
 
diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
index 28626b49..93da866a 100644
--- a/src/MicroOcpp/Version.h
+++ b/src/MicroOcpp/Version.h
@@ -1 +1 @@
-#define MOCPP_VERSION "0.4.0"
+#define MO_VERSION "0.4.0"
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 87a9e2bf..1d567b00 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -15,7 +15,7 @@ void ocpp_initialize(OCPP_Connection *conn, const char *chargePointModel, const
 
 void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt) {
     if (!conn) {
-        MOCPP_DBG_ERR("conn is null");
+        MO_DBG_ERR("conn is null");
     }
 
     ocppSocket = reinterpret_cast<MicroOcpp::Connection*>(conn);
@@ -45,7 +45,7 @@ MicroOcpp::PollResult<bool> adaptScl(enum OptionalBool v) {
     } else if (v == OptionalNone) {
         return MicroOcpp::PollResult<bool>::Await();
     } else {
-        MOCPP_DBG_ERR("illegal argument");
+        MO_DBG_ERR("illegal argument");
         return false;
     }
 }
@@ -102,18 +102,18 @@ std::function<void(void)> adaptFn(void (*fn)(void)) {
     return fn;
 }
 
-#ifndef MOCPP_RECEIVE_PAYLOAD_BUFSIZE
-#define MOCPP_RECEIVE_PAYLOAD_BUFSIZE 512
+#ifndef MO_RECEIVE_PAYLOAD_BUFSIZE
+#define MO_RECEIVE_PAYLOAD_BUFSIZE 512
 #endif
 
-char ocpp_recv_payload_buff [MOCPP_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
+char ocpp_recv_payload_buff [MO_RECEIVE_PAYLOAD_BUFSIZE] = {'\0'};
 
 std::function<void(JsonObject)> adaptFn(OnMessage fn) {
     if (!fn) return nullptr;
     return [fn] (JsonObject payload) {
-        auto len = serializeJson(payload, ocpp_recv_payload_buff, MOCPP_RECEIVE_PAYLOAD_BUFSIZE);
+        auto len = serializeJson(payload, ocpp_recv_payload_buff, MO_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
-            MOCPP_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+            MO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
         }
         fn(len > 0 ? ocpp_recv_payload_buff : "", len);
     };
@@ -122,9 +122,9 @@ std::function<void(JsonObject)> adaptFn(OnMessage fn) {
 MicroOcpp::OnReceiveErrorListener adaptFn(OnCallError fn) {
     if (!fn) return nullptr;
     return [fn] (const char *code, const char *description, JsonObject details) {
-        auto len = serializeJson(details, ocpp_recv_payload_buff, MOCPP_RECEIVE_PAYLOAD_BUFSIZE);
+        auto len = serializeJson(details, ocpp_recv_payload_buff, MO_RECEIVE_PAYLOAD_BUFSIZE);
         if (len <= 0) {
-            MOCPP_DBG_WARN("Received payload buffer exceeded. Continue without payload");
+            MO_DBG_WARN("Received payload buffer exceeded. Continue without payload");
         }
         fn(code, description, len > 0 ? ocpp_recv_payload_buff : "", len);
     };
@@ -347,8 +347,8 @@ void ocpp_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, Aut
 
     authorize(idTag,
             onConfirmation ? [onConfirmation, idTag_capture, user_data] (JsonObject payload) {
-                    auto len = serializeJson(payload, ocpp_recv_payload_buff, MOCPP_RECEIVE_PAYLOAD_BUFSIZE);
-                    if (len <= 0) {MOCPP_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
+                    auto len = serializeJson(payload, ocpp_recv_payload_buff, MO_RECEIVE_PAYLOAD_BUFSIZE);
+                    if (len <= 0) {MO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
                     onConfirmation(idTag_capture.c_str(), len > 0 ? ocpp_recv_payload_buff : "", len, user_data);
                 } : OnReceiveConfListener(nullptr),
             onAbort ? [onAbort, idTag_capture, user_data] () -> void {
@@ -358,8 +358,8 @@ void ocpp_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, Aut
                     onTimeout(idTag_capture.c_str(), user_data);
                 } : OnTimeoutListener(nullptr),
             onError ? [onError, idTag_capture, user_data] (const char *code, const char *description, JsonObject details) {
-                    auto len = serializeJson(details, ocpp_recv_payload_buff, MOCPP_RECEIVE_PAYLOAD_BUFSIZE);
-                    if (len <= 0) {MOCPP_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
+                    auto len = serializeJson(details, ocpp_recv_payload_buff, MO_RECEIVE_PAYLOAD_BUFSIZE);
+                    if (len <= 0) {MO_DBG_WARN("Received payload buffer exceeded. Continue without payload");}
                     onError(idTag_capture.c_str(), code, description, len > 0 ? ocpp_recv_payload_buff : "", len, user_data);
                 } : OnReceiveErrorListener(nullptr));
 }
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index 6c1969e2..b4208da8 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -166,7 +166,7 @@ void ocpp_setOnReceiveRequest(const char *operationType, OnMessage onRequest);
 void ocpp_setOnSendConf(const char *operationType, OnMessage onConfirmation);
 
 /*
- * If build flag MOCPP_CUSTOM_CONSOLE is set, all console output will be forwarded to the print
+ * If build flag MO_CUSTOM_CONSOLE is set, all console output will be forwarded to the print
  * function given by this setter. The parameter msg will also by null-terminated c-strings.
  */
 void ocpp_set_console_out_c(void (*console_out)(const char *msg));
diff --git a/tests/Api.cpp b/tests/Api.cpp
index efbd8d08..d8d02fd7 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -153,12 +153,12 @@ TEST_CASE( "C++ API test" ) {
 
         loop();
         
-        MOCPP_DBG_DEBUG("added %zu checkpoints", ncheck);
+        MO_DBG_DEBUG("added %zu checkpoints", ncheck);
 
         bool checkpointsPassed = true;
         for (unsigned int i = 0; i < ncheck; i++) {
             if (!checkpoints[i]) {
-                MOCPP_DBG_ERR("missed checkpoint %u", i);
+                MO_DBG_ERR("missed checkpoint %u", i);
                 checkpointsPassed = false;
             }
         }
@@ -340,12 +340,12 @@ TEST_CASE( "C API test" ) {
 
         loop();
         
-        MOCPP_DBG_DEBUG("added %zu checkpoints", ncheckc);
+        MO_DBG_DEBUG("added %zu checkpoints", ncheckc);
 
         bool checkpointsPassed = true;
         for (unsigned int i = 0; i < ncheckc; i++) {
             if (!checkpointsc[i]) {
-                MOCPP_DBG_ERR("missed checkpoint %u", i);
+                MO_DBG_ERR("missed checkpoint %u", i);
                 checkpointsPassed = false;
             }
         }
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 87b5a4a5..8eb98fcb 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -185,7 +185,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         loop();
@@ -246,7 +246,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         loop();
@@ -260,7 +260,7 @@ TEST_CASE( "Charging sessions" ) {
 
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         bool checkProcessed = false;
@@ -297,7 +297,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         loop();
@@ -314,7 +314,7 @@ TEST_CASE( "Charging sessions" ) {
 
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-        declareConfiguration<bool>(MOCPP_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
         configuration_save();
 
         bool checkProcessed = false;
diff --git a/tests/Configuration.cpp b/tests/Configuration.cpp
index 4a078079..c890f96f 100644
--- a/tests/Configuration.cpp
+++ b/tests/Configuration.cpp
@@ -39,7 +39,7 @@ TEST_CASE( "Configuration" ) {
         }
 
         SECTION("Persistent storage") {
-            container = makeConfigurationContainerFlash(filesystem, MOCPP_FILENAME_PREFIX "persistent1.jsn", true);
+            container = makeConfigurationContainerFlash(filesystem, MO_FILENAME_PREFIX "persistent1.jsn", true);
         }
 
         //check emptyness
@@ -74,7 +74,7 @@ TEST_CASE( "Configuration" ) {
 
     SECTION("Persistency on filesystem") {
 
-        auto container = makeConfigurationContainerFlash(filesystem, MOCPP_FILENAME_PREFIX "persistent1.jsn", true);
+        auto container = makeConfigurationContainerFlash(filesystem, MO_FILENAME_PREFIX "persistent1.jsn", true);
 
         //trivial load call
         REQUIRE( container->load() );
@@ -89,7 +89,7 @@ TEST_CASE( "Configuration" ) {
         container.reset(); //destroy
 
         //...load again
-        auto container2 = makeConfigurationContainerFlash(filesystem, MOCPP_FILENAME_PREFIX "persistent1.jsn", true);
+        auto container2 = makeConfigurationContainerFlash(filesystem, MO_FILENAME_PREFIX "persistent1.jsn", true);
         REQUIRE( container2->size() == 0 );
         REQUIRE( container2->load() );
         REQUIRE( container2->size() == 1 );
@@ -198,7 +198,7 @@ TEST_CASE( "Configuration" ) {
 
         //create config in hidden container
         isPublic = false;
-        auto cHidden = declareConfiguration<int>("cHidden", 42, MOCPP_FILENAME_PREFIX "hidden.jsn", false, false, isPublic);
+        auto cHidden = declareConfiguration<int>("cHidden", 42, MO_FILENAME_PREFIX "hidden.jsn", false, false, isPublic);
         REQUIRE( !getConfigurationPublic("cHidden") );
         
         //hidden container cannot be fetched
@@ -266,7 +266,7 @@ TEST_CASE( "Configuration" ) {
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
         loop();
 
-        declareConfiguration<int>(KNOWN_KEY, 1234, MOCPP_FILENAME_PREFIX "persistent1.jsn", false);
+        declareConfiguration<int>(KNOWN_KEY, 1234, MO_FILENAME_PREFIX "persistent1.jsn", false);
 
         bool checkProcessed = false;
 
@@ -286,7 +286,7 @@ TEST_CASE( "Configuration" ) {
                     bool foundCustomConfig = false;
                     bool foundStandardConfig = false;
                     for (JsonObject keyvalue : configurationKey) {
-                        MOCPP_DBG_DEBUG("key %s", keyvalue["key"] | "_Undefined");
+                        MO_DBG_DEBUG("key %s", keyvalue["key"] | "_Undefined");
                         if (!strcmp(keyvalue["key"] | "_Undefined", KNOWN_KEY)) {
                             foundCustomConfig = true;
                             REQUIRE( (keyvalue["readonly"] | true) == false );
@@ -357,7 +357,7 @@ TEST_CASE( "Configuration" ) {
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
         loop();
 
-        declareConfiguration<int>(KNOWN_KEY, 0, MOCPP_FILENAME_PREFIX "persistent1.jsn", false);
+        declareConfiguration<int>(KNOWN_KEY, 0, MO_FILENAME_PREFIX "persistent1.jsn", false);
 
         //update existing config
         bool checkProcessed = false;
@@ -480,7 +480,7 @@ TEST_CASE( "Configuration" ) {
 
         //set factory default for standard config ConnectionTimeOut
         configuration_init(filesystem);
-        auto factoryConnectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 1234, MOCPP_FILENAME_PREFIX "factory.jsn");
+        auto factoryConnectionTimeOut = declareConfiguration<int>("ConnectionTimeOut", 1234, MO_FILENAME_PREFIX "factory.jsn");
 
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
@@ -498,7 +498,7 @@ TEST_CASE( "Configuration" ) {
 
         //provide factory default again
         configuration_init(filesystem);
-        declareConfiguration<int>("ConnectionTimeOut", 4321, MOCPP_FILENAME_PREFIX "factory.jsn");
+        declareConfiguration<int>("ConnectionTimeOut", 4321, MO_FILENAME_PREFIX "factory.jsn");
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
         REQUIRE( getConfigurationPublic("ConnectionTimeOut")->getInt() == 1234 );
         mocpp_deinitialize();
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 1943aca6..822eee9f 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -50,7 +50,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
     //clean state
     auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
-    MOCPP_DBG_DEBUG("remove all");
+    MO_DBG_DEBUG("remove all");
     FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
 
     //initialize Context with dummy socket
@@ -139,7 +139,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
     SECTION("AllowOfflineTxForUnknownId") {
         auto configBool = declareConfiguration<bool>("AllowOfflineTxForUnknownId", true);
-        auto authorizationTimeoutInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 1);
+        auto authorizationTimeoutInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "AuthorizationTimeout", 1);
         authorizationTimeoutInt->setInt(1); //try normal Authorize for 1s, then enter offline mode
 
         loopback.setConnected(false); //connection loss
@@ -175,7 +175,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
     SECTION("LocalPreAuthorize") {
         auto configBool = declareConfiguration<bool>("LocalPreAuthorize", true);
-        auto authorizationTimeoutInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
+        auto authorizationTimeoutInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
         authorizationTimeoutInt->setInt(300); //try normal Authorize for 5 minutes
 
         declareConfiguration<bool>("LocalAuthorizeOffline", true)->setBool(true);
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index 684cc5ab..9104ad87 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -61,7 +61,7 @@ TEST_CASE( "LocalAuth" ) {
 
     //set Authorize timeout after which the charger is considered offline
     const unsigned long AUTH_TIMEOUT_MS = 60000;
-    MicroOcpp::declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "AuthorizationTimeout", -1)->setInt(AUTH_TIMEOUT_MS / 1000);
+    MicroOcpp::declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "AuthorizationTimeout", -1)->setInt(AUTH_TIMEOUT_MS / 1000);
 
     //fetch local auth configs
     auto localAuthorizeOffline = declareConfiguration<bool>("LocalAuthorizeOffline", false);
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 84561cbb..9b5b31d1 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -98,7 +98,7 @@ TEST_CASE("Metering") {
         auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
         MeterValueSampleIntervalInt->setInt(10);
 
-        auto MeterValueCacheSizeInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0);
+        auto MeterValueCacheSizeInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0);
         MeterValueCacheSizeInt->setInt(2);
 
         bool checkProcessed = false;
@@ -160,7 +160,7 @@ TEST_CASE("Metering") {
         auto MeterValuesAlignedDataString = declareConfiguration<const char*>("MeterValuesAlignedData", "", CONFIGURATION_FN);
         MeterValuesAlignedDataString->setString("Energy.Active.Import.Register");
 
-        auto MeterValueCacheSizeInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
+        auto MeterValueCacheSizeInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
         MeterValueCacheSizeInt->setInt(2);
 
         bool checkProcessed = false;
@@ -322,7 +322,7 @@ TEST_CASE("Metering") {
         auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
         MeterValueSampleIntervalInt->setInt(10);
 
-        auto MeterValueCacheSizeInt = declareConfiguration<int>(MOCPP_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
+        auto MeterValueCacheSizeInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
         MeterValueCacheSizeInt->setInt(10);
 
         bool checkProcessed = false;
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 18bcfac9..79cd76a1 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -25,7 +25,7 @@ TEST_CASE( "Transaction safety" ) {
     declareConfiguration<int>("ConnectionTimeOut", 30)->setInt(30);
 
     SECTION("Basic transaction") {
-        MOCPP_DBG_DEBUG("Basic transaction");
+        MO_DBG_DEBUG("Basic transaction");
         loop();
         startTransaction("mIdTag");
         loop();
@@ -38,7 +38,7 @@ TEST_CASE( "Transaction safety" ) {
     }
 
     SECTION("Managed transaction") {
-        MOCPP_DBG_DEBUG("Managed transaction");
+        MO_DBG_DEBUG("Managed transaction");
         loop();
         setConnectorPluggedInput([] () {return true;});
         beginTransaction("mIdTag");
@@ -52,7 +52,7 @@ TEST_CASE( "Transaction safety" ) {
     }
 
     SECTION("Reset during transaction 01 - interrupt initiation") {
-        MOCPP_DBG_DEBUG("Reset during transaction 01 - interrupt initiation");
+        MO_DBG_DEBUG("Reset during transaction 01 - interrupt initiation");
         setConnectorPluggedInput([] () {return false;});
         loop();
         beginTransaction("mIdTag");
@@ -61,7 +61,7 @@ TEST_CASE( "Transaction safety" ) {
     }
 
     SECTION("Reset during transaction 02 - interrupt initiation second time") {
-        MOCPP_DBG_DEBUG("Reset during transaction 02 - interrupt initiation second time");
+        MO_DBG_DEBUG("Reset during transaction 02 - interrupt initiation second time");
         setConnectorPluggedInput([] () {return false;});
         loop();
         REQUIRE(!ocppPermitsCharge());
@@ -69,7 +69,7 @@ TEST_CASE( "Transaction safety" ) {
     }
 
     SECTION("Reset during transaction 03 - interrupt running tx") {
-        MOCPP_DBG_DEBUG("Reset during transaction 03 - interrupt running tx");
+        MO_DBG_DEBUG("Reset during transaction 03 - interrupt running tx");
         setConnectorPluggedInput([] () {return true;});
         loop();
         REQUIRE(ocppPermitsCharge());
@@ -77,7 +77,7 @@ TEST_CASE( "Transaction safety" ) {
     }
 
     SECTION("Reset during transaction 04 - interrupt stopping tx") {
-        MOCPP_DBG_DEBUG("Reset during transaction 04 - interrupt stopping tx");
+        MO_DBG_DEBUG("Reset during transaction 04 - interrupt stopping tx");
         setConnectorPluggedInput([] () {return true;});
         loop();
         REQUIRE(ocppPermitsCharge());
@@ -86,7 +86,7 @@ TEST_CASE( "Transaction safety" ) {
     }
 
     SECTION("Reset during transaction 06 - check tx finished") {
-        MOCPP_DBG_DEBUG("Reset during transaction 06 - check tx finished");
+        MO_DBG_DEBUG("Reset during transaction 06 - check tx finished");
         setConnectorPluggedInput([] () {return true;});
         loop();
         REQUIRE(!ocppPermitsCharge());

From 941936e3f2f9570f36303b9e55d66c9046c15588 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 17 Oct 2023 22:31:47 +0200
Subject: [PATCH 409/549] update mocpp_set_console_out signature

---
 src/MicroOcpp/Platform.cpp    | 2 +-
 src/MicroOcpp/Platform.h      | 6 +++---
 src/MicroOcpp_c.cpp           | 2 +-
 tests/ocppEngineLifecycle.cpp | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/MicroOcpp/Platform.cpp b/src/MicroOcpp/Platform.cpp
index daefcd72..113f451b 100644
--- a/src/MicroOcpp/Platform.cpp
+++ b/src/MicroOcpp/Platform.cpp
@@ -16,7 +16,7 @@ void MicroOcpp::mocpp_console_out(const char *msg) {
     }
 }
 
-void mo_set_console_out(void (*console_out)(const char *msg)) {
+void mocpp_set_console_out(void (*console_out)(const char *msg)) {
     MicroOcpp::mocpp_console_out_impl = console_out;
     console_out("[OCPP] console initialized\n");
 }
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index f1435659..f0c14942 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -36,7 +36,7 @@
 #define MO_CUSTOM_CONSOLE_MAXMSGSIZE 192
 #endif
 
-void mo_set_console_out(void (*console_out)(const char *msg));
+void mocpp_set_console_out(void (*console_out)(const char *msg));
 
 namespace MicroOcpp {
 void mocpp_console_out(const char *msg);
@@ -51,9 +51,9 @@ void mocpp_console_out(const char *msg);
                 MicroOcpp::mocpp_console_out(msg); \
             } while (0)
 #else
-#define mo_set_console_out(X) \
+#define mocpp_set_console_out(X) \
             do { \
-                X("[OCPP] CONSOLE ERROR: mo_set_console_out ignored if MO_CUSTOM_CONSOLE " \
+                X("[OCPP] CONSOLE ERROR: mocpp_set_console_out ignored if MO_CUSTOM_CONSOLE " \
                   "not defined\n"); \
                 char msg [196]; \
                 snprintf(msg, 196, "     > see %s:%i",__FILE__,__LINE__); \
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 1d567b00..708206d4 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -338,7 +338,7 @@ void ocpp_setOnSendConf(const char *operationType, OnMessage onConfirmation) {
 }
 
 void ocpp_set_console_out_c(void (*console_out)(const char *msg)) {
-    mo_set_console_out(console_out);
+    mocpp_set_console_out(console_out);
 }
 
 void ocpp_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
diff --git a/tests/ocppEngineLifecycle.cpp b/tests/ocppEngineLifecycle.cpp
index 496eb374..df39f282 100644
--- a/tests/ocppEngineLifecycle.cpp
+++ b/tests/ocppEngineLifecycle.cpp
@@ -7,7 +7,7 @@ TEST_CASE( "Context lifecycle" ) {
     printf("\nRun %s\n",  "Context lifecycle");
 
     //set console output to the cpp console to display outputs
-    //mo_set_console_out(cpp_console_out);
+    //mocpp_set_console_out(cpp_console_out);
 
     //initialize Context with dummy socket
     MicroOcpp::LoopbackConnection loopback;

From 3ecae692c7fedb2657c4e8109c2da85bba58249e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 18 Oct 2023 11:05:23 +0200
Subject: [PATCH 410/549] add autoRecover switch to C-API

---
 examples/ESP-IDF/main/main.c |  2 +-
 src/MicroOcpp_c.cpp          |  8 ++++----
 src/MicroOcpp_c.h            | 10 ++++++----
 tests/Api.cpp                |  2 +-
 4 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/examples/ESP-IDF/main/main.c b/examples/ESP-IDF/main/main.c
index ea961913..97b6e5b7 100644
--- a/examples/ESP-IDF/main/main.c
+++ b/examples/ESP-IDF/main/main.c
@@ -160,7 +160,7 @@ void app_main(void)
             EXAMPLE_MO_OCPP_BACKEND, 
             EXAMPLE_MO_CHARGEBOXID, 
             EXAMPLE_MO_AUTHORIZATIONKEY, "", fsopt);
-    ocpp_initialize(osock, "ESP-IDF charger", "Your brand name here", fsopt);
+    ocpp_initialize(osock, "ESP-IDF charger", "Your brand name here", fsopt, false);
 
     /* Enter infinite loop */
     while (1) {
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 708206d4..7438fc32 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -9,11 +9,11 @@
 
 MicroOcpp::Connection *ocppSocket = nullptr;
 
-void ocpp_initialize(OCPP_Connection *conn, const char *chargePointModel, const char *chargePointVendor, struct OCPP_FilesystemOpt fsopt) {
-    ocpp_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt);
+void ocpp_initialize(OCPP_Connection *conn, const char *chargePointModel, const char *chargePointVendor, struct OCPP_FilesystemOpt fsopt, bool autoRecover) {
+    ocpp_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt, autoRecover);
 }
 
-void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt) {
+void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt, bool autoRecover) {
     if (!conn) {
         MO_DBG_ERR("conn is null");
     }
@@ -22,7 +22,7 @@ void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCre
 
     MicroOcpp::FilesystemOpt adaptFsopt = fsopt;
 
-    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt));
+    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt), autoRecover);
 }
 
 void ocpp_deinitialize() {
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index b4208da8..20ca659b 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -53,15 +53,17 @@ extern "C" {
 
 void ocpp_initialize(
             OCPP_Connection *conn,  //WebSocket adapter for MicroOcpp
-            const char *chargePointModel,     //model name of this charger (e.g. "")
-            const char *chargePointVendor, //brand name
-            struct OCPP_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            const char *chargePointModel,     //model name of this charger (e.g. "My Charger")
+            const char *chargePointVendor, //brand name (e.g. "My Company Ltd.")
+            struct OCPP_FilesystemOpt fsopt, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            bool autoRecover); //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
 
 //same as above, but more fields for the BootNotification
 void ocpp_initialize_full(
             OCPP_Connection *conn,  //WebSocket adapter for MicroOcpp
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
-            struct OCPP_FilesystemOpt fsopt); //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            struct OCPP_FilesystemOpt fsopt, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
+            bool autoRecover); //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
 
 
 void ocpp_deinitialize();
diff --git a/tests/Api.cpp b/tests/Api.cpp
index d8d02fd7..03b6b326 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -186,7 +186,7 @@ TEST_CASE( "C API test" ) {
     fsopt.formatFsOnFail = true;
 
     MicroOcpp::LoopbackConnection loopback;
-    ocpp_initialize(reinterpret_cast<OCPP_Connection*>(&loopback), "test-runner1234", "vendor", fsopt);
+    ocpp_initialize(reinterpret_cast<OCPP_Connection*>(&loopback), "test-runner1234", "vendor", fsopt, false);
     
     auto context = getOcppContext();
     auto& model = context->getModel();

From 45c970105a79b147a4c7c119e5a09d5ec8fe6015 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 18 Oct 2023 13:15:46 +0200
Subject: [PATCH 411/549] more consistent debug info

---
 src/MicroOcpp.cpp                             | 144 +++++++++---------
 src/MicroOcpp/Core/Configuration.h            |   5 +-
 src/MicroOcpp/Debug.h                         |  10 +-
 .../Operations/StatusNotification.cpp         |   5 +-
 4 files changed, 80 insertions(+), 84 deletions(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index ea078334..cb7ac352 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -58,7 +58,7 @@ using namespace MicroOcpp::Ocpp16;
 #ifndef MO_CUSTOM_WS
 void mocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt, const char *login, const char *password, const char *CA_cert, bool autoRecover) {
     if (context) {
-        MO_DBG_WARN("Can't be called two times. Either restart ESP, or call mocpp_deinitialize() before");
+        MO_DBG_WARN("already initialized. To reinit, call mocpp_deinitialize() before");
         return;
     }
 
@@ -133,7 +133,7 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
 
 void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs, bool autoRecover) {
     if (context) {
-        MO_DBG_WARN("Can't be called two times. To change the credentials, either restart ESP, or call mocpp_deinitialize() before");
+        MO_DBG_WARN("already initialized. To reinit, call mocpp_deinitialize() before");
         return;
     }
 
@@ -219,6 +219,8 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     credsJson.reset();
 
     configuration_load();
+
+    MO_DBG_INFO("initialized MicroOcpp v" MO_VERSION);
 }
 
 void mocpp_deinitialize() {
@@ -253,7 +255,7 @@ void mocpp_deinitialize() {
 
 void mocpp_loop() {
     if (!context) {
-        MO_DBG_WARN("Please call mocpp_initialize before");
+        MO_DBG_WARN("need to call mocpp_initialize before");
         return;
     }
 
@@ -262,7 +264,7 @@ void mocpp_loop() {
 
 std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
@@ -271,7 +273,7 @@ std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int co
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return nullptr;
     }
 
@@ -280,7 +282,7 @@ std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int co
 
 std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return nullptr;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX ||
@@ -290,7 +292,7 @@ std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, cons
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return nullptr;
     }
     
@@ -299,12 +301,12 @@ std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, cons
 
 bool endTransaction(const char *idTag, const char *reason, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return false;
     }
     auto res = isTransactionActive(connectorId);
@@ -314,12 +316,12 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
 
 bool isTransactionActive(unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return false;
     }
     auto& tx = connector->getTransaction();
@@ -328,12 +330,12 @@ bool isTransactionActive(unsigned int connectorId) {
 
 bool isTransactionRunning(unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return false;
     }
     auto& tx = connector->getTransaction();
@@ -342,12 +344,12 @@ bool isTransactionRunning(unsigned int connectorId) {
 
 const char *getTransactionIdTag(unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return nullptr;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return nullptr;
     }
     auto& tx = connector->getTransaction();
@@ -358,12 +360,12 @@ std::shared_ptr<Transaction> mocpp_undefinedTx;
 
 std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
     if (!context) {
-        MO_DBG_WARN("Please call mocpp_initialize before");
+        MO_DBG_WARN("OCPP uninitialized");
         return mocpp_undefinedTx;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return mocpp_undefinedTx;
     }
     return connector->getTransaction();
@@ -371,12 +373,12 @@ std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
 
 bool ocppPermitsCharge(unsigned int connectorId) {
     if (!context) {
-        MO_DBG_WARN("Please call mocpp_initialize before");
+        MO_DBG_WARN("OCPP uninitialized");
         return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return false;
     }
     return connector->ocppPermitsCharge();
@@ -384,26 +386,20 @@ bool ocppPermitsCharge(unsigned int connectorId) {
 
 void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->setConnectorPluggedInput(pluggedInput);
-
-    if (pluggedInput) {
-        MO_DBG_INFO("Added ConnectorPluggedInput. Transaction-management is in auto mode now");
-    } else {
-        MO_DBG_INFO("Reset ConnectorPluggedInput. Transaction-management is in manual mode now");
-    }
 }
 
 void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto& model = context->getModel();
@@ -424,7 +420,7 @@ void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connec
 
 void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
 
@@ -446,11 +442,11 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
 
 void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
 
@@ -473,11 +469,11 @@ void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput,
 
 void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
 
@@ -500,11 +496,11 @@ void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutpu
 
 void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOutput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     if (!context->getModel().getConnector(connectorId)) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
 
@@ -526,12 +522,12 @@ void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOu
 
 void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->setEvReadyInput(evReadyInput);
@@ -539,12 +535,12 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
 
 void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->setEvseReadyInput(evseReadyInput);
@@ -552,12 +548,12 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
 
 void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->addErrorCodeInput(errorCodeInput);
@@ -565,12 +561,12 @@ void addErrorCodeInput(std::function<const char*()> errorCodeInput, unsigned int
 
 void addErrorDataInput(std::function<MicroOcpp::ErrorData()> errorDataInput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->addErrorDataInput(errorDataInput);
@@ -578,7 +574,7 @@ void addErrorDataInput(std::function<MicroOcpp::ErrorData()> errorDataInput, uns
 
 void addMeterValueInput(std::function<float ()> valueInput, const char *measurand, const char *unit, const char *location, const char *phase, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
 
@@ -589,7 +585,7 @@ void addMeterValueInput(std::function<float ()> valueInput, const char *measuran
 
     if (!measurand) {
         measurand = "Energy.Active.Import.Register";
-        MO_DBG_WARN("Measurand unspecified; assume %s", measurand);
+        MO_DBG_WARN("measurand unspecified; assume %s", measurand);
     }
 
     SampledValueProperties properties;
@@ -611,7 +607,7 @@ void addMeterValueInput(std::function<float ()> valueInput, const char *measuran
 
 void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto& model = context->getModel();
@@ -624,12 +620,12 @@ void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigne
 
 void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->setOccupiedInput(occupied);
@@ -637,12 +633,12 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId)
 
 void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->setStartTxReadyInput(startTxReady);
@@ -650,12 +646,12 @@ void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int conne
 
 void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->setStopTxReadyInput(stopTxReady);
@@ -663,12 +659,12 @@ void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connect
 
 void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcpp::TxNotification)> notificationOutput, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->setTxNotificationOutput(notificationOutput);
@@ -676,12 +672,12 @@ void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcp
 
 void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return;
     }
     connector->setOnUnlockConnector(onUnlockConnectorInOut);
@@ -689,14 +685,14 @@ void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnect
 
 bool isOperative(unsigned int connectorId) {
     if (!context) {
-        MO_DBG_WARN("Please call mocpp_initialize before");
+        MO_DBG_WARN("OCPP uninitialized");
         return true; //assume "true" as default state
     }
     auto& model = context->getModel();
     auto chargePoint = model.getConnector(OCPP_ID_OF_CP);
     auto connector = model.getConnector(connectorId);
     if (!chargePoint || !connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return true; //assume "true" as default state
     }
     return chargePoint->isOperative() && connector->isOperative();
@@ -704,7 +700,7 @@ bool isOperative(unsigned int connectorId) {
 
 void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
 
@@ -715,7 +711,7 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
 
 void setOnResetExecute(std::function<void(bool)> onResetExecute) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
 
@@ -744,7 +740,7 @@ Context *getOcppContext() {
 
 void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onReceiveReq) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     if (!operationType) {
@@ -756,7 +752,7 @@ void setOnReceiveRequest(const char *operationType, OnReceiveReqListener onRecei
 
 void setOnSendConf(const char *operationType, OnSendConfListener onSendConf) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     if (!operationType) {
@@ -771,7 +767,7 @@ void sendRequest(const char *operationType,
             std::function<void (JsonObject)> fn_processConf) {
 
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     if (!operationType || !fn_createReq || !fn_processConf) {
@@ -788,7 +784,7 @@ void setRequestHandler(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf) {
 
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     if (!operationType || !fn_processReq || !fn_createConf) {
@@ -805,7 +801,7 @@ void setRequestHandler(const char *operationType,
 
 void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
@@ -831,7 +827,7 @@ void authorize(const char *idTag, OnReceiveConfListener onConf, OnAbortListener
 
 bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
     }
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
@@ -840,13 +836,13 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
     }
     auto connector = context->getModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return false;
     }
     auto transaction = connector->getTransaction();
     if (transaction) {
         if (transaction->getStartSync().isRequested()) {
-            MO_DBG_ERR("Transaction already in progress. Must call stopTransaction()");
+            MO_DBG_ERR("transaction already in progress. Must call stopTransaction()");
             return false;
         }
         transaction->setIdTag(idTag);
@@ -854,7 +850,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         beginTransaction_authorized(idTag); //request new transaction object
         transaction = connector->getTransaction();
         if (!transaction) {
-            MO_DBG_WARN("Transaction queue full");
+            MO_DBG_WARN("transaction queue full");
             return false;
         }
     }
@@ -864,7 +860,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
         if (meterStart && *meterStart) {
             transaction->setMeterStart(meterStart->toInteger());
         } else {
-            MO_DBG_ERR("MeterStart undefined");
+            MO_DBG_ERR("meterStart undefined");
         }
     }
 
@@ -893,18 +889,18 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
 
 bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTimeoutListener onTimeout, OnReceiveErrorListener onError, unsigned int timeout) {
     if (!context) {
-        MO_DBG_ERR("OCPP uninitialized"); //please call mocpp_initialize before
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
     }
     auto connector = context->getModel().getConnector(OCPP_ID_OF_CONNECTOR);
     if (!connector) {
-        MO_DBG_ERR("Could not find connector. Ignore");
+        MO_DBG_ERR("could not find connector");
         return false;
     }
 
     auto transaction = connector->getTransaction();
     if (!transaction || !transaction->isRunning()) {
-        MO_DBG_ERR("No running Tx to stop");
+        MO_DBG_ERR("no running Tx to stop");
         return false;
     }
 
@@ -920,7 +916,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
         if (meterStop && *meterStop) {
             transaction->setMeterStop(meterStop->toInteger());
         } else {
-            MO_DBG_ERR("MeterStop undefined");
+            MO_DBG_ERR("meterStop undefined");
         }
     }
 
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index 66c9d43f..1d19dac6 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -18,11 +18,8 @@
 
 namespace MicroOcpp {
 
-/*
- * 
- */
 template <class T>
-std::shared_ptr<Configuration> declareConfiguration(const char *key, T defaultValue, const char *filename = CONFIGURATION_FN, bool readonly = false, bool rebootRequired = false, bool accessible = true);
+std::shared_ptr<Configuration> declareConfiguration(const char *key, T factoryDefault, const char *filename = CONFIGURATION_FN, bool readonly = false, bool rebootRequired = false, bool accessible = true);
 
 std::function<bool(const char*)> *getConfigurationValidator(const char *key);
 void registerConfigurationValidator(const char *key, std::function<bool(const char*)> validator);
diff --git a/src/MicroOcpp/Debug.h b/src/MicroOcpp/Debug.h
index 02ae7c20..238e8b7a 100644
--- a/src/MicroOcpp/Debug.h
+++ b/src/MicroOcpp/Debug.h
@@ -10,7 +10,7 @@
 #define MO_DL_NONE 0x00     //suppress all output to the console
 #define MO_DL_ERROR 0x01    //report failures
 #define MO_DL_WARN 0x02     //report observed or assumed inconsistent state
-#define MO_DL_INFO 0x03     //make internal state apparent
+#define MO_DL_INFO 0x03     //inform about internal state changes
 #define MO_DL_DEBUG 0x04    //relevant info for debugging
 #define MO_DL_VERBOSE 0x05  //all output
 
@@ -56,7 +56,7 @@
         const char *_mo_file = __FILE__;         \
         size_t _mo_l = sizeof(__FILE__);         \
         for (; _mo_l > 0 && _mo_file[_mo_l-1] != '/' && _mo_file[_mo_l-1] != '\\'; _mo_l--);         \
-        MO_CONSOLE_PRINTF("[OCPP] %s (%s:%i): ",level, _mo_file + _mo_l,__LINE__);           \
+        MO_CONSOLE_PRINTF("[MO] %s (%s:%i): ",level, _mo_file + _mo_l,__LINE__);           \
         MO_CONSOLE_PRINTF X;  \
         MO_CONSOLE_PRINTF("\n");         \
     } while (0);
@@ -64,7 +64,7 @@
 #elif MO_DBG_FORMAT == MO_DF_FULL
 #define MO_DBG(level, X)   \
     do {                        \
-        MO_CONSOLE_PRINTF("[OCPP] %s (%s:%i): ",level, __FILE__,__LINE__);           \
+        MO_CONSOLE_PRINTF("[MO] %s (%s:%i): ",level, __FILE__,__LINE__);           \
         MO_CONSOLE_PRINTF X;  \
         MO_CONSOLE_PRINTF("\n");         \
     } while (0);
@@ -108,13 +108,13 @@
 
 #define MO_DBG_TRAFFIC_OUT(...)   \
     do {                        \
-        MO_CONSOLE_PRINTF("[OCPP] Send: %s",__VA_ARGS__);           \
+        MO_CONSOLE_PRINTF("[MO] Send: %s",__VA_ARGS__);           \
         MO_CONSOLE_PRINTF("\n");         \
     } while (0)
 
 #define MO_DBG_TRAFFIC_IN(...)   \
     do {                        \
-        MO_CONSOLE_PRINTF("[OCPP] Recv: %.*s",__VA_ARGS__);           \
+        MO_CONSOLE_PRINTF("[MO] Recv: %.*s",__VA_ARGS__);           \
         MO_CONSOLE_PRINTF("\n");         \
     } while (0)
 
diff --git a/src/MicroOcpp/Operations/StatusNotification.cpp b/src/MicroOcpp/Operations/StatusNotification.cpp
index 4820ba8d..ada65894 100644
--- a/src/MicroOcpp/Operations/StatusNotification.cpp
+++ b/src/MicroOcpp/Operations/StatusNotification.cpp
@@ -46,7 +46,10 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
 StatusNotification::StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData)
         : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorData(errorData) {
     
-    MO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
+    if (currentStatus != ChargePointStatus::NOT_SET) {
+        MO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
+        (void)0;
+    }
 }
 
 const char* StatusNotification::getOperationType(){

From f92b3090587b30a021a6f1c55989fc743d01eccf Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 18 Oct 2023 19:20:14 +0200
Subject: [PATCH 412/549] add endTransaction_authorized

---
 src/MicroOcpp.cpp                             | 18 +++++++++++
 src/MicroOcpp.h                               | 30 +++++++++++++++++--
 .../Model/ConnectorBase/Connector.cpp         |  7 -----
 src/MicroOcpp_c.cpp                           |  7 +++++
 src/MicroOcpp_c.h                             |  3 ++
 tests/Api.cpp                                 |  8 ++---
 6 files changed, 59 insertions(+), 14 deletions(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index cb7ac352..cc9f9085 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -300,6 +300,24 @@ std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, cons
 }
 
 bool endTransaction(const char *idTag, const char *reason, unsigned int connectorId) {
+    if (!context) {
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
+        return false;
+    }
+    bool res = false;
+    if (isTransactionActive(connectorId) && getTransactionIdTag(connectorId)) {
+        //end transaction now if either idTag is nullptr (i.e. force stop) or the idTag matches beginTransaction
+        if (!idTag || !strcmp(idTag, getTransactionIdTag())) {
+            res = endTransaction_authorized(idTag, reason, connectorId);
+        } else {
+            MO_DBG_INFO("endTransaction: idTag doesn't match");
+            (void)0;
+        }
+    }
+    return res;
+}
+
+bool endTransaction_authorized(const char *idTag, const char *reason, unsigned int connectorId) {
     if (!context) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 5ef1244c..44e6939a 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -136,23 +136,47 @@ std::shared_ptr<MicroOcpp::Transaction> beginTransaction(const char *idTag, unsi
 std::shared_ptr<MicroOcpp::Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag = nullptr, unsigned int connectorId = 1);
 
 /*
- * End the transaction process by terminating the transaction and setting a reason for its termination.
+ * End the transaction process if idTag is authorized to stop the transaction. The OCPP lib sends
+ * a StopTransaction request if the following conditions are true:
+ * Conditions:
+ *     1) Currently, a transaction is running which hasn't been terminated yet AND
+ *     2) idTag is either
+ *         - nullptr OR
+ *         - matches the idTag of beginTransaction (or RemoteStartTransaction) OR
+ *         - [Planned, not released yet] is part of the current LocalList and the parentIdTag
+ *           matches with the parentIdTag of beginTransaction.
+ *         - [Planned, not released yet] If none of step 2) applies, then the OCPP lib will check
+ *           the authorization status via an Authorize request
+ * 
+ * See endTransaction_authorized for skipping the authorization check, i.e. step 2)
  * 
  * If the transaction is ended by swiping an RFID card, then idTag should contain its identifier. If
  * charging stops for a different reason than swiping the card, idTag should be null or empty.
  * 
- * Please refer to OCPP 1.6 Specification - Edition 2 p. 90 for a list of valid reasons. "reason"
+ * Please refer to OCPP 1.6 Specification - Edition 2 p. 90 for a list of valid reasons. `reason`
  * can also be nullptr.
  * 
  * It is safe to call this function at any time, i.e. when no transaction runs or when the transaction
  * has already been ended. For example you can place
- *     `endTransaction(nullptr, StopTransactionReason::Reboot);`
+ *     `endTransaction(nullptr, "Reboot");`
  * in the beginning of the program just to ensure that there is no transaction from a previous run.
  * 
+ * If called with idTag=nullptr, this is functionally equivalent to
+ *     `endTransaction_authorized(nullptr, reason);`
+ * 
  * Returns true if there is a transaction which could eventually be ended by this action
  */
 bool endTransaction(const char *idTag = nullptr, const char *reason = nullptr, unsigned int connectorId = 1);
 
+/*
+ * End the transaction process definitely without authorization check. See endTransaction(...) for a
+ * complete description.
+ * 
+ * Use this function if you manage authorization on your own and want to bypass the Authorization
+ * management of this lib.
+ */
+bool endTransaction_authorized(const char *idTag, const char *reason = nullptr, unsigned int connectorId = 1);
+
 /*
  * Get information about the current Transaction lifecycle. A transaction can enter the following
  * states:
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 3540a70f..4c0274ab 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -776,13 +776,6 @@ void Connector::endTransaction(const char *idTag, const char *reason) {
         return;
     }
 
-    if (idTag && *idTag != '\0' && !strcmp(idTag, transaction->getIdTag())) {
-        //given stop idTag differs from start idTag. Make Authorization check first
-
-        MO_DBG_WARN("authorization status of stop idTag not checked automatically yet");
-        (void)0;
-    }
-
     MO_DBG_DEBUG("End session started by idTag %s",
                             transaction->getIdTag());
     
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 7438fc32..4041a368 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -159,6 +159,13 @@ bool ocpp_endTransaction_m(unsigned int connectorId, const char *idTag, const ch
     return endTransaction(idTag, reason, connectorId);
 }
 
+bool ocpp_endTransaction_authorized(const char *idTag, const char *reason) {
+    return endTransaction_authorized(idTag, reason);
+}
+bool ocpp_endTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *reason) {
+    return endTransaction_authorized(idTag, reason, connectorId);
+}
+
 bool ocpp_isTransactionActive() {
     return isTransactionActive();
 }
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index 20ca659b..df9d4402 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -83,6 +83,9 @@ void ocpp_beginTransaction_authorized_m(unsigned int connectorId, const char *id
 bool ocpp_endTransaction(const char *idTag, const char *reason); //idTag, reason can be NULL
 bool ocpp_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason); //idTag, reason can be NULL
 
+bool ocpp_endTransaction_authorized(const char *idTag, const char *reason); //idTag, reason can be NULL
+bool ocpp_endTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *reason); //idTag, reason can be NULL
+
 bool ocpp_isTransactionActive();
 bool ocpp_isTransactionActive_m(unsigned int connectorId);
 
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 03b6b326..2ca8f468 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -280,8 +280,8 @@ TEST_CASE( "C API test" ) {
         REQUIRE(ocpp_ocppPermitsCharge());
         REQUIRE(ocpp_ocppPermitsCharge_m(2));
 
-        ocpp_endTransaction(NULL, NULL);
-        ocpp_endTransaction_m(2, NULL, NULL);
+        ocpp_endTransaction("mIdTag", NULL);
+        ocpp_endTransaction_m(2, "mIdTag", NULL);
 
         loop();
 
@@ -294,8 +294,8 @@ TEST_CASE( "C API test" ) {
 
         loop();
 
-        ocpp_endTransaction(NULL, NULL);
-        ocpp_endTransaction_m(2, NULL, NULL);
+        ocpp_endTransaction_authorized(NULL, NULL);
+        ocpp_endTransaction_authorized_m(2, NULL, NULL);
 
         loop();
 

From 29621c70d4f897b9141326194109d8be8a94d7d4 Mon Sep 17 00:00:00 2001
From: Oliver Lenz <o.lenz@eclever.io>
Date: Thu, 19 Oct 2023 08:19:56 +0200
Subject: [PATCH 413/549] fixed state transition issue in FirmwareService that
 leads to aborting a running update process when in download phase

---
 src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index f897d3a9..0c41cd90 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -111,8 +111,8 @@ void FirmwareService::loop() {
 
                     timestampTransition = mocpp_tick_ms();
                     delayTransition = 10000;
-                    return;
                 }
+                return;
             } else {
                 //if client doesn't report download state, assume download to be finished (at least 30s download time have passed until here)
                 if (downloadStatusInput == nullptr) {

From 99ecb9cfc851c0ae2de78890e2461141789063a8 Mon Sep 17 00:00:00 2001
From: Oliver Lenz <o.lenz@eclever.io>
Date: Thu, 19 Oct 2023 15:28:45 +0200
Subject: [PATCH 414/549] added define for partition label, added check when
 using esp-idf spiffs, so we can actually use a base path like "/ao/" without
 breaking initialization

---
 src/MicroOcpp/Core/FilesystemAdapter.cpp | 5 +++--
 src/MicroOcpp/Core/FilesystemAdapter.h   | 4 ++++
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 6de8d5ef..6a2f1229 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -219,6 +219,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 #include <sys/stat.h>
 #include <dirent.h>
+#include <string.h>
 #include "esp_spiffs.h"
 
 namespace MicroOcpp {
@@ -337,8 +338,8 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
         mounted = false;
         
         esp_vfs_spiffs_conf_t conf = {
-            .base_path = MOCPP_FILENAME_PREFIX,
-            .partition_label = "mo", //also see deconstructor
+            .base_path = MOCPP_FILENAME_PREFIX[strlen(MOCPP_FILENAME_PREFIX) - 1] == '/' ? strndup(MOCPP_FILENAME_PREFIX, strlen(MOCPP_FILENAME_PREFIX) - 1) : MOCPP_FILENAME_PREFIX,
+            .partition_label = MOCPP_PARTITION_LABEL, //also see deconstructor
             .max_files = 5,
             .format_if_mount_failed = config.formatOnFail()
         };
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.h b/src/MicroOcpp/Core/FilesystemAdapter.h
index 8a78e3cd..16be2a96 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.h
+++ b/src/MicroOcpp/Core/FilesystemAdapter.h
@@ -15,6 +15,10 @@
 #define MOCPP_FILENAME_PREFIX "/"
 #endif
 
+#ifndef MOCPP_PARTITION_LABEL
+#define MOCPP_PARTITION_LABEL "mo"
+#endif
+
 #define DISABLE_FS       0
 #define ARDUINO_LITTLEFS 1
 #define ARDUINO_SPIFFS   2

From 44e6a593215cf2fb8b3f2cf968143fbd93e36dfd Mon Sep 17 00:00:00 2001
From: Oliver Lenz <o.lenz@eclever.io>
Date: Thu, 19 Oct 2023 15:50:19 +0200
Subject: [PATCH 415/549] changed to MOCPP_PARTITION_LABEL when unmounting
 spiffs

---
 src/MicroOcpp/Core/FilesystemAdapter.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 6a2f1229..d064c525 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -258,7 +258,7 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
 
     ~EspIdfFilesystemAdapter() {
         if (config.mustMount()) {
-            esp_vfs_spiffs_unregister("mo"); //partition label
+            esp_vfs_spiffs_unregister(MOCPP_PARTITION_LABEL); //partition label
             MOCPP_DBG_DEBUG("SPIFFS unmounted");
         }
     }

From aefcbb09b133c22c8ca6871ad4b0c0110fa3bd36 Mon Sep 17 00:00:00 2001
From: Oliver Lenz <o.lenz@eclever.io>
Date: Thu, 19 Oct 2023 16:17:22 +0200
Subject: [PATCH 416/549] added check, so the standard MOCPP_FILENAME_PREFIX
 "/" would not be cleared by the logic and an empty string would be used for
 initialization

---
 src/MicroOcpp/Core/FilesystemAdapter.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index d064c525..c62b1986 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -338,7 +338,7 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
         mounted = false;
         
         esp_vfs_spiffs_conf_t conf = {
-            .base_path = MOCPP_FILENAME_PREFIX[strlen(MOCPP_FILENAME_PREFIX) - 1] == '/' ? strndup(MOCPP_FILENAME_PREFIX, strlen(MOCPP_FILENAME_PREFIX) - 1) : MOCPP_FILENAME_PREFIX,
+            .base_path = (MOCPP_FILENAME_PREFIX[0] == '/' && MOCPP_FILENAME_PREFIX[1] == '\0') ? MOCPP_FILENAME_PREFIX : (MOCPP_FILENAME_PREFIX[strlen(MOCPP_FILENAME_PREFIX) - 1] == '/' ? strndup(MOCPP_FILENAME_PREFIX, strlen(MOCPP_FILENAME_PREFIX) - 1) : MOCPP_FILENAME_PREFIX),
             .partition_label = MOCPP_PARTITION_LABEL, //also see deconstructor
             .max_files = 5,
             .format_if_mount_failed = config.formatOnFail()

From 4467deaea4858550cae0e455ff6db4304714a74e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 20 Oct 2023 12:59:22 +0200
Subject: [PATCH 417/549] update Mongoose WS adapter ref

---
 .github/workflows/esp-idf.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
index 5d1da976..90043470 100644
--- a/.github/workflows/esp-idf.yml
+++ b/.github/workflows/esp-idf.yml
@@ -34,7 +34,7 @@ jobs:
       uses: actions/checkout@v3
       with:
         repository: matth-x/MicroOcppMongoose
-        ref: 642006f0629b715dce44a913a5c4b77f3f8953bb
+        ref: 92ebea9fe8554999b4d34c6a03fa12c0d9faec48
         path: examples/ESP-IDF/components/MicroOcppMongoose
     - name: Checkout ArduinoJson
       uses: actions/checkout@v3

From 760a8f3174ca03c5b8e0a85a3fc09d82e0c5e990 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 21 Oct 2023 14:29:26 +0200
Subject: [PATCH 418/549] parse URL instead of explicit host param

---
 examples/ESP/main.cpp | 12 +++----
 src/MicroOcpp.cpp     | 78 +++++++++++++++++++++++++++++++++++++++----
 src/MicroOcpp.h       | 13 +++-----
 3 files changed, 82 insertions(+), 21 deletions(-)

diff --git a/examples/ESP/main.cpp b/examples/ESP/main.cpp
index 198d39a6..b9f46a7b 100644
--- a/examples/ESP/main.cpp
+++ b/examples/ESP/main.cpp
@@ -18,16 +18,14 @@ ESP8266WiFiMulti WiFiMulti;
 #define STASSID "YOUR_WIFI_SSID"
 #define STAPSK  "YOUR_WIFI_PW"
 
-#define OCPP_HOST "echo.websocket.events"
-#define OCPP_PORT 80
-#define OCPP_URL "ws://echo.websocket.events/"
+#define OCPP_BACKEND_URL   "ws://echo.websocket.events"
+#define OCPP_CHARGE_BOX_ID ""
 
 //
 //  Settings which worked for my SteVe instance:
 //
-//#define OCPP_HOST "my.instance.com"
-//#define OCPP_PORT 80
-//#define OCPP_URL "ws://my.instance.com/steve/websocket/CentralSystemService/esp-charger"
+//#define OCPP_BACKEND_URL   "ws://192.168.178.100:8180/steve/websocket/CentralSystemService"
+//#define OCPP_CHARGE_BOX_ID "esp-charger"
 
 void setup() {
 
@@ -60,7 +58,7 @@ void setup() {
     /*
      * Initialize the OCPP library
      */
-    mocpp_initialize(OCPP_HOST, OCPP_PORT, OCPP_URL, "My Charging Station", "My company name");
+    mocpp_initialize(OCPP_BACKEND_URL, OCPP_CHARGE_BOX_ID, "My Charging Station", "My company name");
 
     /*
      * Integrate OCPP functionality. You can leave out the following part if your EVSE doesn't need it.
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index cc9f9085..262ffb43 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -56,24 +56,90 @@ using namespace MicroOcpp::Facade;
 using namespace MicroOcpp::Ocpp16;
 
 #ifndef MO_CUSTOM_WS
-void mocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_url, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt, const char *login, const char *password, const char *CA_cert, bool autoRecover) {
+void mocpp_initialize(const char *backendUrl, const char *chargeBoxId, const char *chargePointModel, const char *chargePointVendor, FilesystemOpt fsOpt, const char *password, const char *CA_cert, bool autoRecover) {
     if (context) {
         MO_DBG_WARN("already initialized. To reinit, call mocpp_deinitialize() before");
         return;
     }
 
+    if (!backendUrl || !chargePointModel || !chargePointVendor) {
+        MO_DBG_ERR("invalid args");
+        return;
+    }
+
+    if (!chargeBoxId) {
+        chargeBoxId = "";
+    }
+
+    /*
+     * parse backendUrl so that it suits the links2004/arduinoWebSockets interface
+     */
+    std::string url = backendUrl;
+
+    //tolower protocol specifier
+    for (auto c = url.begin(); *c != ':' && c != url.end(); c++) {
+        *c = tolower(*c);
+    }
+
+    bool isTLS = true;
+    if (!strncmp(url.c_str(),"wss://",strlen("wss://"))) {
+        isTLS = true;
+    } else if (!strncmp(url.c_str(),"ws://",strlen("ws://"))) {
+        isTLS = false;
+    } else {
+        MO_DBG_ERR("only ws:// and wss:// supported");
+        return;
+    }
+
+    //parse host, port
+    std::string host_port_path = url.substr(url.find_first_of("://") + strlen("://"));
+    std::string host_port = host_port_path.substr(0, host_port_path.find_first_of('/'));
+    std::string host = host_port.substr(0, host_port.find_first_of(':'));
+    if (host.empty()) {
+        MO_DBG_ERR("could not parse host: %s", url.c_str());
+        return;
+    }
+    uint16_t port = 0;
+    std::string port_str = host_port.substr(host.length());
+    if (port_str.empty()) {
+        port = isTLS ? 443U : 80U;
+    } else {
+        //skip leading ':'
+        port_str = port_str.substr(1);
+        for (auto c = port_str.begin(); c != port_str.end(); c++) {
+            if (*c < '0' || *c > '9') {
+                MO_DBG_ERR("could not parse port: %s", url.c_str());
+                return; 
+            }
+            auto p = port * 10U + (*c - '0');
+            if (p < port) {
+                MO_DBG_ERR("could not parse port (overflow): %s", url.c_str());
+                return;
+            }
+            port = p;
+        }
+    }
+
+    if (url.back() != '/') {
+        url += '/';
+    }
+
+    url += chargeBoxId;
+
+    MO_DBG_INFO("connecting to %s -- (host: %s, port: %u)", url.c_str(), host.c_str(), port);
+
     if (!webSocket)
         webSocket = new WebSocketsClient();
 
-    if (!strncmp(CS_url,"wss",3) || !strncmp(CS_url,"https",5))
+    if (isTLS)
     {
         // server address, port, URL and TLS certificate
-        webSocket->beginSslWithCA(CS_hostname, CS_port, CS_url, CA_cert, "ocpp1.6");
+        webSocket->beginSslWithCA(host.c_str(), port, url.c_str(), CA_cert, "ocpp1.6");
     }
     else
     {
         // server address, port, URL
-        webSocket->begin(CS_hostname, CS_port, CS_url, "ocpp1.6");
+        webSocket->begin(host.c_str(), port, url.c_str(), "ocpp1.6");
     }
 
     // try ever 5000 again if connection has failed
@@ -86,8 +152,8 @@ void mocpp_initialize(const char *CS_hostname, uint16_t CS_port, const char *CS_
     webSocket->enableHeartbeat(15000, 3000, 2); //comment this one out to for specific OCPP servers
 
     // add authentication data (optional)
-    if (login && password && strlen(login) + strlen(password) >= 2) {
-        webSocket->setAuthorization(login, password);
+    if (password && strlen(password) + strlen(chargeBoxId) >= 4) {
+        webSocket->setAuthorization(chargeBoxId, password);
     }
 
     delete connection;
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 44e6939a..7d7685e2 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -36,19 +36,16 @@ using MicroOcpp::OnReceiveErrorListener;
  * https://github.com/matth-x/MicroOcpp/issues/36#issuecomment-989716573 for recommendations on
  * how to track down the issue with the connection.
  * 
- * This is a convenience function only available for Arduino. For a full initialization with TLS,
- * please refer to https://github.com/matth-x/MicroOcpp/tree/master/examples/ESP-TLS
+ * This is a convenience function only available for Arduino.
  */
 void mocpp_initialize(
-            const char *CS_hostname, //e.g. "example.com"
-            uint16_t CS_port,        //e.g. 80
-            const char *CS_url,      //e.g. "ws://example.com/steve/websocket/CentralSystemService/charger001"
+            const char *backendUrl,    //e.g. "wss://example.com:8443/steve/websocket/CentralSystemService"
+            const char *chargeBoxId,   //e.g. "charger001"
             const char *chargePointModel = "Demo Charger",     //model name of this charger
             const char *chargePointVendor = "My Company Ltd.", //brand name
             MicroOcpp::FilesystemOpt fsOpt = MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
-            const char *login = "", //login present in the websocket message header
-            const char *password = "", //password present in the websocket message header
-            const char *CA_cert = NULL, //TLS certificate
+            const char *password = nullptr, //password present in the websocket message header
+            const char *CA_cert = nullptr, //TLS certificate
             bool autoRecover = false); //automatically sanitize the local data store when the lib detects recurring crashes. Not recommended during development
 #endif
 

From 073e70c67a44d20fd1613cd1609c8060b5699e08 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 21 Oct 2023 17:12:06 +0200
Subject: [PATCH 419/549] remove architectures specifier (addresses #206)

---
 library.properties | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/library.properties b/library.properties
index 451b466e..249cdc17 100644
--- a/library.properties
+++ b/library.properties
@@ -2,8 +2,9 @@ name=MicroOcpp
 version=0.3.0
 author=Matthias Akstaller
 maintainer=Matthias Akstaller
-sentence=OCPP 1.6 Client for the ESP8266 and ESP32 (more coming soon)
+sentence=OCPP 1.6 Client for microcontrollers
 paragraph=
 category=Communication
 url=https://github.com/matth-x/MicroOcpp/
-architectures=espressif8266, espressif32
+architectures=*
+depends=ArduinoJson, WebSockets

From ca7f8b609174b9b18c7b2f1d95249fff15f241eb Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 21 Oct 2023 17:13:00 +0200
Subject: [PATCH 420/549] add changelog

---
 CHANGELOG.md      | 52 +++++++++++++++++++++++++++++++++++++++++++++++
 docs/migration.md | 10 ++++++++-
 2 files changed, 61 insertions(+), 1 deletion(-)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..8c3c8101
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,52 @@
+# Changelog
+
+## [1.0.0] - 2023-10-21
+
+_First release._
+
+### Changed
+
+- `mocpp_initialize` takes OCPP URL without explicit host, port ([#220](https://github.com/matth-x/MicroOcpp/pull/220))
+- `endTransaction` checks authorization of `idTag`
+- Update configurations API ([#195](https://github.com/matth-x/MicroOcpp/pull/195))
+- Update Firmware- and DiagnosticsService API ([#207](https://github.com/matth-x/MicroOcpp/pull/207))
+- Update Connection interface
+- Update Authorization module functions ([#213](https://github.com/matth-x/MicroOcpp/pull/213))
+- Reflect changes in C-API
+- Change build flag prefix from `MOCPP_` to `MO_`
+- Change `mo_set_console_out` to `mocpp_set_console_out`
+- Revise README.md
+- Revise misleading debug messages
+- Update Arduino IDE manifest ([#206](https://github.com/matth-x/MicroOcpp/issues/206))
+
+### Added
+
+- Auto-recovery switch in `mocpp_initialize` params
+- WebAssembly port
+- Configurable `MO_PARTITION_LABEL` for the esp-idf SPIFFS integration ([#218](https://github.com/matth-x/MicroOcpp/pull/218))
+- `MO_TX_CLEAN_ABORTED=0` keeps aborted txs in journal
+- `MO_VERSION` specifier
+- `MO_PLATFORM_NONE` for compilation on custom platforms
+- `endTransaction_authorized` enforces the tx end
+- Add valgrind, ASan, UBSan CI/CD steps ([#189](https://github.com/matth-x/MicroOcpp/pull/189))
+
+### Fixed
+
+- Reservation ([#196](https://github.com/matth-x/MicroOcpp/pull/196))
+- Fix immediate FW-update Download phase abort ([#216](https://github.com/matth-x/MicroOcpp/pull/216))
+- `stat` usage on arduino-esp32 LittleFS
+- SetChargingProfile JSON capacity calculation
+- Set correct idTag when Reset triggers StopTx
+- Execute operations only once despite multiple .conf send attempts ([#207](https://github.com/matth-x/MicroOcpp/pull/207))
+- ConnectionTimeOut only applies when connector is still unplugged
+- Fix valgrind warnings
+
+## [1eff6e5] - 23-08-23
+
+_Previous point with breaking changes on master_
+
+Renaming to MicroOcpp is completed since this commit. See the [migration guide](https://matth-x.github.io/MicroOcpp/migration/) for more details on what's changed. Changelogs and semantic versioning are adopted starting with v1.0.0
+
+## [0.3.0] - 23-08-19
+
+_Last version under the project name ArduinoOcpp_
diff --git a/docs/migration.md b/docs/migration.md
index fed7bd10..88a1cf66 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -1,6 +1,10 @@
 # Migrating to v1.0
 
-The API has been continously improved to best suit the common use cases for MicroOcpp. Moreover, the project has been given a new name to prevent confusion with the relation to the Arduino platform and to reflect the project goals properly. With the new project name, the API has been frozen for the v1.0 release. To migrate existing projects, find and replace the keywords in the following.
+The API has been continously improved to best suit the common use cases for MicroOcpp. Moreover, the project has been given a new name to prevent confusion with the relation to the Arduino platform and to reflect the project goals properly. With the new project name, the API has been frozen for the v1.0 release.
+
+## Adopting the new project name in existing projects
+
+Find and replace the keywords in the following.
 
 If using the C-facade (skip if you don't use anything from *ArduinoOcpp_c.h*):
 
@@ -26,4 +30,8 @@ If using the C-facade, change this as the final step:
 
 - `ao_` to `ocpp_`
 
+## Further API changes to consider
+
+In addition to the new project name, the API has also been reworked for more consistency. After renaming the existing project as described above, also take a look at the [changelogs](https://github.com/matth-x/MicroOcpp/blob/1.0.x/CHANGELOG.md) (see Section Changed for v1.0.0).
+
 **If something is missing in this guide, please share the issue here:** [https://github.com/matth-x/MicroOcpp/issues/176](https://github.com/matth-x/MicroOcpp/issues/176)

From 28f9f189c3e7e682f5b50a858b2a3d4acc1849c8 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 21 Oct 2023 20:46:45 +0200
Subject: [PATCH 421/549] make esp-idf SPIFFS base_path on stack

---
 src/MicroOcpp/Core/FilesystemAdapter.cpp | 24 ++++++++++++++----------
 src/MicroOcpp/Core/FilesystemAdapter.h   | 16 ++++++++--------
 2 files changed, 22 insertions(+), 18 deletions(-)

diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index d158f934..2d65e778 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -227,7 +227,6 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 #include <sys/stat.h>
 #include <dirent.h>
-#include <string.h>
 #include "esp_spiffs.h"
 
 #ifndef MO_PARTITION_LABEL
@@ -270,7 +269,7 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
 
     ~EspIdfFilesystemAdapter() {
         if (config.mustMount()) {
-            esp_vfs_spiffs_unregister(MO_PARTITION_LABEL); //partition label
+            esp_vfs_spiffs_unregister(MO_PARTITION_LABEL);
             MO_DBG_DEBUG("SPIFFS unmounted");
         }
     }
@@ -349,19 +348,24 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     if (config.mustMount()) {
         mounted = false;
 
-        char fn_prefix [MO_MAX_PATH_SIZE];
-        auto fn_prefix_len = snprintf(fn_prefix, MO_MAX_PATH_SIZE, "%.*s", ((int) strlen(MO_FILENAME_PREFIX)) - 1, MO_FILENAME_PREFIX);
-        if (fn_prefix_len < 0 || fn_prefix_len >= MO_MAX_PATH_SIZE) {
-            MO_DBG_ERR("MO_FILENAME_PREFIX error %i", fn_prefix_len);
+        char fnpref [MO_MAX_PATH_SIZE];
+        auto fnpref_len = snprintf(fnpref, MO_MAX_PATH_SIZE, "%s", MO_FILENAME_PREFIX);
+        if (fnpref_len < 0 || fnpref_len >= MO_MAX_PATH_SIZE) {
+            MO_DBG_ERR("MO_FILENAME_PREFIX error %i", fnpref_len);
             return nullptr;
-        } else if (fn_prefix_len == 0) {
-            MO_DBG_ERR("MO_FILENAME_PREFIX cannot be root on ESP-IDF");
+        } else if (fnpref_len <= 2) { //shortest possible prefix: "/p/", i.e. length = 3
+            MO_DBG_ERR("MO_FILENAME_PREFIX cannot be root on ESP-IDF (working example: \"/mo_store/\")");
             return nullptr;
         }
 
+        // trim trailing '/'
+        if (fnpref[fnpref_len - 1] == '/') {
+            fnpref[fnpref_len - 1] = '\0';
+        }
+
         esp_vfs_spiffs_conf_t conf = {
-            .base_path = (MO_FILENAME_PREFIX[0] == '/' && MO_FILENAME_PREFIX[1] == '\0') ? MO_FILENAME_PREFIX : (MO_FILENAME_PREFIX[strlen(MO_FILENAME_PREFIX) - 1] == '/' ? strndup(MO_FILENAME_PREFIX, strlen(MO_FILENAME_PREFIX) - 1) : MO_FILENAME_PREFIX),
-            .partition_label = MO_PARTITION_LABEL, //also see deconstructor
+            .base_path = fnpref,
+            .partition_label = MO_PARTITION_LABEL,
             .max_files = 5,
             .format_if_mount_failed = config.formatOnFail()
         };
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.h b/src/MicroOcpp/Core/FilesystemAdapter.h
index 70b3cea2..3cb6c70c 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.h
+++ b/src/MicroOcpp/Core/FilesystemAdapter.h
@@ -11,14 +11,6 @@
 #include <MicroOcpp/Platform.h>
 #include <MicroOcpp/Core/ConfigurationOptions.h>
 
-#ifndef MO_FILENAME_PREFIX
-#define MO_FILENAME_PREFIX "/"
-#endif
-
-#ifndef MOCPP_PARTITION_LABEL
-#define MOCPP_PARTITION_LABEL "mo"
-#endif
-
 #define DISABLE_FS       0
 #define ARDUINO_LITTLEFS 1
 #define ARDUINO_SPIFFS   2
@@ -42,6 +34,14 @@
 #endif //switch-case MO_PLATFORM
 #endif //ndef MO_USE_FILEAPI
 
+#ifndef MO_FILENAME_PREFIX
+#if MO_USE_FILEAPI == ESPIDF_SPIFFS
+#define MO_FILENAME_PREFIX "/mo_store/"
+#else
+#define MO_FILENAME_PREFIX "/"
+#endif
+#endif
+
 // set default max path size parameters
 #ifndef MO_MAX_PATH_SIZE
 #if MO_USE_FILEAPI == POSIX_FILEAPI

From 540d20f50f81863b6463019a8f9a3006e55d8537 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 21 Oct 2023 21:15:05 +0200
Subject: [PATCH 422/549] track MO_VERSION on flash

---
 src/MicroOcpp.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 262ffb43..666d7c3f 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -232,6 +232,8 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
 
     configuration_init(filesystem); //call before each other library call
 
+    declareConfiguration<const char*>("MicroOcppVersion", MO_VERSION, MO_KEYVALUE_FN, false, false, false);
+
     context = new Context(connection, filesystem, bootstats.bootNr);
     auto& model = context->getModel();
 

From d57a04842748e2ac361f6921789142e9411058fc Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 22 Oct 2023 18:00:00 +0200
Subject: [PATCH 423/549] fix tracking MO_VERSION

---
 src/MicroOcpp.cpp | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 666d7c3f..6498bf10 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -232,8 +232,6 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
 
     configuration_init(filesystem); //call before each other library call
 
-    declareConfiguration<const char*>("MicroOcppVersion", MO_VERSION, MO_KEYVALUE_FN, false, false, false);
-
     context = new Context(connection, filesystem, bootstats.bootNr);
     auto& model = context->getModel();
 
@@ -286,8 +284,11 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     }
     credsJson.reset();
 
+    auto mocppVersion = declareConfiguration<const char*>("MicroOcppVersion", MO_VERSION, MO_KEYVALUE_FN, false, false, false);
+
     configuration_load();
 
+    mocppVersion->setString(MO_VERSION);
     MO_DBG_INFO("initialized MicroOcpp v" MO_VERSION);
 }
 

From 1a32fe7f7e34c04ec581b282fa4be9321c8c0646 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 22 Oct 2023 18:19:02 +0200
Subject: [PATCH 424/549] fix sendReq, ReqHandler usage example (fixes #204)

---
 src/MicroOcpp.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 7d7685e2..db672b35 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -408,7 +408,7 @@ void setOnSendConf(const char *operationType, OnSendConfListener onSendConf);
  *     //will be called to create the request once this operation is being sent out
  *     size_t capacity = JSON_OBJECT_SIZE(4); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
  *     auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity)); 
- *     JsonObject request = *res;
+ *     JsonObject request = res->to<JsonObject>();
  *     request["connectorId"] = 1;
  *     request["idTag"] = "A9C3CE1D7B71EA";
  *     request["meterStart"] = 1234;
@@ -447,7 +447,7 @@ void sendRequest(const char *operationType,
  *     size_t capacity = JSON_OBJECT_SIZE(2) +
  *                       JSON_OBJECT_SIZE(1); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
  *     auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity)); 
- *     JsonObject response = *res;
+ *     JsonObject response = res->to<JsonObject>();
  *     response["status"] = "Accepted";
  *     response["data"]["max_energy"] = 59;
  *     return res;

From 5ba1e972b7bcc3ed7b78876de18644ce4ad50794 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 22 Oct 2023 18:20:24 +0200
Subject: [PATCH 425/549] fix superfluous insert '/' between url and cbid

---
 src/MicroOcpp.cpp | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 6498bf10..25b1e1c9 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -120,11 +120,13 @@ void mocpp_initialize(const char *backendUrl, const char *chargeBoxId, const cha
         }
     }
 
-    if (url.back() != '/') {
-        url += '/';
-    }
+    if ((!*chargeBoxId) == '\0') {
+        if (url.back() != '/') {
+            url += '/';
+        }
 
-    url += chargeBoxId;
+        url += chargeBoxId;
+    }
 
     MO_DBG_INFO("connecting to %s -- (host: %s, port: %u)", url.c_str(), host.c_str(), port);
 

From 0ae20b608eb7ddb154b984d578ca3a0afe173a86 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 22 Oct 2023 18:56:13 +0200
Subject: [PATCH 426/549] fix -Wextra

---
 .github/workflows/platformless.yml            |  2 +-
 .../Model/Metering/MeteringConnector.cpp      |  2 +-
 .../Operations/ChangeConfiguration.cpp        | 19 -------------------
 src/MicroOcpp/Operations/ReserveNow.cpp       |  2 +-
 4 files changed, 3 insertions(+), 22 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 1e461d48..ce5251a2 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -26,4 +26,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++14 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DMO_PLATFORM=MO_PLATFORM_NONE -Wall
+      run: g++ -c -std=c++11 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DMO_PLATFORM=MO_PLATFORM_NONE -Wall -Wextra -Wno-unused-parameter -Werror
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index fb84a24a..1f126161 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -59,7 +59,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
     if ((txBreak || meterData.size() >= (size_t) meterValueCacheSizeInt->getInt()) && !meterData.empty()) {
         auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(std::move(meterData), connectorId, transaction));
         meterData.clear();
-        return std::move(meterValues);
+        return meterValues;
     }
 
     if (model.getConnector(connectorId)) {
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
index 16f0b029..57d84dbf 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
@@ -6,7 +6,6 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Debug.h>
 
-#include <cmath> //for isnan check
 #include <cctype> //for tolower
 
 using MicroOcpp::Ocpp16::ChangeConfiguration;
@@ -57,13 +56,10 @@ void ChangeConfiguration::processReq(JsonObject payload) {
 
     bool convertibleInt = true;
     int numInt = 0;
-    bool convertibleFloat = true;
-    float numFloat = 0.f;
     bool convertibleBool = true;
     bool numBool = false;
 
     int nDigits = 0, nNonDigits = 0, nDots = 0, nSign = 0; //"-1.234" has 4 digits, 0 nonDigits, 1 dot and 1 sign. Don't allow comma as seperator. Don't allow e-expressions (e.g. 1.23e-7)
-    float numFloatTranslate = 1.f;
     for (const char *c = value; *c; ++c) {
         if (*c >= '0' && *c <= '9') {
             //int interpretation
@@ -72,13 +68,6 @@ void ChangeConfiguration::processReq(JsonObject payload) {
                 numInt *= 10;
                 numInt += *c - '0';
             }
-
-            //float interpretation
-            numFloat *= 10.f;
-            numFloat += (float) (*c - '0');
-            if (nDots != 0) {
-                numFloatTranslate *= 10.f;
-            }
         } else if (*c == '.') {
             nDots++;
         } else if (c == value && *c == '-') {
@@ -88,11 +77,8 @@ void ChangeConfiguration::processReq(JsonObject payload) {
         }
     }
 
-    numFloat /= numFloatTranslate; // "1." <-- numFlTrans = 1.f; "-1.234" <-- numFlTrans = 1000.f
-
     if (nSign == 1) {
         numInt = -numInt;
-        numFloat *= -1.f;
     }
 
     int INT_MAXDIGITS; //plausibility check: this allows a numerical range of (-999,999,999 to 999,999,999), or (-9,999 to 9,999) respectively
@@ -103,7 +89,6 @@ void ChangeConfiguration::processReq(JsonObject payload) {
 
     if (nNonDigits > 0 || nDigits == 0 || nSign > 1 || nDots > 1) {
         convertibleInt = false;
-        convertibleFloat = false;
     }
 
     if (nDigits > INT_MAXDIGITS) {
@@ -111,10 +96,6 @@ void ChangeConfiguration::processReq(JsonObject payload) {
         convertibleInt = false;
     }
 
-    if (std::isnan(numFloat)) {
-        convertibleFloat = false;
-    }
-
     if (tolower(value[0]) == 't' && tolower(value[1]) == 'r' && tolower(value[2]) == 'u' && tolower(value[3]) == 'e' && !value[4]) {
         numBool = true;
     } else if (tolower(value[0]) == 'f' && tolower(value[1]) == 'a' && tolower(value[2]) == 'l' && tolower(value[3]) == 's' && tolower(value[4]) == 'e' && !value[5]) {
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index 6dab67ae..1a64391f 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -34,7 +34,7 @@ void ReserveNow::processReq(JsonObject payload) {
     }
 
     int connectorId = payload["connectorId"] | -1;
-    if (connectorId < 0 || connectorId >= model.getNumConnectors()) {
+    if (connectorId < 0 || (unsigned int) connectorId >= model.getNumConnectors()) {
         errorCode = "PropertyConstraintViolation";
         return;
     }

From fc34e11857a9dfeb421af7b43acd5c61f88faf55 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 22 Oct 2023 19:23:34 +0200
Subject: [PATCH 427/549] clean up

---
 README.md            |   2 +-
 docs/img/favicon.ico | Bin 0 -> 2355 bytes
 docs/img/favicon.png | Bin 9687 -> 0 bytes
 library.json         |  13 +++++++------
 mkdocs.yml           |   2 +-
 platformio.ini       |   2 ++
 src/MicroOcpp.cpp    |   4 +++-
 7 files changed, 14 insertions(+), 9 deletions(-)
 create mode 100644 docs/img/favicon.ico
 delete mode 100644 docs/img/favicon.png

diff --git a/README.md b/README.md
index 8e2df168..9f93699c 100644
--- a/README.md
+++ b/README.md
@@ -67,7 +67,7 @@ If compiled with the Arduino integration:
 
 - [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (version `2.4.1`)
 
-In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/ArduinoOcpp@0.3.0` in the PIO library manager.
+In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp@1.0.0` in the PIO library manager.
 
 ## OCPP 2.0.1 and ISO 15118
 
diff --git a/docs/img/favicon.ico b/docs/img/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..42096b5f0a096bf9e74e5eb1d7aab00e1ebbb1de
GIT binary patch
literal 2355
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
Z_#db?KH50Cy?Ouu002ovPDHLkV1iO@W(@!U

literal 0
HcmV?d00001

diff --git a/docs/img/favicon.png b/docs/img/favicon.png
deleted file mode 100644
index 87b3df3c42ed752833850693a273e069e1987ba3..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 9687
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
Z|35Z%iW2p-)ieMA002ovPDHLkV1o0>c(MQh

diff --git a/library.json b/library.json
index f6a1613c..26eb1694 100644
--- a/library.json
+++ b/library.json
@@ -1,8 +1,8 @@
 {
     "name": "MicroOcpp",
     "version": "0.3.0",
-    "description": "OCPP 1.6 Client for the ESP8266 and ESP32",
-    "keywords": "OCPP, 1.6, OCPP 1.6, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, EVSE, Charge Point",
+    "description": "OCPP 1.6 Client for microcontrollers",
+    "keywords": "OCPP, 1.6, OCPP 1.6, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, esp-idf, EVSE, Charge Point",
     "repository":
     {
         "type": "git",
@@ -12,12 +12,12 @@
     [
       {
         "name": "Matthias Akstaller",
-        "url": "https://www.arduino-ocpp.com",
+        "url": "https://www.micro-ocpp.com",
         "maintainer": true
       }
     ],
     "license": "MIT",
-    "homepage": "https://www.arduino-ocpp.com",
+    "homepage": "https://www.micro-ocpp.com",
     "dependencies": [
         {
             "owner": "bblanchon",
@@ -30,7 +30,7 @@
             "version": "2.4.1"
         }
       ],
-    "frameworks": "arduino",
+    "frameworks": "arduino,espidf",
     "platforms": "espressif8266, espressif32",
 
     "export": {
@@ -44,7 +44,8 @@
             "README.md",
             "CMakeLists.txt",
             "docs/*",
-            "LICENSE"
+            "LICENSE",
+            "CHANGELOG.md"
         ]
     },
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 2f047d41..60c415fa 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -42,7 +42,7 @@ theme:
   font:
     text: Roboto
     code: Roboto Mono
-  favicon: img/favicon.png
+  favicon: img/favicon.ico
   icon:
     logo: logo
 
diff --git a/platformio.ini b/platformio.ini
index 55258120..9e02cd14 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -34,3 +34,5 @@ build_flags =
     -DMO_TRAFFIC_OUT   ; print the OCPP communication to the serial monitor
 board_build.partitions = min_spiffs.csv
 upload_speed = 921600
+monitor_filters =
+    esp32_exception_decoder
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 25b1e1c9..7d23f5a3 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -290,7 +290,9 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
 
     configuration_load();
 
-    mocppVersion->setString(MO_VERSION);
+    if (mocppVersion) {
+        mocppVersion->setString(MO_VERSION);
+    }
     MO_DBG_INFO("initialized MicroOcpp v" MO_VERSION);
 }
 

From eed22a0841b77a6e59ae756c223283b5b39b4517 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 22 Oct 2023 19:34:12 +0200
Subject: [PATCH 428/549] advance version to v1.0.0

---
 CHANGELOG.md            | 4 ++--
 library.json            | 3 ++-
 library.properties      | 2 +-
 src/MicroOcpp/Version.h | 2 +-
 4 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8c3c8101..363068c3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,8 @@
 # Changelog
 
-## [1.0.0] - 2023-10-21
+## [1.0.0] - 2023-10-22
 
-_First release._
+_First release_
 
 ### Changed
 
diff --git a/library.json b/library.json
index 26eb1694..37b51377 100644
--- a/library.json
+++ b/library.json
@@ -1,6 +1,6 @@
 {
     "name": "MicroOcpp",
-    "version": "0.3.0",
+    "version": "1.0.0",
     "description": "OCPP 1.6 Client for microcontrollers",
     "keywords": "OCPP, 1.6, OCPP 1.6, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, esp-idf, EVSE, Charge Point",
     "repository":
@@ -45,6 +45,7 @@
             "CMakeLists.txt",
             "docs/*",
             "LICENSE",
+            "mkdocs.yml",
             "CHANGELOG.md"
         ]
     },
diff --git a/library.properties b/library.properties
index 249cdc17..b9c4637e 100644
--- a/library.properties
+++ b/library.properties
@@ -1,5 +1,5 @@
 name=MicroOcpp
-version=0.3.0
+version=1.0.0
 author=Matthias Akstaller
 maintainer=Matthias Akstaller
 sentence=OCPP 1.6 Client for microcontrollers
diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
index 93da866a..d4604681 100644
--- a/src/MicroOcpp/Version.h
+++ b/src/MicroOcpp/Version.h
@@ -1 +1 @@
-#define MO_VERSION "0.4.0"
+#define MO_VERSION "1.0.0"

From f4cc612f931119f259e2c09d9d21d01e18bd4f7f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 22 Oct 2023 19:55:48 +0200
Subject: [PATCH 429/549] fix compilation on espressif8266

---
 .github/workflows/platformless.yml                 | 2 +-
 src/MicroOcpp/Model/Metering/MeteringConnector.cpp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index ce5251a2..9682e919 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -26,4 +26,4 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.19.4/ArduinoJson-v6.19.4.h -O ./src/ArduinoJson.h
     - name: Compile
-      run: g++ -c -std=c++11 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DMO_PLATFORM=MO_PLATFORM_NONE -Wall -Wextra -Wno-unused-parameter -Werror
+      run: g++ -c -std=c++11 -I ./src $(find ./src -type f -iregex ".*\.cpp") -DMO_PLATFORM=MO_PLATFORM_NONE -Wall -Wextra -Wno-unused-parameter -Wno-redundant-move -Werror
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index 1f126161..fb84a24a 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -59,7 +59,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
     if ((txBreak || meterData.size() >= (size_t) meterValueCacheSizeInt->getInt()) && !meterData.empty()) {
         auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(std::move(meterData), connectorId, transaction));
         meterData.clear();
-        return meterValues;
+        return std::move(meterValues);
     }
 
     if (model.getConnector(connectorId)) {

From cf532c41d541efdde1b9f4a95963f2661b49ea70 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 22 Oct 2023 20:11:55 +0200
Subject: [PATCH 430/549] update PIO registry link

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9f93699c..16cff5d2 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ In practical setups, the execution time is largely determined by IO delays and t
 
 ## Developers guide
 
-PlatformIO package: [ArduinoOcpp](https://platformio.org/lib/show/11975/ArduinoOcpp)
+PlatformIO package: [MicroOcpp](https://registry.platformio.org/libraries/matth-x/MicroOcpp)
 
 MicroOcpp is an implementation of the OCPP communication behavior. It automatically initiates the corresponding OCPP operations once the hardware status changes or the RFID input is updated with a new value. Conversely it processes new data from the server, stores it locally and updates the hardware controls when applicable.
 

From b99b8218a34d589fbc9f0bc1c2b2e6415149190e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 28 Oct 2023 20:29:27 +0200
Subject: [PATCH 431/549] set custom console null check (fixes #224)

---
 src/MicroOcpp/Platform.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Platform.cpp b/src/MicroOcpp/Platform.cpp
index 113f451b..5d85ea7e 100644
--- a/src/MicroOcpp/Platform.cpp
+++ b/src/MicroOcpp/Platform.cpp
@@ -18,7 +18,9 @@ void MicroOcpp::mocpp_console_out(const char *msg) {
 
 void mocpp_set_console_out(void (*console_out)(const char *msg)) {
     MicroOcpp::mocpp_console_out_impl = console_out;
-    console_out("[OCPP] console initialized\n");
+    if (console_out) {
+        console_out("[OCPP] console initialized\n");
+    }
 }
 
 #endif

From 8744bd00e92f7fac1de3c2b49c6fdce5af49a87b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 28 Oct 2023 20:37:23 +0200
Subject: [PATCH 432/549] add #224 to changelog

---
 CHANGELOG.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 363068c3..68538993 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## [Unreleased]
+
+### Fixed
+
+- Allow `nullptr` as parameter for `mocpp_set_console_out` ([#224](https://github.com/matth-x/MicroOcpp/issues/224))
+
 ## [1.0.0] - 2023-10-22
 
 _First release_

From 8657db0b91afb4ca8dfb208164b099dc161f6c7c Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 12 Dec 2023 21:16:13 +0100
Subject: [PATCH 433/549] update docs

---
 README.md          | 16 ++--------------
 docs/intro-tech.md |  2 ++
 docs/security.md   |  3 ++-
 3 files changed, 6 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index 16cff5d2..0e38191b 100644
--- a/README.md
+++ b/README.md
@@ -71,21 +71,9 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 
 ## OCPP 2.0.1 and ISO 15118
 
-**The call for funding for the OCPP 2.0.1 upgrade is open.** The version 1.6 support has successfully been funded by private companies who share an interest in using this technology. OCPP is most often seen as a non-differentiating feature of chargers and is therefore perfectly suited for Open Source collaboration. If your company needs OCPP 2.0.1, please use the contact details at the end of this page to receive the more details about the funding plan and why it is beneficial to engage in the upgrade (for hardware manufacturers and CPOs).
+MicroOcpp will be upgraded to OCPP 2.0.1 soon. The API has already been prepared for transitioning between both versions, so an integration of the current library version will also be functional with the 2.0.1 upgrade.
 
-MicroOcpp is a good foundation for starting the OCPP 2.0.1 development:
-
-:tada: Tested by hundreds, including backend operators. The [Simulator](https://github.com/matth-x/MicroOcppSimulator) encourages quick compatibility tests
-
-:hammer: Comes with development tools and a CI/CD specialized for OCPP
-
-:man_teacher: Academic background: roots in a research project
-
-:closed_lock_with_key: Unit tests with valgrind, AddressSanitizer and UndefinedBehaviorSanitizer
-
-:heart: Contributions are highly welcome. Open to building a team
-
-A note on ISO 15118: this library facilitates the integration of ISO 15118 by handling its OCPP-side communication. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
+ISO 15118 defines some use cases which include a message exchange between the charger and server. This library facilitates the integration of ISO 15118 by handling its OCPP-side communication. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
 
 ## Contact details
 
diff --git a/docs/intro-tech.md b/docs/intro-tech.md
index 60648074..451e5ac9 100644
--- a/docs/intro-tech.md
+++ b/docs/intro-tech.md
@@ -80,4 +80,6 @@ Because of the high importance of C in the embedded world, MicroOcpp provides it
 
 While memory constraints are of concern, the execution time generally is not. OCPP is rather uncomplex on the algorithmic side for clients, since there is no need for elaborate planning algorithms or complex data transformations.
 
+Low resource requirements also allow new usage areas on top of EV charging. For example, MicroOcpp has been ported to ordinary IoT equipment such as Wi-Fi sockets to integrate further electric devices into OCPP networks.
+
 Although MicroOcpp is optimized for the usage on microcontrollers, it is also suitable for embedded Linux systems. With more memory available, the upper limits of the internal data structures can be increased, leading to a more versatile support of charging use cases. Also, the separation of the charger firmware into multiple processes can lead to more robustness. MicroOcpp can be extended by an inter-process communication (IPC) interface to run in a separate process.
diff --git a/docs/security.md b/docs/security.md
index 8875b455..0537436a 100644
--- a/docs/security.md
+++ b/docs/security.md
@@ -25,8 +25,9 @@ To address the challenges, the following measures were taken:
 
 Two further measures would be beneficial and could be requested via support request:
 
-- OCPP fuzzer: as a stateful application protocol, there are specific challenges of developing a fuzzer. An open source fuzzing framework for OCPP could reveal vulnerabilities and be of use for other OCPP projects as well
 - Precautious memory allocation: migrating memory management to the stack and where possible would simplify code analysis and reduce the potential of vulnerabilities
+- OCPP fuzzer: as a stateful application protocol, there are specific challenges of developing a fuzzer. An open source fuzzing framework for OCPP could reveal vulnerabilities and be of use for other OCPP projects as well. MicroOcpp is a good foundation for trying new fuzzing approaches. The exposure of the main-loop function and the clock allow a fine-grained access to the program flow and facilitating random alterations of the environment conditions. Furthermore, all persistent data is stored in the JSON format and it is possible to develop a grammatic which contains both a device status and incoming OCPP messages. The Configuration interface could be reused for further status variables which don't need to be persistent in practice, but would improve fuzzing performance when being accessible by the fuzzer.
+- Memory pool: object orientation is a very helpful programming paradigm for OCPP. The standard contains a lot of polymorphic entities and optional or variable length data fields. MicroOcpp makes use of the heap and allocates new chunks of memory as the device model is populated with data. On the upside this allows to save a lot of memory during normal operation, but it also entails the risk of memory depletion of the whole controller. A fixed memory pool for OCPP would encapsulate the heap usage to a certain address space and set a hard limit for the memory consumption and avoid polluting the shared heap area by heap fragmentation. To realize the memory pool, it would be necessary to make the allocate and deallocate functions configurable by the client code. Then appropriate (de)allocators can be injected limiting the memory use to a restricted address area. As a consequence, a more thorough allocation error handling in the MicroOcpp code is required and test cases which randomly suppress allocations to test if the library always reverts to a consistent state. A less invasive alternative to memory pools is to inject measured (de)allocators which just prevent the allocation of new memory chunks after a certain threshold has been exceeded. This programming technique would also allow to create much more fine-grained benchmarks of the library.
 
 ## Measures to be taken by the EVSE vendor
 

From e9f631a74d37a08dffd79b65493ba57e4bac20e2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 14 Dec 2023 21:31:14 +0100
Subject: [PATCH 434/549] fix mocpp_tick_ms() on esp-idf integer overflow

---
 src/MicroOcpp/Platform.cpp | 23 +++++++++++++++++++++--
 src/MicroOcpp/Platform.h   |  5 ++---
 2 files changed, 23 insertions(+), 5 deletions(-)

diff --git a/src/MicroOcpp/Platform.cpp b/src/MicroOcpp/Platform.cpp
index 5d85ea7e..9430488b 100644
--- a/src/MicroOcpp/Platform.cpp
+++ b/src/MicroOcpp/Platform.cpp
@@ -39,9 +39,27 @@ unsigned long mocpp_tick_ms_custom() {
         return 0;
     }
 }
-#endif
+#else
+
+#if MO_PLATFORM == MO_PLATFORM_ESPIDF
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+
+namespace MicroOcpp {
+
+decltype(xTaskGetTickCount()) mocpp_ticks_count = 0;
+unsigned long mocpp_millis_count = 0;
 
-#if MO_PLATFORM == MO_PLATFORM_UNIX
+}
+
+unsigned long mocpp_tick_ms_espidf() {
+    auto ticks_now = xTaskGetTickCount();
+    MicroOcpp::mocpp_millis_count += ((ticks_now - MicroOcpp::mocpp_ticks_count) * 1000UL) / configTICK_RATE_HZ;
+    MicroOcpp::mocpp_ticks_count = ticks_now;
+    return MicroOcpp::mocpp_millis_count;
+}
+
+#elif MO_PLATFORM == MO_PLATFORM_UNIX
 #include <chrono>
 
 namespace MicroOcpp {
@@ -61,6 +79,7 @@ unsigned long mocpp_tick_ms_unix() {
     return (unsigned long) ms.count();
 }
 #endif
+#endif
 
 #if MO_PLATFORM != MO_PLATFORM_ARDUINO
 void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target){
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index f0c14942..220c20d3 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -86,9 +86,8 @@ unsigned long mocpp_tick_ms_custom();
 #include <Arduino.h>
 #define mocpp_tick_ms millis
 #elif MO_PLATFORM == MO_PLATFORM_ESPIDF
-#include "freertos/FreeRTOS.h"
-#include "freertos/task.h"
-#define mocpp_tick_ms(X) ((xTaskGetTickCount() * 1000UL) / configTICK_RATE_HZ)
+unsigned long mocpp_tick_ms_espidf();
+#define mocpp_tick_ms mocpp_tick_ms_espidf
 #elif MO_PLATFORM == MO_PLATFORM_UNIX
 unsigned long mocpp_tick_ms_unix();
 #define mocpp_tick_ms mocpp_tick_ms_unix

From a1939abeb7b49faffd755be5ca523c729f0679d7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 14 Dec 2023 21:40:54 +0100
Subject: [PATCH 435/549] add mocpp_tick_ms() fix to changelog

---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 68538993..fc560e3c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,7 @@
 ### Fixed
 
 - Allow `nullptr` as parameter for `mocpp_set_console_out` ([#224](https://github.com/matth-x/MicroOcpp/issues/224))
+- Fix `mocpp_tick_ms()` on esp-idf roll-over after 12 hours
 
 ## [1.0.0] - 2023-10-22
 

From 735efa29805d33723d80cd351e4ca773b0d96a3e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 28 Dec 2023 11:41:29 +0100
Subject: [PATCH 436/549] declare ESP32/8266 updater as demo (#242)

---
 src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 6258d148..709d524a 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -327,6 +327,8 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 
     fwService->setOnInstall([fwService] (const char *location) {
 
+        MO_DBG_WARN("Built-in updater for ESP32 is only intended for demonstration purposes. HTTP support only");
+
         fwService->setInstallationStatusInput([](){return InstallationStatus::NotInstalled;});
 
         WiFiClient client;
@@ -372,6 +374,8 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 
     fwService->setOnInstall([fwService] (const char *location) {
         
+        MO_DBG_WARN("Built-in updater for ESP8266 is only intended for demonstration purposes. HTTP support only");
+
         WiFiClient client;
         //WiFiClientSecure client;
         //client.setCACert(rootCACertificate);

From 12d4868200d9675d98ff81b9c226e5deace64c12 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 14 Jan 2024 20:55:44 +0100
Subject: [PATCH 437/549] pin ArduinoJson to v6.x (fixes #245)

---
 .github/workflows/esp-idf.yml         | 1 +
 CHANGELOG.md                          | 1 +
 README.md                             | 2 +-
 examples/ESP-IDF/README.md            | 4 +++-
 examples/ESP-IDF/components/README.md | 2 +-
 5 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
index 90043470..f0f756cb 100644
--- a/.github/workflows/esp-idf.yml
+++ b/.github/workflows/esp-idf.yml
@@ -40,6 +40,7 @@ jobs:
       uses: actions/checkout@v3
       with:
         repository: bblanchon/ArduinoJson
+        ref: 3e1be980d93e47b2a0073efeeb9a9396fd7a83be
         path: examples/ESP-IDF/components/ArduinoJson
     - name: esp-idf build
       uses: espressif/esp-idf-ci-action@v1
diff --git a/CHANGELOG.md b/CHANGELOG.md
index fc560e3c..6984baf0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@
 
 - Allow `nullptr` as parameter for `mocpp_set_console_out` ([#224](https://github.com/matth-x/MicroOcpp/issues/224))
 - Fix `mocpp_tick_ms()` on esp-idf roll-over after 12 hours
+- Pin ArduinoJson to v6.21 ([#245](https://github.com/matth-x/MicroOcpp/issues/245))
 
 ## [1.0.0] - 2023-10-22
 
diff --git a/README.md b/README.md
index 0e38191b..fad7a2fd 100644
--- a/README.md
+++ b/README.md
@@ -61,7 +61,7 @@ Please take `examples/ESP/main.cpp` as the starting point for the first project.
 
 Mandatory:
 
-- [bblanchon/ArduinoJSON](https://github.com/bblanchon/ArduinoJson)
+- [bblanchon/ArduinoJSON](https://github.com/bblanchon/ArduinoJson) (version `6.21`)
 
 If compiled with the Arduino integration:
 
diff --git a/examples/ESP-IDF/README.md b/examples/ESP-IDF/README.md
index 702e21ae..7b6a8df0 100644
--- a/examples/ESP-IDF/README.md
+++ b/examples/ESP-IDF/README.md
@@ -11,7 +11,7 @@ Please clone the following repositories into the respective components-directori
 - [MicroOcpp](https://github.com/matth-x/MicroOcpp) into `components/MicroOcpp`
 - [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf) into `components/mongoose`
 - [Mongoose adapter for MicroOcpp](https://github.com/matth-x/MicroOcppMongoose) into `components/MicroOcppMongoose`
-- [ArduinoJson](https://github.com/bblanchon/ArduinoJson) into `components/ArduinoJson`
+- [ArduinoJson (v6.21)](https://github.com/bblanchon/ArduinoJson) into `components/ArduinoJson`
 
 For setup, the following commands could come handy (change to the root directory of the ESP-IDF project first):
 
@@ -24,6 +24,8 @@ git clone https://github.com/matth-x/MicroOcpp components/MicroOcpp
 git clone --recurse-submodules https://github.com/cesanta/mongoose-esp-idf.git components/mongoose
 git clone https://github.com/matth-x/MicroOcppMongoose components/MicroOcppMongoose
 git clone https://github.com/bblanchon/ArduinoJson components/ArduinoJson
+cd components/ArduinoJson
+git checkout 3e1be980d93e47b2a0073efeeb9a9396fd7a83be
 ```
 
 The setup is done if the following include statements work:
diff --git a/examples/ESP-IDF/components/README.md b/examples/ESP-IDF/components/README.md
index 67d997d3..b4acfa92 100644
--- a/examples/ESP-IDF/components/README.md
+++ b/examples/ESP-IDF/components/README.md
@@ -5,6 +5,6 @@ The ESP-IDF integration requires at least the following components:
 - [MicroOcpp](https://github.com/matth-x/MicroOcpp)
 - [Mongoose (ESP-IDF integration)](https://github.com/cesanta/mongoose-esp-idf)
 - [Mongoose adapter for MicroOcpp](https://github.com/matth-x/MicroOcppMongoose)
-- [ArduinoJson](https://github.com/bblanchon/ArduinoJson)
+- [ArduinoJson (v6.21)](https://github.com/bblanchon/ArduinoJson)
 
 This example only provides the folder structure. You need to clone every project into it in order to run the example.

From dc2cdaa502de383c8666f9049fc5ab9aa5350e86 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 17 Feb 2024 20:21:07 +0100
Subject: [PATCH 438/549] Smart Charging module fixes (#260)

---
 CHANGELOG.md                                          |  1 +
 .../Model/SmartCharging/SmartChargingModel.cpp        |  5 +++++
 .../Model/SmartCharging/SmartChargingService.cpp      |  4 ++--
 src/MicroOcpp/Operations/SetChargingProfile.cpp       | 11 ++++++++++-
 4 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6984baf0..453ff535 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,7 @@
 - Allow `nullptr` as parameter for `mocpp_set_console_out` ([#224](https://github.com/matth-x/MicroOcpp/issues/224))
 - Fix `mocpp_tick_ms()` on esp-idf roll-over after 12 hours
 - Pin ArduinoJson to v6.21 ([#245](https://github.com/matth-x/MicroOcpp/issues/245))
+- Fix bounds checking in SmartCharging module ([#260](https://github.com/matth-x/MicroOcpp/pull/260))
 
 ## [1.0.0] - 2023-10-22
 
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
index e8355f61..e64068d1 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -480,6 +480,11 @@ bool MicroOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
         return false;
     }
 
+    if (periodJsonArray.size() > CHARGINGSCHEDULEMAXPERIODS) {
+        MO_DBG_WARN("exceed ChargingScheduleMaxPeriods");
+        return false;
+    }
+
     for (JsonObject periodJson : periodJsonArray) {
         out.chargingSchedulePeriod.push_back(ChargingSchedulePeriod());
         if (!loadChargingSchedulePeriod(periodJson, out.chargingSchedulePeriod.back())) {
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index a3c6be08..b41b8e48 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -274,10 +274,10 @@ std::unique_ptr<ChargingSchedule> SmartChargingConnector::getCompositeSchedule(i
 size_t SmartChargingConnector::getChargingProfilesCount() {
     size_t chargingProfilesCount = 0;
     for (size_t i = 0; i < CHARGEPROFILEMAXSTACKLEVEL + 1; i++) {
-        if (ChargePointTxDefaultProfile[i]) {
+        if (TxDefaultProfile[i]) {
             chargingProfilesCount++;
         }
-        if (ChargePointMaxProfile[i]) {
+        if (TxProfile[i]) {
             chargingProfilesCount++;
         }
     }
diff --git a/src/MicroOcpp/Operations/SetChargingProfile.cpp b/src/MicroOcpp/Operations/SetChargingProfile.cpp
index 14b47605..92e54a6d 100644
--- a/src/MicroOcpp/Operations/SetChargingProfile.cpp
+++ b/src/MicroOcpp/Operations/SetChargingProfile.cpp
@@ -57,12 +57,21 @@ void SetChargingProfile::processReq(JsonObject payload) {
             errorCode = "PropertyConstraintViolation";
             return;
         }
-        if (!connector->getTransaction() || !connector->getTransaction()->isRunning()) {
+
+        auto& transaction = connector->getTransaction();
+        if (!transaction || !connector->getTransaction()->isRunning()) {
             //no transaction running, reject profile
             accepted = false;
             return;
         }
 
+        if (chargingProfile->getTransactionId() < 0 ||
+                chargingProfile->getTransactionId() != transaction->getTransactionId()) {
+            //transactionId undefined / mismatch
+            accepted = false;
+            return;
+        }
+
         //seems good
     } else if (chargingProfile->getChargingProfilePurpose() == ChargingProfilePurposeType::ChargePointMaxProfile) {
         if (connectorId > 0) {

From bbf984a99f02c26cd427cb5fbd242c5feb2eaf08 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 27 Feb 2024 19:13:11 +0100
Subject: [PATCH 439/549] Certificate Management, UCs M03 - M05 (#262)

---
 CHANGELOG.md                                  |   8 +
 CMakeLists.txt                                |  18 +
 README.md                                     |   4 +
 src/MicroOcpp.cpp                             |  19 +-
 src/MicroOcpp.h                               |   4 +-
 .../Model/Certificates/Certificate.cpp        |  40 ++
 .../Model/Certificates/Certificate.h          | 105 +++++
 .../Model/Certificates/CertificateMbedTLS.cpp | 437 ++++++++++++++++++
 .../Model/Certificates/CertificateMbedTLS.h   |  64 +++
 .../Model/Certificates/CertificateService.cpp |  22 +
 .../Model/Certificates/CertificateService.h   |  34 ++
 .../Model/Certificates/Certificate_c.cpp      | 227 +++++++++
 .../Model/Certificates/Certificate_c.h        | 111 +++++
 src/MicroOcpp/Model/Model.cpp                 |  10 +
 src/MicroOcpp/Model/Model.h                   |   5 +
 .../Operations/DeleteCertificate.cpp          |  91 ++++
 src/MicroOcpp/Operations/DeleteCertificate.h  |  32 ++
 .../Operations/GetInstalledCertificateIds.cpp | 105 +++++
 .../Operations/GetInstalledCertificateIds.h   |  34 ++
 .../Operations/InstallCertificate.cpp         |  75 +++
 src/MicroOcpp/Operations/InstallCertificate.h |  32 ++
 src/MicroOcpp/Version.h                       |   2 +-
 src/MicroOcpp_c.cpp                           |  14 +-
 src/MicroOcpp_c.h                             |   4 +-
 tests/Certificates.cpp                        | 244 ++++++++++
 tests/LocalAuthList.cpp                       |   6 +-
 26 files changed, 1737 insertions(+), 10 deletions(-)
 create mode 100644 src/MicroOcpp/Model/Certificates/Certificate.cpp
 create mode 100644 src/MicroOcpp/Model/Certificates/Certificate.h
 create mode 100644 src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
 create mode 100644 src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
 create mode 100644 src/MicroOcpp/Model/Certificates/CertificateService.cpp
 create mode 100644 src/MicroOcpp/Model/Certificates/CertificateService.h
 create mode 100644 src/MicroOcpp/Model/Certificates/Certificate_c.cpp
 create mode 100644 src/MicroOcpp/Model/Certificates/Certificate_c.h
 create mode 100644 src/MicroOcpp/Operations/DeleteCertificate.cpp
 create mode 100644 src/MicroOcpp/Operations/DeleteCertificate.h
 create mode 100644 src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
 create mode 100644 src/MicroOcpp/Operations/GetInstalledCertificateIds.h
 create mode 100644 src/MicroOcpp/Operations/InstallCertificate.cpp
 create mode 100644 src/MicroOcpp/Operations/InstallCertificate.h
 create mode 100644 tests/Certificates.cpp

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 453ff535..7d64aca3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+### Added
+
+- Operation GetInstalledCertificateIds, UC M03 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
+- Operation DeleteCertificate, UC M04 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
+- Operation InstallCertificate, UC M05 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
+
+## [1.1.0] - 2024-02-27
+
 ### Fixed
 
 - Allow `nullptr` as parameter for `mocpp_set_console_out` ([#224](https://github.com/matth-x/MicroOcpp/issues/224))
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 95810e11..d5b66fee 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -4,6 +4,7 @@
 
 cmake_minimum_required(VERSION 3.15)
 
+set(CMAKE_CXX_STANDARD 11)
 
 set(MO_SRC
     src/MicroOcpp/Core/Configuration.cpp
@@ -30,11 +31,13 @@ set(MO_SRC
     src/MicroOcpp/Operations/ClearChargingProfile.cpp
     src/MicroOcpp/Operations/CustomOperation.cpp
     src/MicroOcpp/Operations/DataTransfer.cpp
+    src/MicroOcpp/Operations/DeleteCertificate.cpp
     src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
     src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
     src/MicroOcpp/Operations/GetCompositeSchedule.cpp
     src/MicroOcpp/Operations/GetConfiguration.cpp
     src/MicroOcpp/Operations/GetDiagnostics.cpp
+    src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
     src/MicroOcpp/Operations/GetLocalListVersion.cpp
     src/MicroOcpp/Operations/Heartbeat.cpp
     src/MicroOcpp/Operations/MeterValues.cpp
@@ -48,6 +51,7 @@ set(MO_SRC
     src/MicroOcpp/Operations/StatusNotification.cpp
     src/MicroOcpp/Operations/StopTransaction.cpp
     src/MicroOcpp/Operations/TriggerMessage.cpp
+    src/MicroOcpp/Operations/InstallCertificate.cpp
     src/MicroOcpp/Operations/UnlockConnector.cpp
     src/MicroOcpp/Operations/UpdateFirmware.cpp
     src/MicroOcpp/Platform.cpp
@@ -57,6 +61,10 @@ set(MO_SRC
     src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
     src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
     src/MicroOcpp/Model/Boot/BootService.cpp
+    src/MicroOcpp/Model/Certificates/Certificate.cpp
+    src/MicroOcpp/Model/Certificates/Certificate_c.cpp
+    src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
+    src/MicroOcpp/Model/Certificates/CertificateService.cpp
     src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
     src/MicroOcpp/Model/ConnectorBase/Connector.cpp
     src/MicroOcpp/Model/ConnectorBase/Notification.cpp
@@ -127,6 +135,7 @@ set(MO_SRC_UNIT
     tests/Configuration.cpp
     tests/Reservation.cpp
     tests/LocalAuthList.cpp
+    #tests/Certificates.cpp # add if MbedTLS is available
 )
 
 add_executable(mo_unit_tests
@@ -135,6 +144,14 @@ add_executable(mo_unit_tests
     ./tests/catch2/catchMain.cpp
 )
 
+# add MbedTLS for testing (TODO integrate properly into build system)
+#add_subdirectory(lib/mbedtls)
+#target_link_libraries(mo_unit_tests PUBLIC 
+#    mbedtls
+#    mbedcrypto
+#    mbedx509
+#)
+
 target_include_directories(mo_unit_tests PUBLIC
     "./tests/catch2"
     "./tests/helpers"
@@ -153,6 +170,7 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_FILENAME_PREFIX="./mo_store/"
     MO_LocalAuthListMaxLength=8
     MO_SendLocalListMaxLength=4
+    #MO_ENABLE_MBEDTLS=1
 )
 
 target_compile_options(mo_unit_tests PUBLIC
diff --git a/README.md b/README.md
index fad7a2fd..89d7d434 100644
--- a/README.md
+++ b/README.md
@@ -67,6 +67,10 @@ If compiled with the Arduino integration:
 
 - [Links2004/arduinoWebSockets](https://github.com/Links2004/arduinoWebSockets) (version `2.4.1`)
 
+If using the built-in certificate store (to enable, set build flag `MO_ENABLE_MBEDTLS=1`):
+
+- [Mbed-TLS/mbedtls](https://github.com/Mbed-TLS/mbedtls) (version `2.28.1`)
+
 In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp@1.0.0` in the PIO library manager.
 
 ## OCPP 2.0.1 and ISO 15118
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 7d23f5a3..b1490fd2 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -17,6 +17,8 @@
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Model/Boot/BootService.h>
 #include <MicroOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Model/Certificates/CertificateService.h>
+#include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h> //default CertStore implementation depends on MbedTLS
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
@@ -199,7 +201,7 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
     }
 }
 
-void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs, bool autoRecover) {
+void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs, bool autoRecover, std::unique_ptr<CertificateStore> certStore) {
     if (context) {
         MO_DBG_WARN("already initialized. To reinit, call mocpp_deinitialize() before");
         return;
@@ -257,6 +259,21 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     model.setResetService(std::unique_ptr<ResetService>(
         new ResetService(*context)));
 
+    std::unique_ptr<CertificateStore> certStoreUse;
+    if (certStore) {
+        certStoreUse = std::move(certStore);
+    }
+#if MO_ENABLE_MBEDTLS
+    else {
+        certStoreUse = makeCertificateStoreMbedTLS(filesystem);
+    }
+#endif
+
+    if (certStoreUse) {
+        model.setCertificateService(std::unique_ptr<CertificateService>(
+            new CertificateService(*context, std::move(certStoreUse))));
+    }
+
 #if !defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
         EspWiFi::makeFirmwareService(*context))); //instantiate FW service + ESP installation routine
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index db672b35..f821d7ed 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -18,6 +18,7 @@
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
+#include <MicroOcpp/Model/Certificates/Certificate.h>
 
 using MicroOcpp::OnReceiveConfListener;
 using MicroOcpp::OnReceiveReqListener;
@@ -93,7 +94,8 @@ void mocpp_initialize(
             const char *bootNotificationCredentials = ChargerCredentials("Demo Charger", "My Company Ltd."), //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             std::shared_ptr<MicroOcpp::FilesystemAdapter> filesystem =
                 MicroOcpp::makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail), //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
-            bool autoRecover = false); //automatically sanitize the local data store when the lib detects recurring crashes. Not recommended during development
+            bool autoRecover = false, //automatically sanitize the local data store when the lib detects recurring crashes. Not recommended during development
+            std::unique_ptr<MicroOcpp::CertificateStore> certStore = nullptr); //optionally use custom Cert Store (default depends on MbedTLS)
 
 /*
  * Stop the OCPP library and release allocated resources.
diff --git a/src/MicroOcpp/Model/Certificates/Certificate.cpp b/src/MicroOcpp/Model/Certificates/Certificate.cpp
new file mode 100644
index 00000000..3caa9dd6
--- /dev/null
+++ b/src/MicroOcpp/Model/Certificates/Certificate.cpp
@@ -0,0 +1,40 @@
+#include <MicroOcpp/Model/Certificates/Certificate.h>
+
+#include <string.h>
+
+#include <MicroOcpp/Debug.h>
+
+using namespace MicroOcpp;
+
+const char *CertificateHash::getHashAlgorithmCStr() {
+    switch(hashAlgorithm) {
+        case HashAlgorithmEnumType::SHA256:
+            return "SHA256";
+        case HashAlgorithmEnumType::SHA384:
+            return "SHA384";
+        case HashAlgorithmEnumType::SHA512:
+            return "SHA512";
+    }
+
+    MO_DBG_ERR("internal error");
+    return "";
+}
+
+const char *CertificateHash::getIssuerNameHash() {
+    return issuerNameHash;
+}
+
+const char *CertificateHash::getIssuerKeyHash() {
+    return issuerKeyHash;
+}
+
+const char *CertificateHash::getSerialNumber() {
+    return serialNumber;
+}
+
+bool CertificateHash::equals(const CertificateHash& other) {
+    return hashAlgorithm == other.hashAlgorithm &&
+            !strncmp(serialNumber, other.serialNumber, sizeof(serialNumber)) &&
+            !strncmp(issuerNameHash, other.issuerNameHash, sizeof(issuerNameHash)) &&
+            !strncmp(issuerKeyHash, other.issuerKeyHash, sizeof(issuerKeyHash));
+}
diff --git a/src/MicroOcpp/Model/Certificates/Certificate.h b/src/MicroOcpp/Model/Certificates/Certificate.h
new file mode 100644
index 00000000..6dcf0cc6
--- /dev/null
+++ b/src/MicroOcpp/Model/Certificates/Certificate.h
@@ -0,0 +1,105 @@
+#ifndef MO_CERTIFICATE_H
+#define MO_CERTIFICATE_H
+
+#include <vector>
+#include <stdint.h>
+
+namespace MicroOcpp {
+
+#define MO_MAX_CERT_SIZE 5500 //limit of field `certificate` in InstallCertificateRequest, not counting terminating '\0'. See OCPP 2.0.1 part 2 Data Type 1.30.1
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.36
+ */
+enum class GetCertificateIdType : uint8_t {
+    V2GRootCertificate,
+    MORootCertificate,
+    CSMSRootCertificate,
+    V2GCertificateChain,
+    ManufacturerRootCertificate
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.40
+ */
+enum class GetInstalledCertificateStatus : uint8_t {
+    Accepted,
+    NotFound
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.45
+ */
+enum class InstallCertificateType : uint8_t {
+    V2GRootCertificate,
+    MORootCertificate,
+    CSMSRootCertificate,
+    ManufacturerRootCertificate
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.28
+ */
+enum class InstallCertificateStatus : uint8_t {
+    Accepted,
+    Rejected,
+    Failed
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.28
+ */
+enum class DeleteCertificateStatus : uint8_t {
+    Accepted,
+    Failed,
+    NotFound
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.42
+ */
+enum class HashAlgorithmEnumType : uint8_t {
+    SHA256,
+    SHA384,
+    SHA512
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 2.6
+ */
+struct CertificateHash {
+    HashAlgorithmEnumType hashAlgorithm;
+    char issuerNameHash [128 + 1];
+    char issuerKeyHash [128 + 1];
+    char serialNumber [40 + 1];
+
+    const char *getHashAlgorithmCStr();
+    const char *getIssuerNameHash();
+    const char *getIssuerKeyHash();
+    const char *getSerialNumber();
+
+    bool equals(const CertificateHash& other);
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 2.5
+ */
+struct CertificateChainHash {
+    GetCertificateIdType certificateType;
+    CertificateHash certificateHashData;
+    std::vector<CertificateHash> childCertificateHashData;
+};
+
+/*
+ * Interface which allows MicroOcpp to interact with the certificates managed by the local TLS library
+ */
+class CertificateStore {
+public:
+    virtual GetInstalledCertificateStatus getCertificateIds(GetCertificateIdType certificateType, std::vector<CertificateChainHash>& out) = 0;
+    virtual DeleteCertificateStatus deleteCertificate(const CertificateHash& hash) = 0;
+    virtual InstallCertificateStatus installCertificate(InstallCertificateType certificateType, const char *certificate) = 0;
+};
+
+} //namespace MicroOcpp
+
+#endif
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
new file mode 100644
index 00000000..a20cb0f4
--- /dev/null
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
@@ -0,0 +1,437 @@
+#include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h>
+
+#if MO_ENABLE_MBEDTLS
+
+#include <string.h>
+
+#include <mbedtls/version.h>
+#include <mbedtls/x509_crt.h>
+#include <mbedtls/md.h>
+#include <mbedtls/oid.h>
+#include <mbedtls/error.h>
+
+#include <MicroOcpp/Debug.h>
+
+#define MO_X509_OID_COMMON_NAME "2.5.4.3" //object-identifier of x509 common-name
+
+bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmEnumType_c hashAlg, char *issuerNameHash, char *issuerKeyHash, char *serialNumber) {
+
+    mbedtls_x509_crt cacert;
+    mbedtls_x509_crt_init(&cacert);
+
+    int ret;
+
+    if((ret = mbedtls_x509_crt_parse(&cacert, buf, len + 1)) < 0) {
+        char err [100];
+        mbedtls_strerror(ret, err, 100);
+        MO_DBG_ERR("mbedtls_x509_crt_parse: %i -- %s", ret, err);
+        return false;
+    }
+
+    if (cacert.next) {
+        MO_DBG_ERR("only sole root certs supported");
+        return false;
+    }
+
+    const unsigned char *subject_cn_p = nullptr;
+    size_t subject_cn_len = 0;
+    for (mbedtls_x509_name *it = &cacert.subject; it; it = it->next) {
+        char oid_cstr [50];
+        if ((ret = mbedtls_oid_get_numeric_string(oid_cstr, 50, &it->oid)) < 0) {
+            MO_DBG_ERR("internal error: %i", ret);
+            continue; //there is an oid which exceeds the bufsize, but the target oid does fit so continue
+        }
+
+        if (!strcmp(oid_cstr, MO_X509_OID_COMMON_NAME)) {
+            subject_cn_p = it->val.p;
+            subject_cn_len = it->val.len;
+            break;
+        }
+    }
+
+    if (!subject_cn_p || !subject_cn_len) {
+        MO_DBG_ERR("could not find subject common name");
+        return false;
+    }
+
+    const unsigned char *issuer_cn_p = nullptr;
+    size_t issuer_cn_len = 0;
+    for (mbedtls_x509_name *it = &cacert.issuer; it; it = it->next) {
+        char oid_cstr [50];
+        if ((ret = mbedtls_oid_get_numeric_string(oid_cstr, 50, &it->oid)) < 0) {
+            MO_DBG_ERR("internal error: %i", ret);
+            continue; //there is an oid which exceeds the bufsize, but the target oid does fit so continue
+        }
+
+        if (!strcmp(oid_cstr, MO_X509_OID_COMMON_NAME)) {
+            issuer_cn_p = it->val.p;
+            issuer_cn_len = it->val.len;
+            break;
+        }
+    }
+
+    if (!issuer_cn_p || !issuer_cn_len) {
+        MO_DBG_ERR("could not find issuer common name");
+        return false;
+    }
+
+    if (subject_cn_len != issuer_cn_len || strncmp((const char*) subject_cn_p, (const char*) issuer_cn_p, subject_cn_len)) {
+        MO_DBG_ERR("only support self-signed root certs");
+        return false;
+    }
+    
+    mbedtls_md_type_t hash_alg_mbed;
+
+    switch (hashAlg) {
+        case HashAlgorithmEnumType_c::ENUM_HA_SHA256:
+            hash_alg_mbed = MBEDTLS_MD_SHA256;
+            break;
+        case HashAlgorithmEnumType_c::ENUM_HA_SHA384:
+            hash_alg_mbed = MBEDTLS_MD_SHA384;
+            break;
+        case HashAlgorithmEnumType_c::ENUM_HA_SHA512:
+            hash_alg_mbed = MBEDTLS_MD_SHA512;
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            return false;
+    }
+
+    const mbedtls_md_info_t *md_info;
+
+    md_info = mbedtls_md_info_from_type(hash_alg_mbed);
+    if (!md_info) {
+        MO_DBG_ERR("hash algorithmus not supported");
+        return false;
+    }
+
+    unsigned char hash_buf [64]; //at most 512 Bits (SHA512), equalling 64 Bytes
+
+    size_t hash_size = mbedtls_md_get_size(md_info);
+    if (hash_size > sizeof(hash_buf)) {
+        MO_DBG_ERR("internal error");
+        return false;
+    }
+
+    if ((ret = mbedtls_md(md_info, issuer_cn_p, issuer_cn_len, hash_buf))) {
+        MO_DBG_ERR("mbedtls_md: %i", ret);
+        return false;
+    }
+
+    for (size_t i = 0; i < hash_size; i ++) {
+        sprintf(issuerNameHash + 2 * i, "%02X", hash_buf[i]);
+    }
+
+    unsigned char *pk_p;
+    size_t pk_len;
+
+#if MBEDTLS_VERSION_MAJOR == 2 && MBEDTLS_VERSION_MINOR <= 16
+    unsigned char pk_buf [256];
+    if ((ret = mbedtls_pk_write_pubkey_pem(&cacert.pk, pk_buf, 256)) < 0) {
+        MO_DBG_ERR("mbedtls_md: %i", ret);
+        return false;
+    }
+    pk_p = pk_buf;
+    pk_len = strnlen((const char*)pk_buf, 256);
+#else //tested on MbedTLS 2.28.1
+    pk_p = cacert.pk_raw.p;
+    pk_len = cacert.pk_raw.len;
+#endif // MbedTLS version
+
+    if ((ret = mbedtls_md(md_info, pk_p, pk_len, hash_buf))) {
+        MO_DBG_ERR("mbedtls_md: %i", ret);
+        return false;
+    }
+
+    for (size_t i = 0; i < hash_size; i ++) {
+        sprintf(issuerKeyHash + 2*i, "%02X", hash_buf[i]);
+    }
+
+    size_t serial_begin = 0; //trunicate leftmost 0x00 bytes
+    for (; serial_begin < cacert.serial.len - 1; serial_begin++) { //keep at least 1 byte, even if 0x00
+        if (cacert.serial.p[serial_begin] != 0) {
+            break;
+        }
+    }
+
+    for (size_t i = 0; i < std::min(cacert.serial.len - serial_begin, (size_t) ((MO_CERT_HASH_SERIAL_NUMBER_SIZE - 1)/2)); i++) {
+        sprintf(serialNumber + 2*i, "%02X", cacert.serial.p[i + serial_begin]);
+    }
+
+    return true;
+}
+
+namespace MicroOcpp {
+
+class CertificateStoreMbedTLS : public CertificateStore {
+private:
+    std::shared_ptr<FilesystemAdapter> filesystem;
+
+    bool getCertHash(const char *fn, HashAlgorithmEnumType hashAlg, CertificateHash& out) {
+        size_t fsize;
+        if (filesystem->stat(fn, &fsize) != 0) {
+            MO_DBG_ERR("certificate does not exist: %s", fn);
+            return false;
+        }
+
+        if (fsize >= MO_MAX_CERT_SIZE) {
+            MO_DBG_ERR("cert file exceeds limit: %s,  %zuB", fn, fsize);
+            return false;
+        }
+
+        auto file = filesystem->open(fn, "r");
+        if (!file) {
+            MO_DBG_ERR("could not open file: %s", fn);
+            return false;
+        }
+
+        unsigned char *buf = new unsigned char[fsize + 1];
+        if (!buf) {
+            MO_DBG_ERR("OOM");
+            return false;
+        }
+
+        bool success = true;
+
+        size_t ret;
+        if ((ret = file->read((char*) buf, fsize)) != fsize) {
+            MO_DBG_ERR("read error: %zu (expect %zu)", ret, fsize);
+            success = false;
+        }
+
+        buf[fsize] = '\0';
+
+        if (success) {
+            success &= getCertHash(buf, fsize, hashAlg, out);
+        }
+
+        if (!success) {
+            MO_DBG_ERR("could not read cert: %s", fn);
+            (void)0;
+        }
+
+        delete[] buf;
+        return success;
+    }
+
+    bool getCertHash(const unsigned char *buf, size_t len, HashAlgorithmEnumType hashAlg, CertificateHash& out) {
+        
+        HashAlgorithmEnumType_c ha;
+
+        switch (hashAlg) {
+            case HashAlgorithmEnumType::SHA256:
+                ha = ENUM_HA_SHA256;
+                break;
+            case HashAlgorithmEnumType::SHA384:
+                ha = ENUM_HA_SHA384;
+                break;
+            case HashAlgorithmEnumType::SHA512:
+                ha = ENUM_HA_SHA512;
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                return false;
+        }
+
+        out.hashAlgorithm = hashAlg;
+        return ocpp_get_cert_hash(buf, len, ha, out.issuerNameHash, out.issuerKeyHash, out.serialNumber);
+    }
+public:
+    CertificateStoreMbedTLS(std::shared_ptr<FilesystemAdapter> filesystem)
+            : filesystem(filesystem) {
+
+    }
+
+    GetInstalledCertificateStatus getCertificateIds(GetCertificateIdType certificateType, std::vector<CertificateChainHash>& out) override {
+        const char *certTypeFnStr = nullptr;
+        switch (certificateType) {
+            case GetCertificateIdType::CSMSRootCertificate:
+                certTypeFnStr = MO_CERT_FN_CSMS_ROOT;
+                break;
+            case GetCertificateIdType::ManufacturerRootCertificate:
+                certTypeFnStr = MO_CERT_FN_MANUFACTURER_ROOT;
+                break;
+            default:
+                MO_DBG_ERR("only CSMS / Manufacturer root supported");
+                break;
+        }
+
+        if (!certTypeFnStr) {
+            return GetInstalledCertificateStatus::NotFound;
+        }
+
+        out.clear();
+
+        for (size_t i = 0; i < MO_CERT_STORE_SIZE; i++) {
+            char fn [MO_MAX_PATH_SIZE];
+            if (!printCertFn(certTypeFnStr, i, fn, MO_MAX_PATH_SIZE)) {
+                MO_DBG_ERR("internal error");
+                return GetInstalledCertificateStatus::NotFound;
+            }
+
+            size_t msize;
+            if (filesystem->stat(fn, &msize) != 0) {
+                continue; //no cert installed at this slot
+            }
+
+            out.emplace_back();
+            CertificateChainHash& rootCert = out.back();
+
+            rootCert.certificateType = certificateType;
+
+            if (!getCertHash(fn, HashAlgorithmEnumType::SHA256, rootCert.certificateHashData)) {
+                MO_DBG_ERR("could not create hash: %s", fn);
+                out.pop_back();
+                continue;
+            }
+        }
+
+        return out.empty() ?
+                GetInstalledCertificateStatus::NotFound :
+                GetInstalledCertificateStatus::Accepted;
+    }
+
+    DeleteCertificateStatus deleteCertificate(const CertificateHash& hash) override {
+        bool err = false;
+
+        //enumerate all certs possibly installed by this CertStore implementation
+        for (const char *certTypeFnStr : {MO_CERT_FN_CSMS_ROOT, MO_CERT_FN_MANUFACTURER_ROOT}) {
+            for (size_t i = 0; i < MO_CERT_STORE_SIZE; i++) {
+
+                char fn [MO_MAX_PATH_SIZE] = {'\0'}; //cert fn on flash storage
+
+                if (!printCertFn(certTypeFnStr, i, fn, MO_MAX_PATH_SIZE)) {
+                    MO_DBG_ERR("internal error");
+                    return DeleteCertificateStatus::Failed;
+                }
+
+                size_t msize;
+                if (filesystem->stat(fn, &msize) != 0) {
+                    continue; //no cert installed at this slot
+                }
+
+                CertificateHash probe;
+                if (!getCertHash(fn, hash.hashAlgorithm, probe)) {
+                    MO_DBG_ERR("could not create hash: %s", fn);
+                    err = true;
+                    continue;
+                }
+
+                if (probe.equals(hash)) {
+                    //found, delete
+
+                    bool success = filesystem->remove(fn);
+                    return success ?
+                        DeleteCertificateStatus::Accepted :
+                        DeleteCertificateStatus::Failed;
+                }
+            }
+        }
+
+        return err ?
+            DeleteCertificateStatus::Failed :
+            DeleteCertificateStatus::NotFound;
+    }
+
+    InstallCertificateStatus installCertificate(InstallCertificateType certificateType, const char *certificate) override {
+        const char *certTypeFnStr = nullptr;
+        switch (certificateType) {
+            case InstallCertificateType::CSMSRootCertificate:
+                certTypeFnStr = MO_CERT_FN_CSMS_ROOT;
+                break;
+            case InstallCertificateType::ManufacturerRootCertificate:
+                certTypeFnStr = MO_CERT_FN_MANUFACTURER_ROOT;
+                break;
+            default:
+                MO_DBG_ERR("only CSMS / Manufacturer root supported");
+                break;
+        }
+
+        if (!certTypeFnStr) {
+            return InstallCertificateStatus::Failed;
+        }
+
+        //check if this implementation is able to parse incoming cert
+        {
+            CertificateHash certId;
+            if (!getCertHash((const unsigned char*)certificate, strlen(certificate), HashAlgorithmEnumType::SHA256, certId)) {
+                MO_DBG_ERR("unable to parse cert");
+                return InstallCertificateStatus::Rejected;
+            }
+            MO_DBG_DEBUG("Cert ID:");
+            MO_DBG_DEBUG("hashAlgorithm: %s", certId.getHashAlgorithmCStr());
+            MO_DBG_DEBUG("issuerNameHash: %s", certId.issuerNameHash);
+            MO_DBG_DEBUG("issuerKeyHash: %s", certId.issuerKeyHash);
+            MO_DBG_DEBUG("serialNumber: %s", certId.serialNumber);
+        }
+
+        char fn [MO_MAX_PATH_SIZE] = {'\0'}; //cert fn on flash storage
+
+        //check for free cert slot
+        for (size_t i = 0; i < MO_CERT_STORE_SIZE; i++) {
+            if (!printCertFn(certTypeFnStr, i, fn, MO_MAX_PATH_SIZE)) {
+                MO_DBG_ERR("invalid cert fn");
+                return InstallCertificateStatus::Failed;
+            }
+
+            size_t msize;
+            if (filesystem->stat(fn, &msize) != 0) {
+                //found free slot; fn contains result
+                break;
+            } else {
+                //this slot is already occupied; invalidate fn and try next
+                fn[0] = '\0';
+            }
+        }
+
+        if (fn[0] == '\0') {
+            MO_DBG_ERR("exceed maximum number of certs; must delete before");
+            return InstallCertificateStatus::Rejected;
+        }
+
+        auto file = filesystem->open(fn, "w");
+        if (!file) {
+            MO_DBG_ERR("could not open file");
+            return InstallCertificateStatus::Failed;
+        }
+
+        size_t cert_len = strlen(certificate);
+        auto written = file->write(certificate, cert_len);
+        if (written < cert_len) {
+            MO_DBG_ERR("file write error");
+            file.reset();
+            filesystem->remove(fn);
+            return InstallCertificateStatus::Failed;
+        }
+
+        MO_DBG_INFO("installed certificate: %s", fn);
+        return InstallCertificateStatus::Accepted;
+    }
+};
+
+std::unique_ptr<CertificateStore> makeCertificateStoreMbedTLS(std::shared_ptr<FilesystemAdapter> filesystem) {
+    if (!filesystem) {
+        MO_DBG_WARN("default Certificate Store requires FS");
+        return nullptr;
+    }
+    return std::unique_ptr<CertificateStore>(new CertificateStoreMbedTLS(filesystem));
+}
+
+bool printCertFn(const char *certType, size_t index, char *buf, size_t bufsize) {
+    if (!certType || !*certType || index >= MO_CERT_STORE_SIZE || !buf) {
+        MO_DBG_ERR("invalid args");
+        return false;
+    }
+
+    auto ret = snprintf(buf, bufsize, MO_FILENAME_PREFIX MO_CERT_FN_PREFIX "%s" "-%zu" MO_CERT_FN_SUFFIX,
+            certType, index);
+    if (ret < 0 || ret >= (int)bufsize) {
+        MO_DBG_ERR("fn error: %i", ret);
+        return false;
+    }
+    return true;
+}
+
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_MBEDTLS
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
new file mode 100644
index 00000000..f06b4c2c
--- /dev/null
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
@@ -0,0 +1,64 @@
+#ifndef MO_CERTIFICATE_MBEDTLS_H
+#define MO_CERTIFICATE_MBEDTLS_H
+
+/*
+ * Built-in implementation of the Certificate interface for MbedTLS
+ */
+
+#ifndef MO_ENABLE_MBEDTLS
+#define MO_ENABLE_MBEDTLS 0
+#endif
+
+#if MO_ENABLE_MBEDTLS
+
+/*
+ * Provide certificate interpreter to facilitate cert store in C. A full implementation is only available for C++
+ */
+#include <MicroOcpp/Model/Certificates/Certificate_c.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+bool ocpp_get_cert_hash(const unsigned char *cert, size_t len, enum HashAlgorithmEnumType_c hashAlg, ocpp_certificate_hash *out);
+
+#ifdef __cplusplus
+} //extern "C"
+
+#include <memory>
+
+#include <MicroOcpp/Model/Certificates/Certificate.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+
+#ifndef MO_CERT_FN_PREFIX
+#define MO_CERT_FN_PREFIX "cert-"
+#endif
+
+#ifndef MO_CERT_FN_SUFFIX
+#define MO_CERT_FN_SUFFIX ".pem"
+#endif
+
+#ifndef MO_CERT_FN_CSMS_ROOT
+#define MO_CERT_FN_CSMS_ROOT "csms"
+#endif
+
+#ifndef MO_CERT_FN_MANUFACTURER_ROOT
+#define MO_CERT_FN_MANUFACTURER_ROOT "mfact"
+#endif
+
+#ifndef MO_CERT_STORE_SIZE
+#define MO_CERT_STORE_SIZE 3 //max number of certs per certificate type (e.g. CSMS root CA, Manufacturer root CA)
+#endif
+
+namespace MicroOcpp {
+
+std::unique_ptr<CertificateStore> makeCertificateStoreMbedTLS(std::shared_ptr<FilesystemAdapter> filesystem);
+
+bool printCertFn(const char *certType, size_t index, char *buf, size_t bufsize);
+
+} //namespace MicroOcpp
+
+#endif //def __cplusplus
+#endif //MO_ENABLE_MBEDTLS
+
+#endif
diff --git a/src/MicroOcpp/Model/Certificates/CertificateService.cpp b/src/MicroOcpp/Model/Certificates/CertificateService.cpp
new file mode 100644
index 00000000..57f502f7
--- /dev/null
+++ b/src/MicroOcpp/Model/Certificates/CertificateService.cpp
@@ -0,0 +1,22 @@
+#include <MicroOcpp/Model/Certificates/CertificateService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Operations/DeleteCertificate.h>
+#include <MicroOcpp/Operations/GetInstalledCertificateIds.h>
+#include <MicroOcpp/Operations/InstallCertificate.h>
+
+using namespace MicroOcpp;
+
+CertificateService::CertificateService(Context& context, std::unique_ptr<CertificateStore> certStore)
+        : context(context), certStore(std::move(certStore)) {
+
+    context.getOperationRegistry().registerOperation("DeleteCertificate", [this] () {
+        return new Ocpp201::DeleteCertificate(*this);});
+    context.getOperationRegistry().registerOperation("GetInstalledCertificateIds", [this] () {
+        return new Ocpp201::GetInstalledCertificateIds(*this);});
+    context.getOperationRegistry().registerOperation("InstallCertificate", [this] () {
+        return new Ocpp201::InstallCertificate(*this);});
+}
+
+CertificateStore *CertificateService::getCertificateStore() {
+    return certStore.get();
+}
diff --git a/src/MicroOcpp/Model/Certificates/CertificateService.h b/src/MicroOcpp/Model/Certificates/CertificateService.h
new file mode 100644
index 00000000..ce9b1e64
--- /dev/null
+++ b/src/MicroOcpp/Model/Certificates/CertificateService.h
@@ -0,0 +1,34 @@
+/*
+ * Functional Block M: ISO 15118 Certificate Management
+ *
+ * Implementation of UC:
+ *     - M03
+ *     - M04
+ *     - M05
+ */
+
+#ifndef MO_CERTIFICATESERVICE_H
+#define MO_CERTIFICATESERVICE_H
+
+#include <functional>
+#include <memory>
+
+#include <MicroOcpp/Model/Certificates/Certificate.h>
+
+namespace MicroOcpp {
+
+class Context;
+
+class CertificateService {
+private:
+    Context& context;
+    std::unique_ptr<CertificateStore> certStore;
+public:
+    CertificateService(Context& context, std::unique_ptr<CertificateStore> certStore);
+
+    CertificateStore *getCertificateStore();
+};
+
+}
+
+#endif
diff --git a/src/MicroOcpp/Model/Certificates/Certificate_c.cpp b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
new file mode 100644
index 00000000..285d0078
--- /dev/null
+++ b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
@@ -0,0 +1,227 @@
+#include <MicroOcpp/Model/Certificates/Certificate_c.h>
+#include <MicroOcpp/Debug.h>
+
+namespace MicroOcpp {
+
+/*
+ * C++ wrapper for the C-style certificate interface
+ */
+class CertificateStoreC : public CertificateStore {
+private:
+    ocpp_certificate_store *certstore = nullptr;
+public:
+    CertificateStoreC(ocpp_certificate_store *certstore) : certstore(certstore) {
+
+    }
+
+    ~CertificateStoreC() = default;
+
+    GetInstalledCertificateStatus getCertificateIds(GetCertificateIdType certificateType, std::vector<CertificateChainHash>& out) override {
+        GetCertificateIdType_c ct_c;
+        switch (certificateType) {
+            case GetCertificateIdType::V2GRootCertificate:
+                ct_c = ENUM_GCI_V2GRootCertificate;
+                break;
+            case GetCertificateIdType::MORootCertificate:
+                ct_c = ENUM_GCI_MORootCertificate;
+                break;
+            case GetCertificateIdType::CSMSRootCertificate:
+                ct_c = ENUM_GCI_CSMSRootCertificate;
+                break;
+            case GetCertificateIdType::V2GCertificateChain:
+                ct_c = ENUM_GCI_V2GCertificateChain;
+                break;
+            case GetCertificateIdType::ManufacturerRootCertificate:
+                ct_c = ENUM_GCI_ManufacturerRootCertificate;
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                return GetInstalledCertificateStatus::NotFound;
+        }
+
+        ocpp_certificate_chain_hash *cch;
+
+        auto ret = certstore->getCertificateIds(certstore->user_data, ct_c, &cch);
+        if (ret == ENUM_GICS_NotFound || !cch) {
+            return GetInstalledCertificateStatus::NotFound;
+        }
+
+        bool err = false;
+        
+        for (ocpp_certificate_chain_hash *it = cch; it && !err; it = it->next) {
+            out.emplace_back();
+            auto &chd_el = out.back();
+            switch (it->certificateType) {
+                case ENUM_GCI_V2GRootCertificate:
+                    chd_el.certificateType = GetCertificateIdType::V2GRootCertificate;
+                    break;
+                case ENUM_GCI_MORootCertificate:
+                    chd_el.certificateType = GetCertificateIdType::MORootCertificate;
+                    break;
+                case ENUM_GCI_CSMSRootCertificate:
+                    chd_el.certificateType = GetCertificateIdType::CSMSRootCertificate;
+                    break;
+                case ENUM_GCI_V2GCertificateChain:
+                    chd_el.certificateType = GetCertificateIdType::V2GCertificateChain;
+                    break;
+                case ENUM_GCI_ManufacturerRootCertificate:
+                    chd_el.certificateType = GetCertificateIdType::ManufacturerRootCertificate;
+                    break;
+                default:
+                    MO_DBG_ERR("internal error");
+                    err = true;
+                    break;
+            }
+
+            switch (it->certificateHashData.hashAlgorithm) {
+                case ENUM_HA_SHA256:
+                    chd_el.certificateHashData.hashAlgorithm = HashAlgorithmEnumType::SHA256;
+                    break;
+                case ENUM_HA_SHA384:
+                    chd_el.certificateHashData.hashAlgorithm = HashAlgorithmEnumType::SHA384;
+                    break;
+                case ENUM_HA_SHA512:
+                    chd_el.certificateHashData.hashAlgorithm = HashAlgorithmEnumType::SHA512;
+                    break;
+                default:
+                    MO_DBG_ERR("internal error");
+                    err = true;
+                    break;
+            }
+
+            bool success = true;
+            int ret;
+            ret = snprintf(chd_el.certificateHashData.issuerNameHash, sizeof(chd_el.certificateHashData.issuerNameHash), "%s", it->certificateHashData.issuerNameHash);
+            success &= ret >= 0 && (size_t)ret < sizeof(chd_el.certificateHashData.issuerNameHash);
+            ret = snprintf(chd_el.certificateHashData.issuerKeyHash, sizeof(chd_el.certificateHashData.issuerKeyHash), "%s", it->certificateHashData.issuerKeyHash);
+            success &= ret >= 0 && (size_t)ret < sizeof(chd_el.certificateHashData.issuerKeyHash);
+            ret = snprintf(chd_el.certificateHashData.serialNumber, sizeof(chd_el.certificateHashData.serialNumber), "%s", it->certificateHashData.serialNumber);
+            success &= ret >= 0 && (size_t)ret < sizeof(chd_el.certificateHashData.serialNumber);
+
+            if (!success) {
+                MO_DBG_ERR("error copying C-style struct");
+                err = true;
+            }
+        }
+
+        while (cch) {
+            ocpp_certificate_chain_hash *el = cch;
+            cch = cch->next;
+            el->invalidate(el);
+        }
+
+        if (err) {
+            out.clear();
+        }
+
+        return out.empty() ?
+                GetInstalledCertificateStatus::NotFound :
+                GetInstalledCertificateStatus::Accepted;
+    }
+
+    DeleteCertificateStatus deleteCertificate(const CertificateHash& hash) override {
+        ocpp_certificate_hash ch;
+
+        HashAlgorithmEnumType_c ha;
+
+        switch (hash.hashAlgorithm) {
+            case HashAlgorithmEnumType::SHA256:
+                ha = ENUM_HA_SHA256;
+                break;
+            case HashAlgorithmEnumType::SHA384:
+                ha = ENUM_HA_SHA384;
+                break;
+            case HashAlgorithmEnumType::SHA512:
+                ha = ENUM_HA_SHA512;
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                return DeleteCertificateStatus::Failed;
+        }
+
+        ch.hashAlgorithm = ha;
+
+        bool success = true;
+        int ret;
+        ret = snprintf(ch.issuerNameHash, sizeof(ch.issuerNameHash), "%s", hash.issuerNameHash);
+        success &= ret >= 0 && (size_t)ret < sizeof(ch.issuerNameHash);
+        ret = snprintf(ch.issuerKeyHash, sizeof(ch.issuerKeyHash), "%s", hash.issuerKeyHash);
+        success &= ret >= 0 && (size_t)ret < sizeof(ch.issuerKeyHash);
+        ret = snprintf(ch.serialNumber, sizeof(ch.serialNumber), "%s", hash.serialNumber);
+        success &= ret >= 0 && (size_t)ret < sizeof(ch.serialNumber);
+        if (!success) {
+            MO_DBG_ERR("error copying C-style struct");
+            return DeleteCertificateStatus::Failed;
+        }
+
+        auto status = certstore->deleteCertificate(certstore->user_data, &ch);
+
+        DeleteCertificateStatus dcs;
+
+        switch (status) {
+            case ENUM_DCS_Accepted:
+                dcs = DeleteCertificateStatus::Accepted;
+                break;
+            case ENUM_DCS_Failed:
+                dcs = DeleteCertificateStatus::Failed;
+                break;
+            case ENUM_DCS_NotFound:
+                dcs = DeleteCertificateStatus::NotFound;
+                break;
+            default:
+                MO_DBG_ERR("could not convert status type");
+                return DeleteCertificateStatus::Failed; 
+        }
+
+        return dcs;
+    }
+
+    InstallCertificateStatus installCertificate(InstallCertificateType certificateType, const char *certificate) override {
+        InstallCertificateType_c ic;
+        
+        switch (certificateType) {
+            case InstallCertificateType::V2GRootCertificate:
+                ic = ENUM_IC_V2GRootCertificate;
+                break;
+            case InstallCertificateType::MORootCertificate:
+                ic = ENUM_IC_MORootCertificate;
+                break;
+            case InstallCertificateType::CSMSRootCertificate:
+                ic = ENUM_IC_CSMSRootCertificate;
+                break;
+            case InstallCertificateType::ManufacturerRootCertificate:
+                ic = ENUM_IC_ManufacturerRootCertificate;
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                return InstallCertificateStatus::Failed;
+        }
+
+        auto ret = certstore->installCertificate(certstore->user_data, ic, certificate);
+
+        InstallCertificateStatus ics;
+
+        switch (ret) {
+            case ENUM_ICS_Accepted:
+                ics = InstallCertificateStatus::Accepted;
+                break;
+            case ENUM_ICS_Rejected:
+                ics = InstallCertificateStatus::Rejected;
+                break;
+            case ENUM_ICS_Failed:
+                ics = InstallCertificateStatus::Failed;
+                break;
+            default:
+                MO_DBG_ERR("could not convert status type");
+                return InstallCertificateStatus::Rejected; 
+        }
+
+        return ics;
+    }
+};
+
+std::unique_ptr<CertificateStore> makeCertificateStoreCwrapper(ocpp_certificate_store *certstore) {
+    return std::unique_ptr<CertificateStore>(new CertificateStoreC(certstore));
+}
+
+} //namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/Certificates/Certificate_c.h b/src/MicroOcpp/Model/Certificates/Certificate_c.h
new file mode 100644
index 00000000..cbc256bf
--- /dev/null
+++ b/src/MicroOcpp/Model/Certificates/Certificate_c.h
@@ -0,0 +1,111 @@
+#ifndef MO_CERTIFICATE_C_H
+#define MO_CERTIFICATE_C_H
+
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+enum GetCertificateIdType_c {
+    ENUM_GCI_V2GRootCertificate,
+    ENUM_GCI_MORootCertificate,
+    ENUM_GCI_CSMSRootCertificate,
+    ENUM_GCI_V2GCertificateChain,
+    ENUM_GCI_ManufacturerRootCertificate
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.40
+ */
+enum GetInstalledCertificateStatus_c {
+    ENUM_GICS_Accepted,
+    ENUM_GICS_NotFound
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.45
+ */
+enum InstallCertificateType_c {
+    ENUM_IC_V2GRootCertificate,
+    ENUM_IC_MORootCertificate,
+    ENUM_IC_CSMSRootCertificate,
+    ENUM_IC_ManufacturerRootCertificate
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.28
+ */
+enum InstallCertificateStatus_c {
+    ENUM_ICS_Accepted,
+    ENUM_ICS_Rejected,
+    ENUM_ICS_Failed
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.28
+ */
+enum DeleteCertificateStatus_c {
+    ENUM_DCS_Accepted,
+    ENUM_DCS_Failed,
+    ENUM_DCS_NotFound
+};
+
+/*
+ * See OCPP 2.0.1 part 2 Data Type 3.42
+ */
+enum HashAlgorithmEnumType_c {
+    ENUM_HA_SHA256,
+    ENUM_HA_SHA384,
+    ENUM_HA_SHA512
+};
+
+#define MO_CERT_HASH_ISSUER_NAME_SIZE (128 + 1)
+#define MO_CERT_HASH_ISSUER_KEY_SIZE (128 + 1)
+#define MO_CERT_HASH_SERIAL_NUMBER_SIZE (40 + 1)
+
+typedef struct ocpp_certificate_hash {
+    enum HashAlgorithmEnumType_c hashAlgorithm;
+    char issuerNameHash [MO_CERT_HASH_ISSUER_NAME_SIZE];
+    char issuerKeyHash [MO_CERT_HASH_ISSUER_KEY_SIZE];
+    char serialNumber [MO_CERT_HASH_SERIAL_NUMBER_SIZE];
+
+    //ocpp_certificate_hash *next; //link to next list element if part of ocpp_certificate_chain_hash
+} ocpp_certificate_hash;
+
+typedef struct ocpp_certificate_chain_hash {
+    void *user_data; //set this at your choice. MO passes it back to the functions below
+
+    enum GetCertificateIdType_c certificateType;
+    ocpp_certificate_hash certificateHashData;
+    //ocpp_certificate_hash *childCertificateHashData; 
+
+    struct ocpp_certificate_chain_hash *next; //link to next list element if result of getCertificateIds
+
+    void (*invalidate)(void *user_data); //free resources here. Guaranteed to be called
+} ocpp_certificate_chain_hash;
+
+typedef struct ocpp_certificate_store {
+    void *user_data; //set this at your choice. MO passes it back to the functions below
+
+    enum GetInstalledCertificateStatus_c (*getCertificateIds)(void *user_data, enum GetCertificateIdType_c certificateType, ocpp_certificate_chain_hash **out);
+    enum DeleteCertificateStatus_c (*deleteCertificate)(void *user_data, const ocpp_certificate_hash *hash);
+    enum InstallCertificateStatus_c (*installCertificate)(void *user_data, enum InstallCertificateType_c certificateType, const char *certificate);
+} ocpp_certificate_store;
+
+#ifdef __cplusplus
+} //extern "C"
+
+#include <memory>
+
+#include <MicroOcpp/Model/Certificates/Certificate.h>
+
+namespace MicroOcpp {
+
+std::unique_ptr<CertificateStore> makeCertificateStoreCwrapper(ocpp_certificate_store *certstore);
+
+} //namespace MicroOcpp
+
+#endif //defined __cplusplus
+
+#endif
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index f0bd7beb..d97bedd7 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -17,6 +17,7 @@
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Model/Boot/BootService.h>
 #include <MicroOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Model/Certificates/CertificateService.h>
 
 #include <MicroOcpp/Core/Configuration.h>
 
@@ -187,6 +188,15 @@ ResetService *Model::getResetService() const {
     return resetService.get();
 }
 
+void Model::setCertificateService(std::unique_ptr<CertificateService> cs) {
+    this->certService = std::move(cs);
+    capabilitiesUpdated = true;
+}
+
+CertificateService *Model::getCertificateService() const {
+    return certService.get();
+}
+
 Clock& Model::getClock() {
     return clock;
 }
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 1273153f..81ec653e 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -23,6 +23,7 @@ class AuthorizationService;
 class ReservationService;
 class BootService;
 class ResetService;
+class CertificateService;
 
 class Model {
 private:
@@ -38,6 +39,7 @@ class Model {
     std::unique_ptr<ReservationService> reservationService;
     std::unique_ptr<BootService> bootService;
     std::unique_ptr<ResetService> resetService;
+    std::unique_ptr<CertificateService> certService;
     Clock clock;
 
     bool capabilitiesUpdated = true;
@@ -92,6 +94,9 @@ class Model {
     void setResetService(std::unique_ptr<ResetService> rs);
     ResetService *getResetService() const;
 
+    void setCertificateService(std::unique_ptr<CertificateService> cs);
+    CertificateService *getCertificateService() const;
+
     Clock &getClock();
 
     uint16_t getBootNr();
diff --git a/src/MicroOcpp/Operations/DeleteCertificate.cpp b/src/MicroOcpp/Operations/DeleteCertificate.cpp
new file mode 100644
index 00000000..27a76d10
--- /dev/null
+++ b/src/MicroOcpp/Operations/DeleteCertificate.cpp
@@ -0,0 +1,91 @@
+#include <MicroOcpp/Operations/DeleteCertificate.h>
+#include <MicroOcpp/Model/Certificates/Certificate.h>
+#include <MicroOcpp/Model/Certificates/CertificateService.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::DeleteCertificate;
+
+DeleteCertificate::DeleteCertificate(CertificateService& certService) : certService(certService) {
+
+}
+
+void DeleteCertificate::processReq(JsonObject payload) {
+
+    if (!payload.containsKey("hashAlgorithm") ||
+            !payload.containsKey("issuerNameHash") ||
+            !payload.containsKey("issuerKeyHash") ||
+            !payload.containsKey("serialNumber")) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    const char *hashAlgorithm = payload["hashAlgorithm"] | "_Invalid";
+
+    if (!payload["issuerNameHash"].is<const char*>() ||
+            !payload["issuerKeyHash"].is<const char*>() ||
+            !payload["serialNumber"].is<const char*>()) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    CertificateHash cert;
+
+    if (!strcmp(hashAlgorithm, "SHA256")) {
+        cert.hashAlgorithm = HashAlgorithmEnumType::SHA256;
+    } else if (!strcmp(hashAlgorithm, "SHA384")) {
+        cert.hashAlgorithm = HashAlgorithmEnumType::SHA384;
+    } else if (!strcmp(hashAlgorithm, "SHA512")) {
+        cert.hashAlgorithm = HashAlgorithmEnumType::SHA512;
+    } else {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    auto retIN = snprintf(cert.issuerNameHash, sizeof(cert.issuerNameHash), "%s", payload["issuerNameHash"] | "_Invalid");
+    auto retIK = snprintf(cert.issuerKeyHash, sizeof(cert.issuerKeyHash), "%s", payload["issuerKeyHash"] | "_Invalid");
+    auto retSN = snprintf(cert.serialNumber, sizeof(cert.serialNumber), "%s", payload["serialNumber"] | "_Invalid");
+    if (retIN < 0 || retIK < 0 || retSN < 0) {
+        MO_DBG_ERR("could not parse CertId: %i %i %i", retIN, retIK, retSN);
+        errorCode = "InternalError";
+        return;
+    }
+    if ((size_t)retIN >= sizeof(cert.issuerNameHash) ||
+            (size_t)retIK >= sizeof(cert.issuerKeyHash) ||
+            (size_t)retSN >= sizeof(cert.serialNumber)) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    auto certStore = certService.getCertificateStore();
+    if (!certStore) {
+        errorCode = "NotSupported";
+        return;
+    }
+
+    auto status = certStore->deleteCertificate(cert);
+
+    switch (status) {
+        case DeleteCertificateStatus::Accepted:
+            this->status = "Accepted";
+            break;
+        case DeleteCertificateStatus::Failed:
+            this->status = "Failed";
+            break;
+        case DeleteCertificateStatus::NotFound:
+            this->status = "NotFound";
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            errorCode = "InternalError";
+            return;
+    }
+
+    //operation executed successfully
+}
+
+std::unique_ptr<DynamicJsonDocument> DeleteCertificate::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+    payload["status"] = status;
+    return doc;
+}
diff --git a/src/MicroOcpp/Operations/DeleteCertificate.h b/src/MicroOcpp/Operations/DeleteCertificate.h
new file mode 100644
index 00000000..e0b3f66f
--- /dev/null
+++ b/src/MicroOcpp/Operations/DeleteCertificate.h
@@ -0,0 +1,32 @@
+#ifndef MO_DELETECERTIFICATE_H
+#define MO_DELETECERTIFICATE_H
+
+#include <MicroOcpp/Core/Operation.h>
+
+namespace MicroOcpp {
+
+class CertificateService;
+
+namespace Ocpp201 {
+
+class DeleteCertificate : public Operation {
+private:
+    CertificateService& certService;
+    const char *status = nullptr;
+    const char *errorCode = nullptr;
+public:
+    DeleteCertificate(CertificateService& certService);
+
+    const char* getOperationType() override {return "DeleteCertificate";}
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+};
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+
+#endif
diff --git a/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
new file mode 100644
index 00000000..fae8e150
--- /dev/null
+++ b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
@@ -0,0 +1,105 @@
+#include <MicroOcpp/Operations/GetInstalledCertificateIds.h>
+#include <MicroOcpp/Model/Certificates/Certificate.h>
+#include <MicroOcpp/Model/Certificates/CertificateService.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::GetInstalledCertificateIds;
+
+GetInstalledCertificateIds::GetInstalledCertificateIds(CertificateService& certService) : certService(certService) {
+
+}
+
+void GetInstalledCertificateIds::processReq(JsonObject payload) {
+
+    if (!payload.containsKey("certificateType")) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    const char *certificateTypeCstr = payload["certificateType"] | "_Invalid";
+    GetCertificateIdType certificateType;
+    if (!strcmp(certificateTypeCstr, "V2GRootCertificate")) {
+        certificateType = GetCertificateIdType::V2GRootCertificate;
+    } else if (!strcmp(certificateTypeCstr, "MORootCertificate")) {
+        certificateType = GetCertificateIdType::MORootCertificate;
+    } else if (!strcmp(certificateTypeCstr, "CSMSRootCertificate")) {
+        certificateType = GetCertificateIdType::CSMSRootCertificate;
+    } else if (!strcmp(certificateTypeCstr, "V2GCertificateChain")) {
+        certificateType = GetCertificateIdType::V2GCertificateChain;
+    } else if (!strcmp(certificateTypeCstr, "ManufacturerRootCertificate")) {
+        certificateType = GetCertificateIdType::ManufacturerRootCertificate;
+    } else {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    auto certStore = certService.getCertificateStore();
+    if (!certStore) {
+        errorCode = "NotSupported";
+        return;
+    }
+
+    auto status = certStore->getCertificateIds(certificateType, certificateHashDataChain);
+
+    switch (status) {
+        case GetInstalledCertificateStatus::Accepted:
+            this->status = "Accepted";
+            break;
+        case GetInstalledCertificateStatus::NotFound:
+            this->status = "NotFound";
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            errorCode = "InternalError";
+            return;
+    }
+
+    //operation executed successfully
+}
+
+std::unique_ptr<DynamicJsonDocument> GetInstalledCertificateIds::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+            JSON_OBJECT_SIZE(2) + //payload root
+            JSON_ARRAY_SIZE(certificateHashDataChain.size()) + //array for field certificateHashDataChain
+            certificateHashDataChain.size() * ( 
+                JSON_OBJECT_SIZE(2) + //certificateHashDataChain root
+                JSON_OBJECT_SIZE(4))  //certificateHashData
+            ));
+    JsonObject payload = doc->to<JsonObject>();
+    payload["status"] = status;
+
+    for (auto& chainElem : certificateHashDataChain) {
+        JsonObject certHashJson = payload["certificateHashDataChain"].createNestedObject();
+
+        const char *certificateTypeCstr = "";
+        switch (chainElem.certificateType) {
+            case GetCertificateIdType::V2GRootCertificate:
+                certificateTypeCstr = "V2GRootCertificate";
+                break;
+            case GetCertificateIdType::MORootCertificate:
+                certificateTypeCstr = "MORootCertificate";
+                break;
+            case GetCertificateIdType::CSMSRootCertificate:
+                certificateTypeCstr = "CSMSRootCertificate";
+                break;
+            case GetCertificateIdType::V2GCertificateChain:
+                certificateTypeCstr = "V2GCertificateChain";
+                break;
+            case GetCertificateIdType::ManufacturerRootCertificate:
+                certificateTypeCstr = "ManufacturerRootCertificate";
+                break;
+        }
+
+        certHashJson["certificateType"] = (const char*) certificateTypeCstr; //use JSON zero-copy mode
+        certHashJson["certificateHashData"]["hashAlgorithm"] = chainElem.certificateHashData.getHashAlgorithmCStr();
+        certHashJson["certificateHashData"]["issuerNameHash"] = chainElem.certificateHashData.getIssuerNameHash();
+        certHashJson["certificateHashData"]["issuerKeyHash"] = chainElem.certificateHashData.getIssuerKeyHash();
+        certHashJson["certificateHashData"]["serialNumber"] = chainElem.certificateHashData.getSerialNumber();
+        
+        if (!chainElem.childCertificateHashData.empty()) {
+            MO_DBG_ERR("only sole root certs supported");
+        }
+    }
+
+    return doc;
+}
diff --git a/src/MicroOcpp/Operations/GetInstalledCertificateIds.h b/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
new file mode 100644
index 00000000..58c34d87
--- /dev/null
+++ b/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
@@ -0,0 +1,34 @@
+#ifndef MO_GETINSTALLEDCERTIFICATEIDS_H
+#define MO_GETINSTALLEDCERTIFICATEIDS_H
+
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Model/Certificates/Certificate.h>
+
+namespace MicroOcpp {
+
+class CertificateService;
+
+namespace Ocpp201 {
+
+class GetInstalledCertificateIds : public Operation {
+private:
+    CertificateService& certService;
+    std::vector<CertificateChainHash> certificateHashDataChain;
+    const char *status = nullptr;
+    const char *errorCode = nullptr;
+public:
+    GetInstalledCertificateIds(CertificateService& certService);
+
+    const char* getOperationType() override {return "GetInstalledCertificateIds";}
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+};
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+
+#endif
diff --git a/src/MicroOcpp/Operations/InstallCertificate.cpp b/src/MicroOcpp/Operations/InstallCertificate.cpp
new file mode 100644
index 00000000..69be0d4d
--- /dev/null
+++ b/src/MicroOcpp/Operations/InstallCertificate.cpp
@@ -0,0 +1,75 @@
+#include <MicroOcpp/Operations/InstallCertificate.h>
+#include <MicroOcpp/Model/Certificates/CertificateService.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::InstallCertificate;
+
+InstallCertificate::InstallCertificate(CertificateService& certService) : certService(certService) {
+
+}
+
+void InstallCertificate::processReq(JsonObject payload) {
+
+    if (!payload.containsKey("certificateType") ||
+            !payload.containsKey("certificate")) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    InstallCertificateType certificateType;
+
+    const char *certificateTypeCstr = payload["certificateType"] | "_Invalid";
+
+    if (!strcmp(certificateTypeCstr, "V2GRootCertificate")) {
+        certificateType = InstallCertificateType::V2GRootCertificate;
+    } else if (!strcmp(certificateTypeCstr, "MORootCertificate")) {
+        certificateType = InstallCertificateType::MORootCertificate;
+    } else if (!strcmp(certificateTypeCstr, "CSMSRootCertificate")) {
+        certificateType = InstallCertificateType::CSMSRootCertificate;
+    } else if (!strcmp(certificateTypeCstr, "ManufacturerRootCertificate")) {
+        certificateType = InstallCertificateType::ManufacturerRootCertificate;
+    } else {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    if (!payload["certificate"].is<const char*>()) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    const char *certificate = payload["certificate"];
+
+    auto certStore = certService.getCertificateStore();
+    if (!certStore) {
+        errorCode = "NotSupported";
+        return;
+    }
+
+    auto status = certStore->installCertificate(certificateType, certificate);
+
+    switch (status) {
+        case InstallCertificateStatus::Accepted:
+            this->status = "Accepted";
+            break;
+        case InstallCertificateStatus::Rejected:
+            this->status = "Rejected";
+            break;
+        case InstallCertificateStatus::Failed:
+            this->status = "Failed";
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            errorCode = "InternalError";
+            return;
+    }
+
+    //operation executed successfully
+}
+
+std::unique_ptr<DynamicJsonDocument> InstallCertificate::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+    payload["status"] = status;
+    return doc;
+}
diff --git a/src/MicroOcpp/Operations/InstallCertificate.h b/src/MicroOcpp/Operations/InstallCertificate.h
new file mode 100644
index 00000000..24fb725e
--- /dev/null
+++ b/src/MicroOcpp/Operations/InstallCertificate.h
@@ -0,0 +1,32 @@
+#ifndef MO_INSTALLCERTIFICATE_H
+#define MO_INSTALLCERTIFICATE_H
+
+#include <MicroOcpp/Core/Operation.h>
+
+namespace MicroOcpp {
+
+class CertificateService;
+
+namespace Ocpp201 {
+
+class InstallCertificate : public Operation {
+private:
+    CertificateService& certService;
+    const char *status = nullptr;
+    const char *errorCode = nullptr;
+public:
+    InstallCertificate(CertificateService& certService);
+
+    const char* getOperationType() override {return "InstallCertificate";}
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+};
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+
+#endif
diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
index d4604681..696caef9 100644
--- a/src/MicroOcpp/Version.h
+++ b/src/MicroOcpp/Version.h
@@ -1 +1 @@
-#define MO_VERSION "1.0.0"
+#define MO_VERSION "1.1.0"
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 4041a368..50475f5b 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -5,15 +5,18 @@
 #include "MicroOcpp_c.h"
 #include "MicroOcpp.h"
 
+#include <MicroOcpp/Model/Certificates/Certificate_c.h>
+
+#include <MicroOcpp/Platform.h>
 #include <MicroOcpp/Debug.h>
 
 MicroOcpp::Connection *ocppSocket = nullptr;
 
 void ocpp_initialize(OCPP_Connection *conn, const char *chargePointModel, const char *chargePointVendor, struct OCPP_FilesystemOpt fsopt, bool autoRecover) {
-    ocpp_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt, autoRecover);
+    ocpp_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt, autoRecover, NULL);
 }
 
-void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt, bool autoRecover) {
+void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt, bool autoRecover, ocpp_certificate_store *certs) {
     if (!conn) {
         MO_DBG_ERR("conn is null");
     }
@@ -22,7 +25,12 @@ void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCre
 
     MicroOcpp::FilesystemOpt adaptFsopt = fsopt;
 
-    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt), autoRecover);
+    std::unique_ptr<MicroOcpp::CertificateStore> certsCwrapper;
+    if (certs) {
+        certsCwrapper = MicroOcpp::makeCertificateStoreCwrapper(certs);
+    }
+
+    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt), autoRecover, std::move(certsCwrapper));
 }
 
 void ocpp_deinitialize() {
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index df9d4402..f3a259bf 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -10,6 +10,7 @@
 #include <MicroOcpp/Core/ConfigurationOptions.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/Certificates/Certificate_c.h>
 
 struct OCPP_Connection;
 typedef struct OCPP_Connection OCPP_Connection;
@@ -63,7 +64,8 @@ void ocpp_initialize_full(
             OCPP_Connection *conn,  //WebSocket adapter for MicroOcpp
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             struct OCPP_FilesystemOpt fsopt, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
-            bool autoRecover); //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
+            bool autoRecover, //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
+            ocpp_certificate_store *certs); //optional. If provided, use given Cert Store, if NULL, use default (default depends on MbedTLS)
 
 
 void ocpp_deinitialize();
diff --git a/tests/Certificates.cpp b/tests/Certificates.cpp
new file mode 100644
index 00000000..01535e67
--- /dev/null
+++ b/tests/Certificates.cpp
@@ -0,0 +1,244 @@
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Configuration.h>
+
+#include <MicroOcpp/Model/Certificates/CertificateService.h>
+#include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h>
+
+#if !MO_ENABLE_MBEDTLS
+#error Certificates unit tests depend on MbedTLS
+#endif
+
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
+//ISRG Root X1
+const char *root_cert = R"(-----BEGIN CERTIFICATE-----
+MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
+TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
+cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
+WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
+ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
+h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
+0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
+A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
+T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
+B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
+B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
+KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
+OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
+jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
+qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
+rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
+hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
+ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
+3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
+NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
+ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
+TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
+jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
+oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
+4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
+mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
+emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
+-----END CERTIFICATE-----
+)";
+
+//precomputed identifiers of root cert above, based on Open Certificate Status Protocol (OCSP)
+const char *root_cert_hash_algorithm = "SHA256"; //algorithm used for the following hashes
+const char *root_cert_hash_issuer_name = "998AC9E24B24D4008398DFA1375FD5D3DA7F2827E547ABFE5DB367B9E2CD5B20";
+const char *root_cert_hash_issuer_key = "0B9FA5A59EED715C26C1020C711B4F6EC42D58B0015E14337A39DAD301C5AFC3";
+const char *root_cert_hash_serial_number = "8210CFB0D240E3594463E0BB63828B00";
+
+using namespace MicroOcpp;
+
+TEST_CASE( "M - Certificates" ) {
+    printf("\nRun %s\n",  "M - Certificates");
+
+    //clean state
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
+    FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+
+    mocpp_set_timer(custom_timer_cb);
+
+    mocpp_initialize(loopback, ChargerCredentials("test-runner"));
+    auto& model = getOcppContext()->getModel();
+    auto certService = model.getCertificateService();
+    SECTION("CertificateService initialized") {
+        REQUIRE(certService != nullptr);
+    }
+    auto certs = certService->getCertificateStore();
+    SECTION("CertificateStore initialized") {
+        REQUIRE(certs != nullptr);
+    }
+
+    auto connector = model.getConnector(1);
+    model.getClock().setTime(BASE_TIME);
+
+    loop();
+
+    SECTION("M05 Install CA cert -- sent cert is valid") {
+        auto ret = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
+        REQUIRE(ret == InstallCertificateStatus::Accepted);
+
+        size_t msize;
+        char fn [MO_MAX_PATH_SIZE];
+        printCertFn(MO_CERT_FN_CSMS_ROOT, 0, fn, MO_MAX_PATH_SIZE);
+        REQUIRE(filesystem->stat(fn, &msize) == 0);
+        REQUIRE(msize == strlen(root_cert));
+    }
+
+    SECTION("M03 Retrieve list of available certs -- one cert available") {
+        auto ret1 = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
+        REQUIRE(ret1 == InstallCertificateStatus::Accepted);
+
+        std::vector<CertificateChainHash> chain;
+        auto ret2 = certs->getCertificateIds(GetCertificateIdType::CSMSRootCertificate, chain);
+
+        REQUIRE(ret2 == GetInstalledCertificateStatus::Accepted);
+        REQUIRE(chain.size() == 1);
+
+        auto& chainElem = chain.front();
+
+        REQUIRE(chainElem.certificateType == GetCertificateIdType::CSMSRootCertificate);
+        auto& certHash = chainElem.certificateHashData;
+
+        REQUIRE(!strcmp(certHash.getHashAlgorithmCStr(), root_cert_hash_algorithm)); //if this fails, please update the precomputed test hashes
+        REQUIRE(!strcmp(certHash.getIssuerNameHash(), root_cert_hash_issuer_name));
+        REQUIRE(!strcmp(certHash.getIssuerKeyHash(), root_cert_hash_issuer_key));
+        REQUIRE(!strcmp(certHash.getSerialNumber(), root_cert_hash_serial_number));
+        REQUIRE(chainElem.childCertificateHashData.empty()); //no sub certs sent
+    }
+
+    SECTION("M04 Delete a specific cert -- specified cert exists") {
+        auto ret1 = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
+        REQUIRE(ret1 == InstallCertificateStatus::Accepted);
+
+        std::vector<CertificateChainHash> chain;
+        auto ret2 = certs->getCertificateIds(GetCertificateIdType::CSMSRootCertificate, chain);
+        REQUIRE(ret2 == GetInstalledCertificateStatus::Accepted);
+
+        REQUIRE(chain.size() == 1);
+
+        auto ret3 = certs->deleteCertificate(chain.front().certificateHashData);
+        REQUIRE(ret3 == DeleteCertificateStatus::Accepted);
+
+        ret2 = certs->getCertificateIds(GetCertificateIdType::CSMSRootCertificate, chain);
+        REQUIRE(ret2 == GetInstalledCertificateStatus::NotFound);
+
+        REQUIRE(chain.size() == 0);
+
+        size_t msize;
+        char fn [MO_MAX_PATH_SIZE];
+        printCertFn(MO_CERT_FN_CSMS_ROOT, 0, fn, MO_MAX_PATH_SIZE);
+        REQUIRE(filesystem->stat(fn, &msize) != 0);
+    }
+
+    SECTION("M05 InstallCertificate operation") {
+
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "InstallCertificate",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["certificateType"] = "CSMSRootCertificate"; //of InstallCertificateTypeEnumType
+                    payload["certificate"] = root_cert;
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        size_t msize;
+        char fn [MO_MAX_PATH_SIZE];
+        printCertFn(MO_CERT_FN_CSMS_ROOT, 0, fn, MO_MAX_PATH_SIZE);
+        REQUIRE(filesystem->stat(fn, &msize) == 0);
+        REQUIRE(msize == strlen(root_cert));
+    }
+
+    SECTION("M04 DeleteCertificate operation") {
+        auto ret = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
+        REQUIRE(ret == InstallCertificateStatus::Accepted);
+
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "DeleteCertificate",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            JSON_OBJECT_SIZE(4)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["hashAlgorithm"] = root_cert_hash_algorithm; //of HashAlgorithmEnumType
+                    payload["issuerNameHash"] = root_cert_hash_issuer_name;
+                    payload["issuerKeyHash"] = root_cert_hash_issuer_key;
+                    payload["serialNumber"] = root_cert_hash_serial_number;
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+    }
+
+    SECTION("M03 GetInstalledCertificateIds operation") {
+        auto ret = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
+        REQUIRE(ret == InstallCertificateStatus::Accepted);
+
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "GetInstalledCertificateIds",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                            JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["certificateType"] = "CSMSRootCertificate"; //of GetCertificateIdTypeEnumType
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                    REQUIRE( payload["certificateHashDataChain"].size() == 1 );
+                    JsonObject certificateHashDataChain = payload["certificateHashDataChain"][0];
+                    REQUIRE( !strcmp(certificateHashDataChain["certificateType"] | "_Undefined", "CSMSRootCertificate") );
+                    JsonObject certificateHashData = certificateHashDataChain["certificateHashData"];
+                    REQUIRE( !strcmp(certificateHashData["hashAlgorithm"] | "_Undefined", root_cert_hash_algorithm) ); //if this fails, please update the precomputed test hashes
+                    REQUIRE( !strcmp(certificateHashData["issuerNameHash"] | "_Undefined", root_cert_hash_issuer_name) );
+                    REQUIRE( !strcmp(certificateHashData["issuerKeyHash"] | "_Undefined", root_cert_hash_issuer_key) );
+                    REQUIRE( !strcmp(certificateHashData["serialNumber"] | "_Undefined", root_cert_hash_serial_number) );
+                    REQUIRE( !certificateHashDataChain.containsKey("childCertificateHashData") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+    }
+
+    mocpp_deinitialize();
+}
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index 9104ad87..208b12e6 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -152,7 +152,7 @@ TEST_CASE( "LocalAuth" ) {
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
-        ulong t_before = mocpp_tick_ms();
+        unsigned long t_before = mocpp_tick_ms();
 
         beginTransaction("mIdTag");
         loop();
@@ -219,7 +219,7 @@ TEST_CASE( "LocalAuth" ) {
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
-        ulong t_before = mocpp_tick_ms();
+        unsigned long t_before = mocpp_tick_ms();
 
         beginTransaction("unknownIdTag");
         loop();
@@ -327,7 +327,7 @@ TEST_CASE( "LocalAuth" ) {
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
-        ulong t_before = mocpp_tick_ms();
+        unsigned long t_before = mocpp_tick_ms();
 
         beginTransaction("mIdTagExpired");
         loop();

From 010abf8809cae1dd1ba7b1f01fcd2f6766da08c8 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 27 Feb 2024 22:37:54 +0100
Subject: [PATCH 440/549] OCPP 2.0.1 enable switch, Vars and Txs (#247)

---
 CHANGELOG.md                                  |   5 +
 CMakeLists.txt                                |  10 +
 src/MicroOcpp.cpp                             |  73 ++-
 src/MicroOcpp.h                               |  22 +-
 src/MicroOcpp/Core/Context.cpp                |   8 +-
 src/MicroOcpp/Core/Context.h                  |   7 +-
 src/MicroOcpp/Model/Authorization/IdToken.cpp |  69 +++
 src/MicroOcpp/Model/Authorization/IdToken.h   |  49 ++
 .../Model/Certificates/Certificate.cpp        |   4 +
 .../Model/Certificates/Certificate.h          |   4 +
 .../Model/Certificates/CertificateMbedTLS.cpp |   4 +
 .../Model/Certificates/CertificateMbedTLS.h   |   4 +
 .../Model/Certificates/CertificateService.cpp |   4 +
 .../Model/Certificates/CertificateService.h   |   4 +
 .../Model/Certificates/Certificate_c.cpp      |   4 +
 .../Model/Certificates/Certificate_c.h        |   4 +
 .../Model/ConnectorBase/ChargePointStatus.h   |   9 +-
 .../Model/ConnectorBase/Connector.cpp         |  71 ++-
 src/MicroOcpp/Model/ConnectorBase/EvseId.h    |  35 ++
 src/MicroOcpp/Model/Model.cpp                 |  35 +-
 src/MicroOcpp/Model/Model.h                   |  28 +-
 .../Model/Transactions/Transaction.h          | 147 ++++-
 .../Model/Transactions/TransactionService.cpp | 373 +++++++++++++
 .../Model/Transactions/TransactionService.h   |  99 ++++
 src/MicroOcpp/Model/Variables/Variable.cpp    | 405 ++++++++++++++
 src/MicroOcpp/Model/Variables/Variable.h      | 220 ++++++++
 .../Model/Variables/VariableContainer.cpp     |  73 +++
 .../Model/Variables/VariableContainer.h       |  78 +++
 .../Model/Variables/VariableService.cpp       | 419 ++++++++++++++
 .../Model/Variables/VariableService.h         |  93 ++++
 src/MicroOcpp/Operations/BootNotification.cpp |  12 +-
 .../Operations/DeleteCertificate.cpp          |   4 +
 src/MicroOcpp/Operations/DeleteCertificate.h  |   4 +
 .../Operations/GetInstalledCertificateIds.cpp |   4 +
 .../Operations/GetInstalledCertificateIds.h   |   4 +
 src/MicroOcpp/Operations/GetVariables.cpp     | 222 ++++++++
 src/MicroOcpp/Operations/GetVariables.h       |  63 +++
 .../Operations/InstallCertificate.cpp         |   4 +
 src/MicroOcpp/Operations/InstallCertificate.h |   4 +
 src/MicroOcpp/Operations/SetVariables.cpp     | 179 ++++++
 src/MicroOcpp/Operations/SetVariables.h       |  63 +++
 .../Operations/StatusNotification.cpp         |  60 +-
 src/MicroOcpp/Operations/StatusNotification.h |  38 +-
 src/MicroOcpp/Operations/TransactionEvent.cpp | 261 +++++++++
 src/MicroOcpp/Operations/TransactionEvent.h   |  44 ++
 src/MicroOcpp/Version.h                       |  32 ++
 src/MicroOcpp_c.cpp                           |   2 +-
 tests/Certificates.cpp                        |   4 +
 tests/Configuration.cpp                       |   2 +-
 tests/LocalAuthList.cpp                       |   2 +-
 tests/Reservation.cpp                         |   2 +-
 tests/Transactions.cpp                        |  99 ++++
 tests/Variables.cpp                           | 516 ++++++++++++++++++
 53 files changed, 3927 insertions(+), 58 deletions(-)
 create mode 100644 src/MicroOcpp/Model/Authorization/IdToken.cpp
 create mode 100644 src/MicroOcpp/Model/Authorization/IdToken.h
 create mode 100644 src/MicroOcpp/Model/ConnectorBase/EvseId.h
 create mode 100644 src/MicroOcpp/Model/Transactions/TransactionService.cpp
 create mode 100644 src/MicroOcpp/Model/Transactions/TransactionService.h
 create mode 100644 src/MicroOcpp/Model/Variables/Variable.cpp
 create mode 100644 src/MicroOcpp/Model/Variables/Variable.h
 create mode 100644 src/MicroOcpp/Model/Variables/VariableContainer.cpp
 create mode 100644 src/MicroOcpp/Model/Variables/VariableContainer.h
 create mode 100644 src/MicroOcpp/Model/Variables/VariableService.cpp
 create mode 100644 src/MicroOcpp/Model/Variables/VariableService.h
 create mode 100644 src/MicroOcpp/Operations/GetVariables.cpp
 create mode 100644 src/MicroOcpp/Operations/GetVariables.h
 create mode 100644 src/MicroOcpp/Operations/SetVariables.cpp
 create mode 100644 src/MicroOcpp/Operations/SetVariables.h
 create mode 100644 src/MicroOcpp/Operations/TransactionEvent.cpp
 create mode 100644 src/MicroOcpp/Operations/TransactionEvent.h
 create mode 100644 tests/Transactions.cpp
 create mode 100644 tests/Variables.cpp

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7d64aca3..e8e89c4d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,11 @@
 - Operation GetInstalledCertificateIds, UC M03 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation DeleteCertificate, UC M04 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation InstallCertificate, UC M05 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
+- `ProtocolVersion` selects v1.6 or v2.0.1 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
+- Build flag `MO_ENABLE_V201` set to 1 enables OCPP 2.0.1 features ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
+    - Variables (non-persistent), UCs B05 - B06 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
+    - Transactions (preview only), UCs E01 - E12 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
+    - StatusNotification compatibility ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
 
 ## [1.1.0] - 2024-02-27
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index d5b66fee..f617af66 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -39,6 +39,7 @@ set(MO_SRC
     src/MicroOcpp/Operations/GetDiagnostics.cpp
     src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
     src/MicroOcpp/Operations/GetLocalListVersion.cpp
+    src/MicroOcpp/Operations/GetVariables.cpp
     src/MicroOcpp/Operations/Heartbeat.cpp
     src/MicroOcpp/Operations/MeterValues.cpp
     src/MicroOcpp/Operations/RemoteStartTransaction.cpp
@@ -47,9 +48,11 @@ set(MO_SRC
     src/MicroOcpp/Operations/Reset.cpp
     src/MicroOcpp/Operations/SendLocalList.cpp
     src/MicroOcpp/Operations/SetChargingProfile.cpp
+    src/MicroOcpp/Operations/SetVariables.cpp
     src/MicroOcpp/Operations/StartTransaction.cpp
     src/MicroOcpp/Operations/StatusNotification.cpp
     src/MicroOcpp/Operations/StopTransaction.cpp
+    src/MicroOcpp/Operations/TransactionEvent.cpp
     src/MicroOcpp/Operations/TriggerMessage.cpp
     src/MicroOcpp/Operations/InstallCertificate.cpp
     src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -60,6 +63,7 @@ set(MO_SRC
     src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
     src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
     src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+    src/MicroOcpp/Model/Authorization/IdToken.cpp
     src/MicroOcpp/Model/Boot/BootService.cpp
     src/MicroOcpp/Model/Certificates/Certificate.cpp
     src/MicroOcpp/Model/Certificates/Certificate_c.cpp
@@ -83,7 +87,11 @@ set(MO_SRC
     src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
     src/MicroOcpp/Model/Transactions/Transaction.cpp
     src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
+    src/MicroOcpp/Model/Transactions/TransactionService.cpp
     src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+    src/MicroOcpp/Model/Variables/Variable.cpp
+    src/MicroOcpp/Model/Variables/VariableContainer.cpp
+    src/MicroOcpp/Model/Variables/VariableService.cpp
     src/MicroOcpp.cpp
     src/MicroOcpp_c.cpp
 )
@@ -135,6 +143,8 @@ set(MO_SRC_UNIT
     tests/Configuration.cpp
     tests/Reservation.cpp
     tests/LocalAuthList.cpp
+    tests/Variables.cpp
+    tests/Transactions.cpp
     #tests/Certificates.cpp # add if MbedTLS is available
 )
 
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index b1490fd2..c12ac5b6 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -17,6 +17,8 @@
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Model/Boot/BootService.h>
 #include <MicroOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 #include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h> //default CertStore implementation depends on MbedTLS
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
@@ -30,7 +32,6 @@
 #include <MicroOcpp/Operations/CustomOperation.h>
 
 #include <MicroOcpp/Debug.h>
-#include <MicroOcpp/Version.h>
 
 namespace MicroOcpp {
 namespace Facade {
@@ -201,7 +202,39 @@ ChargerCredentials::ChargerCredentials(const char *cpModel, const char *cpVendor
     }
 }
 
-void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs, bool autoRecover, std::unique_ptr<CertificateStore> certStore) {
+ChargerCredentials ChargerCredentials::v201(const char *cpModel, const char *cpVendor, const char *fWv, const char *cpSNr, const char *meterSNr, const char *meterType, const char *cbSNr, const char *iccid, const char *imsi) {
+
+    ChargerCredentials res;
+
+    StaticJsonDocument<512> creds;
+    if (cpSNr)
+        creds["serialNumber"] = cpSNr;
+    if (cpModel)
+        creds["model"] = cpModel;
+    if (cpVendor)
+        creds["vendorName"] = cpVendor;
+    if (fWv)
+        creds["firmwareVersion"] = fWv;
+    if (iccid)
+        creds["modem"]["iccid"] = iccid;
+    if (imsi)
+        creds["modem"]["imsi"] = imsi;
+
+    if (creds.overflowed()) {
+        MO_DBG_ERR("Charger Credentials too long");
+    }
+
+    size_t written = serializeJson(creds, res.payload, 512);
+
+    if (written < 2) {
+        MO_DBG_ERR("Charger Credentials could not be written");
+        sprintf(res.payload, "{}");
+    }
+
+    return res;
+}
+
+void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs, bool autoRecover, MicroOcpp::ProtocolVersion version, std::unique_ptr<CertificateStore> certStore) {
     if (context) {
         MO_DBG_WARN("already initialized. To reinit, call mocpp_deinitialize() before");
         return;
@@ -236,7 +269,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
 
     configuration_init(filesystem); //call before each other library call
 
-    context = new Context(connection, filesystem, bootstats.bootNr);
+    context = new Context(connection, filesystem, bootstats.bootNr, version);
     auto& model = context->getModel();
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
@@ -259,6 +292,13 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     model.setResetService(std::unique_ptr<ResetService>(
         new ResetService(*context)));
 
+#if MO_ENABLE_V201
+    model.setVariableService(std::unique_ptr<VariableService>(
+        new VariableService(*context, filesystem)));
+    model.setTransactionService(std::unique_ptr<TransactionService>(
+        new TransactionService(*context)));
+#endif
+
     std::unique_ptr<CertificateStore> certStoreUse;
     if (certStore) {
         certStoreUse = std::move(certStore);
@@ -497,6 +537,15 @@ void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int c
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
+#if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (auto txService = context->getModel().getTransactionService()) {
+            if (auto evse = txService->getEvse(connectorId)) {
+                evse->setConnectorPluggedInput(pluggedInput);
+            }
+        }
+    }
+#endif
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -633,6 +682,15 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
+#if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (auto txService = context->getModel().getTransactionService()) {
+            if (auto evse = txService->getEvse(connectorId)) {
+                evse->setEvReadyInput(evReadyInput);
+            }
+        }
+    }
+#endif
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -646,6 +704,15 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
+#if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (auto txService = context->getModel().getTransactionService()) {
+            if (auto evse = txService->getEvse(connectorId)) {
+                evse->setEvseReadyInput(evseReadyInput);
+            }
+        }
+    }
+#endif
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index f821d7ed..453d8dbe 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef ARDUINOOCPP_H
-#define ARDUINOOCPP_H
+#ifndef MO_MICROOCPP_H
+#define MO_MICROOCPP_H
 
 #include <ArduinoJson.h>
 #include <memory>
@@ -18,6 +18,7 @@
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
+#include <MicroOcpp/Version.h>
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 
 using MicroOcpp::OnReceiveConfListener;
@@ -70,6 +71,20 @@ struct ChargerCredentials {
             const char *chargeBoxSerialNumber = nullptr,
             const char *iccid = nullptr,
             const char *imsi = nullptr);
+    
+    /*
+     * OCPP 2.0.1 compatible charger credentials. Use this if initializing the library with ProtocolVersion(2,0,1)
+     */
+    static ChargerCredentials v201(
+            const char *chargePointModel = "Demo Charger",
+            const char *chargePointVendor = "My Company Ltd.",
+            const char *firmwareVersion = nullptr,
+            const char *chargePointSerialNumber = nullptr,
+            const char *meterSerialNumber = nullptr,
+            const char *meterType = nullptr,
+            const char *chargeBoxSerialNumber = nullptr,
+            const char *iccid = nullptr,
+            const char *imsi = nullptr);
 
     operator const char *() {return payload;}
 
@@ -95,6 +110,7 @@ void mocpp_initialize(
             std::shared_ptr<MicroOcpp::FilesystemAdapter> filesystem =
                 MicroOcpp::makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail), //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
             bool autoRecover = false, //automatically sanitize the local data store when the lib detects recurring crashes. Not recommended during development
+            MicroOcpp::ProtocolVersion version = MicroOcpp::ProtocolVersion(1,6),
             std::unique_ptr<MicroOcpp::CertificateStore> certStore = nullptr); //optionally use custom Cert Store (default depends on MbedTLS)
 
 /*
diff --git a/src/MicroOcpp/Core/Context.cpp b/src/MicroOcpp/Core/Context.cpp
index 425354ac..1a557eab 100644
--- a/src/MicroOcpp/Core/Context.cpp
+++ b/src/MicroOcpp/Core/Context.cpp
@@ -11,8 +11,8 @@
 
 using namespace MicroOcpp;
 
-Context::Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr)
-        : connection(connection), model{bootNr}, reqQueue{operationRegistry, &model, filesystem} {
+Context::Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr, ProtocolVersion version)
+        : connection(connection), model{version, bootNr}, reqQueue{operationRegistry, &model, filesystem} {
 
     preBootQueue = std::unique_ptr<RequestQueue>(new RequestQueue(operationRegistry, &model, nullptr)); //pre boot queue doesn't need persistency
     preBootQueue->setConnection(connection);
@@ -64,3 +64,7 @@ Model& Context::getModel() {
 OperationRegistry& Context::getOperationRegistry() {
     return operationRegistry;
 }
+
+const ProtocolVersion& Context::getVersion() {
+    return model.getVersion();
+}
diff --git a/src/MicroOcpp/Core/Context.h b/src/MicroOcpp/Core/Context.h
index dfe5ff2c..cdb0d80b 100644
--- a/src/MicroOcpp/Core/Context.h
+++ b/src/MicroOcpp/Core/Context.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_CONTEXT_H
@@ -10,6 +10,7 @@
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Core/RequestQueue.h>
 #include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Version.h>
 
 namespace MicroOcpp {
 
@@ -26,7 +27,7 @@ class Context {
     std::unique_ptr<RequestQueue> preBootQueue;
 
 public:
-    Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr);
+    Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr, ProtocolVersion version);
     ~Context();
 
     void loop();
@@ -41,6 +42,8 @@ class Context {
     Model& getModel();
 
     OperationRegistry& getOperationRegistry();
+
+    const ProtocolVersion& getVersion();
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/Authorization/IdToken.cpp b/src/MicroOcpp/Model/Authorization/IdToken.cpp
new file mode 100644
index 00000000..aab55a7b
--- /dev/null
+++ b/src/MicroOcpp/Model/Authorization/IdToken.cpp
@@ -0,0 +1,69 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Authorization/IdToken.h>
+
+#include <string.h>
+#include <stdio.h>
+
+#include <MicroOcpp/Debug.h>
+
+using namespace MicroOcpp;
+
+IdToken::IdToken() {
+    idToken[0] = '\0';
+}
+
+IdToken::IdToken(const char *token, Type type) : type(type) {
+    auto ret = snprintf(idToken, MO_IDTOKEN_LEN_MAX + 1, "%s", token);
+    if (ret < 0 || ret >= MO_IDTOKEN_LEN_MAX + 1) {
+        MO_DBG_ERR("invalid token");
+        *idToken = '\0';
+    }
+}
+
+const char *IdToken::get() const {
+    return *idToken ? idToken : nullptr;;
+}
+
+const char *IdToken::getTypeCstr() const {
+    const char *res = nullptr;
+    switch (type) {
+        case Type::Central:
+            res = "Central";
+            break;
+        case Type::eMAID:
+            res = "eMAID";
+            break;
+        case Type::ISO14443:
+            res = "ISO14443";
+            break;
+        case Type::ISO15693:
+            res = "ISO15693";
+            break;
+        case Type::KeyCode:
+            res = "KeyCode";
+            break;
+        case Type::Local:
+            res = "Local";
+            break;
+        case Type::MacAddress:
+            res = "MacAddress";
+            break;
+        case Type::NoAuthorization:
+            res = "NoAuthorization";
+            break;
+    }
+
+    if (!res) {
+        MO_DBG_ERR("internal error");
+    }
+    return res ? res : "";
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Authorization/IdToken.h b/src/MicroOcpp/Model/Authorization/IdToken.h
new file mode 100644
index 00000000..441055dc
--- /dev/null
+++ b/src/MicroOcpp/Model/Authorization/IdToken.h
@@ -0,0 +1,49 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_IDTOKEN_H
+#define MO_IDTOKEN_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <stdint.h>
+
+#define MO_IDTOKEN_LEN_MAX 36
+
+namespace MicroOcpp {
+
+// IdTokenType (2.28)
+class IdToken {
+public:
+
+    // IdTokenEnumType (3.43)
+    enum class Type : uint8_t {
+        Central,
+        eMAID,
+        ISO14443,
+        ISO15693,
+        KeyCode,
+        Local,
+        MacAddress,
+        NoAuthorization,
+        UNDEFINED
+    };
+
+private:
+    char idToken [MO_IDTOKEN_LEN_MAX + 1];
+    Type type = Type::UNDEFINED;
+public:
+    IdToken();
+    IdToken(const char *token, Type type = Type::ISO14443);
+
+    const char *get() const;
+    const char *getTypeCstr() const;
+};
+
+} // namespace MicroOcpp
+
+#endif // MO_ENABLE_V201
+#endif
diff --git a/src/MicroOcpp/Model/Certificates/Certificate.cpp b/src/MicroOcpp/Model/Certificates/Certificate.cpp
index 3caa9dd6..a61a88cb 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate.cpp
+++ b/src/MicroOcpp/Model/Certificates/Certificate.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 
 #include <string.h>
diff --git a/src/MicroOcpp/Model/Certificates/Certificate.h b/src/MicroOcpp/Model/Certificates/Certificate.h
index 6dcf0cc6..137e3658 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate.h
+++ b/src/MicroOcpp/Model/Certificates/Certificate.h
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #ifndef MO_CERTIFICATE_H
 #define MO_CERTIFICATE_H
 
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
index a20cb0f4..4bcce8e2 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h>
 
 #if MO_ENABLE_MBEDTLS
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
index f06b4c2c..1ecd52ee 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #ifndef MO_CERTIFICATE_MBEDTLS_H
 #define MO_CERTIFICATE_MBEDTLS_H
 
diff --git a/src/MicroOcpp/Model/Certificates/CertificateService.cpp b/src/MicroOcpp/Model/Certificates/CertificateService.cpp
index 57f502f7..37ef7c9c 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateService.cpp
+++ b/src/MicroOcpp/Model/Certificates/CertificateService.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/DeleteCertificate.h>
diff --git a/src/MicroOcpp/Model/Certificates/CertificateService.h b/src/MicroOcpp/Model/Certificates/CertificateService.h
index ce9b1e64..7a45eca9 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateService.h
+++ b/src/MicroOcpp/Model/Certificates/CertificateService.h
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 /*
  * Functional Block M: ISO 15118 Certificate Management
  *
diff --git a/src/MicroOcpp/Model/Certificates/Certificate_c.cpp b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
index 285d0078..46d0875a 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
+++ b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp/Model/Certificates/Certificate_c.h>
 #include <MicroOcpp/Debug.h>
 
diff --git a/src/MicroOcpp/Model/Certificates/Certificate_c.h b/src/MicroOcpp/Model/Certificates/Certificate_c.h
index cbc256bf..fb9833fe 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate_c.h
+++ b/src/MicroOcpp/Model/Certificates/Certificate_c.h
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #ifndef MO_CERTIFICATE_C_H
 #define MO_CERTIFICATE_C_H
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h b/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
index 308e04b8..4a603577 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
@@ -1,10 +1,12 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef OCPP_EVSE_STATE
 #define OCPP_EVSE_STATE
 
+#include <MicroOcpp/Version.h>
+
 namespace MicroOcpp {
 
 enum class ChargePointStatus {
@@ -17,6 +19,11 @@ enum class ChargePointStatus {
     Reserved,
     Unavailable,
     Faulted,
+
+#if MO_ENABLE_V201
+    Occupied,
+#endif
+
     NOT_SET //internal value for "undefined"
 };
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 4c0274ab..4f82c90c 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/ConnectorBase/Connector.h>
@@ -21,6 +21,7 @@
 #include <MicroOcpp/Model/Metering/MeteringService.h>
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
+#include <MicroOcpp/Model/ConnectorBase/EvseId.h>
 
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 
@@ -29,7 +30,6 @@
 #endif
 
 using namespace MicroOcpp;
-using namespace MicroOcpp::Ocpp16;
 
 Connector::Connector(Context& context, int connectorId)
         : context(context), model(context.getModel()), connectorId{connectorId} {
@@ -270,7 +270,7 @@ void Connector::loop() {
                     model.getMeteringService()->beginTxMeterData(transaction.get());
                 }
 
-                auto startTx = makeRequest(new StartTransaction(model, transaction));
+                auto startTx = makeRequest(new Ocpp16::StartTransaction(model, transaction));
                 startTx->setTimeout(0);
                 startTx->setOnReceiveConfListener([this] (JsonObject response) {
                     //fetch authorization status from StartTransaction.conf() for user notification
@@ -334,9 +334,9 @@ void Connector::loop() {
                 std::unique_ptr<Request> stopTx;
 
                 if (stopTxData) {
-                    stopTx = makeRequest(new StopTransaction(model, std::move(transaction), stopTxData->retrieveStopTxData()));
+                    stopTx = makeRequest(new Ocpp16::StopTransaction(model, std::move(transaction), stopTxData->retrieveStopTxData()));
                 } else {
-                    stopTx = makeRequest(new StopTransaction(model, std::move(transaction)));
+                    stopTx = makeRequest(new Ocpp16::StopTransaction(model, std::move(transaction)));
                 }
                 stopTx->setTimeout(0);
                 context.initiateRequest(std::move(stopTx));
@@ -366,25 +366,41 @@ void Connector::loop() {
 
     auto status = getStatus();
 
-    for (auto i = std::min(errorDataInputs.size(), trackErrorDataInputs.size()); i >= 1; i--) {
-        auto index = i - 1;
-        auto error = errorDataInputs[index].operator()();
-        if (error.isError && !trackErrorDataInputs[index]) {
-            //new error
-            auto statusNotification = makeRequest(
-                    new StatusNotification(connectorId, status, model.getClock().now(), error));
-            statusNotification->setTimeout(0);
-            context.initiateRequest(std::move(statusNotification));
+    if (model.getVersion().major == 1) {
+        //OCPP 1.6: use StatusNotification to send error codes
+        for (auto i = std::min(errorDataInputs.size(), trackErrorDataInputs.size()); i >= 1; i--) {
+            auto index = i - 1;
+            auto error = errorDataInputs[index].operator()();
+            if (error.isError && !trackErrorDataInputs[index]) {
+                //new error
+                auto statusNotification = makeRequest(
+                        new Ocpp16::StatusNotification(connectorId, status, model.getClock().now(), error));
+                statusNotification->setTimeout(0);
+                context.initiateRequest(std::move(statusNotification));
+
+                currentStatus = status;
+                reportedStatus = status;
+                trackErrorDataInputs[index] = true;
+            } else if (!error.isError && trackErrorDataInputs[index]) {
+                //reset error
+                trackErrorDataInputs[index] = false;
+            }
+        }
+    }
 
-            currentStatus = status;
-            reportedStatus = status;
-            trackErrorDataInputs[index] = true;
-        } else if (!error.isError && trackErrorDataInputs[index]) {
-            //reset error
-            trackErrorDataInputs[index] = false;
+#if MO_ENABLE_V201
+    if (model.getVersion().major == 2) {
+        //OCPP 2.0.1: map v1.6 status onto v2.0.1
+        if (status == ChargePointStatus::Preparing ||
+                status == ChargePointStatus::Charging ||
+                status == ChargePointStatus::SuspendedEV ||
+                status == ChargePointStatus::SuspendedEVSE ||
+                status == ChargePointStatus::Finishing) {
+            status = ChargePointStatus::Occupied;
         }
     }
-    
+#endif
+
     if (status != currentStatus) {
         currentStatus = status;
         t_statusTransition = mocpp_tick_ms();
@@ -399,8 +415,15 @@ void Connector::loop() {
         Timestamp reportedTimestamp = model.getClock().now();
         reportedTimestamp -= (mocpp_tick_ms() - t_statusTransition) / 1000UL;
 
-        auto statusNotification = makeRequest(
-                new StatusNotification(connectorId, reportedStatus, reportedTimestamp, getErrorCode()));
+        auto statusNotification =
+            #if MO_ENABLE_V201
+            model.getVersion().major == 2 ?
+                makeRequest(
+                    new Ocpp201::StatusNotification(connectorId, reportedStatus, reportedTimestamp)) :
+            #endif //MO_ENABLE_V201
+                makeRequest(
+                    new Ocpp16::StatusNotification(connectorId, reportedStatus, reportedTimestamp, getErrorCode()));
+
         statusNotification->setTimeout(0);
         context.initiateRequest(std::move(statusNotification));
         return;
@@ -621,7 +644,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     transaction->commit();
 
-    auto authorize = makeRequest(new Authorize(context.getModel(), idTag));
+    auto authorize = makeRequest(new Ocpp16::Authorize(context.getModel(), idTag));
     authorize->setTimeout(authorizationTimeoutInt && authorizationTimeoutInt->getInt() > 0 ? authorizationTimeoutInt->getInt() * 1000UL : 20UL * 1000UL);
     auto tx = transaction;
     authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
diff --git a/src/MicroOcpp/Model/ConnectorBase/EvseId.h b/src/MicroOcpp/Model/ConnectorBase/EvseId.h
new file mode 100644
index 00000000..14a3c661
--- /dev/null
+++ b/src/MicroOcpp/Model/ConnectorBase/EvseId.h
@@ -0,0 +1,35 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_EVSEID_H
+#define MO_EVSEID_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+// number of EVSEs. Defaults to MO_NUMCONNECTORS if defined, otherwise to 2
+#ifndef MO_NUM_EVSE
+#if defined(MO_NUMCONNECTORS)
+#define MO_NUM_EVSE MO_NUMCONNECTORS
+#else
+#define MO_NUM_EVSE 2
+#endif
+#endif // MO_NUM_EVSE
+
+namespace MicroOcpp {
+
+// EVSEType (2.23)
+struct EvseId {
+    int id;
+    int connectorId = -1; //optional
+
+    EvseId(int id) : id(id) { }
+    EvseId(int id, int connectorId) : id(id), connectorId(connectorId) { }
+};
+
+}
+
+#endif // MO_ENABLE_V201
+#endif
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index d97bedd7..1441b62d 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Model.h>
@@ -17,6 +17,8 @@
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Model/Boot/BootService.h>
 #include <MicroOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 
 #include <MicroOcpp/Core/Configuration.h>
@@ -25,7 +27,7 @@
 
 using namespace MicroOcpp;
 
-Model::Model(uint16_t bootNr) : bootNr(bootNr) {
+Model::Model(ProtocolVersion version, uint16_t bootNr) : version(version), bootNr(bootNr) {
 
 }
 
@@ -73,6 +75,11 @@ void Model::loop() {
     
     if (resetService)
         resetService->loop();
+
+#if MO_ENABLE_V201
+    if (transactionService)
+        transactionService->loop();
+#endif
 }
 
 void Model::setTransactionStore(std::unique_ptr<TransactionStore> ts) {
@@ -197,10 +204,34 @@ CertificateService *Model::getCertificateService() const {
     return certService.get();
 }
 
+#if MO_ENABLE_V201
+void Model::setVariableService(std::unique_ptr<VariableService> vs) {
+    this->variableService = std::move(vs);
+    capabilitiesUpdated = true;
+}
+
+VariableService *Model::getVariableService() const {
+    return variableService.get();
+}
+
+void Model::setTransactionService(std::unique_ptr<TransactionService> ts) {
+    this->transactionService = std::move(ts);
+    capabilitiesUpdated = true;
+}
+
+TransactionService *Model::getTransactionService() const {
+    return transactionService.get();
+}
+#endif
+
 Clock& Model::getClock() {
     return clock;
 }
 
+const ProtocolVersion& Model::getVersion() const {
+    return version;
+}
+
 uint16_t Model::getBootNr() {
     return bootNr;
 }
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 81ec653e..1d2dfa8a 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_MODEL_H
@@ -8,6 +8,7 @@
 #include <memory>
 
 #include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Version.h>
 #include <MicroOcpp/Model/ConnectorBase/Connector.h>
 
 namespace MicroOcpp {
@@ -25,6 +26,11 @@ class BootService;
 class ResetService;
 class CertificateService;
 
+#if MO_ENABLE_V201
+class VariableService;
+class TransactionService;
+#endif
+
 class Model {
 private:
     std::vector<std::unique_ptr<Connector>> connectors;
@@ -40,8 +46,16 @@ class Model {
     std::unique_ptr<BootService> bootService;
     std::unique_ptr<ResetService> resetService;
     std::unique_ptr<CertificateService> certService;
+
+#if MO_ENABLE_V201
+    std::unique_ptr<VariableService> variableService;
+    std::unique_ptr<TransactionService> transactionService;
+#endif
+
     Clock clock;
 
+    ProtocolVersion version;
+
     bool capabilitiesUpdated = true;
     void updateSupportedStandardProfiles();
 
@@ -50,7 +64,7 @@ class Model {
     const uint16_t bootNr = 0; //each boot of this lib has a unique number
 
 public:
-    Model(uint16_t bootNr = 0);
+    Model(ProtocolVersion version = ProtocolVersion(1,6), uint16_t bootNr = 0);
     Model(const Model& rhs) = delete;
     ~Model();
 
@@ -97,8 +111,18 @@ class Model {
     void setCertificateService(std::unique_ptr<CertificateService> cs);
     CertificateService *getCertificateService() const;
 
+#if MO_ENABLE_V201
+    void setVariableService(std::unique_ptr<VariableService> vs);
+    VariableService *getVariableService() const;
+
+    void setTransactionService(std::unique_ptr<TransactionService> ts);
+    TransactionService *getTransactionService() const;
+#endif
+
     Clock &getClock();
 
+    const ProtocolVersion& getVersion() const;
+
     uint16_t getBootNr();
 };
 
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index 1c711da6..cfc8a6f3 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef TRANSACTION_H
@@ -165,7 +165,150 @@ class Transaction {
     bool isSilent() {return silent;} //no data will be sent to server and server will not assign transactionId
 };
 
-}
+} // namespace MicroOcpp
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <memory>
+
+#include <MicroOcpp/Model/Authorization/IdToken.h>
+#include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+
+#define MO_TXID_LEN_MAX 36
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+class Transaction {
+public:
+    struct SubStatus {
+        bool triggered = false;
+        bool untriggered = false;
+        SendStatus remote;
+    };
+
+//private:
+    //SubStatus parkingBayOccupancy; // not supported
+    SubStatus evConnected;
+    SubStatus authorized;
+    SubStatus dataSigned;
+    SubStatus powerPathClosed;
+    SubStatus energyTransfer;
+
+    /*
+     * Global transaction data
+     */
+    bool active = true;         //once active is false, the tx must stop (or cannot start at all)
+    bool isAuthorized = false;    //if the given idToken was authorized
+    bool isDeauthorized = false;  //if the server revoked a local authorization
+    unsigned int seqNoCounter = 0; // increment by 1 for each event
+    IdToken idToken;
+    Timestamp startTime = MIN_TIME;
+    char transactionId [MO_TXID_LEN_MAX + 1] = {'\0'};
+    int remoteStartId = -1;
+
+    bool idTokenTransmitted = false;
+};
+
+// TransactionEventRequest (1.60.1)
+class TransactionEventData {
+public:
+
+    // TransactionEventEnumType (3.80)
+    enum class Type : uint8_t {
+        Ended,
+        Started,
+        Updated
+    };
+
+    // TriggerReasonEnumType (3.82)
+    enum class TriggerReason : uint8_t {
+        Authorized,
+        CablePluggedIn,
+        ChargingRateChanged,
+        ChargingStateChanged,
+        Deauthorized,
+        EnergyLimitReached,
+        EVCommunicationLost,
+        EVConnectTimeout,
+        MeterValueClock,
+        MeterValuePeriodic,
+        TimeLimitReached,
+        Trigger,
+        UnlockCommand,
+        StopAuthorized,
+        EVDeparted,
+        EVDetected,
+        RemoteStop,
+        RemoteStart,
+        AbnormalCondition,
+        SignedDataReceived,
+        ResetCommand
+    };
+
+    // ChargingStateEnumType (3.16)
+    enum class ChargingState : uint8_t {
+        UNDEFINED, // not part of OCPP
+        Charging,
+        EVConnected,
+        SuspendedEV,
+        SuspendedEVSE,
+        Idle
+    };
+
+    // ReasonEnumType (3.67)
+    enum class StopReason : uint8_t {
+        UNDEFINED, // not part of OCPP
+        DeAuthorized,
+        EmergencyStop,
+        EnergyLimitReached,
+        EVDisconnected,
+        GroundFault,
+        ImmediateReset,
+        Local,
+        LocalOutOfCredit,
+        MasterPass,
+        Other,
+        OvercurrentFault,
+        PowerLoss,
+        PowerQuality,
+        Reboot,
+        Remote,
+        SOCLimitReached,
+        StoppedByEV,
+        TimeLimitReached,
+        Timeout
+    };
+
+//private:
+    std::shared_ptr<Transaction> transaction;
+    Type eventType;
+    Timestamp timestamp;
+    TriggerReason triggerReason;
+    const unsigned int seqNo;
+    bool offline = false;
+    int numberOfPhasesUsed = -1;
+    int cableMaxCurrent = -1;
+    int reservationId = -1;
+
+    // TransactionType (2.48)
+    ChargingState chargingState = ChargingState::UNDEFINED;
+    //int timeSpentCharging = 0; // not supported
+    StopReason stoppedReason = StopReason::UNDEFINED;
+
+    bool idTokenTransmit = false; // if the idToken has been updated should be transmitted with this Event
+    EvseId evse = -1;
+    //meterValue not supported
+
+    TransactionEventData(std::shared_ptr<Transaction> transaction, unsigned int seqNo) : transaction(transaction), seqNo(seqNo) { }
+};
+
+} // namespace Ocpp201
+} // namespace MicroOcpp
+
+#endif // MO_ENABLE_V201
 
 extern "C" {
 #endif //__cplusplus
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
new file mode 100644
index 00000000..7a8ed1c6
--- /dev/null
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -0,0 +1,373 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
+
+#include <string.h>
+
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Operations/TransactionEvent.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Debug.h>
+
+using namespace MicroOcpp;
+using namespace MicroOcpp::Ocpp201;
+
+TransactionService::Evse::Evse(Context& context, TransactionService& txService, unsigned int evseId) :
+        context(context), txService(txService), evseId(evseId) {
+
+}
+
+std::unique_ptr<Ocpp201::Transaction> TransactionService::Evse::allocateTransaction() {
+    auto tx =  std::unique_ptr<Ocpp201::Transaction>(new Ocpp201::Transaction());
+    if (!tx) {
+        // OOM
+        return nullptr;
+    }
+
+    //simple clock-based hash
+    int v = context.getModel().getClock().now() - Timestamp(2020,0,0,0,0,0);
+    unsigned int h = v;
+    h *= 749572633U;
+    h %= 24593209U;
+    for (size_t i = 0; i < sizeof(tx->transactionId) - 3; i += 2) {
+        sprintf(tx->transactionId + i, "%02X", (uint8_t)h);
+        h *= 749572633U;
+        h %= 24593209U;
+    }
+
+    return tx;
+}
+
+void TransactionService::Evse::loop() {
+
+    bool txStarted = false;
+    bool txStopped = false;
+
+    bool txUpdated = false;
+
+    TransactionEventData::TriggerReason triggerReason; // only valid if txStarted || txStopped || txUpdated
+    TransactionEventData::StopReason stoppedReason; // only valid if txStopped
+
+    if (!txStarted && !txStopped && !txUpdated) {
+        if (connectorPluggedInput && connectorPluggedInput()) {
+            if (!transaction && txService.isTxStartPoint(TxStartStopPoint::EVConnected)) {
+                transaction = allocateTransaction();
+                txStarted = true;
+            }
+
+            if (transaction && !transaction->evConnected.triggered) {
+                transaction->evConnected.triggered = true;
+                txUpdated = true;
+                triggerReason = TransactionEventData::TriggerReason::CablePluggedIn;
+            }
+        } else if (connectorPluggedInput && !connectorPluggedInput()) {
+            if (transaction && transaction->evConnected.triggered) {
+                if (!transaction->evConnected.untriggered) {
+                    transaction->evConnected.untriggered = true;
+                    txUpdated = true;
+                    triggerReason = TransactionEventData::TriggerReason::EVCommunicationLost;
+                }
+
+                if (txService.isTxStopPoint(TxStartStopPoint::EVConnected)) {
+                    txStopped = true;
+                    stoppedReason = TransactionEventData::StopReason::EVDisconnected;
+                }
+            }
+        }
+    }
+
+    if (!txStarted && !txStopped && !txUpdated) {
+        if (evseReadyInput && evseReadyInput()) {
+            if (!transaction && txService.isTxStartPoint(TxStartStopPoint::PowerPathClosed)) {
+                transaction = allocateTransaction();
+                txStarted = true;
+            }
+
+            if (transaction && !transaction->powerPathClosed.triggered) {
+                transaction->powerPathClosed.triggered = true;
+                txUpdated = true;
+                triggerReason = TransactionEventData::TriggerReason::ChargingStateChanged;
+            }
+        } else if (evseReadyInput && !evseReadyInput()) {
+            if (transaction && transaction->powerPathClosed.triggered) {
+                if (!transaction->powerPathClosed.untriggered) {
+                    transaction->powerPathClosed.untriggered = true;
+                    txUpdated = true;
+                    triggerReason = TransactionEventData::TriggerReason::ChargingStateChanged;
+                }
+
+                if (txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed)) {
+                    txStopped = true;
+                    stoppedReason = TransactionEventData::StopReason::StoppedByEV;
+                }
+            }
+        }
+    }
+
+    if (!txStarted && !txStopped && !txUpdated) {
+        if (authorization.get()) {
+            if (!transaction && txService.isTxStartPoint(TxStartStopPoint::Authorized)) {
+                transaction = allocateTransaction();
+                txStarted = true;
+            }
+
+            if (transaction && !transaction->authorized.triggered) {
+                transaction->authorized.triggered = true;
+                txUpdated = true;
+                triggerReason = TransactionEventData::TriggerReason::Authorized;
+            }
+        } else {
+            if (transaction && transaction->authorized.triggered) {
+                if (!transaction->authorized.untriggered) {
+                    transaction->authorized.untriggered = true;
+                    txUpdated = true;
+                    triggerReason = TransactionEventData::TriggerReason::StopAuthorized;
+                }
+
+                if (txService.isTxStopPoint(TxStartStopPoint::EVConnected)) {
+                    txStopped = true;
+                    stoppedReason = TransactionEventData::StopReason::Local;
+                }
+            }
+        }
+    }
+
+    if (txStarted) {
+       transaction->evConnected.triggered |= connectorPluggedInput && connectorPluggedInput();
+       transaction->powerPathClosed.triggered |= evseReadyInput && evseReadyInput();
+       transaction->authorized.triggered |= authorization.get() != nullptr;
+    }
+
+    TransactionEventData::ChargingState chargingState = TransactionEventData::ChargingState::Idle;
+    if (transaction) {
+        chargingState = TransactionEventData::ChargingState::Charging;
+
+        if (connectorPluggedInput && !connectorPluggedInput()) {
+            chargingState = TransactionEventData::ChargingState::Idle;
+        } else if (!authorization.get()) {
+            chargingState = TransactionEventData::ChargingState::EVConnected;
+        } else if (evseReadyInput && !evseReadyInput()) { 
+            chargingState = TransactionEventData::ChargingState::SuspendedEVSE;
+        } else if (evReadyInput && !evReadyInput()) {
+            chargingState = TransactionEventData::ChargingState::SuspendedEV;
+        } else {
+            chargingState = TransactionEventData::ChargingState::Charging;
+        }
+    }
+
+    if (txStarted && txStopped) {
+        MO_DBG_ERR("tx started and stopped");
+        transaction.reset();
+        return;
+    } else if (txStarted || txStopped || txUpdated) {
+        auto txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
+        if (!txEvent) {
+            // OOM
+            transaction->active = false;
+            return;
+        }
+
+        txEvent->eventType = txStarted ? TransactionEventData::Type::Started :
+                             txStopped ? TransactionEventData::Type::Ended :
+                                         TransactionEventData::Type::Updated;
+        
+        txEvent->timestamp = context.getModel().getClock().now();
+        txEvent->triggerReason = triggerReason;
+        
+        if (chargingState != trackChargingState) {
+            txEvent->chargingState = chargingState;
+        }
+        trackChargingState = chargingState;
+
+        if (txStopped) {
+            txEvent->stoppedReason = stoppedReason;
+        }
+
+        if (authorization.get() && !transaction->idTokenTransmitted) {
+            txEvent->transaction->idToken = authorization;
+            txEvent->idTokenTransmit = true;
+            transaction->idTokenTransmitted = true;
+        }
+
+        txEvent->evse = evseId;
+
+        // meterValue not supported
+
+        auto txEventRequest = makeRequest(new Ocpp201::TransactionEvent(context.getModel(), txEvent));
+        txEventRequest->setTimeout(0);
+        context.initiateRequest(std::move(txEventRequest));
+
+        if (txStopped) {
+            MO_DBG_DEBUG("drop completed transaction");
+            transaction.reset();
+        }
+    }
+}
+
+void TransactionService::Evse::setConnectorPluggedInput(std::function<bool()> connectorPlugged) {
+    this->connectorPluggedInput = connectorPlugged;
+}
+
+void TransactionService::Evse::setEvReadyInput(std::function<bool()> evRequestsEnergy) {
+    this->evReadyInput = evRequestsEnergy;
+}
+
+void TransactionService::Evse::setEvseReadyInput(std::function<bool()> connectorEnergized) {
+    this->evseReadyInput = connectorEnergized;
+}
+
+bool TransactionService::Evse::beginAuthorization(IdToken idToken) {
+    MO_DBG_DEBUG("begin auth: %s", idToken.get());
+    auto authorize = makeRequest(new Ocpp16::CustomOperation(
+            "Authorize",
+            [idToken] () {
+                auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                        JSON_OBJECT_SIZE(3) +
+                        JSON_OBJECT_SIZE(2) +
+                        MO_IDTOKEN_LEN_MAX + 1));
+                auto payload = doc->to<JsonObject>();
+                payload["idToken"]["idToken"] = idToken.get();
+                payload["idToken"]["type"] = idToken.getTypeCstr();
+                return doc;
+            }, [this, idToken] (JsonObject response) {
+                if (!strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
+                    authorization = idToken;
+                    if (transaction) {
+                        transaction->idTokenTransmitted = false;
+                    }
+                    MO_DBG_DEBUG("confirmed auth: %s", idToken.get());
+                }
+            }));
+    context.initiateRequest(std::move(authorize));
+    return true;
+}
+bool TransactionService::Evse::endAuthorization(IdToken idToken) {
+    MO_DBG_DEBUG("end auth: %s", idToken.get()? idToken.get() : "(empty)");
+    authorization = IdToken();
+    if (transaction) {
+        transaction->idTokenTransmitted = false;
+    }
+    return true;
+}
+const char *TransactionService::Evse::getAuthorization() {
+    return authorization.get();
+}
+
+bool TransactionService::isTxStartPoint(TxStartStopPoint check) {
+    for (auto& v : txStartPointParsed) {
+        if (v == check) {
+            return true;
+        }
+    }
+    return false;
+}
+bool TransactionService::isTxStopPoint(TxStartStopPoint check) {
+    for (auto& v : txStopPointParsed) {
+        if (v == check) {
+            return true;
+        }
+    }
+    return false;
+}
+
+bool TransactionService::parseTxStartStopPoint(const char *csl, std::vector<TxStartStopPoint>& dst) {
+    dst.clear();
+
+    while (*csl == ',') {
+        csl++;
+    }
+
+    while (*csl) {
+        if (!strncmp(csl, "ParkingBayOccupancy", sizeof("ParkingBayOccupancy") - 1)
+                && (csl[sizeof("ParkingBayOccupancy") - 1] == '\0' || csl[sizeof("ParkingBayOccupancy") - 1] == ',')) {
+            dst.push_back(TxStartStopPoint::ParkingBayOccupancy);
+            csl += sizeof("ParkingBayOccupancy") - 1;
+        } else if (!strncmp(csl, "EVConnected", sizeof("EVConnected") - 1)
+                && (csl[sizeof("EVConnected") - 1] == '\0' || csl[sizeof("EVConnected") - 1] == ',')) {
+            dst.push_back(TxStartStopPoint::EVConnected);
+            csl += sizeof("EVConnected") - 1;
+        } else if (!strncmp(csl, "Authorized", sizeof("Authorized") - 1)
+                && (csl[sizeof("Authorized") - 1] == '\0' || csl[sizeof("Authorized") - 1] == ',')) {
+            dst.push_back(TxStartStopPoint::Authorized);
+            csl += sizeof("Authorized") - 1;
+        } else if (!strncmp(csl, "DataSigned", sizeof("DataSigned") - 1)
+                && (csl[sizeof("DataSigned") - 1] == '\0' || csl[sizeof("DataSigned") - 1] == ',')) {
+            dst.push_back(TxStartStopPoint::DataSigned);
+            csl += sizeof("DataSigned") - 1;
+        } else if (!strncmp(csl, "PowerPathClosed", sizeof("PowerPathClosed") - 1)
+                && (csl[sizeof("PowerPathClosed") - 1] == '\0' || csl[sizeof("PowerPathClosed") - 1] == ',')) {
+            dst.push_back(TxStartStopPoint::PowerPathClosed);
+            csl += sizeof("PowerPathClosed") - 1;
+        } else if (!strncmp(csl, "EnergyTransfer", sizeof("EnergyTransfer") - 1)
+                && (csl[sizeof("EnergyTransfer") - 1] == '\0' || csl[sizeof("EnergyTransfer") - 1] == ',')) {
+            dst.push_back(TxStartStopPoint::EnergyTransfer);
+            csl += sizeof("EnergyTransfer") - 1;
+        } else {
+            MO_DBG_ERR("unkown TxStartStopPoint");
+            dst.clear();
+            return false;
+        }
+
+        while (*csl == ',') {
+            csl++;
+        }
+    }
+
+    return true;
+}
+
+TransactionService::TransactionService(Context& context) : context(context) {
+    auto variableService = context.getModel().getVariableService();
+
+    TxStartPointString = variableService->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "PowerPathClosed");
+    TxStopPointString  = variableService->declareVariable<const char*>("TxCtrlr", "TxStopPoint",  "Authorized,EVConnected");
+
+    variableService->registerValidator<const char*>("TxCtrlr", "TxStartPoint", [this] (const char *value) -> bool {
+        std::vector<TxStartStopPoint> validated;
+        return this->parseTxStartStopPoint(value, validated);
+    });
+
+    variableService->registerValidator<const char*>("TxCtrlr", "TxStopPoint", [this] (const char *value) -> bool {
+        std::vector<TxStartStopPoint> validated;
+        return this->parseTxStartStopPoint(value, validated);
+    });
+
+    for (unsigned int evseId = 1; evseId < MO_NUM_EVSE; evseId++) {
+        evses.emplace_back(context, *this, evseId);
+    }
+}
+
+void TransactionService::loop() {
+    for (Evse& evse : evses) {
+        evse.loop();
+    }
+
+    if (TxStartPointString->getWriteCount() != trackTxStartPoint) {
+        parseTxStartStopPoint(TxStartPointString->getString(), txStartPointParsed);
+    }
+
+    if (TxStopPointString->getWriteCount() != trackTxStopPoint) {
+        parseTxStartStopPoint(TxStopPointString->getString(), txStopPointParsed);
+    }
+}
+
+TransactionService::Evse *TransactionService::getEvse(unsigned int evseId) {
+    if (evseId >= 1 && evseId - 1 < evses.size()) {
+        return &evses[evseId - 1];
+    } else {
+        MO_DBG_ERR("invalid arg");
+        return nullptr;
+    }
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.h b/src/MicroOcpp/Model/Transactions/TransactionService.h
new file mode 100644
index 00000000..6e39981e
--- /dev/null
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.h
@@ -0,0 +1,99 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+/*
+ * Implementation of the UCs E01 - E12
+ */
+
+#ifndef MO_TRANSACTIONSERVICE_H
+#define MO_TRANSACTIONSERVICE_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+
+#include <memory>
+#include <functional>
+#include <vector>
+
+namespace MicroOcpp {
+
+class Context;
+class Variable;
+
+class TransactionService {
+public:
+
+    class Evse {
+    private:
+        Context& context;
+        TransactionService& txService;
+        const unsigned int evseId;
+        std::shared_ptr<Ocpp201::Transaction> transaction;
+        Ocpp201::TransactionEventData::ChargingState trackChargingState = Ocpp201::TransactionEventData::ChargingState::UNDEFINED;
+
+        std::function<bool()> connectorPluggedInput;
+        std::function<bool()> evReadyInput;
+        std::function<bool()> evseReadyInput;
+
+        IdToken authorization;
+
+        std::unique_ptr<Ocpp201::Transaction> allocateTransaction();
+    public:
+        Evse(Context& context, TransactionService& txService, unsigned int evseId);
+
+        void loop();
+
+        void setConnectorPluggedInput(std::function<bool()> connectorPlugged);
+        void setEvReadyInput(std::function<bool()> evRequestsEnergy);
+        void setEvseReadyInput(std::function<bool()> connectorEnergized);
+
+        bool beginAuthorization(IdToken idToken);
+        bool endAuthorization(IdToken idToken = IdToken());
+        const char *getAuthorization();
+    };
+
+    friend Evse;
+
+private:
+
+    // TxStartStopPoint (2.6.4.1)
+    enum class TxStartStopPoint : uint8_t {
+        ParkingBayOccupancy,
+        EVConnected,
+        Authorized,
+        DataSigned,
+        PowerPathClosed,
+        EnergyTransfer
+    };
+
+    Context& context;
+    std::vector<Evse> evses;
+
+    Variable *TxStartPointString = nullptr;
+    Variable *TxStopPointString = nullptr;
+    uint16_t trackTxStartPoint = -1;
+    uint16_t trackTxStopPoint = -1;
+    std::vector<TxStartStopPoint> txStartPointParsed;
+    std::vector<TxStartStopPoint> txStopPointParsed;
+    bool isTxStartPoint(TxStartStopPoint check);
+    bool isTxStopPoint(TxStartStopPoint check);
+
+    bool parseTxStartStopPoint(const char *src, std::vector<TxStartStopPoint>& dst);
+
+public:
+    TransactionService(Context& context);
+
+    void loop();
+
+    Evse *getEvse(unsigned int evseId);
+};
+
+} // namespace MicroOcpp
+
+#endif // MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Model/Variables/Variable.cpp b/src/MicroOcpp/Model/Variables/Variable.cpp
new file mode 100644
index 00000000..65ff402e
--- /dev/null
+++ b/src/MicroOcpp/Model/Variables/Variable.cpp
@@ -0,0 +1,405 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+/*
+ * Implementation of the UCs B05 - B06
+ */
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Variables/Variable.h>
+
+#include <string.h>
+
+#include <MicroOcpp/Debug.h>
+
+using namespace MicroOcpp;
+
+ComponentId::ComponentId(const char *name) : name(name) { }
+ComponentId::ComponentId(const char *name, EvseId evse) : name(name), evse(evse) { }
+
+bool ComponentId::equals(const ComponentId& other) const {
+    return !strcmp(name, other.name) &&
+        ((evse.id < 0 && other.evse.id < 0) || (evse.id == other.evse.id)) && // evseId undefined or equal
+        ((evse.connectorId < 0 && other.evse.connectorId < 0) || (evse.connectorId == other.evse.connectorId)); // connectorId undefined or equal
+}
+
+bool Variable::AttributeTypeSet::has(AttributeType type) {
+    switch(type) {
+        case AttributeType::Actual:
+            return flag & (1 << 0);
+        case AttributeType::Target:
+            return flag & (1 << 1);
+        case AttributeType::MinSet:
+            return flag & (1 << 2);
+        case AttributeType::MaxSet:
+            return flag & (1 << 3);
+    }
+    MO_DBG_ERR("internal error");
+    return false;
+}
+
+Variable::AttributeTypeSet& Variable::AttributeTypeSet::set(AttributeType type) {
+    switch(type) {
+        case AttributeType::Actual:
+            flag |= (1 << 0);
+            break;
+        case AttributeType::Target:
+            flag |= (1 << 1);
+            break;
+        case AttributeType::MinSet:
+            flag |= (1 << 2);
+            break;
+        case AttributeType::MaxSet:
+            flag |= (1 << 3);
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            break;
+    }
+    return *this;
+}
+
+size_t Variable::AttributeTypeSet::count() {
+    return (flag & (1 << 0) ? 1 : 0) +
+           (flag & (1 << 1) ? 1 : 0) +
+           (flag & (1 << 2) ? 1 : 0) +
+           (flag & (1 << 3) ? 1 : 0);
+}
+
+Variable::AttributeTypeSet::AttributeTypeSet(AttributeType attrType) {
+    set(attrType);
+}
+
+Variable::Variable(AttributeTypeSet attributes) : attributes(attributes) { }
+
+Variable::~Variable() {
+
+}
+
+void Variable::setName(const char *name) {
+    this->variableName = name;
+}
+const char *Variable::getName() const {
+    return variableName;
+}
+
+void Variable::setComponentId(const ComponentId& componentId) {
+    this->component = componentId;
+}
+const ComponentId& Variable::getComponentId() const {
+    return component;
+}
+
+void Variable::setInt(int val, AttributeType) {
+    MO_DBG_ERR("type err");
+    (void)0;
+}
+void Variable::setBool(bool val, AttributeType) {
+    MO_DBG_ERR("type err");
+    (void)0;
+}
+bool Variable::setString(const char *val, AttributeType) {
+    MO_DBG_ERR("type err");
+    return false;
+}
+
+int Variable::getInt(AttributeType) {
+    MO_DBG_ERR("type err");
+    return 0;
+}
+bool Variable::getBool(AttributeType) {
+    MO_DBG_ERR("type err");
+    return false;
+}
+const char *Variable::getString(AttributeType) {
+    MO_DBG_ERR("type err");
+    return nullptr;
+}
+
+bool Variable::hasAttribute(AttributeType attrType) {
+    return attributes.has(attrType);
+}
+
+void Variable::setVariableDataType(VariableCharacteristics::DataType dataType) {
+    this->dataType = dataType;
+}
+VariableCharacteristics::DataType Variable::getVariableDataType() {
+    return dataType;
+}
+
+bool Variable::getSupportsMonitoring() {
+    return supportsMonitoring;
+}
+void Variable::setSupportsMonitoring() {
+    supportsMonitoring = true;
+}
+
+bool Variable::isRebootRequired() {
+    return rebootRequired;
+}
+void Variable::setRebootRequired() {
+    rebootRequired = true;
+}
+
+void Variable::setMutability(Mutability m) {
+    this->mutability = m;
+}
+Variable::Mutability Variable::getMutability() {
+    return mutability;
+}
+
+void Variable::setPersistent() {
+    persistent = true;
+}
+bool Variable::isPersistent() {
+    return persistent;
+}
+
+void Variable::setConstant() {
+    constant = true;
+}
+bool Variable::isConstant() {
+    return constant;
+}
+
+void Variable::detach() {
+    detached = true;
+}
+bool Variable::isDetached() {
+    return detached;
+}
+
+template <class T>
+struct VariableSingleData {
+    T value = 0;
+
+    T& get(Variable::AttributeType attribute) {
+        return value;
+    }
+};
+
+template <class T>
+struct VariableFullData {
+    T actual = 0;
+    T target = 0;
+    T minSet = 0;
+    T maxSet = 0;
+
+    T& get(Variable::AttributeType attribute) {
+        switch(attribute) {
+            case Variable::AttributeType::Actual:
+                return actual;
+            case Variable::AttributeType::Target:
+                return target;
+            case Variable::AttributeType::MinSet:
+                return minSet;
+            case Variable::AttributeType::MaxSet:
+                return maxSet;
+        }
+        MO_DBG_ERR("internal error");
+        return actual;
+    }
+};
+
+template <template<class T> class VariableData>
+class VariableInt : public Variable {
+private:
+    VariableData<int> value;
+    uint16_t writeCount = 0;
+
+    #if MO_VARIABLE_TYPECHECK
+    AttributeTypeSet attributes;
+    #endif
+public:
+    VariableInt(AttributeTypeSet attributes) :
+        Variable(attributes)
+        #if MO_VARIABLE_TYPECHECK
+        , attributes(attributes)
+        #endif
+    {
+
+    }
+
+    void setInt(int val, AttributeType attrType) override {
+        #if MO_VARIABLE_TYPECHECK
+        if (!attributes.has(attrType)) {
+            MO_DBG_ERR("type err");
+            return;
+        }
+        #endif
+        value.get(attrType) = val;
+        writeCount++;
+    }
+
+    int getInt(AttributeType attrType) override {
+        #if MO_VARIABLE_TYPECHECK
+        if (!attributes.has(attrType)) {
+            MO_DBG_ERR("type err");
+            return 0;
+        }
+        #endif
+        return value.get(attrType);
+    }
+
+    InternalDataType getInternalDataType() override {
+        return InternalDataType::Int;
+    }
+
+    uint16_t getWriteCount() override {
+        return writeCount;
+    }
+};
+
+template <template<class T> class VariableData>
+class VariableBool : public Variable {
+private:
+    VariableData<bool> value;
+    uint16_t writeCount = 0;
+
+    #if MO_VARIABLE_TYPECHECK
+    AttributeTypeSet attributes;
+    #endif
+public:
+    VariableBool(AttributeTypeSet attributes) :
+        Variable(attributes)
+        #if MO_VARIABLE_TYPECHECK
+        , attributes(attributes)
+        #endif
+    {
+
+    }
+
+    void setBool(bool val, AttributeType attrType) override {
+        #if MO_VARIABLE_TYPECHECK
+        if (!attributes.has(attrType)) {
+            MO_DBG_ERR("type err");
+            return;
+        }
+        #endif
+        value.get(attrType) = val;
+        writeCount++;
+    }
+
+    bool getBool(AttributeType attrType) override {
+        #if MO_VARIABLE_TYPECHECK
+        if (!attributes.has(attrType)) {
+            MO_DBG_ERR("type err");
+            return 0;
+        }
+        #endif
+        return value.get(attrType);
+    }
+
+    InternalDataType getInternalDataType() override {
+        return InternalDataType::Bool;
+    }
+
+    uint16_t getWriteCount() override {
+        return writeCount;
+    }
+};
+
+template <template<class T> class VariableData>
+class VariableString : public Variable {
+private:
+    VariableData<char*> value;
+    uint16_t writeCount = 0;
+
+    #if MO_VARIABLE_TYPECHECK
+    AttributeTypeSet attributes;
+    #endif
+public:
+    VariableString(AttributeTypeSet attributes) :
+        Variable(attributes)
+        #if MO_VARIABLE_TYPECHECK
+        , attributes(attributes)
+        #endif
+    {
+
+    }
+
+    ~VariableString() {
+        delete[] value.get(AttributeType::Actual);
+        value.get(AttributeType::Actual) = nullptr;
+        delete[] value.get(AttributeType::Target);
+        value.get(AttributeType::Target) = nullptr;
+        delete[] value.get(AttributeType::MinSet);
+        value.get(AttributeType::MinSet) = nullptr;
+        delete[] value.get(AttributeType::MaxSet);
+        value.get(AttributeType::MaxSet) = nullptr;
+    }
+
+    bool setString(const char *val, AttributeType attrType) override {
+        #if MO_VARIABLE_TYPECHECK
+        if (!attributes.has(attrType)) {
+            MO_DBG_ERR("type err");
+            return false;
+        }
+        #endif
+
+        size_t len = strlen(val);
+        char *valNew = nullptr;
+        if (len != 0) {
+            valNew = new char[len + 1];
+            if (!valNew) {
+                MO_DBG_ERR("OOM");
+                return false;
+            }
+            memcpy(valNew, val, len + 1);
+        }
+        delete[] value.get(attrType);
+        value.get(attrType) = valNew;
+        writeCount++;
+        return true;
+    }
+
+    const char *getString(AttributeType attrType) override {
+        #if MO_VARIABLE_TYPECHECK
+        if (!attributes.has(attrType)) {
+            MO_DBG_ERR("type err");
+            return 0;
+        }
+        #endif
+        return value.get(attrType) ? value.get(attrType) : "";
+    }
+
+    InternalDataType getInternalDataType() override {
+        return InternalDataType::String;
+    }
+
+    uint16_t getWriteCount() override {
+        return writeCount;
+    }
+};
+
+std::unique_ptr<Variable> MicroOcpp::makeVariable(Variable::InternalDataType dtype, Variable::AttributeTypeSet supportAttributes) {
+    switch(dtype) {
+        case Variable::InternalDataType::Int:
+            if (supportAttributes.count() > 1) {
+                return std::unique_ptr<Variable>(new VariableInt<VariableFullData>(supportAttributes));
+            } else {
+                return std::unique_ptr<Variable>(new VariableInt<VariableSingleData>(supportAttributes));
+            }
+        case Variable::InternalDataType::Bool:
+            if (supportAttributes.count() > 1) {
+                return std::unique_ptr<Variable>(new VariableBool<VariableFullData>(supportAttributes));
+            } else {
+                return std::unique_ptr<Variable>(new VariableBool<VariableSingleData>(supportAttributes));
+            }
+        case Variable::InternalDataType::String:
+            if (supportAttributes.count() > 1) {
+                return std::unique_ptr<Variable>(new VariableString<VariableFullData>(supportAttributes));
+            } else {
+                return std::unique_ptr<Variable>(new VariableString<VariableSingleData>(supportAttributes));
+            }
+    }
+
+    MO_DBG_ERR("internal error");
+    return nullptr;
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Variables/Variable.h b/src/MicroOcpp/Model/Variables/Variable.h
new file mode 100644
index 00000000..9f9061bb
--- /dev/null
+++ b/src/MicroOcpp/Model/Variables/Variable.h
@@ -0,0 +1,220 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+/*
+ * Implementation of the UCs B05 - B06
+ */
+
+#ifndef MO_VARIABLE_H
+#define MO_VARIABLE_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <stdint.h>
+#include <vector>
+#include <memory>
+#include <limits>
+
+#include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+
+#ifndef MO_VARIABLE_TYPECHECK
+#define MO_VARIABLE_TYPECHECK 1
+#endif
+
+namespace MicroOcpp {
+
+// VariableCharacteristicsType (2.51)
+struct VariableCharacteristics {
+
+    // DataEnumType (3.26)
+    enum class DataType : uint8_t {
+        string,
+        decimal,
+        integer,
+        dateTime,
+        boolean,
+        OptionList,
+        SequenceList,
+        MemberList
+    };
+
+    const char *unit = nullptr; //no copy
+    //DataType dataType; //stored in Variable
+    int minLimit = std::numeric_limits<int>::min();
+    int maxLimit = std::numeric_limits<int>::max();
+    const char *valuesList = nullptr; //no copy
+    //bool supportsMonitoring; //stored in Variable
+};
+
+// SetVariableStatusEnumType (3.79)
+enum class SetVariableStatus : uint8_t {
+    Accepted,
+    Rejected,
+    UnknownComponent,
+    UnknownVariable,
+    NotSupportedAttributeType,
+    RebootRequired
+};
+
+// GetVariableStatusEnumType (3.41)
+enum class GetVariableStatus : uint8_t {
+    Accepted,
+    Rejected,
+    UnknownComponent,
+    UnknownVariable,
+    NotSupportedAttributeType
+};
+
+// VariableMonitoringType (2.52)
+class VariableMonitor {
+public:
+    //MonitorEnumType (3.55)
+    enum class Type {
+        UpperThreshold,
+        LowerThreshold,
+        Delta,
+        Periodic,
+        PeriodicClockAligned
+    };
+private:
+    int id;
+    bool transaction;
+    float value;
+    Type type;
+    int severity;
+public:
+    VariableMonitor() = delete;
+    VariableMonitor(int id, bool transaction, float value, Type type, int severity) :
+            id(id), transaction(transaction), value(value), type(type), severity(severity) { }
+};
+
+// ComponentType (2.16)
+struct ComponentId {
+    const char *name; // zero copy
+    //const char *instance; // not supported in this implementation
+    EvseId evse {-1};
+
+    ComponentId(const char *name = nullptr);
+    ComponentId(const char *name, EvseId evse);
+
+    bool equals(const ComponentId& other) const;
+};
+
+/*
+ * Corresponds to VariableType (2.53)
+ *
+ * Template method pattern: this is a super-class which has hook-methods for storing and fetching
+ * the value of the variable. To make it use the host system's key-value store, extend this class
+ * with a custom implementation of the virtual methods and pass its instances to MO.
+ */
+class Variable {
+public:
+    //AttributeEnumType (3.2)
+    enum class AttributeType : uint8_t {
+        Actual,
+        Target,
+        MinSet,
+        MaxSet
+    };
+
+    struct AttributeTypeSet {
+        uint8_t flag = 0;
+
+        bool has(Variable::AttributeType type);
+        AttributeTypeSet& set(Variable::AttributeType type);
+        size_t count();
+
+        AttributeTypeSet(AttributeType attrType = AttributeType::Actual);
+    };
+
+    //MutabilityEnumType (3.58)
+    enum class Mutability : uint8_t {
+        ReadOnly,
+        WriteOnly,
+        ReadWrite
+    };
+
+    //MO-internal optimization: if value is only in int range, store it in more compact representation
+    enum class InternalDataType : uint8_t {
+        Int,
+        Bool,
+        String
+    };
+private:
+    const char *variableName = nullptr;
+    ComponentId component;
+
+    // VariableCharacteristicsType (2.51)
+    std::unique_ptr<VariableCharacteristics> characteristics; //optional VariableCharacteristics
+    VariableCharacteristics::DataType dataType; //mandatory
+    bool supportsMonitoring = false; //mandatory
+    bool rebootRequired = false; //MO-internal: if to respond status RebootRequired on SetVariables
+
+    // VariableAttributeType (2.50)
+    Mutability mutability = Mutability::ReadWrite;
+    bool persistent = false;
+    bool constant = false;
+
+    AttributeTypeSet attributes;
+
+    bool detached = false; // MO-internal: if a conflicting declaration comes in, discard the old Variable
+
+    // VariableMonitoringType (2.52)
+    //std::vector<VariableMonitor> monitors; // uncomment when testing Monitors
+public:
+    Variable(AttributeTypeSet attributes);
+
+    virtual ~Variable();
+
+    void setName(const char *name); //zero-copy
+    const char *getName() const;
+
+    void setComponentId(const ComponentId& componentId); //zero-copy
+    const ComponentId& getComponentId() const;
+
+    // set Value of Variable
+    virtual void setInt(int val, AttributeType attrType = AttributeType::Actual);
+    virtual void setBool(bool val, AttributeType attrType = AttributeType::Actual);
+    virtual bool setString(const char *val, AttributeType attrType = AttributeType::Actual);
+
+    // get Value of Variable
+    virtual int getInt(AttributeType attrType = AttributeType::Actual);
+    virtual bool getBool(AttributeType attrType = AttributeType::Actual);
+    virtual const char *getString(AttributeType attrType = AttributeType::Actual); //always returns c-string (empty if undefined)
+
+    virtual InternalDataType getInternalDataType() = 0; //corresponds to MO internal value representation
+    bool hasAttribute(AttributeType attrType);
+
+    void setVariableDataType(VariableCharacteristics::DataType dataType); //corresponds to OCPP DataEnumType (3.26)
+    VariableCharacteristics::DataType getVariableDataType(); //corresponds to OCPP DataEnumType (3.26)
+    bool getSupportsMonitoring();
+    void setSupportsMonitoring();
+    bool isRebootRequired();
+    void setRebootRequired();
+
+    void setMutability(Mutability m);
+    Mutability getMutability();
+
+    void setPersistent();
+    bool isPersistent();
+
+    void setConstant();
+    bool isConstant();
+
+    //bool addMonitor(int id, bool transaction, float value, VariableMonitor::Type type, int severity);
+    
+    virtual uint16_t getWriteCount() = 0; //get write count (use this as a pre-check if the value changed)
+
+    void detach();
+    bool isDetached();
+};
+
+std::unique_ptr<Variable> makeVariable(Variable::InternalDataType dtype, Variable::AttributeTypeSet supportAttributes);
+
+} // namespace MicroOcpp
+
+#endif // MO_ENABLE_V201
+#endif
diff --git a/src/MicroOcpp/Model/Variables/VariableContainer.cpp b/src/MicroOcpp/Model/Variables/VariableContainer.cpp
new file mode 100644
index 00000000..6d229c9c
--- /dev/null
+++ b/src/MicroOcpp/Model/Variables/VariableContainer.cpp
@@ -0,0 +1,73 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+/*
+ * Implementation of the UCs B05 - B06
+ */
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Variables/VariableContainer.h>
+
+#include <string.h>
+
+#include <MicroOcpp/Debug.h>
+
+using namespace MicroOcpp;
+
+VariableContainer::~VariableContainer() {
+
+}
+
+VariableContainerVolatile::VariableContainerVolatile(const char *filename, bool accessible) :
+        VariableContainer(filename, accessible) {
+
+}
+
+VariableContainerVolatile::~VariableContainerVolatile() {
+
+}
+
+bool VariableContainerVolatile::load() {
+    return true;
+}
+
+bool VariableContainerVolatile::save() {
+    return true;
+}
+
+std::unique_ptr<Variable> VariableContainerVolatile::createVariable(Variable::InternalDataType dtype, Variable::AttributeTypeSet attributes) {
+    return makeVariable(dtype, attributes);
+}
+
+bool VariableContainerVolatile::add(std::unique_ptr<Variable> variable) {
+    variables.push_back(std::move(variable));
+    return true;
+}
+
+size_t VariableContainerVolatile::size() const {
+    return variables.size();
+}
+
+Variable *VariableContainerVolatile::getVariable(size_t i) const {
+    return variables[i].get();
+}
+
+Variable *VariableContainerVolatile::getVariable(const ComponentId& component, const char *variableName) const {
+    for (auto it = variables.begin(); it != variables.end(); it++) {
+        if (!strcmp((*it)->getName(), variableName) &&
+                (*it)->getComponentId().equals(component)) {
+            return it->get();
+        }
+    }
+    return nullptr;
+}
+
+std::unique_ptr<VariableContainerVolatile> MicroOcpp::makeVariableContainerVolatile(const char *filename, bool accessible) {
+    return std::unique_ptr<VariableContainerVolatile>(new VariableContainerVolatile(filename, accessible));
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Variables/VariableContainer.h b/src/MicroOcpp/Model/Variables/VariableContainer.h
new file mode 100644
index 00000000..90ee41c9
--- /dev/null
+++ b/src/MicroOcpp/Model/Variables/VariableContainer.h
@@ -0,0 +1,78 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+/*
+ * Implementation of the UCs B05 - B06
+ */
+
+#ifndef MO_VARIABLECONTAINER_H
+#define MO_VARIABLECONTAINER_H
+
+#include <vector>
+#include <memory>
+
+#include <MicroOcpp/Model/Variables/Variable.h>
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+namespace MicroOcpp {
+
+class VariableContainer {
+private:
+    const char *filename;
+    bool accessible;
+public:
+    VariableContainer(const char *filename, bool accessible) : filename(filename), accessible(accessible) { }
+
+    virtual ~VariableContainer();
+
+    const char *getFilename() {return filename;}
+    bool isAccessible() const {return accessible;} //accessible by OCPP server or only used as internal persistent store
+
+    virtual bool load() = 0; //called at the end of mocpp_intialize, to load the Variables with the stored value
+    virtual bool save() = 0;
+
+    /*
+     * Factory method to create Variable objects. This doesn't add the returned Variable to the managed
+     * variable store. Instead, the caller must add the returned Variable via `add(...)`
+     * The function signature consists of the requested low-level data type (Int, Bool, or String) and
+     * a composite key to identify the Variable to create (componentName x variableName x attribute type)
+     *
+     * Variable::InternalDataType dtype: internal low-level data type. Defines which value getters / setters are valid.
+     *         if dtype == InternalDataType::Int, then getInt() and setInt(...) are valid
+     *         if dtype == InternalDataType::String, then getString() and setString(...) are valid. Etc.
+     */
+    virtual std::unique_ptr<Variable> createVariable(Variable::InternalDataType dtype, Variable::AttributeTypeSet attributes) = 0; // factory method
+    virtual bool add(std::unique_ptr<Variable> variable) = 0;
+
+    virtual size_t size() const = 0;
+    virtual Variable *getVariable(size_t i) const = 0;
+    virtual Variable *getVariable(const ComponentId& component, const char *variableName) const = 0;
+};
+
+class VariableContainerVolatile : public VariableContainer {
+private:
+    std::vector<std::unique_ptr<Variable>> variables;
+public:
+    VariableContainerVolatile(const char *filename, bool accessible);
+    ~VariableContainerVolatile();
+
+    //VariableContainer definitions
+    bool load() override;
+    bool save() override;
+    std::unique_ptr<Variable> createVariable(Variable::InternalDataType dtype, Variable::AttributeTypeSet attributes) override;
+    bool add(std::unique_ptr<Variable> config) override;
+    size_t size() const override;
+    Variable *getVariable(size_t i) const override;
+    Variable *getVariable(const ComponentId& component, const char *variableName) const override;
+};
+
+std::unique_ptr<VariableContainerVolatile> makeVariableContainerVolatile(const char *filename, bool accessible);
+
+} //end namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+#endif
diff --git a/src/MicroOcpp/Model/Variables/VariableService.cpp b/src/MicroOcpp/Model/Variables/VariableService.cpp
new file mode 100644
index 00000000..94ad0822
--- /dev/null
+++ b/src/MicroOcpp/Model/Variables/VariableService.cpp
@@ -0,0 +1,419 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+/*
+ * Implementation of the UCs B05 - B06
+ */
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Operations/SetVariables.h>
+#include <MicroOcpp/Operations/GetVariables.h>
+
+#include <cstring>
+#include <cctype>
+
+#include <MicroOcpp/Debug.h>
+
+namespace MicroOcpp {
+
+template <class T>
+VariableValidator<T>::VariableValidator(const ComponentId& component, const char *name, std::function<bool(T)> validate) :
+        component(component), name(name), validate(validate) {
+
+}
+
+template <class T>
+VariableValidator<T> *getVariableValidator(std::vector<VariableValidator<T>>& collection, const ComponentId& component, const char *name) {
+    for (auto& validator : collection) {
+        if (!strcmp(name, validator.name) && component.equals(validator.component)) {
+            return &validator;
+        }
+    }
+    return nullptr;
+}
+
+VariableValidator<int> *VariableService::getValidatorInt(const ComponentId& component, const char *name) {
+    return getVariableValidator<int>(validatorInt, component, name);
+}
+
+VariableValidator<bool> *VariableService::getValidatorBool(const ComponentId& component, const char *name) {
+    return getVariableValidator<bool>(validatorBool, component, name);
+}
+
+VariableValidator<const char*> *VariableService::getValidatorString(const ComponentId& component, const char *name) {
+    return getVariableValidator<const char*>(validatorString, component, name);
+}
+
+std::unique_ptr<VariableContainer> VariableService::createContainer(const char *filename, bool accessible) const {
+    //create non-persistent Variable store (i.e. lives only in RAM) if
+    //     - Flash FS usage is switched off OR
+    //     - Filename starts with "/volatile"
+//    if (!filesystem ||
+//                 !strncmp(filename, MO_VARIABLE_VOLATILE, strlen(MO_VARIABLE_VOLATILE))) {
+        return makeVariableContainerVolatile(filename, accessible);
+//    } else {
+//        //create persistent Variable store. This is the normal case
+//        return makeVariableContainerFlash(filesystem, filename, accessible);
+//    }
+}
+
+void VariableService::addContainer(std::shared_ptr<VariableContainer> container) {
+    containers.push_back(std::move(container));
+}
+
+std::shared_ptr<VariableContainer> VariableService::getContainer(const char *filename) {
+    for (auto& container : containers) {
+        if (!strcmp(filename, container->getFilename())) {
+            return container;
+        }
+    }
+    return nullptr;
+}
+
+template <class T>
+bool registerVariableValidator(std::vector<VariableValidator<T>>& collection, const ComponentId& component, const char *name, std::function<bool(T)> validate) {
+    for (auto it = collection.begin(); it != collection.end(); it++) {
+        if (!strcmp(name, it->name) && component.equals(it->component)) {
+            collection.erase(it);
+            break;
+        }
+    }
+    collection.emplace_back(component, name, validate);
+    return true;
+}
+
+template <>
+bool VariableService::registerValidator<int>(const ComponentId& component, const char *name, std::function<bool(int)> validate) {
+    return registerVariableValidator<int>(validatorInt, component, name, validate);
+}
+
+template <>
+bool VariableService::registerValidator<bool>(const ComponentId& component, const char *name, std::function<bool(bool)> validate) {
+    return registerVariableValidator<bool>(validatorBool, component, name, validate);
+}
+
+template <>
+bool VariableService::registerValidator<const char*>(const ComponentId& component, const char *name, std::function<bool(const char*)> validate) {
+    return registerVariableValidator<const char*>(validatorString, component, name, validate);
+}
+
+VariableContainer *VariableService::declareContainer(const char *filename, bool accessible) {
+
+    auto container = getContainer(filename);
+    
+    if (!container) {
+        MO_DBG_DEBUG("init new configurations container: %s", filename);
+
+        container = createContainer(filename, accessible);
+        if (!container) {
+            MO_DBG_ERR("OOM");
+            return nullptr;
+        }
+        containers.push_back(container);
+    }
+
+    if (container->isAccessible() != accessible) {
+        MO_DBG_ERR("%s: conflicting accessibility declarations (expect %s)", filename, container->isAccessible() ? "accessible" : "inaccessible");
+        (void)0;
+    }
+
+    return container.get();
+}
+
+Variable *VariableService::getVariable(Variable::InternalDataType type, const ComponentId& component, const char *name, bool accessible) {
+    for (auto& container : containers) {
+        if (auto variable = container->getVariable(component, name)) {
+            if (variable->isDetached()) {
+                continue;
+            }
+            if (variable->getInternalDataType() != type) {
+                MO_DBG_ERR("conflicting type for %s - remove old variable", name);
+                variable->detach();
+                continue;
+            }
+            if (container->isAccessible() != accessible) {
+                MO_DBG_ERR("conflicting accessibility for %s", name);
+                (void)0;
+            }
+            return variable;
+        }
+    }
+    return nullptr;
+}
+
+VariableService::VariableService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
+    context.getOperationRegistry().registerOperation("SetVariables", [this] () {
+        return new Ocpp201::SetVariables(*this);});
+    context.getOperationRegistry().registerOperation("GetVariables", [this] () {
+        return new Ocpp201::GetVariables(*this);});
+}
+
+template<class T>
+bool loadVariableFactoryDefault(Variable& variable, T factoryDef);
+
+template<>
+bool loadVariableFactoryDefault<int>(Variable& variable, int factoryDef) {
+    variable.setInt(factoryDef);
+    return true;
+}
+
+template<>
+bool loadVariableFactoryDefault<bool>(Variable& variable, bool factoryDef) {
+    variable.setBool(factoryDef);
+    return true;
+}
+
+template<>
+bool loadVariableFactoryDefault<const char*>(Variable& variable, const char *factoryDef) {
+    return variable.setString(factoryDef);
+}
+
+void loadVariableCharacteristics(Variable& variable, Variable::Mutability mutability, bool rebootRequired) {
+    if (variable.getMutability() == Variable::Mutability::ReadWrite) {
+        variable.setMutability(mutability);
+    }
+
+    if (rebootRequired) {
+        variable.setRebootRequired();
+    }
+}
+
+template<class T>
+Variable::InternalDataType getInternalDataType();
+
+template<> Variable::InternalDataType getInternalDataType<int>() {return Variable::InternalDataType::Int;}
+template<> Variable::InternalDataType getInternalDataType<bool>() {return Variable::InternalDataType::Bool;}
+template<> Variable::InternalDataType getInternalDataType<const char*>() {return Variable::InternalDataType::String;}
+
+template<class T>
+Variable *VariableService::declareVariable(const ComponentId& component, const char *name, T factoryDefault, const char *containerPath, Variable::Mutability mutability, Variable::AttributeTypeSet attributes, bool rebootRequired, bool accessible) {
+
+    auto res = getVariable(getInternalDataType<T>(), component, name, accessible);
+    if (!res) {
+        auto container = declareContainer(containerPath, accessible);
+        if (!container) {
+            return nullptr;
+        }
+
+        auto variable = container->createVariable(getInternalDataType<T>(), attributes);
+        if (!variable) {
+            return nullptr;
+        }
+
+        variable->setName(name);
+        variable->setComponentId(component);
+
+        if (!loadVariableFactoryDefault<T>(*variable, factoryDefault)) {
+            return nullptr;
+        }
+
+        res = variable.get();
+
+        if (!container->add(std::move(variable))) {
+            return nullptr;
+        }
+    }
+
+    loadVariableCharacteristics(*res, mutability, rebootRequired);
+    return res;
+}
+
+template Variable *VariableService::declareVariable<int>(const ComponentId&, const char*, int, const char*, Variable::Mutability, Variable::AttributeTypeSet, bool, bool);
+template Variable *VariableService::declareVariable<bool>(const ComponentId&, const char*, bool, const char*, Variable::Mutability, Variable::AttributeTypeSet, bool, bool);
+template Variable *VariableService::declareVariable<const char*>(const ComponentId&, const char*, const char*, const char*, Variable::Mutability, Variable::AttributeTypeSet, bool, bool);
+
+bool VariableService::commit() {
+    bool success = true;
+
+    for (auto& container : containers) {
+        if (!container->save()) {
+            success = false;
+        }
+    }
+
+    return success;
+}
+
+SetVariableStatus VariableService::setVariable(Variable::AttributeType attrType, const char *value, const ComponentId& component, const char *variableName) {
+
+    Variable *variable = nullptr;
+
+    bool foundComponent = false;
+    for (const auto& container : containers) {
+        if (!container->isAccessible()) {
+            // container intended for internal use only
+            continue;
+        }
+        for (size_t i = 0; i < container->size(); i++) {
+            auto entry = container->getVariable(i);
+
+            if (entry->getComponentId().equals(component)) {
+                foundComponent = true;
+
+                if (!strcmp(entry->getName(), variableName)) {
+                    // found variable. Search terminated in this block
+
+                    variable = entry;
+                    break;
+                }
+            }
+        }
+        if (variable) {
+            // result found in inner for-loop
+            break;
+        }
+    }
+
+    if (!variable) {
+        if (foundComponent) {
+            return SetVariableStatus::UnknownVariable;
+        } else {
+            return SetVariableStatus::UnknownComponent; 
+        }
+    }
+
+    if (variable->getMutability() == Variable::Mutability::ReadOnly) {
+        return SetVariableStatus::Rejected;
+    }
+
+    if (!variable->hasAttribute(attrType)) {
+        return SetVariableStatus::NotSupportedAttributeType;
+    }
+
+    //write config
+
+    /*
+     * Try to interpret input as number
+     */
+
+    bool convertibleInt = true;
+    int numInt = 0;
+    bool convertibleBool = true;
+    bool numBool = false;
+
+    int nDigits = 0, nNonDigits = 0, nDots = 0, nSign = 0; //"-1.234" has 4 digits, 0 nonDigits, 1 dot and 1 sign. Don't allow comma as seperator. Don't allow e-expressions (e.g. 1.23e-7)
+    for (const char *c = value; *c; ++c) {
+        if (*c >= '0' && *c <= '9') {
+            //int interpretation
+            if (nDots == 0) { //only append number if before floating point
+                nDigits++;
+                numInt *= 10;
+                numInt += *c - '0';
+            }
+        } else if (*c == '.') {
+            nDots++;
+        } else if (c == value && *c == '-') {
+            nSign++;
+        } else {
+            nNonDigits++;
+        }
+    }
+
+    if (nSign == 1) {
+        numInt = -numInt;
+    }
+
+    int INT_MAXDIGITS; //plausibility check: this allows a numerical range of (-999,999,999 to 999,999,999), or (-9,999 to 9,999) respectively
+    if (sizeof(int) >= 4UL)
+        INT_MAXDIGITS = 9;
+    else
+        INT_MAXDIGITS = 4;
+
+    if (nNonDigits > 0 || nDigits == 0 || nSign > 1 || nDots > 1) {
+        convertibleInt = false;
+    }
+
+    if (nDigits > INT_MAXDIGITS) {
+        MO_DBG_DEBUG("Possible integer overflow: key = %s, value = %s", variableName, value);
+        convertibleInt = false;
+    }
+
+    if (tolower(value[0]) == 't' && tolower(value[1]) == 'r' && tolower(value[2]) == 'u' && tolower(value[3]) == 'e' && !value[4]) {
+        numBool = true;
+    } else if (tolower(value[0]) == 'f' && tolower(value[1]) == 'a' && tolower(value[2]) == 'l' && tolower(value[3]) == 's' && tolower(value[4]) == 'e' && !value[5]) {
+        numBool = false;
+    } else if (convertibleInt) {
+        numBool = numInt != 0;
+    } else {
+        convertibleBool = false;
+    }
+
+    // validate and store (parsed) value to Config
+
+    if (variable->getInternalDataType() == Variable::InternalDataType::Int && convertibleInt) {
+        auto validator = getValidatorInt(component, variableName);
+        if (validator && !validator->validate(numInt)) {
+            MO_DBG_WARN("validation failed for variable=%s", variableName);
+            return SetVariableStatus::Rejected;
+        }
+        variable->setInt(numInt);
+    } else if (variable->getInternalDataType() == Variable::InternalDataType::Bool && convertibleBool) {
+        auto validator = getValidatorBool(component, variableName);
+        if (validator && !validator->validate(numBool)) {
+            MO_DBG_WARN("validation failed for variable=%s", variableName);
+            return SetVariableStatus::Rejected;
+        }
+        variable->setBool(numBool);
+    } else if (variable->getInternalDataType() == Variable::InternalDataType::String) {
+        auto validator = getValidatorString(component, variableName);
+        if (validator && !validator->validate(value)) {
+            MO_DBG_WARN("validation failed for variable=%s", variableName);
+            return SetVariableStatus::Rejected;
+        }
+        variable->setString(value);
+    } else {
+        MO_DBG_WARN("Value has incompatible type");
+        return SetVariableStatus::Rejected;
+    }
+
+    if (variable->isRebootRequired()) {
+        return SetVariableStatus::RebootRequired;
+    }
+
+    return SetVariableStatus::Accepted;
+}
+
+GetVariableStatus VariableService::getVariable(Variable::AttributeType attrType, const ComponentId& component, const char *variableName, Variable **result) {
+
+    bool foundComponent = false;
+    for (const auto& container : containers) {
+        for (size_t i = 0; i < container->size(); i++) {
+            auto variable = container->getVariable(i);
+
+            if (variable->getComponentId().equals(component)) {
+                foundComponent = true;
+
+                if (!strcmp(variable->getName(), variableName)) {
+                    // found variable. Search terminated in this block
+
+                    if (variable->getMutability() == Variable::Mutability::WriteOnly) {
+                        return GetVariableStatus::Rejected;
+                    }
+
+                    if (variable->hasAttribute(attrType)) {
+                        *result = variable;
+                        return GetVariableStatus::Accepted;
+                    } else {
+                        return GetVariableStatus::NotSupportedAttributeType;
+                    }
+                }
+            }
+        }
+    }
+
+    if (foundComponent) {
+        return GetVariableStatus::UnknownVariable;
+    } else {
+        return GetVariableStatus::UnknownComponent; 
+    }
+}
+
+} // namespace MicroOcpp
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Variables/VariableService.h b/src/MicroOcpp/Model/Variables/VariableService.h
new file mode 100644
index 00000000..2cf5b1b7
--- /dev/null
+++ b/src/MicroOcpp/Model/Variables/VariableService.h
@@ -0,0 +1,93 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+/*
+ * Implementation of the UCs B05 - B06
+ */
+
+#ifndef MO_VARIABLESERVICE_H
+#define MO_VARIABLESERVICE_H
+
+#include <stdint.h>
+#include <vector>
+#include <memory>
+#include <limits>
+#include <functional>
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Variables/Variable.h>
+#include <MicroOcpp/Model/Variables/VariableContainer.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+
+#ifndef MO_VARIABLE_FN
+#define MO_VARIABLE_FN (MO_FILENAME_PREFIX "ocpp-vars.jsn")
+#endif
+
+#ifndef MO_VARIABLE_VOLATILE
+#define MO_VARIABLE_VOLATILE "/volatile"
+#endif
+
+#ifndef MO_VARIABLE_INTERNAL_FN
+#define MO_VARIABLE_INTERNAL_FN (MO_FILENAME_PREFIX "mo-vars.jsn")
+#endif
+
+namespace MicroOcpp {
+
+template <class T>
+struct VariableValidator {
+    ComponentId component;
+    const char *name;
+    std::function<bool(T)> validate;
+    VariableValidator(const ComponentId& component, const char *name, std::function<bool(T)> validate);
+};
+
+class Context;
+
+class VariableService {
+private:
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    std::vector<std::shared_ptr<VariableContainer>> containers;
+
+    std::vector<VariableValidator<int>> validatorInt;
+    std::vector<VariableValidator<bool>> validatorBool;
+    std::vector<VariableValidator<const char*>> validatorString;
+
+    VariableValidator<int> *getValidatorInt(const ComponentId& component, const char *name);
+    VariableValidator<bool> *getValidatorBool(const ComponentId& component, const char *name);
+    VariableValidator<const char*> *getValidatorString(const ComponentId& component, const char *name);
+
+    std::unique_ptr<VariableContainer> createContainer(const char *filename, bool accessible) const;
+
+    VariableContainer *declareContainer(const char *filename, bool accessible);
+
+    Variable *getVariable(Variable::InternalDataType type, const ComponentId& component, const char *name, bool accessible);
+
+public:
+    VariableService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem);
+
+    template <class T> 
+    Variable *declareVariable(const ComponentId& component, const char *name, T factoryDefault, const char *containerPath = MO_VARIABLE_FN, Variable::Mutability mutability = Variable::Mutability::ReadWrite, Variable::AttributeTypeSet attributes = Variable::AttributeTypeSet(), bool rebootRequired = false, bool accessible = true);
+
+    bool commit();
+
+    void addContainer(std::shared_ptr<VariableContainer> container);
+
+    std::shared_ptr<VariableContainer> getContainer(const char *filename);
+
+    template <class T>
+    bool registerValidator(const ComponentId& component, const char *name, std::function<bool(T)> validate);
+
+    SetVariableStatus setVariable(Variable::AttributeType attrType, const char *attrVal, const ComponentId& component, const char *variableName);
+
+    GetVariableStatus getVariable(Variable::AttributeType attrType, const ComponentId& component, const char *variableName, Variable **result);
+};
+
+} // namespace MicroOcpp
+
+#endif // MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Operations/BootNotification.cpp b/src/MicroOcpp/Operations/BootNotification.cpp
index f59c1bfe..e0236b0a 100644
--- a/src/MicroOcpp/Operations/BootNotification.cpp
+++ b/src/MicroOcpp/Operations/BootNotification.cpp
@@ -1,11 +1,12 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/BootNotification.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Boot/BootService.h>
 #include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Version.h>
 #include <MicroOcpp/Debug.h>
 
 #include <string.h>
@@ -22,6 +23,15 @@ const char* BootNotification::getOperationType(){
 
 std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
     if (credentials) {
+#if MO_ENABLE_V201
+        if (model.getVersion().major == 2) {
+            std::unique_ptr<DynamicJsonDocument> doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2) + credentials->memoryUsage()));
+            JsonObject payload = doc->to<JsonObject>();
+            payload["reason"] = "PowerUp";
+            payload["chargingStation"] = *credentials;
+            return doc;
+        }
+#endif
         return std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(*credentials));
     } else {
         MO_DBG_ERR("payload undefined");
diff --git a/src/MicroOcpp/Operations/DeleteCertificate.cpp b/src/MicroOcpp/Operations/DeleteCertificate.cpp
index 27a76d10..9af4ad04 100644
--- a/src/MicroOcpp/Operations/DeleteCertificate.cpp
+++ b/src/MicroOcpp/Operations/DeleteCertificate.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp/Operations/DeleteCertificate.h>
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
diff --git a/src/MicroOcpp/Operations/DeleteCertificate.h b/src/MicroOcpp/Operations/DeleteCertificate.h
index e0b3f66f..2c09a363 100644
--- a/src/MicroOcpp/Operations/DeleteCertificate.h
+++ b/src/MicroOcpp/Operations/DeleteCertificate.h
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #ifndef MO_DELETECERTIFICATE_H
 #define MO_DELETECERTIFICATE_H
 
diff --git a/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
index fae8e150..07d385ab 100644
--- a/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
+++ b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp/Operations/GetInstalledCertificateIds.h>
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
diff --git a/src/MicroOcpp/Operations/GetInstalledCertificateIds.h b/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
index 58c34d87..dae66c31 100644
--- a/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
+++ b/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #ifndef MO_GETINSTALLEDCERTIFICATEIDS_H
 #define MO_GETINSTALLEDCERTIFICATEIDS_H
 
diff --git a/src/MicroOcpp/Operations/GetVariables.cpp b/src/MicroOcpp/Operations/GetVariables.cpp
new file mode 100644
index 00000000..e9500f8b
--- /dev/null
+++ b/src/MicroOcpp/Operations/GetVariables.cpp
@@ -0,0 +1,222 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Operations/GetVariables.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Debug.h>
+
+#include <cctype> //for tolower
+
+using MicroOcpp::Ocpp201::GetVariables;
+
+GetVariables::GetVariables(VariableService& variableService) : variableService(variableService) {
+  
+}
+
+const char* GetVariables::getOperationType(){
+    return "GetVariables";
+}
+
+void GetVariables::processReq(JsonObject payload) {
+    for (JsonObject getVariable : payload["getVariableData"].as<JsonArray>()) {
+
+        queries.emplace_back();
+        auto& data = queries.back();
+
+        if (getVariable.containsKey("attributeType")) {
+            const char *attributeTypeCstr = getVariable["attributeType"] | "_Undefined";
+            if (!strcmp(attributeTypeCstr, "Actual")) {
+                data.attributeType = Variable::AttributeType::Actual;
+            } else if (!strcmp(attributeTypeCstr, "Target")) {
+                data.attributeType = Variable::AttributeType::Target;
+            } else if (!strcmp(attributeTypeCstr, "MinSet")) {
+                data.attributeType = Variable::AttributeType::MinSet;
+            } else if (!strcmp(attributeTypeCstr, "MaxSet")) {
+                data.attributeType = Variable::AttributeType::MaxSet;
+            } else {
+                errorCode = "FormationViolation";
+                MO_DBG_ERR("invalid attributeType");
+                return;
+            }
+        }
+
+        const char *componentNameCstr = getVariable["component"]["name"] | (const char*) nullptr;
+        const char *variableNameCstr = getVariable["variable"]["name"] | (const char*) nullptr;
+
+        if (!componentNameCstr ||
+                !variableNameCstr) {
+            errorCode = "FormationViolation";
+            return;
+        }
+
+        data.componentName = componentNameCstr;
+        data.variableName = variableNameCstr;
+
+        // TODO check against ConfigurationValueSize
+
+        data.componentEvseId = getVariable["component"]["evse"]["id"] | -1;
+        data.componentEvseConnectorId = getVariable["component"]["evse"]["connectorId"] | -1;
+
+        if (getVariable["component"].containsKey("evse") && data.componentEvseId < 0) {
+            errorCode = "FormationViolation";
+            MO_DBG_ERR("malformatted / missing evseId");
+            return;
+        }
+    }
+
+    if (queries.empty()) {
+        errorCode = "FormationViolation";
+        return;
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> GetVariables::createConf(){
+
+    // process GetVariables queries
+    for (auto& query : queries) {
+        query.attributeStatus = variableService.getVariable(
+                query.attributeType,
+                ComponentId(query.componentName.c_str(), 
+                    EvseId(query.componentEvseId, query.componentEvseConnectorId)),
+                query.variableName.c_str(),
+                &query.variable);
+    }
+
+    #define VALUE_BUFSIZE 30 // for primitives (int)
+
+    size_t capacity = JSON_ARRAY_SIZE(queries.size());
+    for (const auto& data : queries) {
+        size_t valueCapacity = 0;
+        if (data.variable) {
+            switch (data.variable->getInternalDataType()) {
+                case Variable::InternalDataType::Int: {
+                    // measure int size by printing to a dummy buf
+                    char valbuf [VALUE_BUFSIZE];
+                    auto ret = snprintf(valbuf, VALUE_BUFSIZE, "%i", data.variable->getInt());
+                    if (ret < 0 || ret >= VALUE_BUFSIZE) {
+                        continue;
+                    }
+                    valueCapacity = (size_t) ret + 1;
+                    break;
+                }
+                case Variable::InternalDataType::Bool:
+                    // bool will be stored in zero-copy mode (string literal "true" or "false")
+                    valueCapacity = 0;
+                    break;
+                case Variable::InternalDataType::String:
+                    valueCapacity = strlen(data.variable->getString()); // TODO limit by ReportingValueSize
+                    break;
+                default:
+                    MO_DBG_ERR("internal error");
+                    break;
+            }
+        }
+
+        capacity += 
+            JSON_OBJECT_SIZE(5) + // getVariableResult
+                valueCapacity + // capacity needed for storing the value
+                JSON_OBJECT_SIZE(2) + // component
+                    data.componentName.length() + 1 +
+                    JSON_OBJECT_SIZE(2) + // evse
+                JSON_OBJECT_SIZE(2) + // variable
+                    data.variableName.length() + 1;
+    }
+
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
+
+    JsonObject payload = doc->to<JsonObject>();
+    JsonArray getVariableResult = payload.createNestedArray("getVariableResult");
+
+    for (const auto& data : queries) {
+        JsonObject getVariable = getVariableResult.createNestedObject();
+
+        const char *attributeStatusCstr = "Rejected";
+        switch (data.attributeStatus) {
+            case GetVariableStatus::Accepted:
+                attributeStatusCstr = "Accepted";
+                break;
+            case GetVariableStatus::Rejected:
+                attributeStatusCstr = "Rejected";
+                break;
+            case GetVariableStatus::UnknownComponent:
+                attributeStatusCstr = "UnknownComponent";
+                break;
+            case GetVariableStatus::UnknownVariable:
+                attributeStatusCstr = "UnknownVariable";
+                break;
+            case GetVariableStatus::NotSupportedAttributeType:
+                attributeStatusCstr = "NotSupportedAttributeType";
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                break;
+        }
+        getVariable["attributeStatus"] = attributeStatusCstr;
+
+        const char *attributeTypeCstr = nullptr;
+        switch (data.attributeType) {
+            case Variable::AttributeType::Actual:
+                // leave blank when Actual
+                break;
+            case Variable::AttributeType::Target:
+                attributeTypeCstr = "Target";
+                break;
+            case Variable::AttributeType::MinSet:
+                attributeTypeCstr = "MinSet";
+                break;
+            case Variable::AttributeType::MaxSet:
+                attributeTypeCstr = "MaxSet";
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                break;
+        }
+        if (attributeTypeCstr) {
+            getVariable["attributeType"] = attributeTypeCstr;
+        }
+
+        if (data.variable) {
+            switch (data.variable->getInternalDataType()) {
+                case Variable::InternalDataType::Int: {
+                    char valbuf [VALUE_BUFSIZE];
+                    auto ret = snprintf(valbuf, VALUE_BUFSIZE, "%i", data.variable->getInt());
+                    if (ret < 0 || ret >= VALUE_BUFSIZE) {
+                        break;
+                    }
+                    getVariable["attributeValue"] = valbuf;
+                    break;
+                }
+                case Variable::InternalDataType::Bool:
+                    getVariable["attributeValue"] = data.variable->getBool() ? "true" : "false";
+                    break;
+                case Variable::InternalDataType::String:
+                    getVariable["attributeValue"] = (char*) data.variable->getString(); // force zero-copy mode
+                    break;
+                default:
+                    MO_DBG_ERR("internal error");
+                    break;
+            }
+        }
+
+        getVariable["component"]["name"] = (char*) data.componentName.c_str(); // force copy-mode
+
+        if (data.componentEvseId >= 0) {
+            getVariable["component"]["evse"]["id"] = data.componentEvseId;
+        }
+
+        if (data.componentEvseConnectorId >= 0) {
+            getVariable["component"]["evse"]["connectorId"] = data.componentEvseConnectorId;
+        }
+
+        getVariable["variable"]["name"] = (char*) data.variableName.c_str(); // force copy-mode
+    }
+
+    return doc;
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/GetVariables.h b/src/MicroOcpp/Operations/GetVariables.h
new file mode 100644
index 00000000..a28f744b
--- /dev/null
+++ b/src/MicroOcpp/Operations/GetVariables.h
@@ -0,0 +1,63 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_GETVARIABLES_H
+#define MO_GETVARIABLES_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <string>
+#include <vector>
+
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Model/Variables/Variable.h>
+
+namespace MicroOcpp {
+
+class VariableService;
+
+namespace Ocpp201 {
+
+// GetVariableDataType (2.25) and
+// GetVariableResultType (2.26)
+struct GetVariableData {
+    // GetVariableDataType
+    Variable::AttributeType attributeType = Variable::AttributeType::Actual;
+    std::string componentName;
+    int componentEvseId = -1;
+    int componentEvseConnectorId = -1;
+    std::string variableName;
+
+    // GetVariableResultType
+    GetVariableStatus attributeStatus;
+    Variable *variable = nullptr;
+};
+
+class GetVariables : public Operation {
+private:
+    VariableService& variableService;
+    std::vector<GetVariableData> queries;
+
+    const char *errorCode = nullptr;
+public:
+    GetVariables(VariableService& variableService);
+
+    const char* getOperationType() override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+
+};
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Operations/InstallCertificate.cpp b/src/MicroOcpp/Operations/InstallCertificate.cpp
index 69be0d4d..ed2e6c1f 100644
--- a/src/MicroOcpp/Operations/InstallCertificate.cpp
+++ b/src/MicroOcpp/Operations/InstallCertificate.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp/Operations/InstallCertificate.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 #include <MicroOcpp/Debug.h>
diff --git a/src/MicroOcpp/Operations/InstallCertificate.h b/src/MicroOcpp/Operations/InstallCertificate.h
index 24fb725e..e6bbbcc6 100644
--- a/src/MicroOcpp/Operations/InstallCertificate.h
+++ b/src/MicroOcpp/Operations/InstallCertificate.h
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #ifndef MO_INSTALLCERTIFICATE_H
 #define MO_INSTALLCERTIFICATE_H
 
diff --git a/src/MicroOcpp/Operations/SetVariables.cpp b/src/MicroOcpp/Operations/SetVariables.cpp
new file mode 100644
index 00000000..6333353e
--- /dev/null
+++ b/src/MicroOcpp/Operations/SetVariables.cpp
@@ -0,0 +1,179 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Operations/SetVariables.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::SetVariables;
+
+SetVariables::SetVariables(VariableService& variableService) : variableService(variableService) {
+  
+}
+
+const char* SetVariables::getOperationType(){
+    return "SetVariables";
+}
+
+void SetVariables::processReq(JsonObject payload) {
+    for (JsonObject setVariable : payload["setVariableData"].as<JsonArray>()) {
+
+        queries.emplace_back();
+        auto& data = queries.back();
+
+        if (setVariable.containsKey("attributeType")) {
+            const char *attributeTypeCstr = setVariable["attributeType"] | "_Undefined";
+            if (!strcmp(attributeTypeCstr, "Actual")) {
+                data.attributeType = Variable::AttributeType::Actual;
+            } else if (!strcmp(attributeTypeCstr, "Target")) {
+                data.attributeType = Variable::AttributeType::Target;
+            } else if (!strcmp(attributeTypeCstr, "MinSet")) {
+                data.attributeType = Variable::AttributeType::MinSet;
+            } else if (!strcmp(attributeTypeCstr, "MaxSet")) {
+                data.attributeType = Variable::AttributeType::MaxSet;
+            } else {
+                errorCode = "FormationViolation";
+                MO_DBG_ERR("invalid attributeType");
+                return;
+            }
+        }
+
+        const char *attributeValueCstr = setVariable["attributeValue"] | (const char*) nullptr;
+        const char *componentNameCstr = setVariable["component"]["name"] | (const char*) nullptr;
+        const char *variableNameCstr = setVariable["variable"]["name"] | (const char*) nullptr;
+
+        if (!attributeValueCstr ||
+                !componentNameCstr ||
+                !variableNameCstr) {
+            errorCode = "FormationViolation";
+            return;
+        }
+
+        data.attributeValue = attributeValueCstr;
+        data.componentName = componentNameCstr;
+        data.variableName = variableNameCstr;
+
+        // TODO check against ConfigurationValueSize
+
+        data.componentEvseId = setVariable["component"]["evse"]["id"] | -1;
+        data.componentEvseConnectorId = setVariable["component"]["evse"]["connectorId"] | -1;
+
+        if (setVariable["component"].containsKey("evse") && data.componentEvseId < 0) {
+            errorCode = "FormationViolation";
+            MO_DBG_ERR("malformatted / missing evseId");
+            return;
+        }
+    }
+
+    if (queries.empty()) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    MO_DBG_DEBUG("processing %zu setVariable queries", queries.size());
+
+    for (auto& query : queries) {
+        query.attributeStatus = variableService.setVariable(
+                query.attributeType,
+                query.attributeValue,
+                ComponentId(query.componentName.c_str(), 
+                    EvseId(query.componentEvseId, query.componentEvseConnectorId)),
+                query.variableName.c_str());
+    }
+
+    if (!variableService.commit()) {
+        errorCode = "InternalError";
+        MO_DBG_ERR("Variables could not be stored. Rollback not possible");
+        return;
+    }
+}
+
+std::unique_ptr<DynamicJsonDocument> SetVariables::createConf(){
+    size_t capacity = JSON_ARRAY_SIZE(queries.size());
+    for (const auto& data : queries) {
+        capacity += 
+            JSON_OBJECT_SIZE(5) + // setVariableResult
+                JSON_OBJECT_SIZE(2) + // component
+                    data.componentName.length() + 1 +
+                    JSON_OBJECT_SIZE(2) + // evse
+                JSON_OBJECT_SIZE(2) + // variable
+                    data.variableName.length() + 1;
+    }
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
+
+    JsonObject payload = doc->to<JsonObject>();
+    JsonArray setVariableResult = payload.createNestedArray("setVariableResult");
+
+    for (const auto& data : queries) {
+        JsonObject setVariable = setVariableResult.createNestedObject();
+
+        const char *attributeTypeCstr = nullptr;
+        switch (data.attributeType) {
+            case Variable::AttributeType::Actual:
+                // leave blank when Actual
+                break;
+            case Variable::AttributeType::Target:
+                attributeTypeCstr = "Target";
+                break;
+            case Variable::AttributeType::MinSet:
+                attributeTypeCstr = "MinSet";
+                break;
+            case Variable::AttributeType::MaxSet:
+                attributeTypeCstr = "MaxSet";
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                break;
+        }
+        if (attributeTypeCstr) {
+            setVariable["attributeType"] = attributeTypeCstr;
+        }
+
+        const char *attributeStatusCstr = "Rejected";
+        switch (data.attributeStatus) {
+            case SetVariableStatus::Accepted:
+                attributeStatusCstr = "Accepted";
+                break;
+            case SetVariableStatus::Rejected:
+                attributeStatusCstr = "Rejected";
+                break;
+            case SetVariableStatus::UnknownComponent:
+                attributeStatusCstr = "UnknownComponent";
+                break;
+            case SetVariableStatus::UnknownVariable:
+                attributeStatusCstr = "UnknownVariable";
+                break;
+            case SetVariableStatus::NotSupportedAttributeType:
+                attributeStatusCstr = "NotSupportedAttributeType";
+                break;
+            case SetVariableStatus::RebootRequired:
+                attributeStatusCstr = "RebootRequired";
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                break;
+        }
+        setVariable["attributeStatus"] = attributeStatusCstr;
+
+        setVariable["component"]["name"] = (char*) data.componentName.c_str(); // force copy-mode
+
+        if (data.componentEvseId >= 0) {
+            setVariable["component"]["evse"]["id"] = data.componentEvseId;
+        }
+
+        if (data.componentEvseConnectorId >= 0) {
+            setVariable["component"]["evse"]["connectorId"] = data.componentEvseConnectorId;
+        }
+
+        setVariable["variable"]["name"] = (char*) data.variableName.c_str(); // force copy-mode
+    }
+
+    return doc;
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/SetVariables.h b/src/MicroOcpp/Operations/SetVariables.h
new file mode 100644
index 00000000..83527a4e
--- /dev/null
+++ b/src/MicroOcpp/Operations/SetVariables.h
@@ -0,0 +1,63 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_SETVARIABLES_H
+#define MO_SETVARIABLES_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <string>
+#include <vector>
+
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Model/Variables/Variable.h>
+
+namespace MicroOcpp {
+
+class VariableService;
+
+namespace Ocpp201 {
+
+// SetVariableDataType (2.44) and
+// SetVariableResultType (2.45)
+struct SetVariableData {
+    // SetVariableDataType
+    Variable::AttributeType attributeType = Variable::AttributeType::Actual;
+    const char *attributeValue; // will become invalid after processReq
+    std::string componentName;
+    int componentEvseId = -1;
+    int componentEvseConnectorId = -1;
+    std::string variableName;
+
+    // SetVariableResultType
+    SetVariableStatus attributeStatus;
+};
+
+class SetVariables : public Operation {
+private:
+    VariableService& variableService;
+    std::vector<SetVariableData> queries;
+
+    const char *errorCode = nullptr;
+public:
+    SetVariables(VariableService& variableService);
+
+    const char* getOperationType() override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+
+};
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Operations/StatusNotification.cpp b/src/MicroOcpp/Operations/StatusNotification.cpp
index ada65894..40dab1aa 100644
--- a/src/MicroOcpp/Operations/StatusNotification.cpp
+++ b/src/MicroOcpp/Operations/StatusNotification.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/StatusNotification.h>
@@ -8,11 +8,9 @@
 
 #include <string.h>
 
-using MicroOcpp::Ocpp16::StatusNotification;
+namespace MicroOcpp {
 
 //helper function
-namespace MicroOcpp {
-namespace Ocpp16 {
 const char *cstrFromOcppEveState(ChargePointStatus state) {
     switch (state) {
         case (ChargePointStatus::Available):
@@ -33,6 +31,10 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
             return "Unavailable";
         case (ChargePointStatus::Faulted):
             return "Faulted";
+#if MO_ENABLE_V201
+        case (ChargePointStatus::Occupied):
+            return "Occupied";
+#endif
         default:
             MO_DBG_ERR("ChargePointStatus not specified");
             (void)0;
@@ -41,7 +43,8 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
             return "NOT_SET";
     }
 }
-}} //end namespaces
+
+namespace Ocpp16 {
 
 StatusNotification::StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData)
         : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorData(errorData) {
@@ -56,11 +59,10 @@ const char* StatusNotification::getOperationType(){
     return "StatusNotification";
 }
 
-//TODO if the status has changed again when sendReq() is called, abort the operation completely (note: if req is already sent, stick with listening to conf). The ChargePointStatusService will enqueue a new operation itself
 std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(7) + (JSONDATE_LENGTH + 1)));
     JsonObject payload = doc->to<JsonObject>();
-    
+
     payload["connectorId"] = connectorId;
     if (errorData.isError) {
         if (errorData.errorCode) {
@@ -91,7 +93,6 @@ std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
     return doc;
 }
 
-
 void StatusNotification::processConf(JsonObject payload) {
     /*
     * Empty payload
@@ -111,3 +112,46 @@ void StatusNotification::processReq(JsonObject payload) {
 std::unique_ptr<DynamicJsonDocument> StatusNotification::createConf(){
     return createEmptyDocument();
 }
+
+} // namespace Ocpp16
+} // namespace MicroOcpp
+
+#if MO_ENABLE_V201
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+StatusNotification::StatusNotification(EvseId evseId, ChargePointStatus currentStatus, const Timestamp &timestamp)
+        : evseId(evseId), timestamp(timestamp), currentStatus(currentStatus) {
+
+}
+
+const char* StatusNotification::getOperationType(){
+    return "StatusNotification";
+}
+
+std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4) + (JSONDATE_LENGTH + 1)));
+    JsonObject payload = doc->to<JsonObject>();
+
+    char timestamp_cstr[JSONDATE_LENGTH + 1] = {'\0'};
+    timestamp.toJsonString(timestamp_cstr, JSONDATE_LENGTH + 1);
+    payload["timestamp"] = timestamp_cstr;
+    payload["connectorStatus"] = cstrFromOcppEveState(currentStatus);
+    payload["evseId"] = evseId.id;
+    payload["connectorId"] = evseId.connectorId >= 0 ? evseId.connectorId : 1;
+
+    return doc;
+}
+
+
+void StatusNotification::processConf(JsonObject payload) {
+    /*
+    * Empty payload
+    */
+}
+
+} // namespace Ocpp201
+} // namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/StatusNotification.h b/src/MicroOcpp/Operations/StatusNotification.h
index 74f329d6..ef0e6a1f 100644
--- a/src/MicroOcpp/Operations/StatusNotification.h
+++ b/src/MicroOcpp/Operations/StatusNotification.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef STATUSNOTIFICATION_H
@@ -9,8 +9,12 @@
 #include <MicroOcpp/Core/Time.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
+#include <MicroOcpp/Version.h>
 
 namespace MicroOcpp {
+    
+const char *cstrFromOcppEveState(ChargePointStatus state);
+
 namespace Ocpp16 {
 
 class StatusNotification : public Operation {
@@ -33,8 +37,34 @@ class StatusNotification : public Operation {
     std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
-const char *cstrFromOcppEveState(ChargePointStatus state);
+} // namespace Ocpp16
+} // namespace MicroOcpp
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+class StatusNotification : public Operation {
+private:
+    EvseId evseId;
+    Timestamp timestamp;
+    ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
+public:
+    StatusNotification(EvseId evseId, ChargePointStatus currentStatus, const Timestamp &timestamp);
+
+    const char* getOperationType() override;
+
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
+
+    void processConf(JsonObject payload) override;
+};
+
+} // namespace Ocpp201
+} // namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
 
-} //end namespace Ocpp16
-} //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
new file mode 100644
index 00000000..e221c8b0
--- /dev/null
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -0,0 +1,261 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Operations/TransactionEvent.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::TransactionEvent;
+
+TransactionEvent::TransactionEvent(Model& model, std::shared_ptr<TransactionEventData> txEvent)
+        : model(model), txEvent(txEvent) {
+
+}
+
+const char* TransactionEvent::getOperationType() {
+    return "TransactionEvent";
+}
+
+std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                JSON_OBJECT_SIZE(12) + //total of 12 fields
+                JSONDATE_LENGTH + 1 + //timestamp string
+                JSON_OBJECT_SIZE(5) + //transactionInfo
+                    MO_TXID_LEN_MAX + 1 + //transactionId
+                MO_IDTOKEN_LEN_MAX + 1)); //idToken
+                //meterValue not supported
+    JsonObject payload = doc->to<JsonObject>();
+
+    const char *eventType = "";
+    switch (txEvent->eventType) {
+        case TransactionEventData::Type::Ended:
+            eventType = "Ended";
+            break;
+        case TransactionEventData::Type::Started:
+            eventType = "Started";
+            break;
+        case TransactionEventData::Type::Updated:
+            eventType = "Updated";
+            break;
+    }
+
+    payload["eventType"] = eventType;
+
+    char timestamp [JSONDATE_LENGTH + 1];
+    txEvent->timestamp.toJsonString(timestamp, JSONDATE_LENGTH + 1);
+    payload["timestamp"] = timestamp;
+
+    const char *triggerReason = "";
+    switch(txEvent->triggerReason) {
+        case TransactionEventData::TriggerReason::Authorized:
+            triggerReason = "Authorized";
+            break;
+        case TransactionEventData::TriggerReason::CablePluggedIn:
+            triggerReason = "CablePluggedIn";
+            break;
+        case TransactionEventData::TriggerReason::ChargingRateChanged:
+            triggerReason = "ChargingRateChanged";
+            break;
+        case TransactionEventData::TriggerReason::ChargingStateChanged:
+            triggerReason = "ChargingStateChanged";
+            break;
+        case TransactionEventData::TriggerReason::Deauthorized:
+            triggerReason = "Deauthorized";
+            break;
+        case TransactionEventData::TriggerReason::EnergyLimitReached:
+            triggerReason = "EnergyLimitReached";
+            break;
+        case TransactionEventData::TriggerReason::EVCommunicationLost:
+            triggerReason = "EVCommunicationLost";
+            break;
+        case TransactionEventData::TriggerReason::EVConnectTimeout:
+            triggerReason = "EVConnectTimeout";
+            break;
+        case TransactionEventData::TriggerReason::MeterValueClock:
+            triggerReason = "MeterValueClock";
+            break;
+        case TransactionEventData::TriggerReason::MeterValuePeriodic:
+            triggerReason = "MeterValuePeriodic";
+            break;
+        case TransactionEventData::TriggerReason::TimeLimitReached:
+            triggerReason = "TimeLimitReached";
+            break;
+        case TransactionEventData::TriggerReason::Trigger:
+            triggerReason = "Trigger";
+            break;
+        case TransactionEventData::TriggerReason::UnlockCommand:
+            triggerReason = "UnlockCommand";
+            break;
+        case TransactionEventData::TriggerReason::StopAuthorized:
+            triggerReason = "StopAuthorized";
+            break;
+        case TransactionEventData::TriggerReason::EVDeparted:
+            triggerReason = "EVDeparted";
+            break;
+        case TransactionEventData::TriggerReason::EVDetected:
+            triggerReason = "EVDetected";
+            break;
+        case TransactionEventData::TriggerReason::RemoteStop:
+            triggerReason = "RemoteStop";
+            break;
+        case TransactionEventData::TriggerReason::RemoteStart:
+            triggerReason = "RemoteStart";
+            break;
+        case TransactionEventData::TriggerReason::AbnormalCondition:
+            triggerReason = "AbnormalCondition";
+            break;
+        case TransactionEventData::TriggerReason::SignedDataReceived:
+            triggerReason = "SignedDataReceived";
+            break;
+        case TransactionEventData::TriggerReason::ResetCommand:
+            triggerReason = "ResetCommand";
+            break;
+    }
+
+    payload["triggerReason"] = triggerReason;
+
+    payload["seqNo"] = txEvent->seqNo;
+
+    if (txEvent->offline) {
+        payload["offline"] = txEvent->offline;
+    }
+
+    if (txEvent->numberOfPhasesUsed >= 0) {
+        payload["numberOfPhasesUsed"] = txEvent->numberOfPhasesUsed;
+    }
+
+    if (txEvent->cableMaxCurrent >= 0) {
+        payload["cableMaxCurrent"] = txEvent->cableMaxCurrent;
+    }
+
+    if (txEvent->reservationId >= 0) {
+        payload["reservationId"] = txEvent->reservationId;
+    }
+
+    JsonObject transactionInfo = payload.createNestedObject("transactionInfo");
+    transactionInfo["transactionId"] = txEvent->transaction->transactionId;
+
+    const char *chargingState = nullptr;
+    switch (txEvent->chargingState) {
+        case TransactionEventData::ChargingState::Charging:
+            chargingState = "Charging";
+            break;
+        case TransactionEventData::ChargingState::EVConnected:
+            chargingState = "EVConnected";
+            break;
+        case TransactionEventData::ChargingState::SuspendedEV:
+            chargingState = "SuspendedEV";
+            break;
+        case TransactionEventData::ChargingState::SuspendedEVSE:
+            chargingState = "SuspendedEVSE";
+            break;
+        case TransactionEventData::ChargingState::Idle:
+            chargingState = "Idle";
+            break;
+    }
+    if (chargingState) { // optional
+        transactionInfo["chargingState"] = chargingState;
+    }
+
+    const char *stoppedReason = nullptr;
+    switch (txEvent->stoppedReason) {
+        case TransactionEventData::StopReason::DeAuthorized: 
+            stoppedReason = "DeAuthorized"; 
+            break;
+        case TransactionEventData::StopReason::EmergencyStop: 
+            stoppedReason = "EmergencyStop"; 
+            break;
+        case TransactionEventData::StopReason::EnergyLimitReached: 
+            stoppedReason = "EnergyLimitReached";
+            break;
+        case TransactionEventData::StopReason::EVDisconnected: 
+            stoppedReason = "EVDisconnected";
+            break;
+        case TransactionEventData::StopReason::GroundFault: 
+            stoppedReason = "GroundFault";
+            break;
+        case TransactionEventData::StopReason::ImmediateReset:
+            stoppedReason = "ImmediateReset";
+            break;
+        case TransactionEventData::StopReason::LocalOutOfCredit:
+            stoppedReason = "LocalOutOfCredit";
+            break;
+        case TransactionEventData::StopReason::MasterPass:
+            stoppedReason = "MasterPass";
+            break;
+        case TransactionEventData::StopReason::Other:
+            stoppedReason = "Other";
+            break;
+        case TransactionEventData::StopReason::OvercurrentFault:
+            stoppedReason = "OvercurrentFault";
+            break;
+        case TransactionEventData::StopReason::PowerLoss:
+            stoppedReason = "PowerLoss";
+            break;
+        case TransactionEventData::StopReason::PowerQuality:
+            stoppedReason = "PowerQuality";
+            break;
+        case TransactionEventData::StopReason::Reboot:
+            stoppedReason = "Reboot";
+            break;
+        case TransactionEventData::StopReason::Remote:
+            stoppedReason = "Remote";
+            break;
+        case TransactionEventData::StopReason::SOCLimitReached:
+            stoppedReason = "SOCLimitReached";
+            break;
+        case TransactionEventData::StopReason::StoppedByEV:
+            stoppedReason = "StoppedByEV";
+            break;
+        case TransactionEventData::StopReason::TimeLimitReached:
+            stoppedReason = "TimeLimitReached";
+            break;
+        case TransactionEventData::StopReason::Timeout:
+            stoppedReason = "Timeout";
+            break;
+    }
+    if (stoppedReason) { // optional
+        transactionInfo["stoppedReason"] = stoppedReason;
+    }
+
+    if (txEvent->transaction->remoteStartId >= 0) {
+        payload["remoteStartId"] = txEvent->transaction->remoteStartId;
+    }
+
+    if (txEvent->idTokenTransmit) {
+        JsonObject idToken = payload.createNestedObject("idToken");
+        idToken["idToken"] = txEvent->transaction->idToken.get();
+        idToken["type"] = txEvent->transaction->idToken.getTypeCstr();
+    }
+
+    if (txEvent->evse.id >= 0) {
+        JsonObject evse = payload.createNestedObject("evse");
+        evse["id"] = txEvent->evse.id;
+        if (txEvent->evse.connectorId >= 0) {
+            evse["connectorId"] = txEvent->evse.connectorId;
+        }
+    }
+
+    // meterValue not supported
+
+    return doc;
+}
+
+void TransactionEvent::processConf(JsonObject payload) {
+
+    if (payload.containsKey("idTokenInfo")) {
+        if (strcmp(payload["idTokenInfo"]["status"], "Accepted")) {
+            MO_DBG_INFO("transaction deAuthorized");
+            txEvent->transaction->active = false;
+            txEvent->transaction->isDeauthorized = true;
+        }
+    }
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/TransactionEvent.h b/src/MicroOcpp/Operations/TransactionEvent.h
new file mode 100644
index 00000000..04d34c0a
--- /dev/null
+++ b/src/MicroOcpp/Operations/TransactionEvent.h
@@ -0,0 +1,44 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2023
+// MIT License
+
+#ifndef MO_TRANSACTIONEVENT_H
+#define MO_TRANSACTIONEVENT_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Core/Operation.h>
+
+namespace MicroOcpp {
+
+class Model;
+
+namespace Ocpp201 {
+
+class TransactionEventData;
+
+class TransactionEvent : public Operation {
+private:
+    Model& model;
+    std::shared_ptr<TransactionEventData> txEvent;
+
+    const char *errorCode;
+public:
+
+    TransactionEvent(Model& model, std::shared_ptr<TransactionEventData> txEvent);
+
+    const char* getOperationType() override;
+
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
+
+    void processConf(JsonObject payload) override;
+
+    const char *getErrorCode() override {return errorCode;}
+};
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+#endif // MO_ENABLE_V201
+#endif
diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
index 696caef9..6dac1b8a 100644
--- a/src/MicroOcpp/Version.h
+++ b/src/MicroOcpp/Version.h
@@ -1 +1,33 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_VERSION_H
+#define MO_VERSION_H
+
+/*
+ * Version specification of MicroOcpp library (unrelated with the OCPP version)
+ */
 #define MO_VERSION "1.1.0"
+
+/*
+ * Enable OCPP 2.0.1 support. If enabled, library can be initialized with both v1.6 and v2.0.1. The choice
+ * of the protocol is done dynamically during initialization
+ */
+#ifndef MO_ENABLE_V201
+#define MO_ENABLE_V201 0
+#endif
+
+namespace MicroOcpp {
+
+/*
+ * OCPP version type, defined in Model
+ */
+struct ProtocolVersion {
+    const int major, minor, patch;
+    ProtocolVersion(int major = 1, int minor = 6, int patch = 0) : major(major), minor(minor), patch(patch) { }
+};
+
+}
+
+#endif
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 50475f5b..b04fc9f5 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -30,7 +30,7 @@ void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCre
         certsCwrapper = MicroOcpp::makeCertificateStoreCwrapper(certs);
     }
 
-    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt), autoRecover, std::move(certsCwrapper));
+    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt), autoRecover, MicroOcpp::ProtocolVersion(1,6),std::move(certsCwrapper));
 }
 
 void ocpp_deinitialize() {
diff --git a/tests/Certificates.cpp b/tests/Certificates.cpp
index 01535e67..7266e5b1 100644
--- a/tests/Certificates.cpp
+++ b/tests/Certificates.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"
diff --git a/tests/Configuration.cpp b/tests/Configuration.cpp
index c890f96f..8d918ccf 100644
--- a/tests/Configuration.cpp
+++ b/tests/Configuration.cpp
@@ -275,7 +275,7 @@ TEST_CASE( "Configuration" ) {
                 [] () {
                     //create req
                     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
-                    auto payload = doc->to<JsonObject>();
+                    doc->to<JsonObject>();
                     return doc;},
                 [&checkProcessed] (JsonObject payload) {
                     //receive conf
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index 208b12e6..42ec4994 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -818,7 +818,7 @@ TEST_CASE( "LocalAuth" ) {
                     })));
             
             loop();
-            REQUIRE( authService->getLocalListVersion() == i );
+            REQUIRE( authService->getLocalListVersion() == (int)i );
             REQUIRE( authService->getLocalListSize() == i + 1 );
             REQUIRE( checkAccepted );
         }
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index cf113f03..8b5c5a50 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -278,7 +278,7 @@ TEST_CASE( "Reservation" ) {
 
         auto reservation = getOcppContext()->getModel().getReservationService()->getReservationById(reservationId);
         REQUIRE( reservation->getReservationId() == reservationId );
-        REQUIRE( reservation->getConnectorId() == connectorId );
+        REQUIRE( reservation->getConnectorId() == (int)connectorId );
         REQUIRE( reservation->getExpiryDate() == expiryDate );
         REQUIRE( !strcmp(reservation->getIdTag(), idTag) );
         REQUIRE( !strcmp(reservation->getParentIdTag(), parentIdTag) );
diff --git a/tests/Transactions.cpp b/tests/Transactions.cpp
new file mode 100644
index 00000000..edc0456c
--- /dev/null
+++ b/tests/Transactions.cpp
@@ -0,0 +1,99 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
+using namespace MicroOcpp;
+
+
+TEST_CASE( "Transactions" ) {
+    printf("\nRun %s\n",  "Transactions");
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+    mocpp_initialize(loopback,
+            ChargerCredentials("test-runner1234"),
+            makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail),
+            false,
+            ProtocolVersion(2,0,1));
+
+    auto context = getOcppContext();
+    auto& checkMsg = context->getOperationRegistry();
+
+    mocpp_set_timer(custom_timer_cb);
+
+    getOcppContext()->getOperationRegistry().registerOperation("Authorize", [] () {
+        return new Ocpp16::CustomOperation("Authorize",
+            [] (JsonObject) {}, //ignore req
+            [] () {
+                //create conf
+                auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+                auto payload = doc->to<JsonObject>();
+                payload["idTokenInfo"]["status"] = "Accepted";
+                return doc;
+            });});
+
+    loop();
+
+    SECTION("Basic transaction") {
+
+        MO_DBG_DEBUG("plug EV");
+        setConnectorPluggedInput([] () {return true;});
+
+        loop();
+
+        MO_DBG_DEBUG("authorize");
+        context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken");
+
+        loop();
+
+        MO_DBG_DEBUG("EV requests charge");
+        setEvReadyInput([] () {return true;});
+
+        loop();
+
+        MO_DBG_DEBUG("power circuit closed");
+        setEvseReadyInput([] () {return true;});
+
+        loop();
+
+        MO_DBG_DEBUG("EV idle");
+        setEvReadyInput([] () {return false;});
+
+        loop();
+
+        MO_DBG_DEBUG("power circuit opened");
+        setEvseReadyInput([] () {return false;});
+
+        loop();
+
+        MO_DBG_DEBUG("deauthorize");
+        context->getModel().getTransactionService()->getEvse(1)->endAuthorization("mIdToken");
+
+        loop();
+        
+        MO_DBG_DEBUG("unplug EV");
+        setConnectorPluggedInput([] () {return false;});
+
+        loop();
+    }
+
+    mocpp_deinitialize();
+}
+
+#endif // MO_ENABLE_V201
diff --git a/tests/Variables.cpp b/tests/Variables.cpp
new file mode 100644
index 00000000..156840ea
--- /dev/null
+++ b/tests/Variables.cpp
@@ -0,0 +1,516 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+
+using namespace MicroOcpp;
+
+#define GET_CONFIG_ALL "[2,\"test-msg\",\"GetVariable\",{}]"
+#define KNOWN_KEY "__ExistingKey"
+#define UNKOWN_KEY "__UnknownKey"
+#define GET_CONFIG_KNOWN_UNKOWN "[2,\"test-mst\",\"GetVariable\",{\"key\":[\"" KNOWN_KEY "\",\"" UNKOWN_KEY "\"]}]"
+
+TEST_CASE( "Variable" ) {
+    printf("\nRun %s\n",  "Variable");
+
+    //clean state
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
+    FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+
+    SECTION("Basic container operations"){
+        std::unique_ptr<VariableContainer> container;
+
+        SECTION("Volatile storage") {
+            container = makeVariableContainerVolatile(MO_VARIABLE_VOLATILE "/volatile1", true);
+        }
+
+#if 0
+        SECTION("Persistent storage") {
+            container = makeVariableContainerFlash(filesystem, MO_FILENAME_PREFIX "persistent1.jsn", true);
+        }
+#endif
+
+        //check emptyness
+        REQUIRE( container->size() == 0 );
+
+        //add first config, fetch by index
+        Variable::AttributeTypeSet attrs = Variable::AttributeType::Actual;
+        auto configFirst = container->createVariable(Variable::InternalDataType::Int, attrs);
+        configFirst->setName("cFirst");
+        configFirst->setComponentId("mComponent");
+        auto configFirstRaw = configFirst.get();
+        REQUIRE( container->size() == 0 );
+        REQUIRE( container->add(std::move(configFirst)) );
+        REQUIRE( container->size() == 1 );
+        REQUIRE( container->getVariable((size_t) 0) == configFirstRaw);
+
+        //add one config of each type
+        auto cInt = container->createVariable(Variable::InternalDataType::Int, attrs);
+        cInt->setName("cInt");
+        cInt->setComponentId("mComponent");
+        auto cBool = container->createVariable(Variable::InternalDataType::Bool, attrs);
+        cBool->setName("cBool");
+        cBool->setComponentId("mComponent");
+        auto cBoolRaw = cBool.get();
+        auto cString = container->createVariable(Variable::InternalDataType::String, attrs);
+        cString->setName("cString");
+        cString->setComponentId("mComponent");
+
+        container->add(std::move(cInt));
+        container->add(std::move(cBool));
+        container->add(std::move(cString));
+
+        REQUIRE( container->size() == 4 );
+
+        //fetch config by key
+        REQUIRE( container->getVariable(cBoolRaw->getComponentId(), cBoolRaw->getName()) == cBoolRaw);
+    }
+
+#if 0
+    SECTION("Persistency on filesystem") {
+
+        auto container = makeVariableContainerFlash(filesystem, MO_FILENAME_PREFIX "persistent1.jsn", true);
+
+        //trivial load call
+        REQUIRE( container->load() );
+        REQUIRE( container->size() == 0 );
+
+        //add config, store, load again
+        auto cString = container->createVariable(Variable::InternalDataType::String, "cString");
+        cString->setString("mValue");
+
+        REQUIRE( container->save() ); //store
+
+        container.reset(); //destroy
+
+        //...load again
+        auto container2 = makeVariableContainerFlash(filesystem, MO_FILENAME_PREFIX "persistent1.jsn", true);
+        REQUIRE( container2->size() == 0 );
+        REQUIRE( container2->load() );
+        REQUIRE( container2->size() == 1 );
+
+        auto cString2 = container2->getVariable("cString");
+        REQUIRE( cString2 != nullptr );
+        REQUIRE( !strcmp(cString2->getString(), "mValue") );
+    }
+#endif
+
+    LoopbackConnection loopback; //initialize Context with dummy socket
+    mocpp_set_timer(custom_timer_cb);
+
+    SECTION("Variable API") {
+
+        //declare configs
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        auto vs = getOcppContext()->getModel().getVariableService();
+        auto cInt = vs->declareVariable<int>("mComponent", "cInt", 42);
+        REQUIRE( cInt != nullptr );
+        vs->declareVariable<bool>("mComponent", "cBool", true);
+        vs->declareVariable<const char*>("mComponent", "cString", "mValue");
+
+        //fetch config
+        REQUIRE( vs->declareVariable("mComponent", "cInt", -1)->getInt() == 42 );
+
+#if 0
+        //store, destroy, reload
+        REQUIRE( configuration_save() );
+        cInt.reset();
+        configuration_deinit();
+        REQUIRE( getVariablePublic("cInt") == nullptr);
+
+        REQUIRE( configuration_init(filesystem) ); //reload
+
+        //fetch configs (declare with different factory default - should remain at original value)
+        auto cInt2 = vs->declareVariable<int>("cInt", -1);
+        auto cBool2 = vs->declareVariable<bool>("cBool", false);
+        auto cString2 = vs->declareVariable<const char*>("cString", "no effect");
+        REQUIRE( configuration_load() ); //load config objects with stored values
+
+        //check load result
+        REQUIRE( cInt2->getInt() == 42 );
+        REQUIRE( cBool2->getBool() == true );
+        REQUIRE( !strcmp(cString2->getString(), "mValue") );
+#else
+        auto cInt2 = cInt;
+#endif
+
+        //declare config twice
+        auto cInt3 = vs->declareVariable<int>("mComponent", "cInt", -1);
+        REQUIRE( cInt3 == cInt2 );
+
+        //declare config twice but in different container
+        auto cInt4 = vs->declareVariable<int>("mComponent", "cInt", -1, MO_VARIABLE_VOLATILE "/volatile2");
+        REQUIRE( cInt4 == cInt2 );
+
+        //declare config twice but with conflicting type (will supersede old type because to simplify FW upgrades)
+        auto cNewType = vs->declareVariable<const char*>("mComponent", "cInt", "mValue2");
+        REQUIRE( cNewType != cInt2 );
+        REQUIRE( cInt2->isDetached() ); // Container should not store this
+        REQUIRE( !strcmp(cNewType->getString(), "mValue2") );
+
+#if 0
+        //store, destroy, reload
+        REQUIRE( configuration_save() );
+        configuration_deinit();
+        REQUIRE( getVariablePublic("cInt") == nullptr);
+        REQUIRE( configuration_init(filesystem) ); //reload
+        auto cNewType2 = vs->declareVariable<const char*>("cInt", "no effect");
+        REQUIRE( configuration_load() );
+        REQUIRE( !strcmp(cNewType2->getString(), "mValue2") );
+
+        //get config before declared (container needs to be declared already at this point)
+        auto cString3 = getVariablePublic("cString");
+        REQUIRE( !strcmp(cString3->getString(), "mValue") );
+        configuration_deinit();
+
+        //value needs to outlive container
+        configuration_init(filesystem);
+        auto cString4 = vs->declareVariable<const char *>("cString2", "mValue3");
+        configuration_deinit();
+        REQUIRE( !strcmp(cString4->getString(), "mValue3") );
+
+        FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+#else
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+#endif
+
+        //config accessibility / permissions
+        vs = getOcppContext()->getModel().getVariableService();
+        Variable::Mutability mutability = Variable::Mutability::ReadWrite;
+        Variable::AttributeTypeSet attrs = Variable::AttributeType::Actual;
+        bool rebootRequired = false;
+        bool isAccessible = true;
+        auto cInt6 = vs->declareVariable<int>("mComponent", "cInt", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
+        REQUIRE( cInt6->getMutability() == Variable::Mutability::ReadWrite );
+        REQUIRE( !cInt6->isRebootRequired() );
+        REQUIRE( vs->declareVariable<int>("mComponent", "cInt", 42) );
+
+        //revoke permissions
+        mutability = Variable::Mutability::ReadOnly;
+        rebootRequired = true;
+        vs->declareVariable<int>("mComponent", "cInt", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
+        REQUIRE( cInt6->getMutability() == mutability );
+        REQUIRE( cInt6->isRebootRequired() );
+
+        //revoked permissions cannot be reverted
+        mutability = Variable::Mutability::ReadWrite;
+        rebootRequired = false;
+        auto cInt7 = vs->declareVariable<int>("mComponent", "cInt", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
+        REQUIRE( cInt7->getMutability() == Variable::Mutability::ReadOnly );
+        REQUIRE( cInt7->isRebootRequired() );
+
+        //accessibility cannot be changed after first initialization
+        isAccessible = false;
+        vs->declareVariable<int>("mComponent", "cInt", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
+        vs->declareVariable<int>("mComponent", "cInt2", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
+        Variable *result = nullptr;
+        REQUIRE( vs->getVariable(Variable::AttributeType::Actual, "mComponent", "cInt", &result) == GetVariableStatus::Accepted );
+        REQUIRE( result != nullptr );
+        result = nullptr;
+        REQUIRE( vs->getVariable(Variable::AttributeType::Actual, "mComponent", "cInt2", &result) == GetVariableStatus::Accepted );
+        REQUIRE( result != nullptr );
+
+        //create config in hidden container
+        isAccessible = false;
+        auto cHidden = vs->declareVariable<int>("mComponent", "cHidden", 42, MO_VARIABLE_VOLATILE "/hidden.json", mutability, attrs, rebootRequired, isAccessible);
+        (void)cHidden;
+        result = nullptr;
+        REQUIRE( vs->getVariable(Variable::AttributeType::Actual, "mComponent", "cHidden", &result) == GetVariableStatus::Accepted );
+        REQUIRE( result != nullptr );
+    }
+
+#if 0
+    SECTION("Main lib integration") {
+
+        //basic lifecycle
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        REQUIRE( getVariablePublic("ConnectionTimeOut") );
+        REQUIRE( !getVariableContainersPublic().empty() );
+        mocpp_deinitialize();
+        REQUIRE( !getVariablePublic("ConnectionTimeOut") );
+        REQUIRE( getVariableContainersPublic().empty() );
+
+        //modify standard config ConnectionTimeOut. This config is not modified by the main lib during normal initialization / deinitialization
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        auto config = getVariablePublic("ConnectionTimeOut");
+
+        config->setInt(1234); //update
+        configuration_save(); //write back
+
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        REQUIRE( getVariablePublic("ConnectionTimeOut")->getInt() == 1234 );
+
+        mocpp_deinitialize();
+    }
+#endif
+
+#if 0
+    SECTION("GetVariables") {
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        loop();
+
+        vs->declareVariable<int>(KNOWN_KEY, 1234, MO_FILENAME_PREFIX "persistent1.jsn", false);
+
+        bool checkProcessed = false;
+
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "GetVariables",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    JsonArray configurationKey = payload["configurationKey"];
+
+                    bool foundCustomConfig = false;
+                    bool foundStandardConfig = false;
+                    for (JsonObject keyvalue : configurationKey) {
+                        MO_DBG_DEBUG("key %s", keyvalue["key"] | "_Undefined");
+                        if (!strcmp(keyvalue["key"] | "_Undefined", KNOWN_KEY)) {
+                            foundCustomConfig = true;
+                            REQUIRE( (keyvalue["readonly"] | true) == false );
+                            REQUIRE( !strcmp(keyvalue["value"] | "_Undefined", "1234") );
+                        } else if (!strcmp(keyvalue["key"] | "_Undefined", "ConnectionTimeOut")) {
+                            foundStandardConfig = true;
+                        }
+                    }
+
+                    REQUIRE( foundCustomConfig );
+                    REQUIRE( foundStandardConfig );
+                }
+        )));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+
+        checkProcessed = false;
+
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "GetVariable",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    auto key = payload.createNestedArray("key");
+                    key.add(KNOWN_KEY);
+                    key.add(UNKOWN_KEY);
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    JsonArray configurationKey = payload["configurationKey"];
+
+                    bool foundCustomConfig = false;
+                    for (JsonObject keyvalue : configurationKey) {
+                        if (!strcmp(keyvalue["key"] | "_Undefined", KNOWN_KEY)) {
+                            foundCustomConfig = true;
+                            break;
+                        }
+                    }
+                    REQUIRE( foundCustomConfig );
+
+                    JsonArray unknownKey = payload["unknownKey"];
+
+                    bool foundUnkownKey = false;
+                    for (const char *key : unknownKey) {
+                        if (!strcmp(key, UNKOWN_KEY)) {
+                            foundUnkownKey = true;
+                        }
+                    }
+
+                    REQUIRE( foundUnkownKey );
+                }
+        )));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+
+        mocpp_deinitialize();
+    }
+
+    SECTION("ChangeVariable") {
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        loop();
+
+        vs->declareVariable<int>(KNOWN_KEY, 0, MO_FILENAME_PREFIX "persistent1.jsn", false);
+
+        //update existing config
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeVariable",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = KNOWN_KEY;
+                    payload["value"] = "1234";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE(checkProcessed);
+        REQUIRE( getVariablePublic(KNOWN_KEY)->getInt() == 1234 );
+
+        //try to update not existing key
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeVariable",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = UNKOWN_KEY;
+                    payload["value"] = "no effect";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "NotSupported") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        //try to update config with malformatted value
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeVariable",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = KNOWN_KEY;
+                    payload["value"] = "not convertible to int";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Rejected") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        //try to update config with value validation
+        //value is valid if it begins with 1
+        registerVariableValidator(KNOWN_KEY, [] (const char *v) {
+            return v[0] == '1';
+        });
+
+        //validation success
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeVariable",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = KNOWN_KEY;
+                    payload["value"] = "100234";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( getVariablePublic(KNOWN_KEY)->getInt() == 100234 );
+
+        //validation failure
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "ChangeVariable",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["key"] = KNOWN_KEY;
+                    payload["value"] = "4321";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Rejected") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( getVariablePublic(KNOWN_KEY)->getInt() == 100234 ); //keep old value
+
+        mocpp_deinitialize();
+    }
+
+    SECTION("Define factory defaults for standard configs") {
+
+        //set factory default for standard config ConnectionTimeOut
+        configuration_init(filesystem);
+        auto factoryConnectionTimeOut = vs->declareVariable<int>("ConnectionTimeOut", 1234, MO_FILENAME_PREFIX "factory.jsn");
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        auto connectionTimeout2 = vs->declareVariable<int>("ConnectionTimeOut", 4321);
+        REQUIRE( connectionTimeout2->getInt() == 1234 );
+        REQUIRE( connectionTimeout2 == factoryConnectionTimeOut );
+
+        configuration_save();
+        mocpp_deinitialize();
+
+        //this time, factory default is not given (will lead to duplicates, should be considered in sanitization)
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        REQUIRE( getVariablePublic("ConnectionTimeOut")->getInt() != 1234 );
+        mocpp_deinitialize();
+
+        //provide factory default again
+        configuration_init(filesystem);
+        vs->declareVariable<int>("ConnectionTimeOut", 4321, MO_FILENAME_PREFIX "factory.jsn");
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        REQUIRE( getVariablePublic("ConnectionTimeOut")->getInt() == 1234 );
+        mocpp_deinitialize();
+
+    }
+#endif
+
+    mocpp_deinitialize();
+}
+
+#endif // MO_ENABLE_V201

From d95e24a9838787a2f8cbd7ca1d8a0bc1e587db2f Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 27 Feb 2024 22:44:27 +0100
Subject: [PATCH 441/549] Update README.md

---
 README.md | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 89d7d434..28e24a52 100644
--- a/README.md
+++ b/README.md
@@ -6,21 +6,19 @@
 
 OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif, Arduino, NXP, STM, Linux and more.
 
-**Formerly ArduinoOcpp ([migration guide](https://matth-x.github.io/MicroOcpp/migration/))**: *the initial version of this library used the Arduino API but this dependency was dropped some time ago and the old name has become outdated. Despite the new name, nothing changes for existing users and the Arduino integration will continue to be fully functional.*
-
-Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.micro-ocpp.com](https://www.micro-ocpp.com)
-
-:heavy_check_mark: Works with [SteVe](https://github.com/RWTH-i5-IDSG/steve) and [15+ commercial Central Systems](https://www.micro-ocpp.com/#h.314525e8447cc93c_81)
+:heavy_check_mark: Works with [15+ commercial Central Systems](https://www.micro-ocpp.com/#h.314525e8447cc93c_81)
 
 :heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
-:heavy_check_mark: Supports all OCPP 1.6 feature profiles
+:heavy_check_mark: Supports all OCPP 1.6 feature profiles and OCPP 2.0.1 preview
+
+Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.micro-ocpp.com](https://www.micro-ocpp.com)
 
 ## Tester / Demo App
 
 *Main repository: [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)*
 
-(Beta) The Simulator is a demo & development tool for MicroOcpp which allows to quickly assess the compatibility with different OCPP backends. It simulates a full charging station, adds a GUI and a mocked hardware binding to MicroOcpp and runs in the browser (using WebAssembly): [Try it](https://demo.micro-ocpp.com/)
+The Simulator is a demo & development tool for MicroOcpp which allows to quickly assess the compatibility with different OCPP backends. It simulates a full charging station, adds a GUI and a mocked hardware binding to MicroOcpp and runs in the browser (using WebAssembly): [Try it](https://demo.micro-ocpp.com/)
 
 <div align="center"><img src="https://github.com/matth-x/MicroOcpp/assets/63792403/27f2819b-41fd-41a7-88a8-9e673b8a88b8" alt="Screenshot" width="800em" href="https://demo.micro-ocpp.com/"></div>
 

From 177651142c74de37a51587d675c215bf7d51884b Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 1 Mar 2024 20:45:58 +0100
Subject: [PATCH 442/549] make field localAuthorizationList optional

---
 CHANGELOG.md                               | 4 ++++
 src/MicroOcpp/Operations/SendLocalList.cpp | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e8e89c4d..53f11eb8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,10 @@
     - Transactions (preview only), UCs E01 - E12 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
     - StatusNotification compatibility ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
 
+### Fixed
+
+- Make field localAuthorizationList in SendLocalList optional
+
 ## [1.1.0] - 2024-02-27
 
 ### Fixed
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 70895af5..53dc3de5 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -26,7 +26,7 @@ void SendLocalList::processReq(JsonObject payload) {
         return;
     }
 
-    if (!payload["localAuthorizationList"].is<JsonArray>()) {
+    if (payload.containsKey("localAuthorizationList") && !payload["localAuthorizationList"].is<JsonArray>()) {
         errorCode = "FormationViolation";
         return;
     }

From 6c8a68a20df5cc0fee825a4641c2ff4aed06b077 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 3 Mar 2024 19:27:19 +0100
Subject: [PATCH 443/549] fix v2.0.1 transactions (#265)

---
 src/MicroOcpp/Model/Authorization/IdToken.cpp |   4 +
 src/MicroOcpp/Model/Authorization/IdToken.h   |   2 +
 .../Model/ConnectorBase/Connector.cpp         |  71 +--
 .../Model/ConnectorBase/ConnectorsCommon.cpp  |  29 +-
 .../Model/Transactions/Transaction.h          | 120 ++---
 .../Model/Transactions/TransactionService.cpp | 445 ++++++++++++------
 .../Model/Transactions/TransactionService.h   |  19 +-
 src/MicroOcpp/Operations/Authorize.cpp        |  66 ++-
 src/MicroOcpp/Operations/Authorize.h          |  34 +-
 src/MicroOcpp/Operations/TransactionEvent.cpp |  96 ++--
 src/MicroOcpp/Operations/TransactionEvent.h   |   6 +-
 tests/Transactions.cpp                        |   8 +
 12 files changed, 598 insertions(+), 302 deletions(-)

diff --git a/src/MicroOcpp/Model/Authorization/IdToken.cpp b/src/MicroOcpp/Model/Authorization/IdToken.cpp
index aab55a7b..94bc250e 100644
--- a/src/MicroOcpp/Model/Authorization/IdToken.cpp
+++ b/src/MicroOcpp/Model/Authorization/IdToken.cpp
@@ -66,4 +66,8 @@ const char *IdToken::getTypeCstr() const {
     return res ? res : "";
 }
 
+bool IdToken::equals(const IdToken& other) {
+    return type == other.type && !strcmp(idToken, other.idToken);
+}
+
 #endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Authorization/IdToken.h b/src/MicroOcpp/Model/Authorization/IdToken.h
index 441055dc..492f02a2 100644
--- a/src/MicroOcpp/Model/Authorization/IdToken.h
+++ b/src/MicroOcpp/Model/Authorization/IdToken.h
@@ -41,6 +41,8 @@ class IdToken {
 
     const char *get() const;
     const char *getTypeCstr() const;
+
+    bool equals(const IdToken& other);
 };
 
 } // namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 4f82c90c..af748634 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -75,42 +75,45 @@ Connector::~Connector() {
 }
 
 ChargePointStatus Connector::getStatus() {
+
+    ChargePointStatus res = ChargePointStatus::NOT_SET;
+
     /*
     * Handle special case: This is the Connector for the whole CP (i.e. connectorId=0) --> only states Available, Unavailable, Faulted are possible
     */
     if (connectorId == 0) {
         if (isFaulted()) {
-            return ChargePointStatus::Faulted;
+            res = ChargePointStatus::Faulted;
         } else if (!isOperative()) {
-            return ChargePointStatus::Unavailable;
+            res = ChargePointStatus::Unavailable;
         } else {
-            return ChargePointStatus::Available;
+            res = ChargePointStatus::Available;
         }
+        return res;
     }
 
     if (isFaulted()) {
-        return ChargePointStatus::Faulted;
+        res = ChargePointStatus::Faulted;
     } else if (!isOperative()) {
-        return ChargePointStatus::Unavailable;
+        res = ChargePointStatus::Unavailable;
     } else if (transaction && transaction->isRunning()) {
         //Transaction is currently running
         if (connectorPluggedInput && !connectorPluggedInput()) { //special case when StopTransactionOnEVSideDisconnect is false
-            return ChargePointStatus::SuspendedEV;
-        }
-        if (!ocppPermitsCharge() ||
+            res = ChargePointStatus::SuspendedEV;
+        } else if (!ocppPermitsCharge() ||
                 (evseReadyInput && !evseReadyInput())) { 
-            return ChargePointStatus::SuspendedEVSE;
-        }
-        if (evReadyInput && !evReadyInput()) {
-            return ChargePointStatus::SuspendedEV;
+            res = ChargePointStatus::SuspendedEVSE;
+        } else if (evReadyInput && !evReadyInput()) {
+            res = ChargePointStatus::SuspendedEV;
+        } else {
+            res = ChargePointStatus::Charging;
         }
-        return ChargePointStatus::Charging;
     } else if (model.getReservationService() && model.getReservationService()->getReservation(connectorId)) {
-        return ChargePointStatus::Reserved;
+        res = ChargePointStatus::Reserved;
     } else if ((!transaction || !transaction->isActive()) &&                 //no transaction preparation
                (!connectorPluggedInput || !connectorPluggedInput()) &&   //no vehicle plugged
                (!occupiedInput || !occupiedInput())) {                       //occupied override clear
-        return ChargePointStatus::Available;
+        res = ChargePointStatus::Available;
     } else {
         /*
          * Either in Preparing or Finishing state. Only way to know is from previous state
@@ -120,14 +123,31 @@ ChargePointStatus Connector::getStatus() {
                 previous == ChargePointStatus::Charging ||
                 previous == ChargePointStatus::SuspendedEV ||
                 previous == ChargePointStatus::SuspendedEVSE) {
-            return ChargePointStatus::Finishing;
+            res = ChargePointStatus::Finishing;
         } else {
-            return ChargePointStatus::Preparing;
+            res = ChargePointStatus::Preparing;
         }
     }
 
-    MO_DBG_DEBUG("status undefined");
-    return ChargePointStatus::Faulted; //internal error
+#if MO_ENABLE_V201
+    if (model.getVersion().major == 2) {
+        //OCPP 2.0.1: map v1.6 status onto v2.0.1
+        if (res == ChargePointStatus::Preparing ||
+                res == ChargePointStatus::Charging ||
+                res == ChargePointStatus::SuspendedEV ||
+                res == ChargePointStatus::SuspendedEVSE ||
+                res == ChargePointStatus::Finishing) {
+            res = ChargePointStatus::Occupied;
+        }
+    }
+#endif
+
+    if (res == ChargePointStatus::NOT_SET) {
+        MO_DBG_DEBUG("status undefined");
+        return ChargePointStatus::Faulted; //internal error
+    }
+
+    return res;
 }
 
 bool Connector::ocppPermitsCharge() {
@@ -388,19 +408,6 @@ void Connector::loop() {
         }
     }
 
-#if MO_ENABLE_V201
-    if (model.getVersion().major == 2) {
-        //OCPP 2.0.1: map v1.6 status onto v2.0.1
-        if (status == ChargePointStatus::Preparing ||
-                status == ChargePointStatus::Charging ||
-                status == ChargePointStatus::SuspendedEV ||
-                status == ChargePointStatus::SuspendedEVSE ||
-                status == ChargePointStatus::Finishing) {
-            status = ChargePointStatus::Occupied;
-        }
-    }
-#endif
-
     if (status != currentStatus) {
         currentStatus = status;
         t_statusTransition = mocpp_tick_ms();
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index 2a31817b..67c6818d 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <string>
@@ -21,8 +21,10 @@
 #include <MicroOcpp/Operations/StartTransaction.h>
 #include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Operations/StopTransaction.h>
+#include <MicroOcpp/Operations/TransactionEvent.h>
 
 #include <MicroOcpp/Debug.h>
+#include <MicroOcpp/Version.h>
 
 using namespace MicroOcpp;
 
@@ -61,14 +63,27 @@ ConnectorsCommon::ConnectorsCommon(Context& context, unsigned int numConn, std::
      * is connected with a WebSocket echo server, let it reply to its own requests.
      * Mocking an OCPP Server on the same device makes running (unit) tests easier.
      */
-    context.getOperationRegistry().registerOperation("Authorize", [&context] () {
-        return new Ocpp16::Authorize(context.getModel(), "");});
-    context.getOperationRegistry().registerOperation("StartTransaction", [&context] () {
-        return new Ocpp16::StartTransaction(context.getModel(), nullptr);});
+#if MO_ENABLE_V201
+    if (context.getVersion().major == 2) {
+        // OCPP 2.0.1 compliant echo messages
+        context.getOperationRegistry().registerOperation("Authorize", [&context] () {
+            return new Ocpp201::Authorize(context.getModel(), "");});
+        context.getOperationRegistry().registerOperation("TransactionEvent", [&context] () {
+            return new Ocpp201::TransactionEvent(context.getModel(), nullptr);});
+    } else
+#endif //MO_ENABLE_V201
+    {
+        // OCPP 1.6 compliant echo messages
+        context.getOperationRegistry().registerOperation("Authorize", [&context] () {
+            return new Ocpp16::Authorize(context.getModel(), "");});
+        context.getOperationRegistry().registerOperation("StartTransaction", [&context] () {
+            return new Ocpp16::StartTransaction(context.getModel(), nullptr);});
+        context.getOperationRegistry().registerOperation("StopTransaction", [&context] () {
+            return new Ocpp16::StopTransaction(context.getModel(), nullptr);});
+    }
+    // OCPP 1.6 + 2.0.1 compliant echo messages
     context.getOperationRegistry().registerOperation("StatusNotification", [&context] () {
         return new Ocpp16::StatusNotification(-1, ChargePointStatus::NOT_SET, Timestamp());});
-    context.getOperationRegistry().registerOperation("StopTransaction", [&context] () {
-        return new Ocpp16::StopTransaction(context.getModel(), nullptr);});
 }
 
 void ConnectorsCommon::loop() {
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index cfc8a6f3..b1d2a837 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -181,11 +181,61 @@ class Transaction {
 namespace MicroOcpp {
 namespace Ocpp201 {
 
+// TriggerReasonEnumType (3.82)
+enum class TransactionEventTriggerReason : uint8_t {
+    UNDEFINED, // not part of OCPP
+    Authorized,
+    CablePluggedIn,
+    ChargingRateChanged,
+    ChargingStateChanged,
+    Deauthorized,
+    EnergyLimitReached,
+    EVCommunicationLost,
+    EVConnectTimeout,
+    MeterValueClock,
+    MeterValuePeriodic,
+    TimeLimitReached,
+    Trigger,
+    UnlockCommand,
+    StopAuthorized,
+    EVDeparted,
+    EVDetected,
+    RemoteStop,
+    RemoteStart,
+    AbnormalCondition,
+    SignedDataReceived,
+    ResetCommand
+};
+
 class Transaction {
 public:
+
+    // ReasonEnumType (3.67)
+    enum class StopReason : uint8_t {
+        UNDEFINED, // not part of OCPP
+        DeAuthorized,
+        EmergencyStop,
+        EnergyLimitReached,
+        EVDisconnected,
+        GroundFault,
+        ImmediateReset,
+        Local,
+        LocalOutOfCredit,
+        MasterPass,
+        Other,
+        OvercurrentFault,
+        PowerLoss,
+        PowerQuality,
+        Reboot,
+        Remote,
+        SOCLimitReached,
+        StoppedByEV,
+        TimeLimitReached,
+        Timeout
+    };
+
     struct SubStatus {
         bool triggered = false;
-        bool untriggered = false;
         SendStatus remote;
     };
 
@@ -205,11 +255,20 @@ class Transaction {
     bool isDeauthorized = false;  //if the server revoked a local authorization
     unsigned int seqNoCounter = 0; // increment by 1 for each event
     IdToken idToken;
-    Timestamp startTime = MIN_TIME;
+    Timestamp beginTimestamp = MIN_TIME;
     char transactionId [MO_TXID_LEN_MAX + 1] = {'\0'};
     int remoteStartId = -1;
 
-    bool idTokenTransmitted = false;
+    bool idTokenTransmitted = true;
+
+    bool evConnectionTimeoutListen = true;
+
+    bool started = false, stopped = false;
+
+    StopReason stopReason = StopReason::UNDEFINED;
+    TransactionEventTriggerReason stopTrigger = TransactionEventTriggerReason::UNDEFINED;
+    std::unique_ptr<IdToken> stopIdToken; // if null, then stopIdToken equals idToken
+    bool stopIdTokenTransmitted = true;
 };
 
 // TransactionEventRequest (1.60.1)
@@ -223,31 +282,6 @@ class TransactionEventData {
         Updated
     };
 
-    // TriggerReasonEnumType (3.82)
-    enum class TriggerReason : uint8_t {
-        Authorized,
-        CablePluggedIn,
-        ChargingRateChanged,
-        ChargingStateChanged,
-        Deauthorized,
-        EnergyLimitReached,
-        EVCommunicationLost,
-        EVConnectTimeout,
-        MeterValueClock,
-        MeterValuePeriodic,
-        TimeLimitReached,
-        Trigger,
-        UnlockCommand,
-        StopAuthorized,
-        EVDeparted,
-        EVDetected,
-        RemoteStop,
-        RemoteStart,
-        AbnormalCondition,
-        SignedDataReceived,
-        ResetCommand
-    };
-
     // ChargingStateEnumType (3.16)
     enum class ChargingState : uint8_t {
         UNDEFINED, // not part of OCPP
@@ -258,35 +292,11 @@ class TransactionEventData {
         Idle
     };
 
-    // ReasonEnumType (3.67)
-    enum class StopReason : uint8_t {
-        UNDEFINED, // not part of OCPP
-        DeAuthorized,
-        EmergencyStop,
-        EnergyLimitReached,
-        EVDisconnected,
-        GroundFault,
-        ImmediateReset,
-        Local,
-        LocalOutOfCredit,
-        MasterPass,
-        Other,
-        OvercurrentFault,
-        PowerLoss,
-        PowerQuality,
-        Reboot,
-        Remote,
-        SOCLimitReached,
-        StoppedByEV,
-        TimeLimitReached,
-        Timeout
-    };
-
 //private:
     std::shared_ptr<Transaction> transaction;
     Type eventType;
     Timestamp timestamp;
-    TriggerReason triggerReason;
+    TransactionEventTriggerReason triggerReason;
     const unsigned int seqNo;
     bool offline = false;
     int numberOfPhasesUsed = -1;
@@ -296,9 +306,7 @@ class TransactionEventData {
     // TransactionType (2.48)
     ChargingState chargingState = ChargingState::UNDEFINED;
     //int timeSpentCharging = 0; // not supported
-    StopReason stoppedReason = StopReason::UNDEFINED;
-
-    bool idTokenTransmit = false; // if the idToken has been updated should be transmitted with this Event
+    std::unique_ptr<IdToken> idToken;
     EvseId evse = -1;
     //meterValue not supported
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index 7a8ed1c6..b3e6d5db 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -14,8 +14,8 @@
 #include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Operations/Authorize.h>
 #include <MicroOcpp/Operations/TransactionEvent.h>
-#include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Debug.h>
 
@@ -37,6 +37,7 @@ std::unique_ptr<Ocpp201::Transaction> TransactionService::Evse::allocateTransact
     //simple clock-based hash
     int v = context.getModel().getClock().now() - Timestamp(2020,0,0,0,0,0);
     unsigned int h = v;
+    h += mocpp_tick_ms();
     h *= 749572633U;
     h %= 24593209U;
     for (size_t i = 0; i < sizeof(tx->transactionId) - 3; i += 2) {
@@ -45,171 +46,224 @@ std::unique_ptr<Ocpp201::Transaction> TransactionService::Evse::allocateTransact
         h %= 24593209U;
     }
 
+    tx->beginTimestamp = context.getModel().getClock().now();
+
     return tx;
 }
 
 void TransactionService::Evse::loop() {
 
+    // tx-related behavior
+    if (transaction) {
+        if (connectorPluggedInput) {
+            if (connectorPluggedInput()) {
+                // if cable has been plugged at least once, EVConnectionTimeout will never get triggered
+                transaction->evConnectionTimeoutListen = false;
+            }
+            if (transaction->active &&
+                    transaction->evConnectionTimeoutListen &&
+                    transaction->beginTimestamp > MIN_TIME &&
+                    txService.evConnectionTimeOutInt && txService.evConnectionTimeOutInt->getInt() > 0 &&
+                    !connectorPluggedInput() &&
+                    context.getModel().getClock().now() - transaction->beginTimestamp >= txService.evConnectionTimeOutInt->getInt()) {
+
+                MO_DBG_INFO("Session mngt: timeout");
+                transaction->active = false;
+                transaction->stopTrigger = TransactionEventTriggerReason::EVConnectTimeout;
+                transaction->stopReason = Ocpp201::Transaction::StopReason::Timeout;
+            }
+        }
+    }
+
+    // TxEvent types
     bool txStarted = false;
     bool txStopped = false;
-
     bool txUpdated = false;
 
-    TransactionEventData::TriggerReason triggerReason; // only valid if txStarted || txStopped || txUpdated
-    TransactionEventData::StopReason stoppedReason; // only valid if txStopped
+    TransactionEventTriggerReason triggerReason = TransactionEventTriggerReason::UNDEFINED;
+    Ocpp201::Transaction::StopReason stoppedReason = Ocpp201::Transaction::StopReason::UNDEFINED;
 
-    if (!txStarted && !txStopped && !txUpdated) {
-        if (connectorPluggedInput && connectorPluggedInput()) {
-            if (!transaction && txService.isTxStartPoint(TxStartStopPoint::EVConnected)) {
-                transaction = allocateTransaction();
-                txStarted = true;
-            }
-
-            if (transaction && !transaction->evConnected.triggered) {
-                transaction->evConnected.triggered = true;
-                txUpdated = true;
-                triggerReason = TransactionEventData::TriggerReason::CablePluggedIn;
-            }
-        } else if (connectorPluggedInput && !connectorPluggedInput()) {
-            if (transaction && transaction->evConnected.triggered) {
-                if (!transaction->evConnected.untriggered) {
-                    transaction->evConnected.untriggered = true;
-                    txUpdated = true;
-                    triggerReason = TransactionEventData::TriggerReason::EVCommunicationLost;
-                }
+    // tx should be updated?
+    TransactionEventData::ChargingState chargingState = TransactionEventData::ChargingState::Idle;
+    if (transaction) {
+        chargingState = TransactionEventData::ChargingState::Charging;
 
-                if (txService.isTxStopPoint(TxStartStopPoint::EVConnected)) {
-                    txStopped = true;
-                    stoppedReason = TransactionEventData::StopReason::EVDisconnected;
-                }
-            }
+        if (connectorPluggedInput && !connectorPluggedInput()) {
+            chargingState = TransactionEventData::ChargingState::Idle;
+        } else if (!transaction || !transaction->isAuthorized) {
+            chargingState = TransactionEventData::ChargingState::EVConnected;
+        } else if (evseReadyInput && !evseReadyInput()) { 
+            chargingState = TransactionEventData::ChargingState::SuspendedEVSE;
+        } else if (evReadyInput && !evReadyInput()) {
+            chargingState = TransactionEventData::ChargingState::SuspendedEV;
+        } else {
+            chargingState = TransactionEventData::ChargingState::Charging;
         }
     }
 
-    if (!txStarted && !txStopped && !txUpdated) {
-        if (evseReadyInput && evseReadyInput()) {
-            if (!transaction && txService.isTxStartPoint(TxStartStopPoint::PowerPathClosed)) {
-                transaction = allocateTransaction();
-                txStarted = true;
-            }
+    // tx should be started?
+    if (txService.isTxStartPoint(TxStartStopPoint::EVConnected) &&
+                connectorPluggedInput && connectorPluggedInput()) {
+        txStarted = true;
+        triggerReason = TransactionEventTriggerReason::CablePluggedIn;
+    } else if (txService.isTxStartPoint(TxStartStopPoint::PowerPathClosed) &&
+                evReadyInput && evReadyInput()) {
+        txStarted = true;
+        triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
+    } else if (txService.isTxStartPoint(TxStartStopPoint::Authorized) &&
+                transaction && transaction->isAuthorized) {
+        txStarted = true;
+        triggerReason = TransactionEventTriggerReason::Authorized;
+    }
 
-            if (transaction && !transaction->powerPathClosed.triggered) {
-                transaction->powerPathClosed.triggered = true;
-                txUpdated = true;
-                triggerReason = TransactionEventData::TriggerReason::ChargingStateChanged;
-            }
-        } else if (evseReadyInput && !evseReadyInput()) {
-            if (transaction && transaction->powerPathClosed.triggered) {
-                if (!transaction->powerPathClosed.untriggered) {
-                    transaction->powerPathClosed.untriggered = true;
-                    txUpdated = true;
-                    triggerReason = TransactionEventData::TriggerReason::ChargingStateChanged;
-                }
+    // tx should be stopped?
+    if (transaction && !transaction->active) {
+        // tx ended via endTransaction
+        txStopped = true;
+        triggerReason = transaction->stopTrigger;
+        stoppedReason = transaction->stopReason;
+    } else if (txService.isTxStopPoint(TxStartStopPoint::EVConnected) &&
+                connectorPluggedInput && !connectorPluggedInput() &&
+                (txService.stopTxOnEVSideDisconnectBool->getBool() || !transaction || !transaction->started)) {
+        txStopped = true;
+        triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
+        stoppedReason = Ocpp201::Transaction::StopReason::EVDisconnected;
+    } else if (txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed) &&
+                evReadyInput && !evReadyInput()) {
+        txStopped = true;
+        triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
+        stoppedReason = Ocpp201::Transaction::StopReason::StoppedByEV;
+    } else if (txService.isTxStopPoint(TxStartStopPoint::Authorized) &&
+                (!transaction || !transaction->isAuthorized)) {
+        // user revoked authorization (or EV or any "local" entity)
+        txStopped = true;
+        triggerReason = TransactionEventTriggerReason::StopAuthorized;
+        stoppedReason = Ocpp201::Transaction::StopReason::Local;
+    } else if (txService.isTxStopPoint(TxStartStopPoint::Authorized) &&
+                transaction && transaction->isDeauthorized &&
+                txService.stopTxOnInvalidIdBool->getBool()) {
+        // OCPP server rejected authorization
+        txStopped = true;
+        triggerReason = TransactionEventTriggerReason::Deauthorized;
+        stoppedReason = Ocpp201::Transaction::StopReason::DeAuthorized;
+    }
 
-                if (txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed)) {
-                    txStopped = true;
-                    stoppedReason = TransactionEventData::StopReason::StoppedByEV;
-                }
+    std::shared_ptr<TransactionEventData> txEvent;
+
+    if (txStopped) { // stop tx?
+        if (transaction && transaction->started && !transaction->stopped) {
+            // yes, stop running tx
+
+            txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
+            if (!txEvent) {
+                // OOM
+                return;
             }
+
+            txEvent->eventType = TransactionEventData::Type::Ended;
+            transaction->stopReason = stoppedReason;
         }
-    }
+    } else {
+        if (txStarted && (!transaction || !transaction->started)) { // start tx?
+            // yes, start tx
 
-    if (!txStarted && !txStopped && !txUpdated) {
-        if (authorization.get()) {
-            if (!transaction && txService.isTxStartPoint(TxStartStopPoint::Authorized)) {
+            if (!transaction) {
                 transaction = allocateTransaction();
-                txStarted = true;
+                if (!transaction) {
+                    // OOM
+                    return;
+                }
+            }
+
+            txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
+            if (!txEvent) {
+                // OOM
+                return;
             }
 
-            if (transaction && !transaction->authorized.triggered) {
-                transaction->authorized.triggered = true;
+            txEvent->eventType = TransactionEventData::Type::Started;
+            
+        } else if (transaction && transaction->started) {
+            // update tx?
+            if (chargingState != trackChargingState) {
                 txUpdated = true;
-                triggerReason = TransactionEventData::TriggerReason::Authorized;
+                triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
             }
-        } else {
-            if (transaction && transaction->authorized.triggered) {
-                if (!transaction->authorized.untriggered) {
-                    transaction->authorized.untriggered = true;
-                    txUpdated = true;
-                    triggerReason = TransactionEventData::TriggerReason::StopAuthorized;
-                }
+            trackChargingState = chargingState;
 
-                if (txService.isTxStopPoint(TxStartStopPoint::EVConnected)) {
-                    txStopped = true;
-                    stoppedReason = TransactionEventData::StopReason::Local;
+            if (transaction) {
+                if (connectorPluggedInput && connectorPluggedInput() && !transaction->evConnected.triggered) {
+                    transaction->evConnected.triggered = true;
+                    txUpdated = true;
+                    triggerReason = TransactionEventTriggerReason::CablePluggedIn;
+                } else if (connectorPluggedInput && !connectorPluggedInput() && transaction->evConnected.triggered) {
+                    transaction->evConnected.triggered = false;
+                    txUpdated = true;
+                    triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
+                } else if (transaction->isAuthorized && !transaction->authorized.triggered) {
+                    transaction->authorized.triggered = true;
+                    txUpdated = true;
+                    triggerReason = TransactionEventTriggerReason::Authorized;
+                } else if (!transaction->isAuthorized && transaction->authorized.triggered) {
+                    transaction->authorized.triggered = false;
+                    txUpdated = true;
+                    triggerReason = TransactionEventTriggerReason::StopAuthorized;
+                } else if (evReadyInput && evReadyInput() && !transaction->powerPathClosed.triggered) {
+                    transaction->powerPathClosed.triggered = true;
+                } else if (evReadyInput && !evReadyInput() && transaction->powerPathClosed.triggered) {
+                    transaction->powerPathClosed.triggered = false;
                 }
             }
-        }
-    }
 
-    if (txStarted) {
-       transaction->evConnected.triggered |= connectorPluggedInput && connectorPluggedInput();
-       transaction->powerPathClosed.triggered |= evseReadyInput && evseReadyInput();
-       transaction->authorized.triggered |= authorization.get() != nullptr;
-    }
+            if (txUpdated) {
+                // yes, updated
 
-    TransactionEventData::ChargingState chargingState = TransactionEventData::ChargingState::Idle;
-    if (transaction) {
-        chargingState = TransactionEventData::ChargingState::Charging;
+                txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
+                if (!txEvent) {
+                    // OOM
+                    return;
+                }
 
-        if (connectorPluggedInput && !connectorPluggedInput()) {
-            chargingState = TransactionEventData::ChargingState::Idle;
-        } else if (!authorization.get()) {
-            chargingState = TransactionEventData::ChargingState::EVConnected;
-        } else if (evseReadyInput && !evseReadyInput()) { 
-            chargingState = TransactionEventData::ChargingState::SuspendedEVSE;
-        } else if (evReadyInput && !evReadyInput()) {
-            chargingState = TransactionEventData::ChargingState::SuspendedEV;
-        } else {
-            chargingState = TransactionEventData::ChargingState::Charging;
+                txEvent->eventType = TransactionEventData::Type::Updated;
+            }
         }
     }
 
-    if (txStarted && txStopped) {
-        MO_DBG_ERR("tx started and stopped");
-        transaction.reset();
-        return;
-    } else if (txStarted || txStopped || txUpdated) {
-        auto txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
-        if (!txEvent) {
-            // OOM
-            transaction->active = false;
-            return;
-        }
-
-        txEvent->eventType = txStarted ? TransactionEventData::Type::Started :
-                             txStopped ? TransactionEventData::Type::Ended :
-                                         TransactionEventData::Type::Updated;
-        
+    if (txEvent) {
         txEvent->timestamp = context.getModel().getClock().now();
         txEvent->triggerReason = triggerReason;
-        
-        if (chargingState != trackChargingState) {
-            txEvent->chargingState = chargingState;
-        }
-        trackChargingState = chargingState;
-
-        if (txStopped) {
-            txEvent->stoppedReason = stoppedReason;
-        }
-
-        if (authorization.get() && !transaction->idTokenTransmitted) {
-            txEvent->transaction->idToken = authorization;
-            txEvent->idTokenTransmit = true;
-            transaction->idTokenTransmitted = true;
-        }
-
+        txEvent->chargingState = chargingState;
         txEvent->evse = evseId;
-
         // meterValue not supported
 
+        if (!transaction->stopIdTokenTransmitted && transaction->stopIdToken) {
+            txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(*transaction->stopIdToken.get()));
+        }  else if (!transaction->idTokenTransmitted) {
+            txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(transaction->idToken));
+        }
+    }
+
+    if (txEvent) {
         auto txEventRequest = makeRequest(new Ocpp201::TransactionEvent(context.getModel(), txEvent));
         txEventRequest->setTimeout(0);
         context.initiateRequest(std::move(txEventRequest));
 
-        if (txStopped) {
+        if (!transaction->stopIdTokenTransmitted && transaction->stopIdToken) {
+            transaction->stopIdTokenTransmitted = true;
+        }  else if (!transaction->idTokenTransmitted) {
+            transaction->idTokenTransmitted = true;
+        }
+
+        if (txEvent->eventType == TransactionEventData::Type::Ended) {
+            transaction->stopped = true;
+            transaction->active = false;
             MO_DBG_DEBUG("drop completed transaction");
             transaction.reset();
+        } else if (txEvent->eventType == TransactionEventData::Type::Started) {
+            transaction->started = true;
+            transaction->evConnected.triggered = connectorPluggedInput && connectorPluggedInput();
+            transaction->powerPathClosed.triggered = evReadyInput && evReadyInput();
+            transaction->authorized.triggered = (transaction && transaction->isAuthorized);
         }
     }
 }
@@ -228,39 +282,121 @@ void TransactionService::Evse::setEvseReadyInput(std::function<bool()> connector
 
 bool TransactionService::Evse::beginAuthorization(IdToken idToken) {
     MO_DBG_DEBUG("begin auth: %s", idToken.get());
-    auto authorize = makeRequest(new Ocpp16::CustomOperation(
-            "Authorize",
-            [idToken] () {
-                auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                        JSON_OBJECT_SIZE(3) +
-                        JSON_OBJECT_SIZE(2) +
-                        MO_IDTOKEN_LEN_MAX + 1));
-                auto payload = doc->to<JsonObject>();
-                payload["idToken"]["idToken"] = idToken.get();
-                payload["idToken"]["type"] = idToken.getTypeCstr();
-                return doc;
-            }, [this, idToken] (JsonObject response) {
-                if (!strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
-                    authorization = idToken;
-                    if (transaction) {
-                        transaction->idTokenTransmitted = false;
-                    }
-                    MO_DBG_DEBUG("confirmed auth: %s", idToken.get());
-                }
-            }));
+
+    MO_DBG_DEBUG("patch idTokenType KeyCode for OCTT");
+    idToken = IdToken(idToken.get(), IdToken::Type::KeyCode);
+
+    if (transaction && transaction->idToken.get()) {
+        MO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
+        return false;
+    }
+
+    if (!transaction) {
+        transaction = allocateTransaction();
+        if (!transaction) {
+            MO_DBG_ERR("could not allocate Tx");
+            return false;
+        }
+    }
+
+    transaction->idToken = idToken;
+    transaction->beginTimestamp = context.getModel().getClock().now();
+
+    auto tx = transaction;
+
+    auto authorize = makeRequest(new Authorize(context.getModel(), idToken));
+    if (!authorize) {
+        // OOM
+        return false;
+    }
+
+    authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
+        if (strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
+            MO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->idToken.get());
+            tx->isDeauthorized = true;
+            return;
+        }
+
+        MO_DBG_DEBUG("Authorized transaction process (%s)", tx->idToken.get());
+        tx->isAuthorized = true;
+        tx->idTokenTransmitted = false;
+    });
+    authorize->setTimeout(20 * 1000);
     context.initiateRequest(std::move(authorize));
     return true;
 }
 bool TransactionService::Evse::endAuthorization(IdToken idToken) {
-    MO_DBG_DEBUG("end auth: %s", idToken.get()? idToken.get() : "(empty)");
-    authorization = IdToken();
-    if (transaction) {
+
+    if (!transaction || !transaction->active) {
+        //transaction already ended / not active anymore
+        return false;
+    }
+
+    MO_DBG_DEBUG("End session started by idTag %s",
+                            transaction->idToken.get());
+    
+    if (transaction->idToken.equals(idToken)) {
+        // use same idToken like tx start
+        transaction->isAuthorized = false;
         transaction->idTokenTransmitted = false;
+    } else {
+        // use a different idToken for stopping the tx
+
+        auto tx = transaction;
+
+        auto authorize = makeRequest(new Authorize(context.getModel(), idToken));
+        if (!authorize) {
+            // OOM
+            abortTransaction();
+            return false;
+        }
+
+        authorize->setOnReceiveConfListener([tx, idToken] (JsonObject response) {
+            if (strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
+                MO_DBG_DEBUG("Authorize rejected (%s), don't stop tx", idToken.get());
+                return;
+            }
+
+            MO_DBG_DEBUG("Authorized transaction stop (%s)", idToken.get());
+
+            tx->stopIdToken = std::unique_ptr<IdToken>(new IdToken(idToken));
+            if (!tx->stopIdToken) {
+                // OOM
+                if (tx->active) {
+                    tx->active = false;
+                    tx->stopTrigger = TransactionEventTriggerReason::AbnormalCondition;
+                    tx->stopReason = Ocpp201::Transaction::StopReason::Other;
+                }
+                return;
+            }
+
+            tx->isAuthorized = false;
+            tx->stopIdTokenTransmitted = false;
+        });
+        authorize->setTimeout(20 * 1000);
+        context.initiateRequest(std::move(authorize));
     }
+
+    return true;
+}
+bool TransactionService::Evse::abortTransaction(Ocpp201::Transaction::StopReason stopReason, TransactionEventTriggerReason stopTrigger) {
+
+    if (!transaction || !transaction->active) {
+        //transaction already ended / not active anymore
+        return false;
+    }
+
+    MO_DBG_DEBUG("Abort session started by idTag %s",
+                            transaction->idToken.get());
+
+    transaction->active = false;
+    transaction->stopTrigger = stopTrigger;
+    transaction->stopReason = stopReason;
+
     return true;
 }
-const char *TransactionService::Evse::getAuthorization() {
-    return authorization.get();
+const std::shared_ptr<MicroOcpp::Ocpp201::Transaction>& TransactionService::Evse::getTransaction() {
+    return transaction;
 }
 
 bool TransactionService::isTxStartPoint(TxStartStopPoint check) {
@@ -329,8 +465,11 @@ bool TransactionService::parseTxStartStopPoint(const char *csl, std::vector<TxSt
 TransactionService::TransactionService(Context& context) : context(context) {
     auto variableService = context.getModel().getVariableService();
 
-    TxStartPointString = variableService->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "PowerPathClosed");
-    TxStopPointString  = variableService->declareVariable<const char*>("TxCtrlr", "TxStopPoint",  "Authorized,EVConnected");
+    txStartPointString = variableService->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "PowerPathClosed");
+    txStopPointString  = variableService->declareVariable<const char*>("TxCtrlr", "TxStopPoint",  "EVConnected");
+    stopTxOnInvalidIdBool = variableService->declareVariable<bool>("TxCtrlr", "StopTxOnInvalidId", true);
+    stopTxOnEVSideDisconnectBool = variableService->declareVariable<bool>("TxCtrlr", "StopTxOnEVSideDisconnect", true);
+    evConnectionTimeOutInt = variableService->declareVariable<int>("TxCtrlr", "EVConnectionTimeOut", 30);
 
     variableService->registerValidator<const char*>("TxCtrlr", "TxStartPoint", [this] (const char *value) -> bool {
         std::vector<TxStartStopPoint> validated;
@@ -352,12 +491,12 @@ void TransactionService::loop() {
         evse.loop();
     }
 
-    if (TxStartPointString->getWriteCount() != trackTxStartPoint) {
-        parseTxStartStopPoint(TxStartPointString->getString(), txStartPointParsed);
+    if (txStartPointString->getWriteCount() != trackTxStartPoint) {
+        parseTxStartStopPoint(txStartPointString->getString(), txStartPointParsed);
     }
 
-    if (TxStopPointString->getWriteCount() != trackTxStopPoint) {
-        parseTxStartStopPoint(TxStopPointString->getString(), txStopPointParsed);
+    if (txStopPointString->getWriteCount() != trackTxStopPoint) {
+        parseTxStartStopPoint(txStopPointString->getString(), txStopPointParsed);
     }
 }
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.h b/src/MicroOcpp/Model/Transactions/TransactionService.h
index 6e39981e..4fb7c1a2 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.h
@@ -39,8 +39,6 @@ class TransactionService {
         std::function<bool()> evReadyInput;
         std::function<bool()> evseReadyInput;
 
-        IdToken authorization;
-
         std::unique_ptr<Ocpp201::Transaction> allocateTransaction();
     public:
         Evse(Context& context, TransactionService& txService, unsigned int evseId);
@@ -51,9 +49,13 @@ class TransactionService {
         void setEvReadyInput(std::function<bool()> evRequestsEnergy);
         void setEvseReadyInput(std::function<bool()> connectorEnergized);
 
-        bool beginAuthorization(IdToken idToken);
-        bool endAuthorization(IdToken idToken = IdToken());
-        const char *getAuthorization();
+        bool beginAuthorization(IdToken idToken); // authorize by swipe RFID
+        bool endAuthorization(IdToken idToken = IdToken()); // stop authorization by swipe RFID
+
+        // stop transaction, but neither upon user request nor OCPP server request (e.g. after PowerLoss)
+        bool abortTransaction(Ocpp201::Transaction::StopReason stopReason = Ocpp201::Transaction::StopReason::Other, Ocpp201::TransactionEventTriggerReason stopTrigger = Ocpp201::TransactionEventTriggerReason::AbnormalCondition);
+
+        const std::shared_ptr<Ocpp201::Transaction>& getTransaction();
     };
 
     friend Evse;
@@ -73,8 +75,11 @@ class TransactionService {
     Context& context;
     std::vector<Evse> evses;
 
-    Variable *TxStartPointString = nullptr;
-    Variable *TxStopPointString = nullptr;
+    Variable *txStartPointString = nullptr;
+    Variable *txStopPointString = nullptr;
+    Variable *stopTxOnInvalidIdBool = nullptr;
+    Variable *stopTxOnEVSideDisconnectBool = nullptr;
+    Variable *evConnectionTimeOutInt = nullptr;
     uint16_t trackTxStartPoint = -1;
     uint16_t trackTxStopPoint = -1;
     std::vector<TxStartStopPoint> txStartPointParsed;
diff --git a/src/MicroOcpp/Operations/Authorize.cpp b/src/MicroOcpp/Operations/Authorize.cpp
index 3528f04c..28289773 100644
--- a/src/MicroOcpp/Operations/Authorize.cpp
+++ b/src/MicroOcpp/Operations/Authorize.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/Authorize.h>
@@ -8,7 +8,10 @@
 
 #include <MicroOcpp/Debug.h>
 
-using MicroOcpp::Ocpp16::Authorize;
+using namespace MicroOcpp;
+
+namespace MicroOcpp {
+namespace Ocpp16 {
 
 Authorize::Authorize(Model& model, const char *idTagIn) : model(model) {
     if (idTagIn && strnlen(idTagIn, IDTAG_LEN_MAX + 2) <= IDTAG_LEN_MAX) {
@@ -57,3 +60,62 @@ std::unique_ptr<DynamicJsonDocument> Authorize::createConf(){
     idTagInfo["status"] = "Accepted";
     return doc;
 }
+
+} // namespace Ocpp16
+} // namespace MicroOcpp
+
+#if MO_ENABLE_V201
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+Authorize::Authorize(Model& model, const IdToken& idToken) : model(model) {
+    this->idToken = idToken;
+}
+
+const char* Authorize::getOperationType(){
+    return "Authorize";
+}
+
+std::unique_ptr<DynamicJsonDocument> Authorize::createReq() {
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+            JSON_OBJECT_SIZE(1) +
+            JSON_OBJECT_SIZE(2)));
+    JsonObject payload = doc->to<JsonObject>();
+    payload["idToken"]["idToken"] = idToken.get();
+    payload["idToken"]["type"] = idToken.getTypeCstr();
+    return doc;
+}
+
+void Authorize::processConf(JsonObject payload){
+    const char *idTagInfo = payload["idTokenInfo"]["status"] | "_Undefined";
+
+    if (!strcmp(idTagInfo, "Accepted")) {
+        MO_DBG_INFO("Request has been accepted");
+    } else {
+        MO_DBG_INFO("Request has been denied. Reason: %s", idTagInfo);
+    }
+
+    //if (model.getAuthorizationService()) {
+    //    model.getAuthorizationService()->notifyAuthorization(idTag, payload["idTagInfo"]);
+    //}
+}
+
+void Authorize::processReq(JsonObject payload){
+    /*
+     * Ignore Contents of this Req-message, because this is for debug purposes only
+     */
+}
+
+std::unique_ptr<DynamicJsonDocument> Authorize::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+    JsonObject idTagInfo = payload.createNestedObject("idTokenInfo");
+    idTagInfo["status"] = "Accepted";
+    return doc;
+}
+
+} // namespace Ocpp201
+} // namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/Authorize.h b/src/MicroOcpp/Operations/Authorize.h
index 7f070e6c..0bd9f2eb 100644
--- a/src/MicroOcpp/Operations/Authorize.h
+++ b/src/MicroOcpp/Operations/Authorize.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef AUTHORIZE_H
@@ -7,6 +7,7 @@
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Operations/CiStrings.h>
+#include <MicroOcpp/Version.h>
 
 namespace MicroOcpp {
 
@@ -36,4 +37,35 @@ class Authorize : public Operation {
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
 
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Authorization/IdToken.h>
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+class Authorize : public Operation {
+private:
+    Model& model;
+    IdToken idToken;
+public:
+    Authorize(Model& model, const IdToken& idToken);
+
+    const char* getOperationType() override;
+
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
+
+    void processConf(JsonObject payload) override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+};
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
 #endif
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
index e221c8b0..929ce802 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.cpp
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -53,67 +53,67 @@ std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
 
     const char *triggerReason = "";
     switch(txEvent->triggerReason) {
-        case TransactionEventData::TriggerReason::Authorized:
+        case TransactionEventTriggerReason::Authorized:
             triggerReason = "Authorized";
             break;
-        case TransactionEventData::TriggerReason::CablePluggedIn:
+        case TransactionEventTriggerReason::CablePluggedIn:
             triggerReason = "CablePluggedIn";
             break;
-        case TransactionEventData::TriggerReason::ChargingRateChanged:
+        case TransactionEventTriggerReason::ChargingRateChanged:
             triggerReason = "ChargingRateChanged";
             break;
-        case TransactionEventData::TriggerReason::ChargingStateChanged:
+        case TransactionEventTriggerReason::ChargingStateChanged:
             triggerReason = "ChargingStateChanged";
             break;
-        case TransactionEventData::TriggerReason::Deauthorized:
+        case TransactionEventTriggerReason::Deauthorized:
             triggerReason = "Deauthorized";
             break;
-        case TransactionEventData::TriggerReason::EnergyLimitReached:
+        case TransactionEventTriggerReason::EnergyLimitReached:
             triggerReason = "EnergyLimitReached";
             break;
-        case TransactionEventData::TriggerReason::EVCommunicationLost:
+        case TransactionEventTriggerReason::EVCommunicationLost:
             triggerReason = "EVCommunicationLost";
             break;
-        case TransactionEventData::TriggerReason::EVConnectTimeout:
+        case TransactionEventTriggerReason::EVConnectTimeout:
             triggerReason = "EVConnectTimeout";
             break;
-        case TransactionEventData::TriggerReason::MeterValueClock:
+        case TransactionEventTriggerReason::MeterValueClock:
             triggerReason = "MeterValueClock";
             break;
-        case TransactionEventData::TriggerReason::MeterValuePeriodic:
+        case TransactionEventTriggerReason::MeterValuePeriodic:
             triggerReason = "MeterValuePeriodic";
             break;
-        case TransactionEventData::TriggerReason::TimeLimitReached:
+        case TransactionEventTriggerReason::TimeLimitReached:
             triggerReason = "TimeLimitReached";
             break;
-        case TransactionEventData::TriggerReason::Trigger:
+        case TransactionEventTriggerReason::Trigger:
             triggerReason = "Trigger";
             break;
-        case TransactionEventData::TriggerReason::UnlockCommand:
+        case TransactionEventTriggerReason::UnlockCommand:
             triggerReason = "UnlockCommand";
             break;
-        case TransactionEventData::TriggerReason::StopAuthorized:
+        case TransactionEventTriggerReason::StopAuthorized:
             triggerReason = "StopAuthorized";
             break;
-        case TransactionEventData::TriggerReason::EVDeparted:
+        case TransactionEventTriggerReason::EVDeparted:
             triggerReason = "EVDeparted";
             break;
-        case TransactionEventData::TriggerReason::EVDetected:
+        case TransactionEventTriggerReason::EVDetected:
             triggerReason = "EVDetected";
             break;
-        case TransactionEventData::TriggerReason::RemoteStop:
+        case TransactionEventTriggerReason::RemoteStop:
             triggerReason = "RemoteStop";
             break;
-        case TransactionEventData::TriggerReason::RemoteStart:
+        case TransactionEventTriggerReason::RemoteStart:
             triggerReason = "RemoteStart";
             break;
-        case TransactionEventData::TriggerReason::AbnormalCondition:
+        case TransactionEventTriggerReason::AbnormalCondition:
             triggerReason = "AbnormalCondition";
             break;
-        case TransactionEventData::TriggerReason::SignedDataReceived:
+        case TransactionEventTriggerReason::SignedDataReceived:
             triggerReason = "SignedDataReceived";
             break;
-        case TransactionEventData::TriggerReason::ResetCommand:
+        case TransactionEventTriggerReason::ResetCommand:
             triggerReason = "ResetCommand";
             break;
     }
@@ -164,59 +164,59 @@ std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
     }
 
     const char *stoppedReason = nullptr;
-    switch (txEvent->stoppedReason) {
-        case TransactionEventData::StopReason::DeAuthorized: 
+    switch (txEvent->transaction->stopReason) {
+        case Transaction::StopReason::DeAuthorized: 
             stoppedReason = "DeAuthorized"; 
             break;
-        case TransactionEventData::StopReason::EmergencyStop: 
+        case Transaction::StopReason::EmergencyStop: 
             stoppedReason = "EmergencyStop"; 
             break;
-        case TransactionEventData::StopReason::EnergyLimitReached: 
+        case Transaction::StopReason::EnergyLimitReached: 
             stoppedReason = "EnergyLimitReached";
             break;
-        case TransactionEventData::StopReason::EVDisconnected: 
+        case Transaction::StopReason::EVDisconnected: 
             stoppedReason = "EVDisconnected";
             break;
-        case TransactionEventData::StopReason::GroundFault: 
+        case Transaction::StopReason::GroundFault: 
             stoppedReason = "GroundFault";
             break;
-        case TransactionEventData::StopReason::ImmediateReset:
+        case Transaction::StopReason::ImmediateReset:
             stoppedReason = "ImmediateReset";
             break;
-        case TransactionEventData::StopReason::LocalOutOfCredit:
+        case Transaction::StopReason::LocalOutOfCredit:
             stoppedReason = "LocalOutOfCredit";
             break;
-        case TransactionEventData::StopReason::MasterPass:
+        case Transaction::StopReason::MasterPass:
             stoppedReason = "MasterPass";
             break;
-        case TransactionEventData::StopReason::Other:
+        case Transaction::StopReason::Other:
             stoppedReason = "Other";
             break;
-        case TransactionEventData::StopReason::OvercurrentFault:
+        case Transaction::StopReason::OvercurrentFault:
             stoppedReason = "OvercurrentFault";
             break;
-        case TransactionEventData::StopReason::PowerLoss:
+        case Transaction::StopReason::PowerLoss:
             stoppedReason = "PowerLoss";
             break;
-        case TransactionEventData::StopReason::PowerQuality:
+        case Transaction::StopReason::PowerQuality:
             stoppedReason = "PowerQuality";
             break;
-        case TransactionEventData::StopReason::Reboot:
+        case Transaction::StopReason::Reboot:
             stoppedReason = "Reboot";
             break;
-        case TransactionEventData::StopReason::Remote:
+        case Transaction::StopReason::Remote:
             stoppedReason = "Remote";
             break;
-        case TransactionEventData::StopReason::SOCLimitReached:
+        case Transaction::StopReason::SOCLimitReached:
             stoppedReason = "SOCLimitReached";
             break;
-        case TransactionEventData::StopReason::StoppedByEV:
+        case Transaction::StopReason::StoppedByEV:
             stoppedReason = "StoppedByEV";
             break;
-        case TransactionEventData::StopReason::TimeLimitReached:
+        case Transaction::StopReason::TimeLimitReached:
             stoppedReason = "TimeLimitReached";
             break;
-        case TransactionEventData::StopReason::Timeout:
+        case Transaction::StopReason::Timeout:
             stoppedReason = "Timeout";
             break;
     }
@@ -228,10 +228,10 @@ std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
         payload["remoteStartId"] = txEvent->transaction->remoteStartId;
     }
 
-    if (txEvent->idTokenTransmit) {
+    if (txEvent->idToken) {
         JsonObject idToken = payload.createNestedObject("idToken");
-        idToken["idToken"] = txEvent->transaction->idToken.get();
-        idToken["type"] = txEvent->transaction->idToken.getTypeCstr();
+        idToken["idToken"] = txEvent->idToken->get();
+        idToken["type"] = txEvent->idToken->getTypeCstr();
     }
 
     if (txEvent->evse.id >= 0) {
@@ -258,4 +258,14 @@ void TransactionEvent::processConf(JsonObject payload) {
     }
 }
 
+void TransactionEvent::processReq(JsonObject payload) {
+    /**
+     * Ignore Contents of this Req-message, because this is for debug purposes only
+     */
+}
+
+std::unique_ptr<DynamicJsonDocument> TransactionEvent::createConf() {
+    return createEmptyDocument();
+}
+
 #endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/TransactionEvent.h b/src/MicroOcpp/Operations/TransactionEvent.h
index 04d34c0a..5bfe041f 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.h
+++ b/src/MicroOcpp/Operations/TransactionEvent.h
@@ -24,7 +24,7 @@ class TransactionEvent : public Operation {
     Model& model;
     std::shared_ptr<TransactionEventData> txEvent;
 
-    const char *errorCode;
+    const char *errorCode = nullptr;
 public:
 
     TransactionEvent(Model& model, std::shared_ptr<TransactionEventData> txEvent);
@@ -36,6 +36,10 @@ class TransactionEvent : public Operation {
     void processConf(JsonObject payload) override;
 
     const char *getErrorCode() override {return errorCode;}
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
 };
 
 } //end namespace Ocpp201
diff --git a/tests/Transactions.cpp b/tests/Transactions.cpp
index edc0456c..8bd88d30 100644
--- a/tests/Transactions.cpp
+++ b/tests/Transactions.cpp
@@ -52,6 +52,8 @@ TEST_CASE( "Transactions" ) {
 
     SECTION("Basic transaction") {
 
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
         MO_DBG_DEBUG("plug EV");
         setConnectorPluggedInput([] () {return true;});
 
@@ -72,6 +74,9 @@ TEST_CASE( "Transactions" ) {
 
         loop();
 
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction()->started );
+        REQUIRE( !context->getModel().getTransactionService()->getEvse(1)->getTransaction()->stopped );
+
         MO_DBG_DEBUG("EV idle");
         setEvReadyInput([] () {return false;});
 
@@ -91,6 +96,9 @@ TEST_CASE( "Transactions" ) {
         setConnectorPluggedInput([] () {return false;});
 
         loop();
+
+        REQUIRE( (context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr || 
+                  context->getModel().getTransactionService()->getEvse(1)->getTransaction()->stopped));
     }
 
     mocpp_deinitialize();

From 8b584cfe63b0f8cefdfe896b1e3911ac3a763d40 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 3 Mar 2024 19:30:45 +0100
Subject: [PATCH 444/549] fix version number

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 53f11eb8..670750e8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,7 +17,7 @@
 
 - Make field localAuthorizationList in SendLocalList optional
 
-## [1.1.0] - 2024-02-27
+## [1.0.1] - 2024-02-27
 
 ### Fixed
 

From b5f37233671f2aa0d3883d78246c3183dd205706 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 9 Mar 2024 16:41:52 +0100
Subject: [PATCH 445/549] add filesystem index structure (#270)

---
 CMakeLists.txt                           |   1 +
 src/MicroOcpp/Core/FilesystemAdapter.cpp | 243 +++++++++++++++++++++++
 src/MicroOcpp/Core/FilesystemAdapter.h   |   4 +
 src/MicroOcpp/Core/FilesystemUtils.cpp   |  11 +-
 4 files changed, 257 insertions(+), 2 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index f617af66..524f77f0 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -180,6 +180,7 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_FILENAME_PREFIX="./mo_store/"
     MO_LocalAuthListMaxLength=8
     MO_SendLocalListMaxLength=4
+    MO_ENABLE_FILE_INDEX=1
     #MO_ENABLE_MBEDTLS=1
 )
 
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 2d65e778..c173b797 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -14,10 +14,238 @@
  *     - Arduino SPIFFS
  *     - ESP-IDF SPIFFS
  *     - POSIX-like API (tested on Ubuntu 20.04)
+ * Plus a filesystem index decorator working with any of the above
  * 
  * You can add support for other file systems by passing a custom adapter to mocpp_initialize(...)
  */
 
+#if MO_ENABLE_FILE_INDEX
+
+#include <vector>
+#include <algorithm>
+#include <string>
+
+namespace MicroOcpp {
+
+class FilesystemAdapterIndex;
+
+class IndexedFileAdapter : public FileAdapter {
+private:
+    FilesystemAdapterIndex& index;
+    char fn [MO_MAX_PATH_SIZE];
+    std::unique_ptr<FileAdapter> file;
+
+    size_t written = 0;
+public:
+    IndexedFileAdapter(FilesystemAdapterIndex& index, const char *fn, std::unique_ptr<FileAdapter> file)
+            : index(index), file(std::move(file)) {
+        snprintf(this->fn, sizeof(this->fn), "%s", fn);
+    }
+
+    ~IndexedFileAdapter(); // destructor updates file index with written size
+
+    size_t read(char *buf, size_t len) override {
+        return file->read(buf, len);
+    }
+
+    size_t write(const char *buf, size_t len) override {
+        auto ret = file->write(buf, len);
+        written += ret;
+        return ret;
+    }
+
+    size_t seek(size_t offset) override {
+        auto ret = file->seek(offset);
+        written = ret;
+        return ret;
+    }
+
+    int read() override {
+        return file->read();
+    }
+};
+
+class FilesystemAdapterIndex : public FilesystemAdapter {
+private:
+    std::shared_ptr<FilesystemAdapter> filesystem;
+
+    struct IndexEntry {
+        std::string fname;
+        size_t size;
+
+        IndexEntry(const char *fname, size_t size) : fname(fname), size(size) { }
+    };
+
+    std::vector<IndexEntry> index;
+
+    IndexEntry *getEntryByFname(const char *fn) {
+        auto entry = std::find_if(index.begin(), index.end(),
+            [fn] (const IndexEntry& el) -> bool {
+                return el.fname.compare(fn) == 0;
+            });
+
+        if (entry != index.end()) {
+            return &(*entry);
+        } else {
+            return nullptr;
+        }
+    }
+
+    IndexEntry *getEntryByPath(const char *path) {
+        if (strlen(path) < sizeof(MO_FILENAME_PREFIX) - 1) {
+            MO_DBG_ERR("invalid fn");
+            return nullptr;
+        }
+
+        const char *fn = path + sizeof(MO_FILENAME_PREFIX) - 1;
+        return getEntryByFname(fn);
+    }
+public:
+    FilesystemAdapterIndex(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(std::move(filesystem)) { }
+
+    ~FilesystemAdapterIndex() = default;
+
+    int stat(const char *path, size_t *size) override {
+        if (auto file = getEntryByPath(path)) {
+            *size = file->size;
+            return 0;
+        } else {
+            return -1;
+        }
+    }
+
+    std::unique_ptr<FileAdapter> open(const char *path, const char *mode) {
+        if (!strcmp(mode, "r")) {
+            return filesystem->open(path, "r");
+        } else if (!strcmp(mode, "w")) {
+
+            if (strlen(path) < sizeof(MO_FILENAME_PREFIX) - 1) {
+                MO_DBG_ERR("invalid fn");
+                return nullptr;
+            }
+
+            const char *fn = path + sizeof(MO_FILENAME_PREFIX) - 1;
+
+            auto file = filesystem->open(path, "w");
+            if (!file) {
+                return nullptr;
+            }
+
+            IndexEntry *entry = nullptr;
+            if (!(entry = getEntryByFname(fn))) {
+                index.emplace_back(fn, 0);
+                entry = &index.back();
+            }
+
+            if (!entry) {
+                MO_DBG_ERR("internal error");
+                return nullptr;
+            }
+
+            entry->size = 0; //write always empties the file
+
+            return std::unique_ptr<IndexedFileAdapter>(new IndexedFileAdapter(*this, entry->fname.c_str(), std::move(file)));
+        } else {
+            MO_DBG_ERR("only support r or w");
+            return nullptr;
+        }
+    }
+
+    bool remove(const char *path) override {
+        if (strlen(path) >= sizeof(MO_FILENAME_PREFIX) - 1) {
+            //valid path
+            const char *fn = path + sizeof(MO_FILENAME_PREFIX) - 1;
+            index.erase(std::remove_if(index.begin(), index.end(),
+                [fn] (const IndexEntry& el) -> bool {
+                    return el.fname.compare(fn) == 0;
+                }), index.end());
+        }
+
+        return filesystem->remove(path);
+    }
+
+    int ftw_root(std::function<int(const char *fpath)> fn) {
+        // allow fn to remove elements
+        for (size_t it = 0; it < index.size();) {
+            auto size_before = index.size();
+            auto err = fn(index[it].fname.c_str());
+            if (err) {
+                return err;
+            }
+            if (index.size() + 1 == size_before) {
+                // element removed
+                continue;
+            }
+            // normal execution
+            it++;
+        }
+
+        return 0;
+    }
+
+    bool createIndex() {
+        if (!index.empty()) {
+            return false;
+        }
+        auto ret = filesystem->ftw_root([this] (const char *fn) -> int {
+            int ret;
+            char path [MO_MAX_PATH_SIZE];
+
+            ret = snprintf(path, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "%s", fn);
+            if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+                MO_DBG_ERR("fn error: %i", ret);
+                return 0; //ignore this entry and continue ftw
+            }
+
+            size_t size;
+            ret = filesystem->stat(path, &size);
+            if (ret == 0) {
+                //add fn and size to index
+                MO_DBG_DEBUG("add file to index: %s (%zuB)", fn, size);
+                index.emplace_back(fn, size);
+                return 0; //successfully added filename to index
+            } else {
+                MO_DBG_ERR("unexpected entry: %s", fn);
+                return 0; //ignore this entry and continue ftw
+            }
+        });
+
+        MO_DBG_DEBUG("create fs index: %s, %zu entries", ret == 0 ? "success" : "failure", index.size());
+
+        return ret == 0;
+    }
+
+    void updateFilesize(const char *fn, size_t size) {
+        if (auto entry = getEntryByFname(fn)) {
+            entry->size = size;
+            MO_DBG_DEBUG("update index: %s (%zuB)", entry->fname.c_str(), entry->size);
+        }
+    }
+};
+
+IndexedFileAdapter::~IndexedFileAdapter() {
+    index.updateFilesize(fn, written);
+}
+
+std::shared_ptr<FilesystemAdapter> decorateIndex(std::shared_ptr<FilesystemAdapter> filesystem) {
+
+    auto fsIndex = std::make_shared<FilesystemAdapterIndex>(std::move(filesystem));
+    if (!fsIndex) {
+        MO_DBG_ERR("OOM");
+        return nullptr;
+    }
+
+    if (!fsIndex->createIndex()) {
+        MO_DBG_ERR("createIndex err");
+        return nullptr;
+    }
+
+    return fsIndex;
+}
+
+} // namespace MicroOcpp
+
+#endif //MO_ENABLE_FILE_INDEX
 
 #if MO_USE_FILEAPI == ARDUINO_LITTLEFS || MO_USE_FILEAPI == ARDUINO_SPIFFS
 
@@ -212,6 +440,11 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
     auto fs_concrete = new ArduinoFilesystemAdapter(config);
     auto fs = std::shared_ptr<FilesystemAdapter>(fs_concrete);
+
+#if MO_ENABLE_FILE_INDEX
+    fs = decorateIndex(fs);
+#endif // MO_ENABLE_FILE_INDEX
+
     filesystemCache = fs;
 
     if (*fs_concrete) {
@@ -388,6 +621,11 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
     if (mounted) {
         auto fs = std::shared_ptr<FilesystemAdapter>(new EspIdfFilesystemAdapter(config));
+
+#if MO_ENABLE_FILE_INDEX
+        fs = decorateIndex(fs);
+#endif // MO_ENABLE_FILE_INDEX
+
         filesystemCache = fs;
         return fs;
     } else {
@@ -500,6 +738,11 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     auto fs = std::shared_ptr<FilesystemAdapter>(new PosixFilesystemAdapter(config));
+
+#if MO_ENABLE_FILE_INDEX
+    fs = decorateIndex(fs);
+#endif // MO_ENABLE_FILE_INDEX
+
     filesystemCache = fs;
     return fs;
 }
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.h b/src/MicroOcpp/Core/FilesystemAdapter.h
index 3cb6c70c..2dc4eb2a 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.h
+++ b/src/MicroOcpp/Core/FilesystemAdapter.h
@@ -51,6 +51,10 @@
 #endif
 #endif
 
+#ifndef MO_ENABLE_FILE_INDEX
+#define MO_ENABLE_FILE_INDEX 0
+#endif
+
 namespace MicroOcpp {
 
 class FileAdapter {
diff --git a/src/MicroOcpp/Core/FilesystemUtils.cpp b/src/MicroOcpp/Core/FilesystemUtils.cpp
index 22f85863..ea0bc9d8 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.cpp
+++ b/src/MicroOcpp/Core/FilesystemUtils.cpp
@@ -116,7 +116,7 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
 }
 
 bool FilesystemUtils::remove_if(std::shared_ptr<FilesystemAdapter> filesystem, std::function<bool(const char*)> pred) {
-    return filesystem->ftw_root([filesystem, pred] (const char *fpath) {
+    auto ret = filesystem->ftw_root([filesystem, pred] (const char *fpath) {
         if (pred(fpath) && fpath[0] != '.') {
 
             char fn [MO_MAX_PATH_SIZE] = {'\0'};
@@ -130,5 +130,12 @@ bool FilesystemUtils::remove_if(std::shared_ptr<FilesystemAdapter> filesystem, s
             //no error handling - just skip failed file
         }
         return 0;
-    }) == 0;
+    });
+
+    if (ret != 0) {
+        MO_DBG_ERR("ftw_root: %i", ret);
+        (void)0;
+    }
+
+    return ret == 0;
 }

From 150bc18f3b3fb16fc064b62f7adc13c84ae06afa Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 9 Mar 2024 21:00:36 +0100
Subject: [PATCH 446/549] endTransaction checks wrong idTag

---
 src/MicroOcpp.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index c12ac5b6..656734fb 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -437,7 +437,7 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
     bool res = false;
     if (isTransactionActive(connectorId) && getTransactionIdTag(connectorId)) {
         //end transaction now if either idTag is nullptr (i.e. force stop) or the idTag matches beginTransaction
-        if (!idTag || !strcmp(idTag, getTransactionIdTag())) {
+        if (!idTag || !strcmp(idTag, getTransactionIdTag(connectorId))) {
             res = endTransaction_authorized(idTag, reason, connectorId);
         } else {
             MO_DBG_INFO("endTransaction: idTag doesn't match");

From dd53ecc19a78454e073a15ac196ea6929aae36e1 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 9 Mar 2024 21:00:58 +0100
Subject: [PATCH 447/549] update charging profiles when flash disabled

---
 src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index b41b8e48..b3d41e29 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -715,7 +715,8 @@ bool SmartChargingServiceUtils::printProfileFileName(char *out, size_t bufsize,
 bool SmartChargingServiceUtils::storeProfile(std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ChargingProfile *chargingProfile) {
 
     if (!filesystem) {
-        return false;
+        MO_DBG_DEBUG("no filesystem");
+        return true; //not an error
     }
 
     DynamicJsonDocument chargingProfileJson {0};

From 154153908cc59ff3a960a85cebea1b76c0a2eaf2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 9 Mar 2024 21:01:12 +0100
Subject: [PATCH 448/549] ignore UnlockConnector when handler not set

---
 src/MicroOcpp/Operations/UnlockConnector.cpp | 28 +++----
 src/MicroOcpp/Operations/UnlockConnector.h   |  7 +-
 tests/Api.cpp                                | 80 ++++++++++++++++++++
 3 files changed, 99 insertions(+), 16 deletions(-)

diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index a46acf15..aa01ee50 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -25,40 +25,40 @@ void UnlockConnector::processReq(JsonObject payload) {
     auto connector = model.getConnector(connectorId);
 
     if (!connector) {
-        err = true;
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
+
+    unlockConnector = connector->getOnUnlockConnector();
+
+    if (!unlockConnector) {
+        // NotSupported
         return;
     }
 
     connector->endTransaction(nullptr, "UnlockCommand");
     connector->updateTxNotification(TxNotification::RemoteStop);
 
-    unlockConnector = connector->getOnUnlockConnector();
-    if (unlockConnector != nullptr) {
-        cbUnlockResult = unlockConnector();
-    } else {
-        MO_DBG_WARN("Unlock CB undefined");
-    }
+    cbUnlockResult = unlockConnector();
 
     timerStart = mocpp_tick_ms();
 }
 
 std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
-    if (!err && mocpp_tick_ms() - timerStart < MO_UNLOCK_TIMEOUT) {
+    if (unlockConnector && mocpp_tick_ms() - timerStart < MO_UNLOCK_TIMEOUT) {
         //do poll and if more time is needed, delay creation of conf msg
 
-        if (unlockConnector) {
+        if (!cbUnlockResult) {
+            cbUnlockResult = unlockConnector();
             if (!cbUnlockResult) {
-                cbUnlockResult = unlockConnector();
-                if (!cbUnlockResult) {
-                    return nullptr; //no result yet - delay confirmation response
-                }
+                return nullptr; //no result yet - delay confirmation response
             }
         }
     }
 
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    if (err || !unlockConnector) {
+    if (!unlockConnector) {
         payload["status"] = "NotSupported";
     } else if (cbUnlockResult && cbUnlockResult.toValue()) {
         payload["status"] = "Unlocked";
diff --git a/src/MicroOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
index 7489ad03..ac37606d 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.h
+++ b/src/MicroOcpp/Operations/UnlockConnector.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef UNLOCKCONNECTOR_H
@@ -18,10 +18,11 @@ namespace Ocpp16 {
 class UnlockConnector : public Operation {
 private:
     Model& model;
-    bool err = false;
     std::function<PollResult<bool> ()> unlockConnector;
     PollResult<bool> cbUnlockResult;
     unsigned long timerStart = 0; //for timeout
+
+    const char *errorCode = nullptr;
 public:
     UnlockConnector(Model& model);
 
@@ -30,6 +31,8 @@ class UnlockConnector : public Operation {
     void processReq(JsonObject payload) override;
 
     std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
 };
 
 } //end namespace Ocpp16
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 2ca8f468..3bf463a1 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -4,6 +4,7 @@
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
@@ -164,6 +165,85 @@ TEST_CASE( "C++ API test" ) {
         }
 
         REQUIRE(checkpointsPassed);
+
+        // UnlockConnector handler
+        setOnUnlockConnectorInOut(nullptr);
+        setConnectorPluggedInput(nullptr);
+
+        beginTransaction_authorized("abc");
+
+        loop();
+
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = 1;
+                    return doc;
+                },
+                [&checkProcessed] (JsonObject payload) {
+                    //process conf
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "NotSupported") );
+                })));
+        
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( isTransactionRunning() ); // NotSupported doesn't lead to transaction stop
+
+        setOnUnlockConnectorInOut([] () -> MicroOcpp::PollResult<bool> {
+            // connector lock fails
+            return false;
+        });
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = 1;
+                    return doc;
+                },
+                [&checkProcessed] (JsonObject payload) {
+                    //process conf
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "UnlockFailed") );
+                })));
+        
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( !isTransactionRunning() ); // Stop tx when UnlockConnector generally supported
+
+        setOnUnlockConnectorInOut([] () -> MicroOcpp::PollResult<bool> {
+            // connector lock times out
+            return MicroOcpp::PollResult<bool>::Await;
+        });
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = 1;
+                    return doc;
+                },
+                [&checkProcessed] (JsonObject payload) {
+                    //process conf
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "UnlockFailed") );
+                })));
+        
+        loop();
+        mtime += 60000;
+        loop();
+        REQUIRE( checkProcessed );
     }
 
     mocpp_deinitialize();

From fd54b00d65732fe0b3035c521fce88e594ba9996 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 9 Mar 2024 21:01:22 +0100
Subject: [PATCH 449/549] update changelog

---
 CHANGELOG.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 670750e8..30ba3569 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,7 @@
 
 ### Added
 
+- File index ([#270](https://github.com/matth-x/MicroOcpp/pull/270))
 - Operation GetInstalledCertificateIds, UC M03 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation DeleteCertificate, UC M04 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation InstallCertificate, UC M05 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
@@ -15,7 +16,10 @@
 
 ### Fixed
 
+- Fix defect idTag check in `endTransaction`
 - Make field localAuthorizationList in SendLocalList optional
+- Update charging profiles when flash disabled (relates to [#260](https://github.com/matth-x/MicroOcpp/pull/260))
+- Ignore UnlockConnector when handler not set
 
 ## [1.0.1] - 2024-02-27
 

From 68ba3106950e6ecb08d998c20a4f3d6ea63abd73 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 10 Mar 2024 21:10:46 +0100
Subject: [PATCH 450/549] replace PollResult<bool> with enum types

---
 CHANGELOG.md                                  |  4 +
 src/MicroOcpp.cpp                             |  4 +-
 src/MicroOcpp.h                               | 10 ++-
 src/MicroOcpp/Core/PollResult.h               | 51 -----------
 .../Model/ConnectorBase/Connector.cpp         |  4 +-
 src/MicroOcpp/Model/ConnectorBase/Connector.h | 14 +--
 .../ConnectorBase/UnlockConnectorResult.h     | 28 ++++++
 src/MicroOcpp/Operations/ReserveNow.cpp       |  3 +-
 src/MicroOcpp/Operations/Reset.cpp            |  3 +-
 src/MicroOcpp/Operations/UnlockConnector.cpp  | 10 +--
 src/MicroOcpp/Operations/UnlockConnector.h    |  6 +-
 src/MicroOcpp_c.cpp                           | 27 ++----
 src/MicroOcpp_c.h                             | 12 +--
 tests/Api.cpp                                 | 86 +------------------
 tests/ChargingSessions.cpp                    | 81 ++++++++++++++++-
 tests/Configuration.cpp                       |  1 +
 tests/ConfigurationBehavior.cpp               |  1 +
 17 files changed, 159 insertions(+), 186 deletions(-)
 delete mode 100644 src/MicroOcpp/Core/PollResult.h
 create mode 100644 src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 30ba3569..aa12fb20 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+### Changed
+
+- Replace `PollResult<bool>` with enum `UnlockConnectorResult`
+
 ### Added
 
 - File index ([#270](https://github.com/matth-x/MicroOcpp/pull/270))
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 656734fb..1d8915cd 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include "MicroOcpp.h"
@@ -845,7 +845,7 @@ void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcp
     connector->setTxNotificationOutput(notificationOutput);
 }
 
-void setOnUnlockConnectorInOut(std::function<PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId) {
+void setOnUnlockConnectorInOut(std::function<UnlockConnectorResult()> onUnlockConnectorInOut, unsigned int connectorId) {
     if (!context) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 453d8dbe..4e5fa854 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -13,11 +13,11 @@
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/RequestCallbacks.h>
 #include <MicroOcpp/Core/Connection.h>
-#include <MicroOcpp/Core/PollResult.h>
 #include <MicroOcpp/Model/Metering/SampledValue.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
+#include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <MicroOcpp/Version.h>
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 
@@ -305,10 +305,12 @@ void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcp
 /*
  * Set an InputOutput (reads and sets information at the same time) for forcing to unlock the
  * connector. Called as part of the OCPP operation "UnlockConnector"
- * Return values: true on success, false on failure, PollResult::Await if not known yet
- * Continues to call the Cb as long as it returns PollResult::Await
+ * Return values:
+ *     - UnlockConnectorResult::Pending if action needs more time to complete (MO will call this cb again later or eventually timeout)
+ *     - UnlockConnectorResult::Unlocked if successful
+ *     - UnlockConnectorResult::UnlockFailed if not successful (e.g. lock stuck)
  */
-void setOnUnlockConnectorInOut(std::function<MicroOcpp::PollResult<bool>()> onUnlockConnectorInOut, unsigned int connectorId = 1);
+void setOnUnlockConnectorInOut(std::function<UnlockConnectorResult()> onUnlockConnectorInOut, unsigned int connectorId = 1);
 
 /*
  * Access further information about the internal state of the library
diff --git a/src/MicroOcpp/Core/PollResult.h b/src/MicroOcpp/Core/PollResult.h
deleted file mode 100644
index 802f305c..00000000
--- a/src/MicroOcpp/Core/PollResult.h
+++ /dev/null
@@ -1,51 +0,0 @@
-// matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
-// MIT License
-
-#ifndef POLLRESULT_H
-#define POLLRESULT_H
-
-#include <utility>
-#include <MicroOcpp/Debug.h>
-
-namespace MicroOcpp {
-
-template <class T>
-class PollResult {
-private:
-    bool ready;
-    T value;
-public:
-    PollResult() :          ready(false) {}
-    PollResult(T&& value) : ready(true), value(value) {}
-    PollResult(const PollResult<T>&) = delete;
-    PollResult<T>& operator =(const PollResult<T>&) = delete;
-    PollResult<T>& operator =(const PollResult<T>&& other) {
-        ready = other.ready;
-        value = std::move(other.value);
-        return *this;
-    }
-    PollResult(PollResult<T>&& other) : ready(other.ready), value(std::move(other.value)) {}
-    T&& toValue() {
-        if (!ready) {
-            MO_DBG_ERR("Not ready");
-            (void)0;
-        }
-        ready = false;
-        return std::move(value);
-    }
-    T& getValue() const {
-        if (!ready) {
-            MO_DBG_ERR("Not ready");
-            (void)0;
-        }
-        return *value;
-    }
-    operator bool() const {return ready;}
-
-    static PollResult<T> Await() {return PollResult<T>();}
-};
-
-}
-
-#endif
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index af748634..d0ca67c9 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -881,11 +881,11 @@ void Connector::addErrorDataInput(std::function<ErrorData ()> errorDataInput) {
     this->trackErrorDataInputs.push_back(false);
 }
 
-void Connector::setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector) {
+void Connector::setOnUnlockConnector(std::function<UnlockConnectorResult()> unlockConnector) {
     this->onUnlockConnector = unlockConnector;
 }
 
-std::function<PollResult<bool>()> Connector::getOnUnlockConnector() {
+std::function<UnlockConnectorResult()> Connector::getOnUnlockConnector() {
     return this->onUnlockConnector;
 }
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 3b5e6196..fb66ee37 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -1,15 +1,15 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CONNECTOR_H
-#define CONNECTOR_H
+#ifndef MO_CONNECTOR_H
+#define MO_CONNECTOR_H
 
 #include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
+#include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
-#include <MicroOcpp/Core/PollResult.h>
 #include <MicroOcpp/Operations/CiStrings.h>
 
 #include <vector>
@@ -49,7 +49,7 @@ class Connector {
     ChargePointStatus reportedStatus = ChargePointStatus::NOT_SET;
     unsigned long t_statusTransition = 0;
 
-    std::function<PollResult<bool>()> onUnlockConnector;
+    std::function<UnlockConnectorResult()> onUnlockConnector;
 
     std::function<bool()> startTxReadyInput; //the StartTx request will be delayed while this Input is false
     std::function<bool()> stopTxReadyInput; //the StopTx request will be delayed while this Input is false
@@ -116,8 +116,8 @@ class Connector {
 
     bool ocppPermitsCharge();
 
-    void setOnUnlockConnector(std::function<PollResult<bool>()> unlockConnector);
-    std::function<PollResult<bool>()> getOnUnlockConnector();
+    void setOnUnlockConnector(std::function<UnlockConnectorResult()> unlockConnector);
+    std::function<UnlockConnectorResult()> getOnUnlockConnector();
 
     void setStartTxReadyInput(std::function<bool()> startTxReady);
     void setStopTxReadyInput(std::function<bool()> stopTxReady);
diff --git a/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h b/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h
new file mode 100644
index 00000000..3b91ab59
--- /dev/null
+++ b/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h
@@ -0,0 +1,28 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_UNLOCKCONNECTORRESULT_H
+#define MO_UNLOCKCONNECTORRESULT_H
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+#ifndef MO_UNLOCK_TIMEOUT
+#define MO_UNLOCK_TIMEOUT 10000 // if Result is Pending, wait at most this period (in ms) until sending UnlockFailed
+#endif
+
+typedef enum {
+    UnlockFailed,
+    Unlocked,
+    Pending // unlock action not finished yet, result still unknown (MO will check again later)
+} UnlockConnectorResult;
+
+#ifdef __cplusplus
+}
+#endif // __cplusplus
+
+#endif // MO_UNLOCKCONNECTORRESULT_H
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index 1a64391f..432a6423 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/ReserveNow.h>
@@ -7,6 +7,7 @@
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Model/ConnectorBase/Connector.h>
 #include <MicroOcpp/Platform.h>
+#include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::ReserveNow;
 
diff --git a/src/MicroOcpp/Operations/Reset.cpp b/src/MicroOcpp/Operations/Reset.cpp
index 9a799739..586bc3b7 100644
--- a/src/MicroOcpp/Operations/Reset.cpp
+++ b/src/MicroOcpp/Operations/Reset.cpp
@@ -1,10 +1,11 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/Reset.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::Reset;
 
diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index aa01ee50..39ca611d 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/UnlockConnector.h>
@@ -8,8 +8,6 @@
 
 using MicroOcpp::Ocpp16::UnlockConnector;
 
-#define MO_UNLOCK_TIMEOUT 10000
-
 UnlockConnector::UnlockConnector(Model& model) : model(model) {
   
 }
@@ -48,9 +46,9 @@ std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
     if (unlockConnector && mocpp_tick_ms() - timerStart < MO_UNLOCK_TIMEOUT) {
         //do poll and if more time is needed, delay creation of conf msg
 
-        if (!cbUnlockResult) {
+        if (cbUnlockResult == UnlockConnectorResult::Pending) {
             cbUnlockResult = unlockConnector();
-            if (!cbUnlockResult) {
+            if (cbUnlockResult == UnlockConnectorResult::Pending) {
                 return nullptr; //no result yet - delay confirmation response
             }
         }
@@ -60,7 +58,7 @@ std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
     JsonObject payload = doc->to<JsonObject>();
     if (!unlockConnector) {
         payload["status"] = "NotSupported";
-    } else if (cbUnlockResult && cbUnlockResult.toValue()) {
+    } else if (cbUnlockResult == UnlockConnectorResult::Unlocked) {
         payload["status"] = "Unlocked";
     } else {
         payload["status"] = "UnlockFailed";
diff --git a/src/MicroOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
index ac37606d..ba4081dd 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.h
+++ b/src/MicroOcpp/Operations/UnlockConnector.h
@@ -6,7 +6,7 @@
 #define UNLOCKCONNECTOR_H
 
 #include <MicroOcpp/Core/Operation.h>
-#include <MicroOcpp/Core/PollResult.h>
+#include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <functional>
 
 namespace MicroOcpp {
@@ -18,8 +18,8 @@ namespace Ocpp16 {
 class UnlockConnector : public Operation {
 private:
     Model& model;
-    std::function<PollResult<bool> ()> unlockConnector;
-    PollResult<bool> cbUnlockResult;
+    std::function<UnlockConnectorResult ()> unlockConnector;
+    UnlockConnectorResult cbUnlockResult;
     unsigned long timerStart = 0; //for timeout
 
     const char *errorCode = nullptr;
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index b04fc9f5..5e9a5876 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include "MicroOcpp_c.h"
@@ -45,19 +45,6 @@ void ocpp_loop() {
  * Helper functions for transforming callback functions from C-style to C++style
  */
 
-MicroOcpp::PollResult<bool> adaptScl(enum OptionalBool v) {
-    if (v == OptionalTrue) {
-        return true;
-    } else if (v == OptionalFalse) {
-        return false;
-    } else if (v == OptionalNone) {
-        return MicroOcpp::PollResult<bool>::Await();
-    } else {
-        MO_DBG_ERR("illegal argument");
-        return false;
-    }
-}
-
 std::function<bool()> adaptFn(InputBool fn) {
     return fn;
 }
@@ -138,12 +125,12 @@ MicroOcpp::OnReceiveErrorListener adaptFn(OnCallError fn) {
     };
 }
 
-std::function<MicroOcpp::PollResult<bool>()> adaptFn(PollBool fn) {
-    return [fn] () {return adaptScl(fn());};
+std::function<UnlockConnectorResult()> adaptFn(PollUnlockResult fn) {
+    return [fn] () {return fn();};
 }
 
-std::function<MicroOcpp::PollResult<bool>()> adaptFn(unsigned int connectorId, PollBool_m fn) {
-    return [fn, connectorId] () {return adaptScl(fn(connectorId));};
+std::function<UnlockConnectorResult()> adaptFn(unsigned int connectorId, PollUnlockResult_m fn) {
+    return [fn, connectorId] () {return fn(connectorId);};
 }
 
 void ocpp_beginTransaction(const char *idTag) {
@@ -291,10 +278,10 @@ void ocpp_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterV
     addMeterValueInput(std::move(svs), connectorId);
 }
 
-void ocpp_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut) {
+void ocpp_setOnUnlockConnectorInOut(PollUnlockResult onUnlockConnectorInOut) {
     setOnUnlockConnectorInOut(adaptFn(onUnlockConnectorInOut));
 }
-void ocpp_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut) {
+void ocpp_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollUnlockResult_m onUnlockConnectorInOut) {
     setOnUnlockConnectorInOut(adaptFn(connectorId, onUnlockConnectorInOut), connectorId);
 }
 
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index f3a259bf..583e7c3f 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef ARDUINOOCPP_C_H
@@ -9,6 +9,7 @@
 
 #include <MicroOcpp/Core/ConfigurationOptions.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
+#include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/Certificates/Certificate_c.h>
 
@@ -39,9 +40,8 @@ typedef void (*OutputFloat)(float limit);
 typedef void (*OutputFloat_m)(unsigned int connectorId, float limit);
 typedef void (*OutputSmartCharging)(float power, float current, int nphases);
 typedef void (*OutputSmartCharging_m)(unsigned int connectorId, float power, float current, int nphases);
-enum OptionalBool {OptionalTrue, OptionalFalse, OptionalNone};
-typedef enum OptionalBool (*PollBool)();
-typedef enum OptionalBool (*PollBool_m)(unsigned int connectorId);
+typedef UnlockConnectorResult (*PollUnlockResult)();
+typedef UnlockConnectorResult (*PollUnlockResult_m)(unsigned int connectorId);
 
 
 #ifdef __cplusplus
@@ -154,8 +154,8 @@ void ocpp_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxRead
 void ocpp_setTxNotificationOutput(void (*notificationOutput)(OCPP_Transaction*, enum OCPP_TxNotification));
 void ocpp_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, OCPP_Transaction*, enum OCPP_TxNotification));
 
-void ocpp_setOnUnlockConnectorInOut(PollBool onUnlockConnectorInOut);
-void ocpp_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollBool_m onUnlockConnectorInOut);
+void ocpp_setOnUnlockConnectorInOut(PollUnlockResult onUnlockConnectorInOut);
+void ocpp_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollUnlockResult_m onUnlockConnectorInOut);
 
 /*
  * Access further information about the internal state of the library
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 3bf463a1..149e2538 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -5,6 +5,7 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Debug.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
@@ -57,7 +58,7 @@ TEST_CASE( "C++ API test" ) {
         setStartTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setStopTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setTxNotificationOutput([c = &checkpoints[ncheck++]] (MicroOcpp::Transaction*, MicroOcpp::TxNotification) {*c = true;});
-        setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> MicroOcpp::PollResult<bool> {*c = true; return true;});
+        setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> UnlockConnectorResult {*c = true; return UnlockConnectorResult::Unlocked;});
 
         setOnResetNotify([c = &checkpoints[ncheck++]] (bool) -> bool {*c = true; return true;});
         setOnResetExecute([c = &checkpoints[ncheck++]] (bool) {*c = true;});
@@ -165,85 +166,6 @@ TEST_CASE( "C++ API test" ) {
         }
 
         REQUIRE(checkpointsPassed);
-
-        // UnlockConnector handler
-        setOnUnlockConnectorInOut(nullptr);
-        setConnectorPluggedInput(nullptr);
-
-        beginTransaction_authorized("abc");
-
-        loop();
-
-        bool checkProcessed = false;
-        getOcppContext()->initiateRequest(makeRequest(
-            new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
-                [] () {
-                    //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
-                    auto payload = doc->to<JsonObject>();
-                    payload["connectorId"] = 1;
-                    return doc;
-                },
-                [&checkProcessed] (JsonObject payload) {
-                    //process conf
-                    checkProcessed = true;
-                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "NotSupported") );
-                })));
-        
-        loop();
-        REQUIRE( checkProcessed );
-        REQUIRE( isTransactionRunning() ); // NotSupported doesn't lead to transaction stop
-
-        setOnUnlockConnectorInOut([] () -> MicroOcpp::PollResult<bool> {
-            // connector lock fails
-            return false;
-        });
-
-        checkProcessed = false;
-        getOcppContext()->initiateRequest(makeRequest(
-            new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
-                [] () {
-                    //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
-                    auto payload = doc->to<JsonObject>();
-                    payload["connectorId"] = 1;
-                    return doc;
-                },
-                [&checkProcessed] (JsonObject payload) {
-                    //process conf
-                    checkProcessed = true;
-                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "UnlockFailed") );
-                })));
-        
-        loop();
-        REQUIRE( checkProcessed );
-        REQUIRE( !isTransactionRunning() ); // Stop tx when UnlockConnector generally supported
-
-        setOnUnlockConnectorInOut([] () -> MicroOcpp::PollResult<bool> {
-            // connector lock times out
-            return MicroOcpp::PollResult<bool>::Await;
-        });
-
-        checkProcessed = false;
-        getOcppContext()->initiateRequest(makeRequest(
-            new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
-                [] () {
-                    //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
-                    auto payload = doc->to<JsonObject>();
-                    payload["connectorId"] = 1;
-                    return doc;
-                },
-                [&checkProcessed] (JsonObject payload) {
-                    //process conf
-                    checkProcessed = true;
-                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "UnlockFailed") );
-                })));
-        
-        loop();
-        mtime += 60000;
-        loop();
-        REQUIRE( checkProcessed );
     }
 
     mocpp_deinitialize();
@@ -322,8 +244,8 @@ TEST_CASE( "C API test" ) {
         ocpp_setStopTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[23] = true; return true;}); ncheckc++;
         ocpp_setTxNotificationOutput([] (OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[24] = true;}); ncheckc++;
         ocpp_setTxNotificationOutput_m(2, [] (unsigned int, OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[25] = true;}); ncheckc++;
-        ocpp_setOnUnlockConnectorInOut([] () -> OptionalBool {checkpointsc[26] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
-        ocpp_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> OptionalBool {checkpointsc[27] = true; return OptionalBool::OptionalTrue;}); ncheckc++;
+        ocpp_setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {checkpointsc[26] = true; return UnlockConnectorResult::Unlocked;}); ncheckc++;
+        ocpp_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> UnlockConnectorResult {checkpointsc[27] = true; return UnlockConnectorResult::Unlocked;}); ncheckc++;
 
         ocpp_setOnResetNotify([] (bool) -> bool {checkpointsc[28] = true; return true;}); ncheckc++;
         ocpp_setOnResetExecute([] (bool) {checkpointsc[29] = true;}); ncheckc++;
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 8eb98fcb..48cffd19 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -397,6 +397,85 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE(isOperative());
     }
 
-    mocpp_deinitialize();
+    SECTION("UnlockConnector") {
+        // UnlockConnector handler
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+        REQUIRE( isTransactionRunning() );
+
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = 1;
+                    return doc;
+                },
+                [&checkProcessed] (JsonObject payload) {
+                    //process conf
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "NotSupported") );
+                })));
+        
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( isTransactionRunning() ); // NotSupported doesn't lead to transaction stop
+
+        setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {
+            // connector lock fails
+            return UnlockConnectorResult::UnlockFailed;
+        });
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = 1;
+                    return doc;
+                },
+                [&checkProcessed] (JsonObject payload) {
+                    //process conf
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "UnlockFailed") );
+                })));
+        
+        loop();
+        REQUIRE( checkProcessed );
+        REQUIRE( !isTransactionRunning() ); // Stop tx when UnlockConnector generally supported
+
+        setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {
+            // connector lock times out
+            return UnlockConnectorResult::Pending;
+        });
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(
+            new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["connectorId"] = 1;
+                    return doc;
+                },
+                [&checkProcessed] (JsonObject payload) {
+                    //process conf
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "UnlockFailed") );
+                })));
+        
+        loop();
+        mtime += MO_UNLOCK_TIMEOUT; // increment clock so that MO_UNLOCK_TIMEOUT expires
+        loop();
+        REQUIRE( checkProcessed );
+    }
 
+    mocpp_deinitialize();
 }
diff --git a/tests/Configuration.cpp b/tests/Configuration.cpp
index 8d918ccf..5349e5a3 100644
--- a/tests/Configuration.cpp
+++ b/tests/Configuration.cpp
@@ -12,6 +12,7 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Debug.h>
 
 using namespace MicroOcpp;
 
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 822eee9f..9f23231c 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -5,6 +5,7 @@
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Debug.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 

From 85ea4d99bfa11269c012f393e2ed2e949f383fc1 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 10 Mar 2024 21:20:32 +0100
Subject: [PATCH 451/549] make SmartCharging cardinality limits configurable

---
 CHANGELOG.md                                  |  1 +
 CMakeLists.txt                                |  4 ++
 .../SmartCharging/SmartChargingModel.cpp      |  4 +-
 .../Model/SmartCharging/SmartChargingModel.h  | 16 ++++++--
 .../SmartCharging/SmartChargingService.cpp    | 41 +++++++++----------
 .../SmartCharging/SmartChargingService.h      |  4 +-
 6 files changed, 40 insertions(+), 30 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index aa12fb20..63c57e56 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@
 ### Added
 
 - File index ([#270](https://github.com/matth-x/MicroOcpp/pull/270))
+- Build flags for customizing memory limits of SmartCharging
 - Operation GetInstalledCertificateIds, UC M03 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation DeleteCertificate, UC M04 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation InstallCertificate, UC M05 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 524f77f0..d61bd6eb 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -182,9 +182,13 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_SendLocalListMaxLength=4
     MO_ENABLE_FILE_INDEX=1
     #MO_ENABLE_MBEDTLS=1
+    MO_ChargeProfileMaxStackLevel=2
+    MO_ChargingScheduleMaxPeriods=4
+    MO_MaxChargingProfilesInstalled=3
 )
 
 target_compile_options(mo_unit_tests PUBLIC
+    -Wall
     -O0
     -g
     --coverage
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
index e64068d1..4813dbb9 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -369,7 +369,7 @@ std::unique_ptr<ChargingProfile> MicroOcpp::loadChargingProfile(JsonObject& json
     }
 
     int stackLevel = json["stackLevel"] | -1;
-    if (stackLevel >= 0 && stackLevel <= CHARGEPROFILEMAXSTACKLEVEL) {
+    if (stackLevel >= 0 && stackLevel <= MO_ChargeProfileMaxStackLevel) {
         res->stackLevel = stackLevel;
     } else {
         MO_DBG_WARN("format violation");
@@ -480,7 +480,7 @@ bool MicroOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
         return false;
     }
 
-    if (periodJsonArray.size() > CHARGINGSCHEDULEMAXPERIODS) {
+    if (periodJsonArray.size() > MO_ChargingScheduleMaxPeriods) {
         MO_DBG_WARN("exceed ChargingScheduleMaxPeriods");
         return false;
     }
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
index abd62c1f..74d571b6 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
@@ -1,13 +1,21 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef SMARTCHARGINGMODEL_H
 #define SMARTCHARGINGMODEL_H
 
-#define CHARGEPROFILEMAXSTACKLEVEL 8
-#define CHARGINGSCHEDULEMAXPERIODS 24
-#define MAXCHARGINGPROFILESINSTALLED 10
+#ifndef MO_ChargeProfileMaxStackLevel
+#define MO_ChargeProfileMaxStackLevel 8
+#endif
+
+#ifndef MO_ChargingScheduleMaxPeriods
+#define MO_ChargingScheduleMaxPeriods 24
+#endif
+
+#ifndef MO_MaxChargingProfilesInstalled
+#define MO_MaxChargingProfilesInstalled 10
+#endif
 
 #include <memory>
 #include <vector>
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index b3d41e29..e6a7d967 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
@@ -38,7 +38,7 @@ void SmartChargingConnector::calculateLimit(const Timestamp &t, ChargeRate& limi
     ChargeRate txLimit;
 
     //first, check if TxProfile is defined and limits charging
-    for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+    for (int i = MO_ChargeProfileMaxStackLevel; i >= 0; i--) {
         if (TxProfile[i] && ((trackTxRmtProfileId >= 0 && trackTxRmtProfileId == TxProfile[i]->getChargingProfileId()) ||
                                 TxProfile[i]->getTransactionId() < 0 ||
                                 trackTxId == TxProfile[i]->getTransactionId())) {
@@ -54,7 +54,7 @@ void SmartChargingConnector::calculateLimit(const Timestamp &t, ChargeRate& limi
 
     //if no TxProfile limits charging, check the TxDefaultProfiles for this connector
     if (!txLimitDefined && trackTxStart < MAX_TIME) {
-        for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+        for (int i = MO_ChargeProfileMaxStackLevel; i >= 0; i--) {
             if (TxDefaultProfile[i]) {
                 ChargeRate crOut;
                 bool defined = TxDefaultProfile[i]->calculateLimit(t, trackTxStart, crOut, validToOut);
@@ -69,7 +69,7 @@ void SmartChargingConnector::calculateLimit(const Timestamp &t, ChargeRate& limi
 
     //if no appropriate TxDefaultProfile is set for this connector, search in the general TxDefaultProfiles
     if (!txLimitDefined && trackTxStart < MAX_TIME) {
-        for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+        for (int i = MO_ChargeProfileMaxStackLevel; i >= 0; i--) {
             if (ChargePointTxDefaultProfile[i]) {
                 ChargeRate crOut;
                 bool defined = ChargePointTxDefaultProfile[i]->calculateLimit(t, trackTxStart, crOut, validToOut);
@@ -85,7 +85,7 @@ void SmartChargingConnector::calculateLimit(const Timestamp &t, ChargeRate& limi
     ChargeRate cpLimit;
 
     //the calculated maximum charge rate is also limited by the ChargePointMaxProfiles
-    for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+    for (int i = MO_ChargeProfileMaxStackLevel; i >= 0; i--) {
         if (ChargePointMaxProfile[i]) {
             ChargeRate crOut;
             bool defined = ChargePointMaxProfile[i]->calculateLimit(t, trackTxStart, crOut, validToOut);
@@ -238,7 +238,7 @@ std::unique_ptr<ChargingSchedule> SmartChargingConnector::getCompositeSchedule(i
     Timestamp periodBegin = Timestamp(startSchedule);
     Timestamp periodStop = Timestamp(startSchedule);
 
-    while (periodBegin - startSchedule < duration && periods.size() < CHARGINGSCHEDULEMAXPERIODS) {
+    while (periodBegin - startSchedule < duration && periods.size() < MO_ChargingScheduleMaxPeriods) {
 
         //calculate limit
         ChargeRate limit;
@@ -273,7 +273,7 @@ std::unique_ptr<ChargingSchedule> SmartChargingConnector::getCompositeSchedule(i
 
 size_t SmartChargingConnector::getChargingProfilesCount() {
     size_t chargingProfilesCount = 0;
-    for (size_t i = 0; i < CHARGEPROFILEMAXSTACKLEVEL + 1; i++) {
+    for (size_t i = 0; i < MO_ChargeProfileMaxStackLevel + 1; i++) {
         if (TxDefaultProfile[i]) {
             chargingProfilesCount++;
         }
@@ -303,10 +303,10 @@ SmartChargingService::SmartChargingService(Context& context, std::shared_ptr<Fil
         connectors.push_back(std::move(SmartChargingConnector(context.getModel(), filesystem, cId, ChargePointMaxProfile, ChargePointTxDefaultProfile)));
     }
 
-    declareConfiguration<int>("ChargeProfileMaxStackLevel", CHARGEPROFILEMAXSTACKLEVEL, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<int>("ChargeProfileMaxStackLevel", MO_ChargeProfileMaxStackLevel, CONFIGURATION_VOLATILE, true);
     declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE);
-    declareConfiguration<int>("ChargingScheduleMaxPeriods", CHARGINGSCHEDULEMAXPERIODS, CONFIGURATION_VOLATILE, true);
-    declareConfiguration<int>("MaxChargingProfilesInstalled", MAXCHARGINGPROFILESINSTALLED, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<int>("ChargingScheduleMaxPeriods", MO_ChargingScheduleMaxPeriods, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<int>("MaxChargingProfilesInstalled", MO_MaxChargingProfilesInstalled, CONFIGURATION_VOLATILE, true);
 
     context.getOperationRegistry().registerOperation("ClearChargingProfile", [this] () {
         return new Ocpp16::ClearChargingProfile(*this);});
@@ -335,13 +335,13 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
     }
 
     int stackLevel = chargingProfile->getStackLevel();
-    if (stackLevel< 0 || stackLevel >= CHARGEPROFILEMAXSTACKLEVEL + 1) {
+    if (stackLevel< 0 || stackLevel >= MO_ChargeProfileMaxStackLevel + 1) {
         MO_DBG_ERR("input validation failed");
         return nullptr;
     }
 
     size_t chargingProfilesCount = 0;
-    for (size_t i = 0; i < CHARGEPROFILEMAXSTACKLEVEL + 1; i++) {
+    for (size_t i = 0; i < MO_ChargeProfileMaxStackLevel + 1; i++) {
         if (ChargePointTxDefaultProfile[i]) {
             chargingProfilesCount++;
         }
@@ -353,7 +353,7 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
         chargingProfilesCount += connectors[i].getChargingProfilesCount();
     }
 
-    if (chargingProfilesCount >= MAXCHARGINGPROFILESINSTALLED) {
+    if (chargingProfilesCount >= MO_MaxChargingProfilesInstalled) {
         MO_DBG_WARN("number of maximum charging profiles exceeded");
         return nullptr;
     }
@@ -374,19 +374,16 @@ ChargingProfile *SmartChargingService::updateProfiles(unsigned int connectorId,
                 ChargePointTxDefaultProfile[stackLevel] = std::move(chargingProfile);
                 res = ChargePointTxDefaultProfile[stackLevel].get();
             } else {
-                if (!getScConnectorById(connectorId)) {
-                    MO_DBG_WARN("invalid charging profile");
-                    return nullptr;
-                }
                 res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
             }
             break;
         case (ChargingProfilePurposeType::TxProfile):
-            if (!getScConnectorById(connectorId)) {
+            if (connectorId == 0) {
                 MO_DBG_WARN("invalid charging profile");
                 return nullptr;
+            } else {
+                res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
             }
-            res = getScConnectorById(connectorId)->updateProfiles(std::move(chargingProfile));
             break;
     }
 
@@ -422,7 +419,7 @@ bool SmartChargingService::loadProfiles() {
             if (cId > 0 && purpose == ChargingProfilePurposeType::ChargePointMaxProfile) {
                 continue;
             }
-            for (unsigned int iLevel = 0; iLevel < CHARGEPROFILEMAXSTACKLEVEL; iLevel++) {
+            for (unsigned int iLevel = 0; iLevel < MO_ChargeProfileMaxStackLevel; iLevel++) {
 
                 if (!SmartChargingServiceUtils::printProfileFileName(fn, MO_MAX_PATH_SIZE, cId, purpose, iLevel)) {
                     return false;
@@ -471,7 +468,7 @@ void SmartChargingService::calculateLimit(const Timestamp &t, ChargeRate& limitO
     validToOut = MAX_TIME;
 
     //get ChargePointMaxProfile with the highest stackLevel
-    for (int i = CHARGEPROFILEMAXSTACKLEVEL; i >= 0; i--) {
+    for (int i = MO_ChargeProfileMaxStackLevel; i >= 0; i--) {
         if (ChargePointMaxProfile[i]) {
             ChargeRate crOut;
             bool defined = ChargePointMaxProfile[i]->calculateLimit(t, crOut, validToOut);
@@ -656,7 +653,7 @@ std::unique_ptr<ChargingSchedule> SmartChargingService::getCompositeSchedule(uns
     Timestamp periodBegin = Timestamp(startSchedule);
     Timestamp periodStop = Timestamp(startSchedule);
 
-    while (periodBegin - startSchedule < duration && periods.size() < CHARGINGSCHEDULEMAXPERIODS) {
+    while (periodBegin - startSchedule < duration && periods.size() < MO_ChargingScheduleMaxPeriods) {
 
         //calculate limit
         ChargeRate limit;
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
index f4dfa8ee..5af5448f 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef SMARTCHARGINGSERVICE_H
@@ -26,7 +26,7 @@ enum class ChargingRateUnitType_Optional {
 class Context;
 class Model;
 
-using ProfileStack = std::array<std::unique_ptr<ChargingProfile>, CHARGEPROFILEMAXSTACKLEVEL + 1>;
+using ProfileStack = std::array<std::unique_ptr<ChargingProfile>, MO_ChargeProfileMaxStackLevel + 1>;
 
 class SmartChargingConnector {
 private:

From 64d77c15268d179258d666d8cade703d5135e5f2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 11 Mar 2024 20:40:55 +0100
Subject: [PATCH 452/549] unit tests for SmartCharging memory limits

---
 tests/SmartCharging.cpp | 208 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 208 insertions(+)

diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index 81d73791..a8f34ad7 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -539,6 +539,214 @@ TEST_CASE( "SmartCharging" ) {
         REQUIRE(schedule->chargingSchedulePeriod[3].startPeriod == 86400);
     }
 
+    SECTION("SmartCharging memory limits - MaxChargingProfilesInstalled") {
+
+        loop();
+
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    return doc;},
+                [&checkProcessed] (JsonObject response) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(response["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_0_ALT_SAME_ID);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    (*doc)["connectorId"] = 2;
+                    return doc;},
+                [&checkProcessed] (JsonObject response) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(response["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_1_ABSOLUTE_LIMIT_16A);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    return doc;},
+                [&checkProcessed] (JsonObject response) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(response["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        // 3 distinct ChargingProfiles installed. Check if further Profiles are rejected correctly
+
+        for (size_t i = 0; i < 2; i++) {
+            // replace existing profile - OK
+
+            checkProcessed = false;
+            getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                    "SetChargingProfile",
+                    [] () {
+                        //create req
+                        StaticJsonDocument<2048> raw;
+                        deserializeJson(raw, SCPROFILE_1_ABSOLUTE_LIMIT_16A);
+                        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                        *doc = raw[3];
+                        return doc;},
+                    [&checkProcessed] (JsonObject response) {
+                        checkProcessed = true;
+                        REQUIRE( !strcmp(response["status"] | "_Undefined", "Accepted") );
+                    }
+            )));
+            loop();
+            REQUIRE( checkProcessed );
+        }
+
+        for (size_t i = 0; i < 2; i++) {
+            // try to install additional profile - not okay
+
+            checkProcessed = false;
+            getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                    "SetChargingProfile",
+                    [] () {
+                        //create req
+                        StaticJsonDocument<2048> raw;
+                        deserializeJson(raw, SCPROFILE_5_VALID_UNTIL_2022_16A);
+                        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                        *doc = raw[3];
+                        return doc;},
+                    [&checkProcessed] (JsonObject response) {
+                        checkProcessed = true;
+                        REQUIRE( !strcmp(response["status"] | "_Undefined", "Rejected") );
+                    }
+            )));
+            loop();
+            REQUIRE( checkProcessed );
+        }
+    }
+
+    SECTION("SmartCharging memory limits - ChargeProfileMaxStackLevel") {
+
+        loop();
+
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    (*doc)["csChargingProfiles"]["stackLevel"] = MO_ChargeProfileMaxStackLevel;
+                    return doc;},
+                [&checkProcessed] (JsonObject response) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(response["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    (*doc)["csChargingProfiles"]["stackLevel"] = MO_ChargeProfileMaxStackLevel + 1;
+                    return doc;},
+                [] (JsonObject) { }, //ignore conf
+                [&checkProcessed] (const char*, const char*, JsonObject) {
+                    // process error
+                    checkProcessed = true;
+                    return true;
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+    }
+
+    SECTION("SmartCharging memory limits - ChargingScheduleMaxPeriods") {
+
+        loop();
+
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    JsonArray chargingSchedulePeriod = (*doc)["csChargingProfiles"]["chargingSchedule"]["chargingSchedulePeriod"];
+                    chargingSchedulePeriod.clear();
+                    for (size_t i = 0; i < MO_ChargingScheduleMaxPeriods; i++) {
+                        auto period = chargingSchedulePeriod.createNestedObject();
+                        period["startPeriod"] = i;
+                        period["limit"] = 16;
+                    }
+                    return doc;},
+                [&checkProcessed] (JsonObject response) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(response["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    JsonArray chargingSchedulePeriod = (*doc)["csChargingProfiles"]["chargingSchedule"]["chargingSchedulePeriod"];
+                    chargingSchedulePeriod.clear();
+                    for (size_t i = 0; i < MO_ChargingScheduleMaxPeriods + 1; i++) {
+                        auto period = chargingSchedulePeriod.createNestedObject();
+                        period["startPeriod"] = i;
+                        period["limit"] = 16;
+                    }
+                    return doc;},
+                [] (JsonObject) { }, //ignore conf
+                [&checkProcessed] (const char*, const char*, JsonObject) {
+                    // process error
+                    checkProcessed = true;
+                    return true;
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+    }
+
     scService->clearChargingProfile([] (int, int, ChargingProfilePurposeType, int) {
         return true;
     });

From 7abec0aa5eea6260f53aa2ba5a749feffd8cf452 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Mon, 11 Mar 2024 21:05:10 +0100
Subject: [PATCH 453/549] reject ChargingProfile if unit not supported

---
 CHANGELOG.md                                  |  1 +
 .../SmartCharging/SmartChargingService.cpp    |  6 ++
 .../SmartCharging/SmartChargingService.h      |  1 -
 tests/SmartCharging.cpp                       | 85 +++++++++++++++++++
 4 files changed, 92 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 63c57e56..c08123c5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -25,6 +25,7 @@
 - Make field localAuthorizationList in SendLocalList optional
 - Update charging profiles when flash disabled (relates to [#260](https://github.com/matth-x/MicroOcpp/pull/260))
 - Ignore UnlockConnector when handler not set
+- Reject ChargingProfile if unit not supported
 
 ## [1.0.1] - 2024-02-27
 
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index e6a7d967..8f77f3e3 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -566,6 +566,12 @@ bool SmartChargingService::setChargingProfile(unsigned int connectorId, std::uni
         return false;
     }
 
+    if ((!currentSupported && chargingProfile->chargingSchedule.chargingRateUnit == ChargingRateUnitType::Amp) ||
+            (!powerSupported && chargingProfile->chargingSchedule.chargingRateUnit == ChargingRateUnitType::Watt)) {
+        MO_DBG_WARN("unsupported charge rate unit");
+        return false;
+    }
+
     int chargingProfileId = chargingProfile->getChargingProfileId();
     clearChargingProfile([chargingProfileId] (int id, int, ChargingProfilePurposeType, int) {
         return id == chargingProfileId;
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
index 5af5448f..e3a41dab 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
@@ -11,7 +11,6 @@
 #include <ArduinoJson.h>
 
 #include <MicroOcpp/Model/SmartCharging/SmartChargingModel.h>
-#include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/Time.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index a8f34ad7..c029fcd1 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -747,6 +747,91 @@ TEST_CASE( "SmartCharging" ) {
         REQUIRE( checkProcessed );
     }
 
+    SECTION("ChargingScheduleAllowedChargingRateUnit") {
+        
+        setSmartChargingOutput(nullptr);
+        loop();
+
+        // accept power, reject current
+        setSmartChargingPowerOutput([] (float) { });
+
+        bool checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_0);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    return doc;},
+                [&checkProcessed] (JsonObject response) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(response["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_1_ABSOLUTE_LIMIT_16A);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    return doc;},
+                [&checkProcessed] (JsonObject response) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(response["status"] | "_Undefined", "Rejected") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        //  reject power, accept current
+        setSmartChargingPowerOutput(nullptr);
+        setSmartChargingCurrentOutput([] (float) { });
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_0);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    return doc;},
+                [&checkProcessed] (JsonObject response) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(response["status"] | "_Undefined", "Rejected") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkProcessed = false;
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "SetChargingProfile",
+                [] () {
+                    //create req
+                    StaticJsonDocument<2048> raw;
+                    deserializeJson(raw, SCPROFILE_1_ABSOLUTE_LIMIT_16A);
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    *doc = raw[3];
+                    return doc;},
+                [&checkProcessed] (JsonObject response) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(response["status"] | "_Undefined", "Accepted") );
+                }
+        )));
+        loop();
+        REQUIRE( checkProcessed );
+    }
+
     scService->clearChargingProfile([] (int, int, ChargingProfilePurposeType, int) {
         return true;
     });

From 4ba61a9313efc183568263228da2b82c7de05d4b Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 17 Mar 2024 20:42:07 +0100
Subject: [PATCH 454/549] Update README.md

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 28e24a52..28b85077 100644
--- a/README.md
+++ b/README.md
@@ -79,6 +79,6 @@ ISO 15118 defines some use cases which include a message exchange between the ch
 
 ## Contact details
 
-I hope the given documentation and guidance can help you to successfully integrate an OCPP controller into your EVSE. I will be happy if you reach out!
+If you have further questions, feel free to reach out!
 
-:envelope: : matthias [A⊤] arduino-ocpp [DО⊤] com
+:envelope: : matthias [A⊤] micro-ocpp [DО⊤] com

From 3ba0eea50798ff9bcef5aee5de34cf8582886f56 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 17 Mar 2024 21:58:25 +0100
Subject: [PATCH 455/549] add prefixes to enum UnlockConnectorResult

---
 src/MicroOcpp.h                                           | 6 +++---
 src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h | 6 +++---
 src/MicroOcpp/Operations/UnlockConnector.cpp              | 6 +++---
 tests/Api.cpp                                             | 6 +++---
 tests/ChargingSessions.cpp                                | 4 ++--
 5 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 4e5fa854..dcd16c5b 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -306,9 +306,9 @@ void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcp
  * Set an InputOutput (reads and sets information at the same time) for forcing to unlock the
  * connector. Called as part of the OCPP operation "UnlockConnector"
  * Return values:
- *     - UnlockConnectorResult::Pending if action needs more time to complete (MO will call this cb again later or eventually timeout)
- *     - UnlockConnectorResult::Unlocked if successful
- *     - UnlockConnectorResult::UnlockFailed if not successful (e.g. lock stuck)
+ *     - UnlockConnectorResult_Pending if action needs more time to complete (MO will call this cb again later or eventually timeout)
+ *     - UnlockConnectorResult_Unlocked if successful
+ *     - UnlockConnectorResult_UnlockFailed if not successful (e.g. lock stuck)
  */
 void setOnUnlockConnectorInOut(std::function<UnlockConnectorResult()> onUnlockConnectorInOut, unsigned int connectorId = 1);
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h b/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h
index 3b91ab59..127e4bba 100644
--- a/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h
+++ b/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h
@@ -16,9 +16,9 @@ extern "C" {
 #endif
 
 typedef enum {
-    UnlockFailed,
-    Unlocked,
-    Pending // unlock action not finished yet, result still unknown (MO will check again later)
+    UnlockConnectorResult_UnlockFailed,
+    UnlockConnectorResult_Unlocked,
+    UnlockConnectorResult_Pending // unlock action not finished yet, result still unknown (MO will check again later)
 } UnlockConnectorResult;
 
 #ifdef __cplusplus
diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index 39ca611d..9a171711 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -46,9 +46,9 @@ std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
     if (unlockConnector && mocpp_tick_ms() - timerStart < MO_UNLOCK_TIMEOUT) {
         //do poll and if more time is needed, delay creation of conf msg
 
-        if (cbUnlockResult == UnlockConnectorResult::Pending) {
+        if (cbUnlockResult == UnlockConnectorResult_Pending) {
             cbUnlockResult = unlockConnector();
-            if (cbUnlockResult == UnlockConnectorResult::Pending) {
+            if (cbUnlockResult == UnlockConnectorResult_Pending) {
                 return nullptr; //no result yet - delay confirmation response
             }
         }
@@ -58,7 +58,7 @@ std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
     JsonObject payload = doc->to<JsonObject>();
     if (!unlockConnector) {
         payload["status"] = "NotSupported";
-    } else if (cbUnlockResult == UnlockConnectorResult::Unlocked) {
+    } else if (cbUnlockResult == UnlockConnectorResult_Unlocked) {
         payload["status"] = "Unlocked";
     } else {
         payload["status"] = "UnlockFailed";
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 149e2538..1df5bf3a 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -58,7 +58,7 @@ TEST_CASE( "C++ API test" ) {
         setStartTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setStopTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setTxNotificationOutput([c = &checkpoints[ncheck++]] (MicroOcpp::Transaction*, MicroOcpp::TxNotification) {*c = true;});
-        setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> UnlockConnectorResult {*c = true; return UnlockConnectorResult::Unlocked;});
+        setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> UnlockConnectorResult {*c = true; return UnlockConnectorResult_Unlocked;});
 
         setOnResetNotify([c = &checkpoints[ncheck++]] (bool) -> bool {*c = true; return true;});
         setOnResetExecute([c = &checkpoints[ncheck++]] (bool) {*c = true;});
@@ -244,8 +244,8 @@ TEST_CASE( "C API test" ) {
         ocpp_setStopTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[23] = true; return true;}); ncheckc++;
         ocpp_setTxNotificationOutput([] (OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[24] = true;}); ncheckc++;
         ocpp_setTxNotificationOutput_m(2, [] (unsigned int, OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[25] = true;}); ncheckc++;
-        ocpp_setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {checkpointsc[26] = true; return UnlockConnectorResult::Unlocked;}); ncheckc++;
-        ocpp_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> UnlockConnectorResult {checkpointsc[27] = true; return UnlockConnectorResult::Unlocked;}); ncheckc++;
+        ocpp_setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {checkpointsc[26] = true; return UnlockConnectorResult_Unlocked;}); ncheckc++;
+        ocpp_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> UnlockConnectorResult {checkpointsc[27] = true; return UnlockConnectorResult_Unlocked;}); ncheckc++;
 
         ocpp_setOnResetNotify([] (bool) -> bool {checkpointsc[28] = true; return true;}); ncheckc++;
         ocpp_setOnResetExecute([] (bool) {checkpointsc[29] = true;}); ncheckc++;
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 48cffd19..87132414 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -427,7 +427,7 @@ TEST_CASE( "Charging sessions" ) {
 
         setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {
             // connector lock fails
-            return UnlockConnectorResult::UnlockFailed;
+            return UnlockConnectorResult_UnlockFailed;
         });
 
         checkProcessed = false;
@@ -452,7 +452,7 @@ TEST_CASE( "Charging sessions" ) {
 
         setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {
             // connector lock times out
-            return UnlockConnectorResult::Pending;
+            return UnlockConnectorResult_Pending;
         });
 
         checkProcessed = false;

From 7a6188339ce193dd201c5a7a5e63c74cc59e9af7 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 17 Mar 2024 22:17:53 +0100
Subject: [PATCH 456/549] add config Cst_TxStartOnPowerPathClosed

---
 CHANGELOG.md                                  |  1 +
 .../Model/ConnectorBase/Connector.cpp         | 23 ++++++++---
 src/MicroOcpp/Model/ConnectorBase/Connector.h |  2 +
 tests/ChargingSessions.cpp                    | 39 +++++++++++++++++++
 4 files changed, 60 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c08123c5..75d96b32 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@
 ### Added
 
 - File index ([#270](https://github.com/matth-x/MicroOcpp/pull/270))
+- Config `Cst_TxStartOnPowerPathClosed` to put back TxStartPoint
 - Build flags for customizing memory limits of SmartCharging
 - Operation GetInstalledCertificateIds, UC M03 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation DeleteCertificate, UC M04 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index d0ca67c9..c7736c8f 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -56,6 +56,8 @@ Connector::Connector(Context& context, int connectorId)
     freeVendActiveBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "FreeVendActive", false);
     freeVendIdTagString = declareConfiguration<const char*>(MO_CONFIG_EXT_PREFIX "FreeVendIdTag", "");
 
+    txStartOnPowerPathClosedBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "TxStartOnPowerPathClosed", false);
+
     if (!availabilityBool) {
         MO_DBG_ERR("Cannot declare availabilityBool");
     }
@@ -163,11 +165,21 @@ bool Connector::ocppPermitsCharge() {
         suspendDeAuthorizedIdTag = false;
     }
 
-    return transaction &&
-            transaction->isRunning() &&
-            transaction->isActive() &&
-            !isFaulted() &&
-            !suspendDeAuthorizedIdTag;
+    // check charge permission depending on TxStartPoint
+    if (txStartOnPowerPathClosedBool && txStartOnPowerPathClosedBool->getBool()) {
+        // tx starts when the power path is closed. Advertise charging before transaction
+        return transaction &&
+                transaction->isActive() &&
+                transaction->isAuthorized() &&
+                !suspendDeAuthorizedIdTag;
+    } else {
+        // tx must be started before the power path can be closed
+        return transaction &&
+               transaction->isRunning() &&
+               transaction->isActive() &&
+               !isFaulted() &&
+               !suspendDeAuthorizedIdTag;
+    }
 }
 
 void Connector::loop() {
@@ -254,6 +266,7 @@ void Connector::loop() {
             if (transaction->isActive() && transaction->isAuthorized() &&  //tx must be authorized
                     (!connectorPluggedInput || connectorPluggedInput()) && //if applicable, connector must be plugged
                     isOperative() && //only start tx if charger is free of error conditions
+                    (!txStartOnPowerPathClosedBool || !txStartOnPowerPathClosedBool->getBool() || !evReadyInput || evReadyInput()) && //if applicable, postpone tx start point to PowerPathClosed
                     (!startTxReadyInput || startTxReadyInput())) { //if defined, user Input for allowing StartTx must be true
                 //start Transaction
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index fb66ee37..b2cafad6 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -70,6 +70,8 @@ class Connector {
     std::shared_ptr<Configuration> freeVendIdTagString;
     bool freeVendTrackPlugged = false;
 
+    std::shared_ptr<Configuration> txStartOnPowerPathClosedBool; // this postpones the tx start point to when evReadyInput becomes true
+
     bool trackLoopExecute = false; //if loop has been executed once
 public:
     Connector(Context& context, int connectorId);
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 87132414..66910ff1 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -477,5 +477,44 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE( checkProcessed );
     }
 
+    SECTION("TxStartPoint - PowerPathClosed") {
+
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "TxStartOnPowerPathClosed", true)->setBool(true);
+
+        // precondition: charge not allowed
+        REQUIRE( !ocppPermitsCharge() );
+        REQUIRE( !isTransactionRunning() );
+
+        setConnectorPluggedInput([] () {return false;}); // TxStartOnPowerPathClosed removes ConnectorPlugged as a prerequisite of transactions
+        setEvReadyInput([] () {return false;}); // TxStartOnPowerPathClosed puts EvReady in the role of ConnectorPlugged in conventional transactions
+
+        beginTransaction("mIdTag");
+
+        loop();
+
+        // in contrast to conventional tx mode, charge permission is granted before transaction. PowerPathClosed is a prerequisite of transactions
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( !isTransactionRunning() );
+
+        setConnectorPluggedInput([] () {return true;}); // ConnectorPlugged not sufficient to start tx
+
+        loop();
+
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( !isTransactionRunning() );
+
+        setEvReadyInput([] () {return true;}); // now, close PowerPath. Transaction will start now
+
+        loop();
+
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( isTransactionRunning() );
+
+        endTransaction();
+
+        loop();
+
+    }
+
     mocpp_deinitialize();
 }

From 9715420252938eae0b1b4b9eff68881b545fc0d4 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 22 Mar 2024 14:36:19 +0100
Subject: [PATCH 457/549] fix build for debug levels DBG_WARN and less

---
 CHANGELOG.md                                  |  1 +
 .../Model/Diagnostics/DiagnosticsService.cpp  | 45 +++++++++++--------
 2 files changed, 27 insertions(+), 19 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 75d96b32..322d22cb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -27,6 +27,7 @@
 - Update charging profiles when flash disabled (relates to [#260](https://github.com/matth-x/MicroOcpp/pull/260))
 - Ignore UnlockConnector when handler not set
 - Reject ChargingProfile if unit not supported
+- Fix building with debug level warn and error
 
 ## [1.0.1] - 2024-02-27
 
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index dfe44caa..9a1ba5ea 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
@@ -101,30 +101,37 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const char *location, u
     }
     
 #if MO_DBG_LEVEL >= MO_DL_INFO
-    char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
-    char dbuf2 [JSONDATE_LENGTH + 1] = {'\0'};
-    this->startTime.toJsonString(dbuf, JSONDATE_LENGTH + 1);
-    this->stopTime.toJsonString(dbuf2, JSONDATE_LENGTH + 1);
-
-    MO_DBG_INFO("Scheduled Diagnostics upload!\n" \
-                    "                  location = %s\n" \
-                    "                  retries = %i" \
-                    ", retryInterval = %u" \
-                    "                  startTime = %s\n" \
-                    "                  stopTime = %s",
-            this->location.c_str(),
-            this->retries,
-            this->retryInterval,
-            dbuf,
-            dbuf2);
+    {
+        char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
+        char dbuf2 [JSONDATE_LENGTH + 1] = {'\0'};
+        this->startTime.toJsonString(dbuf, JSONDATE_LENGTH + 1);
+        this->stopTime.toJsonString(dbuf2, JSONDATE_LENGTH + 1);
+
+        MO_DBG_INFO("Scheduled Diagnostics upload!\n" \
+                        "                  location = %s\n" \
+                        "                  retries = %i" \
+                        ", retryInterval = %u" \
+                        "                  startTime = %s\n" \
+                        "                  stopTime = %s",
+                this->location.c_str(),
+                this->retries,
+                this->retryInterval,
+                dbuf,
+                dbuf2);
+    }
 #endif
 
     nextTry = context.getModel().getClock().now();
     nextTry += 5; //wait for 5s before upload
     uploadIssued = false;
 
-    nextTry.toJsonString(dbuf, JSONDATE_LENGTH + 1);
-    MO_DBG_DEBUG("Initial try at %s", dbuf);
+#if MO_DBG_LEVEL >= MO_DL_DEBUG
+    {
+        char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
+        nextTry.toJsonString(dbuf, JSONDATE_LENGTH + 1);
+        MO_DBG_DEBUG("Initial try at %s", dbuf);
+    }
+#endif
 
     std::string fileName;
     if (refreshFilename) {

From ef02b98b82e5aafa4110e6347d62d1dd2b4c3197 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 24 Mar 2024 16:25:01 +0100
Subject: [PATCH 458/549] update default branch, Readme

---
 .github/workflows/documentation.yml |  2 +-
 .github/workflows/esp-idf.yml       |  3 +--
 .github/workflows/pio.yml           |  3 +--
 .github/workflows/platformless.yml  |  3 +--
 .github/workflows/tests.yml         |  3 +--
 CHANGELOG.md                        | 10 ++++++++++
 README.md                           | 21 +++++++++++++++++----
 docs/index.md                       |  2 +-
 src/MicroOcpp.h                     |  2 +-
 9 files changed, 34 insertions(+), 15 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index bd1cd75b..5bb21730 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -2,7 +2,7 @@ name: documentation
 on:
   push:
     branches:
-      - master
+      - main
 permissions:
   contents: write
 jobs:
diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
index f0f756cb..3bc9e699 100644
--- a/.github/workflows/esp-idf.yml
+++ b/.github/workflows/esp-idf.yml
@@ -3,8 +3,7 @@ name: ESP-IDF CI
 on:
   push:
     branches:
-      - master
-      - develop
+      - main
 
   pull_request:
 
diff --git a/.github/workflows/pio.yml b/.github/workflows/pio.yml
index d0fcb568..235e4555 100644
--- a/.github/workflows/pio.yml
+++ b/.github/workflows/pio.yml
@@ -3,8 +3,7 @@ name: PlatformIO CI
 on:
   push:
     branches:
-      - master
-      - develop
+      - main
 
   pull_request:
 
diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 9682e919..5f05b164 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -3,8 +3,7 @@ name: Default Compilation
 on:
   push:
     branches:
-      - master
-      - develop
+      - main
 
   pull_request:
 
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 0a3df6c0..bf857dbc 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -3,8 +3,7 @@ name: Unit tests
 on:
   push:
     branches:
-      - master
-      - develop
+      - main
 
   pull_request:
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 670750e8..8f1a09a5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+### Changed
+
+- Rename master branch into main
+
 ### Added
 
 - Operation GetInstalledCertificateIds, UC M03 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
@@ -17,6 +21,12 @@
 
 - Make field localAuthorizationList in SendLocalList optional
 
+## [1.0.2] - 2024-03-24
+
+### Fixed
+
+- Correct MO version numbers in code (they were still `1.0.0`)
+
 ## [1.0.1] - 2024-02-27
 
 ### Fixed
diff --git a/README.md b/README.md
index 28b85077..d7a0c596 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,8 @@ OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif,
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.micro-ocpp.com](https://www.micro-ocpp.com)
 
+**Updated branches (2024-03-24):** the default branch was renamed from master into main. The develop branch hasn't been used anymore, so it is deleted. This better represents how branches are used in MicroOcpp: active development takes place on main (plus the feature and fixing branches) and the releases are stable versions of this library. To get a release version, checkout a tag, e.g. *v1.0.2*, or download it from GitHub / PlatformIO.
+
 ## Tester / Demo App
 
 *Main repository: [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)*
@@ -53,7 +55,7 @@ PlatformIO package: [MicroOcpp](https://registry.platformio.org/libraries/matth-
 
 MicroOcpp is an implementation of the OCPP communication behavior. It automatically initiates the corresponding OCPP operations once the hardware status changes or the RFID input is updated with a new value. Conversely it processes new data from the server, stores it locally and updates the hardware controls when applicable.
 
-Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h). Also check out the [Docs](https://matth-x.github.io/MicroOcpp).
+Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/main/src/MicroOcpp.h). Also check out the [Docs](https://matth-x.github.io/MicroOcpp).
 
 ### Dependencies
 
@@ -73,11 +75,22 @@ In case you use PlatformIO, you can copy all dependencies from `platformio.ini`
 
 ## OCPP 2.0.1 and ISO 15118
 
-MicroOcpp will be upgraded to OCPP 2.0.1 soon. The API has already been prepared for transitioning between both versions, so an integration of the current library version will also be functional with the 2.0.1 upgrade.
+The following OCPP 2.0.1 use cases are implemented:
+
+| UC | Description | Note |
+| :--- | :--- | :--- |
+| M03 - M05 | Certificate management | Enable Mbed-TLS to use the built-in certificate store |
+| B05 - B06 | Variables | No persistency yet |
+| E01 - E12 | Transactions | |
+| - | Protocol negotiation | The charger can select the OCPP version at runtime |
+
+The OCPP 2.0.1 features are in an early development stage. By default, they are disabled and excluded from the build, so they have no impact on the firmware size. To enable, set the build flag `MO_ENABLE_V201=1` and initialize the library with the ProtocolVersion parameter `2.0.1`  (see [this example](https://github.com/matth-x/MicroOcppSimulator/blob/657e606c3b178d3add242935d413c72624130ff3/src/main.cpp#L43-L47) in the Simulator).
+
+An integration of the library for OCPP 1.6 will also be functional with the 2.0.1 upgrade. It works with the same API in MicroOcpp.h.
 
-ISO 15118 defines some use cases which include a message exchange between the charger and server. This library facilitates the integration of ISO 15118 by handling its OCPP-side communication. A public demonstration will follow with the first collaboration on an open OCPP 2.0.1 + ISO 15118 integration.
+ISO 15118 defines some use cases which include a message exchange between the charger and server. This library facilitates the integration of ISO 15118 by handling its OCPP-side communication.
 
-## Contact details
+## Contact
 
 If you have further questions, feel free to reach out!
 
diff --git a/docs/index.md b/docs/index.md
index 11eac9d1..f87f6ccc 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -12,4 +12,4 @@ MicroOcpp is an OCPP client which runs on microcontrollers and enables EVSEs to
 
 <!-- This chapter shows how to kick-start your OCPP project. -->
 
-*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/MicroOcpp) or the [API description](https://github.com/matth-x/MicroOcpp/blob/master/src/MicroOcpp.h) as reference.*
+*Documentation WIP. See the [GitHub Readme](https://github.com/matth-x/MicroOcpp) or the [API description](https://github.com/matth-x/MicroOcpp/blob/main/src/MicroOcpp.h) as reference.*
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 453d8dbe..6fb2d32d 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -96,7 +96,7 @@ struct ChargerCredentials {
  * Initialize the library with a WebSocket connection which is configured with protocol=ocpp1.6
  * (=Connection), EVSE voltage and filesystem configuration. This library requires that you handle
  * establishing the connection and keeping it alive. Please refer to
- * https://github.com/matth-x/MicroOcpp/tree/master/examples/ESP-TLS for an example how to use it.
+ * https://github.com/matth-x/MicroOcpp/tree/main/examples/ESP-TLS for an example how to use it.
  * 
  * This GitHub project also delivers an Connection implementation based on links2004/WebSockets. If
  * you need another WebSockets implementation, you can subclass the Connection class and pass it to

From 20bbfdb39e3e5bb3f6b3ddb902c6a29acefe3d01 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 30 Mar 2024 21:05:07 +0100
Subject: [PATCH 459/549] certificate management fixes, certs C-API rework
 (#274)

* fix cardinality of getInstalledCerts - certType

* avoid installing certs twice

* fix DeleteCertificateRequest parser

* fix input ranges of hash identifier

* rework Certificates C-compat

* fix width of single-digit serialNumbers

* fix building on C
---
 .../Model/Certificates/Certificate.cpp        | 165 ++++++++--
 .../Model/Certificates/Certificate.h          | 147 ++++++---
 .../Model/Certificates/CertificateMbedTLS.cpp | 300 ++++++++----------
 .../Model/Certificates/CertificateMbedTLS.h   |   5 +-
 .../Model/Certificates/Certificate_c.cpp      | 197 ++----------
 .../Model/Certificates/Certificate_c.h        |  94 +-----
 .../Operations/DeleteCertificate.cpp          |  43 ++-
 .../Operations/GetInstalledCertificateIds.cpp |  80 +++--
 .../Operations/InstallCertificate.cpp         |  14 +-
 src/MicroOcpp_c.cpp                           |   4 +-
 src/MicroOcpp_c.h                             |   4 +-
 tests/Certificates.cpp                        |  71 +++--
 12 files changed, 524 insertions(+), 600 deletions(-)

diff --git a/src/MicroOcpp/Model/Certificates/Certificate.cpp b/src/MicroOcpp/Model/Certificates/Certificate.cpp
index a61a88cb..f0f80033 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate.cpp
+++ b/src/MicroOcpp/Model/Certificates/Certificate.cpp
@@ -5,40 +5,159 @@
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 
 #include <string.h>
+#include <stdio.h>
 
-#include <MicroOcpp/Debug.h>
+bool ocpp_cert_equals(const ocpp_cert_hash *h1, const ocpp_cert_hash *h2) {
+    return h1->hashAlgorithm == h2->hashAlgorithm &&
+            h1->serialNumberLen == h2->serialNumberLen && !memcmp(h1->serialNumber, h2->serialNumber, h1->serialNumberLen) &&
+            !memcmp(h1->issuerNameHash, h2->issuerNameHash, HashAlgorithmSize(h1->hashAlgorithm)) &&
+            !memcmp(h1->issuerKeyHash, h2->issuerKeyHash, HashAlgorithmSize(h1->hashAlgorithm));
+}
+
+int ocpp_cert_bytes_to_hex(char *dst, size_t dst_size, const unsigned char *src, size_t src_len) {
+    if (!dst || !dst_size || !src) {
+        return -1;
+    }
+
+    dst[0] = '\0';
 
-using namespace MicroOcpp;
+    size_t hexLen = 2 * src_len; // hex-encoding needs two characters per byte
 
-const char *CertificateHash::getHashAlgorithmCStr() {
-    switch(hashAlgorithm) {
-        case HashAlgorithmEnumType::SHA256:
-            return "SHA256";
-        case HashAlgorithmEnumType::SHA384:
-            return "SHA384";
-        case HashAlgorithmEnumType::SHA512:
-            return "SHA512";
+    if (dst_size < hexLen + 1) { // buf will hold hex-encoding + terminating null
+        return -1;
     }
 
-    MO_DBG_ERR("internal error");
-    return "";
+    for (size_t i = 0; i < src_len; i++) {
+        snprintf(dst, 3, "%02X", src[i]);
+        dst += 2;
+    }
+
+    return (int)hexLen;
 }
 
-const char *CertificateHash::getIssuerNameHash() {
-    return issuerNameHash;
+int ocpp_cert_print_issuerNameHash(const ocpp_cert_hash *src, char *buf, size_t size) {
+    return ocpp_cert_bytes_to_hex(buf, size, src->issuerNameHash, HashAlgorithmSize(src->hashAlgorithm));
+}
+
+int ocpp_cert_print_issuerKeyHash(const ocpp_cert_hash *src, char *buf, size_t size) {
+    return ocpp_cert_bytes_to_hex(buf, size, src->issuerKeyHash, HashAlgorithmSize(src->hashAlgorithm));
+}
+
+int ocpp_cert_print_serialNumber(const ocpp_cert_hash *src, char *buf, size_t size) {
+
+    if (!buf || !size) {
+        return -1;
+    }
+
+    buf[0] = '\0';
+
+    if (!src->serialNumberLen) {
+        return 0;
+    }
+
+    int hexLen = snprintf(buf, size, "%X", src->serialNumber[0]);
+    if (hexLen < 0 || (size_t)hexLen >= size) {
+        return -1;
+    }
+
+    if (src->serialNumberLen > 1) {
+        auto ret = ocpp_cert_bytes_to_hex(buf + (size_t)hexLen, size - (size_t)hexLen, src->serialNumber + 1, src->serialNumberLen - 1);
+        if (ret < 0) {
+            return -1;
+        }
+        hexLen += ret;
+    }
+
+    return hexLen;
+}
+
+int ocpp_cert_hex_to_bytes(unsigned char *dst, size_t dst_size, const char *hex_src) {
+    if (!dst || !dst_size || !hex_src) {
+        return -1;
+    }
+
+    dst[0] = '\0';
+
+    size_t hex_len = strlen(hex_src);
+
+    size_t write_len = (hex_len + 1) / 2;
+
+    if (dst_size < write_len) {
+        return -1;
+    }
+
+    for (size_t i = 0; i < write_len; i++) {
+        char octet [2];
+
+        if (i == 0 && hex_len % 2) {
+            octet[0] = '0';
+            octet[1] = hex_src[2*i];
+        } else {
+            octet[0] = hex_src[2*i];
+            octet[1] = hex_src[2*i + 1];
+        }
+
+        unsigned char val = 0;
+
+        for (size_t j = 0; j < 2; j++) {
+            char c = octet[j];
+            if (c >= '0' && c <= '9') {
+                val += c - '0';
+            } else if (c >= 'A' && c <= 'F') {
+                val += (c - 'A') + 0xA;
+            } else if (c >= 'a' && c <= 'f') {
+                val += (c - 'a') + 0xA;
+            } else {
+                return -1;
+            }
+
+            if (j == 0) {
+                val *= 0x10;
+            }
+        }
+
+        dst[i] = val;
+    }
+
+    return (int)write_len;
 }
 
-const char *CertificateHash::getIssuerKeyHash() {
-    return issuerKeyHash;
+int ocpp_cert_set_issuerNameHash(ocpp_cert_hash *dst, const char *hex_src, HashAlgorithmType hash_algorithm) {
+    auto ret = ocpp_cert_hex_to_bytes(dst->issuerNameHash, sizeof(dst->issuerNameHash), hex_src);
+
+    if (ret < 0) {
+        return ret;
+    }
+
+    if (ret != HashAlgorithmSize(hash_algorithm)) {
+        return -1;
+    }
+
+    return ret;
 }
 
-const char *CertificateHash::getSerialNumber() {
-    return serialNumber;
+int ocpp_cert_set_issuerKeyHash(ocpp_cert_hash *dst, const char *hex_src, HashAlgorithmType hash_algorithm) {
+    auto ret = ocpp_cert_hex_to_bytes(dst->issuerKeyHash, sizeof(dst->issuerNameHash), hex_src);
+
+    if (ret < 0) {
+        return ret;
+    }
+
+    if (ret != HashAlgorithmSize(hash_algorithm)) {
+        return -1;
+    }
+
+    return ret;
 }
 
-bool CertificateHash::equals(const CertificateHash& other) {
-    return hashAlgorithm == other.hashAlgorithm &&
-            !strncmp(serialNumber, other.serialNumber, sizeof(serialNumber)) &&
-            !strncmp(issuerNameHash, other.issuerNameHash, sizeof(issuerNameHash)) &&
-            !strncmp(issuerKeyHash, other.issuerKeyHash, sizeof(issuerKeyHash));
+int ocpp_cert_set_serialNumber(ocpp_cert_hash *dst, const char *hex_src) {
+    auto ret = ocpp_cert_hex_to_bytes(dst->serialNumber, sizeof(dst->serialNumber), hex_src);
+
+    if (ret < 0) {
+        return ret;
+    }
+
+    dst->serialNumberLen = (size_t)ret;
+
+    return ret;
 }
diff --git a/src/MicroOcpp/Model/Certificates/Certificate.h b/src/MicroOcpp/Model/Certificates/Certificate.h
index 137e3658..fc954b5c 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate.h
+++ b/src/MicroOcpp/Model/Certificates/Certificate.h
@@ -5,85 +5,130 @@
 #ifndef MO_CERTIFICATE_H
 #define MO_CERTIFICATE_H
 
-#include <vector>
-#include <stdint.h>
+#include <stddef.h>
 
-namespace MicroOcpp {
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 #define MO_MAX_CERT_SIZE 5500 //limit of field `certificate` in InstallCertificateRequest, not counting terminating '\0'. See OCPP 2.0.1 part 2 Data Type 1.30.1
 
 /*
  * See OCPP 2.0.1 part 2 Data Type 3.36
  */
-enum class GetCertificateIdType : uint8_t {
-    V2GRootCertificate,
-    MORootCertificate,
-    CSMSRootCertificate,
-    V2GCertificateChain,
-    ManufacturerRootCertificate
-};
+typedef enum GetCertificateIdType {
+    GetCertificateIdType_V2GRootCertificate,
+    GetCertificateIdType_MORootCertificate,
+    GetCertificateIdType_CSMSRootCertificate,
+    GetCertificateIdType_V2GCertificateChain,
+    GetCertificateIdType_ManufacturerRootCertificate
+}   GetCertificateIdType;
 
 /*
  * See OCPP 2.0.1 part 2 Data Type 3.40
  */
-enum class GetInstalledCertificateStatus : uint8_t {
-    Accepted,
-    NotFound
-};
+typedef enum GetInstalledCertificateStatus {
+    GetInstalledCertificateStatus_Accepted,
+    GetInstalledCertificateStatus_NotFound
+}   GetInstalledCertificateStatus;
 
 /*
  * See OCPP 2.0.1 part 2 Data Type 3.45
  */
-enum class InstallCertificateType : uint8_t {
-    V2GRootCertificate,
-    MORootCertificate,
-    CSMSRootCertificate,
-    ManufacturerRootCertificate
-};
+typedef enum InstallCertificateType {
+    InstallCertificateType_V2GRootCertificate,
+    InstallCertificateType_MORootCertificate,
+    InstallCertificateType_CSMSRootCertificate,
+    InstallCertificateType_ManufacturerRootCertificate
+}   InstallCertificateType;
 
 /*
  * See OCPP 2.0.1 part 2 Data Type 3.28
  */
-enum class InstallCertificateStatus : uint8_t {
-    Accepted,
-    Rejected,
-    Failed
-};
+typedef enum InstallCertificateStatus {
+    InstallCertificateStatus_Accepted,
+    InstallCertificateStatus_Rejected,
+    InstallCertificateStatus_Failed
+}   InstallCertificateStatus;
 
 /*
  * See OCPP 2.0.1 part 2 Data Type 3.28
  */
-enum class DeleteCertificateStatus : uint8_t {
-    Accepted,
-    Failed,
-    NotFound
-};
+typedef enum DeleteCertificateStatus {
+    DeleteCertificateStatus_Accepted,
+    DeleteCertificateStatus_Failed,
+    DeleteCertificateStatus_NotFound
+}   DeleteCertificateStatus;
 
 /*
  * See OCPP 2.0.1 part 2 Data Type 3.42
  */
-enum class HashAlgorithmEnumType : uint8_t {
-    SHA256,
-    SHA384,
-    SHA512
-};
+typedef enum HashAlgorithmType {
+    HashAlgorithmType_SHA256,
+    HashAlgorithmType_SHA384,
+    HashAlgorithmType_SHA512
+}   HashAlgorithmType;
+
+// Convert HashAlgorithmType into string
+#define HashAlgorithmLabel(alg) (alg == HashAlgorithmType_SHA256 ? "SHA256" : \
+                                 alg == HashAlgorithmType_SHA384 ? "SHA384" : \
+                                 alg == HashAlgorithmType_SHA512 ? "SHA512" : "_Undefined")
+
+// Convert HashAlgorithmType into hash size in bytes (e.g. SHA256 -> 32)
+#define HashAlgorithmSize(alg) (alg == HashAlgorithmType_SHA256 ? 32 : \
+                                alg == HashAlgorithmType_SHA384 ? 48 : \
+                                alg == HashAlgorithmType_SHA512 ? 64 : 0)
+
+typedef struct ocpp_cert_hash {
+    enum HashAlgorithmType hashAlgorithm;
+
+    unsigned char issuerNameHash [64]; // hash buf can hold 64 bytes (SHA512). Actual hash size is determined by hash algorithm
+    unsigned char issuerKeyHash [64];
+    unsigned char serialNumber [20];
+    size_t serialNumberLen; // length of serial number in bytes
+} ocpp_cert_hash;
+
+bool ocpp_cert_equals(const ocpp_cert_hash *h1, const ocpp_cert_hash *h2);
+
+// Max size of hex-encoded cert hash components
+#define MO_CERT_HASH_ISSUER_NAME_KEY_SIZE (128 + 1) // hex-encoding needs two characters per byte + terminating null-byte
+#define MO_CERT_HASH_SERIAL_NUMBER_SIZE (40 + 1)
 
 /*
- * See OCPP 2.0.1 part 2 Data Type 2.6
+ * Print the issuerNameHash of ocpp_cert_hash as hex-encoded string (e.g. "0123AB") into buf. Bufsize MO_CERT_HASH_ISSUER_NAME_KEY_SIZE is always enough
+ *
+ * Returns the length not counting the terminating 0 on success, -1 on failure
  */
-struct CertificateHash {
-    HashAlgorithmEnumType hashAlgorithm;
-    char issuerNameHash [128 + 1];
-    char issuerKeyHash [128 + 1];
-    char serialNumber [40 + 1];
-
-    const char *getHashAlgorithmCStr();
-    const char *getIssuerNameHash();
-    const char *getIssuerKeyHash();
-    const char *getSerialNumber();
-
-    bool equals(const CertificateHash& other);
-};
+int ocpp_cert_print_issuerNameHash(const ocpp_cert_hash *src, char *buf, size_t size);
+
+/*
+ * Print the issuerKeyHash of ocpp_cert_hash as hex-encoded string (e.g. "0123AB") into buf. Bufsize MO_CERT_HASH_ISSUER_NAME_KEY_SIZE is always enough
+ *
+ * Returns the length not counting the terminating 0 on success, -1 on failure
+ */
+int ocpp_cert_print_issuerKeyHash(const ocpp_cert_hash *src, char *buf, size_t size);
+
+/*
+ * Print the serialNumber of ocpp_cert_hash as hex-encoded string without leading 0s (e.g. "123AB") into buf. Bufsize MO_CERT_HASH_SERIAL_NUMBER_SIZE is always enough
+ *
+ * Returns the length not counting the terminating 0 on success, -1 on failure
+ */
+int ocpp_cert_print_serialNumber(const ocpp_cert_hash *src, char *buf, size_t size);
+
+int ocpp_cert_set_issuerNameHash(ocpp_cert_hash *dst, const char *hex_src, HashAlgorithmType hash_algorithm);
+
+int ocpp_cert_set_issuerKeyHash(ocpp_cert_hash *dst, const char *hex_src, HashAlgorithmType hash_algorithm);
+
+int ocpp_cert_set_serialNumber(ocpp_cert_hash *dst, const char *hex_src);
+
+#ifdef __cplusplus
+} //extern "C"
+
+#include <vector>
+
+namespace MicroOcpp {
+
+using CertificateHash = ocpp_cert_hash;
 
 /*
  * See OCPP 2.0.1 part 2 Data Type 2.5
@@ -99,11 +144,13 @@ struct CertificateChainHash {
  */
 class CertificateStore {
 public:
-    virtual GetInstalledCertificateStatus getCertificateIds(GetCertificateIdType certificateType, std::vector<CertificateChainHash>& out) = 0;
+    virtual GetInstalledCertificateStatus getCertificateIds(const std::vector<GetCertificateIdType>& certificateType, std::vector<CertificateChainHash>& out) = 0;
     virtual DeleteCertificateStatus deleteCertificate(const CertificateHash& hash) = 0;
     virtual InstallCertificateStatus installCertificate(InstallCertificateType certificateType, const char *certificate) = 0;
 };
 
 } //namespace MicroOcpp
 
+#endif //__cplusplus
+
 #endif
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
index 4bcce8e2..36a773d5 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
@@ -11,14 +11,11 @@
 #include <mbedtls/version.h>
 #include <mbedtls/x509_crt.h>
 #include <mbedtls/md.h>
-#include <mbedtls/oid.h>
 #include <mbedtls/error.h>
 
 #include <MicroOcpp/Debug.h>
 
-#define MO_X509_OID_COMMON_NAME "2.5.4.3" //object-identifier of x509 common-name
-
-bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmEnumType_c hashAlg, char *issuerNameHash, char *issuerKeyHash, char *serialNumber) {
+bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmType hashAlg, ocpp_cert_hash *out) {
 
     mbedtls_x509_crt cacert;
     mbedtls_x509_crt_init(&cacert);
@@ -37,63 +34,18 @@ bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmEnumT
         return false;
     }
 
-    const unsigned char *subject_cn_p = nullptr;
-    size_t subject_cn_len = 0;
-    for (mbedtls_x509_name *it = &cacert.subject; it; it = it->next) {
-        char oid_cstr [50];
-        if ((ret = mbedtls_oid_get_numeric_string(oid_cstr, 50, &it->oid)) < 0) {
-            MO_DBG_ERR("internal error: %i", ret);
-            continue; //there is an oid which exceeds the bufsize, but the target oid does fit so continue
-        }
-
-        if (!strcmp(oid_cstr, MO_X509_OID_COMMON_NAME)) {
-            subject_cn_p = it->val.p;
-            subject_cn_len = it->val.len;
-            break;
-        }
-    }
-
-    if (!subject_cn_p || !subject_cn_len) {
-        MO_DBG_ERR("could not find subject common name");
-        return false;
-    }
-
-    const unsigned char *issuer_cn_p = nullptr;
-    size_t issuer_cn_len = 0;
-    for (mbedtls_x509_name *it = &cacert.issuer; it; it = it->next) {
-        char oid_cstr [50];
-        if ((ret = mbedtls_oid_get_numeric_string(oid_cstr, 50, &it->oid)) < 0) {
-            MO_DBG_ERR("internal error: %i", ret);
-            continue; //there is an oid which exceeds the bufsize, but the target oid does fit so continue
-        }
-
-        if (!strcmp(oid_cstr, MO_X509_OID_COMMON_NAME)) {
-            issuer_cn_p = it->val.p;
-            issuer_cn_len = it->val.len;
-            break;
-        }
-    }
-
-    if (!issuer_cn_p || !issuer_cn_len) {
-        MO_DBG_ERR("could not find issuer common name");
-        return false;
-    }
+    out->hashAlgorithm = hashAlg;
 
-    if (subject_cn_len != issuer_cn_len || strncmp((const char*) subject_cn_p, (const char*) issuer_cn_p, subject_cn_len)) {
-        MO_DBG_ERR("only support self-signed root certs");
-        return false;
-    }
-    
     mbedtls_md_type_t hash_alg_mbed;
 
     switch (hashAlg) {
-        case HashAlgorithmEnumType_c::ENUM_HA_SHA256:
+        case HashAlgorithmType_SHA256:
             hash_alg_mbed = MBEDTLS_MD_SHA256;
             break;
-        case HashAlgorithmEnumType_c::ENUM_HA_SHA384:
+        case HashAlgorithmType_SHA384:
             hash_alg_mbed = MBEDTLS_MD_SHA384;
             break;
-        case HashAlgorithmEnumType_c::ENUM_HA_SHA512:
+        case HashAlgorithmType_SHA512:
             hash_alg_mbed = MBEDTLS_MD_SHA512;
             break;
         default:
@@ -109,46 +61,52 @@ bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmEnumT
         return false;
     }
 
-    unsigned char hash_buf [64]; //at most 512 Bits (SHA512), equalling 64 Bytes
-
     size_t hash_size = mbedtls_md_get_size(md_info);
-    if (hash_size > sizeof(hash_buf)) {
+    if (hash_size > sizeof(out->issuerNameHash)) {
         MO_DBG_ERR("internal error");
         return false;
     }
 
-    if ((ret = mbedtls_md(md_info, issuer_cn_p, issuer_cn_len, hash_buf))) {
+    if (!cacert.issuer_raw.p) {
+        MO_DBG_ERR("missing issuer name");
+        return false;
+    }
+
+    if ((ret = mbedtls_md(md_info, cacert.issuer_raw.p, cacert.issuer_raw.len, out->issuerNameHash))) {
         MO_DBG_ERR("mbedtls_md: %i", ret);
         return false;
     }
 
-    for (size_t i = 0; i < hash_size; i ++) {
-        sprintf(issuerNameHash + 2 * i, "%02X", hash_buf[i]);
+    // copy public key into pk_buf to create issuerKeyHash
+    size_t pk_size = cacert.pk_raw.len;
+    unsigned char *pk_buf = new unsigned char[pk_size];
+    if (!pk_buf) {
+        MO_DBG_ERR("OOM (alloc size %zu)", pk_size);
+        return false;
     }
+    int pk_len = 0;
+    unsigned char *pk_p = pk_buf + pk_size;
 
-    unsigned char *pk_p;
-    size_t pk_len;
+    bool pk_err = false;
 
-#if MBEDTLS_VERSION_MAJOR == 2 && MBEDTLS_VERSION_MINOR <= 16
-    unsigned char pk_buf [256];
-    if ((ret = mbedtls_pk_write_pubkey_pem(&cacert.pk, pk_buf, 256)) < 0) {
-        MO_DBG_ERR("mbedtls_md: %i", ret);
-        return false;
+    if ((pk_len = mbedtls_pk_write_pubkey(&pk_p, pk_buf, &cacert.pk)) <= 0) {
+        pk_err = true;
+        char err [100];
+        mbedtls_strerror(ret, err, 100);
+        MO_DBG_ERR("mbedtls_pk_write_pubkey_pem: %i -- %s", pk_len, err);
+        // return after pk_buf has been freed
     }
-    pk_p = pk_buf;
-    pk_len = strnlen((const char*)pk_buf, 256);
-#else //tested on MbedTLS 2.28.1
-    pk_p = cacert.pk_raw.p;
-    pk_len = cacert.pk_raw.len;
-#endif // MbedTLS version
-
-    if ((ret = mbedtls_md(md_info, pk_p, pk_len, hash_buf))) {
-        MO_DBG_ERR("mbedtls_md: %i", ret);
-        return false;
+
+    if (!pk_err) {
+        if ((ret = mbedtls_md(md_info, pk_p, pk_len, out->issuerKeyHash))) {
+            pk_err = true;
+            MO_DBG_ERR("mbedtls_md: %i", ret);
+        }
     }
 
-    for (size_t i = 0; i < hash_size; i ++) {
-        sprintf(issuerKeyHash + 2*i, "%02X", hash_buf[i]);
+    delete[] pk_buf;
+    if (pk_err) {
+        return false;
     }
 
     size_t serial_begin = 0; //trunicate leftmost 0x00 bytes
@@ -158,9 +116,8 @@ bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmEnumT
         }
     }
 
-    for (size_t i = 0; i < std::min(cacert.serial.len - serial_begin, (size_t) ((MO_CERT_HASH_SERIAL_NUMBER_SIZE - 1)/2)); i++) {
-        sprintf(serialNumber + 2*i, "%02X", cacert.serial.p[i + serial_begin]);
-    }
+    out->serialNumberLen = std::min(cacert.serial.len - serial_begin, sizeof(out->serialNumber));
+    memcpy(out->serialNumber, cacert.serial.p + serial_begin, out->serialNumberLen);
 
     return true;
 }
@@ -171,7 +128,7 @@ class CertificateStoreMbedTLS : public CertificateStore {
 private:
     std::shared_ptr<FilesystemAdapter> filesystem;
 
-    bool getCertHash(const char *fn, HashAlgorithmEnumType hashAlg, CertificateHash& out) {
+    bool getCertHash(const char *fn, HashAlgorithmType hashAlg, CertificateHash& out) {
         size_t fsize;
         if (filesystem->stat(fn, &fsize) != 0) {
             MO_DBG_ERR("certificate does not exist: %s", fn);
@@ -206,7 +163,7 @@ class CertificateStoreMbedTLS : public CertificateStore {
         buf[fsize] = '\0';
 
         if (success) {
-            success &= getCertHash(buf, fsize, hashAlg, out);
+            success &= ocpp_get_cert_hash(buf, fsize, hashAlg, &out);
         }
 
         if (!success) {
@@ -217,82 +174,62 @@ class CertificateStoreMbedTLS : public CertificateStore {
         delete[] buf;
         return success;
     }
-
-    bool getCertHash(const unsigned char *buf, size_t len, HashAlgorithmEnumType hashAlg, CertificateHash& out) {
-        
-        HashAlgorithmEnumType_c ha;
-
-        switch (hashAlg) {
-            case HashAlgorithmEnumType::SHA256:
-                ha = ENUM_HA_SHA256;
-                break;
-            case HashAlgorithmEnumType::SHA384:
-                ha = ENUM_HA_SHA384;
-                break;
-            case HashAlgorithmEnumType::SHA512:
-                ha = ENUM_HA_SHA512;
-                break;
-            default:
-                MO_DBG_ERR("internal error");
-                return false;
-        }
-
-        out.hashAlgorithm = hashAlg;
-        return ocpp_get_cert_hash(buf, len, ha, out.issuerNameHash, out.issuerKeyHash, out.serialNumber);
-    }
 public:
     CertificateStoreMbedTLS(std::shared_ptr<FilesystemAdapter> filesystem)
             : filesystem(filesystem) {
 
     }
 
-    GetInstalledCertificateStatus getCertificateIds(GetCertificateIdType certificateType, std::vector<CertificateChainHash>& out) override {
-        const char *certTypeFnStr = nullptr;
-        switch (certificateType) {
-            case GetCertificateIdType::CSMSRootCertificate:
-                certTypeFnStr = MO_CERT_FN_CSMS_ROOT;
-                break;
-            case GetCertificateIdType::ManufacturerRootCertificate:
-                certTypeFnStr = MO_CERT_FN_MANUFACTURER_ROOT;
-                break;
-            default:
-                MO_DBG_ERR("only CSMS / Manufacturer root supported");
-                break;
-        }
-
-        if (!certTypeFnStr) {
-            return GetInstalledCertificateStatus::NotFound;
-        }
-
+    GetInstalledCertificateStatus getCertificateIds(const std::vector<GetCertificateIdType>& certificateType, std::vector<CertificateChainHash>& out) override {
         out.clear();
 
-        for (size_t i = 0; i < MO_CERT_STORE_SIZE; i++) {
-            char fn [MO_MAX_PATH_SIZE];
-            if (!printCertFn(certTypeFnStr, i, fn, MO_MAX_PATH_SIZE)) {
-                MO_DBG_ERR("internal error");
-                return GetInstalledCertificateStatus::NotFound;
+        for (auto certType : certificateType) {
+            const char *certTypeFnStr = nullptr;
+            switch (certType) {
+                case GetCertificateIdType_CSMSRootCertificate:
+                    certTypeFnStr = MO_CERT_FN_CSMS_ROOT;
+                    break;
+                case GetCertificateIdType_ManufacturerRootCertificate:
+                    certTypeFnStr = MO_CERT_FN_MANUFACTURER_ROOT;
+                    break;
+                default:
+                    MO_DBG_ERR("only CSMS / Manufacturer root supported");
+                    break;
             }
 
-            size_t msize;
-            if (filesystem->stat(fn, &msize) != 0) {
-                continue; //no cert installed at this slot
+            if (!certTypeFnStr) {
+                continue;
             }
 
-            out.emplace_back();
-            CertificateChainHash& rootCert = out.back();
+            for (size_t i = 0; i < MO_CERT_STORE_SIZE; i++) {
+                char fn [MO_MAX_PATH_SIZE];
+                if (!printCertFn(certTypeFnStr, i, fn, MO_MAX_PATH_SIZE)) {
+                    MO_DBG_ERR("internal error");
+                    out.clear();
+                    break;
+                }
 
-            rootCert.certificateType = certificateType;
+                size_t msize;
+                if (filesystem->stat(fn, &msize) != 0) {
+                    continue; //no cert installed at this slot
+                }
 
-            if (!getCertHash(fn, HashAlgorithmEnumType::SHA256, rootCert.certificateHashData)) {
-                MO_DBG_ERR("could not create hash: %s", fn);
-                out.pop_back();
-                continue;
+                out.emplace_back();
+                CertificateChainHash& rootCert = out.back();
+
+                rootCert.certificateType = certType;
+
+                if (!getCertHash(fn, HashAlgorithmType_SHA256, rootCert.certificateHashData)) {
+                    MO_DBG_ERR("could not create hash: %s", fn);
+                    out.pop_back();
+                    continue;
+                }
             }
         }
 
         return out.empty() ?
-                GetInstalledCertificateStatus::NotFound :
-                GetInstalledCertificateStatus::Accepted;
+                GetInstalledCertificateStatus_NotFound :
+                GetInstalledCertificateStatus_Accepted;
     }
 
     DeleteCertificateStatus deleteCertificate(const CertificateHash& hash) override {
@@ -306,7 +243,7 @@ class CertificateStoreMbedTLS : public CertificateStore {
 
                 if (!printCertFn(certTypeFnStr, i, fn, MO_MAX_PATH_SIZE)) {
                     MO_DBG_ERR("internal error");
-                    return DeleteCertificateStatus::Failed;
+                    return DeleteCertificateStatus_Failed;
                 }
 
                 size_t msize;
@@ -321,52 +258,79 @@ class CertificateStoreMbedTLS : public CertificateStore {
                     continue;
                 }
 
-                if (probe.equals(hash)) {
+                if (ocpp_cert_equals(&probe, &hash)) {
                     //found, delete
 
                     bool success = filesystem->remove(fn);
                     return success ?
-                        DeleteCertificateStatus::Accepted :
-                        DeleteCertificateStatus::Failed;
+                        DeleteCertificateStatus_Accepted :
+                        DeleteCertificateStatus_Failed;
                 }
             }
         }
 
         return err ?
-            DeleteCertificateStatus::Failed :
-            DeleteCertificateStatus::NotFound;
+            DeleteCertificateStatus_Failed :
+            DeleteCertificateStatus_NotFound;
     }
 
     InstallCertificateStatus installCertificate(InstallCertificateType certificateType, const char *certificate) override {
-        const char *certTypeFnStr = nullptr;
+        const char *certTypeFnStr;
+        GetCertificateIdType certTypeGetType;
         switch (certificateType) {
-            case InstallCertificateType::CSMSRootCertificate:
+            case InstallCertificateType_CSMSRootCertificate:
                 certTypeFnStr = MO_CERT_FN_CSMS_ROOT;
+                certTypeGetType = GetCertificateIdType_CSMSRootCertificate;
                 break;
-            case InstallCertificateType::ManufacturerRootCertificate:
+            case InstallCertificateType_ManufacturerRootCertificate:
                 certTypeFnStr = MO_CERT_FN_MANUFACTURER_ROOT;
+                certTypeGetType = GetCertificateIdType_ManufacturerRootCertificate;
                 break;
             default:
                 MO_DBG_ERR("only CSMS / Manufacturer root supported");
-                break;
+                return InstallCertificateStatus_Failed;
         }
 
-        if (!certTypeFnStr) {
-            return InstallCertificateStatus::Failed;
+        //check if this implementation is able to parse incoming cert
+        CertificateHash certId;
+        if (!ocpp_get_cert_hash((const unsigned char*)certificate, strlen(certificate), HashAlgorithmType_SHA256, &certId)) {
+            MO_DBG_ERR("unable to parse cert");
+            return InstallCertificateStatus_Rejected;
         }
 
-        //check if this implementation is able to parse incoming cert
+#if MO_DBG_LEVEL >= MO_DL_DEBUG
         {
-            CertificateHash certId;
-            if (!getCertHash((const unsigned char*)certificate, strlen(certificate), HashAlgorithmEnumType::SHA256, certId)) {
-                MO_DBG_ERR("unable to parse cert");
-                return InstallCertificateStatus::Rejected;
-            }
             MO_DBG_DEBUG("Cert ID:");
-            MO_DBG_DEBUG("hashAlgorithm: %s", certId.getHashAlgorithmCStr());
-            MO_DBG_DEBUG("issuerNameHash: %s", certId.issuerNameHash);
-            MO_DBG_DEBUG("issuerKeyHash: %s", certId.issuerKeyHash);
-            MO_DBG_DEBUG("serialNumber: %s", certId.serialNumber);
+            MO_DBG_DEBUG("hashAlgorithm: %s", HashAlgorithmLabel(certId.hashAlgorithm));
+            char buf [MO_CERT_HASH_ISSUER_NAME_KEY_SIZE];
+
+            ocpp_cert_print_issuerNameHash(&certId, buf, sizeof(buf));
+            MO_DBG_DEBUG("issuerNameHash: %s", buf);
+
+            ocpp_cert_print_issuerKeyHash(&certId, buf, sizeof(buf));
+            MO_DBG_DEBUG("issuerKeyHash: %s", buf);
+
+            ocpp_cert_print_serialNumber(&certId, buf, sizeof(buf));
+            MO_DBG_DEBUG("serialNumber: %s", buf);
+        }
+#endif // MO_DBG_LEVEL >= MO_DL_DEBUG
+
+        //check if cert is already stored on flash
+        std::vector<CertificateChainHash> installedCerts;
+        auto ret = getCertificateIds({certTypeGetType}, installedCerts);
+        if (ret == GetInstalledCertificateStatus_Accepted) {
+            for (auto &installedCert : installedCerts) {
+                if (ocpp_cert_equals(&installedCert.certificateHashData, &certId)) {
+                    MO_DBG_INFO("certificate already installed");
+                    return InstallCertificateStatus_Accepted;
+                }
+                for (auto& installedChild : installedCert.childCertificateHashData) {
+                    if (ocpp_cert_equals(&installedChild, &certId)) {
+                        MO_DBG_INFO("certificate already installed");
+                        return InstallCertificateStatus_Accepted;
+                    }
+                }
+            }
         }
 
         char fn [MO_MAX_PATH_SIZE] = {'\0'}; //cert fn on flash storage
@@ -375,7 +339,7 @@ class CertificateStoreMbedTLS : public CertificateStore {
         for (size_t i = 0; i < MO_CERT_STORE_SIZE; i++) {
             if (!printCertFn(certTypeFnStr, i, fn, MO_MAX_PATH_SIZE)) {
                 MO_DBG_ERR("invalid cert fn");
-                return InstallCertificateStatus::Failed;
+                return InstallCertificateStatus_Failed;
             }
 
             size_t msize;
@@ -390,13 +354,13 @@ class CertificateStoreMbedTLS : public CertificateStore {
 
         if (fn[0] == '\0') {
             MO_DBG_ERR("exceed maximum number of certs; must delete before");
-            return InstallCertificateStatus::Rejected;
+            return InstallCertificateStatus_Rejected;
         }
 
         auto file = filesystem->open(fn, "w");
         if (!file) {
             MO_DBG_ERR("could not open file");
-            return InstallCertificateStatus::Failed;
+            return InstallCertificateStatus_Failed;
         }
 
         size_t cert_len = strlen(certificate);
@@ -405,11 +369,11 @@ class CertificateStoreMbedTLS : public CertificateStore {
             MO_DBG_ERR("file write error");
             file.reset();
             filesystem->remove(fn);
-            return InstallCertificateStatus::Failed;
+            return InstallCertificateStatus_Failed;
         }
 
         MO_DBG_INFO("installed certificate: %s", fn);
-        return InstallCertificateStatus::Accepted;
+        return InstallCertificateStatus_Accepted;
     }
 };
 
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
index 1ecd52ee..4cb7e86b 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
@@ -18,20 +18,19 @@
 /*
  * Provide certificate interpreter to facilitate cert store in C. A full implementation is only available for C++
  */
-#include <MicroOcpp/Model/Certificates/Certificate_c.h>
+#include <MicroOcpp/Model/Certificates/Certificate.h>
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-bool ocpp_get_cert_hash(const unsigned char *cert, size_t len, enum HashAlgorithmEnumType_c hashAlg, ocpp_certificate_hash *out);
+bool ocpp_get_cert_hash(const unsigned char *cert, size_t len, enum HashAlgorithmType hashAlg, ocpp_cert_hash *out);
 
 #ifdef __cplusplus
 } //extern "C"
 
 #include <memory>
 
-#include <MicroOcpp/Model/Certificates/Certificate.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 
 #ifndef MO_CERT_FN_PREFIX
diff --git a/src/MicroOcpp/Model/Certificates/Certificate_c.cpp b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
index 46d0875a..0d93791f 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
+++ b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
@@ -5,6 +5,8 @@
 #include <MicroOcpp/Model/Certificates/Certificate_c.h>
 #include <MicroOcpp/Debug.h>
 
+#include <string.h>
+
 namespace MicroOcpp {
 
 /*
@@ -12,104 +14,35 @@ namespace MicroOcpp {
  */
 class CertificateStoreC : public CertificateStore {
 private:
-    ocpp_certificate_store *certstore = nullptr;
+    ocpp_cert_store *certstore = nullptr;
 public:
-    CertificateStoreC(ocpp_certificate_store *certstore) : certstore(certstore) {
+    CertificateStoreC(ocpp_cert_store *certstore) : certstore(certstore) {
 
     }
 
     ~CertificateStoreC() = default;
 
-    GetInstalledCertificateStatus getCertificateIds(GetCertificateIdType certificateType, std::vector<CertificateChainHash>& out) override {
-        GetCertificateIdType_c ct_c;
-        switch (certificateType) {
-            case GetCertificateIdType::V2GRootCertificate:
-                ct_c = ENUM_GCI_V2GRootCertificate;
-                break;
-            case GetCertificateIdType::MORootCertificate:
-                ct_c = ENUM_GCI_MORootCertificate;
-                break;
-            case GetCertificateIdType::CSMSRootCertificate:
-                ct_c = ENUM_GCI_CSMSRootCertificate;
-                break;
-            case GetCertificateIdType::V2GCertificateChain:
-                ct_c = ENUM_GCI_V2GCertificateChain;
-                break;
-            case GetCertificateIdType::ManufacturerRootCertificate:
-                ct_c = ENUM_GCI_ManufacturerRootCertificate;
-                break;
-            default:
-                MO_DBG_ERR("internal error");
-                return GetInstalledCertificateStatus::NotFound;
-        }
+    GetInstalledCertificateStatus getCertificateIds(const std::vector<GetCertificateIdType>& certificateType, std::vector<CertificateChainHash>& out) override {
+        out.clear();
 
-        ocpp_certificate_chain_hash *cch;
+        ocpp_cert_chain_hash *cch;
 
-        auto ret = certstore->getCertificateIds(certstore->user_data, ct_c, &cch);
-        if (ret == ENUM_GICS_NotFound || !cch) {
-            return GetInstalledCertificateStatus::NotFound;
+        auto ret = certstore->getCertificateIds(certstore->user_data, &certificateType[0], certificateType.size(), &cch);
+        if (ret == GetInstalledCertificateStatus_NotFound || !cch) {
+            return GetInstalledCertificateStatus_NotFound;
         }
 
         bool err = false;
         
-        for (ocpp_certificate_chain_hash *it = cch; it && !err; it = it->next) {
+        for (ocpp_cert_chain_hash *it = cch; it && !err; it = it->next) {
             out.emplace_back();
             auto &chd_el = out.back();
-            switch (it->certificateType) {
-                case ENUM_GCI_V2GRootCertificate:
-                    chd_el.certificateType = GetCertificateIdType::V2GRootCertificate;
-                    break;
-                case ENUM_GCI_MORootCertificate:
-                    chd_el.certificateType = GetCertificateIdType::MORootCertificate;
-                    break;
-                case ENUM_GCI_CSMSRootCertificate:
-                    chd_el.certificateType = GetCertificateIdType::CSMSRootCertificate;
-                    break;
-                case ENUM_GCI_V2GCertificateChain:
-                    chd_el.certificateType = GetCertificateIdType::V2GCertificateChain;
-                    break;
-                case ENUM_GCI_ManufacturerRootCertificate:
-                    chd_el.certificateType = GetCertificateIdType::ManufacturerRootCertificate;
-                    break;
-                default:
-                    MO_DBG_ERR("internal error");
-                    err = true;
-                    break;
-            }
-
-            switch (it->certificateHashData.hashAlgorithm) {
-                case ENUM_HA_SHA256:
-                    chd_el.certificateHashData.hashAlgorithm = HashAlgorithmEnumType::SHA256;
-                    break;
-                case ENUM_HA_SHA384:
-                    chd_el.certificateHashData.hashAlgorithm = HashAlgorithmEnumType::SHA384;
-                    break;
-                case ENUM_HA_SHA512:
-                    chd_el.certificateHashData.hashAlgorithm = HashAlgorithmEnumType::SHA512;
-                    break;
-                default:
-                    MO_DBG_ERR("internal error");
-                    err = true;
-                    break;
-            }
-
-            bool success = true;
-            int ret;
-            ret = snprintf(chd_el.certificateHashData.issuerNameHash, sizeof(chd_el.certificateHashData.issuerNameHash), "%s", it->certificateHashData.issuerNameHash);
-            success &= ret >= 0 && (size_t)ret < sizeof(chd_el.certificateHashData.issuerNameHash);
-            ret = snprintf(chd_el.certificateHashData.issuerKeyHash, sizeof(chd_el.certificateHashData.issuerKeyHash), "%s", it->certificateHashData.issuerKeyHash);
-            success &= ret >= 0 && (size_t)ret < sizeof(chd_el.certificateHashData.issuerKeyHash);
-            ret = snprintf(chd_el.certificateHashData.serialNumber, sizeof(chd_el.certificateHashData.serialNumber), "%s", it->certificateHashData.serialNumber);
-            success &= ret >= 0 && (size_t)ret < sizeof(chd_el.certificateHashData.serialNumber);
-
-            if (!success) {
-                MO_DBG_ERR("error copying C-style struct");
-                err = true;
-            }
+            chd_el.certificateType = it->certType;
+            memcpy(&chd_el.certificateHashData, &it->certHashData, sizeof(ocpp_cert_hash));
         }
 
         while (cch) {
-            ocpp_certificate_chain_hash *el = cch;
+            ocpp_cert_chain_hash *el = cch;
             cch = cch->next;
             el->invalidate(el);
         }
@@ -119,112 +52,20 @@ class CertificateStoreC : public CertificateStore {
         }
 
         return out.empty() ?
-                GetInstalledCertificateStatus::NotFound :
-                GetInstalledCertificateStatus::Accepted;
+                GetInstalledCertificateStatus_NotFound :
+                GetInstalledCertificateStatus_Accepted;
     }
 
     DeleteCertificateStatus deleteCertificate(const CertificateHash& hash) override {
-        ocpp_certificate_hash ch;
-
-        HashAlgorithmEnumType_c ha;
-
-        switch (hash.hashAlgorithm) {
-            case HashAlgorithmEnumType::SHA256:
-                ha = ENUM_HA_SHA256;
-                break;
-            case HashAlgorithmEnumType::SHA384:
-                ha = ENUM_HA_SHA384;
-                break;
-            case HashAlgorithmEnumType::SHA512:
-                ha = ENUM_HA_SHA512;
-                break;
-            default:
-                MO_DBG_ERR("internal error");
-                return DeleteCertificateStatus::Failed;
-        }
-
-        ch.hashAlgorithm = ha;
-
-        bool success = true;
-        int ret;
-        ret = snprintf(ch.issuerNameHash, sizeof(ch.issuerNameHash), "%s", hash.issuerNameHash);
-        success &= ret >= 0 && (size_t)ret < sizeof(ch.issuerNameHash);
-        ret = snprintf(ch.issuerKeyHash, sizeof(ch.issuerKeyHash), "%s", hash.issuerKeyHash);
-        success &= ret >= 0 && (size_t)ret < sizeof(ch.issuerKeyHash);
-        ret = snprintf(ch.serialNumber, sizeof(ch.serialNumber), "%s", hash.serialNumber);
-        success &= ret >= 0 && (size_t)ret < sizeof(ch.serialNumber);
-        if (!success) {
-            MO_DBG_ERR("error copying C-style struct");
-            return DeleteCertificateStatus::Failed;
-        }
-
-        auto status = certstore->deleteCertificate(certstore->user_data, &ch);
-
-        DeleteCertificateStatus dcs;
-
-        switch (status) {
-            case ENUM_DCS_Accepted:
-                dcs = DeleteCertificateStatus::Accepted;
-                break;
-            case ENUM_DCS_Failed:
-                dcs = DeleteCertificateStatus::Failed;
-                break;
-            case ENUM_DCS_NotFound:
-                dcs = DeleteCertificateStatus::NotFound;
-                break;
-            default:
-                MO_DBG_ERR("could not convert status type");
-                return DeleteCertificateStatus::Failed; 
-        }
-
-        return dcs;
+        return certstore->deleteCertificate(certstore->user_data, &hash);
     }
 
     InstallCertificateStatus installCertificate(InstallCertificateType certificateType, const char *certificate) override {
-        InstallCertificateType_c ic;
-        
-        switch (certificateType) {
-            case InstallCertificateType::V2GRootCertificate:
-                ic = ENUM_IC_V2GRootCertificate;
-                break;
-            case InstallCertificateType::MORootCertificate:
-                ic = ENUM_IC_MORootCertificate;
-                break;
-            case InstallCertificateType::CSMSRootCertificate:
-                ic = ENUM_IC_CSMSRootCertificate;
-                break;
-            case InstallCertificateType::ManufacturerRootCertificate:
-                ic = ENUM_IC_ManufacturerRootCertificate;
-                break;
-            default:
-                MO_DBG_ERR("internal error");
-                return InstallCertificateStatus::Failed;
-        }
-
-        auto ret = certstore->installCertificate(certstore->user_data, ic, certificate);
-
-        InstallCertificateStatus ics;
-
-        switch (ret) {
-            case ENUM_ICS_Accepted:
-                ics = InstallCertificateStatus::Accepted;
-                break;
-            case ENUM_ICS_Rejected:
-                ics = InstallCertificateStatus::Rejected;
-                break;
-            case ENUM_ICS_Failed:
-                ics = InstallCertificateStatus::Failed;
-                break;
-            default:
-                MO_DBG_ERR("could not convert status type");
-                return InstallCertificateStatus::Rejected; 
-        }
-
-        return ics;
+        return certstore->installCertificate(certstore->user_data, certificateType, certificate);
     }
 };
 
-std::unique_ptr<CertificateStore> makeCertificateStoreCwrapper(ocpp_certificate_store *certstore) {
+std::unique_ptr<CertificateStore> makeCertificateStoreCwrapper(ocpp_cert_store *certstore) {
     return std::unique_ptr<CertificateStore>(new CertificateStoreC(certstore));
 }
 
diff --git a/src/MicroOcpp/Model/Certificates/Certificate_c.h b/src/MicroOcpp/Model/Certificates/Certificate_c.h
index fb9833fe..f47b2f73 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate_c.h
+++ b/src/MicroOcpp/Model/Certificates/Certificate_c.h
@@ -7,106 +7,40 @@
 
 #include <stddef.h>
 
+#include <MicroOcpp/Model/Certificates/Certificate.h>
+
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-enum GetCertificateIdType_c {
-    ENUM_GCI_V2GRootCertificate,
-    ENUM_GCI_MORootCertificate,
-    ENUM_GCI_CSMSRootCertificate,
-    ENUM_GCI_V2GCertificateChain,
-    ENUM_GCI_ManufacturerRootCertificate
-};
-
-/*
- * See OCPP 2.0.1 part 2 Data Type 3.40
- */
-enum GetInstalledCertificateStatus_c {
-    ENUM_GICS_Accepted,
-    ENUM_GICS_NotFound
-};
-
-/*
- * See OCPP 2.0.1 part 2 Data Type 3.45
- */
-enum InstallCertificateType_c {
-    ENUM_IC_V2GRootCertificate,
-    ENUM_IC_MORootCertificate,
-    ENUM_IC_CSMSRootCertificate,
-    ENUM_IC_ManufacturerRootCertificate
-};
-
-/*
- * See OCPP 2.0.1 part 2 Data Type 3.28
- */
-enum InstallCertificateStatus_c {
-    ENUM_ICS_Accepted,
-    ENUM_ICS_Rejected,
-    ENUM_ICS_Failed
-};
-
-/*
- * See OCPP 2.0.1 part 2 Data Type 3.28
- */
-enum DeleteCertificateStatus_c {
-    ENUM_DCS_Accepted,
-    ENUM_DCS_Failed,
-    ENUM_DCS_NotFound
-};
-
-/*
- * See OCPP 2.0.1 part 2 Data Type 3.42
- */
-enum HashAlgorithmEnumType_c {
-    ENUM_HA_SHA256,
-    ENUM_HA_SHA384,
-    ENUM_HA_SHA512
-};
-
-#define MO_CERT_HASH_ISSUER_NAME_SIZE (128 + 1)
-#define MO_CERT_HASH_ISSUER_KEY_SIZE (128 + 1)
-#define MO_CERT_HASH_SERIAL_NUMBER_SIZE (40 + 1)
-
-typedef struct ocpp_certificate_hash {
-    enum HashAlgorithmEnumType_c hashAlgorithm;
-    char issuerNameHash [MO_CERT_HASH_ISSUER_NAME_SIZE];
-    char issuerKeyHash [MO_CERT_HASH_ISSUER_KEY_SIZE];
-    char serialNumber [MO_CERT_HASH_SERIAL_NUMBER_SIZE];
-
-    //ocpp_certificate_hash *next; //link to next list element if part of ocpp_certificate_chain_hash
-} ocpp_certificate_hash;
-
-typedef struct ocpp_certificate_chain_hash {
+typedef struct ocpp_cert_chain_hash {
     void *user_data; //set this at your choice. MO passes it back to the functions below
 
-    enum GetCertificateIdType_c certificateType;
-    ocpp_certificate_hash certificateHashData;
-    //ocpp_certificate_hash *childCertificateHashData; 
+    enum GetCertificateIdType certType;
+    ocpp_cert_hash certHashData;
+    //ocpp_cert_hash *childCertificateHashData; 
 
-    struct ocpp_certificate_chain_hash *next; //link to next list element if result of getCertificateIds
+    struct ocpp_cert_chain_hash *next; //link to next list element if result of getCertificateIds
 
     void (*invalidate)(void *user_data); //free resources here. Guaranteed to be called
-} ocpp_certificate_chain_hash;
+} ocpp_cert_chain_hash;
 
-typedef struct ocpp_certificate_store {
+typedef struct ocpp_cert_store {
     void *user_data; //set this at your choice. MO passes it back to the functions below
 
-    enum GetInstalledCertificateStatus_c (*getCertificateIds)(void *user_data, enum GetCertificateIdType_c certificateType, ocpp_certificate_chain_hash **out);
-    enum DeleteCertificateStatus_c (*deleteCertificate)(void *user_data, const ocpp_certificate_hash *hash);
-    enum InstallCertificateStatus_c (*installCertificate)(void *user_data, enum InstallCertificateType_c certificateType, const char *certificate);
-} ocpp_certificate_store;
+    enum GetInstalledCertificateStatus (*getCertificateIds)(void *user_data, const enum GetCertificateIdType certType [], size_t certTypeLen, ocpp_cert_chain_hash **out);
+    enum DeleteCertificateStatus (*deleteCertificate)(void *user_data, const ocpp_cert_hash *hash);
+    enum InstallCertificateStatus (*installCertificate)(void *user_data, enum InstallCertificateType certType, const char *cert);
+} ocpp_cert_store;
 
 #ifdef __cplusplus
 } //extern "C"
 
 #include <memory>
 
-#include <MicroOcpp/Model/Certificates/Certificate.h>
-
 namespace MicroOcpp {
 
-std::unique_ptr<CertificateStore> makeCertificateStoreCwrapper(ocpp_certificate_store *certstore);
+std::unique_ptr<CertificateStore> makeCertificateStoreCwrapper(ocpp_cert_store *certstore);
 
 } //namespace MicroOcpp
 
diff --git a/src/MicroOcpp/Operations/DeleteCertificate.cpp b/src/MicroOcpp/Operations/DeleteCertificate.cpp
index 9af4ad04..5e3bf262 100644
--- a/src/MicroOcpp/Operations/DeleteCertificate.cpp
+++ b/src/MicroOcpp/Operations/DeleteCertificate.cpp
@@ -15,19 +15,21 @@ DeleteCertificate::DeleteCertificate(CertificateService& certService) : certServ
 
 void DeleteCertificate::processReq(JsonObject payload) {
 
-    if (!payload.containsKey("hashAlgorithm") ||
-            !payload.containsKey("issuerNameHash") ||
-            !payload.containsKey("issuerKeyHash") ||
-            !payload.containsKey("serialNumber")) {
+    JsonObject certIdJson = payload["certificateHashData"];
+
+    if (!certIdJson.containsKey("hashAlgorithm") ||
+            !certIdJson.containsKey("issuerNameHash") ||
+            !certIdJson.containsKey("issuerKeyHash") ||
+            !certIdJson.containsKey("serialNumber")) {
         errorCode = "FormationViolation";
         return;
     }
 
-    const char *hashAlgorithm = payload["hashAlgorithm"] | "_Invalid";
+    const char *hashAlgorithm = certIdJson["hashAlgorithm"] | "_Invalid";
 
-    if (!payload["issuerNameHash"].is<const char*>() ||
-            !payload["issuerKeyHash"].is<const char*>() ||
-            !payload["serialNumber"].is<const char*>()) {
+    if (!certIdJson["issuerNameHash"].is<const char*>() ||
+            !certIdJson["issuerKeyHash"].is<const char*>() ||
+            !certIdJson["serialNumber"].is<const char*>()) {
         errorCode = "FormationViolation";
         return;
     }
@@ -35,27 +37,20 @@ void DeleteCertificate::processReq(JsonObject payload) {
     CertificateHash cert;
 
     if (!strcmp(hashAlgorithm, "SHA256")) {
-        cert.hashAlgorithm = HashAlgorithmEnumType::SHA256;
+        cert.hashAlgorithm = HashAlgorithmType_SHA256;
     } else if (!strcmp(hashAlgorithm, "SHA384")) {
-        cert.hashAlgorithm = HashAlgorithmEnumType::SHA384;
+        cert.hashAlgorithm = HashAlgorithmType_SHA384;
     } else if (!strcmp(hashAlgorithm, "SHA512")) {
-        cert.hashAlgorithm = HashAlgorithmEnumType::SHA512;
+        cert.hashAlgorithm = HashAlgorithmType_SHA512;
     } else {
         errorCode = "FormationViolation";
         return;
     }
 
-    auto retIN = snprintf(cert.issuerNameHash, sizeof(cert.issuerNameHash), "%s", payload["issuerNameHash"] | "_Invalid");
-    auto retIK = snprintf(cert.issuerKeyHash, sizeof(cert.issuerKeyHash), "%s", payload["issuerKeyHash"] | "_Invalid");
-    auto retSN = snprintf(cert.serialNumber, sizeof(cert.serialNumber), "%s", payload["serialNumber"] | "_Invalid");
+    auto retIN = ocpp_cert_set_issuerNameHash(&cert, certIdJson["issuerNameHash"] | "_Invalid", cert.hashAlgorithm);
+    auto retIK = ocpp_cert_set_issuerKeyHash(&cert, certIdJson["issuerKeyHash"] | "_Invalid", cert.hashAlgorithm);
+    auto retSN = ocpp_cert_set_serialNumber(&cert, certIdJson["serialNumber"] | "_Invalid");
     if (retIN < 0 || retIK < 0 || retSN < 0) {
-        MO_DBG_ERR("could not parse CertId: %i %i %i", retIN, retIK, retSN);
-        errorCode = "InternalError";
-        return;
-    }
-    if ((size_t)retIN >= sizeof(cert.issuerNameHash) ||
-            (size_t)retIK >= sizeof(cert.issuerKeyHash) ||
-            (size_t)retSN >= sizeof(cert.serialNumber)) {
         errorCode = "FormationViolation";
         return;
     }
@@ -69,13 +64,13 @@ void DeleteCertificate::processReq(JsonObject payload) {
     auto status = certStore->deleteCertificate(cert);
 
     switch (status) {
-        case DeleteCertificateStatus::Accepted:
+        case DeleteCertificateStatus_Accepted:
             this->status = "Accepted";
             break;
-        case DeleteCertificateStatus::Failed:
+        case DeleteCertificateStatus_Failed:
             this->status = "Failed";
             break;
-        case DeleteCertificateStatus::NotFound:
+        case DeleteCertificateStatus_NotFound:
             this->status = "NotFound";
             break;
         default:
diff --git a/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
index 07d385ab..11aedc95 100644
--- a/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
+++ b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
@@ -20,21 +20,22 @@ void GetInstalledCertificateIds::processReq(JsonObject payload) {
         return;
     }
 
-    const char *certificateTypeCstr = payload["certificateType"] | "_Invalid";
-    GetCertificateIdType certificateType;
-    if (!strcmp(certificateTypeCstr, "V2GRootCertificate")) {
-        certificateType = GetCertificateIdType::V2GRootCertificate;
-    } else if (!strcmp(certificateTypeCstr, "MORootCertificate")) {
-        certificateType = GetCertificateIdType::MORootCertificate;
-    } else if (!strcmp(certificateTypeCstr, "CSMSRootCertificate")) {
-        certificateType = GetCertificateIdType::CSMSRootCertificate;
-    } else if (!strcmp(certificateTypeCstr, "V2GCertificateChain")) {
-        certificateType = GetCertificateIdType::V2GCertificateChain;
-    } else if (!strcmp(certificateTypeCstr, "ManufacturerRootCertificate")) {
-        certificateType = GetCertificateIdType::ManufacturerRootCertificate;
-    } else {
-        errorCode = "FormationViolation";
-        return;
+    std::vector<GetCertificateIdType> certificateType;
+    for (const char *certificateTypeCstr : payload["certificateType"].as<JsonArray>()) {
+        if (!strcmp(certificateTypeCstr, "V2GRootCertificate")) {
+            certificateType.push_back(GetCertificateIdType_V2GRootCertificate);
+        } else if (!strcmp(certificateTypeCstr, "MORootCertificate")) {
+            certificateType.push_back(GetCertificateIdType_MORootCertificate);
+        } else if (!strcmp(certificateTypeCstr, "CSMSRootCertificate")) {
+            certificateType.push_back(GetCertificateIdType_CSMSRootCertificate);
+        } else if (!strcmp(certificateTypeCstr, "V2GCertificateChain")) {
+            certificateType.push_back(GetCertificateIdType_V2GCertificateChain);
+        } else if (!strcmp(certificateTypeCstr, "ManufacturerRootCertificate")) {
+            certificateType.push_back(GetCertificateIdType_ManufacturerRootCertificate);
+        } else {
+            errorCode = "FormationViolation";
+            return;
+        }
     }
 
     auto certStore = certService.getCertificateStore();
@@ -46,10 +47,10 @@ void GetInstalledCertificateIds::processReq(JsonObject payload) {
     auto status = certStore->getCertificateIds(certificateType, certificateHashDataChain);
 
     switch (status) {
-        case GetInstalledCertificateStatus::Accepted:
+        case GetInstalledCertificateStatus_Accepted:
             this->status = "Accepted";
             break;
-        case GetInstalledCertificateStatus::NotFound:
+        case GetInstalledCertificateStatus_NotFound:
             this->status = "NotFound";
             break;
         default:
@@ -61,14 +62,21 @@ void GetInstalledCertificateIds::processReq(JsonObject payload) {
     //operation executed successfully
 }
 
-std::unique_ptr<DynamicJsonDocument> GetInstalledCertificateIds::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+std::unique_ptr<DynamicJsonDocument> GetInstalledCertificateIds::createConf() {
+
+    size_t capacity =
             JSON_OBJECT_SIZE(2) + //payload root
-            JSON_ARRAY_SIZE(certificateHashDataChain.size()) + //array for field certificateHashDataChain
-            certificateHashDataChain.size() * ( 
+            JSON_ARRAY_SIZE(certificateHashDataChain.size()); //array for field certificateHashDataChain
+    for (auto& cch : certificateHashDataChain) {
+        capacity +=
                 JSON_OBJECT_SIZE(2) + //certificateHashDataChain root
-                JSON_OBJECT_SIZE(4))  //certificateHashData
-            ));
+                JSON_OBJECT_SIZE(4) +  //certificateHashData
+                (2 * HashAlgorithmSize(cch.certificateHashData.hashAlgorithm) + //issuerNameHash and issuerKeyHash
+                    cch.certificateHashData.serialNumberLen)
+                    * 2 + 3; //issuerNameHash, issuerKeyHash and serialNumber as hex-endoded cstring
+    }
+
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = status;
 
@@ -77,28 +85,36 @@ std::unique_ptr<DynamicJsonDocument> GetInstalledCertificateIds::createConf(){
 
         const char *certificateTypeCstr = "";
         switch (chainElem.certificateType) {
-            case GetCertificateIdType::V2GRootCertificate:
+            case GetCertificateIdType_V2GRootCertificate:
                 certificateTypeCstr = "V2GRootCertificate";
                 break;
-            case GetCertificateIdType::MORootCertificate:
+            case GetCertificateIdType_MORootCertificate:
                 certificateTypeCstr = "MORootCertificate";
                 break;
-            case GetCertificateIdType::CSMSRootCertificate:
+            case GetCertificateIdType_CSMSRootCertificate:
                 certificateTypeCstr = "CSMSRootCertificate";
                 break;
-            case GetCertificateIdType::V2GCertificateChain:
+            case GetCertificateIdType_V2GCertificateChain:
                 certificateTypeCstr = "V2GCertificateChain";
                 break;
-            case GetCertificateIdType::ManufacturerRootCertificate:
+            case GetCertificateIdType_ManufacturerRootCertificate:
                 certificateTypeCstr = "ManufacturerRootCertificate";
                 break;
         }
 
         certHashJson["certificateType"] = (const char*) certificateTypeCstr; //use JSON zero-copy mode
-        certHashJson["certificateHashData"]["hashAlgorithm"] = chainElem.certificateHashData.getHashAlgorithmCStr();
-        certHashJson["certificateHashData"]["issuerNameHash"] = chainElem.certificateHashData.getIssuerNameHash();
-        certHashJson["certificateHashData"]["issuerKeyHash"] = chainElem.certificateHashData.getIssuerKeyHash();
-        certHashJson["certificateHashData"]["serialNumber"] = chainElem.certificateHashData.getSerialNumber();
+        certHashJson["certificateHashData"]["hashAlgorithm"] = HashAlgorithmLabel(chainElem.certificateHashData.hashAlgorithm);
+
+        char buf [MO_CERT_HASH_ISSUER_NAME_KEY_SIZE];
+
+        ocpp_cert_print_issuerNameHash(&chainElem.certificateHashData, buf, sizeof(buf));
+        certHashJson["certificateHashData"]["issuerNameHash"] = buf;
+
+        ocpp_cert_print_issuerKeyHash(&chainElem.certificateHashData, buf, sizeof(buf));
+        certHashJson["certificateHashData"]["issuerKeyHash"] = buf;
+
+        ocpp_cert_print_serialNumber(&chainElem.certificateHashData, buf, sizeof(buf));
+        certHashJson["certificateHashData"]["serialNumber"] = buf;
         
         if (!chainElem.childCertificateHashData.empty()) {
             MO_DBG_ERR("only sole root certs supported");
diff --git a/src/MicroOcpp/Operations/InstallCertificate.cpp b/src/MicroOcpp/Operations/InstallCertificate.cpp
index ed2e6c1f..bafac549 100644
--- a/src/MicroOcpp/Operations/InstallCertificate.cpp
+++ b/src/MicroOcpp/Operations/InstallCertificate.cpp
@@ -25,13 +25,13 @@ void InstallCertificate::processReq(JsonObject payload) {
     const char *certificateTypeCstr = payload["certificateType"] | "_Invalid";
 
     if (!strcmp(certificateTypeCstr, "V2GRootCertificate")) {
-        certificateType = InstallCertificateType::V2GRootCertificate;
+        certificateType = InstallCertificateType_V2GRootCertificate;
     } else if (!strcmp(certificateTypeCstr, "MORootCertificate")) {
-        certificateType = InstallCertificateType::MORootCertificate;
+        certificateType = InstallCertificateType_MORootCertificate;
     } else if (!strcmp(certificateTypeCstr, "CSMSRootCertificate")) {
-        certificateType = InstallCertificateType::CSMSRootCertificate;
+        certificateType = InstallCertificateType_CSMSRootCertificate;
     } else if (!strcmp(certificateTypeCstr, "ManufacturerRootCertificate")) {
-        certificateType = InstallCertificateType::ManufacturerRootCertificate;
+        certificateType = InstallCertificateType_ManufacturerRootCertificate;
     } else {
         errorCode = "FormationViolation";
         return;
@@ -53,13 +53,13 @@ void InstallCertificate::processReq(JsonObject payload) {
     auto status = certStore->installCertificate(certificateType, certificate);
 
     switch (status) {
-        case InstallCertificateStatus::Accepted:
+        case InstallCertificateStatus_Accepted:
             this->status = "Accepted";
             break;
-        case InstallCertificateStatus::Rejected:
+        case InstallCertificateStatus_Rejected:
             this->status = "Rejected";
             break;
-        case InstallCertificateStatus::Failed:
+        case InstallCertificateStatus_Failed:
             this->status = "Failed";
             break;
         default:
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index b04fc9f5..3d36794c 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include "MicroOcpp_c.h"
@@ -16,7 +16,7 @@ void ocpp_initialize(OCPP_Connection *conn, const char *chargePointModel, const
     ocpp_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt, autoRecover, NULL);
 }
 
-void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt, bool autoRecover, ocpp_certificate_store *certs) {
+void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt, bool autoRecover, ocpp_cert_store *certs) {
     if (!conn) {
         MO_DBG_ERR("conn is null");
     }
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index f3a259bf..b0cedf32 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef ARDUINOOCPP_C_H
@@ -65,7 +65,7 @@ void ocpp_initialize_full(
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             struct OCPP_FilesystemOpt fsopt, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
             bool autoRecover, //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
-            ocpp_certificate_store *certs); //optional. If provided, use given Cert Store, if NULL, use default (default depends on MbedTLS)
+            ocpp_cert_store *certs); //optional. If provided, use given Cert Store, if NULL, use default (default depends on MbedTLS)
 
 
 void ocpp_deinitialize();
diff --git a/tests/Certificates.cpp b/tests/Certificates.cpp
index 7266e5b1..b3a858ec 100644
--- a/tests/Certificates.cpp
+++ b/tests/Certificates.cpp
@@ -61,8 +61,8 @@ emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
 
 //precomputed identifiers of root cert above, based on Open Certificate Status Protocol (OCSP)
 const char *root_cert_hash_algorithm = "SHA256"; //algorithm used for the following hashes
-const char *root_cert_hash_issuer_name = "998AC9E24B24D4008398DFA1375FD5D3DA7F2827E547ABFE5DB367B9E2CD5B20";
-const char *root_cert_hash_issuer_key = "0B9FA5A59EED715C26C1020C711B4F6EC42D58B0015E14337A39DAD301C5AFC3";
+const char *root_cert_hash_issuer_name = "F6DB2FBD9DD85D9259DDB3C6DE7D7B2FEC3F3E0CEF1761BCBF3320571E2D30F8";
+const char *root_cert_hash_issuer_key = "F4593A1E07CC9CCEFFBED9C11DC5218356F7814D9B22949DE745E629990C6C60";
 const char *root_cert_hash_serial_number = "8210CFB0D240E3594463E0BB63828B00";
 
 using namespace MicroOcpp;
@@ -96,8 +96,8 @@ TEST_CASE( "M - Certificates" ) {
     loop();
 
     SECTION("M05 Install CA cert -- sent cert is valid") {
-        auto ret = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
-        REQUIRE(ret == InstallCertificateStatus::Accepted);
+        auto ret = certs->installCertificate(InstallCertificateType_CSMSRootCertificate, root_cert);
+        REQUIRE(ret == InstallCertificateStatus_Accepted);
 
         size_t msize;
         char fn [MO_MAX_PATH_SIZE];
@@ -107,42 +107,51 @@ TEST_CASE( "M - Certificates" ) {
     }
 
     SECTION("M03 Retrieve list of available certs -- one cert available") {
-        auto ret1 = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
-        REQUIRE(ret1 == InstallCertificateStatus::Accepted);
+        auto ret1 = certs->installCertificate(InstallCertificateType_CSMSRootCertificate, root_cert);
+        REQUIRE(ret1 == InstallCertificateStatus_Accepted);
 
         std::vector<CertificateChainHash> chain;
-        auto ret2 = certs->getCertificateIds(GetCertificateIdType::CSMSRootCertificate, chain);
+        auto ret2 = certs->getCertificateIds({GetCertificateIdType_CSMSRootCertificate}, chain);
 
-        REQUIRE(ret2 == GetInstalledCertificateStatus::Accepted);
+        REQUIRE(ret2 == GetInstalledCertificateStatus_Accepted);
         REQUIRE(chain.size() == 1);
 
         auto& chainElem = chain.front();
 
-        REQUIRE(chainElem.certificateType == GetCertificateIdType::CSMSRootCertificate);
+        REQUIRE(chainElem.certificateType == GetCertificateIdType_CSMSRootCertificate);
         auto& certHash = chainElem.certificateHashData;
 
-        REQUIRE(!strcmp(certHash.getHashAlgorithmCStr(), root_cert_hash_algorithm)); //if this fails, please update the precomputed test hashes
-        REQUIRE(!strcmp(certHash.getIssuerNameHash(), root_cert_hash_issuer_name));
-        REQUIRE(!strcmp(certHash.getIssuerKeyHash(), root_cert_hash_issuer_key));
-        REQUIRE(!strcmp(certHash.getSerialNumber(), root_cert_hash_serial_number));
+        REQUIRE(!strcmp(HashAlgorithmLabel(certHash.hashAlgorithm), root_cert_hash_algorithm)); //if this fails, please update the precomputed test hashes
+
+        char buf [MO_CERT_HASH_ISSUER_NAME_KEY_SIZE];
+
+        ocpp_cert_print_issuerNameHash(&certHash, buf, sizeof(buf));
+        REQUIRE(!strcmp(buf, root_cert_hash_issuer_name));
+
+        ocpp_cert_print_issuerKeyHash(&certHash, buf, sizeof(buf));
+        REQUIRE(!strcmp(buf, root_cert_hash_issuer_key));
+
+        ocpp_cert_print_serialNumber(&certHash, buf, sizeof(buf));
+        REQUIRE(!strcmp(buf, root_cert_hash_serial_number));
+
         REQUIRE(chainElem.childCertificateHashData.empty()); //no sub certs sent
     }
 
     SECTION("M04 Delete a specific cert -- specified cert exists") {
-        auto ret1 = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
-        REQUIRE(ret1 == InstallCertificateStatus::Accepted);
+        auto ret1 = certs->installCertificate(InstallCertificateType_CSMSRootCertificate, root_cert);
+        REQUIRE(ret1 == InstallCertificateStatus_Accepted);
 
         std::vector<CertificateChainHash> chain;
-        auto ret2 = certs->getCertificateIds(GetCertificateIdType::CSMSRootCertificate, chain);
-        REQUIRE(ret2 == GetInstalledCertificateStatus::Accepted);
+        auto ret2 = certs->getCertificateIds({GetCertificateIdType_CSMSRootCertificate}, chain);
+        REQUIRE(ret2 == GetInstalledCertificateStatus_Accepted);
 
         REQUIRE(chain.size() == 1);
 
         auto ret3 = certs->deleteCertificate(chain.front().certificateHashData);
-        REQUIRE(ret3 == DeleteCertificateStatus::Accepted);
+        REQUIRE(ret3 == DeleteCertificateStatus_Accepted);
 
-        ret2 = certs->getCertificateIds(GetCertificateIdType::CSMSRootCertificate, chain);
-        REQUIRE(ret2 == GetInstalledCertificateStatus::NotFound);
+        ret2 = certs->getCertificateIds({GetCertificateIdType_CSMSRootCertificate}, chain);
+        REQUIRE(ret2 == GetInstalledCertificateStatus_NotFound);
 
         REQUIRE(chain.size() == 0);
 
@@ -183,8 +192,8 @@ TEST_CASE( "M - Certificates" ) {
     }
 
     SECTION("M04 DeleteCertificate operation") {
-        auto ret = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
-        REQUIRE(ret == InstallCertificateStatus::Accepted);
+        auto ret = certs->installCertificate(InstallCertificateType_CSMSRootCertificate, root_cert);
+        REQUIRE(ret == InstallCertificateStatus_Accepted);
 
         bool checkProcessed = false;
         getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
@@ -192,12 +201,12 @@ TEST_CASE( "M - Certificates" ) {
                 [] () {
                     //create req
                     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            JSON_OBJECT_SIZE(4)));
+                            JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(4)));
                     auto payload = doc->to<JsonObject>();
-                    payload["hashAlgorithm"] = root_cert_hash_algorithm; //of HashAlgorithmEnumType
-                    payload["issuerNameHash"] = root_cert_hash_issuer_name;
-                    payload["issuerKeyHash"] = root_cert_hash_issuer_key;
-                    payload["serialNumber"] = root_cert_hash_serial_number;
+                    payload["certificateHashData"]["hashAlgorithm"] = root_cert_hash_algorithm; //of HashAlgorithmType
+                    payload["certificateHashData"]["issuerNameHash"] = root_cert_hash_issuer_name;
+                    payload["certificateHashData"]["issuerKeyHash"] = root_cert_hash_issuer_key;
+                    payload["certificateHashData"]["serialNumber"] = root_cert_hash_serial_number;
                     return doc;},
                 [&checkProcessed] (JsonObject payload) {
                     //receive conf
@@ -211,8 +220,8 @@ TEST_CASE( "M - Certificates" ) {
     }
 
     SECTION("M03 GetInstalledCertificateIds operation") {
-        auto ret = certs->installCertificate(InstallCertificateType::CSMSRootCertificate, root_cert);
-        REQUIRE(ret == InstallCertificateStatus::Accepted);
+        auto ret = certs->installCertificate(InstallCertificateType_CSMSRootCertificate, root_cert);
+        REQUIRE(ret == InstallCertificateStatus_Accepted);
 
         bool checkProcessed = false;
         getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
@@ -220,9 +229,9 @@ TEST_CASE( "M - Certificates" ) {
                 [] () {
                     //create req
                     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            JSON_OBJECT_SIZE(1)));
+                            JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(1)));
                     auto payload = doc->to<JsonObject>();
-                    payload["certificateType"] = "CSMSRootCertificate"; //of GetCertificateIdTypeEnumType
+                    payload["certificateType"][0] = "CSMSRootCertificate"; //of GetCertificateIdTypeEnumType
                     return doc;},
                 [&checkProcessed] (JsonObject payload) {
                     //receive conf

From 70c3c7d00b303c466d6c9985066989dcfe9d20bd Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 6 Apr 2024 21:46:30 +0200
Subject: [PATCH 460/549] update changelog and README with v1.0.3 release

---
 CHANGELOG.md | 7 +++++++
 README.md    | 4 ++--
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8f1a09a5..8a9ba31e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -21,6 +21,13 @@
 
 - Make field localAuthorizationList in SendLocalList optional
 
+## [1.0.3] - 2024-04-06
+
+### Fixed
+
+- Fix nullptr access in endTransaction ([#275](https://github.com/matth-x/MicroOcpp/pull/275))
+- Backport: Fix building with debug level warn and error
+
 ## [1.0.2] - 2024-03-24
 
 ### Fixed
diff --git a/README.md b/README.md
index d7a0c596..9bb8f15b 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif,
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.micro-ocpp.com](https://www.micro-ocpp.com)
 
-**Updated branches (2024-03-24):** the default branch was renamed from master into main. The develop branch hasn't been used anymore, so it is deleted. This better represents how branches are used in MicroOcpp: active development takes place on main (plus the feature and fixing branches) and the releases are stable versions of this library. To get a release version, checkout a tag, e.g. *v1.0.2*, or download it from GitHub / PlatformIO.
+**Updated branches (2024-03-24):** the default branch was renamed from master into main. The develop branch hasn't been used anymore, so it is deleted. This better represents how branches are used in MicroOcpp: active development takes place on main (plus the feature and fixing branches) and the releases are stable versions of this library. To get a release version, checkout a tag, e.g. *v1.0.3*, or download it from GitHub / PlatformIO.
 
 ## Tester / Demo App
 
@@ -71,7 +71,7 @@ If using the built-in certificate store (to enable, set build flag `MO_ENABLE_MB
 
 - [Mbed-TLS/mbedtls](https://github.com/Mbed-TLS/mbedtls) (version `2.28.1`)
 
-In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp@1.0.0` in the PIO library manager.
+In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp@1.0.3` in the PIO library manager.
 
 ## OCPP 2.0.1 and ISO 15118
 

From 10bd26ef5fe7766b140b05501e3bf46ac417fe06 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Fri, 12 Apr 2024 22:16:25 +0200
Subject: [PATCH 461/549] fix transactions freeze in offline mode (#279)

* fix tx queue can get stuck with offline tx

* fix compilation error
---
 .../Core/RequestQueueStorageStrategy.cpp      | 49 ++++++++++---------
 .../Model/ConnectorBase/Connector.cpp         | 11 +++--
 .../Model/Metering/MeteringConnector.cpp      |  2 +-
 src/MicroOcpp/Operations/StopTransaction.cpp  |  6 +++
 4 files changed, 41 insertions(+), 27 deletions(-)

diff --git a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
index caa7e0e0..507f4a7f 100644
--- a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
+++ b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
@@ -59,14 +59,6 @@ PersistentRequestQueue::~PersistentRequestQueue() {
 
 }
 
-Request *PersistentRequestQueue::front() {
-    if (!head && !tailCache.empty()) {
-        MO_DBG_ERR("invalid state");
-        pop_front();
-    }
-    return head.get();
-}
-
 void PersistentRequestQueue::pop_front() {
     
     if (head && head->getStorageHandler() && head->getStorageHandler()->getOpNr() >= 0) {
@@ -75,6 +67,20 @@ void PersistentRequestQueue::pop_front() {
     }
 
     head.reset();
+}
+
+Request *PersistentRequestQueue::front() {
+
+    if (head) {
+        // head still loaded
+        return head.get();
+    }
+
+    // check if there are any more operations
+    if (tailCache.empty() && opStore.getOpBegin() == opStore.getOpEnd()) {
+        // no more operations
+        return nullptr;
+    }
 
     unsigned int nextOpNr = opStore.getOpBegin();
 
@@ -143,29 +149,26 @@ void PersistentRequestQueue::pop_front() {
         }
     }
 
-    MO_DBG_VERBOSE("popped front");
+    MO_DBG_VERBOSE("reloaded head");
+
+    if (!head) {
+        MO_DBG_VERBOSE("illegal state");
+    }
+
+    return head.get();
 }
 
 void PersistentRequestQueue::push_back(std::unique_ptr<Request> op) {
 
     op->initiate(opStore.makeOpHandler());
 
-    if (!head && !tailCache.empty()) {
-        MO_DBG_ERR("invalid state");
-        pop_front();
+    if (tailCache.size() >= MO_OPERATIONCACHE_MAXSIZE) {
+        MO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOperationType());
+        tailCache.front()->executeTimeout();
+        tailCache.pop_front();
     }
 
-    if (!head) {
-        head = std::move(op);
-    } else {
-        if (tailCache.size() >= MO_OPERATIONCACHE_MAXSIZE) {
-            MO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOperationType());
-            tailCache.front()->executeTimeout();
-            tailCache.pop_front();
-        }
-
-        tailCache.push_back(std::move(op));
-    }
+    tailCache.push_back(std::move(op));
 }
 
 void PersistentRequestQueue::drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) {
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index af748634..958737aa 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -166,7 +166,6 @@ bool Connector::ocppPermitsCharge() {
     return transaction &&
             transaction->isRunning() &&
             transaction->isActive() &&
-            !isFaulted() &&
             !suspendDeAuthorizedIdTag;
 }
 
@@ -174,6 +173,9 @@ void Connector::loop() {
 
     if (!trackLoopExecute) {
         trackLoopExecute = true;
+        if (connectorPluggedInput) {
+            freeVendTrackPlugged = connectorPluggedInput();
+        }
     }
 
     if (transaction && transaction->isAborted() && MO_TX_CLEAN_ABORTED) {
@@ -201,7 +203,7 @@ void Connector::loop() {
         transaction = nullptr;
     }
 
-    if (transaction && transaction->isCompleted()) {
+    if (transaction && transaction->getStopSync().isRequested()) {
         MO_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
         transaction = nullptr;
     }
@@ -409,9 +411,12 @@ void Connector::loop() {
     }
 
     if (status != currentStatus) {
+        MO_DBG_DEBUG("Status changed %s -> %s %s",
+                currentStatus == ChargePointStatus::NOT_SET ? "" : cstrFromOcppEveState(currentStatus),
+                cstrFromOcppEveState(status),
+                minimumStatusDurationInt->getInt() ? " (will report delayed)" : "");
         currentStatus = status;
         t_statusTransition = mocpp_tick_ms();
-        MO_DBG_DEBUG("Status changed%s", minimumStatusDurationInt->getInt() ? ", will report delayed" : "");
     }
 
     if (reportedStatus != currentStatus &&
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index fb84a24a..d391b3d4 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -93,7 +93,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         if (dt <= 0 ||                              //normal case: interval elapsed
                 dt > clockAlignedDataIntervalInt->getInt()) {   //special case: clock has been adjusted or first run
 
-            MO_DBG_DEBUG("Clock aligned measurement %" PRId32 "s: %s", dt,
+            MO_DBG_DEBUG("Clock aligned measurement %ds: %s", dt,
                 abs(dt) <= 60 ?
                 "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
diff --git a/src/MicroOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
index 4eec404a..e82acb00 100644
--- a/src/MicroOcpp/Operations/StopTransaction.cpp
+++ b/src/MicroOcpp/Operations/StopTransaction.cpp
@@ -127,6 +127,12 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
         }
     }
 
+    // if StopTx timestamp is before StartTx timestamp, something probably went wrong. Restore reasonable temporal order
+    if (transaction->getStopTimestamp() < transaction->getStartTimestamp()) {
+        MO_DBG_WARN("set stopTime = startTime because stopTime was before startTime");
+        transaction->setStopTimestamp(transaction->getStartTimestamp() + 1); //1s behind startTime to keep order in backend DB
+    }
+
     for (auto mv = transactionData.begin(); mv != transactionData.end(); mv++) {
         if ((*mv)->getTimestamp() < MIN_TIME) {
             //time off. Try to adjust, otherwise send invalid value

From 6a5ff828784efeecc633d9e1cb60b8b5cd2e293e Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Fri, 12 Apr 2024 22:18:14 +0200
Subject: [PATCH 462/549] update changelog (#279)

---
 CHANGELOG.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8a9ba31e..85e47605 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,6 +20,8 @@
 ### Fixed
 
 - Make field localAuthorizationList in SendLocalList optional
+- Fix transaction freeze in offline mode ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
+- Fix compilation error caused by `PRId32` ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
 
 ## [1.0.3] - 2024-04-06
 

From 6a848cf29dd70f1e21f2cdbc4d68ec40feed7418 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 13 Apr 2024 15:00:11 +0200
Subject: [PATCH 463/549] clearer v2.0.1 transaction logic (#277)

---
 .../Model/Transactions/Transaction.h          |  31 +-
 .../Model/Transactions/TransactionService.cpp | 288 ++++++++++--------
 .../Model/Transactions/TransactionService.h   |   3 +
 src/MicroOcpp/Operations/TransactionEvent.cpp |  32 ++
 src/MicroOcpp/Operations/TransactionEvent.h   |   2 +
 5 files changed, 207 insertions(+), 149 deletions(-)

diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index b1d2a837..f02b2c09 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -234,23 +234,28 @@ class Transaction {
         Timeout
     };
 
-    struct SubStatus {
-        bool triggered = false;
-        SendStatus remote;
-    };
-
 //private:
-    //SubStatus parkingBayOccupancy; // not supported
-    SubStatus evConnected;
-    SubStatus authorized;
-    SubStatus dataSigned;
-    SubStatus powerPathClosed;
-    SubStatus energyTransfer;
+    /*
+     * Transaction substates. Notify server about any change when transaction is running
+     */
+    //bool trackParkingBayOccupancy; // not supported
+    bool trackEvConnected;
+    bool trackAuthorized;
+    bool trackDataSigned;
+    bool trackPowerPathClosed;
+    bool trackEnergyTransfer;
+
+    /*
+     * Transaction lifecycle
+     */
+    bool active = true; //once active is false, the tx must stop (or cannot start at all)
+    bool started = false; //if a TxEvent with event type TxStarted has been initiated
+    bool stopped = false; //if a TxEvent with event type TxEnded has been initiated
+    bool stoppedConfirmed = false; //if all TxEvents have been sent to the server (acknowledged or aborted)
 
     /*
      * Global transaction data
      */
-    bool active = true;         //once active is false, the tx must stop (or cannot start at all)
     bool isAuthorized = false;    //if the given idToken was authorized
     bool isDeauthorized = false;  //if the server revoked a local authorization
     unsigned int seqNoCounter = 0; // increment by 1 for each event
@@ -263,8 +268,6 @@ class Transaction {
 
     bool evConnectionTimeoutListen = true;
 
-    bool started = false, stopped = false;
-
     StopReason stopReason = StopReason::UNDEFINED;
     TransactionEventTriggerReason stopTrigger = TransactionEventTriggerReason::UNDEFINED;
     std::unique_ptr<IdToken> stopIdToken; // if null, then stopIdToken equals idToken
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index b3e6d5db..8a5048c9 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -41,7 +41,7 @@ std::unique_ptr<Ocpp201::Transaction> TransactionService::Evse::allocateTransact
     h *= 749572633U;
     h %= 24593209U;
     for (size_t i = 0; i < sizeof(tx->transactionId) - 3; i += 2) {
-        sprintf(tx->transactionId + i, "%02X", (uint8_t)h);
+        snprintf(tx->transactionId + i, 3, "%02X", (uint8_t)h);
         h *= 749572633U;
         h %= 24593209U;
     }
@@ -53,6 +53,16 @@ std::unique_ptr<Ocpp201::Transaction> TransactionService::Evse::allocateTransact
 
 void TransactionService::Evse::loop() {
 
+    if (transaction && !transaction->active && !transaction->started) {
+        MO_DBG_DEBUG("collect aborted transaction %u-%s", evseId, transaction->transactionId);
+        transaction = nullptr;
+    }
+
+    if (transaction && transaction->stopped) {
+        MO_DBG_DEBUG("collect obsolete transaction %u-%s", evseId, transaction->transactionId);
+        transaction = nullptr;
+    }
+
     // tx-related behavior
     if (transaction) {
         if (connectorPluggedInput) {
@@ -60,6 +70,7 @@ void TransactionService::Evse::loop() {
                 // if cable has been plugged at least once, EVConnectionTimeout will never get triggered
                 transaction->evConnectionTimeoutListen = false;
             }
+
             if (transaction->active &&
                     transaction->evConnectionTimeoutListen &&
                     transaction->beginTimestamp > MIN_TIME &&
@@ -75,83 +86,60 @@ void TransactionService::Evse::loop() {
         }
     }
 
-    // TxEvent types
-    bool txStarted = false;
-    bool txStopped = false;
-    bool txUpdated = false;
-
-    TransactionEventTriggerReason triggerReason = TransactionEventTriggerReason::UNDEFINED;
-    Ocpp201::Transaction::StopReason stoppedReason = Ocpp201::Transaction::StopReason::UNDEFINED;
 
-    // tx should be updated?
-    TransactionEventData::ChargingState chargingState = TransactionEventData::ChargingState::Idle;
-    if (transaction) {
-        chargingState = TransactionEventData::ChargingState::Charging;
+    std::shared_ptr<TransactionEventData> txEvent;
 
-        if (connectorPluggedInput && !connectorPluggedInput()) {
-            chargingState = TransactionEventData::ChargingState::Idle;
-        } else if (!transaction || !transaction->isAuthorized) {
-            chargingState = TransactionEventData::ChargingState::EVConnected;
-        } else if (evseReadyInput && !evseReadyInput()) { 
-            chargingState = TransactionEventData::ChargingState::SuspendedEVSE;
-        } else if (evReadyInput && !evReadyInput()) {
-            chargingState = TransactionEventData::ChargingState::SuspendedEV;
-        } else {
-            chargingState = TransactionEventData::ChargingState::Charging;
+    bool txStopCondition = false;
+
+    {
+        // stop tx?
+
+        TransactionEventTriggerReason triggerReason = TransactionEventTriggerReason::UNDEFINED;
+        Ocpp201::Transaction::StopReason stopReason = Ocpp201::Transaction::StopReason::UNDEFINED;
+
+        if (transaction && !transaction->active) {
+            // tx ended via endTransaction
+            txStopCondition = true;
+            triggerReason = transaction->stopTrigger;
+            stopReason = transaction->stopReason;
+        } else if (txService.isTxStopPoint(TxStartStopPoint::EVConnected) &&
+                    connectorPluggedInput && !connectorPluggedInput() &&
+                    (txService.stopTxOnEVSideDisconnectBool->getBool() || !transaction || !transaction->started)) {
+            txStopCondition = true;
+            triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
+            stopReason = Ocpp201::Transaction::StopReason::EVDisconnected;
+        } else if (txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed) &&
+                    evReadyInput && !evReadyInput()) {
+            txStopCondition = true;
+            triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
+            stopReason = Ocpp201::Transaction::StopReason::StoppedByEV;
+        } else if (txService.isTxStopPoint(TxStartStopPoint::Authorized) &&
+                    (!transaction || !transaction->isAuthorized)) {
+            // user revoked authorization (or EV or any "local" entity)
+            txStopCondition = true;
+            triggerReason = TransactionEventTriggerReason::StopAuthorized;
+            stopReason = Ocpp201::Transaction::StopReason::Local;
+        } else if (txService.isTxStopPoint(TxStartStopPoint::Authorized) &&
+                    transaction && transaction->isDeauthorized &&
+                    txService.stopTxOnInvalidIdBool->getBool()) {
+            // OCPP server rejected authorization
+            txStopCondition = true;
+            triggerReason = TransactionEventTriggerReason::Deauthorized;
+            stopReason = Ocpp201::Transaction::StopReason::DeAuthorized;
         }
-    }
 
-    // tx should be started?
-    if (txService.isTxStartPoint(TxStartStopPoint::EVConnected) &&
-                connectorPluggedInput && connectorPluggedInput()) {
-        txStarted = true;
-        triggerReason = TransactionEventTriggerReason::CablePluggedIn;
-    } else if (txService.isTxStartPoint(TxStartStopPoint::PowerPathClosed) &&
-                evReadyInput && evReadyInput()) {
-        txStarted = true;
-        triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
-    } else if (txService.isTxStartPoint(TxStartStopPoint::Authorized) &&
-                transaction && transaction->isAuthorized) {
-        txStarted = true;
-        triggerReason = TransactionEventTriggerReason::Authorized;
-    }
-
-    // tx should be stopped?
-    if (transaction && !transaction->active) {
-        // tx ended via endTransaction
-        txStopped = true;
-        triggerReason = transaction->stopTrigger;
-        stoppedReason = transaction->stopReason;
-    } else if (txService.isTxStopPoint(TxStartStopPoint::EVConnected) &&
-                connectorPluggedInput && !connectorPluggedInput() &&
-                (txService.stopTxOnEVSideDisconnectBool->getBool() || !transaction || !transaction->started)) {
-        txStopped = true;
-        triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
-        stoppedReason = Ocpp201::Transaction::StopReason::EVDisconnected;
-    } else if (txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed) &&
-                evReadyInput && !evReadyInput()) {
-        txStopped = true;
-        triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
-        stoppedReason = Ocpp201::Transaction::StopReason::StoppedByEV;
-    } else if (txService.isTxStopPoint(TxStartStopPoint::Authorized) &&
-                (!transaction || !transaction->isAuthorized)) {
-        // user revoked authorization (or EV or any "local" entity)
-        txStopped = true;
-        triggerReason = TransactionEventTriggerReason::StopAuthorized;
-        stoppedReason = Ocpp201::Transaction::StopReason::Local;
-    } else if (txService.isTxStopPoint(TxStartStopPoint::Authorized) &&
-                transaction && transaction->isDeauthorized &&
-                txService.stopTxOnInvalidIdBool->getBool()) {
-        // OCPP server rejected authorization
-        txStopped = true;
-        triggerReason = TransactionEventTriggerReason::Deauthorized;
-        stoppedReason = Ocpp201::Transaction::StopReason::DeAuthorized;
-    }
+        if (txStopCondition &&
+                transaction && transaction->started && transaction->active) {
 
-    std::shared_ptr<TransactionEventData> txEvent;
+            MO_DBG_INFO("Session mngt: TxStopPoint reached");
+            transaction->active = false;
+            transaction->stopTrigger = triggerReason;
+            transaction->stopReason = stopReason;
+        }
 
-    if (txStopped) { // stop tx?
-        if (transaction && transaction->started && !transaction->stopped) {
+        if (transaction &&
+                transaction->started && !transaction->stopped && !transaction->active &&
+                (!stopTxReadyInput || stopTxReadyInput())) {
             // yes, stop running tx
 
             txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
@@ -160,12 +148,40 @@ void TransactionService::Evse::loop() {
                 return;
             }
 
+            transaction->stopTrigger = triggerReason;
+            transaction->stopReason = stopReason;
+
             txEvent->eventType = TransactionEventData::Type::Ended;
-            transaction->stopReason = stoppedReason;
+            txEvent->triggerReason = triggerReason;
+        }
+    } 
+    
+    if (!txStopCondition) {
+        // start tx?
+
+        bool txStartCondition = false;
+
+        TransactionEventTriggerReason triggerReason = TransactionEventTriggerReason::UNDEFINED;
+
+        // tx should be started?
+        if (txService.isTxStartPoint(TxStartStopPoint::EVConnected) &&
+                    connectorPluggedInput && connectorPluggedInput()) {
+            txStartCondition = true;
+            triggerReason = TransactionEventTriggerReason::CablePluggedIn;
+        } else if (txService.isTxStartPoint(TxStartStopPoint::PowerPathClosed) &&
+                    evReadyInput && evReadyInput()) {
+            txStartCondition = true;
+            triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
+        } else if (txService.isTxStartPoint(TxStartStopPoint::Authorized) &&
+                    transaction && transaction->isAuthorized) {
+            txStartCondition = true;
+            triggerReason = TransactionEventTriggerReason::Authorized;
         }
-    } else {
-        if (txStarted && (!transaction || !transaction->started)) { // start tx?
-            // yes, start tx
+
+        if (txStartCondition &&
+                (!transaction || (transaction->active && !transaction->started)) &&
+                (!startTxReadyInput || startTxReadyInput())) {
+            // start tx
 
             if (!transaction) {
                 transaction = allocateTransaction();
@@ -182,64 +198,84 @@ void TransactionService::Evse::loop() {
             }
 
             txEvent->eventType = TransactionEventData::Type::Started;
-            
-        } else if (transaction && transaction->started) {
-            // update tx?
-            if (chargingState != trackChargingState) {
-                txUpdated = true;
-                triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
-            }
-            trackChargingState = chargingState;
-
-            if (transaction) {
-                if (connectorPluggedInput && connectorPluggedInput() && !transaction->evConnected.triggered) {
-                    transaction->evConnected.triggered = true;
-                    txUpdated = true;
-                    triggerReason = TransactionEventTriggerReason::CablePluggedIn;
-                } else if (connectorPluggedInput && !connectorPluggedInput() && transaction->evConnected.triggered) {
-                    transaction->evConnected.triggered = false;
-                    txUpdated = true;
-                    triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
-                } else if (transaction->isAuthorized && !transaction->authorized.triggered) {
-                    transaction->authorized.triggered = true;
-                    txUpdated = true;
-                    triggerReason = TransactionEventTriggerReason::Authorized;
-                } else if (!transaction->isAuthorized && transaction->authorized.triggered) {
-                    transaction->authorized.triggered = false;
-                    txUpdated = true;
-                    triggerReason = TransactionEventTriggerReason::StopAuthorized;
-                } else if (evReadyInput && evReadyInput() && !transaction->powerPathClosed.triggered) {
-                    transaction->powerPathClosed.triggered = true;
-                } else if (evReadyInput && !evReadyInput() && transaction->powerPathClosed.triggered) {
-                    transaction->powerPathClosed.triggered = false;
-                }
-            }
+            txEvent->triggerReason = triggerReason;
+        }
+    }
 
-            if (txUpdated) {
-                // yes, updated
+    TransactionEventData::ChargingState chargingState = TransactionEventData::ChargingState::Idle;
+    if (connectorPluggedInput && !connectorPluggedInput()) {
+        chargingState = TransactionEventData::ChargingState::Idle;
+    } else if (!transaction || !transaction->isAuthorized) {
+        chargingState = TransactionEventData::ChargingState::EVConnected;
+    } else if (evseReadyInput && !evseReadyInput()) { 
+        chargingState = TransactionEventData::ChargingState::SuspendedEVSE;
+    } else if (evReadyInput && !evReadyInput()) {
+        chargingState = TransactionEventData::ChargingState::SuspendedEV;
+    } else if (transaction && transaction->started && transaction->active) {
+        chargingState = TransactionEventData::ChargingState::Charging;
+    }
 
-                txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
-                if (!txEvent) {
-                    // OOM
-                    return;
-                }
+    if (transaction) {
+        // update tx?
+
+        bool txUpdateCondition = false;
 
-                txEvent->eventType = TransactionEventData::Type::Updated;
+        TransactionEventTriggerReason triggerReason = TransactionEventTriggerReason::UNDEFINED;
+
+        if (chargingState != trackChargingState) {
+            txUpdateCondition = true;
+            triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
+        }
+        trackChargingState = chargingState;
+
+        if (connectorPluggedInput && connectorPluggedInput() && !transaction->trackEvConnected) {
+            transaction->trackEvConnected = true;
+            txUpdateCondition = true;
+            triggerReason = TransactionEventTriggerReason::CablePluggedIn;
+        } else if (connectorPluggedInput && !connectorPluggedInput() && transaction->trackEvConnected) {
+            transaction->trackEvConnected = false;
+            txUpdateCondition = true;
+            triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
+        } else if (transaction->isAuthorized && !transaction->trackAuthorized) {
+            transaction->trackAuthorized = true;
+            txUpdateCondition = true;
+            triggerReason = TransactionEventTriggerReason::Authorized;
+        } else if (!transaction->isAuthorized && transaction->trackAuthorized) {
+            transaction->trackAuthorized = false;
+            txUpdateCondition = true;
+            triggerReason = TransactionEventTriggerReason::StopAuthorized;
+        } else if (evReadyInput && evReadyInput() && !transaction->trackPowerPathClosed) {
+            transaction->trackPowerPathClosed = true;
+        } else if (evReadyInput && !evReadyInput() && transaction->trackPowerPathClosed) {
+            transaction->trackPowerPathClosed = false;
+        }
+
+        if (txUpdateCondition && !txEvent && transaction->started && !transaction->stopped) {
+            // yes, updated
+
+            txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
+            if (!txEvent) {
+                // OOM
+                return;
             }
+
+            txEvent->eventType = TransactionEventData::Type::Updated;
+            txEvent->triggerReason = triggerReason;
         }
     }
 
     if (txEvent) {
         txEvent->timestamp = context.getModel().getClock().now();
-        txEvent->triggerReason = triggerReason;
         txEvent->chargingState = chargingState;
         txEvent->evse = evseId;
         // meterValue not supported
 
         if (!transaction->stopIdTokenTransmitted && transaction->stopIdToken) {
             txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(*transaction->stopIdToken.get()));
+            transaction->stopIdTokenTransmitted = true;
         }  else if (!transaction->idTokenTransmitted) {
             txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(transaction->idToken));
+            transaction->idTokenTransmitted = true;
         }
     }
 
@@ -247,24 +283,6 @@ void TransactionService::Evse::loop() {
         auto txEventRequest = makeRequest(new Ocpp201::TransactionEvent(context.getModel(), txEvent));
         txEventRequest->setTimeout(0);
         context.initiateRequest(std::move(txEventRequest));
-
-        if (!transaction->stopIdTokenTransmitted && transaction->stopIdToken) {
-            transaction->stopIdTokenTransmitted = true;
-        }  else if (!transaction->idTokenTransmitted) {
-            transaction->idTokenTransmitted = true;
-        }
-
-        if (txEvent->eventType == TransactionEventData::Type::Ended) {
-            transaction->stopped = true;
-            transaction->active = false;
-            MO_DBG_DEBUG("drop completed transaction");
-            transaction.reset();
-        } else if (txEvent->eventType == TransactionEventData::Type::Started) {
-            transaction->started = true;
-            transaction->evConnected.triggered = connectorPluggedInput && connectorPluggedInput();
-            transaction->powerPathClosed.triggered = evReadyInput && evReadyInput();
-            transaction->authorized.triggered = (transaction && transaction->isAuthorized);
-        }
     }
 }
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.h b/src/MicroOcpp/Model/Transactions/TransactionService.h
index 4fb7c1a2..1112101c 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.h
@@ -39,6 +39,9 @@ class TransactionService {
         std::function<bool()> evReadyInput;
         std::function<bool()> evseReadyInput;
 
+        std::function<bool()> startTxReadyInput;
+        std::function<bool()> stopTxReadyInput;
+
         std::unique_ptr<Ocpp201::Transaction> allocateTransaction();
     public:
         Evse(Context& context, TransactionService& txService, unsigned int evseId);
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
index 929ce802..2de39cb6 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.cpp
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -12,6 +12,7 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp201::TransactionEvent;
+using namespace MicroOcpp::Ocpp201;
 
 TransactionEvent::TransactionEvent(Model& model, std::shared_ptr<TransactionEventData> txEvent)
         : model(model), txEvent(txEvent) {
@@ -22,6 +23,37 @@ const char* TransactionEvent::getOperationType() {
     return "TransactionEvent";
 }
 
+void TransactionEvent::initiate(StoredOperationHandler *opStore) {
+    if (!txEvent || !txEvent->transaction || !txEvent->transaction) {
+        MO_DBG_ERR("initialization error");
+        return;
+    }
+
+    auto transaction = txEvent->transaction;
+
+    if (txEvent->eventType == TransactionEventData::Type::Started) {
+        if (transaction->started) {
+            MO_DBG_ERR("initialization error");
+            return;
+        }
+
+        transaction->started = true;
+    }
+
+    if (txEvent->eventType == TransactionEventData::Type::Ended) {
+        if (transaction->stopped) {
+            MO_DBG_ERR("initialization error");
+            return;
+        }
+
+        transaction->stopped = true;
+    }
+
+    //commit operation and tx
+
+    MO_DBG_INFO("TransactionEvent initiated");
+}
+
 std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
                 JSON_OBJECT_SIZE(12) + //total of 12 fields
diff --git a/src/MicroOcpp/Operations/TransactionEvent.h b/src/MicroOcpp/Operations/TransactionEvent.h
index 5bfe041f..799a9687 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.h
+++ b/src/MicroOcpp/Operations/TransactionEvent.h
@@ -31,6 +31,8 @@ class TransactionEvent : public Operation {
 
     const char* getOperationType() override;
 
+    void initiate(StoredOperationHandler *opStore) override;
+
     std::unique_ptr<DynamicJsonDocument> createReq() override;
 
     void processConf(JsonObject payload) override;

From eb41d892aeeb7fdf6e4b3b5af306029907da98c0 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 18 Apr 2024 20:51:23 +0200
Subject: [PATCH 464/549] lazy initialization of diag and fw service

---
 CMakeLists.txt                                |  8 +---
 src/MicroOcpp.cpp                             | 43 +++++++++++--------
 src/MicroOcpp.h                               | 22 +++++++---
 .../Model/Diagnostics/DiagnosticsService.cpp  | 16 -------
 .../Model/Diagnostics/DiagnosticsService.h    | 14 +-----
 .../FirmwareManagement/FirmwareService.cpp    | 10 ++---
 .../FirmwareManagement/FirmwareService.h      | 10 ++---
 src/MicroOcpp/Model/Model.cpp                 |  2 +-
 8 files changed, 52 insertions(+), 73 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index d61bd6eb..1ae907fd 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,5 +1,5 @@
 # matth-x/MicroOcpp
-# Copyright Matthias Akstaller 2019 - 2023
+# Copyright Matthias Akstaller 2019 - 2024
 # MIT License
 
 cmake_minimum_required(VERSION 3.15)
@@ -104,8 +104,6 @@ if(ESP_PLATFORM)
 
     target_compile_options(${COMPONENT_TARGET} PUBLIC
         -DMO_PLATFORM=MO_PLATFORM_ESPIDF
-        -DMO_CUSTOM_WS
-        -DMO_CUSTOM_UPDATER
         -DMO_CUSTOM_RESET
         )
 
@@ -124,8 +122,6 @@ target_include_directories(MicroOcpp PUBLIC
 
 target_compile_definitions(MicroOcpp PUBLIC
     MO_PLATFORM=MO_PLATFORM_UNIX
-    MO_CUSTOM_WS
-    MO_CUSTOM_UPDATER
     MO_CUSTOM_RESET
 )
 
@@ -172,8 +168,6 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_PLATFORM=MO_PLATFORM_UNIX
     MO_NUMCONNECTORS=3
     MO_CUSTOM_TIMER
-    MO_CUSTOM_WS
-    MO_CUSTOM_UPDATER
     MO_CUSTOM_RESET
     MO_DBG_LEVEL=MO_DL_DEBUG
     MO_TRAFFIC_OUT
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 1d8915cd..6eb15c53 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -314,21 +314,12 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
             new CertificateService(*context, std::move(certStoreUse))));
     }
 
-#if !defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
+#if defined(ESP32) || defined(ESP8266)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
-        EspWiFi::makeFirmwareService(*context))); //instantiate FW service + ESP installation routine
-#else
-    model.setFirmwareService(std::unique_ptr<FirmwareService>(
-        new FirmwareService(*context))); //only instantiate FW service
-#endif
-
-#if !defined(MO_CUSTOM_DIAGNOSTICS) && !defined(MO_CUSTOM_WS)
-    model.setDiagnosticsService(std::unique_ptr<DiagnosticsService>(
-        EspWiFi::makeDiagnosticsService(*context))); //will only return "Rejected" because client needs to implement logging
-#else
-    model.setDiagnosticsService(std::unique_ptr<DiagnosticsService>(
-        new DiagnosticsService(*context)));
-#endif
+        makeDefaultFirmwareService(*context))); //instantiate FW service + ESP installation routine
+#endif //defined(ESP32) || defined(ESP8266)
+#endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
 
 #if MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
     if (!model.getResetService()->getExecuteReset())
@@ -895,19 +886,35 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute) {
     }
 }
 
-#if defined(MO_CUSTOM_UPDATER) || defined(MO_CUSTOM_WS)
 FirmwareService *getFirmwareService() {
+    if (!context) {
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
+        return nullptr;
+    }
+
     auto& model = context->getModel();
+    if (!model.getFirmwareService()) {
+        model.setFirmwareService(std::unique_ptr<FirmwareService>(
+            new FirmwareService(*context)));
+    }
+
     return model.getFirmwareService();
 }
-#endif
 
-#if defined(MO_CUSTOM_DIAGNOSTICS) || defined(MO_CUSTOM_WS)
 DiagnosticsService *getDiagnosticsService() {
+    if (!context) {
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
+        return nullptr;
+    }
+
     auto& model = context->getModel();
+    if (!model.getDiagnosticsService()) {
+        model.setDiagnosticsService(std::unique_ptr<DiagnosticsService>(
+            new DiagnosticsService(*context)));
+    }
+
     return model.getDiagnosticsService();
 }
-#endif
 
 Context *getOcppContext() {
     return context;
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index dcd16c5b..6926d27e 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -326,28 +326,35 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify); //call onResetNo
 
 void setOnResetExecute(std::function<void(bool)> onResetExecute); //reset handler. This function should reboot this controller immediately. Already defined for the ESP32 on Arduino
 
-#if defined(MO_CUSTOM_UPDATER) || defined(MO_CUSTOM_WS)
-#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
+
+namespace MicroOcpp {
+class FirmwareService;
+class DiagnosticsService;
+}
 
 /*
  * You need to configure this object if FW updates are relevant for you. This project already
  * brings a simple configuration for the ESP32 and ESP8266 for prototyping purposes, however
  * for the productive system you will have to develop a configuration targeting the specific
  * OCPP backend.
- * See MicroOcpp/Model/FirmwareManagement/FirmwareService.h 
+ * See MicroOcpp/Model/FirmwareManagement/FirmwareService.h
+ * 
+ * Lazy initialization: The FW Service will be created at the first call to this function
+ * 
+ * To use, add `#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>`
  */
 MicroOcpp::FirmwareService *getFirmwareService();
-#endif
 
-#if defined(MO_CUSTOM_DIAGNOSTICS) || defined(MO_CUSTOM_WS)
-#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
 /*
  * This library implements the OCPP messaging side of Diagnostics, but no logging or the
  * log upload to your backend.
  * To integrate Diagnostics, see MicroOcpp/Model/Diagnostics/DiagnosticsService.h
+ * 
+ * Lazy initialization: The Diag Service will be created at the first call to this function
+ * 
+ * To use, add `#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>`
  */
 MicroOcpp::DiagnosticsService *getDiagnosticsService();
-#endif
 
 /*
  * Add features and customize the behavior of the OCPP client
@@ -359,6 +366,7 @@ class Context;
 
 //Get access to internal functions and data structures. The returned Context object allows
 //you to bypass the facade functions of this header and implement custom functionality.
+//To use, add `#include <MicroOcpp/Core/Context.h>`
 MicroOcpp::Context *getOcppContext();
 
 /*
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 9a1ba5ea..99202320 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -184,19 +184,3 @@ void DiagnosticsService::setOnUpload(std::function<bool(const char *location, Ti
 void DiagnosticsService::setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput) {
     this->uploadStatusInput = uploadStatusInput;
 }
-
-#if !defined(MO_CUSTOM_DIAGNOSTICS) && !defined(MO_CUSTOM_WS)
-#if defined(ESP32) || defined(ESP8266)
-
-DiagnosticsService *EspWiFi::makeDiagnosticsService(Context& context) {
-    auto diagService = new DiagnosticsService(context);
-
-    /*
-     * add onUpload and uploadStatusInput when logging was implemented
-     */
-
-    return diagService;
-}
-
-#endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
index cd7d2654..536538a0 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef DIAGNOSTICSSERVICE_H
@@ -62,18 +62,6 @@ class DiagnosticsService {
     void setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput);
 };
 
-#if !defined(MO_CUSTOM_DIAGNOSTICS) && !defined(MO_CUSTOM_WS)
-#if defined(ESP32) || defined(ESP8266)
-
-namespace EspWiFi {
-
-DiagnosticsService *makeDiagnosticsService(Context& context);
-
-}
-
-#endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
-
 } //end namespace MicroOcpp
 
 #endif
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 709d524a..9fd19d4b 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
@@ -300,12 +300,12 @@ void FirmwareService::resetStage() {
     installationIssued = false;
 }
 
-#if !defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
 #if defined(ESP32)
 
 #include <HTTPUpdate.h>
 
-FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
+FirmwareService *makeDefaultFirmwareService(Context& context) {
     FirmwareService *fwService = new FirmwareService(context);
 
     /*
@@ -369,7 +369,7 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 
 #include <ESP8266httpUpdate.h>
 
-FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
+FirmwareService *makeDefaultFirmwareService(Context& context) {
     FirmwareService *fwService = new FirmwareService(context);
 
     fwService->setOnInstall([fwService] (const char *location) {
@@ -412,4 +412,4 @@ FirmwareService *EspWiFi::makeFirmwareService(Context& context) {
 }
 
 #endif //defined(ESP8266)
-#endif //!defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
+#endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
index cf9376d2..d3ab261a 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef FIRMWARESERVICE_H
@@ -91,18 +91,16 @@ class FirmwareService {
 
 } //endif namespace MicroOcpp
 
-#if !defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
 #if defined(ESP32) || defined(ESP8266)
 
 namespace MicroOcpp {
-namespace EspWiFi {
 
-FirmwareService *makeFirmwareService(Context& context);
+FirmwareService *makeDefaultFirmwareService(Context& context);
 
-}
 }
 
 #endif //defined(ESP32) || defined(ESP8266)
-#endif //!defined(MO_CUSTOM_UPDATER) && !defined(MO_CUSTOM_WS)
+#endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
 
 #endif
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 1441b62d..9e831322 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -257,7 +257,7 @@ void Model::updateSupportedStandardProfiles() {
         }
     }
 
-    if (firmwareService &&
+    if (firmwareService ||
             diagnosticsService) {
         if (!strstr(supportedFeatureProfilesString->getString(), "FirmwareManagement")) {
             if (!buf.empty()) buf += ',';

From 0231899a323da7e1929081da12f9e282d3489077 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 18 Apr 2024 22:30:59 +0200
Subject: [PATCH 465/549] fix FW Mngt. initialization

---
 CHANGELOG.md                                               | 1 +
 src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 85abb379..62f70991 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -31,6 +31,7 @@
 - Fix building with debug level warn and error
 - Fix transaction freeze in offline mode ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
 - Fix compilation error caused by `PRId32` ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
+- Don't load FW-mngt. module when no handlers set
 
 ## [1.0.3] - 2024-04-06
 
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 9fd19d4b..a8036f6b 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -305,7 +305,7 @@ void FirmwareService::resetStage() {
 
 #include <HTTPUpdate.h>
 
-FirmwareService *makeDefaultFirmwareService(Context& context) {
+FirmwareService *MicroOcpp::makeDefaultFirmwareService(Context& context) {
     FirmwareService *fwService = new FirmwareService(context);
 
     /*
@@ -369,7 +369,7 @@ FirmwareService *makeDefaultFirmwareService(Context& context) {
 
 #include <ESP8266httpUpdate.h>
 
-FirmwareService *makeDefaultFirmwareService(Context& context) {
+FirmwareService *MicroOcpp::makeDefaultFirmwareService(Context& context) {
     FirmwareService *fwService = new FirmwareService(context);
 
     fwService->setOnInstall([fwService] (const char *location) {

From d6e38d80dab07336982a25bb299c5b9a53ec4748 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 19 Apr 2024 12:14:17 +0200
Subject: [PATCH 466/549] undo cherry-pick

---
 src/MicroOcpp.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 6eb15c53..4bfcaf84 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -428,7 +428,7 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
     bool res = false;
     if (isTransactionActive(connectorId) && getTransactionIdTag(connectorId)) {
         //end transaction now if either idTag is nullptr (i.e. force stop) or the idTag matches beginTransaction
-        if (!idTag || !strcmp(idTag, getTransactionIdTag(connectorId))) {
+        if (!idTag || !strcmp(idTag, getTransactionIdTag())) {
             res = endTransaction_authorized(idTag, reason, connectorId);
         } else {
             MO_DBG_INFO("endTransaction: idTag doesn't match");

From 05642346d7dfc571d6a52b372c2cec86f0d98f4a Mon Sep 17 00:00:00 2001
From: Ziyad Tarek <zizoux07@gmail.com>
Date: Sun, 31 Mar 2024 00:06:50 +0200
Subject: [PATCH 467/549] fixed endTansaction method for connectors other than
 1

---
 src/MicroOcpp.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 4bfcaf84..6eb15c53 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -428,7 +428,7 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
     bool res = false;
     if (isTransactionActive(connectorId) && getTransactionIdTag(connectorId)) {
         //end transaction now if either idTag is nullptr (i.e. force stop) or the idTag matches beginTransaction
-        if (!idTag || !strcmp(idTag, getTransactionIdTag())) {
+        if (!idTag || !strcmp(idTag, getTransactionIdTag(connectorId))) {
             res = endTransaction_authorized(idTag, reason, connectorId);
         } else {
             MO_DBG_INFO("endTransaction: idTag doesn't match");

From 6812137fc9fae10edf02414ee55f8e2c828cc325 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Fri, 19 Apr 2024 17:06:51 +0200
Subject: [PATCH 468/549] immediate offline auth when WS unconnected (#282)

* add isConnected() to Connection interface

* check if WS is offline before trying online authorization

* differentiate connected and online status in tests

* add test case for direct offline authorization
---
 CHANGELOG.md                                  |  2 +
 src/MicroOcpp/Core/Connection.cpp             | 11 ++-
 src/MicroOcpp/Core/Connection.h               | 30 ++++++--
 src/MicroOcpp/Core/Context.cpp                |  4 +
 src/MicroOcpp/Core/Context.h                  |  2 +
 .../Model/ConnectorBase/Connector.cpp         |  7 ++
 tests/ChargingSessions.cpp                    | 16 ++--
 tests/ConfigurationBehavior.cpp               | 14 ++--
 tests/LocalAuthList.cpp                       | 74 ++++++++++++++-----
 9 files changed, 123 insertions(+), 37 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 62f70991..5d501de5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,11 +6,13 @@
 
 - Replace `PollResult<bool>` with enum `UnlockConnectorResult`
 - Rename master branch into main
+- Tx logic directly checks if WebSocket is offline ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
 
 ### Added
 
 - File index ([#270](https://github.com/matth-x/MicroOcpp/pull/270))
 - Config `Cst_TxStartOnPowerPathClosed` to put back TxStartPoint
+- Function `bool isConnected()` in `Connection` interface ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
 - Build flags for customizing memory limits of SmartCharging
 - Operation GetInstalledCertificateIds, UC M03 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation DeleteCertificate, UC M04 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
diff --git a/src/MicroOcpp/Core/Connection.cpp b/src/MicroOcpp/Core/Connection.cpp
index 73e64c3c..96305183 100644
--- a/src/MicroOcpp/Core/Connection.cpp
+++ b/src/MicroOcpp/Core/Connection.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/Connection.h>
@@ -10,7 +10,7 @@ using namespace MicroOcpp;
 void LoopbackConnection::loop() { }
 
 bool LoopbackConnection::sendTXT(const char *msg, size_t length) {
-    if (!connected) {
+    if (!connected || !online) {
         return false;
     }
     if (receiveTXT) {
@@ -33,6 +33,13 @@ unsigned long LoopbackConnection::getLastConnected() {
     return lastConn;
 }
 
+void LoopbackConnection::setOnline(bool online) {
+    if (online) {
+        lastConn = mocpp_tick_ms();
+    }
+    this->online = online;
+}
+
 void LoopbackConnection::setConnected(bool connected) {
     if (connected) {
         lastConn = mocpp_tick_ms();
diff --git a/src/MicroOcpp/Core/Connection.h b/src/MicroOcpp/Core/Connection.h
index 2dbed0e5..141159e3 100644
--- a/src/MicroOcpp/Core/Connection.h
+++ b/src/MicroOcpp/Core/Connection.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_CONNECTION_H
@@ -11,7 +11,7 @@
 #include <MicroOcpp/Platform.h>
 
 //On all platforms other than Arduino, the integrated WS lib (links2004/arduinoWebSockets) cannot be
-//used. On Arduino it's usage is optional.
+//used. On Arduino its usage is optional.
 #ifndef MO_CUSTOM_WS
 #if MO_PLATFORM != MO_PLATFORM_ARDUINO
 #define MO_CUSTOM_WS
@@ -46,6 +46,8 @@ class Connection {
 
     /*
      * Returns the timestamp of the last incoming message. Use mocpp_tick_ms() for creating the correct timestamp
+     *
+     * DEPRECATED: this function is superseded by isConnected(). Will be removed in MO v2.0
      */
     virtual unsigned long getLastRecv() {return 0;}
 
@@ -53,13 +55,29 @@ class Connection {
      * Returns the timestamp of the last time a connection got successfully established. Use mocpp_tick_ms() for creating the correct timestamp
      */
     virtual unsigned long getLastConnected() = 0;
+
+    /*
+     * NEW IN v1.1
+     *
+     * Returns true if the connection is open; false if the charger is known to be offline.
+     * 
+     * This function determines if MO is in "offline mode". In offline mode, MO doesn't wait for Authorize responses
+     * before performing fully local authorization. If the connection is disrupted but isConnected is still true, then
+     * MO will first wait for a timeout to expire (20 seconds) before going into offline mode.
+     * 
+     * Returning true will have no further effects other than  using the timeout-then-offline mechanism. If the
+     * connection status is uncertain, it's best to return true by default.
+     */
+    virtual bool isConnected() {return true;} //MO ignores true. This default implementation keeps backwards-compatibility
 };
 
 class LoopbackConnection : public Connection {
 private:
     ReceiveTXTcallback receiveTXT;
 
-    bool connected = true; //for simulating connection losses
+    //for simulating connection losses
+    bool online = true;
+    bool connected = true;
     unsigned long lastRecv = 0;
     unsigned long lastConn = 0;
 public:
@@ -69,8 +87,10 @@ class LoopbackConnection : public Connection {
     unsigned long getLastRecv() override;
     unsigned long getLastConnected() override;
 
-    void setConnected(bool connected);
-    bool isConnected() {return connected;}
+    void setOnline(bool online); //"online": sent messages are going through
+    bool isOnline() {return online;}
+    void setConnected(bool connected); //"connected": connection has been established, but messages may not go through (e.g. weak connection)
+    bool isConnected() override {return connected;}
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/Context.cpp b/src/MicroOcpp/Core/Context.cpp
index 1a557eab..3474ce89 100644
--- a/src/MicroOcpp/Core/Context.cpp
+++ b/src/MicroOcpp/Core/Context.cpp
@@ -68,3 +68,7 @@ OperationRegistry& Context::getOperationRegistry() {
 const ProtocolVersion& Context::getVersion() {
     return model.getVersion();
 }
+
+Connection& Context::getConnection() {
+    return connection;
+}
diff --git a/src/MicroOcpp/Core/Context.h b/src/MicroOcpp/Core/Context.h
index cdb0d80b..5c87d75b 100644
--- a/src/MicroOcpp/Core/Context.h
+++ b/src/MicroOcpp/Core/Context.h
@@ -44,6 +44,8 @@ class Context {
     OperationRegistry& getOperationRegistry();
 
     const ProtocolVersion& getVersion();
+
+    Connection& getConnection();
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 8f46c830..67ce4284 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -24,6 +24,7 @@
 #include <MicroOcpp/Model/ConnectorBase/EvseId.h>
 
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Connection.h>
 
 #ifndef MO_TX_CLEAN_ABORTED
 #define MO_TX_CLEAN_ABORTED 1
@@ -671,6 +672,12 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     auto authorize = makeRequest(new Ocpp16::Authorize(context.getModel(), idTag));
     authorize->setTimeout(authorizationTimeoutInt && authorizationTimeoutInt->getInt() > 0 ? authorizationTimeoutInt->getInt() * 1000UL : 20UL * 1000UL);
+
+    if (!context.getConnection().isConnected()) {
+        //WebSockt unconnected. Enter offline mode immediately
+        authorize->setTimeout(1);
+    }
+
     auto tx = transaction;
     authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
         JsonObject idTagInfo = response["idTagInfo"];
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 66910ff1..166b18e1 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/Context.h>
@@ -182,7 +186,7 @@ TEST_CASE( "Charging sessions" ) {
     SECTION("Preboot transactions - tx before BootNotification") {
         mocpp_deinitialize();
 
-        loopback.setConnected(false);
+        loopback.setOnline(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
@@ -232,7 +236,7 @@ TEST_CASE( "Charging sessions" ) {
                 REQUIRE((adjustmentDelay > 3600 - 10 && adjustmentDelay < 3600 + 10));
             });
         
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         loop();
 
         REQUIRE(checkStartProcessed);
@@ -243,7 +247,7 @@ TEST_CASE( "Charging sessions" ) {
 
         mocpp_deinitialize();
 
-        loopback.setConnected(false);
+        loopback.setOnline(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
@@ -273,7 +277,7 @@ TEST_CASE( "Charging sessions" ) {
             checkProcessed = true;
         });
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
 
         loop();
 
@@ -294,7 +298,7 @@ TEST_CASE( "Charging sessions" ) {
 
         mocpp_deinitialize();
 
-        loopback.setConnected(false);
+        loopback.setOnline(false);
         mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
         declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
@@ -332,7 +336,7 @@ TEST_CASE( "Charging sessions" ) {
                 REQUIRE(adjustmentDelay == 1);
             });
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
 
         loop();
 
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 9f23231c..3ec90055 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/Context.h>
@@ -143,7 +147,7 @@ TEST_CASE( "Configuration Behavior" ) {
         auto authorizationTimeoutInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "AuthorizationTimeout", 1);
         authorizationTimeoutInt->setInt(1); //try normal Authorize for 1s, then enter offline mode
 
-        loopback.setConnected(false); //connection loss
+        loopback.setOnline(false); //connection loss
 
         SECTION("set true") {
             configBool->setBool(true);
@@ -171,7 +175,7 @@ TEST_CASE( "Configuration Behavior" ) {
         }
 
         endTransaction();
-        loopback.setConnected(true);
+        loopback.setOnline(true);
     }
 
     SECTION("LocalPreAuthorize") {
@@ -187,7 +191,7 @@ TEST_CASE( "Configuration Behavior" ) {
         loopback.sendTXT(localListMsg, strlen(localListMsg));
         loop();
 
-        loopback.setConnected(false); //connection loss
+        loopback.setOnline(false); //connection loss
 
         SECTION("set true - accepted idtag") {
             configBool->setBool(true);
@@ -206,7 +210,7 @@ TEST_CASE( "Configuration Behavior" ) {
 
             REQUIRE(connector->getStatus() == ChargePointStatus::Preparing);
 
-            loopback.setConnected(true);
+            loopback.setOnline(true);
             mtime += 20000; //Authorize will be retried after a few seconds
             loop();
 
@@ -214,7 +218,7 @@ TEST_CASE( "Configuration Behavior" ) {
         }
 
         endTransaction();
-        loopback.setConnected(true);
+        loopback.setOnline(true);
     }
 
     mocpp_deinitialize();
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index 42ec4994..47e4d732 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"
@@ -92,7 +96,7 @@ TEST_CASE( "LocalAuth" ) {
         });
 
         //begin transaction and delay Authorize request - tx should start immediately
-        loopback.setConnected(false); //Authorize delayed by short offline period
+        loopback.setOnline(false); //Authorize delayed by short offline period
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -102,13 +106,13 @@ TEST_CASE( "LocalAuth" ) {
         REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
         REQUIRE( checkTxAuthorized );
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         endTransaction();
         loop();
 
         //begin transaction delay Authorize request, but idTag doesn't match local list - tx should start when online again
         checkTxAuthorized = false;
-        loopback.setConnected(false);
+        loopback.setOnline(false);
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -118,7 +122,7 @@ TEST_CASE( "LocalAuth" ) {
         REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
         REQUIRE( !checkTxAuthorized );
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         loop();
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
@@ -148,7 +152,7 @@ TEST_CASE( "LocalAuth" ) {
         });
 
         //make charger offline and begin tx - tx should begin after Authorize timeout
-        loopback.setConnected(false);
+        loopback.setOnline(false);
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -167,7 +171,7 @@ TEST_CASE( "LocalAuth" ) {
         REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
         REQUIRE( checkTxAuthorized );
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         endTransaction();
         loop();
 
@@ -178,7 +182,7 @@ TEST_CASE( "LocalAuth" ) {
                 checkTxTimeout = true;
             }
         });
-        loopback.setConnected(false);
+        loopback.setOnline(false);
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -196,7 +200,7 @@ TEST_CASE( "LocalAuth" ) {
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
         REQUIRE( checkTxTimeout );
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         loop();
     }
 
@@ -215,7 +219,7 @@ TEST_CASE( "LocalAuth" ) {
         });
 
         //make charger offline and begin tx - tx should begin after Authorize timeout
-        loopback.setConnected(false);
+        loopback.setOnline(false);
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -233,6 +237,38 @@ TEST_CASE( "LocalAuth" ) {
         REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
         REQUIRE( checkTxAuthorized );
 
+        loopback.setOnline(true);
+        endTransaction();
+        loop();
+    }
+
+    SECTION("Local auth - check WS online status") {
+
+        localAuthorizeOffline->setBool(false);
+        localPreAuthorize->setBool(false);
+        MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", true)->setBool(true);
+
+        //check TX notification
+        bool checkTxAuthorized = false;
+        setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
+            if (txNotification == TxNotification::Authorized) {
+                checkTxAuthorized = true;
+            }
+        });
+
+        //disconnect WS and begin tx - charger should enter offline mode immediately
+        loopback.setConnected(false);
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+
+        unsigned long t_before = mocpp_tick_ms();
+
+        beginTransaction("unknownIdTag");
+        loop();
+
+        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( checkTxAuthorized );
+
         loopback.setConnected(true);
         endTransaction();
         loop();
@@ -256,7 +292,7 @@ TEST_CASE( "LocalAuth" ) {
         REQUIRE( authService->getLocalAuthorization("mIdTagExpired") );
 
         //begin transaction and delay Authorize request - cannot PreAuthorize because entry is expired
-        loopback.setConnected(false); //Authorize delayed by short offline period
+        loopback.setOnline(false); //Authorize delayed by short offline period
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -265,7 +301,7 @@ TEST_CASE( "LocalAuth" ) {
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         loop();
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
@@ -274,7 +310,7 @@ TEST_CASE( "LocalAuth" ) {
         loop();
 
         //begin transaction and delay Authorize request - cannot PreAuthorize because entry is unauthorized
-        loopback.setConnected(false); //Authorize delayed by short offline period
+        loopback.setOnline(false); //Authorize delayed by short offline period
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -283,7 +319,7 @@ TEST_CASE( "LocalAuth" ) {
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         loop();
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
@@ -309,7 +345,7 @@ TEST_CASE( "LocalAuth" ) {
         REQUIRE( authService->getLocalAuthorization("mIdTagAccepted") );
 
         //begin transaction and delay Authorize request - tx should start immediately
-        loopback.setConnected(false);
+        loopback.setOnline(false);
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -318,12 +354,12 @@ TEST_CASE( "LocalAuth" ) {
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         endTransaction();
         loop();
 
         //begin transaction, but idTag is expired - AllowOfflineTxForUnknownId must not apply
-        loopback.setConnected(false);
+        loopback.setOnline(false);
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -340,7 +376,7 @@ TEST_CASE( "LocalAuth" ) {
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         loop();
     }
 
@@ -376,7 +412,7 @@ TEST_CASE( "LocalAuth" ) {
                 });});
 
         //begin transaction and delay Authorize request - tx should start immediately
-        loopback.setConnected(false); //Authorize delayed by short offline period
+        loopback.setOnline(false); //Authorize delayed by short offline period
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );
 
@@ -394,7 +430,7 @@ TEST_CASE( "LocalAuth" ) {
             }
         });
 
-        loopback.setConnected(true);
+        loopback.setOnline(true);
         loop();
 
         REQUIRE( connector->getStatus() == ChargePointStatus::Available );

From fb55b3e9fbc3252bd0e7827ff0ba811a2c430e74 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 21 Apr 2024 17:16:23 +0200
Subject: [PATCH 469/549] OCPP 2.0.1 GetBaseReport (UC B07) (#284)

* OCPP 2.0.1 UC B07 GetBaseReport

* update changelog
---
 CHANGELOG.md                                  |   2 +-
 CMakeLists.txt                                |   2 +
 src/MicroOcpp/Model/Variables/Variable.h      |  15 ++
 .../Model/Variables/VariableService.cpp       |  67 ++++-
 .../Model/Variables/VariableService.h         |   3 +
 src/MicroOcpp/Operations/GetBaseReport.cpp    |  80 ++++++
 src/MicroOcpp/Operations/GetBaseReport.h      |  50 ++++
 src/MicroOcpp/Operations/NotifyReport.cpp     | 242 ++++++++++++++++++
 src/MicroOcpp/Operations/NotifyReport.h       |  47 ++++
 9 files changed, 504 insertions(+), 4 deletions(-)
 create mode 100644 src/MicroOcpp/Operations/GetBaseReport.cpp
 create mode 100644 src/MicroOcpp/Operations/GetBaseReport.h
 create mode 100644 src/MicroOcpp/Operations/NotifyReport.cpp
 create mode 100644 src/MicroOcpp/Operations/NotifyReport.h

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5d501de5..e4e7f7b7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,7 +19,7 @@
 - Operation InstallCertificate, UC M05 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - `ProtocolVersion` selects v1.6 or v2.0.1 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
 - Build flag `MO_ENABLE_V201` set to 1 enables OCPP 2.0.1 features ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
-    - Variables (non-persistent), UCs B05 - B06 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
+    - Variables (non-persistent), UCs B05 - B07 ([#247](https://github.com/matth-x/MicroOcpp/pull/247), [#284](https://github.com/matth-x/MicroOcpp/pull/284))
     - Transactions (preview only), UCs E01 - E12 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
     - StatusNotification compatibility ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 1ae907fd..b57061bc 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -34,6 +34,7 @@ set(MO_SRC
     src/MicroOcpp/Operations/DeleteCertificate.cpp
     src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
     src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
+    src/MicroOcpp/Operations/GetBaseReport.cpp
     src/MicroOcpp/Operations/GetCompositeSchedule.cpp
     src/MicroOcpp/Operations/GetConfiguration.cpp
     src/MicroOcpp/Operations/GetDiagnostics.cpp
@@ -42,6 +43,7 @@ set(MO_SRC
     src/MicroOcpp/Operations/GetVariables.cpp
     src/MicroOcpp/Operations/Heartbeat.cpp
     src/MicroOcpp/Operations/MeterValues.cpp
+    src/MicroOcpp/Operations/NotifyReport.cpp
     src/MicroOcpp/Operations/RemoteStartTransaction.cpp
     src/MicroOcpp/Operations/RemoteStopTransaction.cpp
     src/MicroOcpp/Operations/ReserveNow.cpp
diff --git a/src/MicroOcpp/Model/Variables/Variable.h b/src/MicroOcpp/Model/Variables/Variable.h
index 9f9061bb..274416ec 100644
--- a/src/MicroOcpp/Model/Variables/Variable.h
+++ b/src/MicroOcpp/Model/Variables/Variable.h
@@ -68,6 +68,21 @@ enum class GetVariableStatus : uint8_t {
     NotSupportedAttributeType
 };
 
+// ReportBaseEnumType (3.70)
+typedef enum ReportBase {
+    ReportBase_ConfigurationInventory,
+    ReportBase_FullInventory,
+    ReportBase_SummaryInventory
+}   ReportBase;
+
+// GenericDeviceModelStatus (3.34)
+typedef enum GenericDeviceModelStatus {
+    GenericDeviceModelStatus_Accepted,
+    GenericDeviceModelStatus_Rejected,
+    GenericDeviceModelStatus_NotSupported,
+    GenericDeviceModelStatus_EmptyResultSet
+}   GenericDeviceModelStatus;
+
 // VariableMonitoringType (2.52)
 class VariableMonitor {
 public:
diff --git a/src/MicroOcpp/Model/Variables/VariableService.cpp b/src/MicroOcpp/Model/Variables/VariableService.cpp
index 94ad0822..72e4ab52 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.cpp
+++ b/src/MicroOcpp/Model/Variables/VariableService.cpp
@@ -14,6 +14,9 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/SetVariables.h>
 #include <MicroOcpp/Operations/GetVariables.h>
+#include <MicroOcpp/Operations/GetBaseReport.h>
+#include <MicroOcpp/Operations/NotifyReport.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
 
 #include <cstring>
 #include <cctype>
@@ -147,11 +150,13 @@ Variable *VariableService::getVariable(Variable::InternalDataType type, const Co
     return nullptr;
 }
 
-VariableService::VariableService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
+VariableService::VariableService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
     context.getOperationRegistry().registerOperation("SetVariables", [this] () {
         return new Ocpp201::SetVariables(*this);});
     context.getOperationRegistry().registerOperation("GetVariables", [this] () {
         return new Ocpp201::GetVariables(*this);});
+    context.getOperationRegistry().registerOperation("GetBaseReport", [this] () {
+        return new Ocpp201::GetBaseReport(*this);});
 }
 
 template<class T>
@@ -174,7 +179,7 @@ bool loadVariableFactoryDefault<const char*>(Variable& variable, const char *fac
     return variable.setString(factoryDef);
 }
 
-void loadVariableCharacteristics(Variable& variable, Variable::Mutability mutability, bool rebootRequired) {
+void loadVariableCharacteristics(Variable& variable, Variable::Mutability mutability, bool rebootRequired, Variable::InternalDataType defaultDataType) {
     if (variable.getMutability() == Variable::Mutability::ReadWrite) {
         variable.setMutability(mutability);
     }
@@ -182,6 +187,21 @@ void loadVariableCharacteristics(Variable& variable, Variable::Mutability mutabi
     if (rebootRequired) {
         variable.setRebootRequired();
     }
+
+    switch (defaultDataType) {
+        case Variable::InternalDataType::Int:
+            variable.setVariableDataType(MicroOcpp::VariableCharacteristics::DataType::integer);
+            break;
+        case Variable::InternalDataType::Bool:
+            variable.setVariableDataType(MicroOcpp::VariableCharacteristics::DataType::boolean);
+            break;
+        case Variable::InternalDataType::String:
+            variable.setVariableDataType(MicroOcpp::VariableCharacteristics::DataType::string);
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            break;
+    }
 }
 
 template<class T>
@@ -220,7 +240,7 @@ Variable *VariableService::declareVariable(const ComponentId& component, const c
         }
     }
 
-    loadVariableCharacteristics(*res, mutability, rebootRequired);
+    loadVariableCharacteristics(*res, mutability, rebootRequired, getInternalDataType<T>());
     return res;
 }
 
@@ -414,6 +434,47 @@ GetVariableStatus VariableService::getVariable(Variable::AttributeType attrType,
     }
 }
 
+GenericDeviceModelStatus VariableService::getBaseReport(int requestId, ReportBase reportBase) {
+
+    if (reportBase == ReportBase_SummaryInventory) {
+        return GenericDeviceModelStatus_NotSupported;
+    }
+
+    std::vector<Variable*> variables;
+
+    for (const auto& container : containers) {
+        if (!container->isAccessible()) {
+            // container intended for internal use only
+            continue;
+        }
+        for (size_t i = 0; i < container->size(); i++) {
+            auto variable = container->getVariable(i);
+
+            if (reportBase == ReportBase_ConfigurationInventory && variable->getMutability() == Variable::Mutability::ReadOnly) {
+                continue;
+            }
+
+            variables.push_back(variable);
+        }
+    }
+
+    if (variables.empty()) {
+        return GenericDeviceModelStatus_EmptyResultSet;
+    }
+
+    auto notifyReport = makeRequest(new Ocpp201::NotifyReport(
+            context.getModel(), 
+            requestId,
+            context.getModel().getClock().now(),
+            false,
+            0,
+            variables));
+
+    context.initiateRequest(std::move(notifyReport));
+
+    return GenericDeviceModelStatus_Accepted;
+}
+
 } // namespace MicroOcpp
 
 #endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Variables/VariableService.h b/src/MicroOcpp/Model/Variables/VariableService.h
index 2cf5b1b7..dfc4808c 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.h
+++ b/src/MicroOcpp/Model/Variables/VariableService.h
@@ -49,6 +49,7 @@ class Context;
 
 class VariableService {
 private:
+    Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
     std::vector<std::shared_ptr<VariableContainer>> containers;
 
@@ -84,6 +85,8 @@ class VariableService {
     SetVariableStatus setVariable(Variable::AttributeType attrType, const char *attrVal, const ComponentId& component, const char *variableName);
 
     GetVariableStatus getVariable(Variable::AttributeType attrType, const ComponentId& component, const char *variableName, Variable **result);
+
+    GenericDeviceModelStatus getBaseReport(int requestId, ReportBase reportBase);
 };
 
 } // namespace MicroOcpp
diff --git a/src/MicroOcpp/Operations/GetBaseReport.cpp b/src/MicroOcpp/Operations/GetBaseReport.cpp
new file mode 100644
index 00000000..3f3ab807
--- /dev/null
+++ b/src/MicroOcpp/Operations/GetBaseReport.cpp
@@ -0,0 +1,80 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Operations/GetBaseReport.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::GetBaseReport;
+
+GetBaseReport::GetBaseReport(VariableService& variableService) : variableService(variableService) {
+  
+}
+
+const char* GetBaseReport::getOperationType(){
+    return "GetBaseReport";
+}
+
+void GetBaseReport::processReq(JsonObject payload) {
+
+    int requestId = payload["requestId"] | -1;
+    if (requestId < 0) {
+        errorCode = "FormationViolation";
+        MO_DBG_ERR("invalid requestId");
+        return;
+    }
+
+    ReportBase reportBase;
+
+    const char *reportBaseCstr = payload["reportBase"] | "";
+    if (!strcmp(reportBaseCstr, "ConfigurationInventory")) {
+        reportBase = ReportBase_ConfigurationInventory;
+    } else if (!strcmp(reportBaseCstr, "FullInventory")) {
+        reportBase = ReportBase_FullInventory;
+    } else if (!strcmp(reportBaseCstr, "SummaryInventory")) {
+        reportBase = ReportBase_SummaryInventory;
+    } else {
+        errorCode = "FormationViolation";
+        MO_DBG_ERR("invalid reportBase");
+        return;
+    }
+
+    status = variableService.getBaseReport(requestId, reportBase);
+}
+
+std::unique_ptr<DynamicJsonDocument> GetBaseReport::createConf(){
+
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+
+    const char *statusCstr = "";
+
+    switch (status) {
+        case GenericDeviceModelStatus_Accepted:
+            statusCstr = "Accepted";
+            break;
+        case GenericDeviceModelStatus_Rejected:
+            statusCstr = "Rejected";
+            break;
+        case GenericDeviceModelStatus_NotSupported:
+            statusCstr = "NotSupported";
+            break;
+        case GenericDeviceModelStatus_EmptyResultSet:
+            statusCstr = "EmptyResultSet";
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            break;
+    }
+
+    payload["status"] = statusCstr;
+
+    return doc;
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/GetBaseReport.h b/src/MicroOcpp/Operations/GetBaseReport.h
new file mode 100644
index 00000000..2c276131
--- /dev/null
+++ b/src/MicroOcpp/Operations/GetBaseReport.h
@@ -0,0 +1,50 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_GETBASEREPORT_H
+#define MO_GETBASEREPORT_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <string>
+
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Model/Variables/Variable.h>
+
+namespace MicroOcpp {
+
+class VariableService;
+
+namespace Ocpp201 {
+
+
+
+class GetBaseReport : public Operation {
+private:
+    VariableService& variableService;
+
+    GenericDeviceModelStatus status;
+
+    const char *errorCode = nullptr;
+public:
+    GetBaseReport(VariableService& variableService);
+
+    const char* getOperationType() override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+
+};
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Operations/NotifyReport.cpp b/src/MicroOcpp/Operations/NotifyReport.cpp
new file mode 100644
index 00000000..9cbff693
--- /dev/null
+++ b/src/MicroOcpp/Operations/NotifyReport.cpp
@@ -0,0 +1,242 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Operations/NotifyReport.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Variables/Variable.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::NotifyReport;
+using namespace MicroOcpp::Ocpp201;
+
+NotifyReport::NotifyReport(Model& model, int requestId, const Timestamp& generatedAt, bool tbc, int seqNo, const std::vector<Variable*>& reportData)
+        : model(model), requestId(requestId), generatedAt(generatedAt), tbc(tbc), seqNo(seqNo), reportData(reportData) {
+
+}
+
+const char* NotifyReport::getOperationType() {
+    return "NotifyReport";
+}
+
+std::unique_ptr<DynamicJsonDocument> NotifyReport::createReq() {
+
+    #define VALUE_BUFSIZE 30 // for primitives (int)
+
+    const Variable::AttributeType enumerateAttributeTypes [] = {
+        Variable::AttributeType::Actual,
+        Variable::AttributeType::Target,
+        Variable::AttributeType::MinSet,
+        Variable::AttributeType::MaxSet
+    };
+
+    size_t capacity = 
+            JSON_OBJECT_SIZE(5) + //total of 5 fields
+            JSONDATE_LENGTH + 1; //timestamp string
+
+    capacity += JSON_ARRAY_SIZE(reportData.size());
+    for (auto variable : reportData) {
+        capacity += JSON_OBJECT_SIZE(4); //total of 4 fields
+        capacity += 2 * JSON_OBJECT_SIZE(2); //component composite
+        capacity += JSON_OBJECT_SIZE(1); //variable composite
+
+        size_t nAttributes = 0;
+        size_t valueCapacity = 0;
+        for (auto attributeType : enumerateAttributeTypes) {
+            if (!variable->hasAttribute(attributeType)) {
+                continue;
+            }
+            nAttributes++;
+            switch (variable->getInternalDataType()) {
+                case Variable::InternalDataType::Int: {
+                    // measure int size by printing to a dummy buf
+                    char valbuf [VALUE_BUFSIZE];
+                    auto ret = snprintf(valbuf, VALUE_BUFSIZE, "%i", variable->getInt());
+                    if (ret < 0 || ret >= VALUE_BUFSIZE) {
+                        continue;
+                    }
+                    valueCapacity = (size_t) ret + 1;
+                    break;
+                }
+                case Variable::InternalDataType::Bool:
+                    // bool will be stored in zero-copy mode (string literal "true" or "false")
+                    valueCapacity = 0;
+                    break;
+                case Variable::InternalDataType::String:
+                    valueCapacity = strlen(variable->getString()); // TODO limit by ReportingValueSize
+                    break;
+                default:
+                    MO_DBG_ERR("internal error");
+                    break;
+            }
+        }
+
+        capacity += nAttributes * JSON_OBJECT_SIZE(5); //variableAttribute composite
+        capacity += valueCapacity; //variableAttribute value total size
+
+        capacity += JSON_OBJECT_SIZE(2); //variableCharacteristics composite: only send two data fields
+    }
+
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
+
+    JsonObject payload = doc->to<JsonObject>();
+    payload["requestId"] = requestId;
+
+    char generatedAtCstr [JSONDATE_LENGTH + 1];
+    generatedAt.toJsonString(generatedAtCstr, sizeof(generatedAtCstr));
+    payload["generatedAt"] = generatedAtCstr;
+
+    if (tbc) {
+        payload["tbc"] = true;
+    }
+
+    payload["seqNo"] = seqNo;
+
+    JsonArray reportDataJsonArray = payload.createNestedArray("reportData");
+
+    for (auto variable : reportData) {
+        JsonObject reportDataJson = reportDataJsonArray.createNestedObject();
+
+        reportDataJson["component"]["name"] = (char*) variable->getComponentId().name; // force copy-mode
+
+        if (variable->getComponentId().evse.id >= 0) {
+            reportDataJson["component"]["evse"]["id"] = variable->getComponentId().evse.id;
+        }
+
+        if (variable->getComponentId().evse.connectorId >= 0) {
+            reportDataJson["component"]["evse"]["connectorId"] = variable->getComponentId().evse.connectorId;
+        }
+
+        reportDataJson["variable"]["name"] = (char*) variable->getName(); // force copy-mode
+
+        JsonArray variableAttribute = reportDataJson.createNestedArray("variableAttribute");
+
+        for (auto attributeType : enumerateAttributeTypes) {
+            if (!variable->hasAttribute(attributeType)) {
+                continue;
+            }
+
+            JsonObject attribute = variableAttribute.createNestedObject();
+
+            const char *attributeTypeCstr = nullptr;
+            switch (attributeType) {
+                case Variable::AttributeType::Actual:
+                    // leave blank when Actual
+                    break;
+                case Variable::AttributeType::Target:
+                    attributeTypeCstr = "Target";
+                    break;
+                case Variable::AttributeType::MinSet:
+                    attributeTypeCstr = "MinSet";
+                    break;
+                case Variable::AttributeType::MaxSet:
+                    attributeTypeCstr = "MaxSet";
+                    break;
+                default:
+                    MO_DBG_ERR("internal error");
+                    break;
+            }
+            if (attributeTypeCstr) {
+                attribute["type"] = attributeTypeCstr;
+            }
+
+            if (variable->getMutability() != Variable::Mutability::WriteOnly) {
+                switch (variable->getInternalDataType()) {
+                    case Variable::InternalDataType::Int: {
+                        char valbuf [VALUE_BUFSIZE];
+                        auto ret = snprintf(valbuf, VALUE_BUFSIZE, "%i", variable->getInt());
+                        if (ret < 0 || ret >= VALUE_BUFSIZE) {
+                            break;
+                        }
+                        attribute["value"] = valbuf;
+                        break;
+                    }
+                    case Variable::InternalDataType::Bool:
+                        attribute["value"] = variable->getBool() ? "true" : "false";
+                        break;
+                    case Variable::InternalDataType::String:
+                        attribute["value"] = (char*) variable->getString(); // force zero-copy mode
+                        break;
+                    default:
+                        MO_DBG_ERR("internal error");
+                        break;
+                }
+            }
+
+            const char *mutabilityCstr = nullptr;
+            switch (variable->getMutability()) {
+                case Variable::Mutability::ReadOnly:
+                    mutabilityCstr = "ReadOnly";
+                    break;
+                case Variable::Mutability::WriteOnly:
+                    mutabilityCstr = "WriteOnly";
+                    break;
+                case Variable::Mutability::ReadWrite:
+                    // leave blank when ReadWrite
+                    break;
+                default:
+                    MO_DBG_ERR("internal error");
+                    break;
+            }
+            if (mutabilityCstr) {
+                attribute["mutability"] = mutabilityCstr;
+            }
+
+            if (variable->isPersistent()) {
+                attribute["persistent"] = true;
+            }
+
+            if (variable->isConstant()) {
+                attribute["constant"] = true;
+            }
+        }
+
+        JsonObject variableCharacteristics = reportDataJson.createNestedObject("variableCharacteristics");
+
+        const char *dataTypeCstr = "";
+        switch (variable->getVariableDataType()) {
+            case VariableCharacteristics::DataType::string:
+                dataTypeCstr = "string";
+                break;
+            case VariableCharacteristics::DataType::decimal:
+                dataTypeCstr = "decimal";
+                break;
+            case VariableCharacteristics::DataType::integer:
+                dataTypeCstr = "integer";
+                break;
+            case VariableCharacteristics::DataType::dateTime:
+                dataTypeCstr = "dateTime";
+                break;
+            case VariableCharacteristics::DataType::boolean:
+                dataTypeCstr = "boolean";
+                break;
+            case VariableCharacteristics::DataType::OptionList:
+                dataTypeCstr = "OptionList";
+                break;
+            case VariableCharacteristics::DataType::SequenceList:
+                dataTypeCstr = "SequenceList";
+                break;
+            case VariableCharacteristics::DataType::MemberList:
+                dataTypeCstr = "MemberList";
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                break; 
+        }
+        variableCharacteristics["dataType"] = dataTypeCstr;
+
+        variableCharacteristics["supportsMonitoring"] = variable->getSupportsMonitoring();
+    }
+
+    return doc;
+}
+
+void NotifyReport::processConf(JsonObject payload) {
+    // empty payload
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/NotifyReport.h b/src/MicroOcpp/Operations/NotifyReport.h
new file mode 100644
index 00000000..285808e2
--- /dev/null
+++ b/src/MicroOcpp/Operations/NotifyReport.h
@@ -0,0 +1,47 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_TRANSACTIONEVENT_H
+#define MO_TRANSACTIONEVENT_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Time.h>
+
+#include <vector>
+
+namespace MicroOcpp {
+
+class Model;
+class Variable;
+
+namespace Ocpp201 {
+
+class NotifyReport : public Operation {
+private:
+    Model& model;
+
+    int requestId;
+    Timestamp generatedAt;
+    bool tbc;
+    int seqNo;
+    std::vector<Variable*> reportData;
+public:
+
+    NotifyReport(Model& model, int requestId, const Timestamp& generatedAt, bool tbc, int seqNo, const std::vector<Variable*>& reportData);
+
+    const char* getOperationType() override;
+
+    std::unique_ptr<DynamicJsonDocument> createReq() override;
+
+    void processConf(JsonObject payload) override;
+};
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+#endif // MO_ENABLE_V201
+#endif

From 76bc5b3be1e62fe9765a1c0243e9cb8c4987a47b Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 21 Apr 2024 21:10:35 +0200
Subject: [PATCH 470/549] v2.0.1 upgrade (#285)

* add ocppPermitsCharge() for v201

* update ChangeAvailability to v201

* update changelog
---
 CHANGELOG.md                                  |  1 +
 src/MicroOcpp.cpp                             | 13 +++++++
 .../Model/ConnectorBase/Connector.cpp         | 23 ++++++++++++
 .../Model/Transactions/TransactionService.cpp |  6 ++++
 .../Model/Transactions/TransactionService.h   |  2 ++
 .../Operations/ChangeAvailability.cpp         | 36 +++++++++++++++----
 6 files changed, 74 insertions(+), 7 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e4e7f7b7..06410a8e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,6 +22,7 @@
     - Variables (non-persistent), UCs B05 - B07 ([#247](https://github.com/matth-x/MicroOcpp/pull/247), [#284](https://github.com/matth-x/MicroOcpp/pull/284))
     - Transactions (preview only), UCs E01 - E12 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
     - StatusNotification compatibility ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
+    - ChangeAvailability compatibility ([#285](https://github.com/matth-x/MicroOcpp/pull/285))
 
 ### Fixed
 
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 6eb15c53..b3eb5857 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -515,6 +515,19 @@ bool ocppPermitsCharge(unsigned int connectorId) {
         MO_DBG_WARN("OCPP uninitialized");
         return false;
     }
+#if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        TransactionService::Evse *evse = nullptr;
+        if (auto txService = context->getModel().getTransactionService()) {
+            evse = txService->getEvse(connectorId);
+        }
+        if (!evse) {
+            MO_DBG_ERR("could not find EVSE");
+            return false;
+        }
+        return evse->ocppPermitsCharge();
+    }
+#endif
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 67ce4284..1f7564db 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -22,6 +22,7 @@
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
 #include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
 
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Core/Connection.h>
@@ -871,6 +872,28 @@ bool Connector::isOperative() {
         }
     }
 
+    #if MO_ENABLE_V201
+    if (model.getVersion().major == 2 && model.getTransactionService()) {
+        auto txService = model.getTransactionService();
+
+        if (connectorId == 0) {
+            for (unsigned int cId = 1; cId < model.getNumConnectors(); cId++) {
+                if (txService->getEvse(cId)->getTransaction() &&
+                        txService->getEvse(cId)->getTransaction()->started &&
+                        !txService->getEvse(cId)->getTransaction()->stopped) {
+                    return true;
+                }
+            }
+        } else {
+            if (txService->getEvse(connectorId)->getTransaction() &&
+                    txService->getEvse(connectorId)->getTransaction()->started &&
+                    !txService->getEvse(connectorId)->getTransaction()->stopped) {
+                return true;
+            }
+        }
+    }
+    #endif //MO_ENABLE_V201
+
     return availabilityVolatile && availabilityBool->getBool();
 }
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index 8a5048c9..62520f3f 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -417,6 +417,12 @@ const std::shared_ptr<MicroOcpp::Ocpp201::Transaction>& TransactionService::Evse
     return transaction;
 }
 
+bool TransactionService::Evse::ocppPermitsCharge() {
+    return transaction &&
+           transaction->active &&
+           transaction->isAuthorized;
+}
+
 bool TransactionService::isTxStartPoint(TxStartStopPoint check) {
     for (auto& v : txStartPointParsed) {
         if (v == check) {
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.h b/src/MicroOcpp/Model/Transactions/TransactionService.h
index 1112101c..0f0b78bd 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.h
@@ -59,6 +59,8 @@ class TransactionService {
         bool abortTransaction(Ocpp201::Transaction::StopReason stopReason = Ocpp201::Transaction::StopReason::Other, Ocpp201::TransactionEventTriggerReason stopTrigger = Ocpp201::TransactionEventTriggerReason::AbnormalCondition);
 
         const std::shared_ptr<Ocpp201::Transaction>& getTransaction();
+
+        bool ocppPermitsCharge();
     };
 
     friend Evse;
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.cpp b/src/MicroOcpp/Operations/ChangeAvailability.cpp
index ae66235d..517bdabb 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.cpp
+++ b/src/MicroOcpp/Operations/ChangeAvailability.cpp
@@ -1,10 +1,11 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/ChangeAvailability.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Version.h>
 
 #include <functional>
 
@@ -19,19 +20,40 @@ const char* ChangeAvailability::getOperationType(){
 }
 
 void ChangeAvailability::processReq(JsonObject payload) {
-    int connectorIdRaw = payload["connectorId"] | -1;
-    if (connectorIdRaw < 0) {
-        errorCode = "FormationViolation";
-        return;
+
+    unsigned int connectorId = 0;
+    const char *type = "_Undefined";
+
+    #if MO_ENABLE_V201
+    if (model.getVersion().major == 2) {
+        //OCPP 2.0.1
+        int connectorIdRaw = payload["evse"]["id"] | 0;
+        if (connectorIdRaw < 0) {
+            errorCode = "FormationViolation";
+            return;
+        }
+
+        connectorId = (unsigned int)connectorIdRaw;
+        type = payload["operationalStatus"] | type;
+    } else
+    #endif //MO_ENABLE_V201
+    {
+        //OCPP 1.6
+        int connectorIdRaw = payload["connectorId"] | -1;
+        if (connectorIdRaw < 0) {
+            errorCode = "FormationViolation";
+            return;
+        }
+
+        connectorId = (unsigned int)connectorIdRaw;
+        type = payload["type"] | type;
     }
-    unsigned int connectorId = (unsigned int) connectorIdRaw;
 
     if (connectorId >= model.getNumConnectors()) {
         errorCode = "PropertyConstraintViolation";
         return;
     }
 
-    const char *type = payload["type"] | "INVALID";
     bool available = false;
 
     if (!strcmp(type, "Operative")) {

From 80da31d92f39e666193c14ffbe11d1a01b84d8bd Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 Apr 2024 21:28:21 +0200
Subject: [PATCH 471/549] fix nullptr when no FW inited (#271)

---
 src/MicroOcpp.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index b3eb5857..73d6cb05 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -329,7 +329,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     model.getBootService()->setChargePointCredentials(bootNotificationCredentials);
 
     auto credsJson = model.getBootService()->getChargePointCredentials();
-    if (credsJson && credsJson->containsKey("firmwareVersion")) {
+    if (model.getFirmwareService() && credsJson && credsJson->containsKey("firmwareVersion")) {
         model.getFirmwareService()->setBuildNumber((*credsJson)["firmwareVersion"]);
     }
     credsJson.reset();

From dc825745318095c5ef9253f7b9c42574151987c9 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 28 Apr 2024 18:51:48 +0200
Subject: [PATCH 472/549] v2.0.1 Reset (UCs B11 - B12) (#286)

* implement UCs B11, B12

* add Reset test cases and fixes
---
 CHANGELOG.md                                  |   1 +
 CMakeLists.txt                                |   1 +
 README.md                                     |   3 +-
 src/MicroOcpp.cpp                             |  35 +-
 src/MicroOcpp/Model/Model.cpp                 |  12 +
 src/MicroOcpp/Model/Model.h                   |   8 +
 src/MicroOcpp/Model/Reset/ResetDefs.h         |  24 ++
 src/MicroOcpp/Model/Reset/ResetService.cpp    | 239 ++++++++++++-
 src/MicroOcpp/Model/Reset/ResetService.h      |  64 +++-
 src/MicroOcpp/Operations/Reset.cpp            |  68 ++++
 src/MicroOcpp/Operations/Reset.h              |  33 +-
 .../Operations/StatusNotification.cpp         |   2 +-
 tests/Reset.cpp                               | 314 ++++++++++++++++++
 13 files changed, 788 insertions(+), 16 deletions(-)
 create mode 100644 src/MicroOcpp/Model/Reset/ResetDefs.h
 create mode 100644 tests/Reset.cpp

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 06410a8e..e464fd1b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -23,6 +23,7 @@
     - Transactions (preview only), UCs E01 - E12 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
     - StatusNotification compatibility ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
     - ChangeAvailability compatibility ([#285](https://github.com/matth-x/MicroOcpp/pull/285))
+    - Reset compatibility, UCs B11 - B12 ([#286](https://github.com/matth-x/MicroOcpp/pull/286))
 
 ### Fixed
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index b57061bc..d4846ec7 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -140,6 +140,7 @@ set(MO_SRC_UNIT
     tests/Metering.cpp
     tests/Configuration.cpp
     tests/Reservation.cpp
+    tests/Reset.cpp
     tests/LocalAuthList.cpp
     tests/Variables.cpp
     tests/Transactions.cpp
diff --git a/README.md b/README.md
index 9bb8f15b..78505c20 100644
--- a/README.md
+++ b/README.md
@@ -80,7 +80,8 @@ The following OCPP 2.0.1 use cases are implemented:
 | UC | Description | Note |
 | :--- | :--- | :--- |
 | M03 - M05 | Certificate management | Enable Mbed-TLS to use the built-in certificate store |
-| B05 - B06 | Variables | No persistency yet |
+| B05 - B07 | Variables | No persistency yet |
+| B01 - B04<br>B11 - B12 | Provisioning | Ported from OCPP 1.6 |
 | E01 - E12 | Transactions | |
 | - | Protocol negotiation | The charger can select the OCPP version at runtime |
 
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 73d6cb05..f0b51d44 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -289,8 +289,6 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new AuthorizationService(*context, filesystem)));
     model.setReservationService(std::unique_ptr<ReservationService>(
         new ReservationService(*context, MO_NUMCONNECTORS)));
-    model.setResetService(std::unique_ptr<ResetService>(
-        new ResetService(*context)));
 
 #if MO_ENABLE_V201
     model.setVariableService(std::unique_ptr<VariableService>(
@@ -299,6 +297,18 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new TransactionService(*context)));
 #endif
 
+#if MO_ENABLE_V201
+    if (version.major == 2) {
+        //depends on VariableService
+        model.setResetServiceV201(std::unique_ptr<Ocpp201::ResetService>(
+            new Ocpp201::ResetService(*context)));
+    } else
+#endif
+    {
+        model.setResetService(std::unique_ptr<ResetService>(
+            new ResetService(*context)));
+    }
+
     std::unique_ptr<CertificateStore> certStoreUse;
     if (certStore) {
         certStoreUse = std::move(certStore);
@@ -322,8 +332,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
 #endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
 
 #if MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
-    if (!model.getResetService()->getExecuteReset())
-        model.getResetService()->setExecuteReset(makeDefaultResetFn());
+    setOnResetExecute(makeDefaultResetFn());
 #endif
 
     model.getBootService()->setChargePointCredentials(bootNotificationCredentials);
@@ -883,6 +892,15 @@ void setOnResetNotify(std::function<bool(bool)> onResetNotify) {
         return;
     }
 
+#if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (auto rService = context->getModel().getResetServiceV201()) {
+            rService->setNotifyReset([onResetNotify] (ResetType) {return onResetNotify(true);});
+        }
+        return;
+    }
+#endif
+
     if (auto rService = context->getModel().getResetService()) {
         rService->setPreReset(onResetNotify);
     }
@@ -894,6 +912,15 @@ void setOnResetExecute(std::function<void(bool)> onResetExecute) {
         return;
     }
 
+#if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (auto rService = context->getModel().getResetServiceV201()) {
+            rService->setExecuteReset([onResetExecute] () {onResetExecute(true); return true;});
+        }
+        return;
+    }
+#endif
+
     if (auto rService = context->getModel().getResetService()) {
         rService->setExecuteReset(onResetExecute);
     }
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 9e831322..58218951 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -79,6 +79,9 @@ void Model::loop() {
 #if MO_ENABLE_V201
     if (transactionService)
         transactionService->loop();
+    
+    if (resetServiceV201)
+        resetServiceV201->loop();
 #endif
 }
 
@@ -222,6 +225,15 @@ void Model::setTransactionService(std::unique_ptr<TransactionService> ts) {
 TransactionService *Model::getTransactionService() const {
     return transactionService.get();
 }
+
+void Model::setResetServiceV201(std::unique_ptr<Ocpp201::ResetService> rs) {
+    this->resetServiceV201 = std::move(rs);
+    capabilitiesUpdated = true;
+}
+
+Ocpp201::ResetService *Model::getResetServiceV201() const {
+    return resetServiceV201.get();
+}
 #endif
 
 Clock& Model::getClock() {
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 1d2dfa8a..148ff596 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -29,6 +29,10 @@ class CertificateService;
 #if MO_ENABLE_V201
 class VariableService;
 class TransactionService;
+
+namespace Ocpp201 {
+class ResetService;
+}
 #endif
 
 class Model {
@@ -50,6 +54,7 @@ class Model {
 #if MO_ENABLE_V201
     std::unique_ptr<VariableService> variableService;
     std::unique_ptr<TransactionService> transactionService;
+    std::unique_ptr<Ocpp201::ResetService> resetServiceV201;
 #endif
 
     Clock clock;
@@ -117,6 +122,9 @@ class Model {
 
     void setTransactionService(std::unique_ptr<TransactionService> ts);
     TransactionService *getTransactionService() const;
+
+    void setResetServiceV201(std::unique_ptr<Ocpp201::ResetService> rs);
+    Ocpp201::ResetService *getResetServiceV201() const;
 #endif
 
     Clock &getClock();
diff --git a/src/MicroOcpp/Model/Reset/ResetDefs.h b/src/MicroOcpp/Model/Reset/ResetDefs.h
new file mode 100644
index 00000000..baa5048d
--- /dev/null
+++ b/src/MicroOcpp/Model/Reset/ResetDefs.h
@@ -0,0 +1,24 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_RESETDEFS_H
+#define MO_RESETDEFS_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+typedef enum ResetType {
+    ResetType_Immediate,
+    ResetType_OnIdle
+}   ResetType;
+
+typedef enum ResetStatus {
+    ResetStatus_Accepted,
+    ResetStatus_Rejected,
+    ResetStatus_Scheduled
+}   ResetStatus;
+
+#endif //MO_ENABLE_V201
+#endif 
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index 43f7b680..e7624470 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Reset/ResetService.h>
@@ -14,12 +14,14 @@
 #include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Operations/StopTransaction.h>
 
-#include <MicroOcpp/Debug.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
 
-#include <memory>
-#include <string.h>
+#include <MicroOcpp/Debug.h>
 
-#define RESET_DELAY 15000
+#ifndef MO_RESET_DELAY
+#define MO_RESET_DELAY 10000
+#endif
 
 using namespace MicroOcpp;
 
@@ -38,7 +40,7 @@ ResetService::~ResetService() {
 
 void ResetService::loop() {
 
-    if (outstandingResetRetries > 0 && mocpp_tick_ms() - t_resetRetry >= RESET_DELAY) {
+    if (outstandingResetRetries > 0 && mocpp_tick_ms() - t_resetRetry >= MO_RESET_DELAY) {
         t_resetRetry = mocpp_tick_ms();
         outstandingResetRetries--;
         if (executeReset) {
@@ -111,3 +113,228 @@ std::function<void(bool isHard)> MicroOcpp::makeDefaultResetFn() {
     };
 }
 #endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
+
+#if MO_ENABLE_V201
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+ResetService::ResetService(Context& context)
+      : context(context) {
+
+    auto varService = context.getModel().getVariableService();
+    resetRetriesInt = varService->declareVariable<int>("OCPPCommCtrlr", "ResetRetries", 0);
+
+    context.getOperationRegistry().registerOperation("Reset", [this] () {
+        return new Ocpp201::Reset(*this);});
+}
+
+ResetService::~ResetService() {
+
+}
+
+ResetService::Evse::Evse(Context& context, ResetService& resetService, unsigned int evseId) : context(context), resetService(resetService), evseId(evseId) {
+    auto varService = context.getModel().getVariableService();
+    varService->declareVariable<bool>(ComponentId("EVSE", evseId), "AllowReset", true, MO_VARIABLE_FN, Variable::Mutability::ReadOnly);
+}
+
+void ResetService::Evse::loop() {
+
+    if (outstandingResetRetries && awaitTxStop) {
+
+        for (unsigned int eId = std::max(1U, evseId); eId < (evseId == 0 ? MO_NUM_EVSE : evseId + 1); eId++) {
+            //If evseId > 0, execute this block one time for evseId. If evseId == 0, then iterate over all evseIds > 0
+
+            auto txService = context.getModel().getTransactionService();
+            if (txService && txService->getEvse(eId) && txService->getEvse(eId)->getTransaction()) {
+                auto tx = txService->getEvse(eId)->getTransaction();
+
+                if (!tx->stopped) {
+                    // wait until tx stopped
+                    return;
+                }
+            }
+        }
+
+        awaitTxStop = false;
+
+        MO_DBG_INFO("Reset - tx stopped");
+        t_resetRetry = mocpp_tick_ms(); // wait for some more time until final reset
+    }
+
+    if (outstandingResetRetries && mocpp_tick_ms() - t_resetRetry >= MO_RESET_DELAY) {
+        t_resetRetry = mocpp_tick_ms();
+        outstandingResetRetries--;
+
+        MO_DBG_INFO("Reset device");
+
+        bool success = executeReset();
+
+        if (success) {
+            outstandingResetRetries = 0;
+
+            if (evseId != 0) {
+                //Set this EVSE Available again
+                if (auto connector = context.getModel().getConnector(evseId)) {
+                    connector->setAvailabilityVolatile(true);
+                }
+            }
+        } else if (!outstandingResetRetries) {
+            MO_DBG_ERR("Reset device failure");
+
+            if (evseId == 0) {
+                //Set all EVSEs Available again
+                for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
+                    auto connector = context.getModel().getConnector(cId);
+                    connector->setAvailabilityVolatile(true);
+                }
+            } else {
+                //Set only this EVSE Available
+                if (auto connector = context.getModel().getConnector(evseId)) {
+                    connector->setAvailabilityVolatile(true);
+                }
+            }
+        }
+    }
+}
+
+ResetService::Evse *ResetService::getEvse(unsigned int evseId) {
+    for (size_t i = 0; i < evses.size(); i++) {
+        if (evses[i].evseId == evseId) {
+            return &evses[i];
+        }
+    }
+    return nullptr;
+}
+
+ResetService::Evse *ResetService::getOrCreateEvse(unsigned int evseId) {
+    if (auto evse = getEvse(evseId)) {
+        return evse;
+    }
+
+    if (evseId >= MO_NUM_EVSE) {
+        MO_DBG_ERR("evseId out of bound");
+        return nullptr;
+    }
+
+    evses.emplace_back(context, *this, evseId);
+    return &evses.back();
+}
+
+void ResetService::loop() {
+    for (Evse& evse : evses) {
+        evse.loop();
+    }
+}
+
+void ResetService::setNotifyReset(std::function<bool(ResetType)> notifyReset, unsigned int evseId) {
+    Evse *evse = getOrCreateEvse(evseId);
+    if (!evse) {
+        MO_DBG_ERR("evseId not found");
+        return;
+    }
+    evse->notifyReset = notifyReset;
+}
+
+std::function<bool(ResetType)> ResetService::getNotifyReset(unsigned int evseId) {
+    Evse *evse = getOrCreateEvse(evseId);
+    if (!evse) {
+        MO_DBG_ERR("evseId not found");
+        return nullptr;
+    }
+    return evse->notifyReset;
+}
+
+void ResetService::setExecuteReset(std::function<bool()> executeReset, unsigned int evseId) {
+    Evse *evse = getOrCreateEvse(evseId);
+    if (!evse) {
+        MO_DBG_ERR("evseId not found");
+        return;
+    }
+    evse->executeReset = executeReset;
+}
+
+std::function<bool()> ResetService::getExecuteReset(unsigned int evseId) {
+    Evse *evse = getOrCreateEvse(evseId);
+    if (!evse) {
+        MO_DBG_ERR("evseId not found");
+        return nullptr;
+    }
+    return evse->executeReset;
+}
+
+ResetStatus ResetService::initiateReset(ResetType type, unsigned int evseId) {
+    auto evse = getEvse(evseId);
+    if (!evse) {
+        MO_DBG_ERR("evseId not found");
+        return ResetStatus_Rejected;
+    }
+
+    if (!evse->executeReset) {
+        MO_DBG_INFO("EVSE %u does not support Reset", evseId);
+        return ResetStatus_Rejected;
+    }
+
+    //Check if EVSEs are ready for Reset
+    for (unsigned int eId = evseId; eId < (evseId == 0 ? MO_NUM_EVSE : evseId + 1); eId++) {
+        //If evseId > 0, execute this block one time for evseId. If evseId == 0, then iterate over all evseIds
+
+        if (auto it = getEvse(eId)) {
+            if (it->notifyReset && !it->notifyReset(type)) {
+                MO_DBG_INFO("EVSE %u not able to Reset", evseId);
+                return ResetStatus_Rejected;
+            }
+        }
+    }
+
+    //Set EVSEs Unavailable
+    if (evseId == 0) {
+        //Set all EVSEs Unavailable
+        for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
+            auto connector = context.getModel().getConnector(cId);
+            connector->setAvailabilityVolatile(false);
+        }
+    } else {
+        //Set this EVSE Unavailable
+        if (auto connector = context.getModel().getConnector(evseId)) {
+            connector->setAvailabilityVolatile(false);
+        }
+    }
+
+    bool scheduled = false;
+
+    //Tx-related behavior: if immediate Reset, stop txs; otherwise schedule Reset
+    for (unsigned int eId = std::max(1U, evseId); eId < (evseId == 0 ? MO_NUM_EVSE : evseId + 1); eId++) {
+        //If evseId > 0, execute this block one time for evseId. If evseId == 0, then iterate over all evseIds > 0
+
+        auto txService = context.getModel().getTransactionService();
+        if (txService && txService->getEvse(eId) && txService->getEvse(eId)->getTransaction()) {
+            auto tx = txService->getEvse(eId)->getTransaction();
+            if (tx->active) {
+                //Tx in progress. Check behavior
+                if (type == ResetType_Immediate) {
+                    txService->getEvse(eId)->abortTransaction(Transaction::StopReason::ImmediateReset, TransactionEventTriggerReason::ResetCommand);
+                } else {
+                    scheduled = true;
+                    break;
+                }
+            }
+        }
+    }
+
+    //Actually engage Reset
+
+    if (resetRetriesInt->getInt() >= 5) {
+        MO_DBG_ERR("no. of reset trials exceeds 5");
+        evse->outstandingResetRetries = 5;
+    } else {
+        evse->outstandingResetRetries = 1 + resetRetriesInt->getInt(); //one initial try + no. of retries
+    }
+    evse->t_resetRetry = mocpp_tick_ms();
+    evse->awaitTxStop = scheduled;
+
+    return scheduled ? ResetStatus_Scheduled : ResetStatus_Accepted;
+}
+
+} //namespace MicroOcpp
+} //namespace Ocpp201
+#endif //MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Reset/ResetService.h b/src/MicroOcpp/Model/Reset/ResetService.h
index f4409aa0..88481815 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.h
+++ b/src/MicroOcpp/Model/Reset/ResetService.h
@@ -1,13 +1,16 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef RESETSERVICE_H
-#define RESETSERVICE_H
+#ifndef MO_RESETSERVICE_H
+#define MO_RESETSERVICE_H
 
 #include <functional>
+#include <vector>
 
+#include <MicroOcpp/Version.h>
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Model/Reset/ResetDefs.h>
 
 namespace MicroOcpp {
 
@@ -53,4 +56,59 @@ std::function<void(bool isHard)> makeDefaultResetFn();
 
 #endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
 
+#if MO_ENABLE_V201
+
+namespace MicroOcpp {
+
+class Variable;
+
+namespace Ocpp201 {
+
+class ResetService {
+private:
+    Context& context;
+
+    struct Evse {
+        Context& context;
+        ResetService& resetService;
+        const unsigned int evseId;
+
+        std::function<bool(ResetType type)> notifyReset; //notify firmware about a Reset command. Return true if Reset is okay; false if Reset cannot be executed
+        std::function<bool()> executeReset; //execute Reset of connector. Return true if Reset will be executed; false if there is a failure to Reset
+
+        unsigned int outstandingResetRetries = 0; //0 = do not reset device
+        unsigned long t_resetRetry;
+
+        bool awaitTxStop = false;
+
+        Evse(Context& context, ResetService& resetService, unsigned int evseId);
+
+        void loop();
+    };
+
+    std::vector<Evse> evses;
+    Evse *getEvse(unsigned int connectorId);
+    Evse *getOrCreateEvse(unsigned int connectorId);
+
+    Variable *resetRetriesInt = nullptr;
+
+public:
+    ResetService(Context& context);
+    ~ResetService();
+    
+    void loop();
+
+    void setNotifyReset(std::function<bool(ResetType)> notifyReset, unsigned int evseId = 0);
+    std::function<bool(ResetType)> getNotifyReset(unsigned int evseId = 0);
+
+    void setExecuteReset(std::function<bool()> executeReset, unsigned int evseId = 0);
+    std::function<bool()> getExecuteReset(unsigned int evseId = 0);
+
+    ResetStatus initiateReset(ResetType type, unsigned int evseId = 0);
+};
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+#endif //MO_ENABLE_V201
+
 #endif
diff --git a/src/MicroOcpp/Operations/Reset.cpp b/src/MicroOcpp/Operations/Reset.cpp
index 586bc3b7..9f61eaaf 100644
--- a/src/MicroOcpp/Operations/Reset.cpp
+++ b/src/MicroOcpp/Operations/Reset.cpp
@@ -49,3 +49,71 @@ std::unique_ptr<DynamicJsonDocument> Reset::createConf() {
     payload["status"] = resetAccepted ? "Accepted" : "Rejected";
     return doc;
 }
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+Reset::Reset(ResetService& resetService) : resetService(resetService) {
+  
+}
+
+const char* Reset::getOperationType(){
+    return "Reset";
+}
+
+void Reset::processReq(JsonObject payload) {
+
+    ResetType type;
+    const char *typeCstr = payload["type"] | "_Undefined";
+    
+    if (!strcmp(typeCstr, "Immediate")) {
+        type = ResetType_Immediate;
+    } else if (!strcmp(typeCstr, "OnIdle")) {
+        type = ResetType_OnIdle;
+    } else {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    int evseIdRaw = payload["evseId"] | 0;
+
+    if (evseIdRaw < 0 || evseIdRaw >= MO_NUM_EVSE) {
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
+
+    unsigned int evseId = (unsigned int) evseIdRaw;
+
+    status = resetService.initiateReset(type, evseId);
+}
+
+std::unique_ptr<DynamicJsonDocument> Reset::createConf() {
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+
+    const char *statusCstr = "";
+    switch (status) {
+        case ResetStatus_Accepted:
+            statusCstr = "Accepted";
+            break;
+        case ResetStatus_Rejected:
+            statusCstr = "Rejected";
+            break;
+        case ResetStatus_Scheduled:
+            statusCstr = "Scheduled";
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            break;
+    }
+    payload["status"] = statusCstr;
+    return doc;
+}
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+#endif //MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/Reset.h b/src/MicroOcpp/Operations/Reset.h
index fd150fef..212a17c2 100644
--- a/src/MicroOcpp/Operations/Reset.h
+++ b/src/MicroOcpp/Operations/Reset.h
@@ -1,11 +1,13 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef RESET_H
 #define RESET_H
 
+#include <MicroOcpp/Version.h>
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Model/Reset/ResetDefs.h>
 
 namespace MicroOcpp {
 
@@ -29,4 +31,33 @@ class Reset : public Operation {
 
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
+
+#if MO_ENABLE_V201
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+class ResetService;
+
+class Reset : public Operation {
+private:
+    ResetService& resetService;
+    ResetStatus status;
+    const char *errorCode = nullptr;
+public:
+    Reset(ResetService& resetService);
+
+    const char* getOperationType() override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+};
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
 #endif
diff --git a/src/MicroOcpp/Operations/StatusNotification.cpp b/src/MicroOcpp/Operations/StatusNotification.cpp
index 40dab1aa..81908e8f 100644
--- a/src/MicroOcpp/Operations/StatusNotification.cpp
+++ b/src/MicroOcpp/Operations/StatusNotification.cpp
@@ -139,7 +139,7 @@ std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
     payload["timestamp"] = timestamp_cstr;
     payload["connectorStatus"] = cstrFromOcppEveState(currentStatus);
     payload["evseId"] = evseId.id;
-    payload["connectorId"] = evseId.connectorId >= 0 ? evseId.connectorId : 1;
+    payload["connectorId"] = evseId.id == 0 ? 0 : evseId.connectorId >= 0 ? evseId.connectorId : 1;
 
     return doc;
 }
diff --git a/tests/Reset.cpp b/tests/Reset.cpp
new file mode 100644
index 00000000..a6206868
--- /dev/null
+++ b/tests/Reset.cpp
@@ -0,0 +1,314 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Model/Reset/ResetService.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Debug.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
+using namespace MicroOcpp;
+
+
+TEST_CASE( "Reset" ) {
+    printf("\nRun %s\n",  "Reset");
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+    mocpp_initialize(loopback,
+            ChargerCredentials("test-runner1234"),
+            makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail),
+            false,
+            ProtocolVersion(2,0,1));
+
+    auto context = getOcppContext();
+
+    mocpp_set_timer(custom_timer_cb);
+
+    // Register Reset handlers
+    bool checkNotified [MO_NUM_EVSE] = {false};
+    bool checkExecuted [MO_NUM_EVSE] = {false};
+
+    setOnResetNotify([&checkNotified] (bool) {
+        MO_DBG_DEBUG("Notify");
+        checkNotified[0] = true;
+        return true;
+    });
+    context->getModel().getResetServiceV201()->setExecuteReset([&checkExecuted] () {
+        MO_DBG_DEBUG("Execute");
+        checkExecuted[0] = true;
+        return false; // Reset fails because we're not actually exiting the process
+    });
+    
+    for (size_t i = 1; i < MO_NUM_EVSE; i++) {
+        context->getModel().getResetServiceV201()->setNotifyReset([&checkNotified, i] (ResetType) {
+            MO_DBG_DEBUG("Notify %zu", i);
+            checkNotified[i] = true;
+            return true;
+        }, i);
+        context->getModel().getResetServiceV201()->setExecuteReset([&checkExecuted, i] () {
+            MO_DBG_DEBUG("Execute %zu", i);
+            checkExecuted[i] = true;
+            return true;
+        }, i);
+    }
+
+    loop();
+
+    SECTION("Schedule full charger Reset") {
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+        REQUIRE( context->getModel().getTransactionService()->getEvse(2)->getTransaction() == nullptr );
+        
+        context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken");
+        setConnectorPluggedInput([] () {return true;}, 1);
+        setEvReadyInput([] () {return true;}, 1);
+        setEvseReadyInput([] () {return true;}, 1);
+
+        context->getModel().getTransactionService()->getEvse(2)->beginAuthorization("mIdToken2");
+        setConnectorPluggedInput([] () {return true;}, 2);
+        setEvReadyInput([] () {return true;}, 2);
+        setEvseReadyInput([] () {return true;}, 2);
+
+        loop();
+
+        REQUIRE( ocppPermitsCharge(1) );
+        REQUIRE( ocppPermitsCharge(2) );
+
+        bool checkProcessed = false;
+
+        auto resetRequest = makeRequest(new Ocpp16::CustomOperation(
+                "Reset",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["type"] = "OnIdle";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE(!strcmp(payload["status"], "Scheduled"));
+                }
+        ));
+
+        context->initiateRequest(std::move(resetRequest));
+
+        loop();
+        mtime += 30000; // Reset has some delays to ensure that the WS is not cut off immediately
+        loop();
+
+        REQUIRE(checkProcessed);
+
+        for (size_t i = 0; i < MO_NUM_EVSE; i++) {
+            REQUIRE( checkNotified[i] );
+        }
+
+        // Still scheduled
+        REQUIRE( ocppPermitsCharge(1) );
+        REQUIRE( ocppPermitsCharge(2) );
+
+        context->getModel().getTransactionService()->getEvse(1)->endAuthorization("mIdToken");
+        setConnectorPluggedInput([] () {return false;}, 1);
+        setEvReadyInput([] () {return false;}, 1);
+        setEvseReadyInput([] () {return false;}, 1);
+        loop();
+
+        // Still scheduled
+        REQUIRE( !ocppPermitsCharge(1) );
+        REQUIRE( ocppPermitsCharge(2) );
+
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Unavailable );
+
+        context->getModel().getTransactionService()->getEvse(2)->endAuthorization("mIdToken");
+        setConnectorPluggedInput([] () {return false;}, 2);
+        setEvReadyInput([] () {return false;}, 2);
+        setEvseReadyInput([] () {return false;}, 2);
+
+        loop();
+        mtime += 30000; // Reset has some delays to ensure that the WS is not cut off immediately
+        loop();
+
+        // Not scheduled anymore; execute Reset
+        REQUIRE( !ocppPermitsCharge(1) );
+        REQUIRE( !ocppPermitsCharge(2) );
+
+        REQUIRE( checkExecuted[0] );
+
+        // Technically, Reset failed at this point, because the program is still running. Check if connectors are Available agin
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus::Available );
+    }
+
+    SECTION("Immediate full charger Reset") {
+
+        context->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+        REQUIRE( context->getModel().getTransactionService()->getEvse(2)->getTransaction() == nullptr );
+        
+        context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken");
+
+        context->getModel().getTransactionService()->getEvse(2)->beginAuthorization("mIdToken2");
+
+        loop();
+
+        REQUIRE( ocppPermitsCharge(1) );
+        REQUIRE( ocppPermitsCharge(2) );
+
+        bool checkProcessedTx = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("TransactionEvent", [&checkProcessedTx] () {
+            return new Ocpp16::CustomOperation("TransactionEvent",
+                [&checkProcessedTx] (JsonObject payload) {
+                    //process req
+                    checkProcessedTx = true;
+
+                    REQUIRE(!strcmp(payload["eventType"], "Ended"));
+                    REQUIRE(!strcmp(payload["triggerReason"], "ResetCommand"));
+                    REQUIRE(!strcmp(payload["transactionInfo"]["stoppedReason"], "ImmediateReset"));
+                },
+                [] () {
+                    //create conf
+                    return createEmptyDocument();
+                });});
+
+        bool checkProcessed = false;
+
+        auto resetRequest = makeRequest(new Ocpp16::CustomOperation(
+                "Reset",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["type"] = "Immediate";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE(!strcmp(payload["status"], "Accepted"));
+                }
+        ));
+
+        context->initiateRequest(std::move(resetRequest));
+
+        loop();
+        mtime += 30000; // Reset has some delays to ensure that the WS is not cut off immediately
+        loop();
+
+        REQUIRE(checkProcessed);
+        REQUIRE(checkProcessedTx);
+
+        for (size_t i = 0; i < MO_NUM_EVSE; i++) {
+            REQUIRE( checkNotified[i] );
+        }
+
+        // Stopped Tx
+        REQUIRE( !ocppPermitsCharge(1) );
+        REQUIRE( !ocppPermitsCharge(2) );
+
+        REQUIRE( checkExecuted[0] );
+
+        loop();
+
+        // Technically, Reset failed at this point, because the program is still running. Check if connectors are Available agin
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus::Available );
+    }
+
+    SECTION("Reject Reset") {
+        
+        context->getModel().getResetServiceV201()->setNotifyReset([&checkNotified] (ResetType) {
+            MO_DBG_DEBUG("Reject Reset");
+            checkNotified[2] = true;
+            return false;
+        }, 2);
+
+        bool checkProcessed = false;
+
+        auto resetRequest = makeRequest(new Ocpp16::CustomOperation(
+                "Reset",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["type"] = "Immediate";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE(!strcmp(payload["status"], "Rejected"));
+                }
+        ));
+
+        context->initiateRequest(std::move(resetRequest));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+        REQUIRE(checkNotified[2]);
+
+        REQUIRE( context->getModel().getConnector(0)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus::Available );
+    }
+
+    SECTION("Reset single EVSE") {
+
+        bool checkProcessed = false;
+
+        auto resetRequest = makeRequest(new Ocpp16::CustomOperation(
+                "Reset",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["type"] = "OnIdle";
+                    payload["evseId"] = 1;
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE(!strcmp(payload["status"], "Accepted"));
+                }
+        ));
+
+        context->initiateRequest(std::move(resetRequest));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+        REQUIRE(checkNotified[1]);
+
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Unavailable );
+        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus::Available );
+
+        mtime += 30000; // Reset has some delays to ensure that the WS is not cut off immediately
+        loop();
+
+        REQUIRE(checkExecuted[1]);
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Available );
+    }
+
+    mocpp_deinitialize();
+}
+
+#endif // MO_ENABLE_V201

From 2020ba7320d9941c8cc3420f0c4ab052453f12b6 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 28 Apr 2024 20:08:04 +0200
Subject: [PATCH 473/549] fix offline txs, add SCons, more tests (#287)

* add contributions

* clean patches (#287)
---
 CHANGELOG.md                                  |   3 +-
 SConscript.py                                 |  50 ++++
 .../Core/RequestQueueStorageStrategy.cpp      |   4 +-
 .../Model/Diagnostics/DiagnosticsService.cpp  |   2 +-
 .../Model/Transactions/Transaction.cpp        |   6 +-
 .../Model/Transactions/Transaction.h          |   1 +
 .../Transactions/TransactionDeserialize.cpp   |   4 +-
 src/MicroOcpp/Operations/GetConfiguration.cpp |   4 +-
 tests/ChargingSessions.cpp                    | 275 ++++++++++++++++++
 9 files changed, 340 insertions(+), 9 deletions(-)
 create mode 100644 SConscript.py

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e464fd1b..682e69bb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,7 @@
 - Config `Cst_TxStartOnPowerPathClosed` to put back TxStartPoint
 - Function `bool isConnected()` in `Connection` interface ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
 - Build flags for customizing memory limits of SmartCharging
+- SConscript ([#287](https://github.com/matth-x/MicroOcpp/pull/287))
 - Operation GetInstalledCertificateIds, UC M03 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation DeleteCertificate, UC M04 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
 - Operation InstallCertificate, UC M05 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
@@ -33,7 +34,7 @@
 - Ignore UnlockConnector when handler not set
 - Reject ChargingProfile if unit not supported
 - Fix building with debug level warn and error
-- Fix transaction freeze in offline mode ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
+- Fix transaction freeze in offline mode ([#279](https://github.com/matth-x/MicroOcpp/pull/279), [#287](https://github.com/matth-x/MicroOcpp/pull/287))
 - Fix compilation error caused by `PRId32` ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
 - Don't load FW-mngt. module when no handlers set
 
diff --git a/SConscript.py b/SConscript.py
new file mode 100644
index 00000000..5bccda82
--- /dev/null
+++ b/SConscript.py
@@ -0,0 +1,50 @@
+# matth-x/MicroOcpp
+# Copyright Matthias Akstaller 2019 - 2024
+# MIT License
+
+# NOTE: This SConscript is still WIP. It has thankfully been contributed from a project using SCons,
+#       not necessarily considering full reusability in other projects though.
+#       Use this file as a starting point for writing your own SCons integration. And as always, any
+#       contributions are highly welcome!
+
+Import("env", "ARDUINOJSON_DIR")
+
+import os, pathlib
+
+def getAllDirs(root_dir):
+    dir_list = []
+    for root, subfolders, files in os.walk(root_dir.abspath):
+        dir_list.append(Dir(root))
+    return dir_list
+
+SOURCE_DIR = Dir(".").srcnode()
+
+source_dirs = getAllDirs(SOURCE_DIR.Dir("src"))
+source_dirs += getAllDirs(ARDUINOJSON_DIR.Dir("src"))
+
+source_files = []
+
+for folder in source_dirs:
+    source_files += folder.glob("*.cpp")
+    env["CPPPATH"].append(folder)
+
+compiled_objects = []
+for source_file in source_files:
+    obj = env.Object(
+        target = pathlib.Path(source_file.path).stem
+        + ".o",
+        source=source_file,
+    )
+    compiled_objects.append(obj)
+
+libmicroocpp = env.StaticLibrary(
+    target='libmicroocpp',
+    source=sorted(compiled_objects)
+)
+
+exports = {
+    'library': libmicroocpp,
+    'CPPPATH': source_dirs.copy()
+}
+
+Return("exports")
diff --git a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
index 507f4a7f..a9b61422 100644
--- a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
+++ b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/RequestQueueStorageStrategy.h>
@@ -104,12 +104,12 @@ Request *PersistentRequestQueue::front() {
         tailCache.pop_front();
     } else {
         //cache miss -> case B) or A) -> try to fetch operation from flash (check for case B)) or take first cached element as front
-        auto storageHandler = opStore.makeOpHandler();
         
         std::unique_ptr<Request> fetched;
 
         unsigned int range = (opStore.getOpEnd() + MO_MAX_OPNR - nextOpNr) % MO_MAX_OPNR;
         for (size_t i = 0; i < range; i++) {
+            auto storageHandler = opStore.makeOpHandler();
             bool exists = storageHandler->restore(nextOpNr);
             if (exists) {
                 //case B) -> load operation from flash and take it as front element
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 99202320..90a86e46 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -48,7 +48,7 @@ void DiagnosticsService::loop() {
         if (uploadIssued) {
             if (uploadStatusInput != nullptr && uploadStatusInput() == UploadStatus::Uploaded) {
                 //success!
-                MO_DBG_DEBUG("end upload routine (by status)")
+                MO_DBG_DEBUG("end upload routine (by status)");
                 uploadIssued = false;
                 retries = 0;
             }
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.cpp b/src/MicroOcpp/Model/Transactions/Transaction.cpp
index 9c6535fa..a7846265 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.cpp
+++ b/src/MicroOcpp/Model/Transactions/Transaction.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Transactions/Transaction.h>
@@ -73,6 +73,10 @@ int32_t ocpp_tx_getMeterStop(OCPP_Transaction *tx) {
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getMeterStop();
 }
 
+void ocpp_tx_setMeterStop(OCPP_Transaction* tx, int32_t meter) {
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->setMeterStop(meter);
+}
+
 bool ocpp_tx_getStopTimestamp(OCPP_Transaction *tx, char *buf, size_t len) {
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getStopTimestamp().toJsonString(buf, len);
 }
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index f02b2c09..788655c2 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -347,6 +347,7 @@ bool ocpp_tx_getStartTimestamp(OCPP_Transaction *tx, char *buf, size_t len);
 const char *ocpp_tx_getStopIdTag(OCPP_Transaction *tx);
 
 int32_t ocpp_tx_getMeterStop(OCPP_Transaction *tx);
+void ocpp_tx_setMeterStop(OCPP_Transaction* tx, int32_t meter);
 
 bool ocpp_tx_getStopTimestamp(OCPP_Transaction *tx, char *buf, size_t len);
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
index b1262ff5..895c1634 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <limits>
@@ -234,7 +234,7 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
         tx.setSilent();
     }
 
-    MO_DBG_DEBUG("DUMP TX");
+    MO_DBG_DEBUG("DUMP TX (%s)", tx.getIdTag() ? tx.getIdTag() : "idTag missing");
     MO_DBG_DEBUG("Session   | idTag %s, active: %i, authorized: %i, deauthorized: %i", tx.getIdTag(), tx.isActive(), tx.isAuthorized(), tx.isIdTagDeauthorized());
     MO_DBG_DEBUG("Start RPC | req: %i, conf: %i", tx.getStartSync().isRequested(), tx.getStartSync().isConfirmed());
     MO_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  tx.getStopSync().isRequested(), tx.getStopSync().isConfirmed());
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index a8b3804c..1dbaabb2 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/GetConfiguration.h>
@@ -135,7 +135,7 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
     if (!unknownKeys.empty()) {
         JsonArray jsonUnknownKey = payload.createNestedArray("unknownKey");
         for (auto key : unknownKeys) {
-            MO_DBG_DEBUG("Unknown key: %s", key)
+            MO_DBG_DEBUG("Unknown key: %s", key);
             jsonUnknownKey.add(key);
         }
     }
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 166b18e1..e6cc8bf5 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -11,6 +11,8 @@
 #include <MicroOcpp/Operations/BootNotification.h>
 #include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Debug.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
@@ -343,6 +345,279 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE(checkProcessed);
     }
 
+    SECTION("Preboot transactions - reject tx if limit exceeded") {
+        mocpp_deinitialize();
+
+        loopback.setConnected(false);
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "SilentOfflineTransactions", false, CONFIGURATION_FN)->setBool(false); // do not start more txs if tx journal is full
+        configuration_save();
+
+        loop();
+
+        for (size_t i = 0; i < MO_TXRECORD_SIZE; i++) {
+            beginTransaction_authorized("mIdTag");
+
+            loop();
+
+            REQUIRE(isTransactionRunning());
+
+            endTransaction();
+
+            loop();
+
+            REQUIRE(!isTransactionRunning());
+        }
+
+        // now, tx journal is full. Block any further charging session
+
+        auto tx = beginTransaction_authorized("mIdTag");
+        REQUIRE( !tx );
+
+        loop();
+
+        REQUIRE(!isTransactionRunning());
+        REQUIRE(!ocppPermitsCharge());
+
+        // Check if all 4 cached transctions are transmitted after going online
+
+        const int txId_base = 10000;
+        int txId_generate = txId_base;
+        int txId_confirm = txId_base;
+
+        getOcppContext()->getOperationRegistry().registerOperation("StartTransaction", [&txId_generate] () {
+            return new Ocpp16::CustomOperation("StartTransaction",
+                [] (JsonObject payload) {}, //ignore req
+                [&txId_generate] () {
+                    //create conf
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    JsonObject payload = doc->to<JsonObject>();
+
+                    JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
+                    idTagInfo["status"] = "Accepted";
+                    txId_generate++;
+                    payload["transactionId"] = txId_generate;
+                    return doc;
+                });});
+
+        getOcppContext()->getOperationRegistry().registerOperation("StopTransaction", [&txId_generate, &txId_confirm] () {
+            return new Ocpp16::CustomOperation("StopTransaction",
+                [&txId_generate, &txId_confirm] (JsonObject payload) {
+                    //receive req
+                    REQUIRE( payload["transactionId"].as<int>() == txId_generate );
+                    REQUIRE( payload["transactionId"].as<int>() == txId_confirm + 1 );
+                    txId_confirm = payload["transactionId"].as<int>();
+                }, 
+                [] () {
+                    //create conf
+                    return createEmptyDocument();
+                });});
+
+        loopback.setConnected(true);
+        loop();
+
+        REQUIRE( txId_confirm == txId_base + MO_TXRECORD_SIZE );
+    }
+
+    SECTION("Preboot transactions - charge without tx if limit exceeded") {
+        mocpp_deinitialize();
+
+        loopback.setConnected(false);
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "SilentOfflineTransactions", false, CONFIGURATION_FN)->setBool(true); // don't report further transactions to server but charge anyway
+        configuration_save();
+
+        loop();
+
+        for (size_t i = 0; i < MO_TXRECORD_SIZE; i++) {
+            beginTransaction_authorized("mIdTag");
+
+            loop();
+
+            REQUIRE(isTransactionRunning());
+
+            endTransaction();
+
+            loop();
+
+            REQUIRE(!isTransactionRunning());
+        }
+
+        // now, tx journal is full. Block any further charging session
+
+        auto tx = beginTransaction_authorized("mIdTag");
+        REQUIRE( tx );
+
+        loop();
+
+        REQUIRE(isTransactionRunning());
+        REQUIRE(ocppPermitsCharge());
+
+        endTransaction();
+
+        loop();
+
+        // Check if all 4 cached transctions are transmitted after going online
+
+        const int txId_base = 10000;
+        int txId_generate = txId_base;
+        int txId_confirm = txId_base;
+
+        getOcppContext()->getOperationRegistry().registerOperation("StartTransaction", [&txId_generate] () {
+            return new Ocpp16::CustomOperation("StartTransaction",
+                [] (JsonObject payload) {}, //ignore req
+                [&txId_generate] () {
+                    //create conf
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    JsonObject payload = doc->to<JsonObject>();
+
+                    JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
+                    idTagInfo["status"] = "Accepted";
+                    txId_generate++;
+                    payload["transactionId"] = txId_generate;
+                    return doc;
+                });});
+
+        getOcppContext()->getOperationRegistry().registerOperation("StopTransaction", [&txId_generate, &txId_confirm] () {
+            return new Ocpp16::CustomOperation("StopTransaction",
+                [&txId_generate, &txId_confirm] (JsonObject payload) {
+                    //receive req
+                    REQUIRE( payload["transactionId"].as<int>() == txId_generate );
+                    REQUIRE( payload["transactionId"].as<int>() == txId_confirm + 1 );
+                    txId_confirm = payload["transactionId"].as<int>();
+                }, 
+                [] () {
+                    //create conf
+                    return createEmptyDocument();
+                });});
+
+        loopback.setConnected(true);
+        loop();
+
+        REQUIRE( txId_confirm == txId_base + MO_TXRECORD_SIZE );
+    }
+
+    SECTION("Preboot transactions - mix PreBoot with Offline tx") {
+        
+        /*
+         * The charger boots and connects to the OCPP server normally. It looses connection and then starts
+         * transaction #1 which is persisted on flash. Then a power loss occurs, but the charger doesn't reconnect.
+         * Start transaction #2 in PreBoot mode. Trigger another power loss, start transaction #3 while still
+         * being offline and then, after reconnection to the server, transaction #4.
+         * 
+         * Tx #1 can be fully restored. The timestamp information for Tx #2 is missing, so it is discarded. Tx #3 is
+         * missing absolute timestamps at first, but after reconnection with the server, the timestamps get updated
+         * with absolute values from the server. Tx #4 is the standard case for transactions and should start normally.
+         */
+
+        // use idTags to identify the transactions
+        const char *tx1_idTag = "Tx#1";
+        const char *tx2_idTag = "Tx#2";
+        const char *tx3_idTag = "Tx#3";
+        const char *tx4_idTag = "Tx#4";
+
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
+        configuration_save();
+        loop();
+
+        // start Tx #1 (offline tx)
+        loopback.setConnected(false);
+
+        MO_DBG_DEBUG("begin tx (%s)", tx1_idTag);
+        beginTransaction_authorized(tx1_idTag);
+        loop();
+        REQUIRE(isTransactionRunning());
+        endTransaction();
+        loop();
+        REQUIRE(!isTransactionRunning());
+
+        // first power cycle
+        mocpp_deinitialize();
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        loop();
+
+        // start Tx #2 (PreBoot tx, won't get timestamp)
+
+        MO_DBG_DEBUG("begin tx (%s)", tx2_idTag);
+        beginTransaction_authorized(tx2_idTag);
+        loop();
+        REQUIRE(isTransactionRunning());
+        endTransaction();
+        loop();
+        REQUIRE(!isTransactionRunning());
+
+        // second power cycle
+        mocpp_deinitialize();
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        loop();
+
+        // start Tx #3 (PreBoot tx, will eventually get timestamp)
+
+        MO_DBG_DEBUG("begin tx (%s)", tx3_idTag);
+        beginTransaction_authorized(tx3_idTag);
+        loop();
+        REQUIRE(isTransactionRunning());
+        endTransaction();
+        loop();
+        REQUIRE(!isTransactionRunning());
+
+        // set up checks before getting online and starting Tx #4
+        bool check_1 = false, check_2 = false, check_3 = false, check_4 = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("StartTransaction", 
+                [&check_1, &check_2, &check_3, &check_4,
+                        tx1_idTag, tx2_idTag, tx3_idTag, tx4_idTag] () {
+            return new Ocpp16::CustomOperation("StartTransaction",
+                [&check_1, &check_2, &check_3, &check_4,
+                        tx1_idTag, tx2_idTag, tx3_idTag, tx4_idTag] (JsonObject payload) {
+                    //process req
+                    const char *idTag = payload["idTag"] | "_Undefined";
+                    if (!strcmp(idTag, tx1_idTag )) {
+                        check_1 = true;
+                    } else if (!strcmp(idTag, tx2_idTag )) {
+                        check_2 = true;
+                    } else if (!strcmp(idTag, tx3_idTag )) {
+                        check_3 = true;
+                    } else if (!strcmp(idTag, tx4_idTag )) {
+                        check_4 = true;
+                    }
+                },
+                [] () {
+                    //create conf
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    JsonObject payload = doc->to<JsonObject>();
+
+                    JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
+                    idTagInfo["status"] = "Accepted";
+                    static int uniqueTxId = 1000;
+                    payload["transactionId"] = uniqueTxId++; //sample data for debug purpose
+                    return doc;
+                });});
+        
+        // get online
+        loopback.setConnected(true);
+        loop();
+
+        // start Tx #4
+        MO_DBG_DEBUG("begin tx (%s)", tx4_idTag);
+        beginTransaction_authorized(tx4_idTag);
+        loop();
+        REQUIRE(isTransactionRunning());
+        endTransaction();
+        loop();
+        REQUIRE(!isTransactionRunning());
+
+        // evaluate results
+        REQUIRE( check_1 );
+        REQUIRE( !check_2 ); // critical data for Tx #2 got lost so it must be discarded
+        REQUIRE( check_3 );
+        REQUIRE( check_4 );
+    }
+
     SECTION("Set Unavaible"){
 
         beginTransaction("mIdTag");

From ffbb6e4f26dc614db14a353877e6cad9446d60a6 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Wed, 1 May 2024 20:28:29 +0200
Subject: [PATCH 474/549] v2.0.1 RequestStart/-StopTx (UCs F01 - F02) (#289)

* adopt v201_ed2 PowerPathClosed

* allow tx on evseId 0

* add RequestStart-/StopTransaction

* update changelog
---
 CHANGELOG.md                                  |   1 +
 CMakeLists.txt                                |   2 +
 README.md                                     |   5 +-
 src/MicroOcpp/Model/Authorization/IdToken.cpp |  36 +++
 src/MicroOcpp/Model/Authorization/IdToken.h   |   2 +
 .../Model/Transactions/Transaction.h          |  13 +-
 .../Model/Transactions/TransactionDefs.h      |  20 ++
 .../Model/Transactions/TransactionService.cpp | 244 ++++++++++++++----
 .../Model/Transactions/TransactionService.h   |  15 +-
 src/MicroOcpp/Operations/GetBaseReport.h      |   2 -
 .../Operations/RequestStartTransaction.cpp    |  76 ++++++
 .../Operations/RequestStartTransaction.h      |  48 ++++
 .../Operations/RequestStopTransaction.cpp     |  59 +++++
 .../Operations/RequestStopTransaction.h       |  47 ++++
 src/MicroOcpp/Operations/TransactionEvent.cpp |   4 +-
 15 files changed, 503 insertions(+), 71 deletions(-)
 create mode 100644 src/MicroOcpp/Model/Transactions/TransactionDefs.h
 create mode 100644 src/MicroOcpp/Operations/RequestStartTransaction.cpp
 create mode 100644 src/MicroOcpp/Operations/RequestStartTransaction.h
 create mode 100644 src/MicroOcpp/Operations/RequestStopTransaction.cpp
 create mode 100644 src/MicroOcpp/Operations/RequestStopTransaction.h

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 682e69bb..f367f5df 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -25,6 +25,7 @@
     - StatusNotification compatibility ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
     - ChangeAvailability compatibility ([#285](https://github.com/matth-x/MicroOcpp/pull/285))
     - Reset compatibility, UCs B11 - B12 ([#286](https://github.com/matth-x/MicroOcpp/pull/286))
+    - RequestStart-/StopTransaction, UCs F01 - F02 ([#289](https://github.com/matth-x/MicroOcpp/pull/289))
 
 ### Fixed
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index d4846ec7..4b4dccc4 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -46,6 +46,8 @@ set(MO_SRC
     src/MicroOcpp/Operations/NotifyReport.cpp
     src/MicroOcpp/Operations/RemoteStartTransaction.cpp
     src/MicroOcpp/Operations/RemoteStopTransaction.cpp
+    src/MicroOcpp/Operations/RequestStartTransaction.cpp
+    src/MicroOcpp/Operations/RequestStopTransaction.cpp
     src/MicroOcpp/Operations/ReserveNow.cpp
     src/MicroOcpp/Operations/Reset.cpp
     src/MicroOcpp/Operations/SendLocalList.cpp
diff --git a/README.md b/README.md
index 78505c20..05814a92 100644
--- a/README.md
+++ b/README.md
@@ -80,12 +80,13 @@ The following OCPP 2.0.1 use cases are implemented:
 | UC | Description | Note |
 | :--- | :--- | :--- |
 | M03 - M05 | Certificate management | Enable Mbed-TLS to use the built-in certificate store |
-| B05 - B07 | Variables | No persistency yet |
+| B05 - B07 | Variables | |
 | B01 - B04<br>B11 - B12 | Provisioning | Ported from OCPP 1.6 |
 | E01 - E12 | Transactions | |
+| F01 - F02 | Remote Start/Stop Tx | |
 | - | Protocol negotiation | The charger can select the OCPP version at runtime |
 
-The OCPP 2.0.1 features are in an early development stage. By default, they are disabled and excluded from the build, so they have no impact on the firmware size. To enable, set the build flag `MO_ENABLE_V201=1` and initialize the library with the ProtocolVersion parameter `2.0.1`  (see [this example](https://github.com/matth-x/MicroOcppSimulator/blob/657e606c3b178d3add242935d413c72624130ff3/src/main.cpp#L43-L47) in the Simulator).
+The OCPP 2.0.1 features are in an alpha development stage (no persistency yet). By default, they are disabled and excluded from the build, so they have no impact on the firmware size. To enable, set the build flag `MO_ENABLE_V201=1` and initialize the library with the ProtocolVersion parameter `2.0.1`  (see [this example](https://github.com/matth-x/MicroOcppSimulator/blob/657e606c3b178d3add242935d413c72624130ff3/src/main.cpp#L43-L47) in the Simulator).
 
 An integration of the library for OCPP 1.6 will also be functional with the 2.0.1 upgrade. It works with the same API in MicroOcpp.h.
 
diff --git a/src/MicroOcpp/Model/Authorization/IdToken.cpp b/src/MicroOcpp/Model/Authorization/IdToken.cpp
index 94bc250e..b13eb516 100644
--- a/src/MicroOcpp/Model/Authorization/IdToken.cpp
+++ b/src/MicroOcpp/Model/Authorization/IdToken.cpp
@@ -27,6 +27,42 @@ IdToken::IdToken(const char *token, Type type) : type(type) {
     }
 }
 
+bool IdToken::parseCstr(const char *token, const char *typeCstr) {
+    if (!token || !typeCstr) {
+        MO_DBG_DEBUG("TRACE");
+        return false;
+    }
+
+    if (!strcmp(typeCstr, "Central")) {
+        type = Type::Central;
+    } else if (!strcmp(typeCstr, "eMAID")) {
+        type = Type::eMAID;
+    } else if (!strcmp(typeCstr, "ISO14443")) {
+        type = Type::ISO14443;
+    } else if (!strcmp(typeCstr, "ISO15693")) {
+        type = Type::ISO15693;
+    } else if (!strcmp(typeCstr, "KeyCode")) {
+        MO_DBG_DEBUG("TRACE");
+        type = Type::KeyCode;
+    } else if (!strcmp(typeCstr, "Local")) {
+        type = Type::Local;
+    } else if (!strcmp(typeCstr, "MacAddress")) {
+        type = Type::MacAddress;
+    } else if (!strcmp(typeCstr, "NoAuthorization")) {
+        type = Type::NoAuthorization;
+    } else {
+        MO_DBG_DEBUG("TRACE");
+        return false;
+    }
+
+    auto ret = snprintf(idToken, sizeof(idToken), "%s", token);
+    if (ret < 0 || (size_t)ret >= sizeof(idToken)) {
+        return false;
+    }
+
+    return true;
+}
+
 const char *IdToken::get() const {
     return *idToken ? idToken : nullptr;;
 }
diff --git a/src/MicroOcpp/Model/Authorization/IdToken.h b/src/MicroOcpp/Model/Authorization/IdToken.h
index 492f02a2..8f4ba190 100644
--- a/src/MicroOcpp/Model/Authorization/IdToken.h
+++ b/src/MicroOcpp/Model/Authorization/IdToken.h
@@ -39,6 +39,8 @@ class IdToken {
     IdToken();
     IdToken(const char *token, Type type = Type::ISO14443);
 
+    bool parseCstr(const char *token, const char *typeCstr);
+
     const char *get() const;
     const char *getTypeCstr() const;
 
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index 788655c2..9f67ed20 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -173,11 +173,10 @@ class Transaction {
 
 #include <memory>
 
+#include <MicroOcpp/Model/Transactions/TransactionDefs.h>
 #include <MicroOcpp/Model/Authorization/IdToken.h>
 #include <MicroOcpp/Model/ConnectorBase/EvseId.h>
 
-#define MO_TXID_LEN_MAX 36
-
 namespace MicroOcpp {
 namespace Ocpp201 {
 
@@ -264,14 +263,19 @@ class Transaction {
     char transactionId [MO_TXID_LEN_MAX + 1] = {'\0'};
     int remoteStartId = -1;
 
-    bool idTokenTransmitted = true;
+    //if to fill next TxEvent with optional fields
+    bool notifyEvseId = false;
+    bool notifyIdToken = false;
+    bool notifyStopIdToken = false;
+    bool notifyReservationId = false;
+    bool notifyChargingState = false;
+    bool notifyRemoteStartId = false;
 
     bool evConnectionTimeoutListen = true;
 
     StopReason stopReason = StopReason::UNDEFINED;
     TransactionEventTriggerReason stopTrigger = TransactionEventTriggerReason::UNDEFINED;
     std::unique_ptr<IdToken> stopIdToken; // if null, then stopIdToken equals idToken
-    bool stopIdTokenTransmitted = true;
 };
 
 // TransactionEventRequest (1.60.1)
@@ -305,6 +309,7 @@ class TransactionEventData {
     int numberOfPhasesUsed = -1;
     int cableMaxCurrent = -1;
     int reservationId = -1;
+    int remoteStartId = -1;
 
     // TransactionType (2.48)
     ChargingState chargingState = ChargingState::UNDEFINED;
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDefs.h b/src/MicroOcpp/Model/Transactions/TransactionDefs.h
new file mode 100644
index 00000000..1a871b4b
--- /dev/null
+++ b/src/MicroOcpp/Model/Transactions/TransactionDefs.h
@@ -0,0 +1,20 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_TRANSACTIONDEFS_H
+#define MO_TRANSACTIONDEFS_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#define MO_TXID_LEN_MAX 36
+
+typedef enum RequestStartStopStatus {
+    RequestStartStopStatus_Accepted,
+    RequestStartStopStatus_Rejected
+}   RequestStartStopStatus;
+
+#endif //MO_ENABLE_V201
+#endif
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index 62520f3f..41c5d0e8 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -16,6 +16,8 @@
 #include <MicroOcpp/Model/Variables/VariableService.h>
 #include <MicroOcpp/Operations/Authorize.h>
 #include <MicroOcpp/Operations/TransactionEvent.h>
+#include <MicroOcpp/Operations/RequestStartTransaction.h>
+#include <MicroOcpp/Operations/RequestStopTransaction.h>
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Debug.h>
 
@@ -102,23 +104,32 @@ void TransactionService::Evse::loop() {
             txStopCondition = true;
             triggerReason = transaction->stopTrigger;
             stopReason = transaction->stopReason;
-        } else if (txService.isTxStopPoint(TxStartStopPoint::EVConnected) &&
+        } else if ((txService.isTxStopPoint(TxStartStopPoint::EVConnected) ||
+                    txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed)) &&
                     connectorPluggedInput && !connectorPluggedInput() &&
                     (txService.stopTxOnEVSideDisconnectBool->getBool() || !transaction || !transaction->started)) {
             txStopCondition = true;
             triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
             stopReason = Ocpp201::Transaction::StopReason::EVDisconnected;
-        } else if (txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed) &&
-                    evReadyInput && !evReadyInput()) {
-            txStopCondition = true;
-            triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
-            stopReason = Ocpp201::Transaction::StopReason::StoppedByEV;
-        } else if (txService.isTxStopPoint(TxStartStopPoint::Authorized) &&
+        } else if ((txService.isTxStopPoint(TxStartStopPoint::Authorized) ||
+                    txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed)) &&
                     (!transaction || !transaction->isAuthorized)) {
             // user revoked authorization (or EV or any "local" entity)
             txStopCondition = true;
             triggerReason = TransactionEventTriggerReason::StopAuthorized;
             stopReason = Ocpp201::Transaction::StopReason::Local;
+        } else if (txService.isTxStopPoint(TxStartStopPoint::EnergyTransfer) &&
+                    evReadyInput && !evReadyInput()) {
+            txStopCondition = true;
+            triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
+            stopReason = Ocpp201::Transaction::StopReason::StoppedByEV;
+        } else if (txService.isTxStopPoint(TxStartStopPoint::EnergyTransfer) &&
+                    (evReadyInput || evseReadyInput) && // at least one of the two defined
+                    !(evReadyInput && evReadyInput()) &&
+                    !(evseReadyInput && evseReadyInput())) {
+            txStopCondition = true;
+            triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
+            stopReason = Ocpp201::Transaction::StopReason::Other;
         } else if (txService.isTxStopPoint(TxStartStopPoint::Authorized) &&
                     transaction && transaction->isDeauthorized &&
                     txService.stopTxOnInvalidIdBool->getBool()) {
@@ -164,18 +175,33 @@ void TransactionService::Evse::loop() {
         TransactionEventTriggerReason triggerReason = TransactionEventTriggerReason::UNDEFINED;
 
         // tx should be started?
-        if (txService.isTxStartPoint(TxStartStopPoint::EVConnected) &&
+        if (txService.isTxStartPoint(TxStartStopPoint::PowerPathClosed) &&
+                    (!connectorPluggedInput || connectorPluggedInput()) &&
+                    transaction && transaction->isAuthorized) {
+            txStartCondition = true;
+            if (transaction->remoteStartId >= 0) {
+                triggerReason = TransactionEventTriggerReason::RemoteStart;
+            } else {
+                triggerReason = TransactionEventTriggerReason::Authorized;
+            }
+        } else if (txService.isTxStartPoint(TxStartStopPoint::Authorized) &&
+                    transaction && transaction->isAuthorized) {
+            txStartCondition = true;
+            if (transaction->remoteStartId >= 0) {
+                triggerReason = TransactionEventTriggerReason::RemoteStart;
+            } else {
+                triggerReason = TransactionEventTriggerReason::Authorized;
+            }
+        } else if (txService.isTxStartPoint(TxStartStopPoint::EVConnected) &&
                     connectorPluggedInput && connectorPluggedInput()) {
             txStartCondition = true;
             triggerReason = TransactionEventTriggerReason::CablePluggedIn;
-        } else if (txService.isTxStartPoint(TxStartStopPoint::PowerPathClosed) &&
-                    evReadyInput && evReadyInput()) {
+        } else if (txService.isTxStartPoint(TxStartStopPoint::EnergyTransfer) &&
+                    (evReadyInput || evseReadyInput) && // at least one of the two defined
+                    (!evReadyInput || evReadyInput()) &&
+                    (!evseReadyInput || evseReadyInput())) {
             txStartCondition = true;
             triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
-        } else if (txService.isTxStartPoint(TxStartStopPoint::Authorized) &&
-                    transaction && transaction->isAuthorized) {
-            txStartCondition = true;
-            triggerReason = TransactionEventTriggerReason::Authorized;
         }
 
         if (txStartCondition &&
@@ -189,6 +215,9 @@ void TransactionService::Evse::loop() {
                     // OOM
                     return;
                 }
+                if (evseId > 0) {
+                    transaction->notifyEvseId = true;
+                }
             }
 
             txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
@@ -211,7 +240,7 @@ void TransactionService::Evse::loop() {
         chargingState = TransactionEventData::ChargingState::SuspendedEVSE;
     } else if (evReadyInput && !evReadyInput()) {
         chargingState = TransactionEventData::ChargingState::SuspendedEV;
-    } else if (transaction && transaction->started && transaction->active) {
+    } else if (ocppPermitsCharge()) {
         chargingState = TransactionEventData::ChargingState::Charging;
     }
 
@@ -225,10 +254,19 @@ void TransactionService::Evse::loop() {
         if (chargingState != trackChargingState) {
             txUpdateCondition = true;
             triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
+            transaction->notifyChargingState = true;
         }
         trackChargingState = chargingState;
 
-        if (connectorPluggedInput && connectorPluggedInput() && !transaction->trackEvConnected) {
+        if (transaction->isAuthorized && !transaction->trackAuthorized) {
+            transaction->trackAuthorized = true;
+            txUpdateCondition = true;
+            if (transaction->remoteStartId >= 0) {
+                triggerReason = TransactionEventTriggerReason::RemoteStart;
+            } else {
+                triggerReason = TransactionEventTriggerReason::Authorized;
+            }
+        } else if (connectorPluggedInput && connectorPluggedInput() && !transaction->trackEvConnected) {
             transaction->trackEvConnected = true;
             txUpdateCondition = true;
             triggerReason = TransactionEventTriggerReason::CablePluggedIn;
@@ -236,10 +274,6 @@ void TransactionService::Evse::loop() {
             transaction->trackEvConnected = false;
             txUpdateCondition = true;
             triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
-        } else if (transaction->isAuthorized && !transaction->trackAuthorized) {
-            transaction->trackAuthorized = true;
-            txUpdateCondition = true;
-            triggerReason = TransactionEventTriggerReason::Authorized;
         } else if (!transaction->isAuthorized && transaction->trackAuthorized) {
             transaction->trackAuthorized = false;
             txUpdateCondition = true;
@@ -266,16 +300,26 @@ void TransactionService::Evse::loop() {
 
     if (txEvent) {
         txEvent->timestamp = context.getModel().getClock().now();
-        txEvent->chargingState = chargingState;
-        txEvent->evse = evseId;
+        if (transaction->notifyChargingState) {
+            txEvent->chargingState = chargingState;
+            transaction->notifyChargingState = false;
+        }
+        if (transaction->notifyEvseId) {
+            txEvent->evse = EvseId(evseId, 1);
+            transaction->notifyEvseId = false;
+        }
+        if (transaction->notifyRemoteStartId) {
+            txEvent->remoteStartId = transaction->remoteStartId;
+            transaction->notifyRemoteStartId = false;
+        }
         // meterValue not supported
 
-        if (!transaction->stopIdTokenTransmitted && transaction->stopIdToken) {
+        if (transaction->notifyStopIdToken && transaction->stopIdToken) {
             txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(*transaction->stopIdToken.get()));
-            transaction->stopIdTokenTransmitted = true;
-        }  else if (!transaction->idTokenTransmitted) {
+            transaction->notifyStopIdToken = false;
+        }  else if (transaction->notifyIdToken) {
             txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(transaction->idToken));
-            transaction->idTokenTransmitted = true;
+            transaction->notifyIdToken = false;
         }
     }
 
@@ -298,13 +342,10 @@ void TransactionService::Evse::setEvseReadyInput(std::function<bool()> connector
     this->evseReadyInput = connectorEnergized;
 }
 
-bool TransactionService::Evse::beginAuthorization(IdToken idToken) {
+bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validateIdToken) {
     MO_DBG_DEBUG("begin auth: %s", idToken.get());
 
-    MO_DBG_DEBUG("patch idTokenType KeyCode for OCTT");
-    idToken = IdToken(idToken.get(), IdToken::Type::KeyCode);
-
-    if (transaction && transaction->idToken.get()) {
+    if (transaction && (transaction->idToken.get() || !transaction->active)) {
         MO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
         return false;
     }
@@ -315,6 +356,9 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken) {
             MO_DBG_ERR("could not allocate Tx");
             return false;
         }
+        if (evseId > 0) {
+            transaction->notifyEvseId = true;
+        }
     }
 
     transaction->idToken = idToken;
@@ -322,28 +366,35 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken) {
 
     auto tx = transaction;
 
-    auto authorize = makeRequest(new Authorize(context.getModel(), idToken));
-    if (!authorize) {
-        // OOM
-        return false;
-    }
-
-    authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
-        if (strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
-            MO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->idToken.get());
-            tx->isDeauthorized = true;
-            return;
+    if (validateIdToken) {
+        auto authorize = makeRequest(new Authorize(context.getModel(), idToken));
+        if (!authorize) {
+            // OOM
+            return false;
         }
 
-        MO_DBG_DEBUG("Authorized transaction process (%s)", tx->idToken.get());
+        authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
+            if (strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
+                MO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->idToken.get());
+                tx->isDeauthorized = true;
+                return;
+            }
+
+            MO_DBG_DEBUG("Authorized tx with validation (%s)", tx->idToken.get());
+            tx->isAuthorized = true;
+            tx->notifyIdToken = true;
+        });
+        authorize->setTimeout(20 * 1000);
+        context.initiateRequest(std::move(authorize));
+    } else {
+        MO_DBG_DEBUG("Authorized tx directly (%s)", tx->idToken.get());
         tx->isAuthorized = true;
-        tx->idTokenTransmitted = false;
-    });
-    authorize->setTimeout(20 * 1000);
-    context.initiateRequest(std::move(authorize));
+        tx->notifyIdToken = true;
+    }
+
     return true;
 }
-bool TransactionService::Evse::endAuthorization(IdToken idToken) {
+bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateIdToken) {
 
     if (!transaction || !transaction->active) {
         //transaction already ended / not active anymore
@@ -356,7 +407,11 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken) {
     if (transaction->idToken.equals(idToken)) {
         // use same idToken like tx start
         transaction->isAuthorized = false;
-        transaction->idTokenTransmitted = false;
+        transaction->notifyIdToken = true;
+    } else if (!validateIdToken) {
+        transaction->stopIdToken = std::unique_ptr<IdToken>(new IdToken(idToken));
+        transaction->isAuthorized = false;
+        transaction->notifyStopIdToken = true;
     } else {
         // use a different idToken for stopping the tx
 
@@ -389,7 +444,7 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken) {
             }
 
             tx->isAuthorized = false;
-            tx->stopIdTokenTransmitted = false;
+            tx->notifyStopIdToken = true;
         });
         authorize->setTimeout(20 * 1000);
         context.initiateRequest(std::move(authorize));
@@ -413,14 +468,15 @@ bool TransactionService::Evse::abortTransaction(Ocpp201::Transaction::StopReason
 
     return true;
 }
-const std::shared_ptr<MicroOcpp::Ocpp201::Transaction>& TransactionService::Evse::getTransaction() {
+std::shared_ptr<MicroOcpp::Ocpp201::Transaction>& TransactionService::Evse::getTransaction() {
     return transaction;
 }
 
 bool TransactionService::Evse::ocppPermitsCharge() {
     return transaction &&
            transaction->active &&
-           transaction->isAuthorized;
+           transaction->isAuthorized &&
+           !transaction->isDeauthorized;
 }
 
 bool TransactionService::isTxStartPoint(TxStartStopPoint check) {
@@ -490,11 +546,13 @@ TransactionService::TransactionService(Context& context) : context(context) {
     auto variableService = context.getModel().getVariableService();
 
     txStartPointString = variableService->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "PowerPathClosed");
-    txStopPointString  = variableService->declareVariable<const char*>("TxCtrlr", "TxStopPoint",  "EVConnected");
+    txStopPointString  = variableService->declareVariable<const char*>("TxCtrlr", "TxStopPoint",  "PowerPathClosed");
     stopTxOnInvalidIdBool = variableService->declareVariable<bool>("TxCtrlr", "StopTxOnInvalidId", true);
     stopTxOnEVSideDisconnectBool = variableService->declareVariable<bool>("TxCtrlr", "StopTxOnEVSideDisconnect", true);
     evConnectionTimeOutInt = variableService->declareVariable<int>("TxCtrlr", "EVConnectionTimeOut", 30);
 
+    variableService->declareVariable<bool>("AuthCtrlr", "AuthorizeRemoteStart", false, MO_VARIABLE_VOLATILE, Variable::Mutability::ReadOnly);
+
     variableService->registerValidator<const char*>("TxCtrlr", "TxStartPoint", [this] (const char *value) -> bool {
         std::vector<TxStartStopPoint> validated;
         return this->parseTxStartStopPoint(value, validated);
@@ -505,9 +563,21 @@ TransactionService::TransactionService(Context& context) : context(context) {
         return this->parseTxStartStopPoint(value, validated);
     });
 
-    for (unsigned int evseId = 1; evseId < MO_NUM_EVSE; evseId++) {
+    evses.reserve(MO_NUM_EVSE);
+
+    for (unsigned int evseId = 0; evseId < MO_NUM_EVSE; evseId++) {
         evses.emplace_back(context, *this, evseId);
     }
+
+    //make sure EVSE 0 will only trigger transactions if TxStartPoint is Authorized
+    evses[0].connectorPluggedInput = [] () {return false;};
+    evses[0].evReadyInput = [] () {return false;};
+    evses[0].evseReadyInput = [] () {return false;};
+
+    context.getOperationRegistry().registerOperation("RequestStartTransaction", [this] () {
+        return new RequestStartTransaction(*this);});
+    context.getOperationRegistry().registerOperation("RequestStopTransaction", [this] () {
+        return new RequestStopTransaction(*this);});
 }
 
 void TransactionService::loop() {
@@ -522,15 +592,77 @@ void TransactionService::loop() {
     if (txStopPointString->getWriteCount() != trackTxStopPoint) {
         parseTxStartStopPoint(txStopPointString->getString(), txStopPointParsed);
     }
+
+    // assign tx on evseId 0 to an EVSE
+    if (auto& tx0 = evses[0].getTransaction()) {
+        //pending tx on evseId 0
+        if (tx0->active) {
+            for (unsigned int evseId = 1; evseId < MO_NUM_EVSE; evseId++) {
+                if (!evses[evseId].getTransaction() && 
+                        (!evses[evseId].connectorPluggedInput || evses[evseId].connectorPluggedInput())) {
+                    MO_DBG_INFO("assign tx to evse %u", evseId);
+                    tx0->notifyEvseId = true;
+                    evses[evseId].transaction = std::move(tx0);
+                }
+            }
+        }
+    }
 }
 
 TransactionService::Evse *TransactionService::getEvse(unsigned int evseId) {
-    if (evseId >= 1 && evseId - 1 < evses.size()) {
-        return &evses[evseId - 1];
+    if (evseId < evses.size()) {
+        return &evses[evseId];
     } else {
         MO_DBG_ERR("invalid arg");
         return nullptr;
     }
 }
 
+RequestStartStopStatus TransactionService::requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, char *transactionIdOut) {
+    auto evse = getEvse(evseId);
+    if (!evse) {
+        return RequestStartStopStatus_Rejected;
+    }
+
+    auto tx = evse->getTransaction();
+    if (tx) {
+        auto ret = snprintf(transactionIdOut, MO_TXID_LEN_MAX + 1, "%s", tx->transactionId);
+        if (ret < 0 || ret >= MO_TXID_LEN_MAX + 1) {
+            MO_DBG_ERR("internal error");
+            return RequestStartStopStatus_Rejected;
+        }
+    }
+
+    if (!evse->beginAuthorization(idToken, false)) {
+        MO_DBG_INFO("EVSE still occupied with pending tx");
+        return RequestStartStopStatus_Rejected;
+    }
+
+    tx = evse->getTransaction();
+    if (!tx) {
+        MO_DBG_ERR("internal error");
+        return RequestStartStopStatus_Rejected;
+    }
+
+    tx->remoteStartId = remoteStartId;
+    tx->notifyRemoteStartId = true;
+
+    return RequestStartStopStatus_Accepted;
+}
+
+RequestStartStopStatus TransactionService::requestStopTransaction(const char *transactionId) {
+    bool success = false;
+
+    for (Evse& evse : evses) {
+        if (evse.getTransaction() && !strcmp(evse.getTransaction()->transactionId, transactionId)) {
+            success = evse.abortTransaction(Ocpp201::Transaction::StopReason::Remote, TransactionEventTriggerReason::RemoteStop);
+            break;
+        }
+    }
+
+    return success ?
+            RequestStartStopStatus_Accepted :
+            RequestStartStopStatus_Rejected;
+}
+
 #endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.h b/src/MicroOcpp/Model/Transactions/TransactionService.h
index 0f0b78bd..20edc212 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.h
@@ -14,6 +14,7 @@
 #if MO_ENABLE_V201
 
 #include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/Transactions/TransactionDefs.h>
 
 #include <memory>
 #include <functional>
@@ -52,18 +53,18 @@ class TransactionService {
         void setEvReadyInput(std::function<bool()> evRequestsEnergy);
         void setEvseReadyInput(std::function<bool()> connectorEnergized);
 
-        bool beginAuthorization(IdToken idToken); // authorize by swipe RFID
-        bool endAuthorization(IdToken idToken = IdToken()); // stop authorization by swipe RFID
+        bool beginAuthorization(IdToken idToken, bool validateIdToken = true); // authorize by swipe RFID
+        bool endAuthorization(IdToken idToken = IdToken(), bool validateIdToken = true); // stop authorization by swipe RFID
 
         // stop transaction, but neither upon user request nor OCPP server request (e.g. after PowerLoss)
         bool abortTransaction(Ocpp201::Transaction::StopReason stopReason = Ocpp201::Transaction::StopReason::Other, Ocpp201::TransactionEventTriggerReason stopTrigger = Ocpp201::TransactionEventTriggerReason::AbnormalCondition);
 
-        const std::shared_ptr<Ocpp201::Transaction>& getTransaction();
+        std::shared_ptr<Ocpp201::Transaction>& getTransaction();
 
         bool ocppPermitsCharge();
-    };
 
-    friend Evse;
+        friend TransactionService;
+    };
 
 private:
 
@@ -100,6 +101,10 @@ class TransactionService {
     void loop();
 
     Evse *getEvse(unsigned int evseId);
+
+    RequestStartStopStatus requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, char *transactionIdOut); //ChargingProfile, GroupIdToken not supported yet
+
+    RequestStartStopStatus requestStopTransaction(const char *transactionId);
 };
 
 } // namespace MicroOcpp
diff --git a/src/MicroOcpp/Operations/GetBaseReport.h b/src/MicroOcpp/Operations/GetBaseReport.h
index 2c276131..2eb85ab2 100644
--- a/src/MicroOcpp/Operations/GetBaseReport.h
+++ b/src/MicroOcpp/Operations/GetBaseReport.h
@@ -20,8 +20,6 @@ class VariableService;
 
 namespace Ocpp201 {
 
-
-
 class GetBaseReport : public Operation {
 private:
     VariableService& variableService;
diff --git a/src/MicroOcpp/Operations/RequestStartTransaction.cpp b/src/MicroOcpp/Operations/RequestStartTransaction.cpp
new file mode 100644
index 00000000..29ac3627
--- /dev/null
+++ b/src/MicroOcpp/Operations/RequestStartTransaction.cpp
@@ -0,0 +1,76 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Operations/RequestStartTransaction.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::RequestStartTransaction;
+
+RequestStartTransaction::RequestStartTransaction(TransactionService& txService) : txService(txService) {
+  
+}
+
+const char* RequestStartTransaction::getOperationType(){
+    return "RequestStartTransaction";
+}
+
+void RequestStartTransaction::processReq(JsonObject payload) {
+
+    int evseId = payload["evseId"] | 0;
+    if (evseId < 0 || evseId >= MO_NUM_EVSE) {
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
+
+    int remoteStartId = payload["remoteStartId"] | 0;
+    if (remoteStartId < 0) {
+        errorCode = "PropertyConstraintViolation";
+        MO_DBG_ERR("IDs must be >= 0");
+        return;
+    }
+
+    IdToken idToken;
+    if (!idToken.parseCstr(payload["idToken"]["idToken"] | (const char*)nullptr, payload["idToken"]["type"] | (const char*)nullptr)) { //parseCstr rejects nullptr as argument
+        MO_DBG_ERR("could not parse idToken");
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    status = txService.requestStartTransaction(evseId, remoteStartId, idToken, transactionId);
+}
+
+std::unique_ptr<DynamicJsonDocument> RequestStartTransaction::createConf(){
+
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+    JsonObject payload = doc->to<JsonObject>();
+
+    const char *statusCstr = "";
+
+    switch (status) {
+        case RequestStartStopStatus_Accepted:
+            statusCstr = "Accepted";
+            break;
+        case RequestStartStopStatus_Rejected:
+            statusCstr = "Rejected";
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            break;
+    }
+
+    payload["status"] = statusCstr;
+
+    if (*transactionId) {
+        payload["transactionId"] = (const char*)transactionId; //force zero-copy mode
+    }
+
+    return doc;
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/RequestStartTransaction.h b/src/MicroOcpp/Operations/RequestStartTransaction.h
new file mode 100644
index 00000000..9a4b6ab4
--- /dev/null
+++ b/src/MicroOcpp/Operations/RequestStartTransaction.h
@@ -0,0 +1,48 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_REQUESTSTARTTRANSACTION_H
+#define MO_REQUESTSTARTTRANSACTION_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <string>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Model/Transactions/TransactionDefs.h>
+
+namespace MicroOcpp {
+
+class TransactionService;
+
+namespace Ocpp201 {
+
+class RequestStartTransaction : public Operation {
+private:
+    TransactionService& txService;
+
+    RequestStartStopStatus status;
+    char transactionId [MO_TXID_LEN_MAX + 1] = {'\0'};
+
+    const char *errorCode = nullptr;
+public:
+    RequestStartTransaction(TransactionService& txService);
+
+    const char* getOperationType() override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+
+};
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Operations/RequestStopTransaction.cpp b/src/MicroOcpp/Operations/RequestStopTransaction.cpp
new file mode 100644
index 00000000..6baf7bcb
--- /dev/null
+++ b/src/MicroOcpp/Operations/RequestStopTransaction.cpp
@@ -0,0 +1,59 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Operations/RequestStopTransaction.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::RequestStopTransaction;
+
+RequestStopTransaction::RequestStopTransaction(TransactionService& txService) : txService(txService) {
+  
+}
+
+const char* RequestStopTransaction::getOperationType(){
+    return "RequestStopTransaction";
+}
+
+void RequestStopTransaction::processReq(JsonObject payload) {
+
+    if (!payload.containsKey("transactionId") || 
+            !payload["transactionId"].is<const char*>() ||
+            strlen(payload["transactionId"].as<const char*>()) > MO_TXID_LEN_MAX) {
+        errorCode = "FormationViolation";
+        return;
+    }
+
+    status = txService.requestStopTransaction(payload["transactionId"].as<const char*>());
+}
+
+std::unique_ptr<DynamicJsonDocument> RequestStopTransaction::createConf(){
+
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+
+    const char *statusCstr = "";
+
+    switch (status) {
+        case RequestStartStopStatus_Accepted:
+            statusCstr = "Accepted";
+            break;
+        case RequestStartStopStatus_Rejected:
+            statusCstr = "Rejected";
+            break;
+        default:
+            MO_DBG_ERR("internal error");
+            break;
+    }
+
+    payload["status"] = statusCstr;
+
+    return doc;
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/RequestStopTransaction.h b/src/MicroOcpp/Operations/RequestStopTransaction.h
new file mode 100644
index 00000000..40222c7a
--- /dev/null
+++ b/src/MicroOcpp/Operations/RequestStopTransaction.h
@@ -0,0 +1,47 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_REQUESTSTOPTRANSACTION_H
+#define MO_REQUESTSTOPTRANSACTION_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <string>
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Model/Transactions/TransactionDefs.h>
+
+namespace MicroOcpp {
+
+class TransactionService;
+
+namespace Ocpp201 {
+
+class RequestStopTransaction : public Operation {
+private:
+    TransactionService& txService;
+
+    RequestStartStopStatus status;
+
+    const char *errorCode = nullptr;
+public:
+    RequestStopTransaction(TransactionService& txService);
+
+    const char* getOperationType() override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+
+};
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
index 2de39cb6..cdcd80a5 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.cpp
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -256,8 +256,8 @@ std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
         transactionInfo["stoppedReason"] = stoppedReason;
     }
 
-    if (txEvent->transaction->remoteStartId >= 0) {
-        payload["remoteStartId"] = txEvent->transaction->remoteStartId;
+    if (txEvent->remoteStartId >= 0) {
+        transactionInfo["remoteStartId"] = txEvent->transaction->remoteStartId;
     }
 
     if (txEvent->idToken) {

From abe44ba5e00ceb98ccca83aaffc63ec160b93395 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Wed, 1 May 2024 20:52:21 +0200
Subject: [PATCH 475/549] eval operation err code before creating conf (#290)

* change execution order getErr <> createConf

* update changelog
---
 CHANGELOG.md                   |  1 +
 src/MicroOcpp/Core/Request.cpp | 18 +++++++++---------
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f367f5df..a63ba4c4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -38,6 +38,7 @@
 - Fix transaction freeze in offline mode ([#279](https://github.com/matth-x/MicroOcpp/pull/279), [#287](https://github.com/matth-x/MicroOcpp/pull/287))
 - Fix compilation error caused by `PRId32` ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
 - Don't load FW-mngt. module when no handlers set
+- Avoid creating conf when operation fails ([#290](https://github.com/matth-x/MicroOcpp/pull/290))
 
 ## [1.0.3] - 2024-04-06
 
diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index c3dd1821..956f0609 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/Request.h>
@@ -184,17 +184,17 @@ std::unique_ptr<DynamicJsonDocument> Request::createResponse(){
      * Create the OCPP message
      */
     std::unique_ptr<DynamicJsonDocument> response = nullptr;
-    std::unique_ptr<DynamicJsonDocument> payload = operation->createConf();
-    std::unique_ptr<DynamicJsonDocument> errorDetails = nullptr;
-    
-    bool operationFailure = operation->getErrorCode() != nullptr;
 
-    if (!operationFailure && !payload) {
-        return nullptr; //confirmation message still pending
-    }
+    bool operationFailure = operation->getErrorCode() != nullptr;
 
     if (!operationFailure) {
 
+        std::unique_ptr<DynamicJsonDocument> payload = operation->createConf();
+
+        if (!payload) {
+            return nullptr; //confirmation message still pending
+        }
+
         /*
          * Create OCPP-J Remote Procedure Call header
          */
@@ -213,7 +213,7 @@ std::unique_ptr<DynamicJsonDocument> Request::createResponse(){
 
         const char *errorCode = operation->getErrorCode();
         const char *errorDescription = operation->getErrorDescription();
-        errorDetails = std::unique_ptr<DynamicJsonDocument>(operation->getErrorDetails());
+        std::unique_ptr<DynamicJsonDocument> errorDetails = std::unique_ptr<DynamicJsonDocument>(operation->getErrorDetails());
         if (!errorCode) { //catch corner case when payload is null but errorCode is not set too!
             errorCode = "GenericError";
             errorDescription = "Could not create payload (createConf() returns Null)";

From b99f1c2858a59a569872d8390255db4035177da8 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Fri, 3 May 2024 20:54:39 +0200
Subject: [PATCH 476/549] add FTP client (#291)

* migrate FTP from matth-x/MicroFtp

* fix compilation errors

* add extra switch or certs store

* fix disable MbedTLS by default

* add FTP client to CMakeLists

* add FTP client to CMakeLists II
---
 CMakeLists.txt                                |   1 +
 src/MicroOcpp.cpp                             |   2 +-
 src/MicroOcpp/Core/Ftp.h                      |  86 ++
 src/MicroOcpp/Core/FtpMbedTLS.cpp             | 927 ++++++++++++++++++
 src/MicroOcpp/Core/FtpMbedTLS.h               |  40 +
 src/MicroOcpp/Debug.h                         |   7 +-
 .../Model/Certificates/CertificateMbedTLS.cpp |   4 +-
 .../Model/Certificates/CertificateMbedTLS.h   |  10 +-
 src/MicroOcpp/Platform.h                      |   6 +-
 9 files changed, 1074 insertions(+), 9 deletions(-)
 create mode 100644 src/MicroOcpp/Core/Ftp.h
 create mode 100644 src/MicroOcpp/Core/FtpMbedTLS.cpp
 create mode 100644 src/MicroOcpp/Core/FtpMbedTLS.h

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 4b4dccc4..3304e256 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -13,6 +13,7 @@ set(MO_SRC
     src/MicroOcpp/Core/ConfigurationKeyValue.cpp
     src/MicroOcpp/Core/FilesystemAdapter.cpp
     src/MicroOcpp/Core/FilesystemUtils.cpp
+    src/MicroOcpp/Core/FtpMbedTLS.cpp
     src/MicroOcpp/Core/RequestQueue.cpp
     src/MicroOcpp/Core/Context.cpp
     src/MicroOcpp/Core/Operation.cpp
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index f0b51d44..7f01c4a3 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -313,7 +313,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     if (certStore) {
         certStoreUse = std::move(certStore);
     }
-#if MO_ENABLE_MBEDTLS
+#if MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
     else {
         certStoreUse = makeCertificateStoreMbedTLS(filesystem);
     }
diff --git a/src/MicroOcpp/Core/Ftp.h b/src/MicroOcpp/Core/Ftp.h
new file mode 100644
index 00000000..f1ab5a77
--- /dev/null
+++ b/src/MicroOcpp/Core/Ftp.h
@@ -0,0 +1,86 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_FTP_H
+#define MO_FTP_H
+
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef struct ocpp_ftp_download {
+    void *user_data; //set this at your choice. MO passes it back to the functions below
+
+    void (*loop)(void *user_data);
+} ocpp_ftp_download;
+
+typedef struct ocpp_ftp_upload {
+    void *user_data; //set this at your choice. MO passes it back to the functions below
+
+    void (*loop)(void *user_data);
+} ocpp_ftp_upload;
+
+typedef struct ocpp_ftp_client {
+    void *user_data; //set this at your choice. MO passes it back to the functions below
+
+    void (*loop)(void *user_data);
+
+    ocpp_ftp_download* (*get_file)(void *user_data,
+        const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
+        size_t (*file_writer)(void *mo_data, unsigned char *data, size_t len),
+        void (*on_close)(void *mo_data),
+        void *mo_data,
+        const char *ca_cert); // nullptr to disable cert check; will be ignored for non-TLS connections
+
+    void (*get_file_free)(void *user_data, ocpp_ftp_download*);
+
+    ocpp_ftp_upload* (*post_file)(void *user_data,
+        const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
+        size_t (*file_reader)(void *mo_data, unsigned char *buf, size_t bufsize),
+        void (*on_close)(void *mo_data),
+        void *mo_data,
+        const char *ca_cert); // nullptr to disable cert check; will be ignored for non-TLS connections
+
+    void (*post_file_free)(void *user_data, ocpp_ftp_upload*);
+} ocpp_ftp_client;
+
+#ifdef __cplusplus
+} //extern "C"
+
+#include <memory>
+#include <functional>
+
+namespace MicroOcpp {
+
+class FtpDownload {
+public:
+    virtual void loop() = 0;
+};
+
+class FtpUpload {
+public:
+    virtual void loop() = 0;
+};
+
+class FtpClient {
+public:
+
+    virtual std::unique_ptr<FtpDownload> getFile(
+                const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
+                std::function<size_t(unsigned char *data, size_t len)> fileWriter,
+                std::function<void()> onClose,
+                const char *ca_cert = nullptr) = 0; // nullptr to disable cert check; will be ignored for non-TLS connections
+
+    virtual std::unique_ptr<FtpUpload> postFile(
+                const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
+                std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, //write at most buffsize bytes into out-buffer. Return number of bytes written
+                std::function<void()> onClose,
+                const char *ca_cert = nullptr) = 0; // nullptr to disable cert check; will be ignored for non-TLS connections
+};
+
+} // namespace MicroOcpp
+#endif //def __cplusplus
+#endif
diff --git a/src/MicroOcpp/Core/FtpMbedTLS.cpp b/src/MicroOcpp/Core/FtpMbedTLS.cpp
new file mode 100644
index 00000000..e135586c
--- /dev/null
+++ b/src/MicroOcpp/Core/FtpMbedTLS.cpp
@@ -0,0 +1,927 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Core/FtpMbedTLS.h>
+
+#if MO_ENABLE_MBEDTLS
+
+#include <string>
+#include <functional>
+
+#include "mbedtls/net_sockets.h"
+#include "mbedtls/ssl.h"
+#include "mbedtls/entropy.h"
+#include "mbedtls/ctr_drbg.h"
+#include "mbedtls/x509.h"
+#include "mbedtls/error.h"
+
+#include <MicroOcpp/Debug.h>
+
+namespace MicroOcpp {
+
+class FtpTransferMbedTLS : public FtpUpload, public FtpDownload {
+private:
+    //MbedTLS common
+    mbedtls_entropy_context entropy;
+    mbedtls_ctr_drbg_context ctr_drbg;
+    mbedtls_ssl_config conf;
+    mbedtls_x509_crt cacert;
+    mbedtls_x509_crt clicert;
+    mbedtls_pk_context pkey;
+    const char *ca_cert = nullptr;
+    const char *client_cert = nullptr;
+    const char *client_key = nullptr;
+    bool isSecure = false; //tls policy
+
+    //control connection specific
+    mbedtls_net_context ctrl_fd;
+    mbedtls_ssl_context ctrl_ssl;
+    bool ctrl_opened = false;
+    bool ctrl_ssl_established = false;
+
+    //data connection specific
+    mbedtls_net_context data_fd;
+    mbedtls_ssl_context data_ssl;
+    bool data_opened = false;
+    bool data_ssl_established = false;
+    bool data_conn_accepted = false; //Server sent okay to upload / download data
+
+    //FTP URL
+    std::string user;
+    std::string pass;
+    std::string ctrl_host;
+    std::string ctrl_port;
+    std::string dir;
+    std::string fname;
+
+    std::string data_host;
+    std::string data_port;
+
+    bool read_url_ctrl(const char *ftp_url);
+    bool read_url_data(const char *data_url);
+    
+    std::function<size_t(unsigned char *data, size_t len)> fileWriter;
+    std::function<size_t(unsigned char *out, size_t bufsize)> fileReader;
+    std::function<void()> onClose;
+
+    enum class Method {
+        Retrieve,  //download file
+        Store,     //upload file
+        UNDEFINED
+    };
+    Method method = Method::UNDEFINED;
+
+    int setup_tls();
+    int connect(mbedtls_net_context& fd, mbedtls_ssl_context& ssl, const char *server_name, const char *server_port);
+    int connect_ctrl();
+    int connect_data();
+    void close_ctrl();
+    void close_data();
+
+    int handshake_tls();
+
+    void send_cmd(const char *cmd, const char *arg = nullptr, bool disable_tls_policy = false);
+
+    void process_ctrl();
+    void process_data();
+
+    unsigned char *data_buf = nullptr;
+    size_t data_buf_size = 4096;
+    size_t data_buf_avail = 0;
+    size_t data_buf_offs = 0;
+
+public:
+    FtpTransferMbedTLS(bool tls_only = false, const char *client_cert = nullptr, const char *client_key = nullptr);
+    ~FtpTransferMbedTLS();
+
+    void loop() override;
+
+    bool getFile(const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
+            std::function<size_t(unsigned char *data, size_t len)> fileWriter,
+            std::function<void()> onClose,
+            const char *ca_cert = nullptr); // nullptr to disable cert check; will be ignored for non-TLS connections
+
+    bool postFile(const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
+            std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, //write at most buffsize bytes into out-buffer. Return number of bytes written
+            std::function<void()> onClose,
+            const char *ca_cert = nullptr); // nullptr to disable cert check; will be ignored for non-TLS connections
+};
+
+class FtpClientMbedTLS : public FtpClient {
+private:
+    const char *client_cert = nullptr;
+    const char *client_key = nullptr;
+    bool tls_only = false; //tls policy
+public:
+
+    FtpClientMbedTLS(bool tls_only = false, const char *client_cert = nullptr, const char *client_key = nullptr);
+
+    std::unique_ptr<FtpDownload> getFile(const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
+            std::function<size_t(unsigned char *data, size_t len)> fileWriter,
+            std::function<void()> onClose,
+            const char *ca_cert = nullptr) override; // nullptr to disable cert check; will be ignored for non-TLS connections
+
+    std::unique_ptr<FtpUpload> postFile(const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
+            std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, //write at most buffsize bytes into out-buffer. Return number of bytes written
+            std::function<void()> onClose,
+            const char *ca_cert = nullptr) override; // nullptr to disable cert check; will be ignored for non-TLS connections
+};
+
+std::unique_ptr<FtpClient> makeFtpClientMbedTLS(bool tls_only, const char *client_cert, const char *client_key) {
+    return std::unique_ptr<FtpClient>(new FtpClientMbedTLS(tls_only, client_cert, client_key));
+}
+
+void mo_mbedtls_log(void *user, int level, const char *file, int line, const char *str) {
+
+    /*
+     * MbedTLS debug level documented in mbedtls/debug.h:
+     *     - 0 No debug
+     *     - 1 Error
+     *     - 2 State change
+     *     - 3 Informational
+     *     - 4 Verbose
+     * 
+     * To change the debug level, use the build flag MO_DBG_LEVEL_MBEDTLS accordingly
+     */
+    const char *lstr = "";
+    if (level <= 1) {
+        lstr = "ERROR";
+    } else if (level <= 3) {
+        lstr = "debug";
+    } else {
+        lstr = "verbose";
+    }
+
+    MO_CONSOLE_PRINTF("[MO] %s (%s:%i): %s\n", lstr, file, line, str);
+}
+
+/*
+ * FTP implementation
+ */
+
+FtpTransferMbedTLS::FtpTransferMbedTLS(bool tls_only, const char *client_cert, const char *client_key) 
+        : isSecure(tls_only), client_cert(client_cert), client_key(client_key) {
+    mbedtls_net_init(&ctrl_fd);
+    mbedtls_ssl_init(&ctrl_ssl);
+    mbedtls_net_init(&data_fd);
+    mbedtls_ssl_init(&data_ssl);
+    mbedtls_ssl_config_init(&conf);
+    mbedtls_x509_crt_init(&cacert);
+    mbedtls_x509_crt_init(&clicert);
+    mbedtls_pk_init(&pkey);
+    mbedtls_ctr_drbg_init(&ctr_drbg);
+    mbedtls_entropy_init(&entropy);
+}
+
+FtpTransferMbedTLS::~FtpTransferMbedTLS() {
+    if (onClose) {
+        onClose();
+        onClose = nullptr;
+    }
+    delete[] data_buf;
+    mbedtls_x509_crt_free(&clicert);
+    mbedtls_x509_crt_free(&cacert);
+    mbedtls_pk_free(&pkey);
+    mbedtls_ssl_config_free(&conf);
+    mbedtls_ctr_drbg_free(&ctr_drbg);
+    mbedtls_entropy_free(&entropy);
+    mbedtls_net_free(&ctrl_fd);
+    mbedtls_ssl_free(&ctrl_ssl);
+    mbedtls_net_free(&data_fd);
+    mbedtls_ssl_free(&data_ssl);
+}
+
+int FtpTransferMbedTLS::setup_tls() {
+
+    if (auto ret = mbedtls_ctr_drbg_seed(&ctr_drbg, mbedtls_entropy_func, &entropy,
+                                     (const unsigned char*) __FILE__,
+                                     strlen(__FILE__)) != 0) {
+        MO_DBG_ERR("mbedtls_ctr_drbg_seed: %i", ret);
+        return ret;
+    }
+
+    if (ca_cert) {
+        if (auto ret = mbedtls_x509_crt_parse(&cacert, (const unsigned char *) ca_cert,
+                                    strlen(ca_cert)) < 0) {
+            MO_DBG_ERR("mbedtls_x509_crt_parse(ca_cert): %i", ret);
+            return ret;
+        }
+    }
+
+    if (client_cert) {
+        if (auto ret = mbedtls_x509_crt_parse(&clicert, (const unsigned char *) client_cert,
+                                    strlen(client_cert))) {
+            MO_DBG_ERR("mbedtls_x509_crt_parse(client_cert): %i", ret);
+            return ret;
+        }
+    }
+
+    if (client_key) {
+        if (auto ret = mbedtls_pk_parse_key(&pkey,
+                                    (const unsigned char *) client_key,
+                                    strlen(client_key),
+                                    NULL,
+                                    0)) {
+            MO_DBG_ERR("mbedtls_pk_parse_key: %i", ret);
+            return ret;
+        }
+    }
+
+    if (auto ret = mbedtls_ssl_config_defaults(&conf,
+                                           MBEDTLS_SSL_IS_CLIENT,
+                                           MBEDTLS_SSL_TRANSPORT_STREAM,
+                                           MBEDTLS_SSL_PRESET_DEFAULT) != 0) {
+        MO_DBG_ERR("mbedtls_ssl_config_defaults: %i", ret);
+        return ret;
+    }
+
+    mbedtls_ssl_conf_authmode(&conf, MBEDTLS_SSL_VERIFY_OPTIONAL); //certificate check result manually handled for now
+
+    mbedtls_ssl_conf_rng(&conf, mbedtls_ctr_drbg_random, &ctr_drbg);
+    mbedtls_ssl_conf_dbg(&conf, mo_mbedtls_log, NULL);
+
+    if (ca_cert) {
+        mbedtls_ssl_conf_ca_chain(&conf, &cacert, NULL);
+    }
+
+    if (client_cert || client_key) {
+        if (auto ret = mbedtls_ssl_conf_own_cert(&conf, &clicert, &pkey) != 0) {
+            MO_DBG_ERR("mbedtls_ssl_conf_own_cert: %i", ret);
+            return ret;
+        }
+    }
+
+    return 0; //success
+}
+
+int FtpTransferMbedTLS::connect(mbedtls_net_context& fd, mbedtls_ssl_context& ssl, const char *server_name, const char *server_port) {
+
+    if (auto ret = mbedtls_net_connect(&fd, server_name, server_port, MBEDTLS_NET_PROTO_TCP) != 0) {
+        MO_DBG_ERR("mbedtls_net_connect: %i", ret);
+        return ret;
+    }
+
+    if (auto ret = mbedtls_net_set_nonblock(&fd)) {
+        MO_DBG_ERR("mbedtls_net_set_nonblock: %i", ret);
+        return ret;
+    }
+
+    if (auto ret = mbedtls_ssl_setup(&ssl, &conf) != 0) {
+        MO_DBG_ERR("mbedtls_ssl_setup: %i", ret);
+        return ret;
+    }
+
+    if (auto ret = mbedtls_ssl_set_hostname(&ssl, server_name) != 0) {
+        MO_DBG_ERR("mbedtls_ssl_set_hostname: %i", ret);
+        return ret;
+    }
+
+    mbedtls_ssl_set_bio(&ssl, &fd, mbedtls_net_send, mbedtls_net_recv, NULL);
+
+    return 0; //success
+}
+
+int FtpTransferMbedTLS::connect_ctrl() {
+    if (auto ret = connect(ctrl_fd, ctrl_ssl, ctrl_host.c_str(), ctrl_port.c_str())) {
+        MO_DBG_ERR("connect: %i", ret);
+        return ret;
+    }
+
+    ctrl_opened = true;
+
+    //handshake will be done later during STARTTLS procedure
+
+    return 0; //success
+}
+
+int FtpTransferMbedTLS::connect_data() {
+    if (auto ret = connect(data_fd, data_ssl, data_host.c_str(), data_port.c_str())) {
+        MO_DBG_ERR("connect: %i", ret);
+        return ret;
+    }
+
+    data_opened = true;
+
+    if (isSecure) {
+        //reuse SSL session of ctrl conn
+
+        if (auto ret = mbedtls_ssl_set_session(&data_ssl, 
+                    mbedtls_ssl_get_session_pointer(&ctrl_ssl))) {
+            MO_DBG_ERR("session reuse failure: %i", ret);
+            return ret;
+        }
+
+        data_ssl_established = true;
+    }
+
+    if (!data_buf) {
+        data_buf = new unsigned char[data_buf_size];
+        if (!data_buf) {
+            MO_DBG_ERR("OOM");
+            return -1;
+        }
+    }
+
+    return 0; //success
+}
+
+void FtpTransferMbedTLS::close_ctrl() {
+    if (!ctrl_opened) {
+        return;
+    }
+
+    if (ctrl_ssl_established) {
+        mbedtls_ssl_close_notify(&ctrl_ssl);
+        ctrl_ssl_established = false;
+    }
+    mbedtls_net_free(&ctrl_fd);
+    ctrl_opened = false;
+
+    if (onClose && !data_opened) {
+        onClose();
+        onClose = nullptr;
+    }
+}
+
+void FtpTransferMbedTLS::close_data() {
+    if (!data_opened) {
+        return;
+    }
+
+    MO_DBG_DEBUG("closing data conn");
+
+    if (data_ssl_established) {
+        MO_DBG_DEBUG("TLS shutdown");
+        mbedtls_ssl_close_notify(&data_ssl);
+        data_ssl_established = false;
+    }
+    mbedtls_net_free(&data_fd);
+    data_opened = false;
+    data_conn_accepted = false;
+
+    if (onClose && !ctrl_opened) {
+        onClose();
+        onClose = nullptr;
+    }
+}
+
+int FtpTransferMbedTLS::handshake_tls() {
+
+    while (auto ret = mbedtls_ssl_handshake(&ctrl_ssl) != 0) {
+        if (ret != MBEDTLS_ERR_SSL_WANT_READ && ret != MBEDTLS_ERR_SSL_WANT_WRITE && ret != 1) {
+            char buf [1024];
+            mbedtls_strerror(ret, (char *) buf, 1024);
+            MO_DBG_ERR("mbedtls_ssl_handshake: %i, %s", ret, buf);
+            return ret;
+        }
+    }
+
+    if (ca_cert) {
+        //certificate validation enabled
+
+        if (auto ret = mbedtls_ssl_get_verify_result(&ctrl_ssl) != 0) {
+            char vrfy_buf[512];
+            mbedtls_x509_crt_verify_info(vrfy_buf, sizeof(vrfy_buf), "   > ", ret);
+            MO_DBG_ERR("mbedtls_ssl_get_verify_result: %i, %s", ret, vrfy_buf);
+            return ret;
+        }
+    }
+
+    ctrl_ssl_established = true;
+
+    return 0; //success
+}
+
+void FtpTransferMbedTLS::send_cmd(const char *cmd, const char *arg, bool disable_tls_policy) {
+
+    const size_t MSG_SIZE = 128;
+    unsigned char msg [MSG_SIZE];
+
+    auto len = snprintf((char*) msg, MSG_SIZE, "%s%s%s\r\n", 
+            cmd,               //cmd mandatory (e.g. "USER")
+            arg ? " " : "",    //line spacing if arg is provided
+            arg ? arg : "");   //arg optional (e.g. "anonymous")
+    if (len < 0 || len >= MSG_SIZE) {
+        MO_DBG_ERR("could not write cmd, send QUIT instead");
+        len = sprintf((char*) msg, "QUIT\r\n");
+    } else {
+        //show outgoing traffic for debug, but shadow PASS
+        MO_DBG_DEBUG("SEND: %s %s", 
+                cmd,
+                !strncmp((char*) cmd, "PASS", strlen("PASS")) ? "***" : arg ? (char*) arg : "");
+        (void)0;
+    }
+
+    int ret = -1;
+
+    if (ctrl_ssl_established) {
+        ret = mbedtls_ssl_write(&ctrl_ssl, (unsigned char*) msg, len);
+    } else if (!isSecure || disable_tls_policy) {
+        ret = mbedtls_net_send(&ctrl_fd, (unsigned char*) msg, len);
+    } else {
+        MO_DBG_ERR("TLS policy failure");
+        len = strlen("QUIT\r\n");
+        ret = mbedtls_net_send(&ctrl_fd, (unsigned char*) "QUIT\r\n", len);
+    }
+
+    if (ret == MBEDTLS_ERR_SSL_WANT_READ || ret == MBEDTLS_ERR_SSL_WANT_WRITE ||
+            ret <= 0 ||
+            ret < (int) len) {
+        char buf [1024];
+        mbedtls_strerror(ret, (char *) buf, 1024);
+        MO_DBG_ERR("fatal - message on ctrl channel lost: %i, %s", ret, buf);
+        close_ctrl();
+        return;
+    }
+}
+
+bool FtpTransferMbedTLS::getFile(const char *ftp_url_raw, std::function<size_t(unsigned char *data, size_t len)> fileWriter, std::function<void()> onClose, const char *ca_cert) {
+
+    if (method != Method::UNDEFINED) {
+        MO_DBG_ERR("FTP Client reuse not supported");
+        return false;
+    }
+    
+    if (!ftp_url_raw || !fileWriter) {
+        MO_DBG_ERR("invalid args");
+        return false;
+    }
+
+    this->ca_cert = ca_cert;
+    this->method = Method::Retrieve;
+    this->fileWriter = fileWriter;
+    this->onClose = onClose;
+
+    if (!read_url_ctrl(ftp_url_raw)) {
+        MO_DBG_ERR("could not parse URL");
+        return false;
+    }
+
+    MO_DBG_DEBUG("init download from %s: %s", ctrl_host.c_str(), fname.c_str());
+
+    if (auto ret = setup_tls()) {
+        MO_DBG_ERR("could not setup MbedTLS: %i", ret);
+        return false;
+    }
+
+    if (auto ret = connect_ctrl()) {
+        MO_DBG_ERR("could not establish connection to FTP server: %i", ret);
+        return false;
+    }
+
+    return true;
+}
+
+bool FtpTransferMbedTLS::postFile(const char *ftp_url_raw, std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, std::function<void()> onClose, const char *ca_cert) {
+    
+    if (method != Method::UNDEFINED) {
+        MO_DBG_ERR("FTP Client reuse not supported");
+        return false;
+    }
+
+    if (!ftp_url_raw || !fileReader) {
+        MO_DBG_ERR("invalid args");
+        return false;
+    }
+
+    MO_DBG_DEBUG("init upload %s", ftp_url_raw);
+
+    this->ca_cert = ca_cert;
+    this->method = Method::Store;
+    this->fileReader = fileReader;
+    this->onClose = onClose;
+
+    if (!read_url_ctrl(ftp_url_raw)) {
+        MO_DBG_ERR("could not parse URL");
+        return false;
+    }
+
+    if (auto ret = setup_tls()) {
+        MO_DBG_ERR("could not setup MbedTLS: %i", ret);
+        return false;
+    }
+
+    if (auto ret = connect_ctrl()) {
+        MO_DBG_ERR("could not establish connection to FTP server: %i", ret);
+        return false;
+    }
+
+    return true;
+}
+
+void FtpTransferMbedTLS::process_ctrl() {
+    // read input (if available)
+
+    const size_t INBUF_SIZE = 128;
+    unsigned char inbuf [INBUF_SIZE];
+    memset(inbuf, 0, INBUF_SIZE);
+
+    int ret = -1;
+
+    if (ctrl_ssl_established) {
+        ret = mbedtls_ssl_read(&ctrl_ssl, inbuf, INBUF_SIZE - 1);
+    } else {
+        ret = mbedtls_net_recv(&ctrl_fd, inbuf, INBUF_SIZE - 1);
+    }
+
+    if (ret == MBEDTLS_ERR_SSL_WANT_READ || ret == MBEDTLS_ERR_SSL_WANT_WRITE) {
+        //no new input data to be processed
+        return;
+    } else if (ret == MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY || ret == 0) {
+        MO_DBG_ERR("FTP transfer aborted");
+        close_ctrl();
+        return;
+    } else if (ret < 0) {
+        MO_DBG_ERR("mbedtls_net_recv: %i", ret);
+        send_cmd("QUIT");
+        close_ctrl();
+        return;
+    }
+
+    size_t inbuf_len = ret;
+
+    // read multi-line command
+    char *line_next = (char*) inbuf;
+    while (line_next < (char*) inbuf + inbuf_len) {
+
+        // take current line
+        char *line = line_next;
+
+        // null-terminate current line and find begin of next line
+        while (line_next + 1 < (char*) inbuf + inbuf_len && *line_next != '\n') {
+            line_next++;
+        }
+        *line_next = '\0';
+        line_next++;
+
+        MO_DBG_DEBUG("RECV: %s", line);
+
+        if (isSecure && !ctrl_ssl_established) { //tls not established yet, set up according to RFC 4217
+            if (!strncmp("220", line, 3)) {
+                MO_DBG_DEBUG("start TLS negotiation");
+                send_cmd("AUTH TLS", nullptr, true);
+                return;
+            } else if (!strncmp("234", line, 3)) { // Proceed with TLS negotiation
+                MO_DBG_DEBUG("upgrade to TLS");
+
+                if (auto ret = handshake_tls()) {
+                    MO_DBG_ERR("handshake: %i", ret);
+                    send_cmd("QUIT", nullptr, true);
+                    return;
+                }
+            } else {
+                MO_DBG_ERR("cannot proceed without TLS");
+                send_cmd("QUIT", nullptr, true);
+                return;
+            }
+        }
+
+        if (isSecure && !ctrl_ssl_established) {
+            //failure to establish security policy
+            MO_DBG_ERR("internal error");
+            send_cmd("QUIT", nullptr, true);
+            return;
+        }
+
+        //security policy met
+                
+        if (!strncmp("530", line, 3)            // Not logged in
+                || !strncmp("220", line, 3)     // Service ready for new user
+                || !strncmp("234", line, 3)) {  // Just completed AUTH TLS handshake
+            MO_DBG_DEBUG("select user %s", user.empty() ? "anonymous" : user.c_str());
+            send_cmd("USER", user.empty() ? "anonymous" : user.c_str());
+        } else if (!strncmp("331", line, 3)) { // User name okay, need password
+            MO_DBG_DEBUG("enter pass %.2s***", pass.empty() ? "-" : pass.c_str());
+            send_cmd("PASS", pass.c_str());
+        } else if (!strncmp("230", line, 3)) { // User logged in, proceed
+            MO_DBG_DEBUG("select directory %s", dir.empty() ? "/" : dir.c_str());
+            send_cmd("CWD", dir.empty() ? "/" : dir.c_str());
+        } else if (!strncmp("250", line, 3)) { // Requested file action okay, completed
+            MO_DBG_DEBUG("enter passive mode");
+            if (isSecure) {
+                send_cmd("PBSZ 0\r\n"
+                         "PROT P\r\n" //RFC 4217: set FTP session Private
+                         "PASV");
+            } else {
+                send_cmd("PASV");
+            }
+        } else if (!strncmp("227", line, 3)) { // Entering Passive Mode (h1,h2,h3,h4,p1,p2)
+
+            if (!read_url_data(line + 3)) { //trim leading response code
+                MO_DBG_ERR("could not process data url. Expect format: (h1,h2,h3,h4,p1,p2)");
+                send_cmd("QUIT");
+                return;
+            }
+
+            if (auto ret = connect_data()) {
+                MO_DBG_ERR("data connection failure: %i", ret);
+                send_cmd("QUIT");
+                return;
+            }
+
+            if (method == Method::Retrieve) {
+                MO_DBG_DEBUG("request download for %s", fname.c_str());
+                send_cmd("RETR", fname.c_str());
+            } else if (method == Method::Store) {
+                MO_DBG_DEBUG("request upload for %s", fname.c_str());
+                send_cmd("STOR", fname.c_str());
+            } else {
+                MO_DBG_ERR("internal error");
+                send_cmd("QUIT");
+                return;
+            }
+
+        } else if (!strncmp("150", line, 3)    // File status okay; about to open data connection
+                || !strncmp("125", line, 3)) { // Data connection already open
+            MO_DBG_DEBUG("data connection accepted");
+            data_conn_accepted = true;
+        } else if (!strncmp("226", line, 3)) { // Closing data connection. Requested file action successful (for example, file transfer or file abort)
+            MO_DBG_INFO("FTP success: %s", line);
+            send_cmd("QUIT");
+            return;
+        } else if (!strncmp("55", line, 2)) { // Requested action not taken / aborted
+            MO_DBG_WARN("FTP failure: %s", line);
+            send_cmd("QUIT");
+            return;
+        } else if (!strncmp("200", line, 3)) { //PBSZ -> 0 and PROT -> P accepted
+            MO_DBG_INFO("PBSZ/PROT success: %s", line);
+            (void)0;
+        } else if (!strncmp("221", line, 3)) { // Server Goodbye
+            MO_DBG_DEBUG("closing ctrl connection");
+            close_ctrl();
+            return;
+        } else {
+            MO_DBG_WARN("unkown commad (close connection): %s", line);
+            send_cmd("QUIT");
+            return;
+        }
+    }
+}
+
+void FtpTransferMbedTLS::process_data() {
+    if (!data_conn_accepted) {
+        return;
+    }
+
+    if (isSecure && !data_ssl_established) {
+        //failure to establish security policy
+        MO_DBG_ERR("internal error");
+        send_cmd("QUIT", nullptr, true);
+        return;
+    }
+
+    if (method == Method::Retrieve) {
+
+        if (data_buf_avail == 0) {
+            //load new data from socket
+
+            data_buf_offs = 0;
+
+            int ret = -1;
+            if (data_ssl_established) {
+                ret = mbedtls_ssl_read(&data_ssl, data_buf, data_buf_size - 1);
+            } else {
+                ret = mbedtls_net_recv(&data_fd, data_buf, data_buf_size - 1);
+            }
+
+            if (ret == MBEDTLS_ERR_SSL_WANT_READ || ret == MBEDTLS_ERR_SSL_WANT_WRITE) {
+                //no new input data to be processed
+                return;
+            } else if (ret == MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY || ret == 0) {
+                //download finished
+                close_data();
+                return;
+            } else if (ret < 0) {
+                MO_DBG_ERR("mbedtls_net_recv: %i", ret);
+                close_data();
+                return;
+            }
+
+            data_buf_avail = ret;
+        }
+
+        auto ret = fileWriter(data_buf + data_buf_offs, data_buf_avail);
+
+        if (ret <= data_buf_avail) {
+            data_buf_avail -= ret;
+            data_buf_offs += ret;
+        } else {
+            MO_DBG_ERR("write error");
+            send_cmd("QUIT");
+            return;
+        }
+
+        //success
+    } else if (method == Method::Store) {
+
+        if (data_buf_avail == 0) {
+            //load new data from file to write on socket
+
+            data_buf_offs = 0;
+
+            data_buf_avail = fileReader(data_buf, data_buf_size);
+        }
+
+        if (data_buf_avail > 0) {
+
+            int ret = -1;
+            if (data_ssl_established) {
+                ret = mbedtls_ssl_write(&data_ssl, data_buf + data_buf_offs, data_buf_avail);
+            } else {
+                ret = mbedtls_net_send(&data_fd, data_buf + data_buf_offs, data_buf_avail);
+            }
+
+            if (ret == MBEDTLS_ERR_SSL_WANT_READ || ret == MBEDTLS_ERR_SSL_WANT_WRITE) {
+                //no data sent, wait
+                return;
+            } else if (ret <= 0) {
+                MO_DBG_ERR("mbedtls_ssl_write: %i", ret);
+                send_cmd("QUIT");
+                return;
+            }
+
+            //successful write
+            data_buf_avail -= ret;
+            data_buf_offs += ret;
+        } else {
+            //no data in fileReader anymore
+            MO_DBG_DEBUG("finished file reading");
+            close_data();
+        }
+    }
+}
+
+void FtpTransferMbedTLS::loop() {
+
+    if (ctrl_opened) {
+        process_ctrl();
+    }
+
+    if (data_opened) {
+        process_data();
+    }
+}
+
+bool FtpTransferMbedTLS::read_url_ctrl(const char *ftp_url_raw) {
+    std::string ftp_url = ftp_url_raw; //copy input ftp_url
+
+    //tolower protocol specifier
+    for (auto c = ftp_url.begin(); *c != ':' && c != ftp_url.end(); c++) {
+        *c = tolower(*c);
+    }
+
+    //parse FTP URL: protocol specifier
+    std::string proto;
+    if (!strncmp(ftp_url.c_str(), "ftps://", strlen("ftps://"))) {
+        //FTP over TLS (RFC 4217)
+        proto = "ftps://";
+        isSecure = true; //TLS policy
+    } else if (!strncmp(ftp_url.c_str(), "ftp://", strlen("ftp://"))) {
+        //FTP without security policies (RFC 959)
+        proto = "ftp://";
+    } else {
+        MO_DBG_ERR("protocol not supported. Please use ftps:// or ftp://");
+        return false;
+    }
+
+    //parse FTP URL: dir and fname
+    auto dir_pos = ftp_url.find_first_of('/', proto.length());
+    if (dir_pos != std::string::npos) {
+        auto fname_pos = ftp_url.find_last_of('/');
+        dir = ftp_url.substr(dir_pos, fname_pos - dir_pos);
+        fname = ftp_url.substr(fname_pos + 1);
+    }
+
+    if (fname.empty()) {
+        MO_DBG_ERR("missing filename");
+        return false;
+    }
+
+    MO_DBG_DEBUG("parsed dir: %s; fname: %s", dir.c_str(), fname.c_str());
+
+    //parse FTP URL: user, pass, host, port
+
+    std::string user_pass_host_port = ftp_url.substr(proto.length(), dir_pos - proto.length());
+    std::string user_pass, host_port;
+    auto user_pass_delim = user_pass_host_port.find_first_of('@');
+    if (user_pass_delim != std::string::npos) {
+        host_port = user_pass_host_port.substr(user_pass_delim + 1);
+        user_pass = user_pass_host_port.substr(0, user_pass_delim);
+    } else {
+        host_port = user_pass_host_port;
+    }
+
+    if (!user_pass.empty()) {
+        auto user_delim = user_pass.find_first_of(':');
+        if (user_delim != std::string::npos) {
+            user = user_pass.substr(0, user_delim);
+            pass = user_pass.substr(user_delim + 1);
+        } else {
+            user = user_pass;
+        }
+    }
+
+    MO_DBG_DEBUG("parsed user: %s; pass: %.2s***", user.c_str(), pass.empty() ? "-" : pass.c_str());
+
+    if (host_port.empty()) {
+        MO_DBG_ERR("missing hostname");
+        return false;
+    }
+
+    auto host_port_delim = host_port.find(':');
+    if (host_port_delim != std::string::npos) {
+        ctrl_host = host_port.substr(0, host_port_delim);
+        ctrl_port = host_port.substr(host_port_delim + 1);
+    } else {
+        //use default port number
+        ctrl_host = host_port;
+        ctrl_port = "21";
+    }
+
+    MO_DBG_DEBUG("parsed host: %s; port: %s", ctrl_host.c_str(), ctrl_port.c_str());
+
+    return true;
+}
+
+bool FtpTransferMbedTLS::read_url_data(const char *data_url_raw) {
+
+    std::string data_url = data_url_raw; //format like " Entering Passive Mode (h1,h2,h3,h4,p1,p2)"
+
+    // parse address field. Replace all non-digits by delimiter character ' '
+    for (char& c : data_url) {
+        if (c < '0' || c > '9') {
+            c = (unsigned char) ' ';
+        }
+    }
+
+    unsigned int h1 = 0, h2 = 0, h3 = 0, h4 = 0, p1 = 0, p2 = 0;
+
+    auto ntokens = sscanf(data_url.c_str(), "%u %u %u %u %u %u", &h1, &h2, &h3, &h4, &p1, &p2);
+    if (ntokens != 6) {
+        MO_DBG_ERR("could not process data url. Expect format: (h1,h2,h3,h4,p1,p2)");
+        return false;
+    }
+
+    unsigned int port = 256U * p1 + p2;
+
+    char buf [64] = {'\0'};
+    auto ret = snprintf(buf, 64, "%u.%u.%u.%u", h1, h2, h3, h4);
+    if (ret < 0 || ret >= 64) {
+        MO_DBG_ERR("data url format failure");
+        return false;
+    }
+    data_host = buf;
+
+    ret = snprintf(buf, 64, "%u", port);
+    if (ret < 0 || ret >= 64) {
+        MO_DBG_ERR("data url format failure");
+        return false;
+    }
+    data_port = buf;
+
+    return true;
+}
+
+FtpClientMbedTLS::FtpClientMbedTLS(bool tls_only, const char *client_cert, const char *client_key)
+        : tls_only(tls_only), client_cert(client_cert), client_key(client_key) {
+
+}
+
+std::unique_ptr<FtpDownload> FtpClientMbedTLS::getFile(const char *ftp_url_raw, std::function<size_t(unsigned char *data, size_t len)> fileWriter, std::function<void()> onClose, const char *ca_cert) {
+
+    auto ftp_handle = std::unique_ptr<FtpTransferMbedTLS>(new FtpTransferMbedTLS(tls_only, client_cert, client_key));
+    if (!ftp_handle) {
+        MO_DBG_ERR("OOM");
+        return nullptr;
+    }
+
+    bool success = ftp_handle->getFile(ftp_url_raw, fileWriter, onClose, ca_cert);
+
+    if (success) {
+        return ftp_handle;
+    } else {
+        return nullptr;
+    }
+}
+
+std::unique_ptr<FtpUpload> FtpClientMbedTLS::postFile(const char *ftp_url_raw, std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, std::function<void()> onClose, const char *ca_cert) {
+    
+    auto ftp_handle = std::unique_ptr<FtpTransferMbedTLS>(new FtpTransferMbedTLS(tls_only, client_cert, client_key));
+    if (!ftp_handle) {
+        MO_DBG_ERR("OOM");
+        return nullptr;
+    }
+
+    bool success = ftp_handle->postFile(ftp_url_raw, fileReader, onClose, ca_cert);
+
+    if (success) {
+        return ftp_handle;
+    } else {
+        return nullptr;
+    }
+}
+
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_MBEDTLS
diff --git a/src/MicroOcpp/Core/FtpMbedTLS.h b/src/MicroOcpp/Core/FtpMbedTLS.h
new file mode 100644
index 00000000..799b3905
--- /dev/null
+++ b/src/MicroOcpp/Core/FtpMbedTLS.h
@@ -0,0 +1,40 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_FTP_MBEDTLS_H
+#define MO_FTP_MBEDTLS_H
+
+/*
+ * Built-in FTP client (depends on MbedTLS)
+ *
+ * Moved from https://github.com/matth-x/MicroFtp
+ * 
+ * Currently, the compatibility with the following FTP servers has been tested:
+ * 
+ * | Server                                                                | FTP | FTPS |
+ * | --------------------------------------------------------------------- | --- | ---- |
+ * | [vsftp](https://security.appspot.com/vsftpd.html)                     |     |  x   |
+ * | [Rebex](https://www.rebex.net/)                                       |  x  |  x   |
+ * | [Windows Server 2022](https://www.microsoft.com/en-us/windows-server) |  x  |  x   |
+ * | [SFTPGo](https://github.com/drakkan/sftpgo)                           |  x  |      |
+ * 
+ */
+
+#include <MicroOcpp/Platform.h>
+
+#if MO_ENABLE_MBEDTLS
+
+#include <memory>
+
+#include <MicroOcpp/Core/Ftp.h>
+
+namespace MicroOcpp {
+
+std::unique_ptr<FtpClient> makeFtpClientMbedTLS(bool tls_only = false, const char *client_cert = nullptr, const char *client_key = nullptr);
+
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_MBEDTLS
+
+#endif
diff --git a/src/MicroOcpp/Debug.h b/src/MicroOcpp/Debug.h
index 238e8b7a..59b8c227 100644
--- a/src/MicroOcpp/Debug.h
+++ b/src/MicroOcpp/Debug.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_DEBUG_H
@@ -18,6 +18,11 @@
 #define MO_DBG_LEVEL MO_DL_INFO  //default
 #endif
 
+//MbedTLS debug level documented in mbedtls/debug.h:
+#ifndef MO_DBG_LEVEL_MBEDTLS
+#define MO_DBG_LEVEL_MBEDTLS 1
+#endif
+
 #define MO_DF_MINIMAL 0x00   //don't reveal origin of a debug message
 #define MO_DF_COMPACT 0x01   //print module by file name and line number
 #define MO_DF_FILE_LINE 0x02 //print file and line number
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
index 36a773d5..145909be 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h>
 
-#if MO_ENABLE_MBEDTLS
+#if MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
 
 #include <string.h>
 
@@ -402,4 +402,4 @@ bool printCertFn(const char *certType, size_t index, char *buf, size_t bufsize)
 
 } //namespace MicroOcpp
 
-#endif //MO_ENABLE_MBEDTLS
+#endif //MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
index 4cb7e86b..9dd38341 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
@@ -9,11 +9,13 @@
  * Built-in implementation of the Certificate interface for MbedTLS
  */
 
-#ifndef MO_ENABLE_MBEDTLS
-#define MO_ENABLE_MBEDTLS 0
+#include <MicroOcpp/Platform.h>
+
+#ifndef MO_ENABLE_CERT_STORE_MBEDTLS
+#define MO_ENABLE_CERT_STORE_MBEDTLS 1
 #endif
 
-#if MO_ENABLE_MBEDTLS
+#if MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
 
 /*
  * Provide certificate interpreter to facilitate cert store in C. A full implementation is only available for C++
@@ -62,6 +64,6 @@ bool printCertFn(const char *certType, size_t index, char *buf, size_t bufsize);
 } //namespace MicroOcpp
 
 #endif //def __cplusplus
-#endif //MO_ENABLE_MBEDTLS
+#endif //MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
 
 #endif
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index 220c20d3..30a4c272 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_PLATFORM_H
@@ -106,4 +106,8 @@ unsigned long mocpp_tick_ms_unix();
 void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target);
 #endif
 
+#ifndef MO_ENABLE_MBEDTLS
+#define MO_ENABLE_MBEDTLS 0
+#endif
+
 #endif

From e38e9f8b2d93c34e84fe9abf93816fbae30c3953 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 5 May 2024 13:06:02 +0200
Subject: [PATCH 477/549] add more build switches for TLS (#292)

* add cmake switch MO_BUILD_UNIT_MBEDTLS

* fix memory leaks

* add MO_ENABLE_CERT_MGMT switch

* add .gitignore

* update changelog

* update changelog

* enable Cert Mgmt by default for v2.0.1
---
 .github/workflows/tests.yml                   | 20 ++++---
 .gitignore                                    |  7 +++
 CHANGELOG.md                                  | 22 ++++----
 CMakeLists.txt                                | 23 ++++----
 src/MicroOcpp.cpp                             | 52 +++++++++++++------
 src/MicroOcpp.h                               | 19 ++++++-
 src/MicroOcpp/Core/FtpMbedTLS.cpp             |  1 +
 .../Model/Certificates/Certificate.cpp        |  4 ++
 .../Model/Certificates/Certificate.h          |  8 ++-
 .../Model/Certificates/CertificateMbedTLS.cpp | 40 ++++++++------
 .../Model/Certificates/CertificateMbedTLS.h   |  7 +--
 .../Model/Certificates/CertificateService.cpp | 13 ++++-
 .../Model/Certificates/CertificateService.h   |  8 ++-
 .../Model/Certificates/Certificate_c.cpp      |  4 ++
 .../Model/Certificates/Certificate_c.h        |  7 ++-
 src/MicroOcpp/Model/Model.cpp                 |  2 +
 src/MicroOcpp/Model/Model.h                   | 10 +++-
 .../Operations/DeleteCertificate.cpp          |  5 ++
 src/MicroOcpp/Operations/DeleteCertificate.h  |  5 ++
 .../Operations/GetInstalledCertificateIds.cpp |  5 ++
 .../Operations/GetInstalledCertificateIds.h   |  5 ++
 .../Operations/InstallCertificate.cpp         |  5 ++
 src/MicroOcpp/Operations/InstallCertificate.h |  5 ++
 src/MicroOcpp/Version.h                       | 11 +++-
 src/MicroOcpp_c.cpp                           | 21 +++++---
 src/MicroOcpp_c.h                             |  8 +--
 tests/Certificates.cpp                        | 13 +++--
 27 files changed, 242 insertions(+), 88 deletions(-)
 create mode 100644 .gitignore

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index bf857dbc..6b30c91e 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -15,6 +15,12 @@ jobs:
     steps:
     - name: Check out repository code
       uses: actions/checkout@v3
+    - name: Check out MbedTLS
+      uses: actions/checkout@v3
+      with:
+        repository: Mbed-TLS/mbedtls
+        ref: v2.28.1
+        path: lib/mbedtls
     - name: Get build tools
       run: |
         sudo apt update
@@ -25,23 +31,21 @@ jobs:
     - name: Get ArduinoJson
       run: wget -Uri https://github.com/bblanchon/ArduinoJson/releases/download/v6.21.3/ArduinoJson-v6.21.3.h -O ./src/ArduinoJson.h
     - name: Generate CMake build files
-      run: cmake -S . -B ./build
+      run: cmake -S . -B ./build -DMO_BUILD_UNIT_MBEDTLS=True
     - name: Compile
-      run: cmake --build ./build -j 16 --target mo_unit_tests
+      run: cmake --build ./build -j 32 --target mo_unit_tests
     - name: Configure FS
       run: mkdir mo_store
-    - name: Run tests
-      run: ./build/mo_unit_tests
     - name: Run tests (valgrind)
-      run: valgrind --error-exitcode=1 --leak-check=full ./build/mo_unit_tests
+      run: valgrind --error-exitcode=1 --leak-check=full ./build/mo_unit_tests --abort
     - name: Generate CMake build files (AddressSanitizer, UndefinedBehaviorSanitizer)
       run: |
         rm -r ./build
-        cmake -S . -B ./build -DCMAKE_CXX_FLAGS="-fsanitize=address -fsanitize=undefined" -DCMAKE_EXE_LINKER_FLAGS="-fsanitize=address -fsanitize=undefined"
+        cmake -S . -B ./build -DCMAKE_CXX_FLAGS="-fsanitize=address -fsanitize=undefined" -DCMAKE_EXE_LINKER_FLAGS="-fsanitize=address -fsanitize=undefined" -DMO_BUILD_UNIT_MBEDTLS=True
     - name: Compile (ASan, UBSan)
-      run: cmake --build ./build -j 16 --target mo_unit_tests
+      run: cmake --build ./build -j 32 --target mo_unit_tests
     - name: Run tests (ASan, UBSan)
-      run: ./build/mo_unit_tests
+      run: ./build/mo_unit_tests --abort
     - name: Create coverage report
       run: |
         lcov --directory . --capture --output-file coverage.info
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 00000000..2b234a58
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,7 @@
+.pio
+build
+lib
+mo_store
+src/ArduinoJson*
+src/main.cpp
+coverage.info
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a63ba4c4..db405854 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,22 +4,22 @@
 
 ### Changed
 
-- Replace `PollResult<bool>` with enum `UnlockConnectorResult`
+- Replace `PollResult<bool>` with enum `UnlockConnectorResult` ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
 - Rename master branch into main
 - Tx logic directly checks if WebSocket is offline ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
+- `ocppPermitsCharge` ignores Faulted state ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
 
 ### Added
 
 - File index ([#270](https://github.com/matth-x/MicroOcpp/pull/270))
-- Config `Cst_TxStartOnPowerPathClosed` to put back TxStartPoint
+- Config `Cst_TxStartOnPowerPathClosed` to put back TxStartPoint ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
 - Function `bool isConnected()` in `Connection` interface ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
-- Build flags for customizing memory limits of SmartCharging
+- Build flags for customizing memory limits of SmartCharging ([#260](https://github.com/matth-x/MicroOcpp/pull/260))
 - SConscript ([#287](https://github.com/matth-x/MicroOcpp/pull/287))
-- Operation GetInstalledCertificateIds, UC M03 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
-- Operation DeleteCertificate, UC M04 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
-- Operation InstallCertificate, UC M05 ([#262](https://github.com/matth-x/MicroOcpp/pull/262))
+- Certificate Management, UCs M03 - M05 ([#262](https://github.com/matth-x/MicroOcpp/pull/262), [#274](https://github.com/matth-x/MicroOcpp/pull/274), [#292](https://github.com/matth-x/MicroOcpp/pull/292))
+- FTP Client ([#291](https://github.com/matth-x/MicroOcpp/pull/291))
 - `ProtocolVersion` selects v1.6 or v2.0.1 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
-- Build flag `MO_ENABLE_V201` set to 1 enables OCPP 2.0.1 features ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
+- Build flag `MO_ENABLE_V201=1` enables OCPP 2.0.1 features ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
     - Variables (non-persistent), UCs B05 - B07 ([#247](https://github.com/matth-x/MicroOcpp/pull/247), [#284](https://github.com/matth-x/MicroOcpp/pull/284))
     - Transactions (preview only), UCs E01 - E12 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
     - StatusNotification compatibility ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
@@ -29,15 +29,15 @@
 
 ### Fixed
 
-- Fix defect idTag check in `endTransaction`
+- Fix defect idTag check in `endTransaction` ([#275](https://github.com/matth-x/MicroOcpp/pull/275))
 - Make field localAuthorizationList in SendLocalList optional
 - Update charging profiles when flash disabled (relates to [#260](https://github.com/matth-x/MicroOcpp/pull/260))
-- Ignore UnlockConnector when handler not set
-- Reject ChargingProfile if unit not supported
+- Ignore UnlockConnector when handler not set ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
+- Reject ChargingProfile if unit not supported ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
 - Fix building with debug level warn and error
 - Fix transaction freeze in offline mode ([#279](https://github.com/matth-x/MicroOcpp/pull/279), [#287](https://github.com/matth-x/MicroOcpp/pull/287))
 - Fix compilation error caused by `PRId32` ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
-- Don't load FW-mngt. module when no handlers set
+- Don't load FW-mngt. module when no handlers set ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
 - Avoid creating conf when operation fails ([#290](https://github.com/matth-x/MicroOcpp/pull/290))
 
 ## [1.0.3] - 2024-04-06
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 3304e256..9f63067d 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -147,7 +147,7 @@ set(MO_SRC_UNIT
     tests/LocalAuthList.cpp
     tests/Variables.cpp
     tests/Transactions.cpp
-    #tests/Certificates.cpp # add if MbedTLS is available
+    tests/Certificates.cpp
 )
 
 add_executable(mo_unit_tests
@@ -156,13 +156,18 @@ add_executable(mo_unit_tests
     ./tests/catch2/catchMain.cpp
 )
 
-# add MbedTLS for testing (TODO integrate properly into build system)
-#add_subdirectory(lib/mbedtls)
-#target_link_libraries(mo_unit_tests PUBLIC 
-#    mbedtls
-#    mbedcrypto
-#    mbedx509
-#)
+if (MO_BUILD_UNIT_MBEDTLS)
+    add_subdirectory(lib/mbedtls)
+    target_link_libraries(mo_unit_tests PUBLIC 
+        mbedtls
+        mbedcrypto
+        mbedx509
+    )
+
+    target_compile_definitions(mo_unit_tests PUBLIC
+        MO_ENABLE_MBEDTLS=1
+    )
+endif()
 
 target_include_directories(mo_unit_tests PUBLIC
     "./tests/catch2"
@@ -181,10 +186,10 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_LocalAuthListMaxLength=8
     MO_SendLocalListMaxLength=4
     MO_ENABLE_FILE_INDEX=1
-    #MO_ENABLE_MBEDTLS=1
     MO_ChargeProfileMaxStackLevel=2
     MO_ChargingScheduleMaxPeriods=4
     MO_MaxChargingProfilesInstalled=3
+    MO_ENABLE_CERT_MGMT=1
 )
 
 target_compile_options(mo_unit_tests PUBLIC
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 7f01c4a3..ca29b41f 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -20,7 +20,7 @@
 #include <MicroOcpp/Model/Variables/VariableService.h>
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
-#include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h> //default CertStore implementation depends on MbedTLS
+#include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h>
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
@@ -234,7 +234,7 @@ ChargerCredentials ChargerCredentials::v201(const char *cpModel, const char *cpV
     return res;
 }
 
-void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs, bool autoRecover, MicroOcpp::ProtocolVersion version, std::unique_ptr<CertificateStore> certStore) {
+void mocpp_initialize(Connection& connection, const char *bootNotificationCredentials, std::shared_ptr<FilesystemAdapter> fs, bool autoRecover, MicroOcpp::ProtocolVersion version) {
     if (context) {
         MO_DBG_WARN("already initialized. To reinit, call mocpp_deinitialize() before");
         return;
@@ -297,6 +297,17 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new TransactionService(*context)));
 #endif
 
+#if MO_ENABLE_CERT_MGMT && MO_ENABLE_CERT_STORE_MBEDTLS
+    std::unique_ptr<CertificateStore> certStore = makeCertificateStoreMbedTLS(filesystem);
+    if (certStore) {
+        model.setCertificateService(std::unique_ptr<CertificateService>(
+            new CertificateService(*context)));
+    }
+    if (certStore && model.getCertificateService()) {
+        model.getCertificateService()->setCertificateStore(std::move(certStore));
+    }
+#endif
+
 #if MO_ENABLE_V201
     if (version.major == 2) {
         //depends on VariableService
@@ -309,21 +320,6 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
             new ResetService(*context)));
     }
 
-    std::unique_ptr<CertificateStore> certStoreUse;
-    if (certStore) {
-        certStoreUse = std::move(certStore);
-    }
-#if MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
-    else {
-        certStoreUse = makeCertificateStoreMbedTLS(filesystem);
-    }
-#endif
-
-    if (certStoreUse) {
-        model.setCertificateService(std::unique_ptr<CertificateService>(
-            new CertificateService(*context, std::move(certStoreUse))));
-    }
-
 #if MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
 #if defined(ESP32) || defined(ESP8266)
     model.setFirmwareService(std::unique_ptr<FirmwareService>(
@@ -956,6 +952,28 @@ DiagnosticsService *getDiagnosticsService() {
     return model.getDiagnosticsService();
 }
 
+#if MO_ENABLE_CERT_MGMT
+
+void setCertificateStore(std::unique_ptr<MicroOcpp::CertificateStore> certStore) {
+    if (!context) {
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
+        return;
+    }
+
+    auto& model = context->getModel();
+    if (!model.getCertificateService()) {
+        model.setCertificateService(std::unique_ptr<CertificateService>(
+            new CertificateService(*context)));
+    }
+    if (auto certService = model.getCertificateService()) {
+        certService->setCertificateStore(std::move(certStore));
+    } else {
+        MO_DBG_ERR("OOM");
+        (void)0;
+    }
+}
+#endif //MO_ENABLE_CERT_MGMT
+
 Context *getOcppContext() {
     return context;
 }
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 4233c330..5309767f 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -110,8 +110,7 @@ void mocpp_initialize(
             std::shared_ptr<MicroOcpp::FilesystemAdapter> filesystem =
                 MicroOcpp::makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail), //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
             bool autoRecover = false, //automatically sanitize the local data store when the lib detects recurring crashes. Not recommended during development
-            MicroOcpp::ProtocolVersion version = MicroOcpp::ProtocolVersion(1,6),
-            std::unique_ptr<MicroOcpp::CertificateStore> certStore = nullptr); //optionally use custom Cert Store (default depends on MbedTLS)
+            MicroOcpp::ProtocolVersion version = MicroOcpp::ProtocolVersion(1,6));
 
 /*
  * Stop the OCPP library and release allocated resources.
@@ -356,6 +355,22 @@ MicroOcpp::FirmwareService *getFirmwareService();
  */
 MicroOcpp::DiagnosticsService *getDiagnosticsService();
 
+#if MO_ENABLE_CERT_MGMT
+/*
+ * Set a custom Certificate Store which implements certificate updates on the host system. 
+ * MicroOcpp will forward OCPP-side update requests to the certificate store, as well as
+ * query the certificate store upon server request.
+ *
+ * To enable OCPP-side certificate updates (UCs M03 - M05), set the build flag
+ * MO_ENABLE_CERT_MGMT=1 so that this function becomes accessible.
+ * 
+ * To use the built-in certificate store (depends on MbedTLS), set the build flag
+ * MO_ENABLE_MBEDTLS=1. To not use the built-in implementation, but still enable MbedTLS,
+ * additionally set MO_ENABLE_CERT_STORE_MBEDTLS=0.
+ */
+void setCertificateStore(std::unique_ptr<MicroOcpp::CertificateStore> certStore);
+#endif //MO_ENABLE_CERT_MGMT
+
 /*
  * Add features and customize the behavior of the OCPP client
  */
diff --git a/src/MicroOcpp/Core/FtpMbedTLS.cpp b/src/MicroOcpp/Core/FtpMbedTLS.cpp
index e135586c..156ae14c 100644
--- a/src/MicroOcpp/Core/FtpMbedTLS.cpp
+++ b/src/MicroOcpp/Core/FtpMbedTLS.cpp
@@ -7,6 +7,7 @@
 #if MO_ENABLE_MBEDTLS
 
 #include <string>
+#include <string.h>
 #include <functional>
 
 #include "mbedtls/net_sockets.h"
diff --git a/src/MicroOcpp/Model/Certificates/Certificate.cpp b/src/MicroOcpp/Model/Certificates/Certificate.cpp
index f0f80033..1de32094 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate.cpp
+++ b/src/MicroOcpp/Model/Certificates/Certificate.cpp
@@ -4,6 +4,8 @@
 
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 
+#if MO_ENABLE_CERT_MGMT
+
 #include <string.h>
 #include <stdio.h>
 
@@ -161,3 +163,5 @@ int ocpp_cert_set_serialNumber(ocpp_cert_hash *dst, const char *hex_src) {
 
     return ret;
 }
+
+#endif //MO_ENABLE_CERT_MGMT
diff --git a/src/MicroOcpp/Model/Certificates/Certificate.h b/src/MicroOcpp/Model/Certificates/Certificate.h
index fc954b5c..d9975bf7 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate.h
+++ b/src/MicroOcpp/Model/Certificates/Certificate.h
@@ -5,6 +5,10 @@
 #ifndef MO_CERTIFICATE_H
 #define MO_CERTIFICATE_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <stddef.h>
 
 #ifdef __cplusplus
@@ -144,6 +148,8 @@ struct CertificateChainHash {
  */
 class CertificateStore {
 public:
+    virtual ~CertificateStore() = default;
+
     virtual GetInstalledCertificateStatus getCertificateIds(const std::vector<GetCertificateIdType>& certificateType, std::vector<CertificateChainHash>& out) = 0;
     virtual DeleteCertificateStatus deleteCertificate(const CertificateHash& hash) = 0;
     virtual InstallCertificateStatus installCertificate(InstallCertificateType certificateType, const char *certificate) = 0;
@@ -152,5 +158,5 @@ class CertificateStore {
 } //namespace MicroOcpp
 
 #endif //__cplusplus
-
+#endif //MO_ENABLE_CERT_MGMT
 #endif
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
index 145909be..fe7400a7 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h>
 
-#if MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
+#if MO_ENABLE_CERT_MGMT && MO_ENABLE_CERT_STORE_MBEDTLS
 
 #include <string.h>
 
@@ -15,19 +15,7 @@
 
 #include <MicroOcpp/Debug.h>
 
-bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmType hashAlg, ocpp_cert_hash *out) {
-
-    mbedtls_x509_crt cacert;
-    mbedtls_x509_crt_init(&cacert);
-
-    int ret;
-
-    if((ret = mbedtls_x509_crt_parse(&cacert, buf, len + 1)) < 0) {
-        char err [100];
-        mbedtls_strerror(ret, err, 100);
-        MO_DBG_ERR("mbedtls_x509_crt_parse: %i -- %s", ret, err);
-        return false;
-    }
+bool ocpp_get_cert_hash(mbedtls_x509_crt& cacert, HashAlgorithmType hashAlg, ocpp_cert_hash *out) {
 
     if (cacert.next) {
         MO_DBG_ERR("only sole root certs supported");
@@ -72,6 +60,8 @@ bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmType
         return false;
     }
 
+    int ret;
+
     if ((ret = mbedtls_md(md_info, cacert.issuer_raw.p, cacert.issuer_raw.len, out->issuerNameHash))) {
         MO_DBG_ERR("mbedtls_md: %i", ret);
         return false;
@@ -122,6 +112,26 @@ bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmType
     return true;
 }
 
+bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmType hashAlg, ocpp_cert_hash *out) {
+
+    mbedtls_x509_crt cacert;
+    mbedtls_x509_crt_init(&cacert);
+
+    bool success = false;
+    int ret;
+
+    if((ret = mbedtls_x509_crt_parse(&cacert, buf, len + 1)) >= 0) {
+        success = ocpp_get_cert_hash(cacert, hashAlg, out);
+    } else {
+        char err [100];
+        mbedtls_strerror(ret, err, 100);
+        MO_DBG_ERR("mbedtls_x509_crt_parse: %i -- %s", ret, err);
+    }
+
+    mbedtls_x509_crt_free(&cacert);
+    return success;
+}
+
 namespace MicroOcpp {
 
 class CertificateStoreMbedTLS : public CertificateStore {
@@ -402,4 +412,4 @@ bool printCertFn(const char *certType, size_t index, char *buf, size_t bufsize)
 
 } //namespace MicroOcpp
 
-#endif //MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
+#endif //MO_ENABLE_CERT_MGMT && MO_ENABLE_CERT_STORE_MBEDTLS
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
index 9dd38341..e60a2734 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.h
@@ -9,13 +9,14 @@
  * Built-in implementation of the Certificate interface for MbedTLS
  */
 
+#include <MicroOcpp/Version.h>
 #include <MicroOcpp/Platform.h>
 
 #ifndef MO_ENABLE_CERT_STORE_MBEDTLS
-#define MO_ENABLE_CERT_STORE_MBEDTLS 1
+#define MO_ENABLE_CERT_STORE_MBEDTLS MO_ENABLE_MBEDTLS
 #endif
 
-#if MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
+#if MO_ENABLE_CERT_MGMT && MO_ENABLE_CERT_STORE_MBEDTLS
 
 /*
  * Provide certificate interpreter to facilitate cert store in C. A full implementation is only available for C++
@@ -64,6 +65,6 @@ bool printCertFn(const char *certType, size_t index, char *buf, size_t bufsize);
 } //namespace MicroOcpp
 
 #endif //def __cplusplus
-#endif //MO_ENABLE_MBEDTLS && MO_ENABLE_CERT_STORE_MBEDTLS
+#endif //MO_ENABLE_CERT_MGMT && MO_ENABLE_CERT_STORE_MBEDTLS
 
 #endif
diff --git a/src/MicroOcpp/Model/Certificates/CertificateService.cpp b/src/MicroOcpp/Model/Certificates/CertificateService.cpp
index 37ef7c9c..b07c2f72 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateService.cpp
+++ b/src/MicroOcpp/Model/Certificates/CertificateService.cpp
@@ -3,6 +3,9 @@
 // MIT License
 
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/DeleteCertificate.h>
 #include <MicroOcpp/Operations/GetInstalledCertificateIds.h>
@@ -10,8 +13,8 @@
 
 using namespace MicroOcpp;
 
-CertificateService::CertificateService(Context& context, std::unique_ptr<CertificateStore> certStore)
-        : context(context), certStore(std::move(certStore)) {
+CertificateService::CertificateService(Context& context)
+        : context(context) {
 
     context.getOperationRegistry().registerOperation("DeleteCertificate", [this] () {
         return new Ocpp201::DeleteCertificate(*this);});
@@ -21,6 +24,12 @@ CertificateService::CertificateService(Context& context, std::unique_ptr<Certifi
         return new Ocpp201::InstallCertificate(*this);});
 }
 
+void CertificateService::setCertificateStore(std::unique_ptr<CertificateStore> certStore) {
+    this->certStore = std::move(certStore);
+}
+
 CertificateStore *CertificateService::getCertificateStore() {
     return certStore.get();
 }
+
+#endif //MO_ENABLE_CERT_MGMT
diff --git a/src/MicroOcpp/Model/Certificates/CertificateService.h b/src/MicroOcpp/Model/Certificates/CertificateService.h
index 7a45eca9..6d11d026 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateService.h
+++ b/src/MicroOcpp/Model/Certificates/CertificateService.h
@@ -14,6 +14,10 @@
 #ifndef MO_CERTIFICATESERVICE_H
 #define MO_CERTIFICATESERVICE_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <functional>
 #include <memory>
 
@@ -28,11 +32,13 @@ class CertificateService {
     Context& context;
     std::unique_ptr<CertificateStore> certStore;
 public:
-    CertificateService(Context& context, std::unique_ptr<CertificateStore> certStore);
+    CertificateService(Context& context);
 
+    void setCertificateStore(std::unique_ptr<CertificateStore> certStore);
     CertificateStore *getCertificateStore();
 };
 
 }
 
+#endif //MO_ENABLE_CERT_MGMT
 #endif
diff --git a/src/MicroOcpp/Model/Certificates/Certificate_c.cpp b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
index 0d93791f..1152af3b 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
+++ b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
@@ -3,6 +3,9 @@
 // MIT License
 
 #include <MicroOcpp/Model/Certificates/Certificate_c.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <MicroOcpp/Debug.h>
 
 #include <string.h>
@@ -70,3 +73,4 @@ std::unique_ptr<CertificateStore> makeCertificateStoreCwrapper(ocpp_cert_store *
 }
 
 } //namespace MicroOcpp
+#endif //MO_ENABLE_CERT_MGMT
diff --git a/src/MicroOcpp/Model/Certificates/Certificate_c.h b/src/MicroOcpp/Model/Certificates/Certificate_c.h
index f47b2f73..3b0bc858 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate_c.h
+++ b/src/MicroOcpp/Model/Certificates/Certificate_c.h
@@ -5,6 +5,10 @@
 #ifndef MO_CERTIFICATE_C_H
 #define MO_CERTIFICATE_C_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <stddef.h>
 
 #include <MicroOcpp/Model/Certificates/Certificate.h>
@@ -44,6 +48,7 @@ std::unique_ptr<CertificateStore> makeCertificateStoreCwrapper(ocpp_cert_store *
 
 } //namespace MicroOcpp
 
-#endif //defined __cplusplus
+#endif //__cplusplus
 
+#endif //MO_ENABLE_CERT_MGMT
 #endif
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 58218951..009ea0d4 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -198,6 +198,7 @@ ResetService *Model::getResetService() const {
     return resetService.get();
 }
 
+#if MO_ENABLE_CERT_MGMT
 void Model::setCertificateService(std::unique_ptr<CertificateService> cs) {
     this->certService = std::move(cs);
     capabilitiesUpdated = true;
@@ -206,6 +207,7 @@ void Model::setCertificateService(std::unique_ptr<CertificateService> cs) {
 CertificateService *Model::getCertificateService() const {
     return certService.get();
 }
+#endif //MO_ENABLE_CERT_MGMT
 
 #if MO_ENABLE_V201
 void Model::setVariableService(std::unique_ptr<VariableService> vs) {
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 148ff596..7a2c3500 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -24,7 +24,10 @@ class AuthorizationService;
 class ReservationService;
 class BootService;
 class ResetService;
+
+#if MO_ENABLE_CERT_MGMT
 class CertificateService;
+#endif //MO_ENABLE_CERT_MGMT
 
 #if MO_ENABLE_V201
 class VariableService;
@@ -33,7 +36,7 @@ class TransactionService;
 namespace Ocpp201 {
 class ResetService;
 }
-#endif
+#endif //MO_ENABLE_V201
 
 class Model {
 private:
@@ -49,7 +52,10 @@ class Model {
     std::unique_ptr<ReservationService> reservationService;
     std::unique_ptr<BootService> bootService;
     std::unique_ptr<ResetService> resetService;
+
+#if MO_ENABLE_CERT_MGMT
     std::unique_ptr<CertificateService> certService;
+#endif //MO_ENABLE_CERT_MGMT
 
 #if MO_ENABLE_V201
     std::unique_ptr<VariableService> variableService;
@@ -113,8 +119,10 @@ class Model {
     void setResetService(std::unique_ptr<ResetService> rs);
     ResetService *getResetService() const;
 
+#if MO_ENABLE_CERT_MGMT
     void setCertificateService(std::unique_ptr<CertificateService> cs);
     CertificateService *getCertificateService() const;
+#endif //MO_ENABLE_CERT_MGMT
 
 #if MO_ENABLE_V201
     void setVariableService(std::unique_ptr<VariableService> vs);
diff --git a/src/MicroOcpp/Operations/DeleteCertificate.cpp b/src/MicroOcpp/Operations/DeleteCertificate.cpp
index 5e3bf262..9bf42d39 100644
--- a/src/MicroOcpp/Operations/DeleteCertificate.cpp
+++ b/src/MicroOcpp/Operations/DeleteCertificate.cpp
@@ -3,6 +3,9 @@
 // MIT License
 
 #include <MicroOcpp/Operations/DeleteCertificate.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 #include <MicroOcpp/Debug.h>
@@ -88,3 +91,5 @@ std::unique_ptr<DynamicJsonDocument> DeleteCertificate::createConf(){
     payload["status"] = status;
     return doc;
 }
+
+#endif //MO_ENABLE_CERT_MGMT
diff --git a/src/MicroOcpp/Operations/DeleteCertificate.h b/src/MicroOcpp/Operations/DeleteCertificate.h
index 2c09a363..bf5bf616 100644
--- a/src/MicroOcpp/Operations/DeleteCertificate.h
+++ b/src/MicroOcpp/Operations/DeleteCertificate.h
@@ -5,6 +5,10 @@
 #ifndef MO_DELETECERTIFICATE_H
 #define MO_DELETECERTIFICATE_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <MicroOcpp/Core/Operation.h>
 
 namespace MicroOcpp {
@@ -33,4 +37,5 @@ class DeleteCertificate : public Operation {
 } //end namespace Ocpp201
 } //end namespace MicroOcpp
 
+#endif //MO_ENABLE_CERT_MGMT
 #endif
diff --git a/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
index 11aedc95..c0ca9028 100644
--- a/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
+++ b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
@@ -3,6 +3,9 @@
 // MIT License
 
 #include <MicroOcpp/Operations/GetInstalledCertificateIds.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 #include <MicroOcpp/Debug.h>
@@ -123,3 +126,5 @@ std::unique_ptr<DynamicJsonDocument> GetInstalledCertificateIds::createConf() {
 
     return doc;
 }
+
+#endif //MO_ENABLE_CERT_MGMT
diff --git a/src/MicroOcpp/Operations/GetInstalledCertificateIds.h b/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
index dae66c31..86c4cfad 100644
--- a/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
+++ b/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
@@ -5,6 +5,10 @@
 #ifndef MO_GETINSTALLEDCERTIFICATEIDS_H
 #define MO_GETINSTALLEDCERTIFICATEIDS_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Model/Certificates/Certificate.h>
 
@@ -35,4 +39,5 @@ class GetInstalledCertificateIds : public Operation {
 } //end namespace Ocpp201
 } //end namespace MicroOcpp
 
+#endif //MO_ENABLE_CERT_MGMT
 #endif
diff --git a/src/MicroOcpp/Operations/InstallCertificate.cpp b/src/MicroOcpp/Operations/InstallCertificate.cpp
index bafac549..dee8c57e 100644
--- a/src/MicroOcpp/Operations/InstallCertificate.cpp
+++ b/src/MicroOcpp/Operations/InstallCertificate.cpp
@@ -3,6 +3,9 @@
 // MIT License
 
 #include <MicroOcpp/Operations/InstallCertificate.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 #include <MicroOcpp/Debug.h>
 
@@ -77,3 +80,5 @@ std::unique_ptr<DynamicJsonDocument> InstallCertificate::createConf(){
     payload["status"] = status;
     return doc;
 }
+
+#endif //MO_ENABLE_CERT_MGMT
diff --git a/src/MicroOcpp/Operations/InstallCertificate.h b/src/MicroOcpp/Operations/InstallCertificate.h
index e6bbbcc6..b3ded1c1 100644
--- a/src/MicroOcpp/Operations/InstallCertificate.h
+++ b/src/MicroOcpp/Operations/InstallCertificate.h
@@ -5,6 +5,10 @@
 #ifndef MO_INSTALLCERTIFICATE_H
 #define MO_INSTALLCERTIFICATE_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_CERT_MGMT
+
 #include <MicroOcpp/Core/Operation.h>
 
 namespace MicroOcpp {
@@ -33,4 +37,5 @@ class InstallCertificate : public Operation {
 } //end namespace Ocpp201
 } //end namespace MicroOcpp
 
+#endif //MO_ENABLE_CERT_MGMT
 #endif
diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
index 6dac1b8a..c7ee0d77 100644
--- a/src/MicroOcpp/Version.h
+++ b/src/MicroOcpp/Version.h
@@ -6,7 +6,7 @@
 #define MO_VERSION_H
 
 /*
- * Version specification of MicroOcpp library (unrelated with the OCPP version)
+ * Version specification of MicroOcpp library (not related with the OCPP version)
  */
 #define MO_VERSION "1.1.0"
 
@@ -18,6 +18,8 @@
 #define MO_ENABLE_V201 0
 #endif
 
+#ifdef __cplusplus
+
 namespace MicroOcpp {
 
 /*
@@ -30,4 +32,11 @@ struct ProtocolVersion {
 
 }
 
+#endif //__cplusplus
+
+// Certificate Management (UCs M03 - M05). Works with OCPP 1.6 and 2.0.1
+#ifndef MO_ENABLE_CERT_MGMT
+#define MO_ENABLE_CERT_MGMT MO_ENABLE_V201
+#endif
+
 #endif
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 7f8fda2a..abb87d7e 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -13,10 +13,10 @@
 MicroOcpp::Connection *ocppSocket = nullptr;
 
 void ocpp_initialize(OCPP_Connection *conn, const char *chargePointModel, const char *chargePointVendor, struct OCPP_FilesystemOpt fsopt, bool autoRecover) {
-    ocpp_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt, autoRecover, NULL);
+    ocpp_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt, autoRecover);
 }
 
-void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt, bool autoRecover, ocpp_cert_store *certs) {
+void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt, bool autoRecover) {
     if (!conn) {
         MO_DBG_ERR("conn is null");
     }
@@ -25,12 +25,7 @@ void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCre
 
     MicroOcpp::FilesystemOpt adaptFsopt = fsopt;
 
-    std::unique_ptr<MicroOcpp::CertificateStore> certsCwrapper;
-    if (certs) {
-        certsCwrapper = MicroOcpp::makeCertificateStoreCwrapper(certs);
-    }
-
-    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt), autoRecover, MicroOcpp::ProtocolVersion(1,6),std::move(certsCwrapper));
+    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt), autoRecover, MicroOcpp::ProtocolVersion(1,6));
 }
 
 void ocpp_deinitialize() {
@@ -331,6 +326,16 @@ void ocpp_setOnResetExecute(void (*onResetExecute)(bool)) {
     setOnResetExecute([onResetExecute] (bool isHard) {onResetExecute(isHard);});
 }
 
+#if MO_ENABLE_CERT_MGMT
+void ocpp_setCertificateStore(ocpp_cert_store *certs) {
+    std::unique_ptr<MicroOcpp::CertificateStore> certsCwrapper;
+    if (certs) {
+        certsCwrapper = MicroOcpp::makeCertificateStoreCwrapper(certs);
+    }
+    setCertificateStore(std::move(certsCwrapper));
+}
+#endif //MO_ENABLE_CERT_MGMT
+
 void ocpp_setOnReceiveRequest(const char *operationType, OnMessage onRequest) {
     setOnReceiveRequest(operationType, adaptFn(onRequest));
 }
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index 94d033d1..4c1f1b6a 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -64,9 +64,7 @@ void ocpp_initialize_full(
             OCPP_Connection *conn,  //WebSocket adapter for MicroOcpp
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             struct OCPP_FilesystemOpt fsopt, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
-            bool autoRecover, //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
-            ocpp_cert_store *certs); //optional. If provided, use given Cert Store, if NULL, use default (default depends on MbedTLS)
-
+            bool autoRecover); //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
 
 void ocpp_deinitialize();
 
@@ -168,6 +166,10 @@ void ocpp_setOnResetNotify(bool (*onResetNotify)(bool));
 
 void ocpp_setOnResetExecute(void (*onResetExecute)(bool));
 
+#if MO_ENABLE_CERT_MGMT
+void ocpp_setCertificateStore(ocpp_cert_store *certs);
+#endif //MO_ENABLE_CERT_MGMT
+
 void ocpp_setOnReceiveRequest(const char *operationType, OnMessage onRequest);
 
 void ocpp_setOnSendConf(const char *operationType, OnMessage onConfirmation);
diff --git a/tests/Certificates.cpp b/tests/Certificates.cpp
index b3a858ec..b1193380 100644
--- a/tests/Certificates.cpp
+++ b/tests/Certificates.cpp
@@ -2,6 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Platform.h>
+
+#if MO_ENABLE_MBEDTLS
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"
@@ -18,11 +22,6 @@
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 #include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h>
 
-#if !MO_ENABLE_MBEDTLS
-#error Certificates unit tests depend on MbedTLS
-#endif
-
-
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 
 //ISRG Root X1
@@ -255,3 +254,7 @@ TEST_CASE( "M - Certificates" ) {
 
     mocpp_deinitialize();
 }
+
+#else
+#warning Certificates unit tests depend on MbedTLS
+#endif //MO_ENABLE_MBEDTLS

From 8eb9e2ea8c4f26949b0721e89db2caac49e1c8af Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Fri, 10 May 2024 14:35:45 +0200
Subject: [PATCH 478/549] C-API for custom Configurations store (#297)

* add C-API for custom Configs storage

* clean patches (#297)
---
 CHANGELOG.md                                 |   1 +
 CMakeLists.txt                               |   1 +
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp |   6 +-
 src/MicroOcpp/Core/ConfigurationKeyValue.h   |   8 +-
 src/MicroOcpp/Core/Configuration_c.cpp       | 195 +++++++++++++++++++
 src/MicroOcpp/Core/Configuration_c.h         |  71 +++++++
 tests/Configuration.cpp                      | 100 ++++++++++
 7 files changed, 375 insertions(+), 7 deletions(-)
 create mode 100644 src/MicroOcpp/Core/Configuration_c.cpp
 create mode 100644 src/MicroOcpp/Core/Configuration_c.h

diff --git a/CHANGELOG.md b/CHANGELOG.md
index db405854..138fd6de 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,6 +16,7 @@
 - Function `bool isConnected()` in `Connection` interface ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
 - Build flags for customizing memory limits of SmartCharging ([#260](https://github.com/matth-x/MicroOcpp/pull/260))
 - SConscript ([#287](https://github.com/matth-x/MicroOcpp/pull/287))
+- C-API for custom Configs store ([297](https://github.com/matth-x/MicroOcpp/pull/297))
 - Certificate Management, UCs M03 - M05 ([#262](https://github.com/matth-x/MicroOcpp/pull/262), [#274](https://github.com/matth-x/MicroOcpp/pull/274), [#292](https://github.com/matth-x/MicroOcpp/pull/292))
 - FTP Client ([#291](https://github.com/matth-x/MicroOcpp/pull/291))
 - `ProtocolVersion` selects v1.6 or v2.0.1 ([#247](https://github.com/matth-x/MicroOcpp/pull/247))
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 9f63067d..fe8120b7 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -7,6 +7,7 @@ cmake_minimum_required(VERSION 3.15)
 set(CMAKE_CXX_STANDARD 11)
 
 set(MO_SRC
+    src/MicroOcpp/Core/Configuration_c.cpp
     src/MicroOcpp/Core/Configuration.cpp
     src/MicroOcpp/Core/ConfigurationContainer.cpp
     src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index 52097583..82551d5b 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
@@ -12,10 +12,6 @@
 #define KEY_MAXLEN 60
 #define STRING_VAL_MAXLEN 512
 
-#ifndef MO_CONFIG_TYPECHECK
-#define MO_CONFIG_TYPECHECK 1 //enable this for debugging
-#endif
-
 namespace MicroOcpp {
 
 template<> TConfig convertType<int>() {return TConfig::Int;}
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index 8af972cb..e11a0484 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef CONFIGURATIONKEYVALUE_H
@@ -14,6 +14,10 @@
 #define MO_CONFIG_EXT_PREFIX "Cst_"
 #endif
 
+#ifndef MO_CONFIG_TYPECHECK
+#define MO_CONFIG_TYPECHECK 1 //enable this for debugging
+#endif
+
 namespace MicroOcpp {
 
 using revision_t = uint16_t;
@@ -49,7 +53,7 @@ class Configuration {
 
     virtual TConfig getType() = 0;
 
-    revision_t getValueRevision(); 
+    virtual revision_t getValueRevision();
 
     void setRebootRequired();
     bool isRebootRequired();
diff --git a/src/MicroOcpp/Core/Configuration_c.cpp b/src/MicroOcpp/Core/Configuration_c.cpp
new file mode 100644
index 00000000..ef4903e7
--- /dev/null
+++ b/src/MicroOcpp/Core/Configuration_c.cpp
@@ -0,0 +1,195 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Core/Configuration_c.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Debug.h>
+
+using namespace MicroOcpp;
+
+class ConfigurationC : public Configuration {
+private:
+    ocpp_configuration *config;
+public:
+    ConfigurationC(ocpp_configuration *config) :
+            config(config) {
+        config->mo_data = this;
+    }
+
+    bool setKey(const char *key) override {
+        return config->set_key(config->user_data, key);
+    }
+
+    const char *getKey() override {
+        return config->get_key(config->user_data);
+    }
+
+    void setInt(int val) override {
+        #if MO_CONFIG_TYPECHECK
+        if (config->get_type(config->user_data) != ENUM_CDT_INT) {
+            MO_DBG_ERR("type err");
+            return;
+        }
+        #endif
+        config->set_int(config->user_data, val);
+    }
+
+    void setBool(bool val) override {
+        #if MO_CONFIG_TYPECHECK
+        if (config->get_type(config->user_data) != ENUM_CDT_BOOL) {
+            MO_DBG_ERR("type err");
+            return;
+        }
+        #endif
+        config->set_bool(config->user_data, val);
+    }
+
+    bool setString(const char *val) override {
+        #if MO_CONFIG_TYPECHECK
+        if (config->get_type(config->user_data) != ENUM_CDT_STRING) {
+            MO_DBG_ERR("type err");
+            return false;
+        }
+        #endif
+        return config->set_string(config->user_data, val);
+    }
+
+    int getInt() override {
+        #if MO_CONFIG_TYPECHECK
+        if (config->get_type(config->user_data) != ENUM_CDT_INT) {
+            MO_DBG_ERR("type err");
+            return 0;
+        }
+        #endif
+        return config->get_int(config->user_data);
+    }
+
+    bool getBool() override {
+        #if MO_CONFIG_TYPECHECK
+        if (config->get_type(config->user_data) != ENUM_CDT_BOOL) {
+            MO_DBG_ERR("type err");
+            return false;
+        }
+        #endif
+        return config->get_bool(config->user_data);
+    }
+
+    const char *getString() override {
+        #if MO_CONFIG_TYPECHECK
+        if (config->get_type(config->user_data) != ENUM_CDT_STRING) {
+            MO_DBG_ERR("type err");
+            return "";
+        }
+        #endif
+        return config->get_string(config->user_data);
+    }
+
+    TConfig getType() override {
+        TConfig res = TConfig::Int;
+        switch (config->get_type(config->user_data)) {
+            case ENUM_CDT_INT:
+                res = TConfig::Int;
+                break;
+            case ENUM_CDT_BOOL:
+                res = TConfig::Bool;
+                break;
+            case ENUM_CDT_STRING:
+                res = TConfig::String;
+                break;
+            default:
+                MO_DBG_ERR("type conversion");
+                break;
+        }
+
+        return res;
+    }
+
+    uint16_t getValueRevision() override {
+        return config->get_write_count(config->user_data);
+    }
+
+    ocpp_configuration *getConfiguration() {
+        return config;
+    }
+};
+
+class ConfigurationContainerC : public ConfigurationContainer {
+private:
+    ocpp_configuration_container *container;
+public:
+    ConfigurationContainerC(ocpp_configuration_container *container, const char *filename, bool accessible) :
+            ConfigurationContainer(filename, accessible), container(container) {
+
+    }
+
+    bool load() override {
+        return container->load(container->user_data);
+    }
+
+    bool save() override {
+        return container->save(container->user_data);
+    }
+
+    std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) override {
+        ocpp_config_datatype dt;
+        switch (type) {
+            case TConfig::Int:
+                dt = ENUM_CDT_INT;
+                break;
+            case TConfig::Bool:
+                dt = ENUM_CDT_BOOL;
+                break;
+            case TConfig::String:
+                dt = ENUM_CDT_STRING;
+                break;
+            default:
+                MO_DBG_ERR("internal error");
+                return nullptr;
+        }
+        ocpp_configuration *config = container->create_configuration(container->user_data, dt, key);
+
+        if (config) {
+            return std::make_shared<ConfigurationC>(config);
+        } else {
+            MO_DBG_ERR("could not create config: %s", key);
+            return nullptr;
+        }
+    }
+
+    void remove(Configuration *config) override {
+        container->remove(container->user_data, config->getKey());
+    }
+
+    size_t size() override {
+        return container->size(container->user_data);
+    }
+
+    Configuration *getConfiguration(size_t i) override {
+        auto config = container->get_configuration(container->user_data, i);
+        if (config) {
+            return static_cast<Configuration*>(config->mo_data);
+        } else {
+            return nullptr;
+        }
+    }
+
+    std::shared_ptr<Configuration> getConfiguration(const char *key) override {
+        ocpp_configuration *config = container->get_configuration_by_key(container->user_data, key);
+        if (config) {
+            return std::make_shared<ConfigurationC>(config);
+        } else {
+            return nullptr;
+        }
+    }
+
+    void loadStaticKey(Configuration& config, const char *key) override {
+        if (container->load_static_key) {
+            container->load_static_key(container->user_data, key);
+        }
+    }
+};
+
+void ocpp_configuration_container_add(ocpp_configuration_container *container, const char *container_path, bool accessible) {
+    addConfigurationContainer(std::make_shared<ConfigurationContainerC>(container, container_path, accessible));
+}
diff --git a/src/MicroOcpp/Core/Configuration_c.h b/src/MicroOcpp/Core/Configuration_c.h
new file mode 100644
index 00000000..8dd47ad1
--- /dev/null
+++ b/src/MicroOcpp/Core/Configuration_c.h
@@ -0,0 +1,71 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_CONFIGURATION_C_H
+#define MO_CONFIGURATION_C_H
+
+#include <stddef.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef enum ocpp_config_datatype {
+    ENUM_CDT_INT,
+    ENUM_CDT_BOOL,
+    ENUM_CDT_STRING
+} ocpp_config_datatype;
+
+typedef struct ocpp_configuration {
+    void *user_data; // Set this at your choice. MO passes it back to the functions below
+
+    bool (*set_key) (void *user_data, const char *key); // Optional. MO may provide a static key value which you can use to replace a possibly malloc'd key buffer
+    const char* (*get_key) (void *user_data); // Return Configuration key
+
+    ocpp_config_datatype (*get_type) (void *user_data); // Return internal data type of config (determines which of the following getX()/setX() pairs are valid)
+
+    // Set value of Config
+    union {
+        void (*set_int) (void *user_data, int val);
+        void (*set_bool) (void *user_data, bool val);
+        bool (*set_string) (void *user_data, const char *val);
+    };
+
+    // Get value of Config
+    union {
+        int (*get_int) (void *user_data);
+        bool (*get_bool) (void *user_data);
+        const char* (*get_string) (void *user_data);
+    };
+
+    uint16_t (*get_write_count) (void *user_data); // Return number of changes of the value. MO uses this to detect if the firmware has updated the config
+
+    void *mo_data; // Reserved for MO
+} ocpp_configuration;
+
+typedef struct ocpp_configuration_container {
+    void *user_data; //set this at your choice. MO passes it back to the functions below
+
+    bool (*load) (void *user_data); // Called after declaring Configurations, to load them with their values
+    bool (*save) (void *user_data); // Commit all Configurations to memory
+
+    ocpp_configuration* (*create_configuration) (void *user_data, ocpp_config_datatype dt, const char *key); // Called to get a reference to a Configuration managed by this container (create new or return existing)
+    void (*remove) (void *user_data, const char *key); // Remove this config from the container. Do not free the config here, the config must outlive the MO lifecycle
+
+    size_t (*size) (void *user_data); // Number of Configurations currently managed by this container
+    ocpp_configuration* (*get_configuration) (void *user_data, size_t i); // Return config at container position i
+    ocpp_configuration* (*get_configuration_by_key) (void *user_data, const char *key); // Return config for given key
+
+    void (*load_static_key) (void *user_data, const char *key); // Optional. MO may provide a static key value which you can use to replace a possibly malloc'd key buffer
+} ocpp_configuration_container;
+
+// Add custom Configuration container. Add one container per container_path before mocpp_initialize(...)
+void ocpp_configuration_container_add(ocpp_configuration_container *container, const char *container_path, bool accessible);
+
+#ifdef __cplusplus
+} // extern "C"
+#endif
+
+#endif
diff --git a/tests/Configuration.cpp b/tests/Configuration.cpp
index 5349e5a3..b4dda74c 100644
--- a/tests/Configuration.cpp
+++ b/tests/Configuration.cpp
@@ -1,3 +1,9 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <string.h>
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"
@@ -8,6 +14,7 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/ConfigurationContainer.h>
 #include <MicroOcpp/Core/ConfigurationContainerFlash.h>
+#include <MicroOcpp/Core/Configuration_c.h>
 
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
@@ -21,6 +28,12 @@ using namespace MicroOcpp;
 #define UNKOWN_KEY "__UnknownKey"
 #define GET_CONFIG_KNOWN_UNKOWN "[2,\"test-mst\",\"GetConfiguration\",{\"key\":[\"" KNOWN_KEY "\",\"" UNKOWN_KEY "\"]}]"
 
+// some globals for the C-API tests
+bool g_checkProcessed [10];
+ocpp_configuration g_configs [2];
+int g_config_values [2];
+uint16_t g_config_write_count[2];
+
 TEST_CASE( "Configuration" ) {
     printf("\nRun %s\n",  "Configuration");
 
@@ -506,4 +519,91 @@ TEST_CASE( "Configuration" ) {
 
     }
 
+    SECTION("C-API") {
+        ocpp_configuration_container container;
+        memset(&container, 0, sizeof(container));
+
+        bool check_load = false;
+
+        container.load = [] (void *user_data) {
+            g_checkProcessed[0] = true;
+            return true;
+        };
+
+        container.save = [] (void *user_data) {
+            g_checkProcessed[1] = true;
+            return true;
+        };
+
+        ocpp_configuration *config_predefined = &g_configs[0];
+        config_predefined->get_key = [] (void *user_data) -> const char* {return "ConnectionTimeOut";}; // existing OCPP key to use custom config store
+        config_predefined->get_type = [] (void *user_data) -> ocpp_config_datatype {return ENUM_CDT_INT;};
+        config_predefined->set_int = [] (void *user_data, int val) -> void {g_config_values[0] = val;};
+        config_predefined->get_int = [] (void *user_data) -> int {return g_config_values[0];};
+        config_predefined->get_write_count = [] (void *user_data) -> uint16_t {return g_config_write_count[0];};
+
+        container.create_configuration = [] (void *user_data, ocpp_config_datatype dt, const char *key) -> ocpp_configuration* {
+            ocpp_configuration *config_created = &g_configs[1];
+            config_created->get_key = [] (void *user_data) -> const char* {return "MCreatedConfig";}; // non-existing key to test create_configuration function
+            config_created->get_type = [] (void *user_data) -> ocpp_config_datatype {return ENUM_CDT_INT;};
+            config_created->set_int = [] (void *user_data, int val) -> void {g_config_values[1] = val;};
+            config_created->get_int = [] (void *user_data) -> int {return g_config_values[1];};
+            config_created->get_write_count = [] (void *user_data) -> uint16_t {return g_config_write_count[1];};
+            return config_created;
+        };
+
+        container.remove = [] (void *user_data, const char *key) -> void {
+            g_checkProcessed[2] = true;
+        };
+
+        container.size = [] (void *user_data) {
+            return sizeof(g_configs) / sizeof(g_configs[0]);
+        };
+
+        container.get_configuration = [] (void *user_data, size_t i) -> ocpp_configuration* {
+            return &g_configs[i];
+        };
+
+        container.get_configuration_by_key = [] (void *user_data, const char *key) -> ocpp_configuration* {
+            if (!strcmp(key, "ConnectionTimeOut")) {
+                return &g_configs[0];
+            } else if (!strcmp(key, "MCreatedConfig")) {
+                return g_configs[1].get_key ? 
+                    &g_configs[1] : // createConfig has already been called
+                    nullptr; // config hasn't been created yet
+            }
+            return nullptr;
+        };
+
+        ocpp_configuration_container_add(&container, "MContainerPath", true);
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        loop();
+
+        REQUIRE( g_checkProcessed[0] );
+
+        auto test_predefined = declareConfiguration<int>("ConnectionTimeOut", 0);
+
+        test_predefined->setInt(12345);
+        REQUIRE( test_predefined->getInt() == 12345 );
+        REQUIRE( config_predefined->get_int(config_predefined->user_data) == 12345 );
+
+        g_checkProcessed[1] = false; // check if store is executed
+        test_predefined->setInt(555);
+        g_config_write_count[0];
+
+        configuration_save();
+
+        REQUIRE( g_checkProcessed[1] );
+
+        // test if declaring new configs is handled
+        auto test_created = declareConfiguration<int>("MCreatedConfig", 123, "MContainerPath");
+        REQUIRE( test_created != nullptr );
+        REQUIRE( test_created->getInt() == 123 );
+        ocpp_configuration *config_created = &g_configs[1];
+        REQUIRE( config_created->get_int(config_created->user_data) == 123 );
+
+        mocpp_deinitialize();
+    }
+
 }

From 94eb0eb9a6c4d8a1792f96a3a2481f19ad81b776 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 18 May 2024 19:01:11 +0200
Subject: [PATCH 479/549] update / fix MeterValues format (#301)

* fix whitespaces in MeterValues

* change EnergyMeterInput data type to int
---
 CHANGELOG.md                                  |  2 ++
 src/MicroOcpp.cpp                             |  6 +++---
 src/MicroOcpp.h                               |  4 ++--
 src/MicroOcpp/Model/Metering/SampledValue.cpp | 13 ++++++++++++-
 src/MicroOcpp/Model/Metering/SampledValue.h   |  8 ++------
 src/MicroOcpp/Platform.cpp                    | 10 +---------
 src/MicroOcpp/Platform.h                      |  4 ----
 tests/Metering.cpp                            |  3 +--
 8 files changed, 23 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 138fd6de..8bb3d331 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,7 @@
 - Rename master branch into main
 - Tx logic directly checks if WebSocket is offline ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
 - `ocppPermitsCharge` ignores Faulted state ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
+- `setEnergyMeterInput` expects `int` input ([#301](https://github.com/matth-x/MicroOcpp/pull/301))
 
 ### Added
 
@@ -40,6 +41,7 @@
 - Fix compilation error caused by `PRId32` ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
 - Don't load FW-mngt. module when no handlers set ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
 - Avoid creating conf when operation fails ([#290](https://github.com/matth-x/MicroOcpp/pull/290))
+- Fix whitespaces in MeterValues ([#301](https://github.com/matth-x/MicroOcpp/pull/301))
 
 ## [1.0.3] - 2024-04-06
 
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index ca29b41f..3dd8312d 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -563,7 +563,7 @@ void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int c
     connector->setConnectorPluggedInput(pluggedInput);
 }
 
-void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connectorId) {
+void setEnergyMeterInput(std::function<int()> energyInput, unsigned int connectorId) {
     if (!context) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
@@ -576,8 +576,8 @@ void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connec
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Energy.Active.Import.Register");
     meterProperties.setUnit("Wh");
-    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<float, SampledValueDeSerializer<float>>>(
-                           new SampledValueSamplerConcrete<float, SampledValueDeSerializer<float>>(
+    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int, SampledValueDeSerializer<int>>>(
+                           new SampledValueSamplerConcrete<int, SampledValueDeSerializer<int>>(
             meterProperties,
             [energyInput] (ReadingContext) {return energyInput();}
     ));
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 5309767f..6b9faefc 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -266,9 +266,9 @@ bool ocppPermitsCharge(unsigned int connectorId = 1);
 
 void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int connectorId = 1); //Input about if an EV is plugged to this EVSE
 
-void setEnergyMeterInput(std::function<float()> energyInput, unsigned int connectorId = 1); //Input of the electricity meter register
+void setEnergyMeterInput(std::function<int()> energyInput, unsigned int connectorId = 1); //Input of the electricity meter register in Wh
 
-void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId = 1); //Input of the power meter reading
+void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId = 1); //Input of the power meter reading in W
 
 //Smart Charging Output, alternative for Watts only, Current only, or Watts x Current x numberPhases. Only one
 //of them can be set at a time
diff --git a/src/MicroOcpp/Model/Metering/SampledValue.cpp b/src/MicroOcpp/Model/Metering/SampledValue.cpp
index c08ce851..be7cfedf 100644
--- a/src/MicroOcpp/Model/Metering/SampledValue.cpp
+++ b/src/MicroOcpp/Model/Metering/SampledValue.cpp
@@ -1,11 +1,15 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Metering/SampledValue.h>
 #include <MicroOcpp/Debug.h>
 #include <cinttypes>
 
+#ifndef MO_SAMPLEDVALUE_FLOAT_FORMAT
+#define MO_SAMPLEDVALUE_FLOAT_FORMAT "%.2f"
+#endif
+
 using namespace MicroOcpp;
 
 int32_t SampledValueDeSerializer<int32_t>::deserialize(const char *str) {
@@ -18,6 +22,13 @@ std::string SampledValueDeSerializer<int32_t>::serialize(int32_t& val) {
     return std::string(str);
 }
 
+std::string SampledValueDeSerializer<float>::serialize(float& val) {
+    char str [20];
+    str[0] = '\0';
+    snprintf(str, 20, MO_SAMPLEDVALUE_FLOAT_FORMAT, val);
+    return std::string(str);
+}
+
 //helper function
 namespace MicroOcpp {
 namespace Ocpp16 {
diff --git a/src/MicroOcpp/Model/Metering/SampledValue.h b/src/MicroOcpp/Model/Metering/SampledValue.h
index 5f12b4b8..a75963a5 100644
--- a/src/MicroOcpp/Model/Metering/SampledValue.h
+++ b/src/MicroOcpp/Model/Metering/SampledValue.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef SAMPLEDVALUE_H
@@ -36,11 +36,7 @@ class SampledValueDeSerializer<float> { // Used in meterValues
 public:
     static float deserialize(const char *str) {return atof(str);}
     static bool ready(float& val) {return true;} //float is always valid
-    static std::string serialize(float& val) {
-        char str[20];
-        dtostrf(val,4,1,str);
-        return std::string(str);
-    }
+    static std::string serialize(float& val);
     static int32_t toInteger(float& val) {return (int32_t) val;}
 };
 
diff --git a/src/MicroOcpp/Platform.cpp b/src/MicroOcpp/Platform.cpp
index 9430488b..c05ac8e0 100644
--- a/src/MicroOcpp/Platform.cpp
+++ b/src/MicroOcpp/Platform.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Platform.h>
@@ -80,11 +80,3 @@ unsigned long mocpp_tick_ms_unix() {
 }
 #endif
 #endif
-
-#if MO_PLATFORM != MO_PLATFORM_ARDUINO
-void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target){
-    char fmt[20];
-    sprintf(fmt, "%%%d.%df", min_width, num_digits_after_decimal);
-    sprintf(target, fmt, value);
-}
-#endif
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index 30a4c272..eb0c5a2b 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -102,10 +102,6 @@ unsigned long mocpp_tick_ms_unix();
 #endif
 #endif
 
-#if MO_PLATFORM != MO_PLATFORM_ARDUINO
-void dtostrf(float value, int min_width, int num_digits_after_decimal, char *target);
-#endif
-
 #ifndef MO_ENABLE_MBEDTLS
 #define MO_ENABLE_MBEDTLS 0
 #endif
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 9b5b31d1..2cd1e01f 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -289,8 +289,7 @@ TEST_CASE("Metering") {
 
         setOnReceiveRequest("MeterValues", [base, &checkProcessed] (JsonObject payload) {
             checkProcessed = true;
-            REQUIRE((!strcmp(payload["meterValue"][0]["sampledValue"][0]["value"] | "", "3600") ||
-                     !strcmp(payload["meterValue"][0]["sampledValue"][0]["value"] | "", "3600.0")));
+            REQUIRE( !strncmp(payload["meterValue"][0]["sampledValue"][0]["value"] | "", "3600", strlen("3600")) );
         });
 
         loop();

From c0732dccacd13a7b2a091272b0eaf92be26a5c30 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 18 May 2024 19:53:50 +0200
Subject: [PATCH 480/549] fix arduinoWebSockets HTTP path (#283)

* use WS path instead of URL (#278)

* update arduinoWebSockets integration
---
 CHANGELOG.md                      |  1 +
 src/MicroOcpp.cpp                 | 28 +++++++++++++++-------------
 src/MicroOcpp/Core/Connection.cpp |  6 +++++-
 src/MicroOcpp/Core/Connection.h   |  2 ++
 4 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8bb3d331..829d8a0d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -40,6 +40,7 @@
 - Fix transaction freeze in offline mode ([#279](https://github.com/matth-x/MicroOcpp/pull/279), [#287](https://github.com/matth-x/MicroOcpp/pull/287))
 - Fix compilation error caused by `PRId32` ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
 - Don't load FW-mngt. module when no handlers set ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
+- Change arduinoWebSockets URL param to path ([#278](https://github.com/matth-x/MicroOcpp/issues/278))
 - Avoid creating conf when operation fails ([#290](https://github.com/matth-x/MicroOcpp/pull/290))
 - Fix whitespaces in MeterValues ([#301](https://github.com/matth-x/MicroOcpp/pull/301))
 
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 3dd8312d..3da86414 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -97,6 +97,7 @@ void mocpp_initialize(const char *backendUrl, const char *chargeBoxId, const cha
     //parse host, port
     std::string host_port_path = url.substr(url.find_first_of("://") + strlen("://"));
     std::string host_port = host_port_path.substr(0, host_port_path.find_first_of('/'));
+    std::string path = host_port_path.substr(host_port.length());
     std::string host = host_port.substr(0, host_port.find_first_of(':'));
     if (host.empty()) {
         MO_DBG_ERR("could not parse host: %s", url.c_str());
@@ -123,28 +124,29 @@ void mocpp_initialize(const char *backendUrl, const char *chargeBoxId, const cha
         }
     }
 
+    if (path.empty()) {
+        path = "/";
+    }
+
     if ((!*chargeBoxId) == '\0') {
-        if (url.back() != '/') {
-            url += '/';
+        if (path.back() != '/') {
+            path += '/';
         }
 
-        url += chargeBoxId;
+        path += chargeBoxId;
     }
 
-    MO_DBG_INFO("connecting to %s -- (host: %s, port: %u)", url.c_str(), host.c_str(), port);
+    MO_DBG_INFO("connecting to %s -- (host: %s, port: %u, path: %s)", url.c_str(), host.c_str(), port, path.c_str());
 
     if (!webSocket)
         webSocket = new WebSocketsClient();
 
-    if (isTLS)
-    {
-        // server address, port, URL and TLS certificate
-        webSocket->beginSslWithCA(host.c_str(), port, url.c_str(), CA_cert, "ocpp1.6");
-    }
-    else
-    {
-        // server address, port, URL
-        webSocket->begin(host.c_str(), port, url.c_str(), "ocpp1.6");
+    if (isTLS) {
+        // server address, port, path and TLS certificate
+        webSocket->beginSslWithCA(host.c_str(), port, path.c_str(), CA_cert, "ocpp1.6");
+    } else {
+        // server address, port, path
+        webSocket->begin(host.c_str(), port, path.c_str(), "ocpp1.6");
     }
 
     // try ever 5000 again if connection has failed
diff --git a/src/MicroOcpp/Core/Connection.cpp b/src/MicroOcpp/Core/Connection.cpp
index 96305183..21164e4b 100644
--- a/src/MicroOcpp/Core/Connection.cpp
+++ b/src/MicroOcpp/Core/Connection.cpp
@@ -72,7 +72,7 @@ void WSClient::setReceiveTXTcallback(ReceiveTXTcallback &callback) {
                 MO_DBG_INFO("Disconnected");
                 break;
             case WStype_CONNECTED:
-                MO_DBG_INFO("Connected to url: %s", payload);
+                MO_DBG_INFO("Connected (path: %s)", payload);
                 captureLastRecv = mocpp_tick_ms();
                 captureLastConnected = mocpp_tick_ms();
                 break;
@@ -112,4 +112,8 @@ unsigned long WSClient::getLastConnected() {
     return lastConnected;
 }
 
+bool WSClient::isConnected() {
+    return wsock->isConnected();
+}
+
 #endif
diff --git a/src/MicroOcpp/Core/Connection.h b/src/MicroOcpp/Core/Connection.h
index 141159e3..f1df512f 100644
--- a/src/MicroOcpp/Core/Connection.h
+++ b/src/MicroOcpp/Core/Connection.h
@@ -118,6 +118,8 @@ class WSClient : public Connection {
     unsigned long getLastRecv() override; //get time of last successful receive in millis
 
     unsigned long getLastConnected() override; //get last connection creation in millis
+
+    bool isConnected() override;
 };
 
 } //end namespace EspWiFi

From b5d059fa28b81432fc871b7cd06f2e79887093af Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 18 May 2024 20:31:26 +0200
Subject: [PATCH 481/549] allow custom MO_MAX_STOPTXDATA_LEN (addresses #299)

---
 src/MicroOcpp/Model/Metering/MeterStore.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Model/Metering/MeterStore.cpp b/src/MicroOcpp/Model/Metering/MeterStore.cpp
index 324fbbe2..7c27308f 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterStore.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Metering/MeterStore.h>
@@ -9,7 +9,9 @@
 
 #include <algorithm>
 
+#ifndef MO_MAX_STOPTXDATA_LEN
 #define MO_MAX_STOPTXDATA_LEN 4
+#endif
 
 using namespace MicroOcpp;
 

From cad22dacc86a26c2383743d084628d04b8a86939 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 18 May 2024 22:12:46 +0200
Subject: [PATCH 482/549] add build flag MO_ENABLE_V16_RESERVATION (#302)

* add build flag MO_ENABLE_V16_RESERVATION

* update changelog

* fix compilation error
---
 CHANGELOG.md                                  |  1 +
 src/MicroOcpp.cpp                             |  3 ++
 .../Model/ConnectorBase/Connector.cpp         | 35 ++++++++++++-------
 src/MicroOcpp/Model/Model.cpp                 | 20 +++++++----
 src/MicroOcpp/Model/Model.h                   | 12 +++++--
 .../Model/Reservation/Reservation.cpp         |  8 ++++-
 src/MicroOcpp/Model/Reservation/Reservation.h | 11 ++++--
 .../Model/Reservation/ReservationService.cpp  | 12 +++++--
 .../Model/Reservation/ReservationService.h    | 11 ++++--
 .../Operations/CancelReservation.cpp          | 21 +++++------
 src/MicroOcpp/Operations/CancelReservation.h  | 17 +++++----
 src/MicroOcpp/Operations/ReserveNow.cpp       |  6 ++++
 src/MicroOcpp/Operations/ReserveNow.h         | 11 ++++--
 src/MicroOcpp/Version.h                       |  5 +++
 tests/Reservation.cpp                         |  4 +++
 15 files changed, 127 insertions(+), 50 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 829d8a0d..d0b0c891 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,7 @@
 
 - File index ([#270](https://github.com/matth-x/MicroOcpp/pull/270))
 - Config `Cst_TxStartOnPowerPathClosed` to put back TxStartPoint ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
+- Build flag `MO_ENABLE_V16_RESERVATION=0` disables Reservation module ([#302](https://github.com/matth-x/MicroOcpp/pull/302))
 - Function `bool isConnected()` in `Connection` interface ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
 - Build flags for customizing memory limits of SmartCharging ([#260](https://github.com/matth-x/MicroOcpp/pull/260))
 - SConscript ([#287](https://github.com/matth-x/MicroOcpp/pull/287))
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 3da86414..34921786 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -289,8 +289,11 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new HeartbeatService(*context)));
     model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
         new AuthorizationService(*context, filesystem)));
+
+#if MO_ENABLE_V16_RESERVATION
     model.setReservationService(std::unique_ptr<ReservationService>(
         new ReservationService(*context, MO_NUMCONNECTORS)));
+#endif
 
 #if MO_ENABLE_V201
     model.setVariableService(std::unique_ptr<VariableService>(
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 1f7564db..a33ddbad 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -112,9 +112,13 @@ ChargePointStatus Connector::getStatus() {
         } else {
             res = ChargePointStatus::Charging;
         }
-    } else if (model.getReservationService() && model.getReservationService()->getReservation(connectorId)) {
+    }
+    #if MO_ENABLE_V16_RESERVATION
+    else if (model.getReservationService() && model.getReservationService()->getReservation(connectorId)) {
         res = ChargePointStatus::Reserved;
-    } else if ((!transaction || !transaction->isActive()) &&                 //no transaction preparation
+    }
+    #endif 
+    else if ((!transaction || !transaction->isActive()) &&                 //no transaction preparation
                (!connectorPluggedInput || !connectorPluggedInput()) &&   //no vehicle plugged
                (!occupiedInput || !occupiedInput())) {                       //occupied override clear
         res = ChargePointStatus::Available;
@@ -609,17 +613,22 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         }
     }
 
-    Reservation *reservation = nullptr;
+    int reservationId = -1;
     bool offlineBlockedResv = false; //if offline authorization will be blocked by reservation
 
+    #if MO_ENABLE_V16_RESERVATION
     //check if blocked by reservation
     if (model.getReservationService()) {
         const char *parentIdTag = localAuth ? localAuth->getParentIdTag() : nullptr;
 
-        reservation = model.getReservationService()->getReservation(
+        auto reservation = model.getReservationService()->getReservation(
                 connectorId,
                 idTag,
                 parentIdTag);
+        
+        if (reservation) {
+            reservationId = reservation->getReservationId();
+        }
 
         if (reservation && !reservation->matches(
                     idTag,
@@ -640,6 +649,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             }
         }
     }
+    #endif //MO_ENABLE_V16_RESERVATION
     
     transaction = allocateTransaction();
 
@@ -661,8 +671,8 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     if (localAuth && localPreAuthorizeBool && localPreAuthorizeBool->getBool()) {
         MO_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
 
-        if (reservation) {
-            transaction->setReservationId(reservation->getReservationId());
+        if (reservationId >= 0) {
+            transaction->setReservationId(reservationId);
         }
         transaction->setAuthorized();
 
@@ -692,6 +702,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             return;
         }
 
+        #if MO_ENABLE_V16_RESERVATION
         if (model.getReservationService()) {
             auto reservation = model.getReservationService()->getReservation(
                         connectorId,
@@ -714,6 +725,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                 }
             }
         }
+        #endif //MO_ENABLE_V16_RESERVATION
 
         MO_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
         tx->setAuthorized();
@@ -724,13 +736,10 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     //capture local auth and reservation check in for timeout handler
     bool localAuthFound = localAuth;
-    bool reservationFound = reservation;
-    int reservationId = reservation ? reservation->getReservationId() : -1;
     authorize->setOnTimeoutListener([this, tx,
                 offlineBlockedAuth, 
                 offlineBlockedResv, 
                 localAuthFound,
-                reservationFound,
                 reservationId] () {
 
         if (offlineBlockedAuth) {
@@ -753,7 +762,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         if (localAuthFound && localAuthorizeOfflineBool && localAuthorizeOfflineBool->getBool()) {
             MO_DBG_DEBUG("Offline transaction process (%s), locally authorized", tx->getIdTag());
-            if (reservationFound) {
+            if (reservationId >= 0) {
                 tx->setReservationId(reservationId);
             }
             tx->setAuthorized();
@@ -765,7 +774,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
         if (allowOfflineTxForUnknownIdBool && allowOfflineTxForUnknownIdBool->getBool()) {
             MO_DBG_DEBUG("Offline transaction process (%s), allow unknown ID", tx->getIdTag());
-            if (reservationFound) {
+            if (reservationId >= 0) {
                 tx->setReservationId(reservationId);
             }
             tx->setAuthorized();
@@ -811,7 +820,8 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
     MO_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
 
     transaction->setAuthorized();
-    
+
+    #if MO_ENABLE_V16_RESERVATION
     if (model.getReservationService()) {
         if (auto reservation = model.getReservationService()->getReservation(connectorId, idTag, parentIdTag)) {
             if (reservation->matches(idTag, parentIdTag)) {
@@ -819,6 +829,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
             }
         }
     }
+    #endif //MO_ENABLE_V16_RESERVATION
 
     transaction->commit();
 
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 009ea0d4..7b6c1126 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -54,25 +54,27 @@ void Model::loop() {
 
     if (chargeControlCommon)
         chargeControlCommon->loop();
-    
+
     if (smartChargingService)
         smartChargingService->loop();
-    
+
     if (heartbeatService)
         heartbeatService->loop();
-    
+
     if (meteringService)
         meteringService->loop();
-    
+
     if (diagnosticsService)
         diagnosticsService->loop();
-    
+
     if (firmwareService)
         firmwareService->loop();
-    
+
+#if MO_ENABLE_V16_RESERVATION
     if (reservationService)
         reservationService->loop();
-    
+#endif //MO_ENABLE_V16_RESERVATION
+
     if (resetService)
         resetService->loop();
 
@@ -171,6 +173,7 @@ AuthorizationService *Model::getAuthorizationService() {
     return authorizationService.get();
 }
 
+#if MO_ENABLE_V16_RESERVATION
 void Model::setReservationService(std::unique_ptr<ReservationService> rs) {
     reservationService = std::move(rs);
     capabilitiesUpdated = true;
@@ -179,6 +182,7 @@ void Model::setReservationService(std::unique_ptr<ReservationService> rs) {
 ReservationService *Model::getReservationService() {
     return reservationService.get();
 }
+#endif //MO_ENABLE_V16_RESERVATION
 
 void Model::setBootService(std::unique_ptr<BootService> bs){
     bootService = std::move(bs);
@@ -286,12 +290,14 @@ void Model::updateSupportedStandardProfiles() {
         }
     }
 
+#if MO_ENABLE_V16_RESERVATION
     if (reservationService) {
         if (!strstr(supportedFeatureProfilesString->getString(), "Reservation")) {
             if (!buf.empty()) buf += ',';
             buf += "Reservation";
         }
     }
+#endif //MO_ENABLE_V16_RESERVATION
 
     if (smartChargingService) {
         if (!strstr(supportedFeatureProfilesString->getString(), "SmartCharging")) {
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 7a2c3500..5b98fd8a 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -21,10 +21,13 @@ class FirmwareService;
 class DiagnosticsService;
 class HeartbeatService;
 class AuthorizationService;
-class ReservationService;
 class BootService;
 class ResetService;
 
+#if MO_ENABLE_V16_RESERVATION
+class ReservationService;
+#endif //MO_ENABLE_V16_RESERVATION
+
 #if MO_ENABLE_CERT_MGMT
 class CertificateService;
 #endif //MO_ENABLE_CERT_MGMT
@@ -49,10 +52,13 @@ class Model {
     std::unique_ptr<DiagnosticsService> diagnosticsService;
     std::unique_ptr<HeartbeatService> heartbeatService;
     std::unique_ptr<AuthorizationService> authorizationService;
-    std::unique_ptr<ReservationService> reservationService;
     std::unique_ptr<BootService> bootService;
     std::unique_ptr<ResetService> resetService;
 
+#if MO_ENABLE_V16_RESERVATION
+    std::unique_ptr<ReservationService> reservationService;
+#endif //MO_ENABLE_V16_RESERVATION
+
 #if MO_ENABLE_CERT_MGMT
     std::unique_ptr<CertificateService> certService;
 #endif //MO_ENABLE_CERT_MGMT
@@ -110,8 +116,10 @@ class Model {
     void setAuthorizationService(std::unique_ptr<AuthorizationService> authorizationService);
     AuthorizationService *getAuthorizationService();
 
+#if MO_ENABLE_V16_RESERVATION
     void setReservationService(std::unique_ptr<ReservationService> reservationService);
     ReservationService *getReservationService();
+#endif //MO_ENABLE_V16_RESERVATION
 
     void setBootService(std::unique_ptr<BootService> bs);
     BootService *getBootService() const;
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
index 302ac8cb..78c40b60 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.cpp
+++ b/src/MicroOcpp/Model/Reservation/Reservation.cpp
@@ -1,7 +1,11 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V16_RESERVATION
+
 #include <MicroOcpp/Model/Reservation/Reservation.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Debug.h>
@@ -130,3 +134,5 @@ void Reservation::clear() {
 
     configuration_save();
 }
+
+#endif //MO_ENABLE_V16_RESERVATION
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.h b/src/MicroOcpp/Model/Reservation/Reservation.h
index 6722df1b..9747d74e 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.h
+++ b/src/MicroOcpp/Model/Reservation/Reservation.h
@@ -1,9 +1,13 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef RESERVATION_H
-#define RESERVATION_H
+#ifndef MO_RESERVATION_H
+#define MO_RESERVATION_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V16_RESERVATION
 
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/Time.h>
@@ -65,4 +69,5 @@ class Reservation {
 
 }
 
+#endif //MO_ENABLE_V16_RESERVATION
 #endif
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index 63782cda..41c185de 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -1,7 +1,11 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V16_RESERVATION
+
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
@@ -24,8 +28,8 @@ ReservationService::ReservationService(Context& context, unsigned int numConnect
 
     reserveConnectorZeroSupportedBool = declareConfiguration<bool>("ReserveConnectorZeroSupported", true, CONFIGURATION_VOLATILE, true);
     
-    context.getOperationRegistry().registerOperation("CancelReservation", [&context] () {
-        return new Ocpp16::CancelReservation(context.getModel());});
+    context.getOperationRegistry().registerOperation("CancelReservation", [this] () {
+        return new Ocpp16::CancelReservation(*this);});
     context.getOperationRegistry().registerOperation("ReserveNow", [&context] () {
         return new Ocpp16::ReserveNow(context.getModel());});
 }
@@ -210,3 +214,5 @@ bool ReservationService::updateReservation(int reservationId, unsigned int conne
     MO_DBG_ERR("error finding blocking reservation");
     return false;
 }
+
+#endif //MO_ENABLE_V16_RESERVATION
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.h b/src/MicroOcpp/Model/Reservation/ReservationService.h
index 87a6a486..d33d4246 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.h
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.h
@@ -1,9 +1,13 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef RESERVATIONSERVICE_H
-#define RESERVATIONSERVICE_H
+#ifndef MO_RESERVATIONSERVICE_H
+#define MO_RESERVATIONSERVICE_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V16_RESERVATION
 
 #include <MicroOcpp/Model/Reservation/Reservation.h>
 
@@ -44,4 +48,5 @@ class ReservationService {
 
 }
 
+#endif //MO_ENABLE_V16_RESERVATION
 #endif
diff --git a/src/MicroOcpp/Operations/CancelReservation.cpp b/src/MicroOcpp/Operations/CancelReservation.cpp
index 25088fe7..4b1929e0 100644
--- a/src/MicroOcpp/Operations/CancelReservation.cpp
+++ b/src/MicroOcpp/Operations/CancelReservation.cpp
@@ -1,15 +1,18 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V16_RESERVATION
+
 #include <MicroOcpp/Operations/CancelReservation.h>
-#include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::CancelReservation;
 
-CancelReservation::CancelReservation(Model& model) : model(model) {
+CancelReservation::CancelReservation(ReservationService& reservationService) : reservationService(reservationService) {
   
 }
 
@@ -23,13 +26,9 @@ void CancelReservation::processReq(JsonObject payload) {
         return;
     }
 
-    if (model.getReservationService()) {
-        if (auto reservation = model.getReservationService()->getReservationById(payload["reservationId"])) {
-            found = true;
-            reservation->clear();
-        }
-    } else {
-        errorCode = "InternalError";
+    if (auto reservation = reservationService.getReservationById(payload["reservationId"])) {
+        found = true;
+        reservation->clear();
     }
 }
 
@@ -43,3 +42,5 @@ std::unique_ptr<DynamicJsonDocument> CancelReservation::createConf(){
     }
     return doc;
 }
+
+#endif //MO_ENABLE_V16_RESERVATION
diff --git a/src/MicroOcpp/Operations/CancelReservation.h b/src/MicroOcpp/Operations/CancelReservation.h
index b268a8fd..3b0312c4 100644
--- a/src/MicroOcpp/Operations/CancelReservation.h
+++ b/src/MicroOcpp/Operations/CancelReservation.h
@@ -1,25 +1,29 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CANCELRESERVATION_H
-#define CANCELRESERVATION_H
+#ifndef MO_CANCELRESERVATION_H
+#define MO_CANCELRESERVATION_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V16_RESERVATION
 
 #include <MicroOcpp/Core/Operation.h>
 
 namespace MicroOcpp {
 
-class Model;
+class ReservationService;
 
 namespace Ocpp16 {
 
 class CancelReservation : public Operation {
 private:
-    Model& model;
+    ReservationService& reservationService;
     bool found = false;
     const char *errorCode = nullptr;
 public:
-    CancelReservation(Model& model);
+    CancelReservation(ReservationService& reservationService);
 
     const char* getOperationType() override;
 
@@ -33,4 +37,5 @@ class CancelReservation : public Operation {
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
 
+#endif //MO_ENABLE_V16_RESERVATION
 #endif
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index 432a6423..7e3a2c0e 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -2,6 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V16_RESERVATION
+
 #include <MicroOcpp/Operations/ReserveNow.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
@@ -123,3 +127,5 @@ std::unique_ptr<DynamicJsonDocument> ReserveNow::createConf(){
     
     return doc;
 }
+
+#endif //MO_ENABLE_V16_RESERVATION
diff --git a/src/MicroOcpp/Operations/ReserveNow.h b/src/MicroOcpp/Operations/ReserveNow.h
index ddaba236..92cb717d 100644
--- a/src/MicroOcpp/Operations/ReserveNow.h
+++ b/src/MicroOcpp/Operations/ReserveNow.h
@@ -1,9 +1,13 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef RESERVENOW_H
-#define RESERVENOW_H
+#ifndef MO_RESERVENOW_H
+#define MO_RESERVENOW_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V16_RESERVATION
 
 #include <MicroOcpp/Core/Operation.h>
 
@@ -35,4 +39,5 @@ class ReserveNow : public Operation {
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
 
+#endif //MO_ENABLE_V16_RESERVATION
 #endif
diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
index c7ee0d77..896bb8d3 100644
--- a/src/MicroOcpp/Version.h
+++ b/src/MicroOcpp/Version.h
@@ -39,4 +39,9 @@ struct ProtocolVersion {
 #define MO_ENABLE_CERT_MGMT MO_ENABLE_V201
 #endif
 
+// Reservations, OCPP 1.6 implementation
+#ifndef MO_ENABLE_V16_RESERVATION
+#define MO_ENABLE_V16_RESERVATION 1
+#endif
+
 #endif
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index 8b5c5a50..1270b5db 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -12,6 +12,8 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 
+#if MO_ENABLE_V16_RESERVATION
+
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 
@@ -504,3 +506,5 @@ TEST_CASE( "Reservation" ) {
 
     mocpp_deinitialize();
 }
+
+#endif //MO_ENABLE_V16_RESERVATION

From 8fa0258f9b42c019a0a03cc718d6d12b60d250d2 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 19 May 2024 17:49:41 +0200
Subject: [PATCH 483/549] update copyright notice

---
 .github/workflows/documentation.yml                       | 4 ++++
 .github/workflows/esp-idf.yml                             | 4 ++++
 .github/workflows/pio.yml                                 | 4 ++++
 .github/workflows/platformless.yml                        | 4 ++++
 .github/workflows/tests.yml                               | 4 ++++
 LICENSE                                                   | 2 +-
 examples/ESP-TLS/main.cpp                                 | 2 +-
 examples/ESP/main.cpp                                     | 2 +-
 platformio.ini                                            | 2 +-
 src/MicroOcpp/Core/Configuration.cpp                      | 2 +-
 src/MicroOcpp/Core/Configuration.h                        | 6 +++---
 src/MicroOcpp/Core/ConfigurationContainer.cpp             | 2 +-
 src/MicroOcpp/Core/ConfigurationContainer.h               | 6 +++---
 src/MicroOcpp/Core/ConfigurationContainerFlash.cpp        | 2 +-
 src/MicroOcpp/Core/ConfigurationContainerFlash.h          | 6 +++---
 src/MicroOcpp/Core/ConfigurationOptions.h                 | 6 +++---
 src/MicroOcpp/Core/Context.cpp                            | 2 +-
 src/MicroOcpp/Core/FilesystemAdapter.cpp                  | 2 +-
 src/MicroOcpp/Core/FilesystemAdapter.h                    | 2 +-
 src/MicroOcpp/Core/FilesystemUtils.cpp                    | 2 +-
 src/MicroOcpp/Core/FilesystemUtils.h                      | 2 +-
 src/MicroOcpp/Core/OcppError.h                            | 6 +++---
 src/MicroOcpp/Core/Operation.cpp                          | 2 +-
 src/MicroOcpp/Core/Operation.h                            | 2 +-
 src/MicroOcpp/Core/OperationRegistry.cpp                  | 2 +-
 src/MicroOcpp/Core/OperationRegistry.h                    | 2 +-
 src/MicroOcpp/Core/Request.h                              | 2 +-
 src/MicroOcpp/Core/RequestCallbacks.h                     | 2 +-
 src/MicroOcpp/Core/RequestQueue.cpp                       | 2 +-
 src/MicroOcpp/Core/RequestQueue.h                         | 2 +-
 src/MicroOcpp/Core/RequestQueueStorageStrategy.h          | 6 +++---
 src/MicroOcpp/Core/RequestStore.cpp                       | 2 +-
 src/MicroOcpp/Core/RequestStore.h                         | 2 +-
 src/MicroOcpp/Core/SimpleRequestFactory.cpp               | 2 +-
 src/MicroOcpp/Core/SimpleRequestFactory.h                 | 2 +-
 src/MicroOcpp/Core/Time.cpp                               | 2 +-
 src/MicroOcpp/Core/Time.h                                 | 2 +-
 src/MicroOcpp/Model/Authorization/AuthorizationData.cpp   | 2 +-
 src/MicroOcpp/Model/Authorization/AuthorizationData.h     | 6 +++---
 src/MicroOcpp/Model/Authorization/AuthorizationList.cpp   | 2 +-
 src/MicroOcpp/Model/Authorization/AuthorizationList.h     | 6 +++---
 .../Model/Authorization/AuthorizationService.cpp          | 2 +-
 src/MicroOcpp/Model/Authorization/AuthorizationService.h  | 6 +++---
 src/MicroOcpp/Model/Boot/BootService.cpp                  | 2 +-
 src/MicroOcpp/Model/Boot/BootService.h                    | 6 +++---
 src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h  | 2 +-
 src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h      | 6 +++---
 src/MicroOcpp/Model/ConnectorBase/Notification.cpp        | 2 +-
 src/MicroOcpp/Model/ConnectorBase/Notification.h          | 2 +-
 src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h       | 6 +++---
 src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h   | 6 +++---
 src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp        | 2 +-
 src/MicroOcpp/Model/Heartbeat/HeartbeatService.h          | 6 +++---
 src/MicroOcpp/Model/Metering/MeterStore.h                 | 6 +++---
 src/MicroOcpp/Model/Metering/MeterValue.cpp               | 2 +-
 src/MicroOcpp/Model/Metering/MeterValue.h                 | 6 +++---
 src/MicroOcpp/Model/Metering/MeteringConnector.cpp        | 2 +-
 src/MicroOcpp/Model/Metering/MeteringConnector.h          | 6 +++---
 src/MicroOcpp/Model/Metering/MeteringService.cpp          | 2 +-
 src/MicroOcpp/Model/Metering/MeteringService.h            | 6 +++---
 src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp  | 2 +-
 src/MicroOcpp/Model/Transactions/TransactionDeserialize.h | 6 +++---
 src/MicroOcpp/Model/Transactions/TransactionStore.cpp     | 2 +-
 src/MicroOcpp/Model/Transactions/TransactionStore.h       | 6 +++---
 src/MicroOcpp/Operations/BootNotification.h               | 6 +++---
 src/MicroOcpp/Operations/ChangeAvailability.h             | 6 +++---
 src/MicroOcpp/Operations/ChangeConfiguration.cpp          | 2 +-
 src/MicroOcpp/Operations/ChangeConfiguration.h            | 6 +++---
 src/MicroOcpp/Operations/CiStrings.h                      | 6 +++---
 src/MicroOcpp/Operations/ClearCache.cpp                   | 2 +-
 src/MicroOcpp/Operations/ClearCache.h                     | 6 +++---
 src/MicroOcpp/Operations/ClearChargingProfile.cpp         | 2 +-
 src/MicroOcpp/Operations/ClearChargingProfile.h           | 6 +++---
 src/MicroOcpp/Operations/CustomOperation.cpp              | 2 +-
 src/MicroOcpp/Operations/CustomOperation.h                | 2 +-
 src/MicroOcpp/Operations/DataTransfer.cpp                 | 2 +-
 src/MicroOcpp/Operations/DataTransfer.h                   | 6 +++---
 .../Operations/DiagnosticsStatusNotification.cpp          | 2 +-
 src/MicroOcpp/Operations/DiagnosticsStatusNotification.h  | 6 +++---
 src/MicroOcpp/Operations/FirmwareStatusNotification.cpp   | 2 +-
 src/MicroOcpp/Operations/FirmwareStatusNotification.h     | 6 +++---
 src/MicroOcpp/Operations/GetCompositeSchedule.cpp         | 2 +-
 src/MicroOcpp/Operations/GetCompositeSchedule.h           | 6 +++---
 src/MicroOcpp/Operations/GetConfiguration.h               | 6 +++---
 src/MicroOcpp/Operations/GetDiagnostics.cpp               | 2 +-
 src/MicroOcpp/Operations/GetDiagnostics.h                 | 6 +++---
 src/MicroOcpp/Operations/GetLocalListVersion.cpp          | 2 +-
 src/MicroOcpp/Operations/GetLocalListVersion.h            | 6 +++---
 src/MicroOcpp/Operations/Heartbeat.cpp                    | 2 +-
 src/MicroOcpp/Operations/Heartbeat.h                      | 6 +++---
 src/MicroOcpp/Operations/MeterValues.cpp                  | 2 +-
 src/MicroOcpp/Operations/MeterValues.h                    | 6 +++---
 src/MicroOcpp/Operations/RemoteStartTransaction.cpp       | 2 +-
 src/MicroOcpp/Operations/RemoteStartTransaction.h         | 6 +++---
 src/MicroOcpp/Operations/RemoteStopTransaction.cpp        | 2 +-
 src/MicroOcpp/Operations/RemoteStopTransaction.h          | 6 +++---
 src/MicroOcpp/Operations/SendLocalList.cpp                | 2 +-
 src/MicroOcpp/Operations/SendLocalList.h                  | 6 +++---
 src/MicroOcpp/Operations/SetChargingProfile.cpp           | 2 +-
 src/MicroOcpp/Operations/SetChargingProfile.h             | 6 +++---
 src/MicroOcpp/Operations/StartTransaction.cpp             | 2 +-
 src/MicroOcpp/Operations/StartTransaction.h               | 6 +++---
 src/MicroOcpp/Operations/StopTransaction.cpp              | 2 +-
 src/MicroOcpp/Operations/StopTransaction.h                | 6 +++---
 src/MicroOcpp/Operations/TransactionEvent.cpp             | 2 +-
 src/MicroOcpp/Operations/TransactionEvent.h               | 2 +-
 src/MicroOcpp/Operations/TriggerMessage.cpp               | 2 +-
 src/MicroOcpp/Operations/TriggerMessage.h                 | 6 +++---
 src/MicroOcpp/Operations/UpdateFirmware.cpp               | 2 +-
 src/MicroOcpp/Operations/UpdateFirmware.h                 | 6 +++---
 tests/Api.cpp                                             | 4 ++++
 tests/Metering.cpp                                        | 4 ++++
 tests/Reservation.cpp                                     | 4 ++++
 tests/SmartCharging.cpp                                   | 4 ++++
 tests/TransactionSafety.cpp                               | 4 ++++
 tests/helpers/testHelper.cpp                              | 4 ++++
 tests/helpers/testHelper.h                                | 8 ++++++--
 tests/ocppEngineLifecycle.cpp                             | 4 ++++
 118 files changed, 245 insertions(+), 193 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 5bb21730..e6bb0e7b 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -1,3 +1,7 @@
+# matth-x/MicroOcpp
+# Copyright Matthias Akstaller 2019 - 2024
+# MIT License
+
 name: documentation 
 on:
   push:
diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
index 3bc9e699..dcbaa166 100644
--- a/.github/workflows/esp-idf.yml
+++ b/.github/workflows/esp-idf.yml
@@ -1,3 +1,7 @@
+# matth-x/MicroOcpp
+# Copyright Matthias Akstaller 2019 - 2024
+# MIT License
+
 name: ESP-IDF CI
 
 on:
diff --git a/.github/workflows/pio.yml b/.github/workflows/pio.yml
index 235e4555..ec777853 100644
--- a/.github/workflows/pio.yml
+++ b/.github/workflows/pio.yml
@@ -1,3 +1,7 @@
+# matth-x/MicroOcpp
+# Copyright Matthias Akstaller 2019 - 2024
+# MIT License
+
 name: PlatformIO CI
 
 on:
diff --git a/.github/workflows/platformless.yml b/.github/workflows/platformless.yml
index 5f05b164..58e7b1ee 100644
--- a/.github/workflows/platformless.yml
+++ b/.github/workflows/platformless.yml
@@ -1,3 +1,7 @@
+# matth-x/MicroOcpp
+# Copyright Matthias Akstaller 2019 - 2024
+# MIT License
+
 name: Default Compilation
 
 on:
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 6b30c91e..e086761f 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -1,3 +1,7 @@
+# matth-x/MicroOcpp
+# Copyright Matthias Akstaller 2019 - 2024
+# MIT License
+
 name: Unit tests
 
 on:
diff --git a/LICENSE b/LICENSE
index 4211ff4f..d0b6f8ec 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019 - 2023 Matthias Akstaller
+Copyright (c) 2019 - 2024 Matthias Akstaller
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/examples/ESP-TLS/main.cpp b/examples/ESP-TLS/main.cpp
index 5a4a6d74..963332f4 100644
--- a/examples/ESP-TLS/main.cpp
+++ b/examples/ESP-TLS/main.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <Arduino.h>
diff --git a/examples/ESP/main.cpp b/examples/ESP/main.cpp
index b9f46a7b..306e700b 100644
--- a/examples/ESP/main.cpp
+++ b/examples/ESP/main.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <Arduino.h>
diff --git a/platformio.ini b/platformio.ini
index 9e02cd14..b5660ac8 100644
--- a/platformio.ini
+++ b/platformio.ini
@@ -1,5 +1,5 @@
 ; matth-x/MicroOcpp
-; Copyright Matthias Akstaller 2019 - 2023
+; Copyright Matthias Akstaller 2019 - 2024
 ; MIT License
 
 [platformio]
diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index 8c40e547..090c4445 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/Configuration.h>
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index 1d19dac6..d6d09226 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CONFIGURATION_H
-#define CONFIGURATION_H
+#ifndef MO_CONFIGURATION_H
+#define MO_CONFIGURATION_H
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <MicroOcpp/Core/ConfigurationContainer.h>
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index 4af4c359..e0554fe7 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/ConfigurationContainer.h>
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index 52804e3b..44382a08 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CONFIGURATIONCONTAINER_H
-#define CONFIGURATIONCONTAINER_H
+#ifndef MO_CONFIGURATIONCONTAINER_H
+#define MO_CONFIGURATIONCONTAINER_H
 
 #include <vector>
 #include <memory>
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index df494327..74263b3e 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/ConfigurationContainerFlash.h>
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.h b/src/MicroOcpp/Core/ConfigurationContainerFlash.h
index ecab3f69..950f3cd7 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.h
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CONFIGURATIONCONTAINERFLASH_H
-#define CONFIGURATIONCONTAINERFLASH_H
+#ifndef MO_CONFIGURATIONCONTAINERFLASH_H
+#define MO_CONFIGURATIONCONTAINERFLASH_H
 
 #include <MicroOcpp/Core/ConfigurationContainer.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
diff --git a/src/MicroOcpp/Core/ConfigurationOptions.h b/src/MicroOcpp/Core/ConfigurationOptions.h
index 1cda7a91..0e9e227f 100644
--- a/src/MicroOcpp/Core/ConfigurationOptions.h
+++ b/src/MicroOcpp/Core/ConfigurationOptions.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CONFIGURATIONOPTIONS_H
-#define CONFIGURATIONOPTIONS_H
+#ifndef MO_CONFIGURATIONOPTIONS_H
+#define MO_CONFIGURATIONOPTIONS_H
 
 #include <stdint.h>
 
diff --git a/src/MicroOcpp/Core/Context.cpp b/src/MicroOcpp/Core/Context.cpp
index 3474ce89..b4c2c4e3 100644
--- a/src/MicroOcpp/Core/Context.cpp
+++ b/src/MicroOcpp/Core/Context.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/Context.h>
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index c173b797..a2fb09ec 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.h b/src/MicroOcpp/Core/FilesystemAdapter.h
index 2dc4eb2a..7e92e7cf 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.h
+++ b/src/MicroOcpp/Core/FilesystemAdapter.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_FILESYSTEMADAPTER_H
diff --git a/src/MicroOcpp/Core/FilesystemUtils.cpp b/src/MicroOcpp/Core/FilesystemUtils.cpp
index ea0bc9d8..3817b280 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.cpp
+++ b/src/MicroOcpp/Core/FilesystemUtils.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
diff --git a/src/MicroOcpp/Core/FilesystemUtils.h b/src/MicroOcpp/Core/FilesystemUtils.h
index 1845d3cd..962ca353 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.h
+++ b/src/MicroOcpp/Core/FilesystemUtils.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_FILESYSTEMUTILS_H
diff --git a/src/MicroOcpp/Core/OcppError.h b/src/MicroOcpp/Core/OcppError.h
index a2d24cf3..759eac40 100644
--- a/src/MicroOcpp/Core/OcppError.h
+++ b/src/MicroOcpp/Core/OcppError.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef OCPPERROR_H
-#define OCPPERROR_H
+#ifndef MO_OCPPERROR_H
+#define MO_OCPPERROR_H
 
 #include <ArduinoJson.h>
 
diff --git a/src/MicroOcpp/Core/Operation.cpp b/src/MicroOcpp/Core/Operation.cpp
index 9dc887fa..386a43e6 100644
--- a/src/MicroOcpp/Core/Operation.cpp
+++ b/src/MicroOcpp/Core/Operation.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/Operation.h>
diff --git a/src/MicroOcpp/Core/Operation.h b/src/MicroOcpp/Core/Operation.h
index 0018a453..e8079333 100644
--- a/src/MicroOcpp/Core/Operation.h
+++ b/src/MicroOcpp/Core/Operation.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 /**
diff --git a/src/MicroOcpp/Core/OperationRegistry.cpp b/src/MicroOcpp/Core/OperationRegistry.cpp
index 2960c24d..38d9e459 100644
--- a/src/MicroOcpp/Core/OperationRegistry.cpp
+++ b/src/MicroOcpp/Core/OperationRegistry.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/OperationRegistry.h>
diff --git a/src/MicroOcpp/Core/OperationRegistry.h b/src/MicroOcpp/Core/OperationRegistry.h
index 23bba2e4..959111eb 100644
--- a/src/MicroOcpp/Core/OperationRegistry.h
+++ b/src/MicroOcpp/Core/OperationRegistry.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_OPERATIONREGISTRY_H
diff --git a/src/MicroOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
index 07a56627..874985f3 100644
--- a/src/MicroOcpp/Core/Request.h
+++ b/src/MicroOcpp/Core/Request.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_REQUEST_H
diff --git a/src/MicroOcpp/Core/RequestCallbacks.h b/src/MicroOcpp/Core/RequestCallbacks.h
index 33209a8d..4959a3bc 100644
--- a/src/MicroOcpp/Core/RequestCallbacks.h
+++ b/src/MicroOcpp/Core/RequestCallbacks.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_REQUESTCALLBACKS_H
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index b247d0de..ea809a52 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/RequestQueue.h>
diff --git a/src/MicroOcpp/Core/RequestQueue.h b/src/MicroOcpp/Core/RequestQueue.h
index 5ce7e03d..1c1f576d 100644
--- a/src/MicroOcpp/Core/RequestQueue.h
+++ b/src/MicroOcpp/Core/RequestQueue.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_REQUESTQUEUE_H
diff --git a/src/MicroOcpp/Core/RequestQueueStorageStrategy.h b/src/MicroOcpp/Core/RequestQueueStorageStrategy.h
index 6d46e978..458b00d0 100644
--- a/src/MicroOcpp/Core/RequestQueueStorageStrategy.h
+++ b/src/MicroOcpp/Core/RequestQueueStorageStrategy.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef REQUESTQUEUESTORAGESTRATEGY_H
-#define REQUESTQUEUESTORAGESTRATEGY_H
+#ifndef MO_REQUESTQUEUESTORAGESTRATEGY_H
+#define MO_REQUESTQUEUESTORAGESTRATEGY_H
 
 #include <MicroOcpp/Core/RequestStore.h>
 
diff --git a/src/MicroOcpp/Core/RequestStore.cpp b/src/MicroOcpp/Core/RequestStore.cpp
index 4fa602af..056bfc9f 100644
--- a/src/MicroOcpp/Core/RequestStore.cpp
+++ b/src/MicroOcpp/Core/RequestStore.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/RequestStore.h>
diff --git a/src/MicroOcpp/Core/RequestStore.h b/src/MicroOcpp/Core/RequestStore.h
index e6320ef5..b31f0cd5 100644
--- a/src/MicroOcpp/Core/RequestStore.h
+++ b/src/MicroOcpp/Core/RequestStore.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_REQUESTSTORE_H
diff --git a/src/MicroOcpp/Core/SimpleRequestFactory.cpp b/src/MicroOcpp/Core/SimpleRequestFactory.cpp
index baf7a7ca..1fa5bd5b 100644
--- a/src/MicroOcpp/Core/SimpleRequestFactory.cpp
+++ b/src/MicroOcpp/Core/SimpleRequestFactory.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
diff --git a/src/MicroOcpp/Core/SimpleRequestFactory.h b/src/MicroOcpp/Core/SimpleRequestFactory.h
index 11c1f1c2..20f84727 100644
--- a/src/MicroOcpp/Core/SimpleRequestFactory.h
+++ b/src/MicroOcpp/Core/SimpleRequestFactory.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_SIMPLEREQUESTFACTORY_H
diff --git a/src/MicroOcpp/Core/Time.cpp b/src/MicroOcpp/Core/Time.cpp
index 6437600b..e2e38ae6 100644
--- a/src/MicroOcpp/Core/Time.cpp
+++ b/src/MicroOcpp/Core/Time.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/Time.h>
diff --git a/src/MicroOcpp/Core/Time.h b/src/MicroOcpp/Core/Time.h
index 83e3bd27..ab363175 100644
--- a/src/MicroOcpp/Core/Time.h
+++ b/src/MicroOcpp/Core/Time.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_TIME_H
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
index 140164a8..d2ea92a9 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Authorization/AuthorizationData.h>
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationData.h b/src/MicroOcpp/Model/Authorization/AuthorizationData.h
index 69f1592c..a1510ef3 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationData.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationData.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef AUTHORIZATIONDATA_H
-#define AUTHORIZATIONDATA_H
+#ifndef MO_AUTHORIZATIONDATA_H
+#define MO_AUTHORIZATIONDATA_H
 
 #include <MicroOcpp/Operations/CiStrings.h>
 #include <MicroOcpp/Core/Time.h>
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
index 9dfaff85..b5c54b5e 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Authorization/AuthorizationList.h>
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.h b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
index f2c57ac2..e3948a27 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef AUTHORIZATIONLIST_H
-#define AUTHORIZATIONLIST_H
+#ifndef MO_AUTHORIZATIONLIST_H
+#define MO_AUTHORIZATIONLIST_H
 
 #include <MicroOcpp/Model/Authorization/AuthorizationData.h>
 #include <vector>
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 36011afd..201cc2e3 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.h b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
index 8a2c6043..359f175f 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef AUTHORIZATIONSERVICE_H
-#define AUTHORIZATIONSERVICE_H
+#ifndef MO_AUTHORIZATIONSERVICE_H
+#define MO_AUTHORIZATIONSERVICE_H
 
 #include <MicroOcpp/Model/Authorization/AuthorizationList.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index 20c07c0e..68c96fa4 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <limits>
diff --git a/src/MicroOcpp/Model/Boot/BootService.h b/src/MicroOcpp/Model/Boot/BootService.h
index 67776eed..263e7055 100644
--- a/src/MicroOcpp/Model/Boot/BootService.h
+++ b/src/MicroOcpp/Model/Boot/BootService.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef BOOTSERVICE_H
-#define BOOTSERVICE_H
+#ifndef MO_BOOTSERVICE_H
+#define MO_BOOTSERVICE_H
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
diff --git a/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h b/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
index d78981b1..ae48c09b 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_CHARGEPOINTERRORCODE_H
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
index b3848a5d..2fa856b8 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CHARGECONTROLCOMMON_H
-#define CHARGECONTROLCOMMON_H
+#ifndef MO_CHARGECONTROLCOMMON_H
+#define MO_CHARGECONTROLCOMMON_H
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Notification.cpp b/src/MicroOcpp/Model/ConnectorBase/Notification.cpp
index 2e0b53d5..1ad2eb1f 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Notification.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Notification.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
diff --git a/src/MicroOcpp/Model/ConnectorBase/Notification.h b/src/MicroOcpp/Model/ConnectorBase/Notification.h
index eb437365..66b14f9c 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Notification.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Notification.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_NOTIFICATION_H
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h
index 1cf9da4d..632708a4 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef DIAGNOSTICS_STATUS
-#define DIAGNOSTICS_STATUS
+#ifndef MO_DIAGNOSTICS_STATUS
+#define MO_DIAGNOSTICS_STATUS
 
 namespace MicroOcpp {
 namespace Ocpp16 {
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h
index 0688af12..3c8c7c2c 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef FIRMWARE_STATUS
-#define FIRMWARE_STATUS
+#ifndef MO_FIRMWARE_STATUS
+#define MO_FIRMWARE_STATUS
 
 namespace MicroOcpp {
 namespace Ocpp16 {
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
index 1de66747..da476db1 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Heartbeat/HeartbeatService.h>
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
index 5820612b..0decfa40 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef HEARTBEATSERVICE_H
-#define HEARTBEATSERVICE_H
+#ifndef MO_HEARTBEATSERVICE_H
+#define MO_HEARTBEATSERVICE_H
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <memory>
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.h b/src/MicroOcpp/Model/Metering/MeterStore.h
index 356bf8f3..d0f5af74 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.h
+++ b/src/MicroOcpp/Model/Metering/MeterStore.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef METERSTORE_H
-#define METERSTORE_H
+#ifndef MO_METERSTORE_H
+#define MO_METERSTORE_H
 
 #include <MicroOcpp/Model/Metering/MeterValue.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.cpp b/src/MicroOcpp/Model/Metering/MeterValue.cpp
index 45fd41ef..8162d3eb 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterValue.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Metering/MeterValue.h>
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.h b/src/MicroOcpp/Model/Metering/MeterValue.h
index 352994b3..f8fd3549 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.h
+++ b/src/MicroOcpp/Model/Metering/MeterValue.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef METERVALUE_H
-#define METERVALUE_H
+#ifndef MO_METERVALUE_H
+#define MO_METERVALUE_H
 
 #include <MicroOcpp/Core/Time.h>
 #include <MicroOcpp/Model/Metering/SampledValue.h>
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index d391b3d4..f76a8d79 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Metering/MeteringConnector.h>
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.h b/src/MicroOcpp/Model/Metering/MeteringConnector.h
index 72ab1d82..f5f304da 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.h
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef METERING_CONNECTOR_H
-#define METERING_CONNECTOR_H
+#ifndef MO_METERING_CONNECTOR_H
+#define MO_METERING_CONNECTOR_H
 
 #include <functional>
 #include <memory>
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index b2bc7373..c2afe99f 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Metering/MeteringService.h>
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.h b/src/MicroOcpp/Model/Metering/MeteringService.h
index 0f2f7afc..5249a3e3 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.h
+++ b/src/MicroOcpp/Model/Metering/MeteringService.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef METERINGSERVICE_H
-#define METERINGSERVICE_H
+#ifndef MO_METERINGSERVICE_H
+#define MO_METERINGSERVICE_H
 
 #include <functional>
 #include <vector>
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
index 4813dbb9..4bab8476 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/SmartCharging/SmartChargingModel.h>
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
index b1f3e200..b3f0549e 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef TRANSACTIONDESERIALIZE_H
-#define TRANSACTIONDESERIALIZE_H
+#ifndef MO_TRANSACTIONDESERIALIZE_H
+#define MO_TRANSACTIONDESERIALIZE_H
 
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
index dc5ff934..7be7ea79 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.h b/src/MicroOcpp/Model/Transactions/TransactionStore.h
index c643bd6b..100a2ab1 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef TRANSACTIONSTORE_H
-#define TRANSACTIONSTORE_H
+#ifndef MO_TRANSACTIONSTORE_H
+#define MO_TRANSACTIONSTORE_H
 
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Core/Configuration.h>
diff --git a/src/MicroOcpp/Operations/BootNotification.h b/src/MicroOcpp/Operations/BootNotification.h
index 4a85833f..cc783fd4 100644
--- a/src/MicroOcpp/Operations/BootNotification.h
+++ b/src/MicroOcpp/Operations/BootNotification.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef BOOTNOTIFICATION_H
-#define BOOTNOTIFICATION_H
+#ifndef MO_BOOTNOTIFICATION_H
+#define MO_BOOTNOTIFICATION_H
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Operations/CiStrings.h>
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.h b/src/MicroOcpp/Operations/ChangeAvailability.h
index 00fd2b7a..4e7e58af 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.h
+++ b/src/MicroOcpp/Operations/ChangeAvailability.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CHANGEAVAILABILITY_H
-#define CHANGEAVAILABILITY_H
+#ifndef MO_CHANGEAVAILABILITY_H
+#define MO_CHANGEAVAILABILITY_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
index 57d84dbf..66e29fed 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/ChangeConfiguration.h>
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.h b/src/MicroOcpp/Operations/ChangeConfiguration.h
index 55cb6b47..1f98a65e 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.h
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CHANGECONFIGURATION_H
-#define CHANGECONFIGURATION_H
+#ifndef MO_CHANGECONFIGURATION_H
+#define MO_CHANGECONFIGURATION_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/CiStrings.h b/src/MicroOcpp/Operations/CiStrings.h
index a963fde6..d52e176c 100644
--- a/src/MicroOcpp/Operations/CiStrings.h
+++ b/src/MicroOcpp/Operations/CiStrings.h
@@ -1,13 +1,13 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 /*
  * A collection of the fixed-length string types in the OCPP specification
  */
 
-#ifndef CI_STRINGS_H
-#define CI_STRINGS_H
+#ifndef MO_CI_STRINGS_H
+#define MO_CI_STRINGS_H
 
 #define CiString20TypeLen 20
 #define CiString25TypeLen 25
diff --git a/src/MicroOcpp/Operations/ClearCache.cpp b/src/MicroOcpp/Operations/ClearCache.cpp
index d6afc1b8..c5e122aa 100644
--- a/src/MicroOcpp/Operations/ClearCache.cpp
+++ b/src/MicroOcpp/Operations/ClearCache.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/ClearCache.h>
diff --git a/src/MicroOcpp/Operations/ClearCache.h b/src/MicroOcpp/Operations/ClearCache.h
index e49a6969..0dc06d58 100644
--- a/src/MicroOcpp/Operations/ClearCache.h
+++ b/src/MicroOcpp/Operations/ClearCache.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CLEARCACHE_H
-#define CLEARCACHE_H
+#ifndef MO_CLEARCACHE_H
+#define MO_CLEARCACHE_H
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
diff --git a/src/MicroOcpp/Operations/ClearChargingProfile.cpp b/src/MicroOcpp/Operations/ClearChargingProfile.cpp
index cd6f5bb5..24b92379 100644
--- a/src/MicroOcpp/Operations/ClearChargingProfile.cpp
+++ b/src/MicroOcpp/Operations/ClearChargingProfile.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/ClearChargingProfile.h>
diff --git a/src/MicroOcpp/Operations/ClearChargingProfile.h b/src/MicroOcpp/Operations/ClearChargingProfile.h
index e7befe8a..535571f8 100644
--- a/src/MicroOcpp/Operations/ClearChargingProfile.h
+++ b/src/MicroOcpp/Operations/ClearChargingProfile.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef CLEARCHARGINGPROFILE_H
-#define CLEARCHARGINGPROFILE_H
+#ifndef MO_CLEARCHARGINGPROFILE_H
+#define MO_CLEARCHARGINGPROFILE_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/CustomOperation.cpp b/src/MicroOcpp/Operations/CustomOperation.cpp
index 59eef187..6f035e62 100644
--- a/src/MicroOcpp/Operations/CustomOperation.cpp
+++ b/src/MicroOcpp/Operations/CustomOperation.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/CustomOperation.h>
diff --git a/src/MicroOcpp/Operations/CustomOperation.h b/src/MicroOcpp/Operations/CustomOperation.h
index 4fe07dcf..334aa98e 100644
--- a/src/MicroOcpp/Operations/CustomOperation.h
+++ b/src/MicroOcpp/Operations/CustomOperation.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_CUSTOMOPERATION_H
diff --git a/src/MicroOcpp/Operations/DataTransfer.cpp b/src/MicroOcpp/Operations/DataTransfer.cpp
index a7f4af1c..b04bb29a 100644
--- a/src/MicroOcpp/Operations/DataTransfer.cpp
+++ b/src/MicroOcpp/Operations/DataTransfer.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/DataTransfer.h>
diff --git a/src/MicroOcpp/Operations/DataTransfer.h b/src/MicroOcpp/Operations/DataTransfer.h
index c8faa586..2a7d78ef 100644
--- a/src/MicroOcpp/Operations/DataTransfer.h
+++ b/src/MicroOcpp/Operations/DataTransfer.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef DATATRANSFER_H
-#define DATATRANSFER_H
+#ifndef MO_DATATRANSFER_H
+#define MO_DATATRANSFER_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
index c220b6fa..6eaa3d94 100644
--- a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
+++ b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/DiagnosticsStatusNotification.h>
diff --git a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
index 7dcd0b3b..18f346a5 100644
--- a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
+++ b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
@@ -1,12 +1,12 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h>
 
-#ifndef DIAGNOSTICSSTATUSNOTIFICATION_H
-#define DIAGNOSTICSSTATUSNOTIFICATION_H
+#ifndef MO_DIAGNOSTICSSTATUSNOTIFICATION_H
+#define MO_DIAGNOSTICSSTATUSNOTIFICATION_H
 
 namespace MicroOcpp {
 namespace Ocpp16 {
diff --git a/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp b/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
index 20d28a60..b3f0a5dd 100644
--- a/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
+++ b/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/FirmwareStatusNotification.h>
diff --git a/src/MicroOcpp/Operations/FirmwareStatusNotification.h b/src/MicroOcpp/Operations/FirmwareStatusNotification.h
index 3e0feb97..632d2bfa 100644
--- a/src/MicroOcpp/Operations/FirmwareStatusNotification.h
+++ b/src/MicroOcpp/Operations/FirmwareStatusNotification.h
@@ -1,13 +1,13 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Core/Operation.h>
 
 #include <MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h>
 
-#ifndef FIRMWARESTATUSNOTIFICATION_H
-#define FIRMWARESTATUSNOTIFICATION_H
+#ifndef MO_FIRMWARESTATUSNOTIFICATION_H
+#define MO_FIRMWARESTATUSNOTIFICATION_H
 
 namespace MicroOcpp {
 namespace Ocpp16 {
diff --git a/src/MicroOcpp/Operations/GetCompositeSchedule.cpp b/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
index 40a314ed..54958f36 100644
--- a/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
+++ b/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/GetCompositeSchedule.h>
diff --git a/src/MicroOcpp/Operations/GetCompositeSchedule.h b/src/MicroOcpp/Operations/GetCompositeSchedule.h
index 6e1d0fae..800c8f33 100644
--- a/src/MicroOcpp/Operations/GetCompositeSchedule.h
+++ b/src/MicroOcpp/Operations/GetCompositeSchedule.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef GETCOMPOSITESCHEDULE_H
-#define GETCOMPOSITESCHEDULE_H
+#ifndef MO_GETCOMPOSITESCHEDULE_H
+#define MO_GETCOMPOSITESCHEDULE_H
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Time.h>
diff --git a/src/MicroOcpp/Operations/GetConfiguration.h b/src/MicroOcpp/Operations/GetConfiguration.h
index 47da8519..94fb5d06 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.h
+++ b/src/MicroOcpp/Operations/GetConfiguration.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef GETCONFIGURATION_H
-#define GETCONFIGURATION_H
+#ifndef MO_GETCONFIGURATION_H
+#define MO_GETCONFIGURATION_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.cpp b/src/MicroOcpp/Operations/GetDiagnostics.cpp
index 93a76d83..6f9e4634 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.cpp
+++ b/src/MicroOcpp/Operations/GetDiagnostics.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/GetDiagnostics.h>
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.h b/src/MicroOcpp/Operations/GetDiagnostics.h
index 22c14983..f9c11635 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.h
+++ b/src/MicroOcpp/Operations/GetDiagnostics.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef GETDIAGNOSTICS_H
-#define GETDIAGNOSTICS_H
+#ifndef MO_GETDIAGNOSTICS_H
+#define MO_GETDIAGNOSTICS_H
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Time.h>
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.cpp b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
index 7c0a2c67..2132014b 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.cpp
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/GetLocalListVersion.h>
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.h b/src/MicroOcpp/Operations/GetLocalListVersion.h
index 90e6d099..4e8232aa 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.h
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef GETLOCALLISTVERSION_H
-#define GETLOCALLISTVERSION_H
+#ifndef MO_GETLOCALLISTVERSION_H
+#define MO_GETLOCALLISTVERSION_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/Heartbeat.cpp b/src/MicroOcpp/Operations/Heartbeat.cpp
index 7d358a6d..040fba05 100644
--- a/src/MicroOcpp/Operations/Heartbeat.cpp
+++ b/src/MicroOcpp/Operations/Heartbeat.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/Heartbeat.h>
diff --git a/src/MicroOcpp/Operations/Heartbeat.h b/src/MicroOcpp/Operations/Heartbeat.h
index 23855e39..83d4c01d 100644
--- a/src/MicroOcpp/Operations/Heartbeat.h
+++ b/src/MicroOcpp/Operations/Heartbeat.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef HEARTBEAT_H
-#define HEARTBEAT_H
+#ifndef MO_HEARTBEAT_H
+#define MO_HEARTBEAT_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/MeterValues.cpp b/src/MicroOcpp/Operations/MeterValues.cpp
index 4e44dfad..32fdd96c 100644
--- a/src/MicroOcpp/Operations/MeterValues.cpp
+++ b/src/MicroOcpp/Operations/MeterValues.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/MeterValues.h>
diff --git a/src/MicroOcpp/Operations/MeterValues.h b/src/MicroOcpp/Operations/MeterValues.h
index d778040f..3760e2aa 100644
--- a/src/MicroOcpp/Operations/MeterValues.h
+++ b/src/MicroOcpp/Operations/MeterValues.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef METERVALUES_H
-#define METERVALUES_H
+#ifndef MO_METERVALUES_H
+#define MO_METERVALUES_H
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Time.h>
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
index 4e06486e..668b6738 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.h b/src/MicroOcpp/Operations/RemoteStartTransaction.h
index 90b78483..c286e1fd 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef REMOTESTARTTRANSACTION_H
-#define REMOTESTARTTRANSACTION_H
+#ifndef MO_REMOTESTARTTRANSACTION_H
+#define MO_REMOTESTARTTRANSACTION_H
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Operations/CiStrings.h>
diff --git a/src/MicroOcpp/Operations/RemoteStopTransaction.cpp b/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
index f19dd969..7e1cdd54 100644
--- a/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/RemoteStopTransaction.h>
diff --git a/src/MicroOcpp/Operations/RemoteStopTransaction.h b/src/MicroOcpp/Operations/RemoteStopTransaction.h
index 984de7e5..a3d6ac21 100644
--- a/src/MicroOcpp/Operations/RemoteStopTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStopTransaction.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef REMOTESTOPTRANSACTION_H
-#define REMOTESTOPTRANSACTION_H
+#ifndef MO_REMOTESTOPTRANSACTION_H
+#define MO_REMOTESTOPTRANSACTION_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 53dc3de5..49fb2b05 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/SendLocalList.h>
diff --git a/src/MicroOcpp/Operations/SendLocalList.h b/src/MicroOcpp/Operations/SendLocalList.h
index 496b8126..d643ea6f 100644
--- a/src/MicroOcpp/Operations/SendLocalList.h
+++ b/src/MicroOcpp/Operations/SendLocalList.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef SENDLOCALLIST_H
-#define SENDLOCALLIST_H
+#ifndef MO_SENDLOCALLIST_H
+#define MO_SENDLOCALLIST_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/SetChargingProfile.cpp b/src/MicroOcpp/Operations/SetChargingProfile.cpp
index 92e54a6d..20cf5ca8 100644
--- a/src/MicroOcpp/Operations/SetChargingProfile.cpp
+++ b/src/MicroOcpp/Operations/SetChargingProfile.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/SetChargingProfile.h>
diff --git a/src/MicroOcpp/Operations/SetChargingProfile.h b/src/MicroOcpp/Operations/SetChargingProfile.h
index 3d0cb425..b68e96dc 100644
--- a/src/MicroOcpp/Operations/SetChargingProfile.h
+++ b/src/MicroOcpp/Operations/SetChargingProfile.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef SETCHARGINGPROFILE_H
-#define SETCHARGINGPROFILE_H
+#ifndef MO_SETCHARGINGPROFILE_H
+#define MO_SETCHARGINGPROFILE_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/StartTransaction.cpp b/src/MicroOcpp/Operations/StartTransaction.cpp
index 80ecb961..6f536fe3 100644
--- a/src/MicroOcpp/Operations/StartTransaction.cpp
+++ b/src/MicroOcpp/Operations/StartTransaction.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/StartTransaction.h>
diff --git a/src/MicroOcpp/Operations/StartTransaction.h b/src/MicroOcpp/Operations/StartTransaction.h
index f4e22311..e6a2f0f3 100644
--- a/src/MicroOcpp/Operations/StartTransaction.h
+++ b/src/MicroOcpp/Operations/StartTransaction.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef STARTTRANSACTION_H
-#define STARTTRANSACTION_H
+#ifndef MO_STARTTRANSACTION_H
+#define MO_STARTTRANSACTION_H
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Time.h>
diff --git a/src/MicroOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
index e82acb00..b46cb88b 100644
--- a/src/MicroOcpp/Operations/StopTransaction.cpp
+++ b/src/MicroOcpp/Operations/StopTransaction.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/StopTransaction.h>
diff --git a/src/MicroOcpp/Operations/StopTransaction.h b/src/MicroOcpp/Operations/StopTransaction.h
index 49cf7fd5..9d3bea4a 100644
--- a/src/MicroOcpp/Operations/StopTransaction.h
+++ b/src/MicroOcpp/Operations/StopTransaction.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef STOPTRANSACTION_H
-#define STOPTRANSACTION_H
+#ifndef MO_STOPTRANSACTION_H
+#define MO_STOPTRANSACTION_H
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Time.h>
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
index cdcd80a5..13393a43 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.cpp
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Version.h>
diff --git a/src/MicroOcpp/Operations/TransactionEvent.h b/src/MicroOcpp/Operations/TransactionEvent.h
index 799a9687..ea8ef856 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.h
+++ b/src/MicroOcpp/Operations/TransactionEvent.h
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #ifndef MO_TRANSACTIONEVENT_H
diff --git a/src/MicroOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
index 7e47a64f..8177aecb 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.cpp
+++ b/src/MicroOcpp/Operations/TriggerMessage.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/TriggerMessage.h>
diff --git a/src/MicroOcpp/Operations/TriggerMessage.h b/src/MicroOcpp/Operations/TriggerMessage.h
index b6f91025..4b8af068 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.h
+++ b/src/MicroOcpp/Operations/TriggerMessage.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef TRIGGERMESSAGE_H
-#define TRIGGERMESSAGE_H
+#ifndef MO_TRIGGERMESSAGE_H
+#define MO_TRIGGERMESSAGE_H
 
 #include <MicroOcpp/Core/Operation.h>
 
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.cpp b/src/MicroOcpp/Operations/UpdateFirmware.cpp
index 8664ffe0..52cb9683 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.cpp
+++ b/src/MicroOcpp/Operations/UpdateFirmware.cpp
@@ -1,5 +1,5 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
 #include <MicroOcpp/Operations/UpdateFirmware.h>
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.h b/src/MicroOcpp/Operations/UpdateFirmware.h
index 8efeba37..0b4721f7 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.h
+++ b/src/MicroOcpp/Operations/UpdateFirmware.h
@@ -1,9 +1,9 @@
 // matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2023
+// Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef UPDATEFIRMWARE_H
-#define UPDATEFIRMWARE_H
+#ifndef MO_UPDATEFIRMWARE_H
+#define MO_UPDATEFIRMWARE_H
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Time.h>
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 1df5bf3a..b716965f 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/Context.h>
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 2cd1e01f..cec57084 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/Context.h>
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index 1270b5db..34e7195b 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index c029fcd1..19bec8b1 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/Context.h>
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 79cd76a1..fe62a486 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/Context.h>
diff --git a/tests/helpers/testHelper.cpp b/tests/helpers/testHelper.cpp
index a6aec2a4..1040b678 100644
--- a/tests/helpers/testHelper.cpp
+++ b/tests/helpers/testHelper.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <iostream>
 #include <MicroOcpp.h>
 
diff --git a/tests/helpers/testHelper.h b/tests/helpers/testHelper.h
index 4d9fd640..90b19061 100644
--- a/tests/helpers/testHelper.h
+++ b/tests/helpers/testHelper.h
@@ -1,5 +1,9 @@
-#ifndef CPP_CONSOLE_OUT
-#define CPP_CONSOLE_OUT
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_CPP_CONSOLE_OUT
+#define MO_CPP_CONSOLE_OUT
 
 /**
 * Prints a string to the c standart console
diff --git a/tests/ocppEngineLifecycle.cpp b/tests/ocppEngineLifecycle.cpp
index df39f282..0a8b3e71 100644
--- a/tests/ocppEngineLifecycle.cpp
+++ b/tests/ocppEngineLifecycle.cpp
@@ -1,3 +1,7 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"

From a36e6a443fe660f27b8b21eceb55db5b59e5c3b2 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 May 2024 13:11:32 +0200
Subject: [PATCH 484/549] add build flag MO_ENABLE_LOCAL_AUTH (#303)

* add build flag MO_ENABLE_LOCAL_AUTH

* update changelog
---
 CHANGELOG.md                                  |  1 +
 src/MicroOcpp.cpp                             |  3 ++
 .../Model/Authorization/AuthorizationData.cpp |  6 ++++
 .../Model/Authorization/AuthorizationData.h   |  5 ++++
 .../Model/Authorization/AuthorizationList.cpp |  6 ++++
 .../Model/Authorization/AuthorizationList.h   |  5 ++++
 .../Authorization/AuthorizationService.cpp    |  6 ++++
 .../Authorization/AuthorizationService.h      |  5 ++++
 .../Model/ConnectorBase/Connector.cpp         | 28 ++++++++++++-------
 src/MicroOcpp/Model/Model.cpp                 |  4 +++
 src/MicroOcpp/Model/Model.h                   | 12 ++++++--
 src/MicroOcpp/Operations/Authorize.cpp        |  6 ++--
 .../Operations/GetLocalListVersion.cpp        |  6 ++++
 .../Operations/GetLocalListVersion.h          |  6 ++++
 src/MicroOcpp/Operations/SendLocalList.cpp    |  6 ++++
 src/MicroOcpp/Operations/SendLocalList.h      |  6 ++++
 src/MicroOcpp/Operations/StartTransaction.cpp |  3 ++
 src/MicroOcpp/Operations/StopTransaction.cpp  |  3 ++
 src/MicroOcpp/Version.h                       |  5 ++++
 tests/ConfigurationBehavior.cpp               |  3 ++
 tests/LocalAuthList.cpp                       |  6 ++++
 21 files changed, 117 insertions(+), 14 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d0b0c891..3ab0a194 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,6 +15,7 @@
 - File index ([#270](https://github.com/matth-x/MicroOcpp/pull/270))
 - Config `Cst_TxStartOnPowerPathClosed` to put back TxStartPoint ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
 - Build flag `MO_ENABLE_V16_RESERVATION=0` disables Reservation module ([#302](https://github.com/matth-x/MicroOcpp/pull/302))
+- Build flag `MO_ENABLE_LOCAL_AUTH=0` disables LocalAuthList module ([#303](https://github.com/matth-x/MicroOcpp/pull/303))
 - Function `bool isConnected()` in `Connection` interface ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
 - Build flags for customizing memory limits of SmartCharging ([#260](https://github.com/matth-x/MicroOcpp/pull/260))
 - SConscript ([#287](https://github.com/matth-x/MicroOcpp/pull/287))
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 34921786..a2bb0cdb 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -287,8 +287,11 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     model.setConnectors(std::move(connectors));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
         new HeartbeatService(*context)));
+
+#if MO_ENABLE_LOCAL_AUTH
     model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
         new AuthorizationService(*context, filesystem)));
+#endif //MO_ENABLE_LOCAL_AUTH
 
 #if MO_ENABLE_V16_RESERVATION
     model.setReservationService(std::unique_ptr<ReservationService>(
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
index d2ea92a9..ac95e70d 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
@@ -2,6 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Model/Authorization/AuthorizationData.h>
 
 using namespace MicroOcpp;
@@ -152,3 +156,5 @@ MicroOcpp::AuthorizationStatus MicroOcpp::deserializeAuthorizationStatus(const c
         return AuthorizationStatus::UNDEFINED;
     }
 }
+
+#endif //MO_ENABLE_LOCAL_AUTH
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationData.h b/src/MicroOcpp/Model/Authorization/AuthorizationData.h
index a1510ef3..074e24a8 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationData.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationData.h
@@ -5,6 +5,10 @@
 #ifndef MO_AUTHORIZATIONDATA_H
 #define MO_AUTHORIZATIONDATA_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Operations/CiStrings.h>
 #include <MicroOcpp/Core/Time.h>
 #include <ArduinoJson.h>
@@ -64,4 +68,5 @@ class AuthorizationData {
 
 }
 
+#endif //MO_ENABLE_LOCAL_AUTH
 #endif
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
index b5c54b5e..bcbc8678 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
@@ -2,6 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Model/Authorization/AuthorizationList.h>
 #include <MicroOcpp/Debug.h>
 
@@ -194,3 +198,5 @@ void AuthorizationList::writeJson(JsonArray authListOut, bool compact) {
 size_t AuthorizationList::size() {
     return localAuthorizationList.size();
 }
+
+#endif //MO_ENABLE_LOCAL_AUTH
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.h b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
index e3948a27..7b0d33c5 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
@@ -5,6 +5,10 @@
 #ifndef MO_AUTHORIZATIONLIST_H
 #define MO_AUTHORIZATIONLIST_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Model/Authorization/AuthorizationData.h>
 #include <vector>
 
@@ -41,4 +45,5 @@ class AuthorizationList {
 
 }
 
+#endif //MO_ENABLE_LOCAL_AUTH
 #endif
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 201cc2e3..3916bc9a 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -2,6 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
 #include <MicroOcpp/Model/ConnectorBase/Connector.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
@@ -192,3 +196,5 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
         context.initiateRequest(std::move(statusNotification));
     }
 }
+
+#endif //MO_ENABLE_LOCAL_AUTH
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.h b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
index 359f175f..85972c50 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
@@ -5,6 +5,10 @@
 #ifndef MO_AUTHORIZATIONSERVICE_H
 #define MO_AUTHORIZATIONSERVICE_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Model/Authorization/AuthorizationList.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/Configuration.h>
@@ -39,4 +43,5 @@ class AuthorizationService {
 
 }
 
+#endif //MO_ENABLE_LOCAL_AUTH
 #endif
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index a33ddbad..bf8da718 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -591,12 +591,14 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
 
     MO_DBG_DEBUG("Begin transaction process (%s), prepare", idTag != nullptr ? idTag : "");
     
-    AuthorizationData *localAuth = nullptr;
+    bool localAuthFound = false;
+    const char *parentIdTag = nullptr; //locally stored parentIdTag
     bool offlineBlockedAuth = false; //if offline authorization will be blocked by local auth list entry
 
     //check local OCPP whitelist
-    if (model.getAuthorizationService()) {
-        localAuth = model.getAuthorizationService()->getLocalAuthorization(idTag);
+    #if MO_ENABLE_LOCAL_AUTH
+    if (auto authService = model.getAuthorizationService()) {
+        auto localAuth = authService->getLocalAuthorization(idTag);
 
         //check authorization status
         if (localAuth && localAuth->getAuthorizationStatus() != AuthorizationStatus::Accepted) {
@@ -611,21 +613,26 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             offlineBlockedAuth = true;
             localAuth = nullptr;
         }
+
+        if (localAuth) {
+            localAuthFound = true;
+            parentIdTag = localAuth->getParentIdTag();
+        }
     }
+    #endif //MO_ENABLE_LOCAL_AUTH
 
     int reservationId = -1;
     bool offlineBlockedResv = false; //if offline authorization will be blocked by reservation
 
-    #if MO_ENABLE_V16_RESERVATION
     //check if blocked by reservation
+    #if MO_ENABLE_V16_RESERVATION
     if (model.getReservationService()) {
-        const char *parentIdTag = localAuth ? localAuth->getParentIdTag() : nullptr;
 
         auto reservation = model.getReservationService()->getReservation(
                 connectorId,
                 idTag,
                 parentIdTag);
-        
+
         if (reservation) {
             reservationId = reservation->getReservationId();
         }
@@ -645,12 +652,14 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             } else {
                 //parentIdTag unkown but local authorization failed in any case
                 MO_DBG_INFO("connector %u reserved - no local auth", connectorId);
-                localAuth = nullptr;
+                localAuthFound = false;
             }
         }
     }
+    #else
+    (void)parentIdTag;
     #endif //MO_ENABLE_V16_RESERVATION
-    
+
     transaction = allocateTransaction();
 
     if (!transaction) {
@@ -668,7 +677,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     transaction->setBeginTimestamp(model.getClock().now());
 
     //check for local preauthorization
-    if (localAuth && localPreAuthorizeBool && localPreAuthorizeBool->getBool()) {
+    if (localAuthFound && localPreAuthorizeBool && localPreAuthorizeBool->getBool()) {
         MO_DBG_DEBUG("Begin transaction process (%s), preauthorized locally", idTag != nullptr ? idTag : "");
 
         if (reservationId >= 0) {
@@ -735,7 +744,6 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     });
 
     //capture local auth and reservation check in for timeout handler
-    bool localAuthFound = localAuth;
     authorize->setOnTimeoutListener([this, tx,
                 offlineBlockedAuth, 
                 offlineBlockedResv, 
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 7b6c1126..91b21126 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -164,6 +164,7 @@ void Model::setHeartbeatService(std::unique_ptr<HeartbeatService> hs) {
     capabilitiesUpdated = true;
 }
 
+#if MO_ENABLE_LOCAL_AUTH
 void Model::setAuthorizationService(std::unique_ptr<AuthorizationService> as) {
     authorizationService = std::move(as);
     capabilitiesUpdated = true;
@@ -172,6 +173,7 @@ void Model::setAuthorizationService(std::unique_ptr<AuthorizationService> as) {
 AuthorizationService *Model::getAuthorizationService() {
     return authorizationService.get();
 }
+#endif //MO_ENABLE_LOCAL_AUTH
 
 #if MO_ENABLE_V16_RESERVATION
 void Model::setReservationService(std::unique_ptr<ReservationService> rs) {
@@ -283,12 +285,14 @@ void Model::updateSupportedStandardProfiles() {
         }
     }
 
+#if MO_ENABLE_LOCAL_AUTH
     if (authorizationService) {
         if (!strstr(supportedFeatureProfilesString->getString(), "LocalAuthListManagement")) {
             if (!buf.empty()) buf += ',';
             buf += "LocalAuthListManagement";
         }
     }
+#endif //MO_ENABLE_LOCAL_AUTH
 
 #if MO_ENABLE_V16_RESERVATION
     if (reservationService) {
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 5b98fd8a..233aa114 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -20,10 +20,13 @@ class MeteringService;
 class FirmwareService;
 class DiagnosticsService;
 class HeartbeatService;
-class AuthorizationService;
 class BootService;
 class ResetService;
 
+#if MO_ENABLE_LOCAL_AUTH
+class AuthorizationService;
+#endif //MO_ENABLE_LOCAL_AUTH
+
 #if MO_ENABLE_V16_RESERVATION
 class ReservationService;
 #endif //MO_ENABLE_V16_RESERVATION
@@ -51,10 +54,13 @@ class Model {
     std::unique_ptr<FirmwareService> firmwareService;
     std::unique_ptr<DiagnosticsService> diagnosticsService;
     std::unique_ptr<HeartbeatService> heartbeatService;
-    std::unique_ptr<AuthorizationService> authorizationService;
     std::unique_ptr<BootService> bootService;
     std::unique_ptr<ResetService> resetService;
 
+#if MO_ENABLE_LOCAL_AUTH
+    std::unique_ptr<AuthorizationService> authorizationService;
+#endif //MO_ENABLE_LOCAL_AUTH
+
 #if MO_ENABLE_V16_RESERVATION
     std::unique_ptr<ReservationService> reservationService;
 #endif //MO_ENABLE_V16_RESERVATION
@@ -113,8 +119,10 @@ class Model {
 
     void setHeartbeatService(std::unique_ptr<HeartbeatService> heartbeatService);
 
+#if MO_ENABLE_LOCAL_AUTH
     void setAuthorizationService(std::unique_ptr<AuthorizationService> authorizationService);
     AuthorizationService *getAuthorizationService();
+#endif //MO_ENABLE_LOCAL_AUTH
 
 #if MO_ENABLE_V16_RESERVATION
     void setReservationService(std::unique_ptr<ReservationService> reservationService);
diff --git a/src/MicroOcpp/Operations/Authorize.cpp b/src/MicroOcpp/Operations/Authorize.cpp
index 28289773..3bf34528 100644
--- a/src/MicroOcpp/Operations/Authorize.cpp
+++ b/src/MicroOcpp/Operations/Authorize.cpp
@@ -42,9 +42,11 @@ void Authorize::processConf(JsonObject payload){
         MO_DBG_INFO("Request has been denied. Reason: %s", idTagInfo);
     }
 
-    if (model.getAuthorizationService()) {
-        model.getAuthorizationService()->notifyAuthorization(idTag, payload["idTagInfo"]);
+#if MO_ENABLE_LOCAL_AUTH
+    if (auto authService = model.getAuthorizationService()) {
+        authService->notifyAuthorization(idTag, payload["idTagInfo"]);
     }
+#endif //MO_ENABLE_LOCAL_AUTH
 }
 
 void Authorize::processReq(JsonObject payload){
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.cpp b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
index 2132014b..71347b0d 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.cpp
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
@@ -2,6 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Operations/GetLocalListVersion.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
@@ -31,3 +35,5 @@ std::unique_ptr<DynamicJsonDocument> GetLocalListVersion::createConf(){
     }
     return doc;
 }
+
+#endif //MO_ENABLE_LOCAL_AUTH
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.h b/src/MicroOcpp/Operations/GetLocalListVersion.h
index 4e8232aa..2d0581ac 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.h
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.h
@@ -5,6 +5,10 @@
 #ifndef MO_GETLOCALLISTVERSION_H
 #define MO_GETLOCALLISTVERSION_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Core/Operation.h>
 
 namespace MicroOcpp {
@@ -28,4 +32,6 @@ class GetLocalListVersion : public Operation {
 
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
+
+#endif //MO_ENABLE_LOCAL_AUTH
 #endif
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 49fb2b05..5d19c908 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -2,6 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Operations/SendLocalList.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
@@ -64,3 +68,5 @@ std::unique_ptr<DynamicJsonDocument> SendLocalList::createConf(){
     
     return doc;
 }
+
+#endif //MO_ENABLE_LOCAL_AUTH
diff --git a/src/MicroOcpp/Operations/SendLocalList.h b/src/MicroOcpp/Operations/SendLocalList.h
index d643ea6f..bbd1fa2d 100644
--- a/src/MicroOcpp/Operations/SendLocalList.h
+++ b/src/MicroOcpp/Operations/SendLocalList.h
@@ -5,6 +5,10 @@
 #ifndef MO_SENDLOCALLIST_H
 #define MO_SENDLOCALLIST_H
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp/Core/Operation.h>
 
 namespace MicroOcpp {
@@ -35,4 +39,6 @@ class SendLocalList : public Operation {
 
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
+
+#endif //MO_ENABLE_LOCAL_AUTH
 #endif
diff --git a/src/MicroOcpp/Operations/StartTransaction.cpp b/src/MicroOcpp/Operations/StartTransaction.cpp
index 6f536fe3..429782db 100644
--- a/src/MicroOcpp/Operations/StartTransaction.cpp
+++ b/src/MicroOcpp/Operations/StartTransaction.cpp
@@ -10,6 +10,7 @@
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Debug.h>
+#include <MicroOcpp/Version.h>
 
 using MicroOcpp::Ocpp16::StartTransaction;
 
@@ -151,9 +152,11 @@ void StartTransaction::processConf(JsonObject payload) {
     transaction->getStartSync().confirm();
     transaction->commit();
 
+#if MO_ENABLE_LOCAL_AUTH
     if (auto authService = model.getAuthorizationService()) {
         authService->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
     }
+#endif //MO_ENABLE_LOCAL_AUTH
 }
 
 void StartTransaction::processReq(JsonObject payload) {
diff --git a/src/MicroOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
index b46cb88b..8cee8615 100644
--- a/src/MicroOcpp/Operations/StopTransaction.cpp
+++ b/src/MicroOcpp/Operations/StopTransaction.cpp
@@ -11,6 +11,7 @@
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Debug.h>
+#include <MicroOcpp/Version.h>
 
 using MicroOcpp::Ocpp16::StopTransaction;
 
@@ -202,9 +203,11 @@ void StopTransaction::processConf(JsonObject payload) {
 
     MO_DBG_INFO("Request has been accepted!");
 
+#if MO_ENABLE_LOCAL_AUTH
     if (auto authService = model.getAuthorizationService()) {
         authService->notifyAuthorization(transaction->getIdTag(), payload["idTagInfo"]);
     }
+#endif //MO_ENABLE_LOCAL_AUTH
 }
 
 bool StopTransaction::processErr(const char *code, const char *description, JsonObject details) {
diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
index 896bb8d3..8c115737 100644
--- a/src/MicroOcpp/Version.h
+++ b/src/MicroOcpp/Version.h
@@ -44,4 +44,9 @@ struct ProtocolVersion {
 #define MO_ENABLE_V16_RESERVATION 1
 #endif
 
+// Local Authorization, i.e. feature profile LocalAuthListManagement
+#ifndef MO_ENABLE_LOCAL_AUTH
+#define MO_ENABLE_LOCAL_AUTH 1
+#endif
+
 #endif
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 3ec90055..27aed0d2 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -10,6 +10,7 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
 #include <MicroOcpp/Debug.h>
+#include <MicroOcpp/Version.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
@@ -178,6 +179,7 @@ TEST_CASE( "Configuration Behavior" ) {
         loopback.setOnline(true);
     }
 
+#if MO_ENABLE_LOCAL_AUTH
     SECTION("LocalPreAuthorize") {
         auto configBool = declareConfiguration<bool>("LocalPreAuthorize", true);
         auto authorizationTimeoutInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
@@ -220,6 +222,7 @@ TEST_CASE( "Configuration Behavior" ) {
         endTransaction();
         loopback.setOnline(true);
     }
+#endif //MO_ENABLE_LOCAL_AUTH
 
     mocpp_deinitialize();
 }
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index 47e4d732..99a07689 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -2,6 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_LOCAL_AUTH
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"
@@ -923,3 +927,5 @@ TEST_CASE( "LocalAuth" ) {
 
     mocpp_deinitialize();
 }
+
+#endif //MO_ENABLE_LOCAL_AUTH

From 53465b4cef0809179c6965412996eb92e77ff4ee Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Mon, 20 May 2024 21:05:18 +0200
Subject: [PATCH 485/549] optimize log functions (#304)

* move logging to own compilation unit

* remove obsolete (void)0 statements after MO_DBG

* update changelog

* optimize MO_CUSTOM_CONSOLE method
---
 CHANGELOG.md                                  |  1 +
 CMakeLists.txt                                |  1 +
 src/MicroOcpp.cpp                             |  2 -
 src/MicroOcpp/Core/Configuration.cpp          |  2 -
 .../Core/ConfigurationContainerFlash.cpp      |  1 -
 src/MicroOcpp/Core/FilesystemUtils.cpp        |  1 -
 src/MicroOcpp/Core/FtpMbedTLS.cpp             |  2 -
 src/MicroOcpp/Core/Request.cpp                |  3 -
 src/MicroOcpp/Core/RequestQueue.cpp           |  2 -
 .../Core/RequestQueueStorageStrategy.cpp      |  1 -
 src/MicroOcpp/Core/RequestStore.cpp           |  2 -
 src/MicroOcpp/Debug.cpp                       | 54 +++++++++++++
 src/MicroOcpp/Debug.h                         | 79 ++++++-------------
 src/MicroOcpp/Model/Boot/BootService.cpp      |  1 -
 .../Model/ConnectorBase/Connector.cpp         |  3 -
 src/MicroOcpp/Model/Metering/MeterStore.cpp   |  3 -
 .../Model/Reservation/Reservation.cpp         |  1 -
 .../SmartCharging/SmartChargingService.cpp    |  2 -
 .../Transactions/TransactionDeserialize.cpp   |  1 -
 src/MicroOcpp/Model/Variables/Variable.cpp    |  2 -
 .../Model/Variables/VariableService.cpp       |  2 -
 src/MicroOcpp/Operations/Authorize.cpp        |  1 -
 src/MicroOcpp/Operations/GetConfiguration.cpp |  4 +-
 src/MicroOcpp/Operations/MeterValues.cpp      |  1 -
 src/MicroOcpp/Operations/Reset.cpp            |  1 -
 .../Operations/StatusNotification.cpp         |  2 -
 src/MicroOcpp/Operations/StopTransaction.cpp  |  2 +-
 src/MicroOcpp/Platform.cpp                    |  8 +-
 src/MicroOcpp/Platform.h                      | 35 ++++----
 29 files changed, 108 insertions(+), 112 deletions(-)
 create mode 100644 src/MicroOcpp/Debug.cpp

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3ab0a194..ccca06ca 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -39,6 +39,7 @@
 - Ignore UnlockConnector when handler not set ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
 - Reject ChargingProfile if unit not supported ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
 - Fix building with debug level warn and error
+- Reduce debug output FW size overhead ([#304](https://github.com/matth-x/MicroOcpp/pull/304))
 - Fix transaction freeze in offline mode ([#279](https://github.com/matth-x/MicroOcpp/pull/279), [#287](https://github.com/matth-x/MicroOcpp/pull/287))
 - Fix compilation error caused by `PRId32` ([#279](https://github.com/matth-x/MicroOcpp/pull/279))
 - Don't load FW-mngt. module when no handlers set ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
diff --git a/CMakeLists.txt b/CMakeLists.txt
index fe8120b7..d46d1ecf 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -63,6 +63,7 @@ set(MO_SRC
     src/MicroOcpp/Operations/InstallCertificate.cpp
     src/MicroOcpp/Operations/UnlockConnector.cpp
     src/MicroOcpp/Operations/UpdateFirmware.cpp
+    src/MicroOcpp/Debug.cpp
     src/MicroOcpp/Platform.cpp
     src/MicroOcpp/Core/SimpleRequestFactory.cpp
     src/MicroOcpp/Core/OperationRegistry.cpp
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index a2bb0cdb..d4a62e24 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -445,7 +445,6 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
             res = endTransaction_authorized(idTag, reason, connectorId);
         } else {
             MO_DBG_INFO("endTransaction: idTag doesn't match");
-            (void)0;
         }
     }
     return res;
@@ -977,7 +976,6 @@ void setCertificateStore(std::unique_ptr<MicroOcpp::CertificateStore> certStore)
         certService->setCertificateStore(std::move(certStore));
     } else {
         MO_DBG_ERR("OOM");
-        (void)0;
     }
 }
 #endif //MO_ENABLE_CERT_MGMT
diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index 090c4445..4ef802fa 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -79,7 +79,6 @@ ConfigurationContainer *declareContainer(const char *filename, bool accessible)
 
     if (container->isAccessible() != accessible) {
         MO_DBG_ERR("%s: conflicting accessibility declarations (expect %s)", filename, container->isAccessible() ? "accessible" : "inaccessible");
-        (void)0;
     }
 
     return container.get();
@@ -95,7 +94,6 @@ std::shared_ptr<Configuration> loadConfiguration(TConfig type, const char *key,
             }
             if (container->isAccessible() != accessible) {
                 MO_DBG_ERR("conflicting accessibility for %s", key);
-                (void)0;
             }
             container->loadStaticKey(*config.get(), key);
             return config;
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index 74263b3e..ccffc9dc 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -181,7 +181,6 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                 }
             } else {
                 MO_DBG_ERR("OOM: %s", key);
-                (void)0;
             }
         }
 
diff --git a/src/MicroOcpp/Core/FilesystemUtils.cpp b/src/MicroOcpp/Core/FilesystemUtils.cpp
index 3817b280..df1285fe 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.cpp
+++ b/src/MicroOcpp/Core/FilesystemUtils.cpp
@@ -134,7 +134,6 @@ bool FilesystemUtils::remove_if(std::shared_ptr<FilesystemAdapter> filesystem, s
 
     if (ret != 0) {
         MO_DBG_ERR("ftw_root: %i", ret);
-        (void)0;
     }
 
     return ret == 0;
diff --git a/src/MicroOcpp/Core/FtpMbedTLS.cpp b/src/MicroOcpp/Core/FtpMbedTLS.cpp
index 156ae14c..d8f6cd5c 100644
--- a/src/MicroOcpp/Core/FtpMbedTLS.cpp
+++ b/src/MicroOcpp/Core/FtpMbedTLS.cpp
@@ -411,7 +411,6 @@ void FtpTransferMbedTLS::send_cmd(const char *cmd, const char *arg, bool disable
         MO_DBG_DEBUG("SEND: %s %s", 
                 cmd,
                 !strncmp((char*) cmd, "PASS", strlen("PASS")) ? "***" : arg ? (char*) arg : "");
-        (void)0;
     }
 
     int ret = -1;
@@ -647,7 +646,6 @@ void FtpTransferMbedTLS::process_ctrl() {
             return;
         } else if (!strncmp("200", line, 3)) { //PBSZ -> 0 and PROT -> P accepted
             MO_DBG_INFO("PBSZ/PROT success: %s", line);
-            (void)0;
         } else if (!strncmp("221", line, 3)) { // Server Goodbye
             MO_DBG_DEBUG("closing ctrl connection");
             close_ctrl();
diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index 956f0609..aae5accc 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -308,7 +308,6 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
         }
     } else {
         MO_DBG_ERR("cannot set unique msgID counter");
-        (void)0;
         //skip this step but don't abort restore
     }
 
@@ -330,10 +329,8 @@ bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *
 
     if (success) {
         MO_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), operation->getOperationType());
-        (void)0;
     } else {
         MO_DBG_ERR("restore opNr %i error", opStore->getOpNr());
-        (void)0;
     }
 
     return success;
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index ea809a52..16fa9562 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -242,10 +242,8 @@ void RequestQueue::receiveResponse(JsonArray json) {
         //didn't find matching Request
         if (json[0] == MESSAGE_TYPE_CALLERROR) {
             MO_DBG_DEBUG("Received CALLERROR did not abort a pending operation");
-            (void)0;
         } else {
             MO_DBG_WARN("Received response doesn't match any pending operation");
-            (void)0;
         }
     }
 }
diff --git a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
index a9b61422..26e24aaa 100644
--- a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
+++ b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
@@ -42,7 +42,6 @@ void VolatileRequestQueue::push_back(std::unique_ptr<Request> op) {
 
     if (queue.size() >= MO_OPERATIONCACHE_MAXSIZE) {
         MO_DBG_WARN("unsafe number of cached operations");
-        (void)0;
     }
 
     queue.push_back(std::move(op));
diff --git a/src/MicroOcpp/Core/RequestStore.cpp b/src/MicroOcpp/Core/RequestStore.cpp
index 056bfc9f..601eb34b 100644
--- a/src/MicroOcpp/Core/RequestStore.cpp
+++ b/src/MicroOcpp/Core/RequestStore.cpp
@@ -153,7 +153,6 @@ void RequestStore::advanceOpNr(unsigned int oldOpNr) {
     if (oldOpNr != (unsigned int) opBeginInt->getInt()) {
         if ((oldOpNr + MO_MAX_OPNR - (unsigned int) opBeginInt->getInt()) % MO_MAX_OPNR < 100) {
             MO_DBG_ERR("synchronization failure - try to fix");
-            (void)0;
         } else {
             MO_DBG_ERR("synchronization failure");
             return;
@@ -187,7 +186,6 @@ void RequestStore::advanceOpNr(unsigned int oldOpNr) {
         bool success = filesystem->remove(fn);
         if (!success) {
             MO_DBG_ERR("error deleting %s", fn);
-            (void)0;
         }
     }
 
diff --git a/src/MicroOcpp/Debug.cpp b/src/MicroOcpp/Debug.cpp
new file mode 100644
index 00000000..71f42343
--- /dev/null
+++ b/src/MicroOcpp/Debug.cpp
@@ -0,0 +1,54 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <string.h>
+
+#include <MicroOcpp/Debug.h>
+
+const char *level_label [] = {
+    "",         //MO_DL_NONE 0x00
+    "ERROR",    //MO_DL_ERROR 0x01
+    "warning",  //MO_DL_WARN 0x02
+    "info",     //MO_DL_INFO 0x03
+    "debug",    //MO_DL_DEBUG 0x04
+    "verbose"   //MO_DL_VERBOSE 0x05
+};
+
+#if MO_DBG_FORMAT == MO_DF_MINIMAL
+void mo_dbg_print_prefix(int level, const char *fn, int line) {
+    (void)0;
+}
+
+#elif MO_DBG_FORMAT == MO_DF_COMPACT
+void mo_dbg_print_prefix(int level, const char *fn, int line) {
+        size_t l = strlen(fn);
+        size_t r = l;
+        while (l > 0 && fn[l-1] != '/' && fn[l-1] != '\\') {
+            l--;
+            if (fn[l] == '.') r = l;
+        }
+        MO_CONSOLE_PRINTF("%.*s:%i ", (int) (r - l), fn + l, line);
+}
+
+#elif MO_DBG_FORMAT == MO_DF_FILE_LINE
+void mo_dbg_print_prefix(int level, const char *fn, int line) {
+    size_t l = strlen(fn);
+    while (l > 0 && fn[l-1] != '/' && fn[l-1] != '\\') {
+        l--;
+    }
+    MO_CONSOLE_PRINTF("[MO] %s (%s:%i): ", level_label[level], fn + l, line);
+}
+
+#elif MO_DBG_FORMAT == MO_DF_FULL
+void mo_dbg_print_prefix(int level, const char *fn, int line) {
+    MO_CONSOLE_PRINTF("[MO] %s (%s:%i): ", level_label[level], fn, line);
+}
+
+#else
+#error invalid MO_DBG_FORMAT definition
+#endif
+
+void mo_dbg_print_suffix() {
+    MO_CONSOLE_PRINTF("\n");
+}
diff --git a/src/MicroOcpp/Debug.h b/src/MicroOcpp/Debug.h
index 59b8c227..51e71216 100644
--- a/src/MicroOcpp/Debug.h
+++ b/src/MicroOcpp/Debug.h
@@ -32,81 +32,52 @@
 #define MO_DBG_FORMAT MO_DF_FILE_LINE //default
 #endif
 
+#ifdef __cplusplus
+extern "C" {
+#endif
 
-#if MO_DBG_FORMAT == MO_DF_MINIMAL
-#define MO_DBG(level, X)   \
-    do {                        \
-        MO_CONSOLE_PRINTF X;  \
-        MO_CONSOLE_PRINTF("\n");         \
-    } while (0);
-
-#elif MO_DBG_FORMAT == MO_DF_COMPACT
-#define MO_DBG(level, X)   \
-    do {                        \
-        const char *_mo_file = __FILE__;         \
-        size_t _mo_l = sizeof(__FILE__);         \
-        size_t _mo_r = _mo_l;         \
-        while (_mo_l > 0 && _mo_file[_mo_l-1] != '/' && _mo_file[_mo_l-1] != '\\') {         \
-            _mo_l--;         \
-            if (_mo_file[_mo_l] == '.') _mo_r = _mo_l;         \
-        }         \
-        MO_CONSOLE_PRINTF("%.*s:%i ", (int) (_mo_r - _mo_l), _mo_file + _mo_l,__LINE__);           \
-        MO_CONSOLE_PRINTF X;  \
-        MO_CONSOLE_PRINTF("\n");         \
-    } while (0);
-
-#elif MO_DBG_FORMAT == MO_DF_FILE_LINE
-#define MO_DBG(level, X)   \
-    do {                        \
-        const char *_mo_file = __FILE__;         \
-        size_t _mo_l = sizeof(__FILE__);         \
-        for (; _mo_l > 0 && _mo_file[_mo_l-1] != '/' && _mo_file[_mo_l-1] != '\\'; _mo_l--);         \
-        MO_CONSOLE_PRINTF("[MO] %s (%s:%i): ",level, _mo_file + _mo_l,__LINE__);           \
-        MO_CONSOLE_PRINTF X;  \
-        MO_CONSOLE_PRINTF("\n");         \
-    } while (0);
-
-#elif MO_DBG_FORMAT == MO_DF_FULL
-#define MO_DBG(level, X)   \
-    do {                        \
-        MO_CONSOLE_PRINTF("[MO] %s (%s:%i): ",level, __FILE__,__LINE__);           \
-        MO_CONSOLE_PRINTF X;  \
-        MO_CONSOLE_PRINTF("\n");         \
-    } while (0);
+void mo_dbg_print_prefix(int level, const char *fn, int line);
+void mo_dbg_print_suffix();
 
-#else
-#error invalid MO_DBG_FORMAT definition
+#ifdef __cplusplus
+}
 #endif
 
+#define MO_DBG(level, X) \
+    do { \
+        mo_dbg_print_prefix(level, __FILE__, __LINE__); \
+        MO_CONSOLE_PRINTF X; \
+        mo_dbg_print_suffix(); \
+    } while (0)
 
 #if MO_DBG_LEVEL >= MO_DL_ERROR
-#define MO_DBG_ERR(...) MO_DBG("ERROR",(__VA_ARGS__))
+#define MO_DBG_ERR(...) MO_DBG(MO_DL_ERROR,(__VA_ARGS__))
 #else
-#define MO_DBG_ERR(...)
+#define MO_DBG_ERR(...) ((void)0)
 #endif
 
 #if MO_DBG_LEVEL >= MO_DL_WARN
-#define MO_DBG_WARN(...) MO_DBG("warning",(__VA_ARGS__))
+#define MO_DBG_WARN(...) MO_DBG(MO_DL_WARN,(__VA_ARGS__))
 #else
-#define MO_DBG_WARN(...)
+#define MO_DBG_WARN(...) ((void)0)
 #endif
 
 #if MO_DBG_LEVEL >= MO_DL_INFO
-#define MO_DBG_INFO(...) MO_DBG("info",(__VA_ARGS__))
+#define MO_DBG_INFO(...) MO_DBG(MO_DL_INFO,(__VA_ARGS__))
 #else
-#define MO_DBG_INFO(...)
+#define MO_DBG_INFO(...) ((void)0)
 #endif
 
 #if MO_DBG_LEVEL >= MO_DL_DEBUG
-#define MO_DBG_DEBUG(...) MO_DBG("debug",(__VA_ARGS__))
+#define MO_DBG_DEBUG(...) MO_DBG(MO_DL_DEBUG,(__VA_ARGS__))
 #else
-#define MO_DBG_DEBUG(...)
+#define MO_DBG_DEBUG(...) ((void)0)
 #endif
 
 #if MO_DBG_LEVEL >= MO_DL_VERBOSE
-#define MO_DBG_VERBOSE(...) MO_DBG("verbose",(__VA_ARGS__))
+#define MO_DBG_VERBOSE(...) MO_DBG(MO_DL_VERBOSE,(__VA_ARGS__))
 #else
-#define MO_DBG_VERBOSE(...)
+#define MO_DBG_VERBOSE(...) ((void)0)
 #endif
 
 #ifdef MO_TRAFFIC_OUT
@@ -124,8 +95,8 @@
     } while (0)
 
 #else
-#define MO_DBG_TRAFFIC_OUT(...)
-#define MO_DBG_TRAFFIC_IN(...)
+#define MO_DBG_TRAFFIC_OUT(...) ((void)0)
+#define MO_DBG_TRAFFIC_IN(...)  ((void)0)
 #endif
 
 #endif
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index 68c96fa4..cd89ca66 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -40,7 +40,6 @@ BootService::BootService(Context& context, std::shared_ptr<FilesystemAdapter> fi
     
     if (!preBootTransactionsBool) {
         MO_DBG_ERR("initialization error");
-        (void)0;
     }
 
     //Register message handler for TriggerMessage operation
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index bf8da718..652851c1 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -68,7 +68,6 @@ Connector::Connector(Context& context, int connectorId)
         transaction = model.getTransactionStore()->getLatestTransaction(connectorId);
     } else {
         MO_DBG_ERR("must initialize TxStore before Connector");
-        (void)0;
     }
 }
 
@@ -398,7 +397,6 @@ void Connector::loop() {
             
             if (!transaction) {
                 MO_DBG_ERR("could not begin FreeVend Tx");
-                (void)0;
             }
         }
 
@@ -574,7 +572,6 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
 
             if (tx) {
                 MO_DBG_DEBUG("created silent transaction");
-                (void)0;
             }
         }
     }
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.cpp b/src/MicroOcpp/Model/Metering/MeterStore.cpp
index 7c27308f..f3ebe2bc 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterStore.cpp
@@ -20,7 +20,6 @@ TransactionMeterData::TransactionMeterData(unsigned int connectorId, unsigned in
     
     if (!filesystem) {
         MO_DBG_DEBUG("volatile mode");
-        (void)0;
     }
 }
 
@@ -151,7 +150,6 @@ MeterStore::MeterStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesyst
 
     if (!filesystem) {
         MO_DBG_DEBUG("volatile mode");
-        (void)0;
     }
 }
 
@@ -293,7 +291,6 @@ bool MeterStore::remove(unsigned int connectorId, unsigned int txNr) {
 
     if (success) {
         MO_DBG_DEBUG("Removed meter values for cId %u, txNr %u", connectorId, txNr);
-        (void)0;
     } else {
         MO_DBG_DEBUG("corrupted fs");
     }
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
index 78c40b60..9c596b85 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.cpp
+++ b/src/MicroOcpp/Model/Reservation/Reservation.cpp
@@ -31,7 +31,6 @@ Reservation::Reservation(Model& model, unsigned int slot) : model(model), slot(s
 
     if (!connectorIdInt || !expiryDateRawString || !idTagString || !reservationIdInt || !parentIdTagString) {
         MO_DBG_ERR("initialization failure");
-        (void)0;
     }
 }
 
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index 8f77f3e3..742ca1fa 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -175,7 +175,6 @@ void SmartChargingConnector::loop(){
 void SmartChargingConnector::setSmartChargingOutput(std::function<void(float,float,int)> limitOutput) {
     if (this->limitOutput) {
         MO_DBG_WARN("replacing existing SmartChargingOutput");
-        (void)0;
     }
     this->limitOutput = limitOutput;
 }
@@ -532,7 +531,6 @@ void SmartChargingService::setSmartChargingOutput(unsigned int connectorId, std:
     if (connectorId == 0) {
         if (this->limitOutput) {
             MO_DBG_WARN("replacing existing SmartChargingOutput");
-            (void)0;
         }
         this->limitOutput = limitOutput;
     } else {
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
index 895c1634..0c66ce11 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -240,7 +240,6 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
     MO_DBG_DEBUG("Stop  RPC | req: %i, conf: %i",  tx.getStopSync().isRequested(), tx.getStopSync().isConfirmed());
     if (tx.isSilent()) {
         MO_DBG_DEBUG("          | silent Tx");
-        (void)0;
     }
 
     return true;
diff --git a/src/MicroOcpp/Model/Variables/Variable.cpp b/src/MicroOcpp/Model/Variables/Variable.cpp
index 65ff402e..ac9b10c2 100644
--- a/src/MicroOcpp/Model/Variables/Variable.cpp
+++ b/src/MicroOcpp/Model/Variables/Variable.cpp
@@ -96,11 +96,9 @@ const ComponentId& Variable::getComponentId() const {
 
 void Variable::setInt(int val, AttributeType) {
     MO_DBG_ERR("type err");
-    (void)0;
 }
 void Variable::setBool(bool val, AttributeType) {
     MO_DBG_ERR("type err");
-    (void)0;
 }
 bool Variable::setString(const char *val, AttributeType) {
     MO_DBG_ERR("type err");
diff --git a/src/MicroOcpp/Model/Variables/VariableService.cpp b/src/MicroOcpp/Model/Variables/VariableService.cpp
index 72e4ab52..c77b06a6 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.cpp
+++ b/src/MicroOcpp/Model/Variables/VariableService.cpp
@@ -123,7 +123,6 @@ VariableContainer *VariableService::declareContainer(const char *filename, bool
 
     if (container->isAccessible() != accessible) {
         MO_DBG_ERR("%s: conflicting accessibility declarations (expect %s)", filename, container->isAccessible() ? "accessible" : "inaccessible");
-        (void)0;
     }
 
     return container.get();
@@ -142,7 +141,6 @@ Variable *VariableService::getVariable(Variable::InternalDataType type, const Co
             }
             if (container->isAccessible() != accessible) {
                 MO_DBG_ERR("conflicting accessibility for %s", name);
-                (void)0;
             }
             return variable;
         }
diff --git a/src/MicroOcpp/Operations/Authorize.cpp b/src/MicroOcpp/Operations/Authorize.cpp
index 3bf34528..f3688913 100644
--- a/src/MicroOcpp/Operations/Authorize.cpp
+++ b/src/MicroOcpp/Operations/Authorize.cpp
@@ -18,7 +18,6 @@ Authorize::Authorize(Model& model, const char *idTagIn) : model(model) {
         snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
     } else {
         MO_DBG_WARN("Format violation of idTag. Discard idTag");
-        (void)0;
     }
 }
 
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index 1dbaabb2..be08e9dd 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -89,7 +89,9 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
     }
 
     if (!doc || doc->capacity() < jcapacity) {
-        if (doc) {MO_DBG_ERR("OOM");(void)0;}
+        if (doc) {
+            MO_DBG_ERR("OOM");
+        }
 
         errorCode = "InternalError";
         errorDescription = "Query too big. Try fewer keys";
diff --git a/src/MicroOcpp/Operations/MeterValues.cpp b/src/MicroOcpp/Operations/MeterValues.cpp
index 32fdd96c..b00be35f 100644
--- a/src/MicroOcpp/Operations/MeterValues.cpp
+++ b/src/MicroOcpp/Operations/MeterValues.cpp
@@ -42,7 +42,6 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
             entries.push_back(std::move(entry));
         } else {
             MO_DBG_ERR("Energy meter reading not convertible to JSON");
-            (void)0;
         }
     }
 
diff --git a/src/MicroOcpp/Operations/Reset.cpp b/src/MicroOcpp/Operations/Reset.cpp
index 9f61eaaf..87c8f855 100644
--- a/src/MicroOcpp/Operations/Reset.cpp
+++ b/src/MicroOcpp/Operations/Reset.cpp
@@ -27,7 +27,6 @@ void Reset::processReq(JsonObject payload) {
     if (auto rService = model.getResetService()) {
         if (!rService->getExecuteReset()) {
             MO_DBG_ERR("No reset handler set. Abort operation");
-            (void)0;
             //resetAccepted remains false
         } else {
             if (!rService->getPreReset() || rService->getPreReset()(isHard) || isHard) {
diff --git a/src/MicroOcpp/Operations/StatusNotification.cpp b/src/MicroOcpp/Operations/StatusNotification.cpp
index 81908e8f..94437ca5 100644
--- a/src/MicroOcpp/Operations/StatusNotification.cpp
+++ b/src/MicroOcpp/Operations/StatusNotification.cpp
@@ -37,7 +37,6 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
 #endif
         default:
             MO_DBG_ERR("ChargePointStatus not specified");
-            (void)0;
             /* fall through */
         case (ChargePointStatus::NOT_SET):
             return "NOT_SET";
@@ -51,7 +50,6 @@ StatusNotification::StatusNotification(int connectorId, ChargePointStatus curren
     
     if (currentStatus != ChargePointStatus::NOT_SET) {
         MO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
-        (void)0;
     }
 }
 
diff --git a/src/MicroOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
index 8cee8615..e2df5442 100644
--- a/src/MicroOcpp/Operations/StopTransaction.cpp
+++ b/src/MicroOcpp/Operations/StopTransaction.cpp
@@ -124,7 +124,7 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
             transaction->setStopTimestamp(transaction->getStartTimestamp() + 1); //1s behind startTime to keep order in backend DB
         } else {
             MO_DBG_ERR("failed to determine StopTx timestamp");
-            (void)0; //send invalid value
+            //send invalid value
         }
     }
 
diff --git a/src/MicroOcpp/Platform.cpp b/src/MicroOcpp/Platform.cpp
index c05ac8e0..df3635e9 100644
--- a/src/MicroOcpp/Platform.cpp
+++ b/src/MicroOcpp/Platform.cpp
@@ -6,13 +6,15 @@
 
 #ifdef MO_CUSTOM_CONSOLE
 
+char _mo_console_msg_buf [MO_CUSTOM_CONSOLE_MAXMSGSIZE];
+
 namespace MicroOcpp {
 void (*mocpp_console_out_impl)(const char *msg) = nullptr;
 }
 
-void MicroOcpp::mocpp_console_out(const char *msg) {
-    if (mocpp_console_out_impl) {
-        mocpp_console_out_impl(msg);
+void _mo_console_out(const char *msg) {
+    if (MicroOcpp::mocpp_console_out_impl) {
+        MicroOcpp::mocpp_console_out_impl(msg);
     }
 }
 
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index eb0c5a2b..9f65e3f5 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -5,12 +5,6 @@
 #ifndef MO_PLATFORM_H
 #define MO_PLATFORM_H
 
-#ifdef __cplusplus
-#define EXT_C extern "C"
-#else
-#define EXT_C
-#endif
-
 #define MO_PLATFORM_NONE    0
 #define MO_PLATFORM_ARDUINO 1
 #define MO_PLATFORM_ESPIDF  2
@@ -30,25 +24,32 @@
 #endif
 
 #ifdef MO_CUSTOM_CONSOLE
-#include <cstdio>
+#include <stdio.h>
 
 #ifndef MO_CUSTOM_CONSOLE_MAXMSGSIZE
 #define MO_CUSTOM_CONSOLE_MAXMSGSIZE 192
 #endif
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern char _mo_console_msg_buf [MO_CUSTOM_CONSOLE_MAXMSGSIZE]; //define msg_buf in data section to save memory (see https://github.com/matth-x/MicroOcpp/pull/304)
+void _mo_console_out(const char *msg);
+
 void mocpp_set_console_out(void (*console_out)(const char *msg));
 
-namespace MicroOcpp {
-void mocpp_console_out(const char *msg);
+#ifdef __cplusplus
 }
+#endif
+
 #define MO_CONSOLE_PRINTF(X, ...) \
             do { \
-                char msg [MO_CUSTOM_CONSOLE_MAXMSGSIZE]; \
-                auto _mo_ret = snprintf(msg, MO_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__); \
+                auto _mo_ret = snprintf(_mo_console_msg_buf, MO_CUSTOM_CONSOLE_MAXMSGSIZE, X, ##__VA_ARGS__); \
                 if (_mo_ret < 0 || _mo_ret >= MO_CUSTOM_CONSOLE_MAXMSGSIZE) { \
-                    sprintf(msg + MO_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
+                    sprintf(_mo_console_msg_buf + MO_CUSTOM_CONSOLE_MAXMSGSIZE - 7, " [...]"); \
                 } \
-                MicroOcpp::mocpp_console_out(msg); \
+                _mo_console_out(_mo_console_msg_buf); \
             } while (0)
 #else
 #define mocpp_set_console_out(X) \
@@ -76,9 +77,9 @@ void mocpp_console_out(const char *msg);
 #endif
 
 #ifdef MO_CUSTOM_TIMER
-void mocpp_set_timer(unsigned long (*get_ms)());
+extern "C" void mocpp_set_timer(unsigned long (*get_ms)());
 
-unsigned long mocpp_tick_ms_custom();
+extern "C" unsigned long mocpp_tick_ms_custom();
 #define mocpp_tick_ms mocpp_tick_ms_custom
 #else
 
@@ -86,10 +87,10 @@ unsigned long mocpp_tick_ms_custom();
 #include <Arduino.h>
 #define mocpp_tick_ms millis
 #elif MO_PLATFORM == MO_PLATFORM_ESPIDF
-unsigned long mocpp_tick_ms_espidf();
+extern "C" unsigned long mocpp_tick_ms_espidf();
 #define mocpp_tick_ms mocpp_tick_ms_espidf
 #elif MO_PLATFORM == MO_PLATFORM_UNIX
-unsigned long mocpp_tick_ms_unix();
+extern "C" unsigned long mocpp_tick_ms_unix();
 #define mocpp_tick_ms mocpp_tick_ms_unix
 #endif
 #endif

From e879c0e6988d7946959ce8cf18e05c4b623d21ba Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 21 May 2024 16:48:12 +0200
Subject: [PATCH 486/549] prepare v1.1.0 release (#306)

* increase dbg msg buf size, clean up

* more concise build flag MO_ENABLE_RESERVATION

* update docs

* advance version to v1.1.0

* fix compiler warnings

* clean CMakeLists.txt

* update release date

* update example, fix compilation error

* update dependencies
---
 .github/workflows/esp-idf.yml                 |  2 +-
 CHANGELOG.md                                  |  4 +-
 CMakeLists.txt                                | 13 ++---
 README.md                                     |  4 +-
 docs/migration.md                             | 23 ++++++--
 examples/ESP-TLS/main.cpp                     | 53 ++++++++-----------
 library.json                                  | 15 +++---
 library.properties                            |  2 +-
 src/MicroOcpp.cpp                             |  6 +--
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp  |  2 +-
 src/MicroOcpp/Core/FtpMbedTLS.cpp             | 11 ++--
 src/MicroOcpp/Core/Time.cpp                   |  2 +-
 src/MicroOcpp/Model/Authorization/IdToken.cpp |  6 +--
 .../Model/Certificates/CertificateMbedTLS.cpp |  1 -
 .../Model/ConnectorBase/Connector.cpp         | 14 ++---
 .../Model/Metering/MeteringConnector.cpp      |  2 +-
 src/MicroOcpp/Model/Model.cpp                 | 12 ++---
 src/MicroOcpp/Model/Model.h                   | 12 ++---
 .../Model/Reservation/Reservation.cpp         |  4 +-
 src/MicroOcpp/Model/Reservation/Reservation.h |  4 +-
 .../Model/Reservation/ReservationService.cpp  |  4 +-
 .../Model/Reservation/ReservationService.h    |  4 +-
 .../Operations/CancelReservation.cpp          |  4 +-
 src/MicroOcpp/Operations/CancelReservation.h  |  4 +-
 src/MicroOcpp/Operations/ReserveNow.cpp       |  4 +-
 src/MicroOcpp/Operations/ReserveNow.h         |  4 +-
 src/MicroOcpp/Operations/TransactionEvent.cpp | 12 +++++
 src/MicroOcpp/Platform.h                      |  2 +-
 src/MicroOcpp/Version.h                       |  6 +--
 tests/Reservation.cpp                         |  8 +--
 30 files changed, 131 insertions(+), 113 deletions(-)

diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
index dcbaa166..06710dc2 100644
--- a/.github/workflows/esp-idf.yml
+++ b/.github/workflows/esp-idf.yml
@@ -37,7 +37,7 @@ jobs:
       uses: actions/checkout@v3
       with:
         repository: matth-x/MicroOcppMongoose
-        ref: 92ebea9fe8554999b4d34c6a03fa12c0d9faec48
+        ref: v1.1.0
         path: examples/ESP-IDF/components/MicroOcppMongoose
     - name: Checkout ArduinoJson
       uses: actions/checkout@v3
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ccca06ca..3e7db579 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## [Unreleased]
+## [1.1.0] - 2024-05-21
 
 ### Changed
 
@@ -14,7 +14,7 @@
 
 - File index ([#270](https://github.com/matth-x/MicroOcpp/pull/270))
 - Config `Cst_TxStartOnPowerPathClosed` to put back TxStartPoint ([#271](https://github.com/matth-x/MicroOcpp/pull/271))
-- Build flag `MO_ENABLE_V16_RESERVATION=0` disables Reservation module ([#302](https://github.com/matth-x/MicroOcpp/pull/302))
+- Build flag `MO_ENABLE_RESERVATION=0` disables Reservation module ([#302](https://github.com/matth-x/MicroOcpp/pull/302))
 - Build flag `MO_ENABLE_LOCAL_AUTH=0` disables LocalAuthList module ([#303](https://github.com/matth-x/MicroOcpp/pull/303))
 - Function `bool isConnected()` in `Connection` interface ([#282](https://github.com/matth-x/MicroOcpp/pull/282))
 - Build flags for customizing memory limits of SmartCharging ([#260](https://github.com/matth-x/MicroOcpp/pull/260))
diff --git a/CMakeLists.txt b/CMakeLists.txt
index d46d1ecf..aed0e7a6 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -106,19 +106,18 @@ set(MO_SRC
 if(ESP_PLATFORM)
 
     idf_component_register(SRCS ${MO_SRC}
-                        INCLUDE_DIRS "./src" "../ArduinoJson/src"
-                        PRIV_REQUIRES spiffs)
+        INCLUDE_DIRS "./src" "../ArduinoJson/src"
+        PRIV_REQUIRES spiffs
+    )
 
     target_compile_options(${COMPONENT_TARGET} PUBLIC
         -DMO_PLATFORM=MO_PLATFORM_ESPIDF
-        -DMO_CUSTOM_RESET
-        )
+    )
 
     return()
 endif()
 
-project(MicroOcpp
-        VERSION 0.2.0)
+project(MicroOcpp VERSION 1.1.0)
 
 add_library(MicroOcpp ${MO_SRC})
 
@@ -129,7 +128,6 @@ target_include_directories(MicroOcpp PUBLIC
 
 target_compile_definitions(MicroOcpp PUBLIC
     MO_PLATFORM=MO_PLATFORM_UNIX
-    MO_CUSTOM_RESET
 )
 
 # Unit tests
@@ -181,7 +179,6 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_PLATFORM=MO_PLATFORM_UNIX
     MO_NUMCONNECTORS=3
     MO_CUSTOM_TIMER
-    MO_CUSTOM_RESET
     MO_DBG_LEVEL=MO_DL_DEBUG
     MO_TRAFFIC_OUT
     MO_FILENAME_PREFIX="./mo_store/"
diff --git a/README.md b/README.md
index 05814a92..03a91c47 100644
--- a/README.md
+++ b/README.md
@@ -14,8 +14,6 @@ OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif,
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.micro-ocpp.com](https://www.micro-ocpp.com)
 
-**Updated branches (2024-03-24):** the default branch was renamed from master into main. The develop branch hasn't been used anymore, so it is deleted. This better represents how branches are used in MicroOcpp: active development takes place on main (plus the feature and fixing branches) and the releases are stable versions of this library. To get a release version, checkout a tag, e.g. *v1.0.3*, or download it from GitHub / PlatformIO.
-
 ## Tester / Demo App
 
 *Main repository: [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)*
@@ -71,7 +69,7 @@ If using the built-in certificate store (to enable, set build flag `MO_ENABLE_MB
 
 - [Mbed-TLS/mbedtls](https://github.com/Mbed-TLS/mbedtls) (version `2.28.1`)
 
-In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp@1.0.3` in the PIO library manager.
+In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp@1.1.0` in the PIO library manager.
 
 ## OCPP 2.0.1 and ISO 15118
 
diff --git a/docs/migration.md b/docs/migration.md
index 88a1cf66..49cc82dd 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -1,8 +1,25 @@
-# Migrating to v1.0
+# Migrating to v1.1
+
+As a new minor version, all features should work the same as in v1.0 and existing integrations are mostly backwards compatible. However, some fixes / cleanup steps in MicroOcpp require syntactic changes or special consideration when upgrading from v1.0 to v1.1. The known pitfalls are as follows:
+
+- The default branch has been renamed from `master` into `main`
+- Need to include extra headers: the transitive includes have been cleaned a bit. Probably it's necessary to add more includes next to `#include <MicroOcpp.h>`. E.g.<br/>`#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>`<br/>`#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>`
+- `ocppPermitsCharge()` does not consider failures reported by the charger anymore. Before v1.1 it was possible to report failures to MicroOcpp using ErrorCodeInputs and then to rely on `ocppPermitsCharge()` becoming false when a failure occurs. For backwards compatibility, complement any occurence to `ocppPermitsCharge() && !isFaulted()`
+- `setEnergyMeterInput` changed the expected return type of the callback function from `float` to `int` (see [#301](https://github.com/matth-x/MicroOcpp/pull/301))
+- The return type of the UnlockConnector handler also changed from `PollResult<bool>` to enum `UnlockConnectorResult` (see [#271](https://github.com/matth-x/MicroOcpp/pull/271))
+
+If upgrading MicroOcppMongoose at the same time, then the following changes are very important to consider:
+
+- Certificates are no longer copied into heap memory, but the MO-Mongoose class takes the passed certificate pointer as a zero-copy parameter. The string behind the passed pointer must outlive the MO-Mongoose class (see [#10](https://github.com/matth-x/MicroOcppMongoose/pull/10))
+- WebSocket authorization keys are no longer stored as c-strings, but as `unsigned char` buffers. For backwards compatibility, a null-byte is still appended and the buffer can be accessed as c-string, but this should be tested in existing deployments. Furtermore, MicroOcpp only accepts hex-encoded keys coming via ChangeConfiguration which is mandated by the standard. This also may break existing deployments (see [#4](https://github.com/matth-x/MicroOcppMongoose/pull/4)).
+
+If accessing the MicroOcpp modules directly (i.e. not over `MicroOcpp.h` or `MicroOcpp_c.h`) then there are likely some more modifications to be done. See the history of pull requests where each change to the code is documented. However, if the existing integration compiles under the new MO version, then there shouldn't be too many unexpected incompatibilities.
+
+## Migrating to v1.0
 
 The API has been continously improved to best suit the common use cases for MicroOcpp. Moreover, the project has been given a new name to prevent confusion with the relation to the Arduino platform and to reflect the project goals properly. With the new project name, the API has been frozen for the v1.0 release.
 
-## Adopting the new project name in existing projects
+### Adopting the new project name in existing projects
 
 Find and replace the keywords in the following.
 
@@ -30,7 +47,7 @@ If using the C-facade, change this as the final step:
 
 - `ao_` to `ocpp_`
 
-## Further API changes to consider
+### Further API changes to consider
 
 In addition to the new project name, the API has also been reworked for more consistency. After renaming the existing project as described above, also take a look at the [changelogs](https://github.com/matth-x/MicroOcpp/blob/1.0.x/CHANGELOG.md) (see Section Changed for v1.0.0).
 
diff --git a/examples/ESP-TLS/main.cpp b/examples/ESP-TLS/main.cpp
index 963332f4..7c4c7c1b 100644
--- a/examples/ESP-TLS/main.cpp
+++ b/examples/ESP-TLS/main.cpp
@@ -14,25 +14,18 @@ ESP8266WiFiMulti WiFiMulti;
 #endif
 
 #include <MicroOcpp.h>
-#include <MicroOcpp/Core/Connection.h> //need for setting TLS credentials
 
-#define STASSID  "YOUR_WIFI_SSID"
-#define STAPSK   "YOUR_WIFI_PW"
+#define STASSID "YOUR_WIFI_SSID"
+#define STAPSK  "YOUR_WIFI_PW"
 
-#define OCPP_HOST  "echo.websocket.events"
-#define OCPP_PORT  443
-#define OCPP_URL   "wss://echo.websocket.events/"
+#define OCPP_BACKEND_URL   "wss://echo.websocket.events"
+#define OCPP_CHARGE_BOX_ID ""
+#define OCPP_AUTH_KEY      "SecureAuthKey" // OCPP Security Profile 2: TLS with Basic Authentication
 
 /*
- * OCPP Security Profile 2: TLS with Basic Authentication
- *
- * Example credentials from the OCPP-JSON document (p. 16)
+ * ISRG ROOT X1
  */
-#define OCPP_AUTH_ID  "AL1000"
-#define OCPP_AUTH_KEY "0001020304050607FFFFFFFFFFFFFFFFFFFFFFFF"
-
-const char ENDPOINT_CA_CERT[] PROGMEM = R"EOF(
------BEGIN CERTIFICATE-----
+const char ca_cert[] PROGMEM = R"EOF(-----BEGIN CERTIFICATE-----
 MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
 TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
 cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
@@ -65,9 +58,6 @@ emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
 -----END CERTIFICATE-----
 )EOF";
 
-WebSocketsClient wsockSecure {};
-MicroOcpp::EspWiFi::WSClient osockSecure {&wsockSecure};
-
 void setup() {
 
     /*
@@ -76,7 +66,7 @@ void setup() {
 
     Serial.begin(115200);
 
-    Serial.print(F("[main] Wait for WiFi "));
+    Serial.print(F("[main] Wait for WiFi: "));
 
 #if defined(ESP8266)
     WiFiMulti.addAP(STASSID, STAPSK);
@@ -87,12 +77,14 @@ void setup() {
 #elif defined(ESP32)
     WiFi.begin(STASSID, STAPSK);
     while (!WiFi.isConnected()) {
-        delay(1000);
         Serial.print('.');
+        delay(1000);
     }
+#else
+#error only ESP32 or ESP8266 supported at the moment
 #endif
 
-    Serial.print(F(" connected\n"));
+    Serial.println(F(" connected!"));
 
     /*
      * Set system time (required for Certificate validation)
@@ -108,23 +100,22 @@ void setup() {
     Serial.printf(" finished. Unix timestamp is %lu\n", now);
     
     /*
-     * Connect to OCPP Central System (using OCPP Security Profile 2: TLS with Basic Authentication )
+     * Initialize the OCPP library (using OCPP Security Profile 2: TLS with Basic Authentication)
      */
-    wsockSecure.beginSslWithCA(OCPP_HOST,
-                    OCPP_PORT,
-                    OCPP_URL,
-                    ENDPOINT_CA_CERT, "ocpp1.6");
-    wsockSecure.setReconnectInterval(5000);
-    wsockSecure.enableHeartbeat(15000, 3000, 2);
-    wsockSecure.setAuthorization(OCPP_AUTH_ID, OCPP_AUTH_KEY); // => Authorization: Basic QUwxMDAwOgABAgMEBQYH////////////////
-    
-    mocpp_initialize(osockSecure, ChargerCredentials("My Charging Station", "My company name"));
+    mocpp_initialize(
+            OCPP_BACKEND_URL,
+            OCPP_CHARGE_BOX_ID,
+            "My Charging Station",
+            "My company name",
+            MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail,
+            OCPP_AUTH_KEY,
+            ca_cert);
 
     /*
      * ... see MicroOcpp.h for how to integrate the EVSE hardware.
      *
      * This example only showcases the TLS connection. For examples about the HW integration,
-     * please see the other examples
+     * see the other examples
      */
 }
 
diff --git a/library.json b/library.json
index 37b51377..0319c846 100644
--- a/library.json
+++ b/library.json
@@ -1,6 +1,6 @@
 {
     "name": "MicroOcpp",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "description": "OCPP 1.6 Client for microcontrollers",
     "keywords": "OCPP, 1.6, OCPP 1.6, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, esp-idf, EVSE, Charge Point",
     "repository":
@@ -36,17 +36,18 @@
     "export": {
         "include":
         [
-            "src/*",
+            "docs/*",
             "examples/*",
-            "platformio.ini",
+            "src/*",
+            "CHANGELOG.md",
+            "CMakeLists.txt",
             "library.json",
             "library.properties",
-            "README.md",
-            "CMakeLists.txt",
-            "docs/*",
             "LICENSE",
             "mkdocs.yml",
-            "CHANGELOG.md"
+            "platformio.ini",
+            "README.md",
+            "SConscript.py"
         ]
     },
 
diff --git a/library.properties b/library.properties
index b9c4637e..b17f41a7 100644
--- a/library.properties
+++ b/library.properties
@@ -1,5 +1,5 @@
 name=MicroOcpp
-version=1.0.0
+version=1.1.0
 author=Matthias Akstaller
 maintainer=Matthias Akstaller
 sentence=OCPP 1.6 Client for microcontrollers
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index d4a62e24..a162cd3d 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -293,7 +293,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new AuthorizationService(*context, filesystem)));
 #endif //MO_ENABLE_LOCAL_AUTH
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
     model.setReservationService(std::unique_ptr<ReservationService>(
         new ReservationService(*context, MO_NUMCONNECTORS)));
 #endif
@@ -583,8 +583,8 @@ void setEnergyMeterInput(std::function<int()> energyInput, unsigned int connecto
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Energy.Active.Import.Register");
     meterProperties.setUnit("Wh");
-    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int, SampledValueDeSerializer<int>>>(
-                           new SampledValueSamplerConcrete<int, SampledValueDeSerializer<int>>(
+    auto mvs = std::unique_ptr<SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>>(
+                           new SampledValueSamplerConcrete<int32_t, SampledValueDeSerializer<int32_t>>(
             meterProperties,
             [energyInput] (ReadingContext) {return energyInput();}
     ));
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index 82551d5b..9307cd40 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -243,7 +243,7 @@ std::unique_ptr<Configuration> makeConfiguration(TConfig type, const char *key)
     }
     res->setKey(key);
     return res;
-};
+}
 
 bool deserializeTConfig(const char *serialized, TConfig& out) {
     if (!strcmp(serialized, "int")) {
diff --git a/src/MicroOcpp/Core/FtpMbedTLS.cpp b/src/MicroOcpp/Core/FtpMbedTLS.cpp
index d8f6cd5c..f5399d12 100644
--- a/src/MicroOcpp/Core/FtpMbedTLS.cpp
+++ b/src/MicroOcpp/Core/FtpMbedTLS.cpp
@@ -162,7 +162,7 @@ void mo_mbedtls_log(void *user, int level, const char *file, int line, const cha
  */
 
 FtpTransferMbedTLS::FtpTransferMbedTLS(bool tls_only, const char *client_cert, const char *client_key) 
-        : isSecure(tls_only), client_cert(client_cert), client_key(client_key) {
+        : client_cert(client_cert), client_key(client_key), isSecure(tls_only) {
     mbedtls_net_init(&ctrl_fd);
     mbedtls_ssl_init(&ctrl_ssl);
     mbedtls_net_init(&data_fd);
@@ -369,7 +369,8 @@ void FtpTransferMbedTLS::close_data() {
 
 int FtpTransferMbedTLS::handshake_tls() {
 
-    while (auto ret = mbedtls_ssl_handshake(&ctrl_ssl) != 0) {
+    int ret;
+    while ((ret = mbedtls_ssl_handshake(&ctrl_ssl)) != 0) {
         if (ret != MBEDTLS_ERR_SSL_WANT_READ && ret != MBEDTLS_ERR_SSL_WANT_WRITE && ret != 1) {
             char buf [1024];
             mbedtls_strerror(ret, (char *) buf, 1024);
@@ -381,7 +382,7 @@ int FtpTransferMbedTLS::handshake_tls() {
     if (ca_cert) {
         //certificate validation enabled
 
-        if (auto ret = mbedtls_ssl_get_verify_result(&ctrl_ssl) != 0) {
+        if ((ret = mbedtls_ssl_get_verify_result(&ctrl_ssl)) != 0) {
             char vrfy_buf[512];
             mbedtls_x509_crt_verify_info(vrfy_buf, sizeof(vrfy_buf), "   > ", ret);
             MO_DBG_ERR("mbedtls_ssl_get_verify_result: %i, %s", ret, vrfy_buf);
@@ -403,7 +404,7 @@ void FtpTransferMbedTLS::send_cmd(const char *cmd, const char *arg, bool disable
             cmd,               //cmd mandatory (e.g. "USER")
             arg ? " " : "",    //line spacing if arg is provided
             arg ? arg : "");   //arg optional (e.g. "anonymous")
-    if (len < 0 || len >= MSG_SIZE) {
+    if (len < 0 || (size_t)len >= MSG_SIZE) {
         MO_DBG_ERR("could not write cmd, send QUIT instead");
         len = sprintf((char*) msg, "QUIT\r\n");
     } else {
@@ -883,7 +884,7 @@ bool FtpTransferMbedTLS::read_url_data(const char *data_url_raw) {
 }
 
 FtpClientMbedTLS::FtpClientMbedTLS(bool tls_only, const char *client_cert, const char *client_key)
-        : tls_only(tls_only), client_cert(client_cert), client_key(client_key) {
+        : client_cert(client_cert), client_key(client_key), tls_only(tls_only) {
 
 }
 
diff --git a/src/MicroOcpp/Core/Time.cpp b/src/MicroOcpp/Core/Time.cpp
index e2e38ae6..58cc0ed6 100644
--- a/src/MicroOcpp/Core/Time.cpp
+++ b/src/MicroOcpp/Core/Time.cpp
@@ -190,7 +190,7 @@ Timestamp &Timestamp::operator+=(int secs) {
     }
 
     return *this;
-};
+}
 
 Timestamp &Timestamp::addMilliseconds(int val) {
 
diff --git a/src/MicroOcpp/Model/Authorization/IdToken.cpp b/src/MicroOcpp/Model/Authorization/IdToken.cpp
index b13eb516..8983c5cd 100644
--- a/src/MicroOcpp/Model/Authorization/IdToken.cpp
+++ b/src/MicroOcpp/Model/Authorization/IdToken.cpp
@@ -70,6 +70,9 @@ const char *IdToken::get() const {
 const char *IdToken::getTypeCstr() const {
     const char *res = nullptr;
     switch (type) {
+        case Type::UNDEFINED:
+            MO_DBG_ERR("internal error");
+            break;
         case Type::Central:
             res = "Central";
             break;
@@ -96,9 +99,6 @@ const char *IdToken::getTypeCstr() const {
             break;
     }
 
-    if (!res) {
-        MO_DBG_ERR("internal error");
-    }
     return res ? res : "";
 }
 
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
index fe7400a7..05609f80 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
@@ -178,7 +178,6 @@ class CertificateStoreMbedTLS : public CertificateStore {
 
         if (!success) {
             MO_DBG_ERR("could not read cert: %s", fn);
-            (void)0;
         }
 
         delete[] buf;
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 652851c1..8fb4578e 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -112,7 +112,7 @@ ChargePointStatus Connector::getStatus() {
             res = ChargePointStatus::Charging;
         }
     }
-    #if MO_ENABLE_V16_RESERVATION
+    #if MO_ENABLE_RESERVATION
     else if (model.getReservationService() && model.getReservationService()->getReservation(connectorId)) {
         res = ChargePointStatus::Reserved;
     }
@@ -622,7 +622,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     bool offlineBlockedResv = false; //if offline authorization will be blocked by reservation
 
     //check if blocked by reservation
-    #if MO_ENABLE_V16_RESERVATION
+    #if MO_ENABLE_RESERVATION
     if (model.getReservationService()) {
 
         auto reservation = model.getReservationService()->getReservation(
@@ -655,7 +655,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
     }
     #else
     (void)parentIdTag;
-    #endif //MO_ENABLE_V16_RESERVATION
+    #endif //MO_ENABLE_RESERVATION
 
     transaction = allocateTransaction();
 
@@ -708,7 +708,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             return;
         }
 
-        #if MO_ENABLE_V16_RESERVATION
+        #if MO_ENABLE_RESERVATION
         if (model.getReservationService()) {
             auto reservation = model.getReservationService()->getReservation(
                         connectorId,
@@ -731,7 +731,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                 }
             }
         }
-        #endif //MO_ENABLE_V16_RESERVATION
+        #endif //MO_ENABLE_RESERVATION
 
         MO_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
         tx->setAuthorized();
@@ -826,7 +826,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
 
     transaction->setAuthorized();
 
-    #if MO_ENABLE_V16_RESERVATION
+    #if MO_ENABLE_RESERVATION
     if (model.getReservationService()) {
         if (auto reservation = model.getReservationService()->getReservation(connectorId, idTag, parentIdTag)) {
             if (reservation->matches(idTag, parentIdTag)) {
@@ -834,7 +834,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
             }
         }
     }
-    #endif //MO_ENABLE_V16_RESERVATION
+    #endif //MO_ENABLE_RESERVATION
 
     transaction->commit();
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index f76a8d79..07444600 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -59,7 +59,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
     if ((txBreak || meterData.size() >= (size_t) meterValueCacheSizeInt->getInt()) && !meterData.empty()) {
         auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(std::move(meterData), connectorId, transaction));
         meterData.clear();
-        return std::move(meterValues);
+        return std::move(meterValues); //std::move is required for some compilers even if it's not mandated by standard C++
     }
 
     if (model.getConnector(connectorId)) {
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 91b21126..a98ab72f 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -70,10 +70,10 @@ void Model::loop() {
     if (firmwareService)
         firmwareService->loop();
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
     if (reservationService)
         reservationService->loop();
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 
     if (resetService)
         resetService->loop();
@@ -175,7 +175,7 @@ AuthorizationService *Model::getAuthorizationService() {
 }
 #endif //MO_ENABLE_LOCAL_AUTH
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 void Model::setReservationService(std::unique_ptr<ReservationService> rs) {
     reservationService = std::move(rs);
     capabilitiesUpdated = true;
@@ -184,7 +184,7 @@ void Model::setReservationService(std::unique_ptr<ReservationService> rs) {
 ReservationService *Model::getReservationService() {
     return reservationService.get();
 }
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 
 void Model::setBootService(std::unique_ptr<BootService> bs){
     bootService = std::move(bs);
@@ -294,14 +294,14 @@ void Model::updateSupportedStandardProfiles() {
     }
 #endif //MO_ENABLE_LOCAL_AUTH
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
     if (reservationService) {
         if (!strstr(supportedFeatureProfilesString->getString(), "Reservation")) {
             if (!buf.empty()) buf += ',';
             buf += "Reservation";
         }
     }
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 
     if (smartChargingService) {
         if (!strstr(supportedFeatureProfilesString->getString(), "SmartCharging")) {
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 233aa114..fd93faba 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -27,9 +27,9 @@ class ResetService;
 class AuthorizationService;
 #endif //MO_ENABLE_LOCAL_AUTH
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 class ReservationService;
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 
 #if MO_ENABLE_CERT_MGMT
 class CertificateService;
@@ -61,9 +61,9 @@ class Model {
     std::unique_ptr<AuthorizationService> authorizationService;
 #endif //MO_ENABLE_LOCAL_AUTH
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
     std::unique_ptr<ReservationService> reservationService;
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 
 #if MO_ENABLE_CERT_MGMT
     std::unique_ptr<CertificateService> certService;
@@ -124,10 +124,10 @@ class Model {
     AuthorizationService *getAuthorizationService();
 #endif //MO_ENABLE_LOCAL_AUTH
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
     void setReservationService(std::unique_ptr<ReservationService> reservationService);
     ReservationService *getReservationService();
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 
     void setBootService(std::unique_ptr<BootService> bs);
     BootService *getBootService() const;
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
index 9c596b85..e16618ff 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.cpp
+++ b/src/MicroOcpp/Model/Reservation/Reservation.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp/Version.h>
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 
 #include <MicroOcpp/Model/Reservation/Reservation.h>
 #include <MicroOcpp/Model/Model.h>
@@ -134,4 +134,4 @@ void Reservation::clear() {
     configuration_save();
 }
 
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.h b/src/MicroOcpp/Model/Reservation/Reservation.h
index 9747d74e..dba888e6 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.h
+++ b/src/MicroOcpp/Model/Reservation/Reservation.h
@@ -7,7 +7,7 @@
 
 #include <MicroOcpp/Version.h>
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/Time.h>
@@ -69,5 +69,5 @@ class Reservation {
 
 }
 
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 #endif
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index 41c185de..f152a29d 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp/Version.h>
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 #include <MicroOcpp/Core/Context.h>
@@ -215,4 +215,4 @@ bool ReservationService::updateReservation(int reservationId, unsigned int conne
     return false;
 }
 
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.h b/src/MicroOcpp/Model/Reservation/ReservationService.h
index d33d4246..2d052594 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.h
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.h
@@ -7,7 +7,7 @@
 
 #include <MicroOcpp/Version.h>
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 
 #include <MicroOcpp/Model/Reservation/Reservation.h>
 
@@ -48,5 +48,5 @@ class ReservationService {
 
 }
 
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 #endif
diff --git a/src/MicroOcpp/Operations/CancelReservation.cpp b/src/MicroOcpp/Operations/CancelReservation.cpp
index 4b1929e0..b0a6206a 100644
--- a/src/MicroOcpp/Operations/CancelReservation.cpp
+++ b/src/MicroOcpp/Operations/CancelReservation.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp/Version.h>
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 
 #include <MicroOcpp/Operations/CancelReservation.h>
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
@@ -43,4 +43,4 @@ std::unique_ptr<DynamicJsonDocument> CancelReservation::createConf(){
     return doc;
 }
 
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
diff --git a/src/MicroOcpp/Operations/CancelReservation.h b/src/MicroOcpp/Operations/CancelReservation.h
index 3b0312c4..4a8dec1f 100644
--- a/src/MicroOcpp/Operations/CancelReservation.h
+++ b/src/MicroOcpp/Operations/CancelReservation.h
@@ -7,7 +7,7 @@
 
 #include <MicroOcpp/Version.h>
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 
 #include <MicroOcpp/Core/Operation.h>
 
@@ -37,5 +37,5 @@ class CancelReservation : public Operation {
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
 
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 #endif
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index 7e3a2c0e..17e6a15a 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp/Version.h>
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 
 #include <MicroOcpp/Operations/ReserveNow.h>
 #include <MicroOcpp/Model/Model.h>
@@ -128,4 +128,4 @@ std::unique_ptr<DynamicJsonDocument> ReserveNow::createConf(){
     return doc;
 }
 
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
diff --git a/src/MicroOcpp/Operations/ReserveNow.h b/src/MicroOcpp/Operations/ReserveNow.h
index 92cb717d..e907a716 100644
--- a/src/MicroOcpp/Operations/ReserveNow.h
+++ b/src/MicroOcpp/Operations/ReserveNow.h
@@ -7,7 +7,7 @@
 
 #include <MicroOcpp/Version.h>
 
-#if MO_ENABLE_V16_RESERVATION
+#if MO_ENABLE_RESERVATION
 
 #include <MicroOcpp/Core/Operation.h>
 
@@ -39,5 +39,5 @@ class ReserveNow : public Operation {
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
 
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION
 #endif
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
index 13393a43..2ff45e13 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.cpp
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -85,6 +85,9 @@ std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
 
     const char *triggerReason = "";
     switch(txEvent->triggerReason) {
+        case TransactionEventTriggerReason::UNDEFINED:
+            MO_DBG_ERR("internal error");
+            break;
         case TransactionEventTriggerReason::Authorized:
             triggerReason = "Authorized";
             break;
@@ -175,6 +178,9 @@ std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
 
     const char *chargingState = nullptr;
     switch (txEvent->chargingState) {
+        case TransactionEventData::ChargingState::UNDEFINED:
+            // optional, okay
+            break;
         case TransactionEventData::ChargingState::Charging:
             chargingState = "Charging";
             break;
@@ -197,6 +203,12 @@ std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
 
     const char *stoppedReason = nullptr;
     switch (txEvent->transaction->stopReason) {
+        case Transaction::StopReason::UNDEFINED:
+            // optional, okay
+            break;
+        case Transaction::StopReason::Local: 
+            // omit reason Local
+            break;
         case Transaction::StopReason::DeAuthorized: 
             stoppedReason = "DeAuthorized"; 
             break;
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index 9f65e3f5..479bd087 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -27,7 +27,7 @@
 #include <stdio.h>
 
 #ifndef MO_CUSTOM_CONSOLE_MAXMSGSIZE
-#define MO_CUSTOM_CONSOLE_MAXMSGSIZE 192
+#define MO_CUSTOM_CONSOLE_MAXMSGSIZE 256
 #endif
 
 #ifdef __cplusplus
diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
index 8c115737..0a9770f1 100644
--- a/src/MicroOcpp/Version.h
+++ b/src/MicroOcpp/Version.h
@@ -39,9 +39,9 @@ struct ProtocolVersion {
 #define MO_ENABLE_CERT_MGMT MO_ENABLE_V201
 #endif
 
-// Reservations, OCPP 1.6 implementation
-#ifndef MO_ENABLE_V16_RESERVATION
-#define MO_ENABLE_V16_RESERVATION 1
+// Reservations
+#ifndef MO_ENABLE_RESERVATION
+#define MO_ENABLE_RESERVATION 1
 #endif
 
 // Local Authorization, i.e. feature profile LocalAuthListManagement
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index 34e7195b..09101ba2 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -2,6 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_RESERVATION
+
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include "./catch2/catch.hpp"
@@ -16,8 +20,6 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Model/Reservation/ReservationService.h>
 
-#if MO_ENABLE_V16_RESERVATION
-
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 
@@ -511,4 +513,4 @@ TEST_CASE( "Reservation" ) {
     mocpp_deinitialize();
 }
 
-#endif //MO_ENABLE_V16_RESERVATION
+#endif //MO_ENABLE_RESERVATION

From a72104e8d28b264db15228d8702b8537f7d5e4fa Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Wed, 29 May 2024 11:53:43 +0200
Subject: [PATCH 487/549] expose ChargePointStatus in API (#309)

* provide ChargePointStatus in API

* change ChargePointStatus into C-style enum

* update version statement
---
 CHANGELOG.md                                  | 10 ++
 CMakeLists.txt                                |  2 +-
 library.json                                  |  2 +-
 library.properties                            |  2 +-
 src/MicroOcpp.cpp                             | 13 +++
 src/MicroOcpp.h                               |  6 ++
 .../Authorization/AuthorizationService.cpp    |  2 +-
 .../Model/ConnectorBase/ChargePointStatus.h   | 38 ++++----
 .../Model/ConnectorBase/Connector.cpp         | 54 +++++------
 src/MicroOcpp/Model/ConnectorBase/Connector.h |  4 +-
 .../Model/ConnectorBase/ConnectorsCommon.cpp  |  2 +-
 .../Model/Reservation/ReservationService.cpp  |  4 +-
 src/MicroOcpp/Model/Reset/ResetService.cpp    |  2 +-
 src/MicroOcpp/Operations/ReserveNow.cpp       | 10 +-
 .../Operations/StatusNotification.cpp         | 28 +++---
 src/MicroOcpp/Operations/StatusNotification.h |  4 +-
 src/MicroOcpp/Version.h                       |  2 +-
 src/MicroOcpp_c.cpp                           |  8 ++
 src/MicroOcpp_c.h                             |  8 +-
 tests/ChargingSessions.cpp                    | 12 +--
 tests/ConfigurationBehavior.cpp               | 30 +++---
 tests/LocalAuthList.cpp                       | 60 ++++++------
 tests/Reservation.cpp                         | 96 +++++++++----------
 tests/Reset.cpp                               | 22 ++---
 24 files changed, 233 insertions(+), 188 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3e7db579..ff9e04e4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## Unreleased
+
+### Changed
+
+- Change `MicroOcpp::ChargePointStatus` into C-style enum ([#309](https://github.com/matth-x/MicroOcpp/pull/309))
+
+### Added
+
+- Provide ChargePointStatus in API ([#309](https://github.com/matth-x/MicroOcpp/pull/309))
+
 ## [1.1.0] - 2024-05-21
 
 ### Changed
diff --git a/CMakeLists.txt b/CMakeLists.txt
index aed0e7a6..46e42ef8 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -117,7 +117,7 @@ if(ESP_PLATFORM)
     return()
 endif()
 
-project(MicroOcpp VERSION 1.1.0)
+project(MicroOcpp VERSION 1.2.0)
 
 add_library(MicroOcpp ${MO_SRC})
 
diff --git a/library.json b/library.json
index 0319c846..6637a297 100644
--- a/library.json
+++ b/library.json
@@ -1,6 +1,6 @@
 {
     "name": "MicroOcpp",
-    "version": "1.1.0",
+    "version": "1.2.0",
     "description": "OCPP 1.6 Client for microcontrollers",
     "keywords": "OCPP, 1.6, OCPP 1.6, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, esp-idf, EVSE, Charge Point",
     "repository":
diff --git a/library.properties b/library.properties
index b17f41a7..8a1a3e01 100644
--- a/library.properties
+++ b/library.properties
@@ -1,5 +1,5 @@
 name=MicroOcpp
-version=1.1.0
+version=1.2.0
 author=Matthias Akstaller
 maintainer=Matthias Akstaller
 sentence=OCPP 1.6 Client for microcontrollers
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index a162cd3d..83451b5a 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -548,6 +548,19 @@ bool ocppPermitsCharge(unsigned int connectorId) {
     return connector->ocppPermitsCharge();
 }
 
+ChargePointStatus getChargePointStatus(unsigned int connectorId) {
+    if (!context) {
+        MO_DBG_WARN("OCPP uninitialized");
+        return ChargePointStatus_UNDEFINED;
+    }
+    auto connector = context->getModel().getConnector(connectorId);
+    if (!connector) {
+        MO_DBG_ERR("could not find connector");
+        return ChargePointStatus_UNDEFINED;
+    }
+    return connector->getStatus();
+}
+
 void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int connectorId) {
     if (!context) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 6b9faefc..0a774ab0 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -17,6 +17,7 @@
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
+#include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <MicroOcpp/Version.h>
 #include <MicroOcpp/Model/Certificates/Certificate.h>
@@ -244,6 +245,11 @@ std::shared_ptr<MicroOcpp::Transaction>& getTransaction(unsigned int connectorId
  */
 bool ocppPermitsCharge(unsigned int connectorId = 1);
 
+/*
+ * Returns the latest ChargePointStatus as reported via StatusNotification (standard OCPP data type)
+ */
+ChargePointStatus getChargePointStatus(unsigned int connectorId = 1);
+
 /*
  * Define the Inputs and Outputs of this library.
  * 
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 3916bc9a..74ee7bb8 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -180,7 +180,7 @@ void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idT
     if (!equivalent) {
         //send error code "LocalListConflict" to server
 
-        ChargePointStatus cpStatus = ChargePointStatus::NOT_SET;
+        ChargePointStatus cpStatus = ChargePointStatus_UNDEFINED;
         if (context.getModel().getNumConnectors() > 0) {
             cpStatus = context.getModel().getConnector(0)->getStatus();
         }
diff --git a/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h b/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
index 4a603577..019fce27 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ChargePointStatus.h
@@ -2,31 +2,35 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef OCPP_EVSE_STATE
-#define OCPP_EVSE_STATE
+#ifndef MO_CHARGEPOINTSTATUS_H
+#define MO_CHARGEPOINTSTATUS_H
 
 #include <MicroOcpp/Version.h>
 
-namespace MicroOcpp {
+#ifdef __cplusplus
+extern "C" {
+#endif
 
-enum class ChargePointStatus {
-    Available,
-    Preparing,
-    Charging,
-    SuspendedEVSE,
-    SuspendedEV,
-    Finishing,
-    Reserved,
-    Unavailable,
-    Faulted,
+typedef enum ChargePointStatus {
+    ChargePointStatus_UNDEFINED, //internal use only - no OCPP standard value 
+    ChargePointStatus_Available,
+    ChargePointStatus_Preparing,
+    ChargePointStatus_Charging,
+    ChargePointStatus_SuspendedEVSE,
+    ChargePointStatus_SuspendedEV,
+    ChargePointStatus_Finishing,
+    ChargePointStatus_Reserved,
+    ChargePointStatus_Unavailable,
+    ChargePointStatus_Faulted
 
 #if MO_ENABLE_V201
-    Occupied,
+    ,ChargePointStatus_Occupied
 #endif
 
-    NOT_SET //internal value for "undefined"
-};
+}   ChargePointStatus;
 
-} //end namespace MicroOcpp
+#ifdef __cplusplus
+}
+#endif
 
 #endif
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 8fb4578e..1fe3d077 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -79,79 +79,79 @@ Connector::~Connector() {
 
 ChargePointStatus Connector::getStatus() {
 
-    ChargePointStatus res = ChargePointStatus::NOT_SET;
+    ChargePointStatus res = ChargePointStatus_UNDEFINED;
 
     /*
     * Handle special case: This is the Connector for the whole CP (i.e. connectorId=0) --> only states Available, Unavailable, Faulted are possible
     */
     if (connectorId == 0) {
         if (isFaulted()) {
-            res = ChargePointStatus::Faulted;
+            res = ChargePointStatus_Faulted;
         } else if (!isOperative()) {
-            res = ChargePointStatus::Unavailable;
+            res = ChargePointStatus_Unavailable;
         } else {
-            res = ChargePointStatus::Available;
+            res = ChargePointStatus_Available;
         }
         return res;
     }
 
     if (isFaulted()) {
-        res = ChargePointStatus::Faulted;
+        res = ChargePointStatus_Faulted;
     } else if (!isOperative()) {
-        res = ChargePointStatus::Unavailable;
+        res = ChargePointStatus_Unavailable;
     } else if (transaction && transaction->isRunning()) {
         //Transaction is currently running
         if (connectorPluggedInput && !connectorPluggedInput()) { //special case when StopTransactionOnEVSideDisconnect is false
-            res = ChargePointStatus::SuspendedEV;
+            res = ChargePointStatus_SuspendedEV;
         } else if (!ocppPermitsCharge() ||
                 (evseReadyInput && !evseReadyInput())) { 
-            res = ChargePointStatus::SuspendedEVSE;
+            res = ChargePointStatus_SuspendedEVSE;
         } else if (evReadyInput && !evReadyInput()) {
-            res = ChargePointStatus::SuspendedEV;
+            res = ChargePointStatus_SuspendedEV;
         } else {
-            res = ChargePointStatus::Charging;
+            res = ChargePointStatus_Charging;
         }
     }
     #if MO_ENABLE_RESERVATION
     else if (model.getReservationService() && model.getReservationService()->getReservation(connectorId)) {
-        res = ChargePointStatus::Reserved;
+        res = ChargePointStatus_Reserved;
     }
     #endif 
     else if ((!transaction || !transaction->isActive()) &&                 //no transaction preparation
                (!connectorPluggedInput || !connectorPluggedInput()) &&   //no vehicle plugged
                (!occupiedInput || !occupiedInput())) {                       //occupied override clear
-        res = ChargePointStatus::Available;
+        res = ChargePointStatus_Available;
     } else {
         /*
          * Either in Preparing or Finishing state. Only way to know is from previous state
          */
         const auto previous = currentStatus;
-        if (previous == ChargePointStatus::Finishing ||
-                previous == ChargePointStatus::Charging ||
-                previous == ChargePointStatus::SuspendedEV ||
-                previous == ChargePointStatus::SuspendedEVSE) {
-            res = ChargePointStatus::Finishing;
+        if (previous == ChargePointStatus_Finishing ||
+                previous == ChargePointStatus_Charging ||
+                previous == ChargePointStatus_SuspendedEV ||
+                previous == ChargePointStatus_SuspendedEVSE) {
+            res = ChargePointStatus_Finishing;
         } else {
-            res = ChargePointStatus::Preparing;
+            res = ChargePointStatus_Preparing;
         }
     }
 
 #if MO_ENABLE_V201
     if (model.getVersion().major == 2) {
         //OCPP 2.0.1: map v1.6 status onto v2.0.1
-        if (res == ChargePointStatus::Preparing ||
-                res == ChargePointStatus::Charging ||
-                res == ChargePointStatus::SuspendedEV ||
-                res == ChargePointStatus::SuspendedEVSE ||
-                res == ChargePointStatus::Finishing) {
-            res = ChargePointStatus::Occupied;
+        if (res == ChargePointStatus_Preparing ||
+                res == ChargePointStatus_Charging ||
+                res == ChargePointStatus_SuspendedEV ||
+                res == ChargePointStatus_SuspendedEVSE ||
+                res == ChargePointStatus_Finishing) {
+            res = ChargePointStatus_Occupied;
         }
     }
 #endif
 
-    if (res == ChargePointStatus::NOT_SET) {
+    if (res == ChargePointStatus_UNDEFINED) {
         MO_DBG_DEBUG("status undefined");
-        return ChargePointStatus::Faulted; //internal error
+        return ChargePointStatus_Faulted; //internal error
     }
 
     return res;
@@ -429,7 +429,7 @@ void Connector::loop() {
 
     if (status != currentStatus) {
         MO_DBG_DEBUG("Status changed %s -> %s %s",
-                currentStatus == ChargePointStatus::NOT_SET ? "" : cstrFromOcppEveState(currentStatus),
+                currentStatus == ChargePointStatus_UNDEFINED ? "" : cstrFromOcppEveState(currentStatus),
                 cstrFromOcppEveState(status),
                 minimumStatusDurationInt->getInt() ? " (will report delayed)" : "");
         currentStatus = status;
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index b2cafad6..fe2cfcf2 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -44,9 +44,9 @@ class Connector {
     bool isFaulted();
     const char *getErrorCode();
 
-    ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
+    ChargePointStatus currentStatus = ChargePointStatus_UNDEFINED;
     std::shared_ptr<Configuration> minimumStatusDurationInt; //in seconds
-    ChargePointStatus reportedStatus = ChargePointStatus::NOT_SET;
+    ChargePointStatus reportedStatus = ChargePointStatus_UNDEFINED;
     unsigned long t_statusTransition = 0;
 
     std::function<UnlockConnectorResult()> onUnlockConnector;
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index 67c6818d..ebbaa3ac 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -83,7 +83,7 @@ ConnectorsCommon::ConnectorsCommon(Context& context, unsigned int numConn, std::
     }
     // OCPP 1.6 + 2.0.1 compliant echo messages
     context.getOperationRegistry().registerOperation("StatusNotification", [&context] () {
-        return new Ocpp16::StatusNotification(-1, ChargePointStatus::NOT_SET, Timestamp());});
+        return new Ocpp16::StatusNotification(-1, ChargePointStatus_UNDEFINED, Timestamp());});
 }
 
 void ConnectorsCommon::loop() {
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index f152a29d..d1131c4c 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -46,7 +46,7 @@ void ReservationService::loop() {
 
             //check if connector went inoperative
             auto cStatus = connector->getStatus();
-            if (cStatus == ChargePointStatus::Faulted || cStatus == ChargePointStatus::Unavailable) {
+            if (cStatus == ChargePointStatus_Faulted || cStatus == ChargePointStatus_Unavailable) {
                 reservation->clear();
                 continue;
             }
@@ -157,7 +157,7 @@ Reservation *ReservationService::getReservation(unsigned int connectorId, const
             continue;
         }
         if (auto connector = context.getModel().getConnector(cId)) {
-            if (connector->getStatus() == ChargePointStatus::Available) {
+            if (connector->getStatus() == ChargePointStatus_Available) {
                 availableCount++;
             }
         }
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index e7624470..d6e02e8d 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -58,7 +58,7 @@ void ResetService::loop() {
                 connector->setAvailabilityVolatile(true);
             }
 
-            ChargePointStatus cpStatus = ChargePointStatus::NOT_SET;
+            ChargePointStatus cpStatus = ChargePointStatus_UNDEFINED;
             if (context.getModel().getNumConnectors() > 0) {
                 cpStatus = context.getModel().getConnector(0)->getStatus();
             }
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index 17e6a15a..fe7eb473 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -87,19 +87,19 @@ void ReserveNow::processReq(JsonObject payload) {
             connector = model.getConnector((unsigned int) connectorId);
         }
 
-        if (chargePoint->getStatus() == ChargePointStatus::Faulted ||
-                (connector && connector->getStatus() == ChargePointStatus::Faulted)) {
+        if (chargePoint->getStatus() == ChargePointStatus_Faulted ||
+                (connector && connector->getStatus() == ChargePointStatus_Faulted)) {
             reservationStatus = "Faulted";
             return;
         }
 
-        if (chargePoint->getStatus() == ChargePointStatus::Unavailable ||
-                (connector && connector->getStatus() == ChargePointStatus::Unavailable)) {
+        if (chargePoint->getStatus() == ChargePointStatus_Unavailable ||
+                (connector && connector->getStatus() == ChargePointStatus_Unavailable)) {
             reservationStatus = "Unavailable";
             return;
         }
 
-        if (connector && connector->getStatus() != ChargePointStatus::Available) {
+        if (connector && connector->getStatus() != ChargePointStatus_Available) {
             reservationStatus = "Occupied";
             return;
         }
diff --git a/src/MicroOcpp/Operations/StatusNotification.cpp b/src/MicroOcpp/Operations/StatusNotification.cpp
index 94437ca5..75e5cf1f 100644
--- a/src/MicroOcpp/Operations/StatusNotification.cpp
+++ b/src/MicroOcpp/Operations/StatusNotification.cpp
@@ -13,33 +13,33 @@ namespace MicroOcpp {
 //helper function
 const char *cstrFromOcppEveState(ChargePointStatus state) {
     switch (state) {
-        case (ChargePointStatus::Available):
+        case (ChargePointStatus_Available):
             return "Available";
-        case (ChargePointStatus::Preparing):
+        case (ChargePointStatus_Preparing):
             return "Preparing";
-        case (ChargePointStatus::Charging):
+        case (ChargePointStatus_Charging):
             return "Charging";
-        case (ChargePointStatus::SuspendedEVSE):
+        case (ChargePointStatus_SuspendedEVSE):
             return "SuspendedEVSE";
-        case (ChargePointStatus::SuspendedEV):
+        case (ChargePointStatus_SuspendedEV):
             return "SuspendedEV";
-        case (ChargePointStatus::Finishing):
+        case (ChargePointStatus_Finishing):
             return "Finishing";
-        case (ChargePointStatus::Reserved):
+        case (ChargePointStatus_Reserved):
             return "Reserved";
-        case (ChargePointStatus::Unavailable):
+        case (ChargePointStatus_Unavailable):
             return "Unavailable";
-        case (ChargePointStatus::Faulted):
+        case (ChargePointStatus_Faulted):
             return "Faulted";
 #if MO_ENABLE_V201
-        case (ChargePointStatus::Occupied):
+        case (ChargePointStatus_Occupied):
             return "Occupied";
 #endif
         default:
             MO_DBG_ERR("ChargePointStatus not specified");
             /* fall through */
-        case (ChargePointStatus::NOT_SET):
-            return "NOT_SET";
+        case (ChargePointStatus_UNDEFINED):
+            return "UNDEFINED";
     }
 }
 
@@ -48,7 +48,7 @@ namespace Ocpp16 {
 StatusNotification::StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData)
         : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorData(errorData) {
     
-    if (currentStatus != ChargePointStatus::NOT_SET) {
+    if (currentStatus != ChargePointStatus_UNDEFINED) {
         MO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
     }
 }
@@ -75,7 +75,7 @@ std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
         if (errorData.vendorErrorCode) {
             payload["vendorErrorCode"] = errorData.vendorErrorCode;
         }
-    } else if (currentStatus == ChargePointStatus::NOT_SET) {
+    } else if (currentStatus == ChargePointStatus_UNDEFINED) {
         MO_DBG_ERR("Reporting undefined status");
         payload["errorCode"] = "InternalError";
     } else {
diff --git a/src/MicroOcpp/Operations/StatusNotification.h b/src/MicroOcpp/Operations/StatusNotification.h
index ef0e6a1f..87480331 100644
--- a/src/MicroOcpp/Operations/StatusNotification.h
+++ b/src/MicroOcpp/Operations/StatusNotification.h
@@ -20,7 +20,7 @@ namespace Ocpp16 {
 class StatusNotification : public Operation {
 private:
     int connectorId = 1;
-    ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
+    ChargePointStatus currentStatus = ChargePointStatus_UNDEFINED;
     Timestamp timestamp;
     ErrorData errorData;
 public:
@@ -51,7 +51,7 @@ class StatusNotification : public Operation {
 private:
     EvseId evseId;
     Timestamp timestamp;
-    ChargePointStatus currentStatus = ChargePointStatus::NOT_SET;
+    ChargePointStatus currentStatus = ChargePointStatus_UNDEFINED;
 public:
     StatusNotification(EvseId evseId, ChargePointStatus currentStatus, const Timestamp &timestamp);
 
diff --git a/src/MicroOcpp/Version.h b/src/MicroOcpp/Version.h
index 0a9770f1..92a2ea46 100644
--- a/src/MicroOcpp/Version.h
+++ b/src/MicroOcpp/Version.h
@@ -8,7 +8,7 @@
 /*
  * Version specification of MicroOcpp library (not related with the OCPP version)
  */
-#define MO_VERSION "1.1.0"
+#define MO_VERSION "1.2.0"
 
 /*
  * Enable OCPP 2.0.1 support. If enabled, library can be initialized with both v1.6 and v2.0.1. The choice
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index abb87d7e..5aa119f3 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -195,6 +195,14 @@ bool ocpp_ocppPermitsCharge_m(unsigned int connectorId) {
     return ocppPermitsCharge(connectorId);
 }
 
+ChargePointStatus ocpp_getChargePointStatus() {
+    return getChargePointStatus();
+}
+
+ChargePointStatus ocpp_getChargePointStatus_m(unsigned int connectorId) {
+    return getChargePointStatus(connectorId);
+}
+
 void ocpp_setConnectorPluggedInput(InputBool pluggedInput) {
     setConnectorPluggedInput(adaptFn(pluggedInput));
 }
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index 4c1f1b6a..52736638 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -2,12 +2,13 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef ARDUINOOCPP_C_H
-#define ARDUINOOCPP_C_H
+#ifndef MO_MICROOCPP_C_H
+#define MO_MICROOCPP_C_H
 
 #include <stddef.h>
 
 #include <MicroOcpp/Core/ConfigurationOptions.h>
+#include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
@@ -101,6 +102,9 @@ OCPP_Transaction *ocpp_getTransaction_m(unsigned int connectorId);
 bool ocpp_ocppPermitsCharge();
 bool ocpp_ocppPermitsCharge_m(unsigned int connectorId);
 
+ChargePointStatus ocpp_getChargePointStatus();
+ChargePointStatus ocpp_getChargePointStatus_m(unsigned int connectorId);
+
 /*
  * Define the Inputs and Outputs of this library.
  */
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index e6cc8bf5..1877f0d8 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -40,7 +40,7 @@ TEST_CASE( "Charging sessions" ) {
     
     std::array<const char*, 2> expectedSN {"Available", "Available"};
     std::array<bool, 2> checkedSN {false, false};
-    checkMsg.registerOperation("StatusNotification", [] () -> Operation* {return new Ocpp16::StatusNotification(0, ChargePointStatus::NOT_SET, MIN_TIME);});
+    checkMsg.registerOperation("StatusNotification", [] () -> Operation* {return new Ocpp16::StatusNotification(0, ChargePointStatus_UNDEFINED, MIN_TIME);});
     checkMsg.setOnRequest("StatusNotification",
         [&checkedSN, &expectedSN] (JsonObject request) {
             int connectorId = request["connectorId"] | -1;
@@ -625,7 +625,7 @@ TEST_CASE( "Charging sessions" ) {
         loop();
 
         auto connector = getOcppContext()->getModel().getConnector(1);
-        REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
+        REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
         REQUIRE(isOperative());
 
         bool checkProcessed = false;
@@ -650,7 +650,7 @@ TEST_CASE( "Charging sessions" ) {
         loop();
 
         REQUIRE(checkProcessed);
-        REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
+        REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
         REQUIRE(isOperative());
 
         mocpp_deinitialize();
@@ -660,19 +660,19 @@ TEST_CASE( "Charging sessions" ) {
 
         loop();
 
-        REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
+        REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
         REQUIRE(isOperative());
 
         endTransaction();
 
         loop();
 
-        REQUIRE(connector->getStatus() == ChargePointStatus::Unavailable);
+        REQUIRE(connector->getStatus() == ChargePointStatus_Unavailable);
         REQUIRE(!isOperative());
 
         connector->setAvailability(true);
 
-        REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+        REQUIRE(connector->getStatus() == ChargePointStatus_Available);
         REQUIRE(isOperative());
     }
 
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 27aed0d2..3b3ea50f 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -85,7 +85,7 @@ TEST_CASE( "Configuration Behavior" ) {
             setConnectorPluggedInput([] () {return false;});
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Available);
         }
 
         SECTION("set false") {
@@ -94,12 +94,12 @@ TEST_CASE( "Configuration Behavior" ) {
             setConnectorPluggedInput([] () {return false;});
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::SuspendedEV);
+            REQUIRE(connector->getStatus() == ChargePointStatus_SuspendedEV);
 
             endTransaction();
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Available);
         }
     }
 
@@ -115,12 +115,12 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("mIdTag");
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Available);
 
             beginTransaction_authorized("mIdTag");
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Available);
         }
 
         SECTION("set false") {
@@ -129,17 +129,17 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("mIdTag");
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Available);
 
             beginTransaction_authorized("mIdTag");
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::SuspendedEVSE);
+            REQUIRE(connector->getStatus() == ChargePointStatus_SuspendedEVSE);
 
             endTransaction();
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Available);
         }
     }
 
@@ -156,23 +156,23 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("mIdTag");
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
 
             endTransaction();
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Available);
         }
 
         SECTION("set false") {
             configBool->setBool(false);
 
             beginTransaction("mIdTag");
-            REQUIRE(connector->getStatus() == ChargePointStatus::Preparing);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Preparing);
 
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Available);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Available);
         }
 
         endTransaction();
@@ -201,7 +201,7 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("local-idtag");
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
         }
 
         SECTION("set false") {
@@ -210,13 +210,13 @@ TEST_CASE( "Configuration Behavior" ) {
             beginTransaction("local-idtag");
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Preparing);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Preparing);
 
             loopback.setOnline(true);
             mtime += 20000; //Authorize will be retried after a few seconds
             loop();
 
-            REQUIRE(connector->getStatus() == ChargePointStatus::Charging);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
         }
 
         endTransaction();
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index 99a07689..811d4d00 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -102,12 +102,12 @@ TEST_CASE( "LocalAuth" ) {
         //begin transaction and delay Authorize request - tx should start immediately
         loopback.setOnline(false); //Authorize delayed by short offline period
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         beginTransaction("mIdTag");
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( checkTxAuthorized );
 
         loopback.setOnline(true);
@@ -118,18 +118,18 @@ TEST_CASE( "LocalAuth" ) {
         checkTxAuthorized = false;
         loopback.setOnline(false);
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         beginTransaction("wrong idTag");
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Preparing );
         REQUIRE( !checkTxAuthorized );
 
         loopback.setOnline(true);
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( checkTxAuthorized );
 
         endTransaction();
@@ -158,7 +158,7 @@ TEST_CASE( "LocalAuth" ) {
         //make charger offline and begin tx - tx should begin after Authorize timeout
         loopback.setOnline(false);
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         unsigned long t_before = mocpp_tick_ms();
 
@@ -166,13 +166,13 @@ TEST_CASE( "LocalAuth" ) {
         loop();
 
         REQUIRE( mocpp_tick_ms() - t_before < AUTH_TIMEOUT_MS ); //if this fails, increase AUTH_TIMEOUT_MS
-        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Preparing );
         REQUIRE( !checkTxAuthorized );
 
         mtime += AUTH_TIMEOUT_MS - (mocpp_tick_ms() - t_before); //increment clock so that auth timeout is exceeded
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( checkTxAuthorized );
 
         loopback.setOnline(true);
@@ -188,20 +188,20 @@ TEST_CASE( "LocalAuth" ) {
         });
         loopback.setOnline(false);
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         t_before = mocpp_tick_ms();
 
         beginTransaction("wrong idTag");
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Preparing );
         REQUIRE( !checkTxTimeout );
 
         mtime += AUTH_TIMEOUT_MS - (mocpp_tick_ms() - t_before); //increment clock so that auth timeout is exceeded
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
         REQUIRE( checkTxTimeout );
 
         loopback.setOnline(true);
@@ -225,20 +225,20 @@ TEST_CASE( "LocalAuth" ) {
         //make charger offline and begin tx - tx should begin after Authorize timeout
         loopback.setOnline(false);
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         unsigned long t_before = mocpp_tick_ms();
 
         beginTransaction("unknownIdTag");
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Preparing );
         REQUIRE( !checkTxAuthorized );
 
         mtime += AUTH_TIMEOUT_MS - (mocpp_tick_ms() - t_before); //increment clock so that auth timeout is exceeded
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( checkTxAuthorized );
 
         loopback.setOnline(true);
@@ -263,14 +263,14 @@ TEST_CASE( "LocalAuth" ) {
         //disconnect WS and begin tx - charger should enter offline mode immediately
         loopback.setConnected(false);
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         unsigned long t_before = mocpp_tick_ms();
 
         beginTransaction("unknownIdTag");
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( checkTxAuthorized );
 
         loopback.setConnected(true);
@@ -298,17 +298,17 @@ TEST_CASE( "LocalAuth" ) {
         //begin transaction and delay Authorize request - cannot PreAuthorize because entry is expired
         loopback.setOnline(false); //Authorize delayed by short offline period
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         beginTransaction("mIdTagExpired");
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Preparing );
 
         loopback.setOnline(true);
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
 
         endTransaction();
         loop();
@@ -316,17 +316,17 @@ TEST_CASE( "LocalAuth" ) {
         //begin transaction and delay Authorize request - cannot PreAuthorize because entry is unauthorized
         loopback.setOnline(false); //Authorize delayed by short offline period
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         beginTransaction("mIdTagUnauthorized");
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Preparing );
 
         loopback.setOnline(true);
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         endTransaction();
         loop();
     }
@@ -351,12 +351,12 @@ TEST_CASE( "LocalAuth" ) {
         //begin transaction and delay Authorize request - tx should start immediately
         loopback.setOnline(false);
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         beginTransaction("mIdTagAccepted");
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
 
         loopback.setOnline(true);
         endTransaction();
@@ -365,7 +365,7 @@ TEST_CASE( "LocalAuth" ) {
         //begin transaction, but idTag is expired - AllowOfflineTxForUnknownId must not apply
         loopback.setOnline(false);
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         unsigned long t_before = mocpp_tick_ms();
 
@@ -373,12 +373,12 @@ TEST_CASE( "LocalAuth" ) {
         loop();
 
         REQUIRE( mocpp_tick_ms() - t_before < AUTH_TIMEOUT_MS ); //if this fails, increase AUTH_TIMEOUT_MS
-        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Preparing );
 
         mtime += AUTH_TIMEOUT_MS - (mocpp_tick_ms() - t_before); //increment clock so that auth timeout is exceeded
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         loopback.setOnline(true);
         loop();
@@ -418,12 +418,12 @@ TEST_CASE( "LocalAuth" ) {
         //begin transaction and delay Authorize request - tx should start immediately
         loopback.setOnline(false); //Authorize delayed by short offline period
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         beginTransaction("mIdTag");
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( checkTxAuthorized );
 
         //check TX notification
@@ -437,7 +437,7 @@ TEST_CASE( "LocalAuth" ) {
         loopback.setOnline(true);
         loop();
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
         REQUIRE( checkTxRejected );
 
         loop();
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index 09101ba2..fbd6894d 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -46,7 +46,7 @@ TEST_CASE( "Reservation" ) {
     loop();
 
     SECTION("Basic reservation") {
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
         REQUIRE( rService );
 
         //set reservation
@@ -58,7 +58,7 @@ TEST_CASE( "Reservation" ) {
 
         rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
         
-        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Reserved );
 
         //transaction blocked by reservation
         bool checkTxRejected = false;
@@ -70,23 +70,23 @@ TEST_CASE( "Reservation" ) {
 
         beginTransaction("wrong idTag");
         loop();
-        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Reserved );
         REQUIRE( checkTxRejected );
 
         //idTag matches reservation
         beginTransaction("mIdTag");
         loop();
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( connector->getTransaction()->getReservationId() == reservationId );
 
         //reservation is reset after tx
         endTransaction();
         loop();
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //RemoteStartTx - idTag doesn't match. The tx will start anyway assuming some start trigger in the backend prevails over reservations in the backend implementation
         rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
-        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Reserved );
 
         getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
                 "RemoteStartTransaction",
@@ -99,17 +99,17 @@ TEST_CASE( "Reservation" ) {
                 [] (JsonObject) { } //ignore conf
         )));
         loop();
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( connector->getTransaction()->getReservationId() != reservationId );
 
         //reservation is reset after tx
         endTransaction();
         loop();
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //RemoteStartTx - idTag does match
         rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
-        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Reserved );
 
         getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
                 "RemoteStartTransaction",
@@ -122,17 +122,17 @@ TEST_CASE( "Reservation" ) {
                 [] (JsonObject) { } //ignore conf
         )));
         loop();
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( connector->getTransaction()->getReservationId() == reservationId );
 
         //reservation is reset after tx
         endTransaction();
         loop();
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
     }
 
     SECTION("Tx on other connector") {
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //set reservation
         int reservationId = 123;
@@ -143,21 +143,21 @@ TEST_CASE( "Reservation" ) {
         const char *parentIdTag = nullptr;
 
         rService->updateReservation(reservationId, connectorIdResvd, expiryDate, idTag, parentIdTag);
-        REQUIRE( model.getConnector(connectorIdResvd)->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( model.getConnector(connectorIdResvd)->getStatus() == ChargePointStatus_Reserved );
 
         beginTransaction(idTag, connectorIdOther);
         loop();
-        REQUIRE( model.getConnector(connectorIdResvd)->getStatus() == ChargePointStatus::Available ); //reservation on first connector withdrawed
-        REQUIRE( model.getConnector(connectorIdOther)->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( model.getConnector(connectorIdResvd)->getStatus() == ChargePointStatus_Available ); //reservation on first connector withdrawed
+        REQUIRE( model.getConnector(connectorIdOther)->getStatus() == ChargePointStatus_Charging );
         REQUIRE( getTransaction(connectorIdOther)->getReservationId() == reservationId ); //reservation transferred to other connector
 
         endTransaction(nullptr, nullptr, connectorIdOther);
         loop();
-        REQUIRE( model.getConnector(connectorIdOther)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( model.getConnector(connectorIdOther)->getStatus() == ChargePointStatus_Available );
     }
 
     SECTION("parentIdTag") {
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //set reservation
         int reservationId = 123;
@@ -167,7 +167,7 @@ TEST_CASE( "Reservation" ) {
         const char *parentIdTag = "mParentIdTag";
         
         rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
-        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Reserved );
 
         bool checkProcessed = false;
         getOcppContext()->getOperationRegistry().registerOperation("Authorize",
@@ -188,17 +188,17 @@ TEST_CASE( "Reservation" ) {
         beginTransaction("other idTag");
         loop();
         REQUIRE( checkProcessed );
-        REQUIRE( connector->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Charging );
         REQUIRE( connector->getTransaction()->getReservationId() == reservationId );
 
         //reset tx
         endTransaction();
         loop();
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
     }
 
     SECTION("ConnectorZero") {
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //set reservation
         Timestamp expiryDate = model.getClock().now() + 3600; //expires one hour in future
@@ -209,19 +209,19 @@ TEST_CASE( "Reservation" ) {
         REQUIRE( rService->updateReservation(1000, 0, expiryDate, idTag, parentIdTag) );
         REQUIRE( rService->updateReservation(1001, 1, expiryDate, idTag, parentIdTag) );
         REQUIRE( !rService->updateReservation(1002, 2, expiryDate, idTag, parentIdTag) );
-        REQUIRE( model.getConnector(2)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( model.getConnector(2)->getStatus() == ChargePointStatus_Available );
 
         //reset reservations
         rService->getReservationById(1000)->clear();
         rService->getReservationById(1001)->clear();
-        REQUIRE( model.getConnector(1)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( model.getConnector(1)->getStatus() == ChargePointStatus_Available );
 
         //if connector 0 is reserved, ensure that at least one physical connector remains available for the idTag of the reservation
         REQUIRE( rService->updateReservation(1000, 0, expiryDate, idTag, parentIdTag) );
 
         beginTransaction("other idTag", 1);
         loop();
-        REQUIRE( model.getConnector(1)->getStatus() == ChargePointStatus::Charging );
+        REQUIRE( model.getConnector(1)->getStatus() == ChargePointStatus_Charging );
 
         bool checkTxRejected = false;
         setTxNotificationOutput([&checkTxRejected] (Transaction*, TxNotification txNotification) {
@@ -233,7 +233,7 @@ TEST_CASE( "Reservation" ) {
         beginTransaction("other idTag 2", 2);
         loop();
         REQUIRE( checkTxRejected );
-        REQUIRE( model.getConnector(2)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( model.getConnector(2)->getStatus() == ChargePointStatus_Available );
         
 
         endTransaction(nullptr, nullptr, 1);
@@ -241,7 +241,7 @@ TEST_CASE( "Reservation" ) {
     }
 
     SECTION("Expiry date") {
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //set reservation
         int reservationId = 123;
@@ -252,19 +252,19 @@ TEST_CASE( "Reservation" ) {
 
         rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
         
-        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Reserved );
 
         Timestamp expired = expiryDate + 1;
         char expired_cstr [JSONDATE_LENGTH + 1];
         expired.toJsonString(expired_cstr, JSONDATE_LENGTH + 1);
         model.getClock().setTime(expired_cstr);
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
     }
 
     SECTION("Reservation persistency") {
         unsigned int connectorId = 1;
-        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus_Available );
 
         //set reservation
         int reservationId = 123;
@@ -274,7 +274,7 @@ TEST_CASE( "Reservation" ) {
 
         getOcppContext()->getModel().getReservationService()->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
         
-        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus_Reserved );
 
         mocpp_deinitialize();
 
@@ -282,7 +282,7 @@ TEST_CASE( "Reservation" ) {
         getOcppContext()->getModel().getClock().setTime(BASE_TIME);
         loop();
 
-        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus_Reserved );
 
         auto reservation = getOcppContext()->getModel().getReservationService()->getReservationById(reservationId);
         REQUIRE( reservation->getReservationId() == reservationId );
@@ -299,12 +299,12 @@ TEST_CASE( "Reservation" ) {
         getOcppContext()->getModel().getClock().setTime(BASE_TIME);
         loop();
 
-        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( getOcppContext()->getModel().getConnector(connectorId)->getStatus() == ChargePointStatus_Available );
     }
 
     SECTION("ReserveNow") {
 
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //set reservation
         int reservationId = 123;
@@ -340,15 +340,15 @@ TEST_CASE( "Reservation" ) {
         )));
         loop();
         REQUIRE( checkProcessed );
-        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Reserved );
 
         model.getReservationService()->getReservationById(reservationId)->clear();
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //reserve while charger is in Faulted state
         const char *errorCode = "OtherError";
         addErrorCodeInput([&errorCode] () {return errorCode;});
-        REQUIRE( connector->getStatus() == ChargePointStatus::Faulted );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Faulted );
 
         checkProcessed = false;
         getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
@@ -376,14 +376,14 @@ TEST_CASE( "Reservation" ) {
         )));
         loop();
         REQUIRE( checkProcessed );
-        REQUIRE( connector->getStatus() == ChargePointStatus::Faulted );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Faulted );
 
         errorCode = nullptr; //reset error
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //reserve while connector is already occupied
         setConnectorPluggedInput([] {return true;}); //plug EV
-        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Preparing );
 
         checkProcessed = false;
         getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
@@ -411,16 +411,16 @@ TEST_CASE( "Reservation" ) {
         )));
         loop();
         REQUIRE( checkProcessed );
-        REQUIRE( connector->getStatus() == ChargePointStatus::Preparing );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Preparing );
 
         setConnectorPluggedInput(nullptr); //reset ConnectorPluggedInput
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //Rejected ReserveNow status not possible
 
         //reserve while connector is inoperative
         connector->setAvailabilityVolatile(false);
-        REQUIRE( connector->getStatus() == ChargePointStatus::Unavailable );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Unavailable );
 
         checkProcessed = false;
         getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
@@ -448,14 +448,14 @@ TEST_CASE( "Reservation" ) {
         )));
         loop();
         REQUIRE( checkProcessed );
-        REQUIRE( connector->getStatus() == ChargePointStatus::Unavailable );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Unavailable );
 
         connector->setAvailabilityVolatile(true); //revert Unavailable status
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
     }
 
     SECTION("CancelReservation") {
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //set reservation
         int reservationId = 123;
@@ -465,7 +465,7 @@ TEST_CASE( "Reservation" ) {
         const char *parentIdTag = nullptr;
 
         rService->updateReservation(reservationId, connectorId, expiryDate, idTag, parentIdTag);
-        REQUIRE( connector->getStatus() == ChargePointStatus::Reserved );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Reserved );
 
         //CancelReservation successfully
         bool checkProcessed = false;
@@ -486,7 +486,7 @@ TEST_CASE( "Reservation" ) {
         )));
         loop();
         REQUIRE( checkProcessed );
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
         //CancelReservation while no reservation exists
         checkProcessed = false;
@@ -507,7 +507,7 @@ TEST_CASE( "Reservation" ) {
         )));
         loop();
         REQUIRE( checkProcessed );
-        REQUIRE( connector->getStatus() == ChargePointStatus::Available );
+        REQUIRE( connector->getStatus() == ChargePointStatus_Available );
     }
 
     mocpp_deinitialize();
diff --git a/tests/Reset.cpp b/tests/Reset.cpp
index a6206868..8092a155 100644
--- a/tests/Reset.cpp
+++ b/tests/Reset.cpp
@@ -133,7 +133,7 @@ TEST_CASE( "Reset" ) {
         REQUIRE( !ocppPermitsCharge(1) );
         REQUIRE( ocppPermitsCharge(2) );
 
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Unavailable );
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Unavailable );
 
         context->getModel().getTransactionService()->getEvse(2)->endAuthorization("mIdToken");
         setConnectorPluggedInput([] () {return false;}, 2);
@@ -151,8 +151,8 @@ TEST_CASE( "Reset" ) {
         REQUIRE( checkExecuted[0] );
 
         // Technically, Reset failed at this point, because the program is still running. Check if connectors are Available agin
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Available );
-        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Available );
+        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus_Available );
     }
 
     SECTION("Immediate full charger Reset") {
@@ -228,8 +228,8 @@ TEST_CASE( "Reset" ) {
         loop();
 
         // Technically, Reset failed at this point, because the program is still running. Check if connectors are Available agin
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Available );
-        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Available );
+        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus_Available );
     }
 
     SECTION("Reject Reset") {
@@ -265,9 +265,9 @@ TEST_CASE( "Reset" ) {
         REQUIRE(checkProcessed);
         REQUIRE(checkNotified[2]);
 
-        REQUIRE( context->getModel().getConnector(0)->getStatus() == ChargePointStatus::Available );
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Available );
-        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( context->getModel().getConnector(0)->getStatus() == ChargePointStatus_Available );
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Available );
+        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus_Available );
     }
 
     SECTION("Reset single EVSE") {
@@ -298,14 +298,14 @@ TEST_CASE( "Reset" ) {
         REQUIRE(checkProcessed);
         REQUIRE(checkNotified[1]);
 
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Unavailable );
-        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Unavailable );
+        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus_Available );
 
         mtime += 30000; // Reset has some delays to ensure that the WS is not cut off immediately
         loop();
 
         REQUIRE(checkExecuted[1]);
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus::Available );
+        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Available );
     }
 
     mocpp_deinitialize();

From 517df096b1e4e476e3a00d028e3fc448ac75aead Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Wed, 5 Jun 2024 20:04:00 +0200
Subject: [PATCH 488/549] clarify SmartCharging API doc (#310)

---
 src/MicroOcpp.h | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 0a774ab0..93a991be 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -276,8 +276,10 @@ void setEnergyMeterInput(std::function<int()> energyInput, unsigned int connecto
 
 void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId = 1); //Input of the power meter reading in W
 
-//Smart Charging Output, alternative for Watts only, Current only, or Watts x Current x numberPhases. Only one
-//of them can be set at a time
+//Smart Charging Output, alternative for Watts only, Current only, or Watts x Current x numberPhases.
+//Only one of the Smart Charging Outputs can be set at a time.
+//MO will execute the callback whenever the OCPP charging limit changes and will pass the limit for now
+//to the callback. If OCPP does not define a limit, then MO passes the value -1 for "undefined".
 void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId = 1); //Output (in Watts) for the Smart Charging limit
 void setSmartChargingCurrentOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId = 1); //Output (in Amps) for the Smart Charging limit
 void setSmartChargingOutput(std::function<void(float,float,int)> chargingLimitOutput, unsigned int connectorId = 1); //Output (in Watts, Amps, numberPhases) for the Smart Charging limit

From 0f8a528f1cc9cc5db06fcd336a4e0395cadaffab Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 7 Jun 2024 21:01:32 +0200
Subject: [PATCH 489/549] add debug message

---
 .../SmartCharging/SmartChargingService.cpp    | 38 ++++++++++++++-----
 1 file changed, 28 insertions(+), 10 deletions(-)

diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index 742ca1fa..655d20a3 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -159,6 +159,21 @@ void SmartChargingConnector::loop(){
 
         calculateLimit(tnow, limit, nextChange);
 
+#if MO_DBG_LEVEL >= MO_DL_INFO
+        {
+            char timestamp1[JSONDATE_LENGTH + 1] = {'\0'};
+            tnow.toJsonString(timestamp1, JSONDATE_LENGTH + 1);
+            char timestamp2[JSONDATE_LENGTH + 1] = {'\0'};
+            nextChange.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
+            MO_DBG_INFO("New limit for connector %u, scheduled at = %s, nextChange = %s, limit = {%.1f, %.1f, %i}",
+                                connectorId,
+                                timestamp1, timestamp2,
+                                limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
+                                limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
+                                limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
+        }
+#endif
+
         if (trackLimitOutput != limit) {
             if (limitOutput) {
 
@@ -497,16 +512,19 @@ void SmartChargingService::loop(){
 
         calculateLimit(tnow, limit, nextChange);
 
-#if (MO_DBG_LEVEL >= MO_DL_INFO)
-        char timestamp1[JSONDATE_LENGTH + 1] = {'\0'};
-        tnow.toJsonString(timestamp1, JSONDATE_LENGTH + 1);
-        char timestamp2[JSONDATE_LENGTH + 1] = {'\0'};
-        nextChange.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
-        MO_DBG_INFO("New limit for connector 1, scheduled at = %s, nextChange = %s, limit = {%f,%f,%i}",
-                            timestamp1, timestamp2,
-                            limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
-                            limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
-                            limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
+#if MO_DBG_LEVEL >= MO_DL_INFO
+        {
+            char timestamp1[JSONDATE_LENGTH + 1] = {'\0'};
+            tnow.toJsonString(timestamp1, JSONDATE_LENGTH + 1);
+            char timestamp2[JSONDATE_LENGTH + 1] = {'\0'};
+            nextChange.toJsonString(timestamp2, JSONDATE_LENGTH + 1);
+            MO_DBG_INFO("New limit for connector %u, scheduled at = %s, nextChange = %s, limit = {%.1f, %.1f, %i}",
+                                0,
+                                timestamp1, timestamp2,
+                                limit.power != std::numeric_limits<float>::max() ? limit.power : -1.f,
+                                limit.current != std::numeric_limits<float>::max() ? limit.current : -1.f,
+                                limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1);
+        }
 #endif
 
         if (trackLimitOutput != limit) {

From e1b4d226fc8d4c1bd20a52a463234307976b0a0f Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 9 Jun 2024 11:07:37 +0200
Subject: [PATCH 490/549] Connector Lock build switch (#312)

* add build flag MO_ENABLE_CONNECTOR_LOCK

* change default for MO_ENABLE_CONNECTOR_LOCK to 0

* update changelog
---
 CHANGELOG.md                                  |  1 +
 CMakeLists.txt                                |  1 +
 src/MicroOcpp.cpp                             |  2 +
 src/MicroOcpp.h                               |  4 +-
 .../Model/ConnectorBase/Connector.cpp         | 11 +++-
 src/MicroOcpp/Model/ConnectorBase/Connector.h |  4 ++
 .../ConnectorBase/UnlockConnectorResult.h     |  8 +++
 src/MicroOcpp/Operations/UnlockConnector.cpp  | 54 +++++++++++--------
 src/MicroOcpp/Operations/UnlockConnector.h    |  3 ++
 src/MicroOcpp_c.cpp                           |  5 ++
 src/MicroOcpp_c.h                             |  5 ++
 tests/Api.cpp                                 |  9 ++++
 tests/ChargingSessions.cpp                    |  8 +++
 13 files changed, 91 insertions(+), 24 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ff9e04e4..b6ef80ca 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,7 @@
 ### Changed
 
 - Change `MicroOcpp::ChargePointStatus` into C-style enum ([#309](https://github.com/matth-x/MicroOcpp/pull/309))
+- Connector lock disabled by default per `MO_ENABLE_CONNECTOR_LOCK` ([#312](https://github.com/matth-x/MicroOcpp/pull/312))
 
 ### Added
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 46e42ef8..5b7c959c 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -189,6 +189,7 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_ChargingScheduleMaxPeriods=4
     MO_MaxChargingProfilesInstalled=3
     MO_ENABLE_CERT_MGMT=1
+    MO_ENABLE_CONNECTOR_LOCK=1
 )
 
 target_compile_options(mo_unit_tests PUBLIC
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 83451b5a..49383124 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -874,6 +874,7 @@ void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcp
     connector->setTxNotificationOutput(notificationOutput);
 }
 
+#if MO_ENABLE_CONNECTOR_LOCK
 void setOnUnlockConnectorInOut(std::function<UnlockConnectorResult()> onUnlockConnectorInOut, unsigned int connectorId) {
     if (!context) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
@@ -886,6 +887,7 @@ void setOnUnlockConnectorInOut(std::function<UnlockConnectorResult()> onUnlockCo
     }
     connector->setOnUnlockConnector(onUnlockConnectorInOut);
 }
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
 bool isOperative(unsigned int connectorId) {
     if (!context) {
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 93a991be..0567ea15 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -309,15 +309,17 @@ void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connect
 
 void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcpp::TxNotification)> notificationOutput, unsigned int connectorId = 1); //called when transaction state changes (see TxNotification for possible events). Transaction can be null
 
+#if MO_ENABLE_CONNECTOR_LOCK
 /*
  * Set an InputOutput (reads and sets information at the same time) for forcing to unlock the
  * connector. Called as part of the OCPP operation "UnlockConnector"
  * Return values:
- *     - UnlockConnectorResult_Pending if action needs more time to complete (MO will call this cb again later or eventually timeout)
+ *     - UnlockConnectorResult_Pending if action needs more time to complete (MO will call this cb again later or eventually time out)
  *     - UnlockConnectorResult_Unlocked if successful
  *     - UnlockConnectorResult_UnlockFailed if not successful (e.g. lock stuck)
  */
 void setOnUnlockConnectorInOut(std::function<UnlockConnectorResult()> onUnlockConnectorInOut, unsigned int connectorId = 1);
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
 /*
  * Access further information about the internal state of the library
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 1fe3d077..d284b8dd 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -38,12 +38,17 @@ Connector::Connector(Context& context, int connectorId)
 
     snprintf(availabilityBoolKey, sizeof(availabilityBoolKey), MO_CONFIG_EXT_PREFIX "AVAIL_CONN_%d", connectorId);
     availabilityBool = declareConfiguration<bool>(availabilityBoolKey, true, MO_KEYVALUE_FN, false, false, false);
-    
+
+#if MO_ENABLE_CONNECTOR_LOCK
+    declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", true); //read-write
+#else
+    declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", false, CONFIGURATION_VOLATILE, true); //read-only because there is no connector lock
+#endif //MO_ENABLE_CONNECTOR_LOCK
+
     connectionTimeOutInt = declareConfiguration<int>("ConnectionTimeOut", 30);
     minimumStatusDurationInt = declareConfiguration<int>("MinimumStatusDuration", 0);
     stopTransactionOnInvalidIdBool = declareConfiguration<bool>("StopTransactionOnInvalidId", true);
     stopTransactionOnEVSideDisconnectBool = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true);
-    declareConfiguration<bool>("UnlockConnectorOnEVSideDisconnect", true, CONFIGURATION_VOLATILE, true);
     localPreAuthorizeBool = declareConfiguration<bool>("LocalPreAuthorize", false);
     localAuthorizeOfflineBool = declareConfiguration<bool>("LocalAuthorizeOffline", true);
     allowOfflineTxForUnknownIdBool = MicroOcpp::declareConfiguration<bool>("AllowOfflineTxForUnknownId", false);
@@ -945,6 +950,7 @@ void Connector::addErrorDataInput(std::function<ErrorData ()> errorDataInput) {
     this->trackErrorDataInputs.push_back(false);
 }
 
+#if MO_ENABLE_CONNECTOR_LOCK
 void Connector::setOnUnlockConnector(std::function<UnlockConnectorResult()> unlockConnector) {
     this->onUnlockConnector = unlockConnector;
 }
@@ -952,6 +958,7 @@ void Connector::setOnUnlockConnector(std::function<UnlockConnectorResult()> unlo
 std::function<UnlockConnectorResult()> Connector::getOnUnlockConnector() {
     return this->onUnlockConnector;
 }
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
 void Connector::setStartTxReadyInput(std::function<bool()> startTxReady) {
     this->startTxReadyInput = startTxReady;
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index fe2cfcf2..7da8c4d4 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -49,7 +49,9 @@ class Connector {
     ChargePointStatus reportedStatus = ChargePointStatus_UNDEFINED;
     unsigned long t_statusTransition = 0;
 
+#if MO_ENABLE_CONNECTOR_LOCK
     std::function<UnlockConnectorResult()> onUnlockConnector;
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
     std::function<bool()> startTxReadyInput; //the StartTx request will be delayed while this Input is false
     std::function<bool()> stopTxReadyInput; //the StopTx request will be delayed while this Input is false
@@ -118,8 +120,10 @@ class Connector {
 
     bool ocppPermitsCharge();
 
+#if MO_ENABLE_CONNECTOR_LOCK
     void setOnUnlockConnector(std::function<UnlockConnectorResult()> unlockConnector);
     std::function<UnlockConnectorResult()> getOnUnlockConnector();
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
     void setStartTxReadyInput(std::function<bool()> startTxReady);
     void setStopTxReadyInput(std::function<bool()> stopTxReady);
diff --git a/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h b/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h
index 127e4bba..0d863f2d 100644
--- a/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h
+++ b/src/MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h
@@ -7,6 +7,13 @@
 
 #include <stdint.h>
 
+// Connector-lock related behavior (i.e. if UnlockConnectorOnEVSideDisconnect is RW; enable HW binding for UnlockConnector)
+#ifndef MO_ENABLE_CONNECTOR_LOCK
+#define MO_ENABLE_CONNECTOR_LOCK 0
+#endif
+
+#if MO_ENABLE_CONNECTOR_LOCK
+
 #ifdef __cplusplus
 extern "C" {
 #endif // __cplusplus
@@ -25,4 +32,5 @@ typedef enum {
 }
 #endif // __cplusplus
 
+#endif // MO_ENABLE_CONNECTOR_LOCK
 #endif // MO_UNLOCKCONNECTORRESULT_H
diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index 9a171711..e67220e8 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -27,41 +27,53 @@ void UnlockConnector::processReq(JsonObject payload) {
         return;
     }
 
-    unlockConnector = connector->getOnUnlockConnector();
+#if MO_ENABLE_CONNECTOR_LOCK
+    {
+        unlockConnector = connector->getOnUnlockConnector();
 
-    if (!unlockConnector) {
-        // NotSupported
-        return;
-    }
+        if (!unlockConnector) {
+            // NotSupported
+            return;
+        }
 
-    connector->endTransaction(nullptr, "UnlockCommand");
-    connector->updateTxNotification(TxNotification::RemoteStop);
+        connector->endTransaction(nullptr, "UnlockCommand");
+        connector->updateTxNotification(TxNotification::RemoteStop);
 
-    cbUnlockResult = unlockConnector();
+        cbUnlockResult = unlockConnector();
 
-    timerStart = mocpp_tick_ms();
+        timerStart = mocpp_tick_ms();
+    }
+#endif //MO_ENABLE_CONNECTOR_LOCK
 }
 
 std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
-    if (unlockConnector && mocpp_tick_ms() - timerStart < MO_UNLOCK_TIMEOUT) {
-        //do poll and if more time is needed, delay creation of conf msg
 
-        if (cbUnlockResult == UnlockConnectorResult_Pending) {
-            cbUnlockResult = unlockConnector();
+    const char *status = "NotSupported";
+
+#if MO_ENABLE_CONNECTOR_LOCK
+    if (unlockConnector) {
+
+        if (mocpp_tick_ms() - timerStart < MO_UNLOCK_TIMEOUT) {
+            //do poll and if more time is needed, delay creation of conf msg
+
             if (cbUnlockResult == UnlockConnectorResult_Pending) {
-                return nullptr; //no result yet - delay confirmation response
+                cbUnlockResult = unlockConnector();
+                if (cbUnlockResult == UnlockConnectorResult_Pending) {
+                    return nullptr; //no result yet - delay confirmation response
+                }
             }
         }
+
+        if (cbUnlockResult == UnlockConnectorResult_Unlocked) {
+            status = "Unlocked";
+        } else {
+            status = "UnlockFailed";
+        }
     }
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    if (!unlockConnector) {
-        payload["status"] = "NotSupported";
-    } else if (cbUnlockResult == UnlockConnectorResult_Unlocked) {
-        payload["status"] = "Unlocked";
-    } else {
-        payload["status"] = "UnlockFailed";
-    }
+    payload["status"] = status;
     return doc;
 }
diff --git a/src/MicroOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
index ba4081dd..bf49d195 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.h
+++ b/src/MicroOcpp/Operations/UnlockConnector.h
@@ -18,9 +18,12 @@ namespace Ocpp16 {
 class UnlockConnector : public Operation {
 private:
     Model& model;
+
+#if MO_ENABLE_CONNECTOR_LOCK
     std::function<UnlockConnectorResult ()> unlockConnector;
     UnlockConnectorResult cbUnlockResult;
     unsigned long timerStart = 0; //for timeout
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
     const char *errorCode = nullptr;
 public:
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 5aa119f3..04aa5091 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -120,6 +120,7 @@ MicroOcpp::OnReceiveErrorListener adaptFn(OnCallError fn) {
     };
 }
 
+#if MO_ENABLE_CONNECTOR_LOCK
 std::function<UnlockConnectorResult()> adaptFn(PollUnlockResult fn) {
     return [fn] () {return fn();};
 }
@@ -127,6 +128,7 @@ std::function<UnlockConnectorResult()> adaptFn(PollUnlockResult fn) {
 std::function<UnlockConnectorResult()> adaptFn(unsigned int connectorId, PollUnlockResult_m fn) {
     return [fn, connectorId] () {return fn(connectorId);};
 }
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
 void ocpp_beginTransaction(const char *idTag) {
     beginTransaction(idTag);
@@ -281,12 +283,15 @@ void ocpp_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterV
     addMeterValueInput(std::move(svs), connectorId);
 }
 
+
+#if MO_ENABLE_CONNECTOR_LOCK
 void ocpp_setOnUnlockConnectorInOut(PollUnlockResult onUnlockConnectorInOut) {
     setOnUnlockConnectorInOut(adaptFn(onUnlockConnectorInOut));
 }
 void ocpp_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollUnlockResult_m onUnlockConnectorInOut) {
     setOnUnlockConnectorInOut(adaptFn(connectorId, onUnlockConnectorInOut), connectorId);
 }
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
 void ocpp_setStartTxReadyInput(InputBool startTxReady) {
     setStartTxReadyInput(adaptFn(startTxReady));
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index 52736638..64699337 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -41,8 +41,11 @@ typedef void (*OutputFloat)(float limit);
 typedef void (*OutputFloat_m)(unsigned int connectorId, float limit);
 typedef void (*OutputSmartCharging)(float power, float current, int nphases);
 typedef void (*OutputSmartCharging_m)(unsigned int connectorId, float power, float current, int nphases);
+
+#if MO_ENABLE_CONNECTOR_LOCK
 typedef UnlockConnectorResult (*PollUnlockResult)();
 typedef UnlockConnectorResult (*PollUnlockResult_m)(unsigned int connectorId);
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
 
 #ifdef __cplusplus
@@ -156,8 +159,10 @@ void ocpp_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxRead
 void ocpp_setTxNotificationOutput(void (*notificationOutput)(OCPP_Transaction*, enum OCPP_TxNotification));
 void ocpp_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, OCPP_Transaction*, enum OCPP_TxNotification));
 
+#if MO_ENABLE_CONNECTOR_LOCK
 void ocpp_setOnUnlockConnectorInOut(PollUnlockResult onUnlockConnectorInOut);
 void ocpp_setOnUnlockConnectorInOut_m(unsigned int connectorId, PollUnlockResult_m onUnlockConnectorInOut);
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
 /*
  * Access further information about the internal state of the library
diff --git a/tests/Api.cpp b/tests/Api.cpp
index b716965f..9f53aa94 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -62,7 +62,10 @@ TEST_CASE( "C++ API test" ) {
         setStartTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setStopTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setTxNotificationOutput([c = &checkpoints[ncheck++]] (MicroOcpp::Transaction*, MicroOcpp::TxNotification) {*c = true;});
+
+#if MO_ENABLE_CONNECTOR_LOCK
         setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> UnlockConnectorResult {*c = true; return UnlockConnectorResult_Unlocked;});
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
         setOnResetNotify([c = &checkpoints[ncheck++]] (bool) -> bool {*c = true; return true;});
         setOnResetExecute([c = &checkpoints[ncheck++]] (bool) {*c = true;});
@@ -248,8 +251,14 @@ TEST_CASE( "C API test" ) {
         ocpp_setStopTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[23] = true; return true;}); ncheckc++;
         ocpp_setTxNotificationOutput([] (OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[24] = true;}); ncheckc++;
         ocpp_setTxNotificationOutput_m(2, [] (unsigned int, OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[25] = true;}); ncheckc++;
+
+#if MO_ENABLE_CONNECTOR_LOCK
         ocpp_setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {checkpointsc[26] = true; return UnlockConnectorResult_Unlocked;}); ncheckc++;
         ocpp_setOnUnlockConnectorInOut_m(2, [] (unsigned int) -> UnlockConnectorResult {checkpointsc[27] = true; return UnlockConnectorResult_Unlocked;}); ncheckc++;
+#else
+        checkpointsc[26] = true;
+        checkpointsc[27] = true;
+#endif //MO_ENABLE_CONNECTOR_LOCK
 
         ocpp_setOnResetNotify([] (bool) -> bool {checkpointsc[28] = true; return true;}); ncheckc++;
         ocpp_setOnResetExecute([] (bool) {checkpointsc[29] = true;}); ncheckc++;
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 1877f0d8..6975fea6 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -704,6 +704,8 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE( checkProcessed );
         REQUIRE( isTransactionRunning() ); // NotSupported doesn't lead to transaction stop
 
+#if MO_ENABLE_CONNECTOR_LOCK
+
         setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {
             // connector lock fails
             return UnlockConnectorResult_UnlockFailed;
@@ -754,6 +756,12 @@ TEST_CASE( "Charging sessions" ) {
         mtime += MO_UNLOCK_TIMEOUT; // increment clock so that MO_UNLOCK_TIMEOUT expires
         loop();
         REQUIRE( checkProcessed );
+
+#else
+        endTransaction();
+        loop();
+#endif //MO_ENABLE_CONNECTOR_LOCK
+
     }
 
     SECTION("TxStartPoint - PowerPathClosed") {

From 5956d1291bdca050ae0ae1b4bf8af82a7c18f5b6 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Tue, 11 Jun 2024 20:50:43 +0200
Subject: [PATCH 491/549] built-in FW-Mngmt over FTP (#313)

---
 .gitignore                                    |   1 +
 CHANGELOG.md                                  |  10 +
 CMakeLists.txt                                |   1 +
 src/MicroOcpp.cpp                             |  32 +-
 src/MicroOcpp/Core/Context.cpp                |   8 +
 src/MicroOcpp/Core/Context.h                  |   6 +
 src/MicroOcpp/Core/FilesystemAdapter.cpp      |   3 +
 src/MicroOcpp/Core/FilesystemUtils.cpp        |   2 +-
 src/MicroOcpp/Core/Ftp.h                      |  21 +-
 src/MicroOcpp/Core/FtpMbedTLS.cpp             |  53 +-
 src/MicroOcpp/Core/Time.h                     |   2 +-
 .../Model/Diagnostics/DiagnosticsService.cpp  | 383 ++++++++++-
 .../Model/Diagnostics/DiagnosticsService.h    |  59 +-
 .../FirmwareManagement/FirmwareService.cpp    | 236 ++++---
 .../FirmwareManagement/FirmwareService.h      |  42 +-
 tests/FirmwareManagement.cpp                  | 597 ++++++++++++++++++
 tests/helpers/testHelper.cpp                  |   5 -
 tests/helpers/testHelper.h                    |  11 +-
 tests/ocppEngineLifecycle.cpp                 |   3 -
 19 files changed, 1335 insertions(+), 140 deletions(-)
 create mode 100644 tests/FirmwareManagement.cpp

diff --git a/.gitignore b/.gitignore
index 2b234a58..56868dff 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,4 +4,5 @@ lib
 mo_store
 src/ArduinoJson*
 src/main.cpp
+tests/helpers/ArduinoJson*
 coverage.info
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b6ef80ca..f99c3f42 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,6 +10,16 @@
 ### Added
 
 - Provide ChargePointStatus in API ([#309](https://github.com/matth-x/MicroOcpp/pull/309))
+- Built-in OTA over FTP ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
+- Built-in Diagnostics over FTP ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
+
+### Removed
+
+- ESP32 built-in HTTP OTA ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
+
+### Fixed
+
+- Skip Unix files . and .. in ftw_root ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 5b7c959c..4817e066 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -148,6 +148,7 @@ set(MO_SRC_UNIT
     tests/Variables.cpp
     tests/Transactions.cpp
     tests/Certificates.cpp
+    tests/FirmwareManagement.cpp
 )
 
 add_executable(mo_unit_tests
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 49383124..b6f70567 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -25,6 +25,8 @@
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Ftp.h>
+#include <MicroOcpp/Core/FtpMbedTLS.h>
 
 #include <MicroOcpp/Operations/Authorize.h>
 #include <MicroOcpp/Operations/StartTransaction.h>
@@ -272,6 +274,11 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     configuration_init(filesystem); //call before each other library call
 
     context = new Context(connection, filesystem, bootstats.bootNr, version);
+
+#if MO_ENABLE_MBEDTLS
+    context->setFtpClient(makeFtpClientMbedTLS());
+#endif //MO_ENABLE_MBEDTLS
+
     auto& model = context->getModel();
 
     model.setTransactionStore(std::unique_ptr<TransactionStore>(
@@ -328,12 +335,25 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
             new ResetService(*context)));
     }
 
-#if MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
-#if defined(ESP32) || defined(ESP8266)
-    model.setFirmwareService(std::unique_ptr<FirmwareService>(
-        makeDefaultFirmwareService(*context))); //instantiate FW service + ESP installation routine
-#endif //defined(ESP32) || defined(ESP8266)
-#endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
+#if !defined(MO_CUSTOM_UPDATER)
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP32) && MO_ENABLE_MBEDTLS
+    model.setFirmwareService(
+        makeDefaultFirmwareService(*context)); //instantiate FW service + ESP installation routine
+#elif MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP8266)
+    model.setFirmwareService(
+        makeDefaultFirmwareService(*context)); //instantiate FW service + ESP installation routine
+#endif //MO_PLATFORM
+#endif //!defined(MO_CUSTOM_UPDATER)
+
+#if !defined(MO_CUSTOM_DIAGNOSTICS)
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP32) && MO_ENABLE_MBEDTLS
+    model.setDiagnosticsService(
+        makeDefaultDiagnosticsService(*context, filesystem)); //instantiate Diag service + ESP hardware diagnostics
+#elif MO_ENABLE_MBEDTLS
+    model.setDiagnosticsService(
+        makeDefaultDiagnosticsService(*context, filesystem)); //instantiate Diag service 
+#endif //MO_PLATFORM
+#endif //!defined(MO_CUSTOM_DIAGNOSTICS)
 
 #if MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))
     setOnResetExecute(makeDefaultResetFn());
diff --git a/src/MicroOcpp/Core/Context.cpp b/src/MicroOcpp/Core/Context.cpp
index b4c2c4e3..4d651557 100644
--- a/src/MicroOcpp/Core/Context.cpp
+++ b/src/MicroOcpp/Core/Context.cpp
@@ -72,3 +72,11 @@ const ProtocolVersion& Context::getVersion() {
 Connection& Context::getConnection() {
     return connection;
 }
+
+void Context::setFtpClient(std::unique_ptr<FtpClient> ftpClient) {
+    this->ftpClient = std::move(ftpClient);
+}
+
+FtpClient *Context::getFtpClient() {
+    return ftpClient.get();
+}
diff --git a/src/MicroOcpp/Core/Context.h b/src/MicroOcpp/Core/Context.h
index 5c87d75b..1e87c0b3 100644
--- a/src/MicroOcpp/Core/Context.h
+++ b/src/MicroOcpp/Core/Context.h
@@ -9,6 +9,7 @@
 
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Core/RequestQueue.h>
+#include <MicroOcpp/Core/Ftp.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Version.h>
 
@@ -26,6 +27,8 @@ class Context {
 
     std::unique_ptr<RequestQueue> preBootQueue;
 
+    std::unique_ptr<FtpClient> ftpClient;
+
 public:
     Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr, ProtocolVersion version);
     ~Context();
@@ -46,6 +49,9 @@ class Context {
     const ProtocolVersion& getVersion();
 
     Connection& getConnection();
+
+    void setFtpClient(std::unique_ptr<FtpClient> ftpClient);
+    FtpClient *getFtpClient();
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index a2fb09ec..983d0925 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -709,6 +709,9 @@ class PosixFilesystemAdapter : public FilesystemAdapter {
 
         int err = 0;
         while (auto entry = readdir(dir)) {
+            if (!strcmp(entry->d_name, ".") || !strcmp(entry->d_name, "..")) {
+                continue; //files . and .. are specific to desktop systems and rarely appear on microcontroller filesystems. Filter them
+            }
             err = fn(entry->d_name);
             if (err) {
                 break;
diff --git a/src/MicroOcpp/Core/FilesystemUtils.cpp b/src/MicroOcpp/Core/FilesystemUtils.cpp
index df1285fe..a6bd916c 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.cpp
+++ b/src/MicroOcpp/Core/FilesystemUtils.cpp
@@ -117,7 +117,7 @@ bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, c
 
 bool FilesystemUtils::remove_if(std::shared_ptr<FilesystemAdapter> filesystem, std::function<bool(const char*)> pred) {
     auto ret = filesystem->ftw_root([filesystem, pred] (const char *fpath) {
-        if (pred(fpath) && fpath[0] != '.') {
+        if (pred(fpath)) {
 
             char fn [MO_MAX_PATH_SIZE] = {'\0'};
             auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "%s", fpath);
diff --git a/src/MicroOcpp/Core/Ftp.h b/src/MicroOcpp/Core/Ftp.h
index f1ab5a77..053f9e01 100644
--- a/src/MicroOcpp/Core/Ftp.h
+++ b/src/MicroOcpp/Core/Ftp.h
@@ -11,16 +11,24 @@
 extern "C" {
 #endif
 
+typedef enum {
+    MO_FtpCloseReason_Undefined,
+    MO_FtpCloseReason_Success,
+    MO_FtpCloseReason_Failure
+}   MO_FtpCloseReason;
+
 typedef struct ocpp_ftp_download {
     void *user_data; //set this at your choice. MO passes it back to the functions below
 
     void (*loop)(void *user_data);
+    void (*is_active)(void *user_data);
 } ocpp_ftp_download;
 
 typedef struct ocpp_ftp_upload {
     void *user_data; //set this at your choice. MO passes it back to the functions below
 
     void (*loop)(void *user_data);
+    void (*is_active)(void *user_data);
 } ocpp_ftp_upload;
 
 typedef struct ocpp_ftp_client {
@@ -31,7 +39,7 @@ typedef struct ocpp_ftp_client {
     ocpp_ftp_download* (*get_file)(void *user_data,
         const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
         size_t (*file_writer)(void *mo_data, unsigned char *data, size_t len),
-        void (*on_close)(void *mo_data),
+        void (*on_close)(void *mo_data, MO_FtpCloseReason reason),
         void *mo_data,
         const char *ca_cert); // nullptr to disable cert check; will be ignored for non-TLS connections
 
@@ -40,7 +48,7 @@ typedef struct ocpp_ftp_client {
     ocpp_ftp_upload* (*post_file)(void *user_data,
         const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
         size_t (*file_reader)(void *mo_data, unsigned char *buf, size_t bufsize),
-        void (*on_close)(void *mo_data),
+        void (*on_close)(void *mo_data, MO_FtpCloseReason reason),
         void *mo_data,
         const char *ca_cert); // nullptr to disable cert check; will be ignored for non-TLS connections
 
@@ -57,27 +65,32 @@ namespace MicroOcpp {
 
 class FtpDownload {
 public:
+    virtual ~FtpDownload() = default;
     virtual void loop() = 0;
+    virtual bool isActive() = 0;
 };
 
 class FtpUpload {
 public:
+    virtual ~FtpUpload() = default;
     virtual void loop() = 0;
+    virtual bool isActive() = 0;
 };
 
 class FtpClient {
 public:
+    virtual ~FtpClient() = default;
 
     virtual std::unique_ptr<FtpDownload> getFile(
                 const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
                 std::function<size_t(unsigned char *data, size_t len)> fileWriter,
-                std::function<void()> onClose,
+                std::function<void(MO_FtpCloseReason reason)> onClose,
                 const char *ca_cert = nullptr) = 0; // nullptr to disable cert check; will be ignored for non-TLS connections
 
     virtual std::unique_ptr<FtpUpload> postFile(
                 const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
                 std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, //write at most buffsize bytes into out-buffer. Return number of bytes written
-                std::function<void()> onClose,
+                std::function<void(MO_FtpCloseReason reason)> onClose,
                 const char *ca_cert = nullptr) = 0; // nullptr to disable cert check; will be ignored for non-TLS connections
 };
 
diff --git a/src/MicroOcpp/Core/FtpMbedTLS.cpp b/src/MicroOcpp/Core/FtpMbedTLS.cpp
index f5399d12..dac7bbe4 100644
--- a/src/MicroOcpp/Core/FtpMbedTLS.cpp
+++ b/src/MicroOcpp/Core/FtpMbedTLS.cpp
@@ -64,7 +64,7 @@ class FtpTransferMbedTLS : public FtpUpload, public FtpDownload {
     
     std::function<size_t(unsigned char *data, size_t len)> fileWriter;
     std::function<size_t(unsigned char *out, size_t bufsize)> fileReader;
-    std::function<void()> onClose;
+    std::function<void(MO_FtpCloseReason)> onClose;
 
     enum class Method {
         Retrieve,  //download file
@@ -78,7 +78,7 @@ class FtpTransferMbedTLS : public FtpUpload, public FtpDownload {
     int connect_ctrl();
     int connect_data();
     void close_ctrl();
-    void close_data();
+    void close_data(MO_FtpCloseReason reason);
 
     int handshake_tls();
 
@@ -97,15 +97,17 @@ class FtpTransferMbedTLS : public FtpUpload, public FtpDownload {
     ~FtpTransferMbedTLS();
 
     void loop() override;
+    
+    bool isActive() override;
 
     bool getFile(const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
             std::function<size_t(unsigned char *data, size_t len)> fileWriter,
-            std::function<void()> onClose,
+            std::function<void(MO_FtpCloseReason)> onClose,
             const char *ca_cert = nullptr); // nullptr to disable cert check; will be ignored for non-TLS connections
 
     bool postFile(const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
             std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, //write at most buffsize bytes into out-buffer. Return number of bytes written
-            std::function<void()> onClose,
+            std::function<void(MO_FtpCloseReason)> onClose,
             const char *ca_cert = nullptr); // nullptr to disable cert check; will be ignored for non-TLS connections
 };
 
@@ -120,12 +122,12 @@ class FtpClientMbedTLS : public FtpClient {
 
     std::unique_ptr<FtpDownload> getFile(const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
             std::function<size_t(unsigned char *data, size_t len)> fileWriter,
-            std::function<void()> onClose,
+            std::function<void(MO_FtpCloseReason)> onClose,
             const char *ca_cert = nullptr) override; // nullptr to disable cert check; will be ignored for non-TLS connections
 
     std::unique_ptr<FtpUpload> postFile(const char *ftp_url, // ftp[s]://[user[:pass]@]host[:port][/directory]/filename
             std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, //write at most buffsize bytes into out-buffer. Return number of bytes written
-            std::function<void()> onClose,
+            std::function<void(MO_FtpCloseReason)> onClose,
             const char *ca_cert = nullptr) override; // nullptr to disable cert check; will be ignored for non-TLS connections
 };
 
@@ -177,7 +179,7 @@ FtpTransferMbedTLS::FtpTransferMbedTLS(bool tls_only, const char *client_cert, c
 
 FtpTransferMbedTLS::~FtpTransferMbedTLS() {
     if (onClose) {
-        onClose();
+        onClose(MO_FtpCloseReason_Failure); //data connection not closed properly
         onClose = nullptr;
     }
     delete[] data_buf;
@@ -340,12 +342,12 @@ void FtpTransferMbedTLS::close_ctrl() {
     ctrl_opened = false;
 
     if (onClose && !data_opened) {
-        onClose();
+        onClose(MO_FtpCloseReason_Failure); //data connection has never been opened --> failure
         onClose = nullptr;
     }
 }
 
-void FtpTransferMbedTLS::close_data() {
+void FtpTransferMbedTLS::close_data(MO_FtpCloseReason reason) {
     if (!data_opened) {
         return;
     }
@@ -361,8 +363,8 @@ void FtpTransferMbedTLS::close_data() {
     data_opened = false;
     data_conn_accepted = false;
 
-    if (onClose && !ctrl_opened) {
-        onClose();
+    if (onClose) {
+        onClose(reason);
         onClose = nullptr;
     }
 }
@@ -437,7 +439,7 @@ void FtpTransferMbedTLS::send_cmd(const char *cmd, const char *arg, bool disable
     }
 }
 
-bool FtpTransferMbedTLS::getFile(const char *ftp_url_raw, std::function<size_t(unsigned char *data, size_t len)> fileWriter, std::function<void()> onClose, const char *ca_cert) {
+bool FtpTransferMbedTLS::getFile(const char *ftp_url_raw, std::function<size_t(unsigned char *data, size_t len)> fileWriter, std::function<void(MO_FtpCloseReason)> onClose, const char *ca_cert) {
 
     if (method != Method::UNDEFINED) {
         MO_DBG_ERR("FTP Client reuse not supported");
@@ -474,7 +476,7 @@ bool FtpTransferMbedTLS::getFile(const char *ftp_url_raw, std::function<size_t(u
     return true;
 }
 
-bool FtpTransferMbedTLS::postFile(const char *ftp_url_raw, std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, std::function<void()> onClose, const char *ca_cert) {
+bool FtpTransferMbedTLS::postFile(const char *ftp_url_raw, std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, std::function<void(MO_FtpCloseReason)> onClose, const char *ca_cert) {
     
     if (method != Method::UNDEFINED) {
         MO_DBG_ERR("FTP Client reuse not supported");
@@ -667,6 +669,7 @@ void FtpTransferMbedTLS::process_data() {
     if (isSecure && !data_ssl_established) {
         //failure to establish security policy
         MO_DBG_ERR("internal error");
+        close_data(MO_FtpCloseReason_Failure);
         send_cmd("QUIT", nullptr, true);
         return;
     }
@@ -690,11 +693,12 @@ void FtpTransferMbedTLS::process_data() {
                 return;
             } else if (ret == MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY || ret == 0) {
                 //download finished
-                close_data();
+                close_data(MO_FtpCloseReason_Success);
                 return;
             } else if (ret < 0) {
                 MO_DBG_ERR("mbedtls_net_recv: %i", ret);
-                close_data();
+                close_data(MO_FtpCloseReason_Failure);
+                send_cmd("QUIT");
                 return;
             }
 
@@ -703,11 +707,17 @@ void FtpTransferMbedTLS::process_data() {
 
         auto ret = fileWriter(data_buf + data_buf_offs, data_buf_avail);
 
-        if (ret <= data_buf_avail) {
+        if (ret == 0) {
+            MO_DBG_ERR("fileWriter aborted download");
+            close_data(MO_FtpCloseReason_Failure);
+            send_cmd("QUIT");
+            return;
+        } else if (ret <= data_buf_avail) {
             data_buf_avail -= ret;
             data_buf_offs += ret;
         } else {
             MO_DBG_ERR("write error");
+            close_data(MO_FtpCloseReason_Failure);
             send_cmd("QUIT");
             return;
         }
@@ -737,6 +747,7 @@ void FtpTransferMbedTLS::process_data() {
                 return;
             } else if (ret <= 0) {
                 MO_DBG_ERR("mbedtls_ssl_write: %i", ret);
+                close_data(MO_FtpCloseReason_Failure);
                 send_cmd("QUIT");
                 return;
             }
@@ -747,7 +758,7 @@ void FtpTransferMbedTLS::process_data() {
         } else {
             //no data in fileReader anymore
             MO_DBG_DEBUG("finished file reading");
-            close_data();
+            close_data(MO_FtpCloseReason_Success);
         }
     }
 }
@@ -763,6 +774,10 @@ void FtpTransferMbedTLS::loop() {
     }
 }
 
+bool FtpTransferMbedTLS::isActive() {
+    return ctrl_opened || data_opened;
+}
+
 bool FtpTransferMbedTLS::read_url_ctrl(const char *ftp_url_raw) {
     std::string ftp_url = ftp_url_raw; //copy input ftp_url
 
@@ -888,7 +903,7 @@ FtpClientMbedTLS::FtpClientMbedTLS(bool tls_only, const char *client_cert, const
 
 }
 
-std::unique_ptr<FtpDownload> FtpClientMbedTLS::getFile(const char *ftp_url_raw, std::function<size_t(unsigned char *data, size_t len)> fileWriter, std::function<void()> onClose, const char *ca_cert) {
+std::unique_ptr<FtpDownload> FtpClientMbedTLS::getFile(const char *ftp_url_raw, std::function<size_t(unsigned char *data, size_t len)> fileWriter, std::function<void(MO_FtpCloseReason)> onClose, const char *ca_cert) {
 
     auto ftp_handle = std::unique_ptr<FtpTransferMbedTLS>(new FtpTransferMbedTLS(tls_only, client_cert, client_key));
     if (!ftp_handle) {
@@ -905,7 +920,7 @@ std::unique_ptr<FtpDownload> FtpClientMbedTLS::getFile(const char *ftp_url_raw,
     }
 }
 
-std::unique_ptr<FtpUpload> FtpClientMbedTLS::postFile(const char *ftp_url_raw, std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, std::function<void()> onClose, const char *ca_cert) {
+std::unique_ptr<FtpUpload> FtpClientMbedTLS::postFile(const char *ftp_url_raw, std::function<size_t(unsigned char *out, size_t buffsize)> fileReader, std::function<void(MO_FtpCloseReason)> onClose, const char *ca_cert) {
     
     auto ftp_handle = std::unique_ptr<FtpTransferMbedTLS>(new FtpTransferMbedTLS(tls_only, client_cert, client_key));
     if (!ftp_handle) {
diff --git a/src/MicroOcpp/Core/Time.h b/src/MicroOcpp/Core/Time.h
index ab363175..01af04bb 100644
--- a/src/MicroOcpp/Core/Time.h
+++ b/src/MicroOcpp/Core/Time.h
@@ -11,7 +11,7 @@
 
 #include <MicroOcpp/Platform.h>
 
-#define JSONDATE_LENGTH 24
+#define JSONDATE_LENGTH 24   //max. ISO 8601 date length, excluding the terminating zero
 
 namespace MicroOcpp {
 
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 90a86e46..a46737df 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -11,6 +11,14 @@
 #include <MicroOcpp/Operations/GetDiagnostics.h>
 #include <MicroOcpp/Operations/DiagnosticsStatusNotification.h>
 
+//Fetch relevant data from other modules for diagnostics
+#include <MicroOcpp/Model/Boot/BootService.h>
+#include <MicroOcpp/Operations/StatusNotification.h> //for serializing ChargePointStatus
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Version.h> //for MO_ENABLE_V201
+#include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h> //for MO_ENABLE_CONNECTOR_LOCK
+
 using namespace MicroOcpp;
 using Ocpp16::DiagnosticsStatus;
 
@@ -24,7 +32,26 @@ DiagnosticsService::DiagnosticsService(Context& context) : context(context) {
         return new Ocpp16::DiagnosticsStatusNotification(getDiagnosticsStatus());});
 }
 
+DiagnosticsService::~DiagnosticsService() {
+    free(diagPreamble);
+    free(diagPostamble);
+}
+
 void DiagnosticsService::loop() {
+
+    if (ftpUpload && ftpUpload->isActive()) {
+        ftpUpload->loop();
+    }
+
+    if (ftpUpload) {
+        if (ftpUpload->isActive()) {
+            ftpUpload->loop();
+        } else {
+            MO_DBG_DEBUG("Deinit FTP upload");
+            ftpUpload.reset();
+        }
+    }
+
     auto notification = getDiagnosticsStatusNotification();
     if (notification) {
         context.initiateRequest(std::move(notification));
@@ -38,10 +65,12 @@ void DiagnosticsService::loop() {
                 MO_DBG_DEBUG("Call onUpload");
                 onUpload(location.c_str(), startTime, stopTime);
                 uploadIssued = true;
+                uploadFailure = false;
             } else {
                 MO_DBG_ERR("onUpload must be set! (see setOnUpload). Will abort");
                 retries = 0;
                 uploadIssued = false;
+                uploadFailure = true;
             }
         }
 
@@ -65,8 +94,10 @@ void DiagnosticsService::loop() {
                     uploadIssued = false;
                     retries = 0;
                 } else {
-                    //either we have UploadFailed status or (NotDownloaded + timeout) here
+                    //either we have UploadFailed status or (NotUploaded + timeout) here
                     MO_DBG_WARN("Upload timeout or failed");
+                    ftpUpload.reset();
+
                     const int TRANSITION_DELAY = 10;
                     if (retryInterval <= UPLOAD_TIMEOUT + TRANSITION_DELAY) {
                         nextTry = timestampNow;
@@ -75,6 +106,11 @@ void DiagnosticsService::loop() {
                         nextTry += retryInterval;
                     }
                     retries--;
+
+                    if (retries == 0) {
+                        MO_DBG_DEBUG("end upload routine (no more retry)");
+                        uploadFailure = true;
+                    }
                 }
             }
         } //end if (uploadIssued)
@@ -83,10 +119,26 @@ void DiagnosticsService::loop() {
 
 //timestamps before year 2021 will be treated as "undefined"
 std::string DiagnosticsService::requestDiagnosticsUpload(const char *location, unsigned int retries, unsigned int retryInterval, Timestamp startTime, Timestamp stopTime) {
-    if (onUpload == nullptr) //maybe add further plausibility checks
+    if (onUpload == nullptr) {
         return std::string{};
-    
+    }
+
+    std::string fileName;
+    if (refreshFilename) {
+        fileName = refreshFilename();
+    } else {
+        fileName = "diagnostics.log";
+    }
+
+    this->location.reserve(strlen(location) + 1 + fileName.size());
+
     this->location = location;
+
+    if (!this->location.empty() && this->location.back() != '/') {
+        this->location.append("/");
+    }
+    this->location.append(fileName.c_str());
+
     this->retries = retries;
     this->retryInterval = retryInterval;
     this->startTime = startTime;
@@ -133,16 +185,14 @@ std::string DiagnosticsService::requestDiagnosticsUpload(const char *location, u
     }
 #endif
 
-    std::string fileName;
-    if (refreshFilename) {
-        fileName = refreshFilename();
-    } else {
-        fileName = "diagnostics.log";
-    }
     return fileName;
 }
 
 DiagnosticsStatus DiagnosticsService::getDiagnosticsStatus() {
+    if (uploadFailure) {
+        return DiagnosticsStatus::UploadFailed;
+    }
+
     if (uploadIssued) {
         if (uploadStatusInput != nullptr) {
             switch (uploadStatusInput()) {
@@ -184,3 +234,318 @@ void DiagnosticsService::setOnUpload(std::function<bool(const char *location, Ti
 void DiagnosticsService::setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput) {
     this->uploadStatusInput = uploadStatusInput;
 }
+
+void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, size_t size)> diagnosticsReader, std::function<void()> onClose, std::shared_ptr<FilesystemAdapter> filesystem) {
+
+    this->onUpload = [this, diagnosticsReader, onClose, filesystem] (const char *location, Timestamp &startTime, Timestamp &stopTime) -> bool {
+
+        auto ftpClient = context.getFtpClient();
+        if (!ftpClient) {
+            MO_DBG_ERR("FTP client not set");
+            this->ftpUploadStatus = UploadStatus::UploadFailed;
+            return false;
+        }
+
+        const size_t diagPreambleSize = 128;
+        diagPreamble = (char*) malloc(diagPreambleSize);
+        if (!diagPreamble) {
+            MO_DBG_ERR("OOM");
+            this->ftpUploadStatus = UploadStatus::UploadFailed;
+            return false;
+        }
+        diagPreambleLen = 0;
+        diagPreambleTransferred = 0;
+
+        diagReaderHasData = diagnosticsReader ? true : false;
+
+        const size_t diagPostambleSize = 1024;
+        diagPostamble = (char*) malloc(diagPostambleSize);
+        if (!diagPostamble) {
+            MO_DBG_ERR("OOM");
+            this->ftpUploadStatus = UploadStatus::UploadFailed;
+            free(diagPreamble);
+            return false;
+        }
+        diagPostambleLen = 0;
+        diagPostambleTransferred = 0;
+
+        auto& model = context.getModel();
+
+        std::string cpModel;
+        std::string fwVersion;
+
+        if (auto bootService = model.getBootService()) {
+            if (auto cpCreds = bootService->getChargePointCredentials()) {
+                cpModel = (*cpCreds)["chargePointModel"] | "Charger";
+                fwVersion = (*cpCreds)["firmwareVersion"] | "";
+            }
+        }
+
+        char jsonDate [JSONDATE_LENGTH + 1];
+        model.getClock().now().toJsonString(jsonDate, sizeof(jsonDate));
+
+        int ret;
+
+        ret = snprintf(diagPreamble, diagPreambleSize,
+                "### %s Hardware Diagnostics%s%s\n%s\n",
+                cpModel.c_str(),
+                fwVersion.empty() ? "" : " - v. ", fwVersion.c_str(),
+                jsonDate);
+
+        if (ret < 0 || (size_t)ret >= diagPreambleSize) {
+            MO_DBG_ERR("snprintf: %i", ret);
+            this->ftpUploadStatus = UploadStatus::UploadFailed;
+            free(diagPreamble);
+            free(diagPostamble);
+            return false;
+        }
+
+        diagPreambleLen += (size_t)ret;
+
+        Connector *connector0 = model.getConnector(0);
+        Connector *connector1 = model.getConnector(1);
+        Transaction *connector1Tx = connector1 ? connector1->getTransaction().get() : nullptr;
+        Connector *connector2 = model.getNumConnectors() > 2 ? model.getConnector(2) : nullptr;
+        Transaction *connector2Tx = connector2 ? connector2->getTransaction().get() : nullptr;
+
+        ret = 0;
+
+        if (ret >= 0 && (size_t)ret + diagPostambleLen < diagPostambleSize) {
+            diagPostambleLen += (size_t)ret;
+            ret = snprintf(diagPostamble + diagPostambleLen, diagPostambleSize - diagPostambleLen,
+                "\n# OCPP"
+                "\nclient_version=%s"
+                "\nuptime=%lus"
+                "%s%s"
+                "%s%s"
+                "%s%s"
+                "\nws_status=%s"
+                "\nws_last_conn=%lus"
+                "\nws_last_recv=%lus"
+                "%s%s"
+                "%s%s"
+                "%s%s"
+                "%s%s"
+                "%s%s"
+                "%s%s"
+                "%s%s"
+                "%s%s"
+                "\nENABLE_CONNECTOR_LOCK=%i"
+                "\nENABLE_FILE_INDEX=%i"
+                "\nENABLE_V201=%i"
+                "\n",
+                MO_VERSION,
+                mocpp_tick_ms() / 1000UL,
+                connector0 ? "\nocpp_status_cId0=" : "", connector0 ? cstrFromOcppEveState(connector0->getStatus()) : "",
+                connector1 ? "\nocpp_status_cId1=" : "", connector1 ? cstrFromOcppEveState(connector1->getStatus()) : "",
+                connector2 ? "\nocpp_status_cId2=" : "", connector2 ? cstrFromOcppEveState(connector2->getStatus()) : "",
+                context.getConnection().isConnected() ? "connected" : "unconnected",
+                context.getConnection().getLastConnected() / 1000UL,
+                context.getConnection().getLastRecv() / 1000UL,
+                connector1 ? "\ncId1_hasTx=" : "", connector1 ? (connector1Tx ? "1" : "0") : "",
+                connector1Tx ? "\ncId1_txActive=" : "", connector1Tx ? (connector1Tx->isActive() ? "1" : "0") : "",
+                connector1Tx ? "\ncId1_txHasStarted=" : "", connector1Tx ? (connector1Tx->getStartSync().isRequested() ? "1" : "0") : "",
+                connector1Tx ? "\ncId1_txHasStopped=" : "", connector1Tx ? (connector1Tx->getStopSync().isRequested() ? "1" : "0") : "",
+                connector2 ? "\ncId2_hasTx=" : "", connector2 ? (connector2Tx ? "1" : "0") : "",
+                connector2Tx ? "\ncId2_txActive=" : "", connector2Tx ? (connector2Tx->isActive() ? "1" : "0") : "",
+                connector2Tx ? "\ncId2_txHasStarted=" : "", connector2Tx ? (connector2Tx->getStartSync().isRequested() ? "1" : "0") : "",
+                connector2Tx ? "\ncId2_txHasStopped=" : "", connector2Tx ? (connector2Tx->getStopSync().isRequested() ? "1" : "0") : "",
+                MO_ENABLE_CONNECTOR_LOCK,
+                MO_ENABLE_FILE_INDEX,
+                MO_ENABLE_V201
+                );
+        }
+
+        if (filesystem) {
+
+            if (ret >= 0 && (size_t)ret + diagPostambleLen < diagPostambleSize) {
+                diagPostambleLen += (size_t)ret;
+                ret = snprintf(diagPostamble + diagPostambleLen, diagPostambleSize - diagPostambleLen, "\n# Filesystem\n");
+            }
+
+            filesystem->ftw_root([this, &ret] (const char *fname) -> int {
+                if (ret >= 0 && (size_t)ret + diagPostambleLen < diagPostambleSize) {
+                    diagPostambleLen += (size_t)ret;
+                    ret = snprintf(diagPostamble + diagPostambleLen, diagPostambleSize - diagPostambleLen, "%s\n", fname);
+                }
+                diagFileList.emplace_back(fname);
+                return 0;
+            });
+
+            MO_DBG_DEBUG("discovered %zu files", diagFileList.size());
+        }
+
+        if (ret >= 0 && (size_t)ret + diagPostambleLen < diagPostambleSize) {
+            diagPostambleLen += (size_t)ret;
+        } else {
+            char errMsg [64];
+            auto errLen = snprintf(errMsg, sizeof(errMsg), "\n[Diagnostics cut]\n");
+            size_t ellipseStart = std::min(diagPostambleSize - (size_t)errLen - 1, diagPostambleLen);
+            auto ret2 = snprintf(diagPostamble + ellipseStart, diagPostambleSize - ellipseStart, "%s", errMsg);
+            diagPostambleLen += (size_t)ret2;
+        }
+
+        this->ftpUpload = ftpClient->postFile(location,
+            [this, diagnosticsReader, filesystem] (unsigned char *buf, size_t size) -> size_t {
+                size_t written = 0;
+                if (written < size && diagPreambleTransferred < diagPreambleLen) {
+                    size_t writeLen = std::min(size - written, diagPreambleLen - diagPreambleTransferred);
+                    memcpy(buf + written, diagPreamble + diagPreambleTransferred, writeLen);
+                    diagPreambleTransferred += writeLen;
+                    written += writeLen;
+                }
+
+                while (written < size && diagReaderHasData && diagnosticsReader) {
+                    size_t writeLen = diagnosticsReader((char*)buf + written, size - written);
+                    if (writeLen == 0) {
+                        diagReaderHasData = false;
+                    }
+                    written += writeLen;
+                }
+
+                if (written < size && diagPostambleTransferred < diagPostambleLen) {
+                    size_t writeLen = std::min(size - written, diagPostambleLen - diagPostambleTransferred);
+                    memcpy(buf + written, diagPostamble + diagPostambleTransferred, writeLen);
+                    diagPostambleTransferred += writeLen;
+                    written += writeLen;
+                }
+
+                while (written < size && !diagFileList.empty() && filesystem) {
+
+                    char fpath [MO_MAX_PATH_SIZE];
+                    auto ret = snprintf(fpath, sizeof(fpath), "%s%s", MO_FILENAME_PREFIX, diagFileList.front().c_str());
+                    if (ret < 0 || (size_t)ret >= sizeof(fpath)) {
+                        MO_DBG_ERR("fn error: %i", ret);
+                        diagFileList.pop_front();
+                        continue;
+                    }
+
+                    if (auto file = filesystem->open(fpath, "r")) {
+
+                        if (diagFilesFrontTransferred == 0) {
+                            char fileHeading [30 + MO_MAX_PATH_SIZE];
+                            auto writeLen = snprintf(fileHeading, sizeof(fileHeading), "\n\n# File %s:\n", diagFileList.front().c_str());
+                            if (writeLen < 0 || (size_t)writeLen >= sizeof(fileHeading)) {
+                                MO_DBG_ERR("fn error: %i", ret);
+                                diagFileList.pop_front();
+                                continue;
+                            }
+                            if (writeLen + written > size || //heading doesn't fit anymore, return with a bit unused buffer space and print heading the next time
+                                    writeLen + written == size) { //filling the buffer up exactly would mean that no file payload is written and this head gets printed again
+                                
+                                MO_DBG_DEBUG("upload diag chunk (%zuB)", written);
+                                return written;
+                            }
+
+                            memcpy(buf + written, fileHeading, (size_t)writeLen);
+                            written += (size_t)writeLen;
+                        }
+
+                        file->seek(diagFilesFrontTransferred);
+                        size_t writeLen = file->read((char*)buf + written, size - written);
+
+                        if (writeLen < size - written) {
+                            diagFileList.pop_front();
+                        }
+                        written += writeLen;
+                    } else {
+                        MO_DBG_ERR("could not open file: %s", fpath);
+                        diagFileList.pop_front();
+                    }
+                }
+
+                MO_DBG_DEBUG("upload diag chunk (%zuB)", written);
+                return written;
+            },
+            [this, onClose] (MO_FtpCloseReason reason) -> void {
+                if (reason == MO_FtpCloseReason_Success) {
+                    MO_DBG_INFO("FTP upload success");
+                    this->ftpUploadStatus = UploadStatus::Uploaded;
+                } else {
+                    MO_DBG_INFO("FTP upload failure (%i)", reason);
+                    this->ftpUploadStatus = UploadStatus::UploadFailed;
+                }
+
+                free(diagPreamble);
+                free(diagPostamble);
+                diagFileList.clear();
+
+                if (onClose) {
+                    onClose();
+                }
+            });
+
+        if (this->ftpUpload) {
+            this->ftpUploadStatus = UploadStatus::NotUploaded;
+            return true;
+        } else {
+            this->ftpUploadStatus = UploadStatus::UploadFailed;
+            return false;
+        }
+    };
+
+    this->uploadStatusInput = [this] () {
+        return this->ftpUploadStatus;
+    };
+}
+
+void DiagnosticsService::setFtpServerCert(const char *cert) {
+    this->ftpServerCert = cert;
+}
+
+#if !defined(MO_CUSTOM_DIAGNOSTICS)
+
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP32) && MO_ENABLE_MBEDTLS
+
+#include "esp_heap_caps.h"
+#include <LittleFS.h>
+
+bool g_diagsSent = false;
+
+std::unique_ptr<DiagnosticsService> MicroOcpp::makeDefaultDiagnosticsService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) {
+    std::unique_ptr<DiagnosticsService> diagService = std::unique_ptr<DiagnosticsService>(new DiagnosticsService(context));
+
+    diagService->setDiagnosticsReader(
+        [] (char *buf, size_t size) -> size_t {
+            if (!g_diagsSent) {
+                g_diagsSent = true;
+                int ret = snprintf(buf, size,
+                    "\n# Memory\n"
+                    "freeHeap=%zu\n"
+                    "minHeap=%zu\n"
+                    "maxAllocHeap=%zu\n"
+                    "LittleFS_used=%zu\n"
+                    "LittleFS_total=%zu\n",
+                    heap_caps_get_free_size(MALLOC_CAP_DEFAULT),
+                    heap_caps_get_minimum_free_size(MALLOC_CAP_DEFAULT),
+                    heap_caps_get_largest_free_block(MALLOC_CAP_DEFAULT),
+                    LittleFS.usedBytes(),
+                    LittleFS.totalBytes()
+                );
+                if (ret < 0 || (size_t)ret >= size) {
+                    MO_DBG_ERR("snprintf: %i", ret);
+                    return 0;
+                }
+                return (size_t)ret;
+            }
+            return 0;
+        }, [] () {
+            g_diagsSent = false;
+        },
+        filesystem);
+
+    return diagService;
+}
+
+#elif MO_ENABLE_MBEDTLS
+
+std::unique_ptr<DiagnosticsService> MicroOcpp::makeDefaultDiagnosticsService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) {
+    std::unique_ptr<DiagnosticsService> diagService = std::unique_ptr<DiagnosticsService>(new DiagnosticsService(context));
+
+    diagService->setDiagnosticsReader(nullptr, nullptr, filesystem); //report the built-in MO defaults
+
+    return diagService;
+}
+
+#endif //MO_PLATFORM
+#endif //!defined(MO_CUSTOM_DIAGNOSTICS)
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
index 536538a0..7df0e788 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -7,9 +7,11 @@
 
 #include <functional>
 #include <memory>
+#include <string>
+#include <deque>
 #include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Ftp.h>
 #include <MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h>
-#include <string>
 
 namespace MicroOcpp {
 
@@ -21,6 +23,7 @@ enum class UploadStatus {
 
 class Context;
 class Request;
+class FilesystemAdapter;
 
 class DiagnosticsService {
 private:
@@ -38,6 +41,20 @@ class DiagnosticsService {
     std::function<bool(const char *location, Timestamp &startTime, Timestamp &stopTime)> onUpload;
     std::function<UploadStatus()> uploadStatusInput;
     bool uploadIssued = false;
+    bool uploadFailure = false;
+
+    std::unique_ptr<FtpUpload> ftpUpload;
+    UploadStatus ftpUploadStatus = UploadStatus::NotUploaded;
+    const char *ftpServerCert = nullptr;
+    char *diagPreamble = nullptr;
+    size_t diagPreambleLen = 0;
+    size_t diagPreambleTransferred = 0;
+    bool diagReaderHasData = false;
+    char *diagPostamble = nullptr;
+    size_t diagPostambleLen = 0;
+    size_t diagPostambleTransferred = 0;
+    std::deque<std::string> diagFileList;
+    size_t diagFilesFrontTransferred = 0;
 
     std::unique_ptr<Request> getDiagnosticsStatusNotification();
 
@@ -45,6 +62,7 @@ class DiagnosticsService {
 
 public:
     DiagnosticsService(Context& context);
+    ~DiagnosticsService();
 
     void loop();
 
@@ -57,6 +75,28 @@ class DiagnosticsService {
 
     void setRefreshFilename(std::function<std::string()> refreshFn); //refresh a new filename which will be used for the subsequent upload tries
 
+    /*
+     * Sets the diagnostics data reader. When the server sends a GetDiagnostics operation, then MO will open an FTP
+     * connection to the FTP server and upload a diagnostics file. MO automatically creates a small report about
+     * the OCPP-related status data + it uploads the contents of the OCPP directory. In addition to the automatic
+     * report, MO also sends all data provided by the custom diagnosticsReader. Use the diagnosticsReader to add
+     * all data which could be helpful for troubleshooting, i.e.
+     *     - internal status variables, or state machine states
+     *     - error trip counters
+     *     - current sensor readings and all GPIO values
+     *     - Heap statistics, flash memory statistics
+     *     - and more. The more the better
+     *
+     * MO calls the diagnosticsReader output buffer `buf` and the bufsize `size`. Write at most `size` bytes and
+     * return the number of bytes actually written (without terminating zero-byte). It's not necessary to append
+     * a terminating zero, MO will ignore any data after the string. To end the reading process, return 0.
+     *
+     * Note that this function only works if MO_ENABLE_MBEDTLS=1, or MO has been configured with a custom FTP client
+     */
+    void setDiagnosticsReader(std::function<size_t(char *buf, size_t size)> diagnosticsReader, std::function<void()> onClose, std::shared_ptr<FilesystemAdapter> filesystem);
+
+    void setFtpServerCert(const char *cert); //zero-copy mode, i.e. cert must outlive MO
+
     void setOnUpload(std::function<bool(const char *location, Timestamp &startTime, Timestamp &stopTime)> onUpload);
 
     void setOnUploadStatusInput(std::function<UploadStatus()> uploadStatusInput);
@@ -64,4 +104,21 @@ class DiagnosticsService {
 
 } //end namespace MicroOcpp
 
+#if !defined(MO_CUSTOM_DIAGNOSTICS)
+
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP32) && MO_ENABLE_MBEDTLS
+
+namespace MicroOcpp {
+std::unique_ptr<DiagnosticsService> makeDefaultDiagnosticsService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem);
+}
+
+#elif MO_ENABLE_MBEDTLS
+
+namespace MicroOcpp {
+std::unique_ptr<DiagnosticsService> makeDefaultDiagnosticsService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem);
+}
+
+#endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP32) && MO_ENABLE_MBEDTLS
+#endif //!defined(MO_CUSTOM_DIAGNOSTICS)
+
 #endif
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index a8036f6b..ee59ae47 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -44,6 +44,20 @@ void FirmwareService::setBuildNumber(const char *buildNumber) {
 }
 
 void FirmwareService::loop() {
+
+    if (ftpDownload && ftpDownload->isActive()) {
+        ftpDownload->loop();
+    }
+
+    if (ftpDownload) {
+        if (ftpDownload->isActive()) {
+            ftpDownload->loop();
+        } else {
+            MO_DBG_DEBUG("Deinit FTP download");
+            ftpDownload.reset();
+        }
+    }
+
     auto notification = getFirmwareStatusNotification();
     if (notification) {
         context.initiateRequest(std::move(notification));
@@ -69,7 +83,7 @@ void FirmwareService::loop() {
                 downloadIssued = true;
                 stage = UpdateStage::AwaitDownload;
                 timestampTransition = mocpp_tick_ms();
-                delayTransition = 5000; //delay between state "Downloading" and actually starting the download
+                delayTransition = 2000; //delay between state "Downloading" and actually starting the download
                 return;
             }
         }
@@ -94,7 +108,7 @@ void FirmwareService::loop() {
                     //passed download stage
                     stage = UpdateStage::AfterDownload;
                 } else if (downloadStatusInput() == DownloadStatus::DownloadFailed) {
-                    MO_DBG_INFO("Download timeout or failed! Retry");
+                    MO_DBG_INFO("Download timeout or failed");
                     retreiveDate = timestampNow;
                     retreiveDate += retryInterval;
                     retries--;
@@ -106,9 +120,7 @@ void FirmwareService::loop() {
                 return;
             } else {
                 //if client doesn't report download state, assume download to be finished (at least 30s download time have passed until here)
-                if (downloadStatusInput == nullptr) {
-                    stage = UpdateStage::AfterDownload;
-                }
+                stage = UpdateStage::AfterDownload;
             }
         }
 
@@ -123,11 +135,14 @@ void FirmwareService::loop() {
             }
 
             if (!ongoingTx) {
-                stage = UpdateStage::AwaitInstallation;
-                installationIssued = true;
-
+                if (onInstall == nullptr) {
+                    stage = UpdateStage::Installing;
+                } else {
+                    stage = UpdateStage::AwaitInstallation;
+                }
                 timestampTransition = mocpp_tick_ms();
-                delayTransition = 10000;
+                delayTransition = 2000;
+                installationIssued = true;
             }
 
             return;
@@ -138,13 +153,11 @@ void FirmwareService::loop() {
             stage = UpdateStage::Installing;
 
             if (onInstall) {
-                onInstall(location.c_str()); //should restart the device on success
-            } else {
-                MO_DBG_WARN("onInstall must be set! (see setOnInstall). Will abort");
-            }
+                onInstall(location.c_str()); //may restart the device on success
 
-            timestampTransition = mocpp_tick_ms();
-            delayTransition = installationStatusInput ? 1000 : 120 * 1000;
+                timestampTransition = mocpp_tick_ms();
+                delayTransition = installationStatusInput ? 1000 : 120 * 1000;
+            }
             return;
         }
 
@@ -153,9 +166,11 @@ void FirmwareService::loop() {
             if (installationStatusInput) {
                 if (installationStatusInput() == InstallationStatus::Installed) {
                     MO_DBG_INFO("FW update finished");
-                    //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
+                    //Charger may reboot during onInstall. If it doesn't, server will send Reset request
                     resetStage();
-                    retries = 0; //End of update routine. Client must reboot on its own
+                    retries = 0; //End of update routine
+                    stage = UpdateStage::Installed;
+                    location.clear();
                 } else if (installationStatusInput() == InstallationStatus::InstallationFailed) {
                     MO_DBG_INFO("Installation timeout or failed! Retry");
                     retreiveDate = timestampNow;
@@ -169,9 +184,11 @@ void FirmwareService::loop() {
                 return;
             } else {
                 MO_DBG_INFO("FW update finished");
-                //Client should reboot during onInstall. If not, client is responsible to reboot at a later point
+                //Charger may reboot during onInstall. If it doesn't, server will send Reset request
                 resetStage();
-                retries = 0; //End of update routine. Client must reboot on its own
+                stage = UpdateStage::Installed;
+                retries = 0; //End of update routine
+                location.clear();
                 return;
             }
         }
@@ -180,10 +197,19 @@ void FirmwareService::loop() {
         MO_DBG_ERR("Firmware update failed");
         retries = 0;
         resetStage();
+        stage = UpdateStage::InternalError;
+        location.clear();
     }
 }
 
 void FirmwareService::scheduleFirmwareUpdate(const char *location, Timestamp retreiveDate, unsigned int retries, unsigned int retryInterval) {
+
+    if (!onDownload && !onInstall) {
+        MO_DBG_ERR("FW service not configured");
+        stage = UpdateStage::InternalError; //will send "InstallationFailed" and not proceed with update
+        return;
+    }
+
     this->location = location;
     this->retreiveDate = retreiveDate;
     this->retries = retries;
@@ -197,7 +223,6 @@ void FirmwareService::scheduleFirmwareUpdate(const char *location, Timestamp ret
     char dbuf [JSONDATE_LENGTH + 1] = {'\0'};
     this->retreiveDate.toJsonString(dbuf, JSONDATE_LENGTH + 1);
 
-#if MO_DBG_LEVEL >= MO_DL_INFO
     MO_DBG_INFO("Scheduled FW update!\n" \
                     "                  location = %s\n" \
                     "                  retrieveDate = %s\n" \
@@ -207,7 +232,6 @@ void FirmwareService::scheduleFirmwareUpdate(const char *location, Timestamp ret
             dbuf,
             this->retries,
             this->retryInterval);
-#endif
 
     timestampTransition = mocpp_tick_ms();
     delayTransition = 1000;
@@ -216,6 +240,13 @@ void FirmwareService::scheduleFirmwareUpdate(const char *location, Timestamp ret
 }
 
 FirmwareStatus FirmwareService::getFirmwareStatus() {
+
+    if (stage == UpdateStage::Installed) {
+        return FirmwareStatus::Installed;
+    } else if (stage == UpdateStage::InternalError) {
+        return FirmwareStatus::InstallationFailed; 
+    }
+
     if (installationIssued) {
         if (installationStatusInput != nullptr) {
             if (installationStatusInput() == InstallationStatus::Installed) {
@@ -268,7 +299,7 @@ std::unique_ptr<Request> FirmwareService::getFirmwareStatusNotification() {
 
     if (getFirmwareStatus() != lastReportedStatus) {
         lastReportedStatus = getFirmwareStatus();
-        if (lastReportedStatus != FirmwareStatus::Idle && lastReportedStatus != FirmwareStatus::Installed) {
+        if (lastReportedStatus != FirmwareStatus::Idle) {
             auto fwNotificationMsg = new Ocpp16::FirmwareStatusNotification(lastReportedStatus);
             auto fwNotification = makeRequest(fwNotificationMsg);
             return fwNotification;
@@ -300,59 +331,113 @@ void FirmwareService::resetStage() {
     installationIssued = false;
 }
 
-#if MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
-#if defined(ESP32)
+void FirmwareService::setDownloadFileWriter(std::function<size_t(const unsigned char *buf, size_t size)> firmwareWriter, std::function<void(MO_FtpCloseReason)> onClose) {
 
-#include <HTTPUpdate.h>
+    this->onDownload = [this, firmwareWriter, onClose] (const char *location) -> bool {
 
-FirmwareService *MicroOcpp::makeDefaultFirmwareService(Context& context) {
-    FirmwareService *fwService = new FirmwareService(context);
+        auto ftpClient = context.getFtpClient();
+        if (!ftpClient) {
+            MO_DBG_ERR("FTP client not set");
+            this->ftpDownloadStatus = DownloadStatus::DownloadFailed;
+            return false;
+        }
 
-    /*
-     * example of how to integrate a separate download phase (optional)
-     */
-#if 0 //separate download phase
-    fwService->setOnDownload([] (const char *location) {
-        //download the new binary
-        //...
-        return true;
-    });
+        this->ftpDownload = ftpClient->getFile(location, firmwareWriter,
+            [this, onClose] (MO_FtpCloseReason reason) -> void {
+                if (reason == MO_FtpCloseReason_Success) {
+                    MO_DBG_INFO("FTP download success");
+                    this->ftpDownloadStatus = DownloadStatus::Downloaded;
+                } else {
+                    MO_DBG_INFO("FTP download failure (%i)", reason);
+                    this->ftpDownloadStatus = DownloadStatus::DownloadFailed;
+                }
 
-    fwService->setDownloadStatusInput([] () {
-        //report the download progress
-        //...
-        return DownloadStatus::NotDownloaded;
-    });
-#endif //separate download phase
+                onClose(reason);
+            });
+
+        if (this->ftpDownload) {
+            this->ftpDownloadStatus = DownloadStatus::NotDownloaded;
+            return true;
+        } else {
+            this->ftpDownloadStatus = DownloadStatus::DownloadFailed;
+            return false;
+        }
+    };
 
-    fwService->setOnInstall([fwService] (const char *location) {
+    this->downloadStatusInput = [this] () {
+        return this->ftpDownloadStatus;
+    };
+}
 
-        MO_DBG_WARN("Built-in updater for ESP32 is only intended for demonstration purposes. HTTP support only");
+void FirmwareService::setFtpServerCert(const char *cert) {
+    this->ftpServerCert = cert;
+}
 
-        fwService->setInstallationStatusInput([](){return InstallationStatus::NotInstalled;});
+#if !defined(MO_CUSTOM_UPDATER)
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP32) && MO_ENABLE_MBEDTLS
 
-        WiFiClient client;
-        //WiFiClientSecure client;
-        //client.setCACert(rootCACertificate);
-        client.setTimeout(60); //in seconds
-        
-        // httpUpdate.setLedPin(LED_BUILTIN, HIGH);
-        t_httpUpdate_return ret = httpUpdate.update(client, location);
+#include <Update.h>
 
-        switch (ret) {
-            case HTTP_UPDATE_FAILED:
-                fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                MO_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", httpUpdate.getLastError(), httpUpdate.getLastErrorString().c_str());
-                break;
-            case HTTP_UPDATE_NO_UPDATES:
-                fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
-                MO_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
-                break;
-            case HTTP_UPDATE_OK:
-                fwService->setInstallationStatusInput([](){return InstallationStatus::Installed;});
-                MO_DBG_INFO("HTTP_UPDATE_OK");
-                ESP.restart();
-                break;
+std::unique_ptr<FirmwareService> MicroOcpp::makeDefaultFirmwareService(Context& context) {
+    std::unique_ptr<FirmwareService> fwService = std::unique_ptr<FirmwareService>(new FirmwareService(context));
+    auto ftServicePtr = fwService.get();
+
+    fwService->setDownloadFileWriter(
+        [ftServicePtr] (const unsigned char *data, size_t size) -> size_t {
+            if (!Update.isRunning()) {
+                MO_DBG_DEBUG("start writing FW");
+                MO_DBG_WARN("Built-in updater for ESP32 is only intended for demonstration purposes");
+                ftServicePtr->setInstallationStatusInput([](){return InstallationStatus::NotInstalled;});
+
+                auto ret = Update.begin();
+                if (!ret) {
+                    MO_DBG_ERR("cannot start update: %i", ret);
+                    return 0;
+                }
+            }
+
+            size_t written = Update.write((uint8_t*) data, size);
+
+            #if MO_DBG_LEVEL >= MO_DL_INFO
+            {
+                size_t progress = Update.progress();
+
+                bool printProgress = false;
+
+                if (progress <= 10000) {
+                    size_t p1k = progress / 1000;
+                    printProgress = progress < p1k * 1000 + written && progress >= p1k * 1000;
+                } else if (progress <= 100000) {
+                    size_t p10k = progress / 10000;
+                    printProgress = progress < p10k * 10000 + written && progress >= p10k * 10000;
+                } else {
+                    size_t p100k = progress / 100000;
+                    printProgress = progress < p100k * 100000 + written && progress >= p100k * 100000;
+                }
+
+                if (printProgress) {
+                    MO_DBG_INFO("update progress: %zu kB", progress / 1000);
+                }
+            }
+            #endif //MO_DBG_LEVEL >= MO_DL_DEBUG
+
+            return written;
+        }, [] (MO_FtpCloseReason reason) {
+            if (reason != MO_FtpCloseReason_Success) {
+                Update.abort();
+            }
+        });
+
+    fwService->setOnInstall([ftServicePtr] (const char *location) {
+
+        if (Update.isRunning() && Update.end(true)) {
+            MO_DBG_DEBUG("update success");
+            ftServicePtr->setInstallationStatusInput([](){return InstallationStatus::Installed;});
+
+            ESP.restart();
+        } else {
+            MO_DBG_ERR("update failed");
+            ftServicePtr->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
         }
 
         return true;
@@ -365,14 +450,15 @@ FirmwareService *MicroOcpp::makeDefaultFirmwareService(Context& context) {
     return fwService;
 }
 
-#elif defined(ESP8266)
+#elif MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP8266)
 
 #include <ESP8266httpUpdate.h>
 
-FirmwareService *MicroOcpp::makeDefaultFirmwareService(Context& context) {
-    FirmwareService *fwService = new FirmwareService(context);
+std::unique_ptr<FirmwareService> MicroOcpp::makeDefaultFirmwareService(Context& context) {
+    std::unique_ptr<FirmwareService> fwService = std::unique_ptr<FirmwareService>(new FirmwareService(context));
+    auto fwServicePtr = fwService.get();
 
-    fwService->setOnInstall([fwService] (const char *location) {
+    fwService->setOnInstall([fwServicePtr] (const char *location) {
         
         MO_DBG_WARN("Built-in updater for ESP8266 is only intended for demonstration purposes. HTTP support only");
 
@@ -387,15 +473,15 @@ FirmwareService *MicroOcpp::makeDefaultFirmwareService(Context& context) {
 
         switch (ret) {
             case HTTP_UPDATE_FAILED:
-                fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
+                fwServicePtr->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
                 MO_DBG_WARN("HTTP_UPDATE_FAILED Error (%d): %s\n", ESPhttpUpdate.getLastError(), ESPhttpUpdate.getLastErrorString().c_str());
                 break;
             case HTTP_UPDATE_NO_UPDATES:
-                fwService->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
+                fwServicePtr->setInstallationStatusInput([](){return InstallationStatus::InstallationFailed;});
                 MO_DBG_WARN("HTTP_UPDATE_NO_UPDATES");
                 break;
             case HTTP_UPDATE_OK:
-                fwService->setInstallationStatusInput([](){return InstallationStatus::Installed;});
+                fwServicePtr->setInstallationStatusInput([](){return InstallationStatus::Installed;});
                 MO_DBG_INFO("HTTP_UPDATE_OK");
                 ESP.restart();
                 break;
@@ -411,5 +497,5 @@ FirmwareService *MicroOcpp::makeDefaultFirmwareService(Context& context) {
     return fwService;
 }
 
-#endif //defined(ESP8266)
-#endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
+#endif //MO_PLATFORM
+#endif //!defined(MO_CUSTOM_UPDATER)
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
index d3ab261a..e481458b 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
@@ -11,6 +11,7 @@
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h>
 #include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Ftp.h>
 
 namespace MicroOcpp {
 
@@ -39,6 +40,10 @@ class FirmwareService {
     std::function<DownloadStatus()> downloadStatusInput;
     bool downloadIssued = false;
 
+    std::unique_ptr<FtpDownload> ftpDownload;
+    DownloadStatus ftpDownloadStatus = DownloadStatus::NotDownloaded;
+    const char *ftpServerCert = nullptr;
+
     std::function<InstallationStatus()> installationStatusInput;
     bool installationIssued = false;
 
@@ -62,8 +67,10 @@ class FirmwareService {
         Downloading,
         AfterDownload,
         AwaitInstallation,
-        Installing
-    } stage;
+        Installing,
+        Installed,
+        InternalError
+    } stage = UpdateStage::Idle;
 
     void resetStage();
 
@@ -80,6 +87,22 @@ class FirmwareService {
 
     Ocpp16::FirmwareStatus getFirmwareStatus();
 
+    /*
+     * Sets the firmware writer. During the UpdateFirmware process, MO will use an FTP client to download the firmware and forward
+     * the binary data to `firmwareWriter`. The binary data comes in chunks. MO executes `firmwareWriter` with `buf` containing the
+     * next chunk of FW data and `size` being the chunk size. `firmwareWriter` must return the number of bytes written, whereas
+     * the result can be between 1 and `size`, and 0 aborts the download. MO executes `onClose` with the reason why the connection
+     * has been closed. If the download hasn't been successful, MO will abort the update routine in any case.
+     * 
+     * Note that this function only works if MO_ENABLE_MBEDTLS=1, or MO has been configured with a custom FTP client
+     */
+    void setDownloadFileWriter(std::function<size_t(const unsigned char *buf, size_t size)> firmwareWriter, std::function<void(MO_FtpCloseReason)> onClose);
+
+    void setFtpServerCert(const char *cert); //zero-copy mode, i.e. cert must outlive MO
+
+    /*
+     * Manual alternative for FTP download handler `setDownloadFileWriter`
+     */
     void setOnDownload(std::function<bool(const char *location)> onDownload);
 
     void setDownloadStatusInput(std::function<DownloadStatus()> downloadStatusInput);
@@ -91,16 +114,21 @@ class FirmwareService {
 
 } //endif namespace MicroOcpp
 
-#if MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
-#if defined(ESP32) || defined(ESP8266)
+#if !defined(MO_CUSTOM_UPDATER)
+
+#if MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP32) && MO_ENABLE_MBEDTLS
 
 namespace MicroOcpp {
+std::unique_ptr<FirmwareService> makeDefaultFirmwareService(Context& context);
+}
 
-FirmwareService *makeDefaultFirmwareService(Context& context);
+#elif MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP8266)
 
+namespace MicroOcpp {
+std::unique_ptr<FirmwareService> makeDefaultFirmwareService(Context& context);
 }
 
-#endif //defined(ESP32) || defined(ESP8266)
-#endif //MO_PLATFORM == MO_PLATFORM_ARDUINO && !defined(MO_CUSTOM_UPDATER)
+#endif //MO_PLATFORM
+#endif //!defined(MO_CUSTOM_UPDATER)
 
 #endif
diff --git a/tests/FirmwareManagement.cpp b/tests/FirmwareManagement.cpp
new file mode 100644
index 00000000..2a9425cc
--- /dev/null
+++ b/tests/FirmwareManagement.cpp
@@ -0,0 +1,597 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Configuration.h>
+
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
+
+#define BASE_TIME     "2023-01-01T00:00:00.000Z"
+#define BASE_TIME_1H  "2023-01-01T01:00:00.000Z"
+#define FTP_URL       "ftps://localhost/firmware.bin"
+
+using namespace MicroOcpp;
+
+TEST_CASE( "FirmwareManagement" ) {
+    printf("\nRun %s\n",  "FirmwareManagement");
+
+    //clean state
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
+    FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+
+    mocpp_set_timer(custom_timer_cb);
+
+    mocpp_initialize(loopback, ChargerCredentials("test-runner"));
+    auto& model = getOcppContext()->getModel();
+    auto fwService = getFirmwareService();
+    SECTION("FirmwareService initialized") {
+        REQUIRE(fwService != nullptr);
+    }
+
+    model.getClock().setTime(BASE_TIME);
+
+    loop();
+
+    SECTION("Unconfigured FW service") {
+
+        bool checkProcessed = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("FirmwareStatusNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("FirmwareStatusNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        checkProcessed = true;
+                        REQUIRE((
+                            !strcmp(payload["status"] | "_Undefined", "DownloadFailed") ||
+                            !strcmp(payload["status"] | "_Undefined", "InstallationFailed")
+                        ));
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+        
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "UpdateFirmware",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["location"] = FTP_URL;
+                    payload["retries"] = 1;
+                    payload["retrieveDate"] = BASE_TIME;
+                    payload["retryInterval"] = 1;
+                    return doc;},
+                [] (JsonObject) { } //ignore conf
+        )));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+    }
+
+    SECTION("Download phase only") {
+
+        int checkProcessed = 0;
+
+        getOcppContext()->getOperationRegistry().registerOperation("FirmwareStatusNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("FirmwareStatusNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        if (checkProcessed == 0) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Downloading") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 1) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Downloaded") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 2) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Installed") );
+                            checkProcessed++;
+                        }
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+
+        bool checkProcessedOnDownload = false;
+
+        fwService->setOnDownload([&checkProcessedOnDownload] (const char *location) {
+            checkProcessedOnDownload = true;
+            return true;
+        });
+
+        int checkProcessedOnDownloadStatus = 0;
+
+        fwService->setDownloadStatusInput([&checkProcessed, &checkProcessedOnDownloadStatus] () {
+            if (checkProcessed == 0) {
+                if (checkProcessedOnDownloadStatus == 0) checkProcessedOnDownloadStatus = 1;
+                return DownloadStatus::NotDownloaded;
+            } else if (checkProcessed >= 1) {
+                if (checkProcessedOnDownloadStatus == 1) checkProcessedOnDownloadStatus = 2;
+                return DownloadStatus::Downloaded;
+            }
+        });
+
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "UpdateFirmware",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["location"] = FTP_URL;
+                    payload["retries"] = 1;
+                    payload["retrieveDate"] = BASE_TIME;
+                    payload["retryInterval"] = 1;
+                    return doc;},
+                [] (JsonObject) { } //ignore conf
+        )));
+
+        for (unsigned int i = 0; i < 10; i++) {
+            loop();
+            mtime += 5000;
+        }
+
+        REQUIRE( checkProcessed == 3 ); //all FirmwareStatusNotification messages have been received
+        REQUIRE( checkProcessedOnDownload );
+        REQUIRE( checkProcessedOnDownloadStatus == 2 );
+    }
+
+    SECTION("Installation phase only") {
+
+        int checkProcessed = 0;
+
+        getOcppContext()->getOperationRegistry().registerOperation("FirmwareStatusNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("FirmwareStatusNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        if (checkProcessed == 0) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Installing") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 1) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Installed") );
+                            checkProcessed++;
+                        }
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+        
+        bool checkProcessedOnInstall = false;
+
+        fwService->setOnInstall([&checkProcessedOnInstall] (const char *location) {
+            checkProcessedOnInstall = true;
+            REQUIRE( !strcmp(location, FTP_URL) );
+            return true;
+        });
+
+        int checkProcessedOnInstallStatus = 0;
+
+        fwService->setInstallationStatusInput([&checkProcessed, &checkProcessedOnInstallStatus] () {
+            if (checkProcessed == 0) {
+                if (checkProcessedOnInstallStatus == 0) checkProcessedOnInstallStatus = 1;
+                return InstallationStatus::NotInstalled;
+            } else if (checkProcessed >= 1) {
+                if (checkProcessedOnInstallStatus == 1) checkProcessedOnInstallStatus = 2;
+                return InstallationStatus::Installed;
+            }
+        });
+        
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "UpdateFirmware",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["location"] = FTP_URL;
+                    payload["retries"] = 1;
+                    payload["retrieveDate"] = BASE_TIME;
+                    payload["retryInterval"] = 1;
+                    return doc;},
+                [] (JsonObject) { } //ignore conf
+        )));
+
+        for (unsigned int i = 0; i < 10; i++) {
+            loop();
+            mtime += 5000;
+        }
+
+        REQUIRE( checkProcessed == 2 ); //all FirmwareStatusNotification messages have been received
+        REQUIRE( checkProcessedOnInstall );
+        REQUIRE( checkProcessedOnInstallStatus == 2 );
+    }
+
+    SECTION("Download and install") {
+
+        int checkProcessed = 0;
+
+        getOcppContext()->getOperationRegistry().registerOperation("FirmwareStatusNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("FirmwareStatusNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        if (checkProcessed == 0) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Downloading") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 1) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Downloaded") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 2) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Installing") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 3) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Installed") );
+                            checkProcessed++;
+                        }
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+        
+        bool checkProcessedOnDownload = false;
+        fwService->setOnDownload([&checkProcessedOnDownload] (const char *location) {
+            checkProcessedOnDownload = true;
+            return true;
+        });
+
+        int checkProcessedOnDownloadStatus = 0;
+        fwService->setDownloadStatusInput([&checkProcessed, &checkProcessedOnDownloadStatus] () {
+            if (checkProcessed == 0) {
+                if (checkProcessedOnDownloadStatus == 0) checkProcessedOnDownloadStatus = 1;
+                return DownloadStatus::NotDownloaded;
+            } else if (checkProcessed >= 1) {
+                if (checkProcessedOnDownloadStatus == 1) checkProcessedOnDownloadStatus = 2;
+                return DownloadStatus::Downloaded;
+            }
+        });
+        
+        bool checkProcessedOnInstall = false;
+        fwService->setOnInstall([&checkProcessedOnInstall] (const char *location) {
+            checkProcessedOnInstall = true;
+            return true;
+        });
+
+        int checkProcessedOnInstallStatus = 0;
+        fwService->setInstallationStatusInput([&checkProcessed, &checkProcessedOnInstallStatus] () {
+            if (checkProcessed <= 2) {
+                if (checkProcessedOnInstallStatus == 0) checkProcessedOnInstallStatus = 1;
+                return InstallationStatus::NotInstalled;
+            } else if (checkProcessed >= 3) {
+                if (checkProcessedOnInstallStatus == 1) checkProcessedOnInstallStatus = 2;
+                return InstallationStatus::Installed;
+            }
+        });
+        
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "UpdateFirmware",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["location"] = FTP_URL;
+                    payload["retries"] = 1;
+                    payload["retrieveDate"] = BASE_TIME;
+                    payload["retryInterval"] = 1;
+                    return doc;},
+                [] (JsonObject) { } //ignore conf
+        )));
+
+        for (unsigned int i = 0; i < 10; i++) {
+            loop();
+            mtime += 5000;
+        }
+
+        REQUIRE( checkProcessed == 4 ); //all FirmwareStatusNotification messages have been received
+        REQUIRE( checkProcessedOnDownload );
+        REQUIRE( checkProcessedOnDownloadStatus == 2 );
+        REQUIRE( checkProcessedOnInstall );
+        REQUIRE( checkProcessedOnInstallStatus == 2 );
+    }
+
+    SECTION("Download failure (try 2 times)") {
+
+        int checkProcessed = 0;
+
+        getOcppContext()->getOperationRegistry().registerOperation("FirmwareStatusNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("FirmwareStatusNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        if (checkProcessed == 0) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Downloading") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 1) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "DownloadFailed") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 2) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Downloading") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 3) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "DownloadFailed") );
+                            checkProcessed++;
+                        }
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+
+        int checkProcessedOnDownload = 0;
+        fwService->setOnDownload([&checkProcessedOnDownload] (const char *location) {
+            checkProcessedOnDownload++;
+            return true;
+        });
+
+        int checkProcessedOnDownloadStatus = 0;
+        fwService->setDownloadStatusInput([&checkProcessed, &checkProcessedOnDownloadStatus] () {
+            if (checkProcessed == 0) {
+                if (checkProcessedOnDownloadStatus == 0) checkProcessedOnDownloadStatus = 1;
+                return DownloadStatus::NotDownloaded;
+            } else if (checkProcessed == 1) {
+                if (checkProcessedOnDownloadStatus == 1) checkProcessedOnDownloadStatus = 2;
+                return DownloadStatus::DownloadFailed;
+            } else if (checkProcessed == 2) {
+                if (checkProcessedOnDownloadStatus == 2) checkProcessedOnDownloadStatus = 3;
+                return DownloadStatus::NotDownloaded;
+            } else if (checkProcessed >= 3) {
+                if (checkProcessedOnDownloadStatus == 3) checkProcessedOnDownloadStatus = 4;
+                return DownloadStatus::DownloadFailed;
+            }
+        });
+
+        bool checkProcessedOnInstall = false; // must not be executed
+        fwService->setOnInstall([&checkProcessedOnInstall] (const char *location) {
+            checkProcessedOnInstall = true;
+            return true;
+        });
+
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "UpdateFirmware",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["location"] = FTP_URL;
+                    payload["retries"] = 2;
+                    payload["retrieveDate"] = BASE_TIME;
+                    payload["retryInterval"] = 10;
+                    return doc;},
+                [] (JsonObject) { } //ignore conf
+        )));
+
+        for (unsigned int i = 0; i < 20; i++) {
+            loop();
+            mtime += 5000;
+        }
+
+        REQUIRE( checkProcessed == 4 ); //all FirmwareStatusNotification messages have been received
+        REQUIRE( checkProcessedOnDownload == 2 );
+        REQUIRE( checkProcessedOnDownloadStatus == 4 );
+        REQUIRE( !checkProcessedOnInstall );
+    }
+
+    SECTION("Installation failure (try 2 times)") {
+
+        int checkProcessed = 0;
+
+        getOcppContext()->getOperationRegistry().registerOperation("FirmwareStatusNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("FirmwareStatusNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        if (checkProcessed == 0) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Installing") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 1) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "InstallationFailed") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 2) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Installing") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 3) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "InstallationFailed") );
+                            checkProcessed++;
+                        }
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+        
+        int checkProcessedOnInstall = 0;
+
+        fwService->setOnInstall([&checkProcessedOnInstall] (const char *location) {
+            checkProcessedOnInstall++;
+            return true;
+        });
+
+        int checkProcessedOnInstallStatus = 0;
+
+        fwService->setInstallationStatusInput([&checkProcessed, &checkProcessedOnInstallStatus] () {
+            if (checkProcessed == 0) {
+                if (checkProcessedOnInstallStatus == 0) checkProcessedOnInstallStatus = 1;
+                return InstallationStatus::NotInstalled;
+            } else if (checkProcessed == 1) {
+                if (checkProcessedOnInstallStatus == 1) checkProcessedOnInstallStatus = 2;
+                return InstallationStatus::InstallationFailed;
+            } else if (checkProcessed == 2) {
+                if (checkProcessedOnInstallStatus == 2) checkProcessedOnInstallStatus = 3;
+                return InstallationStatus::NotInstalled;
+            } else if (checkProcessed >= 3) {
+                if (checkProcessedOnInstallStatus == 3) checkProcessedOnInstallStatus = 4;
+                return InstallationStatus::InstallationFailed;
+            }
+        });
+        
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "UpdateFirmware",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["location"] = FTP_URL;
+                    payload["retries"] = 2;
+                    payload["retrieveDate"] = BASE_TIME;
+                    payload["retryInterval"] = 10;
+                    return doc;},
+                [] (JsonObject) { } //ignore conf
+        )));
+
+        for (unsigned int i = 0; i < 10; i++) {
+            loop();
+            mtime += 5000;
+        }
+
+        REQUIRE( checkProcessed == 4 ); //all FirmwareStatusNotification messages have been received
+        REQUIRE( checkProcessedOnInstall == 2 );
+        REQUIRE( checkProcessedOnInstallStatus == 4 );
+    }
+
+    SECTION("Wait for retreiveDate and charging sessions end") {
+
+        beginTransaction("mIdTag");
+
+        int checkProcessed = 0;
+
+        getOcppContext()->getOperationRegistry().registerOperation("FirmwareStatusNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("FirmwareStatusNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        if (checkProcessed == 0) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Downloading") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 1) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Downloaded") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 2) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Installing") );
+                            checkProcessed++;
+                        } else if (checkProcessed == 3) {
+                            REQUIRE( !strcmp(payload["status"] | "_Undefined", "Installed") );
+                            checkProcessed++;
+                        }
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+        
+        bool checkProcessedOnDownload = false;
+        fwService->setOnDownload([&checkProcessedOnDownload] (const char *location) {
+            checkProcessedOnDownload = true;
+            return true;
+        });
+
+        int checkProcessedOnDownloadStatus = 0;
+        fwService->setDownloadStatusInput([&checkProcessed, &checkProcessedOnDownloadStatus] () {
+            if (checkProcessed == 0) {
+                if (checkProcessedOnDownloadStatus == 0) checkProcessedOnDownloadStatus = 1;
+                return DownloadStatus::NotDownloaded;
+            } else if (checkProcessed >= 1) {
+                if (checkProcessedOnDownloadStatus == 1) checkProcessedOnDownloadStatus = 2;
+                return DownloadStatus::Downloaded;
+            }
+        });
+        
+        bool checkProcessedOnInstall = false;
+        fwService->setOnInstall([&checkProcessedOnInstall] (const char *location) {
+            checkProcessedOnInstall = true;
+            return true;
+        });
+
+        int checkProcessedOnInstallStatus = 0;
+        fwService->setInstallationStatusInput([&checkProcessed, &checkProcessedOnInstallStatus] () {
+            if (checkProcessed <= 2) {
+                if (checkProcessedOnInstallStatus == 0) checkProcessedOnInstallStatus = 1;
+                return InstallationStatus::NotInstalled;
+            } else if (checkProcessed >= 3) {
+                if (checkProcessedOnInstallStatus == 1) checkProcessedOnInstallStatus = 2;
+                return InstallationStatus::Installed;
+            }
+        });
+        
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                "UpdateFirmware",
+                [] () {
+                    //create req
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto payload = doc->to<JsonObject>();
+                    payload["location"] = FTP_URL;
+                    payload["retries"] = 1;
+                    payload["retrieveDate"] = BASE_TIME_1H;
+                    payload["retryInterval"] = 1;
+                    return doc;},
+                [] (JsonObject) { } //ignore conf
+        )));
+
+        for (unsigned int i = 0; i < 10; i++) {
+            loop();
+            mtime += 5000;
+        }
+
+        //retreiveDate not reached yet
+        REQUIRE( checkProcessed == 0 );
+        REQUIRE( !checkProcessedOnDownload );
+        REQUIRE( checkProcessedOnDownloadStatus == 0 );
+        REQUIRE( !checkProcessedOnInstall );
+        REQUIRE( checkProcessedOnInstallStatus == 0 );
+
+        getOcppContext()->getModel().getClock().setTime(BASE_TIME_1H);
+
+        for (unsigned int i = 0; i < 10; i++) {
+            loop();
+            mtime += 5000;
+        }
+
+        //download-related FirmwareStatusNotification messages have been received
+        REQUIRE( checkProcessed == 2 );
+        REQUIRE( checkProcessedOnDownload );
+        REQUIRE( checkProcessedOnDownloadStatus == 2 );
+        REQUIRE( !checkProcessedOnInstall );
+        REQUIRE( checkProcessedOnInstallStatus == 0 );
+
+        endTransaction();
+
+        for (unsigned int i = 0; i < 10; i++) {
+            loop();
+            mtime += 5000;
+        }
+
+        //all FirmwareStatusNotification messages have been received
+        REQUIRE( checkProcessed == 4 );
+        REQUIRE( checkProcessedOnDownload );
+        REQUIRE( checkProcessedOnDownloadStatus == 2 );
+        REQUIRE( checkProcessedOnInstall );
+        REQUIRE( checkProcessedOnInstallStatus == 2 );
+    }
+
+    mocpp_deinitialize();
+
+}
diff --git a/tests/helpers/testHelper.cpp b/tests/helpers/testHelper.cpp
index 1040b678..fc56e20b 100644
--- a/tests/helpers/testHelper.cpp
+++ b/tests/helpers/testHelper.cpp
@@ -2,15 +2,10 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#include <iostream>
 #include <MicroOcpp.h>
 
 using namespace MicroOcpp;
 
-void cpp_console_out(const char *msg) {
-    std::cout << msg;
-}
-
 unsigned long mtime = 10000;
 unsigned long custom_timer_cb() {
     return mtime;
diff --git a/tests/helpers/testHelper.h b/tests/helpers/testHelper.h
index 90b19061..7dd33ba8 100644
--- a/tests/helpers/testHelper.h
+++ b/tests/helpers/testHelper.h
@@ -2,15 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#ifndef MO_CPP_CONSOLE_OUT
-#define MO_CPP_CONSOLE_OUT
-
-/**
-* Prints a string to the c standart console
-*
-* @param msg pointer to the string
-*/
-void cpp_console_out(const char *msg);   
+#ifndef MO_TESTHELPER_H
+#define MO_TESTHELPER_H
 
 extern unsigned long mtime;
 unsigned long custom_timer_cb();
diff --git a/tests/ocppEngineLifecycle.cpp b/tests/ocppEngineLifecycle.cpp
index 0a8b3e71..a6a84818 100644
--- a/tests/ocppEngineLifecycle.cpp
+++ b/tests/ocppEngineLifecycle.cpp
@@ -10,9 +10,6 @@
 TEST_CASE( "Context lifecycle" ) {
     printf("\nRun %s\n",  "Context lifecycle");
 
-    //set console output to the cpp console to display outputs
-    //mocpp_set_console_out(cpp_console_out);
-
     //initialize Context with dummy socket
     MicroOcpp::LoopbackConnection loopback;
     mocpp_initialize(loopback);

From 47cc0e4b853b193ac9154d4a481759afd196ae29 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 14 Jun 2024 20:43:47 +0200
Subject: [PATCH 492/549] fix stopTime field (addresses #320)

---
 src/MicroOcpp/Operations/GetDiagnostics.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Operations/GetDiagnostics.cpp b/src/MicroOcpp/Operations/GetDiagnostics.cpp
index 6f9e4634..93aec8a7 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.cpp
+++ b/src/MicroOcpp/Operations/GetDiagnostics.cpp
@@ -39,7 +39,7 @@ void GetDiagnostics::processReq(JsonObject payload) {
     }
 
     Timestamp stopTime;
-    if (payload.containsKey("startTime")) {
+    if (payload.containsKey("stopTime")) {
         if (!stopTime.setTime(payload["stopTime"] | "Invalid")) {
             errorCode = "PropertyConstraintViolation";
             MO_DBG_WARN("bad time format");

From 786e015b2357135e7809ffec6ab6c7558ccad77a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 15 Jun 2024 15:36:36 +0200
Subject: [PATCH 493/549] skip clock-aligned measurement when clock not set

---
 CHANGELOG.md                                       | 1 +
 src/MicroOcpp/Model/Metering/MeteringConnector.cpp | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f99c3f42..cfadb59d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,6 +20,7 @@
 ### Fixed
 
 - Skip Unix files . and .. in ftw_root ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
+- Skip clock-aligned measurements when time not set
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index 07444600..3e642f87 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -86,7 +86,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         }
     }
 
-    if (clockAlignedDataIntervalInt->getInt() >= 1) {
+    if (clockAlignedDataIntervalInt->getInt() >= 1 && model.getClock().now() >= MIN_TIME) {
 
         auto& timestampNow = model.getClock().now();
         auto dt = nextAlignedTime - timestampNow;

From 518a40976cf7af8ee8c3cfc0d7408dc4853fee82 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 15 Jun 2024 15:41:10 +0200
Subject: [PATCH 494/549] don't send error StatusNotif when time not set
 (addresses #311)

---
 CHANGELOG.md                                    | 1 +
 src/MicroOcpp/Model/ConnectorBase/Connector.cpp | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cfadb59d..cc5895ca 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -21,6 +21,7 @@
 
 - Skip Unix files . and .. in ftw_root ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
 - Skip clock-aligned measurements when time not set
+- Hold back error StatusNotifs when time not set ([#311](https://github.com/matth-x/MicroOcpp/issues/311))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index d284b8dd..67292dc0 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -410,7 +410,7 @@ void Connector::loop() {
 
     auto status = getStatus();
 
-    if (model.getVersion().major == 1) {
+    if (model.getVersion().major == 1 && model.getClock().now() >= MIN_TIME) {
         //OCPP 1.6: use StatusNotification to send error codes
         for (auto i = std::min(errorDataInputs.size(), trackErrorDataInputs.size()); i >= 1; i--) {
             auto index = i - 1;
@@ -442,7 +442,7 @@ void Connector::loop() {
     }
 
     if (reportedStatus != currentStatus &&
-            model.getClock().now() >= Timestamp(2010,0,0,0,0,0) &&
+            model.getClock().now() >= MIN_TIME &&
             (minimumStatusDurationInt->getInt() <= 0 || //MinimumStatusDuration disabled
             mocpp_tick_ms() - t_statusTransition >= ((unsigned long) minimumStatusDurationInt->getInt()) * 1000UL)) {
         reportedStatus = currentStatus;

From 1bf49421a4641a29ddaf5e3de99027bd93d2b22a Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sat, 15 Jun 2024 15:46:59 +0200
Subject: [PATCH 495/549] keep Finishing while tx still occupies connector
 (addresses #315)

---
 CHANGELOG.md                                    | 1 +
 src/MicroOcpp/Model/ConnectorBase/Connector.cpp | 5 +++--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc5895ca..cf0b4279 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,6 +22,7 @@
 - Skip Unix files . and .. in ftw_root ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
 - Skip clock-aligned measurements when time not set
 - Hold back error StatusNotifs when time not set ([#311](https://github.com/matth-x/MicroOcpp/issues/311))
+- Don't send Available when tx occupies connector ([#315](https://github.com/matth-x/MicroOcpp/issues/315))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 67292dc0..1879823c 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -122,7 +122,7 @@ ChargePointStatus Connector::getStatus() {
         res = ChargePointStatus_Reserved;
     }
     #endif 
-    else if ((!transaction || !transaction->isActive()) &&                 //no transaction preparation
+    else if ((!transaction) &&                                           //no transaction process occupying the connector
                (!connectorPluggedInput || !connectorPluggedInput()) &&   //no vehicle plugged
                (!occupiedInput || !occupiedInput())) {                       //occupied override clear
         res = ChargePointStatus_Available;
@@ -134,7 +134,8 @@ ChargePointStatus Connector::getStatus() {
         if (previous == ChargePointStatus_Finishing ||
                 previous == ChargePointStatus_Charging ||
                 previous == ChargePointStatus_SuspendedEV ||
-                previous == ChargePointStatus_SuspendedEVSE) {
+                previous == ChargePointStatus_SuspendedEVSE ||
+                (transaction && transaction->getStartSync().isRequested())) { //transaction process still occupying the connector
             res = ChargePointStatus_Finishing;
         } else {
             res = ChargePointStatus_Preparing;

From 8b1f0fdbae8785c49453f0b2d54a1a8db2fbe3ed Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 21 Jun 2024 08:17:31 +0200
Subject: [PATCH 496/549] fix ChargingScheduleAllowedChargingRateUnit
 mutability (fixes #328)

---
 CHANGELOG.md                                               | 1 +
 src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cf0b4279..36636390 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -23,6 +23,7 @@
 - Skip clock-aligned measurements when time not set
 - Hold back error StatusNotifs when time not set ([#311](https://github.com/matth-x/MicroOcpp/issues/311))
 - Don't send Available when tx occupies connector ([#315](https://github.com/matth-x/MicroOcpp/issues/315))
+- Make ChargingScheduleAllowedChargingRateUnit read-only ([#328](https://github.com/matth-x/MicroOcpp/issues/328))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index 655d20a3..08445340 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -318,7 +318,7 @@ SmartChargingService::SmartChargingService(Context& context, std::shared_ptr<Fil
     }
 
     declareConfiguration<int>("ChargeProfileMaxStackLevel", MO_ChargeProfileMaxStackLevel, CONFIGURATION_VOLATILE, true);
-    declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE);
+    declareConfiguration<const char*>("ChargingScheduleAllowedChargingRateUnit", "", CONFIGURATION_VOLATILE, true);
     declareConfiguration<int>("ChargingScheduleMaxPeriods", MO_ChargingScheduleMaxPeriods, CONFIGURATION_VOLATILE, true);
     declareConfiguration<int>("MaxChargingProfilesInstalled", MO_MaxChargingProfilesInstalled, CONFIGURATION_VOLATILE, true);
 

From fb6a765b1ac8240e060f2e65ef0f3022aaafa73f Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 23 Jul 2024 18:21:28 +0200
Subject: [PATCH 497/549] StatusNotification error layering mechanism (#331)

* add option to report NoError

* add build switch MO_REPORT_NOERROR

* add error severity levels

* double-check NoError condition

* revise stacked error conditions

* update changelog
---
 CHANGELOG.md                                  |   2 +
 CMakeLists.txt                                |   2 +
 .../ConnectorBase/ChargePointErrorData.h      |   3 +
 .../Model/ConnectorBase/Connector.cpp         |  57 ++-
 src/MicroOcpp/Model/ConnectorBase/Connector.h |   5 +
 tests/ChargePointError.cpp                    | 340 ++++++++++++++++++
 6 files changed, 394 insertions(+), 15 deletions(-)
 create mode 100644 tests/ChargePointError.cpp

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 36636390..597f386f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -12,6 +12,8 @@
 - Provide ChargePointStatus in API ([#309](https://github.com/matth-x/MicroOcpp/pull/309))
 - Built-in OTA over FTP ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
 - Built-in Diagnostics over FTP ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
+- Error `severity` mechanism ([#331](https://github.com/matth-x/MicroOcpp/pull/331))
+- Build flag `MO_REPORT_NOERROR` to report error recovery ([#331](https://github.com/matth-x/MicroOcpp/pull/331))
 
 ### Removed
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 4817e066..a034a1ce 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -149,6 +149,7 @@ set(MO_SRC_UNIT
     tests/Transactions.cpp
     tests/Certificates.cpp
     tests/FirmwareManagement.cpp
+    tests/ChargePointError.cpp
 )
 
 add_executable(mo_unit_tests
@@ -191,6 +192,7 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_MaxChargingProfilesInstalled=3
     MO_ENABLE_CERT_MGMT=1
     MO_ENABLE_CONNECTOR_LOCK=1
+    MO_REPORT_NOERROR=1
 )
 
 target_compile_options(mo_unit_tests PUBLIC
diff --git a/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h b/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
index ae48c09b..6c7b04f2 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h
@@ -5,11 +5,14 @@
 #ifndef MO_CHARGEPOINTERRORCODE_H
 #define MO_CHARGEPOINTERRORCODE_H
 
+#include <stdint.h>
+
 namespace MicroOcpp {
 
 struct ErrorData {
     bool isError = false; //if any error information is set
     bool isFaulted = false; //if this is a severe error and the EVSE should go into the faulted state
+    uint8_t severity = 1; //severity: don't send less severe errors during highly severe error condition
     const char *errorCode = nullptr; //see ChargePointErrorCode (p. 76/77) for possible values
     const char *info = nullptr; //Additional free format information related to the error
     const char *vendorId = nullptr; //vendor-specific implementation identifier
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 1879823c..42d034c3 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -409,29 +409,52 @@ void Connector::loop() {
         freeVendTrackPlugged = connectorPluggedInput();
     }
 
-    auto status = getStatus();
+    ErrorData errorData {nullptr};
+    errorData.severity = 0;
+    int errorDataIndex = -1;
 
     if (model.getVersion().major == 1 && model.getClock().now() >= MIN_TIME) {
         //OCPP 1.6: use StatusNotification to send error codes
+
+        if (reportedErrorIndex >= 0) {
+            auto error = errorDataInputs[reportedErrorIndex].operator()();
+            if (error.isError) {
+                errorData = error;
+                errorDataIndex = reportedErrorIndex;
+            }
+        }
+
         for (auto i = std::min(errorDataInputs.size(), trackErrorDataInputs.size()); i >= 1; i--) {
             auto index = i - 1;
-            auto error = errorDataInputs[index].operator()();
-            if (error.isError && !trackErrorDataInputs[index]) {
+            ErrorData error {nullptr};
+            if ((int)index != errorDataIndex) {
+                error = errorDataInputs[index].operator()();
+            } else {
+                error = errorData;
+            }
+            if (error.isError && !trackErrorDataInputs[index] && error.severity >= errorData.severity) {
                 //new error
-                auto statusNotification = makeRequest(
-                        new Ocpp16::StatusNotification(connectorId, status, model.getClock().now(), error));
-                statusNotification->setTimeout(0);
-                context.initiateRequest(std::move(statusNotification));
-
-                currentStatus = status;
-                reportedStatus = status;
-                trackErrorDataInputs[index] = true;
+                errorData = error;
+                errorDataIndex = index;
+            } else if (error.isError && error.severity > errorData.severity) {
+                errorData = error;
+                errorDataIndex = index;
             } else if (!error.isError && trackErrorDataInputs[index]) {
                 //reset error
                 trackErrorDataInputs[index] = false;
             }
         }
-    }
+
+        if (errorDataIndex != reportedErrorIndex) {
+            if (errorDataIndex >= 0 || MO_REPORT_NOERROR) {
+                reportedStatus = ChargePointStatus_UNDEFINED; //trigger sending currentStatus again with code NoError
+            } else {
+                reportedErrorIndex = -1;
+            }
+        }
+    } //if (model.getVersion().major == 1)
+
+    auto status = getStatus();
 
     if (status != currentStatus) {
         MO_DBG_DEBUG("Status changed %s -> %s %s",
@@ -447,6 +470,10 @@ void Connector::loop() {
             (minimumStatusDurationInt->getInt() <= 0 || //MinimumStatusDuration disabled
             mocpp_tick_ms() - t_statusTransition >= ((unsigned long) minimumStatusDurationInt->getInt()) * 1000UL)) {
         reportedStatus = currentStatus;
+        reportedErrorIndex = errorDataIndex;
+        if (errorDataIndex >= 0) {
+            trackErrorDataInputs[errorDataIndex] = true;
+        }
         Timestamp reportedTimestamp = model.getClock().now();
         reportedTimestamp -= (mocpp_tick_ms() - t_statusTransition) / 1000UL;
 
@@ -457,7 +484,7 @@ void Connector::loop() {
                     new Ocpp201::StatusNotification(connectorId, reportedStatus, reportedTimestamp)) :
             #endif //MO_ENABLE_V201
                 makeRequest(
-                    new Ocpp16::StatusNotification(connectorId, reportedStatus, reportedTimestamp, getErrorCode()));
+                    new Ocpp16::StatusNotification(connectorId, reportedStatus, reportedTimestamp, errorData));
 
         statusNotification->setTimeout(0);
         context.initiateRequest(std::move(statusNotification));
@@ -478,8 +505,8 @@ bool Connector::isFaulted() {
 }
 
 const char *Connector::getErrorCode() {
-    for (auto i = errorDataInputs.size(); i >= 1; i--) {
-        auto error = errorDataInputs[i-1].operator()();
+    if (reportedErrorIndex >= 0) {
+        auto error = errorDataInputs[reportedErrorIndex].operator()();
         if (error.isError && error.errorCode) {
             return error.errorCode;
         }
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 7da8c4d4..08828f2d 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -16,6 +16,10 @@
 #include <functional>
 #include <memory>
 
+#ifndef MO_REPORT_NOERROR
+#define MO_REPORT_NOERROR 0
+#endif
+
 namespace MicroOcpp {
 
 class Context;
@@ -41,6 +45,7 @@ class Connector {
     std::function<bool()> evseReadyInput;
     std::vector<std::function<ErrorData ()>> errorDataInputs;
     std::vector<bool> trackErrorDataInputs;
+    int reportedErrorIndex = -1; //last reported error
     bool isFaulted();
     const char *getErrorCode();
 
diff --git a/tests/ChargePointError.cpp b/tests/ChargePointError.cpp
new file mode 100644
index 00000000..6ca2498c
--- /dev/null
+++ b/tests/ChargePointError.cpp
@@ -0,0 +1,340 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include "./catch2/catch.hpp"
+#include "./helpers/testHelper.h"
+
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Debug.h>
+
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Configuration.h>
+
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
+
+#define BASE_TIME     "2023-01-01T00:00:00.000Z"
+#define BASE_TIME_1H  "2023-01-01T01:00:00.000Z"
+#define FTP_URL       "ftps://localhost/firmware.bin"
+
+#define ERROR_INFO_EXAMPLE "error description"
+#define ERROR_INFO_LOW_1   "low severity 1"
+#define ERROR_INFO_LOW_2   "low severity 2"
+#define ERROR_INFO_HIGH    "high severity"
+
+#define ERROR_VENDOR_ID    "mVendorId"
+#define ERROR_VENDOR_CODE  "mVendorErrorCode"
+
+using namespace MicroOcpp;
+
+TEST_CASE( "ChargePointError" ) {
+    printf("\nRun %s\n",  "ChargePointError");
+
+    //clean state
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
+    FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+
+    mocpp_set_timer(custom_timer_cb);
+
+    mocpp_initialize(loopback, ChargerCredentials("test-runner"));
+    auto& model = getOcppContext()->getModel();
+    auto fwService = getFirmwareService();
+    SECTION("FirmwareService initialized") {
+        REQUIRE(fwService != nullptr);
+    }
+
+    model.getClock().setTime(BASE_TIME);
+
+    loop();
+
+    SECTION("Err and resolve (soft error)") {
+
+        bool errorCondition = false;
+
+        addErrorDataInput([&errorCondition] () -> ErrorData {
+            if (errorCondition) {
+                ErrorData error = "OtherError";
+                error.isFaulted = false;
+                error.info = ERROR_INFO_EXAMPLE;
+                error.vendorId = ERROR_VENDOR_ID;
+                error.vendorErrorCode = ERROR_VENDOR_CODE;
+                return error;
+            }
+            return nullptr;
+        });
+
+        //test error condition during transaction to check if status remains unchanged
+
+        beginTransaction("mIdTag");
+
+        loop();
+
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging );
+        REQUIRE( isOperative() );
+
+        bool checkProcessed = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("StatusNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("StatusNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        checkProcessed = true;
+                        REQUIRE( !strcmp(payload["errorCode"] | "_Undefined", "OtherError") );
+                        REQUIRE( !strcmp(payload["info"] | "_Undefined", ERROR_INFO_EXAMPLE) );
+                        REQUIRE( !strcmp(payload["status"] | "_Undefined", "Charging") );
+                        REQUIRE( !strcmp(payload["vendorId"] | "_Undefined", ERROR_VENDOR_ID) );
+                        REQUIRE( !strcmp(payload["vendorErrorCode"] | "_Undefined", ERROR_VENDOR_CODE) );
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+
+        errorCondition = true;
+
+        loop();
+
+        REQUIRE( checkProcessed );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging );
+        REQUIRE( isOperative() );
+
+#if MO_REPORT_NOERROR
+        checkProcessed = false;
+        getOcppContext()->getOperationRegistry().registerOperation("StatusNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("StatusNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        checkProcessed = true;
+                        REQUIRE( !strcmp(payload["errorCode"] | "_Undefined", "NoError") );
+                        REQUIRE( !payload.containsKey("info") );
+                        REQUIRE( !strcmp(payload["status"] | "_Undefined", "Charging") );
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+#else
+        checkProcessed = true;
+#endif //MO_REPORT_NOERROR
+
+        errorCondition = false;
+
+        loop();
+
+        REQUIRE( checkProcessed );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging );
+        REQUIRE( isOperative() );
+
+    }
+
+    SECTION("Err and resolve (fatal)") {
+
+        bool errorCondition = false;
+
+        addErrorCodeInput([&errorCondition] () {
+            return errorCondition ? "OtherError" : nullptr;
+        });
+
+        loop();
+
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+        REQUIRE( isOperative() );
+
+        errorCondition = true;
+
+        loop();
+
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Faulted );
+        REQUIRE( !isOperative() );
+
+        errorCondition = false;
+
+        loop();
+
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+        REQUIRE( isOperative() );
+    }
+
+    SECTION("Error severity") {
+
+        bool errorConditionLow1 = false;
+        bool errorConditionLow2 = false;
+        bool errorConditionHigh = false;
+
+        addErrorDataInput([&errorConditionLow1] () -> ErrorData {
+            if (errorConditionLow1) {
+                ErrorData error = "OtherError";
+                error.severity = 1;
+                error.info = ERROR_INFO_LOW_1;
+                return error;
+            }
+            return nullptr;
+        });
+
+        addErrorDataInput([&errorConditionLow2] () -> ErrorData {
+            if (errorConditionLow2) {
+                ErrorData error = "OtherError";
+                error.severity = 1;
+                error.info = ERROR_INFO_LOW_2;
+                return error;
+            }
+            return nullptr;
+        });
+
+        addErrorDataInput([&errorConditionHigh] () -> ErrorData {
+            if (errorConditionHigh) {
+                ErrorData error = "OtherError";
+                error.severity = 2;
+                error.info = ERROR_INFO_HIGH;
+                return error;
+            }
+            return nullptr;
+        });
+
+        const char *errorCode = "*";
+        bool checkErrorCode = false;
+        const char *errorInfo = "*";
+        bool checkErrorInfo = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("StatusNotification",
+            [&checkErrorCode, &checkErrorInfo, &errorInfo, &errorCode] () {
+                return new Ocpp16::CustomOperation("StatusNotification",
+                    [&checkErrorCode, &checkErrorInfo, &errorInfo, &errorCode] (JsonObject payload) {
+                        //process req
+                        if (strcmp(errorInfo, "*")) {
+                            MO_DBG_DEBUG("expect \"%s\", got \"%s\"", errorInfo, payload["info"] | "_Undefined");
+                            REQUIRE( !strcmp(payload["info"] | "_Undefined", errorInfo) );
+                            checkErrorInfo = true;
+                        }
+                        if (strcmp(errorCode, "*")) {
+                            MO_DBG_DEBUG("expect \"%s\", got \"%s\"", errorCode, payload["errorCode"] | "_Undefined");
+                            REQUIRE( !strcmp(payload["errorCode"] | "_Undefined", errorCode) );
+                            checkErrorCode = true;
+                        }
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+        
+        //sequence: low-level error 1, low-level error 2, then severe error  -- all errors should go through
+        MO_DBG_INFO("test sequence: low-level error 1, low-level error 2, then severe error");
+
+        errorConditionLow1 = true;
+        errorInfo = ERROR_INFO_LOW_1;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+        
+        errorConditionLow2 = true;
+        errorInfo = ERROR_INFO_LOW_2;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+        
+        errorConditionHigh = true;
+        errorInfo = ERROR_INFO_HIGH;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+
+        errorConditionLow1 = false;
+        errorConditionLow2 = false;
+        errorConditionHigh = false;
+        errorInfo = "*";
+        loop();
+        
+        //sequence: low-level error 1, severe error, then low-level error 2 -- last error gets muted until severe error is resolved
+        MO_DBG_INFO("test sequence: low-level error 1, severe error, then low-level error 2");
+
+        errorConditionLow1 = true;
+        errorInfo = ERROR_INFO_LOW_1;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+        
+        errorConditionHigh = true;
+        errorInfo = ERROR_INFO_HIGH;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+        
+        errorConditionLow2 = true;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( !checkErrorInfo );
+
+        errorConditionHigh = false;
+        errorInfo = ERROR_INFO_LOW_2;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+
+        errorConditionLow1 = false;
+        errorConditionLow2 = false;
+        errorConditionHigh = false;
+        errorInfo = "*";
+        loop();
+        
+        //sequence: low-level error 1, severe error, then severe error gets resolved -- low-level error is reported again
+        MO_DBG_INFO("test sequence: low-level error 1, severe error, then severe error gets resolved");
+
+        errorConditionLow1 = true;
+        errorInfo = ERROR_INFO_LOW_1;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+        
+        errorConditionHigh = true;
+        errorInfo = ERROR_INFO_HIGH;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+        
+        errorConditionHigh = false;
+        errorInfo = ERROR_INFO_LOW_1;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+
+        errorConditionLow1 = false;
+        errorConditionLow2 = false;
+        errorConditionHigh = false;
+        errorInfo = "*";
+        loop();
+
+        //sequence: error, then error gets resolved -- report NoError
+        MO_DBG_INFO("test sequence: error, then error gets resolved");
+
+        errorConditionLow1 = true;
+        errorInfo = ERROR_INFO_LOW_1;
+        checkErrorInfo = false;
+        loop();
+        REQUIRE( checkErrorInfo );
+
+        errorConditionLow1 = false;
+        errorInfo = "*";
+        errorCode = "NoError";
+        checkErrorCode = false;
+        loop();
+        REQUIRE( checkErrorCode );
+    }
+
+    endTransaction();
+    mocpp_deinitialize();
+
+}

From 1098e959e51874367da428752807421cdb5f62f6 Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Tue, 11 Jun 2024 19:58:34 +0000
Subject: [PATCH 498/549] TC_037_1, TC037_2: Deduplicate StatusNotifications in
 RequestQueue

From the OCPP Spec:
> The Charge Point SHOULD NOT send StatusNotification.req PDUs for
> historical status change events that happened while the Charge
> Point was offline.

So, each time we queue another StatusNotification, we drop the
StatusNotifications already in the queue for that connector.
---
 src/MicroOcpp/Core/Request.cpp                |  4 ++++
 src/MicroOcpp/Core/Request.h                  |  1 +
 src/MicroOcpp/Core/RequestQueue.cpp           | 17 ++++++++++++++++-
 src/MicroOcpp/Operations/StatusNotification.h |  4 ++++
 4 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index c3dd1821..2422eef1 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -34,6 +34,10 @@ void Request::setOperation(std::unique_ptr<Operation> msg){
     operation = std::move(msg);
 }
 
+std::unique_ptr<Operation>& Request::getOperation(){
+    return operation;
+}
+
 void Request::setTimeout(unsigned long timeout) {
     this->timeout_period = timeout;
 }
diff --git a/src/MicroOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
index 07a56627..2aaf7a89 100644
--- a/src/MicroOcpp/Core/Request.h
+++ b/src/MicroOcpp/Core/Request.h
@@ -49,6 +49,7 @@ class Request {
     ~Request();
 
     void setOperation(std::unique_ptr<Operation> msg);
+    std::unique_ptr<Operation>& getOperation();
 
     void setTimeout(unsigned long timeout); //0 = disable timeout
     bool isTimeoutExceeded();
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index b247d0de..2fe9df1e 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -9,6 +9,7 @@
 #include <MicroOcpp/Core/OcppError.h>
 #include <MicroOcpp/Core/RequestStore.h>
 #include <MicroOcpp/Core/OperationRegistry.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
 
 #include <MicroOcpp/Debug.h>
 
@@ -129,7 +130,21 @@ void RequestQueue::sendRequest(std::unique_ptr<Request> op){
         MO_DBG_ERR("Called with null. Ignore");
         return;
     }
-    
+
+    // Don't queue up multiple StatusNotification messages for the same connectorId
+    if (strcmp(op->getOperationType(), "StatusNotification") == 0)
+    {
+        auto new_status_notification = static_cast<Ocpp16::StatusNotification*>(op->getOperation().get());
+        initiatedRequests->drop_if([&new_status_notification] (const std::unique_ptr<Request>& operation) {
+            if (strcmp(operation->getOperationType(), "StatusNotification")!= 0)
+            {
+                return false;
+            }
+            auto old_status_notification = static_cast<Ocpp16::StatusNotification*>(operation->getOperation().get());
+            return old_status_notification->getConnectorId() == new_status_notification->getConnectorId();
+        });
+    }
+
     initiatedRequests->push_back(std::move(op));
 }
 
diff --git a/src/MicroOcpp/Operations/StatusNotification.h b/src/MicroOcpp/Operations/StatusNotification.h
index ef0e6a1f..8687e05b 100644
--- a/src/MicroOcpp/Operations/StatusNotification.h
+++ b/src/MicroOcpp/Operations/StatusNotification.h
@@ -35,6 +35,10 @@ class StatusNotification : public Operation {
     void processReq(JsonObject payload) override;
 
     std::unique_ptr<DynamicJsonDocument> createConf() override;
+
+    int getConnectorId() {
+        return connectorId;
+    }
 };
 
 } // namespace Ocpp16

From e9615720fa1ad2e5d8520a9a5c7b35fe98fcfb8d Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Tue, 11 Jun 2024 23:36:45 +0000
Subject: [PATCH 499/549] TC_016_CS: Reset shouldnt set connectors inoperative.

Setting them to inOperative causes the status to change to
Unavailable.

The OCPP Test Spec and OCTT requires the Status to change to
Finishing when a Reset has been recieved.
---
 src/MicroOcpp/Model/Reset/ResetService.cpp | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index 43f7b680..277687b8 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -96,11 +96,6 @@ void ResetService::initiateReset(bool isHard) {
         outstandingResetRetries = 5;
     }
     t_resetRetry = mocpp_tick_ms();
-
-    for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
-        auto connector = context.getModel().getConnector(cId);
-        connector->setAvailabilityVolatile(false);
-    }
 }
 
 #if MO_PLATFORM == MO_PLATFORM_ARDUINO && (defined(ESP32) || defined(ESP8266))

From f5cde7f70b91b7578a5ea8281c797d10eebc0b8d Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Wed, 12 Jun 2024 00:18:35 +0000
Subject: [PATCH 500/549] TC_069: Add support for ParentIdTag

Should allow an ID Tags with the same parent ID Tag to
start/stop transactions together.

- Associate parent ID Tag with a transaction if known.
- If a transaction is underway, and an ID tag is swiped which
  doesn't match the one that started the transaction, then submit
  an Authorize request.
- If the Authorize request is accepted, and if it contains a
  matching parent ID tag with the transaction, then end the
  transaction.
---
 src/MicroOcpp.cpp                             | 27 +++++++++++++++++--
 .../Model/Transactions/Transaction.cpp        |  5 ++++
 .../Model/Transactions/Transaction.h          |  4 +++
 src/MicroOcpp/Operations/StartTransaction.cpp |  5 ++++
 4 files changed, 39 insertions(+), 2 deletions(-)

diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 6eb15c53..b02e3ebb 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -431,8 +431,31 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
         if (!idTag || !strcmp(idTag, getTransactionIdTag(connectorId))) {
             res = endTransaction_authorized(idTag, reason, connectorId);
         } else {
-            MO_DBG_INFO("endTransaction: idTag doesn't match");
-            (void)0;
+            auto& tx = getTransaction(connectorId);
+            const char *parentIdTag = tx->getParentIdTag();
+            if (strlen(parentIdTag) > 0)
+            {
+                // We have a parent ID tag, so we need to check if this new card also has one
+                auto authorize = makeRequest(new Ocpp16::Authorize(context->getModel(), idTag));
+                // authorize->setTimeout(authorizationTimeoutInt && authorizationTimeoutInt->getInt() > 0 ? authorizationTimeoutInt->getInt() * 1000UL : 20UL * 1000UL);
+                authorize->setOnReceiveConfListener([idTag, parentIdTag, connectorId, reason] (JsonObject response) {
+                    JsonObject idTagInfo = response["idTagInfo"];
+
+                    if (strcmp("Accepted", idTagInfo["status"] | "UNDEFINED")) {
+                        //Authorization rejected, do nothing
+                        return;
+                    }
+                    if (idTagInfo.containsKey("parentIdTag") && strcmp(idTagInfo["parenIdTag"], parentIdTag))
+                    {
+                        endTransaction_authorized(idTag, reason, connectorId);
+                    }
+                });
+                context->initiateRequest(std::move(authorize));
+                res = true;
+            } else {
+                MO_DBG_INFO("endTransaction: idTag doesn't match");
+                (void)0;
+            }
         }
     }
     return res;
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.cpp b/src/MicroOcpp/Model/Transactions/Transaction.cpp
index 9c6535fa..cdd9ce0c 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.cpp
+++ b/src/MicroOcpp/Model/Transactions/Transaction.cpp
@@ -12,6 +12,11 @@ bool Transaction::setIdTag(const char *idTag) {
     return ret >= 0 && ret < IDTAG_LEN_MAX + 1;
 }
 
+bool Transaction::setParentIdTag(const char *idTag) {
+    auto ret = snprintf(this->parentIdTag, IDTAG_LEN_MAX + 1, "%s", idTag);
+    return ret >= 0 && ret < IDTAG_LEN_MAX + 1;
+}
+
 bool Transaction::setStopIdTag(const char *idTag) {
     auto ret = snprintf(stop_idTag, IDTAG_LEN_MAX + 1, "%s", idTag);
     return ret >= 0 && ret < IDTAG_LEN_MAX + 1;
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index b1d2a837..2f22b5a5 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -57,6 +57,7 @@ class Transaction {
     Timestamp start_timestamp = MIN_TIME;      //timestamp of StartTx; can be set before actually initiating
     uint16_t start_bootNr = 0;
     int transactionId = -1; //only valid if confirmed = true
+    char parentIdTag [IDTAG_LEN_MAX + 1] = {'\0'};
 
     /*
      * Attributes of StopTransaction
@@ -137,6 +138,9 @@ class Transaction {
 
     void setTransactionId(int transactionId) {this->transactionId = transactionId;}
 
+    bool setParentIdTag(const char *idTag);
+    const char *getParentIdTag() {return parentIdTag;}
+
     SendStatus& getStopSync() {return stop_sync;}
 
     bool setStopIdTag(const char *idTag);
diff --git a/src/MicroOcpp/Operations/StartTransaction.cpp b/src/MicroOcpp/Operations/StartTransaction.cpp
index 80ecb961..1e696baa 100644
--- a/src/MicroOcpp/Operations/StartTransaction.cpp
+++ b/src/MicroOcpp/Operations/StartTransaction.cpp
@@ -148,6 +148,11 @@ void StartTransaction::processConf(JsonObject payload) {
     int transactionId = payload["transactionId"] | -1;
     transaction->setTransactionId(transactionId);
 
+    if (payload["idTagInfo"].containsKey("parentIdTag"))
+    {
+        transaction->setParentIdTag(payload["idTagInfo"]["parentIdTag"]);
+    }
+
     transaction->getStartSync().confirm();
     transaction->commit();
 

From 5d191d06dc490d1071c962e3d50a62c6e289e94f Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Wed, 12 Jun 2024 00:41:20 +0000
Subject: [PATCH 501/549] TC_062: Add support for rejecting DataTransfer

According to the test spec, you need to return Rejected if
you don't support DataTransfer. Returning Unimplemented is not
valid.
---
 .../Model/ConnectorBase/ConnectorsCommon.cpp          |  3 +++
 src/MicroOcpp/Operations/DataTransfer.cpp             | 11 +++++++++++
 src/MicroOcpp/Operations/DataTransfer.h               |  5 +++++
 3 files changed, 19 insertions(+)

diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index 67c6818d..296aaf60 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -2,6 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include "DataTransfer.h"
 #include <string>
 
 #include <MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h>
@@ -45,6 +46,8 @@ ConnectorsCommon::ConnectorsCommon(Context& context, unsigned int numConn, std::
         return new Ocpp16::ChangeConfiguration();});
     context.getOperationRegistry().registerOperation("ClearCache", [filesystem] () {
         return new Ocpp16::ClearCache(filesystem);});
+    context.getOperationRegistry().registerOperation("DataTransfer", [] () {
+        return new Ocpp16::DataTransfer();});
     context.getOperationRegistry().registerOperation("GetConfiguration", [] () {
         return new Ocpp16::GetConfiguration();});
     context.getOperationRegistry().registerOperation("RemoteStartTransaction", [&context] () {
diff --git a/src/MicroOcpp/Operations/DataTransfer.cpp b/src/MicroOcpp/Operations/DataTransfer.cpp
index a7f4af1c..9ab12917 100644
--- a/src/MicroOcpp/Operations/DataTransfer.cpp
+++ b/src/MicroOcpp/Operations/DataTransfer.cpp
@@ -32,3 +32,14 @@ void DataTransfer::processConf(JsonObject payload){
         MO_DBG_INFO("Request has been denied");
     }
 }
+
+void DataTransfer::processReq(JsonObject payload) {
+    // Do nothing - we're just required to reject these DataTransfer requests
+}
+
+std::unique_ptr<DynamicJsonDocument> DataTransfer::createConf(){
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+    payload["status"] = "Rejected";
+    return doc;
+}
diff --git a/src/MicroOcpp/Operations/DataTransfer.h b/src/MicroOcpp/Operations/DataTransfer.h
index c8faa586..ec16ed46 100644
--- a/src/MicroOcpp/Operations/DataTransfer.h
+++ b/src/MicroOcpp/Operations/DataTransfer.h
@@ -14,6 +14,7 @@ class DataTransfer : public Operation {
 private:
     std::string msg {};
 public:
+    DataTransfer() {};
     DataTransfer(const std::string &msg);
 
     const char* getOperationType() override;
@@ -21,6 +22,10 @@ class DataTransfer : public Operation {
     std::unique_ptr<DynamicJsonDocument> createReq() override;
 
     void processConf(JsonObject payload) override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<DynamicJsonDocument> createConf() override;
     
 };
 

From ffbe32428cca2617c818c07926a54b11e3c9f946 Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Wed, 12 Jun 2024 02:10:32 +0000
Subject: [PATCH 502/549] TC_040_2: Validate integer configurations

Interval duration configuration should not be allowed to be set to
negative values, according to the spec.
---
 src/MicroOcpp/Model/Metering/MeteringService.cpp | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index b2bc7373..10812696 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -55,10 +55,23 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
         }
         return isValid;
     };
+
+    std::function<bool(const char*)> validateUnsignedIntString = [] (const char *value) {
+        for(size_t i = 0; value[i] != '\0'; i++)
+        {
+            if (value[i] < '0' || value[i] > '9') {
+                return false;
+            }
+        }
+        return true;
+    };
+
     registerConfigurationValidator("MeterValuesSampledData", validateSelectString);
     registerConfigurationValidator("StopTxnSampledData", validateSelectString);
     registerConfigurationValidator("MeterValuesAlignedData", validateSelectString);
     registerConfigurationValidator("StopTxnAlignedData", validateSelectString);
+    registerConfigurationValidator("MeterValueSampleInterval", validateUnsignedIntString);
+    registerConfigurationValidator("ClockAlignedDataInterval", validateUnsignedIntString);
 
     /*
      * Register further message handlers to support echo mode: when this library

From 54a3f251036084a89336bb3893b9ad0366301d8d Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Wed, 12 Jun 2024 01:12:38 +0000
Subject: [PATCH 503/549] TC_043_1: Respond NotSupported to SendLocalList if
 LocalList is not supported.

---
 src/MicroOcpp/Operations/SendLocalList.cpp | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 53dc3de5..ec1022d8 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -2,6 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
+#include "Configuration.h"
 #include <MicroOcpp/Operations/SendLocalList.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
@@ -21,6 +22,11 @@ const char* SendLocalList::getOperationType(){
 }
 
 void SendLocalList::processReq(JsonObject payload) {
+    auto supported_feature_profiles = declareConfiguration<const char*>("SupportedFeatureProfiles", "");
+    if (strstr(supported_feature_profiles->getString(), "LocalAuthListManagement") == NULL) {
+        return;
+    }
+
     if (!payload.containsKey("listVersion") || !payload.containsKey("updateType")) {
         errorCode = "FormationViolation";
         return;
@@ -53,8 +59,11 @@ void SendLocalList::processReq(JsonObject payload) {
 std::unique_ptr<DynamicJsonDocument> SendLocalList::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
+    auto supported_feature_profiles = declareConfiguration<const char*>("SupportedFeatureProfiles", "");
 
-    if (versionMismatch) {
+    if (strstr(supported_feature_profiles->getString(), "LocalAuthListManagement") == NULL) {
+        payload["status"] = "NotSupported";
+    } else if (versionMismatch) {
         payload["status"] = "VersionMismatch";
     } else if (updateFailure) {
         payload["status"] = "Failed";

From 076ef54dc6befb900c7aa1a6071900bc8e82d522 Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Wed, 12 Jun 2024 01:34:32 +0000
Subject: [PATCH 504/549] TC_042_1: Return -1 for listVersion when local auth
 list not supported (TC_042_1_CS)

---
 src/MicroOcpp/Operations/GetLocalListVersion.cpp | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.cpp b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
index 7c0a2c67..1fe8dbfb 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.cpp
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
@@ -2,6 +2,7 @@
 // Copyright Matthias Akstaller 2019 - 2023
 // MIT License
 
+#include "Configuration.h"
 #include <MicroOcpp/Operations/GetLocalListVersion.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
@@ -24,7 +25,11 @@ void GetLocalListVersion::processReq(JsonObject payload) {
 std::unique_ptr<DynamicJsonDocument> GetLocalListVersion::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    if (auto authService = model.getAuthorizationService()) {
+    auto supported_feature_profiles = declareConfiguration<const char*>("SupportedFeatureProfiles", "");
+
+    if (strstr(supported_feature_profiles->getString(), "LocalAuthListManagement") == NULL) {
+        payload["listVersion"] = -1;
+    } else if (auto authService = model.getAuthorizationService()) {
         payload["listVersion"] = authService->getLocalListVersion();
     } else {
         payload["listVersion"] = -1;

From de8a65b0bf293bf3800e425a2476c195ca01c594 Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Wed, 12 Jun 2024 01:43:36 +0000
Subject: [PATCH 505/549] TC_031: Return notSupported for UnlockConnector on
 invalid connector ID

---
 src/MicroOcpp/Operations/UnlockConnector.cpp | 15 +++++++++++----
 src/MicroOcpp/Operations/UnlockConnector.h   |  2 ++
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index 9a171711..a5cc682c 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -20,10 +20,10 @@ void UnlockConnector::processReq(JsonObject payload) {
     
     auto connectorId = payload["connectorId"] | -1;
 
-    auto connector = model.getConnector(connectorId);
+    connector = model.getConnector(connectorId);
 
     if (!connector) {
-        errorCode = "PropertyConstraintViolation";
+        // NotSupported
         return;
     }
 
@@ -43,6 +43,15 @@ void UnlockConnector::processReq(JsonObject payload) {
 }
 
 std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
+    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    JsonObject payload = doc->to<JsonObject>();
+
+    if (connector == nullptr) {
+        // NotSupported
+        payload["status"] = "NotSupported";
+        return doc;
+    }
+
     if (unlockConnector && mocpp_tick_ms() - timerStart < MO_UNLOCK_TIMEOUT) {
         //do poll and if more time is needed, delay creation of conf msg
 
@@ -54,8 +63,6 @@ std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
         }
     }
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
-    JsonObject payload = doc->to<JsonObject>();
     if (!unlockConnector) {
         payload["status"] = "NotSupported";
     } else if (cbUnlockResult == UnlockConnectorResult_Unlocked) {
diff --git a/src/MicroOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
index ba4081dd..6692d731 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.h
+++ b/src/MicroOcpp/Operations/UnlockConnector.h
@@ -6,6 +6,7 @@
 #define UNLOCKCONNECTOR_H
 
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <functional>
 
@@ -19,6 +20,7 @@ class UnlockConnector : public Operation {
 private:
     Model& model;
     std::function<UnlockConnectorResult ()> unlockConnector;
+    Connector *connector = nullptr;
     UnlockConnectorResult cbUnlockResult;
     unsigned long timerStart = 0; //for timeout
 

From eb09ad66fe836878dd7b8bce5771507fb5684d07 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 26 Jul 2024 16:47:02 +0200
Subject: [PATCH 506/549] update (#344) to newest MO version and complement
 changes

---
 CHANGELOG.md                                  |  6 ++++
 src/MicroOcpp.cpp                             | 29 +++++++++++++++----
 src/MicroOcpp/Core/Request.cpp                |  4 +--
 src/MicroOcpp/Core/Request.h                  |  2 +-
 src/MicroOcpp/Core/RequestQueue.cpp           |  4 +--
 .../Model/ConnectorBase/Connector.cpp         | 14 +++++++--
 .../Model/ConnectorBase/ConnectorsCommon.cpp  |  2 +-
 src/MicroOcpp/Model/Reset/ResetService.cpp    |  4 ---
 .../Model/Transactions/Transaction.h          |  8 ++---
 .../Transactions/TransactionDeserialize.cpp   | 10 +++++++
 .../Operations/GetLocalListVersion.cpp        |  5 +---
 src/MicroOcpp/Operations/SendLocalList.cpp    |  9 +-----
 src/MicroOcpp/Operations/UnlockConnector.h    |  1 -
 13 files changed, 64 insertions(+), 34 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 597f386f..0530868a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,8 @@
 - Built-in Diagnostics over FTP ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
 - Error `severity` mechanism ([#331](https://github.com/matth-x/MicroOcpp/pull/331))
 - Build flag `MO_REPORT_NOERROR` to report error recovery ([#331](https://github.com/matth-x/MicroOcpp/pull/331))
+- Support for `parentIdTag` ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
+- Input validation for unsigned int Configs ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 
 ### Removed
 
@@ -26,6 +28,10 @@
 - Hold back error StatusNotifs when time not set ([#311](https://github.com/matth-x/MicroOcpp/issues/311))
 - Don't send Available when tx occupies connector ([#315](https://github.com/matth-x/MicroOcpp/issues/315))
 - Make ChargingScheduleAllowedChargingRateUnit read-only ([#328](https://github.com/matth-x/MicroOcpp/issues/328))
+- Don't send StatusNotifs while offline ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
+- Don't change into Unavailable upon Reset ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
+- Reject DataTransfer by default ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
+- UnlockConnector NotSupported if connectorId invalid ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 3a07fd30..77a6c904 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -464,25 +464,44 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
         if (!idTag || !strcmp(idTag, getTransactionIdTag(connectorId))) {
             res = endTransaction_authorized(idTag, reason, connectorId);
         } else {
-            auto& tx = getTransaction(connectorId);
+            auto tx = getTransaction(connectorId);
             const char *parentIdTag = tx->getParentIdTag();
             if (strlen(parentIdTag) > 0)
             {
                 // We have a parent ID tag, so we need to check if this new card also has one
                 auto authorize = makeRequest(new Ocpp16::Authorize(context->getModel(), idTag));
-                // authorize->setTimeout(authorizationTimeoutInt && authorizationTimeoutInt->getInt() > 0 ? authorizationTimeoutInt->getInt() * 1000UL : 20UL * 1000UL);
-                authorize->setOnReceiveConfListener([idTag, parentIdTag, connectorId, reason] (JsonObject response) {
+                std::string idTag_capture = idTag;
+                std::string reason_capture = reason ? reason : "";
+                authorize->setOnReceiveConfListener([idTag_capture, reason_capture, connectorId, tx] (JsonObject response) {
                     JsonObject idTagInfo = response["idTagInfo"];
 
                     if (strcmp("Accepted", idTagInfo["status"] | "UNDEFINED")) {
                         //Authorization rejected, do nothing
+                        MO_DBG_DEBUG("Authorize rejected (%s), continue transaction", idTag_capture.c_str());
+                        auto connector = context->getModel().getConnector(connectorId);
+                        if (connector) {
+                            connector->updateTxNotification(TxNotification::AuthorizationRejected);
+                        }
                         return;
                     }
-                    if (idTagInfo.containsKey("parentIdTag") && strcmp(idTagInfo["parenIdTag"], parentIdTag))
+                    if (idTagInfo.containsKey("parentIdTag") && !strcmp(idTagInfo["parenIdTag"], tx->getParentIdTag()))
                     {
-                        endTransaction_authorized(idTag, reason, connectorId);
+                        endTransaction_authorized(idTag_capture.c_str(), reason_capture.empty() ? (const char*)nullptr : reason_capture.c_str(), connectorId);
                     }
                 });
+
+                authorize->setOnTimeoutListener([idTag_capture, connectorId] () {
+                    //Authorization timed out, do nothing
+                    MO_DBG_DEBUG("Authorization timeout (%s), continue transaction", idTag_capture.c_str());
+                    auto connector = context->getModel().getConnector(connectorId);
+                    if (connector) {
+                        connector->updateTxNotification(TxNotification::AuthorizationTimeout);
+                    }
+                });
+
+                auto authorizationTimeoutInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
+                authorize->setTimeout(authorizationTimeoutInt && authorizationTimeoutInt->getInt() > 0 ? authorizationTimeoutInt->getInt() * 1000UL : 20UL * 1000UL);
+
                 context->initiateRequest(std::move(authorize));
                 res = true;
             } else {
diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index 99bbed9c..6c5444d1 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -34,8 +34,8 @@ void Request::setOperation(std::unique_ptr<Operation> msg){
     operation = std::move(msg);
 }
 
-std::unique_ptr<Operation>& Request::getOperation(){
-    return operation;
+Operation *Request::getOperation(){
+    return operation.get();
 }
 
 void Request::setTimeout(unsigned long timeout) {
diff --git a/src/MicroOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
index 1df638b1..ebdeac30 100644
--- a/src/MicroOcpp/Core/Request.h
+++ b/src/MicroOcpp/Core/Request.h
@@ -49,7 +49,7 @@ class Request {
     ~Request();
 
     void setOperation(std::unique_ptr<Operation> msg);
-    std::unique_ptr<Operation>& getOperation();
+    Operation *getOperation();
 
     void setTimeout(unsigned long timeout); //0 = disable timeout
     bool isTimeoutExceeded();
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index d0eabd06..b5ca5049 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -134,13 +134,13 @@ void RequestQueue::sendRequest(std::unique_ptr<Request> op){
     // Don't queue up multiple StatusNotification messages for the same connectorId
     if (strcmp(op->getOperationType(), "StatusNotification") == 0)
     {
-        auto new_status_notification = static_cast<Ocpp16::StatusNotification*>(op->getOperation().get());
+        auto new_status_notification = static_cast<Ocpp16::StatusNotification*>(op->getOperation());
         initiatedRequests->drop_if([&new_status_notification] (const std::unique_ptr<Request>& operation) {
             if (strcmp(operation->getOperationType(), "StatusNotification")!= 0)
             {
                 return false;
             }
-            auto old_status_notification = static_cast<Ocpp16::StatusNotification*>(operation->getOperation().get());
+            auto old_status_notification = static_cast<Ocpp16::StatusNotification*>(operation->getOperation());
             return old_status_notification->getConnectorId() == new_status_notification->getConnectorId();
         });
     }
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 42d034c3..5fc1175b 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -686,8 +686,6 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             }
         }
     }
-    #else
-    (void)parentIdTag;
     #endif //MO_ENABLE_RESERVATION
 
     transaction = allocateTransaction();
@@ -704,6 +702,10 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         transaction->setIdTag(idTag);
     }
 
+    if (parentIdTag) {
+        transaction->setParentIdTag(parentIdTag);
+    }
+
     transaction->setBeginTimestamp(model.getClock().now());
 
     //check for local preauthorization
@@ -766,6 +768,10 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         }
         #endif //MO_ENABLE_RESERVATION
 
+        if (idTagInfo.containsKey("parentIdTag")) {
+            tx->setParentIdTag(idTagInfo["parentIdTag"] | "");
+        }
+
         MO_DBG_DEBUG("Authorized transaction process (%s)", tx->getIdTag());
         tx->setAuthorized();
         tx->commit();
@@ -853,6 +859,10 @@ std::shared_ptr<Transaction> Connector::beginTransaction_authorized(const char *
         transaction->setIdTag(idTag);
     }
 
+    if (parentIdTag) {
+        transaction->setParentIdTag(parentIdTag);
+    }
+
     transaction->setBeginTimestamp(model.getClock().now());
     
     MO_DBG_DEBUG("Begin transaction process (%s), already authorized", idTag != nullptr ? idTag : "");
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index 4e3ae315..3eb9d596 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -2,7 +2,6 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#include "DataTransfer.h"
 #include <string>
 
 #include <MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h>
@@ -11,6 +10,7 @@
 #include <MicroOcpp/Operations/ChangeAvailability.h>
 #include <MicroOcpp/Operations/ChangeConfiguration.h>
 #include <MicroOcpp/Operations/ClearCache.h>
+#include <MicroOcpp/Operations/DataTransfer.h>
 #include <MicroOcpp/Operations/GetConfiguration.h>
 #include <MicroOcpp/Operations/RemoteStartTransaction.h>
 #include <MicroOcpp/Operations/RemoteStopTransaction.h>
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index 1cf0b446..e21b448f 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -53,10 +53,6 @@ void ResetService::loop() {
         MO_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
 
         if (outstandingResetRetries <= 0) {
-            for (unsigned int cId = 0; cId < context.getModel().getNumConnectors(); cId++) {
-                auto connector = context.getModel().getConnector(cId);
-                connector->setAvailabilityVolatile(true);
-            }
 
             ChargePointStatus cpStatus = ChargePointStatus_UNDEFINED;
             if (context.getModel().getNumConnectors() > 0) {
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index a852029e..74997059 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -43,6 +43,7 @@ class Transaction {
      * Attributes existing before StartTransaction
      */
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
+    char parentIdTag [IDTAG_LEN_MAX + 1] = {'\0'};
     bool authorized = false;    //if the given idTag was authorized
     bool deauthorized = false;  //if the server revoked a local authorization
     Timestamp begin_timestamp = MIN_TIME;
@@ -57,7 +58,6 @@ class Transaction {
     Timestamp start_timestamp = MIN_TIME;      //timestamp of StartTx; can be set before actually initiating
     uint16_t start_bootNr = 0;
     int transactionId = -1; //only valid if confirmed = true
-    char parentIdTag [IDTAG_LEN_MAX + 1] = {'\0'};
 
     /*
      * Attributes of StopTransaction
@@ -112,6 +112,9 @@ class Transaction {
     bool setIdTag(const char *idTag);
     const char *getIdTag() {return idTag;}
 
+    bool setParentIdTag(const char *idTag);
+    const char *getParentIdTag() {return parentIdTag;}
+
     void setAuthorized() {authorized = true;}
     void setIdTagDeauthorized() {deauthorized = true;}
 
@@ -138,9 +141,6 @@ class Transaction {
 
     void setTransactionId(int transactionId) {this->transactionId = transactionId;}
 
-    bool setParentIdTag(const char *idTag);
-    const char *getParentIdTag() {return parentIdTag;}
-
     SendStatus& getStopSync() {return stop_sync;}
 
     bool setStopIdTag(const char *idTag);
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
index 0c66ce11..bb951f82 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -40,6 +40,9 @@ bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
     if (tx.getIdTag()[0] != '\0') {
         sessionState["idTag"] = tx.getIdTag();
     }
+    if (tx.getParentIdTag()[0] != '\0') {
+        sessionState["parentIdTag"] = tx.getParentIdTag();
+    }
     if (tx.isAuthorized()) {
         sessionState["authorized"] = true;
     }
@@ -129,6 +132,13 @@ bool deserializeTransaction(Transaction& tx, JsonObject state) {
         }
     }
 
+    if (sessionState.containsKey("parentIdTag")) {
+        if (!tx.setParentIdTag(sessionState["parentIdTag"] | "")) {
+            MO_DBG_ERR("read err");
+            return false;
+        }
+    }
+
     if (sessionState["authorized"] | false) {
         tx.setAuthorized();
     }
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.cpp b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
index a03212e9..0802509c 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.cpp
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
@@ -2,7 +2,6 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#include "Configuration.h"
 #include <MicroOcpp/Version.h>
 
 #if MO_ENABLE_LOCAL_AUTH
@@ -31,9 +30,7 @@ std::unique_ptr<DynamicJsonDocument> GetLocalListVersion::createConf(){
     JsonObject payload = doc->to<JsonObject>();
     auto supported_feature_profiles = declareConfiguration<const char*>("SupportedFeatureProfiles", "");
 
-    if (strstr(supported_feature_profiles->getString(), "LocalAuthListManagement") == NULL) {
-        payload["listVersion"] = -1;
-    } else if (auto authService = model.getAuthorizationService()) {
+    if (auto authService = model.getAuthorizationService()) {
         payload["listVersion"] = authService->getLocalListVersion();
     } else {
         payload["listVersion"] = -1;
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index e7425ac0..7f7d6d9e 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -2,7 +2,6 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#include "Configuration.h"
 #include <MicroOcpp/Version.h>
 
 #if MO_ENABLE_LOCAL_AUTH
@@ -26,10 +25,6 @@ const char* SendLocalList::getOperationType(){
 }
 
 void SendLocalList::processReq(JsonObject payload) {
-    auto supported_feature_profiles = declareConfiguration<const char*>("SupportedFeatureProfiles", "");
-    if (strstr(supported_feature_profiles->getString(), "LocalAuthListManagement") == NULL) {
-        return;
-    }
 
     if (!payload.containsKey("listVersion") || !payload.containsKey("updateType")) {
         errorCode = "FormationViolation";
@@ -65,9 +60,7 @@ std::unique_ptr<DynamicJsonDocument> SendLocalList::createConf(){
     JsonObject payload = doc->to<JsonObject>();
     auto supported_feature_profiles = declareConfiguration<const char*>("SupportedFeatureProfiles", "");
 
-    if (strstr(supported_feature_profiles->getString(), "LocalAuthListManagement") == NULL) {
-        payload["status"] = "NotSupported";
-    } else if (versionMismatch) {
+    if (versionMismatch) {
         payload["status"] = "VersionMismatch";
     } else if (updateFailure) {
         payload["status"] = "Failed";
diff --git a/src/MicroOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
index 0311cc15..bf49d195 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.h
+++ b/src/MicroOcpp/Operations/UnlockConnector.h
@@ -6,7 +6,6 @@
 #define UNLOCKCONNECTOR_H
 
 #include <MicroOcpp/Core/Operation.h>
-#include <MicroOcpp/Model/ConnectorBase/Connector.h>
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <functional>
 

From d7c0e1200ea57b70bcdf486ee1ce5e053b21213f Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Fri, 26 Jul 2024 17:07:48 +0200
Subject: [PATCH 507/549] clean obsolete config declarations

---
 src/MicroOcpp/Operations/GetLocalListVersion.cpp | 1 -
 src/MicroOcpp/Operations/SendLocalList.cpp       | 1 -
 2 files changed, 2 deletions(-)

diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.cpp b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
index 0802509c..b1428791 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.cpp
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
@@ -28,7 +28,6 @@ void GetLocalListVersion::processReq(JsonObject payload) {
 std::unique_ptr<DynamicJsonDocument> GetLocalListVersion::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    auto supported_feature_profiles = declareConfiguration<const char*>("SupportedFeatureProfiles", "");
 
     if (auto authService = model.getAuthorizationService()) {
         payload["listVersion"] = authService->getLocalListVersion();
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 7f7d6d9e..128f5d8a 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -58,7 +58,6 @@ void SendLocalList::processReq(JsonObject payload) {
 std::unique_ptr<DynamicJsonDocument> SendLocalList::createConf(){
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
     JsonObject payload = doc->to<JsonObject>();
-    auto supported_feature_profiles = declareConfiguration<const char*>("SupportedFeatureProfiles", "");
 
     if (versionMismatch) {
         payload["status"] = "VersionMismatch";

From a2c6307b48bf4ba311e22f56d7175d3156dc74c3 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Wed, 31 Jul 2024 19:27:08 +0200
Subject: [PATCH 508/549] Support TransactionMessageAttempts and -RetryInterval
 (#345)

* refactor RequestQueue

* fix losing last txData after tx restore

* apply changes to v201

* stop tracking txBegin and txEnd in tx store

* add unit tests for TxMsgAttempts and debug

* fix compilation on ESP32

* fix compilation error on ESP8266

* avoid cast from CustomOperation("StatusNotification")

* update changelog
---
 CHANGELOG.md                                  |   5 +
 CMakeLists.txt                                |   2 -
 src/MicroOcpp.cpp                             |   2 +-
 src/MicroOcpp/Core/Context.cpp                |  39 +-
 src/MicroOcpp/Core/Context.h                  |   9 +-
 src/MicroOcpp/Core/Operation.cpp              |   8 -
 src/MicroOcpp/Core/Operation.h                |   8 +-
 src/MicroOcpp/Core/Request.cpp                | 226 +++-------
 src/MicroOcpp/Core/Request.h                  |  50 +--
 src/MicroOcpp/Core/RequestQueue.cpp           | 291 ++++++++-----
 src/MicroOcpp/Core/RequestQueue.h             |  77 +++-
 .../Core/RequestQueueStorageStrategy.cpp      | 180 --------
 .../Core/RequestQueueStorageStrategy.h        |  70 ----
 src/MicroOcpp/Core/RequestStore.cpp           | 203 ---------
 src/MicroOcpp/Core/RequestStore.h             |  70 ----
 src/MicroOcpp/Core/SimpleRequestFactory.cpp   |   9 +-
 src/MicroOcpp/Core/SimpleRequestFactory.h     |   7 +-
 src/MicroOcpp/Model/Boot/BootService.cpp      |   7 +-
 src/MicroOcpp/Model/Boot/BootService.h        |   1 -
 .../Model/ConnectorBase/Connector.cpp         | 390 ++++++++++++++----
 src/MicroOcpp/Model/ConnectorBase/Connector.h |  27 +-
 src/MicroOcpp/Model/Metering/MeterStore.cpp   |   6 +-
 src/MicroOcpp/Model/Metering/MeterStore.h     |   2 +-
 .../Model/Metering/MeteringConnector.cpp      |  19 +-
 .../Model/Metering/MeteringConnector.h        |   2 +
 .../Model/Metering/MeteringService.cpp        |  10 +
 .../Model/Metering/MeteringService.h          |   2 +
 .../Model/Transactions/Transaction.h          |  11 +
 .../Transactions/TransactionDeserialize.cpp   |  22 +
 .../Model/Transactions/TransactionService.cpp |   6 +
 .../Model/Transactions/TransactionStore.cpp   | 183 ++------
 .../Model/Transactions/TransactionStore.h     |  41 +-
 src/MicroOcpp/Operations/CustomOperation.cpp  |  20 +-
 src/MicroOcpp/Operations/CustomOperation.h    |  10 +-
 src/MicroOcpp/Operations/StartTransaction.cpp |  79 ----
 src/MicroOcpp/Operations/StartTransaction.h   |   4 -
 src/MicroOcpp/Operations/StopTransaction.cpp  |  80 ----
 src/MicroOcpp/Operations/StopTransaction.h    |   4 -
 src/MicroOcpp/Operations/TransactionEvent.cpp |  31 --
 src/MicroOcpp/Operations/TransactionEvent.h   |   2 -
 src/MicroOcpp/Operations/TriggerMessage.cpp   |   8 +-
 tests/ChargingSessions.cpp                    | 278 +++++++++++++
 tests/ConfigurationBehavior.cpp               |   4 +-
 tests/Metering.cpp                            |   5 +
 tests/Transactions.cpp                        |   1 +
 45 files changed, 1094 insertions(+), 1417 deletions(-)
 delete mode 100644 src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
 delete mode 100644 src/MicroOcpp/Core/RequestQueueStorageStrategy.h
 delete mode 100644 src/MicroOcpp/Core/RequestStore.cpp
 delete mode 100644 src/MicroOcpp/Core/RequestStore.h

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0530868a..d90671c6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,8 @@
 
 - Change `MicroOcpp::ChargePointStatus` into C-style enum ([#309](https://github.com/matth-x/MicroOcpp/pull/309))
 - Connector lock disabled by default per `MO_ENABLE_CONNECTOR_LOCK` ([#312](https://github.com/matth-x/MicroOcpp/pull/312))
+- Relaxed temporal order of non-tx-related operations ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
+- Use pseudo-GUIDs as messageId ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 
 ### Added
 
@@ -16,10 +18,13 @@
 - Build flag `MO_REPORT_NOERROR` to report error recovery ([#331](https://github.com/matth-x/MicroOcpp/pull/331))
 - Support for `parentIdTag` ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Input validation for unsigned int Configs ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
+- Support for TransactionMessageAttempts/-RetryInterval ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 
 ### Removed
 
 - ESP32 built-in HTTP OTA ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
+- Operation store (files op-*.jsn and opstore.jsn) ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
+- Explicit tracking of txNr (file txstore.jsn) ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 
 ### Fixed
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index a034a1ce..8036f3fa 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -22,8 +22,6 @@ set(MO_SRC
     src/MicroOcpp/Core/Request.cpp
     src/MicroOcpp/Core/Connection.cpp
     src/MicroOcpp/Core/Time.cpp
-    src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
-    src/MicroOcpp/Core/RequestStore.cpp
     src/MicroOcpp/Operations/Authorize.cpp
     src/MicroOcpp/Operations/BootNotification.cpp
     src/MicroOcpp/Operations/CancelReservation.cpp
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 77a6c904..bfde4634 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -289,7 +289,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new ConnectorsCommon(*context, MO_NUMCONNECTORS, filesystem)));
     std::vector<std::unique_ptr<Connector>> connectors;
     for (unsigned int connectorId = 0; connectorId < MO_NUMCONNECTORS; connectorId++) {
-        connectors.emplace_back(new Connector(*context, connectorId));
+        connectors.emplace_back(new Connector(*context, filesystem, connectorId));
     }
     model.setConnectors(std::move(connectors));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
diff --git a/src/MicroOcpp/Core/Context.cpp b/src/MicroOcpp/Core/Context.cpp
index 4d651557..f3efd3ea 100644
--- a/src/MicroOcpp/Core/Context.cpp
+++ b/src/MicroOcpp/Core/Context.cpp
@@ -12,10 +12,8 @@
 using namespace MicroOcpp;
 
 Context::Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr, ProtocolVersion version)
-        : connection(connection), model{version, bootNr}, reqQueue{operationRegistry, &model, filesystem} {
+        : connection(connection), model{version, bootNr}, reqQueue{connection, operationRegistry} {
 
-    preBootQueue = std::unique_ptr<RequestQueue>(new RequestQueue(operationRegistry, &model, nullptr)); //pre boot queue doesn't need persistency
-    preBootQueue->setConnection(connection);
 }
 
 Context::~Context() {
@@ -24,37 +22,16 @@ Context::~Context() {
 
 void Context::loop() {
     connection.loop();
-
-    if (preBootQueue) {
-        preBootQueue->loop(connection);
-    } else {
-        reqQueue.loop(connection);
-    }
-
+    reqQueue.loop();
     model.loop();
 }
 
-void Context::activatePostBootCommunication() {
-    //switch from pre boot connection to normal connetion
-    reqQueue.setConnection(connection);
-    preBootQueue.reset();
-}
-
 void Context::initiateRequest(std::unique_ptr<Request> op) {
-    if (op) {
-        reqQueue.sendRequest(std::move(op));
-    }
-}
-
-void Context::initiatePreBootOperation(std::unique_ptr<Request> op) {
-    if (op) {
-        if (preBootQueue) {
-            preBootQueue->sendRequest(std::move(op));
-        } else {
-            //not in pre boot mode anymore - initiate normally
-            initiateRequest(std::move(op));
-        }
+    if (!op) {
+        MO_DBG_ERR("invalid arg");
+        return;
     }
+    reqQueue.sendRequest(std::move(op));
 }
 
 Model& Context::getModel() {
@@ -73,6 +50,10 @@ Connection& Context::getConnection() {
     return connection;
 }
 
+RequestQueue& Context::getRequestQueue() {
+    return reqQueue;
+}
+
 void Context::setFtpClient(std::unique_ptr<FtpClient> ftpClient) {
     this->ftpClient = std::move(ftpClient);
 }
diff --git a/src/MicroOcpp/Core/Context.h b/src/MicroOcpp/Core/Context.h
index 1e87c0b3..eb8c0aef 100644
--- a/src/MicroOcpp/Core/Context.h
+++ b/src/MicroOcpp/Core/Context.h
@@ -25,8 +25,6 @@ class Context {
     Model model;
     RequestQueue reqQueue;
 
-    std::unique_ptr<RequestQueue> preBootQueue;
-
     std::unique_ptr<FtpClient> ftpClient;
 
 public:
@@ -35,12 +33,7 @@ class Context {
 
     void loop();
 
-    void activatePostBootCommunication();
-
     void initiateRequest(std::unique_ptr<Request> op);
-    
-    //for BootNotification and TriggerMessage: initiate operations before the first BootNotification was accepted (pre-boot mode)
-    void initiatePreBootOperation(std::unique_ptr<Request> op);
 
     Model& getModel();
 
@@ -50,6 +43,8 @@ class Context {
 
     Connection& getConnection();
 
+    RequestQueue& getRequestQueue();
+
     void setFtpClient(std::unique_ptr<FtpClient> ftpClient);
     FtpClient *getFtpClient();
 };
diff --git a/src/MicroOcpp/Core/Operation.cpp b/src/MicroOcpp/Core/Operation.cpp
index 386a43e6..63d76a20 100644
--- a/src/MicroOcpp/Core/Operation.cpp
+++ b/src/MicroOcpp/Core/Operation.cpp
@@ -17,14 +17,6 @@ const char* Operation::getOperationType(){
     return "CustomOperation";
 }
 
-void Operation::initiate(StoredOperationHandler *rpcData) {
-    //called after initiateRequest(anyMsg)
-}
-
-bool Operation::restore(StoredOperationHandler *rpcData) {
-    return false;
-}
-
 std::unique_ptr<DynamicJsonDocument> Operation::createReq() {
     MO_DBG_ERR("Unsupported operation: createReq() is not implemented");
     return createEmptyDocument();
diff --git a/src/MicroOcpp/Core/Operation.h b/src/MicroOcpp/Core/Operation.h
index e8079333..5da9aa56 100644
--- a/src/MicroOcpp/Core/Operation.h
+++ b/src/MicroOcpp/Core/Operation.h
@@ -18,10 +18,8 @@
  #ifndef MO_OPERATION_H
  #define MO_OPERATION_H
 
-#include <ArduinoJson.h>
 #include <memory>
-
-#include <MicroOcpp/Core/RequestStore.h>
+#include <ArduinoJson.h>
 
 namespace MicroOcpp {
 
@@ -35,10 +33,6 @@ class Operation {
     
     virtual const char* getOperationType();
 
-    virtual void initiate(StoredOperationHandler *rpcData);
-
-    virtual bool restore(StoredOperationHandler *rpcData);
-
     /**
      * Create the payload for the respective OCPP message
      * 
diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index 6c5444d1..a2cad9b8 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -6,7 +6,6 @@
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
-#include <MicroOcpp/Core/RequestStore.h>
 
 #include <MicroOcpp/Operations/StartTransaction.h>
 #include <MicroOcpp/Operations/StopTransaction.h>
@@ -14,26 +13,31 @@
 #include <MicroOcpp/Platform.h>
 #include <MicroOcpp/Debug.h>
 
-int unique_id_counter = 1000000;
-
-using namespace MicroOcpp;
-
-Request::Request(std::unique_ptr<Operation> msg) : operation(std::move(msg)) {
+namespace MicroOcpp {
+    unsigned int g_randSeed = 1394827383;
 
+    void writeRandomNonsecure(unsigned char *buf, size_t len) {
+        g_randSeed += mocpp_tick_ms();
+        const unsigned int a = 16807;
+        const unsigned int m = 2147483647;
+        for (size_t i = 0; i < len; i++) {
+            g_randSeed = (a * g_randSeed) % m;
+            buf[i] = g_randSeed;
+        }
+    }
 }
 
-Request::Request() {
+using namespace MicroOcpp;
 
+Request::Request(std::unique_ptr<Operation> msg) : operation(std::move(msg)) {
+    timeout_start = mocpp_tick_ms();
+    debugRequest_start = mocpp_tick_ms();
 }
 
 Request::~Request(){
 
 }
 
-void Request::setOperation(std::unique_ptr<Operation> msg){
-    operation = std::move(msg);
-}
-
 Operation *Request::getOperation(){
     return operation.get();
 }
@@ -54,41 +58,46 @@ void Request::executeTimeout() {
     timed_out = true;
 }
 
-unsigned int Request::getTrialNo() {
-    return trialNo;
-}
-
-void Request::setMessageID(const std::string &id){
+void Request::setMessageID(const char *id){
     if (!messageID.empty()){
-        MO_DBG_WARN("MessageID is set twice or is set after first usage!");
+        MO_DBG_ERR("messageID already defined");
     }
     messageID = id;
 }
 
-const char *Request::getMessageID() {
-    return messageID.c_str();
-}
+Request::CreateRequestResult Request::createRequest(DynamicJsonDocument& requestJson) {
 
-std::unique_ptr<DynamicJsonDocument> Request::createRequest(){
+    if (messageID.empty()) {
+        unsigned char random [18];
+        char guuid [sizeof(random) * 2 + 1];
+
+        writeRandomNonsecure(random, sizeof(random));
+
+        for (size_t i = 0; i < sizeof(random); i++) {
+            snprintf(guuid + i * 2, 3, "%02x", random[i]);
+        }
+        guuid[8] = guuid[13] = guuid[18] = guuid[23] = '-';
+        messageID = guuid;
+    }
 
     /*
      * Create the OCPP message
      */
     auto requestPayload = operation->createReq();
     if (!requestPayload) {
-        return nullptr;
+        return CreateRequestResult::Failure;
     }
 
     /*
      * Create OCPP-J Remote Procedure Call header
      */
     size_t json_buffsize = JSON_ARRAY_SIZE(4) + (messageID.length() + 1) + requestPayload->capacity();
-    auto requestJson = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
+    requestJson = DynamicJsonDocument(json_buffsize);
 
-    requestJson->add(MESSAGE_TYPE_CALL);                    //MessageType
-    requestJson->add(messageID);                      //Unique message ID
-    requestJson->add(operation->getOperationType());  //Action
-    requestJson->add(*requestPayload);                      //Payload
+    requestJson.add(MESSAGE_TYPE_CALL);                    //MessageType
+    requestJson.add(messageID);                      //Unique message ID
+    requestJson.add(operation->getOperationType());  //Action
+    requestJson.add(*requestPayload);                      //Payload
 
     if (MO_DBG_LEVEL >= MO_DL_DEBUG && mocpp_tick_ms() - debugRequest_start >= 10000) { //print contents on the console
         debugRequest_start = mocpp_tick_ms();
@@ -96,7 +105,7 @@ std::unique_ptr<DynamicJsonDocument> Request::createRequest(){
         char *buf = new char[1024];
         size_t len = 0;
         if (buf) {
-            len = serializeJson(*requestJson, buf, 1024);
+            len = serializeJson(requestJson, buf, 1024);
         }
 
         if (!buf || len < 1) {
@@ -108,9 +117,7 @@ std::unique_ptr<DynamicJsonDocument> Request::createRequest(){
         delete[] buf;
     }
 
-    trialNo++;
-
-    return requestJson;
+    return CreateRequestResult::Success;
 }
 
 bool Request::receiveResponse(JsonArray response){
@@ -163,10 +170,14 @@ bool Request::receiveResponse(JsonArray response){
 
 }
 
-bool Request::receiveRequest(JsonArray request){
+bool Request::receiveRequest(JsonArray request) {
+
+    if (!request[1].is<const char*>()) {
+        MO_DBG_ERR("malformatted msgId");
+        return false;
+    }
   
-    std::string msgId = request[1];
-    setMessageID(msgId);
+    setMessageID(request[1].as<const char*>());
     
     /*
      * Hand the payload over to the Request object
@@ -182,12 +193,7 @@ bool Request::receiveRequest(JsonArray request){
     return true; //success
 }
 
-std::unique_ptr<DynamicJsonDocument> Request::createResponse(){
-
-    /*
-     * Create the OCPP message
-     */
-    std::unique_ptr<DynamicJsonDocument> response = nullptr;
+Request::CreateResponseResult Request::createResponse(DynamicJsonDocument& response) {
 
     bool operationFailure = operation->getErrorCode() != nullptr;
 
@@ -196,18 +202,18 @@ std::unique_ptr<DynamicJsonDocument> Request::createResponse(){
         std::unique_ptr<DynamicJsonDocument> payload = operation->createConf();
 
         if (!payload) {
-            return nullptr; //confirmation message still pending
+            return CreateResponseResult::Pending; //confirmation message still pending
         }
 
         /*
          * Create OCPP-J Remote Procedure Call header
          */
-        size_t json_buffsize = JSON_ARRAY_SIZE(3) + (messageID.length() + 1) + payload->capacity();
-        response = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
+        size_t json_buffsize = JSON_ARRAY_SIZE(3) + payload->capacity();
+        response = DynamicJsonDocument(json_buffsize);
 
-        response->add(MESSAGE_TYPE_CALLRESULT);   //MessageType
-        response->add(messageID);            //Unique message ID
-        response->add(*payload);              //Payload
+        response.add(MESSAGE_TYPE_CALLRESULT);   //MessageType
+        response.add(messageID.c_str());            //Unique message ID
+        response.add(*payload);              //Payload
 
         if (onSendConfListener) {
             onSendConfListener(payload->as<JsonObject>());
@@ -217,127 +223,23 @@ std::unique_ptr<DynamicJsonDocument> Request::createResponse(){
 
         const char *errorCode = operation->getErrorCode();
         const char *errorDescription = operation->getErrorDescription();
-        std::unique_ptr<DynamicJsonDocument> errorDetails = std::unique_ptr<DynamicJsonDocument>(operation->getErrorDetails());
-        if (!errorCode) { //catch corner case when payload is null but errorCode is not set too!
-            errorCode = "GenericError";
-            errorDescription = "Could not create payload (createConf() returns Null)";
-            errorDetails = std::unique_ptr<DynamicJsonDocument>(createEmptyDocument());
-        }
+        std::unique_ptr<DynamicJsonDocument> errorDetails = operation->getErrorDetails();
 
         /*
          * Create OCPP-J Remote Procedure Call header
          */
         size_t json_buffsize = JSON_ARRAY_SIZE(5)
-                    + (messageID.length() + 1)
-                    + strlen(errorCode) + 1
-                    + strlen(errorDescription) + 1
                     + errorDetails->capacity();
-        response = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
-
-        response->add(MESSAGE_TYPE_CALLERROR);   //MessageType
-        response->add(messageID);            //Unique message ID
-        response->add(errorCode);
-        response->add(errorDescription);
-        response->add(*errorDetails);              //Error description
-    }
-
-    return response;
-}
-
-void Request::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
-
-    timeout_start = mocpp_tick_ms();
-    debugRequest_start = mocpp_tick_ms();
-
-    //assign messageID
-    char id_str [16] = {'\0'};
-    sprintf(id_str, "%d", unique_id_counter++);
-    messageID = std::string {id_str};
-
-    if (operation) {
+        response = DynamicJsonDocument(json_buffsize);
 
-        /*
-         * Create OCPP-J Remote Procedure Call header storage entry
-         */
-        opStore = std::move(opStorage);
-
-        if (opStore) {
-            size_t json_buffsize = JSON_ARRAY_SIZE(3) + (messageID.length() + 1);
-            auto rpcData = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(json_buffsize));
-
-            rpcData->add(MESSAGE_TYPE_CALL);                    //MessageType
-            rpcData->add(messageID);                      //Unique message ID
-            rpcData->add(operation->getOperationType());  //Action
-
-            opStore->setRpcData(std::move(rpcData));
-        }
-        
-        operation->initiate(opStore.get());
-
-        if (opStore) {
-            opStore->clearBuffer();
-        }
-    } else {
-        MO_DBG_ERR("Missing operation instance");
-    }
-}
-
-bool Request::restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *model) {
-    if (!opStorage) {
-        MO_DBG_ERR("invalid argument");
-        return false;
-    }
-
-    opStore = std::move(opStorage);
-
-    auto rpcData = opStore->getRpcData();
-    if (!rpcData) {
-        MO_DBG_ERR("corrupted storage");
-        return false;
-    }
-
-    messageID = (*rpcData)[1] | std::string();
-    std::string opType = (*rpcData)[2] | std::string();
-    if (messageID.empty() || opType.empty()) {
-        MO_DBG_ERR("corrupted storage");
-        messageID.clear();
-        return false;
-    }
-
-    int parsedMessageID = -1;
-    if (sscanf(messageID.c_str(), "%d", &parsedMessageID) == 1) {
-        if (parsedMessageID > unique_id_counter) {
-            MO_DBG_DEBUG("restore unique_id_counter with %d", parsedMessageID);
-            unique_id_counter = parsedMessageID + 1; //next unique value is parsedId + 1
-        }
-    } else {
-        MO_DBG_ERR("cannot set unique msgID counter");
-        //skip this step but don't abort restore
+        response.add(MESSAGE_TYPE_CALLERROR);   //MessageType
+        response.add(messageID.c_str());            //Unique message ID
+        response.add(errorCode);
+        response.add(errorDescription);
+        response.add(*errorDetails);              //Error description
     }
 
-    timeout_period = 0; //disable timeout by default for restored msgs
-
-    if (!strcmp(opType.c_str(), "StartTransaction") && model) { //TODO this will get a nicer solution
-        operation = std::unique_ptr<Operation>(new Ocpp16::StartTransaction(*model, nullptr));
-    } else if (!strcmp(opType.c_str(), "StopTransaction") && model) {
-        operation = std::unique_ptr<Operation>(new Ocpp16::StopTransaction(*model, nullptr));
-    }
-
-    if (!operation) {
-        MO_DBG_ERR("cannot create msg");
-        return false;
-    }
-
-    bool success = operation->restore(opStore.get());
-    opStore->clearBuffer();
-
-    if (success) {
-        MO_DBG_DEBUG("restored opNr %i: %s", opStore->getOpNr(), operation->getOperationType());
-    } else {
-        MO_DBG_ERR("restore opNr %i error", opStore->getOpNr());
-    }
-
-    return success;
+    return CreateResponseResult::Success;
 }
 
 void Request::setOnReceiveConfListener(OnReceiveConfListener onReceiveConf){
@@ -376,3 +278,11 @@ void Request::setOnAbortListener(OnAbortListener onAbort) {
 const char *Request::getOperationType() {
     return operation ? operation->getOperationType() : "UNDEFINED";
 }
+
+void Request::setRequestSent() {
+    requestSent = true;
+}
+
+bool Request::isRequestSent() {
+    return requestSent;
+}
diff --git a/src/MicroOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
index ebdeac30..300d0d79 100644
--- a/src/MicroOcpp/Core/Request.h
+++ b/src/MicroOcpp/Core/Request.h
@@ -17,13 +17,12 @@ namespace MicroOcpp {
 
 class Operation;
 class Model;
-class StoredOperationHandler;
 
 class Request {
 private:
     std::string messageID {};
     std::unique_ptr<Operation> operation;
-    void setMessageID(const std::string &id);
+    void setMessageID(const char *id);
     OnReceiveConfListener onReceiveConfListener = [] (JsonObject payload) {};
     OnReceiveReqListener onReceiveReqListener = [] (JsonObject payload) {};
     OnSendConfListener onSendConfListener = [] (JsonObject payload) {};
@@ -34,28 +33,22 @@ class Request {
     unsigned long timeout_start = 0;
     unsigned long timeout_period = 40000;
     bool timed_out = false;
-
-    unsigned int trialNo = 0;
     
     unsigned long debugRequest_start = 0;
 
-    std::unique_ptr<StoredOperationHandler> opStore;
+    bool requestSent = false;
 public:
 
     Request(std::unique_ptr<Operation> msg);
 
-    Request();
-
     ~Request();
 
-    void setOperation(std::unique_ptr<Operation> msg);
     Operation *getOperation();
 
     void setTimeout(unsigned long timeout); //0 = disable timeout
     bool isTimeoutExceeded();
-    void executeTimeout(); //call Timeout handler
-
-    unsigned int getTrialNo(); //how many times createRequest() has been tried (used for retry behavior)
+    void executeTimeout(); //call Timeout Listener
+    void setOnTimeoutListener(OnTimeoutListener onTimeout);
 
     /**
      * Sends the message(s) that belong to the OCPP Operation. This function puts a JSON message on the lower protocol layer.
@@ -65,7 +58,11 @@ class Request {
      * This function is usually called multiple times by the Arduino loop(). On first call, the request is initially sent. In the
      * succeeding calls, the implementers decide to either resend the request, or do nothing as the operation is still pending.
      */
-    std::unique_ptr<DynamicJsonDocument> createRequest();
+    enum class CreateRequestResult {
+        Success,
+        Failure
+    };
+    CreateRequestResult createRequest(DynamicJsonDocument& out);
 
    /**
     * Decides if message belongs to this operation instance and if yes, proccesses it. Receives both Confirmations and Errors
@@ -86,24 +83,17 @@ class Request {
      * message. Returns true on success, false otherwise. Returns also true if a CallError has successfully
      * been sent
      */
-    std::unique_ptr<DynamicJsonDocument> createResponse();
+    enum class CreateResponseResult {
+        Success,
+        Pending,
+        Failure
+    };
 
-    void initiate(std::unique_ptr<StoredOperationHandler> opStorage);
+    CreateResponseResult createResponse(DynamicJsonDocument& out);
 
-    bool restore(std::unique_ptr<StoredOperationHandler> opStorage, Model *model);
-
-    StoredOperationHandler *getStorageHandler() {return opStore.get();}
-
-    void setOnReceiveConfListener(OnReceiveConfListener onReceiveConf);
-
-    /**
-     * Sets a Listener that is called after this machine processed a request by the communication counterpart
-     */
-    void setOnReceiveReqListener(OnReceiveReqListener onReceiveReq);
-
-    void setOnSendConfListener(OnSendConfListener onSendConf);
-
-    void setOnTimeoutListener(OnTimeoutListener onTimeout);
+    void setOnReceiveConfListener(OnReceiveConfListener onReceiveConf); //listener executed when we received the .conf() to a .req() we sent
+    void setOnReceiveReqListener(OnReceiveReqListener onReceiveReq); //listener executed when we receive a .req()
+    void setOnSendConfListener(OnSendConfListener onSendConf); //listener executed when we send a .conf() to a .req() we received
 
     void setOnReceiveErrorListener(OnReceiveErrorListener onReceiveError);
 
@@ -120,8 +110,10 @@ class Request {
      */
     void setOnAbortListener(OnAbortListener onAbort);
 
-    const char *getMessageID();
     const char *getOperationType();
+
+    void setRequestSent();
+    bool isRequestSent();
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index b5ca5049..8f8cc3cb 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -2,12 +2,13 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <limits>
+
 #include <MicroOcpp/Core/RequestQueue.h>
 #include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Core/OcppError.h>
-#include <MicroOcpp/Core/RequestStore.h>
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Operations/StatusNotification.h>
 
@@ -17,135 +18,238 @@ size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_siz
 
 using namespace MicroOcpp;
 
-RequestQueue::RequestQueue(OperationRegistry& operationRegistry, Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
-            : operationRegistry(operationRegistry) {
-    
-    if (filesystem) {
-        initiatedRequests.reset(new PersistentRequestQueue(baseModel, filesystem));
-    } else {
-        initiatedRequests.reset(new VolatileRequestQueue());
+VolatileRequestQueue::VolatileRequestQueue(unsigned int priority) : priority{priority} {
+
+}
+
+VolatileRequestQueue::~VolatileRequestQueue() = default;
+
+void VolatileRequestQueue::loop() {
+
+    /*
+     * Drop timed out operations
+     */
+    size_t i = 0;
+    while (i < len) {
+        size_t index = (front + i) % MO_REQUEST_CACHE_MAXSIZE;
+        auto& request = requests[index];
+
+        if (request->isTimeoutExceeded()) {
+            MO_DBG_INFO("operation timeout: %s", request->getOperationType());
+            request->executeTimeout();
+
+            if (index == front) {
+                requests[front].reset();
+                front = (front + 1) % MO_REQUEST_CACHE_MAXSIZE;
+                len--;
+            } else {
+                requests[index].reset();
+                for (size_t i = (index + MO_REQUEST_CACHE_MAXSIZE - front) % MO_REQUEST_CACHE_MAXSIZE; i < len - 1; i++) {
+                    requests[(front + i) % MO_REQUEST_CACHE_MAXSIZE] = std::move(requests[(front + i + 1) % MO_REQUEST_CACHE_MAXSIZE]);
+                }
+                len--;
+            }
+        } else {
+            i++;
+        }
+    }
+}
+
+unsigned int VolatileRequestQueue::getFrontRequestOpNr() {
+    if (len == 0) {
+        return NoOperation;
+    }
+
+    return priority;
+}
+
+std::unique_ptr<Request> VolatileRequestQueue::fetchFrontRequest() {
+    if (len == 0) {
+        return nullptr;
+    }
+
+    std::unique_ptr<Request> result = std::move(requests[front]);
+    front = (front + 1) % MO_REQUEST_CACHE_MAXSIZE;
+    len--;
+
+    MO_DBG_VERBOSE("front %zu len %zu", front, len);
+
+    return result;
+}
+
+bool VolatileRequestQueue::pushRequestBack(std::unique_ptr<Request> request) {
+
+    // Don't queue up multiple StatusNotification messages for the same connectorId
+    if (strcmp(request->getOperationType(), "StatusNotification") == 0)
+    {
+        size_t i = 0;
+        while (i < len) {
+            size_t index = (front + i) % MO_REQUEST_CACHE_MAXSIZE;
+
+            if (strcmp(requests[index]->getOperationType(), "StatusNotification")!= 0)
+            {
+                i++;
+                continue;
+            }
+            auto new_status_notification = static_cast<Ocpp16::StatusNotification*>(request->getOperation());
+            auto old_status_notification = static_cast<Ocpp16::StatusNotification*>(requests[index]->getOperation());
+            if (old_status_notification->getConnectorId() == new_status_notification->getConnectorId()) {
+                requests[index].reset();
+                for (size_t i = (index + MO_REQUEST_CACHE_MAXSIZE - front) % MO_REQUEST_CACHE_MAXSIZE; i < len - 1; i++) {
+                    requests[(front + i) % MO_REQUEST_CACHE_MAXSIZE] = std::move(requests[(front + i + 1) % MO_REQUEST_CACHE_MAXSIZE]);
+                }
+                len--;
+            } else {
+                i++;
+            }
+        }
+    }
+
+    if (len >= MO_REQUEST_CACHE_MAXSIZE) {
+        MO_DBG_INFO("Drop cached operation (cache full): %s", requests[front]->getOperationType());
+        requests[front]->executeTimeout();
+        requests[front].reset();
+        front = (front + 1) % MO_REQUEST_CACHE_MAXSIZE;
+        len--;
     }
+
+    requests[(front + len) % MO_REQUEST_CACHE_MAXSIZE] = std::move(request);
+    len++;
+    return true;
 }
 
-void RequestQueue::setConnection(Connection& sock) {
+RequestQueue::RequestQueue(Connection& connection, OperationRegistry& operationRegistry)
+            : connection(connection), operationRegistry(operationRegistry) {
+
     ReceiveTXTcallback callback = [this] (const char *payload, size_t length) {
         return this->receiveMessage(payload, length);
     };
     
-    sock.setReceiveTXTcallback(callback);
+    connection.setReceiveTXTcallback(callback);
+
+    memset(sendQueues, 0, sizeof(sendQueues));
+    addSendQueue(&defaultSendQueue);
+    addSendQueue(&preBootSendQueue);
 }
 
-void RequestQueue::loop(Connection& ocppSock) {
+void RequestQueue::loop() {
 
     /*
-     * Sort out timed out operations
+     * Check if front request timed out
      */
-    initiatedRequests->drop_if([] (std::unique_ptr<Request>& op) -> bool {
-        bool timed_out = op->isTimeoutExceeded();
-        if (timed_out) {
-            MO_DBG_INFO("operation timeout: %s", op->getOperationType());
-            op->executeTimeout();
-        }
-        return timed_out;
-    });
+    if (sendReqFront && sendReqFront->isTimeoutExceeded()) {
+        MO_DBG_INFO("operation timeout: %s", sendReqFront->getOperationType());
+        sendReqFront->executeTimeout();
+        sendReqFront.reset();
+    }
+
+    if (recvReqFront && recvReqFront->isTimeoutExceeded()) {
+        MO_DBG_INFO("operation timeout: %s", recvReqFront->getOperationType());
+        recvReqFront->executeTimeout();
+        recvReqFront.reset();
+    }
+
+    defaultSendQueue.loop();
+    preBootSendQueue.loop();
+
+    if (!connection.isConnected()) {
+        return;
+    }
 
     /**
-     * Send and dequeue a pending confirmation message, if existing. If the first operation is awaiting,
-     * try with the subsequent operations.
+     * Send and dequeue a pending confirmation message, if existing
      * 
      * If a message has been sent, terminate this loop() function.
      */
-    for (auto received = receivedRequests.begin(); received != receivedRequests.end(); ++received) {
-    
-        auto response = (*received)->createResponse();
 
-        if (response) {
+    if (!recvReqFront) {
+        recvReqFront = recvQueue.fetchFrontRequest();
+    }
+
+    if (recvReqFront) {
+
+        DynamicJsonDocument response {0};
+        auto ret = recvReqFront->createResponse(response);
+
+        if (ret == Request::CreateResponseResult::Success) {
             std::string out;
-            serializeJson(*response, out);
+            serializeJson(response, out);
     
-            bool success = ocppSock.sendTXT(out.c_str(), out.length());
+            bool success = connection.sendTXT(out.c_str(), out.length());
 
             if (success) {
                 MO_DBG_TRAFFIC_OUT(out.c_str());
-                receivedRequests.erase(received);
+                recvReqFront.reset();
             }
 
             return;
-        } //else: There will be another attempt to send this conf message in a future loop call.
-          //      Go on with the next element in the queue.
+        } //else: There will be another attempt to send this conf message in a future loop call
     }
 
     /**
      * Send pending req message
      */
-    auto initedOp = initiatedRequests->front();
-
-    if (!initedOp) {
-        //queue empty
-        return;
-    }
 
-    //check backoff time
+    if (!sendReqFront) {
 
-    if (initedOp->getTrialNo() == 0) {
-        //first trial -> send immediately
-        sendBackoffPeriod = 0;
-    }
+        unsigned int minOpNr = RequestEmitter::NoOperation;
+        size_t index = MO_NUM_REQUEST_QUEUES;
+        for (size_t i = 0; i < MO_NUM_REQUEST_QUEUES && sendQueues[i]; i++) {
+            auto opNr = sendQueues[i]->getFrontRequestOpNr();
+            if (opNr < minOpNr) {
+                minOpNr = opNr;
+                index = i;
+            }
+        }
 
-    if (sockTrackLastConnected != ocppSock.getLastConnected()) {
-        //connection active (again) -> send immediately
-        sendBackoffPeriod = std::min(sendBackoffPeriod, 1000UL);
+        if (index < MO_NUM_REQUEST_QUEUES) {
+            sendReqFront = sendQueues[index]->fetchFrontRequest();
+        }
     }
-    sockTrackLastConnected = ocppSock.getLastConnected();
 
-    if (mocpp_tick_ms() - sendBackoffTime < sendBackoffPeriod) {
-        //still in backoff period
-        return;
-    }
+    if (sendReqFront && !sendReqFront->isRequestSent()) {
 
-    auto request = initedOp->createRequest();
+        DynamicJsonDocument request {0};
+        auto ret = sendReqFront->createRequest(request);
 
-    if (!request) {
-        //request not ready yet or OOM
-        return;
-    }
+        if (ret == Request::CreateRequestResult::Success) {
 
-    //send request
-    std::string out;
-    serializeJson(*request, out);
+            //send request
+            std::string out;
+            serializeJson(request, out);
 
-    bool success = ocppSock.sendTXT(out.c_str(), out.length());
+            bool success = connection.sendTXT(out.c_str(), out.length());
 
-    if (success) {
-        MO_DBG_TRAFFIC_OUT(out.c_str());
+            if (success) {
+                MO_DBG_TRAFFIC_OUT(out.c_str());
+                sendReqFront->setRequestSent(); //mask as sent and wait for response / timeout
+            }
 
-        //update backoff time
-        sendBackoffTime = mocpp_tick_ms();
-        sendBackoffPeriod = std::min(sendBackoffPeriod + BACKOFF_PERIOD_INCREMENT, BACKOFF_PERIOD_MAX);
+            return;
+        }
     }
 }
 
 void RequestQueue::sendRequest(std::unique_ptr<Request> op){
-    if (!op) {
-        MO_DBG_ERR("Called with null. Ignore");
-        return;
-    }
+    defaultSendQueue.pushRequestBack(std::move(op));
+}
 
-    // Don't queue up multiple StatusNotification messages for the same connectorId
-    if (strcmp(op->getOperationType(), "StatusNotification") == 0)
-    {
-        auto new_status_notification = static_cast<Ocpp16::StatusNotification*>(op->getOperation());
-        initiatedRequests->drop_if([&new_status_notification] (const std::unique_ptr<Request>& operation) {
-            if (strcmp(operation->getOperationType(), "StatusNotification")!= 0)
-            {
-                return false;
-            }
-            auto old_status_notification = static_cast<Ocpp16::StatusNotification*>(operation->getOperation());
-            return old_status_notification->getConnectorId() == new_status_notification->getConnectorId();
-        });
+void RequestQueue::sendRequestPreBoot(std::unique_ptr<Request> op){
+    preBootSendQueue.pushRequestBack(std::move(op));
+}
+
+void RequestQueue::addSendQueue(RequestEmitter* sendQueue) {
+    for (size_t i = 0; i < MO_NUM_REQUEST_QUEUES; i++) {
+        if (!sendQueues[i]) {
+            sendQueues[i] = sendQueue;
+            return;
+        }
     }
+    MO_DBG_ERR("exceeded sendQueue capacity");
+}
 
-    initiatedRequests->push_back(std::move(op));
+unsigned int RequestQueue::getNextOpNr() {
+    return nextOpNr++;
 }
 
 bool RequestQueue::receiveMessage(const char* payload, size_t length) {
@@ -241,26 +345,11 @@ bool RequestQueue::receiveMessage(const char* payload, size_t length) {
  */
 void RequestQueue::receiveResponse(JsonArray json) {
 
-    bool success = false;
-
-    initiatedRequests->drop_if(
-        [&json, &success] (std::unique_ptr<Request>& operation) {
-            bool match = operation->receiveResponse(json);
-            if (match) {
-                success = true;
-                //operation will be deleted by the surrounding drop_if
-            }
-            return match;
-        }); //executes in order and drops every operation where predicate(op) == true
-
-    if (!success) {
-        //didn't find matching Request
-        if (json[0] == MESSAGE_TYPE_CALLERROR) {
-            MO_DBG_DEBUG("Received CALLERROR did not abort a pending operation");
-        } else {
-            MO_DBG_WARN("Received response doesn't match any pending operation");
-        }
+    if (!sendReqFront || !sendReqFront->receiveResponse(json)) {
+        MO_DBG_WARN("Received response doesn't match pending operation");
     }
+
+    sendReqFront.reset();
 }
 
 void RequestQueue::receiveRequest(JsonArray json) {
@@ -274,7 +363,7 @@ void RequestQueue::receiveRequest(JsonArray json) {
 
 void RequestQueue::receiveRequest(JsonArray json, std::unique_ptr<Request> op) {
     op->receiveRequest(json); //execute the operation
-    receivedRequests.push_back(std::move(op)); //enqueue so loop() plans conf sending
+    recvQueue.pushRequestBack(std::move(op)); //enqueue so loop() plans conf sending
 }
 
 /*
diff --git a/src/MicroOcpp/Core/RequestQueue.h b/src/MicroOcpp/Core/RequestQueue.h
index 1c1f576d..7eba5355 100644
--- a/src/MicroOcpp/Core/RequestQueue.h
+++ b/src/MicroOcpp/Core/RequestQueue.h
@@ -5,46 +5,87 @@
 #ifndef MO_REQUESTQUEUE_H
 #define MO_REQUESTQUEUE_H
 
-#include <MicroOcpp/Core/RequestQueueStorageStrategy.h>
+#include <limits>
+
+#include <MicroOcpp/Core/Connection.h>
 
-#include <deque>
 #include <memory>
 #include <ArduinoJson.h>
 
+#ifndef MO_REQUEST_CACHE_MAXSIZE
+#define MO_REQUEST_CACHE_MAXSIZE 10
+#endif
+
+#ifndef MO_NUM_REQUEST_QUEUES
+#define MO_NUM_REQUEST_QUEUES 5
+#endif
+
 namespace MicroOcpp {
 
-class OperationRegistry;
-class Model;
 class Connection;
+class OperationRegistry;
 class Request;
-class FilesystemAdapter;
+
+class RequestEmitter {
+public:
+    static const unsigned int NoOperation = std::numeric_limits<unsigned int>::max();
+
+    virtual unsigned int getFrontRequestOpNr() = 0; //return OpNr of front request or NoOperation if queue is empty
+    virtual std::unique_ptr<Request> fetchFrontRequest() = 0;
+};
+
+class VolatileRequestQueue : public RequestEmitter {
+private:
+    std::unique_ptr<Request> requests [MO_REQUEST_CACHE_MAXSIZE];
+    size_t front = 0, len = 0;
+    const unsigned int priority;
+public:
+    VolatileRequestQueue(unsigned int priority = 1);
+    ~VolatileRequestQueue();
+    void loop();
+
+    unsigned int getFrontRequestOpNr() override;
+    std::unique_ptr<Request> fetchFrontRequest() override;
+
+    bool pushRequestBack(std::unique_ptr<Request> request);
+};
 
 class RequestQueue {
 private:
+    Connection& connection;
     OperationRegistry& operationRegistry;
-    
-    std::unique_ptr<RequestQueueStorageStrategy> initiatedRequests;
-    std::deque<std::unique_ptr<Request>> receivedRequests;
 
+    RequestEmitter* sendQueues [MO_NUM_REQUEST_QUEUES];
+    VolatileRequestQueue defaultSendQueue {1};
+    VolatileRequestQueue preBootSendQueue {0};
+    std::unique_ptr<Request> sendReqFront;
+
+    VolatileRequestQueue recvQueue;
+    std::unique_ptr<Request> recvReqFront;
+
+    bool receiveMessage(const char* payload, size_t length); //receive from  server: either a request or response
     void receiveRequest(JsonArray json);
     void receiveRequest(JsonArray json, std::unique_ptr<Request> op);
     void receiveResponse(JsonArray json);
 
-    unsigned long sendBackoffTime = 0;
-    unsigned long sendBackoffPeriod = 0;
     unsigned long sockTrackLastConnected = 0;
-    const unsigned long BACKOFF_PERIOD_MAX = 1048576;
-    const unsigned long BACKOFF_PERIOD_INCREMENT = BACKOFF_PERIOD_MAX / 4;
+
+    unsigned int nextOpNr = 10; //Nr 0 - 9 reservered for internal purposes
 public:
-    RequestQueue(OperationRegistry& operationRegistry, Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem = nullptr);
+    RequestQueue() = delete;
+    RequestQueue(const RequestQueue&) = delete;
+    RequestQueue(const RequestQueue&&) = delete;
 
-    void setConnection(Connection& sock);
+    RequestQueue(Connection& connection, OperationRegistry& operationRegistry);
 
-    void loop(Connection& ocppSock);
+    void loop(); //polls all reqQueues and decides which request to send (if any)
 
-    void sendRequest(std::unique_ptr<Request> o); //send an OCPP operation request to the server
-    
-    bool receiveMessage(const char* payload, size_t length); //receive from  server: either a request or response
+    void sendRequest(std::unique_ptr<Request> request); //send an OCPP operation request to the server; adds request to default queue
+    void sendRequestPreBoot(std::unique_ptr<Request> request); //send an OCPP operation request to the server; adds request to preBootQueue
+
+    void addSendQueue(RequestEmitter* sendQueue);
+
+    unsigned int getNextOpNr();
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp b/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
deleted file mode 100644
index 26e24aaa..00000000
--- a/src/MicroOcpp/Core/RequestQueueStorageStrategy.cpp
+++ /dev/null
@@ -1,180 +0,0 @@
-// matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2024
-// MIT License
-
-#include <MicroOcpp/Core/RequestQueueStorageStrategy.h>
-#include <MicroOcpp/Core/RequestStore.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
-
-#include <MicroOcpp/Core/Request.h>
-#include <MicroOcpp/Core/FilesystemAdapter.h>
-#include <MicroOcpp/Debug.h>
-
-#include <algorithm>
-
-#define MO_OPERATIONCACHE_MAXSIZE 10
-
-using namespace MicroOcpp;
-
-VolatileRequestQueue::VolatileRequestQueue() {
-
-}
-
-VolatileRequestQueue::~VolatileRequestQueue() {
-
-}
-
-Request *VolatileRequestQueue::front() {
-    if (!queue.empty()) {
-        return queue.front().get();
-    } else {
-        return nullptr;
-    }
-}
-
-void VolatileRequestQueue::pop_front() {
-    queue.pop_front();
-}
-
-void VolatileRequestQueue::push_back(std::unique_ptr<Request> op) {
-
-    op->initiate(nullptr);
-
-    if (queue.size() >= MO_OPERATIONCACHE_MAXSIZE) {
-        MO_DBG_WARN("unsafe number of cached operations");
-    }
-
-    queue.push_back(std::move(op));
-}
-
-void VolatileRequestQueue::drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) {
-    queue.erase(std::remove_if(queue.begin(), queue.end(), pred), queue.end());
-}
-
-PersistentRequestQueue::PersistentRequestQueue(Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem)
-            : opStore(filesystem), baseModel(baseModel) { }
-
-PersistentRequestQueue::~PersistentRequestQueue() {
-
-}
-
-void PersistentRequestQueue::pop_front() {
-    
-    if (head && head->getStorageHandler() && head->getStorageHandler()->getOpNr() >= 0) {
-        opStore.advanceOpNr(head->getStorageHandler()->getOpNr());
-        MO_DBG_DEBUG("advanced %i to %u", head->getStorageHandler()->getOpNr(), opStore.getOpBegin());
-    }
-
-    head.reset();
-}
-
-Request *PersistentRequestQueue::front() {
-
-    if (head) {
-        // head still loaded
-        return head.get();
-    }
-
-    // check if there are any more operations
-    if (tailCache.empty() && opStore.getOpBegin() == opStore.getOpEnd()) {
-        // no more operations
-        return nullptr;
-    }
-
-    unsigned int nextOpNr = opStore.getOpBegin();
-
-    /*
-     * Find next operation to take as front. Two cases:
-     * A) [front, tailCache] contains all operations stored on this device
-     * B) [front, tailCache] does not contain all operations. The next operation after front is not present
-     *                       in the cache. Fetch the next operation from the flash to front
-     */
-
-    auto found = std::find_if(tailCache.begin(), tailCache.end(),
-        [nextOpNr] (std::unique_ptr<Request>& op) {
-            return op->getStorageHandler() &&
-                   op->getStorageHandler()->getOpNr() >= 0 &&
-                   (unsigned int) op->getStorageHandler()->getOpNr() == nextOpNr;
-    });
-
-    if (found != tailCache.end()) {
-        //cache hit -> case A) -> don't load from flash but just take the next element from tail
-        head = std::move(tailCache.front());
-        tailCache.pop_front();
-    } else {
-        //cache miss -> case B) or A) -> try to fetch operation from flash (check for case B)) or take first cached element as front
-        
-        std::unique_ptr<Request> fetched;
-
-        unsigned int range = (opStore.getOpEnd() + MO_MAX_OPNR - nextOpNr) % MO_MAX_OPNR;
-        for (size_t i = 0; i < range; i++) {
-            auto storageHandler = opStore.makeOpHandler();
-            bool exists = storageHandler->restore(nextOpNr);
-            if (exists) {
-                //case B) -> load operation from flash and take it as front element
-
-                fetched = makeRequest();
-
-                bool success = fetched->restore(std::move(storageHandler), baseModel);
-
-                if (success) {
-                    //loaded operation from flash and will place it at head position of the queue
-                    break;
-                }
-
-                MO_DBG_ERR("could not restore operation");
-                fetched.reset();
-                opStore.advanceOpNr(nextOpNr);
-                nextOpNr = opStore.getOpBegin();
-            } else {
-                //didn't find anything at this slot. Try next slot
-                nextOpNr++;
-                nextOpNr %= MO_MAX_OPNR;
-            }
-        }
-
-        if (fetched) {
-            //found operation in flash -> case B)
-            head = std::move(fetched);
-            MO_DBG_DEBUG("restored operation from flash");
-        } else {
-            //no operation anymore in flash -> case A) -> take next queued operation in tailCache
-            if (tailCache.empty()) {
-                //no operations anymore
-            } else {
-                head = std::move(tailCache.front());
-                tailCache.pop_front();
-            }
-        }
-    }
-
-    MO_DBG_VERBOSE("reloaded head");
-
-    if (!head) {
-        MO_DBG_VERBOSE("illegal state");
-    }
-
-    return head.get();
-}
-
-void PersistentRequestQueue::push_back(std::unique_ptr<Request> op) {
-
-    op->initiate(opStore.makeOpHandler());
-
-    if (tailCache.size() >= MO_OPERATIONCACHE_MAXSIZE) {
-        MO_DBG_INFO("Replace cached operation (cache full): %s", tailCache.front()->getOperationType());
-        tailCache.front()->executeTimeout();
-        tailCache.pop_front();
-    }
-
-    tailCache.push_back(std::move(op));
-}
-
-void PersistentRequestQueue::drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) {
-
-    while (head && pred(head)) {
-        pop_front();
-    }
-
-    tailCache.erase(std::remove_if(tailCache.begin(), tailCache.end(), pred), tailCache.end());
-}
diff --git a/src/MicroOcpp/Core/RequestQueueStorageStrategy.h b/src/MicroOcpp/Core/RequestQueueStorageStrategy.h
deleted file mode 100644
index 458b00d0..00000000
--- a/src/MicroOcpp/Core/RequestQueueStorageStrategy.h
+++ /dev/null
@@ -1,70 +0,0 @@
-// matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2024
-// MIT License
-
-#ifndef MO_REQUESTQUEUESTORAGESTRATEGY_H
-#define MO_REQUESTQUEUESTORAGESTRATEGY_H
-
-#include <MicroOcpp/Core/RequestStore.h>
-
-#include <memory>
-#include <deque>
-#include <functional>
-
-namespace MicroOcpp {
-
-class FilesystemAdapter;
-class Request;
-class Model;
-
-class RequestQueueStorageStrategy {
-public:
-    virtual ~RequestQueueStorageStrategy() = default;
-
-    virtual Request *front() = 0;
-    virtual void pop_front() = 0;
-
-    virtual void push_back(std::unique_ptr<Request> op) = 0;
-
-    virtual void drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) = 0; //drops operations from this queue where pred(operation) == true. Executes pred in order
-};
-
-class VolatileRequestQueue : public RequestQueueStorageStrategy {
-private:
-    std::deque<std::unique_ptr<Request>> queue;
-public:
-    VolatileRequestQueue();
-    ~VolatileRequestQueue();
-
-    Request *front() override;
-    void pop_front() override;
-
-    void push_back(std::unique_ptr<Request> op) override;
-
-    void drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
-};
-
-class PersistentRequestQueue : public RequestQueueStorageStrategy {
-private:
-    RequestStore opStore;
-    Model *baseModel;
-
-    std::unique_ptr<Request> head;
-    std::deque<std::unique_ptr<Request>> tailCache;
-public:
-
-    PersistentRequestQueue(Model *baseModel, std::shared_ptr<FilesystemAdapter> filesystem);
-    ~PersistentRequestQueue();
-
-    Request *front() override;
-    void pop_front() override;
-
-    void push_back(std::unique_ptr<Request> op) override;
-
-    void drop_if(std::function<bool(std::unique_ptr<Request>&)> pred) override; //drops operations from this queue where pred(operation) == true. Executes pred in order
-
-};
-
-}
-
-#endif
diff --git a/src/MicroOcpp/Core/RequestStore.cpp b/src/MicroOcpp/Core/RequestStore.cpp
deleted file mode 100644
index 601eb34b..00000000
--- a/src/MicroOcpp/Core/RequestStore.cpp
+++ /dev/null
@@ -1,203 +0,0 @@
-// matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2024
-// MIT License
-
-#include <MicroOcpp/Core/RequestStore.h>
-#include <MicroOcpp/Core/FilesystemAdapter.h>
-#include <MicroOcpp/Core/FilesystemUtils.h>
-#include <MicroOcpp/Core/Configuration.h>
-#include <MicroOcpp/Debug.h>
-
-#define MO_OPSTORE_FN MO_FILENAME_PREFIX "opstore.jsn"
-
-#define MO_OPHISTORY_SIZE 3
-
-using namespace MicroOcpp;
-
-bool StoredOperationHandler::commit() {
-    if (isPersistent) {
-        MO_DBG_ERR("cannot call two times");
-        return false;
-    }
-    if (!filesystem) {
-        MO_DBG_DEBUG("filesystem");
-        return false;
-    }
-
-    if (!rpc || !payload) {
-        MO_DBG_ERR("unitialized");
-        return false;
-    }
-
-    opNr = context.reserveOpNr();
-
-    char fn [MO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "op" "-%u.jsn", opNr);
-    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
-        MO_DBG_ERR("fn error: %i", ret);
-        return false;
-    }
-
-    DynamicJsonDocument doc {JSON_OBJECT_SIZE(2) + rpc->capacity() + payload->capacity()};
-    doc["rpc"] = *rpc;
-    doc["payload"] = *payload;
-
-    if (!FilesystemUtils::storeJson(filesystem, fn, doc)) {
-        MO_DBG_ERR("FS error");
-        return false;
-    }
-
-    isPersistent = true;
-    return true;
-}
-
-bool StoredOperationHandler::restore(unsigned int opNrToLoad) {
-    if (isPersistent) {
-        MO_DBG_ERR("cannot restore after commit");
-        return false;
-    }
-    if (!filesystem) {
-        MO_DBG_DEBUG("filesystem");
-        return false;
-    }
-
-    opNr = opNrToLoad;
-
-    char fn [MO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "op" "-%u.jsn", opNr);
-    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
-        MO_DBG_ERR("fn error: %i", ret);
-        return false;
-    }
-
-    size_t msize;
-    if (filesystem->stat(fn, &msize) != 0) {
-        MO_DBG_VERBOSE("operation %u does not exist", opNr);
-        return false;
-    }
-
-    auto doc = FilesystemUtils::loadJson(filesystem, fn);
-    if (!doc) {
-        MO_DBG_ERR("FS error");
-        return false;
-    }
-    
-    JsonVariant rpc_restore = (*doc)["rpc"];
-    JsonVariant payload_restore = (*doc)["payload"];
-
-    rpc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(rpc_restore.memoryUsage()));
-    payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(payload_restore.memoryUsage()));
-    
-    *rpc = rpc_restore;
-    *payload = payload_restore;
-
-    isPersistent = true;
-    return true;
-}
-
-RequestStore::RequestStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
-    opBeginInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "opBegin", 0, MO_OPSTORE_FN, false, false, false);
-    configuration_load(MO_OPSTORE_FN);
-
-    if (!opBeginInt || opBeginInt->getInt() < 0) {
-        MO_DBG_ERR("init failure");
-    } else if (filesystem) {
-        opEnd = opBeginInt->getInt();
-
-        unsigned int misses = 0;
-        unsigned int i = opEnd;
-        while (misses < 3) {
-            char fn [MO_MAX_PATH_SIZE] = {'\0'};
-            auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "op" "-%u.jsn", i);
-            if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
-                MO_DBG_ERR("fn error: %i", ret);
-                misses++;
-                i = (i + 1) % MO_MAX_OPNR;
-                continue;
-            }
-
-            size_t msize;
-            if (filesystem->stat(fn, &msize) != 0) {
-                MO_DBG_DEBUG("operation %u does not exist", i);
-                misses++;
-                i = (i + 1) % MO_MAX_OPNR;
-                continue;
-            }
-
-            //file exists
-            misses = 0;
-            i = (i + 1) % MO_MAX_OPNR;
-            opEnd = i;
-        }
-    }
-}
-
-std::unique_ptr<StoredOperationHandler> RequestStore::makeOpHandler() {
-    return std::unique_ptr<StoredOperationHandler>(new StoredOperationHandler(*this, filesystem));
-}
-
-unsigned int RequestStore::reserveOpNr() {
-    MO_DBG_DEBUG("reserved opNr %u", opEnd);
-    auto res = opEnd;
-    opEnd++;
-    opEnd %= MO_MAX_OPNR;
-    return res;
-}
-
-void RequestStore::advanceOpNr(unsigned int oldOpNr) {
-    if (!opBeginInt || opBeginInt->getInt() < 0) {
-        MO_DBG_ERR("init failure");
-        return;
-    }
-
-    if (oldOpNr != (unsigned int) opBeginInt->getInt()) {
-        if ((oldOpNr + MO_MAX_OPNR - (unsigned int) opBeginInt->getInt()) % MO_MAX_OPNR < 100) {
-            MO_DBG_ERR("synchronization failure - try to fix");
-        } else {
-            MO_DBG_ERR("synchronization failure");
-            return;
-        }
-    }
-
-    unsigned int opNr = (oldOpNr + 1) % MO_MAX_OPNR;
-
-    //delete range [opBeginInt->getInt() ... opNr)
-
-    unsigned int rangeSize = (opNr + MO_MAX_OPNR - (unsigned int) opBeginInt->getInt()) % MO_MAX_OPNR;
-
-    MO_DBG_DEBUG("delete %u operations", rangeSize);
-
-    for (unsigned int i = 0; i < rangeSize; i++) {
-        unsigned int op = ((unsigned int) opBeginInt->getInt() + i + MO_MAX_OPNR - MO_OPHISTORY_SIZE) % MO_MAX_OPNR;
-
-        char fn [MO_MAX_PATH_SIZE] = {'\0'};
-        auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "op" "-%u.jsn", op);
-        if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
-            MO_DBG_ERR("fn error: %i", ret);
-            break;
-        }
-
-        size_t msize;
-        if (filesystem->stat(fn, &msize) != 0) {
-            MO_DBG_DEBUG("operation %u does not exist", i);
-            continue;
-        }
-
-        bool success = filesystem->remove(fn);
-        if (!success) {
-            MO_DBG_ERR("error deleting %s", fn);
-        }
-    }
-
-    MO_DBG_DEBUG("advance opBegin: %u", opNr);
-    opBeginInt->setInt(opNr);
-    configuration_save();
-}
-
-unsigned int RequestStore::getOpBegin() {
-    if (!opBeginInt || opBeginInt->getInt() < 0) {
-        MO_DBG_ERR("invalid state");
-        return 0;
-    }
-    return (unsigned int) opBeginInt->getInt();
-}
diff --git a/src/MicroOcpp/Core/RequestStore.h b/src/MicroOcpp/Core/RequestStore.h
deleted file mode 100644
index b31f0cd5..00000000
--- a/src/MicroOcpp/Core/RequestStore.h
+++ /dev/null
@@ -1,70 +0,0 @@
-// matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2024
-// MIT License
-
-#ifndef MO_REQUESTSTORE_H
-#define MO_REQUESTSTORE_H
-
-#include <memory>
-#include <deque>
-#include <ArduinoJson.h>
-
-#define MO_MAX_OPNR 10000
-
-namespace MicroOcpp {
-
-class RequestStore;
-class FilesystemAdapter;
-class Configuration;
-
-class StoredOperationHandler {
-private:
-    RequestStore& context;
-    int opNr = -1;
-    std::shared_ptr<FilesystemAdapter> filesystem;
-
-    std::unique_ptr<DynamicJsonDocument> rpc;
-    std::unique_ptr<DynamicJsonDocument> payload;
-
-    bool isPersistent = false;
-
-public:
-    StoredOperationHandler(RequestStore& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {}
-
-    void setRpcData(std::unique_ptr<DynamicJsonDocument> rpc) {this->rpc = std::move(rpc);}
-    void setPayload(std::unique_ptr<DynamicJsonDocument> payload) {this->payload = std::move(payload);}
-
-    std::unique_ptr<DynamicJsonDocument> getRpcData() {return std::move(rpc);}
-    std::unique_ptr<DynamicJsonDocument> getPayload() {return std::move(payload);}
-
-    bool commit();
-    void clearBuffer() {rpc.reset(); payload.reset();}
-
-    bool restore(unsigned int opNr);
-
-    int getOpNr() {return isPersistent ? opNr : -1;}
-};
-
-class RequestStore {
-private:
-    std::shared_ptr<FilesystemAdapter> filesystem;
-    std::shared_ptr<Configuration> opBeginInt; //Tx-related operations are stored; index of the first pending operation
-    unsigned int opEnd = 0; //one place after last number
-
-public:
-    RequestStore() = delete;
-    RequestStore(std::shared_ptr<FilesystemAdapter> filesystem);
-
-    std::unique_ptr<StoredOperationHandler> makeOpHandler();
-    std::unique_ptr<StoredOperationHandler> fetchOpHandler(unsigned int opNr);
-
-    unsigned int reserveOpNr();
-    void advanceOpNr(unsigned int oldOpNr);
-
-    unsigned int getOpBegin();
-    unsigned int getOpEnd() {return opEnd;}
-};
-
-}
-
-#endif
diff --git a/src/MicroOcpp/Core/SimpleRequestFactory.cpp b/src/MicroOcpp/Core/SimpleRequestFactory.cpp
index 1fa5bd5b..dc0f38c2 100644
--- a/src/MicroOcpp/Core/SimpleRequestFactory.cpp
+++ b/src/MicroOcpp/Core/SimpleRequestFactory.cpp
@@ -11,18 +11,11 @@ std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> operation){
     if (operation == nullptr) {
         return nullptr;
     }
-    auto request = makeRequest();
-    request->setOperation(std::move(operation));
-    return request;
+    return std::unique_ptr<Request>(new Request(std::move(operation)));
 }
 
 std::unique_ptr<Request> makeRequest(Operation *operation) {
     return makeRequest(std::unique_ptr<Operation>(operation));
 }
 
-std::unique_ptr<Request> makeRequest(){
-    auto result = std::unique_ptr<Request>(new Request());
-    return result;
-}
-
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/SimpleRequestFactory.h b/src/MicroOcpp/Core/SimpleRequestFactory.h
index 20f84727..45c7e0a0 100644
--- a/src/MicroOcpp/Core/SimpleRequestFactory.h
+++ b/src/MicroOcpp/Core/SimpleRequestFactory.h
@@ -5,17 +5,14 @@
 #ifndef MO_SIMPLEREQUESTFACTORY_H
 #define MO_SIMPLEREQUESTFACTORY_H
 
-#include <ArduinoJson.h>
-#include <MicroOcpp/Core/Request.h>
 #include <memory>
-#include <functional>
+
+#include <MicroOcpp/Core/Request.h>
 
 namespace MicroOcpp {
 
 class Operation;
 
-std::unique_ptr<Request> makeRequest();
-
 std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> op);
 std::unique_ptr<Request> makeRequest(Operation *op); //takes ownership of op
 
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index cd89ca66..bf485ad3 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -63,11 +63,6 @@ void BootService::loop() {
         storeBootStats(filesystem, bootstats);
     }
 
-    if (!activatedPostBootCommunication && status == RegistrationStatus::Accepted) {
-        context.activatePostBootCommunication();
-        activatedPostBootCommunication = true;
-    }
-
     if (!activatedModel && (status == RegistrationStatus::Accepted || preBootTransactionsBool->getBool())) {
         context.getModel().activateTasks();
         activatedModel = true;
@@ -87,7 +82,7 @@ void BootService::loop() {
      */
     auto bootNotification = makeRequest(new Ocpp16::BootNotification(context.getModel(), getChargePointCredentials()));
     bootNotification->setTimeout(interval_s * 1000UL);
-    context.initiatePreBootOperation(std::move(bootNotification));
+    context.getRequestQueue().sendRequestPreBoot(std::move(bootNotification));
 
     lastBootNotification = mocpp_tick_ms();
 }
diff --git a/src/MicroOcpp/Model/Boot/BootService.h b/src/MicroOcpp/Model/Boot/BootService.h
index 263e7055..e00559bd 100644
--- a/src/MicroOcpp/Model/Boot/BootService.h
+++ b/src/MicroOcpp/Model/Boot/BootService.h
@@ -48,7 +48,6 @@ class BootService {
     std::shared_ptr<Configuration> preBootTransactionsBool;
 
     bool activatedModel = false;
-    bool activatedPostBootCommunication = false;
 
     unsigned long firstExecutionTimestamp = 0;
     bool executedFirstTime = false;
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 5fc1175b..db137d26 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -33,8 +33,10 @@
 
 using namespace MicroOcpp;
 
-Connector::Connector(Context& context, int connectorId)
-        : context(context), model(context.getModel()), connectorId{connectorId} {
+Connector::Connector(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId)
+        : context(context), model(context.getModel()), filesystem(filesystem), connectorId(connectorId) {
+
+    context.getRequestQueue().addSendQueue(this); //register at RequestQueue as Request emitter
 
     snprintf(availabilityBoolKey, sizeof(availabilityBoolKey), MO_CONFIG_EXT_PREFIX "AVAIL_CONN_%d", connectorId);
     availabilityBool = declareConfiguration<bool>(availabilityBoolKey, true, MO_KEYVALUE_FN, false, false, false);
@@ -65,12 +67,57 @@ Connector::Connector(Context& context, int connectorId)
 
     txStartOnPowerPathClosedBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "TxStartOnPowerPathClosed", false);
 
+    transactionMessageAttemptsInt = declareConfiguration<int>("TransactionMessageAttempts", 3);
+    transactionMessageRetryIntervalInt = declareConfiguration<int>("TransactionMessageRetryInterval", 60);
+
     if (!availabilityBool) {
         MO_DBG_ERR("Cannot declare availabilityBool");
     }
 
+    char txFnamePrefix [30];
+    snprintf(txFnamePrefix, sizeof(txFnamePrefix), "tx-%u-", connectorId);
+    size_t txFnamePrefixLen = strlen(txFnamePrefix);
+
+    unsigned int txNrPivot = std::numeric_limits<unsigned int>::max();
+
+    filesystem->ftw_root([this, txFnamePrefix, txFnamePrefixLen, &txNrPivot] (const char *fname) {
+        if (!strncmp(fname, txFnamePrefix, txFnamePrefixLen)) {
+            unsigned int parsedTxNr = 0;
+            for (size_t i = txFnamePrefixLen; fname[i] >= '0' && fname[i] <= '9'; i++) {
+                parsedTxNr *= 10;
+                parsedTxNr += fname[i] - '0';
+            }
+
+            if (txNrPivot == std::numeric_limits<unsigned int>::max()) {
+                txNrPivot = parsedTxNr;
+                txNrBegin = parsedTxNr;
+                txNrBack = (parsedTxNr + 1) % MAX_TX_CNT;
+                return 0;
+            }
+
+            if ((parsedTxNr + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT < MAX_TX_CNT / 2) {
+                //parsedTxNr is after pivot point
+                if ((parsedTxNr + 1 + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT > (txNrBack + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT) {
+                    txNrBack = (parsedTxNr + 1) % MAX_TX_CNT;
+                }
+            } else if ((txNrPivot + MAX_TX_CNT - parsedTxNr) % MAX_TX_CNT < MAX_TX_CNT / 2) {
+                //parsedTxNr is before pivot point
+                if ((txNrPivot + MAX_TX_CNT - parsedTxNr) % MAX_TX_CNT > (txNrPivot + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT) {
+                    txNrBegin = parsedTxNr;
+                }
+            }
+
+            MO_DBG_DEBUG("found %s%u.jsn - Internal range from %u to %u (exclusive)", txFnamePrefix, parsedTxNr, txNrBegin, txNrBack);
+        }
+        return 0;
+    });
+
+    MO_DBG_DEBUG("found %u transactions for connector %u. Internal range from %u to %u (exclusive)", (txNrBack + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT, connectorId, txNrBegin, txNrBack);
+    txNrFront = txNrBegin;
+
     if (model.getTransactionStore()) {
-        transaction = model.getTransactionStore()->getLatestTransaction(connectorId);
+        unsigned int txNrLatest = (txNrBack + MAX_TX_CNT - 1) % MAX_TX_CNT; //txNr of the most recent tx on flash
+        transaction = model.getTransactionStore()->getTransaction(connectorId, txNrLatest); //returns nullptr if txNrLatest does not exist on flash
     } else {
         MO_DBG_ERR("must initialize TxStore before Connector");
     }
@@ -201,11 +248,12 @@ void Connector::loop() {
         }
     }
 
-    if (transaction && transaction->isAborted() && MO_TX_CLEAN_ABORTED) {
-        //If the transaction is aborted (invalidated before started), delete all artifacts from flash
+    if (transaction && ((transaction->isAborted() && MO_TX_CLEAN_ABORTED) || (transaction->isSilent() && transaction->getStopSync().isRequested()))) {
+        //If the transaction is aborted (invalidated before started) or is silent and has stopped. Delete all artifacts from flash
         //This is an optimization. The memory management will attempt to remove those files again later
         bool removed = true;
         if (auto mService = model.getMeteringService()) {
+            mService->abortTxMeterData(connectorId);
             removed &= mService->removeTxMeterData(connectorId, transaction->getTxNr());
         }
 
@@ -214,20 +262,26 @@ void Connector::loop() {
         }
 
         if (removed) {
-            model.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr()); //roll back creation of last tx entry
+            if (txNrFront == txNrBack) {
+                txNrFront = transaction->getTxNr();
+            }
+            txNrBack = transaction->getTxNr(); //roll back creation of last tx entry
         }
 
-        MO_DBG_DEBUG("collect aborted transaction %u-%u %s", connectorId, transaction->getTxNr(), removed ? "" : "failure");
+        MO_DBG_DEBUG("collect aborted or silent transaction %u-%u %s", connectorId, transaction->getTxNr(), removed ? "" : "failure");
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
         transaction = nullptr;
     }
 
     if (transaction && transaction->isAborted()) {
         MO_DBG_DEBUG("collect aborted transaction %u-%u", connectorId, transaction->getTxNr());
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
         transaction = nullptr;
     }
 
     if (transaction && transaction->getStopSync().isRequested()) {
         MO_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
         transaction = nullptr;
     }
 
@@ -300,36 +354,27 @@ void Connector::loop() {
                     transaction->setStartBootNr(model.getBootNr());
                 }
 
-                updateTxNotification(TxNotification::StartTx);
+                transaction->getStartSync().setRequested();
+                transaction->getStartSync().setOpNr(context.getRequestQueue().getNextOpNr());
 
                 if (transaction->isSilent()) {
                     MO_DBG_INFO("silent Transaction: omit StartTx");
-                    transaction->getStartSync().setRequested();
                     transaction->getStartSync().confirm();
-                    transaction->commit();
-                    return;
+                } else {
+                    //normal transaction, record txMeterData
+                    if (model.getMeteringService()) {
+                        model.getMeteringService()->beginTxMeterData(transaction.get());
+                    }
                 }
 
                 transaction->commit();
 
-                if (model.getMeteringService()) {
-                    model.getMeteringService()->beginTxMeterData(transaction.get());
-                }
-
-                auto startTx = makeRequest(new Ocpp16::StartTransaction(model, transaction));
-                startTx->setTimeout(0);
-                startTx->setOnReceiveConfListener([this] (JsonObject response) {
-                    //fetch authorization status from StartTransaction.conf() for user notification
+                updateTxNotification(TxNotification::StartTx);
 
-                    const char* idTagInfoStatus = response["idTagInfo"]["status"] | "_Undefined";
-                    if (strcmp(idTagInfoStatus, "Accepted")) {
-                        updateTxNotification(TxNotification::DeAuthorized);
-                    }
-                });
-                context.initiateRequest(std::move(startTx));
+                //fetchFrontRequest will create the StartTransaction and pass it to the message sender
                 return;
             }
-        } else  {
+        } else {
             //stop tx?
 
             if (!transaction->isActive() &&
@@ -337,20 +382,6 @@ void Connector::loop() {
                 //stop transaction
 
                 MO_DBG_INFO("Session mngt: trigger StopTransaction");
-
-                if (transaction->isSilent()) {
-                    MO_DBG_INFO("silent Transaction: omit StopTx");
-                    updateTxNotification(TxNotification::StopTx);
-                    transaction->getStopSync().setRequested();
-                    transaction->getStopSync().confirm();
-                    if (auto mService = model.getMeteringService()) {
-                        mService->removeTxMeterData(connectorId, transaction->getTxNr());
-                    }
-                    model.getTransactionStore()->remove(connectorId, transaction->getTxNr());
-                    model.getTransactionStore()->setTxEnd(connectorId, transaction->getTxNr());
-                    transaction = nullptr;
-                    return;
-                }
                 
                 auto meteringService = model.getMeteringService();
                 if (transaction->getMeterStop() < 0 && meteringService) {
@@ -367,25 +398,24 @@ void Connector::loop() {
                     transaction->setStopBootNr(model.getBootNr());
                 }
 
-                transaction->commit();
+                transaction->getStopSync().setRequested();
+                transaction->getStopSync().setOpNr(context.getRequestQueue().getNextOpNr());
 
-                updateTxNotification(TxNotification::StopTx);
-
-                std::shared_ptr<TransactionMeterData> stopTxData;
-
-                if (meteringService) {
-                    stopTxData = meteringService->endTxMeterData(transaction.get());
+                if (transaction->isSilent()) {
+                    MO_DBG_INFO("silent Transaction: omit StopTx");
+                    transaction->getStopSync().confirm();
+                } else {
+                    //normal transaction, record txMeterData
+                    if (model.getMeteringService()) {
+                        model.getMeteringService()->endTxMeterData(transaction.get());
+                    }
                 }
 
-                std::unique_ptr<Request> stopTx;
+                transaction->commit();
 
-                if (stopTxData) {
-                    stopTx = makeRequest(new Ocpp16::StopTransaction(model, std::move(transaction), stopTxData->retrieveStopTxData()));
-                } else {
-                    stopTx = makeRequest(new Ocpp16::StopTransaction(model, std::move(transaction)));
-                }
-                stopTx->setTimeout(0);
-                context.initiateRequest(std::move(stopTx));
+                updateTxNotification(TxNotification::StopTx);
+
+                //fetchFrontRequest will create the StopTransaction and pass it to the message sender
                 return;
             }
         }
@@ -516,14 +546,14 @@ const char *Connector::getErrorCode() {
 
 std::shared_ptr<Transaction> Connector::allocateTransaction() {
 
-    decltype(allocateTransaction()) tx;
+    std::shared_ptr<Transaction> tx;
 
-    //clean possible aorted tx
-    auto txr = model.getTransactionStore()->getTxEnd(connectorId);
-    auto txsize = model.getTransactionStore()->size(connectorId);
-    for (decltype(txsize) i = 0; i < txsize; i++) {
+    //clean possible aborted tx
+    unsigned int txr = txNrBack;
+    unsigned int txSize = (txNrBack + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT;
+    for (unsigned int i = 0; i < txSize; i++) {
         txr = (txr + MAX_TX_CNT - 1) % MAX_TX_CNT; //decrement by 1
-        
+
         auto tx = model.getTransactionStore()->getTransaction(connectorId, txr);
         //check if dangling silent tx, aborted tx, or corrupted entry (tx == null)
         if (!tx || tx->isSilent() || (tx->isAborted() && MO_TX_CLEAN_ABORTED)) {
@@ -536,7 +566,10 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
                 removed &= model.getTransactionStore()->remove(connectorId, txr);
             }
             if (removed) {
-                model.getTransactionStore()->setTxEnd(connectorId, txr);
+                if (txNrFront == txNrBack) {
+                    txNrFront = txr;
+                }
+                txNrBack = txr;
                 MO_DBG_WARN("deleted dangling silent or aborted tx for new transaction");
             } else {
                 MO_DBG_ERR("memory corruption");
@@ -548,16 +581,20 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
         }
     }
 
+    txSize = (txNrBack + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT; //refresh after cleaning txs
+
     //try to create new transaction
-    tx = model.getTransactionStore()->createTransaction(connectorId);
+    if (txSize < MO_TXRECORD_SIZE) {
+        tx = model.getTransactionStore()->createTransaction(connectorId, txNrBack);
+    }
 
     if (!tx) {
         //could not create transaction - now, try to replace tx history entry
 
-        auto txl = model.getTransactionStore()->getTxBegin(connectorId);
-        auto txsize = model.getTransactionStore()->size(connectorId);
+        unsigned int txl = txNrBegin;
+        txSize = (txNrBack + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT;
 
-        for (decltype(txsize) i = 0; i < txsize; i++) {
+        for (unsigned int i = 0; i < txSize; i++) {
 
             if (tx) {
                 //success, finished here
@@ -568,7 +605,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
 
             auto txhist = model.getTransactionStore()->getTransaction(connectorId, txl);
             //oldest entry, now check if it's history and can be removed or corrupted entry
-            if (!txhist || txhist->isCompleted() || txhist->isAborted()) {
+            if (!txhist || txhist->isCompleted() || txhist->isAborted() || (txhist->isSilent() && txhist->getStopSync().isRequested())) {
                 //yes, remove
                 bool removed = true;
                 if (auto mService = model.getMeteringService()) {
@@ -578,10 +615,14 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
                     removed &= model.getTransactionStore()->remove(connectorId, txl);
                 }
                 if (removed) {
-                    model.getTransactionStore()->setTxBegin(connectorId, (txl + 1) % MAX_TX_CNT);
+                    txNrBegin = (txl + 1) % MAX_TX_CNT;
+                    if (txNrFront == txl) {
+                        txNrFront = txNrBegin;
+                    }
                     MO_DBG_DEBUG("deleted tx history entry for new transaction");
+                    MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
 
-                    tx = model.getTransactionStore()->createTransaction(connectorId);
+                    tx = model.getTransactionStore()->createTransaction(connectorId, txNrBack);
                 } else {
                     MO_DBG_ERR("memory corruption");
                     break;
@@ -601,7 +642,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
         //couldn't create normal transaction -> check if to start charging without real transaction
         if (silentOfflineTransactionsBool && silentOfflineTransactionsBool->getBool()) {
             //try to handle charging session without sending StartTx or StopTx to the server
-            tx = model.getTransactionStore()->createTransaction(connectorId, true);
+            tx = model.getTransactionStore()->createTransaction(connectorId, txNrBack, true);
 
             if (tx) {
                 MO_DBG_DEBUG("created silent transaction");
@@ -609,6 +650,21 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
         }
     }
 
+    if (tx) {
+        //clean meter data which could still be here from a rolled-back transaction
+        if (auto mService = model.getMeteringService()) {
+            if (!mService->removeTxMeterData(connectorId, tx->getTxNr())) {
+                MO_DBG_ERR("memory corruption");
+            }
+        }
+    }
+
+    if (tx) {
+        txNrBack = (txNrBack + 1) % MAX_TX_CNT;
+        MO_DBG_DEBUG("advance txNrBack %u-%u", connectorId, txNrBack);
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+    }
+
     return tx;
 }
 
@@ -1019,3 +1075,197 @@ void Connector::updateTxNotification(TxNotification event) {
         txNotificationOutput(transaction.get(), event);
     }
 }
+
+unsigned int Connector::getFrontRequestOpNr() {
+
+    /*
+     * Advance front transaction?
+     */
+
+    unsigned int txSize = (txNrBack + MAX_TX_CNT - txNrFront) % MAX_TX_CNT;
+
+    if (transactionFront && txSize == 0) {
+        //catch edge case where txBack has been rolled back and txFront was equal to txBack
+        MO_DBG_DEBUG("collect front transaction %u-%u after tx rollback", connectorId, transactionFront->getTxNr());
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+        transactionFront = nullptr;
+    }
+
+    for (unsigned int i = 0; i < txSize; i++) {
+
+        if (!transactionFront) {
+            transactionFront = model.getTransactionStore()->getTransaction(connectorId, txNrFront);
+
+            #if MO_DBG_LEVEL >= MO_DL_VERBOSE
+            if (transactionFront)
+            {
+                MO_DBG_VERBOSE("load front transaction %u-%u", connectorId, transactionFront->getTxNr());
+            }
+            #endif
+        }
+
+        if (transactionFront && (transactionFront->isAborted() || transactionFront->isCompleted() || transactionFront->isSilent())) {
+            //advance front
+            MO_DBG_DEBUG("collect front transaction %u-%u", connectorId, transactionFront->getTxNr());
+            transactionFront = nullptr;
+            txNrFront = (txNrFront + 1) % MAX_TX_CNT;
+            MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+        } else {
+            //front is accurate. Done here
+            break;
+        }
+    }
+
+    if (transactionFront) {
+        if (transactionFront->getStartSync().isRequested() && !transactionFront->getStartSync().isConfirmed()) {
+            return transactionFront->getStartSync().getOpNr();
+        }
+
+        if (transactionFront->getStopSync().isRequested() && !transactionFront->getStopSync().isConfirmed()) {
+            return transactionFront->getStopSync().getOpNr();
+        }
+    }
+
+    return NoOperation;
+}
+
+std::unique_ptr<Request> Connector::fetchFrontRequest() {
+
+    if (transactionFront && !transactionFront->isSilent()) {
+        if (transactionFront->getStartSync().isRequested() && !transactionFront->getStartSync().isConfirmed()) {
+            //send StartTx?
+
+            bool cancelStartTx = false;
+
+            if (transactionFront->getStartTimestamp() < MIN_TIME &&
+                    transactionFront->getStartBootNr() != model.getBootNr()) {
+                //time not set, cannot be restored anymore -> invalid tx
+                MO_DBG_ERR("cannot recover tx from previus run");
+
+                cancelStartTx = true;
+            }
+
+            if ((int)transactionFront->getStartSync().getAttemptNr() >= transactionMessageAttemptsInt->getInt()) {
+                MO_DBG_WARN("exceeded TransactionMessageAttempts. Discard transaction");
+
+                cancelStartTx = true;
+            }
+
+            if (cancelStartTx) {
+                transactionFront->setSilent();
+                transactionFront->setInactive();
+                transactionFront->commit();
+
+                //clean up possible tx records
+                if (auto mSerivce = model.getMeteringService()) {
+                    mSerivce->removeTxMeterData(connectorId, transactionFront->getTxNr());
+                }
+                //next getFrontRequestOpNr() call will collect transactionFront
+                return nullptr;
+            }
+
+            Timestamp nextAttempt = transactionFront->getStartSync().getAttemptTime() +
+                                    transactionFront->getStartSync().getAttemptNr() * transactionMessageRetryIntervalInt->getInt();
+
+            if (nextAttempt > model.getClock().now()) {
+                return nullptr;
+            }
+
+            transactionFront->getStartSync().advanceAttemptNr();
+            transactionFront->getStartSync().setAttemptTime(model.getClock().now());
+            transactionFront->commit();
+
+            auto startTx = makeRequest(new Ocpp16::StartTransaction(model, transactionFront));
+            startTx->setOnReceiveConfListener([this] (JsonObject response) {
+                //fetch authorization status from StartTransaction.conf() for user notification
+
+                const char* idTagInfoStatus = response["idTagInfo"]["status"] | "_Undefined";
+                if (strcmp(idTagInfoStatus, "Accepted")) {
+                    updateTxNotification(TxNotification::DeAuthorized);
+                }
+            });
+            auto transactionFront_capture = transactionFront;
+            startTx->setOnAbortListener([this, transactionFront_capture] () {
+                //shortcut to the attemptNr check above. Relevant if other operations block the queue while this StartTx is timing out
+                if (transactionFront_capture && (int)transactionFront_capture->getStartSync().getAttemptNr() >= transactionMessageAttemptsInt->getInt()) {
+                    MO_DBG_WARN("exceeded TransactionMessageAttempts. Discard transaction");
+
+                    transactionFront_capture->setSilent();
+                    transactionFront_capture->setInactive();
+                    transactionFront_capture->commit();
+
+                    //clean up possible tx records
+                    if (auto mSerivce = model.getMeteringService()) {
+                        mSerivce->removeTxMeterData(connectorId, transactionFront_capture->getTxNr());
+                    }
+                    //next getFrontRequestOpNr() call will collect transactionFront
+                }
+            });
+
+            return startTx;
+        }
+
+        if (transactionFront->getStopSync().isRequested() && !transactionFront->getStopSync().isConfirmed()) {
+            //send StopTx?
+
+            if ((int)transactionFront->getStopSync().getAttemptNr() >= transactionMessageAttemptsInt->getInt()) {
+                MO_DBG_WARN("exceeded TransactionMessageAttempts. Discard transaction");
+
+                transactionFront->setSilent();
+
+                //clean up possible tx records
+                if (auto mSerivce = model.getMeteringService()) {
+                    mSerivce->removeTxMeterData(connectorId, transactionFront->getTxNr());
+                }
+                //next getFrontRequestOpNr() call will collect transactionFront
+                return nullptr;
+            }
+
+            Timestamp nextAttempt = transactionFront->getStopSync().getAttemptTime() +
+                                    transactionFront->getStopSync().getAttemptNr() * transactionMessageRetryIntervalInt->getInt();
+
+            if (nextAttempt > model.getClock().now()) {
+                return nullptr;
+            }
+
+            transactionFront->getStopSync().advanceAttemptNr();
+            transactionFront->getStopSync().setAttemptTime(model.getClock().now());
+            transactionFront->commit();
+
+            std::shared_ptr<TransactionMeterData> stopTxData;
+
+            if (auto meteringService = model.getMeteringService()) {
+                stopTxData = meteringService->getStopTxMeterData(transactionFront.get());
+            }
+
+            std::unique_ptr<Request> stopTx;
+
+            if (stopTxData) {
+                stopTx = makeRequest(new Ocpp16::StopTransaction(model, transactionFront, stopTxData->retrieveStopTxData()));
+            } else {
+                stopTx = makeRequest(new Ocpp16::StopTransaction(model, transactionFront));
+            }
+            auto transactionFront_capture = transactionFront;
+            stopTx->setOnAbortListener([this, transactionFront_capture] () {
+                //shortcut to the attemptNr check above. Relevant if other operations block the queue while this StopTx is timing out
+                if ((int)transactionFront_capture->getStopSync().getAttemptNr() >= transactionMessageAttemptsInt->getInt()) {
+                    MO_DBG_WARN("exceeded TransactionMessageAttempts. Discard transaction");
+
+                    transactionFront_capture->setSilent();
+                    transactionFront_capture->setInactive();
+                    transactionFront_capture->commit();
+
+                    //clean up possible tx records
+                    if (auto mSerivce = model.getMeteringService()) {
+                        mSerivce->removeTxMeterData(connectorId, transactionFront_capture->getTxNr());
+                    }
+                    //next getFrontRequestOpNr() call will collect transactionFront
+                }
+            });
+
+            return stopTx;
+        }
+    }
+
+    return nullptr;
+}
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 08828f2d..637313e0 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -9,13 +9,21 @@
 #include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
+#include <MicroOcpp/Core/RequestQueue.h>
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Operations/CiStrings.h>
 
 #include <vector>
 #include <functional>
 #include <memory>
 
+#ifndef MO_TXRECORD_SIZE
+#define MO_TXRECORD_SIZE 4 //no. of tx to hold on flash storage
+#endif
+
+#define MAX_TX_CNT 100000U //upper limit of txNr (internal usage). Must be at least 2*MO_TXRECORD_SIZE+1
+
 #ifndef MO_REPORT_NOERROR
 #define MO_REPORT_NOERROR 0
 #endif
@@ -27,12 +35,13 @@ class Model;
 class Operation;
 class Transaction;
 
-class Connector {
+class Connector : public RequestEmitter {
 private:
     Context& context;
     Model& model;
+    std::shared_ptr<FilesystemAdapter> filesystem;
     
-    const int connectorId;
+    const unsigned int connectorId;
 
     std::shared_ptr<Transaction> transaction;
 
@@ -79,9 +88,18 @@ class Connector {
 
     std::shared_ptr<Configuration> txStartOnPowerPathClosedBool; // this postpones the tx start point to when evReadyInput becomes true
 
+    std::shared_ptr<Configuration> transactionMessageAttemptsInt;
+    std::shared_ptr<Configuration> transactionMessageRetryIntervalInt;
+
     bool trackLoopExecute = false; //if loop has been executed once
+
+    unsigned int txNrBegin = 0; //oldest (historical) transaction on flash. Has no function, but is useful for error diagnosis
+    unsigned int txNrFront = 0; //oldest transaction which is still queued to be sent to the server
+    unsigned int txNrBack = 0; //one position behind newest transaction
+
+    std::shared_ptr<Transaction> transactionFront;
 public:
-    Connector(Context& context, int connectorId);
+    Connector(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId);
     Connector(const Connector&) = delete;
     Connector(Connector&&) = delete;
     Connector& operator=(const Connector&) = delete;
@@ -136,6 +154,9 @@ class Connector {
 
     void setTxNotificationOutput(std::function<void(Transaction*,TxNotification)> txNotificationOutput);
     void updateTxNotification(TxNotification event);
+
+    unsigned int getFrontRequestOpNr() override;
+    std::unique_ptr<Request> fetchFrontRequest() override;
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.cpp b/src/MicroOcpp/Model/Metering/MeterStore.cpp
index f3ebe2bc..d5f7041a 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterStore.cpp
@@ -137,12 +137,12 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
 
         txData.push_back(std::move(mv));
 
-        mvCount = i;
         i++;
+        mvCount = i;
         misses = 0;
     }
 
-    MO_DBG_DEBUG("Restored %zu meter values", txData.size());
+    MO_DBG_DEBUG("Restored %zu meter values from sd-%u-%u-0 to %u (exclusive)", txData.size(), connectorId, txNr, mvCount);
     return true;
 }
 
@@ -210,7 +210,7 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
 
     txMeterData.push_back(tx);
 
-    MO_DBG_DEBUG("Added txNr %u, now holding %zu txs", txNr, txMeterData.size());
+    MO_DBG_DEBUG("Added txNr %u, now holding %zu sds", txNr, txMeterData.size());
 
     return tx;
 }
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.h b/src/MicroOcpp/Model/Metering/MeterStore.h
index d0f5af74..3f14e47c 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.h
+++ b/src/MicroOcpp/Model/Metering/MeterStore.h
@@ -19,7 +19,7 @@ class TransactionMeterData {
     const unsigned int connectorId; //assignment to Transaction object
     const unsigned int txNr; //assignment to Transaction object
 
-    unsigned int mvCount = 0; //nr of saved meter values
+    unsigned int mvCount = 0; //nr of saved meter values, including gaps
     bool finalized = false; //if true, this is read-only
 
     std::shared_ptr<FilesystemAdapter> filesystem;
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index 3e642f87..aa1f4dcc 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -24,14 +24,14 @@ MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore&
     declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
     meterValueCacheSizeInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "MeterValueCacheSize", 1);
     meterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval", 60);
-    
+
     auto stopTxnSampledDataString = declareConfiguration<const char*>("StopTxnSampledData", "");
     declareConfiguration<int>("StopTxnSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
-    
+
     auto meterValuesAlignedDataString = declareConfiguration<const char*>("MeterValuesAlignedData", "");
     declareConfiguration<int>("MeterValuesAlignedDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
     clockAlignedDataIntervalInt  = declareConfiguration<int>("ClockAlignedDataInterval", 0);
-    
+
     auto stopTxnAlignedDataString = declareConfiguration<const char*>("StopTxnAlignedData", "");
 
     meterValuesInTxOnlyBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "MeterValuesInTxOnly", true);
@@ -66,12 +66,12 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         if (transaction != model.getConnector(connectorId)->getTransaction()) {
             transaction = model.getConnector(connectorId)->getTransaction();
         }
-        
+
         if (transaction && transaction->isRunning() && !transaction->isSilent()) {
             //check during transaction
 
             if (!stopTxnData || stopTxnData->getTxNr() != transaction->getTxNr()) {
-                MO_DBG_WARN("reload stopTxnData");
+                MO_DBG_WARN("reload stopTxnData, %s, for tx-%u-%u", stopTxnData ? "replace" : "first time", connectorId, transaction->getTxNr());
                 //reload (e.g. after power cut during transaction)
                 stopTxnData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction.get());
             }
@@ -108,9 +108,8 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
                         stopTxnData->addTxData(std::move(alignedStopTx));
                     }
                 }
-
             }
-            
+
             Timestamp midnightBase = Timestamp(2010,0,0,0,0,0);
             auto intervall = timestampNow - midnightBase;
             intervall %= 3600 * 24;
@@ -143,7 +142,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
                 }
             }
             lastSampleTime = mocpp_tick_ms();
-        }   
+        }
     }
 
     if (clockAlignedDataIntervalInt->getInt() < 1 && meterValueSampleIntervalInt->getInt() < 1) {
@@ -216,6 +215,10 @@ std::shared_ptr<TransactionMeterData> MeteringConnector::endTxMeterData(Transact
     return std::move(stopTxnData);
 }
 
+void MeteringConnector::abortTxMeterData() {
+    stopTxnData.reset();
+}
+
 std::shared_ptr<TransactionMeterData> MeteringConnector::getStopTxMeterData(Transaction *transaction) {
     auto txData = meterStore.getTxMeterData(*stopTxnSampledDataBuilder, transaction);
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.h b/src/MicroOcpp/Model/Metering/MeteringConnector.h
index f5f304da..c40075f5 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.h
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.h
@@ -70,6 +70,8 @@ class MeteringConnector {
 
     std::shared_ptr<TransactionMeterData> endTxMeterData(Transaction *transaction);
 
+    void abortTxMeterData();
+
     std::shared_ptr<TransactionMeterData> getStopTxMeterData(Transaction *transaction);
 
     bool existsSampler(const char *measurand, size_t len);
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index af8700f6..bff296d1 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -160,6 +160,16 @@ std::shared_ptr<TransactionMeterData> MeteringService::endTxMeterData(Transactio
     return connector->endTxMeterData(transaction);
 }
 
+void MeteringService::abortTxMeterData(unsigned int connectorId) {
+    if (connectorId >= connectors.size()) {
+        MO_DBG_ERR("connectorId is out of bounds");
+        return;
+    }
+    auto& connector = connectors[connectorId];
+
+    connector->abortTxMeterData();
+}
+
 std::shared_ptr<TransactionMeterData> MeteringService::getStopTxMeterData(Transaction *transaction) {
     if (!transaction) {
         MO_DBG_ERR("invalid argument");
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.h b/src/MicroOcpp/Model/Metering/MeteringService.h
index 5249a3e3..76f8038d 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.h
+++ b/src/MicroOcpp/Model/Metering/MeteringService.h
@@ -40,6 +40,8 @@ class MeteringService {
 
     std::shared_ptr<TransactionMeterData> endTxMeterData(Transaction *transaction); //use return value to keep data in cache
 
+    void abortTxMeterData(unsigned int connectorId); //call this to free resources if txMeterData record is not ended normally. Does not remove files
+
     std::shared_ptr<TransactionMeterData> getStopTxMeterData(Transaction *transaction); //prefer endTxMeterData when possible
 
     bool removeTxMeterData(unsigned int connectorId, unsigned int txNr);
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index 74997059..4413102a 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -26,11 +26,22 @@ class SendStatus {
 private:
     bool requested = false;
     bool confirmed = false;
+    
+    unsigned int opNr = 0;
+    unsigned int attemptNr = 0;
+    Timestamp attemptTime = MIN_TIME;
 public:
     void setRequested() {this->requested = true;}
     bool isRequested() {return requested;}
     void confirm() {confirmed = true;}
     bool isConfirmed() {return confirmed;}
+    void setOpNr(unsigned int opNr) {this->opNr = opNr;}
+    unsigned int getOpNr() {return opNr;}
+    void advanceAttemptNr() {attemptNr++;}
+    void setAttemptNr(unsigned int attemptNr) {this->attemptNr = attemptNr;}
+    unsigned int getAttemptNr() {return attemptNr;}
+    const Timestamp& getAttemptTime() {return attemptTime;}
+    void setAttemptTime(const Timestamp& timestamp) {attemptTime = timestamp;}
 };
 
 class Transaction {
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
index bb951f82..eb3ff237 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -16,6 +16,15 @@ bool serializeSendStatus(SendStatus& status, JsonObject out) {
     if (status.isConfirmed()) {
         out["confirmed"] = true;
     }
+    out["opNr"] = status.getOpNr();
+    if (status.getAttemptNr() != 0) {
+        out["attemptNr"] = status.getAttemptNr();
+    }
+    if (status.getAttemptTime() > MIN_TIME) {
+        char attemptTime [JSONDATE_LENGTH + 1];
+        status.getAttemptTime().toJsonString(attemptTime, sizeof(attemptTime));
+        out["attemptTime"] = attemptTime;
+    }
     return true;
 }
 
@@ -26,6 +35,19 @@ bool deserializeSendStatus(SendStatus& status, JsonObject in) {
     if (in["confirmed"] | false) {
         status.confirm();
     }
+    unsigned int opNr = in["opNr"] | (unsigned int)0;
+    if (opNr >= 10) { //10 is first valid tx-related opNr
+        status.setOpNr(opNr);
+    }
+    status.setAttemptNr(in["attemptNr"] | (unsigned int)0);
+    if (in.containsKey("attemptTime")) {
+        Timestamp attemptTime;
+        if (!attemptTime.setTime(in["attemptTime"] | "_Invalid")) {
+            MO_DBG_ERR("deserialization error");
+            return false;
+        }
+        status.setAttemptTime(attemptTime);
+    }
     return true;
 }
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index 41c5d0e8..163e252a 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -327,6 +327,12 @@ void TransactionService::Evse::loop() {
         auto txEventRequest = makeRequest(new Ocpp201::TransactionEvent(context.getModel(), txEvent));
         txEventRequest->setTimeout(0);
         context.initiateRequest(std::move(txEventRequest));
+
+        if (txEvent->eventType == TransactionEventData::Type::Started) {
+            transaction->started = true;
+        } else if (txEvent->eventType == TransactionEventData::Type::Ended) {
+            transaction->stopped = true;
+        }
     }
 }
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
index 7be7ea79..ccb48333 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
@@ -3,39 +3,21 @@
 // MIT License
 
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
-#include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/Transactions/TransactionDeserialize.h>
-#include <MicroOcpp/Operations/StartTransaction.h>
-#include <MicroOcpp/Operations/StopTransaction.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
 #include <MicroOcpp/Debug.h>
 
-#include <algorithm>
-
 using namespace MicroOcpp;
 
-#define MO_TXSTORE_META_FN MO_FILENAME_PREFIX "txstore.jsn"
-
 ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context, unsigned int connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
         context(context),
         connectorId(connectorId),
         filesystem(filesystem) {
 
-    snprintf(txBeginKey, sizeof(txBeginKey), MO_TXSTORE_TXBEGIN_KEY "%u", connectorId);
-    txBeginInt = declareConfiguration<int>(txBeginKey, 0, MO_TXSTORE_META_FN, false, false, false);
-
-    snprintf(txEndKey, sizeof(txEndKey), MO_TXSTORE_TXEND_KEY "%u", connectorId);
-    txEndInt = declareConfiguration<int>(txEndKey, 0, MO_TXSTORE_META_FN, false, false, false);
 }
 
 ConnectorTransactionStore::~ConnectorTransactionStore() {
-    if (txBeginInt->getKey() == txBeginKey) {
-        txBeginInt->setKey(nullptr);
-    }
-    if (txEndInt->getKey() == txEndKey) {
-        txEndInt->setKey(nullptr);
-    }
+
 }
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned int txNr) {
@@ -100,38 +82,23 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
     }
 
     //before adding new entry, clean cache
-    transactions.erase(std::remove_if(transactions.begin(), transactions.end(),
-            [](std::weak_ptr<Transaction> tx) {
-                return tx.expired();
-            }),
-            transactions.end());
+    cached = transactions.begin();
+    while (cached != transactions.end()) {
+        if (cached->expired()) {
+            //collect outdated cache reference
+            cached = transactions.erase(cached);
+        } else {
+            cached++;
+        }
+    }
 
     transactions.push_back(transaction);
     return transaction;
 }
 
-std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool silent) {
-    
-    if (!txBeginInt || txBeginInt->getInt() < 0 || !txEndInt || txEndInt->getInt() < 0) {
-        MO_DBG_ERR("memory corruption");
-        return nullptr;
-    }
-
-    //check if maximum number of queued tx already reached
-    if ((txEndInt->getInt() + MAX_TX_CNT - txBeginInt->getInt()) % MAX_TX_CNT >= MO_TXRECORD_SIZE) {
-        //limit reached
+std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(unsigned int txNr, bool silent) {
 
-        if (!silent) {
-            //normal tx -> abort
-            return nullptr;
-        }
-        //special case: silent tx -> create tx anyway, but should be deleted immediately after charging session
-    }
-
-    auto transaction = std::make_shared<Transaction>(*this, connectorId, (unsigned int) txEndInt->getInt(), silent);
-
-    txEndInt->setInt((txEndInt->getInt() + 1) % MAX_TX_CNT);
-    configuration_save();
+    auto transaction = std::make_shared<Transaction>(*this, connectorId, txNr, silent);
 
     if (!commit(transaction.get())) {
         MO_DBG_ERR("FS error");
@@ -139,27 +106,20 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(bool s
     }
 
     //before adding new entry, clean cache
-    transactions.erase(std::remove_if(transactions.begin(), transactions.end(),
-            [](std::weak_ptr<Transaction> tx) {
-                return tx.expired();
-            }),
-            transactions.end());
+    auto cached = transactions.begin();
+    while (cached != transactions.end()) {
+        if (cached->expired()) {
+            //collect outdated cache reference
+            cached = transactions.erase(cached);
+        } else {
+            cached++;
+        }
+    }
 
     transactions.push_back(transaction);
     return transaction;
 }
 
-std::shared_ptr<Transaction> ConnectorTransactionStore::getLatestTransaction() {
-    if (!txEndInt || txEndInt->getInt() < 0) {
-        MO_DBG_ERR("memory corruption");
-        return nullptr;
-    }
-
-    unsigned int latest = ((unsigned int) txEndInt->getInt() + MAX_TX_CNT - 1) % MAX_TX_CNT;
-
-    return getTransaction(latest);
-}
-
 bool ConnectorTransactionStore::commit(Transaction *transaction) {
 
     if (!filesystem) {
@@ -214,69 +174,12 @@ bool ConnectorTransactionStore::remove(unsigned int txNr) {
     return filesystem->remove(fn);
 }
 
-int ConnectorTransactionStore::getTxBegin() {
-    if (!txBeginInt || txBeginInt->getInt() < 0) {
-        MO_DBG_ERR("memory corruption");
-        return -1;
-    }
-
-    return txBeginInt->getInt();
-}
-
-int ConnectorTransactionStore::getTxEnd() {
-    if (!txEndInt || txEndInt->getInt() < 0) {
-        MO_DBG_ERR("memory corruption");
-        return -1;
-    }
-
-    return txEndInt->getInt();
-}
-
-void ConnectorTransactionStore::setTxBegin(unsigned int txNr) {
-    if (!txBeginInt || txBeginInt->getInt() < 0) {
-        MO_DBG_ERR("memory corruption");
-        return;
-    }
-
-    txBeginInt->setInt(txNr);
-    configuration_save();
-}
-
-void ConnectorTransactionStore::setTxEnd(unsigned int txNr) {
-    if (!txBeginInt || txBeginInt->getInt() < 0 || !txEndInt || txEndInt->getInt() < 0) {
-        MO_DBG_ERR("memory corruption");
-        return;
-    }
-
-    txEndInt->setInt(txNr);
-    configuration_save();
-}
-
-unsigned int ConnectorTransactionStore::size() {
-    if (!txBeginInt || txBeginInt->getInt() < 0 || !txEndInt || txEndInt->getInt() < 0) {
-        MO_DBG_ERR("memory corruption");
-        return 0;
-    }
-
-    return (txEndInt->getInt() + MAX_TX_CNT - txBeginInt->getInt()) % MAX_TX_CNT;
-}
-
 TransactionStore::TransactionStore(unsigned int nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
     
     for (unsigned int i = 0; i < nConnectors; i++) {
         connectors.push_back(std::unique_ptr<ConnectorTransactionStore>(
             new ConnectorTransactionStore(*this, i, filesystem)));
     }
-
-    configuration_load(MO_TXSTORE_META_FN);
-}
-
-std::shared_ptr<Transaction> TransactionStore::getLatestTransaction(unsigned int connectorId) {
-    if (connectorId >= connectors.size()) {
-        MO_DBG_ERR("Invalid connectorId");
-        return nullptr;
-    }
-    return connectors[connectorId]->getLatestTransaction();
 }
 
 bool TransactionStore::commit(Transaction *transaction) {
@@ -300,12 +203,12 @@ std::shared_ptr<Transaction> TransactionStore::getTransaction(unsigned int conne
     return connectors[connectorId]->getTransaction(txNr);
 }
 
-std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int connectorId, bool silent) {
+std::shared_ptr<Transaction> TransactionStore::createTransaction(unsigned int connectorId, unsigned int txNr, bool silent) {
     if (connectorId >= connectors.size()) {
         MO_DBG_ERR("Invalid connectorId");
         return nullptr;
     }
-    return connectors[connectorId]->createTransaction(silent);
+    return connectors[connectorId]->createTransaction(txNr, silent);
 }
 
 bool TransactionStore::remove(unsigned int connectorId, unsigned int txNr) {
@@ -315,43 +218,3 @@ bool TransactionStore::remove(unsigned int connectorId, unsigned int txNr) {
     }
     return connectors[connectorId]->remove(txNr);
 }
-
-int TransactionStore::getTxBegin(unsigned int connectorId) {
-    if (connectorId >= connectors.size()) {
-        MO_DBG_ERR("Invalid connectorId");
-        return -1;
-    }
-    return connectors[connectorId]->getTxBegin();
-}
-
-int TransactionStore::getTxEnd(unsigned int connectorId) {
-    if (connectorId >= connectors.size()) {
-        MO_DBG_ERR("Invalid connectorId");
-        return -1;
-    }
-    return connectors[connectorId]->getTxEnd();
-}
-
-void TransactionStore::setTxBegin(unsigned int connectorId, unsigned int txNr) {
-    if (connectorId >= connectors.size()) {
-        MO_DBG_ERR("Invalid connectorId");
-        return;
-    }
-    return connectors[connectorId]->setTxBegin(txNr);
-}
-
-void TransactionStore::setTxEnd(unsigned int connectorId, unsigned int txNr) {
-    if (connectorId >= connectors.size()) {
-        MO_DBG_ERR("Invalid connectorId");
-        return;
-    }
-    return connectors[connectorId]->setTxEnd(txNr);
-}
-
-unsigned int TransactionStore::size(unsigned int connectorId) {
-    if (connectorId >= connectors.size()) {
-        MO_DBG_ERR("Invalid connectorId");
-        return 0;
-    }
-    return connectors[connectorId]->size();
-}
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.h b/src/MicroOcpp/Model/Transactions/TransactionStore.h
index 100a2ab1..9f080dcd 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.h
@@ -5,19 +5,11 @@
 #ifndef MO_TRANSACTIONSTORE_H
 #define MO_TRANSACTIONSTORE_H
 
-#include <MicroOcpp/Model/Transactions/Transaction.h>
-#include <MicroOcpp/Core/Configuration.h>
-#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <vector>
 #include <deque>
 
-#define MAX_TX_CNT 100000U
-
-#ifndef MO_TXRECORD_SIZE
-#define MO_TXRECORD_SIZE 4 //no. of tx to hold on flash storage
-#endif
-
-#define MO_TXSTORE_TXBEGIN_KEY "txBegin_"
-#define MO_TXSTORE_TXEND_KEY "txEnd_"
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 
 namespace MicroOcpp {
 
@@ -29,11 +21,6 @@ class ConnectorTransactionStore {
     const unsigned int connectorId;
 
     std::shared_ptr<FilesystemAdapter> filesystem;
-    std::shared_ptr<Configuration> txBeginInt; //if txNr < txBegin, tx has been safely deleted
-    char txBeginKey [sizeof(MO_TXSTORE_TXBEGIN_KEY "xxx") + 1]; //"xxx": placeholder for connectorId
-
-    std::shared_ptr<Configuration> txEndInt;
-    char txEndKey [sizeof(MO_TXSTORE_TXEND_KEY "xxx") + 1];
     
     std::deque<std::weak_ptr<Transaction>> transactions;
 
@@ -44,21 +31,13 @@ class ConnectorTransactionStore {
     ConnectorTransactionStore& operator=(const ConnectorTransactionStore&) = delete;
 
     ~ConnectorTransactionStore();
-    
-    std::shared_ptr<Transaction> getLatestTransaction();
+
     bool commit(Transaction *transaction);
 
     std::shared_ptr<Transaction> getTransaction(unsigned int txNr);
-    std::shared_ptr<Transaction> createTransaction(bool silent = false);
+    std::shared_ptr<Transaction> createTransaction(unsigned int txNr, bool silent = false);
 
     bool remove(unsigned int txNr);
-
-    int getTxBegin();
-    int getTxEnd();
-    void setTxBegin(unsigned int txNr);
-    void setTxEnd(unsigned int txNr);
-
-    unsigned int size();
 };
 
 class TransactionStore {
@@ -67,20 +46,12 @@ class TransactionStore {
 public:
     TransactionStore(unsigned int nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
-    std::shared_ptr<Transaction> getLatestTransaction(unsigned int connectorId);
     bool commit(Transaction *transaction);
 
     std::shared_ptr<Transaction> getTransaction(unsigned int connectorId, unsigned int txNr);
-    std::shared_ptr<Transaction> createTransaction(unsigned int connectorId, bool silent = false);
+    std::shared_ptr<Transaction> createTransaction(unsigned int connectorId, unsigned int txNr, bool silent = false);
 
     bool remove(unsigned int connectorId, unsigned int txNr);
-
-    int getTxBegin(unsigned int connectorId);
-    int getTxEnd(unsigned int connectorId);
-    void setTxBegin(unsigned int connectorId, unsigned int txNr);
-    void setTxEnd(unsigned int connectorId, unsigned int txNr);
-
-    unsigned int size(unsigned int connectorId);
 };
 
 }
diff --git a/src/MicroOcpp/Operations/CustomOperation.cpp b/src/MicroOcpp/Operations/CustomOperation.cpp
index 6f035e62..ddd5ab32 100644
--- a/src/MicroOcpp/Operations/CustomOperation.cpp
+++ b/src/MicroOcpp/Operations/CustomOperation.cpp
@@ -9,12 +9,8 @@ using MicroOcpp::Ocpp16::CustomOperation;
 CustomOperation::CustomOperation(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf,
-            std::function<bool (const char*, const char*, JsonObject)> fn_processErr,
-            std::function<void (StoredOperationHandler*)> fn_initiate,
-            std::function<bool (StoredOperationHandler*)> fn_restore) :
+            std::function<bool (const char*, const char*, JsonObject)> fn_processErr) :
         operationType{operationType},
-        fn_initiate{fn_initiate},
-        fn_restore{fn_restore},
         fn_createReq{fn_createReq},
         fn_processConf{fn_processConf},
         fn_processErr{fn_processErr} {
@@ -44,20 +40,6 @@ const char* CustomOperation::getOperationType() {
     return operationType.c_str();
 }
 
-void CustomOperation::initiate(StoredOperationHandler *opStore) {
-    if (fn_initiate) {
-        fn_initiate(opStore);
-    }
-}
-
-bool CustomOperation::restore(StoredOperationHandler *opStore) {
-    if (fn_restore) {
-        return fn_restore(opStore);
-    } else {
-        return false;
-    }
-}
-
 std::unique_ptr<DynamicJsonDocument> CustomOperation::createReq() {
     return fn_createReq();
 }
diff --git a/src/MicroOcpp/Operations/CustomOperation.h b/src/MicroOcpp/Operations/CustomOperation.h
index 334aa98e..88193fc8 100644
--- a/src/MicroOcpp/Operations/CustomOperation.h
+++ b/src/MicroOcpp/Operations/CustomOperation.h
@@ -16,8 +16,6 @@ namespace Ocpp16 {
 class CustomOperation : public Operation {
 private:
     std::string operationType;
-    std::function<void (StoredOperationHandler*)> fn_initiate; //optional
-    std::function<bool (StoredOperationHandler*)> fn_restore;  //optional
     std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq;
     std::function<void (JsonObject)> fn_processConf;
     std::function<bool (const char*, const char*, JsonObject)> fn_processErr;  //optional
@@ -32,9 +30,7 @@ class CustomOperation : public Operation {
     CustomOperation(const char *operationType,
             std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf,
-            std::function<bool (const char*, const char*, JsonObject)> fn_processErr = nullptr,
-            std::function<void (StoredOperationHandler*)> fn_initiate = nullptr,
-            std::function<bool (StoredOperationHandler*)> fn_restore = nullptr);
+            std::function<bool (const char*, const char*, JsonObject)> fn_processErr = nullptr);
     
     //for operations receied from remote
     CustomOperation(const char *operationType,
@@ -48,10 +44,6 @@ class CustomOperation : public Operation {
 
     const char* getOperationType() override;
 
-    void initiate(StoredOperationHandler *opStore) override;
-
-    bool restore(StoredOperationHandler *opStore) override;
-
     std::unique_ptr<DynamicJsonDocument> createReq() override;
 
     void processConf(JsonObject payload) override;
diff --git a/src/MicroOcpp/Operations/StartTransaction.cpp b/src/MicroOcpp/Operations/StartTransaction.cpp
index c9378996..ccd5d89e 100644
--- a/src/MicroOcpp/Operations/StartTransaction.cpp
+++ b/src/MicroOcpp/Operations/StartTransaction.cpp
@@ -4,7 +4,6 @@
 
 #include <MicroOcpp/Operations/StartTransaction.h>
 #include <MicroOcpp/Model/Model.h>
-#include <MicroOcpp/Core/RequestStore.h>
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
 #include <MicroOcpp/Model/Metering/MeteringService.h>
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
@@ -27,84 +26,6 @@ const char* StartTransaction::getOperationType() {
     return "StartTransaction";
 }
 
-void StartTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!transaction || transaction->getStartSync().isRequested()) {
-        MO_DBG_ERR("initialization error");
-        return;
-    }
-    
-    auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
-    (*payload)["connectorId"] = transaction->getConnectorId();
-    (*payload)["txNr"] = transaction->getTxNr();
-
-    if (opStore) {
-        opStore->setPayload(std::move(payload));
-        opStore->commit();
-    }
-
-    transaction->getStartSync().setRequested();
-
-    transaction->commit();
-
-    MO_DBG_INFO("StartTransaction initiated");
-}
-
-bool StartTransaction::restore(StoredOperationHandler *opStore) {
-    if (!opStore) {
-        MO_DBG_ERR("invalid argument");
-        return false;
-    }
-
-    auto payload = opStore->getPayload();
-    if (!payload) {
-        MO_DBG_ERR("memory corruption");
-        return false;
-    }
-
-    int connectorId = (*payload)["connectorId"] | -1;
-    int txNr = (*payload)["txNr"] | -1;
-    if (connectorId < 0 || txNr < 0) {
-        MO_DBG_ERR("record incomplete");
-        return false;
-    }
-
-    auto txStore = model.getTransactionStore();
-
-    if (!txStore) {
-        MO_DBG_ERR("invalid state");
-        return false;
-    }
-
-    transaction = txStore->getTransaction(connectorId, txNr);
-    if (!transaction) {
-        MO_DBG_ERR("referential integrity violation");
-
-        //clean up possible tx records
-        if (auto mSerivce = model.getMeteringService()) {
-            mSerivce->removeTxMeterData(connectorId, txNr);
-        }
-        return false;
-    }
-
-    if (transaction->getStartTimestamp() < MIN_TIME &&
-            transaction->getStartBootNr() != model.getBootNr()) {
-        //time not set, cannot be restored anymore -> invalid tx
-        MO_DBG_ERR("cannot recover tx from previus run");
-
-        //clean up possible tx records
-        if (auto mSerivce = model.getMeteringService()) {
-            mSerivce->removeTxMeterData(connectorId, txNr);
-        }
-
-        transaction->setSilent();
-        transaction->setInactive();
-        transaction->commit();
-        return false;
-    }
-
-    return true;
-}
-
 std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
 
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
diff --git a/src/MicroOcpp/Operations/StartTransaction.h b/src/MicroOcpp/Operations/StartTransaction.h
index e6a2f0f3..e01d0461 100644
--- a/src/MicroOcpp/Operations/StartTransaction.h
+++ b/src/MicroOcpp/Operations/StartTransaction.h
@@ -29,10 +29,6 @@ class StartTransaction : public Operation {
 
     const char* getOperationType() override;
 
-    void initiate(StoredOperationHandler *opStore) override;
-
-    bool restore(StoredOperationHandler *opStore) override;
-
     std::unique_ptr<DynamicJsonDocument> createReq() override;
 
     void processConf(JsonObject payload) override;
diff --git a/src/MicroOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
index e2df5442..49b9b029 100644
--- a/src/MicroOcpp/Operations/StopTransaction.cpp
+++ b/src/MicroOcpp/Operations/StopTransaction.cpp
@@ -4,7 +4,6 @@
 
 #include <MicroOcpp/Operations/StopTransaction.h>
 #include <MicroOcpp/Model/Model.h>
-#include <MicroOcpp/Core/RequestStore.h>
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
 #include <MicroOcpp/Model/Metering/MeteringService.h>
 #include <MicroOcpp/Model/Metering/MeterValue.h>
@@ -29,85 +28,6 @@ const char* StopTransaction::getOperationType() {
     return "StopTransaction";
 }
 
-void StopTransaction::initiate(StoredOperationHandler *opStore) {
-    if (!transaction || transaction->getStopSync().isRequested()) {
-        MO_DBG_ERR("initialization error");
-        return;
-    }
-    
-    auto payload = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
-    (*payload)["connectorId"] = transaction->getConnectorId();
-    (*payload)["txNr"] = transaction->getTxNr();
-
-    if (opStore) {
-        opStore->setPayload(std::move(payload));
-        opStore->commit();
-    }
-
-    transaction->getStopSync().setRequested();
-
-    transaction->commit();
-
-    MO_DBG_INFO("StopTransaction initiated");
-}
-
-bool StopTransaction::restore(StoredOperationHandler *opStore) {
-    if (!opStore) {
-        MO_DBG_ERR("invalid argument");
-        return false;
-    }
-
-    auto payload = opStore->getPayload();
-    if (!payload) {
-        MO_DBG_ERR("memory corruption");
-        return false;
-    }
-
-    int connectorId = (*payload)["connectorId"] | -1;
-    int txNr = (*payload)["txNr"] | -1;
-    if (connectorId < 0 || txNr < 0) {
-        MO_DBG_ERR("record incomplete");
-        return false;
-    }
-
-    auto txStore = model.getTransactionStore();
-
-    if (!txStore) {
-        MO_DBG_ERR("invalid state");
-        return false;
-    }
-
-    transaction = txStore->getTransaction(connectorId, txNr);
-    if (!transaction) {
-        MO_DBG_ERR("referential integrity violation");
-
-        //clean up possible tx records
-        if (auto mSerivce = model.getMeteringService()) {
-            mSerivce->removeTxMeterData(connectorId, txNr);
-        }
-        return false;
-    }
-
-    if (transaction->isSilent()) {
-        //transaction has been set silent after initializing StopTx - discard operation record
-        MO_DBG_WARN("tx has been set silent - discard StopTx");
-
-        //clean up possible tx records
-        if (auto mSerivce = model.getMeteringService()) {
-            mSerivce->removeTxMeterData(connectorId, txNr);
-        }
-        return false;
-    }
-
-    if (auto mSerivce = model.getMeteringService()) {
-        if (auto txData = mSerivce->getStopTxMeterData(transaction.get())) {
-            transactionData = txData->retrieveStopTxData();
-        }
-    }
-
-    return true;
-}
-
 std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
 
     /*
diff --git a/src/MicroOcpp/Operations/StopTransaction.h b/src/MicroOcpp/Operations/StopTransaction.h
index 9d3bea4a..9f617e9d 100644
--- a/src/MicroOcpp/Operations/StopTransaction.h
+++ b/src/MicroOcpp/Operations/StopTransaction.h
@@ -34,10 +34,6 @@ class StopTransaction : public Operation {
 
     const char* getOperationType() override;
 
-    void initiate(StoredOperationHandler *opStore) override;
-
-    bool restore(StoredOperationHandler *opStore) override;
-
     std::unique_ptr<DynamicJsonDocument> createReq() override;
 
     void processConf(JsonObject payload) override;
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
index 2ff45e13..92a7e686 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.cpp
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -23,37 +23,6 @@ const char* TransactionEvent::getOperationType() {
     return "TransactionEvent";
 }
 
-void TransactionEvent::initiate(StoredOperationHandler *opStore) {
-    if (!txEvent || !txEvent->transaction || !txEvent->transaction) {
-        MO_DBG_ERR("initialization error");
-        return;
-    }
-
-    auto transaction = txEvent->transaction;
-
-    if (txEvent->eventType == TransactionEventData::Type::Started) {
-        if (transaction->started) {
-            MO_DBG_ERR("initialization error");
-            return;
-        }
-
-        transaction->started = true;
-    }
-
-    if (txEvent->eventType == TransactionEventData::Type::Ended) {
-        if (transaction->stopped) {
-            MO_DBG_ERR("initialization error");
-            return;
-        }
-
-        transaction->stopped = true;
-    }
-
-    //commit operation and tx
-
-    MO_DBG_INFO("TransactionEvent initiated");
-}
-
 std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
     auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
                 JSON_OBJECT_SIZE(12) + //total of 12 fields
diff --git a/src/MicroOcpp/Operations/TransactionEvent.h b/src/MicroOcpp/Operations/TransactionEvent.h
index ea8ef856..dcedb63e 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.h
+++ b/src/MicroOcpp/Operations/TransactionEvent.h
@@ -31,8 +31,6 @@ class TransactionEvent : public Operation {
 
     const char* getOperationType() override;
 
-    void initiate(StoredOperationHandler *opStore) override;
-
     std::unique_ptr<DynamicJsonDocument> createReq() override;
 
     void processConf(JsonObject payload) override;
diff --git a/src/MicroOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
index 8177aecb..7c246e3d 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.cpp
+++ b/src/MicroOcpp/Operations/TriggerMessage.cpp
@@ -35,11 +35,11 @@ void TriggerMessage::processReq(JsonObject payload) {
             if (connectorId < 0) {
                 auto nConnectors = mService->getNumConnectors();
                 for (decltype(nConnectors) cId = 0; cId < nConnectors; cId++) {
-                    context.initiatePreBootOperation(mService->takeTriggeredMeterValues(cId));
+                    context.getRequestQueue().sendRequestPreBoot(mService->takeTriggeredMeterValues(cId));
                     statusMessage = "Accepted";
                 }
             } else if (connectorId < mService->getNumConnectors()) {
-                context.initiatePreBootOperation(mService->takeTriggeredMeterValues(connectorId));
+                context.getRequestQueue().sendRequestPreBoot(mService->takeTriggeredMeterValues(connectorId));
                 statusMessage = "Accepted";
             } else {
                 errorCode = "PropertyConstraintViolation";
@@ -66,13 +66,13 @@ void TriggerMessage::processReq(JsonObject payload) {
 
             statusNotification->setTimeout(60000);
 
-            context.initiatePreBootOperation(std::move(statusNotification));
+            context.getRequestQueue().sendRequestPreBoot(std::move(statusNotification));
             statusMessage = "Accepted";
         }
     } else {
         auto msg = context.getOperationRegistry().deserializeOperation(requestedMessage);
         if (msg) {
-            context.initiatePreBootOperation(std::move(msg));
+            context.getRequestQueue().sendRequestPreBoot(std::move(msg));
             statusMessage = "Accepted";
         } else {
             statusMessage = "NotImplemented";
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 6975fea6..bff8838e 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -803,5 +803,283 @@ TEST_CASE( "Charging sessions" ) {
 
     }
 
+    SECTION("TransactionMessageAttempts-/RetryInterval") {
+
+        /*
+         * Scenarios:
+         * - final failure to send txMsg after tx terminated
+         * - normal communication restored after a final failure
+         * - StartTx fails finally during tx
+         * - StartTx works but StopTx fails finally after tx terminated
+         * - sends attempts fail until final attempt succeeds
+         * - after reboot, continue attempting
+         */
+
+        declareConfiguration<int>("TransactionMessageAttempts", 1)->setInt(1);
+
+        bool checkProcessedStartTx = false;
+        bool checkProcessedStopTx = false;
+        unsigned int txId = 1000;
+
+         /*
+         * - final failure to send txMsg after tx terminated
+         */
+
+        getOcppContext()->getOperationRegistry().registerOperation("StartTransaction", [&checkProcessedStartTx, &txId] () {
+            return new Ocpp16::CustomOperation("StartTransaction",
+                [&checkProcessedStartTx] (JsonObject payload) {
+                    //receive req
+                    checkProcessedStartTx = true;
+                },
+                [&txId] () {
+                    //create conf
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    JsonObject payload = doc->to<JsonObject>();
+
+                    JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
+                    idTagInfo["status"] = "Accepted";
+                    payload["transactionId"] = txId++;
+                    return doc;
+                });});
+
+        getOcppContext()->getOperationRegistry().registerOperation("StopTransaction", [&checkProcessedStopTx] () {
+            return new Ocpp16::CustomOperation("StopTransaction",
+                [&checkProcessedStopTx] (JsonObject payload) {
+                    //receive req
+                    checkProcessedStopTx = true;
+                }, 
+                [] () {
+                    //create conf
+                    return createEmptyDocument();
+                });});
+
+        loopback.setOnline(false);
+
+        REQUIRE( !ocppPermitsCharge() );
+
+        beginTransaction_authorized("mIdTag");
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+
+        endTransaction();
+        loop();
+        REQUIRE( !ocppPermitsCharge() );
+
+        mtime += 10 * 60 * 1000; //jump 10 minutes into future
+
+        loopback.setOnline(true);
+        loop();
+
+        REQUIRE( !checkProcessedStartTx );
+        REQUIRE( !checkProcessedStopTx );
+
+         /*
+         * - normal communication restored after a final failure
+         */
+        checkProcessedStartTx = false;
+        checkProcessedStopTx = false;
+        
+        beginTransaction_authorized("mIdTag");
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( checkProcessedStartTx );
+
+        endTransaction();
+        loop();
+        REQUIRE( !ocppPermitsCharge() );
+
+        REQUIRE( checkProcessedStopTx );
+
+        /*
+         * - StartTx fails finally during tx
+         */
+
+        checkProcessedStartTx = false;
+        checkProcessedStopTx = false;
+        
+        loopback.setOnline(false);
+
+        REQUIRE( !ocppPermitsCharge() );
+
+        beginTransaction_authorized("mIdTag");
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+
+        mtime += 10 * 60 * 1000; //jump 10 minutes into future
+        loop();
+        REQUIRE( !ocppPermitsCharge() );
+
+        loopback.setOnline(true);
+        loop();
+
+        REQUIRE( !checkProcessedStartTx );
+        REQUIRE( !checkProcessedStopTx );
+
+        /*
+         * - StartTx works but StopTx fails finally after tx terminated
+         */
+
+        checkProcessedStartTx = false;
+        checkProcessedStopTx = false;
+        
+        beginTransaction_authorized("mIdTag");
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( checkProcessedStartTx );
+
+        loopback.setOnline(false);
+
+        endTransaction();
+        loop();
+        mtime += 10 * 60 * 1000; //jump 10 minutes into future
+
+        loopback.setOnline(true);
+        loop();
+        REQUIRE( !checkProcessedStopTx );
+
+        /*
+         * - sends attempts fail until final attempt succeeds
+         */
+
+        const size_t NUM_ATTEMPTS = 3;
+        const int RETRY_INTERVAL_SECS = 3600;
+
+        declareConfiguration<int>("TransactionMessageAttempts", 0)->setInt(NUM_ATTEMPTS);
+        declareConfiguration<int>("TransactionMessageRetryInterval", 0)->setInt(RETRY_INTERVAL_SECS);
+
+        configuration_save();
+
+        checkProcessedStartTx = false;
+        checkProcessedStopTx = false;
+
+        unsigned int attemptNr = 0;
+
+        getOcppContext()->getOperationRegistry().registerOperation("StartTransaction", [&checkProcessedStartTx, &txId, &attemptNr] () {
+            return new Ocpp16::CustomOperation("StartTransaction",
+                [&attemptNr] (JsonObject payload) {
+                    //receive req
+                    attemptNr++;
+                },
+                [&txId] () {
+                    //create conf
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    JsonObject payload = doc->to<JsonObject>();
+
+                    JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
+                    idTagInfo["status"] = "Accepted";
+                    payload["transactionId"] = txId++;
+                    return doc;
+                },
+                [&attemptNr] () {
+                    //ErrorCode for CALLERROR
+                    return attemptNr < NUM_ATTEMPTS ? "InternalError" : (const char*)nullptr;
+                });});
+        
+        beginTransaction_authorized("mIdTag");
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( attemptNr == 1 );
+
+        mtime += (unsigned long)RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( attemptNr == 2 );
+
+        mtime += 2 * (unsigned long)RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( attemptNr == 3 );
+
+        mtime += 100 * (unsigned long)RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( attemptNr == 3 ); //no further retry after third and successful attempt
+
+        endTransaction();
+        loop();
+        REQUIRE( !ocppPermitsCharge() );
+        REQUIRE( attemptNr == 3 );
+        REQUIRE( checkProcessedStopTx );
+
+        /*
+         * - after reboot, continue attempting
+         */
+
+        getOcppContext()->getModel().getClock().setTime(BASE_TIME); //reset system time to have roughly the same time after reboot
+
+        checkProcessedStartTx = false;
+        checkProcessedStopTx = false;
+        attemptNr = 0;
+
+        beginTransaction_authorized("mIdTag");
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( attemptNr == 1 );
+
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+
+        getOcppContext()->getModel().getClock().setTime(BASE_TIME);
+
+        getOcppContext()->getOperationRegistry().registerOperation("StartTransaction", [&checkProcessedStartTx, &txId, &attemptNr] () {
+            return new Ocpp16::CustomOperation("StartTransaction",
+                [&attemptNr] (JsonObject payload) {
+                    //receive req
+                    attemptNr++;
+                },
+                [&txId] () {
+                    //create conf
+                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    JsonObject payload = doc->to<JsonObject>();
+
+                    JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
+                    idTagInfo["status"] = "Accepted";
+                    payload["transactionId"] = txId++;
+                    return doc;
+                },
+                [&attemptNr] () {
+                    //ErrorCode for CALLERROR
+                    return attemptNr < NUM_ATTEMPTS ? "InternalError" : (const char*)nullptr;
+                });});
+
+        getOcppContext()->getOperationRegistry().registerOperation("StopTransaction", [&checkProcessedStopTx] () {
+            return new Ocpp16::CustomOperation("StopTransaction",
+                [&checkProcessedStopTx] (JsonObject payload) {
+                    //receive req
+                    checkProcessedStopTx = true;
+                }, 
+                [] () {
+                    //create conf
+                    return createEmptyDocument();
+                });});
+
+        loop();
+
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( attemptNr == 1 );
+
+        mtime += (unsigned long)RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( attemptNr == 2 );
+
+        mtime += 2 * (unsigned long)RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( attemptNr == 3 );
+
+        mtime += 100 * (unsigned long)RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE( ocppPermitsCharge() );
+        REQUIRE( attemptNr == 3 ); //no further retry after third and successful attempt
+
+        endTransaction();
+        loop();
+        REQUIRE( !ocppPermitsCharge() );
+        REQUIRE( attemptNr == 3 );
+        REQUIRE( checkProcessedStopTx );
+    }
+
     mocpp_deinitialize();
 }
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 3b3ea50f..1d345c3d 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -112,12 +112,12 @@ TEST_CASE( "Configuration Behavior" ) {
         SECTION("set true") {
             configBool->setBool(true);
 
-            beginTransaction("mIdTag");
+            beginTransaction("mIdTag_invalid");
             loop();
 
             REQUIRE(connector->getStatus() == ChargePointStatus_Available);
 
-            beginTransaction_authorized("mIdTag");
+            beginTransaction_authorized("mIdTag_invalid2");
             loop();
 
             REQUIRE(connector->getStatus() == ChargePointStatus_Available);
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index cec57084..63d744ba 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -223,6 +223,8 @@ TEST_CASE("Metering") {
         auto StopTxnSampledDataString = declareConfiguration<const char*>("StopTxnSampledData", "", CONFIGURATION_FN);
         StopTxnSampledDataString->setString("Energy.Active.Import.Register");
 
+        configuration_save();
+
         loop();
 
         model.getClock().setTime(BASE_TIME);
@@ -244,6 +246,9 @@ TEST_CASE("Metering") {
 
         setOnReceiveRequest("StopTransaction", [base, &checkProcessed] (JsonObject payload) {
             checkProcessed = true;
+
+            REQUIRE(payload["transactionData"].size() >= 2);
+
             Timestamp t0, t1;
             t0.setTime(payload["transactionData"][0]["timestamp"] | "");
             t1.setTime(payload["transactionData"][1]["timestamp"] | "");
diff --git a/tests/Transactions.cpp b/tests/Transactions.cpp
index 8bd88d30..bf071e73 100644
--- a/tests/Transactions.cpp
+++ b/tests/Transactions.cpp
@@ -13,6 +13,7 @@
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Debug.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 

From 211c745a244ef1f61808302eded313a060b50412 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Fri, 2 Aug 2024 13:40:55 +0200
Subject: [PATCH 509/549] Change MicroOcpp into MicroOCPP in non-code texts
 (#347)

---
 README.md                         |  8 +++---
 docs/img/components_overview.svg  |  2 +-
 docs/img/components_selective.svg |  2 +-
 docs/index.md                     |  2 +-
 docs/intro-tech.md                | 44 +++++++++++++++----------------
 docs/migration.md                 | 10 +++----
 docs/modules.md                   | 10 +++----
 docs/prerequisites.md             | 10 +++----
 docs/security.md                  | 18 ++++++-------
 mkdocs.yml                        |  2 +-
 10 files changed, 54 insertions(+), 54 deletions(-)

diff --git a/README.md b/README.md
index 03a91c47..738dd659 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# <img src="https://github.com/matth-x/MicroOcpp/assets/63792403/1c49d1ad-7afc-48d3-a54e-9aef2d4886db" alt="Icon" height="24"> &nbsp; MicroOcpp
+# <img src="https://github.com/matth-x/MicroOcpp/assets/63792403/1c49d1ad-7afc-48d3-a54e-9aef2d4886db" alt="Icon" height="24"> &nbsp; MicroOCPP
 
 [![Build Status]( https://github.com/matth-x/MicroOcpp/workflows/PlatformIO%20CI/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
 [![Unit tests]( https://github.com/matth-x/MicroOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
@@ -18,7 +18,7 @@ Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/mas
 
 *Main repository: [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)*
 
-The Simulator is a demo & development tool for MicroOcpp which allows to quickly assess the compatibility with different OCPP backends. It simulates a full charging station, adds a GUI and a mocked hardware binding to MicroOcpp and runs in the browser (using WebAssembly): [Try it](https://demo.micro-ocpp.com/)
+The Simulator is a demo & development tool for MicroOCPP which allows to quickly assess the compatibility with different OCPP backends. It simulates a full charging station, adds a GUI and a mocked hardware binding to MicroOCPP and runs in the browser (using WebAssembly): [Try it](https://demo.micro-ocpp.com/)
 
 <div align="center"><img src="https://github.com/matth-x/MicroOcpp/assets/63792403/27f2819b-41fd-41a7-88a8-9e673b8a88b8" alt="Screenshot" width="800em" href="https://demo.micro-ocpp.com/"></div>
 
@@ -32,7 +32,7 @@ If you don't have an OCPP server at hand, leave the charge box ID blank and ente
 
 ## Benchmarks
 
-*Full report: [MicroOcpp benchmark (esp-idf)](https://github.com/matth-x/MicroOcpp-benchmark)*
+*Full report: [MicroOCPP benchmark (esp-idf)](https://github.com/matth-x/MicroOcpp-benchmark)*
 
 The following measurements were taken on the ESP32 @ 160MHz and represent the optimistic best case scenario for a charger with two physical connectors (i.e. compiled with `-Os`, disabled debug output and logs).
 
@@ -51,7 +51,7 @@ In practical setups, the execution time is largely determined by IO delays and t
 
 PlatformIO package: [MicroOcpp](https://registry.platformio.org/libraries/matth-x/MicroOcpp)
 
-MicroOcpp is an implementation of the OCPP communication behavior. It automatically initiates the corresponding OCPP operations once the hardware status changes or the RFID input is updated with a new value. Conversely it processes new data from the server, stores it locally and updates the hardware controls when applicable.
+MicroOCPP is an implementation of the OCPP communication behavior. It automatically initiates the corresponding OCPP operations once the hardware status changes or the RFID input is updated with a new value. Conversely it processes new data from the server, stores it locally and updates the hardware controls when applicable.
 
 Please take `examples/ESP/main.cpp` as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in [`MicroOcpp.h`](https://github.com/matth-x/MicroOcpp/blob/main/src/MicroOcpp.h). Also check out the [Docs](https://matth-x.github.io/MicroOcpp).
 
diff --git a/docs/img/components_overview.svg b/docs/img/components_overview.svg
index d5dbf07f..a6423759 100644
--- a/docs/img/components_overview.svg
+++ b/docs/img/components_overview.svg
@@ -1,3 +1,3 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="335px" height="391px" viewBox="-0.5 -0.5 335 391"><defs/><g><rect x="-0.4" y="0" width="333.4" height="390" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="33" y="70" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 77px; margin-left: 34px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp library</div></div></div></foreignObject><text x="163" y="89" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp library</text></switch></g><rect x="43" y="110" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 135px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp API</div></div></div></foreignObject><text x="163" y="139" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp API</text></switch></g><rect x="43" y="170" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 195px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="163" y="199" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="43" y="230" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 255px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="163" y="259" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="73" y="20" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 35px; margin-left: 74px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware (main source)</div></div></div></foreignObject><text x="145" y="39" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware (main source)</text></switch></g><rect x="71.4" y="330" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 355px; margin-left: 72px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="163" y="359" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 145.47 50 L 152.25 113.67" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 152.8 118.89 L 148.58 112.3 L 152.25 113.67 L 155.54 111.56 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 163 290 L 163 323.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 163 328.88 L 159.5 321.88 L 163 323.63 L 166.5 321.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="335px" height="391px" viewBox="-0.5 -0.5 335 391"><defs/><g><rect x="-0.4" y="0" width="333.4" height="390" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="33" y="70" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 77px; margin-left: 34px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOCPP library</div></div></div></foreignObject><text x="163" y="89" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOCPP library</text></switch></g><rect x="43" y="110" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 135px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOCPP API</div></div></div></foreignObject><text x="163" y="139" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOCPP API</text></switch></g><rect x="43" y="170" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 195px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="163" y="199" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="43" y="230" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 255px; margin-left: 44px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="163" y="259" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="73" y="20" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 35px; margin-left: 74px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware (main source)</div></div></div></foreignObject><text x="145" y="39" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware (main source)</text></switch></g><rect x="71.4" y="330" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 355px; margin-left: 72px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="163" y="359" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 145.47 50 L 152.25 113.67" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 152.8 118.89 L 148.58 112.3 L 152.25 113.67 L 155.54 111.56 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 163 290 L 163 323.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 163 328.88 L 159.5 321.88 L 163 323.63 L 166.5 321.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
diff --git a/docs/img/components_selective.svg b/docs/img/components_selective.svg
index e2dedf65..7788f100 100644
--- a/docs/img/components_selective.svg
+++ b/docs/img/components_selective.svg
@@ -1,3 +1,3 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="603px" height="402px" viewBox="-0.5 -0.5 603 402"><defs/><g><rect x="17" y="0" width="580" height="400" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="27" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp library</div></div></div></foreignObject><text x="157" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp library</text></switch></g><rect x="37" y="130" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp API</div></div></div></foreignObject><text x="157" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp API</text></switch></g><rect x="37" y="190" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="157" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="37" y="250" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="157" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="0" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 1px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="72" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="65.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 66px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="157" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 157 310 L 157 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 157 348.88 L 153.5 341.88 L 157 343.63 L 160.5 341.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 72.47 70 L 86.44 253.65" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 86.84 258.89 L 82.81 252.17 L 86.44 253.65 L 89.79 251.64 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="327" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 328px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp library</div></div></div></foreignObject><text x="457" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp library</text></switch></g><rect x="337" y="130" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOcpp API</div></div></div></foreignObject><text x="457" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOcpp API</text></switch></g><rect x="337" y="190" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="457" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="337" y="250" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="457" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="457" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 458px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="529" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="365.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 366px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="457" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 457 310 L 457 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 457 348.88 L 453.5 341.88 L 457 343.63 L 460.5 341.88 Z" fill-opacity="0.1" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="all"/><path d="M 529.47 70 L 517.98 143.71" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 517.17 148.9 L 514.79 141.44 L 517.98 143.71 L 521.71 142.52 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 448.42 270.5 L 465 270.5 L 465 318.36 L 475.5 318.36 L 456.71 339.5 L 437.92 318.36 L 448.42 318.36 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="397" y="344" width="120" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 359px; margin-left: 398px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">custom RPC framework</div></div></div></foreignObject><text x="457" y="363" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">custom RPC framework</text></switch></g><path d="M 307 70 L 307 330" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><rect x="27" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example A) Only RPC framework selected</div></div></div></foreignObject><text x="167" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example A) Only RPC framework selected</text></switch></g><rect x="307" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 308px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example B) OCPP logic selected</div></div></div></foreignObject><text x="447" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example B) OCPP logic selected</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="603px" height="402px" viewBox="-0.5 -0.5 603 402"><defs/><g><rect x="17" y="0" width="580" height="400" fill-opacity="0.9" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="27" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOCPP library</div></div></div></foreignObject><text x="157" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOCPP library</text></switch></g><rect x="37" y="130" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOCPP API</div></div></div></foreignObject><text x="157" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOCPP API</text></switch></g><rect x="37" y="190" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="157" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="37" y="250" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 38px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="157" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="0" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 1px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="72" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="65.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 66px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="157" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 157 310 L 157 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 157 348.88 L 153.5 341.88 L 157 343.63 L 160.5 341.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 72.47 70 L 86.44 253.65" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 86.84 258.89 L 82.81 252.17 L 86.44 253.65 L 89.79 251.64 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="327" y="90" width="260" height="220" rx="4.4" ry="4.4" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 97px; margin-left: 328px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOCPP library</div></div></div></foreignObject><text x="457" y="109" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOCPP library</text></switch></g><rect x="337" y="130" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 155px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">MicroOCPP API</div></div></div></foreignObject><text x="457" y="159" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">MicroOCPP API</text></switch></g><rect x="337" y="190" width="240" height="50" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 215px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">OCPP behavior and device model</div></div></div></foreignObject><text x="457" y="219" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">OCPP behavior and device model</text></switch></g><rect x="337" y="250" width="240" height="50" fill-opacity="0.1" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 275px; margin-left: 338px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Remote Procedure Call (RPC) framework</div></div></div></foreignObject><text x="457" y="279" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Remote Procedure Call (RPC) framework</text></switch></g><rect x="457" y="40" width="144.95" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 143px; height: 1px; padding-top: 55px; margin-left: 458px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Firmware<br />(main source)</div></div></div></foreignObject><text x="529" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Firmware...</text></switch></g><rect x="365.4" y="350" width="183.2" height="50" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)" opacity="0.1"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 181px; height: 1px; padding-top: 375px; margin-left: 366px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">WebSocket library,<br />filesystem access,<br />system clock</div></div></div></foreignObject><text x="457" y="379" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">WebSocket library,...</text></switch></g><path d="M 457 310 L 457 343.63" fill="none" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 457 348.88 L 453.5 341.88 L 457 343.63 L 460.5 341.88 Z" fill-opacity="0.1" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-opacity="0.1" stroke-miterlimit="10" pointer-events="all"/><path d="M 529.47 70 L 517.98 143.71" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 517.17 148.9 L 514.79 141.44 L 517.98 143.71 L 521.71 142.52 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 448.42 270.5 L 465 270.5 L 465 318.36 L 475.5 318.36 L 456.71 339.5 L 437.92 318.36 L 448.42 318.36 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="397" y="344" width="120" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 359px; margin-left: 398px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">custom RPC framework</div></div></div></foreignObject><text x="457" y="363" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">custom RPC framework</text></switch></g><path d="M 307 70 L 307 330" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><rect x="27" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 28px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example A) Only RPC framework selected</div></div></div></foreignObject><text x="167" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example A) Only RPC framework selected</text></switch></g><rect x="307" y="0" width="280" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 15px; margin-left: 308px;"><div style="box-sizing: border-box; font-size: 0px; text-align: center;" data-drawio-colors="color: rgb(0, 0, 0); "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-style: italic; white-space: normal; overflow-wrap: normal;">Example B) OCPP logic selected</div></div></div></foreignObject><text x="447" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-style="italic">Example B) OCPP logic selected</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
index f87f6ccc..3705cfff 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,4 +1,4 @@
-MicroOcpp is an OCPP client which runs on microcontrollers and enables EVSEs to participate in OCPP charging networks. As a software library, it can be added to the firmware of the EVSE and will become a new part of it. If the EVSE has already an internet controller, then most likely, no extra hardware is required.
+MicroOCPP is an OCPP client which runs on microcontrollers and enables EVSEs to participate in OCPP charging networks. As a software library, it can be added to the firmware of the EVSE and will become a new part of it. If the EVSE has already an internet controller, then most likely, no extra hardware is required.
 
 [Technical introduction](intro-tech)
 
diff --git a/docs/intro-tech.md b/docs/intro-tech.md
index 451e5ac9..d99457f5 100644
--- a/docs/intro-tech.md
+++ b/docs/intro-tech.md
@@ -1,14 +1,14 @@
 # Technical introduction
 
-This chapter covers the technical concepts of MicroOcpp.
+This chapter covers the technical concepts of MicroOCPP.
 
-## Scope of MicroOcpp
+## Scope of MicroOCPP
 
-The OCPP specification defines a charger data model, operations on the data model and the resulting physical behavior on the charger side. MicroOcpp implements the full scope of OCPP, i.e. a minimalistic data store for the data model, the OCPP operations and an interface to the surrounding firmware.
+The OCPP specification defines a charger data model, operations on the data model and the resulting physical behavior on the charger side. MicroOCPP implements the full scope of OCPP, i.e. a minimalistic data store for the data model, the OCPP operations and an interface to the surrounding firmware.
 
-Another part of OCPP is its messaging mechanism, the so-called Remote Procedure Calls (RPC) framework. MicroOcpp also implements the specified RPC framework with the required guarantees of message delivery or the corresponding error handling.
+Another part of OCPP is its messaging mechanism, the so-called Remote Procedure Calls (RPC) framework. MicroOCPP also implements the specified RPC framework with the required guarantees of message delivery or the corresponding error handling.
 
-At the lowest layer, OCPP relies on standard WebSockets. MicroOcpp works with any WebSocket library and has a lean interface to integrate them.
+At the lowest layer, OCPP relies on standard WebSockets. MicroOCPP works with any WebSocket library and has a lean interface to integrate them.
 
 The high-level API in `MicroOcpp.h` bundles all touch points of the EVSE firmware with the OCPP library.
 
@@ -20,7 +20,7 @@ The high-level API in `MicroOcpp.h` bundles all touch points of the EVSE firmwar
 
 ## High-level OCPP support
 
-Being a full implementation of OCPP, MicroOcpp handles the OCPP communication, i.e. it sends OCPP requests and processes incoming OCPP requests autonomously. The messages are triggered by the internal data model and by input from the high-level API. Incoming OCPP requests are used to update the internal data model and if an action on the charger is required, the library signals that to the main firmware through the high-level API.
+Being a full implementation of OCPP, MicroOCPP handles the OCPP communication, i.e. it sends OCPP requests and processes incoming OCPP requests autonomously. The messages are triggered by the internal data model and by input from the high-level API. Incoming OCPP requests are used to update the internal data model and if an action on the charger is required, the library signals that to the main firmware through the high-level API.
 
 In consequence, the high-level API decouples the main firmware from the OCPP communication and hides the operations. This has the following good reasons:
 
@@ -30,56 +30,56 @@ In consequence, the high-level API decouples the main firmware from the OCPP com
 
 ## Customizability
 
-One core principle of the architecture of MicroOcpp is the customizability and the selective usage of its components.
+One core principle of the architecture of MicroOCPP is the customizability and the selective usage of its components.
 
-Selective usage of components means that the EVSE firmware can use parts of MicroOcpp and work with its own implementation for the rest. In that case only the selected parts of MicroOcpp will be compiled into the firmware. For example, the main firmware can use the RPC framework and build a custom implementation of the OCPP logic on top of it. This could be necessary if the OCPP behavior should be tightly coupled to other modules of the firmware. In a different scenario, the EVSE firmware could already contain an extensive RPC framework and the OCPP client should reuse it. Then, only the business logic and high-level API are of interest.
+Selective usage of components means that the EVSE firmware can use parts of MicroOCPP and work with its own implementation for the rest. In that case only the selected parts of MicroOCPP will be compiled into the firmware. For example, the main firmware can use the RPC framework and build a custom implementation of the OCPP logic on top of it. This could be necessary if the OCPP behavior should be tightly coupled to other modules of the firmware. In a different scenario, the EVSE firmware could already contain an extensive RPC framework and the OCPP client should reuse it. Then, only the business logic and high-level API are of interest.
 
 <p style="text-align:center">
     <img src="../img/components_selective.svg">
     <br />
-    <em>Selective usage of MicroOcpp</em>
+    <em>Selective usage of MicroOCPP</em>
 </p>
 
-Customizations of the library allow to integrate use cases for which the high-level API is too restrictive. The high-level API is designed to provide a facade for the expected usage of the library, but since the charging sector is driven by innovation, new use cases for OCPP emerge every day. If a custom use case cannot be integrated on the API level, the main firmware can access the internal data structures of MicroOcpp and complement the required functionality or replace parts of the internal behavior with custom implementations which fits the concrete scenarios better.
+Customizations of the library allow to integrate use cases for which the high-level API is too restrictive. The high-level API is designed to provide a facade for the expected usage of the library, but since the charging sector is driven by innovation, new use cases for OCPP emerge every day. If a custom use case cannot be integrated on the API level, the main firmware can access the internal data structures of MicroOCPP and complement the required functionality or replace parts of the internal behavior with custom implementations which fits the concrete scenarios better.
 
 ## Main-loop paradigm
 
-MicroOcpp works with the common main-loop execution model of microcontrollers. After initialization, the EVSE firmware most likely enters a main-loop and repeats it infinitely. To run MicroOcpp, a call to its loop function must be placed into the main loop of the firmware. Then at each main-loop iteration, MicroOcpp executes its internal routines, i.e. it processes input data, updates its data model, executes operations and creates new output data. The MicroOcpp loop function does not block the main loop but executes immediately. This library does not contain any delay functions. Some activities of the library spread over many loop iterations like the start of a charging session which needs to await the approval of an NFC card and a hardware diagnosis of the high power electronics for example. All activities in MicroOcpp support the distribution over many loop calls, leading to a pseudo-parallel execution behavior.
+MicroOCPP works with the common main-loop execution model of microcontrollers. After initialization, the EVSE firmware most likely enters a main-loop and repeats it infinitely. To run MicroOCPP, a call to its loop function must be placed into the main loop of the firmware. Then at each main-loop iteration, MicroOCPP executes its internal routines, i.e. it processes input data, updates its data model, executes operations and creates new output data. The MicroOCPP loop function does not block the main loop but executes immediately. This library does not contain any delay functions. Some activities of the library spread over many loop iterations like the start of a charging session which needs to await the approval of an NFC card and a hardware diagnosis of the high power electronics for example. All activities in MicroOCPP support the distribution over many loop calls, leading to a pseudo-parallel execution behavior.
 
-No separate RTOS task is needed and MicroOcpp does not have an internal mechanism for multi-task synchronization. However, it is of course possible to create a dedicated OCPP task, as long as extra care is taken of the synchronization.
+No separate RTOS task is needed and MicroOCPP does not have an internal mechanism for multi-task synchronization. However, it is of course possible to create a dedicated OCPP task, as long as extra care is taken of the synchronization.
 
 ## How the API works
 
 The high-level API consists of four parts:
 
 - **Library lifecycle**: The library has initialize functions with a few initialization options. Dynamic system components like the WebSocket adapter need to be set at initialization time. The deinitialize function reverts the library into an unitialized state. That's useful for memory inspection tools like valgrind or to disable the OCPP communication. The loop function also counts as part of the lifecycle management.
-- **Sensor Inputs**: EVSEs are mechanical systems with a variety of sensor information. OCPP is used to send parts of the sensor readings to the server. The other part of the sensor data flows into the local charger model of MicroOcpp where it is further processed. To update MicroOcpp with the input data from the sensors, the firmware needs to bind the sensors to the library. An *Input-binding*, or in short *Input*, is a function which transfers the current sensor value to MicroOcpp. Inputs are callback functions which read a specific sensor value and pass the value in the return statement. The firmware defines those callback functions for each sensor and adds them to MicroOcpp during initialization. After initialization, MicroOcpp uses the callbacks and executes them to fetch the most recent sensor values. <br/>
-This concept is reused for the data *Outputs* of the library to the firmware, where the callback applies output data from MicroOcpp to the firmware.
-- **Transaction management**: OCPP considers EVSEs as vending machines. To enable payment processing and the billing of the EVSE usage, all charging activity is assigned to transactions. A big portion of OCPP is about transactions, their prerequisites, runtime and their termination scenarios. The MicroOcpp API breaks transactions down into an initiation and termination function and gives a transparent view on the current process status, authorization result and offline behavior strategy. For non-commercial setups, the transaction mechanism is the same but has only informational purposes.
-- **Device management**: MicroOcpp implements the OCPP side of the device management operations. For the actual execution, the firmware needs to provide the charger-side implementations of the operations to MicroOcpp by passing handler functions to the API. For example, the OCPP server can restart the charger. Upon receipt of the request, MicroOcpp terminates the transactions and eventually triggers the system restart using the handler function which the firmware has provided through the high-level API.
+- **Sensor Inputs**: EVSEs are mechanical systems with a variety of sensor information. OCPP is used to send parts of the sensor readings to the server. The other part of the sensor data flows into the local charger model of MicroOCPP where it is further processed. To update MicroOCPP with the input data from the sensors, the firmware needs to bind the sensors to the library. An *Input-binding*, or in short *Input*, is a function which transfers the current sensor value to MicroOCPP. Inputs are callback functions which read a specific sensor value and pass the value in the return statement. The firmware defines those callback functions for each sensor and adds them to MicroOCPP during initialization. After initialization, MicroOCPP uses the callbacks and executes them to fetch the most recent sensor values. <br/>
+This concept is reused for the data *Outputs* of the library to the firmware, where the callback applies output data from MicroOCPP to the firmware.
+- **Transaction management**: OCPP considers EVSEs as vending machines. To enable payment processing and the billing of the EVSE usage, all charging activity is assigned to transactions. A big portion of OCPP is about transactions, their prerequisites, runtime and their termination scenarios. The MicroOCPP API breaks transactions down into an initiation and termination function and gives a transparent view on the current process status, authorization result and offline behavior strategy. For non-commercial setups, the transaction mechanism is the same but has only informational purposes.
+- **Device management**: MicroOCPP implements the OCPP side of the device management operations. For the actual execution, the firmware needs to provide the charger-side implementations of the operations to MicroOCPP by passing handler functions to the API. For example, the OCPP server can restart the charger. Upon receipt of the request, MicroOCPP terminates the transactions and eventually triggers the system restart using the handler function which the firmware has provided through the high-level API.
 
 ## Transaction safety
 
 Software in EVSEs needs to withstand hazardous operating conditions. EVSEs are located on the street or in garages where the WiFi or LTE signal strength is often weak, leading to long offline periods or where random power cuts can occur. In addition to that, the lack of process virtualization on microcontrollers means that a malfunction in one part of the firmware leads to the crash of all other parts.
 
-The transaction process of MicroOcpp is robust against random failures or resets. A minimal transaction log on the flash storage ensures that each operation on a transaction is fully executed. It will always result in a consistent state between the EVSE and the OCPP server, even over resets of the microcontroller. The RPC queue facilitates this by tracking the delivery status of relevant messages. If the microcontroller is reset while the delivery status of a message is unknown, MicroOcpp takes up the message delivery again at the next start up and completes it.
+The transaction process of MicroOCPP is robust against random failures or resets. A minimal transaction log on the flash storage ensures that each operation on a transaction is fully executed. It will always result in a consistent state between the EVSE and the OCPP server, even over resets of the microcontroller. The RPC queue facilitates this by tracking the delivery status of relevant messages. If the microcontroller is reset while the delivery status of a message is unknown, MicroOCPP takes up the message delivery again at the next start up and completes it.
 
 A requirement for the transaction safety feature is the availability of a journaling file system. Examples include LittleFS, SPIFFS and the POSIX file API, but some microcontroller platforms don't support this natively, so an extension would be required.
 
 ## Unit testing
 
-MicroOcpp includes a number of unit tests based on the [Catch2](https://github.com/catchorg/Catch2) framework. A [GitHub Action](https://github.com/matth-x/MicroOcpp/actions) runs the unit tests against each new commit in the MicroOcpp repository, which ensures that new features don't break old code.
+MicroOCPP includes a number of unit tests based on the [Catch2](https://github.com/catchorg/Catch2) framework. A [GitHub Action](https://github.com/matth-x/MicroOcpp/actions) runs the unit tests against each new commit in the MicroOCPP repository, which ensures that new features don't break old code.
 
 The scope of the unit tests is to to ensure a correct implementation of OCPP and to validate the high-level API against its definition. For that, it is not necessary to establish an actual test connection to an OCPP server. In fact, real-world communication would disturb the tests and make them undeterministic. That's why the test suite is fully based on an integrated, tiny OCPP test server which the OCPP client reaches over a loopback connection. The test suite does not access the WebSocket library. When making the unit tests of the main firmware, it is not necessary to check the full OCPP communication, but only to validate correct usage of the high-level API. An example of how the library can be initialized with a loopback connection can be found in its test suite.
 
 ## Microcontroller optimization
 
-As a library for microcontrollers, the design of MicroOcpp considers the strict memory limits and complies with the best practices of embedded software development. Also, a few measures were taken to optimize the memory usage which include the spare inclusion of external libraries, an optimization of the internal data structures and the exclusion of C++ run-time type information (RTTI) and exceptions. Features of C++ which may have a larger footprint are carefully used such as the standard template library (STL) and lambda functions. The STL increases the robustness of the code and lambdas prove to be a powerful tool to deal with the complexity of asynchronous data processing in embedded systems. That's also why the high-level API has many functional parameters.
+As a library for microcontrollers, the design of MicroOCPP considers the strict memory limits and complies with the best practices of embedded software development. Also, a few measures were taken to optimize the memory usage which include the spare inclusion of external libraries, an optimization of the internal data structures and the exclusion of C++ run-time type information (RTTI) and exceptions. Features of C++ which may have a larger footprint are carefully used such as the standard template library (STL) and lambda functions. The STL increases the robustness of the code and lambdas prove to be a powerful tool to deal with the complexity of asynchronous data processing in embedded systems. That's also why the high-level API has many functional parameters.
 
-Because of the high importance of C in the embedded world, MicroOcpp provides its high-level API in C too. It is typically simple to instruct the compiler to compile and link the C++-based library in a C-based firmware development. In case that the firmware requires custom features which are not part of the C-API, then the firmware can implement it in a new C++ source file, export the new functions to the C namespace and use it normally in the main source.
+Because of the high importance of C in the embedded world, MicroOCPP provides its high-level API in C too. It is typically simple to instruct the compiler to compile and link the C++-based library in a C-based firmware development. In case that the firmware requires custom features which are not part of the C-API, then the firmware can implement it in a new C++ source file, export the new functions to the C namespace and use it normally in the main source.
 
 While memory constraints are of concern, the execution time generally is not. OCPP is rather uncomplex on the algorithmic side for clients, since there is no need for elaborate planning algorithms or complex data transformations.
 
-Low resource requirements also allow new usage areas on top of EV charging. For example, MicroOcpp has been ported to ordinary IoT equipment such as Wi-Fi sockets to integrate further electric devices into OCPP networks.
+Low resource requirements also allow new usage areas on top of EV charging. For example, MicroOCPP has been ported to ordinary IoT equipment such as Wi-Fi sockets to integrate further electric devices into OCPP networks.
 
-Although MicroOcpp is optimized for the usage on microcontrollers, it is also suitable for embedded Linux systems. With more memory available, the upper limits of the internal data structures can be increased, leading to a more versatile support of charging use cases. Also, the separation of the charger firmware into multiple processes can lead to more robustness. MicroOcpp can be extended by an inter-process communication (IPC) interface to run in a separate process.
+Although MicroOCPP is optimized for the usage on microcontrollers, it is also suitable for embedded Linux systems. With more memory available, the upper limits of the internal data structures can be increased, leading to a more versatile support of charging use cases. Also, the separation of the charger firmware into multiple processes can lead to more robustness. MicroOCPP can be extended by an inter-process communication (IPC) interface to run in a separate process.
diff --git a/docs/migration.md b/docs/migration.md
index 49cc82dd..8db223f8 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -1,23 +1,23 @@
 # Migrating to v1.1
 
-As a new minor version, all features should work the same as in v1.0 and existing integrations are mostly backwards compatible. However, some fixes / cleanup steps in MicroOcpp require syntactic changes or special consideration when upgrading from v1.0 to v1.1. The known pitfalls are as follows:
+As a new minor version, all features should work the same as in v1.0 and existing integrations are mostly backwards compatible. However, some fixes / cleanup steps in MicroOCPP require syntactic changes or special consideration when upgrading from v1.0 to v1.1. The known pitfalls are as follows:
 
 - The default branch has been renamed from `master` into `main`
 - Need to include extra headers: the transitive includes have been cleaned a bit. Probably it's necessary to add more includes next to `#include <MicroOcpp.h>`. E.g.<br/>`#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>`<br/>`#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>`
-- `ocppPermitsCharge()` does not consider failures reported by the charger anymore. Before v1.1 it was possible to report failures to MicroOcpp using ErrorCodeInputs and then to rely on `ocppPermitsCharge()` becoming false when a failure occurs. For backwards compatibility, complement any occurence to `ocppPermitsCharge() && !isFaulted()`
+- `ocppPermitsCharge()` does not consider failures reported by the charger anymore. Before v1.1 it was possible to report failures to MicroOCPP using ErrorCodeInputs and then to rely on `ocppPermitsCharge()` becoming false when a failure occurs. For backwards compatibility, complement any occurence to `ocppPermitsCharge() && !isFaulted()`
 - `setEnergyMeterInput` changed the expected return type of the callback function from `float` to `int` (see [#301](https://github.com/matth-x/MicroOcpp/pull/301))
 - The return type of the UnlockConnector handler also changed from `PollResult<bool>` to enum `UnlockConnectorResult` (see [#271](https://github.com/matth-x/MicroOcpp/pull/271))
 
 If upgrading MicroOcppMongoose at the same time, then the following changes are very important to consider:
 
 - Certificates are no longer copied into heap memory, but the MO-Mongoose class takes the passed certificate pointer as a zero-copy parameter. The string behind the passed pointer must outlive the MO-Mongoose class (see [#10](https://github.com/matth-x/MicroOcppMongoose/pull/10))
-- WebSocket authorization keys are no longer stored as c-strings, but as `unsigned char` buffers. For backwards compatibility, a null-byte is still appended and the buffer can be accessed as c-string, but this should be tested in existing deployments. Furtermore, MicroOcpp only accepts hex-encoded keys coming via ChangeConfiguration which is mandated by the standard. This also may break existing deployments (see [#4](https://github.com/matth-x/MicroOcppMongoose/pull/4)).
+- WebSocket authorization keys are no longer stored as c-strings, but as `unsigned char` buffers. For backwards compatibility, a null-byte is still appended and the buffer can be accessed as c-string, but this should be tested in existing deployments. Furtermore, MicroOCPP only accepts hex-encoded keys coming via ChangeConfiguration which is mandated by the standard. This also may break existing deployments (see [#4](https://github.com/matth-x/MicroOcppMongoose/pull/4)).
 
-If accessing the MicroOcpp modules directly (i.e. not over `MicroOcpp.h` or `MicroOcpp_c.h`) then there are likely some more modifications to be done. See the history of pull requests where each change to the code is documented. However, if the existing integration compiles under the new MO version, then there shouldn't be too many unexpected incompatibilities.
+If accessing the MicroOCPP modules directly (i.e. not over `MicroOcpp.h` or `MicroOcpp_c.h`) then there are likely some more modifications to be done. See the history of pull requests where each change to the code is documented. However, if the existing integration compiles under the new MO version, then there shouldn't be too many unexpected incompatibilities.
 
 ## Migrating to v1.0
 
-The API has been continously improved to best suit the common use cases for MicroOcpp. Moreover, the project has been given a new name to prevent confusion with the relation to the Arduino platform and to reflect the project goals properly. With the new project name, the API has been frozen for the v1.0 release.
+The API has been continously improved to best suit the common use cases for MicroOCPP. Moreover, the project has been given a new name to prevent confusion with the relation to the Arduino platform and to reflect the project goals properly. With the new project name, the API has been frozen for the v1.0 release.
 
 ### Adopting the new project name in existing projects
 
diff --git a/docs/modules.md b/docs/modules.md
index 5fa0a21b..47d2abe2 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -1,10 +1,10 @@
 # Modules
 
-This chapter gives an overview of the class structure of MicroOcpp.
+This chapter gives an overview of the class structure of MicroOCPP.
 
 ## Context
 
-The *Context* contains all runtime data of MicroOcpp. Every data object which this library creates is stored in the Context instance, except only the Configuration. So it is the basic entry point to the internals of the library. The structure of the context follows the main architecture as described in [this introduction](intro-tech) and consists of the Request queue and message deserializer for the RPC framework and the Model object for the OCPP model and behavior (see below).
+The *Context* contains all runtime data of MicroOCPP. Every data object which this library creates is stored in the Context instance, except only the Configuration. So it is the basic entry point to the internals of the library. The structure of the context follows the main architecture as described in [this introduction](intro-tech) and consists of the Request queue and message deserializer for the RPC framework and the Model object for the OCPP model and behavior (see below).
 
 When the library is initialized, `getOcppContext()` returns the current Context object.
 
@@ -12,7 +12,7 @@ When the library is initialized, `getOcppContext()` returns the current Context
 
 The *Model* represents the OCPP device model and behavior. OCPP defines a rough charger model, i.e. the hardware parts of the charger and their basic functionality in relation to the OCPP operations. Furthermore, OCPP specifies a few only software related features like the reservation of the charger. This charger model is implemented as straightforward C++ data structures and corresponding algorithms.
 
-The implementation of the Model is structured into a top-level Model class and the subordinate Service classes. Each Service class represents a functional block of the OCPP specification and implements the corresponding data structures and functionality. The definition of the functional blocks in MicroOcpp is very similar to the feature profiles in OCPP. Only the Core profile is split into multiple functional blocks to keep a smaller module scope.
+The implementation of the Model is structured into a top-level Model class and the subordinate Service classes. Each Service class represents a functional block of the OCPP specification and implements the corresponding data structures and functionality. The definition of the functional blocks in MicroOCPP is very similar to the feature profiles in OCPP. Only the Core profile is split into multiple functional blocks to keep a smaller module scope.
 
 The following list contains the resulting functional blocks:
 
@@ -39,7 +39,7 @@ Every OCPP operation (e.g. Heartbeat, BootNotification) has a dedicated class fo
 
 To send operations to the OCPP server, they must be wrapped into a Request object. The RPC framework and operations are separated modules. While the RPC framework (including the Request class) deals with the messaging mechanism and transfering data to the other OCPP device, operations define the effect on the OCPP model and data structure and execute the desired action. The operation classes inherit from *Operation* which is the interface visible to the Request class.
 
-Incoming messages are unmarshalled using the *OperationRegistry*. During the initialization phase of the library, the Model classes register all supported operations with their name and an instantiator. The instantiator, when executed, provides the Request interpreter with an instance of the corresponding Operation subclasses. It is possible to extend MicroOcpp by adding new Operation instantiators to the registry, or to modify the behavior by overriding the default Operation implementations. In addition to that, event handlers can be set which the RPC queue will notify with the payload once operations are sent or received.
+Incoming messages are unmarshalled using the *OperationRegistry*. During the initialization phase of the library, the Model classes register all supported operations with their name and an instantiator. The instantiator, when executed, provides the Request interpreter with an instance of the corresponding Operation subclasses. It is possible to extend MicroOCPP by adding new Operation instantiators to the registry, or to modify the behavior by overriding the default Operation implementations. In addition to that, event handlers can be set which the RPC queue will notify with the payload once operations are sent or received.
 
 ## Configuration
 
@@ -53,4 +53,4 @@ Configurations like the HeartbeatInterval are managed by the *Configuration* mod
 
 If another storage implementation is required (e.g. for syncing with an external configuration manager), then it's possible to add a custom ConfigurationContainer.
 
-In the initialization phase, MicroOcpp loads the built-in Configurations with hard-coded factory defaults and a default storage structure. To customize the factory defaults or which ConfigurationContainers will be used, the Configuration module must be initialized before loading the library. To do so, call `configuration_init(...)`. Then the factory defaults can be applied by calling `declareConfiguration<T>(...)` with the desired default value. To use a custom ConfigurationContainer, call `addConfigurationContainer(...)` with the custom implementation. When the library is loaded afterwards, it will use the previously provided Configurations / Containers and create only the data structure which hasn't been set already.
+In the initialization phase, MicroOCPP loads the built-in Configurations with hard-coded factory defaults and a default storage structure. To customize the factory defaults or which ConfigurationContainers will be used, the Configuration module must be initialized before loading the library. To do so, call `configuration_init(...)`. Then the factory defaults can be applied by calling `declareConfiguration<T>(...)` with the desired default value. To use a custom ConfigurationContainer, call `addConfigurationContainer(...)` with the custom implementation. When the library is loaded afterwards, it will use the previously provided Configurations / Containers and create only the data structure which hasn't been set already.
diff --git a/docs/prerequisites.md b/docs/prerequisites.md
index 3abcd786..4cc63613 100644
--- a/docs/prerequisites.md
+++ b/docs/prerequisites.md
@@ -4,27 +4,27 @@ This page explains how to work with this library using the appropriate developme
 
 ## Development tools prerequisites
 
-Throughout these document pages, it is assumed that you already have set up your development environment and that you are familiar with the corresponding building, flashing and (basic) debugging routines. MicroOcpp runs in many environments (from the Arduino-IDE to proprietary microcontroller IDEs like the Code Composer Studio). If you do not have any preferences yet, it is highly recommended to get started with VSCode + the PlatformIO add-on, since it is the favorite setup of the community and therefore you find the most related information in the Issues pages of the main repository.
+Throughout these document pages, it is assumed that you already have set up your development environment and that you are familiar with the corresponding building, flashing and (basic) debugging routines. MicroOCPP runs in many environments (from the Arduino-IDE to proprietary microcontroller IDEs like the Code Composer Studio). If you do not have any preferences yet, it is highly recommended to get started with VSCode + the PlatformIO add-on, since it is the favorite setup of the community and therefore you find the most related information in the Issues pages of the main repository.
 
 There are many high-quality tutorials for out there for setting up VSCode + PIO. The following site covers everything you need to know:
 [https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/](https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/)
 
-Once that's done, adding MicroOcpp is no big deal anymore. However, let's discuss another very important tool for your project first.
+Once that's done, adding MicroOCPP is no big deal anymore. However, let's discuss another very important tool for your project first.
 
 ## OCPP Server prerequisites
 
-MicroOcpp is just a client, but all the magic of OCPP lives in the communication between a client and a server. Although it *is* possible to run MicroOcpp without a real server for testing purposes, the best approach for getting started is to get the hands on a real server. So you can always use the client in a practical setup, see immediate results and simplify development a lot.
+MicroOCPP is just a client, but all the magic of OCPP lives in the communication between a client and a server. Although it *is* possible to run MicroOCPP without a real server for testing purposes, the best approach for getting started is to get the hands on a real server. So you can always use the client in a practical setup, see immediate results and simplify development a lot.
 
 Perhaps you were already given access to an OCPP server for your project. Then you can use that, it should work fine. If you don't have a server already, it is highly recommended to get
 SteVe ([https://github.com/steve-community/steve](https://github.com/steve-community/steve)).
 It allows to control every detail of the OCPP operations and shows detail-rich information about the results. And again, it is the favorite test server of the community, so you will find the most related information on the Web. For the installation instructions, please refer to the
 [SteVe docs](https://github.com/steve-community/steve#configuration-and-installation).
 
-In case you can't wait to get started, you can make the first connection test with a WebSocket echo server as a fake OCPP service. MicroOcpp supports that: it can send all messages to an echo server which reflects all traffic. MicroOcpp gets back its own messages and replies to itself with mocked responses. Complicated, but it does work and the console will show a valid OCPP communication. An example echo server is given in the following section. For the further development though, you will definitely need a real OCPP server.
+In case you can't wait to get started, you can make the first connection test with a WebSocket echo server as a fake OCPP service. MicroOCPP supports that: it can send all messages to an echo server which reflects all traffic. MicroOCPP gets back its own messages and replies to itself with mocked responses. Complicated, but it does work and the console will show a valid OCPP communication. An example echo server is given in the following section. For the further development though, you will definitely need a real OCPP server.
 
 ## Project structure
 
-MicroOcpp is a library, i.e. it is not a full firmware, but just solves one specific task in your project which is the OCPP connectivity. The project structure should reflect this: typically you download MicroOcpp into a libraries or dependencies subfolder, while the main part of the development takes place in a main source folder. All dependencies of MicroOcpp (i.e. ArduinoJson, see the dependencies sections) should be located in the same libraries or dependencies folder.
+MicroOCPP is a library, i.e. it is not a full firmware, but just solves one specific task in your project which is the OCPP connectivity. The project structure should reflect this: typically you download MicroOCPP into a libraries or dependencies subfolder, while the main part of the development takes place in a main source folder. All dependencies of MicroOCPP (i.e. ArduinoJson, see the dependencies sections) should be located in the same libraries or dependencies folder.
 
 When the include paths are correctly set up, you should be able `#include <MicroOcpp.h>` at the top of your own source files. This setup keeps the OCPP library source separate from your integration and gives the project a clear structure.
 
diff --git a/docs/security.md b/docs/security.md
index 0537436a..d4838580 100644
--- a/docs/security.md
+++ b/docs/security.md
@@ -1,6 +1,6 @@
 # Security
 
-MicroOcpp is designed to be compatible with IoT devices which leads to special considerations regarding cyber security. This section describes the challenges and security concepts of MicroOcpp.
+MicroOCPP is designed to be compatible with IoT devices which leads to special considerations regarding cyber security. This section describes the challenges and security concepts of MicroOCPP.
 
 ## Challenges of using microcontrollers in safety-critical environments
 
@@ -15,33 +15,33 @@ Challenge 2) is due to the fact that OCPP uses standard web technology (WebSocke
 
 On the upside, an advantage of microcontrollers is their single purpose usage and thus, reduced complexity. Many security breaches are caused by misconfigured and often even superflous software components (e.g. due to overlooked open ports) which are not a regular part of a microcontroller firmware.
 
-## Security measures of MicroOcpp
+## Security measures of MicroOCPP
 
 To address the challenges, the following measures were taken:
 
-- Input sanitazion: MicroOcpp only accepts the JSON format for all input. It is validated by ArduinoJson. Every JSON value is checked against the expected format and for conformity with the OCPP specification before using it. The JSON object is discarded immediately after interpretation
+- Input sanitazion: MicroOCPP only accepts the JSON format for all input. It is validated by ArduinoJson. Every JSON value is checked against the expected format and for conformity with the OCPP specification before using it. The JSON object is discarded immediately after interpretation
 - Transaction safety: to address crashes and random reboots of the microcontroller during operation, all activities of the OCPP library are programmed so that they will either be resumed or fully reverted after reboots, preventing inconsistent states. See also [Transaction safety](../intro-tech/#transaction-safety)
 - Careful choice of the dependencies: the mandatory dependency, [ArduinoJson](https://github.com/bblanchon/ArduinoJson), has a test coverage of nearly 100% and is fuzzed. The same goes for the recommended WebSocket library, [Mongoose](https://github.com/cesanta/mongoose). Both projects are very relevant in their field with over 6k and 9k stars on GitHub
 
 Two further measures would be beneficial and could be requested via support request:
 
 - Precautious memory allocation: migrating memory management to the stack and where possible would simplify code analysis and reduce the potential of vulnerabilities
-- OCPP fuzzer: as a stateful application protocol, there are specific challenges of developing a fuzzer. An open source fuzzing framework for OCPP could reveal vulnerabilities and be of use for other OCPP projects as well. MicroOcpp is a good foundation for trying new fuzzing approaches. The exposure of the main-loop function and the clock allow a fine-grained access to the program flow and facilitating random alterations of the environment conditions. Furthermore, all persistent data is stored in the JSON format and it is possible to develop a grammatic which contains both a device status and incoming OCPP messages. The Configuration interface could be reused for further status variables which don't need to be persistent in practice, but would improve fuzzing performance when being accessible by the fuzzer.
-- Memory pool: object orientation is a very helpful programming paradigm for OCPP. The standard contains a lot of polymorphic entities and optional or variable length data fields. MicroOcpp makes use of the heap and allocates new chunks of memory as the device model is populated with data. On the upside this allows to save a lot of memory during normal operation, but it also entails the risk of memory depletion of the whole controller. A fixed memory pool for OCPP would encapsulate the heap usage to a certain address space and set a hard limit for the memory consumption and avoid polluting the shared heap area by heap fragmentation. To realize the memory pool, it would be necessary to make the allocate and deallocate functions configurable by the client code. Then appropriate (de)allocators can be injected limiting the memory use to a restricted address area. As a consequence, a more thorough allocation error handling in the MicroOcpp code is required and test cases which randomly suppress allocations to test if the library always reverts to a consistent state. A less invasive alternative to memory pools is to inject measured (de)allocators which just prevent the allocation of new memory chunks after a certain threshold has been exceeded. This programming technique would also allow to create much more fine-grained benchmarks of the library.
+- OCPP fuzzer: as a stateful application protocol, there are specific challenges of developing a fuzzer. An open source fuzzing framework for OCPP could reveal vulnerabilities and be of use for other OCPP projects as well. MicroOCPP is a good foundation for trying new fuzzing approaches. The exposure of the main-loop function and the clock allow a fine-grained access to the program flow and facilitating random alterations of the environment conditions. Furthermore, all persistent data is stored in the JSON format and it is possible to develop a grammatic which contains both a device status and incoming OCPP messages. The Configuration interface could be reused for further status variables which don't need to be persistent in practice, but would improve fuzzing performance when being accessible by the fuzzer.
+- Memory pool: object orientation is a very helpful programming paradigm for OCPP. The standard contains a lot of polymorphic entities and optional or variable length data fields. MicroOCPP makes use of the heap and allocates new chunks of memory as the device model is populated with data. On the upside this allows to save a lot of memory during normal operation, but it also entails the risk of memory depletion of the whole controller. A fixed memory pool for OCPP would encapsulate the heap usage to a certain address space and set a hard limit for the memory consumption and avoid polluting the shared heap area by heap fragmentation. To realize the memory pool, it would be necessary to make the allocate and deallocate functions configurable by the client code. Then appropriate (de)allocators can be injected limiting the memory use to a restricted address area. As a consequence, a more thorough allocation error handling in the MicroOCPP code is required and test cases which randomly suppress allocations to test if the library always reverts to a consistent state. A less invasive alternative to memory pools is to inject measured (de)allocators which just prevent the allocation of new memory chunks after a certain threshold has been exceeded. This programming technique would also allow to create much more fine-grained benchmarks of the library.
 
 ## Measures to be taken by the EVSE vendor
 
 As a general rule, the communication controller which is exposed to the internet shouldn't be used for safety-critical tasks on the charging hardware. That's because the networking stack is a very complex piece of software which very likely still has open bugs which can crash the controller despite all the effort to improve it. Safety-critical tasks on the charging hardware shouldn't rely on a controller which could crash at any time because of incoming network traffic. To mitigate this, either the OCPP library and internet functionality should be placed onto a separate chip, or the most vital safety functionality should get a dedicated controller.
 
-The recommended [Mongoose WebSocket adapter for MicroOcpp](https://github.com/matth-x/MicroOcppMongoose) supports the OCPP Security Profile 2 (TLS with Basic Authentication) and needs to be provided with the necessary TLS certificate.
+The recommended [Mongoose WebSocket adapter for MicroOCPP](https://github.com/matth-x/MicroOcppMongoose) supports the OCPP Security Profile 2 (TLS with Basic Authentication) and needs to be provided with the necessary TLS certificate.
 
-Most IoT-controllers have built-in mechanisms to ensure the authenticity of their firmware. For example, the Espressif32 supports [Secure Boot](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/secure-boot-v2.html) which is a signature verification of the installed firmware before that firmware is executed. Many platforms also have a built-in signature verification for incoming OTA firmware updates. To prove the authenticity of the charger to the OCPP server, it is also important to keep the WebSocket key secret by [encrypting the flash memory](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/flash-encryption.html). These security mechanisms heavily depend on the host controller which runs MicroOcpp. It is the responsibility of the main firmware to make proper use of them.
+Most IoT-controllers have built-in mechanisms to ensure the authenticity of their firmware. For example, the Espressif32 supports [Secure Boot](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/secure-boot-v2.html) which is a signature verification of the installed firmware before that firmware is executed. Many platforms also have a built-in signature verification for incoming OTA firmware updates. To prove the authenticity of the charger to the OCPP server, it is also important to keep the WebSocket key secret by [encrypting the flash memory](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/security/flash-encryption.html). These security mechanisms heavily depend on the host controller which runs MicroOCPP. It is the responsibility of the main firmware to make proper use of them.
 
 ## OCPP Security Whitepaper and ISO 15118
 
-With MicroOcpp, the recommended way of handling certificates on microcontrollers is to compile them into the firmware binary and to rely on the built-in firmware signature checks of the host microcontroller platform. This lean approach results in a smaller attack vector compared to establishing a separate infrastructure for the server- and firmware certificate. It can be assumed that the OTA functionality of the microcontrollers is thoroughly tested and consequently, reaching a comparable level of robustness would require much effort.
+With MicroOCPP, the recommended way of handling certificates on microcontrollers is to compile them into the firmware binary and to rely on the built-in firmware signature checks of the host microcontroller platform. This lean approach results in a smaller attack vector compared to establishing a separate infrastructure for the server- and firmware certificate. It can be assumed that the OTA functionality of the microcontrollers is thoroughly tested and consequently, reaching a comparable level of robustness would require much effort.
 
-In case the certificate handling mechanism of the Security Whitepaper is preferred, then the EVSE vendor needs to implement it via a custom extension. Unfortunately, this mechanism hasn't been requested yet and is not natively supported by MicroOcpp yet. The new custom operations can be implemented by extending the class `Operation`. A handler for incoming messages can be registered via `OperationRegistry::registerOperation(...)`. To send custom messages to the server, use `Context::initiateRequest(...)`.
+In case the certificate handling mechanism of the Security Whitepaper is preferred, then the EVSE vendor needs to implement it via a custom extension. Unfortunately, this mechanism hasn't been requested yet and is not natively supported by MicroOCPP yet. The new custom operations can be implemented by extending the class `Operation`. A handler for incoming messages can be registered via `OperationRegistry::registerOperation(...)`. To send custom messages to the server, use `Context::initiateRequest(...)`.
 
 A further challenge for microcontrollers is the relatively low processor speed which becomes relevant for a potential ISO 15118 integration. Some incoming message types (`AuthorizationReq` and `MeteringReceiptReq`) include a signature which needs to be verified on the communications controller of the EVSE. Moreover, messages in the ISO 15118 V2G protocol have a maximum round trip time (which is 2 seconds for the message types in question) and so the signature verification is time-contrained. [These benchmarks](https://web.archive.org/web/20230724184529/https://www.oryx-embedded.com/benchmark/espressif/crypto-esp32.html) for the Espressif32 show that for some signature algorithms, the verification time can get close or exceed the timing requirements of ISO 15118 if done on the processor only. As a consequence, hardware acceleration by the crypto-core is mandatory to ensure a robust communication between the EVSE and EV. Before making a communications controller with ISO 15118 support, the performance of the host controller should be benchmarked and checked against the requirements.
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 60c415fa..0bc66499 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,4 +1,4 @@
-site_name: MicroOcpp docs
+site_name: MicroOCPP docs
 
 theme:
   name: material

From 77e88cbc5edac055acdfb4e09af296a1bfdc003f Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Mon, 5 Aug 2024 13:45:35 +0200
Subject: [PATCH 510/549] Remove SimpleRequestFactory (#351)

* move Request factory functions into Request.h/cpp

* add missing Request include

* update changelog
---
 CHANGELOG.md                                  |  1 +
 CMakeLists.txt                                |  1 -
 src/MicroOcpp.cpp                             |  2 +-
 src/MicroOcpp/Core/Request.cpp                | 15 +++++++++++++
 src/MicroOcpp/Core/Request.h                  |  6 ++++++
 src/MicroOcpp/Core/RequestQueue.cpp           |  1 -
 src/MicroOcpp/Core/SimpleRequestFactory.cpp   | 21 -------------------
 src/MicroOcpp/Core/SimpleRequestFactory.h     | 20 ------------------
 .../Authorization/AuthorizationService.cpp    |  2 +-
 src/MicroOcpp/Model/Boot/BootService.cpp      |  2 +-
 .../Model/ConnectorBase/Connector.cpp         |  2 +-
 .../Model/Diagnostics/DiagnosticsService.cpp  |  2 +-
 .../FirmwareManagement/FirmwareService.cpp    |  2 +-
 .../Model/Heartbeat/HeartbeatService.cpp      |  2 +-
 .../Model/Metering/MeteringService.cpp        |  2 +-
 src/MicroOcpp/Model/Reset/ResetService.cpp    |  2 +-
 .../Model/Transactions/TransactionService.cpp |  1 -
 .../Model/Variables/VariableService.cpp       |  2 +-
 src/MicroOcpp/Operations/TriggerMessage.cpp   |  2 +-
 tests/Api.cpp                                 |  2 +-
 tests/Certificates.cpp                        |  2 +-
 tests/ChargePointError.cpp                    |  1 -
 tests/ChargingSessions.cpp                    |  2 +-
 tests/Configuration.cpp                       |  2 +-
 tests/FirmwareManagement.cpp                  |  2 +-
 tests/LocalAuthList.cpp                       |  2 +-
 tests/Metering.cpp                            |  1 -
 tests/Reservation.cpp                         |  2 +-
 tests/Reset.cpp                               |  1 -
 tests/SmartCharging.cpp                       |  2 +-
 tests/TransactionSafety.cpp                   |  1 -
 tests/Transactions.cpp                        |  1 -
 tests/Variables.cpp                           |  1 -
 33 files changed, 41 insertions(+), 69 deletions(-)
 delete mode 100644 src/MicroOcpp/Core/SimpleRequestFactory.cpp
 delete mode 100644 src/MicroOcpp/Core/SimpleRequestFactory.h

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d90671c6..9249bf3f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -25,6 +25,7 @@
 - ESP32 built-in HTTP OTA ([#313](https://github.com/matth-x/MicroOcpp/pull/313))
 - Operation store (files op-*.jsn and opstore.jsn) ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 - Explicit tracking of txNr (file txstore.jsn) ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
+- SimpleRequestFactory ([#351](https://github.com/matth-x/MicroOcpp/pull/351))
 
 ### Fixed
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 8036f3fa..f86ebf25 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -63,7 +63,6 @@ set(MO_SRC
     src/MicroOcpp/Operations/UpdateFirmware.cpp
     src/MicroOcpp/Debug.cpp
     src/MicroOcpp/Platform.cpp
-    src/MicroOcpp/Core/SimpleRequestFactory.cpp
     src/MicroOcpp/Core/OperationRegistry.cpp
     src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
     src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index bfde4634..73231056 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -21,7 +21,7 @@
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 #include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index a2cad9b8..a9d63677 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -286,3 +286,18 @@ void Request::setRequestSent() {
 bool Request::isRequestSent() {
     return requestSent;
 }
+
+namespace MicroOcpp {
+
+std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> operation){
+    if (operation == nullptr) {
+        return nullptr;
+    }
+    return std::unique_ptr<Request>(new Request(std::move(operation)));
+}
+
+std::unique_ptr<Request> makeRequest(Operation *operation) {
+    return makeRequest(std::unique_ptr<Operation>(operation));
+}
+
+} //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
index 300d0d79..fde0eb91 100644
--- a/src/MicroOcpp/Core/Request.h
+++ b/src/MicroOcpp/Core/Request.h
@@ -116,6 +116,12 @@ class Request {
     bool isRequestSent();
 };
 
+/*
+ * Simple factory functions
+ */
+std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> op);
+std::unique_ptr<Request> makeRequest(Operation *op); //takes ownership of op
+
 } //end namespace MicroOcpp
 
  #endif
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index 8f8cc3cb..5f9722c2 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -7,7 +7,6 @@
 #include <MicroOcpp/Core/RequestQueue.h>
 #include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Core/Connection.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Core/OcppError.h>
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Operations/StatusNotification.h>
diff --git a/src/MicroOcpp/Core/SimpleRequestFactory.cpp b/src/MicroOcpp/Core/SimpleRequestFactory.cpp
deleted file mode 100644
index dc0f38c2..00000000
--- a/src/MicroOcpp/Core/SimpleRequestFactory.cpp
+++ /dev/null
@@ -1,21 +0,0 @@
-// matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2024
-// MIT License
-
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
-#include <MicroOcpp/Core/Operation.h>
-
-namespace MicroOcpp {
-
-std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> operation){
-    if (operation == nullptr) {
-        return nullptr;
-    }
-    return std::unique_ptr<Request>(new Request(std::move(operation)));
-}
-
-std::unique_ptr<Request> makeRequest(Operation *operation) {
-    return makeRequest(std::unique_ptr<Operation>(operation));
-}
-
-} //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/SimpleRequestFactory.h b/src/MicroOcpp/Core/SimpleRequestFactory.h
deleted file mode 100644
index 45c7e0a0..00000000
--- a/src/MicroOcpp/Core/SimpleRequestFactory.h
+++ /dev/null
@@ -1,20 +0,0 @@
-// matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2024
-// MIT License
-
-#ifndef MO_SIMPLEREQUESTFACTORY_H
-#define MO_SIMPLEREQUESTFACTORY_H
-
-#include <memory>
-
-#include <MicroOcpp/Core/Request.h>
-
-namespace MicroOcpp {
-
-class Operation;
-
-std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> op);
-std::unique_ptr<Request> makeRequest(Operation *op); //takes ownership of op
-
-} //end namespace MicroOcpp
-#endif
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 74ee7bb8..fd15c0b9 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -12,7 +12,7 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/OperationRegistry.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Operations/GetLocalListVersion.h>
 #include <MicroOcpp/Operations/SendLocalList.h>
 #include <MicroOcpp/Operations/StatusNotification.h>
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index bf485ad3..d44a4b71 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -8,7 +8,7 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Configuration.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
 #include <MicroOcpp/Operations/BootNotification.h>
 #include <MicroOcpp/Platform.h>
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index db137d26..56eaa7e8 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -24,7 +24,7 @@
 #include <MicroOcpp/Model/ConnectorBase/EvseId.h>
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
 
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Core/Connection.h>
 
 #ifndef MO_TX_CLEAN_ABORTED
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index a46737df..c4cb6b9a 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -5,7 +5,7 @@
 #include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Debug.h>
 
 #include <MicroOcpp/Operations/GetDiagnostics.h>
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index ee59ae47..54cf72ca 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -9,7 +9,7 @@
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/OperationRegistry.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 
 #include <MicroOcpp/Operations/UpdateFirmware.h>
 #include <MicroOcpp/Operations/FirmwareStatusNotification.h>
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
index da476db1..a77eed0e 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp/Model/Heartbeat/HeartbeatService.h>
 #include <MicroOcpp/Core/Context.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Operations/Heartbeat.h>
 #include <MicroOcpp/Platform.h>
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index bff296d1..169c2e2a 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -7,7 +7,7 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Operations/MeterValues.h>
 #include <MicroOcpp/Debug.h>
 
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index e21b448f..d43436c4 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -5,7 +5,7 @@
 #include <MicroOcpp/Model/Reset/ResetService.h>
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Operations/Reset.h>
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index 163e252a..a1ccd4aa 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -18,7 +18,6 @@
 #include <MicroOcpp/Operations/TransactionEvent.h>
 #include <MicroOcpp/Operations/RequestStartTransaction.h>
 #include <MicroOcpp/Operations/RequestStopTransaction.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Debug.h>
 
 using namespace MicroOcpp;
diff --git a/src/MicroOcpp/Model/Variables/VariableService.cpp b/src/MicroOcpp/Model/Variables/VariableService.cpp
index c77b06a6..267a8971 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.cpp
+++ b/src/MicroOcpp/Model/Variables/VariableService.cpp
@@ -16,7 +16,7 @@
 #include <MicroOcpp/Operations/GetVariables.h>
 #include <MicroOcpp/Operations/GetBaseReport.h>
 #include <MicroOcpp/Operations/NotifyReport.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 
 #include <cstring>
 #include <cctype>
diff --git a/src/MicroOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
index 7c246e3d..431f2a57 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.cpp
+++ b/src/MicroOcpp/Operations/TriggerMessage.cpp
@@ -8,7 +8,7 @@
 #include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Context.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::TriggerMessage;
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 9f53aa94..2de67703 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -6,8 +6,8 @@
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Core/Configuration.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Debug.h>
 #include "./catch2/catch.hpp"
diff --git a/tests/Certificates.cpp b/tests/Certificates.cpp
index b1193380..9267705a 100644
--- a/tests/Certificates.cpp
+++ b/tests/Certificates.cpp
@@ -13,7 +13,7 @@
 
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
diff --git a/tests/ChargePointError.cpp b/tests/ChargePointError.cpp
index 6ca2498c..3fe9a472 100644
--- a/tests/ChargePointError.cpp
+++ b/tests/ChargePointError.cpp
@@ -9,7 +9,6 @@
 
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Debug.h>
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index bff8838e..5c35362b 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -7,7 +7,7 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Configuration.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Operations/BootNotification.h>
 #include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
diff --git a/tests/Configuration.cpp b/tests/Configuration.cpp
index b4dda74c..57aa8107 100644
--- a/tests/Configuration.cpp
+++ b/tests/Configuration.cpp
@@ -18,7 +18,7 @@
 
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Debug.h>
 
 using namespace MicroOcpp;
diff --git a/tests/FirmwareManagement.cpp b/tests/FirmwareManagement.cpp
index 2a9425cc..20801dd8 100644
--- a/tests/FirmwareManagement.cpp
+++ b/tests/FirmwareManagement.cpp
@@ -9,7 +9,7 @@
 
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index 811d4d00..866567e3 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -13,7 +13,7 @@
 
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 63d744ba..3a542d5c 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -7,7 +7,6 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Configuration.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include "./catch2/catch.hpp"
 #include "./helpers/testHelper.h"
 
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index fbd6894d..1b36f077 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -13,7 +13,7 @@
 
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
diff --git a/tests/Reset.cpp b/tests/Reset.cpp
index 8092a155..d1607eb8 100644
--- a/tests/Reset.cpp
+++ b/tests/Reset.cpp
@@ -13,7 +13,6 @@
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Model/Reset/ResetService.h>
 #include <MicroOcpp/Model/Variables/VariableService.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Debug.h>
 #include "./catch2/catch.hpp"
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index 19bec8b1..c92c5dcf 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -7,7 +7,7 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Configuration.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include "./catch2/catch.hpp"
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index fe62a486..03eeb9f6 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -7,7 +7,6 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Configuration.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Operations/BootNotification.h>
 #include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Debug.h>
diff --git a/tests/Transactions.cpp b/tests/Transactions.cpp
index bf071e73..e32994be 100644
--- a/tests/Transactions.cpp
+++ b/tests/Transactions.cpp
@@ -11,7 +11,6 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Debug.h>
 #include "./catch2/catch.hpp"
diff --git a/tests/Variables.cpp b/tests/Variables.cpp
index 156840ea..aed483b3 100644
--- a/tests/Variables.cpp
+++ b/tests/Variables.cpp
@@ -17,7 +17,6 @@
 
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
-#include <MicroOcpp/Core/SimpleRequestFactory.h>
 
 using namespace MicroOcpp;
 

From d6840efa90431d472a044fabc4c5e00d49e59077 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 6 Aug 2024 13:00:32 +0200
Subject: [PATCH 511/549] Make Timestamp milliseconds optional (#352)

* add Timestamp milliseconds support switch

* update changelog
---
 CHANGELOG.md                |  1 +
 src/MicroOcpp/Core/Time.cpp | 33 ++++++++++++++++++++++++++++++++-
 src/MicroOcpp/Core/Time.h   | 19 +++++++++++++++++--
 3 files changed, 50 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9249bf3f..eca02c88 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,7 @@
 - Connector lock disabled by default per `MO_ENABLE_CONNECTOR_LOCK` ([#312](https://github.com/matth-x/MicroOcpp/pull/312))
 - Relaxed temporal order of non-tx-related operations ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 - Use pseudo-GUIDs as messageId ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
+- ISO 8601 milliseconds omitted by default ([352](https://github.com/matth-x/MicroOcpp/pull/352))
 
 ### Added
 
diff --git a/src/MicroOcpp/Core/Time.cpp b/src/MicroOcpp/Core/Time.cpp
index 58cc0ed6..6db1f852 100644
--- a/src/MicroOcpp/Core/Time.cpp
+++ b/src/MicroOcpp/Core/Time.cpp
@@ -19,6 +19,14 @@ Timestamp::Timestamp(const Timestamp& other) {
     *this = other;
 }
 
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
+    Timestamp::Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second, int32_t ms) :
+                year(year), month(month), day(day), hour(hour), minute(minute), second(second), ms(ms) { };
+#else 
+    Timestamp::Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second) :
+                year(year), month(month), day(day), hour(hour), minute(minute), second(second) { };
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
+
 int noDays(int month, int year) {
     return (month == 0 || month == 2 || month == 4 || month == 6 || month == 7 || month == 9 || month == 11) ? 31 :
             ((month == 3 || month == 5 || month == 8 || month == 10) ? 30 :
@@ -102,7 +110,9 @@ bool Timestamp::setTime(const char *jsonDateString) {
     this->hour = hour;
     this->minute = minute;
     this->second = second;
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
     this->ms = ms;
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
     
     return true;
 }
@@ -129,12 +139,17 @@ bool Timestamp::toJsonString(char *jsonDateString, size_t buffsize) const {
     jsonDateString[16] = ':';
     jsonDateString[17] = ((char) ((second / 10) % 10))  + '0';
     jsonDateString[18] = ((char) ((second / 1) % 10))  + '0';
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
     jsonDateString[19] = '.';
     jsonDateString[20] = ((char) ((ms / 100) % 10))  + '0';
     jsonDateString[21] = ((char) ((ms / 10) % 10))  + '0';
     jsonDateString[22] = ((char) ((ms / 1) % 10))  + '0';
     jsonDateString[23] = 'Z';
     jsonDateString[24] = '\0';
+#else
+    jsonDateString[19] = 'Z';
+    jsonDateString[20] = '\0';
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
 
     return true;
 }
@@ -192,6 +207,7 @@ Timestamp &Timestamp::operator+=(int secs) {
     return *this;
 }
 
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
 Timestamp &Timestamp::addMilliseconds(int val) {
 
     ms += val;
@@ -206,6 +222,7 @@ Timestamp &Timestamp::addMilliseconds(int val) {
     }
     return this->operator+=(dsecond);
 }
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
 
 Timestamp &Timestamp::operator-=(int secs) {
     return operator+=(-secs);
@@ -248,7 +265,9 @@ Timestamp &Timestamp::operator=(const Timestamp &rhs) {
     hour = rhs.hour;
     minute = rhs.minute;
     second = rhs.second;
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
     ms = rhs.ms;
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
 
     return *this;
 }
@@ -264,7 +283,11 @@ Timestamp operator-(const Timestamp &lhs, int secs) {
 }
 
 bool operator==(const Timestamp &lhs, const Timestamp &rhs) {
-    return lhs.year == rhs.year && lhs.month == rhs.month && lhs.day == rhs.day && lhs.hour == rhs.hour && lhs.minute == rhs.minute && lhs.second == rhs.second && lhs.ms == rhs.ms;
+    return lhs.year == rhs.year && lhs.month == rhs.month && lhs.day == rhs.day && lhs.hour == rhs.hour && lhs.minute == rhs.minute && lhs.second == rhs.second
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
+    && lhs.ms == rhs.ms
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
+    ;
 }
 
 bool operator!=(const Timestamp &lhs, const Timestamp &rhs) {
@@ -284,8 +307,10 @@ bool operator<(const Timestamp &lhs, const Timestamp &rhs) {
         return lhs.minute < rhs.minute;
     if (lhs.second != rhs.second)
         return lhs.second < rhs.second;
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
     if (lhs.ms != rhs.ms)
         return lhs.ms < rhs.ms;
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
     return false;  
 }
 
@@ -327,8 +352,14 @@ const Timestamp &Clock::now() {
     auto tReading = mocpp_tick_ms();
     auto delta = tReading - lastUpdate;
 
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
     currentTime.addMilliseconds(delta);
     lastUpdate = tReading;
+#else
+    auto deltaSecs = delta / 1000;
+    currentTime += deltaSecs;
+    lastUpdate += deltaSecs * 1000;
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
 
     return currentTime;
 }
diff --git a/src/MicroOcpp/Core/Time.h b/src/MicroOcpp/Core/Time.h
index 01af04bb..349fb01b 100644
--- a/src/MicroOcpp/Core/Time.h
+++ b/src/MicroOcpp/Core/Time.h
@@ -11,7 +11,15 @@
 
 #include <MicroOcpp/Platform.h>
 
+#ifndef MO_ENABLE_TIMESTAMP_MILLISECONDS
+#define MO_ENABLE_TIMESTAMP_MILLISECONDS 0
+#endif
+
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
 #define JSONDATE_LENGTH 24   //max. ISO 8601 date length, excluding the terminating zero
+#else
+#define JSONDATE_LENGTH 20   //ISO 8601 date length, excluding the terminating zero
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
 
 namespace MicroOcpp {
 
@@ -27,7 +35,9 @@ class Timestamp {
     int32_t hour = 0;
     int32_t minute = 0;
     int32_t second = 0;
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
     int32_t ms = 0;
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
 
 public:
 
@@ -35,8 +45,11 @@ class Timestamp {
 
     Timestamp(const Timestamp& other);
 
-    Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second, int32_t ms = 0) :
-                year(year), month(month), day(day), hour(hour), minute(minute), second(second), ms(ms) { };
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
+    Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second, int32_t ms = 0);
+#else 
+    Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second);
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
 
     /**
      * Expects a date string like
@@ -57,7 +70,9 @@ class Timestamp {
 
     Timestamp &operator=(const Timestamp &rhs);
 
+#if MO_ENABLE_TIMESTAMP_MILLISECONDS
     Timestamp &addMilliseconds(int ms);
+#endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
 
     /*
      * Time periods are given in seconds for all of the following arithmetic operations

From 94e0918ccb8c0e38bd1086771431d6ce5177a524 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 13 Aug 2024 16:35:51 +0200
Subject: [PATCH 512/549] Custom allocator / heap profiler (#350)

* custom allocators layout (WIP)

* custom allocator proof-of-concept with Request and Operation

* fix Allocator tag handling

* keep tag in dynamic memory

* use allocators for Configs

* revert allocator in Operation interface

* use allocators in more Core modules

* add memory tag to Request factory

* simple heap profiler implementation

* add vector with custom allocator type

* use allocators in Model and Time

* facilitate memory tag concatenation

* use allocators for Variables

* add type MemJsonDoc and factory method

* use custom allocators for Operation classes

* find tags for untagged memory blocks

* capture maximum heap usage per memory tag

* cover remaining allocations and debug

* add missing custom alloc statements

* fix compilation, remove Debug.h include

* fix compilation on Arduino

* fix compilation warnings / errors

* fix UBSan reported error

* add function to reset maximum heap usage

* update Memory interface and function names

* update changelog

* fix building on ESP

* fix building on ESP8266

* clean up custom allocator changes
---
 CHANGELOG.md                                  |   1 +
 CMakeLists.txt                                |   7 +-
 src/MicroOcpp.cpp                             |  34 +-
 src/MicroOcpp.h                               |  17 +-
 src/MicroOcpp/Core/Configuration.cpp          |  18 +-
 src/MicroOcpp/Core/Configuration.h            |   4 +-
 src/MicroOcpp/Core/ConfigurationContainer.cpp |   5 +-
 src/MicroOcpp/Core/ConfigurationContainer.h   |   6 +-
 .../Core/ConfigurationContainerFlash.cpp      |  71 ++-
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp  |  20 +-
 src/MicroOcpp/Core/Configuration_c.cpp        |  10 +-
 src/MicroOcpp/Core/Connection.cpp             |   4 +-
 src/MicroOcpp/Core/Connection.h               |   7 +-
 src/MicroOcpp/Core/Context.cpp                |   2 +-
 src/MicroOcpp/Core/Context.h                  |   3 +-
 src/MicroOcpp/Core/FilesystemAdapter.cpp      |  99 ++--
 src/MicroOcpp/Core/FilesystemUtils.cpp        |   8 +-
 src/MicroOcpp/Core/FilesystemUtils.h          |   5 +-
 src/MicroOcpp/Core/FtpMbedTLS.cpp             |  64 ++-
 src/MicroOcpp/Core/Memory.cpp                 | 294 ++++++++++++
 src/MicroOcpp/Core/Memory.h                   | 444 ++++++++++++++++++
 src/MicroOcpp/Core/OcppError.h                |  15 +-
 src/MicroOcpp/Core/Operation.cpp              |  10 +-
 src/MicroOcpp/Core/Operation.h                |   9 +-
 src/MicroOcpp/Core/OperationRegistry.cpp      |   2 +-
 src/MicroOcpp/Core/OperationRegistry.h        |   5 +-
 src/MicroOcpp/Core/Request.cpp                |  26 +-
 src/MicroOcpp/Core/Request.h                  |  15 +-
 src/MicroOcpp/Core/RequestQueue.cpp           |  18 +-
 src/MicroOcpp/Core/RequestQueue.h             |   5 +-
 src/MicroOcpp/Core/Time.cpp                   |   8 +-
 src/MicroOcpp/Core/Time.h                     |   3 +-
 .../Model/Authorization/AuthorizationData.cpp |  41 +-
 .../Model/Authorization/AuthorizationData.h   |  13 +-
 .../Model/Authorization/AuthorizationList.cpp |  14 +-
 .../Model/Authorization/AuthorizationList.h   |   6 +-
 .../Authorization/AuthorizationService.cpp    |   8 +-
 .../Authorization/AuthorizationService.h      |   3 +-
 src/MicroOcpp/Model/Authorization/IdToken.cpp |  21 +-
 src/MicroOcpp/Model/Authorization/IdToken.h   |   9 +-
 src/MicroOcpp/Model/Boot/BootService.cpp      |  12 +-
 src/MicroOcpp/Model/Boot/BootService.h        |   7 +-
 .../Model/Certificates/Certificate.h          |  10 +-
 .../Model/Certificates/CertificateMbedTLS.cpp |  16 +-
 .../Model/Certificates/CertificateService.cpp |   2 +-
 .../Model/Certificates/CertificateService.h   |   3 +-
 .../Model/Certificates/Certificate_c.cpp      |   7 +-
 .../Model/ConnectorBase/Connector.cpp         |   3 +-
 src/MicroOcpp/Model/ConnectorBase/Connector.h |   8 +-
 .../Model/ConnectorBase/ConnectorsCommon.cpp  |   4 +-
 .../Model/ConnectorBase/ConnectorsCommon.h    |   3 +-
 .../Model/Diagnostics/DiagnosticsService.cpp  |  50 +-
 .../Model/Diagnostics/DiagnosticsService.h    |  13 +-
 .../FirmwareManagement/FirmwareService.cpp    |   5 +-
 .../FirmwareManagement/FirmwareService.h      |   7 +-
 .../Model/Heartbeat/HeartbeatService.cpp      |   2 +-
 .../Model/Heartbeat/HeartbeatService.h        |   6 +-
 src/MicroOcpp/Model/Metering/MeterStore.cpp   |  10 +-
 src/MicroOcpp/Model/Metering/MeterStore.h     |  14 +-
 src/MicroOcpp/Model/Metering/MeterValue.cpp   |  37 +-
 src/MicroOcpp/Model/Metering/MeterValue.h     |  20 +-
 .../Model/Metering/MeteringConnector.cpp      |  10 +-
 .../Model/Metering/MeteringConnector.h        |   8 +-
 .../Model/Metering/MeteringService.cpp        |  36 +-
 .../Model/Metering/MeteringService.h          |   6 +-
 src/MicroOcpp/Model/Metering/SampledValue.cpp |  29 +-
 src/MicroOcpp/Model/Metering/SampledValue.h   |  50 +-
 src/MicroOcpp/Model/Model.cpp                 |   8 +-
 src/MicroOcpp/Model/Model.h                   |   7 +-
 .../Model/Reservation/Reservation.cpp         |   2 +-
 src/MicroOcpp/Model/Reservation/Reservation.h |   3 +-
 .../Model/Reservation/ReservationService.cpp  |   2 +-
 .../Model/Reservation/ReservationService.h    |   5 +-
 src/MicroOcpp/Model/Reset/ResetService.cpp    |   4 +-
 src/MicroOcpp/Model/Reset/ResetService.h      |   8 +-
 .../SmartCharging/SmartChargingModel.cpp      |  20 +-
 .../Model/SmartCharging/SmartChargingModel.h  |  16 +-
 .../SmartCharging/SmartChargingService.cpp    |  12 +-
 .../SmartCharging/SmartChargingService.h      |   7 +-
 .../Model/Transactions/Transaction.h          |  12 +-
 .../Transactions/TransactionDeserialize.cpp   |   4 +-
 .../Transactions/TransactionDeserialize.h     |   3 +-
 .../Model/Transactions/TransactionService.cpp |  20 +-
 .../Model/Transactions/TransactionService.h   |  14 +-
 .../Model/Transactions/TransactionStore.cpp   |  13 +-
 .../Model/Transactions/TransactionStore.h     |  12 +-
 src/MicroOcpp/Model/Variables/Variable.cpp    |  16 +-
 src/MicroOcpp/Model/Variables/Variable.h      |   8 +-
 .../Model/Variables/VariableContainer.cpp     |   2 +-
 .../Model/Variables/VariableContainer.h       |  14 +-
 .../Model/Variables/VariableService.cpp       |  16 +-
 .../Model/Variables/VariableService.h         |  14 +-
 src/MicroOcpp/Operations/Authorize.cpp        |  22 +-
 src/MicroOcpp/Operations/Authorize.h          |  12 +-
 src/MicroOcpp/Operations/BootNotification.cpp |  13 +-
 src/MicroOcpp/Operations/BootNotification.h   |  10 +-
 .../Operations/CancelReservation.cpp          |   9 +-
 src/MicroOcpp/Operations/CancelReservation.h  |   4 +-
 .../Operations/ChangeAvailability.cpp         |   7 +-
 src/MicroOcpp/Operations/ChangeAvailability.h |   4 +-
 .../Operations/ChangeConfiguration.cpp        |   7 +-
 .../Operations/ChangeConfiguration.h          |   4 +-
 src/MicroOcpp/Operations/ClearCache.cpp       |   7 +-
 src/MicroOcpp/Operations/ClearCache.h         |   4 +-
 .../Operations/ClearChargingProfile.cpp       |   7 +-
 .../Operations/ClearChargingProfile.h         |   4 +-
 src/MicroOcpp/Operations/CustomOperation.cpp  |  19 +-
 src/MicroOcpp/Operations/CustomOperation.h    |  22 +-
 src/MicroOcpp/Operations/DataTransfer.cpp     |  21 +-
 src/MicroOcpp/Operations/DataTransfer.h       |  12 +-
 .../Operations/DeleteCertificate.cpp          |   7 +-
 src/MicroOcpp/Operations/DeleteCertificate.h  |   4 +-
 .../DiagnosticsStatusNotification.cpp         |   7 +-
 .../DiagnosticsStatusNotification.h           |   4 +-
 .../Operations/FirmwareStatusNotification.cpp |   7 +-
 .../Operations/FirmwareStatusNotification.h   |   4 +-
 src/MicroOcpp/Operations/GetBaseReport.cpp    |   7 +-
 src/MicroOcpp/Operations/GetBaseReport.h      |   7 +-
 .../Operations/GetCompositeSchedule.cpp       |  13 +-
 .../Operations/GetCompositeSchedule.h         |   4 +-
 src/MicroOcpp/Operations/GetConfiguration.cpp |  15 +-
 src/MicroOcpp/Operations/GetConfiguration.h   |   9 +-
 src/MicroOcpp/Operations/GetDiagnostics.cpp   |   9 +-
 src/MicroOcpp/Operations/GetDiagnostics.h     |   6 +-
 .../Operations/GetInstalledCertificateIds.cpp |   9 +-
 .../Operations/GetInstalledCertificateIds.h   |   6 +-
 .../Operations/GetLocalListVersion.cpp        |   7 +-
 .../Operations/GetLocalListVersion.h          |   4 +-
 src/MicroOcpp/Operations/GetVariables.cpp     |  16 +-
 src/MicroOcpp/Operations/GetVariables.h       |  16 +-
 src/MicroOcpp/Operations/Heartbeat.cpp        |   9 +-
 src/MicroOcpp/Operations/Heartbeat.h          |   6 +-
 .../Operations/InstallCertificate.cpp         |   7 +-
 src/MicroOcpp/Operations/InstallCertificate.h |   4 +-
 src/MicroOcpp/Operations/MeterValues.cpp      |  15 +-
 src/MicroOcpp/Operations/MeterValues.h        |  13 +-
 src/MicroOcpp/Operations/NotifyReport.cpp     |  10 +-
 src/MicroOcpp/Operations/NotifyReport.h       |  11 +-
 .../Operations/RemoteStartTransaction.cpp     |  11 +-
 .../Operations/RemoteStartTransaction.h       |   6 +-
 .../Operations/RemoteStopTransaction.cpp      |   7 +-
 .../Operations/RemoteStopTransaction.h        |   4 +-
 .../Operations/RequestStartTransaction.cpp    |   7 +-
 .../Operations/RequestStartTransaction.h      |   6 +-
 .../Operations/RequestStopTransaction.cpp     |   7 +-
 .../Operations/RequestStopTransaction.h       |   6 +-
 src/MicroOcpp/Operations/ReserveNow.cpp       |   7 +-
 src/MicroOcpp/Operations/ReserveNow.h         |   4 +-
 src/MicroOcpp/Operations/Reset.cpp            |  13 +-
 src/MicroOcpp/Operations/Reset.h              |   8 +-
 src/MicroOcpp/Operations/SendLocalList.cpp    |   7 +-
 src/MicroOcpp/Operations/SendLocalList.h      |   4 +-
 .../Operations/SetChargingProfile.cpp         |   7 +-
 src/MicroOcpp/Operations/SetChargingProfile.h |   4 +-
 src/MicroOcpp/Operations/SetVariables.cpp     |  14 +-
 src/MicroOcpp/Operations/SetVariables.h       |  16 +-
 src/MicroOcpp/Operations/StartTransaction.cpp |  13 +-
 src/MicroOcpp/Operations/StartTransaction.h   |   6 +-
 .../Operations/StatusNotification.cpp         |  14 +-
 src/MicroOcpp/Operations/StatusNotification.h |  10 +-
 src/MicroOcpp/Operations/StopTransaction.cpp  |  21 +-
 src/MicroOcpp/Operations/StopTransaction.h    |  12 +-
 src/MicroOcpp/Operations/TransactionEvent.cpp |  12 +-
 src/MicroOcpp/Operations/TransactionEvent.h   |   6 +-
 src/MicroOcpp/Operations/TriggerMessage.cpp   |   7 +-
 src/MicroOcpp/Operations/TriggerMessage.h     |   7 +-
 src/MicroOcpp/Operations/UnlockConnector.cpp  |   7 +-
 src/MicroOcpp/Operations/UnlockConnector.h    |   4 +-
 src/MicroOcpp/Operations/UpdateFirmware.cpp   |   5 +-
 src/MicroOcpp/Operations/UpdateFirmware.h     |   4 +-
 src/MicroOcpp_c.cpp                           |   3 +-
 tests/Api.cpp                                 |  16 +-
 tests/Certificates.cpp                        |  18 +-
 tests/ChargePointError.cpp                    |   2 +-
 tests/ChargingSessions.cpp                    |  24 +-
 tests/Configuration.cpp                       |  16 +-
 tests/ConfigurationBehavior.cpp               |  10 +-
 tests/FirmwareManagement.cpp                  |  32 +-
 tests/LocalAuthList.cpp                       |  44 +-
 tests/Metering.cpp                            |   6 +-
 tests/Reservation.cpp                         |  30 +-
 tests/Reset.cpp                               |  10 +-
 tests/SmartCharging.cpp                       |  30 +-
 tests/TransactionSafety.cpp                   |   2 +-
 tests/Transactions.cpp                        |   4 +-
 tests/Variables.cpp                           |  16 +-
 tests/helpers/testHelper.cpp                  |  16 +
 tests/ocppEngineLifecycle.cpp                 |   2 +-
 188 files changed, 1964 insertions(+), 981 deletions(-)
 create mode 100644 src/MicroOcpp/Core/Memory.cpp
 create mode 100644 src/MicroOcpp/Core/Memory.h

diff --git a/CHANGELOG.md b/CHANGELOG.md
index eca02c88..0ad9de8c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,6 +20,7 @@
 - Support for `parentIdTag` ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Input validation for unsigned int Configs ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Support for TransactionMessageAttempts/-RetryInterval ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
+- Heap profiler and custom allocator support ([#350](https://github.com/matth-x/MicroOcpp/pull/350))
 
 ### Removed
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index f86ebf25..a3f085b1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -15,6 +15,7 @@ set(MO_SRC
     src/MicroOcpp/Core/FilesystemAdapter.cpp
     src/MicroOcpp/Core/FilesystemUtils.cpp
     src/MicroOcpp/Core/FtpMbedTLS.cpp
+    src/MicroOcpp/Core/Memory.cpp
     src/MicroOcpp/Core/RequestQueue.cpp
     src/MicroOcpp/Core/Context.cpp
     src/MicroOcpp/Core/Operation.cpp
@@ -169,7 +170,7 @@ if (MO_BUILD_UNIT_MBEDTLS)
 endif()
 
 target_include_directories(mo_unit_tests PUBLIC
-    "./tests/catch2"
+    "./tests"
     "./tests/helpers"
     "./src"
 )
@@ -190,6 +191,10 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_ENABLE_CERT_MGMT=1
     MO_ENABLE_CONNECTOR_LOCK=1
     MO_REPORT_NOERROR=1
+    MO_OVERRIDE_ALLOCATION=1
+    MO_ENABLE_HEAP_PROFILER=1
+    MO_HEAP_PROFILER_EXTERNAL_CONTROL=1
+    CATCH_CONFIG_EXTERNAL_INTERFACES
 )
 
 target_compile_options(mo_unit_tests PUBLIC
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 73231056..2fc39ba3 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -56,6 +56,12 @@ std::shared_ptr<FilesystemAdapter> filesystem;
 } //end namespace MicroOcpp::Facade
 } //end namespace MicroOcpp
 
+#if MO_ENABLE_HEAP_PROFILER
+#ifndef MO_HEAP_PROFILER_EXTERNAL_CONTROL
+#define MO_HEAP_PROFILER_EXTERNAL_CONTROL 0 //enable if you want to manually reset the heap profiler (e.g. for keeping stats over multiple MO lifecycles)
+#endif
+#endif
+
 using namespace MicroOcpp;
 using namespace MicroOcpp::Facade;
 using namespace MicroOcpp::Ocpp16;
@@ -79,7 +85,7 @@ void mocpp_initialize(const char *backendUrl, const char *chargeBoxId, const cha
     /*
      * parse backendUrl so that it suits the links2004/arduinoWebSockets interface
      */
-    std::string url = backendUrl;
+    auto url = makeString("MicroOcpp.cpp", backendUrl);
 
     //tolower protocol specifier
     for (auto c = url.begin(); *c != ':' && c != url.end(); c++) {
@@ -97,16 +103,16 @@ void mocpp_initialize(const char *backendUrl, const char *chargeBoxId, const cha
     }
 
     //parse host, port
-    std::string host_port_path = url.substr(url.find_first_of("://") + strlen("://"));
-    std::string host_port = host_port_path.substr(0, host_port_path.find_first_of('/'));
-    std::string path = host_port_path.substr(host_port.length());
-    std::string host = host_port.substr(0, host_port.find_first_of(':'));
+    auto host_port_path = url.substr(url.find_first_of("://") + strlen("://"));
+    auto host_port = host_port_path.substr(0, host_port_path.find_first_of('/'));
+    auto path = host_port_path.substr(host_port.length());
+    auto host = host_port.substr(0, host_port.find_first_of(':'));
     if (host.empty()) {
         MO_DBG_ERR("could not parse host: %s", url.c_str());
         return;
     }
     uint16_t port = 0;
-    std::string port_str = host_port.substr(host.length());
+    auto port_str = host_port.substr(host.length());
     if (port_str.empty()) {
         port = isTLS ? 443U : 80U;
     } else {
@@ -287,7 +293,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new BootService(*context, filesystem)));
     model.setConnectorsCommon(std::unique_ptr<ConnectorsCommon>(
         new ConnectorsCommon(*context, MO_NUMCONNECTORS, filesystem)));
-    std::vector<std::unique_ptr<Connector>> connectors;
+    auto connectors = makeVector<std::unique_ptr<Connector>>("v16.ConnectorBase.Connector");
     for (unsigned int connectorId = 0; connectorId < MO_NUMCONNECTORS; connectorId++) {
         connectors.emplace_back(new Connector(*context, filesystem, connectorId));
     }
@@ -404,6 +410,10 @@ void mocpp_deinitialize() {
 
     configuration_deinit();
 
+#if !MO_HEAP_PROFILER_EXTERNAL_CONTROL
+    MO_MEM_DEINIT();
+#endif
+
     MO_DBG_DEBUG("deinitialized OCPP\n");
 }
 
@@ -470,8 +480,8 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
             {
                 // We have a parent ID tag, so we need to check if this new card also has one
                 auto authorize = makeRequest(new Ocpp16::Authorize(context->getModel(), idTag));
-                std::string idTag_capture = idTag;
-                std::string reason_capture = reason ? reason : "";
+                auto idTag_capture = makeString("MicroOcpp.cpp", idTag);
+                auto reason_capture = makeString("MicroOcpp.cpp", reason ? reason : "");
                 authorize->setOnReceiveConfListener([idTag_capture, reason_capture, connectorId, tx] (JsonObject response) {
                     JsonObject idTagInfo = response["idTagInfo"];
 
@@ -1087,7 +1097,7 @@ void setOnSendConf(const char *operationType, OnSendConfListener onSendConf) {
 }
 
 void sendRequest(const char *operationType,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
+            std::function<std::unique_ptr<JsonDoc> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf) {
 
     if (!context) {
@@ -1105,7 +1115,7 @@ void sendRequest(const char *operationType,
 
 void setRequestHandler(const char *operationType,
             std::function<void (JsonObject)> fn_processReq,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf) {
+            std::function<std::unique_ptr<JsonDoc> ()> fn_createConf) {
 
     if (!context) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
@@ -1116,7 +1126,7 @@ void setRequestHandler(const char *operationType,
         return;
     }
 
-    std::string captureOpType = operationType;
+    auto captureOpType = makeString("MicroOcpp.cpp", operationType);
 
     context->getOperationRegistry().registerOperation(operationType, [captureOpType, fn_processReq, fn_createConf] () {
         return new CustomOperation(captureOpType.c_str(), fn_processReq, fn_createConf);
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 0567ea15..25896a26 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -13,6 +13,7 @@
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/RequestCallbacks.h>
 #include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Model/Metering/SampledValue.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/ConnectorBase/Notification.h>
@@ -436,11 +437,11 @@ void setOnSendConf(const char *operationType, OnSendConfListener onSendConf);
  * 
  * Use case 1, extend the library by sending additional operations. E.g. DataTransfer:
  * 
- * sendRequest("DataTransfer", [] () -> std::unique_ptr<DynamicJsonDocument> {
+ * sendRequest("DataTransfer", [] () -> std::unique_ptr<MicroOcpp::JsonDoc> {
  *     //will be called to create the request once this operation is being sent out
  *     size_t capacity = JSON_OBJECT_SIZE(3) +
  *                       JSON_OBJECT_SIZE(2); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
- *     auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity)); 
+ *     auto res = std::unique_ptr<MicroOcpp::JsonDoc>(new MicroOcpp::JsonDoc(capacity)); 
  *     JsonObject request = *res;
  *     request["vendorId"] = "My company Ltd.";
  *     request["messageId"] = "TargetValues";
@@ -457,10 +458,10 @@ void setOnSendConf(const char *operationType, OnSendConfListener onSendConf);
  * 
  * Use case 2, bypass the business logic of this library for custom behavior. E.g. StartTransaction:
  * 
- * sendRequest("StartTransaction", [] () -> std::unique_ptr<DynamicJsonDocument> {
+ * sendRequest("StartTransaction", [] () -> std::unique_ptr<MicroOcpp::JsonDoc> {
  *     //will be called to create the request once this operation is being sent out
  *     size_t capacity = JSON_OBJECT_SIZE(4); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
- *     auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity)); 
+ *     auto res = std::unique_ptr<MicroOcpp::JsonDoc>(new MicroOcpp::JsonDoc(capacity)); 
  *     JsonObject request = res->to<JsonObject>();
  *     request["connectorId"] = 1;
  *     request["idTag"] = "A9C3CE1D7B71EA";
@@ -477,7 +478,7 @@ void setOnSendConf(const char *operationType, OnSendConfListener onSendConf);
  * its own.
  */
 void sendRequest(const char *operationType,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
+            std::function<std::unique_ptr<MicroOcpp::JsonDoc> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf);
 
 /*
@@ -495,11 +496,11 @@ void sendRequest(const char *operationType,
  *     const char *messageId = request["messageId"];
  *     int battery_capacity = request["data"]["battery_capacity"];
  *     int battery_soc = request["data"]["battery_soc"];
- * }, [] () -> std::unique_ptr<DynamicJsonDocument> {
+ * }, [] () -> std::unique_ptr<MicroOcpp::JsonDoc> {
  *     //will be called  to create the response once this operation is being sent out
  *     size_t capacity = JSON_OBJECT_SIZE(2) +
  *                       JSON_OBJECT_SIZE(1); //for calculating the required capacity, see https://arduinojson.org/v6/assistant/
- *     auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity)); 
+ *     auto res = std::unique_ptr<MicroOcpp::JsonDoc>(new MicroOcpp::JsonDoc(capacity)); 
  *     JsonObject response = res->to<JsonObject>();
  *     response["status"] = "Accepted";
  *     response["data"]["max_energy"] = 59;
@@ -508,7 +509,7 @@ void sendRequest(const char *operationType,
  */
 void setRequestHandler(const char *operationType,
             std::function<void (JsonObject)> fn_processReq,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf);
+            std::function<std::unique_ptr<MicroOcpp::JsonDoc> ()> fn_createConf);
 
 /*
  * Send OCPP operations manually not bypassing the internal business logic
diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index 4ef802fa..ec1b9841 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -4,10 +4,10 @@
 
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/ConfigurationContainerFlash.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Debug.h>
 
 #include <string.h>
-#include <vector>
 #include <algorithm>
 #include <ArduinoJson.h>
 
@@ -24,8 +24,8 @@ struct Validator {
 namespace ConfigurationLocal {
 
 std::shared_ptr<FilesystemAdapter> filesystem;
-std::vector<std::shared_ptr<ConfigurationContainer>> configurationContainers;
-std::vector<Validator> validators;
+auto configurationContainers = makeVector<std::shared_ptr<ConfigurationContainer>>("v16.Configuration.Containers");
+auto validators = makeVector<Validator>("v16.Configuration.Validators");
 
 }
 
@@ -50,8 +50,8 @@ void addConfigurationContainer(std::shared_ptr<ConfigurationContainer> container
 }
 
 std::shared_ptr<ConfigurationContainer> getContainer(const char *filename) {
-    std::vector<std::shared_ptr<ConfigurationContainer>>::iterator container = std::find_if(configurationContainers.begin(), configurationContainers.end(),
-        [filename](std::shared_ptr<ConfigurationContainer> &elem) {
+    auto container = std::find_if(configurationContainers.begin(), configurationContainers.end(),
+        [filename](decltype(configurationContainers)::value_type &elem) {
             return !strcmp(elem->getFilename(), filename);
         });
 
@@ -192,8 +192,8 @@ Configuration *getConfigurationPublic(const char *key) {
     return nullptr;
 }
 
-std::vector<ConfigurationContainer*> getConfigurationContainersPublic() {
-    std::vector<ConfigurationContainer*> res;
+Vector<ConfigurationContainer*> getConfigurationContainersPublic() {
+    auto res = makeVector<ConfigurationContainer*>("v16.Configuration.Containers");
 
     for (auto& container : configurationContainers) {
         if (container->isAccessible()) {
@@ -210,8 +210,8 @@ bool configuration_init(std::shared_ptr<FilesystemAdapter> _filesystem) {
 }
 
 void configuration_deinit() {
-    configurationContainers.clear();
-    validators.clear();
+    makeVector<decltype(configurationContainers)::value_type>("v16.Configuration.Containers").swap(configurationContainers); //release allocated memory (see https://cplusplus.com/reference/vector/vector/clear/)
+    makeVector<decltype(validators)::value_type>("v16.Configuration.Validators").swap(validators);
     filesystem.reset();
 }
 
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index d6d09226..6b33f43c 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -8,9 +8,9 @@
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <MicroOcpp/Core/ConfigurationContainer.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Memory.h>
 
 #include <memory>
-#include <vector>
 
 #define CONFIGURATION_FN (MO_FILENAME_PREFIX "ocpp-config.jsn")
 #define CONFIGURATION_VOLATILE "/volatile"
@@ -27,7 +27,7 @@ void registerConfigurationValidator(const char *key, std::function<bool(const ch
 void addConfigurationContainer(std::shared_ptr<ConfigurationContainer> container);
 
 Configuration *getConfigurationPublic(const char *key);
-std::vector<ConfigurationContainer*> getConfigurationContainersPublic();
+Vector<ConfigurationContainer*> getConfigurationContainersPublic();
 
 bool configuration_init(std::shared_ptr<FilesystemAdapter> filesytem);
 void configuration_deinit();
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.cpp b/src/MicroOcpp/Core/ConfigurationContainer.cpp
index e0554fe7..af0cba2f 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainer.cpp
@@ -12,7 +12,8 @@ ConfigurationContainer::~ConfigurationContainer() {
 
 }
 
-ConfigurationContainerVolatile::ConfigurationContainerVolatile(const char *filename, bool accessible) : ConfigurationContainer(filename, accessible) {
+ConfigurationContainerVolatile::ConfigurationContainerVolatile(const char *filename, bool accessible) :
+        ConfigurationContainer(filename, accessible), MemoryManaged("v16.Configuration.ContainerVoltaile.", filename), configurations(makeVector<std::shared_ptr<Configuration>>(getMemoryTag())) {
 
 }
 
@@ -25,7 +26,7 @@ bool ConfigurationContainerVolatile::save() {
 }
 
 std::shared_ptr<Configuration> ConfigurationContainerVolatile::createConfiguration(TConfig type, const char *key) {
-    std::shared_ptr<Configuration> res = makeConfiguration(type, key);
+    auto res = std::shared_ptr<Configuration>(makeConfiguration(type, key).release(), std::default_delete<Configuration>(), makeAllocator<Configuration>("v16.Configuration.", key));
     if (!res) {
         //allocation failure - OOM
         MO_DBG_ERR("OOM");
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index 44382a08..f31c613c 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -5,10 +5,10 @@
 #ifndef MO_CONFIGURATIONCONTAINER_H
 #define MO_CONFIGURATIONCONTAINER_H
 
-#include <vector>
 #include <memory>
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
@@ -37,9 +37,9 @@ class ConfigurationContainer {
     virtual void loadStaticKey(Configuration& config, const char *key) { } //possible optimization: can replace internal key with passed static key
 };
 
-class ConfigurationContainerVolatile : public ConfigurationContainer {
+class ConfigurationContainerVolatile : public ConfigurationContainer, public MemoryManaged {
 private:
-    std::vector<std::shared_ptr<Configuration>> configurations;
+    Vector<std::shared_ptr<Configuration>> configurations;
 public:
     ConfigurationContainerVolatile(const char *filename, bool accessible);
 
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index ccffc9dc..9f83631f 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -6,32 +6,34 @@
 
 #include <algorithm>
 #include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Debug.h>
 
 #define MAX_CONFIGURATIONS 50
 
 namespace MicroOcpp {
 
-class ConfigurationContainerFlash : public ConfigurationContainer {
+class ConfigurationContainerFlash : public ConfigurationContainer, public MemoryManaged {
 private:
-    std::vector<std::shared_ptr<Configuration>> configurations;
+    Vector<std::shared_ptr<Configuration>> configurations;
     std::shared_ptr<FilesystemAdapter> filesystem;
     uint16_t revisionSum = 0;
 
     bool loaded = false;
 
-    std::vector<std::unique_ptr<char[]>> keyPool;
+    Vector<char*> keyPool;
     
     void clearKeyPool(const char *key) {
-        keyPool.erase(std::remove_if(keyPool.begin(), keyPool.end(), 
-            [key] (const std::unique_ptr<char[]>& k) {
-                #if MO_DBG_LEVEL >= MO_DL_VERBOSE
-                if (!strcmp(k.get(), key)) {
-                    MO_DBG_VERBOSE("clear key %s", key);
-                }
-                #endif
-                return !strcmp(k.get(), key);
-            }), keyPool.end());
+        auto it = keyPool.begin();
+        while (it != keyPool.end()) {
+            if (!strcmp(*it, key)) {
+                MO_DBG_VERBOSE("clear key %s", key);
+                MO_FREE(*it);
+                it = keyPool.erase(it);
+            } else {
+                ++it;
+            }
+        }
     }
 
     bool configurationsUpdated() {
@@ -46,8 +48,16 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
     }
 public:
     ConfigurationContainerFlash(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename, bool accessible) :
-            ConfigurationContainer(filename, accessible), filesystem(filesystem) { }
+            ConfigurationContainer(filename, accessible), MemoryManaged("v16.Configuration.ContainerFlash.", filename), configurations(makeVector<std::shared_ptr<Configuration>>(getMemoryTag())), filesystem(filesystem), keyPool(makeVector<char*>(getMemoryTag())) { }
 
+    ~ConfigurationContainerFlash() {
+        auto it = keyPool.begin();
+        while (it != keyPool.end()) {
+            MO_FREE(*it);
+            it = keyPool.erase(it);
+        }
+    }
+    
     bool load() override {
 
         if (loaded) {
@@ -65,7 +75,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
             return save();
         }
 
-        auto doc = FilesystemUtils::loadJson(filesystem, getFilename());
+        auto doc = FilesystemUtils::loadJson(filesystem, getFilename(), getMemoryTag());
         if (!doc) {
             MO_DBG_ERR("failed to load %s", getFilename());
             return false;
@@ -110,8 +120,8 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                 MO_DBG_ERR("corrupt config");
                 continue;
             }
-            
-            std::unique_ptr<char[]> key_pooled;
+
+            char *key_pooled = nullptr;
 
             auto config = getConfiguration(key).get();
             if (config && config->getType() != type) {
@@ -120,20 +130,32 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                 config = nullptr;
             }
             if (!config) {
-                key_pooled.reset(new char[strlen(key) + 1]);
-                strcpy(key_pooled.get(), key);
+                #if MO_ENABLE_HEAP_PROFILER
+                char memoryTag [64];
+                snprintf(memoryTag, sizeof(memoryTag), "%s%s", "v16.Configuration.", key);
+                #else
+                const char *memoryTag = nullptr;
+                (void)memoryTag;
+                #endif
+                key_pooled = static_cast<char*>(MO_MALLOC(memoryTag, strlen(key) + 1));
+                if (!key_pooled) {
+                    MO_DBG_ERR("OOM: %s", key);
+                    return false;
+                }
+                strcpy(key_pooled, key);
             }
 
             switch (type) {
                 case TConfig::Int: {
                     if (!stored["value"].is<int>()) {
                         MO_DBG_ERR("corrupt config");
+                        MO_FREE(key_pooled);
                         continue;
                     }
                     int value = stored["value"] | 0;
                     if (!config) {
                         //create new config
-                        config = createConfiguration(TConfig::Int, key_pooled.get()).get();
+                        config = createConfiguration(TConfig::Int, key_pooled).get();
                     }
                     if (config) {
                         config->setInt(value);
@@ -143,12 +165,13 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                 case TConfig::Bool: {
                     if (!stored["value"].is<bool>()) {
                         MO_DBG_ERR("corrupt config");
+                        MO_FREE(key_pooled);
                         continue;
                     }
                     bool value = stored["value"] | false;
                     if (!config) {
                         //create new config
-                        config = createConfiguration(TConfig::Bool, key_pooled.get()).get();
+                        config = createConfiguration(TConfig::Bool, key_pooled).get();
                     }
                     if (config) {
                         config->setBool(value);
@@ -158,12 +181,13 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                 case TConfig::String: {
                     if (!stored["value"].is<const char*>()) {
                         MO_DBG_ERR("corrupt config");
+                        MO_FREE(key_pooled);
                         continue;
                     }
                     const char *value = stored["value"] | "";
                     if (!config) {
                         //create new config
-                        config = createConfiguration(TConfig::String, key_pooled.get()).get();
+                        config = createConfiguration(TConfig::String, key_pooled).get();
                     }
                     if (config) {
                         config->setString(value);
@@ -181,6 +205,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
                 }
             } else {
                 MO_DBG_ERR("OOM: %s", key);
+                MO_FREE(key_pooled);
             }
         }
 
@@ -218,7 +243,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
             jsonCapacity = MO_MAX_JSON_CAPACITY;
         }
 
-        DynamicJsonDocument doc {jsonCapacity};
+        auto doc = initJsonDoc(getMemoryTag(), jsonCapacity);
         JsonObject head = doc.createNestedObject("head");
         head["content-type"] = "ocpp_config_file";
         head["version"] = "2.0";
@@ -267,7 +292,7 @@ class ConfigurationContainerFlash : public ConfigurationContainer {
     }
 
     std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) override {
-        std::shared_ptr<Configuration> res = makeConfiguration(type, key);
+        auto res = std::shared_ptr<Configuration>(makeConfiguration(type, key).release(), std::default_delete<Configuration>(), makeAllocator<Configuration>("v16.Configuration.", key));
         if (!res) {
             //allocation failure - OOM
             MO_DBG_ERR("OOM");
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index 9307cd40..033e371a 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -3,10 +3,10 @@
 // MIT License
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Debug.h>
 
 #include <string.h>
-#include <vector>
 #include <ArduinoJson.h>
 
 #define KEY_MAXLEN 60
@@ -89,7 +89,7 @@ bool Configuration::isReadOnly() {
  * before its initialization stage. Then the library won't create new config objects but 
  */
 
-class ConfigInt : public Configuration {
+class ConfigInt : public Configuration, public MemoryManaged {
 private:
     const char *key = nullptr;
     int val = 0;
@@ -99,6 +99,7 @@ class ConfigInt : public Configuration {
 
     bool setKey(const char *key) override {
         this->key = key;
+        updateMemoryTag("v16.Configuration.", key);
         return true;
     }
 
@@ -120,7 +121,7 @@ class ConfigInt : public Configuration {
     }
 };
 
-class ConfigBool : public Configuration {
+class ConfigBool : public Configuration, public MemoryManaged {
 private:
     const char *key = nullptr;
     bool val = false;
@@ -130,6 +131,7 @@ class ConfigBool : public Configuration {
 
     bool setKey(const char *key) override {
         this->key = key;
+        updateMemoryTag("v16.Configuration.", key);
         return true;
     }
 
@@ -151,7 +153,7 @@ class ConfigBool : public Configuration {
     }
 };
 
-class ConfigString : public Configuration {
+class ConfigString : public Configuration, public MemoryManaged {
 private:
     const char *key = nullptr;
     char *val = nullptr;
@@ -162,11 +164,15 @@ class ConfigString : public Configuration {
     ConfigString& operator=(const ConfigString&) = delete;
 
     ~ConfigString() {
-        free(val);
+        MO_FREE(val);
     }
 
     bool setKey(const char *key) override {
         this->key = key;
+        updateMemoryTag("v16.Configuration.", key);
+        if (val) {
+            MO_MEM_SET_TAG(val, getMemoryTag());
+        }
         return true;
     }
 
@@ -201,12 +207,12 @@ class ConfigString : public Configuration {
         value_revision++;
 
         if (this->val) {
-            free(this->val);
+            MO_FREE(this->val);
             this->val = nullptr;
         }
 
         if (!src_empty) {
-            this->val = (char*) malloc(size);
+            this->val = (char*) MO_MALLOC(getMemoryTag(), size);
             if (!this->val) {
                 return false;
             }
diff --git a/src/MicroOcpp/Core/Configuration_c.cpp b/src/MicroOcpp/Core/Configuration_c.cpp
index ef4903e7..f04101f2 100644
--- a/src/MicroOcpp/Core/Configuration_c.cpp
+++ b/src/MicroOcpp/Core/Configuration_c.cpp
@@ -4,11 +4,12 @@
 
 #include <MicroOcpp/Core/Configuration_c.h>
 #include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Debug.h>
 
 using namespace MicroOcpp;
 
-class ConfigurationC : public Configuration {
+class ConfigurationC : public Configuration, public MemoryManaged {
 private:
     ocpp_configuration *config;
 public:
@@ -18,6 +19,7 @@ class ConfigurationC : public Configuration {
     }
 
     bool setKey(const char *key) override {
+        updateMemoryTag("v16.Configuration.", key);
         return config->set_key(config->user_data, key);
     }
 
@@ -114,12 +116,12 @@ class ConfigurationC : public Configuration {
     }
 };
 
-class ConfigurationContainerC : public ConfigurationContainer {
+class ConfigurationContainerC : public ConfigurationContainer, public MemoryManaged {
 private:
     ocpp_configuration_container *container;
 public:
     ConfigurationContainerC(ocpp_configuration_container *container, const char *filename, bool accessible) :
-            ConfigurationContainer(filename, accessible), container(container) {
+            ConfigurationContainer(filename, accessible), MemoryManaged("v16.Configuration.ContainerC.", filename), container(container) {
 
     }
 
@@ -150,7 +152,7 @@ class ConfigurationContainerC : public ConfigurationContainer {
         ocpp_configuration *config = container->create_configuration(container->user_data, dt, key);
 
         if (config) {
-            return std::make_shared<ConfigurationC>(config);
+            return std::allocate_shared<ConfigurationC>(makeAllocator<ConfigurationC>(getMemoryTag()), config);
         } else {
             MO_DBG_ERR("could not create config: %s", key);
             return nullptr;
diff --git a/src/MicroOcpp/Core/Connection.cpp b/src/MicroOcpp/Core/Connection.cpp
index 21164e4b..ae2ee2fb 100644
--- a/src/MicroOcpp/Core/Connection.cpp
+++ b/src/MicroOcpp/Core/Connection.cpp
@@ -7,6 +7,8 @@
 
 using namespace MicroOcpp;
 
+LoopbackConnection::LoopbackConnection() : MemoryManaged("WebSocketLoopback") { }
+
 void LoopbackConnection::loop() { }
 
 bool LoopbackConnection::sendTXT(const char *msg, size_t length) {
@@ -51,7 +53,7 @@ void LoopbackConnection::setConnected(bool connected) {
 
 using namespace MicroOcpp::EspWiFi;
 
-WSClient::WSClient(WebSocketsClient *wsock) : wsock(wsock) {
+WSClient::WSClient(WebSocketsClient *wsock) : MemoryManaged("WebSocketsClient"), wsock(wsock) {
 
 }
 
diff --git a/src/MicroOcpp/Core/Connection.h b/src/MicroOcpp/Core/Connection.h
index f1df512f..2c2f7d5c 100644
--- a/src/MicroOcpp/Core/Connection.h
+++ b/src/MicroOcpp/Core/Connection.h
@@ -8,6 +8,7 @@
 #include <functional>
 #include <memory>
 
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Platform.h>
 
 //On all platforms other than Arduino, the integrated WS lib (links2004/arduinoWebSockets) cannot be
@@ -71,7 +72,7 @@ class Connection {
     virtual bool isConnected() {return true;} //MO ignores true. This default implementation keeps backwards-compatibility
 };
 
-class LoopbackConnection : public Connection {
+class LoopbackConnection : public Connection, public MemoryManaged {
 private:
     ReceiveTXTcallback receiveTXT;
 
@@ -81,6 +82,8 @@ class LoopbackConnection : public Connection {
     unsigned long lastRecv = 0;
     unsigned long lastConn = 0;
 public:
+    LoopbackConnection();
+
     void loop() override;
     bool sendTXT(const char *msg, size_t length) override;
     void setReceiveTXTcallback(ReceiveTXTcallback &receiveTXT) override;
@@ -102,7 +105,7 @@ class LoopbackConnection : public Connection {
 namespace MicroOcpp {
 namespace EspWiFi {
 
-class WSClient : public Connection {
+class WSClient : public Connection, public MemoryManaged {
 private:
     WebSocketsClient *wsock;
     unsigned long lastRecv = 0, lastConnected = 0;
diff --git a/src/MicroOcpp/Core/Context.cpp b/src/MicroOcpp/Core/Context.cpp
index f3efd3ea..1ab65fcb 100644
--- a/src/MicroOcpp/Core/Context.cpp
+++ b/src/MicroOcpp/Core/Context.cpp
@@ -12,7 +12,7 @@
 using namespace MicroOcpp;
 
 Context::Context(Connection& connection, std::shared_ptr<FilesystemAdapter> filesystem, uint16_t bootNr, ProtocolVersion version)
-        : connection(connection), model{version, bootNr}, reqQueue{connection, operationRegistry} {
+        : MemoryManaged("Context"), connection(connection), model{version, bootNr}, reqQueue{connection, operationRegistry} {
 
 }
 
diff --git a/src/MicroOcpp/Core/Context.h b/src/MicroOcpp/Core/Context.h
index eb8c0aef..2df691d1 100644
--- a/src/MicroOcpp/Core/Context.h
+++ b/src/MicroOcpp/Core/Context.h
@@ -9,6 +9,7 @@
 
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Core/RequestQueue.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Core/Ftp.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Version.h>
@@ -18,7 +19,7 @@ namespace MicroOcpp {
 class Connection;
 class FilesystemAdapter;
 
-class Context {
+class Context : public MemoryManaged {
 private:
     Connection& connection;
     OperationRegistry operationRegistry;
diff --git a/src/MicroOcpp/Core/FilesystemAdapter.cpp b/src/MicroOcpp/Core/FilesystemAdapter.cpp
index 983d0925..b442e583 100644
--- a/src/MicroOcpp/Core/FilesystemAdapter.cpp
+++ b/src/MicroOcpp/Core/FilesystemAdapter.cpp
@@ -4,6 +4,7 @@
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/ConfigurationOptions.h> //FilesystemOpt
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Debug.h>
 
 #include <cstring>
@@ -21,15 +22,13 @@
 
 #if MO_ENABLE_FILE_INDEX
 
-#include <vector>
 #include <algorithm>
-#include <string>
 
 namespace MicroOcpp {
 
 class FilesystemAdapterIndex;
 
-class IndexedFileAdapter : public FileAdapter {
+class IndexedFileAdapter : public FileAdapter, public MemoryManaged {
 private:
     FilesystemAdapterIndex& index;
     char fn [MO_MAX_PATH_SIZE];
@@ -38,7 +37,7 @@ class IndexedFileAdapter : public FileAdapter {
     size_t written = 0;
 public:
     IndexedFileAdapter(FilesystemAdapterIndex& index, const char *fn, std::unique_ptr<FileAdapter> file)
-            : index(index), file(std::move(file)) {
+            : MemoryManaged("FilesystemIndex"), index(index), file(std::move(file)) {
         snprintf(this->fn, sizeof(this->fn), "%s", fn);
     }
 
@@ -65,18 +64,18 @@ class IndexedFileAdapter : public FileAdapter {
     }
 };
 
-class FilesystemAdapterIndex : public FilesystemAdapter {
+class FilesystemAdapterIndex : public FilesystemAdapter, public MemoryManaged {
 private:
     std::shared_ptr<FilesystemAdapter> filesystem;
 
     struct IndexEntry {
-        std::string fname;
+        String fname;
         size_t size;
 
-        IndexEntry(const char *fname, size_t size) : fname(fname), size(size) { }
+        IndexEntry(const char *fname, size_t size) : fname(makeString("FilesystemIndex", fname)), size(size) { }
     };
 
-    std::vector<IndexEntry> index;
+    Vector<IndexEntry> index;
 
     IndexEntry *getEntryByFname(const char *fn) {
         auto entry = std::find_if(index.begin(), index.end(),
@@ -100,10 +99,16 @@ class FilesystemAdapterIndex : public FilesystemAdapter {
         const char *fn = path + sizeof(MO_FILENAME_PREFIX) - 1;
         return getEntryByFname(fn);
     }
+    
+    void (*onDestruct)(void*) = nullptr;
 public:
-    FilesystemAdapterIndex(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(std::move(filesystem)) { }
+    FilesystemAdapterIndex(std::shared_ptr<FilesystemAdapter> filesystem, void (*onDestruct)(void*) = nullptr) : MemoryManaged("FilesystemIndex"), filesystem(std::move(filesystem)), index(makeVector<IndexEntry>("FilesystemIndex")), onDestruct(onDestruct) { }
 
-    ~FilesystemAdapterIndex() = default;
+    ~FilesystemAdapterIndex() {
+        if (onDestruct) {
+            onDestruct(this);
+        }
+    }
 
     int stat(const char *path, size_t *size) override {
         if (auto file = getEntryByPath(path)) {
@@ -227,9 +232,9 @@ IndexedFileAdapter::~IndexedFileAdapter() {
     index.updateFilesize(fn, written);
 }
 
-std::shared_ptr<FilesystemAdapter> decorateIndex(std::shared_ptr<FilesystemAdapter> filesystem) {
+std::shared_ptr<FilesystemAdapter> decorateIndex(std::shared_ptr<FilesystemAdapter> filesystem, void (*onDestruct)(void*) = nullptr) {
 
-    auto fsIndex = std::make_shared<FilesystemAdapterIndex>(std::move(filesystem));
+    auto fsIndex = std::allocate_shared<FilesystemAdapterIndex>(makeAllocator<FilesystemAdapterIndex>("FilesystemIndex"), std::move(filesystem), onDestruct);
     if (!fsIndex) {
         MO_DBG_ERR("OOM");
         return nullptr;
@@ -260,10 +265,10 @@ std::shared_ptr<FilesystemAdapter> decorateIndex(std::shared_ptr<FilesystemAdapt
 
 namespace MicroOcpp {
 
-class ArduinoFileAdapter : public FileAdapter {
+class ArduinoFileAdapter : public FileAdapter, public MemoryManaged {
     File file;
 public:
-    ArduinoFileAdapter(File&& file) : file(file) {}
+    ArduinoFileAdapter(File&& file) : MemoryManaged("Filesystem"), file(file) {}
 
     ~ArduinoFileAdapter() {
         if (file) {
@@ -285,12 +290,14 @@ class ArduinoFileAdapter : public FileAdapter {
     }
 };
 
-class ArduinoFilesystemAdapter : public FilesystemAdapter {
+class ArduinoFilesystemAdapter : public FilesystemAdapter, public MemoryManaged {
 private:
     bool valid = false;
     FilesystemOpt config;
+
+    void (* onDestruct)(void*) = nullptr;
 public:
-    ArduinoFilesystemAdapter(FilesystemOpt config) : config(config) {
+    ArduinoFilesystemAdapter(FilesystemOpt config, void (*onDestruct)(void*) = nullptr) : MemoryManaged("Filesystem"), config(config), onDestruct(onDestruct) {
         valid = true;
 
         if (config.mustMount()) { 
@@ -322,6 +329,10 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
         if (config.mustMount()) {
             USE_FS.end();
         }
+
+        if (onDestruct) {
+            onDestruct(this);
+        }
     }
 
     operator bool() {return valid;}
@@ -427,6 +438,10 @@ class ArduinoFilesystemAdapter : public FilesystemAdapter {
 
 std::weak_ptr<FilesystemAdapter> filesystemCache;
 
+void resetFilesystemCache(void*) {
+    filesystemCache.reset();
+}
+
 std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
 
     if (auto cached = filesystemCache.lock()) {
@@ -438,11 +453,11 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
         return nullptr;
     }
 
-    auto fs_concrete = new ArduinoFilesystemAdapter(config);
-    auto fs = std::shared_ptr<FilesystemAdapter>(fs_concrete);
+    auto fs_concrete = new ArduinoFilesystemAdapter(config, resetFilesystemCache);
+    auto fs = std::shared_ptr<FilesystemAdapter>(fs_concrete, std::default_delete<FilesystemAdapter>(), makeAllocator<FilesystemAdapter>("Filesystem"));
 
 #if MO_ENABLE_FILE_INDEX
-    fs = decorateIndex(fs);
+    fs = decorateIndex(fs, resetFilesystemCache);
 #endif // MO_ENABLE_FILE_INDEX
 
     filesystemCache = fs;
@@ -468,10 +483,10 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 namespace MicroOcpp {
 
-class EspIdfFileAdapter : public FileAdapter {
+class EspIdfFileAdapter : public FileAdapter, public MemoryManaged {
     FILE *file {nullptr};
 public:
-    EspIdfFileAdapter(FILE *file) : file(file) {}
+    EspIdfFileAdapter(FILE *file) : MemoryManaged("Filesystem"), file(file) {}
 
     ~EspIdfFileAdapter() {
         fclose(file);
@@ -494,17 +509,23 @@ class EspIdfFileAdapter : public FileAdapter {
     }
 };
 
-class EspIdfFilesystemAdapter : public FilesystemAdapter {
+class EspIdfFilesystemAdapter : public FilesystemAdapter, public MemoryManaged {
 public:
     FilesystemOpt config;
+
+    void (* onDestruct)(void*) = nullptr;
 public:
-    EspIdfFilesystemAdapter(FilesystemOpt config) : config(config) { }
+    EspIdfFilesystemAdapter(FilesystemOpt config, void (* onDestruct)(void*) = nullptr) : MemoryManaged("Filesystem"), config(config), onDestruct(onDestruct) { }
 
     ~EspIdfFilesystemAdapter() {
         if (config.mustMount()) {
             esp_vfs_spiffs_unregister(MO_PARTITION_LABEL);
             MO_DBG_DEBUG("SPIFFS unmounted");
         }
+
+        if (onDestruct) {
+            onDestruct(this);
+        }
     }
 
     int stat(const char *path, size_t *size) override {
@@ -565,6 +586,10 @@ class EspIdfFilesystemAdapter : public FilesystemAdapter {
 
 std::weak_ptr<FilesystemAdapter> filesystemCache;
 
+void resetFilesystemCache(void*) {
+    filesystemCache.reset();
+}
+
 std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
 
     if (auto cached = filesystemCache.lock()) {
@@ -620,10 +645,10 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
     }
 
     if (mounted) {
-        auto fs = std::shared_ptr<FilesystemAdapter>(new EspIdfFilesystemAdapter(config));
+        auto fs = std::shared_ptr<FilesystemAdapter>(new EspIdfFilesystemAdapter(config, resetFilesystemCache), std::default_delete<FilesystemAdapter>(), makeAllocator<FilesystemAdapter>("Filesystem"));
 
 #if MO_ENABLE_FILE_INDEX
-        fs = decorateIndex(fs);
+        fs = decorateIndex(fs, resetFilesystemCache);
 #endif // MO_ENABLE_FILE_INDEX
 
         filesystemCache = fs;
@@ -643,10 +668,10 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
 
 namespace MicroOcpp {
 
-class PosixFileAdapter : public FileAdapter {
+class PosixFileAdapter : public FileAdapter, public MemoryManaged {
     FILE *file {nullptr};
 public:
-    PosixFileAdapter(FILE *file) : file(file) {}
+    PosixFileAdapter(FILE *file) : MemoryManaged("Filesystem"), file(file) {}
 
     ~PosixFileAdapter() {
         fclose(file);
@@ -669,13 +694,19 @@ class PosixFileAdapter : public FileAdapter {
     }
 };
 
-class PosixFilesystemAdapter : public FilesystemAdapter {
+class PosixFilesystemAdapter : public FilesystemAdapter, public MemoryManaged {
 public:
     FilesystemOpt config;
+
+    void (* onDestruct)(void*) = nullptr;
 public:
-    PosixFilesystemAdapter(FilesystemOpt config) : config(config) { }
+    PosixFilesystemAdapter(FilesystemOpt config, void (* onDestruct)(void*) = nullptr) : MemoryManaged("Filesystem"), config(config), onDestruct(onDestruct) { }
 
-    ~PosixFilesystemAdapter() = default;
+    ~PosixFilesystemAdapter() {
+        if (onDestruct) {
+            onDestruct(this);
+        }
+    }
 
     int stat(const char *path, size_t *size) override {
         struct ::stat st;
@@ -725,6 +756,10 @@ class PosixFilesystemAdapter : public FilesystemAdapter {
 
 std::weak_ptr<FilesystemAdapter> filesystemCache;
 
+void resetFilesystemCache(void*) {
+    filesystemCache.reset();
+}
+
 std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt config) {
 
     if (auto cached = filesystemCache.lock()) {
@@ -740,10 +775,10 @@ std::shared_ptr<FilesystemAdapter> makeDefaultFilesystemAdapter(FilesystemOpt co
         MO_DBG_DEBUG("Skip mounting on UNIX host");
     }
 
-    auto fs = std::shared_ptr<FilesystemAdapter>(new PosixFilesystemAdapter(config));
+    auto fs = std::shared_ptr<FilesystemAdapter>(new PosixFilesystemAdapter(config, resetFilesystemCache), std::default_delete<FilesystemAdapter>(), makeAllocator<FilesystemAdapter>("Filesystem"));
 
 #if MO_ENABLE_FILE_INDEX
-    fs = decorateIndex(fs);
+    fs = decorateIndex(fs, resetFilesystemCache);
 #endif // MO_ENABLE_FILE_INDEX
 
     filesystemCache = fs;
diff --git a/src/MicroOcpp/Core/FilesystemUtils.cpp b/src/MicroOcpp/Core/FilesystemUtils.cpp
index a6bd916c..de6a034d 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.cpp
+++ b/src/MicroOcpp/Core/FilesystemUtils.cpp
@@ -9,7 +9,7 @@
 
 using namespace MicroOcpp;
 
-std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn) {
+std::unique_ptr<JsonDoc> FilesystemUtils::loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const char *memoryTag) {
     if (!filesystem || !fn || *fn == '\0') {
         MO_DBG_ERR("Format error");
         return nullptr;
@@ -50,13 +50,13 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
         capacity = MO_MAX_JSON_CAPACITY;
     }
     
-    auto doc = std::unique_ptr<DynamicJsonDocument>(nullptr);
+    std::unique_ptr<JsonDoc> doc;
     DeserializationError err = DeserializationError::NoMemory;
     ArduinoJsonFileAdapter fileReader {file.get()};
 
     while (err == DeserializationError::NoMemory && capacity <= MO_MAX_JSON_CAPACITY) {
 
-        doc.reset(new DynamicJsonDocument(capacity));
+        doc = makeJsonDoc(memoryTag, capacity);
         err = deserializeJson(*doc, fileReader);
 
         capacity *= 2;
@@ -75,7 +75,7 @@ std::unique_ptr<DynamicJsonDocument> FilesystemUtils::loadJson(std::shared_ptr<F
     return doc;
 }
 
-bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const DynamicJsonDocument& doc) {
+bool FilesystemUtils::storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const JsonDoc& doc) {
     if (!filesystem || !fn || *fn == '\0') {
         MO_DBG_ERR("Format error");
         return false;
diff --git a/src/MicroOcpp/Core/FilesystemUtils.h b/src/MicroOcpp/Core/FilesystemUtils.h
index 962ca353..31a36a73 100644
--- a/src/MicroOcpp/Core/FilesystemUtils.h
+++ b/src/MicroOcpp/Core/FilesystemUtils.h
@@ -6,6 +6,7 @@
 #define MO_FILESYSTEMUTILS_H
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <ArduinoJson.h>
 #include <memory>
 
@@ -36,8 +37,8 @@ class ArduinoJsonFileAdapter {
 
 namespace FilesystemUtils {
 
-std::unique_ptr<DynamicJsonDocument> loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn);
-bool storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const DynamicJsonDocument& doc);
+std::unique_ptr<JsonDoc> loadJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const char *memoryTag = nullptr);
+bool storeJson(std::shared_ptr<FilesystemAdapter> filesystem, const char *fn, const JsonDoc& doc);
 
 bool remove_if(std::shared_ptr<FilesystemAdapter> filesystem, std::function<bool(const char*)> pred);
 
diff --git a/src/MicroOcpp/Core/FtpMbedTLS.cpp b/src/MicroOcpp/Core/FtpMbedTLS.cpp
index dac7bbe4..b40015b9 100644
--- a/src/MicroOcpp/Core/FtpMbedTLS.cpp
+++ b/src/MicroOcpp/Core/FtpMbedTLS.cpp
@@ -6,7 +6,6 @@
 
 #if MO_ENABLE_MBEDTLS
 
-#include <string>
 #include <string.h>
 #include <functional>
 
@@ -17,11 +16,12 @@
 #include "mbedtls/x509.h"
 #include "mbedtls/error.h"
 
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Debug.h>
 
 namespace MicroOcpp {
 
-class FtpTransferMbedTLS : public FtpUpload, public FtpDownload {
+class FtpTransferMbedTLS : public FtpUpload, public FtpDownload, public MemoryManaged {
 private:
     //MbedTLS common
     mbedtls_entropy_context entropy;
@@ -49,15 +49,15 @@ class FtpTransferMbedTLS : public FtpUpload, public FtpDownload {
     bool data_conn_accepted = false; //Server sent okay to upload / download data
 
     //FTP URL
-    std::string user;
-    std::string pass;
-    std::string ctrl_host;
-    std::string ctrl_port;
-    std::string dir;
-    std::string fname;
+    String user;
+    String pass;
+    String ctrl_host;
+    String ctrl_port;
+    String dir;
+    String fname;
 
-    std::string data_host;
-    std::string data_port;
+    String data_host;
+    String data_port;
 
     bool read_url_ctrl(const char *ftp_url);
     bool read_url_data(const char *data_url);
@@ -111,7 +111,7 @@ class FtpTransferMbedTLS : public FtpUpload, public FtpDownload {
             const char *ca_cert = nullptr); // nullptr to disable cert check; will be ignored for non-TLS connections
 };
 
-class FtpClientMbedTLS : public FtpClient {
+class FtpClientMbedTLS : public FtpClient, public MemoryManaged {
 private:
     const char *client_cert = nullptr;
     const char *client_key = nullptr;
@@ -163,8 +163,20 @@ void mo_mbedtls_log(void *user, int level, const char *file, int line, const cha
  * FTP implementation
  */
 
-FtpTransferMbedTLS::FtpTransferMbedTLS(bool tls_only, const char *client_cert, const char *client_key) 
-        : client_cert(client_cert), client_key(client_key), isSecure(tls_only) {
+FtpTransferMbedTLS::FtpTransferMbedTLS(bool tls_only, const char *client_cert, const char *client_key) : 
+        MemoryManaged("FTP.TransferMbedTLS"),
+        client_cert(client_cert),
+        client_key(client_key),
+        isSecure(tls_only),
+        user(makeString(getMemoryTag())),
+        pass(makeString(getMemoryTag())),
+        ctrl_host(makeString(getMemoryTag())),
+        ctrl_port(makeString(getMemoryTag())),
+        dir(makeString(getMemoryTag())),
+        fname(makeString(getMemoryTag())),
+        data_host(makeString(getMemoryTag())),
+        data_port(makeString(getMemoryTag())) {
+
     mbedtls_net_init(&ctrl_fd);
     mbedtls_ssl_init(&ctrl_ssl);
     mbedtls_net_init(&data_fd);
@@ -182,7 +194,7 @@ FtpTransferMbedTLS::~FtpTransferMbedTLS() {
         onClose(MO_FtpCloseReason_Failure); //data connection not closed properly
         onClose = nullptr;
     }
-    delete[] data_buf;
+    MO_FREE(data_buf);
     mbedtls_x509_crt_free(&clicert);
     mbedtls_x509_crt_free(&cacert);
     mbedtls_pk_free(&pkey);
@@ -319,11 +331,12 @@ int FtpTransferMbedTLS::connect_data() {
     }
 
     if (!data_buf) {
-        data_buf = new unsigned char[data_buf_size];
+        data_buf = static_cast<unsigned char*>(MO_MALLOC(getMemoryTag(), data_buf_size));
         if (!data_buf) {
             MO_DBG_ERR("OOM");
             return -1;
         }
+        memset(data_buf, 0, data_buf_size);
     }
 
     return 0; //success
@@ -779,7 +792,7 @@ bool FtpTransferMbedTLS::isActive() {
 }
 
 bool FtpTransferMbedTLS::read_url_ctrl(const char *ftp_url_raw) {
-    std::string ftp_url = ftp_url_raw; //copy input ftp_url
+    String ftp_url = makeString(getMemoryTag(), ftp_url_raw); //copy input ftp_url
 
     //tolower protocol specifier
     for (auto c = ftp_url.begin(); *c != ':' && c != ftp_url.end(); c++) {
@@ -787,7 +800,7 @@ bool FtpTransferMbedTLS::read_url_ctrl(const char *ftp_url_raw) {
     }
 
     //parse FTP URL: protocol specifier
-    std::string proto;
+    String proto = makeString(getMemoryTag());
     if (!strncmp(ftp_url.c_str(), "ftps://", strlen("ftps://"))) {
         //FTP over TLS (RFC 4217)
         proto = "ftps://";
@@ -802,7 +815,7 @@ bool FtpTransferMbedTLS::read_url_ctrl(const char *ftp_url_raw) {
 
     //parse FTP URL: dir and fname
     auto dir_pos = ftp_url.find_first_of('/', proto.length());
-    if (dir_pos != std::string::npos) {
+    if (dir_pos != String::npos) {
         auto fname_pos = ftp_url.find_last_of('/');
         dir = ftp_url.substr(dir_pos, fname_pos - dir_pos);
         fname = ftp_url.substr(fname_pos + 1);
@@ -817,10 +830,11 @@ bool FtpTransferMbedTLS::read_url_ctrl(const char *ftp_url_raw) {
 
     //parse FTP URL: user, pass, host, port
 
-    std::string user_pass_host_port = ftp_url.substr(proto.length(), dir_pos - proto.length());
-    std::string user_pass, host_port;
+    String user_pass_host_port = ftp_url.substr(proto.length(), dir_pos - proto.length());
+    String user_pass = makeString(getMemoryTag());
+    String host_port = makeString(getMemoryTag());
     auto user_pass_delim = user_pass_host_port.find_first_of('@');
-    if (user_pass_delim != std::string::npos) {
+    if (user_pass_delim != String::npos) {
         host_port = user_pass_host_port.substr(user_pass_delim + 1);
         user_pass = user_pass_host_port.substr(0, user_pass_delim);
     } else {
@@ -829,7 +843,7 @@ bool FtpTransferMbedTLS::read_url_ctrl(const char *ftp_url_raw) {
 
     if (!user_pass.empty()) {
         auto user_delim = user_pass.find_first_of(':');
-        if (user_delim != std::string::npos) {
+        if (user_delim != String::npos) {
             user = user_pass.substr(0, user_delim);
             pass = user_pass.substr(user_delim + 1);
         } else {
@@ -845,7 +859,7 @@ bool FtpTransferMbedTLS::read_url_ctrl(const char *ftp_url_raw) {
     }
 
     auto host_port_delim = host_port.find(':');
-    if (host_port_delim != std::string::npos) {
+    if (host_port_delim != String::npos) {
         ctrl_host = host_port.substr(0, host_port_delim);
         ctrl_port = host_port.substr(host_port_delim + 1);
     } else {
@@ -861,7 +875,7 @@ bool FtpTransferMbedTLS::read_url_ctrl(const char *ftp_url_raw) {
 
 bool FtpTransferMbedTLS::read_url_data(const char *data_url_raw) {
 
-    std::string data_url = data_url_raw; //format like " Entering Passive Mode (h1,h2,h3,h4,p1,p2)"
+    String data_url = makeString(getMemoryTag(), data_url_raw); //format like " Entering Passive Mode (h1,h2,h3,h4,p1,p2)"
 
     // parse address field. Replace all non-digits by delimiter character ' '
     for (char& c : data_url) {
@@ -899,7 +913,7 @@ bool FtpTransferMbedTLS::read_url_data(const char *data_url_raw) {
 }
 
 FtpClientMbedTLS::FtpClientMbedTLS(bool tls_only, const char *client_cert, const char *client_key)
-        : client_cert(client_cert), client_key(client_key), tls_only(tls_only) {
+        : MemoryManaged("FTP.ClientMbedTLS"), client_cert(client_cert), client_key(client_key), tls_only(tls_only) {
 
 }
 
diff --git a/src/MicroOcpp/Core/Memory.cpp b/src/MicroOcpp/Core/Memory.cpp
new file mode 100644
index 00000000..26500b2b
--- /dev/null
+++ b/src/MicroOcpp/Core/Memory.cpp
@@ -0,0 +1,294 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Core/Memory.h>
+#include <MicroOcpp/Debug.h>
+
+#if MO_OVERRIDE_ALLOCATION && MO_ENABLE_HEAP_PROFILER
+
+#include <map>
+
+namespace MicroOcpp {
+namespace Memory {
+
+struct MemBlockInfo {
+    void* tagger_ptr = nullptr;
+    std::string tag;
+    size_t size = 0;
+
+    MemBlockInfo(void* ptr, const char *tag, size_t size) : size{size} {
+        updateTag(ptr, tag);
+    }
+
+    void updateTag(void* ptr, const char *tag);
+};
+
+std::map<void*,MemBlockInfo> memBlocks; //key: memory address of malloc'd block
+
+struct MemTagInfo {
+    size_t current_size = 0;
+    size_t max_size = 0;
+
+    MemTagInfo(size_t size) {
+        operator+=(size);
+    }
+
+    void operator+=(size_t size) {
+        current_size += size;
+        max_size = std::max(max_size, current_size);
+    }
+
+    void operator-=(size_t size) {
+        if (size > current_size) {
+            MO_DBG_ERR("captured size does not fit");
+            //return; let it happen for now
+        }
+        current_size -= size;
+    }
+
+    void reset() {
+        max_size = current_size;
+    }
+};
+
+std::map<std::string,MemTagInfo> memTags;
+
+size_t memTotal, memTotalMax;
+
+void MemBlockInfo::updateTag(void* ptr, const char *tag) {
+    if (!tag) {
+        return;
+    }
+    if (tagger_ptr == nullptr || ptr < tagger_ptr) {
+        MO_DBG_VERBOSE("update tag from %s to %s, ptr from %p to %p", this->tag.c_str(), tag, tagger_ptr, ptr);
+
+        auto tagInfo = memTags.find(this->tag);
+        if (tagInfo != memTags.end()) {
+            tagInfo->second -= size;
+        }
+
+        tagInfo = memTags.find(tag);
+        if (tagInfo != memTags.end()) {
+            tagInfo->second += size;
+        } else {
+            memTags.emplace(tag, size);
+        }
+
+        tagger_ptr = ptr;
+        this->tag = tag;
+    }
+}
+
+} //namespace Memory
+} //namespace MicroOcpp
+
+#endif //MO_OVERRIDE_ALLOCATION && MO_ENABLE_HEAP_PROFILER
+
+#if MO_OVERRIDE_ALLOCATION
+
+namespace MicroOcpp {
+namespace Memory {
+
+void* (*malloc_override)(size_t);
+void (*free_override)(void*);
+
+}
+}
+
+using namespace MicroOcpp::Memory;
+
+void mo_mem_set_malloc_free(void* (*malloc_override)(size_t), void (*free_override)(void*)) {
+    MicroOcpp::Memory::malloc_override = malloc_override;
+    MicroOcpp::Memory::free_override = free_override;
+}
+
+void *mo_mem_malloc(const char *tag, size_t size) {
+    MO_DBG_VERBOSE("malloc %zu B (%s)", size, tag ? tag : "unspecified");
+
+    void *ptr;
+    if (malloc_override) {
+        ptr = malloc_override(size);
+    } else {
+        ptr = malloc(size);
+    }
+
+    #if MO_ENABLE_HEAP_PROFILER
+    if (ptr) {
+        memBlocks.emplace(ptr, MemBlockInfo(ptr, tag, size));
+
+        memTotal += size;
+        memTotalMax = std::max(memTotalMax, memTotal);
+    }
+    #endif
+    return ptr;
+}
+
+void mo_mem_free(void* ptr) {
+    MO_DBG_VERBOSE("free");
+
+    #if MO_ENABLE_HEAP_PROFILER
+    if (ptr) {
+
+        auto blockInfo = memBlocks.find(ptr);
+        if (blockInfo != memBlocks.end()) {
+            auto tagInfo = memTags.find(blockInfo->second.tag);
+            if (tagInfo != memTags.end()) {
+                tagInfo->second -= blockInfo->second.size;
+            }
+            memTotal -= blockInfo->second.size;
+        }
+
+        if (blockInfo != memBlocks.end()) {
+            memBlocks.erase(blockInfo);
+        }
+    }
+    #endif
+
+    if (free_override) {
+        free_override(ptr);
+    } else {
+        free(ptr);
+    }
+}
+
+#endif //MO_OVERRIDE_ALLOCATION
+
+#if MO_OVERRIDE_ALLOCATION && MO_ENABLE_HEAP_PROFILER
+
+void mo_mem_deinit() {
+    memBlocks.clear();
+    memTags.clear();
+}
+
+void mo_mem_reset() {
+    MO_DBG_DEBUG("Reset all maximum values to current values");
+
+    auto tagInfo = memTags.begin();
+    if (tagInfo != memTags.end()) {
+        tagInfo->second.reset();
+    }
+
+    memTotalMax = memTotal;
+}
+
+void mo_mem_set_tag(void *ptr, const char *tag) {
+    MO_DBG_VERBOSE("set tag (%s)", tag ? tag : "unspecified");
+
+    if (!tag) {
+        return;
+    }
+
+    bool hasTagged = false;
+
+    if (tag) {
+        auto foundBlock = memBlocks.upper_bound(ptr);
+        if (foundBlock != memBlocks.begin()) {
+            --foundBlock;
+        }
+        if (foundBlock != memBlocks.end() &&
+                (unsigned char*)ptr - (unsigned char*)foundBlock->first < (std::ptrdiff_t)foundBlock->second.size) {
+            foundBlock->second.updateTag(ptr, tag);
+            hasTagged = true;
+        }
+    }
+
+    if (!hasTagged) {
+        MO_DBG_VERBOSE("memory area doesn't apply");
+    }
+}
+
+void mo_mem_print_stats() {
+
+    MO_CONSOLE_PRINTF("\n *** Heap usage statistics ***\n");
+
+    size_t size = 0;
+
+    size_t untagged = 0, untagged_size = 0;
+
+    for (const auto& heapEntry : memBlocks) {
+        size += heapEntry.second.size;
+        #if MO_DBG_LEVEL >= MO_DL_DEBUG
+        {
+            MO_CONSOLE_PRINTF("@%p - %zu B (%s)\n", heapEntry.first, heapEntry.second.size, heapEntry.second.tag.c_str());
+        }
+        #endif
+
+        if (heapEntry.second.tag.empty()) {
+            untagged ++;
+            untagged_size += heapEntry.second.size;
+        }
+    }
+
+    std::map<std::string, size_t> tags;
+    for (const auto& heapEntry : memBlocks) {
+        auto foundTag = tags.find(heapEntry.second.tag);
+        if (foundTag != tags.end()) {
+            foundTag->second += heapEntry.second.size;
+        } else {
+            tags.emplace(heapEntry.second.tag, heapEntry.second.size);
+        }
+    }
+
+    size_t size_control = 0;
+
+    for (const auto& tag : tags) {
+        size_control += tag.second;
+        #if MO_DBG_LEVEL >= MO_DL_VERBOSE
+        {
+            MO_CONSOLE_PRINTF("%s - %zu B\n", tag.first.c_str(), tag.second);
+        }
+        #endif
+    }
+
+    size_t size_control2 = 0;
+    for (const auto& tag : memTags) {
+        size_control2 += tag.second.current_size;
+        MO_CONSOLE_PRINTF("%s - %zu B (max. %zu B)\n", tag.first.c_str(), tag.second.current_size, tag.second.max_size);
+    }
+
+    MO_CONSOLE_PRINTF(" *** Summary ***\nBlocks: %zu\nTags: %zu\nCurrent usage: %zu B\nMaximum usage: %zu B\n", memBlocks.size(), memTags.size(), memTotal, memTotalMax);
+    #if MO_DBG_LEVEL >= MO_DL_DEBUG
+    {
+        MO_CONSOLE_PRINTF(" *** Debug information ***\nTotal blocks (control value 1): %zu B\nTags (control value): %zu\nTotal tagged (control value 2): %zu B\nTotal tagged (control value 3): %zu B\nUntagged: %zu\nTotal untagged: %zu B\n", size, tags.size(), size_control, size_control2, untagged, untagged_size);
+    }
+    #endif
+}
+
+#endif //MO_OVERRIDE_ALLOCATION && MO_ENABLE_HEAP_PROFILER
+
+namespace MicroOcpp {
+
+String makeString(const char *tag, const char *val) {
+#if MO_OVERRIDE_ALLOCATION
+    if (val) {
+        return String(val, Allocator<char>(tag));
+    } else {
+        return String(Allocator<char>(tag));
+    }
+#else
+    if (val) {
+        return String(val);
+    } else {
+        return String();
+    }
+#endif
+}
+
+JsonDoc initJsonDoc(const char *tag, size_t capacity) {
+#if MO_OVERRIDE_ALLOCATION
+    return JsonDoc(capacity, ArduinoJsonAllocator(tag));
+#else
+    return JsonDoc(capacity);
+#endif
+}
+
+std::unique_ptr<JsonDoc> makeJsonDoc(const char *tag, size_t capacity) {
+#if MO_OVERRIDE_ALLOCATION
+    return std::unique_ptr<JsonDoc>(new JsonDoc(capacity, ArduinoJsonAllocator(tag)));
+#else
+    return std::unique_ptr<JsonDoc>(new JsonDoc(capacity));
+#endif
+}
+
+}
diff --git a/src/MicroOcpp/Core/Memory.h b/src/MicroOcpp/Core/Memory.h
new file mode 100644
index 00000000..bca25a84
--- /dev/null
+++ b/src/MicroOcpp/Core/Memory.h
@@ -0,0 +1,444 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_MEMORY_H
+#define MO_MEMORY_H
+
+#include <stddef.h>
+
+#ifndef MO_OVERRIDE_ALLOCATION
+#define MO_OVERRIDE_ALLOCATION 0
+#endif
+
+#ifndef MO_ENABLE_EXTERNAL_RAM
+#define MO_ENABLE_EXTERNAL_RAM 0
+#endif
+
+#ifndef MO_ENABLE_HEAP_PROFILER
+#define MO_ENABLE_HEAP_PROFILER 0
+#endif
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if MO_OVERRIDE_ALLOCATION
+
+void mo_mem_set_malloc_free(void* (*malloc_override)(size_t), void (*free_override)(void*)); //pass custom malloc and free function to be used with the OCPP lib. If not set or NULL, defaults to standard malloc
+
+void *mo_mem_malloc(const char *tag, size_t size);
+
+void mo_mem_free(void* ptr);
+
+#define MO_MALLOC mo_mem_malloc
+#define MO_FREE mo_mem_free
+
+#else
+#define MO_MALLOC(TAG, SIZE) malloc(SIZE) //default malloc provided by host system
+#define MO_FREE(PTR) free(PTR)       //default free provided by host system
+#endif //MO_OVERRIDE_ALLOCATION
+
+
+#if MO_OVERRIDE_ALLOCATION && MO_ENABLE_HEAP_PROFILER
+
+void mo_mem_deinit(); //release allocated memory and deinit
+void mo_mem_reset(); //reset maximum heap occuption
+
+void mo_mem_set_tag(void *ptr, const char *tag);
+
+void mo_mem_get_current_heap(const char *tag);
+void mo_mem_get_maximum_heap(const char *tag);
+void mo_mem_get_current_heap_by_tag(const char *tag);
+void mo_mem_get_maximum_heap_by_tag(const char *tag);
+
+int mo_mem_write_stats_json(char *buf, size_t size);
+
+void mo_mem_print_stats();
+
+#define MO_MEM_DEINIT mo_mem_deinit
+#define MO_MEM_RESET mo_mem_reset
+#define MO_MEM_SET_TAG mo_mem_set_tag
+#define MO_MEM_PRINT_STATS mo_mem_print_stats
+
+#else
+#define MO_MEM_DEINIT(...) (void)0
+#define MO_MEM_RESET(...) (void)0
+#define MO_MEM_SET_TAG(...) (void)0
+#define MO_MEM_PRINT_STATS(...) (void)0
+#endif //MO_OVERRIDE_ALLOCATION && MO_ENABLE_HEAP_PROFILER
+
+
+#if MO_ENABLE_EXTERNAL_RAM
+
+void mo_mem_set_malloc_free_ext(void* (*malloc_override)(size_t), void (*free_override)(void*)); //pass malloc and free function to external RAM to be used with the OCPP lib. If not set or NULL, defaults to standard malloc
+
+void *mo_mem_malloc_ext(const char *tag, size_t size);
+
+void mo_mem_free_ext(void* ptr);
+
+#define MO_MALLOC_EXT(TAG, SIZE) mo_mem_malloc_ext(TAG, SIZE)
+#define MO_FREE_EXT(PTR) mo_mem_free_ext(PTR)
+
+#else
+#define MO_MALLOC_EXT MO_MALLOC
+#define MO_FREE_EXT MO_FREE
+#endif //MO_ENABLE_EXTERNAL_RAM
+
+
+#ifdef __cplusplus
+}
+
+
+#include <memory>
+#include <string>
+#include <vector>
+
+#include <ArduinoJson.h>
+
+#if MO_OVERRIDE_ALLOCATION
+
+#include <string.h>
+
+namespace MicroOcpp {
+
+class MemoryManaged {
+private:
+    #if MO_ENABLE_HEAP_PROFILER
+    char *tag = nullptr;
+    #endif
+protected:
+    void updateMemoryTag(const char *src1, const char *src2 = nullptr) {
+        #if MO_ENABLE_HEAP_PROFILER
+        if (!src1 && !src2) {
+            //empty source does not update tag
+            return;
+        }
+        char src [64];
+        snprintf(src, sizeof(src), "%s%s", src1 ? src1 : "", src2 ? src2 : "");
+        if (tag) {
+            if (!strcmp(src, tag)) {
+                //nothing to do
+                return;
+            }
+            MO_FREE(tag);
+            tag = nullptr;
+        }
+        size_t size = strlen(src) + 1;
+        tag = static_cast<char*>(malloc(size)); //heap profiler bypasses custom malloc to not count into the statistics
+        memset(tag, 0, size);
+        snprintf(tag, size, "%s", src);
+        mo_mem_set_tag(this, tag);
+        #else
+        (void)src1;
+        (void)src2;
+        #endif
+    }
+    const char *getMemoryTag() const {
+        #if MO_ENABLE_HEAP_PROFILER
+        return tag;
+        #else
+        return nullptr;
+        #endif
+    }
+public:
+    void *operator new(size_t size) {
+        return MO_MALLOC(nullptr, size);
+    }
+    void operator delete(void * ptr) {
+        MO_FREE(ptr);
+    }
+
+    MemoryManaged(const char *tag = nullptr, const char *tag_suffix = nullptr) {
+        #if MO_ENABLE_HEAP_PROFILER
+        updateMemoryTag(tag, tag_suffix);
+        #endif
+    }
+
+    MemoryManaged(MemoryManaged&& other) {
+        #if MO_ENABLE_HEAP_PROFILER
+        tag = other.tag;
+        other.tag = nullptr;
+        #endif
+    }
+
+    ~MemoryManaged() {
+        #if MO_ENABLE_HEAP_PROFILER
+        MO_FREE(tag);
+        tag = nullptr;
+        #endif
+    }
+
+    void operator=(const MemoryManaged& other) {
+        #if MO_ENABLE_HEAP_PROFILER
+        updateMemoryTag(other.tag);
+        #endif
+    }
+};
+
+template<class T>
+struct Allocator {
+
+    Allocator(const char *tag = nullptr, const char *tag_suffix = nullptr) {
+        #if MO_ENABLE_HEAP_PROFILER
+        updateMemoryTag(tag, tag_suffix);
+        #endif
+    }
+
+    template<class U>
+    Allocator(const Allocator<U>& other) {
+        #if MO_ENABLE_HEAP_PROFILER
+        updateMemoryTag(other.tag);
+        #endif
+    }
+
+    Allocator(const Allocator& other) {
+        #if MO_ENABLE_HEAP_PROFILER
+        updateMemoryTag(other.tag);
+        #endif
+    }
+
+    //template<class U>
+    //Allocator(Allocator<U>&& other) {
+    Allocator(Allocator&& other) {
+        #if MO_ENABLE_HEAP_PROFILER
+        updateMemoryTag(other.tag); //ignore move semantics for allocators as it simplifies moving std::vector<T, Allocator<T>>. This is okay because the Allocator's state is only the memory tag which is not exclusively owned
+        #endif
+    }
+
+    ~Allocator() {
+        #if MO_ENABLE_HEAP_PROFILER
+        if (tag) {
+            //MO_FREE(tag);
+            free(tag);
+            tag = nullptr;
+        }
+        #endif
+    }
+
+    T *allocate(size_t count) {
+        #if MO_ENABLE_HEAP_PROFILER
+            return static_cast<T*>(MO_MALLOC(tag, sizeof(T) * count));
+        #else
+            return static_cast<T*>(MO_MALLOC(nullptr, sizeof(T) * count));
+        #endif
+    }
+
+    void deallocate(T *ptr, size_t count) {
+        MO_FREE(ptr);
+    }
+
+    bool operator==(const Allocator<T>& other) {
+        #if MO_ENABLE_HEAP_PROFILER
+        if (!tag && !other.tag) {
+            return true;
+        } else if (tag && other.tag) {
+            return !strcmp(tag, other.tag);
+        } else {
+            return false;
+        }
+        #else
+        return true;
+        #endif
+    }
+
+    bool operator!=(const Allocator<T>& other) {
+        return !operator==(other);
+    }
+
+    typedef T value_type;
+
+    #if MO_ENABLE_HEAP_PROFILER
+    char *tag = nullptr;
+
+    void updateMemoryTag(const char *src1, const char *src2 = nullptr) {
+        if (!src1 && !src2) {
+            //empty source does not update tag
+            return;
+        }
+        char src [64];
+        snprintf(src, sizeof(src), "%s%s", src1 ? src1 : "", src2 ? src2 : "");
+        if (tag) {
+            if (!strcmp(src, tag)) {
+                //nothing to do
+                return;
+            }
+            //MO_FREE(tag);
+            free(tag);
+            tag = nullptr;
+        }
+        size_t size = strlen(src) + 1;
+        tag = static_cast<char*>(malloc(size));
+        memset(tag, 0, size);
+        snprintf(tag, size, "%s", src);
+    }
+    #endif
+};
+
+template<class T>
+Allocator<T> makeAllocator(const char *tag, const char *tag_suffix = nullptr) {
+    return Allocator<T>(tag, tag_suffix);
+}
+
+using String = std::basic_string<char, std::char_traits<char>, MicroOcpp::Allocator<char>>;
+
+template<class T>
+using Vector = std::vector<T, Allocator<T>>;
+
+template<class T>
+Vector<T> makeVector(const char *tag) {
+    return Vector<T>(Allocator<T>(tag));
+}
+
+class ArduinoJsonAllocator {
+private:
+    #if MO_ENABLE_HEAP_PROFILER
+    char *tag = nullptr;
+
+    void updateMemoryTag(const char *src1, const char *src2 = nullptr) {
+        if (!src1 && !src2) {
+            //empty source does not update tag
+            return;
+        }
+        char src [64];
+        snprintf(src, sizeof(src), "%s%s", src1 ? src1 : "", src2 ? src2 : "");
+        if (tag) {
+            if (!strcmp(src, tag)) {
+                //nothing to do
+                return;
+            }
+            MO_FREE(tag);
+            tag = nullptr;
+        }
+        size_t size = strlen(src) + 1;
+        //tag = static_cast<char*>(MO_MALLOC("HeapProfilerInternal", size));
+        tag = static_cast<char*>(malloc(size));
+        memset(tag, 0, size);
+        snprintf(tag, size, "%s", src);
+    }
+    #endif
+public:
+
+    ArduinoJsonAllocator(const char *tag = nullptr, const char *tag_suffix = nullptr) {
+        #if MO_ENABLE_HEAP_PROFILER
+        updateMemoryTag(tag, tag_suffix);
+        #endif
+    }
+
+    ArduinoJsonAllocator(const ArduinoJsonAllocator& other) {
+        #if MO_ENABLE_HEAP_PROFILER
+        updateMemoryTag(other.tag);
+        #endif
+    }
+
+    ArduinoJsonAllocator(ArduinoJsonAllocator&& other) {
+        #if MO_ENABLE_HEAP_PROFILER
+        tag = other.tag;
+        other.tag = nullptr;
+        #endif
+    }
+
+    ~ArduinoJsonAllocator() {
+        #if MO_ENABLE_HEAP_PROFILER
+        if (tag) {
+            MO_FREE(tag);
+            tag = nullptr;
+        }
+        #endif
+    }
+
+    void *allocate(size_t size) {
+        #if MO_ENABLE_HEAP_PROFILER
+            return MO_MALLOC(tag, size);
+        #else
+            return MO_MALLOC(nullptr, size);
+        #endif
+    }
+    void deallocate(void *ptr) {
+        MO_FREE(ptr);
+    }
+};
+
+using JsonDoc = BasicJsonDocument<ArduinoJsonAllocator>;
+
+template<class T, typename ...Args>
+T *mo_mem_new(const char *tag, Args&& ...args)  {
+    if (auto ptr = MO_MALLOC(tag, sizeof(T))) {
+        return new(ptr) T(std::forward<Args>(args)...);
+    }
+    return nullptr; //OOM
+}
+
+template<class T>
+void mo_mem_delete(T *ptr)  {
+    if (ptr) {
+        ptr->~T();
+        MO_FREE(ptr);
+    }
+}
+
+} //namespace MicroOcpp
+
+#else
+
+#include <memory>
+
+namespace MicroOcpp {
+
+class MemoryManaged {
+protected:
+    const char *getMemoryTag() const {return nullptr;}
+    void updateMemoryTag(const char*,const char*) { } 
+public:
+    MemoryManaged() { }
+    MemoryManaged(const char*) { }
+    MemoryManaged(const char*,const char*) { }
+};
+
+template<class T>
+using Allocator = ::std::allocator<T>;
+
+template<class T>
+Allocator<T> makeAllocator(const char *, const char *unused = nullptr) {
+    (void)unused;
+    return Allocator<T>();
+}
+
+using String = std::string;
+
+template<class T>
+using Vector = std::vector<T>;
+
+template<class T>
+Vector<T> makeVector(const char *tag) {
+    return Vector<T>();
+}
+
+using JsonDoc = DynamicJsonDocument;
+
+template <class T, typename ...Args>
+T *mo_mem_new(Args&& ...args)  {
+    return new T(std::forward<Args>(args)...);
+}
+
+template<class T>
+void mo_mem_delete(T *ptr)  {
+    delete ptr;
+}
+
+} //namespace MicroOcpp
+
+#endif //MO_OVERRIDE_ALLOCATION
+
+namespace MicroOcpp {
+
+String makeString(const char *tag, const char *val = nullptr);
+
+JsonDoc initJsonDoc(const char *tag, size_t capacity = 0);
+std::unique_ptr<JsonDoc> makeJsonDoc(const char *tag, size_t capacity = 0);
+
+}
+
+#endif //__cplusplus
+#endif
diff --git a/src/MicroOcpp/Core/OcppError.h b/src/MicroOcpp/Core/OcppError.h
index 759eac40..826c3215 100644
--- a/src/MicroOcpp/Core/OcppError.h
+++ b/src/MicroOcpp/Core/OcppError.h
@@ -5,33 +5,34 @@
 #ifndef MO_OCPPERROR_H
 #define MO_OCPPERROR_H
 
-#include <ArduinoJson.h>
-
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
-class NotImplemented : public Operation {
+class NotImplemented : public Operation, public MemoryManaged {
 public:
+    NotImplemented() : MemoryManaged("v16.CallError.", "NotImplemented") { }
+
     const char *getErrorCode() override {
         return "NotImplemented";
     }
 };
 
-class MsgBufferExceeded : public Operation {
+class MsgBufferExceeded : public Operation, public MemoryManaged {
 private:
     size_t maxCapacity;
     size_t msgLen;
 public:
-    MsgBufferExceeded(size_t maxCapacity, size_t msgLen) : maxCapacity(maxCapacity), msgLen(msgLen) { }
+    MsgBufferExceeded(size_t maxCapacity, size_t msgLen) : MemoryManaged("v16.CallError.", "GenericError"), maxCapacity(maxCapacity), msgLen(msgLen) { }
     const char *getErrorCode() override {
         return "GenericError";
     }
     const char *getErrorDescription() override {
         return "JSON too long or too many fields. Cannot deserialize";
     }
-    std::unique_ptr<DynamicJsonDocument> getErrorDetails() override {
-        auto errDoc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+    std::unique_ptr<JsonDoc> getErrorDetails() override {
+        auto errDoc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(2));
         JsonObject err = errDoc->to<JsonObject>();
         err["max_capacity"] = maxCapacity;
         err["msg_length"] = msgLen;
diff --git a/src/MicroOcpp/Core/Operation.cpp b/src/MicroOcpp/Core/Operation.cpp
index 63d76a20..1289381b 100644
--- a/src/MicroOcpp/Core/Operation.cpp
+++ b/src/MicroOcpp/Core/Operation.cpp
@@ -6,7 +6,7 @@
 
 #include <MicroOcpp/Debug.h>
 
-using MicroOcpp::Operation;
+using namespace MicroOcpp;
 
 Operation::Operation() {}
 
@@ -17,7 +17,7 @@ const char* Operation::getOperationType(){
     return "CustomOperation";
 }
 
-std::unique_ptr<DynamicJsonDocument> Operation::createReq() {
+std::unique_ptr<JsonDoc> Operation::createReq() {
     MO_DBG_ERR("Unsupported operation: createReq() is not implemented");
     return createEmptyDocument();
 }
@@ -30,13 +30,13 @@ void Operation::processReq(JsonObject payload) {
     MO_DBG_ERR("Unsupported operation: processReq() is not implemented");
 }
 
-std::unique_ptr<DynamicJsonDocument> Operation::createConf() {
+std::unique_ptr<JsonDoc> Operation::createConf() {
     MO_DBG_ERR("Unsupported operation: createConf() is not implemented");
     return createEmptyDocument();
 }
 
-std::unique_ptr<DynamicJsonDocument> MicroOcpp::createEmptyDocument() {
-    auto emptyDoc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(0));
+std::unique_ptr<JsonDoc> MicroOcpp::createEmptyDocument() {
+    auto emptyDoc = makeJsonDoc("EmptyJsonDoc", 0);
     emptyDoc->to<JsonObject>();
     return emptyDoc;
 }
diff --git a/src/MicroOcpp/Core/Operation.h b/src/MicroOcpp/Core/Operation.h
index 5da9aa56..9c1756a1 100644
--- a/src/MicroOcpp/Core/Operation.h
+++ b/src/MicroOcpp/Core/Operation.h
@@ -20,10 +20,11 @@
 
 #include <memory>
 #include <ArduinoJson.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
-std::unique_ptr<DynamicJsonDocument> createEmptyDocument();
+std::unique_ptr<JsonDoc> createEmptyDocument();
 
 class Operation {
 public:
@@ -41,7 +42,7 @@ class Operation {
      * This function is usually called multiple times by the Arduino loop(). On first call, the request is initially sent. In the
      * succeeding calls, the implementers decide to either recreate the request, or do nothing as the operation is still pending.
      */
-    virtual std::unique_ptr<DynamicJsonDocument> createReq();
+    virtual std::unique_ptr<JsonDoc> createReq();
 
 
     virtual void processConf(JsonObject payload);
@@ -60,11 +61,11 @@ class Operation {
      * After successfully processing a request sent by the communication counterpart, this function creates the payload for a confirmation
      * message.
      */
-    virtual std::unique_ptr<DynamicJsonDocument> createConf();
+    virtual std::unique_ptr<JsonDoc> createConf();
 
     virtual const char *getErrorCode() {return nullptr;} //nullptr means no error
     virtual const char *getErrorDescription() {return "";}
-    virtual std::unique_ptr<DynamicJsonDocument> getErrorDetails() {return createEmptyDocument();}
+    virtual std::unique_ptr<JsonDoc> getErrorDetails() {return createEmptyDocument();}
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/OperationRegistry.cpp b/src/MicroOcpp/Core/OperationRegistry.cpp
index 38d9e459..0bd17d45 100644
--- a/src/MicroOcpp/Core/OperationRegistry.cpp
+++ b/src/MicroOcpp/Core/OperationRegistry.cpp
@@ -11,7 +11,7 @@
 
 using namespace MicroOcpp;
 
-OperationRegistry::OperationRegistry() {
+OperationRegistry::OperationRegistry() : registry(makeVector<OperationCreator>("OperationRegistry")) {
 
 }
 
diff --git a/src/MicroOcpp/Core/OperationRegistry.h b/src/MicroOcpp/Core/OperationRegistry.h
index 959111eb..0d0d44b5 100644
--- a/src/MicroOcpp/Core/OperationRegistry.h
+++ b/src/MicroOcpp/Core/OperationRegistry.h
@@ -6,9 +6,8 @@
 #define MO_OPERATIONREGISTRY_H
 
 #include <functional>
-#include <vector>
 #include <memory>
-#include <ArduinoJson.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Core/RequestCallbacks.h>
 
 namespace MicroOcpp {
@@ -25,7 +24,7 @@ struct OperationCreator {
 
 class OperationRegistry {
 private:
-    std::vector<OperationCreator> registry;
+    Vector<OperationCreator> registry;
     OperationCreator *findCreator(const char *operationType);
 
 public:
diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index a9d63677..56477fa8 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -29,7 +29,7 @@ namespace MicroOcpp {
 
 using namespace MicroOcpp;
 
-Request::Request(std::unique_ptr<Operation> msg) : operation(std::move(msg)) {
+Request::Request(std::unique_ptr<Operation> msg, const char *memory_tag) : MemoryManaged(memory_tag), messageID(makeString(getMemoryTag())), operation(std::move(msg)) {
     timeout_start = mocpp_tick_ms();
     debugRequest_start = mocpp_tick_ms();
 }
@@ -65,7 +65,7 @@ void Request::setMessageID(const char *id){
     messageID = id;
 }
 
-Request::CreateRequestResult Request::createRequest(DynamicJsonDocument& requestJson) {
+Request::CreateRequestResult Request::createRequest(JsonDoc& requestJson) {
 
     if (messageID.empty()) {
         unsigned char random [18];
@@ -92,7 +92,7 @@ Request::CreateRequestResult Request::createRequest(DynamicJsonDocument& request
      * Create OCPP-J Remote Procedure Call header
      */
     size_t json_buffsize = JSON_ARRAY_SIZE(4) + (messageID.length() + 1) + requestPayload->capacity();
-    requestJson = DynamicJsonDocument(json_buffsize);
+    requestJson = initJsonDoc(getMemoryTag(), json_buffsize);
 
     requestJson.add(MESSAGE_TYPE_CALL);                    //MessageType
     requestJson.add(messageID);                      //Unique message ID
@@ -124,7 +124,7 @@ bool Request::receiveResponse(JsonArray response){
     /*
      * check if messageIDs match. If yes, continue with this function. If not, return false for message not consumed
      */
-    if (messageID != response[1].as<std::string>()){
+    if (messageID.compare(response[1].as<const char*>())){
         return false;
     }
 
@@ -193,13 +193,13 @@ bool Request::receiveRequest(JsonArray request) {
     return true; //success
 }
 
-Request::CreateResponseResult Request::createResponse(DynamicJsonDocument& response) {
+Request::CreateResponseResult Request::createResponse(JsonDoc& response) {
 
     bool operationFailure = operation->getErrorCode() != nullptr;
 
     if (!operationFailure) {
 
-        std::unique_ptr<DynamicJsonDocument> payload = operation->createConf();
+        std::unique_ptr<JsonDoc> payload = operation->createConf();
 
         if (!payload) {
             return CreateResponseResult::Pending; //confirmation message still pending
@@ -209,7 +209,7 @@ Request::CreateResponseResult Request::createResponse(DynamicJsonDocument& respo
          * Create OCPP-J Remote Procedure Call header
          */
         size_t json_buffsize = JSON_ARRAY_SIZE(3) + payload->capacity();
-        response = DynamicJsonDocument(json_buffsize);
+        response = initJsonDoc(getMemoryTag(), json_buffsize);
 
         response.add(MESSAGE_TYPE_CALLRESULT);   //MessageType
         response.add(messageID.c_str());            //Unique message ID
@@ -223,14 +223,14 @@ Request::CreateResponseResult Request::createResponse(DynamicJsonDocument& respo
 
         const char *errorCode = operation->getErrorCode();
         const char *errorDescription = operation->getErrorDescription();
-        std::unique_ptr<DynamicJsonDocument> errorDetails = operation->getErrorDetails();
+        std::unique_ptr<JsonDoc> errorDetails = operation->getErrorDetails();
 
         /*
          * Create OCPP-J Remote Procedure Call header
          */
         size_t json_buffsize = JSON_ARRAY_SIZE(5)
                     + errorDetails->capacity();
-        response = DynamicJsonDocument(json_buffsize);
+        response = initJsonDoc(getMemoryTag(), json_buffsize);
 
         response.add(MESSAGE_TYPE_CALLERROR);   //MessageType
         response.add(messageID.c_str());            //Unique message ID
@@ -289,15 +289,19 @@ bool Request::isRequestSent() {
 
 namespace MicroOcpp {
 
-std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> operation){
+std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> operation, const char *memoryTag){
     if (operation == nullptr) {
         return nullptr;
     }
-    return std::unique_ptr<Request>(new Request(std::move(operation)));
+    return std::unique_ptr<Request>(new Request(std::move(operation), memoryTag));
 }
 
 std::unique_ptr<Request> makeRequest(Operation *operation) {
     return makeRequest(std::unique_ptr<Operation>(operation));
 }
 
+std::unique_ptr<Request> makeRequest(const char *memoryTag, Operation *operation) {
+    return makeRequest(std::unique_ptr<Operation>(operation), memoryTag);
+}
+
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
index fde0eb91..4b608217 100644
--- a/src/MicroOcpp/Core/Request.h
+++ b/src/MicroOcpp/Core/Request.h
@@ -13,14 +13,16 @@
 
 #include <MicroOcpp/Core/RequestCallbacks.h>
 
+#include <MicroOcpp/Core/Memory.h>
+
 namespace MicroOcpp {
 
 class Operation;
 class Model;
 
-class Request {
+class Request : public MemoryManaged {
 private:
-    std::string messageID {};
+    String messageID;
     std::unique_ptr<Operation> operation;
     void setMessageID(const char *id);
     OnReceiveConfListener onReceiveConfListener = [] (JsonObject payload) {};
@@ -39,7 +41,7 @@ class Request {
     bool requestSent = false;
 public:
 
-    Request(std::unique_ptr<Operation> msg);
+    Request(std::unique_ptr<Operation> msg, const char *memory_tag = "Request");
 
     ~Request();
 
@@ -62,7 +64,7 @@ class Request {
         Success,
         Failure
     };
-    CreateRequestResult createRequest(DynamicJsonDocument& out);
+    CreateRequestResult createRequest(JsonDoc& out);
 
    /**
     * Decides if message belongs to this operation instance and if yes, proccesses it. Receives both Confirmations and Errors
@@ -89,7 +91,7 @@ class Request {
         Failure
     };
 
-    CreateResponseResult createResponse(DynamicJsonDocument& out);
+    CreateResponseResult createResponse(JsonDoc& out);
 
     void setOnReceiveConfListener(OnReceiveConfListener onReceiveConf); //listener executed when we received the .conf() to a .req() we sent
     void setOnReceiveReqListener(OnReceiveReqListener onReceiveReq); //listener executed when we receive a .req()
@@ -119,8 +121,9 @@ class Request {
 /*
  * Simple factory functions
  */
-std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> op);
+std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> op, const char *memoryTag = "Request");
 std::unique_ptr<Request> makeRequest(Operation *op); //takes ownership of op
+std::unique_ptr<Request> makeRequest(const char *memoryTag, Operation *op); //takes ownership of op
 
 } //end namespace MicroOcpp
 
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index 5f9722c2..551175a7 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -17,7 +17,7 @@ size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_siz
 
 using namespace MicroOcpp;
 
-VolatileRequestQueue::VolatileRequestQueue(unsigned int priority) : priority{priority} {
+VolatileRequestQueue::VolatileRequestQueue(unsigned int priority) : MemoryManaged("VolatileRequestQueue"), priority{priority} {
 
 }
 
@@ -118,7 +118,7 @@ bool VolatileRequestQueue::pushRequestBack(std::unique_ptr<Request> request) {
 }
 
 RequestQueue::RequestQueue(Connection& connection, OperationRegistry& operationRegistry)
-            : connection(connection), operationRegistry(operationRegistry) {
+            : MemoryManaged("RequestQueue"), connection(connection), operationRegistry(operationRegistry) {
 
     ReceiveTXTcallback callback = [this] (const char *payload, size_t length) {
         return this->receiveMessage(payload, length);
@@ -167,11 +167,11 @@ void RequestQueue::loop() {
 
     if (recvReqFront) {
 
-        DynamicJsonDocument response {0};
+        auto response = initJsonDoc(getMemoryTag());
         auto ret = recvReqFront->createResponse(response);
 
         if (ret == Request::CreateResponseResult::Success) {
-            std::string out;
+            auto out = makeString(getMemoryTag());
             serializeJson(response, out);
     
             bool success = connection.sendTXT(out.c_str(), out.length());
@@ -208,13 +208,13 @@ void RequestQueue::loop() {
 
     if (sendReqFront && !sendReqFront->isRequestSent()) {
 
-        DynamicJsonDocument request {0};
+        auto request = initJsonDoc(getMemoryTag());
         auto ret = sendReqFront->createRequest(request);
 
         if (ret == Request::CreateRequestResult::Success) {
 
             //send request
-            std::string out;
+            auto out = makeString(getMemoryTag());
             serializeJson(request, out);
 
             bool success = connection.sendTXT(out.c_str(), out.length());
@@ -267,12 +267,12 @@ bool RequestQueue::receiveMessage(const char* payload, size_t length) {
         capacity = MO_MAX_JSON_CAPACITY;
     }
     
-    DynamicJsonDocument doc {0};
+    auto doc = initJsonDoc(getMemoryTag());
     DeserializationError err = DeserializationError::NoMemory;
 
     while (err == DeserializationError::NoMemory && capacity <= MO_MAX_JSON_CAPACITY) {
 
-        doc = DynamicJsonDocument(capacity);
+        doc = initJsonDoc(getMemoryTag(), capacity);
         err = deserializeJson(doc, payload, length);
 
         capacity *= 2;
@@ -308,7 +308,7 @@ bool RequestQueue::receiveMessage(const char* payload, size_t length) {
                 * If the input type is MESSAGE_TYPE_CALLRESULT, then abort the operation to avoid getting stalled.
                 */
 
-            doc = DynamicJsonDocument(200);
+            doc = initJsonDoc(getMemoryTag(), 200);
             char onlyRpcHeader[200];
             size_t onlyRpcHeader_len = removePayload(payload, length, onlyRpcHeader, sizeof(onlyRpcHeader));
             DeserializationError err2 = deserializeJson(doc, onlyRpcHeader, onlyRpcHeader_len);
diff --git a/src/MicroOcpp/Core/RequestQueue.h b/src/MicroOcpp/Core/RequestQueue.h
index 7eba5355..5213272e 100644
--- a/src/MicroOcpp/Core/RequestQueue.h
+++ b/src/MicroOcpp/Core/RequestQueue.h
@@ -8,6 +8,7 @@
 #include <limits>
 
 #include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Memory.h>
 
 #include <memory>
 #include <ArduinoJson.h>
@@ -34,7 +35,7 @@ class RequestEmitter {
     virtual std::unique_ptr<Request> fetchFrontRequest() = 0;
 };
 
-class VolatileRequestQueue : public RequestEmitter {
+class VolatileRequestQueue : public RequestEmitter, public MemoryManaged {
 private:
     std::unique_ptr<Request> requests [MO_REQUEST_CACHE_MAXSIZE];
     size_t front = 0, len = 0;
@@ -50,7 +51,7 @@ class VolatileRequestQueue : public RequestEmitter {
     bool pushRequestBack(std::unique_ptr<Request> request);
 };
 
-class RequestQueue {
+class RequestQueue : public MemoryManaged {
 private:
     Connection& connection;
     OperationRegistry& operationRegistry;
diff --git a/src/MicroOcpp/Core/Time.cpp b/src/MicroOcpp/Core/Time.cpp
index 6db1f852..ae25bf5e 100644
--- a/src/MicroOcpp/Core/Time.cpp
+++ b/src/MicroOcpp/Core/Time.cpp
@@ -11,20 +11,20 @@ namespace MicroOcpp {
 const Timestamp MIN_TIME = Timestamp(2010, 0, 0, 0, 0, 0);
 const Timestamp MAX_TIME = Timestamp(2037, 0, 0, 0, 0, 0);
 
-Timestamp::Timestamp() {
+Timestamp::Timestamp() : MemoryManaged("Timestamp") {
     
 }
 
-Timestamp::Timestamp(const Timestamp& other) {
+Timestamp::Timestamp(const Timestamp& other) : MemoryManaged("Timestamp") {
     *this = other;
 }
 
 #if MO_ENABLE_TIMESTAMP_MILLISECONDS
     Timestamp::Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second, int32_t ms) :
-                year(year), month(month), day(day), hour(hour), minute(minute), second(second), ms(ms) { };
+                MemoryManaged("Timestamp"), year(year), month(month), day(day), hour(hour), minute(minute), second(second), ms(ms) { }
 #else 
     Timestamp::Timestamp(int16_t year, int16_t month, int16_t day, int32_t hour, int32_t minute, int32_t second) :
-                year(year), month(month), day(day), hour(hour), minute(minute), second(second) { };
+                MemoryManaged("Timestamp"), year(year), month(month), day(day), hour(hour), minute(minute), second(second) { }
 #endif //MO_ENABLE_TIMESTAMP_MILLISECONDS
 
 int noDays(int month, int year) {
diff --git a/src/MicroOcpp/Core/Time.h b/src/MicroOcpp/Core/Time.h
index 349fb01b..9a82753b 100644
--- a/src/MicroOcpp/Core/Time.h
+++ b/src/MicroOcpp/Core/Time.h
@@ -9,6 +9,7 @@
 #include <stdint.h>
 #include <stddef.h>
 
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Platform.h>
 
 #ifndef MO_ENABLE_TIMESTAMP_MILLISECONDS
@@ -23,7 +24,7 @@
 
 namespace MicroOcpp {
 
-class Timestamp {
+class Timestamp : public MemoryManaged {
 private:
     /*
      * Internal representation of the current time. The initial values correspond to UNIX-time 0. January
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
index ac95e70d..08cbfbca 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
@@ -7,23 +7,26 @@
 #if MO_ENABLE_LOCAL_AUTH
 
 #include <MicroOcpp/Model/Authorization/AuthorizationData.h>
+#include <MicroOcpp/Debug.h>
 
 using namespace MicroOcpp;
 
-AuthorizationData::AuthorizationData() {
+AuthorizationData::AuthorizationData() : MemoryManaged("v16.Authorization.AuthorizationData") {
 
 }
 
-AuthorizationData::AuthorizationData(AuthorizationData&& other) {
+AuthorizationData::AuthorizationData(AuthorizationData&& other) : MemoryManaged("v16.Authorization.AuthorizationData") {
     operator=(std::move(other));
 }
 
 AuthorizationData::~AuthorizationData() {
-
+    MO_FREE(parentIdTag);
+    parentIdTag = nullptr;
 }
 
 AuthorizationData& AuthorizationData::operator=(AuthorizationData&& other) {
-    parentIdTag = std::move(other.parentIdTag);
+    parentIdTag = other.parentIdTag;
+    other.parentIdTag = nullptr;
     expiryDate = std::move(other.expiryDate);
     strncpy(idTag, other.idTag, IDTAG_LEN_MAX + 1);
     idTag[IDTAG_LEN_MAX] = '\0';
@@ -56,11 +59,18 @@ void AuthorizationData::readJson(JsonObject entry, bool compact) {
     }
 
     if (idTagInfo.containsKey(AUTHDATA_KEY_PARENTIDTAG(compact))) {
-        parentIdTag = std::unique_ptr<char[]>(new char[IDTAG_LEN_MAX + 1]);
-        strncpy(parentIdTag.get(), idTagInfo[AUTHDATA_KEY_PARENTIDTAG(compact)], IDTAG_LEN_MAX + 1);
-        parentIdTag.get()[IDTAG_LEN_MAX] = '\0';
+        MO_FREE(parentIdTag);
+        parentIdTag = nullptr;
+        parentIdTag = static_cast<char*>(MO_MALLOC(getMemoryTag(), IDTAG_LEN_MAX + 1));
+        if (parentIdTag) {
+            strncpy(parentIdTag, idTagInfo[AUTHDATA_KEY_PARENTIDTAG(compact)], IDTAG_LEN_MAX + 1);
+            parentIdTag[IDTAG_LEN_MAX] = '\0';
+        } else {
+            MO_DBG_ERR("OOM");
+        }
     } else {
-        parentIdTag.reset();
+        MO_FREE(parentIdTag);
+        parentIdTag = nullptr;
     }
 
     if (idTagInfo.containsKey(AUTHDATA_KEY_STATUS(compact))) {
@@ -106,7 +116,7 @@ void AuthorizationData::writeJson(JsonObject& entry, bool compact) {
     }
 
     if (parentIdTag) {
-        idTagInfo[AUTHDATA_KEY_PARENTIDTAG(compact)] = (const char *) parentIdTag.get();
+        idTagInfo[AUTHDATA_KEY_PARENTIDTAG(compact)] = (const char *) parentIdTag;
     }
 
     if (status != AuthorizationStatus::Accepted) {
@@ -116,6 +126,19 @@ void AuthorizationData::writeJson(JsonObject& entry, bool compact) {
     }
 }
 
+const char *AuthorizationData::getIdTag() const {
+    return idTag;
+}
+Timestamp *AuthorizationData::getExpiryDate() const {
+    return expiryDate.get();
+}
+const char *AuthorizationData::getParentIdTag() const {
+    return parentIdTag;
+}
+AuthorizationStatus AuthorizationData::getAuthorizationStatus() const {
+    return status;
+}
+
 void AuthorizationData::reset() {
     idTag[0] = '\0';
 }
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationData.h b/src/MicroOcpp/Model/Authorization/AuthorizationData.h
index 074e24a8..7bcdccd7 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationData.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationData.h
@@ -11,6 +11,7 @@
 
 #include <MicroOcpp/Operations/CiStrings.h>
 #include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <ArduinoJson.h>
 #include <memory>
 
@@ -36,11 +37,11 @@ enum class AuthorizationStatus : uint8_t {
 const char *serializeAuthorizationStatus(AuthorizationStatus status);
 AuthorizationStatus deserializeAuthorizationStatus(const char *cstr);
 
-class AuthorizationData {
+class AuthorizationData : public MemoryManaged {
 private:
     //data structure optimized for memory consumption
 
-    std::unique_ptr<char[]> parentIdTag;
+    char *parentIdTag = nullptr;
     std::unique_ptr<Timestamp> expiryDate;
 
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
@@ -58,10 +59,10 @@ class AuthorizationData {
     size_t getJsonCapacity() const;
     void writeJson(JsonObject& entry, bool compact = false); //compact: compressed representation for flash storage
 
-    const char *getIdTag() const {return idTag;}
-    Timestamp *getExpiryDate() const {return expiryDate.get();}
-    const char *getParentIdTag() const {return parentIdTag.get();}
-    AuthorizationStatus getAuthorizationStatus() const {return status;}
+    const char *getIdTag() const;
+    Timestamp *getExpiryDate() const;
+    const char *getParentIdTag() const;
+    AuthorizationStatus getAuthorizationStatus() const;
 
     void reset();
 };
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
index bcbc8678..dd438ff8 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
@@ -14,7 +14,7 @@
 
 using namespace MicroOcpp;
 
-AuthorizationList::AuthorizationList() {
+AuthorizationList::AuthorizationList() : MemoryManaged("v16.Authorization.AuthorizationList"), localAuthorizationList(makeVector<AuthorizationData>(getMemoryTag())) {
 
 }
 
@@ -60,8 +60,8 @@ bool AuthorizationList::readJson(JsonArray authlistJson, int listVersion, bool d
         }
     }
 
-    std::vector<int> authlist_index;
-    std::vector<int> remove_list;
+    auto authlist_index = makeVector<int>(getMemoryTag());
+    auto remove_list = makeVector<int>(getMemoryTag());
 
     unsigned int resultingListLength = 0;
 
@@ -74,7 +74,7 @@ bool AuthorizationList::readJson(JsonArray authlistJson, int listVersion, bool d
         resultingListLength = localAuthorizationList.size();
 
         //also, build index here
-        authlist_index = std::vector<int>(authlistJson.size(), -1);
+        authlist_index.resize(authlistJson.size(), -1);
 
         for (size_t i = 0; i < authlistJson.size(); i++) {
 
@@ -113,7 +113,7 @@ bool AuthorizationList::readJson(JsonArray authlistJson, int listVersion, bool d
         localAuthorizationList.clear();
 
         for (size_t i = 0; i < authlistJson.size(); i++) {
-            localAuthorizationList.push_back(AuthorizationData());
+            localAuthorizationList.emplace_back();
             localAuthorizationList.back().readJson(authlistJson[i], compact);
         }
     } else if (differential) {
@@ -138,7 +138,7 @@ bool AuthorizationList::readJson(JsonArray authlistJson, int listVersion, bool d
                 } else {
                     //no, create new
                     authlist_index[i] = localAuthorizationList.size();
-                    localAuthorizationList.push_back(AuthorizationData());
+                    localAuthorizationList.emplace_back();
                 }
             }
 
@@ -150,7 +150,7 @@ bool AuthorizationList::readJson(JsonArray authlistJson, int listVersion, bool d
 
         for (size_t i = 0; i < authlistJson.size(); i++) {
             if (authlistJson[i].as<JsonObject>().containsKey(AUTHDATA_KEY_IDTAGINFO)) {
-                localAuthorizationList.push_back(AuthorizationData());
+                localAuthorizationList.emplace_back();
                 localAuthorizationList.back().readJson(authlistJson[i], compact);
             }
         }
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationList.h b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
index 7b0d33c5..0a083777 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationList.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationList.h
@@ -10,7 +10,7 @@
 #if MO_ENABLE_LOCAL_AUTH
 
 #include <MicroOcpp/Model/Authorization/AuthorizationData.h>
-#include <vector>
+#include <MicroOcpp/Core/Memory.h>
 
 #ifndef MO_LocalAuthListMaxLength
 #define MO_LocalAuthListMaxLength 48
@@ -22,10 +22,10 @@
 
 namespace MicroOcpp {
 
-class AuthorizationList {
+class AuthorizationList : public MemoryManaged {
 private:
     int listVersion = 0;
-    std::vector<AuthorizationData> localAuthorizationList; //sorted list
+    Vector<AuthorizationData> localAuthorizationList; //sorted list
 public:
     AuthorizationList();
     ~AuthorizationList();
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index fd15c0b9..e9dc39d2 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -22,8 +22,8 @@
 
 using namespace MicroOcpp;
 
-AuthorizationService::AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
-    
+AuthorizationService::AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : MemoryManaged("v16.Authorization.AuthorizationService"), context(context), filesystem(filesystem) {
+
     localAuthListEnabledBool = declareConfiguration<bool>("LocalAuthListEnabled", true);
     declareConfiguration<int>("LocalAuthListMaxLength", MO_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, true);
     declareConfiguration<int>("SendLocalListMaxLength", MO_SendLocalListMaxLength, CONFIGURATION_VOLATILE, true);
@@ -56,7 +56,7 @@ bool AuthorizationService::loadLists() {
         return true;
     }
     
-    auto doc = FilesystemUtils::loadJson(filesystem, MO_LOCALAUTHORIZATIONLIST_FN);
+    auto doc = FilesystemUtils::loadJson(filesystem, MO_LOCALAUTHORIZATIONLIST_FN, getMemoryTag());
     if (!doc) {
         MO_DBG_ERR("failed to load %s", MO_LOCALAUTHORIZATIONLIST_FN);
         return false;
@@ -106,7 +106,7 @@ bool AuthorizationService::updateLocalList(JsonArray localAuthorizationListJson,
 
     if (success) {
         
-        DynamicJsonDocument doc (
+        auto doc = initJsonDoc(getMemoryTag(),
                 JSON_OBJECT_SIZE(3) +
                 localAuthorizationList.getJsonCapacity());
 
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.h b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
index 85972c50..88ba7936 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
@@ -12,12 +12,13 @@
 #include <MicroOcpp/Model/Authorization/AuthorizationList.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
 class Context;
 
-class AuthorizationService {
+class AuthorizationService : public MemoryManaged {
 private:
     Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
diff --git a/src/MicroOcpp/Model/Authorization/IdToken.cpp b/src/MicroOcpp/Model/Authorization/IdToken.cpp
index 8983c5cd..f6ceec10 100644
--- a/src/MicroOcpp/Model/Authorization/IdToken.cpp
+++ b/src/MicroOcpp/Model/Authorization/IdToken.cpp
@@ -15,21 +15,22 @@
 
 using namespace MicroOcpp;
 
-IdToken::IdToken() {
-    idToken[0] = '\0';
+IdToken::IdToken(const char *token, Type type, const char *memoryTag) : MemoryManaged(memoryTag ? memoryTag : "v201.Authorization.IdToken"), type(type) {
+    if (token) {
+        auto ret = snprintf(idToken, MO_IDTOKEN_LEN_MAX + 1, "%s", token);
+        if (ret < 0 || ret >= MO_IDTOKEN_LEN_MAX + 1) {
+            MO_DBG_ERR("invalid token");
+            *idToken = '\0';
+        }
+    }
 }
 
-IdToken::IdToken(const char *token, Type type) : type(type) {
-    auto ret = snprintf(idToken, MO_IDTOKEN_LEN_MAX + 1, "%s", token);
-    if (ret < 0 || ret >= MO_IDTOKEN_LEN_MAX + 1) {
-        MO_DBG_ERR("invalid token");
-        *idToken = '\0';
-    }
+IdToken::IdToken(const IdToken& other, const char *memoryTag) : IdToken(other.idToken, other.type, memoryTag ? memoryTag : other.getMemoryTag()) { 
+
 }
 
 bool IdToken::parseCstr(const char *token, const char *typeCstr) {
     if (!token || !typeCstr) {
-        MO_DBG_DEBUG("TRACE");
         return false;
     }
 
@@ -42,7 +43,6 @@ bool IdToken::parseCstr(const char *token, const char *typeCstr) {
     } else if (!strcmp(typeCstr, "ISO15693")) {
         type = Type::ISO15693;
     } else if (!strcmp(typeCstr, "KeyCode")) {
-        MO_DBG_DEBUG("TRACE");
         type = Type::KeyCode;
     } else if (!strcmp(typeCstr, "Local")) {
         type = Type::Local;
@@ -51,7 +51,6 @@ bool IdToken::parseCstr(const char *token, const char *typeCstr) {
     } else if (!strcmp(typeCstr, "NoAuthorization")) {
         type = Type::NoAuthorization;
     } else {
-        MO_DBG_DEBUG("TRACE");
         return false;
     }
 
diff --git a/src/MicroOcpp/Model/Authorization/IdToken.h b/src/MicroOcpp/Model/Authorization/IdToken.h
index 8f4ba190..cb209872 100644
--- a/src/MicroOcpp/Model/Authorization/IdToken.h
+++ b/src/MicroOcpp/Model/Authorization/IdToken.h
@@ -11,12 +11,14 @@
 
 #include <stdint.h>
 
+#include <MicroOcpp/Core/Memory.h>
+
 #define MO_IDTOKEN_LEN_MAX 36
 
 namespace MicroOcpp {
 
 // IdTokenType (2.28)
-class IdToken {
+class IdToken : public MemoryManaged {
 public:
 
     // IdTokenEnumType (3.43)
@@ -36,8 +38,9 @@ class IdToken {
     char idToken [MO_IDTOKEN_LEN_MAX + 1];
     Type type = Type::UNDEFINED;
 public:
-    IdToken();
-    IdToken(const char *token, Type type = Type::ISO14443);
+    IdToken(const char *token = nullptr, Type type = Type::ISO14443, const char *memoryTag = nullptr);
+
+    IdToken(const IdToken& other, const char *memoryTag = nullptr);
 
     bool parseCstr(const char *token, const char *typeCstr);
 
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index d44a4b71..3d027f03 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -33,7 +33,7 @@ RegistrationStatus MicroOcpp::deserializeRegistrationStatus(const char *serializ
     }
 }
 
-BootService::BootService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
+BootService::BootService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : MemoryManaged("v16.Boot.BootService"), context(context), filesystem(filesystem), cpCredentials{makeString(getMemoryTag())} {
     
     //if transactions can start before the BootNotification succeeds
     preBootTransactionsBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", false);
@@ -102,16 +102,16 @@ void BootService::setChargePointCredentials(const char *credentials) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> BootService::getChargePointCredentials() {
+std::unique_ptr<JsonDoc> BootService::getChargePointCredentials() {
     if (cpCredentials.size() <= 2) {
         return createEmptyDocument();
     }
 
-    std::unique_ptr<DynamicJsonDocument> doc;
+    std::unique_ptr<JsonDoc> doc;
     size_t capacity = JSON_OBJECT_SIZE(9) + cpCredentials.size();
     DeserializationError err = DeserializationError::NoMemory;
     while (err == DeserializationError::NoMemory && capacity <= MO_MAX_JSON_CAPACITY) {
-        doc.reset(new DynamicJsonDocument(capacity));
+        doc = makeJsonDoc(getMemoryTag(), capacity);
         err = deserializeJson(*doc, cpCredentials);
 
         capacity *= 2;
@@ -149,7 +149,7 @@ bool BootService::loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, B
         
         bool success = true;
 
-        auto json = FilesystemUtils::loadJson(filesystem, MO_FILENAME_PREFIX "bootstats.jsn");
+        auto json = FilesystemUtils::loadJson(filesystem, MO_FILENAME_PREFIX "bootstats.jsn", "v16.Boot.BootService");
         if (json) {
             int bootNrIn = (*json)["bootNr"] | -1;
             if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
@@ -185,7 +185,7 @@ bool BootService::storeBootStats(std::shared_ptr<FilesystemAdapter> filesystem,
         return false;
     }
 
-    DynamicJsonDocument json {JSON_OBJECT_SIZE(2)};
+    auto json = initJsonDoc("v16.Boot.BootService", JSON_OBJECT_SIZE(2));
 
     json["bootNr"] = bstats.bootNr;
     json["lastSuccess"] = bstats.lastBootSuccess;
diff --git a/src/MicroOcpp/Model/Boot/BootService.h b/src/MicroOcpp/Model/Boot/BootService.h
index e00559bd..e5144be1 100644
--- a/src/MicroOcpp/Model/Boot/BootService.h
+++ b/src/MicroOcpp/Model/Boot/BootService.h
@@ -7,6 +7,7 @@
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <memory>
 
 #define MO_BOOT_INTERVAL_DEFAULT 60
@@ -33,7 +34,7 @@ RegistrationStatus deserializeRegistrationStatus(const char *serialized);
 
 class Context;
 
-class BootService {
+class BootService : public MemoryManaged {
 private:
     Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
@@ -43,7 +44,7 @@ class BootService {
 
     RegistrationStatus status = RegistrationStatus::Pending;
     
-    std::string cpCredentials;
+    String cpCredentials;
 
     std::shared_ptr<Configuration> preBootTransactionsBool;
 
@@ -60,7 +61,7 @@ class BootService {
 
     void setChargePointCredentials(JsonObject credentials);
     void setChargePointCredentials(const char *credentials); //credentials: serialized BootNotification payload
-    std::unique_ptr<DynamicJsonDocument> getChargePointCredentials();
+    std::unique_ptr<JsonDoc> getChargePointCredentials();
 
     void notifyRegistrationStatus(RegistrationStatus status);
     void setRetryInterval(unsigned long interval);
diff --git a/src/MicroOcpp/Model/Certificates/Certificate.h b/src/MicroOcpp/Model/Certificates/Certificate.h
index d9975bf7..33574351 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate.h
+++ b/src/MicroOcpp/Model/Certificates/Certificate.h
@@ -128,7 +128,7 @@ int ocpp_cert_set_serialNumber(ocpp_cert_hash *dst, const char *hex_src);
 #ifdef __cplusplus
 } //extern "C"
 
-#include <vector>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
@@ -137,10 +137,12 @@ using CertificateHash = ocpp_cert_hash;
 /*
  * See OCPP 2.0.1 part 2 Data Type 2.5
  */
-struct CertificateChainHash {
+struct CertificateChainHash : public MemoryManaged {
     GetCertificateIdType certificateType;
     CertificateHash certificateHashData;
-    std::vector<CertificateHash> childCertificateHashData;
+    Vector<CertificateHash> childCertificateHashData;
+
+    CertificateChainHash() : MemoryManaged("v2.0.1.Certificates.CertificateChainHash"), childCertificateHashData(makeVector<CertificateHash>(getMemoryTag())) { }
 };
 
 /*
@@ -150,7 +152,7 @@ class CertificateStore {
 public:
     virtual ~CertificateStore() = default;
 
-    virtual GetInstalledCertificateStatus getCertificateIds(const std::vector<GetCertificateIdType>& certificateType, std::vector<CertificateChainHash>& out) = 0;
+    virtual GetInstalledCertificateStatus getCertificateIds(const Vector<GetCertificateIdType>& certificateType, Vector<CertificateChainHash>& out) = 0;
     virtual DeleteCertificateStatus deleteCertificate(const CertificateHash& hash) = 0;
     virtual InstallCertificateStatus installCertificate(InstallCertificateType certificateType, const char *certificate) = 0;
 };
diff --git a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
index 05609f80..73314158 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
+++ b/src/MicroOcpp/Model/Certificates/CertificateMbedTLS.cpp
@@ -69,7 +69,7 @@ bool ocpp_get_cert_hash(mbedtls_x509_crt& cacert, HashAlgorithmType hashAlg, ocp
 
     // copy public key into pk_buf to create issuerKeyHash
     size_t pk_size = cacert.pk_raw.len;
-    unsigned char *pk_buf = new unsigned char[pk_size];
+    unsigned char *pk_buf = static_cast<unsigned char*>(MO_MALLOC("v201.Certificates.CertificateStoreMbedTLS", pk_size));
     if (!pk_buf) {
         MO_DBG_ERR("OOM (alloc size %zu)", pk_size);
         return false;
@@ -94,7 +94,7 @@ bool ocpp_get_cert_hash(mbedtls_x509_crt& cacert, HashAlgorithmType hashAlg, ocp
         }
     }
 
-    delete[] pk_buf;
+    MO_FREE(pk_buf);
     if (pk_err) {
         return false;
     }
@@ -134,7 +134,7 @@ bool ocpp_get_cert_hash(const unsigned char *buf, size_t len, HashAlgorithmType
 
 namespace MicroOcpp {
 
-class CertificateStoreMbedTLS : public CertificateStore {
+class CertificateStoreMbedTLS : public CertificateStore, public MemoryManaged {
 private:
     std::shared_ptr<FilesystemAdapter> filesystem;
 
@@ -156,7 +156,7 @@ class CertificateStoreMbedTLS : public CertificateStore {
             return false;
         }
 
-        unsigned char *buf = new unsigned char[fsize + 1];
+        unsigned char *buf = static_cast<unsigned char*>(MO_MALLOC(getMemoryTag(), fsize + 1));
         if (!buf) {
             MO_DBG_ERR("OOM");
             return false;
@@ -180,16 +180,16 @@ class CertificateStoreMbedTLS : public CertificateStore {
             MO_DBG_ERR("could not read cert: %s", fn);
         }
 
-        delete[] buf;
+        MO_FREE(buf);
         return success;
     }
 public:
     CertificateStoreMbedTLS(std::shared_ptr<FilesystemAdapter> filesystem)
-            : filesystem(filesystem) {
+            : MemoryManaged("v201.Certificates.CertificateStoreMbedTLS"), filesystem(filesystem) {
 
     }
 
-    GetInstalledCertificateStatus getCertificateIds(const std::vector<GetCertificateIdType>& certificateType, std::vector<CertificateChainHash>& out) override {
+    GetInstalledCertificateStatus getCertificateIds(const Vector<GetCertificateIdType>& certificateType, Vector<CertificateChainHash>& out) override {
         out.clear();
 
         for (auto certType : certificateType) {
@@ -325,7 +325,7 @@ class CertificateStoreMbedTLS : public CertificateStore {
 #endif // MO_DBG_LEVEL >= MO_DL_DEBUG
 
         //check if cert is already stored on flash
-        std::vector<CertificateChainHash> installedCerts;
+        auto installedCerts = makeVector<CertificateChainHash>(getMemoryTag());
         auto ret = getCertificateIds({certTypeGetType}, installedCerts);
         if (ret == GetInstalledCertificateStatus_Accepted) {
             for (auto &installedCert : installedCerts) {
diff --git a/src/MicroOcpp/Model/Certificates/CertificateService.cpp b/src/MicroOcpp/Model/Certificates/CertificateService.cpp
index b07c2f72..22e5ab6d 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateService.cpp
+++ b/src/MicroOcpp/Model/Certificates/CertificateService.cpp
@@ -14,7 +14,7 @@
 using namespace MicroOcpp;
 
 CertificateService::CertificateService(Context& context)
-        : context(context) {
+        : MemoryManaged("v201.Certificates.CertificateService"), context(context) {
 
     context.getOperationRegistry().registerOperation("DeleteCertificate", [this] () {
         return new Ocpp201::DeleteCertificate(*this);});
diff --git a/src/MicroOcpp/Model/Certificates/CertificateService.h b/src/MicroOcpp/Model/Certificates/CertificateService.h
index 6d11d026..31d10048 100644
--- a/src/MicroOcpp/Model/Certificates/CertificateService.h
+++ b/src/MicroOcpp/Model/Certificates/CertificateService.h
@@ -22,12 +22,13 @@
 #include <memory>
 
 #include <MicroOcpp/Model/Certificates/Certificate.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
 class Context;
 
-class CertificateService {
+class CertificateService : public MemoryManaged {
 private:
     Context& context;
     std::unique_ptr<CertificateStore> certStore;
diff --git a/src/MicroOcpp/Model/Certificates/Certificate_c.cpp b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
index 1152af3b..d316140c 100644
--- a/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
+++ b/src/MicroOcpp/Model/Certificates/Certificate_c.cpp
@@ -6,6 +6,7 @@
 
 #if MO_ENABLE_CERT_MGMT
 
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Debug.h>
 
 #include <string.h>
@@ -15,17 +16,17 @@ namespace MicroOcpp {
 /*
  * C++ wrapper for the C-style certificate interface
  */
-class CertificateStoreC : public CertificateStore {
+class CertificateStoreC : public CertificateStore, public MemoryManaged {
 private:
     ocpp_cert_store *certstore = nullptr;
 public:
-    CertificateStoreC(ocpp_cert_store *certstore) : certstore(certstore) {
+    CertificateStoreC(ocpp_cert_store *certstore) : MemoryManaged("v201.Certificates.CertificateStoreC"), certstore(certstore) {
 
     }
 
     ~CertificateStoreC() = default;
 
-    GetInstalledCertificateStatus getCertificateIds(const std::vector<GetCertificateIdType>& certificateType, std::vector<CertificateChainHash>& out) override {
+    GetInstalledCertificateStatus getCertificateIds(const Vector<GetCertificateIdType>& certificateType, Vector<CertificateChainHash>& out) override {
         out.clear();
 
         ocpp_cert_chain_hash *cch;
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 56eaa7e8..04f04e9e 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -34,7 +34,8 @@
 using namespace MicroOcpp;
 
 Connector::Connector(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId)
-        : context(context), model(context.getModel()), filesystem(filesystem), connectorId(connectorId) {
+        : MemoryManaged("v16.ConnectorBase.Connector"), context(context), model(context.getModel()), filesystem(filesystem), connectorId(connectorId),
+          errorDataInputs(makeVector<std::function<ErrorData ()>>(getMemoryTag())), trackErrorDataInputs(makeVector<bool>(getMemoryTag())) {
 
     context.getRequestQueue().addSendQueue(this); //register at RequestQueue as Request emitter
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 637313e0..84d2722f 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -12,9 +12,9 @@
 #include <MicroOcpp/Core/RequestQueue.h>
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Operations/CiStrings.h>
 
-#include <vector>
 #include <functional>
 #include <memory>
 
@@ -35,7 +35,7 @@ class Model;
 class Operation;
 class Transaction;
 
-class Connector : public RequestEmitter {
+class Connector : public RequestEmitter, public MemoryManaged {
 private:
     Context& context;
     Model& model;
@@ -52,8 +52,8 @@ class Connector : public RequestEmitter {
     std::function<bool()> connectorPluggedInput;
     std::function<bool()> evReadyInput;
     std::function<bool()> evseReadyInput;
-    std::vector<std::function<ErrorData ()>> errorDataInputs;
-    std::vector<bool> trackErrorDataInputs;
+    Vector<std::function<ErrorData ()>> errorDataInputs;
+    Vector<bool> trackErrorDataInputs;
     int reportedErrorIndex = -1; //last reported error
     bool isFaulted();
     const char *getErrorCode();
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index 3eb9d596..f08b3483 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -2,8 +2,6 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
-#include <string>
-
 #include <MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h>
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Core/Configuration.h>
@@ -30,7 +28,7 @@
 using namespace MicroOcpp;
 
 ConnectorsCommon::ConnectorsCommon(Context& context, unsigned int numConn, std::shared_ptr<FilesystemAdapter> filesystem) :
-        context(context) {
+        MemoryManaged("v16.ConnectorBase.ConnectorsCommon"), context(context) {
     
     declareConfiguration<int>("NumberOfConnectors", numConn >= 1 ? numConn - 1 : 0, CONFIGURATION_VOLATILE, true);
     
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
index 2fa856b8..4bc9f78a 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h
@@ -6,12 +6,13 @@
 #define MO_CHARGECONTROLCOMMON_H
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
 class Context;
 
-class ConnectorsCommon {
+class ConnectorsCommon : public MemoryManaged {
 private:
     Context& context;
 public:
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index c4cb6b9a..6eb9a3e0 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -22,8 +22,8 @@
 using namespace MicroOcpp;
 using Ocpp16::DiagnosticsStatus;
 
-DiagnosticsService::DiagnosticsService(Context& context) : context(context) {
-    
+DiagnosticsService::DiagnosticsService(Context& context) : MemoryManaged("v16.Diagnostics.DiagnosticsService"), context(context), location(makeString(getMemoryTag())), diagFileList(makeVector<String>(getMemoryTag())) {
+
     context.getOperationRegistry().registerOperation("GetDiagnostics", [this] () {
         return new Ocpp16::GetDiagnostics(*this);});
 
@@ -33,8 +33,8 @@ DiagnosticsService::DiagnosticsService(Context& context) : context(context) {
 }
 
 DiagnosticsService::~DiagnosticsService() {
-    free(diagPreamble);
-    free(diagPostamble);
+    MO_FREE(diagPreamble);
+    MO_FREE(diagPostamble);
 }
 
 void DiagnosticsService::loop() {
@@ -118,14 +118,14 @@ void DiagnosticsService::loop() {
 }
 
 //timestamps before year 2021 will be treated as "undefined"
-std::string DiagnosticsService::requestDiagnosticsUpload(const char *location, unsigned int retries, unsigned int retryInterval, Timestamp startTime, Timestamp stopTime) {
+MicroOcpp::String DiagnosticsService::requestDiagnosticsUpload(const char *location, unsigned int retries, unsigned int retryInterval, Timestamp startTime, Timestamp stopTime) {
     if (onUpload == nullptr) {
-        return std::string{};
+        return makeString(getMemoryTag());
     }
 
-    std::string fileName;
+    String fileName;
     if (refreshFilename) {
-        fileName = refreshFilename();
+        fileName = refreshFilename().c_str();
     } else {
         fileName = "diagnostics.log";
     }
@@ -247,7 +247,7 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
         }
 
         const size_t diagPreambleSize = 128;
-        diagPreamble = (char*) malloc(diagPreambleSize);
+        diagPreamble = static_cast<char*>(MO_MALLOC(getMemoryTag(), diagPreambleSize));
         if (!diagPreamble) {
             MO_DBG_ERR("OOM");
             this->ftpUploadStatus = UploadStatus::UploadFailed;
@@ -259,11 +259,11 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
         diagReaderHasData = diagnosticsReader ? true : false;
 
         const size_t diagPostambleSize = 1024;
-        diagPostamble = (char*) malloc(diagPostambleSize);
+        diagPostamble = static_cast<char*>(MO_MALLOC(getMemoryTag(), diagPostambleSize));
         if (!diagPostamble) {
             MO_DBG_ERR("OOM");
             this->ftpUploadStatus = UploadStatus::UploadFailed;
-            free(diagPreamble);
+            MO_FREE(diagPreamble);
             return false;
         }
         diagPostambleLen = 0;
@@ -271,8 +271,8 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
 
         auto& model = context.getModel();
 
-        std::string cpModel;
-        std::string fwVersion;
+        auto cpModel = makeString(getMemoryTag());
+        auto fwVersion = makeString(getMemoryTag());
 
         if (auto bootService = model.getBootService()) {
             if (auto cpCreds = bootService->getChargePointCredentials()) {
@@ -295,8 +295,8 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
         if (ret < 0 || (size_t)ret >= diagPreambleSize) {
             MO_DBG_ERR("snprintf: %i", ret);
             this->ftpUploadStatus = UploadStatus::UploadFailed;
-            free(diagPreamble);
-            free(diagPostamble);
+            MO_FREE(diagPreamble);
+            MO_FREE(diagPostamble);
             return false;
         }
 
@@ -413,21 +413,21 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
                 while (written < size && !diagFileList.empty() && filesystem) {
 
                     char fpath [MO_MAX_PATH_SIZE];
-                    auto ret = snprintf(fpath, sizeof(fpath), "%s%s", MO_FILENAME_PREFIX, diagFileList.front().c_str());
+                    auto ret = snprintf(fpath, sizeof(fpath), "%s%s", MO_FILENAME_PREFIX, diagFileList.back().c_str());
                     if (ret < 0 || (size_t)ret >= sizeof(fpath)) {
                         MO_DBG_ERR("fn error: %i", ret);
-                        diagFileList.pop_front();
+                        diagFileList.pop_back();
                         continue;
                     }
 
                     if (auto file = filesystem->open(fpath, "r")) {
 
-                        if (diagFilesFrontTransferred == 0) {
+                        if (diagFilesBackTransferred == 0) {
                             char fileHeading [30 + MO_MAX_PATH_SIZE];
-                            auto writeLen = snprintf(fileHeading, sizeof(fileHeading), "\n\n# File %s:\n", diagFileList.front().c_str());
+                            auto writeLen = snprintf(fileHeading, sizeof(fileHeading), "\n\n# File %s:\n", diagFileList.back().c_str());
                             if (writeLen < 0 || (size_t)writeLen >= sizeof(fileHeading)) {
                                 MO_DBG_ERR("fn error: %i", ret);
-                                diagFileList.pop_front();
+                                diagFileList.pop_back();
                                 continue;
                             }
                             if (writeLen + written > size || //heading doesn't fit anymore, return with a bit unused buffer space and print heading the next time
@@ -441,16 +441,16 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
                             written += (size_t)writeLen;
                         }
 
-                        file->seek(diagFilesFrontTransferred);
+                        file->seek(diagFilesBackTransferred);
                         size_t writeLen = file->read((char*)buf + written, size - written);
 
                         if (writeLen < size - written) {
-                            diagFileList.pop_front();
+                            diagFileList.pop_back();
                         }
                         written += writeLen;
                     } else {
                         MO_DBG_ERR("could not open file: %s", fpath);
-                        diagFileList.pop_front();
+                        diagFileList.pop_back();
                     }
                 }
 
@@ -466,8 +466,8 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
                     this->ftpUploadStatus = UploadStatus::UploadFailed;
                 }
 
-                free(diagPreamble);
-                free(diagPostamble);
+                MO_FREE(diagPreamble);
+                MO_FREE(diagPostamble);
                 diagFileList.clear();
 
                 if (onClose) {
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
index 7df0e788..ed3ae3c0 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.h
@@ -7,10 +7,9 @@
 
 #include <functional>
 #include <memory>
-#include <string>
-#include <deque>
 #include <MicroOcpp/Core/Time.h>
 #include <MicroOcpp/Core/Ftp.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Model/Diagnostics/DiagnosticsStatus.h>
 
 namespace MicroOcpp {
@@ -25,11 +24,11 @@ class Context;
 class Request;
 class FilesystemAdapter;
 
-class DiagnosticsService {
+class DiagnosticsService : public MemoryManaged {
 private:
     Context& context;
     
-    std::string location;
+    String location;
     unsigned int retries = 0;
     unsigned int retryInterval = 0;
     Timestamp startTime;
@@ -53,8 +52,8 @@ class DiagnosticsService {
     char *diagPostamble = nullptr;
     size_t diagPostambleLen = 0;
     size_t diagPostambleTransferred = 0;
-    std::deque<std::string> diagFileList;
-    size_t diagFilesFrontTransferred = 0;
+    Vector<String> diagFileList;
+    size_t diagFilesBackTransferred = 0;
 
     std::unique_ptr<Request> getDiagnosticsStatusNotification();
 
@@ -69,7 +68,7 @@ class DiagnosticsService {
     //timestamps before year 2021 will be treated as "undefined"
     //returns empty std::string if onUpload is missing or upload cannot be scheduled for another reason
     //returns fileName of diagnostics file to be uploaded if upload has been scheduled
-    std::string requestDiagnosticsUpload(const char *location, unsigned int retries = 1, unsigned int retryInterval = 0, Timestamp startTime = Timestamp(), Timestamp stopTime = Timestamp());
+    String requestDiagnosticsUpload(const char *location, unsigned int retries = 1, unsigned int retryInterval = 0, Timestamp startTime = Timestamp(), Timestamp stopTime = Timestamp());
 
     Ocpp16::DiagnosticsStatus getDiagnosticsStatus();
 
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
index 54cf72ca..7eb006e1 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
@@ -22,10 +22,11 @@
 #define MO_IGNORE_FW_RETR_DATE 0
 #endif
 
-using namespace MicroOcpp;
+using MicroOcpp::FirmwareService;
 using MicroOcpp::Ocpp16::FirmwareStatus;
+using MicroOcpp::Request;
 
-FirmwareService::FirmwareService(Context& context) : context(context) {
+FirmwareService::FirmwareService(Context& context) : MemoryManaged("v16.Firmware.FirmwareService"), context(context), buildNumber(makeString(getMemoryTag())), location(makeString(getMemoryTag())) {
     
     context.getOperationRegistry().registerOperation("UpdateFirmware", [this] () {
         return new Ocpp16::UpdateFirmware(*this);});
diff --git a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
index e481458b..5f4671f2 100644
--- a/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
+++ b/src/MicroOcpp/Model/FirmwareManagement/FirmwareService.h
@@ -12,6 +12,7 @@
 #include <MicroOcpp/Model/FirmwareManagement/FirmwareStatus.h>
 #include <MicroOcpp/Core/Time.h>
 #include <MicroOcpp/Core/Ftp.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
@@ -30,12 +31,12 @@ enum class InstallationStatus {
 class Context;
 class Request;
 
-class FirmwareService {
+class FirmwareService : public MemoryManaged {
 private:
     Context& context;
     
     std::shared_ptr<Configuration> previousBuildNumberString;
-    std::string buildNumber;
+    String buildNumber;
 
     std::function<DownloadStatus()> downloadStatusInput;
     bool downloadIssued = false;
@@ -50,7 +51,7 @@ class FirmwareService {
     Ocpp16::FirmwareStatus lastReportedStatus = Ocpp16::FirmwareStatus::Idle;
     bool checkedSuccessfulFwUpdate = false;
 
-    std::string location;
+    String location;
     Timestamp retreiveDate;
     unsigned int retries = 0;
     unsigned int retryInterval = 0;
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
index a77eed0e..ea79cb24 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
@@ -11,7 +11,7 @@
 
 using namespace MicroOcpp;
 
-HeartbeatService::HeartbeatService(Context& context) : context(context) {
+HeartbeatService::HeartbeatService(Context& context) : MemoryManaged("v16.Heartbeat.HeartbeatService"), context(context) {
     heartbeatIntervalInt = declareConfiguration<int>("HeartbeatInterval", 86400);
     lastHeartbeat = mocpp_tick_ms();
 
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
index 0decfa40..ea632cc8 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.h
@@ -5,14 +5,16 @@
 #ifndef MO_HEARTBEATSERVICE_H
 #define MO_HEARTBEATSERVICE_H
 
-#include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <memory>
 
+#include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/Memory.h>
+
 namespace MicroOcpp {
 
 class Context;
 
-class HeartbeatService {
+class HeartbeatService : public MemoryManaged {
 private:
     Context& context;
 
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.cpp b/src/MicroOcpp/Model/Metering/MeterStore.cpp
index d5f7041a..68e84376 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterStore.cpp
@@ -16,7 +16,7 @@
 using namespace MicroOcpp;
 
 TransactionMeterData::TransactionMeterData(unsigned int connectorId, unsigned int txNr, std::shared_ptr<FilesystemAdapter> filesystem)
-        : connectorId(connectorId), txNr(txNr), filesystem{filesystem} {
+        : MemoryManaged("v16.Metering.TransactionMeterData"), connectorId(connectorId), txNr(txNr), filesystem{filesystem}, txData{makeVector<std::unique_ptr<MeterValue>>(getMemoryTag())} {
     
     if (!filesystem) {
         MO_DBG_DEBUG("volatile mode");
@@ -83,10 +83,10 @@ bool TransactionMeterData::addTxData(std::unique_ptr<MeterValue> mv) {
     return true;
 }
 
-std::vector<std::unique_ptr<MeterValue>> TransactionMeterData::retrieveStopTxData() {
+Vector<std::unique_ptr<MeterValue>> TransactionMeterData::retrieveStopTxData() {
     if (isFinalized()) {
         MO_DBG_ERR("Can only retrieve once");
-        return decltype(txData) {};
+        return makeVector<std::unique_ptr<MeterValue>>(getMemoryTag());
     }
     finalize();
     MO_DBG_DEBUG("creating sd");
@@ -112,7 +112,7 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
             return false; //all files have same length
         }
 
-        auto doc = FilesystemUtils::loadJson(filesystem, fn);
+        auto doc = FilesystemUtils::loadJson(filesystem, fn, getMemoryTag());
 
         if (!doc) {
             misses++;
@@ -146,7 +146,7 @@ bool TransactionMeterData::restore(MeterValueBuilder& mvBuilder) {
     return true;
 }
 
-MeterStore::MeterStore(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem {filesystem} {
+MeterStore::MeterStore(std::shared_ptr<FilesystemAdapter> filesystem) : MemoryManaged("v16.Metering.MeterStore"), filesystem {filesystem}, txMeterData{makeVector<std::weak_ptr<TransactionMeterData>>(getMemoryTag())} {
 
     if (!filesystem) {
         MO_DBG_DEBUG("volatile mode");
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.h b/src/MicroOcpp/Model/Metering/MeterStore.h
index 3f14e47c..bdb67441 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.h
+++ b/src/MicroOcpp/Model/Metering/MeterStore.h
@@ -8,13 +8,11 @@
 #include <MicroOcpp/Model/Metering/MeterValue.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
-
-#include <vector>
-#include <deque>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
-class TransactionMeterData {
+class TransactionMeterData : public MemoryManaged {
 private:
     const unsigned int connectorId; //assignment to Transaction object
     const unsigned int txNr; //assignment to Transaction object
@@ -24,14 +22,14 @@ class TransactionMeterData {
 
     std::shared_ptr<FilesystemAdapter> filesystem;
 
-    std::vector<std::unique_ptr<MeterValue>> txData;
+    Vector<std::unique_ptr<MeterValue>> txData;
 
 public:
     TransactionMeterData(unsigned int connectorId, unsigned int txNr, std::shared_ptr<FilesystemAdapter> filesystem);
 
     bool addTxData(std::unique_ptr<MeterValue> mv);
 
-    std::vector<std::unique_ptr<MeterValue>> retrieveStopTxData(); //will invalidate internal cache
+    Vector<std::unique_ptr<MeterValue>> retrieveStopTxData(); //will invalidate internal cache
 
     bool restore(MeterValueBuilder& mvBuilder); //load record from memory; true if record found, false if nothing loaded
 
@@ -42,11 +40,11 @@ class TransactionMeterData {
     bool isFinalized() {return finalized;}
 };
 
-class MeterStore {
+class MeterStore : public MemoryManaged {
 private:
     std::shared_ptr<FilesystemAdapter> filesystem;
     
-    std::vector<std::weak_ptr<TransactionMeterData>> txMeterData;
+    Vector<std::weak_ptr<TransactionMeterData>> txMeterData;
 
 public:
     MeterStore() = delete;
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.cpp b/src/MicroOcpp/Model/Metering/MeterValue.cpp
index 8162d3eb..c00c4f34 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterValue.cpp
@@ -8,9 +8,20 @@
 
 using namespace MicroOcpp;
 
-std::unique_ptr<DynamicJsonDocument> MeterValue::toJson() {
+MeterValue::MeterValue(const Timestamp& timestamp) :
+        MemoryManaged("v16.Metering.MeterValue"), 
+        timestamp(timestamp), 
+        sampledValue(makeVector<std::unique_ptr<SampledValue>>(getMemoryTag())) {
+
+}
+
+void MeterValue::addSampledValue(std::unique_ptr<SampledValue> sample) {
+    sampledValue.push_back(std::move(sample));
+}
+
+std::unique_ptr<JsonDoc> MeterValue::toJson() {
     size_t capacity = 0;
-    std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
+    auto entries = makeVector<std::unique_ptr<JsonDoc>>(getMemoryTag());
     for (auto sample = sampledValue.begin(); sample != sampledValue.end(); sample++) {
         auto json = (*sample)->toJson();
         if (!json) {
@@ -24,7 +35,7 @@ std::unique_ptr<DynamicJsonDocument> MeterValue::toJson() {
     capacity += JSONDATE_LENGTH + 1;
     capacity += JSON_OBJECT_SIZE(2);
     
-    auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
+    auto result = makeJsonDoc(getMemoryTag(), capacity);
     auto jsonPayload = result->to<JsonObject>();
 
     char timestampStr [JSONDATE_LENGTH + 1] = {'\0'};
@@ -56,11 +67,13 @@ ReadingContext MeterValue::getReadingContext() {
     return ReadingContext::NOT_SET;
 }
 
-MeterValueBuilder::MeterValueBuilder(const std::vector<std::unique_ptr<SampledValueSampler>> &samplers,
+MeterValueBuilder::MeterValueBuilder(const Vector<std::unique_ptr<SampledValueSampler>> &samplers,
             std::shared_ptr<Configuration> samplersSelectStr) :
+            MemoryManaged("v16.Metering.MeterValueBuilder"),
             samplers(samplers),
-            selectString(samplersSelectStr) {
-        
+            selectString(samplersSelectStr),
+            select_mask(makeVector<bool>(getMemoryTag())) {
+
     updateObservedSamplers();
     select_observe = selectString->getValueRevision();
 }
@@ -89,7 +102,7 @@ void MeterValueBuilder::updateObservedSamplers() {
 
         if (sr != sl + 1) {
             for (size_t i = 0; i < samplers.size(); i++) {
-                if (!strncmp(samplers[i]->getProperties().getMeasurand().c_str(), sstring + sl, sr - sl)) {
+                if (!strncmp(samplers[i]->getProperties().getMeasurand(), sstring + sl, sr - sl)) {
                     select_mask[i] = true;
                     select_n++;
                 }
@@ -139,11 +152,11 @@ std::unique_ptr<MeterValue> MeterValueBuilder::deserializeSample(const JsonObjec
     for (JsonObject svJson : sampledValue) {  //for each sampled value, search sampler with matching measurand type
         for (auto& sampler : samplers) {
             auto& properties = sampler->getProperties();
-            if (!properties.getMeasurand().compare(svJson["measurand"] | "") &&
-                    !properties.getFormat().compare(svJson["format"] | "") &&
-                    !properties.getPhase().compare(svJson["phase"] | "") &&
-                    !properties.getLocation().compare(svJson["location"] | "") &&
-                    !properties.getUnit().compare(svJson["unit"] | "")) {
+            if (!strcmp(properties.getMeasurand(), svJson["measurand"] | "") &&
+                    !strcmp(properties.getFormat(), svJson["format"] | "") &&
+                    !strcmp(properties.getPhase(), svJson["phase"] | "") &&
+                    !strcmp(properties.getLocation(), svJson["location"] | "") &&
+                    !strcmp(properties.getUnit(), svJson["unit"] | "")) {
                 //found correct sampler
                 auto dVal = sampler->deserializeValue(svJson);
                 if (dVal) {
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.h b/src/MicroOcpp/Model/Metering/MeterValue.h
index f8fd3549..74351943 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.h
+++ b/src/MicroOcpp/Model/Metering/MeterValue.h
@@ -8,23 +8,23 @@
 #include <MicroOcpp/Core/Time.h>
 #include <MicroOcpp/Model/Metering/SampledValue.h>
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <ArduinoJson.h>
 #include <memory>
-#include <vector>
 
 namespace MicroOcpp {
 
-class MeterValue {
+class MeterValue : public MemoryManaged {
 private:
     Timestamp timestamp;
-    std::vector<std::unique_ptr<SampledValue>> sampledValue;
+    Vector<std::unique_ptr<SampledValue>> sampledValue;
 public:
-    MeterValue(Timestamp timestamp) : timestamp(timestamp) { }
+    MeterValue(const Timestamp& timestamp);
     MeterValue(const MeterValue& other) = delete;
 
-    void addSampledValue(std::unique_ptr<SampledValue> sample) {sampledValue.push_back(std::move(sample));}
+    void addSampledValue(std::unique_ptr<SampledValue> sample);
 
-    std::unique_ptr<DynamicJsonDocument> toJson();
+    std::unique_ptr<JsonDoc> toJson();
 
     const Timestamp& getTimestamp();
     void setTimestamp(Timestamp timestamp);
@@ -32,17 +32,17 @@ class MeterValue {
     ReadingContext getReadingContext();
 };
 
-class MeterValueBuilder {
+class MeterValueBuilder : public MemoryManaged {
 private:
-    const std::vector<std::unique_ptr<SampledValueSampler>> &samplers;
+    const Vector<std::unique_ptr<SampledValueSampler>> &samplers;
     std::shared_ptr<Configuration> selectString;
-    std::vector<bool> select_mask;
+    Vector<bool> select_mask;
     unsigned int select_n {0};
     decltype(selectString->getValueRevision()) select_observe;
 
     void updateObservedSamplers();
 public:
-    MeterValueBuilder(const std::vector<std::unique_ptr<SampledValueSampler>> &samplers,
+    MeterValueBuilder(const Vector<std::unique_ptr<SampledValueSampler>> &samplers,
             std::shared_ptr<Configuration> samplersSelectStr);
     
     std::unique_ptr<MeterValue> takeSample(const Timestamp& timestamp, const ReadingContext& context);
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index aa1f4dcc..45373443 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -18,7 +18,7 @@ using namespace MicroOcpp;
 using namespace MicroOcpp::Ocpp16;
 
 MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore& meterStore)
-        : model(model), connectorId{connectorId}, meterStore(meterStore) {
+        : MemoryManaged("v16.Metering.MeteringConnector"), model(model), connectorId{connectorId}, meterStore(meterStore), meterData(makeVector<std::unique_ptr<MeterValue>>(getMemoryTag())), samplers(makeVector<std::unique_ptr<SampledValueSampler>>(getMemoryTag())) {
 
     auto meterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData", "");
     declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
@@ -58,7 +58,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
 
     if ((txBreak || meterData.size() >= (size_t) meterValueCacheSizeInt->getInt()) && !meterData.empty()) {
         auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(std::move(meterData), connectorId, transaction));
-        meterData.clear();
+        meterData = makeVector<std::unique_ptr<MeterValue>>(getMemoryTag());
         return std::move(meterValues); //std::move is required for some compilers even if it's not mandated by standard C++
     }
 
@@ -172,7 +172,7 @@ std::unique_ptr<Operation> MeteringConnector::takeTriggeredMeterValues() {
 }
 
 void MeteringConnector::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
-    if (!meterValueSampler->getProperties().getMeasurand().compare("Energy.Active.Import.Register")) {
+    if (!strcmp(meterValueSampler->getProperties().getMeasurand(), "Energy.Active.Import.Register")) {
         energySamplerIndex = samplers.size();
     }
     samplers.push_back(std::move(meterValueSampler));
@@ -232,8 +232,8 @@ std::shared_ptr<TransactionMeterData> MeteringConnector::getStopTxMeterData(Tran
 
 bool MeteringConnector::existsSampler(const char *measurand, size_t len) {
     for (size_t i = 0; i < samplers.size(); i++) {
-        if (samplers[i]->getProperties().getMeasurand().length() == len &&
-                !strncmp(measurand, samplers[i]->getProperties().getMeasurand().c_str(), len)) {
+        if (strlen(samplers[i]->getProperties().getMeasurand()) == len &&
+                !strncmp(measurand, samplers[i]->getProperties().getMeasurand(), len)) {
             return true;
         }
     }
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.h b/src/MicroOcpp/Model/Metering/MeteringConnector.h
index c40075f5..881c7aa1 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.h
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.h
@@ -7,12 +7,12 @@
 
 #include <functional>
 #include <memory>
-#include <vector>
 
 #include <MicroOcpp/Model/Metering/MeterValue.h>
 #include <MicroOcpp/Model/Metering/MeterStore.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
@@ -21,13 +21,13 @@ class Operation;
 class Transaction;
 class MeterStore;
 
-class MeteringConnector {
+class MeteringConnector : public MemoryManaged {
 private:
     Model& model;
     const int connectorId;
     MeterStore& meterStore;
     
-    std::vector<std::unique_ptr<MeterValue>> meterData;
+    Vector<std::unique_ptr<MeterValue>> meterData;
     std::shared_ptr<TransactionMeterData> stopTxnData;
 
     std::unique_ptr<MeterValueBuilder> sampledDataBuilder;
@@ -45,7 +45,7 @@ class MeteringConnector {
     std::shared_ptr<Transaction> transaction;
     bool trackTxRunning = false;
  
-    std::vector<std::unique_ptr<SampledValueSampler>> samplers;
+    Vector<std::unique_ptr<SampledValueSampler>> samplers;
     int energySamplerIndex {-1};
 
     std::shared_ptr<Configuration> meterValueSampleIntervalInt;
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index 169c2e2a..9196865f 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -14,7 +14,7 @@
 using namespace MicroOcpp;
 
 MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<FilesystemAdapter> filesystem)
-      : context(context), meterStore(filesystem) {
+      : MemoryManaged("v16.Metering.MeteringService"), context(context), meterStore(filesystem), connectors(makeVector<std::unique_ptr<MeteringConnector>>(getMemoryTag())) {
 
     //set factory defaults for Metering-related config keys
     declareConfiguration<const char*>("MeterValuesSampledData", "Energy.Active.Import.Register,Power.Active.Import");
@@ -115,18 +115,14 @@ std::unique_ptr<Request> MeteringService::takeTriggeredMeterValues(int connector
         MO_DBG_ERR("connectorId out of bounds. Ignore");
         return nullptr;
     }
-    auto& connector = connectors.at(connectorId);
-    if (connector.get()) {
-        auto msg = connector->takeTriggeredMeterValues();
-        if (msg) {
-            auto meterValues = makeRequest(std::move(msg));
-            meterValues->setTimeout(120000);
-            return meterValues;
-        }
-        MO_DBG_DEBUG("Did not take any samples for connectorId %d", connectorId);
-        return nullptr;
+
+    auto msg = connectors[connectorId]->takeTriggeredMeterValues();
+    if (msg) {
+        auto meterValues = makeRequest(std::move(msg));
+        meterValues->setTimeout(120000);
+        return meterValues;
     }
-    MO_DBG_ERR("Could not find connector");
+    MO_DBG_DEBUG("Did not take any samples for connectorId %d", connectorId);
     return nullptr;
 }
 
@@ -140,9 +136,7 @@ void MeteringService::beginTxMeterData(Transaction *transaction) {
         MO_DBG_ERR("connectorId is out of bounds");
         return;
     }
-    auto& connector = connectors[connectorId];
-
-    connector->beginTxMeterData(transaction);
+    connectors[connectorId]->beginTxMeterData(transaction);
 }
 
 std::shared_ptr<TransactionMeterData> MeteringService::endTxMeterData(Transaction *transaction) {
@@ -155,9 +149,7 @@ std::shared_ptr<TransactionMeterData> MeteringService::endTxMeterData(Transactio
         MO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
-    auto& connector = connectors[connectorId];
-
-    return connector->endTxMeterData(transaction);
+    return connectors[connectorId]->endTxMeterData(transaction);
 }
 
 void MeteringService::abortTxMeterData(unsigned int connectorId) {
@@ -165,9 +157,7 @@ void MeteringService::abortTxMeterData(unsigned int connectorId) {
         MO_DBG_ERR("connectorId is out of bounds");
         return;
     }
-    auto& connector = connectors[connectorId];
-
-    connector->abortTxMeterData();
+    connectors[connectorId]->abortTxMeterData();
 }
 
 std::shared_ptr<TransactionMeterData> MeteringService::getStopTxMeterData(Transaction *transaction) {
@@ -180,9 +170,7 @@ std::shared_ptr<TransactionMeterData> MeteringService::getStopTxMeterData(Transa
         MO_DBG_ERR("connectorId is out of bounds");
         return nullptr;
     }
-    auto& connector = connectors[connectorId];
-
-    return connector->getStopTxMeterData(transaction);
+    return connectors[connectorId]->getStopTxMeterData(transaction);
 }
 
 bool MeteringService::removeTxMeterData(unsigned int connectorId, unsigned int txNr) {
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.h b/src/MicroOcpp/Model/Metering/MeteringService.h
index 76f8038d..748a0b4a 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.h
+++ b/src/MicroOcpp/Model/Metering/MeteringService.h
@@ -6,12 +6,12 @@
 #define MO_METERINGSERVICE_H
 
 #include <functional>
-#include <vector>
 #include <memory>
 
 #include <MicroOcpp/Model/Metering/MeteringConnector.h>
 #include <MicroOcpp/Model/Metering/SampledValue.h>
 #include <MicroOcpp/Model/Metering/MeterStore.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
@@ -19,12 +19,12 @@ class Context;
 class Request;
 class FilesystemAdapter;
 
-class MeteringService {
+class MeteringService : public MemoryManaged {
 private:
     Context& context;
     MeterStore meterStore;
 
-    std::vector<std::unique_ptr<MeteringConnector>> connectors;
+    Vector<std::unique_ptr<MeteringConnector>> connectors;
 public:
     MeteringService(Context& context, int numConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
diff --git a/src/MicroOcpp/Model/Metering/SampledValue.cpp b/src/MicroOcpp/Model/Metering/SampledValue.cpp
index be7cfedf..64f96152 100644
--- a/src/MicroOcpp/Model/Metering/SampledValue.cpp
+++ b/src/MicroOcpp/Model/Metering/SampledValue.cpp
@@ -16,17 +16,17 @@ int32_t SampledValueDeSerializer<int32_t>::deserialize(const char *str) {
     return strtol(str, nullptr, 10);
 }
 
-std::string SampledValueDeSerializer<int32_t>::serialize(int32_t& val) {
+MicroOcpp::String SampledValueDeSerializer<int32_t>::serialize(int32_t& val) {
     char str [12] = {'\0'};
     snprintf(str, 12, "%" PRId32, val);
-    return std::string(str);
+    return makeString("v16.Metering.SampledValueDeSerializer<int32_t>", str);
 }
 
-std::string SampledValueDeSerializer<float>::serialize(float& val) {
+MicroOcpp::String SampledValueDeSerializer<float>::serialize(float& val) {
     char str [20];
     str[0] = '\0';
     snprintf(str, 20, MO_SAMPLEDVALUE_FLOAT_FORMAT, val);
-    return std::string(str);
+    return makeString("v16.Metering.SampledValueDeSerializer<float>", str);
 }
 
 //helper function
@@ -89,34 +89,29 @@ ReadingContext deserializeReadingContext(const char *context) {
 }
 }} //end namespaces
 
-std::unique_ptr<DynamicJsonDocument> SampledValue::toJson() {
+std::unique_ptr<JsonDoc> SampledValue::toJson() {
     auto value = serializeValue();
     if (value.empty()) {
         return nullptr;
     }
     size_t capacity = 0;
     capacity += JSON_OBJECT_SIZE(8);
-    capacity += value.length() + 1
-                + properties.getFormat().length() + 1
-                + properties.getMeasurand().length() + 1
-                + properties.getPhase().length() + 1
-                + properties.getLocation().length() + 1
-                + properties.getUnit().length() + 1;
-    auto result = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
+    capacity += value.length() + 1;
+    auto result = makeJsonDoc("v16.Metering.SampledValue", capacity);
     auto payload = result->to<JsonObject>();
     payload["value"] = value;
     auto context_cstr = Ocpp16::serializeReadingContext(context);
     if (context_cstr)
         payload["context"] = context_cstr;
-    if (!properties.getFormat().empty())
+    if (*properties.getFormat())
         payload["format"] = properties.getFormat();
-    if (!properties.getMeasurand().empty())
+    if (*properties.getMeasurand())
         payload["measurand"] = properties.getMeasurand();
-    if (!properties.getPhase().empty())
+    if (*properties.getPhase())
         payload["phase"] = properties.getPhase();
-    if (!properties.getLocation().empty())
+    if (*properties.getLocation())
         payload["location"] = properties.getLocation();
-    if (!properties.getUnit().empty())
+    if (*properties.getUnit())
         payload["unit"] = properties.getUnit();
     return result;
 }
diff --git a/src/MicroOcpp/Model/Metering/SampledValue.h b/src/MicroOcpp/Model/Metering/SampledValue.h
index a75963a5..aabc674d 100644
--- a/src/MicroOcpp/Model/Metering/SampledValue.h
+++ b/src/MicroOcpp/Model/Metering/SampledValue.h
@@ -9,6 +9,7 @@
 #include <memory>
 #include <functional>
 
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Platform.h>
 
 namespace MicroOcpp {
@@ -18,7 +19,7 @@ class SampledValueDeSerializer {
 public:
     static T deserialize(const char *str);
     static bool ready(T& val);
-    static std::string serialize(T& val);
+    static String serialize(T& val);
     static int32_t toInteger(T& val);
 };
 
@@ -27,7 +28,7 @@ class SampledValueDeSerializer<int32_t> { // example class
 public:
     static int32_t deserialize(const char *str);
     static bool ready(int32_t& val) {return true;} //int32_t is always valid
-    static std::string serialize(int32_t& val);
+    static String serialize(int32_t& val);
     static int32_t toInteger(int32_t& val) {return val;} //no conversion required
 };
 
@@ -36,20 +37,25 @@ class SampledValueDeSerializer<float> { // Used in meterValues
 public:
     static float deserialize(const char *str) {return atof(str);}
     static bool ready(float& val) {return true;} //float is always valid
-    static std::string serialize(float& val);
+    static String serialize(float& val);
     static int32_t toInteger(float& val) {return (int32_t) val;}
 };
 
 class SampledValueProperties {
 private:
-    std::string format;
-    std::string measurand;
-    std::string phase;
-    std::string location;
-    std::string unit;
+    String format;
+    String measurand;
+    String phase;
+    String location;
+    String unit;
 
 public:
-    SampledValueProperties() { }
+    SampledValueProperties() :
+            format(makeString("v16.Metering.SampledValueProperties")),
+            measurand(makeString("v16.Metering.SampledValueProperties")),
+            phase(makeString("v16.Metering.SampledValueProperties")),
+            location(makeString("v16.Metering.SampledValueProperties")),
+            unit(makeString("v16.Metering.SampledValueProperties")) { }
     SampledValueProperties(const SampledValueProperties& other) :
             format(other.format),
             measurand(other.measurand),
@@ -59,15 +65,15 @@ class SampledValueProperties {
     ~SampledValueProperties() = default;
 
     void setFormat(const char *format) {this->format = format;}
-    const std::string& getFormat() const {return format;}
+    const char *getFormat() const {return format.c_str();}
     void setMeasurand(const char *measurand) {this->measurand = measurand;}
-    const std::string& getMeasurand() const {return measurand;}
+    const char *getMeasurand() const {return measurand.c_str();}
     void setPhase(const char *phase) {this->phase = phase;}
-    const std::string& getPhase() const {return phase;}
+    const char *getPhase() const {return phase.c_str();}
     void setLocation(const char *location) {this->location = location;}
-    const std::string& getLocation() const {return location;}
+    const char *getLocation() const {return location.c_str();}
     void setUnit(const char *unit) {this->unit = unit;}
-    const std::string& getUnit() const {return unit;}
+    const char *getUnit() const {return unit.c_str();}
 };
 
 enum class ReadingContext {
@@ -91,13 +97,13 @@ class SampledValue {
 protected:
     const SampledValueProperties& properties;
     const ReadingContext context;
-    virtual std::string serializeValue() = 0;
+    virtual String serializeValue() = 0;
 public:
     SampledValue(const SampledValueProperties& properties, ReadingContext context) : properties(properties), context(context) { }
     SampledValue(const SampledValue& other) : properties(other.properties), context(other.context) { }
     virtual ~SampledValue() = default;
 
-    std::unique_ptr<DynamicJsonDocument> toJson();
+    std::unique_ptr<JsonDoc> toJson();
 
     virtual operator bool() = 0;
     virtual int32_t toInteger() = 0;
@@ -106,17 +112,17 @@ class SampledValue {
 };
 
 template <class T, class DeSerializer>
-class SampledValueConcrete : public SampledValue {
+class SampledValueConcrete : public SampledValue, public MemoryManaged {
 private:
     T value;
 public:
-    SampledValueConcrete(const SampledValueProperties& properties, ReadingContext context, const T&& value) : SampledValue(properties, context), value(value) { }
-    SampledValueConcrete(const SampledValueConcrete& other) : SampledValue(other), value(other.value) { }
+    SampledValueConcrete(const SampledValueProperties& properties, ReadingContext context, const T&& value) : SampledValue(properties, context), MemoryManaged("v16.Metering.SampledValueConcrete"), value(value) { }
+    SampledValueConcrete(const SampledValueConcrete& other) : SampledValue(other), MemoryManaged(other), value(other.value) { }
     ~SampledValueConcrete() = default;
 
     operator bool() override {return DeSerializer::ready(value);}
 
-    std::string serializeValue() override {return DeSerializer::serialize(value);}
+    String serializeValue() override {return DeSerializer::serialize(value);}
 
     int32_t toInteger() override { return DeSerializer::toInteger(value);}
 };
@@ -133,11 +139,11 @@ class SampledValueSampler {
 };
 
 template <class T, class DeSerializer>
-class SampledValueSamplerConcrete : public SampledValueSampler {
+class SampledValueSamplerConcrete : public SampledValueSampler, public MemoryManaged {
 private:
     std::function<T(ReadingContext context)> sampler;
 public:
-    SampledValueSamplerConcrete(SampledValueProperties properties, std::function<T(ReadingContext)> sampler) : SampledValueSampler(properties), sampler(sampler) { }
+    SampledValueSamplerConcrete(SampledValueProperties properties, std::function<T(ReadingContext)> sampler) : SampledValueSampler(properties), MemoryManaged("v16.Metering.SampledValueSamplerConcrete"), sampler(sampler) { }
     std::unique_ptr<SampledValue> takeValue(ReadingContext context) override {
         return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(
             properties,
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index a98ab72f..571f19cb 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -4,8 +4,6 @@
 
 #include <MicroOcpp/Model/Model.h>
 
-#include <string>
-
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
 #include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h>
@@ -27,7 +25,7 @@
 
 using namespace MicroOcpp;
 
-Model::Model(ProtocolVersion version, uint16_t bootNr) : version(version), bootNr(bootNr) {
+Model::Model(ProtocolVersion version, uint16_t bootNr) : MemoryManaged("Model"), connectors(makeVector<std::unique_ptr<Connector>>(getMemoryTag())), version(version), bootNr(bootNr) {
 
 }
 
@@ -114,7 +112,7 @@ ConnectorsCommon *Model::getConnectorsCommon() {
     return chargeControlCommon.get();
 }
 
-void Model::setConnectors(std::vector<std::unique_ptr<Connector>>&& connectors) {
+void Model::setConnectors(Vector<std::unique_ptr<Connector>>&& connectors) {
     this->connectors = std::move(connectors);
     capabilitiesUpdated = true;
 }
@@ -266,7 +264,7 @@ void Model::updateSupportedStandardProfiles() {
         return;
     }
 
-    std::string buf = supportedFeatureProfilesString->getString();
+    auto buf = makeString(getMemoryTag(), supportedFeatureProfilesString->getString());
 
     if (chargeControlCommon &&
             heartbeatService &&
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index fd93faba..67639ee1 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -8,6 +8,7 @@
 #include <memory>
 
 #include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Version.h>
 #include <MicroOcpp/Model/ConnectorBase/Connector.h>
 
@@ -44,9 +45,9 @@ class ResetService;
 }
 #endif //MO_ENABLE_V201
 
-class Model {
+class Model : public MemoryManaged {
 private:
-    std::vector<std::unique_ptr<Connector>> connectors;
+    Vector<std::unique_ptr<Connector>> connectors;
     std::unique_ptr<TransactionStore> transactionStore;
     std::unique_ptr<SmartChargingService> smartChargingService;
     std::unique_ptr<ConnectorsCommon> chargeControlCommon;
@@ -104,7 +105,7 @@ class Model {
     void setConnectorsCommon(std::unique_ptr<ConnectorsCommon> ccs);
     ConnectorsCommon *getConnectorsCommon();
 
-    void setConnectors(std::vector<std::unique_ptr<Connector>>&& connectors);
+    void setConnectors(Vector<std::unique_ptr<Connector>>&& connectors);
     unsigned int getNumConnectors() const;
     Connector *getConnector(unsigned int connectorId);
 
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.cpp b/src/MicroOcpp/Model/Reservation/Reservation.cpp
index e16618ff..eb856b5d 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.cpp
+++ b/src/MicroOcpp/Model/Reservation/Reservation.cpp
@@ -12,7 +12,7 @@
 
 using namespace MicroOcpp;
 
-Reservation::Reservation(Model& model, unsigned int slot) : model(model), slot(slot) {
+Reservation::Reservation(Model& model, unsigned int slot) : MemoryManaged("v16.Reservation.Reservation"), model(model), slot(slot) {
     
     snprintf(connectorIdKey, sizeof(connectorIdKey), MO_RESERVATION_CID_KEY "%u", slot);
     connectorIdInt = declareConfiguration<int>(connectorIdKey, -1, RESERVATION_FN, false, false, false);
diff --git a/src/MicroOcpp/Model/Reservation/Reservation.h b/src/MicroOcpp/Model/Reservation/Reservation.h
index dba888e6..daae197a 100644
--- a/src/MicroOcpp/Model/Reservation/Reservation.h
+++ b/src/MicroOcpp/Model/Reservation/Reservation.h
@@ -11,6 +11,7 @@
 
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Memory.h>
 
 #ifndef RESERVATION_FN
 #define RESERVATION_FN (MO_FILENAME_PREFIX "reservations.jsn")
@@ -26,7 +27,7 @@ namespace MicroOcpp {
 
 class Model;
 
-class Reservation {
+class Reservation : public MemoryManaged {
 private:
     Model& model;
     const unsigned int slot;
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.cpp b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
index d1131c4c..dde39aea 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.cpp
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.cpp
@@ -18,7 +18,7 @@
 
 using namespace MicroOcpp;
 
-ReservationService::ReservationService(Context& context, unsigned int numConnectors) : context(context), maxReservations((int) numConnectors - 1) {
+ReservationService::ReservationService(Context& context, unsigned int numConnectors) : MemoryManaged("v16.Reservation.ReservationService"), context(context), maxReservations((int) numConnectors - 1), reservations(makeVector<std::unique_ptr<Reservation>>(getMemoryTag())) {
     if (maxReservations > 0) {
         reservations.reserve((size_t) maxReservations);
         for (int i = 0; i < maxReservations; i++) {
diff --git a/src/MicroOcpp/Model/Reservation/ReservationService.h b/src/MicroOcpp/Model/Reservation/ReservationService.h
index 2d052594..367f1f59 100644
--- a/src/MicroOcpp/Model/Reservation/ReservationService.h
+++ b/src/MicroOcpp/Model/Reservation/ReservationService.h
@@ -10,6 +10,7 @@
 #if MO_ENABLE_RESERVATION
 
 #include <MicroOcpp/Model/Reservation/Reservation.h>
+#include <MicroOcpp/Core/Memory.h>
 
 #include <memory>
 
@@ -17,12 +18,12 @@ namespace MicroOcpp {
 
 class Context;
 
-class ReservationService {
+class ReservationService : public MemoryManaged {
 private:
     Context& context;
 
     const int maxReservations; // = number of physical connectors
-    std::vector<std::unique_ptr<Reservation>> reservations;
+    Vector<std::unique_ptr<Reservation>> reservations;
 
     std::shared_ptr<Configuration> reserveConnectorZeroSupportedBool;
 
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index d43436c4..ebe7ca07 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -26,7 +26,7 @@
 using namespace MicroOcpp;
 
 ResetService::ResetService(Context& context)
-      : context(context) {
+      : MemoryManaged("v16.Reset.ResetService"), context(context) {
 
     resetRetriesInt = declareConfiguration<int>("ResetRetries", 2);
 
@@ -110,7 +110,7 @@ namespace MicroOcpp {
 namespace Ocpp201 {
 
 ResetService::ResetService(Context& context)
-      : context(context) {
+      : MemoryManaged("v201.Reset.ResetService"), context(context), evses(makeVector<Evse>(getMemoryTag())) {
 
     auto varService = context.getModel().getVariableService();
     resetRetriesInt = varService->declareVariable<int>("OCPPCommCtrlr", "ResetRetries", 0);
diff --git a/src/MicroOcpp/Model/Reset/ResetService.h b/src/MicroOcpp/Model/Reset/ResetService.h
index 88481815..a84e82d6 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.h
+++ b/src/MicroOcpp/Model/Reset/ResetService.h
@@ -6,17 +6,17 @@
 #define MO_RESETSERVICE_H
 
 #include <functional>
-#include <vector>
 
 #include <MicroOcpp/Version.h>
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Model/Reset/ResetDefs.h>
 
 namespace MicroOcpp {
 
 class Context;
 
-class ResetService {
+class ResetService : public MemoryManaged {
 private:
     Context& context;
 
@@ -64,7 +64,7 @@ class Variable;
 
 namespace Ocpp201 {
 
-class ResetService {
+class ResetService : public MemoryManaged {
 private:
     Context& context;
 
@@ -86,7 +86,7 @@ class ResetService {
         void loop();
     };
 
-    std::vector<Evse> evses;
+    Vector<Evse> evses;
     Evse *getEvse(unsigned int connectorId);
     Evse *getOrCreateEvse(unsigned int connectorId);
 
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
index 4bab8476..3c71d539 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.cpp
@@ -18,6 +18,10 @@ ChargeRate MicroOcpp::chargeRate_min(const ChargeRate& a, const ChargeRate& b) {
     return res;
 }
 
+ChargingSchedule::ChargingSchedule() : MemoryManaged("v16.SmartCharging.SmartChargingModel"), chargingSchedulePeriod{makeVector<ChargingSchedulePeriod>(getMemoryTag())} {
+
+}
+
 bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &startOfCharging, ChargeRate& limit, Timestamp& nextChange) {
     Timestamp basis = Timestamp(); //point in time to which schedule-related times are relative
     switch (chargingProfileKind) {
@@ -116,13 +120,13 @@ bool ChargingSchedule::calculateLimit(const Timestamp &t, const Timestamp &start
     }
 }
 
-bool ChargingSchedule::toJson(DynamicJsonDocument& doc) {
+bool ChargingSchedule::toJson(JsonDoc& doc) {
     size_t capacity = 0;
     capacity += JSON_OBJECT_SIZE(5); //no of fields of ChargingSchedule
     capacity += JSONDATE_LENGTH + 1; //startSchedule
     capacity += JSON_ARRAY_SIZE(chargingSchedulePeriod.size()) + chargingSchedulePeriod.size() * JSON_OBJECT_SIZE(3);
 
-    doc = DynamicJsonDocument(capacity);
+    doc = initJsonDoc("v16.SmartCharging.ChargingSchedule", capacity);
     if (duration >= 0) {
         doc["duration"] = duration;
     }
@@ -173,6 +177,10 @@ void ChargingSchedule::printSchedule(){
     }
 }
 
+ChargingProfile::ChargingProfile() : MemoryManaged("v16.SmartCharging.ChargingProfile") {
+
+}
+
 bool ChargingProfile::calculateLimit(const Timestamp &t, const Timestamp &startOfCharging, ChargeRate& limit, Timestamp& nextChange){
     if (t > validTo && validTo > MIN_TIME) {
         return false; //no limit defined
@@ -205,14 +213,14 @@ ChargingProfilePurposeType ChargingProfile::getChargingProfilePurpose(){
     return chargingProfilePurpose;
 }
 
-bool ChargingProfile::toJson(DynamicJsonDocument& doc) {
+bool ChargingProfile::toJson(JsonDoc& doc) {
     
-    DynamicJsonDocument chargingScheduleDoc {0};
+    auto chargingScheduleDoc = initJsonDoc("v16.SmartCharging.ChargingSchedule");
     if (!chargingSchedule.toJson(chargingScheduleDoc)) {
         return false;
     }
 
-    doc = DynamicJsonDocument(
+    doc = initJsonDoc("v16.SmartCharging.ChargingProfile",
             JSON_OBJECT_SIZE(9) + //no. of fields in ChargingProfile
             2 * (JSONDATE_LENGTH + 1) + //validFrom and validTo
             chargingScheduleDoc.memoryUsage()); //nested JSON object
@@ -486,7 +494,7 @@ bool MicroOcpp::loadChargingSchedule(JsonObject& json, ChargingSchedule& out) {
     }
 
     for (JsonObject periodJson : periodJsonArray) {
-        out.chargingSchedulePeriod.push_back(ChargingSchedulePeriod());
+        out.chargingSchedulePeriod.emplace_back();
         if (!loadChargingSchedulePeriod(periodJson, out.chargingSchedulePeriod.back())) {
             return false;
         }
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
index 74d571b6..825d6866 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingModel.h
@@ -18,12 +18,12 @@
 #endif
 
 #include <memory>
-#include <vector>
 #include <limits>
 
 #include <ArduinoJson.h>
 
 #include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
@@ -75,17 +75,19 @@ class ChargingSchedulePeriod {
     int numberPhases = 3;
 };
 
-class ChargingSchedule {
+class ChargingSchedule : public MemoryManaged {
 public:
     int duration = -1;
     Timestamp startSchedule;
     ChargingRateUnitType chargingRateUnit;
-    std::vector<ChargingSchedulePeriod> chargingSchedulePeriod;
+    Vector<ChargingSchedulePeriod> chargingSchedulePeriod;
     float minChargingRate = -1.0f;
 
     ChargingProfileKindType chargingProfileKind; //copied from ChargingProfile to increase cohesion of limit algorithms
     RecurrencyKindType recurrencyKind = RecurrencyKindType::NOT_SET; //copied from ChargingProfile to increase cohesion of limit algorithms
 
+    ChargingSchedule();
+
     /**
      * limit: output parameter
      * nextChange: output parameter
@@ -96,7 +98,7 @@ class ChargingSchedule {
      */
     bool calculateLimit(const Timestamp &t, const Timestamp &startOfCharging, ChargeRate& limit, Timestamp& nextChange);
 
-    bool toJson(DynamicJsonDocument& out);
+    bool toJson(JsonDoc& out);
 
     /*
     * print on console
@@ -104,7 +106,7 @@ class ChargingSchedule {
     void printSchedule();
 };
 
-class ChargingProfile {
+class ChargingProfile : public MemoryManaged {
 public:
     int chargingProfileId = -1;
     int transactionId = -1;
@@ -116,6 +118,8 @@ class ChargingProfile {
     Timestamp validTo;
     ChargingSchedule chargingSchedule;
 
+    ChargingProfile();
+
     /**
      * limit: output parameter
      * nextChange: output parameter
@@ -137,7 +141,7 @@ class ChargingProfile {
     
     ChargingProfilePurposeType getChargingProfilePurpose();
 
-    bool toJson(DynamicJsonDocument& out);
+    bool toJson(JsonDoc& out);
 
     /*
     * print on console
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
index 08445340..762bd6ac 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.cpp
@@ -16,7 +16,7 @@
 using namespace::MicroOcpp;
 
 SmartChargingConnector::SmartChargingConnector(Model& model, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int connectorId, ProfileStack& ChargePointMaxProfile, ProfileStack& ChargePointTxDefaultProfile) :
-        model(model), filesystem{filesystem}, connectorId{connectorId}, ChargePointMaxProfile(ChargePointMaxProfile), ChargePointTxDefaultProfile(ChargePointTxDefaultProfile) {
+        MemoryManaged("v16.SmartCharging.SmartChargingConnector"), model(model), filesystem{filesystem}, connectorId{connectorId}, ChargePointMaxProfile(ChargePointMaxProfile), ChargePointTxDefaultProfile(ChargePointTxDefaultProfile) {
     
 }
 
@@ -267,7 +267,7 @@ std::unique_ptr<ChargingSchedule> SmartChargingConnector::getCompositeSchedule(i
             }
         }
 
-        periods.push_back(ChargingSchedulePeriod());
+        periods.emplace_back();
         float limit_opt = unit == ChargingRateUnitType_Optional::Watt ? limit.power : limit.current;
         periods.back().limit = limit_opt != std::numeric_limits<float>::max() ? limit_opt : -1.f,
         periods.back().numberPhases = limit.nphases != std::numeric_limits<int>::max() ? limit.nphases : -1;
@@ -311,10 +311,10 @@ SmartChargingConnector *SmartChargingService::getScConnectorById(unsigned int co
 }
 
 SmartChargingService::SmartChargingService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int numConnectors)
-      : context(context), filesystem{filesystem}, numConnectors(numConnectors) {
+      : MemoryManaged("v16.SmartCharging.SmartChargingService"), context(context), filesystem{filesystem}, connectors{makeVector<SmartChargingConnector>(getMemoryTag())}, numConnectors(numConnectors) {
     
     for (unsigned int cId = 1; cId < numConnectors; cId++) {
-        connectors.push_back(std::move(SmartChargingConnector(context.getModel(), filesystem, cId, ChargePointMaxProfile, ChargePointTxDefaultProfile)));
+        connectors.emplace_back(context.getModel(), filesystem, cId, ChargePointMaxProfile, ChargePointTxDefaultProfile);
     }
 
     declareConfiguration<int>("ChargeProfileMaxStackLevel", MO_ChargeProfileMaxStackLevel, CONFIGURATION_VOLATILE, true);
@@ -444,7 +444,7 @@ bool SmartChargingService::loadProfiles() {
                     continue; //There is not a profile on the stack iStack with stacklevel iLevel. Normal case, just continue.
                 }
 
-                auto profileDoc = FilesystemUtils::loadJson(filesystem, fn);
+                auto profileDoc = FilesystemUtils::loadJson(filesystem, fn, getMemoryTag());
                 if (!profileDoc) {
                     success = false;
                     MO_DBG_ERR("profile corrupt: %s, remove", fn);
@@ -738,7 +738,7 @@ bool SmartChargingServiceUtils::storeProfile(std::shared_ptr<FilesystemAdapter>
         return true; //not an error
     }
 
-    DynamicJsonDocument chargingProfileJson {0};
+    auto chargingProfileJson = initJsonDoc("v16.SmartCharging.ChargingProfile");
     if (!chargingProfile->toJson(chargingProfileJson)) {
         return false;
     }
diff --git a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
index e3a41dab..57952a72 100644
--- a/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
+++ b/src/MicroOcpp/Model/SmartCharging/SmartChargingService.h
@@ -13,6 +13,7 @@
 #include <MicroOcpp/Model/SmartCharging/SmartChargingModel.h>
 #include <MicroOcpp/Core/Time.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
@@ -27,7 +28,7 @@ class Model;
 
 using ProfileStack = std::array<std::unique_ptr<ChargingProfile>, MO_ChargeProfileMaxStackLevel + 1>;
 
-class SmartChargingConnector {
+class SmartChargingConnector : public MemoryManaged {
 private:
     Model& model;
     std::shared_ptr<FilesystemAdapter> filesystem;
@@ -72,11 +73,11 @@ class SmartChargingConnector {
     size_t getChargingProfilesCount();
 };
 
-class SmartChargingService {
+class SmartChargingService : public MemoryManaged {
 private:
     Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
-    std::vector<SmartChargingConnector> connectors; //connectorId 0 excluded
+    Vector<SmartChargingConnector> connectors; //connectorId 0 excluded
     SmartChargingConnector *getScConnectorById(unsigned int connectorId);
     unsigned int numConnectors; //connectorId 0 included
     
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index 4413102a..0e7dfd90 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -8,6 +8,7 @@
 #ifdef __cplusplus
 
 #include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Operations/CiStrings.h>
 
 namespace MicroOcpp {
@@ -44,7 +45,7 @@ class SendStatus {
     void setAttemptTime(const Timestamp& timestamp) {attemptTime = timestamp;}
 };
 
-class Transaction {
+class Transaction : public MemoryManaged {
 private:
     ConnectorTransactionStore& context;
 
@@ -90,6 +91,7 @@ class Transaction {
 
 public:
     Transaction(ConnectorTransactionStore& context, unsigned int connectorId, unsigned int txNr, bool silent = false) : 
+                MemoryManaged("v16.Transactions.Transaction"),
                 context(context),
                 connectorId(connectorId), 
                 txNr(txNr),
@@ -221,7 +223,7 @@ enum class TransactionEventTriggerReason : uint8_t {
     ResetCommand
 };
 
-class Transaction {
+class Transaction : public MemoryManaged {
 public:
 
     // ReasonEnumType (3.67)
@@ -291,10 +293,12 @@ class Transaction {
     StopReason stopReason = StopReason::UNDEFINED;
     TransactionEventTriggerReason stopTrigger = TransactionEventTriggerReason::UNDEFINED;
     std::unique_ptr<IdToken> stopIdToken; // if null, then stopIdToken equals idToken
+
+    Transaction() : MemoryManaged("v201.Transactions.Transaction") { }
 };
 
 // TransactionEventRequest (1.60.1)
-class TransactionEventData {
+class TransactionEventData : public MemoryManaged {
 public:
 
     // TransactionEventEnumType (3.80)
@@ -333,7 +337,7 @@ class TransactionEventData {
     EvseId evse = -1;
     //meterValue not supported
 
-    TransactionEventData(std::shared_ptr<Transaction> transaction, unsigned int seqNo) : transaction(transaction), seqNo(seqNo) { }
+    TransactionEventData(std::shared_ptr<Transaction> transaction, unsigned int seqNo) : MemoryManaged("v201.Transactions.TransactionEventData"), transaction(transaction), seqNo(seqNo) { }
 };
 
 } // namespace Ocpp201
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
index eb3ff237..e3c412f0 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.cpp
@@ -51,8 +51,8 @@ bool deserializeSendStatus(SendStatus& status, JsonObject in) {
     return true;
 }
 
-bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out) {
-    out = DynamicJsonDocument(1024);
+bool serializeTransaction(Transaction& tx, JsonDoc& out) {
+    out = initJsonDoc("v16.Transactions.TransactionDeserialize", 1024);
     JsonObject state = out.to<JsonObject>();
 
     JsonObject sessionState = state.createNestedObject("session");
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
index b3f0549e..c8cfc427 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionDeserialize.h
@@ -6,12 +6,13 @@
 #define MO_TRANSACTIONDESERIALIZE_H
 
 #include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Core/Memory.h>
 
 #include <ArduinoJson.h>
 
 namespace MicroOcpp {
 
-bool serializeTransaction(Transaction& tx, DynamicJsonDocument& out);
+bool serializeTransaction(Transaction& tx, JsonDoc& out);
 bool deserializeTransaction(Transaction& tx, JsonObject in);
 
 }
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index a1ccd4aa..c36126ac 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -24,7 +24,7 @@ using namespace MicroOcpp;
 using namespace MicroOcpp::Ocpp201;
 
 TransactionService::Evse::Evse(Context& context, TransactionService& txService, unsigned int evseId) :
-        context(context), txService(txService), evseId(evseId) {
+        MemoryManaged("v201.Transactions.TransactionServiceEvse"), context(context), txService(txService), evseId(evseId) {
 
 }
 
@@ -314,10 +314,10 @@ void TransactionService::Evse::loop() {
         // meterValue not supported
 
         if (transaction->notifyStopIdToken && transaction->stopIdToken) {
-            txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(*transaction->stopIdToken.get()));
+            txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(*transaction->stopIdToken.get(), getMemoryTag()));
             transaction->notifyStopIdToken = false;
         }  else if (transaction->notifyIdToken) {
-            txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(transaction->idToken));
+            txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(transaction->idToken, getMemoryTag()));
             transaction->notifyIdToken = false;
         }
     }
@@ -414,7 +414,7 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
         transaction->isAuthorized = false;
         transaction->notifyIdToken = true;
     } else if (!validateIdToken) {
-        transaction->stopIdToken = std::unique_ptr<IdToken>(new IdToken(idToken));
+        transaction->stopIdToken = std::unique_ptr<IdToken>(new IdToken(idToken, getMemoryTag()));
         transaction->isAuthorized = false;
         transaction->notifyStopIdToken = true;
     } else {
@@ -429,7 +429,7 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
             return false;
         }
 
-        authorize->setOnReceiveConfListener([tx, idToken] (JsonObject response) {
+        authorize->setOnReceiveConfListener([tx, idToken, this] (JsonObject response) {
             if (strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
                 MO_DBG_DEBUG("Authorize rejected (%s), don't stop tx", idToken.get());
                 return;
@@ -437,7 +437,7 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
 
             MO_DBG_DEBUG("Authorized transaction stop (%s)", idToken.get());
 
-            tx->stopIdToken = std::unique_ptr<IdToken>(new IdToken(idToken));
+            tx->stopIdToken = std::unique_ptr<IdToken>(new IdToken(idToken, getMemoryTag()));
             if (!tx->stopIdToken) {
                 // OOM
                 if (tx->active) {
@@ -501,7 +501,7 @@ bool TransactionService::isTxStopPoint(TxStartStopPoint check) {
     return false;
 }
 
-bool TransactionService::parseTxStartStopPoint(const char *csl, std::vector<TxStartStopPoint>& dst) {
+bool TransactionService::parseTxStartStopPoint(const char *csl, Vector<TxStartStopPoint>& dst) {
     dst.clear();
 
     while (*csl == ',') {
@@ -547,7 +547,7 @@ bool TransactionService::parseTxStartStopPoint(const char *csl, std::vector<TxSt
     return true;
 }
 
-TransactionService::TransactionService(Context& context) : context(context) {
+TransactionService::TransactionService(Context& context) : MemoryManaged("v201.Transactions.TransactionService"), context(context), evses(makeVector<Evse>(getMemoryTag())), txStartPointParsed(makeVector<TxStartStopPoint>(getMemoryTag())),  txStopPointParsed(makeVector<TxStartStopPoint>(getMemoryTag())) {
     auto variableService = context.getModel().getVariableService();
 
     txStartPointString = variableService->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "PowerPathClosed");
@@ -559,12 +559,12 @@ TransactionService::TransactionService(Context& context) : context(context) {
     variableService->declareVariable<bool>("AuthCtrlr", "AuthorizeRemoteStart", false, MO_VARIABLE_VOLATILE, Variable::Mutability::ReadOnly);
 
     variableService->registerValidator<const char*>("TxCtrlr", "TxStartPoint", [this] (const char *value) -> bool {
-        std::vector<TxStartStopPoint> validated;
+        auto validated = makeVector<TxStartStopPoint>(getMemoryTag());
         return this->parseTxStartStopPoint(value, validated);
     });
 
     variableService->registerValidator<const char*>("TxCtrlr", "TxStopPoint", [this] (const char *value) -> bool {
-        std::vector<TxStartStopPoint> validated;
+        auto validated = makeVector<TxStartStopPoint>(getMemoryTag());
         return this->parseTxStartStopPoint(value, validated);
     });
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.h b/src/MicroOcpp/Model/Transactions/TransactionService.h
index 20edc212..4b985b24 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.h
@@ -15,20 +15,20 @@
 
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/Transactions/TransactionDefs.h>
+#include <MicroOcpp/Core/Memory.h>
 
 #include <memory>
 #include <functional>
-#include <vector>
 
 namespace MicroOcpp {
 
 class Context;
 class Variable;
 
-class TransactionService {
+class TransactionService : public MemoryManaged {
 public:
 
-    class Evse {
+    class Evse : public MemoryManaged {
     private:
         Context& context;
         TransactionService& txService;
@@ -79,7 +79,7 @@ class TransactionService {
     };
 
     Context& context;
-    std::vector<Evse> evses;
+    Vector<Evse> evses;
 
     Variable *txStartPointString = nullptr;
     Variable *txStopPointString = nullptr;
@@ -88,12 +88,12 @@ class TransactionService {
     Variable *evConnectionTimeOutInt = nullptr;
     uint16_t trackTxStartPoint = -1;
     uint16_t trackTxStopPoint = -1;
-    std::vector<TxStartStopPoint> txStartPointParsed;
-    std::vector<TxStartStopPoint> txStopPointParsed;
+    Vector<TxStartStopPoint> txStartPointParsed;
+    Vector<TxStartStopPoint> txStopPointParsed;
     bool isTxStartPoint(TxStartStopPoint check);
     bool isTxStopPoint(TxStartStopPoint check);
 
-    bool parseTxStartStopPoint(const char *src, std::vector<TxStartStopPoint>& dst);
+    bool parseTxStartStopPoint(const char *src, Vector<TxStartStopPoint>& dst);
 
 public:
     TransactionService(Context& context);
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
index ccb48333..97c62d4b 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
@@ -10,9 +10,11 @@
 using namespace MicroOcpp;
 
 ConnectorTransactionStore::ConnectorTransactionStore(TransactionStore& context, unsigned int connectorId, std::shared_ptr<FilesystemAdapter> filesystem) :
+        MemoryManaged("v16.Transactions.TransactionStore"),
         context(context),
         connectorId(connectorId),
-        filesystem(filesystem) {
+        filesystem(filesystem),
+        transactions{makeVector<std::weak_ptr<Transaction>>(getMemoryTag())} {
 
 }
 
@@ -67,7 +69,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
         return nullptr;
     }
 
-    auto doc = FilesystemUtils::loadJson(filesystem, fn);
+    auto doc = FilesystemUtils::loadJson(filesystem, fn, getMemoryTag());
 
     if (!doc) {
         MO_DBG_ERR("memory corruption");
@@ -134,7 +136,7 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
         return false;
     }
     
-    DynamicJsonDocument txDoc {0};
+    auto txDoc = initJsonDoc(getMemoryTag());
     if (!serializeTransaction(*transaction, txDoc)) {
         MO_DBG_ERR("Serialization error");
         return false;
@@ -174,8 +176,9 @@ bool ConnectorTransactionStore::remove(unsigned int txNr) {
     return filesystem->remove(fn);
 }
 
-TransactionStore::TransactionStore(unsigned int nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) {
-    
+TransactionStore::TransactionStore(unsigned int nConnectors, std::shared_ptr<FilesystemAdapter> filesystem) :
+        MemoryManaged{"v16.Transactions.TransactionStore"}, connectors{makeVector<std::unique_ptr<ConnectorTransactionStore>>(getMemoryTag())} {
+
     for (unsigned int i = 0; i < nConnectors; i++) {
         connectors.push_back(std::unique_ptr<ConnectorTransactionStore>(
             new ConnectorTransactionStore(*this, i, filesystem)));
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.h b/src/MicroOcpp/Model/Transactions/TransactionStore.h
index 9f080dcd..7e4db699 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.h
@@ -5,24 +5,22 @@
 #ifndef MO_TRANSACTIONSTORE_H
 #define MO_TRANSACTIONSTORE_H
 
-#include <vector>
-#include <deque>
-
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
 class TransactionStore;
 
-class ConnectorTransactionStore {
+class ConnectorTransactionStore : public MemoryManaged {
 private:
     TransactionStore& context;
     const unsigned int connectorId;
 
     std::shared_ptr<FilesystemAdapter> filesystem;
     
-    std::deque<std::weak_ptr<Transaction>> transactions;
+    Vector<std::weak_ptr<Transaction>> transactions;
 
 public:
     ConnectorTransactionStore(TransactionStore& context, unsigned int connectorId, std::shared_ptr<FilesystemAdapter> filesystem);
@@ -40,9 +38,9 @@ class ConnectorTransactionStore {
     bool remove(unsigned int txNr);
 };
 
-class TransactionStore {
+class TransactionStore : public MemoryManaged {
 private:
-    std::vector<std::unique_ptr<ConnectorTransactionStore>> connectors;
+    Vector<std::unique_ptr<ConnectorTransactionStore>> connectors;
 public:
     TransactionStore(unsigned int nConnectors, std::shared_ptr<FilesystemAdapter> filesystem);
 
diff --git a/src/MicroOcpp/Model/Variables/Variable.cpp b/src/MicroOcpp/Model/Variables/Variable.cpp
index ac9b10c2..4f676d0f 100644
--- a/src/MicroOcpp/Model/Variables/Variable.cpp
+++ b/src/MicroOcpp/Model/Variables/Variable.cpp
@@ -82,6 +82,7 @@ Variable::~Variable() {
 
 void Variable::setName(const char *name) {
     this->variableName = name;
+    updateMemoryTag("v201.Variables.Variable.", name);
 }
 const char *Variable::getName() const {
     return variableName;
@@ -321,13 +322,13 @@ class VariableString : public Variable {
     }
 
     ~VariableString() {
-        delete[] value.get(AttributeType::Actual);
+        MO_FREE(value.get(AttributeType::Actual));
         value.get(AttributeType::Actual) = nullptr;
-        delete[] value.get(AttributeType::Target);
+        MO_FREE(value.get(AttributeType::Target));
         value.get(AttributeType::Target) = nullptr;
-        delete[] value.get(AttributeType::MinSet);
+        MO_FREE(value.get(AttributeType::MinSet));
         value.get(AttributeType::MinSet) = nullptr;
-        delete[] value.get(AttributeType::MaxSet);
+        MO_FREE(value.get(AttributeType::MaxSet));
         value.get(AttributeType::MaxSet) = nullptr;
     }
 
@@ -342,14 +343,15 @@ class VariableString : public Variable {
         size_t len = strlen(val);
         char *valNew = nullptr;
         if (len != 0) {
-            valNew = new char[len + 1];
+            size_t size = len + 1;
+            valNew = static_cast<char*>(MO_MALLOC(getMemoryTag(), size));
             if (!valNew) {
                 MO_DBG_ERR("OOM");
                 return false;
             }
-            memcpy(valNew, val, len + 1);
+            memcpy(valNew, val, size);
         }
-        delete[] value.get(attrType);
+        MO_FREE(value.get(attrType));
         value.get(attrType) = valNew;
         writeCount++;
         return true;
diff --git a/src/MicroOcpp/Model/Variables/Variable.h b/src/MicroOcpp/Model/Variables/Variable.h
index 274416ec..c64ffa46 100644
--- a/src/MicroOcpp/Model/Variables/Variable.h
+++ b/src/MicroOcpp/Model/Variables/Variable.h
@@ -14,11 +14,11 @@
 #if MO_ENABLE_V201
 
 #include <stdint.h>
-#include <vector>
 #include <memory>
 #include <limits>
 
 #include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+#include <MicroOcpp/Core/Memory.h>
 
 #ifndef MO_VARIABLE_TYPECHECK
 #define MO_VARIABLE_TYPECHECK 1
@@ -27,7 +27,7 @@
 namespace MicroOcpp {
 
 // VariableCharacteristicsType (2.51)
-struct VariableCharacteristics {
+struct VariableCharacteristics : public MemoryManaged {
 
     // DataEnumType (3.26)
     enum class DataType : uint8_t {
@@ -47,6 +47,8 @@ struct VariableCharacteristics {
     int maxLimit = std::numeric_limits<int>::max();
     const char *valuesList = nullptr; //no copy
     //bool supportsMonitoring; //stored in Variable
+
+    VariableCharacteristics() : MemoryManaged("v201.Variables.VariableCharacteristics") { }
 };
 
 // SetVariableStatusEnumType (3.79)
@@ -125,7 +127,7 @@ struct ComponentId {
  * the value of the variable. To make it use the host system's key-value store, extend this class
  * with a custom implementation of the virtual methods and pass its instances to MO.
  */
-class Variable {
+class Variable : public MemoryManaged {
 public:
     //AttributeEnumType (3.2)
     enum class AttributeType : uint8_t {
diff --git a/src/MicroOcpp/Model/Variables/VariableContainer.cpp b/src/MicroOcpp/Model/Variables/VariableContainer.cpp
index 6d229c9c..1b99396d 100644
--- a/src/MicroOcpp/Model/Variables/VariableContainer.cpp
+++ b/src/MicroOcpp/Model/Variables/VariableContainer.cpp
@@ -23,7 +23,7 @@ VariableContainer::~VariableContainer() {
 }
 
 VariableContainerVolatile::VariableContainerVolatile(const char *filename, bool accessible) :
-        VariableContainer(filename, accessible) {
+        VariableContainer(filename, accessible), MemoryManaged("v201.Variables.VariableContainerVolatile.", filename), variables(makeVector<std::unique_ptr<Variable>>(getMemoryTag())) {
 
 }
 
diff --git a/src/MicroOcpp/Model/Variables/VariableContainer.h b/src/MicroOcpp/Model/Variables/VariableContainer.h
index 90ee41c9..fe247abe 100644
--- a/src/MicroOcpp/Model/Variables/VariableContainer.h
+++ b/src/MicroOcpp/Model/Variables/VariableContainer.h
@@ -9,15 +9,15 @@
 #ifndef MO_VARIABLECONTAINER_H
 #define MO_VARIABLECONTAINER_H
 
-#include <vector>
-#include <memory>
-
-#include <MicroOcpp/Model/Variables/Variable.h>
-
 #include <MicroOcpp/Version.h>
 
 #if MO_ENABLE_V201
 
+#include <memory>
+
+#include <MicroOcpp/Model/Variables/Variable.h>
+#include <MicroOcpp/Core/Memory.h>
+
 namespace MicroOcpp {
 
 class VariableContainer {
@@ -53,9 +53,9 @@ class VariableContainer {
     virtual Variable *getVariable(const ComponentId& component, const char *variableName) const = 0;
 };
 
-class VariableContainerVolatile : public VariableContainer {
+class VariableContainerVolatile : public VariableContainer, public MemoryManaged {
 private:
-    std::vector<std::unique_ptr<Variable>> variables;
+    Vector<std::unique_ptr<Variable>> variables;
 public:
     VariableContainerVolatile(const char *filename, bool accessible);
     ~VariableContainerVolatile();
diff --git a/src/MicroOcpp/Model/Variables/VariableService.cpp b/src/MicroOcpp/Model/Variables/VariableService.cpp
index 267a8971..c196f805 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.cpp
+++ b/src/MicroOcpp/Model/Variables/VariableService.cpp
@@ -27,12 +27,12 @@ namespace MicroOcpp {
 
 template <class T>
 VariableValidator<T>::VariableValidator(const ComponentId& component, const char *name, std::function<bool(T)> validate) :
-        component(component), name(name), validate(validate) {
+        MemoryManaged("v201.Variables.VariableValidator.", name), component(component), name(name), validate(validate) {
 
 }
 
 template <class T>
-VariableValidator<T> *getVariableValidator(std::vector<VariableValidator<T>>& collection, const ComponentId& component, const char *name) {
+VariableValidator<T> *getVariableValidator(Vector<VariableValidator<T>>& collection, const ComponentId& component, const char *name) {
     for (auto& validator : collection) {
         if (!strcmp(name, validator.name) && component.equals(validator.component)) {
             return &validator;
@@ -80,7 +80,7 @@ std::shared_ptr<VariableContainer> VariableService::getContainer(const char *fil
 }
 
 template <class T>
-bool registerVariableValidator(std::vector<VariableValidator<T>>& collection, const ComponentId& component, const char *name, std::function<bool(T)> validate) {
+bool registerVariableValidator(Vector<VariableValidator<T>>& collection, const ComponentId& component, const char *name, std::function<bool(T)> validate) {
     for (auto it = collection.begin(); it != collection.end(); it++) {
         if (!strcmp(name, it->name) && component.equals(it->component)) {
             collection.erase(it);
@@ -148,7 +148,13 @@ Variable *VariableService::getVariable(Variable::InternalDataType type, const Co
     return nullptr;
 }
 
-VariableService::VariableService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : context(context), filesystem(filesystem) {
+VariableService::VariableService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) :
+            MemoryManaged("v201.Variables.VariableService"),
+            context(context), filesystem(filesystem),
+            containers(makeVector<std::shared_ptr<VariableContainer>>(getMemoryTag())),
+            validatorInt(makeVector<VariableValidator<int>>(getMemoryTag())),
+            validatorBool(makeVector<VariableValidator<bool>>(getMemoryTag())),
+            validatorString(makeVector<VariableValidator<const char*>>(getMemoryTag())) {
     context.getOperationRegistry().registerOperation("SetVariables", [this] () {
         return new Ocpp201::SetVariables(*this);});
     context.getOperationRegistry().registerOperation("GetVariables", [this] () {
@@ -438,7 +444,7 @@ GenericDeviceModelStatus VariableService::getBaseReport(int requestId, ReportBas
         return GenericDeviceModelStatus_NotSupported;
     }
 
-    std::vector<Variable*> variables;
+    Vector<Variable*> variables = makeVector<Variable*>(getMemoryTag());
 
     for (const auto& container : containers) {
         if (!container->isAccessible()) {
diff --git a/src/MicroOcpp/Model/Variables/VariableService.h b/src/MicroOcpp/Model/Variables/VariableService.h
index dfc4808c..0fff37d3 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.h
+++ b/src/MicroOcpp/Model/Variables/VariableService.h
@@ -10,7 +10,6 @@
 #define MO_VARIABLESERVICE_H
 
 #include <stdint.h>
-#include <vector>
 #include <memory>
 #include <limits>
 #include <functional>
@@ -22,6 +21,7 @@
 #include <MicroOcpp/Model/Variables/Variable.h>
 #include <MicroOcpp/Model/Variables/VariableContainer.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/Memory.h>
 
 #ifndef MO_VARIABLE_FN
 #define MO_VARIABLE_FN (MO_FILENAME_PREFIX "ocpp-vars.jsn")
@@ -38,7 +38,7 @@
 namespace MicroOcpp {
 
 template <class T>
-struct VariableValidator {
+struct VariableValidator : public MemoryManaged {
     ComponentId component;
     const char *name;
     std::function<bool(T)> validate;
@@ -47,15 +47,15 @@ struct VariableValidator {
 
 class Context;
 
-class VariableService {
+class VariableService : public MemoryManaged {
 private:
     Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
-    std::vector<std::shared_ptr<VariableContainer>> containers;
+    Vector<std::shared_ptr<VariableContainer>> containers;
 
-    std::vector<VariableValidator<int>> validatorInt;
-    std::vector<VariableValidator<bool>> validatorBool;
-    std::vector<VariableValidator<const char*>> validatorString;
+    Vector<VariableValidator<int>> validatorInt;
+    Vector<VariableValidator<bool>> validatorBool;
+    Vector<VariableValidator<const char*>> validatorString;
 
     VariableValidator<int> *getValidatorInt(const ComponentId& component, const char *name);
     VariableValidator<bool> *getValidatorBool(const ComponentId& component, const char *name);
diff --git a/src/MicroOcpp/Operations/Authorize.cpp b/src/MicroOcpp/Operations/Authorize.cpp
index f3688913..e12050be 100644
--- a/src/MicroOcpp/Operations/Authorize.cpp
+++ b/src/MicroOcpp/Operations/Authorize.cpp
@@ -13,7 +13,7 @@ using namespace MicroOcpp;
 namespace MicroOcpp {
 namespace Ocpp16 {
 
-Authorize::Authorize(Model& model, const char *idTagIn) : model(model) {
+Authorize::Authorize(Model& model, const char *idTagIn) : MemoryManaged("v16.Operation.", "Authorize"), model(model) {
     if (idTagIn && strnlen(idTagIn, IDTAG_LEN_MAX + 2) <= IDTAG_LEN_MAX) {
         snprintf(idTag, IDTAG_LEN_MAX + 1, "%s", idTagIn);
     } else {
@@ -25,8 +25,8 @@ const char* Authorize::getOperationType(){
     return "Authorize";
 }
 
-std::unique_ptr<DynamicJsonDocument> Authorize::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + (IDTAG_LEN_MAX + 1)));
+std::unique_ptr<JsonDoc> Authorize::createReq() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1) + (IDTAG_LEN_MAX + 1));
     JsonObject payload = doc->to<JsonObject>();
     payload["idTag"] = idTag;
     return doc;
@@ -54,8 +54,8 @@ void Authorize::processReq(JsonObject payload){
      */
 }
 
-std::unique_ptr<DynamicJsonDocument> Authorize::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> Authorize::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), 2 * JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
     idTagInfo["status"] = "Accepted";
@@ -70,7 +70,7 @@ std::unique_ptr<DynamicJsonDocument> Authorize::createConf(){
 namespace MicroOcpp {
 namespace Ocpp201 {
 
-Authorize::Authorize(Model& model, const IdToken& idToken) : model(model) {
+Authorize::Authorize(Model& model, const IdToken& idToken) : MemoryManaged("v201.Operation.Authorize"), model(model) {
     this->idToken = idToken;
 }
 
@@ -78,10 +78,10 @@ const char* Authorize::getOperationType(){
     return "Authorize";
 }
 
-std::unique_ptr<DynamicJsonDocument> Authorize::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+std::unique_ptr<JsonDoc> Authorize::createReq() {
+    auto doc = makeJsonDoc(getMemoryTag(),
             JSON_OBJECT_SIZE(1) +
-            JSON_OBJECT_SIZE(2)));
+            JSON_OBJECT_SIZE(2));
     JsonObject payload = doc->to<JsonObject>();
     payload["idToken"]["idToken"] = idToken.get();
     payload["idToken"]["type"] = idToken.getTypeCstr();
@@ -108,8 +108,8 @@ void Authorize::processReq(JsonObject payload){
      */
 }
 
-std::unique_ptr<DynamicJsonDocument> Authorize::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> Authorize::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), 2 * JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     JsonObject idTagInfo = payload.createNestedObject("idTokenInfo");
     idTagInfo["status"] = "Accepted";
diff --git a/src/MicroOcpp/Operations/Authorize.h b/src/MicroOcpp/Operations/Authorize.h
index 0bd9f2eb..b49226ef 100644
--- a/src/MicroOcpp/Operations/Authorize.h
+++ b/src/MicroOcpp/Operations/Authorize.h
@@ -15,7 +15,7 @@ class Model;
 
 namespace Ocpp16 {
 
-class Authorize : public Operation {
+class Authorize : public Operation, public MemoryManaged {
 private:
     Model& model;
     char idTag [IDTAG_LEN_MAX + 1] = {'\0'};
@@ -24,13 +24,13 @@ class Authorize : public Operation {
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
 };
 
@@ -44,7 +44,7 @@ class Authorize : public Operation {
 namespace MicroOcpp {
 namespace Ocpp201 {
 
-class Authorize : public Operation {
+class Authorize : public Operation, public MemoryManaged {
 private:
     Model& model;
     IdToken idToken;
@@ -53,13 +53,13 @@ class Authorize : public Operation {
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
 };
 
diff --git a/src/MicroOcpp/Operations/BootNotification.cpp b/src/MicroOcpp/Operations/BootNotification.cpp
index e0236b0a..1f4b7c77 100644
--- a/src/MicroOcpp/Operations/BootNotification.cpp
+++ b/src/MicroOcpp/Operations/BootNotification.cpp
@@ -12,8 +12,9 @@
 #include <string.h>
 
 using MicroOcpp::Ocpp16::BootNotification;
+using MicroOcpp::JsonDoc;
 
-BootNotification::BootNotification(Model& model, std::unique_ptr<DynamicJsonDocument> payload) : model(model), credentials(std::move(payload)) {
+BootNotification::BootNotification(Model& model, std::unique_ptr<JsonDoc> payload) : MemoryManaged("v16.Operation.", "BootNotification"), model(model), credentials(std::move(payload)) {
     
 }
 
@@ -21,18 +22,18 @@ const char* BootNotification::getOperationType(){
     return "BootNotification";
 }
 
-std::unique_ptr<DynamicJsonDocument> BootNotification::createReq() {
+std::unique_ptr<JsonDoc> BootNotification::createReq() {
     if (credentials) {
 #if MO_ENABLE_V201
         if (model.getVersion().major == 2) {
-            std::unique_ptr<DynamicJsonDocument> doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2) + credentials->memoryUsage()));
+            auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(2) + credentials->memoryUsage());
             JsonObject payload = doc->to<JsonObject>();
             payload["reason"] = "PowerUp";
             payload["chargingStation"] = *credentials;
             return doc;
         }
 #endif
-        return std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(*credentials));
+        return std::unique_ptr<JsonDoc>(new JsonDoc(*credentials));
     } else {
         MO_DBG_ERR("payload undefined");
         return createEmptyDocument();
@@ -99,8 +100,8 @@ void BootNotification::processReq(JsonObject payload){
      */
 }
 
-std::unique_ptr<DynamicJsonDocument> BootNotification::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(3) + (JSONDATE_LENGTH + 1)));
+std::unique_ptr<JsonDoc> BootNotification::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(3) + (JSONDATE_LENGTH + 1));
     JsonObject payload = doc->to<JsonObject>();
 
     //safety mechanism; in some test setups the library has to answer BootNotifications without valid system time
diff --git a/src/MicroOcpp/Operations/BootNotification.h b/src/MicroOcpp/Operations/BootNotification.h
index cc783fd4..c560e03f 100644
--- a/src/MicroOcpp/Operations/BootNotification.h
+++ b/src/MicroOcpp/Operations/BootNotification.h
@@ -19,25 +19,25 @@ class Model;
 
 namespace Ocpp16 {
 
-class BootNotification : public Operation {
+class BootNotification : public Operation, public MemoryManaged {
 private:
     Model& model;
-    std::unique_ptr<DynamicJsonDocument> credentials;
+    std::unique_ptr<JsonDoc> credentials;
     const char *errorCode = nullptr;
 public:
-    BootNotification(Model& model, std::unique_ptr<DynamicJsonDocument> payload);
+    BootNotification(Model& model, std::unique_ptr<JsonDoc> payload);
 
     ~BootNotification() = default;
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/CancelReservation.cpp b/src/MicroOcpp/Operations/CancelReservation.cpp
index b0a6206a..7741d9b9 100644
--- a/src/MicroOcpp/Operations/CancelReservation.cpp
+++ b/src/MicroOcpp/Operations/CancelReservation.cpp
@@ -11,12 +11,13 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::CancelReservation;
+using MicroOcpp::JsonDoc;
 
-CancelReservation::CancelReservation(ReservationService& reservationService) : reservationService(reservationService) {
+CancelReservation::CancelReservation(ReservationService& reservationService) : MemoryManaged("v16.Operation.", "CancelReservation"), reservationService(reservationService) {
   
 }
 
-const char* CancelReservation::getOperationType(){
+const char* CancelReservation::getOperationType() {
     return "CancelReservation";
 }
 
@@ -32,8 +33,8 @@ void CancelReservation::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> CancelReservation::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> CancelReservation::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     if (found) {
         payload["status"] = "Accepted";
diff --git a/src/MicroOcpp/Operations/CancelReservation.h b/src/MicroOcpp/Operations/CancelReservation.h
index 4a8dec1f..0e39bb60 100644
--- a/src/MicroOcpp/Operations/CancelReservation.h
+++ b/src/MicroOcpp/Operations/CancelReservation.h
@@ -17,7 +17,7 @@ class ReservationService;
 
 namespace Ocpp16 {
 
-class CancelReservation : public Operation {
+class CancelReservation : public Operation, public MemoryManaged {
 private:
     ReservationService& reservationService;
     bool found = false;
@@ -29,7 +29,7 @@ class CancelReservation : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.cpp b/src/MicroOcpp/Operations/ChangeAvailability.cpp
index 517bdabb..b0bd2da3 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.cpp
+++ b/src/MicroOcpp/Operations/ChangeAvailability.cpp
@@ -10,8 +10,9 @@
 #include <functional>
 
 using MicroOcpp::Ocpp16::ChangeAvailability;
+using MicroOcpp::JsonDoc;
 
-ChangeAvailability::ChangeAvailability(Model& model) : model(model) {
+ChangeAvailability::ChangeAvailability(Model& model) : MemoryManaged("v16.Operation.", "ChangeAvailability"), model(model) {
 
 }
 
@@ -84,8 +85,8 @@ void ChangeAvailability::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> ChangeAvailability::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> ChangeAvailability::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     if (!accepted) {
         payload["status"] = "Rejected";
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.h b/src/MicroOcpp/Operations/ChangeAvailability.h
index 4e7e58af..2830d791 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.h
+++ b/src/MicroOcpp/Operations/ChangeAvailability.h
@@ -13,7 +13,7 @@ class Model;
 
 namespace Ocpp16 {
 
-class ChangeAvailability : public Operation {
+class ChangeAvailability : public Operation, public MemoryManaged {
 private:
     Model& model;
     bool scheduled = false;
@@ -27,7 +27,7 @@ class ChangeAvailability : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
index 66e29fed..15227ca2 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
@@ -9,8 +9,9 @@
 #include <cctype> //for tolower
 
 using MicroOcpp::Ocpp16::ChangeConfiguration;
+using MicroOcpp::JsonDoc;
 
-ChangeConfiguration::ChangeConfiguration() {
+ChangeConfiguration::ChangeConfiguration() : MemoryManaged("v16.Operation.", "ChangeConfiguration") {
   
 }
 
@@ -141,8 +142,8 @@ void ChangeConfiguration::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> ChangeConfiguration::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> ChangeConfiguration::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     if (notSupported) {
         payload["status"] = "NotSupported";
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.h b/src/MicroOcpp/Operations/ChangeConfiguration.h
index 1f98a65e..3699cf6d 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.h
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.h
@@ -10,7 +10,7 @@
 namespace MicroOcpp {
 namespace Ocpp16 {
 
-class ChangeConfiguration : public Operation {
+class ChangeConfiguration : public Operation, public MemoryManaged {
 private:
     bool reject = false;
     bool rebootRequired = false;
@@ -25,7 +25,7 @@ class ChangeConfiguration : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 
diff --git a/src/MicroOcpp/Operations/ClearCache.cpp b/src/MicroOcpp/Operations/ClearCache.cpp
index c5e122aa..6666ae51 100644
--- a/src/MicroOcpp/Operations/ClearCache.cpp
+++ b/src/MicroOcpp/Operations/ClearCache.cpp
@@ -7,8 +7,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::ClearCache;
+using MicroOcpp::JsonDoc;
 
-ClearCache::ClearCache(std::shared_ptr<FilesystemAdapter> filesystem) : filesystem(filesystem) {
+ClearCache::ClearCache(std::shared_ptr<FilesystemAdapter> filesystem) : MemoryManaged("v16.Operation.", "ClearCache"), filesystem(filesystem) {
   
 }
 
@@ -31,8 +32,8 @@ void ClearCache::processReq(JsonObject payload) {
     });
 }
 
-std::unique_ptr<DynamicJsonDocument> ClearCache::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> ClearCache::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     if (success) {
         payload["status"] = "Accepted"; //"Accepted", because the intended postcondition is true
diff --git a/src/MicroOcpp/Operations/ClearCache.h b/src/MicroOcpp/Operations/ClearCache.h
index 0dc06d58..110ab14a 100644
--- a/src/MicroOcpp/Operations/ClearCache.h
+++ b/src/MicroOcpp/Operations/ClearCache.h
@@ -11,7 +11,7 @@
 namespace MicroOcpp {
 namespace Ocpp16 {
 
-class ClearCache : public Operation {
+class ClearCache : public Operation, public MemoryManaged {
 private:
     std::shared_ptr<FilesystemAdapter> filesystem;
     bool success = true;
@@ -22,7 +22,7 @@ class ClearCache : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/ClearChargingProfile.cpp b/src/MicroOcpp/Operations/ClearChargingProfile.cpp
index 24b92379..e99f9bd7 100644
--- a/src/MicroOcpp/Operations/ClearChargingProfile.cpp
+++ b/src/MicroOcpp/Operations/ClearChargingProfile.cpp
@@ -9,8 +9,9 @@
 #include <functional>
 
 using MicroOcpp::Ocpp16::ClearChargingProfile;
+using MicroOcpp::JsonDoc;
 
-ClearChargingProfile::ClearChargingProfile(SmartChargingService& scService) : scService(scService) {
+ClearChargingProfile::ClearChargingProfile(SmartChargingService& scService) : MemoryManaged("v16.Operation.", "ClearChargingProfile"), scService(scService) {
 
 }
 
@@ -69,8 +70,8 @@ void ClearChargingProfile::processReq(JsonObject payload) {
     matchingProfilesFound = scService.clearChargingProfile(filter);
 }
 
-std::unique_ptr<DynamicJsonDocument> ClearChargingProfile::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> ClearChargingProfile::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     if (matchingProfilesFound)
         payload["status"] = "Accepted";
diff --git a/src/MicroOcpp/Operations/ClearChargingProfile.h b/src/MicroOcpp/Operations/ClearChargingProfile.h
index 535571f8..40b7d210 100644
--- a/src/MicroOcpp/Operations/ClearChargingProfile.h
+++ b/src/MicroOcpp/Operations/ClearChargingProfile.h
@@ -13,7 +13,7 @@ class SmartChargingService;
 
 namespace Ocpp16 {
 
-class ClearChargingProfile : public Operation {
+class ClearChargingProfile : public Operation, public MemoryManaged {
 private:
     SmartChargingService& scService;
     bool matchingProfilesFound = false;
@@ -24,7 +24,7 @@ class ClearChargingProfile : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
     
 };
 
diff --git a/src/MicroOcpp/Operations/CustomOperation.cpp b/src/MicroOcpp/Operations/CustomOperation.cpp
index ddd5ab32..78643d43 100644
--- a/src/MicroOcpp/Operations/CustomOperation.cpp
+++ b/src/MicroOcpp/Operations/CustomOperation.cpp
@@ -5,12 +5,14 @@
 #include <MicroOcpp/Operations/CustomOperation.h>
 
 using MicroOcpp::Ocpp16::CustomOperation;
+using MicroOcpp::JsonDoc;
 
 CustomOperation::CustomOperation(const char *operationType,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
+            std::function<std::unique_ptr<JsonDoc> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf,
             std::function<bool (const char*, const char*, JsonObject)> fn_processErr) :
-        operationType{operationType},
+        MemoryManaged("v16.Operation.", operationType),
+        operationType{makeString(getMemoryTag(), operationType)},
         fn_createReq{fn_createReq},
         fn_processConf{fn_processConf},
         fn_processErr{fn_processErr} {
@@ -19,11 +21,12 @@ CustomOperation::CustomOperation(const char *operationType,
 
 CustomOperation::CustomOperation(const char *operationType,
             std::function<void (JsonObject)> fn_processReq,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf,
+            std::function<std::unique_ptr<JsonDoc> ()> fn_createConf,
             std::function<const char* ()> fn_getErrorCode,
             std::function<const char* ()> fn_getErrorDescription,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_getErrorDetails) :
-        operationType{operationType},
+            std::function<std::unique_ptr<JsonDoc> ()> fn_getErrorDetails) :
+        MemoryManaged("v16.Operation.", operationType),
+        operationType{makeString(getMemoryTag(), operationType)},
         fn_processReq{fn_processReq},
         fn_createConf{fn_createConf},
         fn_getErrorCode{fn_getErrorCode},
@@ -40,7 +43,7 @@ const char* CustomOperation::getOperationType() {
     return operationType.c_str();
 }
 
-std::unique_ptr<DynamicJsonDocument> CustomOperation::createReq() {
+std::unique_ptr<JsonDoc> CustomOperation::createReq() {
     return fn_createReq();
 }
 
@@ -59,7 +62,7 @@ void CustomOperation::processReq(JsonObject payload) {
     return fn_processReq(payload);
 }
 
-std::unique_ptr<DynamicJsonDocument> CustomOperation::createConf() {
+std::unique_ptr<JsonDoc> CustomOperation::createConf() {
     return fn_createConf();
 }
 
@@ -79,7 +82,7 @@ const char *CustomOperation::getErrorDescription() {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> CustomOperation::getErrorDetails() {
+std::unique_ptr<JsonDoc> CustomOperation::getErrorDetails() {
     if (fn_getErrorDetails) {
         return fn_getErrorDetails();
     } else {
diff --git a/src/MicroOcpp/Operations/CustomOperation.h b/src/MicroOcpp/Operations/CustomOperation.h
index 88193fc8..02f72e88 100644
--- a/src/MicroOcpp/Operations/CustomOperation.h
+++ b/src/MicroOcpp/Operations/CustomOperation.h
@@ -13,38 +13,38 @@ namespace MicroOcpp {
 
 namespace Ocpp16 {
 
-class CustomOperation : public Operation {
+class CustomOperation : public Operation, public MemoryManaged {
 private:
-    std::string operationType;
-    std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq;
+    String operationType;
+    std::function<std::unique_ptr<JsonDoc> ()> fn_createReq;
     std::function<void (JsonObject)> fn_processConf;
     std::function<bool (const char*, const char*, JsonObject)> fn_processErr;  //optional
     std::function<void (JsonObject)> fn_processReq;
-    std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf;
+    std::function<std::unique_ptr<JsonDoc> ()> fn_createConf;
     std::function<const char* ()> fn_getErrorCode;            //optional
     std::function<const char* ()> fn_getErrorDescription;     //optional
-    std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_getErrorDetails; //optional
+    std::function<std::unique_ptr<JsonDoc> ()> fn_getErrorDetails; //optional
 public:
 
     //for operations initiated at this device
     CustomOperation(const char *operationType,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createReq,
+            std::function<std::unique_ptr<JsonDoc> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf,
             std::function<bool (const char*, const char*, JsonObject)> fn_processErr = nullptr);
     
     //for operations receied from remote
     CustomOperation(const char *operationType,
             std::function<void (JsonObject)> fn_processReq,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_createConf,
+            std::function<std::unique_ptr<JsonDoc> ()> fn_createConf,
             std::function<const char* ()> fn_getErrorCode = nullptr,
             std::function<const char* ()> fn_getErrorDescription = nullptr,
-            std::function<std::unique_ptr<DynamicJsonDocument> ()> fn_getErrorDetails = nullptr);
+            std::function<std::unique_ptr<JsonDoc> ()> fn_getErrorDetails = nullptr);
     
     ~CustomOperation();
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
@@ -52,10 +52,10 @@ class CustomOperation : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
     const char *getErrorCode() override;
     const char *getErrorDescription() override;
-    std::unique_ptr<DynamicJsonDocument> getErrorDetails() override;
+    std::unique_ptr<JsonDoc> getErrorDetails() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/DataTransfer.cpp b/src/MicroOcpp/Operations/DataTransfer.cpp
index 6535bfc5..5c605039 100644
--- a/src/MicroOcpp/Operations/DataTransfer.cpp
+++ b/src/MicroOcpp/Operations/DataTransfer.cpp
@@ -6,17 +6,22 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::DataTransfer;
+using MicroOcpp::JsonDoc;
+
+DataTransfer::DataTransfer() : MemoryManaged("v16.Operation.", "DataTransfer") {
+
+}
+
+DataTransfer::DataTransfer(const String &msg) : MemoryManaged("v16.Operation.", "DataTransfer"), msg{makeString(getMemoryTag(), msg.c_str())} {
 
-DataTransfer::DataTransfer(const std::string &msg) {
-    this->msg = msg;
 }
 
 const char* DataTransfer::getOperationType(){
     return "DataTransfer";
 }
 
-std::unique_ptr<DynamicJsonDocument> DataTransfer::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2) + (msg.length() + 1)));
+std::unique_ptr<JsonDoc> DataTransfer::createReq() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(2) + (msg.length() + 1));
     JsonObject payload = doc->to<JsonObject>();
     payload["vendorId"] = "CustomVendor";
     payload["data"] = msg;
@@ -24,9 +29,9 @@ std::unique_ptr<DynamicJsonDocument> DataTransfer::createReq() {
 }
 
 void DataTransfer::processConf(JsonObject payload){
-    std::string status = payload["status"] | "Invalid";
+    const char *status = payload["status"] | "Invalid";
 
-    if (status == "Accepted") {
+    if (!strcmp(status, "Accepted")) {
         MO_DBG_DEBUG("Request has been accepted");
     } else {
         MO_DBG_INFO("Request has been denied");
@@ -37,8 +42,8 @@ void DataTransfer::processReq(JsonObject payload) {
     // Do nothing - we're just required to reject these DataTransfer requests
 }
 
-std::unique_ptr<DynamicJsonDocument> DataTransfer::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> DataTransfer::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = "Rejected";
     return doc;
diff --git a/src/MicroOcpp/Operations/DataTransfer.h b/src/MicroOcpp/Operations/DataTransfer.h
index 76588d27..f7967202 100644
--- a/src/MicroOcpp/Operations/DataTransfer.h
+++ b/src/MicroOcpp/Operations/DataTransfer.h
@@ -10,22 +10,22 @@
 namespace MicroOcpp {
 namespace Ocpp16 {
 
-class DataTransfer : public Operation {
+class DataTransfer : public Operation, public MemoryManaged {
 private:
-    std::string msg {};
+    String msg;
 public:
-    DataTransfer() {};
-    DataTransfer(const std::string &msg);
+    DataTransfer();
+    DataTransfer(const String &msg);
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
     
 };
 
diff --git a/src/MicroOcpp/Operations/DeleteCertificate.cpp b/src/MicroOcpp/Operations/DeleteCertificate.cpp
index 9bf42d39..b7a7267a 100644
--- a/src/MicroOcpp/Operations/DeleteCertificate.cpp
+++ b/src/MicroOcpp/Operations/DeleteCertificate.cpp
@@ -11,8 +11,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp201::DeleteCertificate;
+using MicroOcpp::JsonDoc;
 
-DeleteCertificate::DeleteCertificate(CertificateService& certService) : certService(certService) {
+DeleteCertificate::DeleteCertificate(CertificateService& certService) : MemoryManaged("v201.Operation.", "DeleteCertificate"), certService(certService) {
 
 }
 
@@ -85,8 +86,8 @@ void DeleteCertificate::processReq(JsonObject payload) {
     //operation executed successfully
 }
 
-std::unique_ptr<DynamicJsonDocument> DeleteCertificate::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> DeleteCertificate::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = status;
     return doc;
diff --git a/src/MicroOcpp/Operations/DeleteCertificate.h b/src/MicroOcpp/Operations/DeleteCertificate.h
index bf5bf616..4c07014b 100644
--- a/src/MicroOcpp/Operations/DeleteCertificate.h
+++ b/src/MicroOcpp/Operations/DeleteCertificate.h
@@ -17,7 +17,7 @@ class CertificateService;
 
 namespace Ocpp201 {
 
-class DeleteCertificate : public Operation {
+class DeleteCertificate : public Operation, public MemoryManaged {
 private:
     CertificateService& certService;
     const char *status = nullptr;
@@ -29,7 +29,7 @@ class DeleteCertificate : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
index 6eaa3d94..8fc99913 100644
--- a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
+++ b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.cpp
@@ -8,8 +8,9 @@
 #include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
 
 using MicroOcpp::Ocpp16::DiagnosticsStatusNotification;
+using MicroOcpp::JsonDoc;
 
-DiagnosticsStatusNotification::DiagnosticsStatusNotification(DiagnosticsStatus status) : status(status) {
+DiagnosticsStatusNotification::DiagnosticsStatusNotification(DiagnosticsStatus status) : MemoryManaged("v16.Operation.", "DiagnosticsStatusNotification"), status(status) {
     
 }
 
@@ -31,8 +32,8 @@ const char *DiagnosticsStatusNotification::cstrFromStatus(DiagnosticsStatus stat
     return nullptr; //cannot be reached
 }
 
-std::unique_ptr<DynamicJsonDocument> DiagnosticsStatusNotification::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> DiagnosticsStatusNotification::createReq() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = cstrFromStatus(status);
     return doc;
diff --git a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
index 18f346a5..e21c8c07 100644
--- a/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
+++ b/src/MicroOcpp/Operations/DiagnosticsStatusNotification.h
@@ -11,7 +11,7 @@
 namespace MicroOcpp {
 namespace Ocpp16 {
 
-class DiagnosticsStatusNotification : public Operation {
+class DiagnosticsStatusNotification : public Operation, public MemoryManaged {
 private:
     DiagnosticsStatus status = DiagnosticsStatus::Idle;
     static const char *cstrFromStatus(DiagnosticsStatus status);
@@ -20,7 +20,7 @@ class DiagnosticsStatusNotification : public Operation {
 
     const char* getOperationType() override {return "DiagnosticsStatusNotification"; }
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
diff --git a/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp b/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
index b3f0a5dd..0b52c56f 100644
--- a/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
+++ b/src/MicroOcpp/Operations/FirmwareStatusNotification.cpp
@@ -8,8 +8,9 @@
 #include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
 
 using MicroOcpp::Ocpp16::FirmwareStatusNotification;
+using MicroOcpp::JsonDoc;
 
-FirmwareStatusNotification::FirmwareStatusNotification(FirmwareStatus status) : status{status} {
+FirmwareStatusNotification::FirmwareStatusNotification(FirmwareStatus status) : MemoryManaged("v16.Operation.", "FirmwareStatusNotification"), status{status} {
 
 }
 
@@ -40,8 +41,8 @@ const char *FirmwareStatusNotification::cstrFromFwStatus(FirmwareStatus status)
     return NULL; //cannot be reached
 }
 
-std::unique_ptr<DynamicJsonDocument> FirmwareStatusNotification::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> FirmwareStatusNotification::createReq() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = cstrFromFwStatus(status);
     return doc;
diff --git a/src/MicroOcpp/Operations/FirmwareStatusNotification.h b/src/MicroOcpp/Operations/FirmwareStatusNotification.h
index 632d2bfa..026ea45b 100644
--- a/src/MicroOcpp/Operations/FirmwareStatusNotification.h
+++ b/src/MicroOcpp/Operations/FirmwareStatusNotification.h
@@ -12,7 +12,7 @@
 namespace MicroOcpp {
 namespace Ocpp16 {
 
-class FirmwareStatusNotification : public Operation {
+class FirmwareStatusNotification : public Operation, public MemoryManaged {
 private:
     FirmwareStatus status = FirmwareStatus::Idle;
     static const char *cstrFromFwStatus(FirmwareStatus status);
@@ -21,7 +21,7 @@ class FirmwareStatusNotification : public Operation {
 
     const char* getOperationType() override {return "FirmwareStatusNotification"; }
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
diff --git a/src/MicroOcpp/Operations/GetBaseReport.cpp b/src/MicroOcpp/Operations/GetBaseReport.cpp
index 3f3ab807..95414481 100644
--- a/src/MicroOcpp/Operations/GetBaseReport.cpp
+++ b/src/MicroOcpp/Operations/GetBaseReport.cpp
@@ -11,8 +11,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp201::GetBaseReport;
+using MicroOcpp::JsonDoc;
 
-GetBaseReport::GetBaseReport(VariableService& variableService) : variableService(variableService) {
+GetBaseReport::GetBaseReport(VariableService& variableService) : MemoryManaged("v201.Operation.", "GetBaseReport"), variableService(variableService) {
   
 }
 
@@ -47,9 +48,9 @@ void GetBaseReport::processReq(JsonObject payload) {
     status = variableService.getBaseReport(requestId, reportBase);
 }
 
-std::unique_ptr<DynamicJsonDocument> GetBaseReport::createConf(){
+std::unique_ptr<JsonDoc> GetBaseReport::createConf(){
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
 
     const char *statusCstr = "";
diff --git a/src/MicroOcpp/Operations/GetBaseReport.h b/src/MicroOcpp/Operations/GetBaseReport.h
index 2eb85ab2..f23b7e81 100644
--- a/src/MicroOcpp/Operations/GetBaseReport.h
+++ b/src/MicroOcpp/Operations/GetBaseReport.h
@@ -9,9 +9,8 @@
 
 #if MO_ENABLE_V201
 
-#include <string>
-
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Model/Variables/Variable.h>
 
 namespace MicroOcpp {
@@ -20,7 +19,7 @@ class VariableService;
 
 namespace Ocpp201 {
 
-class GetBaseReport : public Operation {
+class GetBaseReport : public Operation, public MemoryManaged {
 private:
     VariableService& variableService;
 
@@ -34,7 +33,7 @@ class GetBaseReport : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 
diff --git a/src/MicroOcpp/Operations/GetCompositeSchedule.cpp b/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
index 54958f36..760e0e2f 100644
--- a/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
+++ b/src/MicroOcpp/Operations/GetCompositeSchedule.cpp
@@ -8,8 +8,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::GetCompositeSchedule;
+using MicroOcpp::JsonDoc;
 
-GetCompositeSchedule::GetCompositeSchedule(Model& model, SmartChargingService& scService) : model(model), scService(scService) {
+GetCompositeSchedule::GetCompositeSchedule(Model& model, SmartChargingService& scService) : MemoryManaged("v16.Operation.", "GetCompositeSchedule"), model(model), scService(scService) {
 
 }
 
@@ -40,12 +41,12 @@ void GetCompositeSchedule::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
+std::unique_ptr<JsonDoc> GetCompositeSchedule::createConf(){
 
     bool success = false;
 
     auto chargingSchedule = scService.getCompositeSchedule((unsigned int) connectorId, duration, chargingRateUnit);
-    DynamicJsonDocument chargingScheduleDoc {0};
+    JsonDoc chargingScheduleDoc {0};
 
     if (chargingSchedule) {
         success = chargingSchedule->toJson(chargingScheduleDoc);
@@ -58,9 +59,9 @@ std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
     }
 
     if (success && chargingSchedule) {
-        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+        auto doc = makeJsonDoc(getMemoryTag(),
                         JSON_OBJECT_SIZE(4) +
-                        chargingScheduleDoc.memoryUsage()));
+                        chargingScheduleDoc.memoryUsage());
         JsonObject payload = doc->to<JsonObject>();
         payload["status"] = "Accepted";
         payload["connectorId"] = connectorId;
@@ -68,7 +69,7 @@ std::unique_ptr<DynamicJsonDocument> GetCompositeSchedule::createConf(){
         payload["chargingSchedule"] = chargingScheduleDoc;
         return doc;
     } else {
-        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+        auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
         JsonObject payload = doc->to<JsonObject>();
         payload["status"] = "Rejected";
         return doc;
diff --git a/src/MicroOcpp/Operations/GetCompositeSchedule.h b/src/MicroOcpp/Operations/GetCompositeSchedule.h
index 800c8f33..30e427c4 100644
--- a/src/MicroOcpp/Operations/GetCompositeSchedule.h
+++ b/src/MicroOcpp/Operations/GetCompositeSchedule.h
@@ -15,7 +15,7 @@ class Model;
 
 namespace Ocpp16 {
 
-class GetCompositeSchedule : public Operation {
+class GetCompositeSchedule : public Operation, public MemoryManaged {
 private:
     Model& model;
     SmartChargingService& scService;
@@ -31,7 +31,7 @@ class GetCompositeSchedule : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index be08e9dd..1ba7ef0a 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -7,8 +7,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::GetConfiguration;
+using MicroOcpp::JsonDoc;
 
-GetConfiguration::GetConfiguration() {
+GetConfiguration::GetConfiguration() : MemoryManaged("v16.Operation.", "GetConfiguration"), keys{makeVector<String>(getMemoryTag())} {
 
 }
 
@@ -20,14 +21,14 @@ void GetConfiguration::processReq(JsonObject payload) {
 
     JsonArray requestedKeys = payload["key"];
     for (size_t i = 0; i < requestedKeys.size(); i++) {
-        keys.push_back(requestedKeys[i].as<std::string>());
+        keys.push_back(makeString(getMemoryTag(), requestedKeys[i].as<const char*>()));
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
+std::unique_ptr<JsonDoc> GetConfiguration::createConf(){
 
-    std::vector<Configuration*> configurations;
-    std::vector<const char*> unknownKeys;
+    Vector<Configuration*> configurations = makeVector<Configuration*>(getMemoryTag());
+    Vector<const char*> unknownKeys = makeVector<const char*>(getMemoryTag());
 
     auto containers = getConfigurationContainersPublic();
 
@@ -82,10 +83,10 @@ std::unique_ptr<DynamicJsonDocument> GetConfiguration::createConf(){
     
     MO_DBG_DEBUG("GetConfiguration capacity: %zu", jcapacity);
 
-    std::unique_ptr<DynamicJsonDocument> doc;
+    std::unique_ptr<JsonDoc> doc;
 
     if (jcapacity <= MO_MAX_JSON_CAPACITY) {
-        doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(jcapacity));
+        doc = makeJsonDoc(getMemoryTag(), jcapacity);
     }
 
     if (!doc || doc->capacity() < jcapacity) {
diff --git a/src/MicroOcpp/Operations/GetConfiguration.h b/src/MicroOcpp/Operations/GetConfiguration.h
index 94fb5d06..c6781119 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.h
+++ b/src/MicroOcpp/Operations/GetConfiguration.h
@@ -6,15 +6,14 @@
 #define MO_GETCONFIGURATION_H
 
 #include <MicroOcpp/Core/Operation.h>
-
-#include <vector>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 namespace Ocpp16 {
 
-class GetConfiguration : public Operation {
+class GetConfiguration : public Operation, public MemoryManaged {
 private:
-    std::vector<std::string> keys;
+    Vector<String> keys;
 
     const char *errorCode {nullptr};
     const char *errorDescription = "";
@@ -25,7 +24,7 @@ class GetConfiguration : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
     const char *getErrorDescription() override {return errorDescription;}
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.cpp b/src/MicroOcpp/Operations/GetDiagnostics.cpp
index 93aec8a7..e3bab7eb 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.cpp
+++ b/src/MicroOcpp/Operations/GetDiagnostics.cpp
@@ -8,8 +8,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::GetDiagnostics;
+using MicroOcpp::JsonDoc;
 
-GetDiagnostics::GetDiagnostics(DiagnosticsService& diagService) : diagService(diagService) {
+GetDiagnostics::GetDiagnostics(DiagnosticsService& diagService) : MemoryManaged("v16.Operation.", "GetDiagnostics"), diagService(diagService), fileName(makeString(getMemoryTag())) {
 
 }
 
@@ -50,13 +51,13 @@ void GetDiagnostics::processReq(JsonObject payload) {
     fileName = diagService.requestDiagnosticsUpload(location, (unsigned int) retries, (unsigned int) retryInterval, startTime, stopTime);
 }
 
-std::unique_ptr<DynamicJsonDocument> GetDiagnostics::createConf(){
+std::unique_ptr<JsonDoc> GetDiagnostics::createConf(){
     if (fileName.empty()) {
         return createEmptyDocument();
     } else {
-        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + fileName.length() + 1));
+        auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
         JsonObject payload = doc->to<JsonObject>();
-        payload["fileName"] = fileName;
+        payload["fileName"] = fileName.c_str();
         return doc;
     }
 }
diff --git a/src/MicroOcpp/Operations/GetDiagnostics.h b/src/MicroOcpp/Operations/GetDiagnostics.h
index f9c11635..704f9199 100644
--- a/src/MicroOcpp/Operations/GetDiagnostics.h
+++ b/src/MicroOcpp/Operations/GetDiagnostics.h
@@ -14,10 +14,10 @@ class DiagnosticsService;
 
 namespace Ocpp16 {
 
-class GetDiagnostics : public Operation {
+class GetDiagnostics : public Operation, public MemoryManaged {
 private:
     DiagnosticsService& diagService;
-    std::string fileName;
+    String fileName;
 
     const char *errorCode = nullptr;
 public:
@@ -27,7 +27,7 @@ class GetDiagnostics : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
index c0ca9028..87d4c2dd 100644
--- a/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
+++ b/src/MicroOcpp/Operations/GetInstalledCertificateIds.cpp
@@ -11,8 +11,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp201::GetInstalledCertificateIds;
+using MicroOcpp::JsonDoc;
 
-GetInstalledCertificateIds::GetInstalledCertificateIds(CertificateService& certService) : certService(certService) {
+GetInstalledCertificateIds::GetInstalledCertificateIds(CertificateService& certService) : MemoryManaged("v201.Operation.", "GetInstalledCertificateIds"), certService(certService), certificateHashDataChain(makeVector<CertificateChainHash>(getMemoryTag())) {
 
 }
 
@@ -23,7 +24,7 @@ void GetInstalledCertificateIds::processReq(JsonObject payload) {
         return;
     }
 
-    std::vector<GetCertificateIdType> certificateType;
+    auto certificateType = makeVector<GetCertificateIdType>(getMemoryTag());
     for (const char *certificateTypeCstr : payload["certificateType"].as<JsonArray>()) {
         if (!strcmp(certificateTypeCstr, "V2GRootCertificate")) {
             certificateType.push_back(GetCertificateIdType_V2GRootCertificate);
@@ -65,7 +66,7 @@ void GetInstalledCertificateIds::processReq(JsonObject payload) {
     //operation executed successfully
 }
 
-std::unique_ptr<DynamicJsonDocument> GetInstalledCertificateIds::createConf() {
+std::unique_ptr<JsonDoc> GetInstalledCertificateIds::createConf() {
 
     size_t capacity =
             JSON_OBJECT_SIZE(2) + //payload root
@@ -79,7 +80,7 @@ std::unique_ptr<DynamicJsonDocument> GetInstalledCertificateIds::createConf() {
                     * 2 + 3; //issuerNameHash, issuerKeyHash and serialNumber as hex-endoded cstring
     }
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
+    auto doc = makeJsonDoc(getMemoryTag(), capacity);
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = status;
 
diff --git a/src/MicroOcpp/Operations/GetInstalledCertificateIds.h b/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
index 86c4cfad..28a31c92 100644
--- a/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
+++ b/src/MicroOcpp/Operations/GetInstalledCertificateIds.h
@@ -18,10 +18,10 @@ class CertificateService;
 
 namespace Ocpp201 {
 
-class GetInstalledCertificateIds : public Operation {
+class GetInstalledCertificateIds : public Operation, public MemoryManaged {
 private:
     CertificateService& certService;
-    std::vector<CertificateChainHash> certificateHashDataChain;
+    Vector<CertificateChainHash> certificateHashDataChain;
     const char *status = nullptr;
     const char *errorCode = nullptr;
 public:
@@ -31,7 +31,7 @@ class GetInstalledCertificateIds : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.cpp b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
index b1428791..f2c8a058 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.cpp
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
@@ -12,8 +12,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::GetLocalListVersion;
+using MicroOcpp::JsonDoc;
 
-GetLocalListVersion::GetLocalListVersion(Model& model) : model(model) {
+GetLocalListVersion::GetLocalListVersion(Model& model) : MemoryManaged("v16.Operation.", "GetLocalListVersion"), model(model) {
   
 }
 
@@ -25,8 +26,8 @@ void GetLocalListVersion::processReq(JsonObject payload) {
     //empty payload
 }
 
-std::unique_ptr<DynamicJsonDocument> GetLocalListVersion::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> GetLocalListVersion::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
 
     if (auto authService = model.getAuthorizationService()) {
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.h b/src/MicroOcpp/Operations/GetLocalListVersion.h
index 2d0581ac..554f7a6b 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.h
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.h
@@ -17,7 +17,7 @@ class Model;
 
 namespace Ocpp16 {
 
-class GetLocalListVersion : public Operation {
+class GetLocalListVersion : public Operation, public MemoryManaged {
 private:
     Model& model;
 public:
@@ -27,7 +27,7 @@ class GetLocalListVersion : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/GetVariables.cpp b/src/MicroOcpp/Operations/GetVariables.cpp
index e9500f8b..af75f644 100644
--- a/src/MicroOcpp/Operations/GetVariables.cpp
+++ b/src/MicroOcpp/Operations/GetVariables.cpp
@@ -12,10 +12,16 @@
 
 #include <cctype> //for tolower
 
+using MicroOcpp::Ocpp201::GetVariableData;
 using MicroOcpp::Ocpp201::GetVariables;
+using MicroOcpp::JsonDoc;
+
+GetVariableData::GetVariableData(const char *memory_tag) : componentName{makeString(memory_tag)}, variableName{makeString(memory_tag)} {
+
+}
+
+GetVariables::GetVariables(VariableService& variableService) : MemoryManaged("v201.Operation.", "GetVariableData"), variableService(variableService), queries(makeVector<GetVariableData>(getMemoryTag())) {
 
-GetVariables::GetVariables(VariableService& variableService) : variableService(variableService) {
-  
 }
 
 const char* GetVariables::getOperationType(){
@@ -25,7 +31,7 @@ const char* GetVariables::getOperationType(){
 void GetVariables::processReq(JsonObject payload) {
     for (JsonObject getVariable : payload["getVariableData"].as<JsonArray>()) {
 
-        queries.emplace_back();
+        queries.emplace_back(getMemoryTag());
         auto& data = queries.back();
 
         if (getVariable.containsKey("attributeType")) {
@@ -75,7 +81,7 @@ void GetVariables::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> GetVariables::createConf(){
+std::unique_ptr<JsonDoc> GetVariables::createConf(){
 
     // process GetVariables queries
     for (auto& query : queries) {
@@ -127,7 +133,7 @@ std::unique_ptr<DynamicJsonDocument> GetVariables::createConf(){
                     data.variableName.length() + 1;
     }
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
+    auto doc = makeJsonDoc(getMemoryTag(), capacity);
 
     JsonObject payload = doc->to<JsonObject>();
     JsonArray getVariableResult = payload.createNestedArray("getVariableResult");
diff --git a/src/MicroOcpp/Operations/GetVariables.h b/src/MicroOcpp/Operations/GetVariables.h
index a28f744b..a0360e62 100644
--- a/src/MicroOcpp/Operations/GetVariables.h
+++ b/src/MicroOcpp/Operations/GetVariables.h
@@ -9,10 +9,8 @@
 
 #if MO_ENABLE_V201
 
-#include <string>
-#include <vector>
-
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Model/Variables/Variable.h>
 
 namespace MicroOcpp {
@@ -26,20 +24,22 @@ namespace Ocpp201 {
 struct GetVariableData {
     // GetVariableDataType
     Variable::AttributeType attributeType = Variable::AttributeType::Actual;
-    std::string componentName;
+    String componentName;
     int componentEvseId = -1;
     int componentEvseConnectorId = -1;
-    std::string variableName;
+    String variableName;
 
     // GetVariableResultType
     GetVariableStatus attributeStatus;
     Variable *variable = nullptr;
+
+    GetVariableData(const char *memory_tag = nullptr);
 };
 
-class GetVariables : public Operation {
+class GetVariables : public Operation, public MemoryManaged {
 private:
     VariableService& variableService;
-    std::vector<GetVariableData> queries;
+    Vector<GetVariableData> queries;
 
     const char *errorCode = nullptr;
 public:
@@ -49,7 +49,7 @@ class GetVariables : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 
diff --git a/src/MicroOcpp/Operations/Heartbeat.cpp b/src/MicroOcpp/Operations/Heartbeat.cpp
index 040fba05..4dfd0439 100644
--- a/src/MicroOcpp/Operations/Heartbeat.cpp
+++ b/src/MicroOcpp/Operations/Heartbeat.cpp
@@ -8,8 +8,9 @@
 #include <string.h>
 
 using MicroOcpp::Ocpp16::Heartbeat;
+using MicroOcpp::JsonDoc;
 
-Heartbeat::Heartbeat(Model& model) : model(model) {
+Heartbeat::Heartbeat(Model& model) : MemoryManaged("v16.Operation.", "Heartbeat"), model(model) {
   
 }
 
@@ -17,7 +18,7 @@ const char* Heartbeat::getOperationType(){
     return "Heartbeat";
 }
 
-std::unique_ptr<DynamicJsonDocument> Heartbeat::createReq() {
+std::unique_ptr<JsonDoc> Heartbeat::createReq() {
     return createEmptyDocument();
 }
 
@@ -44,8 +45,8 @@ void Heartbeat::processReq(JsonObject payload) {
 
 }
 
-std::unique_ptr<DynamicJsonDocument> Heartbeat::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + (JSONDATE_LENGTH + 1)));
+std::unique_ptr<JsonDoc> Heartbeat::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1) + (JSONDATE_LENGTH + 1));
     JsonObject payload = doc->to<JsonObject>();
 
     //safety mechanism; in some test setups the library could have to answer Heartbeats without valid system time
diff --git a/src/MicroOcpp/Operations/Heartbeat.h b/src/MicroOcpp/Operations/Heartbeat.h
index 83d4c01d..b3ce6a0e 100644
--- a/src/MicroOcpp/Operations/Heartbeat.h
+++ b/src/MicroOcpp/Operations/Heartbeat.h
@@ -13,7 +13,7 @@ class Model;
 
 namespace Ocpp16 {
 
-class Heartbeat : public Operation {
+class Heartbeat : public Operation, public MemoryManaged {
 private:
     Model& model;
 public:
@@ -21,13 +21,13 @@ class Heartbeat : public Operation {
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/InstallCertificate.cpp b/src/MicroOcpp/Operations/InstallCertificate.cpp
index dee8c57e..b9859501 100644
--- a/src/MicroOcpp/Operations/InstallCertificate.cpp
+++ b/src/MicroOcpp/Operations/InstallCertificate.cpp
@@ -10,8 +10,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp201::InstallCertificate;
+using MicroOcpp::JsonDoc;
 
-InstallCertificate::InstallCertificate(CertificateService& certService) : certService(certService) {
+InstallCertificate::InstallCertificate(CertificateService& certService) : MemoryManaged("v201.Operation.", "InstallCertificate"), certService(certService) {
 
 }
 
@@ -74,8 +75,8 @@ void InstallCertificate::processReq(JsonObject payload) {
     //operation executed successfully
 }
 
-std::unique_ptr<DynamicJsonDocument> InstallCertificate::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> InstallCertificate::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = status;
     return doc;
diff --git a/src/MicroOcpp/Operations/InstallCertificate.h b/src/MicroOcpp/Operations/InstallCertificate.h
index b3ded1c1..e2c22b55 100644
--- a/src/MicroOcpp/Operations/InstallCertificate.h
+++ b/src/MicroOcpp/Operations/InstallCertificate.h
@@ -17,7 +17,7 @@ class CertificateService;
 
 namespace Ocpp201 {
 
-class InstallCertificate : public Operation {
+class InstallCertificate : public Operation, public MemoryManaged {
 private:
     CertificateService& certService;
     const char *status = nullptr;
@@ -29,7 +29,7 @@ class InstallCertificate : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/MeterValues.cpp b/src/MicroOcpp/Operations/MeterValues.cpp
index b00be35f..905e63dc 100644
--- a/src/MicroOcpp/Operations/MeterValues.cpp
+++ b/src/MicroOcpp/Operations/MeterValues.cpp
@@ -9,16 +9,17 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::MeterValues;
+using MicroOcpp::JsonDoc;
 
 #define ENERGY_METER_TIMEOUT_MS 30 * 1000  //after waiting for 30s, send MeterValues without missing readings
 
 //can only be used for echo server debugging
-MeterValues::MeterValues() {
+MeterValues::MeterValues() : MemoryManaged("v16.Operation.", "MeterValues") {
     
 }
 
-MeterValues::MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction) 
-      : meterValue{std::move(meterValue)}, connectorId{connectorId}, transaction{transaction} {
+MeterValues::MeterValues(Vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction) 
+      : MemoryManaged("v16.Operation.", "MeterValues"), meterValue{std::move(meterValue)}, connectorId{connectorId}, transaction{transaction} {
     
 }
 
@@ -30,11 +31,11 @@ const char* MeterValues::getOperationType(){
     return "MeterValues";
 }
 
-std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
+std::unique_ptr<JsonDoc> MeterValues::createReq() {
 
     size_t capacity = 0;
     
-    std::vector<std::unique_ptr<DynamicJsonDocument>> entries;
+    auto entries = makeVector<std::unique_ptr<JsonDoc>>(getMemoryTag());
     for (auto value = meterValue.begin(); value != meterValue.end(); value++) {
         auto entry = (*value)->toJson();
         if (entry) {
@@ -48,7 +49,7 @@ std::unique_ptr<DynamicJsonDocument> MeterValues::createReq() {
     capacity += JSON_OBJECT_SIZE(3);
     capacity += JSON_ARRAY_SIZE(entries.size());
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity + 100)); //TODO remove safety space
+    auto doc = makeJsonDoc(getMemoryTag(), capacity);
     auto payload = doc->to<JsonObject>();
     payload["connectorId"] = connectorId;
 
@@ -77,6 +78,6 @@ void MeterValues::processReq(JsonObject payload) {
 
 }
 
-std::unique_ptr<DynamicJsonDocument> MeterValues::createConf(){
+std::unique_ptr<JsonDoc> MeterValues::createConf(){
     return createEmptyDocument();
 }
diff --git a/src/MicroOcpp/Operations/MeterValues.h b/src/MicroOcpp/Operations/MeterValues.h
index 3760e2aa..012151d5 100644
--- a/src/MicroOcpp/Operations/MeterValues.h
+++ b/src/MicroOcpp/Operations/MeterValues.h
@@ -6,10 +6,9 @@
 #define MO_METERVALUES_H
 
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Core/Time.h>
 
-#include <vector>
-
 namespace MicroOcpp {
 
 class MeterValue;
@@ -17,16 +16,16 @@ class Transaction;
 
 namespace Ocpp16 {
 
-class MeterValues : public Operation {
+class MeterValues : public Operation, public MemoryManaged {
 private:
-    std::vector<std::unique_ptr<MeterValue>> meterValue;
+    Vector<std::unique_ptr<MeterValue>> meterValue;
 
     unsigned int connectorId = 0;
 
     std::shared_ptr<Transaction> transaction;
 
 public:
-    MeterValues(std::vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction = nullptr);
+    MeterValues(Vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction = nullptr);
 
     MeterValues(); //for debugging only. Make this for the server pendant
 
@@ -34,13 +33,13 @@ class MeterValues : public Operation {
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/NotifyReport.cpp b/src/MicroOcpp/Operations/NotifyReport.cpp
index 9cbff693..0528e452 100644
--- a/src/MicroOcpp/Operations/NotifyReport.cpp
+++ b/src/MicroOcpp/Operations/NotifyReport.cpp
@@ -11,11 +11,11 @@
 #include <MicroOcpp/Model/Variables/Variable.h>
 #include <MicroOcpp/Debug.h>
 
-using MicroOcpp::Ocpp201::NotifyReport;
 using namespace MicroOcpp::Ocpp201;
+using MicroOcpp::JsonDoc;
 
-NotifyReport::NotifyReport(Model& model, int requestId, const Timestamp& generatedAt, bool tbc, int seqNo, const std::vector<Variable*>& reportData)
-        : model(model), requestId(requestId), generatedAt(generatedAt), tbc(tbc), seqNo(seqNo), reportData(reportData) {
+NotifyReport::NotifyReport(Model& model, int requestId, const Timestamp& generatedAt, bool tbc, int seqNo, const Vector<Variable*>& reportData)
+        : MemoryManaged("v201.Operation.", "NotifyReport"), model(model), requestId(requestId), generatedAt(generatedAt), tbc(tbc), seqNo(seqNo), reportData(reportData) {
 
 }
 
@@ -23,7 +23,7 @@ const char* NotifyReport::getOperationType() {
     return "NotifyReport";
 }
 
-std::unique_ptr<DynamicJsonDocument> NotifyReport::createReq() {
+std::unique_ptr<JsonDoc> NotifyReport::createReq() {
 
     #define VALUE_BUFSIZE 30 // for primitives (int)
 
@@ -81,7 +81,7 @@ std::unique_ptr<DynamicJsonDocument> NotifyReport::createReq() {
         capacity += JSON_OBJECT_SIZE(2); //variableCharacteristics composite: only send two data fields
     }
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
+    auto doc = makeJsonDoc(getMemoryTag(), capacity);
 
     JsonObject payload = doc->to<JsonObject>();
     payload["requestId"] = requestId;
diff --git a/src/MicroOcpp/Operations/NotifyReport.h b/src/MicroOcpp/Operations/NotifyReport.h
index 285808e2..1a092678 100644
--- a/src/MicroOcpp/Operations/NotifyReport.h
+++ b/src/MicroOcpp/Operations/NotifyReport.h
@@ -11,8 +11,7 @@
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Time.h>
-
-#include <vector>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
@@ -21,7 +20,7 @@ class Variable;
 
 namespace Ocpp201 {
 
-class NotifyReport : public Operation {
+class NotifyReport : public Operation, public MemoryManaged {
 private:
     Model& model;
 
@@ -29,14 +28,14 @@ class NotifyReport : public Operation {
     Timestamp generatedAt;
     bool tbc;
     int seqNo;
-    std::vector<Variable*> reportData;
+    Vector<Variable*> reportData;
 public:
 
-    NotifyReport(Model& model, int requestId, const Timestamp& generatedAt, bool tbc, int seqNo, const std::vector<Variable*>& reportData);
+    NotifyReport(Model& model, int requestId, const Timestamp& generatedAt, bool tbc, int seqNo, const Vector<Variable*>& reportData);
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 };
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
index 668b6738..4e0d7163 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
@@ -11,8 +11,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::RemoteStartTransaction;
+using MicroOcpp::JsonDoc;
 
-RemoteStartTransaction::RemoteStartTransaction(Model& model) : model(model) {
+RemoteStartTransaction::RemoteStartTransaction(Model& model) : MemoryManaged("v16.Operation.", "RemoteStartTransaction"), model(model) {
   
 }
 
@@ -115,8 +116,8 @@ void RemoteStartTransaction::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> RemoteStartTransaction::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     if (accepted) {
         payload["status"] = "Accepted";
@@ -126,8 +127,8 @@ std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createConf(){
     return doc;
 }
 
-std::unique_ptr<DynamicJsonDocument> RemoteStartTransaction::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> RemoteStartTransaction::createReq() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
 
     payload["idTag"] = "A0000000";
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.h b/src/MicroOcpp/Operations/RemoteStartTransaction.h
index c286e1fd..411578bd 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.h
@@ -15,7 +15,7 @@ class ChargingProfile;
 
 namespace Ocpp16 {
 
-class RemoteStartTransaction : public Operation {
+class RemoteStartTransaction : public Operation, public MemoryManaged {
 private:
     Model& model;
 
@@ -28,13 +28,13 @@ class RemoteStartTransaction : public Operation {
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
     const char *getErrorDescription() override {return errorDescription;}
diff --git a/src/MicroOcpp/Operations/RemoteStopTransaction.cpp b/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
index 7e1cdd54..8a36699a 100644
--- a/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStopTransaction.cpp
@@ -8,8 +8,9 @@
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 
 using MicroOcpp::Ocpp16::RemoteStopTransaction;
+using MicroOcpp::JsonDoc;
 
-RemoteStopTransaction::RemoteStopTransaction(Model& model) : model(model) {
+RemoteStopTransaction::RemoteStopTransaction(Model& model) : MemoryManaged("v16.Operation.", "RemoteStopTransaction"), model(model) {
   
 }
 
@@ -34,8 +35,8 @@ void RemoteStopTransaction::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> RemoteStopTransaction::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> RemoteStopTransaction::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     if (accepted){
         payload["status"] = "Accepted";
diff --git a/src/MicroOcpp/Operations/RemoteStopTransaction.h b/src/MicroOcpp/Operations/RemoteStopTransaction.h
index a3d6ac21..2a42d695 100644
--- a/src/MicroOcpp/Operations/RemoteStopTransaction.h
+++ b/src/MicroOcpp/Operations/RemoteStopTransaction.h
@@ -13,7 +13,7 @@ class Model;
 
 namespace Ocpp16 {
 
-class RemoteStopTransaction : public Operation {
+class RemoteStopTransaction : public Operation, public MemoryManaged {
 private:
     Model& model;
     bool accepted = false;
@@ -26,7 +26,7 @@ class RemoteStopTransaction : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/RequestStartTransaction.cpp b/src/MicroOcpp/Operations/RequestStartTransaction.cpp
index 29ac3627..9b35783b 100644
--- a/src/MicroOcpp/Operations/RequestStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RequestStartTransaction.cpp
@@ -11,8 +11,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp201::RequestStartTransaction;
+using MicroOcpp::JsonDoc;
 
-RequestStartTransaction::RequestStartTransaction(TransactionService& txService) : txService(txService) {
+RequestStartTransaction::RequestStartTransaction(TransactionService& txService) : MemoryManaged("v201.Operation.", "RequestStartTransaction"), txService(txService) {
   
 }
 
@@ -45,9 +46,9 @@ void RequestStartTransaction::processReq(JsonObject payload) {
     status = txService.requestStartTransaction(evseId, remoteStartId, idToken, transactionId);
 }
 
-std::unique_ptr<DynamicJsonDocument> RequestStartTransaction::createConf(){
+std::unique_ptr<JsonDoc> RequestStartTransaction::createConf(){
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(2));
     JsonObject payload = doc->to<JsonObject>();
 
     const char *statusCstr = "";
diff --git a/src/MicroOcpp/Operations/RequestStartTransaction.h b/src/MicroOcpp/Operations/RequestStartTransaction.h
index 9a4b6ab4..d28ade11 100644
--- a/src/MicroOcpp/Operations/RequestStartTransaction.h
+++ b/src/MicroOcpp/Operations/RequestStartTransaction.h
@@ -9,8 +9,8 @@
 
 #if MO_ENABLE_V201
 
-#include <string>
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Model/Transactions/TransactionDefs.h>
 
 namespace MicroOcpp {
@@ -19,7 +19,7 @@ class TransactionService;
 
 namespace Ocpp201 {
 
-class RequestStartTransaction : public Operation {
+class RequestStartTransaction : public Operation, public MemoryManaged {
 private:
     TransactionService& txService;
 
@@ -34,7 +34,7 @@ class RequestStartTransaction : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 
diff --git a/src/MicroOcpp/Operations/RequestStopTransaction.cpp b/src/MicroOcpp/Operations/RequestStopTransaction.cpp
index 6baf7bcb..9752895a 100644
--- a/src/MicroOcpp/Operations/RequestStopTransaction.cpp
+++ b/src/MicroOcpp/Operations/RequestStopTransaction.cpp
@@ -11,8 +11,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp201::RequestStopTransaction;
+using MicroOcpp::JsonDoc;
 
-RequestStopTransaction::RequestStopTransaction(TransactionService& txService) : txService(txService) {
+RequestStopTransaction::RequestStopTransaction(TransactionService& txService) : MemoryManaged("v201.Operation.", "RequestStopTransaction"), txService(txService) {
   
 }
 
@@ -32,9 +33,9 @@ void RequestStopTransaction::processReq(JsonObject payload) {
     status = txService.requestStopTransaction(payload["transactionId"].as<const char*>());
 }
 
-std::unique_ptr<DynamicJsonDocument> RequestStopTransaction::createConf(){
+std::unique_ptr<JsonDoc> RequestStopTransaction::createConf(){
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
 
     const char *statusCstr = "";
diff --git a/src/MicroOcpp/Operations/RequestStopTransaction.h b/src/MicroOcpp/Operations/RequestStopTransaction.h
index 40222c7a..ba8f545c 100644
--- a/src/MicroOcpp/Operations/RequestStopTransaction.h
+++ b/src/MicroOcpp/Operations/RequestStopTransaction.h
@@ -9,8 +9,8 @@
 
 #if MO_ENABLE_V201
 
-#include <string>
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Model/Transactions/TransactionDefs.h>
 
 namespace MicroOcpp {
@@ -19,7 +19,7 @@ class TransactionService;
 
 namespace Ocpp201 {
 
-class RequestStopTransaction : public Operation {
+class RequestStopTransaction : public Operation, public MemoryManaged {
 private:
     TransactionService& txService;
 
@@ -33,7 +33,7 @@ class RequestStopTransaction : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 
diff --git a/src/MicroOcpp/Operations/ReserveNow.cpp b/src/MicroOcpp/Operations/ReserveNow.cpp
index fe7eb473..26857fdb 100644
--- a/src/MicroOcpp/Operations/ReserveNow.cpp
+++ b/src/MicroOcpp/Operations/ReserveNow.cpp
@@ -14,8 +14,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::ReserveNow;
+using MicroOcpp::JsonDoc;
 
-ReserveNow::ReserveNow(Model& model) : model(model) {
+ReserveNow::ReserveNow(Model& model) : MemoryManaged("v16.Operation.", "ReserveNow"), model(model) {
   
 }
 
@@ -114,8 +115,8 @@ void ReserveNow::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> ReserveNow::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> ReserveNow::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
 
     if (reservationStatus) {
diff --git a/src/MicroOcpp/Operations/ReserveNow.h b/src/MicroOcpp/Operations/ReserveNow.h
index e907a716..cf162ad6 100644
--- a/src/MicroOcpp/Operations/ReserveNow.h
+++ b/src/MicroOcpp/Operations/ReserveNow.h
@@ -17,7 +17,7 @@ class Model;
 
 namespace Ocpp16 {
 
-class ReserveNow : public Operation {
+class ReserveNow : public Operation, public MemoryManaged {
 private:
     Model& model;
     const char *errorCode = nullptr;
@@ -31,7 +31,7 @@ class ReserveNow : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/Reset.cpp b/src/MicroOcpp/Operations/Reset.cpp
index 87c8f855..bf2b7592 100644
--- a/src/MicroOcpp/Operations/Reset.cpp
+++ b/src/MicroOcpp/Operations/Reset.cpp
@@ -8,8 +8,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::Reset;
+using MicroOcpp::JsonDoc;
 
-Reset::Reset(Model& model) : model(model) {
+Reset::Reset(Model& model) : MemoryManaged("v16.Operation.", "Reset"), model(model) {
   
 }
 
@@ -42,8 +43,8 @@ void Reset::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> Reset::createConf() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> Reset::createConf() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = resetAccepted ? "Accepted" : "Rejected";
     return doc;
@@ -56,7 +57,7 @@ std::unique_ptr<DynamicJsonDocument> Reset::createConf() {
 namespace MicroOcpp {
 namespace Ocpp201 {
 
-Reset::Reset(ResetService& resetService) : resetService(resetService) {
+Reset::Reset(ResetService& resetService) : MemoryManaged("v201.Operation.", "Reset"), resetService(resetService) {
   
 }
 
@@ -90,8 +91,8 @@ void Reset::processReq(JsonObject payload) {
     status = resetService.initiateReset(type, evseId);
 }
 
-std::unique_ptr<DynamicJsonDocument> Reset::createConf() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> Reset::createConf() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
 
     const char *statusCstr = "";
diff --git a/src/MicroOcpp/Operations/Reset.h b/src/MicroOcpp/Operations/Reset.h
index 212a17c2..53aca0d0 100644
--- a/src/MicroOcpp/Operations/Reset.h
+++ b/src/MicroOcpp/Operations/Reset.h
@@ -15,7 +15,7 @@ class Model;
 
 namespace Ocpp16 {
 
-class Reset : public Operation {
+class Reset : public Operation, public MemoryManaged {
 private:
     Model& model;
     bool resetAccepted {false};
@@ -26,7 +26,7 @@ class Reset : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 };
 
 } //end namespace Ocpp16
@@ -39,7 +39,7 @@ namespace Ocpp201 {
 
 class ResetService;
 
-class Reset : public Operation {
+class Reset : public Operation, public MemoryManaged {
 private:
     ResetService& resetService;
     ResetStatus status;
@@ -51,7 +51,7 @@ class Reset : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 128f5d8a..45f0dfbe 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -11,8 +11,9 @@
 #include <MicroOcpp/Model/Authorization/AuthorizationService.h>
 
 using MicroOcpp::Ocpp16::SendLocalList;
+using MicroOcpp::JsonDoc;
 
-SendLocalList::SendLocalList(AuthorizationService& authService) : authService(authService) {
+SendLocalList::SendLocalList(AuthorizationService& authService) : MemoryManaged("v16.Operation.", "SendLocalList"), authService(authService) {
   
 }
 
@@ -55,8 +56,8 @@ void SendLocalList::processReq(JsonObject payload) {
     updateFailure = !authService.updateLocalList(localAuthorizationList, listVersion, differential);
 }
 
-std::unique_ptr<DynamicJsonDocument> SendLocalList::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> SendLocalList::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
 
     if (versionMismatch) {
diff --git a/src/MicroOcpp/Operations/SendLocalList.h b/src/MicroOcpp/Operations/SendLocalList.h
index bbd1fa2d..d58265bd 100644
--- a/src/MicroOcpp/Operations/SendLocalList.h
+++ b/src/MicroOcpp/Operations/SendLocalList.h
@@ -17,7 +17,7 @@ class AuthorizationService;
 
 namespace Ocpp16 {
 
-class SendLocalList : public Operation {
+class SendLocalList : public Operation, public MemoryManaged {
 private:
     AuthorizationService& authService;
     const char *errorCode = nullptr;
@@ -32,7 +32,7 @@ class SendLocalList : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/SetChargingProfile.cpp b/src/MicroOcpp/Operations/SetChargingProfile.cpp
index 20cf5ca8..355d70d3 100644
--- a/src/MicroOcpp/Operations/SetChargingProfile.cpp
+++ b/src/MicroOcpp/Operations/SetChargingProfile.cpp
@@ -9,8 +9,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::SetChargingProfile;
+using MicroOcpp::JsonDoc;
 
-SetChargingProfile::SetChargingProfile(Model& model, SmartChargingService& scService) : model(model), scService(scService) {
+SetChargingProfile::SetChargingProfile(Model& model, SmartChargingService& scService) : MemoryManaged("v16.Operation.", "SetChargingProfile"), model(model), scService(scService) {
 
 }
 
@@ -84,8 +85,8 @@ void SetChargingProfile::processReq(JsonObject payload) {
     accepted = scService.setChargingProfile(connectorId, std::move(chargingProfile));
 }
 
-std::unique_ptr<DynamicJsonDocument> SetChargingProfile::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> SetChargingProfile::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     if (accepted) {
         payload["status"] = "Accepted";
diff --git a/src/MicroOcpp/Operations/SetChargingProfile.h b/src/MicroOcpp/Operations/SetChargingProfile.h
index b68e96dc..1ce35f1e 100644
--- a/src/MicroOcpp/Operations/SetChargingProfile.h
+++ b/src/MicroOcpp/Operations/SetChargingProfile.h
@@ -14,7 +14,7 @@ class SmartChargingService;
 
 namespace Ocpp16 {
 
-class SetChargingProfile : public Operation {
+class SetChargingProfile : public Operation, public MemoryManaged {
 private:
     Model& model;
     SmartChargingService& scService;
@@ -31,7 +31,7 @@ class SetChargingProfile : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
     const char *getErrorDescription() override {return errorDescription;}
diff --git a/src/MicroOcpp/Operations/SetVariables.cpp b/src/MicroOcpp/Operations/SetVariables.cpp
index 6333353e..23bd043d 100644
--- a/src/MicroOcpp/Operations/SetVariables.cpp
+++ b/src/MicroOcpp/Operations/SetVariables.cpp
@@ -10,9 +10,15 @@
 #include <MicroOcpp/Model/Variables/VariableService.h>
 #include <MicroOcpp/Debug.h>
 
+using MicroOcpp::Ocpp201::SetVariableData;
 using MicroOcpp::Ocpp201::SetVariables;
+using MicroOcpp::JsonDoc;
 
-SetVariables::SetVariables(VariableService& variableService) : variableService(variableService) {
+SetVariableData::SetVariableData(const char *memory_tag) : componentName{makeString(memory_tag)}, variableName{makeString(memory_tag)} {
+
+}
+
+SetVariables::SetVariables(VariableService& variableService) : MemoryManaged("v201.Operation.", "SetVariables"), variableService(variableService), queries(makeVector<SetVariableData>(getMemoryTag())) {
   
 }
 
@@ -23,7 +29,7 @@ const char* SetVariables::getOperationType(){
 void SetVariables::processReq(JsonObject payload) {
     for (JsonObject setVariable : payload["setVariableData"].as<JsonArray>()) {
 
-        queries.emplace_back();
+        queries.emplace_back(getMemoryTag());
         auto& data = queries.back();
 
         if (setVariable.containsKey("attributeType")) {
@@ -93,7 +99,7 @@ void SetVariables::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> SetVariables::createConf(){
+std::unique_ptr<JsonDoc> SetVariables::createConf(){
     size_t capacity = JSON_ARRAY_SIZE(queries.size());
     for (const auto& data : queries) {
         capacity += 
@@ -104,7 +110,7 @@ std::unique_ptr<DynamicJsonDocument> SetVariables::createConf(){
                 JSON_OBJECT_SIZE(2) + // variable
                     data.variableName.length() + 1;
     }
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(capacity));
+    auto doc = makeJsonDoc(getMemoryTag(), capacity);
 
     JsonObject payload = doc->to<JsonObject>();
     JsonArray setVariableResult = payload.createNestedArray("setVariableResult");
diff --git a/src/MicroOcpp/Operations/SetVariables.h b/src/MicroOcpp/Operations/SetVariables.h
index 83527a4e..fb0ca889 100644
--- a/src/MicroOcpp/Operations/SetVariables.h
+++ b/src/MicroOcpp/Operations/SetVariables.h
@@ -9,10 +9,8 @@
 
 #if MO_ENABLE_V201
 
-#include <string>
-#include <vector>
-
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Model/Variables/Variable.h>
 
 namespace MicroOcpp {
@@ -27,19 +25,21 @@ struct SetVariableData {
     // SetVariableDataType
     Variable::AttributeType attributeType = Variable::AttributeType::Actual;
     const char *attributeValue; // will become invalid after processReq
-    std::string componentName;
+    String componentName;
     int componentEvseId = -1;
     int componentEvseConnectorId = -1;
-    std::string variableName;
+    String variableName;
 
     // SetVariableResultType
     SetVariableStatus attributeStatus;
+
+    SetVariableData(const char *memory_tag = nullptr);
 };
 
-class SetVariables : public Operation {
+class SetVariables : public Operation, public MemoryManaged {
 private:
     VariableService& variableService;
-    std::vector<SetVariableData> queries;
+    Vector<SetVariableData> queries;
 
     const char *errorCode = nullptr;
 public:
@@ -49,7 +49,7 @@ class SetVariables : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 
diff --git a/src/MicroOcpp/Operations/StartTransaction.cpp b/src/MicroOcpp/Operations/StartTransaction.cpp
index ccd5d89e..907baaf3 100644
--- a/src/MicroOcpp/Operations/StartTransaction.cpp
+++ b/src/MicroOcpp/Operations/StartTransaction.cpp
@@ -12,9 +12,10 @@
 #include <MicroOcpp/Version.h>
 
 using MicroOcpp::Ocpp16::StartTransaction;
+using MicroOcpp::JsonDoc;
 
 
-StartTransaction::StartTransaction(Model& model, std::shared_ptr<Transaction> transaction) : model(model), transaction(transaction) {
+StartTransaction::StartTransaction(Model& model, std::shared_ptr<Transaction> transaction) : MemoryManaged("v16.Operation.", "StartTransaction"), model(model), transaction(transaction) {
     
 }
 
@@ -26,12 +27,12 @@ const char* StartTransaction::getOperationType() {
     return "StartTransaction";
 }
 
-std::unique_ptr<DynamicJsonDocument> StartTransaction::createReq() {
+std::unique_ptr<JsonDoc> StartTransaction::createReq() {
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+    auto doc = makeJsonDoc(getMemoryTag(),
                 JSON_OBJECT_SIZE(6) + 
                 (IDTAG_LEN_MAX + 1) +
-                (JSONDATE_LENGTH + 1)));
+                (JSONDATE_LENGTH + 1));
                 
     JsonObject payload = doc->to<JsonObject>();
 
@@ -93,8 +94,8 @@ void StartTransaction::processReq(JsonObject payload) {
 
 }
 
-std::unique_ptr<DynamicJsonDocument> StartTransaction::createConf() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+std::unique_ptr<JsonDoc> StartTransaction::createConf() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2));
     JsonObject payload = doc->to<JsonObject>();
 
     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
diff --git a/src/MicroOcpp/Operations/StartTransaction.h b/src/MicroOcpp/Operations/StartTransaction.h
index e01d0461..a73b5368 100644
--- a/src/MicroOcpp/Operations/StartTransaction.h
+++ b/src/MicroOcpp/Operations/StartTransaction.h
@@ -17,7 +17,7 @@ class Transaction;
 
 namespace Ocpp16 {
 
-class StartTransaction : public Operation {
+class StartTransaction : public Operation, public MemoryManaged {
 private:
     Model& model;
     std::shared_ptr<Transaction> transaction;
@@ -29,13 +29,13 @@ class StartTransaction : public Operation {
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/StatusNotification.cpp b/src/MicroOcpp/Operations/StatusNotification.cpp
index 75e5cf1f..c5fb1a60 100644
--- a/src/MicroOcpp/Operations/StatusNotification.cpp
+++ b/src/MicroOcpp/Operations/StatusNotification.cpp
@@ -46,7 +46,7 @@ const char *cstrFromOcppEveState(ChargePointStatus state) {
 namespace Ocpp16 {
 
 StatusNotification::StatusNotification(int connectorId, ChargePointStatus currentStatus, const Timestamp &timestamp, ErrorData errorData)
-        : connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorData(errorData) {
+        : MemoryManaged("v16.Operation.", "StatusNotification"), connectorId(connectorId), currentStatus(currentStatus), timestamp(timestamp), errorData(errorData) {
     
     if (currentStatus != ChargePointStatus_UNDEFINED) {
         MO_DBG_INFO("New status: %s (connectorId %d)", cstrFromOcppEveState(currentStatus), connectorId);
@@ -57,8 +57,8 @@ const char* StatusNotification::getOperationType(){
     return "StatusNotification";
 }
 
-std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(7) + (JSONDATE_LENGTH + 1)));
+std::unique_ptr<JsonDoc> StatusNotification::createReq() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(7) + (JSONDATE_LENGTH + 1));
     JsonObject payload = doc->to<JsonObject>();
 
     payload["connectorId"] = connectorId;
@@ -107,7 +107,7 @@ void StatusNotification::processReq(JsonObject payload) {
 /*
  * For debugging only
  */
-std::unique_ptr<DynamicJsonDocument> StatusNotification::createConf(){
+std::unique_ptr<JsonDoc> StatusNotification::createConf(){
     return createEmptyDocument();
 }
 
@@ -120,7 +120,7 @@ namespace MicroOcpp {
 namespace Ocpp201 {
 
 StatusNotification::StatusNotification(EvseId evseId, ChargePointStatus currentStatus, const Timestamp &timestamp)
-        : evseId(evseId), timestamp(timestamp), currentStatus(currentStatus) {
+        : MemoryManaged("v201.Operation.", "StatusNotification"), evseId(evseId), timestamp(timestamp), currentStatus(currentStatus) {
 
 }
 
@@ -128,8 +128,8 @@ const char* StatusNotification::getOperationType(){
     return "StatusNotification";
 }
 
-std::unique_ptr<DynamicJsonDocument> StatusNotification::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4) + (JSONDATE_LENGTH + 1)));
+std::unique_ptr<JsonDoc> StatusNotification::createReq() {
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(4) + (JSONDATE_LENGTH + 1));
     JsonObject payload = doc->to<JsonObject>();
 
     char timestamp_cstr[JSONDATE_LENGTH + 1] = {'\0'};
diff --git a/src/MicroOcpp/Operations/StatusNotification.h b/src/MicroOcpp/Operations/StatusNotification.h
index b218ed7e..2e65dcec 100644
--- a/src/MicroOcpp/Operations/StatusNotification.h
+++ b/src/MicroOcpp/Operations/StatusNotification.h
@@ -17,7 +17,7 @@ const char *cstrFromOcppEveState(ChargePointStatus state);
 
 namespace Ocpp16 {
 
-class StatusNotification : public Operation {
+class StatusNotification : public Operation, public MemoryManaged {
 private:
     int connectorId = 1;
     ChargePointStatus currentStatus = ChargePointStatus_UNDEFINED;
@@ -28,13 +28,13 @@ class StatusNotification : public Operation {
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     int getConnectorId() {
         return connectorId;
@@ -51,7 +51,7 @@ class StatusNotification : public Operation {
 namespace MicroOcpp {
 namespace Ocpp201 {
 
-class StatusNotification : public Operation {
+class StatusNotification : public Operation, public MemoryManaged {
 private:
     EvseId evseId;
     Timestamp timestamp;
@@ -61,7 +61,7 @@ class StatusNotification : public Operation {
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 };
diff --git a/src/MicroOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
index 49b9b029..ecc495cc 100644
--- a/src/MicroOcpp/Operations/StopTransaction.cpp
+++ b/src/MicroOcpp/Operations/StopTransaction.cpp
@@ -13,14 +13,15 @@
 #include <MicroOcpp/Version.h>
 
 using MicroOcpp::Ocpp16::StopTransaction;
+using MicroOcpp::JsonDoc;
 
 StopTransaction::StopTransaction(Model& model, std::shared_ptr<Transaction> transaction)
-        : model(model), transaction(transaction) {
+        : MemoryManaged("v16.Operation.", "StopTransaction"), model(model), transaction(transaction) {
 
 }
 
-StopTransaction::StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<MicroOcpp::MeterValue>> transactionData)
-        : model(model), transaction(transaction), transactionData(std::move(transactionData)) {
+StopTransaction::StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, Vector<std::unique_ptr<MicroOcpp::MeterValue>> transactionData)
+        : MemoryManaged("v16.Operation.", "StopTransaction"), model(model), transaction(transaction), transactionData(std::move(transactionData)) {
 
 }
 
@@ -28,7 +29,7 @@ const char* StopTransaction::getOperationType() {
     return "StopTransaction";
 }
 
-std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
+std::unique_ptr<JsonDoc> StopTransaction::createReq() {
 
     /*
      * Adjust timestamps in case they were taken before initial Clock setting
@@ -67,7 +68,7 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
         }
     }
 
-    std::vector<std::unique_ptr<DynamicJsonDocument>> txDataJson;
+    auto txDataJson = makeVector<std::unique_ptr<JsonDoc>>(getMemoryTag());
     size_t txDataJson_size = 0;
     for (auto mv = transactionData.begin(); mv != transactionData.end(); mv++) {
         auto mvJson = (*mv)->toJson();
@@ -78,17 +79,17 @@ std::unique_ptr<DynamicJsonDocument> StopTransaction::createReq() {
         txDataJson.emplace_back(std::move(mvJson));
     }
 
-    DynamicJsonDocument txDataDoc = DynamicJsonDocument(JSON_ARRAY_SIZE(txDataJson.size()) + txDataJson_size);
+    auto txDataDoc = initJsonDoc(getMemoryTag(), JSON_ARRAY_SIZE(txDataJson.size()) + txDataJson_size);
     for (auto mvJson = txDataJson.begin(); mvJson != txDataJson.end(); mvJson++) {
         txDataDoc.add(**mvJson);
     }
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+    auto doc = makeJsonDoc(getMemoryTag(),
                 JSON_OBJECT_SIZE(6) + //total of 6 fields
                 (IDTAG_LEN_MAX + 1) + //stop idTag
                 (JSONDATE_LENGTH + 1) + //timestamp string
                 (REASON_LEN_MAX + 1) + //reason string
-                txDataDoc.capacity()));
+                txDataDoc.capacity());
     JsonObject payload = doc->to<JsonObject>();
 
     if (transaction->getStopIdTag() && *transaction->getStopIdTag()) {
@@ -148,8 +149,8 @@ void StopTransaction::processReq(JsonObject payload) {
      */
 }
 
-std::unique_ptr<DynamicJsonDocument> StopTransaction::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> StopTransaction::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), 2 * JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
 
     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
diff --git a/src/MicroOcpp/Operations/StopTransaction.h b/src/MicroOcpp/Operations/StopTransaction.h
index 9f617e9d..c573135c 100644
--- a/src/MicroOcpp/Operations/StopTransaction.h
+++ b/src/MicroOcpp/Operations/StopTransaction.h
@@ -6,9 +6,9 @@
 #define MO_STOPTRANSACTION_H
 
 #include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Core/Time.h>
 #include <MicroOcpp/Operations/CiStrings.h>
-#include <vector>
 
 namespace MicroOcpp {
 
@@ -21,20 +21,20 @@ class Transaction;
 
 namespace Ocpp16 {
 
-class StopTransaction : public Operation {
+class StopTransaction : public Operation, public MemoryManaged {
 private:
     Model& model;
     std::shared_ptr<Transaction> transaction;
-    std::vector<std::unique_ptr<MeterValue>> transactionData;
+    Vector<std::unique_ptr<MeterValue>> transactionData;
 public:
 
     StopTransaction(Model& model, std::shared_ptr<Transaction> transaction);
 
-    StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, std::vector<std::unique_ptr<MicroOcpp::MeterValue>> transactionData);
+    StopTransaction(Model& model, std::shared_ptr<Transaction> transaction, Vector<std::unique_ptr<MicroOcpp::MeterValue>> transactionData);
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
@@ -42,7 +42,7 @@ class StopTransaction : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 };
 
 } //end namespace Ocpp16
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
index 92a7e686..a9e74a2f 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.cpp
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -11,11 +11,11 @@
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Debug.h>
 
-using MicroOcpp::Ocpp201::TransactionEvent;
 using namespace MicroOcpp::Ocpp201;
+using MicroOcpp::JsonDoc;
 
 TransactionEvent::TransactionEvent(Model& model, std::shared_ptr<TransactionEventData> txEvent)
-        : model(model), txEvent(txEvent) {
+        : MemoryManaged("v201.Operation.", "TransactionEvent"), model(model), txEvent(txEvent) {
 
 }
 
@@ -23,13 +23,13 @@ const char* TransactionEvent::getOperationType() {
     return "TransactionEvent";
 }
 
-std::unique_ptr<DynamicJsonDocument> TransactionEvent::createReq() {
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+std::unique_ptr<JsonDoc> TransactionEvent::createReq() {
+    auto doc = makeJsonDoc(getMemoryTag(),
                 JSON_OBJECT_SIZE(12) + //total of 12 fields
                 JSONDATE_LENGTH + 1 + //timestamp string
                 JSON_OBJECT_SIZE(5) + //transactionInfo
                     MO_TXID_LEN_MAX + 1 + //transactionId
-                MO_IDTOKEN_LEN_MAX + 1)); //idToken
+                MO_IDTOKEN_LEN_MAX + 1); //idToken
                 //meterValue not supported
     JsonObject payload = doc->to<JsonObject>();
 
@@ -277,7 +277,7 @@ void TransactionEvent::processReq(JsonObject payload) {
      */
 }
 
-std::unique_ptr<DynamicJsonDocument> TransactionEvent::createConf() {
+std::unique_ptr<JsonDoc> TransactionEvent::createConf() {
     return createEmptyDocument();
 }
 
diff --git a/src/MicroOcpp/Operations/TransactionEvent.h b/src/MicroOcpp/Operations/TransactionEvent.h
index dcedb63e..0df02ba0 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.h
+++ b/src/MicroOcpp/Operations/TransactionEvent.h
@@ -19,7 +19,7 @@ namespace Ocpp201 {
 
 class TransactionEventData;
 
-class TransactionEvent : public Operation {
+class TransactionEvent : public Operation, public MemoryManaged {
 private:
     Model& model;
     std::shared_ptr<TransactionEventData> txEvent;
@@ -31,7 +31,7 @@ class TransactionEvent : public Operation {
 
     const char* getOperationType() override;
 
-    std::unique_ptr<DynamicJsonDocument> createReq() override;
+    std::unique_ptr<JsonDoc> createReq() override;
 
     void processConf(JsonObject payload) override;
 
@@ -39,7 +39,7 @@ class TransactionEvent : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 };
 
 } //end namespace Ocpp201
diff --git a/src/MicroOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
index 431f2a57..518353a0 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.cpp
+++ b/src/MicroOcpp/Operations/TriggerMessage.cpp
@@ -12,8 +12,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::TriggerMessage;
+using MicroOcpp::JsonDoc;
 
-TriggerMessage::TriggerMessage(Context& context) : context(context) {
+TriggerMessage::TriggerMessage(Context& context) : MemoryManaged("v16.Operation.", "TriggerMessage"), context(context) {
 
 }
 
@@ -80,8 +81,8 @@ void TriggerMessage::processReq(JsonObject payload) {
     }
 }
 
-std::unique_ptr<DynamicJsonDocument> TriggerMessage::createConf(){
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+std::unique_ptr<JsonDoc> TriggerMessage::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = statusMessage;
     return doc;
diff --git a/src/MicroOcpp/Operations/TriggerMessage.h b/src/MicroOcpp/Operations/TriggerMessage.h
index 4b8af068..7869e5a5 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.h
+++ b/src/MicroOcpp/Operations/TriggerMessage.h
@@ -6,8 +6,7 @@
 #define MO_TRIGGERMESSAGE_H
 
 #include <MicroOcpp/Core/Operation.h>
-
-#include <vector>
+#include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
@@ -15,7 +14,7 @@ class Context;
 
 namespace Ocpp16 {
 
-class TriggerMessage : public Operation {
+class TriggerMessage : public Operation, public MemoryManaged {
 private:
     Context& context;
     const char *statusMessage = nullptr;
@@ -28,7 +27,7 @@ class TriggerMessage : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index 537ee3b4..87cc03f6 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -7,8 +7,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::UnlockConnector;
+using MicroOcpp::JsonDoc;
 
-UnlockConnector::UnlockConnector(Model& model) : model(model) {
+UnlockConnector::UnlockConnector(Model& model) : MemoryManaged("v16.Operation.", "UnlockConnector"), model(model) {
   
 }
 
@@ -46,7 +47,7 @@ void UnlockConnector::processReq(JsonObject payload) {
 #endif //MO_ENABLE_CONNECTOR_LOCK
 }
 
-std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
+std::unique_ptr<JsonDoc> UnlockConnector::createConf() {
 
     const char *status = "NotSupported";
 
@@ -72,7 +73,7 @@ std::unique_ptr<DynamicJsonDocument> UnlockConnector::createConf() {
     }
 #endif //MO_ENABLE_CONNECTOR_LOCK
 
-    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
     payload["status"] = status;
     return doc;
diff --git a/src/MicroOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
index bf49d195..44b41bb9 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.h
+++ b/src/MicroOcpp/Operations/UnlockConnector.h
@@ -15,7 +15,7 @@ class Model;
 
 namespace Ocpp16 {
 
-class UnlockConnector : public Operation {
+class UnlockConnector : public Operation, public MemoryManaged {
 private:
     Model& model;
 
@@ -33,7 +33,7 @@ class UnlockConnector : public Operation {
 
     void processReq(JsonObject payload) override;
 
-    std::unique_ptr<DynamicJsonDocument> createConf() override;
+    std::unique_ptr<JsonDoc> createConf() override;
 
     const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.cpp b/src/MicroOcpp/Operations/UpdateFirmware.cpp
index 52cb9683..d9be551f 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.cpp
+++ b/src/MicroOcpp/Operations/UpdateFirmware.cpp
@@ -8,8 +8,9 @@
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp16::UpdateFirmware;
+using MicroOcpp::JsonDoc;
 
-UpdateFirmware::UpdateFirmware(FirmwareService& fwService) : fwService(fwService) {
+UpdateFirmware::UpdateFirmware(FirmwareService& fwService) : MemoryManaged("v16.Operation.", "UpdateFirmware"), fwService(fwService) {
 
 }
 
@@ -45,6 +46,6 @@ void UpdateFirmware::processReq(JsonObject payload) {
     fwService.scheduleFirmwareUpdate(location, retrieveDate, (unsigned int) retries, (unsigned int) retryInterval);
 }
 
-std::unique_ptr<DynamicJsonDocument> UpdateFirmware::createConf(){
+std::unique_ptr<JsonDoc> UpdateFirmware::createConf(){
     return createEmptyDocument();
 }
diff --git a/src/MicroOcpp/Operations/UpdateFirmware.h b/src/MicroOcpp/Operations/UpdateFirmware.h
index 0b4721f7..da962141 100644
--- a/src/MicroOcpp/Operations/UpdateFirmware.h
+++ b/src/MicroOcpp/Operations/UpdateFirmware.h
@@ -14,7 +14,7 @@ class FirmwareService;
 
 namespace Ocpp16 {
 
-class UpdateFirmware : public Operation {
+class UpdateFirmware : public Operation, public MemoryManaged {
 private:
   FirmwareService& fwService;
 
@@ -26,7 +26,7 @@ class UpdateFirmware : public Operation {
 
   void processReq(JsonObject payload) override;
 
-  std::unique_ptr<DynamicJsonDocument> createConf() override;
+  std::unique_ptr<JsonDoc> createConf() override;
 
   const char *getErrorCode() override {return errorCode;}
 };
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 04aa5091..4c5b6317 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -6,6 +6,7 @@
 #include "MicroOcpp.h"
 
 #include <MicroOcpp/Model/Certificates/Certificate_c.h>
+#include <MicroOcpp/Core/Memory.h>
 
 #include <MicroOcpp/Platform.h>
 #include <MicroOcpp/Debug.h>
@@ -363,7 +364,7 @@ void ocpp_set_console_out_c(void (*console_out)(const char *msg)) {
 
 void ocpp_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
     
-    std::string idTag_capture = idTag;
+    auto idTag_capture = MicroOcpp::makeString("MicroOcpp_c.cpp", idTag);
 
     authorize(idTag,
             onConfirmation ? [onConfirmation, idTag_capture, user_data] (JsonObject payload) {
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 2de67703..ab0888c2 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -10,7 +10,7 @@
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Debug.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
@@ -78,13 +78,13 @@ TEST_CASE( "C++ API test" ) {
         setOnSendConf("StatusNotification", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
         sendRequest("DataTransfer", [c = &checkpoints[ncheck++]] () {
             *c = true;
-            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            auto doc = MicroOcpp::makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
             doc->to<JsonObject>();
             return doc;
         }, [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;});
         setRequestHandler("DataTransfer", [c = &checkpoints[ncheck++]] (JsonObject) {*c = true;}, [c = &checkpoints[ncheck++]] () {
             *c = true;
-            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            auto doc = MicroOcpp::makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
             doc->to<JsonObject>();
             return doc;
         });
@@ -145,13 +145,13 @@ TEST_CASE( "C++ API test" ) {
         REQUIRE(isOperative());
 
         sendRequest("UnlockConnector", [] () {
-            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            auto doc = MicroOcpp::makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
             (*doc)["connectorId"] = 1;
             return doc;
         }, [] (JsonObject) {});
 
         sendRequest("Reset", [] () {
-            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            auto doc = MicroOcpp::makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
             (*doc)["type"] = "Hard";
             return doc;
         }, [] (JsonObject) {});
@@ -333,18 +333,18 @@ TEST_CASE( "C API test" ) {
         REQUIRE(ocpp_isOperative_m(2));
 
         sendRequest("UnlockConnector", [] () {
-            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            auto doc = MicroOcpp::makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
             (*doc)["connectorId"] = 1;
             return doc;
         }, [] (JsonObject) {});
         sendRequest("UnlockConnector", [] () {
-            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            auto doc = MicroOcpp::makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
             (*doc)["connectorId"] = 2;
             return doc;
         }, [] (JsonObject) {});
 
         sendRequest("Reset", [] () {
-            auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+            auto doc = MicroOcpp::makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
             (*doc)["type"] = "Hard";
             return doc;
         }, [] (JsonObject) {});
diff --git a/tests/Certificates.cpp b/tests/Certificates.cpp
index 9267705a..79d0b967 100644
--- a/tests/Certificates.cpp
+++ b/tests/Certificates.cpp
@@ -8,7 +8,7 @@
 
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #include <MicroOcpp/Core/Context.h>
@@ -109,7 +109,7 @@ TEST_CASE( "M - Certificates" ) {
         auto ret1 = certs->installCertificate(InstallCertificateType_CSMSRootCertificate, root_cert);
         REQUIRE(ret1 == InstallCertificateStatus_Accepted);
 
-        std::vector<CertificateChainHash> chain;
+        auto chain = makeVector<CertificateChainHash>("UnitTests");
         auto ret2 = certs->getCertificateIds({GetCertificateIdType_CSMSRootCertificate}, chain);
 
         REQUIRE(ret2 == GetInstalledCertificateStatus_Accepted);
@@ -140,7 +140,7 @@ TEST_CASE( "M - Certificates" ) {
         auto ret1 = certs->installCertificate(InstallCertificateType_CSMSRootCertificate, root_cert);
         REQUIRE(ret1 == InstallCertificateStatus_Accepted);
 
-        std::vector<CertificateChainHash> chain;
+        auto chain = makeVector<CertificateChainHash>("UnitTests");
         auto ret2 = certs->getCertificateIds({GetCertificateIdType_CSMSRootCertificate}, chain);
         REQUIRE(ret2 == GetInstalledCertificateStatus_Accepted);
 
@@ -167,8 +167,8 @@ TEST_CASE( "M - Certificates" ) {
                 "InstallCertificate",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests",
+                            JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["certificateType"] = "CSMSRootCertificate"; //of InstallCertificateTypeEnumType
                     payload["certificate"] = root_cert;
@@ -199,8 +199,8 @@ TEST_CASE( "M - Certificates" ) {
                 "DeleteCertificate",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(4)));
+                    auto doc = makeJsonDoc("UnitTests",
+                            JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(4));
                     auto payload = doc->to<JsonObject>();
                     payload["certificateHashData"]["hashAlgorithm"] = root_cert_hash_algorithm; //of HashAlgorithmType
                     payload["certificateHashData"]["issuerNameHash"] = root_cert_hash_issuer_name;
@@ -227,8 +227,8 @@ TEST_CASE( "M - Certificates" ) {
                 "GetInstalledCertificateIds",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests",
+                            JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["certificateType"][0] = "CSMSRootCertificate"; //of GetCertificateIdTypeEnumType
                     return doc;},
diff --git a/tests/ChargePointError.cpp b/tests/ChargePointError.cpp
index 3fe9a472..5f498de6 100644
--- a/tests/ChargePointError.cpp
+++ b/tests/ChargePointError.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #include <MicroOcpp/Core/Context.h>
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 5c35362b..9401a4f1 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -13,7 +13,7 @@
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
 #include <MicroOcpp/Debug.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
@@ -52,7 +52,7 @@ TEST_CASE( "Charging sessions" ) {
     SECTION("Check idle state"){
 
         bool checkedBN = false;
-        checkMsg.registerOperation("BootNotification", [engine] () -> Operation* {return new Ocpp16::BootNotification(engine->getModel(), std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(0)));});
+        checkMsg.registerOperation("BootNotification", [engine] () -> Operation* {return new Ocpp16::BootNotification(engine->getModel(), makeJsonDoc("UnitTests"));});
         checkMsg.setOnRequest("BootNotification",
             [&checkedBN] (JsonObject request) {
                 checkedBN = !strcmp(request["chargePointModel"] | "Invalid", "test-runner1234");
@@ -392,7 +392,7 @@ TEST_CASE( "Charging sessions" ) {
                 [] (JsonObject payload) {}, //ignore req
                 [&txId_generate] () {
                     //create conf
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2));
                     JsonObject payload = doc->to<JsonObject>();
 
                     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
@@ -472,7 +472,7 @@ TEST_CASE( "Charging sessions" ) {
                 [] (JsonObject payload) {}, //ignore req
                 [&txId_generate] () {
                     //create conf
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2));
                     JsonObject payload = doc->to<JsonObject>();
 
                     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
@@ -588,7 +588,7 @@ TEST_CASE( "Charging sessions" ) {
                 },
                 [] () {
                     //create conf
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2));
                     JsonObject payload = doc->to<JsonObject>();
 
                     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
@@ -634,7 +634,7 @@ TEST_CASE( "Charging sessions" ) {
                 "ChangeAvailability",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["connectorId"] = 1;
                     payload["type"] = "Inoperative";
@@ -689,7 +689,7 @@ TEST_CASE( "Charging sessions" ) {
             new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["connectorId"] = 1;
                     return doc;
@@ -716,7 +716,7 @@ TEST_CASE( "Charging sessions" ) {
             new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["connectorId"] = 1;
                     return doc;
@@ -741,7 +741,7 @@ TEST_CASE( "Charging sessions" ) {
             new MicroOcpp::Ocpp16::CustomOperation("UnlockConnector",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["connectorId"] = 1;
                     return doc;
@@ -833,7 +833,7 @@ TEST_CASE( "Charging sessions" ) {
                 },
                 [&txId] () {
                     //create conf
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2));
                     JsonObject payload = doc->to<JsonObject>();
 
                     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
@@ -962,7 +962,7 @@ TEST_CASE( "Charging sessions" ) {
                 },
                 [&txId] () {
                     //create conf
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2));
                     JsonObject payload = doc->to<JsonObject>();
 
                     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
@@ -1030,7 +1030,7 @@ TEST_CASE( "Charging sessions" ) {
                 },
                 [&txId] () {
                     //create conf
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1) + JSON_OBJECT_SIZE(2));
                     JsonObject payload = doc->to<JsonObject>();
 
                     JsonObject idTagInfo = payload.createNestedObject("idTagInfo");
diff --git a/tests/Configuration.cpp b/tests/Configuration.cpp
index 57aa8107..91fa1e28 100644
--- a/tests/Configuration.cpp
+++ b/tests/Configuration.cpp
@@ -6,7 +6,7 @@
 
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
@@ -288,7 +288,7 @@ TEST_CASE( "Configuration" ) {
                 "GetConfiguration",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     doc->to<JsonObject>();
                     return doc;},
                 [&checkProcessed] (JsonObject payload) {
@@ -325,7 +325,7 @@ TEST_CASE( "Configuration" ) {
                 "GetConfiguration",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     auto key = payload.createNestedArray("key");
                     key.add(KNOWN_KEY);
@@ -379,7 +379,7 @@ TEST_CASE( "Configuration" ) {
                 "ChangeConfiguration",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = KNOWN_KEY;
                     payload["value"] = "1234";
@@ -401,7 +401,7 @@ TEST_CASE( "Configuration" ) {
                 "ChangeConfiguration",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = UNKOWN_KEY;
                     payload["value"] = "no effect";
@@ -422,7 +422,7 @@ TEST_CASE( "Configuration" ) {
                 "ChangeConfiguration",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = KNOWN_KEY;
                     payload["value"] = "not convertible to int";
@@ -449,7 +449,7 @@ TEST_CASE( "Configuration" ) {
                 "ChangeConfiguration",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = KNOWN_KEY;
                     payload["value"] = "100234";
@@ -471,7 +471,7 @@ TEST_CASE( "Configuration" ) {
                 "ChangeConfiguration",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = KNOWN_KEY;
                     payload["value"] = "4321";
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 1d345c3d..4b14f733 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -11,7 +11,7 @@
 #include <MicroOcpp/Core/FilesystemUtils.h>
 #include <MicroOcpp/Debug.h>
 #include <MicroOcpp/Version.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 using namespace MicroOcpp;
@@ -25,8 +25,8 @@ class CustomAuthorize : public Operation {
     void processReq(JsonObject payload) override {
         //ignore payload - result is determined at construction time
     }
-    std::unique_ptr<DynamicJsonDocument> createConf() override {
-        auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+    std::unique_ptr<JsonDoc> createConf() override {
+        auto res = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
         auto payload = res->to<JsonObject>();
         payload["idTagInfo"]["status"] = status;
         return res;
@@ -42,8 +42,8 @@ class CustomStartTransaction : public Operation {
     void processReq(JsonObject payload) override {
         //ignore payload - result is determined at construction time
     }
-    std::unique_ptr<DynamicJsonDocument> createConf() override {
-        auto res = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2) + JSON_OBJECT_SIZE(1)));
+    std::unique_ptr<JsonDoc> createConf() override {
+        auto res = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2) + JSON_OBJECT_SIZE(1));
         auto payload = res->to<JsonObject>();
         payload["idTagInfo"]["status"] = status;
         payload["transactionId"] = 1000;
diff --git a/tests/FirmwareManagement.cpp b/tests/FirmwareManagement.cpp
index 20801dd8..5f11b8c4 100644
--- a/tests/FirmwareManagement.cpp
+++ b/tests/FirmwareManagement.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #include <MicroOcpp/Core/Context.h>
@@ -71,7 +71,7 @@ TEST_CASE( "FirmwareManagement" ) {
                 "UpdateFirmware",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(4));
                     auto payload = doc->to<JsonObject>();
                     payload["location"] = FTP_URL;
                     payload["retries"] = 1;
@@ -125,7 +125,7 @@ TEST_CASE( "FirmwareManagement" ) {
             if (checkProcessed == 0) {
                 if (checkProcessedOnDownloadStatus == 0) checkProcessedOnDownloadStatus = 1;
                 return DownloadStatus::NotDownloaded;
-            } else if (checkProcessed >= 1) {
+            } else {
                 if (checkProcessedOnDownloadStatus == 1) checkProcessedOnDownloadStatus = 2;
                 return DownloadStatus::Downloaded;
             }
@@ -135,7 +135,7 @@ TEST_CASE( "FirmwareManagement" ) {
                 "UpdateFirmware",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(4));
                     auto payload = doc->to<JsonObject>();
                     payload["location"] = FTP_URL;
                     payload["retries"] = 1;
@@ -192,7 +192,7 @@ TEST_CASE( "FirmwareManagement" ) {
             if (checkProcessed == 0) {
                 if (checkProcessedOnInstallStatus == 0) checkProcessedOnInstallStatus = 1;
                 return InstallationStatus::NotInstalled;
-            } else if (checkProcessed >= 1) {
+            } else {
                 if (checkProcessedOnInstallStatus == 1) checkProcessedOnInstallStatus = 2;
                 return InstallationStatus::Installed;
             }
@@ -202,7 +202,7 @@ TEST_CASE( "FirmwareManagement" ) {
                 "UpdateFirmware",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(4));
                     auto payload = doc->to<JsonObject>();
                     payload["location"] = FTP_URL;
                     payload["retries"] = 1;
@@ -262,7 +262,7 @@ TEST_CASE( "FirmwareManagement" ) {
             if (checkProcessed == 0) {
                 if (checkProcessedOnDownloadStatus == 0) checkProcessedOnDownloadStatus = 1;
                 return DownloadStatus::NotDownloaded;
-            } else if (checkProcessed >= 1) {
+            } else {
                 if (checkProcessedOnDownloadStatus == 1) checkProcessedOnDownloadStatus = 2;
                 return DownloadStatus::Downloaded;
             }
@@ -279,7 +279,7 @@ TEST_CASE( "FirmwareManagement" ) {
             if (checkProcessed <= 2) {
                 if (checkProcessedOnInstallStatus == 0) checkProcessedOnInstallStatus = 1;
                 return InstallationStatus::NotInstalled;
-            } else if (checkProcessed >= 3) {
+            } else {
                 if (checkProcessedOnInstallStatus == 1) checkProcessedOnInstallStatus = 2;
                 return InstallationStatus::Installed;
             }
@@ -289,7 +289,7 @@ TEST_CASE( "FirmwareManagement" ) {
                 "UpdateFirmware",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(4));
                     auto payload = doc->to<JsonObject>();
                     payload["location"] = FTP_URL;
                     payload["retries"] = 1;
@@ -357,7 +357,7 @@ TEST_CASE( "FirmwareManagement" ) {
             } else if (checkProcessed == 2) {
                 if (checkProcessedOnDownloadStatus == 2) checkProcessedOnDownloadStatus = 3;
                 return DownloadStatus::NotDownloaded;
-            } else if (checkProcessed >= 3) {
+            } else {
                 if (checkProcessedOnDownloadStatus == 3) checkProcessedOnDownloadStatus = 4;
                 return DownloadStatus::DownloadFailed;
             }
@@ -373,7 +373,7 @@ TEST_CASE( "FirmwareManagement" ) {
                 "UpdateFirmware",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(4));
                     auto payload = doc->to<JsonObject>();
                     payload["location"] = FTP_URL;
                     payload["retries"] = 2;
@@ -442,7 +442,7 @@ TEST_CASE( "FirmwareManagement" ) {
             } else if (checkProcessed == 2) {
                 if (checkProcessedOnInstallStatus == 2) checkProcessedOnInstallStatus = 3;
                 return InstallationStatus::NotInstalled;
-            } else if (checkProcessed >= 3) {
+            } else {
                 if (checkProcessedOnInstallStatus == 3) checkProcessedOnInstallStatus = 4;
                 return InstallationStatus::InstallationFailed;
             }
@@ -452,7 +452,7 @@ TEST_CASE( "FirmwareManagement" ) {
                 "UpdateFirmware",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(4));
                     auto payload = doc->to<JsonObject>();
                     payload["location"] = FTP_URL;
                     payload["retries"] = 2;
@@ -514,7 +514,7 @@ TEST_CASE( "FirmwareManagement" ) {
             if (checkProcessed == 0) {
                 if (checkProcessedOnDownloadStatus == 0) checkProcessedOnDownloadStatus = 1;
                 return DownloadStatus::NotDownloaded;
-            } else if (checkProcessed >= 1) {
+            } else {
                 if (checkProcessedOnDownloadStatus == 1) checkProcessedOnDownloadStatus = 2;
                 return DownloadStatus::Downloaded;
             }
@@ -531,7 +531,7 @@ TEST_CASE( "FirmwareManagement" ) {
             if (checkProcessed <= 2) {
                 if (checkProcessedOnInstallStatus == 0) checkProcessedOnInstallStatus = 1;
                 return InstallationStatus::NotInstalled;
-            } else if (checkProcessed >= 3) {
+            } else {
                 if (checkProcessedOnInstallStatus == 1) checkProcessedOnInstallStatus = 2;
                 return InstallationStatus::Installed;
             }
@@ -541,7 +541,7 @@ TEST_CASE( "FirmwareManagement" ) {
                 "UpdateFirmware",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(4)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(4));
                     auto payload = doc->to<JsonObject>();
                     payload["location"] = FTP_URL;
                     payload["retries"] = 1;
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index 866567e3..86ac08a6 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -8,7 +8,7 @@
 
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #include <MicroOcpp/Core/Context.h>
@@ -409,7 +409,7 @@ TEST_CASE( "LocalAuth" ) {
                 [] (JsonObject) {}, //ignore req
                 [] () {
                     //create conf
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["idTagInfo"]["status"] = "Blocked";
                     return doc;
@@ -454,7 +454,7 @@ TEST_CASE( "LocalAuth" ) {
                 },
                 [] () {
                     //create conf
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["idTagInfo"]["status"] = "Blocked";
                     return doc;
@@ -469,8 +469,8 @@ TEST_CASE( "LocalAuth" ) {
                 },
                 [] () {
                     //create conf
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            JSON_OBJECT_SIZE(2) + JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", 
+                            JSON_OBJECT_SIZE(2) + JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["idTagInfo"]["status"] = "Blocked";
                     payload["transactionId"] = 1000;
@@ -642,7 +642,7 @@ TEST_CASE( "LocalAuth" ) {
 
         int listVersion = 42;
         size_t listSize = 2;
-        std::string populatedEntryIdTag; //local auth list entry to be fully populated
+        auto populatedEntryIdTag = makeString("UnitTests"); //local auth list entry to be fully populated
         
         //Full update - happy path
         bool checkAccepted = false;
@@ -650,8 +650,8 @@ TEST_CASE( "LocalAuth" ) {
             new Ocpp16::CustomOperation("SendLocalList",
                 [&listVersion, &listSize, &populatedEntryIdTag] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            4096));
+                    auto doc = makeJsonDoc("UnitTests", 
+                            4096);
                     auto payload = doc->to<JsonObject>();
                     payload["listVersion"] = listVersion;
                     generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSize, false);
@@ -693,8 +693,8 @@ TEST_CASE( "LocalAuth" ) {
             new Ocpp16::CustomOperation("SendLocalList",
                 [&listVersion, &listSize] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            1024));
+                    auto doc = makeJsonDoc("UnitTests", 
+                            1024);
                     auto payload = doc->to<JsonObject>();
                     payload["listVersion"] = listVersion;
                     generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSize, false);
@@ -719,8 +719,8 @@ TEST_CASE( "LocalAuth" ) {
             new Ocpp16::CustomOperation("SendLocalList",
                 [&listVersion, &listSizeInvalid] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            1024));
+                    auto doc = makeJsonDoc("UnitTests", 
+                            1024);
                     auto payload = doc->to<JsonObject>();
                     payload["listVersion"] = listVersion;
                     generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSizeInvalid, false);
@@ -746,8 +746,8 @@ TEST_CASE( "LocalAuth" ) {
             new Ocpp16::CustomOperation("SendLocalList",
                 [&listVersion, &listSize] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            4096));
+                    auto doc = makeJsonDoc("UnitTests", 
+                            4096);
                     auto payload = doc->to<JsonObject>();
                     payload["listVersion"] = listVersion;
                     generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSize, false);
@@ -772,8 +772,8 @@ TEST_CASE( "LocalAuth" ) {
             new Ocpp16::CustomOperation("SendLocalList",
                 [&listVersion, &listSize] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            4096));
+                    auto doc = makeJsonDoc("UnitTests", 
+                            4096);
                     auto payload = doc->to<JsonObject>();
                     payload["listVersion"] = listVersion;
                     generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSize, false);
@@ -799,8 +799,8 @@ TEST_CASE( "LocalAuth" ) {
             new Ocpp16::CustomOperation("SendLocalList",
                 [&listVersionInvalid, &listSizeInvalid] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            4096));
+                    auto doc = makeJsonDoc("UnitTests", 
+                            4096);
                     auto payload = doc->to<JsonObject>();
                     payload["listVersion"] = listVersionInvalid;
                     generateAuthList(payload["localAuthorizationList"].to<JsonArray>(), listSizeInvalid, false);
@@ -835,8 +835,8 @@ TEST_CASE( "LocalAuth" ) {
                 new Ocpp16::CustomOperation("SendLocalList",
                     [&i] () {
                         //create req
-                        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                                1024));
+                        auto doc = makeJsonDoc("UnitTests", 
+                                1024);
                         auto payload = doc->to<JsonObject>();
                         payload["listVersion"] = (int) i;
 
@@ -873,8 +873,8 @@ TEST_CASE( "LocalAuth" ) {
             new Ocpp16::CustomOperation("SendLocalList",
                 [&listVersionInvalid] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
-                            1024));
+                    auto doc = makeJsonDoc("UnitTests", 
+                            1024);
                     auto payload = doc->to<JsonObject>();
                     payload["listVersion"] = listVersionInvalid;
 
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 3a542d5c..144d4a37 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -7,7 +7,7 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Configuration.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
@@ -49,7 +49,7 @@ TEST_CASE("Metering") {
         sendRequest("ChangeConfiguration",
             [] () {
                 //create req
-                auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                 auto payload = doc->to<JsonObject>();
                 payload["key"] = "MeterValuesSampledData";
                 payload["value"] = "Energy.Active.Import.Register,INVALID,Voltage"; //invalid request
@@ -69,7 +69,7 @@ TEST_CASE("Metering") {
         sendRequest("ChangeConfiguration",
             [] () {
                 //create req
-                auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                 auto payload = doc->to<JsonObject>();
                 payload["key"] = "MeterValuesSampledData";
                 payload["value"] = "Voltage,Energy.Active.Import.Register"; //valid request
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index 1b36f077..b25db0e2 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -8,7 +8,7 @@
 
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #include <MicroOcpp/Core/Context.h>
@@ -92,7 +92,7 @@ TEST_CASE( "Reservation" ) {
                 "RemoteStartTransaction",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["idTag"] = "wrong idTag";
                     return doc;},
@@ -115,7 +115,7 @@ TEST_CASE( "Reservation" ) {
                 "RemoteStartTransaction",
                 [idTag] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["idTag"] = idTag;
                     return doc;},
@@ -177,9 +177,9 @@ TEST_CASE( "Reservation" ) {
                     [parentIdTag, &checkProcessed] () {
                         //create conf
                         checkProcessed = true;
-                        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                        auto doc = makeJsonDoc("UnitTests", 
                                 JSON_OBJECT_SIZE(1) + //payload root
-                                JSON_OBJECT_SIZE(3))); //idTagInfo
+                                JSON_OBJECT_SIZE(3)); //idTagInfo
                         auto payload = doc->to<JsonObject>();
                         payload["idTagInfo"]["parentIdTag"] = parentIdTag;
                         payload["idTagInfo"]["status"] = "Accepted";
@@ -319,9 +319,9 @@ TEST_CASE( "Reservation" ) {
                 "ReserveNow",
                 [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                    auto doc = makeJsonDoc("UnitTests", 
                             JSON_OBJECT_SIZE(5) + 
-                            JSONDATE_LENGTH + 1));
+                            JSONDATE_LENGTH + 1);
                     auto payload = doc->to<JsonObject>();
                     payload["connectorId"] = connectorId;
                     char expiryDate_cstr [JSONDATE_LENGTH + 1];
@@ -355,9 +355,9 @@ TEST_CASE( "Reservation" ) {
                 "ReserveNow",
                 [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                    auto doc = makeJsonDoc("UnitTests", 
                             JSON_OBJECT_SIZE(5) + 
-                            JSONDATE_LENGTH + 1));
+                            JSONDATE_LENGTH + 1);
                     auto payload = doc->to<JsonObject>();
                     payload["connectorId"] = connectorId;
                     char expiryDate_cstr [JSONDATE_LENGTH + 1];
@@ -390,9 +390,9 @@ TEST_CASE( "Reservation" ) {
                 "ReserveNow",
                 [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                    auto doc = makeJsonDoc("UnitTests", 
                             JSON_OBJECT_SIZE(5) + 
-                            JSONDATE_LENGTH + 1));
+                            JSONDATE_LENGTH + 1);
                     auto payload = doc->to<JsonObject>();
                     payload["connectorId"] = connectorId;
                     char expiryDate_cstr [JSONDATE_LENGTH + 1];
@@ -427,9 +427,9 @@ TEST_CASE( "Reservation" ) {
                 "ReserveNow",
                 [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(
+                    auto doc = makeJsonDoc("UnitTests", 
                             JSON_OBJECT_SIZE(5) + 
-                            JSONDATE_LENGTH + 1));
+                            JSONDATE_LENGTH + 1);
                     auto payload = doc->to<JsonObject>();
                     payload["connectorId"] = connectorId;
                     char expiryDate_cstr [JSONDATE_LENGTH + 1];
@@ -473,7 +473,7 @@ TEST_CASE( "Reservation" ) {
                 "CancelReservation",
                 [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["reservationId"] = reservationId;
                     return doc;},
@@ -494,7 +494,7 @@ TEST_CASE( "Reservation" ) {
                 "CancelReservation",
                 [reservationId, connectorId, expiryDate, idTag, parentIdTag] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["reservationId"] = reservationId;
                     return doc;},
diff --git a/tests/Reset.cpp b/tests/Reset.cpp
index d1607eb8..8036393f 100644
--- a/tests/Reset.cpp
+++ b/tests/Reset.cpp
@@ -15,7 +15,7 @@
 #include <MicroOcpp/Model/Variables/VariableService.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Debug.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
@@ -94,7 +94,7 @@ TEST_CASE( "Reset" ) {
                 "Reset",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["type"] = "OnIdle";
                     return doc;},
@@ -193,7 +193,7 @@ TEST_CASE( "Reset" ) {
                 "Reset",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["type"] = "Immediate";
                     return doc;},
@@ -245,7 +245,7 @@ TEST_CASE( "Reset" ) {
                 "Reset",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     payload["type"] = "Immediate";
                     return doc;},
@@ -277,7 +277,7 @@ TEST_CASE( "Reset" ) {
                 "Reset",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["type"] = "OnIdle";
                     payload["evseId"] = 1;
diff --git a/tests/SmartCharging.cpp b/tests/SmartCharging.cpp
index c92c5dcf..7cf53b32 100644
--- a/tests/SmartCharging.cpp
+++ b/tests/SmartCharging.cpp
@@ -10,7 +10,7 @@
 #include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
@@ -476,7 +476,7 @@ TEST_CASE( "SmartCharging" ) {
                 "GetCompositeSchedule",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(3)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(3));
                     auto payload = doc->to<JsonObject>();
                     payload["connectorId"] = 1;
                     payload["duration"] = 86400;
@@ -554,7 +554,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     return doc;},
                 [&checkProcessed] (JsonObject response) {
@@ -572,7 +572,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_0_ALT_SAME_ID);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     (*doc)["connectorId"] = 2;
                     return doc;},
@@ -591,7 +591,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_1_ABSOLUTE_LIMIT_16A);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     return doc;},
                 [&checkProcessed] (JsonObject response) {
@@ -614,7 +614,7 @@ TEST_CASE( "SmartCharging" ) {
                         //create req
                         StaticJsonDocument<2048> raw;
                         deserializeJson(raw, SCPROFILE_1_ABSOLUTE_LIMIT_16A);
-                        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                        auto doc = makeJsonDoc("UnitTests", 2048);
                         *doc = raw[3];
                         return doc;},
                     [&checkProcessed] (JsonObject response) {
@@ -636,7 +636,7 @@ TEST_CASE( "SmartCharging" ) {
                         //create req
                         StaticJsonDocument<2048> raw;
                         deserializeJson(raw, SCPROFILE_5_VALID_UNTIL_2022_16A);
-                        auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                        auto doc = makeJsonDoc("UnitTests", 2048);
                         *doc = raw[3];
                         return doc;},
                     [&checkProcessed] (JsonObject response) {
@@ -660,7 +660,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     (*doc)["csChargingProfiles"]["stackLevel"] = MO_ChargeProfileMaxStackLevel;
                     return doc;},
@@ -679,7 +679,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     (*doc)["csChargingProfiles"]["stackLevel"] = MO_ChargeProfileMaxStackLevel + 1;
                     return doc;},
@@ -705,7 +705,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     JsonArray chargingSchedulePeriod = (*doc)["csChargingProfiles"]["chargingSchedule"]["chargingSchedulePeriod"];
                     chargingSchedulePeriod.clear();
@@ -730,7 +730,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_2_RELATIVE_TXDEF_24A);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     JsonArray chargingSchedulePeriod = (*doc)["csChargingProfiles"]["chargingSchedule"]["chargingSchedulePeriod"];
                     chargingSchedulePeriod.clear();
@@ -766,7 +766,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_0);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     return doc;},
                 [&checkProcessed] (JsonObject response) {
@@ -784,7 +784,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_1_ABSOLUTE_LIMIT_16A);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     return doc;},
                 [&checkProcessed] (JsonObject response) {
@@ -806,7 +806,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_0);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     return doc;},
                 [&checkProcessed] (JsonObject response) {
@@ -824,7 +824,7 @@ TEST_CASE( "SmartCharging" ) {
                     //create req
                     StaticJsonDocument<2048> raw;
                     deserializeJson(raw, SCPROFILE_1_ABSOLUTE_LIMIT_16A);
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2048));
+                    auto doc = makeJsonDoc("UnitTests", 2048);
                     *doc = raw[3];
                     return doc;},
                 [&checkProcessed] (JsonObject response) {
diff --git a/tests/TransactionSafety.cpp b/tests/TransactionSafety.cpp
index 03eeb9f6..f3593e01 100644
--- a/tests/TransactionSafety.cpp
+++ b/tests/TransactionSafety.cpp
@@ -10,7 +10,7 @@
 #include <MicroOcpp/Operations/BootNotification.h>
 #include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Debug.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 using namespace MicroOcpp;
diff --git a/tests/Transactions.cpp b/tests/Transactions.cpp
index e32994be..aa4a3be9 100644
--- a/tests/Transactions.cpp
+++ b/tests/Transactions.cpp
@@ -13,7 +13,7 @@
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Debug.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
@@ -42,7 +42,7 @@ TEST_CASE( "Transactions" ) {
             [] (JsonObject) {}, //ignore req
             [] () {
                 //create conf
-                auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(2 * JSON_OBJECT_SIZE(1)));
+                auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
                 auto payload = doc->to<JsonObject>();
                 payload["idTokenInfo"]["status"] = "Accepted";
                 return doc;
diff --git a/tests/Variables.cpp b/tests/Variables.cpp
index aed483b3..6813dd11 100644
--- a/tests/Variables.cpp
+++ b/tests/Variables.cpp
@@ -8,7 +8,7 @@
 
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #include <MicroOcpp/Core/FilesystemAdapter.h>
@@ -277,7 +277,7 @@ TEST_CASE( "Variable" ) {
                 "GetVariables",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
                     auto payload = doc->to<JsonObject>();
                     return doc;},
                 [&checkProcessed] (JsonObject payload) {
@@ -314,7 +314,7 @@ TEST_CASE( "Variable" ) {
                 "GetVariable",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     auto key = payload.createNestedArray("key");
                     key.add(KNOWN_KEY);
@@ -368,7 +368,7 @@ TEST_CASE( "Variable" ) {
                 "ChangeVariable",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = KNOWN_KEY;
                     payload["value"] = "1234";
@@ -390,7 +390,7 @@ TEST_CASE( "Variable" ) {
                 "ChangeVariable",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = UNKOWN_KEY;
                     payload["value"] = "no effect";
@@ -411,7 +411,7 @@ TEST_CASE( "Variable" ) {
                 "ChangeVariable",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = KNOWN_KEY;
                     payload["value"] = "not convertible to int";
@@ -438,7 +438,7 @@ TEST_CASE( "Variable" ) {
                 "ChangeVariable",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = KNOWN_KEY;
                     payload["value"] = "100234";
@@ -460,7 +460,7 @@ TEST_CASE( "Variable" ) {
                 "ChangeVariable",
                 [] () {
                     //create req
-                    auto doc = std::unique_ptr<DynamicJsonDocument>(new DynamicJsonDocument(JSON_OBJECT_SIZE(2)));
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(2));
                     auto payload = doc->to<JsonObject>();
                     payload["key"] = KNOWN_KEY;
                     payload["value"] = "4321";
diff --git a/tests/helpers/testHelper.cpp b/tests/helpers/testHelper.cpp
index fc56e20b..ffc6fac5 100644
--- a/tests/helpers/testHelper.cpp
+++ b/tests/helpers/testHelper.cpp
@@ -2,7 +2,11 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <catch2/catch.hpp>
+#include <catch2/catch.hpp>
+
 #include <MicroOcpp.h>
+#include <MicroOcpp/Core/Memory.h>
 
 using namespace MicroOcpp;
 
@@ -17,3 +21,15 @@ void loop() {
         mocpp_loop();
     }
 }
+
+class TestRunListener : public Catch::TestEventListenerBase {
+public:
+    using Catch::TestEventListenerBase::TestEventListenerBase;
+
+    void testRunEnded( Catch::TestRunStats const& testRunStats ) override {
+        MO_MEM_PRINT_STATS();
+        MO_MEM_DEINIT();
+    }
+};
+
+CATCH_REGISTER_LISTENER(TestRunListener)
diff --git a/tests/ocppEngineLifecycle.cpp b/tests/ocppEngineLifecycle.cpp
index a6a84818..b3de2a18 100644
--- a/tests/ocppEngineLifecycle.cpp
+++ b/tests/ocppEngineLifecycle.cpp
@@ -4,7 +4,7 @@
 
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
-#include "./catch2/catch.hpp"
+#include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 TEST_CASE( "Context lifecycle" ) {

From a24cdbb377d5fff71ccc39d255b2e8e19d5e8eeb Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Wed, 14 Aug 2024 12:00:24 +0200
Subject: [PATCH 513/549] Fix Boot behavior regression bug (#353)

* avoid sending messages before BootNotification Accepted

* update changelog
---
 CHANGELOG.md                             |   1 +
 CMakeLists.txt                           |   1 +
 src/MicroOcpp/Core/RequestQueue.cpp      |  17 +-
 src/MicroOcpp/Core/RequestQueue.h        |   8 +-
 src/MicroOcpp/Model/Boot/BootService.cpp |  21 ++
 src/MicroOcpp/Model/Boot/BootService.h   |  13 +
 tests/Boot.cpp                           | 312 +++++++++++++++++++++++
 tests/helpers/testHelper.h               |   2 +
 8 files changed, 366 insertions(+), 9 deletions(-)
 create mode 100644 tests/Boot.cpp

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0ad9de8c..46857bce 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -40,6 +40,7 @@
 - Don't change into Unavailable upon Reset ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Reject DataTransfer by default ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - UnlockConnector NotSupported if connectorId invalid ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
+- Fix regression bug of [#345](https://github.com/matth-x/MicroOcpp/pull/345) ([#353](https://github.com/matth-x/MicroOcpp/pull/353))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index a3f085b1..ca91ef7d 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -148,6 +148,7 @@ set(MO_SRC_UNIT
     tests/Certificates.cpp
     tests/FirmwareManagement.cpp
     tests/ChargePointError.cpp
+    tests/Boot.cpp
 )
 
 add_executable(mo_unit_tests
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index 551175a7..383492aa 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -17,7 +17,7 @@ size_t removePayload(const char *src, size_t src_size, char *dst, size_t dst_siz
 
 using namespace MicroOcpp;
 
-VolatileRequestQueue::VolatileRequestQueue(unsigned int priority) : MemoryManaged("VolatileRequestQueue"), priority{priority} {
+VolatileRequestQueue::VolatileRequestQueue() : MemoryManaged("VolatileRequestQueue") {
 
 }
 
@@ -59,7 +59,7 @@ unsigned int VolatileRequestQueue::getFrontRequestOpNr() {
         return NoOperation;
     }
 
-    return priority;
+    return 1; //return OpNr 1 to grant PreBoot queue higher priority (=0), but send messages before tx-msg queue (starting with 10)
 }
 
 std::unique_ptr<Request> VolatileRequestQueue::fetchFrontRequest() {
@@ -128,7 +128,6 @@ RequestQueue::RequestQueue(Connection& connection, OperationRegistry& operationR
 
     memset(sendQueues, 0, sizeof(sendQueues));
     addSendQueue(&defaultSendQueue);
-    addSendQueue(&preBootSendQueue);
 }
 
 void RequestQueue::loop() {
@@ -149,7 +148,6 @@ void RequestQueue::loop() {
     }
 
     defaultSendQueue.loop();
-    preBootSendQueue.loop();
 
     if (!connection.isConnected()) {
         return;
@@ -234,7 +232,11 @@ void RequestQueue::sendRequest(std::unique_ptr<Request> op){
 }
 
 void RequestQueue::sendRequestPreBoot(std::unique_ptr<Request> op){
-    preBootSendQueue.pushRequestBack(std::move(op));
+    if (!preBootSendQueue) {
+        MO_DBG_ERR("did not set PreBoot queue");
+        return;
+    }
+    preBootSendQueue->pushRequestBack(std::move(op));
 }
 
 void RequestQueue::addSendQueue(RequestEmitter* sendQueue) {
@@ -247,6 +249,11 @@ void RequestQueue::addSendQueue(RequestEmitter* sendQueue) {
     MO_DBG_ERR("exceeded sendQueue capacity");
 }
 
+void RequestQueue::setPreBootSendQueue(VolatileRequestQueue *preBootQueue) {
+    this->preBootSendQueue = preBootQueue;
+    addSendQueue(preBootQueue);
+}
+
 unsigned int RequestQueue::getNextOpNr() {
     return nextOpNr++;
 }
diff --git a/src/MicroOcpp/Core/RequestQueue.h b/src/MicroOcpp/Core/RequestQueue.h
index 5213272e..1375ad90 100644
--- a/src/MicroOcpp/Core/RequestQueue.h
+++ b/src/MicroOcpp/Core/RequestQueue.h
@@ -39,9 +39,8 @@ class VolatileRequestQueue : public RequestEmitter, public MemoryManaged {
 private:
     std::unique_ptr<Request> requests [MO_REQUEST_CACHE_MAXSIZE];
     size_t front = 0, len = 0;
-    const unsigned int priority;
 public:
-    VolatileRequestQueue(unsigned int priority = 1);
+    VolatileRequestQueue();
     ~VolatileRequestQueue();
     void loop();
 
@@ -57,8 +56,8 @@ class RequestQueue : public MemoryManaged {
     OperationRegistry& operationRegistry;
 
     RequestEmitter* sendQueues [MO_NUM_REQUEST_QUEUES];
-    VolatileRequestQueue defaultSendQueue {1};
-    VolatileRequestQueue preBootSendQueue {0};
+    VolatileRequestQueue defaultSendQueue;
+    VolatileRequestQueue *preBootSendQueue = nullptr;
     std::unique_ptr<Request> sendReqFront;
 
     VolatileRequestQueue recvQueue;
@@ -85,6 +84,7 @@ class RequestQueue : public MemoryManaged {
     void sendRequestPreBoot(std::unique_ptr<Request> request); //send an OCPP operation request to the server; adds request to preBootQueue
 
     void addSendQueue(RequestEmitter* sendQueue);
+    void setPreBootSendQueue(VolatileRequestQueue *preBootQueue);
 
     unsigned int getNextOpNr();
 };
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index 3d027f03..cf569449 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -20,6 +20,18 @@
 
 using namespace MicroOcpp;
 
+unsigned int PreBootQueue::getFrontRequestOpNr() {
+    if (!activatedPostBootCommunication) {
+        return 0;
+    }
+
+    return VolatileRequestQueue::getFrontRequestOpNr();
+}
+
+void PreBootQueue::activatePostBootCommunication() {
+    activatedPostBootCommunication = true;
+}
+
 RegistrationStatus MicroOcpp::deserializeRegistrationStatus(const char *serialized) {
     if (!strcmp(serialized, "Accepted")) {
         return RegistrationStatus::Accepted;
@@ -35,6 +47,8 @@ RegistrationStatus MicroOcpp::deserializeRegistrationStatus(const char *serializ
 
 BootService::BootService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : MemoryManaged("v16.Boot.BootService"), context(context), filesystem(filesystem), cpCredentials{makeString(getMemoryTag())} {
     
+    context.getRequestQueue().setPreBootSendQueue(&preBootQueue); //register PreBootQueue in RequestQueue module
+    
     //if transactions can start before the BootNotification succeeds
     preBootTransactionsBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", false);
     
@@ -63,6 +77,13 @@ void BootService::loop() {
         storeBootStats(filesystem, bootstats);
     }
 
+    preBootQueue.loop();
+
+    if (!activatedPostBootCommunication && status == RegistrationStatus::Accepted) {
+        preBootQueue.activatePostBootCommunication();
+        activatedPostBootCommunication = true;
+    }
+
     if (!activatedModel && (status == RegistrationStatus::Accepted || preBootTransactionsBool->getBool())) {
         context.getModel().activateTasks();
         activatedModel = true;
diff --git a/src/MicroOcpp/Model/Boot/BootService.h b/src/MicroOcpp/Model/Boot/BootService.h
index e5144be1..dac4d91f 100644
--- a/src/MicroOcpp/Model/Boot/BootService.h
+++ b/src/MicroOcpp/Model/Boot/BootService.h
@@ -7,6 +7,7 @@
 
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/RequestQueue.h>
 #include <MicroOcpp/Core/Memory.h>
 #include <memory>
 
@@ -32,6 +33,15 @@ enum class RegistrationStatus {
 
 RegistrationStatus deserializeRegistrationStatus(const char *serialized);
 
+class PreBootQueue : public VolatileRequestQueue {
+private:
+    bool activatedPostBootCommunication = false;
+public:
+    unsigned int getFrontRequestOpNr() override; //override FrontRequestOpNr behavior: in PreBoot mode, always return 0 to avoid other RequestEmitters from sending msgs
+    
+    void activatePostBootCommunication(); //end PreBoot mode, now send Requests normally
+};
+
 class Context;
 
 class BootService : public MemoryManaged {
@@ -39,6 +49,8 @@ class BootService : public MemoryManaged {
     Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
 
+    PreBootQueue preBootQueue;
+
     unsigned long interval_s = MO_BOOT_INTERVAL_DEFAULT;
     unsigned long lastBootNotification = -1UL / 2;
 
@@ -49,6 +61,7 @@ class BootService : public MemoryManaged {
     std::shared_ptr<Configuration> preBootTransactionsBool;
 
     bool activatedModel = false;
+    bool activatedPostBootCommunication = false;
 
     unsigned long firstExecutionTimestamp = 0;
     bool executedFirstTime = false;
diff --git a/tests/Boot.cpp b/tests/Boot.cpp
new file mode 100644
index 00000000..7a76c803
--- /dev/null
+++ b/tests/Boot.cpp
@@ -0,0 +1,312 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Operations/BootNotification.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Debug.h>
+#include <catch2/catch.hpp>
+#include "./helpers/testHelper.h"
+
+#define CHARGEPOINTMODEL "Test model"
+#define CHARGEPOINTVENDOR "Test vendor"
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
+#define GET_CONFIGURATION "[2,\"msgId01\",\"GetConfiguration\",{\"key\":[]}]"
+#define TRIGGER_MESSAGE "[2,\"msgId02\",\"TriggerMessage\",{\"requestedMessage\":\"TriggeredOperation\"}]"
+
+using namespace MicroOcpp;
+
+//dummy operation type to test TriggerMessage
+class TriggeredOperation : public Operation {
+private:
+    bool& checkExecuted;
+public:
+    TriggeredOperation(bool& checkExecuted) : checkExecuted(checkExecuted) { }
+    const char* getOperationType() override {return "TriggeredOperation";}
+    std::unique_ptr<JsonDoc> createReq() override {
+        checkExecuted = true;
+        return createEmptyDocument();
+    }
+    void processConf(JsonObject) override {}
+    void processReq(JsonObject) override {}
+    std::unique_ptr<JsonDoc> createConf() override {return createEmptyDocument();}
+};
+
+
+TEST_CASE( "Boot Behavior" ) {
+    printf("\nRun %s\n",  "Boot Behavior");
+
+    //clean state
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
+    FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+
+
+    mocpp_initialize(loopback, ChargerCredentials(CHARGEPOINTMODEL, CHARGEPOINTVENDOR), filesystem);
+
+    mocpp_set_timer(custom_timer_cb);
+
+    SECTION("BootNotification - Accepted") {
+
+        bool checkProcessed = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("BootNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("BootNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        checkProcessed = true;
+                        REQUIRE( !strcmp(payload["chargePointModel"] | "_Undefined", CHARGEPOINTMODEL) );
+                        REQUIRE( !strcmp(payload["chargePointVendor"] | "_Undefined", CHARGEPOINTVENDOR) );
+                    },
+                    [] () {
+                        //create conf
+                        auto conf = makeJsonDoc(UNIT_MEM_TAG, 1024);
+                        (*conf)["currentTime"] = BASE_TIME;
+                        (*conf)["interval"] = 3600;
+                        (*conf)["status"] = "Accepted";
+                        return conf;
+                    });
+            });
+        
+        loop();
+
+        REQUIRE(checkProcessed);
+        REQUIRE(getOcppContext()->getModel().getClock().now() >= MIN_TIME);
+    }
+
+    SECTION("BootNotification - Pending") {
+
+        MO_DBG_INFO("Queue messages before BootNotification to see if they come through");
+
+        loop(); //normal BootNotification run
+
+        REQUIRE( isOperative() ); //normal BN succeeded
+
+        loopback.setOnline( false );
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        endTransaction();
+
+        mocpp_deinitialize();
+
+        loopback.setOnline( true );
+
+        MO_DBG_INFO("Start charger again with queued transaction messages, also init non-tx-related msg, but now delay BN procedure");
+
+        mocpp_initialize(loopback, ChargerCredentials());
+
+        getOcppContext()->getOperationRegistry().registerOperation("BootNotification",
+            [] () {
+                return new Ocpp16::CustomOperation("BootNotification",
+                    [] (JsonObject payload) {
+                        //ignore req
+                    },
+                    [] () {
+                        //create conf
+                        auto conf = makeJsonDoc(UNIT_MEM_TAG, 1024);
+                        (*conf)["currentTime"] = BASE_TIME;
+                        (*conf)["interval"] = 3600;
+                        (*conf)["status"] = "Pending";
+                        return conf;
+                    });
+            });
+
+        bool sentTxMsg = false;
+
+        getOcppContext()->getOperationRegistry().setOnRequest("StartTransaction",
+            [&sentTxMsg] (JsonObject) {
+                sentTxMsg = true;
+            });
+
+        getOcppContext()->getOperationRegistry().setOnRequest("StopTransaction",
+            [&sentTxMsg] (JsonObject) {
+                sentTxMsg = true;
+            });
+        
+        bool checkProcessedHeartbeat = false;
+
+        auto heartbeat = makeRequest(new Ocpp16::CustomOperation(
+                "Heartbeat",
+                [] () {
+                    //create req
+                    return createEmptyDocument();},
+                [&checkProcessedHeartbeat] (JsonObject) {
+                    //process conf
+                    checkProcessedHeartbeat = true;
+                }));
+        heartbeat->setTimeout(0); //disable timeout and check if message will be sent later
+        
+        getOcppContext()->initiateRequest(std::move(heartbeat));
+
+        bool sentNonTxMsg = false;
+
+        getOcppContext()->getOperationRegistry().setOnRequest("Heartbeat",
+            [&sentNonTxMsg] (JsonObject) {
+                sentNonTxMsg = true;
+            });
+
+        loop();
+
+        REQUIRE( !sentTxMsg );
+        REQUIRE( !sentNonTxMsg );
+        REQUIRE( !checkProcessedHeartbeat );
+
+        MO_DBG_INFO("Check if charger still responds to server-side messages and executes TriggerMessages");
+
+        bool reactedToServerMsg = false;
+
+        getOcppContext()->getOperationRegistry().setOnRequest("GetConfiguration",
+            [&reactedToServerMsg] (JsonObject) {
+                reactedToServerMsg = true;
+            });
+
+        loopback.sendTXT(GET_CONFIGURATION, sizeof(GET_CONFIGURATION) - 1);
+
+        loop();
+
+        REQUIRE( reactedToServerMsg );
+
+        bool executedTriggerMessage = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("TriggeredOperation",
+            [&executedTriggerMessage] () {return new TriggeredOperation(executedTriggerMessage);});
+        
+        loopback.sendTXT(TRIGGER_MESSAGE, sizeof(TRIGGER_MESSAGE) - 1);
+
+        loop();
+
+        REQUIRE( executedTriggerMessage );
+
+        //other messages still didn't get through?
+        REQUIRE( !sentTxMsg );
+        REQUIRE( !sentNonTxMsg );
+        REQUIRE( !checkProcessedHeartbeat );
+
+        MO_DBG_INFO("Now, accept BN and check if all queued messages finally arrive");
+
+        getOcppContext()->getOperationRegistry().registerOperation("BootNotification",
+            [] () {
+                return new Ocpp16::CustomOperation("BootNotification",
+                    [] (JsonObject payload) {
+                        //ignore req
+                    },
+                    [] () {
+                        //create conf
+                        auto conf = makeJsonDoc(UNIT_MEM_TAG, 1024);
+                        (*conf)["currentTime"] = BASE_TIME;
+                        (*conf)["interval"] = 3600;
+                        (*conf)["status"] = "Accepted";
+                        return conf;
+                    });
+            });
+
+        mtime += 3600 * 1000;
+
+        loop();
+
+        REQUIRE( sentTxMsg );
+        REQUIRE( sentNonTxMsg );
+        REQUIRE( checkProcessedHeartbeat );
+    }
+
+    SECTION("PreBoot transactions") {
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true)->setBool(true);
+        declareConfiguration<bool>("AllowOfflineTxForUnknownId", true)->setBool(true);
+
+        unsigned int startTxCount = 0;
+
+        getOcppContext()->getOperationRegistry().setOnRequest("StartTransaction",
+            [&startTxCount] (JsonObject) {
+                startTxCount++;
+            });
+
+        //start one transaction in full offline mode
+
+        loopback.setOnline( false );
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+
+        beginTransaction_authorized("mIdTag");
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging ); 
+
+        endTransaction("mIdTag");
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+
+        //start another transaction while BN is pending
+
+        getOcppContext()->getOperationRegistry().registerOperation("BootNotification",
+            [] () {
+                return new Ocpp16::CustomOperation("BootNotification",
+                    [] (JsonObject payload) {
+                        //ignore req
+                    },
+                    [] () {
+                        //create conf
+                        auto conf = makeJsonDoc(UNIT_MEM_TAG, 1024);
+                        (*conf)["currentTime"] = BASE_TIME;
+                        (*conf)["interval"] = 3600;
+                        (*conf)["status"] = "Pending";
+                        return conf;
+                    });
+            });
+
+        loopback.setOnline( true );
+        loop();
+        REQUIRE( startTxCount == 0 );
+
+        beginTransaction_authorized("mIdTag");
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging ); 
+
+        endTransaction("mIdTag");
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+
+        REQUIRE( startTxCount == 0 );
+
+        //Now, accept BN and check again
+
+        getOcppContext()->getOperationRegistry().registerOperation("BootNotification",
+            [] () {
+                return new Ocpp16::CustomOperation("BootNotification",
+                    [] (JsonObject payload) {
+                        //ignore req
+                    },
+                    [] () {
+                        //create conf
+                        auto conf = makeJsonDoc(UNIT_MEM_TAG, 1024);
+                        (*conf)["currentTime"] = BASE_TIME;
+                        (*conf)["interval"] = 3600;
+                        (*conf)["status"] = "Accepted";
+                        return conf;
+                    });
+            });
+
+        mtime += 3600 * 1000;
+
+        loop();
+        REQUIRE( startTxCount == 2 );
+
+    }
+
+    mocpp_deinitialize();
+}
diff --git a/tests/helpers/testHelper.h b/tests/helpers/testHelper.h
index 7dd33ba8..04e35d57 100644
--- a/tests/helpers/testHelper.h
+++ b/tests/helpers/testHelper.h
@@ -5,6 +5,8 @@
 #ifndef MO_TESTHELPER_H
 #define MO_TESTHELPER_H
 
+#define UNIT_MEM_TAG "UnitTests"
+
 extern unsigned long mtime;
 unsigned long custom_timer_cb();
 

From 032672b88dee3839cb73194a0bd64af2cd6b5889 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Thu, 15 Aug 2024 10:16:11 +0200
Subject: [PATCH 514/549] further offline authorization checks in unit cases

---
 tests/Boot.cpp             | 15 ++++++++-------
 tests/ChargingSessions.cpp | 11 ++++++-----
 2 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/tests/Boot.cpp b/tests/Boot.cpp
index 7a76c803..0e661b2a 100644
--- a/tests/Boot.cpp
+++ b/tests/Boot.cpp
@@ -96,7 +96,7 @@ TEST_CASE( "Boot Behavior" ) {
 
         REQUIRE( isOperative() ); //normal BN succeeded
 
-        loopback.setOnline( false );
+        loopback.setConnected( false );
 
         beginTransaction_authorized("mIdTag");
 
@@ -106,7 +106,7 @@ TEST_CASE( "Boot Behavior" ) {
 
         mocpp_deinitialize();
 
-        loopback.setOnline( true );
+        loopback.setConnected( true );
 
         MO_DBG_INFO("Start charger again with queued transaction messages, also init non-tx-related msg, but now delay BN procedure");
 
@@ -239,11 +239,11 @@ TEST_CASE( "Boot Behavior" ) {
 
         //start one transaction in full offline mode
 
-        loopback.setOnline( false );
+        loopback.setConnected( false );
         loop();
         REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
 
-        beginTransaction_authorized("mIdTag");
+        beginTransaction("mIdTag");
         loop();
         REQUIRE( getChargePointStatus() == ChargePointStatus_Charging ); 
 
@@ -269,15 +269,16 @@ TEST_CASE( "Boot Behavior" ) {
                     });
             });
 
-        loopback.setOnline( true );
+        loopback.setConnected( true );
         loop();
         REQUIRE( startTxCount == 0 );
 
-        beginTransaction_authorized("mIdTag");
+        beginTransaction("mIdTag2");
+        mtime += 20 * 1000;
         loop();
         REQUIRE( getChargePointStatus() == ChargePointStatus_Charging ); 
 
-        endTransaction("mIdTag");
+        endTransaction();
         loop();
         REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
 
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 9401a4f1..b495494d 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -520,7 +520,8 @@ TEST_CASE( "Charging sessions" ) {
         const char *tx3_idTag = "Tx#3";
         const char *tx4_idTag = "Tx#4";
 
-        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true, CONFIGURATION_FN)->setBool(true);
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true)->setBool(true);
+        declareConfiguration<bool>("AllowOfflineTxForUnknownId", true)->setBool(true);
         configuration_save();
         loop();
 
@@ -528,7 +529,7 @@ TEST_CASE( "Charging sessions" ) {
         loopback.setConnected(false);
 
         MO_DBG_DEBUG("begin tx (%s)", tx1_idTag);
-        beginTransaction_authorized(tx1_idTag);
+        beginTransaction(tx1_idTag);
         loop();
         REQUIRE(isTransactionRunning());
         endTransaction();
@@ -543,7 +544,7 @@ TEST_CASE( "Charging sessions" ) {
         // start Tx #2 (PreBoot tx, won't get timestamp)
 
         MO_DBG_DEBUG("begin tx (%s)", tx2_idTag);
-        beginTransaction_authorized(tx2_idTag);
+        beginTransaction(tx2_idTag);
         loop();
         REQUIRE(isTransactionRunning());
         endTransaction();
@@ -558,7 +559,7 @@ TEST_CASE( "Charging sessions" ) {
         // start Tx #3 (PreBoot tx, will eventually get timestamp)
 
         MO_DBG_DEBUG("begin tx (%s)", tx3_idTag);
-        beginTransaction_authorized(tx3_idTag);
+        beginTransaction(tx3_idTag);
         loop();
         REQUIRE(isTransactionRunning());
         endTransaction();
@@ -604,7 +605,7 @@ TEST_CASE( "Charging sessions" ) {
 
         // start Tx #4
         MO_DBG_DEBUG("begin tx (%s)", tx4_idTag);
-        beginTransaction_authorized(tx4_idTag);
+        beginTransaction(tx4_idTag);
         loop();
         REQUIRE(isTransactionRunning());
         endTransaction();

From a9213ec1b9af220a1a08744c5f36e3f68f79495a Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Thu, 15 Aug 2024 10:53:39 +0200
Subject: [PATCH 515/549] Correct MV PreBoot year 1970 timestamps (#354)

* fix MeterValues PreBoot year 1970 timestamps

* update changelog
---
 CHANGELOG.md                                    |  1 +
 .../Model/Metering/MeteringConnector.cpp        |  4 ++--
 .../Model/Metering/MeteringService.cpp          |  4 ++--
 src/MicroOcpp/Operations/MeterValues.cpp        | 17 ++++++++++++-----
 src/MicroOcpp/Operations/MeterValues.h          |  6 ++++--
 5 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 46857bce..73ebdbc9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -41,6 +41,7 @@
 - Reject DataTransfer by default ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - UnlockConnector NotSupported if connectorId invalid ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Fix regression bug of [#345](https://github.com/matth-x/MicroOcpp/pull/345) ([#353](https://github.com/matth-x/MicroOcpp/pull/353))
+- Correct MeterValue PreBoot timestamp ([#354](https://github.com/matth-x/MicroOcpp/pull/354))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index 45373443..737a106e 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -57,7 +57,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
     }
 
     if ((txBreak || meterData.size() >= (size_t) meterValueCacheSizeInt->getInt()) && !meterData.empty()) {
-        auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(std::move(meterData), connectorId, transaction));
+        auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(model, std::move(meterData), connectorId, transaction));
         meterData = makeVector<std::unique_ptr<MeterValue>>(getMemoryTag());
         return std::move(meterValues); //std::move is required for some compilers even if it's not mandated by standard C++
     }
@@ -168,7 +168,7 @@ std::unique_ptr<Operation> MeteringConnector::takeTriggeredMeterValues() {
         transaction = model.getConnector(connectorId)->getTransaction();
     }
 
-    return std::unique_ptr<MeterValues>(new MeterValues(std::move(mv_now), connectorId, transaction));
+    return std::unique_ptr<MeterValues>(new MeterValues(model, std::move(mv_now), connectorId, transaction));
 }
 
 void MeteringConnector::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index 9196865f..a404ab48 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -78,8 +78,8 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
      * is connected with a WebSocket echo server, let it reply to its own requests.
      * Mocking an OCPP Server on the same device makes running (unit) tests easier.
      */
-    context.getOperationRegistry().registerOperation("MeterValues", [] () {
-        return new Ocpp16::MeterValues();});
+    context.getOperationRegistry().registerOperation("MeterValues", [this] () {
+        return new Ocpp16::MeterValues(this->context.getModel());});
 }
 
 void MeteringService::loop(){
diff --git a/src/MicroOcpp/Operations/MeterValues.cpp b/src/MicroOcpp/Operations/MeterValues.cpp
index 905e63dc..f6ab2d7c 100644
--- a/src/MicroOcpp/Operations/MeterValues.cpp
+++ b/src/MicroOcpp/Operations/MeterValues.cpp
@@ -14,12 +14,12 @@ using MicroOcpp::JsonDoc;
 #define ENERGY_METER_TIMEOUT_MS 30 * 1000  //after waiting for 30s, send MeterValues without missing readings
 
 //can only be used for echo server debugging
-MeterValues::MeterValues() : MemoryManaged("v16.Operation.", "MeterValues") {
+MeterValues::MeterValues(Model& model) : MemoryManaged("v16.Operation.", "MeterValues"), model(model) {
     
 }
 
-MeterValues::MeterValues(Vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction) 
-      : MemoryManaged("v16.Operation.", "MeterValues"), meterValue{std::move(meterValue)}, connectorId{connectorId}, transaction{transaction} {
+MeterValues::MeterValues(Model& model, Vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction) 
+      : MemoryManaged("v16.Operation.", "MeterValues"), model(model), meterValue{std::move(meterValue)}, connectorId{connectorId}, transaction{transaction} {
     
 }
 
@@ -36,8 +36,15 @@ std::unique_ptr<JsonDoc> MeterValues::createReq() {
     size_t capacity = 0;
     
     auto entries = makeVector<std::unique_ptr<JsonDoc>>(getMemoryTag());
-    for (auto value = meterValue.begin(); value != meterValue.end(); value++) {
-        auto entry = (*value)->toJson();
+    for (auto mv = meterValue.begin(); mv != meterValue.end(); mv++) {
+
+        if ((*mv)->getTimestamp() < MIN_TIME) {
+            MO_DBG_DEBUG("adjust preboot MeterValue timestamp");
+            Timestamp adjusted = model.getClock().adjustPrebootTimestamp((*mv)->getTimestamp());
+            (*mv)->setTimestamp(adjusted);
+        }
+
+        auto entry = (*mv)->toJson();
         if (entry) {
             capacity += entry->capacity();
             entries.push_back(std::move(entry));
diff --git a/src/MicroOcpp/Operations/MeterValues.h b/src/MicroOcpp/Operations/MeterValues.h
index 012151d5..f4e4be4e 100644
--- a/src/MicroOcpp/Operations/MeterValues.h
+++ b/src/MicroOcpp/Operations/MeterValues.h
@@ -11,6 +11,7 @@
 
 namespace MicroOcpp {
 
+class Model;
 class MeterValue;
 class Transaction;
 
@@ -18,6 +19,7 @@ namespace Ocpp16 {
 
 class MeterValues : public Operation, public MemoryManaged {
 private:
+    Model& model; //for adjusting the timestamp if MeterValue has been created before BootNotification
     Vector<std::unique_ptr<MeterValue>> meterValue;
 
     unsigned int connectorId = 0;
@@ -25,9 +27,9 @@ class MeterValues : public Operation, public MemoryManaged {
     std::shared_ptr<Transaction> transaction;
 
 public:
-    MeterValues(Vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction = nullptr);
+    MeterValues(Model& model, Vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction = nullptr);
 
-    MeterValues(); //for debugging only. Make this for the server pendant
+    MeterValues(Model& model); //for debugging only. Make this for the server pendant
 
     ~MeterValues();
 

From ed3034f037c30675a93f3531dff0da746b49b924 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Thu, 15 Aug 2024 15:49:02 +0200
Subject: [PATCH 516/549] Migration of persistent data from previous versions
 (#355)

* add migration and cleaning of configs; add unit tests

* keep client-state.jsn; opstore handled in migration

* update changelog

* fix UBSan error

* reduce Unit test log verbosity (faster execution)
---
 CHANGELOG.md                                  |   1 +
 CMakeLists.txt                                |   2 +-
 src/MicroOcpp.cpp                             |  22 +---
 src/MicroOcpp/Core/Configuration.cpp          |   7 ++
 src/MicroOcpp/Core/Configuration.h            |   2 +
 src/MicroOcpp/Core/ConfigurationContainer.h   |   2 +
 .../Core/ConfigurationContainerFlash.cpp      |  19 +++
 src/MicroOcpp/Model/Boot/BootService.cpp      |  62 +++++++++-
 src/MicroOcpp/Model/Boot/BootService.h        |  16 ++-
 tests/Boot.cpp                                | 117 ++++++++++++++++++
 10 files changed, 223 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 73ebdbc9..fd7a7961 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -21,6 +21,7 @@
 - Input validation for unsigned int Configs ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Support for TransactionMessageAttempts/-RetryInterval ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 - Heap profiler and custom allocator support ([#350](https://github.com/matth-x/MicroOcpp/pull/350))
+- Migration of persistent storage ([#355](https://github.com/matth-x/MicroOcpp/pull/355))
 
 ### Removed
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index ca91ef7d..9d8fffc8 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -180,7 +180,7 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_PLATFORM=MO_PLATFORM_UNIX
     MO_NUMCONNECTORS=3
     MO_CUSTOM_TIMER
-    MO_DBG_LEVEL=MO_DL_DEBUG
+    MO_DBG_LEVEL=MO_DL_INFO
     MO_TRAFFIC_OUT
     MO_FILENAME_PREFIX="./mo_store/"
     MO_LocalAuthListMaxLength=8
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 2fc39ba3..3b2d070c 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -259,21 +259,12 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     BootService::loadBootStats(filesystem, bootstats);
 
     if (autoRecover && bootstats.getBootFailureCount() > 3) {
-        MO_DBG_ERR("multiple initialization failures detected");
-        if (filesystem) {
-            bool success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
-                return !strncmp(fname, "sd", strlen("sd")) ||
-                       !strncmp(fname, "tx", strlen("tx")) ||
-                       !strncmp(fname, "op", strlen("op")) ||
-                       !strncmp(fname, "sc-", strlen("sc-")) ||
-                       !strncmp(fname, "reservation", strlen("reservation"));
-            });
-            MO_DBG_ERR("clear local state files (recovery): %s", success ? "success" : "not completed");
-
-            bootstats = BootStats();
-        }
+        BootService::recover(filesystem, bootstats);
+        bootstats = BootStats();
     }
 
+    BootService::migrate(filesystem, bootstats);
+
     bootstats.bootNr++; //assign new boot number to this run
     BootService::storeBootStats(filesystem, bootstats);
 
@@ -373,13 +364,8 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     }
     credsJson.reset();
 
-    auto mocppVersion = declareConfiguration<const char*>("MicroOcppVersion", MO_VERSION, MO_KEYVALUE_FN, false, false, false);
-
     configuration_load();
 
-    if (mocppVersion) {
-        mocppVersion->setString(MO_VERSION);
-    }
     MO_DBG_INFO("initialized MicroOcpp v" MO_VERSION);
 }
 
diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index ec1b9841..9a00fb12 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -239,4 +239,11 @@ bool configuration_save() {
     return success;
 }
 
+bool configuration_clean_unused() {
+    for (auto& container : configurationContainers) {
+        container->removeUnused();
+    }
+    return configuration_save();
+}
+
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index 6b33f43c..f445ffce 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -36,5 +36,7 @@ bool configuration_load(const char *filename = nullptr);
 
 bool configuration_save();
 
+bool configuration_clean_unused(); //remove configs which haven't been accessed
+
 } //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Core/ConfigurationContainer.h b/src/MicroOcpp/Core/ConfigurationContainer.h
index f31c613c..9a3ff3ae 100644
--- a/src/MicroOcpp/Core/ConfigurationContainer.h
+++ b/src/MicroOcpp/Core/ConfigurationContainer.h
@@ -35,6 +35,8 @@ class ConfigurationContainer {
     virtual std::shared_ptr<Configuration> getConfiguration(const char *key) = 0;
 
     virtual void loadStaticKey(Configuration& config, const char *key) { } //possible optimization: can replace internal key with passed static key
+
+    virtual void removeUnused() { } //remove configs which haven't been accessed (optional and only if known)
 };
 
 class ConfigurationContainerVolatile : public ConfigurationContainer, public MemoryManaged {
diff --git a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
index 9f83631f..b32f1af8 100644
--- a/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
+++ b/src/MicroOcpp/Core/ConfigurationContainerFlash.cpp
@@ -334,6 +334,25 @@ class ConfigurationContainerFlash : public ConfigurationContainer, public Memory
         config.setKey(key);
         clearKeyPool(key);
     }
+
+    void removeUnused() override {
+        //if a config's key is still in the keyPool, we know it's unused because it has never been declared in FW (originates from an older FW version)
+
+        auto key = keyPool.begin();
+        while (key != keyPool.end()) {
+
+            for (auto config = configurations.begin(); config != configurations.end(); ++config) {
+                if ((*config)->getKey() == *key) {
+                    MO_DBG_DEBUG("remove unused config %s", (*config)->getKey());
+                    configurations.erase(config);
+                    break;
+                }
+            }
+
+            MO_FREE(*key);
+            key = keyPool.erase(key);
+        }
+    }
 };
 
 std::unique_ptr<ConfigurationContainer> makeConfigurationContainerFlash(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename, bool accessible) {
diff --git a/src/MicroOcpp/Model/Boot/BootService.cpp b/src/MicroOcpp/Model/Boot/BootService.cpp
index cf569449..1aabb200 100644
--- a/src/MicroOcpp/Model/Boot/BootService.cpp
+++ b/src/MicroOcpp/Model/Boot/BootService.cpp
@@ -14,10 +14,6 @@
 #include <MicroOcpp/Platform.h>
 #include <MicroOcpp/Debug.h>
 
-#ifndef MO_BOOTSTATS_LONGTIME_MS
-#define MO_BOOTSTATS_LONGTIME_MS 180 * 1000
-#endif
-
 using namespace MicroOcpp;
 
 unsigned int PreBootQueue::getFrontRequestOpNr() {
@@ -71,6 +67,9 @@ void BootService::loop() {
     if (!executedLongTime && mocpp_tick_ms() - firstExecutionTimestamp >= MO_BOOTSTATS_LONGTIME_MS) {
         executedLongTime = true;
         MO_DBG_DEBUG("boot success timer reached");
+
+        configuration_clean_unused();
+
         BootStats bootstats;
         loadBootStats(filesystem, bootstats);
         bootstats.lastBootSuccess = bootstats.bootNr;
@@ -185,6 +184,14 @@ bool BootService::loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, B
             } else {
                 success = false;
             }
+
+            const char *microOcppVersionIn = (*json)["MicroOcppVersion"] | (const char*)nullptr;
+            if (microOcppVersionIn) {
+                auto ret = snprintf(bstats.microOcppVersion, sizeof(bstats.microOcppVersion), "%s", microOcppVersionIn);
+                if (ret < 0 || (size_t)ret >= sizeof(bstats.microOcppVersion)) {
+                    success = false;
+                }
+            } //else: version specifier can be missing after upgrade from pre 1.2.0 version
         } else {
             success = false;
         }
@@ -201,15 +208,58 @@ bool BootService::loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, B
     }
 }
 
-bool BootService::storeBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats bstats) {
+bool BootService::storeBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& bstats) {
     if (!filesystem) {
         return false;
     }
 
-    auto json = initJsonDoc("v16.Boot.BootService", JSON_OBJECT_SIZE(2));
+    auto json = initJsonDoc("v16.Boot.BootService", JSON_OBJECT_SIZE(3));
 
     json["bootNr"] = bstats.bootNr;
     json["lastSuccess"] = bstats.lastBootSuccess;
+    json["MicroOcppVersion"] = (const char*)bstats.microOcppVersion;
 
     return FilesystemUtils::storeJson(filesystem, MO_FILENAME_PREFIX "bootstats.jsn", json);
 }
+
+bool BootService::recover(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& bstats) {
+    if (!filesystem) {
+        return false;
+    }
+
+    bool success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
+        return !strncmp(fname, "sd", strlen("sd")) ||
+                !strncmp(fname, "tx", strlen("tx")) ||
+                !strncmp(fname, "sc-", strlen("sc-")) ||
+                !strncmp(fname, "reservation", strlen("reservation")) ||
+                !strncmp(fname, "client-state", strlen("client-state"));
+    });
+    MO_DBG_ERR("clear local state files (recovery): %s", success ? "success" : "not completed");
+
+    return success;
+}
+
+bool BootService::migrate(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& bstats) {
+    if (!filesystem) {
+        return false;
+    }
+
+    bool success = true;
+
+    if (strcmp(bstats.microOcppVersion, MO_VERSION)) {
+        MO_DBG_INFO("migrate persistent storage to MO v" MO_VERSION);
+        success = FilesystemUtils::remove_if(filesystem, [] (const char *fname) -> bool {
+            return !strncmp(fname, "sd", strlen("sd")) ||
+                    !strncmp(fname, "tx", strlen("tx")) ||
+                    !strncmp(fname, "op", strlen("op")) ||
+                    !strncmp(fname, "sc-", strlen("sc-")) ||
+                    !strcmp(fname, "client-state.cnf") ||
+                    !strcmp(fname, "arduino-ocpp.cnf") ||
+                    !strcmp(fname, "ocpp-creds.jsn");
+        });
+
+        snprintf(bstats.microOcppVersion, sizeof(bstats.microOcppVersion), "%s", MO_VERSION);
+        MO_DBG_DEBUG("clear local state files (migration): %s", success ? "success" : "not completed");
+    }
+    return success;
+}
diff --git a/src/MicroOcpp/Model/Boot/BootService.h b/src/MicroOcpp/Model/Boot/BootService.h
index dac4d91f..6091dc2c 100644
--- a/src/MicroOcpp/Model/Boot/BootService.h
+++ b/src/MicroOcpp/Model/Boot/BootService.h
@@ -13,8 +13,14 @@
 
 #define MO_BOOT_INTERVAL_DEFAULT 60
 
+#ifndef MO_BOOTSTATS_LONGTIME_MS
+#define MO_BOOTSTATS_LONGTIME_MS 180 * 1000
+#endif
+
 namespace MicroOcpp {
 
+#define MO_BOOTSTATS_VERSION_SIZE 10
+
 struct BootStats {
     uint16_t bootNr = 0;
     uint16_t lastBootSuccess = 0;
@@ -22,6 +28,8 @@ struct BootStats {
     uint16_t getBootFailureCount() {
         return bootNr - lastBootSuccess;
     }
+
+    char microOcppVersion [MO_BOOTSTATS_VERSION_SIZE] = {'\0'};
 };
 
 enum class RegistrationStatus {
@@ -79,8 +87,12 @@ class BootService : public MemoryManaged {
     void notifyRegistrationStatus(RegistrationStatus status);
     void setRetryInterval(unsigned long interval);
 
-    static bool loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& out);
-    static bool storeBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats bstats);
+    static bool loadBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& bstats);
+    static bool storeBootStats(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& bstats);
+
+    static bool recover(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& bstats); //delete all persistent files which could lead to a crash
+
+    static bool migrate(std::shared_ptr<FilesystemAdapter> filesystem, BootStats& bstats); //migrate persistent storage if running on a new MO version
 };
 
 }
diff --git a/tests/Boot.cpp b/tests/Boot.cpp
index 0e661b2a..4beadf31 100644
--- a/tests/Boot.cpp
+++ b/tests/Boot.cpp
@@ -12,6 +12,7 @@
 #include <MicroOcpp/Operations/BootNotification.h>
 #include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Model/Boot/BootService.h>
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
 #include <MicroOcpp/Debug.h>
 #include <catch2/catch.hpp>
@@ -309,5 +310,121 @@ TEST_CASE( "Boot Behavior" ) {
 
     }
 
+    SECTION("Auto recovery") {
+
+        //start transaction which will persist a few boot cycles, but then will be wiped by auto recovery
+        loop();
+        beginTransaction("mIdTag");
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging );
+
+        declareConfiguration<const char*>("keepConfigOverRecovery", "originalVal");
+        configuration_save();
+
+        mocpp_deinitialize();
+
+        //MO has 2 unexpected power cycles. Probably just back luck - keep the local state and configuration
+
+        //Increase the power cycle counter manually because it's not possible to interrupt the MO lifecycle during unit tests
+        BootStats bootstats;
+        BootService::loadBootStats(filesystem, bootstats);
+        bootstats.bootNr += 2;
+        BootService::storeBootStats(filesystem, bootstats);
+
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, /*enable auto recovery*/ true);
+        BootService::loadBootStats(filesystem, bootstats);
+        REQUIRE( bootstats.getBootFailureCount() == 2 + 1 ); //two boot failures have been measured, +1 because each power cycle is counted as potentially failing until reaching the long runtime barrier
+
+        loop();
+
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging );
+
+        REQUIRE( !strcmp(declareConfiguration<const char*>("keepConfigOverRecovery", "otherVal")->getString(), "originalVal") );
+
+        //check that the power cycle counter has been updated properly after the controller has been running stable over a long time
+        mtime += MO_BOOTSTATS_LONGTIME_MS;
+        loop();
+        BootService::loadBootStats(filesystem, bootstats);
+        REQUIRE( bootstats.getBootFailureCount() == 0 );
+
+        mocpp_deinitialize();
+
+        //MO has 10 power cycles without running for at least 3 minutes and wipes the local state, but keeps the configuration
+
+        BootStats bootstats2;
+        BootService::loadBootStats(filesystem, bootstats2);
+        bootstats2.bootNr += 10;
+        BootService::storeBootStats(filesystem, bootstats2);
+
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, /*enable auto recovery*/ true);
+
+        REQUIRE( !strcmp(declareConfiguration<const char*>("keepConfigOverRecovery", "otherVal")->getString(), "originalVal") );
+        BootStats bootstats3;
+        BootService::loadBootStats(filesystem, bootstats3);
+        REQUIRE( bootstats3.getBootFailureCount() == 0 + 1 ); //failure count is reset, but +1 because each power cycle is counted as potentially failing until reaching the long runtime barrier
+
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+
+    }
+
+    SECTION("Migration") {
+
+        //migration removes files from previous MO versions which were running on the controller. This includes the
+        //transaction cache, but configs are preserved
+
+        auto old_opstore = filesystem->open(MO_FILENAME_PREFIX "opstore.jsn", "w"); //the opstore has been removed in MO v1.2.0
+        old_opstore->write("example content", sizeof("example content") - 1);
+        old_opstore.reset(); //flushes the file
+
+        loop();
+        auto tx = beginTransaction("mIdTag"); //tx store will also be removed
+        auto txNr = tx->getTxNr(); //remember this for later usage
+        tx.reset(); //reset this smart pointer
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging );
+        endTransaction();
+        loop();
+
+        REQUIRE( getOcppContext()->getModel().getTransactionStore()->getTransaction(1, txNr) != nullptr ); //tx exists on flash
+
+        declareConfiguration<const char*>("keepConfigOverMigration", "originalVal"); //migration keeps configs
+        configuration_save();
+
+        mocpp_deinitialize();
+
+        //After a FW update, the tracked version number has changed
+        BootStats bootstats;
+        BootService::loadBootStats(filesystem, bootstats);
+        snprintf(bootstats.microOcppVersion, sizeof(bootstats.microOcppVersion), "oldFwVers");
+        BootService::storeBootStats(filesystem, bootstats);
+
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem); //MO migrates here
+
+        size_t msize = 0;
+        REQUIRE( filesystem->stat(MO_FILENAME_PREFIX "opstore.jsn", &msize) != 0 ); //opstore has been removed
+
+        REQUIRE( getOcppContext()->getModel().getTransactionStore()->getTransaction(1, txNr) == nullptr ); //tx history entry has been removed
+
+        REQUIRE( !strcmp(declareConfiguration<const char*>("keepConfigOverMigration", "otherVal")->getString(), "originalVal") ); //config has been preserved
+    }
+
+    SECTION("Clean unused configs") {
+
+        declareConfiguration<const char*>("neverDeclaredInsideMO", "originalVal"); //unused configs will be cleared automatically after the controller has been running for a long time
+        configuration_save();
+
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem); //all configs are loaded here, including the test config of this section
+        loop();
+
+        //unused configs will be cleared automatically after long time
+        mtime += MO_BOOTSTATS_LONGTIME_MS;
+        loop();
+
+        REQUIRE( !strcmp(declareConfiguration<const char*>("neverDeclaredInsideMO", "newVal")->getString(), "newVal") ); //config has been removed
+    }
+
     mocpp_deinitialize();
 }

From 7e017cf55f27766abe42fd937edbe346c4bd87fe Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 18 Aug 2024 18:00:44 +0200
Subject: [PATCH 517/549] Fix MeterValues tx-related message behavior (#356)

* revise latest changes in actual integration

* fix MeterValues tx-related message order

* adopt tx retry behavior

* fix TriggerMessage for MeterValues
---
 CHANGELOG.md                                  |   2 +-
 src/MicroOcpp/Core/Request.cpp                |  10 +-
 src/MicroOcpp/Core/Request.h                  |   5 +-
 src/MicroOcpp/Core/RequestQueue.h             |   2 +-
 .../Model/ConnectorBase/Connector.cpp         |  70 +--
 src/MicroOcpp/Model/ConnectorBase/Connector.h |   6 +-
 .../Model/Diagnostics/DiagnosticsService.cpp  |   5 +-
 src/MicroOcpp/Model/Metering/MeterValue.cpp   |  38 ++
 src/MicroOcpp/Model/Metering/MeterValue.h     |  17 +
 .../Model/Metering/MeteringConnector.cpp      | 116 +++--
 .../Model/Metering/MeteringConnector.h        |  23 +-
 .../Model/Metering/MeteringService.cpp        |  11 +-
 src/MicroOcpp/Operations/MeterValues.cpp      |  39 +-
 src/MicroOcpp/Operations/MeterValues.h        |   6 +-
 src/MicroOcpp/Operations/TriggerMessage.cpp   |  12 +-
 tests/Metering.cpp                            | 412 ++++++++++++++++--
 16 files changed, 635 insertions(+), 139 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index fd7a7961..eb5f732c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -41,7 +41,7 @@
 - Don't change into Unavailable upon Reset ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Reject DataTransfer by default ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - UnlockConnector NotSupported if connectorId invalid ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
-- Fix regression bug of [#345](https://github.com/matth-x/MicroOcpp/pull/345) ([#353](https://github.com/matth-x/MicroOcpp/pull/353))
+- Fix regression bug of [#345](https://github.com/matth-x/MicroOcpp/pull/345) ([#353](https://github.com/matth-x/MicroOcpp/pull/353), [#356](https://github.com/matth-x/MicroOcpp/pull/356))
 - Correct MeterValue PreBoot timestamp ([#354](https://github.com/matth-x/MicroOcpp/pull/354))
 
 ## [1.1.0] - 2024-05-21
diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index 56477fa8..bf4db6b3 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -29,7 +29,7 @@ namespace MicroOcpp {
 
 using namespace MicroOcpp;
 
-Request::Request(std::unique_ptr<Operation> msg, const char *memory_tag) : MemoryManaged(memory_tag), messageID(makeString(getMemoryTag())), operation(std::move(msg)) {
+Request::Request(std::unique_ptr<Operation> msg) : MemoryManaged("Request.", msg->getOperationType()), messageID(makeString(getMemoryTag())), operation(std::move(msg)) {
     timeout_start = mocpp_tick_ms();
     debugRequest_start = mocpp_tick_ms();
 }
@@ -289,19 +289,15 @@ bool Request::isRequestSent() {
 
 namespace MicroOcpp {
 
-std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> operation, const char *memoryTag){
+std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> operation){
     if (operation == nullptr) {
         return nullptr;
     }
-    return std::unique_ptr<Request>(new Request(std::move(operation), memoryTag));
+    return std::unique_ptr<Request>(new Request(std::move(operation)));
 }
 
 std::unique_ptr<Request> makeRequest(Operation *operation) {
     return makeRequest(std::unique_ptr<Operation>(operation));
 }
 
-std::unique_ptr<Request> makeRequest(const char *memoryTag, Operation *operation) {
-    return makeRequest(std::unique_ptr<Operation>(operation), memoryTag);
-}
-
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/Request.h b/src/MicroOcpp/Core/Request.h
index 4b608217..62e42967 100644
--- a/src/MicroOcpp/Core/Request.h
+++ b/src/MicroOcpp/Core/Request.h
@@ -41,7 +41,7 @@ class Request : public MemoryManaged {
     bool requestSent = false;
 public:
 
-    Request(std::unique_ptr<Operation> msg, const char *memory_tag = "Request");
+    Request(std::unique_ptr<Operation> msg);
 
     ~Request();
 
@@ -121,9 +121,8 @@ class Request : public MemoryManaged {
 /*
  * Simple factory functions
  */
-std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> op, const char *memoryTag = "Request");
+std::unique_ptr<Request> makeRequest(std::unique_ptr<Operation> op);
 std::unique_ptr<Request> makeRequest(Operation *op); //takes ownership of op
-std::unique_ptr<Request> makeRequest(const char *memoryTag, Operation *op); //takes ownership of op
 
 } //end namespace MicroOcpp
 
diff --git a/src/MicroOcpp/Core/RequestQueue.h b/src/MicroOcpp/Core/RequestQueue.h
index 1375ad90..0cdfe7bc 100644
--- a/src/MicroOcpp/Core/RequestQueue.h
+++ b/src/MicroOcpp/Core/RequestQueue.h
@@ -18,7 +18,7 @@
 #endif
 
 #ifndef MO_NUM_REQUEST_QUEUES
-#define MO_NUM_REQUEST_QUEUES 5
+#define MO_NUM_REQUEST_QUEUES 10
 #endif
 
 namespace MicroOcpp {
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 04f04e9e..d1adc1ea 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -92,14 +92,14 @@ Connector::Connector(Context& context, std::shared_ptr<FilesystemAdapter> filesy
             if (txNrPivot == std::numeric_limits<unsigned int>::max()) {
                 txNrPivot = parsedTxNr;
                 txNrBegin = parsedTxNr;
-                txNrBack = (parsedTxNr + 1) % MAX_TX_CNT;
+                txNrEnd = (parsedTxNr + 1) % MAX_TX_CNT;
                 return 0;
             }
 
             if ((parsedTxNr + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT < MAX_TX_CNT / 2) {
                 //parsedTxNr is after pivot point
-                if ((parsedTxNr + 1 + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT > (txNrBack + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT) {
-                    txNrBack = (parsedTxNr + 1) % MAX_TX_CNT;
+                if ((parsedTxNr + 1 + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT > (txNrEnd + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT) {
+                    txNrEnd = (parsedTxNr + 1) % MAX_TX_CNT;
                 }
             } else if ((txNrPivot + MAX_TX_CNT - parsedTxNr) % MAX_TX_CNT < MAX_TX_CNT / 2) {
                 //parsedTxNr is before pivot point
@@ -108,16 +108,16 @@ Connector::Connector(Context& context, std::shared_ptr<FilesystemAdapter> filesy
                 }
             }
 
-            MO_DBG_DEBUG("found %s%u.jsn - Internal range from %u to %u (exclusive)", txFnamePrefix, parsedTxNr, txNrBegin, txNrBack);
+            MO_DBG_DEBUG("found %s%u.jsn - Internal range from %u to %u (exclusive)", txFnamePrefix, parsedTxNr, txNrBegin, txNrEnd);
         }
         return 0;
     });
 
-    MO_DBG_DEBUG("found %u transactions for connector %u. Internal range from %u to %u (exclusive)", (txNrBack + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT, connectorId, txNrBegin, txNrBack);
+    MO_DBG_DEBUG("found %u transactions for connector %u. Internal range from %u to %u (exclusive)", (txNrEnd + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT, connectorId, txNrBegin, txNrEnd);
     txNrFront = txNrBegin;
 
     if (model.getTransactionStore()) {
-        unsigned int txNrLatest = (txNrBack + MAX_TX_CNT - 1) % MAX_TX_CNT; //txNr of the most recent tx on flash
+        unsigned int txNrLatest = (txNrEnd + MAX_TX_CNT - 1) % MAX_TX_CNT; //txNr of the most recent tx on flash
         transaction = model.getTransactionStore()->getTransaction(connectorId, txNrLatest); //returns nullptr if txNrLatest does not exist on flash
     } else {
         MO_DBG_ERR("must initialize TxStore before Connector");
@@ -263,26 +263,26 @@ void Connector::loop() {
         }
 
         if (removed) {
-            if (txNrFront == txNrBack) {
+            if (txNrFront == txNrEnd) {
                 txNrFront = transaction->getTxNr();
             }
-            txNrBack = transaction->getTxNr(); //roll back creation of last tx entry
+            txNrEnd = transaction->getTxNr(); //roll back creation of last tx entry
         }
 
         MO_DBG_DEBUG("collect aborted or silent transaction %u-%u %s", connectorId, transaction->getTxNr(), removed ? "" : "failure");
-        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
         transaction = nullptr;
     }
 
     if (transaction && transaction->isAborted()) {
         MO_DBG_DEBUG("collect aborted transaction %u-%u", connectorId, transaction->getTxNr());
-        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
         transaction = nullptr;
     }
 
     if (transaction && transaction->getStopSync().isRequested()) {
         MO_DBG_DEBUG("collect obsolete transaction %u-%u", connectorId, transaction->getTxNr());
-        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
         transaction = nullptr;
     }
 
@@ -550,8 +550,8 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
     std::shared_ptr<Transaction> tx;
 
     //clean possible aborted tx
-    unsigned int txr = txNrBack;
-    unsigned int txSize = (txNrBack + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT;
+    unsigned int txr = txNrEnd;
+    unsigned int txSize = (txNrEnd + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT;
     for (unsigned int i = 0; i < txSize; i++) {
         txr = (txr + MAX_TX_CNT - 1) % MAX_TX_CNT; //decrement by 1
 
@@ -567,10 +567,10 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
                 removed &= model.getTransactionStore()->remove(connectorId, txr);
             }
             if (removed) {
-                if (txNrFront == txNrBack) {
+                if (txNrFront == txNrEnd) {
                     txNrFront = txr;
                 }
-                txNrBack = txr;
+                txNrEnd = txr;
                 MO_DBG_WARN("deleted dangling silent or aborted tx for new transaction");
             } else {
                 MO_DBG_ERR("memory corruption");
@@ -582,18 +582,18 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
         }
     }
 
-    txSize = (txNrBack + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT; //refresh after cleaning txs
+    txSize = (txNrEnd + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT; //refresh after cleaning txs
 
     //try to create new transaction
     if (txSize < MO_TXRECORD_SIZE) {
-        tx = model.getTransactionStore()->createTransaction(connectorId, txNrBack);
+        tx = model.getTransactionStore()->createTransaction(connectorId, txNrEnd);
     }
 
     if (!tx) {
         //could not create transaction - now, try to replace tx history entry
 
         unsigned int txl = txNrBegin;
-        txSize = (txNrBack + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT;
+        txSize = (txNrEnd + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT;
 
         for (unsigned int i = 0; i < txSize; i++) {
 
@@ -621,9 +621,9 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
                         txNrFront = txNrBegin;
                     }
                     MO_DBG_DEBUG("deleted tx history entry for new transaction");
-                    MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+                    MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
 
-                    tx = model.getTransactionStore()->createTransaction(connectorId, txNrBack);
+                    tx = model.getTransactionStore()->createTransaction(connectorId, txNrEnd);
                 } else {
                     MO_DBG_ERR("memory corruption");
                     break;
@@ -643,7 +643,7 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
         //couldn't create normal transaction -> check if to start charging without real transaction
         if (silentOfflineTransactionsBool && silentOfflineTransactionsBool->getBool()) {
             //try to handle charging session without sending StartTx or StopTx to the server
-            tx = model.getTransactionStore()->createTransaction(connectorId, txNrBack, true);
+            tx = model.getTransactionStore()->createTransaction(connectorId, txNrEnd, true);
 
             if (tx) {
                 MO_DBG_DEBUG("created silent transaction");
@@ -661,9 +661,9 @@ std::shared_ptr<Transaction> Connector::allocateTransaction() {
     }
 
     if (tx) {
-        txNrBack = (txNrBack + 1) % MAX_TX_CNT;
-        MO_DBG_DEBUG("advance txNrBack %u-%u", connectorId, txNrBack);
-        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+        txNrEnd = (txNrEnd + 1) % MAX_TX_CNT;
+        MO_DBG_DEBUG("advance txNrEnd %u-%u", connectorId, txNrEnd);
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
     }
 
     return tx;
@@ -1083,12 +1083,12 @@ unsigned int Connector::getFrontRequestOpNr() {
      * Advance front transaction?
      */
 
-    unsigned int txSize = (txNrBack + MAX_TX_CNT - txNrFront) % MAX_TX_CNT;
+    unsigned int txSize = (txNrEnd + MAX_TX_CNT - txNrFront) % MAX_TX_CNT;
 
     if (transactionFront && txSize == 0) {
         //catch edge case where txBack has been rolled back and txFront was equal to txBack
         MO_DBG_DEBUG("collect front transaction %u-%u after tx rollback", connectorId, transactionFront->getTxNr());
-        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
         transactionFront = nullptr;
     }
 
@@ -1110,7 +1110,7 @@ unsigned int Connector::getFrontRequestOpNr() {
             MO_DBG_DEBUG("collect front transaction %u-%u", connectorId, transactionFront->getTxNr());
             transactionFront = nullptr;
             txNrFront = (txNrFront + 1) % MAX_TX_CNT;
-            MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrBack=%u", txNrBegin, txNrFront, txNrBack);
+            MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
         } else {
             //front is accurate. Done here
             break;
@@ -1166,7 +1166,7 @@ std::unique_ptr<Request> Connector::fetchFrontRequest() {
             }
 
             Timestamp nextAttempt = transactionFront->getStartSync().getAttemptTime() +
-                                    transactionFront->getStartSync().getAttemptNr() * transactionMessageRetryIntervalInt->getInt();
+                                    transactionFront->getStartSync().getAttemptNr() * std::max(0, transactionMessageRetryIntervalInt->getInt());
 
             if (nextAttempt > model.getClock().now()) {
                 return nullptr;
@@ -1223,7 +1223,7 @@ std::unique_ptr<Request> Connector::fetchFrontRequest() {
             }
 
             Timestamp nextAttempt = transactionFront->getStopSync().getAttemptTime() +
-                                    transactionFront->getStopSync().getAttemptNr() * transactionMessageRetryIntervalInt->getInt();
+                                    transactionFront->getStopSync().getAttemptNr() * std::max(0, transactionMessageRetryIntervalInt->getInt());
 
             if (nextAttempt > model.getClock().now()) {
                 return nullptr;
@@ -1270,3 +1270,15 @@ std::unique_ptr<Request> Connector::fetchFrontRequest() {
 
     return nullptr;
 }
+
+unsigned int Connector::getTxNrBeginHistory() {
+    return txNrBegin;
+}
+
+unsigned int Connector::getTxNrFront() {
+    return txNrFront;
+}
+
+unsigned int Connector::getTxNrEnd() {
+    return txNrEnd;
+}
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 84d2722f..9f4be32a 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -95,7 +95,7 @@ class Connector : public RequestEmitter, public MemoryManaged {
 
     unsigned int txNrBegin = 0; //oldest (historical) transaction on flash. Has no function, but is useful for error diagnosis
     unsigned int txNrFront = 0; //oldest transaction which is still queued to be sent to the server
-    unsigned int txNrBack = 0; //one position behind newest transaction
+    unsigned int txNrEnd = 0; //one position behind newest transaction
 
     std::shared_ptr<Transaction> transactionFront;
 public:
@@ -157,6 +157,10 @@ class Connector : public RequestEmitter, public MemoryManaged {
 
     unsigned int getFrontRequestOpNr() override;
     std::unique_ptr<Request> fetchFrontRequest() override;
+
+    unsigned int getTxNrBeginHistory(); //if getTxNrBeginHistory() != getTxNrFront(), then return value is the txNr of the oldest tx history entry. If equal to getTxNrFront(), then the history is empty
+    unsigned int getTxNrFront(); //if getTxNrEnd() != getTxNrFront(), then return value is the txNr of the oldest transaction queued to be sent to the server. If equal to getTxNrEnd(), then there is no tx to be sent to the server
+    unsigned int getTxNrEnd(); //upper limit for the range of valid txNrs
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 6eb9a3e0..6257ad57 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -19,8 +19,9 @@
 #include <MicroOcpp/Version.h> //for MO_ENABLE_V201
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h> //for MO_ENABLE_CONNECTOR_LOCK
 
-using namespace MicroOcpp;
-using Ocpp16::DiagnosticsStatus;
+using MicroOcpp::DiagnosticsService;
+using MicroOcpp::Ocpp16::DiagnosticsStatus;
+using MicroOcpp::Request;
 
 DiagnosticsService::DiagnosticsService(Context& context) : MemoryManaged("v16.Diagnostics.DiagnosticsService"), context(context), location(makeString(getMemoryTag())), diagFileList(makeVector<String>(getMemoryTag())) {
 
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.cpp b/src/MicroOcpp/Model/Metering/MeterValue.cpp
index c00c4f34..dd52741d 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterValue.cpp
@@ -2,6 +2,8 @@
 // Copyright Matthias Akstaller 2019 - 2024
 // MIT License
 
+#include <limits>
+
 #include <MicroOcpp/Model/Metering/MeterValue.h>
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Debug.h>
@@ -67,6 +69,42 @@ ReadingContext MeterValue::getReadingContext() {
     return ReadingContext::NOT_SET;
 }
 
+void MeterValue::setTxNr(unsigned int txNr) {
+    if (txNr > (unsigned int)std::numeric_limits<int>::max()) {
+        MO_DBG_ERR("invalid arg");
+        return;
+    }
+    this->txNr = (int)txNr;
+}
+
+int MeterValue::getTxNr() {
+    return txNr;
+}
+
+void MeterValue::setOpNr(unsigned int opNr) {
+    this->opNr = opNr;
+}
+
+unsigned int MeterValue::getOpNr() {
+    return opNr;
+}
+
+void MeterValue::advanceAttemptNr() {
+    attemptNr++;
+}
+
+unsigned int MeterValue::getAttemptNr() {
+    return attemptNr;
+}
+
+unsigned long MeterValue::getAttemptTime() {
+    return attemptTime;
+}
+
+void MeterValue::setAttemptTime(unsigned long timestamp) {
+    this->attemptTime = timestamp;
+}
+
 MeterValueBuilder::MeterValueBuilder(const Vector<std::unique_ptr<SampledValueSampler>> &samplers,
             std::shared_ptr<Configuration> samplersSelectStr) :
             MemoryManaged("v16.Metering.MeterValueBuilder"),
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.h b/src/MicroOcpp/Model/Metering/MeterValue.h
index 74351943..0637ad33 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.h
+++ b/src/MicroOcpp/Model/Metering/MeterValue.h
@@ -18,6 +18,11 @@ class MeterValue : public MemoryManaged {
 private:
     Timestamp timestamp;
     Vector<std::unique_ptr<SampledValue>> sampledValue;
+
+    int txNr = -1;
+    unsigned int opNr = 1;
+    unsigned int attemptNr = 0;
+    unsigned long attemptTime = 0;
 public:
     MeterValue(const Timestamp& timestamp);
     MeterValue(const MeterValue& other) = delete;
@@ -30,6 +35,18 @@ class MeterValue : public MemoryManaged {
     void setTimestamp(Timestamp timestamp);
 
     ReadingContext getReadingContext();
+
+    void setTxNr(unsigned int txNr);
+    int getTxNr();
+
+    void setOpNr(unsigned int opNr);
+    unsigned int getOpNr();
+
+    void advanceAttemptNr();
+    unsigned int getAttemptNr();
+
+    unsigned long getAttemptTime();
+    void setAttemptTime(unsigned long timestamp);
 };
 
 class MeterValueBuilder : public MemoryManaged {
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index 737a106e..ad3b6807 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -5,8 +5,11 @@
 #include <MicroOcpp/Model/Metering/MeteringConnector.h>
 #include <MicroOcpp/Model/Metering/MeterStore.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
 #include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Operations/MeterValues.h>
 #include <MicroOcpp/Platform.h>
 #include <MicroOcpp/Debug.h>
@@ -17,12 +20,13 @@
 using namespace MicroOcpp;
 using namespace MicroOcpp::Ocpp16;
 
-MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore& meterStore)
-        : MemoryManaged("v16.Metering.MeteringConnector"), model(model), connectorId{connectorId}, meterStore(meterStore), meterData(makeVector<std::unique_ptr<MeterValue>>(getMemoryTag())), samplers(makeVector<std::unique_ptr<SampledValueSampler>>(getMemoryTag())) {
+MeteringConnector::MeteringConnector(Context& context, int connectorId, MeterStore& meterStore)
+        : MemoryManaged("v16.Metering.MeteringConnector"), context(context), model(context.getModel()), connectorId{connectorId}, meterStore(meterStore), meterData(makeVector<std::unique_ptr<MeterValue>>(getMemoryTag())), samplers(makeVector<std::unique_ptr<SampledValueSampler>>(getMemoryTag())) {
+
+    context.getRequestQueue().addSendQueue(this);
 
     auto meterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData", "");
     declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
-    meterValueCacheSizeInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "MeterValueCacheSize", 1);
     meterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval", 60);
 
     auto stopTxnSampledDataString = declareConfiguration<const char*>("StopTxnSampledData", "");
@@ -37,13 +41,16 @@ MeteringConnector::MeteringConnector(Model& model, int connectorId, MeterStore&
     meterValuesInTxOnlyBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "MeterValuesInTxOnly", true);
     stopTxnDataCapturePeriodicBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "StopTxnDataCapturePeriodic", false);
 
+    transactionMessageAttemptsInt = declareConfiguration<int>("TransactionMessageAttempts", 3);
+    transactionMessageRetryIntervalInt = declareConfiguration<int>("TransactionMessageRetryInterval", 60);
+
     sampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, meterValuesSampledDataString));
     alignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, meterValuesAlignedDataString));
     stopTxnSampledDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, stopTxnSampledDataString));
     stopTxnAlignedDataBuilder = std::unique_ptr<MeterValueBuilder>(new MeterValueBuilder(samplers, stopTxnAlignedDataString));
 }
 
-std::unique_ptr<Operation> MeteringConnector::loop() {
+void MeteringConnector::loop() {
 
     bool txBreak = false;
     if (model.getConnector(connectorId)) {
@@ -56,12 +63,6 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         lastSampleTime = mocpp_tick_ms();
     }
 
-    if ((txBreak || meterData.size() >= (size_t) meterValueCacheSizeInt->getInt()) && !meterData.empty()) {
-        auto meterValues = std::unique_ptr<MeterValues>(new MeterValues(model, std::move(meterData), connectorId, transaction));
-        meterData = makeVector<std::unique_ptr<MeterValue>>(getMemoryTag());
-        return std::move(meterValues); //std::move is required for some compilers even if it's not mandated by standard C++
-    }
-
     if (model.getConnector(connectorId)) {
         if (transaction != model.getConnector(connectorId)->getTransaction()) {
             transaction = model.getConnector(connectorId)->getTransaction();
@@ -80,8 +81,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
 
             if (connectorId != 0 && meterValuesInTxOnlyBool->getBool()) {
                 //don't take any MeterValues outside of transactions on connectorIds other than 0
-                meterData.clear();
-                return nullptr;
+                return;
             }
         }
     }
@@ -97,9 +97,17 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
                 abs(dt) <= 60 ?
                 "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
-                auto alignedMeterValues = alignedDataBuilder->takeSample(model.getClock().now(), ReadingContext::SampleClock);
-                if (alignedMeterValues) {
-                    meterData.push_back(std::move(alignedMeterValues));
+
+                if (auto alignedMeterValue = alignedDataBuilder->takeSample(model.getClock().now(), ReadingContext::SampleClock)) {
+                    if (meterData.size() >= MO_METERVALUES_CACHE_MAXSIZE) {
+                        MO_DBG_INFO("MeterValue cache full. Drop old MV");
+                        meterData.erase(meterData.begin());
+                    }
+                    alignedMeterValue->setOpNr(context.getRequestQueue().getNextOpNr());
+                    if (transaction) {
+                        alignedMeterValue->setTxNr(transaction->getTxNr());
+                    }
+                    meterData.push_back(std::move(alignedMeterValue));
                 }
 
                 if (stopTxnData) {
@@ -130,9 +138,16 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
         //record periodic tx data
 
         if (mocpp_tick_ms() - lastSampleTime >= (unsigned long) (meterValueSampleIntervalInt->getInt() * 1000)) {
-            auto sampleMeterValues = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::SamplePeriodic);
-            if (sampleMeterValues) {
-                meterData.push_back(std::move(sampleMeterValues));
+            if (auto sampledMeterValue = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::SamplePeriodic)) {
+                if (meterData.size() >= MO_METERVALUES_CACHE_MAXSIZE) {
+                    MO_DBG_INFO("MeterValue cache full. Drop old MV");
+                    meterData.erase(meterData.begin());
+                }
+                sampledMeterValue->setOpNr(context.getRequestQueue().getNextOpNr());
+                if (transaction) {
+                    sampledMeterValue->setTxNr(transaction->getTxNr());
+                }
+                meterData.push_back(std::move(sampledMeterValue));
             }
 
             if (stopTxnData && stopTxnDataCapturePeriodicBool->getBool()) {
@@ -144,12 +159,6 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
             lastSampleTime = mocpp_tick_ms();
         }
     }
-
-    if (clockAlignedDataIntervalInt->getInt() < 1 && meterValueSampleIntervalInt->getInt() < 1) {
-        meterData.clear();
-    }
-
-    return nullptr; //successful method completition. Currently there is no reason to send a MeterValues Msg.
 }
 
 std::unique_ptr<Operation> MeteringConnector::takeTriggeredMeterValues() {
@@ -160,15 +169,12 @@ std::unique_ptr<Operation> MeteringConnector::takeTriggeredMeterValues() {
         return nullptr;
     }
 
-    decltype(meterData) mv_now;
-    mv_now.push_back(std::move(sample));
-
     std::shared_ptr<Transaction> transaction = nullptr;
     if (model.getConnector(connectorId)) {
         transaction = model.getConnector(connectorId)->getTransaction();
     }
 
-    return std::unique_ptr<MeterValues>(new MeterValues(model, std::move(mv_now), connectorId, transaction));
+    return std::unique_ptr<MeterValues>(new MeterValues(model, std::move(sample), connectorId, transaction));
 }
 
 void MeteringConnector::addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler) {
@@ -240,3 +246,57 @@ bool MeteringConnector::existsSampler(const char *measurand, size_t len) {
 
     return false;
 }
+
+unsigned int MeteringConnector::getFrontRequestOpNr() {
+    if (!meterDataFront && !meterData.empty()) {
+        MO_DBG_DEBUG("advance MV front");
+        meterDataFront = std::move(meterData.front());
+        meterData.erase(meterData.begin());
+    }
+    if (meterDataFront) {
+        return meterDataFront->getOpNr();
+    }
+    return NoOperation;
+}
+
+std::unique_ptr<Request> MeteringConnector::fetchFrontRequest() {
+
+    if (!meterDataFront) {
+        return nullptr;
+    }
+
+    if ((int)meterDataFront->getAttemptNr() >= transactionMessageAttemptsInt->getInt()) {
+        MO_DBG_WARN("exceeded TransactionMessageAttempts. Discard MeterValue");
+        meterDataFront.reset();
+        return nullptr;
+    }
+
+    if (mocpp_tick_ms() - meterDataFront->getAttemptTime() < meterDataFront->getAttemptNr() * (unsigned long)(std::max(0, transactionMessageRetryIntervalInt->getInt())) * 1000UL) {
+        return nullptr;
+    }
+
+    meterDataFront->advanceAttemptNr();
+    meterDataFront->setAttemptTime(mocpp_tick_ms());
+
+    //fetch tx for meterValue
+    std::shared_ptr<Transaction> tx;
+    if (meterDataFront->getTxNr() >= 0) {
+        tx = model.getTransactionStore()->getTransaction(connectorId, meterDataFront->getTxNr());
+    }
+
+    //discard MV if it belongs to silent tx
+    if (tx && tx->isSilent()) {
+        MO_DBG_DEBUG("Drop MeterValue belonging to silent tx");
+        meterDataFront.reset();
+        return nullptr;
+    }
+
+    auto meterValues = makeRequest(new MeterValues(model, meterDataFront.get(), connectorId, tx));
+    meterValues->setOnReceiveConfListener([this] (JsonObject) {
+        //operation success
+        MO_DBG_DEBUG("drop MV front");
+        meterDataFront.reset();
+    });
+
+    return meterValues;
+}
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.h b/src/MicroOcpp/Model/Metering/MeteringConnector.h
index 881c7aa1..75873ff6 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.h
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.h
@@ -12,22 +12,29 @@
 #include <MicroOcpp/Model/Metering/MeterStore.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
+#include <MicroOcpp/Core/RequestQueue.h>
 #include <MicroOcpp/Core/Memory.h>
 
+#ifndef MO_METERVALUES_CACHE_MAXSIZE
+#define MO_METERVALUES_CACHE_MAXSIZE MO_REQUEST_CACHE_MAXSIZE
+#endif
+
 namespace MicroOcpp {
 
+class Context;
 class Model;
 class Operation;
-class Transaction;
 class MeterStore;
 
-class MeteringConnector : public MemoryManaged {
+class MeteringConnector : public MemoryManaged, public RequestEmitter {
 private:
+    Context& context;
     Model& model;
     const int connectorId;
     MeterStore& meterStore;
     
     Vector<std::unique_ptr<MeterValue>> meterData;
+    std::unique_ptr<MeterValue> meterDataFront;
     std::shared_ptr<TransactionMeterData> stopTxnData;
 
     std::unique_ptr<MeterValueBuilder> sampledDataBuilder;
@@ -49,16 +56,18 @@ class MeteringConnector : public MemoryManaged {
     int energySamplerIndex {-1};
 
     std::shared_ptr<Configuration> meterValueSampleIntervalInt;
-    std::shared_ptr<Configuration> meterValueCacheSizeInt;
 
     std::shared_ptr<Configuration> clockAlignedDataIntervalInt;
 
     std::shared_ptr<Configuration> meterValuesInTxOnlyBool;
     std::shared_ptr<Configuration> stopTxnDataCapturePeriodicBool;
+
+    std::shared_ptr<Configuration> transactionMessageAttemptsInt;
+    std::shared_ptr<Configuration> transactionMessageRetryIntervalInt;
 public:
-    MeteringConnector(Model& model, int connectorId, MeterStore& meterStore);
+    MeteringConnector(Context& context, int connectorId, MeterStore& meterStore);
 
-    std::unique_ptr<Operation> loop();
+    void loop();
 
     void addMeterValueSampler(std::unique_ptr<SampledValueSampler> meterValueSampler);
 
@@ -76,6 +85,10 @@ class MeteringConnector : public MemoryManaged {
 
     bool existsSampler(const char *measurand, size_t len);
 
+    //RequestEmitter implementation
+    unsigned int getFrontRequestOpNr() override;
+    std::unique_ptr<Request> fetchFrontRequest() override;
+
 };
 
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index a404ab48..287f026a 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -22,8 +22,9 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
     declareConfiguration<const char*>("MeterValuesAlignedData", "Energy.Active.Import.Register,Power.Active.Import");
     declareConfiguration<const char*>("StopTxnAlignedData", "");
     
+    connectors.reserve(numConn);
     for (int i = 0; i < numConn; i++) {
-        connectors.emplace_back(new MeteringConnector(context.getModel(), i, meterStore));
+        connectors.emplace_back(new MeteringConnector(context, i, meterStore));
     }
 
     std::function<bool(const char*)> validateSelectString = [this] (const char *csl) {
@@ -83,14 +84,8 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
 }
 
 void MeteringService::loop(){
-
     for (unsigned int i = 0; i < connectors.size(); i++){
-        auto meterValuesMsg = connectors[i]->loop();
-        if (meterValuesMsg != nullptr) {
-            auto meterValues = makeRequest(std::move(meterValuesMsg));
-            meterValues->setTimeout(120000);
-            context.initiateRequest(std::move(meterValues));
-        }
+        connectors[i]->loop();
     }
 }
 
diff --git a/src/MicroOcpp/Operations/MeterValues.cpp b/src/MicroOcpp/Operations/MeterValues.cpp
index f6ab2d7c..ee2b4c7e 100644
--- a/src/MicroOcpp/Operations/MeterValues.cpp
+++ b/src/MicroOcpp/Operations/MeterValues.cpp
@@ -11,18 +11,21 @@
 using MicroOcpp::Ocpp16::MeterValues;
 using MicroOcpp::JsonDoc;
 
-#define ENERGY_METER_TIMEOUT_MS 30 * 1000  //after waiting for 30s, send MeterValues without missing readings
-
 //can only be used for echo server debugging
 MeterValues::MeterValues(Model& model) : MemoryManaged("v16.Operation.", "MeterValues"), model(model) {
     
 }
 
-MeterValues::MeterValues(Model& model, Vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction) 
-      : MemoryManaged("v16.Operation.", "MeterValues"), model(model), meterValue{std::move(meterValue)}, connectorId{connectorId}, transaction{transaction} {
+MeterValues::MeterValues(Model& model, MeterValue *meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction) 
+      : MemoryManaged("v16.Operation.", "MeterValues"), model(model), meterValue{meterValue}, connectorId{connectorId}, transaction{transaction} {
     
 }
 
+MeterValues::MeterValues(Model& model, std::unique_ptr<MeterValue> meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction)
+      : MeterValues(model, meterValue.get(), connectorId, transaction) {
+    this->meterValueOwnership = std::move(meterValue);
+}
+
 MeterValues::~MeterValues(){
 
 }
@@ -34,27 +37,27 @@ const char* MeterValues::getOperationType(){
 std::unique_ptr<JsonDoc> MeterValues::createReq() {
 
     size_t capacity = 0;
-    
-    auto entries = makeVector<std::unique_ptr<JsonDoc>>(getMemoryTag());
-    for (auto mv = meterValue.begin(); mv != meterValue.end(); mv++) {
 
-        if ((*mv)->getTimestamp() < MIN_TIME) {
+    std::unique_ptr<JsonDoc> meterValueJson;
+
+    if (meterValue) {
+
+        if (meterValue->getTimestamp() < MIN_TIME) {
             MO_DBG_DEBUG("adjust preboot MeterValue timestamp");
-            Timestamp adjusted = model.getClock().adjustPrebootTimestamp((*mv)->getTimestamp());
-            (*mv)->setTimestamp(adjusted);
+            Timestamp adjusted = model.getClock().adjustPrebootTimestamp(meterValue->getTimestamp());
+            meterValue->setTimestamp(adjusted);
         }
 
-        auto entry = (*mv)->toJson();
-        if (entry) {
-            capacity += entry->capacity();
-            entries.push_back(std::move(entry));
+        meterValueJson = meterValue->toJson();
+        if (meterValueJson) {
+            capacity += meterValueJson->capacity();
         } else {
             MO_DBG_ERR("Energy meter reading not convertible to JSON");
         }
     }
 
     capacity += JSON_OBJECT_SIZE(3);
-    capacity += JSON_ARRAY_SIZE(entries.size());
+    capacity += JSON_ARRAY_SIZE(1);
 
     auto doc = makeJsonDoc(getMemoryTag(), capacity);
     auto payload = doc->to<JsonObject>();
@@ -64,9 +67,9 @@ std::unique_ptr<JsonDoc> MeterValues::createReq() {
         payload["transactionId"] = transaction->getTransactionId();
     }
 
-    auto meterValueJson = payload.createNestedArray("meterValue");
-    for (auto entry = entries.begin(); entry != entries.end(); entry++) {
-        meterValueJson.add(**entry);
+    auto meterValueArray = payload.createNestedArray("meterValue");
+    if (meterValueJson) {
+        meterValueArray.add(*meterValueJson);
     }
 
     return doc;
diff --git a/src/MicroOcpp/Operations/MeterValues.h b/src/MicroOcpp/Operations/MeterValues.h
index f4e4be4e..774a538a 100644
--- a/src/MicroOcpp/Operations/MeterValues.h
+++ b/src/MicroOcpp/Operations/MeterValues.h
@@ -20,14 +20,16 @@ namespace Ocpp16 {
 class MeterValues : public Operation, public MemoryManaged {
 private:
     Model& model; //for adjusting the timestamp if MeterValue has been created before BootNotification
-    Vector<std::unique_ptr<MeterValue>> meterValue;
+    MeterValue *meterValue = nullptr;
+    std::unique_ptr<MeterValue> meterValueOwnership;
 
     unsigned int connectorId = 0;
 
     std::shared_ptr<Transaction> transaction;
 
 public:
-    MeterValues(Model& model, Vector<std::unique_ptr<MeterValue>>&& meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction = nullptr);
+    MeterValues(Model& model, MeterValue *meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction = nullptr);
+    MeterValues(Model& model, std::unique_ptr<MeterValue> meterValue, unsigned int connectorId, std::shared_ptr<Transaction> transaction = nullptr);
 
     MeterValues(Model& model); //for debugging only. Make this for the server pendant
 
diff --git a/src/MicroOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
index 518353a0..7a537f6d 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.cpp
+++ b/src/MicroOcpp/Operations/TriggerMessage.cpp
@@ -36,12 +36,16 @@ void TriggerMessage::processReq(JsonObject payload) {
             if (connectorId < 0) {
                 auto nConnectors = mService->getNumConnectors();
                 for (decltype(nConnectors) cId = 0; cId < nConnectors; cId++) {
-                    context.getRequestQueue().sendRequestPreBoot(mService->takeTriggeredMeterValues(cId));
-                    statusMessage = "Accepted";
+                    if (auto meterValues = mService->takeTriggeredMeterValues(cId)) {
+                        context.getRequestQueue().sendRequestPreBoot(std::move(meterValues));
+                        statusMessage = "Accepted";
+                    }
                 }
             } else if (connectorId < mService->getNumConnectors()) {
-                context.getRequestQueue().sendRequestPreBoot(mService->takeTriggeredMeterValues(connectorId));
-                statusMessage = "Accepted";
+                if (auto meterValues = mService->takeTriggeredMeterValues(connectorId)) {
+                    context.getRequestQueue().sendRequestPreBoot(std::move(meterValues));
+                    statusMessage = "Accepted";
+                }
             } else {
                 errorCode = "PropertyConstraintViolation";
             }
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 144d4a37..23e79fe5 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -6,12 +6,16 @@
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Metering/MeteringConnector.h>
 #include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
 #include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 
+#define TRIGGER_METERVALUES "[2,\"msgId01\",\"TriggerMessage\",{\"requestedMessage\":\"MeterValues\"}]"
+
 using namespace MicroOcpp;
 
 TEST_CASE("Metering") {
@@ -101,19 +105,14 @@ TEST_CASE("Metering") {
         auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
         MeterValueSampleIntervalInt->setInt(10);
 
-        auto MeterValueCacheSizeInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0);
-        MeterValueCacheSizeInt->setInt(2);
-
         bool checkProcessed = false;
 
         setOnReceiveRequest("MeterValues", [base, &checkProcessed] (JsonObject payload) {
             checkProcessed = true;
-            Timestamp t0, t1;
+            Timestamp t0;
             t0.setTime(payload["meterValue"][0]["timestamp"] | "");
-            t1.setTime(payload["meterValue"][1]["timestamp"] | "");
 
             REQUIRE((t0 - base >= 10 && t0 - base <= 11));
-            REQUIRE((t1 - base >= 20 && t1 - base <= 21));
 
             REQUIRE(!strcmp(payload["meterValue"][0]["sampledValue"][0]["context"] | "", "Sample.Periodic"));
         });
@@ -130,10 +129,6 @@ TEST_CASE("Metering") {
 
         mtime = trackMtime + 10 * 1000;
 
-        loop(),
-
-        mtime = trackMtime + 20 * 1000;
-
         loop();
 
         endTransaction();
@@ -163,19 +158,14 @@ TEST_CASE("Metering") {
         auto MeterValuesAlignedDataString = declareConfiguration<const char*>("MeterValuesAlignedData", "", CONFIGURATION_FN);
         MeterValuesAlignedDataString->setString("Energy.Active.Import.Register");
 
-        auto MeterValueCacheSizeInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
-        MeterValueCacheSizeInt->setInt(2);
-
         bool checkProcessed = false;
 
         setOnReceiveRequest("MeterValues", [base, &checkProcessed] (JsonObject payload) {
             checkProcessed = true;
-            Timestamp t0, t1;
+            Timestamp t0;
             t0.setTime(payload["meterValue"][0]["timestamp"] | "");
-            t1.setTime(payload["meterValue"][1]["timestamp"] | "");
 
             REQUIRE((t0 - base >= 900 && t0 - base <= 901));
-            REQUIRE((t1 - base >= 1800 && t1 - base <= 1801));
 
             REQUIRE(!strcmp(payload["meterValue"][0]["sampledValue"][0]["context"] | "", "Sample.Clock"));
         });
@@ -194,10 +184,6 @@ TEST_CASE("Metering") {
         loop();
 
         model.getClock().setTime("2023-01-01T00:29:50Z");
-        loop();
-
-        model.getClock().setTime("2023-01-01T00:30:00Z");
-        loop();
 
         endTransaction();
 
@@ -329,22 +315,16 @@ TEST_CASE("Metering") {
         auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
         MeterValueSampleIntervalInt->setInt(10);
 
-        auto MeterValueCacheSizeInt = declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "MeterValueCacheSize", 0, CONFIGURATION_FN);
-        MeterValueCacheSizeInt->setInt(10);
-
         bool checkProcessed = false;
 
         setOnReceiveRequest("MeterValues", [base, &checkProcessed] (JsonObject payload) {
             checkProcessed = true;
-            Timestamp t0, t1;
+            Timestamp t0;
             t0.setTime(payload["meterValue"][0]["timestamp"] | "");
-            t1.setTime(payload["meterValue"][1]["timestamp"] | "");
 
             REQUIRE((t0 - base >= 10 && t0 - base <= 11));
-            REQUIRE((t1 - base >= 20 && t1 - base <= 21));
             
-            REQUIRE(!strcmp(payload["meterValue"][0]["sampledValue"][0]["measurand"] | "", "Energy.Active.Import.Register"));
-            REQUIRE(!strcmp(payload["meterValue"][1]["sampledValue"][0]["measurand"] | "", "Power.Active.Import"));
+            REQUIRE(!strcmp(payload["meterValue"][0]["sampledValue"][0]["measurand"] | "", "Power.Active.Import"));
         });
 
         loop();
@@ -355,15 +335,135 @@ TEST_CASE("Metering") {
 
         beginTransaction_authorized("mIdTag");
 
+        MeterValuesSampledDataString->setString("Power.Active.Import");
+
         loop();
 
         mtime = trackMtime + 10 * 1000;
 
         loop();
 
-        MeterValuesSampledDataString->setString("Power.Active.Import");
+        endTransaction();
 
-        mtime = trackMtime + 20 * 1000;
+        loop();
+
+        REQUIRE(checkProcessed);
+    }
+
+    SECTION("Preserve order of tx-related msgs") {
+
+        loopback.setConnected(false);
+
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true)->setBool(true);
+
+        Timestamp base;
+        base.setTime(BASE_TIME);
+
+        addMeterValueInput([base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        auto MeterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Energy.Active.Import.Register");
+
+        auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        MeterValueSampleIntervalInt->setInt(10);
+
+        configuration_save();
+
+        unsigned int countProcessed = 0;
+
+        setOnReceiveRequest("StartTransaction", [&countProcessed] (JsonObject) {
+            REQUIRE(countProcessed == 0);
+            countProcessed++;
+        });
+
+        int assignedTxId = -1;
+
+        setOnSendConf("StartTransaction", [&assignedTxId] (JsonObject conf) {
+            assignedTxId = conf["transactionId"];
+        });
+
+        setOnReceiveRequest("MeterValues", [&countProcessed, &assignedTxId] (JsonObject req) {
+            REQUIRE(countProcessed == 1);
+            countProcessed++;
+
+            int transactionId = req["transactionId"] | -1000;
+
+            REQUIRE(assignedTxId == transactionId);
+        });
+
+        setOnReceiveRequest("StopTransaction", [&countProcessed] (JsonObject) {
+            REQUIRE(countProcessed == 2);
+            countProcessed++;
+        });
+
+        loop();
+
+        auto trackMtime = mtime;
+
+        beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        mtime = trackMtime + 10 * 1000;
+
+        loop();
+
+        endTransaction();
+
+        loop();
+
+        loopback.setConnected(true);
+
+        loop();
+
+        REQUIRE(countProcessed == 3);
+
+        /*
+         * Combine test case with power loss. Start tx before power loss, then enqueue 1 MV, then StopTx
+         */
+
+        countProcessed = 0;
+
+        beginTransaction("mIdTag");
+
+        loop();
+
+        mocpp_deinitialize();
+
+        loopback.setConnected(false);
+
+        mocpp_initialize(loopback, ChargerCredentials());
+        getOcppContext()->getModel().getClock().setTime(BASE_TIME);
+
+        base.setTime(BASE_TIME);
+
+        addMeterValueInput([base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        setOnReceiveRequest("MeterValues", [&countProcessed, &assignedTxId] (JsonObject req) {
+            REQUIRE(countProcessed == 1);
+            countProcessed++;
+
+            int transactionId = req["transactionId"] | -1000;
+
+            REQUIRE(assignedTxId == transactionId);
+        });
+
+        setOnReceiveRequest("StopTransaction", [&countProcessed] (JsonObject) {
+            REQUIRE(countProcessed == 2);
+            countProcessed++;
+        });
+
+        trackMtime = mtime;
+
+        loop();
+
+        mtime = trackMtime + 10 * 1000;
 
         loop();
 
@@ -371,7 +471,259 @@ TEST_CASE("Metering") {
 
         loop();
 
+        loopback.setConnected(true);
+
+        loop();
+
+        REQUIRE(countProcessed == 3);
+    }
+
+    SECTION("Queue multiple MeterValues") {
+
+        Timestamp base;
+        base.setTime(BASE_TIME);
+        model.getClock().setTime(BASE_TIME);
+
+        addMeterValueInput([base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        auto MeterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Energy.Active.Import.Register");
+
+        auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        MeterValueSampleIntervalInt->setInt(10);
+
+        unsigned int nrInitiated = 0;
+        unsigned int countProcessed = 0;
+
+        setOnReceiveRequest("MeterValues", [&base, &nrInitiated, &countProcessed] (JsonObject payload) {
+            countProcessed++;
+
+            Timestamp t0;
+            t0.setTime(payload["meterValue"][0]["timestamp"] | "");
+
+            REQUIRE((t0 - base >= 10 * ((int)nrInitiated - (MO_METERVALUES_CACHE_MAXSIZE - (int)countProcessed)) && t0 - base <= 1 + 10 * ((int)nrInitiated - (MO_METERVALUES_CACHE_MAXSIZE - (int)countProcessed))));
+        });
+
+
+        loop();
+
+        beginTransaction_authorized("mIdTag");
+
+        base = model.getClock().now();
+        auto trackMtime = mtime;
+
+        loop();
+
+        loopback.setConnected(false);
+
+        //initiate 10 more MeterValues than can be cached
+        for (unsigned long i = 1; i <= 10 + MO_METERVALUES_CACHE_MAXSIZE; i++) {
+            mtime = trackMtime + i * 10 * 1000;
+            loop();
+
+            nrInitiated++;
+        }
+
+        loopback.setConnected(true);
+
+        loop();
+
+        REQUIRE(countProcessed == MO_METERVALUES_CACHE_MAXSIZE);
+
+        endTransaction();
+
+        loop();
+
+    }
+
+    SECTION("Drop MeterValues for silent tx") {
+
+        loopback.setConnected(false);
+
+        declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "PreBootTransactions", true)->setBool(true);
+
+        Timestamp base;
+        base.setTime(BASE_TIME);
+
+        addMeterValueInput([base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        auto MeterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Energy.Active.Import.Register");
+
+        auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        MeterValueSampleIntervalInt->setInt(10);
+
+        configuration_save();
+
+        unsigned int countProcessed = 0;
+
+        setOnReceiveRequest("StartTransaction", [&countProcessed] (JsonObject) {
+            countProcessed++;
+        });
+
+        int assignedTxId = -1;
+
+        setOnSendConf("StartTransaction", [&assignedTxId] (JsonObject conf) {
+            assignedTxId = conf["transactionId"];
+        });
+
+        setOnReceiveRequest("MeterValues", [&countProcessed, &assignedTxId] (JsonObject req) {
+            countProcessed++;
+        });
+
+        setOnReceiveRequest("StopTransaction", [&countProcessed] (JsonObject) {
+            REQUIRE(countProcessed == 2);
+        });
+
+        loop();
+
+        auto trackMtime = mtime;
+
+        auto tx = beginTransaction_authorized("mIdTag");
+
+        loop();
+
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging );
+
+        mtime = trackMtime + 10 * 1000;
+
+        loop();
+
+        endTransaction();
+
+        loop();
+
+        tx->setSilent();
+        tx->commit();
+
+        loopback.setConnected(true);
+
+        loop();
+
+        REQUIRE(countProcessed == 0);
+    }
+
+    SECTION("TxMsg retry behavior") {
+        
+        Timestamp base;
+
+        addMeterValueInput([&base] () {
+            //simulate 3600W consumption
+            return getOcppContext()->getModel().getClock().now() - base;
+        }, "Energy.Active.Import.Register");
+
+        auto MeterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Energy.Active.Import.Register");
+
+        auto MeterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval",0, CONFIGURATION_FN);
+        MeterValueSampleIntervalInt->setInt(10);
+
+        configuration_save();
+
+        const size_t NUM_ATTEMPTS = 3;
+        const int RETRY_INTERVAL_SECS = 3600;
+
+        declareConfiguration<int>("TransactionMessageAttempts", 0)->setInt(NUM_ATTEMPTS);
+        declareConfiguration<int>("TransactionMessageRetryInterval", 0)->setInt(RETRY_INTERVAL_SECS);
+
+        unsigned int attemptNr = 0;
+
+        getOcppContext()->getOperationRegistry().registerOperation("MeterValues", [&attemptNr] () {
+            return new Ocpp16::CustomOperation("MeterValues",
+                [&attemptNr] (JsonObject payload) {
+                    //receive req
+                    attemptNr++;
+                },
+                [] () {
+                    //create conf
+                    return createEmptyDocument();
+                },
+                [] () {
+                    //ErrorCode for CALLERROR
+                    return "InternalError";
+                });});
+
+        loop();
+
+        auto trackMtime = mtime;
+        base = model.getClock().now();
+
+        beginTransaction("mIdTag");
+
+        loop();
+
+        mtime = trackMtime + 10 * 1000;
+
+        loop();
+
+        REQUIRE(attemptNr == 1);
+
+        endTransaction();
+
+        mtime = trackMtime + 20 * 1000;
+        loop();
+        REQUIRE(attemptNr == 1);
+
+        mtime = trackMtime + 10 * 1000 + RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE(attemptNr == 2);
+
+        mtime = trackMtime + 10 * 1000 + 2 * RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE(attemptNr == 2);
+
+        mtime = trackMtime + 10 * 1000 + 3 * RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE(attemptNr == 3);
+
+        mtime = trackMtime + 10 * 1000 + 7 * RETRY_INTERVAL_SECS * 1000;
+        loop();
+        REQUIRE(attemptNr == 3);
+    }
+
+    SECTION("TriggerMessage") {
+        
+        addMeterValueInput([] () {
+            return 12345;
+        }, "Energy.Active.Import.Register");
+
+        auto MeterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData","", CONFIGURATION_FN);
+        MeterValuesSampledDataString->setString("Energy.Active.Import.Register");
+
+        Timestamp base;
+
+        bool checkProcessed = false;
+
+        setOnReceiveRequest("MeterValues", [&base, &checkProcessed] (JsonObject payload) {
+            int connectorId = payload["connectorId"] | -1;
+            if (connectorId != 1) {
+                return;
+            }
+
+            checkProcessed = true;
+
+            Timestamp t0;
+            t0.setTime(payload["meterValue"][0]["timestamp"] | "");
+
+            REQUIRE( std::abs(t0 - base) <= 1 );
+            REQUIRE( !strncmp(payload["meterValue"][0]["sampledValue"][0]["value"] | "", "12345", strlen("12345")) );
+        });
+
+        loop();
+
+        base = model.getClock().now();
+
+        loopback.sendTXT(TRIGGER_METERVALUES, sizeof(TRIGGER_METERVALUES) - 1);
+        loop();
+
         REQUIRE(checkProcessed);
+
     }
 
     mocpp_deinitialize();

From 974b7b9e8198aa6e4739a3a57932d77b14a7c4b2 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Wed, 21 Aug 2024 17:49:15 +0200
Subject: [PATCH 518/549] Support errorCode in triggered StatusNotifications
 (#359)

* add triggerStatusNotif which is aware about errorData

* update changelog
---
 CHANGELOG.md                                  |  1 +
 .../Model/ConnectorBase/Connector.cpp         | 31 +++++++++++++++++++
 src/MicroOcpp/Model/ConnectorBase/Connector.h |  2 ++
 src/MicroOcpp/Operations/TriggerMessage.cpp   | 14 ++-------
 4 files changed, 37 insertions(+), 11 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index eb5f732c..ff0a8467 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -43,6 +43,7 @@
 - UnlockConnector NotSupported if connectorId invalid ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Fix regression bug of [#345](https://github.com/matth-x/MicroOcpp/pull/345) ([#353](https://github.com/matth-x/MicroOcpp/pull/353), [#356](https://github.com/matth-x/MicroOcpp/pull/356))
 - Correct MeterValue PreBoot timestamp ([#354](https://github.com/matth-x/MicroOcpp/pull/354))
+- Send errorCode in triggered StatusNotif ([#359](https://github.com/matth-x/MicroOcpp/pull/359))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index d1adc1ea..c0911858 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -1271,6 +1271,37 @@ std::unique_ptr<Request> Connector::fetchFrontRequest() {
     return nullptr;
 }
 
+bool Connector::triggerStatusNotification() {
+
+    ErrorData errorData {nullptr};
+    errorData.severity = 0;
+
+    if (reportedErrorIndex >= 0) {
+        errorData = errorDataInputs[reportedErrorIndex].operator()();
+    } else {
+        //find errorData with maximum severity
+        for (auto i = errorDataInputs.size(); i >= 1; i--) {
+            auto index = i - 1;
+            ErrorData error = errorDataInputs[index].operator()();
+            if (error.isError && error.severity >= errorData.severity) {
+                errorData = error;
+            }
+        }
+    }
+
+    auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
+                connectorId,
+                getStatus(),
+                context.getModel().getClock().now(),
+                errorData));
+
+    statusNotification->setTimeout(60000);
+
+    context.getRequestQueue().sendRequestPreBoot(std::move(statusNotification));
+
+    return true;
+}
+
 unsigned int Connector::getTxNrBeginHistory() {
     return txNrBegin;
 }
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 9f4be32a..541c1f4c 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -158,6 +158,8 @@ class Connector : public RequestEmitter, public MemoryManaged {
     unsigned int getFrontRequestOpNr() override;
     std::unique_ptr<Request> fetchFrontRequest() override;
 
+    bool triggerStatusNotification();
+
     unsigned int getTxNrBeginHistory(); //if getTxNrBeginHistory() != getTxNrFront(), then return value is the txNr of the oldest tx history entry. If equal to getTxNrFront(), then the history is empty
     unsigned int getTxNrFront(); //if getTxNrEnd() != getTxNrFront(), then return value is the txNr of the oldest transaction queued to be sent to the server. If equal to getTxNrEnd(), then there is no tx to be sent to the server
     unsigned int getTxNrEnd(); //upper limit for the range of valid txNrs
diff --git a/src/MicroOcpp/Operations/TriggerMessage.cpp b/src/MicroOcpp/Operations/TriggerMessage.cpp
index 7a537f6d..9b930697 100644
--- a/src/MicroOcpp/Operations/TriggerMessage.cpp
+++ b/src/MicroOcpp/Operations/TriggerMessage.cpp
@@ -5,7 +5,6 @@
 #include <MicroOcpp/Operations/TriggerMessage.h>
 #include <MicroOcpp/Model/ConnectorBase/Connector.h>
 #include <MicroOcpp/Model/Metering/MeteringService.h>
-#include <MicroOcpp/Operations/StatusNotification.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Core/Request.h>
@@ -63,16 +62,9 @@ void TriggerMessage::processReq(JsonObject payload) {
 
         for (auto i = cIdRangeBegin; i < cIdRangeEnd; i++) {
             auto connector = context.getModel().getConnector(i);
-
-            auto statusNotification = makeRequest(new Ocpp16::StatusNotification(
-                        i,
-                        connector->getStatus(), //will be determined in StatusNotification::initiate
-                        context.getModel().getClock().now()));
-
-            statusNotification->setTimeout(60000);
-
-            context.getRequestQueue().sendRequestPreBoot(std::move(statusNotification));
-            statusMessage = "Accepted";
+            if (connector->triggerStatusNotification()) {
+                statusMessage = "Accepted";
+            }
         }
     } else {
         auto msg = context.getOperationRegistry().deserializeOperation(requestedMessage);

From 46d43990903c5ec27149d340473046523c3ed24a Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Mon, 26 Aug 2024 11:07:03 +0200
Subject: [PATCH 519/549] Remove int to bool conversion in ChangeConfiguation
 (#362)

* remove int to bool conversion in ChangeConfiguation

* update changelog
---
 CHANGELOG.md                                     | 1 +
 src/MicroOcpp/Operations/ChangeConfiguration.cpp | 2 --
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ff0a8467..033ffd17 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -44,6 +44,7 @@
 - Fix regression bug of [#345](https://github.com/matth-x/MicroOcpp/pull/345) ([#353](https://github.com/matth-x/MicroOcpp/pull/353), [#356](https://github.com/matth-x/MicroOcpp/pull/356))
 - Correct MeterValue PreBoot timestamp ([#354](https://github.com/matth-x/MicroOcpp/pull/354))
 - Send errorCode in triggered StatusNotif ([#359](https://github.com/matth-x/MicroOcpp/pull/359))
+- Remove int to bool conversion in ChangeConfig ([#362](https://github.com/matth-x/MicroOcpp/pull/362))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/src/MicroOcpp/Operations/ChangeConfiguration.cpp b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
index 15227ca2..79abaf29 100644
--- a/src/MicroOcpp/Operations/ChangeConfiguration.cpp
+++ b/src/MicroOcpp/Operations/ChangeConfiguration.cpp
@@ -101,8 +101,6 @@ void ChangeConfiguration::processReq(JsonObject payload) {
         numBool = true;
     } else if (tolower(value[0]) == 'f' && tolower(value[1]) == 'a' && tolower(value[2]) == 'l' && tolower(value[3]) == 's' && tolower(value[4]) == 'e' && !value[5]) {
         numBool = false;
-    } else if (convertibleInt) {
-        numBool = numInt != 0;
     } else {
         convertibleBool = false;
     }

From 45dc003fad83de0cfcd0f4e2f4cc43b6f9b04624 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Thu, 12 Sep 2024 16:55:10 +0200
Subject: [PATCH 520/549] Generate benchmarks for docs (#369)

---
 .github/workflows/documentation.yml           | 119 +++++-
 .gitignore                                    |   1 +
 CHANGELOG.md                                  |   1 +
 docs/benchmarks.md                            |  47 +++
 mkdocs.yml                                    |   5 +
 tests/benchmarks/firmware_size/main.cpp       |  68 ++++
 tests/benchmarks/firmware_size/platformio.ini |  38 ++
 .../benchmarks/scripts/eval_firmware_size.py  | 350 ++++++++++++++++++
 8 files changed, 619 insertions(+), 10 deletions(-)
 create mode 100644 docs/benchmarks.md
 create mode 100644 tests/benchmarks/firmware_size/main.cpp
 create mode 100644 tests/benchmarks/firmware_size/platformio.ini
 create mode 100755 tests/benchmarks/scripts/eval_firmware_size.py

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index e6bb0e7b..27314b72 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -7,19 +7,118 @@ on:
   push:
     branches:
       - main
+  pull_request:
+
 permissions:
   contents: write
 jobs:
+  build_firmware_size:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - name: Cache pip
+      uses: actions/cache@v2
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+    - name: Cache PlatformIO
+      uses: actions/cache@v2
+      with:
+        path: ~/.platformio
+        key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }}
+    - name: Set up Python
+      uses: actions/setup-python@v4
+    - name: Install PlatformIO
+      run: |
+        python -m pip install --upgrade pip
+        pip install --upgrade platformio
+    - name: Run PlatformIO
+      run: pio ci --lib="." --build-dir="${{ github.workspace }}/../build" --keep-build-dir --project-conf="./tests/benchmarks/firmware_size/platformio.ini" ./tests/benchmarks/firmware_size/main.cpp
+    - name: Move firmware files # change path to location without parent dir ('..') statement (to make upload-artifact happy)
+      run: |
+        mkdir firmware
+        mv "${{ github.workspace }}/../build/.pio/build/v16/firmware.elf"  firmware/firmware_v16.elf
+        mv "${{ github.workspace }}/../build/.pio/build/v201/firmware.elf" firmware/firmware_v201.elf
+    - name: Upload firmware linker files
+      uses: actions/upload-artifact@v4
+      with:
+        name: Firmware linker files
+        path: firmware
+        if-no-files-found: error
+        retention-days: 1
+
+  evaluate_firmware:
+    needs: build_firmware_size
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: 3.x
+    - uses: actions/cache@v2
+      with:
+        key: ${{ github.ref }}
+        path: .cache
+    - name: Install Python dependencies
+      run: pip install pandas 
+    - name: Get build tools
+      run: |
+        sudo apt update
+        sudo apt install build-essential cmake ninja-build
+        sudo apt -y install gcc-9 g++-9
+        g++ --version
+    - name: Check out bloaty
+      uses: actions/checkout@v3
+      with:
+        repository: google/bloaty
+        ref: 379d5305670c00c36a57e608079fd253f13bde63
+        path: tools/bloaty
+        submodules: recursive
+    - name: Install bloaty
+      run: |
+        cmake -B tools/bloaty/build -G Ninja -S tools/bloaty
+        cmake --build tools/bloaty/build -j 32
+    - name: Get firmware linker files
+      uses: actions/download-artifact@v4
+      with:
+        name: Firmware linker files
+        path: firmware
+    - name: Run bloaty
+      run: |
+        mkdir docs/assets
+        mkdir docs/assets/tables
+        tools/bloaty/build/bloaty firmware/firmware_v16.elf  -d compileunits --csv -n 0 > docs/assets/tables/bloaty_v16.csv
+        tools/bloaty/build/bloaty firmware/firmware_v201.elf -d compileunits --csv -n 0 > docs/assets/tables/bloaty_v201.csv
+    - name: Evaluate and create reports
+      run: python tests/benchmarks/scripts/eval_firmware_size.py
+    - name: Upload reports
+      uses: actions/upload-artifact@v4
+      with:
+        name: Firmware size reports CSV
+        path: docs/assets/tables
+        if-no-files-found: error
+
   deploy:
+    needs: evaluate_firmware
     runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v4
-        with:
-          python-version: 3.x
-      - uses: actions/cache@v2
-        with:
-          key: ${{ github.ref }}
-          path: .cache
-      - run: pip install mkdocs-material 
-      - run: mkdocs gh-deploy --force
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: 3.x
+    - uses: actions/cache@v2
+      with:
+        key: ${{ github.ref }}
+        path: .cache
+    - name: Install Python dependencies
+      run: pip install pandas mkdocs-material mkdocs-table-reader-plugin
+    - name: Get firmware size reports
+      uses: actions/download-artifact@v4
+      with:
+        name: Firmware size reports CSV
+        path: docs/assets/tables
+    - name: Run mkdocs
+      run: mkdocs gh-deploy --force
diff --git a/.gitignore b/.gitignore
index 56868dff..e04a3bf0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,3 +6,4 @@ src/ArduinoJson*
 src/main.cpp
 tests/helpers/ArduinoJson*
 coverage.info
+docs/assets
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 033ffd17..d1e16f55 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,6 +22,7 @@
 - Support for TransactionMessageAttempts/-RetryInterval ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 - Heap profiler and custom allocator support ([#350](https://github.com/matth-x/MicroOcpp/pull/350))
 - Migration of persistent storage ([#355](https://github.com/matth-x/MicroOcpp/pull/355))
+- Benchmarks pipeline ([#369](https://github.com/matth-x/MicroOcpp/pull/369))
 
 ### Removed
 
diff --git a/docs/benchmarks.md b/docs/benchmarks.md
new file mode 100644
index 00000000..f304dd6f
--- /dev/null
+++ b/docs/benchmarks.md
@@ -0,0 +1,47 @@
+# Benchmarks
+
+Microcontrollers have tight hardware constraints which affect how much resources the firmware can demand. It is important to make sure that the available resources are not depleted to allow for robust operation and that there is sufficient flash head room to allow for future software upgrades.
+
+In general, microcontrollers have three relevant hardware constraints:
+
+- Limited processing speed
+- Limited memory size
+- Limited flash size
+
+For OCPP, the relevant bottlenecks are especially the memory and flash size. The processing speed is no concern, since OCPP is not computationally complex and does not include any extensive planning algorithms on the charger size. A previous [benchmark on the ESP-IDF](https://github.com/matth-x/MicroOcpp-benchmark) showed that the processing times are in the lower milliseconds range and are probably outweighed by IO times and network round trip times.
+
+However, the memory and flash requirements are important figures, because the device model of OCPP has a significant size. The microcontroller needs to keep the model data in the heap memory for the largest part and the firmware which covers the corresponding processing routines needs to have sufficient space on flash.
+
+This chapter presents benchmarks of the memory and flash requirements. They should help to determine the required microcontroller capabilities, or to give general insights for taking further action on optimizing the firmware.
+
+## Firmware size
+
+When compiling a firmware with MicroOCPP, the resulting binary will contain functionality which is not related to OCPP, like hardware drivers, modules which are shared, like MbedTLS and the actual MicroOCPP object files. The size of the latter is the final flash requirement of MicroOCPP.
+
+For the flash benchmark, the profiler compiles a [dummy OCPP firmware](https://github.com/matth-x/MicroOcpp/tree/main/tests/benchmarks/firmware_size/main.cpp), analyzes the size of the compilation units using [bloaty](https://github.com/google/bloaty) and evaluates the bloaty report using a [Python script](https://github.com/matth-x/MicroOcpp/tree/main/tests/benchmarks/scripts/eval_firmware_size.py). To give realistic results, the firwmare is compiled with `-Os`, no RTTI or exceptions and newlib as the standard C library. The following tables show the results.
+
+### OCPP 1.6
+
+The following table shows the cumulated size of the objects files per module. The Module category consists of the OCPP 2.0.1 functional blocks, OCPP 1.6 feature profiles and general functionality which is shared accross the library. If a feature of the implementation falls under both an OCPP 2.0.1 functional block and OCPP 1.6 feature profile definition, it is preferrably assigned to the OCPP 2.0.1 category. This allows for better comparability between both OCPP versions.
+
+**Table 1: Firmware size per Module**
+
+{{ read_csv('modules_v16.csv') }}
+
+### OCPP 2.0.1
+
+**Table 2: Firmware size per Module**
+
+{{ read_csv('modules_v201.csv') }}
+
+## Full data sets
+
+This section contains the raw data which is the basis for the evaluations above.
+
+**Table 3: All compilation units for OCPP 1.6 firmware**
+
+{{ read_csv('compile_units_v16.csv') }}
+
+**Table 4: All compilation units for OCPP 2.0.1 firmware**
+
+{{ read_csv('compile_units_v201.csv') }}
diff --git a/mkdocs.yml b/mkdocs.yml
index 0bc66499..22027d12 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -48,3 +48,8 @@ theme:
 
 extra_css:
   - stylesheets/extra.css
+
+plugins:
+  - search
+  - table-reader:
+      data_path: "docs/assets/tables"
diff --git a/tests/benchmarks/firmware_size/main.cpp b/tests/benchmarks/firmware_size/main.cpp
new file mode 100644
index 00000000..f1d07cd1
--- /dev/null
+++ b/tests/benchmarks/firmware_size/main.cpp
@@ -0,0 +1,68 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp.h>
+#include <MicroOcpp_c.h>
+#include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
+#include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
+
+MicroOcpp::LoopbackConnection g_loopback;
+
+void setup() {
+
+    ocpp_deinitialize();
+
+#if MO_ENABLE_V201
+    mocpp_initialize(g_loopback, ChargerCredentials::v201(),MicroOcpp::makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Use_Mount_FormatOnFail),true,MicroOcpp::ProtocolVersion(2,0,1));
+#else
+    mocpp_initialize(g_loopback, ChargerCredentials());
+#endif
+
+    ocpp_beginTransaction("");
+    ocpp_beginTransaction_authorized("","");
+    ocpp_endTransaction("","");
+    ocpp_endTransaction_authorized("","");
+    ocpp_isTransactionActive();
+    ocpp_isTransactionRunning();
+    ocpp_getTransactionIdTag();
+    ocpp_getTransaction();
+    ocpp_ocppPermitsCharge();
+    ocpp_getChargePointStatus();
+    ocpp_setConnectorPluggedInput([] () {return false;});
+    ocpp_setEnergyMeterInput([] () {return 0;});
+    ocpp_setPowerMeterInput([] () {return 0.f;});
+    ocpp_setSmartChargingPowerOutput([] (float) {});
+    ocpp_setSmartChargingCurrentOutput([] (float) {});
+    ocpp_setSmartChargingOutput([] (float,float,int) {});
+    ocpp_setEvReadyInput([] () {return false;});
+    ocpp_setEvseReadyInput([] () {return false;});
+    ocpp_addErrorCodeInput([] () {return (const char*)nullptr;});
+    addErrorDataInput([] () {return MicroOcpp::ErrorData("");});
+    ocpp_addMeterValueInputFloat([] () {return 0.f;},"","","","");
+    ocpp_setOccupiedInput([] () {return false;});
+    ocpp_setStartTxReadyInput([] () {return false;});
+    ocpp_setStopTxReadyInput([] () {return false;});
+    ocpp_setTxNotificationOutput([] (OCPP_Transaction*, OCPP_TxNotification) {});
+
+#if MO_ENABLE_CONNECTOR_LOCK
+    ocpp_setOnUnlockConnectorInOut([] () {return UnlockConnectorResult_UnlockFailed;});
+#endif
+
+    isOperative();
+    setOnResetNotify([] (bool) {return false;});
+    setOnResetExecute([] (bool) {return false;});
+    getFirmwareService()->getFirmwareStatus();
+    getDiagnosticsService()->getDiagnosticsStatus();
+
+#if MO_ENABLE_CERT_MGMT
+    setCertificateStore(nullptr);
+#endif
+
+    getOcppContext();
+
+}
+
+void loop() {
+    mocpp_loop();
+}
diff --git a/tests/benchmarks/firmware_size/platformio.ini b/tests/benchmarks/firmware_size/platformio.ini
new file mode 100644
index 00000000..121a8de5
--- /dev/null
+++ b/tests/benchmarks/firmware_size/platformio.ini
@@ -0,0 +1,38 @@
+; matth-x/MicroOcpp
+; Copyright Matthias Akstaller 2019 - 2024
+; MIT License
+
+[common]
+platform = espressif32@6.8.1
+board = esp-wrover-kit
+framework = arduino
+lib_deps =
+    bblanchon/ArduinoJson@6.20.1
+build_flags=
+    -D MO_DBG_LEVEL=MO_DL_NONE ; don't take debug messages into account
+    -D MO_CUSTOM_WS
+
+[env:v16]
+platform = ${common.platform}
+board = ${common.board}
+framework = ${common.framework}
+lib_deps = ${common.lib_deps}
+build_flags =
+    ${common.build_flags}
+    -D MO_ENABLE_MBEDTLS=1
+    -D MO_ENABLE_CERT_MGMT=1
+    -D MO_ENABLE_RESERVATION=1
+    -D MO_ENABLE_LOCAL_AUTH=1
+    -D MO_REPORT_NOERROR=1
+    -D MO_ENABLE_CONNECTOR_LOCK=1
+
+[env:v201]
+platform = ${common.platform}
+board = ${common.board}
+framework = ${common.framework}
+lib_deps = ${common.lib_deps}
+build_flags =
+    ${common.build_flags}
+    -D MO_ENABLE_V201=1
+    -D MO_ENABLE_MBEDTLS=1
+    -D MO_ENABLE_CERT_MGMT=1
diff --git a/tests/benchmarks/scripts/eval_firmware_size.py b/tests/benchmarks/scripts/eval_firmware_size.py
new file mode 100755
index 00000000..653cf00f
--- /dev/null
+++ b/tests/benchmarks/scripts/eval_firmware_size.py
@@ -0,0 +1,350 @@
+import sys
+import numpy as np
+import pandas as pd
+
+# load data
+
+COLUMN_BINSIZE = 'Binary size (Bytes)'
+
+def load_compilation_units(fn):
+    df = pd.read_csv(fn, index_col="compileunits").filter(like="lib/MicroOcpp/src/MicroOcpp", axis=0).filter(['Module','v16','v201','vmsize'], axis=1).sort_index()
+    df.index.names = ['Compile Unit']
+    df.index = df.index.map(lambda s: s[len("lib/MicroOcpp/src/"):] if s.startswith("lib/MicroOcpp/src/") else s)
+    df.index = df.index.map(lambda s: s[len("MicroOcpp/"):] if s.startswith("MicroOcpp/") else s)
+    df.rename(columns={'vmsize': COLUMN_BINSIZE}, inplace=True)
+    return df
+    
+cunits_v16 = load_compilation_units('docs/assets/tables/bloaty_v16.csv')
+cunits_v201 = load_compilation_units('docs/assets/tables/bloaty_v201.csv')
+
+# categorize data
+
+def categorize_table(df):
+
+    df["v16"] = ' '
+    df["v201"] = ' '
+    df["Module"] = ''
+
+    TICK = 'x'
+
+    MODULE_GENERAL = 'General'
+    MODULE_HAL = 'General - Hardware Abstraction Layer'
+    MODULE_RPC = 'General - RPC framework'
+    MODULE_API = 'General - API'
+    MODULE_CORE = 'Core'
+    MODULE_CONFIGURATION = 'Configuration'
+    MODULE_FW_MNGT = 'Firmware Management'
+    MODULE_TRIGGERMESSAGE = 'TriggerMessage'
+    MODULE_SECURITY = 'A - Security'
+    MODULE_PROVISIONING = 'B - Provisioning'
+    MODULE_PROVISIONING_VARS = 'B - Provisioning - Variables'
+    MODULE_AUTHORIZATION = 'C - Authorization'
+    MODULE_LOCALAUTH = 'D - Local Authorization List Management'
+    MODULE_TX = 'E - Transactions'
+    MODULE_AVAILABILITY = 'G - Availability'
+    MODULE_RESERVATION = 'H - Reservation'
+    MODULE_METERVALUES = 'J - MeterValues'
+    MODULE_SMARTCHARGING = 'K - SmartCharging'
+    MODULE_CERTS = 'M - Certificate Management'
+
+    df.at['MicroOcpp.cpp', 'v16'] = TICK
+    df.at['MicroOcpp.cpp', 'v201'] = TICK
+    df.at['MicroOcpp.cpp', 'Module'] = MODULE_API
+    df.at['Core/Configuration.cpp', 'v16'] = TICK
+    df.at['Core/Configuration.cpp', 'v201'] = TICK
+    df.at['Core/Configuration.cpp', 'Module'] = MODULE_CONFIGURATION
+    if 'Core/Configuration_c.cpp' in df.index:
+        df.at['Core/Configuration_c.cpp', 'v16'] = TICK
+        df.at['Core/Configuration_c.cpp', 'v201'] = TICK
+        df.at['Core/Configuration_c.cpp', 'Module'] = MODULE_CONFIGURATION
+    df.at['Core/ConfigurationContainer.cpp', 'v16'] = TICK
+    df.at['Core/ConfigurationContainer.cpp', 'v201'] = TICK
+    df.at['Core/ConfigurationContainer.cpp', 'Module'] = MODULE_CONFIGURATION
+    df.at['Core/ConfigurationContainerFlash.cpp', 'v16'] = TICK
+    df.at['Core/ConfigurationContainerFlash.cpp', 'v201'] = TICK
+    df.at['Core/ConfigurationContainerFlash.cpp', 'Module'] = MODULE_CONFIGURATION
+    df.at['Core/ConfigurationKeyValue.cpp', 'v16'] = TICK
+    df.at['Core/ConfigurationKeyValue.cpp', 'v201'] = TICK
+    df.at['Core/ConfigurationKeyValue.cpp', 'Module'] = MODULE_CONFIGURATION
+    df.at['Core/Connection.cpp', 'v16'] = TICK
+    df.at['Core/Connection.cpp', 'v201'] = TICK
+    df.at['Core/Connection.cpp', 'Module'] = MODULE_HAL
+    df.at['Core/Context.cpp', 'v16'] = TICK
+    df.at['Core/Context.cpp', 'v201'] = TICK
+    df.at['Core/Context.cpp', 'Module'] = MODULE_GENERAL
+    df.at['Core/FilesystemAdapter.cpp', 'v16'] = TICK
+    df.at['Core/FilesystemAdapter.cpp', 'v201'] = TICK
+    df.at['Core/FilesystemAdapter.cpp', 'Module'] = MODULE_HAL
+    df.at['Core/FilesystemUtils.cpp', 'v16'] = TICK
+    df.at['Core/FilesystemUtils.cpp', 'v201'] = TICK
+    df.at['Core/FilesystemUtils.cpp', 'Module'] = MODULE_GENERAL
+    df.at['Core/FtpMbedTLS.cpp', 'v16'] = TICK
+    df.at['Core/FtpMbedTLS.cpp', 'v201'] = TICK
+    df.at['Core/FtpMbedTLS.cpp', 'Module'] = MODULE_GENERAL
+    df.at['Core/Memory.cpp', 'v16'] = TICK
+    df.at['Core/Memory.cpp', 'v201'] = TICK
+    df.at['Core/Memory.cpp', 'Module'] = MODULE_GENERAL
+    df.at['Core/Operation.cpp', 'v16'] = TICK
+    df.at['Core/Operation.cpp', 'v201'] = TICK
+    df.at['Core/Operation.cpp', 'Module'] = MODULE_RPC
+    df.at['Core/OperationRegistry.cpp', 'v16'] = TICK
+    df.at['Core/OperationRegistry.cpp', 'v201'] = TICK
+    df.at['Core/OperationRegistry.cpp', 'Module'] = MODULE_RPC
+    df.at['Core/Request.cpp', 'v16'] = TICK
+    df.at['Core/Request.cpp', 'v201'] = TICK
+    df.at['Core/Request.cpp', 'Module'] = MODULE_RPC
+    df.at['Core/RequestQueue.cpp', 'v16'] = TICK
+    df.at['Core/RequestQueue.cpp', 'v201'] = TICK
+    df.at['Core/RequestQueue.cpp', 'Module'] = MODULE_RPC
+    df.at['Core/Time.cpp', 'v16'] = TICK
+    df.at['Core/Time.cpp', 'v201'] = TICK
+    df.at['Core/Time.cpp', 'Module'] = MODULE_GENERAL
+    if 'Debug.cpp' in df.index:
+        df.at['Debug.cpp', 'v16'] = TICK
+        df.at['Debug.cpp', 'v201'] = TICK
+        df.at['Debug.cpp', 'Module'] = MODULE_HAL
+    df.at['Model/Authorization/AuthorizationData.cpp', 'v16'] = TICK
+    df.at['Model/Authorization/AuthorizationData.cpp', 'Module'] = MODULE_LOCALAUTH
+    df.at['Model/Authorization/AuthorizationList.cpp', 'v16'] = TICK
+    df.at['Model/Authorization/AuthorizationList.cpp', 'Module'] = MODULE_LOCALAUTH
+    df.at['Model/Authorization/AuthorizationService.cpp', 'v16'] = TICK
+    df.at['Model/Authorization/AuthorizationService.cpp', 'Module'] = MODULE_LOCALAUTH
+    if 'Model/Authorization/IdToken.cpp' in df.index:
+        df.at['Model/Authorization/IdToken.cpp', 'v201'] = TICK
+        df.at['Model/Authorization/IdToken.cpp', 'Module'] = MODULE_AUTHORIZATION
+    if 'Model/Availability/AvailabilityService.cpp' in df.index:
+        df.at['Model/Availability/AvailabilityService.cpp', 'v16'] = TICK
+        df.at['Model/Availability/AvailabilityService.cpp', 'v201'] = TICK
+        df.at['Model/Availability/AvailabilityService.cpp', 'Module'] = MODULE_AVAILABILITY
+    df.at['Model/Boot/BootService.cpp', 'v16'] = TICK
+    df.at['Model/Boot/BootService.cpp', 'v201'] = TICK
+    df.at['Model/Boot/BootService.cpp', 'Module'] = MODULE_PROVISIONING
+    df.at['Model/Certificates/Certificate.cpp', 'v16'] = TICK
+    df.at['Model/Certificates/Certificate.cpp', 'v201'] = TICK
+    df.at['Model/Certificates/Certificate.cpp', 'Module'] = MODULE_CERTS
+    df.at['Model/Certificates/CertificateMbedTLS.cpp', 'v16'] = TICK
+    df.at['Model/Certificates/CertificateMbedTLS.cpp', 'v201'] = TICK
+    df.at['Model/Certificates/CertificateMbedTLS.cpp', 'Module'] = MODULE_CERTS
+    if 'Model/Certificates/Certificate_c.cpp' in df.index:
+        df.at['Model/Certificates/Certificate_c.cpp', 'v16'] = TICK
+        df.at['Model/Certificates/Certificate_c.cpp', 'v201'] = TICK
+        df.at['Model/Certificates/Certificate_c.cpp', 'Module'] = MODULE_CERTS
+    df.at['Model/Certificates/CertificateService.cpp', 'v16'] = TICK
+    df.at['Model/Certificates/CertificateService.cpp', 'v201'] = TICK
+    df.at['Model/Certificates/CertificateService.cpp', 'Module'] = MODULE_CERTS
+    df.at['Model/ConnectorBase/Connector.cpp', 'v16'] = TICK
+    df.at['Model/ConnectorBase/Connector.cpp', 'Module'] = MODULE_CORE
+    df.at['Model/ConnectorBase/ConnectorsCommon.cpp', 'v16'] = TICK
+    df.at['Model/ConnectorBase/ConnectorsCommon.cpp', 'Module'] = MODULE_CORE
+    if 'Model/ConnectorBase/Notification.cpp' in df.index:
+        df.at['Model/ConnectorBase/Notification.cpp', 'v16'] = TICK
+        df.at['Model/ConnectorBase/Notification.cpp', 'Module'] = MODULE_CORE
+    df.at['Model/Diagnostics/DiagnosticsService.cpp', 'v16'] = TICK
+    df.at['Model/Diagnostics/DiagnosticsService.cpp', 'Module'] = MODULE_FW_MNGT
+    df.at['Model/FirmwareManagement/FirmwareService.cpp', 'v16'] = TICK
+    df.at['Model/FirmwareManagement/FirmwareService.cpp', 'Module'] = MODULE_FW_MNGT
+    df.at['Model/Heartbeat/HeartbeatService.cpp', 'v16'] = TICK
+    df.at['Model/Heartbeat/HeartbeatService.cpp', 'v201'] = TICK
+    df.at['Model/Heartbeat/HeartbeatService.cpp', 'Module'] = MODULE_AVAILABILITY
+    df.at['Model/Metering/MeteringConnector.cpp', 'v16'] = TICK
+    df.at['Model/Metering/MeteringConnector.cpp', 'Module'] = MODULE_METERVALUES
+    df.at['Model/Metering/MeteringService.cpp', 'v16'] = TICK
+    df.at['Model/Metering/MeteringService.cpp', 'Module'] = MODULE_METERVALUES
+    df.at['Model/Metering/MeterStore.cpp', 'v16'] = TICK
+    df.at['Model/Metering/MeterStore.cpp', 'Module'] = MODULE_METERVALUES
+    df.at['Model/Metering/MeterValue.cpp', 'v16'] = TICK
+    df.at['Model/Metering/MeterValue.cpp', 'Module'] = MODULE_METERVALUES
+    df.at['Model/Metering/SampledValue.cpp', 'v16'] = TICK
+    df.at['Model/Metering/SampledValue.cpp', 'Module'] = MODULE_METERVALUES
+    df.at['Model/Model.cpp', 'v16'] = TICK
+    df.at['Model/Model.cpp', 'v201'] = TICK
+    df.at['Model/Model.cpp', 'Module'] = MODULE_GENERAL
+    df.at['Model/Reservation/Reservation.cpp', 'v16'] = TICK
+    df.at['Model/Reservation/Reservation.cpp', 'Module'] = MODULE_RESERVATION
+    df.at['Model/Reservation/ReservationService.cpp', 'v16'] = TICK
+    df.at['Model/Reservation/ReservationService.cpp', 'Module'] = MODULE_RESERVATION
+    df.at['Model/Reset/ResetService.cpp', 'v16'] = TICK
+    df.at['Model/Reset/ResetService.cpp', 'v201'] = TICK
+    df.at['Model/Reset/ResetService.cpp', 'Module'] = MODULE_PROVISIONING
+    df.at['Model/SmartCharging/SmartChargingModel.cpp', 'v16'] = TICK
+    df.at['Model/SmartCharging/SmartChargingModel.cpp', 'Module'] = MODULE_SMARTCHARGING
+    df.at['Model/SmartCharging/SmartChargingService.cpp', 'v16'] = TICK
+    df.at['Model/SmartCharging/SmartChargingService.cpp', 'Module'] = MODULE_SMARTCHARGING
+    df.at['Model/Transactions/Transaction.cpp', 'v16'] = TICK
+    df.at['Model/Transactions/Transaction.cpp', 'v201'] = TICK
+    df.at['Model/Transactions/Transaction.cpp', 'Module'] = MODULE_TX
+    df.at['Model/Transactions/TransactionDeserialize.cpp', 'v16'] = TICK
+    df.at['Model/Transactions/TransactionDeserialize.cpp', 'Module'] = MODULE_TX
+    if 'Model/Transactions/TransactionService.cpp' in df.index:
+        df.at['Model/Transactions/TransactionService.cpp', 'v201'] = TICK
+        df.at['Model/Transactions/TransactionService.cpp', 'Module'] = MODULE_TX
+    df.at['Model/Transactions/TransactionStore.cpp', 'v16'] = TICK
+    df.at['Model/Transactions/TransactionStore.cpp', 'Module'] = MODULE_TX
+    if 'Model/Variables/Variable.cpp' in df.index:
+        df.at['Model/Variables/Variable.cpp', 'v201'] = TICK
+        df.at['Model/Variables/Variable.cpp', 'Module'] = MODULE_PROVISIONING_VARS
+    if 'Model/Variables/VariableContainer.cpp' in df.index:
+        df.at['Model/Variables/VariableContainer.cpp', 'v201'] = TICK
+        df.at['Model/Variables/VariableContainer.cpp', 'Module'] = MODULE_PROVISIONING_VARS
+    if 'Model/Variables/VariableService.cpp' in df.index:
+        df.at['Model/Variables/VariableService.cpp', 'v201'] = TICK
+        df.at['Model/Variables/VariableService.cpp', 'Module'] = MODULE_PROVISIONING_VARS
+    df.at['Operations/Authorize.cpp', 'v16'] = TICK
+    df.at['Operations/Authorize.cpp', 'v201'] = TICK
+    df.at['Operations/Authorize.cpp', 'Module'] = MODULE_AUTHORIZATION
+    df.at['Operations/BootNotification.cpp', 'v16'] = TICK
+    df.at['Operations/BootNotification.cpp', 'v201'] = TICK
+    df.at['Operations/BootNotification.cpp', 'Module'] = MODULE_PROVISIONING
+    df.at['Operations/CancelReservation.cpp', 'v16'] = TICK
+    df.at['Operations/CancelReservation.cpp', 'Module'] = MODULE_RESERVATION
+    df.at['Operations/ChangeAvailability.cpp', 'v16'] = TICK
+    df.at['Operations/ChangeAvailability.cpp', 'Module'] = MODULE_AVAILABILITY
+    df.at['Operations/ChangeConfiguration.cpp', 'v16'] = TICK
+    df.at['Operations/ChangeConfiguration.cpp', 'Module'] = MODULE_CONFIGURATION
+    df.at['Operations/ClearCache.cpp', 'v16'] = TICK
+    df.at['Operations/ClearCache.cpp', 'Module'] = MODULE_CORE
+    df.at['Operations/ClearChargingProfile.cpp', 'v16'] = TICK
+    df.at['Operations/ClearChargingProfile.cpp', 'Module'] = MODULE_SMARTCHARGING
+    df.at['Operations/CustomOperation.cpp', 'v16'] = TICK
+    df.at['Operations/CustomOperation.cpp', 'v201'] = TICK
+    df.at['Operations/CustomOperation.cpp', 'Module'] = MODULE_RPC
+    df.at['Operations/DataTransfer.cpp', 'v16'] = TICK
+    df.at['Operations/DataTransfer.cpp', 'Module'] = MODULE_CORE
+    df.at['Operations/DeleteCertificate.cpp', 'v16'] = TICK
+    df.at['Operations/DeleteCertificate.cpp', 'v201'] = TICK
+    df.at['Operations/DeleteCertificate.cpp', 'Module'] = MODULE_CERTS
+    df.at['Operations/DiagnosticsStatusNotification.cpp', 'v16'] = TICK
+    df.at['Operations/DiagnosticsStatusNotification.cpp', 'Module'] = MODULE_FW_MNGT
+    df.at['Operations/FirmwareStatusNotification.cpp', 'v16'] = TICK
+    df.at['Operations/FirmwareStatusNotification.cpp', 'Module'] = MODULE_FW_MNGT
+    if 'Operations/GetBaseReport.cpp' in df.index:
+        df.at['Operations/GetBaseReport.cpp', 'v201'] = TICK
+        df.at['Operations/GetBaseReport.cpp', 'Module'] = MODULE_PROVISIONING_VARS
+    df.at['Operations/GetCompositeSchedule.cpp', 'v16'] = TICK
+    df.at['Operations/GetCompositeSchedule.cpp', 'Module'] = MODULE_SMARTCHARGING
+    df.at['Operations/GetConfiguration.cpp', 'v16'] = TICK
+    df.at['Operations/GetConfiguration.cpp', 'v201'] = TICK
+    df.at['Operations/GetConfiguration.cpp', 'Module'] = MODULE_CONFIGURATION
+    df.at['Operations/GetDiagnostics.cpp', 'v16'] = TICK
+    df.at['Operations/GetDiagnostics.cpp', 'Module'] = MODULE_FW_MNGT
+    df.at['Operations/GetInstalledCertificateIds.cpp', 'v16'] = TICK
+    df.at['Operations/GetInstalledCertificateIds.cpp', 'Module'] = MODULE_SMARTCHARGING
+    df.at['Operations/GetLocalListVersion.cpp', 'v16'] = TICK
+    df.at['Operations/GetLocalListVersion.cpp', 'Module'] = MODULE_LOCALAUTH
+    if 'Operations/GetVariables.cpp' in df.index:
+        df.at['Operations/GetVariables.cpp', 'v201'] = TICK
+        df.at['Operations/GetVariables.cpp', 'Module'] = MODULE_PROVISIONING_VARS
+    df.at['Operations/Heartbeat.cpp', 'v16'] = TICK
+    df.at['Operations/Heartbeat.cpp', 'v201'] = TICK
+    df.at['Operations/Heartbeat.cpp', 'Module'] = MODULE_AVAILABILITY
+    df.at['Operations/InstallCertificate.cpp', 'v16'] = TICK
+    df.at['Operations/InstallCertificate.cpp', 'v201'] = TICK
+    df.at['Operations/InstallCertificate.cpp', 'Module'] = MODULE_CERTS
+    df.at['Operations/MeterValues.cpp', 'v16'] = TICK
+    df.at['Operations/MeterValues.cpp', 'Module'] = MODULE_METERVALUES
+    if 'Operations/NotifyReport.cpp' in df.index:
+        df.at['Operations/NotifyReport.cpp', 'v201'] = TICK
+        df.at['Operations/NotifyReport.cpp', 'Module'] = MODULE_PROVISIONING_VARS
+    df.at['Operations/RemoteStartTransaction.cpp', 'v16'] = TICK
+    df.at['Operations/RemoteStartTransaction.cpp', 'Module'] = MODULE_TX
+    df.at['Operations/RemoteStopTransaction.cpp', 'v16'] = TICK
+    df.at['Operations/RemoteStopTransaction.cpp', 'Module'] = MODULE_TX
+    if 'Operations/RequestStartTransaction.cpp' in df.index:
+        df.at['Operations/RequestStartTransaction.cpp', 'v201'] = TICK
+        df.at['Operations/RequestStartTransaction.cpp', 'Module'] = MODULE_TX
+    if 'Operations/RequestStopTransaction.cpp' in df.index:
+        df.at['Operations/RequestStopTransaction.cpp', 'v201'] = TICK
+        df.at['Operations/RequestStopTransaction.cpp', 'Module'] = MODULE_TX
+    df.at['Operations/ReserveNow.cpp', 'v16'] = TICK
+    df.at['Operations/ReserveNow.cpp', 'Module'] = MODULE_RESERVATION
+    df.at['Operations/Reset.cpp', 'v16'] = TICK
+    df.at['Operations/Reset.cpp', 'v201'] = TICK
+    df.at['Operations/Reset.cpp', 'Module'] = MODULE_PROVISIONING
+    if 'Operations/SecurityEventNotification.cpp' in df.index:
+        df.at['Operations/SecurityEventNotification.cpp', 'v201'] = TICK
+        df.at['Operations/SecurityEventNotification.cpp', 'Module'] = MODULE_SECURITY
+    df.at['Operations/SendLocalList.cpp', 'v16'] = TICK
+    df.at['Operations/SendLocalList.cpp', 'Module'] = MODULE_LOCALAUTH
+    df.at['Operations/SetChargingProfile.cpp', 'v16'] = TICK
+    df.at['Operations/SetChargingProfile.cpp', 'Module'] = MODULE_SMARTCHARGING
+    if 'Operations/SetVariables.cpp' in df.index:
+        df.at['Operations/SetVariables.cpp', 'v201'] = TICK
+        df.at['Operations/SetVariables.cpp', 'Module'] = MODULE_PROVISIONING_VARS
+    df.at['Operations/StartTransaction.cpp', 'v16'] = TICK
+    df.at['Operations/StartTransaction.cpp', 'Module'] = MODULE_TX
+    df.at['Operations/StatusNotification.cpp', 'v16'] = TICK
+    df.at['Operations/StatusNotification.cpp', 'v201'] = TICK
+    df.at['Operations/StatusNotification.cpp', 'Module'] = MODULE_AVAILABILITY
+    df.at['Operations/StopTransaction.cpp', 'v16'] = TICK
+    df.at['Operations/StopTransaction.cpp', 'Module'] = MODULE_TX
+    if 'Operations/TransactionEvent.cpp' in df.index:
+        df.at['Operations/TransactionEvent.cpp', 'v201'] = TICK
+        df.at['Operations/TransactionEvent.cpp', 'Module'] = MODULE_TX
+    df.at['Operations/TriggerMessage.cpp', 'v16'] = TICK
+    df.at['Operations/TriggerMessage.cpp', 'Module'] = MODULE_TRIGGERMESSAGE
+    df.at['Operations/UnlockConnector.cpp', 'v16'] = TICK
+    df.at['Operations/UnlockConnector.cpp', 'Module'] = MODULE_CORE
+    df.at['Operations/UpdateFirmware.cpp', 'v16'] = TICK
+    df.at['Operations/UpdateFirmware.cpp', 'Module'] = MODULE_FW_MNGT
+    if 'MicroOcpp_c.cpp' in df.index:
+        df.at['MicroOcpp_c.cpp', 'v16'] = TICK
+        df.at['MicroOcpp_c.cpp', 'v201'] = TICK
+        df.at['MicroOcpp_c.cpp', 'Module'] = MODULE_API
+
+    print(df)
+
+categorize_table(cunits_v16)
+categorize_table(cunits_v201)
+
+categorize_success = True
+
+if cunits_v16[COLUMN_BINSIZE].isnull().any():
+    print('Error: categorized the following compilation units erroneously (v16):\n')
+    print(cunits_v16.loc[cunits_v16[COLUMN_BINSIZE].isnull()])
+    categorize_success = False
+
+if cunits_v201[COLUMN_BINSIZE].isnull().any():
+    print('Error: categorized the following compilation units erroneously (v201):\n')
+    print(cunits_v201.loc[cunits_v201[COLUMN_BINSIZE].isnull()])
+    categorize_success = False
+
+if (cunits_v16['Module'].values == '').sum() > 0:
+    print('Error: did not categorize the following compilation units (v16):\n')
+    print(cunits_v16.loc[cunits_v16['Module'].values == ''])
+    categorize_success = False
+
+if (cunits_v201['Module'].values == '').sum() > 0:
+    print('Error: did not categorize the following compilation units (v201):\n')
+    print(cunits_v201.loc[cunits_v201['Module'].values == ''])
+    categorize_success = False
+
+if not categorize_success:
+    sys.exit('\nError categorizing compilation units')
+
+# store csv with all details
+
+print('Uncategorized compile units (v16): ', (cunits_v16['Module'].values == '').sum())
+print('Uncategorized compile units (v201): ', (cunits_v201['Module'].values == '').sum())
+
+cunits_v16.to_csv("docs/assets/tables/compile_units_v16.csv")
+cunits_v201.to_csv("docs/assets/tables/compile_units_v201.csv")
+
+# store csv with size by Module for v16
+
+modules_v16 = cunits_v16.loc[cunits_v16['v16'].values == 'x'].sort_index()
+modules_v16_by_module = modules_v16[['Module', COLUMN_BINSIZE]].groupby('Module').sum()
+modules_v16_by_module.loc['**Total**'] = [modules_v16_by_module[COLUMN_BINSIZE].sum()]
+
+print(modules_v16_by_module)
+
+modules_v16_by_module.to_csv('docs/assets/tables/modules_v16.csv')
+
+# store csv with size by Module for v201
+
+modules_v201 = cunits_v201.loc[cunits_v201['v201'].values == 'x'].sort_index()
+modules_v201_by_module = modules_v201[['Module', COLUMN_BINSIZE]].groupby('Module').sum()
+modules_v201_by_module.loc['**Total**'] = [modules_v201_by_module[COLUMN_BINSIZE].sum()]
+
+print(modules_v201_by_module)
+
+modules_v201_by_module.to_csv('docs/assets/tables/modules_v201.csv')

From 5f482724d9cf1eefdffabe9d8e0e6685253c55b0 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Mon, 30 Sep 2024 12:50:30 +0200
Subject: [PATCH 521/549] Support for AuthorizeRemoteTxRequests (#373)

---
 CHANGELOG.md                                  |  1 +
 .../Model/ConnectorBase/ConnectorsCommon.cpp  |  2 +-
 .../Operations/RemoteStartTransaction.cpp     |  9 ++-
 tests/ConfigurationBehavior.cpp               | 66 ++++++++++++++++++-
 4 files changed, 73 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d1e16f55..09fc0fb1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -23,6 +23,7 @@
 - Heap profiler and custom allocator support ([#350](https://github.com/matth-x/MicroOcpp/pull/350))
 - Migration of persistent storage ([#355](https://github.com/matth-x/MicroOcpp/pull/355))
 - Benchmarks pipeline ([#369](https://github.com/matth-x/MicroOcpp/pull/369))
+- Support for AuthorizeRemoteTxRequests ([#373](https://github.com/matth-x/MicroOcpp/pull/373))
 
 ### Removed
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
index f08b3483..cfc32c82 100644
--- a/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
@@ -35,7 +35,7 @@ ConnectorsCommon::ConnectorsCommon(Context& context, unsigned int numConn, std::
     /*
      * Further configuration keys which correspond to the Core profile
      */
-    declareConfiguration<bool>("AuthorizeRemoteTxRequests", false, CONFIGURATION_VOLATILE, true);
+    declareConfiguration<bool>("AuthorizeRemoteTxRequests", false);
     declareConfiguration<int>("GetConfigurationMaxKeys", 30, CONFIGURATION_VOLATILE, true);
     
     context.getOperationRegistry().registerOperation("ChangeAvailability", [&context] () {
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
index 4e0d7163..b6f83bab 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
@@ -4,6 +4,7 @@
 
 
 #include <MicroOcpp/Operations/RemoteStartTransaction.h>
+#include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/ConnectorBase/Connector.h>
 #include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
@@ -98,7 +99,13 @@ void RemoteStartTransaction::processReq(JsonObject payload) {
         }
 
         if (success) {
-            auto tx = selectConnector->beginTransaction_authorized(idTag);
+            std::shared_ptr<MicroOcpp::Transaction> tx;
+            auto authorizeRemoteTxRequests = declareConfiguration<bool>("AuthorizeRemoteTxRequests", false);
+            if (authorizeRemoteTxRequests && authorizeRemoteTxRequests->getBool()) {
+                tx = selectConnector->beginTransaction(idTag);
+            } else {
+                tx = selectConnector->beginTransaction_authorized(idTag);
+            }
             selectConnector->updateTxNotification(TxNotification::RemoteStart);
             if (tx) {
                 if (chargingProfileId >= 0) {
diff --git a/tests/ConfigurationBehavior.cpp b/tests/ConfigurationBehavior.cpp
index 4b14f733..fc30b356 100644
--- a/tests/ConfigurationBehavior.cpp
+++ b/tests/ConfigurationBehavior.cpp
@@ -9,6 +9,8 @@
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Configuration.h>
 #include <MicroOcpp/Core/FilesystemUtils.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Debug.h>
 #include <MicroOcpp/Version.h>
 #include <catch2/catch.hpp>
@@ -63,10 +65,10 @@ TEST_CASE( "Configuration Behavior" ) {
     LoopbackConnection loopback;
     mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
 
-    auto engine = getOcppContext();
-    auto& checkMsg = engine->getOperationRegistry();
+    auto context = getOcppContext();
+    auto& checkMsg = context->getOperationRegistry();
 
-    auto connector = engine->getModel().getConnector(1);
+    auto connector = context->getModel().getConnector(1);
 
     mocpp_set_timer(custom_timer_cb);
 
@@ -224,5 +226,63 @@ TEST_CASE( "Configuration Behavior" ) {
     }
 #endif //MO_ENABLE_LOCAL_AUTH
 
+    SECTION("AuthorizeRemoteTxRequests") {
+        auto configBool = declareConfiguration<bool>("AuthorizeRemoteTxRequests", false);
+
+        bool receivedAuthorize = false;
+
+        setOnReceiveRequest("Authorize", [&receivedAuthorize] (JsonObject payload) {
+            receivedAuthorize = true;
+            REQUIRE( !strcmp(payload["idTag"] | "_Undefined", "mIdTag") );
+        });
+
+        SECTION("set true") {
+            configBool->setBool(true);
+
+            context->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                    "RemoteStartTransaction",
+                    [] () {
+                        //create req
+                        auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
+                        auto payload = doc->to<JsonObject>();
+                        payload["idTag"] = "mIdTag";
+                        return doc;},
+                    [] (JsonObject) {
+                        //ignore conf
+                    }
+            )));
+
+            loop();
+
+            REQUIRE(receivedAuthorize);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
+        }
+
+        SECTION("set false") {
+            configBool->setBool(false);
+
+            context->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+                    "RemoteStartTransaction",
+                    [] () {
+                        //create req
+                        auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
+                        auto payload = doc->to<JsonObject>();
+                        payload["idTag"] = "mIdTag";
+                        return doc;},
+                    [] (JsonObject) {
+                        //ignore conf
+                    }
+            )));
+
+            loop();
+
+            REQUIRE(!receivedAuthorize);
+            REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
+        }
+
+        endTransaction();
+        loop();
+    }
+
     mocpp_deinitialize();
 }

From 41e7e9ee76a951aaa4384e8992b679e29a3ae675 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 8 Oct 2024 09:13:30 +0200
Subject: [PATCH 522/549] OCPP 2.0.1 cumulative updates (#371)

* multiple fixes after v201 tests

* add tx meterData support

* add authorization active flag for begin- / endAuthorization

* patch transaction API for v201

* restore non-v201-compatible ChangeAvailability

* update v201 ChangeAvailability port

* fix OCTT test cases

* add RemoteControlService

* reset TxEndedMeasurands factory default

* add AuthorizeRemoteStart

* fix sending empty MeterValuePeriodic if interval set, but no measurands

* cumulative fixes

* fix test cases

* fix compilation

* fix compilation error

* fix ASAN error

* fix firmware size classifier

* update changelog
---
 CHANGELOG.md                                  |   9 +-
 CMakeLists.txt                                |   7 +
 src/MicroOcpp.cpp                             | 189 ++++++++--
 src/MicroOcpp/Core/Configuration_c.cpp        |   4 +-
 src/MicroOcpp/Core/Memory.cpp                 |   3 +-
 src/MicroOcpp/Core/RequestQueue.cpp           |   2 +
 .../Availability/AvailabilityService.cpp      | 203 ++++++++++
 .../Model/Availability/AvailabilityService.h  |  92 +++++
 .../Availability/ChangeAvailabilityStatus.h   |  25 ++
 .../Model/ConnectorBase/Connector.cpp         |   4 +-
 src/MicroOcpp/Model/ConnectorBase/EvseId.h    |  10 +-
 src/MicroOcpp/Model/Metering/MeterStore.cpp   |   2 +-
 src/MicroOcpp/Model/Metering/MeterValue.cpp   |   4 +-
 .../Model/Metering/MeterValuesV201.cpp        | 351 ++++++++++++++++++
 .../Model/Metering/MeterValuesV201.h          | 152 ++++++++
 .../Model/Metering/MeteringConnector.cpp      |  14 +-
 .../Model/Metering/ReadingContext.cpp         |  65 ++++
 src/MicroOcpp/Model/Metering/ReadingContext.h |  28 ++
 src/MicroOcpp/Model/Metering/SampledValue.cpp |  62 +---
 src/MicroOcpp/Model/Metering/SampledValue.h   |  20 +-
 src/MicroOcpp/Model/Model.cpp                 |  33 ++
 src/MicroOcpp/Model/Model.h                   |  15 +
 .../Model/RemoteControl/RemoteControlDefs.h   |  34 ++
 .../RemoteControl/RemoteControlService.cpp    | 162 ++++++++
 .../RemoteControl/RemoteControlService.h      |  65 ++++
 src/MicroOcpp/Model/Reset/ResetService.cpp    |  10 +-
 .../Model/Transactions/Transaction.h          |  61 ++-
 .../Model/Transactions/TransactionDefs.h      |   5 -
 .../Model/Transactions/TransactionService.cpp | 211 ++++++-----
 .../Model/Transactions/TransactionService.h   |  10 +-
 .../Model/Transactions/TransactionStore.cpp   |   4 +-
 .../Operations/ChangeAvailability.cpp         | 119 ++++--
 src/MicroOcpp/Operations/ChangeAvailability.h |  35 ++
 src/MicroOcpp/Operations/CustomOperation.cpp  |   4 +-
 src/MicroOcpp/Operations/GetVariables.cpp     |   2 +-
 .../Operations/RequestStartTransaction.cpp    |  12 +-
 .../Operations/RequestStartTransaction.h      |  11 +-
 .../Operations/RequestStopTransaction.cpp     |   6 +-
 .../Operations/RequestStopTransaction.h       |   8 +-
 src/MicroOcpp/Operations/Reset.cpp            |   2 +-
 .../Operations/SecurityEventNotification.cpp  |  54 +++
 .../Operations/SecurityEventNotification.h    |  48 +++
 src/MicroOcpp/Operations/StopTransaction.cpp  |   4 +-
 src/MicroOcpp/Operations/TransactionEvent.cpp |  46 ++-
 src/MicroOcpp/Operations/UnlockConnector.cpp  |  84 +++++
 src/MicroOcpp/Operations/UnlockConnector.h    |  42 +++
 tests/Api.cpp                                 |   6 +-
 tests/Boot.cpp                                |  46 +++
 tests/Reset.cpp                               |  85 ++++-
 tests/Security.cpp                            |  58 +++
 tests/Transactions.cpp                        | 167 ++++++++-
 tests/Variables.cpp                           | 188 +++++++++-
 .../benchmarks/scripts/eval_firmware_size.py  |  10 +
 53 files changed, 2563 insertions(+), 330 deletions(-)
 create mode 100644 src/MicroOcpp/Model/Availability/AvailabilityService.cpp
 create mode 100644 src/MicroOcpp/Model/Availability/AvailabilityService.h
 create mode 100644 src/MicroOcpp/Model/Availability/ChangeAvailabilityStatus.h
 create mode 100644 src/MicroOcpp/Model/Metering/MeterValuesV201.cpp
 create mode 100644 src/MicroOcpp/Model/Metering/MeterValuesV201.h
 create mode 100644 src/MicroOcpp/Model/Metering/ReadingContext.cpp
 create mode 100644 src/MicroOcpp/Model/Metering/ReadingContext.h
 create mode 100644 src/MicroOcpp/Model/RemoteControl/RemoteControlDefs.h
 create mode 100644 src/MicroOcpp/Model/RemoteControl/RemoteControlService.cpp
 create mode 100644 src/MicroOcpp/Model/RemoteControl/RemoteControlService.h
 create mode 100644 src/MicroOcpp/Operations/SecurityEventNotification.cpp
 create mode 100644 src/MicroOcpp/Operations/SecurityEventNotification.h
 create mode 100644 tests/Security.cpp

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 09fc0fb1..22c9a6bc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,9 @@
 - Relaxed temporal order of non-tx-related operations ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 - Use pseudo-GUIDs as messageId ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 - ISO 8601 milliseconds omitted by default ([352](https://github.com/matth-x/MicroOcpp/pull/352))
+- Rename `MO_NUM_EVSE` into `MO_NUM_EVSEID` (v2.0.1) ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
+- Change `MicroOcpp::ReadingContext` into C-style struct ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
+- Refactor RequestStartTransaction (v2.0.1) ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
 
 ### Added
 
@@ -23,6 +26,9 @@
 - Heap profiler and custom allocator support ([#350](https://github.com/matth-x/MicroOcpp/pull/350))
 - Migration of persistent storage ([#355](https://github.com/matth-x/MicroOcpp/pull/355))
 - Benchmarks pipeline ([#369](https://github.com/matth-x/MicroOcpp/pull/369))
+- MeterValues port for OCPP 2.0.1 ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
+- UnlockConnector port for OCPP 2.0.1 ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
+- More APIs ported to OCPP 2.0.1 ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
 - Support for AuthorizeRemoteTxRequests ([#373](https://github.com/matth-x/MicroOcpp/pull/373))
 
 ### Removed
@@ -39,7 +45,7 @@
 - Hold back error StatusNotifs when time not set ([#311](https://github.com/matth-x/MicroOcpp/issues/311))
 - Don't send Available when tx occupies connector ([#315](https://github.com/matth-x/MicroOcpp/issues/315))
 - Make ChargingScheduleAllowedChargingRateUnit read-only ([#328](https://github.com/matth-x/MicroOcpp/issues/328))
-- Don't send StatusNotifs while offline ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
+- ~Don't send StatusNotifs while offline ([#344](https://github.com/matth-x/MicroOcpp/pull/344))~ (see ([#371](https://github.com/matth-x/MicroOcpp/pull/371)))
 - Don't change into Unavailable upon Reset ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Reject DataTransfer by default ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - UnlockConnector NotSupported if connectorId invalid ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
@@ -47,6 +53,7 @@
 - Correct MeterValue PreBoot timestamp ([#354](https://github.com/matth-x/MicroOcpp/pull/354))
 - Send errorCode in triggered StatusNotif ([#359](https://github.com/matth-x/MicroOcpp/pull/359))
 - Remove int to bool conversion in ChangeConfig ([#362](https://github.com/matth-x/MicroOcpp/pull/362))
+- Multiple fixes of the OCPP 2.0.1 extension ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
 
 ## [1.1.0] - 2024-05-21
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 9d8fffc8..2dfebce5 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -51,6 +51,7 @@ set(MO_SRC
     src/MicroOcpp/Operations/RequestStopTransaction.cpp
     src/MicroOcpp/Operations/ReserveNow.cpp
     src/MicroOcpp/Operations/Reset.cpp
+    src/MicroOcpp/Operations/SecurityEventNotification.cpp
     src/MicroOcpp/Operations/SendLocalList.cpp
     src/MicroOcpp/Operations/SetChargingProfile.cpp
     src/MicroOcpp/Operations/SetVariables.cpp
@@ -65,6 +66,7 @@ set(MO_SRC
     src/MicroOcpp/Debug.cpp
     src/MicroOcpp/Platform.cpp
     src/MicroOcpp/Core/OperationRegistry.cpp
+    src/MicroOcpp/Model/Availability/AvailabilityService.cpp
     src/MicroOcpp/Model/Authorization/AuthorizationData.cpp
     src/MicroOcpp/Model/Authorization/AuthorizationList.cpp
     src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -84,7 +86,10 @@ set(MO_SRC
     src/MicroOcpp/Model/Metering/MeteringService.cpp
     src/MicroOcpp/Model/Metering/MeterStore.cpp
     src/MicroOcpp/Model/Metering/MeterValue.cpp
+    src/MicroOcpp/Model/Metering/MeterValuesV201.cpp
+    src/MicroOcpp/Model/Metering/ReadingContext.cpp
     src/MicroOcpp/Model/Metering/SampledValue.cpp
+    src/MicroOcpp/Model/RemoteControl/RemoteControlService.cpp
     src/MicroOcpp/Model/Reservation/Reservation.cpp
     src/MicroOcpp/Model/Reservation/ReservationService.cpp
     src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -149,6 +154,7 @@ set(MO_SRC_UNIT
     tests/FirmwareManagement.cpp
     tests/ChargePointError.cpp
     tests/Boot.cpp
+    tests/Security.cpp
 )
 
 add_executable(mo_unit_tests
@@ -192,6 +198,7 @@ target_compile_definitions(mo_unit_tests PUBLIC
     MO_ENABLE_CERT_MGMT=1
     MO_ENABLE_CONNECTOR_LOCK=1
     MO_REPORT_NOERROR=1
+    MO_ENABLE_V201=1
     MO_OVERRIDE_ALLOCATION=1
     MO_ENABLE_HEAP_PROFILER=1
     MO_HEAP_PROFILER_EXTERNAL_CONTROL=1
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 3b2d070c..de8e6ae8 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -21,6 +21,8 @@
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
 #include <MicroOcpp/Model/Certificates/CertificateMbedTLS.h>
+#include <MicroOcpp/Model/Availability/AvailabilityService.h>
+#include <MicroOcpp/Model/RemoteControl/RemoteControlService.h>
 #include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Core/OperationRegistry.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
@@ -278,17 +280,32 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
 
     auto& model = context->getModel();
 
-    model.setTransactionStore(std::unique_ptr<TransactionStore>(
-        new TransactionStore(MO_NUMCONNECTORS, filesystem)));
     model.setBootService(std::unique_ptr<BootService>(
         new BootService(*context, filesystem)));
-    model.setConnectorsCommon(std::unique_ptr<ConnectorsCommon>(
-        new ConnectorsCommon(*context, MO_NUMCONNECTORS, filesystem)));
-    auto connectors = makeVector<std::unique_ptr<Connector>>("v16.ConnectorBase.Connector");
-    for (unsigned int connectorId = 0; connectorId < MO_NUMCONNECTORS; connectorId++) {
-        connectors.emplace_back(new Connector(*context, filesystem, connectorId));
+
+#if MO_ENABLE_V201
+    if (version.major == 2) {
+        model.setAvailabilityService(std::unique_ptr<AvailabilityService>(
+            new AvailabilityService(*context, MO_NUM_EVSEID)));
+        model.setVariableService(std::unique_ptr<VariableService>(
+            new VariableService(*context, filesystem)));
+        model.setTransactionService(std::unique_ptr<TransactionService>(
+            new TransactionService(*context)));
+        model.setRemoteControlService(std::unique_ptr<RemoteControlService>(
+            new RemoteControlService(*context, MO_NUM_EVSEID)));
+    } else
+#endif
+    {
+        model.setTransactionStore(std::unique_ptr<TransactionStore>(
+            new TransactionStore(MO_NUMCONNECTORS, filesystem)));
+        model.setConnectorsCommon(std::unique_ptr<ConnectorsCommon>(
+            new ConnectorsCommon(*context, MO_NUMCONNECTORS, filesystem)));
+        auto connectors = makeVector<std::unique_ptr<Connector>>("v16.ConnectorBase.Connector");
+        for (unsigned int connectorId = 0; connectorId < MO_NUMCONNECTORS; connectorId++) {
+            connectors.emplace_back(new Connector(*context, filesystem, connectorId));
+        }
+        model.setConnectors(std::move(connectors));
     }
-    model.setConnectors(std::move(connectors));
     model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
         new HeartbeatService(*context)));
 
@@ -302,13 +319,6 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         new ReservationService(*context, MO_NUMCONNECTORS)));
 #endif
 
-#if MO_ENABLE_V201
-    model.setVariableService(std::unique_ptr<VariableService>(
-        new VariableService(*context, filesystem)));
-    model.setTransactionService(std::unique_ptr<TransactionService>(
-        new TransactionService(*context)));
-#endif
-
 #if MO_ENABLE_CERT_MGMT && MO_ENABLE_CERT_STORE_MBEDTLS
     std::unique_ptr<CertificateStore> certStore = makeCertificateStoreMbedTLS(filesystem);
     if (certStore) {
@@ -366,7 +376,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
 
     configuration_load();
 
-    MO_DBG_INFO("initialized MicroOcpp v" MO_VERSION);
+    MO_DBG_INFO("initialized MicroOcpp v" MO_VERSION " running OCPP %i.%i.%i", version.major, version.minor, version.patch);
 }
 
 void mocpp_deinitialize() {
@@ -529,6 +539,21 @@ bool isTransactionActive(unsigned int connectorId) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
     }
+
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        TransactionService::Evse *evse = nullptr;
+        if (auto txService = context->getModel().getTransactionService()) {
+            evse = txService->getEvse(connectorId);
+        }
+        if (!evse) {
+            MO_DBG_ERR("could not find EVSE");
+            return false;
+        }
+        return evse->getTransaction() && evse->getTransaction()->active;
+    }
+    #endif
+
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -543,6 +568,21 @@ bool isTransactionRunning(unsigned int connectorId) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
     }
+
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        TransactionService::Evse *evse = nullptr;
+        if (auto txService = context->getModel().getTransactionService()) {
+            evse = txService->getEvse(connectorId);
+        }
+        if (!evse) {
+            MO_DBG_ERR("could not find EVSE");
+            return false;
+        }
+        return evse->getTransaction() && evse->getTransaction()->started && !evse->getTransaction()->stopped;
+    }
+    #endif
+
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -557,6 +597,21 @@ const char *getTransactionIdTag(unsigned int connectorId) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return nullptr;
     }
+
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        TransactionService::Evse *evse = nullptr;
+        if (auto txService = context->getModel().getTransactionService()) {
+            evse = txService->getEvse(connectorId);
+        }
+        if (!evse) {
+            MO_DBG_ERR("could not find EVSE");
+            return nullptr;
+        }
+        return evse->getTransaction() ? evse->getTransaction()->idToken.get() : nullptr;
+    }
+    #endif
+
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -612,6 +667,15 @@ ChargePointStatus getChargePointStatus(unsigned int connectorId) {
         MO_DBG_WARN("OCPP uninitialized");
         return ChargePointStatus_UNDEFINED;
     }
+#if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (auto availabilityService = context->getModel().getAvailabilityService()) {
+            if (auto evse = availabilityService->getEvse(connectorId)) {
+                return evse->getStatus();
+            }
+        }
+    }
+#endif
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -627,11 +691,17 @@ void setConnectorPluggedInput(std::function<bool()> pluggedInput, unsigned int c
     }
 #if MO_ENABLE_V201
     if (context->getVersion().major == 2) {
+        if (auto availabilityService = context->getModel().getAvailabilityService()) {
+            if (auto evse = availabilityService->getEvse(connectorId)) {
+                evse->setConnectorPluggedInput(pluggedInput);
+            }
+        }
         if (auto txService = context->getModel().getTransactionService()) {
             if (auto evse = txService->getEvse(connectorId)) {
                 evse->setConnectorPluggedInput(pluggedInput);
             }
         }
+        return;
     }
 #endif
     auto connector = context->getModel().getConnector(connectorId);
@@ -647,11 +717,14 @@ void setEnergyMeterInput(std::function<int()> energyInput, unsigned int connecto
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
-    auto& model = context->getModel();
-    if (!model.getMeteringService()) {
-        model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*context, MO_NUMCONNECTORS, filesystem)));
+
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        addMeterValueInput([energyInput] () {return static_cast<float>(energyInput());}, "Energy.Active.Import.Register", "Wh", nullptr, nullptr, connectorId);
+        return;
     }
+    #endif
+
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Energy.Active.Import.Register");
     meterProperties.setUnit("Wh");
@@ -660,7 +733,7 @@ void setEnergyMeterInput(std::function<int()> energyInput, unsigned int connecto
             meterProperties,
             [energyInput] (ReadingContext) {return energyInput();}
     ));
-    model.getMeteringService()->addMeterValueSampler(connectorId, std::move(mvs));
+    addMeterValueInput(std::move(mvs), connectorId);
 }
 
 void setPowerMeterInput(std::function<float()> powerInput, unsigned int connectorId) {
@@ -669,11 +742,13 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
         return;
     }
 
-    auto& model = context->getModel();
-    if (!model.getMeteringService()) {
-        model.setMeteringSerivce(std::unique_ptr<MeteringService>(
-            new MeteringService(*context, MO_NUMCONNECTORS, filesystem)));
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        addMeterValueInput([powerInput] () {return static_cast<float>(powerInput());}, "Power.Active.Import", "W", nullptr, nullptr, connectorId);
+        return;
     }
+    #endif
+
     SampledValueProperties meterProperties;
     meterProperties.setMeasurand("Power.Active.Import");
     meterProperties.setUnit("W");
@@ -682,7 +757,7 @@ void setPowerMeterInput(std::function<float()> powerInput, unsigned int connecto
             meterProperties,
             [powerInput] (ReadingContext) {return powerInput();}
     ));
-    model.getMeteringService()->addMeterValueSampler(connectorId, std::move(mvs));
+    addMeterValueInput(std::move(mvs), connectorId);
 }
 
 void setSmartChargingPowerOutput(std::function<void(float)> chargingLimitOutput, unsigned int connectorId) {
@@ -799,6 +874,7 @@ void setEvseReadyInput(std::function<bool()> evseReadyInput, unsigned int connec
                 evse->setEvseReadyInput(evseReadyInput);
             }
         }
+        return;
     }
 #endif
     auto connector = context->getModel().getConnector(connectorId);
@@ -851,6 +927,33 @@ void addMeterValueInput(std::function<float ()> valueInput, const char *measuran
         MO_DBG_WARN("measurand unspecified; assume %s", measurand);
     }
 
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        auto& model = context->getModel();
+        if (!model.getMeteringServiceV201()) {
+            model.setMeteringServiceV201(std::unique_ptr<Ocpp201::MeteringService>(
+                new Ocpp201::MeteringService(context->getModel(), MO_NUM_EVSEID)));
+        }
+        if (auto mEvse = model.getMeteringServiceV201()->getEvse(connectorId)) {
+            
+            Ocpp201::SampledValueProperties properties;
+            properties.setMeasurand(measurand); //mandatory for MO
+
+            if (unit)
+                properties.setUnitOfMeasureUnit(unit);
+            if (location)
+                properties.setLocation(location);
+            if (phase)
+                properties.setPhase(phase);
+
+            mEvse->addMeterValueInput([valueInput] (ReadingContext) {return static_cast<double>(valueInput());}, properties);
+        } else {
+            MO_DBG_ERR("inalid arg");
+        }
+        return;
+    }
+    #endif
+
     SampledValueProperties properties;
     properties.setMeasurand(measurand); //mandatory for MO
 
@@ -864,7 +967,7 @@ void addMeterValueInput(std::function<float ()> valueInput, const char *measuran
     auto valueSampler = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<float, MicroOcpp::SampledValueDeSerializer<float>>>(
                                     new MicroOcpp::SampledValueSamplerConcrete<float, MicroOcpp::SampledValueDeSerializer<float>>(
                 properties,
-                [valueInput] (MicroOcpp::ReadingContext) {return valueInput();}));
+                [valueInput] (ReadingContext) {return valueInput();}));
     addMeterValueInput(std::move(valueSampler), connectorId);
 }
 
@@ -873,6 +976,12 @@ void addMeterValueInput(std::unique_ptr<SampledValueSampler> valueInput, unsigne
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        MO_DBG_ERR("addMeterValueInput(std::unique_ptr<SampledValueSampler>...) not compatible with v201. Use addMeterValueInput(std::function<float>...) instead");
+        return;
+    }
+    #endif
     auto& model = context->getModel();
     if (!model.getMeteringService()) {
         model.setMeteringSerivce(std::unique_ptr<MeteringService>(
@@ -886,6 +995,15 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId)
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
+#if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (auto availabilityService = context->getModel().getAvailabilityService()) {
+            if (auto evse = availabilityService->getEvse(connectorId)) {
+                evse->setOccupiedInput(occupied);
+            }
+        }
+    }
+#endif
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -953,6 +1071,19 @@ bool isOperative(unsigned int connectorId) {
         MO_DBG_WARN("OCPP uninitialized");
         return true; //assume "true" as default state
     }
+#if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (auto availabilityService = context->getModel().getAvailabilityService()) {
+            auto chargePoint = availabilityService->getEvse(OCPP_ID_OF_CP);
+            auto connector = availabilityService->getEvse(connectorId);
+            if (!chargePoint || !connector) {
+                MO_DBG_ERR("could not find connector");
+                return true; //assume "true" as default state
+            }
+            return chargePoint->isAvailable() && connector->isAvailable();
+        }
+    }
+#endif
     auto& model = context->getModel();
     auto chargePoint = model.getConnector(OCPP_ID_OF_CP);
     auto connector = model.getConnector(connectorId);
@@ -1176,7 +1307,7 @@ bool startTransaction(const char *idTag, OnReceiveConfListener onConf, OnAbortLi
     }
 
     if (auto mService = context->getModel().getMeteringService()) {
-        auto meterStart = mService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionBegin);
+        auto meterStart = mService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext_TransactionBegin);
         if (meterStart && *meterStart) {
             transaction->setMeterStart(meterStart->toInteger());
         } else {
@@ -1232,7 +1363,7 @@ bool stopTransaction(OnReceiveConfListener onConf, OnAbortListener onAbort, OnTi
     }
 
     if (auto mService = context->getModel().getMeteringService()) {
-        auto meterStop = mService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
+        auto meterStop = mService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext_TransactionEnd);
         if (meterStop && *meterStop) {
             transaction->setMeterStop(meterStop->toInteger());
         } else {
diff --git a/src/MicroOcpp/Core/Configuration_c.cpp b/src/MicroOcpp/Core/Configuration_c.cpp
index f04101f2..a85a1edd 100644
--- a/src/MicroOcpp/Core/Configuration_c.cpp
+++ b/src/MicroOcpp/Core/Configuration_c.cpp
@@ -179,7 +179,7 @@ class ConfigurationContainerC : public ConfigurationContainer, public MemoryMana
     std::shared_ptr<Configuration> getConfiguration(const char *key) override {
         ocpp_configuration *config = container->get_configuration_by_key(container->user_data, key);
         if (config) {
-            return std::make_shared<ConfigurationC>(config);
+            return std::allocate_shared<ConfigurationC>(makeAllocator<ConfigurationC>(getMemoryTag()), config);
         } else {
             return nullptr;
         }
@@ -193,5 +193,5 @@ class ConfigurationContainerC : public ConfigurationContainer, public MemoryMana
 };
 
 void ocpp_configuration_container_add(ocpp_configuration_container *container, const char *container_path, bool accessible) {
-    addConfigurationContainer(std::make_shared<ConfigurationContainerC>(container, container_path, accessible));
+    addConfigurationContainer(std::allocate_shared<ConfigurationContainerC>(makeAllocator<ConfigurationContainerC>("v16.Configuration.ContainerC.", container_path), container, container_path, accessible));
 }
diff --git a/src/MicroOcpp/Core/Memory.cpp b/src/MicroOcpp/Core/Memory.cpp
index 26500b2b..f8ea7a2b 100644
--- a/src/MicroOcpp/Core/Memory.cpp
+++ b/src/MicroOcpp/Core/Memory.cpp
@@ -164,8 +164,7 @@ void mo_mem_deinit() {
 void mo_mem_reset() {
     MO_DBG_DEBUG("Reset all maximum values to current values");
 
-    auto tagInfo = memTags.begin();
-    if (tagInfo != memTags.end()) {
+    for (auto tagInfo = (memTags).begin(); tagInfo != memTags.end(); ++tagInfo) {
         tagInfo->second.reset();
     }
 
diff --git a/src/MicroOcpp/Core/RequestQueue.cpp b/src/MicroOcpp/Core/RequestQueue.cpp
index 383492aa..104a2e97 100644
--- a/src/MicroOcpp/Core/RequestQueue.cpp
+++ b/src/MicroOcpp/Core/RequestQueue.cpp
@@ -79,6 +79,7 @@ std::unique_ptr<Request> VolatileRequestQueue::fetchFrontRequest() {
 bool VolatileRequestQueue::pushRequestBack(std::unique_ptr<Request> request) {
 
     // Don't queue up multiple StatusNotification messages for the same connectorId
+    #if 0 // Leads to ASAN failure when executed by Unit test suite (CustomOperation is casted to StatusNotification)
     if (strcmp(request->getOperationType(), "StatusNotification") == 0)
     {
         size_t i = 0;
@@ -103,6 +104,7 @@ bool VolatileRequestQueue::pushRequestBack(std::unique_ptr<Request> request) {
             }
         }
     }
+    #endif
 
     if (len >= MO_REQUEST_CACHE_MAXSIZE) {
         MO_DBG_INFO("Drop cached operation (cache full): %s", requests[front]->getOperationType());
diff --git a/src/MicroOcpp/Model/Availability/AvailabilityService.cpp b/src/MicroOcpp/Model/Availability/AvailabilityService.cpp
new file mode 100644
index 00000000..b1e59419
--- /dev/null
+++ b/src/MicroOcpp/Model/Availability/AvailabilityService.cpp
@@ -0,0 +1,203 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Availability/AvailabilityService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Debug.h>
+#include <MicroOcpp/Model/Reservation/ReservationService.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Operations/ChangeAvailability.h>
+#include <MicroOcpp/Operations/StatusNotification.h>
+
+using namespace MicroOcpp;
+
+AvailabilityServiceEvse::AvailabilityServiceEvse(Context& context, AvailabilityService& availabilityService, unsigned int evseId) : MemoryManaged("v201.Availability.AvailabilityServiceEvse"), context(context), availabilityService(availabilityService), evseId(evseId) {
+
+}
+
+void AvailabilityServiceEvse::loop() {
+
+    if (evseId >= 1) {
+        auto status = getStatus();
+
+        if (status != reportedStatus &&
+                context.getModel().getClock().now() >= MIN_TIME) {
+
+            auto statusNotification = makeRequest(new Ocpp201::StatusNotification(evseId, status, context.getModel().getClock().now()));
+            statusNotification->setTimeout(0);
+            context.initiateRequest(std::move(statusNotification));
+            reportedStatus = status;
+            return;
+        }
+    }
+}
+
+void AvailabilityServiceEvse::setConnectorPluggedInput(std::function<bool()> connectorPluggedInput) {
+    this->connectorPluggedInput = connectorPluggedInput;
+}
+
+void AvailabilityServiceEvse::setOccupiedInput(std::function<bool()> occupiedInput) {
+    this->occupiedInput = occupiedInput;
+}
+
+ChargePointStatus AvailabilityServiceEvse::getStatus() {
+    ChargePointStatus res = ChargePointStatus_UNDEFINED;
+
+    if (isFaulted()) {
+        res = ChargePointStatus_Faulted;
+    } else if (!isAvailable()) {
+        res = ChargePointStatus_Unavailable;
+    }
+    #if MO_ENABLE_RESERVATION
+    else if (context.getModel().getReservationService() && context.getModel().getReservationService()->getReservation(evseId)) {
+        res = ChargePointStatus_Reserved;
+    }
+    #endif 
+    else if ((!connectorPluggedInput || !connectorPluggedInput()) &&   //no vehicle plugged
+               (!occupiedInput || !occupiedInput())) {                       //occupied override clear
+        res = ChargePointStatus_Available;
+    } else {
+        res = ChargePointStatus_Occupied;
+    }
+
+    return res;
+}
+
+void AvailabilityServiceEvse::setUnavailable(void *requesterId) {
+    for (size_t i = 0; i < MO_INOPERATIVE_REQUESTERS_MAX; i++) {
+        if (!unavailableRequesters[i]) {
+            unavailableRequesters[i] = requesterId;
+            return;
+        }
+    }
+    MO_DBG_ERR("exceeded max. unavailable requesters");
+}
+
+void AvailabilityServiceEvse::setAvailable(void *requesterId) {
+    for (size_t i = 0; i < MO_INOPERATIVE_REQUESTERS_MAX; i++) {
+        if (unavailableRequesters[i] == requesterId) {
+            unavailableRequesters[i] = nullptr;
+            return;
+        }
+    }
+    MO_DBG_ERR("could not find unavailable requester");
+}
+
+ChangeAvailabilityStatus AvailabilityServiceEvse::changeAvailability(bool operative) {
+    if (operative) {
+        setAvailable(this);
+    } else {
+        setUnavailable(this);
+    }
+
+    if (!operative) {
+        if (isAvailable()) {
+            return ChangeAvailabilityStatus::Scheduled;
+        }
+
+        if (evseId == 0) {
+            for (unsigned int id = 1; id < MO_NUM_EVSEID; id++) {
+                if (availabilityService.getEvse(id) && availabilityService.getEvse(id)->isAvailable()) {
+                    return ChangeAvailabilityStatus::Scheduled;
+                }
+            }
+        }
+    }
+
+    return ChangeAvailabilityStatus::Accepted;
+}
+
+void AvailabilityServiceEvse::setFaulted(void *requesterId) {
+    for (size_t i = 0; i < MO_FAULTED_REQUESTERS_MAX; i++) {
+        if (!faultedRequesters[i]) {
+            faultedRequesters[i] = requesterId;
+            return;
+        }
+    }
+    MO_DBG_ERR("exceeded max. faulted requesters");
+}
+
+void AvailabilityServiceEvse::resetFaulted(void *requesterId) {
+    for (size_t i = 0; i < MO_FAULTED_REQUESTERS_MAX; i++) {
+        if (faultedRequesters[i] == requesterId) {
+            faultedRequesters[i] = nullptr;
+            return;
+        }
+    }
+    MO_DBG_ERR("could not find faulted requester");
+}
+
+bool AvailabilityServiceEvse::isAvailable() {
+
+    auto txService = context.getModel().getTransactionService();
+    auto txEvse = txService ? txService->getEvse(evseId) : nullptr;
+    if (txEvse) {
+        if (txEvse->getTransaction() &&
+                txEvse->getTransaction()->started &&
+                !txEvse->getTransaction()->stopped) {
+            return true;
+        }
+    }
+
+    if (evseId > 0) {
+        if (availabilityService.getEvse(0) && !availabilityService.getEvse(0)->isAvailable()) {
+            return false;
+        }
+    }
+
+    for (size_t i = 0; i < MO_INOPERATIVE_REQUESTERS_MAX; i++) {
+        if (unavailableRequesters[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+
+bool AvailabilityServiceEvse::isFaulted() {
+    for (size_t i = 0; i < MO_FAULTED_REQUESTERS_MAX; i++) {
+        if (faultedRequesters[i]) {
+            return true;
+        }
+    }
+    return false;
+}
+
+AvailabilityService::AvailabilityService(Context& context, size_t numEvses) : MemoryManaged("v201.Availability.AvailabilityService"), context(context) {
+
+    for (size_t i = 0; i < numEvses && i < MO_NUM_EVSEID; i++) {
+        evses[i] = new AvailabilityServiceEvse(context, *this, (unsigned int)i);
+    }
+
+    context.getOperationRegistry().registerOperation("StatusNotification", [&context] () {
+        return new Ocpp16::StatusNotification(-1, ChargePointStatus_UNDEFINED, Timestamp());});
+    context.getOperationRegistry().registerOperation("ChangeAvailability", [this] () {
+        return new Ocpp201::ChangeAvailability(*this);});
+}
+
+AvailabilityService::~AvailabilityService() {
+    for (size_t i = 0; i < MO_NUM_EVSEID && evses[i]; i++) {
+        delete evses[i];
+    }
+}
+
+void AvailabilityService::loop() {
+    for (size_t i = 0; i < MO_NUM_EVSEID && evses[i]; i++) {
+        evses[i]->loop();
+    }
+}
+
+AvailabilityServiceEvse *AvailabilityService::getEvse(unsigned int evseId) {
+    if (evseId >= MO_NUM_EVSEID) {
+        MO_DBG_ERR("invalid arg");
+        return nullptr;
+    }
+    return evses[evseId];
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Availability/AvailabilityService.h b/src/MicroOcpp/Model/Availability/AvailabilityService.h
new file mode 100644
index 00000000..d8b74d61
--- /dev/null
+++ b/src/MicroOcpp/Model/Availability/AvailabilityService.h
@@ -0,0 +1,92 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+/*
+ * Implementation of the UCs G01, G03, G04.
+ *
+ * G02 (Heartbeat) is implemented in the HeartbeatService
+ */
+
+#ifndef MO_AVAILABILITYSERVICE_H
+#define MO_AVAILABILITYSERVICE_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <functional>
+
+#include <MicroOcpp/Model/Availability/ChangeAvailabilityStatus.h>
+#include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+#include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
+#include <MicroOcpp/Core/Memory.h>
+
+#ifndef MO_INOPERATIVE_REQUESTERS_MAX
+#define MO_INOPERATIVE_REQUESTERS_MAX 3
+#endif
+
+#ifndef MO_FAULTED_REQUESTERS_MAX
+#define MO_FAULTED_REQUESTERS_MAX 3
+#endif
+
+namespace MicroOcpp {
+
+class Context;
+class AvailabilityService;
+
+class AvailabilityServiceEvse : public MemoryManaged {
+private:
+    Context& context;
+    AvailabilityService& availabilityService;
+    const unsigned int evseId;
+
+    std::function<bool()> connectorPluggedInput;
+    std::function<bool()> occupiedInput; //instead of Available, go into Occupied
+
+    void *unavailableRequesters [MO_INOPERATIVE_REQUESTERS_MAX] = {nullptr};
+    void *faultedRequesters [MO_FAULTED_REQUESTERS_MAX] = {nullptr};
+
+    ChargePointStatus reportedStatus = ChargePointStatus_UNDEFINED;
+public:
+    AvailabilityServiceEvse(Context& context, AvailabilityService& availabilityService, unsigned int evseId);
+
+    void loop();
+
+    void setConnectorPluggedInput(std::function<bool()> connectorPluggedInput);
+    void setOccupiedInput(std::function<bool()> occupiedInput);
+
+    ChargePointStatus getStatus();
+
+    void setUnavailable(void *requesterId);
+    void setAvailable(void *requesterId);
+
+    ChangeAvailabilityStatus changeAvailability(bool operative);
+
+    void setFaulted(void *requesterId);
+    void resetFaulted(void *requesterId);
+
+    bool isAvailable();
+    bool isFaulted();
+};
+
+class AvailabilityService : public MemoryManaged {
+private:
+    Context& context;
+
+    AvailabilityServiceEvse* evses [MO_NUM_EVSEID] = {nullptr};
+
+public:
+    AvailabilityService(Context& context, size_t numEvses);
+    ~AvailabilityService();
+
+    void loop();
+
+    AvailabilityServiceEvse *getEvse(unsigned int evseId);
+};
+
+} // namespace MicroOcpp
+
+#endif // MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Model/Availability/ChangeAvailabilityStatus.h b/src/MicroOcpp/Model/Availability/ChangeAvailabilityStatus.h
new file mode 100644
index 00000000..113a3768
--- /dev/null
+++ b/src/MicroOcpp/Model/Availability/ChangeAvailabilityStatus.h
@@ -0,0 +1,25 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_CHANGEAVAILABILITYSTATUS_H
+#define MO_CHANGEAVAILABILITYSTATUS_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <stdint.h>
+
+namespace MicroOcpp {
+
+enum class ChangeAvailabilityStatus : uint8_t {
+    Accepted,
+    Rejected,
+    Scheduled
+};
+
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+#endif
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index c0911858..244185bd 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -342,7 +342,7 @@ void Connector::loop() {
 
                 auto meteringService = model.getMeteringService();
                 if (transaction->getMeterStart() < 0 && meteringService) {
-                    auto meterStart = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionBegin);
+                    auto meterStart = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext_TransactionBegin);
                     if (meterStart && *meterStart) {
                         transaction->setMeterStart(meterStart->toInteger());
                     } else {
@@ -386,7 +386,7 @@ void Connector::loop() {
                 
                 auto meteringService = model.getMeteringService();
                 if (transaction->getMeterStop() < 0 && meteringService) {
-                    auto meterStop = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext::TransactionEnd);
+                    auto meterStop = meteringService->readTxEnergyMeter(transaction->getConnectorId(), ReadingContext_TransactionEnd);
                     if (meterStop && *meterStop) {
                         transaction->setMeterStop(meterStop->toInteger());
                     } else {
diff --git a/src/MicroOcpp/Model/ConnectorBase/EvseId.h b/src/MicroOcpp/Model/ConnectorBase/EvseId.h
index 14a3c661..6ca5295a 100644
--- a/src/MicroOcpp/Model/ConnectorBase/EvseId.h
+++ b/src/MicroOcpp/Model/ConnectorBase/EvseId.h
@@ -9,14 +9,14 @@
 
 #if MO_ENABLE_V201
 
-// number of EVSEs. Defaults to MO_NUMCONNECTORS if defined, otherwise to 2
-#ifndef MO_NUM_EVSE
+// number of EVSE IDs (including 0). Defaults to MO_NUMCONNECTORS if defined, otherwise to 2
+#ifndef MO_NUM_EVSEID
 #if defined(MO_NUMCONNECTORS)
-#define MO_NUM_EVSE MO_NUMCONNECTORS
+#define MO_NUM_EVSEID MO_NUMCONNECTORS
 #else
-#define MO_NUM_EVSE 2
+#define MO_NUM_EVSEID 2
 #endif
-#endif // MO_NUM_EVSE
+#endif // MO_NUM_EVSEID
 
 namespace MicroOcpp {
 
diff --git a/src/MicroOcpp/Model/Metering/MeterStore.cpp b/src/MicroOcpp/Model/Metering/MeterStore.cpp
index 68e84376..e4bc9e85 100644
--- a/src/MicroOcpp/Model/Metering/MeterStore.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterStore.cpp
@@ -187,7 +187,7 @@ std::shared_ptr<TransactionMeterData> MeterStore::getTxMeterData(MeterValueBuild
 
     //create new object and cache weak pointer
 
-    auto tx = std::make_shared<TransactionMeterData>(connectorId, txNr, filesystem);
+    auto tx = std::allocate_shared<TransactionMeterData>(makeAllocator<TransactionMeterData>(getMemoryTag()), connectorId, txNr, filesystem);
     
     if (filesystem) {
         char fn [MO_MAX_PATH_SIZE] = {'\0'};
diff --git a/src/MicroOcpp/Model/Metering/MeterValue.cpp b/src/MicroOcpp/Model/Metering/MeterValue.cpp
index dd52741d..740905da 100644
--- a/src/MicroOcpp/Model/Metering/MeterValue.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterValue.cpp
@@ -62,11 +62,11 @@ void MeterValue::setTimestamp(Timestamp timestamp) {
 ReadingContext MeterValue::getReadingContext() {
     //all sampledValues have the same ReadingContext. Just get the first result
     for (auto sample = sampledValue.begin(); sample != sampledValue.end(); sample++) {
-        if ((*sample)->getReadingContext() != ReadingContext::NOT_SET) {
+        if ((*sample)->getReadingContext() != ReadingContext_UNDEFINED) {
             return (*sample)->getReadingContext();
         }
     }
-    return ReadingContext::NOT_SET;
+    return ReadingContext_UNDEFINED;
 }
 
 void MeterValue::setTxNr(unsigned int txNr) {
diff --git a/src/MicroOcpp/Model/Metering/MeterValuesV201.cpp b/src/MicroOcpp/Model/Metering/MeterValuesV201.cpp
new file mode 100644
index 00000000..fc856204
--- /dev/null
+++ b/src/MicroOcpp/Model/Metering/MeterValuesV201.cpp
@@ -0,0 +1,351 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Metering/MeterValuesV201.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Variables/Variable.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Debug.h>
+
+//helper function
+namespace MicroOcpp {
+
+bool csvContains(const char *csv, const char *elem) {
+
+    if (!csv || !elem) {
+        return false;
+    }
+
+    size_t elemLen = strlen(elem);
+
+    size_t sl = 0, sr = 0;
+    while (csv[sr]) {
+        while (csv[sr]) {
+            if (csv[sr] == ',') {
+                break;
+            }
+            sr++;
+        }
+        //csv[sr] is either ',' or '\0'
+
+        if (sr - sl == elemLen && !strncmp(csv + sl, elem, sr - sl)) {
+            return true;
+        }
+
+        if (csv[sr]) {
+            sr++;
+        }
+        sl = sr;
+    }
+    return false;
+}
+
+} //namespace MicroOcpp
+
+using namespace MicroOcpp::Ocpp201;
+
+SampledValueProperties::SampledValueProperties() : MemoryManaged("v201.MeterValues.SampledValueProperties") { }
+SampledValueProperties::SampledValueProperties(const SampledValueProperties& other) :
+        MemoryManaged(other.getMemoryTag()), 
+        format(other.format), 
+        measurand(other.measurand), 
+        phase(other.phase), 
+        location(other.location), 
+        unitOfMeasureUnit(other.unitOfMeasureUnit),
+        unitOfMeasureMultiplier(other.unitOfMeasureMultiplier) {
+
+}
+
+void SampledValueProperties::setFormat(const char *format) {this->format = format;}
+const char *SampledValueProperties::getFormat() const {return format;}
+void SampledValueProperties::setMeasurand(const char *measurand) {this->measurand = measurand;}
+const char *SampledValueProperties::getMeasurand() const {return measurand;}
+void SampledValueProperties::setPhase(const char *phase) {this->phase = phase;}
+const char *SampledValueProperties::getPhase() const {return phase;}
+void SampledValueProperties::setLocation(const char *location) {this->location = location;}
+const char *SampledValueProperties::getLocation() const {return location;}
+void SampledValueProperties::setUnitOfMeasureUnit(const char *unitOfMeasureUnit) {this->unitOfMeasureUnit = unitOfMeasureUnit;}
+const char *SampledValueProperties::getUnitOfMeasureUnit() const {return unitOfMeasureUnit;}
+void SampledValueProperties::setUnitOfMeasureMultiplier(int unitOfMeasureMultiplier) {this->unitOfMeasureMultiplier = unitOfMeasureMultiplier;}
+int SampledValueProperties::getUnitOfMeasureMultiplier() const {return unitOfMeasureMultiplier;}
+
+SampledValue::SampledValue(double value, ReadingContext readingContext, SampledValueProperties& properties)
+        : MemoryManaged("v201.MeterValues.SampledValue"), value(value), readingContext(readingContext), properties(properties) {
+
+}
+
+bool SampledValue::toJson(JsonDoc& out) {
+
+    size_t unitOfMeasureElements = 
+            (properties.getUnitOfMeasureUnit() ? 1 : 0) +
+            (properties.getUnitOfMeasureMultiplier() ? 1 : 0);
+
+    out = initJsonDoc(getMemoryTag(),
+        JSON_OBJECT_SIZE(
+            1 + //value
+            (readingContext != ReadingContext_SamplePeriodic ? 1 : 0) +
+            (properties.getMeasurand() ? 1 : 0) +
+            (properties.getPhase() ? 1 : 0) +
+            (properties.getLocation() ? 1 : 0) +
+            (unitOfMeasureElements ? 1 : 0)
+        ) +
+        (unitOfMeasureElements ? JSON_OBJECT_SIZE(unitOfMeasureElements) : 0)
+    );
+
+    out["value"] = value;
+    if (readingContext != ReadingContext_SamplePeriodic)
+        out["context"] = serializeReadingContext(readingContext);
+    if (properties.getMeasurand())
+        out["measurand"] = properties.getMeasurand();
+    if (properties.getPhase())
+        out["phase"] = properties.getPhase();
+    if (properties.getLocation())
+        out["location"] = properties.getLocation();
+    if (properties.getUnitOfMeasureUnit())
+        out["unitOfMeasure"]["unit"] = properties.getUnitOfMeasureUnit();
+    if (properties.getUnitOfMeasureMultiplier())
+        out["unitOfMeasure"]["multiplier"] = properties.getUnitOfMeasureMultiplier();
+
+    return true;
+}
+
+SampledValueInput::SampledValueInput(std::function<double(ReadingContext)> valueInput, const SampledValueProperties& properties)
+        : MemoryManaged("v201.MeterValues.SampledValueInput"), valueInput(valueInput), properties(properties) {
+
+}
+
+SampledValue *SampledValueInput::takeSampledValue(ReadingContext readingContext) {
+    return new SampledValue(valueInput(readingContext), readingContext, properties);
+}
+
+const SampledValueProperties& SampledValueInput::getProperties() {
+    return properties;
+}
+
+uint8_t& SampledValueInput::getMeasurandTypeFlags() {
+    return measurandTypeFlags;
+}
+
+MeterValue::MeterValue(const Timestamp& timestamp, SampledValue **sampledValue, size_t sampledValueSize) :
+        MemoryManaged("v201.MeterValues.MeterValue"), timestamp(timestamp), sampledValue(sampledValue), sampledValueSize(sampledValueSize) {
+    
+}
+
+MeterValue::~MeterValue() {
+    for (size_t i = 0; i < sampledValueSize; i++) {
+        delete sampledValue[i];
+    }
+    MO_FREE(sampledValue);
+}
+
+bool MeterValue::toJson(JsonDoc& out) {
+
+    size_t capacity = 0;
+
+    for (size_t i = 0; i < sampledValueSize; i++) {
+        //just measure, discard sampledValueJson afterwards
+        JsonDoc sampledValueJson = initJsonDoc(getMemoryTag());
+        sampledValue[i]->toJson(sampledValueJson);
+        capacity += sampledValueJson.capacity();
+    }
+
+    capacity += JSON_OBJECT_SIZE(2) +
+                JSONDATE_LENGTH + 1 +
+                JSON_ARRAY_SIZE(sampledValueSize);
+                
+
+    out = initJsonDoc("v201.MeterValues.MeterValue", capacity);
+
+    char timestampStr [JSONDATE_LENGTH + 1];
+    timestamp.toJsonString(timestampStr, sizeof(timestampStr));
+    
+    out["timestamp"] = timestampStr;
+    JsonArray sampledValueArray = out.createNestedArray("sampledValue");
+    
+    for (size_t i = 0; i < sampledValueSize; i++) {
+        JsonDoc sampledValueJson = initJsonDoc(getMemoryTag());
+        sampledValue[i]->toJson(sampledValueJson);
+        sampledValueArray.add(sampledValueJson);
+    }
+
+    return true;
+}
+
+const MicroOcpp::Timestamp& MeterValue::getTimestamp() {
+    return timestamp;
+}
+
+MeteringServiceEvse::MeteringServiceEvse(Model& model, unsigned int evseId)
+        : MemoryManaged("v201.MeterValues.MeteringServiceEvse"), model(model), evseId(evseId), sampledValueInputs(makeVector<SampledValueInput>(getMemoryTag())) {
+
+    auto varService = model.getVariableService();
+
+    sampledDataTxStartedMeasurands = varService->declareVariable<const char*>("SampledDataCtrlr", "TxStartedMeasurands", "");
+    sampledDataTxUpdatedMeasurands = varService->declareVariable<const char*>("SampledDataCtrlr", "TxUpdatedMeasurands", "");
+    sampledDataTxEndedMeasurands = varService->declareVariable<const char*>("SampledDataCtrlr", "TxEndedMeasurands", "");
+    alignedDataMeasurands = varService->declareVariable<const char*>("AlignedDataCtrlr", "AlignedDataMeasurands", "");
+}
+
+void MeteringServiceEvse::addMeterValueInput(std::function<double(ReadingContext)> valueInput, const SampledValueProperties& properties) {
+    sampledValueInputs.emplace_back(valueInput, properties);
+}
+
+std::unique_ptr<MeterValue> MeteringServiceEvse::takeMeterValue(Variable *measurands, uint16_t& trackMeasurandsWriteCount, size_t& trackInputsSize, uint8_t measurandsMask, ReadingContext readingContext) {
+
+    if (measurands->getWriteCount() != trackMeasurandsWriteCount ||
+            sampledValueInputs.size() != trackInputsSize) {
+        MO_DBG_DEBUG("Updating observed samplers due to config change or samplers added");
+        for (size_t i = 0; i < sampledValueInputs.size(); i++) {
+            if (csvContains(measurands->getString(), sampledValueInputs[i].getProperties().getMeasurand())) {
+                sampledValueInputs[i].getMeasurandTypeFlags() |= measurandsMask;
+            } else {
+                sampledValueInputs[i].getMeasurandTypeFlags() &= ~measurandsMask;
+            }
+        }
+
+        trackMeasurandsWriteCount = measurands->getWriteCount();
+        trackInputsSize = sampledValueInputs.size();
+    }
+
+    size_t samplesSize = 0;
+
+    for (size_t i = 0; i < sampledValueInputs.size(); i++) {
+        if (sampledValueInputs[i].getMeasurandTypeFlags() & measurandsMask) {
+            samplesSize++;
+        }
+    }
+
+    if (samplesSize == 0) {
+        return nullptr;
+    }
+
+    SampledValue **sampledValue = static_cast<SampledValue**>(MO_MALLOC(getMemoryTag(), samplesSize * sizeof(SampledValue*)));
+    if (!sampledValue) {
+        MO_DBG_ERR("OOM");
+        return nullptr;
+    }
+    size_t samplesWritten = 0;
+
+    bool memoryErr = false;
+
+    for (size_t i = 0; i < sampledValueInputs.size(); i++) {
+        if (sampledValueInputs[i].getMeasurandTypeFlags() & measurandsMask) {
+            auto sample = sampledValueInputs[i].takeSampledValue(readingContext);
+            if (!sample) {
+                MO_DBG_ERR("OOM");
+                memoryErr = true;
+                break;
+            }
+            sampledValue[samplesWritten++] = sample;
+        }
+    }
+
+    std::unique_ptr<MeterValue> meterValue = std::unique_ptr<MeterValue>(new MeterValue(model.getClock().now(), sampledValue, samplesWritten));
+    if (!meterValue) {
+        MO_DBG_ERR("OOM");
+        memoryErr = true;
+    }
+
+    if (memoryErr) {
+        if (!meterValue) {
+            //meterValue did not take ownership, so clean resources manually
+            for (size_t i = 0; i < samplesWritten; i++) {
+                delete sampledValue[i];
+            }
+            delete sampledValue;
+        }
+        return nullptr;
+    }
+
+    return meterValue;
+}
+
+std::unique_ptr<MeterValue> MeteringServiceEvse::takeTxStartedMeterValue(ReadingContext readingContext) {
+    return takeMeterValue(sampledDataTxStartedMeasurands, trackSampledDataTxStartedMeasurandsWriteCount, trackSampledValueInputsSizeTxStarted, MO_MEASURAND_TYPE_TXSTARTED, readingContext);
+}
+std::unique_ptr<MeterValue> MeteringServiceEvse::takeTxUpdatedMeterValue(ReadingContext readingContext) {
+    return takeMeterValue(sampledDataTxUpdatedMeasurands, trackSampledDataTxUpdatedMeasurandsWriteCount, trackSampledValueInputsSizeTxUpdated, MO_MEASURAND_TYPE_TXUPDATED, readingContext);
+}
+std::unique_ptr<MeterValue> MeteringServiceEvse::takeTxEndedMeterValue(ReadingContext readingContext) {
+    return takeMeterValue(sampledDataTxEndedMeasurands, trackSampledDataTxEndedMeasurandsWriteCount, trackSampledValueInputsSizeTxEnded, MO_MEASURAND_TYPE_TXENDED, readingContext);
+}
+std::unique_ptr<MeterValue> MeteringServiceEvse::takeTriggeredMeterValues() {
+    return takeMeterValue(alignedDataMeasurands, trackAlignedDataMeasurandsWriteCount, trackSampledValueInputsSizeAligned, MO_MEASURAND_TYPE_ALIGNED, ReadingContext_Trigger);
+}
+
+bool MeteringServiceEvse::existsMeasurand(const char *measurand, size_t len) {
+    for (size_t i = 0; i < sampledValueInputs.size(); i++) {
+        const char *sviMeasurand = sampledValueInputs[i].getProperties().getMeasurand();
+        if (sviMeasurand && len == strlen(sviMeasurand) && !strncmp(sviMeasurand, measurand, len)) {
+            return true;
+        }
+    }
+    return false;
+}
+
+MeteringService::MeteringService(Model& model, size_t numEvses) {
+
+    auto varService = model.getVariableService();
+
+    //define factory defaults
+    varService->declareVariable<const char*>("SampledDataCtrlr", "TxStartedMeasurands", "");
+    varService->declareVariable<const char*>("SampledDataCtrlr", "TxUpdatedMeasurands", "");
+    varService->declareVariable<const char*>("SampledDataCtrlr", "TxEndedMeasurands", "");
+    varService->declareVariable<const char*>("AlignedDataCtrlr", "AlignedDataMeasurands", "");
+
+    std::function<bool(const char*)> validateSelectString = [this] (const char *csl) {
+        bool isValid = true;
+        const char *l = csl; //the beginning of an entry of the comma-separated list
+        const char *r = l; //one place after the last character of the entry beginning with l
+        while (*l) {
+            if (*l == ',') {
+                l++;
+                continue;
+            }
+            r = l + 1;
+            while (*r != '\0' && *r != ',') {
+                r++;
+            }
+            bool found = false;
+            for (size_t evseId = 0; evseId < MO_NUM_EVSEID && evses[evseId]; evseId++) {
+                if (evses[evseId]->existsMeasurand(l, (size_t) (r - l))) {
+                    found = true;
+                    break;
+                }
+            }
+            if (!found) {
+                isValid = false;
+                MO_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
+                break;
+            }
+            l = r;
+        }
+        return isValid;
+    };
+
+    varService->registerValidator<const char*>("SampledDataCtrlr", "TxStartedMeasurands", validateSelectString);
+    varService->registerValidator<const char*>("SampledDataCtrlr", "TxUpdatedMeasurands", validateSelectString);
+    varService->registerValidator<const char*>("SampledDataCtrlr", "TxEndedMeasurands", validateSelectString);
+    varService->registerValidator<const char*>("AlignedDataCtrlr", "AlignedDataMeasurands", validateSelectString);
+
+    for (size_t evseId = 0; evseId < std::min(numEvses, (size_t)MO_NUM_EVSEID); evseId++) {
+        evses[evseId] = new MeteringServiceEvse(model, evseId);
+    }
+}
+
+MeteringService::~MeteringService() {
+    for (size_t evseId = 0; evseId < MO_NUM_EVSEID && evses[evseId]; evseId++) {
+        delete evses[evseId];
+    }
+}
+
+MeteringServiceEvse *MeteringService::getEvse(unsigned int evseId) {
+    return evses[evseId];
+}
+
+#endif
diff --git a/src/MicroOcpp/Model/Metering/MeterValuesV201.h b/src/MicroOcpp/Model/Metering/MeterValuesV201.h
new file mode 100644
index 00000000..f35ec146
--- /dev/null
+++ b/src/MicroOcpp/Model/Metering/MeterValuesV201.h
@@ -0,0 +1,152 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+/*
+ * Implementation of the UCs E01 - E12
+ */
+
+#ifndef MO_METERVALUESV201_H
+#define MO_METERVALUESV201_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <functional>
+
+#include <MicroOcpp/Model/Metering/ReadingContext.h>
+#include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+#include <MicroOcpp/Core/Time.h>
+#include <MicroOcpp/Core/Memory.h>
+
+namespace MicroOcpp {
+
+class Model;
+class Variable;
+
+namespace Ocpp201 {
+
+class SampledValueProperties : public MemoryManaged {
+private:
+    const char *format = nullptr;
+    const char *measurand = nullptr;
+    const char *phase = nullptr;
+    const char *location = nullptr;
+    const char *unitOfMeasureUnit = nullptr;
+    int unitOfMeasureMultiplier = 0;
+
+public:
+    SampledValueProperties();
+    SampledValueProperties(const SampledValueProperties&);
+
+    void setFormat(const char *format); //zero-copy
+    const char *getFormat() const;
+    void setMeasurand(const char *measurand); //zero-copy
+    const char *getMeasurand() const;
+    void setPhase(const char *phase); //zero-copy
+    const char *getPhase() const;
+    void setLocation(const char *location); //zero-copy
+    const char *getLocation() const;
+    void setUnitOfMeasureUnit(const char *unitOfMeasureUnit); //zero-copy
+    const char *getUnitOfMeasureUnit() const;
+    void setUnitOfMeasureMultiplier(int unitOfMeasureMultiplier);
+    int getUnitOfMeasureMultiplier() const;
+};
+
+class SampledValue : public MemoryManaged {
+private:
+    double value = 0.;
+    ReadingContext readingContext;
+    SampledValueProperties& properties;
+    //std::unique_ptr<SignedMeterValue> ... this could be an abstract type
+public:
+    SampledValue(double value, ReadingContext readingContext, SampledValueProperties& properties);
+
+    bool toJson(JsonDoc& out);
+};
+
+#define MO_MEASURAND_TYPE_TXSTARTED (1 << 0)
+#define MO_MEASURAND_TYPE_TXUPDATED (1 << 1)
+#define MO_MEASURAND_TYPE_TXENDED   (1 << 2)
+#define MO_MEASURAND_TYPE_ALIGNED   (1 << 3)
+
+class SampledValueInput : public MemoryManaged {
+private:
+    std::function<double(ReadingContext)> valueInput;
+    SampledValueProperties properties;
+
+    uint8_t measurandTypeFlags = 0;
+public:
+    SampledValueInput(std::function<double(ReadingContext)> valueInput, const SampledValueProperties& properties);
+    SampledValue *takeSampledValue(ReadingContext readingContext);
+
+    const SampledValueProperties& getProperties();
+
+    uint8_t& getMeasurandTypeFlags();
+};
+
+class MeterValue : public MemoryManaged {
+private:
+    Timestamp timestamp;
+    SampledValue **sampledValue = nullptr;
+    size_t sampledValueSize = 0;
+public:
+    MeterValue(const Timestamp& timestamp, SampledValue **sampledValue, size_t sampledValueSize);
+    ~MeterValue();
+
+    bool toJson(JsonDoc& out);
+
+    const Timestamp& getTimestamp();
+};
+
+class MeteringServiceEvse : public MemoryManaged {
+private:
+    Model& model;
+    const unsigned int evseId;
+ 
+    Vector<SampledValueInput> sampledValueInputs;
+
+    Variable *sampledDataTxStartedMeasurands = nullptr;
+    Variable *sampledDataTxUpdatedMeasurands = nullptr;
+    Variable *sampledDataTxEndedMeasurands = nullptr;
+    Variable *alignedDataMeasurands = nullptr;
+
+    size_t trackSampledValueInputsSizeTxStarted = 0;
+    size_t trackSampledValueInputsSizeTxUpdated = 0;
+    size_t trackSampledValueInputsSizeTxEnded = 0;
+    size_t trackSampledValueInputsSizeAligned = 0;
+    uint16_t trackSampledDataTxStartedMeasurandsWriteCount = -1;
+    uint16_t trackSampledDataTxUpdatedMeasurandsWriteCount = -1;
+    uint16_t trackSampledDataTxEndedMeasurandsWriteCount = -1;
+    uint16_t trackAlignedDataMeasurandsWriteCount = -1;
+
+    std::unique_ptr<MeterValue> takeMeterValue(Variable *measurands, uint16_t& trackMeasurandsWriteCount, size_t& trackInputsSize, uint8_t measurandsMask, ReadingContext context);
+public:
+    MeteringServiceEvse(Model& model, unsigned int evseId);
+
+    void addMeterValueInput(std::function<double(ReadingContext)> valueInput, const SampledValueProperties& properties);
+
+    std::unique_ptr<MeterValue> takeTxStartedMeterValue(ReadingContext context = ReadingContext_TransactionBegin);
+    std::unique_ptr<MeterValue> takeTxUpdatedMeterValue(ReadingContext context = ReadingContext_SamplePeriodic);
+    std::unique_ptr<MeterValue> takeTxEndedMeterValue(ReadingContext context);
+    std::unique_ptr<MeterValue> takeTriggeredMeterValues();
+
+    bool existsMeasurand(const char *measurand, size_t len);
+};
+
+class MeteringService : public MemoryManaged {
+private:
+    MeteringServiceEvse* evses [MO_NUM_EVSEID] = {nullptr};
+public:
+    MeteringService(Model& model, size_t numEvses);
+    ~MeteringService();
+
+    MeteringServiceEvse *getEvse(unsigned int evseId);
+};
+
+}
+}
+
+#endif
+#endif
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index ad3b6807..e9dfc628 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -98,7 +98,7 @@ void MeteringConnector::loop() {
                 "in time (tolerance <= 60s)" : "off, e.g. because of first run. Ignore");
             if (abs(dt) <= 60) { //is measurement still "clock-aligned"?
 
-                if (auto alignedMeterValue = alignedDataBuilder->takeSample(model.getClock().now(), ReadingContext::SampleClock)) {
+                if (auto alignedMeterValue = alignedDataBuilder->takeSample(model.getClock().now(), ReadingContext_SampleClock)) {
                     if (meterData.size() >= MO_METERVALUES_CACHE_MAXSIZE) {
                         MO_DBG_INFO("MeterValue cache full. Drop old MV");
                         meterData.erase(meterData.begin());
@@ -111,7 +111,7 @@ void MeteringConnector::loop() {
                 }
 
                 if (stopTxnData) {
-                    auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(model.getClock().now(), ReadingContext::SampleClock);
+                    auto alignedStopTx = stopTxnAlignedDataBuilder->takeSample(model.getClock().now(), ReadingContext_SampleClock);
                     if (alignedStopTx) {
                         stopTxnData->addTxData(std::move(alignedStopTx));
                     }
@@ -138,7 +138,7 @@ void MeteringConnector::loop() {
         //record periodic tx data
 
         if (mocpp_tick_ms() - lastSampleTime >= (unsigned long) (meterValueSampleIntervalInt->getInt() * 1000)) {
-            if (auto sampledMeterValue = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::SamplePeriodic)) {
+            if (auto sampledMeterValue = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext_SamplePeriodic)) {
                 if (meterData.size() >= MO_METERVALUES_CACHE_MAXSIZE) {
                     MO_DBG_INFO("MeterValue cache full. Drop old MV");
                     meterData.erase(meterData.begin());
@@ -151,7 +151,7 @@ void MeteringConnector::loop() {
             }
 
             if (stopTxnData && stopTxnDataCapturePeriodicBool->getBool()) {
-                auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::SamplePeriodic);
+                auto sampleStopTx = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext_SamplePeriodic);
                 if (sampleStopTx) {
                     stopTxnData->addTxData(std::move(sampleStopTx));
                 }
@@ -163,7 +163,7 @@ void MeteringConnector::loop() {
 
 std::unique_ptr<Operation> MeteringConnector::takeTriggeredMeterValues() {
 
-    auto sample = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::Trigger);
+    auto sample = sampledDataBuilder->takeSample(model.getClock().now(), ReadingContext_Trigger);
 
     if (!sample) {
         return nullptr;
@@ -199,7 +199,7 @@ void MeteringConnector::beginTxMeterData(Transaction *transaction) {
     }
 
     if (stopTxnData) {
-        auto sampleTxBegin = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::TransactionBegin);
+        auto sampleTxBegin = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext_TransactionBegin);
         if (sampleTxBegin) {
             stopTxnData->addTxData(std::move(sampleTxBegin));
         }
@@ -212,7 +212,7 @@ std::shared_ptr<TransactionMeterData> MeteringConnector::endTxMeterData(Transact
     }
 
     if (stopTxnData) {
-        auto sampleTxEnd = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext::TransactionEnd);
+        auto sampleTxEnd = stopTxnSampledDataBuilder->takeSample(model.getClock().now(), ReadingContext_TransactionEnd);
         if (sampleTxEnd) {
             stopTxnData->addTxData(std::move(sampleTxEnd));
         }
diff --git a/src/MicroOcpp/Model/Metering/ReadingContext.cpp b/src/MicroOcpp/Model/Metering/ReadingContext.cpp
new file mode 100644
index 00000000..2ea24886
--- /dev/null
+++ b/src/MicroOcpp/Model/Metering/ReadingContext.cpp
@@ -0,0 +1,65 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <string.h>
+
+#include <MicroOcpp/Model/Metering/ReadingContext.h>
+#include <MicroOcpp/Debug.h>
+
+namespace MicroOcpp {
+
+const char *serializeReadingContext(ReadingContext context) {
+    switch (context) {
+        case (ReadingContext_InterruptionBegin):
+            return "Interruption.Begin";
+        case (ReadingContext_InterruptionEnd):
+            return "Interruption.End";
+        case (ReadingContext_Other):
+            return "Other";
+        case (ReadingContext_SampleClock):
+            return "Sample.Clock";
+        case (ReadingContext_SamplePeriodic):
+            return "Sample.Periodic";
+        case (ReadingContext_TransactionBegin):
+            return "Transaction.Begin";
+        case (ReadingContext_TransactionEnd):
+            return "Transaction.End";
+        case (ReadingContext_Trigger):
+            return "Trigger";
+        default:
+            MO_DBG_ERR("ReadingContext not specified");
+            /* fall through */
+        case (ReadingContext_UNDEFINED):
+            return "";
+    }
+}
+ReadingContext deserializeReadingContext(const char *context) {
+    if (!context) {
+        MO_DBG_ERR("Invalid argument");
+        return ReadingContext_UNDEFINED;
+    }
+
+    if (!strcmp(context, "Sample.Periodic")) {
+        return ReadingContext_SamplePeriodic;
+    } else if (!strcmp(context, "Sample.Clock")) {
+        return ReadingContext_SampleClock;
+    } else if (!strcmp(context, "Transaction.Begin")) {
+        return ReadingContext_TransactionBegin;
+    } else if (!strcmp(context, "Transaction.End")) {
+        return ReadingContext_TransactionEnd;
+    } else if (!strcmp(context, "Other")) {
+        return ReadingContext_Other;
+    } else if (!strcmp(context, "Interruption.Begin")) {
+        return ReadingContext_InterruptionBegin;
+    } else if (!strcmp(context, "Interruption.End")) {
+        return ReadingContext_InterruptionEnd;
+    } else if (!strcmp(context, "Trigger")) {
+        return ReadingContext_Trigger;
+    }
+
+    MO_DBG_ERR("ReadingContext not specified %.10s", context);
+    return ReadingContext_UNDEFINED;
+}
+
+} //namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/Metering/ReadingContext.h b/src/MicroOcpp/Model/Metering/ReadingContext.h
new file mode 100644
index 00000000..592914e1
--- /dev/null
+++ b/src/MicroOcpp/Model/Metering/ReadingContext.h
@@ -0,0 +1,28 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_READINGCONTEXT_H
+#define MO_READINGCONTEXT_H
+
+typedef enum {
+    ReadingContext_UNDEFINED,
+    ReadingContext_InterruptionBegin,
+    ReadingContext_InterruptionEnd,
+    ReadingContext_Other,
+    ReadingContext_SampleClock,
+    ReadingContext_SamplePeriodic,
+    ReadingContext_TransactionBegin,
+    ReadingContext_TransactionEnd,
+    ReadingContext_Trigger
+}   ReadingContext;
+
+#ifdef __cplusplus
+
+namespace MicroOcpp {
+const char *serializeReadingContext(ReadingContext context);
+ReadingContext deserializeReadingContext(const char *serialized);
+}
+
+#endif
+#endif
diff --git a/src/MicroOcpp/Model/Metering/SampledValue.cpp b/src/MicroOcpp/Model/Metering/SampledValue.cpp
index 64f96152..4168a048 100644
--- a/src/MicroOcpp/Model/Metering/SampledValue.cpp
+++ b/src/MicroOcpp/Model/Metering/SampledValue.cpp
@@ -29,66 +29,6 @@ MicroOcpp::String SampledValueDeSerializer<float>::serialize(float& val) {
     return makeString("v16.Metering.SampledValueDeSerializer<float>", str);
 }
 
-//helper function
-namespace MicroOcpp {
-namespace Ocpp16 {
-const char *serializeReadingContext(ReadingContext context) {
-    switch (context) {
-        case (ReadingContext::InterruptionBegin):
-            return "Interruption.Begin";
-        case (ReadingContext::InterruptionEnd):
-            return "Interruption.End";
-        case (ReadingContext::Other):
-            return "Other";
-        case (ReadingContext::SampleClock):
-            return "Sample.Clock";
-        case (ReadingContext::SamplePeriodic):
-            return "Sample.Periodic";
-        case (ReadingContext::TransactionBegin):
-            return "Transaction.Begin";
-        case (ReadingContext::TransactionEnd):
-            return "Transaction.End";
-        case (ReadingContext::Trigger):
-            return "Trigger";
-        default:
-            MO_DBG_ERR("ReadingContext not specified");
-            /* fall through */
-        case (ReadingContext::NOT_SET):
-            return nullptr;
-    }
-}
-ReadingContext deserializeReadingContext(const char *context) {
-    if (!context) {
-        MO_DBG_ERR("Invalid argument");
-        return ReadingContext::NOT_SET;
-    }
-
-    if (!strcmp(context, "NOT_SET")) {
-        MO_DBG_DEBUG("Deserialize Null-ReadingContext");
-        return ReadingContext::NOT_SET;
-    } else if (!strcmp(context, "Sample.Periodic")) {
-        return ReadingContext::SamplePeriodic;
-    } else if (!strcmp(context, "Sample.Clock")) {
-        return ReadingContext::SampleClock;
-    } else if (!strcmp(context, "Transaction.Begin")) {
-        return ReadingContext::TransactionBegin;
-    } else if (!strcmp(context, "Transaction.End")) {
-        return ReadingContext::TransactionEnd;
-    } else if (!strcmp(context, "Other")) {
-        return ReadingContext::Other;
-    } else if (!strcmp(context, "Interruption.Begin")) {
-        return ReadingContext::InterruptionBegin;
-    } else if (!strcmp(context, "Interruption.End")) {
-        return ReadingContext::InterruptionEnd;
-    } else if (!strcmp(context, "Trigger")) {
-        return ReadingContext::Trigger;
-    }
-
-    MO_DBG_ERR("ReadingContext not specified %.10s", context);
-    return ReadingContext::NOT_SET;
-}
-}} //end namespaces
-
 std::unique_ptr<JsonDoc> SampledValue::toJson() {
     auto value = serializeValue();
     if (value.empty()) {
@@ -100,7 +40,7 @@ std::unique_ptr<JsonDoc> SampledValue::toJson() {
     auto result = makeJsonDoc("v16.Metering.SampledValue", capacity);
     auto payload = result->to<JsonObject>();
     payload["value"] = value;
-    auto context_cstr = Ocpp16::serializeReadingContext(context);
+    auto context_cstr = serializeReadingContext(context);
     if (context_cstr)
         payload["context"] = context_cstr;
     if (*properties.getFormat())
diff --git a/src/MicroOcpp/Model/Metering/SampledValue.h b/src/MicroOcpp/Model/Metering/SampledValue.h
index aabc674d..350990ae 100644
--- a/src/MicroOcpp/Model/Metering/SampledValue.h
+++ b/src/MicroOcpp/Model/Metering/SampledValue.h
@@ -9,6 +9,7 @@
 #include <memory>
 #include <functional>
 
+#include <MicroOcpp/Model/Metering/ReadingContext.h>
 #include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Platform.h>
 
@@ -76,23 +77,6 @@ class SampledValueProperties {
     const char *getUnit() const {return unit.c_str();}
 };
 
-enum class ReadingContext {
-    InterruptionBegin,
-    InterruptionEnd,
-    Other,
-    SampleClock,
-    SamplePeriodic,
-    TransactionBegin,
-    TransactionEnd,
-    Trigger,
-    NOT_SET
-};
-
-namespace Ocpp16 {
-const char *serializeReadingContext(ReadingContext context);
-ReadingContext deserializeReadingContext(const char *serialized);
-}
-
 class SampledValue {
 protected:
     const SampledValueProperties& properties;
@@ -153,7 +137,7 @@ class SampledValueSamplerConcrete : public SampledValueSampler, public MemoryMan
     std::unique_ptr<SampledValue> deserializeValue(JsonObject svJson) override {
         return std::unique_ptr<SampledValueConcrete<T, DeSerializer>>(new SampledValueConcrete<T, DeSerializer>(
             properties,
-            Ocpp16::deserializeReadingContext(svJson["context"] | "NOT_SET"),
+            deserializeReadingContext(svJson["context"] | "NOT_SET"),
             DeSerializer::deserialize(svJson["value"] | "")));
     }
 };
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index 571f19cb..f2e19c1e 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -8,6 +8,7 @@
 #include <MicroOcpp/Model/SmartCharging/SmartChargingService.h>
 #include <MicroOcpp/Model/ConnectorBase/ConnectorsCommon.h>
 #include <MicroOcpp/Model/Metering/MeteringService.h>
+#include <MicroOcpp/Model/Metering/MeterValuesV201.h>
 #include <MicroOcpp/Model/FirmwareManagement/FirmwareService.h>
 #include <MicroOcpp/Model/Diagnostics/DiagnosticsService.h>
 #include <MicroOcpp/Model/Heartbeat/HeartbeatService.h>
@@ -18,6 +19,8 @@
 #include <MicroOcpp/Model/Variables/VariableService.h>
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Model/Certificates/CertificateService.h>
+#include <MicroOcpp/Model/Availability/AvailabilityService.h>
+#include <MicroOcpp/Model/RemoteControl/RemoteControlService.h>
 
 #include <MicroOcpp/Core/Configuration.h>
 
@@ -77,6 +80,9 @@ void Model::loop() {
         resetService->loop();
 
 #if MO_ENABLE_V201
+    if (availabilityService)
+        availabilityService->loop();
+
     if (transactionService)
         transactionService->loop();
     
@@ -214,6 +220,15 @@ CertificateService *Model::getCertificateService() const {
 #endif //MO_ENABLE_CERT_MGMT
 
 #if MO_ENABLE_V201
+void Model::setAvailabilityService(std::unique_ptr<AvailabilityService> as) {
+    this->availabilityService = std::move(as);
+    capabilitiesUpdated = true;
+}
+
+AvailabilityService *Model::getAvailabilityService() const {
+    return availabilityService.get();
+}
+
 void Model::setVariableService(std::unique_ptr<VariableService> vs) {
     this->variableService = std::move(vs);
     capabilitiesUpdated = true;
@@ -240,6 +255,24 @@ void Model::setResetServiceV201(std::unique_ptr<Ocpp201::ResetService> rs) {
 Ocpp201::ResetService *Model::getResetServiceV201() const {
     return resetServiceV201.get();
 }
+
+void Model::setMeteringServiceV201(std::unique_ptr<Ocpp201::MeteringService> rs) {
+    this->meteringServiceV201 = std::move(rs);
+    capabilitiesUpdated = true;
+}
+
+Ocpp201::MeteringService *Model::getMeteringServiceV201() const {
+    return meteringServiceV201.get();
+}
+
+void Model::setRemoteControlService(std::unique_ptr<RemoteControlService> rs) {
+    remoteControlService = std::move(rs);
+    capabilitiesUpdated = true;
+}
+
+RemoteControlService *Model::getRemoteControlService() const {
+    return remoteControlService.get();
+}
 #endif
 
 Clock& Model::getClock() {
diff --git a/src/MicroOcpp/Model/Model.h b/src/MicroOcpp/Model/Model.h
index 67639ee1..ff31bdb2 100644
--- a/src/MicroOcpp/Model/Model.h
+++ b/src/MicroOcpp/Model/Model.h
@@ -37,11 +37,14 @@ class CertificateService;
 #endif //MO_ENABLE_CERT_MGMT
 
 #if MO_ENABLE_V201
+class AvailabilityService;
 class VariableService;
 class TransactionService;
+class RemoteControlService;
 
 namespace Ocpp201 {
 class ResetService;
+class MeteringService;
 }
 #endif //MO_ENABLE_V201
 
@@ -71,9 +74,12 @@ class Model : public MemoryManaged {
 #endif //MO_ENABLE_CERT_MGMT
 
 #if MO_ENABLE_V201
+    std::unique_ptr<AvailabilityService> availabilityService;
     std::unique_ptr<VariableService> variableService;
     std::unique_ptr<TransactionService> transactionService;
     std::unique_ptr<Ocpp201::ResetService> resetServiceV201;
+    std::unique_ptr<Ocpp201::MeteringService> meteringServiceV201;
+    std::unique_ptr<RemoteControlService> remoteControlService;
 #endif
 
     Clock clock;
@@ -142,6 +148,9 @@ class Model : public MemoryManaged {
 #endif //MO_ENABLE_CERT_MGMT
 
 #if MO_ENABLE_V201
+    void setAvailabilityService(std::unique_ptr<AvailabilityService> as);
+    AvailabilityService *getAvailabilityService() const;
+
     void setVariableService(std::unique_ptr<VariableService> vs);
     VariableService *getVariableService() const;
 
@@ -150,6 +159,12 @@ class Model : public MemoryManaged {
 
     void setResetServiceV201(std::unique_ptr<Ocpp201::ResetService> rs);
     Ocpp201::ResetService *getResetServiceV201() const;
+
+    void setMeteringServiceV201(std::unique_ptr<Ocpp201::MeteringService> ms);
+    Ocpp201::MeteringService *getMeteringServiceV201() const;
+
+    void setRemoteControlService(std::unique_ptr<RemoteControlService> rs);
+    RemoteControlService *getRemoteControlService() const;
 #endif
 
     Clock &getClock();
diff --git a/src/MicroOcpp/Model/RemoteControl/RemoteControlDefs.h b/src/MicroOcpp/Model/RemoteControl/RemoteControlDefs.h
new file mode 100644
index 00000000..2edc83e3
--- /dev/null
+++ b/src/MicroOcpp/Model/RemoteControl/RemoteControlDefs.h
@@ -0,0 +1,34 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_UNLOCKCONNECTOR_H
+#define MO_UNLOCKCONNECTOR_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <stdint.h>
+
+#include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
+
+typedef enum {
+    RequestStartStopStatus_Accepted,
+    RequestStartStopStatus_Rejected
+}   RequestStartStopStatus;
+
+#if MO_ENABLE_CONNECTOR_LOCK
+
+typedef enum {
+    UnlockStatus_Unlocked,
+    UnlockStatus_UnlockFailed,
+    UnlockStatus_OngoingAuthorizedTransaction,
+    UnlockStatus_UnknownConnector,
+    UnlockStatus_PENDING // unlock action not finished yet, result still unknown (MO will check again later)
+}   UnlockStatus;
+
+#endif // MO_ENABLE_CONNECTOR_LOCK
+
+#endif // MO_ENABLE_V201
+#endif // MO_UNLOCKCONNECTOR_H
diff --git a/src/MicroOcpp/Model/RemoteControl/RemoteControlService.cpp b/src/MicroOcpp/Model/RemoteControl/RemoteControlService.cpp
new file mode 100644
index 00000000..7d49d2bc
--- /dev/null
+++ b/src/MicroOcpp/Model/RemoteControl/RemoteControlService.cpp
@@ -0,0 +1,162 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/RemoteControl/RemoteControlService.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Debug.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Operations/RequestStartTransaction.h>
+#include <MicroOcpp/Operations/RequestStopTransaction.h>
+#include <MicroOcpp/Operations/TriggerMessage.h>
+#include <MicroOcpp/Operations/UnlockConnector.h>
+
+using namespace MicroOcpp;
+
+RemoteControlServiceEvse::RemoteControlServiceEvse(Context& context, unsigned int evseId) : MemoryManaged("v201.RemoteControl.RemoteControlServiceEvse"), context(context), evseId(evseId) {
+
+}
+
+#if MO_ENABLE_CONNECTOR_LOCK
+void RemoteControlServiceEvse::setOnUnlockConnector(UnlockConnectorResult (*onUnlockConnector)(unsigned int evseId, void *userData), void *userData) {
+    this->onUnlockConnector = onUnlockConnector;
+    this->onUnlockConnectorUserData = userData;
+}
+
+UnlockStatus RemoteControlServiceEvse::unlockConnector() {
+
+    if (!onUnlockConnector) {
+        return UnlockStatus_UnlockFailed;
+    }
+
+    if (auto txService = context.getModel().getTransactionService()) {
+        if (auto evse = txService->getEvse(evseId)) {
+            if (auto tx = evse->getTransaction()) {
+                if (tx->started && !tx->stopped && tx->isAuthorized) {
+                    return UnlockStatus_OngoingAuthorizedTransaction;
+                } else {
+                    evse->abortTransaction(Ocpp201::Transaction::StopReason::Other,Ocpp201::TransactionEventTriggerReason::UnlockCommand);
+                }
+            }
+        }
+    }
+
+    auto status = onUnlockConnector(evseId, onUnlockConnectorUserData);
+    switch (status) {
+        case UnlockConnectorResult_Pending:
+            return UnlockStatus_PENDING;
+        case UnlockConnectorResult_Unlocked:
+            return UnlockStatus_Unlocked;
+        case UnlockConnectorResult_UnlockFailed:
+            return UnlockStatus_UnlockFailed;
+    }
+
+    MO_DBG_ERR("invalid onUnlockConnector result code");
+    return UnlockStatus_UnlockFailed;
+}
+#endif
+
+RemoteControlService::RemoteControlService(Context& context, size_t numEvses) : MemoryManaged("v201.RemoteControl.RemoteControlService"), context(context) {
+
+    for (size_t i = 0; i < numEvses && i < MO_NUM_EVSEID; i++) {
+        evses[i] = new RemoteControlServiceEvse(context, (unsigned int)i);
+    }
+
+    auto varService = context.getModel().getVariableService();
+    authorizeRemoteStart = varService->declareVariable<bool>("AuthCtrlr", "AuthorizeRemoteStart", false);
+
+    context.getOperationRegistry().registerOperation("RequestStartTransaction", [this] () -> Operation* {
+        if (!this->context.getModel().getTransactionService()) {
+            return nullptr; //-> NotSupported
+        }
+        return new Ocpp201::RequestStartTransaction(*this);});
+    context.getOperationRegistry().registerOperation("RequestStopTransaction", [this] () -> Operation* {
+        if (!this->context.getModel().getTransactionService()) {
+            return nullptr; //-> NotSupported
+        }
+        return new Ocpp201::RequestStopTransaction(*this);});
+#if MO_ENABLE_CONNECTOR_LOCK
+    context.getOperationRegistry().registerOperation("UnlockConnector", [this] () {
+        return new Ocpp201::UnlockConnector(*this);});
+#endif
+    context.getOperationRegistry().registerOperation("TriggerMessage", [&context] () {
+        return new Ocpp16::TriggerMessage(context);});
+}
+
+RemoteControlService::~RemoteControlService() {
+    for (size_t i = 0; i < MO_NUM_EVSEID && evses[i]; i++) {
+        delete evses[i];
+    }
+}
+
+RemoteControlServiceEvse *RemoteControlService::getEvse(unsigned int evseId) {
+    if (evseId >= MO_NUM_EVSEID) {
+        MO_DBG_ERR("invalid arg");
+        return nullptr;
+    }
+    return evses[evseId];
+}
+
+RequestStartStopStatus RemoteControlService::requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, std::shared_ptr<Ocpp201::Transaction>& transactionOut) {
+    
+    TransactionService *txService = context.getModel().getTransactionService();
+    if (!txService) {
+        MO_DBG_ERR("TxService uninitialized");
+        return RequestStartStopStatus_Rejected;
+    }
+    
+    auto evse = txService->getEvse(evseId);
+    if (!evse) {
+        MO_DBG_ERR("EVSE not found");
+        return RequestStartStopStatus_Rejected;
+    }
+
+    transactionOut = evse->getTransaction();
+
+    if (!evse->beginAuthorization(idToken, authorizeRemoteStart->getBool())) {
+        MO_DBG_INFO("EVSE still occupied with pending tx");
+        return RequestStartStopStatus_Rejected;
+    }
+
+    transactionOut = evse->getTransaction();
+    if (!transactionOut) {
+        MO_DBG_ERR("internal error");
+        return RequestStartStopStatus_Rejected;
+    }
+
+    transactionOut->remoteStartId = remoteStartId;
+    transactionOut->notifyRemoteStartId = true;
+
+    return RequestStartStopStatus_Accepted;
+}
+
+RequestStartStopStatus RemoteControlService::requestStopTransaction(const char *transactionId) {
+
+    TransactionService *txService = context.getModel().getTransactionService();
+    if (!txService) {
+        MO_DBG_ERR("TxService uninitialized");
+        return RequestStartStopStatus_Rejected;
+    }
+
+    bool success = false;
+
+    for (unsigned int evseId = 0; evseId < MO_NUM_EVSEID; evseId++) {
+        if (auto evse = txService->getEvse(evseId)) {
+            if (evse->getTransaction() && !strcmp(evse->getTransaction()->transactionId, transactionId)) {
+                success = evse->abortTransaction(Ocpp201::Transaction::StopReason::Remote, Ocpp201::TransactionEventTriggerReason::RemoteStop);
+                break;
+            }
+        }
+    }
+
+    return success ?
+            RequestStartStopStatus_Accepted :
+            RequestStartStopStatus_Rejected;
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/RemoteControl/RemoteControlService.h b/src/MicroOcpp/Model/RemoteControl/RemoteControlService.h
new file mode 100644
index 00000000..a19adcc7
--- /dev/null
+++ b/src/MicroOcpp/Model/RemoteControl/RemoteControlService.h
@@ -0,0 +1,65 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_REMOTECONTROLSERVICE_H
+#define MO_REMOTECONTROLSERVICE_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/RemoteControl/RemoteControlDefs.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+#include <MicroOcpp/Core/Memory.h>
+
+namespace MicroOcpp {
+
+class Context;
+class Variable;
+
+class RemoteControlServiceEvse : public MemoryManaged {
+private:
+    Context& context;
+    const unsigned int evseId;
+
+#if MO_ENABLE_CONNECTOR_LOCK
+    UnlockConnectorResult (*onUnlockConnector)(unsigned int evseId, void *user) = nullptr;
+    void *onUnlockConnectorUserData = nullptr;
+#endif
+
+public:
+    RemoteControlServiceEvse(Context& context, unsigned int evseId);
+
+#if MO_ENABLE_CONNECTOR_LOCK
+    void setOnUnlockConnector(UnlockConnectorResult (*onUnlockConnector)(unsigned int evseId, void *userData), void *userData);
+
+    UnlockStatus unlockConnector();
+#endif
+
+};
+
+class RemoteControlService : public MemoryManaged {
+private:
+    Context& context;
+    RemoteControlServiceEvse* evses [MO_NUM_EVSEID] = {nullptr};
+
+    Variable *authorizeRemoteStart = nullptr;
+
+public:
+    RemoteControlService(Context& context, size_t numEvses);
+    ~RemoteControlService();
+
+    RemoteControlServiceEvse *getEvse(unsigned int evseId);
+
+    RequestStartStopStatus requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, std::shared_ptr<Ocpp201::Transaction>& transactionOut); //ChargingProfile, GroupIdToken not supported yet
+
+    RequestStartStopStatus requestStopTransaction(const char *transactionId);
+};
+
+} // namespace MicroOcpp
+
+#endif // MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index ebe7ca07..e20c8b30 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -125,14 +125,14 @@ ResetService::~ResetService() {
 
 ResetService::Evse::Evse(Context& context, ResetService& resetService, unsigned int evseId) : context(context), resetService(resetService), evseId(evseId) {
     auto varService = context.getModel().getVariableService();
-    varService->declareVariable<bool>(ComponentId("EVSE", evseId), "AllowReset", true, MO_VARIABLE_FN, Variable::Mutability::ReadOnly);
+    varService->declareVariable<bool>(ComponentId("EVSE", evseId >= 1 ? evseId : -1), "AllowReset", true, MO_VARIABLE_FN, Variable::Mutability::ReadOnly);
 }
 
 void ResetService::Evse::loop() {
 
     if (outstandingResetRetries && awaitTxStop) {
 
-        for (unsigned int eId = std::max(1U, evseId); eId < (evseId == 0 ? MO_NUM_EVSE : evseId + 1); eId++) {
+        for (unsigned int eId = std::max(1U, evseId); eId < (evseId == 0 ? MO_NUM_EVSEID : evseId + 1); eId++) {
             //If evseId > 0, execute this block one time for evseId. If evseId == 0, then iterate over all evseIds > 0
 
             auto txService = context.getModel().getTransactionService();
@@ -202,7 +202,7 @@ ResetService::Evse *ResetService::getOrCreateEvse(unsigned int evseId) {
         return evse;
     }
 
-    if (evseId >= MO_NUM_EVSE) {
+    if (evseId >= MO_NUM_EVSEID) {
         MO_DBG_ERR("evseId out of bound");
         return nullptr;
     }
@@ -266,7 +266,7 @@ ResetStatus ResetService::initiateReset(ResetType type, unsigned int evseId) {
     }
 
     //Check if EVSEs are ready for Reset
-    for (unsigned int eId = evseId; eId < (evseId == 0 ? MO_NUM_EVSE : evseId + 1); eId++) {
+    for (unsigned int eId = evseId; eId < (evseId == 0 ? MO_NUM_EVSEID : evseId + 1); eId++) {
         //If evseId > 0, execute this block one time for evseId. If evseId == 0, then iterate over all evseIds
 
         if (auto it = getEvse(eId)) {
@@ -294,7 +294,7 @@ ResetStatus ResetService::initiateReset(ResetType type, unsigned int evseId) {
     bool scheduled = false;
 
     //Tx-related behavior: if immediate Reset, stop txs; otherwise schedule Reset
-    for (unsigned int eId = std::max(1U, evseId); eId < (evseId == 0 ? MO_NUM_EVSE : evseId + 1); eId++) {
+    for (unsigned int eId = std::max(1U, evseId); eId < (evseId == 0 ? MO_NUM_EVSEID : evseId + 1); eId++) {
         //If evseId > 0, execute this block one time for evseId. If evseId == 0, then iterate over all evseIds > 0
 
         auto txService = context.getModel().getTransactionService();
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index 0e7dfd90..bf8a058c 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -189,10 +189,16 @@ class Transaction : public MemoryManaged {
 #if MO_ENABLE_V201
 
 #include <memory>
+#include <limits>
 
 #include <MicroOcpp/Model/Transactions/TransactionDefs.h>
 #include <MicroOcpp/Model/Authorization/IdToken.h>
 #include <MicroOcpp/Model/ConnectorBase/EvseId.h>
+#include <MicroOcpp/Model/Metering/MeterValuesV201.h>
+
+#ifndef MO_SAMPLEDDATATXENDED_SIZE_MAX
+#define MO_SAMPLEDDATATXENDED_SIZE_MAX 5
+#endif
 
 namespace MicroOcpp {
 namespace Ocpp201 {
@@ -255,11 +261,11 @@ class Transaction : public MemoryManaged {
      * Transaction substates. Notify server about any change when transaction is running
      */
     //bool trackParkingBayOccupancy; // not supported
-    bool trackEvConnected;
-    bool trackAuthorized;
-    bool trackDataSigned;
-    bool trackPowerPathClosed;
-    bool trackEnergyTransfer;
+    bool trackEvConnected = false;
+    bool trackAuthorized = false;
+    bool trackDataSigned = false;
+    bool trackPowerPathClosed = false;
+    bool trackEnergyTransfer = false;
 
     /*
      * Transaction lifecycle
@@ -272,6 +278,7 @@ class Transaction : public MemoryManaged {
     /*
      * Global transaction data
      */
+    bool isAuthorizationActive = false; //period between beginAuthorization and endAuthorization
     bool isAuthorized = false;    //if the given idToken was authorized
     bool isDeauthorized = false;  //if the server revoked a local authorization
     unsigned int seqNoCounter = 0; // increment by 1 for each event
@@ -294,7 +301,46 @@ class Transaction : public MemoryManaged {
     TransactionEventTriggerReason stopTrigger = TransactionEventTriggerReason::UNDEFINED;
     std::unique_ptr<IdToken> stopIdToken; // if null, then stopIdToken equals idToken
 
-    Transaction() : MemoryManaged("v201.Transactions.Transaction") { }
+    /*
+     * Tx-related metering
+     */
+
+    Vector<std::unique_ptr<Ocpp201::MeterValue>> sampledDataTxEnded;
+
+    unsigned long lastSampleTimeTxUpdated = 0; //0 means not charging right now
+    unsigned long lastSampleTimeTxEnded = 0;
+
+    /*
+     * Attributes for internal store
+     */
+    unsigned int evseId = 0;
+    unsigned int txNr = 0; //internal key attribute (!= transactionId); {evseId*txNr} is unique key
+
+    bool silent = false; //silent Tx: process tx locally, without reporting to the server
+
+    Transaction() : MemoryManaged("v201.Transactions.Transaction"), sampledDataTxEnded(makeVector<std::unique_ptr<Ocpp201::MeterValue>>(getMemoryTag())) { }
+
+    void addSampledDataTxEnded(std::unique_ptr<Ocpp201::MeterValue> mv) {
+        if (sampledDataTxEnded.size() >= MO_SAMPLEDDATATXENDED_SIZE_MAX) {
+            int deltaMin = std::numeric_limits<int>::max();
+            size_t indexMin = sampledDataTxEnded.size();
+            for (size_t i = 1; i + 1 <= sampledDataTxEnded.size(); i++) {
+                size_t t0 = sampledDataTxEnded.size() - i - 1;
+                size_t t1 = sampledDataTxEnded.size() - i;
+
+                auto delta = sampledDataTxEnded[t1]->getTimestamp() - sampledDataTxEnded[t0]->getTimestamp();
+
+                if (delta < deltaMin) {
+                    deltaMin = delta;
+                    indexMin = t1;
+                }
+            }
+
+            sampledDataTxEnded.erase(sampledDataTxEnded.begin() + indexMin);
+        }
+
+        sampledDataTxEnded.push_back(std::move(mv));
+    }
 };
 
 // TransactionEventRequest (1.60.1)
@@ -336,8 +382,9 @@ class TransactionEventData : public MemoryManaged {
     std::unique_ptr<IdToken> idToken;
     EvseId evse = -1;
     //meterValue not supported
+    Vector<std::unique_ptr<MeterValue>> meterValue;
 
-    TransactionEventData(std::shared_ptr<Transaction> transaction, unsigned int seqNo) : MemoryManaged("v201.Transactions.TransactionEventData"), transaction(transaction), seqNo(seqNo) { }
+    TransactionEventData(std::shared_ptr<Transaction> transaction, unsigned int seqNo) : MemoryManaged("v201.Transactions.TransactionEventData"), transaction(transaction), seqNo(seqNo), meterValue(makeVector<std::unique_ptr<MeterValue>>(getMemoryTag())) { }
 };
 
 } // namespace Ocpp201
diff --git a/src/MicroOcpp/Model/Transactions/TransactionDefs.h b/src/MicroOcpp/Model/Transactions/TransactionDefs.h
index 1a871b4b..62ef657a 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionDefs.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionDefs.h
@@ -11,10 +11,5 @@
 
 #define MO_TXID_LEN_MAX 36
 
-typedef enum RequestStartStopStatus {
-    RequestStartStopStatus_Accepted,
-    RequestStartStopStatus_Rejected
-}   RequestStartStopStatus;
-
 #endif //MO_ENABLE_V201
 #endif
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index c36126ac..7f74e7be 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -24,7 +24,10 @@ using namespace MicroOcpp;
 using namespace MicroOcpp::Ocpp201;
 
 TransactionService::Evse::Evse(Context& context, TransactionService& txService, unsigned int evseId) :
-        MemoryManaged("v201.Transactions.TransactionServiceEvse"), context(context), txService(txService), evseId(evseId) {
+        MemoryManaged("v201.Transactions.TransactionServiceEvse"),
+        context(context),
+        txService(txService),
+        evseId(evseId) {
 
 }
 
@@ -35,6 +38,9 @@ std::unique_ptr<Ocpp201::Transaction> TransactionService::Evse::allocateTransact
         return nullptr;
     }
 
+    tx->evseId = evseId;
+    tx->txNr = txNrCounter;
+
     //simple clock-based hash
     int v = context.getModel().getClock().now() - Timestamp(2020,0,0,0,0,0);
     unsigned int h = v;
@@ -49,6 +55,8 @@ std::unique_ptr<Ocpp201::Transaction> TransactionService::Evse::allocateTransact
 
     tx->beginTimestamp = context.getModel().getClock().now();
 
+    MO_DBG_DEBUG("allocated tx %u-%s", evseId, tx->transactionId);
+
     return tx;
 }
 
@@ -84,6 +92,18 @@ void TransactionService::Evse::loop() {
                 transaction->stopTrigger = TransactionEventTriggerReason::EVConnectTimeout;
                 transaction->stopReason = Ocpp201::Transaction::StopReason::Timeout;
             }
+
+            if (transaction->active &&
+                    transaction->isDeauthorized &&
+                    !transaction->started &&
+                    (txService.isTxStartPoint(TxStartStopPoint::Authorized) || txService.isTxStartPoint(TxStartStopPoint::PowerPathClosed) ||
+                     txService.isTxStopPoint(TxStartStopPoint::Authorized)  || txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed))) {
+                
+                MO_DBG_INFO("Session mngt: Deauthorized before start");
+                transaction->active = false;
+                transaction->stopTrigger = TransactionEventTriggerReason::Deauthorized;
+                transaction->stopReason = Ocpp201::Transaction::StopReason::DeAuthorized;
+            }
         }
     }
 
@@ -112,7 +132,7 @@ void TransactionService::Evse::loop() {
             stopReason = Ocpp201::Transaction::StopReason::EVDisconnected;
         } else if ((txService.isTxStopPoint(TxStartStopPoint::Authorized) ||
                     txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed)) &&
-                    (!transaction || !transaction->isAuthorized)) {
+                    (!transaction || !transaction->isAuthorizationActive)) {
             // user revoked authorization (or EV or any "local" entity)
             txStopCondition = true;
             triggerReason = TransactionEventTriggerReason::StopAuthorized;
@@ -152,7 +172,7 @@ void TransactionService::Evse::loop() {
                 (!stopTxReadyInput || stopTxReadyInput())) {
             // yes, stop running tx
 
-            txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
+            txEvent = std::allocate_shared<TransactionEventData>(makeAllocator<TransactionEventData>(getMemoryTag()), transaction, transaction->seqNoCounter++);
             if (!txEvent) {
                 // OOM
                 return;
@@ -176,15 +196,15 @@ void TransactionService::Evse::loop() {
         // tx should be started?
         if (txService.isTxStartPoint(TxStartStopPoint::PowerPathClosed) &&
                     (!connectorPluggedInput || connectorPluggedInput()) &&
-                    transaction && transaction->isAuthorized) {
+                    transaction && transaction->isAuthorizationActive && transaction->isAuthorized) {
             txStartCondition = true;
             if (transaction->remoteStartId >= 0) {
                 triggerReason = TransactionEventTriggerReason::RemoteStart;
             } else {
-                triggerReason = TransactionEventTriggerReason::Authorized;
+                triggerReason = TransactionEventTriggerReason::CablePluggedIn;
             }
         } else if (txService.isTxStartPoint(TxStartStopPoint::Authorized) &&
-                    transaction && transaction->isAuthorized) {
+                    transaction && transaction->isAuthorizationActive && transaction->isAuthorized) {
             txStartCondition = true;
             if (transaction->remoteStartId >= 0) {
                 triggerReason = TransactionEventTriggerReason::RemoteStart;
@@ -219,7 +239,7 @@ void TransactionService::Evse::loop() {
                 }
             }
 
-            txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
+            txEvent = std::allocate_shared<TransactionEventData>(makeAllocator<TransactionEventData>(getMemoryTag()), transaction, transaction->seqNoCounter++);
             if (!txEvent) {
                 // OOM
                 return;
@@ -233,7 +253,7 @@ void TransactionService::Evse::loop() {
     TransactionEventData::ChargingState chargingState = TransactionEventData::ChargingState::Idle;
     if (connectorPluggedInput && !connectorPluggedInput()) {
         chargingState = TransactionEventData::ChargingState::Idle;
-    } else if (!transaction || !transaction->isAuthorized) {
+    } else if (!transaction || !transaction->isAuthorizationActive || !transaction->isAuthorized) {
         chargingState = TransactionEventData::ChargingState::EVConnected;
     } else if (evseReadyInput && !evseReadyInput()) { 
         chargingState = TransactionEventData::ChargingState::SuspendedEVSE;
@@ -243,6 +263,31 @@ void TransactionService::Evse::loop() {
         chargingState = TransactionEventData::ChargingState::Charging;
     }
 
+    //General Metering behavior. There is another section for TxStarted, Updated and TxEnded MeterValues
+    std::unique_ptr<MicroOcpp::Ocpp201::MeterValue> mvTxUpdated;
+
+    if (transaction) {
+
+        if (txService.sampledDataTxUpdatedInterval && txService.sampledDataTxUpdatedInterval->getInt() > 0 && mocpp_tick_ms() - transaction->lastSampleTimeTxUpdated >= (unsigned long)txService.sampledDataTxUpdatedInterval->getInt() * 1000UL) {
+            transaction->lastSampleTimeTxUpdated = mocpp_tick_ms();
+            auto meteringService = context.getModel().getMeteringServiceV201();
+            auto meteringEvse = meteringService ? meteringService->getEvse(evseId) : nullptr;
+            mvTxUpdated = meteringEvse ? meteringEvse->takeTxUpdatedMeterValue() : nullptr;
+        }
+
+        if (transaction->started && !transaction->stopped &&
+                 txService.sampledDataTxEndedInterval && txService.sampledDataTxEndedInterval->getInt() > 0 &&
+                 mocpp_tick_ms() - transaction->lastSampleTimeTxEnded >= (unsigned long)txService.sampledDataTxEndedInterval->getInt() * 1000UL) {
+            transaction->lastSampleTimeTxEnded = mocpp_tick_ms();
+            auto meteringService = context.getModel().getMeteringServiceV201();
+            auto meteringEvse = meteringService ? meteringService->getEvse(evseId) : nullptr;
+            auto mvTxEnded = meteringEvse ? meteringEvse->takeTxEndedMeterValue(ReadingContext_SamplePeriodic) : nullptr;
+            if (mvTxEnded) {
+                transaction->addSampledDataTxEnded(std::move(mvTxEnded));
+            }
+        }
+    }
+
     if (transaction) {
         // update tx?
 
@@ -257,7 +302,7 @@ void TransactionService::Evse::loop() {
         }
         trackChargingState = chargingState;
 
-        if (transaction->isAuthorized && !transaction->trackAuthorized) {
+        if ((transaction->isAuthorizationActive && transaction->isAuthorized) && !transaction->trackAuthorized) {
             transaction->trackAuthorized = true;
             txUpdateCondition = true;
             if (transaction->remoteStartId >= 0) {
@@ -273,10 +318,13 @@ void TransactionService::Evse::loop() {
             transaction->trackEvConnected = false;
             txUpdateCondition = true;
             triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
-        } else if (!transaction->isAuthorized && transaction->trackAuthorized) {
+        } else if (!(transaction->isAuthorizationActive && transaction->isAuthorized) && transaction->trackAuthorized) {
             transaction->trackAuthorized = false;
             txUpdateCondition = true;
             triggerReason = TransactionEventTriggerReason::StopAuthorized;
+        } else if (mvTxUpdated) {
+            txUpdateCondition = true;
+            triggerReason = TransactionEventTriggerReason::MeterValuePeriodic;
         } else if (evReadyInput && evReadyInput() && !transaction->trackPowerPathClosed) {
             transaction->trackPowerPathClosed = true;
         } else if (evReadyInput && !evReadyInput() && transaction->trackPowerPathClosed) {
@@ -286,7 +334,7 @@ void TransactionService::Evse::loop() {
         if (txUpdateCondition && !txEvent && transaction->started && !transaction->stopped) {
             // yes, updated
 
-            txEvent = std::make_shared<TransactionEventData>(transaction, transaction->seqNoCounter++);
+            txEvent = std::allocate_shared<TransactionEventData>(makeAllocator<TransactionEventData>(getMemoryTag()), transaction, transaction->seqNoCounter++);
             if (!txEvent) {
                 // OOM
                 return;
@@ -311,7 +359,31 @@ void TransactionService::Evse::loop() {
             txEvent->remoteStartId = transaction->remoteStartId;
             transaction->notifyRemoteStartId = false;
         }
-        // meterValue not supported
+        if (txEvent->eventType == TransactionEventData::Type::Started) {
+            auto meteringService = context.getModel().getMeteringServiceV201();
+            auto meteringEvse = meteringService ? meteringService->getEvse(evseId) : nullptr;
+            auto mvTxStarted = meteringEvse ? meteringEvse->takeTxStartedMeterValue() : nullptr;
+            if (mvTxStarted) {
+                txEvent->meterValue.push_back(std::move(mvTxStarted));
+            }
+            auto mvTxEnded = meteringEvse ? meteringEvse->takeTxEndedMeterValue(ReadingContext_TransactionBegin) : nullptr;
+            if (mvTxEnded) {
+                transaction->addSampledDataTxEnded(std::move(mvTxEnded));
+            }
+            transaction->lastSampleTimeTxEnded = mocpp_tick_ms();
+            transaction->lastSampleTimeTxUpdated = mocpp_tick_ms();
+        } else if (txEvent->eventType == TransactionEventData::Type::Ended) {
+            auto meteringService = context.getModel().getMeteringServiceV201();
+            auto meteringEvse = meteringService ? meteringService->getEvse(evseId) : nullptr;
+            auto mvTxEnded = meteringEvse ? meteringEvse->takeTxEndedMeterValue(ReadingContext_TransactionEnd) : nullptr;
+            if (mvTxEnded) {
+                transaction->addSampledDataTxEnded(std::move(mvTxEnded));
+            }
+            transaction->lastSampleTimeTxEnded = mocpp_tick_ms();
+        }
+        if (mvTxUpdated) {
+            txEvent->meterValue.push_back(std::move(mvTxUpdated));
+        }
 
         if (transaction->notifyStopIdToken && transaction->stopIdToken) {
             txEvent->idToken = std::unique_ptr<IdToken>(new IdToken(*transaction->stopIdToken.get(), getMemoryTag()));
@@ -350,7 +422,7 @@ void TransactionService::Evse::setEvseReadyInput(std::function<bool()> connector
 bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validateIdToken) {
     MO_DBG_DEBUG("begin auth: %s", idToken.get());
 
-    if (transaction && (transaction->idToken.get() || !transaction->active)) {
+    if (transaction && transaction->isAuthorizationActive) {
         MO_DBG_WARN("tx process still running. Please call endTransaction(...) before");
         return false;
     }
@@ -366,6 +438,7 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
         }
     }
 
+    transaction->isAuthorizationActive = true;
     transaction->idToken = idToken;
     transaction->beginTimestamp = context.getModel().getClock().now();
 
@@ -375,6 +448,7 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
         auto authorize = makeRequest(new Authorize(context.getModel(), idToken));
         if (!authorize) {
             // OOM
+            abortTransaction();
             return false;
         }
 
@@ -389,6 +463,10 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
             tx->isAuthorized = true;
             tx->notifyIdToken = true;
         });
+        authorize->setOnAbortListener([this, tx] () {
+            MO_DBG_DEBUG("Authorize timeout (%s)", tx->idToken.get());
+            tx->isDeauthorized = true;
+        });
         authorize->setTimeout(20 * 1000);
         context.initiateRequest(std::move(authorize));
     } else {
@@ -401,7 +479,7 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
 }
 bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateIdToken) {
 
-    if (!transaction || !transaction->active) {
+    if (!transaction || !transaction->isAuthorizationActive) {
         //transaction already ended / not active anymore
         return false;
     }
@@ -411,11 +489,11 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
     
     if (transaction->idToken.equals(idToken)) {
         // use same idToken like tx start
-        transaction->isAuthorized = false;
+        transaction->isAuthorizationActive = false;
         transaction->notifyIdToken = true;
     } else if (!validateIdToken) {
         transaction->stopIdToken = std::unique_ptr<IdToken>(new IdToken(idToken, getMemoryTag()));
-        transaction->isAuthorized = false;
+        transaction->isAuthorizationActive = false;
         transaction->notifyStopIdToken = true;
     } else {
         // use a different idToken for stopping the tx
@@ -448,7 +526,7 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
                 return;
             }
 
-            tx->isAuthorized = false;
+            tx->isAuthorizationActive = false;
             tx->notifyStopIdToken = true;
         });
         authorize->setTimeout(20 * 1000);
@@ -480,6 +558,7 @@ std::shared_ptr<MicroOcpp::Ocpp201::Transaction>& TransactionService::Evse::getT
 bool TransactionService::Evse::ocppPermitsCharge() {
     return transaction &&
            transaction->active &&
+           transaction->isAuthorizationActive &&
            transaction->isAuthorized &&
            !transaction->isDeauthorized;
 }
@@ -547,30 +626,44 @@ bool TransactionService::parseTxStartStopPoint(const char *csl, Vector<TxStartSt
     return true;
 }
 
-TransactionService::TransactionService(Context& context) : MemoryManaged("v201.Transactions.TransactionService"), context(context), evses(makeVector<Evse>(getMemoryTag())), txStartPointParsed(makeVector<TxStartStopPoint>(getMemoryTag())),  txStopPointParsed(makeVector<TxStartStopPoint>(getMemoryTag())) {
-    auto variableService = context.getModel().getVariableService();
-
-    txStartPointString = variableService->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "PowerPathClosed");
-    txStopPointString  = variableService->declareVariable<const char*>("TxCtrlr", "TxStopPoint",  "PowerPathClosed");
-    stopTxOnInvalidIdBool = variableService->declareVariable<bool>("TxCtrlr", "StopTxOnInvalidId", true);
-    stopTxOnEVSideDisconnectBool = variableService->declareVariable<bool>("TxCtrlr", "StopTxOnEVSideDisconnect", true);
-    evConnectionTimeOutInt = variableService->declareVariable<int>("TxCtrlr", "EVConnectionTimeOut", 30);
-
-    variableService->declareVariable<bool>("AuthCtrlr", "AuthorizeRemoteStart", false, MO_VARIABLE_VOLATILE, Variable::Mutability::ReadOnly);
-
-    variableService->registerValidator<const char*>("TxCtrlr", "TxStartPoint", [this] (const char *value) -> bool {
+TransactionService::TransactionService(Context& context) :
+        MemoryManaged("v201.Transactions.TransactionService"),
+        context(context),
+        evses(makeVector<Evse>(getMemoryTag())),
+        txStartPointParsed(makeVector<TxStartStopPoint>(getMemoryTag())),
+        txStopPointParsed(makeVector<TxStartStopPoint>(getMemoryTag())) {
+    auto varService = context.getModel().getVariableService();
+
+    txStartPointString = varService->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "PowerPathClosed");
+    txStopPointString  = varService->declareVariable<const char*>("TxCtrlr", "TxStopPoint",  "PowerPathClosed");
+    stopTxOnInvalidIdBool = varService->declareVariable<bool>("TxCtrlr", "StopTxOnInvalidId", true);
+    stopTxOnEVSideDisconnectBool = varService->declareVariable<bool>("TxCtrlr", "StopTxOnEVSideDisconnect", true);
+    evConnectionTimeOutInt = varService->declareVariable<int>("TxCtrlr", "EVConnectionTimeOut", 30);
+    sampledDataTxUpdatedInterval = varService->declareVariable<int>("SampledDataCtrlr", "TxUpdatedInterval", 0);
+    sampledDataTxEndedInterval = varService->declareVariable<int>("SampledDataCtrlr", "TxEndedInterval", 0);
+
+    varService->declareVariable<bool>("AuthCtrlr", "AuthorizeRemoteStart", false, MO_VARIABLE_VOLATILE, Variable::Mutability::ReadOnly);
+
+    varService->registerValidator<const char*>("TxCtrlr", "TxStartPoint", [this] (const char *value) -> bool {
         auto validated = makeVector<TxStartStopPoint>(getMemoryTag());
         return this->parseTxStartStopPoint(value, validated);
     });
 
-    variableService->registerValidator<const char*>("TxCtrlr", "TxStopPoint", [this] (const char *value) -> bool {
+    varService->registerValidator<const char*>("TxCtrlr", "TxStopPoint", [this] (const char *value) -> bool {
         auto validated = makeVector<TxStartStopPoint>(getMemoryTag());
         return this->parseTxStartStopPoint(value, validated);
     });
 
-    evses.reserve(MO_NUM_EVSE);
+    std::function<bool(int)> validateUnsignedInt = [] (int val) {
+        return val >= 0;
+    };
+
+    varService->registerValidator<int>("SampledDataCtrlr", "TxUpdatedInterval", validateUnsignedInt);
+    varService->registerValidator<int>("SampledDataCtrlr", "TxEndedInterval", validateUnsignedInt);
 
-    for (unsigned int evseId = 0; evseId < MO_NUM_EVSE; evseId++) {
+    evses.reserve(MO_NUM_EVSEID);
+
+    for (unsigned int evseId = 0; evseId < MO_NUM_EVSEID; evseId++) {
         evses.emplace_back(context, *this, evseId);
     }
 
@@ -578,11 +671,6 @@ TransactionService::TransactionService(Context& context) : MemoryManaged("v201.T
     evses[0].connectorPluggedInput = [] () {return false;};
     evses[0].evReadyInput = [] () {return false;};
     evses[0].evseReadyInput = [] () {return false;};
-
-    context.getOperationRegistry().registerOperation("RequestStartTransaction", [this] () {
-        return new RequestStartTransaction(*this);});
-    context.getOperationRegistry().registerOperation("RequestStopTransaction", [this] () {
-        return new RequestStopTransaction(*this);});
 }
 
 void TransactionService::loop() {
@@ -602,7 +690,7 @@ void TransactionService::loop() {
     if (auto& tx0 = evses[0].getTransaction()) {
         //pending tx on evseId 0
         if (tx0->active) {
-            for (unsigned int evseId = 1; evseId < MO_NUM_EVSE; evseId++) {
+            for (unsigned int evseId = 1; evseId < MO_NUM_EVSEID; evseId++) {
                 if (!evses[evseId].getTransaction() && 
                         (!evses[evseId].connectorPluggedInput || evses[evseId].connectorPluggedInput())) {
                     MO_DBG_INFO("assign tx to evse %u", evseId);
@@ -623,51 +711,4 @@ TransactionService::Evse *TransactionService::getEvse(unsigned int evseId) {
     }
 }
 
-RequestStartStopStatus TransactionService::requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, char *transactionIdOut) {
-    auto evse = getEvse(evseId);
-    if (!evse) {
-        return RequestStartStopStatus_Rejected;
-    }
-
-    auto tx = evse->getTransaction();
-    if (tx) {
-        auto ret = snprintf(transactionIdOut, MO_TXID_LEN_MAX + 1, "%s", tx->transactionId);
-        if (ret < 0 || ret >= MO_TXID_LEN_MAX + 1) {
-            MO_DBG_ERR("internal error");
-            return RequestStartStopStatus_Rejected;
-        }
-    }
-
-    if (!evse->beginAuthorization(idToken, false)) {
-        MO_DBG_INFO("EVSE still occupied with pending tx");
-        return RequestStartStopStatus_Rejected;
-    }
-
-    tx = evse->getTransaction();
-    if (!tx) {
-        MO_DBG_ERR("internal error");
-        return RequestStartStopStatus_Rejected;
-    }
-
-    tx->remoteStartId = remoteStartId;
-    tx->notifyRemoteStartId = true;
-
-    return RequestStartStopStatus_Accepted;
-}
-
-RequestStartStopStatus TransactionService::requestStopTransaction(const char *transactionId) {
-    bool success = false;
-
-    for (Evse& evse : evses) {
-        if (evse.getTransaction() && !strcmp(evse.getTransaction()->transactionId, transactionId)) {
-            success = evse.abortTransaction(Ocpp201::Transaction::StopReason::Remote, TransactionEventTriggerReason::RemoteStop);
-            break;
-        }
-    }
-
-    return success ?
-            RequestStartStopStatus_Accepted :
-            RequestStartStopStatus_Rejected;
-}
-
 #endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.h b/src/MicroOcpp/Model/Transactions/TransactionService.h
index 4b985b24..ca9704b7 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.h
@@ -14,7 +14,7 @@
 #if MO_ENABLE_V201
 
 #include <MicroOcpp/Model/Transactions/Transaction.h>
-#include <MicroOcpp/Model/Transactions/TransactionDefs.h>
+#include <MicroOcpp/Model/Metering/MeterValuesV201.h>
 #include <MicroOcpp/Core/Memory.h>
 
 #include <memory>
@@ -33,6 +33,7 @@ class TransactionService : public MemoryManaged {
         Context& context;
         TransactionService& txService;
         const unsigned int evseId;
+        unsigned int txNrCounter = 0;
         std::shared_ptr<Ocpp201::Transaction> transaction;
         Ocpp201::TransactionEventData::ChargingState trackChargingState = Ocpp201::TransactionEventData::ChargingState::UNDEFINED;
 
@@ -44,6 +45,7 @@ class TransactionService : public MemoryManaged {
         std::function<bool()> stopTxReadyInput;
 
         std::unique_ptr<Ocpp201::Transaction> allocateTransaction();
+
     public:
         Evse(Context& context, TransactionService& txService, unsigned int evseId);
 
@@ -86,6 +88,8 @@ class TransactionService : public MemoryManaged {
     Variable *stopTxOnInvalidIdBool = nullptr;
     Variable *stopTxOnEVSideDisconnectBool = nullptr;
     Variable *evConnectionTimeOutInt = nullptr;
+    Variable *sampledDataTxUpdatedInterval = nullptr;
+    Variable *sampledDataTxEndedInterval = nullptr;
     uint16_t trackTxStartPoint = -1;
     uint16_t trackTxStopPoint = -1;
     Vector<TxStartStopPoint> txStartPointParsed;
@@ -101,10 +105,6 @@ class TransactionService : public MemoryManaged {
     void loop();
 
     Evse *getEvse(unsigned int evseId);
-
-    RequestStartStopStatus requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, char *transactionIdOut); //ChargingProfile, GroupIdToken not supported yet
-
-    RequestStartStopStatus requestStopTransaction(const char *transactionId);
 };
 
 } // namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
index 97c62d4b..01ea4111 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
@@ -76,7 +76,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
         return nullptr;
     }
 
-    auto transaction = std::make_shared<Transaction>(*this, connectorId, txNr);
+    auto transaction = std::allocate_shared<Transaction>(makeAllocator<Transaction>(getMemoryTag()), *this, connectorId, txNr);
     JsonObject txJson = doc->as<JsonObject>();
     if (!deserializeTransaction(*transaction, txJson)) {
         MO_DBG_ERR("deserialization error");
@@ -100,7 +100,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
 
 std::shared_ptr<Transaction> ConnectorTransactionStore::createTransaction(unsigned int txNr, bool silent) {
 
-    auto transaction = std::make_shared<Transaction>(*this, connectorId, txNr, silent);
+    auto transaction = std::allocate_shared<Transaction>(makeAllocator<Transaction>(getMemoryTag()), *this, connectorId, txNr, silent);
 
     if (!commit(transaction.get())) {
         MO_DBG_ERR("FS error");
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.cpp b/src/MicroOcpp/Operations/ChangeAvailability.cpp
index b0bd2da3..7377657c 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.cpp
+++ b/src/MicroOcpp/Operations/ChangeAvailability.cpp
@@ -9,8 +9,8 @@
 
 #include <functional>
 
-using MicroOcpp::Ocpp16::ChangeAvailability;
-using MicroOcpp::JsonDoc;
+namespace MicroOcpp {
+namespace Ocpp16 {
 
 ChangeAvailability::ChangeAvailability(Model& model) : MemoryManaged("v16.Operation.", "ChangeAvailability"), model(model) {
 
@@ -21,40 +21,19 @@ const char* ChangeAvailability::getOperationType(){
 }
 
 void ChangeAvailability::processReq(JsonObject payload) {
-
-    unsigned int connectorId = 0;
-    const char *type = "_Undefined";
-
-    #if MO_ENABLE_V201
-    if (model.getVersion().major == 2) {
-        //OCPP 2.0.1
-        int connectorIdRaw = payload["evse"]["id"] | 0;
-        if (connectorIdRaw < 0) {
-            errorCode = "FormationViolation";
-            return;
-        }
-
-        connectorId = (unsigned int)connectorIdRaw;
-        type = payload["operationalStatus"] | type;
-    } else
-    #endif //MO_ENABLE_V201
-    {
-        //OCPP 1.6
-        int connectorIdRaw = payload["connectorId"] | -1;
-        if (connectorIdRaw < 0) {
-            errorCode = "FormationViolation";
-            return;
-        }
-
-        connectorId = (unsigned int)connectorIdRaw;
-        type = payload["type"] | type;
+    int connectorIdRaw = payload["connectorId"] | -1;
+    if (connectorIdRaw < 0) {
+        errorCode = "FormationViolation";
+        return;
     }
+    unsigned int connectorId = (unsigned int)connectorIdRaw;
 
     if (connectorId >= model.getNumConnectors()) {
         errorCode = "PropertyConstraintViolation";
         return;
     }
 
+    const char *type = payload["type"] | "INVALID";
     bool available = false;
 
     if (!strcmp(type, "Operative")) {
@@ -98,3 +77,85 @@ std::unique_ptr<JsonDoc> ChangeAvailability::createConf(){
         
     return doc;
 }
+
+} // namespace Ocpp16
+} // namespace MicroOcpp
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Availability/AvailabilityService.h>
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+ChangeAvailability::ChangeAvailability(AvailabilityService& availabilityService) : MemoryManaged("v201.Operation.", "ChangeAvailability"), availabilityService(availabilityService) {
+
+}
+
+const char* ChangeAvailability::getOperationType(){
+    return "ChangeAvailability";
+}
+
+void ChangeAvailability::processReq(JsonObject payload) {
+
+    unsigned int evseId = 0;
+    
+    if (payload.containsKey("evse")) {
+        int evseIdRaw = payload["evse"]["id"] | -1;
+        if (evseIdRaw < 0) {
+            errorCode = "FormationViolation";
+            return;
+        }
+        evseId = (unsigned int)evseIdRaw;
+
+        if ((payload["evse"]["connectorId"] | 1) != 1) {
+            errorCode = "PropertyConstraintViolation";
+            return;
+        }
+    }
+
+    auto availabilityEvse = availabilityService.getEvse(evseId);
+    if (!availabilityEvse) {
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
+
+    const char *type = payload["operationalStatus"] | "_Undefined";
+
+    bool operative = false;
+
+    if (!strcmp(type, "Operative")) {
+        operative = true;
+    } else if (!strcmp(type, "Inoperative")) {
+        operative = false;
+    } else {
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
+
+    status = availabilityEvse->changeAvailability(operative);
+}
+
+std::unique_ptr<JsonDoc> ChangeAvailability::createConf(){
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
+    JsonObject payload = doc->to<JsonObject>();
+
+    switch (status) {
+        case ChangeAvailabilityStatus::Accepted:
+            payload["status"] = "Accepted";
+            break;
+        case ChangeAvailabilityStatus::Scheduled:
+            payload["status"] = "Scheduled";
+            break;
+        case ChangeAvailabilityStatus::Rejected:
+            payload["status"] = "Rejected";
+            break;
+    }
+
+    return doc;
+}
+
+} // namespace Ocpp201
+} // namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/ChangeAvailability.h b/src/MicroOcpp/Operations/ChangeAvailability.h
index 2830d791..08914e52 100644
--- a/src/MicroOcpp/Operations/ChangeAvailability.h
+++ b/src/MicroOcpp/Operations/ChangeAvailability.h
@@ -34,4 +34,39 @@ class ChangeAvailability : public Operation, public MemoryManaged {
 
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Model/Availability/ChangeAvailabilityStatus.h>
+#include <MicroOcpp/Model/Authorization/IdToken.h>
+
+namespace MicroOcpp {
+
+class AvailabilityService;
+
+namespace Ocpp201 {
+
+class ChangeAvailability : public Operation, public MemoryManaged {
+private:
+    AvailabilityService& availabilityService;
+    ChangeAvailabilityStatus status = ChangeAvailabilityStatus::Rejected;
+
+    const char *errorCode {nullptr};
+public:
+    ChangeAvailability(AvailabilityService& availabilityService);
+
+    const char* getOperationType() override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<JsonDoc> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+};
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
 #endif
diff --git a/src/MicroOcpp/Operations/CustomOperation.cpp b/src/MicroOcpp/Operations/CustomOperation.cpp
index 78643d43..317d01ef 100644
--- a/src/MicroOcpp/Operations/CustomOperation.cpp
+++ b/src/MicroOcpp/Operations/CustomOperation.cpp
@@ -11,7 +11,7 @@ CustomOperation::CustomOperation(const char *operationType,
             std::function<std::unique_ptr<JsonDoc> ()> fn_createReq,
             std::function<void (JsonObject)> fn_processConf,
             std::function<bool (const char*, const char*, JsonObject)> fn_processErr) :
-        MemoryManaged("v16.Operation.", operationType),
+        MemoryManaged("Operation.Custom.", operationType),
         operationType{makeString(getMemoryTag(), operationType)},
         fn_createReq{fn_createReq},
         fn_processConf{fn_processConf},
@@ -25,7 +25,7 @@ CustomOperation::CustomOperation(const char *operationType,
             std::function<const char* ()> fn_getErrorCode,
             std::function<const char* ()> fn_getErrorDescription,
             std::function<std::unique_ptr<JsonDoc> ()> fn_getErrorDetails) :
-        MemoryManaged("v16.Operation.", operationType),
+        MemoryManaged("Operation.Custom.", operationType),
         operationType{makeString(getMemoryTag(), operationType)},
         fn_processReq{fn_processReq},
         fn_createConf{fn_createConf},
diff --git a/src/MicroOcpp/Operations/GetVariables.cpp b/src/MicroOcpp/Operations/GetVariables.cpp
index af75f644..30f8dc7f 100644
--- a/src/MicroOcpp/Operations/GetVariables.cpp
+++ b/src/MicroOcpp/Operations/GetVariables.cpp
@@ -20,7 +20,7 @@ GetVariableData::GetVariableData(const char *memory_tag) : componentName{makeStr
 
 }
 
-GetVariables::GetVariables(VariableService& variableService) : MemoryManaged("v201.Operation.", "GetVariableData"), variableService(variableService), queries(makeVector<GetVariableData>(getMemoryTag())) {
+GetVariables::GetVariables(VariableService& variableService) : MemoryManaged("v201.Operation.", "GetVariables"), variableService(variableService), queries(makeVector<GetVariableData>(getMemoryTag())) {
 
 }
 
diff --git a/src/MicroOcpp/Operations/RequestStartTransaction.cpp b/src/MicroOcpp/Operations/RequestStartTransaction.cpp
index 9b35783b..1b6c0b8f 100644
--- a/src/MicroOcpp/Operations/RequestStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RequestStartTransaction.cpp
@@ -7,13 +7,13 @@
 #if MO_ENABLE_V201
 
 #include <MicroOcpp/Operations/RequestStartTransaction.h>
-#include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Model/RemoteControl/RemoteControlService.h>
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp201::RequestStartTransaction;
 using MicroOcpp::JsonDoc;
 
-RequestStartTransaction::RequestStartTransaction(TransactionService& txService) : MemoryManaged("v201.Operation.", "RequestStartTransaction"), txService(txService) {
+RequestStartTransaction::RequestStartTransaction(RemoteControlService& rcService) : MemoryManaged("v201.Operation.", "RequestStartTransaction"), rcService(rcService) {
   
 }
 
@@ -24,7 +24,7 @@ const char* RequestStartTransaction::getOperationType(){
 void RequestStartTransaction::processReq(JsonObject payload) {
 
     int evseId = payload["evseId"] | 0;
-    if (evseId < 0 || evseId >= MO_NUM_EVSE) {
+    if (evseId < 0 || evseId >= MO_NUM_EVSEID) {
         errorCode = "PropertyConstraintViolation";
         return;
     }
@@ -43,7 +43,7 @@ void RequestStartTransaction::processReq(JsonObject payload) {
         return;
     }
 
-    status = txService.requestStartTransaction(evseId, remoteStartId, idToken, transactionId);
+    status = rcService.requestStartTransaction(evseId, remoteStartId, idToken, transaction);
 }
 
 std::unique_ptr<JsonDoc> RequestStartTransaction::createConf(){
@@ -67,8 +67,8 @@ std::unique_ptr<JsonDoc> RequestStartTransaction::createConf(){
 
     payload["status"] = statusCstr;
 
-    if (*transactionId) {
-        payload["transactionId"] = (const char*)transactionId; //force zero-copy mode
+    if (transaction) {
+        payload["transactionId"] = (const char*)transaction->transactionId; //force zero-copy mode
     }
 
     return doc;
diff --git a/src/MicroOcpp/Operations/RequestStartTransaction.h b/src/MicroOcpp/Operations/RequestStartTransaction.h
index d28ade11..dad7d5ae 100644
--- a/src/MicroOcpp/Operations/RequestStartTransaction.h
+++ b/src/MicroOcpp/Operations/RequestStartTransaction.h
@@ -11,24 +11,25 @@
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Memory.h>
-#include <MicroOcpp/Model/Transactions/TransactionDefs.h>
+#include <MicroOcpp/Model/RemoteControl/RemoteControlDefs.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
 
 namespace MicroOcpp {
 
-class TransactionService;
+class RemoteControlService;
 
 namespace Ocpp201 {
 
 class RequestStartTransaction : public Operation, public MemoryManaged {
 private:
-    TransactionService& txService;
+    RemoteControlService& rcService;
 
     RequestStartStopStatus status;
-    char transactionId [MO_TXID_LEN_MAX + 1] = {'\0'};
+    std::shared_ptr<Ocpp201::Transaction> transaction;
 
     const char *errorCode = nullptr;
 public:
-    RequestStartTransaction(TransactionService& txService);
+    RequestStartTransaction(RemoteControlService& rcService);
 
     const char* getOperationType() override;
 
diff --git a/src/MicroOcpp/Operations/RequestStopTransaction.cpp b/src/MicroOcpp/Operations/RequestStopTransaction.cpp
index 9752895a..a316188e 100644
--- a/src/MicroOcpp/Operations/RequestStopTransaction.cpp
+++ b/src/MicroOcpp/Operations/RequestStopTransaction.cpp
@@ -7,13 +7,13 @@
 #if MO_ENABLE_V201
 
 #include <MicroOcpp/Operations/RequestStopTransaction.h>
-#include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Model/RemoteControl/RemoteControlService.h>
 #include <MicroOcpp/Debug.h>
 
 using MicroOcpp::Ocpp201::RequestStopTransaction;
 using MicroOcpp::JsonDoc;
 
-RequestStopTransaction::RequestStopTransaction(TransactionService& txService) : MemoryManaged("v201.Operation.", "RequestStopTransaction"), txService(txService) {
+RequestStopTransaction::RequestStopTransaction(RemoteControlService& rcService) : MemoryManaged("v201.Operation.", "RequestStopTransaction"), rcService(rcService) {
   
 }
 
@@ -30,7 +30,7 @@ void RequestStopTransaction::processReq(JsonObject payload) {
         return;
     }
 
-    status = txService.requestStopTransaction(payload["transactionId"].as<const char*>());
+    status = rcService.requestStopTransaction(payload["transactionId"].as<const char*>());
 }
 
 std::unique_ptr<JsonDoc> RequestStopTransaction::createConf(){
diff --git a/src/MicroOcpp/Operations/RequestStopTransaction.h b/src/MicroOcpp/Operations/RequestStopTransaction.h
index ba8f545c..30664b67 100644
--- a/src/MicroOcpp/Operations/RequestStopTransaction.h
+++ b/src/MicroOcpp/Operations/RequestStopTransaction.h
@@ -11,23 +11,23 @@
 
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Core/Memory.h>
-#include <MicroOcpp/Model/Transactions/TransactionDefs.h>
+#include <MicroOcpp/Model/RemoteControl/RemoteControlDefs.h>
 
 namespace MicroOcpp {
 
-class TransactionService;
+class RemoteControlService;
 
 namespace Ocpp201 {
 
 class RequestStopTransaction : public Operation, public MemoryManaged {
 private:
-    TransactionService& txService;
+    RemoteControlService& rcService;
 
     RequestStartStopStatus status;
 
     const char *errorCode = nullptr;
 public:
-    RequestStopTransaction(TransactionService& txService);
+    RequestStopTransaction(RemoteControlService& rcService);
 
     const char* getOperationType() override;
 
diff --git a/src/MicroOcpp/Operations/Reset.cpp b/src/MicroOcpp/Operations/Reset.cpp
index bf2b7592..9ab42422 100644
--- a/src/MicroOcpp/Operations/Reset.cpp
+++ b/src/MicroOcpp/Operations/Reset.cpp
@@ -81,7 +81,7 @@ void Reset::processReq(JsonObject payload) {
 
     int evseIdRaw = payload["evseId"] | 0;
 
-    if (evseIdRaw < 0 || evseIdRaw >= MO_NUM_EVSE) {
+    if (evseIdRaw < 0 || evseIdRaw >= MO_NUM_EVSEID) {
         errorCode = "PropertyConstraintViolation";
         return;
     }
diff --git a/src/MicroOcpp/Operations/SecurityEventNotification.cpp b/src/MicroOcpp/Operations/SecurityEventNotification.cpp
new file mode 100644
index 00000000..d4837315
--- /dev/null
+++ b/src/MicroOcpp/Operations/SecurityEventNotification.cpp
@@ -0,0 +1,54 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Operations/SecurityEventNotification.h>
+#include <MicroOcpp/Debug.h>
+
+using MicroOcpp::Ocpp201::SecurityEventNotification;
+using MicroOcpp::JsonDoc;
+
+SecurityEventNotification::SecurityEventNotification(const char *type, const Timestamp& timestamp) : MemoryManaged("v201.Operation.", "SecurityEventNotification"), type(makeString(getMemoryTag(), type ? type : "")), timestamp(timestamp) {
+
+}
+
+const char* SecurityEventNotification::getOperationType(){
+    return "SecurityEventNotification";
+}
+
+std::unique_ptr<JsonDoc> SecurityEventNotification::createReq() {
+
+    auto doc = makeJsonDoc(getMemoryTag(),
+                JSON_OBJECT_SIZE(2) +
+                JSONDATE_LENGTH + 1);
+
+    JsonObject payload = doc->to<JsonObject>();
+
+    payload["type"] = type.c_str();
+
+    char timestampStr [JSONDATE_LENGTH + 1];
+    timestamp.toJsonString(timestampStr, sizeof(timestampStr));
+    payload["timestamp"] = timestampStr;
+
+    return doc;
+}
+
+void SecurityEventNotification::processConf(JsonObject) {
+    //empty payload
+}
+
+void SecurityEventNotification::processReq(JsonObject payload) {
+    /**
+     * Ignore Contents of this Req-message, because this is for debug purposes only
+     */
+}
+
+std::unique_ptr<JsonDoc> SecurityEventNotification::createConf() {
+    return createEmptyDocument();
+}
+
+#endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/SecurityEventNotification.h b/src/MicroOcpp/Operations/SecurityEventNotification.h
new file mode 100644
index 00000000..5d618c00
--- /dev/null
+++ b/src/MicroOcpp/Operations/SecurityEventNotification.h
@@ -0,0 +1,48 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#ifndef MO_SECURITYEVENTNOTIFICATION_H
+#define MO_SECURITYEVENTNOTIFICATION_H
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp/Core/Operation.h>
+#include <MicroOcpp/Core/Memory.h>
+#include <MicroOcpp/Core/Time.h>
+
+namespace MicroOcpp {
+
+namespace Ocpp201 {
+
+class SecurityEventNotification : public Operation, public MemoryManaged {
+private:
+    String type;
+    Timestamp timestamp;
+
+    const char *errorCode = nullptr;
+public:
+    SecurityEventNotification(const char *type, const Timestamp& timestamp);
+
+    const char* getOperationType() override;
+
+    std::unique_ptr<JsonDoc> createReq() override;
+
+    void processConf(JsonObject payload) override;
+
+    const char *getErrorCode() override {return errorCode;}
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<JsonDoc> createConf() override;
+
+};
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
+#endif
diff --git a/src/MicroOcpp/Operations/StopTransaction.cpp b/src/MicroOcpp/Operations/StopTransaction.cpp
index ecc495cc..a3aef101 100644
--- a/src/MicroOcpp/Operations/StopTransaction.cpp
+++ b/src/MicroOcpp/Operations/StopTransaction.cpp
@@ -58,9 +58,9 @@ std::unique_ptr<JsonDoc> StopTransaction::createReq() {
     for (auto mv = transactionData.begin(); mv != transactionData.end(); mv++) {
         if ((*mv)->getTimestamp() < MIN_TIME) {
             //time off. Try to adjust, otherwise send invalid value
-            if ((*mv)->getReadingContext() == ReadingContext::TransactionBegin) {
+            if ((*mv)->getReadingContext() == ReadingContext_TransactionBegin) {
                 (*mv)->setTimestamp(transaction->getStartTimestamp());
-            } else if ((*mv)->getReadingContext() == ReadingContext::TransactionEnd) {
+            } else if ((*mv)->getReadingContext() == ReadingContext_TransactionEnd) {
                 (*mv)->setTimestamp(transaction->getStopTimestamp());
             } else {
                 (*mv)->setTimestamp(transaction->getStartTimestamp() + 1);
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
index a9e74a2f..16df68cf 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.cpp
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -24,13 +24,31 @@ const char* TransactionEvent::getOperationType() {
 }
 
 std::unique_ptr<JsonDoc> TransactionEvent::createReq() {
-    auto doc = makeJsonDoc(getMemoryTag(),
-                JSON_OBJECT_SIZE(12) + //total of 12 fields
-                JSONDATE_LENGTH + 1 + //timestamp string
-                JSON_OBJECT_SIZE(5) + //transactionInfo
-                    MO_TXID_LEN_MAX + 1 + //transactionId
-                MO_IDTOKEN_LEN_MAX + 1); //idToken
-                //meterValue not supported
+
+    size_t capacity = 0;
+
+    if (txEvent->eventType == TransactionEventData::Type::Ended) {
+        for (size_t i = 0; i < txEvent->transaction->sampledDataTxEnded.size(); i++) {
+            JsonDoc meterValueJson = initJsonDoc(getMemoryTag()); //just measure, create again for serialization later
+            txEvent->transaction->sampledDataTxEnded[i]->toJson(meterValueJson);
+            capacity += meterValueJson.capacity();
+        }
+    }
+
+    for (size_t i = 0; i < txEvent->meterValue.size(); i++) {
+        JsonDoc meterValueJson = initJsonDoc(getMemoryTag()); //just measure, create again for serialization later
+        txEvent->meterValue[i]->toJson(meterValueJson);
+        capacity += meterValueJson.capacity();
+    }
+
+    capacity +=
+            JSON_OBJECT_SIZE(12) + //total of 12 fields
+            JSONDATE_LENGTH + 1 + //timestamp string
+            JSON_OBJECT_SIZE(5) + //transactionInfo
+                MO_TXID_LEN_MAX + 1 + //transactionId
+            MO_IDTOKEN_LEN_MAX + 1; //idToken
+
+    auto doc = makeJsonDoc(getMemoryTag(), capacity);
     JsonObject payload = doc->to<JsonObject>();
 
     const char *eventType = "";
@@ -255,7 +273,19 @@ std::unique_ptr<JsonDoc> TransactionEvent::createReq() {
         }
     }
 
-    // meterValue not supported
+    if (txEvent->eventType == TransactionEventData::Type::Ended) {
+        for (size_t i = 0; i < txEvent->transaction->sampledDataTxEnded.size(); i++) {
+            JsonDoc meterValueJson = initJsonDoc(getMemoryTag());
+            txEvent->transaction->sampledDataTxEnded[i]->toJson(meterValueJson);
+            payload["meterValue"].add(meterValueJson);
+        }
+    }
+
+    for (size_t i = 0; i < txEvent->meterValue.size(); i++) {
+        JsonDoc meterValueJson = initJsonDoc(getMemoryTag());
+        txEvent->meterValue[i]->toJson(meterValueJson);
+        payload["meterValue"].add(meterValueJson);
+    }
 
     return doc;
 }
diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index 87cc03f6..3dfdbec9 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -78,3 +78,87 @@ std::unique_ptr<JsonDoc> UnlockConnector::createConf() {
     payload["status"] = status;
     return doc;
 }
+
+
+#if MO_ENABLE_V201
+#if MO_ENABLE_CONNECTOR_LOCK
+
+#include <MicroOcpp/Model/RemoteControl/RemoteControlService.h>
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+UnlockConnector::UnlockConnector(RemoteControlService& rcService) : MemoryManaged("v201.Operation.UnlockConnector"), rcService(rcService) {
+
+}
+
+const char* UnlockConnector::getOperationType(){
+    return "UnlockConnector";
+}
+
+void UnlockConnector::processReq(JsonObject payload) {
+
+    int evseId = payload["evseId"] | -1;
+    int connectorId = payload["connectorId"] | -1;
+
+    if (evseId < 1 || evseId >= MO_NUM_EVSEID || connectorId < 1) {
+        errorCode = "PropertyConstraintViolation";
+        return;
+    }
+
+    if (connectorId != 1) {
+        status = UnlockStatus_UnknownConnector;
+        return;
+    }
+
+    rcEvse = rcService.getEvse(evseId);
+    if (!rcEvse) {
+        status = UnlockStatus_UnlockFailed;
+        return;
+    }
+
+    status = rcEvse->unlockConnector();
+    timerStart = mocpp_tick_ms();
+}
+
+std::unique_ptr<JsonDoc> UnlockConnector::createConf() {
+
+    if (rcEvse && status == UnlockStatus_PENDING && mocpp_tick_ms() - timerStart < MO_UNLOCK_TIMEOUT) {
+        status = rcEvse->unlockConnector();
+
+        if (status == UnlockStatus_PENDING) {
+            return nullptr; //no result yet - delay confirmation response
+        }
+    }
+
+    const char *statusStr = "";
+    switch (status) {
+        case UnlockStatus_Unlocked:
+            statusStr = "Unlocked";
+            break;
+        case UnlockStatus_UnlockFailed:
+            statusStr = "UnlockFailed";
+            break;
+        case UnlockStatus_OngoingAuthorizedTransaction:
+            statusStr = "OngoingAuthorizedTransaction";
+            break;
+        case UnlockStatus_UnknownConnector:
+            statusStr = "UnknownConnector";
+            break;
+        case UnlockStatus_PENDING:
+            MO_DBG_ERR("UnlockConnector timeout");
+            statusStr = "UnlockFailed";
+            break;
+    }
+
+    auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
+    JsonObject payload = doc->to<JsonObject>();
+    payload["status"] = statusStr;
+    return doc;
+}
+
+} // namespace Ocpp201
+} // namespace MicroOcpp
+
+#endif //MO_ENABLE_CONNECTOR_LOCK
+#endif //MO_ENABLE_V201
diff --git a/src/MicroOcpp/Operations/UnlockConnector.h b/src/MicroOcpp/Operations/UnlockConnector.h
index 44b41bb9..518653cd 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.h
+++ b/src/MicroOcpp/Operations/UnlockConnector.h
@@ -5,6 +5,8 @@
 #ifndef UNLOCKCONNECTOR_H
 #define UNLOCKCONNECTOR_H
 
+#include <MicroOcpp/Version.h>
+
 #include <MicroOcpp/Core/Operation.h>
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <functional>
@@ -40,4 +42,44 @@ class UnlockConnector : public Operation, public MemoryManaged {
 
 } //end namespace Ocpp16
 } //end namespace MicroOcpp
+
+#if MO_ENABLE_V201
+#if MO_ENABLE_CONNECTOR_LOCK
+
+#include <MicroOcpp/Model/RemoteControl/RemoteControlDefs.h>
+
+namespace MicroOcpp {
+
+class RemoteControlService;
+class RemoteControlServiceEvse;
+
+namespace Ocpp201 {
+
+class UnlockConnector : public Operation, public MemoryManaged {
+private:
+    RemoteControlService& rcService;
+    RemoteControlServiceEvse *rcEvse = nullptr;
+
+    UnlockStatus status;
+    unsigned long timerStart = 0; //for timeout
+
+    const char *errorCode = nullptr;
+public:
+    UnlockConnector(RemoteControlService& rcService);
+
+    const char* getOperationType() override;
+
+    void processReq(JsonObject payload) override;
+
+    std::unique_ptr<JsonDoc> createConf() override;
+
+    const char *getErrorCode() override {return errorCode;}
+};
+
+} //end namespace Ocpp201
+} //end namespace MicroOcpp
+
+#endif //MO_ENABLE_CONNECTOR_LOCK
+#endif //MO_ENABLE_V201
+
 #endif
diff --git a/tests/Api.cpp b/tests/Api.cpp
index ab0888c2..d7815e10 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -55,7 +55,7 @@ TEST_CASE( "C++ API test" ) {
         auto valueSampler = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>>(
                                         new MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>(
                     svprops,
-                    [c = &checkpoints[ncheck++]] (MicroOcpp::ReadingContext) -> int32_t {*c = true; return 0;}));
+                    [c = &checkpoints[ncheck++]] (ReadingContext) -> int32_t {*c = true; return 0;}));
         addMeterValueInput(std::move(valueSampler));
 
         setOccupiedInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return false;});
@@ -234,13 +234,13 @@ TEST_CASE( "C API test" ) {
         auto valueSampler = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>>(
                                         new MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>(
                     svprops,
-                    [] (MicroOcpp::ReadingContext) -> int32_t {checkpointsc[16] = true; return 0;})); ncheckc++;
+                    [] (ReadingContext) -> int32_t {checkpointsc[16] = true; return 0;})); ncheckc++;
         ocpp_addMeterValueInput(reinterpret_cast<MeterValueInput*>(valueSampler.release()));
 
         valueSampler = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>>(
                                         new MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>(
                     svprops,
-                    [] (MicroOcpp::ReadingContext) -> int32_t {checkpointsc[17] = true; return 0;})); ncheckc++;
+                    [] (ReadingContext) -> int32_t {checkpointsc[17] = true; return 0;})); ncheckc++;
         ocpp_addMeterValueInput_m(2, reinterpret_cast<MeterValueInput*>(valueSampler.release()));
 
         ocpp_setOccupiedInput([] () -> bool {checkpointsc[18] = true; return true;}); ncheckc++;
diff --git a/tests/Boot.cpp b/tests/Boot.cpp
index 4beadf31..c759b808 100644
--- a/tests/Boot.cpp
+++ b/tests/Boot.cpp
@@ -426,5 +426,51 @@ TEST_CASE( "Boot Behavior" ) {
         REQUIRE( !strcmp(declareConfiguration<const char*>("neverDeclaredInsideMO", "newVal")->getString(), "newVal") ); //config has been removed
     }
 
+    SECTION("Boot with v201") {
+
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials::v201(CHARGEPOINTMODEL, CHARGEPOINTVENDOR), filesystem, false, ProtocolVersion(2,0,1));
+
+        bool checkProcessed = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("BootNotification",
+            [&checkProcessed] () {
+                return new Ocpp16::CustomOperation("BootNotification",
+                    [ &checkProcessed] (JsonObject payload) {
+                        //process req
+                        checkProcessed = true;
+                        REQUIRE( !strcmp(payload["reason"] | "_Undefined", "PowerUp") );
+                        REQUIRE( !strcmp(payload["chargingStation"]["model"] | "_Undefined", CHARGEPOINTMODEL) );
+                        REQUIRE( !strcmp(payload["chargingStation"]["vendorName"] | "_Undefined", CHARGEPOINTVENDOR) );
+                    },
+                    [] () {
+                        //create conf
+                        auto conf = makeJsonDoc(UNIT_MEM_TAG, JSON_OBJECT_SIZE(3));
+                        (*conf)["currentTime"] = BASE_TIME;
+                        (*conf)["interval"] = 3600;
+                        (*conf)["status"] = "Accepted";
+                        return conf;
+                    });
+            });
+
+        MO_MEM_RESET();
+        
+        loop();
+
+        REQUIRE(checkProcessed);
+        REQUIRE(getOcppContext()->getModel().getClock().now() >= MIN_TIME);
+
+        MO_MEM_PRINT_STATS();
+
+        MO_MEM_RESET();
+
+        mtime += 3600 * 1000;
+        loop();
+
+        MO_DBG_INFO("Memory requirements UC G02:");
+        MO_MEM_PRINT_STATS();
+    }
+
     mocpp_deinitialize();
 }
diff --git a/tests/Reset.cpp b/tests/Reset.cpp
index 8036393f..c5dfcd5b 100644
--- a/tests/Reset.cpp
+++ b/tests/Reset.cpp
@@ -9,6 +9,7 @@
 #include <MicroOcpp.h>
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
 #include <MicroOcpp/Model/Reset/ResetService.h>
@@ -38,9 +39,20 @@ TEST_CASE( "Reset" ) {
 
     mocpp_set_timer(custom_timer_cb);
 
+    getOcppContext()->getOperationRegistry().registerOperation("Authorize", [] () {
+        return new Ocpp16::CustomOperation("Authorize",
+            [] (JsonObject) {}, //ignore req
+            [] () {
+                //create conf
+                auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
+                auto payload = doc->to<JsonObject>();
+                payload["idTokenInfo"]["status"] = "Accepted";
+                return doc;
+            });});
+
     // Register Reset handlers
-    bool checkNotified [MO_NUM_EVSE] = {false};
-    bool checkExecuted [MO_NUM_EVSE] = {false};
+    bool checkNotified [MO_NUM_EVSEID] = {false};
+    bool checkExecuted [MO_NUM_EVSEID] = {false};
 
     setOnResetNotify([&checkNotified] (bool) {
         MO_DBG_DEBUG("Notify");
@@ -53,7 +65,7 @@ TEST_CASE( "Reset" ) {
         return false; // Reset fails because we're not actually exiting the process
     });
     
-    for (size_t i = 1; i < MO_NUM_EVSE; i++) {
+    for (size_t i = 1; i < MO_NUM_EVSEID; i++) {
         context->getModel().getResetServiceV201()->setNotifyReset([&checkNotified, i] (ResetType) {
             MO_DBG_DEBUG("Notify %zu", i);
             checkNotified[i] = true;
@@ -68,6 +80,43 @@ TEST_CASE( "Reset" ) {
 
     loop();
 
+    SECTION("B11 - Reset - Without ongoing transaction") {
+
+        MO_MEM_RESET();
+
+        bool checkProcessed = false;
+
+        auto resetRequest = makeRequest(new Ocpp16::CustomOperation(
+                "Reset",
+                [] () {
+                    //create req
+                    auto doc = makeJsonDoc("UnitTests", JSON_OBJECT_SIZE(1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["type"] = "OnIdle";
+                    return doc;},
+                [&checkProcessed] (JsonObject payload) {
+                    //receive conf
+                    checkProcessed = true;
+
+                    REQUIRE(!strcmp(payload["status"], "Accepted"));
+                }
+        ));
+
+        context->initiateRequest(std::move(resetRequest));
+
+        loop();
+        mtime += 30000; // Reset has some delays to ensure that the WS is not cut off immediately
+        loop();
+
+        REQUIRE(checkProcessed);
+
+        for (size_t i = 0; i < MO_NUM_EVSEID; i++) {
+            REQUIRE( checkNotified[i] );
+        }
+
+        MO_MEM_PRINT_STATS();
+    }
+
     SECTION("Schedule full charger Reset") {
 
         REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
@@ -114,7 +163,7 @@ TEST_CASE( "Reset" ) {
 
         REQUIRE(checkProcessed);
 
-        for (size_t i = 0; i < MO_NUM_EVSE; i++) {
+        for (size_t i = 0; i < MO_NUM_EVSEID; i++) {
             REQUIRE( checkNotified[i] );
         }
 
@@ -132,7 +181,7 @@ TEST_CASE( "Reset" ) {
         REQUIRE( !ocppPermitsCharge(1) );
         REQUIRE( ocppPermitsCharge(2) );
 
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Unavailable );
+        //REQUIRE( getChargePointStatus(1) == ChargePointStatus_Unavailable ); //change: Reset doesn't lead to Unavailable state
 
         context->getModel().getTransactionService()->getEvse(2)->endAuthorization("mIdToken");
         setConnectorPluggedInput([] () {return false;}, 2);
@@ -150,8 +199,8 @@ TEST_CASE( "Reset" ) {
         REQUIRE( checkExecuted[0] );
 
         // Technically, Reset failed at this point, because the program is still running. Check if connectors are Available agin
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Available );
-        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus_Available );
+        REQUIRE( getChargePointStatus(1) == ChargePointStatus_Available );
+        REQUIRE( getChargePointStatus(2) == ChargePointStatus_Available );
     }
 
     SECTION("Immediate full charger Reset") {
@@ -167,6 +216,8 @@ TEST_CASE( "Reset" ) {
 
         loop();
 
+        MO_MEM_RESET();
+
         REQUIRE( ocppPermitsCharge(1) );
         REQUIRE( ocppPermitsCharge(2) );
 
@@ -214,7 +265,7 @@ TEST_CASE( "Reset" ) {
         REQUIRE(checkProcessed);
         REQUIRE(checkProcessedTx);
 
-        for (size_t i = 0; i < MO_NUM_EVSE; i++) {
+        for (size_t i = 0; i < MO_NUM_EVSEID; i++) {
             REQUIRE( checkNotified[i] );
         }
 
@@ -224,11 +275,13 @@ TEST_CASE( "Reset" ) {
 
         REQUIRE( checkExecuted[0] );
 
+        MO_MEM_PRINT_STATS();
+
         loop();
 
         // Technically, Reset failed at this point, because the program is still running. Check if connectors are Available agin
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Available );
-        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus_Available );
+        REQUIRE( getChargePointStatus(1) == ChargePointStatus_Available );
+        REQUIRE( getChargePointStatus(2) == ChargePointStatus_Available );
     }
 
     SECTION("Reject Reset") {
@@ -264,9 +317,9 @@ TEST_CASE( "Reset" ) {
         REQUIRE(checkProcessed);
         REQUIRE(checkNotified[2]);
 
-        REQUIRE( context->getModel().getConnector(0)->getStatus() == ChargePointStatus_Available );
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Available );
-        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus_Available );
+        REQUIRE( getChargePointStatus(0) == ChargePointStatus_Available );
+        REQUIRE( getChargePointStatus(1) == ChargePointStatus_Available );
+        REQUIRE( getChargePointStatus(2) == ChargePointStatus_Available );
     }
 
     SECTION("Reset single EVSE") {
@@ -297,14 +350,14 @@ TEST_CASE( "Reset" ) {
         REQUIRE(checkProcessed);
         REQUIRE(checkNotified[1]);
 
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Unavailable );
-        REQUIRE( context->getModel().getConnector(2)->getStatus() == ChargePointStatus_Available );
+        //REQUIRE( getChargePointStatus(1) == ChargePointStatus_Unavailable ); //change: Reset doesn't lead to Unavailable state
+        REQUIRE( getChargePointStatus(2) == ChargePointStatus_Available );
 
         mtime += 30000; // Reset has some delays to ensure that the WS is not cut off immediately
         loop();
 
         REQUIRE(checkExecuted[1]);
-        REQUIRE( context->getModel().getConnector(1)->getStatus() == ChargePointStatus_Available );
+        REQUIRE( getChargePointStatus(1) == ChargePointStatus_Available );
     }
 
     mocpp_deinitialize();
diff --git a/tests/Security.cpp b/tests/Security.cpp
new file mode 100644
index 00000000..43bf2d7a
--- /dev/null
+++ b/tests/Security.cpp
@@ -0,0 +1,58 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp/Version.h>
+
+#if MO_ENABLE_V201
+
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Operations/SecurityEventNotification.h>
+#include <MicroOcpp/Debug.h>
+#include <catch2/catch.hpp>
+#include "./helpers/testHelper.h"
+
+#define BASE_TIME "2023-01-01T00:00:00.000Z"
+
+using namespace MicroOcpp;
+
+
+TEST_CASE( "Security" ) {
+    printf("\nRun %s\n",  "Security");
+
+    mocpp_set_timer(custom_timer_cb);
+
+    //initialize Context with dummy socket
+    LoopbackConnection loopback;
+    auto filesystem = makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail);
+    mocpp_initialize(loopback,
+            ChargerCredentials(),
+            filesystem,
+            false,
+            ProtocolVersion(2,0,1));
+
+    SECTION("Manual SecurityEventNotification") {
+
+        loop();
+
+        MO_MEM_RESET();
+
+        getOcppContext()->initiateRequest(makeRequest(new Ocpp201::SecurityEventNotification(
+                "ReconfigurationOfSecurityParameters",
+                getOcppContext()->getModel().getClock().now())));
+        
+        loop();
+
+        MO_MEM_PRINT_STATS();
+    }
+
+    mocpp_deinitialize();
+}
+
+#endif // MO_ENABLE_V201
diff --git a/tests/Transactions.cpp b/tests/Transactions.cpp
index aa4a3be9..aa86df32 100644
--- a/tests/Transactions.cpp
+++ b/tests/Transactions.cpp
@@ -11,8 +11,10 @@
 #include <MicroOcpp/Core/Context.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Transactions/TransactionService.h>
+#include <MicroOcpp/Model/Variables/VariableService.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 #include <MicroOcpp/Debug.h>
+#include <MicroOcpp/Core/Memory.h>
 #include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
@@ -33,7 +35,6 @@ TEST_CASE( "Transactions" ) {
             ProtocolVersion(2,0,1));
 
     auto context = getOcppContext();
-    auto& checkMsg = context->getOperationRegistry();
 
     mocpp_set_timer(custom_timer_cb);
 
@@ -101,6 +102,170 @@ TEST_CASE( "Transactions" ) {
                   context->getModel().getTransactionService()->getEvse(1)->getTransaction()->stopped));
     }
 
+    SECTION("UC C01-04") {
+
+        //scenario preparation
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("PowerPathClosed");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("PowerPathClosed");
+
+        setConnectorPluggedInput([] () {return false;});
+
+        loop();
+
+        MO_MEM_RESET();
+
+        context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken");
+        loop();
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() != nullptr );
+        REQUIRE( !context->getModel().getTransactionService()->getEvse(1)->getTransaction()->started );
+        REQUIRE( !context->getModel().getTransactionService()->getEvse(1)->getTransaction()->stopped );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+
+        MO_DBG_INFO("Memory requirements UC C01-04:");
+
+        MO_MEM_PRINT_STATS();
+    }
+
+    SECTION("UC E01 - S5 / E06") {
+
+        //scenario preparation
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("PowerPathClosed");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("PowerPathClosed");
+
+        setConnectorPluggedInput([] () {return false;});
+
+        loop();
+
+        MO_MEM_RESET();
+
+        //run scenario
+
+        setConnectorPluggedInput([] () {return true;});
+        loop();
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Occupied );
+
+        context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken");
+        loop();
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() != nullptr );
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction()->started );
+        REQUIRE( !context->getModel().getTransactionService()->getEvse(1)->getTransaction()->stopped );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Occupied );
+
+        MO_DBG_INFO("Memory requirements UC E01 - S5:");
+
+        MO_MEM_PRINT_STATS();
+
+        auto trackTx = context->getModel().getTransactionService()->getEvse(1)->getTransaction();
+
+        MO_MEM_RESET();
+
+        setConnectorPluggedInput([] () {return false;});
+        loop();
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+        REQUIRE( trackTx->stopped );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+        trackTx.reset();
+
+        MO_DBG_INFO("Memory requirements UC E06:");
+        MO_MEM_PRINT_STATS();
+
+    }
+
+    SECTION("UC G01") {
+
+        setConnectorPluggedInput([] () {return false;});
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+        MO_MEM_RESET();
+
+        setConnectorPluggedInput([] () {return true;});
+        loop();
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Occupied );
+
+        MO_DBG_INFO("Memory requirements UC G01:");
+        MO_MEM_PRINT_STATS();
+    }
+
+    SECTION("UC J02") {
+
+        //scenario preparation
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("PowerPathClosed");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("PowerPathClosed");
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("SampledDataCtrlr", "SampledDataTxStartedMeasurands", "")->setString("Energy.Active.Import.Register");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("SampledDataCtrlr", "SampledDataTxUpdatedMeasurands", "")->setString("Power.Active.Import");
+        getOcppContext()->getModel().getVariableService()->declareVariable<int>("SampledDataCtrlr", "TxUpdatedInterval", 0)->setInt(60);
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("SampledDataCtrlr", "SampledDataTxEndedMeasurands", "")->setString("Current.Import");
+        getOcppContext()->getModel().getVariableService()->declareVariable<int>("SampledDataCtrlr", "TxEndededInterval", 0)->setInt(100);
+
+        setConnectorPluggedInput([] () {return false;});
+        setEnergyMeterInput([] () {return 100;});
+        setPowerMeterInput([] () {return 200;});
+        addMeterValueInput([] () {return 30;}, "Current.Import", "A");
+
+        Timestamp tStart, tUpdated, tEnded;
+
+        setOnReceiveRequest("TransactionEvent", [&tStart, &tUpdated, &tEnded] (JsonObject request) {
+            const char *eventType = request["eventType"] | (const char*)nullptr;
+            bool eventTypeError = false;
+            if (!strcmp(eventType, "Started")) {
+                tStart = getOcppContext()->getModel().getClock().now();
+
+                REQUIRE( request["meterValue"].as<JsonArray>().size() >= 1 );
+
+                Timestamp tMv;
+                tMv.setTime(request["meterValue"][0]["timestamp"]);
+                REQUIRE( std::abs(tStart - tMv) <= 1);
+
+                REQUIRE( request["meterValue"][0]["sampledValue"].as<JsonArray>().size() >= 1 );
+
+                REQUIRE( !strcmp(request["meterValue"][0]["sampledValue"][0]["measurand"] | "_Undefined", "Energy.Active.Import.Register") );
+                REQUIRE( !strcmp(request["meterValue"][0]["sampledValue"][0]["measurand"] | "_Undefined", "Energy.Active.Import.Register") );
+            } else if (!strcmp(eventType, "Updated")) {
+                tUpdated = getOcppContext()->getModel().getClock().now();
+
+            } else if (!strcmp(eventType, "Ended")) {
+                tEnded = getOcppContext()->getModel().getClock().now();
+
+            } else {
+                eventTypeError = true;
+            }
+            REQUIRE( !eventTypeError );
+        });
+
+        loop();
+
+        MO_MEM_RESET();
+
+        //run scenario
+
+        setConnectorPluggedInput([] () {return true;});
+        context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken");
+        loop();
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() != nullptr );
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction()->started );
+        REQUIRE( !context->getModel().getTransactionService()->getEvse(1)->getTransaction()->stopped );
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Occupied );
+
+        MO_DBG_INFO("Memory requirements UC E01 - S5:");
+
+        MO_MEM_PRINT_STATS();
+    }
+
     mocpp_deinitialize();
 }
 
diff --git a/tests/Variables.cpp b/tests/Variables.cpp
index 6813dd11..1d6399c4 100644
--- a/tests/Variables.cpp
+++ b/tests/Variables.cpp
@@ -16,6 +16,7 @@
 #include <MicroOcpp/Model/Variables/VariableService.h>
 
 #include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Operations/CustomOperation.h>
 
 using namespace MicroOcpp;
@@ -116,7 +117,7 @@ TEST_CASE( "Variable" ) {
     SECTION("Variable API") {
 
         //declare configs
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
         auto vs = getOcppContext()->getModel().getVariableService();
         auto cInt = vs->declareVariable<int>("mComponent", "cInt", 42);
         REQUIRE( cInt != nullptr );
@@ -188,7 +189,7 @@ TEST_CASE( "Variable" ) {
 #else
         mocpp_deinitialize();
 
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
 #endif
 
         //config accessibility / permissions
@@ -240,7 +241,7 @@ TEST_CASE( "Variable" ) {
     SECTION("Main lib integration") {
 
         //basic lifecycle
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
         REQUIRE( getVariablePublic("ConnectionTimeOut") );
         REQUIRE( !getVariableContainersPublic().empty() );
         mocpp_deinitialize();
@@ -248,7 +249,7 @@ TEST_CASE( "Variable" ) {
         REQUIRE( getVariableContainersPublic().empty() );
 
         //modify standard config ConnectionTimeOut. This config is not modified by the main lib during normal initialization / deinitialization
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
         auto config = getVariablePublic("ConnectionTimeOut");
 
         config->setInt(1234); //update
@@ -256,7 +257,7 @@ TEST_CASE( "Variable" ) {
 
         mocpp_deinitialize();
 
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
         REQUIRE( getVariablePublic("ConnectionTimeOut")->getInt() == 1234 );
 
         mocpp_deinitialize();
@@ -266,7 +267,7 @@ TEST_CASE( "Variable" ) {
 #if 0
     SECTION("GetVariables") {
 
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
         loop();
 
         vs->declareVariable<int>(KNOWN_KEY, 1234, MO_FILENAME_PREFIX "persistent1.jsn", false);
@@ -357,7 +358,7 @@ TEST_CASE( "Variable" ) {
 
     SECTION("ChangeVariable") {
 
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
         loop();
 
         vs->declareVariable<int>(KNOWN_KEY, 0, MO_FILENAME_PREFIX "persistent1.jsn", false);
@@ -485,7 +486,7 @@ TEST_CASE( "Variable" ) {
         configuration_init(filesystem);
         auto factoryConnectionTimeOut = vs->declareVariable<int>("ConnectionTimeOut", 1234, MO_FILENAME_PREFIX "factory.jsn");
 
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
 
         auto connectionTimeout2 = vs->declareVariable<int>("ConnectionTimeOut", 4321);
         REQUIRE( connectionTimeout2->getInt() == 1234 );
@@ -495,20 +496,187 @@ TEST_CASE( "Variable" ) {
         mocpp_deinitialize();
 
         //this time, factory default is not given (will lead to duplicates, should be considered in sanitization)
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
         REQUIRE( getVariablePublic("ConnectionTimeOut")->getInt() != 1234 );
         mocpp_deinitialize();
 
         //provide factory default again
         configuration_init(filesystem);
         vs->declareVariable<int>("ConnectionTimeOut", 4321, MO_FILENAME_PREFIX "factory.jsn");
-        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
         REQUIRE( getVariablePublic("ConnectionTimeOut")->getInt() == 1234 );
         mocpp_deinitialize();
 
     }
 #endif
 
+    SECTION("GetVariables request") {
+
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
+
+        auto vs = getOcppContext()->getModel().getVariableService();
+        auto varString = vs->declareVariable<const char*>("mComponent", "mString", "mValue", MO_VARIABLE_VOLATILE);
+        REQUIRE( varString != nullptr );
+        REQUIRE( !strcmp(varString->getString(), "mValue") );
+
+        loop();
+
+        MO_MEM_RESET();
+
+        bool checkProcessed = false;
+
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("GetVariables",
+                [] () {
+                    //create req
+                    auto doc = makeJsonDoc("UnitTests",
+                            JSON_OBJECT_SIZE(1) +
+                            JSON_ARRAY_SIZE(1) +
+                            JSON_OBJECT_SIZE(2) +
+                            JSON_OBJECT_SIZE(1) +
+                            JSON_OBJECT_SIZE(1));
+                    auto payload = doc->to<JsonObject>();
+                    auto getVariableData = payload.createNestedArray("getVariableData");
+                    getVariableData[0]["component"]["name"] = "mComponent";
+                    getVariableData[0]["variable"]["name"] = "mString";
+                    return doc;
+                },
+                [&checkProcessed] (JsonObject payload) {
+                    //process conf
+                    JsonArray getVariableResult = payload["getVariableResult"];
+                    REQUIRE( !strcmp(getVariableResult[0]["attributeStatus"] | "_Undefined", "Accepted") );
+                    REQUIRE( !strcmp(getVariableResult[0]["component"]["name"] | "_Undefined", "mComponent") );
+                    REQUIRE( !strcmp(getVariableResult[0]["variable"]["name"] | "_Undefined", "mString") );
+                    REQUIRE( !strcmp(getVariableResult[0]["attributeValue"] | "_Undefined", "mValue") );
+                    checkProcessed = true;
+                })));
+        
+        loop();
+
+        REQUIRE( checkProcessed );
+
+        MO_MEM_PRINT_STATS();
+
+    }
+
+    SECTION("SetVariables request") {
+
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
+
+        auto vs = getOcppContext()->getModel().getVariableService();
+        auto varString = vs->declareVariable<const char*>("mComponent", "mString", "", MO_VARIABLE_VOLATILE);
+        REQUIRE( varString != nullptr );
+        REQUIRE( !strcmp(varString->getString(), "") );
+
+        loop();
+
+        MO_MEM_RESET();
+
+        bool checkProcessed = false;
+
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("SetVariables",
+                [] () {
+                    //create req
+                    auto doc = makeJsonDoc("UnitTests",
+                            JSON_OBJECT_SIZE(1) +
+                            JSON_ARRAY_SIZE(1) +
+                            JSON_OBJECT_SIZE(3) +
+                            JSON_OBJECT_SIZE(1) +
+                            JSON_OBJECT_SIZE(1));
+                    auto payload = doc->to<JsonObject>();
+                    auto setVariableData = payload.createNestedArray("setVariableData");
+                    setVariableData[0]["component"]["name"] = "mComponent";
+                    setVariableData[0]["variable"]["name"] = "mString";
+                    setVariableData[0]["attributeValue"] = "mValue";
+                    return doc;
+                },
+                [&checkProcessed] (JsonObject payload) {
+                    //process conf
+                    JsonArray setVariableResult = payload["setVariableResult"];
+                    REQUIRE( !strcmp(setVariableResult[0]["attributeStatus"] | "_Undefined", "Accepted") );
+                    REQUIRE( !strcmp(setVariableResult[0]["component"]["name"] | "_Undefined", "mComponent") );
+                    REQUIRE( !strcmp(setVariableResult[0]["variable"]["name"] | "_Undefined", "mString") );
+                    checkProcessed = true;
+                })));
+        
+        loop();
+
+        REQUIRE( checkProcessed );
+
+        MO_MEM_PRINT_STATS();
+    }
+
+    SECTION("GetBaseReport request") {
+
+        mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
+
+        auto vs = getOcppContext()->getModel().getVariableService();
+        auto varString = vs->declareVariable<const char*>("mComponent", "mString", "", MO_VARIABLE_VOLATILE);
+        REQUIRE( varString != nullptr );
+        REQUIRE( !strcmp(varString->getString(), "") );
+
+        loop();
+
+        MO_MEM_RESET();
+
+        bool checkProcessedNotification = false;
+        Timestamp checkTimestamp;
+
+        getOcppContext()->getOperationRegistry().registerOperation("NotifyReport",
+            [&checkProcessedNotification, &checkTimestamp] () {
+                return new Ocpp16::CustomOperation("NotifyReport",
+                    [ &checkProcessedNotification, &checkTimestamp] (JsonObject payload) {
+                        //process req
+                        checkProcessedNotification = true;
+                        REQUIRE( (payload["requestId"] | -1) == 1);
+                        checkTimestamp.setTime(payload["generatedAt"] | "_Undefined");
+                        REQUIRE( (payload["seqNo"] | -1) == 0);
+
+                        bool foundVar = false;
+                        for (auto reportData : payload["reportData"].as<JsonArray>()) {
+                            if (!strcmp(reportData["component"]["name"] | "_Undefined", "mComponent") &&
+                                    !strcmp(reportData["variable"]["name"] | "_Undefined", "mString")) {
+                                foundVar = true;
+                            }
+                        }
+                        REQUIRE( foundVar );
+                    },
+                    [] () {
+                        //create conf
+                        return createEmptyDocument();
+                    });
+            });
+
+        bool checkProcessed = false;
+
+        getOcppContext()->initiateRequest(makeRequest(
+            new Ocpp16::CustomOperation("GetBaseReport",
+                [] () {
+                    //create req
+                    auto doc = makeJsonDoc("UnitTests",
+                            JSON_OBJECT_SIZE(2));
+                    auto payload = doc->to<JsonObject>();
+                    payload["requestId"] = 1;
+                    payload["reportBase"] = "FullInventory";
+                    return doc;
+                },
+                [&checkProcessed] (JsonObject payload) {
+                    //process conf
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", "Accepted") );
+                    checkProcessed = true;
+                })));
+
+        loop();
+
+        REQUIRE( checkProcessed );
+        REQUIRE( checkProcessedNotification );
+        REQUIRE( std::abs(getOcppContext()->getModel().getClock().now() - checkTimestamp) <= 10 );
+
+        MO_MEM_PRINT_STATS();
+
+    }
+
     mocpp_deinitialize();
 }
 
diff --git a/tests/benchmarks/scripts/eval_firmware_size.py b/tests/benchmarks/scripts/eval_firmware_size.py
index 653cf00f..5d544028 100755
--- a/tests/benchmarks/scripts/eval_firmware_size.py
+++ b/tests/benchmarks/scripts/eval_firmware_size.py
@@ -41,6 +41,7 @@ def categorize_table(df):
     MODULE_AUTHORIZATION = 'C - Authorization'
     MODULE_LOCALAUTH = 'D - Local Authorization List Management'
     MODULE_TX = 'E - Transactions'
+    MODULE_REMOTECONTROL = 'F - RemoteControl'
     MODULE_AVAILABILITY = 'G - Availability'
     MODULE_RESERVATION = 'H - Reservation'
     MODULE_METERVALUES = 'J - MeterValues'
@@ -154,8 +155,17 @@ def categorize_table(df):
     df.at['Model/Metering/MeterStore.cpp', 'Module'] = MODULE_METERVALUES
     df.at['Model/Metering/MeterValue.cpp', 'v16'] = TICK
     df.at['Model/Metering/MeterValue.cpp', 'Module'] = MODULE_METERVALUES
+    if 'Model/Metering/MeterValuesV201.cpp' in df.index:
+        df.at['Model/Metering/MeterValuesV201.cpp', 'v201'] = TICK
+        df.at['Model/Metering/MeterValuesV201.cpp', 'Module'] = MODULE_METERVALUES
+    if 'Model/Metering/ReadingContext.cpp' in df.index:
+        df.at['Model/Metering/ReadingContext.cpp', 'v201'] = TICK
+        df.at['Model/Metering/ReadingContext.cpp', 'Module'] = MODULE_METERVALUES
     df.at['Model/Metering/SampledValue.cpp', 'v16'] = TICK
     df.at['Model/Metering/SampledValue.cpp', 'Module'] = MODULE_METERVALUES
+    if 'Model/RemoteControl/RemoteControlService.cpp' in df.index:
+        df.at['Model/RemoteControl/RemoteControlService.cpp', 'v201'] = TICK
+        df.at['Model/RemoteControl/RemoteControlService.cpp', 'Module'] = MODULE_REMOTECONTROL
     df.at['Model/Model.cpp', 'v16'] = TICK
     df.at['Model/Model.cpp', 'v201'] = TICK
     df.at['Model/Model.cpp', 'Module'] = MODULE_GENERAL

From 4ea7db2daeefb94bef42d4fa2d4ae4db9fab5646 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Tue, 8 Oct 2024 09:34:18 +0200
Subject: [PATCH 523/549] make txId in TxProfile an optional parameter (fixes
 #346) (#348)

---
 CHANGELOG.md                                    | 1 +
 src/MicroOcpp/Operations/SetChargingProfile.cpp | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 22c9a6bc..632a44e6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -101,6 +101,7 @@
 - Change arduinoWebSockets URL param to path ([#278](https://github.com/matth-x/MicroOcpp/issues/278))
 - Avoid creating conf when operation fails ([#290](https://github.com/matth-x/MicroOcpp/pull/290))
 - Fix whitespaces in MeterValues ([#301](https://github.com/matth-x/MicroOcpp/pull/301))
+- Make SmartChargingProfile txId field optional ([#348](https://github.com/matth-x/MicroOcpp/pull/348))
 
 ## [1.0.3] - 2024-04-06
 
diff --git a/src/MicroOcpp/Operations/SetChargingProfile.cpp b/src/MicroOcpp/Operations/SetChargingProfile.cpp
index 355d70d3..1ff28acd 100644
--- a/src/MicroOcpp/Operations/SetChargingProfile.cpp
+++ b/src/MicroOcpp/Operations/SetChargingProfile.cpp
@@ -66,7 +66,7 @@ void SetChargingProfile::processReq(JsonObject payload) {
             return;
         }
 
-        if (chargingProfile->getTransactionId() < 0 ||
+        if (chargingProfile->getTransactionId() >= 0 &&
                 chargingProfile->getTransactionId() != transaction->getTransactionId()) {
             //transactionId undefined / mismatch
             accepted = false;

From 6cb5066b22966e0cf9b700e813cc66b24a228ac1 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Thu, 10 Oct 2024 11:30:51 +0200
Subject: [PATCH 524/549] Print memory stats to JSON (#375)

---
 src/MicroOcpp/Core/Memory.cpp | 37 ++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/Memory.cpp b/src/MicroOcpp/Core/Memory.cpp
index f8ea7a2b..a352e9ac 100644
--- a/src/MicroOcpp/Core/Memory.cpp
+++ b/src/MicroOcpp/Core/Memory.cpp
@@ -207,7 +207,7 @@ void mo_mem_print_stats() {
 
     for (const auto& heapEntry : memBlocks) {
         size += heapEntry.second.size;
-        #if MO_DBG_LEVEL >= MO_DL_DEBUG
+        #if MO_DBG_LEVEL >= MO_DL_VERBOSE
         {
             MO_CONSOLE_PRINTF("@%p - %zu B (%s)\n", heapEntry.first, heapEntry.second.size, heapEntry.second.tag.c_str());
         }
@@ -254,6 +254,41 @@ void mo_mem_print_stats() {
     #endif
 }
 
+int mo_mem_write_stats_json(char *buf, size_t size) {
+    DynamicJsonDocument doc {size * 2};
+
+    doc["total_current"] = memTotal;
+    doc["total_max"] = memTotalMax;
+    doc["total_blocks"] = memBlocks.size();
+
+    JsonArray by_tag = doc.createNestedArray("by_tag");
+    for (const auto& tag : memTags) {
+        JsonObject entry = by_tag.createNestedObject();
+        entry["tag"] = tag.first.c_str();
+        entry["current"] = tag.second.current_size;
+        entry["max"] = tag.second.max_size;
+    }
+
+    size_t untagged = 0, untagged_size = 0;
+
+    for (const auto& heapEntry : memBlocks) {
+        if (heapEntry.second.tag.empty()) {
+            untagged ++;
+            untagged_size += heapEntry.second.size;
+        }
+    }
+
+    doc["untagged_blocks"] = untagged;
+    doc["untagged_size"] = untagged_size;
+
+    if (doc.overflowed()) {
+        MO_DBG_ERR("exceeded JSON capacity");
+        return -1;
+    }
+
+    return (int)serializeJson(doc, buf, size);
+}
+
 #endif //MO_OVERRIDE_ALLOCATION && MO_ENABLE_HEAP_PROFILER
 
 namespace MicroOcpp {

From 942fb88aa736a5f99d1a24c11fe657c49af2c7ea Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 13 Oct 2024 06:59:47 +0200
Subject: [PATCH 525/549] Generate heap benchmarks automatically (#376)

---
 .github/workflows/documentation.yml      |  98 +++++-
 CHANGELOG.md                             |   2 +-
 docs/benchmarks.md                       |  16 +-
 tests/benchmarks/scripts/measure_heap.py | 391 +++++++++++++++++++++++
 4 files changed, 500 insertions(+), 7 deletions(-)
 create mode 100644 tests/benchmarks/scripts/measure_heap.py

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 27314b72..80f0365c 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -2,7 +2,7 @@
 # Copyright Matthias Akstaller 2019 - 2024
 # MIT License
 
-name: documentation 
+name: Documentation
 on:
   push:
     branches:
@@ -11,8 +11,92 @@ on:
 
 permissions:
   contents: write
+
 jobs:
+  build_simulator:
+    name: Build Simulator
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: 3.x
+    - uses: actions/cache@v2
+      with:
+        key: ${{ github.ref }}
+        path: .cache
+    - name: Get build tools
+      run: |
+        sudo apt update
+        sudo apt install cmake libssl-dev build-essential
+    - name: Checkout Simulator
+      uses: actions/checkout@v3
+      with:
+        repository: matth-x/MicroOcppSimulator
+        path: MicroOcppSimulator
+        ref: feature/remote-api
+        submodules: 'recursive'
+    - name: Clean MicroOcpp submodule
+      run: |
+        rm -rf MicroOcppSimulator/lib/MicroOcpp
+    - name: Checkout MicroOcpp submodule
+      uses: actions/checkout@v3
+      with:
+        path: MicroOcppSimulator/lib/MicroOcpp
+    - name: Generate CMake files
+      run: cmake -S ./MicroOcppSimulator -B ./MicroOcppSimulator/build -DCMAKE_CXX_FLAGS="-DMO_OVERRIDE_ALLOCATION=1 -DMO_ENABLE_HEAP_PROFILER=1"
+    - name: Compile
+      run: cmake --build ./MicroOcppSimulator/build -j 32 --target mo_simulator
+    - name: Upload Simulator executable
+      uses: actions/upload-artifact@v4
+      with:
+        name: Simulator executable
+        path: |
+          MicroOcppSimulator/build/mo_simulator
+          MicroOcppSimulator/public/bundle.html.gz
+        if-no-files-found: error
+        retention-days: 1
+
+  measure_heap:
+    needs: build_simulator
+    name: Heap measurements
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: 3.x
+    - name: Install Python dependencies
+      run: pip install requests paramiko pandas
+    - name: Get Simulator
+      uses: actions/download-artifact@v4
+      with:
+        name: Simulator executable
+        path: MicroOcppSimulator
+    - name: Measure heap and create reports
+      run: |
+        mkdir -p docs/assets/tables
+        python tests/benchmarks/scripts/measure_heap.py
+      env:
+        TEST_DRIVER_URL: ${{ secrets.TEST_DRIVER_URL }}
+        TEST_DRIVER_CONFIG: ${{ secrets.TEST_DRIVER_CONFIG }}
+        TEST_DRIVER_KEY: ${{ secrets.TEST_DRIVER_KEY }}
+        MO_SIM_CONFIG: ${{ secrets.MO_SIM_CONFIG }}
+        MO_SIM_OCPP_SERVER: ${{ secrets.MO_SIM_OCPP_SERVER }}
+        MO_SIM_API_CERT: ${{ secrets.MO_SIM_API_CERT }}
+        MO_SIM_API_KEY: ${{ secrets.MO_SIM_API_KEY }}
+        MO_SIM_API_CONFIG: ${{ secrets.MO_SIM_API_CONFIG }}
+        SSH_LOCAL_PRIV: ${{ secrets.SSH_LOCAL_PRIV }}
+        SSH_HOST_PUB: ${{ secrets.SSH_HOST_PUB }}
+    - name: Upload reports
+      uses: actions/upload-artifact@v4
+      with:
+        name: Memory usage reports CSV
+        path: docs/assets/tables
+        if-no-files-found: error
+
   build_firmware_size:
+    name: Build firmware
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
@@ -51,6 +135,7 @@ jobs:
 
   evaluate_firmware:
     needs: build_firmware_size
+    name: Static firmware analysis
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
@@ -87,8 +172,7 @@ jobs:
         path: firmware
     - name: Run bloaty
       run: |
-        mkdir docs/assets
-        mkdir docs/assets/tables
+        mkdir -p docs/assets/tables
         tools/bloaty/build/bloaty firmware/firmware_v16.elf  -d compileunits --csv -n 0 > docs/assets/tables/bloaty_v16.csv
         tools/bloaty/build/bloaty firmware/firmware_v201.elf -d compileunits --csv -n 0 > docs/assets/tables/bloaty_v201.csv
     - name: Evaluate and create reports
@@ -101,7 +185,8 @@ jobs:
         if-no-files-found: error
 
   deploy:
-    needs: evaluate_firmware
+    needs: [evaluate_firmware, measure_heap]
+    name: Deploy docs
     runs-on: ubuntu-latest
     if: github.ref == 'refs/heads/main'
     steps:
@@ -120,5 +205,10 @@ jobs:
       with:
         name: Firmware size reports CSV
         path: docs/assets/tables
+    - name: Get memory occupation reports
+      uses: actions/download-artifact@v4
+      with:
+        name: Memory usage reports CSV
+        path: docs/assets/tables
     - name: Run mkdocs
       run: mkdocs gh-deploy --force
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 632a44e6..b02743f9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -25,7 +25,7 @@
 - Support for TransactionMessageAttempts/-RetryInterval ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
 - Heap profiler and custom allocator support ([#350](https://github.com/matth-x/MicroOcpp/pull/350))
 - Migration of persistent storage ([#355](https://github.com/matth-x/MicroOcpp/pull/355))
-- Benchmarks pipeline ([#369](https://github.com/matth-x/MicroOcpp/pull/369))
+- Benchmarks pipeline ([#369](https://github.com/matth-x/MicroOcpp/pull/369), [#376](https://github.com/matth-x/MicroOcpp/pull/376))
 - MeterValues port for OCPP 2.0.1 ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
 - UnlockConnector port for OCPP 2.0.1 ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
 - More APIs ported to OCPP 2.0.1 ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
diff --git a/docs/benchmarks.md b/docs/benchmarks.md
index f304dd6f..665930c6 100644
--- a/docs/benchmarks.md
+++ b/docs/benchmarks.md
@@ -34,14 +34,26 @@ The following table shows the cumulated size of the objects files per module. Th
 
 {{ read_csv('modules_v201.csv') }}
 
+## Memory usage
+
+MicroOCPP uses the heap memory to process incoming messages, maintain the device model and create outgoing OCPP messages. The total heap usage should remain low enough to not risk a heap depletion which would not only affect the OCPP module, but the whole controller, because heap memory is typically shared on microcontrollers. To assess the heap usage of MicroOCPP, a test suite runs a variety of simulated charger use cases and measures the maximum occupied memory. Then, the maximum observed value is considered as the memory requirement of MicroOCPP.
+
+Another important figure is the base level which is much closer to the average heap usage. The total heap usage consists of a base level and a dynamic part. Some memory objects are only initialized once during startup or as the device model is populated (e.g. Charging Schedules) and therefore belong to the base which changes only slowly over time. In contrast, objects for the JSON parsing and serialization and the internal execution of the operations are highly dynamic as they are instantiated for one operation and freed again after completion of the action. If the firmware contains multiple components besides MicroOCPP with this usage pattern, then the average total memory occupation of the device RAM is even closer to the base levels of the individual components.
+
+The following table shows the dynamic heap usage for a variety of test cases, followed by the base level and resulting maximum memory occupation of MicroOCPP. At the time being, the measurements are limited to only OCPP 2.0.1 and a narrow set of test cases. They will be gradually extended over time.
+
+**Table 3: Memory usage per use case and total**
+
+{{ read_csv('heap_v201.csv') }}
+
 ## Full data sets
 
 This section contains the raw data which is the basis for the evaluations above.
 
-**Table 3: All compilation units for OCPP 1.6 firmware**
+**Table 4: All compilation units for OCPP 1.6 firmware**
 
 {{ read_csv('compile_units_v16.csv') }}
 
-**Table 4: All compilation units for OCPP 2.0.1 firmware**
+**Table 5: All compilation units for OCPP 2.0.1 firmware**
 
 {{ read_csv('compile_units_v201.csv') }}
diff --git a/tests/benchmarks/scripts/measure_heap.py b/tests/benchmarks/scripts/measure_heap.py
new file mode 100644
index 00000000..3c15b464
--- /dev/null
+++ b/tests/benchmarks/scripts/measure_heap.py
@@ -0,0 +1,391 @@
+import os
+import sys
+import requests
+import paramiko
+import base64
+import traceback
+import io
+import json
+import time
+import pandas as pd
+
+
+requests.packages.urllib3.disable_warnings() # avoid the URL to be printed to console
+
+# Test case selection (commented out a few to simplify testing for now)
+testcase_name_list = [
+    'TC_B_06_CS',
+    #'TC_B_07_CS',
+    #'TC_B_09_CS',
+    'TC_B_10_CS',
+    #'TC_B_11_CS',
+    #'TC_B_12_CS',
+    'TC_B_13_CS',
+    #'TC_B_32_CS',
+    #'TC_B_34_CS',
+    'TC_B_35_CS',
+    #'TC_B_36_CS',
+    #'TC_B_37_CS',
+    'TC_B_39_CS',
+    #'TC_C_02_CS',
+    #'TC_C_04_CS',
+    'TC_C_06_CS',
+    #'TC_C_07_CS',
+    #'TC_C_49_CS',
+    'TC_E_01_CS',
+    #'TC_E_02_CS',
+    #'TC_E_03_CS',
+    'TC_E_04_CS',
+    #'TC_E_05_CS',
+    #'TC_E_06_CS',
+    'TC_E_07_CS',
+    #'TC_E_09_CS',
+    #'TC_E_13_CS',
+    'TC_E_15_CS',
+    #'TC_E_17_CS',
+    #'TC_E_20_CS',
+    'TC_E_21_CS',
+    #'TC_E_24_CS',
+    #'TC_E_25_CS',
+    'TC_E_28_CS',
+    #'TC_E_29_CS',
+    #'TC_E_30_CS',
+    'TC_E_31_CS',
+    #'TC_E_32_CS',
+    #'TC_E_33_CS',
+    'TC_E_34_CS',
+    #'TC_E_35_CS',
+    #'TC_E_39_CS',
+    'TC_F_01_CS',
+    #'TC_F_02_CS',
+    #'TC_F_03_CS',
+    'TC_F_04_CS',
+    #'TC_F_05_CS',
+    #'TC_F_06_CS',
+    'TC_F_07_CS',
+    #'TC_F_08_CS',
+    #'TC_F_09_CS',
+    'TC_F_10_CS',
+    #'TC_F_11_CS',
+    #'TC_F_12_CS',
+    'TC_F_13_CS',
+    #'TC_F_14_CS',
+    #'TC_F_20_CS',
+    'TC_F_23_CS',
+    #'TC_F_24_CS',
+    #'TC_F_26_CS',
+    'TC_F_27_CS',
+    #'TC_G_01_CS',
+    #'TC_G_02_CS',
+    'TC_G_03_CS',
+    #'TC_G_04_CS',
+    #'TC_G_05_CS',
+    'TC_G_06_CS',
+    #'TC_G_07_CS',
+    #'TC_G_08_CS',
+    'TC_G_09_CS',
+    #'TC_G_10_CS',
+    #'TC_G_11_CS',
+    'TC_G_12_CS',
+    #'TC_G_13_CS',
+    #'TC_G_14_CS',
+    'TC_G_15_CS',
+    #'TC_G_16_CS',
+    #'TC_G_17_CS',
+    'TC_J_07_CS',
+    #'TC_J_08_CS',
+    #'TC_J_09_CS',
+    'TC_J_10_CS',
+]
+
+# Result data set
+df = pd.DataFrame(columns=['FN_BLOCK', 'Testcase', 'Pass', 'Heap usage (Bytes)'])
+df.index.names = ['TC_ID']
+
+max_memory_total = 0
+min_memory_base = 1000 * 1000 * 1000
+
+def connect_ssh():
+
+    if not os.path.isfile(os.path.join('tests', 'benchmarks', 'scripts', 'id_ed25519')):
+        file = open(os.path.join('tests', 'benchmarks', 'scripts', 'id_ed25519'), 'w')
+        file.write(os.environ['SSH_LOCAL_PRIV'])
+        file.close()
+        print('SSH ID written to file')
+
+    client = paramiko.SSHClient()
+    client.get_host_keys().add('cicd.micro-ocpp.com', 'ssh-ed25519', paramiko.pkey.PKey.from_type_string('ssh-ed25519', base64.b64decode(os.environ['SSH_HOST_PUB'])))
+    client.connect('cicd.micro-ocpp.com', username='ocpp', key_filename=os.path.join('tests', 'benchmarks', 'scripts', 'id_ed25519'), look_for_keys=False)
+    return client
+
+def close_ssh(client: paramiko.SSHClient):
+
+    client.close()
+
+def deploy_simulator():
+
+    print('Deploy Simulator')
+
+    client = connect_ssh()
+
+    print('   - stop Simulator, if still running')
+    stdin, stdout, stderr = client.exec_command('killall -s SIGINT mo_simulator')
+
+    print('   - clean previous deployment')
+    stdin, stdout, stderr = client.exec_command('rm -rf ' + os.path.join('MicroOcppSimulator'))
+
+    print('   - init folder structure')
+    sftp = client.open_sftp()
+    sftp.mkdir(os.path.join('MicroOcppSimulator'))
+    sftp.mkdir(os.path.join('MicroOcppSimulator', 'build'))
+    sftp.mkdir(os.path.join('MicroOcppSimulator', 'public'))
+    sftp.mkdir(os.path.join('MicroOcppSimulator', 'mo_store'))
+
+    print('   - upload files')
+    sftp.put(  os.path.join('MicroOcppSimulator', 'build', 'mo_simulator'),
+               os.path.join('MicroOcppSimulator', 'build', 'mo_simulator'))
+    sftp.chmod(os.path.join('MicroOcppSimulator', 'build', 'mo_simulator'), 0O777)
+    sftp.put(  os.path.join('MicroOcppSimulator', 'public', 'bundle.html.gz'),
+               os.path.join('MicroOcppSimulator', 'public', 'bundle.html.gz'))
+    sftp.close()
+    close_ssh(client)
+    print('   - done')
+
+def cleanup_simulator():
+
+    print('Clean up Simulator')
+
+    client = connect_ssh()
+
+    print('   - stop Simulator, if still running')
+    stdin, stdout, stderr = client.exec_command('killall -s SIGINT mo_simulator')
+
+    print('   - clean deployment')
+    stdin, stdout, stderr = client.exec_command('rm -rf ' + os.path.join('MicroOcppSimulator'))
+
+    close_ssh(client)
+    print('   - done')
+
+def setup_simulator():
+
+    print('Setup Simulator')
+
+    client = connect_ssh()
+
+    print('   - stop Simulator, if still running')
+    stdin, stdout, stderr = client.exec_command('killall -s SIGINT mo_simulator')
+
+    print('   - clean state')
+    stdin, stdout, stderr = client.exec_command('rm -rf ' + os.path.join('MicroOcppSimulator', 'mo_store', '*'))
+
+    print('   - upload credentials')
+    sftp = client.open_sftp()
+    sftp.putfo(io.StringIO(os.environ['MO_SIM_CONFIG']),     os.path.join('MicroOcppSimulator', 'mo_store', 'simulator.jsn'))
+    sftp.putfo(io.StringIO(os.environ['MO_SIM_OCPP_SERVER']),os.path.join('MicroOcppSimulator', 'mo_store', 'ws-conn.jsn'))
+    sftp.putfo(io.StringIO(os.environ['MO_SIM_API_CERT']),   os.path.join('MicroOcppSimulator', 'mo_store', 'api_cert.pem'))
+    sftp.putfo(io.StringIO(os.environ['MO_SIM_API_KEY']),    os.path.join('MicroOcppSimulator', 'mo_store', 'api_key.pem'))
+    sftp.putfo(io.StringIO(os.environ['MO_SIM_API_CONFIG']), os.path.join('MicroOcppSimulator', 'mo_store', 'api.jsn'))
+    sftp.close()
+
+    print('   - start Simulator')
+
+    stdin, stdout, stderr = client.exec_command('mkdir -p logs && cd ' + os.path.join('MicroOcppSimulator') + ' && ./build/mo_simulator > ~/logs/sim_"$(date +%Y-%m-%d_%H-%M-%S.log)"')
+    close_ssh(client)
+
+    print('   - done')
+
+def run_measurements():
+    
+    global max_memory_total
+    global min_memory_base
+    
+    print("Fetch TCs from Test Driver")
+
+    response = requests.get(os.environ['TEST_DRIVER_URL'] + '/ocpp2.0.1/CS/testcases/' + os.environ['TEST_DRIVER_CONFIG'], 
+                            headers={'Authorization': 'Bearer ' + os.environ['TEST_DRIVER_KEY']},
+                            verify=False)
+
+    #print(json.dumps(response.json(), indent=4))
+
+    testcases = []
+
+    for i in response.json()['data']['testcasesData']:
+        for j in i['data']:
+            is_core = False
+            for k in j['certification_profiles']:
+                if k == 'Core':
+                    is_core = True
+                    break
+
+            select = False
+            for k in testcase_name_list:
+                if j['testcase_name'] == k:
+                    select = True
+                    break
+
+            if select:
+                print(i['header'] + ' --- ' + j['functional_block'] + ' --- ' + j['description'])
+                testcases.append(j)
+
+    deploy_simulator()
+
+    print('Get Simulator base memory data')
+    setup_simulator()
+
+    response = requests.post('https://cicd.micro-ocpp.com:8443/api/memory/reset', 
+                             auth=(json.loads(os.environ['MO_SIM_API_CONFIG'])['user'],
+                                   json.loads(os.environ['MO_SIM_API_CONFIG'])['pass']))
+    print(f'Simulator API /memory/reset:\n > {response.status_code}')
+
+    response = requests.get('https://cicd.micro-ocpp.com:8443/api/memory/info', 
+                             auth=(json.loads(os.environ['MO_SIM_API_CONFIG'])['user'],
+                                   json.loads(os.environ['MO_SIM_API_CONFIG'])['pass']))
+    print(f'Simulator API /memory/info:\n > {response.status_code}, current heap={response.json()["total_current"]}, max heap={response.json()["total_max"]}')
+    base_memory_level = response.json()["total_max"]
+    min_memory_base = min(min_memory_base, response.json()["total_max"])
+
+    print("Start Test Driver")
+
+    response = requests.post(os.environ['TEST_DRIVER_URL'] + '/ocpp2.0.1/CS/session/start/' + os.environ['TEST_DRIVER_CONFIG'], 
+                             headers={'Authorization': 'Bearer ' + os.environ['TEST_DRIVER_KEY']},
+                             verify=False)
+    print(f'Test Driver /*/*/session/start/*:\n > {response.status_code}')
+    #print(json.dumps(response.json(), indent=4))
+
+    for testcase in testcases:
+        print('\nRun ' + testcase['functional_block'] + ' > ' + testcase['description'] + ' (' + testcase['testcase_name'] + ')')
+
+        if testcase['testcase_name'] in df.index:
+            print('Test case already executed - skip')
+            continue
+
+        setup_simulator()
+        time.sleep(1)
+
+        # Check connection
+        simulator_connected = False
+        for i in range(5):
+            response = requests.get(os.environ['TEST_DRIVER_URL'] + '/sut_connection_status', 
+                                    headers={'Authorization': 'Bearer ' + os.environ['TEST_DRIVER_KEY']},
+                                    verify=False)
+            print(f'Test Driver /sut_connection_status:\n > {response.status_code}')
+            #print(json.dumps(response.json(), indent=4))
+            if response.status_code == 200:
+                simulator_connected = True
+                break
+            else:
+                print(f'Waiting for the Simulator to connect ({i}) ...')
+                time.sleep(3)
+        
+        if not simulator_connected:
+            print('Simulator could not connect to Test Driver')
+            raise Exception()
+        
+        response = requests.post('https://cicd.micro-ocpp.com:8443/api/memory/reset', 
+                             auth=(json.loads(os.environ['MO_SIM_API_CONFIG'])['user'],
+                                   json.loads(os.environ['MO_SIM_API_CONFIG'])['pass']))
+        print(f'Simulator API /memory/reset:\n > {response.status_code}')
+        
+        test_response = requests.post(os.environ['TEST_DRIVER_URL'] + '/testcases/' + testcase['testcase_name'] + '/execute', 
+                                 headers={'Authorization': 'Bearer ' + os.environ['TEST_DRIVER_KEY']},
+                                 verify=False)
+        print(f'Test Driver /testcases/{testcase["testcase_name"]}/execute:\n > {test_response.status_code}')
+        #try:
+        #    print(json.dumps(test_response.json(), indent=4))
+        #except:
+        #    print(' > No JSON')
+
+        sim_response = requests.get('https://cicd.micro-ocpp.com:8443/api/memory/info', 
+                             auth=(json.loads(os.environ['MO_SIM_API_CONFIG'])['user'],
+                                   json.loads(os.environ['MO_SIM_API_CONFIG'])['pass']))
+        print(f'Simulator API /memory/info:\n > {sim_response.status_code}, current heap={sim_response.json()["total_current"]}, max heap={sim_response.json()["total_max"]}')
+
+        df.loc[testcase['testcase_name']] = [testcase['functional_block'], testcase['description'], 'x' if test_response.status_code == 200 and test_response.json()['data'][0]['verdict'] == "pass" else '-', str(sim_response.json()["total_max"] - min(base_memory_level, sim_response.json()["total_current"]))]
+
+        max_memory_total = max(max_memory_total, sim_response.json()["total_max"])
+        min_memory_base = min(min_memory_base, sim_response.json()["total_current"])
+
+    print("Stop Test Driver")
+    
+    response = requests.post(os.environ['TEST_DRIVER_URL'] + '/session/stop', 
+                             headers={'Authorization': 'Bearer ' + os.environ['TEST_DRIVER_KEY']},
+                             verify=False)
+    print(f'Test Driver /session/stop:\n > {response.status_code}')
+    #print(json.dumps(response.json(), indent=4))
+
+    cleanup_simulator()
+
+    print('Store test results')
+
+    # Add some meta information
+    max_memory = 0
+    for index, row in df.iterrows():
+        memory = row['Heap usage (Bytes)']
+        if memory.isdigit():
+            max_memory = max(max_memory, int(memory))
+
+    functional_blocks = set()
+    for index, row in df.iterrows():
+        functional_blocks.add(row['FN_BLOCK'])
+
+    print(functional_blocks)
+
+    for i in functional_blocks:
+        df.loc[f'TC_{i[0]}'] = [i, f'**{i}**', ' ', ' ']
+
+    df.loc['|MO_SIM_000'] = ['-', '**Simulator stats**', ' ', ' ']
+    df.loc['|MO_SIM_010'] = ['-', 'Base memory occupation', ' ', str(min_memory_base)]
+    df.loc['|MO_SIM_020'] = ['-', 'Test case maximum', ' ', str(max_memory)]
+    df.loc['|MO_SIM_030'] = ['-', 'Total memory maximum', ' ', str(max_memory_total)]
+
+    df.sort_index(inplace=True)
+    
+    print(df)
+
+    df.to_csv('docs/assets/tables/heap_v201.csv',index=False,columns=['Testcase','Pass','Heap usage (Bytes)'])
+
+    print('Stored test results to CSV')
+
+def run_measurements_and_retry():
+
+    if (    'TEST_DRIVER_URL'    not in os.environ or
+            'TEST_DRIVER_CONFIG' not in os.environ or
+            'TEST_DRIVER_KEY'    not in os.environ or
+            'MO_SIM_CONFIG'      not in os.environ or
+            'MO_SIM_OCPP_SERVER' not in os.environ or
+            'MO_SIM_API_CERT'    not in os.environ or
+            'MO_SIM_API_KEY'     not in os.environ or
+            'MO_SIM_API_CONFIG'  not in os.environ or
+            'SSH_LOCAL_PRIV'     not in os.environ or
+            'SSH_HOST_PUB'       not in os.environ):
+        sys.exit('\nCould not read environment variables')
+
+    n_tries = 3
+
+    for i in range(n_tries):
+
+        try:
+            run_measurements()
+            print('\n **Test cases executed successfully**')
+            break
+        except:
+            print(f'Error detected ({i+1})')
+
+            traceback.print_exc()
+
+            print("Stop Test Driver")    
+            response = requests.post(os.environ['TEST_DRIVER_URL'] + '/session/stop', 
+                                    headers={'Authorization': 'Bearer ' + os.environ['TEST_DRIVER_KEY']},
+                                    verify=False)
+            print(f'Test Driver /session/stop:\n > {response.status_code}')
+            #print(json.dumps(response.json(), indent=4))
+
+            cleanup_simulator()
+
+            if i + 1 < n_tries:
+                print('Retry test cases')
+            else:
+                print('\n **Test case execution aborted**')
+                sys.exit('\nError running test cases')
+
+run_measurements_and_retry()

From fecac0978b5ab29548f97e6384b4b63964ed0e32 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sat, 19 Oct 2024 18:02:25 +0100
Subject: [PATCH 526/549] Add StatusNotification test cases (#377)

---
 tests/ChargingSessions.cpp | 146 +++++++++++++++++++++++++++++++++++++
 1 file changed, 146 insertions(+)

diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index b495494d..bcc2cb69 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -1082,5 +1082,151 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE( checkProcessedStopTx );
     }
 
+    SECTION("StatusNotification") {
+
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials());
+
+        bool checkProcessed = false;
+        const char *checkStatus = "";
+
+        getOcppContext()->getOperationRegistry().setOnRequest("StatusNotification",
+            [&checkProcessed, &checkStatus] (JsonObject payload) {
+                //process req
+                if (payload["connectorId"].as<int>() == 1) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", checkStatus) );
+                }
+            });
+
+        checkStatus = "Available";
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Preparing";
+        checkProcessed = false;
+        setConnectorPluggedInput([] () {return true;});
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Available";
+        checkProcessed = false;
+        setConnectorPluggedInput([] () {return false;});
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Preparing";
+        checkProcessed = false;
+        beginTransaction("mIdTag");
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Available";
+        checkProcessed = false;
+        endTransaction("mIdTag");
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Preparing";
+        beginTransaction("mIdTag");
+        loop();
+        checkProcessed = false;
+
+        checkStatus = "Charging";
+        checkProcessed = false;
+        setConnectorPluggedInput([] () {return true;});
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "SuspendedEV";
+        checkProcessed = false;
+        setEvReadyInput([] () {return false;});
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "SuspendedEVSE";
+        checkProcessed = false;
+        setEvReadyInput([] () {return true;});
+        setEvseReadyInput([] () {return false;});
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Charging";
+        checkProcessed = false;
+        setEvReadyInput([] () {return true;});
+        setEvseReadyInput([] () {return true;});
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Finishing";
+        checkProcessed = false;
+        endTransaction();
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Available";
+        checkProcessed = false;
+        setConnectorPluggedInput([] () {return false;});
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Available";
+        const char *checkStatus2 = checkStatus;
+        checkProcessed = false;
+        mocpp_deinitialize();
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        getOcppContext()->getOperationRegistry().setOnRequest("StatusNotification",
+            [&checkProcessed, &checkStatus, &checkStatus2] (JsonObject payload) {
+                //process req
+                if (payload["connectorId"].as<int>() == 1) {
+                    checkProcessed = true;
+                    REQUIRE( (!strcmp(payload["status"] | "_Undefined", checkStatus) || !strcmp(payload["status"] | "_Undefined", checkStatus2)) );
+                }
+            });
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Charging";
+        checkStatus2 = "Preparing";
+        checkProcessed = false;
+        beginTransaction("mIdTag");
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Charging";
+        checkStatus2 = checkStatus;
+        checkProcessed = false;
+        mocpp_deinitialize();
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        getOcppContext()->getOperationRegistry().setOnRequest("StatusNotification",
+            [&checkProcessed, &checkStatus] (JsonObject payload) {
+                //process req
+                if (payload["connectorId"].as<int>() == 1) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", checkStatus) );
+                }
+            });
+        loop();
+        REQUIRE( checkProcessed );
+
+        checkStatus = "Available";
+        checkStatus2 = checkStatus;
+        checkProcessed = false;
+        endTransaction();
+        mocpp_deinitialize();
+        mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+        getOcppContext()->getOperationRegistry().setOnRequest("StatusNotification",
+            [&checkProcessed, &checkStatus] (JsonObject payload) {
+                //process req
+                if (payload["connectorId"].as<int>() == 1) {
+                    checkProcessed = true;
+                    REQUIRE( !strcmp(payload["status"] | "_Undefined", checkStatus) );
+                }
+            });
+        loop();
+        REQUIRE( checkProcessed );
+    }
+
     mocpp_deinitialize();
 }

From 4b89f4649d65c83cc559e4cc7c65f430db482217 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 3 Nov 2024 11:46:39 +0100
Subject: [PATCH 527/549] Persistent v20.1 Variable and Transactions store
 (#379)

* add persistent Variable store

* add persistent transactions queue

* add further tests

* update changelog

* fix unit tests

* fix unit tests

* fix compiler warning

* rename built-in VariableContainer implementations

* remove leftover debug message

* update WS creds storage location

* pin MOSim version

* update changelog
---
 .github/workflows/documentation.yml           |   2 +-
 CHANGELOG.md                                  |   1 +
 src/MicroOcpp.cpp                             |   3 +-
 src/MicroOcpp/Model/Authorization/IdToken.cpp |   8 +-
 src/MicroOcpp/Model/ConnectorBase/Connector.h |   2 -
 .../Model/Metering/MeterValuesV201.cpp        |  78 +-
 .../RemoteControl/RemoteControlService.cpp    |  29 +-
 .../RemoteControl/RemoteControlService.h      |   2 +-
 src/MicroOcpp/Model/Reset/ResetService.cpp    |   4 +-
 .../Model/Transactions/Transaction.cpp        | 324 +++++++
 .../Model/Transactions/Transaction.h          |  38 +-
 .../Model/Transactions/TransactionService.cpp | 559 ++++++++---
 .../Model/Transactions/TransactionService.h   |  53 +-
 .../Model/Transactions/TransactionStore.cpp   | 893 +++++++++++++++++-
 .../Model/Transactions/TransactionStore.h     |  60 ++
 src/MicroOcpp/Model/Variables/Variable.cpp    |   7 -
 src/MicroOcpp/Model/Variables/Variable.h      |   5 -
 .../Model/Variables/VariableContainer.cpp     | 262 ++++-
 .../Model/Variables/VariableContainer.h       |  82 +-
 .../Model/Variables/VariableService.cpp       | 180 ++--
 .../Model/Variables/VariableService.h         |  50 +-
 .../Operations/RequestStartTransaction.cpp    |   2 +-
 .../Operations/RequestStartTransaction.h      |   1 +
 src/MicroOcpp/Operations/TransactionEvent.cpp | 184 +---
 src/MicroOcpp/Operations/TransactionEvent.h   |   4 +-
 tests/LocalAuthList.cpp                       |   2 -
 tests/Reset.cpp                               |  11 +
 tests/Transactions.cpp                        | 478 +++++++++-
 tests/Variables.cpp                           |  98 +-
 tests/benchmarks/scripts/measure_heap.py      |   2 +-
 30 files changed, 2804 insertions(+), 620 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 80f0365c..888d9121 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -34,7 +34,7 @@ jobs:
       with:
         repository: matth-x/MicroOcppSimulator
         path: MicroOcppSimulator
-        ref: feature/remote-api
+        ref: 20e8da7b76a3f5f3e50facab018a457ecdbcca59
         submodules: 'recursive'
     - name: Clean MicroOcpp submodule
       run: |
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b02743f9..fc31c734 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -30,6 +30,7 @@
 - UnlockConnector port for OCPP 2.0.1 ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
 - More APIs ported to OCPP 2.0.1 ([#371](https://github.com/matth-x/MicroOcpp/pull/371))
 - Support for AuthorizeRemoteTxRequests ([#373](https://github.com/matth-x/MicroOcpp/pull/373))
+- Persistent Variable and Tx store for OCPP 2.0.1 ([#379](https://github.com/matth-x/MicroOcpp/pull/379))
 
 ### Removed
 
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index de8e6ae8..7ca20f3a 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -290,7 +290,7 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
         model.setVariableService(std::unique_ptr<VariableService>(
             new VariableService(*context, filesystem)));
         model.setTransactionService(std::unique_ptr<TransactionService>(
-            new TransactionService(*context)));
+            new TransactionService(*context, filesystem, MO_NUM_EVSEID)));
         model.setRemoteControlService(std::unique_ptr<RemoteControlService>(
             new RemoteControlService(*context, MO_NUM_EVSEID)));
     } else
@@ -852,6 +852,7 @@ void setEvReadyInput(std::function<bool()> evReadyInput, unsigned int connectorI
                 evse->setEvReadyInput(evReadyInput);
             }
         }
+        return;
     }
 #endif
     auto connector = context->getModel().getConnector(connectorId);
diff --git a/src/MicroOcpp/Model/Authorization/IdToken.cpp b/src/MicroOcpp/Model/Authorization/IdToken.cpp
index f6ceec10..e1637ef8 100644
--- a/src/MicroOcpp/Model/Authorization/IdToken.cpp
+++ b/src/MicroOcpp/Model/Authorization/IdToken.cpp
@@ -22,6 +22,8 @@ IdToken::IdToken(const char *token, Type type, const char *memoryTag) : MemoryMa
             MO_DBG_ERR("invalid token");
             *idToken = '\0';
         }
+    } else {
+        *idToken = '\0';
     }
 }
 
@@ -63,11 +65,11 @@ bool IdToken::parseCstr(const char *token, const char *typeCstr) {
 }
 
 const char *IdToken::get() const {
-    return *idToken ? idToken : nullptr;;
+    return idToken;
 }
 
 const char *IdToken::getTypeCstr() const {
-    const char *res = nullptr;
+    const char *res = "";
     switch (type) {
         case Type::UNDEFINED:
             MO_DBG_ERR("internal error");
@@ -98,7 +100,7 @@ const char *IdToken::getTypeCstr() const {
             break;
     }
 
-    return res ? res : "";
+    return res;
 }
 
 bool IdToken::equals(const IdToken& other) {
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 541c1f4c..824e3d3b 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -22,8 +22,6 @@
 #define MO_TXRECORD_SIZE 4 //no. of tx to hold on flash storage
 #endif
 
-#define MAX_TX_CNT 100000U //upper limit of txNr (internal usage). Must be at least 2*MO_TXRECORD_SIZE+1
-
 #ifndef MO_REPORT_NOERROR
 #define MO_REPORT_NOERROR 0
 #endif
diff --git a/src/MicroOcpp/Model/Metering/MeterValuesV201.cpp b/src/MicroOcpp/Model/Metering/MeterValuesV201.cpp
index fc856204..97376774 100644
--- a/src/MicroOcpp/Model/Metering/MeterValuesV201.cpp
+++ b/src/MicroOcpp/Model/Metering/MeterValuesV201.cpp
@@ -288,6 +288,46 @@ bool MeteringServiceEvse::existsMeasurand(const char *measurand, size_t len) {
     return false;
 }
 
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+bool validateSelectString(const char *csl, void *userPtr) {
+    auto mService = static_cast<MeteringService*>(userPtr);
+
+    bool isValid = true;
+    const char *l = csl; //the beginning of an entry of the comma-separated list
+    const char *r = l; //one place after the last character of the entry beginning with l
+    while (*l) {
+        if (*l == ',') {
+            l++;
+            continue;
+        }
+        r = l + 1;
+        while (*r != '\0' && *r != ',') {
+            r++;
+        }
+        bool found = false;
+        for (size_t evseId = 0; evseId < MO_NUM_EVSEID && mService->getEvse(evseId); evseId++) {
+            if (mService->getEvse(evseId)->existsMeasurand(l, (size_t) (r - l))) {
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            isValid = false;
+            MO_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
+            break;
+        }
+        l = r;
+    }
+    return isValid;
+}
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+using namespace MicroOcpp::Ocpp201;
+
 MeteringService::MeteringService(Model& model, size_t numEvses) {
 
     auto varService = model.getVariableService();
@@ -298,40 +338,10 @@ MeteringService::MeteringService(Model& model, size_t numEvses) {
     varService->declareVariable<const char*>("SampledDataCtrlr", "TxEndedMeasurands", "");
     varService->declareVariable<const char*>("AlignedDataCtrlr", "AlignedDataMeasurands", "");
 
-    std::function<bool(const char*)> validateSelectString = [this] (const char *csl) {
-        bool isValid = true;
-        const char *l = csl; //the beginning of an entry of the comma-separated list
-        const char *r = l; //one place after the last character of the entry beginning with l
-        while (*l) {
-            if (*l == ',') {
-                l++;
-                continue;
-            }
-            r = l + 1;
-            while (*r != '\0' && *r != ',') {
-                r++;
-            }
-            bool found = false;
-            for (size_t evseId = 0; evseId < MO_NUM_EVSEID && evses[evseId]; evseId++) {
-                if (evses[evseId]->existsMeasurand(l, (size_t) (r - l))) {
-                    found = true;
-                    break;
-                }
-            }
-            if (!found) {
-                isValid = false;
-                MO_DBG_WARN("could not find metering device for %.*s", (int) (r - l), l);
-                break;
-            }
-            l = r;
-        }
-        return isValid;
-    };
-
-    varService->registerValidator<const char*>("SampledDataCtrlr", "TxStartedMeasurands", validateSelectString);
-    varService->registerValidator<const char*>("SampledDataCtrlr", "TxUpdatedMeasurands", validateSelectString);
-    varService->registerValidator<const char*>("SampledDataCtrlr", "TxEndedMeasurands", validateSelectString);
-    varService->registerValidator<const char*>("AlignedDataCtrlr", "AlignedDataMeasurands", validateSelectString);
+    varService->registerValidator<const char*>("SampledDataCtrlr", "TxStartedMeasurands", validateSelectString, this);
+    varService->registerValidator<const char*>("SampledDataCtrlr", "TxUpdatedMeasurands", validateSelectString, this);
+    varService->registerValidator<const char*>("SampledDataCtrlr", "TxEndedMeasurands", validateSelectString, this);
+    varService->registerValidator<const char*>("AlignedDataCtrlr", "AlignedDataMeasurands", validateSelectString, this);
 
     for (size_t evseId = 0; evseId < std::min(numEvses, (size_t)MO_NUM_EVSEID); evseId++) {
         evses[evseId] = new MeteringServiceEvse(model, evseId);
diff --git a/src/MicroOcpp/Model/RemoteControl/RemoteControlService.cpp b/src/MicroOcpp/Model/RemoteControl/RemoteControlService.cpp
index 7d49d2bc..74aefe0f 100644
--- a/src/MicroOcpp/Model/RemoteControl/RemoteControlService.cpp
+++ b/src/MicroOcpp/Model/RemoteControl/RemoteControlService.cpp
@@ -40,7 +40,7 @@ UnlockStatus RemoteControlServiceEvse::unlockConnector() {
                 if (tx->started && !tx->stopped && tx->isAuthorized) {
                     return UnlockStatus_OngoingAuthorizedTransaction;
                 } else {
-                    evse->abortTransaction(Ocpp201::Transaction::StopReason::Other,Ocpp201::TransactionEventTriggerReason::UnlockCommand);
+                    evse->abortTransaction(Ocpp201::Transaction::StoppedReason::Other,Ocpp201::TransactionEventTriggerReason::UnlockCommand);
                 }
             }
         }
@@ -102,7 +102,7 @@ RemoteControlServiceEvse *RemoteControlService::getEvse(unsigned int evseId) {
     return evses[evseId];
 }
 
-RequestStartStopStatus RemoteControlService::requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, std::shared_ptr<Ocpp201::Transaction>& transactionOut) {
+RequestStartStopStatus RemoteControlService::requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, char *transactionIdOut, size_t transactionIdBufSize) {
     
     TransactionService *txService = context.getModel().getTransactionService();
     if (!txService) {
@@ -116,21 +116,32 @@ RequestStartStopStatus RemoteControlService::requestStartTransaction(unsigned in
         return RequestStartStopStatus_Rejected;
     }
 
-    transactionOut = evse->getTransaction();
-
     if (!evse->beginAuthorization(idToken, authorizeRemoteStart->getBool())) {
         MO_DBG_INFO("EVSE still occupied with pending tx");
+        if (auto tx = evse->getTransaction()) {
+            auto ret = snprintf(transactionIdOut, transactionIdBufSize, "%s", tx->transactionId);
+            if (ret < 0 || (size_t)ret >= transactionIdBufSize) {
+                MO_DBG_ERR("internal error");
+                return RequestStartStopStatus_Rejected;
+            }
+        }
+        return RequestStartStopStatus_Rejected;
+    }
+
+    auto tx = evse->getTransaction();
+    if (!tx) {
+        MO_DBG_ERR("internal error");
         return RequestStartStopStatus_Rejected;
     }
 
-    transactionOut = evse->getTransaction();
-    if (!transactionOut) {
+    auto ret = snprintf(transactionIdOut, transactionIdBufSize, "%s", tx->transactionId);
+    if (ret < 0 || (size_t)ret >= transactionIdBufSize) {
         MO_DBG_ERR("internal error");
         return RequestStartStopStatus_Rejected;
     }
 
-    transactionOut->remoteStartId = remoteStartId;
-    transactionOut->notifyRemoteStartId = true;
+    tx->remoteStartId = remoteStartId;
+    tx->notifyRemoteStartId = true;
 
     return RequestStartStopStatus_Accepted;
 }
@@ -148,7 +159,7 @@ RequestStartStopStatus RemoteControlService::requestStopTransaction(const char *
     for (unsigned int evseId = 0; evseId < MO_NUM_EVSEID; evseId++) {
         if (auto evse = txService->getEvse(evseId)) {
             if (evse->getTransaction() && !strcmp(evse->getTransaction()->transactionId, transactionId)) {
-                success = evse->abortTransaction(Ocpp201::Transaction::StopReason::Remote, Ocpp201::TransactionEventTriggerReason::RemoteStop);
+                success = evse->abortTransaction(Ocpp201::Transaction::StoppedReason::Remote, Ocpp201::TransactionEventTriggerReason::RemoteStop);
                 break;
             }
         }
diff --git a/src/MicroOcpp/Model/RemoteControl/RemoteControlService.h b/src/MicroOcpp/Model/RemoteControl/RemoteControlService.h
index a19adcc7..0a26567b 100644
--- a/src/MicroOcpp/Model/RemoteControl/RemoteControlService.h
+++ b/src/MicroOcpp/Model/RemoteControl/RemoteControlService.h
@@ -53,7 +53,7 @@ class RemoteControlService : public MemoryManaged {
 
     RemoteControlServiceEvse *getEvse(unsigned int evseId);
 
-    RequestStartStopStatus requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, std::shared_ptr<Ocpp201::Transaction>& transactionOut); //ChargingProfile, GroupIdToken not supported yet
+    RequestStartStopStatus requestStartTransaction(unsigned int evseId, unsigned int remoteStartId, IdToken idToken, char *transactionIdOut, size_t transactionIdBufSize); //ChargingProfile, GroupIdToken not supported yet
 
     RequestStartStopStatus requestStopTransaction(const char *transactionId);
 };
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index e20c8b30..8335ce42 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -125,7 +125,7 @@ ResetService::~ResetService() {
 
 ResetService::Evse::Evse(Context& context, ResetService& resetService, unsigned int evseId) : context(context), resetService(resetService), evseId(evseId) {
     auto varService = context.getModel().getVariableService();
-    varService->declareVariable<bool>(ComponentId("EVSE", evseId >= 1 ? evseId : -1), "AllowReset", true, MO_VARIABLE_FN, Variable::Mutability::ReadOnly);
+    varService->declareVariable<bool>(ComponentId("EVSE", evseId >= 1 ? evseId : -1), "AllowReset", true, Variable::Mutability::ReadOnly, false);
 }
 
 void ResetService::Evse::loop() {
@@ -303,7 +303,7 @@ ResetStatus ResetService::initiateReset(ResetType type, unsigned int evseId) {
             if (tx->active) {
                 //Tx in progress. Check behavior
                 if (type == ResetType_Immediate) {
-                    txService->getEvse(eId)->abortTransaction(Transaction::StopReason::ImmediateReset, TransactionEventTriggerReason::ResetCommand);
+                    txService->getEvse(eId)->abortTransaction(Transaction::StoppedReason::ImmediateReset, TransactionEventTriggerReason::ResetCommand);
                 } else {
                     scheduled = true;
                     break;
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.cpp b/src/MicroOcpp/Model/Transactions/Transaction.cpp
index 333da16e..bd21db2e 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.cpp
+++ b/src/MicroOcpp/Model/Transactions/Transaction.cpp
@@ -4,6 +4,7 @@
 
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/Transactions/TransactionStore.h>
+#include <MicroOcpp/Debug.h>
 
 using namespace MicroOcpp;
 
@@ -31,6 +32,329 @@ bool Transaction::commit() {
     return context.commit(this);
 }
 
+#if MO_ENABLE_V201
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+const char *serializeTransactionStoppedReason(Transaction::StoppedReason stoppedReason) {
+    const char *stoppedReasonCstr = nullptr;
+    switch (stoppedReason) {
+        case Transaction::StoppedReason::UNDEFINED:
+            // optional, okay
+            break;
+        case Transaction::StoppedReason::Local:
+            stoppedReasonCstr = "Local";
+            break;
+        case Transaction::StoppedReason::DeAuthorized:
+            stoppedReasonCstr = "DeAuthorized";
+            break;
+        case Transaction::StoppedReason::EmergencyStop:
+            stoppedReasonCstr = "EmergencyStop";
+            break;
+        case Transaction::StoppedReason::EnergyLimitReached:
+            stoppedReasonCstr = "EnergyLimitReached";
+            break;
+        case Transaction::StoppedReason::EVDisconnected:
+            stoppedReasonCstr = "EVDisconnected";
+            break;
+        case Transaction::StoppedReason::GroundFault:
+            stoppedReasonCstr = "GroundFault";
+            break;
+        case Transaction::StoppedReason::ImmediateReset:
+            stoppedReasonCstr = "ImmediateReset";
+            break;
+        case Transaction::StoppedReason::LocalOutOfCredit:
+            stoppedReasonCstr = "LocalOutOfCredit";
+            break;
+        case Transaction::StoppedReason::MasterPass:
+            stoppedReasonCstr = "MasterPass";
+            break;
+        case Transaction::StoppedReason::Other:
+            stoppedReasonCstr = "Other";
+            break;
+        case Transaction::StoppedReason::OvercurrentFault:
+            stoppedReasonCstr = "OvercurrentFault";
+            break;
+        case Transaction::StoppedReason::PowerLoss:
+            stoppedReasonCstr = "PowerLoss";
+            break;
+        case Transaction::StoppedReason::PowerQuality:
+            stoppedReasonCstr = "PowerQuality";
+            break;
+        case Transaction::StoppedReason::Reboot:
+            stoppedReasonCstr = "Reboot";
+            break;
+        case Transaction::StoppedReason::Remote:
+            stoppedReasonCstr = "Remote";
+            break;
+        case Transaction::StoppedReason::SOCLimitReached:
+            stoppedReasonCstr = "SOCLimitReached";
+            break;
+        case Transaction::StoppedReason::StoppedByEV:
+            stoppedReasonCstr = "StoppedByEV";
+            break;
+        case Transaction::StoppedReason::TimeLimitReached:
+            stoppedReasonCstr = "TimeLimitReached";
+            break;
+        case Transaction::StoppedReason::Timeout:
+            stoppedReasonCstr = "Timeout";
+            break;
+    }
+
+    return stoppedReasonCstr;
+}
+bool deserializeTransactionStoppedReason(const char *stoppedReasonCstr, Transaction::StoppedReason& stoppedReasonOut) {
+    if (!stoppedReasonCstr || !*stoppedReasonCstr) {
+        stoppedReasonOut = Transaction::StoppedReason::UNDEFINED;
+    } else if (!strcmp(stoppedReasonCstr, "DeAuthorized")) {
+        stoppedReasonOut = Transaction::StoppedReason::DeAuthorized;
+    } else if (!strcmp(stoppedReasonCstr, "EmergencyStop")) {
+        stoppedReasonOut = Transaction::StoppedReason::EmergencyStop;
+    } else if (!strcmp(stoppedReasonCstr, "EnergyLimitReached")) {
+        stoppedReasonOut = Transaction::StoppedReason::EnergyLimitReached;
+    } else if (!strcmp(stoppedReasonCstr, "EVDisconnected")) {
+        stoppedReasonOut = Transaction::StoppedReason::EVDisconnected;
+    } else if (!strcmp(stoppedReasonCstr, "GroundFault")) {
+        stoppedReasonOut = Transaction::StoppedReason::GroundFault;
+    } else if (!strcmp(stoppedReasonCstr, "ImmediateReset")) {
+        stoppedReasonOut = Transaction::StoppedReason::ImmediateReset;
+    } else if (!strcmp(stoppedReasonCstr, "Local")) {
+        stoppedReasonOut = Transaction::StoppedReason::Local;
+    } else if (!strcmp(stoppedReasonCstr, "LocalOutOfCredit")) {
+        stoppedReasonOut = Transaction::StoppedReason::LocalOutOfCredit;
+    } else if (!strcmp(stoppedReasonCstr, "MasterPass")) {
+        stoppedReasonOut = Transaction::StoppedReason::MasterPass;
+    } else if (!strcmp(stoppedReasonCstr, "Other")) {
+        stoppedReasonOut = Transaction::StoppedReason::Other;
+    } else if (!strcmp(stoppedReasonCstr, "OvercurrentFault")) {
+        stoppedReasonOut = Transaction::StoppedReason::OvercurrentFault;
+    } else if (!strcmp(stoppedReasonCstr, "PowerLoss")) {
+        stoppedReasonOut = Transaction::StoppedReason::PowerLoss;
+    } else if (!strcmp(stoppedReasonCstr, "PowerQuality")) {
+        stoppedReasonOut = Transaction::StoppedReason::PowerQuality;
+    } else if (!strcmp(stoppedReasonCstr, "Reboot")) {
+        stoppedReasonOut = Transaction::StoppedReason::Reboot;
+    } else if (!strcmp(stoppedReasonCstr, "Remote")) {
+        stoppedReasonOut = Transaction::StoppedReason::Remote;
+    } else if (!strcmp(stoppedReasonCstr, "SOCLimitReached")) {
+        stoppedReasonOut = Transaction::StoppedReason::SOCLimitReached;
+    } else if (!strcmp(stoppedReasonCstr, "StoppedByEV")) {
+        stoppedReasonOut = Transaction::StoppedReason::StoppedByEV;
+    } else if (!strcmp(stoppedReasonCstr, "TimeLimitReached")) {
+        stoppedReasonOut = Transaction::StoppedReason::TimeLimitReached;
+    } else if (!strcmp(stoppedReasonCstr, "Timeout")) {
+        stoppedReasonOut = Transaction::StoppedReason::Timeout;
+    } else {
+        MO_DBG_ERR("deserialization error");
+        return false;
+    }
+    return true;
+}
+
+const char *serializeTransactionEventType(TransactionEventData::Type type) {
+    const char *typeCstr = "";
+    switch (type) {
+        case TransactionEventData::Type::Ended:
+            typeCstr = "Ended";
+            break;
+        case TransactionEventData::Type::Started:
+            typeCstr = "Started";
+            break;
+        case TransactionEventData::Type::Updated:
+            typeCstr = "Updated";
+            break;
+    }
+    return typeCstr;
+}
+bool deserializeTransactionEventType(const char *typeCstr, TransactionEventData::Type& typeOut) {
+    if (!strcmp(typeCstr, "Ended")) {
+        typeOut = TransactionEventData::Type::Ended;
+    } else if (!strcmp(typeCstr, "Started")) {
+        typeOut = TransactionEventData::Type::Started;
+    } else if (!strcmp(typeCstr, "Updated")) {
+        typeOut = TransactionEventData::Type::Updated;
+    } else {
+        MO_DBG_ERR("deserialization error");
+        return false;
+    }
+    return true;
+}
+
+const char *serializeTransactionEventTriggerReason(TransactionEventTriggerReason triggerReason) {
+
+    const char *triggerReasonCstr = nullptr;
+    switch(triggerReason) {
+        case TransactionEventTriggerReason::UNDEFINED:
+            break;
+        case TransactionEventTriggerReason::Authorized:
+            triggerReasonCstr = "Authorized";
+            break;
+        case TransactionEventTriggerReason::CablePluggedIn:
+            triggerReasonCstr = "CablePluggedIn";
+            break;
+        case TransactionEventTriggerReason::ChargingRateChanged:
+            triggerReasonCstr = "ChargingRateChanged";
+            break;
+        case TransactionEventTriggerReason::ChargingStateChanged:
+            triggerReasonCstr = "ChargingStateChanged";
+            break;
+        case TransactionEventTriggerReason::Deauthorized:
+            triggerReasonCstr = "Deauthorized";
+            break;
+        case TransactionEventTriggerReason::EnergyLimitReached:
+            triggerReasonCstr = "EnergyLimitReached";
+            break;
+        case TransactionEventTriggerReason::EVCommunicationLost:
+            triggerReasonCstr = "EVCommunicationLost";
+            break;
+        case TransactionEventTriggerReason::EVConnectTimeout:
+            triggerReasonCstr = "EVConnectTimeout";
+            break;
+        case TransactionEventTriggerReason::MeterValueClock:
+            triggerReasonCstr = "MeterValueClock";
+            break;
+        case TransactionEventTriggerReason::MeterValuePeriodic:
+            triggerReasonCstr = "MeterValuePeriodic";
+            break;
+        case TransactionEventTriggerReason::TimeLimitReached:
+            triggerReasonCstr = "TimeLimitReached";
+            break;
+        case TransactionEventTriggerReason::Trigger:
+            triggerReasonCstr = "Trigger";
+            break;
+        case TransactionEventTriggerReason::UnlockCommand:
+            triggerReasonCstr = "UnlockCommand";
+            break;
+        case TransactionEventTriggerReason::StopAuthorized:
+            triggerReasonCstr = "StopAuthorized";
+            break;
+        case TransactionEventTriggerReason::EVDeparted:
+            triggerReasonCstr = "EVDeparted";
+            break;
+        case TransactionEventTriggerReason::EVDetected:
+            triggerReasonCstr = "EVDetected";
+            break;
+        case TransactionEventTriggerReason::RemoteStop:
+            triggerReasonCstr = "RemoteStop";
+            break;
+        case TransactionEventTriggerReason::RemoteStart:
+            triggerReasonCstr = "RemoteStart";
+            break;
+        case TransactionEventTriggerReason::AbnormalCondition:
+            triggerReasonCstr = "AbnormalCondition";
+            break;
+        case TransactionEventTriggerReason::SignedDataReceived:
+            triggerReasonCstr = "SignedDataReceived";
+            break;
+        case TransactionEventTriggerReason::ResetCommand:
+            triggerReasonCstr = "ResetCommand";
+            break;
+    }
+
+    return triggerReasonCstr;
+}
+bool deserializeTransactionEventTriggerReason(const char *triggerReasonCstr, TransactionEventTriggerReason& triggerReasonOut) {
+    if (!triggerReasonCstr || !*triggerReasonCstr) {
+        triggerReasonOut = TransactionEventTriggerReason::UNDEFINED;
+    } else if (!strcmp(triggerReasonCstr, "Authorized")) {
+        triggerReasonOut = TransactionEventTriggerReason::Authorized;
+    } else if (!strcmp(triggerReasonCstr, "CablePluggedIn")) {
+        triggerReasonOut = TransactionEventTriggerReason::CablePluggedIn;
+    } else if (!strcmp(triggerReasonCstr, "ChargingRateChanged")) {
+        triggerReasonOut = TransactionEventTriggerReason::ChargingRateChanged;
+    } else if (!strcmp(triggerReasonCstr, "ChargingStateChanged")) {
+        triggerReasonOut = TransactionEventTriggerReason::ChargingStateChanged;
+    } else if (!strcmp(triggerReasonCstr, "Deauthorized")) {
+        triggerReasonOut = TransactionEventTriggerReason::Deauthorized;
+    } else if (!strcmp(triggerReasonCstr, "EnergyLimitReached")) {
+        triggerReasonOut = TransactionEventTriggerReason::EnergyLimitReached;
+    } else if (!strcmp(triggerReasonCstr, "EVCommunicationLost")) {
+        triggerReasonOut = TransactionEventTriggerReason::EVCommunicationLost;
+    } else if (!strcmp(triggerReasonCstr, "EVConnectTimeout")) {
+        triggerReasonOut = TransactionEventTriggerReason::EVConnectTimeout;
+    } else if (!strcmp(triggerReasonCstr, "MeterValueClock")) {
+        triggerReasonOut = TransactionEventTriggerReason::MeterValueClock;
+    } else if (!strcmp(triggerReasonCstr, "MeterValuePeriodic")) {
+        triggerReasonOut = TransactionEventTriggerReason::MeterValuePeriodic;
+    } else if (!strcmp(triggerReasonCstr, "TimeLimitReached")) {
+        triggerReasonOut = TransactionEventTriggerReason::TimeLimitReached;
+    } else if (!strcmp(triggerReasonCstr, "Trigger")) {
+        triggerReasonOut = TransactionEventTriggerReason::Trigger;
+    } else if (!strcmp(triggerReasonCstr, "UnlockCommand")) {
+        triggerReasonOut = TransactionEventTriggerReason::UnlockCommand;
+    } else if (!strcmp(triggerReasonCstr, "StopAuthorized")) {
+        triggerReasonOut = TransactionEventTriggerReason::StopAuthorized;
+    } else if (!strcmp(triggerReasonCstr, "EVDeparted")) {
+        triggerReasonOut = TransactionEventTriggerReason::EVDeparted;
+    } else if (!strcmp(triggerReasonCstr, "EVDetected")) {
+        triggerReasonOut = TransactionEventTriggerReason::EVDetected;
+    } else if (!strcmp(triggerReasonCstr, "RemoteStop")) {
+        triggerReasonOut = TransactionEventTriggerReason::RemoteStop;
+    } else if (!strcmp(triggerReasonCstr, "RemoteStart")) {
+        triggerReasonOut = TransactionEventTriggerReason::RemoteStart;
+    } else if (!strcmp(triggerReasonCstr, "AbnormalCondition")) {
+        triggerReasonOut = TransactionEventTriggerReason::AbnormalCondition;
+    } else if (!strcmp(triggerReasonCstr, "SignedDataReceived")) {
+        triggerReasonOut = TransactionEventTriggerReason::SignedDataReceived;
+    } else if (!strcmp(triggerReasonCstr, "ResetCommand")) {
+        triggerReasonOut = TransactionEventTriggerReason::ResetCommand;
+    } else {
+        MO_DBG_ERR("deserialization error");
+        return false;
+    }
+    return true;
+}
+
+const char *serializeTransactionEventChargingState(TransactionEventData::ChargingState chargingState) {
+    const char *chargingStateCstr = nullptr;
+    switch (chargingState) {
+        case TransactionEventData::ChargingState::UNDEFINED:
+            // optional, okay
+            break;
+        case TransactionEventData::ChargingState::Charging:
+            chargingStateCstr = "Charging";
+            break;
+        case TransactionEventData::ChargingState::EVConnected:
+            chargingStateCstr = "EVConnected";
+            break;
+        case TransactionEventData::ChargingState::SuspendedEV:
+            chargingStateCstr = "SuspendedEV";
+            break;
+        case TransactionEventData::ChargingState::SuspendedEVSE:
+            chargingStateCstr = "SuspendedEVSE";
+            break;
+        case TransactionEventData::ChargingState::Idle:
+            chargingStateCstr = "Idle";
+            break;
+    }
+    return chargingStateCstr;
+}
+bool deserializeTransactionEventChargingState(const char *chargingStateCstr, TransactionEventData::ChargingState& chargingStateOut) {
+    if (!chargingStateCstr || !*chargingStateCstr) {
+        chargingStateOut = TransactionEventData::ChargingState::UNDEFINED;
+    } else if (!strcmp(chargingStateCstr, "Charging")) {
+        chargingStateOut = TransactionEventData::ChargingState::Charging;
+    } else if (!strcmp(chargingStateCstr, "EVConnected")) {
+        chargingStateOut = TransactionEventData::ChargingState::EVConnected;
+    } else if (!strcmp(chargingStateCstr, "SuspendedEV")) {
+        chargingStateOut = TransactionEventData::ChargingState::SuspendedEV;
+    } else if (!strcmp(chargingStateCstr, "SuspendedEVSE")) {
+        chargingStateOut = TransactionEventData::ChargingState::SuspendedEVSE;
+    } else if (!strcmp(chargingStateCstr, "Idle")) {
+        chargingStateOut = TransactionEventData::ChargingState::Idle;
+    } else {
+        MO_DBG_ERR("deserialization error");
+        return false;
+    }
+    return true;
+}
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
 int ocpp_tx_getTransactionId(OCPP_Transaction *tx) {
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getTransactionId();
 }
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index bf8a058c..c9d0d80a 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -11,6 +11,8 @@
 #include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Operations/CiStrings.h>
 
+#define MAX_TX_CNT 100000U //upper limit of txNr (internal usage). Must be at least 2*MO_TXRECORD_SIZE+1
+
 namespace MicroOcpp {
 
 /*
@@ -233,7 +235,7 @@ class Transaction : public MemoryManaged {
 public:
 
     // ReasonEnumType (3.67)
-    enum class StopReason : uint8_t {
+    enum class StoppedReason : uint8_t {
         UNDEFINED, // not part of OCPP
         DeAuthorized,
         EmergencyStop,
@@ -273,7 +275,6 @@ class Transaction : public MemoryManaged {
     bool active = true; //once active is false, the tx must stop (or cannot start at all)
     bool started = false; //if a TxEvent with event type TxStarted has been initiated
     bool stopped = false; //if a TxEvent with event type TxEnded has been initiated
-    bool stoppedConfirmed = false; //if all TxEvents have been sent to the server (acknowledged or aborted)
 
     /*
      * Global transaction data
@@ -281,7 +282,6 @@ class Transaction : public MemoryManaged {
     bool isAuthorizationActive = false; //period between beginAuthorization and endAuthorization
     bool isAuthorized = false;    //if the given idToken was authorized
     bool isDeauthorized = false;  //if the server revoked a local authorization
-    unsigned int seqNoCounter = 0; // increment by 1 for each event
     IdToken idToken;
     Timestamp beginTimestamp = MIN_TIME;
     char transactionId [MO_TXID_LEN_MAX + 1] = {'\0'};
@@ -297,7 +297,7 @@ class Transaction : public MemoryManaged {
 
     bool evConnectionTimeoutListen = true;
 
-    StopReason stopReason = StopReason::UNDEFINED;
+    StoppedReason stoppedReason = StoppedReason::UNDEFINED;
     TransactionEventTriggerReason stopTrigger = TransactionEventTriggerReason::UNDEFINED;
     std::unique_ptr<IdToken> stopIdToken; // if null, then stopIdToken equals idToken
 
@@ -316,9 +316,15 @@ class Transaction : public MemoryManaged {
     unsigned int evseId = 0;
     unsigned int txNr = 0; //internal key attribute (!= transactionId); {evseId*txNr} is unique key
 
+    unsigned int seqNoEnd = 0; // increment by 1 for each event
+    Vector<unsigned int> seqNos; //track stored txEvents
+
     bool silent = false; //silent Tx: process tx locally, without reporting to the server
 
-    Transaction() : MemoryManaged("v201.Transactions.Transaction"), sampledDataTxEnded(makeVector<std::unique_ptr<Ocpp201::MeterValue>>(getMemoryTag())) { }
+    Transaction() :
+            MemoryManaged("v201.Transactions.Transaction"),
+            sampledDataTxEnded(makeVector<std::unique_ptr<Ocpp201::MeterValue>>(getMemoryTag())),
+            seqNos(makeVector<unsigned int>(getMemoryTag())) { }
 
     void addSampledDataTxEnded(std::unique_ptr<Ocpp201::MeterValue> mv) {
         if (sampledDataTxEnded.size() >= MO_SAMPLEDDATATXENDED_SIZE_MAX) {
@@ -365,9 +371,10 @@ class TransactionEventData : public MemoryManaged {
     };
 
 //private:
-    std::shared_ptr<Transaction> transaction;
+    Transaction *transaction;
     Type eventType;
     Timestamp timestamp;
+    uint16_t bootNr = 0;
     TransactionEventTriggerReason triggerReason;
     const unsigned int seqNo;
     bool offline = false;
@@ -383,10 +390,27 @@ class TransactionEventData : public MemoryManaged {
     EvseId evse = -1;
     //meterValue not supported
     Vector<std::unique_ptr<MeterValue>> meterValue;
+    
+    unsigned int opNr = 0;
+    unsigned int attemptNr = 0;
+    Timestamp attemptTime = MIN_TIME;
 
-    TransactionEventData(std::shared_ptr<Transaction> transaction, unsigned int seqNo) : MemoryManaged("v201.Transactions.TransactionEventData"), transaction(transaction), seqNo(seqNo), meterValue(makeVector<std::unique_ptr<MeterValue>>(getMemoryTag())) { }
+    TransactionEventData(Transaction *transaction, unsigned int seqNo) : MemoryManaged("v201.Transactions.TransactionEventData"), transaction(transaction), seqNo(seqNo), meterValue(makeVector<std::unique_ptr<MeterValue>>(getMemoryTag())) { }
 };
 
+const char *serializeTransactionStoppedReason(Transaction::StoppedReason stoppedReason);
+bool deserializeTransactionStoppedReason(const char *stoppedReasonCstr, Transaction::StoppedReason& stoppedReasonOut);
+
+const char *serializeTransactionEventType(TransactionEventData::Type type);
+bool deserializeTransactionEventType(const char *typeCstr, TransactionEventData::Type& typeOut);
+
+const char *serializeTransactionEventTriggerReason(TransactionEventTriggerReason triggerReason);
+bool deserializeTransactionEventTriggerReason(const char *triggerReasonCstr, TransactionEventTriggerReason& triggerReasonOut);
+
+const char *serializeTransactionEventChargingState(TransactionEventData::ChargingState chargingState);
+bool deserializeTransactionEventChargingState(const char *chargingStateCstr, TransactionEventData::ChargingState& chargingStateOut);
+
+
 } // namespace Ocpp201
 } // namespace MicroOcpp
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index 7f74e7be..be9fb72a 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -11,35 +11,56 @@
 #include <string.h>
 
 #include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
 #include <MicroOcpp/Core/Request.h>
 #include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Model/Variables/VariableService.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
 #include <MicroOcpp/Operations/Authorize.h>
 #include <MicroOcpp/Operations/TransactionEvent.h>
 #include <MicroOcpp/Operations/RequestStartTransaction.h>
 #include <MicroOcpp/Operations/RequestStopTransaction.h>
 #include <MicroOcpp/Debug.h>
 
+#ifndef MO_TX_CLEAN_ABORTED
+#define MO_TX_CLEAN_ABORTED 1
+#endif
+
 using namespace MicroOcpp;
 using namespace MicroOcpp::Ocpp201;
 
-TransactionService::Evse::Evse(Context& context, TransactionService& txService, unsigned int evseId) :
+TransactionService::Evse::Evse(Context& context, TransactionService& txService, Ocpp201::TransactionStoreEvse& txStore, unsigned int evseId) :
         MemoryManaged("v201.Transactions.TransactionServiceEvse"),
         context(context),
         txService(txService),
+        txStore(txStore),
         evseId(evseId) {
 
+    context.getRequestQueue().addSendQueue(this); //register at RequestQueue as Request emitter
+
+    txStore.discoverStoredTx(txNrBegin, txNrEnd); //initializes txNrBegin and txNrEnd
+    txNrFront = txNrBegin;
+    MO_DBG_DEBUG("found %u transactions for evseId %u. Internal range from %u to %u (exclusive)", (txNrEnd + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT, evseId, txNrBegin, txNrEnd);
+
+    unsigned int txNrLatest = (txNrEnd + MAX_TX_CNT - 1) % MAX_TX_CNT; //txNr of the most recent tx on flash
+    transaction = txStore.loadTransaction(txNrLatest); //returns nullptr if txNrLatest does not exist on flash
 }
 
-std::unique_ptr<Ocpp201::Transaction> TransactionService::Evse::allocateTransaction() {
-    auto tx =  std::unique_ptr<Ocpp201::Transaction>(new Ocpp201::Transaction());
-    if (!tx) {
-        // OOM
-        return nullptr;
+TransactionService::Evse::~Evse() {
+    
+}
+
+bool TransactionService::Evse::beginTransaction() {
+
+    if (transaction) {
+        MO_DBG_ERR("transaction still running");
+        return false;
     }
 
-    tx->evseId = evseId;
-    tx->txNr = txNrCounter;
+    std::unique_ptr<Ocpp201::Transaction> tx;
+
+    char txId [sizeof(Ocpp201::Transaction::transactionId)];
 
     //simple clock-based hash
     int v = context.getModel().getClock().now() - Timestamp(2020,0,0,0,0,0);
@@ -48,27 +69,178 @@ std::unique_ptr<Ocpp201::Transaction> TransactionService::Evse::allocateTransact
     h *= 749572633U;
     h %= 24593209U;
     for (size_t i = 0; i < sizeof(tx->transactionId) - 3; i += 2) {
-        snprintf(tx->transactionId + i, 3, "%02X", (uint8_t)h);
+        snprintf(txId + i, 3, "%02X", (uint8_t)h);
         h *= 749572633U;
         h %= 24593209U;
     }
 
+    //clean possible aborted tx
+    unsigned int txr = txNrEnd;
+    unsigned int txSize = (txNrEnd + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT;
+    for (unsigned int i = 0; i < txSize; i++) {
+        txr = (txr + MAX_TX_CNT - 1) % MAX_TX_CNT; //decrement by 1
+
+        std::unique_ptr<Ocpp201::Transaction> intermediateTx;
+
+        Ocpp201::Transaction *txhist = nullptr;
+        if (transaction && transaction->txNr == txr) {
+            txhist = transaction.get();
+        } else if (txFront && txFront->txNr == txr) {
+            txhist = txFront;
+        } else {
+            intermediateTx = txStore.loadTransaction(txr);
+            txhist = intermediateTx.get();
+        }
+
+        //check if dangling silent tx, aborted tx, or corrupted entry (txhist == null)
+        if (!txhist || txhist->silent || (!txhist->active && !txhist->started && MO_TX_CLEAN_ABORTED)) {
+            //yes, remove
+            if (txStore.remove(txr)) {
+                if (txNrFront == txNrEnd) {
+                    txNrFront = txr;
+                }
+                txNrEnd = txr;
+                MO_DBG_WARN("deleted dangling silent or aborted tx for new transaction");
+            } else {
+                MO_DBG_ERR("memory corruption");
+                break;
+            }
+        } else {
+            //no, tx record trimmed, end
+            break;
+        }
+    }
+
+    txSize = (txNrEnd + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT; //refresh after cleaning txs
+
+    //try to create new transaction
+    if (txSize < MO_TXRECORD_SIZE) {
+        tx = txStore.createTransaction(txNrEnd, txId);
+    }
+
+    if (!tx) {
+        //could not create transaction - now, try to replace tx history entry
+
+        unsigned int txl = txNrBegin;
+        txSize = (txNrEnd + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT;
+
+        for (unsigned int i = 0; i < txSize; i++) {
+
+            if (tx) {
+                //success, finished here
+                break;
+            }
+
+            //no transaction allocated, delete history entry to make space
+            std::unique_ptr<Ocpp201::Transaction> intermediateTx;
+
+            Ocpp201::Transaction *txhist = nullptr;
+            if (transaction && transaction->txNr == txl) {
+                txhist = transaction.get();
+            } else if (txFront && txFront->txNr == txl) {
+                txhist = txFront;
+            } else {
+                intermediateTx = txStore.loadTransaction(txl);
+                txhist = intermediateTx.get();
+            }
+
+            //oldest entry, now check if it's history and can be removed or corrupted entry
+            if (!txhist || (txhist->stopped && txhist->seqNos.empty()) || (!txhist->active && !txhist->started) || (txhist->silent && txhist->stopped)) {
+                //yes, remove
+
+                if (txStore.remove(txl)) {
+                    txNrBegin = (txl + 1) % MAX_TX_CNT;
+                    if (txNrFront == txl) {
+                        txNrFront = txNrBegin;
+                    }
+                    MO_DBG_DEBUG("deleted tx history entry for new transaction");
+                    MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
+
+                    tx = txStore.createTransaction(txNrEnd, txId);
+                } else {
+                    MO_DBG_ERR("memory corruption");
+                    break;
+                }
+            } else {
+                //no, end of history reached, don't delete further tx
+                MO_DBG_DEBUG("cannot delete more tx");
+                break;
+            }
+
+            txl++;
+            txl %= MAX_TX_CNT;
+        }
+    }
+
+    if (!tx) {
+        //couldn't create normal transaction -> check if to start charging without real transaction
+        if (txService.silentOfflineTransactionsBool && txService.silentOfflineTransactionsBool->getBool()) {
+            //try to handle charging session without sending StartTx or StopTx to the server
+            tx = txStore.createTransaction(txNrEnd, txId);
+
+            if (tx) {
+                tx->silent = true;
+                MO_DBG_DEBUG("created silent transaction");
+            }
+        }
+    }
+
+    if (!tx) {
+        MO_DBG_ERR("transaction queue full");
+        return false;
+    }
+
     tx->beginTimestamp = context.getModel().getClock().now();
 
-    MO_DBG_DEBUG("allocated tx %u-%s", evseId, tx->transactionId);
+    if (!txStore.commit(tx.get())) {
+        MO_DBG_ERR("fs error");
+        return false;
+    }
+
+    transaction = std::move(tx);
+
+    txNrEnd = (txNrEnd + 1) % MAX_TX_CNT;
+    MO_DBG_DEBUG("advance txNrEnd %u-%u", evseId, txNrEnd);
+    MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
+
+    return true;
+}
+
+bool TransactionService::Evse::endTransaction(Ocpp201::Transaction::StoppedReason stoppedReason = Ocpp201::Transaction::StoppedReason::Other, Ocpp201::TransactionEventTriggerReason stopTrigger = Ocpp201::TransactionEventTriggerReason::AbnormalCondition) {
+
+    if (!transaction || !transaction->active) {
+        //transaction already ended / not active anymore
+        return false;
+    }
+
+    MO_DBG_DEBUG("End transaction started by idTag %s",
+                            transaction->idToken.get());
+
+    transaction->active = false;
+    transaction->stopTrigger = stopTrigger;
+    transaction->stoppedReason = stoppedReason;
+    txStore.commit(transaction.get());
 
-    return tx;
+    return true;
 }
 
 void TransactionService::Evse::loop() {
 
     if (transaction && !transaction->active && !transaction->started) {
         MO_DBG_DEBUG("collect aborted transaction %u-%s", evseId, transaction->transactionId);
+        if (txFront == transaction.get()) {
+            MO_DBG_DEBUG("pass ownership from tx to txFront");
+            txFrontCache = std::move(transaction);
+        }
         transaction = nullptr;
     }
 
     if (transaction && transaction->stopped) {
         MO_DBG_DEBUG("collect obsolete transaction %u-%s", evseId, transaction->transactionId);
+        if (txFront == transaction.get()) {
+            MO_DBG_DEBUG("pass ownership from tx to txFront");
+            txFrontCache = std::move(transaction);
+        }
         transaction = nullptr;
     }
 
@@ -88,9 +260,7 @@ void TransactionService::Evse::loop() {
                     context.getModel().getClock().now() - transaction->beginTimestamp >= txService.evConnectionTimeOutInt->getInt()) {
 
                 MO_DBG_INFO("Session mngt: timeout");
-                transaction->active = false;
-                transaction->stopTrigger = TransactionEventTriggerReason::EVConnectTimeout;
-                transaction->stopReason = Ocpp201::Transaction::StopReason::Timeout;
+                endTransaction(Ocpp201::Transaction::StoppedReason::Timeout, TransactionEventTriggerReason::EVConnectTimeout);
             }
 
             if (transaction->active &&
@@ -100,15 +270,12 @@ void TransactionService::Evse::loop() {
                      txService.isTxStopPoint(TxStartStopPoint::Authorized)  || txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed))) {
                 
                 MO_DBG_INFO("Session mngt: Deauthorized before start");
-                transaction->active = false;
-                transaction->stopTrigger = TransactionEventTriggerReason::Deauthorized;
-                transaction->stopReason = Ocpp201::Transaction::StopReason::DeAuthorized;
+                endTransaction(Ocpp201::Transaction::StoppedReason::DeAuthorized, TransactionEventTriggerReason::Deauthorized);
             }
         }
     }
 
-
-    std::shared_ptr<TransactionEventData> txEvent;
+    std::unique_ptr<TransactionEventData> txEvent;
 
     bool txStopCondition = false;
 
@@ -116,55 +283,53 @@ void TransactionService::Evse::loop() {
         // stop tx?
 
         TransactionEventTriggerReason triggerReason = TransactionEventTriggerReason::UNDEFINED;
-        Ocpp201::Transaction::StopReason stopReason = Ocpp201::Transaction::StopReason::UNDEFINED;
+        Ocpp201::Transaction::StoppedReason stoppedReason = Ocpp201::Transaction::StoppedReason::UNDEFINED;
 
         if (transaction && !transaction->active) {
             // tx ended via endTransaction
             txStopCondition = true;
             triggerReason = transaction->stopTrigger;
-            stopReason = transaction->stopReason;
+            stoppedReason = transaction->stoppedReason;
         } else if ((txService.isTxStopPoint(TxStartStopPoint::EVConnected) ||
                     txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed)) &&
                     connectorPluggedInput && !connectorPluggedInput() &&
                     (txService.stopTxOnEVSideDisconnectBool->getBool() || !transaction || !transaction->started)) {
             txStopCondition = true;
             triggerReason = TransactionEventTriggerReason::EVCommunicationLost;
-            stopReason = Ocpp201::Transaction::StopReason::EVDisconnected;
+            stoppedReason = Ocpp201::Transaction::StoppedReason::EVDisconnected;
         } else if ((txService.isTxStopPoint(TxStartStopPoint::Authorized) ||
                     txService.isTxStopPoint(TxStartStopPoint::PowerPathClosed)) &&
                     (!transaction || !transaction->isAuthorizationActive)) {
             // user revoked authorization (or EV or any "local" entity)
             txStopCondition = true;
             triggerReason = TransactionEventTriggerReason::StopAuthorized;
-            stopReason = Ocpp201::Transaction::StopReason::Local;
+            stoppedReason = Ocpp201::Transaction::StoppedReason::Local;
         } else if (txService.isTxStopPoint(TxStartStopPoint::EnergyTransfer) &&
                     evReadyInput && !evReadyInput()) {
             txStopCondition = true;
             triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
-            stopReason = Ocpp201::Transaction::StopReason::StoppedByEV;
+            stoppedReason = Ocpp201::Transaction::StoppedReason::StoppedByEV;
         } else if (txService.isTxStopPoint(TxStartStopPoint::EnergyTransfer) &&
                     (evReadyInput || evseReadyInput) && // at least one of the two defined
                     !(evReadyInput && evReadyInput()) &&
                     !(evseReadyInput && evseReadyInput())) {
             txStopCondition = true;
             triggerReason = TransactionEventTriggerReason::ChargingStateChanged;
-            stopReason = Ocpp201::Transaction::StopReason::Other;
+            stoppedReason = Ocpp201::Transaction::StoppedReason::Other;
         } else if (txService.isTxStopPoint(TxStartStopPoint::Authorized) &&
                     transaction && transaction->isDeauthorized &&
                     txService.stopTxOnInvalidIdBool->getBool()) {
             // OCPP server rejected authorization
             txStopCondition = true;
             triggerReason = TransactionEventTriggerReason::Deauthorized;
-            stopReason = Ocpp201::Transaction::StopReason::DeAuthorized;
+            stoppedReason = Ocpp201::Transaction::StoppedReason::DeAuthorized;
         }
 
         if (txStopCondition &&
                 transaction && transaction->started && transaction->active) {
 
             MO_DBG_INFO("Session mngt: TxStopPoint reached");
-            transaction->active = false;
-            transaction->stopTrigger = triggerReason;
-            transaction->stopReason = stopReason;
+            endTransaction(stoppedReason, triggerReason);
         }
 
         if (transaction &&
@@ -172,14 +337,14 @@ void TransactionService::Evse::loop() {
                 (!stopTxReadyInput || stopTxReadyInput())) {
             // yes, stop running tx
 
-            txEvent = std::allocate_shared<TransactionEventData>(makeAllocator<TransactionEventData>(getMemoryTag()), transaction, transaction->seqNoCounter++);
+            txEvent = txStore.createTransactionEvent(*transaction);
             if (!txEvent) {
                 // OOM
                 return;
             }
 
             transaction->stopTrigger = triggerReason;
-            transaction->stopReason = stopReason;
+            transaction->stoppedReason = stoppedReason;
 
             txEvent->eventType = TransactionEventData::Type::Ended;
             txEvent->triggerReason = triggerReason;
@@ -229,7 +394,7 @@ void TransactionService::Evse::loop() {
             // start tx
 
             if (!transaction) {
-                transaction = allocateTransaction();
+                beginTransaction();
                 if (!transaction) {
                     // OOM
                     return;
@@ -239,7 +404,7 @@ void TransactionService::Evse::loop() {
                 }
             }
 
-            txEvent = std::allocate_shared<TransactionEventData>(makeAllocator<TransactionEventData>(getMemoryTag()), transaction, transaction->seqNoCounter++);
+            txEvent = txStore.createTransactionEvent(*transaction);
             if (!txEvent) {
                 // OOM
                 return;
@@ -334,7 +499,7 @@ void TransactionService::Evse::loop() {
         if (txUpdateCondition && !txEvent && transaction->started && !transaction->stopped) {
             // yes, updated
 
-            txEvent = std::allocate_shared<TransactionEventData>(makeAllocator<TransactionEventData>(getMemoryTag()), transaction, transaction->seqNoCounter++);
+            txEvent = txStore.createTransactionEvent(*transaction);
             if (!txEvent) {
                 // OOM
                 return;
@@ -395,16 +560,36 @@ void TransactionService::Evse::loop() {
     }
 
     if (txEvent) {
-        auto txEventRequest = makeRequest(new Ocpp201::TransactionEvent(context.getModel(), txEvent));
-        txEventRequest->setTimeout(0);
-        context.initiateRequest(std::move(txEventRequest));
-
         if (txEvent->eventType == TransactionEventData::Type::Started) {
             transaction->started = true;
         } else if (txEvent->eventType == TransactionEventData::Type::Ended) {
             transaction->stopped = true;
         }
     }
+
+    if (txEvent) {
+        txEvent->opNr = context.getRequestQueue().getNextOpNr();
+        MO_DBG_DEBUG("enqueueing new txEvent at opNr %u", txEvent->opNr);
+    }
+
+    if (txEvent) {
+        txStore.commit(txEvent.get());
+    }
+
+    //try to pass ownership to front txEvent immediatley
+    if (txEvent && !txEventFront &&
+            transaction->txNr == txNrFront &&
+            !transaction->seqNos.empty() && transaction->seqNos.front() == txEvent->seqNo) {
+
+        //txFront set up?
+        if (!txFront) {
+            txFront = transaction.get();
+        }
+
+        //keep txEvent loaded (otherwise ReqEmitter would load it again from flash)
+        MO_DBG_DEBUG("new txEvent is front element");
+        txEventFront = std::move(txEvent);
+    }
 }
 
 void TransactionService::Evse::setConnectorPluggedInput(std::function<bool()> connectorPlugged) {
@@ -428,7 +613,7 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
     }
 
     if (!transaction) {
-        transaction = allocateTransaction();
+        beginTransaction();
         if (!transaction) {
             MO_DBG_ERR("could not allocate Tx");
             return false;
@@ -442,8 +627,6 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
     transaction->idToken = idToken;
     transaction->beginTimestamp = context.getModel().getClock().now();
 
-    auto tx = transaction;
-
     if (validateIdToken) {
         auto authorize = makeRequest(new Authorize(context.getModel(), idToken));
         if (!authorize) {
@@ -452,27 +635,45 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
             return false;
         }
 
-        authorize->setOnReceiveConfListener([this, tx] (JsonObject response) {
+        char txId [sizeof(transaction->transactionId)]; //capture txId to check if transaction reference is still the same
+        snprintf(txId, sizeof(txId), "%s", transaction->transactionId);
+
+        authorize->setOnReceiveConfListener([this, txId] (JsonObject response) {
+            auto tx = getTransaction();
+            if (!tx || strcmp(tx->transactionId, txId)) {
+                MO_DBG_INFO("dangling Authorize -- discard");
+                return;
+            }
+
             if (strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
                 MO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->idToken.get());
                 tx->isDeauthorized = true;
+                txStore.commit(tx);
                 return;
             }
 
             MO_DBG_DEBUG("Authorized tx with validation (%s)", tx->idToken.get());
             tx->isAuthorized = true;
             tx->notifyIdToken = true;
+            txStore.commit(tx);
         });
-        authorize->setOnAbortListener([this, tx] () {
+        authorize->setOnAbortListener([this, txId] () {
+            auto tx = getTransaction();
+            if (!tx || strcmp(tx->transactionId, txId)) {
+                MO_DBG_INFO("dangling Authorize -- discard");
+                return;
+            }
+
             MO_DBG_DEBUG("Authorize timeout (%s)", tx->idToken.get());
             tx->isDeauthorized = true;
+            txStore.commit(tx);
         });
         authorize->setTimeout(20 * 1000);
         context.initiateRequest(std::move(authorize));
     } else {
-        MO_DBG_DEBUG("Authorized tx directly (%s)", tx->idToken.get());
-        tx->isAuthorized = true;
-        tx->notifyIdToken = true;
+        MO_DBG_DEBUG("Authorized tx directly (%s)", transaction->idToken.get());
+        transaction->isAuthorized = true;
+        transaction->notifyIdToken = true;
     }
 
     return true;
@@ -498,8 +699,6 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
     } else {
         // use a different idToken for stopping the tx
 
-        auto tx = transaction;
-
         auto authorize = makeRequest(new Authorize(context.getModel(), idToken));
         if (!authorize) {
             // OOM
@@ -507,7 +706,16 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
             return false;
         }
 
-        authorize->setOnReceiveConfListener([tx, idToken, this] (JsonObject response) {
+        char txId [sizeof(transaction->transactionId)]; //capture txId to check if transaction reference is still the same
+        snprintf(txId, sizeof(txId), "%s", transaction->transactionId);
+
+        authorize->setOnReceiveConfListener([this, txId, idToken] (JsonObject response) {
+            auto tx = getTransaction();
+            if (!tx || strcmp(tx->transactionId, txId)) {
+                MO_DBG_INFO("dangling Authorize -- discard");
+                return;
+            }
+
             if (strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
                 MO_DBG_DEBUG("Authorize rejected (%s), don't stop tx", idToken.get());
                 return;
@@ -519,15 +727,14 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
             if (!tx->stopIdToken) {
                 // OOM
                 if (tx->active) {
-                    tx->active = false;
-                    tx->stopTrigger = TransactionEventTriggerReason::AbnormalCondition;
-                    tx->stopReason = Ocpp201::Transaction::StopReason::Other;
+                    abortTransaction();
                 }
                 return;
             }
 
             tx->isAuthorizationActive = false;
             tx->notifyStopIdToken = true;
+            txStore.commit(tx);
         });
         authorize->setTimeout(20 * 1000);
         context.initiateRequest(std::move(authorize));
@@ -535,24 +742,11 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
 
     return true;
 }
-bool TransactionService::Evse::abortTransaction(Ocpp201::Transaction::StopReason stopReason, TransactionEventTriggerReason stopTrigger) {
-
-    if (!transaction || !transaction->active) {
-        //transaction already ended / not active anymore
-        return false;
-    }
-
-    MO_DBG_DEBUG("Abort session started by idTag %s",
-                            transaction->idToken.get());
-
-    transaction->active = false;
-    transaction->stopTrigger = stopTrigger;
-    transaction->stopReason = stopReason;
-
-    return true;
+bool TransactionService::Evse::abortTransaction(Ocpp201::Transaction::StoppedReason stoppedReason, TransactionEventTriggerReason stopTrigger) {
+    return endTransaction(stoppedReason, stopTrigger);
 }
-std::shared_ptr<MicroOcpp::Ocpp201::Transaction>& TransactionService::Evse::getTransaction() {
-    return transaction;
+MicroOcpp::Ocpp201::Transaction *TransactionService::Evse::getTransaction() {
+    return transaction.get();
 }
 
 bool TransactionService::Evse::ocppPermitsCharge() {
@@ -563,6 +757,142 @@ bool TransactionService::Evse::ocppPermitsCharge() {
            !transaction->isDeauthorized;
 }
 
+unsigned int TransactionService::Evse::getFrontRequestOpNr() {
+
+    if (txEventFront) {
+        return txEventFront->opNr;
+    }
+
+    /*
+     * Advance front transaction?
+     */
+
+    unsigned int txSize = (txNrEnd + MAX_TX_CNT - txNrFront) % MAX_TX_CNT;
+
+    if (txFront && txSize == 0) {
+        //catch edge case where txBack has been rolled back and txFront was equal to txBack
+        MO_DBG_DEBUG("collect front transaction %u-%u after tx rollback", evseId, txFront->txNr);
+        MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
+        txEventFront = nullptr;
+        txFrontCache = nullptr;
+        txFront = nullptr;
+    }
+
+    for (unsigned int i = 0; i < txSize; i++) {
+
+        if (!txFront) {
+            if (transaction && transaction->txNr == txNrFront) {
+                txFront = transaction.get();
+            } else {
+                txFrontCache = txStore.loadTransaction(txNrFront);
+                txFront = txFrontCache.get();
+            }
+
+            if (txFront) {
+                MO_DBG_DEBUG("load front transaction %u-%u", evseId, txFront->txNr);
+                (void)0;
+            }
+        }
+
+        if (!txFront || (txFront && ((!txFront->active && !txFront->started) || (txFront->stopped && txFront->seqNos.empty()) || txFront->silent))) {
+            //advance front
+            MO_DBG_DEBUG("collect front transaction %u-%u", evseId, txNrFront);
+            txEventFront = nullptr;
+            txFrontCache = nullptr;
+            txFront = nullptr;
+            txNrFront = (txNrFront + 1) % MAX_TX_CNT;
+            MO_DBG_VERBOSE("txNrBegin=%u, txNrFront=%u, txNrEnd=%u", txNrBegin, txNrFront, txNrEnd);
+        } else {
+            //front is accurate. Done here
+            break;
+        }
+    }
+
+    if (txFront && !txFront->seqNos.empty()) {
+        MO_DBG_DEBUG("load front txEvent %u-%u-%u from flash", evseId, txFront->txNr, txFront->seqNos.front());
+        txEventFront = txStore.loadTransactionEvent(*txFront, txFront->seqNos.front());
+    }
+
+    if (txEventFront) {
+        return txEventFront->opNr;
+    }
+
+    return NoOperation;
+}
+
+std::unique_ptr<Request> TransactionService::Evse::fetchFrontRequest() {
+
+    if (!txEventFront) {
+        return nullptr;
+    }
+
+    if (txFront && txFront->silent) {
+        return nullptr;
+    }
+
+    if (txEventFront->seqNo == 0 &&
+            txEventFront->timestamp < MIN_TIME &&
+            txEventFront->bootNr != context.getModel().getBootNr()) {
+        //time not set, cannot be restored anymore -> invalid tx
+        MO_DBG_ERR("cannot recover tx from previous power cycle");
+
+        txFront->silent = true;
+        txFront->active = false;
+        txStore.commit(txFront);
+
+        //clean txEvents early
+        auto seqNos = txFront->seqNos;
+        for (size_t i = 0; i < seqNos.size(); i++) {
+            txStore.remove(*txFront, seqNos[i]);
+        }
+        //last remove should keep tx201 file with only tx record and without txEvent
+
+        //next getFrontRequestOpNr() call will collect txFront
+        return nullptr;
+    }
+
+    if ((int)txEventFront->attemptNr >= txService.messageAttemptsTransactionEventInt->getInt()) {
+        MO_DBG_WARN("exceeded TransactionMessageAttempts. Discard txEvent");
+
+        txStore.remove(*txFront, txEventFront->seqNo);
+        txEventFront = nullptr;
+        return nullptr;
+    }
+
+    Timestamp nextAttempt = txEventFront->attemptTime +
+                            txEventFront->attemptNr * std::max(0, txService.messageAttemptIntervalTransactionEventInt->getInt());
+
+    if (nextAttempt > context.getModel().getClock().now()) {
+        return nullptr;
+    }
+
+    if (txEventFrontIsRequested) {
+        //ensure that only one TransactionEvent request is being executed at the same time
+        return nullptr;
+    }
+
+    txEventFront->attemptNr++;
+    txEventFront->attemptTime = context.getModel().getClock().now();
+    txStore.commit(txEventFront.get());
+
+    auto txEventRequest = makeRequest(new TransactionEvent(context.getModel(), txEventFront.get()));
+    txEventRequest->setOnReceiveConfListener([this] (JsonObject) {
+        MO_DBG_DEBUG("completed front txEvent");
+        txStore.remove(*txFront, txEventFront->seqNo);
+        txEventFront = nullptr;
+        txEventFrontIsRequested = false;
+    });
+    txEventRequest->setOnAbortListener([this] () {
+        MO_DBG_DEBUG("unsuccessful front txEvent");
+        txEventFrontIsRequested = false;
+    });
+    txEventRequest->setTimeout(std::min(20, std::max(5, txService.messageAttemptIntervalTransactionEventInt->getInt())) * 1000);
+
+    txEventFrontIsRequested = true;
+
+    return txEventRequest;
+}
+
 bool TransactionService::isTxStartPoint(TxStartStopPoint check) {
     for (auto& v : txStartPointParsed) {
         if (v == check) {
@@ -626,10 +956,27 @@ bool TransactionService::parseTxStartStopPoint(const char *csl, Vector<TxStartSt
     return true;
 }
 
-TransactionService::TransactionService(Context& context) :
+namespace MicroOcpp {
+
+bool validateTxStartStopPoint(const char *value, void *userPtr) {
+    auto txService = static_cast<TransactionService*>(userPtr);
+
+    auto validated = makeVector<TransactionService::TxStartStopPoint>("v201.Transactions.TransactionService");
+    return txService->parseTxStartStopPoint(value, validated);
+}
+
+bool validateUnsignedInt(int val, void*) {
+    return val >= 0;
+}
+
+} //namespace MicroOcpp
+
+using namespace MicroOcpp;
+
+TransactionService::TransactionService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int numEvseIds) :
         MemoryManaged("v201.Transactions.TransactionService"),
         context(context),
-        evses(makeVector<Evse>(getMemoryTag())),
+        txStore(filesystem, numEvseIds),
         txStartPointParsed(makeVector<TxStartStopPoint>(getMemoryTag())),
         txStopPointParsed(makeVector<TxStartStopPoint>(getMemoryTag())) {
     auto varService = context.getModel().getVariableService();
@@ -641,41 +988,42 @@ TransactionService::TransactionService(Context& context) :
     evConnectionTimeOutInt = varService->declareVariable<int>("TxCtrlr", "EVConnectionTimeOut", 30);
     sampledDataTxUpdatedInterval = varService->declareVariable<int>("SampledDataCtrlr", "TxUpdatedInterval", 0);
     sampledDataTxEndedInterval = varService->declareVariable<int>("SampledDataCtrlr", "TxEndedInterval", 0);
+    messageAttemptsTransactionEventInt = varService->declareVariable<int>("OCPPCommCtrlr", "MessageAttempts", 3);
+    messageAttemptIntervalTransactionEventInt = varService->declareVariable<int>("OCPPCommCtrlr", "MessageAttemptInterval", 60);
+    silentOfflineTransactionsBool = varService->declareVariable<bool>("CustomizationCtrlr", "SilentOfflineTransactions", false);
 
-    varService->declareVariable<bool>("AuthCtrlr", "AuthorizeRemoteStart", false, MO_VARIABLE_VOLATILE, Variable::Mutability::ReadOnly);
-
-    varService->registerValidator<const char*>("TxCtrlr", "TxStartPoint", [this] (const char *value) -> bool {
-        auto validated = makeVector<TxStartStopPoint>(getMemoryTag());
-        return this->parseTxStartStopPoint(value, validated);
-    });
-
-    varService->registerValidator<const char*>("TxCtrlr", "TxStopPoint", [this] (const char *value) -> bool {
-        auto validated = makeVector<TxStartStopPoint>(getMemoryTag());
-        return this->parseTxStartStopPoint(value, validated);
-    });
-
-    std::function<bool(int)> validateUnsignedInt = [] (int val) {
-        return val >= 0;
-    };
+    varService->declareVariable<bool>("AuthCtrlr", "AuthorizeRemoteStart", false, Variable::Mutability::ReadOnly, false);
 
+    varService->registerValidator<const char*>("TxCtrlr", "TxStartPoint", validateTxStartStopPoint, this);
+    varService->registerValidator<const char*>("TxCtrlr", "TxStopPoint", validateTxStartStopPoint, this);
     varService->registerValidator<int>("SampledDataCtrlr", "TxUpdatedInterval", validateUnsignedInt);
     varService->registerValidator<int>("SampledDataCtrlr", "TxEndedInterval", validateUnsignedInt);
 
-    evses.reserve(MO_NUM_EVSEID);
-
-    for (unsigned int evseId = 0; evseId < MO_NUM_EVSEID; evseId++) {
-        evses.emplace_back(context, *this, evseId);
+    for (unsigned int evseId = 0; evseId < std::min(numEvseIds, (unsigned int)MO_NUM_EVSEID); evseId++) {
+        if (!txStore.getEvse(evseId)) {
+            MO_DBG_ERR("initialization error");
+            break;
+        }
+        evses[evseId] = new Evse(context, *this, *txStore.getEvse(evseId), evseId);
     }
 
     //make sure EVSE 0 will only trigger transactions if TxStartPoint is Authorized
-    evses[0].connectorPluggedInput = [] () {return false;};
-    evses[0].evReadyInput = [] () {return false;};
-    evses[0].evseReadyInput = [] () {return false;};
+    if (evses[0]) {
+        evses[0]->connectorPluggedInput = [] () {return false;};
+        evses[0]->evReadyInput = [] () {return false;};
+        evses[0]->evseReadyInput = [] () {return false;};
+    }
+}
+
+TransactionService::~TransactionService() {
+    for (unsigned int evseId = 0; evseId < MO_NUM_EVSEID && evses[evseId]; evseId++) {
+        delete evses[evseId];
+    }
 }
 
 void TransactionService::loop() {
-    for (Evse& evse : evses) {
-        evse.loop();
+    for (unsigned int evseId = 0; evseId < MO_NUM_EVSEID && evses[evseId]; evseId++) {
+        evses[evseId]->loop();
     }
 
     if (txStartPointString->getWriteCount() != trackTxStartPoint) {
@@ -687,15 +1035,16 @@ void TransactionService::loop() {
     }
 
     // assign tx on evseId 0 to an EVSE
-    if (auto& tx0 = evses[0].getTransaction()) {
+    if (evses[0]->transaction) {
         //pending tx on evseId 0
-        if (tx0->active) {
-            for (unsigned int evseId = 1; evseId < MO_NUM_EVSEID; evseId++) {
-                if (!evses[evseId].getTransaction() && 
-                        (!evses[evseId].connectorPluggedInput || evses[evseId].connectorPluggedInput())) {
+        if (evses[0]->transaction->active) {
+            for (unsigned int evseId = 1; evseId < MO_NUM_EVSEID && evses[evseId]; evseId++) {
+                if (!evses[evseId]->getTransaction() && 
+                        (!evses[evseId]->connectorPluggedInput || evses[evseId]->connectorPluggedInput())) {
                     MO_DBG_INFO("assign tx to evse %u", evseId);
-                    tx0->notifyEvseId = true;
-                    evses[evseId].transaction = std::move(tx0);
+                    evses[0]->transaction->notifyEvseId = true;
+                    evses[0]->transaction->evseId = evseId;
+                    evses[evseId]->transaction = std::move(evses[0]->transaction);
                 }
             }
         }
@@ -703,12 +1052,10 @@ void TransactionService::loop() {
 }
 
 TransactionService::Evse *TransactionService::getEvse(unsigned int evseId) {
-    if (evseId < evses.size()) {
-        return &evses[evseId];
-    } else {
-        MO_DBG_ERR("invalid arg");
+    if (evseId >= MO_NUM_EVSEID) {
         return nullptr;
     }
+    return evses[evseId];
 }
 
 #endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.h b/src/MicroOcpp/Model/Transactions/TransactionService.h
index ca9704b7..45a0b64a 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.h
@@ -14,27 +14,35 @@
 #if MO_ENABLE_V201
 
 #include <MicroOcpp/Model/Transactions/Transaction.h>
+#include <MicroOcpp/Model/Transactions/TransactionStore.h>
 #include <MicroOcpp/Model/Metering/MeterValuesV201.h>
+#include <MicroOcpp/Core/RequestQueue.h>
 #include <MicroOcpp/Core/Memory.h>
 
 #include <memory>
 #include <functional>
 
+#ifndef MO_TXRECORD_SIZE_V201
+#define MO_TXRECORD_SIZE_V201 4 //maximum number of tx to hold on flash storage
+#endif
+
 namespace MicroOcpp {
 
 class Context;
+class FilesystemAdapter;
 class Variable;
 
 class TransactionService : public MemoryManaged {
 public:
 
-    class Evse : public MemoryManaged {
+    class Evse : public RequestEmitter, public MemoryManaged {
     private:
         Context& context;
         TransactionService& txService;
+        Ocpp201::TransactionStoreEvse& txStore;
         const unsigned int evseId;
         unsigned int txNrCounter = 0;
-        std::shared_ptr<Ocpp201::Transaction> transaction;
+        std::unique_ptr<Ocpp201::Transaction> transaction;
         Ocpp201::TransactionEventData::ChargingState trackChargingState = Ocpp201::TransactionEventData::ChargingState::UNDEFINED;
 
         std::function<bool()> connectorPluggedInput;
@@ -44,10 +52,21 @@ class TransactionService : public MemoryManaged {
         std::function<bool()> startTxReadyInput;
         std::function<bool()> stopTxReadyInput;
 
-        std::unique_ptr<Ocpp201::Transaction> allocateTransaction();
+        bool beginTransaction();
+        bool endTransaction(Ocpp201::Transaction::StoppedReason stoppedReason, Ocpp201::TransactionEventTriggerReason stopTrigger);
+
+        unsigned int txNrBegin = 0; //oldest (historical) transaction on flash. Has no function, but is useful for error diagnosis
+        unsigned int txNrFront = 0; //oldest transaction which is still queued to be sent to the server
+        unsigned int txNrEnd = 0; //one position behind newest transaction
+
+        Ocpp201::Transaction *txFront = nullptr;
+        std::unique_ptr<Ocpp201::Transaction> txFrontCache; //helper owner for txFront. Empty if txFront == transaction.get()
+        std::unique_ptr<Ocpp201::TransactionEventData> txEventFront;
+        bool txEventFrontIsRequested = false;
 
     public:
-        Evse(Context& context, TransactionService& txService, unsigned int evseId);
+        Evse(Context& context, TransactionService& txService, Ocpp201::TransactionStoreEvse& txStore, unsigned int evseId);
+        virtual ~Evse();
 
         void loop();
 
@@ -56,20 +75,21 @@ class TransactionService : public MemoryManaged {
         void setEvseReadyInput(std::function<bool()> connectorEnergized);
 
         bool beginAuthorization(IdToken idToken, bool validateIdToken = true); // authorize by swipe RFID
-        bool endAuthorization(IdToken idToken = IdToken(), bool validateIdToken = true); // stop authorization by swipe RFID
+        bool endAuthorization(IdToken idToken = IdToken(), bool validateIdToken = false); // stop authorization by swipe RFID
 
         // stop transaction, but neither upon user request nor OCPP server request (e.g. after PowerLoss)
-        bool abortTransaction(Ocpp201::Transaction::StopReason stopReason = Ocpp201::Transaction::StopReason::Other, Ocpp201::TransactionEventTriggerReason stopTrigger = Ocpp201::TransactionEventTriggerReason::AbnormalCondition);
+        bool abortTransaction(Ocpp201::Transaction::StoppedReason stoppedReason = Ocpp201::Transaction::StoppedReason::Other, Ocpp201::TransactionEventTriggerReason stopTrigger = Ocpp201::TransactionEventTriggerReason::AbnormalCondition);
 
-        std::shared_ptr<Ocpp201::Transaction>& getTransaction();
+        Ocpp201::Transaction *getTransaction();
 
         bool ocppPermitsCharge();
 
+        unsigned int getFrontRequestOpNr() override;
+        std::unique_ptr<Request> fetchFrontRequest() override;
+
         friend TransactionService;
     };
 
-private:
-
     // TxStartStopPoint (2.6.4.1)
     enum class TxStartStopPoint : uint8_t {
         ParkingBayOccupancy,
@@ -80,8 +100,10 @@ class TransactionService : public MemoryManaged {
         EnergyTransfer
     };
 
+private:
     Context& context;
-    Vector<Evse> evses;
+    Ocpp201::TransactionStore txStore;
+    Evse *evses [MO_NUM_EVSEID] = {nullptr};
 
     Variable *txStartPointString = nullptr;
     Variable *txStopPointString = nullptr;
@@ -90,21 +112,24 @@ class TransactionService : public MemoryManaged {
     Variable *evConnectionTimeOutInt = nullptr;
     Variable *sampledDataTxUpdatedInterval = nullptr;
     Variable *sampledDataTxEndedInterval = nullptr;
+    Variable *messageAttemptsTransactionEventInt = nullptr;
+    Variable *messageAttemptIntervalTransactionEventInt = nullptr;
+    Variable *silentOfflineTransactionsBool = nullptr;
     uint16_t trackTxStartPoint = -1;
     uint16_t trackTxStopPoint = -1;
     Vector<TxStartStopPoint> txStartPointParsed;
     Vector<TxStartStopPoint> txStopPointParsed;
     bool isTxStartPoint(TxStartStopPoint check);
     bool isTxStopPoint(TxStartStopPoint check);
-
-    bool parseTxStartStopPoint(const char *src, Vector<TxStartStopPoint>& dst);
-
 public:
-    TransactionService(Context& context);
+    TransactionService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem, unsigned int numEvseIds);
+    ~TransactionService();
 
     void loop();
 
     Evse *getEvse(unsigned int evseId);
+
+    bool parseTxStartStopPoint(const char *src, Vector<TxStartStopPoint>& dst);
 };
 
 } // namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
index 01ea4111..39c096ba 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.cpp
@@ -57,7 +57,7 @@ std::shared_ptr<Transaction> ConnectorTransactionStore::getTransaction(unsigned
     }
 
     char fn [MO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx" "-%u-%u.json", connectorId, txNr);
     if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
         MO_DBG_ERR("fn error: %i", ret);
         return nullptr;
@@ -130,7 +130,7 @@ bool ConnectorTransactionStore::commit(Transaction *transaction) {
     }
 
     char fn [MO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, transaction->getTxNr());
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx" "-%u-%u.json", connectorId, transaction->getTxNr());
     if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
         MO_DBG_ERR("fn error: %i", ret);
         return false;
@@ -159,7 +159,7 @@ bool ConnectorTransactionStore::remove(unsigned int txNr) {
     }
 
     char fn [MO_MAX_PATH_SIZE] = {'\0'};
-    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx" "-%u-%u.jsn", connectorId, txNr);
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx" "-%u-%u.json", connectorId, txNr);
     if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
         MO_DBG_ERR("fn error: %i", ret);
         return false;
@@ -221,3 +221,890 @@ bool TransactionStore::remove(unsigned int connectorId, unsigned int txNr) {
     }
     return connectors[connectorId]->remove(txNr);
 }
+
+#if MO_ENABLE_V201
+
+#include <algorithm>
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+bool TransactionStoreEvse::serializeTransaction(Transaction& tx, JsonObject txJson) {
+
+    if (tx.trackEvConnected) {
+        txJson["trackEvConnected"] = tx.trackEvConnected;
+    }
+
+    if (tx.trackAuthorized) {
+        txJson["trackAuthorized"] = tx.trackAuthorized;
+    }
+
+    if (tx.trackDataSigned) {
+        txJson["trackDataSigned"] = tx.trackDataSigned;
+    }
+
+    if (tx.trackPowerPathClosed) {
+        txJson["trackPowerPathClosed"] = tx.trackPowerPathClosed;
+    }
+
+    if (tx.trackEnergyTransfer) {
+        txJson["trackEnergyTransfer"] = tx.trackEnergyTransfer;
+    }
+
+    if (tx.active) {
+        txJson["active"] = true;
+    }
+    if (tx.started) {
+        txJson["started"] = true;
+    }
+    if (tx.stopped) {
+        txJson["stopped"] = true;
+    }
+
+    if (tx.isAuthorizationActive) {
+        txJson["isAuthorizationActive"] = true;
+    }
+    if (tx.isAuthorized) {
+        txJson["isAuthorized"] = true;
+    }
+    if (tx.isDeauthorized) {
+        txJson["isDeauthorized"] = true;
+    }
+
+    if (tx.idToken.get()) {
+        txJson["idToken"]["idToken"] = tx.idToken.get();
+        txJson["idToken"]["type"] = tx.idToken.getTypeCstr();
+    }
+
+    if (tx.beginTimestamp > MIN_TIME) {
+        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+        tx.beginTimestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
+        txJson["beginTimestamp"] = timeStr;
+    }
+
+    if (tx.remoteStartId >= 0) {
+        txJson["remoteStartId"] = tx.remoteStartId;
+    }
+
+    if (tx.evConnectionTimeoutListen) {
+        txJson["evConnectionTimeoutListen"] = true;
+    }
+
+    if (serializeTransactionStoppedReason(tx.stoppedReason)) { // optional
+        txJson["stoppedReason"] = serializeTransactionStoppedReason(tx.stoppedReason);
+    }
+
+    if (serializeTransactionEventTriggerReason(tx.stopTrigger)) {
+        txJson["stopTrigger"] = serializeTransactionEventTriggerReason(tx.stopTrigger);
+    }
+
+    if (tx.stopIdToken) {
+        JsonObject stopIdToken = txJson.createNestedObject("stopIdToken");
+        stopIdToken["idToken"] = tx.stopIdToken->get();
+        stopIdToken["type"] = tx.stopIdToken->getTypeCstr();
+    }
+
+    //sampledDataTxEnded not supported yet
+
+    if (tx.silent) {
+        txJson["silent"] = true;
+    }
+
+    txJson["txId"] = (const char*)tx.transactionId; //force zero-copy
+
+    return true;
+}
+
+bool TransactionStoreEvse::deserializeTransaction(Transaction& tx, JsonObject txJson) {
+
+    if (txJson.containsKey("trackEvConnected") && !txJson["trackEvConnected"].is<bool>()) {
+        return false;
+    }
+    tx.trackEvConnected = txJson["trackEvConnected"] | false;
+
+    if (txJson.containsKey("trackAuthorized") && !txJson["trackAuthorized"].is<bool>()) {
+        return false;
+    }
+    tx.trackAuthorized = txJson["trackAuthorized"] | false;
+
+    if (txJson.containsKey("trackDataSigned") && !txJson["trackDataSigned"].is<bool>()) {
+        return false;
+    }
+    tx.trackDataSigned = txJson["trackDataSigned"] | false;
+
+    if (txJson.containsKey("trackPowerPathClosed") && !txJson["trackPowerPathClosed"].is<bool>()) {
+        return false;
+    }
+    tx.trackPowerPathClosed = txJson["trackPowerPathClosed"] | false;
+
+    if (txJson.containsKey("trackEnergyTransfer") && !txJson["trackEnergyTransfer"].is<bool>()) {
+        return false;
+    }
+    tx.trackEnergyTransfer = txJson["trackEnergyTransfer"] | false;
+
+    if (txJson.containsKey("active") && !txJson["active"].is<bool>()) {
+        return false;
+    }
+    tx.active = txJson["active"] | false;
+    if (txJson.containsKey("started") && !txJson["started"].is<bool>()) {
+        return false;
+    }
+    tx.started = txJson["started"] | false;
+
+    if (txJson.containsKey("stopped") && !txJson["stopped"].is<bool>()) {
+        return false;
+    }
+    tx.stopped = txJson["stopped"] | false;
+
+    if (txJson.containsKey("isAuthorizationActive") && !txJson["isAuthorizationActive"].is<bool>()) {
+        return false;
+    }
+    tx.isAuthorizationActive = txJson["isAuthorizationActive"] | false;
+    if (txJson.containsKey("isAuthorized") && !txJson["isAuthorized"].is<bool>()) {
+        return false;
+    }
+    tx.isAuthorized = txJson["isAuthorized"] | false;
+
+    if (txJson.containsKey("isDeauthorized") && !txJson["isDeauthorized"].is<bool>()) {
+        return false;
+    }
+    tx.isDeauthorized = txJson["isDeauthorized"] | false;
+
+    if (txJson.containsKey("idToken")) {
+        IdToken idToken;
+        if (!idToken.parseCstr(
+                    txJson["idToken"]["idToken"] | (const char*)nullptr, 
+                    txJson["idToken"]["type"]    | (const char*)nullptr)) {
+            return false;
+        }
+        tx.idToken = idToken;
+    }
+
+    if (txJson.containsKey("beginTimestamp")) {
+        if (!tx.beginTimestamp.setTime(txJson["beginTimestamp"] | "_Undefined")) {
+            return false;
+        }
+    }
+
+    if (txJson.containsKey("remoteStartId")) {
+        int remoteStartIdIn = txJson["remoteStartId"] | -1;
+        if (remoteStartIdIn < 0) {
+            return false;
+        }
+        tx.remoteStartId = remoteStartIdIn;
+    }
+
+    if (txJson.containsKey("evConnectionTimeoutListen") && !txJson["evConnectionTimeoutListen"].is<bool>()) {
+        return false;
+    }
+    tx.evConnectionTimeoutListen = txJson["evConnectionTimeoutListen"] | false;
+
+    Transaction::StoppedReason stoppedReason;
+    if (!deserializeTransactionStoppedReason(txJson["stoppedReason"] | (const char*)nullptr, stoppedReason)) {
+        return false;
+    }
+    tx.stoppedReason = stoppedReason;
+
+    TransactionEventTriggerReason stopTrigger;
+    if (!deserializeTransactionEventTriggerReason(txJson["stopTrigger"] | (const char*)nullptr, stopTrigger)) {
+        return false;
+    }
+    tx.stopTrigger = stopTrigger;
+
+    if (txJson.containsKey("stopIdToken")) {
+        auto stopIdToken = std::unique_ptr<IdToken>(new IdToken());
+        if (!stopIdToken) {
+            MO_DBG_ERR("OOM");
+            return false;
+        }
+        if (!stopIdToken->parseCstr(
+                    txJson["stopIdToken"]["idToken"] | (const char*)nullptr, 
+                    txJson["stopIdToken"]["type"]    | (const char*)nullptr)) {
+            return false;
+        }
+        tx.stopIdToken = std::move(stopIdToken);
+    }
+
+    //sampledDataTxEnded not supported yet
+
+    if (auto txId = txJson["txId"] | (const char*)nullptr) {
+        auto ret = snprintf(tx.transactionId, sizeof(tx.transactionId), "%s", txId);
+        if (ret < 0 || (size_t)ret >= sizeof(tx.transactionId)) {
+            return false;
+        }
+    } else {
+        return false;
+    }
+
+    if (txJson.containsKey("silent") && !txJson["silent"].is<bool>()) {
+        return false;
+    }
+    tx.silent = txJson["silent"] | false;
+
+    return true;
+}
+
+bool TransactionStoreEvse::serializeTransactionEvent(TransactionEventData& txEvent, JsonObject txEventJson) {
+    
+    if (txEvent.eventType != TransactionEventData::Type::Updated) {
+        txEventJson["eventType"] = serializeTransactionEventType(txEvent.eventType);
+    }
+
+    if (txEvent.timestamp > MIN_TIME) {
+        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+        txEvent.timestamp.toJsonString(timeStr, JSONDATE_LENGTH + 1);
+        txEventJson["timestamp"] = timeStr;
+    }
+
+    txEventJson["bootNr"] = txEvent.bootNr;
+
+    if (serializeTransactionEventTriggerReason(txEvent.triggerReason)) {
+        txEventJson["triggerReason"] = serializeTransactionEventTriggerReason(txEvent.triggerReason);
+    }
+    
+    if (txEvent.offline) {
+        txEventJson["offline"] = true;
+    }
+
+    if (txEvent.numberOfPhasesUsed >= 0) {
+        txEventJson["numberOfPhasesUsed"] = txEvent.numberOfPhasesUsed;
+    }
+
+    if (txEvent.cableMaxCurrent >= 0) {
+        txEventJson["cableMaxCurrent"] = txEvent.cableMaxCurrent;
+    }
+
+    if (txEvent.reservationId >= 0) {
+        txEventJson["reservationId"] = txEvent.reservationId;
+    }
+
+    if (txEvent.remoteStartId >= 0) {
+        txEventJson["remoteStartId"] = txEvent.remoteStartId;
+    }
+
+    if (serializeTransactionEventChargingState(txEvent.chargingState)) { // optional
+        txEventJson["chargingState"] = serializeTransactionEventChargingState(txEvent.chargingState);
+    }
+
+    if (txEvent.idToken) {
+        JsonObject idToken = txEventJson.createNestedObject("idToken");
+        idToken["idToken"] = txEvent.idToken->get();
+        idToken["type"] = txEvent.idToken->getTypeCstr();
+    }
+
+    if (txEvent.evse.id >= 0) {
+        JsonObject evse = txEventJson.createNestedObject("evse");
+        evse["id"] = txEvent.evse.id;
+        if (txEvent.evse.connectorId >= 0) {
+            evse["connectorId"] = txEvent.evse.connectorId;
+        }
+    }
+
+    //meterValue not supported yet
+
+    txEventJson["opNr"] = txEvent.opNr;
+    txEventJson["attemptNr"] = txEvent.attemptNr;
+    
+    if (txEvent.attemptTime > MIN_TIME) {
+        char timeStr [JSONDATE_LENGTH + 1] = {'\0'};
+        txEvent.attemptTime.toJsonString(timeStr, JSONDATE_LENGTH + 1);
+        txEventJson["attemptTime"] = timeStr;
+    }
+
+    return true;
+}
+
+bool TransactionStoreEvse::deserializeTransactionEvent(TransactionEventData& txEvent, JsonObject txEventJson) {
+
+    TransactionEventData::Type eventType;
+    if (!deserializeTransactionEventType(txEventJson["eventType"] | "Updated", eventType)) {
+        return false;
+    }
+    txEvent.eventType = eventType;
+
+    if (txEventJson.containsKey("timestamp")) {
+        if (!txEvent.timestamp.setTime(txEventJson["timestamp"] | "_Undefined")) {
+            return false;
+        }
+    }
+
+    int bootNrIn = txEventJson["bootNr"] | -1;
+    if (bootNrIn >= 0 && bootNrIn <= std::numeric_limits<uint16_t>::max()) {
+        txEvent.bootNr = (uint16_t)bootNrIn;
+    } else {
+        return false;
+    }
+
+    TransactionEventTriggerReason triggerReason;
+    if (!deserializeTransactionEventTriggerReason(txEventJson["triggerReason"] | "_Undefined", triggerReason)) {
+        return false;
+    }
+    txEvent.triggerReason = triggerReason;
+    
+    if (txEventJson.containsKey("offline") && !txEventJson["offline"].is<bool>()) {
+        return false;
+    }
+    txEvent.offline = txEventJson["offline"] | false;
+
+    if (txEventJson.containsKey("numberOfPhasesUsed")) {
+        int numberOfPhasesUsedIn = txEventJson["numberOfPhasesUsed"] | -1;
+        if (numberOfPhasesUsedIn < 0) {
+            return false;
+        }
+        txEvent.numberOfPhasesUsed = numberOfPhasesUsedIn;
+    }
+
+    if (txEventJson.containsKey("cableMaxCurrent")) {
+        int cableMaxCurrentIn = txEventJson["cableMaxCurrent"] | -1;
+        if (cableMaxCurrentIn < 0) {
+            return false;
+        }
+        txEvent.cableMaxCurrent = cableMaxCurrentIn;
+    }
+
+    if (txEventJson.containsKey("reservationId")) {
+        int reservationIdIn = txEventJson["reservationId"] | -1;
+        if (reservationIdIn < 0) {
+            return false;
+        }
+        txEvent.reservationId = reservationIdIn;
+    }
+
+    if (txEventJson.containsKey("remoteStartId")) {
+        int remoteStartIdIn = txEventJson["remoteStartId"] | -1;
+        if (remoteStartIdIn < 0) {
+            return false;
+        }
+        txEvent.remoteStartId = remoteStartIdIn;
+    }
+
+    TransactionEventData::ChargingState chargingState;
+    if (!deserializeTransactionEventChargingState(txEventJson["chargingState"] | (const char*)nullptr, chargingState)) {
+        return false;
+    }
+    txEvent.chargingState = chargingState;
+
+    if (txEventJson.containsKey("idToken")) {
+        auto idToken = std::unique_ptr<IdToken>(new IdToken());
+        if (!idToken) {
+            MO_DBG_ERR("OOM");
+            return false;
+        }
+        if (!idToken->parseCstr(
+                    txEventJson["idToken"]["idToken"] | (const char*)nullptr, 
+                    txEventJson["idToken"]["type"]    | (const char*)nullptr)) {
+            return false;
+        }
+        txEvent.idToken = std::move(idToken);
+    }
+
+    if (txEventJson.containsKey("evse")) {
+        int evseId = txEventJson["evse"]["id"] | -1;
+        if (evseId < 0) {
+            return false;
+        }
+        if (txEventJson["evse"].containsKey("connectorId")) {
+            int connectorId = txEventJson["evse"]["connectorId"] | -1;
+            if (connectorId < 0) {
+                return false;
+            }
+            txEvent.evse = EvseId(evseId, connectorId);
+        } else {
+            txEvent.evse = EvseId(evseId);
+        }
+    }
+
+    //meterValue not supported yet
+
+    int opNrIn = txEventJson["opNr"] | -1;
+    if (opNrIn >= 0) {
+        txEvent.opNr = (unsigned int)opNrIn;
+    } else {
+        return false;
+    }
+
+    int attemptNrIn = txEventJson["attemptNr"] | -1;
+    if (attemptNrIn >= 0) {
+        txEvent.attemptNr = (unsigned int)attemptNrIn;
+    } else {
+        return false;
+    }
+
+    if (txEventJson.containsKey("attemptTime")) {
+        if (!txEvent.attemptTime.setTime(txEventJson["attemptTime"] | "_Undefined")) {
+            return false;
+        }
+    }
+
+    return true;
+}
+
+TransactionStoreEvse::TransactionStoreEvse(TransactionStore& txStore, unsigned int evseId, std::shared_ptr<FilesystemAdapter> filesystem) :
+        MemoryManaged("v201.Transactions.TransactionStore"),
+        txStore(txStore),
+        evseId(evseId),
+        filesystem(filesystem) {
+
+}
+
+bool TransactionStoreEvse::discoverStoredTx(unsigned int& txNrBeginOut, unsigned int& txNrEndOut) {
+
+    if (!filesystem) {
+        MO_DBG_DEBUG("no FS adapter");
+        return true;
+    }
+
+    char fnPrefix [MO_MAX_PATH_SIZE];
+    snprintf(fnPrefix, sizeof(fnPrefix), "tx201-%u-", evseId);
+    size_t fnPrefixLen = strlen(fnPrefix);
+
+    unsigned int txNrPivot = std::numeric_limits<unsigned int>::max();
+    unsigned int txNrBegin = 0, txNrEnd = 0;
+
+    auto ret = filesystem->ftw_root([fnPrefix, fnPrefixLen, &txNrPivot, &txNrBegin, &txNrEnd] (const char *fn) {
+        if (!strncmp(fn, fnPrefix, fnPrefixLen)) {
+            unsigned int parsedTxNr = 0;
+            for (size_t i = fnPrefixLen; fn[i] >= '0' && fn[i] <= '9'; i++) {
+                parsedTxNr *= 10;
+                parsedTxNr += fn[i] - '0';
+            }
+
+            if (txNrPivot == std::numeric_limits<unsigned int>::max()) {
+                txNrPivot = parsedTxNr;
+                txNrBegin = parsedTxNr;
+                txNrEnd = (parsedTxNr + 1) % MAX_TX_CNT;
+                return 0;
+            }
+
+            if ((parsedTxNr + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT < MAX_TX_CNT / 2) {
+                //parsedTxNr is after pivot point
+                if ((parsedTxNr + 1 + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT > (txNrEnd + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT) {
+                    txNrEnd = (parsedTxNr + 1) % MAX_TX_CNT;
+                }
+            } else if ((txNrPivot + MAX_TX_CNT - parsedTxNr) % MAX_TX_CNT < MAX_TX_CNT / 2) {
+                //parsedTxNr is before pivot point
+                if ((txNrPivot + MAX_TX_CNT - parsedTxNr) % MAX_TX_CNT > (txNrPivot + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT) {
+                    txNrBegin = parsedTxNr;
+                }
+            }
+
+            MO_DBG_DEBUG("found %s%u-*.json - Internal range from %u to %u (exclusive)", fnPrefix, parsedTxNr, txNrBegin, txNrEnd);
+        }
+        return 0;
+    });
+
+    if (ret == 0) {
+        txNrBeginOut = txNrBegin;
+        txNrEndOut = txNrEnd;
+        return true;
+    } else {
+        MO_DBG_ERR("fs error");
+        return false;
+    }
+}
+
+std::unique_ptr<Transaction> TransactionStoreEvse::loadTransaction(unsigned int txNr) {
+
+    if (!filesystem) {
+        MO_DBG_DEBUG("no FS adapter");
+        return nullptr;
+    }
+
+    char fnPrefix [MO_MAX_PATH_SIZE];
+    auto ret= snprintf(fnPrefix, sizeof(fnPrefix), "tx201-%u-%u-", evseId, txNr);
+    if (ret < 0 || (size_t)ret >= sizeof(fnPrefix)) {
+        MO_DBG_ERR("fn error");
+        return nullptr;
+    }
+    size_t fnPrefixLen = strlen(fnPrefix);
+
+    Vector<unsigned int> seqNos = makeVector<unsigned int>(getMemoryTag());
+
+    filesystem->ftw_root([fnPrefix, fnPrefixLen, &seqNos] (const char *fn) {
+        if (!strncmp(fn, fnPrefix, fnPrefixLen)) {
+            unsigned int parsedSeqNo = 0;
+            for (size_t i = fnPrefixLen; fn[i] >= '0' && fn[i] <= '9'; i++) {
+                parsedSeqNo *= 10;
+                parsedSeqNo += fn[i] - '0';
+            }
+
+            seqNos.push_back(parsedSeqNo);
+        }
+        return 0;
+    });
+
+    if (seqNos.empty()) {
+        MO_DBG_DEBUG("no tx at tx201-%u-%u", evseId, txNr);
+        return nullptr;
+    }
+
+    std::sort(seqNos.begin(), seqNos.end());
+
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
+    ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx201" "-%u-%u-%u.json", evseId, txNr, seqNos.back());
+    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("fn error: %i", ret);
+        return nullptr;
+    }
+
+    size_t msize;
+    if (filesystem->stat(fn, &msize) != 0) {
+        MO_DBG_ERR("tx201-%u-%u memory corruption", evseId, txNr);
+        return nullptr;
+    }
+
+    auto doc = FilesystemUtils::loadJson(filesystem, fn, getMemoryTag());
+
+    if (!doc) {
+        MO_DBG_ERR("memory corruption");
+        return nullptr;
+    }
+
+    auto transaction = std::unique_ptr<Transaction>(new Transaction());
+    if (!transaction) {
+        MO_DBG_ERR("OOM");
+        return nullptr;
+    }
+
+    transaction->evseId = evseId;
+    transaction->txNr = txNr;
+    transaction->seqNos = std::move(seqNos);
+
+    JsonObject txJson = (*doc)["tx"];
+
+    if (!deserializeTransaction(*transaction, txJson)) {
+        MO_DBG_ERR("deserialization error");
+        return nullptr;
+    }
+
+    //determine seqNoEnd and trim seqNos record
+    if (doc->containsKey("txEvent")) {
+        //last tx201 file contains txEvent -> txNoEnd is one place after tx201 file and seqNos is accurate
+        transaction->seqNoEnd = transaction->seqNos.back() + 1;
+    } else {
+        //last tx201 file contains only tx status information, but no txEvent -> remove from seqNos record and set seqNoEnd to this
+        transaction->seqNoEnd = transaction->seqNos.back();
+        transaction->seqNos.pop_back();
+    }
+
+    MO_DBG_DEBUG("loaded tx %u-%u, seqNos.size()=%zu", evseId, txNr, transaction->seqNos.size());
+
+    return transaction;
+}
+
+std::unique_ptr<Ocpp201::Transaction> TransactionStoreEvse::createTransaction(unsigned int txNr, const char *txId) {
+
+    //clean data which could still be here from a rolled-back transaction
+    if (!remove(txNr)) {
+        MO_DBG_ERR("txNr not clean");
+        return nullptr;
+    }
+
+    auto transaction = std::unique_ptr<Transaction>(new Transaction());
+    if (!transaction) {
+        MO_DBG_ERR("OOM");
+        return nullptr;
+    }
+
+    transaction->evseId = evseId;
+    transaction->txNr = txNr;
+
+    auto ret = snprintf(transaction->transactionId, sizeof(transaction->transactionId), "%s", txId);
+    if (ret < 0 || (size_t)ret >= sizeof(transaction->transactionId)) {
+        MO_DBG_ERR("invalid arg");
+        return nullptr;
+    }
+
+    if (!commit(transaction.get())) {
+        MO_DBG_ERR("FS error");
+        return nullptr;
+    }
+
+    return transaction;
+}
+
+std::unique_ptr<TransactionEventData> TransactionStoreEvse::createTransactionEvent(Transaction& tx) {
+
+    auto txEvent = std::unique_ptr<TransactionEventData>(new TransactionEventData(&tx, tx.seqNoEnd));
+    if (!txEvent) {
+        MO_DBG_ERR("OOM");
+        return nullptr;
+    }
+
+    //success
+    return txEvent;
+}
+
+std::unique_ptr<TransactionEventData> TransactionStoreEvse::loadTransactionEvent(Transaction& tx, unsigned int seqNo) {
+
+    if (!filesystem) {
+        MO_DBG_DEBUG("no FS adapter");
+        return nullptr;
+    }
+
+    bool found = false;
+    for (size_t i = 0; i < tx.seqNos.size(); i++) {
+        if (tx.seqNos[i] == seqNo) {
+            found = true;
+        }
+    }
+    if (!found) {
+        MO_DBG_DEBUG("%u-%u-%u does not exist", evseId, tx.txNr, seqNo);
+        return nullptr;
+    }
+
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx201" "-%u-%u-%u.json", evseId, tx.txNr, seqNo);
+    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("fn error: %i", ret);
+        return nullptr;
+    }
+
+    size_t msize;
+    if (filesystem->stat(fn, &msize) != 0) {
+        MO_DBG_ERR("seqNos out of sync: could not find %u-%u-%u", evseId, tx.txNr, seqNo);
+        return nullptr;
+    }
+
+    auto doc = FilesystemUtils::loadJson(filesystem, fn, getMemoryTag());
+
+    if (!doc) {
+        MO_DBG_ERR("memory corruption");
+        return nullptr;
+    }
+
+    if (!doc->containsKey("txEvent")) {
+        MO_DBG_DEBUG("%u-%u-%u does not contain txEvent", evseId, tx.txNr, seqNo);
+        return nullptr;
+    }
+
+    auto txEvent = std::unique_ptr<TransactionEventData>(new TransactionEventData(&tx, seqNo));
+    if (!txEvent) {
+        MO_DBG_ERR("OOM");
+        return nullptr;
+    }
+
+    if (!deserializeTransactionEvent(*txEvent, (*doc)["txEvent"])) {
+        MO_DBG_ERR("deserialization error");
+        return nullptr;
+    }
+
+    return txEvent;
+}
+
+bool TransactionStoreEvse::commit(Transaction& tx, TransactionEventData *txEvent) {
+
+    if (!filesystem) {
+        MO_DBG_DEBUG("no FS: nothing to commit");
+        return true;
+    }
+
+    unsigned int seqNo = 0;
+
+    if (txEvent) {
+        seqNo = txEvent->seqNo;
+    } else {
+        //update tx state in new or reused tx201 file
+        seqNo = tx.seqNoEnd;
+    }
+
+    size_t seqNosNewSize = tx.seqNos.size() + 1;
+    for (size_t i = 0; i < tx.seqNos.size(); i++) {
+        if (tx.seqNos[i] == seqNo) {
+            seqNosNewSize -= 1;
+            break;
+        }
+    }
+
+    // Check if to delete intermediate offline txEvent
+    if (seqNosNewSize > MO_TXEVENTRECORD_SIZE_V201) {
+        auto deltaMin = std::numeric_limits<unsigned int>::max();
+        size_t indexMin = tx.seqNos.size();
+        for (size_t i = 2; i + 1 <= tx.seqNos.size(); i++) { //always keep first and final txEvent
+            size_t t0 = tx.seqNos.size() - i - 1;
+            size_t t1 = tx.seqNos.size() - i;
+            size_t t2 = tx.seqNos.size() - i + 1;
+
+            auto delta = tx.seqNos[t2] - tx.seqNos[t0];
+
+            if (delta < deltaMin) {
+                deltaMin = delta;
+                indexMin = t1;
+            }
+        }
+
+        if (indexMin < tx.seqNos.size()) {
+            MO_DBG_DEBUG("delete intermediate txEvent %u-%u-%u - delta=%u", evseId, tx.txNr, tx.seqNos[indexMin], deltaMin);
+            remove(tx, tx.seqNos[indexMin]); //remove can call commit() again. Ensure that remove is not executed for last element
+        } else {
+            MO_DBG_ERR("internal error");
+            return false;
+        }
+    }
+
+    char fn [MO_MAX_PATH_SIZE] = {'\0'};
+    auto ret = snprintf(fn, MO_MAX_PATH_SIZE, MO_FILENAME_PREFIX "tx201" "-%u-%u-%u.json", evseId, tx.txNr, seqNo);
+    if (ret < 0 || ret >= MO_MAX_PATH_SIZE) {
+        MO_DBG_ERR("fn error: %i", ret);
+        return false;
+    }
+
+    auto txDoc = initJsonDoc("v201.Transactions.TransactionStoreEvse", 2048);
+
+    if (!serializeTransaction(tx, txDoc.createNestedObject("tx"))) {
+        MO_DBG_ERR("Serialization error");
+        return false;
+    }
+
+    if (txEvent && !serializeTransactionEvent(*txEvent, txDoc.createNestedObject("txEvent"))) {
+        MO_DBG_ERR("Serialization error");
+        return false;
+    }
+
+    if (!FilesystemUtils::storeJson(filesystem, fn, txDoc)) {
+        MO_DBG_ERR("FS error");
+        return false;
+    }
+
+    if (txEvent && seqNo == tx.seqNoEnd) {
+        tx.seqNos.push_back(seqNo);
+        tx.seqNoEnd++;
+    }
+
+    MO_DBG_DEBUG("comitted tx %u-%u-%u", evseId, tx.txNr, seqNo);
+
+    //success
+    return true;
+}
+
+bool TransactionStoreEvse::commit(Transaction *transaction) {
+    return commit(*transaction, nullptr);
+}
+
+bool TransactionStoreEvse::commit(TransactionEventData *txEvent) {
+    return commit(*txEvent->transaction, txEvent);
+}
+
+bool TransactionStoreEvse::remove(unsigned int txNr) {
+
+    if (!filesystem) {
+        MO_DBG_DEBUG("no FS: nothing to remove");
+        return true;
+    }
+
+    char fnPrefix [MO_MAX_PATH_SIZE];
+    auto ret= snprintf(fnPrefix, sizeof(fnPrefix), "tx201-%u-%u-", evseId, txNr);
+    if (ret < 0 || (size_t)ret >= sizeof(fnPrefix)) {
+        MO_DBG_ERR("fn error");
+        return false;
+    }
+    size_t fnPrefixLen = strlen(fnPrefix);
+
+    auto success = FilesystemUtils::remove_if(filesystem, [fnPrefix, fnPrefixLen] (const char *fn) {
+        return !strncmp(fn, fnPrefix, fnPrefixLen);
+    });
+
+    return success;
+}
+
+bool TransactionStoreEvse::remove(Transaction& tx, unsigned int seqNo) {
+
+    if (tx.seqNos.empty()) {
+        //nothing to do
+        return true;
+    }
+
+    if (tx.seqNos.back() == seqNo) {
+        //special case: deletion of last tx201 file could also delete information about tx. Make sure all tx-related
+        //information is commited into tx201 file at seqNoEnd, then delete file at seqNo
+
+        char fn [MO_MAX_PATH_SIZE];
+        auto ret = snprintf(fn, sizeof(fn), "%stx201-%u-%u-%u.json", MO_FILENAME_PREFIX, evseId, tx.txNr, tx.seqNoEnd);
+        if (ret < 0 || (size_t)ret >= sizeof(fn)) {
+            MO_DBG_ERR("fn error");
+            return false;
+        }
+
+        auto doc = FilesystemUtils::loadJson(filesystem, fn, getMemoryTag());
+        
+        if (!doc || !doc->containsKey("tx")) {
+            //no valid tx201 file at seqNoEnd. Commit tx into file seqNoEnd, then remove file at seqNo
+
+            if (!commit(tx, nullptr)) {
+                MO_DBG_ERR("fs error");
+                return false;
+            }
+        }
+
+        //seqNoEnd contains all tx data which should be persisted. Continue
+    }
+
+    bool found = false;
+    for (size_t i = 0; i < tx.seqNos.size(); i++) {
+        if (tx.seqNos[i] == seqNo) {
+            found = true;
+        }
+    }
+    if (!found) {
+        MO_DBG_DEBUG("%u-%u-%u does not exist", evseId, tx.txNr, seqNo);
+        return true;
+    }
+
+    bool success = true;
+
+    if (filesystem) {
+        char fn [MO_MAX_PATH_SIZE];
+        auto ret = snprintf(fn, sizeof(fn), "%stx201-%u-%u-%u.json", MO_FILENAME_PREFIX, evseId, tx.txNr, seqNo);
+        if (ret < 0 || (size_t)ret >= sizeof(fn)) {
+            MO_DBG_ERR("fn error");
+            return false;
+        }
+
+        size_t msize;
+        if (filesystem->stat(fn, &msize) == 0) {
+            success &= filesystem->remove(fn);
+        } else {
+            MO_DBG_ERR("internal error: seqNos out of sync");
+            (void)0;
+        }
+    }
+
+    if (success) {
+        auto it = tx.seqNos.begin();
+        while (it != tx.seqNos.end()) {
+            if (*it == seqNo) {
+                it = tx.seqNos.erase(it);
+            } else {
+                it++;
+            }
+        }
+    }
+
+    return success;
+}
+
+TransactionStore::TransactionStore(std::shared_ptr<FilesystemAdapter> filesystem, size_t numEvses) :
+        MemoryManaged{"v201.Transactions.TransactionStore"} {
+
+    for (unsigned int evseId = 0; evseId < MO_NUM_EVSEID && (size_t)evseId < numEvses; evseId++) {
+        evses[evseId] = new TransactionStoreEvse(*this, evseId, filesystem);
+    }
+}
+
+TransactionStore::~TransactionStore() {
+    for (unsigned int evseId = 0; evseId < MO_NUM_EVSEID && evses[evseId]; evseId++) {
+        delete evses[evseId];
+    }
+}
+
+TransactionStoreEvse *TransactionStore::getEvse(unsigned int evseId) {
+    if (evseId >= MO_NUM_EVSEID) {
+        return nullptr;
+    }
+    return evses[evseId];
+}
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Transactions/TransactionStore.h b/src/MicroOcpp/Model/Transactions/TransactionStore.h
index 7e4db699..c5d3421e 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionStore.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionStore.h
@@ -5,6 +5,7 @@
 #ifndef MO_TRANSACTIONSTORE_H
 #define MO_TRANSACTIONSTORE_H
 
+#include <MicroOcpp/Version.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/Memory.h>
@@ -54,4 +55,63 @@ class TransactionStore : public MemoryManaged {
 
 }
 
+#if MO_ENABLE_V201
+
+#ifndef MO_TXEVENTRECORD_SIZE_V201
+#define MO_TXEVENTRECORD_SIZE_V201 10 //maximum number of of txEvents per tx to hold on flash storage
+#endif
+
+namespace MicroOcpp {
+namespace Ocpp201 {
+
+class TransactionStore;
+
+class TransactionStoreEvse : public MemoryManaged {
+private:
+    TransactionStore& txStore;
+    const unsigned int evseId;
+
+    std::shared_ptr<FilesystemAdapter> filesystem;
+
+    bool serializeTransaction(Transaction& tx, JsonObject out);
+    bool serializeTransactionEvent(TransactionEventData& txEvent, JsonObject out);
+    bool deserializeTransaction(Transaction& tx, JsonObject in);
+    bool deserializeTransactionEvent(TransactionEventData& txEvent, JsonObject in);
+
+    bool commit(Transaction& transaction, TransactionEventData *transactionEvent);
+
+public:
+    TransactionStoreEvse(TransactionStore& txStore, unsigned int evseId, std::shared_ptr<FilesystemAdapter> filesystem);
+
+    bool discoverStoredTx(unsigned int& txNrBeginOut, unsigned int& txNrEndOut);
+
+    bool commit(Transaction *transaction);
+    bool commit(TransactionEventData *transactionEvent);
+
+    std::unique_ptr<Transaction> loadTransaction(unsigned int txNr);
+    std::unique_ptr<Transaction> createTransaction(unsigned int txNr, const char *txId);
+
+    std::unique_ptr<TransactionEventData> createTransactionEvent(Transaction& tx);
+    std::unique_ptr<TransactionEventData> loadTransactionEvent(Transaction& tx, unsigned int seqNo);
+
+    bool remove(unsigned int txNr);
+    bool remove(Transaction& tx, unsigned int seqNo);
+};
+
+class TransactionStore : public MemoryManaged {
+private:
+    TransactionStoreEvse *evses [MO_NUM_EVSEID] = {nullptr};
+public:
+    TransactionStore(std::shared_ptr<FilesystemAdapter> filesystem, size_t numEvses);
+
+    ~TransactionStore();
+
+    TransactionStoreEvse *getEvse(unsigned int evseId);
+};
+
+} //namespace Ocpp201
+} //namespace MicroOcpp
+
+#endif //MO_ENABLE_V201
+
 #endif
diff --git a/src/MicroOcpp/Model/Variables/Variable.cpp b/src/MicroOcpp/Model/Variables/Variable.cpp
index 4f676d0f..ee3f0229 100644
--- a/src/MicroOcpp/Model/Variables/Variable.cpp
+++ b/src/MicroOcpp/Model/Variables/Variable.cpp
@@ -165,13 +165,6 @@ bool Variable::isConstant() {
     return constant;
 }
 
-void Variable::detach() {
-    detached = true;
-}
-bool Variable::isDetached() {
-    return detached;
-}
-
 template <class T>
 struct VariableSingleData {
     T value = 0;
diff --git a/src/MicroOcpp/Model/Variables/Variable.h b/src/MicroOcpp/Model/Variables/Variable.h
index c64ffa46..79178303 100644
--- a/src/MicroOcpp/Model/Variables/Variable.h
+++ b/src/MicroOcpp/Model/Variables/Variable.h
@@ -177,8 +177,6 @@ class Variable : public MemoryManaged {
 
     AttributeTypeSet attributes;
 
-    bool detached = false; // MO-internal: if a conflicting declaration comes in, discard the old Variable
-
     // VariableMonitoringType (2.52)
     //std::vector<VariableMonitor> monitors; // uncomment when testing Monitors
 public:
@@ -224,9 +222,6 @@ class Variable : public MemoryManaged {
     //bool addMonitor(int id, bool transaction, float value, VariableMonitor::Type type, int severity);
     
     virtual uint16_t getWriteCount() = 0; //get write count (use this as a pre-check if the value changed)
-
-    void detach();
-    bool isDetached();
 };
 
 std::unique_ptr<Variable> makeVariable(Variable::InternalDataType dtype, Variable::AttributeTypeSet supportAttributes);
diff --git a/src/MicroOcpp/Model/Variables/VariableContainer.cpp b/src/MicroOcpp/Model/Variables/VariableContainer.cpp
index 1b99396d..0d751d8f 100644
--- a/src/MicroOcpp/Model/Variables/VariableContainer.cpp
+++ b/src/MicroOcpp/Model/Variables/VariableContainer.cpp
@@ -11,6 +11,7 @@
 #if MO_ENABLE_V201
 
 #include <MicroOcpp/Model/Variables/VariableContainer.h>
+#include <MicroOcpp/Core/FilesystemUtils.h>
 
 #include <string.h>
 
@@ -22,52 +23,273 @@ VariableContainer::~VariableContainer() {
 
 }
 
-VariableContainerVolatile::VariableContainerVolatile(const char *filename, bool accessible) :
-        VariableContainer(filename, accessible), MemoryManaged("v201.Variables.VariableContainerVolatile.", filename), variables(makeVector<std::unique_ptr<Variable>>(getMemoryTag())) {
+bool VariableContainer::commit() {
+    return true;
+}
+
+VariableContainerNonOwning::VariableContainerNonOwning() :
+            VariableContainer(), MemoryManaged("v201.Variables.VariableContainerNonOwning"), variables(makeVector<Variable*>(getMemoryTag())) {
 
 }
 
-VariableContainerVolatile::~VariableContainerVolatile() {
+size_t VariableContainerNonOwning::size() {
+    return variables.size();
+}
 
+Variable *VariableContainerNonOwning::getVariable(size_t i) {
+    return variables[i];
 }
 
-bool VariableContainerVolatile::load() {
-    return true;
+Variable *VariableContainerNonOwning::getVariable(const ComponentId& component, const char *variableName) {
+    for (size_t i = 0; i < variables.size(); i++) {
+        auto& var = variables[i];
+        if (!strcmp(var->getName(), variableName) &&
+                var->getComponentId().equals(component)) {
+            return var;
+        }
+    }
+    return nullptr;
 }
 
-bool VariableContainerVolatile::save() {
+bool VariableContainerNonOwning::add(Variable *variable) {
+    variables.push_back(variable);
     return true;
 }
 
-std::unique_ptr<Variable> VariableContainerVolatile::createVariable(Variable::InternalDataType dtype, Variable::AttributeTypeSet attributes) {
-    return makeVariable(dtype, attributes);
+bool VariableContainerOwning::checkWriteCountUpdated() {
+
+    decltype(trackWriteCount) writeCount = 0;
+
+    for (size_t i = 0; i < variables.size(); i++) {
+        writeCount += variables[i]->getWriteCount();
+    }
+
+    bool updated = writeCount != trackWriteCount;
+
+    trackWriteCount = writeCount;
+
+    return updated;
 }
 
-bool VariableContainerVolatile::add(std::unique_ptr<Variable> variable) {
-    variables.push_back(std::move(variable));
-    return true;
+VariableContainerOwning::VariableContainerOwning() :
+            VariableContainer(), MemoryManaged("v201.Variables.VariableContainerOwning"), variables(makeVector<std::unique_ptr<Variable>>(getMemoryTag())) {
+
 }
 
-size_t VariableContainerVolatile::size() const {
+VariableContainerOwning::~VariableContainerOwning() {
+    MO_FREE(filename);
+    filename = nullptr;
+}
+
+size_t VariableContainerOwning::size() {
     return variables.size();
 }
 
-Variable *VariableContainerVolatile::getVariable(size_t i) const {
+Variable *VariableContainerOwning::getVariable(size_t i) {
     return variables[i].get();
 }
 
-Variable *VariableContainerVolatile::getVariable(const ComponentId& component, const char *variableName) const {
-    for (auto it = variables.begin(); it != variables.end(); it++) {
-        if (!strcmp((*it)->getName(), variableName) &&
-                (*it)->getComponentId().equals(component)) {
-            return it->get();
+Variable *VariableContainerOwning::getVariable(const ComponentId& component, const char *variableName) {
+    for (size_t i = 0; i < variables.size(); i++) {
+        auto& var = variables[i];
+        if (!strcmp(var->getName(), variableName) &&
+                var->getComponentId().equals(component)) {
+            return var.get();
         }
     }
     return nullptr;
 }
 
-std::unique_ptr<VariableContainerVolatile> MicroOcpp::makeVariableContainerVolatile(const char *filename, bool accessible) {
-    return std::unique_ptr<VariableContainerVolatile>(new VariableContainerVolatile(filename, accessible));
+bool VariableContainerOwning::add(std::unique_ptr<Variable> variable) {
+    variables.push_back(std::move(variable));
+    return true;
+}
+
+bool VariableContainerOwning::enablePersistency(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename) {
+    this->filesystem = filesystem;
+
+    MO_FREE(this->filename);
+    this->filename = nullptr;
+
+    size_t fnsize = strlen(filename) + 1;
+
+    this->filename = static_cast<char*>(MO_MALLOC(getMemoryTag(), fnsize));
+    if (!this->filename) {
+        MO_DBG_ERR("OOM");
+        return false;
+    }
+
+    snprintf(this->filename, fnsize, "%s", filename);
+    return true;
+}
+
+bool VariableContainerOwning::load() {
+    if (loaded) {
+        return true;
+    }
+
+    if (!filesystem || !filename) {
+        return true; //persistency disabled - nothing to do
+    }
+
+    size_t file_size = 0;
+    if (filesystem->stat(filename, &file_size) != 0 // file does not exist
+            || file_size == 0) {                         // file exists, but empty
+        MO_DBG_DEBUG("Populate FS: create variables file");
+        return commit();
+    }
+
+    auto doc = FilesystemUtils::loadJson(filesystem, filename, getMemoryTag());
+    if (!doc) {
+        MO_DBG_ERR("failed to load %s", filename);
+        return false;
+    }
+    
+    JsonArray variablesJson = (*doc)["variables"];
+
+    for (JsonObject stored : variablesJson) {
+
+        const char *component = stored["component"] | (const char*)nullptr;
+        int evseId = stored["evseId"] | -1;
+        const char *name = stored["name"] | (const char*)nullptr;
+
+        if (!component || !name) {
+            MO_DBG_ERR("corrupt entry: %s", filename);
+            continue;
+        }
+
+        auto variablePtr = getVariable(ComponentId(component, EvseId(evseId)), name);
+        if (!variablePtr) {
+            MO_DBG_ERR("loaded variable does not exist: %s, %s, %s", filename, component, name);
+            continue;
+        }
+
+        auto& variable = *variablePtr;
+
+        switch (variable.getInternalDataType()) {
+            case Variable::InternalDataType::Int:
+                if (variable.hasAttribute(Variable::AttributeType::Actual)) variable.setInt(stored["valActual"] | 0, Variable::AttributeType::Actual);
+                if (variable.hasAttribute(Variable::AttributeType::Target)) variable.setInt(stored["valTarget"] | 0, Variable::AttributeType::Target);
+                if (variable.hasAttribute(Variable::AttributeType::MinSet)) variable.setInt(stored["valMinSet"] | 0, Variable::AttributeType::MinSet);
+                if (variable.hasAttribute(Variable::AttributeType::MaxSet)) variable.setInt(stored["valMaxSet"] | 0, Variable::AttributeType::MaxSet);
+                break;
+            case Variable::InternalDataType::Bool:
+                if (variable.hasAttribute(Variable::AttributeType::Actual)) variable.setBool(stored["valActual"] | false, Variable::AttributeType::Actual);
+                if (variable.hasAttribute(Variable::AttributeType::Target)) variable.setBool(stored["valTarget"] | false, Variable::AttributeType::Target);
+                if (variable.hasAttribute(Variable::AttributeType::MinSet)) variable.setBool(stored["valMinSet"] | false, Variable::AttributeType::MinSet);
+                if (variable.hasAttribute(Variable::AttributeType::MaxSet)) variable.setBool(stored["valMaxSet"] | false, Variable::AttributeType::MaxSet);
+                break;
+            case Variable::InternalDataType::String:
+                bool success = true;
+                if (variable.hasAttribute(Variable::AttributeType::Actual)) success &= variable.setString(stored["valActual"] | "", Variable::AttributeType::Actual);
+                if (variable.hasAttribute(Variable::AttributeType::Target)) success &= variable.setString(stored["valTarget"] | "", Variable::AttributeType::Target);
+                if (variable.hasAttribute(Variable::AttributeType::MinSet)) success &= variable.setString(stored["valMinSet"] | "", Variable::AttributeType::MinSet);
+                if (variable.hasAttribute(Variable::AttributeType::MaxSet)) success &= variable.setString(stored["valMaxSet"] | "", Variable::AttributeType::MaxSet);
+                if (!success) {
+                    MO_DBG_ERR("value error: %s, %s, %s", filename, component, name);
+                    continue;
+                }
+                break;
+        }
+    }
+
+    checkWriteCountUpdated(); // update trackWriteCount after load is completed
+
+    MO_DBG_DEBUG("Initialization finished");
+    loaded = true;
+    return true;
+}
+
+bool VariableContainerOwning::commit() {
+    if (!filesystem || !filename) {
+        //persistency disabled - nothing to do
+        return true;
+    }
+
+    if (!checkWriteCountUpdated()) {
+        return true; //nothing to be done
+    }
+
+    size_t jsonCapacity = JSON_OBJECT_SIZE(1) + JSON_ARRAY_SIZE(0);
+    size_t variableCapacity = 0;
+    for (size_t i = 0; i < variables.size(); i++) {
+        auto& variable = *variables[i];
+
+        if (!variable.isPersistent()) {
+            continue;
+        }
+
+        size_t addedJsonCapacity = JSON_ARRAY_SIZE(variableCapacity + 1) - JSON_ARRAY_SIZE(variableCapacity);
+
+        size_t storedEntities = 2; //component name, variable name will always be stored
+        storedEntities += variable.getComponentId().evse.id >= 0 ?                 1 : 0;
+        storedEntities += variable.hasAttribute(Variable::AttributeType::Actual) ? 1 : 0;
+        storedEntities += variable.hasAttribute(Variable::AttributeType::Target) ? 1 : 0;
+        storedEntities += variable.hasAttribute(Variable::AttributeType::MinSet) ? 1 : 0;
+        storedEntities += variable.hasAttribute(Variable::AttributeType::MaxSet) ? 1 : 0;
+
+        addedJsonCapacity += JSON_OBJECT_SIZE(storedEntities);
+
+        if (jsonCapacity + addedJsonCapacity <= MO_MAX_JSON_CAPACITY) {
+            jsonCapacity += addedJsonCapacity;
+            variableCapacity++;
+        } else {
+            MO_DBG_ERR("configs JSON exceeds maximum capacity (%s, %zu entries). Crop configs file (by FCFS)", filename, variables.size());
+            break;
+        }
+    }
+
+    auto doc = initJsonDoc(getMemoryTag(), jsonCapacity);
+
+    JsonArray variablesJson = doc.createNestedArray("variables");
+
+    for (size_t i = 0; i < variableCapacity; i++) {
+        auto& variable = *variables[i];
+
+        if (!variable.isPersistent()) {
+            continue;
+        }
+
+        auto stored = variablesJson.createNestedObject();
+
+        stored["component"] = variable.getComponentId().name;
+        if (variable.getComponentId().evse.id >= 0) {
+            stored["evseId"] = variable.getComponentId().evse.id;
+        }
+        stored["name"] = variable.getName();
+        
+        switch (variable.getInternalDataType()) {
+            case Variable::InternalDataType::Int:
+                if (variable.hasAttribute(Variable::AttributeType::Actual)) stored["valActual"] = variable.getInt(Variable::AttributeType::Actual);
+                if (variable.hasAttribute(Variable::AttributeType::Target)) stored["valTarget"] = variable.getInt(Variable::AttributeType::Target);
+                if (variable.hasAttribute(Variable::AttributeType::MinSet)) stored["valMinSet"] = variable.getInt(Variable::AttributeType::MinSet);
+                if (variable.hasAttribute(Variable::AttributeType::MaxSet)) stored["valMaxSet"] = variable.getInt(Variable::AttributeType::MaxSet);
+                break;
+            case Variable::InternalDataType::Bool:
+                if (variable.hasAttribute(Variable::AttributeType::Actual)) stored["valActual"] = variable.getBool(Variable::AttributeType::Actual);
+                if (variable.hasAttribute(Variable::AttributeType::Target)) stored["valTarget"] = variable.getBool(Variable::AttributeType::Target);
+                if (variable.hasAttribute(Variable::AttributeType::MinSet)) stored["valMinSet"] = variable.getBool(Variable::AttributeType::MinSet);
+                if (variable.hasAttribute(Variable::AttributeType::MaxSet)) stored["valMaxSet"] = variable.getBool(Variable::AttributeType::MaxSet);
+                break;
+            case Variable::InternalDataType::String:
+                if (variable.hasAttribute(Variable::AttributeType::Actual)) stored["valActual"] = variable.getString(Variable::AttributeType::Actual);
+                if (variable.hasAttribute(Variable::AttributeType::Target)) stored["valTarget"] = variable.getString(Variable::AttributeType::Target);
+                if (variable.hasAttribute(Variable::AttributeType::MinSet)) stored["valMinSet"] = variable.getString(Variable::AttributeType::MinSet);
+                if (variable.hasAttribute(Variable::AttributeType::MaxSet)) stored["valMaxSet"] = variable.getString(Variable::AttributeType::MaxSet);
+                break;
+        }
+    }
+
+
+    bool success = FilesystemUtils::storeJson(filesystem, filename, doc);
+
+    if (success) {
+        MO_DBG_DEBUG("Saving variables finished");
+    } else {
+        MO_DBG_ERR("could not save variables file: %s", filename);
+    }
+
+    return success;
 }
 
 #endif // MO_ENABLE_V201
diff --git a/src/MicroOcpp/Model/Variables/VariableContainer.h b/src/MicroOcpp/Model/Variables/VariableContainer.h
index fe247abe..d4dd0c69 100644
--- a/src/MicroOcpp/Model/Variables/VariableContainer.h
+++ b/src/MicroOcpp/Model/Variables/VariableContainer.h
@@ -16,61 +16,59 @@
 #include <memory>
 
 #include <MicroOcpp/Model/Variables/Variable.h>
+#include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/Memory.h>
 
 namespace MicroOcpp {
 
 class VariableContainer {
+public:
+    ~VariableContainer();
+    virtual size_t size() = 0;
+    virtual Variable *getVariable(size_t i) = 0;
+    virtual Variable *getVariable(const ComponentId& component, const char *variableName) = 0;
+
+    virtual bool commit();
+};
+
+class VariableContainerNonOwning : public VariableContainer, public MemoryManaged {
 private:
-    const char *filename;
-    bool accessible;
+    Vector<Variable*> variables;
 public:
-    VariableContainer(const char *filename, bool accessible) : filename(filename), accessible(accessible) { }
-
-    virtual ~VariableContainer();
-
-    const char *getFilename() {return filename;}
-    bool isAccessible() const {return accessible;} //accessible by OCPP server or only used as internal persistent store
-
-    virtual bool load() = 0; //called at the end of mocpp_intialize, to load the Variables with the stored value
-    virtual bool save() = 0;
-
-    /*
-     * Factory method to create Variable objects. This doesn't add the returned Variable to the managed
-     * variable store. Instead, the caller must add the returned Variable via `add(...)`
-     * The function signature consists of the requested low-level data type (Int, Bool, or String) and
-     * a composite key to identify the Variable to create (componentName x variableName x attribute type)
-     *
-     * Variable::InternalDataType dtype: internal low-level data type. Defines which value getters / setters are valid.
-     *         if dtype == InternalDataType::Int, then getInt() and setInt(...) are valid
-     *         if dtype == InternalDataType::String, then getString() and setString(...) are valid. Etc.
-     */
-    virtual std::unique_ptr<Variable> createVariable(Variable::InternalDataType dtype, Variable::AttributeTypeSet attributes) = 0; // factory method
-    virtual bool add(std::unique_ptr<Variable> variable) = 0;
-
-    virtual size_t size() const = 0;
-    virtual Variable *getVariable(size_t i) const = 0;
-    virtual Variable *getVariable(const ComponentId& component, const char *variableName) const = 0;
+    VariableContainerNonOwning();
+
+    size_t size() override;
+    Variable *getVariable(size_t i) override;
+    Variable *getVariable(const ComponentId& component, const char *variableName) override;
+
+    bool add(Variable *variable);
 };
 
-class VariableContainerVolatile : public VariableContainer, public MemoryManaged {
+class VariableContainerOwning : public VariableContainer, public MemoryManaged {
 private:
     Vector<std::unique_ptr<Variable>> variables;
+    std::shared_ptr<FilesystemAdapter> filesystem;
+    char *filename = nullptr;
+
+    uint16_t trackWriteCount = 0;
+    bool checkWriteCountUpdated();
+
+    bool loaded = false;
+
 public:
-    VariableContainerVolatile(const char *filename, bool accessible);
-    ~VariableContainerVolatile();
-
-    //VariableContainer definitions
-    bool load() override;
-    bool save() override;
-    std::unique_ptr<Variable> createVariable(Variable::InternalDataType dtype, Variable::AttributeTypeSet attributes) override;
-    bool add(std::unique_ptr<Variable> config) override;
-    size_t size() const override;
-    Variable *getVariable(size_t i) const override;
-    Variable *getVariable(const ComponentId& component, const char *variableName) const override;
-};
+    VariableContainerOwning();
+    ~VariableContainerOwning();
 
-std::unique_ptr<VariableContainerVolatile> makeVariableContainerVolatile(const char *filename, bool accessible);
+    size_t size() override;
+    Variable *getVariable(size_t i) override;
+    Variable *getVariable(const ComponentId& component, const char *variableName) override;
+
+    bool add(std::unique_ptr<Variable> variable);
+
+    bool enablePersistency(std::shared_ptr<FilesystemAdapter> filesystem, const char *filename); 
+    bool load(); //load variables from flash
+    bool commit() override;
+};
 
 } //end namespace MicroOcpp
 
diff --git a/src/MicroOcpp/Model/Variables/VariableService.cpp b/src/MicroOcpp/Model/Variables/VariableService.cpp
index c196f805..dcdc499d 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.cpp
+++ b/src/MicroOcpp/Model/Variables/VariableService.cpp
@@ -26,14 +26,20 @@
 namespace MicroOcpp {
 
 template <class T>
-VariableValidator<T>::VariableValidator(const ComponentId& component, const char *name, std::function<bool(T)> validate) :
-        MemoryManaged("v201.Variables.VariableValidator.", name), component(component), name(name), validate(validate) {
+VariableValidator<T>::VariableValidator(const ComponentId& component, const char *name, bool (*validateFn)(T, void*), void *userPtr) :
+        MemoryManaged("v201.Variables.VariableValidator.", name), component(component), name(name), userPtr(userPtr), validateFn(validateFn) {
 
 }
 
+template <class T>
+bool VariableValidator<T>::validate(T v) {
+    return validateFn(v, userPtr);
+}
+
 template <class T>
 VariableValidator<T> *getVariableValidator(Vector<VariableValidator<T>>& collection, const ComponentId& component, const char *name) {
-    for (auto& validator : collection) {
+    for (size_t i = 0; i < collection.size(); i++) {
+        auto& validator = collection[i];
         if (!strcmp(name, validator.name) && component.equals(validator.component)) {
             return &validator;
         }
@@ -53,108 +59,90 @@ VariableValidator<const char*> *VariableService::getValidatorString(const Compon
     return getVariableValidator<const char*>(validatorString, component, name);
 }
 
-std::unique_ptr<VariableContainer> VariableService::createContainer(const char *filename, bool accessible) const {
-    //create non-persistent Variable store (i.e. lives only in RAM) if
-    //     - Flash FS usage is switched off OR
-    //     - Filename starts with "/volatile"
-//    if (!filesystem ||
-//                 !strncmp(filename, MO_VARIABLE_VOLATILE, strlen(MO_VARIABLE_VOLATILE))) {
-        return makeVariableContainerVolatile(filename, accessible);
-//    } else {
-//        //create persistent Variable store. This is the normal case
-//        return makeVariableContainerFlash(filesystem, filename, accessible);
-//    }
-}
-
-void VariableService::addContainer(std::shared_ptr<VariableContainer> container) {
-    containers.push_back(std::move(container));
+VariableContainerOwning& VariableService::getContainerInternalByVariable(const ComponentId& component, const char *name) {
+    unsigned int hash = 0;
+    for (size_t i = 0; i < strlen(component.name); i++) {
+        hash += (unsigned int)component.name[i];
+    }
+    if (component.evse.id >= 0)
+        hash += (unsigned int)component.evse.id;
+    if (component.evse.connectorId >= 0)
+        hash += (unsigned int)component.evse.connectorId;
+    for (size_t i = 0; i < strlen(name); i++) {
+        hash += (unsigned int)name[i];
+    }
+    return containersInternal[hash % MO_VARIABLESTORE_BUCKETS];
 }
 
-std::shared_ptr<VariableContainer> VariableService::getContainer(const char *filename) {
-    for (auto& container : containers) {
-        if (!strcmp(filename, container->getFilename())) {
-            return container;
-        }
-    }
-    return nullptr;
+void VariableService::addContainer(VariableContainer *container) {
+    containers.push_back(container);
 }
 
 template <class T>
-bool registerVariableValidator(Vector<VariableValidator<T>>& collection, const ComponentId& component, const char *name, std::function<bool(T)> validate) {
+bool registerVariableValidator(Vector<VariableValidator<T>>& collection, const ComponentId& component, const char *name, bool (*validate)(T, void*), void *userPtr) {
     for (auto it = collection.begin(); it != collection.end(); it++) {
         if (!strcmp(name, it->name) && component.equals(it->component)) {
             collection.erase(it);
             break;
         }
     }
-    collection.emplace_back(component, name, validate);
+    collection.emplace_back(component, name, validate, userPtr);
     return true;
 }
 
 template <>
-bool VariableService::registerValidator<int>(const ComponentId& component, const char *name, std::function<bool(int)> validate) {
-    return registerVariableValidator<int>(validatorInt, component, name, validate);
+bool VariableService::registerValidator<int>(const ComponentId& component, const char *name, bool (*validate)(int, void*), void *userPtr) {
+    return registerVariableValidator<int>(validatorInt, component, name, validate, userPtr);
 }
 
 template <>
-bool VariableService::registerValidator<bool>(const ComponentId& component, const char *name, std::function<bool(bool)> validate) {
-    return registerVariableValidator<bool>(validatorBool, component, name, validate);
+bool VariableService::registerValidator<bool>(const ComponentId& component, const char *name, bool (*validate)(bool, void*), void *userPtr) {
+    return registerVariableValidator<bool>(validatorBool, component, name, validate, userPtr);
 }
 
 template <>
-bool VariableService::registerValidator<const char*>(const ComponentId& component, const char *name, std::function<bool(const char*)> validate) {
-    return registerVariableValidator<const char*>(validatorString, component, name, validate);
+bool VariableService::registerValidator<const char*>(const ComponentId& component, const char *name, bool (*validate)(const char*, void*), void *userPtr) {
+    return registerVariableValidator<const char*>(validatorString, component, name, validate, userPtr);
 }
 
-VariableContainer *VariableService::declareContainer(const char *filename, bool accessible) {
-
-    auto container = getContainer(filename);
-    
-    if (!container) {
-        MO_DBG_DEBUG("init new configurations container: %s", filename);
-
-        container = createContainer(filename, accessible);
-        if (!container) {
-            MO_DBG_ERR("OOM");
-            return nullptr;
-        }
-        containers.push_back(container);
-    }
+Variable *VariableService::getVariable(const ComponentId& component, const char *name) {
 
-    if (container->isAccessible() != accessible) {
-        MO_DBG_ERR("%s: conflicting accessibility declarations (expect %s)", filename, container->isAccessible() ? "accessible" : "inaccessible");
+    if (auto variable = getContainerInternalByVariable(component, name).getVariable(component, name)) {
+        return variable;
     }
 
-    return container.get();
-}
-
-Variable *VariableService::getVariable(Variable::InternalDataType type, const ComponentId& component, const char *name, bool accessible) {
-    for (auto& container : containers) {
+    for (size_t i = 0; i < containers.size(); i++) {
+        auto container = containers[containers.size() - i - 1]; //search from back, because internal containers at front don't contain variable
         if (auto variable = container->getVariable(component, name)) {
-            if (variable->isDetached()) {
-                continue;
-            }
-            if (variable->getInternalDataType() != type) {
-                MO_DBG_ERR("conflicting type for %s - remove old variable", name);
-                variable->detach();
-                continue;
-            }
-            if (container->isAccessible() != accessible) {
-                MO_DBG_ERR("conflicting accessibility for %s", name);
-            }
             return variable;
         }
     }
+
     return nullptr;
 }
 
 VariableService::VariableService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) :
             MemoryManaged("v201.Variables.VariableService"),
             context(context), filesystem(filesystem),
-            containers(makeVector<std::shared_ptr<VariableContainer>>(getMemoryTag())),
+            containers(makeVector<VariableContainer*>(getMemoryTag())),
             validatorInt(makeVector<VariableValidator<int>>(getMemoryTag())),
             validatorBool(makeVector<VariableValidator<bool>>(getMemoryTag())),
             validatorString(makeVector<VariableValidator<const char*>>(getMemoryTag())) {
+    
+    containers.reserve(MO_VARIABLESTORE_BUCKETS + 1);
+
+    for (unsigned int i = 0; i < MO_VARIABLESTORE_BUCKETS; i++) {
+        char fn [MO_MAX_PATH_SIZE];
+        auto ret = snprintf(fn, sizeof(fn), "%s%02x%s", MO_VARIABLESTORE_FN_PREFIX, i, MO_VARIABLESTORE_FN_SUFFIX);
+        if (ret < 0 || (size_t)ret >= sizeof(fn)) {
+            MO_DBG_ERR("fn error");
+            continue;
+        }
+        containersInternal[i].enablePersistency(filesystem, fn);
+        containers.push_back(&containersInternal[i]);
+    }
+    containers.push_back(&containerExternal);
+
     context.getOperationRegistry().registerOperation("SetVariables", [this] () {
         return new Ocpp201::SetVariables(*this);});
     context.getOperationRegistry().registerOperation("GetVariables", [this] () {
@@ -183,11 +171,15 @@ bool loadVariableFactoryDefault<const char*>(Variable& variable, const char *fac
     return variable.setString(factoryDef);
 }
 
-void loadVariableCharacteristics(Variable& variable, Variable::Mutability mutability, bool rebootRequired, Variable::InternalDataType defaultDataType) {
+void loadVariableCharacteristics(Variable& variable, Variable::Mutability mutability, bool persistent, bool rebootRequired, Variable::InternalDataType defaultDataType) {
     if (variable.getMutability() == Variable::Mutability::ReadWrite) {
         variable.setMutability(mutability);
     }
 
+    if (persistent) {
+        variable.setPersistent();
+    }
+
     if (rebootRequired) {
         variable.setRebootRequired();
     }
@@ -216,17 +208,13 @@ template<> Variable::InternalDataType getInternalDataType<bool>() {return Variab
 template<> Variable::InternalDataType getInternalDataType<const char*>() {return Variable::InternalDataType::String;}
 
 template<class T>
-Variable *VariableService::declareVariable(const ComponentId& component, const char *name, T factoryDefault, const char *containerPath, Variable::Mutability mutability, Variable::AttributeTypeSet attributes, bool rebootRequired, bool accessible) {
+Variable *VariableService::declareVariable(const ComponentId& component, const char *name, T factoryDefault, Variable::Mutability mutability, bool persistent, Variable::AttributeTypeSet attributes, bool rebootRequired) {
 
-    auto res = getVariable(getInternalDataType<T>(), component, name, accessible);
+    auto res = getVariable(component, name);
     if (!res) {
-        auto container = declareContainer(containerPath, accessible);
-        if (!container) {
-            return nullptr;
-        }
-
-        auto variable = container->createVariable(getInternalDataType<T>(), attributes);
+        auto variable = makeVariable(getInternalDataType<T>(), attributes);
         if (!variable) {
+            MO_DBG_ERR("OOM");
             return nullptr;
         }
 
@@ -239,24 +227,32 @@ Variable *VariableService::declareVariable(const ComponentId& component, const c
 
         res = variable.get();
 
-        if (!container->add(std::move(variable))) {
+        if (!getContainerInternalByVariable(component, name).add(std::move(variable))) {
             return nullptr;
         }
     }
 
-    loadVariableCharacteristics(*res, mutability, rebootRequired, getInternalDataType<T>());
+    loadVariableCharacteristics(*res, mutability, persistent, rebootRequired, getInternalDataType<T>());
     return res;
 }
 
-template Variable *VariableService::declareVariable<int>(const ComponentId&, const char*, int, const char*, Variable::Mutability, Variable::AttributeTypeSet, bool, bool);
-template Variable *VariableService::declareVariable<bool>(const ComponentId&, const char*, bool, const char*, Variable::Mutability, Variable::AttributeTypeSet, bool, bool);
-template Variable *VariableService::declareVariable<const char*>(const ComponentId&, const char*, const char*, const char*, Variable::Mutability, Variable::AttributeTypeSet, bool, bool);
+template Variable *VariableService::declareVariable<int>(        const ComponentId&, const char*, int,         Variable::Mutability, bool, Variable::AttributeTypeSet, bool);
+template Variable *VariableService::declareVariable<bool>(       const ComponentId&, const char*, bool,        Variable::Mutability, bool, Variable::AttributeTypeSet, bool);
+template Variable *VariableService::declareVariable<const char*>(const ComponentId&, const char*, const char*, Variable::Mutability, bool, Variable::AttributeTypeSet, bool);
+
+bool VariableService::addVariable(Variable *variable) {
+    return containerExternal.add(variable);
+}
+
+bool VariableService::addVariable(std::unique_ptr<Variable> variable) {
+    return getContainerInternalByVariable(variable->getComponentId(), variable->getName()).add(std::move(variable));
+}
 
 bool VariableService::commit() {
     bool success = true;
 
-    for (auto& container : containers) {
-        if (!container->save()) {
+    for (size_t i = 0; i < containers.size(); i++) {
+        if (!containers[i]->commit()) {
             success = false;
         }
     }
@@ -269,11 +265,9 @@ SetVariableStatus VariableService::setVariable(Variable::AttributeType attrType,
     Variable *variable = nullptr;
 
     bool foundComponent = false;
-    for (const auto& container : containers) {
-        if (!container->isAccessible()) {
-            // container intended for internal use only
-            continue;
-        }
+    for (size_t i = 0; i < containers.size(); i++) {
+        auto container = containers[i];
+
         for (size_t i = 0; i < container->size(); i++) {
             auto entry = container->getVariable(i);
 
@@ -406,7 +400,9 @@ SetVariableStatus VariableService::setVariable(Variable::AttributeType attrType,
 GetVariableStatus VariableService::getVariable(Variable::AttributeType attrType, const ComponentId& component, const char *variableName, Variable **result) {
 
     bool foundComponent = false;
-    for (const auto& container : containers) {
+    for (size_t i = 0; i < containers.size(); i++) {
+        auto container = containers[i];
+
         for (size_t i = 0; i < container->size(); i++) {
             auto variable = container->getVariable(i);
 
@@ -446,11 +442,9 @@ GenericDeviceModelStatus VariableService::getBaseReport(int requestId, ReportBas
 
     Vector<Variable*> variables = makeVector<Variable*>(getMemoryTag());
 
-    for (const auto& container : containers) {
-        if (!container->isAccessible()) {
-            // container intended for internal use only
-            continue;
-        }
+    for (size_t i = 0; i < containers.size(); i++) {
+        auto container = containers[i];
+
         for (size_t i = 0; i < container->size(); i++) {
             auto variable = container->getVariable(i);
 
diff --git a/src/MicroOcpp/Model/Variables/VariableService.h b/src/MicroOcpp/Model/Variables/VariableService.h
index 0fff37d3..d4621053 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.h
+++ b/src/MicroOcpp/Model/Variables/VariableService.h
@@ -12,7 +12,6 @@
 #include <stdint.h>
 #include <memory>
 #include <limits>
-#include <functional>
 
 #include <MicroOcpp/Version.h>
 
@@ -23,16 +22,12 @@
 #include <MicroOcpp/Core/FilesystemAdapter.h>
 #include <MicroOcpp/Core/Memory.h>
 
-#ifndef MO_VARIABLE_FN
-#define MO_VARIABLE_FN (MO_FILENAME_PREFIX "ocpp-vars.jsn")
+#ifndef MO_VARIABLESTORE_FN_PREFIX
+#define MO_VARIABLESTORE_FN_PREFIX (MO_FILENAME_PREFIX "ocpp-vars-")
 #endif
 
-#ifndef MO_VARIABLE_VOLATILE
-#define MO_VARIABLE_VOLATILE "/volatile"
-#endif
-
-#ifndef MO_VARIABLE_INTERNAL_FN
-#define MO_VARIABLE_INTERNAL_FN (MO_FILENAME_PREFIX "mo-vars.jsn")
+#ifndef MO_VARIABLESTORE_FN_SUFFIX
+#define MO_VARIABLESTORE_FN_SUFFIX ".jsn"
 #endif
 
 namespace MicroOcpp {
@@ -41,17 +36,26 @@ template <class T>
 struct VariableValidator : public MemoryManaged {
     ComponentId component;
     const char *name;
-    std::function<bool(T)> validate;
-    VariableValidator(const ComponentId& component, const char *name, std::function<bool(T)> validate);
+    void *userPtr;
+    bool (*validateFn)(T, void*);
+    VariableValidator(const ComponentId& component, const char *name, bool (*validate)(T, void*), void *userPtr);
+    bool validate(T);
 };
 
 class Context;
 
+#ifndef MO_VARIABLESTORE_BUCKETS
+#define MO_VARIABLESTORE_BUCKETS 8
+#endif
+
 class VariableService : public MemoryManaged {
 private:
     Context& context;
     std::shared_ptr<FilesystemAdapter> filesystem;
-    Vector<std::shared_ptr<VariableContainer>> containers;
+    Vector<VariableContainer*> containers;
+    VariableContainerNonOwning containerExternal;
+    VariableContainerOwning containersInternal [MO_VARIABLESTORE_BUCKETS];
+    VariableContainerOwning& getContainerInternalByVariable(const ComponentId& component, const char *name);
 
     Vector<VariableValidator<int>> validatorInt;
     Vector<VariableValidator<bool>> validatorBool;
@@ -60,27 +64,25 @@ class VariableService : public MemoryManaged {
     VariableValidator<int> *getValidatorInt(const ComponentId& component, const char *name);
     VariableValidator<bool> *getValidatorBool(const ComponentId& component, const char *name);
     VariableValidator<const char*> *getValidatorString(const ComponentId& component, const char *name);
-
-    std::unique_ptr<VariableContainer> createContainer(const char *filename, bool accessible) const;
-
-    VariableContainer *declareContainer(const char *filename, bool accessible);
-
-    Variable *getVariable(Variable::InternalDataType type, const ComponentId& component, const char *name, bool accessible);
-
 public:
     VariableService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem);
 
+    //Get Variable. If not existent, create Variable owned by MO and return
     template <class T> 
-    Variable *declareVariable(const ComponentId& component, const char *name, T factoryDefault, const char *containerPath = MO_VARIABLE_FN, Variable::Mutability mutability = Variable::Mutability::ReadWrite, Variable::AttributeTypeSet attributes = Variable::AttributeTypeSet(), bool rebootRequired = false, bool accessible = true);
+    Variable *declareVariable(const ComponentId& component, const char *name, T factoryDefault, Variable::Mutability mutability = Variable::Mutability::ReadWrite, bool persistent = true, Variable::AttributeTypeSet attributes = Variable::AttributeTypeSet(), bool rebootRequired = false);
 
-    bool commit();
+    bool addVariable(Variable *variable); //Add Variable without transferring ownership
+    bool addVariable(std::unique_ptr<Variable> variable); //Add Variable and transfer ownership
 
-    void addContainer(std::shared_ptr<VariableContainer> container);
+    //Get Variable. If not existent, return nullptr
+    Variable *getVariable(const ComponentId& component, const char *name);
+
+    bool commit();
 
-    std::shared_ptr<VariableContainer> getContainer(const char *filename);
+    void addContainer(VariableContainer *container);
 
     template <class T>
-    bool registerValidator(const ComponentId& component, const char *name, std::function<bool(T)> validate);
+    bool registerValidator(const ComponentId& component, const char *name, bool (*validate)(T, void*), void *userPtr = nullptr);
 
     SetVariableStatus setVariable(Variable::AttributeType attrType, const char *attrVal, const ComponentId& component, const char *variableName);
 
diff --git a/src/MicroOcpp/Operations/RequestStartTransaction.cpp b/src/MicroOcpp/Operations/RequestStartTransaction.cpp
index 1b6c0b8f..1b37f051 100644
--- a/src/MicroOcpp/Operations/RequestStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RequestStartTransaction.cpp
@@ -43,7 +43,7 @@ void RequestStartTransaction::processReq(JsonObject payload) {
         return;
     }
 
-    status = rcService.requestStartTransaction(evseId, remoteStartId, idToken, transaction);
+    status = rcService.requestStartTransaction(evseId, remoteStartId, idToken, transactionId, sizeof(transactionId));
 }
 
 std::unique_ptr<JsonDoc> RequestStartTransaction::createConf(){
diff --git a/src/MicroOcpp/Operations/RequestStartTransaction.h b/src/MicroOcpp/Operations/RequestStartTransaction.h
index dad7d5ae..4ee19761 100644
--- a/src/MicroOcpp/Operations/RequestStartTransaction.h
+++ b/src/MicroOcpp/Operations/RequestStartTransaction.h
@@ -26,6 +26,7 @@ class RequestStartTransaction : public Operation, public MemoryManaged {
 
     RequestStartStopStatus status;
     std::shared_ptr<Ocpp201::Transaction> transaction;
+    char transactionId [MO_TXID_LEN_MAX + 1] = {'\0'};
 
     const char *errorCode = nullptr;
 public:
diff --git a/src/MicroOcpp/Operations/TransactionEvent.cpp b/src/MicroOcpp/Operations/TransactionEvent.cpp
index 16df68cf..12d91afb 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.cpp
+++ b/src/MicroOcpp/Operations/TransactionEvent.cpp
@@ -14,7 +14,7 @@
 using namespace MicroOcpp::Ocpp201;
 using MicroOcpp::JsonDoc;
 
-TransactionEvent::TransactionEvent(Model& model, std::shared_ptr<TransactionEventData> txEvent)
+TransactionEvent::TransactionEvent(Model& model, TransactionEventData *txEvent)
         : MemoryManaged("v201.Operation.", "TransactionEvent"), model(model), txEvent(txEvent) {
 
 }
@@ -51,97 +51,18 @@ std::unique_ptr<JsonDoc> TransactionEvent::createReq() {
     auto doc = makeJsonDoc(getMemoryTag(), capacity);
     JsonObject payload = doc->to<JsonObject>();
 
-    const char *eventType = "";
-    switch (txEvent->eventType) {
-        case TransactionEventData::Type::Ended:
-            eventType = "Ended";
-            break;
-        case TransactionEventData::Type::Started:
-            eventType = "Started";
-            break;
-        case TransactionEventData::Type::Updated:
-            eventType = "Updated";
-            break;
-    }
-
-    payload["eventType"] = eventType;
+    payload["eventType"] = serializeTransactionEventType(txEvent->eventType);
 
     char timestamp [JSONDATE_LENGTH + 1];
     txEvent->timestamp.toJsonString(timestamp, JSONDATE_LENGTH + 1);
     payload["timestamp"] = timestamp;
 
-    const char *triggerReason = "";
-    switch(txEvent->triggerReason) {
-        case TransactionEventTriggerReason::UNDEFINED:
-            MO_DBG_ERR("internal error");
-            break;
-        case TransactionEventTriggerReason::Authorized:
-            triggerReason = "Authorized";
-            break;
-        case TransactionEventTriggerReason::CablePluggedIn:
-            triggerReason = "CablePluggedIn";
-            break;
-        case TransactionEventTriggerReason::ChargingRateChanged:
-            triggerReason = "ChargingRateChanged";
-            break;
-        case TransactionEventTriggerReason::ChargingStateChanged:
-            triggerReason = "ChargingStateChanged";
-            break;
-        case TransactionEventTriggerReason::Deauthorized:
-            triggerReason = "Deauthorized";
-            break;
-        case TransactionEventTriggerReason::EnergyLimitReached:
-            triggerReason = "EnergyLimitReached";
-            break;
-        case TransactionEventTriggerReason::EVCommunicationLost:
-            triggerReason = "EVCommunicationLost";
-            break;
-        case TransactionEventTriggerReason::EVConnectTimeout:
-            triggerReason = "EVConnectTimeout";
-            break;
-        case TransactionEventTriggerReason::MeterValueClock:
-            triggerReason = "MeterValueClock";
-            break;
-        case TransactionEventTriggerReason::MeterValuePeriodic:
-            triggerReason = "MeterValuePeriodic";
-            break;
-        case TransactionEventTriggerReason::TimeLimitReached:
-            triggerReason = "TimeLimitReached";
-            break;
-        case TransactionEventTriggerReason::Trigger:
-            triggerReason = "Trigger";
-            break;
-        case TransactionEventTriggerReason::UnlockCommand:
-            triggerReason = "UnlockCommand";
-            break;
-        case TransactionEventTriggerReason::StopAuthorized:
-            triggerReason = "StopAuthorized";
-            break;
-        case TransactionEventTriggerReason::EVDeparted:
-            triggerReason = "EVDeparted";
-            break;
-        case TransactionEventTriggerReason::EVDetected:
-            triggerReason = "EVDetected";
-            break;
-        case TransactionEventTriggerReason::RemoteStop:
-            triggerReason = "RemoteStop";
-            break;
-        case TransactionEventTriggerReason::RemoteStart:
-            triggerReason = "RemoteStart";
-            break;
-        case TransactionEventTriggerReason::AbnormalCondition:
-            triggerReason = "AbnormalCondition";
-            break;
-        case TransactionEventTriggerReason::SignedDataReceived:
-            triggerReason = "SignedDataReceived";
-            break;
-        case TransactionEventTriggerReason::ResetCommand:
-            triggerReason = "ResetCommand";
-            break;
+    if (serializeTransactionEventTriggerReason(txEvent->triggerReason)) {
+        payload["triggerReason"] = serializeTransactionEventTriggerReason(txEvent->triggerReason);
+    } else {
+        MO_DBG_ERR("serialization error");
     }
 
-    payload["triggerReason"] = triggerReason;
-
     payload["seqNo"] = txEvent->seqNo;
 
     if (txEvent->offline) {
@@ -163,96 +84,13 @@ std::unique_ptr<JsonDoc> TransactionEvent::createReq() {
     JsonObject transactionInfo = payload.createNestedObject("transactionInfo");
     transactionInfo["transactionId"] = txEvent->transaction->transactionId;
 
-    const char *chargingState = nullptr;
-    switch (txEvent->chargingState) {
-        case TransactionEventData::ChargingState::UNDEFINED:
-            // optional, okay
-            break;
-        case TransactionEventData::ChargingState::Charging:
-            chargingState = "Charging";
-            break;
-        case TransactionEventData::ChargingState::EVConnected:
-            chargingState = "EVConnected";
-            break;
-        case TransactionEventData::ChargingState::SuspendedEV:
-            chargingState = "SuspendedEV";
-            break;
-        case TransactionEventData::ChargingState::SuspendedEVSE:
-            chargingState = "SuspendedEVSE";
-            break;
-        case TransactionEventData::ChargingState::Idle:
-            chargingState = "Idle";
-            break;
-    }
-    if (chargingState) { // optional
-        transactionInfo["chargingState"] = chargingState;
+    if (serializeTransactionEventChargingState(txEvent->chargingState)) { // optional
+        transactionInfo["chargingState"] = serializeTransactionEventChargingState(txEvent->chargingState);
     }
 
-    const char *stoppedReason = nullptr;
-    switch (txEvent->transaction->stopReason) {
-        case Transaction::StopReason::UNDEFINED:
-            // optional, okay
-            break;
-        case Transaction::StopReason::Local: 
-            // omit reason Local
-            break;
-        case Transaction::StopReason::DeAuthorized: 
-            stoppedReason = "DeAuthorized"; 
-            break;
-        case Transaction::StopReason::EmergencyStop: 
-            stoppedReason = "EmergencyStop"; 
-            break;
-        case Transaction::StopReason::EnergyLimitReached: 
-            stoppedReason = "EnergyLimitReached";
-            break;
-        case Transaction::StopReason::EVDisconnected: 
-            stoppedReason = "EVDisconnected";
-            break;
-        case Transaction::StopReason::GroundFault: 
-            stoppedReason = "GroundFault";
-            break;
-        case Transaction::StopReason::ImmediateReset:
-            stoppedReason = "ImmediateReset";
-            break;
-        case Transaction::StopReason::LocalOutOfCredit:
-            stoppedReason = "LocalOutOfCredit";
-            break;
-        case Transaction::StopReason::MasterPass:
-            stoppedReason = "MasterPass";
-            break;
-        case Transaction::StopReason::Other:
-            stoppedReason = "Other";
-            break;
-        case Transaction::StopReason::OvercurrentFault:
-            stoppedReason = "OvercurrentFault";
-            break;
-        case Transaction::StopReason::PowerLoss:
-            stoppedReason = "PowerLoss";
-            break;
-        case Transaction::StopReason::PowerQuality:
-            stoppedReason = "PowerQuality";
-            break;
-        case Transaction::StopReason::Reboot:
-            stoppedReason = "Reboot";
-            break;
-        case Transaction::StopReason::Remote:
-            stoppedReason = "Remote";
-            break;
-        case Transaction::StopReason::SOCLimitReached:
-            stoppedReason = "SOCLimitReached";
-            break;
-        case Transaction::StopReason::StoppedByEV:
-            stoppedReason = "StoppedByEV";
-            break;
-        case Transaction::StopReason::TimeLimitReached:
-            stoppedReason = "TimeLimitReached";
-            break;
-        case Transaction::StopReason::Timeout:
-            stoppedReason = "Timeout";
-            break;
-    }
-    if (stoppedReason) { // optional
-        transactionInfo["stoppedReason"] = stoppedReason;
+    if (txEvent->transaction->stoppedReason != Transaction::StoppedReason::Local &&
+            serializeTransactionStoppedReason(txEvent->transaction->stoppedReason)) { // optional
+        transactionInfo["stoppedReason"] = serializeTransactionStoppedReason(txEvent->transaction->stoppedReason);
     }
 
     if (txEvent->remoteStartId >= 0) {
diff --git a/src/MicroOcpp/Operations/TransactionEvent.h b/src/MicroOcpp/Operations/TransactionEvent.h
index 0df02ba0..af8bbf86 100644
--- a/src/MicroOcpp/Operations/TransactionEvent.h
+++ b/src/MicroOcpp/Operations/TransactionEvent.h
@@ -22,12 +22,12 @@ class TransactionEventData;
 class TransactionEvent : public Operation, public MemoryManaged {
 private:
     Model& model;
-    std::shared_ptr<TransactionEventData> txEvent;
+    TransactionEventData *txEvent;
 
     const char *errorCode = nullptr;
 public:
 
-    TransactionEvent(Model& model, std::shared_ptr<TransactionEventData> txEvent);
+    TransactionEvent(Model& model, TransactionEventData *txEvent);
 
     const char* getOperationType() override;
 
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index 86ac08a6..daca34c4 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -265,8 +265,6 @@ TEST_CASE( "LocalAuth" ) {
 
         REQUIRE( connector->getStatus() == ChargePointStatus_Available );
 
-        unsigned long t_before = mocpp_tick_ms();
-
         beginTransaction("unknownIdTag");
         loop();
 
diff --git a/tests/Reset.cpp b/tests/Reset.cpp
index c5dfcd5b..1390b336 100644
--- a/tests/Reset.cpp
+++ b/tests/Reset.cpp
@@ -50,6 +50,17 @@ TEST_CASE( "Reset" ) {
                 return doc;
             });});
 
+    getOcppContext()->getOperationRegistry().registerOperation("TransactionEvent", [] () {
+        return new Ocpp16::CustomOperation("TransactionEvent",
+            [] (JsonObject) {}, //ignore req
+            [] () {
+                //create conf
+                auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
+                auto payload = doc->to<JsonObject>();
+                payload["idTokenInfo"]["status"] = "Accepted";
+                return doc;
+            });});
+
     // Register Reset handlers
     bool checkNotified [MO_NUM_EVSEID] = {false};
     bool checkExecuted [MO_NUM_EVSEID] = {false};
diff --git a/tests/Transactions.cpp b/tests/Transactions.cpp
index aa86df32..4e056543 100644
--- a/tests/Transactions.cpp
+++ b/tests/Transactions.cpp
@@ -48,6 +48,17 @@ TEST_CASE( "Transactions" ) {
                 payload["idTokenInfo"]["status"] = "Accepted";
                 return doc;
             });});
+    
+    getOcppContext()->getOperationRegistry().registerOperation("TransactionEvent", [] () {
+        return new Ocpp16::CustomOperation("TransactionEvent",
+            [] (JsonObject) {}, //ignore req
+            [] () {
+                //create conf
+                auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
+                auto payload = doc->to<JsonObject>();
+                payload["idTokenInfo"]["status"] = "Accepted";
+                return doc;
+            });});
 
     loop();
 
@@ -128,6 +139,10 @@ TEST_CASE( "Transactions" ) {
         MO_DBG_INFO("Memory requirements UC C01-04:");
 
         MO_MEM_PRINT_STATS();
+
+        context->getModel().getTransactionService()->getEvse(1)->abortTransaction();
+        loop();
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
     }
 
     SECTION("UC E01 - S5 / E06") {
@@ -164,17 +179,13 @@ TEST_CASE( "Transactions" ) {
 
         MO_MEM_PRINT_STATS();
 
-        auto trackTx = context->getModel().getTransactionService()->getEvse(1)->getTransaction();
-
         MO_MEM_RESET();
 
         setConnectorPluggedInput([] () {return false;});
         loop();
 
         REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
-        REQUIRE( trackTx->stopped );
         REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
-        trackTx.reset();
 
         MO_DBG_INFO("Memory requirements UC E06:");
         MO_MEM_PRINT_STATS();
@@ -206,10 +217,10 @@ TEST_CASE( "Transactions" ) {
         getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("PowerPathClosed");
         getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("PowerPathClosed");
 
-        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("SampledDataCtrlr", "SampledDataTxStartedMeasurands", "")->setString("Energy.Active.Import.Register");
-        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("SampledDataCtrlr", "SampledDataTxUpdatedMeasurands", "")->setString("Power.Active.Import");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("SampledDataCtrlr", "TxStartedMeasurands", "")->setString("Energy.Active.Import.Register");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("SampledDataCtrlr", "TxUpdatedMeasurands", "")->setString("Power.Active.Import");
         getOcppContext()->getModel().getVariableService()->declareVariable<int>("SampledDataCtrlr", "TxUpdatedInterval", 0)->setInt(60);
-        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("SampledDataCtrlr", "SampledDataTxEndedMeasurands", "")->setString("Current.Import");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("SampledDataCtrlr", "TxEndedMeasurands", "")->setString("Current.Import");
         getOcppContext()->getModel().getVariableService()->declareVariable<int>("SampledDataCtrlr", "TxEndededInterval", 0)->setInt(100);
 
         setConnectorPluggedInput([] () {return false;});
@@ -264,6 +275,459 @@ TEST_CASE( "Transactions" ) {
         MO_DBG_INFO("Memory requirements UC E01 - S5:");
 
         MO_MEM_PRINT_STATS();
+
+        context->getModel().getTransactionService()->getEvse(1)->endAuthorization();
+        loop();
+
+        REQUIRE( (tStart > MIN_TIME) );
+        //REQUIRE( (tUpdated > MIN_TIME) );
+        REQUIRE( (tEnded > MIN_TIME) );
+
+    }
+
+    SECTION("TxEvents queue") {
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("Authorized");
+
+        bool checkReceivedStarted = false, checkReceivedEnded = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("TransactionEvent", [&checkReceivedStarted, &checkReceivedEnded] () {
+            return new Ocpp16::CustomOperation("TransactionEvent",
+                [&checkReceivedStarted, &checkReceivedEnded] (JsonObject request) {
+                    //process req
+                    const char *eventType = request["eventType"] | (const char*)nullptr;
+                    if (!strcmp(eventType, "Started")) {
+                        checkReceivedStarted = true;
+                    } else if (!strcmp(eventType, "Ended")) {
+                        checkReceivedEnded = true;
+                    }
+                },
+                [] () {
+                    //create conf
+                    auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTokenInfo"]["status"] = "Accepted";
+                    return doc;
+                });});
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
+        loopback.setConnected(false);
+
+        context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken", false);
+
+        loop();
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() != nullptr );
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction()->started );
+
+        context->getModel().getTransactionService()->getEvse(1)->endAuthorization();
+
+        loop();
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
+        loopback.setConnected(true);
+        loop();
+
+        REQUIRE( checkReceivedStarted );
+        REQUIRE( checkReceivedEnded );
+    }
+
+    SECTION("TxEvents queue size limit") {
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("Authorized");
+
+        bool checkReceivedStarted = false, checkReceivedEnded = false;
+        size_t checkSeqNosSize = 0;
+
+        getOcppContext()->getOperationRegistry().registerOperation("TransactionEvent", [&checkReceivedStarted, &checkReceivedEnded, &checkSeqNosSize] () {
+            return new Ocpp16::CustomOperation("TransactionEvent",
+                [&checkReceivedStarted, &checkReceivedEnded, &checkSeqNosSize] (JsonObject request) {
+                    //process req
+                    const char *eventType = request["eventType"] | (const char*)nullptr;
+                    if (!strcmp(eventType, "Started")) {
+                        checkReceivedStarted = true;
+                    } else if (!strcmp(eventType, "Ended")) {
+                        checkReceivedEnded = true;
+                    }
+                    checkSeqNosSize++;
+                },
+                [] () {
+                    //create conf
+                    auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTokenInfo"]["status"] = "Accepted";
+                    return doc;
+                });});
+    
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
+        loopback.setConnected(false);
+
+        context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken", false);
+
+        loop();
+
+        auto tx = context->getModel().getTransactionService()->getEvse(1)->getTransaction();
+        REQUIRE( tx != nullptr );
+
+        for (size_t i = 0; i < MO_TXEVENTRECORD_SIZE_V201 * 2; i++) {
+            setEvReadyInput([] () {return false;});
+            loop();
+            setEvReadyInput([] () {return true;});
+            loop();
+            setEvReadyInput([] () {return false;});
+            loop();
+        }
+
+        REQUIRE( tx->seqNos.size() == MO_TXEVENTRECORD_SIZE_V201 );
+
+        for (auto seqNo : tx->seqNos) {
+            MO_DBG_DEBUG("stored seqNo %u", seqNo);
+        }
+
+        for (size_t i = 1; i < tx->seqNos.size(); i++) {
+            auto delta = tx->seqNos[i] - tx->seqNos[i-1];
+            REQUIRE(delta <= 2 * tx->seqNos.back() / MO_TXEVENTRECORD_SIZE_V201 );
+        }
+
+        context->getModel().getTransactionService()->getEvse(1)->endAuthorization();
+
+        loop();
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
+        loopback.setConnected(true);
+        loop();
+
+        REQUIRE( checkReceivedStarted );
+        REQUIRE( checkReceivedEnded );
+        REQUIRE( checkSeqNosSize == MO_TXEVENTRECORD_SIZE_V201 );
+    }
+
+    SECTION("Tx queue") {
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("Authorized");
+
+        std::map<std::string,std::tuple<bool,bool>> txEventRequests;
+
+        getOcppContext()->getOperationRegistry().registerOperation("TransactionEvent", [&txEventRequests] () {
+            return new Ocpp16::CustomOperation("TransactionEvent",
+                [&txEventRequests] (JsonObject request) {
+                    //process req
+                    const char *eventType = request["eventType"] | (const char*)nullptr;
+                    if (!strcmp(eventType, "Started")) {
+                        std::get<0>(txEventRequests[request["transactionInfo"]["transactionId"] | "_Undefined"]) = true;
+                    } else if (!strcmp(eventType, "Ended")) {
+                        std::get<1>(txEventRequests[request["transactionInfo"]["transactionId"] | "_Undefined"]) = true;
+                    }
+                },
+                [] () {
+                    //create conf
+                    auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTokenInfo"]["status"] = "Accepted";
+                    return doc;
+                });});
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
+        loopback.setConnected(false);
+
+        for (size_t i = 0; i < MO_TXRECORD_SIZE_V201; i++) {
+
+            char idTokenBuf [MO_IDTOKEN_LEN_MAX + 1];
+            snprintf(idTokenBuf, sizeof(idTokenBuf), "mIdToken-%zu", i);
+
+            REQUIRE( context->getModel().getTransactionService()->getEvse(1)->beginAuthorization(idTokenBuf, false) );
+
+            loop();
+
+            auto tx = context->getModel().getTransactionService()->getEvse(1)->getTransaction();
+
+            REQUIRE( tx != nullptr );
+            REQUIRE( tx->started );
+            txEventRequests[tx->transactionId] = {false, false};
+
+            context->getModel().getTransactionService()->getEvse(1)->endAuthorization();
+
+            loop();
+
+            REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+        }
+
+        REQUIRE( !context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken", false) );
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
+        loopback.setConnected(true);
+        loop();
+
+        for (const auto& txReq : txEventRequests) {
+            MO_DBG_DEBUG("check txId %s", txReq.first.c_str());
+            REQUIRE( std::get<0>(txReq.second) );
+            REQUIRE( std::get<1>(txReq.second) );
+        }
+
+        REQUIRE( txEventRequests.size() == MO_TXRECORD_SIZE_V201 );
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->beginAuthorization("mIdToken", false) );
+        loop();
+        auto tx = context->getModel().getTransactionService()->getEvse(1)->getTransaction();
+        REQUIRE( tx != nullptr );
+        REQUIRE( tx->started );
+
+        context->getModel().getTransactionService()->getEvse(1)->endAuthorization();
+        loop();
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+    }
+
+    SECTION("Power loss during running transaction") {
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("Authorized");
+
+        REQUIRE( getOcppContext()->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
+        const char *idTag = "example123";
+
+        getOcppContext()->getModel().getTransactionService()->getEvse(1)->beginAuthorization(idTag, false);
+        loop();
+
+        auto tx = getOcppContext()->getModel().getTransactionService()->getEvse(1)->getTransaction();
+        REQUIRE( tx != nullptr );
+        REQUIRE( tx->started );
+
+        auto txNr = tx->txNr;
+        std::string txId = tx->transactionId;
+
+        //power cut
+        mocpp_deinitialize();
+
+        //power restored
+        mocpp_initialize(loopback,
+            ChargerCredentials(),
+            makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail),
+            false,
+            ProtocolVersion(2,0,1));
+        mocpp_set_timer(custom_timer_cb);
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("Authorized");
+
+        bool checkProcessed = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("TransactionEvent", [&checkProcessed, txId] () {
+            return new Ocpp16::CustomOperation("TransactionEvent",
+                [&checkProcessed, txId] (JsonObject request) {
+                    //process req
+                    const char *eventType = request["eventType"] | (const char*)nullptr;
+                    REQUIRE( strcmp(eventType, "Started") );
+                    if (!strcmp(eventType, "Ended")) {
+                        checkProcessed = true;
+                    }
+                    REQUIRE( !txId.compare(request["transactionInfo"]["transactionId"] | "_Undefined") );
+                },
+                [] () {
+                    //create conf
+                    auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTokenInfo"]["status"] = "Accepted";
+                    return doc;
+                });});
+        
+        loop(); //let MO spin up and reconnect
+
+        tx = getOcppContext()->getModel().getTransactionService()->getEvse(1)->getTransaction();
+        REQUIRE( tx != nullptr );
+        REQUIRE( tx->started );
+        REQUIRE( !tx->stopped );
+        REQUIRE( tx->txNr == txNr );
+        REQUIRE( !txId.compare(tx->transactionId) );
+        REQUIRE( !strcmp(tx->idToken.get(), idTag) );
+
+        getOcppContext()->getModel().getTransactionService()->getEvse(1)->endAuthorization();
+        loop();
+
+        tx = getOcppContext()->getModel().getTransactionService()->getEvse(1)->getTransaction();
+        REQUIRE( tx == nullptr );
+        REQUIRE( checkProcessed ); //txEvent was sent
+    }
+
+    SECTION("Power loss with enqueued txEvents") {
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("Authorized");
+
+        REQUIRE( getOcppContext()->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
+        loopback.setConnected(false);
+
+        const char *idTag = "example123";
+
+        getOcppContext()->getModel().getTransactionService()->getEvse(1)->beginAuthorization(idTag, false);
+        loop();
+
+        auto tx = getOcppContext()->getModel().getTransactionService()->getEvse(1)->getTransaction();
+        REQUIRE( tx != nullptr );
+        REQUIRE( tx->started );
+
+        auto txNr = tx->txNr;
+        std::string txId = tx->transactionId;
+
+        setEvReadyInput([] () {return false;});
+        loop();
+        setEvReadyInput([] () {return true;});
+        loop();
+        setEvReadyInput([] () {return false;});
+        loop();
+
+        size_t seqNosSize = tx->seqNos.size();
+        size_t checkSeqNosSize = 0;
+
+        //power cut
+        mocpp_deinitialize();
+
+        //power restored
+        mocpp_initialize(loopback,
+            ChargerCredentials(),
+            makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail),
+            false,
+            ProtocolVersion(2,0,1));
+        mocpp_set_timer(custom_timer_cb);
+
+        loopback.setConnected(true);
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("Authorized");
+
+        bool checkReceivedStarted = false, checkReceivedEnded = false;
+
+        getOcppContext()->getOperationRegistry().registerOperation("TransactionEvent", [&checkReceivedStarted, &checkReceivedEnded, txId, &checkSeqNosSize] () {
+            return new Ocpp16::CustomOperation("TransactionEvent",
+                [&checkReceivedStarted, &checkReceivedEnded, txId, &checkSeqNosSize] (JsonObject request) {
+                    //process req
+                    const char *eventType = request["eventType"] | (const char*)nullptr;
+                    if (!strcmp(eventType, "Started")) {
+                        checkReceivedStarted = true;
+                    } else if (!strcmp(eventType, "Ended")) {
+                        checkReceivedEnded = true;
+                    }
+                    REQUIRE( !txId.compare(request["transactionInfo"]["transactionId"] | "_Undefined") );
+                    checkSeqNosSize++;
+                },
+                [] () {
+                    //create conf
+                    auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTokenInfo"]["status"] = "Accepted";
+                    return doc;
+                });});
+        
+        loop(); //let MO spin up and reconnect
+
+        REQUIRE( checkReceivedStarted );
+        REQUIRE( (seqNosSize == checkSeqNosSize || seqNosSize + 1 == checkSeqNosSize) );
+
+        tx = getOcppContext()->getModel().getTransactionService()->getEvse(1)->getTransaction();
+        REQUIRE( tx != nullptr );
+        REQUIRE( tx->started );
+        REQUIRE( !tx->stopped );
+        REQUIRE( tx->txNr == txNr );
+        REQUIRE( !txId.compare(tx->transactionId) );
+        REQUIRE( !strcmp(tx->idToken.get(), idTag) );
+
+        getOcppContext()->getModel().getTransactionService()->getEvse(1)->endAuthorization();
+        loop();
+
+        tx = getOcppContext()->getModel().getTransactionService()->getEvse(1)->getTransaction();
+        REQUIRE( tx == nullptr );
+        REQUIRE( checkReceivedEnded ); //txEvent was sent
+    }
+
+    SECTION("Power loss with enqueued transactions") {
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("Authorized");
+
+        std::map<std::string,std::tuple<bool,bool>> txEventRequests;
+
+        REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+
+        loopback.setConnected(false);
+
+        for (size_t i = 0; i < MO_TXRECORD_SIZE_V201; i++) {
+
+            char idTokenBuf [MO_IDTOKEN_LEN_MAX + 1];
+            snprintf(idTokenBuf, sizeof(idTokenBuf), "mIdToken-%zu", i);
+
+            REQUIRE( context->getModel().getTransactionService()->getEvse(1)->beginAuthorization(idTokenBuf, false) );
+
+            loop();
+
+            auto tx = context->getModel().getTransactionService()->getEvse(1)->getTransaction();
+
+            REQUIRE( tx != nullptr );
+            REQUIRE( tx->started );
+            txEventRequests[tx->transactionId] = {false, false};
+
+            context->getModel().getTransactionService()->getEvse(1)->endAuthorization();
+
+            loop();
+
+            REQUIRE( context->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
+        }
+
+        //power cut
+        mocpp_deinitialize();
+
+        //power restored
+        mocpp_initialize(loopback,
+            ChargerCredentials(),
+            makeDefaultFilesystemAdapter(FilesystemOpt::Use_Mount_FormatOnFail),
+            false,
+            ProtocolVersion(2,0,1));
+        mocpp_set_timer(custom_timer_cb);
+
+        loopback.setConnected(true);
+
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStartPoint", "")->setString("Authorized");
+        getOcppContext()->getModel().getVariableService()->declareVariable<const char*>("TxCtrlr", "TxStopPoint", "")->setString("Authorized");
+
+        getOcppContext()->getOperationRegistry().registerOperation("TransactionEvent", [&txEventRequests] () {
+            return new Ocpp16::CustomOperation("TransactionEvent",
+                [&txEventRequests] (JsonObject request) {
+                    //process req
+                    const char *eventType = request["eventType"] | (const char*)nullptr;
+                    if (!strcmp(eventType, "Started")) {
+                        std::get<0>(txEventRequests[request["transactionInfo"]["transactionId"] | "_Undefined"]) = true;
+                    } else if (!strcmp(eventType, "Ended")) {
+                        std::get<1>(txEventRequests[request["transactionInfo"]["transactionId"] | "_Undefined"]) = true;
+                    }
+                },
+                [] () {
+                    //create conf
+                    auto doc = makeJsonDoc("UnitTests", 2 * JSON_OBJECT_SIZE(1));
+                    auto payload = doc->to<JsonObject>();
+                    payload["idTokenInfo"]["status"] = "Accepted";
+                    return doc;
+                });});
+
+        loopback.setConnected(true);
+        loop();
+
+        for (const auto& txReq : txEventRequests) {
+            MO_DBG_DEBUG("check txId %s", txReq.first.c_str());
+            REQUIRE( std::get<0>(txReq.second) );
+            REQUIRE( std::get<1>(txReq.second) );
+        }
+
+        REQUIRE( txEventRequests.size() == MO_TXRECORD_SIZE_V201 );
+
+        REQUIRE( getOcppContext()->getModel().getTransactionService()->getEvse(1)->getTransaction() == nullptr );
     }
 
     mocpp_deinitialize();
diff --git a/tests/Variables.cpp b/tests/Variables.cpp
index 1d6399c4..158140fc 100644
--- a/tests/Variables.cpp
+++ b/tests/Variables.cpp
@@ -34,24 +34,14 @@ TEST_CASE( "Variable" ) {
     FilesystemUtils::remove_if(filesystem, [] (const char*) {return true;});
 
     SECTION("Basic container operations"){
-        std::unique_ptr<VariableContainer> container;
-
-        SECTION("Volatile storage") {
-            container = makeVariableContainerVolatile(MO_VARIABLE_VOLATILE "/volatile1", true);
-        }
-
-#if 0
-        SECTION("Persistent storage") {
-            container = makeVariableContainerFlash(filesystem, MO_FILENAME_PREFIX "persistent1.jsn", true);
-        }
-#endif
+        auto container = std::unique_ptr<VariableContainerOwning>(new VariableContainerOwning());
 
         //check emptyness
         REQUIRE( container->size() == 0 );
 
         //add first config, fetch by index
         Variable::AttributeTypeSet attrs = Variable::AttributeType::Actual;
-        auto configFirst = container->createVariable(Variable::InternalDataType::Int, attrs);
+        auto configFirst = makeVariable(Variable::InternalDataType::Int, attrs);
         configFirst->setName("cFirst");
         configFirst->setComponentId("mComponent");
         auto configFirstRaw = configFirst.get();
@@ -61,14 +51,14 @@ TEST_CASE( "Variable" ) {
         REQUIRE( container->getVariable((size_t) 0) == configFirstRaw);
 
         //add one config of each type
-        auto cInt = container->createVariable(Variable::InternalDataType::Int, attrs);
+        auto cInt = makeVariable(Variable::InternalDataType::Int, attrs);
         cInt->setName("cInt");
         cInt->setComponentId("mComponent");
-        auto cBool = container->createVariable(Variable::InternalDataType::Bool, attrs);
+        auto cBool = makeVariable(Variable::InternalDataType::Bool, attrs);
         cBool->setName("cBool");
         cBool->setComponentId("mComponent");
         auto cBoolRaw = cBool.get();
-        auto cString = container->createVariable(Variable::InternalDataType::String, attrs);
+        auto cString = makeVariable(Variable::InternalDataType::String, attrs);
         cString->setName("cString");
         cString->setComponentId("mComponent");
 
@@ -82,34 +72,46 @@ TEST_CASE( "Variable" ) {
         REQUIRE( container->getVariable(cBoolRaw->getComponentId(), cBoolRaw->getName()) == cBoolRaw);
     }
 
-#if 0
     SECTION("Persistency on filesystem") {
 
-        auto container = makeVariableContainerFlash(filesystem, MO_FILENAME_PREFIX "persistent1.jsn", true);
+        auto container = std::unique_ptr<VariableContainerOwning>(new VariableContainerOwning());
+        container->enablePersistency(filesystem, MO_FILENAME_PREFIX "persistent1.jsn");
 
         //trivial load call
         REQUIRE( container->load() );
         REQUIRE( container->size() == 0 );
 
         //add config, store, load again
-        auto cString = container->createVariable(Variable::InternalDataType::String, "cString");
+        auto cString = makeVariable(Variable::InternalDataType::String, Variable::AttributeType::Actual);
+        cString->setName("cString");
+        cString->setComponentId("mComponent");
         cString->setString("mValue");
+        container->add(std::move(cString));
+        REQUIRE( container->size() == 1 );
 
-        REQUIRE( container->save() ); //store
+        REQUIRE( container->commit() ); //store
 
         container.reset(); //destroy
 
         //...load again
-        auto container2 = makeVariableContainerFlash(filesystem, MO_FILENAME_PREFIX "persistent1.jsn", true);
+        auto container2 = std::unique_ptr<VariableContainerOwning>(new VariableContainerOwning());
+        container2->enablePersistency(filesystem, MO_FILENAME_PREFIX "persistent1.jsn");
         REQUIRE( container2->size() == 0 );
+
+        auto cString2 = makeVariable(Variable::InternalDataType::String, Variable::AttributeType::Actual);
+        cString2->setName("cString");
+        cString2->setComponentId("mComponent");
+        cString2->setString("mValue");
+        container2->add(std::move(cString2));
+        REQUIRE( container2->size() == 1 );
+
         REQUIRE( container2->load() );
         REQUIRE( container2->size() == 1 );
 
-        auto cString2 = container2->getVariable("cString");
-        REQUIRE( cString2 != nullptr );
-        REQUIRE( !strcmp(cString2->getString(), "mValue") );
+        auto cString3 = container2->getVariable("mComponent", "cString");
+        REQUIRE( cString3 != nullptr );
+        REQUIRE( !strcmp(cString3->getString(), "mValue") );
     }
-#endif
 
     LoopbackConnection loopback; //initialize Context with dummy socket
     mocpp_set_timer(custom_timer_cb);
@@ -154,16 +156,6 @@ TEST_CASE( "Variable" ) {
         auto cInt3 = vs->declareVariable<int>("mComponent", "cInt", -1);
         REQUIRE( cInt3 == cInt2 );
 
-        //declare config twice but in different container
-        auto cInt4 = vs->declareVariable<int>("mComponent", "cInt", -1, MO_VARIABLE_VOLATILE "/volatile2");
-        REQUIRE( cInt4 == cInt2 );
-
-        //declare config twice but with conflicting type (will supersede old type because to simplify FW upgrades)
-        auto cNewType = vs->declareVariable<const char*>("mComponent", "cInt", "mValue2");
-        REQUIRE( cNewType != cInt2 );
-        REQUIRE( cInt2->isDetached() ); // Container should not store this
-        REQUIRE( !strcmp(cNewType->getString(), "mValue2") );
-
 #if 0
         //store, destroy, reload
         REQUIRE( configuration_save() );
@@ -195,46 +187,32 @@ TEST_CASE( "Variable" ) {
         //config accessibility / permissions
         vs = getOcppContext()->getModel().getVariableService();
         Variable::Mutability mutability = Variable::Mutability::ReadWrite;
+        bool persistent = false;
         Variable::AttributeTypeSet attrs = Variable::AttributeType::Actual;
         bool rebootRequired = false;
-        bool isAccessible = true;
-        auto cInt6 = vs->declareVariable<int>("mComponent", "cInt", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
+        auto cInt6 = vs->declareVariable<int>("mComponent", "cInt", 42, mutability, persistent, attrs, rebootRequired);
         REQUIRE( cInt6->getMutability() == Variable::Mutability::ReadWrite );
+        REQUIRE( !cInt6->isPersistent() );
         REQUIRE( !cInt6->isRebootRequired() );
         REQUIRE( vs->declareVariable<int>("mComponent", "cInt", 42) );
 
         //revoke permissions
         mutability = Variable::Mutability::ReadOnly;
+        persistent = true;
         rebootRequired = true;
-        vs->declareVariable<int>("mComponent", "cInt", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
+        vs->declareVariable<int>("mComponent", "cInt", 42, mutability, persistent, attrs, rebootRequired);
         REQUIRE( cInt6->getMutability() == mutability );
+        REQUIRE( cInt6->isPersistent() );
         REQUIRE( cInt6->isRebootRequired() );
 
         //revoked permissions cannot be reverted
         mutability = Variable::Mutability::ReadWrite;
+        persistent = false;
         rebootRequired = false;
-        auto cInt7 = vs->declareVariable<int>("mComponent", "cInt", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
+        auto cInt7 = vs->declareVariable<int>("mComponent", "cInt", 42, mutability, persistent, attrs, rebootRequired);
         REQUIRE( cInt7->getMutability() == Variable::Mutability::ReadOnly );
+        REQUIRE( cInt6->isPersistent() );
         REQUIRE( cInt7->isRebootRequired() );
-
-        //accessibility cannot be changed after first initialization
-        isAccessible = false;
-        vs->declareVariable<int>("mComponent", "cInt", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
-        vs->declareVariable<int>("mComponent", "cInt2", 42, MO_VARIABLE_VOLATILE, mutability, attrs, rebootRequired, isAccessible);
-        Variable *result = nullptr;
-        REQUIRE( vs->getVariable(Variable::AttributeType::Actual, "mComponent", "cInt", &result) == GetVariableStatus::Accepted );
-        REQUIRE( result != nullptr );
-        result = nullptr;
-        REQUIRE( vs->getVariable(Variable::AttributeType::Actual, "mComponent", "cInt2", &result) == GetVariableStatus::Accepted );
-        REQUIRE( result != nullptr );
-
-        //create config in hidden container
-        isAccessible = false;
-        auto cHidden = vs->declareVariable<int>("mComponent", "cHidden", 42, MO_VARIABLE_VOLATILE "/hidden.json", mutability, attrs, rebootRequired, isAccessible);
-        (void)cHidden;
-        result = nullptr;
-        REQUIRE( vs->getVariable(Variable::AttributeType::Actual, "mComponent", "cHidden", &result) == GetVariableStatus::Accepted );
-        REQUIRE( result != nullptr );
     }
 
 #if 0
@@ -515,7 +493,7 @@ TEST_CASE( "Variable" ) {
         mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
 
         auto vs = getOcppContext()->getModel().getVariableService();
-        auto varString = vs->declareVariable<const char*>("mComponent", "mString", "mValue", MO_VARIABLE_VOLATILE);
+        auto varString = vs->declareVariable<const char*>("mComponent", "mString", "mValue");
         REQUIRE( varString != nullptr );
         REQUIRE( !strcmp(varString->getString(), "mValue") );
 
@@ -564,7 +542,7 @@ TEST_CASE( "Variable" ) {
         mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
 
         auto vs = getOcppContext()->getModel().getVariableService();
-        auto varString = vs->declareVariable<const char*>("mComponent", "mString", "", MO_VARIABLE_VOLATILE);
+        auto varString = vs->declareVariable<const char*>("mComponent", "mString", "");
         REQUIRE( varString != nullptr );
         REQUIRE( !strcmp(varString->getString(), "") );
 
@@ -612,7 +590,7 @@ TEST_CASE( "Variable" ) {
         mocpp_initialize(loopback, ChargerCredentials(), filesystem, false, ProtocolVersion(2,0,1));
 
         auto vs = getOcppContext()->getModel().getVariableService();
-        auto varString = vs->declareVariable<const char*>("mComponent", "mString", "", MO_VARIABLE_VOLATILE);
+        auto varString = vs->declareVariable<const char*>("mComponent", "mString", "");
         REQUIRE( varString != nullptr );
         REQUIRE( !strcmp(varString->getString(), "") );
 
diff --git a/tests/benchmarks/scripts/measure_heap.py b/tests/benchmarks/scripts/measure_heap.py
index 3c15b464..8ae75ddc 100644
--- a/tests/benchmarks/scripts/measure_heap.py
+++ b/tests/benchmarks/scripts/measure_heap.py
@@ -181,7 +181,7 @@ def setup_simulator():
     print('   - upload credentials')
     sftp = client.open_sftp()
     sftp.putfo(io.StringIO(os.environ['MO_SIM_CONFIG']),     os.path.join('MicroOcppSimulator', 'mo_store', 'simulator.jsn'))
-    sftp.putfo(io.StringIO(os.environ['MO_SIM_OCPP_SERVER']),os.path.join('MicroOcppSimulator', 'mo_store', 'ws-conn.jsn'))
+    sftp.putfo(io.StringIO(os.environ['MO_SIM_OCPP_SERVER']),os.path.join('MicroOcppSimulator', 'mo_store', 'ws-conn-v201.jsn'))
     sftp.putfo(io.StringIO(os.environ['MO_SIM_API_CERT']),   os.path.join('MicroOcppSimulator', 'mo_store', 'api_cert.pem'))
     sftp.putfo(io.StringIO(os.environ['MO_SIM_API_KEY']),    os.path.join('MicroOcppSimulator', 'mo_store', 'api_key.pem'))
     sftp.putfo(io.StringIO(os.environ['MO_SIM_API_CONFIG']), os.path.join('MicroOcppSimulator', 'mo_store', 'api.jsn'))

From 5de54478229a0d0a845c26c3a6d76e014cee7db1 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 3 Nov 2024 20:04:50 +0100
Subject: [PATCH 528/549] Fix crash when initialized without FS access (#380)

---
 CHANGELOG.md                                  |  2 +-
 .../Model/ConnectorBase/Connector.cpp         | 54 ++++++++++---------
 tests/ChargingSessions.cpp                    | 49 +++++++++++++++++
 tests/Transactions.cpp                        |  1 +
 4 files changed, 79 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index fc31c734..60d80ac3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,7 +22,7 @@
 - Build flag `MO_REPORT_NOERROR` to report error recovery ([#331](https://github.com/matth-x/MicroOcpp/pull/331))
 - Support for `parentIdTag` ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
 - Input validation for unsigned int Configs ([#344](https://github.com/matth-x/MicroOcpp/pull/344))
-- Support for TransactionMessageAttempts/-RetryInterval ([#345](https://github.com/matth-x/MicroOcpp/pull/345))
+- Support for TransactionMessageAttempts/-RetryInterval ([#345](https://github.com/matth-x/MicroOcpp/pull/345), [#380](https://github.com/matth-x/MicroOcpp/pull/380))
 - Heap profiler and custom allocator support ([#350](https://github.com/matth-x/MicroOcpp/pull/350))
 - Migration of persistent storage ([#355](https://github.com/matth-x/MicroOcpp/pull/355))
 - Benchmarks pipeline ([#369](https://github.com/matth-x/MicroOcpp/pull/369), [#376](https://github.com/matth-x/MicroOcpp/pull/376))
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 244185bd..edb13154 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -81,37 +81,39 @@ Connector::Connector(Context& context, std::shared_ptr<FilesystemAdapter> filesy
 
     unsigned int txNrPivot = std::numeric_limits<unsigned int>::max();
 
-    filesystem->ftw_root([this, txFnamePrefix, txFnamePrefixLen, &txNrPivot] (const char *fname) {
-        if (!strncmp(fname, txFnamePrefix, txFnamePrefixLen)) {
-            unsigned int parsedTxNr = 0;
-            for (size_t i = txFnamePrefixLen; fname[i] >= '0' && fname[i] <= '9'; i++) {
-                parsedTxNr *= 10;
-                parsedTxNr += fname[i] - '0';
-            }
-
-            if (txNrPivot == std::numeric_limits<unsigned int>::max()) {
-                txNrPivot = parsedTxNr;
-                txNrBegin = parsedTxNr;
-                txNrEnd = (parsedTxNr + 1) % MAX_TX_CNT;
-                return 0;
-            }
+    if (filesystem) {
+        filesystem->ftw_root([this, txFnamePrefix, txFnamePrefixLen, &txNrPivot] (const char *fname) {
+            if (!strncmp(fname, txFnamePrefix, txFnamePrefixLen)) {
+                unsigned int parsedTxNr = 0;
+                for (size_t i = txFnamePrefixLen; fname[i] >= '0' && fname[i] <= '9'; i++) {
+                    parsedTxNr *= 10;
+                    parsedTxNr += fname[i] - '0';
+                }
 
-            if ((parsedTxNr + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT < MAX_TX_CNT / 2) {
-                //parsedTxNr is after pivot point
-                if ((parsedTxNr + 1 + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT > (txNrEnd + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT) {
+                if (txNrPivot == std::numeric_limits<unsigned int>::max()) {
+                    txNrPivot = parsedTxNr;
+                    txNrBegin = parsedTxNr;
                     txNrEnd = (parsedTxNr + 1) % MAX_TX_CNT;
+                    return 0;
                 }
-            } else if ((txNrPivot + MAX_TX_CNT - parsedTxNr) % MAX_TX_CNT < MAX_TX_CNT / 2) {
-                //parsedTxNr is before pivot point
-                if ((txNrPivot + MAX_TX_CNT - parsedTxNr) % MAX_TX_CNT > (txNrPivot + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT) {
-                    txNrBegin = parsedTxNr;
+
+                if ((parsedTxNr + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT < MAX_TX_CNT / 2) {
+                    //parsedTxNr is after pivot point
+                    if ((parsedTxNr + 1 + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT > (txNrEnd + MAX_TX_CNT - txNrPivot) % MAX_TX_CNT) {
+                        txNrEnd = (parsedTxNr + 1) % MAX_TX_CNT;
+                    }
+                } else if ((txNrPivot + MAX_TX_CNT - parsedTxNr) % MAX_TX_CNT < MAX_TX_CNT / 2) {
+                    //parsedTxNr is before pivot point
+                    if ((txNrPivot + MAX_TX_CNT - parsedTxNr) % MAX_TX_CNT > (txNrPivot + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT) {
+                        txNrBegin = parsedTxNr;
+                    }
                 }
-            }
 
-            MO_DBG_DEBUG("found %s%u.jsn - Internal range from %u to %u (exclusive)", txFnamePrefix, parsedTxNr, txNrBegin, txNrEnd);
-        }
-        return 0;
-    });
+                MO_DBG_DEBUG("found %s%u.jsn - Internal range from %u to %u (exclusive)", txFnamePrefix, parsedTxNr, txNrBegin, txNrEnd);
+            }
+            return 0;
+        });
+    }
 
     MO_DBG_DEBUG("found %u transactions for connector %u. Internal range from %u to %u (exclusive)", (txNrEnd + MAX_TX_CNT - txNrBegin) % MAX_TX_CNT, connectorId, txNrBegin, txNrEnd);
     txNrFront = txNrBegin;
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index bcc2cb69..ab3d8e6e 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -1228,5 +1228,54 @@ TEST_CASE( "Charging sessions" ) {
         REQUIRE( checkProcessed );
     }
 
+    SECTION("No filesystem access behavior") {
+
+        //re-init without filesystem access
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials(), MicroOcpp::makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Deactivate));
+        mocpp_set_timer(custom_timer_cb);
+        
+        loop();
+
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+        REQUIRE( !ocppPermitsCharge() );
+
+        for (size_t i = 0; i < 3; i++) {
+
+            beginTransaction("mIdTag");
+            loop();
+
+            REQUIRE( getChargePointStatus() == ChargePointStatus_Charging );
+            REQUIRE( ocppPermitsCharge() );
+
+            endTransaction();
+            loop();
+
+            REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+            REQUIRE( !ocppPermitsCharge() );
+        }
+
+        //Tx status will be lost over reboot
+
+        beginTransaction("mIdTag");
+        loop();
+
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Charging );
+        REQUIRE( ocppPermitsCharge() );
+
+        mocpp_deinitialize();
+
+        mocpp_initialize(loopback, ChargerCredentials(), MicroOcpp::makeDefaultFilesystemAdapter(MicroOcpp::FilesystemOpt::Deactivate));
+        mocpp_set_timer(custom_timer_cb);
+
+        loop();
+
+        REQUIRE( getChargePointStatus() == ChargePointStatus_Available );
+        REQUIRE( !ocppPermitsCharge() );
+
+        //Note: queueing offline transactions without FS is currently not implemented
+    }
+
     mocpp_deinitialize();
 }
diff --git a/tests/Transactions.cpp b/tests/Transactions.cpp
index 4e056543..56d50c97 100644
--- a/tests/Transactions.cpp
+++ b/tests/Transactions.cpp
@@ -387,6 +387,7 @@ TEST_CASE( "Transactions" ) {
 
         for (auto seqNo : tx->seqNos) {
             MO_DBG_DEBUG("stored seqNo %u", seqNo);
+            (void)seqNo;
         }
 
         for (size_t i = 1; i < tx->seqNos.size(); i++) {

From 2187f79cb261b38972e4ef64ea7dad070344095d Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 3 Nov 2024 22:59:43 +0100
Subject: [PATCH 529/549] Prepare v1.2.0 release (#381)

* update pinned repos

* update readme

* update changelog

* update PIO manifest
---
 .github/workflows/documentation.yml |  2 +-
 .github/workflows/esp-idf.yml       |  2 +-
 CHANGELOG.md                        |  2 +-
 README.md                           | 21 +++++++++++++--------
 library.json                        |  7 +++----
 5 files changed, 19 insertions(+), 15 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 888d9121..a861ed91 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -34,7 +34,7 @@ jobs:
       with:
         repository: matth-x/MicroOcppSimulator
         path: MicroOcppSimulator
-        ref: 20e8da7b76a3f5f3e50facab018a457ecdbcca59
+        ref: 2cb07cdbe53954a694a29336ab31eac2d2b48673
         submodules: 'recursive'
     - name: Clean MicroOcpp submodule
       run: |
diff --git a/.github/workflows/esp-idf.yml b/.github/workflows/esp-idf.yml
index 06710dc2..279cd4a8 100644
--- a/.github/workflows/esp-idf.yml
+++ b/.github/workflows/esp-idf.yml
@@ -37,7 +37,7 @@ jobs:
       uses: actions/checkout@v3
       with:
         repository: matth-x/MicroOcppMongoose
-        ref: v1.1.0
+        ref: v1.2.0
         path: examples/ESP-IDF/components/MicroOcppMongoose
     - name: Checkout ArduinoJson
       uses: actions/checkout@v3
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 60d80ac3..04bf0a0c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## Unreleased
+## [1.2.0] - 2024-11-03
 
 ### Changed
 
diff --git a/README.md b/README.md
index 738dd659..9434aec7 100644
--- a/README.md
+++ b/README.md
@@ -4,13 +4,13 @@
 [![Unit tests]( https://github.com/matth-x/MicroOcpp/workflows/Unit%20tests/badge.svg)](https://github.com/matth-x/MicroOcpp/actions)
 [![codecov](https://codecov.io/github/matth-x/ArduinoOcpp/branch/develop/graph/badge.svg?token=UN6LO96HM7)](https://codecov.io/github/matth-x/ArduinoOcpp)
 
-OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif, Arduino, NXP, STM, Linux and more.
+OCPP 1.6 / 2.0.1 client for microcontrollers. Portable C/C++. Compatible with Espressif, Arduino, NXP, STM, Linux and more.
 
 :heavy_check_mark: Works with [15+ commercial Central Systems](https://www.micro-ocpp.com/#h.314525e8447cc93c_81)
 
 :heavy_check_mark: Eligible for public chargers (Eichrecht-compliant)
 
-:heavy_check_mark: Supports all OCPP 1.6 feature profiles and OCPP 2.0.1 preview
+:heavy_check_mark: Supports all OCPP 1.6 feature profiles and the [basic OCPP 2.0.1 UCs](https://github.com/matth-x/MicroOcpp/tree/feature/prepare-release?tab=readme-ov-file#ocpp-201-and-iso-15118)
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.micro-ocpp.com](https://www.micro-ocpp.com)
 
@@ -32,7 +32,7 @@ If you don't have an OCPP server at hand, leave the charge box ID blank and ente
 
 ## Benchmarks
 
-*Full report: [MicroOCPP benchmark (esp-idf)](https://github.com/matth-x/MicroOcpp-benchmark)*
+*Full report: [MicroOCPP benchmarks](https://matth-x.github.io/MicroOcpp/benchmarks/)*
 
 The following measurements were taken on the ESP32 @ 160MHz and represent the optimistic best case scenario for a charger with two physical connectors (i.e. compiled with `-Os`, disabled debug output and logs).
 
@@ -69,7 +69,7 @@ If using the built-in certificate store (to enable, set build flag `MO_ENABLE_MB
 
 - [Mbed-TLS/mbedtls](https://github.com/Mbed-TLS/mbedtls) (version `2.28.1`)
 
-In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp@1.1.0` in the PIO library manager.
+In case you use PlatformIO, you can copy all dependencies from `platformio.ini` into your own configuration file. Alternatively, you can install the full library with dependencies by adding `matth-x/MicroOcpp@1.2.0` in the PIO library manager.
 
 ## OCPP 2.0.1 and ISO 15118
 
@@ -77,14 +77,19 @@ The following OCPP 2.0.1 use cases are implemented:
 
 | UC | Description | Note |
 | :--- | :--- | :--- |
-| M03 - M05 | Certificate management | Enable Mbed-TLS to use the built-in certificate store |
-| B05 - B07 | Variables | |
 | B01 - B04<br>B11 - B12 | Provisioning | Ported from OCPP 1.6 |
+| B05 - B07 | Variables | |
+| C01 - C06 | Authorization options | |
+| C15 | Offline Authorization | |
 | E01 - E12 | Transactions | |
-| F01 - F02 | Remote Start/Stop Tx | |
+| F01 - F03<br>F05 - F06 | RemoteControl | |
+| G01 - G04 | Availability | |
+| J02 | Tx-related MeterValues | persistency not supported yet |
+| M03 - M05 | Certificate management | Enable Mbed-TLS to use the built-in certificate store |
+| P01 - P02 | Data transfer | |
 | - | Protocol negotiation | The charger can select the OCPP version at runtime |
 
-The OCPP 2.0.1 features are in an alpha development stage (no persistency yet). By default, they are disabled and excluded from the build, so they have no impact on the firmware size. To enable, set the build flag `MO_ENABLE_V201=1` and initialize the library with the ProtocolVersion parameter `2.0.1`  (see [this example](https://github.com/matth-x/MicroOcppSimulator/blob/657e606c3b178d3add242935d413c72624130ff3/src/main.cpp#L43-L47) in the Simulator).
+The OCPP 2.0.1 features are in an alpha development stage. By default, they are disabled and excluded from the build, so they have no impact on the firmware size. To enable, set the build flag `MO_ENABLE_V201=1` and initialize the library with the ProtocolVersion parameter `2.0.1`  (see [this example](https://github.com/matth-x/MicroOcppSimulator/blob/657e606c3b178d3add242935d413c72624130ff3/src/main.cpp#L43-L47) in the Simulator).
 
 An integration of the library for OCPP 1.6 will also be functional with the 2.0.1 upgrade. It works with the same API in MicroOcpp.h.
 
diff --git a/library.json b/library.json
index 6637a297..ec1b8a1e 100644
--- a/library.json
+++ b/library.json
@@ -1,8 +1,8 @@
 {
     "name": "MicroOcpp",
     "version": "1.2.0",
-    "description": "OCPP 1.6 Client for microcontrollers",
-    "keywords": "OCPP, 1.6, OCPP 1.6, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, esp-idf, EVSE, Charge Point",
+    "description": "OCPP 1.6 / 2.0.1 Client for microcontrollers",
+    "keywords": "OCPP, 1.6, OCPP 1.6, OCPP 2.0.1, Smart Energy, Smart Charging, client, ESP8266, ESP32, Arduino, esp-idf, EVSE, Charge Point",
     "repository":
     {
         "type": "git",
@@ -46,8 +46,7 @@
             "LICENSE",
             "mkdocs.yml",
             "platformio.ini",
-            "README.md",
-            "SConscript.py"
+            "README.md"
         ]
     },
 

From 2d19077fd8a481f77ea4cc7448217833a850d9a5 Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Sat, 24 Aug 2024 00:48:18 +0000
Subject: [PATCH 530/549] Move to UUIDs for Message IDs

OCPP-J Message IDs must be unique per "Connection URL", including across
different WebSocket connection instances. Below is the text from the
Test Laboratory Working Instruction describing OCA's position.

    The message IDs were intended to at least be unique per defined
    'Connection URL' as specified by section 3.1.1 of the OCPP-J
    specification (In case of OCPP 1.6) or "Part 4 - JSON over WebSockets
    implementation guide" (In case of OCPP 2.0.1). By this it is meant
    unique on any WebSocket connection using the same unique Charging
    Station identifier. An erratum will be published in the near future for
    this. Please notify the vendors about this still upcoming erratum. From
    this moment on, no retests will be granted for this issue.

    To verify if a Charging Station is behaving correctly, testcases 013,
    014, 015, 016, 032, 034 and 044 can be used for checking this after
    rebooting, test cases 036, 037_1, 037_2, 037_3, 038 and 039 can be used
    for testing the behavior a when reconnection. If an incrementally
    increasing message ID is being used by the system, then it should NOT
    be reset to 0 or 1 after reconnection / reboot.

    To verify if a CSMS is behaving correctly, any testcase can be used
    after stopping the test session. Because stopping the test session
    will close the connection with the CSMS.

Changes:
* Added a Random Number Generator (RNG) platform API to microOCPP, with
  a hashed-time based default implementation.
* Add UUID generation for Message IDs using the RNG API.
---
 src/MicroOcpp/Core/Request.cpp   |  5 +--
 src/MicroOcpp/Core/UuidUtils.cpp | 56 ++++++++++++++++++++++++++++++++
 src/MicroOcpp/Core/UuidUtils.h   | 14 ++++++++
 src/MicroOcpp/Platform.cpp       | 28 ++++++++++++++++
 src/MicroOcpp/Platform.h         | 11 +++++++
 src/MicroOcpp_c.cpp              |  7 ++++
 src/MicroOcpp_c.h                |  8 +++++
 7 files changed, 127 insertions(+), 2 deletions(-)
 create mode 100644 src/MicroOcpp/Core/UuidUtils.cpp
 create mode 100644 src/MicroOcpp/Core/UuidUtils.h

diff --git a/src/MicroOcpp/Core/Request.cpp b/src/MicroOcpp/Core/Request.cpp
index 2422eef1..8ff788da 100644
--- a/src/MicroOcpp/Core/Request.cpp
+++ b/src/MicroOcpp/Core/Request.cpp
@@ -7,6 +7,7 @@
 #include <MicroOcpp/Core/Connection.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Core/RequestStore.h>
+#include <MicroOcpp/Core/UuidUtils.h>
 
 #include <MicroOcpp/Operations/StartTransaction.h>
 #include <MicroOcpp/Operations/StopTransaction.h>
@@ -250,8 +251,8 @@ void Request::initiate(std::unique_ptr<StoredOperationHandler> opStorage) {
     debugRequest_start = mocpp_tick_ms();
 
     //assign messageID
-    char id_str [16] = {'\0'};
-    sprintf(id_str, "%d", unique_id_counter++);
+    char id_str [37] = {'\0'};
+    generateUUID(id_str, 37);
     messageID = std::string {id_str};
 
     if (operation) {
diff --git a/src/MicroOcpp/Core/UuidUtils.cpp b/src/MicroOcpp/Core/UuidUtils.cpp
new file mode 100644
index 00000000..7d3ddb15
--- /dev/null
+++ b/src/MicroOcpp/Core/UuidUtils.cpp
@@ -0,0 +1,56 @@
+#include <MicroOcpp/Core/UuidUtils.h>
+#include <MicroOcpp/Platform.h>
+
+#include <stdint.h>
+
+namespace MicroOcpp {
+
+#define UUID_STR_LEN 36
+
+bool generateUUID(char *uuidBuffer, size_t len) {
+  if (len < UUID_STR_LEN + 1)
+  {
+    return false;
+  }
+
+  uint32_t ar[4];
+  for (uint8_t i = 0; i < 4; i++) {
+    ar[i] = mocpp_rng();
+  }
+
+  // Conforming to RFC 4122 Specification
+  // - byte 7: four most significant bits ==> 0100  --> always 4
+  // - byte 9: two  most significant bits ==> 10    --> always {8, 9, A, B}.
+  //
+  // patch bits for version 1 and variant 4 here
+  ar[1] &= 0xFFF0FFFF;   //  remove 4 bits.
+  ar[1] |= 0x00040000;   //  variant 4
+  ar[2] &= 0xFFFFFFF3;   //  remove 2 bits
+  ar[2] |= 0x00000008;   //  version 1
+
+  // loop through the random 16 byte array
+  for (uint8_t i = 0, j = 0; i < 16; i++) {
+    // multiples of 4 between 8 and 20 get a -.
+    // note we are processing 2 digits in one loop.
+    if ((i & 0x1) == 0) {
+      if ((4 <= i) && (i <= 10)) {
+        uuidBuffer[j++] = '-';
+      }
+    }
+
+    // encode the byte as two hex characters
+    uint8_t nr   = i / 4;
+    uint8_t xx   = ar[nr];
+    uint8_t ch   = xx & 0x0F;
+    uuidBuffer[j++] = (ch < 10)? '0' + ch : ('a' - 10) + ch;
+
+    ch = (xx >> 4) & 0x0F;
+    ar[nr] >>= 8;
+    uuidBuffer[j++] = (ch < 10)? '0' + ch : ('a' - 10) + ch;
+  }
+
+  uuidBuffer[UUID_STR_LEN] = 0;
+  return true;
+}
+
+}
diff --git a/src/MicroOcpp/Core/UuidUtils.h b/src/MicroOcpp/Core/UuidUtils.h
new file mode 100644
index 00000000..3516effe
--- /dev/null
+++ b/src/MicroOcpp/Core/UuidUtils.h
@@ -0,0 +1,14 @@
+#ifndef MO_UUIDUTILS_H
+#define MO_UUIDUTILS_H
+
+#include <stddef.h>
+namespace MicroOcpp {
+
+// Generates a UUID (Universally Unique Identifier) and writes it into a given buffer
+// Returns false if the generation failed
+// The buffer must be at least 37 bytes long (36 characters + zero termination)
+bool generateUUID(char *uuidBuffer, size_t len);
+
+}
+
+#endif
diff --git a/src/MicroOcpp/Platform.cpp b/src/MicroOcpp/Platform.cpp
index 9430488b..7065b64a 100644
--- a/src/MicroOcpp/Platform.cpp
+++ b/src/MicroOcpp/Platform.cpp
@@ -88,3 +88,31 @@ void dtostrf(float value, int min_width, int num_digits_after_decimal, char *tar
     sprintf(target, fmt, value);
 }
 #endif
+
+#ifdef MO_CUSTOM_RNG
+uint32_t (*mocpp_rng_impl)() = nullptr;
+
+void mocpp_set_rng(uint32_t (*rng)()) {
+    mocpp_rng_impl = rng;
+}
+
+uint32_t mocpp_rng_custom(void) {
+    if (mocpp_rng_impl) {
+        return mocpp_rng_impl();
+    } else {
+        return 0;
+    }
+}
+#else
+
+// Time-based Pseudo RNG.
+// Contains internal state which is mixed with the current timestamp
+// each time it is called. Then this is passed through a multiply-with-carry
+// PRNG operation to get a pseudo-random number.
+uint32_t mocpp_time_based_prng(void) {
+    static uint32_t prng_state = 1;
+    uint32_t entropy = mocpp_tick_ms();
+    prng_state = (prng_state ^ entropy)*1664525U + 1013904223U; // assuming complement-2 integers and non-signaling overflow
+    return prng_state;
+}
+#endif
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index 220c20d3..26d23643 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -5,6 +5,8 @@
 #ifndef MO_PLATFORM_H
 #define MO_PLATFORM_H
 
+#include <stdint.h>
+
 #ifdef __cplusplus
 #define EXT_C extern "C"
 #else
@@ -94,6 +96,15 @@ unsigned long mocpp_tick_ms_unix();
 #endif
 #endif
 
+#ifdef MO_CUSTOM_RNG
+void mocpp_set_rng(uint32_t (*rng)());
+uint32_t mocpp_rng_custom();
+#define mocpp_rng mocpp_rng_custom
+#else
+uint32_t mocpp_time_based_prng(void);
+#define mocpp_rng mocpp_time_based_prng
+#endif
+
 #ifndef MO_MAX_JSON_CAPACITY
 #if MO_PLATFORM == MO_PLATFORM_UNIX
 #define MO_MAX_JSON_CAPACITY 16384
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 5e9a5876..61a35a7e 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -343,6 +343,13 @@ void ocpp_set_console_out_c(void (*console_out)(const char *msg)) {
     mocpp_set_console_out(console_out);
 }
 
+#ifdef MO_CUSTOM_RNG
+void ocpp_set_rng_c(uint32_t (*rng)(void))
+{
+    mocpp_set_rng(rng);
+}
+#endif
+
 void ocpp_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
     
     std::string idTag_capture = idTag;
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index 583e7c3f..27418270 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -178,6 +178,14 @@ void ocpp_setOnSendConf(const char *operationType, OnMessage onConfirmation);
  */
 void ocpp_set_console_out_c(void (*console_out)(const char *msg));
 
+#ifdef MO_CUSTOM_RNG
+/**
+ * If build flag MO_CUSTOM_RNG is set, calls to get random numbers shall be
+ * forwarded to the function provided through this setter.
+ */
+void ocpp_set_rng_c( uint32_t (*rng)(void));
+#endif
+
 /*
  * Send OCPP operations
  */

From 039e5224c4af7963426ea02af3504d6e8b8756bd Mon Sep 17 00:00:00 2001
From: Adam Busch <abusch@tesla.com>
Date: Mon, 26 Aug 2024 15:58:05 -0500
Subject: [PATCH 531/549] Do not queue Heartbeat.req messages for longer than
 4s

Heartbeat messages are dropped from the request queue if
they are more than 4 seconds old. This is on recommendation
of the OCA to keep the heartbeat interval within 4s of the
interval provided by the CSMS.

If heartbeat messages are queued for longer than 4s,
the resulting interval will exceed this recommendation.
---
 src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
index 1de66747..ffd5c38b 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
@@ -29,6 +29,8 @@ void HeartbeatService::loop() {
         lastHeartbeat = now;
 
         auto heartbeat = makeRequest(new Ocpp16::Heartbeat(context.getModel()));
+        // Heartbeats can not deviate more than 4s from the configured interval
+        heartbeat->setTimeout(std::min(4000UL, hbInterval));
         context.initiateRequest(std::move(heartbeat));
     }
 }

From 4938a8f4f23ecdc820a82ba1963e136774a7c00e Mon Sep 17 00:00:00 2001
From: heakins <heakins@tesla.com>
Date: Wed, 28 Aug 2024 03:52:01 +0000
Subject: [PATCH 532/549] Make timeouts more accurate

---
 src/MicroOcpp/Core/Time.cpp                     | 5 +++++
 src/MicroOcpp/Model/ConnectorBase/Connector.cpp | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Core/Time.cpp b/src/MicroOcpp/Core/Time.cpp
index 6437600b..5424d09f 100644
--- a/src/MicroOcpp/Core/Time.cpp
+++ b/src/MicroOcpp/Core/Time.cpp
@@ -238,6 +238,11 @@ int Timestamp::operator-(const Timestamp &rhs) const {
     }
 
     int dt = (lhsDays - rhsDays) * (24 * 3600) + (hour - rhs.hour) * 3600 + (minute - rhs.minute) * 60 + second - rhs.second;
+
+    // Make it so that we round the difference to the nearest second, instead of being up to almost a whole second off
+    if ((ms - rhs.ms) > 500) dt++;
+    if ((ms - rhs.ms) < -500) dt--;
+
     return dt;
 }
 
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index c7736c8f..11643f19 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -235,7 +235,7 @@ void Connector::loop() {
                     transaction->getBeginTimestamp() > MIN_TIME &&
                     connectionTimeOutInt && connectionTimeOutInt->getInt() > 0 &&
                     !connectorPluggedInput() &&
-                    model.getClock().now() - transaction->getBeginTimestamp() >= connectionTimeOutInt->getInt()) {
+                    model.getClock().now() - transaction->getBeginTimestamp() > connectionTimeOutInt->getInt()) {
 
                 MO_DBG_INFO("Session mngt: timeout");
                 transaction->setInactive();

From d7221e18ec130151693b6432c8f8022bfe1e2de1 Mon Sep 17 00:00:00 2001
From: Adam Busch <abusch@tesla.com>
Date: Thu, 19 Sep 2024 15:27:37 -0400
Subject: [PATCH 533/549] Ensure ClockInterval has passed before sending
 metering values

---
 src/MicroOcpp/Model/Metering/MeteringConnector.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index fb84a24a..d260d8b1 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -90,7 +90,7 @@ std::unique_ptr<Operation> MeteringConnector::loop() {
 
         auto& timestampNow = model.getClock().now();
         auto dt = nextAlignedTime - timestampNow;
-        if (dt <= 0 ||                              //normal case: interval elapsed
+        if (dt < 0 ||                              //normal case: interval elapsed
                 dt > clockAlignedDataIntervalInt->getInt()) {   //special case: clock has been adjusted or first run
 
             MO_DBG_DEBUG("Clock aligned measurement %" PRId32 "s: %s", dt,

From 301dd5f07c8b952cdd3a849cc8f594974f419343 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Wed, 6 Nov 2024 14:47:23 +0100
Subject: [PATCH 534/549] update changelog

---
 CHANGELOG.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 04bf0a0c..6bc492b1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## Unreleased
+
+### Changed
+
+- Improved UUID generation ([#383](https://github.com/matth-x/MicroOcpp/pull/383))
+
+### Fixed
+
+- Timing issues for OCTT test cases ([#383](https://github.com/matth-x/MicroOcpp/pull/383))
+
 ## [1.2.0] - 2024-11-03
 
 ### Changed

From 5761e0f97b1946a147f00f39b63b877a112b651c Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 24 Nov 2024 23:41:04 +0100
Subject: [PATCH 535/549] Minor OCPP 1.6 fixes (#388)

* change misleading Reset failure debug msg

* reject negative ints in ChangeConfig
---
 CHANGELOG.md                                       |  2 ++
 src/MicroOcpp/Core/Configuration.cpp               |  9 +++++++++
 src/MicroOcpp/Core/Configuration.h                 |  3 +++
 src/MicroOcpp/Model/ConnectorBase/Connector.cpp    |  5 +++++
 src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp |  1 +
 src/MicroOcpp/Model/Metering/MeteringConnector.cpp |  2 ++
 src/MicroOcpp/Model/Metering/MeteringService.cpp   | 14 ++------------
 src/MicroOcpp/Model/Reset/ResetService.cpp         |  4 +++-
 8 files changed, 27 insertions(+), 13 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6bc492b1..23b58145 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,8 @@
 ### Fixed
 
 - Timing issues for OCTT test cases ([#383](https://github.com/matth-x/MicroOcpp/pull/383))
+- Misleading Reset failure dbg msg ([#388](https://github.com/matth-x/MicroOcpp/pull/388))
+- Reject negative ints in ChangeConfig ([#388](https://github.com/matth-x/MicroOcpp/pull/388))
 
 ## [1.2.0] - 2024-11-03
 
diff --git a/src/MicroOcpp/Core/Configuration.cpp b/src/MicroOcpp/Core/Configuration.cpp
index 9a00fb12..cb0a8ff5 100644
--- a/src/MicroOcpp/Core/Configuration.cpp
+++ b/src/MicroOcpp/Core/Configuration.cpp
@@ -246,4 +246,13 @@ bool configuration_clean_unused() {
     return configuration_save();
 }
 
+bool VALIDATE_UNSIGNED_INT(const char *value) {
+    for(size_t i = 0; value[i] != '\0'; i++) {
+        if (value[i] < '0' || value[i] > '9') {
+            return false;
+        }
+    }
+    return true;
+}
+
 } //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Core/Configuration.h b/src/MicroOcpp/Core/Configuration.h
index f445ffce..486b9c69 100644
--- a/src/MicroOcpp/Core/Configuration.h
+++ b/src/MicroOcpp/Core/Configuration.h
@@ -38,5 +38,8 @@ bool configuration_save();
 
 bool configuration_clean_unused(); //remove configs which haven't been accessed
 
+//default implementation for common validator
+bool VALIDATE_UNSIGNED_INT(const char*);
+
 } //end namespace MicroOcpp
 #endif
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index db5833a5..82939863 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -49,7 +49,9 @@ Connector::Connector(Context& context, std::shared_ptr<FilesystemAdapter> filesy
 #endif //MO_ENABLE_CONNECTOR_LOCK
 
     connectionTimeOutInt = declareConfiguration<int>("ConnectionTimeOut", 30);
+    registerConfigurationValidator("ConnectionTimeOut", VALIDATE_UNSIGNED_INT);
     minimumStatusDurationInt = declareConfiguration<int>("MinimumStatusDuration", 0);
+    registerConfigurationValidator("MinimumStatusDuration", VALIDATE_UNSIGNED_INT);
     stopTransactionOnInvalidIdBool = declareConfiguration<bool>("StopTransactionOnInvalidId", true);
     stopTransactionOnEVSideDisconnectBool = declareConfiguration<bool>("StopTransactionOnEVSideDisconnect", true);
     localPreAuthorizeBool = declareConfiguration<bool>("LocalPreAuthorize", false);
@@ -61,6 +63,7 @@ Connector::Connector(Context& context, std::shared_ptr<FilesystemAdapter> filesy
 
     //how long the EVSE tries the Authorize request before it enters offline mode
     authorizationTimeoutInt = MicroOcpp::declareConfiguration<int>(MO_CONFIG_EXT_PREFIX "AuthorizationTimeout", 20);
+    registerConfigurationValidator(MO_CONFIG_EXT_PREFIX "AuthorizationTimeout", VALIDATE_UNSIGNED_INT);
 
     //FreeVend mode
     freeVendActiveBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "FreeVendActive", false);
@@ -69,7 +72,9 @@ Connector::Connector(Context& context, std::shared_ptr<FilesystemAdapter> filesy
     txStartOnPowerPathClosedBool = declareConfiguration<bool>(MO_CONFIG_EXT_PREFIX "TxStartOnPowerPathClosed", false);
 
     transactionMessageAttemptsInt = declareConfiguration<int>("TransactionMessageAttempts", 3);
+    registerConfigurationValidator("TransactionMessageAttempts", VALIDATE_UNSIGNED_INT);
     transactionMessageRetryIntervalInt = declareConfiguration<int>("TransactionMessageRetryInterval", 60);
+    registerConfigurationValidator("TransactionMessageRetryInterval", VALIDATE_UNSIGNED_INT);
 
     if (!availabilityBool) {
         MO_DBG_ERR("Cannot declare availabilityBool");
diff --git a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
index 612c5778..4ebab502 100644
--- a/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
+++ b/src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
@@ -13,6 +13,7 @@ using namespace MicroOcpp;
 
 HeartbeatService::HeartbeatService(Context& context) : MemoryManaged("v16.Heartbeat.HeartbeatService"), context(context) {
     heartbeatIntervalInt = declareConfiguration<int>("HeartbeatInterval", 86400);
+    registerConfigurationValidator("HeartbeatInterval", VALIDATE_UNSIGNED_INT);
     lastHeartbeat = mocpp_tick_ms();
 
     //Register message handler for TriggerMessage operation
diff --git a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
index cba9870f..378232a5 100644
--- a/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringConnector.cpp
@@ -28,6 +28,7 @@ MeteringConnector::MeteringConnector(Context& context, int connectorId, MeterSto
     auto meterValuesSampledDataString = declareConfiguration<const char*>("MeterValuesSampledData", "");
     declareConfiguration<int>("MeterValuesSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
     meterValueSampleIntervalInt = declareConfiguration<int>("MeterValueSampleInterval", 60);
+    registerConfigurationValidator("MeterValueSampleInterval", VALIDATE_UNSIGNED_INT);
 
     auto stopTxnSampledDataString = declareConfiguration<const char*>("StopTxnSampledData", "");
     declareConfiguration<int>("StopTxnSampledDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
@@ -35,6 +36,7 @@ MeteringConnector::MeteringConnector(Context& context, int connectorId, MeterSto
     auto meterValuesAlignedDataString = declareConfiguration<const char*>("MeterValuesAlignedData", "");
     declareConfiguration<int>("MeterValuesAlignedDataMaxLength", 8, CONFIGURATION_VOLATILE, true);
     clockAlignedDataIntervalInt  = declareConfiguration<int>("ClockAlignedDataInterval", 0);
+    registerConfigurationValidator("ClockAlignedDataInterval", VALIDATE_UNSIGNED_INT);
 
     auto stopTxnAlignedDataString = declareConfiguration<const char*>("StopTxnAlignedData", "");
 
diff --git a/src/MicroOcpp/Model/Metering/MeteringService.cpp b/src/MicroOcpp/Model/Metering/MeteringService.cpp
index 287f026a..73ab4deb 100644
--- a/src/MicroOcpp/Model/Metering/MeteringService.cpp
+++ b/src/MicroOcpp/Model/Metering/MeteringService.cpp
@@ -57,22 +57,12 @@ MeteringService::MeteringService(Context& context, int numConn, std::shared_ptr<
         return isValid;
     };
 
-    std::function<bool(const char*)> validateUnsignedIntString = [] (const char *value) {
-        for(size_t i = 0; value[i] != '\0'; i++)
-        {
-            if (value[i] < '0' || value[i] > '9') {
-                return false;
-            }
-        }
-        return true;
-    };
-
     registerConfigurationValidator("MeterValuesSampledData", validateSelectString);
     registerConfigurationValidator("StopTxnSampledData", validateSelectString);
     registerConfigurationValidator("MeterValuesAlignedData", validateSelectString);
     registerConfigurationValidator("StopTxnAlignedData", validateSelectString);
-    registerConfigurationValidator("MeterValueSampleInterval", validateUnsignedIntString);
-    registerConfigurationValidator("ClockAlignedDataInterval", validateUnsignedIntString);
+    registerConfigurationValidator("MeterValueSampleInterval", VALIDATE_UNSIGNED_INT);
+    registerConfigurationValidator("ClockAlignedDataInterval", VALIDATE_UNSIGNED_INT);
 
     /*
      * Register further message handlers to support echo mode: when this library
diff --git a/src/MicroOcpp/Model/Reset/ResetService.cpp b/src/MicroOcpp/Model/Reset/ResetService.cpp
index 8335ce42..2eef02b8 100644
--- a/src/MicroOcpp/Model/Reset/ResetService.cpp
+++ b/src/MicroOcpp/Model/Reset/ResetService.cpp
@@ -29,6 +29,7 @@ ResetService::ResetService(Context& context)
       : MemoryManaged("v16.Reset.ResetService"), context(context) {
 
     resetRetriesInt = declareConfiguration<int>("ResetRetries", 2);
+    registerConfigurationValidator("ResetRetries", VALIDATE_UNSIGNED_INT);
 
     context.getOperationRegistry().registerOperation("Reset", [&context] () {
         return new Ocpp16::Reset(context.getModel());});
@@ -50,10 +51,11 @@ void ResetService::loop() {
             MO_DBG_ERR("No Reset function set! Abort");
             outstandingResetRetries = 0;
         }
-        MO_DBG_ERR("Reset device failure. %s", outstandingResetRetries == 0 ? "Abort" : "Retry");
 
         if (outstandingResetRetries <= 0) {
 
+            MO_DBG_ERR("Reset device failure. Abort");
+
             ChargePointStatus cpStatus = ChargePointStatus_UNDEFINED;
             if (context.getModel().getNumConnectors() > 0) {
                 cpStatus = context.getModel().getConnector(0)->getStatus();

From 4b080f63847e6f5b1328a205edfbf8906ab0e720 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <63792403+matth-x@users.noreply.github.com>
Date: Sun, 5 Jan 2025 15:49:09 +0100
Subject: [PATCH 536/549] Improve v1.6 / v2.0.1 Tx APIs compat (#386)

* upgrade v201 compat in MicroOcpp.h

* add definition for getTransactionV201()

* refactor TxNotification

* v201 compat for ocpp_tx C-API

* port TxNotification to v201

* init with v201 in C-API directly

* fix build checks

* enable further v201 benchmarks

* update changelog
---
 CHANGELOG.md                                  |   7 +
 CMakeLists.txt                                |   1 -
 examples/ESP-IDF/main/main.c                  |   2 +-
 src/MicroOcpp.cpp                             | 201 +++++++++++++++---
 src/MicroOcpp.h                               |  39 +++-
 .../Model/ConnectorBase/Connector.cpp         |  28 +--
 src/MicroOcpp/Model/ConnectorBase/Connector.h |   3 +-
 .../Model/ConnectorBase/Notification.cpp      |  48 -----
 .../Model/ConnectorBase/Notification.h        |  62 ------
 .../Model/Transactions/Transaction.cpp        | 109 ++++++++++
 .../Model/Transactions/Transaction.h          |  44 +++-
 .../Model/Transactions/TransactionService.cpp |  48 +++++
 .../Model/Transactions/TransactionService.h   |   5 +
 .../Model/Variables/VariableService.cpp       |  12 ++
 .../Model/Variables/VariableService.h         |   1 +
 .../Operations/RemoteStartTransaction.cpp     |   2 +-
 src/MicroOcpp/Operations/UnlockConnector.cpp  |   2 +-
 src/MicroOcpp_c.cpp                           |  66 ++++--
 src/MicroOcpp_c.h                             |  19 +-
 tests/Api.cpp                                 |   8 +-
 tests/Boot.cpp                                |   3 +-
 tests/ChargingSessions.cpp                    |   8 +-
 tests/LocalAuthList.cpp                       |  14 +-
 tests/Metering.cpp                            |   3 +-
 tests/Reservation.cpp                         |   4 +-
 tests/benchmarks/firmware_size/main.cpp       |   2 +-
 .../benchmarks/scripts/eval_firmware_size.py  |  10 +-
 tests/benchmarks/scripts/measure_heap.py      | 108 +++++-----
 28 files changed, 584 insertions(+), 275 deletions(-)
 delete mode 100644 src/MicroOcpp/Model/ConnectorBase/Notification.cpp
 delete mode 100644 src/MicroOcpp/Model/ConnectorBase/Notification.h

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 23b58145..588beea3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,7 +4,14 @@
 
 ### Changed
 
+- Change `MicroOcpp::TxNotification` into C-style enum, replace `OCPP_TxNotication` ([#386](https://github.com/matth-x/MicroOcpp/pull/386))
 - Improved UUID generation ([#383](https://github.com/matth-x/MicroOcpp/pull/383))
+- `beginTransaction()` returns bool for better v2.0.1 interop ([#386](https://github.com/matth-x/MicroOcpp/pull/386))
+
+### Added
+
+- `getTransactionV201()` exposes v201 Tx in API ([#386](https://github.com/matth-x/MicroOcpp/pull/386))
+- v201 support in Transaction.h C-API ([#386](https://github.com/matth-x/MicroOcpp/pull/386))
 
 ### Fixed
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 127fb008..963c1d8b 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -79,7 +79,6 @@ set(MO_SRC
     src/MicroOcpp/Model/Certificates/CertificateService.cpp
     src/MicroOcpp/Model/ConnectorBase/ConnectorsCommon.cpp
     src/MicroOcpp/Model/ConnectorBase/Connector.cpp
-    src/MicroOcpp/Model/ConnectorBase/Notification.cpp
     src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
     src/MicroOcpp/Model/FirmwareManagement/FirmwareService.cpp
     src/MicroOcpp/Model/Heartbeat/HeartbeatService.cpp
diff --git a/examples/ESP-IDF/main/main.c b/examples/ESP-IDF/main/main.c
index 97b6e5b7..b0911702 100644
--- a/examples/ESP-IDF/main/main.c
+++ b/examples/ESP-IDF/main/main.c
@@ -160,7 +160,7 @@ void app_main(void)
             EXAMPLE_MO_OCPP_BACKEND, 
             EXAMPLE_MO_CHARGEBOXID, 
             EXAMPLE_MO_AUTHORIZATIONKEY, "", fsopt);
-    ocpp_initialize(osock, "ESP-IDF charger", "Your brand name here", fsopt, false);
+    ocpp_initialize(osock, "ESP-IDF charger", "Your brand name here", fsopt, false, false);
 
     /* Enter infinite loop */
     while (1) {
diff --git a/src/MicroOcpp.cpp b/src/MicroOcpp.cpp
index 7ca20f3a..5dbd3714 100644
--- a/src/MicroOcpp.cpp
+++ b/src/MicroOcpp.cpp
@@ -293,6 +293,8 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
             new TransactionService(*context, filesystem, MO_NUM_EVSEID)));
         model.setRemoteControlService(std::unique_ptr<RemoteControlService>(
             new RemoteControlService(*context, MO_NUM_EVSEID)));
+        model.setResetServiceV201(std::unique_ptr<Ocpp201::ResetService>(
+            new Ocpp201::ResetService(*context)));
     } else
 #endif
     {
@@ -305,20 +307,24 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
             connectors.emplace_back(new Connector(*context, filesystem, connectorId));
         }
         model.setConnectors(std::move(connectors));
-    }
-    model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
-        new HeartbeatService(*context)));
 
 #if MO_ENABLE_LOCAL_AUTH
-    model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
-        new AuthorizationService(*context, filesystem)));
+        model.setAuthorizationService(std::unique_ptr<AuthorizationService>(
+            new AuthorizationService(*context, filesystem)));
 #endif //MO_ENABLE_LOCAL_AUTH
 
 #if MO_ENABLE_RESERVATION
-    model.setReservationService(std::unique_ptr<ReservationService>(
-        new ReservationService(*context, MO_NUMCONNECTORS)));
+        model.setReservationService(std::unique_ptr<ReservationService>(
+            new ReservationService(*context, MO_NUMCONNECTORS)));
 #endif
 
+        model.setResetService(std::unique_ptr<ResetService>(
+            new ResetService(*context)));
+    }
+
+    model.setHeartbeatService(std::unique_ptr<HeartbeatService>(
+        new HeartbeatService(*context)));
+
 #if MO_ENABLE_CERT_MGMT && MO_ENABLE_CERT_STORE_MBEDTLS
     std::unique_ptr<CertificateStore> certStore = makeCertificateStoreMbedTLS(filesystem);
     if (certStore) {
@@ -330,18 +336,6 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
     }
 #endif
 
-#if MO_ENABLE_V201
-    if (version.major == 2) {
-        //depends on VariableService
-        model.setResetServiceV201(std::unique_ptr<Ocpp201::ResetService>(
-            new Ocpp201::ResetService(*context)));
-    } else
-#endif
-    {
-        model.setResetService(std::unique_ptr<ResetService>(
-            new ResetService(*context)));
-    }
-
 #if !defined(MO_CUSTOM_UPDATER)
 #if MO_PLATFORM == MO_PLATFORM_ARDUINO && defined(ESP32) && MO_ENABLE_MBEDTLS
     model.setFirmwareService(
@@ -376,6 +370,12 @@ void mocpp_initialize(Connection& connection, const char *bootNotificationCreden
 
     configuration_load();
 
+#if MO_ENABLE_V201
+    if (version.major == 2) {
+        model.getVariableService()->load();
+    }
+#endif //MO_ENABLE_V201
+
     MO_DBG_INFO("initialized MicroOcpp v" MO_VERSION " running OCPP %i.%i.%i", version.major, version.minor, version.patch);
 }
 
@@ -422,41 +422,79 @@ void mocpp_loop() {
     context->loop();
 }
 
-std::shared_ptr<Transaction> beginTransaction(const char *idTag, unsigned int connectorId) {
+bool beginTransaction(const char *idTag, unsigned int connectorId) {
     if (!context) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
-        return nullptr;
+        return false;
     }
+
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (!idTag || strnlen(idTag, MO_IDTOKEN_LEN_MAX + 2) > MO_IDTOKEN_LEN_MAX) {
+            MO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", MO_IDTOKEN_LEN_MAX);
+            return false;
+        }
+        TransactionService::Evse *evse = nullptr;
+        if (auto txService = context->getModel().getTransactionService()) {
+            evse = txService->getEvse(connectorId);
+        }
+        if (!evse) {
+            MO_DBG_ERR("could not find EVSE");
+            return false;
+        }
+        return evse->beginAuthorization(idTag, true);
+    }
+    #endif
+
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX) {
         MO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
-        return nullptr;
+        return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
-        return nullptr;
+        return false;
     }
 
-    return connector->beginTransaction(idTag);
+    return connector->beginTransaction(idTag) != nullptr;
 }
 
-std::shared_ptr<Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
+bool beginTransaction_authorized(const char *idTag, const char *parentIdTag, unsigned int connectorId) {
     if (!context) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
-        return nullptr;
+        return false;
     }
+
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (!idTag || strnlen(idTag, MO_IDTOKEN_LEN_MAX + 2) > MO_IDTOKEN_LEN_MAX) {
+            MO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", MO_IDTOKEN_LEN_MAX);
+            return false;
+        }
+        TransactionService::Evse *evse = nullptr;
+        if (auto txService = context->getModel().getTransactionService()) {
+            evse = txService->getEvse(connectorId);
+        }
+        if (!evse) {
+            MO_DBG_ERR("could not find EVSE");
+            return false;
+        }
+        return evse->beginAuthorization(idTag, false);
+    }
+    #endif
+
     if (!idTag || strnlen(idTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX ||
         (parentIdTag && strnlen(parentIdTag, IDTAG_LEN_MAX + 2) > IDTAG_LEN_MAX)) {
         MO_DBG_ERR("(parent)idTag format violation. Expect c-style string with at most %u characters", IDTAG_LEN_MAX);
-        return nullptr;
+        return false;
     }
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
-        return nullptr;
+        return false;
     }
     
-    return connector->beginTransaction_authorized(idTag, parentIdTag);
+    return connector->beginTransaction_authorized(idTag, parentIdTag) != nullptr;
 }
 
 bool endTransaction(const char *idTag, const char *reason, unsigned int connectorId) {
@@ -464,6 +502,25 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
     }
+
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (!idTag || strnlen(idTag, MO_IDTOKEN_LEN_MAX + 2) > MO_IDTOKEN_LEN_MAX) {
+            MO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", MO_IDTOKEN_LEN_MAX);
+            return false;
+        }
+        TransactionService::Evse *evse = nullptr;
+        if (auto txService = context->getModel().getTransactionService()) {
+            evse = txService->getEvse(connectorId);
+        }
+        if (!evse) {
+            MO_DBG_ERR("could not find EVSE");
+            return false;
+        }
+        return evse->endAuthorization(idTag, true);
+    }
+    #endif
+
     bool res = false;
     if (isTransactionActive(connectorId) && getTransactionIdTag(connectorId)) {
         //end transaction now if either idTag is nullptr (i.e. force stop) or the idTag matches beginTransaction
@@ -486,7 +543,7 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
                         MO_DBG_DEBUG("Authorize rejected (%s), continue transaction", idTag_capture.c_str());
                         auto connector = context->getModel().getConnector(connectorId);
                         if (connector) {
-                            connector->updateTxNotification(TxNotification::AuthorizationRejected);
+                            connector->updateTxNotification(TxNotification_AuthorizationRejected);
                         }
                         return;
                     }
@@ -501,7 +558,7 @@ bool endTransaction(const char *idTag, const char *reason, unsigned int connecto
                     MO_DBG_DEBUG("Authorization timeout (%s), continue transaction", idTag_capture.c_str());
                     auto connector = context->getModel().getConnector(connectorId);
                     if (connector) {
-                        connector->updateTxNotification(TxNotification::AuthorizationTimeout);
+                        connector->updateTxNotification(TxNotification_AuthorizationTimeout);
                     }
                 });
 
@@ -524,6 +581,25 @@ bool endTransaction_authorized(const char *idTag, const char *reason, unsigned i
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return false;
     }
+
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        if (!idTag || strnlen(idTag, MO_IDTOKEN_LEN_MAX + 2) > MO_IDTOKEN_LEN_MAX) {
+            MO_DBG_ERR("idTag format violation. Expect c-style string with at most %u characters", MO_IDTOKEN_LEN_MAX);
+            return false;
+        }
+        TransactionService::Evse *evse = nullptr;
+        if (auto txService = context->getModel().getTransactionService()) {
+            evse = txService->getEvse(connectorId);
+        }
+        if (!evse) {
+            MO_DBG_ERR("could not find EVSE");
+            return false;
+        }
+        return evse->endAuthorization(idTag, false);
+    }
+    #endif
+
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -628,6 +704,12 @@ std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
         MO_DBG_WARN("OCPP uninitialized");
         return mocpp_undefinedTx;
     }
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        MO_DBG_ERR("only supported in v16");
+        return mocpp_undefinedTx;
+    }
+    #endif
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -636,6 +718,30 @@ std::shared_ptr<Transaction>& getTransaction(unsigned int connectorId) {
     return connector->getTransaction();
 }
 
+#if MO_ENABLE_V201
+Ocpp201::Transaction *getTransactionV201(unsigned int evseId) {
+    if (!context) {
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
+        return nullptr;
+    }
+
+    if (context->getVersion().major != 2) {
+        MO_DBG_ERR("only supported in v201");
+        return nullptr;
+    }
+
+    TransactionService::Evse *evse = nullptr;
+    if (auto txService = context->getModel().getTransactionService()) {
+        evse = txService->getEvse(evseId);
+    }
+    if (!evse) {
+        MO_DBG_ERR("could not find EVSE");
+        return nullptr;
+    }
+    return evse->getTransaction();
+}
+#endif //MO_ENABLE_V201
+
 bool ocppPermitsCharge(unsigned int connectorId) {
     if (!context) {
         MO_DBG_WARN("OCPP uninitialized");
@@ -1003,6 +1109,7 @@ void setOccupiedInput(std::function<bool()> occupied, unsigned int connectorId)
                 evse->setOccupiedInput(occupied);
             }
         }
+        return;
     }
 #endif
     auto connector = context->getModel().getConnector(connectorId);
@@ -1039,11 +1146,17 @@ void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connect
     connector->setStopTxReadyInput(stopTxReady);
 }
 
-void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcpp::TxNotification)> notificationOutput, unsigned int connectorId) {
+void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,TxNotification)> notificationOutput, unsigned int connectorId) {
     if (!context) {
         MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
         return;
     }
+    #if MO_ENABLE_V201
+    if (context->getVersion().major == 2) {
+        MO_DBG_ERR("only supported in v16");
+        return;
+    }
+    #endif
     auto connector = context->getModel().getConnector(connectorId);
     if (!connector) {
         MO_DBG_ERR("could not find connector");
@@ -1052,6 +1165,30 @@ void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcp
     connector->setTxNotificationOutput(notificationOutput);
 }
 
+#if MO_ENABLE_V201
+void setTxNotificationOutputV201(std::function<void(MicroOcpp::Ocpp201::Transaction*,TxNotification)> notificationOutput, unsigned int connectorId) {
+    if (!context) {
+        MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
+        return;
+    }
+
+    if (context->getVersion().major != 2) {
+        MO_DBG_ERR("only supported in v201");
+        return;
+    }
+
+    TransactionService::Evse *evse = nullptr;
+    if (auto txService = context->getModel().getTransactionService()) {
+        evse = txService->getEvse(connectorId);
+    }
+    if (!evse) {
+        MO_DBG_ERR("could not find EVSE");
+        return;
+    }
+    evse->setTxNotificationOutput(notificationOutput);
+}
+#endif //MO_ENABLE_V201
+
 #if MO_ENABLE_CONNECTOR_LOCK
 void setOnUnlockConnectorInOut(std::function<UnlockConnectorResult()> onUnlockConnectorInOut, unsigned int connectorId) {
     if (!context) {
diff --git a/src/MicroOcpp.h b/src/MicroOcpp.h
index 25896a26..f15c13cc 100644
--- a/src/MicroOcpp.h
+++ b/src/MicroOcpp.h
@@ -16,7 +16,6 @@
 #include <MicroOcpp/Core/Memory.h>
 #include <MicroOcpp/Model/Metering/SampledValue.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
-#include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
@@ -127,6 +126,7 @@ void mocpp_loop();
 /*
  * Transaction management.
  * 
+ * OCPP 1.6 (2.0.1 see below):
  * Begin the transaction process and prepare it. When all conditions for the transaction are true,
  * eventually send a StartTransaction request to the OCPP server.
  * Conditions:
@@ -140,18 +140,24 @@ void mocpp_loop();
  * 
  * See beginTransaction_authorized for skipping steps 1) to 3)
  * 
- * Returns the transaction object if it was possible to create the transaction process. Returns
- * nullptr if either another transaction process is still active or you need to try it again later.
+ * Returns true if it was possible to create the transaction process. Returns
+ * false if either another transaction process is still active or you need to try it again later.
+ * 
+ * OCPP 2.0.1:
+ * Authorize a transaction. Like the OCPP 1.6 behavior, this should be called when the user swipes the
+ * card to start charging, but the semantic is slightly different. This function begins the authorized
+ * phase, but a transaction may already have started due to an earlier transaction start point.
  */
-std::shared_ptr<MicroOcpp::Transaction> beginTransaction(const char *idTag, unsigned int connectorId = 1);
+bool beginTransaction(const char *idTag, unsigned int connectorId = 1);
 
 /*
  * Begin the transaction process and skip the OCPP-side authorization. See beginTransaction(...) for a
  * complete description
  */
-std::shared_ptr<MicroOcpp::Transaction> beginTransaction_authorized(const char *idTag, const char *parentIdTag = nullptr, unsigned int connectorId = 1);
+bool beginTransaction_authorized(const char *idTag, const char *parentIdTag = nullptr, unsigned int connectorId = 1);
 
 /*
+ * OCPP 1.6 (2.0.1 see below):
  * End the transaction process if idTag is authorized to stop the transaction. The OCPP lib sends
  * a StopTransaction request if the following conditions are true:
  * Conditions:
@@ -181,6 +187,15 @@ std::shared_ptr<MicroOcpp::Transaction> beginTransaction_authorized(const char *
  *     `endTransaction_authorized(nullptr, reason);`
  * 
  * Returns true if there is a transaction which could eventually be ended by this action
+ * 
+ * OCPP 2.0.1:
+ * End the user authorization. Like when running with OCPP 1.6, this should be called when the user
+ * swipes the card to stop charging. The difference between the 1.6/2.0.1 behavior is that in 1.6,
+ * endTransaction always sets the transaction inactive so that it wants to stop. In 2.0.1, this only
+ * revokes the user authorization which may terminate the transaction but doesn't have to if the
+ * transaction stop point is set to EvConnected.
+ * 
+ * Note: the stop reason parameter is ignored when running with OCPP 2.0.1. It's always Local
  */
 bool endTransaction(const char *idTag = nullptr, const char *reason = nullptr, unsigned int connectorId = 1);
 
@@ -238,6 +253,14 @@ const char *getTransactionIdTag(unsigned int connectorId = 1);
  */
 std::shared_ptr<MicroOcpp::Transaction>& getTransaction(unsigned int connectorId = 1);
 
+#if MO_ENABLE_V201
+/*
+ * OCPP 2.0.1 version of getTransaction(). Note that the return transaction object is of another type
+ * and unlike the 1.6 version, this function does not give ownership.
+ */
+MicroOcpp::Ocpp201::Transaction *getTransactionV201(unsigned int evseId = 1);
+#endif //MO_ENABLE_V201
+
 /* 
  * Returns if the OCPP library allows the EVSE to charge at the moment.
  *
@@ -308,7 +331,11 @@ void setStartTxReadyInput(std::function<bool()> startTxReady, unsigned int conne
 
 void setStopTxReadyInput(std::function<bool()> stopTxReady, unsigned int connectorId = 1); //Input if charger is ready for StopTransaction
 
-void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,MicroOcpp::TxNotification)> notificationOutput, unsigned int connectorId = 1); //called when transaction state changes (see TxNotification for possible events). Transaction can be null
+void setTxNotificationOutput(std::function<void(MicroOcpp::Transaction*,TxNotification)> notificationOutput, unsigned int connectorId = 1); //called when transaction state changes (see TxNotification for possible events). Transaction can be null
+
+#if MO_ENABLE_V201
+void setTxNotificationOutputV201(std::function<void(MicroOcpp::Ocpp201::Transaction*,TxNotification)> notificationOutput, unsigned int connectorId = 1);
+#endif //MO_ENABLE_V201
 
 #if MO_ENABLE_CONNECTOR_LOCK
 /*
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
index 82939863..11142dc9 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.cpp
@@ -316,7 +316,7 @@ void Connector::loop() {
                 transaction->setInactive();
                 transaction->commit();
 
-                updateTxNotification(TxNotification::ConnectionTimeout);
+                updateTxNotification(TxNotification_ConnectionTimeout);
             }
         }
 
@@ -377,7 +377,7 @@ void Connector::loop() {
 
                 transaction->commit();
 
-                updateTxNotification(TxNotification::StartTx);
+                updateTxNotification(TxNotification_StartTx);
 
                 //fetchFrontRequest will create the StartTransaction and pass it to the message sender
                 return;
@@ -421,7 +421,7 @@ void Connector::loop() {
 
                 transaction->commit();
 
-                updateTxNotification(TxNotification::StopTx);
+                updateTxNotification(TxNotification_StopTx);
 
                 //fetchFrontRequest will create the StopTransaction and pass it to the message sender
                 return;
@@ -741,7 +741,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             if (parentIdTag) {
                 //parentIdTag known
                 MO_DBG_INFO("connector %u reserved - abort transaction", connectorId);
-                updateTxNotification(TxNotification::ReservationConflict);
+                updateTxNotification(TxNotification_ReservationConflict);
                 return nullptr;
             } else {
                 //parentIdTag unkown but local authorization failed in any case
@@ -781,7 +781,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         }
         transaction->setAuthorized();
 
-        updateTxNotification(TxNotification::Authorized);
+        updateTxNotification(TxNotification_Authorized);
     }
 
     transaction->commit();
@@ -803,7 +803,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             MO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->getIdTag());
             tx->setIdTagDeauthorized();
             tx->commit();
-            updateTxNotification(TxNotification::AuthorizationRejected);
+            updateTxNotification(TxNotification_AuthorizationRejected);
             return;
         }
 
@@ -825,7 +825,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
                     MO_DBG_INFO("connector %u reserved - abort transaction", connectorId);
                     tx->setInactive();
                     tx->commit();
-                    updateTxNotification(TxNotification::ReservationConflict);
+                    updateTxNotification(TxNotification_ReservationConflict);
                     return;
                 }
             }
@@ -840,7 +840,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
         tx->setAuthorized();
         tx->commit();
 
-        updateTxNotification(TxNotification::Authorized);
+        updateTxNotification(TxNotification_Authorized);
     });
 
     //capture local auth and reservation check in for timeout handler
@@ -855,7 +855,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             MO_DBG_DEBUG("Abort transaction process (%s), timeout, expired local auth", tx->getIdTag());
             tx->setInactive();
             tx->commit();
-            updateTxNotification(TxNotification::AuthorizationTimeout);
+            updateTxNotification(TxNotification_AuthorizationTimeout);
             return;
         }
 
@@ -864,7 +864,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             MO_DBG_INFO("connector %u reserved (offline) - abort transaction", connectorId);
             tx->setInactive();
             tx->commit();
-            updateTxNotification(TxNotification::ReservationConflict);
+            updateTxNotification(TxNotification_ReservationConflict);
             return;
         }
 
@@ -876,7 +876,7 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             tx->setAuthorized();
             tx->commit();
 
-            updateTxNotification(TxNotification::Authorized);
+            updateTxNotification(TxNotification_Authorized);
             return;
         }
 
@@ -887,14 +887,14 @@ std::shared_ptr<Transaction> Connector::beginTransaction(const char *idTag) {
             }
             tx->setAuthorized();
             tx->commit();
-            updateTxNotification(TxNotification::Authorized);
+            updateTxNotification(TxNotification_Authorized);
             return;
         }
 
         MO_DBG_DEBUG("Abort transaction process (%s): timeout", tx->getIdTag());
         tx->setInactive();
         tx->commit();
-        updateTxNotification(TxNotification::AuthorizationTimeout);
+        updateTxNotification(TxNotification_AuthorizationTimeout);
         return; //offline tx disabled
     });
     context.initiateRequest(std::move(authorize));
@@ -1189,7 +1189,7 @@ std::unique_ptr<Request> Connector::fetchFrontRequest() {
 
                 const char* idTagInfoStatus = response["idTagInfo"]["status"] | "_Undefined";
                 if (strcmp(idTagInfoStatus, "Accepted")) {
-                    updateTxNotification(TxNotification::DeAuthorized);
+                    updateTxNotification(TxNotification_DeAuthorized);
                 }
             });
             auto transactionFront_capture = transactionFront;
diff --git a/src/MicroOcpp/Model/ConnectorBase/Connector.h b/src/MicroOcpp/Model/ConnectorBase/Connector.h
index 824e3d3b..d8d61639 100644
--- a/src/MicroOcpp/Model/ConnectorBase/Connector.h
+++ b/src/MicroOcpp/Model/ConnectorBase/Connector.h
@@ -7,8 +7,8 @@
 
 #include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointErrorData.h>
-#include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
+#include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Core/RequestQueue.h>
 #include <MicroOcpp/Core/ConfigurationKeyValue.h>
 #include <MicroOcpp/Core/FilesystemAdapter.h>
@@ -31,7 +31,6 @@ namespace MicroOcpp {
 class Context;
 class Model;
 class Operation;
-class Transaction;
 
 class Connector : public RequestEmitter, public MemoryManaged {
 private:
diff --git a/src/MicroOcpp/Model/ConnectorBase/Notification.cpp b/src/MicroOcpp/Model/ConnectorBase/Notification.cpp
deleted file mode 100644
index 1ad2eb1f..00000000
--- a/src/MicroOcpp/Model/ConnectorBase/Notification.cpp
+++ /dev/null
@@ -1,48 +0,0 @@
-// matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2024
-// MIT License
-
-#include <MicroOcpp/Model/ConnectorBase/Notification.h>
-
-namespace MicroOcpp {
-
-OCPP_TxNotification convertTxNotification(TxNotification txn) {
-    auto res = OCPP_TxNotification::AuthorizationRejected;
-    
-    switch (txn) {
-        case TxNotification::AuthorizationRejected:
-            res = OCPP_TxNotification::AuthorizationRejected;
-            break;
-        case TxNotification::AuthorizationTimeout:
-            res = OCPP_TxNotification::AuthorizationTimeout;
-            break;
-        case TxNotification::Authorized:
-            res = OCPP_TxNotification::Authorized;
-            break;
-        case TxNotification::ConnectionTimeout:
-            res = OCPP_TxNotification::ConnectionTimeout;
-            break;
-        case TxNotification::DeAuthorized:
-            res = OCPP_TxNotification::DeAuthorized;
-            break;
-        case TxNotification::RemoteStart:
-            res = OCPP_TxNotification::RemoteStart;
-            break;
-        case TxNotification::RemoteStop:
-            res = OCPP_TxNotification::RemoteStop;
-            break;
-        case TxNotification::ReservationConflict:
-            res = OCPP_TxNotification::ReservationConflict;
-            break;
-        case TxNotification::StartTx:
-            res = OCPP_TxNotification::StartTx;
-            break;
-        case TxNotification::StopTx:
-            res = OCPP_TxNotification::StopTx;
-            break;
-    }
-
-    return res;
-}
-
-} //end namespace MicroOcpp
diff --git a/src/MicroOcpp/Model/ConnectorBase/Notification.h b/src/MicroOcpp/Model/ConnectorBase/Notification.h
deleted file mode 100644
index 66b14f9c..00000000
--- a/src/MicroOcpp/Model/ConnectorBase/Notification.h
+++ /dev/null
@@ -1,62 +0,0 @@
-// matth-x/MicroOcpp
-// Copyright Matthias Akstaller 2019 - 2024
-// MIT License
-
-#ifndef MO_NOTIFICATION_H
-#define MO_NOTIFICATION_H
-
-#ifdef __cplusplus
-
-namespace MicroOcpp {
-
-enum class TxNotification {
-    //Authorization events
-    Authorized, //success
-    AuthorizationRejected, //IdTag not authorized
-    AuthorizationTimeout, //authorization failed - offline
-    ReservationConflict, //connector reserved for other IdTag
-
-    ConnectionTimeout, //user took to long to plug vehicle after the authorization
-    DeAuthorized, //server rejected StartTx
-    RemoteStart, //authorized via RemoteStartTransaction
-    RemoteStop, //stopped via RemoteStopTransaction
-
-    //Tx lifecycle events
-    StartTx,
-    StopTx,
-};
-
-} //end namespace MicroOcpp
-
-extern "C" {
-#endif //__cplusplus
-
-enum OCPP_TxNotification {
-    //Authorization events
-    Authorized, //success
-    AuthorizationRejected, //IdTag not authorized
-    AuthorizationTimeout, //authorization failed - offline
-    ReservationConflict, //connector reserved for other IdTag
-
-    ConnectionTimeout, //user took to long to plug vehicle after the authorization
-    DeAuthorized, //server rejected StartTx
-    RemoteStart, //authorized via RemoteStartTransaction
-    RemoteStop, //stopped via RemoteStopTransaction
-
-    //Tx lifecycle events
-    StartTx,
-    StopTx,
-};
-
-#ifdef __cplusplus
-} //end extern "C"
-
-namespace MicroOcpp {
-
-OCPP_TxNotification convertTxNotification(TxNotification txn);
-
-} //end namespace MicroOcpp
-
-#endif //__cplusplus
-
-#endif
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.cpp b/src/MicroOcpp/Model/Transactions/Transaction.cpp
index bd21db2e..7a48a7da 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.cpp
+++ b/src/MicroOcpp/Model/Transactions/Transaction.cpp
@@ -355,61 +355,170 @@ bool deserializeTransactionEventChargingState(const char *chargingStateCstr, Tra
 
 #endif //MO_ENABLE_V201
 
+#if MO_ENABLE_V201
+bool g_ocpp_tx_compat_v201;
+
+void ocpp_tx_compat_setV201(bool isV201) {
+    g_ocpp_tx_compat_v201 = isV201;
+}
+#endif
+
 int ocpp_tx_getTransactionId(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        MO_DBG_ERR("only supported in v16");
+        return -1;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getTransactionId();
 }
+#if MO_ENABLE_V201
+const char *ocpp_tx_getTransactionIdV201(OCPP_Transaction *tx) {
+    if (!g_ocpp_tx_compat_v201) {
+        MO_DBG_ERR("only supported in v201");
+        return nullptr;
+    }
+    return reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx)->transactionId;
+}
+#endif //MO_ENABLE_V201
 bool ocpp_tx_isAuthorized(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        return reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx)->isAuthorized;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isAuthorized();
 }
 bool ocpp_tx_isIdTagDeauthorized(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        return reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx)->isDeauthorized;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isIdTagDeauthorized();
 }
 
 bool ocpp_tx_isRunning(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        auto transaction = reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx);
+        return transaction->started && !transaction->stopped;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isRunning();
 }
 bool ocpp_tx_isActive(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        return reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx)->active;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isActive();
 }
 bool ocpp_tx_isAborted(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        auto transaction = reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx);
+        return !transaction->active && !transaction->started;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isAborted();
 }
 bool ocpp_tx_isCompleted(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        auto transaction = reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx);
+        return transaction->stopped && transaction->seqNos.empty();
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->isCompleted();
 }
 
 const char *ocpp_tx_getIdTag(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        auto transaction = reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx);
+        return transaction->idToken.get();
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getIdTag();
 }
 
 bool ocpp_tx_getBeginTimestamp(OCPP_Transaction *tx, char *buf, size_t len) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        return reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx)->beginTimestamp.toJsonString(buf, len);
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getBeginTimestamp().toJsonString(buf, len);
 }
 
 int32_t ocpp_tx_getMeterStart(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        MO_DBG_ERR("only supported in v16");
+        return -1;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getMeterStart();
 }
 
 bool ocpp_tx_getStartTimestamp(OCPP_Transaction *tx, char *buf, size_t len) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        MO_DBG_ERR("only supported in v16");
+        return -1;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getStartTimestamp().toJsonString(buf, len);
 }
 
 const char *ocpp_tx_getStopIdTag(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        auto transaction = reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx);
+        return transaction->stopIdToken ? transaction->stopIdToken->get() : "";
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getStopIdTag();
 }
 
 int32_t ocpp_tx_getMeterStop(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        MO_DBG_ERR("only supported in v16");
+        return -1;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getMeterStop();
 }
 
 void ocpp_tx_setMeterStop(OCPP_Transaction* tx, int32_t meter) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        MO_DBG_ERR("only supported in v16");
+        return;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->setMeterStop(meter);
 }
 
 bool ocpp_tx_getStopTimestamp(OCPP_Transaction *tx, char *buf, size_t len) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        MO_DBG_ERR("only supported in v16");
+        return -1;
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getStopTimestamp().toJsonString(buf, len);
 }
 
 const char *ocpp_tx_getStopReason(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        auto transaction = reinterpret_cast<MicroOcpp::Ocpp201::Transaction*>(tx);
+        return serializeTransactionStoppedReason(transaction->stoppedReason);
+    }
+    #endif //MO_ENABLE_V201
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getStopReason();
 }
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index c9d0d80a..877ccc4c 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -5,6 +5,37 @@
 #ifndef TRANSACTION_H
 #define TRANSACTION_H
 
+#include <MicroOcpp/Version.h>
+
+/* General Tx defs */
+#ifdef __cplusplus
+extern "C" {
+#endif //__cplusplus
+
+//TxNotification - event from MO to the main firmware to notify it about transaction state changes
+typedef enum {
+    UNDEFINED,
+
+    //Authorization events
+    TxNotification_Authorized, //success
+    TxNotification_AuthorizationRejected, //IdTag/token not authorized
+    TxNotification_AuthorizationTimeout, //authorization failed - offline
+    TxNotification_ReservationConflict, //connector/evse reserved for other IdTag
+
+    TxNotification_ConnectionTimeout, //user took to long to plug vehicle after the authorization
+    TxNotification_DeAuthorized, //server rejected StartTx/TxEvent
+    TxNotification_RemoteStart, //authorized via RemoteStartTx/RequestStartTx
+    TxNotification_RemoteStop, //stopped via RemoteStopTx/RequestStopTx
+
+    //Tx lifecycle events
+    TxNotification_StartTx, //entered running state (StartTx/TxEvent was initiated)
+    TxNotification_StopTx, //left running state (StopTx/TxEvent was initiated)
+}   TxNotification;
+
+#ifdef __cplusplus
+}
+#endif //__cplusplus
+
 #ifdef __cplusplus
 
 #include <MicroOcpp/Core/Time.h>
@@ -186,8 +217,6 @@ class Transaction : public MemoryManaged {
 
 } // namespace MicroOcpp
 
-#include <MicroOcpp/Version.h>
-
 #if MO_ENABLE_V201
 
 #include <memory>
@@ -422,7 +451,18 @@ extern "C" {
 struct OCPP_Transaction;
 typedef struct OCPP_Transaction OCPP_Transaction;
 
+/*
+ * Compat mode for transactions. This means that all following C-wrapper functions will interprete the handle as v201 transactions
+ */
+#if MO_ENABLE_V201
+void ocpp_tx_compat_setV201(bool isV201); //if set, all OCPP_Transaction* handles are treated as v201 transactions
+#endif
+
 int ocpp_tx_getTransactionId(OCPP_Transaction *tx);
+#if MO_ENABLE_V201
+const char *ocpp_tx_getTransactionIdV201(OCPP_Transaction *tx);
+#endif
+
 bool ocpp_tx_isAuthorized(OCPP_Transaction *tx);
 bool ocpp_tx_isIdTagDeauthorized(OCPP_Transaction *tx);
 
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.cpp b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
index be9fb72a..d0e58e1f 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.cpp
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.cpp
@@ -261,6 +261,8 @@ void TransactionService::Evse::loop() {
 
                 MO_DBG_INFO("Session mngt: timeout");
                 endTransaction(Ocpp201::Transaction::StoppedReason::Timeout, TransactionEventTriggerReason::EVConnectTimeout);
+
+                updateTxNotification(TxNotification_ConnectionTimeout);
             }
 
             if (transaction->active &&
@@ -576,6 +578,14 @@ void TransactionService::Evse::loop() {
         txStore.commit(txEvent.get());
     }
 
+    if (txEvent) {
+        if (txEvent->eventType == TransactionEventData::Type::Started) {
+            updateTxNotification(TxNotification_StartTx);
+        } else if (txEvent->eventType == TransactionEventData::Type::Ended) {
+            updateTxNotification(TxNotification_StartTx);
+        }
+    }
+
     //try to pass ownership to front txEvent immediatley
     if (txEvent && !txEventFront &&
             transaction->txNr == txNrFront &&
@@ -604,6 +614,16 @@ void TransactionService::Evse::setEvseReadyInput(std::function<bool()> connector
     this->evseReadyInput = connectorEnergized;
 }
 
+void TransactionService::Evse::setTxNotificationOutput(std::function<void(Ocpp201::Transaction*, TxNotification)> txNotificationOutput) {
+    this->txNotificationOutput = txNotificationOutput;
+}
+
+void TransactionService::Evse::updateTxNotification(TxNotification event) {
+    if (txNotificationOutput) {
+        txNotificationOutput(transaction.get(), event);
+    }
+}
+
 bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validateIdToken) {
     MO_DBG_DEBUG("begin auth: %s", idToken.get());
 
@@ -649,6 +669,8 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
                 MO_DBG_DEBUG("Authorize rejected (%s), abort tx process", tx->idToken.get());
                 tx->isDeauthorized = true;
                 txStore.commit(tx);
+
+                updateTxNotification(TxNotification_AuthorizationRejected);
                 return;
             }
 
@@ -656,6 +678,8 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
             tx->isAuthorized = true;
             tx->notifyIdToken = true;
             txStore.commit(tx);
+
+            updateTxNotification(TxNotification_Authorized);
         });
         authorize->setOnAbortListener([this, txId] () {
             auto tx = getTransaction();
@@ -667,6 +691,8 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
             MO_DBG_DEBUG("Authorize timeout (%s)", tx->idToken.get());
             tx->isDeauthorized = true;
             txStore.commit(tx);
+
+            updateTxNotification(TxNotification_AuthorizationTimeout);
         });
         authorize->setTimeout(20 * 1000);
         context.initiateRequest(std::move(authorize));
@@ -674,6 +700,9 @@ bool TransactionService::Evse::beginAuthorization(IdToken idToken, bool validate
         MO_DBG_DEBUG("Authorized tx directly (%s)", transaction->idToken.get());
         transaction->isAuthorized = true;
         transaction->notifyIdToken = true;
+        txStore.commit(transaction.get());
+
+        updateTxNotification(TxNotification_Authorized);
     }
 
     return true;
@@ -692,10 +721,16 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
         // use same idToken like tx start
         transaction->isAuthorizationActive = false;
         transaction->notifyIdToken = true;
+        txStore.commit(transaction.get());
+
+        updateTxNotification(TxNotification_Authorized);
     } else if (!validateIdToken) {
         transaction->stopIdToken = std::unique_ptr<IdToken>(new IdToken(idToken, getMemoryTag()));
         transaction->isAuthorizationActive = false;
         transaction->notifyStopIdToken = true;
+        txStore.commit(transaction.get());
+
+        updateTxNotification(TxNotification_Authorized);
     } else {
         // use a different idToken for stopping the tx
 
@@ -718,6 +753,8 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
 
             if (strcmp(response["idTokenInfo"]["status"] | "_Undefined", "Accepted")) {
                 MO_DBG_DEBUG("Authorize rejected (%s), don't stop tx", idToken.get());
+
+                updateTxNotification(TxNotification_AuthorizationRejected);
                 return;
             }
 
@@ -735,6 +772,17 @@ bool TransactionService::Evse::endAuthorization(IdToken idToken, bool validateId
             tx->isAuthorizationActive = false;
             tx->notifyStopIdToken = true;
             txStore.commit(tx);
+
+            updateTxNotification(TxNotification_Authorized);
+        });
+        authorize->setOnTimeoutListener([this, txId] () {
+            auto tx = getTransaction();
+            if (!tx || strcmp(tx->transactionId, txId)) {
+                MO_DBG_INFO("dangling Authorize -- discard");
+                return;
+            }
+
+            updateTxNotification(TxNotification_AuthorizationTimeout);
         });
         authorize->setTimeout(20 * 1000);
         context.initiateRequest(std::move(authorize));
diff --git a/src/MicroOcpp/Model/Transactions/TransactionService.h b/src/MicroOcpp/Model/Transactions/TransactionService.h
index 45a0b64a..36a0bc99 100644
--- a/src/MicroOcpp/Model/Transactions/TransactionService.h
+++ b/src/MicroOcpp/Model/Transactions/TransactionService.h
@@ -52,6 +52,8 @@ class TransactionService : public MemoryManaged {
         std::function<bool()> startTxReadyInput;
         std::function<bool()> stopTxReadyInput;
 
+        std::function<void(Ocpp201::Transaction*,TxNotification)> txNotificationOutput;
+
         bool beginTransaction();
         bool endTransaction(Ocpp201::Transaction::StoppedReason stoppedReason, Ocpp201::TransactionEventTriggerReason stopTrigger);
 
@@ -74,6 +76,9 @@ class TransactionService : public MemoryManaged {
         void setEvReadyInput(std::function<bool()> evRequestsEnergy);
         void setEvseReadyInput(std::function<bool()> connectorEnergized);
 
+        void setTxNotificationOutput(std::function<void(Ocpp201::Transaction*,TxNotification)> txNotificationOutput);
+        void updateTxNotification(TxNotification event);
+
         bool beginAuthorization(IdToken idToken, bool validateIdToken = true); // authorize by swipe RFID
         bool endAuthorization(IdToken idToken = IdToken(), bool validateIdToken = false); // stop authorization by swipe RFID
 
diff --git a/src/MicroOcpp/Model/Variables/VariableService.cpp b/src/MicroOcpp/Model/Variables/VariableService.cpp
index dcdc499d..9c0d6fde 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.cpp
+++ b/src/MicroOcpp/Model/Variables/VariableService.cpp
@@ -248,6 +248,18 @@ bool VariableService::addVariable(std::unique_ptr<Variable> variable) {
     return getContainerInternalByVariable(variable->getComponentId(), variable->getName()).add(std::move(variable));
 }
 
+bool VariableService::load() {
+    bool success = true;
+
+    for (size_t i = 0; i < MO_VARIABLESTORE_BUCKETS; i++) {
+        if (!containersInternal[i].load()) {
+            success = false;
+        }
+    }
+
+    return success;
+}
+
 bool VariableService::commit() {
     bool success = true;
 
diff --git a/src/MicroOcpp/Model/Variables/VariableService.h b/src/MicroOcpp/Model/Variables/VariableService.h
index d4621053..afe19099 100644
--- a/src/MicroOcpp/Model/Variables/VariableService.h
+++ b/src/MicroOcpp/Model/Variables/VariableService.h
@@ -77,6 +77,7 @@ class VariableService : public MemoryManaged {
     //Get Variable. If not existent, return nullptr
     Variable *getVariable(const ComponentId& component, const char *name);
 
+    bool load();
     bool commit();
 
     void addContainer(VariableContainer *container);
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
index b6f83bab..77314f36 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
@@ -106,7 +106,7 @@ void RemoteStartTransaction::processReq(JsonObject payload) {
             } else {
                 tx = selectConnector->beginTransaction_authorized(idTag);
             }
-            selectConnector->updateTxNotification(TxNotification::RemoteStart);
+            selectConnector->updateTxNotification(TxNotification_RemoteStart);
             if (tx) {
                 if (chargingProfileId >= 0) {
                     tx->setTxProfileId(chargingProfileId);
diff --git a/src/MicroOcpp/Operations/UnlockConnector.cpp b/src/MicroOcpp/Operations/UnlockConnector.cpp
index 3dfdbec9..a64b7bd4 100644
--- a/src/MicroOcpp/Operations/UnlockConnector.cpp
+++ b/src/MicroOcpp/Operations/UnlockConnector.cpp
@@ -38,7 +38,7 @@ void UnlockConnector::processReq(JsonObject payload) {
         }
 
         connector->endTransaction(nullptr, "UnlockCommand");
-        connector->updateTxNotification(TxNotification::RemoteStop);
+        connector->updateTxNotification(TxNotification_RemoteStop);
 
         cbUnlockResult = unlockConnector();
 
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index f47dd1cf..6771d0ae 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -5,7 +5,10 @@
 #include "MicroOcpp_c.h"
 #include "MicroOcpp.h"
 
+#include <MicroOcpp/Version.h>
 #include <MicroOcpp/Model/Certificates/Certificate_c.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Model/Model.h>
 #include <MicroOcpp/Core/Memory.h>
 
 #include <MicroOcpp/Platform.h>
@@ -13,11 +16,14 @@
 
 MicroOcpp::Connection *ocppSocket = nullptr;
 
-void ocpp_initialize(OCPP_Connection *conn, const char *chargePointModel, const char *chargePointVendor, struct OCPP_FilesystemOpt fsopt, bool autoRecover) {
-    ocpp_initialize_full(conn, ChargerCredentials(chargePointModel, chargePointVendor), fsopt, autoRecover);
+void ocpp_initialize(OCPP_Connection *conn, const char *chargePointModel, const char *chargePointVendor, struct OCPP_FilesystemOpt fsopt, bool autoRecover, bool ocpp201) {
+    ocpp_initialize_full(conn, ocpp201 ?
+                                    ChargerCredentials::v201(chargePointModel, chargePointVendor) :
+                                    ChargerCredentials(chargePointModel, chargePointVendor),
+                               fsopt, autoRecover, ocpp201);
 }
 
-void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt, bool autoRecover) {
+void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCredentials, struct OCPP_FilesystemOpt fsopt, bool autoRecover, bool ocpp201) {
     if (!conn) {
         MO_DBG_ERR("conn is null");
     }
@@ -26,7 +32,10 @@ void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCre
 
     MicroOcpp::FilesystemOpt adaptFsopt = fsopt;
 
-    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt), autoRecover, MicroOcpp::ProtocolVersion(1,6));
+    mocpp_initialize(*ocppSocket, bootNotificationCredentials, MicroOcpp::makeDefaultFilesystemAdapter(adaptFsopt), autoRecover,
+            ocpp201 ?
+                MicroOcpp::ProtocolVersion(2,0,1) :
+                MicroOcpp::ProtocolVersion(1,6));
 }
 
 void ocpp_deinitialize() {
@@ -131,18 +140,18 @@ std::function<UnlockConnectorResult()> adaptFn(unsigned int connectorId, PollUnl
 }
 #endif //MO_ENABLE_CONNECTOR_LOCK
 
-void ocpp_beginTransaction(const char *idTag) {
-    beginTransaction(idTag);
+bool ocpp_beginTransaction(const char *idTag) {
+    return beginTransaction(idTag);
 }
-void ocpp_beginTransaction_m(unsigned int connectorId, const char *idTag) {
-    beginTransaction(idTag, connectorId);
+bool ocpp_beginTransaction_m(unsigned int connectorId, const char *idTag) {
+    return beginTransaction(idTag, connectorId);
 }
 
-void ocpp_beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
-    beginTransaction_authorized(idTag, parentIdTag);
+bool ocpp_beginTransaction_authorized(const char *idTag, const char *parentIdTag) {
+    return beginTransaction_authorized(idTag, parentIdTag);
 }
-void ocpp_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag) {
-    beginTransaction_authorized(idTag, parentIdTag, connectorId);
+bool ocpp_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag) {
+    return beginTransaction_authorized(idTag, parentIdTag, connectorId);
 }
 
 bool ocpp_endTransaction(const char *idTag, const char *reason) {
@@ -184,10 +193,29 @@ OCPP_Transaction *ocpp_getTransaction() {
     return ocpp_getTransaction_m(1);
 }
 OCPP_Transaction *ocpp_getTransaction_m(unsigned int connectorId) {
+    #if MO_ENABLE_V201
+    {
+        if (!getOcppContext()) {
+            MO_DBG_ERR("OCPP uninitialized"); //need to call mocpp_initialize before
+            return nullptr;
+        }
+        if (getOcppContext()->getModel().getVersion().major == 2) {
+            ocpp_tx_compat_setV201(true); //set the ocpp_tx C-API into v201 mode globally
+            if (getTransactionV201(connectorId)) {
+                return reinterpret_cast<OCPP_Transaction*>(getTransactionV201(connectorId));
+            } else {
+                return nullptr;
+            }
+        } else {
+            ocpp_tx_compat_setV201(false); //set the ocpp_tx C-API into v16 mode globally
+            //continue with V16 implementation
+        }
+    }
+    #endif //MO_ENABLE_V201
     if (getTransaction(connectorId)) {
         return reinterpret_cast<OCPP_Transaction*>(getTransaction(connectorId).get());
     } else {
-        return NULL;
+        return nullptr;
     }
 }
 
@@ -308,14 +336,14 @@ void ocpp_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxRead
     setStopTxReadyInput(adaptFn(connectorId, stopTxReady), connectorId);
 }
 
-void ocpp_setTxNotificationOutput(void (*notificationOutput)(OCPP_Transaction*, enum OCPP_TxNotification)) {
-    setTxNotificationOutput([notificationOutput] (MicroOcpp::Transaction *tx, MicroOcpp::TxNotification notification) {
-        notificationOutput(reinterpret_cast<OCPP_Transaction*>(tx), convertTxNotification(notification));
+void ocpp_setTxNotificationOutput(void (*notificationOutput)(OCPP_Transaction*, TxNotification)) {
+    setTxNotificationOutput([notificationOutput] (MicroOcpp::Transaction *tx, TxNotification notification) {
+        notificationOutput(reinterpret_cast<OCPP_Transaction*>(tx), notification);
     });
 }
-void ocpp_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, OCPP_Transaction*, enum OCPP_TxNotification)) {
-    setTxNotificationOutput([notificationOutput, connectorId] (MicroOcpp::Transaction *tx, MicroOcpp::TxNotification notification) {
-        notificationOutput(connectorId, reinterpret_cast<OCPP_Transaction*>(tx), convertTxNotification(notification));
+void ocpp_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, OCPP_Transaction*, TxNotification)) {
+    setTxNotificationOutput([notificationOutput, connectorId] (MicroOcpp::Transaction *tx, TxNotification notification) {
+        notificationOutput(connectorId, reinterpret_cast<OCPP_Transaction*>(tx), notification);
     }, connectorId);
 }
 
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index c2e2cc1c..6477b6d6 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -9,7 +9,6 @@
 
 #include <MicroOcpp/Core/ConfigurationOptions.h>
 #include <MicroOcpp/Model/ConnectorBase/ChargePointStatus.h>
-#include <MicroOcpp/Model/ConnectorBase/Notification.h>
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/Certificates/Certificate_c.h>
@@ -61,14 +60,16 @@ void ocpp_initialize(
             const char *chargePointModel,     //model name of this charger (e.g. "My Charger")
             const char *chargePointVendor, //brand name (e.g. "My Company Ltd.")
             struct OCPP_FilesystemOpt fsopt, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
-            bool autoRecover); //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
+            bool autoRecover, //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
+            bool ocpp201); //true to select OCPP 2.0.1, false for OCPP 1.6
 
 //same as above, but more fields for the BootNotification
 void ocpp_initialize_full(
             OCPP_Connection *conn,  //WebSocket adapter for MicroOcpp
             const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
             struct OCPP_FilesystemOpt fsopt, //If this library should format the flash if necessary. Find further options in ConfigurationOptions.h
-            bool autoRecover); //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
+            bool autoRecover, //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
+            bool ocpp201); //true to select OCPP 2.0.1, false for OCPP 1.6
 
 void ocpp_deinitialize();
 
@@ -78,11 +79,11 @@ void ocpp_loop();
  * Charging session management
  */
 
-void ocpp_beginTransaction(const char *idTag);
-void ocpp_beginTransaction_m(unsigned int connectorId, const char *idTag); //multiple connectors version
+bool ocpp_beginTransaction(const char *idTag);
+bool ocpp_beginTransaction_m(unsigned int connectorId, const char *idTag); //multiple connectors version
 
-void ocpp_beginTransaction_authorized(const char *idTag, const char *parentIdTag);
-void ocpp_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag);
+bool ocpp_beginTransaction_authorized(const char *idTag, const char *parentIdTag);
+bool ocpp_beginTransaction_authorized_m(unsigned int connectorId, const char *idTag, const char *parentIdTag);
 
 bool ocpp_endTransaction(const char *idTag, const char *reason); //idTag, reason can be NULL
 bool ocpp_endTransaction_m(unsigned int connectorId, const char *idTag, const char *reason); //idTag, reason can be NULL
@@ -156,8 +157,8 @@ void ocpp_setStartTxReadyInput_m(unsigned int connectorId, InputBool_m startTxRe
 void ocpp_setStopTxReadyInput(InputBool stopTxReady);
 void ocpp_setStopTxReadyInput_m(unsigned int connectorId, InputBool_m stopTxReady);
 
-void ocpp_setTxNotificationOutput(void (*notificationOutput)(OCPP_Transaction*, enum OCPP_TxNotification));
-void ocpp_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, OCPP_Transaction*, enum OCPP_TxNotification));
+void ocpp_setTxNotificationOutput(void (*notificationOutput)(OCPP_Transaction*, TxNotification));
+void ocpp_setTxNotificationOutput_m(unsigned int connectorId, void (*notificationOutput)(unsigned int, OCPP_Transaction*, TxNotification));
 
 #if MO_ENABLE_CONNECTOR_LOCK
 void ocpp_setOnUnlockConnectorInOut(PollUnlockResult onUnlockConnectorInOut);
diff --git a/tests/Api.cpp b/tests/Api.cpp
index d7815e10..41f9f8a6 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -61,7 +61,7 @@ TEST_CASE( "C++ API test" ) {
         setOccupiedInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return false;});
         setStartTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
         setStopTxReadyInput([c = &checkpoints[ncheck++]] () -> bool {*c = true; return true;});
-        setTxNotificationOutput([c = &checkpoints[ncheck++]] (MicroOcpp::Transaction*, MicroOcpp::TxNotification) {*c = true;});
+        setTxNotificationOutput([c = &checkpoints[ncheck++]] (MicroOcpp::Transaction*, TxNotification) {*c = true;});
 
 #if MO_ENABLE_CONNECTOR_LOCK
         setOnUnlockConnectorInOut([c = &checkpoints[ncheck++]] () -> UnlockConnectorResult {*c = true; return UnlockConnectorResult_Unlocked;});
@@ -195,7 +195,7 @@ TEST_CASE( "C API test" ) {
     fsopt.formatFsOnFail = true;
 
     MicroOcpp::LoopbackConnection loopback;
-    ocpp_initialize(reinterpret_cast<OCPP_Connection*>(&loopback), "test-runner1234", "vendor", fsopt, false);
+    ocpp_initialize(reinterpret_cast<OCPP_Connection*>(&loopback), "test-runner1234", "vendor", fsopt, false, false);
     
     auto context = getOcppContext();
     auto& model = context->getModel();
@@ -249,8 +249,8 @@ TEST_CASE( "C API test" ) {
         ocpp_setStartTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[21] = true; return true;}); ncheckc++;
         ocpp_setStopTxReadyInput([] () -> bool {checkpointsc[22] = true; return true;}); ncheckc++;
         ocpp_setStopTxReadyInput_m(2, [] (unsigned int) -> bool {checkpointsc[23] = true; return true;}); ncheckc++;
-        ocpp_setTxNotificationOutput([] (OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[24] = true;}); ncheckc++;
-        ocpp_setTxNotificationOutput_m(2, [] (unsigned int, OCPP_Transaction*, OCPP_TxNotification) {checkpointsc[25] = true;}); ncheckc++;
+        ocpp_setTxNotificationOutput([] (OCPP_Transaction*, TxNotification) {checkpointsc[24] = true;}); ncheckc++;
+        ocpp_setTxNotificationOutput_m(2, [] (unsigned int, OCPP_Transaction*, TxNotification) {checkpointsc[25] = true;}); ncheckc++;
 
 #if MO_ENABLE_CONNECTOR_LOCK
         ocpp_setOnUnlockConnectorInOut([] () -> UnlockConnectorResult {checkpointsc[26] = true; return UnlockConnectorResult_Unlocked;}); ncheckc++;
diff --git a/tests/Boot.cpp b/tests/Boot.cpp
index c759b808..a4ea610f 100644
--- a/tests/Boot.cpp
+++ b/tests/Boot.cpp
@@ -378,7 +378,8 @@ TEST_CASE( "Boot Behavior" ) {
         old_opstore.reset(); //flushes the file
 
         loop();
-        auto tx = beginTransaction("mIdTag"); //tx store will also be removed
+        beginTransaction("mIdTag"); //tx store will also be removed
+        auto tx = getTransaction();
         auto txNr = tx->getTxNr(); //remember this for later usage
         tx.reset(); //reset this smart pointer
         loop();
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index ab3d8e6e..1ac9bdef 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -373,8 +373,8 @@ TEST_CASE( "Charging sessions" ) {
 
         // now, tx journal is full. Block any further charging session
 
-        auto tx = beginTransaction_authorized("mIdTag");
-        REQUIRE( !tx );
+        auto tx_success = beginTransaction_authorized("mIdTag");
+        REQUIRE( !tx_success );
 
         loop();
 
@@ -449,8 +449,8 @@ TEST_CASE( "Charging sessions" ) {
 
         // now, tx journal is full. Block any further charging session
 
-        auto tx = beginTransaction_authorized("mIdTag");
-        REQUIRE( tx );
+        auto tx_success = beginTransaction_authorized("mIdTag");
+        REQUIRE( tx_success );
 
         loop();
 
diff --git a/tests/LocalAuthList.cpp b/tests/LocalAuthList.cpp
index daca34c4..855a980b 100644
--- a/tests/LocalAuthList.cpp
+++ b/tests/LocalAuthList.cpp
@@ -94,7 +94,7 @@ TEST_CASE( "LocalAuth" ) {
         //check TX notification
         bool checkTxAuthorized = false;
         setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
-            if (txNotification == TxNotification::Authorized) {
+            if (txNotification == TxNotification_Authorized) {
                 checkTxAuthorized = true;
             }
         });
@@ -150,7 +150,7 @@ TEST_CASE( "LocalAuth" ) {
         //check TX notification
         bool checkTxAuthorized = false;
         setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
-            if (txNotification == TxNotification::Authorized) {
+            if (txNotification == TxNotification_Authorized) {
                 checkTxAuthorized = true;
             }
         });
@@ -182,7 +182,7 @@ TEST_CASE( "LocalAuth" ) {
         //make charger offline and begin tx, but idTag doesn't match - tx should be aborted
         bool checkTxTimeout = false;
         setTxNotificationOutput([&checkTxTimeout] (Transaction*, TxNotification txNotification) {
-            if (txNotification == TxNotification::AuthorizationTimeout) {
+            if (txNotification == TxNotification_AuthorizationTimeout) {
                 checkTxTimeout = true;
             }
         });
@@ -217,7 +217,7 @@ TEST_CASE( "LocalAuth" ) {
         //check TX notification
         bool checkTxAuthorized = false;
         setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
-            if (txNotification == TxNotification::Authorized) {
+            if (txNotification == TxNotification_Authorized) {
                 checkTxAuthorized = true;
             }
         });
@@ -255,7 +255,7 @@ TEST_CASE( "LocalAuth" ) {
         //check TX notification
         bool checkTxAuthorized = false;
         setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
-            if (txNotification == TxNotification::Authorized) {
+            if (txNotification == TxNotification_Authorized) {
                 checkTxAuthorized = true;
             }
         });
@@ -390,7 +390,7 @@ TEST_CASE( "LocalAuth" ) {
         //check TX notification
         bool checkTxAuthorized = false;
         setTxNotificationOutput([&checkTxAuthorized] (Transaction*, TxNotification txNotification) {
-            if (txNotification == TxNotification::Authorized) {
+            if (txNotification == TxNotification_Authorized) {
                 checkTxAuthorized = true;
             }
         });
@@ -427,7 +427,7 @@ TEST_CASE( "LocalAuth" ) {
         //check TX notification
         bool checkTxRejected = false;
         setTxNotificationOutput([&checkTxRejected] (Transaction*, TxNotification txNotification) {
-            if (txNotification == TxNotification::AuthorizationRejected) {
+            if (txNotification == TxNotification_AuthorizationRejected) {
                 checkTxRejected = true;
             }
         });
diff --git a/tests/Metering.cpp b/tests/Metering.cpp
index 23e79fe5..aa555e99 100644
--- a/tests/Metering.cpp
+++ b/tests/Metering.cpp
@@ -585,7 +585,8 @@ TEST_CASE("Metering") {
 
         auto trackMtime = mtime;
 
-        auto tx = beginTransaction_authorized("mIdTag");
+        beginTransaction_authorized("mIdTag");
+        auto tx = getTransaction();
 
         loop();
 
diff --git a/tests/Reservation.cpp b/tests/Reservation.cpp
index b25db0e2..306b804a 100644
--- a/tests/Reservation.cpp
+++ b/tests/Reservation.cpp
@@ -63,7 +63,7 @@ TEST_CASE( "Reservation" ) {
         //transaction blocked by reservation
         bool checkTxRejected = false;
         setTxNotificationOutput([&checkTxRejected] (Transaction*, TxNotification txNotification) {
-            if (txNotification == TxNotification::ReservationConflict) {
+            if (txNotification == TxNotification_ReservationConflict) {
                 checkTxRejected = true;
             }
         });
@@ -225,7 +225,7 @@ TEST_CASE( "Reservation" ) {
 
         bool checkTxRejected = false;
         setTxNotificationOutput([&checkTxRejected] (Transaction*, TxNotification txNotification) {
-            if (txNotification == TxNotification::ReservationConflict) {
+            if (txNotification == TxNotification_ReservationConflict) {
                 checkTxRejected = true;
             }
         }, 2);
diff --git a/tests/benchmarks/firmware_size/main.cpp b/tests/benchmarks/firmware_size/main.cpp
index f1d07cd1..6e849b8d 100644
--- a/tests/benchmarks/firmware_size/main.cpp
+++ b/tests/benchmarks/firmware_size/main.cpp
@@ -43,7 +43,7 @@ void setup() {
     ocpp_setOccupiedInput([] () {return false;});
     ocpp_setStartTxReadyInput([] () {return false;});
     ocpp_setStopTxReadyInput([] () {return false;});
-    ocpp_setTxNotificationOutput([] (OCPP_Transaction*, OCPP_TxNotification) {});
+    ocpp_setTxNotificationOutput([] (OCPP_Transaction*, TxNotification) {});
 
 #if MO_ENABLE_CONNECTOR_LOCK
     ocpp_setOnUnlockConnectorInOut([] () {return UnlockConnectorResult_UnlockFailed;});
diff --git a/tests/benchmarks/scripts/eval_firmware_size.py b/tests/benchmarks/scripts/eval_firmware_size.py
index 5d544028..a952f7f8 100755
--- a/tests/benchmarks/scripts/eval_firmware_size.py
+++ b/tests/benchmarks/scripts/eval_firmware_size.py
@@ -100,10 +100,17 @@ def categorize_table(df):
     df.at['Core/Time.cpp', 'v16'] = TICK
     df.at['Core/Time.cpp', 'v201'] = TICK
     df.at['Core/Time.cpp', 'Module'] = MODULE_GENERAL
+    df.at['Core/UuidUtils.cpp', 'v16'] = TICK
+    df.at['Core/UuidUtils.cpp', 'v201'] = TICK
+    df.at['Core/UuidUtils.cpp', 'Module'] = MODULE_GENERAL
     if 'Debug.cpp' in df.index:
         df.at['Debug.cpp', 'v16'] = TICK
         df.at['Debug.cpp', 'v201'] = TICK
         df.at['Debug.cpp', 'Module'] = MODULE_HAL
+    if 'Platform.cpp' in df.index:
+        df.at['Platform.cpp', 'v16'] = TICK
+        df.at['Platform.cpp', 'v201'] = TICK
+        df.at['Platform.cpp', 'Module'] = MODULE_HAL
     df.at['Model/Authorization/AuthorizationData.cpp', 'v16'] = TICK
     df.at['Model/Authorization/AuthorizationData.cpp', 'Module'] = MODULE_LOCALAUTH
     df.at['Model/Authorization/AuthorizationList.cpp', 'v16'] = TICK
@@ -137,9 +144,6 @@ def categorize_table(df):
     df.at['Model/ConnectorBase/Connector.cpp', 'Module'] = MODULE_CORE
     df.at['Model/ConnectorBase/ConnectorsCommon.cpp', 'v16'] = TICK
     df.at['Model/ConnectorBase/ConnectorsCommon.cpp', 'Module'] = MODULE_CORE
-    if 'Model/ConnectorBase/Notification.cpp' in df.index:
-        df.at['Model/ConnectorBase/Notification.cpp', 'v16'] = TICK
-        df.at['Model/ConnectorBase/Notification.cpp', 'Module'] = MODULE_CORE
     df.at['Model/Diagnostics/DiagnosticsService.cpp', 'v16'] = TICK
     df.at['Model/Diagnostics/DiagnosticsService.cpp', 'Module'] = MODULE_FW_MNGT
     df.at['Model/FirmwareManagement/FirmwareService.cpp', 'v16'] = TICK
diff --git a/tests/benchmarks/scripts/measure_heap.py b/tests/benchmarks/scripts/measure_heap.py
index 8ae75ddc..0b050544 100644
--- a/tests/benchmarks/scripts/measure_heap.py
+++ b/tests/benchmarks/scripts/measure_heap.py
@@ -15,86 +15,86 @@
 # Test case selection (commented out a few to simplify testing for now)
 testcase_name_list = [
     'TC_B_06_CS',
-    #'TC_B_07_CS',
-    #'TC_B_09_CS',
+    'TC_B_07_CS',
+    'TC_B_09_CS',
     'TC_B_10_CS',
-    #'TC_B_11_CS',
-    #'TC_B_12_CS',
+    'TC_B_11_CS',
+    'TC_B_12_CS',
     'TC_B_13_CS',
-    #'TC_B_32_CS',
-    #'TC_B_34_CS',
+    'TC_B_32_CS',
+    'TC_B_34_CS',
     'TC_B_35_CS',
-    #'TC_B_36_CS',
-    #'TC_B_37_CS',
+    'TC_B_36_CS',
+    'TC_B_37_CS',
     'TC_B_39_CS',
-    #'TC_C_02_CS',
-    #'TC_C_04_CS',
+    'TC_C_02_CS',
+    'TC_C_04_CS',
     'TC_C_06_CS',
-    #'TC_C_07_CS',
-    #'TC_C_49_CS',
+    'TC_C_07_CS',
+    'TC_C_49_CS',
     'TC_E_01_CS',
-    #'TC_E_02_CS',
-    #'TC_E_03_CS',
+    'TC_E_02_CS',
+    'TC_E_03_CS',
     'TC_E_04_CS',
-    #'TC_E_05_CS',
-    #'TC_E_06_CS',
+    'TC_E_05_CS',
+    'TC_E_06_CS',
     'TC_E_07_CS',
-    #'TC_E_09_CS',
-    #'TC_E_13_CS',
+    'TC_E_09_CS',
+    'TC_E_13_CS',
     'TC_E_15_CS',
-    #'TC_E_17_CS',
-    #'TC_E_20_CS',
+    'TC_E_17_CS',
+    'TC_E_20_CS',
     'TC_E_21_CS',
-    #'TC_E_24_CS',
-    #'TC_E_25_CS',
+    'TC_E_24_CS',
+    'TC_E_25_CS',
     'TC_E_28_CS',
-    #'TC_E_29_CS',
-    #'TC_E_30_CS',
+    'TC_E_29_CS',
+    'TC_E_30_CS',
     'TC_E_31_CS',
-    #'TC_E_32_CS',
-    #'TC_E_33_CS',
+    'TC_E_32_CS',
+    'TC_E_33_CS',
     'TC_E_34_CS',
-    #'TC_E_35_CS',
-    #'TC_E_39_CS',
+    'TC_E_35_CS',
+    'TC_E_39_CS',
     'TC_F_01_CS',
-    #'TC_F_02_CS',
-    #'TC_F_03_CS',
+    'TC_F_02_CS',
+    'TC_F_03_CS',
     'TC_F_04_CS',
-    #'TC_F_05_CS',
-    #'TC_F_06_CS',
+    'TC_F_05_CS',
+    'TC_F_06_CS',
     'TC_F_07_CS',
-    #'TC_F_08_CS',
-    #'TC_F_09_CS',
+    'TC_F_08_CS',
+    'TC_F_09_CS',
     'TC_F_10_CS',
-    #'TC_F_11_CS',
-    #'TC_F_12_CS',
+    'TC_F_11_CS',
+    'TC_F_12_CS',
     'TC_F_13_CS',
-    #'TC_F_14_CS',
-    #'TC_F_20_CS',
+    'TC_F_14_CS',
+    'TC_F_20_CS',
     'TC_F_23_CS',
-    #'TC_F_24_CS',
-    #'TC_F_26_CS',
+    'TC_F_24_CS',
+    'TC_F_26_CS',
     'TC_F_27_CS',
-    #'TC_G_01_CS',
-    #'TC_G_02_CS',
+    'TC_G_01_CS',
+    'TC_G_02_CS',
     'TC_G_03_CS',
-    #'TC_G_04_CS',
-    #'TC_G_05_CS',
+    'TC_G_04_CS',
+    'TC_G_05_CS',
     'TC_G_06_CS',
-    #'TC_G_07_CS',
-    #'TC_G_08_CS',
+    'TC_G_07_CS',
+    'TC_G_08_CS',
     'TC_G_09_CS',
-    #'TC_G_10_CS',
-    #'TC_G_11_CS',
+    'TC_G_10_CS',
+    'TC_G_11_CS',
     'TC_G_12_CS',
-    #'TC_G_13_CS',
-    #'TC_G_14_CS',
+    'TC_G_13_CS',
+    'TC_G_14_CS',
     'TC_G_15_CS',
-    #'TC_G_16_CS',
-    #'TC_G_17_CS',
+    'TC_G_16_CS',
+    'TC_G_17_CS',
     'TC_J_07_CS',
-    #'TC_J_08_CS',
-    #'TC_J_09_CS',
+    'TC_J_08_CS',
+    'TC_J_09_CS',
     'TC_J_10_CS',
 ]
 

From e6b7bc829f282e2fefc5f473c4c450f4dd055a0c Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <makstaller@tesla.com>
Date: Mon, 20 Jan 2025 13:59:01 +0100
Subject: [PATCH 537/549] Fix SConscript file

* Previously, the SConscript added all MO subfolders to the global include paths. However, MO expects only ./src to be on include and the superfluous folders may lead to filename conflicts.

* Remove ArduinoJson from the sources as it's a header-only library and only needs to be on the include path

* Add .c files to the list of source objects
---
 SConscript.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/SConscript.py b/SConscript.py
index 5bccda82..a33ab3f6 100644
--- a/SConscript.py
+++ b/SConscript.py
@@ -7,7 +7,7 @@
 #       Use this file as a starting point for writing your own SCons integration. And as always, any
 #       contributions are highly welcome!
 
-Import("env", "ARDUINOJSON_DIR")
+Import("env")
 
 import os, pathlib
 
@@ -17,16 +17,15 @@ def getAllDirs(root_dir):
         dir_list.append(Dir(root))
     return dir_list
 
-SOURCE_DIR = Dir(".").srcnode()
+SOURCE_DIR = Dir(".").srcnode().Dir("src")
 
-source_dirs = getAllDirs(SOURCE_DIR.Dir("src"))
-source_dirs += getAllDirs(ARDUINOJSON_DIR.Dir("src"))
+source_dirs = getAllDirs(SOURCE_DIR)
 
 source_files = []
 
 for folder in source_dirs:
+    source_files += folder.glob("*.c")
     source_files += folder.glob("*.cpp")
-    env["CPPPATH"].append(folder)
 
 compiled_objects = []
 for source_file in source_files:
@@ -44,7 +43,7 @@ def getAllDirs(root_dir):
 
 exports = {
     'library': libmicroocpp,
-    'CPPPATH': source_dirs.copy()
+    'CPPPATH': SOURCE_DIR
 }
 
 Return("exports")

From 92764c2a3dc003bc4ef6162a3c20a84e3ec8dbb3 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <makstaller@tesla.com>
Date: Mon, 20 Jan 2025 14:01:06 +0100
Subject: [PATCH 538/549] Add Config write-only option

The "AuthorizationKey" config is specified as write-only and thus, may be updated by the server but not reported through the GetConfiguration option.
---
 src/MicroOcpp/Core/ConfigurationKeyValue.cpp  | 20 +++++++++++++++++--
 src/MicroOcpp/Core/ConfigurationKeyValue.h    | 13 +++++++++++-
 src/MicroOcpp/Operations/GetConfiguration.cpp |  5 ++++-
 3 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
index 033e371a..77e8ad85 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.cpp
@@ -75,11 +75,27 @@ bool Configuration::isRebootRequired() {
 }
 
 void Configuration::setReadOnly() {
-    readOnly = true;
+    if (mutability == Mutability::ReadWrite) {
+        mutability = Mutability::ReadOnly;
+    } else {
+        mutability = Mutability::None;
+    }
 }
 
 bool Configuration::isReadOnly() {
-    return readOnly;
+    return mutability == Mutability::ReadOnly;
+}
+
+bool Configuration::isReadable() {
+    return mutability == Mutability::ReadWrite || mutability == Mutability::ReadOnly;
+}
+
+void Configuration::setWriteOnly() {
+    if (mutability == Mutability::ReadWrite) {
+        mutability = Mutability::WriteOnly;
+    } else {
+        mutability = Mutability::None;
+    }
 }
 
 /*
diff --git a/src/MicroOcpp/Core/ConfigurationKeyValue.h b/src/MicroOcpp/Core/ConfigurationKeyValue.h
index e11a0484..3e631c1e 100644
--- a/src/MicroOcpp/Core/ConfigurationKeyValue.h
+++ b/src/MicroOcpp/Core/ConfigurationKeyValue.h
@@ -36,7 +36,15 @@ class Configuration {
     revision_t value_revision = 0; //write access counter; used to check if this config has been changed
 private:
     bool rebootRequired = false;
-    bool readOnly = false;
+
+    enum class Mutability : uint8_t {
+        ReadWrite,
+        ReadOnly,
+        WriteOnly,
+        None
+    };
+    Mutability mutability = Mutability::ReadWrite;
+
 public:
     virtual ~Configuration();
 
@@ -60,6 +68,9 @@ class Configuration {
 
     void setReadOnly();
     bool isReadOnly();
+    bool isReadable();
+
+    void setWriteOnly();
 };
 
 /*
diff --git a/src/MicroOcpp/Operations/GetConfiguration.cpp b/src/MicroOcpp/Operations/GetConfiguration.cpp
index 1ba7ef0a..8146bba1 100644
--- a/src/MicroOcpp/Operations/GetConfiguration.cpp
+++ b/src/MicroOcpp/Operations/GetConfiguration.cpp
@@ -40,6 +40,9 @@ std::unique_ptr<JsonDoc> GetConfiguration::createConf(){
                     MO_DBG_ERR("invalid config");
                     continue;
                 }
+                if (!container->getConfiguration(i)->isReadable()) {
+                    continue;
+                }
                 configurations.push_back(container->getConfiguration(i));
             }
         }
@@ -53,7 +56,7 @@ std::unique_ptr<JsonDoc> GetConfiguration::createConf(){
                 }
             }
 
-            if (res) {
+            if (res && res->isReadable()) {
                 configurations.push_back(res);
             } else {
                 unknownKeys.push_back(key.c_str());

From ef8e771c443805f24a516f38952a2d0a3b2e5e58 Mon Sep 17 00:00:00 2001
From: Matthias Akstaller <makstaller@tesla.com>
Date: Mon, 20 Jan 2025 14:05:12 +0100
Subject: [PATCH 539/549] Update C-APIs

* Remove Platform setup functions from MicroOcpp_c.h /.cpp which can be found in Platform.h

* Add FilesystemAdapter C-handle

* Expose library lifecycle through `ocpp_is_initialized()`

* Update Configuration C-API

* Update Transaction C-API
---
 src/MicroOcpp/Core/Configuration_c.cpp        | 138 ++++++++++++++++--
 src/MicroOcpp/Core/Configuration_c.h          |  13 ++
 .../Model/Transactions/Transaction.cpp        |  10 ++
 .../Model/Transactions/Transaction.h          |   4 +-
 src/MicroOcpp/Platform.h                      |  32 ++--
 src/MicroOcpp_c.cpp                           |  55 +++++--
 src/MicroOcpp_c.h                             |  31 ++--
 7 files changed, 230 insertions(+), 53 deletions(-)

diff --git a/src/MicroOcpp/Core/Configuration_c.cpp b/src/MicroOcpp/Core/Configuration_c.cpp
index a85a1edd..6b6998e1 100644
--- a/src/MicroOcpp/Core/Configuration_c.cpp
+++ b/src/MicroOcpp/Core/Configuration_c.cpp
@@ -15,7 +15,15 @@ class ConfigurationC : public Configuration, public MemoryManaged {
 public:
     ConfigurationC(ocpp_configuration *config) :
             config(config) {
-        config->mo_data = this;
+        if (config->read_only) {
+            setReadOnly();
+        }
+        if (config->write_only) {
+            setWriteOnly();
+        }
+        if (config->reboot_required) {
+            setRebootRequired();
+        }
     }
 
     bool setKey(const char *key) override {
@@ -116,6 +124,59 @@ class ConfigurationC : public Configuration, public MemoryManaged {
     }
 };
 
+namespace MicroOcpp {
+
+ConfigurationC *getConfigurationC(ocpp_configuration *config) {
+    if (!config->mo_data) {
+        return nullptr;
+    }
+    return reinterpret_cast<std::shared_ptr<ConfigurationC>*>(config->mo_data)->get();
+}
+
+}
+
+using namespace MicroOcpp;
+
+
+void ocpp_setRebootRequired(ocpp_configuration *config) {
+    if (auto c = getConfigurationC(config)) {
+        c->setRebootRequired();
+    }
+    config->reboot_required = true;
+}
+bool ocpp_isRebootRequired(ocpp_configuration *config) {
+    if (auto c = getConfigurationC(config)) {
+        return c->isRebootRequired();
+    }
+    return config->reboot_required;
+}
+
+void ocpp_setReadOnly(ocpp_configuration *config) {
+    if (auto c = getConfigurationC(config)) {
+        c->setReadOnly();
+    }
+    config->read_only = true;
+}
+bool ocpp_isReadOnly(ocpp_configuration *config) {
+    if (auto c = getConfigurationC(config)) {
+        return c->isReadOnly();
+    }
+    return config->read_only;
+}
+bool ocpp_isReadable(ocpp_configuration *config) {
+    if (auto c = getConfigurationC(config)) {
+        return c->isReadable();
+    }
+    return !config->write_only;
+}
+
+void ocpp_setWriteOnly(ocpp_configuration *config) {
+    if (auto c = getConfigurationC(config)) {
+        c->setWriteOnly();
+    }
+    config->write_only = true;
+}
+
 class ConfigurationContainerC : public ConfigurationContainer, public MemoryManaged {
 private:
     ocpp_configuration_container *container;
@@ -125,15 +186,41 @@ class ConfigurationContainerC : public ConfigurationContainer, public MemoryMana
 
     }
 
+    ~ConfigurationContainerC() {
+        for (size_t i = 0; i < container->size(container->user_data); i++) {
+            if (auto config = container->get_configuration(container->user_data, i)) {
+                if (config->mo_data) {
+                    delete reinterpret_cast<std::shared_ptr<ConfigurationC>*>(config->mo_data);
+                    config->mo_data = nullptr;
+                }
+            }
+        }
+    }
+
     bool load() override {
-        return container->load(container->user_data);
+        if (container->load) {
+            return container->load(container->user_data);
+        } else {
+            return true;
+        }
     }
 
     bool save() override {
-        return container->save(container->user_data);
+        if (container->save) {
+            return container->save(container->user_data);
+        } else {
+            return true;
+        }
     }
 
     std::shared_ptr<Configuration> createConfiguration(TConfig type, const char *key) override {
+
+        auto result = std::shared_ptr<ConfigurationC>(nullptr, std::default_delete<ConfigurationC>(), makeAllocator<ConfigurationC>(getMemoryTag()));
+
+        if (!container->create_configuration) {
+            return result;
+        }
+
         ocpp_config_datatype dt;
         switch (type) {
             case TConfig::Int:
@@ -147,19 +234,38 @@ class ConfigurationContainerC : public ConfigurationContainer, public MemoryMana
                 break;
             default:
                 MO_DBG_ERR("internal error");
-                return nullptr;
+                return result;
         }
         ocpp_configuration *config = container->create_configuration(container->user_data, dt, key);
+        if (!config) {
+            return result;
+        }
+        
+        result.reset(new ConfigurationC(config));
 
-        if (config) {
-            return std::allocate_shared<ConfigurationC>(makeAllocator<ConfigurationC>(getMemoryTag()), config);
+        if (result) {
+            auto captureConfigC = new std::shared_ptr<ConfigurationC>(result);
+            config->mo_data = reinterpret_cast<void*>(captureConfigC);
         } else {
             MO_DBG_ERR("could not create config: %s", key);
-            return nullptr;
+            if (container->remove) {
+                container->remove(container->user_data, key);
+            }
         }
+
+        return result;
     }
 
     void remove(Configuration *config) override {
+        if (!container->remove) {
+            return;
+        }
+
+        if (auto c = container->get_configuration_by_key(container->user_data, config->getKey())) {
+            delete reinterpret_cast<std::shared_ptr<ConfigurationC>*>(c->mo_data);
+            c->mo_data = nullptr;
+        }
+
         container->remove(container->user_data, config->getKey());
     }
 
@@ -170,16 +276,28 @@ class ConfigurationContainerC : public ConfigurationContainer, public MemoryMana
     Configuration *getConfiguration(size_t i) override {
         auto config = container->get_configuration(container->user_data, i);
         if (config) {
-            return static_cast<Configuration*>(config->mo_data);
+            if (!config->mo_data) {
+                auto c = new ConfigurationC(config);
+                if (c) {
+                    config->mo_data = reinterpret_cast<void*>(new std::shared_ptr<ConfigurationC>(c, std::default_delete<ConfigurationC>(), makeAllocator<ConfigurationC>(getMemoryTag())));
+                }
+            }
+            return static_cast<Configuration*>(config->mo_data ? reinterpret_cast<std::shared_ptr<ConfigurationC>*>(config->mo_data)->get() : nullptr);
         } else {
             return nullptr;
         }
     }
 
     std::shared_ptr<Configuration> getConfiguration(const char *key) override {
-        ocpp_configuration *config = container->get_configuration_by_key(container->user_data, key);
+        auto config = container->get_configuration_by_key(container->user_data, key);
         if (config) {
-            return std::allocate_shared<ConfigurationC>(makeAllocator<ConfigurationC>(getMemoryTag()), config);
+            if (!config->mo_data) {
+                auto c = new ConfigurationC(config);
+                if (c) {
+                    config->mo_data = reinterpret_cast<void*>(new std::shared_ptr<ConfigurationC>(c, std::default_delete<ConfigurationC>(), makeAllocator<ConfigurationC>(getMemoryTag())));
+                }
+            }
+            return config->mo_data ? *reinterpret_cast<std::shared_ptr<ConfigurationC>*>(config->mo_data) : nullptr;
         } else {
             return nullptr;
         }
diff --git a/src/MicroOcpp/Core/Configuration_c.h b/src/MicroOcpp/Core/Configuration_c.h
index 8dd47ad1..94172d07 100644
--- a/src/MicroOcpp/Core/Configuration_c.h
+++ b/src/MicroOcpp/Core/Configuration_c.h
@@ -42,9 +42,22 @@ typedef struct ocpp_configuration {
 
     uint16_t (*get_write_count) (void *user_data); // Return number of changes of the value. MO uses this to detect if the firmware has updated the config
 
+    bool read_only;
+    bool write_only;
+    bool reboot_required;
+
     void *mo_data; // Reserved for MO
 } ocpp_configuration;
 
+void ocpp_setRebootRequired(ocpp_configuration *config);
+bool ocpp_isRebootRequired(ocpp_configuration *config);
+
+void ocpp_setReadOnly(ocpp_configuration *config);
+bool ocpp_isReadOnly(ocpp_configuration *config);
+bool ocpp_isReadable(ocpp_configuration *config);
+
+void ocpp_setWriteOnly(ocpp_configuration *config);
+
 typedef struct ocpp_configuration_container {
     void *user_data; //set this at your choice. MO passes it back to the functions below
 
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.cpp b/src/MicroOcpp/Model/Transactions/Transaction.cpp
index 7a48a7da..a53b68f1 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.cpp
+++ b/src/MicroOcpp/Model/Transactions/Transaction.cpp
@@ -444,6 +444,16 @@ const char *ocpp_tx_getIdTag(OCPP_Transaction *tx) {
     return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getIdTag();
 }
 
+const char *ocpp_tx_getParentIdTag(OCPP_Transaction *tx) {
+    #if MO_ENABLE_V201
+    if (g_ocpp_tx_compat_v201) {
+        MO_DBG_ERR("only supported in v16");
+        return nullptr;
+    }
+    #endif //MO_ENABLE_V201
+    return reinterpret_cast<MicroOcpp::Transaction*>(tx)->getParentIdTag();
+}
+
 bool ocpp_tx_getBeginTimestamp(OCPP_Transaction *tx, char *buf, size_t len) {
     #if MO_ENABLE_V201
     if (g_ocpp_tx_compat_v201) {
diff --git a/src/MicroOcpp/Model/Transactions/Transaction.h b/src/MicroOcpp/Model/Transactions/Transaction.h
index 877ccc4c..5dc3e869 100644
--- a/src/MicroOcpp/Model/Transactions/Transaction.h
+++ b/src/MicroOcpp/Model/Transactions/Transaction.h
@@ -14,7 +14,7 @@ extern "C" {
 
 //TxNotification - event from MO to the main firmware to notify it about transaction state changes
 typedef enum {
-    UNDEFINED,
+    TxNotification_UNDEFINED,
 
     //Authorization events
     TxNotification_Authorized, //success
@@ -473,6 +473,8 @@ bool ocpp_tx_isCompleted(OCPP_Transaction *tx);
 
 const char *ocpp_tx_getIdTag(OCPP_Transaction *tx);
 
+const char *ocpp_tx_getParentIdTag(OCPP_Transaction *tx);
+
 bool ocpp_tx_getBeginTimestamp(OCPP_Transaction *tx, char *buf, size_t len);
 
 int32_t ocpp_tx_getMeterStart(OCPP_Transaction *tx);
diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index 5582dc2a..a3da99ea 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -16,6 +16,12 @@
 #define MO_PLATFORM MO_PLATFORM_ARDUINO
 #endif
 
+#ifdef __cplusplus
+#define MO_EXTERN_C extern "C"
+#else
+#define MO_EXTERN_C
+#endif
+
 #if MO_PLATFORM == MO_PLATFORM_NONE
 #ifndef MO_CUSTOM_CONSOLE
 #define MO_CUSTOM_CONSOLE
@@ -32,18 +38,10 @@
 #define MO_CUSTOM_CONSOLE_MAXMSGSIZE 256
 #endif
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
 extern char _mo_console_msg_buf [MO_CUSTOM_CONSOLE_MAXMSGSIZE]; //define msg_buf in data section to save memory (see https://github.com/matth-x/MicroOcpp/pull/304)
-void _mo_console_out(const char *msg);
-
-void mocpp_set_console_out(void (*console_out)(const char *msg));
+MO_EXTERN_C void _mo_console_out(const char *msg);
 
-#ifdef __cplusplus
-}
-#endif
+MO_EXTERN_C void mocpp_set_console_out(void (*console_out)(const char *msg));
 
 #define MO_CONSOLE_PRINTF(X, ...) \
             do { \
@@ -79,9 +77,9 @@ void mocpp_set_console_out(void (*console_out)(const char *msg));
 #endif
 
 #ifdef MO_CUSTOM_TIMER
-extern "C" void mocpp_set_timer(unsigned long (*get_ms)());
+MO_EXTERN_C void mocpp_set_timer(unsigned long (*get_ms)());
 
-extern "C" unsigned long mocpp_tick_ms_custom();
+MO_EXTERN_C unsigned long mocpp_tick_ms_custom();
 #define mocpp_tick_ms mocpp_tick_ms_custom
 #else
 
@@ -89,20 +87,20 @@ extern "C" unsigned long mocpp_tick_ms_custom();
 #include <Arduino.h>
 #define mocpp_tick_ms millis
 #elif MO_PLATFORM == MO_PLATFORM_ESPIDF
-extern "C" unsigned long mocpp_tick_ms_espidf();
+MO_EXTERN_C unsigned long mocpp_tick_ms_espidf();
 #define mocpp_tick_ms mocpp_tick_ms_espidf
 #elif MO_PLATFORM == MO_PLATFORM_UNIX
-extern "C" unsigned long mocpp_tick_ms_unix();
+MO_EXTERN_C unsigned long mocpp_tick_ms_unix();
 #define mocpp_tick_ms mocpp_tick_ms_unix
 #endif
 #endif
 
 #ifdef MO_CUSTOM_RNG
-void mocpp_set_rng(uint32_t (*rng)());
-uint32_t mocpp_rng_custom();
+MO_EXTERN_C void mocpp_set_rng(uint32_t (*rng)());
+MO_EXTERN_C uint32_t mocpp_rng_custom();
 #define mocpp_rng mocpp_rng_custom
 #else
-uint32_t mocpp_time_based_prng(void);
+MO_EXTERN_C uint32_t mocpp_time_based_prng(void);
 #define mocpp_rng mocpp_time_based_prng
 #endif
 
diff --git a/src/MicroOcpp_c.cpp b/src/MicroOcpp_c.cpp
index 6771d0ae..381084b0 100644
--- a/src/MicroOcpp_c.cpp
+++ b/src/MicroOcpp_c.cpp
@@ -38,10 +38,27 @@ void ocpp_initialize_full(OCPP_Connection *conn, const char *bootNotificationCre
                 MicroOcpp::ProtocolVersion(1,6));
 }
 
+void ocpp_initialize_full2(OCPP_Connection *conn, const char *bootNotificationCredentials, FilesystemAdapterC *filesystem, bool autoRecover, bool ocpp201) {
+    if (!conn) {
+        MO_DBG_ERR("conn is null");
+    }
+
+    ocppSocket = reinterpret_cast<MicroOcpp::Connection*>(conn);
+
+    mocpp_initialize(*ocppSocket, bootNotificationCredentials, *reinterpret_cast<std::shared_ptr<MicroOcpp::FilesystemAdapter>*>(filesystem), autoRecover,
+            ocpp201 ?
+                MicroOcpp::ProtocolVersion(2,0,1) :
+                MicroOcpp::ProtocolVersion(1,6));
+}
+
 void ocpp_deinitialize() {
     mocpp_deinitialize();
 }
 
+bool ocpp_is_initialized() {
+    return getOcppContext() != nullptr;
+}
+
 void ocpp_loop() {
     mocpp_loop();
 }
@@ -302,6 +319,33 @@ void ocpp_addMeterValueInputFloat_m(unsigned int connectorId, InputFloat_m value
     addMeterValueInput(adaptFn(connectorId, valueInput), measurand, unit, location, phase, connectorId);
 }
 
+void ocpp_addMeterValueInputIntTx(int (*valueInput)(ReadingContext), const char *measurand, const char *unit, const char *location, const char *phase) {
+    MicroOcpp::SampledValueProperties props;
+    props.setMeasurand(measurand);
+    props.setUnit(unit);
+    props.setLocation(location);
+    props.setPhase(phase);
+    auto mvs = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>>(
+                           new MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>(
+            props,
+            [valueInput] (ReadingContext readingContext) {return valueInput(readingContext);}
+    ));
+    addMeterValueInput(std::move(mvs));
+}
+void ocpp_addMeterValueInputIntTx_m(unsigned int connectorId, int (*valueInput)(unsigned int cId, ReadingContext), const char *measurand, const char *unit, const char *location, const char *phase) {
+    MicroOcpp::SampledValueProperties props;
+    props.setMeasurand(measurand);
+    props.setUnit(unit);
+    props.setLocation(location);
+    props.setPhase(phase);
+    auto mvs = std::unique_ptr<MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>>(
+                           new MicroOcpp::SampledValueSamplerConcrete<int32_t, MicroOcpp::SampledValueDeSerializer<int32_t>>(
+            props,
+            [valueInput, connectorId] (ReadingContext readingContext) {return valueInput(connectorId, readingContext);}
+    ));
+    addMeterValueInput(std::move(mvs), connectorId);
+}
+
 void ocpp_addMeterValueInput(MeterValueInput *meterValueInput) {
     ocpp_addMeterValueInput_m(1, meterValueInput);
 }
@@ -386,17 +430,6 @@ void ocpp_setOnSendConf(const char *operationType, OnMessage onConfirmation) {
     setOnSendConf(operationType, adaptFn(onConfirmation));
 }
 
-void ocpp_set_console_out_c(void (*console_out)(const char *msg)) {
-    mocpp_set_console_out(console_out);
-}
-
-#ifdef MO_CUSTOM_RNG
-void ocpp_set_rng_c(uint32_t (*rng)(void))
-{
-    mocpp_set_rng(rng);
-}
-#endif
-
 void ocpp_authorize(const char *idTag, AuthorizeConfCallback onConfirmation, AuthorizeAbortCallback onAbort, AuthorizeTimeoutCallback onTimeout, AuthorizeErrorCallback onError, void *user_data) {
     
     auto idTag_capture = MicroOcpp::makeString("MicroOcpp_c.cpp", idTag);
diff --git a/src/MicroOcpp_c.h b/src/MicroOcpp_c.h
index 6477b6d6..a517ff1d 100644
--- a/src/MicroOcpp_c.h
+++ b/src/MicroOcpp_c.h
@@ -12,6 +12,7 @@
 #include <MicroOcpp/Model/ConnectorBase/UnlockConnectorResult.h>
 #include <MicroOcpp/Model/Transactions/Transaction.h>
 #include <MicroOcpp/Model/Certificates/Certificate_c.h>
+#include <MicroOcpp/Model/Metering/ReadingContext.h>
 
 struct OCPP_Connection;
 typedef struct OCPP_Connection OCPP_Connection;
@@ -19,6 +20,9 @@ typedef struct OCPP_Connection OCPP_Connection;
 struct MeterValueInput;
 typedef struct MeterValueInput MeterValueInput;
 
+struct FilesystemAdapterC;
+typedef struct FilesystemAdapterC FilesystemAdapterC;
+
 typedef void (*OnMessage) (const char *payload, size_t len);
 typedef void (*OnAbort)   ();
 typedef void (*OnTimeout) ();
@@ -71,8 +75,18 @@ void ocpp_initialize_full(
             bool autoRecover, //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
             bool ocpp201); //true to select OCPP 2.0.1, false for OCPP 1.6
 
+//same as above, but pass FS handle instead of FS options
+void ocpp_initialize_full2(
+            OCPP_Connection *conn,  //WebSocket adapter for MicroOcpp
+            const char *bootNotificationCredentials, //e.g. '{"chargePointModel":"Demo Charger","chargePointVendor":"My Company Ltd."}' (refer to OCPP 1.6 Specification - Edition 2 p. 60)
+            FilesystemAdapterC *filesystem, //FilesystemAdapter handle initialized by client. MO takes ownership and deletes it during deinitialization
+            bool autoRecover, //automatically sanitize the local data store when the lib detects recurring crashes. During development, `false` is recommended
+            bool ocpp201); //true to select OCPP 2.0.1, false for OCPP 1.6
+
 void ocpp_deinitialize();
 
+bool ocpp_is_initialized();
+
 void ocpp_loop();
 
 /*
@@ -145,6 +159,9 @@ void ocpp_addErrorCodeInput_m(unsigned int connectorId, InputString_m errorCodeI
 void ocpp_addMeterValueInputFloat(InputFloat valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
 void ocpp_addMeterValueInputFloat_m(unsigned int connectorId, InputFloat_m valueInput, const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
 
+void ocpp_addMeterValueInputIntTx(int (*valueInput)(ReadingContext), const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
+void ocpp_addMeterValueInputIntTx_m(unsigned int connectorId, int (*valueInput)(unsigned int cId, ReadingContext), const char *measurand, const char *unit, const char *location, const char *phase); //measurand, unit, location and phase can be NULL
+
 void ocpp_addMeterValueInput(MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 void ocpp_addMeterValueInput_m(unsigned int connectorId, MeterValueInput *meterValueInput); //takes ownership of meterValueInput
 
@@ -184,20 +201,6 @@ void ocpp_setOnReceiveRequest(const char *operationType, OnMessage onRequest);
 
 void ocpp_setOnSendConf(const char *operationType, OnMessage onConfirmation);
 
-/*
- * If build flag MO_CUSTOM_CONSOLE is set, all console output will be forwarded to the print
- * function given by this setter. The parameter msg will also by null-terminated c-strings.
- */
-void ocpp_set_console_out_c(void (*console_out)(const char *msg));
-
-#ifdef MO_CUSTOM_RNG
-/**
- * If build flag MO_CUSTOM_RNG is set, calls to get random numbers shall be
- * forwarded to the function provided through this setter.
- */
-void ocpp_set_rng_c( uint32_t (*rng)(void));
-#endif
-
 /*
  * Send OCPP operations
  */

From bb88b167c9c0bd26c461252724a417c1c2796c2e Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 2 Feb 2025 19:53:01 +0100
Subject: [PATCH 540/549] Clean up PR (#400)

* update changelog
* fix CI/CD errors
---
 .github/workflows/documentation.yml | 2 +-
 .github/workflows/tests.yml         | 2 +-
 CHANGELOG.md                        | 4 ++++
 tests/Api.cpp                       | 2 ++
 tests/ChargingSessions.cpp          | 2 ++
 5 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index a861ed91..7fc6acd6 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -158,7 +158,7 @@ jobs:
       uses: actions/checkout@v3
       with:
         repository: google/bloaty
-        ref: 379d5305670c00c36a57e608079fd253f13bde63
+        ref: e1155149d54bb09b81e86f0e4e5cb7fbd2a318eb
         path: tools/bloaty
         submodules: recursive
     - name: Install bloaty
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index e086761f..3288a443 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -52,7 +52,7 @@ jobs:
       run: ./build/mo_unit_tests --abort
     - name: Create coverage report
       run: |
-        lcov --directory . --capture --output-file coverage.info
+        lcov --directory . --capture --output-file coverage.info --ignore-errors mismatch
         lcov --remove coverage.info '/usr/*' '*/tests/*' '*/ArduinoJson.h' --output-file coverage.info
         lcov --list coverage.info
     - name: Upload coverage reports to Codecov
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 588beea3..3b7759aa 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,17 +7,21 @@
 - Change `MicroOcpp::TxNotification` into C-style enum, replace `OCPP_TxNotication` ([#386](https://github.com/matth-x/MicroOcpp/pull/386))
 - Improved UUID generation ([#383](https://github.com/matth-x/MicroOcpp/pull/383))
 - `beginTransaction()` returns bool for better v2.0.1 interop ([#386](https://github.com/matth-x/MicroOcpp/pull/386))
+- Configurations C-API updates ([#400](https://github.com/matth-x/MicroOcpp/pull/400))
+- Platform integrations C-API upates ([#400](https://github.com/matth-x/MicroOcpp/pull/400))
 
 ### Added
 
 - `getTransactionV201()` exposes v201 Tx in API ([#386](https://github.com/matth-x/MicroOcpp/pull/386))
 - v201 support in Transaction.h C-API ([#386](https://github.com/matth-x/MicroOcpp/pull/386))
+- Write-only Configurations ([#400](https://github.com/matth-x/MicroOcpp/pull/400))
 
 ### Fixed
 
 - Timing issues for OCTT test cases ([#383](https://github.com/matth-x/MicroOcpp/pull/383))
 - Misleading Reset failure dbg msg ([#388](https://github.com/matth-x/MicroOcpp/pull/388))
 - Reject negative ints in ChangeConfig ([#388](https://github.com/matth-x/MicroOcpp/pull/388))
+- Revised SCons integration ([#400](https://github.com/matth-x/MicroOcpp/pull/400))
 
 ## [1.2.0] - 2024-11-03
 
diff --git a/tests/Api.cpp b/tests/Api.cpp
index 41f9f8a6..c2470172 100644
--- a/tests/Api.cpp
+++ b/tests/Api.cpp
@@ -13,6 +13,8 @@
 #include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
+#include <array>
+
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 #define SCPROFILE "[2,\"testmsg\",\"SetChargingProfile\",{\"connectorId\":0,\"csChargingProfiles\":{\"chargingProfileId\":0,\"stackLevel\":0,\"chargingProfilePurpose\":\"ChargePointMaxProfile\",\"chargingProfileKind\":\"Absolute\",\"chargingSchedule\":{\"duration\":1000000,\"startSchedule\":\"2023-01-01T00:00:00.000Z\",\"chargingRateUnit\":\"W\",\"chargingSchedulePeriod\":[{\"startPeriod\":0,\"limit\":16,\"numberPhases\":3}]}}}]"
 
diff --git a/tests/ChargingSessions.cpp b/tests/ChargingSessions.cpp
index 1ac9bdef..82090f16 100644
--- a/tests/ChargingSessions.cpp
+++ b/tests/ChargingSessions.cpp
@@ -16,6 +16,8 @@
 #include <catch2/catch.hpp>
 #include "./helpers/testHelper.h"
 
+#include <array>
+
 #define BASE_TIME "2023-01-01T00:00:00.000Z"
 
 using namespace MicroOcpp;

From c6440c08ec1988b20b516f54cffb56b69bad01ba Mon Sep 17 00:00:00 2001
From: Dave Smith <dsmith@emporiaenergy.com>
Date: Tue, 4 Mar 2025 11:17:10 -0700
Subject: [PATCH 541/549] Add ESP_LOG support.

Update the platform logging to use the ESP_LOGx macros when MO_PLATFORM
is set to MO_PLATFORM_ESPIDF.
---
 src/MicroOcpp/Platform.h | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index a3da99ea..bf1582e8 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -69,7 +69,11 @@ MO_EXTERN_C void mocpp_set_console_out(void (*console_out)(const char *msg));
 #endif
 
 #define MO_CONSOLE_PRINTF(X, ...) MO_USE_SERIAL.printf_P(PSTR(X), ##__VA_ARGS__)
-#elif MO_PLATFORM == MO_PLATFORM_ESPIDF || MO_PLATFORM == MO_PLATFORM_UNIX
+#elif MO_PLATFORM == MO_PLATFORM_ESPIDF
+#include "esp_log.h"
+
+#define MO_CONSOLE_PRINTF(X, ...) ESP_LOGI("MicroOcpp", X, ##__VA_ARGS__)
+#elif MO_PLATFORM == MO_PLATFORM_UNIX
 #include <stdio.h>
 
 #define MO_CONSOLE_PRINTF(X, ...) printf(X, ##__VA_ARGS__)

From 9e96596547ac1d8d95d09d1d36b957ca3a32cc05 Mon Sep 17 00:00:00 2001
From: Razvan Grigore <razvan.grigore@vampirebyte.ro>
Date: Mon, 15 Sep 2025 20:12:18 +0300
Subject: [PATCH 542/549] Fix DiagnosticsService upload filesystem files bigger
 than chunk size

---
 .../Model/Diagnostics/DiagnosticsService.cpp    | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
index 6257ad57..94bd9609 100644
--- a/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
+++ b/src/MicroOcpp/Model/Diagnostics/DiagnosticsService.cpp
@@ -269,14 +269,17 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
         }
         diagPostambleLen = 0;
         diagPostambleTransferred = 0;
+        diagFilesBackTransferred = 0;
 
         auto& model = context.getModel();
 
+        auto cpVendor = makeString(getMemoryTag());
         auto cpModel = makeString(getMemoryTag());
         auto fwVersion = makeString(getMemoryTag());
 
         if (auto bootService = model.getBootService()) {
             if (auto cpCreds = bootService->getChargePointCredentials()) {
+                cpVendor = (*cpCreds)["chargePointVendor"] | "Vendor";
                 cpModel = (*cpCreds)["chargePointModel"] | "Charger";
                 fwVersion = (*cpCreds)["firmwareVersion"] | "";
             }
@@ -288,7 +291,8 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
         int ret;
 
         ret = snprintf(diagPreamble, diagPreambleSize,
-                "### %s Hardware Diagnostics%s%s\n%s\n",
+                "### %s %s - Hardware Diagnostics%s%s\n%s\n",
+                cpVendor.c_str(),
                 cpModel.c_str(),
                 fwVersion.empty() ? "" : " - v. ", fwVersion.c_str(),
                 jsonDate);
@@ -418,6 +422,8 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
                     if (ret < 0 || (size_t)ret >= sizeof(fpath)) {
                         MO_DBG_ERR("fn error: %i", ret);
                         diagFileList.pop_back();
+                        // next file starts from offset 0
+                        diagFilesBackTransferred = 0;
                         continue;
                     }
 
@@ -429,6 +435,7 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
                             if (writeLen < 0 || (size_t)writeLen >= sizeof(fileHeading)) {
                                 MO_DBG_ERR("fn error: %i", ret);
                                 diagFileList.pop_back();
+                                diagFilesBackTransferred = 0;
                                 continue;
                             }
                             if (writeLen + written > size || //heading doesn't fit anymore, return with a bit unused buffer space and print heading the next time
@@ -444,14 +451,19 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
 
                         file->seek(diagFilesBackTransferred);
                         size_t writeLen = file->read((char*)buf + written, size - written);
-
+                        // advance per-file offset
+                        diagFilesBackTransferred += writeLen;
                         if (writeLen < size - written) {
+                            // EOF for this file; move to next and reset offset
+                            MO_DBG_DEBUG("upload diag chunk %zu (done)", diagFilesBackTransferred);
                             diagFileList.pop_back();
+                            diagFilesBackTransferred = 0;
                         }
                         written += writeLen;
                     } else {
                         MO_DBG_ERR("could not open file: %s", fpath);
                         diagFileList.pop_back();
+                        diagFilesBackTransferred = 0;
                     }
                 }
 
@@ -470,6 +482,7 @@ void DiagnosticsService::setDiagnosticsReader(std::function<size_t(char *buf, si
                 MO_FREE(diagPreamble);
                 MO_FREE(diagPostamble);
                 diagFileList.clear();
+                diagFilesBackTransferred = 0; //reset offset for future uploads
 
                 if (onClose) {
                     onClose();

From ecdb0b42c04fe537c85bc165ca3ea01554ff442e Mon Sep 17 00:00:00 2001
From: Razvan Grigore <razvan.grigore@vampirebyte.ro>
Date: Sun, 19 Oct 2025 09:14:13 +0300
Subject: [PATCH 543/549] connectorId SHALL be > 0 in RemoteStartTransaction
 (TC_027_CS)

---
 .github/workflows/tests.yml                   |   2 +-
 .gitignore                                    |   1 +
 CMakeLists.txt                                |   1 +
 .../Operations/RemoteStartTransaction.cpp     |   7 +
 tests/RemoteStartTransaction.cpp              | 168 ++++++++++++++++++
 5 files changed, 178 insertions(+), 1 deletion(-)
 create mode 100644 tests/RemoteStartTransaction.cpp

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 3288a443..38b1d04e 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -23,7 +23,7 @@ jobs:
       uses: actions/checkout@v3
       with:
         repository: Mbed-TLS/mbedtls
-        ref: v2.28.1
+        ref: v2.28.10
         path: lib/mbedtls
     - name: Get build tools
       run: |
diff --git a/.gitignore b/.gitignore
index e04a3bf0..d47070b1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
 .pio
+.vscode
 build
 lib
 mo_store
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 963c1d8b..bf1d5f7a 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -150,6 +150,7 @@ set(MO_SRC_UNIT
     tests/LocalAuthList.cpp
     tests/Variables.cpp
     tests/Transactions.cpp
+    tests/RemoteStartTransaction.cpp
     tests/Certificates.cpp
     tests/FirmwareManagement.cpp
     tests/ChargePointError.cpp
diff --git a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
index 77314f36..977f675d 100644
--- a/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
+++ b/src/MicroOcpp/Operations/RemoteStartTransaction.cpp
@@ -25,6 +25,13 @@ const char* RemoteStartTransaction::getOperationType() {
 void RemoteStartTransaction::processReq(JsonObject payload) {
     int connectorId = payload["connectorId"] | -1;
 
+    // OCPP 1.6 specification: connectorId SHALL be > 0 (TC_027_CS)
+    if (connectorId == 0) {
+        MO_DBG_INFO("RemoteStartTransaction rejected: connectorId SHALL not be 0");
+        accepted = false;
+        return;
+    }
+
     if (!payload.containsKey("idTag")) {
         errorCode = "FormationViolation";
         return;
diff --git a/tests/RemoteStartTransaction.cpp b/tests/RemoteStartTransaction.cpp
new file mode 100644
index 00000000..5d21ec08
--- /dev/null
+++ b/tests/RemoteStartTransaction.cpp
@@ -0,0 +1,168 @@
+// matth-x/MicroOcpp
+// Copyright Matthias Akstaller 2019 - 2024
+// MIT License
+
+#include <MicroOcpp.h>
+#include <MicroOcpp/Core/Connection.h>
+#include <MicroOcpp/Core/Context.h>
+#include <MicroOcpp/Core/Request.h>
+#include <MicroOcpp/Core/Configuration.h>
+#include <MicroOcpp/Core/OperationRegistry.h>
+#include <MicroOcpp/Operations/CustomOperation.h>
+#include <MicroOcpp/Model/Model.h>
+#include <MicroOcpp/Model/ConnectorBase/Connector.h>
+#include <MicroOcpp/Operations/RemoteStartTransaction.h>
+#include <MicroOcpp/Debug.h>
+#include <catch2/catch.hpp>
+#include "./helpers/testHelper.h"
+
+using namespace MicroOcpp;
+
+TEST_CASE("RemoteStartTransaction") {
+    printf("\nRun %s\n", "RemoteStartTransaction");
+
+    LoopbackConnection loopback;
+    mocpp_initialize(loopback, ChargerCredentials("test-runner1234"));
+    mocpp_set_timer(custom_timer_cb);
+    loop();
+
+    auto context = getOcppContext();
+    auto connector = context->getModel().getConnector(1);
+
+    SECTION("Basic remote start accepted") {
+        // Ensure connector idle
+        REQUIRE(connector->getStatus() == ChargePointStatus_Available);
+
+        context->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+            "RemoteStartTransaction",
+            [] () {
+                auto doc = makeJsonDoc(UNIT_MEM_TAG, JSON_OBJECT_SIZE(2));
+                auto payload = doc->to<JsonObject>();
+                payload["idTag"] = "mIdTag";
+                return doc;},
+            [] (JsonObject) {}
+        )));
+
+        loop();
+        REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
+        endTransaction();
+        loop();
+        REQUIRE(connector->getStatus() == ChargePointStatus_Available);
+    }
+
+    SECTION("Same connectorId rejected when transaction active") {
+        // Start with connector 1 busy so remote start with connectorId=1 should not auto-assign
+        beginTransaction("anotherId");
+        loop();
+        REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
+
+        bool checkProcessed = false;
+
+        context->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+            "RemoteStartTransaction",
+            [] () {
+                auto doc = makeJsonDoc(UNIT_MEM_TAG, JSON_OBJECT_SIZE(3));
+                auto payload = doc->to<JsonObject>();
+                payload["idTag"] = "mIdTag";
+                payload["connectorId"] = 1; // the same connector already in use
+                return doc;},
+            [&checkProcessed] (JsonObject response) {
+                checkProcessed = true;
+                REQUIRE( !strcmp(response["status"] | "_Undefined", "Rejected") );
+            }
+        )));
+
+        loop();
+
+        // Transaction should still be the original one only
+        REQUIRE(checkProcessed);
+        REQUIRE(connector->getTransaction());
+        REQUIRE(strcmp(connector->getTransaction()->getIdTag(), "anotherId") == 0);
+        REQUIRE(connector->getStatus() == ChargePointStatus_Charging);
+
+        endTransaction();
+        loop();
+        REQUIRE(connector->getStatus() == ChargePointStatus_Available);
+    }
+
+    SECTION("ConnectorId 0 rejected per spec") {
+        // RemoteStartTransaction response status is Rejected when connectorId == 0
+        REQUIRE(connector->getStatus() == ChargePointStatus_Available);
+
+        bool checkProcessed = false;
+
+        context->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+            "RemoteStartTransaction",
+            [] () {
+                auto doc = makeJsonDoc(UNIT_MEM_TAG, JSON_OBJECT_SIZE(3));
+                auto payload = doc->to<JsonObject>();
+                payload["idTag"] = "mIdTag";
+                payload["connectorId"] = 0; // invalid per spec
+                return doc;},
+            [&checkProcessed] (JsonObject response) {
+                checkProcessed = true;
+                REQUIRE( !strcmp(response["status"] | "_Undefined", "Rejected") );
+            }
+        )));
+
+        loop();
+
+        REQUIRE(checkProcessed);
+        REQUIRE(connector->getStatus() == ChargePointStatus_Available);
+    }
+
+    SECTION("No free connector so rejected") {
+        // Occupy all connectors (limit defined by MO_NUMCONNECTORS)
+        for (unsigned cId = 1; cId < context->getModel().getNumConnectors(); cId++) {
+            auto c = context->getModel().getConnector(cId);
+            if (c) {
+                c->beginTransaction_authorized("busyId");
+            }
+        }
+        loop();
+
+        bool checkProcessed = false;
+        auto freeFound = false;
+        for (unsigned cId = 1; cId < context->getModel().getNumConnectors(); cId++) {
+            auto c = context->getModel().getConnector(cId);
+            if (c && !c->getTransaction()) freeFound = true;
+        }
+        REQUIRE(!freeFound); // ensure all are busy
+
+        context->initiateRequest(makeRequest(new Ocpp16::CustomOperation(
+            "RemoteStartTransaction",
+            [] () {
+                auto doc = makeJsonDoc(UNIT_MEM_TAG, JSON_OBJECT_SIZE(2));
+                auto payload = doc->to<JsonObject>();
+                payload["idTag"] = "mIdTag";
+                return doc;},
+            [&checkProcessed] (JsonObject response) {
+                checkProcessed = true;
+                REQUIRE( !strcmp(response["status"] | "_Undefined", "Rejected") );
+            }
+        )));
+
+        loop();
+        REQUIRE(checkProcessed);
+
+        // No new transaction should be created; keep statuses
+        int activeTx = 0;
+        for (unsigned cId = 1; cId < context->getModel().getNumConnectors(); cId++) {
+            auto c = context->getModel().getConnector(cId);
+            if (c && c->getTransaction()) activeTx++;
+        }
+        REQUIRE(activeTx == (int)context->getModel().getNumConnectors() - 1); // all occupied
+
+        // cleanup
+        for (unsigned cId = 1; cId < context->getModel().getNumConnectors(); cId++) {
+            auto c = context->getModel().getConnector(cId);
+            if (c && c->getTransaction()) {
+                c->endTransaction();
+            }
+        }
+        loop();
+        REQUIRE(connector->getStatus() == ChargePointStatus_Available);
+    }
+
+    mocpp_deinitialize();
+}

From de480fa53a7b84436a5a4bfa3b92ba56e531fa19 Mon Sep 17 00:00:00 2001
From: Razvan Grigore <razvan.grigore@vampirebyte.ro>
Date: Thu, 23 Oct 2025 17:33:34 +0300
Subject: [PATCH 544/549] fix TC_042_1_CS and TC_043_1_CS / local auth list not
 supported

---
 .../Model/Authorization/AuthorizationService.cpp          | 8 ++++++--
 src/MicroOcpp/Model/Authorization/AuthorizationService.h  | 1 +
 src/MicroOcpp/Model/Model.cpp                             | 2 +-
 src/MicroOcpp/Operations/GetLocalListVersion.cpp          | 4 +++-
 src/MicroOcpp/Operations/SendLocalList.cpp                | 6 ++++++
 5 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index e9dc39d2..443f0138 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -75,7 +75,7 @@ bool AuthorizationService::loadLists() {
 }
 
 AuthorizationData *AuthorizationService::getLocalAuthorization(const char *idTag) {
-    if (!localAuthListEnabledBool->getBool()) {
+    if (!localAuthListEnabled()) {
         return nullptr; //auth cache will follow
     }
 
@@ -101,6 +101,10 @@ size_t AuthorizationService::getLocalListSize() {
     return localAuthorizationList.size();
 }
 
+bool AuthorizationService::localAuthListEnabled() const {
+    return localAuthListEnabledBool && localAuthListEnabledBool->getBool();
+}
+
 bool AuthorizationService::updateLocalList(JsonArray localAuthorizationListJson, int listVersion, bool differential) {
     bool success = localAuthorizationList.readJson(localAuthorizationListJson, listVersion, differential, false);
 
@@ -127,7 +131,7 @@ bool AuthorizationService::updateLocalList(JsonArray localAuthorizationListJson,
 void AuthorizationService::notifyAuthorization(const char *idTag, JsonObject idTagInfo) {
     //check local list conflicts. In future: also update authorization cache
 
-    if (!localAuthListEnabledBool->getBool()) {
+    if (!localAuthListEnabled()) {
         return; //auth cache will follow
     }
 
diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.h b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
index 88ba7936..536bba1f 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.h
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.h
@@ -35,6 +35,7 @@ class AuthorizationService : public MemoryManaged {
     AuthorizationData *getLocalAuthorization(const char *idTag);
 
     int getLocalListVersion();
+    bool localAuthListEnabled() const;
     size_t getLocalListSize(); //number of entries in current localAuthList; used in unit tests
 
     bool updateLocalList(JsonArray localAuthorizationListJson, int listVersion, bool differential);
diff --git a/src/MicroOcpp/Model/Model.cpp b/src/MicroOcpp/Model/Model.cpp
index f2e19c1e..fe59568f 100644
--- a/src/MicroOcpp/Model/Model.cpp
+++ b/src/MicroOcpp/Model/Model.cpp
@@ -317,7 +317,7 @@ void Model::updateSupportedStandardProfiles() {
     }
 
 #if MO_ENABLE_LOCAL_AUTH
-    if (authorizationService) {
+    if (authorizationService && authorizationService->localAuthListEnabled()) {
         if (!strstr(supportedFeatureProfilesString->getString(), "LocalAuthListManagement")) {
             if (!buf.empty()) buf += ',';
             buf += "LocalAuthListManagement";
diff --git a/src/MicroOcpp/Operations/GetLocalListVersion.cpp b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
index f2c8a058..4c2d4688 100644
--- a/src/MicroOcpp/Operations/GetLocalListVersion.cpp
+++ b/src/MicroOcpp/Operations/GetLocalListVersion.cpp
@@ -30,9 +30,11 @@ std::unique_ptr<JsonDoc> GetLocalListVersion::createConf(){
     auto doc = makeJsonDoc(getMemoryTag(), JSON_OBJECT_SIZE(1));
     JsonObject payload = doc->to<JsonObject>();
 
-    if (auto authService = model.getAuthorizationService()) {
+    auto authService = model.getAuthorizationService();
+    if (authService && authService->localAuthListEnabled()) {
         payload["listVersion"] = authService->getLocalListVersion();
     } else {
+        //TC_042_1_CS Get Local List Version (not supported)
         payload["listVersion"] = -1;
     }
     return doc;
diff --git a/src/MicroOcpp/Operations/SendLocalList.cpp b/src/MicroOcpp/Operations/SendLocalList.cpp
index 45f0dfbe..29890024 100644
--- a/src/MicroOcpp/Operations/SendLocalList.cpp
+++ b/src/MicroOcpp/Operations/SendLocalList.cpp
@@ -27,6 +27,12 @@ const char* SendLocalList::getOperationType(){
 
 void SendLocalList::processReq(JsonObject payload) {
 
+    //TC_043_1_CS Send Local Authorization List - NotSupported
+    if (!authService.localAuthListEnabled()) {
+        errorCode = "NotSupported";
+        return;
+    }
+
     if (!payload.containsKey("listVersion") || !payload.containsKey("updateType")) {
         errorCode = "FormationViolation";
         return;

From 6259fe30d49c7c3bf52354bf3d7a55cbf2c6bd95 Mon Sep 17 00:00:00 2001
From: matth-x <63792403+matth-x@users.noreply.github.com>
Date: Sun, 26 Oct 2025 13:59:08 +0100
Subject: [PATCH 545/549] Update README.md

---
 README.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9434aec7..de09d875 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,14 @@ OCPP 1.6 / 2.0.1 client for microcontrollers. Portable C/C++. Compatible with Es
 
 Reference usage: [OpenEVSE](https://github.com/OpenEVSE/ESP32_WiFi_V4.x/blob/master/src/ocpp.cpp) | Technical introduction: [Docs](https://matth-x.github.io/MicroOcpp/intro-tech) | Website: [www.micro-ocpp.com](https://www.micro-ocpp.com)
 
+## AI-friendly code
+
+AI models perform extremely well with the MicroOCPP codebase. The upcoming new release of MO (v2.0) will further optimize the code for more reliable results with AI models (preview to be found in the `develop/remodel-api` branch). The hope is to allow integrating MO into an existing EV charger project with only a few queries.
+
+Currently, the `develop/remodel-api` branch is not stable yet, but recommended for new developments. To get started, load `MicroOcpp.h` (now unified for C and C++) into the context window and ask what the AI model needs to know to integrate it into your codebase.
+
+If your tools have issues with something in MicroOCPP, please open an issue on GitHub. Any feedback on how to further optimize the codebase is also highly appreciated.
+
 ## Tester / Demo App
 
 *Main repository: [MicroOcppSimulator](https://github.com/matth-x/MicroOcppSimulator)*
@@ -97,6 +105,6 @@ ISO 15118 defines some use cases which include a message exchange between the ch
 
 ## Contact
 
-If you have further questions, feel free to reach out!
+If you have any questions, or found a potential bug, feel free to open an issue. This type of interaction is highly appreciated, because it shows problems in the codebase and helps improve the project for clarity. For further questions which shouldn't stand in public, you can reach me via LinkedIn or the following email address:
 
 :envelope: : matthias [A⊤] micro-ocpp [DО⊤] com

From 36ce12b846aa224a35334768d3684377d4556282 Mon Sep 17 00:00:00 2001
From: Razvan Grigore <razvan.grigore@vampirebyte.ro>
Date: Sun, 9 Nov 2025 18:01:52 +0200
Subject: [PATCH 546/549] add hint on how to pass TC_043_3_CS-Send Local
 Authorization List - Failed

---
 src/MicroOcpp/Model/Authorization/AuthorizationService.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 443f0138..86692dee 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -106,6 +106,9 @@ bool AuthorizationService::localAuthListEnabled() const {
 }
 
 bool AuthorizationService::updateLocalList(JsonArray localAuthorizationListJson, int listVersion, bool differential) {
+    //TC_043_3_CS-Send Local Authorization List - Failed
+    //return false;
+
     bool success = localAuthorizationList.readJson(localAuthorizationListJson, listVersion, differential, false);
 
     if (success) {

From 3af8343192edaa3af0509ff6fd3f16daca3bbe83 Mon Sep 17 00:00:00 2001
From: Razvan Grigore <razvan.grigore@vampirebyte.ro>
Date: Sun, 9 Nov 2025 18:10:47 +0200
Subject: [PATCH 547/549] Fix Actions / Error: This request has been
 automatically failed because it uses a deprecated version of `actions/cache:
 v2`

Please update your workflow to use v3/v4 of actions/cache to avoid interruptions. Learn more: https://github.blog/changelog/2024-12-05-notice-of-upcoming-releases-and-breaking-changes-for-github-actions/#actions-cache-v1-v2-and-actions-toolkit-cache-package-closing-down
---
 .github/workflows/documentation.yml | 10 +++++-----
 .github/workflows/pio.yml           |  8 ++++----
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 7fc6acd6..9d23daeb 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -21,7 +21,7 @@ jobs:
     - uses: actions/setup-python@v4
       with:
         python-version: 3.x
-    - uses: actions/cache@v2
+    - uses: actions/cache@v4
       with:
         key: ${{ github.ref }}
         path: .cache
@@ -101,14 +101,14 @@ jobs:
     steps:
     - uses: actions/checkout@v3
     - name: Cache pip
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.cache/pip
         key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
         restore-keys: |
           ${{ runner.os }}-pip-
     - name: Cache PlatformIO
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.platformio
         key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }}
@@ -142,7 +142,7 @@ jobs:
     - uses: actions/setup-python@v4
       with:
         python-version: 3.x
-    - uses: actions/cache@v2
+    - uses: actions/cache@v4
       with:
         key: ${{ github.ref }}
         path: .cache
@@ -194,7 +194,7 @@ jobs:
     - uses: actions/setup-python@v4
       with:
         python-version: 3.x
-    - uses: actions/cache@v2
+    - uses: actions/cache@v4
       with:
         key: ${{ github.ref }}
         path: .cache
diff --git a/.github/workflows/pio.yml b/.github/workflows/pio.yml
index ec777853..189351fd 100644
--- a/.github/workflows/pio.yml
+++ b/.github/workflows/pio.yml
@@ -20,21 +20,21 @@ jobs:
         example: [examples/ESP/main.cpp, examples/ESP-TLS/main.cpp]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
     - name: Cache pip
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.cache/pip
         key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
         restore-keys: |
           ${{ runner.os }}-pip-
     - name: Cache PlatformIO
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.platformio
         key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }}
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
     - name: Install PlatformIO
       run: |
         python -m pip install --upgrade pip

From 9a4f1da1759f9c9782ec220c600ed74e372a93fd Mon Sep 17 00:00:00 2001
From: Razvan Grigore <razvan.grigore@vampirebyte.ro>
Date: Tue, 11 Nov 2025 16:59:43 +0200
Subject: [PATCH 548/549] mark LocalAuthListEnabled configuration as
 rebootRequired

---
 src/MicroOcpp/Model/Authorization/AuthorizationService.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
index 86692dee..dc395ff9 100644
--- a/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
+++ b/src/MicroOcpp/Model/Authorization/AuthorizationService.cpp
@@ -24,7 +24,7 @@ using namespace MicroOcpp;
 
 AuthorizationService::AuthorizationService(Context& context, std::shared_ptr<FilesystemAdapter> filesystem) : MemoryManaged("v16.Authorization.AuthorizationService"), context(context), filesystem(filesystem) {
 
-    localAuthListEnabledBool = declareConfiguration<bool>("LocalAuthListEnabled", true);
+    localAuthListEnabledBool = declareConfiguration<bool>("LocalAuthListEnabled", true, CONFIGURATION_FN, false, true);
     declareConfiguration<int>("LocalAuthListMaxLength", MO_LocalAuthListMaxLength, CONFIGURATION_VOLATILE, true);
     declareConfiguration<int>("SendLocalListMaxLength", MO_SendLocalListMaxLength, CONFIGURATION_VOLATILE, true);
 

From a30629e0bb4e9ec894ea356becf5020d8c9918db Mon Sep 17 00:00:00 2001
From: Dave Smith <dsmith@emporiaenergy.com>
Date: Tue, 2 Dec 2025 16:57:43 -0700
Subject: [PATCH 549/549] Replace macro with esp_log_write.

Replace the ESP_LOG macro with esp_log_write, which is a better
replacement for printf style logging.
---
 src/MicroOcpp/Platform.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MicroOcpp/Platform.h b/src/MicroOcpp/Platform.h
index bf1582e8..e5b8de09 100644
--- a/src/MicroOcpp/Platform.h
+++ b/src/MicroOcpp/Platform.h
@@ -72,7 +72,7 @@ MO_EXTERN_C void mocpp_set_console_out(void (*console_out)(const char *msg));
 #elif MO_PLATFORM == MO_PLATFORM_ESPIDF
 #include "esp_log.h"
 
-#define MO_CONSOLE_PRINTF(X, ...) ESP_LOGI("MicroOcpp", X, ##__VA_ARGS__)
+#define MO_CONSOLE_PRINTF(X, ...) esp_log_write(ESP_LOG_INFO, "MicroOcpp", X, ##__VA_ARGS__)
 #elif MO_PLATFORM == MO_PLATFORM_UNIX
 #include <stdio.h>