Oni-Framework

إطار عمل أوني هو منصة لتطوير برمجيات الأجهزة المضمنة. يتم استخدامه من أجل تصحيح الأخطاء عن بعد / إضافة وظائف لجهاز مضمن. في الوقت الحالي، المفاهيم الرئيسية هي نظام إضافات كامل معيارية، مع استدعاء إجراء بعيد محلي وعن بعد (rpc). تم تصميم هذا ليعمل على مستوى الامتياز ring-0، ولكن مع بعض التعديلات يمكن استخدامه أيضًا على مستويات ring-3. يُحذَّر، هذا ليس للاستخدام الإنتاجي، فقط للمطورين الذين يريدون منصة بناء سهلة للبحث.

• حالياً هذا المشروع قيد التطوير، وقد لا يكون مختبراً بالكامل
• سيحتاج معرفة جيدة بـ C/C#
• سحر

ميزات جديدة!

الميزات المدعومة حالياً

• نظام RPC محلي وعن بعد قوي بالكامل
• جميع الوظائف المستخدمة تم ترميزها مؤقتاً لتسهيل النقل إلى منصات مختلفة
• أداة نقل الملفات
• نظام تسجيل ملون (يعمل عبر UART مع PUTTY)

الميزات المخطط لها:

• إطار عمل التصحيح
• إدارة الحزم عن بعد وتثبيتها
• الاتصال بين الأجهزة
• تحميل وتفريغ وحدات الإضافات القابلة للتبديل السريع
• التصعيد الذاتي من ring-3 إلى ring-0 (BYO-EntryPoint)

البناء والتثبيت

يتطلب إطار عمل Oni-Framework فقط أن تقوم باستعراض هذا الدليل وتنفيذ ملف oni/utils/kdlsym/default.h مع جميع التطبيقات المطلوبة. بعد ذلك، يجب أن يتم تجميعه بشكل جيد باستخدام gcc أو clang وينتج ملفًا تنفيذيًا. ستحتاج إلى طريقة تنفيذ خاصة بك (BYO-execution method)، لكن بالنسبة لمعظم الأجهزة المضمنة يمكن تحقيق ذلك عبر شل ssh، أو شل عبر telnet، أو أي شل من هذا القبيل. قد تحتاج الأجهزة الأخرى إلى التحميل في سياق الذاكرة قيد التشغيل، ثم القفز إلى main الذي سيتولى جميع مشكلات التهيئة.

1. استنساخ المستودع git clone https://github.com/kiwidoggie/oni-framework.git أ. اختياري: تعيين موقع رؤوس FreeBSD export BSD_INC="/path/to/freebsd/headers/include"
2. إذا كنت تقوم بالبناء لأول مرة، يجب تشغيل make create الذي سينشئ هيكل المجلدات
3. بناء باستخدام make أ. إذا لم تقم بتعيين متغير البيئة، يمكنك البناء باستخدام make BSD_INC=/path/to/freebsd/headers/include

النقل إلى منصات مختلفة

لا يعتمد Oni-Framework على مكتبة libc كاملة الوظائف، وهو مبني للبناء والتشغيل بشكل مستقل تمامًا (بشرط توفر جميع المتطلبات الأساسية). بدلاً من ذلك، يتم تجميع الوظائف المطلوبة من الحد الأدنى من الوظائف الموجودة إما في سياق عملية قيد التشغيل، أو سياق النواة (الأخير هو الوحيد المختبر).

1. إنشاء هدف kdlsym جديد (حل الرموز الديناميكية للنواة) عن طريق إنشاء رأس جديد في include/oni/utils/kdlsym/my_platform.h
2. نسخ ولصق محتويات include/oni/utils/kdlsym/default.h إلى ملف الرأس الذي أنشأته حديثًا
3. إضافة هدفك الجديد إلى include/oni/utils/kdlsym.h

#if ONI_PLATFORM==ONI_UNKNOWN_PLATFORM
#include "kdlsym/default.h"
#elif ...
#elif ONI_PLATFORM==ONI_MY_PLATFORM
#include "kdlsym/my_platform.h"
#endif

4. إضافة هدفك إلى ملف التكوين الموجود في include/oni/config.h

// Unknown device
#define ONI_UNKNOWN_PLATFORM		-1
#define ONI_MY_PLATFORM		5

5. تغيير هدف البناء الحالي عن طريق تغيير #define ONI_PLATFORM ONI_UNKNOWN_PLATFORM إلى #define ONI_PLATFORM ONI_MY_PLATFORM

المطورون

إذا كنت ترغب في المساهمة، فقط قم بتقديم طلب سحب (pull request). بخلاف ذلك، لا يوجد دعم حقيقي لهذا في الوقت الحالي. قد يتغير هذا في المستقبل

@diwidog

تخطيط الرسالة