【SDK调用】如何快速连接和断开WiMi-net433MHz无线通信设备？
时间：2021-12-30 阅读：151
为了缩短用户的开发周期，简化用户使用自组网产品的流程，降低使用WiMi-net自组网通讯系统的难度，提高用户整体系统的可靠性和稳定性，WiMi-net免费开放WiMi-net无线自组网管理平台Win32 SDK。
OEM用户可以调用微网高通提供的上位机（PC端）SDK将WiMi-net自组网通讯系统集成到用户的应用信息管理平台，我们在《WiMi-net无线自组网管理平台Win32 SDK函数说明书--初级版 V4.0》为用户解决如下7问题：
1、如何快速搭建WiMi-net无线自组网安装开发环境？
√ 2、如何快速连接和断开WiMi-net无线自组网设备？
3、如何快速读取WiMi-net无线通讯设备的固件版本号？
4、如何快速接入WiMi-net无线自组网网络？
5、如何快速操作WiMi-net无线通讯设备的数据发送业务？
6、如何快速操作WiMi-net无线通讯设备的数据接收业务？
7、如何快速操作WiMi-net无线通讯设备的电磁波唤醒节点的业务？
本章节重点讲述第2个问题：如何快速连接和断开433MHzWiMi-net无线通信设备？
一、打开通讯端口
函数名 | char OpenWiMinetShell( char * pDevice, long dwParam, char iBlockMode ) | |
头文件 | API-WiMinet.h | |
静态库 | WiMinet.lib | |
动态库 | WiMinet.dll | |
形式 | 说明 | |
参数一 | char * pDevice | 目标设备的通讯端口名称，以字符串形式输入，分为串口和网口两种接口端口类型，共计三种模式： （a）串口通讯，就用“COM1”，“COM2”等名称，不区分大小写，也成“com1”，“com2”等也可以。 （b）网口通讯，基站作为 TCP Server，填写基站的IP地址，比如 “192.168.0.240”，见下图中“TCP Server模式”红色框住的部分。 （c）网口通讯，基站作为 TCP Client，填写运行当前目标程序的PC或者云服务器的IP地址，比如PC或者云服务器的IP地址，同时需要确保基站配置软件中控制中心的IP地址需要填写为该地址，见下图中“TCP Client模式”红色框住的部分 |
参数二 | long dwParam | 与通讯端口相关的参数，针对串口和网口两种接口类型，有下述三种设定： （a）串口通讯：填写基站的串口波特率，默认是115200 （b）网口通讯，基站做TCP Server模式，填写基站的 TCP通讯端口，填写固定数值12580 （c）网口通讯，基站做TCP Client，模式，填写运行该目标程序的PC或者云服务器的TCP Server的端口号码，该数值需要和基站的设定一致，见下图“TCP 端口号码”红色方框所示 |
参数三 | char iBlockMode | 通讯模式，同步阻塞模式，填写0X01，异步非阻塞模式，填写0X00，下面是两种模式的使用方式以及具体差异： （a）同步模式下：所有的操作命令，发完了请求报文之后，需要读取返回结果，经过了一定的时间如果没有收到应答，返回失败。 （b）异步模式下：所有的操作命令，发送完了请求报文之后，不需要读取返回结果，等待返回结果到达之后，发送通知消息给应用程序的窗体或者其他资源句柄，通知其来读取命令结果。 |
返回值 | 0X01=操作成功，0X00=操作失败 | |
示例一 | 打开串口通讯OpenWiMinetShell( "COM3",115200, 0X01 ) | |
示例二 | 打开网口通讯OpenWiMinetShell( "192.168.0.240",12580, 0X01 ) | |
TCP Server模式
TCP Client模式
TCP 端口号码
二、关闭通讯端口
函数名 | char StopWiMinetShell( char iShell ) | |
头文件 | API-WiMinet.h | |
静态库 | WiMinet.lib | |
动态库 | WiMinet.dll | |
形式 | 说明 | |
参数一 | char iShell | 通讯端口的编号，填写固定数值0X00 |
返回值 | 0X01=操作成功，0X00=操作失败 | |