libmodbus

ห้องสมุด modbus groovy

ภาพรวม

Libmodbus เป็นไลบรารีซอฟต์แวร์ฟรีที่จะส่ง/รับข้อมูลด้วยอุปกรณ์ที่เคารพโปรโตคอล Modbus ไลบรารีนี้สามารถใช้พอร์ตอนุกรมหรือการเชื่อมต่ออีเธอร์เน็ต

ฟังก์ชั่นที่รวมอยู่ในไลบรารีได้มาจากคู่มืออ้างอิงโปรโตคอล Modicon Modbus ซึ่งสามารถรับได้จาก www.modbus.org

ใบอนุญาตของ Libmodbus คือ LGPL v2.1 หรือใหม่กว่า

เว็บไซต์อย่างเป็นทางการคือ www.libmodbus.org เว็บไซต์มีเอกสารเวอร์ชันล่าสุด

ไลบรารีเขียนด้วย C และออกแบบมาเพื่อทำงานบน Linux, Mac OS X, FreeBSD, Embox, QNX และ Windows

คุณสามารถใช้ไลบรารีบน MCUs ด้วย embox RTOS

การติดตั้ง

คุณจะต้องติดตั้ง Automake, AutoConf, Libtool และ C Compiler (GCC หรือ Clang) เพื่อรวบรวมไลบรารีและ Asciidoc และ XMLTO เพื่อสร้างเอกสาร (ไม่บังคับ)

ในการติดตั้งเพียงเรียกใช้การเต้นรำปกติ. ./configure && make install Run ./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/ มีโครงการ Visual C

ในการรวบรวมภายใต้ OS X ด้วย Homebrew คุณจะต้องติดตั้งการอ้างอิงต่อไปนี้ก่อน: brew install autoconf automake libtool

ในการสร้างภายใต้ Embox คุณต้องใช้ระบบบิลด์

การทดสอบ

การทดสอบบางอย่างมีให้ในไดเรกทอรี การทดสอบ คุณสามารถแก้ไขซอร์สโค้ดได้อย่างอิสระเพื่อให้เหมาะกับความต้องการของคุณ (เป็นซอฟต์แวร์ฟรี :)

ดู การทดสอบ/readme สำหรับคำอธิบายของแต่ละโปรแกรม

สำหรับการทดสอบอย่างรวดเร็วของ Libmodbus คุณสามารถเรียกใช้โปรแกรมต่อไปนี้ในสองเชลล์:

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

โดยค่าเริ่มต้นการทดสอบหน่วย TCP ทั้งหมดจะถูกดำเนินการ (ดู -HELP สำหรับตัวเลือก)

นอกจากนี้ยังเป็นไปได้ที่จะเรียกใช้การทดสอบหน่วยด้วย make check

เพื่อรายงานข้อผิดพลาดหรือมีส่วนร่วม

ดูเอกสารที่มีส่วนร่วม

เอกสาร

คุณสามารถให้บริการเอกสารท้องถิ่นด้วย:

pip install mkdocs-material
mkdocs serve