开关量采集接口类型(S014B)

[TOC]

一、实现功能简介

基于 FlexLua 《DTU01万能采集器》实现对 烟雾探测传感器的采集，并可通过下面八种无线/有线通信方式中的一种将传感器数据上报至云平台服务器，八种方式分别为：

• 4G 无线 Mqtt 主动传输
• 4G 无线 TCP 主动传输
• WiFi 无线 Mqtt 主动传输
• WiFi 无线TCP 主动传输
• Lora 无线 主动传输
• Lora 无线 被动传输
• 以太网有线主动传输
• 以太网有线被动传输

二、传感器简介

本文中烟雾探测传感器采用的是海康威视一款带消防认证的开关量输出型烟雾传感器（型号：DS-PDSMK-B01），当然也可以选择其他厂家的传感器，只要输出信号是开关量输出型即可。该传感器可应用于众多领域，比如火灾探测, 家庭烟雾监测，厂房烟雾监测，仓库烟雾监测，机房烟雾监测等。

该传感器说明书资料可在 {FlexLua开源网盘} -> {Spec} -> {S014B} 文件夹中找到。

三、DTU01 万能采集器介绍

基于《DTU01采集器》实现采集市面上常见的 烟雾探测传感器数据，并将采集到的传感器数据以 Json 字符串的形式通过可选的 4G/WiFi/以太网/Lora 其中一种方式发送给网关或云服务器。在需要电池供电的场景下，还可通过给 DTU01 增加低功耗模块以实现周期性休眠采集，休眠电流可低至 3uA 以内，以实现在电池供电场景下的几个月甚至几年的周期性长期采集。

关于 DTU01 万能采集器：

《DTU01万能采集器》内部核心主控采用 ShineBlink C2M 低代码物联网核心模组，使用该主控核心模组可轻松采集大量市面上常见的传感器数据，并可自由选择通过 4G/WiFi/以太网/Lora 中的一种方式进行数据通信。本采集器硬件资料和源代码开放且源码极其精简，所以开发者无论是否有嵌入式单片机开发经验，皆可轻松基于源码进行二次开发（例如：新功能增加、边缘数据处理、逻辑判断、特殊协议解析等）。当然如果使用者对编程不感兴趣也可直接参考下面的技术指导文章即可实现大部分场景的需求。

四、DTU01 硬件要求

由于 DTU01 的硬件接口是可配置的，所以需要确认一下您手上的 DTU01 采集器是否满足要求，如果确认已满足就无需再做任何操作，否则请按《DTU01硬件使用指导书》完成下面的硬件配置：

• DTU01 电路板上的 ‘A’ 和 ‘B’ 引脚需配置成 无源开关量检测 接口的 DI-1和 DI-2，即 S6 选择
• DTU01 电路板上的 ‘+’ 和 ‘-’ 无需任何配置

《DTU01硬件使用指导书》可在 {FlexLua开源网盘}->{Hardware}->{DTU01万能采集器}->{DTU01硬件使用指导书} 文件夹中找到。

五、传感器采集核心代码

完成 SensorInit() 和 SensorGetValue() 两个函数的构造以实现烟雾探测传感器的采集，并将这两个函数代码覆盖至对应的 main.lua 源代码文件中即可实现传感器的采集。

--采集接口初始化函数
function SensorInit()
	--设置D4口为输入，用于检测开关量输入信号（GPIO高低电平值）
	LIB_GpioInputConfig("D4","NOPULL")
end

--读取烟雾探测传感器数据，获取到的json data数据形式可如下：
--{"Smog":1},Smog=1表示烟雾传感器报警，Smog=0表示正常
function SensorGetValue()
    local val
    err = "null" --err包含错误信息，如果没有错误，设置为"null"
    
    --读取GPIO输入引脚的高低电平值（开关量的状态）
    gpio_value = LIB_GpioRead("D4")
    if gpio_value == 1 then --检测到开关量断开，无烟感报警信号
        val = 0
    elseif gpio_value == 0 then --检测到开关量闭合，有烟感报警信号
        val = 1
    end
    --生成Json字符串
    data = string.format("{\"Smog\":%d}", val)
	
	--返回结果
	finish = 1   --finish=1表示传感器读取完成(无论是否成功)
	return finish,data,err
end

六、八种采集传输方式实现（选一种阅读即可）

（1）4G Mqtt 主动传输（直流供电+电池供电）

周期性采集 烟雾探测传感器数据并转换成可读性更强的 Json 字符串，然后通过 4G Mqtt 发送至云端，Json 字符串示例如下：

{"Dev":"TH","Data":{"Smog":1},"Err":null}

实现方法如下：

• 请仔细阅读参考 DTU01 的《软件使用指导书(OTHERS_4G_MQTT)》，并在 main.lua 源代码文件中修改好"配置信息"
• 将第五节中提供的"传感器采集核心代码"覆盖至相应的 main.lua 源代码文件中
• 注意：如果需要使用低功耗电池供电功能，还需在配置信息中配置 SysSleepEn 参数

指导书文件和main.lua源代码文件均位于：

{FlexLua开源网盘} -> {Software} -> {DTU01万能采集器}-> {Others} -> {4G主动发送} -> {MQTT} 文件夹中

（2）4G TCP主动传输（直流供电+电池供电）

周期性采集 烟雾探测传感器数据并转换成可读性更强的 Json 字符串，然后通过 4G Tcp 发送至云端，Json 字符串示例如下：

{"Dev":"TH","Data":{"Smog":1},"Err":null}

实现方法如下：

• 请仔细阅读参考 DTU01 的《软件使用指导书(OTHERS_4G_TCP)》，并在 main.lua 源代码文件中修改好"配置信息"
• 将第五节中提供的"传感器采集核心代码"覆盖至相应的 main.lua 源代码文件中
• 注意：如果需要使用低功耗电池供电功能，还需在配置信息中配置 SysSleepEn 参数

指导书文件和main.lua源代码文件均位于：

{FlexLua开源网盘} -> {Software} -> {DTU01万能采集器}-> {Others} -> {4G主动发送} -> {TCP} 文件夹中

（3）WiFi Mqtt 主动传输（直流供电+电池供电）

周期性采集 烟雾探测传感器数据并转换成可读性更强的 Json 字符串，然后通过 WiFi Mqtt 发送至云端，Json 字符串示例如下：

{"Dev":"TH","Data":{"Smog":1},"Err":null}

实现方法如下：

• 请仔细阅读参考 DTU01 的《软件使用指导书(OTHERS_WIFI_MQTT)》，并在 main.lua 源代码文件中修改好"配置信息"
• 将第五节中提供的"传感器采集核心代码"覆盖至相应的 main.lua 源代码文件中
• 注意：如果需要使用低功耗电池供电功能，还需在配置信息中配置 SysSleepEn 参数

指导书文件和main.lua源代码文件均位于：

{FlexLua开源网盘} -> {Software} -> {DTU01万能采集器}-> {Others} -> {WiFi 主动发送} -> {MQTT} 文件夹中

（4）WiFi TCP主动传输（直流供电+电池供电）

周期性采集 烟雾探测传感器数据并转换成可读性更强的 Json 字符串，然后通过 WiFi Tcp 发送至云端，Json 字符串示例如下：

{"Dev":"TH","Data":{"Smog":1},"Err":null}

实现方法如下：

• 请仔细阅读参考 DTU01 的《软件使用指导书(OTHERS_WIFI_TCP)》，并在 main.lua 源代码文件中修改好"配置信息"
• 将第五节中提供的"传感器采集核心代码"覆盖至相应的 main.lua 源代码文件中
• 注意：如果需要使用低功耗电池供电功能，还需在配置信息中配置 SysSleepEn 参数

指导书文件和main.lua源代码文件均位于：

{FlexLua开源网盘} -> {Software} -> {DTU01万能采集器}-> {Others} -> {WiFi 主动发送} -> {TCP} 文件夹中

（5）Lora 主动传输（直流供电+电池供电）

Lora从机周期性采集 烟雾探测传感器数据并转换成可读性更强的 Json 字符串，然后无线发送至Lora中心点网关（DTU02万能网关），Json 字符串示例如下：

{"LrAddr":1,"Dev":"TH","Data":{"Smog":1},"Err":null}

实现方法如下：

• 请仔细阅读参考 DTU01 的《软件使用指导书(OTHERS_LORA_ACTIVE)》，并在 main.lua 源代码文件中修改好"配置信息"
• 将第五节中提供的"传感器采集核心代码"覆盖至相应的 main.lua 源代码文件中
• 注意：如果需要使用低功耗电池供电功能，还需在配置信息中配置 SysSleepEn 参数

指导书文件和main.lua源代码文件均位于：

{FlexLua开源网盘} -> {Software} -> {DTU01万能采集器} -> {Others} -> {Lora主动发送} 文件夹中

Lora通信组网需要结合 DTU02万能网关，DTU02网关可支持以下功能：

• Lora 转 4G 透传
• Lora 转 WiFi 透传
• Lora 转 以太网 透传

DTU02万能网关的资料位于：

{FlexLua开源网盘} -> {Software} -> {DTU02万能网关} 文件夹中

（6）Lora 被动传输（直流供电）

本设备以 Lora 从机方式工作，等待 Lora中心点网关（DTU02万能网关）发来查询 Json 指令，查询指令格式如下：

--"LrAddr"=1表示云端服务器希望网关去查询其旗下的某个Lora从机地址为1的设备
--例如："Dev"="TH"表示查询指令标识(例如表示查询某款传感器的数据，该标识可用来区分传感器)
{"LrAddr":1, "Dev":"TH"}

当收到以上 Json 指令后，本设备通过采集烟雾探测传感器的数据并转换成可读性更强的 Json 字符串，然后通过 Lora 返回给网关（DTU02万能网关），返回的 Json 数据格式如下：

{"LrAddr":1, "Dev":"TH","Data":{"Smog":1},"Err":null}

实现方法如下：

• 请仔细阅读参考 DTU01 的《软件使用指导书(OTHERS_LORA_PASSIVE)》，并在 main.lua 源代码文件中修改好"配置信息"
• 将第五节中提供的"传感器采集核心代码"覆盖至相应的 main.lua 源代码文件中

指导书文件和main.lua源代码文件均位于：

{FlexLua开源网盘} -> {Software} -> {DTU01万能采集器} -> {Others} -> {Lora被动发送} 文件夹中

Lora通信组网需要结合 DTU02万能网关，DTU02网关可支持以下功能：

• Lora 转 4G 透传
• Lora 转 WiFi 透传
• Lora 转 以太网 透传

DTU02万能网关的资料位于：

{FlexLua开源网盘} -> {Software} -> {DTU02万能网关} 文件夹中

（7）以太网 Tcp Client 主动传输（直流供电）

周期性采集烟雾探测传感器数据并转换成可读性更强的 Json 字符串，然后通过 以太网 Tcp Client 发送至云端，Json 字符串示例如下：

{"Dev":"TH","Data":{"Smog":1},"Err":null}

实现方法如下：

• 请仔细阅读参考 DTU01 的《软件使用指导书(OTHERS_ETH_ACTIVE)》，并在 main.lua 源代码文件中修改好"配置信息"
• 将第五节中提供的"传感器采集核心代码"覆盖至相应的 main.lua 源代码文件中

指导书文件和main.lua源代码文件均位于：

{FlexLua开源网盘} -> {Software} -> {DTU01万能采集器} -> {Others} -> {Eth主动发送} 文件夹中

（8）以太网 TCP Server 被动传输（直流供电）

本设备的以太网接口以 TCP Server 静态 IP 方式工作，等待 Client 设备发来查询 Json 指令，指令格式如下：

--"Dev"="TH"表示查询指令标识(例如表示查询某款传感器的数据，该标识可用来区分传感器)
{"Dev":"TH"}

当收到以上 Json 指令后，本设备通过采集烟雾探测传感器数据并转换成可读性更强的 Json 字符串，然后通过 以太网 返回给 Client 端，返回的 Json 数据格式如下：

{"Dev":"TH","Data":{"Smog":1},"Err":null}

实现方法如下：

• 请仔细阅读参考 DTU01 的《软件使用指导书(OTHERS_ETH_PASSIVE)》，并在 main.lua 源代码文件中修改好"配置信息"
• 将第五节中提供的"传感器采集核心代码"覆盖至相应的 main.lua 源代码文件中

指导书文件和main.lua源代码文件均位于：

{FlexLua开源网盘} -> {Software} -> {DTU01万能采集器} -> {Others} -> {Eth被动发送} 文件夹中

七、本章相关开源资料汇总

（1）硬件开源资料

硬件	开源网盘路径
《烟雾探测传感器说明书》	{FlexLua开源网盘}->{Spec}->{S014B} 文件夹
《DTU01万能采集器硬件使用指导书》	{FlexLua开源网盘}->{Hardware}->{DTU01万能采集器}->{DTU01硬件使用指导书} 文件夹
《DTU01万能采集器硬件原理图》	{FlexLua开源网盘}->{Hardware}->{DTU01万能采集器}->{DTU01硬件原理图} 文件夹

（2）软件开源资料

注意：以下八个文档，只需按需选择其中一个阅读即可。

软件	开源网盘路径
《4G Mqtt 主动传输实现指导书》及main.lua源码	{FlexLua开源网盘}->{Software}->{DTU01万能采集器}->{Others}->{4G主动发送}->{MQTT} 文件夹
《4G TCP 主动传输实现指导书》及main.lua源码	{FlexLua开源网盘}->{Software}->{DTU01万能采集器}->{Others}->{4G主动发送}->{TCP} 文件夹
《WiFi Mqtt 主动传输指导书》及main.lua源码	{FlexLua开源网盘}->{Software}->{DTU01万能采集器}->{Others}->{WiFi主动发送}->{MQTT} 文件夹
《WiFi TCP 主动传输指导书》及main.lua源码	{FlexLua开源网盘}->{Software}->{DTU01万能采集器}->{Others} ->{WiFi主动发送}->{TCP} 文件夹
《 Lora 主动传输实现指导书》及main.lua源码	{FlexLua开源网盘}->{Software}->{DTU01万能采集器}->{Others}->{Lora主动发送} 文件夹
《 Lora 被动传输实现指导书》及main.lua源码	{FlexLua开源网盘}->{Software}->{DTU01万能采集器}->{Others}->{Lora被动发送} 文件夹
《 以太网主动传输实现指导书》及main.lua源码	{FlexLua开源网盘}->{Software}->{DTU01万能采集器}->{Others}->{ETH主动发送} 文件夹
《 以太网被动传输实现指导书》及main.lua源码	{FlexLua开源网盘}->{Software}->{DTU01万能采集器}->{Others}->{ETH被动发送} 文件夹

（3）其他（非必需）

如对源代码中的实现细节感兴趣，开发者可查阅 《Lua编程学习指导》、《ShineBlink 函数API手册》、《ShineBlink C2M模组资料》：

内容	开源网盘路径
《Lua编程学习指导》	{FlexLua开源网盘}->{Tutorial}->{Lua编程学习指导} 文件夹
《ShineBlink 函数API手册》	{FlexLua开源网盘}->{Tutorial}->{ShineBlink 函数API手册} 文件夹
《ShineBlink C2M模组资料》	{FlexLua开源网盘}->{Tutorial}->{ShineBlink C2M模组资料} 文件夹