Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
The open smart grid platform supports IEC61850. IEC61850 is a popular protocol in the field of "smart grids". IEC61850 started as a standard for substation automation but has expanded into other domains such as EV and solar panels. Currently, the IEC61850 protocol is used within the Public Lighting, Microgrids and Distribution Automation domains. IEC61850 on Wikipedia
No security options exist in this IEC61850 version 1 and 2
Use through a secured tunnelling protocol like TLS (with client certificates) or VPN
IEC Security guidelines can be found in IEC62351.
The open smart grid platform implementation supports:
IEC 61850-8-1: Mappings to MMS (ISO/IEC9506-1 and ISO/IEC 9506-2)
The OpenMUC IEC61850 library from Fraunhofer is used to implement the protocol.
These devices are currently supported by the Open Smart Grid Platform:
Wago 750-881 RTU
ABB 540CID11 RTU
Kaifa AS101 load control box
Contrary to OSLP the contract between OSGP and IEC61850 devices does not exist of request/response messages, instead the request messages received by OSGP will result in multiple read/write operations at the device. The response messages returned by OSGP will contain the result of these operations.
The device registration is a 2 step process. First RegisterDeviceRequest is sent from device to platform. Second are writing GPS coordinates to the device and disabling the device registration flag.
Request that notifies the platform that a device wants to register. During the registration the device identification (serial number) and the IP address are sent to the platform.
Response writes GPS coordinates and disables registration flag.
IEC61850 platform messages of the data sent to the device:
IEC61850 protocol adapter logging:
Request which queries a device for its current configuration.
Response which returns the result of the request and, if 'result = OK', contains the configuration of the device.
Soap requests and responses sent to and from platform:
Platform message of the data read from the device:
IEC61850 protocol adapter logging:
Request which commands a device to download and install new firmware. The request contains a URL defining the location of the new firmware image. The device should download the firmware from that location.
Response which returns the result of the request.
Soap requests and responses sent to and from platform:
Platform message of the data written to the device:
IEC61850 protocol adapter logging:
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
CSLC.EvnBuf
CF
enbEvnType
VisString32
Bitmask indicating which event notification types are enabled, to enable all event types use: "3FFFFFF".
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
CSLC.Reg
CF
ntfEnb
BOOLEAN
Enable/Disable device registration.
CSLC.Atnm
CF
lon
FLOAT32
Longitude.
CSLC.Atnm
CF
lat
FLOAT32
Latitude.
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
XSWC1.SwType
ST
stVal
INT8
Switch type for relay 1, tariff = 0, light = 1.
XSWC2.SwType
ST
stVal
INT8
Switch type for relay 2, tariff = 0, light = 1.
XSWC3.SwType
ST
stVal
INT8
Switch type for relay 3, tariff = 0, light = 1.
CSLC.SWCf
CF
LT
VisString64
Device light type, always set to RELAY.
CSLC.SWCf
CF
adSetOft
INT16
Offset in minutes with respect to astronomical sunset.
CSLC.SWCf
CF
adRiseOft
INT16
Offset in minutes with respect to astronomical sunrise.
CSLC.Reg
CF
svrAddr
VisString64
OSGP server address for device registration.
CSLC.Reg
CF
svrPort
INT32
OSGP server port for device registration.
CSLC.Clock
CF
dstBegT
VisString255
Daylight savings time begin time.
CSLC.Clock
CF
dstEndT
VisString255
Daylight savings time end time.
CSLC.Clock
CF
enbDst
BOOLEAN
Flag indicating whether daylight savings time is enabled.
CSLC.Clock
CF
enbNtpC
BOOLEAN
Flag inidicating whether NTP client is enabled.
CSLC.Clock
CF
ntpSvrA
VisString255
NTP server address.
CSLC.Clock
CF
syncPer
INT16U
Time sync period.
CSLC.IPCf
CF
enbDHCP
BOOLEAN
Flag indicating whether DHCP client is enabled.
CSLC.IPCf
CF
ipAddr
VisString32
Fixed IP address when DHCP is disabled.
CSLC.IPCf
CF
netmask
VisString32
Netmask when DHCP is disabled.
CSLC.IPCf
CF
gateway
VisString32
Gateway when DHCP is disabled.
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
XSWC1.SwType
CO
Oper.ctlVal
INT8
Switch type for relay 1, tariff = 0, light = 1.
XSWC2.SwType
CO
Oper.ctlVal
INT8
Switch type for relay 2, tariff = 0, light = 1.
XSWC3.SwType
CO
Oper.ctlVal
INT8
Switch type for relay 3, tariff = 0, light = 1.
XSWC4.SwType
CO
Oper.ctlVal
INT8
Switch type for relay 4, tariff = 0, light = 1.
CSLC.SWCf
CF
LT
VisString64
Light type, always set to "RELAY".
CSLC.SWCf
CF
adSetOft
INT16
Offset in minutes with respect to astronomical sunset.
CSLC.SWCf
CF
adRiseOft
INT16
Offset in minutes with respect to astronomical sunrise.
CSLC.Reg
CF
svrAddr
VisString64
OSGP server address for device registration.
CSLC.Reg
CF
svrPort
INT32
OSGP server port for device registration.
CSLC.Clock
CF
dstBegT
VisString255
Daylight savings time begin time.
CSLC.Clock
CF
dstEndT
VisString255
Daylight savings time end time.
CSLC.Clock
CF
enbDst
BOOLEAN
Flag indicating whether daylight savings time is enabled.
CSLC.Clock
CF
enbNtpC
BOOLEAN
Flag indicating whether NTP client is enabled.
CSLC.Clock
CF
ntpSvrA
VisString255
NTP server address.
CSLC.Clock
CF
syncPer
INT16U
Time sync period in minutes.
CSLC.IPCf
CF
enbDHCP
BOOLEAN
Flag indicating whether DHCP client is enabled.
CSLC.IPCf
CF
ipAddr
VisString32
Fixed IP address when DHCP is disabled.
CSLC.IPCf
CF
netmask
VisString32
Netmask when DHCP is disabled.
CSLC.IPCf
CF
gateway
VisString32
Gateway when DHCP is disabled.
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
CSLC.FuncFwDw
CF
url
VisString255
Functional firmware. Set new firmware file download URL here, device will download the new firmware file and then replace the old firmware file at startT.
CSLC.FuncFwDw
CF
startT
Timestamp
Functional firmware. Device will try to install new firmware file at this Timestamp (date + time).
CSLC.ScyFwDw
CF
url
VisString255
Security firmware. Set new firmware file download URL here, device will download the new firmware file and then replace the old firmware file at startT.
CSLC.ScyFwDw
CF
startT
Timestamp
Security firmware. Device will try to install new firmware file at this Timestamp (date + time).
Request which commands a device to reboot immediately. After the reboot, the device will switch its relays according to its schedule. Any ad hoc changes to relays will be lost.
Response which returns the result of the request.
Soap requests and responses sent to and from platform:
IEC61850 platform message of the data set on the device:
IEC61850 protocol adapter logging:
Request which commands the device to switch all light relays off and then queries the device for the status of the relays. OGSP checks if the status of the relays is as expected (off in this case).
Response which returns the result of the request.
Soap requests and responses sent to and from platform:
IEC61850 platform message of the data written to the device:
IEC61850 platform message of the data read from the device:
IEC61850 protocol adapter logging:
Request to download a new SSL certificate from the certificate server. The device will be given the domain name and URL where the certificate is located.
Soap requests and responses sent to and from platform:
IEC61850 platform message of the data sent to the device:
IEC61850 protocol Adapter logging:
A light sensor device can send a buffered report containing the current state of the digital inputs. The buffered report will be sent on data change. OSGP will interpret the buffered report and save event information contained in the report, in this case the state of the digital input:
IEC61850 protocol Adapter logging:
Contract for The contract specifies the messages which can be exchanged with a LMD.
(from platform to device) is a request which queries a device for the current status of all its digital inputs.
(from device to platform) is a response which returns the result of the GetStatusRequest and, if 'result = OK', returns the current status for all of the digital inputs.
(from device to platform) is a request that pushes an event notification from a device to the platform.
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
CSLC.RbOper
ST
Oper.ctlVal
BOOLEAN
Flag which, if set to true, will trigger a reboot.
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
CSLC.Sensor
CO
Oper.ctlVal
BOOLEAN
Flag indicating transition type, true = DAY_NIGHT, false = NIGHT_DAY.
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
XSWC2.Pos
CO
Oper.ctlVal
BOOLEAN
Flag which, if set to false, immediately switches relay 2 off.
XSWC3.Pos
CO
Oper.ctlVal
BOOLEAN
Flag which, if set to false, immediately switches relay 3 off.
ATTRIBUTE | FC | SUB ATTRIBUTE | DATATYPE | DESCRIPTION |
CSLC.CARepl | CF | url | VisString255 | Set new CA file download URL here, device will download the new CA file and then replace the old CA file at startT. |
CSLC.CARepl | CF | startT | VisString32 | Device will download CA file at this Timestamp (date + time). |
The messages below are part of OSGP and implemented in the IEC61850 protocol adapter and supported by the SWDevice-010805 device firmware.
The following messages are not supported in IEC61850 and will return an UNSUPPORTED_DEVICE_ACTION SOAP Fault when a request is sent:
ResumeScheduleRequest
SwitchConfigurationRequest
SwitchFirmwareRequest
SetDeviceVerificationKeyRequest
The following message from device to OSGP is also not supported:
ConfirmRegisterDeviceRequest
Request which queries the device for the status of the digital input.
Response which returns the result of the request and, if 'result = OK', contains the current status for the digital input.
Soap requests and responses sent to and from platform:
Platform message of the data read from the device:
IEC61850 protocol Adapter logging:
Buffered report sent from device to platform containing information about 1 event. The devices keep up to 120 events in the cyclic buffer CSLC.EvnBuf.evn1/env120
. The events are converted to buffered reports when OSGP triggers the device to do so by writing true to CSLC.evn_rpn01[BR].RptEna
. When this happens, the device will send the buffered reports to OSGP. OSGP will save the information specified by the remark field, like the event type and the event time:
Example buffered report:
NOTE: After executing operations SetLightRequest, GetStatusRequest and SetTransitionRequest, OSGP will enable reporting on the device. Optionally, OSGP will enable reporting after DeviceRegistrationRequest (default is false).
IEC61850 platform message of the data sent to the device:
IEC61850 protocol Adapter logging:
Request which queries the device for its current firmware version.
Response which returns the result of the request and, if 'result = OK' contains the firmware version.
Soap requests and responses sent to and from platform:
Platform message of the data received from the device:
IEC61850 protocol adapter logging:
Request which commands the device to switch on or off one or several light relays. If optional value 'index' is omitted, all relays configured as light are switched. In that case, the message will contain exactly one LightValue and all relays will switch to that LightValue. In case the value 'index' is included, multiple instances of LightValue can be used (up to 6), each indicating a particular relay.
Response which returns the result of the request.
Soap requests and responses sent to and from platform:
IEC61850 platform message of the data set on the device:
IEC61850 protocol adapter logging:
Request which commands the device to switch all light relays on and then queries the device for the status of the relays. OGSP checks if the status of the relays is as expected (on in this case).
Response returns the result of the request.
Soap requests and responses sent to and from platform:
IEC61850 platform message of the data written to the device:
IEC61850 platform message of the data read from the device:
IEC61850 protocol adapter logging:
Request which queries the device for the status of all relays, the type of configuration, and the event notification mask set on the device.
Response which returns the result of the request and, if 'result = OK', contains the current status for all of the relays and other information.
Soap requests and responses sent to and from platform:
Platform message of the data read from the device:
IEC61850 protocol Adapter logging:
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
SPGGIO2.Ind
ST
stVal
BOOLEAN
Current state of the digital input.
ATTRIBUTE
FC
SUB ATTRIBUTE
DATATYPE
DESCRIPTION
CSLC.evn_rpn01
BR
RptEna
BOOLEAN
Flag which indicates to the device to send buffered reports.
ATTRIBUTE | FC | SUB ATTRIBUTE | DATATYPE | DESCRIPTION |
SWDeviceGenericIO/CSLC.FuncFwDw | ST | curVer | VisString32 | Current functional firmware version. |
SWDeviceGenericIO/CSLC.ScyFwDw | ST | curVer | VisString32 | Current security firmware version. |
ATTRIBUTE | FC | SUB ATTRIBUTE | DATATYPE | DESCRIPTION |
XSWC2.Pos | CO | Oper.ctlVal | BOOLEAN | Flag which, if set to true, immediately switches relay 2 on. |
XSWC3.Pos | CO | Oper.ctlVal | BOOLEAN | Flag which, if set to true, immediately switches relay 3 on. |
XSWC4.Pos | CO | Oper.ctlVal | BOOLEAN | Flag which, if set to true, immediately switches relay 4 on. |
ATTRIBUTE | FC | SUB ATTRIBUTE | DATATYPE | DESCRIPTION |
XSWC2.Pos | CO | Oper.ctlVal | BOOLEAN | Flag which, if set to true, immediately switches relay 2 on. |
XSWC3.Pos | CO | Oper.ctlVal | BOOLEAN | Flag which, if set to true, immediately switches relay 3 on. |
ATTRIBUTE | FC | SUB ATTRIBUTE | DATATYPE | DESCRIPTION |
XSWC1.Pos | ST | stVal | BOOLEAN | Current switch status for relay 1. |
XSWC2.Pos | ST | stVal | BOOLEAN | Current switch status for relay 2. |
XSWC3.Pos | ST | stVal | BOOLEAN | Current switch status for relay 3. |
XSWC4.Pos | ST | stVal | BOOLEAN | Current switch status for relay 4. |
CSLC.EvnBuf | CF | enbEvnType | VisString32 | Bitmask indicating which event notification types are enabled. |
CSLC.SWCf | CF | LT | VisString64 | Device light type, always "RELAY". |
Request which commands a device to set a light or tariff schedule.
Response which returns the result of the request.
The table shows the fields for XSWC1 (relay 1). The device has 4 relays (XSWC1...XSWC4).
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).
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
.
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:
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.
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.