Skip to content

Commit b396565

Browse files
author
Rick Mark
committed
Added T2 and iPad data
Signed-off-by: Rick Mark <[email protected]>
1 parent 2d8d29b commit b396565

2 files changed

Lines changed: 9 additions & 4 deletions

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
11
macvdmtool
2+
*.o

README.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
# Apple Silicon to Apple Silicon VDM tool
22

3-
This tool lets you get a serial console on an Apple Silicon device and reboot it remotely, using only another Apple Silicon device running macOS and a standard Type C cable.
3+
This tool lets you send common Apple VDM messages from an Apple Sillicon Mac. It can send messages to the T2 DFU port, the Apple M1 DFU port or any USB-C based iPad. Currently it requires the sending device to be M1 based and the "DFU" port, but it should be possible to use any port and work from an Intel Mac (they have the same USB-C port controller) with some additonal patching.
4+
5+
`dfu` and `reboot` are confirmed to work on iPad and T2. Serial can probably be adapted to work with checkra1n.
46

57
## Disclaimer
68

@@ -15,17 +17,19 @@ This is based on portions of [ThunderboltPatcher](https://github.com/osy/Thunder
1517

1618
Thanks to t8012.dev and mrarm for assistance with the VDM and Ace2 host interface commands.
1719

20+
The documentation of the ACE and its USB-PD VPDs is here https://blog.t8012.dev/ace-part-1/
21+
1822
## Building
1923

2024
Install the XCode commandline tools and type `make`.
2125

2226
## Usage
2327

24-
Connect the two devices via their DFU ports. That's the rear port on MacBooks and the port nearest to the power plug on Mac Minis.
28+
Connect the two devices via their DFU ports. That's the furthest left port on M1 MacBooks, the closest left port on the T2, and the only port on the iPad. See Apple's DFU recovery support articles to identify these ports on other models.
2529

26-
You need to use a *USB 3.0 compatible* (SuperSpeed) Type C cable. USB 2.0-only cables, including most cables meant for charging, will not work, as they do not have the required pins. Thunderbolt cables work too.
30+
You need to use a *USB 3.0 compatible* (SuperSpeed) Type C cable. USB 2.0-only cables, including most cables meant for charging, will not work, as they do not have the required pins (USB CC1/CC2 where USB-PD are transmitted). Thunderbolt cables work too.
2731

28-
Run it as root (`sudo ./macvdmtool`).
32+
Run it as root (`sudo ./macvdmtool`) as root privledge is required to open the needed IOKit IOService.
2933

3034
```
3135
Usage: ./macvdmtool <command>

0 commit comments

Comments
 (0)