Skip to content

Modbus TCP

The Teleport can be configured to have a local Modbus TCP server running. By default it is disabled.

Conventions

  • Values are in big-endian word order.
  • The highest allowed value of the type is used to signal null, eg. 2^16 - 1 for UInt16 and 2^31 - 1 for SInt32.
  • Unlisted addresses for listed Unit IDs will return 2^16 - 1.

Register

Teleport Device

On Unit ID 0 a Modbus TCP client can interact with the Teleport device.

ItemStart addressSizeTypeUnitR/WNotes
Heartbeat01UInt16R/WValue does not matter. Modbus server power limits are removed if there is no heartbeat for 60 seconds. Any other write is also counted as a heartbeat
Unix timestamp14UInt64msR

Aggregated solar and wind assets

At Unit ID 1 a Modbus TCP client can control and readout all connected solar and wind assets together. Aggregated statistics are provided for connected assets. Be aware that these statistics are partial aggregates if (and only if) registers 0 and 1 are not equal. To avoid drawing incorrect conclusions by reading out registers 0 and 1 at a different time than the aggregate statistics, it is advisable to read out all required registers of this Unit ID in a single request.

ItemStart addressSizeTypeUnitR/WNotes
Number of assets configured01UInt16RThe number of assets the Teleport should be connected to.
Number of connected assets11UInt16RThe number of assets the Teleport is connected to.
Nominal active power of configured assets22UInt32WRThe sum of the values from the assets the Teleport should be connected to.
Nominal active power of connected assets212UInt32WRThe sum of the values from the assets the Teleport is connected to.
Combined target active power limit of connected assets311UInt160.01%RThe minimum of setpoints from the various sources listed here, corrected for static limits. Is null if it differs between connected assets.
Target active power limit from modbus server of connected assets321UInt160.01%R/WAs set through the local modbus interface of the Teleport. Writing null (2^16 - 1) means that there is no limit. Overwrites the individual limits set using Unit ID >= 100. Is null if it differs between connected assets.
Target active power limit from cloud of connected assets331UInt160.01%RAs set through the Teleport Cloud API using limitProductionPower commands. Is null if it differs between connected assets.
Target active power limit from realtime interface of connected assets341UInt160.01%RAs set through the Realtime Interface by the grid operator. Is null if it differs between connected assets.
Target active power limit from local active control of connected assets351UInt160.01%RAs set by the Teleport as the result of a control strategy. Is null if it differs between connected assets.
Target active power limit reduction from reduce power instructions of connected assets362UInt32WRAs set through the Teleport Cloud API using reduceProductionPower commands. Is the sum of connected assets.
Target active power limit reduction from reduce power instructions of connected assets381UInt160.01%RAs set through the Teleport Cloud API using reduceProductionPower commands. Is null if it differs between connected assets.
Effective active power limit of connected assets501UInt160.01%RIs null if it differs between connected assets.
Active power of connected assets512SInt32WRThe sum of the values read out from the connected assets.
Available active power of connected assets532SInt32WRThe sum of the values read out from the connected asset or calculated using an asset like a pyranometer.

Individual wind or solar asset

Starting at Unit ID 100 a Modbus TCP client can control and readout an individual asset. The second asset is available at Unit ID 101 and so on. The number of assets can be retrieved from register 1 of Unit ID 0 (see above).

ItemStart addressSizeTypeUnitR/WNotes
Asset type01UInt16R1 = solar, 2 = wind.
Asset identifier120ascii stringRUniquely identifies the asset within the assets connected to this Teleport device.
Nominal active power212UInt32WR
Combined target active power limit311UInt160.01%RThe minimum of setpoints from the various sources listed here, corrected for static limits.
Target active power limit from modbus server321UInt160.01%R/WAs set through the local modbus interface of the Teleport. Writing null (2^16 - 1) means that there is no limit. Overwrites the limit set on Unit ID 1 for this asset.
Target active power limit from cloud331UInt160.01%RAs set through the Teleport Cloud API using limitProductionPower commands.
Target active power limit from realtime interface341UInt160.01%RAs set through the Realtime Interface by the grid operator.
Target active power limit from local active control351UInt160.01%RAs set by the Teleport as the result of a control strategy.
Target active power limit reduction from reduce power instructions362UInt32WRAs set through the Teleport Cloud API using reduceProductionPower commands.
Target active power limit reduction from reduce power instructions381UInt160.01%RAs set through the Teleport Cloud API using reduceProductionPower commands.
Effective active power limit501UInt160.01%RAs read out from the solar or wind asset.
Active power512SInt32WRAs read out from the solar or wind asset.
Available active power532SInt32WRAs read out from the solar or wind asset or calculated using an asset like a pyranometer.