萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 設備名稱修改:解決豌豆莢/QQ管家顯示錯誤設備型號問題

問題背景

基於君正 JZ4770 方案開發產品時,發現通過豌豆莢、QQ電腦管家等 PC 端工具連接設備,顯示的設備名稱仍為原廠「艾諾 Novo7 Basic」,而非自定義的「SmartQ7Candy」。雖然在「設置 → 關於平板 → 型號」中已正確顯示自定義型號,但 USB 連接識別仍舊錯誤。

根因分析

PC 端助手軟件識別設備型號主要讀取 USB 設備描述符中的 iSerial 序列號,而非系統屬性 ro.product.model。經排查:

  1. adb devices 顯示 "Novo7 Basic",確認是 USB 層面標識
  2. 內核驅動 drivers/usb/gadget/android.c 中創建 android_usb 類設備
  3. iSerial 屬性通過 CONFIG_USB_SERIAL_NUM 內核配置宏定義

解決方案

方法一:修改內核配置(推薦,徹底解決)

  1. 進入內核源碼目錄,執行 make menuconfig 或直接編輯 .config
  2. 找到 CONFIG_USB_SERIAL_NUM 設置
  3. 修改為自定義型號:
# 修改前
CONFIG_USB_SERIAL_NUM="Novo7 Basic"

# 修改後
CONFIG_USB_SERIAL_NUM="SmartQ Candy"
  1. 重新編譯內核:make -j4
  2. 燒錄新內核至設備

方法二:修改設備樹/板級配置(視具體平台而定)

部分平台在板級 .mk 或設備樹 .dts 中定義 USB 序列號,搜索關鍵字 usb_serial、serial_number、android.usb.serial 進行修改。

驗證結果

  • 豌豆莢:正確識別為 "SmartQ Candy" ✓
  • QQ電腦管家:識別為 "OPhone" ⚠

原因分析: QQ管家維護內部設備白名單庫,「SmartQ Candy」不在庫中,未識別設備統一歸類為 "OPhone"。此為 PC 端軟件邏輯問題,非設備端故障。

補充:adb devices 顯示名稱修改

adb devices 顯示的序列號同樣源自 iSerial,修改內核配置後同步生效。

最佳實踐建議

  1. 統一標識:確保 ro.product.model、ro.product.brand、CONFIG_USB_SERIAL_NUM、ro.build.fingerprint 等所有標識一致
  2. 白名單申報:向主流助手廠商(豌豆莢、360、騰訊、小米等)提交設備信息錄入白名單
  3. 自動化驗證:在編譯腳本中添加檢查,確保關鍵標識與產品定義一致

相關內核代碼片段

// drivers/usb/gadget/android.c 關鍵片段
static struct usb_gadget_strings android_usb_strings = {
    .language = 0x0409, // en-us
    .strings = android_usb_string_defs,
};

static struct usb_string android_usb_string_defs[] = {
    [STRING_MANUFACTURER_IDX].s = "Android",
    [STRING_PRODUCT_IDX].s = "Android",
    [STRING_SERIAL_IDX].s = serial_string, // 關鍵:iSerial 來源
    {  /* end of list */ }
};

// 初始化時拷貝配置宏
strncpy(serial_string, CONFIG_USB_SERIAL_NUM, sizeof(serial_string) - 1);

// 創建 sysfs 節點供用戶空間讀取
DESCRIPTOR_STRING_ATTR(iSerial, serial_string)
copyright © 萬盛學電腦網 all rights reserved