Thermostat tile

The temperature and the set point, which a tap changes; a thermostat’s mode and state too.

In a dashboard file: "type": "thermostat", with the options below. Every tile also has the fields under Every tile.

Example

A tile, as it goes in a screen’s tiles:

{
    "type": "thermostat",
    "label": "Living room",
    "layout": { "x": 1, "y": 1, "width": 2, "height": 2 },
    "dataSource": { "connection": "demo", "params": { "device": "thermostat" } },
    "options": { "gauge": { "min": 15, "max": 25 } }
}

It reads the demo home: in a dashboard with the connection "demo": { "driver": "demo", "config": {} }, it works as it is. To read a device of your own, its data source names one of your connections, with the params of that connection’s driver (Connections and data sources).

It is set up one of two ways, each with its own options.

A thermostat

A device that is one: its temperature, set point, mode and state together.

Field	Type	Default	What
source	data source name	primary	Thermostat. One of the tile’s data sources, by name, that gives a thermostat.
numberFormat	number format	0.0	Number format. 0, 0.0, 0.## or #,##0.
gauge	object	{}	Gauge. The dial.
gauge.min	number	10	From.
gauge.max	number	30	To.
gauge.colors	gradient	blue-yellow-red	Gradient. A named one such as blue-yellow-red, or a list of colours. A look option: a tile style can set it.
gauge.thresholds	list	[]	Thresholds. A colour from a value on, such as green, yellow from 24, red from 27.
gauge.thresholds[].from	number	required	From. The value this colour starts at.
gauge.thresholds[].color	colour	required	Colour.
gauge.coloring	one of gradient, threshold (By thresholds), single (One colour)		Colouring. The gradient, the colour of the threshold the value is in, or one colour; by the thresholds where there are any, else one colour where one is set. A look option: a tile style can set it.
gauge.color	colour		Colour. The gauge’s one colour. A look option: a tile style can set it.
gauge.track	colour or none		Unfilled part. The part of the scale not filled. A look option: a tile style can set it.
gauge.look	object		Look. Thickness, steps, sweep and the like, where the style has them. A look option: a tile style can set it.
gauge.look.thickness	number, 1 to 50		Thickness. Of the arc, ring or bar, in percent of the gauge.
gauge.look.steps	whole number, 2 to 100		Steps. Ticks, blocks, cells or dots; the needle’s numbered ticks.
gauge.look.sweep	number, 90 to 360		Sweep. How far round a dial goes, in degrees.
gauge.look.roundEnds	true or false		Round ends.
gauge.look.vertical	true or false		Upright. A bar, cells or bullet standing up.
gauge.look.numbers	true or false		Numbers. On the scale, where the style has them.
gauge.look.accent	colour		Accent. The needle, the knob, the glow, the fill.
gauge.look.markSecond	true or false		Second on the scale. Marks the second value on the scale too, where it is on the same scale (a set point); the thermostat’s does, a value tile’s not unless set.

Separate values

A temperature and a set point from any source, such as a sensor and a relay.

Field	Type	Default	What
temperature	object	required	Temperature. The room’s temperature.
temperature.source	data source name	required	Temperature. One of the tile’s data sources, by name, that gives a number.
temperature.numberFormat	number format	0.0	Number format. 0, 0.0, 0.## or #,##0.
setpoint	object	required	Set point. The temperature asked for, which a tap changes.
setpoint.source	data source name	required	Set point. One of the tile’s data sources, by name, that gives a number.
setpoint.numberFormat	number format	0.0	Number format. 0, 0.0, 0.## or #,##0.
setpoint.unit	text	""	Unit. Shown after it.
setpoint.command	command name		Command. What sets it, of those its source takes; set_setpoint when left out.
mode	object		Mode. Heat, cool, …: shown with the set point, and changed in the card where it has a command.
mode.source	data source name	required	Mode. One of the tile’s data sources, by name, that gives a text.
mode.command	command name		Command. What changes it, of those its source takes; none to only show it.
gauge	object	{}	Gauge. The dial.
gauge.min	number	10	From.
gauge.max	number	30	To.
gauge.colors	gradient	blue-yellow-red	Gradient. A named one such as blue-yellow-red, or a list of colours. A look option: a tile style can set it.
gauge.thresholds	list	[]	Thresholds. A colour from a value on, such as green, yellow from 24, red from 27.
gauge.thresholds[].from	number	required	From. The value this colour starts at.
gauge.thresholds[].color	colour	required	Colour.
gauge.coloring	one of gradient, threshold (By thresholds), single (One colour)		Colouring. The gradient, the colour of the threshold the value is in, or one colour; by the thresholds where there are any, else one colour where one is set. A look option: a tile style can set it.
gauge.color	colour		Colour. The gauge’s one colour. A look option: a tile style can set it.
gauge.track	colour or none		Unfilled part. The part of the scale not filled. A look option: a tile style can set it.
gauge.look	object		Look. Thickness, steps, sweep and the like, where the style has them. A look option: a tile style can set it.
gauge.look.thickness	number, 1 to 50		Thickness. Of the arc, ring or bar, in percent of the gauge.
gauge.look.steps	whole number, 2 to 100		Steps. Ticks, blocks, cells or dots; the needle’s numbered ticks.
gauge.look.sweep	number, 90 to 360		Sweep. How far round a dial goes, in degrees.
gauge.look.roundEnds	true or false		Round ends.
gauge.look.vertical	true or false		Upright. A bar, cells or bullet standing up.
gauge.look.numbers	true or false		Numbers. On the scale, where the style has them.
gauge.look.accent	colour		Accent. The needle, the knob, the glow, the fill.
gauge.look.markSecond	true or false		Second on the scale. Marks the second value on the scale too, where it is on the same scale (a set point); the thermostat’s does, a value tile’s not unless set.

Built-in styles

The styles the app offers for it, after “The dashboard’s style”. Style files says what they set.

• Centred
• Left aligned
• Compact
• Icon at the left