thirtythreeforty/businesscard-linux
A Buildroot distribution small enough to run on my business card
| repo name | thirtythreeforty/businesscard-linux |
| repo link | https://github.com/thirtythreeforty/businesscard-linux |
| homepage | https://www.thirtythreeforty.net/posts/2019/12/my-business-card-runs-linux/ |
| language | Makefile |
| size (curr.) | 14277 kB |
| stars (curr.) | 1238 |
| created | 2019-04-30 |
| license | |
Business Card Linux
This is the Linux distribution small enough to run from the 8MB of storage on my Linux-powered business card. It is powered by the Allwinner F1C100s, a $1.40 Linux-capable ARM system-on-chip. This repository is the source code for its firmware image, based on Buildroot 2019.05. This directory is a “Buildroot external,” providing a few patches, additional packages, and board support files on top of mainline Buildroot.
For a complete write-up, see my blog post about the project.
Patched Linux and U-Boot
I lightly patched the Linux kernel and U-Boot to get all the hardware peripherals working. You can find my forks here:
Build
Make sure submodules are initialized:
git submodule update --init
Change to the top-level Buildroot directory:
cd buildroot
Initialize the configuration, including the defconfig and this external directory:
make BR2_EXTERNAL=$PWD/../ thirtythreeforty_businesscard_defconfig
And compile:
make
This may take a couple hours to do from scratch, depending on the speed of your machine.
Installation
If you have a Lichee Pi Nano with a flash chip, or one of my blank business cards, you can flash it with the following command.
Make sure the board is in FEL mode using dmesg or similar.
output/host/bin/sunxi-fel -p spiflash-write 0 output/images/flash.bin
You can erase the card after it boots by simply logging in (as root) and erasing the flash manually:
dd if=/dev/zero of=/dev/mtd0
Don’t erase it unless you’re prepared to burn a new image!
License
Subject to the below exceptions, code is released under the GNU General Public License, version 2 or (at your option) any later version. See also the Buildroot license notice for more nuances about the meaning of this license.
Patches are not covered by this license. Instead, they are covered by the license of the software to which the patches are applied.
Finally, files in the businesscard-flashdrive package, including its README, my resume, and my photography, remain proprietary and are not released under the GPL.
If you would like to build your own firmware based on this, simply remove those files, or deselect the package during build.
