|
@@ -0,0 +1,75 @@
|
|
|
+SiFive HiFive Unleashed
|
|
|
+=======================
|
|
|
+
|
|
|
+This file describes how to use the pre-defined Buildroot
|
|
|
+configuration for the SiFive HiFive Unleashed board.
|
|
|
+
|
|
|
+Further information about the HiFive Unleashed board can be found
|
|
|
+at https://www.sifive.com/boards/hifive-unleashed
|
|
|
+
|
|
|
+Building
|
|
|
+========
|
|
|
+
|
|
|
+Configure Buildroot using the default board configuration:
|
|
|
+
|
|
|
+ $ make hifive_unleashed_defconfig
|
|
|
+
|
|
|
+Customise the build as necessary:
|
|
|
+
|
|
|
+ $ make menuconfig
|
|
|
+
|
|
|
+Start the build:
|
|
|
+
|
|
|
+ $ make
|
|
|
+
|
|
|
+Result of the build
|
|
|
+===================
|
|
|
+
|
|
|
+Once the build has finished you will have the following files:
|
|
|
+
|
|
|
+ output/images/
|
|
|
+ +-- fw_jump.bin
|
|
|
+ +-- fw_jump.elf
|
|
|
+ +-- fw_payload.bin
|
|
|
+ +-- fw_payload.elf
|
|
|
+ +-- Image
|
|
|
+ +-- rootfs.ext2
|
|
|
+ +-- rootfs.ext4
|
|
|
+ +-- rootfs.tar
|
|
|
+ +-- sdcard.img
|
|
|
+
|
|
|
+
|
|
|
+Creating a bootable SD card with genimage
|
|
|
+=========================================
|
|
|
+
|
|
|
+Buildroot builds a SD card image for you. All you need to do is dd the
|
|
|
+image to your SD card, which can be done with the following command:
|
|
|
+
|
|
|
+ $ sudo dd if=output/images/sdcard.img of=/dev/mmcblk0 bs=4096
|
|
|
+
|
|
|
+Booting the SD card on the board
|
|
|
+================================
|
|
|
+
|
|
|
+Make sure that the all DIP switches are set to the off position for
|
|
|
+default boot mode (MSEL mode = 1111), insert the SD card and power
|
|
|
+up the board.
|
|
|
+
|
|
|
+Connect the USB cable and open minicom (/dev/ttyUSB1, 115200, 8N1).
|
|
|
+
|
|
|
+See the 'SiFive HiFive Unleashed Getting Started Guide' for
|
|
|
+more details (https://www.sifive.com/documentation).
|
|
|
+
|
|
|
+You will get a warning reported by fdisk when you examine the SD card.
|
|
|
+This is because the genimage.cfg file doesn't specify the SD card size
|
|
|
+(as people will naturally have different sized cards), so the
|
|
|
+secondary GPT header is placed after the rootfs rather than at the end
|
|
|
+of the disk where it is expected to be.
|
|
|
+
|
|
|
+You will see something like this at boot time:
|
|
|
+
|
|
|
+[ 2.318722] GPT:Primary header thinks Alt. header is not at the end of the disk.
|
|
|
+[ 2.325390] GPT:190496 != 122142719
|
|
|
+[ 2.328843] GPT:Alternate GPT header not at the end of the disk.
|
|
|
+[ 2.334824] GPT:190496 != 122142719
|
|
|
+[ 2.338302] GPT: Use GNU Parted to correct GPT errors.
|
|
|
+[ 2.343456] mmcblk0: p1 p2
|