mobile-nixos/examples/target-disk-mode

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 outputs.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 outputs.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 project.