Project

General

Profile

OsmocomBB Firmware » History » Version 4

nion, 02/19/2016 10:48 PM

1 1
2
[[PageOutline]]
3
4 2 nion
= Background =
5
The OsmocomBB source code comes with several applications for various purposes.
6
Those applications can be devided into two separate classes, applications:
7
 * running on the baseband chip of the phone
8
 * running on a PC, communicating with the baseband firmware over serial
9 1
10 2 nion
Applications running on the PC can further be partitioned into:
11
 * Firmware management software (loading, flashing, ...)
12 3 nion
 * GSM Layer 2/3 applications
13 1
14 2 nion
The following will provide you a rough overview of the most commonly used software pieces.
15 1
16
17
18 2 nion
= Baseband firmware =
19
20
Binary location: src/target/firmware/board/*/*.bin
21
Source locations: src/target/firmware/, particularly apps and layer1
22
23 1
== layer1 ==
24
25
A simple GSM layer 1 proxy, communicating over the [wiki:L1A_L23_Interface].
26
27
This allows you to run a full-blown GSM implementation on your host machine, communicating through the phones radio interface.
28
29
== l1test ==
30
31
Layer 1 development application.
32
33
This application does what layer1 does, but automatically tunes to the strongest ARFCN it can find.
34
35
It can be used for stand-alone-testing of the phones radio.
36
37
== loader ==
38
39
Our [wiki:Bootloader], available in various build configurations.
40
41
== compal_dsp_dump ==
42
43
Application for dumping the contents of the DSP in the Calypso chip.
44
45
== compal_dumper ==
46
47
The old compal device dumper. Use [wiki:Bootloader] instead once it is available.
48
49
== hello_world ==
50
51
The initial obligatory "Hello, world!" application.
52
53
Currently, this does more than say hello. Intended as a template for new applications.
54 2 nion
55
== rssi ==
56
57
The [blog:rssi-firmware] can be used to monitor the received signal indication (RSSI) of ARFCNs or the entire spectrum.
58
59
60
61
= Firmware management software =
62
Location (source and binary): src/host/osmocon
63
64
== osmocon ==
65
[wiki:osmocon] is a console tool for interfacing our baseband firmware on the phone with applications on the host PC.
66 4 nion
67 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.
68
69 1
== osmoload ==
70 4 nion
[wiki:osmoload] is used to write, dump and examine flash memory of supported phones.
71
72 2 nion
You will need this program for example if you intent [wiki:flashing] an application to the phone (the software is usually loaded into RAM).
73 1
74 3 nion
== calypso_pll == 
75
The [wiki:calypso_pll] tool can be used to calculate Calypso DPLL multiplier+divider.
76 1
77 3 nion
== rita_pll ==
78
The [wiki:rita_pll] tool can be used to calculate the Rita PLL multiplier/divider.
79 1
80 3 nion
81
= GSM Layer 2/3 applications = 
82 2 nion
Location (source and binary): src/host/layer23/*
83
84 3 nion
Layer 3 applications implement various functionality based on GSM Layer 3 in combination with Layer 2 (LAPDm).
85 2 nion
86
== mobile ==
87 1
[wiki:mobile] is the most sophisticated OsmocomBB application so far.
88 4 nion
89 2 nion
It implements most of the behavior of a regular GSM telephone, but is extended in many ways with features interesting to researchers.
90
91
== cell_log ==
92 1
The cell_log application scans through valid available carrier frequencies, attempts to sync to them and dumps information gathered from the BCCH.
93 4 nion
94 2 nion
It is usually used to create a list of used ARFCNs and information such as their reception levels, MNC, MCC, and System Information.
95
96
== ccch_scan ==
97
The ccch_scan application can sync to a carrier ARFCN and logs power measurement and CCCH information (paging requests and Immediate Assignments).
98
99
== bcch_scan ==
100
bcch_scan is basically a predecessor of cell_log and logs information as observed on the BCCH (System Information).
101
102
== cbch_sniff ==
103
cbch_sniff dumps cell broadcast channel information such as, e.g., GPS location of the cell.
Add picture from clipboard (Maximum size: 48.8 MB)