InControl™ User Guide | Smart Charging Commands

Smart Charging Commands - Power Limits

Julian Ares

Last Update 19 днів тому

Create and manage dynamic power limit rules for EV chargers. This feature enables precise control over energy distribution across your site or charger groups helping you:

Apply limits during peak utility rate periods
Adjust site-wide load during DER or battery usage windows
Schedule daily caps for operational hours

⚠️ Notes & Best Practices

Minimum Power Rule: InControl enforces a 2kW per charger floor to avoid unstable behavior.
Rule Overlap: Avoid overlapping rules to prevent conflicts in enforcement.

Use Recurring for TOU: For time-of-use-based load shedding, recurring rules are more efficient.
Unit Selection: WATT is recommended unless amperage-based logic is required.

Request Parameters

Field	Description
name	Name for the rule
siteId	ID of the site where the rule applies
chargerIds	Specific charger IDs. If omitted, applies to entire site. (Brackets are required even if only one charger is included)
enabled	Activates the rule upon creation
schedule	Defines the time range and recurrence
config	Defines power limit settings and strategy
repeat	Whether the rule is one-time or recurring
noRepeat	Start and stop timestamps for single-use rule
week	Weekly recurrence settings
balancingStrategy	Distribution strategy
minimumPowerLimit	Minimum per-charger limit (≥2000W recommended)
powerLimit	Total limit applied to the group or site
powerLimitUnit	Unit of measurement (WATT, AMPERE)

Creating a One Time Power Limit Rule

Use this mutation to create a one-time power limit for a specific site or set of chargers. The rule defines the maximum allowable site power (in Watts or Amperes) over a scheduled time window.

Example:

The response:

This confirms the rule is active, and you now have a ruleId you can use to update or manage it later.

Updating a One Time Power Limit Rule

Use this mutation to modify an existing one-time rule—for example, to change the time window or adjust the power cap. You must pass the ruleId of the rule you wish to update.

Example:

Note: The id field is required and should reference the ruleId returned from the original createSmartChargingPowerLimitAndDistributionRule call.

The response:

We can see the rule was updated and enabled per the return values we specified, and we have a ruleId which we can use to make future updates to this same rule if we so choose.

💡Best Practices:

Use updates to maintain a clean ruleset - avoid stacking new rules unnecessarily.
Stick with one-time rules for temporary or dynamic site behavior.

Create a Recurring Power Limit Rule

Use this mutation to apply a recurring power limit on specific weekdays during defined time windows. This is useful for consistent load management patterns such as depot fleet arrival times, school dismissal windows, or recurring peak-hour caps.

Example:

The Response:

Defining a recurring schedule introduces a bit more complexity compared to one-time rules. In this example, the rule is configured to run on weekdays for a duration of 14,400 seconds (4 hours).

The response confirms the rule was successfully created and enabled. The returned ruleId can be used for future updates, and the response also includes the full schedule details for reference.

Was this article helpful?

0 out of 0 liked this article

Still need help? Message Us