libmodbus

Uma biblioteca Groovy Modbus

Visão geral

O LibModbus é uma biblioteca de software livre para enviar/receber dados com um dispositivo que respeite o protocolo Modbus. Esta biblioteca pode usar uma porta serial ou uma conexão Ethernet.

As funções incluídas na biblioteca foram derivadas do guia de referência do protocolo Modicon Modbus, que pode ser obtido em www.modbus.org.

A licença do libmodbus é LGPL v2.1 ou posterior .

O site oficial é www.libmodbus.org. O site contém a versão mais recente da documentação.

A biblioteca é escrita em C e projetada para ser executada no Linux, Mac OS X, FreeBSD, Embox, QNX e Windows.

Você pode usar a biblioteca no MCUS com o Embox RTOs.

Instalação

Você só precisará instalar o Autorake, Autoconf, Libtool e um compilador C (GCC ou CLANG) para compilar a biblioteca e asciidoc e xmlto para gerar a documentação (opcional).

Para instalar, basta executar a dança usual, ./configure && make install . Execute ./autogen.sh primeiro para gerar o script configure , se necessário.

Você pode alterar o diretório de instalação com a opção Prefixo, por exemplo. ./configure --prefix=/usr/local/ . Você deve verificar se o caminho da biblioteca de instalação está configurado corretamente no seu sistema ( /etc/ld.so.conf.d ) e o cache da biblioteca está atualizado (execute ldconfig conforme root, se necessário).

A biblioteca fornece um arquivo libmodbus.pc a ser usado com pkg-config para facilitar a compilação e a ligação do programa.

Se você deseja compilar com o Microsoft Visual Studio, siga as instruções em ./src/win32/README.md .

Para compilar no Windows, instale Mingw e MSYs e selecione os pacotes comuns (GCC, Autorake, Libtool, etc.). O diretório ./src/win32/ contém um projeto C Visual C.

Para compilar no OS X com o HomeBrew, você precisará instalar as seguintes dependências primeiro: brew install autoconf automake libtool .

Para construir no Embox, você deve usar seu sistema de construção.

Teste

Alguns testes são fornecidos no diretório de testes , você pode editar livremente o código -fonte para atender às suas necessidades (é um software livre :).

Consulte Testes/ReadMe para obter uma descrição de cada programa.

Para um teste rápido do Libmodbus, você pode executar os seguintes programas em dois conchos:

1. ./Unit-Test-Server
2. ./unit-test-client

Por padrão, todos os testes de unidade TCP serão executados (consulte -Help para opções).

Também é possível executar os testes de unidade com make check .

Para relatar um bug ou contribuir

Consulte o documento contribuinte.

Documentação

Você pode servir a documentação local com:

pip install mkdocs-material
mkdocs serve