Git Product home page Git Product logo

rpi-buildroot's Introduction

Buildroot for Raspberry Pi

This buildroot fork will produce a very light-weight and trimmed down toolchain, rootfs and kernel for the Raspberry Pi. It's intended for advanced users and specific embedded applications.

Before You Begin

  • If you're not familiar with Buildroot and what it can and can't do, please take the time to read the manual.

  • You must be pretty comfortable with cross-compilation in order to use rpi-buildroot.

Test Drive

You can test drive rpi-buildroot by following the instructions below:

wget http://dl.guillermoamaral.com/rpi/sdcard.img.xz
xz -d sdcard.img.xz
sudo dd if=sdcard.img of=/dev/sdx # replace *sdx* with your actual sdcard device node

The default user is root, no password will be requested.

Toolchain

I've added a toolchain, it has everything needed to cross-compile software for use with the test-drive image, download and usage instructions below:

wget http://dl.guillermoamaral.com/rpi/rpi-buildroot-toolchain.tar.xz
tar -xvJf rpi-buildroot-toolchain.tar.xz
source rpi-buildroot-toolchain/env
$CC -I"${BUILDROOT_STAGING_DIR}/usr/include" \
    -I"${BUILDROOT_STAGING_DIR}/opt/vc/include" \
    -L"${BUILDROOT_STAGING_DIR}/opt/vc/lib" \
    -L"${BUILDROOT_STAGING_DIR}/usr/lib" \
    -L"${BUILDROOT_STAGING_DIR}/lib" \
    -L"${BUILDROOT_TARGET_DIR}/opt/vc/lib" \
    -L"${BUILDROOT_TARGET_DIR}/usr/lib" \
    -L"${BUILDROOT_TARGET_DIR}/lib" \
    main.c # example usage

If you're interested in using the toolchain with CMake, you may want to download the toolchain cmake file used with Marshmallow Game Engine:

wget https://github.com/gamaral/marshmallow_h/blob/master/cmake/Toolchain-buildroot.cmake
# The **env** file needs to be **sourced** before executing the following command
cmake -DCMAKE_TOOLCHAIN_FILE=Toolchain-buildroot.cmake .
make

Building

git clone --depth 1 git://github.com/gamaral/rpi-buildroot.git
cd rpi-buildroot
make raspberrypi_defconfig
make nconfig         # if you want to add packages or fiddle around with it
make                 # build (NOTICE: Don't use the **-j** switch, it's set to auto-detect)

Deploying

Script

I've added a script that can automatically flash your sdcard, you simply need to point it to the correct device node, confirm and you're done!

Notice you will need to replace sdx in the following commands with the actual device node for your sdcard.

# run the following as root (sudo)
board/raspberrypi/mksdcard /dev/sdx

Manual

You will need to create two partitions in your sdcard, the first (boot) needs to be a small W95 FAT16 (LBA) patition (that's partition id e), about 32 MB will do.

Notice you will need to replace sdx in the following commands with the actual device node for your sdcard.

Create the partitions on the SD card. Run the following as root. Notice all data on the SD card will be lost.

fdisk /dev/sdx
> p             # prints partition table
> d             # repeat until all partitions are deleted
> n             # create a new partition
> p             # create primary
> 1             # make it the first partition
> <enter>       # use the default sector
> +32M          # create a boot partition with 32MB of space
> n             # create rootfs partition
> p
> 2
> <enter>
> <enter>       # fill the remaining disk, adjust size to fit your needs
> p             # double check everything looks right
> w             # write partition table to disk.

Now format the boot partition as FAT 16

# run the following as root
mkfs.vfat -F16 -n boot /dev/sdx1
mkdir -p /media/boot
mount /dev/sdx1 /media/boot

You will need to copy all the files in output/target/boot to your boot partition.

# run the following as root
cp output/target/boot/* /media/boot
umount /media/boot

The second (rootfs) can be as big as you want, but with a 200 MB minimum, and formated as ext4.

# run the following as root
mkfs.ext4 -L rootfs /dev/sdx2
mkdir -p /media/rootfs
mount /dev/sdx2 /media/rootfs

You will need to extract output/images/rootfs.tar onto the partition, as root.

# run the following as root
tar -xvpsf output/images/rootfs.tar -C /media/rootfs # replace with your mount directory
umount /media/rootfs

rpi-buildroot's People

Contributors

aldot avatar allannielsen avatar arnout avatar axellin avatar baruchsiach avatar bkuhls avatar correa avatar culssw avatar danomimanchego123 avatar djdeath avatar erikbandersen avatar fperrad avatar gamaral avatar gtalis avatar gustavoz avatar jacmet avatar lucaceresoli avatar martinbanky avatar mripard avatar nkukard avatar patrickdepinguin avatar pauliuszaleckas avatar sjhill71 avatar spdawson avatar spenser309 avatar tpetazzoni avatar tsed avatar vapier avatar yann-morin-1998 avatar yegorich avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.