View on GitHub

Build Gear

A lightweight embedded firmware build tool

buildgear-0.9.20.tar.xz Release Notes (07-05-14)

Latest Code Commits

git://github.com/buildgear/buildgear.git

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?

Build Gear is easily installed. See the installation section of the Build Gear handbook

How to build stuff?

Build Gear makes building a basic filesystem for eg. the Pandaboard as easy as:

$ git clone --recursive git://github.com/mini-distribution/pandaboard.git
$ cd pandaboard
$ 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: build/output/fs.tar.gz

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 easily create and customize embedded firmware for specific needs and at the same time maintain a high level of firmware quality. One of the finest qualities 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.

Features

  • Simple build files
  • Cross and native type build files
  • Build dependency support
  • Automatic rebuild support
  • Support for independent build spaces
  • One global build configuration file
  • Local and global tool configuration
  • Build layer support
  • Advanced build log support
  • Automatic source download
  • Integrated download manager:
    • Support for http, https, ftp, ftps type URLs
    • Parallel download support
    • Download resume support
    • Download super mirror support
    • URL redirection support
  • Compressed source tarball support
  • Crosstool-NG toolchain support
  • Bash autocompletion
  • Automatic stripping of binaries
  • SVG dependency graph support
  • SVG load chart support
  • Build footprint support
  • Build checksum support (sha256sum)
  • Build system type detection
  • Build system check support
  • Parallel build support
  • Build log rotation

License

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.

Downloads

Release tarballs are available here.

Documentation

Latest revision of the Build Gear Handbook is available online here.

NOTE:

Please notice that the handbook documentation is currently considered somewhat incomplete and work in progress.

Mailing List

Please subscribe to the following mailing list for development, help, bug reports, announcements, discussions, etc.: Build Gear Development Mailing List

Development

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

Build files are available here.

At the moment this is just a list of build file repositories supported by the Build Gear maintainers. In the future we will figure out a way to handle and maintain an online list of user contributed build file repositories.

Contributing

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.