libmodbus

Групкая библиотека Modbus

Обзор

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 и C Compiler (GCC или Clang) для составления библиотеки и Asciidoc и XMLTO для генерации документации (необязательно).

Чтобы установить, просто запустите обычный танец, ./configure && make install . Запустите ./autogen.sh сначала для создания сценария configure , если это необходимо.

Вы можете изменить каталог установки с опцией префикса, например. ./configure --prefix=/usr/local/ . Вы должны убедиться, что путь библиотеки установки правильно настроен на вашей системе ( /etc/ld.so.conf.d ), а кэш библиотеки обновлен (запустите ldconfig как корень, если это необходимо).

Библиотека предоставляет файл libmodbus.pc для использования с pkg-config для облегчения компиляции вашей программы и связывания.

Если вы хотите компилировать с Microsoft Visual Studio, вам следует следовать инструкциям в ./src/win32/README.md .

Чтобы компилироваться под Windows, установите Mingw и MSYS, затем выберите общие пакеты (GCC, Automake, Libtool и т. Д.). Справочник ./SRC/WIN32/ содержит визуальный проект C.

Для компиляции под OS X с Homebrew вам нужно сначала установить следующие зависимости: brew install autoconf automake libtool .

Чтобы построить под Embox, вы должны использовать его систему сборки.

Тестирование

Некоторые тесты представлены в каталоге тестов , вы можете свободно отредактировать исходный код в соответствии с вашими потребностями (это бесплатное программное обеспечение :).

См. Tests/Readme для описания каждой программы.

Для быстрой проверки Libmodbus вы можете запустить следующие программы в двух оболочках:

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

По умолчанию будут выполнены все модульные тесты TCP (см. -Help для параметров).

Также можно запустить модульные тесты с помощью make check .

Сообщить об ошибке или внести свой вклад

См. Документ.

Документация

Вы можете служить местной документации с:

pip install mkdocs-material
mkdocs serve