Project

General

Profile

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

steve-m, 02/19/2016 10:48 PM
add notice about our IRC channel

1 22 laforge
[[PageOutline]]
2 23 laforge
= Welcome to the OsmocomBB project =
3 1
4 23 laforge
OsmocomBB is an Open Source / Free Software GSM Baseband software implementation.
5
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
In short: By using [wiki:OsmocomBB] on a compatible phone, you should eventually be able
11
to make and receive phone calls, send and receive SMS, etc. based on Free Software only.
12
13 41 laforge
At the moment we are making very good progress. Most of the hardware drivers have been
14
written, and a minimalistic layer1 and layer2 as well as a mostly untested layer3 exist.
15
Most work is spent on completing functionality and fixing the various known bugs.
16
No work has yet been done on actual voice call support or any sort of UI on the phone.
17 23 laforge
18
This is the project page about our experiments (so far) only with phones based on the Ti [wiki:Calypso]/[wiki:Iota]/[wiki:Rita] 
19 32 laforge
GSM baseband chipset.  The main target is the [wiki:MotorolaC123]. For more supported phones, check below.
20 8 laforge
21
We originally intended to build an inexpensive GSM experimentation board built with/around that chipset, but right now
22 15 laforge
are pursuing a slightly alternative course by using cheap off-the-shelf feature phones and write custom software for it.
23 1
 * The [wiki:ProjectRationale]
24 8 laforge
 * The big [wiki:MasterPlan]
25 17 laforge
  * [wiki:AreasOfWork] -- What needs to be done and who wants to do it
26 23 laforge
 * Information about the [wiki:TypicalCalypsoModemDesign]
27 42 laforge
  * [wiki:Calypso] -- The HERCROM digital baseband chip (DSP+ARM7)
28 11 laforge
   * [wiki:CalypsoDSP] -- The DSP inside the Calypso DBB
29 1
  * [wiki:Iota] -- The TWL3025 analog baseband chip (ADC/DAC)
30 10 laforge
  * [wiki:Rita] -- The TRF6151C GSM transceiver (VCO, up/down-conversion)
31 22 laforge
 * Old/obsolete plan/spec of the [wiki:GsmDevelBoard] (note: This project is on hold right now!
32 18 laforge
 * Description of our own GSM Stack
33 1
  * [wiki:L1A_L23_Interface] -- How the Layer1 interfaces with Layer2 and Layer3 of the stack
34
 * Notes on the [wiki:TSM30Layer1 TSM30 Layer1] as it can be found in the TSM30 source
35 22 laforge
 * [wiki:Glossary] -- The weird terms used in the phone baseband world
36
 * [wiki:LegalAspects] -- Important legal aspects of this project
37
 * [wiki:People] -- The people behind the project
38 37 laforge
 * [wiki:PressCoverage] -- What the press is writing about us
39 1
40 26 laforge
== Mailing List ==
41
The development discussions regarding this project happen on the ''baseband-devel@lists.osmocom.org'' mailing list.
42
43
General announcement of major steps and releases of the project are available on the ''osmocom-announce'' list.
44
45
You can subscribe to any of those mailing lists at http://lists.osmocom.org/mailman/listinfo
46
47 44 steve-m
== IRC (Internet Relay Chat) ==
48
49
We have an IRC channel where some developers and users hang out. You can find it at: irc.freenode.net/#osmocom
50
51 1
== Software ==
52 31 laforge
Documentation about software developed by this project.
53 1
54
All source code is kept in the git repository at '''git://git.osmocom.org/osmocom-bb.git'''
55 26 laforge
56 31 laforge
=== Host programs (running on the PC) ===
57 25 zecke
 * [wiki:osmocon] -- A tool for Compal phones; to load code into RAM and execute it
58 22 laforge
 * [wiki:calypso_pll] -- A tool to calculate Calypso DPLL multiplier+divider
59 1
 * [wiki:rita_pll] -- A tool to calculate the Rita PLL multiplier/divider
60
 * [wiki:libosmocore] -- A library with utility functions
61 37 laforge
 * [wiki:layer23] -- An implementation of GSM Layer2 and upwards.
62 35 laforge
  * [wiki:WiresharkIntegration] -- How to use OsmocomBB with wireshark protocol analyzer
63 1
64 31 laforge
=== Target programs (running on the phone baseband chip) ===
65 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:
66 27 laforge
  * [wiki:hello_world.bin] -- An actual 'hello world' application for LCD and serial port
67 1
  * [wiki:compal_dump.bin] -- A program to dump the internal NOR flash of a Motorola/Compal phone
68 22 laforge
  * [wiki:compal_dsp_dump.bin] -- A program to dump the ROM of the DSP inside the [wiki:Calypso]
69
  * [wiki:l1test.bin] -- An example program for testing and developing the GSM Layer1
70 38 laforge
  * [wiki:layer1.bin] -- The actual Layer1 software as it is to be used with [wiki:layer23]
71 22 laforge
72 31 laforge
== Supported Phone hardware ==
73
Information specific to certain Calypso based phones that we support
74
75 20 laforge
 * Designed + Manufactured by Compal, OEM by Motorola
76
  * [wiki:MotorolaC115]/C117 (E87)
77 1
  * [wiki:MotorolaC123]/C121/C118 (E88) -- our primary target
78
  * [wiki:MotorolaC140]/C139 (E86)
79
  * [wiki:MotorolaC155] (E99) -- our secondary target
80 39 steve-m
  * [wiki:MotorolaV171] (E68/E69)
81 33 laforge
  * [wiki:SonyEricssonJ100i]
82 1
=== Accessories ===
83
You will need a [wiki:CalypsoSerialCable] to connect the phone to a PC
84 31 laforge
85
== References ==
86
=== Related projects ===
87
 * [https://svn.berlin.ccc.de/projects/airprobe/ airprobe] -- Open Source GSM protocol analyzer 
88
 * [http://openbsc.gnumonks.org/ OpenBSC] -- Open Source BSC/MSC/HLR/SMSC
89
 * [http://openbts.sourceforge.net/ OpenBTS] -- Open Source Um-to-SIP gateway
90
=== Recommended reading ===
91 43 laforge
 * [http://laforge.gnumonks.org/papers/gsm_phone-anatomy-latest.pdf] -- Introduction to contemporary GSM cellphone hardware
92 31 laforge
 * [http://www2.informatik.hu-berlin.de/~goeller/] -- Homepage of Dr.-Ing. Joachim Goeller, lots of GSM tutorials
93 34 laforge
 * [http://sourceforge.net/projects/plabs/] -- Source code of the firmware of the Vitelcom TSM30 phone 
94 30 laforge
95 2 laforge
== Trac Starting Points ==
96 1
97
 * TracGuide --  Built-in Documentation
98
 * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project
99
 * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions
100
 * TracSupport --  Trac Support
101
102
For a complete list of local wiki pages, see TitleIndex.
Add picture from clipboard (Maximum size: 48.8 MB)