libmodbus

مكتبة مودبوس رائعة

ملخص

Libmodbus هي مكتبة برامج مجانية لإرسال/تلقي البيانات باستخدام جهاز يحترم بروتوكول Modbus. يمكن لهذه المكتبة استخدام منفذ تسلسلي أو اتصال Ethernet.

تم اشتقاق الوظائف المدرجة في المكتبة من دليل مرجع بروتوكول Modicon Modbus والذي يمكن الحصول عليه من www.modbus.org.

ترخيص libmodbus هو LGPL v2.1 أو أحدث .

الموقع الرسمي هو www.libmodbus.org. يحتوي الموقع على أحدث إصدار من الوثائق.

المكتبة مكتوبة في C ومصممة لتشغيل على Linux و Mac OS X و FreeBSD و Embox و QNX و Windows.

يمكنك استخدام المكتبة على MCU مع EMBox RTOs.

تثبيت

ستحتاج فقط إلى تثبيت Automake و AutoconF و LIBTOOL و CENTER (GCC أو CLANG) لتجميع المكتبة و ASCIIDOC و XMLTO لإنشاء الوثائق (اختياري).

للتثبيت ، فقط قم بتشغيل الرقص المعتاد ، ./configure && make install . قم بتشغيل ./autogen.sh أولاً لإنشاء البرنامج النصي configure إذا لزم الأمر.

يمكنك تغيير دليل التثبيت مع خيار البادئة ، على سبيل المثال. ./configure --prefix=/usr/local/ . يجب عليك التحقق من أن مسار مكتبة التثبيت يتم إعداده بشكل صحيح على نظامك ( /ETC/LD.SO.SO.CONF.D ) وأن ذاكرة التخزين المؤقت للمكتبة محدثة (قم بتشغيل ldconfig كجذر إذا لزم الأمر).

توفر المكتبة ملف libmodbus.pc لاستخدامه مع pkg-config لتخفيف تجميع البرنامج وربطه.

إذا كنت ترغب في التجميع مع Microsoft Visual Studio ، فيجب عليك اتباع الإرشادات في ./src/win32/README.md .

للتجميع تحت Windows ، قم بتثبيت MingW و MSYS ثم حدد الحزم الشائعة (GCC ، Automake ، Libtool ، إلخ). الدليل ./SRC/WIN32/ يحتوي على مشروع V Visual C.

للتجميع تحت OS X مع Homebrew ، ستحتاج إلى تثبيت التبعيات التالية أولاً: brew install autoconf automake libtool .

للبناء تحت Embox ، يجب عليك استخدام نظام البناء الخاص به.

الاختبار

يتم توفير بعض الاختبارات في دليل الاختبارات ، يمكنك تحرير الكود المصدر بحرية لتناسب احتياجاتك (إنه برنامج مجاني :).

انظر الاختبارات/ReadMe للحصول على وصف لكل برنامج.

لاختبار سريع لـ libmodbus ، يمكنك تشغيل البرامج التالية في قشتين:

1. ./unit-test-server
2. ./unit-test-client

بشكل افتراضي ، سيتم تنفيذ جميع اختبارات وحدة TCP (انظر -Help for Options).

من الممكن أيضًا تشغيل اختبارات الوحدة باستخدام make check .

للإبلاغ عن خطأ أو للمساهمة

انظر وثيقة المساهمة.

الوثائق

يمكنك خدمة الوثائق المحلية مع:

pip install mkdocs-material
mkdocs serve