readme

软件无线电的平台

stfa
----

 The STFA implements a framed TDD-transmission. It is THE module in the 
software-radio. It is responsible for the interaction with the hardware
or the simulator, and allows to define the scheduling of the different 
slots.
 This module has x inputs and x outputs which are tied to one antenna.
 
User messages:
- "ANT": the antenna received/sent a slot
- "Go": start the STFA
- "Stop": stop the STFA
- "Notice_func": add a notice-function
- "Notice_sdb": add a notice-sdb

The user-messages can be called using functions which are defined in stfa.h:
- add a notice-function to a slot
  void swr_stfa_notice_func( swr_sdb_id stfa, int slot, func *f )
- add a sdb to a slot
  void swr_stfa_notice_sdb( swr_sdb_id stfa, int slot, swr_sdb_id sdb_id );
- Start the stfa, this also starts the DMA-transfer.
  void swr_stfa_go( swr_sdb_id stfa );
- Stop the stfa. This also stops the DMA-transfer.
  void swr_stfa_stop( swr_sdb_id stfa );

Inputs:
	SAMPLE_S12

outputs:
	SAMPLE_S12

Config:
	blocks_per_slot<int>: 20
		Set the size of the transmission-slots

	gain_rx<int>: 0
		

	gain_rx_0<int>: 500
		

	gain_tx<int>: 0
		The more general gains (the above should disappear sometimes)

	gain_tx_0<int>: 500
		The gains for direct changes

	gain_tx_1<int>: 500
		

	gain_tx_2<int>: 500
		

	guard_period_chips<int>: 90
		The guard-period, which is put in before and after the slot, in chips

	offset_chips_rcv<int>: 0
		The general delay between the master and this radio

	offset_chips_send<int>: 0
		Kind of the distance between the master and this radio, as
		the samples will be sent this much earlier, in order to arrive
		in synch at the master

	offset_samples_rcv<int>: 0
		The more fine delay between the master and this radio

	pre_rcv_chips<int>: 0
		How many chips in advance we switch to receive

	slot_send_offset<int>: 2
		How many slots in advance a TX-chain is called

	slots_per_frame<int>: 15
		Set the number of slots per frame

	stfa_id<int>: -1
		The next stfa for a multi-stfa system


Stats:
	blocks_per_slot<int>:
		This many blocks per slot

	buffer_off_rx<int>:
		The offset of slot 0 in rx

	buffer_off_tx<int>:
		The offset of slot 0 in tx

	frame_count<int>:
		How many frames have been done

	offset_chips<int>:
		How many chips from the beginning of the buffer slot0 is
		placed

	offset_samples<int>:
		How many samples from the beginning of the buffer slot0 is
		placed

	rx<block_t>:
		The whole reception-dma-area, including buffer-zones

	slots_per_frame<int>:
		This many slots per frame

	tx<block_t>:
		The whole transmission-dma-area, including buffer-zones