mirrors
/
Jumpdrive
mirror of https://github.com/dreemurrs-embedded/Jumpdrive.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Mirror of dreemurrs-embedded/jumpdrive@github.com - Pinephone boot software to expose the eMMC over USB
73 Commits 8 Branches 10 Tags 926 KiB
Makefile 67.1%
Shell 32.9%
Go to file
Anupam Basak 0b5f39d03d
Merge branch 'dreemurrs-embedded:master' into master 		2022-01-09 14:47:47 +05:30
initramfs init: Add optional sleep before creating device nodes 2021-02-04 02:57:45 +01:00
splash Add Pocket P.C. support 2021-12-19 22:09:21 +01:00
src Add Pocket P.C. support 2021-12-19 22:09:21 +01:00
.gitignore Add Pocket P.C. support 2021-12-19 22:09:21 +01:00
LICENSE Added GPLv2 License 2020-03-17 04:13:48 +07:00
Makefile Add Pocket P.C. support 2021-12-19 22:09:21 +01:00
README.md Update dependency list and install commands 2021-07-02 13:07:56 +05:30

README.md

Jumpdrive

A swiss army knife for mobile devices, currently supporting:

  • Pine64 PineTab
  • Pine64 PinePhone
  • Purism Librem 5
  • Xiaomi Pocophone F1
  • OnePlus 6
  • OnePlus 6T

You can use this to flash a image directly to eMMC, troubleshooting a broken system, and a lot more.

Table of Contents

Installation

Download the latest image for your device here

PinePhone / PineTab

Then use dd to flash the image to an SD card. Jumpdrive is pretty small, so there is no need for a large storage SD card.

Insert the SD card to the device, then boot it up, you should get a nice splash screen and you should see a new storage device after you plug the device to USB.

With the device plugged in, you can now flash a distro, or fix a unbootable installation.

WARNING: In case eMMC isn't showing up try to charge your battery and try again. There are reports of people not being able to flash to eMMC with discharged battery.

Librem 5

Extract the downloaded JumpDrive release archive for the Librem 5, put the device into flash mode, then run the boot-purism-librem5.sh script from the release.

Xiaomi Pocophone F1 / OnePlus 6 / OnePlus 6T

Boot the image using fastboot boot.

Building

The dependencies are:

  • aarch64-linux-gnu- toolchain
  • u-boot tools
  • mtools
  • bison
  • flex
  • cpio
  • make
  • wget
  • swig
  • bc
  • python3
  • python3 distutils
  • parted
  • mkfs.fat
  • udev

To install the build dependencies in Arch :

sudo pacman -S aarch64-linux-gnu-gcc uboot-tools mtools cpio bison flex make wget swig bc python python-distlib parted dosfstools

To install the build dependencies in Ubuntu/Debian :

sudo apt install gcc-aarch64-linux-gnu u-boot-tools mtools cpio bison flex make wget swig bc python3 python3-distutils parted dosfstools udev

Additional dependencies for the Purism Librem 5:

  • arm-none-eabi- toolchain
  • uuu

Additional dependencies for the Xiaomi Pocophone F1 / OnePlus 6 / OnePlus 6T:

  • mkbootimg
$ git submodule update --init --recursive
Downloads the projects to build

$ make -j8 pine64-pinephone.img.xz
Builds everything needed for the pinephone image...

$ make -j8 initramfs-pine64-pinephone.gz
Generate only the initramfs for the pinephone

$ make -j8 all
Generates an image for every supported platform in parallel

This project is built on: