Differences

This shows you the differences between two versions of the page.

--- ezeio2:expref:ds [2019-08-29 15:16] – andreh
+++ ezeio2:expref:ds [2020-09-18 17:10] – [ds( deviceno, subject )] andreh
@@ Line 1: / Line 1: @@
-===== Expressions ======
+===== Device Status ======
 ==== ds( deviceno, subject ) ====
@@ Line 9: / Line 9: @@
 <code>ds( deviceno, subject )</code>
-This function returns the current status of a device.
+This function returns the current status of a device or the aggregate status of all devices.
 === Parameters ===
-| ''deviceno'' | Device number (1 - 40) |
+| ''deviceno'' | Device number (1 - 40). If 0 (zero), the function returns the aggregate status of ALL devices.|
 | ''subject'' | Subject to request (see below) |
+^ Subject ^ Description ^
+| DVCSTAT_BATTVOLT | Battery/supply voltage in mV |
+| DVCSTAT_SIGNAL | Signal level, typically 0-100% |
+| DVCSTAT_COMMCOUNT | Comm count, typically count of valid messages |
+| DVCSTAT_COMMERR | Comm error count, typically number of failed communication attempts |
+| DVCSTAT_LASTCOMM | Last comm, EPOCH timestamp of last successful communication |
+| DVCSTAT_COMMSTAT | Device communication status (0-7, where 0=unknown, 1=error, 2,3,4=warning, 5,6,7=ideal) |
+| DVCSTAT_OPSTAT | Device operational status (0-3, where 0=unknown, 1=error, 2=warning, 3=nominal) |
+| DVCSTAT_APPSTAT | Device application status (0-7, where 0=unknown, 1=error, 2,3,4=warning, 5,6,7=nominal) |
+| DVCSTAT_STAT | Aggregated status (0-3, 0=unknown, 1=error, 2=warning, 3=ok) |
 === Return value ===