EvalTool¶
Overview¶
The EvalTool (Evaluation Tool) is a desktop GUI application that allows you to explore and test functionality of the Inertial Sense products in real-time. It has scrolling plots, 3D model representation, table views of all data, data logger, and firmware updating interface for the IMX, uAHRS, or uIMU. The EvalTool can simultaneously interface with multiple Inertial Sense devices.
Download and Install¶
The EvalTool Windows desktop app installer (.exe) can be downloaded from the Inertial Sense releases page.
Getting Started¶
With a device connected to your computer:
- Connect your INS to your computer using directions in the getting started section of this guide
- Open the “Settings” tab -> "Serial Ports" tab
- Click, “Find Devices”
- Ensure that the checkbox under “Open” is selected for your unit
- Wait until the box under “Port” turns green and shows a com-port number
- You can select a specific baud-rate for data transmission on this same tab. This is done in the drop-down menu shown at the top-middle of the page.
Data Logging Steps¶
In order to log data from your INS device, follow the steps listed below:
- Make sure your unit is connected to the EvalTool and the port is open.
- Open the “Data Logs” tab.
- Select “Open Folder” to verify that the log will be saved in your desired location.
- Change the selection in “Format:” to your desired file format (.dat .csv .sdat etc..)
- Change the selection in “Data Streams” to the data that you would like collected.
- Press “Enable” in "Data Log" when you are ready to record the data.
- The data you are currently recording will be shown in the “Log Summary” sub-tab.
- When you are finished recording data, press “Disable”. Your data will be saved in the location shown in “Open Folder”.
Info Bar¶
The Info Bar can be seen from any tab and shows basic connection information for the unit selected.
- Link Status - Shows Packets being Transmitted and Received. counts to 99 then resets to 0.
- Error Message - Shows error messages for the selected unit. The kinds of messages vary from data packets lost to system had a reset.
- RTK Base Messages - The number in this field will increment as your rover unit continues to receive RTK messages from your base station. Use this field as the main signifier that RTK messages are coming through.
- Currently selected unit - The unit with the serial number shown here will have its live data shown on each tab in EvalTool.
Update Firmware¶
- Enter the Settings tab.
- Open the COM ports of the units you would like to update. 1. If the units don't open up, you may have to change the baud rate.
- Click "Update Firmware".
- Choose the firmware file by clicking on the ellipsis (three dots) button next to the file name and navigating to the directory where your .hex file is located. Select it and press "Open".
- Repeat for the bootloader .bin file or check the bootloader update "Skip" checkbox. The bootloader will only be updated if the unit has an older bootloader than the file provided.
- Click "Start".
- Wait for the firmware to fully load or your units will enter into "bootloader mode" and you will have to reload the firmware again.
- After completion, click "Done".
*Note: The firmware can only be updated at the following baud rates: 300000, 921600, 460800, 230400, 115200.
Tab Descriptions¶
INS Tab¶
- Attitude Plot and Table - shows the Roll, Pitch, and Yaw values of the selected unit. Hover the cursor of the radio buttons to see more descriptions.
- Velocity Plot and Table - U,V,W velocities.
- LLA Plot and Table - Tabular values and plot of Latitude, Longitude, and Altitude.
- Simulation - Real-time, simulated image of the INS orientation.
- GPS Summary - Strength of GPS signal and accuracy.
- Mag Recal Button - Allows you to calibrate your units about either a single axis (for heavy, ground based vehicles) or multi-axes.
- BIT (Built-In Test) Button - Runs a system of checks on your unit.
- Link Messages - shows the performance information on connected units and displays error messages.
Sensors Tab¶
- Gyros Plot and Table - Gyroscopic data on the selected unit. Includes standard deviation.
- Accelerometers Plot and Table - Accelerometer data on the selected unit. Includes standard deviation.
- Magnetometers Plot and Table - Magnetometer data on the selected unit. Includes standard deviation.
- Barometer Plot and Table - Barometric, temperature, and humidity data on the selected unit. Includes standard deviation.
GPS Tab¶
- GPS CNO Signal Strength - Bar graphs of each satellite being used in your solution and its strength in dBHz(CNO).
- Position Accuracy Plot and Table - RTK mode and status. Includes number of satellites used in the RTK solution (max and mean).
- Satellites Used Table - The GNSS ID for each satellite seen by your unit and the subsequent connection details.
Map Tab¶
- Track Active - Tracks all units on window view.
- Zoom to Fit - Zooms your window view around each unit being used.
- Manual - Requires manual movement of the window view.
- Location of Units - GPS location of each of your units. Shows RTK, GPS ublox, and INS solution.
Data Sets Tab¶
- List of DIDs (Data IDentifiers) - The data identifiers that you might need to view for measurements. See the User Manual (Binary Protocol Data Sets) for a detailed description of frequently used DIDs.
- List of Variables within DIDs - shows what is recorded in each DID in real-time.
Data Logs¶
Data Streams¶
This area allow users to enable streaming of various DIDs.
- RMC Presets Button - Enable a group of data sets. PPD (post process data) is the preferred preset for post processing and debug analysis.
- Save Persistent Button - Save currently enabled data streams to automatically begin streaming after system restart. To clear persistent streams, first stop streaming and then click Save Persistent.
- Stop Streaming - Stops all data streams. Any streams previously saved as persistent will begin streaming at startup.
Data Log¶
- Enable/Disable Button - Starts/stops a log of all currently streaming data and saves it to a sub-folder with the current time-stamp within your "Logs" folder.
- Open Folder Button - Opens the "Logs" folder where your previous logs are saved.
- Format Dropdown - Select the file output type of the data log , such as .dat, .sdat, .csv, or .kml.
- Summary Window - Shows the log directly path, the elapsed time the data log has been running, the total size of the log file, and a list currently recording DIDs with corresponding dt (time between measurements).
- File Conversion Utility - Enables you to convert the data log file type in a specified directory. (e.g. .dat to .csv)
Settings Tab¶
The Settings tab has 3 sub tabs and they are as follows:
Settings - Serial Ports Tab
- Open All - Opens all of the ports shown.
- Close All - Closes all of the ports shown.
- Find Devices - Determines which peripherals into your computer are Inertial Sense units, and opens those ports while closing the others.
- Baud Rate - The rate at which data will be communicated over your data channel.
- Update Firmware - Allows you to update your unit's firmware when an update is released from Inertial Sense.
- Port Status - Shows a list of all connected comports and basic information for each of them. Clicking the check box opens the port.
Settings - General Tab
- Software Reset - Allows the user to issue a reset to the unit. has options for all open comports and only the currently connected unit.
- Zero Motion - Allows the user to informs the EKF that the system is stationary on the ground and is used to aid in IMU bias estimation which can reduce drift in the INS attitude.
- DID_Flash_Config - Gives the user option to disable or enable different features normally found in the "Data Sets" tab. For more information about the Flash Config see Data sets.
Settings - GPS Tab
- IMX Parameters - Shows flash config settings commonly used when setting up RTK units
- Status - Shows information important to using RTK.
- Rover/Base Mode - Used in setup of RTK Rovers and RTK base Stations.
- Message Window - Shows confirmation messages and Flash Config writes.
About Tab¶
Shows General information about the EvalTool and where more help information can be found.