This is an old revision of the document!


How to customize Buildroot

Buildroot allows to keep customizations outside Buildroot main project.

We are using this mechanism to extend & customize Buildroot configuration for liteSOM based projects and it is recommenced to start with one of our example to build infrastructure for your project.

Please take into account that below you can find one of the possible way how to customize Buildroot; for more details please read Buildroot User Manual and Customizing the generated target filesystem.

This project will allow you to build complete firmware image for liteboard and lcd with resistive touchscreen.

Main intention is to keep all customizations outside Buildroot project but still allow user to configure kernel, BusyBox and Buildroot or to modify Device Tree without any problems.

Download Buildroot release you want to use, for example

wget https://buildroot.org/downloads/buildroot-2016.11.1.tar.gz

Extract downloaded file

tar xf buildroot-2016.11.1.tar.gz

During this how to we will extend Buildroot setup by customizations from Grinn examples repository, please clone this repository

git clone https://github.com/grinn-pub/examples.git

Tell Buildroot to use additional br2-external directory by setting (once per project setup) BR2_EXTERNAL variable as presented below

cd buildroot-2016-11.1
make BR2_EXTERNAL=/tmp/examples list-defconfigs

where /tmp/examples should point to cloned Grinn examples repository.

Target list-defconfigs shows list of available defconfigs. After built-in configs you should see configs provided by the external customizations (like Grinn examples).

make BR2_EXTERNAL=/tmp/examples list-defconfigs
Built-in configs:
  acmesystems_aria_g25_128mb_defconfig - Build for acmesystems_aria_g25_128mb
  acmesystems_aria_g25_256mb_defconfig - Build for acmesystems_aria_g25_256mb
  [...]

External configs in "Grinn examples":
  grinn_liteboard_lcd_res_defconfig   - Build for grinn_liteboard_lcd_res

To configure Buildroot for liteSOM + lcd please use grinn_liteboard_lcd_res_defconfig configuration.

make grinn_liteboard_lcd_res_defconfig

Project compilation

You can compile project in this same way as usual

make all

Project output

Like for other Buildroot based projects directory output/images/ contains all files required to program liteboard.

You can program SD card via following command

dd if=output/images/sdcard.img of=/dev/<SD-CARD> bs=4M
  • litesom/customization.1486315685.txt.gz
  • Last modified: 2017/02/05 17:28
  • by filug