osmocom-bb

History

Andreas.Eversberg 9359a91504 Moved layer 1 <-> layer 2 interface from main.c to a seperate file of liblayer23. Other applications using liblayer23 don't need to re-implement it. Messages from layer 1 are not freed in layer2_read() anymore. They will be freed by the upper layers. The layers may also decide to queue or to forward the messages. In general: A message is always discarded by the message handler and not after calling the message handler.		2010-05-22 10:46:20 +00:00
..
host	Moved layer 1 <-> layer 2 interface from main.c to a seperate file of	2010-05-22 10:46:20 +00:00
shared	Added some "get"-functions to bitvec of libosmocore.	2010-05-09 09:36:54 +00:00
target/firmware	Make new L1CTL_FBSB_REQ work reliably	2010-05-20 23:26:42 +02:00
target_dsp	target_dsp/calypso: Add some pointers to get started in IDA	2010-04-28 10:13:58 +02:00
wireshark	update wireshakr gsmtap patch with the 2nd version submitted to wireshark	2010-03-04 21:44:41 +01:00
Makefile	start to use libosmocore within the firmware	2010-03-07 20:56:12 +01:00
README.building	readme update	2010-03-08 10:18:57 +01:00
README.development	readme update	2010-03-08 10:18:57 +01:00

README.development

= Contributing to OsmocomBB development =

Feel free to help us by extending the code.  Always make sure to
send back all your patches to the baseband-devel@lists.osmocom.org
mailing list - Free Software is all about sharing.

== src/shared/libosmocore ==

is a library of various utility routines, including linked lists,
message buffers, bit-vectors, memory allocator, signals, select loop
handling, timers - as well as some more specifically GSM related things
like a TLV parser, a Comp128V1 implementation and utility functions for
RSL (TS 08.58) and CC/MM/RR (TS 04.08).

libosmocore is maintained in git://git.osmocom.org/libosmocore.git, so

	DO NOT DIRECTLY COMMIT TO libosmocore IN THIS REPOSITORY!

We simply maintain a copy (synchronized by git-subtree) in this
repository for the ease of building and to make sure everyone is using
the proper/compatible version of libosmocore

Please note, whatever you add to libosmocore will need to build as a
Linux userspace program (using glibc) just as well as on the OsmocomBB
embedded target without OS.  So please refrain from using fancy
functions.


== src/target/firmware ==

The firmware is what we build for the actual target (phone).  It was
written with some idea of modularity in mind, i.e. we have

 * Ti Calypso specific code in calypso/
 * Analog Baseband code in abb/
 * RF Mixer code in rf/
 * Layer1 code in layer1/
 * NOR flash handling in flash/
 * LCD display handlin in display/
 * minimal C-Library code in lib/
 * communications utility routines in comm/
 * Board (phone model/family) specific code in board/
   * board/compal_e88 is the Motorola C115-C124 family
   * board/compal_e99 is the Motorola C155 family
 * Applications (each app builds one firmware image) in apps/


== src/target_dsp/calypso ==

This is where we keep some (assembly) code that we wrote for
the DSP that is part of the Caylypso DBB.

== host/layer23 ==

The Layer2 (LAPDm / TS 04.06) and Layer3 (CC/MM/RR / 04.08)
implementations, as they are growing.