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/Symbol
Symbol 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.DisplayMode
Determines the display mode of the lamp.
Name | Presentation |
---|---|
lightBulb | |
lightBulbFilled | |
filles |
ShowValue
tchmi:general#/definitions/Boolean
If TRUE, the brightness value is displayed.

BaData
Priority
tchmi:framework#/definitions/TcHmi.BuildingAutomation.Controls.RoomAutomation.Light.Priority
The 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.BaInterfaceSymbolNames
Edit the BaInterfaceSymbolNames.
Brightness
tchmi:framework#/definitions/TcHmi.BuildingAutomation.NumberOrBoolean
Current brightness value (0-100%).
BrightnessFeedback
tchmi:framework#/definitions/TcHmi.BuildingAutomation.NumberOrBoolean
Feedback 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. |