智嵌物聯(lián)ZQWL可編程串口IO控制器（略懂C語言即可使用）

1. 概述

智嵌物聯(lián)串口IO模塊提供了用戶編程接口，增強(qiáng)了應(yīng)用的靈活性，簡化了用戶的編程的難度，縮短了開發(fā)產(chǎn)品的周期；用戶不需要了解IO板卡底層驅(qū)動(dòng)，只需將控制邏輯和通訊協(xié)議嵌入其中即可。

串口IO模塊提供keil開發(fā)環(huán)境下的函數(shù)庫，功能強(qiáng)大，使用方便。開發(fā)人員只需略懂C語言（提供詳盡技術(shù)指導(dǎo)和咨詢）就可以在本司串口IO平臺(tái)上開發(fā)所需功能。

1. 開關(guān)量相關(guān)函數(shù)
   1. Write_Relay函數(shù)

函數(shù)原型如下：

該函數(shù)需被其他函數(shù)調(diào)用才能使用。

舉例：

Write_Relay(0,1);//閉合第一路繼電器的常開觸點(diǎn)，斷開常閉觸點(diǎn)。

Write_Relay(1,0);//斷開第二路繼電器的常閉觸點(diǎn)，打開常開觸點(diǎn)。

在使用過程中，注意傳入的參數(shù)（channel，status）不能出錯(cuò)，channel的范圍為0到N，N為控制板IO輸出點(diǎn)個(gè)數(shù)；status的值只能為0或1。參數(shù)超出定義范圍時(shí)，函數(shù)將返回錯(cuò)誤信息。

1. Read_Relay函數(shù)

函數(shù)原型如下：

該函數(shù)需被其他函數(shù)調(diào)用才能使用。

舉例：

unsigned char temp = 0;

temp =Read_Relay(0);//讀取第一路的輸出狀態(tài)并將結(jié)果賦給temp。

temp =Read_Relay(3);//讀取第四路的輸出狀態(tài)并將結(jié)果賦給temp。

然后根據(jù)temp的值即可判斷當(dāng)前IO輸出的狀態(tài)：

temp為0則：常開觸點(diǎn)斷開，常閉觸點(diǎn)閉合。

temp為1則：常閉觸點(diǎn)斷開，常開觸點(diǎn)閉合。

temp為2則：傳入的參數(shù)channel錯(cuò)誤。

temp為3則：其他未知錯(cuò)誤。

1. 開關(guān)量輸入相關(guān)函數(shù)
   1. Read_IN函數(shù)

函數(shù)原型如下：

該函數(shù)需被其他函數(shù)調(diào)用才能使用。

舉例：

unsigned char temp = 0;

temp =Read_IN(0);//讀取第一路的輸入狀態(tài)并將結(jié)果賦給temp。

temp =Read_Relay(3);//讀取第四路的輸入狀態(tài)并將結(jié)果賦給temp。

然后根據(jù)temp的值即可判斷當(dāng)前IO輸入的狀態(tài)：

temp為0則：該路為無信號(hào)輸入（邏輯值為0，低電平）。

temp為1則：該路為有信號(hào)輸入（邏輯值為1，高電平）。

temp為2則：傳入的參數(shù)channel錯(cuò)誤。

1. 串口通訊相關(guān)函數(shù)

智嵌物聯(lián)雙串口IO控制板均有RS232和RS485接口，這兩種接口可以獨(dú)立使用。

串口接收緩沖器以及緩沖器大小在“ZQWL_IO_xBNRRx.h”文件中有定義：

1. RS232_Init函數(shù)

函數(shù)原型如下：

該函數(shù)為RS232串口初始化函數(shù)，如果要使用RS232通訊功能，必須調(diào)用該函數(shù)來初始化通訊相關(guān)參數(shù)。

舉例：

注意該函數(shù)的第三個(gè)參數(shù)parity，必須為以下三種：

。

如果該函數(shù)調(diào)用成功則返回值為0，否則返回相應(yīng)的錯(cuò)誤信息。

1. RS485_Init函數(shù)

函數(shù)原型如下：

該函數(shù)為RS485串口初始化函數(shù)，如果要使用RS485通訊功能，必須調(diào)用該函數(shù)來初始化通訊相關(guān)參數(shù)。

舉例：

注意該函數(shù)的第三個(gè)參數(shù)parity，必須為以下三種：

。

如果該函數(shù)調(diào)用成功則返回值為0，否則返回相應(yīng)的錯(cuò)誤信息。

1. RS232_Send_Data函數(shù)

函數(shù)原型如下：

該函數(shù)為串口發(fā)送函數(shù)，調(diào)用該函數(shù)前必須正確調(diào)用RS232_Init（）函數(shù)。

舉例1，直接發(fā)送字符串：

RS232_Send_Data("1234567890",10);

舉例2，將數(shù)組中數(shù)據(jù)發(fā)送出去：

unsigned char temp[10];

RS232_Send_Data(temp,10);

1. RS485_Send_Data函數(shù)

函數(shù)原型如下：

該函數(shù)為串口發(fā)送函數(shù)，調(diào)用該函數(shù)前必須正確調(diào)用RS485_Init（）函數(shù)。

舉例1，直接發(fā)送字符串：

RS485_Send_Data("1234567890",10);

舉例2，將數(shù)組中數(shù)據(jù)發(fā)送出去：

unsigned char temp[10];

RS485_Send_Data(temp,10);

1. RS232_Recv_Handler函數(shù)

函數(shù)原型如下：

該函數(shù)為類似中斷函數(shù)，不能被其他函數(shù)調(diào)用。必須在正確調(diào)用RS232_Init（）函數(shù)后該函數(shù)才能生效。建議在該函數(shù)中首先將buff中的數(shù)據(jù)復(fù)制出來，然后退出，在別的函數(shù)中進(jìn)行數(shù)據(jù)的處理。

舉例：

1. RS485_Recv_Handler函數(shù)

函數(shù)原型如下：

該函數(shù)為類似中斷函數(shù)，不能被其他函數(shù)調(diào)用。必須在正確調(diào)用RS485_Init（）函數(shù)后該函數(shù)才能生效。建議在該函數(shù)中首先將buff中的數(shù)據(jù)復(fù)制出來，然后退出，在別的函數(shù)中進(jìn)行數(shù)據(jù)的處理。

舉例：

1. 系統(tǒng)指示燈相關(guān)函數(shù)

該系列控制板有1個(gè)系統(tǒng)LED指示燈，可以用來指示系統(tǒng)運(yùn)行的狀態(tài)。

1. RUN_LED_Toggle函數(shù)

函數(shù)原型如下：

此函數(shù)實(shí)現(xiàn)系統(tǒng)LED的狀態(tài)翻轉(zhuǎn)功能（調(diào)用后原來熄滅則會(huì)點(diǎn)亮，原來點(diǎn)亮則會(huì)熄滅）。

舉例：

RUN_LED_Toggle（）；//調(diào)用后，指示燈狀態(tài)翻轉(zhuǎn)。

1. RUN_LED_ON函數(shù)

函數(shù)原型如下：

舉例：

RUN_LED_ON();//點(diǎn)亮系統(tǒng)LED指示燈

1. RUN_LED_OFF函數(shù)

函數(shù)原型如下:

舉例：

RUN_LED_OFF();//熄滅系統(tǒng)LED指示燈

1. 延時(shí)相關(guān)函數(shù)
   1. Delay_ms函數(shù)

函數(shù)原型如下：

舉例：

Delay_ms(500);//延時(shí)500毫秒。

Delay_ms(2000);//延時(shí)2000毫秒。

1. Delay_us函數(shù)

函數(shù)原型如下：

舉例：

Delay_us(500);//延時(shí)500微秒。

Delay_us(999);//延時(shí)999微秒。

1. 定時(shí)器相關(guān)函數(shù)
   1. Timer_IRQHandler函數(shù)

函數(shù)原型如下：

該函數(shù)為中斷函數(shù)，不能被其他函數(shù)調(diào)用。每隔1ms中斷一次，用戶以此為基礎(chǔ)可以設(shè)計(jì)出各種定時(shí)服務(wù)功能。例如設(shè)計(jì)一個(gè)10ms定時(shí)服務(wù)功能：

1. 看門狗相關(guān)函數(shù)
   1. IWDG_Init函數(shù)

函數(shù)原型如下：

舉例：

IWDG_Init（WD_1000MS）；//設(shè)置看門狗定時(shí)器為1000毫秒。

IWDG_Init（WD_2000MS）；//設(shè)置看門狗定時(shí)器為2000毫秒。

1. Feed_Dog函數(shù)

函數(shù)原型如下：

如果調(diào)用了IWDG_Init（），那么， Feed_Dog()函數(shù)就必須周期調(diào)用，并且調(diào)用周期必須小于看門狗定時(shí)器設(shè)定值。否則，系統(tǒng)將不斷的復(fù)位。

建議在產(chǎn)品開發(fā)階段先不用看門狗功能，產(chǎn)品發(fā)布時(shí)再加上此功能。

1. Flash相關(guān)函數(shù)

該系列控制板均提供128字節(jié)的用戶flash空間，可以用來存放控制板掉電后需要保存的參數(shù)，比如波特率，地址碼等。

1. User_Flash_Write函數(shù)

函數(shù)原型如下：

舉例：

1. User_Flash_Read函數(shù)

函數(shù)原型如下：

舉例：

1. 系統(tǒng)異常相關(guān)函數(shù)
   1. HardFault_Handler函數(shù)

函數(shù)原型如下：

當(dāng)系統(tǒng)有異常時(shí)，比如指針操作不當(dāng)、數(shù)組操作不當(dāng)?shù)龋瑫?huì)進(jìn)入此中斷。

1. 系統(tǒng)復(fù)位相關(guān)函數(shù)
   1. MCU_Soft_Reset函數(shù)

函數(shù)原型如下：

調(diào)用該函數(shù)后，系統(tǒng)將復(fù)位。

1. CAN相關(guān)函數(shù)

只有控制板硬件具有CAN通訊的版本才支持CAN相關(guān)函數(shù)。

CAN相關(guān)的數(shù)據(jù)結(jié)構(gòu)定義：

1. CAN_Configuration函數(shù)

使用CAN通訊前必須正確調(diào)用該函數(shù)。

1. CAN_Recv_IRQHandler函數(shù)

例如：

1. CAN_Send_Data函數(shù)

1. main函數(shù)

該函數(shù)為系統(tǒng)入口函數(shù)，提供如下示例：

1. 模塊編程
   1. 開發(fā)環(huán)境

該模塊開發(fā)環(huán)境使用keil 5.10版本（其他版本未驗(yàn)證），有關(guān)keil的使用教程請(qǐng)參考其他開發(fā)文檔，keil5的安裝包在MDK5.zip里面。

在“軟件包”里有該控制板的keil5工程

打開“軟件包”:

此即為該控制板的工程文件， 打開文件：

打開“Proj”：

雙擊上圖中的“pro”，則可以通過keil軟件打開該工程，工程配置如下：

有關(guān)KEIL軟件的使用請(qǐng)自己查找資料學(xué)習(xí)。

工程編譯后會(huì)生成一個(gè)IO_APP.bin文件（路徑：ZQWL_IO_APP（雙串口+CAN）_V1.2\project\BIN）：

如果是其他網(wǎng)絡(luò)模塊，則需要將“xBXRA16_V1.0.lib”從工程中移除，再添加上相對(duì)應(yīng)的lib文件即可（路徑在：ZQWL_IO_APP\App）：

1. 程序下載

智嵌串口IO模塊的固件是通過《智嵌物聯(lián) 串口繼電器控制板固件升級(jí)工具》來下載程序的：

點(diǎn)擊上圖的“瀏覽”，將編譯好的IO_APP.bin文件載入軟件，然后點(diǎn)“打開”，接點(diǎn)“開始升級(jí)”，即可實(shí)現(xiàn)固件的下載，下完成后自動(dòng)運(yùn)行：

1. 程序出錯(cuò)處理

在調(diào)試程序時(shí)難免會(huì)出現(xiàn)程序出錯(cuò)，出錯(cuò)后可能造成不能直接對(duì)模塊進(jìn)行固件下載，這時(shí)需要按照如下步驟操作：

第一步：斷電。

第二步：將撥碼開關(guān)全部撥到OFF狀態(tài)（強(qiáng)制進(jìn)入升級(jí)固件狀態(tài)）。

第三步：上電，此時(shí)看到模塊的運(yùn)行燈快速閃爍，說明進(jìn)入到了固件下載模式，此時(shí)就可以對(duì)模塊下載固件了。注意此過程中要保證撥碼開關(guān)一直全OFF狀態(tài)。

注意，智嵌物聯(lián)網(wǎng)ZQWL的部分網(wǎng)絡(luò)IO控制器也支持編程功能，如型號(hào)ZQWL-NET8880M，Smart IO，該類產(chǎn)品功能更強(qiáng)大。除此之外，智嵌物聯(lián)ZQWL新推出的Smart GW串口服務(wù)器也具有編程功能，該類產(chǎn)品通訊接口支持4G,網(wǎng)口,WIFI,CAN，RS485等，部分產(chǎn)品也具有IO擴(kuò)展功能，性能更強(qiáng)大，使用更方便。