1. 概述

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

DAM-5802D模塊提供keil開發(fā)環(huán)境下的函數(shù)庫，功能強(qiáng)大，使用方便。開發(fā)人員只需略懂C語言（提供詳盡技術(shù)指導(dǎo)和咨詢）就可以在本司DAM-5802D平臺上開發(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)函數(shù)

ZQWL_DAM_5802D有1個(gè)RS485接口，用于收發(fā)數(shù)據(jù)。

1. UART_Init函數(shù)

函數(shù)原型如下：

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

舉例：

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

。

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

1. UART_Send_Data函數(shù)

函數(shù)原型如下：

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

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

UART_Send_Data("1234567890",10);

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

unsigned char temp[10];

UART_Send_Data(temp,10);

1. UART_Recv_Handler函數(shù)

函數(shù)原型如下：

該函數(shù)為類似中斷函數(shù)，不能被其他函數(shù)調(diào)用。必須在正確調(diào)用UART_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. main函數(shù)

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

1. 模擬量變量聲明

提供ADC值、0~5V型電壓值、0~10V型電壓值和0~20mA型電流值的采集，統(tǒng)一輸出到一個(gè)結(jié)構(gòu)體中：

變量的聲明在ZQWL_DAM_5802D.h文件中。

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

該模塊開發(fā)環(huán)境使用keil 5.10版本（其他版本未驗(yàn)證），有關(guān)keil的使用教程請參考其他開發(fā)文檔，keil5的安裝包下載地址：

https://pan.baidu.com/s/1rAgGc5AjeSDBvNq1KSFNsg提取碼: jxeq。

在“可編程資料”里有該控制板的keil5工程

打開“可編程資料”:

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

打開“Proj”：

雙擊上圖中的“LED”，則可以通過keil軟件打開該工程。

工程配置如下圖：

編譯后會(huì)生成一個(gè)IO_APP.bin文件（路徑：ZQWL_IO_APP\Proj\BIN）：

1. 程序下載

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

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

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

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

第一步：斷電。

第二步：按住模塊上的按鍵。

第三步：上電，看到模塊的運(yùn)行燈快速閃爍，說明進(jìn)入到了固件下載模式，此時(shí)就可以對模塊下載固件了。注意此過程中不可以松開按鍵，直到下載成功后才能松開。

注意，智嵌物聯(lián)網(wǎng)ZQWL的部分網(wǎng)絡(luò)IO控制器也支持編程功能，如型號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)大，使用更方便。