[Documentation] [TitleIndex] [WordIndex

Introduction

This package provides the official ROS driver for the 221e Multisensor InerTial CHamaleon (MITCH) V2 device.

Package available for:

Installation

Install ROS and create a Catkin workspace

a. Ubuntu 20.04:

b. Windows 10:

Tips for Windows:

To set up the catkin_make tools in Visual Studio 2019:

{
  "configurations": [
    {
      "name": "x64-Debug",
      "generator": "Ninja",
      "configurationType": "RelWithDebInfo",
      "inheritEnvironments": [ "msvc_x64_x64" ],
      "buildRoot": "C:\\catkin_ws\\build",
      "installRoot": "C:\\catkin_ws\\install",
      "cmakeCommandArgs": "DCATKIN_DEVEL_PREFIX=C:\\catkin_ws\\devel",
      "ctestCommandArgs": ""
    }
  ]
}

In this way, Cmaking and building your project from Visual Studio will be equal to a catkin_make outside the Visual Studio environment. You can also open the Command Line directly from the Visual Studio Tools button.

Install lib221e

lib221e is the C++ library for the 221e Communication Protocol. Follow the installation instructions available here.

Clone mitch_v2_driver in your Catkin Workspace

a) Ubuntu:

$ cd ~/catkin_ws/src/
$ git clone https://github.com/221eROS/mitch_v2_driver.git
$ catkin_make

b) Windows:

$ cd c:\catkin_ws\src
$ git clone https://github.com/221eROS/mitch_v2_driver.git
$ cd ..
$ catkin_make

Usage

Device connection

Switch on your MITCH V2 device. From your catkin workspace, launch the following command to connect to your sensor and enable its ROS node:

$ roslaunch mitch_v2_driver mitch_v2.launch

Among others, this launch file allows you to set: - port name (Default: COM4); - baudrate (Default: 115200).

Device shutdown

Assuming the ROS node of your MITCH V2 sensor is active [step 3(a)], launch the following command to switch off your device:

$ roslaunch mitch_v2_driver shutdown.launch

Battery charge and voltage

Assuming the ROS node of your MITCH V2 sensor is active [step 3(a)], type the following command from your catkin workspace:

$ roslaunch mitch_v2_driver battery.launch

The node will send back the battery charge, its voltage, or both depending on whether the arguments *charge* and *voltage* are set to *true*.

Firmware version

Assuming the ROS node of your MITCH V2 sensor is active [step 3(a)], type the following command from your catkin workspace:

$ roslaunch mitch_v2_driver get_firmware_version.launch


2024-10-05 14:20