Software Getting Started » History » Version 2
Anonymous, 02/19/2016 10:49 PM
1 | 1 | == OsmocomBB Getting Started Guide == |
|
---|---|---|---|
2 | |||
3 | This page will describe how to compile the firmware, the host utilities and how to use them. |
||
4 | |||
5 | === Compiling osmocomBB === |
||
6 | osmocomBB consists out of software that is intended to be run on the phone (target) and the host system. |
||
7 | |||
8 | ==== Depenendencies for the host ==== |
||
9 | osmocomBB requires GNU autoconf, automake, libtool, pkg-config, make and GCC to compile. You will |
||
10 | also need to use git to access and update the sources. There should be no other depedencies. The name |
||
11 | of these packages depend on the distribution used. To |
||
12 | |||
13 | For Debian the package names are: |
||
14 | {{{ |
||
15 | sudo aptitude install libtool autoconf git-core pkg-config make gcc |
||
16 | }}} |
||
17 | |||
18 | ==== Depenendencies for the target ==== |
||
19 | To compile software for the target we need a GNU Toolchain for ARM. There are various pre-compiled toolchains |
||
20 | available but not all of them will produce working firmware. We will try to support all these configurations but it |
||
21 | might take a while to identify the source of a problem. |
||
22 | |||
23 | 2 | ==== Getting and updating the source ==== |
|
24 | 1 | {{{ |
|
25 | git clone git://git.osmocom.org/osmocom-bb.git |
||
26 | 2 | }}} |
|
27 | |||
28 | {{{ |
||
29 | $ cd osmocom-bb.git |
||
30 | $ git pull --rebase |
||
31 | }}} |
||
32 | |||
33 | ==== Building the source ==== |
||
34 | Compiling both the target and the host code will happen with the following command. It assumes that the '''arm-elf-gcc''' |
||
35 | is inside the current path. |
||
36 | |||
37 | {{{ |
||
38 | $ cd src |
||
39 | $ make |
||
40 | }}} |
||
41 | |||
42 | If your GCC binary that produces ARM code is not called ''''arm-elf-gcc''' you will need to invoke |
||
43 | |||
44 | {{{ |
||
45 | $ cd src |
||
46 | $ make -e CROSS_TOOL_PREFIX=arm-OTHER_NAME- |
||
47 | 1 | }}} |