Light
The Light control is used to display and control the brightness of a light source.
![Light 1:](Images/png/18014409241237771__Web.png)
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.
![Light 2:](Images/png/10731757707__Web.png)
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.
![Light 3:](Images/png/18014409241243531__Web.png)
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
To use the generic functionalities of TcHmiBa. It links a single object or a complete view (including children) to the control.
![]() | You can find more detailed information about the generic possibilities of TcHmiBa under Generic HMI. |
![Light 5:](Images/png/12117788939__Web.png)
![Light 6:](Images/png/9007211372531851__Web.png)
![Light 7:](Images/png/9007211373557771__Web.png)
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.
![Light 11:](Images/png/16578690443__Web.png)
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
Allows editing the BaInterfaceSymbolNames.
![]() | The default values of BaInterfaceSymbolNames, as well as the expected data types can be found in the tooltip of the dialog for setting BaInterfaceSymbolNames: |
![]() | Here is described how the BaInterfaceSymbolNames are overwritten by all controls of a type. |
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. |