Report; Reset; Context Preservation; Startup Banner - M-Labs APOLLO series User Manual

39. AT+IONUC: Update configuration files OTA
40. AT+IONVO: Virtual Odometer
41. AT+IONVTO: Virtual Trip Odometer

4.5 Report

The Apollo series capture data and forms a report record with that data. This is a single
data structure intended to contain all of the typically useful data on the Apollo series. Other
information can be queried separately using separate AT commands.
Reports are generated following specified events such as periodic timeout, speed
threshold, geofence crossing, etc., or in response to a Report Now command .
Reports are generated regardless of whether or not there is a GPS lock. If no lock has ever
been attained since hardware reset, default values of 0 are returned for all GPS fields. If a
lock has been attained and lost, the report will contain the last valid GPS data including the
timestamp of that data.
Base Requirements：
1. A report is generated in response to either an interrupt event or in response to
execution of associated AT commands explicitly requesting one.
2. GPS coordinates are stored in reports as signed hex values to save space.
3. To reduce data transmission costs, the data within a report record can be masked
and removed before it is transmitted.
4. Every report has a tag and each enabled interrupt or event generates a separate
report. The report tags indicate the cause of the generated report, which can be an
interrupt, an event or in response to a command.

4.6 Reset

There are two types of resets supported; soft reset which restarts the main application without
performing a power cycle and hard reset that occurs from a power event triggered by power
failure or system watchdog.

4.6.1 Context Preservation

When a reset is caused by the Network Watchdog or by the Reset command (modes 0,1), the
context of the system is being preserved and is restored after the reset. The context includes
all the periodic timers, the report queue, the odometer, etc. This allows to reset the unit as a
troubleshooting measure either periodically or due to Network Watchdog without losing reports
that are already in the queue or are pending on running timers. Note that the reset process
may cause 1-2min of inaccuracy in the timers and should not be considered as very precise.
Modes 8/9 of the IONRS command perform soft and hard reset respectively without preserving
any context. Factory reset (IONFR) also does not preserve any context of the system.

4.7 Startup Banner

After a reset a startup banner is printed through the UART only. The format and content of
the banner shown below:
FW:<firmware version>; BIN:<bin version>; MEID/ESN:<MEID/ESN>
APN1:<apn1 name>; IP:<IP>:<port>;LPORT:<lport>
RI:<s,v,t>; DTE:<t1,t2,t3>; DI:<t>; HB:<t>; NR:<t,c,r>; RS:<a,t,r>