What is Build Gear?
Build Gear is a lightweight build tool for building embedded firmware.
The primary focus of this build tool is to make it easy to create and maintain fully customized embedded firmware. This is reflected in a straightforward command line interface and support for easy to understand build files. The secondary focus is build performance and build integrity. Build Gear is easy to use and well suited for rapid prototyping and product development of GNU/Linux firmware to be deployed in small to medium sized embedded systems.
How to install?
To install please see the installation section of the Build Gear handbook
How to build stuff?
Build Gear makes building a basic filesystem for eg. the Hummingboard as easy as:
$ git clone --recursive git://github.com/mini-distribution/hummingboard.git $ cd hummingboard $ buildgear build fs
This will make Build Gear automatically download the source code of all
included filesystem components, resolve build dependencies, and build
everything in correct order - the end result is a compressed filesystem tarball
in the build output directory:
Do we need another build tool?
In short, yes! We need a truly simple build tool for easily creating fully customized embedded GNU/Linux firmware.
The main motivation for creating Build Gear is to create a firmware build tool which operates in simpler and more transparent ways than existing build tools. Transparency is an imperative precondition for being able to quickly and easily create and customize embedded firmware for specific needs and at the same time maintain a high level of firmware quality. One of the main advantages of Build Gear is that it makes it easy to start from scratch. Also, there is a good collection of build files available for reuse or inspiration and if you are missing any features you can easily customize or add build files yourself.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Release tarballs are available here.
Latest revision of the Build Gear Handbook is available online here.
Please notice that the handbook documentation is currently considered somewhat incomplete and work in progress.
Subscribe to the following mailing list for development, help, bug
reports, announcements, discussions, etc.:
Build Gear Development Mailing List
We hang out on the #buildgear channel at irc.freenode.net.
The Build Gear source code is available on github: github.com/buildgear.
Continious integration builds are available via Contigrator: contigrator.wizznic.org/jobs/buildgear.
Build file repositories
There is a collection of reference buildfiles available here: https://github.com/mini-distribution.
These buildfiles are part of the "Mini Distribution" which is a reference distribution maintained by the Build Gear maintainers. It includes a simple set of components and features. That being said you should be able to easily reuse, modify or extend it for your own needs. In fact, we invite you to create your own distribution for you specific hardware. Build Gear makes it easy to do!
The Mini Distribution has it's own website here: http://mini-distribution.io.
Also, please notice that we only support building the Mini Distribution using Ubuntu. Other distributions installed on your build system are not officially supported. However, others will likely work but use on your own risk!
Feel free to contribute - Build Gear is fully open source and open for ideas and patches which improve the build tool itself or any of the available build files. Go ahead, introduce yourself on the mailing list or drop by #buildgear.
We are always in need for maintainers to help maintain support for various hardware boards.
Build Gear Commit History
Mini Distribution Commit History (http://mini-distribution.io)
The Mini Distribution serves as a reference distribution and example on how to create firmware using Build Gear.