2. 各類Modbus功能接口函數

左右滑動查看完整內容

MODBUS_API int modbus_read_bits（modbus t * ctx，int addr，int nb，uint8_t * dest）：

此函數對應于功能碼01（0x01）讀取線圈/離散量輸出狀態（Read CoilStatus/DOs），其中，所讀取的值存放于參數uint8_t * dest指向的數組空間因此dest指向的空間必須足夠大，其大小至少為nb * sizeof（uint8_t）個字節。

用法舉例:

左右滑動查看完整內容

#define SERVER ID 1
#define ADDRESS START 0
#define ADDRESS END 99
modbus_t * ctx;
uint8_t * tab_rp_bits;
int rc;
int nb;
ctx=modbus_new_tcp("127.0.0.1",502);
modbus_set_debug(ctx，TRUE);
if (modbus_connect(ctx)==-1)
{
 fprintf(stderr,"Connection failed:%s
", modbus_strerror(errno));
 modbus free(ctx);
 return -1;
}
//申請存儲空間并初始化
int nb = ADDRESS_END - ADDRESS_START;
tab_rp_bits = (uint8_t * ) malloc (nb * sizeof(uint8_t));
memset(tab_rp_bits, 0, nb * sizeof(uint8_t));
//讀取一個線圈
int addr =1;
rc =modbus_read_bits(ctx,addr,1,tab_rp_bits);
if (rc !=1)
{
 printf("ERROR modbus_read_bits_single (%d)
", rc);
 printf("address =%d
", addr);
}
//讀取多個線圈
rc =modbus_read_bits(ctx,addr,nb,tab_rp_bits);
if (rc !=nb)
{
 printf("ERROR modbus_read_bits
");
 printf("Address =%d,nb =%d
", addr, nb);
}
//釋放空間關閉連接
free(tab_rp_bits);
modbus_close(ctx);
modbus_free(ctx);

左右滑動查看完整內容

MODBUS_API int modbus_read_input_bits (modbus_t * ctx, intaddr, int nb,uint8_t * dest)：

此函數對應于功能碼02（0x02）讀取離散量輸入值（Read InputStatus/DIs），各參數的意義與用法，類似于函數modbus_read_bits()。

左右滑動查看完整內容

MODBUS_API int modbus_read_registers (modbus_t * ctx, intaddr, int nb，uint16_t * dest)：

此函數對應于功能碼03（0x03）讀取保持寄存器（Read HoldingRegister），其中，所讀取的值存放于參數uint16_t * dest指向的數組空間，因此dest指向的空間必須足夠大，其大小至少為nb * sizeof（uint16_t）個字節。

當讀取成功后，返回值為讀取的寄存器個數;若讀取失敗，則返回-1。此函數調用依賴關系如下圖6-5所示。

用法舉例:

左右滑動查看完整內容

modbust * ctx;
uint16_t tab_reg[64];
int rc;
int i;
ctx=modbus_new_tcp("127.0.0.1",502);
if (modbusconnect(ctx)==-1)
{
 fprintf(stderr,"Connection failed:%s
", modbus_strerror(errno));
 modbus_free(ctx);
 return -1;
}
//從地址0開始連續讀取10個
rc =modbus_read_registers(ctx,0,10,tab_reg);
if (rc ==-1)
{
 fprintf(stderr,"%s
",modbus_strerror(errno));
 return -1;
}
for (i=0;i

	

	左右滑動查看完整內容

	
MODBUS_API int modbus_read_input_registers （modbus_t * ctx，int addr， int nb， uint16_t * dest ）：

	

	此函數對應于功能碼04（0x04）讀取輸人寄存器（Read Iput Register），各參數的意義與用法，類似于函數 modbus_read_registers()。

	此函數的調用依賴關系如下圖6-6所示。

	圖6-6函數modbus_read input_registers()的調用依賴關系：

	

	左右滑動查看完整內容

	
MODBUS_API int modbus_write_bit（modbus_t * ctx，intcoil_addr，int status）：

	

	該函數對應于功能碼05（0x05）寫單個線圈或單個離散輸出（ForceSingleCoil）。其中參數coil_addr代表線圈地址；參數status代表寫值取值只能是TRUE（1）或 FALSE（0）。

	左右滑動查看完整內容

	
MODBUS_API int modbus_write_register（modbus_t * ctx，intreg_addr，int value）：

	

	該函數對應于功能碼06（0x06）寫單個保持寄存器（Preset SingleRegister）。

	左右滑動查看完整內容

	
MODBUS_API int modbus_write_bits（modbus_t * ctx, int addr，int nb，const uint8_t * data）：

	

	該函數對應于功能碼15（0x0F）寫多個線圈（Force Multiple Coils）

	參數addr代表寄存器起始地址，參數nb表示線圈個數，而參數constuint8_t * data表示待寫入的數據塊。一般情況下，可以使用數組存儲寫入數據，數組的各元素取值范圍只能是TRUE（1）或FALSE（0）。

	左右滑動查看完整內容

	
MODBUS_API int modbus_write_registers（modbus_t * ctx， intaddr，int nb，const uint16_t * data）：

	

	該函數對應于功能碼16（0x10）寫多個保持存器 （PresetMultipleRegisters）

	參數addr代表寄存器起始地址，參數nb表示存器的個數而參數constuint16_t * data表示待寫人的數據塊。一般情況下，可以使用數組存儲寫入數據數組的各元素取值范圍是0~0xFFFF即數據類型uint16_t的取值范圍。

	左右滑動查看完整內容

	
MODBUS_API int modbus_mask_registers（modbus_t * ctx， intaddr， uint16_t and_mask，uint16_t or_mask ）：

	

	modbus_mask_write_register()函數應使用以下算法修改遠程設備地址“addr”處的保持寄存器的值：

	新值=（current value AND ‘and’）OR（‘or’ AND（NOT ‘and’））。

	該功能使用Modbus功能代碼0x16（掩碼單個寄存器）。

	左右滑動查看完整內容

	
MODBUS_API int modbus_write_and_read_registers （mobus_t *ctx ,
int writer_addr,
int writer_nb,
const uint16_t * src,
int read_addr,
int read_nb,
uint16_t * dest）;

	

	modbus_write_and_read_registers()函數應將write_nb保持寄存器的內容從數組“src”寫入遠程設備的地址 write_addr，然后將read_nb保持寄存器的內容讀取到遠程設備的地址read_addr。讀取結果作為字值（16位）存儲在dest數組中。

	必須注意分配足夠的內存來存儲結果dest（至少nb *sizeof（uint16_t））。該功能使用Modbus功能代碼0x17（寫/讀寄存器）。

	左右滑動查看完整內容

	
MODBUS_API int modbus_report_slave_id（modbus_t * ctx， intmax_dest， uint8_t * dest）：

	

	該函數對應于功能碼17（0x11）報告從站ID。參數max_dest代表最大的存儲空間，參數dest用于存儲返回數據。返回數據可以包括如下內容：從站ID狀態值（0x00=OFF狀態，0xFF=ON狀態）以及其他附加信息，具體的各參數意義由開發者指定。

	用法舉例:

	左右滑動查看完整內容

	
uint8_t tab_bytes[MODBUS_MAX_PDU_LENGTH];
...
 
rc =modbus_report_slave_id(ctx, MODBUS_MAX_PDU_LENGTH, tab_bytes);
if (rc>1)
{
 printf("Run Status Indicator: %s
",tab_bytes[1] ?"ON":"OFF");
}

	

	3.數據處理的相關函數或宏定義

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

	例如獲取數據的高低字節序宏定義：

	左右滑動查看完整內容

	
#define MODBUS_GET_HIGH_BYTE (data) (((data) >>8)&0xFF)

	

	左右滑動查看完整內容

	
#define MODBUS_GET_LOW_BYTE (data) ((data)&0xFF)

	

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

	左右滑動查看完整內容

	
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);

	

	當然，可以參照float類型的處理方法，繼續定義其他多字節類型的數據例如int32_t、uint32_t、int64_t、uint64_t以及double類型的讀寫函數。