readme

This a framework to test new ideas in transmission technology. Actual development is a LDPC-coder in

macro_sch
=========


The System CHannel controls things like slot-allocation and power-control.


sch_rcv
-------

This is used for one or more clients to connect to the master-radio.
It uses an id and checks against the structures sent from the master
in order to pick the right configuration for this client.
 If the client radio sets a valid antenna-id, sending and receiving
gain-control will be done.

Inputs:
	U8

Config:
	*data_usr<void>: NULL
		contains the data that has been sent along

	antenna<int>: -1
		if valid, the tx/rx gain of this antenna will be updated

	id<int>: -1
		has to be set so that the SCh module knows which array to decode

	len_usr<int>: 0
		the length of the allocated memory-block


Stats:
	downlinks<int>:
		a bit-field for the downlinks allocated

	free_id<int>:
		a possible new id that could be used

	gain<double>:
		the desired tx-gain

	len_usr<int>:
		how many bytes are valid in data_usr

	uplinks<int>:
		a bit-field for the uplinks allocated

	valid<int>:
		valid is 1 (OK), 0 (SCh OK, but no ID) or <0 (CRC-error)


sch_send
--------

 In general, it builds a big structure that is sent over the first slot
in a frame. It is also used to tell the clients about the strength of the
signal to be sent.
 If there is not enough to send the whole data_usr block through the
slot, it will be truncated and a message will appear in the logs.

outputs:
	U8

Config:
	*data_usr<void>: NULL
		is a pointer to a block of data that will be sent along

	downlinks[ MAX_CLIENTS ]<int>: 0
		a bit-field of the downlinks for the clients

	id[ MAX_CLIENTS ]<int>: -1
		the client's id

	len_usr<int>: 0
		is the length in bytes of the data_usr block

	mafi[ MAX_CLIENTS ]<int>: -1
		one matched-filter from an uplink that will be used for
		gain-control

	minimum_peak[ MAX_CLIENTS ]<int>: 150
		below this peak-level the client is considered to
		be missing

	target_snr[ MAX_CLIENTS ]<double>: 10
		the target snr that the BS tries to achieve by telling
		the MS to increase it's sending gain

	uplinks[ MAX_CLIENTS ]<int>: 0
		a bit-field of the uplinks for the clients