Direct appliance control

This section provides example use-cases for gridX' DER Controlling API as a complement to the technical documentation.

Direct control of an EV charging station

Constraints that can be used specifically for the control of an EV charging station are listed in 'Use-Case 3: Set EV charging station's min/max power constraints' of the API documentation.
For direct control, a power set point can be issued for an EV charging station. It is a total set point, then distributed based on the number of phases of the EV connected to the charging station, depending on the type of EV charging station.

Direct control of a battery

Constraints that can be used specifically for the control of a battery are listed in 'Use-Case 1: Charge battery via direct power control' and 'Use-Case 2: Set Battery's min/max State of Charge' of the API documentation.
For direct control, a total power set point can be issued directly.

Direct control of a Smart-Grid (SG) Ready Heat Pump

In the case of smart-grid ready heat pumps, the control relies on 4 predefined SG modes. To be controllable via the API endpoints, the SG modes must be translated into an equivalent power set point. The translation depends on the heat pump manufacturer. Contact our support team for further information relative to your appliance. The general principle is as follows.

If all 4 SG ready modes are supported:

  • Forced-off mode: the corresponding power set point must be set to zero.
  • Normal operation mode (AUTO): this mode is triggered by a power set point strictly inferior to the minimum heat pump operating power.
  • Smart-grid low (RECOMMENDED ON): this mode is triggered by a power set point comprised between the minimum heat pump operating power and the maximum heat pump operating power.
  • Smart-grid high: this mode is triggered by a power set point equal to the maximum heat pump operating power.

If only 2 SG ready modes are supported:

  • Normal operation mode (AUTO): the corresponding power set point must be set to zero.
  • Smart-grid low (RECOMMENDED ON): this mode is triggered by a power set point equal to the maximum heat pump operating power.

The power set point must be issued as Constraint. This set point is then translated by the DER Driver into one of the SG modes, as illustrated in the following sequence diagram:

The actual power used by the heat pump, and returned by the Flexibilities, will depend on the SG mode and on the operating conditions of the heat pump (ambient temperature, water supply temperature, ...).

Direct control of a PV Inverter

Constraints that can be used specifically for the control of an inverter are listed in 'Use-Case 7: Set PV inverter's active power' of the API documentation.