Mirror of funkey-project/funkey-os@github.com - OS for the FunKey kickstarter-funded handheld games console.
Go to file
Michel-FK 09dc20c6e7 Added the utility scripts 2020-05-30 09:22:50 +02:00
FunKey Added the utility scripts 2020-05-30 09:22:50 +02:00
buildroot@0edff95ebd Bumped buildroot to 2020.02.x 2020-05-13 22:54:17 +02:00
.gitignore first_boot script 2020-05-09 23:49:37 +02:00
.gitmodules added funkey-gpio-mapping 2020-01-06 23:11:11 +01:00
README.md added patch 20 for fbtft soft rotation and text overlay 2019-12-04 23:27:55 +01:00
fun Optimized boot time and USB back to working 2019-05-04 20:18:57 +02:00
have Make buildroot a git submodule 2019-03-24 23:24:40 +01:00

README.md

FunKey

Intro

This directory contains a buildroot-based external configuration for building the FunKey.

How to get it

Clone the FunKey OS repository and the required submodules from BitBucket:

$ git clone --recurse-submodules git@bitbucket.org:keymu2/funkey-os.git

Then enter into the created directory:

$ cd

How to build it

Configure Buildroot

There is only one Funkey defconfig files in Buildroot:

$ ./fun funkey_defconfig

Build the rootfs

Note: you will need to have access to the network, since Buildroot will download the packages' sources.

You may now build your FunKey with:

$ ./have fun

(This may take a while, consider getting yourself a coffee ;-) )

Result of the build

After building, you should obtain this tree:

FunKey/output/images/
+-- boot.scr
+-- boot.vfat
+-- rootfs.ext2
+-- rootfs.ext4 -> rootfs.ext2
+-- sdcard.img
+-- sun8i-v3s-funkey.dtb
+-- 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 "sdcard.img" in the FunKey/output/images/ directory.

Copy the bootable "sdcard.img" onto an SD card with "dd":

$ sudo dd if=/FunKey/output/images/sdcard.img of=/dev/sdX

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.