SetSchedule
Description
Request which commands a device to set a light or tariff schedule.
Response which returns the result of the request.
IEC61850 Fields
The table shows the fields for XSWC1 (relay 1). The device has 4 relays (XSWC1...XSWC4).
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
XSWC1.Sche
CF
sche1.enable
BOOLEAN
Flag indicating the schedule entry is enabled.
XSWC1.Sche
CF
sche1.day
INT32
Day in yyyymmdd format or defined by DAY enum.
XSWC1.Sche
CF
sche1.tOn
INT32
Timestamp in hhmm format when relay should switch on or -1 if not used.
XSWC1.Sche
CF
sche1.tOnT
INT8
Schedule entry type, 0 = fixed time, 1 = light sensor, 2 = astronomical time.
XSWC1.Sche
CF
sche1.tOff
INT32
Timestamp in hhmm format when relay should switch off or -1 if not used.
XSWC1.Sche
CF
sche1.tOffT
INT8
Schedule entry type, 0 = fixed time, 1 = light sensor, 2 = astronomical time.
XSWC1.Sche
CF
sche1.minOnPer
INT16U
Minimum burning time for this relay.
XSWC1.Sche
CF
sche1.minOffPer
INT16U
Not used.
XSWC1.Sche
CF
sche1.srBefWd
INT16U
Window for light sensor trigger, minutes before astronomical time.
XSWC1.Sche
CF
sche1.srAftWd
INT16U
Window for light sensor trigger, minutes after astronomical time.
XSWC1.Sche
CF
sche1.igBefWd
INT16U
Not used.
XSWC1.Sche
CF
sche1.igAftWd
INT16U
Not used.
Although the device supports setting 64 schedule entries (sche1...sche64) for 4 relays (XSWC1...XSWC4), the actual number of schedule entries is limited by OSGP to 50.
Besides the fields on the relay, the switch logic applies astronomical sunrise and sunset offsets to the calculated astronomical times. These are stored with the Street Light Configuration (logical node CSLC).
ATTRIBUTE
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
SWCf
adSetOft
INT16
Offset to be used with calculated astronomical sunset time.
SWCf
adRiseOft
INT16
Offset to be used with calculated astronomical sunrise time.
Examples
Example 1: Light schedule based on light measurement
Description: This schedule combines a 'morning/evening light' with an 'all night light'. Relay 1 and 2 will be switched on using a light measurement trigger. Relay 2 will be switched off at 23:00 using an absolute time. Relay 2 will be switched on at 07:00, but only when no light measurement trigger has been received yet. Relay 1 and 2 will be switched off using a light measurement trigger.
Screenshot of this schedule in an OSGP client application:
SOAP Request Message for Platform web service:
Platform message of data written to the device:
IEC61850 protocol adapter logging:
Astronomical Offsets
The SOAP request message may contain information about astronomical offsets (see the documentation about light schedules for more details about the offsets).
When AstronomicalSunriseOffset and/or AstronomicalSunsetOffset are set, they will be written to the device in attributes CSLC.SWCf.adRiseOft and CSLC.SWCf.adSetOft.
Example 2: Tariff Schedule
Description for this schedule:
This schedule defines the tariff switching moments. For most weekdays of the year the tariff is high from 7 'o clock in the morning until 11 'o clock in the evening. During the night and weekend, the tariff is low. However for certain days, like Christmas Day, the tariff has to be low as well (Christmas Day may be a weekday).
SOAP Request Message for Platform web service:
SOAP Response Message:
SOAP Request message for response:
SOAP Response message:
Platform message for data written to device:
IEC61850 protocol adapter logging:
Last updated
Was this helpful?