1. 概述

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

DAM-5802D模塊提供keil開發(fā)環(huán)境下的函數(shù)庫，功能強大，使用方便。開發(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);//閉合第一路繼電器的常開觸點，斷開常閉觸點。

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

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

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則：常開觸點斷開，常閉觸點閉合。

temp為1則：常閉觸點斷開，常開觸點閉合。

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

temp為3則：其他未知錯誤。

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

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

1. UART_Init函數(shù)

函數(shù)原型如下：

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

舉例：

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

。

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

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ù)中進行數(shù)據(jù)的處理。

舉例：

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

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

1. RUN_LED_Toggle函數(shù)

函數(shù)原型如下：

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

舉例：

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

1. RUN_LED_ON函數(shù)

函數(shù)原型如下：

舉例：

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

1. RUN_LED_OFF函數(shù)

函數(shù)原型如下:

舉例：

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

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

函數(shù)原型如下：

舉例：

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

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

1. Delay_us函數(shù)

函數(shù)原型如下：

舉例：

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

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

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

函數(shù)原型如下：

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

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

函數(shù)原型如下：

舉例：

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

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

1. Feed_Dog函數(shù)

函數(shù)原型如下：

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

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

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)有異常時，比如指針操作不當(dāng)、數(shù)組操作不當(dāng)?shù)龋瑫M入此中斷。

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)一輸出到一個結(jié)構(gòu)體中：

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

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

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

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

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

打開“可編程資料”:

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

打開“Proj”：

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

工程配置如下圖：

編譯后會生成一個IO_APP.bin文件（路徑：ZQWL_IO_APP\Proj\BIN）：

1. 程序下載

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

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

1. 程序出錯處理

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

第一步：斷電。

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

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

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