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

【SDK调用】如何快速读取无线通讯设备的固件版本号?

 二维码
作者:WiMi-net 微网智控来源:WiMi-net 微网智控网址:http://www.wiminet.cn/h-col-106.html

   为了缩短用户的开发周期,简化用户使用自组网产品的流程,降低使用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无线通讯设备的电磁波唤醒节点的业务?


本章节重点讲述第3个问题:如何快速读取WiMi-net无线通讯设备的固件版本号?


1.函数说明


函数名

char GetModuleVersion(

char          iShell,

VersionInfo   * pVersion )

头文件

API-WiMinet.h

静态库

WiMinet.lib

动态库

WiMinet.dll


形式

说明

参数一

char iShell

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

参数二

VersionInfo   * pVersion

指向一个已经分配好实体内存空间的VersionInfo结构体,详细定义见“VersionInfo”结构体说明

返回值

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


2.VersionInfo 结构体说明

//-----------------------------------------------------------------------------

// DESCRIPTION:

//-----------------------------------------------------------------------------

typedef struct_VersionInfo

{

   //--------------------------------------------------------------------------

   // DESCRIPTION:   

   // --------------------------------------------------------------------------

   unsigned long                         m_dwInfoSize;   

   

   //--------------------------------------------------------------------------

   // DESCRIPTION:

   // --------------------------------------------------------------------------

   unsigned long                    m_dwMajorVersion;

   

   //--------------------------------------------------------------------------

   // DESCRIPTION:

   //--------------------------------------------------------------------------

   unsigned long                    m_dwMinorVersion;

   

   //--------------------------------------------------------------------------

   // DESCRIPTION:

    //--------------------------------------------------------------------------

   unsigned long                    m_dwBuildNumber;

   

   //--------------------------------------------------------------------------

   // DESCRIPTION:

   //--------------------------------------------------------------------------

   unsigned long                    m_dwPlatformId;

   

   //--------------------------------------------------------------------------

   // DESCRIPTION:

   //--------------------------------------------------------------------------

   char                            m_pVersion[0X80];     

   

} VersionInfo;


名称

VersionInfo

数值

说明

m_dwInfoSize

描述信息的实际长度,32位长整型

m_dwMajorVersion

固件的次要版本号码,32位长整型

m_dwMinorVersion

固件的次要版本号码,32位长整型

m_dwPlatformId

设备的硬件平台标识,32位长整型

m_pVersion

设备的固件描述信息,字符串,**长度128字节

3. 上电自举与固件升级

设备的固件版本信息,在上电自举完成之后,会从串口打印出来,其中最后一行“[S/W Version]”一栏就是固件的信息。可以将该API读取到的信息与打印信息对比验证正确性。

另外设备在做完固件升级之后,其版本号码会发生变化。通过对比版本号码的变化可以检验升级成功与否。