readme

软件无线电的平台

stfa_complex
------------

 The STFA_complex 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.
 It differs from STFA in that it has complex in- and outputs
 
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:
	SYMBOL_COMPLEX

outputs:
	SYMBOL_COMPLEX

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

	gain_rx<int>: 0
		

	gain_rx_0<int>: undef
		

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

	gain_tx_0, gain_tx_1, gain_tx_2<int>: undef
		The gains for direct changes

	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_samples_rcv<int>: 0
		The more fine delay between the master and this radio

	offset_samples_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

	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
		Master-Slave Stfa's in MIMO
		Each STFA has the id of the next STFA or -1 to finish the chain


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

	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