How ojasp21/micromouse works
This repository combines micromouse firmware experiments with two maze-solver simulations and a VL53L0X time-of-flight sensor component. The clearest user-to-result workflow is a simulation entry point querying walls, choosing a move, and issuing movement or turn commands to the simulator; floodfill follows a precomputed value gradient, while the separate left-wall follower uses a wall-following rule. The ToF firmware initializes the sensor and repeatedly reports range measurements. The README also describes PID testing and hardware design, but the tree does not show an integrated robot-control workflow. Several sensor-layer links are omitted because their callers were not excerpted.
Main entry points: vl53l0x.c VL53L0X driver · main.c Range measurement app · floodfill/API.c Simulator API · left_follow_rule/API.c Simulator API
Components 15
Maze simulations
- Floodfill solver
firmware/simulation/floodfill/Main.c - Simulator API
firmware/simulation/floodfill/API.c - Left-wall follower
firmware/simulation/left_follow_rule/Main.c - Simulator API
firmware/simulation/left_follow_rule/API.c
Sensor firmware
- Analog IR test
firmware/ir_sensor/IR_ANALOG/main/main.c - Digital IR test
firmware/ir_sensor/IR_DIGITAL/main/main.c
Control experiments
- PID firmware
firmware/pid_tuning/main/main.c - PID tuning code
firmware/pid_tuning/c.cpp
ToF component
- Range measurement app
firmware/tof_sensor/main/main.c - VL53L0X driver
firmware/tof_sensor/components/vl53l0x.c - VL53L0X API
firmware/tof_sensor/components/Api/core/src/vl53l0x_api.c - I2C platform layer
firmware/tof_sensor/components/Api/platform/src/vl53l0x_i2c_platform.c
Other components
- Maze simulator
- VL53L0X sensor
- Range log output
Connections 9
- Floodfill solver → Simulator API: queries and commands
firmware/simulation/floodfill/Main.c - Simulator API → Maze simulator: forwards API calls
- Left-wall follower → Simulator API: queries and commands
firmware/simulation/left_follow_rule/Main.c - Simulator API → Maze simulator: forwards API calls
- Range measurement app → VL53L0X driver: initializes and reads
firmware/tof_sensor/main/main.c - VL53L0X driver → VL53L0X API: calls ranging API
firmware/tof_sensor/components/vl53l0x.c - VL53L0X API → I2C platform layer: uses register access
- VL53L0X sensor → VL53L0X driver: provides measurements
- Range measurement app → Range log output: logs measurements
firmware/tof_sensor/main/main.c