2013-01-10-WikiStart » History » Version 72
Anonymous, 02/19/2016 10:48 PM
1 | 22 | laforge | [[PageOutline]] |
---|---|---|---|
2 | 23 | laforge | = Welcome to the OsmocomBB project = |
3 | 1 | ||
4 | 65 | laforge | OsmocomBB is an Free Software / Open Source GSM Baseband software implementation. |
5 | 23 | laforge | |
6 | It intends to completely replace the need for a proprietary GSM baseband software, such as |
||
7 | * drivers for the GSM analog and digital baseband (integrated and external) peripherals |
||
8 | * the GSM phone-side protocol stack, from layer 1 up to layer 3 |
||
9 | |||
10 | 57 | laforge | In short: By using [wiki:OsmocomBB] on a compatible phone, you are able |
11 | 23 | laforge | to make and receive phone calls, send and receive SMS, etc. based on Free Software only. |
12 | 1 | ||
13 | 57 | laforge | Over the past 12 months, we've been making very good progress. Most of the hardware drivers have been |
14 | written, and a relatively complete layer1, layer2 and layer3 exist. |
||
15 | |||
16 | No work has yet been done on any sort of UI on the phone. The only user interface is a telnet-based |
||
17 | command line. |
||
18 | |||
19 | 62 | To get started, checkout the [wiki:PreliminaryRequirements] and then [wiki:GettingStarted] |
|
20 | |||
21 | 1 | == Directory == |
|
22 | 58 | steve-m | |
23 | [[BlogList(format=float,recent=5,max_size=350)]] |
||
24 | 23 | laforge | |
25 | This is the project page about our experiments (so far) only with phones based on the Ti [wiki:Calypso]/[wiki:Iota]/[wiki:Rita] |
||
26 | 32 | laforge | GSM baseband chipset. The main target is the [wiki:MotorolaC123]. For more supported phones, check below. |
27 | 8 | laforge | |
28 | We originally intended to build an inexpensive GSM experimentation board built with/around that chipset, but right now |
||
29 | 15 | laforge | are pursuing a slightly alternative course by using cheap off-the-shelf feature phones and write custom software for it. |
30 | 1 | * The [wiki:ProjectRationale] |
|
31 | 8 | laforge | * The big [wiki:MasterPlan] |
32 | 17 | laforge | * [wiki:AreasOfWork] -- What needs to be done and who wants to do it |
33 | 23 | laforge | * Information about the [wiki:TypicalCalypsoModemDesign] |
34 | 42 | laforge | * [wiki:Calypso] -- The HERCROM digital baseband chip (DSP+ARM7) |
35 | 11 | laforge | * [wiki:CalypsoDSP] -- The DSP inside the Calypso DBB |
36 | 1 | * [wiki:Iota] -- The TWL3025 analog baseband chip (ADC/DAC) |
|
37 | 10 | laforge | * [wiki:Rita] -- The TRF6151C GSM transceiver (VCO, up/down-conversion) |
38 | 50 | laforge | * Information about the [wiki:SciphoneDreamG2], a [wiki:MT6235] based phone (not supported!!) |
39 | 22 | laforge | * Old/obsolete plan/spec of the [wiki:GsmDevelBoard] (note: This project is on hold right now! |
40 | 18 | laforge | * Description of our own GSM Stack |
41 | 1 | * [wiki:L1A_L23_Interface] -- How the Layer1 interfaces with Layer2 and Layer3 of the stack |
|
42 | * Notes on the [wiki:TSM30Layer1 TSM30 Layer1] as it can be found in the TSM30 source |
||
43 | 22 | laforge | * [wiki:Glossary] -- The weird terms used in the phone baseband world |
44 | * [wiki:LegalAspects] -- Important legal aspects of this project |
||
45 | 71 | * [wiki:Community/People] -- The people behind the project |
|
46 | 37 | laforge | * [wiki:PressCoverage] -- What the press is writing about us |
47 | 1 | ||
48 | 72 | == Mailing List/IRC Chat == |
|
49 | 26 | laforge | |
50 | 72 | We offer [wiki:Community/Mailing_lists Mailing Lists] and hang out on [wiki:Community/IRC IRC]. |
|
51 | 44 | steve-m | |
52 | |||
53 | 1 | == Software == |
|
54 | 31 | laforge | Documentation about software developed by this project. |
55 | 1 | ||
56 | 66 | laforge | OsmocomBB source code is kept in the git repository at '''git://git.osmocom.org/osmocom-bb.git''', which you can browse |
57 | best from http://cgit.osmocom.org/ |
||
58 | 26 | laforge | |
59 | 56 | * [wiki:GettingStarted] -- Getting Started with the Software for the target and host. |
|
60 | 63 | laforge | * [wiki:SoftwareOverview] -- Overview how all the parts below fit together |
61 | 56 | ||
62 | 31 | laforge | === Host programs (running on the PC) === |
63 | 64 | laforge | |
64 | ==== General Purpose ==== |
||
65 | 25 | zecke | * [wiki:osmocon] -- A tool for Compal phones; to load code into RAM and execute it |
66 | 64 | laforge | * [wiki:mobile] -- An application implementing a regular GSM mobile phone (and more) |
67 | * [wiki:WiresharkIntegration] -- How to use OsmocomBB with wireshark protocol analyzer |
||
68 | * [wiki:libosmocore] -- A library with utility functions |
||
69 | |||
70 | ==== Advanced / special purpose tools ==== |
||
71 | 1 | * [wiki:osmoload] -- A tool for flashing and examining phones |
|
72 | * [wiki:calypso_pll] -- A tool to calculate Calypso DPLL multiplier+divider |
||
73 | 37 | laforge | * [wiki:rita_pll] -- A tool to calculate the Rita PLL multiplier/divider |
74 | 35 | laforge | * [wiki:layer23] -- An implementation of GSM Layer2 and upwards. |
75 | 1 | ||
76 | 31 | laforge | === Target programs (running on the phone baseband chip) === |
77 | 26 | laforge | * [wiki:firmware] -- The current staging/testing code base for our own software on the Calypso. From it we build a number of apps: |
78 | 54 | steve-m | * hello_world.bin -- An actual 'hello world' application for LCD and serial port |
79 | 22 | laforge | * [wiki:layer1.bin] -- The actual Layer1 software as it is to be used with [wiki:layer23] |
80 | 48 | * [wiki:loader.bin] -- Our flash loader, dumper and second stage bootloader |
|
81 | * [wiki:compal_dsp_dump.bin] -- A program to dump the ROM of the DSP inside the [wiki:Calypso] |
||
82 | 22 | laforge | |
83 | 31 | laforge | == Supported Phone hardware == |
84 | Information specific to certain Calypso based phones that we support |
||
85 | |||
86 | 20 | laforge | * Designed + Manufactured by Compal, OEM by Motorola |
87 | * [wiki:MotorolaC115]/C117 (E87) |
||
88 | 1 | * [wiki:MotorolaC123]/C121/C118 (E88) -- our primary target |
|
89 | * [wiki:MotorolaC140]/C139 (E86) |
||
90 | * [wiki:MotorolaC155] (E99) -- our secondary target |
||
91 | 39 | steve-m | * [wiki:MotorolaV171] (E68/E69) |
92 | 33 | laforge | * [wiki:SonyEricssonJ100i] |
93 | 1 | ||
94 | 47 | steve-m | * Designed by Pirelli/Foxconn, manufactured by Foxconn |
95 | 61 | steve-m | * [wiki:PirelliDPL10 Pirelli DP-L10] |
96 | |||
97 | * Designed by Openmoko, manufactured by FIC |
||
98 | 47 | steve-m | * Neo 1973 (GTA01) |
99 | 69 | * [wiki:OpenMoko] - Neo Freerunner (GTA02) |
|
100 | 1 | === Accessories === |
|
101 | 72 | You will need a [wiki:Hardware/SerialCable] to connect the phone to a PC |
|
102 | 31 | laforge | |
103 | 1 | == Random bits and pieces == |
|
104 | 55 | laforge | * SIM related |
105 | * [wiki:RebelSIM] How the Rebel SIM card cand be used as SIM proxy |
||
106 | * [wiki:RebelSIM_Scanner] to scan/trace communication between SIM and phone (rubbish) |
||
107 | * [wiki:SIMtrace] -- our custom hardware / firmware / software to get SIM-ME traces into wireshark |
||
108 | * [wiki:SIMReader] How to connect to network using provider SIM |
||
109 | 68 | tsaitgaist | * [wiki:softSIM] How to do software SIM |
110 | 60 | * [wiki:Sniffing Notes on sniffing] |
|
111 | 67 | * [wiki:dct3-gsmtap] A tool to obtain GSMTAP messages for SIM and GSM from Nokia DCT3 (eg, 3310) phones |
|
112 | 72 | * [wiki:Hardware/FilterReplacement] How to replace filters on Motorola phones |
|
113 | 51 | laforge | |
114 | 31 | laforge | == References == |
115 | 1 | === Related projects === |
|
116 | 65 | laforge | * [https://svn.berlin.ccc.de/projects/airprobe/ airprobe] -- Free Software GSM protocol analyzer |
117 | * [http://openbsc.osmocom.org/ OpenBSC] -- Free Software BSC/MSC/HLR/SMSC |
||
118 | * [http://openbts.sourceforge.net/ OpenBTS] -- Free Software Um-to-SIP gateway |
||
119 | * [http://tetra.osmocom.org/ OsmocomTETRA] -- Free Software TETRA related code |
||
120 | |||
121 | 1 | === Recommended reading === |
|
122 | * [http://laforge.gnumonks.org/papers/gsm_phone-anatomy-latest.pdf] -- Introduction to contemporary GSM cellphone hardware |
||
123 | * [http://www2.informatik.hu-berlin.de/~goeller/] -- Homepage of Dr.-Ing. Joachim Goeller, lots of GSM tutorials |
||
124 | * [http://sourceforge.net/projects/plabs/] -- Source code of the firmware of the Vitelcom TSM30 phone (dead link) |
||
125 | * [http://svn.gnumonks.org/trunk/presentation/2010/osmocombb-sstic2010/osmocombb-security.pdf OsmocomBB presentation at SSTIC 2010] |
||
126 | |||
127 | For a complete list of local wiki pages, see TitleIndex. |