mirror of
https://github.com/NixOS/mobile-nixos.git
synced 2024-12-18 05:21:47 +03:00
57 lines
1.5 KiB
Markdown
57 lines
1.5 KiB
Markdown
Target Disk Mode
|
|
================
|
|
|
|
What's this?
|
|
------------
|
|
|
|
This is a system that allows you to present the internal storage of a device
|
|
over the USB connection using Linux USB gadget mode.
|
|
|
|
|
|
How to use
|
|
----------
|
|
|
|
This will differ depending on the device.
|
|
|
|
The main thing to know is that you need to build a *bootable* image for your
|
|
device.
|
|
|
|
This will have different implications depending on the device.
|
|
|
|
|
|
### U-Boot based systems
|
|
|
|
(E.g. `pine64-pinephone`)
|
|
|
|
```
|
|
$ nix-build examples/target-disk-mode/ --argstr device pine64-pinephone -A build.default
|
|
$ file -L result
|
|
result: DOS/MBR boot sector; partition 1 : ID=0xee, start-CHS (0x0,0,2), end-CHS (0x3ff,255,63), startsector 1, 319555 sectors, extended partition table (last)
|
|
```
|
|
|
|
The disk image produced can be flashed to a bootable medium (e.g. an SD card).
|
|
|
|
|
|
### Android-based systems
|
|
|
|
(None)
|
|
|
|
> **NOTE**: Adding this feature for android-based systems, at the time being,
|
|
> is **dangerous**. Overwriting parts of the disk could lead to **really
|
|
> actually bricked** devices.
|
|
|
|
```
|
|
$ nix-build examples/target-disk-mode/ --argstr device ____ -A build.android-bootimg
|
|
$ file -L result
|
|
result: Android bootimg, kernel (0x10008000), ramdisk (0x11000000), page size: 2048, cmdline (...)
|
|
```
|
|
|
|
This boot image can be ran using `fastboot boot`, if the device supports it, or
|
|
flashed to the recovery or the boot partition.
|
|
|
|
* * *
|
|
|
|
While the project differs in implementation, I want to acknowledge the
|
|
inspiration taken from the [JumpDrive](https://github.com/dreemurrs-embedded/Jumpdrive)
|
|
project.
|