The Advanced Configuration Tool (navXConfig) is used to modify certain VMX-pi settings which impact the behavior of certain VMX-pi motion-processing algorithms.
NOTE: The use of the navxConfig Advanced Configuration Tool is an ADVANCED feature, and should only be used when directed by KauaiLabs support. Please see the section on “Restoring Factory Defaults” for instructions on recovering the original, recommended VMX-pi configuration settings.
Installing the navXConfig Advanced Configuration Tool
- Download the latest build.
- Unpack the contents of the vmx-pi.zip file and run the setup.exe program, which will install the navXUI, as well as all necessary device drivers for communicating over USB with VMX-pi, as well as some additional tools.
- Connect the USB cable between the VMX-pi circuit board and your Windows computer.
Running the navXConfig Advanced Configuration Tool
Start navXConfig
From your windows start menu, first select “Kauai Labs” and then “VMX-pi” and click on the navXConfig item.
Connecting to navX-Micro
Once the navXConfig application is started, select the COM Port on which your VMX-pi is connected, and press the “Open” button. If VMX-pi is successfully opened, you will see information about the VMX_pi circuit board:
Editing Configuration Settings
The following VMX-pi configuration settings can be modified using navXConfig:
Thresholds
Threshold settings define the level at which particular “events” occur.
Linear Motion
The VMX-pi motion detection algorithm indicates the VMX-pi is “moving” when the sum of the X and Y axis linear acceleration values exceed this threshold. Note that this threshold can impact the Gyroscope/Accelerometer calibration process, so if this value is modified, the calibration process should be tested afterwards to confirm it still works as intended.
Rotation
The VMX-pi rotation detection algorithm indicates the VMX-pi is “rotating” when the angular rotation within the last second exceeds this threshold in Gs. Note that this threshold can impact the Gyroscope/Accelerometer calibration process, so if this value is modified, the calibration process should be tested afterwards to confirm it still works as intended.
Magnetic Disturbance
The VMX-pi magnetic disturbance algorithm indicates the VMX-pi has detected magnetic disturbance when the strength of the currently-measured magnetic field exceeds that the calibrated earth magnetic field strength by this threshold, which is a percentage. Note that this threshold can impact the 9-axis “fused” heading fusion algorithm, so if this value is modified, the 9-axis “fused” heading process should be tested afterwards to confirm it still works as intended.
Environment Settings
Envrionment Settings are used to define attributes describing the environment in which VMX-pi is used.
Sea-level Barometric Pressure (VMX-pi Aero Only)
The Sea-level Barometric Pressure settings specifies the atmospheric pressure (in units of millibars) of sea-level in the particular location where VMX-pi is used. This value should be as accurate as possible for the current location, and will impact the calculation of altitude.
Restoring Factory Defaults
When VMX-pi units are shipped from the factory, the configuration settings which can be modified via navXConfig are set to default values. These default values were selected because they were tested and found to provide the most accurate results.
The default VMX-pi configuration settings can be restored at any time by pressing the “Restore Factory Defaults” button.