更新记录

1.0.1（2026-10-14） 下载此版本

• 承接项目侧下沉：SerialDeviceBase（通道 = serial）
• uni_modules.dependencies 声明 pro-device-core

1.0.0（2026-10-14） 下载此版本

• 首次发布
• 提供 SerialAdapter（Android 原生串口传输原语）

平台兼容性

uni-app(5.06)

pro-device-adp-uart — 串口传输原语（UTS）

uni_modules 串口传输适配器（UTS 插件）。内置 Android 原生串口支持（mcSerialPort.aar），提供 SerialAdapter 封装层。

可独立使用，亦可作为 pro-device 框架的 ITransport 适配器。

架构定位

pro-device-adp-uart
├── js_sdk/pro-device-adp-uart/
│   ├── adapter.ts              ← SerialAdapter（ITransport）
│   ├── types.ts                ← SerialAdapterConfig（含可选 probe）
│   ├── errors.ts
│   ├── codec/hex.ts            ← 收发十六进制编解码
│   └── link/
│       └── serial-link-controller.ts  ← 断开枢纽 + SessionProbe 接入
└── utssdk/app-android/
    ├── index.uts               ← SerialPort 原生类
    └── libs/mcSerialPort.aar

与 pro-device-core/transport 的关系：

平台限制

仅支持 APP-PLUS（Android）平台。 minSdkVersion = 21（Android 5.0+）。

其他平台调用 open() 会立即抛出 SerialConnectionError。

核心 API

SerialAdapter

// App 构建：根路径是 uts-proxy（仅 SerialPort）；Adapter 需走 js_sdk
import { SerialAdapter } from '@/uni_modules/pro-device-adp-uart/js_sdk/pro-device-adp-uart'
import type { SerialAdapterConfig } from '@/uni_modules/pro-device-adp-uart/js_sdk/pro-device-adp-uart'

const adapter = new SerialAdapter()

await adapter.open({
  serialPath: '/dev/ttyS1',
  baudRate: 9600,
  // 可选：会话探活（tty 无拔插事件时用于合成断开）
  probe: {
    idleTimeoutMs: 15_000, // 无收发超时
    // intervalMs: 5_000,
    // ping: async () => { await adapter.send(statusQueryFrame) },
  },
})

adapter.onDisconnect((reason) => {
  // probe-timeout | io-error | ...
})

adapter.onReceive((buf) => { /* ... */ })
await adapter.send(frame)
await adapter.close() // 主动关闭，不会进 onDisconnect

常见串口路径

USB Host 扫码枪/CH340 等更稳妥的方式是独立的 pro-device-adp-usb（UsbManager），不要依赖本包的 tty 路径。

权限

Android 串口访问通常需要 root 或厂商预授权。商米等工业 PDA 上节点权限通常已开放。