Differences

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

--- ezeio2:scriptref:getsystemitem [2019-09-02 21:39] – andreh
+++ ezeio2:scriptref:getsystemitem [2025-02-11 23:18] (current) – andreh
@@ Line 19: / Line 19: @@
 | ''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_CELLINHIBIT'' | 0=normal operation. >0 cellular modem is off, remaining seconds |
 | ''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 |
@@ Line 34: / Line 34: @@
 | ''SYSITEM_SECOND'' | Real time clock, seconds |
 | ''SYSITEM_EPOCH'' | Real time clock, Epoch (number of seconds since 1970-01-01) |
-| ''SYSITEM_RND'' | Random number |
+| ''SYSITEM_RND'' | Random number. 32 bit signed integer |
+| ''SYSITEM_OUT3RCPWM'' | Output 3 mode (0=0-100%, 1=1-2ms servo) |
+| ''SYSITEM_RESETCAUSE'' | Cause of last hardware reset, bitmap or RESETCAUSE flags defined below |
+| ''SYSITEM_SCRIPT_RESETCAUSE'' | Cause of last script restart, current script (see below) |
+| ''SYSITEM_HIBERNATE'' | Nonzero if running as part of sleep cycle |
+| ''SYSITEM_EXPn'' | ezeio-CAN Expander status (0=no comm, 1=comm ok), where n=1 through 7 |
+== Flags returned by SYSITEM_RESETCAUSE ==
+^ constant ^ meaning ^
+| RESETCAUSE_EXT | Any external reset |
+| RESETCAUSE_POR | Board was powered on |
+| RESETCAUSE_BOR | Board detected brown-out (voltage dip) |
+| RESETCAUSE_BOR | Software caused the reset |
+| RESETCAUSE_WDOG | Internal watchdog caused the reset |
+| RESETCAUSE_HIB | Board woke up from hibernation |
+== Flags returned by SYSITEM_SCRIPT_RESETCAUSE ==
+^ constant ^ meaning ^
+| SCRIPT_BOOT | Script started due to board reset |
+| SCRIPT_ERROR | Script restarted due to script error |
+| SCRIPT_USER | Script restarted by user |
+| SCRIPT_CHANGE | Script restarted due to config change |
+| SCRIPT_BUTTON | Script restarted with hardware button |
 === Return value ===
@@ Line 46: / Line 68: @@
    x = GetSystemItem(SYSITEM_YEAR);
+   // x is now 2019 (as of this writing)
-   // x is not 2019 (as of this writing)
+   if( GetSystemItem( SYSITEM_RESETCAUSE ) & RESETCAUSE_HIB ) {
+     // this code will run if board came back from a hibernation cycle
+   }
 </code>