FunKey-OS

History

Michel-FK 82f64a82c4 Removed dmesg boot errors		2019-10-27 11:07:05 +01:00
..
patches	Removed dmesg boot errors	2019-10-27 11:07:05 +01:00
rootfs-overlay	Added mass_storage filesystem check	2019-10-19 23:39:43 +02:00
boot.cmd	modified boot.cmd t oremove duplicate console statement and quiet	2019-10-20 16:49:52 +02:00
busybox.config	Added mass_storage filesystem check	2019-10-19 23:39:43 +02:00
device_table.txt	Make buildroot a git submodule	2019-03-24 23:24:40 +01:00
genimage.cfg	Moved from zImage to uImage to anticipate for U-Boot Falcon Mode	2019-05-05 19:45:44 +02:00
linux.config	Changed boot logo, added AXP209 support and removed 90 degrees screen rotation because of tearing effect	2019-10-18 23:17:32 +02:00
post-build.sh	Make buildroot a git submodule	2019-03-24 23:24:40 +01:00
readme.txt	Moved from zImage to uImage to anticipate for U-Boot Falcon Mode	2019-05-05 19:45:44 +02:00
uboot.config	added smp, g_ether working with debian	2019-09-30 14:16:27 +02:00
users_table.txt	Make buildroot a git submodule	2019-03-24 23:24:40 +01:00

readme.txt

# 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 <Funkey directory>

Then enter into the created directory:

  $ cd <Funkey directory>

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
    `-- uImage

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 directory>/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.