Single Value Mode

Single Value Mode displays a single numeric value with various visual representations and optional animations.

Basic Settings

Setting	Description
Read only mode	When enabled, value only changes via datasource. When disabled, value can change via commands
Minimum Value	Lower bound of the value range
Maximum Value	Upper bound of the value range
Default Value	Initial value when no datasource is bound (Only visible when Read only mode is OFF)
Default step value	Amount to increase/decrease by default (Only visible when Read only mode is OFF)
Reset at maximum	When enabled, value resets to minimum when maximum is reached (Only when Read only is OFF)

Appearance Options

Single Value Mode offers five appearance styles:

Appearance	Description
Number	Numeric display with animation options
Progressbar	Linear, vertical, or circular progress indicators
Color	Color-changing background based on value
Gauge	Speedometer-style dial indicator
Characters	Text or icon-based visual representation

Datasource

The widget can:

1. Read values from bound data sources
2. Write values back to data sources (if the read only mode is disabled and if in displayer)
3. Support both simple values and complex objects with value and config properties

Expects a single numeric value or an object with:

Property	Type	Required	Description
value	number	Yes	The current value
config.min	number	No	Overrides minimum setting
config.max	number	No	Overrides maximum setting
config.defaultValue	number	No	Default value
config.defaultStep	number	No	Step increment

Data structure example:

{
    value: 10,
    config: {
        min: 0,
        max: 100,
        defaultValue: 0,
        defaultStep: 1
    }
}

External messages

Command	Parameters	Description
Increase by	value: number (optional)	Add to current value. Uses default step if not specified
Decrease by	value: number (optional)	Subtract from current value. Uses default step if not specified
Set value to	value: number (required)	Set to exact value
Reset value	none	Reset to default value
Settings to dataSource	none	Export config to datasource
Set to random	none	Set to random value in range

Sensor Events

Event Name	Payload	Trigger
ReachedMaximum	max value	Value reaches maximum
ReachedMinimum	min value	Value reaches minimum
Increased	current value	Value was increased
Decreased	current value	Value was decreased
Data source changed	current value	Value updated to datasource

Usage Notes

• Commands are only processed in Displayer Mode
• Commands sent to widgets with Read only mode enabled will only work for datasource-related operations
• The Settings to dataSource command exports the current configuration for external processing or for ease of re-use