Panel SDK

Appearance

🛡️⚡ 固件信息（FirmwareInfo）模块 · 开发者指南 ​

🧠 模块介绍 ​

固件信息模块，用于获取和配置设备的各类固件参数，包括厂商、型号、CPU、系统版本、触摸点数等。支持批量自动化运维，助力设备管理高效、专业。

🛠️ PanelSDK 初始化 ​

java
// 推荐在 Application 或 Activity 中初始化，确保全局唯一
PanelSDK panelSDK = new PanelSDK(this);

🧩 核心方法 · 专业解读 ​

🏷️ getFactoryInfo — 获取设备生产商信息 ​

java
String getFactoryInfo()
参数说明
参数类型说明
无返回厂商字符串，如 hzmct
返回值说明
返回值说明
字符串获取成功返回厂商信息
null获取失败
典型场景代码
java
String factory = panelSDK.getFactoryInfo();
if (factory != null) {
    // 🎉 获取成功，厂商信息：${factory}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

🏷️ getProductInfo — 获取产品型号 ​

java
String getProductInfo()
参数说明
参数类型说明
无返回产品型号字符串
返回值说明
返回值说明
字符串获取成功返回产品型号
null获取失败
典型场景代码
java
String product = panelSDK.getProductInfo();
if (product != null) {
    // 🎉 获取成功，产品型号：${product}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

🏷️ getSpecialInfo — 获取定制型号信息 ​

java
String getSpecialInfo()
参数说明
参数类型说明
无返回定制型号信息（定制产品专有）
返回值说明
返回值说明
字符串获取成功返回定制信息
null获取失败
典型场景代码
java
String special = panelSDK.getSpecialInfo();
if (special != null) {
    // 🎉 获取成功，定制信息：${special}
} else {
    // ❗ 获取失败，可能为非定制产品
}

🏷️ getCpuTypeInfo — 获取CPU型号 ​

java
String getCpuTypeInfo()
参数说明
参数类型说明
无返回CPU型号字符串
返回值说明
返回值说明
字符串获取成功返回CPU型号
null获取失败
典型场景代码
java
String cpuType = panelSDK.getCpuTypeInfo();
if (cpuType != null) {
    // 🎉 获取成功，CPU型号：${cpuType}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

🏷️ getCpuSerial — 获取CPU序列号 ​

java
String getCpuSerial()
参数说明
参数类型说明
无返回CPU唯一序列号
返回值说明
返回值说明
字符串获取成功返回序列号
null获取失败
典型场景代码
java
String cpuSerial = panelSDK.getCpuSerial();
if (cpuSerial != null) {
    // 🎉 获取成功，CPU序列号：${cpuSerial}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

🏷️ getAndroidVersionInfo — 获取Android系统版本 ​

java
String getAndroidVersionInfo()
参数说明
参数类型说明
无返回Android系统版本字符串
返回值说明
返回值说明
字符串获取成功返回系统版本
null获取失败
典型场景代码
java
String androidVersion = panelSDK.getAndroidVersionInfo();
if (androidVersion != null) {
    // 🎉 获取成功，Android版本：${androidVersion}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

🏷️ getPlatformVersionInfo — 获取平台代号 ​

java
String getPlatformVersionInfo()
参数说明
参数类型说明
无返回平台代号字符串
返回值说明
返回值说明
字符串获取成功返回平台代号
null获取失败
典型场景代码
java
String platform = panelSDK.getPlatformVersionInfo();
if (platform != null) {
    // 🎉 获取成功，平台代号：${platform}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

🏷️ getSystemVersion — 获取固件版本号 ​

java
String getSystemVersion()
参数说明
参数类型说明
无返回固件版本号字符串
返回值说明
返回值说明
字符串获取成功返回固件版本号
null获取失败
典型场景代码
java
String systemVersion = panelSDK.getSystemVersion();
if (systemVersion != null) {
    // 🎉 获取成功，固件版本：${systemVersion}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

🏷️ getBootVersion — 获取Boot固件版本号 ​

java
String getBootVersion()
参数说明
参数类型说明
无返回Boot固件版本号字符串
返回值说明
返回值说明
字符串获取成功返回Boot固件版本号
null获取失败
典型场景代码
java
String bootVersion = panelSDK.getBootVersion();
if (bootVersion != null) {
    // 🎉 获取成功，Boot版本：${bootVersion}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

🏷️ getOemVersion — 获取Oem固件版本号 ​

java
String getOemVersion()
参数说明
参数类型说明
无返回Oem固件版本号字符串
返回值说明
返回值说明
字符串获取成功返回Oem固件版本号
null获取失败
典型场景代码
java
String oemVersion = panelSDK.getOemVersion();
if (oemVersion != null) {
    // 🎉 获取成功，Oem版本：${oemVersion}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

🛠️ setSerialNo — 设置设备序列号 ​

java
Boolean setSerialNo(String serialno)
参数说明
参数类型说明
serialnoStringSN号字符串
返回值说明
返回值说明
true设置成功
false设置失败
典型场景代码
java
Boolean result = panelSDK.setSerialNo("SN123456789");
if (result != null && result) {
    // ✅ 设置成功，序列号已更新
} else {
    // ❗ 设置失败，可能权限不足或设备不支持
}

🛠️ getEthernetMac — 获取设备网卡MAC地址 ​

java
String getEthernetMac(String eth)
参数说明
参数类型说明
ethString设备网口名
返回值说明
返回值说明
xx:xx:xx设备MAC地址
其他负数具体错误码见下表
典型场景代码
java
String result = panelSDK.getEthernetMac("eth0");

🧾 固件相关错误码 · 分组速查 ​

错误码类型说明
0成功操作成功
-1通用未知错误
-2101指纹/扫码指纹/扫码模块相关错误
-2201指纹指纹状态未配置
-2301FOTAFOTA设备不匹配
-2302FOTAFOTA存储空间不足
-2303FOTAFOTA升级包版本过低
-2304FOTAFOTA差分包不连续
其他更多错误码请参考 StErrorCode.md 或 StErrorCode.java

⚡ 专业进阶 · 技术要点 ​

所有方法均为同步调用，返回值可直接判断结果，适合批量自动化脚本。 推荐在具备系统权限的环境下调用，部分功能需 Root 或系统签名。 依赖底层 StFirmwareInfoManager，请确保相关依赖已集成并兼容目标设备。 支持企业级批量部署、远程 OTA 固件下发。

🏆 专业总结 ​

只需一个 PanelSDK 实例，固件信息随时掌控。无论是批量运维、参数配置还是安全管理，FirmwareInfo 模块让你的设备管理更专业、更高效！