Getting Started

Quick Start Guide

Prerequisites

Docker and Docker Compose
Git

Initial Setup

Clone the repository:

git clone https://github.com/c-lydia/wall_e.git
cd wall_e/micro_ros_ws

Start the Docker Compose environment:

docker compose up -d

Enter the workspace container and build host packages:

docker compose exec workspace bash
cd /micro_ros_ws
source /opt/ros/humble/setup.bash
colcon build
source /micro_ros_ws/install/setup.bash

Launch the integrated stack:

ros2 launch wall_e_description wall_e.launch.py

If GUI authorization fails on the host (X11), run on host before launching GUI apps:

xhost +si:localuser:root

Building the ESP32 Firmware

ros2 run micro_ros_setup configure_firmware.sh esp32_controller -t udp -i 192.168.1.2 -p 8888
ros2 run micro_ros_setup build_firmware.sh
ros2 run micro_ros_setup flash_firmware.sh

Next Steps

Read the ESP32 Controller documentation
Explore the Architecture overview
Check Troubleshooting for common issues