专业提供Sub-G无线自组网通信方案

微 网 高 通

P3. 读取固件的版本号
来源: | 作者:微网高通 | 发布时间: 2025-06-12 | 11 次浏览 | 分享到:

3.1函数说明


函数名

char GetModuleVersion( char iShell, VersionInfo * pVersion )

头文件

API-WiMinet.h

静态库

WiMinet.lib

动态库

WiMinet.dll


形式

说明

参数一

char iShell

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

参数二

VersionInfo * pVersion

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

返回值

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




3.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.3 上电自举与固件升级

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

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



首页 >> P3. 读取固件的版本号