Smart Lighting Controller Data Objects

The Rachio Smart Lighting Controller API supports interaction with:

  • LightingAreas: A top level container for all Smart Lighting Controllers at a given address
  • LightingControllers: Rachio Smart Lighting Controllers
  • LightingZones: A lighting zone on a Smart Lighting Controller
  • LightingZoneGroups: A group of lighting zones
  • LightingScenes: A set of saved lighting zone settings
  • LightingPrograms: Schedules created for a Smart Lighting Controller are called LightingPrograms

A typical development flow consists of:

  • Obtain your user ID (which is equivalent to the Controller API Person ID)
  • ListLightingAreas for that user
  • ListLightingControllers for a given lighting area
  • ListLightingZones for a given lighting controller, area, zone group, or scene
  • Control zones directly with SetLightingZoneStates and SetLightingZoneDimmingLevels
  • Create scenes and set them with ActivateLightingScene and DeactivateLightingScene
  • Create lighting programs against zones, groups, or scenes to automate your smart lighting

Important notes

We support multiple Smart Lighting Controllers at a given lighting area (address) which means scenes, groups, and programs can be created against any combination of lighting zones.

Zone groups can be used as an easier way to create a program against of set of zones. In addition, scenes can be created and programmed to automate dimming changes.

A program can be created against zones, zone groups, or scenes, but not multiple.