Project

General

Profile

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

nion, 02/19/2016 10:49 PM
Name changed from WikiStart to 2013-01-10-WikiStart

1 84 nion
{{>toc}}
2 1
3 84 nion
h1. Welcome to the [[OsmocomBB]] project
4 1
5 84 nion
6
[[OsmocomBB]] is an Free Software / Open Source GSM Baseband software implementation.
7
8 23 laforge
It intends to completely replace the need for a proprietary GSM baseband software, such as
9 84 nion
* drivers for the GSM analog and digital baseband (integrated and external) peripherals
10
* the GSM phone-side protocol stack, from layer 1 up to layer 3
11 57 laforge
12 84 nion
In short: By using [[OsmocomBB]] on a compatible phone, you are able
13 57 laforge
to make and receive phone calls, send and receive SMS, etc. based on Free Software only.
14 1
15 57 laforge
Over the past 12 months, we've been making very good progress. Most of the hardware drivers have been
16 1
written, and a relatively complete layer1, layer2 and layer3 exist.
17
18
No work has yet been done on any sort of UI on the phone.  The only user interface is a telnet-based
19
command line.
20
21 84 nion
To get started, checkout the [[PreliminaryRequirements]] and then [[SoftwareGettingStarted]]
22 1
23
24 84 nion
h2. Directory
25
26
27 1
[[BlogList(format=float,recent=5,max_size=350)]]
28
29 84 nion
This is the project page about our experiments (so far) only with phones based on the Ti [[HardwareCalypso]]/[[Iota]]/[[Rita]] 
30
GSM baseband chipset.  The main target is the [[MotorolaC123]]. For more supported phones, check below.
31 1
32
We originally intended to build an inexpensive GSM experimentation board built with/around that chipset, but right now
33
are pursuing a slightly alternative course by using cheap off-the-shelf feature phones and write custom software for it.
34 84 nion
* The [[ProjectRationale]]
35
* [[SoftwareAreasOfWork]] -- What needs to be done and who wants to do it
36
* Information about the [[TypicalCalypsoModemDesign]]
37
** [[HardwareCalypso]] -- The HERCROM digital baseband chip (DSP+ARM7)
38
*** [[HardwareCalypsoDSP]] -- The DSP inside the Calypso DBB
39
** [[Iota]] -- The TWL3025 analog baseband chip (ADC/DAC)
40
** [[Rita]] -- The TRF6151C GSM transceiver (VCO, up/down-conversion)
41
* Information about the [[SciphoneDreamG2]], a [[MT6235]] based phone (not supported!!)
42
* Old/obsolete plan/spec of the [[GsmDevelBoard]] (note: This project is on hold right now!
43
* Description of our own GSM Stack
44
** [[L1A_L23_Interface]] -- How the Layer1 interfaces with Layer2 and Layer3 of the stack
45
* Notes on the [[TSM30Layer1|TSM30 Layer1]] as it can be found in the TSM30 source
46
* [[Glossary]] -- The weird terms used in the phone baseband world
47
* [[LegalAspects]] -- Important legal aspects of this project
48
* [[CommunityPeople]] -- The people behind the project
49
* [[PressCoverage]] -- What the press is writing about us
50 1
51
52 84 nion
h2. Mailing List/IRC Chat
53 1
54
55 84 nion
We offer [[CommunityMailing_lists|Mailing Lists] and hang out on [wikiCommunityIRC IRC]].
56
57
58
59
h2. Software
60
61 1
Documentation about software developed by this project.
62
63 84 nion
[[OsmocomBB]] source code is kept in the git repository at *git://git.osmocom.org/osmocom-bb.git*, which you can browse
64 1
best from http://cgit.osmocom.org/
65 72
66 84 nion
* [[SoftwareGettingStarted]] -- Getting Started with the Software for the target and host.
67
* [[SoftwareOverview]] -- Overview how all the parts below fit together
68 44 steve-m
69
70 84 nion
h3. Host programs (running on the PC)
71 31 laforge
72 1
73 66 laforge
74 84 nion
h4. General Purpose
75 26 laforge
76 84 nion
* [[osmocon]] -- A tool for Compal phones; to load code into RAM and execute it
77
* [[mobile]] -- An application implementing a regular GSM mobile phone (and more)
78
* [[WiresharkIntegration]] -- How to use [[OsmocomBB]] with wireshark protocol analyzer
79
* [[libosmocore]] -- A library with utility functions
80 64 laforge
81
82 84 nion
h4. Advanced / special purpose tools
83 64 laforge
84 84 nion
* [[osmoload]] -- A tool for flashing and examining phones
85
* [[calypso_pll]] -- A tool to calculate Calypso DPLL multiplier+divider
86
* [[rita_pll]] -- A tool to calculate the Rita PLL multiplier/divider
87
* [[layer23]] -- An implementation of GSM Layer2 and upwards.
88 1
89 84 nion
90
h3. Target programs (running on the phone baseband chip)
91
92
* The current staging/testing code base for our own software on the Calypso. From it we build a number of apps:
93
** hello_world.bin -- An actual 'hello world' application for LCD and serial port
94
** [[layer1bin]] -- The actual Layer1 software as it is to be used with [[layer23]]
95
** [[loaderbin]] -- Our flash loader, dumper and second stage bootloader
96
** [[compal_dsp_dumpbin]] -- A program to dump the ROM of the DSP inside the [[HardwareCalypso]]
97
** [[rssibin]] -- Receive signal strength monitor with spectrum display
98
99
100
h2. Supported Phone hardware
101
102
103
Please see [[HardwarePhones]] for a list of supported phones.
104
105
106
h3. Accessories
107
108
You will need a [[HardwareSerialCable]] to connect the phone to a PC
109
110
111
h2. Random bits and pieces
112
113
* SIM related
114
** [[RebelSIM]] How the Rebel SIM card cand be used as SIM proxy
115
** [[RebelSIM_Scanner]] to scan/trace communication between SIM and phone (rubbish)
116
** [[SIMtrace]] -- our custom hardware / firmware / software to get SIM-ME traces into wireshark
117
** [[SIMReader]] How to connect to network using provider SIM
118
** [[softSIM]] How to do software SIM
119
* a collection of phone [[TerminalProfile|Terminal Profiles]]
120
* [[Sniffing|Notes on sniffing]]
121
* [[dct3-gsmtap]] A tool to obtain GSMTAP messages for SIM and GSM from Nokia DCT3 (eg, 3310) phones
122
* [[HardwareFilterReplacement]] How to replace filters on Motorola phones
123
* [[PotentialCalypsoTargets]] Potential phone hardware to use with osmocom-bb
124
125
126
h2. References ==
127
 Related projects ===
128
* [[nuttx-bb]] -- Port of nuttx on the osmocom-bb comaptible phones.
129
* "airprobe":https://svn.berlin.ccc.de/projects/airprobe/ -- Free Software GSM protocol analyzer 
130
* "Other Osmocom Projects":http://osmocom.org/ -- Osmocom Projects
131
* "OpenBTS":http://openbts.sourceforge.net/ -- Free Software Um-to-SIP gateway
132
133
134
h3. Recommended reading
135
136
* "-- Introduction to contemporary GSM cellphone hardware
137
* [http://www2.informatik.hu-berlin.de/~goeller/":http://laforge.gnumonks.org/papers/gsm_phone-anatomy-latest.pdf] -- Homepage of Dr.-Ing. Joachim Goeller, lots of GSM tutorials
138
* "-- Source code of the firmware of the Vitelcom TSM30 phone (dead link)
139
* [http://svn.gnumonks.org/trunk/presentation/2010/osmocombb-sstic2010/osmocombb-security.pdf [[OsmocomBB]] presentation at SSTIC 2010":http://sourceforge.net/projects/plabs/]
140
* "Article covering [[OsmocomBB]] at h-online, from July 2012":http://www.h-online.com/open/features/How-free-is-my-phone-1634071.html
141
For a complete list of local wiki pages, see [[TitleIndex]].
Add picture from clipboard (Maximum size: 48.8 MB)