This is an old revision of the document!
GetSystemItem
Fetch the value of a given system parameter
Description
GetSystemItem( item )
Returns the value of a given system parameter
Parameters
item | The system item to return (see below) |
Parameter | Description |
---|---|
SYSITEM_GPSX | GPS latitude in degrees x 106 |
SYSITEM_GPSY | GPS longitude in degrees x 106 |
SYSITEM_GPSZ | GPS elevation in meters x 10 |
SYSITEM_GPSSIGNAL | Received signal level from GPS |
SYSITEM_UPTIME | Number of seconds since last restart |
SYSITEM_CELLINHIBIT | 0=normal operation. 1=cellular modem is off |
SYSITEM_RSSI | Received signal level for cellular modem (0=no signal. 31=max signal strength) |
SYSITEM_ETHLINK | 0=No Ethernet connection. 1=Ethernet connection detected |
SYSITEM_ETHCONN | 0=Not using Ethernet connection. 1=Using Ethernet connection |
SYSITEM_CELLCONN | 0=Not using cellular connection. 1=Using cellular connection |
SYSITEM_GPSLOCK | 0=No current GPS position. 1=GPS position current |
SYSITEM_YEAR | Real time clock, year |
SYSITEM_MONTH | Real time clock, month |
SYSITEM_DAY | Real time clock, day |
SYSITEM_WDAY | Real time clock, weekday (0=Sunday, 6=Saturday) |
SYSITEM_YDAY | Real time clock, day of year |
SYSITEM_HOUR | Real time clock, hour |
SYSITEM_MINUTE | Real time clock, minutes |
SYSITEM_SECOND | Real time clock, seconds |
SYSITEM_EPOCH | Real time clock, Epoch (number of seconds since 1970-01-01) |
SYSITEM_RND | Random number |
Return value
Depends on parameter requested. See above.
Example usage
new x; x = GetSystemItem(SYSITEM_YEAR); // x is now 2019 (as of this writing)