Model¶
The balanz model provides the required data structures for driving Smart Charging decisions as well as elements to support CSMS/CS functionality.
The main components of the model are Groups, Chargers, Sessions, and Tags. The current implementation has, for simplicity, a CSV-file associated with each of these compnent types. Later versions will support a database backend.
Groups¶
A group represents a collection of chargers. For each group, the following attributes are defined:
group_id: A unique identifier for the group.description: A textual description of the group.max_allocation: The maximum allocation for the group. If defined, sets the limit for the total allocation of all chargers contained in any child group (or directly in the group).
A group with the max_allocation attribute set is termed an allocation group.
Groups are defined in a CSV file named groups.csv; file name is configurable.
group_id,description,max_allocation
HQ,HQ Site,00:00-07:59>0=63;08:00-16:59>0=20:3=63;17:00-20:59>5=63;21:00-23:59>0=40:3=63
RR1,Road Runner 1 Site,00:00-05:59>0=48;06:00-16:59>0=16:3=32:5=48;17:00-20:59>0=0:5=48;21:00-23:59>0=32:5=48
RR2,Road Runner 2 Site,00:00-23:59>0=24:3=40:5=48
Default,Default Group for autoregistered chargers,
Note that max_allocation values (in Amps) are defined as values per priority within a schedule. All 24 hours should be covered
as is the case in the examples above. In this allocation maximum may e.g. be increased during the night where office site
activities are not as demanding in terms of electricity. A schedule may also specify times in the day where charging should be
limited, e.g. due to higher electricity costs.
For example, on the RR1 site above in the time interval between 17:00 and 20:59 (most expensive timeslot in Denmark due to
electricity tarrifs), charging with a priority below 5 is completely disabled. If 5 or above, charging can occur with a total
of the full maximum 48 A available.
Chargers¶
A Charger is naturally the most interesting point of control for balanz. It is defined using the following attributes:
charger_id: A unique identifier for the charger. This is typically hardcoded into the charger.alias: A human-readable name for the charger.group_id: The ID of the group to which this charger belongs.no_connectors: The number of connectors on the charger, typically 1.priority: Priority (higher is better) associated with charger connectors.description: A description of the charger.conn_max: The maximum current that can be drawn from this charger in Amps.auth_sha: An authentication SHA-256 hash to verify the charger’s identity. This is set by balanz.
charger_id,alias,group_id,no_connectors,priority,description,conn_max,auth_sha
TACW222421G063,HQ-01,HQ,1,1,HQ low priority HQ-01 (limit 8A),8.0,
TACW212432G692,HQ-02,HQ,1,1,HQ low priority HQ-02 (limit 8A),8.0,
TACW242432G552,HQ-03,HQ,1,1,HQ low priority HQ-03,32.0,
TACW227426G469,HQ-11,HQ,1,3,HQ medium priority HQ-11,32.0,
TACW224437G681,HQ-16,HQ,1,5,HQ high priority HQ-16,32.0,
TACW224377G584,RR1-01,RR1,1,1,RR1 charger RR1-01,32.0,
TACW224357G670,RR1-02,RR1,1,1,RR1 charger RR1-02,32.0,
TACW224327G682,RR1-03,RR1,1,1,RR1 charger RR1-03 (limit 8A),8.0,
TACW224317G584,RR2-01,RR2,1,3,RR2 high priority RR2-01,32.0,
TACW224137G670,RR2-02,RR2,1,1,RR2 low priority RR2-02,32.0,
...
Sessions¶
A Session represents a completed charging transaction. If configured, balanz will log session details to a CSV file for
off-line analysis or processing. Note, that the energy values is given in kWh.
The history field is a ;-separated list of timestamps and their associated offer values in Amps (A).
session_id,charger_id,charger_alias,group_id,id_tag,user_name,stop_id_tag,start_time,end_time,duration,energy,stop_reason,history
TACW225426G463-2025-02-20-22:43:24,TACW225426G463,HQ-14,HQ,D40C346D,John Jones,D40C346D,2025-02-20 20:43:24,2025-02-20 22:23:29,01:40:05,18.021,EVDisconnected,2025-02-20 20:43:27=6A;2025-02-20 20:45:29=9A;2025-02-20 22:23:29=0A
