Logging¶
The SDK logging interface is defined in SDK/src/ISLogger.h. Data logs can be converted between file formats using the Inertial Sense data logger. The logging interface is used in the Inertial Sense software described below.
Logging using Inertial Sense software¶
EvalTool¶
- Go to “Data Logs” tab in EvalTool.
- Select the “Format” file type from the drop-down menu.
- Select the data to record within the Data Streams section of the "Data Logs" tab:
- Manual Selection – Allows the user to select the specific datasets to stream and their update rates by setting the checkbox and period multiple in Manual Selection table.
- INS – Log INS output (attitude, velocity, position) at 100 Hz by selecting "INS" from the RMC Presets dropdown.
- Post Process – Used for beta testing and internal testing. Includes IMU, GPS, INS and other messages. Log by selecting "PPD" from the RMC Presets dropdown.
- Press “Enable” to begin logging data.
- Press “Disable” to stop logging data.
- The “Open Folder” button opens the File Explorer location to the data logs, i.e.
C:\Users\[username]\Documents\Inertial_Sense\logs
. - To change the root log folder in the Eval Tool, edit
Documents/Inertial Sense/settings.json
, and add or change the logger key: "Directory": "FOLDER_FOR_LOGS".
CLTool¶
The CLTool, provided in the SDK, is a command line application that can record post process data. The CLTool help menu is displayed using the option -h
. See the CLTool section for more information on using the CLTool.
Post Process Data (PPD) Logging Instructions¶
Post process data (PPD) logs include both the input to and output from the navigation filter. The data is used for analyzing, troubleshooting, and improving system performance. PPD logs can be recorded using the EvalTool, CLTool, or SDK.
PPD RMC bits Preset¶
PPD logs are created by enabling PPD data streaming by setting the RMC bits to RMC_PRESET_IMX_PPD
and logging this stream to a .dat binary file. RMC_PRESET_IMX_PPD
is defined in data_sets.h.
Logging PPD in EvalTool¶
The following steps outline how to record post process data in the EvalTool
- Go to the "Data Logs" tab in the EvalTool.
- Press the "Data Log: PPD Log" button to start logging.
- Toggle the "Data Log: Disable" button to stop logging.
- The "Open Folder" button will open the directory where the data logs are stored.
Logging PPD in CLTool¶
Streaming and logging a PPD log using the CLTool is done using the -presetPPD -lon
options:
cltool -c /dev/ttyS2 -presetPPD -lon