2013-01-10-WikiStart » History » Version 85
laforge, 11/07/2023 03:59 PM
git:// deprecation
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 | 85 | laforge | [[OsmocomBB]] source code is kept in the git repository at https://gitea.osmocom.org/phone-side/osmocom-bb |
64 | 72 | ||
65 | 84 | nion | * [[SoftwareGettingStarted]] -- Getting Started with the Software for the target and host. |
66 | * [[SoftwareOverview]] -- Overview how all the parts below fit together |
||
67 | 44 | steve-m | |
68 | |||
69 | 84 | nion | h3. Host programs (running on the PC) |
70 | 31 | laforge | |
71 | 1 | ||
72 | 66 | laforge | |
73 | 84 | nion | h4. General Purpose |
74 | 26 | laforge | |
75 | 84 | nion | * [[osmocon]] -- A tool for Compal phones; to load code into RAM and execute it |
76 | * [[mobile]] -- An application implementing a regular GSM mobile phone (and more) |
||
77 | * [[WiresharkIntegration]] -- How to use [[OsmocomBB]] with wireshark protocol analyzer |
||
78 | * [[libosmocore]] -- A library with utility functions |
||
79 | 64 | laforge | |
80 | |||
81 | 84 | nion | h4. Advanced / special purpose tools |
82 | 64 | laforge | |
83 | 84 | nion | * [[osmoload]] -- A tool for flashing and examining phones |
84 | * [[calypso_pll]] -- A tool to calculate Calypso DPLL multiplier+divider |
||
85 | * [[rita_pll]] -- A tool to calculate the Rita PLL multiplier/divider |
||
86 | * [[layer23]] -- An implementation of GSM Layer2 and upwards. |
||
87 | 1 | ||
88 | 84 | nion | |
89 | h3. Target programs (running on the phone baseband chip) |
||
90 | |||
91 | * The current staging/testing code base for our own software on the Calypso. From it we build a number of apps: |
||
92 | ** hello_world.bin -- An actual 'hello world' application for LCD and serial port |
||
93 | ** [[layer1bin]] -- The actual Layer1 software as it is to be used with [[layer23]] |
||
94 | ** [[loaderbin]] -- Our flash loader, dumper and second stage bootloader |
||
95 | ** [[compal_dsp_dumpbin]] -- A program to dump the ROM of the DSP inside the [[HardwareCalypso]] |
||
96 | ** [[rssibin]] -- Receive signal strength monitor with spectrum display |
||
97 | |||
98 | |||
99 | h2. Supported Phone hardware |
||
100 | |||
101 | |||
102 | Please see [[HardwarePhones]] for a list of supported phones. |
||
103 | |||
104 | |||
105 | h3. Accessories |
||
106 | |||
107 | You will need a [[HardwareSerialCable]] to connect the phone to a PC |
||
108 | |||
109 | |||
110 | h2. Random bits and pieces |
||
111 | |||
112 | * SIM related |
||
113 | ** [[RebelSIM]] How the Rebel SIM card cand be used as SIM proxy |
||
114 | ** [[RebelSIM_Scanner]] to scan/trace communication between SIM and phone (rubbish) |
||
115 | ** [[SIMtrace]] -- our custom hardware / firmware / software to get SIM-ME traces into wireshark |
||
116 | ** [[SIMReader]] How to connect to network using provider SIM |
||
117 | ** [[softSIM]] How to do software SIM |
||
118 | * a collection of phone [[TerminalProfile|Terminal Profiles]] |
||
119 | * [[Sniffing|Notes on sniffing]] |
||
120 | * [[dct3-gsmtap]] A tool to obtain GSMTAP messages for SIM and GSM from Nokia DCT3 (eg, 3310) phones |
||
121 | * [[HardwareFilterReplacement]] How to replace filters on Motorola phones |
||
122 | * [[PotentialCalypsoTargets]] Potential phone hardware to use with osmocom-bb |
||
123 | |||
124 | |||
125 | h2. References == |
||
126 | Related projects === |
||
127 | * [[nuttx-bb]] -- Port of nuttx on the osmocom-bb comaptible phones. |
||
128 | * "airprobe":https://svn.berlin.ccc.de/projects/airprobe/ -- Free Software GSM protocol analyzer |
||
129 | * "Other Osmocom Projects":http://osmocom.org/ -- Osmocom Projects |
||
130 | * "OpenBTS":http://openbts.sourceforge.net/ -- Free Software Um-to-SIP gateway |
||
131 | |||
132 | |||
133 | h3. Recommended reading |
||
134 | |||
135 | * "-- Introduction to contemporary GSM cellphone hardware |
||
136 | * [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 |
||
137 | * "-- Source code of the firmware of the Vitelcom TSM30 phone (dead link) |
||
138 | * [http://svn.gnumonks.org/trunk/presentation/2010/osmocombb-sstic2010/osmocombb-security.pdf [[OsmocomBB]] presentation at SSTIC 2010":http://sourceforge.net/projects/plabs/] |
||
139 | * "Article covering [[OsmocomBB]] at h-online, from July 2012":http://www.h-online.com/open/features/How-free-is-my-phone-1634071.html |
||
140 | For a complete list of local wiki pages, see [[TitleIndex]]. |