Mirror of funkey-project/funkey-os@github.com - OS for the FunKey kickstarter-funded handheld games console.
Go to file
Michel-FK a1ce14040d added retrofe & retrofe-layout packages 2020-01-06 19:40:27 +01:00
FunKey added retrofe & retrofe-layout packages 2020-01-06 19:40:27 +01:00
buildroot@836b84a774 Bumped buildroot to 2019.11 2019-12-30 11:11:31 +01:00
funkey_retrofe@0961a03bf2 added retrofe & retrofe-layout packages 2020-01-06 19:40:27 +01:00
funkey_retrofe_layout_240x240@f29381aafc added retrofe & retrofe-layout packages 2020-01-06 19:40:27 +01:00
.gitignore Make buildroot a git submodule 2019-03-24 23:24:40 +01:00
.gitmodules added retrofe & retrofe-layout packages 2020-01-06 19:40:27 +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.