智嵌物联ZQWL可编程模拟量采集模块DAM-5802D

1. 概述

智嵌物联网ZQWL研发的DAM-5802D模块提供了用户编程接口，增强了应用的灵活性，简化了用户的编程的难度，缩短了开发产品的周期；用户不需要了解板卡底层驱动，只需将控制逻辑和通讯协议嵌入其中即可。

DAM-5802D模块提供keil开发环境下的函数库，功能强大，使用方便。开发人员只需略懂C语言（提供详尽技术指导和咨询）就可以在本司DAM-5802D平台上开发所需功能。

1. 开关量相关函数
   1. Write_Relay函数

函数原型如下：

该函数需被其他函数调用才能使用。

举例：

Write_Relay(0,1);//闭合第一路继电器的常开触点，断开常闭触点。

Write_Relay(1,0);//断开第二路继电器的常闭触点，打开常开触点。

在使用过程中，注意传入的参数（channel，status）不能出错，channel的范围为0到N，N为控制板IO输出点个数；status的值只能为0或1。参数超出定义范围时，函数将返回错误信息。

1. Read_Relay函数

函数原型如下：

该函数需被其他函数调用才能使用。

举例：

unsigned char temp = 0;

temp =Read_Relay(0);//读取第一路的输出状态并将结果赋给temp。

temp =Read_Relay(3);//读取第四路的输出状态并将结果赋给temp。

然后根据temp的值即可判断当前IO输出的状态：

temp为0则：常开触点断开，常闭触点闭合。

temp为1则：常闭触点断开，常开触点闭合。

temp为2则：传入的参数channel错误。

temp为3则：其他未知错误。

1. 串口通讯相关函数

ZQWL_DAM_5802D有1个RS485接口，用于收发数据。

1. UART_Init函数

函数原型如下：

该函数为串口初始化函数，如果要使用RS232/485通讯功能，必须调用该函数来初始化通讯相关参数。

举例：

注意该函数的第三个参数parity，必须为以下三种：

。

如果该函数调用成功则返回值为0，否则返回相应的错误信息。

1. UART_Send_Data函数

函数原型如下：

该函数为串口发送函数，调用该函数前必须正确调用UART_Init（）函数。

举例1，直接发送字符串：

UART_Send_Data("1234567890",10);

举例2，将数组中数据发送出去：

unsigned char temp[10];

UART_Send_Data(temp,10);

1. UART_Recv_Handler函数

函数原型如下：

该函数为类似中断函数，不能被其他函数调用。必须在正确调用UART_Init（）函数后该函数才能生效。建议在该函数中首先将buff中的数据复制出来，然后退出，在别的函数中进行数据的处理。

举例：

1. 系统指示灯相关函数

该系列控制板有1个系统LED指示灯，可以用来指示系统运行的状态。

1. RUN_LED_Toggle函数

函数原型如下：

此函数实现系统LED的状态翻转功能（调用后原来熄灭则会点亮，原来点亮则会熄灭）。

举例：

RUN_LED_Toggle（）；//调用后，指示灯状态翻转。

1. RUN_LED_ON函数

函数原型如下：

举例：

RUN_LED_ON();//点亮系统LED指示灯

1. RUN_LED_OFF函数

函数原型如下:

举例：

RUN_LED_OFF();//熄灭系统LED指示灯

1. 延时相关函数
   1. Delay_ms函数

函数原型如下：

举例：

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

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

1. Delay_us函数

函数原型如下：

举例：

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

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

1. 定时器相关函数
   1. Timer_IRQHandler函数

函数原型如下：

该函数为中断函数，不能被其他函数调用。每隔1ms中断一次，用户以此为基础可以设计出各种定时服务功能。例如设计一个10ms定时服务功能：

1. 看门狗相关函数
   1. IWDG_Init函数

函数原型如下：

举例：

IWDG_Init（WD_1000MS）；//设置看门狗定时器为1000毫秒。

IWDG_Init（WD_2000MS）；//设置看门狗定时器为2000毫秒。

1. Feed_Dog函数

函数原型如下：

如果调用了IWDG_Init（），那么， Feed_Dog()函数就必须周期调用，并且调用周期必须小于看门狗定时器设定值。否则，系统将不断的复位。

建议在产品开发阶段先不用看门狗功能，产品发布时再加上此功能。

1. Flash相关函数

该系列控制板均提供128字节的用户flash空间，可以用来存放控制板掉电后需要保存的参数，比如波特率，地址码等。

1. User_Flash_Write函数

函数原型如下：

举例：

1. User_Flash_Read函数

函数原型如下：

举例：

1. 系统异常相关函数
   1. HardFault_Handler函数

函数原型如下：

当系统有异常时，比如指针操作不当、数组操作不当等，会进入此中断。

1. 系统复位相关函数
   1. MCU_Soft_Reset函数

函数原型如下：

调用该函数后，系统将复位。

1. main函数

该函数为系统入口函数，提供如下示例：

1. 模拟量变量声明

提供ADC值、0~5V型电压值、0~10V型电压值和0~20mA型电流值的采集，统一输出到一个结构体中：

变量的声明在ZQWL_DAM_5802D.h文件中。

1. 模块编程
   1. 开发环境

该模块开发环境使用keil 5.10版本（其他版本未验证），有关keil的使用教程请参考其他开发文档，keil5的安装包下载地址：

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

在“可编程资料”里有该控制板的keil5工程

打开“可编程资料”:

此即为该控制板的工程文件， 打开文件：

打开“Proj”：

双击上图中的“LED”，则可以通过keil软件打开该工程。

工程配置如下图：

编译后会生成一个IO_APP.bin文件（路径：ZQWL_IO_APP\Proj\BIN）：

1. 程序下载

智嵌串口IO模块的固件是通过《智嵌物联 串口继电器控制板固件升级工具》来下载程序的：

点击上图的“浏览”，将编译好的IO_APP.bin文件载入软件，选择好串口参数，然后点“打开”，点“开始升级”，即可实现固件的下载，下载完成后自动运行：

1. 程序出错处理

在调试程序时难免会出现程序出错，出错后可能造成不能直接对模块固件下载，这时需要按照如下步骤操作：

第一步：断电。

第二步：按住模块上的按键。

第三步：上电，看到模块的运行灯快速闪烁，说明进入到了固件下载模式，此时就可以对模块下载固件了。注意此过程中不可以松开按键，直到下载成功后才能松开。

注意，智嵌物联网ZQWL的部分网络IO控制器也支持编程功能，如型号ZQWL-NET8880M，Smart IO，该类产品功能更强大。除此之外，智嵌物联ZQWL新推出的Smart GW串口服务器也具有编程功能，该类产品通讯接口支持4G,网口,WIFI,CAN，RS485等，部分产品也具有IO扩展功能，性能更强大，使用更方便。