FunKey-OS/README.md

65 lines
1.4 KiB
Markdown
Raw Normal View History

2018-02-25 19:07:30 +00:00
# FunKey
Intro
=====
2019-03-24 22:24:40 +00:00
This directory contains a buildroot-based external configuration for
2018-02-25 19:07:30 +00:00
building the FunKey.
How to build it
===============
Configure Buildroot
-------------------
There is only one Funkey defconfig files in Buildroot:
2019-03-24 22:24:40 +00:00
$ ./fun funkey_defconfig
2018-02-25 19:07:30 +00:00
Build the rootfs
----------------
Note: you will need to have access to the network, since Buildroot
will download the packages' sources.
2019-03-24 22:24:40 +00:00
You may now build your FunKey with:
2018-02-25 19:07:30 +00:00
2019-03-24 22:24:40 +00:00
$ ./have fun
2018-02-25 19:07:30 +00:00
(This may take a while, consider getting yourself a coffee ;-) )
Result of the build
-------------------
After building, you should obtain this tree:
2019-03-24 22:24:40 +00:00
FunKey/output/images/
2018-02-25 19:07:30 +00:00
+-- boot.scr
+-- boot.vfat
+-- rootfs.ext2
+-- rootfs.ext4 -> rootfs.ext2
+-- sdcard.img
2019-03-24 22:24:40 +00:00
+-- sun8i-v3s-funkey.dtb
2018-02-25 19:07:30 +00:00
+-- u-boot.bin
+-- u-boot-sunxi-with-spl.bin
`-- zImage
How to write the SD card
========================
Once the build process is finished you will have an image called
2019-03-24 22:24:40 +00:00
"sdcard.img" in the FunKey/output/images/ directory.
2018-02-25 19:07:30 +00:00
Copy the bootable "sdcard.img" onto an SD card with "dd":
2019-03-24 22:24:40 +00:00
$ sudo dd if=<Funkey directory>/FunKey/output/images/sdcard.img of=/dev/sdX
2018-02-25 19:07:30 +00:00
2019-03-24 22:24:40 +00:00
Alternatively, you can use the Etcher graphical tool to burn the image
to the SD card safely and on any platform:
https://etcher.io/
Once the SD card is burned, insert it into your FunKey board, and
power it up. Your new system should come up now and start a console on
the UART0 serial port.