Project

General

Profile

2013-01-10-WikiStart » History » Version 77

mathias, 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 sylvain
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 zecke2
 * [wiki:Community/People] -- The people behind the project
46 37 laforge
 * [wiki:PressCoverage] -- What the press is writing about us
47 1
48 72 zecke2
== Mailing List/IRC Chat ==
49 26 laforge
50 72 zecke2
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 zecke2
 * [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 zecke2
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 prom
  * [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 73 laforge
  * [wiki:rssi.bin] -- Receive signal strength monitor with spectrum display
83 22 laforge
84 31 laforge
== Supported Phone hardware ==
85
Information specific to certain Calypso based phones that we support
86
87 20 laforge
 * Designed + Manufactured by Compal, OEM by Motorola
88
  * [wiki:MotorolaC115]/C117 (E87)
89 1
  * [wiki:MotorolaC123]/C121/C118 (E88) -- our primary target
90
  * [wiki:MotorolaC140]/C139 (E86)
91
  * [wiki:MotorolaC155] (E99) -- our secondary target
92 39 steve-m
  * [wiki:MotorolaV171] (E68/E69)
93 33 laforge
  * [wiki:SonyEricssonJ100i]
94 1
95 47 steve-m
 * Designed by Pirelli/Foxconn, manufactured by Foxconn
96 61 steve-m
  * [wiki:PirelliDPL10 Pirelli DP-L10]
97
98
 * Designed by Openmoko, manufactured by FIC
99 47 steve-m
  * Neo 1973 (GTA01)
100 69 plotr
  * [wiki:OpenMoko] - Neo Freerunner (GTA02)
101 1
=== Accessories ===
102 72 zecke2
You will need a [wiki:Hardware/SerialCable] to connect the phone to a PC
103 31 laforge
104 1
== Random bits and pieces ==
105 55 laforge
 * SIM related
106
  * [wiki:RebelSIM] How the Rebel SIM card cand be used as SIM proxy
107
  * [wiki:RebelSIM_Scanner] to scan/trace communication between SIM and phone (rubbish)
108
  * [wiki:SIMtrace] -- our custom hardware / firmware / software to get SIM-ME traces into wireshark
109
  * [wiki:SIMReader] How to connect to network using provider SIM
110 68 tsaitgaist
  * [wiki:softSIM] How to do software SIM
111 76 tsaitgaist
 * a collection of phone [wiki:TerminalProfile Terminal Profiles]
112 60 xoraxax
 * [wiki:Sniffing Notes on sniffing]
113 67 duncan
 * [wiki:dct3-gsmtap] A tool to obtain GSMTAP messages for SIM and GSM from Nokia DCT3 (eg, 3310) phones
114 72 zecke2
 * [wiki:Hardware/FilterReplacement] How to replace filters on Motorola phones
115 77 mathias
 * [wiki:PotentialCalypsoTargets] Potential phone hardware to use with osmocom-bb
116 51 laforge
117 31 laforge
== References ==
118 1
=== Related projects ===
119 74 gnutoo
 * [wiki:nuttx-bb] -- Port of nuttx on the osmocom-bb comaptible phones.
120 65 laforge
 * [https://svn.berlin.ccc.de/projects/airprobe/ airprobe] -- Free Software GSM protocol analyzer 
121
 * [http://openbsc.osmocom.org/ OpenBSC] -- Free Software BSC/MSC/HLR/SMSC
122
 * [http://openbts.sourceforge.net/ OpenBTS] -- Free Software Um-to-SIP gateway
123
 * [http://tetra.osmocom.org/ OsmocomTETRA] -- Free Software TETRA related code
124
125 1
=== Recommended reading ===
126
 * [http://laforge.gnumonks.org/papers/gsm_phone-anatomy-latest.pdf] -- Introduction to contemporary GSM cellphone hardware
127
 * [http://www2.informatik.hu-berlin.de/~goeller/] -- Homepage of Dr.-Ing. Joachim Goeller, lots of GSM tutorials
128
 * [http://sourceforge.net/projects/plabs/] -- Source code of the firmware of the Vitelcom TSM30 phone (dead link)
129
 * [http://svn.gnumonks.org/trunk/presentation/2010/osmocombb-sstic2010/osmocombb-security.pdf OsmocomBB presentation at SSTIC 2010]
130
131
For a complete list of local wiki pages, see TitleIndex.
Add picture from clipboard (Maximum size: 48.8 MB)