LogoLogo
  • Introduction
  • General platform architecture
    • Platform properties
    • Architecture introduction
    • Architecture functional layers
    • Architecture Principles
    • Platform components description
    • Message flow examples
    • Logical Authorisation Model
    • Non-functional overview
      • TimeBehavior
      • Internationalization and localization
      • Security
      • Scalability
      • Redundancy
      • Performance
    • Technical Overview
      • Web Services Layer
      • Domain Layer
      • Core Layer
      • Protocol Layer
      • Technology Stack
    • Use cases
    • Throttling
  • General User's Guide
    • Installation Guide
      • Installation
        • Vagrant
        • Manual Setup
      • GitHub configuration
      • Platform Setup
      • Test the Platform
        • Using SoapUi
        • Using the Demo App
    • Configuration
      • Add a device
      • Users
      • Add a new organisation
      • Throttling
    • Web Services
    • Deployment
    • FAQ
  • Open Source Community
    • Start contributing
    • Developers 101
    • Contributing to the code
    • Contributing to documentation
    • Communication and Contact
    • Governance
    • Code of Conduct
    • Foundation
  • Domains
    • Admin
    • Smart lighting
      • Use cases
      • Light Schedules
    • Tariff switching
    • Microgrids
    • Distribution automation
    • SmartMetering
      • Web Services
        • bypass retry
        • priority
        • scheduling
        • AdHocManagement
          • GetAssociationLnObjects
          • GetGetAssociationLnObjectsResponse
          • RetrieveConfigurationObjects
          • GetRetrieveConfigurationObjectsResponse
          • SpecificConfigurationObject
          • SynchronizeTime
          • GetSynchronizeTimeResponse
        • Bundle
          • Bundle
          • GetBundleResponse
        • Configuration
          • GetAdministrativeStatus
          • GetGetAdministrativeStatusResponse
          • GetFirmwareVersion
          • GetGetFirmwareVersionResponse
          • UpdateFirmware
          • GetUpdateFirmwareResponse
          • ReplaceKeys
          • GetReplaceKeysResponse
          • GetKeys
          • SetActivityCalendar
          • GetSetActivityCalendarResponse
          • SetAdministrativeStatus
          • GetSetAdministrativeStatusResponse
          • SetAlarmNotifications
          • GetSetAlarmNotificationsResponse
          • SetConfigurationObject
          • GetSetConfigurationObjectResponse
          • SetKeyOnGMeter
          • GetSetKeyOnGMeterResponse
          • SetPushSetupAlarm
          • GetSetPushSetupAlarmResponse
          • SetPushSetupSms
          • GetSetPushSetupSmsResponse
          • SetSpecialDays
          • GetSetSpecialDaysResponse
          • GetConfigurationObject
          • GetConfigurationObjectResponse
          • ConfigureDefinableLoadProfile
          • GetConfigureDefinableLoadProfileResponse
          • SetMbusUserKeyByChannel
          • GetSetMbusUserKeyByChannelResponse
          • GetMbusEncryptionKeyStatus
          • GetGetMbusEncryptionKeyStatusResponse
          • GetMbusEncryptionKeyStatusByChannel
          • GetGetMbusEncryptionKeyStatusByChannelResponse
          • ScanMbusChannels
          • ScanMbusChannelsResponse
        • Installation
          • AddDevice
          • GetAddDeviceResponse
          • CoupleMbusDevice
          • GetCoupleMbusDeviceResponse
          • DeCoupleMbusDevice
          • GetDeCoupleMbusDeviceResponse
        • Management
          • FindEvents
          • GetFindEventsResponse
          • GetDevices
          • SetDeviceLifecycleStatusByChannel
          • SetDeviceLifecycleStatusByChannelResponse
          • EnableDebugging
          • DisableDebugging
          • FindMessageLogs
          • GetGsmDiagnostic
        • Monitoring
          • GetActualMeterReads
          • GetActualMeterReadsResponse
          • GetActualMeterReadsGas
          • GetActualMeterReadsGasResponse
          • GetPeriodicMeterReads
          • GetPeriodicMeterReadsResponse
          • GetPeriodicMeterReadsGas
          • GetPeriodicMeterReadsGasResponse
          • GetProfileGenericData
          • GetProfileGenericDataResponse
          • ReadAlarmRegister
          • GetReadAlarmRegisterResponse
          • RetrievePushNotificationAlarm
        • Notification
          • SendNotification
      • ResponseMessages
      • Use cases
    • Guidelines to add a new domain to GXF
  • Protocols
    • IEC61850
      • SWDevice-010805
        • SWDevice-010805.icd
        • RegisterDevice
        • GetConfiguration
        • SetConfiguration
        • SetEventNotifications
        • EventNotification
        • SetSchedule
        • GetFirmwareVersion
        • UpdateFirmware
        • SetReboot
        • StartSelfTest
        • StopSelfTest
        • SetLight
        • SetTransition
        • GetStatus
        • UpdateDeviceSslCertification
      • FlexOVL_540_171101_2
        • FlexOVL_540_171101_2_out.icd
        • GetStatus
        • EventNotification
    • DLMS / COSEM
      • DLMS protocol adapter configuration
      • DLMS device simulator
    • OSLP
      • OSLP v0.5.1
        • Protobuf Contract
      • OSLP v0.6.1
        • Protobuf Contract
        • RegisterDevice
        • ConfirmRegisterDevice
        • GetConfiguration
        • SetConfiguration
        • SetEventNotifications
        • EventNotification
        • SetSchedule
        • ResumeSchedule
        • GetFirmwareVersion
        • UpdateFirmware
        • SetReboot
        • StartSelfTest
        • StopSelfTest
        • SetLight
        • SetTransition
        • GetStatus
        • UpdateDeviceSslCertification
        • SetDeviceVerificationKey
        • SwitchFirmware
        • SwitchConfiguration
    • MQTT
  • Support
  • License
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. Protocols
  2. IEC61850

SWDevice-010805

PreviousIEC61850NextSWDevice-010805.icd

Last updated 1 year ago

Was this helpful?

Contract for The contract specifies the messages which can be exchanged with an SSLD.

Messages

The messages below are part of OSGP and implemented in the IEC61850 protocol adapter and supported by the SWDevice-010805 device firmware.

  • (from device to platform) is a request that notifies the platform a device wants to register. During the registration the device sends its identification (serial number), and the device communicates its IP address to the platform.

  • (from platform to device) is a response which informs the device that the registration was successful. The device will not register anymore, until the next power cycle or reboot.

  • (from platform to device) is a request which commands a device to switch all light relays on.

  • (from device to platform) is a response which returns the result of the StartSelfTestRequest.

  • (from platform to device) is a request which commands a device to switch all light relays off.

  • (from device to platform) is a response which returns the result of the StopSelfTestRequest.

  • (from platform to device) is a request which commands a device to reboot immediately.

  • (from device to platform) is a response which returns the result of the SetRebootRequest.

  • (from platform to device) is a request which commands a device to switch on or off one ore several light relays.

  • (from device to platform) is a response which returns the result of the SetLightRequest.

  • (from platform to device) is a request which commands a device to switch its light relays according to light measurement schedule-entries.

  • (from device to platform) is a response which returns the result of the SetTransitionRequest.

  • (from platform to device) is a request which commands a device to set the event notification mask.

  • (from device to platform) is a response which returns the result of the SetEventNotificationsRequest.

  • (from platform to device) is a request which queries a device for the current status of all its relays, the type of configuration (RELAY for SSLD), and the event notification mask set on the device.

  • (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 relays and other information.

  • (from platform to device) is a request which queries a device for its current firmware version.

  • (from device to platform) is a response which returns the result of the GetFirmwareVersionRequest and, if 'result = OK', returns the current firmware version.

  • (from platform to device) is a request which commands a device to download a new firmware version from a server using a URL.

  • (from device to platform) is a response which returns the result of the UpdateFirmwareRequest, which indicates if the device will start the process to download and install a new firmware version. Please note there are several events which are sent from the device to the platform to inform the platform when the firmware has been downloaded and whether or not the firmware was successfully activated.

  • (from platform to device) is a request which queries a device for its current configuration settings.

  • (from device to platform) is a response which returns the result of the GetConfigurationRequest and, if 'result = OK', returns the configuration settings retrieved from the device.

  • (from platform to device) is a request which commands a device to update its configuration.

  • (from device to platform) is a response which returns the result of the SetConfigurationRequest.

  • (from platform to device) is a request which commands a device to update its light or tariff schedule.

  • (from device to platform) is a response which returns the result of the SetScheduleRequest.

  • (from platform to device) is a request which commands a device to download a new certificate file from a server using a URL.

  • (from platform to device) is a response which returns the result of the UpdateDeviceSslCertificationRequest, which indicates if the device will start the process to download and install a new certificate file. Please note there are several events which are sent from the device to the platform to inform the platform whether or not the certificate file was successfully downloaded and activated.

  • (from device to platform) is a request that pushes an event notification from a device to the platform.

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

SWDevice-010805
RegisterDeviceRequest
RegisterDeviceResponse
StartSelfTestRequest
StartSelfTestResponse
StopSelfTestRequest
StopSelfTestResponse
SetRebootRequest
SetRebootResponse
SetLightRequest
SetLightResponse
SetTransitionRequest
SetTransitionResponse
SetEventNotificationsRequest
SetEventNotificationsResponse
GetStatusRequest
GetStatusResponse
GetFirmwareVersionRequest
GetFirmwareVersionResponse
UpdateFirmwareRequest
UpdateFirmwareResponse
GetConfigurationRequest
GetConfigurationResponse
SetConfigurationRequest
SetConfigurationResponse
SetScheduleRequest
SetScheduleResponse
UpdateDeviceSslCertificationRequest
UpdateDeviceSslCertificationResponse
EventNotificationRequest