Ambulatio Control application for GaitAnalyser hardware module

Ambulatio

Ambulatio is the operator software for the HW module "Gait Analyser". It allows to communicate with the HW module, which can contain up to 4 IMU sensors. The API described in the Gait Analyser project is used for communication. A serial interface with the following parameters is used for communication:

  • 921600 Baud rate
  • Parity: none

The basic configuration can be found in the config.ini file. Supported settings:

  • port - serial port name.
    • Linux: /dev/ttyACM0 or /dev/ttyUSB0
    • Windows: COMx (need to find the actual port as it was mapped to the system)
  • debug (defaut 0) - set the detailed communication dump
  • data_dir - output directory dor data files. Default location is working directory af Ambulatio SW.

Running from source code

Dependent packages: wxPython, Pyserial, Numpy

python3 ./ambulatio.py

Instalation

  • unpack downloaded archive
  • rename file config.ini.default to config.ini and set desired parameters.
  • run file ambulatio

How it works

  1. connect HW module to PC
  2. Run software Ambulation and click Connect. The settings from HW module is loaded into SW
  3. When Active sensor is changed, settings from selected sensor is loaded

Change sensor settings

An IMU sensor consists of accelerometer, gyroscope and magnetometer. For each sensor, the Sample rate, Low pass filter and Range can be set. The setting can be temporary or permanent.

Temporary setting is valid until next reset/power on of module. This is done by button Set

Permanent setting is stored to persistent memory of HW module. After setting desired parameters, click on button Write settins

Erase settings - all setting will be erased from module persistent memory. After next connection, the default parameters will be used.

Ambulatio - sensors settings

Measure

Every sensor has own calibration.
We recommend that the calibration is done in a resting state, with all connected sensors placed on a solid support. The orientation of each sensor should be such that the gravitational acceleration vector is oriented to the `z' axis of the sensor.

Calibrate - Run the sensor calibration. It will take approx. 2 s. This action take temporary calibration.

Write calibration - write the calibration to persistent memory of HW module. The actual calibration is showed in Config tab under Set button.

Start - run the measurement

Record date - Measured data will be saved in CSV file.

Contributors 2
Juraj Ďuďák 95.0%
Jakub Pericka 5.0%
Languages
  • Python [99.42%]
  • Makefile [0.58%]
  • Relations
    gait-analyser
    related
    Created at 15.01.2023
    Last update 13.01.2025, 22:35:38