Remarkable tablet system tools

Please be aware that you can potentially break your remarkable tablet. Even if unlikely even bricking it behind repair. Nobody is responsible for the actions you are taking with this scripts.

The uuu (Universial Update Utility) tool was created by NXP and made avilable under the BSD license. Please check here for details: https://github.com/NXPmicro/mfgtools

This is a community effort. Please do not contact the rM-team. They are helpful but cannot provide support for third-party acitvities.

Preperation

Clone this repository

git clone https://github.com/ddvk/remarkable-uuuflash.git 
cd remarkable-uuuflash

Set the rM into recovery mode

Attach the rM tablet via USB to the host machine
Power-off the rM tablet
Set it into upload mode, by pressing the middle (home) button and then the power button for > 3 seconds. The display will not change, there will be no feedback!
To control if the mode was set type:

dmesg

One of the last messages should be something (usb address might be different) like:

 hid-generic 0003:15A2:0063.0008: hiddev1,hidraw3: USB HID v1.10 Device [Freescale SemiConductor Inc  SE Blank MEGREZ] on usb-0000:00:1a.0-1.3/input0

Now you are ready to start the following actions from within this repository

Actions

Depending on your system you might have to run the uuu tool with sudo rights, or as a better alternative create some udev rules.

Boot into a recovery serial console

To boot into recovery use:

./uuu recover.uuu

After the loading of the recovery image you should be able to login via a serial client

Linux

minicom -D /dev/ttyACM0

screen /dev/ttyACM0

Please notice, that the name of the device might be different depending on your system. If this does not work, check with dmesg the current status, there should be a line like:

cdc_acm 1-1.3:1.2: ttyACM0: USB ACM device

Note that the name of the serial device might differ from distro to distro. Try again, with the correct name, if no device is shown under dmesg. Something might have gone wrong. In that case please report your problems. Please be aware that the access to the serial device might require root rights, depending on your system.

Windows (not yet fully tested, may need additional drivers)

You can use putty to establish a serial connection to the COM device it's listed as (Example: COM3). Check the Device Manager for unknown usb devices and/or Event Viewer

If your device is recognized as a "CDC Composite Gadget" after running uuu.exe recover.uuu, use the following steps to allow Windows to communicate with it over serial:

Open device manager.
Right click "CDC Composite Gadget"
Click "Properties"
Go to the "Driver" tab
Click "Update Driver"
"Browse my computer for driver software"
"Let me pick from a list..."
Select "Ports (COM & LPT)"
Select "Microsoft" from the Manufacturer list
Select "USB Serial Device" from the Model list
Click "Next" and allow the driver to install

macOS

Option 1: install uuu via homebrew

For ARM and Intel based Macs you can install the necessary uuu utility via Homebrew

brew install uuu

Option 2: Use uuu-mac provided in this repo

Included in this repo is the "uuu-mac" compiled for x86. Intel-based Macs can run this utility directly but you also need libzip and libusb.

ARM Macs can (theoretically) run this version of the utility under Rosetta. However it is dependent on libzip and libusb and attempts to look for them in x86-specific directories. If you attempt to run it and see an error such as below you will need to use Option 1 or find and install those libraries manually

$ ./uuu-mac
dyld[79392]: Library not loaded: /usr/local/opt/libusb/lib/libusb-1.0.0.dylib
...

On Intel Macs you can install zlib and libusb via Homebrew:

brew install libzip
brew install libusb

then start:

./uuu-mac ./recover.uuu
screen /dev/tty.usbmodem1A1103

A login prompt will appear:

Frankenboot rmrestore /dev/ttyGS0

rmrestore login:

To login use root as user.

Mount flash memory

The entire visible system is the initramfs within the rM RAM. Thus, the flash memory partitions of the real system have to be mounted, if you want to access it.

Mount the internal flash memory partitions

mount /dev/mmcblk1p2 /mnt/ # This may need to be mmcblk1p3 if you are using the other root partition
mount /dev/mmcblk1p7 /mnt/home
mount /dev/mmcblk1p1 /mnt/var/lib/uboot
mount -t proc /proc /mnt/proc
mount --rbind /sys /mnt/sys
mount --rbind /dev /mnt/dev
mount --rbind /run /mnt/run

For convince, one can chroot into the real system.

chroot /mnt

If you use toltec you will need to run the following to get access to anything that toltec has installed

mount -o bind /home/root/.entware /opt
source /home/root/.bashrc
# You may wish to mount any other bind mounts that toltec has setup

You can now change settings or reset passwords, etc.
If you need SSH access you can run the following:

/usr/sbin/udhcpd /etc/udhcpd.usb0.conf
ip addr add 10.11.99.1 dev usb0
/usr/sbin/dropbear -r /etc/dropbear/dropbear_ed25519_host_key -B

After you have finished, type

exit #if you used the chroot
reboot

to restart the rM tablet and boot into the normal operation mode.

Semi Upgrade (overwriting the root with version 2.1.1.3)

Use

./uuu upgrade.uuu

This will overwrite both root partitions with the version 2.1.1.3, use if you really cannot fix it yourself.

Reflash (if nothing else helps)

** This will delete all your files, use as last resort **

Use

./uuu reflash.uuu

This will rewrite the bootloader, repartition the device aka (mfgtools), thus deleting home and everyting.

Sources

remarkable / imx_usb_tool (initramfs) [https://github.com/reMarkable/imx_usb_loader]
uuu [https://github.com/NXPmicro/mfgtools]
uboot (modified to ignore env variables) [to be pushed]
zImages-fsl [SCR-4.14.98_2.0.0_ga.txt]

ddvk / remarkable-uuuflash