تنزيل nanopb - تنزيل كود مصدر nanopb

nanopb

كود مصدر C#

1.0.0

تنزيل

Nanopb - مخازن البروتوكول المؤقتة للأنظمة المدمجة

Nanopb عبارة عن تطبيق صغير الحجم لمخازن البروتوكول المؤقتة في ansi C. وهو مناسب بشكل خاص للاستخدام في وحدات التحكم الدقيقة، ولكنه يناسب أي نظام مقيد بالذاكرة.

الصفحة الرئيسية: https://jpa.kapsi.fi/nanopb/
مستودع جيت: https://github.com/nanopb/nanopb/
التوثيق: https://jpa.kapsi.fi/nanopb/docs/
المنتدى: https://groups.google.com/forum/#!forum/nanopb
تنزيلات الإصدار الثابت: https://jpa.kapsi.fi/nanopb/download/
الحزم الثنائية السابقة للإصدار: https://github.com/nanopb/nanopb/actions/workflows/binary_packages.yml

باستخدام مكتبة النانو

لاستخدام مكتبة nanopb، عليك القيام بأمرين:

قم بتجميع ملفات .proto الخاصة بك لـ nanopb، باستخدام protoc .
قم بتضمين pb_encode.c و pb_decode.c و pb_common.c في مشروعك.

أسهل طريقة للبدء هي دراسة المشروع من خلال "أمثلة/بسيطة". يحتوي على ملف Makefile، والذي يجب أن يعمل مباشرة مع معظم أنظمة Linux. ومع ذلك، بالنسبة لأي نوع آخر من أنظمة البناء، راجع الخطوات اليدوية في ملف README.txt الموجود في هذا المجلد.

توليد الرؤوس

يتم تعريف رسائل مخازن البروتوكول المؤقتة في ملف .proto ، الذي يتبع تنسيقًا قياسيًا متوافقًا مع كافة مكتبات مخازن البروتوكول المؤقتة. لاستخدامه مع nanopb، تحتاج إلى إنشاء ملفات .pb.c و .pb.h منه:

 python generator/nanopb_generator.py myprotocol.proto  # For source checkout
generator-bin/nanopb_generator myprotocol.proto        # For binary package

(ملاحظة: للحصول على تعليمات حول nanopb-0.3.9.x والإصدارات الأقدم، راجع وثائق هذا الإصدار المحدد هنا)

يجب أن تحتوي الحزم الثنائية لأنظمة التشغيل Windows وLinux وMac OS X على جميع التبعيات الضرورية، بما في ذلك Python ومكتبة python-protobuf وprotoc. إذا كنت تستخدم git checkout أو توزيعة مصدر عادي، فستحتاج إلى تثبيت Python بشكل منفصل. بمجرد حصولك على Python، يمكنك تثبيت التبعيات الأخرى باستخدام pip install --upgrade protobuf grpcio-tools .

يمكنك تخصيص إنشاء الرأس بشكل أكبر عن طريق إنشاء ملف .options . انظر الوثائق للحصول على التفاصيل.

تشغيل الاختبارات

إذا كنت ترغب في إجراء مزيد من التطوير لنواة nanopb، أو التحقق من وظائفها باستخدام المترجم والنظام الأساسي الخاصين بك، فستحتاج إلى تشغيل مجموعة الاختبار. يتم تنفيذ قواعد البناء لمجموعة الاختبار باستخدام Scons، لذلك تحتاج إلى تثبيتها (على سبيل المثال: sudo apt install scons أو pip install scons ). لتشغيل الاختبارات:

 cd tests
scons

سيُظهر هذا التقدم في حالات الاختبار المختلفة. إذا لم ينته الإخراج بخطأ، فهذا يعني أن حالات الاختبار كانت ناجحة.

ملاحظة: يقوم نظام التشغيل Mac OS X افتراضيًا باستخدام الأسماء المستعارة لـ "clang" كـ "gcc"، بينما لا يدعم فعليًا نفس خيارات سطر الأوامر التي يدعمها gcc. لإجراء الاختبارات على نظام التشغيل Mac OS X، استخدم: scons CC=clang CXX=clang++ . يمكن استخدام نفس الطريقة لإجراء الاختبارات مع مترجمين مختلفين على أي نظام أساسي.

بالنسبة للأنظمة الأساسية المضمنة، يوجد حاليًا دعم لتشغيل الاختبارات على لوحة الاكتشاف STM32 ومحاكي simavr AVR. استخدم scons PLATFORM=STM32 و scons PLATFORM=AVR لتشغيل هذه الاختبارات.

بناء النظم والتكامل

تم تصميم كود Nanopb C نفسه ليكون محمولاً وسهل البناء على أي نظام أساسي. غالبًا ما تكون العقبة الأكبر هي تشغيل المولد الذي يستقبل ملفات .proto ويخرج تعريفات .pb.c .

توجد قواعد بناء لعدة أنظمة: