智能网关开发与应用 课件 第10章 温湿度传感设备的驱动开发

OpenWrt智能网关开发与应用第10章温湿度传感设备的驱动开发基于ModbusRTU协议实战案例本章内容导航01学习目标明确本章核心知识点与技能要求02建大仁科温湿度传感器介绍硬件特性、参数规格及接口定义03Modbus通信协议详解RTU/ASCII模式、功能码及数据帧结构04Libmodbus实战开发库的编译、配置与基本API调用实践05传感器驱动实现(基于SimpleDeviceModel)从框架适配到完整驱动程序的编写与测试本章学习目标学习目标掌握ModbusRTU协议的应用原理与通信机制掌握建大仁科RS-WS-N01-6J系列温湿度传感设备的驱动开发流程技能目标熟练使用Libmodbus库进行数据的读写与解析使用C语言完成驱动开发，包含数据结构定义与错误处理在OpenWrt系统中完成驱动部署、运行与调试测试素养目标提升独立解决问题的能力，学会查阅资料并分析复杂问题增强动手实践能力，将理论知识有效转化为实际项目成果培养创新意识，探索驱动开发技术在其他领域的应用潜力10.1建大仁科温湿度传感器介绍了解温湿度传感器基础，掌握核心技术参数CHAPTER10.1/HARDWAREINTRODUCTION什么是RS-WS-N01-6J？高精度测量采用瑞士进口测量单元，确保工业级精度与稳定性。数据记录与显示内置存储65535组数据，大屏液晶实时显示温湿度与时间。灵活报警功能支持蜂鸣器、声光报警及继电器输出，自定义上下限。远程配置与监控支持平台远程参数设置和历史数据召测，管理更便捷。多场景广泛应用适用于冷链物流、医药仓储、机房及科研实验室等场景。RS-WS-N01-6J功能特点高精度测量单元采用瑞士原装进口测温单元，测量精度高、抗干扰能力强。大容量数据记录内置存储器，最大可记录65535组温湿度数据，数据不丢失。本地按键与显示液晶按键设定参数，大屏实时显示温湿度、时间及设备地址。远程监控与配置支持平台远程召测及参数设置，实现无人值守的高效管理。多种报警输出内置蜂鸣器、外延声光报警及2路开关量输出，灵活关联事项。稳定可靠的通信RS485信号输出，最远通信2000米，采用专业防雷设计。宽电压输入适应工业现场支持10~30V宽电源电压输入，完美适应各种复杂的工业现场供电环境。RS-WS-N01-6J主要技术参数参数类别参数项规格供电直流供电（默认）DC10-30V，最大功耗0.4W测量精度A准精度(湿度/温度)±2%RH/±0.4℃(25℃)测量精度B准精度(默认)(湿度/温度)±3%RH/±0.5℃(25℃)工作环境变送器电路/探头工作温湿度-20~60℃/-40~120℃；0~95%RH/0~100%RH显示与刷新分辨率/刷新时间0.1℃/0.1%RH；1s快速刷新稳定性与响应长期稳定性/响应时间≤1%RH/y/≤8s(湿度)；≤0.1℃/y/≤25s(温度)通信接口输出信号RS485(ModbusRTU协议)记录功能存储容量/模式65535条（默认间隔可存4年），支持自动记录传感器面板与显示说明面板布局示意面板集成了电源指示灯、运行指示灯及多功能按键。通过这些组件，用户可直接在本地查看设备状态并进行基础参数设置。液晶显示功能详解实时监测：直观显示温湿度值，支持超限报警闪烁提示状态反馈：实时显示设备通信状态及数据存储模式参数轮显：循环展示地址、波特率、时间及历史数据量交互模式：清晰指示当前是否处于参数修改配置状态10.2Modbus通信协议详解掌握工业标准串行通信协议Modbus协议概述Modbus是工业领域最流行的串行通信标准之一，由施耐德公司于1979年开发，被誉为连接工业自动化设备的通用语言。完全开放与免费无著作权要求，任何制造商均可免费使用，促进了广泛的设备互操作性。简单易用易维护协议结构简单，对开发者友好，易于部署、测试和后期维护。多物理层支持灵活支持RS232、RS485、TCP/IP等多种物理层，适应不同网络环境。工业设备通用语言广泛应用于PLC、传感器、变频器等设备，是工业自动化的事实标准。Modbus主从通信模式主站(Master)主动发起通信请求（如OpenWrt网关），网络中通常只有一个主站。从站(Slave)被动响应请求（如传感器），拥有唯一SlaveID，网络中可存在多个。通信流程主站发送请求帧->目标从站响应并返回数据->其他从站忽略。Modbus协议分类ModbusRTU(重点)串行通信(RS232/485)，二进制编码，效率高，工业现场最常用。ModbusTCP以太网通信，封装在TCP/IP数据包中，工业以太网标准之一。ModbusASCIIASCII字符编码，传输效率较低，目前较少使用。ModbusPlus(MB+)施耐德专有协议，用于高速令牌环网，需专用硬件。CHAPTER10.3软件设计开发基于ModbusRTU的驱动开发实战Libmodbus库开发实战什么是Libmodbus？免费开源的跨平台协议库支持RTU和TCP两种通信模式封装了复杂的协议帧格式与校验提供简洁易用的C语言API接口RTU模式核心API流程modbus_new_rtu()-创建实例，指定串口、波特率等参数modbus_set_slave()-设置通信的从站地址(SlaveID)modbus_connect()-建立与从站的Modbus物理连接modbus_read_registers()-读取保持寄存器（核心：读温湿度数据）modbus_close()-关闭Modbus连接modbus_free()-释放实例占用的系统资源传感器Modbus协议解析问询帧(读保持寄存器0x03)地址码功能码起始地址数据长度CRC校验0x01(从站)0x03(读寄存器)0x00000x0002(温湿度)0xC40B应答帧(数据解析与补码处理)地址码功能码字节数湿度值(寄存器)温度值(寄存器)CRC校验0x010x030x040x02920xFF9B0x5A3D湿度解析：0x0292=658→658/10=65.8%RH温度解析：0xFF9B(补码)=-101→-101/10=-10.1℃(需处理负数补码)Libmodbus通信示例代码解析核心C语言代码实现//1.初始化RTU实例ctx=modbus_new_rtu("/dev/ttyS1",4800,'N',8,1);//2.设置从站地址并建立连接modbus_set_slave(ctx,0x01);modbus_connect(ctx);//3.读取保持寄存器(0x00开始的2个寄存器)rc=modbus_read_registers(ctx,0,2,tab_reg);//4.数据解析(处理负数补码逻辑)temp=tab_reg[0]&0x8000?(int16_t)tab_reg[0]/10.0:tab_reg[0]/10.0;//5.释放资源modbus_close(ctx);modbus_free(ctx);关键步骤与逻辑解析初始化与配置设置串口参数(4800-N-8-1)，指定从站地址0x01，建立物理连接。寄存器读取调用read_registers读取起始地址0的2个寄存器值，存入缓冲区。数据解析与转换将整数寄存器值除以10.0转换为浮点数；特别处理负数补码逻辑。资源释放操作完成后，务必关闭连接并释放上下文，避免内存泄漏。驱动开发：定义私有数据结构rkckth_ws_n01_6j_drvdata.h/**@brief温湿度传感器驱动私有数据结构保存驱动运行时的上下文信息/typedefstruct_rkckth_drvdata{modbus_tmCtx;/*ModbusRTU上下文指针*/}rkckth_ws_n01_6j_drvdata_t;结构定义定义了名为rkckth_ws_n01_6j_drvdata_t的结构体，用于封装驱动运行时的所有状态信息。核心成员mCtx包含一个指向modbus_t类型的指针，用于保存Open接口中创建的ModbusRTU实例。通信核心句柄该上下文指针是驱动与传感器通信的“通行证”，在后续的Read、Write等操作中作为核心句柄使用。驱动开发：实现SimpleDeviceModel接口驱动接口函数功能描述probe设备探测与添加回调，为私有数据结构分配内存。remove设备移除回调，释放私有数据结构占用的内存资源。open初始化Modbus通信，创建RTU实例并建立连接。close关闭Modbus连接，释放RTU实例资源。preread操作前的预处理，如加锁等。postread操作后的后处理，如解锁等。read核心数据读取接口，调用LibmodbusAPI完成数据解析。接口实现：probe&removerkckth_ws_n01_6j_probeintrkckth_ws_n01_6j_probe(void*pv){//分配私有数据内存drvdata=g_malloc0(sizeof(*drvdata));if(!drvdata)return-1;//挂载到设备配置结构体config->mPriv=drvdata;return0;}功能：为驱动的私有数据结构分配内存，并将其挂接到设备配置结构体中，实现资源初始化。rkckth_ws_n01_6j_removeintrkckth_ws_n01_6j_remove(void*pv){drvdata=(drvdata_t*)config->mPriv;//释放之前分配的内存g_free(drvdata);//清理指针防止野指针config->mPriv=NULL;return0;}功能：释放私有数据结构占用的内存，并清理设备配置的mPriv指针，防止内存泄漏。接口实现：open&closerkckth_ws_n01_6j_open接口//1.创建ModbusRTU实例modbus_t*ctx=modbus_new_rtu(DEV,BAUD,PARITY,DATA,STOP);//2.设置从站地址并建立连接modbus_set_slave(ctx,0x01);modbus_connect(ctx);//3.保存上下文指针到私有数据drvdata->mCtx=ctx;功能描述根据设备配置参数初始化串口，创建ModbusRTU实例并建立连接，将上下文指针保存至私有数据结构中以便后续操作。rkckth_ws_n01_6j_close接口//1.从私有数据中获取上下文modbus_t*ctx=drvdata->mCtx;//2.关闭连接并释放资源modbus_close(ctx);modbus_free(ctx);//3.置空指针防止野指针drvdata->mCtx=NULL;功能描述负责资源的释放与清理。关闭Modbus连接，释放上下文对象，并将私有数据中的指针置空，确保系统资源不泄露。接口实现：pre&postrkckth_ws_n01_6j_pre接口intrkckth_ws_n01_6j_pre(void*pv){LOGD("rkckth_ws_n01_6j_precalled\n");//TODO:执行预处理操作(如加锁)return0;}功能说明：在read操作前调用。常用于执行预处理工作，例如为了保证线程安全而对共享资源（如传感器）进行加锁。rkckth_ws_n01_6j_post接口intrkckth_ws_n01_6j_post(void*pv){LOGD("rkckth_ws_n01_6j_postcalled\n");//TODO:执行后处理操作(如解锁)return0;}功能说明：在read操作后调用。常用于执行后处理工作，例如与pre接口配合，对共享资源进行解锁操作。接口实现：readrkckth_ws_n01_6j_read()核心逻辑//1.获取Modbus上下文与读取寄存器modbus_t*ctx=drvdata->mCtx;intrc=modbus_read_registers(ctx,0,2,tab_reg);//2.根据配置解析温度或湿度if(strncmp(config->mDomain,"T",1)==0){result=tab_reg[0]/10.0f;//温度处理}elseif(strncmp(config->mDomain,"H",1)==0){result=tab_reg[1]/10.0f;//湿度处理}//3.格式化结果并返回snprintf(value,sizeof(value),"%.1f",result);memcpy(config->mStrResult,value,sizeof(value));功能流程解析获取上下文从驱动私有数据结构中提取ModbusRTU实例(ctx)，建立通信基础。寄存器读取调用libmodbus核心API读取保持寄存器，一次性获取温湿度原始数据。数据解析与校准根据mDomain参数区分温湿度，进行浮点换算，并处理温度的负数补码情况。结果封装返回将解析后的数值