Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cliansang/uwb-tracking-ros

This repo demonstrates the tracking scenario for UWB Localization in ROS using the Decawave's TREK1000 (EVK1000 Evaluation Kits) and MDEK 1001 (DWM1001-DEV boards).
https://github.com/cliansang/uwb-tracking-ros

decawave dwm1001 mdek1001 ros ros-noetic trek1000 ultra-wideband uwb uwb-localization uwb-positioning uwb-tracking

Last synced: about 1 month ago
JSON representation

This repo demonstrates the tracking scenario for UWB Localization in ROS using the Decawave's TREK1000 (EVK1000 Evaluation Kits) and MDEK 1001 (DWM1001-DEV boards).

Awesome Lists containing this project

README 

        
# ROS Interface for the UWB Tracking Demos of Decawave's MDEK1001 and TREK1000 Kits



This repo extends the ROS interfaces for the Ultra-Wideband (UWB) Real Time Locatin System (RTLS) [demo](https://www.decawave.com/mdek1001/usermanual/) of Decawave's MDEK1001 Dev-boards provided by [TIERS](https://github.com/TIERS/ros-dwm1001-uwb-localization.git) and [Mub @20chix](https://github.com/20chix/dwm1001_ros.git) for the purpose of tracking and visualizing multiple tags in ROS environment. Additionally, we added the Kalman filter on top of the previous works to smoothen the positioning data from the UWB device before sending them as ROS topics. Moreover, we provide the ROS interface for the UWB tracking [demo](https://www.decawave.com/wp-content/uploads/2018/09/trek1000_user_manual.pdf) based on TREK1000/EVK1000 Dev-boards, which we wrote it from scratch, in this repo. The code has been tested under Ubuntu 20.04 LTS with ROS Noetic Ninjemys distribution. It should be noted that this is a work-in-progress research repo and some parts are still in developing states. 



This project has been originated as a supplementary sub-project for [CITrack](https://cit-ec.de/en/ks/projects/citrack) in [Cognitronics and Sensor Systems](https://www.cit-ec.de/en/ks) Research Group, CITEC, Bielefeld University.



### Updates as of 23.10.2024



For the **ROS2 use case** of this repository, please refer to [this link](https://github.com/lauritz1000/uwb-tracking-ros2), provided and tested by [Lauritz](https://github.com/lauritz1000). For any further inquiries about **_ROS2_**, please address them on that repository.



## Setups and Installation

### DWM1001/MDEK1001 Setup

- Clone this repo into your catkin workspace (see installation section)

- Plug the USB cable of the tag acting as either a listener node or gateway node into your machine

- Check the name of the USB in your machine (typically it is /dev/ttyACM0 in Ubuntu if no other USB is connected into it)

- Give read-write permission to your USB (i.e., sudo chmod 777 /dev/ or add it into the user group dialout)

- Make sure that RTLS is working on the app from the grid view according to the instruction in 'Getting Started' section 



### TREK1000/EVK1000 Setup

- Install the stlink-tools to connect the Dev-board via USB ``` sudo apt install stlink-tools ```

- If you are using virtual machine via Windows as a host, [STM32 Virtual COM Port Driver](https://www.st.com/en/development-tools/stsw-stm32102.html) is necessary to install on the host in some cases.

- Plug the USB cable of the coordinator node (Achor 0) into your machine

- Give read-write permission to your USB (typically it is /dev/ttyACM0 in Ubuntu if no other USBs are connected)



### Installation



Clone this repo into your catkin workspace and install the dependencies if required 

```

rosdep install --from-paths src --ignore-src -r -y

pip install pyserial

pip install numpy

```



Build the workspace:

```

cd ~/

catkin_make 

```

Then, run the respetive launch file.

```

roslaunch / 

```



For instance, run the following launch file for the DWM1001 multiple tags tracking scenario:

```

roslaunch uwb_tracking_ros uwb_tracking_dwm1001.launch

```



## Getting Started

### For DWM1001/MDEK1001 

Follow the steps in [Decawave's DRTLS Guide](https://www.decawave.com/mdek1001/quickstart/) to setup a Real Time Location System (RTLS) system with at least 3 anchors and 1 active node using DWM1001-dev board ( in our case, we use MDEK1001 hardware setup). An android phone or a tablet is required to set-up the RTLS using [DRTLS andriod app](https://www.decawave.com/product/dwm1001-development-board/). 



The UWB node can be set-up as an anchor, a tag, and listener modes. This repo requires the listener node (or) gateway node to be attached into the PC or remote machine where ROS is running. The task of the listener node is echoing the positioning data of tags that it has heard. Only position data (x, y, z) of the tags in 3D are able to process via listener node (i.e., the ranging data are not available). To set-up the node as a listener, simply switch the dedicated UWB node to a 'passive' mode in the Decawave's RTLS app. 



The update rate of the tag's position can be adjusted within the Decawave's app. However, we recommend setting the update rate to 10 Hz (100 ms).



The following is a sample visualization screenshot of two tags on rviz in 3D

![rviz_uwb_sample](https://user-images.githubusercontent.com/18302290/144410317-1d5b5a1f-3058-487b-b583-408133118df7.JPG)



### For TREK1000/EVK1000

Follow the set-up instructions given for [TREK1000](https://www.decawave.com/wp-content/uploads/2018/09/trek1000_user_manual.pdf) by Decawave. Then, connect the coordinator node (i.e., Anchor 0 in TREK1000) into your machine where ROS is availalbe via USB port. Run the launch file related to TREK1000 from this repo and process further as your requirments. It should be noted that the tag node can also be connected into the your machine. In this case, the scenario will be for navigation or self-navigation purpose where the positioning data is available to the moving tag.