a02f11d4d4
e421208f small tweaks to strings, dec_str and string extensions 0baa53c6 Merge pull request #12 from laxsjo/update/str-extensions 1e27ba02 swapped start and occurrence arguments in str-find 7d5a997e Write tests for new string extensions 6bd2c1bd Update str-find argument behavior b84a779b add_symbol functions now check if a symbol already exists before adding it. dac49f47 move test lisp files into dedicated directory 34a14229 added a few more move-to-flash tests 1f221aaf change order of flash writes in a few more cases. The high-level array case needs refactoring to fit the pattern e9e7083f add compiled repl and tests executable to .gitignore a70eda64 cast/change int types to avoid warnings in string_extensions.c 5dc5b022 Swapped meaning of 'left and 'right in str-find Realized that the previous behavior is completely stupid, since the argument is called direction, while the previous left and right specified which end to start in. 93805c98 Add the str-join and str-find extensions, remove old str-merge 3f364178 change to order in which values are written to flash when processing lists. 6c1a0672 added tests related to progn + var. May need to think a bit about the meaning of var in progn dd09cecf tweak refman a9c5fd53 small update lbmref 3642e8a5 small update lbmref 8be7ab05 small tweaks to manual 77a38617 update to lbmref fa56ea05 changes to lbmref. minor tweaks git-subtree-dir: lispBM/lispBM git-subtree-split: e421208f5355be188ac80949e36300f43f15a8fc |
||
|---|---|---|
| benchmarks | ||
| doc | ||
| include | ||
| mascot | ||
| platform | ||
| repl | ||
| src | ||
| test_reports | ||
| tests | ||
| vesc_express_tests | ||
| videos | ||
| .clang_complete | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| lispbm.mk | ||
| mktags.sh | ||
| release.sh | ||
| runinfer.sh | ||
| runsa.sh | ||
README.md
lispBM (LBM)
LispBM is a lisp or scheme like programming language for microcontrollers. LispBM also borrows a couple of ideas from Erlang when it comes to concurrency, message passing, pattern matching and process monitoring. The LispBM runtime system can be compiled for either 32 or 64 bit platforms and runs on a wide range of hardware such as for example STM32, NRF52, ESP32 or X86. When running the LispBM runtime system on a microcontroller it can be built on top of ChibiOS, FreeRTOS or ZephyrOS or, if you are adventurous, on bare-metal. LispBM can also be built to run on top of a regular linux.
The LispBM mascot, Lispy the llama, was created by PixiLadyArt. Thank you, Pixi!
Want to get involved and help out?
There are lots of interesting things to code on in and around the LispBM runtime system. I would love to interact with people who are interested in high-level programming languages on microcontrollers (or elsewhere) so please do not be shy to make contact. Together we can make great stuff happen ;)
- Are you interested in microcontrollers and programming languages?
- You find it fun to mess around in C code with close to zero comments?
- Then join in the fun. Lots to do, so little time!
- Poke me by mail bo(dot)joel(dot)svensson(whirly-a)gmail(dot)com.
There are areas where insights and help would matter greatly. Some I can think of are:
- Running LispBM on system simulators.
- LispBM efficiency, compilation, byte-code and real time garbage collection.
- Code size optimisation. Do more with less, while maintaining performance.
- Documentation and testing.
- Useful extension libraries.
- Lisp scriptable home automation.
- Lisp scriptable MIDI sequencers.
- Lisp scriptable Audio synthesizers.
- ...
Getting started
The easiest way to get started with LispBM programming is to use VESC-Tool together with the VESC EXPRESS Firmware on an esp32c3.
VESC-Tool gives you access to a very capable IDE for lisp programming on embedded systems and the VESC Express firmware provides built in functionality to interface with CAN, WIFI, BLE and UART as well as GPIO and display drivers.
If you are looking for a more bare-bones way to add scripting capabilities to your embedded system, LispBM is quite platform independent and can be compiled for many different MCUs and systems. LispBM can tie into the rest of your application via what we call "extensions" which are C functions that can be called from your LispBM scripts.
Documentation
- Work in progress LispBM language reference.
- Gotchas and caveats Gotchas and caveats.
- Work in progress LispBM programming manual.
- C code documentation can be found here.
- LispBM's internals are documented as a series of (now quite outdated) blog posts.
- There are demonstrations on YouTube.
The LBM REPL
There is an example REPL implementation that runs on X86 32 or 64bit in the repl directory.
The REPL depends on libreadline.
REPL Dependencies for 32Bit executable on 64Bit linux:
- libreadline
- lib32readline
- gcc-multilib
On Ubunty you can obtain the depencies by:
sudo apt-get install gcc-multilib libreadline-dev lib32readline-dev
Then issue command make in the repl directory.