README.md

atom_matrix_ros2

ROS2 driver for M5 Stack's Atom Matrix Micro-controller.

1. Installation

1.1 Install the ROS2 driver and its dependencies:

cd <your_ws>
git clone https://github.com/grassjelly/atom_matrix_ros2 src/atrom_matrix_ros2
rosdep install --from-paths src -i -r -y
colcon build

2. Installing the firmware

2.1 Install PlatformIO (only have to do once)

python3 -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
echo "PATH=\"\$PATH:\$HOME/.platformio/penv/bin\"" >> $HOME/.bashrc
source $HOME/.bashrc

2.2 Install the firmware to the Atom Matrix

cd atom_matrix_ros2/firmware
pio run --target upload

3. Running the driver

3.1 Run the launch file to run the microROS agent and IMU Madgwick Filter

ros2 launch atom_matrix_ros2 imu.launch

Optional arguments

rviz - If you want to run rviz and visualize the filter's estimated pose. For example:

ros2 Launch atom_matrix_ros2 imu.launch rviz:=true