slControl API

LogoutChangelog (26.08.2024)Legal notesBasic usageRequest EmulatorTroubleshooting
Global
Get list of accessible customersGet lookup tables for settingsGet lookup tables for devicesGet lookup tables for operationModeGet lookup tables for gatewaysGet lookup tables for jobsGet lookup tables for alerts
Customers
Get customer configurationUpdate customer configurationGet mesh network
Groups
Get group tree
Lamp switches
Get lamp switchesUpdate lamp switches
Luminaire points
Get luminaire pointsUpdate luminaire pointsCreate luminaire pointsDelete luminaire points
Devices
Get devicesGet device dataGet device stateUpdate device dataUpdate device operation stateGet operation modeUpdate operation modeDelete deviceDelete devices
Devices - Statistics/Logs
Get radar dataGet motion dataGet device energyGet environmental data
Gateways
Get gatewaysGet gateway dataCreate gatewaysDelete a gateway
Jobs
Get jobs state of a deviceGet job state by slcID
Alerts
Get alertsCreate alertsUpdate alerts

Get device state

Get state and sensor data of one or more devices.

API endpoint

deviceStatus/slcDeviceAddress

Request method

GET

Request headers

-

Request URL parameters

-

Request content

EntityTypeNullableDescription
deviceStatusarray (mainEntity)no

mainEntity

EntityTypeNullableDescription
device_idintnoslcDeviceAddress
led_brightnessbyteyesled brightness in %
power_usagefloatyescurrent energy consumption in Watt
evg_sec_currentfloatyescurrent secondary (led) current in ampere (measured by DALI 2-EVG)
evg_sec_voltagefloatyescurrent secondary (led) voltage in volt (measured by DALI 2-EVG)
online_status_idint (onlineState)nodevice online state
network_qualitybyteyesnetwork connection quality in %
hop_countbyteyesnumber of signal redirects (hops) of the radio connection to the device
last_connection_attimestampyesDate and time of last known connection to the device.
last_status_refresh_attimestampyeslast actualization of the device state data (eg. sensor data)
pcb_temperaturefloatyesdevice temperature in °C
led_temperaturefloatyesLED temperatur in °C
env_brightness_referenceintyesreference environment brightness (0-1720 lux)
env_brightness_localintyeslocally measured environment brightness (0-1720 lux)
motion_counterintyesmotion counter value
operation_time_dev_totaldoubleyestotal operation time in hours
operation_time_led_totaldoubleyestotal LED operation time in hours
operation_time_led_weighteddoubleyesweighted LED operation time in hours
manual_override_switch_statusboolyescurrent light switch state (active/inactive)
on_timedoubleyesdevice operation time since last switch on or reset in hours
device_hw_status_idbyte - 1 flag per bit (hardwareState)yesdevice hardware state
device_periphery_hw_failure_idint - 1 flag per bit (peripheryFailure)yesperiphery hardware failure
managing_gateway_idintyesslcID of the gateway that is managing this device
dio_statusbyteyesstate of digital IO of the electronics (SLC and SLC Core)

onlineState

ValueDescription
0Unbekannt
1Verfügbar (Online)
2Nicht verfügbar (Offline)
3Inaktiv

hardwareState

ValueDescription
0Aktivierung erfolgt
1GPS Hardware Fehler
2RTC Hardware Fehler
3Temperatursensor Hardware Fehler
4Temperatur zu Hoch
5Peripherie Hardware Fehler
6Authentifizierungs Fehler
7unknown / not yet implemented

peripheryFailure

ValueDescription
0Bewegungs Sensor Fehler
1Digitaler LED Temperatur Sensor Fehler
2EVG Lampenfehler
3Digitaler Helligkeitssensor Fehler