AtomVM

Atomvm

Membawa Erlang, Elixir dan bahasa fungsional lainnya ke sistem yang sangat kecil.

ATOMVM IMPLEMEN DARI SCRORM ERLANG VM minimal yang mendukung subset fitur ERLANGVM dan yang mampu menjalankan binari balok yang tidak dimodifikasi pada sistem yang sangat kecil seperti MCU.

Platform yang didukung

• Linux, MacOS, FreeBSD, Dragonfly (generic_unix)
• ESP32 SOC (dengan IDF/FREERTOS, lihat ESP32)
• STM32 MCUS (dengan libopencm3, lihat STM32)
• Raspberry Pi Pico dan Pico 2 (lihat RP2)
• Browser dan NodeJs dengan WebAssembly (lihat Emscripten)

ATOMVM bertujuan untuk mudah portabel ke platform baru dengan upaya minimum, sehingga platform tambahan mungkin didukung dalam waktu dekat.

Memulai

Ada lebih banyak informasi, termasuk "panduan memulai" yang lebih lengkap, contoh, instruksi pembuatan terperinci, dan informasi kontak yang tersedia di situs web Proyek ATOMVM.

Jangan lupa untuk memeriksa repositori contoh untuk membantu Anda memulai proyek IoT Anda berikutnya.

Tolong, gunakan rilis v0.6.x, cabang utama adalah untuk tujuan pengembangan dan mungkin tidak stabil.

Dependensi

Diperlukan untuk membangun:

• CMAKE (CMAKE Build System)
• GPERF (GNU Perfect Hash Function Generator)
• ERLC (Kompiler Erlang)
• Elixirc (kompiler elixir)
• Rebar3 (alat build rebar3)
• MBED TLS (Portable TLS Library, secara opsional diperlukan untuk mendukung SSL)
• Zlib (Zlib Compression and Decompression Library)

Dokumentasi dan Cakupan:

• GCOV dan LCOV secara opsional diminta untuk menghasilkan laporan cakupan ( make coverage ).
• Untuk persyaratan pembangunan dokumentasi, konsultasikan dengan dokumentasi, readme.

Instruksi pembuatan langkah demi langkah (platform UNIX generik)

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

Jalankan tes dalam Direktori Build dengan:

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

Instruksi build lengkap tersedia dalam dokumentasi untuk UNIX generik (Linux, MacOS, FreeBSD, Dragonfly), ESP32, STM32, Raspberry Pi Pico dan PICO 2 (RP2), dan WASM (NodeJS/Web).

Status proyek

AtomVM masih dalam tahap awal, tetapi dapat menjalankan aplikasi sederhana yang mirip dengan yang tersedia dalam contoh dan tes.

Atomvm mungkin macet dengan pesan serupa:

 Undecoded opcode: 15
Aborted (core dumped)

Ini pada dasarnya berarti bahwa instruksi belum diimplementasikan, atau bahwa versi yang sudah ketinggalan zaman telah digunakan. Tolong, pastikan untuk selalu menjalankan AtomVM menggunakan versi terbaru.

Keterbatasan yang diketahui

Proyek ini sedang dalam proses, jadi ada beberapa batasan yang diketahui, yang akan mencegah untuk menjalankan perangkat lunak yang tidak dimodifikasi, beberapa di antaranya adalah:

• Ada pustaka standar minimal, sehingga beberapa fungsi standar hilang.
• Beberapa instruksi belum diimplementasikan.

Semua batasan ini akan diperbaiki dalam waktu yang wajar.

Tentang proyek ini

Proyek ini telah dibuat oleh Davide Bettio, dan sekarang dikembangkan dari semakin banyak kontributor.

Bagaimana berkontribusi

Segala jenis kontribusi diterima, Anda dapat berkontribusi pada repositori ini dengan meningkatkan mesin virtual, perpustakaan inti atau dokumentasi atau dengan berkontribusi pada salah satu repositori organisasi.

Lisensi

Proyek ini berada di bawah ketentuan lisensi Apache 2.0.