This document describes running Fuchsia on the Khadas VIM3 board. Additional documentation can be found at docs.khadas.com
The Khadas VIM3 board is the successor to the VIM2.
Fuchsia currently supports these features of the VIM3:
These features are under development and may not be supported:
The following features are not supported, but might be added by future contributions:
These features are not supported and are unlikely to be added:
When setting up your board, make sure you have a 24W power supply, as the VIM3 can draw that much power when DVFS is enabled.
When describing the location of buttons, pins and other items on the board, we will refer to the side with the USB, ethernet and HDMI connectors as the front of the board and the opposite side the back of the board.
Before you start, you need a heat sink. A passive chip heat sink will allow you to run 2 cores out of 8 at full speed before reaching 80C, the critical temperature at which cores have to be throttled down.
fastboot.The debug UART for the serial console is exposed on the 40 pin header at the back of the board. You may use a 3.3v FTDI USB to serial cable to access the serial console. On the front row of the header:
For FTDI serial cables with black, white, red and green wires, use this:
You can see these pins in this diagram of the 40 pin header.
When connecting to the serial port, use (115200,8,N,1) as the settings.
The VIM3 has 3 buttons on the left side of the board. On the board schematic, SW1 (switch closest to the USB plug) is the reset switch. SW3 (farthest away from the USB plug on the schematic) can be used for entering flashing mode. If SW3 is held down while the board is reset or power cycled , the bootloader will enter flashing mode instead of booting the kernel normally.
Booting Fuchsia on the VIM3 requires a custom bootloader found at third-party-mirror.googlesource.com/u-boot/, in the vim3 branch.
You can download the latest built version at https://chrome-infra-packages.appspot.com/p/fuchsia/prebuilt/third_party/firmware/vim3/+/#instances.
To find out what version of the bootloader you have, grep for “zircon-bootloader” in the kernel boot log. You should see something like: “cmdline: zircon-bootloader=0.12”
The first time flashing the device, you will need to unlock the flashing capability. Boot the device by pressing the reset switch and you'll see logs in the serial console and hold. Repeatedly press the space bar to get to the U-boot console prompt.
Once you see the U-boot prompt (kvim#), type fastboot to launch fastboot. You should then see:
USB RESET SPEED ENUM USB RESET SPEED ENUM
This indicates that fastboot is running.
To unlock flashing, type the following fastboot commands on the host:
fastboot flashing unlock fastboot flashing unlock_critical
Now you can flash the Fuchsia bootloader. Assuming you named the bootloader file u-boot.bin, type the following commands:
fastboot flash bootloader u-boot.bin fastboot reboot
Now your board will reboot and use the new version of U-boot you just flashed. You only need to do this step once.
Set your build configuration to the core vim3 product and build it:
fx set core.vim3 fx build
When the build is complete, you can flash the device (below).
First enter fastboot mode by holding down SW3 (leftmost button), pressing SW1 (rightmost button) quickly and keeping pressing SW3 for a few seconds. When the following shows up, the device is in fastboot mode:
USB RESET SPEED ENUM USB RESET SPEED ENUM
Now you can flash & pave:
fx flash --pave
This flashes all of the zircon, zedboot, vbmeta and fvm images to your vim3 and provisions ssh key files on the device. It is now ready to use and does not need to go through zedboot or paving. (If you don‘t know what those are, don’t worry!)
If fx flash asks for serial, you can find it with fastboot devices.
In order to get into zedboot you can reboot into the recovery:
dm reboot-recovery
Paving is available from the “core” product and above. Run the following under the fuchsia directory:
fx set core.vim3 && fx build && fx pave -1
To update the boot splash screen to be the Fuchsia logo, do this in fastboot mode:
fastboot flash logo zircon/kernel/target/arm64/board/vim2/firmware/logo.img
(The same file is usable for VIM2 and VIM3.)