Grid eXchange Fabric Documentation

  Fix This Page

Tariff switching

This covers the services for tariff switching domain using the open smart grid platform.


This domain allows tariff switching. It allows a relay to switch when a tariff changes. This domain could be used to replace ripple control tariff signals.


Operation Request Response
GetStatus DeviceIdentification Status
SetSchedule DeviceIdentification, Schedules, Page -


When configuring a device via the platform to switch relays according to a tariff schedule, the device can be instructed to switch the tariff relay normally ("TARIFF") or reversed ("TARIFF_REVERSED").

The devices themselves are unaware of the difference between TARIFF and TARIFF_REVERSED. When sending a setScheduleRequest message for a tariff schedule to the platform, the tariff switching domain adapter checks if the device relay(s) are configured with TARIFF_REVERSED. If so, the tariff switching domain adapter will invert the relay value for all tariff schedule entries before the tariff schedule is sent to the device.

When two devices have the same schedule, while one device is using TARIFF and the other TARIFF_REVERSED, the state of their tariff relays will always be the opposite of each other.

Communicated/Stored values

The values as shown in the table below will be returned, when getting the status from a device or from the platform.

Type State Relay powered Returned by Device Returned by Platform
TARIFF LOW yes on = true High = false
HIGH no on = false High = true
TARIFF_REVERSED LOW no on = false High = false
HIGH yes on = true High = true