专注 Sub-G 无线组网通信方案
 
设为首页 | 收藏本站

【SDK调用】如何快速连接和断开无线通信设备?

 二维码
作者:WiMi-net 微网智控来源:WiMi-net 微网智控

  为了缩短用户的开发周期,简化用户使用自组网产品的流程,降低使用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 )




2-14.png

   TCP Server模式



2-15.png

   TCP Client模式



2-14.png

   TCP 端口号码



、关闭通讯端口

函数名

char   StopWiMinetShell( char iShell )

头文件

API-WiMinet.h

静态库

WiMinet.lib

动态库

WiMinet.dll


形式

说明

参数一

char iShell

通讯端口的编号,填写固定数值0X00

返回值

0X01=操作成功,0X00=操作失败