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