OSID Specifications
control package
Version 3.0.0
Release Candidate Preview
TitleControl Open Service Interface Definitions

The Control OSID manages control systems. A system is comprised o f Devices whose Controllers are the control points. Devices have various Input mechanisms to command the Controllers.


A Device represents some piece of visible equipment in a system. Example Devices are joysticks, yokes, and control panels.


A Controller is an Operable manages a specific responder in a system such as a model railroad gate, an airplane rudder, or the volume of a stereo. The management of a Controller includes on/off, variable amount values, or a set of States. A Controller is a black box. The Control OSID does not describe or manage system responders or how a Controller performs its tasks.


An Input is an OsidRelationship between a Device and a Controller. A yoke may have several Inputs. One Input for push-pull that commands the Controller for the elevator, another Input for turning that commands the Controller for the ailerons, and another Input that commands the Controller for enabling and disabling auto-pilot.


A Setting captures fixed setting values for a Controller. A Controller for a sound system volume may have a variable amount Setting for LOUD and another variable amount Setting for SOFT. Settings are the basic building blocks for Scenes.


A Scen e is a set of Settings. While a Setting is a value for a single Controller, Scenes apply values across a bunch of Controllers. Executing a movie theater Scene may set the light Controllers to dim values, close the curtains, and set the sound system vilume.


Triggers are OsidRules used to perform actions in response to a value or state change in a Controller. Triggers have two parts. One part of the Trigger is the event listening criteria (fan turned on, light changed brightness). The second part of a Trigger is the execution that is to be performed when the event criteria is true. The OsidRule may encapsulate more complex event criteria.

An example Trigger is when the motion sensor Controller is turned "on," the Trigger executes a Setting or a Scene that turns on the porch light.

Triggers may execute Scenes or Settings directly. This is the simpler approach but does not allow for other rules or conditionals not expressable by a set of critera. Triggers may also execute ActionGroups.

Actions and ActionGroups

ActionGroups are a set of Actions. Actions are OsidRules to be executed. Built-in rules execute Settings or Scenes. These OsidRules may reference other actions or behaviors not directly described in the Action.

Settings, Scenes, and Actions

A Setting is a single state or value for a specific Controller used to build Scenes but may also be directly executed by a Trigger or Action.

Scenes are a set of Settings used to set the state or values of multiple Controllers simultaneously and provide reusability of clusters of Settings.

ActionGroups may be used with Triggers to achieve the same effect as a Setting. The difference between a set of Actions and a Setting are the presence of rules in the Actions. These rules may determine which Actions within an ActionGroup apply at tha time within a context. As such, each evaluation across an ActionGroup may result in different sets of executed Actions unlike Scenes whose complete set of Settings are known up front and may be thought of as a multicast group.

System Cataloging

All Devices, Inputs, Controllers, Settings, Scenes, Triggers , and ActionGroups may be organized into federateable OsidCatalogs called Systems.

Sub Packages

The Control OSID includes a Control Rules OSID for managing rules amd a Control Batch OSID for managing Devices, Inputs, Controllers, Scenes, Settings, Triggers, and ActionGroups in bulk.