ev_charger_pool
frequenz.sdk.timeseries.ev_charger_pool ¤
Interactions with EV Chargers.
Classes¤
frequenz.sdk.timeseries.ev_charger_pool.EVChargerPool ¤
An interface for interaction with pools of EV Chargers.
Provides
- Aggregate
power
andcurrent_per_phase
measurements of the EV Chargers in the pool.
Source code in frequenz/sdk/timeseries/ev_charger_pool/_ev_charger_pool.py
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 |
|
Attributes¤
component_ids
property
¤
current_per_phase
property
¤
current_per_phase: FormulaEngine3Phase[Current]
Fetch the total current for the EV Chargers in the pool.
This formula produces values that are in the Passive Sign Convention (PSC).
If a formula engine to calculate EV Charger current is not already running, it will be started.
A receiver from the formula engine can be created using the new_receiver
method.
RETURNS | DESCRIPTION |
---|---|
FormulaEngine3Phase[Current]
|
A FormulaEngine that will calculate and stream the total current of all EV Chargers. |
power
property
¤
power: FormulaEngine[Power]
Fetch the total power for the EV Chargers in the pool.
This formula produces values that are in the Passive Sign Convention (PSC).
If a formula engine to calculate EV Charger power is not already running, it will be started.
A receiver from the formula engine can be created using the new_receiver
method.
RETURNS | DESCRIPTION |
---|---|
FormulaEngine[Power]
|
A FormulaEngine that will calculate and stream the total power of all EV Chargers. |
power_distribution_results
property
¤
power_distribution_results: ReceiverFetcher[Result]
Get a receiver to receive power distribution results.
RETURNS | DESCRIPTION |
---|---|
ReceiverFetcher[Result]
|
A receiver that will stream power distribution results for the pool's set of |
ReceiverFetcher[Result]
|
EV chargers. |
power_status
property
¤
power_status: ReceiverFetcher[EVChargerPoolReport]
Get a receiver to receive new power status reports when they change.
These include - the current inclusion/exclusion bounds available for the pool's priority, - the current target power for the pool's set of batteries, - the result of the last distribution request for the pool's set of batteries.
RETURNS | DESCRIPTION |
---|---|
ReceiverFetcher[EVChargerPoolReport]
|
A receiver that will stream power status reports for the pool's priority. |
Functions¤
__init__ ¤
__init__(
*,
pool_ref_store: EVChargerPoolReferenceStore,
name: str | None,
priority: int,
set_operating_point: bool
) -> None
Create an EVChargerPool
instance.
Note
EVChargerPool
instances are not meant to be created directly by users. Use
the
microgrid.new_ev_charger_pool
method for creating EVChargerPool
instances.
PARAMETER | DESCRIPTION |
---|---|
pool_ref_store |
The EV charger pool reference store instance.
TYPE:
|
name |
An optional name used to identify this instance of the pool or a corresponding actor in the logs.
TYPE:
|
priority |
The priority of the actor using this wrapper.
TYPE:
|
set_operating_point |
Whether this instance sets the operating point power or the normal power for the components.
TYPE:
|
Source code in frequenz/sdk/timeseries/ev_charger_pool/_ev_charger_pool.py
propose_power
async
¤
Send a proposal to the power manager for the pool's set of EV chargers.
This proposal is for the maximum power that can be set for the EV chargers in the pool. The actual consumption might be lower based on the number of phases an EV is drawing power from, and its current state of charge.
Power values need to follow the Passive Sign Convention (PSC). That is, positive values indicate charge power and negative values indicate discharge power. Discharging from EV chargers is currently not supported.
If the same EV chargers are shared by multiple actors, the power manager will consider the priority of the actors, the bounds they set, and their preferred power, when calculating the target power for the EV chargers
The preferred power of lower priority actors will take precedence as long as they respect the bounds set by higher priority actors. If lower priority actors request power values outside of the bounds set by higher priority actors, the target power will be the closest value to the preferred power that is within the bounds.
When there are no other actors trying to use the same EV chargers, the actor's preferred power would be set as the target power, as long as it falls within the system power bounds for the EV chargers.
The result of the request can be accessed using the receiver returned from the
power_status
method, which also streams the bounds that an actor should comply with, based on
its priority.
PARAMETER | DESCRIPTION |
---|---|
power |
The power to propose for the EV chargers in the pool. If
TYPE:
|
bounds |
The power bounds for the proposal. These bounds will apply to actors with a lower priority, and can be overridden by bounds from actors with a higher priority. If None, the power bounds will be set to the maximum power of the batteries in the pool. This is currently and experimental feature. |
RAISES | DESCRIPTION |
---|---|
EVChargerPoolError
|
If a discharge power for EV chargers is requested. |
Source code in frequenz/sdk/timeseries/ev_charger_pool/_ev_charger_pool.py
frequenz.sdk.timeseries.ev_charger_pool.EVChargerPoolError ¤
frequenz.sdk.timeseries.ev_charger_pool.EVChargerPoolReport ¤
Bases: Protocol
A status report for an EV chargers pool.