Skip to content

Repository files navigation

Delibot Configurator

TypeScript Vite HTML5 CSS3 Node.js Web Serial API

A web-based configurator for the Delibot STM32 controller. It connects over USB (serial) to configure and calibrate the robot directly from the browser, using the Web Serial API — no companion app or install required.

Made by DeliBot Lab (CBSH).

Requirements

  • Chrome or Edge (Web Serial API support). Firefox/Safari are not supported.
  • A Delibot controller board connected via USB-C (RPi-link UART, 115200 baud 8N1).
  • Node.js 18+ (for development/build)

Development

npm install
npm run dev

Open http://localhost:5173 in your browser. The page must be served over https or http://localhost — the Web Serial API only works in a secure context.

Production build

npm run build

Static files are emitted to dist/. Deploy them to any static host (GitHub Pages, Netlify, etc.).

Tabs

  • Setup — live yaw compass, left/right wheel speed, link status badges, config save/backup/restore
  • Receiver — 16 live CRSF channel bars, steering/throttle channel mapping and deadband
  • Drive — motor/encoder direction, chassis geometry (track width / wheel diameter / encoder resolution), max speeds, live wheel speed and raw encoder counts
  • PID Tuning — wheel speed PID, yaw control source (encoder/IMU), yaw rate PID
  • Calibration — encoder zero, IMU calibration save, wheel diameter / track width calculation wizards
  • CLI — raw parameter table plus JSON config dump/restore

Wire protocol

Implemented in src/serial/protocol.ts, mirroring Delibot-Controller's App/Inc/rpi_protocol.h, robot_config.h, and rpi_link.c.

  • Frame: [0xA5][LEN][CMD][PAYLOAD...][CRC8], CRC8 is DVB-S2 (poly 0xD5, init 0x00) computed over LEN+CMD+PAYLOAD
  • USART2, 115200 baud, 8N1
  • If the firmware protocol changes, update Cmd, ParamId, and PARAM_DEFS in src/serial/protocol.ts accordingly.

About

Delibot Configurator for configurating delibot & calibrating delibot!

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages