LPMS-Control Software
Overview
The LPMS-Control application allows users to control various aspects of an LPMS device from a PC. The application has the following core functionality:
List all LPMS devices connected to the system
Connect to up to 256 sensors simultaneously
Adjust all sensor parameters (sensor range etc.).
Set orientation offsets
Initiate accelerometer, gyroscope and magnetometer calibration.
Display the acquired data in real-time either as line graphs or a 3D image
Record data from the sensors to a CSV data file
Play back data from a previously recorded CSV file
Upload new firmware and in-application-programming software to the sensor
LPMS-Control can be downloaded directly from the LP-Research website support page.
GUI Elements
Toolbar Items
The key functionality of LpmsControl can be accessed via the toolbar. See an overview of the toolbar in Figure 6, Figure 7, Figure 8 and Figure 9.
Figure 6 - Connection toolbar
Figure 7 - Recording and playback toolbar
Figure 8 - Orientation offset toolbar
Figure 9 - Window selector
Menu Items
Menu title | Menu item | Operation |
Connect menu |
|
|
| Connect | Connects to sensor selected in "Preferred devices" list |
| Disconnect | Disconnects sensor currently selected in "Connected devices" list |
| Add / remove sensor | Opens "Scan devices" dialog |
| Exit program | Exits the application |
Measurement menu |
|
|
| Stop measurement | Toggles measurement |
| Browse record file | Opens browser for selectinga file for data recording |
| Record data | Toggles data recording |
| Browse replay file
| Opens browser for selecting a playback file |
| Playback data | Starts data playback |
Calibration menu |
|
|
| Calibrate gyroscope | Starts manual gyroscope calibration |
| Calibrate mag. (ellipsoid fit) | Starts magnetometer calibration wizard for ellipsoid fit calibration |
| Calibrate mag. (min/max fit) | Starts magnetometer calibration wizard for min/max fit calibration |
| Save parameters to sensor | Saves parameters to sensor flash memory |
| Save calibrationfile | Saves file with calibration data |
| Load calibrationfile | Loads file with calibration data |
| Set offset | Sets sensor orientation offset (depending on "Reset target" and "Reset method") |
| Reset offset | Resets sensor orientation offset (depending on "Reset target") |
| Arm timestamp reset | Arms hardware timestamp reset |
| Reset to factory settings | Resets sensor settings to factory default |
View |
|
|
| Graph window | Selects raw data graph window |
| Orientation window | Selects orientation graph window |
| Pressure window | Selects pressure graph window |
| 3D visualization | Selects 3D visualization window |
| 3D view mode 1 | Selects view mode 1 |
| 3D view mode 2 | Selects view mode 2 |
| 3D view mode 4 | Selects view mode 4 |
| Load object file | Loads 3D OBJ file |
Advanced |
|
|
| Upload firmware | Uploads firmware file |
| Upload IAP | Uploads in-application-programmer file |
| Start self test | Starts self-test |
| Calibrate acc. misalignment | Starts accelerometer calibration wizard |
| Calibrate gyr. misalignment | Starts gyroscope calibration wizard |
| Calibrate mag. misalignment (HH-coils) | Starts magnetometer calibration wizard (Helmholtz coils mode) |
| Calibrate mag. misalignment (auto) | Starts magnetometer calibration wizard (automatic mode) |
| Version info | Displays version information dialog |
Connected Devices List
Devices connected to the system are shown in the Connected devices list. Through this list each sensor parameter can be adjusted according to the table below.
Top level item | Parameter item | Description |
Status |
|
|
| Connection | Displays the current connection status OK: Connection successful In progress: Currently connecting Failed: Connection failed
|
| Sensor status | Displays the current sensor status Started: Sensor measurement is running Stopped: Sensor measurement stopped
|
| Device ID | Current device ID |
| Firmware version | Firmware version |
ID / sampling rate |
|
|
| IMU ID | Selects OpenMAT ID |
| Transmission rate | Selects data transmission rate |
Range |
|
|
| GYR range | Selects gyroscope range |
| ACC range | Selects accelerometer range |
| MAG range | Selects magnetometer range |
Filter |
|
|
| Filter mode | Selects filter mode |
| MAG correction | Selects magnetometer correction mode |
| Lin. ACC correction | Selects linear acceleration correction mode |
| Rot. ACC correction | Selects centripetal acceleration correction |
| GYR threshold | Selects gyroscope threshold |
| GYR autocalibration | Selects auto-calibration setting |
| Low-pass filter | Selects low-pass filter setting (deprecated) |
Data |
|
|
| LP-BUS data mode | Switches between 16-bit integer or 32-bit floating point mode |
| Enabled data | Selects data to be enabled for transmission from the sensor |
UART (RS-232/TTL) |
|
|
| Baud rate | Selects the UART transmission baud rate |
| Data format | Switches between LP-BUS and ASCII format output |
CAN bus |
|
|
| CAN baudrate | Selects baud rate for CAN communication |
| Channel mode | Selects CAN channel mode |
| Value mode | Selects CAN value mode |
| Start ID | CAN start ID for sequential mode |
| Heartbeat freq. | Heartbeat frequency |
| Channel 1-16 | CAN channel assignment |
NOTE: Parameter adjustments are normally only persistent until the sensor is switched off. You can permanently save the newly adjusted parameters to the LPMS flash memory by selecting Save parameters to sensor in the Calibration menu of LPMS-Control.
Scanning, Discovering and Saving Devices
Discovering devices, especially Bluetooth devices, can be quite time-consuming. Therefore LPMS-Control allows scanning for devices once and then saves the device identification in a list of preferred devices. Figure 10 shows the device discovery dialog. To add a device to the preferred devices list, please follow the steps below:
Click "Scan devices" and wait until the scanning process is finished.
Select the target device from the discovered devices list
Click "Add device" to add the device to the Preferred devices list
Click Save devices to save the list of preferred devices
Figure 10 - Discover devices dialog
Connecting and Disconnecting a Device
To connect to an LPMS device, please follow the steps below.
Select device to connect to in "Preferred devices" dropdown list.
Click "Connect" button.
Sensor status should now be "Connecting..".
Connection establishment should take between 2 and 5 seconds.
If the connection is successful, the sensor status should switch to "Connected". The sensor will start measuring automatically after connecting. Should the connection procedure fail for some reason, “Failed” will be displayed. If a successful connection is interrupted the connection status will change to "Connection interrupted".
NOTE: Please make sure that you have no 3rd party Bluetooth driver (Toshiba, Bluesoleil etc.) installed on your system. LPMS-Control uses the native Windows Bluetooth driver and any other driver will block communication with the native Windows driver. The Windows Bluetooth pairing functionality will be automatically started when connecting to the sensor from LPMS-Control. A PIN code should not be required for connecting with the LPMS.
Recording and Playing Back Data
LPMS-Control allows recording and playback of sensor data. Recorded data is saved in a CSV format that can be easily processed by Excel, MATLAB etc. Saved files can be loaded into LPSM-Control and played back. Now only playback of the sensor with the lowest OpenMAT ID in the file is possible. To start data recording please follow the steps below:
Select "Measurement" ->"Browse record file" and choose a filename that you would like to record to.
Start the recording by selecting "Measurement -> Record" data.
Once you have collected enough data stop the recording by selecting "Measurement" ->"Stop recording".
To replay a data file, do the following:
Select "Measurement" ->"Browse replay" file and select a file that you would like to replay.
Start replay by selecting "Measurement" ->"Replay data".
Replay will loop automatically. Once you would like to stop replay select "Measurement" ->"Stop replay data".
NOTE: LPMS-Control automatically applies calibration parameters to raw sensor data and therefore records and displays calibrated sensor data.
Switching View Modes
LPMS-Control can visualize sensor orientation data either as data graphs or as 3D representation. In 3D view mode the orientation of the sensor is shown as a 3D cube. Up to 4 sensors can be shown simultaneously in one window. In this multi-view mode, which sensors are visualized can be adjusted by assigning an IMU ID to each window (see Figure 11).
Figure 11 - Viewing the orientation of 4 connected LPMS at the same time
By selecting Load object file from the View menu, custom 3D data can be loaded into LPMS-Control as shown in Figure 12.
NOTE: LPMS-Control so far only supports the OBJ file format for loading 3D CAD files. We recommend exporting files in this format from the open-source 3D visualizer Meshlab: http://meshlab.sourceforge.net/
Figure 12 - Custom 3D OBJ data can be loaded into the visualization window
Uploading New Firmware
Please follow the following steps carefully when you are updating the sensor firmware. Invalid operation might result in an incomplete firmware update and brick the sensor.
Start your current LPMS-Control software.
Connect to the sensor you would like to update.
Choose the “Save parameters to file” function from the “Calibration” menu of LPMS-Control to save the current sensor calibration results into a .txt file on your local host system.
Select Upload firmware function in the “Advanced” menu.
Click OK and select the new firmware file. Be careful that you select the right file which should be named as LpmsXFirmwareX.X.X.bin (with X being the sensor type identifier and firmware version).
Wait for the upload process to finish. It should take around 30 seconds. At around 15s the green LED on the sensor should begin to blink rapidly (~10 Hz).
Disconnect from the sensor and exit LPMS-Control.
Now install the new LPMS-Control application. The previous LPMS-Control application does not need to be un-installed.
Start LPMS-Control and connect to your sensor.
Choose the “Load parameters fromfile” function from the “Calibration” menu of LPMS-Control to recover the previous sensor calibration results.
Choose the “Save parameters”tosensor function from the calibration menu of LPMS-Control to save the previous sensor calibration results into sensor flash.
The update is finished. Make sure everything works as expected.