Light
The Light control is used to display and control the brightness of a light source.

Use
Use on any page where controls are needed to control light sources.
Features
Priorities
Display of different priorities via the attribute Priority.
Brightness specification
The brightness can be adjusted using an analog (dimmable) or binary (switchable) value.
Buttons with predefined brightness values are available for dimmable lamps.

The display of these buttons can be set globally:
Operation
Clicking on the Light control changes the visibility of the menu for adjusting the brightness.

Attributes
The control inherits from BaseRoomControl and thus has the same attributes. In addition, there are the following attributes.
BA
BaObject
tchmi:framework#/definitions/SymbolSymbol for BaObject for using the generic functionalities of TcHmiBa. Links a single object or a complete view (including children) to the control.
![]() | The attribute is not applicable to all controls. |
Common
DisplayMode
tchmi:framework#/definitions/TcHmi.BuildingAutomation.Controls.RoomAutomation.Light.DisplayModeDetermines the display mode of the lamp.
Name | Presentation |
|---|---|
lightBulb |
|
lightBulbFilled |
|
filles |
|
ShowValue
tchmi:general#/definitions/BooleanIf TRUE, the brightness value is displayed.

BaData
Priority
tchmi:framework#/definitions/TcHmi.BuildingAutomation.Controls.RoomAutomation.Light.PriorityThe current priority displayed on the control. High priorities (low value in priority enumeration) deactivate the control's operating options.
Priority | Presentation |
|---|---|
fire |
|
communicationError |
|
burglaryAlarm |
|
maintenance |
|
cleaning |
|
nightWatch |
|
simple |
|
manual |
|
automaticLight |
|
scene1…scene3 |
|
![]() | The icons used for the various priorities can be set globally. |
BaInterfaceSymbolNames
tchmi:framework#/definitions/TcHmi.BuildingAutomation.Controls.Light.BaInterfaceSymbolNamesEdit the BaInterfaceSymbolNames.
Brightness
tchmi:framework#/definitions/TcHmi.BuildingAutomation.NumberOrBooleanCurrent brightness value (0-100%).
BrightnessFeedback
tchmi:framework#/definitions/TcHmi.BuildingAutomation.NumberOrBooleanFeedback for the brightness value (0-100%).
Events
Event | Description |
|---|---|
onBrightnessChanged | Triggered when the user changes the brightness. |
onHandModeReset | Triggered when the button for resetting from "hand" to automatic mode is pressed. |











