2020-04-24 11:49:17 +00:00
# Jumpdrive
2020-03-13 08:38:01 +00:00
2021-02-24 06:21:49 +00:00
A swiss army knife for mobile devices, currently supporting:
- Pine64 PineTab
- Pine64 PinePhone
- Purism Librem 5
2021-05-19 14:45:03 +00:00
- Xiaomi Pocophone F1
- OnePlus 6
- OnePlus 6T
2020-03-13 08:38:01 +00:00
You can use this to flash a image **directly to eMMC** , troubleshooting a broken system, and a lot more.
2020-04-24 11:49:17 +00:00
### Table of Contents
- [Installation ](#installation )
- [Building ](#building )
- [List of projects being used in Jumpdrive ](#this-project-is-built-on )
### Installation
Download the latest image for your device [here ](https://github.com/dreemurrs-embedded/Jumpdrive/releases )
2021-02-24 06:21:49 +00:00
#### PinePhone / PineTab
2020-04-24 11:49:17 +00:00
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.
2020-03-16 14:55:58 +00:00
2020-04-24 11:49:17 +00:00
With the device plugged in, you can now flash a distro, or fix a unbootable installation.
2021-01-18 15:43:44 +00:00
**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.
2021-02-24 06:21:49 +00:00
#### 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.
2021-05-19 14:45:03 +00:00
### Xiaomi Pocophone F1 / OnePlus 6 / OnePlus 6T
Boot the image using `fastboot boot` .
2020-04-24 11:49:17 +00:00
### Building
2020-03-16 14:55:58 +00:00
The dependencies are:
- aarch64-linux-gnu- toolchain
- u-boot tools
- mtools
2020-03-17 18:22:52 +00:00
2021-02-03 03:44:56 +00:00
Additional dependencies for the Purism Librem 5:
- arm-none-eabi- toolchain
- uuu
2021-05-19 14:45:03 +00:00
Additional dependencies for the Xiaomi Pocophone F1 / OnePlus 6 / OnePlus 6T:
- mkbootimg
2020-03-17 18:22:52 +00:00
```shell-session
2020-04-10 17:45:35 +00:00
$ git submodule update --init --recursive
Downloads the projects to build
2020-03-17 18:22:52 +00:00
$ 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
```
2020-04-24 11:49:17 +00:00
### This project is built on:
- [Busybox ](https://busybox.net ) - which is [GPLv2 ](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html ).
- [postmarketOS ](https://postmarketos.org ) scripts - which is [GPLv2 ](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html ).
- [Pine64's kernel fork ](https://gitlab.com/pine64-org/linux ) - which is [GPLv2 ](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html ).
- [U-Boot ](https://github.com/u-boot/u-boot ) - which has [multiple licenses ](https://github.com/u-boot/u-boot/tree/master/Licenses )
