System Design: BBA Microgrid Controller Generic Packet Translation¶

This design defines how BBA Microgrid Controller telemetry should be translated into the BetterFleet generic sensor packet defined in IoT Sensor Packet.

Translation Table¶

MGC Key	Generic Measurand Key	Translation
`CMS_PDCC_AVAILABLE_PWR`	`AVAILABLE_CHARGING_CAPACITY`	Units watts
`CMS_PDCC_DEFAULT_PWR`	`FAIL_SAFE_CAPACITY`	Units watts
`CMS_BESS_SOC`	`SOC`	Percentage
`CMS_PEAKSHAV_ON`	`LIMIT_PEAK_SHAVING`	`"true"` if on, else `"false"`
`CMS_DER_EXP_ON`	`LIMIT_DER_EXPORT`	`"true"` if on, else `"false"`
`CMS_BESS_ON`	`DEVICE_POWER_STATE`	`"on"` if on, else `"off"`
`CMS_BESS_MAN_CHRG_ON`, `CMS_BESS_MAN_DISCHRG_ON`, `CMS_BESS_AUTO_DISPATCH_ON`	`BESS_OPERATIONAL_MODE`	See the truth table below
`CMS_HEARTBEAT`	`HEARTBEAT_STATUS`	`"ok"`, `"connection_lost"` if the MGC connection is lost, `"timeout"` if the heartbeat rate is less than threshold, otherwise `"error"`

AVAILABLE_CHARGING_CAPACITY and HEARTBEAT_STATUS are required measurands for this translation.

BESS Operational Mode Truth Table¶

`BESS_OPERATIONAL_MODE`	`CMS_BESS_AUTO_DISPATCH_ON`	`CMS_BESS_MAN_CHRG_ON`	`CMS_BESS_MAN_DISCHRG_ON`
`"idle"`	`False`	`False`	`False`
`"discharging"`	`False`	`False`	`True`
`"charging"`	`False`	`True`	`False`
`"error"`	`False`	`True`	`True`
`"automatic"`	`True`	`False`	`False`
`"error"`	`True`	`False`	`True`
`"error"`	`True`	`True`	`False`
`"error"`	`True`	`True`	`True`