3D-printing/cc-fw-tools
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
cc-fw-tools/docs/EMMC_RESTORE.md
AGG2017 9c3333d15e Spelling fix
2024-02-18 17:15:42 -05:00

3.3 KiB
Raw Blame History

EMMC Restore Procedure

This procedure can be performed when you already have a good backup and your printer is not working properly or even cannot boot. Another use case is to fast switch to another printer setup by replacing the system partitions or the entire eMMC with the content from another setup. The procedure uses the uboot functionality to read/write the eMMC and to read/write USB disks. The restore procedure recovers the entire eMMC (or just the system partitions) from a USB disk backup.

To perform a restore follow these steps according to the current printer working state (A/ or B/):

A/ In case your printer is in good working conditions (it can somehow boot) and you are using firmware version that has uboot enabled.

  1. Turn on the printer and stop the booting process by holding key 's'
  2. Insert a USB disk (FAT32 formatted) with the file restore.scr on it for complete emmc restore. If you need to restore just the system partitions use the file srestore.scr instead.
  3. From the uboot shell enter the following:
usb reset

usb dev 0

fatload usb 0:0 42000000 restore.scr

If you see an error, try typing in usb part and see what partitions are available. Then enter:

fatload usb 0:<Enter partition number in here> 42000000 restore.scr

Example:

fatload usb 0:1 42000000 restore.scr

(Partition 1)

For a system restore replace the above script name restore.scr with the name srestore.scr.

  1. Remove the USB disk with the scripts and insert the 8GB USB disk with the complete backup (or the 1GB USB disk with the system backup). In case you don't keep the backups on a USB disk you can create them from the backup files on a Linux machine:
dd of=emmc_backup.bin of=/dev/sdh  bs=512 count=15269888 status=progress

or in case of system backup:

dd of=emmc_system_backup.bin of=/dev/sdh  bs=512 count=1135648 status=progress

Note: replace the /dev/sdh with the device name of your USB disk.

  1. Type the following to execute the script:
source 42000000
  1. Wait about 15 minutes (or about 2 minutes for a system backup) and the entire emmc (or the system part of it) will be restored 1:1 from the USB disk If you see an error and the script stopped before showing 100%, insert another type USB disk and enter again:
source 42000000
  1. Reset the printer or power off / power on and you should have a fully working machine like at the time the backup was taken.

B/ With the xfel tool in case your printer cannot boot at all or you are using a firmware version that disable the UART and you don't have access to the uboot shell.

To boot into uboot shell:

  1. Enter the printer in FEL mode and connect the uart to the computer. Open the terminal.
  2. Enter the following:
xfel ddr t113-s3

xfel write 0x43000000 uboot239.bin

xfel exec 0x43000b50

Immediately press and hold key 's' in the terminal until the boot process stop in uboot shell and go to step 3 above

You can modify the script and create new restore.scr image by:

mkimage -T script -n 'EMMC Restore' -d restore.txt restore.scr

or for the system restore:

mkimage -T script -n 'EMMC System Restore' -d srestore.txt srestore.scr