From b69acb26d60e1894cbca98105b9a1e5ca3564bcb Mon Sep 17 00:00:00 2001 From: liufumingren Date: Fri, 25 Sep 2026 17:05:42 +0800 Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E6=96=B0=E5=A2=9E=20X9R=20?= =?UTF-8?q?=E6=9C=BA=E5=9E=8B=E6=B3=A8=E6=84=8F=20-=20=E4=BE=9B=E7=94=B5/U?= =?UTF-8?q?SB=20=E5=8F=A3/=E5=9B=BA=E4=BB=B6=E5=B7=AE=E5=BC=82=EF=BC=88202?= =?UTF-8?q?6-09-25=20=E5=AE=9E=E6=B5=8B=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 现场"扫着扫着就扫不上、重启才好"的实测根因是硬件,写进 README 供装机/巡检执行: - 电源必须 ≥12V/2.5A(推荐 3A):12V/2.0A(24W) 满载实测出现 2 次 usb 2-1(内部 Hub) + usb 2-1.4(扫码枪) 掉线、device not accepting address error -71、4 次总线复位,枪离线 13/120; 2.5A 与"2A 但撤掉音响"均为 0 掉线、枪 120/120。 - 禁止从平板 USB 口给音响取电:与内部 Hub/扫码枪共用 5V 支路,语音播报峰值触发过流 -> 先掉 Hub 再掉枪 -> 应用侧 keys=0。给出 dmesg 判据与四种正确接法。 - 其他机型注意:adb 换 USB 口才认设备;该固件 WebView 实现是 Chrome 不可卸载; 开机自启需先手动启动过一次(stopped/notLaunched 检查命令);扫码枪身份与 event 节点; 满载 75℃ 散热建议;建议走网线。 - 现场排查工具与排查口诀(keys=0 -> 查 dmesg)。 --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) diff --git a/README.md b/README.md index 61897f2..95bf783 100644 --- a/README.md +++ b/README.md @@ -63,3 +63,62 @@ export default { 2. **不要**在新页面 WebView 创建早期(onLoad)调用 `plus.screen.lockOrientation` / `plus.webview.currentWebview().setStyle` 等 native 操作——实测无效且会触发 `AdaUniWebView` 的 `ViewOptions.updateViewData` NPE。横屏由 `manifest.json` 的全局 `screenOrientation` 配置承担,打包页的 lockLandscape 已因此移除; 3. 若新增页面在真机出现同样白屏,按上面的示例接入 `installZeroViewportFix` 即可; 4. 排查白屏类问题先看**视口尺寸**(renderjs 里打 Log),而不是猜字体/样式——0×0 视口下 CSS 的 vw/vh 全部失效是这类白屏的典型特征。 + +## ⚠️ 机型注意:X9R 工控机的供电 / USB 口 / 固件差异(2026-09-25 实测) + +> 结论先说:这台机器的「扫码突然没反应」**多数不是软件问题**,而是供电不足或 USB 口上挂了耗电外设。 +> 装机、巡检、换电源前请先读本节。实测机型:X9R(RK3288 / Android 7.1.2 / 内核 4.4.112)。 + +### 一、电源:必须 ≥12V/2.5A(推荐 3A) + +| 电源 | 满载实测(屏幕最亮 + 4 核满载 60s) | 结果 | +|---|---|---| +| 12V/**2.5A** | USB 掉线 0 次,扫码枪全程在线(120/120) | ✅ 可用 | +| 12V/**2.0A**(24W) | dmesg 出现 **2 次 `usb 2-1: USB disconnect`**(内部 USB Hub 与扫码枪一起掉)、`device not accepting address, error -71`、4 次总线复位;采样中枪离线 13/120(约 6.5s) | ❌ 临界,不可用 | + +24W 是**临界值**:屏背光最亮 + WiFi + 内部 USB Hub + 扫码枪 + 喇叭峰值很容易越过它。 + +### 二、⛔ 绝对不要从平板 USB 口给外设(音响)供电 + +**现象**:插上 USB 音响后「扫着扫着就扫不上」,重启设备才恢复;**12V/2.5A 电源现场同样复现**。 + +**根因**:音响与内部 USB Hub、扫码枪共用同一条 5V 支路(USB 口规范每口仅 0.5A,音响常远超)→ 一放音(尤其每次扫码后的**语音播报峰值**)Hub 就过流跳闸 → 先掉 Hub(`usb 2-1`)再掉枪(`usb 2-1.4`)→ 应用侧表现就是 **`keys=0`(一个按键都收不到)**。 + +**现场判据(不用拆机、不用 root)**: + +```bash +adb shell "dmesg | grep -E 'USB disconnect|error -71' | tail -20" +``` + +- 同时出现 `usb 2-1:`(Hub)与 `usb 2-1.x`(枪)→ **USB 口上挂了耗电外设 / 供电不足**; +- 只有 `usb 2-1.4`(枪)单独掉 → 更可能是枪的线材/接头。 + +**正确接法**:① 音响自带电源适配器;② 用**带独立供电的 USB Hub**(Hub 自己给音响供电,平板只出信号);③ 蓝牙/自带电池音箱;④ 若必须吃 12V,从 12V 母线单独引一路,不要走平板 USB 口。 + +### 三、其他机型相关注意 + +| 项目 | 说明 | +|---|---| +| **adb 认不到设备** | 同一台机器**换个 USB 口可能就认**:实测某个口 Windows 会把 `USB\VID_2207&PID_0006` 绑成通用 WinUSB 驱动,`adb devices` 全空;换口后立刻正常。**先换口/换线,别急着装驱动** | +| **不要卸载 Chrome** | 该固件 WebView 实现就是 Chrome(`adb shell settings get global webview_provider` = `com.android.chrome`),卸了打包页直接白屏;`com.android.webview` 同样必须保留 | +| **开机自启的前提** | 自启靠原生 `BootReceiver`(`BOOT_COMPLETED` / `QUICKBOOT_POWERON`)。**新装机或被 `force-stop` 后必须手动启动一次**(Android 3.1+ 规则);检查:`adb shell dumpsys package com.gztbyc.sandan \| grep 'User 0'` 需为 `stopped=false notLaunched=false` | +| **扫码枪身份** | USB HID 键盘(`Newtologic DW-8200`,VID_060E:PID_0960),挂在 `usb-1.4` → `/dev/input/event4`,供后续排查对照 | +| **散热** | 4 核满载实测 75℃(室温环境、无散热片);7×24 使用建议加散热片/小风扇,否则会热降频 | +| **网络** | 建议走网线(`eth0` 存在但默认无链路,先确认机器有没有 RJ45 口);WiFi 是 Broadcom SDIO,做常驻服务不稳 | + +### 四、现场排查工具 + +| 工具 | 用途 | +|---|---| +| 诊断面板 | 打包页标题**3 秒内连点 5 次**(退件页为「拆包工作台」同操作):实时看按键到达 / 丢弃原因 / 门控快照 / 自愈次数,可复制与一键上报 | +| `scripts/scan-forensics.ps1` | 故障**当场**一键取证:内核按键流 + dmesg + App 心跳 + 自动判据(内核有事件而 App `keys=0` → 上层;内核无事件 → 枪/线/供电) | +| `scripts/power-probe.sh`、`scripts/power-load-test.sh` | 电源/负载对比实测(采样 ADC、温度、CPU 频率、扫码枪是否仍在总线) | +| logcat | `adb logcat -s WMSScan`(扫码链路)、`WMSPage`(页面生命周期)、`UniConsole` / `UniViewConsole`(JS 日志) | + +> 日志上行已做降噪(2026-09-25):本地明细全部保留(面板 + logcat + 环形缓存),**只有异常才上报服务端**(主线程卡顿、真自愈、活动突然中断),正常扫码不再产生上行记录。 + +### 五、排查口诀 + +1. 先看诊断面板的 `按键到达`:**`keys=0` → 按键根本没到 JS**,转第 2 步;有 `keys` 但业务没生效 → 看 `丢弃统计` 的 reason(属 JS 门控,按 reason 定位)。 +2. `keys=0` 时执行上面那条 `dmesg | grep -E 'USB disconnect|error -71'`:**有输出 → 供电 / USB 口外接耗电外设**(见本节一、二);无输出 → 枪 / 线材 / 系统扫码服务。 +3. 长跑中「突然扫不上、重启才好」几乎都是第 2 步命中的供电类问题:先换电源、拔掉 USB 音响,再复核。