YamlCardSupervision

Card type cardSupervison and cardSupervison2

The card type cardSupervision and cardSupervison3 can be used to supervise the values of items in an openHAB Group. If the value of items in the group reaches a specific value or if an items don't send a value for a specific time, the cards shows them in a list.

Note: The cardSupervision2 is based on cardSchedule type and is only supported in ticaki/ioBroker.nspanel-lovelace-ui for EU panels.

Card attributes:

card attribute	default value	optional / Mandetory	Description
ohGroup	-	M	Name of the openHAB Group item which should be supervised by the card
value	-	M	Value item or value group which is used for comparision (see Group of values vs. single values)
mode	timeout	O	Supervsion modes (see Supported modes)
icon	shield-check	O	Icon which is shown for items in the group which are reaching the supervision value
iconColor	red	O	Color of the icon
result	None	O	Optional result item in openHAB. In case the result item is of type Number or String it is set to the number of items which match the supervision mode. If the result item is of type Switch or Contact the result item is activated if there is at least one item in the supervised group is matching supervison criteria.

Supported modes:

mode	description
"timeout"	Items are supervised by timeout. When an item does not send a value during th timeout period it is shown in th list. The timeout value is specified in minutes. (see Mode timeout)
"=="	Item is equal to the given value
"!="	Item is not equal to the given value
"<"	Item is smaller than the given value
"<="	Item is smaller or equal to the given value
">"	Item is bigger than the given value
">="	Item is bigger or equal to the given value

Group of values vs. single values

If a single openHAB item of type String, Number etc. is used for the value attribute, all items in the ohGroup are compared to this value based on the selected mode. In case of mode timeout the value is used as timeout value. If an openHAB Group is defined for the value attribute, the value with the same label as the item label is used for comparition.

Example openHAB groups:

Group Moisture
Group Thresholds

//Plant moisture measurement items:
Number M_Plant_A "01. Kaktus" (Moisture)
Number M_Plant_B "02. Monstera" (Moisture)

//Plant moisture threshold values:
Dimmer TH_Plant_A "01. Kaktus" (Thresholds)
Dimmer TH_Plant_B "02. Monstera" (Thresholds)

//Result item
Number NSPanelPlantCheckResult "Number of dry plants"

Example card yaml for this setup:

cards:
  - name: PlantSupervsion
    title: Dry plants
    type: cardSupervision
    ohGroup: Moisture
    values: Thresholds
    result: NSPanelPlantCheckResult
    mode: "<="
    icon: palm-tree
    iconColor: yellow

In this configuration the card shows the M_Plan_A item, when the state is smaller or equal to the value of TH_Plant_A, because M_Plant_A has the same label ("01. Kaktus") as TH_Plant_A.

As cardSupervision:

As cardSupervision2:

Mode timeout

The timeout supervision mode can be used to supervise when an item got the last update. This is useful for battery driven devices to check if they are still alive or dead because of a drained battery. You can add all the battery state items to a group and supervise them with a longer timeout. For zigbee devices a timeout of 900 minutes or longer must be used to check if they are still alive.

Example card yaml for a timeout supervision:

cards:
  - name: BatterySupervsion
    title: Battery check
    type: cardSupervision
    ohGroup: gBattery
    values: NSPanelBatteryTimeout
    mode: "timeout"
    icon: battery-remove
    iconColor: red