Description Class LightCtrlPanelRoom

INTENTION

This class provides all the definitions of entities concerning the control of the light in a room for which a user can enter a value using the control panel of a room. These are

• a possibility to choose the current light scene
• a possibility to choose the current ambient light level
• a possibility to switch on and off the window ceiling light
• a possibility to switch on and off the wall ceiling light
• a possibility to determine whether
  • the currently set ambient light level should be applied or
  • the currently settings of the window and wall ceiling light switches of the control panel should be applied
• a possibility to determine whether
  • the light scenes are enabled by the control panel, i.e. the currently chosen light scene should be applied or
  • the currently settings of the control panel concerning the ambient switch, the ceiling light switches, and the ambient light level should be applied.

If the light is controlled using the control panel the following cases are possible:

• A chosen light scene has to be established. This is the case if the value of lightSceneSwitch is 1.
• A set ambient light level has to be established. This is the case if the value of lightSceneSwitch is 0 and the value of ambientSwitch is 1.
• The two lights are set directly using the control panel. This is the case if the value of lightSceneSwitch is 0 and the value of ambientSwitch is 0.

These different cases are specified in the description class RoomLight.

Note that such a control panel does not exist up to now and has to be developed, too.

SIGNATURE

Object	chosenLightScene  :  EnteredValue(CHECKED_DOM  = STRING )

Intention	:	This object represents the light scene currently chosen by using the control panel. A light scene is identified by its name. Therefore, the entered value has to have the domain STRING.
Postreferences	:	msref RoomLight : M_RL5
		msref RoomLight : M_RL7

Object	ambLightLev  :  EnteredValue(CHECKED_DOM  =  LIGHT_VALUES)

Intention	:	This object represents the value defined for the ambient light level by using the control panel. The entered value has to be an element of the domain LIGHT_VALUES. Note that this setting is only relevant if the light is not controlled manually using the push buttons.
Postreferences	:	msref RoomLight : M_RL12
		msref RoomLight : M_RL14

Object	winCeilLightSwitch  :  EnteredValue(CHECKED_DOM  =  BINARY)

Intention	:	This object represents the value defined for the window ceiling light by using the control panel. winCeilLightSwitch.checked = 1 means that the window ceiling light should be on. winCeilLightSwitch.checked = 0 means that the window ceiling light should be off. Note that this setting is only relevant if the light is not controlled manually using the push buttons.
Postreferences	:	msref RoomLight : M_RL10

Object	wallCeilLightSwitch  :  EnteredValue(CHECKED_DOM  =  BINARY)

Intention	:	This object represents the value defined for the wall ceiling light by using the control panel. wallCeilLightSwitch.checked = 1 means that the wall ceiling light should be on. wallCeilLightSwitch.checked = 0 means that the wall ceiling light should be off. Note that this setting is only relevant if the light is not controlled manually using the push buttons.
Postreferences	:	msref RoomLight : M_RL10

Object	ambientSwitch  :  EnteredValue(CHECKED_DOM  =  BINARY)

Intention	:	This object represents the value that indicates whether the currently set ambient light level (ambLightLev) should be applied (this is the case for ambientSwitch.checked = 1) or the currently settings of the window and wall ceiling light switches of the control panel should be applied (this is the case for ambientSwitch.checked = 0). Note that this setting is only relevant if the light is not controlled manually using the push buttons.
Postreferences	:	msref RoomLight : M_RL4
		msref RoomLight : M_RL9
		msref RoomLight : M_RL10

Object	lightSceneSwitch  :  EnteredValue(CHECKED_DOM  =  BINARY)

Intention	:	This object represents the value that indicates whether the light scenes are enabled by the control panel, i.e. the currently chosen light scene should be applied (this is the case for lightSceneSwitch = 1) or the currently settings of the control panel concerning the ambient switch (ambientSwitch), the ceiling light switches (winCeilLightSwitch, winCeilLightSwitch), and the ambient light level (ambLightLev) should be applied (this is the case for lightSceneSwitch = 0). Note that this setting is only relevant if the light is not controlled manually using the push buttons.
Postreferences	:	msref RoomLight : M_RL4
		msref RoomLight : M_RL8
		msref RoomLight : M_RL9
		msref RoomLight : M_RL10

REQUIREMENT SPECIFICATIONS

Property	R_LCP1

NonFormal

:

The control panel should be easy and intuitive to use.