Skip to content

  • voltage and current objects report phase and line measurements, voltage.l1, voltage.l2, voltage.l3, current.l1, current.l2, current.l3 are deprecated
  • The configuration and limit objects are deprecated and replaced by setpoints.
  • Mappings are applied as follows:
    • setpoints.confirmed.current = limit.current.
    • setpoints.confirmed.power = limit.power.
    • setpoints.effective.current = configuration.current.
    • setpoints.effective.power = configuration.power..
  • Added vehicleStateOfCharge to point objects.
[
{
"type": "evPower:2", // identifies this schema
"teleportHashId": "8de4y2", // uniquely identifies the teleport device
"assetIdentifier": "phoenix-contact-charx-abd9234", // globally unique identifier of the asset, when available the brand and serial number of the asset
"attempt": 0, // 0-indexed delivery attempt. integer
"isDeferred": false, // chronological ordering (by asset identifier) is only guaranteed for messages with isDeferred: false.
"measuredAt": "2023-01-01T00:00:00Z", // when read-out started, ISO 8601 yyyy-mm-ddThh:mm:ssZ or YYYYYY-MM-DDTHH:mm:ss.sssZ, so in UTC
"currentType": "ac", // can be "ac" or "dc" or "mixed"
"power": -40700.23, // in W, can be null. Negative if charging a vehicle (consuming from the grid). Active power in case currentType is "ac"
"energyConsumed": 93702.1, // in Wh, can be null. Nonnegative. Active consumed energy in case currentType is "ac"
"energyProduced": null, // in Wh, can be null. Nonnegative. Active produced energy in case currentType is "ac". Only relevant for bidirectional chargers
"errors": [], // array of strings. see error codes section (Deprecated:error is an alias of alarm and will be removed in a future release)
"alarms": [], // array of strings. see error codes section
"info": [], // array of strings. see error codes section
"setpoints": {
"confirmed": { // the setpoints reported by the EV charging point
"activePowerLimit": null, // in W, can be null. The actual power limit, combining setpoints from the Teleport with that of other sources (eg. the vehicles over OCPP)
"currentLimit": -16 // in A, can be null. The actual current limit, combining setpoints from the Teleport with that of other sources (eg. the vehicles over OCPP)
},
"desired": { // setpoints from different sources
"activePowerLimit": {
"cloud": null, // in W, can be null
"activeControl": null, // in W, can be null
"gridOperator": null, // in W, can be null
"modbusServer": null // in W, can be null
},
"currentLimit": {
"cloud": -15, // in A, can be null.
"activeControl": null, // in A, can be null.
"gridOperator": null, // in A, can be null.
"modbusServer": -19 // in A, can be null.
}
},
"effective": { // the setpoints written by the Teleport in the EV charging point
"activePowerLimit": null, // in W, can be null. Negative if charging a vehicle (consuming from the grid). Active power in case currentType is "ac". For EV chargers that only allow control via current this property is null. In that case the Teleport converts the setpoint to a current value and it is included there.
"currentLimit": -15 // in A, can be null. Negative if charging a vehicle (consuming from the grid)
}
},
"stations": [
{
"identifier": "x9844a", // not guaranteed to be unique outside the asset
"errors": [], // array of strings. see error codes section (Deprecated:error is an alias of alarm and will be removed in a future release)
"alarms": [], // array of strings. see error codes section
"info": [], // array of strings. see error codes section
"points": [
{
"identifier": "ge874564", // not guaranteed to be unique outside the station
"currentType": "ac-3-phase-wye", // can be "ac-3-phase-wye", "ac-3-phase-delta", "ac-1-phase" and "dc"
"errors": [], // array of strings. see error codes section (Deprecated:error is an alias of alarm and will be removed in a future release)
"alarms": ["phoenix_contact_charx_external_temperature_too_high"], // array of strings. see error codes section
"info": [], // array of strings. see error codes section
"isCharging": true, // can be null
"vehicleConnected": true, // can be null
"vehicleStateOfCharge": 42.5, // in %, can be null
"setpoints": {
"confirmed": { // the setpoints reported by the EV charging point
"activePowerLimit": null, // in W, can be null. The actual power limit, combining setpoints from the Teleport with that of other sources (eg. the vehicles over OCPP)
"currentLimit": -16 // in A, can be null. The actual current limit, combining setpoints from the Teleport with that of other sources (eg. the vehicles over OCPP)
},
"effective": { // the setpoints written by the Teleport in the EV charging point
"activePowerLimit": null, // in W, can be null. Negative if charging a vehicle (consuming from the grid). Active power in case currentType is "ac". For EV chargers that only allow control via current this property is null. In that case the Teleport converts the setpoint to a current value and it is included there.
"currentLimit": -15 // in A, can be null. Negative if charging a vehicle (consuming from the grid)
}
},
"voltage": { // can be null. Is a number or null for "dc" and "ac-1-phase" currentTypes
"phase": {
"l1": 230.4, // in V, can be null. Nonnegative
"l2": 230.1, // in V, can be null. Nonnegative
"l3": 230.2 // in V, can be null. Nonnegative
}, // can be null
"line": {
"l1": 400.4, // in V, can be null. Nonnegative
"l2": 400.1, // in V, can be null. Nonnegative
"l3": 400.2 // in V, can be null. Nonnegative
} // can be null
},
"current": { // can be null. Is a number or null for "dc" and "ac-1-phase" currentTypes
"phase": {
"l1": -14.9, // in A, can be null. Delivering to the grid is a positive value
"l2": -15.0, // in A, can be null. Delivering to the grid is a positive value
"l3": -15.1 // in A, can be null. Delivering to the grid is a positive value
}, // can be null
"line": {
"l1": -14.9, // in A, can be null. Delivering to the grid is a positive value
"l2": -15.0, // in A, can be null. Delivering to the grid is a positive value
"l3": -15.1 // in A, can be null. Delivering to the grid is a positive value
} // can be null
},
"energyConsumed": 33702.1, // in Wh, can be null. is active energy for AC currentTypes
"energyProduced": 254.9, // in Wh, can be null. is active energy for AC currentTypes. Only relevant for bidirectional chargers
"power": { // can be null, is active power for AC currentTypes. Is a number or null for "dc" and "ac-1-phase" currentTypes
"l1": -3410.01, // in W, can be null. Charging a vehicle has a negative value
"l2": -3400.01, // in W, can be null. Charging a vehicle has a negative value
"l3": -3440.01, // in W, can be null. Charging a vehicle has a negative value
"sum": -10250.03 // in W, can be null. Charging a vehicle has a negative value
}
}
]
}
],
"scheduled": true, // false for measurements that are not part of the regular reporting interval, eg. directly after command execution and at Teleport initialisation
"cellularSignalQuality": -55, // RSSI, in dBm, null means there is no up-to-date signal quality data, optional
}
]