==== GetDeviceStatus ====

Fetch the Comm / Op / App status of a given device (or aggregate status)

=== Description ===

<code>GetDeviceStatus( deviceno, status item )</code>

Returns the given status item for.

=== Parameters ===

| ''deviceno'' | Device number to request status from (or 0 for all devices) |
| ''status item'' | The status item to return (see below) |

^ Parameter ^ Description ^ Aggregate ^
| ''DVCSTAT_BATTVOLT'' | The device battery/supply voltage in mV (if supported) | YES | 
| ''DVCSTAT_SIGNAL'' | The reported device signal strength | YES |
| ''DVCSTAT_COMMCOUNT'' | Number of successful comm attempts | NO |
| ''DVCSTAT_COMMERR'' | Number of failed comm attempts | NO |
| ''DVCSTAT_LASTCOMM'' | Time of last status update | NO | 
| ''DVCSTAT_COMMSTAT'' | Communication status, one of: \\ DS_COM_UNKNOWN \\ DS_COM_ERROR \\ DS_COM_ISSUE \\ DS_COM_OK \\ DS_COM_BEST | YES |
| ''DVCSTAT_OPSTAT'' | Operational status, one of: \\ DS_OP_UNKNOWN \\ DS_OP_ERROR \\ DS_OP_PART \\ DS_OP_FULL | YES |
| ''DVCSTAT_APPSTAT'' | Application status, one of: \\ DS_APP_UNKNOWN \\ DS_APP_ERROR \\ DS_APP_WARNING \\ DS_APP_OK \\ DS_APP_OK1 \\ DS_APP_OK2 \\ DS_APP_OK3 \\ DS_APP_OK4 | YES |
| ''DVCSTAT_STAT'' | Aggregated status, one of: (read only) \\ DS_UNKNOWN \\ DS_ERROR \\ DS_WARNING \\ DS_OK | YES |
| ''DVCSTAT_ACTIVE'' | Returns 1 if device is loaded/active (read only) | NO | 
| ''DVCSTAT_REGCOUNT'' | Number of registers allocated (read only) | NO | 
| ''DVCSTAT_TYPE'' | Driver id number | NO | 
| ''DVCSTAT_VERSION'' | Driver version | NO | 
| ''DVCSTAT_MODE'' | User defined mode | NO | 
| ''DVCSTAT_PARAM'' | User defined parameter | NO | 

//DVCSTAT_ACTIVE, _REGCOUNT, _TYPE, _VERSION, _MODE and _PARAM are available in firmware 21061101 and newer//

=== Return value ===

Depends on parameter requested. See above.

=== Example usage ===

<code javascript>   
   if( GetDeviceStatus(0, DVCSTAT_STAT) < DS_OK ) {  // Get 'worst' status from all devices
      // DEVICE ERROR DETECTED -- SHUT OFF PROCESS
      SetOutput(1, 0);
   }   
</code>