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

Update device data

Add a new device or actualize an existing one.

API endpoint

device

Request method

POST

Request headers

-

Request URL parameters

-

Request content

EntityTypeNullableDescription
devicearray (mainEntity)no

mainEntity

EntityTypeNullableDescription
idintnoslcDeviceAddress of this device
customer_idintnoslcID of customer
serial_numberstringyesserial number
mac_addressstringyesMAC address
hardware_type_idint (hardwareType)yeshardware type (slControl-module)
hardware_versionstringyesslcDeviceAddress of this device
firmware_versionstringyescurrent firmware version
bootloader_versionstringyescurrent bootloader version
luminaire_type_namestringyesluminaire type name of the device/lamp (defined by lamp manufacturer)
namestringyesname of the device
latitudefloatyeslatitude (WGS84)
longitudefloatyeslongitude (WGS84)
manual_led_brightnessbyteyesLED-Helligkeit im Manuellen Betriebsmodus
env_brightness_masterboolyestrue if this device is acting as environment brightness master
manual_override_switch_groupsbyte[8] - 64 flags, 8 per byteyesÜbergeordneter Lichtschalter-Gruppen-Konfiguration
motion_neighbor_devicesint[]yesNachbargeräte für Bewegungserkennung (max. 16 Einträge)
led_temperature_limitbyteyesLED temperature limit (lamp will be dimmed if reached)
neighbor_rssi_limitsbyteyesMinimale Empfangsstärke der Nachbarleuchten (in dbm)
dali_evg_type_idint (daliType)yestype id of evg
dali_evg_namestringyesName des EVG's (über DALI an Steuerung angehängt)
available_peripherybyte - 1 flag per bit (periphery) yesVerfügbare Peripherie (Flags, siehe Device_Available_Periphery - Tabelle)
ralab_motion_sensor_configarray (ralabMotionSensorConfig)yesKonfiguration für den Ralab Radar-Bewegungssensor
output_configarray (deviceOutputConfig)yesAusgangskonfiguration der Steuerung
lfc_configarray (lfcConfig)yesLichtstrom-Korrektur-Einstellungen (aka LFC, aka CLO) der Leuchte
has_rf_pin_setboolyesHas device RF-PIN set?

ralabMotionSensorConfig

EntityTypeNullableDescription
sensitivitybytenosensitivity of the sensor in %

deviceOutputConfig

EntityTypeNullableDescription
output_typeint (outputType)nooutput type of the controller
fade_off_timefloatnofade off time in ms
fade_on_timefloatnofade on time in ms
min_dim_stepfloatnoAbstufung (Zeiteinheit hängt von Ausgangstyp ab). Typ: 0.001

lfcConfig

EntityTypeNullableDescription
led_lifetimeuintnoLebenszeit der LED-Module [h]
eol_outputbytenoAusgangs-Lichtleistung des LED-Moduls am Ende der Lebenszeit [%]
limiting_factorbytenoLimiting factor of the led output (e.g. max. output percentage) [%]
curve_gammafloat (range: 0.0 - 1.0)noLichstromabnahme des LED-Moduls im Verhältnis der Zeit. Als Annäherung wird eine Gamma-Kurve verwendet. Dieser Wert gibt den Krümmungsfaktor (gamma) an.

hardwareType

ValueDescription
0iLight_M5
1iLight_S3
2iLight_SA
3iLight_S3_PWM
4iLight_MA
5iLight_MP
6iLight_SP
7iLight_MDA
8iLight_SDA
9iLight_SLC
10iLight_SLC_GPS
11esave_SLC_CORE
12esave_SLC_HUB100
13esave_SLC_HUB101
14esave_SLC_HUB102
15esave_SLC_CORE102
16esave_SLC_HUB103
17esave_SLC_CORE103
80esave_SLC_ASIA
81esave_SLC_GPS_ASIA
82esave_SLC_CORE_ASIA
83esave_SLC_HUB100_ASIA
84esave_SLC_HUB101_ASIA
85esave_SLC_HUB102_ASIA
86esave_SLC_CORE102_ASIA
87esave_SLC_HUB103_ASIA
88esave_SLC_CORE103_ASIA
256SLC-Hub 200-C
257SLC-Hub 203-C
288SLC-RC-Switch 200-C
289SLC-RC-Switch 203-C
513SLC-Hub 203
544SLC-Switch One
65280USB_Stick
65281iLightAccessPointMP
65282iLightAccessPointMSX
65535Unknown

daliType

ValueDescription
0Nicht definiert
1Philips Xi SSR 75W
2Philips Xi SSR 150W
3OSRAM OT 40
4OSRAM OT 60
5OSRAM OT 90
6OSRAM OT 165
7Alle Philips SR Treiber ab Spezifikation 1.2 bis 1.5
8Alle Philips SR Treiber ab Spezifikation 1.5
9Tridonic LCA 30W
10Tridonic LCA 60W
11Tridonic LCA 75W
12Tridonic LCA 120W
13Tridonic LCA 160W

periphery

ValueDescription
0ublox GPS Modul (nur bei SLC-Core100)
1Digitaler LED Temperatur Sensor angeschlossen
2Intelligenter Bewegungsmelder angeschlossen (z.B: Radar)
3EVG DALI 2.0 mit Leistungsmessung
4Digitaler Helligkeits Sensor angeschlossen

Request: example in XML

n.a.

Request: example in JSON

{
	"device": {
		"id": 142635,
		"customer_id": 139,
		"name": "GPS Box Axpo Tegra",
		"latitude": 46.828067779541016,
		"longitude": 9.4250392913818359
	}
}