Grid eXchange Fabric Documentation

  Fix This Page

SetTransition

Description

Request which informs a device of a daylight transiton: it has become dark (sunset) or light (sunrise). The device will switch the relays, which have schedule entries for transition messages. The optional 'time' value can be used to indicate a switch time. If the optional 'time' value is omitted the device should switch immediately. See light schedule-entry for more information regarding switch schedules.

Response communicates status.

Message definitions

message SetTransitionRequest {
    required TransitionType transitionType = 1; // Night-Day or Day-Night transition
    optional string time = 2; // [(nanopb).max_size = 7]; // - format hhmmss UTC
}

message SetTransitionResponse {
    required Status status = 1;
}

Data types

enum TransitionType {
    NIGHT_DAY = 0;
    DAY_NIGHT = 1;
}

enum Status {
    OK = 0;
    FAILURE = 1; // general failure
    REJECTED = 2; // request received in wrong state
}

Example

Soap requests and responses sent to and from platform:


   
      LianderNetManagement
      liander gebruiker
      SoapUI
   
   
      
         device-01
         NIGHT_DAY
         
         07:55:01
      
   



   
   
      
         
            LianderNetManagement|||device-01|||20160106155501582
            device-01
         
      
   



   
      LianderNetManagement
      liander gebruiker
      SoapUI
   
   
      
         
            LianderNetManagement|||device-01|||20160106155501582
            device-01
         
      
   



   
   
      
         OK
      
   

OSLP SetTransitionRequest sent to 'device-01':

setTransitionRequest {
  transitionType: NIGHT_DAY
  time: "075501"
}

OSLP SetTransitionResponse sent to platform:

setTransitionResponse {
  status: OK
}