Mirror of funkey-project/funkey-os@github.com - OS for the FunKey kickstarter-funded handheld games console.
Go to file
Vincent-FK bc9af11d9e changed linux version in recovery and FunKey: bug fix in fbtft driver, TE interupt initialized after vars and functions 2020-11-03 20:31:55 +01:00
FunKey changed linux version in recovery and FunKey: bug fix in fbtft driver, TE interupt initialized after vars and functions 2020-11-03 20:31:55 +01:00
Recovery changed linux version in recovery and FunKey: bug fix in fbtft driver, TE interupt initialized after vars and functions 2020-11-03 20:31:55 +01:00
buildroot@b120226e0e bumped buildroot to 2020.02.6 2020-10-06 22:46:48 +02:00
docker recovery build 2020-10-20 23:26:28 +02:00
.gitignore recovery build 2020-10-20 23:26:28 +02:00
.gitmodules Removed obsolete submodules 2020-06-06 22:23:19 +02:00
Makefile changed update file naming scheme 2020-11-01 00:55:14 +01:00
README.md correct url in README 2020-09-24 19:04:15 +02:00
genimage.cfg add swap partition 2020-11-02 16:49:47 +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 https://github.com/FunKey-Project/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.