2. 连接和断开无线设备

2025-05-01

2.1 打开通讯端口


函数名
char OpenWiMinetShell( char * pDevice, long dwParam, char iBlockMode )
头文件
API-WiMinet.h
静态库
WiMinet.lib
动态库
WiMinet.dll

形式
说明
参数一
char * pDevice
目标设备的通讯端口名称,以字符串形式输入,分为串口和网口两种接口端口类型,共计三种模式:   
  1. 串口通讯,就用“COM1”,“COM2”等名称,不区分大小写,也成“com1”,“”“com2”等也可以。   

  2. 网口通讯,基站作为 TCP Server,填写基站的IP地址,比如     “192.168.0.240”,见下图中“TCP Server模式”红色框住的部分。

  3. 网口通讯,基站作为 TCP Client,填写运行当前目标程序的PC或者云服务器的IP地址,比如PC或者云服务器的IP地址,同时需要确保基站配置软件中控制中心的IP地址需要填写为该地址,见下图中“TCP Client模式”红色框住的部分

参数二
long dwParam
跟通讯端口相关的参数,针对串口和网口两种接口类型,有下述三种设定:   
  1. 串口通讯:填写基站的串口波特率,默认是115200

  2. 网口通讯,基站做TCP Server模式,填写基站的 TCP通讯端口,填写固定数值12580   

  3. 网口通讯,基站做TCP Client,模式,填写运行该目标程序的PC或者云服务器的TCP Server的端口号码,该数值需要和基站的设定一致,见下图“TCP 端口号码”红色方框所示

参数三
char iBlockMode

通讯模式,同步阻塞模式,填写0X01,异步非阻塞模式,填写0X00,下面是两种模式的使用方式以及具体差异:   

  1. 同步模式下:所有的操作命令,发完了请求报文之后,需要读取返回结果,经过了一定的时间如果没有收到应答,返回失败。   

  2. 异步模式下:所有的操作命令,发送完了请求报文之后,不需要读取返回结果,等待返回结果到达之后,发送通知消息给应用程序的窗体或者其他资源句柄,通知其来读取命令结果。

返回值
0X01=操作成功,0X00=操作失败
示例一
打开串口通讯 OpenWiMinetShell( "COM3",115200, 0X01 )
示例二
打开网口通讯 OpenWiMinetShell( "192.168.0.240",12580, 0X01 )



TCP Server模式


TCP Client模式



TCP 端口号码



2.2 关闭通讯端口

函数名
char StopWiMinetShell( char iShell )
头文件
API-WiMinet.h
静态库
WiMinet.lib
动态库
WiMinet.dll

形式
说明
参数一
char iShell
通讯端口的编号,填写固定数值0X00
返回值
0X01=操作成功,0X00=操作失败


阅读0
分享
写下您的评论吧