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]]. |