00. 目錄

文章目錄

• • 00. 目錄
  • 01. modbus常用接口函數概述
  • 02. modbus輔助接口函數
  • 03. modbus功能接口函數
  • 04. modbus數據處理
  • 05. 附錄

01. modbus常用接口函數概述

libmodbus開發庫提供的所有接口API函數，其主要對象文件包括modbus.h和modbus.c，接口函數大致可以分為3類。

02. modbus輔助接口函數

modbus.c文件中輔助接口函數

//設置從站地址 MODBUS_API int modbus_set_slave(modbus_t* ctx, int slave); //獲取從站地址 MODBUS_API int modbus_get_slave(modbus_t* ctx); //設置錯誤恢復模式 MODBUS_API int modbus_set_error_recovery(modbus_t *ctx, modbus_error_recovery_mode error_recovery); //設置當前socket或者串口句柄 MODBUS_API int modbus_set_socket(modbus_t *ctx, int s); //獲取當前socket或者窗口句柄 MODBUS_API int modbus_get_socket(modbus_t *ctx);//獲取響應超時 MODBUS_API int modbus_get_response_timeout(modbus_t *ctx, uint32_t *to_sec, uint32_t *to_usec); //設置響應超時 MODBUS_API int modbus_set_response_timeout(modbus_t *ctx, uint32_t to_sec, uint32_t to_usec); //獲取連續字節之間的超時時間 MODBUS_API int modbus_get_byte_timeout(modbus_t *ctx, uint32_t *to_sec, uint32_t *to_usec); //設置連續字節之間的超時時間 MODBUS_API int modbus_set_byte_timeout(modbus_t *ctx, uint32_t to_sec, uint32_t to_usec);//獲取服務端等待客戶端請求超時時間 MODBUS_API int modbus_get_indication_timeout(modbus_t *ctx, uint32_t *to_sec, uint32_t *to_usec); //設置服務端等待客戶端請求超時時間 MODBUS_API int modbus_set_indication_timeout(modbus_t *ctx, uint32_t to_sec, uint32_t to_usec); //獲取報文頭長度 MODBUS_API int modbus_get_header_length(modbus_t *ctx); //用于主站設備與從站設備建立連接 MODBUS_API int modbus_connect(modbus_t *ctx); //關閉連接 MODBUS_API void modbus_close(modbus_t *ctx); //釋放內存 MODBUS_API void modbus_free(modbus_t *ctx); //刷新緩沖區 MODBUS_API int modbus_flush(modbus_t *ctx); //是否設置為debug模式 MODBUS_API int modbus_set_debug(modbus_t *ctx, int flag); //獲取當前錯誤信息 MODBUS_API const char *modbus_strerror(int errnum);

03. modbus功能接口函數

modbus.c文件中功能接口函數

//讀取線圈或者離散量輸出狀態(功能碼 0x1) MODBUS_API int modbus_read_bits(modbus_t *ctx, int addr, int nb, uint8_t *dest); //讀取離散量輸入值(功能碼 0x2) MODBUS_API int modbus_read_input_bits(modbus_t *ctx, int addr, int nb, uint8_t *dest); //讀取保持寄存器(功能碼 0x3) MODBUS_API int modbus_read_registers(modbus_t *ctx, int addr, int nb, uint16_t *dest); //讀取輸入寄存器(功能碼 0x4) MODBUS_API int modbus_read_input_registers(modbus_t *ctx, int addr, int nb, uint16_t *dest); //寫單個線圈或者單個離散量(功能碼 0x5) MODBUS_API int modbus_write_bit(modbus_t *ctx, int coil_addr, int status); //寫單個保持寄存器(功能碼 0x6) MODBUS_API int modbus_write_register(modbus_t *ctx, int reg_addr, const uint16_t value); //寫多個線圈(功能碼 0xF) MODBUS_API int modbus_write_bits(modbus_t *ctx, int addr, int nb, const uint8_t *data); //寫多個保持寄存器(功能碼 0x10) MODBUS_API int modbus_write_registers(modbus_t *ctx, int addr, int nb, const uint16_t *data); MODBUS_API int modbus_mask_write_register(modbus_t *ctx, int addr, uint16_t and_mask, uint16_t or_mask); MODBUS_API int modbus_write_and_read_registers(modbus_t *ctx, int write_addr, int write_nb,const uint16_t *src, int read_addr, int read_nb,uint16_t *dest); //報告從站ID(功能碼 0x11) MODBUS_API int modbus_report_slave_id(modbus_t *ctx, int max_dest, uint8_t *dest);

04. modbus數據處理

在libmodbus開發庫中，為了方便數據處理，在modbus.h文件中定義了一系列數據處理宏。

/*** UTILS FUNCTIONS**/ //獲取高字節 #define MODBUS_GET_HIGH_BYTE(data) (((data) >> 8) & 0xFF) //獲取低字節 #define MODBUS_GET_LOW_BYTE(data) ((data) & 0xFF) #define MODBUS_GET_INT64_FROM_INT16(tab_int16, index) \(((int64_t)tab_int16[(index) ] << 48) | \((int64_t)tab_int16[(index) + 1] << 32) | \((int64_t)tab_int16[(index) + 2] << 16) | \(int64_t)tab_int16[(index) + 3]) #define MODBUS_GET_INT32_FROM_INT16(tab_int16, index) \(((int32_t)tab_int16[(index) ] << 16) | \(int32_t)tab_int16[(index) + 1]) #define MODBUS_GET_INT16_FROM_INT8(tab_int8, index) \(((int16_t)tab_int8[(index) ] << 8) | \(int16_t)tab_int8[(index) + 1]) #define MODBUS_SET_INT16_TO_INT8(tab_int8, index, value) \do { \((int8_t*)(tab_int8))[(index) ] = (int8_t)((value) >> 8); \((int8_t*)(tab_int8))[(index) + 1] = (int8_t)(value); \} while (0) #define MODBUS_SET_INT32_TO_INT16(tab_int16, index, value) \do { \((int16_t*)(tab_int16))[(index) ] = (int16_t)((value) >> 16); \((int16_t*)(tab_int16))[(index) + 1] = (int16_t)(value); \} while (0) #define MODBUS_SET_INT64_TO_INT16(tab_int16, index, value) \do { \((int16_t*)(tab_int16))[(index) ] = (int16_t)((value) >> 48); \((int16_t*)(tab_int16))[(index) + 1] = (int16_t)((value) >> 32); \((int16_t*)(tab_int16))[(index) + 2] = (int16_t)((value) >> 16); \((int16_t*)(tab_int16))[(index) + 3] = (int16_t)(value); \} while (0)

對于浮點數等多字節數據而言，由于存在字節序和大小端處理等問題，所有輔助定義了一些特殊函數

MODBUS_API void modbus_set_bits_from_byte(uint8_t *dest, int idx, const uint8_t value); MODBUS_API void modbus_set_bits_from_bytes(uint8_t *dest, int idx, unsigned int nb_bits,const uint8_t *tab_byte); MODBUS_API uint8_t modbus_get_byte_from_bits(const uint8_t *src, int idx, unsigned int nb_bits); MODBUS_API float modbus_get_float(const uint16_t *src); MODBUS_API float modbus_get_float_abcd(const uint16_t *src); MODBUS_API float modbus_get_float_dcba(const uint16_t *src); MODBUS_API float modbus_get_float_badc(const uint16_t *src); MODBUS_API float modbus_get_float_cdab(const uint16_t *src);MODBUS_API void modbus_set_float(float f, uint16_t *dest); MODBUS_API void modbus_set_float_abcd(float f, uint16_t *dest); MODBUS_API void modbus_set_float_dcba(float f, uint16_t *dest); MODBUS_API void modbus_set_float_badc(float f, uint16_t *dest); MODBUS_API void modbus_set_float_cdab(float f, uint16_t *dest);

05. 附錄

libmodbus源碼下載：https://github.com/stephane/libmodbus

總結

以上是生活随笔為你收集整理的【嵌入式】Libmodbus源码分析(二)-常用接口函数分析的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。