AtomVM

atomvm

يجلب Erlang و Elixir واللغات الوظيفية الأخرى إلى أنظمة صغيرة حقًا.

تنفذ ATOMVM من الصفر الحد الأدنى من Erlang VM يدعم مجموعة فرعية من ميزات ErlangVM وهو قادر على تشغيل ثنائيات الشعاع غير المعدلة على أنظمة صغيرة حقًا مثل MCUs.

المنصات المدعومة

• Linux ، MacOS ، Freebsd ، Dragonfly (generic_unix)
• ESP32 SOC (مع IDF/Freertos ، انظر ESP32)
• STM32 MCUS (مع libopencm3 ، انظر STM32)
• Raspberry Pi Pico و Pico 2 (انظر RP2)
• المتصفحات والعقبات مع webassembly (انظر emscripten)

تهدف ATOMVM إلى أن تكون محمولة بسهولة إلى منصات جديدة بأقل جهد ، لذلك قد يتم دعم منصات إضافية في المستقبل القريب.

ابدء

هناك المزيد من المعلومات ، بما في ذلك "دليل البدء" الأكثر اكتمالا ، وأمثلة ، وإرشادات بناء مفصلة ، ومعلومات الاتصال المتاحة على موقع AtomVM Project.

لا تنس التحقق من مستودع الأمثلة لمساعدتك في البدء في مشروع إنترنت الأشياء التالي.

من فضلك ، استخدم إصدارات v0.6.x ، الفرع الرئيسي هو لأغراض التطوير وقد يكون غير مستقر.

التبعيات

مطلوب للبناء:

• Cmake (نظام بناء cmake)
• GPERF (GNU مثالية مولد وظيفة التجزئة)
• ERLC (مترجم إرلانج)
• Elixirc (برنامج التحويل البرمجي Elixir)
• حديد التسليح 3 (أداة بناء حديد التسليح 3)
• MBED TLS (مكتبة TLS المحمولة ، مطلوب اختياريا لدعم SSL)
• Zlib (ضغط Zlib ومكتبة إلغاء الضغط)

الوثائق والتغطية:

• مطلوب اختياريا GCOV و LCOV لإنشاء تقرير التغطية ( make coverage ).
• لمتطلبات بناء الوثائق ، استشر الوثائق ReadMe.

تعليمات بناء خطوة بخطوة (منصة 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) ، و WASM (NodeJS/WEB).

حالة المشروع

لا يزال ATOMVM في مراحله المبكرة ، ولكن يمكنه تشغيل تطبيقات بسيطة مماثلة لتلك المتاحة في الأمثلة والاختبارات.

قد تتعطل Atomvm برسالة مماثلة:

 Undecoded opcode: 15
Aborted (core dumped)

هذا يعني في الأساس أنه لم يتم تنفيذ التعليمات بعد ، أو أنه تم استخدام نسخة عفا عليها الزمن. من فضلك ، تأكد من تشغيل AtomVM دائمًا باستخدام أحدث إصدار.

القيود المعروفة

هذا المشروع هو عمل مستمر ، لذلك هناك العديد من القيود المعروفة ، التي ستمنع تشغيل البرامج غير المعدلة ، وبعضها:

• هناك الحد الأدنى من المكتبة القياسية ، لذلك هناك العديد من الوظائف القياسية مفقودة.
• لم يتم تنفيذ العديد من التعليمات بعد.

سيتم إصلاح كل هذه القيود في فترة زمنية معقولة.

حول هذا المشروع

تم إنشاء هذا المشروع بواسطة Davide Bettio ، وتم تطويره الآن من عدد متزايد من المساهمين.

كيفية المساهمة

أي نوع من المساهمة موضع ترحيب ، يمكنك إما المساهمة في هذا المستودع من خلال تحسين الجهاز الظاهري أو المكتبات الأساسية أو الوثائق أو عن طريق المساهمة في أي من مستودعات المؤسسة.

رخصة

هذا المشروع تحت شروط ترخيص Apache 2.0.