LispBM is an integration of the lispBM language by Joel Svensson into the VESC firmware. It lets the VESC run Lisp programs in a sandboxed environment alongside the main motor control stack — no external hardware or host computer required once a script is uploaded.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/vedderb/bldc/llms.txt
Use this file to discover all available pages before exploring further.
What LispBM provides
Sandboxed runtime
Lisp code runs in isolation. A stuck script or heap exhaustion cannot freeze or crash the rest of the VESC firmware.
Stored in flash
Scripts are written to flash memory and survive power cycles. When a Lisp application is uploaded to the VESC it starts automatically on every boot.
Live REPL
VESC Tool includes a Lisp console where you can execute expressions and inspect bindings in the running program without restarting it.
Live monitoring
CPU usage, heap consumption, and custom variable plots are available in real time from VESC Tool while the script is running.
How scripts are stored and started
When you write a Lisp application to the VESC using VESC Tool, the compiled bytecode is saved to the device’s flash memory. On every subsequent boot the firmware loads and starts the script automatically — no host connection is needed for normal operation. The script keeps running until it explicitly exits, encounters an unrecoverable error, or the VESC is power-cycled. Because the environment is sandboxed, a runaway script (infinite loop, heap exhaustion) is isolated from the motor control task.Code that is actively controlling a motor must call
(timeout-reset) at least once per second or the motor will stop. This is a safety feature — not a bug.Development workflow
Open the Lisp editor in VESC Tool
Navigate to Scripting in VESC Tool. The built-in editor has syntax highlighting and a collection of example scripts accessible from the menu.
Write or load a script
Write your Lisp program in the editor or load one of the bundled examples as a starting point. VESC Tool includes examples covering motor control, CAN communication, sensor reading, and more.
Upload and run
Click Upload to write the script to the VESC. The script starts immediately. Use the Console tab to view
print output and interact with the running program via the REPL.REPL access
The REPL in VESC Tool gives full access to all functions and variable bindings in the currently running program. You can call extension functions, inspect state, and test expressions without modifying or restarting the script.CPU and memory monitoring
VESC Tool displays real-time CPU load and heap usage for the Lisp runtime. This helps you identify scripts that are too compute-intensive for the available resources and tune accordingly. For scripts that must start quickly, LBM Image support allows pre-compiled snapshots of the heap to be stored in flash and restored at boot, avoiding the overhead of re-evaluating the script from source on every power cycle.Platform support
| Feature | ESC (STM32) | VESC Express (ESP32) |
|---|---|---|
| Core LispBM runtime | Yes | Yes |
| Motor control extensions | Yes | No |
| CAN bus extensions | Yes | Yes |
| IMU extensions | Yes | Yes |
| Display / WiFi / BLE | No | Yes |
| UART / I2C / GPIO | Yes | Yes |
Next steps
Language reference
Core LispBM syntax, data types, control flow, and functions.
VESC extensions
Motor control, CAN bus, IMU, GPIO, and all VESC-specific functions.
Examples
Practical scripts to read sensors, control motor speed, and communicate over CAN.