Skip to content
gunkslab

Concepts

The architecture

The fleet software for the desk bots and, later, Soleil: the firmware on each bot and the cluster side that coordinates them. It’s written for gl_zero first, then Pirate Stage, then Soleil.

The bots stay simple on purpose. Each one runs motion primitives and reports what it sees, and the coordination runs on the cluster, over MQTT.

Simple bots, a coordinating cluster

The bot is deliberately dumb. It drives where the station tells it and reports what it sees. Coordination, mapping and task allocation live in the cluster. That split is the point of the project. The fleet layer is the asset, and it must not be entangled with any one vehicle. The one thing a bot decides for itself is the reflex: it won’t drive forward into what its distance sensor sees, so that works with the station down.

The station

Before the station, anything could send a bot cmd. That works for one person at one keyboard, and stops working as soon as there are two:

  • Two clients drive one bot at once, and it lurches between them.
  • Each client numbers its own commands, so a bot’s seq echo means nothing.
  • There’s nowhere to put a power cap for the whole fleet.
  • Nothing remembers the fleet for a page that opens late.

The station fixes all four. Every command a bot gets comes from one place.

Everything in a container

Every service and tool runs in a container: Apple’s container on macOS, docker or podman anywhere else. Nothing is installed by hand on one machine, so it runs the same everywhere, and from scripts in the repo. The one exception is flashing a board, which needs the USB port, which a container can’t reach.

What the bot deliberately doesn’t do

No odometry on gl_zero (its firmware doesn’t use its encoders, so dead reckoning is hopeless, and the overhead camera does localisation instead). No autonomy on the bot beyond the reflex. No per-bot configuration. Each of those lives in the cluster on purpose, so that swapping the vehicle underneath (an ESP32 bot today, something much larger later) doesn’t touch the fleet layer.