AtomVM

Atomvm

Bringt Erlang, Elixir und andere funktionale Sprachen in wirklich kleine Systeme.

Atomvm implementiert von Grund auf eine minimale Erlang -VM, die eine Untergruppe von Erlangvm -Funktionen unterstützt und in der Lage ist, nicht modifizierte Strahlbinärdateien auf wirklich kleinen Systemen wie MCUs auszuführen.

Unterstützte Plattformen

• Linux, MacOS, FreeBSD, Dragonfly (generic_unix)
• ESP32 SOC (mit IDF/Freertos, siehe ESP32)
• STM32 MCUS (mit libopencm3 siehe STM32)
• Raspberry Pi Pico und Pico 2 (siehe RP2)
• Browser und NodeJs mit WebAssembly (siehe Emscripten)

Atomvm zielt darauf ab, mit einem Mindestaufwand für neue Plattformen leicht tragbar zu sein. Daher können in naher Zukunft zusätzliche Plattformen unterstützt werden.

Erste Schritte

Es finden Sie viel mehr Informationen, einschließlich eines vollständigeren "Erste -Start -Leitfadens", Beispielen, detaillierten Build -Anweisungen und Kontaktinformationen, die auf der ATOMVM -Projektwebsite verfügbar sind.

Vergessen Sie nicht, das Beispiele -Repository zu überprüfen, um Ihnen bei Ihrem nächsten IoT -Projekt zu starten.

Bitte verwenden Sie V0.6.x -Veröffentlichungen, der Hauptzweig dient zu Entwicklungszwecken und kann instabil sein.

Abhängigkeiten

Für den Bau erforderlich:

• CMAKE (CMAKE -Build -System)
• GPERF (GNU Perfect Hash -Funktion Generator)
• ERLC (Erlang Compiler)
• Elixirc (Elixir Compiler)
• rebar3 (rebar3 build tool)
• MBED TLS (tragbare TLS -Bibliothek, optional erforderlich, um SSL zu unterstützen)
• ZLIB (ZLIB -Komprimierung und Dekompressionsbibliothek)

Dokumentation und Berichterstattung:

• GCOV und LCOV sind optional erforderlich, um Deckungsbericht zu erstellen ( make coverage ).
• Für Dokumentationsbauanforderungen wenden Sie sich an die Dokumentation Readme.

Schritt-für-Schritt-Build-Anweisungen (generische Unix-Plattform)

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

Führen Sie Tests innerhalb des Build -Verzeichnisses mit:

 $ ./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

Komplette Build -Anweisungen finden Sie in der Dokumentation für generische Unix (Linux, MacOS, FreeBSD, Dragonfly), ESP32, STM32, Raspberry Pi Pico und Pico 2 (RP2) und WASM (NodeJS/Web).

Projektstatus

Atomvm befindet sich noch in den frühen Stadien, kann jedoch einfache Anwendungen ausführen, die denen in Beispielen und Tests ähneln.

Atomvm kann mit einer ähnlichen Nachricht abstürzen:

 Undecoded opcode: 15
Aborted (core dumped)

Dies bedeutet im Grunde, dass noch keine Anweisung implementiert wurde oder dass eine veraltete Version verwendet wurde. Bitte vergewissern Sie sich, dass Sie Atomvm immer mit der neuesten Version ausführen.

Bekannte Einschränkungen

Dieses Projekt ist in Arbeit, daher gibt es einige bekannte Einschränkungen, die verhindern, dass unmodifizierte Software ausgeführt wird. Einige davon sind:

• Es gibt eine minimale Standardbibliothek, sodass fehlen mehrere Standardfunktionen.
• Mehrere Anweisungen werden noch nicht implementiert.

Alle diese Einschränkungen werden in angemessener Zeit festgelegt.

Über dieses Projekt

Dieses Projekt wurde von Davide Bettio erstellt und wird nun aus einer wachsenden Anzahl von Mitwirkenden entwickelt.

Wie man beiträgt

Jede Art von Beitrag ist willkommen. Sie können entweder zu diesem Repository beitragen, indem Sie die virtuelle Maschine, die Kernbibliotheken oder die Dokumentation verbessern oder zu einer der Organisationsrepositorys beitragen.

Lizenz

Dieses Projekt steht unter den Bestimmungen der Apache 2.0 -Lizenz.