Models
Models are objects that are referred to in endpoints.
SetSolarOperation
Set the operating mode for an inverter.
Non-negative, in W. 0 will turn power production off, power above nominal active power will not curtail it at all.
Non-negative and <= 100. 0 will turn power production off, 100 will not curtail it at all.
In var. Positive means injecting, negative absorbing.
SetWindOperation
Set the operating mode for a turbine.
Non-negative, in W. 0 will turn power production off, power above nominal active power will not curtail it at all.
Non-negative and <= 100. 0 will turn power production off, 100 will not curtail it at all.
In var. Positive means injecting, negative absorbing.
ApplyAfrrDeltaSetpoint
Adjust the power production of an inverter, turbine or battery with the specified power delta. For an inverter or turbine, the delta is compared to the minimum of the available power given the weather conditions and the regular curtailment instructions. For a battery, the delta is compared to the cloud setpoint (SetBatteryOperation) or 0 if no cloud setpoint is active. This can be used when providing automatic Frequency Restoration Reserve (aFRR) services. For PV assets this requires at least one pyranometer or irradiance sensor on site. If a controller has both battery and solar/wind, solar/wind always has priority for achieving aFRR delta. Battery is only used if solar/wind cannot achieve required delta. As the active power need to be produced every 4 seconds (possibly 1 second in the future), the assets need to respond fast enough. Especially PV assets where each inverter in an RS485 string needs to be read out might be problematic.
LimitProductionPower commands for the same asset can be active in parallel: the Teleport will apply the delta on the lowest active setpoint.
In W. Positive for aFRR-up and negative for aFRR-down.
SetBatteryOperation
Set the operating mode for a battery.
In W. Positive means discharging, negative charging.
In var. Positive means injecting, negative consuming.
In W and non-negative.
Non-negative and <= 100.
SetEVOperation
Set the operating mode for a set of EV charger stations.
In W. For non-bidirectional chargers this value should not be positive. Use null or leave the property out to indicate that no limit should be set.
SetGeneratorOperation
Set the operating mode for a generator.
In W. For generators digital input controls, any non-zero setpoint turns on the asset to deliver a predetermined fixed power output.
In var. Positive means injecting, negative absorbing.
SetRelayOperation
Set the operating mode for a relay.
An array describing the state of all channels in the relay. If there are more elements than channels the superfluous ones are ignored. If less elements are present the other channels are put in their default state.
SetNodeConstraints
Set instantaneous and/or contractual active power limit at the grid connection or designated metering point with dynamic control where startAt defines the start period of the limit and endAt defined the end period. Once the control schedule ends, the limits revert to their preconfigured static settings. If a requested limit is outside of the static and configured limits, it will be clamped to the nearest permissible value and the Teleport will apply the limitation on the lowest active setpoint. It is recommended to use a 5% margin on feedIn and consume limits compared to the actual contracted limits.
In W. The upper power limit (typically positive). Represents the maximum allowable feed-in. Must be greater than or equal to the consume limit. In line with Producer Reference Frame (generator sign convention).
In W. The lower power limit (typically negative). Represents the maximum allowable consumption. Must be less than or equal to the feed-in limit. In line with Producer Reference Frame (generator sign convention).
In W. The upper power limit (typically positive). Represents the maximum allowable feed-in. Must be greater than or equal to the consume limit. In line with Producer Reference Frame (generator sign convention).
In W. The lower power limit (typically negative). Represents the maximum allowable consumption. Must be less than or equal to the feed-in limit. In line with Producer Reference Frame (generator sign convention).
In W. The upper power limit (typically positive). Represents the maximum allowable feed-in. Must be greater than or equal to the consume limit. In line with Producer Reference Frame (generator sign convention).
In W. The lower power limit (typically negative). Represents the maximum allowable consumption. Must be less than or equal to the feed-in limit. In line with Producer Reference Frame (generator sign convention).
In W. The upper power limit (typically positive). Represents the maximum allowable feed-in. Must be greater than or equal to the consume limit. In line with Producer Reference Frame (generator sign convention).
In W. The lower power limit (typically negative). Represents the maximum allowable consumption. Must be less than or equal to the feed-in limit. In line with Producer Reference Frame (generator sign convention).
DemoBattery
Parameters for controlling the errors and warnings of a demo battery. The demo battery will use these warnings and errors in the batteryPower messages.
LimitProductionPower
Limit the power production of an inverter or turbine. The Teleport device will send an extra measurement report immediately after startAt and endAt (unless a report is already scheduled within 3 seconds).
Non-negative and <= 100. 0 will turn power production off, 100 will not curtail it at all.
LimitPower
Set an active power limit at the grid connection or designated metering point with dynamic control where startAt defines the start period of the limit and endAt defined the end period. Once the control schedule ends, the limits revert to their preconfigured static settings. The Teleport will apply the limitation on the lowest active setpoint.
If a negative value is set for feedIn, its absolute value must be lower than both the static and configured consumption limits; otherwise, it will be clamped to the nearest permissible value. Similarly, if a negative value is set for consume, its absolute value must be lower than both the static and configured feed-in limits; otherwise, it will also be clamped to the nearest permissible value. If both feedIn and consume are negative, both will be changed to 0.
It is recommended to use a 5% margin on feedIn and consume limits compared to the actual contracted limits when using LimitPower schedule.
In W. The inverted feed-in limit must not exceed the consume limit, and vice versa
In W. The inverted consume limit must not exceed the feed-in limit, and vice versa