Add extracted tools: CitrineOS, OpenOCPP, ShapeShifter

- CitrineOS core extracted (CSMS OCPP 2.0.1)
- OpenOCPP extracted (firmware OCPP 1.6J/2.0.1)
- ShapeShifter library installed (pip install -e)
- ShapeShifter specification extracted
- EVerest extracted

TODO updated with progress

tools/EVerest-main/modules/HardwareDrivers/EVSE/MicroMegaWattBSP/umwc_comms/protobuf/generate_nanopb.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+nanopb_generator.py -L "#include <everest/3rd_party/nanopb/%s>" -I . -D . umwc.proto

tools/EVerest-main/modules/HardwareDrivers/EVSE/MicroMegaWattBSP/umwc_comms/protobuf/umwc.options

@@ -0,0 +1,2 @@
+KeepAlive.sw_version_string max_length:50
+KeepAliveLo.sw_version_string max_length:50

tools/EVerest-main/modules/HardwareDrivers/EVSE/MicroMegaWattBSP/umwc_comms/protobuf/umwc.pb.c

@@ -0,0 +1,35 @@
+/* Automatically generated nanopb constant definitions */
+/* Generated by nanopb-0.4.8 */
+
+#include "umwc.pb.h"
+#if PB_PROTO_HEADER_VERSION != 40
+#error Regenerate this file with the current version of nanopb generator.
+#endif
+
+PB_BIND(EverestToMcu, EverestToMcu, 2)
+
+
+PB_BIND(McuToEverest, McuToEverest, 2)
+
+
+PB_BIND(SetOutputVoltageCurrent, SetOutputVoltageCurrent, AUTO)
+
+
+PB_BIND(ErrorFlags, ErrorFlags, AUTO)
+
+
+PB_BIND(KeepAliveLo, KeepAliveLo, AUTO)
+
+
+PB_BIND(KeepAlive, KeepAlive, AUTO)
+
+
+PB_BIND(Telemetry, Telemetry, AUTO)
+
+
+PB_BIND(FirmwareUpdate, FirmwareUpdate, AUTO)
+
+
+
+
+

tools/EVerest-main/modules/HardwareDrivers/EVSE/MicroMegaWattBSP/umwc_comms/protobuf/umwc.pb.h

@@ -0,0 +1,299 @@
+/* Automatically generated nanopb header */
+/* Generated by nanopb-0.4.8 */
+
+#ifndef PB_UMWC_PB_H_INCLUDED
+#define PB_UMWC_PB_H_INCLUDED
+#include <everest/3rd_party/nanopb/pb.h>
+
+#if PB_PROTO_HEADER_VERSION != 40
+#error Regenerate this file with the current version of nanopb generator.
+#endif
+
+/* Enum definitions */
+typedef enum _CpState {
+    CpState_STATE_A = 0,
+    CpState_STATE_B = 1,
+    CpState_STATE_C = 2,
+    CpState_STATE_D = 3,
+    CpState_STATE_E = 4,
+    CpState_STATE_F = 5
+} CpState;
+
+typedef enum _ResetReason {
+    ResetReason_USER = 0,
+    ResetReason_WATCHDOG = 1
+} ResetReason;
+
+/* Struct definitions */
+typedef struct _SetOutputVoltageCurrent {
+    float voltage;
+    float current;
+} SetOutputVoltageCurrent;
+
+typedef struct _ErrorFlags {
+    bool diode_fault;
+    bool cp_signal_fault;
+} ErrorFlags;
+
+typedef struct _KeepAliveLo {
+    uint32_t time_stamp;
+    uint32_t hw_type;
+    uint32_t hw_revision;
+    uint32_t protocol_version_major;
+    uint32_t protocol_version_minor;
+    char sw_version_string[51];
+    float hwcap_max_current;
+    float hwcap_min_current;
+    uint32_t hwcap_max_phase_count;
+    uint32_t hwcap_min_phase_count;
+    bool supports_changing_phases_during_charging;
+} KeepAliveLo;
+
+typedef struct _KeepAlive {
+    uint32_t time_stamp;
+    uint32_t hw_type;
+    uint32_t hw_revision;
+    char sw_version_string[51];
+} KeepAlive;
+
+typedef struct _Telemetry {
+    float cp_hi;
+    float cp_lo;
+    float pwm_dc;
+    float relais_on;
+    float voltage;
+} Telemetry;
+
+/* This container message is send from MCU to EVerest and may contain any allowed message in that direction. */
+typedef struct _McuToEverest {
+    pb_size_t which_payload;
+    union {
+        /* Needs to remain the same to allow firmware updates of older versions */
+        KeepAliveLo keep_alive;
+        /* Other IDs are 100+ to avoid compatibility issues with older firmware versions */
+        ResetReason reset;
+        CpState cp_state;
+        bool relais_state; /* false: relais are off, true: relais are on */
+        ErrorFlags error_flags;
+        Telemetry telemetry;
+    } payload;
+} McuToEverest;
+
+typedef struct _FirmwareUpdate {
+    bool invoke_rom_bootloader;
+} FirmwareUpdate;
+
+/* This container message is send from EVerest to MCU and may contain any allowed message in that direction. */
+typedef struct _EverestToMcu {
+    pb_size_t which_payload;
+    union {
+        /* Needs to remain the same to allow firmware updates of older versions */
+        FirmwareUpdate firmware_update;
+        SetOutputVoltageCurrent set_output_voltage_current;
+        /* Other IDs are 100+ to avoid compatibility issues with older firmware versions */
+        KeepAlive keep_alive;
+        uint32_t pwm_duty_cycle; /* in 0.01 %, 0 = State F, 10000 = X1 */
+        bool allow_power_on;
+        bool reset;
+        bool enable;
+        bool replug;
+    } payload;
+} EverestToMcu;
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Helper constants for enums */
+#define _CpState_MIN CpState_STATE_A
+#define _CpState_MAX CpState_STATE_F
+#define _CpState_ARRAYSIZE ((CpState)(CpState_STATE_F+1))
+
+#define _ResetReason_MIN ResetReason_USER
+#define _ResetReason_MAX ResetReason_WATCHDOG
+#define _ResetReason_ARRAYSIZE ((ResetReason)(ResetReason_WATCHDOG+1))
+
+
+#define McuToEverest_payload_reset_ENUMTYPE ResetReason
+#define McuToEverest_payload_cp_state_ENUMTYPE CpState
+
+
+
+
+
+
+
+
+/* Initializer values for message structs */
+#define EverestToMcu_init_default                {0, {FirmwareUpdate_init_default}}
+#define McuToEverest_init_default                {0, {KeepAliveLo_init_default}}
+#define SetOutputVoltageCurrent_init_default     {0, 0}
+#define ErrorFlags_init_default                  {0, 0}
+#define KeepAliveLo_init_default                 {0, 0, 0, 0, 0, "", 0, 0, 0, 0, 0}
+#define KeepAlive_init_default                   {0, 0, 0, ""}
+#define Telemetry_init_default                   {0, 0, 0, 0, 0}
+#define FirmwareUpdate_init_default              {0}
+#define EverestToMcu_init_zero                   {0, {FirmwareUpdate_init_zero}}
+#define McuToEverest_init_zero                   {0, {KeepAliveLo_init_zero}}
+#define SetOutputVoltageCurrent_init_zero        {0, 0}
+#define ErrorFlags_init_zero                     {0, 0}
+#define KeepAliveLo_init_zero                    {0, 0, 0, 0, 0, "", 0, 0, 0, 0, 0}
+#define KeepAlive_init_zero                      {0, 0, 0, ""}
+#define Telemetry_init_zero                      {0, 0, 0, 0, 0}
+#define FirmwareUpdate_init_zero                 {0}
+
+/* Field tags (for use in manual encoding/decoding) */
+#define SetOutputVoltageCurrent_voltage_tag      1
+#define SetOutputVoltageCurrent_current_tag      2
+#define ErrorFlags_diode_fault_tag               1
+#define ErrorFlags_cp_signal_fault_tag           6
+#define KeepAliveLo_time_stamp_tag               1
+#define KeepAliveLo_hw_type_tag                  2
+#define KeepAliveLo_hw_revision_tag              3
+#define KeepAliveLo_protocol_version_major_tag   4
+#define KeepAliveLo_protocol_version_minor_tag   5
+#define KeepAliveLo_sw_version_string_tag        6
+#define KeepAliveLo_hwcap_max_current_tag        7
+#define KeepAliveLo_hwcap_min_current_tag        8
+#define KeepAliveLo_hwcap_max_phase_count_tag    9
+#define KeepAliveLo_hwcap_min_phase_count_tag    10
+#define KeepAliveLo_supports_changing_phases_during_charging_tag 11
+#define KeepAlive_time_stamp_tag                 1
+#define KeepAlive_hw_type_tag                    2
+#define KeepAlive_hw_revision_tag                3
+#define KeepAlive_sw_version_string_tag          6
+#define Telemetry_cp_hi_tag                      1
+#define Telemetry_cp_lo_tag                      2
+#define Telemetry_pwm_dc_tag                     3
+#define Telemetry_relais_on_tag                  4
+#define Telemetry_voltage_tag                    5
+#define McuToEverest_keep_alive_tag              3
+#define McuToEverest_reset_tag                   101
+#define McuToEverest_cp_state_tag                102
+#define McuToEverest_relais_state_tag            103
+#define McuToEverest_error_flags_tag             104
+#define McuToEverest_telemetry_tag               105
+#define FirmwareUpdate_invoke_rom_bootloader_tag 1
+#define EverestToMcu_firmware_update_tag         16
+#define EverestToMcu_set_output_voltage_current_tag 50
+#define EverestToMcu_keep_alive_tag              100
+#define EverestToMcu_pwm_duty_cycle_tag          103
+#define EverestToMcu_allow_power_on_tag          104
+#define EverestToMcu_reset_tag                   105
+#define EverestToMcu_enable_tag                  106
+#define EverestToMcu_replug_tag                  107
+
+/* Struct field encoding specification for nanopb */
+#define EverestToMcu_FIELDLIST(X, a) \
+X(a, STATIC,   ONEOF,    MESSAGE,  (payload,firmware_update,payload.firmware_update),  16) \
+X(a, STATIC,   ONEOF,    MESSAGE,  (payload,set_output_voltage_current,payload.set_output_voltage_current),  50) \
+X(a, STATIC,   ONEOF,    MESSAGE,  (payload,keep_alive,payload.keep_alive), 100) \
+X(a, STATIC,   ONEOF,    UINT32,   (payload,pwm_duty_cycle,payload.pwm_duty_cycle), 103) \
+X(a, STATIC,   ONEOF,    BOOL,     (payload,allow_power_on,payload.allow_power_on), 104) \
+X(a, STATIC,   ONEOF,    BOOL,     (payload,reset,payload.reset), 105) \
+X(a, STATIC,   ONEOF,    BOOL,     (payload,enable,payload.enable), 106) \
+X(a, STATIC,   ONEOF,    BOOL,     (payload,replug,payload.replug), 107)
+#define EverestToMcu_CALLBACK NULL
+#define EverestToMcu_DEFAULT NULL
+#define EverestToMcu_payload_firmware_update_MSGTYPE FirmwareUpdate
+#define EverestToMcu_payload_set_output_voltage_current_MSGTYPE SetOutputVoltageCurrent
+#define EverestToMcu_payload_keep_alive_MSGTYPE KeepAlive
+
+#define McuToEverest_FIELDLIST(X, a) \
+X(a, STATIC,   ONEOF,    MESSAGE,  (payload,keep_alive,payload.keep_alive),   3) \
+X(a, STATIC,   ONEOF,    UENUM,    (payload,reset,payload.reset), 101) \
+X(a, STATIC,   ONEOF,    UENUM,    (payload,cp_state,payload.cp_state), 102) \
+X(a, STATIC,   ONEOF,    BOOL,     (payload,relais_state,payload.relais_state), 103) \
+X(a, STATIC,   ONEOF,    MESSAGE,  (payload,error_flags,payload.error_flags), 104) \
+X(a, STATIC,   ONEOF,    MESSAGE,  (payload,telemetry,payload.telemetry), 105)
+#define McuToEverest_CALLBACK NULL
+#define McuToEverest_DEFAULT NULL
+#define McuToEverest_payload_keep_alive_MSGTYPE KeepAliveLo
+#define McuToEverest_payload_error_flags_MSGTYPE ErrorFlags
+#define McuToEverest_payload_telemetry_MSGTYPE Telemetry
+
+#define SetOutputVoltageCurrent_FIELDLIST(X, a) \
+X(a, STATIC,   SINGULAR, FLOAT,    voltage,           1) \
+X(a, STATIC,   SINGULAR, FLOAT,    current,           2)
+#define SetOutputVoltageCurrent_CALLBACK NULL
+#define SetOutputVoltageCurrent_DEFAULT NULL
+
+#define ErrorFlags_FIELDLIST(X, a) \
+X(a, STATIC,   SINGULAR, BOOL,     diode_fault,       1) \
+X(a, STATIC,   SINGULAR, BOOL,     cp_signal_fault,   6)
+#define ErrorFlags_CALLBACK NULL
+#define ErrorFlags_DEFAULT NULL
+
+#define KeepAliveLo_FIELDLIST(X, a) \
+X(a, STATIC,   SINGULAR, UINT32,   time_stamp,        1) \
+X(a, STATIC,   SINGULAR, UINT32,   hw_type,           2) \
+X(a, STATIC,   SINGULAR, UINT32,   hw_revision,       3) \
+X(a, STATIC,   SINGULAR, UINT32,   protocol_version_major,   4) \
+X(a, STATIC,   SINGULAR, UINT32,   protocol_version_minor,   5) \
+X(a, STATIC,   SINGULAR, STRING,   sw_version_string,   6) \
+X(a, STATIC,   SINGULAR, FLOAT,    hwcap_max_current,   7) \
+X(a, STATIC,   SINGULAR, FLOAT,    hwcap_min_current,   8) \
+X(a, STATIC,   SINGULAR, UINT32,   hwcap_max_phase_count,   9) \
+X(a, STATIC,   SINGULAR, UINT32,   hwcap_min_phase_count,  10) \
+X(a, STATIC,   SINGULAR, BOOL,     supports_changing_phases_during_charging,  11)
+#define KeepAliveLo_CALLBACK NULL
+#define KeepAliveLo_DEFAULT NULL
+
+#define KeepAlive_FIELDLIST(X, a) \
+X(a, STATIC,   SINGULAR, UINT32,   time_stamp,        1) \
+X(a, STATIC,   SINGULAR, UINT32,   hw_type,           2) \
+X(a, STATIC,   SINGULAR, UINT32,   hw_revision,       3) \
+X(a, STATIC,   SINGULAR, STRING,   sw_version_string,   6)
+#define KeepAlive_CALLBACK NULL
+#define KeepAlive_DEFAULT NULL
+
+#define Telemetry_FIELDLIST(X, a) \
+X(a, STATIC,   SINGULAR, FLOAT,    cp_hi,             1) \
+X(a, STATIC,   SINGULAR, FLOAT,    cp_lo,             2) \
+X(a, STATIC,   SINGULAR, FLOAT,    pwm_dc,            3) \
+X(a, STATIC,   SINGULAR, FLOAT,    relais_on,         4) \
+X(a, STATIC,   SINGULAR, FLOAT,    voltage,           5)
+#define Telemetry_CALLBACK NULL
+#define Telemetry_DEFAULT NULL
+
+#define FirmwareUpdate_FIELDLIST(X, a) \
+X(a, STATIC,   SINGULAR, BOOL,     invoke_rom_bootloader,   1)
+#define FirmwareUpdate_CALLBACK NULL
+#define FirmwareUpdate_DEFAULT NULL
+
+extern const pb_msgdesc_t EverestToMcu_msg;
+extern const pb_msgdesc_t McuToEverest_msg;
+extern const pb_msgdesc_t SetOutputVoltageCurrent_msg;
+extern const pb_msgdesc_t ErrorFlags_msg;
+extern const pb_msgdesc_t KeepAliveLo_msg;
+extern const pb_msgdesc_t KeepAlive_msg;
+extern const pb_msgdesc_t Telemetry_msg;
+extern const pb_msgdesc_t FirmwareUpdate_msg;
+
+/* Defines for backwards compatibility with code written before nanopb-0.4.0 */
+#define EverestToMcu_fields &EverestToMcu_msg
+#define McuToEverest_fields &McuToEverest_msg
+#define SetOutputVoltageCurrent_fields &SetOutputVoltageCurrent_msg
+#define ErrorFlags_fields &ErrorFlags_msg
+#define KeepAliveLo_fields &KeepAliveLo_msg
+#define KeepAlive_fields &KeepAlive_msg
+#define Telemetry_fields &Telemetry_msg
+#define FirmwareUpdate_fields &FirmwareUpdate_msg
+
+/* Maximum encoded size of messages (where known) */
+#define ErrorFlags_size                          4
+#define EverestToMcu_size                        73
+#define FirmwareUpdate_size                      2
+#define KeepAliveLo_size                         106
+#define KeepAlive_size                           70
+#define McuToEverest_size                        108
+#define SetOutputVoltageCurrent_size             10
+#define Telemetry_size                           25
+#define UMWC_PB_H_MAX_SIZE                       McuToEverest_size
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif
+
+#endif

tools/EVerest-main/modules/HardwareDrivers/EVSE/MicroMegaWattBSP/umwc_comms/protobuf/umwc.proto

@@ -0,0 +1,95 @@
+syntax = "proto3";
+
+/*
+ This container message is send from EVerest to MCU and may contain any allowed message in that direction.
+*/
+message EverestToMcu {
+ oneof payload {
+    // Needs to remain the same to allow firmware updates of older versions
+    FirmwareUpdate firmware_update = 16;
+
+    SetOutputVoltageCurrent set_output_voltage_current = 50;
+
+    // Other IDs are 100+ to avoid compatibility issues with older firmware versions
+    KeepAlive keep_alive = 100;
+    uint32 pwm_duty_cycle = 103; // in 0.01 %, 0 = State F, 10000 = X1
+    bool allow_power_on = 104;
+    bool reset = 105;
+    bool enable = 106;
+    bool replug = 107;
+  }
+}
+
+/*
+ This container message is send from MCU to EVerest and may contain any allowed message in that direction.
+*/
+message McuToEverest {
+ oneof payload {
+  // Needs to remain the same to allow firmware updates of older versions
+  KeepAliveLo keep_alive = 3;
+
+  // Other IDs are 100+ to avoid compatibility issues with older firmware versions
+  ResetReason reset = 101;
+  CpState cp_state = 102;
+  bool relais_state = 103; // false: relais are off, true: relais are on
+  ErrorFlags error_flags = 104;
+  Telemetry telemetry = 105;
+ }
+}
+
+enum CpState {
+  STATE_A = 0;
+  STATE_B = 1;
+  STATE_C = 2;
+  STATE_D = 3;
+  STATE_E = 4;
+  STATE_F = 5;
+}
+
+message SetOutputVoltageCurrent {
+  float voltage = 1;
+  float current = 2;
+}
+
+message ErrorFlags {
+  bool diode_fault = 1;
+  bool cp_signal_fault = 6;
+}
+
+enum ResetReason {
+  USER = 0;
+  WATCHDOG = 1;
+}
+
+message KeepAliveLo {
+  uint32 time_stamp = 1;
+  uint32 hw_type = 2;
+  uint32 hw_revision = 3;
+  uint32 protocol_version_major = 4;
+  uint32 protocol_version_minor = 5;
+  string sw_version_string = 6;
+  float hwcap_max_current = 7;
+  float hwcap_min_current = 8;
+  uint32 hwcap_max_phase_count = 9;
+  uint32 hwcap_min_phase_count = 10;
+  bool supports_changing_phases_during_charging = 11;
+}
+
+message KeepAlive {
+  uint32 time_stamp = 1;
+  uint32 hw_type = 2;
+  uint32 hw_revision = 3;
+  string sw_version_string = 6;
+}
+
+message Telemetry {
+  float cp_hi = 1;
+  float cp_lo = 2;
+  float pwm_dc = 3;
+  float relais_on = 4;
+  float voltage = 5;
+}
+
+message FirmwareUpdate {
+  bool invoke_rom_bootloader = 1;
+}