diff --git a/source/_lovelace/guage.markdown b/source/_lovelace/guage.markdown new file mode 100644 index 00000000000..4e586391ebe --- /dev/null +++ b/source/_lovelace/guage.markdown @@ -0,0 +1,101 @@ +--- +layout: page +title: "Gauge Card" +sidebar_label: Gauge +description: "The Gauge card allows you to display sensor information visually" +date: 2018-10-11 10:28 +00:00 +sidebar: true +comments: false +sharing: true +footer: true +--- + +Gauge card is a basic card that allows visually seeing sensor data + +

+Screenshot of the gauge card +Screenshot of the gauge card. +

+ +{% configuration %} +type: + required: true + description: gauge + type: string +entity: + required: true + description: "Numerical Entity to show" + type: string +title: + required: false + description: Title of Gauge Data + type: string +unit_of_measurement: + required: false + description: Unit of Measurement given to data + type: string + default: "Unit Of Measurement given by Entity" +min: + required: false + description: Minimum value for graph + type: number + default: 0 +max: + required: false + description: Maximum value for graph + type: number + default: 100 +severity: + required: false + description: Allows setting of colors for different numbers + type: object +{% endconfiguration %} + +## {% linkable_title Severity Variables %} + +If you define the severity object, these are the required options: + +{% configuration %} +green: + required: true + description: Value from which to start green color + type: number +yellow: + required: true + description: Value from which to start yellow color + type: number +red: + required: true + description: Value from which to start red color + type: number +{% endconfiguration %} + +## {% linkable_title Examples %} + +Basic example: + +```yaml +- type: gauge + title: CPU Usuage + unit_of_measurement: % + entity: sensor.cpu_usuage +``` + +

+Screenshot of the gauge card with custom title and unit of measurement +Screenshot of the gauge card with custom title and unit of measurement. +

+ +Define severity object: + +```yaml +- type: gauge + title: With Severity + title: CPU Usuage + unit_of_measurement: % + entity: sensor.cpu_usuage + severity: + green: 0 + yellow: 45 + red: 85 +``` diff --git a/source/images/lovelace/lovelace_gauge_card.gif b/source/images/lovelace/lovelace_gauge_card.gif new file mode 100644 index 00000000000..7ba68a90d2c Binary files /dev/null and b/source/images/lovelace/lovelace_gauge_card.gif differ