FDD-book逆向工程:没有文档时如何逆向出设备驱动
FDD-book逆向工程:没有文档时如何逆向出设备驱动
本文带你走一遍 FDD-book(FreeBSD Device Driver Book)第 36 章「无文档逆向工程」的完整流程:当一块硬件丢掉了数据手册(datasheet)、厂商只给闭源驱动时,如何用观察、实验和验证,把它逆向出一个可用的 FreeBSD 设备驱动。核心是一套可复现的六步方法——识别 → 捕获 → 对比 → 假设 → 实验 → 文档,配合 6 个安全实验和一份「伪数据手册」模板,全程不需要任何昂贵硬件。
为什么需要逆向工程?没有数据手册也能写驱动
逆向工程不是黑客行为,而是一门有纪律的工程实践。书中归纳了三种最常见的"无文档"场景:
| 场景 | 典型情况 | 难度来源 |
|---|---|---|
| 遗留硬件 | 厂商倒闭、纸质手册丢失、配套 CD 找不到了 | 文档真的消失了 |
| 闭源驱动 | 厂商只发布 Windows/Linux 二进制驱动,拒绝公开接口 | 法律与取证边界更复杂 |
| 定制嵌入式设备 | 只有一张机械图纸、README 和固件二进制 | 没有社区、没有前人代码可参考 |
三者的共同点:设备能工作,但描述它编程接口的资料缺失。好消息是,FreeBSD 源码树里有大量现成的逆向成果——在 /usr/src/sys/dev/ 下能搜到不少注释里写着 "no datasheet"、"based on observation" 的驱动,它们本身就是这本书方法的活教材。
🔍 逆向工程更像实验科学,而不是"敲键盘碰运气":提出假设、做实验、记录结果、修正模型,重复几百次,直到能写出一个真正工作的驱动。
搭建实验室:一台可以随便弄坏的 FreeBSD 虚拟机
逆向会话本质上是一次次受控实验,所以第一步是搭一个可以随便破坏的环境。书中给出的最低配置非常朴素:
- 一台 FreeBSD 14.3 开发机(虚拟机即可),至少 16 GB 内存
- 一个可运行厂商驱动的虚拟机(通过 USB/PCI 直通把设备交给它)
- 一个 Git 仓库,存放实验笔记、pcap 抓包和伪数据手册
- 一个常驻终端运行
tail -F /var/log/messages,随时观察实验驱动的日志
内核崩溃在这个环境里的代价只是一次重启,这正是逆向工程需要的安全感。
系统装好后,登录到你的实验环境:
📓 实验笔记不是可选项。每一次观察都要记录:时间、系统配置、执行的确切命令、捕获的数据、以及"这是观察还是假设"的明确标注。六个月后你会发现,当初随手记下的那句"我认为这个位是就绪标志",可能正是整个项目的转折点。
观察四件套:pciconf、usbconfig、usbdump、dtrace
FreeBSD 基础系统自带了逆向工程所需的绝大多数工具,不需要额外购买任何东西:
| 工具 | 用途 | 典型命令 |
|---|---|---|
pciconf(8) |
枚举 PCI 设备、读配置空间 | sudo pciconf -lvc |
usbconfig(8) |
枚举 USB 设备、导出描述符 | sudo usbconfig -d ugen0.5 dump_device_desc |
usbdump(8) |
捕获 USB 总线上的全部数据包 | sudo usbdump -i usbus0 -w init.pcap |
dtrace(1) |
跟踪内核与驱动的交互点 | 探针 bus_space 操作 |
devinfo(8) / devctl(8) |
查看设备树 / 动态挂载卸载驱动 | devinfo -rv |
xxd(1) / sdiff(1) |
十六进制查看与逐字节对比 | 对比两次抓包输出 |
这些都是 root 权限命令,先切换到管理员身份:
su -
第一步永远是"静态识别"
对 PCI 设备,pciconf -lv 一行输出就记录了 6 个关键事实:总线位置、类别码、子系统 ID、芯片 ID、修订号、头类型。对 USB 设备,三条 usbconfig 命令(设备描述符 + 当前配置 + 全部配置)就给出了完整的"编程可见身份"——端点类型(control / bulk / interrupt / isochronous)、方向、最大包大小。
仅凭这些静态信息就能做出有效推断:
- 一对 bulk-IN + bulk-OUT 端点 → 大概率承载私有应用层协议
- 两个 interrupt-IN 端点 → 事件源类设备
- 带 isochronous 端点 → 几乎可以确定是音视频等实时数据
配套脚本可以直接照着做:lab01-identify/identify.sh、lab02-capture/capture.sh。
核心技巧:用 diff 隔离出"一位的含义"
整章最重要的分析技巧只有一个字:对比(diff)。
假设你分别捕获了"设置通道 1"和"设置通道 6"的两次操作。两段抓包会 99% 相同,而中间那几个不同的字节,几乎必然与通道号有关。对比它们,就能推断出:
- 哪个传输携带通道值
- 值在传输中的哪个字节位置
- 数值编码方式(直接值 / 表索引 / 位域)
- 小端还是大端
纪律要求:两次捕获只允许变化一个变量。比较"通道 1 + 模式 A"和"通道 6 + 模式 B"会引入两个变量,分析难度立刻翻倍。书中推荐的命名方案是 init-001-attach-cold.pcap、op-002-send-icmp-echo-request.pcap 这类"前缀 + 编号 + 英文描述",旁边再放一份同名 .txt 侧边笔记,记录用户操作和预期行为。
值得记住的 7 种"设备行为模式"
几乎所有设备的协议里都会反复出现这些形状,学会一眼识别能省掉大量时间:
- 连续写 + 单次读:经典的"写命令、读结果"
- 状态位随事件翻转:设备报告进度的最常见方式
- 地址递增的连续写(4 字节对齐):先清零寄存器块、再配置、最后写 "go" 寄存器触发
- 同一地址反复读到值变化为止:轮询(polling),被轮询的地址就是状态寄存器
- 等长的 bulk-OUT 后跟 bulk-IN:命令-应答通道
- 周期固定的 interrupt-IN 包:心跳 / 周期性状态上报
- 超长写序列且无可见响应:固件下载
最小驱动 + 模拟验证:一次只实现一个已验证的功能
在真机上冒险之前,FDD-book 的配套代码提供了一条零风险练习线(全部位于 examples/part-07/ch36-reverse-engineering/,可在虚拟机内独立构建运行):
| 实验 | 内容 | 学会的技能 |
|---|---|---|
| Lab 3 | regprobe.c:只读寄存器探测内核模块 | 通过"哪些字在变、哪些字稳定"画出寄存器地图 |
| Lab 4 | mockdev.c:纯软件模拟的"命令+状态"设备 | 用 mock 设备验证驱动逻辑,坏设备也只是虚拟机里的一次 panic |
| Lab 5 | safeprobe.c:安全探测包装库 | 超时保护、写后读回校验、失败自动恢复 |
| Lab 6 | DATASHEET-TEMPLATE.md:伪数据手册模板 | 把发现沉淀成结构化文档 |
工作方式是:先写最小驱动(通常从"复位"这一个功能开始),在 mock 设备上把假设跑通,确认行为后才允许它在真机上写一次寄存器。扩展功能时,每新增一个特性都要先对照安全标准评审。
⚠️ 安全红线:三类可能把设备变砖的操作
这是全章反复强调、也最容易被新手低估的部分:
没有充分证据证明安全,就不要向未知寄存器写值或发送未知命令。
尤其要避开:
- Flash/EEPROM 写入——可能擦除固件、校准数据或设备身份,且几乎不可逆
- 影响非易失状态的硬复位——"工厂复位"和"软复位"可能只差一个位模式
- 修改设备标识寄存器——ID 一旦被覆盖,没有任何驱动能再认出它,恢复可能需要硬件编程器
"安全"的判定标准有四条:厂商驱动做过同样的操作、属于标准协议操作、操作可逆、已在模拟环境中验证过。四条都不满足,就不做。
最终交付物:伪数据手册(pseudo-datasheet)
逆向工程的"成品"不只是驱动,还有一份伪数据手册——对设备的结构化记录,且每一条事实都标注来源可信度(HIGH 直接观察到 / MEDIUM 强证据推断 / LOW 假设未证实 / UNKNOWN)。模板见 DATASHEET-TEMPLATE.md,包含身份、来源方法、资源、寄存器映射、缓冲区布局、命令接口、初始化序列、怪癖(quirks)和开放问题等章节。
书中两个真实案例证明了这套纪律的价值:
umcs驱动(USB 转串口桥片):公开数据手册与厂商驱动矛盾,作者在代码注释里完整记录了"实验证明手册不可靠"的推理过程,十五年后的维护者依然能读懂axe驱动(ASIX 网卡):芯片手册对两个关键初始化步骤只字未提——不设置某个位就收不到任何包,不初始化三个 IPG 寄存器就发不出任何包。这些"手册的沉默"全靠观察补全
共同经验有三条:注释就是审计轨迹、观察优先于文档(数据手册描述的是"预期行为",芯片的实际行为才需要驱动去匹配)、许可证纪律(读 GPL 代码理解接口可以,代码必须自己从零写,即"净室"做法)。
新手上路清单:从零开始的第一步
✅ 把 chapter-36.md 第 1~3 节(动机、法律边界、实验室)一次读完
✅ 在虚拟机里完成 identify.sh:对你手边任意一块 USB 设备做静态识别
✅ 用 usbdump 捕获一次 U 盘插拔的初始化序列,对照 usbconfig 输出验证
✅ 跑通 Lab 4 的 mock 设备,体验"验证假设"的完整闭环
逆向工程奖励耐心,很少奖励速度。但只要你坚持"观察与假设分离、写前必记笔记、无证据不写寄存器"这三条纪律,一块没有文档的硬件终将成为一份别人也能复用的伪数据手册——而这正是 FreeBSD 驱动树里那些"无名英雄"代码的由来。


