# usbliter8：A12/A13 SecureROM 的 USB 层漏洞

## 1. 漏洞位置

不是 iBoot，不是 SEP，是 **SecureROM 里 USB 控制器驱动的一段低级代码**。

SecureROM 是芯片里固化的一段 boot ROM（掩膜 ROM），芯片出厂后**不可修改、不可打补丁**。
它在 DFU 模式下会解析 USB 控制传输的 `SETUP` 包 —— 这段解析逻辑里存在一个可被利用的状态机缺陷，
可以拿到 SecureROM 上下文中的代码执行。

后果：

| 后果 | 含义 |
|---|---|
| 签名校验失效 | 后续的 iBSS / iBEC / ramdisk / kernelcache 不再需要 Apple 签名 |
| 版本无关 | 修不了，只能换芯片（A14 起换了新 USB 控制器） |
| tethered | SecureROM 每次上电都重新跑，所以每次开机都要重新打一遍 |

支持面：**A12、A13、S4/S5（手表）**；A12X/A12Z 理论上可，未实现。

## 2. 为什么要一块 RP2350

漏洞在 **USB 电气/时序层**，不是协议语义层。macOS / Windows 的 USB 栈：

- 有最小包间隔、重试、重传、hub 转发的固有延迟；
- 不允许应用层精确控制 SOF 帧内的位时序；
- 无法构造"半包"（截断的传输）去命中那个状态机。

所以必须用**可编程 USB 设备控制器**自己当 host：

```
RP2350（PIO 状态机模拟 USB host）
   │  D+ = GPIO12, D− = GPIO13, 接 Lightning
   ▼
iPhone 11 → DFU → 被打穿 → 序列号变成 PWND:[usbliter8]
```

RP2350 的 **PIO**（可编程 IO）能做到 1 个时钟周期级的 USB 信号控制，这是关键。
代码里 `pio_usb/src/*.pio` 就是这套 USB host 的 PIO 程序，`exploit.c` 在上面跑协议状态机。

> Waveshare RP2350 USB-A 那颗板子的 R13 电阻可选拆除，是为了让它作为 host 供电/识别更稳。

## 3. 代码结构（`firmware/`）

```
main.c            入口：识别设备、跑 exploit、点亮 LED
exploit.c   24 KB 漏洞本体：DFU 握手 → 触发 → 交付 shellcode
bus.c / bus.h     在 PIO-USB 上做 EP0 控制传输
usb.c / usb.h     USB 描述符、CRC、标准请求
pio_usb/          PIO 实现的 USB host 协议栈（host + device）
resources/
  shellcode_t8030.h   A13（t8030）用的 SecureROM 内 shellcode
  shellcode_t8020.h   A12
  shellcode_t8006.h   A12（另一变体）
  descriptors_*.h     对应 SoC 的伪造描述符
t8020_t8006_shellcode/start.S   shellcode 汇编源
```

设备识别靠 `CPID`（芯片 ID）区分 t8030 / t8020 / t8006，选对应 shellcode 与描述符。

## 4. pwn 之后：控制权移交

被打穿的设备处于 **pwned DFU**，能接受任意镜像，但怎么送？两个通道：

**A. 硬件直送**（`usbliter8-fun` 的 `boot.py`）：板子继续当 host，把 iBSS 直接推给设备。

**B. 主机接管**（Liter8 走这条）：漏洞打完，设备在 USB 上重新枚举成一个**普通 DFU 设备**，
序列号带 `PWND:[usbliter8]`，此时 Mac 可以用 libusb 直接对它发 DFU 类请求：

```
tools/usbliter8ctl boot <work>/iBSS.raw
        │
        ├── CUSTOM_BOOT (bRequest=8)：把 raw iBSS 载荷塞进去
        └── DFU_ABORT   (bRequest=4)：退出 DFU，跳到刚塞进去的 iBSS
```

`usbliter8ctl` 只有 1.7 KB，就是这两条控制传输 + 分块搬运（`TRANSFER_SIZE = 0x800`）。

Liter8 在 `scripts/device_boot.py:150` 调它：

```python
result = subprocess.run([usbliter8ctl, "boot", str(root / "iBSS.raw")])
# usbliter8ctl 在 USB 状态转换开始时就返回，不等转换完成
```

所以脚本里紧接着要等设备重新枚举，再继续发 iBEC / devicetree / ramdisk。

## 5. 逆向入口（想自己审计的话）

1. `exploit.c` 里找 `device identification` → `CPID` 分派 → 对应 `shellcode_tXXXX.h`。
2. 每个 `shellcode_*.h` 是一段位置无关的 ARM64 机器码，入口约定在 `start.S`。
3. 用 `liter8 inspect` 或 IDA 把 shellcode 反汇编，看它怎么：
   - 关掉 SecureROM 的镜像校验标志位；
   - 把 DFU 的 `CUSTOM_BOOT` 缓冲区指针改成"任意地址可执行"；
   - 返回时让 SecureROM 认为签名已通过。
4. `bus.c` 的 `bus_control_xfer()` 是理解"为什么 PC 不行"的最好入口 —— 看它对帧时序的要求。

## 6. 和其他 bootrom 漏洞的对比

| | checkm8 (A5–A11) | usbliter8 (A12/A13) |
|---|---|---|
| 层 | USB DFU 的堆溢出 | USB 控制器状态机 |
| 触发 | 软件即可（`checkra1n` 用 libusb） | **必须硬件**（RP2350） |
| 持久性 | tethered | tethered |
| 可修 | 否 | 否 |

checkm8 能在 Mac 上纯软件打，是因为它的 bug 在协议语义层；
usbliter8 在电气层，这是两者最大的工程差异。
