Temp README
LispBM language support
This brings basic language support for the lispBM language to vscode.
LispBM is a functional programming
language in the lisp family designed to be run on microcontrollers.
This is the first real extention I write for vscode, so don't put too much
faith in this extension.
Features
This extension adds the new language LispBM.
The primary feature are the provided Textmate grammar definitions.
This means that basic syntax highlighting is supported (no semantic highlighting!).
Bracket definitions are also provided.
Custom folding ranges can be specified using comments. Start the range with a
;#region line and end it with a ;#endregion comment.
Custom text after #region and #endregion is allowed.
Example:
;#region My Optional Region
; This can be folded :)
(def a 5)
(print a)
;#endregion
Requirements
- A serial port accessible to the OS (e.g.
/dev/ttyUSB0 on Linux, COM3 on Windows)
- A device running LispBM with the VESC packet protocol interface (e.g. the ESP32C3 example from the LispBM repository)
Device Integration
Version 0.4.0 adds direct communication with LispBM devices over serial using the VESC packet protocol.
When a .lbm or .lisp file is open, a row of buttons appears in the editor title bar:
| Button |
Command |
Description |
plug |
Connect |
Connect to a serial port |
disconnect |
Disconnect |
Close the serial connection |
cloud-upload |
Upload |
Stream the current file to the device |
play |
Evaluate |
Evaluate an expression on the device |
refresh |
Reset |
Restart the LispBM evaluator |
pause |
Pause |
Pause the evaluator |
continue |
Continue |
Resume the evaluator |
pulse |
Stats |
Show heap and memory usage |
Device output (print statements and REPL results) appears in the LispBM output channel.
All commands are also available via Ctrl+Shift+P → LispBM: ....
Extension Settings
| Setting |
Default |
Description |
lispbm.serialPort |
(prompt on connect) |
Serial port path, e.g. /dev/ttyUSB0 |
lispbm.baudRate |
115200 |
Baud rate for the serial connection |
lispbm.streamChunkSize |
256 |
Chunk size in bytes when uploading code |
Known Issues
None! :)
Building
make # compile TypeScript
make package # produce a .vsix installable package
Install the resulting .vsix via Extensions panel → ... → Install from VSIX...
Release Notes
See CHANGELOG.md for more details
0.0.1
Initial release of the extension.
0.1.0
- Changed line comments from
;; to single ;. This seems to fix an issue where
bracket pair colorization would colorize brackets in comments.
- Added default file icon
0.1.1
- Fixed a lot of syntax grammar issues, including broken quoted lists, and supporting
inserting function expressions into quasi-quoted lists, and lots of function
parameter list improvements.
0.2.0
- Add indentation to language config. Pressing enter will now auto indent more
often.
- Improved textmate operator recognition.
0.2.2
- Add syntax grammar support for
@const-start and @const-end (their
documentation).
0.2.3
- Add syntax support for match structure.
- Fix
<=, >=, and not-eq not being recognized as operators.
0.3.0
- Add custom folding marker comments
- Fix a lot of indentation issues.
- Fix unrecognized
true and false constants.
0.3.1
- Add support for
@const-symbol-strings
0.3.2
- Fix escaped characters in strings not being detected.
0.3.3
- Add support for
read-eval-program, undefine, import, and defunret.
0.3.4
- Add more operators, like
cdr
- Add missing numeric literals
0.3.5
- Fix bug causing incorrect symbol highlighting
- Support strings and numbers in match patterns
- Support the ".lbm" extension
- Remove the ".lispbm" extension
0.3.6
- Add missing special forms
- Fix negative integer parsing
0.3.7
0.4.0
- Add basic VESC Packet compatibility, allowing devices to be connected over serial interfaces
