TSoM eMMC Programming Guide revB
From Terasic Wiki
This guide will show you how to program the Linux image into the eMMC device on the TSoM module and explain how to update device tree and zImage in the eMMC device.
1.1 Re-flash linux image to emmc memory
- Prepare a SD card reader and a Micro SD card (minimum 4GB capacity,for Linux boot).
- Download the image file form the link below and use the tool such as "Win32 Disk Imager" to write the linux image file(tsom_linux_console.zip) into the Mircro SD card.
- Download the eMMC image file from the link below and extract it, then copy the image file(tsom_emmc_168M.img) to the fat partition of sdcard
- Insert the Micro SD card into the TSoM evaluation kit.
- Make sure SW2 is set to FPPx32 mode(MSEL[4:0]="01010"), so the FPGA can be configured by HPS. The factory default mode is the FPPx32 mode.
- Make sure that SW1 on the TSoM is switch to the "ON" position, which represents the HPS boot from the SD Card.
- Connect the PC and TSoM evaluation kit via mini USB cable and connect the Power adapter to power on the board.
- Use the terminal emulation program such as Putty on the operating system to connect to Linux running on TSoM
- .
- Press the CPU KEY1(WARM_RST) button on the TSoM module and wait for the "Hit any key to stop autoboot :5" to appear in the Putty window. Press any key to enter uboot.
- Enter the command "fatls mmc 0:1" to view the contents of the sdcard fat partition.
- Enter the command "fatload mmc 0:1 $loadaddr tsom_emmc_168M.img" to load the .img file into the DDR3.
- Switch SW1 to "OFF" position to switch to eMMC boot mode.
- Enter the command "mmc rescan" to rescan the eMMC device.
- Enter the command "mmc write $loadaddr 0 0x510e0" to program image file to the eMMC device.
- Note: The number "0x510e0" represents the image size, the unit is "block", each block has 512 bytes size. The size of the image file here is 169984000 bytes , i.e. 169984000/ 512=332000 (block) . 332000 converted to hexadecimal is 0x510e0.
- Press the COLD_RST button of the TSoM evaluation kit to reboot the board into linux. When the "login in" message appears that shows the programming eMMC success.
1.2 Update Device Tree and zImage in the eMMC
- Before you update files to the eMMC, you should make sure the Tsom board can boot from eMMC correctly.
- Copy your new device tree file(.dtb) and zImage files to USB flash drive.
- Insert the USB flash drive to TSoM Board with USB OTG cable, then boot linux from eMMC
- After the linux is boot, enter "root" to login the system, then, mount the USB flash drive and eMMC memory's partition one to linux. Commands: "mount /dev/sda1 /mnt/card" and "mount /dev/mmcblk0p1 /mnt/ram/".
- (sda is USB flash drive, mmcblk0p1 is emmc memory's partition one; ignore the information when you do mount)
- Copy your new files from the USB flash drive to the eMMC memory with commands "cp /mnt/card/zImage /mnt/ram/zImage -rf" and "cp /mnt/card/soc_system.dtb /mnt/ram/soc_system.dtb -rf".
- Umount USB flash drive(command:"umount /mnt/ram" ) and eMMC memory's partition one(command:"umount/mnt/car").
- Press the COLD_RST button to reboot TSoM board, then it will boot linux with your new updated files.
