osmo-trx/Transceiver52M
Pau Espin 5b60c98769 Use pthread_setname_np to name threads
osmo-trx can start a considerable amount of threads that can make
debugging it challenging at least. By using phtread_setname_np, the
system sets a meaningful name to the thread which can be seen while
debugging with gdb or by printing /proc/$pid/task/$tid/comm.

Now we also log system TID when setting the name so we can identify
different tasks in /proc even if pthread_setname_np fails.

Change-Id: I84711739c3e224cb383fd12b6db933785b28209e
2018-09-28 23:17:57 +00:00
..
arch build: Fix make distcheck 2018-04-27 11:34:11 +02:00
device Use pthread_setname_np to name threads 2018-09-28 23:17:57 +00:00
Channelizer.cpp Move arch specific fiels to arch subdir 2018-04-24 15:22:59 +02:00
Channelizer.h mcbts: Add multi-ARFCN channelizing filters 2016-07-01 03:07:27 -07:00
ChannelizerBase.cpp Move arch specific fiels to arch subdir 2018-04-24 15:22:59 +02:00
ChannelizerBase.h mcbts: Add multi-ARFCN channelizing filters 2016-07-01 03:07:27 -07:00
Complex.h Alexander's patches: 2012-11-23 08:37:32 +00:00
Makefile.am lms: Makefile.am: Reorder params to fix link issue 2018-06-13 21:45:32 +00:00
README Adding in the missing Transceiver52M directory 2011-10-12 07:44:40 +00:00
README.DFEsymbolspaced Adding in the missing Transceiver52M directory 2011-10-12 07:44:40 +00:00
Resampler.cpp sigProcLib: Replace dynamically allocated resampling buffers 2017-06-22 17:39:44 +00:00
Resampler.h sigProcLib: Replace dynamically allocated resampling buffers 2017-06-22 17:39:44 +00:00
Synthesis.cpp Move arch specific fiels to arch subdir 2018-04-24 15:22:59 +02:00
Synthesis.h mcbts: Add multi-ARFCN channelizing filters 2016-07-01 03:07:27 -07:00
Transceiver.cpp Use pthread_setname_np to name threads 2018-09-28 23:17:57 +00:00
Transceiver.h osmo-trx: Add osmo_signal to stop whole transceiver chain correctly on error 2018-09-04 16:35:23 +02:00
inband-signaling-usb Adding in the missing Transceiver52M directory 2011-10-12 07:44:40 +00:00
laurent.m Transceiver52M: Add 4 samples-per-symbol Laurent pulse shape 2013-10-18 13:10:17 -04:00
osmo-trx.cpp osmo-trx: Add osmo_signal to stop whole transceiver chain correctly on error 2018-09-04 16:35:23 +02:00
pulseApproximate.m Adding in the missing Transceiver52M directory 2011-10-12 07:44:40 +00:00
radioBuffer.cpp transceiver: Fix mismatched allocations and deallocations 2016-10-26 08:54:13 +02:00
radioBuffer.h radioBuffer: Remove extra ; at the end of inline function definitions. 2017-03-20 18:41:02 +00:00
radioClock.cpp Transceiver52M: Implement POWEROFF command 2014-12-15 16:20:15 -07:00
radioClock.h transceiver: separate radio clock and vector interfaces 2011-11-26 03:18:30 +00:00
radioInterface.cpp Use pthread_setname_np to name threads 2018-09-28 23:17:57 +00:00
radioInterface.h radioInterface: forward errors from RadioDevice to Transceiver in recv path 2018-09-03 18:53:52 +02:00
radioInterfaceMulti.cpp radioInterfaceMulti:pullBuffer: Sanely convert float array to complex array 2018-09-10 10:30:06 +02:00
radioInterfaceResamp.cpp radioInterface: forward errors from RadioDevice to Transceiver in recv path 2018-09-03 18:53:52 +02:00
radioVector.cpp Transceiver52M: Enable all warnings and resolve 2013-11-15 23:35:07 -05:00
radioVector.h Transceiver52M: Set const qualifier on appropriate radio vector methods 2013-11-15 23:35:07 -05:00
sigProcLib.cpp cosmetic: Fix trailing whitespace in several files 2018-09-10 10:30:06 +02:00
sigProcLib.h sigProcLib: Remove unused functions from public interface 2017-06-14 16:30:28 +00:00
signalVector.cpp Vector: Copy arrays in a sane way for non-trivially copyable types 2018-09-10 10:33:34 +02:00
signalVector.h signalVector: Implement segment(). 2017-03-24 01:22:40 +00:00
std_inband.rbf Adding in the missing Transceiver52M directory 2011-10-12 07:44:40 +00:00

README

The Transceiver

The transceiver consists of three modules:
   --- transceiver
   --- radioInterface
   --- USRPDevice

The USRPDevice module is basically a driver that reads/writes
packets to a USRP with two RFX900 daughterboards, board 
A is the Tx chain and board B is the Rx chain.  

The radioInterface module is basically an interface b/w the
transceiver and the USRP.   It operates the basestation clock
based upon the sample count of received USRP samples.  Packets 
from the USRP are queued and segmented into GSM bursts that are
passed up to the transceiver; bursts from the transceiver are
passed down to the USRP. 

The transceiver basically operates "layer 0" of the GSM stack,
performing the modulation, detection, and demodulation of GSM 
bursts.  It communicates with the GSM stack via three UDP sockets,
one socket for data, one for control messages, and one socket to
pass clocking information.  The transceiver contains a priority
queue to sort to-be-transmitted bursts, and a filler table to fill
in timeslots that do not have bursts in the priority queue.  The
transceiver tries to stay ahead of the basestation clock, adapting 
its latency when underruns are reported by the radioInterface/USRP.
Received bursts (from the radioInterface) pass through a simple 
energy detector, a RACH or midamble correlator, and a DFE-based demodulator.

NOTE: There's a SWLOOPBACK #define statement, where the USRP is replaced
with a memory buffer.  In this mode, data written to the USRP is actually stored 
in a buffer, and read commands to the USRP simply pull data from this buffer.
This was very useful in early testing, and still may be useful in testing basic
Transceiver and radioInterface functionality.