===== System Item ======

==== sys( subject ) ====

Return a system status value.

=== Description ===

<code>sys( subject )</code>

This function returns the current value of a system item.

=== Parameters ===

| ''subject'' | Subject to request (see below) |

^ Subject ^ Description ^
| SYSITEM_GPSX | Current GPS longitude in degrees x 10<sup>6</sup> |
| SYSITEM_GPSY | Current GPS latitude in degrees x 10<sup>6</sup> | 
| SYSITEM_GPSZ | Current GPS elevation in meter x 10 |
| SYSITEM_GPSSIGNAL | Current GPS reception signal |
| SYSITEM_GPSLOCK | 0 if GPS is not locked. 1 if locked. |
| SYSITEM_UPTIME | Number of seconds since last reset |
| SYSITEM_CELLINHIBIT | 0 if normal operation. >0 if cell modem is turned off |
| SYSITEM_RSSI | Cell modem RSSI (received signal), 1 (bad) to 31 (good) |
| SYSITEM_ETHLINK | 0 if no hardware link detected. 1 if ok |
| SYSITEM_ETHCONN | 0 if not connected via Ethernet. 1 if connected |
| SYSITEM_CELLCONN | 0 if not connected to cell network. 1 if connected |
| SYSITEM_YEAR | Current year (eg 2020) |
| SYSITEM_MONTH | Current month (1-12) |
| SYSITEM_DAY | Current day of the month (1-31) |
| SYSITEM_WDAY | Current weekday (0=Sunday, 6=Saturday) |
| SYSITEM_YDAY | Current day of the year |
| SYSITEM_HOUR | Current hour (0-23) |
| SYSITEM_MINUTE | Current minute (0-59) |
| SYSITEM_SECOND | Current second (0-59) |
| SYSITEM_EPOCH | Epoch time stamp (seconds since 1970-01-01 00:00:00 UTC |
| SYSITEM_RND | Random number 0-2<sup>32</sup> |
	
=== Return value ===

Returns the current status value of the subject requested.

=== Example usage ===

<code>sys(SYSITEM_MONTH)</code>
Returns the current month number.

<code>sys(SYSITEM_RND) % 47</code>
Returns random value between 0 and 46