P3. 读取固件的版本号
2025-04-29
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读取到的信息与打印信息对比验证正确性。
另外设备在做完固件升级之后，其版本号码会发生变化。通过对比版本号码的变化可以检验升级成功与否。
阅读11
写下您的评论吧