Project

General

Profile

OsmocomBB Firmware » History » Version 9

laforge, 02/21/2016 11:57 AM

1 8 jolly
{{>toc}}
2 1 prom
3 8 jolly
4 8 jolly
h1. Background
5 8 jolly
6 8 jolly
The [[OsmocomBB]] source code comes with several applications for various purposes.
7 2 nion
Those applications can be devided into two separate classes, applications:
8 8 jolly
* running on the baseband chip of the phone
9 8 jolly
* running on a PC, communicating with the baseband firmware over serial
10 2 nion
11 3 nion
Applications running on the PC can further be partitioned into:
12 8 jolly
* Firmware management software (loading, flashing, ...)
13 8 jolly
* GSM Layer 2/3 applications
14 1 prom
15 1 prom
The following will provide you a rough overview of the most commonly used software pieces.
16 1 prom
17 1 prom
18 1 prom
19 1 prom
20 8 jolly
h1. Baseband firmware
21 8 jolly
22 8 jolly
23 1 prom
Binary location: src/target/firmware/board/*/*.bin
24 1 prom
Source locations: src/target/firmware/, particularly apps and layer1
25 1 prom
26 1 prom
27 8 jolly
h2. layer1
28 8 jolly
29 8 jolly
[[layer1bin]] is a simple GSM layer 1 proxy, communicating over the [[L1A_L23_Interface]].
30 8 jolly
31 5 nion
This allows you to run a full-blown GSM implementation on your host machine, communicating through the phones radio interface.
32 5 nion
33 1 prom
34 8 jolly
h2. loader
35 1 prom
36 8 jolly
[[loaderbin]] is our flash loader, dumper and second stage bootloader
37 8 jolly
38 8 jolly
39 8 jolly
h2. l1test
40 8 jolly
41 8 jolly
42 1 prom
Layer 1 development application.
43 1 prom
44 1 prom
This application does what layer1 does, but automatically tunes to the strongest ARFCN it can find.
45 1 prom
46 1 prom
It can be used for stand-alone-testing of the phones radio.
47 1 prom
48 1 prom
49 8 jolly
h2. loader
50 1 prom
51 1 prom
52 8 jolly
Our [[Bootloader]], available in various build configurations.
53 8 jolly
54 8 jolly
55 8 jolly
h2. compal_dsp_dump
56 8 jolly
57 8 jolly
58 1 prom
Application for dumping the contents of the DSP in the Calypso chip.
59 1 prom
60 1 prom
61 8 jolly
h2. compal_dumper
62 7 jolly
63 1 prom
64 8 jolly
The old compal device dumper. Use [[Bootloader]] instead once it is available.
65 8 jolly
66 8 jolly
67 8 jolly
h2. hello_world
68 8 jolly
69 8 jolly
70 1 prom
The initial obligatory "Hello, world!" application.
71 1 prom
72 7 jolly
Currently, this does more than say hello. Intended as a template for new applications.
73 1 prom
74 1 prom
75 8 jolly
h2. menu
76 1 prom
77 1 prom
78 8 jolly
Boot menu application to select and load apps that are stored in flash memory. See [[flashing_new]].
79 8 jolly
80 8 jolly
81 8 jolly
h2. rssi
82 8 jolly
83 8 jolly
84 1 prom
The [blog:rssi-firmware] can be used to monitor the received signal indication (RSSI) of ARFCNs or the entire spectrum.
85 1 prom
86 1 prom
87 8 jolly
h2. EMI
88 1 prom
89 1 prom
90 8 jolly
The EMI (electro magnetic interference) simulator application can be used to generate RF interference caused by GSM networks an mobile station. See [[emi-firmware]].
91 1 prom
92 8 jolly
93 8 jolly
94 8 jolly
95 8 jolly
h1. Firmware management software
96 8 jolly
97 1 prom
Location (source and binary): src/host/osmocon
98 1 prom
99 2 nion
100 8 jolly
h2. osmocon
101 8 jolly
102 8 jolly
[[osmocon]] is a console tool for interfacing our baseband firmware on the phone with applications on the host PC.
103 8 jolly
104 2 nion
It is responsible for downloading a baseband firmware or bootloader into the phone and relay communication between Layer 3 applications and baseband firmwares over serial.
105 2 nion
106 1 prom
107 8 jolly
h2. osmoload
108 1 prom
109 8 jolly
[[osmoload]] is used to write, dump and examine flash memory of supported phones.
110 1 prom
111 8 jolly
You will need this program for example if you intent [[flashing]] an application to the phone (the software is usually loaded into RAM).
112 1 prom
113 2 nion
114 8 jolly
h2. calypso_pll
115 8 jolly
 
116 8 jolly
The [[calypso_pll]] tool can be used to calculate Calypso DPLL multiplier+divider.
117 8 jolly
118 8 jolly
119 8 jolly
h2. rita_pll
120 8 jolly
121 8 jolly
The [[rita_pll]] tool can be used to calculate the Rita PLL multiplier/divider.
Add picture from clipboard (Maximum size: 48.8 MB)