OsmocomBB

[[PageOutline]]

= Welcome to the OsmocomBB project =

OsmocomBB is an Open Source / Free Software GSM Baseband software implementation.

It intends to completely replace the need for a proprietary GSM baseband software, such as

 * drivers for the GSM analog and digital baseband (integrated and external) peripherals

 * the GSM phone-side protocol stack, from layer 1 up to layer 3

In short: By using [wiki:OsmocomBB] on a compatible phone, you should eventually be able

to make and receive phone calls, send and receive SMS, etc. based on Free Software only.

At the moment we are in an early but still very promising stage of the project.  Most work

is still being done at Layer1 of the protocol, but there is quick progress!

This is the project page about our experiments (so far) only with phones based on the Ti [wiki:Calypso]/[wiki:Iota]/[wiki:Rita] 

GSM baseband chipset.

We originally intended to build an inexpensive GSM experimentation board built with/around that chipset, but right now

are pursuing a slightly alternative course by using cheap off-the-shelf feature phones and write custom software for it.

 * The [wiki:ProjectRationale]

 * The big [wiki:MasterPlan]

  * [wiki:AreasOfWork] -- What needs to be done and who wants to do it

 * Information about the [wiki:TypicalCalypsoModemDesign]

  * [wiki:Calypso] -- The HERCOM digital baseband chip (DSP+ARM7)

   * [wiki:CalypsoDSP] -- The DSP inside the Calypso DBB

  * [wiki:Iota] -- The TWL3025 analog baseband chip (ADC/DAC)

  * [wiki:Rita] -- The TRF6151C GSM transceiver (VCO, up/down-conversion)

 * Old/obsolete plan/spec of the [wiki:GsmDevelBoard] (note: This project is on hold right now!

 * Description of our own GSM Stack

  * [wiki:L1A_L23_Interface] -- How the Layer1 interfaces with Layer2 and Layer3 of the stack

 * Notes on the [wiki:TSM30Layer1 TSM30 Layer1] as it can be found in the TSM30 source

 * [wiki:Glossary] -- The weird terms used in the phone baseband world

 * [wiki:LegalAspects] -- Important legal aspects of this project

 * [wiki:People] -- The people behind the project

== Software ==

Documentation about software develped by this project

=== host utilities ===

 * [wiki:osmocon] -- A tool for Compal phones; to load code into RAM and execute it

 * [wiki:calypso_pll] -- A tool to calculate Calypso DPLL multiplier+divider

 * [wiki:rita_pll] -- A tool to calculate the Rita PLL multiplier/divider

 * [wiki:layer2] -- An implementation of GSM Layer2 and upwards.

=== software on the target phone ===

 * [wiki:hello_world] -- The current staging/testing code base for our own software on the Calypso. From it we build a number of apps:

  * [wiki:hello_world.bin] -- An actual 'hello world' application for LCD and serial port

  * [wiki:compal_dump.bin] -- A program to dump the internal NOR flash of a Motorola/Compal phone

  * [wiki:compal_dsp_dump.bin] -- A program to dump the ROM of the DSP inside the [wiki:Calypso]

  * [wiki:l1test.bin] -- An example program for testing and developing the GSM Layer1

 * [wiki:FreeRTOS] -- The future FreeRTOS port for the Calypso, TI-Copyright-Free and for gcc

== Phone hardware ==

Information specific to certain Calypso based phones

 * Designed + Manufactured by Compal, OEM by Motorola

  * [wiki:MotorolaC115]/C117 (E87)

  * [wiki:MotorolaC123]/C121/C118 (E88) -- our primary target

  * [wiki:MotorolaC140]/C139 (E86)

  * [wiki:MotorolaC155] (E99) -- our secondary target

== Legal Notice ==

'''SOME OF THE INFORMATION IN THIS WIKI IS CONFIDENTIAL AND COVERED UNDER NON-DISCLOSURE-AGREEMENT'''

== Trac Starting Points ==

 * TracGuide --  Built-in Documentation

 * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project

 * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions

 * TracSupport --  Trac Support

For a complete list of local wiki pages, see TitleIndex.