{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"7e1d7a21-d861-45be-bb4a-2f00e817dd33"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"2f9aa3b5-9a4f-4b64-af59-f6a81a380a7b"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"This page contains the instructions to flash the eMMC on a ","type":"text"},{"text":"SBC-3.5-RK3568 (E09)","type":"text","marks":[{"type":"link","attrs":{"href":"https://secogroup.atlassian.net/wiki/spaces/SECOTech/pages/1804402689"}}]},{"text":" SECO board and to create a bootable eMMC/uSD.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Flashing the entire image via OTG","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Hardware","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MicroUSB cable (OTG).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Linux Host PC.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Software","type":"text"}]},{"type":"paragraph","content":[{"text":"Download the needed software here:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rockchip rkdeveloptool","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://secostorage.blob.core.windows.net/secosoftware-public/rockchip/e09/tools/rkdeveloptool"}}]},{"text":" - this guide uses the official open source Rockchip ","type":"text"},{"text":"rkdeveloptool","type":"text","marks":[{"type":"code"}]},{"text":"package but any other Rockchip flashing utilities could be used. You can find more info about ","type":"text"},{"text":"rkdeveloptool","type":"text","marks":[{"type":"code"}]},{"text":" in the ","type":"text"},{"text":"official github page","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/rockchip-linux/rkdeveloptool"}}]},{"text":", and more info about ","type":"text"},{"text":"Rockchip flashing tools","type":"text","marks":[{"type":"link","attrs":{"href":"http://opensource.rock-chips.com/wiki_Tools"}}]},{"text":" in the vendor wiki.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rockchip RK3568 loader","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://secostorage.blob.core.windows.net/secosoftware-public/rockchip/e09/tools/loader.bin"}}]},{"text":" - official Rockchip loader for RK3568.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"OS image file","type":"text","marks":[{"type":"strong"}]},{"text":" (","type":"text"},{"text":".wic","type":"text","marks":[{"type":"code"}]},{"text":") provided in the ","type":"text"},{"text":"SBC-3.5-RK3568 (E09)","type":"text","marks":[{"type":"link","attrs":{"href":"https://secogroup.atlassian.net/wiki/spaces/SECOTech/pages/1804402689"}}]},{"text":" product page.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Instructions","type":"text"}]},{"type":"paragraph","content":[{"text":"These are the instructions to be followed in case the device that needs to be flashed does not either have a bootloader:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure there is no microSD card inserted in the slot ","type":"text"},{"text":"J17","type":"text","marks":[{"type":"code"}]},{"text":" of the SBC-3.5-RK3568.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect your Linux Host PC to the microUSB connector ","type":"text"},{"text":"J48","type":"text","marks":[{"type":"code"}]},{"text":" of the SBC-3.5-RK3568.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Turn on the switch ","type":"text"},{"text":"SW1","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Power on the SBC-3.5-RK3568 board.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Turn the switch ","type":"text"},{"text":"SW1","type":"text","marks":[{"type":"code"}]},{"text":" back off.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the command ","type":"text"},{"text":"rkdeveloptool ld","type":"text","marks":[{"type":"code"}]},{"text":" to make sure the Rockchip board is detected.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Flash the loader on the SBC-3.5-RK3568 device via the following command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ sudo rkdeveloptool db loader.bin","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Flash the ","type":"text"},{"text":".wic","type":"text","marks":[{"type":"code"}]},{"text":" image in the board via the following command. Remember to substitute the ","type":"text"},{"text":".wic","type":"text","marks":[{"type":"code"}]},{"text":" with the file name of the image (e.g ","type":"text"},{"text":"seco_rk3568_e09_edgehog-embedded-full-image-wayland_5-10-x_kirkstone_1-03-00_20240410.wic","type":"text","marks":[{"type":"code"}]},{"text":"):","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ sudo rkdeveloptool wl 0 .wic","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wait for it to finish, then disconnect the microUSB cable and reboot the board. The SBC-3.5-RK3568 board will now run the new image.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Manually flashing partitions","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Formatting the device","type":"text"}]},{"type":"paragraph","content":[{"text":"A bootable device where to flash BSP binaries needs a specific partitioned storage.","type":"text"}]},{"type":"paragraph","content":[{"text":"The device must have at least three partitions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the first partition contains the U-boot image;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the second formatted as ","type":"text"},{"text":"FAT32","type":"text","marks":[{"type":"em"}]},{"text":" and with size at least 100MB;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the third formatted as ","type":"text"},{"text":"EXT4","type":"text","marks":[{"type":"em"}]},{"text":" and big enough to decompress the filesystem as explained later.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"In following instructions the device will be commonly declared as","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"/dev/","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"In case of a µSD it is usually named ","type":"text"},{"text":"/dev/sdx","type":"text","marks":[{"type":"code"}]},{"text":", while in case of eMMC ","type":"text"},{"text":"/dev/mmcblk*","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The partitions associated to the device are usually named ","type":"text"},{"text":"/dev/1","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"/dev/2","type":"text","marks":[{"type":"code"}]},{"text":", etc..","type":"text"}]},{"type":"paragraph","content":[{"text":"Before performing any partitioning operation, it is always necessary to umount them.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Every command listed in this page is executed as superuser","type":"text"}]}]},{"type":"paragraph","content":[{"text":"You can use many different tools to create the partitions, such as ","type":"text"},{"text":"gparted","type":"text","marks":[{"type":"code"}]},{"text":", which has a graphical interface, or ","type":"text"},{"text":"sfdisk","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"fdisk","type":"text","marks":[{"type":"code"}]},{"text":" on the command line.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you want to use the command line ","type":"text"},{"text":"sfdisk","type":"text","marks":[{"type":"code"}]},{"text":" tool instead, you need to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"first create a text file called ","type":"text"},{"text":"devicepart.sfdisk, ","type":"text","marks":[{"type":"em"}]},{"text":"copying the following content inside it","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"label:gpt\nstart=16384, type=3DE21764-95BD-54BD-A5C3-4ABE786F38A8, name=\"uboot\", size=8192\nstart=57344, type=EBD0A0A2-B9E5-4433-87C0-68B6B72699C7, name=\"bootfs\", size=200M\nstart=466944, type=0FC63DAF-8483-4772-8E79-3D69D8477DE4, name=\"rootfs\"","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create the boot device with the commands","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"sfdisk /dev/ < devicepart.sfdisk\n\n# format the second partition as FAT32\nmkfs.vfat /dev/2\n# format the third partition as EXT4\nmkfs.ext4 /dev/3","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Flash the BSP inside the bootable device","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to flash BSP Linux distribution inside the formatted bootable device, the following binaries are required:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"U-Boot image","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dtb file","type":"text","marks":[{"type":"em"}]},{"text":" (device tree blob) file and ","type":"text"},{"text":"dtbo","type":"text","marks":[{"type":"em"}]},{"text":" (device tree overlay) files","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Kernel image","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"filesystem","type":"text","marks":[{"type":"em"}]},{"text":", Linux Filesystem (Yocto Filesystem)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In the following sections you will be guided in flashing your bootable device using the pre-compiled binaries that you can find in the board page.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Flash u-boot","type":"text"}]},{"type":"paragraph","content":[{"text":"To flash the U-Boot image, you need:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idblock.img","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"uboot.img","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"These binary images are created by u-boot compilation or you can download the precompiled binaries from ","type":"text"},{"text":"seco_rk3568_e09_uboot-edgehog-embedded-full-image-wayland_5-10_kirkstone_1-04-00_20240621.tar.gz","type":"text","marks":[{"type":"link","attrs":{"href":"https://secostorage.blob.core.windows.net/secosoftware-public/rockchip/e09/kirkstone_1-04-00/seco_rk3568_e09_uboot-edgehog-embedded-full-image-wayland_5-10_kirkstone_1-04-00_20240621.tar.gz"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"These binaries can be flashed with:","type":"text"}]},{"type":"codeBlock","content":[{"text":"dd if=./idblock.img of=/dev/ seek=64 conv=fsync\ndd if=./uboot.img of=/dev/ seek=16384 conv=fsync","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Be careful to flash the u-boot in the device root itself and not in one of the partition, e.g. :","type":"text"}]},{"type":"paragraph","content":[{"text":"/dev/sda","type":"text","marks":[{"type":"code"}]},{"text":" -> OK","type":"text"}]},{"type":"paragraph","content":[{"text":"/dev/sda1","type":"text","marks":[{"type":"code"}]},{"text":" -> NOT OK","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"U-boot is now flashed","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Flash kernel and filesystem","type":"text"}]},{"type":"paragraph","content":[{"text":"Choose the right binaries from the board page. You need to download a kernel and a filesystem tarball.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the command below we suppose two device partitions, mounted respectively as ","type":"text"},{"text":"/media/2","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"/media/3","type":"text","marks":[{"type":"code"}]},{"text":". If your situation is different, please change the path accordingly.","type":"text"}]},{"type":"paragraph","content":[{"text":"First, extract the ","type":"text"},{"text":"filesystem ","type":"text","marks":[{"type":"em"}]},{"text":"inside the second partition, with the command:","type":"text"}]},{"type":"paragraph","content":[{"text":"tar xpf .tar -C /media/3","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Extract the kernel tarball provided: inside it there are 2 folders, named ","type":"text"},{"text":"boot","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"lib. ","type":"text","marks":[{"type":"em"}]},{"text":"You need to copy all the content of the ","type":"text"},{"text":"boot","type":"text","marks":[{"type":"em"}]},{"text":" folder inside the root of the first partition of the device, e.g.: ","type":"text"},{"type":"hardBreak"},{"text":"cp boot/* /media/2","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Copy the content of the ","type":"text"},{"text":"lib/modules","type":"text","marks":[{"type":"em"}]},{"text":" folder of the tarball inside the ","type":"text"},{"text":"lib/modules","type":"text","marks":[{"type":"em"}]},{"text":" folder inside the second partition, e.g.:","type":"text"}]},{"type":"paragraph","content":[{"text":"mkdir /media/3/lib/modules ","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"cp -r lib/modules/* /media/3/lib/modules","type":"text","marks":[{"type":"code"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"If you compiled the kernel yourself, copy the ","type":"text"},{"text":"Image ","type":"text","marks":[{"type":"em"}]},{"text":"file inside the second partition alongside all the ","type":"text"},{"text":"dtb","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"dtbo","type":"text","marks":[{"type":"em"}]},{"text":" files.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Now unmount the device and you are ready to go.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"A full bootable disk has now be created.","type":"text"}]}]},{"type":"paragraph"}],"version":1}