手机USB OTG读取iButton温度数据：MIT App Inventor扩展开发实战

1. 项目概述：当iButton温度记录仪遇上手机

在工业现场、冷链运输或者实验室里，我们常常需要一种“傻瓜式”的温度监测方案：设备要足够皮实，能扛住恶劣环境；数据要足够可靠，不能丢包；操作还得足够简单，最好能随时随地查看。Maxim Integrated（现为ADI一部分）的iButton系列，特别是DS1922L这款高精度温度记录仪，就是为这种场景而生的。它本身是一个纽扣大小的不锈钢封装设备，内置了温度传感器、实时时钟和存储器，通过1-Wire单总线协议通信，物理上极其坚固，数据记录也相当稳定。

但它的传统使用方式有个痛点：你得有一台安装了专用软件（比如Maxim的OneWireViewer）的Windows电脑，通过一个专用的USB适配器（比如DS9490R）才能对它进行配置和数据读取。这在很多移动化、现场化的场景下就很不方便。想象一下，你在冷库里检查疫苗温度，或者在户外监测设备运行环境，难道还得抱着一台笔记本电脑？

这个项目的核心，就是要打破这个限制。我们利用现在几乎人手一台的智能手机，通过一个简单的USB OTG转接头，直接让手机变成iButton的“主机”。更进一步，我们使用MIT App Inventor这款图形化开发工具，为它开发一个专属的手机App。这样一来，启动记录任务、停止任务、读取历史数据、设置采样率和精度这些核心操作，都能在手机上点点屏幕就完成。这不仅仅是把电脑上的功能搬到了手机，更是让数据采集变得前所未有的轻量和便捷。

2. 核心思路与技术选型解析

2.1 为什么是DS1922L + USB OTG + MIT App Inventor？

这个技术栈的每一个选择，背后都有明确的考量。

首先，DS1922L作为记录仪的核心，其优势在于“独立”与“坚固”。它内部集成了温度传感器、实时时钟、非易失性存储器和唯一的64位ROM ID。这意味着它不需要外部供电就能长时间记录数据（依靠内部电池），记录的数据掉电不丢失，不锈钢外壳能防水、防尘、抗冲击，非常适合户外或工业环境。它支持可编程的采样率（从1秒到273小时）和温度报警阈值，功能上完全满足大多数温度监控需求。

其次，USB OTG（On-The-Go）是连接手机和iButton的桥梁。传统的iButton读写需要专用的1-Wire主机适配器（如DS9490R），它本质上是一个USB转1-Wire的协议转换器。而我们的思路是，能否在手机上实现这个“协议转换器”的功能？答案是肯定的。通过一个USB OTG转接线，手机可以扮演USB主机的角色。我们只需要一个硬件上兼容1-Wire协议、软件上能被手机驱动的USB转串口芯片（如FTDI的FT232R），再配合一个简单的电平转换和寄生供电电路，就能在物理层实现连接。关键在于，我们需要一个App能通过手机USB口发送和接收特定的1-Wire指令。

最后，MIT App Inventor是这个项目的“灵魂”，它极大地降低了开发门槛。1-Wire协议虽然比I2C、SPI简单，但其底层时序要求严格，包含复杂的ROM命令和功能命令。如果用原生Android（Java/Kotlin）或iOS（Swift）开发，开发者需要深入理解USB Host API和1-Wire协议栈，工作量巨大。而MIT App Inventor通过其扩展（Extension）机制，允许我们用Java封装底层的USB通信和1-Wire协议解析，暴露出一系列简单的、语义化的积木块（如“连接设备”、“开始任务”、“读取数据”）。这样，应用开发者甚至不需要懂太多编程，通过拖拽这些积木块，就能快速构建出功能完整的控制App。这完美契合了项目“让iButton更普及、更易用”的初衷。

2.2 系统架构与数据流

整个系统的运作，可以理解为一次精心策划的“数据远征”。

1. 物理连接层：iButton DS1922L通过一个自制的适配器（内含USB转串口芯片和1-Wire电平转换电路）连接到手机的USB OTG接口。
2. 驱动与协议层：手机上的App通过MIT App Inventor扩展，调用封装好的库。这个库在Android端利用UsbManager和UsbDeviceConnection与USB转串口芯片通信，将高阶指令（如“开始记录”）翻译成符合1-Wire协议规范的底层字节序列，通过串口发送出去。芯片将这些字节转换成符合1-Wire时序的电平信号，驱动iButton。
3. 应用逻辑层：用户在App界面上的操作（点击“开始任务”按钮），触发MIT App Inventor的逻辑块，调用对应的扩展积木。扩展积木执行完毕后，通过回调函数将结果（如“任务启动成功”）返回给界面显示。
4. 数据存储与展示层：从iButton读取到的温度数据（通常是时间戳-温度值对），可以在App内以列表或图表形式实时展示，并支持导出为CSV或Excel文件，方便后续在电脑上分析。

这个架构的核心价值在于，将复杂的硬件协议交互封装成简单的软件接口，让开发者能聚焦于应用逻辑和用户体验。

3. MIT App Inventor扩展开发详解

3.1 扩展的核心组件与工作原理

MIT App Inventor扩展本质上是一个为特定硬件或服务定制的Java库。对于我们的iButton USB OTG扩展，它需要包含以下几个关键部分：

• UsbHelper类：负责处理所有USB通信的脏活累活。包括：
  • 设备枚举与连接：扫描已连接的USB设备，根据供应商ID（VID）和产品ID（PID）找到我们特定的USB转串口适配器。
  • 端点配置：配置USB通信的输入（IN）和输出（OUT）端点。
  • 数据收发：提供同步或异步的方法，向USB设备发送字节数组指令，并接收返回的数据。
• OneWireProtocol类：这是1-Wire协议的实现核心。它需要实现：
  • 复位与存在脉冲：每次通信前，发送复位脉冲并检测iButton的应答，这是1-Wire通信的握手信号。
  • ROM命令：如搜索ROM（0xF0）、读取ROM（0x33）、匹配ROM（0x55）等，用于在总线上识别和选定特定的iButton设备。
  • 功能命令：针对DS1922L的特定命令，这是我们扩展功能的直接体现。例如：
    • 开始任务：对应DS1922L的“Start Mission”命令。需要先发送匹配ROM命令选中设备，再发送功能命令码（如0xCC），并附带任务参数（如采样率）。
    • 停止任务：发送“Stop Mission”命令（如0xCD）。
    • 读取任务状态：发送“Read Mission Status”命令，获取设备当前状态（是否在记录、内存使用情况等）。
    • 读取任务数据：这是最复杂的一步。需要发送“Read Mission Data”命令，并分页读取设备内存中的所有温度-时间数据包，然后按照DS1922L的数据手册格式进行解析，将原始的二进制数据转换成可读的温度值和时间戳。
• Ds1922lComponent类：这是扩展对MIT App Inventor开发者的主要接口。它继承自AndroidNonvisibleComponent，并定义了一系列“方法”（Method）和“事件”（Event）。例如：
  • 方法：Connect()，StartMission(sampleRate),StopMission(),ReadMissionData()。
  • 事件：OnConnected()，OnDataReceived(dataList)，OnError(errorMessage)。 在MIT App Inventor的设计视图中，开发者拖拽的就是这个组件，在逻辑视图中使用的就是这些方法和事件积木。

3.2 关键功能实现：以“开始任务”和“读取数据”为例

“开始任务”的实现流程：

1. 参数准备：用户在App界面选择采样率（例如，每5分钟一次）。App逻辑块调用Ds1922lComponent.StartMission(300)（300秒）。
2. 协议封装：在扩展的StartMission方法内部，OneWireProtocol类会构建一个完整的命令序列：
   • [复位脉冲]->[存在脉冲]->[匹配ROM命令 0x55]->[64位设备ROM ID]->[开始任务命令 0xCC]->[采样率参数（2字节）]。
   • 这里的关键是采样率参数的转换。DS1922L的采样率寄存器是一个16位的值，代表两次采样间隔的秒数。我们需要将用户输入的300秒，转换成0x012C（高位在前）的格式。
3. 发送与验证：UsbHelper将这个字节序列通过USB发送出去。DS1922L执行命令后，通常会返回一个状态字节。扩展需要解析这个状态字节，判断任务是否成功启动，并通过OnSuccess或OnError事件通知App。

“读取数据”的实现流程（更复杂）：

1. 发起读取：App调用ReadMissionData()方法。
2. 分页读取：DS1922L的数据存储是分页的。扩展需要先发送“读取任务状态”命令，获取总数据页数。然后在一个循环中，逐页发送“读取内存”命令（0x69），并指定页地址。
3. 数据解析：每一页返回的数据是原始二进制。根据DS1922L数据手册，每个数据样本可能由2字节温度值、2字节时间戳（或相对时间偏移）组成。解析器需要：
   • 将温度字节转换成实际的摄氏度值（通常涉及补码和固定小数点计算）。
   • 将时间戳与设备的实时时钟基准结合，转换成绝对时间（年-月-日 时:分:秒）。
4. 组装与返回：将所有解析后的数据样本（时间，温度）组装成一个列表或JSON字符串。
5. 事件触发：通过OnDataReceived事件，将这个结构化的数据列表返回给App。App端再用列表显示框或图表组件将其可视化。

注意：1-Wire通信对时序非常敏感。在Java层实现时，尤其是通过USB转串口，必须仔细处理读写操作的延迟和超时。读取数据时，循环等待设备响应的超时时间设置至关重要，设得太短可能读不全，设得太长会导致App界面“假死”。建议将耗时的数据读取操作放在后台线程（AsyncTask）中执行，避免阻塞UI线程。

4. 硬件适配器制作要点

要让手机通过USB OTG与iButton对话，中间这个硬件适配器是关键。它不是一个标准的商品，需要我们自己动手或定制。

4.1 电路设计核心

一个最小系统的适配器需要以下部分：

1. USB转串口芯片：首选FTDI FT232R或CP2102。理由很充分：首先，它们在Android系统上有良好的免驱支持（通过CDC/ACM驱动）；其次，它们的IO引脚可以配置为通用的GPIO，这对于模拟1-Wire时序至关重要。FT232R的CBUS引脚就可以用来做1-Wire的强上拉控制。
2. 电平转换与寄生供电：iButton的工作电压是标准的5V或3.3V（DS1922L通常为3V）。而USB转串口芯片的IO电平可能是3.3V。因此需要一个电平转换电路（如使用一个MOSFET或三极管），确保信号电平匹配。更重要的是1-Wire的“寄生供电”模式：iButton在通信时可以从数据线上“窃取”能量为内部电路供电。这需要在数据线上通过一个MOSFET（如2N7002）连接一个强上拉电源（5V），在特定时刻（如温度转换期间）打开MOSFET，为线上所有设备提供足够电流。
3. 连接器：一端是USB-A母口（用于连接手机OTG线），另一端是适合iButton的Micro-Can插座（如DS9097兼容插座），或者引出一对线夹（“蓝夹子”）。

4.2 制作与调试避坑指南

• PCB vs 洞洞板：如果只是做一两个原型，用洞洞板焊接完全可行。如果想更稳定、更美观，画一块简单的PCB是值得的，成本也不高。
• 上拉电阻：1-Wire总线必须有一个约4.7kΩ的上拉电阻到电源（3.3V/5V）。这个电阻通常集成在主机适配器端。
• 电源滤波：在USB电源入口处，记得加上一个10-100μF的电解电容和一个0.1μF的陶瓷电容进行退耦，防止手机电源噪声干扰通信。
• 调试第一步：确认USB通信：先用一个简单的串口调试App（如“Serial USB Terminal”）测试你的适配器。插上手机，看App能否识别到FT232R或CP2102设备，并能进行基本的收发测试。这一步通了，硬件基础就牢靠了。
• 调试第二步：1-Wire信号观测：如果条件允许，用逻辑分析仪抓取一下适配器输出的信号。看看复位脉冲、存在脉冲的时序是否符合1-Wire标准（复位脉冲低电平至少480μs，存在脉冲在复位脉冲结束后60-240μs内被拉低）。这是软件驱动调试的基础。

5. App界面设计与用户体验

MIT App Inventor在界面设计上非常直观，但要想做出好用的App，仍需一些巧思。

5.1 核心界面布局

一个典型的控制App可能包含以下屏幕：

1. 主连接界面：
   • 一个“扫描/连接设备”按钮。
   • 连接状态显示（如“未连接”、“已连接：DS1922L-XXXX”）。
   • 设备基本信息显示（ROM ID， 电池电压）。
2. 任务控制界面：
   • 采样率设置：下拉选择框或数字输入框，单位可以是秒、分、小时。
   • 精度/分辨率设置：DS1922L支持不同温度分辨率（如9-12位），分辨率越高精度越高但转换时间越长。
   • 报警阈值设置：高温限和低温限输入框。
   • “开始任务”和“停止任务”大按钮，按钮状态应互斥（任务运行时，“开始”按钮禁用）。
   • 当前任务状态显示（“运行中/已停止”，已记录样本数，预计剩余容量）。
3. 数据读取与展示界面：
   • “读取数据”按钮。
   • 数据加载进度条（读取大量数据时很必要）。
   • 数据展示区：可以用ListView显示表格（时间，温度），更推荐集成图表组件（如Chart扩展）绘制温度-时间曲线图，直观看出温度变化趋势。
   • “导出数据”按钮，将数据保存为手机存储上的CSV文件，或直接分享到微信、邮箱。

5.2 提升体验的关键细节

• 异步操作与状态反馈：所有与硬件的交互（连接、开始、读取）都必须是异步的，并给出明确的反馈。例如，点击“读取数据”后，按钮应变为“读取中...”，并禁用，同时弹出进度条。数据读取完毕后，恢复按钮，隐藏进度条，刷新图表。
• 错误处理的友好性：不要只弹出“错误代码0x05”。将常见的错误情况转化为用户能懂的语言。例如，“连接失败，请检查适配器是否插好”、“设备未响应，可能电量不足”、“数据校验错误，建议重新读取”。
• 数据持久化：App每次读取的数据，除了可以导出，最好也能在App内临时保存一份历史记录。这样用户即使不小心关闭了App，下次打开还能看到上次读取的数据。可以使用TinyDB组件简单存储。
• 离线能力：考虑一种高级用法：App配置好任务并启动后，可以断开手机。iButton会独立运行记录数据。几天后，用户再次连接手机和iButton，打开App即可读取这段时间的全部数据。App的设计应支持这种“即插即读”的离线记录模式。

6. 实战中遇到的典型问题与解决方案

在实际开发和使用过程中，我踩过不少坑，这里总结几个最有代表性的：

6.1 问题一：手机无法识别USB设备

• 现象：插上OTG线和适配器后，App里扫描不到设备。
• 排查步骤：
  1. 检查OTG线：并非所有Micro-USB或Type-C线都支持OTG功能。务必使用确认支持OTG的数据线。
  2. 检查手机OTG支持与供电：部分手机需要在设置中手动开启OTG功能。另外，有些手机对USB设备的供电能力有限，如果适配器电路功耗较大，可能无法驱动。尝试给手机连接充电器，或者检查适配器电路是否有短路或漏电。
  3. 检查USB芯片驱动：虽然FTDI和CP2102在Android上免驱，但有些定制化深的国产ROM可能移除了相关驱动。可以尝试安装第三方USB驱动App，或者换一部手机测试。
  4. 检查VID/PID：在扩展代码中，用于识别设备的供应商ID和产品ID必须与你的USB转串口芯片完全一致。用PC端的设备管理器查看你的芯片的准确VID/PID。

6.2 问题二：通信不稳定，时好时坏

• 现象：有时能成功连接并操作，有时却超时或返回乱码。
• 解决方案：
  1. 加强电源：这是最常见的原因。1-Wire总线在温度转换或写操作时，需要较大的瞬时电流。确保你的寄生供电电路中的MOSFET能够提供足够电流（DS1922L温度转换时峰值电流可达1.5mA）。可以尝试将上拉电源直接接到一个外部5V电源（如果适配器有的话），或者加大滤波电容。
  2. 优化软件时序：在发送关键命令（尤其是启动温度转换Convert T命令）后，必须插入足够的延迟。DS1922L在12位分辨率下完成一次温度转换可能需要最多750ms。代码里要用Thread.sleep()或定时器确保等待时间充足。
  3. 添加重试机制：在扩展的通信底层，对每一次发送命令、读取响应的操作，都包裹一个重试循环（比如最多3次）。单次失败自动重试，能大幅提升在干扰环境下的可靠性。

6.3 问题三：读取的数据时间戳错乱

• 现象：温度值看起来正确，但时间戳全部对不上，或者顺序混乱。
• 原因与解决：
  • 时区与时钟基准：DS1922L内部存储的时间戳可能是设备本地时间，也可能是相对于任务开始时间的偏移秒数。在解析时，必须严格按照数据手册的格式说明来处理。如果是相对时间，需要结合你记录的任务开始绝对时间进行计算。
  • 数据包顺序：分页读取时，必须确保页地址是顺序递增的。检查你的读取循环逻辑，确保没有漏页或跳页。
  • 缓冲区处理：从USB串口读取数据是流式的，需要妥善处理缓冲区。可能一次read操作没有读完一页完整的数据。正确的做法是循环读取，直到凑够一页数据应有的字节数，再进行解析。

6.4 问题四：MIT App Inventor扩展打包与兼容性

• 现象：自己开发的扩展在测试手机上工作正常，但打包成APK发给别人，或者换一部手机就失效。
• 注意事项：
  • 权限声明：确保在扩展的AndroidManifest.xml文件中正确声明了USB权限（``）。
  • 依赖库：如果你的扩展引用了第三方JAR包（例如FTDI的D2XX库），需要将这些库一并打包到扩展的AIAX文件中。MIT App Inventor在打包APK时，会将这些依赖包含进去。
  • API级别：使用的USB Host API在较旧的Android版本上可能支持不完善。建议在扩展说明中注明最低Android版本要求（例如API Level 12以上）。

7. 项目总结与延伸思考

完成这个项目后，一个坚固、便携、低成本的温度监测系统就真正掌握在了手中。它的意义不在于技术多么高深，而在于巧妙地用现有工具（手机、MIT App Inventor）解决了一个具体的接入痛点，让一款优秀的专业传感器走出了实验室和工控机，融入了更灵活的移动场景。

回顾整个过程，最深的体会是“分层解耦”的重要性。硬件层（适配器）、驱动协议层（Java扩展）、应用层（MIT App积木）各司其职。一旦协议层稳定封装好，上层应用的构建就变得异常快速和多样。基于这个扩展，我可以轻松为不同的场景定制不同的App：一个给仓库管理员用的，界面简单，只显示超温报警；一个给研发人员用的，可以实时绘制高分辨率温度曲线；甚至做一个自动化的，到达某个GPS地点就自动读取附近iButton数据的巡检App。

这个项目的模式具有很强的可复制性。不仅仅是DS1922L，Maxim/Dallas半导体大量的1-Wire设备（如湿度传感器、数字开关、EEPROM）都可以通过类似的方式接入手机。更进一步，市面上许多通过串口（UART）通信的传感器模块（GPS、气压计、粉尘传感器），都可以套用“USB OTG转串口 + MIT App Inventor扩展”这个范式，快速实现手机化。它为我们打开了一扇门：让智能手机成为万物互联时代最个人化、最强大的数据采集与控制终端。