~~PAGEIMAGE:arch:risc-v:sipeed:how_to:boot_lichee_rv_dock:media:20231026-223812.png~~

====== Boot Lichee RV Dock ======

{{template>meta:template:pageinfo#tpl |desc=Introduce how to boot Lichee RV Dock.}}

===== Make Image With Buildroot =====

  * Download source code from **[[https://github.com/buildroot/buildroot|buildroot]]** .
  * Go to the buildroot root directory and run the following commands:
      * <wrap cmd>make sipeed_lichee_rv_dock_defconfig</wrap>
      * <wrap cmd>make all</wrap>  - If the command is executed successfully, an image named <wrap file>sdcard.img</wrap>  will be generated in the <wrap path>./buildroot/output/images</wrap> directory.  <callout type="warning">

  * buildroot will download many packages from different repositories after running <wrap cmd>make all</wrap>, and you may need a **VPN**  to speed up the process.
  * If you're having trouble with the build process, maybe you can get more details from [[https://github.com/buildroot/buildroot/blob/master/README|buildroot README]].

</callout>

===== Flash Image To SD Card =====

  * Please refer to [[https://etcher-docs.balena.io/#debian-and-ubuntu-based-package-repository-gnulinux-x86x64|this page]] to install <tooltip title="An OS image flasher" placement="bottom">**Etcher**</tooltip>. \\ <callout type="warning">
If cannot install **Etcher** by <wrap cmd>sudo apt install balena-etcher</wrap>, please refer to [[https://github.com/balena-io/etcher/issues/4059#issue-1686399813]].
</callout>
  * Run <wrap cmd>balena-etcher &</wrap> to start **Etcher** in the background. This command will open a **graphics**** window**. \\ \\ {{:arch:risc-v:sipeed:how_to:img:afd4d7ccb9379436c16d5fd078dbea41.png?695x325}}

  * Click on the following icons in turn and select what you need.
      * <wrap menu>Flash from file</wrap>  - Select the <wrap file>sdcard.img</wrap> generated by buildroot in step [[arch:risc-v:sipeed:how_to:boot_lichee_rv_dock#make_image_with_buildroot|Make image with buildroot]].
      * <wrap menu>Select target</wrap>  - Select the SD card device to be used for flashing.
      * <wrap menu>Flash!</wrap>  - Flash <wrap file>sdcard.img</wrap> to the SD card device. \\ \\ {{:arch:risc-v:sipeed:how_to:img:f3fc847b9589126c2d83fbb14c58acd8.png?368x357}}

===== Human-Computer Interaction (UART) =====

Insert the SD card into the Lichee board and connect the serial. Then power on. The following video shows the Linux boot process. 
 
{{:arch:risc-v:sipeed:media:boot-lichee-rv-dock.mp4}}