Download uLisp
Version 3.3
The 32-bit version of uLisp for ARM, ESP, and RISC-V microcontroller boards now extends its array support to include bit arrays.
Bit arrays will be particularly useful in the microcontroller-based applications that uLisp is aimed at as they can efficiently store the state of digital I/O lines, digital signals, or display pixels. You could use them as the basis for a data logger, low-speed logic analyzer, or other digital application.
uLisp's implementation supports bit arrays with an arbitrary number of dimensions, and packs bit arrays as efficiently as possible, so they take up a factor of 32 less storage than the equivalent-sized integer array.
Latest versions
There are currently four actively maintained versions of uLisp. Download the correct one for your platform:
AVR version
Download the latest AVR version of uLisp for the Arduino Uno, Arduino Mega 2560, ATmega1284, and ATmega4809 platforms here:
AVR Version 3.3 - 1st June 2020
or get it from GitHub at https://github.com/technoblogy/ulisp.
ARM version
Download the latest ARM version of uLisp for the Arduino Zero, Arduino MKRZero, Adafruit M0 boards, Adafruit M4 boards, Adafruit PyBadge/PyGamer, Adafruit nRF52840 boards, BBC Micro Bit, Calliope mini, MAX32620FTHR, and Teensy 4.0/4.1 platforms here:
ARM Version 3.3a - 1st July 2020
or get it from GitHub at https://github.com/technoblogy/ulisp-arm.
ESP version
Download the latest ESP version of uLisp for the ESP8266 and ESP32 platforms here:
ESP Version 3.3 - 1st June 2020
or get it from GitHub at https://github.com/technoblogy/ulisp-esp.
RISC-V version
Download the latest RISC-V version of uLisp for the Sipeed Maixduino, MAiX One Dock, and MAiX BiT boards here:
RISC-V Version 3.3 - 1st June 2020
or get it from GitHub at https://github.com/technoblogy/ulisp-riscv.
Other platforms
These versions are also available, but are not currently up to date with the newer features:
MSP430 version
Download the version of uLisp for the Energia MSP430 platforms here:
MSP430 Version 2.7c - 20th June 2019
or get it from GitHub at https://github.com/technoblogy/ulisp-msp430.
STM32 version
Download the STM32 version of uLisp for the Maple Mini and Blue Pill platforms here:
STM32 Version 3.0b - 11th January 2020
or get it from GitHub at https://github.com/technoblogy/ulisp-stm32.
Installing uLisp
This download is a single text file. To compile it in the Arduino or Energia IDE either save it as a text file and rename it to a .cpp file, or copy and paste the text into a new empty project file.
Download the latest Arduino IDE from arduino.cc, or the latest Energia IDE from energia.nu.
To install uLisp on the BBC Micro Bit see BBC Micro:bit.
If you're using uLisp with the Arduino IDE on Debian or OpenBSD see these threads on GitHub: https://github.com/technoblogy/ulisp/pull/2 and https://github.com/technoblogy/ulisp/pull/22.
Note that saved images are not generally compatible between different versions of uLisp.
Compile options
The uLisp sources provide the following compile options:
| Option | Default | Description |
| checkoverflow * | enabled | Generates an error if underflow/overflow occurs in arithmetic operations. |
| resetautorun | disabled | Loads, and optionally runs, an image using load-image on reset. |
| printfreespace | enabled | Prints the number of free objects before the uLisp prompt. |
| printgcs | disabled | Prints the amount of space reclaimed after each garbage collection. |
| sdcardsupport | disabled | Provides SD card support using with-sd-card. |
| gfxsupport ** | disabled | Provides graphics extensions for use with a suitable display. |
| lisplibrary | disabled | Evaluates the Lisp definitions provided in the Lisp Library on reset. |
| assemblerlist *** | enabled | Generates an assembler listing from defcode. |
| lineeditor | disabled | Provides a line editor for use when using uLisp from a terminal. |
| vt100 | disabled | Provides parenthesis matching on VT100-compatible terminals. |
* Not applicable to the versions with floating point.
** Only applicable to the versions with graphics extensions; currently ARM, ESP, and RISC-V.
*** Only applicable to versions with defcode; currently ARM and RISC-V.
Older versions
See Older versions.
Test suites
The following files contains test suites I use for testing each release of uLisp. You may find these useful if you are porting uLisp to another platform:
Test suite - 8/16-bit version (ATmega and MSP430)
Test suite - 32-bit version (ARM and ESP8266)
Test suite - Floating point (ARM and ESP8266)