Describe issues surrounding integrating BBN's 802.11 code.
[debian/gnuradio] / README.organization
1 [This file is currently not baked and does not claim to represent
2 consensus.]
3
4 This file describes the current organization of the GNU Radio source
5 tree.  It is intended to be both descriptive and normative.
6
7 The big issues are:
8
9 1) Should we separate by "code needed to implement protocol/modulation
10 foo", or related blocks. to (that are therefore not so likely to be
11 used together).
12
13 2) How do m-blocks impact organization?  If m-blocks are in a separate
14 module, which seems reasonable, then do we have most modules depend on
15 m-blocks rather than just core, or do we have two versions of blocks -
16 the classic continuous block and the m-block wrapped block?  If
17 m-blocks become the main path, what will be less awkward?
18
19 3) Because some (ADROIT at BBN) have proposed to implement MACs in
20 click instead of GNU Radio, should we have a clean separation of
21 MAC/PHY within GNU Radio, to facilitate using MACs implemented in
22 various places?
23
24
25 The immediate question is how to integrate the 802.11 implementation
26 done by BBN, available at:
27
28   http://acert.ir.bbn.com/viewvc/adroitgrdevel/adroitgrdevel/gr-bbn/
29
30 This contains blocks at various places in the stack, and gdt believs
31 that putting them in an 802.11 module will lead to less reuse and less
32 of a tendency to generalize.
33
34 [need pointers to existing documentation of big picture and what's where]