AtomVM

atomvm

將Erlang，Elixir和其他功能性語言帶入真正的小型系統。

ATOMVM從頭開始實現了一個最小的Erlang VM，該VM支持ERLANGVM功能的一個子集，並且能夠在MCUS（例如MCUS）上運行未修改的光束二進製文件。

支持的平台

• Linux，MacOS，FreeBSD，Dragonfly（generic_unix）
• ESP32 SOC（使用IDF/Freertos，請參閱ESP32）
• STM32 MCUS（使用libopencm3，請參見STM32）
• Raspberry pi pico和pico 2（請參閱RP2）
• 帶有WebAssembly的瀏覽器和nodejs（請參閱Emscripten）

ATOMVM的目的是輕鬆地用於最低限度的新平台，因此在不久的將來可能會支持其他平台。

入門

還有更多信息，包括更完整的“入門指南”，示例，詳細的構建說明以及ATOMVM Project網站上可用的聯繫信息。

不要忘記查看示例存儲庫，以幫助您開始下一個IoT項目。

請使用v0.6.x版本，主要分支是出於開發目的，並且可能不穩定。

依賴性

建築所需的

• CMAKE（CMAKE構建系統）
• GPERF（GNU完美哈希功能生成器）
• ERLC（ERLANG編譯器）
• Elixirc（Elixir Compiler）
• rebar3（rebar3構建工具）
• MBED TLS（便攜式TLS庫，可選地支持SSL）
• Zlib（Zlib壓縮和減壓庫）

文檔和覆蓋範圍：

• 可選地需要GCOV和LCOV來生成覆蓋範圍報告（ make coverage ）。
• 對於文檔構建要求，請諮詢文檔讀數。

分步構建指令（通用UNIX平台）

 $ mkdir build
$ cd build
$ cmake ..
$ make
$ ./src/AtomVM ./examples/erlang/hello_world.avm

在構建目錄中運行測試：

 $ ./tests/test-erlang
$ ./tests/test-enif
$ ./tests/test-mailbox
$ ./tests/test-structs
$ ./src/AtomVM ./tests/libs/estdlib/test_estdlib.avm
$ ./src/AtomVM ./tests/libs/eavmlib/test_eavmlib.avm
$ ./src/AtomVM ./tests/libs/alisp/test_alisp.avm

完整的構建說明可在通用Unix（Linux，MacOS，FreeBSD，Dragonfly），ESP32，STM32，Raspberry Pi Pico和Pico 2（RP2）（RP2）和Wasm（Nodejs/web）的文檔中獲得。

項目狀態

ATOMVM仍處於早期階段，但是它可以運行與示例和測試中可用的應用程序相似的簡單應用程序。

ATOMVM可能會以類似的消息崩潰：

 Undecoded opcode: 15
Aborted (core dumped)

這基本上意味著尚未實施指令，或者已經使用了過時的版本。請確保始終使用最新版本運行ATOMVM。

已知限制

該項目正在進行中，因此有幾個已知限制，可以阻止運行未修改的軟件，其中一些是：

• 有一個最小的標準庫，因此缺少幾個標準功能。
• 尚未實施幾個說明。

所有這些限制都將在合理的時間內固定。

關於這個項目

該項目是由Davide Bettio創建的，現在是由越來越多的貢獻者開發的。

如何貢獻

歡迎任何類型的貢獻，您可以通過改進虛擬機，核心庫或文檔或向任何組織存儲庫做出貢獻來為該存儲庫做出貢獻。

執照

該項目按照Apache 2.0許可證的條款。