Release Notes
Welcome to AtomVM 0.6.0-dev+git.22266692
These release notes provide information about the current release of AtoVM.
Required Software
The following software is required to develop Erlang or Elixir applications on AtomVM:
The
esptool
program, for flashing the AtomVM image and AtomVM programs to ESP32 MCUs.An Erlang/OTP compiler (
erlc
)The Elixir runtime, if developing Elixir applications.
A serial console program, such as
minicom
orscreen
, so that you can view console output from your AtomVM application.(recommended) For Erlang programs,
rebar3
(recommended) For Elixir programs,
mix
, which ships with the Elixir runtime.
AtomVM will run BEAM files that have been compiled using the following Erlang and Elixir versions:
Erlang Version |
Elixir Version |
---|---|
✅ OTP 21 |
✅ 1.7 |
✅ OTP 22 |
✅ 1.8 |
✅ OTP 23 |
✅ 1.11 |
✅ OTP 24 |
✅ 1.14 |
✅ OTP 25 |
✅ 1.14 |
✅ OTP 26* |
✅ 1.15* |
*
OTP 26 is still a release candidate and should be considered experimental.
Other versions of Elixir that are compatible with a particular OTP version may work, this chart reflects the versions that are tested.
Note. Not all BEAM instructions are supported for every Erlang and Elixir compiler. For details about which instructions are supported, see the
src/libAtomVM/opcodes.h
header file in the AtomVM github repository corresponding to the current release.
ESP32 Build requirements
This is entirely optional, you may simply use the downloadable images and flash them to your esp32 using esptool
, but if you wish to work on development of the VM or use one on the additional drivers that are available in the (AtomVM repositories) you will need a compatible version of (Espressif’s) ESP-IDF.
Espressif provides excellent installation documentation on their website at:
https://docs.espressif.com/projects/esp-idf/en/release-v4.4/esp32/get-started/index.html
AtomVM currently supports the following versions of ESP-IDF:
Espressif supported versions |
AtomVM support |
---|---|
ESP-IDF v4.2 |
✅ |
ESP-IDF v4.3 |
✅ |
ESP-IDF v4.4 |
✅ |
ESP-IDF v5.0 |
❌ |
Support is planned for version 5.0…
For detailed information about features and bug fixes in the current release, see the AtomVM Change Log.