|  | 1 | = The BuildRoot environment = | 
                          |  | 2 |  | 
                          |  | 3 | [BuildRoot http://buildroot.uclibc.org] is a build system [http://en.wikipedia.org/wiki/Build_automation]. It will help you to manage and create a complete GNU/Linux system from scratch automatically. | 
                          |  | 4 |  | 
                          |  | 5 | The main role of a build system is: | 
                          |  | 6 | - Compile source code | 
                          |  | 7 | - Manage packages (software) | 
                          |  | 8 | - Deploy software to a platform | 
                          |  | 9 | - (optionally) Test software code | 
                          |  | 10 | - (optionally) Generate documentation | 
                          |  | 11 |  | 
                          |  | 12 | During this module, you will only use a very small part of what a build system is capable of. However, it is sufficient to build a large variety of embedded systems. | 
                          |  | 13 |  | 
                          |  | 14 | This page contains documentation for setting up and using BuildRoot. | 
                          |  | 15 |  | 
                          |  | 16 | == Installation == | 
                          |  | 17 |  | 
                          |  | 18 | The installation makes the hypothesis you are on a GNU system (e.g. GNU/Linux) with utilities like make, flex, bison, gcc... | 
                          |  | 19 |  | 
                          |  | 20 | Open a terminal, | 
                          |  | 21 |  | 
                          |  | 22 | 1) Setup the working directory | 
                          |  | 23 |  | 
                          |  | 24 | In the home directory, type: | 
                          |  | 25 |  | 
                          |  | 26 | {{{ | 
                          |  | 27 | developer@debian-rpi:~$ mkdir -p work/sources | 
                          |  | 28 | }}} | 
                          |  | 29 |  | 
                          |  | 30 | 1) Get the BuildRoot software | 
                          |  | 31 |  | 
                          |  | 32 | {{{ | 
                          |  | 33 | developer@debian-rpi:~$ cd work/sources | 
                          |  | 34 | developer@debian-rpi:~/work/sources$ wget http://buildroot.uclibc.org/downloads/buildroot-2013.11.tar.bz2 | 
                          |  | 35 | }}} | 
                          |  | 36 |  | 
                          |  | 37 | 2) Uncompress the archive | 
                          |  | 38 |  | 
                          |  | 39 | {{{ | 
                          |  | 40 | developer@debian-rpi:~/work/sources$ tar xvf buildroot-2013.11.tar.bz2 -C ~/work | 
                          |  | 41 | }}} | 
                          |  | 42 |  | 
                          |  | 43 | This will uncompress the archive in the directory ~/work/buildroot-2013.11. |