AtomVM

Atomvm

Lleva a Erlang, Elixir y otros idiomas funcionales a sistemas realmente pequeños.

AtomVM implementa desde cero una VM de Erlang mínima que admite un subconjunto de características de ERLANGVM y que puede ejecutar binarios de haz sin modificar en sistemas realmente pequeños como MCU.

Plataformas compatibles

• Linux, MacOS, FreeBSD, Dragonfly (Generic_unix)
• ESP32 SOC (con IDF/Freertos, ver ESP32)
• STM32 MCU (con libopencm3, ver STM32)
• Raspberry Pi Pico y Pico 2 (ver RP2)
• Navegadores y nodejs con WebAssembly (ver Emscripten)

AtomVM tiene como objetivo ser fácilmente portátil a nuevas plataformas con un esfuerzo mínimo, por lo que las plataformas adicionales podrían ser compatibles en un futuro cercano.

Empezando

Hay mucha más información, incluida una "Guía de inicio" más completa, ejemplos, instrucciones de compilación detalladas e información de contacto disponible en el sitio web del proyecto AtomVM.

No olvide ver el repositorio de ejemplos para ayudarlo a comenzar su próximo proyecto IoT.

Por favor, use las versiones V0.6.X, la rama principal es para fines de desarrollo y puede ser inestable.

Dependencias

Requerido para la construcción:

• CMake (sistema de compilación Cmake)
• GPerf (GNU Perfect Hash Function Generator)
• ERLC (compilador de Erlang)
• Elixirc (compilador de elixir)
• ReRar3 (herramienta de construcción de barras de refuerzo)
• MBED TLS (biblioteca TLS portátil, opcionalmente requerida para admitir SSL)
• ZLIB (Biblioteca de compresión y descompresión de ZLIB)

Documentación y cobertura:

• Se requieren opcionalmente GCOV y LCOV para generar un informe de cobertura ( make coverage ).
• Para los requisitos de compilación de documentación, consulte la documentación ReadMe.

Instrucciones de compilación paso a paso (plataforma Unix genérica)

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

Ejecutar pruebas dentro del directorio de compilación con:

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

Las instrucciones completas de compilación están disponibles en la documentación para unix genérico (Linux, MacOS, FreeBSD, Dragonfly), ESP32, STM32, Raspberry Pi Pico y Pico 2 (RP2) y WASM (NodeJS/Web).

Estado del proyecto

AtomVM todavía está en sus primeras etapas, pero puede ejecutar aplicaciones simples similares a las disponibles en ejemplos y pruebas.

AtomVM podría bloquearse con un mensaje similar:

 Undecoded opcode: 15
Aborted (core dumped)

Básicamente, esto significa que aún no se ha implementado una instrucción, o que se ha utilizado una versión obsoleta. Por favor, asegúrese de ejecutar siempre AtomVM usando la última versión.

Limitaciones conocidas

Este proyecto es un trabajo en progreso, por lo que hay varias limitaciones conocidas, que evitarán ejecutar software no modificado, algunos de ellos son:

• Hay una biblioteca estándar mínima, por lo que faltan varias funciones estándar.
• Aún no se implementan varias instrucciones.

Todas estas limitaciones se fijarán en un tiempo razonable.

Sobre este proyecto

Este proyecto ha sido creado por Davide Bettio, y ahora se desarrolla a partir de un número creciente de contribuyentes.

Cómo contribuir

Cualquier tipo de contribución es bienvenida, puede contribuir a este repositorio mejorando la máquina virtual, las bibliotecas centrales o la documentación o contribuyendo a cualquiera de los repositorios de la organización.

Licencia

Este proyecto está bajo los términos de la licencia Apache 2.0.