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.

This document reflects the current RAD version of the BBA Microgrid Controller specification.

Translation Table

Blank values in BBA Microgrid Controller indicate generic packet measurands that remain part of the contract but do not have a current BBA source value. Blank values in Generic Measurand Key indicate BBA controller fields that do not yet have a generic packet measurand.

BBA Microgrid Controller	Generic Measurand Key	Translation
MCN_MGC_CMS_AVAILABLE_PWR	AVAILABLE_CHARGING_CAPACITY	Units watts
MCN_MGC_CMS_FAILSAFE_PWR	FAIL_SAFE_CAPACITY	Units watts; used when communication with the MGC is lost
MCN_MGC_BESS_SOC	SOC	Percentage
	LIMIT_PEAK_SHAVING	No current BBA Microgrid Controller source value. Do not infer this from MCN_MGC_IESO_DISPATCH_ON_OFF.
MCN_MGC_IESO_DISPATCH_ON_OFF	DISPATCH_STATE	"on" if on, else "off"
MCN_MGC_DER_EXP_ON_OFF	LIMIT_DER_EXPORT	"true" if on, else "false"
MCN_MGC_BESS_ON_OFF	DEVICE_POWER_STATE	"on" if on, else "off"
MCN_MGC_BESS_MAN_CHRG_ON_OFF, MCN_MGC_BESS_MAN_DISCHRG_ON_OFF, MCN_MGC_BESS_AUTO_DISPATCH_ON_OFF	BESS_OPERATIONAL_MODE	See the truth table below
MCN_MGC_CMS_HEARTBEAT	HEARTBEAT_STATUS	"ok", "connection_lost" if the MGC connection is lost, "timeout" if the heartbeat rate is less than threshold, otherwise "error"
MCN_GENSET_ATS_UTILITY_POS		Placeholder only; ATS in utility position
MCN_GENSET_ATS_GENSET_POS		Placeholder only; ATS in generator position
MCN_GENSET_MET_IA_MAG		Placeholder only; current phase A magnitude
MCN_GENSET_MET_IB_MAG		Placeholder only; current phase B magnitude
MCN_GENSET_MET_IC_MAG		Placeholder only; current phase C magnitude
MCN_GENSET_MET_IN_MAG		Placeholder only; current neutral magnitude
MCN_GENSET_MET_VA_MAG		Placeholder only; voltage phase A-neutral magnitude
MCN_GENSET_MET_VB_MAG		Placeholder only; voltage phase B-neutral magnitude
MCN_GENSET_MET_VC_MAG		Placeholder only; voltage phase C-neutral magnitude
MCN_GENSET_MET_W3		Placeholder only; real power 3-phases
MCN_GENSET_MET_WA		Placeholder only; real power phase A
MCN_GENSET_MET_WB		Placeholder only; real power phase B
MCN_GENSET_MET_WC		Placeholder only; real power phase C
MCN_GENSET_MET_U3		Placeholder only; apparent power 3-phases
MCN_GENSET_MET_UA		Placeholder only; apparent power phase A
MCN_GENSET_MET_UB		Placeholder only; apparent power phase B
MCN_GENSET_MET_UC		Placeholder only; apparent power phase C
MCN_GENSET_MET_Q3		Placeholder only; reactive power 3-phases
MCN_GENSET_MET_QA		Placeholder only; reactive power phase A
MCN_GENSET_MET_QB		Placeholder only; reactive power phase B
MCN_GENSET_MET_QC		Placeholder only; reactive power phase C
MCN_GENSET_MET_FREQ		Placeholder only; frequency
MCN_GENSET_MET_PF3		Placeholder only; power factor 3-phases
MCN_GENSET_MET_PFA		Placeholder only; power factor phase A
MCN_GENSET_MET_PFB		Placeholder only; power factor phase B
MCN_GENSET_MET_PFC		Placeholder only; power factor phase C
MCN_GENSET_MET_WH3_IN		Placeholder only; system imported active energy
MCN_GENSET_MET_WH_IN_A		Placeholder only; phase A imported active energy
MCN_GENSET_MET_WH_IN_B		Placeholder only; phase B imported active energy
MCN_GENSET_MET_WH_IN_C		Placeholder only; phase C imported active energy
MCN_GENSET_MET_WH3_OUT		Placeholder only; system exported active energy
MCN_GENSET_MET_WH_OUT_A		Placeholder only; phase A exported active energy
MCN_GENSET_MET_WH_OUT_B		Placeholder only; phase B exported active energy
MCN_GENSET_MET_WH_OUT_C		Placeholder only; phase C exported active energy
MCN_GENSET_MET_WH3_NET		Placeholder only; balance of system active energy (import-export)

AVAILABLE_CHARGING_CAPACITY and HEARTBEAT_STATUS are required measurands for this translation.

BESS Operational Mode Truth Table

BESS_OPERATIONAL_MODE	MCN_MGC_BESS_AUTO_DISPATCH_ON_OFF	MCN_MGC_BESS_MAN_CHRG_ON_OFF	MCN_MGC_BESS_MAN_DISCHRG_ON_OFF
"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

"automatic" continues to represent the existing generic BESS auto behaviour derived from the vendor auto-dispatch source fields. The separate controller dispatch signal is represented by DISPATCH_STATE, sourced from MCN_MGC_IESO_DISPATCH_ON_OFF.