openimu 2.3.1

Aceinna Navigation System Open Devices Library

python-openimu

A message communication tool for OpenIMU, OpenRTK and other devices of Aceinna

Working Environment

• Windows10: python 3.7
• Mac OS: python 3.7

Steps

1. Start the tool

There are 2 ways to run the tool

Prepare

Install the dependency library. It is better to create a virtual environment before to do it.

python 3.x

$ pip install -r requirements.txt

A. From source code

Run

Please use this way if you want to contribute the project.

$ python main.py

B. Work as execution file

Build

The executable will be generated in dist folder.

$ pyinstaller build.spec

Run

$ cd dist
$ ./ans-devices

Startup Arguments

You can specify some arguments while run the tool

Arguments:

Name	Type	Default	Description
--cli	Boolean	False	Work as command line mode
-p, --port	Number	'8000'	Value should be an available port
--device-type	String	'auto'	Value should be one of IMU, RTK, DMU
-b, --baudrate	String	None	Value should be a valid baudrate. The valid value should be one of 38400, 57600, 115200, 230400, 460800
-c, --com-port	String	'auto'	Value should be a COM port
--console-log	Boolean	False	Output log on console
--debug	Boolean	False	Log debug information
--with-data-log	Boolean	False	Contains internal data log (OpenIMU only)
-s, --set-user-para	Boolean	False	Set uesr parameters (OpenRTK only)
-n, --ntrip-client	Boolean	False	Enable ntrip client (OpenRTK only)
-l, --protocol	String	'uart'	Value should be uart, lan. Depends on device type

2. Connect Aceinna device

Link device to your pc or mac. The tool will auto detect the linked device by default.

More Usage

Work Mode

Default Mode

Normally, python-openimu works as default mode. It will establish a websocket server, then exchange messages through the websocket protocol. And it should work with aceinna developers site, it allows user to do data monitor, configuration and firmware management.

Command Line Mode

You can specify the startup argument --cli to switch to Command Line Mode. Command Line Mode helps you interact with device directly. And it also supply command to start a websocket server, so that you can use the full features of Default Mode.

Command Line Mode supports some commands for using, below is a list of commands description,

Help

Show help menu. It would show a list of description for all supported commands.

$ help

Get Device Info

Show information of connected device.

$ connect

Get Parameter (OpenIMU Only)

Retrieve current value of specified parameter.

$ get param_name

Set Parameter (OpenIMU Only)

Update the value of specified parameter. The value would be recoverd after device power off.

$ set param_name param_value

Save Configuration

Save the configuration into EEPROM. The value would be permanently saved.

$ save

Record Data (OpenIMU Only)

Log the device output data in path /data. It is not supported for OpenRTK, because OpenRTK device will automatically log data when it is connected.

$ record

Upgrade Firmware

Upgrade firmware from a specified path. The binary file should match with the device. This is a high risk command.

$ upgrade path/to/bin

Start Server

Establish a websocket server.

$ server_start

Stop Server

Stop the websocket server. If there is websocket server runing, it has to stop it when you want to use other command.

$ stop

Exit

Quit from Command Line Mode

$ exit

Protocol

Aceinna Device could be connected with your PC via UART or LAN. The supported protocol is depended on the device type.

Device Type	Supported Protocols	Description
DMU	uart
OpenIMU	uart
OpenRTK	uart, lan	The startup argument -l lan is supported
RTK330L	uart

Changelogs and Release Notes

Please refer to HISTORY.md