How bulebots/bulebule works
Bulebule is a micromouse robot: the user configures a search goal and speed, the firmware explores and saves a maze, then can reuse that maze for a run. The sampled entry point shows orchestration and hardware setup; several algorithm implementations live in the listed but unsampled src/mmlib submodule, so their internal calls are not inferred. The repository also includes Bluetooth/data-analysis tools. Edges reflect calls shown in src/main.c, explicit README scope, or the indexed import from the Bluetooth tool.
Main entry points: main.c Firmware orchestration · setup.c Board initialization · connect_bluetooth.py Bluetooth client · eeprom.c Saved maze storage
Components 17
Robot workflow
- Firmware orchestration
src/main.c - Maze exploration and run
src/mmlib - Motion and motor control
src/mmlib - Buttons and interface
src/mmlib - Saved maze storage
src/eeprom.c - Simulation movement
src/simulation/move.c
Robot hardware
- Board initialization
src/setup.c - Infrared sensing
src/detection.c - Motor driver
src/motor.c - Battery monitoring
src/voltage.c
Connectivity and analysis
- Bluetooth serial
src/serial.c - Bluetooth client
scripts/connect_bluetooth.py - Log analysis
scripts/analysis.py - Simulation client
scripts/simulation_client.c
Other components
- Robot operator
- Robot flash memory
- Bluetooth module
Connections 14
- Robot operator → Firmware orchestration: starts and configures
src/main.c - Firmware orchestration → Board initialization: initializes board
src/main.c - Firmware orchestration → Buttons and interface: reads choices
src/main.c - Firmware orchestration → Maze exploration and run: explores and runs
src/main.c - Firmware orchestration → Motion and motor control: configures control
src/main.c - Firmware orchestration → Saved maze storage: loads and saves maze
src/main.c - Firmware orchestration → Battery monitoring: checks voltage
src/main.c - Board initialization → Infrared sensing: configures emitters
- Board initialization → Motor driver: configures PWM
- Saved maze storage → Robot flash memory: reads and writes
- Bluetooth client → Log analysis: imports
scripts/connect_bluetooth.py - Bluetooth client → Bluetooth module: communicates with
- Bluetooth serial → Bluetooth module: sends and receives
- Simulation client → Simulation movement: uses simulator